You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@magpie.apache.org by gi...@apache.org on 2026/09/16 22:47:14 UTC
(magpie-site) branch preview/pr180-staging updated (ab84509 -> c54f0a8)
This is an automated email from the ASF dual-hosted git repository.
github-actions[bot] pushed a change to branch preview/pr180-staging
in repository https://gitbox.apache.org/repos/asf/magpie-site.git
discard ab84509 Publish preview for #180 (14fdc13)
new c54f0a8 Publish preview for #180 (14fdc13)
This update added new revisions after undoing existing revisions.
That is to say, some revisions that were in the old version of the
branch are not in the new version. This situation occurs
when a user --force pushes a change and generates a repository
containing something like this:
* -- * -- B -- O -- O -- O (ab84509)
\
N -- N -- N refs/heads/preview/pr180-staging (c54f0a8)
You should already have received notification emails for all of the O
revisions, and so the following emails describe only the N revisions
from the common base, B.
Any revisions marked "omit" are not gone; other references still
refer to them. Any revisions marked "discard" are gone forever.
The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
(magpie-site) 01/01: Publish preview for #180 (14fdc13)
Posted by gi...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
github-actions[bot] pushed a commit to branch preview/pr180-staging
in repository https://gitbox.apache.org/repos/asf/magpie-site.git
commit c54f0a8065f000c58084b8779da9d60b81ccb80d
Author: github-actions[bot] <gi...@users.noreply.github.com>
AuthorDate: Wed Sep 16 22:47:04 2026 +0000
Publish preview for #180 (14fdc13)
Generated-by: preview-publish
---
.asf.yaml | 5 +
.htaccess | 39 +
404.html | 1 +
_astro/AnimationLab.Dgrvysdu.js | 1 +
_astro/BaseLayout.H4DLRpYn.css | 2 +
_astro/KineticHome.C-3-oRUu.js | 1 +
_astro/KineticResources.CxkDmVTE.js | 1 +
_astro/MagpieFlight.jfKZeDdE.js | 53 +
_astro/TerminalDemo.D3XxO7w3.js | 49 +
_astro/TerminalDemo.Dr_RgvG1.js | 1 +
_astro/TerminalDemo._B8BWLul.css | 1 +
_astro/animation-test.CneHVBNE.css | 1 +
_astro/arrow-up-right.DdKwi7mE.js | 1 +
_astro/client.bxcwkfp-.js | 9 +
_astro/copy.Dfz5KN2B.js | 1 +
.../geist-cyrillic-ext-wght-normal.DjL33-gN.woff2 | Bin 0 -> 7420 bytes
_astro/geist-cyrillic-wght-normal.BEAKL7Jp.woff2 | Bin 0 -> 15084 bytes
_astro/geist-latin-ext-wght-normal.DC-KSUi6.woff2 | Bin 0 -> 16512 bytes
_astro/geist-latin-wght-normal.BgDaEnEv.woff2 | Bin 0 -> 29400 bytes
_astro/geist-vietnamese-wght-normal.6IgcOCM7.woff2 | Bin 0 -> 8004 bytes
_astro/inter-cyrillic-400-normal.HOLc17fK.woff | Bin 0 -> 9780 bytes
_astro/inter-cyrillic-400-normal.obahsSVq.woff2 | Bin 0 -> 7712 bytes
_astro/inter-cyrillic-500-normal.BasfLYem.woff2 | Bin 0 -> 7900 bytes
_astro/inter-cyrillic-500-normal.CxZf_p3X.woff | Bin 0 -> 9940 bytes
_astro/inter-cyrillic-600-normal.4D_pXhcN.woff | Bin 0 -> 9936 bytes
_astro/inter-cyrillic-600-normal.CWCymEST.woff2 | Bin 0 -> 7972 bytes
_astro/inter-cyrillic-700-normal.CjBOestx.woff2 | Bin 0 -> 7904 bytes
_astro/inter-cyrillic-700-normal.DrXBdSj3.woff | Bin 0 -> 9912 bytes
.../inter-cyrillic-ext-400-normal.BQZuk6qB.woff2 | Bin 0 -> 10232 bytes
_astro/inter-cyrillic-ext-400-normal.DQukG94-.woff | Bin 0 -> 13336 bytes
.../inter-cyrillic-ext-500-normal.B0yAr1jD.woff2 | Bin 0 -> 10432 bytes
_astro/inter-cyrillic-ext-500-normal.BmqWE9Dz.woff | Bin 0 -> 13452 bytes
_astro/inter-cyrillic-ext-600-normal.Bcila6Z-.woff | Bin 0 -> 13464 bytes
.../inter-cyrillic-ext-600-normal.Dfes3d0z.woff2 | Bin 0 -> 10484 bytes
.../inter-cyrillic-ext-700-normal.BjwYoWNd.woff2 | Bin 0 -> 10496 bytes
_astro/inter-cyrillic-ext-700-normal.LO58E6JB.woff | Bin 0 -> 13408 bytes
_astro/inter-greek-400-normal.B4URO6DV.woff2 | Bin 0 -> 7776 bytes
_astro/inter-greek-400-normal.q2sYcFCs.woff | Bin 0 -> 9924 bytes
_astro/inter-greek-500-normal.BIZE56-Y.woff2 | Bin 0 -> 7920 bytes
_astro/inter-greek-500-normal.Xzm54t5V.woff | Bin 0 -> 9980 bytes
_astro/inter-greek-600-normal.BZpKdvQh.woff | Bin 0 -> 10032 bytes
_astro/inter-greek-600-normal.plRanbMR.woff2 | Bin 0 -> 7944 bytes
_astro/inter-greek-700-normal.BUv2fZ6O.woff | Bin 0 -> 9980 bytes
_astro/inter-greek-700-normal.C3JjAnD8.woff2 | Bin 0 -> 7920 bytes
_astro/inter-greek-ext-400-normal.DGGRlc-M.woff2 | Bin 0 -> 5264 bytes
_astro/inter-greek-ext-400-normal.KugGGMne.woff | Bin 0 -> 7064 bytes
_astro/inter-greek-ext-500-normal.2j5mBUwD.woff | Bin 0 -> 7192 bytes
_astro/inter-greek-ext-500-normal.C4iEst2y.woff2 | Bin 0 -> 5428 bytes
_astro/inter-greek-ext-600-normal.B8X0CLgF.woff | Bin 0 -> 7212 bytes
_astro/inter-greek-ext-600-normal.DRtmH8MT.woff2 | Bin 0 -> 5432 bytes
_astro/inter-greek-ext-700-normal.BoQ6DsYi.woff | Bin 0 -> 7216 bytes
_astro/inter-greek-ext-700-normal.qfdV9bQt.woff2 | Bin 0 -> 5444 bytes
_astro/inter-latin-400-normal.C38fXH4l.woff2 | Bin 0 -> 23664 bytes
_astro/inter-latin-400-normal.CyCys3Eg.woff | Bin 0 -> 30696 bytes
_astro/inter-latin-500-normal.BL9OpVg8.woff | Bin 0 -> 31284 bytes
_astro/inter-latin-500-normal.Cerq10X2.woff2 | Bin 0 -> 24272 bytes
_astro/inter-latin-600-normal.CiBQ2DWP.woff | Bin 0 -> 31260 bytes
_astro/inter-latin-600-normal.LgqL8muc.woff2 | Bin 0 -> 24452 bytes
_astro/inter-latin-700-normal.BLAVimhd.woff | Bin 0 -> 31320 bytes
_astro/inter-latin-700-normal.Yt3aPRUw.woff2 | Bin 0 -> 24356 bytes
_astro/inter-latin-ext-400-normal.77YHD8bZ.woff | Bin 0 -> 47560 bytes
_astro/inter-latin-ext-400-normal.C1nco2VV.woff2 | Bin 0 -> 35000 bytes
_astro/inter-latin-ext-500-normal.BxGbmqWO.woff | Bin 0 -> 48492 bytes
_astro/inter-latin-ext-500-normal.CV4jyFjo.woff2 | Bin 0 -> 36024 bytes
_astro/inter-latin-ext-600-normal.CIVaiw4L.woff | Bin 0 -> 48668 bytes
_astro/inter-latin-ext-600-normal.D2bJ5OIk.woff2 | Bin 0 -> 36260 bytes
_astro/inter-latin-ext-700-normal.Ca8adRJv.woff2 | Bin 0 -> 36244 bytes
_astro/inter-latin-ext-700-normal.TidjK2hL.woff | Bin 0 -> 48632 bytes
_astro/inter-vietnamese-400-normal.Bbgyi5SW.woff | Bin 0 -> 6500 bytes
_astro/inter-vietnamese-400-normal.DMkecbls.woff2 | Bin 0 -> 4972 bytes
_astro/inter-vietnamese-500-normal.DOriooB6.woff2 | Bin 0 -> 5112 bytes
_astro/inter-vietnamese-500-normal.mJboJaSs.woff | Bin 0 -> 6596 bytes
_astro/inter-vietnamese-600-normal.BuLX-rYi.woff | Bin 0 -> 6640 bytes
_astro/inter-vietnamese-600-normal.Cc8MFFhd.woff2 | Bin 0 -> 5100 bytes
_astro/inter-vietnamese-700-normal.BZaoP0fm.woff | Bin 0 -> 6632 bytes
_astro/inter-vietnamese-700-normal.DlLaEgI2.woff2 | Bin 0 -> 5104 bytes
_astro/jost-cyrillic-400-normal.Dk3McGkH.woff | Bin 0 -> 5588 bytes
_astro/jost-cyrillic-400-normal.bVZEi0jL.woff2 | Bin 0 -> 4108 bytes
_astro/jost-cyrillic-500-normal.DlHwnXyv.woff | Bin 0 -> 5872 bytes
_astro/jost-cyrillic-500-normal.DtB2bvF0.woff2 | Bin 0 -> 4412 bytes
_astro/jost-cyrillic-600-normal.BEDXyecp.woff2 | Bin 0 -> 4436 bytes
_astro/jost-cyrillic-600-normal.D0Fzn8un.woff | Bin 0 -> 5868 bytes
_astro/jost-cyrillic-700-normal.BHDNzvjF.woff | Bin 0 -> 5900 bytes
_astro/jost-cyrillic-700-normal._ob5o-r5.woff2 | Bin 0 -> 4384 bytes
_astro/jost-latin-400-normal.C7S-3Ky6.woff | Bin 0 -> 13224 bytes
_astro/jost-latin-400-normal.q-RKOgPK.woff2 | Bin 0 -> 9404 bytes
_astro/jost-latin-500-normal.41lBe9I9.woff2 | Bin 0 -> 10476 bytes
_astro/jost-latin-500-normal.B-AtzreL.woff | Bin 0 -> 14220 bytes
_astro/jost-latin-600-normal.Bv_M0d15.woff | Bin 0 -> 14232 bytes
_astro/jost-latin-600-normal.C497H-z9.woff2 | Bin 0 -> 10480 bytes
_astro/jost-latin-700-normal.k-iBXzmq.woff | Bin 0 -> 14288 bytes
_astro/jost-latin-700-normal.u2Hrqd6k.woff2 | Bin 0 -> 10520 bytes
_astro/jost-latin-ext-400-normal.CpdMQIMr.woff2 | Bin 0 -> 6396 bytes
_astro/jost-latin-ext-400-normal.Dsyb2mtt.woff | Bin 0 -> 9108 bytes
_astro/jost-latin-ext-500-normal.BkvHgcKf.woff2 | Bin 0 -> 6912 bytes
_astro/jost-latin-ext-500-normal.Cpxiadwk.woff | Bin 0 -> 9524 bytes
_astro/jost-latin-ext-600-normal.D8I9kjga.woff2 | Bin 0 -> 6832 bytes
_astro/jost-latin-ext-600-normal.Pm6OqGZB.woff | Bin 0 -> 9604 bytes
_astro/jost-latin-ext-700-normal.AnR_ULdm.woff2 | Bin 0 -> 6884 bytes
_astro/jost-latin-ext-700-normal.DTcCupJy.woff | Bin 0 -> 9572 bytes
_astro/jsx-runtime.WQvrtk7F.js | 1 +
_astro/kinetic-home.BR2OxRzm.css | 1 +
_astro/react.CYuo-Lgd.js | 1 +
_astro/three.module.fzXHyE0N.js | 4220 ++
animation-test/index.html | 1 +
architecture/index.html | 75 +
brand/avatar-1000.png | Bin 0 -> 34340 bytes
brand/avatar-400.png | Bin 0 -> 17393 bytes
brand/banner-1500x500.png | Bin 0 -> 106721 bytes
brand/banner-bluesky-3000x1000.png | Bin 0 -> 194147 bytes
brand/banner-linkedin-1128x191.png | Bin 0 -> 57326 bytes
brand/index.html | 19 +
community-avatars/CalvinKirs.png | Bin 0 -> 5672 bytes
community-avatars/RussellSpitzer.png | Bin 0 -> 3445 bytes
community-avatars/amoghrajesh.png | Bin 0 -> 8587 bytes
community-avatars/andreahlert.png | Bin 0 -> 36790 bytes
community-avatars/andrewmusselman.png | Bin 0 -> 928 bytes
community-avatars/choo121600.png | Bin 0 -> 5341 bytes
community-avatars/clr-apache.png | Bin 0 -> 4281 bytes
community-avatars/csutherl.png | Bin 0 -> 3790 bytes
community-avatars/eladkal.png | Bin 0 -> 3446 bytes
community-avatars/gopidesupavan.png | Bin 0 -> 7693 bytes
community-avatars/iemejia.png | Bin 0 -> 55669 bytes
community-avatars/jamesfredley.png | Bin 0 -> 4439 bytes
community-avatars/jbonofre.png | Bin 0 -> 1581 bytes
community-avatars/justinmclean.png | Bin 0 -> 4523 bytes
community-avatars/madrob.png | Bin 0 -> 1537 bytes
community-avatars/onlyarnav.png | Bin 0 -> 4233 bytes
community-avatars/paulk-asert.png | Bin 0 -> 53934 bytes
community-avatars/potiuk.png | Bin 0 -> 45314 bytes
community-avatars/ppkarwasz.png | Bin 0 -> 4255 bytes
community-avatars/rbowen.png | Bin 0 -> 5812 bytes
community-avatars/rmaucher.png | Bin 0 -> 7063 bytes
community-avatars/rusackas.png | Bin 0 -> 7158 bytes
community-avatars/rzo1.png | Bin 0 -> 38907 bytes
community-avatars/tisonkun.png | Bin 0 -> 4485 bytes
community-avatars/zeroshade.png | Bin 0 -> 5030 bytes
demo/index.html | 21 +
docs-assets/badge.json | 8 +
docs-assets/bump-dev-version-run.png | Bin 0 -> 228243 bytes
docs-assets/installed-plugins.png | Bin 0 -> 601625 bytes
docs-assets/quickstart/README.md | 167 +
docs-assets/quickstart/demo.svg | 60 +
.../families/contributor-growth/activity-sweep.svg | 48 +
.../families/contributor-growth/activity-sweep.txt | 33 +
.../contributor-growth/committer-onboarding.svg | 49 +
.../contributor-growth/committer-onboarding.txt | 34 +
.../families/contributor-growth/nomination.svg | 48 +
.../families/contributor-growth/nomination.txt | 34 +
.../quickstart/families/issue/deduplicate.svg | 49 +
.../quickstart/families/issue/deduplicate.txt | 35 +
.../quickstart/families/issue/reproducer.svg | 47 +
.../quickstart/families/issue/reproducer.txt | 33 +
docs-assets/quickstart/families/issue/triage.svg | 49 +
docs-assets/quickstart/families/issue/triage.txt | 33 +
.../families/mentoring/good-first-issue-sweep.svg | 49 +
.../families/mentoring/good-first-issue-sweep.txt | 34 +
.../mentoring/newcomer-issue-explainer.svg | 47 +
.../mentoring/newcomer-issue-explainer.txt | 32 +
.../quickstart/families/mentoring/welcome.svg | 48 +
.../quickstart/families/mentoring/welcome.txt | 33 +
.../families/pairing/multi-agent-review.svg | 50 +
.../families/pairing/multi-agent-review.txt | 37 +
.../quickstart/families/pairing/self-review.svg | 47 +
.../quickstart/families/pairing/self-review.txt | 32 +
.../quickstart/families/pr-management/stats.svg | 50 +
.../quickstart/families/pr-management/stats.txt | 37 +
.../quickstart/families/pr-management/triage.svg | 50 +
.../quickstart/families/pr-management/triage.txt | 34 +
.../families/release-management/prepare.svg | 48 +
.../families/release-management/prepare.txt | 33 +
.../families/release-management/verify-rc.svg | 49 +
.../families/release-management/verify-rc.txt | 34 +
.../families/release-management/vote-tally.svg | 49 +
.../families/release-management/vote-tally.txt | 35 +
.../families/repo-health/dependency-audit.svg | 49 +
.../families/repo-health/dependency-audit.txt | 35 +
.../families/repo-health/flaky-test-triage.svg | 49 +
.../families/repo-health/flaky-test-triage.txt | 35 +
.../repo-health/workflow-security-audit.svg | 48 +
.../repo-health/workflow-security-audit.txt | 33 +
.../quickstart/families/security/issue-import.svg | 47 +
.../quickstart/families/security/issue-import.txt | 33 +
.../quickstart/families/security/issue-triage.svg | 49 +
.../quickstart/families/security/issue-triage.txt | 34 +
.../quickstart/families/security/model-verify.svg | 47 +
.../quickstart/families/security/model-verify.txt | 32 +
.../families/setup/isolated-setup-install.svg | 48 +
.../families/setup/isolated-setup-install.txt | 33 +
.../families/setup/isolated-setup-verify.svg | 49 +
.../families/setup/isolated-setup-verify.txt | 34 +
docs-assets/quickstart/families/setup/status.svg | 48 +
docs-assets/quickstart/families/setup/status.txt | 32 +
.../quickstart/families/utilities/list-skills.svg | 49 +
.../quickstart/families/utilities/list-skills.txt | 35 +
.../families/utilities/report-framework-issue.svg | 47 +
.../families/utilities/report-framework-issue.txt | 32 +
.../quickstart/families/utilities/write-skill.svg | 48 +
.../quickstart/families/utilities/write-skill.txt | 34 +
docs-assets/quickstart/install.svg | 53 +
docs-assets/quickstart/magpie-setup.svg | 69 +
docs-assets/quickstart/step-adopt.svg | 50 +
docs-assets/quickstart/step-guard.svg | 54 +
docs-assets/quickstart/step-install.svg | 55 +
docs-assets/quickstart/step-isolation.svg | 51 +
docs-assets/quickstart/step-privacy.svg | 54 +
docs-assets/quickstart/step-use.svg | 51 +
.../quickstart/walkthrough/1-preflight-stops.svg | 47 +
.../quickstart/walkthrough/1-preflight-stops.txt | 32 +
.../quickstart/walkthrough/2-config-wizard.svg | 47 +
.../quickstart/walkthrough/2-config-wizard.txt | 32 +
.../quickstart/walkthrough/3-scaffolded.svg | 50 +
.../quickstart/walkthrough/3-scaffolded.txt | 37 +
docs-assets/quickstart/walkthrough/4-it-runs.svg | 47 +
docs-assets/quickstart/walkthrough/4-it-runs.txt | 32 +
.../quickstart/walkthrough/5-adopt-promotes.svg | 54 +
.../quickstart/walkthrough/5-adopt-promotes.txt | 40 +
.../quickstart/wizard/contributor-growth.svg | 60 +
docs-assets/quickstart/wizard/issue.svg | 60 +
docs-assets/quickstart/wizard/mentoring.svg | 54 +
docs-assets/quickstart/wizard/pr-management.svg | 60 +
.../quickstart/wizard/release-management.svg | 56 +
docs-assets/quickstart/wizard/repo-health.svg | 54 +
docs-assets/quickstart/wizard/security.svg | 66 +
docs-assets/sandbox-blocks-read.png | Bin 0 -> 350556 bytes
docs-assets/sandbox-bypass-banner.png | Bin 0 -> 484008 bytes
docs-assets/sandbox-modes.png | Bin 0 -> 512135 bytes
docs-assets/sandbox-os-level-block.png | Bin 0 -> 528082 bytes
docs-assets/session-no-sandbox.png | Bin 0 -> 462482 bytes
docs-assets/session-sandboxed.png | Bin 0 -> 359031 bytes
docs/adapters/add-a-harness.md | 282 +
docs/adapters/add-a-harness/index.html | 290 +
docs/adapters/authoring.md | 82 +
docs/adapters/authoring/index.html | 156 +
docs/adapters/codex.md | 223 +
docs/adapters/codex/index.html | 246 +
docs/adapters/cursor.md | 125 +
docs/adapters/cursor/index.html | 169 +
docs/adapters/gemini.md | 370 +
docs/adapters/gemini/index.html | 494 +
docs/adapters/goose.md | 197 +
docs/adapters/goose/index.html | 212 +
docs/adapters/kiro.md | 103 +
docs/adapters/kiro/index.html | 135 +
docs/adapters/local-llm.md | 247 +
docs/adapters/local-llm/index.html | 248 +
docs/adapters/opencode.md | 104 +
docs/adapters/opencode/index.html | 138 +
docs/adapters/readme.md | 70 +
docs/adapters/readme/index.html | 146 +
docs/adapters/registry.md | 85 +
docs/adapters/registry/index.html | 193 +
docs/confidentiality.md | 54 +
docs/confidentiality/index.html | 96 +
docs/contributor-growth/readme.md | 214 +
docs/contributor-growth/readme/index.html | 354 +
docs/contributor-sentiment.md | 267 +
docs/contributor-sentiment/index.html | 305 +
docs/designs/2026-09-13-install-adopt-upgrade.md | 624 +
.../2026-09-13-install-adopt-upgrade/index.html | 646 +
docs/designs/readme.md | 31 +
docs/designs/readme/index.html | 82 +
docs/editorial-guidelines.md | 485 +
docs/editorial-guidelines/index.html | 463 +
docs/education/agentic-work.md | 175 +
docs/education/agentic-work/index.html | 197 +
docs/education/choosing-models.md | 151 +
docs/education/choosing-models/index.html | 177 +
docs/education/contributing.md | 161 +
docs/education/contributing/index.html | 192 +
docs/education/debugging-skills.md | 272 +
docs/education/debugging-skills/index.html | 292 +
docs/education/english-as-code.md | 164 +
docs/education/english-as-code/index.html | 212 +
docs/education/eval-driven-development.md | 460 +
docs/education/eval-driven-development/index.html | 417 +
docs/education/pattern-catalogue.md | 485 +
docs/education/pattern-catalogue/index.html | 416 +
docs/education/portable-skills.md | 289 +
docs/education/portable-skills/index.html | 311 +
docs/education/readme.md | 159 +
docs/education/readme/index.html | 251 +
docs/education/training/instructor-guide.md | 653 +
.../education/training/instructor-guide/index.html | 769 +
.../training/lesson-01-what-agents-are.md | 217 +
.../training/lesson-01-what-agents-are/index.html | 202 +
.../training/lesson-02-working-with-agents.md | 244 +
.../lesson-02-working-with-agents/index.html | 234 +
.../training/lesson-03-choosing-models.md | 240 +
.../training/lesson-03-choosing-models/index.html | 234 +
.../training/lesson-04-your-first-skill.md | 270 +
.../training/lesson-04-your-first-skill/index.html | 257 +
.../training/lesson-05-writing-safe-skills.md | 368 +
.../lesson-05-writing-safe-skills/index.html | 363 +
.../training/lesson-06-debugging-a-skill.md | 352 +
.../lesson-06-debugging-a-skill/index.html | 327 +
.../training/lesson-07-writing-portable-skills.md | 337 +
.../lesson-07-writing-portable-skills/index.html | 313 +
.../training/lesson-08-eval-driven-development.md | 550 +
.../lesson-08-eval-driven-development/index.html | 512 +
.../lesson-09-agentic-and-autonomous-work.md | 486 +
.../index.html | 550 +
.../lesson-10-english-as-a-programming-language.md | 402 +
.../index.html | 562 +
.../training/lesson-11-how-to-contribute.md | 422 +
.../lesson-11-how-to-contribute/index.html | 634 +
docs/education/training/lesson-lab-tutorials.md | 396 +
.../training/lesson-lab-tutorials/index.html | 381 +
docs/education/training/readme.md | 107 +
docs/education/training/readme/index.html | 187 +
docs/education/training/upstream-contribution.md | 247 +
.../training/upstream-contribution/index.html | 327 +
docs/education/tutorials.md | 287 +
docs/education/tutorials/index.html | 259 +
docs/education/what-agents-are.md | 180 +
docs/education/what-agents-are/index.html | 217 +
docs/education/working-with-agents.md | 177 +
docs/education/working-with-agents/index.html | 204 +
docs/education/writing-safe-skills.md | 323 +
docs/education/writing-safe-skills/index.html | 316 +
docs/education/your-first-skill.md | 390 +
docs/education/your-first-skill/index.html | 377 +
docs/extending.md | 122 +
docs/extending/index.html | 216 +
docs/index.html | 50 +
docs/index.md/index.html | 1 +
docs/index/index.html | 1 +
docs/issue-management/readme.md | 205 +
docs/issue-management/readme/index.html | 305 +
docs/labels-and-capabilities.md | 447 +
docs/labels-and-capabilities/index.html | 1111 +
docs/mentoring/readme.md | 205 +
docs/mentoring/readme/index.html | 275 +
docs/mentoring/spec.md | 211 +
docs/mentoring/spec/index.html | 289 +
docs/mode-economics.md | 459 +
docs/mode-economics/index.html | 1140 +
docs/modes.md | 350 +
docs/modes/index.html | 762 +
docs/pairing/readme.md | 196 +
docs/pairing/readme/index.html | 214 +
docs/pilot-report-template.md | 99 +
docs/pilot-report-template/index.html | 116 +
docs/pr-management/readme.md | 202 +
docs/pr-management/readme/index.html | 297 +
docs/principles.md | 126 +
docs/principles/index.html | 127 +
docs/quick-start.md | 371 +
docs/quick-start/families.md | 46 +
docs/quick-start/families/index.html | 160 +
docs/quick-start/first-run.md | 216 +
docs/quick-start/first-run/index.html | 258 +
docs/quick-start/index.html | 372 +
docs/quick-start/other-install-methods.md | 328 +
docs/quick-start/other-install-methods/index.html | 373 +
docs/quick-start/prerequisites.md | 282 +
docs/quick-start/prerequisites/index.html | 296 +
docs/quick-start/readme.md | 24 +
docs/quick-start/readme/index.html | 89 +
docs/quick-start/two-ways.md | 42 +
docs/quick-start/two-ways/index.html | 110 +
docs/release-management/atr-release-runbook.md | 483 +
.../atr-release-runbook/index.html | 560 +
docs/release-management/manual-release-process.md | 386 +
.../manual-release-process/index.html | 366 +
docs/release-management/process.md | 523 +
docs/release-management/process/index.html | 573 +
docs/release-management/readme.md | 301 +
docs/release-management/readme/index.html | 455 +
docs/release-management/spec.md | 843 +
docs/release-management/spec/index.html | 979 +
docs/release-management/svn-release-runbook.md | 289 +
.../svn-release-runbook/index.html | 320 +
docs/repo-health/readme.md | 378 +
docs/repo-health/readme/index.html | 353 +
docs/rfcs/readme.md | 32 +
docs/rfcs/readme/index.html | 109 +
docs/rfcs/rfc-ai-0002.md | 556 +
docs/rfcs/rfc-ai-0002/index.html | 621 +
docs/rfcs/rfc-ai-0003.md | 442 +
docs/rfcs/rfc-ai-0003/index.html | 662 +
docs/rfcs/rfc-ai-0004.md | 375 +
docs/rfcs/rfc-ai-0004/index.html | 441 +
docs/rfcs/rfc-ai-0005.md | 220 +
docs/rfcs/rfc-ai-0005/index.html | 339 +
docs/rfcs/rfc-ai-0006.md | 241 +
docs/rfcs/rfc-ai-0006/index.html | 284 +
docs/rfcs/rfc-ai-0007.md | 177 +
docs/rfcs/rfc-ai-0007/index.html | 199 +
docs/rfcs/rfc-ai-0008.md | 731 +
docs/rfcs/rfc-ai-0008/index.html | 773 +
docs/security/fixing-security-issues.md | 135 +
docs/security/fixing-security-issues/index.html | 183 +
docs/security/forwarder-routing-policy.md | 258 +
docs/security/forwarder-routing-policy/index.html | 318 +
docs/security/how-the-security-team-works.md | 258 +
.../how-the-security-team-works/index.html | 280 +
docs/security/poc-handling-policy.md | 93 +
docs/security/poc-handling-policy/index.html | 133 +
docs/security/process.md | 554 +
docs/security/process/index.html | 614 +
docs/security/readme.md | 253 +
docs/security/readme/index.html | 379 +
docs/security/roles.md | 444 +
docs/security/roles/index.html | 435 +
docs/security/security-model-preparation.md | 238 +
.../security/security-model-preparation/index.html | 293 +
docs/security/threat-model.md | 695 +
docs/security/threat-model/index.html | 1211 +
docs/setup/agentic-overrides.md | 367 +
docs/setup/agentic-overrides/index.html | 364 +
docs/setup/companion-skills.md | 143 +
docs/setup/companion-skills/index.html | 116 +
docs/setup/individual-use.md | 357 +
docs/setup/individual-use/index.html | 343 +
docs/setup/marketplace-install.md | 196 +
docs/setup/marketplace-install/index.html | 201 +
docs/setup/marketplace.md | 672 +
docs/setup/marketplace/index.html | 871 +
docs/setup/per-role-mcp-access.md | 276 +
docs/setup/per-role-mcp-access/index.html | 269 +
docs/setup/privacy-llm.md | 400 +
docs/setup/privacy-llm/index.html | 388 +
docs/setup/readme.md | 214 +
docs/setup/readme/index.html | 285 +
docs/setup/sandbox-troubleshooting.md | 465 +
docs/setup/sandbox-troubleshooting/index.html | 433 +
docs/setup/secure-agent-internals.md | 302 +
docs/setup/secure-agent-internals/index.html | 369 +
docs/setup/secure-agent-setup.md | 2609 ++
docs/setup/secure-agent-setup/index.html | 2460 ++
docs/setup/team-adoption.md | 204 +
docs/setup/team-adoption/index.html | 228 +
docs/setup/uninstall.md | 242 +
docs/setup/uninstall/index.html | 239 +
docs/skill-sources/authoring-a-source.md | 187 +
docs/skill-sources/authoring-a-source/index.html | 212 +
docs/skill-sources/readme.md | 187 +
docs/skill-sources/readme/index.html | 230 +
docs/skill-sources/registry.md | 65 +
docs/skill-sources/registry/index.html | 135 +
docs/source-release-contents.md | 61 +
docs/source-release-contents/index.html | 131 +
docs/spec-driven-development.md | 248 +
docs/spec-driven-development/index.html | 308 +
docs/tools/agent-guard/readme.md | 383 +
docs/tools/agent-guard/readme/index.html | 389 +
docs/tools/agent-isolation/readme.md | 143 +
docs/tools/agent-isolation/readme/index.html | 211 +
docs/tools/apache-projects/readme.md | 44 +
docs/tools/apache-projects/readme/index.html | 81 +
docs/tools/asf-svn/readme.md | 96 +
docs/tools/asf-svn/readme/index.html | 157 +
docs/tools/bitbucket/readme.md | 296 +
docs/tools/bitbucket/readme/index.html | 453 +
docs/tools/change-request/readme.md | 362 +
docs/tools/change-request/readme/index.html | 522 +
docs/tools/cve-org/readme.md | 32 +
docs/tools/cve-org/readme/index.html | 71 +
docs/tools/cve-tool-vulnogram/readme.md | 40 +
docs/tools/cve-tool-vulnogram/readme/index.html | 76 +
docs/tools/cve-tool/readme.md | 406 +
docs/tools/cve-tool/readme/index.html | 493 +
docs/tools/dashboard-generator/readme.md | 104 +
docs/tools/dashboard-generator/readme/index.html | 149 +
docs/tools/dev/readme.md | 68 +
docs/tools/dev/readme/index.html | 158 +
docs/tools/egress-gateway/readme.md | 107 +
docs/tools/egress-gateway/readme/index.html | 120 +
docs/tools/forwarder-relay/readme.md | 436 +
docs/tools/forwarder-relay/readme/index.html | 504 +
docs/tools/fossil/readme.md | 48 +
docs/tools/fossil/readme/index.html | 84 +
docs/tools/github-body-field/readme.md | 114 +
docs/tools/github-body-field/readme/index.html | 152 +
docs/tools/github-rollup/readme.md | 96 +
docs/tools/github-rollup/readme/index.html | 139 +
docs/tools/github/readme.md | 37 +
docs/tools/github/readme/index.html | 74 +
docs/tools/gmail/readme.md | 41 +
docs/tools/gmail/readme/index.html | 79 +
docs/tools/jira-patch/readme.md | 133 +
docs/tools/jira-patch/readme/index.html | 187 +
docs/tools/jira/readme.md | 299 +
docs/tools/jira/readme/index.html | 251 +
docs/tools/mail-archive/readme.md | 383 +
docs/tools/mail-archive/readme/index.html | 547 +
docs/tools/mail-patch/readme.md | 140 +
docs/tools/mail-patch/readme/index.html | 193 +
docs/tools/mail-source/readme.md | 42 +
docs/tools/mail-source/readme/index.html | 79 +
docs/tools/maildir/readme.md | 150 +
docs/tools/maildir/readme/index.html | 200 +
docs/tools/permission-audit/readme.md | 264 +
docs/tools/permission-audit/readme/index.html | 271 +
docs/tools/pilot-report-validator/readme.md | 73 +
.../tools/pilot-report-validator/readme/index.html | 106 +
docs/tools/ponymail/readme.md | 45 +
docs/tools/ponymail/readme/index.html | 80 +
docs/tools/pr-management-stats/readme.md | 178 +
docs/tools/pr-management-stats/readme/index.html | 198 +
docs/tools/preflight-audit/readme.md | 137 +
docs/tools/preflight-audit/readme/index.html | 147 +
docs/tools/privacy-llm/readme.md | 21 +
docs/tools/privacy-llm/readme/index.html | 63 +
docs/tools/probe-templates/readme.md | 107 +
docs/tools/probe-templates/readme/index.html | 136 +
docs/tools/sandbox-lint/readme.md | 232 +
docs/tools/sandbox-lint/readme/index.html | 246 +
docs/tools/scan-format/readme.md | 121 +
docs/tools/scan-format/readme/index.html | 195 +
.../security-tracker-stats-dashboard/readme.md | 300 +
.../readme/index.html | 405 +
docs/tools/skill-and-tool-validator/readme.md | 92 +
.../skill-and-tool-validator/readme/index.html | 125 +
docs/tools/skill-evals/readme.md | 445 +
docs/tools/skill-evals/readme/index.html | 430 +
docs/tools/skill-reconciler-diff/readme.md | 144 +
docs/tools/skill-reconciler-diff/readme/index.html | 190 +
docs/tools/skill-token-count/readme.md | 169 +
docs/tools/skill-token-count/readme/index.html | 177 +
docs/tools/sourcehut/readme.md | 50 +
docs/tools/sourcehut/readme/index.html | 97 +
docs/tools/spec-inventory/readme.md | 72 +
docs/tools/spec-inventory/readme/index.html | 97 +
docs/tools/spec-loop/readme.md | 167 +
docs/tools/spec-loop/readme/index.html | 214 +
docs/tools/spec-status-index/readme.md | 63 +
docs/tools/spec-status-index/readme/index.html | 113 +
docs/tools/spec-validator/readme.md | 55 +
docs/tools/spec-validator/readme/index.html | 91 +
docs/tools/symlink-lint/readme.md | 112 +
docs/tools/symlink-lint/readme/index.html | 143 +
docs/tools/vcs/readme.md | 124 +
docs/tools/vcs/readme/index.html | 222 +
docs/tools/vendor-neutrality-score/readme.md | 101 +
.../vendor-neutrality-score/readme/index.html | 147 +
docs/tools/vetted-ops/readme.md | 298 +
docs/tools/vetted-ops/readme/index.html | 308 +
docs/updating-magpie.md | 47 +
docs/updating-magpie/index.html | 88 +
docs/utilities/readme.md | 158 +
docs/utilities/readme/index.html | 190 +
docs/vendor-neutrality.md | 670 +
docs/vendor-neutrality/index.html | 1001 +
downloads/index.html | 27 +
favicon.ico | Bin 0 -> 15086 bytes
favicon.svg | 1 +
illustrations/magpie/3d/README.md | 21 +
illustrations/magpie/3d/magpie-flying.png | Bin 0 -> 733426 bytes
illustrations/magpie/3d/magpie-front.png | Bin 0 -> 590690 bytes
illustrations/magpie/3d/magpie-looking-back.png | Bin 0 -> 590027 bytes
illustrations/magpie/README.md | 23 +
illustrations/magpie/magpie-flying.png | Bin 0 -> 504759 bytes
illustrations/magpie/magpie-looking-back.png | Bin 0 -> 376308 bytes
illustrations/magpie/magpie-standing.png | Bin 0 -> 375973 bytes
index.html | 19 +
llms-full.txt | 41274 +++++++++++++++++++
llms.txt | 194 +
magpie-mark.png | Bin 0 -> 40625 bytes
magpie-mascot.png | Bin 0 -> 303273 bytes
mark.svg | 1 +
og-image.png | Bin 0 -> 102843 bytes
photos/README.md | 27 +
photos/building-tools.jpg | Bin 0 -> 88554 bytes
photos/collaboration.jpg | Bin 0 -> 218841 bytes
photos/health-review.jpg | Bin 0 -> 60030 bytes
photos/maintainer-work.jpg | Bin 0 -> 124068 bytes
photos/pair-work.jpg | Bin 0 -> 63553 bytes
photos/release-planning.jpg | Bin 0 -> 98665 bytes
photos/security-review.jpg | Bin 0 -> 138954 bytes
photos/team-discussion.jpg | Bin 0 -> 83073 bytes
photos/team-review.jpg | Bin 0 -> 76763 bytes
photos/teamwork.jpg | Bin 0 -> 366417 bytes
photos/workshop.jpg | Bin 0 -> 68259 bytes
resources/index.html | 19 +
robots.txt | 2 +
sitemap-0.xml | 1 +
sitemap-index.xml | 1 +
skills/adapters/add-a-harness/index.html | 1 +
skills/adapters/authoring/index.html | 1 +
skills/adapters/codex/index.html | 1 +
skills/adapters/cursor/index.html | 1 +
skills/adapters/gemini/index.html | 1 +
skills/adapters/goose/index.html | 1 +
skills/adapters/kiro/index.html | 1 +
skills/adapters/local-llm/index.html | 1 +
skills/adapters/opencode/index.html | 1 +
skills/adapters/readme/index.html | 1 +
skills/adapters/registry/index.html | 1 +
skills/confidentiality/index.html | 1 +
skills/contributor-growth/readme/index.html | 1 +
skills/contributor-sentiment/index.html | 1 +
.../2026-09-13-install-adopt-upgrade/index.html | 1 +
skills/designs/readme/index.html | 1 +
skills/editorial-guidelines/index.html | 1 +
skills/education/agentic-work/index.html | 1 +
skills/education/choosing-models/index.html | 1 +
skills/education/contributing/index.html | 1 +
skills/education/debugging-skills/index.html | 1 +
skills/education/english-as-code/index.html | 1 +
.../education/eval-driven-development/index.html | 1 +
skills/education/pattern-catalogue/index.html | 1 +
skills/education/portable-skills/index.html | 1 +
skills/education/readme/index.html | 1 +
.../education/training/instructor-guide/index.html | 1 +
.../training/lesson-01-what-agents-are/index.html | 1 +
.../lesson-02-working-with-agents/index.html | 1 +
.../training/lesson-03-choosing-models/index.html | 1 +
.../training/lesson-04-your-first-skill/index.html | 1 +
.../lesson-05-writing-safe-skills/index.html | 1 +
.../lesson-06-debugging-a-skill/index.html | 1 +
.../lesson-07-writing-portable-skills/index.html | 1 +
.../lesson-08-eval-driven-development/index.html | 1 +
.../index.html | 1 +
.../index.html | 1 +
.../lesson-11-how-to-contribute/index.html | 1 +
.../training/lesson-lab-tutorials/index.html | 1 +
skills/education/training/readme/index.html | 1 +
.../training/upstream-contribution/index.html | 1 +
skills/education/tutorials/index.html | 1 +
skills/education/what-agents-are/index.html | 1 +
skills/education/working-with-agents/index.html | 1 +
skills/education/writing-safe-skills/index.html | 1 +
skills/education/your-first-skill/index.html | 1 +
skills/extending/index.html | 1 +
skills/index.html | 1 +
skills/index/index.html | 1 +
skills/issue-management/readme/index.html | 1 +
skills/labels-and-capabilities/index.html | 1 +
skills/mentoring/readme/index.html | 1 +
skills/mentoring/spec/index.html | 1 +
skills/mode-economics/index.html | 1 +
skills/modes/index.html | 1 +
skills/pairing/readme/index.html | 1 +
skills/pilot-report-template/index.html | 1 +
skills/pr-management/readme/index.html | 1 +
skills/principles/index.html | 1 +
skills/quick-start/families/index.html | 1 +
skills/quick-start/first-run/index.html | 1 +
skills/quick-start/index.html | 1 +
.../quick-start/other-install-methods/index.html | 1 +
skills/quick-start/prerequisites/index.html | 1 +
skills/quick-start/readme/index.html | 1 +
skills/quick-start/two-ways/index.html | 1 +
.../atr-release-runbook/index.html | 1 +
.../manual-release-process/index.html | 1 +
skills/release-management/process/index.html | 1 +
skills/release-management/readme/index.html | 1 +
skills/release-management/spec/index.html | 1 +
.../svn-release-runbook/index.html | 1 +
skills/repo-health/readme/index.html | 1 +
skills/rfcs/readme/index.html | 1 +
skills/rfcs/rfc-ai-0002/index.html | 1 +
skills/rfcs/rfc-ai-0003/index.html | 1 +
skills/rfcs/rfc-ai-0004/index.html | 1 +
skills/rfcs/rfc-ai-0005/index.html | 1 +
skills/rfcs/rfc-ai-0006/index.html | 1 +
skills/rfcs/rfc-ai-0007/index.html | 1 +
skills/rfcs/rfc-ai-0008/index.html | 1 +
skills/security/fixing-security-issues/index.html | 1 +
.../security/forwarder-routing-policy/index.html | 1 +
.../how-the-security-team-works/index.html | 1 +
skills/security/poc-handling-policy/index.html | 1 +
skills/security/process/index.html | 1 +
skills/security/readme/index.html | 1 +
skills/security/roles/index.html | 1 +
.../security/security-model-preparation/index.html | 1 +
skills/security/threat-model/index.html | 1 +
skills/setup/agentic-overrides/index.html | 1 +
skills/setup/companion-skills/index.html | 1 +
skills/setup/individual-use/index.html | 1 +
skills/setup/marketplace-install/index.html | 1 +
skills/setup/marketplace/index.html | 1 +
skills/setup/per-role-mcp-access/index.html | 1 +
skills/setup/privacy-llm/index.html | 1 +
skills/setup/readme/index.html | 1 +
skills/setup/sandbox-troubleshooting/index.html | 1 +
skills/setup/secure-agent-internals/index.html | 1 +
skills/setup/secure-agent-setup/index.html | 1 +
skills/setup/team-adoption/index.html | 1 +
skills/setup/uninstall/index.html | 1 +
skills/skill-sources/authoring-a-source/index.html | 1 +
skills/skill-sources/readme/index.html | 1 +
skills/skill-sources/registry/index.html | 1 +
skills/source-release-contents/index.html | 1 +
skills/spec-driven-development/index.html | 1 +
skills/tools/agent-guard/readme/index.html | 1 +
skills/tools/agent-isolation/readme/index.html | 1 +
skills/tools/apache-projects/readme/index.html | 1 +
skills/tools/asf-svn/readme/index.html | 1 +
skills/tools/bitbucket/readme/index.html | 1 +
skills/tools/change-request/readme/index.html | 1 +
skills/tools/cve-org/readme/index.html | 1 +
skills/tools/cve-tool-vulnogram/readme/index.html | 1 +
skills/tools/cve-tool/readme/index.html | 1 +
skills/tools/dashboard-generator/readme/index.html | 1 +
skills/tools/dev/readme/index.html | 1 +
skills/tools/egress-gateway/readme/index.html | 1 +
skills/tools/forwarder-relay/readme/index.html | 1 +
skills/tools/fossil/readme/index.html | 1 +
skills/tools/github-body-field/readme/index.html | 1 +
skills/tools/github-rollup/readme/index.html | 1 +
skills/tools/github/readme/index.html | 1 +
skills/tools/gmail/readme/index.html | 1 +
skills/tools/jira-patch/readme/index.html | 1 +
skills/tools/jira/readme/index.html | 1 +
skills/tools/mail-archive/readme/index.html | 1 +
skills/tools/mail-patch/readme/index.html | 1 +
skills/tools/mail-source/readme/index.html | 1 +
skills/tools/maildir/readme/index.html | 1 +
skills/tools/permission-audit/readme/index.html | 1 +
.../tools/pilot-report-validator/readme/index.html | 1 +
skills/tools/ponymail/readme/index.html | 1 +
skills/tools/pr-management-stats/readme/index.html | 1 +
skills/tools/preflight-audit/readme/index.html | 1 +
skills/tools/privacy-llm/readme/index.html | 1 +
skills/tools/probe-templates/readme/index.html | 1 +
skills/tools/sandbox-lint/readme/index.html | 1 +
skills/tools/scan-format/readme/index.html | 1 +
.../readme/index.html | 1 +
.../skill-and-tool-validator/readme/index.html | 1 +
skills/tools/skill-evals/readme/index.html | 1 +
.../tools/skill-reconciler-diff/readme/index.html | 1 +
skills/tools/skill-token-count/readme/index.html | 1 +
skills/tools/sourcehut/readme/index.html | 1 +
skills/tools/spec-inventory/readme/index.html | 1 +
skills/tools/spec-loop/readme/index.html | 1 +
skills/tools/spec-status-index/readme/index.html | 1 +
skills/tools/spec-validator/readme/index.html | 1 +
skills/tools/symlink-lint/readme/index.html | 1 +
skills/tools/vcs/readme/index.html | 1 +
.../vendor-neutrality-score/readme/index.html | 1 +
skills/tools/vetted-ops/readme/index.html | 1 +
skills/updating-magpie/index.html | 1 +
skills/utilities/readme/index.html | 1 +
skills/vendor-neutrality/index.html | 1 +
styled-logo.svg | 259 +
subframe-mark.svg | 1 +
subframe-styled.svg | 11 +
subframe-wordmark.png | Bin 0 -> 304964 bytes
tools/index.html | 128 +
vendor-logos/atlassian.svg | 1 +
vendor-logos/git.svg | 1 +
vendor-logos/github.svg | 1 +
vendor-logos/google.svg | 1 +
vendor-logos/oak.svg | 1 +
vendor-logos/subversion.svg | 1 +
wordmark.svg | 11 +
749 files changed, 141228 insertions(+)
diff --git a/.asf.yaml b/.asf.yaml
new file mode 100644
index 0000000..442cf9a
--- /dev/null
+++ b/.asf.yaml
@@ -0,0 +1,5 @@
+# Generated by preview-publish. Do not edit.
+# Serves this branch at https://magpie-pr180.staged.apache.org/
+staging:
+ profile: pr180
+ whoami: preview/pr180-staging
diff --git a/.htaccess b/.htaccess
new file mode 100644
index 0000000..05c74ff
--- /dev/null
+++ b/.htaccess
@@ -0,0 +1,39 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+# Astro copies public/ into dist/ verbatim, and CI force-pushes dist/ to the
+# `publish` branch that ASF infrastructure serves at magpie.apache.org, so
+# this file lands at the site root.
+
+# Unknown paths must answer 404, never a 200 with the app shell. Astro writes
+# 404.html at build time; without ErrorDocument the ASF web server answers
+# with its own bare "Not Found" body and the page's recovery links are lost.
+ErrorDocument 404 /404.html
+
+# Root discovery files and the .md twins carry the Markdown media type. The
+# twins are alternates of the HTML page, not pages, so they stay out of
+# search results.
+<Files "llms.txt">
+ Header set Content-Type "text/markdown; charset=utf-8"
+</Files>
+<Files "llms-full.txt">
+ Header set Content-Type "text/markdown; charset=utf-8"
+</Files>
+<FilesMatch "\.md$">
+ Header set Content-Type "text/markdown; charset=utf-8"
+ Header set X-Robots-Tag "noindex"
+</FilesMatch>
diff --git a/404.html b/404.html
new file mode 100644
index 0000000..3a0fad9
--- /dev/null
+++ b/404.html
@@ -0,0 +1 @@
+<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><meta name="robots" content="noindex"><title>Page not found — Apache Magpie</title></head><body><main><h1>Page not found</h1><p>There is no page at this address on Apache Magpie. It may have moved when the documentation was reorganised.</p><ul><li><a href="/docs/">Documentation index</a></li><li><a href="/">Home</a></li><li><a href="https://magpie.apache.org/llms [...]
\ No newline at end of file
diff --git a/_astro/AnimationLab.Dgrvysdu.js b/_astro/AnimationLab.Dgrvysdu.js
new file mode 100644
index 0000000..a789a66
--- /dev/null
+++ b/_astro/AnimationLab.Dgrvysdu.js
@@ -0,0 +1 @@
+import{r as e,t}from"./react.CYuo-Lgd.js";import{r as n,t as r}from"./jsx-runtime.WQvrtk7F.js";import{t as i}from"./MagpieFlight.jfKZeDdE.js";var a=e(t(),1),o=r();function s(){let[e,t]=(0,a.useState)(0),[r,s]=(0,a.useState)(`reference`),[c,l]=(0,a.useState)(!1),[u,d]=(0,a.useState)(!1),[f,p]=(0,a.useState)(1),[m,h]=(0,a.useState)(0),g=e=>{l(!1),h(e),d(!1),t(e=>e+1)};return(0,o.jsxs)(`main`,{className:`animation-lab`,children:[(0,o.jsxs)(`header`,{children:[(0,o.jsxs)(`div`,{children:[(0, [...]
\ No newline at end of file
diff --git a/_astro/BaseLayout.H4DLRpYn.css b/_astro/BaseLayout.H4DLRpYn.css
new file mode 100644
index 0000000..8036932
--- /dev/null
+++ b/_astro/BaseLayout.H4DLRpYn.css
@@ -0,0 +1,2 @@
+/*! tailwindcss v4.3.3 | MIT License | https://tailwindcss.com */
+@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){:root,:host{--shimmer-angle:20deg}*,:before,:after,::backdrop{--tw-translate-x:0;--tw-translate-y:0;--tw-translate-z:0;--tw-scale-x:1;--tw-scale-y:1;--tw-scale-z:1;--tw-rotate-x:initial;--tw-rotate-y:initial;--tw-rotate-z:initial;--tw-skew-x:initial;--tw-skew-y:initial;--tw-border-style:solid;--tw-gradient-position:initial;--tw-gradient-fro [...]
diff --git a/_astro/KineticHome.C-3-oRUu.js b/_astro/KineticHome.C-3-oRUu.js
new file mode 100644
index 0000000..5bfc1a1
--- /dev/null
+++ b/_astro/KineticHome.C-3-oRUu.js
@@ -0,0 +1 @@
+import{r as e,t}from"./react.CYuo-Lgd.js";import{n,r,t as i}from"./jsx-runtime.WQvrtk7F.js";import{t as a}from"./MagpieFlight.jfKZeDdE.js";import{n as o,r as s}from"./TerminalDemo.D3XxO7w3.js";import{n as c,t as l}from"./arrow-up-right.DdKwi7mE.js";import{n as u,r as d,t as f}from"./copy.Dfz5KN2B.js";var p=e(t(),1);function m(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,`value`in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}function [...]
\ No newline at end of file
diff --git a/_astro/KineticResources.CxkDmVTE.js b/_astro/KineticResources.CxkDmVTE.js
new file mode 100644
index 0000000..85c9b25
--- /dev/null
+++ b/_astro/KineticResources.CxkDmVTE.js
@@ -0,0 +1 @@
+import{r as e,t}from"./react.CYuo-Lgd.js";import{r as n,t as r}from"./jsx-runtime.WQvrtk7F.js";import{t as i}from"./arrow-up-right.DdKwi7mE.js";import{n as a,r as o,t as s}from"./copy.Dfz5KN2B.js";var c=e(t(),1),l=r();function u({href:e,children:t}){return(0,l.jsxs)(`a`,{className:`k-link`,href:e.startsWith(`/`)?n(e):e,target:`_blank`,rel:`noreferrer`,children:[t,(0,l.jsx)(i,{size:16,"aria-hidden":`true`})]})}var d=[{title:`Working with agents`,description:`Get oriented before you build. [...]
\ No newline at end of file
diff --git a/_astro/MagpieFlight.jfKZeDdE.js b/_astro/MagpieFlight.jfKZeDdE.js
new file mode 100644
index 0000000..fc5c39c
--- /dev/null
+++ b/_astro/MagpieFlight.jfKZeDdE.js
@@ -0,0 +1,53 @@
+import{r as e,t}from"./react.CYuo-Lgd.js";import{r as n,t as r}from"./jsx-runtime.WQvrtk7F.js";var i=e(t(),1),a=r(),o=(function(){let e=typeof document<`u`&&document.createElement(`link`).relList;return e&&e.supports&&e.supports(`modulepreload`)?`modulepreload`:`preload`})(),s=function(e){return`/`+e},c={},l=function(e,t,n){let r=Promise.resolve();if(t&&t.length>0){let e=document.getElementsByTagName(`link`),i=document.querySelector(`meta[property=csp-nonce]`),a=i?.nonce||i?.getAttribute [...]
+ vec3 turnHead(vec3 p, float weight) {
+ float cy=cos(headAngles.x*weight), sy=sin(headAngles.x*weight);
+ float cz=cos(headAngles.y*weight), sz=sin(headAngles.y*weight);
+ vec3 q=vec3(cz*p.x-sz*p.y, sz*p.x+cz*p.y, p.z);
+ return vec3(cy*q.x+sy*q.z,q.y,-sy*q.x+cy*q.z);
+ }
+ vec3 poseHead(vec3 p) {
+ vec3 pivot=vec3(.10,1.17,0.);
+ float weight=smoothstep(.32,.92,p.y);
+ return turnHead(p-pivot,weight)+pivot+vec3(neckOffset,0.)*weight;
+ }
+`+e.vertexShader,e.vertexShader=e.vertexShader.replace(`#include <begin_vertex>`,`
+ #include <begin_vertex>
+ restPosition=position;
+ transformed=poseHead(position);
+ `).replace(`#include <beginnormal_vertex>`,`
+ #include <beginnormal_vertex>
+ // Derive normals from the bent surface, including the neck transition.
+ vec3 axis=abs(objectNormal.y)<.9?vec3(0.,1.,0.):vec3(1.,0.,0.);
+ vec3 tangent=normalize(cross(axis,objectNormal));
+ vec3 bitangent=cross(objectNormal,tangent);
+ vec3 posed=poseHead(position);
+ objectNormal=normalize(cross(poseHead(position+tangent*.001)-posed,poseHead(position+bitangent*.001)-posed));
+ `),e.fragmentShader=`varying vec3 restPosition;
+`+e.fragmentShader,e.fragmentShader=e.fragmentShader.replace(`#include <color_fragment>`,`
+ #include <color_fragment>
+ float bibSide=smoothstep(-.15,-.13,restPosition.x);
+ float bibCrest=.13*exp(-restPosition.z*restPosition.z/.045);
+ float bibEdge=.43+restPosition.x*.86+bibCrest;
+ float bibTop=1.-smoothstep(bibEdge,bibEdge+.02,restPosition.y);
+ float bibBottom=smoothstep(-.79,-.70,restPosition.y);
+ diffuseColor.rgb=mix(diffuseColor.rgb,vec3(.98,.965,.94),bibSide*bibTop*bibBottom);
+ `)};let C=new r.Mesh(x,S);C.castShadow=!0,C.receiveShadow=!0,v.add(C);let w=new r.Group;w.position.set(.1,1.17,0),v.add(w);let ce={value:0},T=g.clone(),E=ne.clone();for(let e of[T,E])e.side=r.DoubleSide,e.onBeforeCompile=e=>{e.uniforms.eyelid=ce,e.uniforms.lidColor={value:h.color},e.vertexShader=`varying float eyeHeight;
+`+e.vertexShader,e.vertexShader=e.vertexShader.replace(`#include <begin_vertex>`,`#include <begin_vertex>
+eyeHeight=position.y-.06;`),e.fragmentShader=`uniform float eyelid; uniform vec3 lidColor; varying float eyeHeight;
+`+e.fragmentShader,e.fragmentShader=e.fragmentShader.replace(`#include <color_fragment>`,`
+ #include <color_fragment>
+ float upper=mix(.235,-.24,eyelid);
+ float lower=mix(-.235,-.17,eyelid);
+ float covered=max(smoothstep(upper-.006,upper+.006,eyeHeight),1.-smoothstep(lower-.006,lower+.006,eyeHeight));
+ diffuseColor.rgb=mix(diffuseColor.rgb,lidColor,covered);
+ `)};let D=[],O=y.getPoints(1e3),le=e=>{let t=0,n=O.length-1;for(;n-t>1;){let r=t+n>>1;O[r].y<e?t=r:n=r}let r=O[t],i=O[n];return r.clone().lerp(i,(e-r.y)/(i.y-r.y))};for(let e of[-1,1]){let t=[],n=[];for(let r=0;r<=16;r++){let i=r/16;for(let a=0;a<=64;a++){let o=a/64*Math.PI*2,s=1.23+Math.sin(o)*.23*i,c=e*(.98+Math.cos(o)*.37*i),l=le(s);if(t.push(l.z+(l.x+.012)*Math.cos(c)-.1,s-1.17,(l.x*.86+.012)*Math.sin(c)),r<16&&a<64){let e=r*65+a;n.push(e,e+1,e+64+1,e+1,e+64+2,e+64+1)}}}l [...]
+`+e.vertexShader,e.vertexShader=e.vertexShader.replace(`#include <begin_vertex>`,`#include <begin_vertex>
+wingRest=position;`),e.fragmentShader=`varying vec3 wingRest;
+`+e.fragmentShader,e.fragmentShader=e.fragmentShader.replace(`#include <color_fragment>`,`
+ #include <color_fragment>
+ float center=-.10*wingRest.z;
+ vec2 patchCoord=vec2((wingRest.x-center)/.21,(wingRest.z-.65)/.52);
+ float ellipseMask=dot(patchCoord,patchCoord);
+ float marking=(1.-smoothstep(.90,1.,ellipseMask))*smoothstep(.015,.045,wingRest.y);
+ diffuseColor.rgb=mix(diffuseColor.rgb,vec3(.98,.965,.94),marking);
+ `)};let u=new r.Mesh(s,l);t.add(u),ve.push(s),ye.push(l),_e.push({root:t,wrist:n,surface:c,side:e})}let be=[],xe=(e,t,n)=>{let i=new r.CatmullRomCurve3(t),a=i.computeFrenetFrames(48,!1),o=[],s=[];for(let e=0;e<=48;e++){let t=e/48,c=i.getPointAt(t),l=t*(n.length-1),u=Math.min(Math.floor(l),n.length-2),d=l-u,f=d*d*(3-2*d),p=n[u+1]===0?n[u]*Math.sqrt(Math.max(0,1-d*d)):r.MathUtils.lerp(n[u],n[u+1],f);for(let t=0;t<=20;t++){let n=t/20*Math.PI*2,r=c.clone().addScaledVector(a.norma [...]
\ No newline at end of file
diff --git a/_astro/TerminalDemo.D3XxO7w3.js b/_astro/TerminalDemo.D3XxO7w3.js
new file mode 100644
index 0000000..bc6aeee
--- /dev/null
+++ b/_astro/TerminalDemo.D3XxO7w3.js
@@ -0,0 +1,49 @@
+import{r as e,t}from"./react.CYuo-Lgd.js";import{r as n,t as r}from"./jsx-runtime.WQvrtk7F.js";import{n as i,t as a}from"./arrow-up-right.DdKwi7mE.js";var o=e(t(),1);function s(e){if(e===void 0)throw ReferenceError(`this hasn't been initialised - super() hasn't been called`);return e}function c(e,t){e.prototype=Object.create(t.prototype),e.prototype.constructor=e,e.__proto__=t}var l={autoSleep:120,force3D:`auto`,nullTargetWarn:1,units:{lineHeight:``}},u={duration:.5,overwrite:!1,delay:0} [...]
+Fictional repository · simulated actions · no account required
+Choose a task below or type help. No shell commands are executed.`},Ci={prs:`#142 Fix empty search results → needs-review
+ Adds an empty-state guard. Regression test included.
+#145 Add export documentation → ready-for-review
+ Documentation only. No runtime changes.
+#148 Upgrade runtime dependency → needs-testing
+ Compatibility evidence is missing. Ask the author for tests.`,issues:`#81 Export fails with an empty list → needs-reproduction
+ Missing version and reproduction steps.
+#84 Empty export crashes → possible-duplicate
+ Similar symptom to #81; maintainer confirmation needed.
+#89 Improve keyboard focus → enhancement
+ Clear accessibility request with a focused scope.`},wi=`Illustrative diff for PR #142
+
+--- a/search.ts
++++ b/search.ts
+@@
+- return results[0].title;
++ return results.length ? results[0].title : "No results";
+
+--- a/search.test.ts
++++ b/search.test.ts
+@@
++ expect(firstTitle([])).toBe("No results");
+
+Review note: confirm the empty-state text matches the product conventions.
+No tests were executed in this simulation.`;function Ti(){let[e,t]=(0,o.useState)([Si]),[r,i]=(0,o.useState)(`prs`),[s,c]=(0,o.useState)(!1),[l,u]=(0,o.useState)(``),[d,f]=(0,o.useState)(!1),p=(0,o.useRef)(null),m=(0,o.useRef)(null),h=(0,o.useRef)(null);(0,o.useEffect)(()=>()=>{p.current&&clearTimeout(p.current)},[]),(0,o.useEffect)(()=>{m.current&&(m.current.scrollTop=m.current.scrollHeight)},[e]);function g(e,n){t(t=>[...t,{kind:e,text:n}])}function _(e){let t=e.trim();if(!t||d)return; [...]
+You can also ask: “Review the open pull requests”.
+This guided demo supports these tasks; it is not connected to an LLM.`);return}if([`restart`,`reset`,`clear`,`reiniciar`].includes(n)){v();return}if([`y`,`yes`,`approve`,`aprovar`].includes(n)){if(!s){g(`muted`,`There is no proposal waiting for approval. Start a triage first.`);return}g(`result`,r===`prs`?`Simulated approval recorded.
+#142 → needs-review
+#145 → ready-for-review
+#148 → needs-testing
+
+Audit: 3 proposed labels approved by you. No merge or external write occurred.`:`Simulated approval recorded.
+#81 → needs-reproduction
+#84 → possible-duplicate (left open)
+#89 → enhancement
+
+Audit: labels approved by you. No issues were closed or changed externally.`),c(!1);return}if([`n`,`no`,`reject`,`recusar`].includes(n)){if(!s){g(`muted`,`There is no pending proposal. Start a triage first.`);return}g(`muted`,`Proposal kept as a draft. No labels applied.
+You can inspect details, view the diff, or start another task.`),c(!1);return}if(/^(diff|patch|show diff|ver diff)$/.test(n)){g(`result`,r===`prs`?wi:`Issue triage has not produced a patch. Reproduce #81 first.
+Switch to PR triage to inspect the sample diff for #142.`);return}if(/^(details|detail|why|explain|detalhes)$/.test(n)){g(`result`,r===`prs`?`Why #148 needs testing:
+The runtime version changed, but the PR includes no compatibility tests.
+Suggested next step: ask the author to run the supported runtime matrix.
+
+Draft comment: “Could you include the compatibility results for the supported runtimes?”
+This comment has not been posted.`:`Why #84 is only a possible duplicate:
+Both reports mention empty exports, but neither supplies a full reproduction.
+Ask for the version, sample input, and expected result before closing either issue.`);return}if(/triage|review|pull request|\bprs?\b|issues|backlog|revis|fila/.test(n)){let e=/issue|backlog/.test(n)?`issues`:`prs`;i(e),c(!1),f(!0),g(`muted`,`Reading the fictional project context and 3 ${e===`prs`?`pull requests`:`issues`}…`),p.current=setTimeout(()=>{g(`result`,Ci[e]),g(`gate`,`Apply these proposed labels? Type approve or reject.
+Use details to inspect the reasoning before deciding.`),c(!0),f(!1),p.current=null},850);return}g(`muted`,`That request is outside this guided demo. Try “triage PRs”, “triage issues”, or “help”. No command was executed.`)}function v(){p.current&&clearTimeout(p.current),p.current=null,t([Si]),c(!1),f(!1),u(``),i(`prs`),h.current?.focus()}return(0,$.jsxs)(`div`,{className:`t-demo-page`,children:[(0,$.jsxs)(`header`,{className:`t-demo-header`,children:[(0,$.jsxs)(`a`,{href:n(`/`),"aria-labe [...]
\ No newline at end of file
diff --git a/_astro/TerminalDemo.Dr_RgvG1.js b/_astro/TerminalDemo.Dr_RgvG1.js
new file mode 100644
index 0000000..45ddfe4
--- /dev/null
+++ b/_astro/TerminalDemo.Dr_RgvG1.js
@@ -0,0 +1 @@
+import{n as e,t}from"./TerminalDemo.D3XxO7w3.js";export{e as TerminalPreview,t as default};
\ No newline at end of file
diff --git a/_astro/TerminalDemo._B8BWLul.css b/_astro/TerminalDemo._B8BWLul.css
new file mode 100644
index 0000000..aea78bd
--- /dev/null
+++ b/_astro/TerminalDemo._B8BWLul.css
@@ -0,0 +1 @@
+.t-preview{background:#e7ecf7;padding-top:48px;padding-bottom:42px}.t-preview-heading{justify-content:space-between;align-items:end;gap:30px;margin-bottom:28px;display:flex}.t-preview-heading h2{letter-spacing:-.05em;font-size:clamp(34px,3.3vw,52px);line-height:1.05}.t-preview-heading h2 span{color:#2359eb}.t-preview-heading p{color:#516078;line-height:1.6}.t-window{color:#e5eaf4;background:#131a26;border:1px solid #334053;border-radius:13px;overflow:hidden;box-shadow:0 18px 40px #1b3452 [...]
diff --git a/_astro/animation-test.CneHVBNE.css b/_astro/animation-test.CneHVBNE.css
new file mode 100644
index 0000000..6a30716
--- /dev/null
+++ b/_astro/animation-test.CneHVBNE.css
@@ -0,0 +1 @@
+@font-face{font-family:Geist Variable;font-style:normal;font-display:swap;font-weight:100 900;src:url(/_astro/geist-cyrillic-ext-wght-normal.DjL33-gN.woff2)format("woff2-variations");unicode-range:U+460-52F,U+1C80-1C8A,U+20B4,U+2DE0-2DFF,U+A640-A69F,U+FE2E-FE2F}@font-face{font-family:Geist Variable;font-style:normal;font-display:swap;font-weight:100 900;src:url(/_astro/geist-cyrillic-wght-normal.BEAKL7Jp.woff2)format("woff2-variations");unicode-range:U+301,U+400-45F,U+490-491,U+4B0-4B1,U [...]
diff --git a/_astro/arrow-up-right.DdKwi7mE.js b/_astro/arrow-up-right.DdKwi7mE.js
new file mode 100644
index 0000000..949bf7d
--- /dev/null
+++ b/_astro/arrow-up-right.DdKwi7mE.js
@@ -0,0 +1 @@
+import{r as e,t}from"./react.CYuo-Lgd.js";var n=e(t(),1),r=e=>e?.replace(/([a-z0-9])([A-Z])/g,`$1-$2`).toLowerCase();function i(e,t,n=[]){if(t==null)throw Error(`[lucide]: iconNode is required when icon name is used`);return{name:r(e),size:24,node:t,...n.length>0?{aliases:n}:{}}}var a=e=>{let t=``,n=!1;for(let r of e){if(r===`-`||r===`_`||r<=` `){n=t.length>0;continue}t.length===0?t+=r.toLowerCase():t+=n?r.toUpperCase():r,n=!1}return t},o=e=>{let t=a(e);return t.charAt(0).toUpperCase()+t [...]
\ No newline at end of file
diff --git a/_astro/client.bxcwkfp-.js b/_astro/client.bxcwkfp-.js
new file mode 100644
index 0000000..dd29ac3
--- /dev/null
+++ b/_astro/client.bxcwkfp-.js
@@ -0,0 +1,9 @@
+import{n as e,r as t,t as n}from"./react.CYuo-Lgd.js";var r=e((e=>{function t(e,t){var n=e.length;e.push(t);a:for(;0<n;){var r=n-1>>>1,a=e[r];if(0<i(a,t))e[r]=t,e[n]=a,n=r;else break a}}function n(e){return e.length===0?null:e[0]}function r(e){if(e.length===0)return null;var t=e[0],n=e.pop();if(n!==t){e[0]=n;a:for(var r=0,a=e.length,o=a>>>1;r<o;){var s=2*(r+1)-1,c=e[s],l=s+1,u=e[l];if(0>i(c,n))l<a&&0>i(u,c)?(e[r]=u,e[l]=n,r=l):(e[r]=c,e[s]=n,r=s);else if(l<a&&0>i(u,n))e[r]=u,e[l]=n,r=l;e [...]
+ at`)?` (<anonymous>)`:-1<e.stack.indexOf(`@`)?`@unknown:0:0`:``}return`
+`+Ee+e+De}var ke=!1;function Ae(e,t){if(!e||ke)return``;ke=!0;var n=Error.prepareStackTrace;Error.prepareStackTrace=void 0;try{var r={DetermineComponentFrameRoot:function(){try{if(t){var n=function(){throw Error()};if(Object.defineProperty(n.prototype,"props",{set:function(){throw Error()}}),typeof Reflect==`object`&&Reflect.construct){try{Reflect.construct(n,[])}catch(e){var r=e}Reflect.construct(e,[],n)}else{try{n.call()}catch(e){r=e}e.call(n.prototype)}}else{try{throw Error()}catch(e) [...]
+`),l=s.split(`
+`);for(i=r=0;r<c.length&&!c[r].includes(`DetermineComponentFrameRoot`);)r++;for(;i<l.length&&!l[i].includes(`DetermineComponentFrameRoot`);)i++;if(r===c.length||i===l.length)for(r=c.length-1,i=l.length-1;1<=r&&0<=i&&c[r]!==l[i];)i--;for(;1<=r&&0<=i;r--,i--)if(c[r]!==l[i]){if(r!==1||i!==1)do if(r--,i--,0>i||c[r]!==l[i]){var u=`
+`+c[r].replace(` at new `,` at `);return e.displayName&&u.includes(`<anonymous>`)&&(u=u.replace(`<anonymous>`,e.displayName)),u}while(1<=r&&0<=i);break}}}finally{ke=!1,Error.prepareStackTrace=n}return(n=e?e.displayName||e.name:``)?Oe(n):``}function je(e,t){switch(e.tag){case 26:case 27:case 5:return Oe(e.type);case 16:return Oe(`Lazy`);case 13:return e.child!==t&&t!==null?Oe(`Suspense Fallback`):Oe(`Suspense`);case 19:return Oe(`SuspenseList`);case 0:case 15:return Ae(e.type,!1);case 11: [...]
+Error generating stack: `+e.message+`
+`+e.stack}}var Ne=Object.prototype.hasOwnProperty,Pe=t.unstable_scheduleCallback,Fe=t.unstable_cancelCallback,Ie=t.unstable_shouldYield,Le=t.unstable_requestPaint,Re=t.unstable_now,ze=t.unstable_getCurrentPriorityLevel,Be=t.unstable_ImmediatePriority,Ve=t.unstable_UserBlockingPriority,He=t.unstable_NormalPriority,Ue=t.unstable_LowPriority,We=t.unstable_IdlePriority,Ge=t.log,Ke=t.unstable_setDisableYieldValue,qe=null,Je=null;function Ye(e){if(typeof Ge==`function`&&Ke(e),Je&&typeof Je.set [...]
+`).replace(jd,``)}function Nd(e,t){return t=Md(t),Md(e)===t}function Q(e,t,n,r,i,a){switch(n){case`children`:typeof r==`string`?t===`body`||t===`textarea`&&r===``||rn(e,r):(typeof r==`number`||typeof r==`bigint`)&&t!==`body`&&rn(e,``+r);break;case`className`:Vt(e,`class`,r);break;case`tabIndex`:Vt(e,`tabindex`,r);break;case`dir`:case`role`:case`viewBox`:case`width`:case`height`:Vt(e,n,r);break;case`style`:sn(e,r,a);break;case`data`:if(t!==`object`){Vt(e,`data`,r);break}case`src`:case`hre [...]
\ No newline at end of file
diff --git a/_astro/copy.Dfz5KN2B.js b/_astro/copy.Dfz5KN2B.js
new file mode 100644
index 0000000..bafc57b
--- /dev/null
+++ b/_astro/copy.Dfz5KN2B.js
@@ -0,0 +1 @@
+import{n as e}from"./arrow-up-right.DdKwi7mE.js";var t={name:`book-open`,size:24,node:[[`path`,{d:`M12 5v16`,key:`1f6ucr`}],[`path`,{d:`M20.001 19A2 2 0 0022 17V5a2 2 0 00-1.999-2L16 3.002A5 5 0 0012 5a5 5 0 00-4-2H4a2 2 0 00-2 2v12a2 2 0 001.999 2H8a5 5 0 014 2 5 5 0 014-2z`,key:`1fyvmf`}]]};t.node;var n=e(t),r={name:`check`,size:24,node:[[`path`,{d:`M20 6 9 17l-5-5`,key:`1gmf2c`}]]};r.node;var i=e(r),a={name:`copy`,size:24,node:[[`rect`,{width:`14`,height:`14`,x:`8`,y:`8`,rx:`2`,ry:`2` [...]
\ No newline at end of file
diff --git a/_astro/geist-cyrillic-ext-wght-normal.DjL33-gN.woff2 b/_astro/geist-cyrillic-ext-wght-normal.DjL33-gN.woff2
new file mode 100644
index 0000000..4c46295
Binary files /dev/null and b/_astro/geist-cyrillic-ext-wght-normal.DjL33-gN.woff2 differ
diff --git a/_astro/geist-cyrillic-wght-normal.BEAKL7Jp.woff2 b/_astro/geist-cyrillic-wght-normal.BEAKL7Jp.woff2
new file mode 100644
index 0000000..4b7a2be
Binary files /dev/null and b/_astro/geist-cyrillic-wght-normal.BEAKL7Jp.woff2 differ
diff --git a/_astro/geist-latin-ext-wght-normal.DC-KSUi6.woff2 b/_astro/geist-latin-ext-wght-normal.DC-KSUi6.woff2
new file mode 100644
index 0000000..ba90e20
Binary files /dev/null and b/_astro/geist-latin-ext-wght-normal.DC-KSUi6.woff2 differ
diff --git a/_astro/geist-latin-wght-normal.BgDaEnEv.woff2 b/_astro/geist-latin-wght-normal.BgDaEnEv.woff2
new file mode 100644
index 0000000..991445d
Binary files /dev/null and b/_astro/geist-latin-wght-normal.BgDaEnEv.woff2 differ
diff --git a/_astro/geist-vietnamese-wght-normal.6IgcOCM7.woff2 b/_astro/geist-vietnamese-wght-normal.6IgcOCM7.woff2
new file mode 100644
index 0000000..ee96589
Binary files /dev/null and b/_astro/geist-vietnamese-wght-normal.6IgcOCM7.woff2 differ
diff --git a/_astro/inter-cyrillic-400-normal.HOLc17fK.woff b/_astro/inter-cyrillic-400-normal.HOLc17fK.woff
new file mode 100644
index 0000000..6bd8b02
Binary files /dev/null and b/_astro/inter-cyrillic-400-normal.HOLc17fK.woff differ
diff --git a/_astro/inter-cyrillic-400-normal.obahsSVq.woff2 b/_astro/inter-cyrillic-400-normal.obahsSVq.woff2
new file mode 100644
index 0000000..e7583fc
Binary files /dev/null and b/_astro/inter-cyrillic-400-normal.obahsSVq.woff2 differ
diff --git a/_astro/inter-cyrillic-500-normal.BasfLYem.woff2 b/_astro/inter-cyrillic-500-normal.BasfLYem.woff2
new file mode 100644
index 0000000..dd14bcf
Binary files /dev/null and b/_astro/inter-cyrillic-500-normal.BasfLYem.woff2 differ
diff --git a/_astro/inter-cyrillic-500-normal.CxZf_p3X.woff b/_astro/inter-cyrillic-500-normal.CxZf_p3X.woff
new file mode 100644
index 0000000..c8aa26e
Binary files /dev/null and b/_astro/inter-cyrillic-500-normal.CxZf_p3X.woff differ
diff --git a/_astro/inter-cyrillic-600-normal.4D_pXhcN.woff b/_astro/inter-cyrillic-600-normal.4D_pXhcN.woff
new file mode 100644
index 0000000..10ec579
Binary files /dev/null and b/_astro/inter-cyrillic-600-normal.4D_pXhcN.woff differ
diff --git a/_astro/inter-cyrillic-600-normal.CWCymEST.woff2 b/_astro/inter-cyrillic-600-normal.CWCymEST.woff2
new file mode 100644
index 0000000..e250ef0
Binary files /dev/null and b/_astro/inter-cyrillic-600-normal.CWCymEST.woff2 differ
diff --git a/_astro/inter-cyrillic-700-normal.CjBOestx.woff2 b/_astro/inter-cyrillic-700-normal.CjBOestx.woff2
new file mode 100644
index 0000000..781e4b4
Binary files /dev/null and b/_astro/inter-cyrillic-700-normal.CjBOestx.woff2 differ
diff --git a/_astro/inter-cyrillic-700-normal.DrXBdSj3.woff b/_astro/inter-cyrillic-700-normal.DrXBdSj3.woff
new file mode 100644
index 0000000..46451f1
Binary files /dev/null and b/_astro/inter-cyrillic-700-normal.DrXBdSj3.woff differ
diff --git a/_astro/inter-cyrillic-ext-400-normal.BQZuk6qB.woff2 b/_astro/inter-cyrillic-ext-400-normal.BQZuk6qB.woff2
new file mode 100644
index 0000000..4ee0d27
Binary files /dev/null and b/_astro/inter-cyrillic-ext-400-normal.BQZuk6qB.woff2 differ
diff --git a/_astro/inter-cyrillic-ext-400-normal.DQukG94-.woff b/_astro/inter-cyrillic-ext-400-normal.DQukG94-.woff
new file mode 100644
index 0000000..6b6dc78
Binary files /dev/null and b/_astro/inter-cyrillic-ext-400-normal.DQukG94-.woff differ
diff --git a/_astro/inter-cyrillic-ext-500-normal.B0yAr1jD.woff2 b/_astro/inter-cyrillic-ext-500-normal.B0yAr1jD.woff2
new file mode 100644
index 0000000..c21492c
Binary files /dev/null and b/_astro/inter-cyrillic-ext-500-normal.B0yAr1jD.woff2 differ
diff --git a/_astro/inter-cyrillic-ext-500-normal.BmqWE9Dz.woff b/_astro/inter-cyrillic-ext-500-normal.BmqWE9Dz.woff
new file mode 100644
index 0000000..e5c7962
Binary files /dev/null and b/_astro/inter-cyrillic-ext-500-normal.BmqWE9Dz.woff differ
diff --git a/_astro/inter-cyrillic-ext-600-normal.Bcila6Z-.woff b/_astro/inter-cyrillic-ext-600-normal.Bcila6Z-.woff
new file mode 100644
index 0000000..7b24dd8
Binary files /dev/null and b/_astro/inter-cyrillic-ext-600-normal.Bcila6Z-.woff differ
diff --git a/_astro/inter-cyrillic-ext-600-normal.Dfes3d0z.woff2 b/_astro/inter-cyrillic-ext-600-normal.Dfes3d0z.woff2
new file mode 100644
index 0000000..e00289e
Binary files /dev/null and b/_astro/inter-cyrillic-ext-600-normal.Dfes3d0z.woff2 differ
diff --git a/_astro/inter-cyrillic-ext-700-normal.BjwYoWNd.woff2 b/_astro/inter-cyrillic-ext-700-normal.BjwYoWNd.woff2
new file mode 100644
index 0000000..1a5c3ce
Binary files /dev/null and b/_astro/inter-cyrillic-ext-700-normal.BjwYoWNd.woff2 differ
diff --git a/_astro/inter-cyrillic-ext-700-normal.LO58E6JB.woff b/_astro/inter-cyrillic-ext-700-normal.LO58E6JB.woff
new file mode 100644
index 0000000..6fb2700
Binary files /dev/null and b/_astro/inter-cyrillic-ext-700-normal.LO58E6JB.woff differ
diff --git a/_astro/inter-greek-400-normal.B4URO6DV.woff2 b/_astro/inter-greek-400-normal.B4URO6DV.woff2
new file mode 100644
index 0000000..e7103fb
Binary files /dev/null and b/_astro/inter-greek-400-normal.B4URO6DV.woff2 differ
diff --git a/_astro/inter-greek-400-normal.q2sYcFCs.woff b/_astro/inter-greek-400-normal.q2sYcFCs.woff
new file mode 100644
index 0000000..c0c36e2
Binary files /dev/null and b/_astro/inter-greek-400-normal.q2sYcFCs.woff differ
diff --git a/_astro/inter-greek-500-normal.BIZE56-Y.woff2 b/_astro/inter-greek-500-normal.BIZE56-Y.woff2
new file mode 100644
index 0000000..730be94
Binary files /dev/null and b/_astro/inter-greek-500-normal.BIZE56-Y.woff2 differ
diff --git a/_astro/inter-greek-500-normal.Xzm54t5V.woff b/_astro/inter-greek-500-normal.Xzm54t5V.woff
new file mode 100644
index 0000000..b4ebbd9
Binary files /dev/null and b/_astro/inter-greek-500-normal.Xzm54t5V.woff differ
diff --git a/_astro/inter-greek-600-normal.BZpKdvQh.woff b/_astro/inter-greek-600-normal.BZpKdvQh.woff
new file mode 100644
index 0000000..ae72058
Binary files /dev/null and b/_astro/inter-greek-600-normal.BZpKdvQh.woff differ
diff --git a/_astro/inter-greek-600-normal.plRanbMR.woff2 b/_astro/inter-greek-600-normal.plRanbMR.woff2
new file mode 100644
index 0000000..479b547
Binary files /dev/null and b/_astro/inter-greek-600-normal.plRanbMR.woff2 differ
diff --git a/_astro/inter-greek-700-normal.BUv2fZ6O.woff b/_astro/inter-greek-700-normal.BUv2fZ6O.woff
new file mode 100644
index 0000000..1d428f5
Binary files /dev/null and b/_astro/inter-greek-700-normal.BUv2fZ6O.woff differ
diff --git a/_astro/inter-greek-700-normal.C3JjAnD8.woff2 b/_astro/inter-greek-700-normal.C3JjAnD8.woff2
new file mode 100644
index 0000000..3a9fc0b
Binary files /dev/null and b/_astro/inter-greek-700-normal.C3JjAnD8.woff2 differ
diff --git a/_astro/inter-greek-ext-400-normal.DGGRlc-M.woff2 b/_astro/inter-greek-ext-400-normal.DGGRlc-M.woff2
new file mode 100644
index 0000000..7cb1d6b
Binary files /dev/null and b/_astro/inter-greek-ext-400-normal.DGGRlc-M.woff2 differ
diff --git a/_astro/inter-greek-ext-400-normal.KugGGMne.woff b/_astro/inter-greek-ext-400-normal.KugGGMne.woff
new file mode 100644
index 0000000..96f1f60
Binary files /dev/null and b/_astro/inter-greek-ext-400-normal.KugGGMne.woff differ
diff --git a/_astro/inter-greek-ext-500-normal.2j5mBUwD.woff b/_astro/inter-greek-ext-500-normal.2j5mBUwD.woff
new file mode 100644
index 0000000..713c500
Binary files /dev/null and b/_astro/inter-greek-ext-500-normal.2j5mBUwD.woff differ
diff --git a/_astro/inter-greek-ext-500-normal.C4iEst2y.woff2 b/_astro/inter-greek-ext-500-normal.C4iEst2y.woff2
new file mode 100644
index 0000000..4062b66
Binary files /dev/null and b/_astro/inter-greek-ext-500-normal.C4iEst2y.woff2 differ
diff --git a/_astro/inter-greek-ext-600-normal.B8X0CLgF.woff b/_astro/inter-greek-ext-600-normal.B8X0CLgF.woff
new file mode 100644
index 0000000..b3d15d1
Binary files /dev/null and b/_astro/inter-greek-ext-600-normal.B8X0CLgF.woff differ
diff --git a/_astro/inter-greek-ext-600-normal.DRtmH8MT.woff2 b/_astro/inter-greek-ext-600-normal.DRtmH8MT.woff2
new file mode 100644
index 0000000..83e7de9
Binary files /dev/null and b/_astro/inter-greek-ext-600-normal.DRtmH8MT.woff2 differ
diff --git a/_astro/inter-greek-ext-700-normal.BoQ6DsYi.woff b/_astro/inter-greek-ext-700-normal.BoQ6DsYi.woff
new file mode 100644
index 0000000..e36fd56
Binary files /dev/null and b/_astro/inter-greek-ext-700-normal.BoQ6DsYi.woff differ
diff --git a/_astro/inter-greek-ext-700-normal.qfdV9bQt.woff2 b/_astro/inter-greek-ext-700-normal.qfdV9bQt.woff2
new file mode 100644
index 0000000..af7bcba
Binary files /dev/null and b/_astro/inter-greek-ext-700-normal.qfdV9bQt.woff2 differ
diff --git a/_astro/inter-latin-400-normal.C38fXH4l.woff2 b/_astro/inter-latin-400-normal.C38fXH4l.woff2
new file mode 100644
index 0000000..f15b025
Binary files /dev/null and b/_astro/inter-latin-400-normal.C38fXH4l.woff2 differ
diff --git a/_astro/inter-latin-400-normal.CyCys3Eg.woff b/_astro/inter-latin-400-normal.CyCys3Eg.woff
new file mode 100644
index 0000000..2f21ed4
Binary files /dev/null and b/_astro/inter-latin-400-normal.CyCys3Eg.woff differ
diff --git a/_astro/inter-latin-500-normal.BL9OpVg8.woff b/_astro/inter-latin-500-normal.BL9OpVg8.woff
new file mode 100644
index 0000000..07775a3
Binary files /dev/null and b/_astro/inter-latin-500-normal.BL9OpVg8.woff differ
diff --git a/_astro/inter-latin-500-normal.Cerq10X2.woff2 b/_astro/inter-latin-500-normal.Cerq10X2.woff2
new file mode 100644
index 0000000..54f0a59
Binary files /dev/null and b/_astro/inter-latin-500-normal.Cerq10X2.woff2 differ
diff --git a/_astro/inter-latin-600-normal.CiBQ2DWP.woff b/_astro/inter-latin-600-normal.CiBQ2DWP.woff
new file mode 100644
index 0000000..323fa67
Binary files /dev/null and b/_astro/inter-latin-600-normal.CiBQ2DWP.woff differ
diff --git a/_astro/inter-latin-600-normal.LgqL8muc.woff2 b/_astro/inter-latin-600-normal.LgqL8muc.woff2
new file mode 100644
index 0000000..d189794
Binary files /dev/null and b/_astro/inter-latin-600-normal.LgqL8muc.woff2 differ
diff --git a/_astro/inter-latin-700-normal.BLAVimhd.woff b/_astro/inter-latin-700-normal.BLAVimhd.woff
new file mode 100644
index 0000000..161b01e
Binary files /dev/null and b/_astro/inter-latin-700-normal.BLAVimhd.woff differ
diff --git a/_astro/inter-latin-700-normal.Yt3aPRUw.woff2 b/_astro/inter-latin-700-normal.Yt3aPRUw.woff2
new file mode 100644
index 0000000..a68fb10
Binary files /dev/null and b/_astro/inter-latin-700-normal.Yt3aPRUw.woff2 differ
diff --git a/_astro/inter-latin-ext-400-normal.77YHD8bZ.woff b/_astro/inter-latin-ext-400-normal.77YHD8bZ.woff
new file mode 100644
index 0000000..0238739
Binary files /dev/null and b/_astro/inter-latin-ext-400-normal.77YHD8bZ.woff differ
diff --git a/_astro/inter-latin-ext-400-normal.C1nco2VV.woff2 b/_astro/inter-latin-ext-400-normal.C1nco2VV.woff2
new file mode 100644
index 0000000..5243e4b
Binary files /dev/null and b/_astro/inter-latin-ext-400-normal.C1nco2VV.woff2 differ
diff --git a/_astro/inter-latin-ext-500-normal.BxGbmqWO.woff b/_astro/inter-latin-ext-500-normal.BxGbmqWO.woff
new file mode 100644
index 0000000..e6a577e
Binary files /dev/null and b/_astro/inter-latin-ext-500-normal.BxGbmqWO.woff differ
diff --git a/_astro/inter-latin-ext-500-normal.CV4jyFjo.woff2 b/_astro/inter-latin-ext-500-normal.CV4jyFjo.woff2
new file mode 100644
index 0000000..2ab7ebf
Binary files /dev/null and b/_astro/inter-latin-ext-500-normal.CV4jyFjo.woff2 differ
diff --git a/_astro/inter-latin-ext-600-normal.CIVaiw4L.woff b/_astro/inter-latin-ext-600-normal.CIVaiw4L.woff
new file mode 100644
index 0000000..74b454b
Binary files /dev/null and b/_astro/inter-latin-ext-600-normal.CIVaiw4L.woff differ
diff --git a/_astro/inter-latin-ext-600-normal.D2bJ5OIk.woff2 b/_astro/inter-latin-ext-600-normal.D2bJ5OIk.woff2
new file mode 100644
index 0000000..bad65d4
Binary files /dev/null and b/_astro/inter-latin-ext-600-normal.D2bJ5OIk.woff2 differ
diff --git a/_astro/inter-latin-ext-700-normal.Ca8adRJv.woff2 b/_astro/inter-latin-ext-700-normal.Ca8adRJv.woff2
new file mode 100644
index 0000000..c9507e3
Binary files /dev/null and b/_astro/inter-latin-ext-700-normal.Ca8adRJv.woff2 differ
diff --git a/_astro/inter-latin-ext-700-normal.TidjK2hL.woff b/_astro/inter-latin-ext-700-normal.TidjK2hL.woff
new file mode 100644
index 0000000..b4517fc
Binary files /dev/null and b/_astro/inter-latin-ext-700-normal.TidjK2hL.woff differ
diff --git a/_astro/inter-vietnamese-400-normal.Bbgyi5SW.woff b/_astro/inter-vietnamese-400-normal.Bbgyi5SW.woff
new file mode 100644
index 0000000..ff3f8f1
Binary files /dev/null and b/_astro/inter-vietnamese-400-normal.Bbgyi5SW.woff differ
diff --git a/_astro/inter-vietnamese-400-normal.DMkecbls.woff2 b/_astro/inter-vietnamese-400-normal.DMkecbls.woff2
new file mode 100644
index 0000000..ba7767f
Binary files /dev/null and b/_astro/inter-vietnamese-400-normal.DMkecbls.woff2 differ
diff --git a/_astro/inter-vietnamese-500-normal.DOriooB6.woff2 b/_astro/inter-vietnamese-500-normal.DOriooB6.woff2
new file mode 100644
index 0000000..abe88f5
Binary files /dev/null and b/_astro/inter-vietnamese-500-normal.DOriooB6.woff2 differ
diff --git a/_astro/inter-vietnamese-500-normal.mJboJaSs.woff b/_astro/inter-vietnamese-500-normal.mJboJaSs.woff
new file mode 100644
index 0000000..87a9d4d
Binary files /dev/null and b/_astro/inter-vietnamese-500-normal.mJboJaSs.woff differ
diff --git a/_astro/inter-vietnamese-600-normal.BuLX-rYi.woff b/_astro/inter-vietnamese-600-normal.BuLX-rYi.woff
new file mode 100644
index 0000000..264f0f5
Binary files /dev/null and b/_astro/inter-vietnamese-600-normal.BuLX-rYi.woff differ
diff --git a/_astro/inter-vietnamese-600-normal.Cc8MFFhd.woff2 b/_astro/inter-vietnamese-600-normal.Cc8MFFhd.woff2
new file mode 100644
index 0000000..e7b7814
Binary files /dev/null and b/_astro/inter-vietnamese-600-normal.Cc8MFFhd.woff2 differ
diff --git a/_astro/inter-vietnamese-700-normal.BZaoP0fm.woff b/_astro/inter-vietnamese-700-normal.BZaoP0fm.woff
new file mode 100644
index 0000000..26d92ec
Binary files /dev/null and b/_astro/inter-vietnamese-700-normal.BZaoP0fm.woff differ
diff --git a/_astro/inter-vietnamese-700-normal.DlLaEgI2.woff2 b/_astro/inter-vietnamese-700-normal.DlLaEgI2.woff2
new file mode 100644
index 0000000..38c516e
Binary files /dev/null and b/_astro/inter-vietnamese-700-normal.DlLaEgI2.woff2 differ
diff --git a/_astro/jost-cyrillic-400-normal.Dk3McGkH.woff b/_astro/jost-cyrillic-400-normal.Dk3McGkH.woff
new file mode 100644
index 0000000..2ba4e06
Binary files /dev/null and b/_astro/jost-cyrillic-400-normal.Dk3McGkH.woff differ
diff --git a/_astro/jost-cyrillic-400-normal.bVZEi0jL.woff2 b/_astro/jost-cyrillic-400-normal.bVZEi0jL.woff2
new file mode 100644
index 0000000..c930567
Binary files /dev/null and b/_astro/jost-cyrillic-400-normal.bVZEi0jL.woff2 differ
diff --git a/_astro/jost-cyrillic-500-normal.DlHwnXyv.woff b/_astro/jost-cyrillic-500-normal.DlHwnXyv.woff
new file mode 100644
index 0000000..4a4616a
Binary files /dev/null and b/_astro/jost-cyrillic-500-normal.DlHwnXyv.woff differ
diff --git a/_astro/jost-cyrillic-500-normal.DtB2bvF0.woff2 b/_astro/jost-cyrillic-500-normal.DtB2bvF0.woff2
new file mode 100644
index 0000000..37f6401
Binary files /dev/null and b/_astro/jost-cyrillic-500-normal.DtB2bvF0.woff2 differ
diff --git a/_astro/jost-cyrillic-600-normal.BEDXyecp.woff2 b/_astro/jost-cyrillic-600-normal.BEDXyecp.woff2
new file mode 100644
index 0000000..4ebbae6
Binary files /dev/null and b/_astro/jost-cyrillic-600-normal.BEDXyecp.woff2 differ
diff --git a/_astro/jost-cyrillic-600-normal.D0Fzn8un.woff b/_astro/jost-cyrillic-600-normal.D0Fzn8un.woff
new file mode 100644
index 0000000..27fd386
Binary files /dev/null and b/_astro/jost-cyrillic-600-normal.D0Fzn8un.woff differ
diff --git a/_astro/jost-cyrillic-700-normal.BHDNzvjF.woff b/_astro/jost-cyrillic-700-normal.BHDNzvjF.woff
new file mode 100644
index 0000000..5914f0f
Binary files /dev/null and b/_astro/jost-cyrillic-700-normal.BHDNzvjF.woff differ
diff --git a/_astro/jost-cyrillic-700-normal._ob5o-r5.woff2 b/_astro/jost-cyrillic-700-normal._ob5o-r5.woff2
new file mode 100644
index 0000000..5ae7751
Binary files /dev/null and b/_astro/jost-cyrillic-700-normal._ob5o-r5.woff2 differ
diff --git a/_astro/jost-latin-400-normal.C7S-3Ky6.woff b/_astro/jost-latin-400-normal.C7S-3Ky6.woff
new file mode 100644
index 0000000..515f532
Binary files /dev/null and b/_astro/jost-latin-400-normal.C7S-3Ky6.woff differ
diff --git a/_astro/jost-latin-400-normal.q-RKOgPK.woff2 b/_astro/jost-latin-400-normal.q-RKOgPK.woff2
new file mode 100644
index 0000000..a93b79d
Binary files /dev/null and b/_astro/jost-latin-400-normal.q-RKOgPK.woff2 differ
diff --git a/_astro/jost-latin-500-normal.41lBe9I9.woff2 b/_astro/jost-latin-500-normal.41lBe9I9.woff2
new file mode 100644
index 0000000..80e9c5b
Binary files /dev/null and b/_astro/jost-latin-500-normal.41lBe9I9.woff2 differ
diff --git a/_astro/jost-latin-500-normal.B-AtzreL.woff b/_astro/jost-latin-500-normal.B-AtzreL.woff
new file mode 100644
index 0000000..62837c4
Binary files /dev/null and b/_astro/jost-latin-500-normal.B-AtzreL.woff differ
diff --git a/_astro/jost-latin-600-normal.Bv_M0d15.woff b/_astro/jost-latin-600-normal.Bv_M0d15.woff
new file mode 100644
index 0000000..554e7e7
Binary files /dev/null and b/_astro/jost-latin-600-normal.Bv_M0d15.woff differ
diff --git a/_astro/jost-latin-600-normal.C497H-z9.woff2 b/_astro/jost-latin-600-normal.C497H-z9.woff2
new file mode 100644
index 0000000..d083772
Binary files /dev/null and b/_astro/jost-latin-600-normal.C497H-z9.woff2 differ
diff --git a/_astro/jost-latin-700-normal.k-iBXzmq.woff b/_astro/jost-latin-700-normal.k-iBXzmq.woff
new file mode 100644
index 0000000..99caca0
Binary files /dev/null and b/_astro/jost-latin-700-normal.k-iBXzmq.woff differ
diff --git a/_astro/jost-latin-700-normal.u2Hrqd6k.woff2 b/_astro/jost-latin-700-normal.u2Hrqd6k.woff2
new file mode 100644
index 0000000..3d3e683
Binary files /dev/null and b/_astro/jost-latin-700-normal.u2Hrqd6k.woff2 differ
diff --git a/_astro/jost-latin-ext-400-normal.CpdMQIMr.woff2 b/_astro/jost-latin-ext-400-normal.CpdMQIMr.woff2
new file mode 100644
index 0000000..07e0e47
Binary files /dev/null and b/_astro/jost-latin-ext-400-normal.CpdMQIMr.woff2 differ
diff --git a/_astro/jost-latin-ext-400-normal.Dsyb2mtt.woff b/_astro/jost-latin-ext-400-normal.Dsyb2mtt.woff
new file mode 100644
index 0000000..ab7db75
Binary files /dev/null and b/_astro/jost-latin-ext-400-normal.Dsyb2mtt.woff differ
diff --git a/_astro/jost-latin-ext-500-normal.BkvHgcKf.woff2 b/_astro/jost-latin-ext-500-normal.BkvHgcKf.woff2
new file mode 100644
index 0000000..4d4b532
Binary files /dev/null and b/_astro/jost-latin-ext-500-normal.BkvHgcKf.woff2 differ
diff --git a/_astro/jost-latin-ext-500-normal.Cpxiadwk.woff b/_astro/jost-latin-ext-500-normal.Cpxiadwk.woff
new file mode 100644
index 0000000..8c24c0a
Binary files /dev/null and b/_astro/jost-latin-ext-500-normal.Cpxiadwk.woff differ
diff --git a/_astro/jost-latin-ext-600-normal.D8I9kjga.woff2 b/_astro/jost-latin-ext-600-normal.D8I9kjga.woff2
new file mode 100644
index 0000000..3809c6a
Binary files /dev/null and b/_astro/jost-latin-ext-600-normal.D8I9kjga.woff2 differ
diff --git a/_astro/jost-latin-ext-600-normal.Pm6OqGZB.woff b/_astro/jost-latin-ext-600-normal.Pm6OqGZB.woff
new file mode 100644
index 0000000..dbba5f7
Binary files /dev/null and b/_astro/jost-latin-ext-600-normal.Pm6OqGZB.woff differ
diff --git a/_astro/jost-latin-ext-700-normal.AnR_ULdm.woff2 b/_astro/jost-latin-ext-700-normal.AnR_ULdm.woff2
new file mode 100644
index 0000000..4f7d685
Binary files /dev/null and b/_astro/jost-latin-ext-700-normal.AnR_ULdm.woff2 differ
diff --git a/_astro/jost-latin-ext-700-normal.DTcCupJy.woff b/_astro/jost-latin-ext-700-normal.DTcCupJy.woff
new file mode 100644
index 0000000..3e578b5
Binary files /dev/null and b/_astro/jost-latin-ext-700-normal.DTcCupJy.woff differ
diff --git a/_astro/jsx-runtime.WQvrtk7F.js b/_astro/jsx-runtime.WQvrtk7F.js
new file mode 100644
index 0000000..37f707e
--- /dev/null
+++ b/_astro/jsx-runtime.WQvrtk7F.js
@@ -0,0 +1 @@
+import{n as e}from"./react.CYuo-Lgd.js";function t(e){var n,r,i=``;if(typeof e==`string`||typeof e==`number`)i+=e;else if(typeof e==`object`)if(Array.isArray(e)){var a=e.length;for(n=0;n<a;n++)e[n]&&(r=t(e[n]))&&(i&&(i+=` `),i+=r)}else for(r in e)e[r]&&(i&&(i+=` `),i+=r);return i}function n(){for(var e,n,r=0,i=``,a=arguments.length;r<a;r++)(e=arguments[r])&&(n=t(e))&&(i&&(i+=` `),i+=n);return i}var r=(e,t)=>{let n=Array(e.length+t.length);for(let t=0;t<e.length;t++)n[t]=e[t];for(let r=0; [...]
\ No newline at end of file
diff --git a/_astro/kinetic-home.BR2OxRzm.css b/_astro/kinetic-home.BR2OxRzm.css
new file mode 100644
index 0000000..a9ab7ba
--- /dev/null
+++ b/_astro/kinetic-home.BR2OxRzm.css
@@ -0,0 +1 @@
+html:has(.k-home){scroll-padding-top:92px}.k-home{--ink:#202127;--paper:#f3f2eb;--blue:#2359eb;--acid:#c8dcff;--line:#cdcec4;background:var(--paper);color:var(--ink);font-family:Geist Variable,Arial,sans-serif;font-size:15px;line-height:1.6;overflow:clip}.k-home *{box-sizing:border-box}.k-home h1,.k-home h2,.k-home h3,.k-home p{margin:0}.k-home h1,.k-home h2,.k-home h3{font-family:inherit;font-weight:550}.k-home a{text-decoration:none}.k-home button{font:inherit;cursor:pointer}.k-home bu [...]
diff --git a/_astro/react.CYuo-Lgd.js b/_astro/react.CYuo-Lgd.js
new file mode 100644
index 0000000..d1dd543
--- /dev/null
+++ b/_astro/react.CYuo-Lgd.js
@@ -0,0 +1 @@
+var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,t)=>()=>(t||(e((t={exports:{}}).exports,t),e=null),t.exports),s=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},c=(n,r,a)=>(a=n==null?{}:e(i(n)),s(r||!n||!n.__e [...]
\ No newline at end of file
diff --git a/_astro/three.module.fzXHyE0N.js b/_astro/three.module.fzXHyE0N.js
new file mode 100644
index 0000000..c3f1348
--- /dev/null
+++ b/_astro/three.module.fzXHyE0N.js
@@ -0,0 +1,4220 @@
+var e=3,t=2,n=4,r=1e3,i=1001,a=1002,o=1003,s=1006,c=1008,l=1009,u=1012,d=1014,f=1015,p=1016,m=1017,h=1018,g=1020,_=1023,v=1026,y=1027,b=1029,x=1030,S=1031,C=1033,w=2300,T=2301,E=2302,D=2303,O=2400,k=2401,A=2402,j=`srgb`,M=`srgb-linear`,N=`linear`,P=`srgb`,F=7680,I=2e3;function L(e){for(let t=e.length-1;t>=0;--t)if(e[t]>=65535)return!0;return!1}function R(e){return ArrayBuffer.isView(e)&&!(e instanceof DataView)}function ee(e){return document.createElementNS(`http://www.w3.org/1999/xhtml` [...]
+ gl_Position = projectionMatrix * modelViewMatrix * vec4( position, 1.0 );
+}`,Mr=`void main() {
+ gl_FragColor = vec4( 1.0, 0.0, 0.0, 1.0 );
+}`,Nr=class extends In{constructor(e){super(),this.isShaderMaterial=!0,this.type=`ShaderMaterial`,this.defines={},this.uniforms={},this.uniformsGroups=[],this.vertexShader=jr,this.fragmentShader=Mr,this.linewidth=1,this.wireframe=!1,this.wireframeLinewidth=1,this.fog=!1,this.lights=!1,this.clipping=!1,this.forceSinglePass=!0,this.extensions={clipCullDistance:!1,multiDraw:!1},this.defaultAttributeValues={color:[1,1,1],uv:[0,0],uv1:[0,0]},this.index0AttributeName=void 0,this.uniformsNeedUp [...]
+ if ( diffuseColor.a < getAlphaHashThreshold( vPosition ) ) discard;
+#endif`,alphahash_pars_fragment:`#ifdef USE_ALPHAHASH
+ const float ALPHA_HASH_SCALE = 0.05;
+ float hash2D( vec2 value ) {
+ return fract( 1.0e4 * sin( 17.0 * value.x + 0.1 * value.y ) * ( 0.1 + abs( sin( 13.0 * value.y + value.x ) ) ) );
+ }
+ float hash3D( vec3 value ) {
+ return hash2D( vec2( hash2D( value.xy ), value.z ) );
+ }
+ float getAlphaHashThreshold( vec3 position ) {
+ float maxDeriv = max(
+ length( dFdx( position.xyz ) ),
+ length( dFdy( position.xyz ) )
+ );
+ float pixScale = 1.0 / ( ALPHA_HASH_SCALE * maxDeriv );
+ vec2 pixScales = vec2(
+ exp2( floor( log2( pixScale ) ) ),
+ exp2( ceil( log2( pixScale ) ) )
+ );
+ vec2 alpha = vec2(
+ hash3D( floor( pixScales.x * position.xyz ) ),
+ hash3D( floor( pixScales.y * position.xyz ) )
+ );
+ float lerpFactor = fract( log2( pixScale ) );
+ float x = ( 1.0 - lerpFactor ) * alpha.x + lerpFactor * alpha.y;
+ float a = min( lerpFactor, 1.0 - lerpFactor );
+ vec3 cases = vec3(
+ x * x / ( 2.0 * a * ( 1.0 - a ) ),
+ ( x - 0.5 * a ) / ( 1.0 - a ),
+ 1.0 - ( ( 1.0 - x ) * ( 1.0 - x ) / ( 2.0 * a * ( 1.0 - a ) ) )
+ );
+ float threshold = ( x < ( 1.0 - a ) )
+ ? ( ( x < a ) ? cases.x : cases.y )
+ : cases.z;
+ return clamp( threshold , 1.0e-6, 1.0 );
+ }
+#endif`,alphamap_fragment:`#ifdef USE_ALPHAMAP
+ diffuseColor.a *= texture2D( alphaMap, vAlphaMapUv ).g;
+#endif`,alphamap_pars_fragment:`#ifdef USE_ALPHAMAP
+ uniform sampler2D alphaMap;
+#endif`,alphatest_fragment:`#ifdef USE_ALPHATEST
+ #ifdef ALPHA_TO_COVERAGE
+ diffuseColor.a = smoothstep( alphaTest, alphaTest + fwidth( diffuseColor.a ), diffuseColor.a );
+ if ( diffuseColor.a == 0.0 ) discard;
+ #else
+ if ( diffuseColor.a < alphaTest ) discard;
+ #endif
+#endif`,alphatest_pars_fragment:`#ifdef USE_ALPHATEST
+ uniform float alphaTest;
+#endif`,aomap_fragment:`#ifdef USE_AOMAP
+ float ambientOcclusion = ( texture2D( aoMap, vAoMapUv ).r - 1.0 ) * aoMapIntensity + 1.0;
+ reflectedLight.indirectDiffuse *= ambientOcclusion;
+ #if defined( USE_CLEARCOAT )
+ clearcoatSpecularIndirect *= ambientOcclusion;
+ #endif
+ #if defined( USE_SHEEN )
+ sheenSpecularIndirect *= ambientOcclusion;
+ #endif
+ #if defined( USE_ENVMAP ) && defined( STANDARD )
+ float dotNV = saturate( dot( geometryNormal, geometryViewDir ) );
+ reflectedLight.indirectSpecular *= computeSpecularOcclusion( dotNV, ambientOcclusion, material.roughness );
+ #endif
+#endif`,aomap_pars_fragment:`#ifdef USE_AOMAP
+ uniform sampler2D aoMap;
+ uniform float aoMapIntensity;
+#endif`,batching_pars_vertex:`#ifdef USE_BATCHING
+ #if ! defined( GL_ANGLE_multi_draw )
+ #define gl_DrawID _gl_DrawID
+ uniform int _gl_DrawID;
+ #endif
+ uniform highp sampler2D batchingTexture;
+ uniform highp usampler2D batchingIdTexture;
+ mat4 getBatchingMatrix( const in float i ) {
+ int size = textureSize( batchingTexture, 0 ).x;
+ int j = int( i ) * 4;
+ int x = j % size;
+ int y = j / size;
+ vec4 v1 = texelFetch( batchingTexture, ivec2( x, y ), 0 );
+ vec4 v2 = texelFetch( batchingTexture, ivec2( x + 1, y ), 0 );
+ vec4 v3 = texelFetch( batchingTexture, ivec2( x + 2, y ), 0 );
+ vec4 v4 = texelFetch( batchingTexture, ivec2( x + 3, y ), 0 );
+ return mat4( v1, v2, v3, v4 );
+ }
+ float getIndirectIndex( const in int i ) {
+ int size = textureSize( batchingIdTexture, 0 ).x;
+ int x = i % size;
+ int y = i / size;
+ return float( texelFetch( batchingIdTexture, ivec2( x, y ), 0 ).r );
+ }
+#endif
+#ifdef USE_BATCHING_COLOR
+ uniform sampler2D batchingColorTexture;
+ vec4 getBatchingColor( const in float i ) {
+ int size = textureSize( batchingColorTexture, 0 ).x;
+ int j = int( i );
+ int x = j % size;
+ int y = j / size;
+ return texelFetch( batchingColorTexture, ivec2( x, y ), 0 );
+ }
+#endif`,batching_vertex:`#ifdef USE_BATCHING
+ mat4 batchingMatrix = getBatchingMatrix( getIndirectIndex( gl_DrawID ) );
+#endif`,begin_vertex:`vec3 transformed = vec3( position );
+#ifdef USE_ALPHAHASH
+ vPosition = vec3( position );
+#endif`,beginnormal_vertex:`vec3 objectNormal = vec3( normal );
+#ifdef USE_TANGENT
+ vec3 objectTangent = vec3( tangent.xyz );
+#endif`,bsdfs:`float G_BlinnPhong_Implicit( ) {
+ return 0.25;
+}
+float D_BlinnPhong( const in float shininess, const in float dotNH ) {
+ return RECIPROCAL_PI * ( shininess * 0.5 + 1.0 ) * pow( dotNH, shininess );
+}
+vec3 BRDF_BlinnPhong( const in vec3 lightDir, const in vec3 viewDir, const in vec3 normal, const in vec3 specularColor, const in float shininess ) {
+ vec3 halfDir = normalize( lightDir + viewDir );
+ float dotNH = saturate( dot( normal, halfDir ) );
+ float dotVH = saturate( dot( viewDir, halfDir ) );
+ vec3 F = F_Schlick( specularColor, 1.0, dotVH );
+ float G = G_BlinnPhong_Implicit( );
+ float D = D_BlinnPhong( shininess, dotNH );
+ return F * ( G * D );
+} // validated`,iridescence_fragment:`#ifdef USE_IRIDESCENCE
+ const mat3 XYZ_TO_REC709 = mat3(
+ 3.2404542, -0.9692660, 0.0556434,
+ -1.5371385, 1.8760108, -0.2040259,
+ -0.4985314, 0.0415560, 1.0572252
+ );
+ vec3 Fresnel0ToIor( vec3 fresnel0 ) {
+ vec3 sqrtF0 = sqrt( fresnel0 );
+ return ( vec3( 1.0 ) + sqrtF0 ) / ( vec3( 1.0 ) - sqrtF0 );
+ }
+ vec3 IorToFresnel0( vec3 transmittedIor, float incidentIor ) {
+ return pow2( ( transmittedIor - vec3( incidentIor ) ) / ( transmittedIor + vec3( incidentIor ) ) );
+ }
+ float IorToFresnel0( float transmittedIor, float incidentIor ) {
+ return pow2( ( transmittedIor - incidentIor ) / ( transmittedIor + incidentIor ));
+ }
+ vec3 evalSensitivity( float OPD, vec3 shift ) {
+ float phase = 2.0 * PI * OPD * 1.0e-9;
+ vec3 val = vec3( 5.4856e-13, 4.4201e-13, 5.2481e-13 );
+ vec3 pos = vec3( 1.6810e+06, 1.7953e+06, 2.2084e+06 );
+ vec3 var = vec3( 4.3278e+09, 9.3046e+09, 6.6121e+09 );
+ vec3 xyz = val * sqrt( 2.0 * PI * var ) * cos( pos * phase + shift ) * exp( - pow2( phase ) * var );
+ xyz.x += 9.7470e-14 * sqrt( 2.0 * PI * 4.5282e+09 ) * cos( 2.2399e+06 * phase + shift[ 0 ] ) * exp( - 4.5282e+09 * pow2( phase ) );
+ xyz /= 1.0685e-7;
+ vec3 rgb = XYZ_TO_REC709 * xyz;
+ return rgb;
+ }
+ vec3 evalIridescence( float outsideIOR, float eta2, float cosTheta1, float thinFilmThickness, vec3 baseF0 ) {
+ vec3 I;
+ float iridescenceIOR = mix( outsideIOR, eta2, smoothstep( 0.0, 0.03, thinFilmThickness ) );
+ float sinTheta2Sq = pow2( outsideIOR / iridescenceIOR ) * ( 1.0 - pow2( cosTheta1 ) );
+ float cosTheta2Sq = 1.0 - sinTheta2Sq;
+ if ( cosTheta2Sq < 0.0 ) {
+ return vec3( 1.0 );
+ }
+ float cosTheta2 = sqrt( cosTheta2Sq );
+ float R0 = IorToFresnel0( iridescenceIOR, outsideIOR );
+ float R12 = F_Schlick( R0, 1.0, cosTheta1 );
+ float T121 = 1.0 - R12;
+ float phi12 = 0.0;
+ if ( iridescenceIOR < outsideIOR ) phi12 = PI;
+ float phi21 = PI - phi12;
+ vec3 baseIOR = Fresnel0ToIor( clamp( baseF0, 0.0, 0.9999 ) ); vec3 R1 = IorToFresnel0( baseIOR, iridescenceIOR );
+ vec3 R23 = F_Schlick( R1, 1.0, cosTheta2 );
+ vec3 phi23 = vec3( 0.0 );
+ if ( baseIOR[ 0 ] < iridescenceIOR ) phi23[ 0 ] = PI;
+ if ( baseIOR[ 1 ] < iridescenceIOR ) phi23[ 1 ] = PI;
+ if ( baseIOR[ 2 ] < iridescenceIOR ) phi23[ 2 ] = PI;
+ float OPD = 2.0 * iridescenceIOR * thinFilmThickness * cosTheta2;
+ vec3 phi = vec3( phi21 ) + phi23;
+ vec3 R123 = clamp( R12 * R23, 1e-5, 0.9999 );
+ vec3 r123 = sqrt( R123 );
+ vec3 Rs = pow2( T121 ) * R23 / ( vec3( 1.0 ) - R123 );
+ vec3 C0 = R12 + Rs;
+ I = C0;
+ vec3 Cm = Rs - T121;
+ for ( int m = 1; m <= 2; ++ m ) {
+ Cm *= r123;
+ vec3 Sm = 2.0 * evalSensitivity( float( m ) * OPD, float( m ) * phi );
+ I += Cm * Sm;
+ }
+ return max( I, vec3( 0.0 ) );
+ }
+#endif`,bumpmap_pars_fragment:`#ifdef USE_BUMPMAP
+ uniform sampler2D bumpMap;
+ uniform float bumpScale;
+ vec2 dHdxy_fwd() {
+ vec2 dSTdx = dFdx( vBumpMapUv );
+ vec2 dSTdy = dFdy( vBumpMapUv );
+ float Hll = bumpScale * texture2D( bumpMap, vBumpMapUv ).x;
+ float dBx = bumpScale * texture2D( bumpMap, vBumpMapUv + dSTdx ).x - Hll;
+ float dBy = bumpScale * texture2D( bumpMap, vBumpMapUv + dSTdy ).x - Hll;
+ return vec2( dBx, dBy );
+ }
+ vec3 perturbNormalArb( vec3 surf_pos, vec3 surf_norm, vec2 dHdxy, float faceDirection ) {
+ vec3 vSigmaX = normalize( dFdx( surf_pos.xyz ) );
+ vec3 vSigmaY = normalize( dFdy( surf_pos.xyz ) );
+ vec3 vN = surf_norm;
+ vec3 R1 = cross( vSigmaY, vN );
+ vec3 R2 = cross( vN, vSigmaX );
+ float fDet = dot( vSigmaX, R1 ) * faceDirection;
+ vec3 vGrad = sign( fDet ) * ( dHdxy.x * R1 + dHdxy.y * R2 );
+ return normalize( abs( fDet ) * surf_norm - vGrad );
+ }
+#endif`,clipping_planes_fragment:`#if NUM_CLIPPING_PLANES > 0
+ vec4 plane;
+ #ifdef ALPHA_TO_COVERAGE
+ float distanceToPlane, distanceGradient;
+ float clipOpacity = 1.0;
+ #pragma unroll_loop_start
+ for ( int i = 0; i < UNION_CLIPPING_PLANES; i ++ ) {
+ plane = clippingPlanes[ i ];
+ distanceToPlane = - dot( vClipPosition, plane.xyz ) + plane.w;
+ distanceGradient = fwidth( distanceToPlane ) / 2.0;
+ clipOpacity *= smoothstep( - distanceGradient, distanceGradient, distanceToPlane );
+ if ( clipOpacity == 0.0 ) discard;
+ }
+ #pragma unroll_loop_end
+ #if UNION_CLIPPING_PLANES < NUM_CLIPPING_PLANES
+ float unionClipOpacity = 1.0;
+ #pragma unroll_loop_start
+ for ( int i = UNION_CLIPPING_PLANES; i < NUM_CLIPPING_PLANES; i ++ ) {
+ plane = clippingPlanes[ i ];
+ distanceToPlane = - dot( vClipPosition, plane.xyz ) + plane.w;
+ distanceGradient = fwidth( distanceToPlane ) / 2.0;
+ unionClipOpacity *= 1.0 - smoothstep( - distanceGradient, distanceGradient, distanceToPlane );
+ }
+ #pragma unroll_loop_end
+ clipOpacity *= 1.0 - unionClipOpacity;
+ #endif
+ diffuseColor.a *= clipOpacity;
+ if ( diffuseColor.a == 0.0 ) discard;
+ #else
+ #pragma unroll_loop_start
+ for ( int i = 0; i < UNION_CLIPPING_PLANES; i ++ ) {
+ plane = clippingPlanes[ i ];
+ if ( dot( vClipPosition, plane.xyz ) > plane.w ) discard;
+ }
+ #pragma unroll_loop_end
+ #if UNION_CLIPPING_PLANES < NUM_CLIPPING_PLANES
+ bool clipped = true;
+ #pragma unroll_loop_start
+ for ( int i = UNION_CLIPPING_PLANES; i < NUM_CLIPPING_PLANES; i ++ ) {
+ plane = clippingPlanes[ i ];
+ clipped = ( dot( vClipPosition, plane.xyz ) > plane.w ) && clipped;
+ }
+ #pragma unroll_loop_end
+ if ( clipped ) discard;
+ #endif
+ #endif
+#endif`,clipping_planes_pars_fragment:`#if NUM_CLIPPING_PLANES > 0
+ varying vec3 vClipPosition;
+ uniform vec4 clippingPlanes[ NUM_CLIPPING_PLANES ];
+#endif`,clipping_planes_pars_vertex:`#if NUM_CLIPPING_PLANES > 0
+ varying vec3 vClipPosition;
+#endif`,clipping_planes_vertex:`#if NUM_CLIPPING_PLANES > 0
+ vClipPosition = - mvPosition.xyz;
+#endif`,color_fragment:`#if defined( USE_COLOR ) || defined( USE_COLOR_ALPHA )
+ diffuseColor *= vColor;
+#endif`,color_pars_fragment:`#if defined( USE_COLOR ) || defined( USE_COLOR_ALPHA )
+ varying vec4 vColor;
+#endif`,color_pars_vertex:`#if defined( USE_COLOR ) || defined( USE_COLOR_ALPHA ) || defined( USE_INSTANCING_COLOR ) || defined( USE_BATCHING_COLOR )
+ varying vec4 vColor;
+#endif`,color_vertex:`#if defined( USE_COLOR ) || defined( USE_COLOR_ALPHA ) || defined( USE_INSTANCING_COLOR ) || defined( USE_BATCHING_COLOR )
+ vColor = vec4( 1.0 );
+#endif
+#ifdef USE_COLOR_ALPHA
+ vColor *= color;
+#elif defined( USE_COLOR )
+ vColor.rgb *= color;
+#endif
+#ifdef USE_INSTANCING_COLOR
+ vColor.rgb *= instanceColor.rgb;
+#endif
+#ifdef USE_BATCHING_COLOR
+ vColor *= getBatchingColor( getIndirectIndex( gl_DrawID ) );
+#endif`,common:`#define PI 3.141592653589793
+#define PI2 6.283185307179586
+#define PI_HALF 1.5707963267948966
+#define RECIPROCAL_PI 0.3183098861837907
+#define RECIPROCAL_PI2 0.15915494309189535
+#define EPSILON 1e-6
+#ifndef saturate
+#define saturate( a ) clamp( a, 0.0, 1.0 )
+#endif
+#define whiteComplement( a ) ( 1.0 - saturate( a ) )
+float pow2( const in float x ) { return x*x; }
+vec3 pow2( const in vec3 x ) { return x*x; }
+float pow3( const in float x ) { return x*x*x; }
+float pow4( const in float x ) { float x2 = x*x; return x2*x2; }
+float max3( const in vec3 v ) { return max( max( v.x, v.y ), v.z ); }
+float average( const in vec3 v ) { return dot( v, vec3( 0.3333333 ) ); }
+highp float rand( const in vec2 uv ) {
+ const highp float a = 12.9898, b = 78.233, c = 43758.5453;
+ highp float dt = dot( uv.xy, vec2( a,b ) ), sn = mod( dt, PI );
+ return fract( sin( sn ) * c );
+}
+#ifdef HIGH_PRECISION
+ float precisionSafeLength( vec3 v ) { return length( v ); }
+#else
+ float precisionSafeLength( vec3 v ) {
+ float maxComponent = max3( abs( v ) );
+ return length( v / maxComponent ) * maxComponent;
+ }
+#endif
+struct IncidentLight {
+ vec3 color;
+ vec3 direction;
+ bool visible;
+};
+struct ReflectedLight {
+ vec3 directDiffuse;
+ vec3 directSpecular;
+ vec3 indirectDiffuse;
+ vec3 indirectSpecular;
+};
+#ifdef USE_ALPHAHASH
+ varying vec3 vPosition;
+#endif
+vec3 transformDirection( in vec3 dir, in mat4 matrix ) {
+ return normalize( ( matrix * vec4( dir, 0.0 ) ).xyz );
+}
+#define inverseTransformDirection transformDirectionByInverseViewMatrix
+vec3 transformNormalByInverseViewMatrix( in vec3 normal, in mat4 viewMatrix ) {
+ return normalize( ( vec4( normal, 0.0 ) * viewMatrix ).xyz );
+}
+vec3 transformDirectionByInverseViewMatrix( in vec3 dir, in mat4 viewMatrix ) {
+ return normalize( ( vec4( dir, 0.0 ) * viewMatrix ).xyz );
+}
+bool isPerspectiveMatrix( mat4 m ) {
+ return m[ 2 ][ 3 ] == - 1.0;
+}
+vec2 equirectUv( in vec3 dir ) {
+ float u = atan( dir.z, dir.x ) * RECIPROCAL_PI2 + 0.5;
+ float v = asin( clamp( dir.y, - 1.0, 1.0 ) ) * RECIPROCAL_PI + 0.5;
+ return vec2( u, v );
+}
+vec3 BRDF_Lambert( const in vec3 diffuseColor ) {
+ return RECIPROCAL_PI * diffuseColor;
+}
+vec3 F_Schlick( const in vec3 f0, const in float f90, const in float dotVH ) {
+ float fresnel = exp2( ( - 5.55473 * dotVH - 6.98316 ) * dotVH );
+ return f0 * ( 1.0 - fresnel ) + ( f90 * fresnel );
+}
+float F_Schlick( const in float f0, const in float f90, const in float dotVH ) {
+ float fresnel = exp2( ( - 5.55473 * dotVH - 6.98316 ) * dotVH );
+ return f0 * ( 1.0 - fresnel ) + ( f90 * fresnel );
+} // validated`,cube_uv_reflection_fragment:`#ifdef ENVMAP_TYPE_CUBE_UV
+ #define cubeUV_minMipLevel 4.0
+ #define cubeUV_minTileSize 16.0
+ float getFace( vec3 direction ) {
+ vec3 absDirection = abs( direction );
+ float face = - 1.0;
+ if ( absDirection.x > absDirection.z ) {
+ if ( absDirection.x > absDirection.y )
+ face = direction.x > 0.0 ? 0.0 : 3.0;
+ else
+ face = direction.y > 0.0 ? 1.0 : 4.0;
+ } else {
+ if ( absDirection.z > absDirection.y )
+ face = direction.z > 0.0 ? 2.0 : 5.0;
+ else
+ face = direction.y > 0.0 ? 1.0 : 4.0;
+ }
+ return face;
+ }
+ vec2 getUV( vec3 direction, float face ) {
+ vec2 uv;
+ if ( face == 0.0 ) {
+ uv = vec2( direction.z, direction.y ) / abs( direction.x );
+ } else if ( face == 1.0 ) {
+ uv = vec2( - direction.x, - direction.z ) / abs( direction.y );
+ } else if ( face == 2.0 ) {
+ uv = vec2( - direction.x, direction.y ) / abs( direction.z );
+ } else if ( face == 3.0 ) {
+ uv = vec2( - direction.z, direction.y ) / abs( direction.x );
+ } else if ( face == 4.0 ) {
+ uv = vec2( - direction.x, direction.z ) / abs( direction.y );
+ } else {
+ uv = vec2( direction.x, direction.y ) / abs( direction.z );
+ }
+ return 0.5 * ( uv + 1.0 );
+ }
+ vec3 bilinearCubeUV( sampler2D envMap, vec3 direction, float mipInt ) {
+ float face = getFace( direction );
+ float filterInt = max( cubeUV_minMipLevel - mipInt, 0.0 );
+ mipInt = max( mipInt, cubeUV_minMipLevel );
+ float faceSize = exp2( mipInt );
+ highp vec2 uv = getUV( direction, face ) * ( faceSize - 2.0 ) + 1.0;
+ if ( face > 2.0 ) {
+ uv.y += faceSize;
+ face -= 3.0;
+ }
+ uv.x += face * faceSize;
+ uv.x += filterInt * 3.0 * cubeUV_minTileSize;
+ uv.y += 4.0 * ( exp2( CUBEUV_MAX_MIP ) - faceSize );
+ uv.x *= CUBEUV_TEXEL_WIDTH;
+ uv.y *= CUBEUV_TEXEL_HEIGHT;
+ #ifdef texture2DGradEXT
+ return texture2DGradEXT( envMap, uv, vec2( 0.0 ), vec2( 0.0 ) ).rgb;
+ #else
+ return texture2D( envMap, uv ).rgb;
+ #endif
+ }
+ #define cubeUV_r0 1.0
+ #define cubeUV_m0 - 2.0
+ #define cubeUV_r1 0.8
+ #define cubeUV_m1 - 1.0
+ #define cubeUV_r4 0.4
+ #define cubeUV_m4 2.0
+ #define cubeUV_r5 0.305
+ #define cubeUV_m5 3.0
+ #define cubeUV_r6 0.21
+ #define cubeUV_m6 4.0
+ float roughnessToMip( float roughness ) {
+ float mip = 0.0;
+ if ( roughness >= cubeUV_r1 ) {
+ mip = ( cubeUV_r0 - roughness ) * ( cubeUV_m1 - cubeUV_m0 ) / ( cubeUV_r0 - cubeUV_r1 ) + cubeUV_m0;
+ } else if ( roughness >= cubeUV_r4 ) {
+ mip = ( cubeUV_r1 - roughness ) * ( cubeUV_m4 - cubeUV_m1 ) / ( cubeUV_r1 - cubeUV_r4 ) + cubeUV_m1;
+ } else if ( roughness >= cubeUV_r5 ) {
+ mip = ( cubeUV_r4 - roughness ) * ( cubeUV_m5 - cubeUV_m4 ) / ( cubeUV_r4 - cubeUV_r5 ) + cubeUV_m4;
+ } else if ( roughness >= cubeUV_r6 ) {
+ mip = ( cubeUV_r5 - roughness ) * ( cubeUV_m6 - cubeUV_m5 ) / ( cubeUV_r5 - cubeUV_r6 ) + cubeUV_m5;
+ } else {
+ mip = - 2.0 * log2( 1.16 * roughness ); }
+ return mip;
+ }
+ vec4 textureCubeUV( sampler2D envMap, vec3 sampleDir, float roughness ) {
+ float mip = clamp( roughnessToMip( roughness ), cubeUV_m0, CUBEUV_MAX_MIP );
+ float mipF = fract( mip );
+ float mipInt = floor( mip );
+ vec3 color0 = bilinearCubeUV( envMap, sampleDir, mipInt );
+ if ( mipF == 0.0 ) {
+ return vec4( color0, 1.0 );
+ } else {
+ vec3 color1 = bilinearCubeUV( envMap, sampleDir, mipInt + 1.0 );
+ return vec4( mix( color0, color1, mipF ), 1.0 );
+ }
+ }
+#endif`,defaultnormal_vertex:`vec3 transformedNormal = objectNormal;
+#ifdef USE_TANGENT
+ vec3 transformedTangent = objectTangent;
+#endif
+#ifdef USE_BATCHING
+ mat3 bm = mat3( batchingMatrix );
+ transformedNormal /= vec3( dot( bm[ 0 ], bm[ 0 ] ), dot( bm[ 1 ], bm[ 1 ] ), dot( bm[ 2 ], bm[ 2 ] ) );
+ transformedNormal = bm * transformedNormal;
+ #ifdef USE_TANGENT
+ transformedTangent = bm * transformedTangent;
+ #endif
+#endif
+#ifdef USE_INSTANCING
+ mat3 im = mat3( instanceMatrix );
+ transformedNormal /= vec3( dot( im[ 0 ], im[ 0 ] ), dot( im[ 1 ], im[ 1 ] ), dot( im[ 2 ], im[ 2 ] ) );
+ transformedNormal = im * transformedNormal;
+ #ifdef USE_TANGENT
+ transformedTangent = im * transformedTangent;
+ #endif
+#endif
+transformedNormal = normalMatrix * transformedNormal;
+#ifdef FLIP_SIDED
+ transformedNormal = - transformedNormal;
+#endif
+#ifdef USE_TANGENT
+ transformedTangent = ( modelViewMatrix * vec4( transformedTangent, 0.0 ) ).xyz;
+#endif`,displacementmap_pars_vertex:`#ifdef USE_DISPLACEMENTMAP
+ uniform sampler2D displacementMap;
+ uniform float displacementScale;
+ uniform float displacementBias;
+#endif`,displacementmap_vertex:`#ifdef USE_DISPLACEMENTMAP
+ transformed += normalize( objectNormal ) * ( texture2D( displacementMap, vDisplacementMapUv ).x * displacementScale + displacementBias );
+#endif`,emissivemap_fragment:`#ifdef USE_EMISSIVEMAP
+ vec4 emissiveColor = texture2D( emissiveMap, vEmissiveMapUv );
+ #ifdef DECODE_VIDEO_TEXTURE_EMISSIVE
+ emissiveColor = sRGBTransferEOTF( emissiveColor );
+ #endif
+ totalEmissiveRadiance *= emissiveColor.rgb;
+#endif`,emissivemap_pars_fragment:`#ifdef USE_EMISSIVEMAP
+ uniform sampler2D emissiveMap;
+#endif`,colorspace_fragment:`gl_FragColor = linearToOutputTexel( gl_FragColor );`,colorspace_pars_fragment:`vec4 LinearTransferOETF( in vec4 value ) {
+ return value;
+}
+vec4 sRGBTransferEOTF( in vec4 value ) {
+ return vec4( mix( pow( value.rgb * 0.9478672986 + vec3( 0.0521327014 ), vec3( 2.4 ) ), value.rgb * 0.0773993808, vec3( lessThanEqual( value.rgb, vec3( 0.04045 ) ) ) ), value.a );
+}
+vec4 sRGBTransferOETF( in vec4 value ) {
+ return vec4( mix( pow( value.rgb, vec3( 0.41666 ) ) * 1.055 - vec3( 0.055 ), value.rgb * 12.92, vec3( lessThanEqual( value.rgb, vec3( 0.0031308 ) ) ) ), value.a );
+}`,envmap_fragment:`#ifdef USE_ENVMAP
+ #ifdef ENV_WORLDPOS
+ vec3 cameraToFrag;
+ if ( isOrthographic ) {
+ cameraToFrag = normalize( vec3( - viewMatrix[ 0 ][ 2 ], - viewMatrix[ 1 ][ 2 ], - viewMatrix[ 2 ][ 2 ] ) );
+ } else {
+ cameraToFrag = normalize( vWorldPosition - cameraPosition );
+ }
+ vec3 worldNormal = transformNormalByInverseViewMatrix( normal, viewMatrix );
+ #ifdef ENVMAP_MODE_REFLECTION
+ vec3 reflectVec = reflect( cameraToFrag, worldNormal );
+ #else
+ vec3 reflectVec = refract( cameraToFrag, worldNormal, refractionRatio );
+ #endif
+ #else
+ vec3 reflectVec = vReflect;
+ #endif
+ #ifdef ENVMAP_TYPE_CUBE
+ vec4 envColor = textureCube( envMap, envMapRotation * reflectVec );
+ #ifdef ENVMAP_BLENDING_MULTIPLY
+ outgoingLight = mix( outgoingLight, outgoingLight * envColor.xyz, specularStrength * reflectivity );
+ #elif defined( ENVMAP_BLENDING_MIX )
+ outgoingLight = mix( outgoingLight, envColor.xyz, specularStrength * reflectivity );
+ #elif defined( ENVMAP_BLENDING_ADD )
+ outgoingLight += envColor.xyz * specularStrength * reflectivity;
+ #endif
+ #endif
+#endif`,envmap_common_pars_fragment:`#ifdef USE_ENVMAP
+ uniform float envMapIntensity;
+ uniform mat3 envMapRotation;
+ #ifdef ENVMAP_TYPE_CUBE
+ uniform samplerCube envMap;
+ #else
+ uniform sampler2D envMap;
+ #endif
+#endif`,envmap_pars_fragment:`#ifdef USE_ENVMAP
+ uniform float reflectivity;
+ #if defined( USE_BUMPMAP ) || defined( USE_NORMALMAP ) || defined( PHONG ) || defined( LAMBERT )
+ #define ENV_WORLDPOS
+ #endif
+ #ifdef ENV_WORLDPOS
+ varying vec3 vWorldPosition;
+ uniform float refractionRatio;
+ #else
+ varying vec3 vReflect;
+ #endif
+#endif`,envmap_pars_vertex:`#ifdef USE_ENVMAP
+ #if defined( USE_BUMPMAP ) || defined( USE_NORMALMAP ) || defined( PHONG ) || defined( LAMBERT )
+ #define ENV_WORLDPOS
+ #endif
+ #ifdef ENV_WORLDPOS
+
+ varying vec3 vWorldPosition;
+ #else
+ varying vec3 vReflect;
+ uniform float refractionRatio;
+ #endif
+#endif`,envmap_physical_pars_fragment:`#ifdef USE_ENVMAP
+ vec3 getIBLIrradiance( const in vec3 normal ) {
+ #ifdef ENVMAP_TYPE_CUBE_UV
+ vec3 worldNormal = transformNormalByInverseViewMatrix( normal, viewMatrix );
+ vec4 envMapColor = textureCubeUV( envMap, envMapRotation * worldNormal, 1.0 );
+ return PI * envMapColor.rgb * envMapIntensity;
+ #else
+ return vec3( 0.0 );
+ #endif
+ }
+ vec3 getIBLRadiance( const in vec3 viewDir, const in vec3 normal, const in float roughness ) {
+ #ifdef ENVMAP_TYPE_CUBE_UV
+ vec3 reflectVec = reflect( - viewDir, normal );
+ reflectVec = normalize( mix( reflectVec, normal, pow4( roughness ) ) );
+ reflectVec = transformDirectionByInverseViewMatrix( reflectVec, viewMatrix );
+ vec4 envMapColor = textureCubeUV( envMap, envMapRotation * reflectVec, roughness );
+ return envMapColor.rgb * envMapIntensity;
+ #else
+ return vec3( 0.0 );
+ #endif
+ }
+ #ifdef USE_RETROREFLECTION
+ vec3 getIBLRetroRadiance( const in vec3 viewDir, const in vec3 normal, const in float roughness ) {
+ #ifdef ENVMAP_TYPE_CUBE_UV
+ vec3 retroVec = normalize( mix( viewDir, normal, pow4( roughness ) ) );
+ retroVec = transformDirectionByInverseViewMatrix( retroVec, viewMatrix );
+ vec4 envMapColor = textureCubeUV( envMap, envMapRotation * retroVec, roughness );
+ return envMapColor.rgb * envMapIntensity;
+ #else
+ return vec3( 0.0 );
+ #endif
+ }
+ #endif
+ #ifdef USE_ANISOTROPY
+ vec3 getIBLAnisotropyRadiance( const in vec3 viewDir, const in vec3 normal, const in float roughness, const in vec3 bitangent, const in float anisotropy ) {
+ #ifdef ENVMAP_TYPE_CUBE_UV
+ vec3 bentNormal = cross( bitangent, viewDir );
+ bentNormal = normalize( cross( bentNormal, bitangent ) );
+ bentNormal = normalize( mix( bentNormal, normal, pow2( pow2( 1.0 - anisotropy * ( 1.0 - roughness ) ) ) ) );
+ return getIBLRadiance( viewDir, bentNormal, roughness );
+ #else
+ return vec3( 0.0 );
+ #endif
+ }
+ #ifdef USE_RETROREFLECTION
+ vec3 getIBLAnisotropyRetroRadiance( const in vec3 viewDir, const in vec3 normal, const in float roughness, const in vec3 bitangent, const in float anisotropy ) {
+ #ifdef ENVMAP_TYPE_CUBE_UV
+ vec3 bentNormal = cross( bitangent, viewDir );
+ bentNormal = normalize( cross( bentNormal, bitangent ) );
+ bentNormal = normalize( mix( bentNormal, normal, pow2( pow2( 1.0 - anisotropy * ( 1.0 - roughness ) ) ) ) );
+ return getIBLRetroRadiance( viewDir, bentNormal, roughness );
+ #else
+ return vec3( 0.0 );
+ #endif
+ }
+ #endif
+ #endif
+#endif`,envmap_vertex:`#ifdef USE_ENVMAP
+ #ifdef ENV_WORLDPOS
+ vWorldPosition = worldPosition.xyz;
+ #else
+ vec3 cameraToVertex;
+ if ( isOrthographic ) {
+ cameraToVertex = normalize( vec3( - viewMatrix[ 0 ][ 2 ], - viewMatrix[ 1 ][ 2 ], - viewMatrix[ 2 ][ 2 ] ) );
+ } else {
+ cameraToVertex = normalize( worldPosition.xyz - cameraPosition );
+ }
+ vec3 worldNormal = transformNormalByInverseViewMatrix( transformedNormal, viewMatrix );
+ #ifdef ENVMAP_MODE_REFLECTION
+ vReflect = reflect( cameraToVertex, worldNormal );
+ #else
+ vReflect = refract( cameraToVertex, worldNormal, refractionRatio );
+ #endif
+ #endif
+#endif`,fog_vertex:`#ifdef USE_FOG
+ vFogDepth = - mvPosition.z;
+#endif`,fog_pars_vertex:`#ifdef USE_FOG
+ varying float vFogDepth;
+#endif`,fog_fragment:`#ifdef USE_FOG
+ #ifdef FOG_EXP2
+ float fogFactor = 1.0 - exp( - fogDensity * fogDensity * vFogDepth * vFogDepth );
+ #else
+ float fogFactor = smoothstep( fogNear, fogFar, vFogDepth );
+ #endif
+ gl_FragColor.rgb = mix( gl_FragColor.rgb, fogColor, fogFactor );
+#endif`,fog_pars_fragment:`#ifdef USE_FOG
+ uniform vec3 fogColor;
+ varying float vFogDepth;
+ #ifdef FOG_EXP2
+ uniform float fogDensity;
+ #else
+ uniform float fogNear;
+ uniform float fogFar;
+ #endif
+#endif`,gradientmap_pars_fragment:`#ifdef USE_GRADIENTMAP
+ uniform sampler2D gradientMap;
+#endif
+vec3 getGradientIrradiance( vec3 normal, vec3 lightDirection ) {
+ float dotNL = dot( normal, lightDirection );
+ vec2 coord = vec2( dotNL * 0.5 + 0.5, 0.0 );
+ #ifdef USE_GRADIENTMAP
+ return vec3( texture2D( gradientMap, coord ).r );
+ #else
+ vec2 fw = fwidth( coord ) * 0.5;
+ return mix( vec3( 0.7 ), vec3( 1.0 ), smoothstep( 0.7 - fw.x, 0.7 + fw.x, coord.x ) );
+ #endif
+}`,lightmap_pars_fragment:`#ifdef USE_LIGHTMAP
+ uniform sampler2D lightMap;
+ uniform float lightMapIntensity;
+#endif`,lights_lambert_fragment:`LambertMaterial material;
+material.diffuseColor = diffuseColor.rgb;
+material.specularStrength = specularStrength;`,lights_lambert_pars_fragment:`varying vec3 vViewPosition;
+struct LambertMaterial {
+ vec3 diffuseColor;
+ float specularStrength;
+};
+void RE_Direct_Lambert( const in IncidentLight directLight, const in vec3 geometryPosition, const in vec3 geometryNormal, const in vec3 geometryViewDir, const in vec3 geometryClearcoatNormal, const in LambertMaterial material, inout ReflectedLight reflectedLight ) {
+ float dotNL = saturate( dot( geometryNormal, directLight.direction ) );
+ vec3 irradiance = dotNL * directLight.color;
+ reflectedLight.directDiffuse += irradiance * BRDF_Lambert( material.diffuseColor );
+}
+void RE_IndirectDiffuse_Lambert( const in vec3 irradiance, const in vec3 geometryPosition, const in vec3 geometryNormal, const in vec3 geometryViewDir, const in vec3 geometryClearcoatNormal, const in LambertMaterial material, inout ReflectedLight reflectedLight ) {
+ reflectedLight.indirectDiffuse += irradiance * BRDF_Lambert( material.diffuseColor );
+}
+#define RE_Direct RE_Direct_Lambert
+#define RE_IndirectDiffuse RE_IndirectDiffuse_Lambert`,lights_pars_begin:`uniform bool receiveShadow;
+uniform vec3 ambientLightColor;
+#if defined( USE_LIGHT_PROBES )
+ uniform vec3 lightProbe[ 9 ];
+#endif
+vec3 shGetIrradianceAt( in vec3 normal, in vec3 shCoefficients[ 9 ] ) {
+ float x = normal.x, y = normal.y, z = normal.z;
+ vec3 result = shCoefficients[ 0 ] * 0.886227;
+ result += shCoefficients[ 1 ] * 2.0 * 0.511664 * y;
+ result += shCoefficients[ 2 ] * 2.0 * 0.511664 * z;
+ result += shCoefficients[ 3 ] * 2.0 * 0.511664 * x;
+ result += shCoefficients[ 4 ] * 2.0 * 0.429043 * x * y;
+ result += shCoefficients[ 5 ] * 2.0 * 0.429043 * y * z;
+ result += shCoefficients[ 6 ] * ( 0.743125 * z * z - 0.247708 );
+ result += shCoefficients[ 7 ] * 2.0 * 0.429043 * x * z;
+ result += shCoefficients[ 8 ] * 0.429043 * ( x * x - y * y );
+ return result;
+}
+vec3 getLightProbeIrradiance( const in vec3 lightProbe[ 9 ], const in vec3 normal ) {
+ vec3 worldNormal = transformNormalByInverseViewMatrix( normal, viewMatrix );
+ vec3 irradiance = shGetIrradianceAt( worldNormal, lightProbe );
+ return irradiance;
+}
+vec3 getAmbientLightIrradiance( const in vec3 ambientLightColor ) {
+ vec3 irradiance = ambientLightColor;
+ return irradiance;
+}
+float getDistanceAttenuation( const in float lightDistance, const in float cutoffDistance, const in float decayExponent ) {
+ float distanceFalloff = 1.0 / max( pow( lightDistance, decayExponent ), 0.01 );
+ if ( cutoffDistance > 0.0 ) {
+ distanceFalloff *= pow2( saturate( 1.0 - pow4( lightDistance / cutoffDistance ) ) );
+ }
+ return distanceFalloff;
+}
+float getSpotAttenuation( const in float coneCosine, const in float penumbraCosine, const in float angleCosine ) {
+ return smoothstep( coneCosine, penumbraCosine, angleCosine );
+}
+#if NUM_SUN_LIGHTS > 0
+ struct SunLight {
+ vec3 direction;
+ vec3 color;
+ };
+ uniform SunLight sunLights[ NUM_SUN_LIGHTS ];
+ void getSunLightInfo( const in SunLight sunLight, out IncidentLight light ) {
+ light.color = sunLight.color;
+ light.direction = sunLight.direction;
+ light.visible = true;
+ }
+#endif
+#if NUM_DIR_LIGHTS > 0
+ struct DirectionalLight {
+ vec3 direction;
+ vec3 color;
+ };
+ uniform DirectionalLight directionalLights[ NUM_DIR_LIGHTS ];
+ void getDirectionalLightInfo( const in DirectionalLight directionalLight, out IncidentLight light ) {
+ light.color = directionalLight.color;
+ light.direction = directionalLight.direction;
+ light.visible = true;
+ }
+#endif
+#if NUM_POINT_LIGHTS > 0
+ struct PointLight {
+ vec3 position;
+ vec3 color;
+ float distance;
+ float decay;
+ };
+ uniform PointLight pointLights[ NUM_POINT_LIGHTS ];
+ void getPointLightInfo( const in PointLight pointLight, const in vec3 geometryPosition, out IncidentLight light ) {
+ vec3 lVector = pointLight.position - geometryPosition;
+ light.direction = normalize( lVector );
+ float lightDistance = length( lVector );
+ light.color = pointLight.color;
+ light.color *= getDistanceAttenuation( lightDistance, pointLight.distance, pointLight.decay );
+ light.visible = ( light.color != vec3( 0.0 ) );
+ }
+#endif
+#if NUM_SPOT_LIGHTS > 0
+ struct SpotLight {
+ vec3 position;
+ vec3 direction;
+ vec3 color;
+ float distance;
+ float decay;
+ float coneCos;
+ float penumbraCos;
+ };
+ uniform SpotLight spotLights[ NUM_SPOT_LIGHTS ];
+ void getSpotLightInfo( const in SpotLight spotLight, const in vec3 geometryPosition, out IncidentLight light ) {
+ vec3 lVector = spotLight.position - geometryPosition;
+ light.direction = normalize( lVector );
+ float angleCos = dot( light.direction, spotLight.direction );
+ float spotAttenuation = getSpotAttenuation( spotLight.coneCos, spotLight.penumbraCos, angleCos );
+ if ( spotAttenuation > 0.0 ) {
+ float lightDistance = length( lVector );
+ light.color = spotLight.color * spotAttenuation;
+ light.color *= getDistanceAttenuation( lightDistance, spotLight.distance, spotLight.decay );
+ light.visible = ( light.color != vec3( 0.0 ) );
+ } else {
+ light.color = vec3( 0.0 );
+ light.visible = false;
+ }
+ }
+#endif
+#if NUM_RECT_AREA_LIGHTS > 0
+ struct RectAreaLight {
+ vec3 color;
+ vec3 position;
+ vec3 halfWidth;
+ vec3 halfHeight;
+ };
+ uniform sampler2D ltc_1; uniform sampler2D ltc_2;
+ uniform RectAreaLight rectAreaLights[ NUM_RECT_AREA_LIGHTS ];
+#endif
+#if NUM_HEMI_LIGHTS > 0
+ struct HemisphereLight {
+ vec3 direction;
+ vec3 skyColor;
+ vec3 groundColor;
+ };
+ uniform HemisphereLight hemisphereLights[ NUM_HEMI_LIGHTS ];
+ vec3 getHemisphereLightIrradiance( const in HemisphereLight hemiLight, const in vec3 normal ) {
+ float dotNL = dot( normal, hemiLight.direction );
+ float hemiDiffuseWeight = 0.5 * dotNL + 0.5;
+ vec3 irradiance = mix( hemiLight.groundColor, hemiLight.skyColor, hemiDiffuseWeight );
+ return irradiance;
+ }
+#endif
+#include <lightprobes_pars_fragment>`,lights_toon_fragment:`ToonMaterial material;
+material.diffuseColor = diffuseColor.rgb;`,lights_toon_pars_fragment:`varying vec3 vViewPosition;
+struct ToonMaterial {
+ vec3 diffuseColor;
+};
+void RE_Direct_Toon( const in IncidentLight directLight, const in vec3 geometryPosition, const in vec3 geometryNormal, const in vec3 geometryViewDir, const in vec3 geometryClearcoatNormal, const in ToonMaterial material, inout ReflectedLight reflectedLight ) {
+ vec3 irradiance = getGradientIrradiance( geometryNormal, directLight.direction ) * directLight.color;
+ reflectedLight.directDiffuse += irradiance * BRDF_Lambert( material.diffuseColor );
+}
+void RE_IndirectDiffuse_Toon( const in vec3 irradiance, const in vec3 geometryPosition, const in vec3 geometryNormal, const in vec3 geometryViewDir, const in vec3 geometryClearcoatNormal, const in ToonMaterial material, inout ReflectedLight reflectedLight ) {
+ reflectedLight.indirectDiffuse += irradiance * BRDF_Lambert( material.diffuseColor );
+}
+#define RE_Direct RE_Direct_Toon
+#define RE_IndirectDiffuse RE_IndirectDiffuse_Toon`,lights_phong_fragment:`BlinnPhongMaterial material;
+material.diffuseColor = diffuseColor.rgb;
+material.specularColor = specular;
+material.specularShininess = shininess;
+material.specularStrength = specularStrength;`,lights_phong_pars_fragment:`varying vec3 vViewPosition;
+struct BlinnPhongMaterial {
+ vec3 diffuseColor;
+ vec3 specularColor;
+ float specularShininess;
+ float specularStrength;
+};
+void RE_Direct_BlinnPhong( const in IncidentLight directLight, const in vec3 geometryPosition, const in vec3 geometryNormal, const in vec3 geometryViewDir, const in vec3 geometryClearcoatNormal, const in BlinnPhongMaterial material, inout ReflectedLight reflectedLight ) {
+ float dotNL = saturate( dot( geometryNormal, directLight.direction ) );
+ vec3 irradiance = dotNL * directLight.color;
+ reflectedLight.directDiffuse += irradiance * BRDF_Lambert( material.diffuseColor );
+ reflectedLight.directSpecular += irradiance * BRDF_BlinnPhong( directLight.direction, geometryViewDir, geometryNormal, material.specularColor, material.specularShininess ) * material.specularStrength;
+}
+void RE_IndirectDiffuse_BlinnPhong( const in vec3 irradiance, const in vec3 geometryPosition, const in vec3 geometryNormal, const in vec3 geometryViewDir, const in vec3 geometryClearcoatNormal, const in BlinnPhongMaterial material, inout ReflectedLight reflectedLight ) {
+ reflectedLight.indirectDiffuse += irradiance * BRDF_Lambert( material.diffuseColor );
+}
+#define RE_Direct RE_Direct_BlinnPhong
+#define RE_IndirectDiffuse RE_IndirectDiffuse_BlinnPhong`,lights_physical_fragment:`PhysicalMaterial material;
+material.diffuseColor = diffuseColor.rgb;
+material.diffuseContribution = diffuseColor.rgb * ( 1.0 - metalnessFactor );
+material.metalness = metalnessFactor;
+vec3 dxy = max( abs( dFdx( nonPerturbedNormal ) ), abs( dFdy( nonPerturbedNormal ) ) );
+float geometryRoughness = max( max( dxy.x, dxy.y ), dxy.z );
+material.roughness = max( roughnessFactor, 0.0525 );material.roughness += geometryRoughness;
+material.roughness = min( material.roughness, 1.0 );
+#ifdef IOR
+ material.ior = ior;
+ #ifdef USE_SPECULAR
+ float specularIntensityFactor = specularIntensity;
+ vec3 specularColorFactor = specularColor;
+ #ifdef USE_SPECULAR_COLORMAP
+ specularColorFactor *= texture2D( specularColorMap, vSpecularColorMapUv ).rgb;
+ #endif
+ #ifdef USE_SPECULAR_INTENSITYMAP
+ specularIntensityFactor *= texture2D( specularIntensityMap, vSpecularIntensityMapUv ).a;
+ #endif
+ material.specularF90 = mix( specularIntensityFactor, 1.0, metalnessFactor );
+ #else
+ float specularIntensityFactor = 1.0;
+ vec3 specularColorFactor = vec3( 1.0 );
+ material.specularF90 = 1.0;
+ #endif
+ material.specularColor = min( pow2( ( material.ior - 1.0 ) / ( material.ior + 1.0 ) ) * specularColorFactor, vec3( 1.0 ) ) * specularIntensityFactor;
+ material.specularColorBlended = mix( material.specularColor, diffuseColor.rgb, metalnessFactor );
+#else
+ material.specularColor = vec3( 0.04 );
+ material.specularColorBlended = mix( material.specularColor, diffuseColor.rgb, metalnessFactor );
+ material.specularF90 = 1.0;
+#endif
+#ifdef USE_CLEARCOAT
+ material.clearcoat = clearcoat;
+ material.clearcoatRoughness = clearcoatRoughness;
+ material.clearcoatF0 = vec3( 0.04 );
+ material.clearcoatF90 = 1.0;
+ #ifdef USE_CLEARCOATMAP
+ material.clearcoat *= texture2D( clearcoatMap, vClearcoatMapUv ).x;
+ #endif
+ #ifdef USE_CLEARCOAT_ROUGHNESSMAP
+ material.clearcoatRoughness *= texture2D( clearcoatRoughnessMap, vClearcoatRoughnessMapUv ).y;
+ #endif
+ material.clearcoat = saturate( material.clearcoat ); material.clearcoatRoughness = max( material.clearcoatRoughness, 0.0525 );
+ material.clearcoatRoughness += geometryRoughness;
+ material.clearcoatRoughness = min( material.clearcoatRoughness, 1.0 );
+#endif
+#ifdef USE_DISPERSION
+ material.dispersion = dispersion;
+#endif
+#ifdef USE_RETROREFLECTION
+ material.retroreflectivity = retroreflectivity;
+#endif
+#ifdef USE_IRIDESCENCE
+ material.iridescence = iridescence;
+ material.iridescenceIOR = iridescenceIOR;
+ #ifdef USE_IRIDESCENCEMAP
+ material.iridescence *= texture2D( iridescenceMap, vIridescenceMapUv ).r;
+ #endif
+ #ifdef USE_IRIDESCENCE_THICKNESSMAP
+ material.iridescenceThickness = (iridescenceThicknessMaximum - iridescenceThicknessMinimum) * texture2D( iridescenceThicknessMap, vIridescenceThicknessMapUv ).g + iridescenceThicknessMinimum;
+ #else
+ material.iridescenceThickness = iridescenceThicknessMaximum;
+ #endif
+#endif
+#ifdef USE_SHEEN
+ material.sheenColor = sheenColor;
+ #ifdef USE_SHEEN_COLORMAP
+ material.sheenColor *= texture2D( sheenColorMap, vSheenColorMapUv ).rgb;
+ #endif
+ material.sheenRoughness = clamp( sheenRoughness, 0.0001, 1.0 );
+ #ifdef USE_SHEEN_ROUGHNESSMAP
+ material.sheenRoughness *= texture2D( sheenRoughnessMap, vSheenRoughnessMapUv ).a;
+ #endif
+#endif
+#ifdef USE_ANISOTROPY
+ #ifdef USE_ANISOTROPYMAP
+ mat2 anisotropyMat = mat2( anisotropyVector.x, anisotropyVector.y, - anisotropyVector.y, anisotropyVector.x );
+ vec3 anisotropyPolar = texture2D( anisotropyMap, vAnisotropyMapUv ).rgb;
+ vec2 anisotropyV = anisotropyMat * normalize( 2.0 * anisotropyPolar.rg - vec2( 1.0 ) ) * anisotropyPolar.b;
+ #else
+ vec2 anisotropyV = anisotropyVector;
+ #endif
+ material.anisotropy = length( anisotropyV );
+ if( material.anisotropy == 0.0 ) {
+ anisotropyV = vec2( 1.0, 0.0 );
+ } else {
+ anisotropyV /= material.anisotropy;
+ material.anisotropy = saturate( material.anisotropy );
+ }
+ material.alphaT = mix( pow2( material.roughness ), 1.0, pow2( material.anisotropy ) );
+ material.anisotropyT = tbn[ 0 ] * anisotropyV.x + tbn[ 1 ] * anisotropyV.y;
+ material.anisotropyB = tbn[ 1 ] * anisotropyV.x - tbn[ 0 ] * anisotropyV.y;
+#endif`,lights_physical_pars_fragment:`uniform sampler2D dfgLUT;
+struct PhysicalMaterial {
+ vec3 diffuseColor;
+ vec3 diffuseContribution;
+ vec3 specularColor;
+ vec3 specularColorBlended;
+ float roughness;
+ float metalness;
+ float specularF90;
+ float dispersion;
+ vec2 dfg;
+ vec3 multiScatteringCompensation;
+ #ifdef USE_RETROREFLECTION
+ float retroreflectivity;
+ #endif
+ #ifdef USE_CLEARCOAT
+ float clearcoat;
+ float clearcoatRoughness;
+ vec3 clearcoatF0;
+ float clearcoatF90;
+ #endif
+ #ifdef USE_IRIDESCENCE
+ float iridescence;
+ float iridescenceIOR;
+ float iridescenceThickness;
+ vec3 iridescenceFresnel;
+ vec3 iridescenceF0Dielectric;
+ vec3 iridescenceF0Metallic;
+ #endif
+ #ifdef USE_SHEEN
+ vec3 sheenColor;
+ float sheenRoughness;
+ #endif
+ #ifdef IOR
+ float ior;
+ #endif
+ #ifdef USE_TRANSMISSION
+ float transmission;
+ float transmissionAlpha;
+ float thickness;
+ float attenuationDistance;
+ vec3 attenuationColor;
+ #endif
+ #ifdef USE_ANISOTROPY
+ float anisotropy;
+ float alphaT;
+ vec3 anisotropyT;
+ vec3 anisotropyB;
+ #endif
+};
+vec3 clearcoatSpecularDirect = vec3( 0.0 );
+vec3 clearcoatSpecularIndirect = vec3( 0.0 );
+vec3 sheenSpecularDirect = vec3( 0.0 );
+vec3 sheenSpecularIndirect = vec3(0.0 );
+vec3 Schlick_to_F0( const in vec3 f, const in float f90, const in float dotVH ) {
+ float x = clamp( 1.0 - dotVH, 0.0, 1.0 );
+ float x2 = x * x;
+ float x5 = clamp( x * x2 * x2, 0.0, 0.9999 );
+ return ( f - vec3( f90 ) * x5 ) / ( 1.0 - x5 );
+}
+float V_GGX_SmithCorrelated( const in float alpha, const in float dotNL, const in float dotNV ) {
+ float a2 = pow2( alpha );
+ float gv = dotNL * sqrt( a2 + ( 1.0 - a2 ) * pow2( dotNV ) );
+ float gl = dotNV * sqrt( a2 + ( 1.0 - a2 ) * pow2( dotNL ) );
+ return 0.5 / max( gv + gl, EPSILON );
+}
+float D_GGX( const in float alpha, const in float dotNH ) {
+ float a2 = pow2( alpha );
+ float denom = pow2( dotNH ) * ( a2 - 1.0 ) + 1.0;
+ return RECIPROCAL_PI * a2 / pow2( denom );
+}
+#ifdef USE_ANISOTROPY
+ float V_GGX_SmithCorrelated_Anisotropic( const in float alphaT, const in float alphaB, const in float dotTV, const in float dotBV, const in float dotTL, const in float dotBL, const in float dotNV, const in float dotNL ) {
+ float gv = dotNL * length( vec3( alphaT * dotTV, alphaB * dotBV, dotNV ) );
+ float gl = dotNV * length( vec3( alphaT * dotTL, alphaB * dotBL, dotNL ) );
+ return 0.5 / max( gv + gl, EPSILON );
+ }
+ float D_GGX_Anisotropic( const in float alphaT, const in float alphaB, const in float dotNH, const in float dotTH, const in float dotBH ) {
+ float a2 = alphaT * alphaB;
+ highp vec3 v = vec3( alphaB * dotTH, alphaT * dotBH, a2 * dotNH );
+ highp float v2 = dot( v, v );
+ float w2 = a2 / v2;
+ return RECIPROCAL_PI * a2 * pow2 ( w2 );
+ }
+#endif
+#ifdef USE_CLEARCOAT
+ vec3 BRDF_GGX_Clearcoat( const in vec3 lightDir, const in vec3 viewDir, const in vec3 normal, const in PhysicalMaterial material) {
+ vec3 f0 = material.clearcoatF0;
+ float f90 = material.clearcoatF90;
+ float roughness = material.clearcoatRoughness;
+ float alpha = pow2( roughness );
+ vec3 halfDir = normalize( lightDir + viewDir );
+ float dotNL = saturate( dot( normal, lightDir ) );
+ float dotNV = saturate( dot( normal, viewDir ) );
+ float dotNH = saturate( dot( normal, halfDir ) );
+ float dotVH = saturate( dot( viewDir, halfDir ) );
+ vec3 F = F_Schlick( f0, f90, dotVH );
+ float V = V_GGX_SmithCorrelated( alpha, dotNL, dotNV );
+ float D = D_GGX( alpha, dotNH );
+ return F * ( V * D );
+ }
+#endif
+vec3 BRDF_GGX( const in vec3 lightDir, const in vec3 viewDir, const in vec3 normal, const in PhysicalMaterial material ) {
+ vec3 f0 = material.specularColorBlended;
+ float f90 = material.specularF90;
+ float roughness = material.roughness;
+ float alpha = pow2( roughness );
+ vec3 halfDir = normalize( lightDir + viewDir );
+ float dotNL = saturate( dot( normal, lightDir ) );
+ float dotNV = saturate( dot( normal, viewDir ) );
+ float dotNH = saturate( dot( normal, halfDir ) );
+ float dotVH = saturate( dot( viewDir, halfDir ) );
+ vec3 F = F_Schlick( f0, f90, dotVH );
+ #ifdef USE_IRIDESCENCE
+ F = mix( F, material.iridescenceFresnel, material.iridescence );
+ #endif
+ #ifdef USE_ANISOTROPY
+ float dotTL = dot( material.anisotropyT, lightDir );
+ float dotTV = dot( material.anisotropyT, viewDir );
+ float dotTH = dot( material.anisotropyT, halfDir );
+ float dotBL = dot( material.anisotropyB, lightDir );
+ float dotBV = dot( material.anisotropyB, viewDir );
+ float dotBH = dot( material.anisotropyB, halfDir );
+ float V = V_GGX_SmithCorrelated_Anisotropic( material.alphaT, alpha, dotTV, dotBV, dotTL, dotBL, dotNV, dotNL );
+ float D = D_GGX_Anisotropic( material.alphaT, alpha, dotNH, dotTH, dotBH );
+ #else
+ float V = V_GGX_SmithCorrelated( alpha, dotNL, dotNV );
+ float D = D_GGX( alpha, dotNH );
+ #endif
+ return F * ( V * D );
+}
+vec2 LTC_Uv( const in vec3 N, const in vec3 V, const in float roughness ) {
+ const float LUT_SIZE = 64.0;
+ const float LUT_SCALE = ( LUT_SIZE - 1.0 ) / LUT_SIZE;
+ const float LUT_BIAS = 0.5 / LUT_SIZE;
+ float dotNV = saturate( dot( N, V ) );
+ vec2 uv = vec2( roughness, sqrt( 1.0 - dotNV ) );
+ uv = uv * LUT_SCALE + LUT_BIAS;
+ return uv;
+}
+float LTC_ClippedSphereFormFactor( const in vec3 f ) {
+ float l = length( f );
+ return max( ( l * l + f.z ) / ( l + 1.0 ), 0.0 );
+}
+vec3 LTC_EdgeVectorFormFactor( const in vec3 v1, const in vec3 v2 ) {
+ float x = dot( v1, v2 );
+ float y = abs( x );
+ float a = 0.8543985 + ( 0.4965155 + 0.0145206 * y ) * y;
+ float b = 3.4175940 + ( 4.1616724 + y ) * y;
+ float v = a / b;
+ float theta_sintheta = ( x > 0.0 ) ? v : 0.5 * inversesqrt( max( 1.0 - x * x, 1e-7 ) ) - v;
+ return cross( v1, v2 ) * theta_sintheta;
+}
+vec3 LTC_Evaluate( const in vec3 N, const in vec3 V, const in vec3 P, const in mat3 mInv, const in vec3 rectCoords[ 4 ] ) {
+ vec3 v1 = rectCoords[ 1 ] - rectCoords[ 0 ];
+ vec3 v2 = rectCoords[ 3 ] - rectCoords[ 0 ];
+ vec3 lightNormal = cross( v1, v2 );
+ if( dot( lightNormal, P - rectCoords[ 0 ] ) < 0.0 ) return vec3( 0.0 );
+ vec3 T1, T2;
+ T1 = normalize( V - N * dot( V, N ) );
+ T2 = - cross( N, T1 );
+ mat3 mat = mInv * transpose( mat3( T1, T2, N ) );
+ vec3 coords[ 4 ];
+ coords[ 0 ] = mat * ( rectCoords[ 0 ] - P );
+ coords[ 1 ] = mat * ( rectCoords[ 1 ] - P );
+ coords[ 2 ] = mat * ( rectCoords[ 2 ] - P );
+ coords[ 3 ] = mat * ( rectCoords[ 3 ] - P );
+ coords[ 0 ] = normalize( coords[ 0 ] );
+ coords[ 1 ] = normalize( coords[ 1 ] );
+ coords[ 2 ] = normalize( coords[ 2 ] );
+ coords[ 3 ] = normalize( coords[ 3 ] );
+ vec3 vectorFormFactor = vec3( 0.0 );
+ vectorFormFactor += LTC_EdgeVectorFormFactor( coords[ 0 ], coords[ 1 ] );
+ vectorFormFactor += LTC_EdgeVectorFormFactor( coords[ 1 ], coords[ 2 ] );
+ vectorFormFactor += LTC_EdgeVectorFormFactor( coords[ 2 ], coords[ 3 ] );
+ vectorFormFactor += LTC_EdgeVectorFormFactor( coords[ 3 ], coords[ 0 ] );
+ float result = LTC_ClippedSphereFormFactor( vectorFormFactor );
+ return vec3( result );
+}
+#if defined( USE_SHEEN )
+float D_Charlie( float roughness, float dotNH ) {
+ float alpha = pow2( roughness );
+ float invAlpha = 1.0 / alpha;
+ float cos2h = dotNH * dotNH;
+ float sin2h = max( 1.0 - cos2h, 0.0078125 );
+ return ( 2.0 + invAlpha ) * pow( sin2h, invAlpha * 0.5 ) / ( 2.0 * PI );
+}
+float V_Neubelt( float dotNV, float dotNL ) {
+ return saturate( 1.0 / ( 4.0 * ( dotNL + dotNV - dotNL * dotNV ) ) );
+}
+vec3 BRDF_Sheen( const in vec3 lightDir, const in vec3 viewDir, const in vec3 normal, vec3 sheenColor, const in float sheenRoughness ) {
+ vec3 halfDir = normalize( lightDir + viewDir );
+ float dotNL = saturate( dot( normal, lightDir ) );
+ float dotNV = saturate( dot( normal, viewDir ) );
+ float dotNH = saturate( dot( normal, halfDir ) );
+ float D = D_Charlie( sheenRoughness, dotNH );
+ float V = V_Neubelt( dotNV, dotNL );
+ return sheenColor * ( D * V );
+}
+#endif
+float IBLSheenBRDF( const in vec3 normal, const in vec3 viewDir, const in float roughness ) {
+ float dotNV = saturate( dot( normal, viewDir ) );
+ float r2 = roughness * roughness;
+ float rInv = 1.0 / ( roughness + 0.1 );
+ float a = -1.9362 + 1.0678 * roughness + 0.4573 * r2 - 0.8469 * rInv;
+ float b = -0.6014 + 0.5538 * roughness - 0.4670 * r2 - 0.1255 * rInv;
+ float DG = exp( a * dotNV + b );
+ return saturate( DG );
+}
+vec3 EnvironmentBRDF( const in vec3 normal, const in vec3 viewDir, const in vec3 specularColor, const in float specularF90, const in float roughness ) {
+ float dotNV = saturate( dot( normal, viewDir ) );
+ vec2 fab = texture2D( dfgLUT, vec2( roughness, dotNV ) ).rg;
+ return specularColor * fab.x + specularF90 * fab.y;
+}
+#ifdef USE_IRIDESCENCE
+void computeMultiscatteringIridescence( const in vec2 fab, const in vec3 specularColor, const in float specularF90, const in float iridescence, const in vec3 iridescenceF0, inout vec3 singleScatter, inout vec3 multiScatter ) {
+#else
+void computeMultiscattering( const in vec2 fab, const in vec3 specularColor, const in float specularF90, inout vec3 singleScatter, inout vec3 multiScatter ) {
+#endif
+ #ifdef USE_IRIDESCENCE
+ vec3 Fr = mix( specularColor, iridescenceF0, iridescence );
+ #else
+ vec3 Fr = specularColor;
+ #endif
+ vec3 FssEss = Fr * fab.x + specularF90 * fab.y;
+ float Ess = fab.x + fab.y;
+ float Ems = 1.0 - Ess;
+ vec3 Favg = Fr + ( 1.0 - Fr ) * 0.047619; vec3 Fms = FssEss * Favg / ( 1.0 - Ems * Favg );
+ singleScatter += FssEss;
+ multiScatter += Fms * Ems;
+}
+#if NUM_RECT_AREA_LIGHTS > 0
+ void RE_Direct_RectArea_Physical( const in RectAreaLight rectAreaLight, const in vec3 geometryPosition, const in vec3 geometryNormal, const in vec3 geometryViewDir, const in vec3 geometryClearcoatNormal, const in PhysicalMaterial material, inout ReflectedLight reflectedLight ) {
+ vec3 normal = geometryNormal;
+ vec3 viewDir = geometryViewDir;
+ vec3 position = geometryPosition;
+ vec3 lightPos = rectAreaLight.position;
+ vec3 halfWidth = rectAreaLight.halfWidth;
+ vec3 halfHeight = rectAreaLight.halfHeight;
+ vec3 lightColor = rectAreaLight.color;
+ float roughness = material.roughness;
+ vec3 rectCoords[ 4 ];
+ rectCoords[ 0 ] = lightPos + halfWidth - halfHeight; rectCoords[ 1 ] = lightPos - halfWidth - halfHeight;
+ rectCoords[ 2 ] = lightPos - halfWidth + halfHeight;
+ rectCoords[ 3 ] = lightPos + halfWidth + halfHeight;
+ vec2 uv = LTC_Uv( normal, viewDir, roughness );
+ vec4 t1 = texture2D( ltc_1, uv );
+ vec4 t2 = texture2D( ltc_2, uv );
+ mat3 mInv = mat3(
+ vec3( t1.x, 0, t1.y ),
+ vec3( 0, 1, 0 ),
+ vec3( t1.z, 0, t1.w )
+ );
+ vec3 fresnel = ( material.specularColorBlended * t2.x + ( material.specularF90 - material.specularColorBlended ) * t2.y );
+ reflectedLight.directSpecular += lightColor * fresnel * LTC_Evaluate( normal, viewDir, position, mInv, rectCoords );
+ reflectedLight.directDiffuse += lightColor * material.diffuseContribution * LTC_Evaluate( normal, viewDir, position, mat3( 1.0 ), rectCoords );
+ #ifdef USE_CLEARCOAT
+ vec3 Ncc = geometryClearcoatNormal;
+ vec2 uvClearcoat = LTC_Uv( Ncc, viewDir, material.clearcoatRoughness );
+ vec4 t1Clearcoat = texture2D( ltc_1, uvClearcoat );
+ vec4 t2Clearcoat = texture2D( ltc_2, uvClearcoat );
+ mat3 mInvClearcoat = mat3(
+ vec3( t1Clearcoat.x, 0, t1Clearcoat.y ),
+ vec3( 0, 1, 0 ),
+ vec3( t1Clearcoat.z, 0, t1Clearcoat.w )
+ );
+ vec3 fresnelClearcoat = material.clearcoatF0 * t2Clearcoat.x + ( material.clearcoatF90 - material.clearcoatF0 ) * t2Clearcoat.y;
+ clearcoatSpecularDirect += lightColor * fresnelClearcoat * LTC_Evaluate( Ncc, viewDir, position, mInvClearcoat, rectCoords );
+ #endif
+ }
+#endif
+void RE_Direct_Physical( const in IncidentLight directLight, const in vec3 geometryPosition, const in vec3 geometryNormal, const in vec3 geometryViewDir, const in vec3 geometryClearcoatNormal, const in PhysicalMaterial material, inout ReflectedLight reflectedLight ) {
+ float dotNL = saturate( dot( geometryNormal, directLight.direction ) );
+ vec3 irradiance = dotNL * directLight.color;
+ #ifdef USE_CLEARCOAT
+ float dotNLcc = saturate( dot( geometryClearcoatNormal, directLight.direction ) );
+ vec3 ccIrradiance = dotNLcc * directLight.color;
+ clearcoatSpecularDirect += ccIrradiance * BRDF_GGX_Clearcoat( directLight.direction, geometryViewDir, geometryClearcoatNormal, material );
+ #endif
+ #ifdef USE_SHEEN
+
+ sheenSpecularDirect += irradiance * BRDF_Sheen( directLight.direction, geometryViewDir, geometryNormal, material.sheenColor, material.sheenRoughness );
+
+ float sheenAlbedoV = IBLSheenBRDF( geometryNormal, geometryViewDir, material.sheenRoughness );
+ float sheenAlbedoL = IBLSheenBRDF( geometryNormal, directLight.direction, material.sheenRoughness );
+
+ float sheenEnergyComp = 1.0 - max3( material.sheenColor ) * max( sheenAlbedoV, sheenAlbedoL );
+
+ irradiance *= sheenEnergyComp;
+
+ #endif
+ vec3 specularBRDF = BRDF_GGX( directLight.direction, geometryViewDir, geometryNormal, material );
+ #ifdef USE_RETROREFLECTION
+ vec3 retroViewDir = reflect( - geometryViewDir, geometryNormal );
+ vec3 retroSpecularBRDF = BRDF_GGX( directLight.direction, retroViewDir, geometryNormal, material );
+ specularBRDF = mix( specularBRDF, retroSpecularBRDF, saturate( material.retroreflectivity ) );
+ #endif
+ reflectedLight.directSpecular += irradiance * specularBRDF * material.multiScatteringCompensation;
+ vec3 halfDir = normalize( directLight.direction + geometryViewDir );
+ float dotVH = saturate( dot( geometryViewDir, halfDir ) );
+ vec3 F = F_Schlick( material.specularColor, material.specularF90, dotVH );
+ #ifdef USE_RETROREFLECTION
+ vec3 retroHalfDir = normalize( directLight.direction + retroViewDir );
+ float dotRetroVH = saturate( dot( retroViewDir, retroHalfDir ) );
+ vec3 retroF = F_Schlick( material.specularColor, material.specularF90, dotRetroVH );
+ F = mix( F, retroF, saturate( material.retroreflectivity ) );
+ #endif
+ reflectedLight.directDiffuse += irradiance * BRDF_Lambert( material.diffuseContribution ) * ( 1.0 - F );
+}
+void RE_IndirectDiffuse_Physical( const in vec3 irradiance, const in vec3 geometryPosition, const in vec3 geometryNormal, const in vec3 geometryViewDir, const in vec3 geometryClearcoatNormal, const in PhysicalMaterial material, inout ReflectedLight reflectedLight ) {
+ vec3 singleScattering = vec3( 0.0 );
+ vec3 multiScattering = vec3( 0.0 );
+ #ifdef USE_IRIDESCENCE
+ computeMultiscatteringIridescence( material.dfg, material.specularColor, material.specularF90, material.iridescence, material.iridescenceF0Dielectric, singleScattering, multiScattering );
+ #else
+ computeMultiscattering( material.dfg, material.specularColor, material.specularF90, singleScattering, multiScattering );
+ #endif
+ vec3 diffuse = irradiance * BRDF_Lambert( material.diffuseContribution ) * ( 1.0 - singleScattering - multiScattering );
+ #ifdef USE_SHEEN
+ float sheenAlbedo = IBLSheenBRDF( geometryNormal, geometryViewDir, material.sheenRoughness );
+ sheenSpecularIndirect += irradiance * material.sheenColor * sheenAlbedo * RECIPROCAL_PI;
+ float sheenEnergyComp = 1.0 - max3( material.sheenColor ) * sheenAlbedo;
+ diffuse *= sheenEnergyComp;
+ #endif
+ reflectedLight.indirectDiffuse += diffuse;
+}
+void RE_IndirectSpecular_Physical( const in vec3 radiance, const in vec3 irradiance, const in vec3 clearcoatRadiance, const in vec3 geometryPosition, const in vec3 geometryNormal, const in vec3 geometryViewDir, const in vec3 geometryClearcoatNormal, const in PhysicalMaterial material, inout ReflectedLight reflectedLight) {
+ #ifdef USE_CLEARCOAT
+ clearcoatSpecularIndirect += clearcoatRadiance * EnvironmentBRDF( geometryClearcoatNormal, geometryViewDir, material.clearcoatF0, material.clearcoatF90, material.clearcoatRoughness );
+ #endif
+ #ifdef USE_SHEEN
+ sheenSpecularIndirect += irradiance * material.sheenColor * IBLSheenBRDF( geometryNormal, geometryViewDir, material.sheenRoughness ) * RECIPROCAL_PI;
+ #endif
+ vec3 singleScatteringDielectric = vec3( 0.0 );
+ vec3 multiScatteringDielectric = vec3( 0.0 );
+ vec3 singleScatteringMetallic = vec3( 0.0 );
+ vec3 multiScatteringMetallic = vec3( 0.0 );
+ #ifdef USE_IRIDESCENCE
+ computeMultiscatteringIridescence( material.dfg, material.specularColor, material.specularF90, material.iridescence, material.iridescenceF0Dielectric, singleScatteringDielectric, multiScatteringDielectric );
+ computeMultiscatteringIridescence( material.dfg, material.diffuseColor, material.specularF90, material.iridescence, material.iridescenceF0Metallic, singleScatteringMetallic, multiScatteringMetallic );
+ #else
+ computeMultiscattering( material.dfg, material.specularColor, material.specularF90, singleScatteringDielectric, multiScatteringDielectric );
+ computeMultiscattering( material.dfg, material.diffuseColor, material.specularF90, singleScatteringMetallic, multiScatteringMetallic );
+ #endif
+ vec3 singleScattering = mix( singleScatteringDielectric, singleScatteringMetallic, material.metalness );
+ vec3 multiScattering = mix( multiScatteringDielectric, multiScatteringMetallic, material.metalness );
+ vec3 totalScatteringDielectric = singleScatteringDielectric + multiScatteringDielectric;
+ vec3 diffuse = material.diffuseContribution * ( 1.0 - totalScatteringDielectric );
+ vec3 cosineWeightedIrradiance = irradiance * RECIPROCAL_PI;
+ vec3 indirectSpecular = radiance * singleScattering;
+ indirectSpecular += multiScattering * cosineWeightedIrradiance;
+ vec3 indirectDiffuse = diffuse * cosineWeightedIrradiance;
+ #ifdef USE_SHEEN
+ float sheenAlbedo = IBLSheenBRDF( geometryNormal, geometryViewDir, material.sheenRoughness );
+ float sheenEnergyComp = 1.0 - max3( material.sheenColor ) * sheenAlbedo;
+ indirectSpecular *= sheenEnergyComp;
+ indirectDiffuse *= sheenEnergyComp;
+ #endif
+ reflectedLight.indirectSpecular += indirectSpecular;
+ reflectedLight.indirectDiffuse += indirectDiffuse;
+}
+#define RE_Direct RE_Direct_Physical
+#define RE_Direct_RectArea RE_Direct_RectArea_Physical
+#define RE_IndirectDiffuse RE_IndirectDiffuse_Physical
+#define RE_IndirectSpecular RE_IndirectSpecular_Physical
+float computeSpecularOcclusion( const in float dotNV, const in float ambientOcclusion, const in float roughness ) {
+ return saturate( pow( dotNV + ambientOcclusion, exp2( - 16.0 * roughness - 1.0 ) ) - 1.0 + ambientOcclusion );
+}`,lights_fragment_begin:`
+vec3 geometryPosition = - vViewPosition;
+vec3 geometryNormal = normal;
+vec3 geometryViewDir = ( isOrthographic ) ? vec3( 0, 0, 1 ) : normalize( vViewPosition );
+vec3 geometryClearcoatNormal = vec3( 0.0 );
+#ifdef USE_CLEARCOAT
+ geometryClearcoatNormal = clearcoatNormal;
+#endif
+#ifdef USE_IRIDESCENCE
+ float dotNVi = saturate( dot( normal, geometryViewDir ) );
+ if ( material.iridescenceThickness == 0.0 ) {
+ material.iridescence = 0.0;
+ } else {
+ material.iridescence = saturate( material.iridescence );
+ }
+ if ( material.iridescence > 0.0 ) {
+ vec3 iridescenceFresnelDielectric = evalIridescence( 1.0, material.iridescenceIOR, dotNVi, material.iridescenceThickness, material.specularColor );
+ vec3 iridescenceFresnelMetallic = evalIridescence( 1.0, material.iridescenceIOR, dotNVi, material.iridescenceThickness, material.diffuseColor );
+ material.iridescenceFresnel = mix( iridescenceFresnelDielectric, iridescenceFresnelMetallic, material.metalness );
+ material.iridescenceF0Dielectric = Schlick_to_F0( iridescenceFresnelDielectric, 1.0, dotNVi );
+ material.iridescenceF0Metallic = Schlick_to_F0( iridescenceFresnelMetallic, 1.0, dotNVi );
+ }
+#endif
+#ifdef STANDARD
+ float dotNVms = saturate( dot( geometryNormal, geometryViewDir ) );
+ material.dfg = texture2D( dfgLUT, vec2( material.roughness, dotNVms ) ).rg;
+ #if ( NUM_SUN_LIGHTS > 0 || NUM_DIR_LIGHTS > 0 || NUM_POINT_LIGHTS > 0 || NUM_SPOT_LIGHTS > 0 )
+ float EssMs = material.dfg.x + material.dfg.y;
+ material.multiScatteringCompensation = 1.0 + material.specularColorBlended * ( 1.0 / EssMs - 1.0 );
+ #endif
+#endif
+IncidentLight directLight;
+#if ( NUM_POINT_LIGHTS > 0 ) && defined( RE_Direct )
+ PointLight pointLight;
+ #if defined( USE_SHADOWMAP ) && NUM_POINT_LIGHT_SHADOWS > 0
+ PointLightShadow pointLightShadow;
+ #endif
+ #pragma unroll_loop_start
+ for ( int i = 0; i < NUM_POINT_LIGHTS; i ++ ) {
+ pointLight = pointLights[ i ];
+ getPointLightInfo( pointLight, geometryPosition, directLight );
+ #if defined( USE_SHADOWMAP ) && ( UNROLLED_LOOP_INDEX < NUM_POINT_LIGHT_SHADOWS ) && ( defined( SHADOWMAP_TYPE_PCF ) || defined( SHADOWMAP_TYPE_BASIC ) )
+ pointLightShadow = pointLightShadows[ i ];
+ directLight.color *= ( directLight.visible && receiveShadow ) ? getPointShadow( pointShadowMap[ i ], pointLightShadow.shadowMapSize, pointLightShadow.shadowIntensity, pointLightShadow.shadowBias, pointLightShadow.shadowRadius, vPointShadowCoord[ i ], pointLightShadow.shadowCameraNear, pointLightShadow.shadowCameraFar ) : 1.0;
+ #endif
+ RE_Direct( directLight, geometryPosition, geometryNormal, geometryViewDir, geometryClearcoatNormal, material, reflectedLight );
+ }
+ #pragma unroll_loop_end
+#endif
+#if ( NUM_SPOT_LIGHTS > 0 ) && defined( RE_Direct )
+ SpotLight spotLight;
+ vec4 spotColor;
+ vec3 spotLightCoord;
+ bool inSpotLightMap;
+ #if defined( USE_SHADOWMAP ) && NUM_SPOT_LIGHT_SHADOWS > 0
+ SpotLightShadow spotLightShadow;
+ #endif
+ #pragma unroll_loop_start
+ for ( int i = 0; i < NUM_SPOT_LIGHTS; i ++ ) {
+ spotLight = spotLights[ i ];
+ getSpotLightInfo( spotLight, geometryPosition, directLight );
+ #if ( UNROLLED_LOOP_INDEX < NUM_SPOT_LIGHT_SHADOWS_WITH_MAPS )
+ #define SPOT_LIGHT_MAP_INDEX UNROLLED_LOOP_INDEX
+ #elif ( UNROLLED_LOOP_INDEX < NUM_SPOT_LIGHT_SHADOWS )
+ #define SPOT_LIGHT_MAP_INDEX NUM_SPOT_LIGHT_MAPS
+ #else
+ #define SPOT_LIGHT_MAP_INDEX ( UNROLLED_LOOP_INDEX - NUM_SPOT_LIGHT_SHADOWS + NUM_SPOT_LIGHT_SHADOWS_WITH_MAPS )
+ #endif
+ #if ( SPOT_LIGHT_MAP_INDEX < NUM_SPOT_LIGHT_MAPS )
+ spotLightCoord = vSpotLightCoord[ i ].xyz / vSpotLightCoord[ i ].w;
+ inSpotLightMap = all( lessThan( abs( spotLightCoord * 2. - 1. ), vec3( 1.0 ) ) );
+ spotColor = texture2D( spotLightMap[ SPOT_LIGHT_MAP_INDEX ], spotLightCoord.xy );
+ directLight.color = inSpotLightMap ? directLight.color * spotColor.rgb : directLight.color;
+ #endif
+ #undef SPOT_LIGHT_MAP_INDEX
+ #if defined( USE_SHADOWMAP ) && ( UNROLLED_LOOP_INDEX < NUM_SPOT_LIGHT_SHADOWS )
+ spotLightShadow = spotLightShadows[ i ];
+ directLight.color *= ( directLight.visible && receiveShadow ) ? getShadow( spotShadowMap[ i ], spotLightShadow.shadowMapSize, spotLightShadow.shadowIntensity, spotLightShadow.shadowBias, spotLightShadow.shadowRadius, vSpotLightCoord[ i ] ) : 1.0;
+ #endif
+ RE_Direct( directLight, geometryPosition, geometryNormal, geometryViewDir, geometryClearcoatNormal, material, reflectedLight );
+ }
+ #pragma unroll_loop_end
+#endif
+#if ( NUM_SUN_LIGHTS > 0 ) && defined( RE_Direct )
+ SunLight sunLight;
+ #if defined( USE_SHADOWMAP ) && NUM_SUN_LIGHT_SHADOWS > 0
+ SunLightShadow sunLightShadow;
+ #endif
+ #pragma unroll_loop_start
+ for ( int i = 0; i < NUM_SUN_LIGHTS; i ++ ) {
+ sunLight = sunLights[ i ];
+ getSunLightInfo( sunLight, directLight );
+ #if defined( USE_SHADOWMAP ) && ( UNROLLED_LOOP_INDEX < NUM_SUN_LIGHT_SHADOWS )
+ sunLightShadow = sunLightShadows[ i ];
+ directLight.color *= ( directLight.visible && receiveShadow ) ? getSunShadow( sunShadowMap[ i ], sunLightShadow, UNROLLED_LOOP_INDEX ) : 1.0;
+ #endif
+ RE_Direct( directLight, geometryPosition, geometryNormal, geometryViewDir, geometryClearcoatNormal, material, reflectedLight );
+ }
+ #pragma unroll_loop_end
+#endif
+#if ( NUM_DIR_LIGHTS > 0 ) && defined( RE_Direct )
+ DirectionalLight directionalLight;
+ #if defined( USE_SHADOWMAP ) && NUM_DIR_LIGHT_SHADOWS > 0
+ DirectionalLightShadow directionalLightShadow;
+ #endif
+ #pragma unroll_loop_start
+ for ( int i = 0; i < NUM_DIR_LIGHTS; i ++ ) {
+ directionalLight = directionalLights[ i ];
+ getDirectionalLightInfo( directionalLight, directLight );
+ #if defined( USE_SHADOWMAP ) && ( UNROLLED_LOOP_INDEX < NUM_DIR_LIGHT_SHADOWS )
+ directionalLightShadow = directionalLightShadows[ i ];
+ directLight.color *= ( directLight.visible && receiveShadow ) ? getShadow( directionalShadowMap[ i ], directionalLightShadow.shadowMapSize, directionalLightShadow.shadowIntensity, directionalLightShadow.shadowBias, directionalLightShadow.shadowRadius, vDirectionalShadowCoord[ i ] ) : 1.0;
+ #endif
+ RE_Direct( directLight, geometryPosition, geometryNormal, geometryViewDir, geometryClearcoatNormal, material, reflectedLight );
+ }
+ #pragma unroll_loop_end
+#endif
+#if ( NUM_RECT_AREA_LIGHTS > 0 ) && defined( RE_Direct_RectArea )
+ RectAreaLight rectAreaLight;
+ #pragma unroll_loop_start
+ for ( int i = 0; i < NUM_RECT_AREA_LIGHTS; i ++ ) {
+ rectAreaLight = rectAreaLights[ i ];
+ RE_Direct_RectArea( rectAreaLight, geometryPosition, geometryNormal, geometryViewDir, geometryClearcoatNormal, material, reflectedLight );
+ }
+ #pragma unroll_loop_end
+#endif
+#if defined( RE_IndirectDiffuse )
+ vec3 iblIrradiance = vec3( 0.0 );
+ vec3 irradiance = getAmbientLightIrradiance( ambientLightColor );
+ #if defined( USE_LIGHT_PROBES )
+ irradiance += getLightProbeIrradiance( lightProbe, geometryNormal );
+ #endif
+ #if ( NUM_HEMI_LIGHTS > 0 )
+ #pragma unroll_loop_start
+ for ( int i = 0; i < NUM_HEMI_LIGHTS; i ++ ) {
+ irradiance += getHemisphereLightIrradiance( hemisphereLights[ i ], geometryNormal );
+ }
+ #pragma unroll_loop_end
+ #endif
+ #ifdef USE_LIGHT_PROBES_GRID
+ vec3 probeWorldPos = ( ( vec4( geometryPosition, 1.0 ) - viewMatrix[ 3 ] ) * viewMatrix ).xyz;
+ vec3 probeWorldNormal = transformNormalByInverseViewMatrix( geometryNormal, viewMatrix );
+ irradiance += getLightProbeGridIrradiance( probeWorldPos, probeWorldNormal );
+ #endif
+#endif
+#if defined( RE_IndirectSpecular )
+ vec3 radiance = vec3( 0.0 );
+ vec3 clearcoatRadiance = vec3( 0.0 );
+#endif`,lights_fragment_maps:`#if defined( RE_IndirectDiffuse )
+ #ifdef USE_LIGHTMAP
+ vec4 lightMapTexel = texture2D( lightMap, vLightMapUv );
+ vec3 lightMapIrradiance = lightMapTexel.rgb * lightMapIntensity;
+ irradiance += lightMapIrradiance;
+ #endif
+ #if defined( USE_ENVMAP ) && defined( ENVMAP_TYPE_CUBE_UV )
+ #if defined( STANDARD ) || defined( LAMBERT ) || defined( PHONG )
+ iblIrradiance += getIBLIrradiance( geometryNormal );
+ #endif
+ #endif
+#endif
+#if defined( USE_ENVMAP ) && defined( RE_IndirectSpecular )
+ #ifdef USE_ANISOTROPY
+ vec3 iblRadiance = getIBLAnisotropyRadiance( geometryViewDir, geometryNormal, material.roughness, material.anisotropyB, material.anisotropy );
+ #else
+ vec3 iblRadiance = getIBLRadiance( geometryViewDir, geometryNormal, material.roughness );
+ #endif
+ #ifdef USE_RETROREFLECTION
+ #ifdef USE_ANISOTROPY
+ vec3 retroIBLRadiance = getIBLAnisotropyRetroRadiance( geometryViewDir, geometryNormal, material.roughness, material.anisotropyB, material.anisotropy );
+ #else
+ vec3 retroIBLRadiance = getIBLRetroRadiance( geometryViewDir, geometryNormal, material.roughness );
+ #endif
+ iblRadiance = mix( iblRadiance, retroIBLRadiance, saturate( material.retroreflectivity ) );
+ #endif
+ radiance += iblRadiance;
+ #ifdef USE_CLEARCOAT
+ clearcoatRadiance += getIBLRadiance( geometryViewDir, geometryClearcoatNormal, material.clearcoatRoughness );
+ #endif
+#endif`,lights_fragment_end:`#if defined( RE_IndirectDiffuse )
+ #if defined( LAMBERT ) || defined( PHONG )
+ irradiance += iblIrradiance;
+ #endif
+ RE_IndirectDiffuse( irradiance, geometryPosition, geometryNormal, geometryViewDir, geometryClearcoatNormal, material, reflectedLight );
+#endif
+#if defined( RE_IndirectSpecular )
+ RE_IndirectSpecular( radiance, iblIrradiance, clearcoatRadiance, geometryPosition, geometryNormal, geometryViewDir, geometryClearcoatNormal, material, reflectedLight );
+#endif`,lightprobes_pars_fragment:`#ifdef USE_LIGHT_PROBES_GRID
+uniform highp sampler3D probesSH;
+uniform vec3 probesMin;
+uniform vec3 probesMax;
+uniform vec3 probesResolution;
+vec3 getLightProbeGridIrradiance( vec3 worldPos, vec3 worldNormal ) {
+ vec3 res = probesResolution;
+ vec3 gridRange = probesMax - probesMin;
+ vec3 resMinusOne = res - 1.0;
+ vec3 probeSpacing = gridRange / resMinusOne;
+ vec3 samplePos = worldPos + worldNormal * probeSpacing * 0.5;
+ vec3 uvw = clamp( ( samplePos - probesMin ) / gridRange, 0.0, 1.0 );
+ uvw = uvw * resMinusOne / res + 0.5 / res;
+ float nz = res.z;
+ float paddedSlices = nz + 2.0;
+ float atlasDepth = 7.0 * paddedSlices;
+ float uvZBase = uvw.z * nz + 1.0;
+ vec4 s0 = texture( probesSH, vec3( uvw.xy, ( uvZBase ) / atlasDepth ) );
+ vec4 s1 = texture( probesSH, vec3( uvw.xy, ( uvZBase + paddedSlices ) / atlasDepth ) );
+ vec4 s2 = texture( probesSH, vec3( uvw.xy, ( uvZBase + 2.0 * paddedSlices ) / atlasDepth ) );
+ vec4 s3 = texture( probesSH, vec3( uvw.xy, ( uvZBase + 3.0 * paddedSlices ) / atlasDepth ) );
+ vec4 s4 = texture( probesSH, vec3( uvw.xy, ( uvZBase + 4.0 * paddedSlices ) / atlasDepth ) );
+ vec4 s5 = texture( probesSH, vec3( uvw.xy, ( uvZBase + 5.0 * paddedSlices ) / atlasDepth ) );
+ vec4 s6 = texture( probesSH, vec3( uvw.xy, ( uvZBase + 6.0 * paddedSlices ) / atlasDepth ) );
+ vec3 c0 = s0.xyz;
+ vec3 c1 = vec3( s0.w, s1.xy );
+ vec3 c2 = vec3( s1.zw, s2.x );
+ vec3 c3 = s2.yzw;
+ vec3 c4 = s3.xyz;
+ vec3 c5 = vec3( s3.w, s4.xy );
+ vec3 c6 = vec3( s4.zw, s5.x );
+ vec3 c7 = s5.yzw;
+ vec3 c8 = s6.xyz;
+ float x = worldNormal.x, y = worldNormal.y, z = worldNormal.z;
+ vec3 result = c0 * 0.886227;
+ result += c1 * 2.0 * 0.511664 * y;
+ result += c2 * 2.0 * 0.511664 * z;
+ result += c3 * 2.0 * 0.511664 * x;
+ result += c4 * 2.0 * 0.429043 * x * y;
+ result += c5 * 2.0 * 0.429043 * y * z;
+ result += c6 * ( 0.743125 * z * z - 0.247708 );
+ result += c7 * 2.0 * 0.429043 * x * z;
+ result += c8 * 0.429043 * ( x * x - y * y );
+ return max( result, vec3( 0.0 ) );
+}
+#endif`,logdepthbuf_fragment:`#if defined( USE_LOGARITHMIC_DEPTH_BUFFER )
+ gl_FragDepth = vIsPerspective == 0.0 ? gl_FragCoord.z : log2( vFragDepth ) * logDepthBufFC * 0.5;
+#endif`,logdepthbuf_pars_fragment:`#if defined( USE_LOGARITHMIC_DEPTH_BUFFER )
+ uniform float logDepthBufFC;
+ varying float vFragDepth;
+ varying float vIsPerspective;
+#endif`,logdepthbuf_pars_vertex:`#ifdef USE_LOGARITHMIC_DEPTH_BUFFER
+ varying float vFragDepth;
+ varying float vIsPerspective;
+#endif`,logdepthbuf_vertex:`#ifdef USE_LOGARITHMIC_DEPTH_BUFFER
+ vFragDepth = 1.0 + gl_Position.w;
+ vIsPerspective = float( isPerspectiveMatrix( projectionMatrix ) );
+#endif`,map_fragment:`#ifdef USE_MAP
+ vec4 sampledDiffuseColor = texture2D( map, vMapUv );
+ #ifdef DECODE_VIDEO_TEXTURE
+ sampledDiffuseColor = sRGBTransferEOTF( sampledDiffuseColor );
+ #endif
+ diffuseColor *= sampledDiffuseColor;
+#endif`,map_pars_fragment:`#ifdef USE_MAP
+ uniform sampler2D map;
+#endif`,map_particle_fragment:`#if defined( USE_MAP ) || defined( USE_ALPHAMAP )
+ #if defined( USE_POINTS_UV )
+ vec2 uv = vUv;
+ #else
+ vec2 uv = ( uvTransform * vec3( gl_PointCoord.x, 1.0 - gl_PointCoord.y, 1 ) ).xy;
+ #endif
+#endif
+#ifdef USE_MAP
+ diffuseColor *= texture2D( map, uv );
+#endif
+#ifdef USE_ALPHAMAP
+ diffuseColor.a *= texture2D( alphaMap, uv ).g;
+#endif`,map_particle_pars_fragment:`#if defined( USE_POINTS_UV )
+ varying vec2 vUv;
+#else
+ #if defined( USE_MAP ) || defined( USE_ALPHAMAP )
+ uniform mat3 uvTransform;
+ #endif
+#endif
+#ifdef USE_MAP
+ uniform sampler2D map;
+#endif
+#ifdef USE_ALPHAMAP
+ uniform sampler2D alphaMap;
+#endif`,metalnessmap_fragment:`float metalnessFactor = metalness;
+#ifdef USE_METALNESSMAP
+ vec4 texelMetalness = texture2D( metalnessMap, vMetalnessMapUv );
+ metalnessFactor *= texelMetalness.b;
+#endif`,metalnessmap_pars_fragment:`#ifdef USE_METALNESSMAP
+ uniform sampler2D metalnessMap;
+#endif`,morphinstance_vertex:`#ifdef USE_INSTANCING_MORPH
+ float morphTargetInfluences[ MORPHTARGETS_COUNT ];
+ float morphTargetBaseInfluence = texelFetch( morphTexture, ivec2( 0, gl_InstanceID ), 0 ).r;
+ for ( int i = 0; i < MORPHTARGETS_COUNT; i ++ ) {
+ morphTargetInfluences[i] = texelFetch( morphTexture, ivec2( i + 1, gl_InstanceID ), 0 ).r;
+ }
+#endif`,morphcolor_vertex:`#if defined( USE_MORPHCOLORS )
+ vColor *= morphTargetBaseInfluence;
+ for ( int i = 0; i < MORPHTARGETS_COUNT; i ++ ) {
+ #if defined( USE_COLOR_ALPHA )
+ if ( morphTargetInfluences[ i ] != 0.0 ) vColor += getMorph( gl_VertexID, i, 2 ) * morphTargetInfluences[ i ];
+ #elif defined( USE_COLOR )
+ if ( morphTargetInfluences[ i ] != 0.0 ) vColor += getMorph( gl_VertexID, i, 2 ).rgb * morphTargetInfluences[ i ];
+ #endif
+ }
+#endif`,morphnormal_vertex:`#ifdef USE_MORPHNORMALS
+ objectNormal *= morphTargetBaseInfluence;
+ for ( int i = 0; i < MORPHTARGETS_COUNT; i ++ ) {
+ if ( morphTargetInfluences[ i ] != 0.0 ) objectNormal += getMorph( gl_VertexID, i, 1 ).xyz * morphTargetInfluences[ i ];
+ }
+#endif`,morphtarget_pars_vertex:`#ifdef USE_MORPHTARGETS
+ #ifndef USE_INSTANCING_MORPH
+ uniform float morphTargetBaseInfluence;
+ uniform float morphTargetInfluences[ MORPHTARGETS_COUNT ];
+ #endif
+ uniform sampler2DArray morphTargetsTexture;
+ uniform ivec2 morphTargetsTextureSize;
+ vec4 getMorph( const in int vertexIndex, const in int morphTargetIndex, const in int offset ) {
+ int texelIndex = vertexIndex * MORPHTARGETS_TEXTURE_STRIDE + offset;
+ int y = texelIndex / morphTargetsTextureSize.x;
+ int x = texelIndex - y * morphTargetsTextureSize.x;
+ ivec3 morphUV = ivec3( x, y, morphTargetIndex );
+ return texelFetch( morphTargetsTexture, morphUV, 0 );
+ }
+#endif`,morphtarget_vertex:`#ifdef USE_MORPHTARGETS
+ transformed *= morphTargetBaseInfluence;
+ for ( int i = 0; i < MORPHTARGETS_COUNT; i ++ ) {
+ if ( morphTargetInfluences[ i ] != 0.0 ) transformed += getMorph( gl_VertexID, i, 0 ).xyz * morphTargetInfluences[ i ];
+ }
+#endif`,normal_fragment_begin:`float faceDirection = gl_FrontFacing ? 1.0 : - 1.0;
+#ifdef FLAT_SHADED
+ vec3 fdx = dFdx( vViewPosition );
+ vec3 fdy = dFdy( vViewPosition );
+ vec3 normal = normalize( cross( fdx, fdy ) );
+#else
+ vec3 normal = normalize( vNormal );
+ #ifdef DOUBLE_SIDED
+ normal *= faceDirection;
+ #endif
+#endif
+#if defined( USE_NORMALMAP_TANGENTSPACE ) || defined( USE_CLEARCOAT_NORMALMAP ) || defined( USE_ANISOTROPY )
+ #ifdef USE_TANGENT
+ mat3 tbn = mat3( normalize( vTangent ), normalize( vBitangent ), normal );
+ #else
+ mat3 tbn = getTangentFrame( - vViewPosition, normal,
+ #if defined( USE_NORMALMAP )
+ vNormalMapUv
+ #elif defined( USE_CLEARCOAT_NORMALMAP )
+ vClearcoatNormalMapUv
+ #else
+ vUv
+ #endif
+ );
+ #endif
+ #ifdef DOUBLE_SIDED
+ tbn[0] *= faceDirection;
+ tbn[1] *= faceDirection;
+ #endif
+#endif
+#ifdef USE_CLEARCOAT_NORMALMAP
+ #ifdef USE_TANGENT
+ mat3 tbn2 = mat3( normalize( vTangent ), normalize( vBitangent ), normal );
+ #else
+ mat3 tbn2 = getTangentFrame( - vViewPosition, normal, vClearcoatNormalMapUv );
+ #endif
+ #ifdef DOUBLE_SIDED
+ tbn2[0] *= faceDirection;
+ tbn2[1] *= faceDirection;
+ #endif
+#endif
+vec3 nonPerturbedNormal = normal;`,normal_fragment_maps:`#ifdef USE_NORMALMAP_OBJECTSPACE
+ normal = texture2D( normalMap, vNormalMapUv ).xyz * 2.0 - 1.0;
+ #ifdef FLIP_SIDED
+ normal = - normal;
+ #endif
+ #ifdef DOUBLE_SIDED
+ normal = normal * faceDirection;
+ #endif
+ normal = normalize( normalMatrix * normal );
+#elif defined( USE_NORMALMAP_TANGENTSPACE )
+ vec3 mapN = texture2D( normalMap, vNormalMapUv ).xyz * 2.0 - 1.0;
+ #if defined( USE_PACKED_NORMALMAP )
+ mapN = vec3( mapN.xy, sqrt( saturate( 1.0 - dot( mapN.xy, mapN.xy ) ) ) );
+ #endif
+ mapN.xy *= normalScale;
+ normal = normalize( tbn * mapN );
+#elif defined( USE_BUMPMAP )
+ normal = perturbNormalArb( - vViewPosition, normal, dHdxy_fwd(), faceDirection );
+#endif`,normal_pars_fragment:`#ifndef FLAT_SHADED
+ varying vec3 vNormal;
+ #ifdef USE_TANGENT
+ varying vec3 vTangent;
+ varying vec3 vBitangent;
+ #endif
+#endif`,normal_pars_vertex:`#ifndef FLAT_SHADED
+ varying vec3 vNormal;
+ #ifdef USE_TANGENT
+ varying vec3 vTangent;
+ varying vec3 vBitangent;
+ #endif
+#endif`,normal_vertex:`#ifndef FLAT_SHADED
+ vNormal = normalize( transformedNormal );
+ #ifdef USE_TANGENT
+ vTangent = normalize( transformedTangent );
+ vBitangent = normalize( cross( vNormal, vTangent ) * tangent.w );
+ #ifdef FLIP_SIDED
+ vBitangent = - vBitangent;
+ #endif
+ #endif
+#endif`,normalmap_pars_fragment:`#ifdef USE_NORMALMAP
+ uniform sampler2D normalMap;
+ uniform vec2 normalScale;
+#endif
+#ifdef USE_NORMALMAP_OBJECTSPACE
+ uniform mat3 normalMatrix;
+#endif
+#if ! defined ( USE_TANGENT ) && ( defined ( USE_NORMALMAP_TANGENTSPACE ) || defined ( USE_CLEARCOAT_NORMALMAP ) || defined( USE_ANISOTROPY ) )
+ mat3 getTangentFrame( vec3 eye_pos, vec3 surf_norm, vec2 uv ) {
+ vec3 q0 = dFdx( eye_pos.xyz );
+ vec3 q1 = dFdy( eye_pos.xyz );
+ vec2 st0 = dFdx( uv.st );
+ vec2 st1 = dFdy( uv.st );
+ vec3 N = surf_norm;
+ vec3 q1perp = cross( q1, N );
+ vec3 q0perp = cross( N, q0 );
+ vec3 T = q1perp * st0.x + q0perp * st1.x;
+ vec3 B = q1perp * st0.y + q0perp * st1.y;
+ float det = max( dot( T, T ), dot( B, B ) );
+ float scale = ( det == 0.0 ) ? 0.0 : inversesqrt( det );
+ return mat3( T * scale, B * scale, N );
+ }
+#endif`,clearcoat_normal_fragment_begin:`#ifdef USE_CLEARCOAT
+ vec3 clearcoatNormal = nonPerturbedNormal;
+#endif`,clearcoat_normal_fragment_maps:`#ifdef USE_CLEARCOAT_NORMALMAP
+ vec3 clearcoatMapN = texture2D( clearcoatNormalMap, vClearcoatNormalMapUv ).xyz * 2.0 - 1.0;
+ clearcoatMapN.xy *= clearcoatNormalScale;
+ clearcoatNormal = normalize( tbn2 * clearcoatMapN );
+#endif`,clearcoat_pars_fragment:`#ifdef USE_CLEARCOATMAP
+ uniform sampler2D clearcoatMap;
+#endif
+#ifdef USE_CLEARCOAT_NORMALMAP
+ uniform sampler2D clearcoatNormalMap;
+ uniform vec2 clearcoatNormalScale;
+#endif
+#ifdef USE_CLEARCOAT_ROUGHNESSMAP
+ uniform sampler2D clearcoatRoughnessMap;
+#endif`,iridescence_pars_fragment:`#ifdef USE_IRIDESCENCEMAP
+ uniform sampler2D iridescenceMap;
+#endif
+#ifdef USE_IRIDESCENCE_THICKNESSMAP
+ uniform sampler2D iridescenceThicknessMap;
+#endif`,opaque_fragment:`#ifdef OPAQUE
+diffuseColor.a = 1.0;
+#endif
+#ifdef USE_TRANSMISSION
+diffuseColor.a *= material.transmissionAlpha;
+#endif
+gl_FragColor = vec4( outgoingLight, diffuseColor.a );`,packing:`vec3 packNormalToRGB( const in vec3 normal ) {
+ return normalize( normal ) * 0.5 + 0.5;
+}
+vec3 unpackRGBToNormal( const in vec3 rgb ) {
+ return 2.0 * rgb.xyz - 1.0;
+}
+const float PackUpscale = 256. / 255.;const float UnpackDownscale = 255. / 256.;const float ShiftRight8 = 1. / 256.;
+const float Inv255 = 1. / 255.;
+const vec4 PackFactors = vec4( 1.0, 256.0, 256.0 * 256.0, 256.0 * 256.0 * 256.0 );
+const vec2 UnpackFactors2 = vec2( UnpackDownscale, 1.0 / PackFactors.g );
+const vec3 UnpackFactors3 = vec3( UnpackDownscale / PackFactors.rg, 1.0 / PackFactors.b );
+const vec4 UnpackFactors4 = vec4( UnpackDownscale / PackFactors.rgb, 1.0 / PackFactors.a );
+vec4 packDepthToRGBA( const in float v ) {
+ if( v <= 0.0 )
+ return vec4( 0., 0., 0., 0. );
+ if( v >= 1.0 )
+ return vec4( 1., 1., 1., 1. );
+ float vuf;
+ float af = modf( v * PackFactors.a, vuf );
+ float bf = modf( vuf * ShiftRight8, vuf );
+ float gf = modf( vuf * ShiftRight8, vuf );
+ return vec4( vuf * Inv255, gf * PackUpscale, bf * PackUpscale, af );
+}
+vec3 packDepthToRGB( const in float v ) {
+ if( v <= 0.0 )
+ return vec3( 0., 0., 0. );
+ if( v >= 1.0 )
+ return vec3( 1., 1., 1. );
+ float vuf;
+ float bf = modf( v * PackFactors.b, vuf );
+ float gf = modf( vuf * ShiftRight8, vuf );
+ return vec3( vuf * Inv255, gf * PackUpscale, bf );
+}
+vec2 packDepthToRG( const in float v ) {
+ if( v <= 0.0 )
+ return vec2( 0., 0. );
+ if( v >= 1.0 )
+ return vec2( 1., 1. );
+ float vuf;
+ float gf = modf( v * 256., vuf );
+ return vec2( vuf * Inv255, gf );
+}
+float unpackRGBAToDepth( const in vec4 v ) {
+ return dot( v, UnpackFactors4 );
+}
+float unpackRGBToDepth( const in vec3 v ) {
+ return dot( v, UnpackFactors3 );
+}
+float unpackRGToDepth( const in vec2 v ) {
+ return v.r * UnpackFactors2.r + v.g * UnpackFactors2.g;
+}
+vec4 pack2HalfToRGBA( const in vec2 v ) {
+ vec4 r = vec4( v.x, fract( v.x * 255.0 ), v.y, fract( v.y * 255.0 ) );
+ return vec4( r.x - r.y / 255.0, r.y, r.z - r.w / 255.0, r.w );
+}
+vec2 unpackRGBATo2Half( const in vec4 v ) {
+ return vec2( v.x + ( v.y / 255.0 ), v.z + ( v.w / 255.0 ) );
+}
+float viewZToOrthographicDepth( const in float viewZ, const in float near, const in float far ) {
+ return ( viewZ + near ) / ( near - far );
+}
+float orthographicDepthToViewZ( const in float depth, const in float near, const in float far ) {
+ #ifdef USE_REVERSED_DEPTH_BUFFER
+
+ return depth * ( far - near ) - far;
+ #else
+ return depth * ( near - far ) - near;
+ #endif
+}
+float viewZToPerspectiveDepth( const in float viewZ, const in float near, const in float far ) {
+ return ( ( near + viewZ ) * far ) / ( ( far - near ) * viewZ );
+}
+float perspectiveDepthToViewZ( const in float depth, const in float near, const in float far ) {
+
+ #ifdef USE_REVERSED_DEPTH_BUFFER
+ return ( near * far ) / ( ( near - far ) * depth - near );
+ #else
+ return ( near * far ) / ( ( far - near ) * depth - far );
+ #endif
+}`,premultiplied_alpha_fragment:`#ifdef PREMULTIPLIED_ALPHA
+ gl_FragColor.rgb *= gl_FragColor.a;
+#endif`,project_vertex:`vec4 mvPosition = vec4( transformed, 1.0 );
+#ifdef USE_BATCHING
+ mvPosition = batchingMatrix * mvPosition;
+#endif
+#ifdef USE_INSTANCING
+ mvPosition = instanceMatrix * mvPosition;
+#endif
+mvPosition = modelViewMatrix * mvPosition;
+gl_Position = projectionMatrix * mvPosition;`,dithering_fragment:`#ifdef DITHERING
+ gl_FragColor.rgb = dithering( gl_FragColor.rgb );
+#endif`,dithering_pars_fragment:`#ifdef DITHERING
+ vec3 dithering( vec3 color ) {
+ float grid_position = rand( gl_FragCoord.xy );
+ vec3 dither_shift_RGB = vec3( 0.25 / 255.0, -0.25 / 255.0, 0.25 / 255.0 );
+ dither_shift_RGB = mix( 2.0 * dither_shift_RGB, -2.0 * dither_shift_RGB, grid_position );
+ return color + dither_shift_RGB;
+ }
+#endif`,roughnessmap_fragment:`float roughnessFactor = roughness;
+#ifdef USE_ROUGHNESSMAP
+ vec4 texelRoughness = texture2D( roughnessMap, vRoughnessMapUv );
+ roughnessFactor *= texelRoughness.g;
+#endif`,roughnessmap_pars_fragment:`#ifdef USE_ROUGHNESSMAP
+ uniform sampler2D roughnessMap;
+#endif`,shadowmap_pars_fragment:`#if NUM_SPOT_LIGHT_COORDS > 0
+ varying vec4 vSpotLightCoord[ NUM_SPOT_LIGHT_COORDS ];
+#endif
+#if NUM_SPOT_LIGHT_MAPS > 0
+ uniform sampler2D spotLightMap[ NUM_SPOT_LIGHT_MAPS ];
+#endif
+#ifdef USE_SHADOWMAP
+ #if NUM_SUN_LIGHT_SHADOWS > 0
+ #define SUN_LIGHT_CASCADES 2
+ #if defined( SHADOWMAP_TYPE_PCF )
+ uniform sampler2DShadow sunShadowMap[ NUM_SUN_LIGHT_SHADOWS ];
+ #else
+ uniform sampler2D sunShadowMap[ NUM_SUN_LIGHT_SHADOWS ];
+ #endif
+ uniform mat4 sunShadowMatrix[ NUM_SUN_LIGHT_SHADOWS * SUN_LIGHT_CASCADES ];
+ uniform vec4 sunShadowCascade[ NUM_SUN_LIGHT_SHADOWS * SUN_LIGHT_CASCADES ];
+ varying vec4 vSunShadowWorldPosition;
+ varying vec3 vSunShadowWorldNormal;
+ struct SunLightShadow {
+ float shadowIntensity;
+ float shadowBias;
+ float shadowNormalBias;
+ float shadowRadius;
+ vec2 shadowMapSize;
+ };
+ uniform SunLightShadow sunLightShadows[ NUM_SUN_LIGHT_SHADOWS ];
+ #endif
+ #if NUM_DIR_LIGHT_SHADOWS > 0
+ #if defined( SHADOWMAP_TYPE_PCF )
+ uniform sampler2DShadow directionalShadowMap[ NUM_DIR_LIGHT_SHADOWS ];
+ #else
+ uniform sampler2D directionalShadowMap[ NUM_DIR_LIGHT_SHADOWS ];
+ #endif
+ varying vec4 vDirectionalShadowCoord[ NUM_DIR_LIGHT_SHADOWS ];
+ struct DirectionalLightShadow {
+ float shadowIntensity;
+ float shadowBias;
+ float shadowNormalBias;
+ float shadowRadius;
+ vec2 shadowMapSize;
+ };
+ uniform DirectionalLightShadow directionalLightShadows[ NUM_DIR_LIGHT_SHADOWS ];
+ #endif
+ #if NUM_SPOT_LIGHT_SHADOWS > 0
+ #if defined( SHADOWMAP_TYPE_PCF )
+ uniform sampler2DShadow spotShadowMap[ NUM_SPOT_LIGHT_SHADOWS ];
+ #else
+ uniform sampler2D spotShadowMap[ NUM_SPOT_LIGHT_SHADOWS ];
+ #endif
+ struct SpotLightShadow {
+ float shadowIntensity;
+ float shadowBias;
+ float shadowNormalBias;
+ float shadowRadius;
+ vec2 shadowMapSize;
+ };
+ uniform SpotLightShadow spotLightShadows[ NUM_SPOT_LIGHT_SHADOWS ];
+ #endif
+ #if NUM_POINT_LIGHT_SHADOWS > 0
+ #if defined( SHADOWMAP_TYPE_PCF )
+ uniform samplerCubeShadow pointShadowMap[ NUM_POINT_LIGHT_SHADOWS ];
+ #elif defined( SHADOWMAP_TYPE_BASIC )
+ uniform samplerCube pointShadowMap[ NUM_POINT_LIGHT_SHADOWS ];
+ #endif
+ varying vec4 vPointShadowCoord[ NUM_POINT_LIGHT_SHADOWS ];
+ struct PointLightShadow {
+ float shadowIntensity;
+ float shadowBias;
+ float shadowNormalBias;
+ float shadowRadius;
+ vec2 shadowMapSize;
+ float shadowCameraNear;
+ float shadowCameraFar;
+ };
+ uniform PointLightShadow pointLightShadows[ NUM_POINT_LIGHT_SHADOWS ];
+ #endif
+ #if defined( SHADOWMAP_TYPE_PCF )
+ float interleavedGradientNoise( vec2 position ) {
+ return fract( 52.9829189 * fract( dot( position, vec2( 0.06711056, 0.00583715 ) ) ) );
+ }
+ vec2 vogelDiskSample( int sampleIndex, int samplesCount, float phi ) {
+ const float goldenAngle = 2.399963229728653;
+ float r = sqrt( ( float( sampleIndex ) + 0.5 ) / float( samplesCount ) );
+ float theta = float( sampleIndex ) * goldenAngle + phi;
+ return vec2( cos( theta ), sin( theta ) ) * r;
+ }
+ #endif
+ #if defined( SHADOWMAP_TYPE_PCF )
+ float getShadow( sampler2DShadow shadowMap, vec2 shadowMapSize, float shadowIntensity, float shadowBias, float shadowRadius, vec4 shadowCoord ) {
+ float shadow = 1.0;
+ shadowCoord.xyz /= shadowCoord.w;
+ shadowCoord.z += shadowBias;
+ bool inFrustum = shadowCoord.x >= 0.0 && shadowCoord.x <= 1.0 && shadowCoord.y >= 0.0 && shadowCoord.y <= 1.0;
+ bool frustumTest = inFrustum && shadowCoord.z <= 1.0;
+ if ( frustumTest ) {
+ vec2 texelSize = vec2( 1.0 ) / shadowMapSize;
+ float radius = shadowRadius * texelSize.x;
+ float phi = interleavedGradientNoise( gl_FragCoord.xy ) * PI2;
+ shadow = (
+ texture( shadowMap, vec3( shadowCoord.xy + vogelDiskSample( 0, 5, phi ) * radius, shadowCoord.z ) ) +
+ texture( shadowMap, vec3( shadowCoord.xy + vogelDiskSample( 1, 5, phi ) * radius, shadowCoord.z ) ) +
+ texture( shadowMap, vec3( shadowCoord.xy + vogelDiskSample( 2, 5, phi ) * radius, shadowCoord.z ) ) +
+ texture( shadowMap, vec3( shadowCoord.xy + vogelDiskSample( 3, 5, phi ) * radius, shadowCoord.z ) ) +
+ texture( shadowMap, vec3( shadowCoord.xy + vogelDiskSample( 4, 5, phi ) * radius, shadowCoord.z ) )
+ ) * 0.2;
+ }
+ return mix( 1.0, shadow, shadowIntensity );
+ }
+ #elif defined( SHADOWMAP_TYPE_VSM )
+ float getShadow( sampler2D shadowMap, vec2 shadowMapSize, float shadowIntensity, float shadowBias, float shadowRadius, vec4 shadowCoord ) {
+ float shadow = 1.0;
+ shadowCoord.xyz /= shadowCoord.w;
+ #ifdef USE_REVERSED_DEPTH_BUFFER
+ shadowCoord.z -= shadowBias;
+ #else
+ shadowCoord.z += shadowBias;
+ #endif
+ bool inFrustum = shadowCoord.x >= 0.0 && shadowCoord.x <= 1.0 && shadowCoord.y >= 0.0 && shadowCoord.y <= 1.0;
+ bool frustumTest = inFrustum && shadowCoord.z <= 1.0;
+ if ( frustumTest ) {
+ vec2 distribution = texture2D( shadowMap, shadowCoord.xy ).rg;
+ float mean = distribution.x;
+ float variance = distribution.y * distribution.y;
+ #ifdef USE_REVERSED_DEPTH_BUFFER
+ float hard_shadow = step( mean, shadowCoord.z );
+ #else
+ float hard_shadow = step( shadowCoord.z, mean );
+ #endif
+
+ if ( hard_shadow == 1.0 ) {
+ shadow = 1.0;
+ } else {
+ variance = max( variance, 0.0000001 );
+ float d = shadowCoord.z - mean;
+ float p_max = variance / ( variance + d * d );
+ p_max = clamp( ( p_max - 0.3 ) / 0.65, 0.0, 1.0 );
+ shadow = max( hard_shadow, p_max );
+ }
+ }
+ return mix( 1.0, shadow, shadowIntensity );
+ }
+ #else
+ float getShadow( sampler2D shadowMap, vec2 shadowMapSize, float shadowIntensity, float shadowBias, float shadowRadius, vec4 shadowCoord ) {
+ float shadow = 1.0;
+ shadowCoord.xyz /= shadowCoord.w;
+ #ifdef USE_REVERSED_DEPTH_BUFFER
+ shadowCoord.z -= shadowBias;
+ #else
+ shadowCoord.z += shadowBias;
+ #endif
+ bool inFrustum = shadowCoord.x >= 0.0 && shadowCoord.x <= 1.0 && shadowCoord.y >= 0.0 && shadowCoord.y <= 1.0;
+ bool frustumTest = inFrustum && shadowCoord.z <= 1.0;
+ if ( frustumTest ) {
+ float depth = texture2D( shadowMap, shadowCoord.xy ).r;
+ #ifdef USE_REVERSED_DEPTH_BUFFER
+ shadow = step( depth, shadowCoord.z );
+ #else
+ shadow = step( shadowCoord.z, depth );
+ #endif
+ }
+ return mix( 1.0, shadow, shadowIntensity );
+ }
+ #endif
+ #if NUM_SUN_LIGHT_SHADOWS > 0
+ float getSunShadow(
+ #if defined( SHADOWMAP_TYPE_PCF )
+ sampler2DShadow shadowMap,
+ #else
+ sampler2D shadowMap,
+ #endif
+ SunLightShadow sunLightShadow,
+ int shadowIndex
+ ) {
+ vec4 shadowWorldPosition = vec4( vSunShadowWorldPosition.xyz + vSunShadowWorldNormal * sunLightShadow.shadowNormalBias, 1.0 );
+ float viewDepth = vSunShadowWorldPosition.w;
+ int cascadeOffset = shadowIndex * SUN_LIGHT_CASCADES;
+ float shadow = 1.0;
+ for ( int i = SUN_LIGHT_CASCADES - 1; i >= 0; i -- ) {
+ vec4 cascade = sunShadowCascade[ cascadeOffset + i ];
+ if ( viewDepth >= cascade.x && viewDepth < cascade.y ) {
+ float cascadeShadow = getShadow(
+ shadowMap,
+ sunLightShadow.shadowMapSize,
+ sunLightShadow.shadowIntensity,
+ sunLightShadow.shadowBias,
+ sunLightShadow.shadowRadius,
+ sunShadowMatrix[ cascadeOffset + i ] * shadowWorldPosition
+ );
+ shadow = mix( cascadeShadow, shadow, smoothstep( cascade.z, cascade.y, viewDepth ) );
+ }
+ }
+ return shadow;
+ }
+ #endif
+ #if NUM_POINT_LIGHT_SHADOWS > 0
+ #if defined( SHADOWMAP_TYPE_PCF )
+ float getPointShadow( samplerCubeShadow shadowMap, vec2 shadowMapSize, float shadowIntensity, float shadowBias, float shadowRadius, vec4 shadowCoord, float shadowCameraNear, float shadowCameraFar ) {
+ float shadow = 1.0;
+ vec3 lightToPosition = shadowCoord.xyz;
+ vec3 bd3D = normalize( lightToPosition );
+ vec3 absVec = abs( lightToPosition );
+ float viewSpaceZ = max( max( absVec.x, absVec.y ), absVec.z );
+ if ( viewSpaceZ - shadowCameraFar <= 0.0 && viewSpaceZ - shadowCameraNear >= 0.0 ) {
+ #ifdef USE_REVERSED_DEPTH_BUFFER
+ float dp = ( shadowCameraNear * ( shadowCameraFar - viewSpaceZ ) ) / ( viewSpaceZ * ( shadowCameraFar - shadowCameraNear ) );
+ dp -= shadowBias;
+ #else
+ float dp = ( shadowCameraFar * ( viewSpaceZ - shadowCameraNear ) ) / ( viewSpaceZ * ( shadowCameraFar - shadowCameraNear ) );
+ dp += shadowBias;
+ #endif
+ float texelSize = shadowRadius / shadowMapSize.x;
+ vec3 absDir = abs( bd3D );
+ vec3 tangent = absDir.x > absDir.z ? vec3( 0.0, 1.0, 0.0 ) : vec3( 1.0, 0.0, 0.0 );
+ tangent = normalize( cross( bd3D, tangent ) );
+ vec3 bitangent = cross( bd3D, tangent );
+ float phi = interleavedGradientNoise( gl_FragCoord.xy ) * PI2;
+ vec2 sample0 = vogelDiskSample( 0, 5, phi );
+ vec2 sample1 = vogelDiskSample( 1, 5, phi );
+ vec2 sample2 = vogelDiskSample( 2, 5, phi );
+ vec2 sample3 = vogelDiskSample( 3, 5, phi );
+ vec2 sample4 = vogelDiskSample( 4, 5, phi );
+ shadow = (
+ texture( shadowMap, vec4( bd3D + ( tangent * sample0.x + bitangent * sample0.y ) * texelSize, dp ) ) +
+ texture( shadowMap, vec4( bd3D + ( tangent * sample1.x + bitangent * sample1.y ) * texelSize, dp ) ) +
+ texture( shadowMap, vec4( bd3D + ( tangent * sample2.x + bitangent * sample2.y ) * texelSize, dp ) ) +
+ texture( shadowMap, vec4( bd3D + ( tangent * sample3.x + bitangent * sample3.y ) * texelSize, dp ) ) +
+ texture( shadowMap, vec4( bd3D + ( tangent * sample4.x + bitangent * sample4.y ) * texelSize, dp ) )
+ ) * 0.2;
+ }
+ return mix( 1.0, shadow, shadowIntensity );
+ }
+ #elif defined( SHADOWMAP_TYPE_BASIC )
+ float getPointShadow( samplerCube shadowMap, vec2 shadowMapSize, float shadowIntensity, float shadowBias, float shadowRadius, vec4 shadowCoord, float shadowCameraNear, float shadowCameraFar ) {
+ float shadow = 1.0;
+ vec3 lightToPosition = shadowCoord.xyz;
+ vec3 absVec = abs( lightToPosition );
+ float viewSpaceZ = max( max( absVec.x, absVec.y ), absVec.z );
+ if ( viewSpaceZ - shadowCameraFar <= 0.0 && viewSpaceZ - shadowCameraNear >= 0.0 ) {
+ float dp = ( shadowCameraFar * ( viewSpaceZ - shadowCameraNear ) ) / ( viewSpaceZ * ( shadowCameraFar - shadowCameraNear ) );
+ dp += shadowBias;
+ vec3 bd3D = normalize( lightToPosition );
+ float depth = textureCube( shadowMap, bd3D ).r;
+ #ifdef USE_REVERSED_DEPTH_BUFFER
+ depth = 1.0 - depth;
+ #endif
+ shadow = step( dp, depth );
+ }
+ return mix( 1.0, shadow, shadowIntensity );
+ }
+ #endif
+ #endif
+#endif`,shadowmap_pars_vertex:`#if NUM_SPOT_LIGHT_COORDS > 0
+ uniform mat4 spotLightMatrix[ NUM_SPOT_LIGHT_COORDS ];
+ varying vec4 vSpotLightCoord[ NUM_SPOT_LIGHT_COORDS ];
+#endif
+#ifdef USE_SHADOWMAP
+ #if NUM_SUN_LIGHT_SHADOWS > 0
+ varying vec4 vSunShadowWorldPosition;
+ varying vec3 vSunShadowWorldNormal;
+ #endif
+ #if NUM_DIR_LIGHT_SHADOWS > 0
+ uniform mat4 directionalShadowMatrix[ NUM_DIR_LIGHT_SHADOWS ];
+ varying vec4 vDirectionalShadowCoord[ NUM_DIR_LIGHT_SHADOWS ];
+ struct DirectionalLightShadow {
+ float shadowIntensity;
+ float shadowBias;
+ float shadowNormalBias;
+ float shadowRadius;
+ vec2 shadowMapSize;
+ };
+ uniform DirectionalLightShadow directionalLightShadows[ NUM_DIR_LIGHT_SHADOWS ];
+ #endif
+ #if NUM_SPOT_LIGHT_SHADOWS > 0
+ struct SpotLightShadow {
+ float shadowIntensity;
+ float shadowBias;
+ float shadowNormalBias;
+ float shadowRadius;
+ vec2 shadowMapSize;
+ };
+ uniform SpotLightShadow spotLightShadows[ NUM_SPOT_LIGHT_SHADOWS ];
+ #endif
+ #if NUM_POINT_LIGHT_SHADOWS > 0
+ uniform mat4 pointShadowMatrix[ NUM_POINT_LIGHT_SHADOWS ];
+ varying vec4 vPointShadowCoord[ NUM_POINT_LIGHT_SHADOWS ];
+ struct PointLightShadow {
+ float shadowIntensity;
+ float shadowBias;
+ float shadowNormalBias;
+ float shadowRadius;
+ vec2 shadowMapSize;
+ float shadowCameraNear;
+ float shadowCameraFar;
+ };
+ uniform PointLightShadow pointLightShadows[ NUM_POINT_LIGHT_SHADOWS ];
+ #endif
+#endif`,shadowmap_vertex:`#if ( defined( USE_SHADOWMAP ) && ( NUM_DIR_LIGHT_SHADOWS > 0 || NUM_SUN_LIGHT_SHADOWS > 0 || NUM_POINT_LIGHT_SHADOWS > 0 ) ) || ( NUM_SPOT_LIGHT_COORDS > 0 )
+ #ifdef HAS_NORMAL
+ vec3 shadowWorldNormal = transformNormalByInverseViewMatrix( transformedNormal, viewMatrix );
+ #else
+ vec3 shadowWorldNormal = vec3( 0.0 );
+ #endif
+ vec4 shadowWorldPosition;
+#endif
+#if defined( USE_SHADOWMAP )
+ #if NUM_SUN_LIGHT_SHADOWS > 0
+ vSunShadowWorldPosition = vec4( worldPosition.xyz, - mvPosition.z );
+ vSunShadowWorldNormal = shadowWorldNormal;
+ #endif
+ #if NUM_DIR_LIGHT_SHADOWS > 0
+ #pragma unroll_loop_start
+ for ( int i = 0; i < NUM_DIR_LIGHT_SHADOWS; i ++ ) {
+ shadowWorldPosition = worldPosition + vec4( shadowWorldNormal * directionalLightShadows[ i ].shadowNormalBias, 0 );
+ vDirectionalShadowCoord[ i ] = directionalShadowMatrix[ i ] * shadowWorldPosition;
+ }
+ #pragma unroll_loop_end
+ #endif
+ #if NUM_POINT_LIGHT_SHADOWS > 0
+ #pragma unroll_loop_start
+ for ( int i = 0; i < NUM_POINT_LIGHT_SHADOWS; i ++ ) {
+ shadowWorldPosition = worldPosition + vec4( shadowWorldNormal * pointLightShadows[ i ].shadowNormalBias, 0 );
+ vPointShadowCoord[ i ] = pointShadowMatrix[ i ] * shadowWorldPosition;
+ }
+ #pragma unroll_loop_end
+ #endif
+#endif
+#if NUM_SPOT_LIGHT_COORDS > 0
+ #pragma unroll_loop_start
+ for ( int i = 0; i < NUM_SPOT_LIGHT_COORDS; i ++ ) {
+ shadowWorldPosition = worldPosition;
+ #if ( defined( USE_SHADOWMAP ) && UNROLLED_LOOP_INDEX < NUM_SPOT_LIGHT_SHADOWS )
+ shadowWorldPosition.xyz += shadowWorldNormal * spotLightShadows[ i ].shadowNormalBias;
+ #endif
+ vSpotLightCoord[ i ] = spotLightMatrix[ i ] * shadowWorldPosition;
+ }
+ #pragma unroll_loop_end
+#endif`,shadowmask_pars_fragment:`float getShadowMask() {
+ float shadow = 1.0;
+ #ifdef USE_SHADOWMAP
+ #if NUM_SUN_LIGHT_SHADOWS > 0
+ SunLightShadow sunLight;
+ #pragma unroll_loop_start
+ for ( int i = 0; i < NUM_SUN_LIGHT_SHADOWS; i ++ ) {
+ sunLight = sunLightShadows[ i ];
+ shadow *= receiveShadow ? getSunShadow( sunShadowMap[ i ], sunLight, UNROLLED_LOOP_INDEX ) : 1.0;
+ }
+ #pragma unroll_loop_end
+ #endif
+ #if NUM_DIR_LIGHT_SHADOWS > 0
+ DirectionalLightShadow directionalLight;
+ #pragma unroll_loop_start
+ for ( int i = 0; i < NUM_DIR_LIGHT_SHADOWS; i ++ ) {
+ directionalLight = directionalLightShadows[ i ];
+ shadow *= receiveShadow ? getShadow( directionalShadowMap[ i ], directionalLight.shadowMapSize, directionalLight.shadowIntensity, directionalLight.shadowBias, directionalLight.shadowRadius, vDirectionalShadowCoord[ i ] ) : 1.0;
+ }
+ #pragma unroll_loop_end
+ #endif
+ #if NUM_SPOT_LIGHT_SHADOWS > 0
+ SpotLightShadow spotLight;
+ #pragma unroll_loop_start
+ for ( int i = 0; i < NUM_SPOT_LIGHT_SHADOWS; i ++ ) {
+ spotLight = spotLightShadows[ i ];
+ shadow *= receiveShadow ? getShadow( spotShadowMap[ i ], spotLight.shadowMapSize, spotLight.shadowIntensity, spotLight.shadowBias, spotLight.shadowRadius, vSpotLightCoord[ i ] ) : 1.0;
+ }
+ #pragma unroll_loop_end
+ #endif
+ #if NUM_POINT_LIGHT_SHADOWS > 0 && ( defined( SHADOWMAP_TYPE_PCF ) || defined( SHADOWMAP_TYPE_BASIC ) )
+ PointLightShadow pointLight;
+ #pragma unroll_loop_start
+ for ( int i = 0; i < NUM_POINT_LIGHT_SHADOWS; i ++ ) {
+ pointLight = pointLightShadows[ i ];
+ shadow *= receiveShadow ? getPointShadow( pointShadowMap[ i ], pointLight.shadowMapSize, pointLight.shadowIntensity, pointLight.shadowBias, pointLight.shadowRadius, vPointShadowCoord[ i ], pointLight.shadowCameraNear, pointLight.shadowCameraFar ) : 1.0;
+ }
+ #pragma unroll_loop_end
+ #endif
+ #endif
+ return shadow;
+}`,skinbase_vertex:`#ifdef USE_SKINNING
+ mat4 boneMatX = getBoneMatrix( skinIndex.x );
+ mat4 boneMatY = getBoneMatrix( skinIndex.y );
+ mat4 boneMatZ = getBoneMatrix( skinIndex.z );
+ mat4 boneMatW = getBoneMatrix( skinIndex.w );
+#endif`,skinning_pars_vertex:`#ifdef USE_SKINNING
+ uniform mat4 bindMatrix;
+ uniform mat4 bindMatrixInverse;
+ uniform highp sampler2D boneTexture;
+ mat4 getBoneMatrix( const in float i ) {
+ int size = textureSize( boneTexture, 0 ).x;
+ int j = int( i ) * 4;
+ int x = j % size;
+ int y = j / size;
+ vec4 v1 = texelFetch( boneTexture, ivec2( x, y ), 0 );
+ vec4 v2 = texelFetch( boneTexture, ivec2( x + 1, y ), 0 );
+ vec4 v3 = texelFetch( boneTexture, ivec2( x + 2, y ), 0 );
+ vec4 v4 = texelFetch( boneTexture, ivec2( x + 3, y ), 0 );
+ return mat4( v1, v2, v3, v4 );
+ }
+#endif`,skinning_vertex:`#ifdef USE_SKINNING
+ vec4 skinVertex = bindMatrix * vec4( transformed, 1.0 );
+ vec4 skinned = vec4( 0.0 );
+ skinned += boneMatX * skinVertex * skinWeight.x;
+ skinned += boneMatY * skinVertex * skinWeight.y;
+ skinned += boneMatZ * skinVertex * skinWeight.z;
+ skinned += boneMatW * skinVertex * skinWeight.w;
+ transformed = ( bindMatrixInverse * skinned ).xyz;
+#endif`,skinnormal_vertex:`#ifdef USE_SKINNING
+ mat4 skinMatrix = mat4( 0.0 );
+ skinMatrix += skinWeight.x * boneMatX;
+ skinMatrix += skinWeight.y * boneMatY;
+ skinMatrix += skinWeight.z * boneMatZ;
+ skinMatrix += skinWeight.w * boneMatW;
+ skinMatrix = bindMatrixInverse * skinMatrix * bindMatrix;
+ objectNormal = vec4( skinMatrix * vec4( objectNormal, 0.0 ) ).xyz;
+ #ifdef USE_TANGENT
+ objectTangent = vec4( skinMatrix * vec4( objectTangent, 0.0 ) ).xyz;
+ #endif
+#endif`,specularmap_fragment:`float specularStrength;
+#ifdef USE_SPECULARMAP
+ vec4 texelSpecular = texture2D( specularMap, vSpecularMapUv );
+ specularStrength = texelSpecular.r;
+#else
+ specularStrength = 1.0;
+#endif`,specularmap_pars_fragment:`#ifdef USE_SPECULARMAP
+ uniform sampler2D specularMap;
+#endif`,tonemapping_fragment:`#if defined( TONE_MAPPING )
+ gl_FragColor.rgb = toneMapping( gl_FragColor.rgb );
+#endif`,tonemapping_pars_fragment:`#ifndef saturate
+#define saturate( a ) clamp( a, 0.0, 1.0 )
+#endif
+uniform float toneMappingExposure;
+vec3 LinearToneMapping( vec3 color ) {
+ return saturate( toneMappingExposure * color );
+}
+vec3 ReinhardToneMapping( vec3 color ) {
+ color *= toneMappingExposure;
+ return saturate( color / ( vec3( 1.0 ) + color ) );
+}
+vec3 CineonToneMapping( vec3 color ) {
+ color *= toneMappingExposure;
+ color = max( vec3( 0.0 ), color - 0.004 );
+ return pow( ( color * ( 6.2 * color + 0.5 ) ) / ( color * ( 6.2 * color + 1.7 ) + 0.06 ), vec3( 2.2 ) );
+}
+vec3 RRTAndODTFit( vec3 v ) {
+ vec3 a = v * ( v + 0.0245786 ) - 0.000090537;
+ vec3 b = v * ( 0.983729 * v + 0.4329510 ) + 0.238081;
+ return a / b;
+}
+vec3 ACESFilmicToneMapping( vec3 color ) {
+ const mat3 ACESInputMat = mat3(
+ vec3( 0.59719, 0.07600, 0.02840 ), vec3( 0.35458, 0.90834, 0.13383 ),
+ vec3( 0.04823, 0.01566, 0.83777 )
+ );
+ const mat3 ACESOutputMat = mat3(
+ vec3( 1.60475, -0.10208, -0.00327 ), vec3( -0.53108, 1.10813, -0.07276 ),
+ vec3( -0.07367, -0.00605, 1.07602 )
+ );
+ color *= toneMappingExposure / 0.6;
+ color = ACESInputMat * color;
+ color = RRTAndODTFit( color );
+ color = ACESOutputMat * color;
+ return saturate( color );
+}
+const mat3 LINEAR_REC2020_TO_LINEAR_SRGB = mat3(
+ vec3( 1.6605, - 0.1246, - 0.0182 ),
+ vec3( - 0.5876, 1.1329, - 0.1006 ),
+ vec3( - 0.0728, - 0.0083, 1.1187 )
+);
+const mat3 LINEAR_SRGB_TO_LINEAR_REC2020 = mat3(
+ vec3( 0.6274, 0.0691, 0.0164 ),
+ vec3( 0.3293, 0.9195, 0.0880 ),
+ vec3( 0.0433, 0.0113, 0.8956 )
+);
+vec3 agxDefaultContrastApprox( vec3 x ) {
+ vec3 x2 = x * x;
+ vec3 x4 = x2 * x2;
+ return + 15.5 * x4 * x2
+ - 40.14 * x4 * x
+ + 31.96 * x4
+ - 6.868 * x2 * x
+ + 0.4298 * x2
+ + 0.1191 * x
+ - 0.00232;
+}
+vec3 AgXToneMapping( vec3 color ) {
+ const mat3 AgXInsetMatrix = mat3(
+ vec3( 0.856627153315983, 0.137318972929847, 0.11189821299995 ),
+ vec3( 0.0951212405381588, 0.761241990602591, 0.0767994186031903 ),
+ vec3( 0.0482516061458583, 0.101439036467562, 0.811302368396859 )
+ );
+ const mat3 AgXOutsetMatrix = mat3(
+ vec3( 1.1271005818144368, - 0.1413297634984383, - 0.14132976349843826 ),
+ vec3( - 0.11060664309660323, 1.157823702216272, - 0.11060664309660294 ),
+ vec3( - 0.016493938717834573, - 0.016493938717834257, 1.2519364065950405 )
+ );
+ const float AgxMinEv = - 12.47393; const float AgxMaxEv = 4.026069;
+ color *= toneMappingExposure;
+ color = LINEAR_SRGB_TO_LINEAR_REC2020 * color;
+ color = AgXInsetMatrix * color;
+ color = max( color, 1e-10 ); color = log2( color );
+ color = ( color - AgxMinEv ) / ( AgxMaxEv - AgxMinEv );
+ color = clamp( color, 0.0, 1.0 );
+ color = agxDefaultContrastApprox( color );
+ color = AgXOutsetMatrix * color;
+ color = pow( max( vec3( 0.0 ), color ), vec3( 2.2 ) );
+ color = LINEAR_REC2020_TO_LINEAR_SRGB * color;
+ color = clamp( color, 0.0, 1.0 );
+ return color;
+}
+vec3 NeutralToneMapping( vec3 color ) {
+ const float StartCompression = 0.8 - 0.04;
+ const float Desaturation = 0.15;
+ color *= toneMappingExposure;
+ float x = min( color.r, min( color.g, color.b ) );
+ float offset = x < 0.08 ? x - 6.25 * x * x : 0.04;
+ color -= offset;
+ float peak = max( color.r, max( color.g, color.b ) );
+ if ( peak < StartCompression ) return color;
+ float d = 1. - StartCompression;
+ float newPeak = 1. - d * d / ( peak + d - StartCompression );
+ color *= newPeak / peak;
+ float g = 1. - 1. / ( Desaturation * ( peak - newPeak ) + 1. );
+ return mix( color, vec3( newPeak ), g );
+}
+vec3 CustomToneMapping( vec3 color ) { return color; }`,transmission_fragment:`#ifdef USE_TRANSMISSION
+ material.transmission = transmission;
+ material.transmissionAlpha = 1.0;
+ material.thickness = thickness;
+ material.attenuationDistance = attenuationDistance;
+ material.attenuationColor = attenuationColor;
+ #ifdef USE_TRANSMISSIONMAP
+ material.transmission *= texture2D( transmissionMap, vTransmissionMapUv ).r;
+ #endif
+ #ifdef USE_THICKNESSMAP
+ material.thickness *= texture2D( thicknessMap, vThicknessMapUv ).g;
+ #endif
+ vec3 pos = vWorldPosition;
+ vec3 v = normalize( cameraPosition - pos );
+ vec3 n = transformNormalByInverseViewMatrix( normal, viewMatrix );
+ vec4 transmitted = getIBLVolumeRefraction(
+ n, v, material.roughness, material.diffuseContribution, material.specularColorBlended, material.specularF90,
+ pos, modelMatrix, viewMatrix, projectionMatrix, material.dispersion, material.ior, material.thickness,
+ material.attenuationColor, material.attenuationDistance );
+ material.transmissionAlpha = mix( material.transmissionAlpha, transmitted.a, material.transmission );
+ totalDiffuse = mix( totalDiffuse, transmitted.rgb, material.transmission );
+#endif`,transmission_pars_fragment:`#ifdef USE_TRANSMISSION
+ uniform float transmission;
+ uniform float thickness;
+ uniform float attenuationDistance;
+ uniform vec3 attenuationColor;
+ #ifdef USE_TRANSMISSIONMAP
+ uniform sampler2D transmissionMap;
+ #endif
+ #ifdef USE_THICKNESSMAP
+ uniform sampler2D thicknessMap;
+ #endif
+ uniform vec2 transmissionSamplerSize;
+ uniform sampler2D transmissionSamplerMap;
+ uniform mat4 modelMatrix;
+ uniform mat4 projectionMatrix;
+ varying vec3 vWorldPosition;
+ float w0( float a ) {
+ return ( 1.0 / 6.0 ) * ( a * ( a * ( - a + 3.0 ) - 3.0 ) + 1.0 );
+ }
+ float w1( float a ) {
+ return ( 1.0 / 6.0 ) * ( a * a * ( 3.0 * a - 6.0 ) + 4.0 );
+ }
+ float w2( float a ){
+ return ( 1.0 / 6.0 ) * ( a * ( a * ( - 3.0 * a + 3.0 ) + 3.0 ) + 1.0 );
+ }
+ float w3( float a ) {
+ return ( 1.0 / 6.0 ) * ( a * a * a );
+ }
+ float g0( float a ) {
+ return w0( a ) + w1( a );
+ }
+ float g1( float a ) {
+ return w2( a ) + w3( a );
+ }
+ float h0( float a ) {
+ return - 1.0 + w1( a ) / ( w0( a ) + w1( a ) );
+ }
+ float h1( float a ) {
+ return 1.0 + w3( a ) / ( w2( a ) + w3( a ) );
+ }
+ vec4 bicubic( sampler2D tex, vec2 uv, vec4 texelSize, float lod ) {
+ uv = uv * texelSize.zw + 0.5;
+ vec2 iuv = floor( uv );
+ vec2 fuv = fract( uv );
+ float g0x = g0( fuv.x );
+ float g1x = g1( fuv.x );
+ float h0x = h0( fuv.x );
+ float h1x = h1( fuv.x );
+ float h0y = h0( fuv.y );
+ float h1y = h1( fuv.y );
+ vec2 p0 = ( vec2( iuv.x + h0x, iuv.y + h0y ) - 0.5 ) * texelSize.xy;
+ vec2 p1 = ( vec2( iuv.x + h1x, iuv.y + h0y ) - 0.5 ) * texelSize.xy;
+ vec2 p2 = ( vec2( iuv.x + h0x, iuv.y + h1y ) - 0.5 ) * texelSize.xy;
+ vec2 p3 = ( vec2( iuv.x + h1x, iuv.y + h1y ) - 0.5 ) * texelSize.xy;
+ return g0( fuv.y ) * ( g0x * textureLod( tex, p0, lod ) + g1x * textureLod( tex, p1, lod ) ) +
+ g1( fuv.y ) * ( g0x * textureLod( tex, p2, lod ) + g1x * textureLod( tex, p3, lod ) );
+ }
+ vec4 textureBicubic( sampler2D sampler, vec2 uv, float lod ) {
+ vec2 fLodSize = vec2( textureSize( sampler, int( lod ) ) );
+ vec2 cLodSize = vec2( textureSize( sampler, int( lod + 1.0 ) ) );
+ vec2 fLodSizeInv = 1.0 / fLodSize;
+ vec2 cLodSizeInv = 1.0 / cLodSize;
+ vec4 fSample = bicubic( sampler, uv, vec4( fLodSizeInv, fLodSize ), floor( lod ) );
+ vec4 cSample = bicubic( sampler, uv, vec4( cLodSizeInv, cLodSize ), ceil( lod ) );
+ return mix( fSample, cSample, fract( lod ) );
+ }
+ vec3 getVolumeTransmissionRay( const in vec3 n, const in vec3 v, const in float thickness, const in float ior, const in mat4 modelMatrix ) {
+ vec3 refractionVector = refract( - v, normalize( n ), 1.0 / ior );
+ vec3 modelScale;
+ modelScale.x = length( vec3( modelMatrix[ 0 ].xyz ) );
+ modelScale.y = length( vec3( modelMatrix[ 1 ].xyz ) );
+ modelScale.z = length( vec3( modelMatrix[ 2 ].xyz ) );
+ return normalize( refractionVector ) * thickness * modelScale;
+ }
+ float applyIorToRoughness( const in float roughness, const in float ior ) {
+ return roughness * clamp( ior * 2.0 - 2.0, 0.0, 1.0 );
+ }
+ vec4 getTransmissionSample( const in vec2 fragCoord, const in float roughness, const in float ior ) {
+ float lod = log2( transmissionSamplerSize.x ) * applyIorToRoughness( roughness, ior );
+ return textureBicubic( transmissionSamplerMap, fragCoord.xy, lod );
+ }
+ vec3 volumeAttenuation( const in float transmissionDistance, const in vec3 attenuationColor, const in float attenuationDistance ) {
+ if ( isinf( attenuationDistance ) ) {
+ return vec3( 1.0 );
+ } else {
+ vec3 attenuationCoefficient = -log( attenuationColor ) / attenuationDistance;
+ vec3 transmittance = exp( - attenuationCoefficient * transmissionDistance ); return transmittance;
+ }
+ }
+ vec4 getIBLVolumeRefraction( const in vec3 n, const in vec3 v, const in float roughness, const in vec3 diffuseColor,
+ const in vec3 specularColor, const in float specularF90, const in vec3 position, const in mat4 modelMatrix,
+ const in mat4 viewMatrix, const in mat4 projMatrix, const in float dispersion, const in float ior, const in float thickness,
+ const in vec3 attenuationColor, const in float attenuationDistance ) {
+ vec4 transmittedLight;
+ vec3 transmittance;
+ #ifdef USE_DISPERSION
+ float halfSpread = ( ior - 1.0 ) * 0.025 * dispersion;
+ vec3 iors = vec3( ior - halfSpread, ior, ior + halfSpread );
+ for ( int i = 0; i < 3; i ++ ) {
+ vec3 transmissionRay = getVolumeTransmissionRay( n, v, thickness, iors[ i ], modelMatrix );
+ vec3 refractedRayExit = position + transmissionRay;
+ vec4 ndcPos = projMatrix * viewMatrix * vec4( refractedRayExit, 1.0 );
+ vec2 refractionCoords = ndcPos.xy / ndcPos.w;
+ refractionCoords += 1.0;
+ refractionCoords /= 2.0;
+ vec4 transmissionSample = getTransmissionSample( refractionCoords, roughness, iors[ i ] );
+ transmittedLight[ i ] = transmissionSample[ i ];
+ transmittedLight.a += transmissionSample.a;
+ transmittance[ i ] = diffuseColor[ i ] * volumeAttenuation( length( transmissionRay ), attenuationColor, attenuationDistance )[ i ];
+ }
+ transmittedLight.a /= 3.0;
+ #else
+ vec3 transmissionRay = getVolumeTransmissionRay( n, v, thickness, ior, modelMatrix );
+ vec3 refractedRayExit = position + transmissionRay;
+ vec4 ndcPos = projMatrix * viewMatrix * vec4( refractedRayExit, 1.0 );
+ vec2 refractionCoords = ndcPos.xy / ndcPos.w;
+ refractionCoords += 1.0;
+ refractionCoords /= 2.0;
+ transmittedLight = getTransmissionSample( refractionCoords, roughness, ior );
+ transmittance = diffuseColor * volumeAttenuation( length( transmissionRay ), attenuationColor, attenuationDistance );
+ #endif
+ vec3 attenuatedColor = transmittance * transmittedLight.rgb;
+ vec3 F = EnvironmentBRDF( n, v, specularColor, specularF90, roughness );
+ float transmittanceFactor = ( transmittance.r + transmittance.g + transmittance.b ) / 3.0;
+ return vec4( ( 1.0 - F ) * attenuatedColor, 1.0 - ( 1.0 - transmittedLight.a ) * transmittanceFactor );
+ }
+#endif`,uv_pars_fragment:`#if defined( USE_UV ) || defined( USE_ANISOTROPY )
+ varying vec2 vUv;
+#endif
+#ifdef USE_MAP
+ varying vec2 vMapUv;
+#endif
+#ifdef USE_ALPHAMAP
+ varying vec2 vAlphaMapUv;
+#endif
+#ifdef USE_LIGHTMAP
+ varying vec2 vLightMapUv;
+#endif
+#ifdef USE_AOMAP
+ varying vec2 vAoMapUv;
+#endif
+#ifdef USE_BUMPMAP
+ varying vec2 vBumpMapUv;
+#endif
+#ifdef USE_NORMALMAP
+ varying vec2 vNormalMapUv;
+#endif
+#ifdef USE_EMISSIVEMAP
+ varying vec2 vEmissiveMapUv;
+#endif
+#ifdef USE_METALNESSMAP
+ varying vec2 vMetalnessMapUv;
+#endif
+#ifdef USE_ROUGHNESSMAP
+ varying vec2 vRoughnessMapUv;
+#endif
+#ifdef USE_ANISOTROPYMAP
+ varying vec2 vAnisotropyMapUv;
+#endif
+#ifdef USE_CLEARCOATMAP
+ varying vec2 vClearcoatMapUv;
+#endif
+#ifdef USE_CLEARCOAT_NORMALMAP
+ varying vec2 vClearcoatNormalMapUv;
+#endif
+#ifdef USE_CLEARCOAT_ROUGHNESSMAP
+ varying vec2 vClearcoatRoughnessMapUv;
+#endif
+#ifdef USE_IRIDESCENCEMAP
+ varying vec2 vIridescenceMapUv;
+#endif
+#ifdef USE_IRIDESCENCE_THICKNESSMAP
+ varying vec2 vIridescenceThicknessMapUv;
+#endif
+#ifdef USE_SHEEN_COLORMAP
+ varying vec2 vSheenColorMapUv;
+#endif
+#ifdef USE_SHEEN_ROUGHNESSMAP
+ varying vec2 vSheenRoughnessMapUv;
+#endif
+#ifdef USE_SPECULARMAP
+ varying vec2 vSpecularMapUv;
+#endif
+#ifdef USE_SPECULAR_COLORMAP
+ varying vec2 vSpecularColorMapUv;
+#endif
+#ifdef USE_SPECULAR_INTENSITYMAP
+ varying vec2 vSpecularIntensityMapUv;
+#endif
+#ifdef USE_TRANSMISSIONMAP
+ uniform mat3 transmissionMapTransform;
+ varying vec2 vTransmissionMapUv;
+#endif
+#ifdef USE_THICKNESSMAP
+ uniform mat3 thicknessMapTransform;
+ varying vec2 vThicknessMapUv;
+#endif`,uv_pars_vertex:`#if defined( USE_UV ) || defined( USE_ANISOTROPY )
+ varying vec2 vUv;
+#endif
+#ifdef USE_MAP
+ uniform mat3 mapTransform;
+ varying vec2 vMapUv;
+#endif
+#ifdef USE_ALPHAMAP
+ uniform mat3 alphaMapTransform;
+ varying vec2 vAlphaMapUv;
+#endif
+#ifdef USE_LIGHTMAP
+ uniform mat3 lightMapTransform;
+ varying vec2 vLightMapUv;
+#endif
+#ifdef USE_AOMAP
+ uniform mat3 aoMapTransform;
+ varying vec2 vAoMapUv;
+#endif
+#ifdef USE_BUMPMAP
+ uniform mat3 bumpMapTransform;
+ varying vec2 vBumpMapUv;
+#endif
+#ifdef USE_NORMALMAP
+ uniform mat3 normalMapTransform;
+ varying vec2 vNormalMapUv;
+#endif
+#ifdef USE_DISPLACEMENTMAP
+ uniform mat3 displacementMapTransform;
+ varying vec2 vDisplacementMapUv;
+#endif
+#ifdef USE_EMISSIVEMAP
+ uniform mat3 emissiveMapTransform;
+ varying vec2 vEmissiveMapUv;
+#endif
+#ifdef USE_METALNESSMAP
+ uniform mat3 metalnessMapTransform;
+ varying vec2 vMetalnessMapUv;
+#endif
+#ifdef USE_ROUGHNESSMAP
+ uniform mat3 roughnessMapTransform;
+ varying vec2 vRoughnessMapUv;
+#endif
+#ifdef USE_ANISOTROPYMAP
+ uniform mat3 anisotropyMapTransform;
+ varying vec2 vAnisotropyMapUv;
+#endif
+#ifdef USE_CLEARCOATMAP
+ uniform mat3 clearcoatMapTransform;
+ varying vec2 vClearcoatMapUv;
+#endif
+#ifdef USE_CLEARCOAT_NORMALMAP
+ uniform mat3 clearcoatNormalMapTransform;
+ varying vec2 vClearcoatNormalMapUv;
+#endif
+#ifdef USE_CLEARCOAT_ROUGHNESSMAP
+ uniform mat3 clearcoatRoughnessMapTransform;
+ varying vec2 vClearcoatRoughnessMapUv;
+#endif
+#ifdef USE_SHEEN_COLORMAP
+ uniform mat3 sheenColorMapTransform;
+ varying vec2 vSheenColorMapUv;
+#endif
+#ifdef USE_SHEEN_ROUGHNESSMAP
+ uniform mat3 sheenRoughnessMapTransform;
+ varying vec2 vSheenRoughnessMapUv;
+#endif
+#ifdef USE_IRIDESCENCEMAP
+ uniform mat3 iridescenceMapTransform;
+ varying vec2 vIridescenceMapUv;
+#endif
+#ifdef USE_IRIDESCENCE_THICKNESSMAP
+ uniform mat3 iridescenceThicknessMapTransform;
+ varying vec2 vIridescenceThicknessMapUv;
+#endif
+#ifdef USE_SPECULARMAP
+ uniform mat3 specularMapTransform;
+ varying vec2 vSpecularMapUv;
+#endif
+#ifdef USE_SPECULAR_COLORMAP
+ uniform mat3 specularColorMapTransform;
+ varying vec2 vSpecularColorMapUv;
+#endif
+#ifdef USE_SPECULAR_INTENSITYMAP
+ uniform mat3 specularIntensityMapTransform;
+ varying vec2 vSpecularIntensityMapUv;
+#endif
+#ifdef USE_TRANSMISSIONMAP
+ uniform mat3 transmissionMapTransform;
+ varying vec2 vTransmissionMapUv;
+#endif
+#ifdef USE_THICKNESSMAP
+ uniform mat3 thicknessMapTransform;
+ varying vec2 vThicknessMapUv;
+#endif`,uv_vertex:`#if defined( USE_UV ) || defined( USE_ANISOTROPY )
+ vUv = vec3( uv, 1 ).xy;
+#endif
+#ifdef USE_MAP
+ vMapUv = ( mapTransform * vec3( MAP_UV, 1 ) ).xy;
+#endif
+#ifdef USE_ALPHAMAP
+ vAlphaMapUv = ( alphaMapTransform * vec3( ALPHAMAP_UV, 1 ) ).xy;
+#endif
+#ifdef USE_LIGHTMAP
+ vLightMapUv = ( lightMapTransform * vec3( LIGHTMAP_UV, 1 ) ).xy;
+#endif
+#ifdef USE_AOMAP
+ vAoMapUv = ( aoMapTransform * vec3( AOMAP_UV, 1 ) ).xy;
+#endif
+#ifdef USE_BUMPMAP
+ vBumpMapUv = ( bumpMapTransform * vec3( BUMPMAP_UV, 1 ) ).xy;
+#endif
+#ifdef USE_NORMALMAP
+ vNormalMapUv = ( normalMapTransform * vec3( NORMALMAP_UV, 1 ) ).xy;
+#endif
+#ifdef USE_DISPLACEMENTMAP
+ vDisplacementMapUv = ( displacementMapTransform * vec3( DISPLACEMENTMAP_UV, 1 ) ).xy;
+#endif
+#ifdef USE_EMISSIVEMAP
+ vEmissiveMapUv = ( emissiveMapTransform * vec3( EMISSIVEMAP_UV, 1 ) ).xy;
+#endif
+#ifdef USE_METALNESSMAP
+ vMetalnessMapUv = ( metalnessMapTransform * vec3( METALNESSMAP_UV, 1 ) ).xy;
+#endif
+#ifdef USE_ROUGHNESSMAP
+ vRoughnessMapUv = ( roughnessMapTransform * vec3( ROUGHNESSMAP_UV, 1 ) ).xy;
+#endif
+#ifdef USE_ANISOTROPYMAP
+ vAnisotropyMapUv = ( anisotropyMapTransform * vec3( ANISOTROPYMAP_UV, 1 ) ).xy;
+#endif
+#ifdef USE_CLEARCOATMAP
+ vClearcoatMapUv = ( clearcoatMapTransform * vec3( CLEARCOATMAP_UV, 1 ) ).xy;
+#endif
+#ifdef USE_CLEARCOAT_NORMALMAP
+ vClearcoatNormalMapUv = ( clearcoatNormalMapTransform * vec3( CLEARCOAT_NORMALMAP_UV, 1 ) ).xy;
+#endif
+#ifdef USE_CLEARCOAT_ROUGHNESSMAP
+ vClearcoatRoughnessMapUv = ( clearcoatRoughnessMapTransform * vec3( CLEARCOAT_ROUGHNESSMAP_UV, 1 ) ).xy;
+#endif
+#ifdef USE_IRIDESCENCEMAP
+ vIridescenceMapUv = ( iridescenceMapTransform * vec3( IRIDESCENCEMAP_UV, 1 ) ).xy;
+#endif
+#ifdef USE_IRIDESCENCE_THICKNESSMAP
+ vIridescenceThicknessMapUv = ( iridescenceThicknessMapTransform * vec3( IRIDESCENCE_THICKNESSMAP_UV, 1 ) ).xy;
+#endif
+#ifdef USE_SHEEN_COLORMAP
+ vSheenColorMapUv = ( sheenColorMapTransform * vec3( SHEEN_COLORMAP_UV, 1 ) ).xy;
+#endif
+#ifdef USE_SHEEN_ROUGHNESSMAP
+ vSheenRoughnessMapUv = ( sheenRoughnessMapTransform * vec3( SHEEN_ROUGHNESSMAP_UV, 1 ) ).xy;
+#endif
+#ifdef USE_SPECULARMAP
+ vSpecularMapUv = ( specularMapTransform * vec3( SPECULARMAP_UV, 1 ) ).xy;
+#endif
+#ifdef USE_SPECULAR_COLORMAP
+ vSpecularColorMapUv = ( specularColorMapTransform * vec3( SPECULAR_COLORMAP_UV, 1 ) ).xy;
+#endif
+#ifdef USE_SPECULAR_INTENSITYMAP
+ vSpecularIntensityMapUv = ( specularIntensityMapTransform * vec3( SPECULAR_INTENSITYMAP_UV, 1 ) ).xy;
+#endif
+#ifdef USE_TRANSMISSIONMAP
+ vTransmissionMapUv = ( transmissionMapTransform * vec3( TRANSMISSIONMAP_UV, 1 ) ).xy;
+#endif
+#ifdef USE_THICKNESSMAP
+ vThicknessMapUv = ( thicknessMapTransform * vec3( THICKNESSMAP_UV, 1 ) ).xy;
+#endif`,worldpos_vertex:`#if defined( USE_ENVMAP ) || defined( DISTANCE ) || defined ( USE_SHADOWMAP ) || defined ( USE_TRANSMISSION ) || NUM_SPOT_LIGHT_COORDS > 0
+ vec4 worldPosition = vec4( transformed, 1.0 );
+ #ifdef USE_BATCHING
+ worldPosition = batchingMatrix * worldPosition;
+ #endif
+ #ifdef USE_INSTANCING
+ worldPosition = instanceMatrix * worldPosition;
+ #endif
+ worldPosition = modelMatrix * worldPosition;
+#endif`,background_vert:`varying vec2 vUv;
+uniform mat3 uvTransform;
+void main() {
+ vUv = ( uvTransform * vec3( uv, 1 ) ).xy;
+ gl_Position = vec4( position.xy, 1.0, 1.0 );
+}`,background_frag:`uniform sampler2D t2D;
+uniform float backgroundIntensity;
+varying vec2 vUv;
+void main() {
+ vec4 texColor = texture2D( t2D, vUv );
+ #ifdef DECODE_VIDEO_TEXTURE
+ texColor = vec4( mix( pow( texColor.rgb * 0.9478672986 + vec3( 0.0521327014 ), vec3( 2.4 ) ), texColor.rgb * 0.0773993808, vec3( lessThanEqual( texColor.rgb, vec3( 0.04045 ) ) ) ), texColor.w );
+ #endif
+ texColor.rgb *= backgroundIntensity;
+ gl_FragColor = texColor;
+ #include <tonemapping_fragment>
+ #include <colorspace_fragment>
+}`,backgroundCube_vert:`varying vec3 vWorldDirection;
+#include <common>
+void main() {
+ vWorldDirection = transformDirection( position, modelMatrix );
+ #include <begin_vertex>
+ #include <project_vertex>
+ gl_Position.z = gl_Position.w;
+}`,backgroundCube_frag:`#ifdef ENVMAP_TYPE_CUBE
+ uniform samplerCube envMap;
+#elif defined( ENVMAP_TYPE_CUBE_UV )
+ uniform sampler2D envMap;
+#endif
+uniform float backgroundBlurriness;
+uniform float backgroundIntensity;
+uniform mat3 backgroundRotation;
+varying vec3 vWorldDirection;
+#include <cube_uv_reflection_fragment>
+void main() {
+ #ifdef ENVMAP_TYPE_CUBE
+ vec4 texColor = textureCube( envMap, backgroundRotation * vWorldDirection );
+ #elif defined( ENVMAP_TYPE_CUBE_UV )
+ vec4 texColor = textureCubeUV( envMap, backgroundRotation * vWorldDirection, backgroundBlurriness );
+ #else
+ vec4 texColor = vec4( 0.0, 0.0, 0.0, 1.0 );
+ #endif
+ texColor.rgb *= backgroundIntensity;
+ gl_FragColor = texColor;
+ #include <tonemapping_fragment>
+ #include <colorspace_fragment>
+}`,cube_vert:`varying vec3 vWorldDirection;
+#include <common>
+void main() {
+ vWorldDirection = transformDirection( position, modelMatrix );
+ #include <begin_vertex>
+ #include <project_vertex>
+ gl_Position.z = gl_Position.w;
+}`,cube_frag:`uniform samplerCube tCube;
+uniform float tFlip;
+uniform float opacity;
+varying vec3 vWorldDirection;
+void main() {
+ vec4 texColor = textureCube( tCube, vec3( tFlip * vWorldDirection.x, vWorldDirection.yz ) );
+ gl_FragColor = texColor;
+ gl_FragColor.a *= opacity;
+ #include <tonemapping_fragment>
+ #include <colorspace_fragment>
+}`,depth_vert:`#include <common>
+#include <batching_pars_vertex>
+#include <uv_pars_vertex>
+#include <displacementmap_pars_vertex>
+#include <morphtarget_pars_vertex>
+#include <skinning_pars_vertex>
+#include <logdepthbuf_pars_vertex>
+#include <clipping_planes_pars_vertex>
+varying vec2 vHighPrecisionZW;
+void main() {
+ #include <uv_vertex>
+ #include <batching_vertex>
+ #include <skinbase_vertex>
+ #include <morphinstance_vertex>
+ #ifdef USE_DISPLACEMENTMAP
+ #include <beginnormal_vertex>
+ #include <morphnormal_vertex>
+ #include <skinnormal_vertex>
+ #endif
+ #include <begin_vertex>
+ #include <morphtarget_vertex>
+ #include <skinning_vertex>
+ #include <displacementmap_vertex>
+ #include <project_vertex>
+ #include <logdepthbuf_vertex>
+ #include <clipping_planes_vertex>
+ vHighPrecisionZW = gl_Position.zw;
+}`,depth_frag:`#if DEPTH_PACKING == 3200
+ uniform float opacity;
+#endif
+#include <common>
+#include <packing>
+#include <uv_pars_fragment>
+#include <map_pars_fragment>
+#include <alphamap_pars_fragment>
+#include <alphatest_pars_fragment>
+#include <alphahash_pars_fragment>
+#include <logdepthbuf_pars_fragment>
+#include <clipping_planes_pars_fragment>
+varying vec2 vHighPrecisionZW;
+void main() {
+ vec4 diffuseColor = vec4( 1.0 );
+ #include <clipping_planes_fragment>
+ #if DEPTH_PACKING == 3200
+ diffuseColor.a = opacity;
+ #endif
+ #include <map_fragment>
+ #include <alphamap_fragment>
+ #include <alphatest_fragment>
+ #include <alphahash_fragment>
+ #include <logdepthbuf_fragment>
+ #ifdef USE_REVERSED_DEPTH_BUFFER
+ float fragCoordZ = vHighPrecisionZW[ 0 ] / vHighPrecisionZW[ 1 ];
+ #else
+ float fragCoordZ = 0.5 * vHighPrecisionZW[ 0 ] / vHighPrecisionZW[ 1 ] + 0.5;
+ #endif
+ #if DEPTH_PACKING == 3200
+ gl_FragColor = vec4( vec3( 1.0 - fragCoordZ ), opacity );
+ #elif DEPTH_PACKING == 3201
+ gl_FragColor = packDepthToRGBA( fragCoordZ );
+ #elif DEPTH_PACKING == 3202
+ gl_FragColor = vec4( packDepthToRGB( fragCoordZ ), 1.0 );
+ #elif DEPTH_PACKING == 3203
+ gl_FragColor = vec4( packDepthToRG( fragCoordZ ), 0.0, 1.0 );
+ #endif
+}`,distance_vert:`#define DISTANCE
+varying vec3 vWorldPosition;
+#include <common>
+#include <batching_pars_vertex>
+#include <uv_pars_vertex>
+#include <displacementmap_pars_vertex>
+#include <morphtarget_pars_vertex>
+#include <skinning_pars_vertex>
+#include <clipping_planes_pars_vertex>
+void main() {
+ #include <uv_vertex>
+ #include <batching_vertex>
+ #include <skinbase_vertex>
+ #include <morphinstance_vertex>
+ #ifdef USE_DISPLACEMENTMAP
+ #include <beginnormal_vertex>
+ #include <morphnormal_vertex>
+ #include <skinnormal_vertex>
+ #endif
+ #include <begin_vertex>
+ #include <morphtarget_vertex>
+ #include <skinning_vertex>
+ #include <displacementmap_vertex>
+ #include <project_vertex>
+ #include <worldpos_vertex>
+ #include <clipping_planes_vertex>
+ vWorldPosition = worldPosition.xyz;
+}`,distance_frag:`#define DISTANCE
+uniform vec3 referencePosition;
+uniform float nearDistance;
+uniform float farDistance;
+varying vec3 vWorldPosition;
+#include <common>
+#include <uv_pars_fragment>
+#include <map_pars_fragment>
+#include <alphamap_pars_fragment>
+#include <alphatest_pars_fragment>
+#include <alphahash_pars_fragment>
+#include <clipping_planes_pars_fragment>
+void main() {
+ vec4 diffuseColor = vec4( 1.0 );
+ #include <clipping_planes_fragment>
+ #include <map_fragment>
+ #include <alphamap_fragment>
+ #include <alphatest_fragment>
+ #include <alphahash_fragment>
+ float dist = length( vWorldPosition - referencePosition );
+ dist = ( dist - nearDistance ) / ( farDistance - nearDistance );
+ dist = saturate( dist );
+ gl_FragColor = vec4( dist, 0.0, 0.0, 1.0 );
+}`,equirect_vert:`varying vec3 vWorldDirection;
+#include <common>
+void main() {
+ vWorldDirection = transformDirection( position, modelMatrix );
+ #include <begin_vertex>
+ #include <project_vertex>
+}`,equirect_frag:`uniform sampler2D tEquirect;
+varying vec3 vWorldDirection;
+#include <common>
+void main() {
+ vec3 direction = normalize( vWorldDirection );
+ vec2 sampleUV = equirectUv( direction );
+ gl_FragColor = texture2D( tEquirect, sampleUV );
+ #include <tonemapping_fragment>
+ #include <colorspace_fragment>
+}`,linedashed_vert:`uniform float scale;
+attribute float lineDistance;
+varying float vLineDistance;
+#include <common>
+#include <uv_pars_vertex>
+#include <color_pars_vertex>
+#include <fog_pars_vertex>
+#include <morphtarget_pars_vertex>
+#include <logdepthbuf_pars_vertex>
+#include <clipping_planes_pars_vertex>
+void main() {
+ vLineDistance = scale * lineDistance;
+ #include <uv_vertex>
+ #include <color_vertex>
+ #include <morphinstance_vertex>
+ #include <morphcolor_vertex>
+ #include <begin_vertex>
+ #include <morphtarget_vertex>
+ #include <project_vertex>
+ #include <logdepthbuf_vertex>
+ #include <clipping_planes_vertex>
+ #include <fog_vertex>
+}`,linedashed_frag:`uniform vec3 diffuse;
+uniform float opacity;
+uniform float dashSize;
+uniform float totalSize;
+varying float vLineDistance;
+#include <common>
+#include <color_pars_fragment>
+#include <uv_pars_fragment>
+#include <map_pars_fragment>
+#include <fog_pars_fragment>
+#include <logdepthbuf_pars_fragment>
+#include <clipping_planes_pars_fragment>
+void main() {
+ vec4 diffuseColor = vec4( diffuse, opacity );
+ #include <clipping_planes_fragment>
+ if ( mod( vLineDistance, totalSize ) > dashSize ) {
+ discard;
+ }
+ vec3 outgoingLight = vec3( 0.0 );
+ #include <logdepthbuf_fragment>
+ #include <map_fragment>
+ #include <color_fragment>
+ outgoingLight = diffuseColor.rgb;
+ #include <opaque_fragment>
+ #include <tonemapping_fragment>
+ #include <colorspace_fragment>
+ #include <fog_fragment>
+ #include <premultiplied_alpha_fragment>
+}`,meshbasic_vert:`#include <common>
+#include <batching_pars_vertex>
+#include <uv_pars_vertex>
+#include <envmap_pars_vertex>
+#include <color_pars_vertex>
+#include <fog_pars_vertex>
+#include <morphtarget_pars_vertex>
+#include <skinning_pars_vertex>
+#include <logdepthbuf_pars_vertex>
+#include <clipping_planes_pars_vertex>
+void main() {
+ #include <uv_vertex>
+ #include <color_vertex>
+ #include <morphinstance_vertex>
+ #include <morphcolor_vertex>
+ #include <batching_vertex>
+ #if defined ( USE_ENVMAP ) || defined ( USE_SKINNING )
+ #include <beginnormal_vertex>
+ #include <morphnormal_vertex>
+ #include <skinbase_vertex>
+ #include <skinnormal_vertex>
+ #include <defaultnormal_vertex>
+ #endif
+ #include <begin_vertex>
+ #include <morphtarget_vertex>
+ #include <skinning_vertex>
+ #include <project_vertex>
+ #include <logdepthbuf_vertex>
+ #include <clipping_planes_vertex>
+ #include <worldpos_vertex>
+ #include <envmap_vertex>
+ #include <fog_vertex>
+}`,meshbasic_frag:`uniform vec3 diffuse;
+uniform float opacity;
+#ifndef FLAT_SHADED
+ varying vec3 vNormal;
+#endif
+#include <common>
+#include <dithering_pars_fragment>
+#include <color_pars_fragment>
+#include <uv_pars_fragment>
+#include <map_pars_fragment>
+#include <alphamap_pars_fragment>
+#include <alphatest_pars_fragment>
+#include <alphahash_pars_fragment>
+#include <aomap_pars_fragment>
+#include <lightmap_pars_fragment>
+#include <envmap_common_pars_fragment>
+#include <envmap_pars_fragment>
+#include <fog_pars_fragment>
+#include <specularmap_pars_fragment>
+#include <logdepthbuf_pars_fragment>
+#include <clipping_planes_pars_fragment>
+void main() {
+ vec4 diffuseColor = vec4( diffuse, opacity );
+ #include <clipping_planes_fragment>
+ #include <logdepthbuf_fragment>
+ #include <map_fragment>
+ #include <color_fragment>
+ #include <alphamap_fragment>
+ #include <alphatest_fragment>
+ #include <alphahash_fragment>
+ #include <specularmap_fragment>
+ ReflectedLight reflectedLight = ReflectedLight( vec3( 0.0 ), vec3( 0.0 ), vec3( 0.0 ), vec3( 0.0 ) );
+ #ifdef USE_LIGHTMAP
+ vec4 lightMapTexel = texture2D( lightMap, vLightMapUv );
+ reflectedLight.indirectDiffuse += lightMapTexel.rgb * lightMapIntensity * RECIPROCAL_PI;
+ #else
+ reflectedLight.indirectDiffuse += vec3( 1.0 );
+ #endif
+ #include <aomap_fragment>
+ reflectedLight.indirectDiffuse *= diffuseColor.rgb;
+ vec3 outgoingLight = reflectedLight.indirectDiffuse;
+ #include <envmap_fragment>
+ #include <opaque_fragment>
+ #include <tonemapping_fragment>
+ #include <colorspace_fragment>
+ #include <fog_fragment>
+ #include <premultiplied_alpha_fragment>
+ #include <dithering_fragment>
+}`,meshlambert_vert:`#define LAMBERT
+varying vec3 vViewPosition;
+#include <common>
+#include <batching_pars_vertex>
+#include <uv_pars_vertex>
+#include <displacementmap_pars_vertex>
+#include <envmap_pars_vertex>
+#include <color_pars_vertex>
+#include <fog_pars_vertex>
+#include <normal_pars_vertex>
+#include <morphtarget_pars_vertex>
+#include <skinning_pars_vertex>
+#include <shadowmap_pars_vertex>
+#include <logdepthbuf_pars_vertex>
+#include <clipping_planes_pars_vertex>
+void main() {
+ #include <uv_vertex>
+ #include <color_vertex>
+ #include <morphinstance_vertex>
+ #include <morphcolor_vertex>
+ #include <batching_vertex>
+ #include <beginnormal_vertex>
+ #include <morphnormal_vertex>
+ #include <skinbase_vertex>
+ #include <skinnormal_vertex>
+ #include <defaultnormal_vertex>
+ #include <normal_vertex>
+ #include <begin_vertex>
+ #include <morphtarget_vertex>
+ #include <skinning_vertex>
+ #include <displacementmap_vertex>
+ #include <project_vertex>
+ #include <logdepthbuf_vertex>
+ #include <clipping_planes_vertex>
+ vViewPosition = - mvPosition.xyz;
+ #include <worldpos_vertex>
+ #include <envmap_vertex>
+ #include <shadowmap_vertex>
+ #include <fog_vertex>
+}`,meshlambert_frag:`#define LAMBERT
+uniform vec3 diffuse;
+uniform vec3 emissive;
+uniform float opacity;
+#include <common>
+#include <dithering_pars_fragment>
+#include <color_pars_fragment>
+#include <uv_pars_fragment>
+#include <map_pars_fragment>
+#include <alphamap_pars_fragment>
+#include <alphatest_pars_fragment>
+#include <alphahash_pars_fragment>
+#include <aomap_pars_fragment>
+#include <lightmap_pars_fragment>
+#include <emissivemap_pars_fragment>
+#include <cube_uv_reflection_fragment>
+#include <envmap_common_pars_fragment>
+#include <envmap_pars_fragment>
+#include <envmap_physical_pars_fragment>
+#include <fog_pars_fragment>
+#include <bsdfs>
+#include <lights_pars_begin>
+#include <normal_pars_fragment>
+#include <lights_lambert_pars_fragment>
+#include <shadowmap_pars_fragment>
+#include <bumpmap_pars_fragment>
+#include <normalmap_pars_fragment>
+#include <specularmap_pars_fragment>
+#include <logdepthbuf_pars_fragment>
+#include <clipping_planes_pars_fragment>
+void main() {
+ vec4 diffuseColor = vec4( diffuse, opacity );
+ #include <clipping_planes_fragment>
+ ReflectedLight reflectedLight = ReflectedLight( vec3( 0.0 ), vec3( 0.0 ), vec3( 0.0 ), vec3( 0.0 ) );
+ vec3 totalEmissiveRadiance = emissive;
+ #include <logdepthbuf_fragment>
+ #include <map_fragment>
+ #include <color_fragment>
+ #include <alphamap_fragment>
+ #include <alphatest_fragment>
+ #include <alphahash_fragment>
+ #include <specularmap_fragment>
+ #include <normal_fragment_begin>
+ #include <normal_fragment_maps>
+ #include <emissivemap_fragment>
+ #include <lights_lambert_fragment>
+ #include <lights_fragment_begin>
+ #include <lights_fragment_maps>
+ #include <lights_fragment_end>
+ #include <aomap_fragment>
+ vec3 outgoingLight = reflectedLight.directDiffuse + reflectedLight.indirectDiffuse + totalEmissiveRadiance;
+ #include <envmap_fragment>
+ #include <opaque_fragment>
+ #include <tonemapping_fragment>
+ #include <colorspace_fragment>
+ #include <fog_fragment>
+ #include <premultiplied_alpha_fragment>
+ #include <dithering_fragment>
+}`,meshmatcap_vert:`#define MATCAP
+varying vec3 vViewPosition;
+#include <common>
+#include <batching_pars_vertex>
+#include <uv_pars_vertex>
+#include <color_pars_vertex>
+#include <displacementmap_pars_vertex>
+#include <fog_pars_vertex>
+#include <normal_pars_vertex>
+#include <morphtarget_pars_vertex>
+#include <skinning_pars_vertex>
+#include <logdepthbuf_pars_vertex>
+#include <clipping_planes_pars_vertex>
+void main() {
+ #include <uv_vertex>
+ #include <color_vertex>
+ #include <morphinstance_vertex>
+ #include <morphcolor_vertex>
+ #include <batching_vertex>
+ #include <beginnormal_vertex>
+ #include <morphnormal_vertex>
+ #include <skinbase_vertex>
+ #include <skinnormal_vertex>
+ #include <defaultnormal_vertex>
+ #include <normal_vertex>
+ #include <begin_vertex>
+ #include <morphtarget_vertex>
+ #include <skinning_vertex>
+ #include <displacementmap_vertex>
+ #include <project_vertex>
+ #include <logdepthbuf_vertex>
+ #include <clipping_planes_vertex>
+ #include <fog_vertex>
+ vViewPosition = - mvPosition.xyz;
+}`,meshmatcap_frag:`#define MATCAP
+uniform vec3 diffuse;
+uniform float opacity;
+uniform sampler2D matcap;
+varying vec3 vViewPosition;
+#include <common>
+#include <dithering_pars_fragment>
+#include <color_pars_fragment>
+#include <uv_pars_fragment>
+#include <map_pars_fragment>
+#include <alphamap_pars_fragment>
+#include <alphatest_pars_fragment>
+#include <alphahash_pars_fragment>
+#include <fog_pars_fragment>
+#include <normal_pars_fragment>
+#include <bumpmap_pars_fragment>
+#include <normalmap_pars_fragment>
+#include <logdepthbuf_pars_fragment>
+#include <clipping_planes_pars_fragment>
+void main() {
+ vec4 diffuseColor = vec4( diffuse, opacity );
+ #include <clipping_planes_fragment>
+ #include <logdepthbuf_fragment>
+ #include <map_fragment>
+ #include <color_fragment>
+ #include <alphamap_fragment>
+ #include <alphatest_fragment>
+ #include <alphahash_fragment>
+ #include <normal_fragment_begin>
+ #include <normal_fragment_maps>
+ vec3 viewDir = normalize( vViewPosition );
+ vec3 x = normalize( vec3( viewDir.z, 0.0, - viewDir.x ) );
+ vec3 y = cross( viewDir, x );
+ vec2 uv = vec2( dot( x, normal ), dot( y, normal ) ) * 0.495 + 0.5;
+ #ifdef USE_MATCAP
+ vec4 matcapColor = texture2D( matcap, uv );
+ #else
+ vec4 matcapColor = vec4( vec3( mix( 0.2, 0.8, uv.y ) ), 1.0 );
+ #endif
+ vec3 outgoingLight = diffuseColor.rgb * matcapColor.rgb;
+ #include <opaque_fragment>
+ #include <tonemapping_fragment>
+ #include <colorspace_fragment>
+ #include <fog_fragment>
+ #include <premultiplied_alpha_fragment>
+ #include <dithering_fragment>
+}`,meshnormal_vert:`#define NORMAL
+#if defined( FLAT_SHADED ) || defined( USE_BUMPMAP ) || defined( USE_NORMALMAP_TANGENTSPACE )
+ varying vec3 vViewPosition;
+#endif
+#include <common>
+#include <batching_pars_vertex>
+#include <uv_pars_vertex>
+#include <displacementmap_pars_vertex>
+#include <normal_pars_vertex>
+#include <morphtarget_pars_vertex>
+#include <skinning_pars_vertex>
+#include <logdepthbuf_pars_vertex>
+#include <clipping_planes_pars_vertex>
+void main() {
+ #include <uv_vertex>
+ #include <batching_vertex>
+ #include <beginnormal_vertex>
+ #include <morphinstance_vertex>
+ #include <morphnormal_vertex>
+ #include <skinbase_vertex>
+ #include <skinnormal_vertex>
+ #include <defaultnormal_vertex>
+ #include <normal_vertex>
+ #include <begin_vertex>
+ #include <morphtarget_vertex>
+ #include <skinning_vertex>
+ #include <displacementmap_vertex>
+ #include <project_vertex>
+ #include <logdepthbuf_vertex>
+ #include <clipping_planes_vertex>
+#if defined( FLAT_SHADED ) || defined( USE_BUMPMAP ) || defined( USE_NORMALMAP_TANGENTSPACE )
+ vViewPosition = - mvPosition.xyz;
+#endif
+}`,meshnormal_frag:`#define NORMAL
+uniform float opacity;
+#if defined( FLAT_SHADED ) || defined( USE_BUMPMAP ) || defined( USE_NORMALMAP_TANGENTSPACE )
+ varying vec3 vViewPosition;
+#endif
+#include <uv_pars_fragment>
+#include <normal_pars_fragment>
+#include <bumpmap_pars_fragment>
+#include <normalmap_pars_fragment>
+#include <logdepthbuf_pars_fragment>
+#include <clipping_planes_pars_fragment>
+void main() {
+ vec4 diffuseColor = vec4( 0.0, 0.0, 0.0, opacity );
+ #include <clipping_planes_fragment>
+ #include <logdepthbuf_fragment>
+ #include <normal_fragment_begin>
+ #include <normal_fragment_maps>
+ gl_FragColor = vec4( normalize( normal ) * 0.5 + 0.5, diffuseColor.a );
+ #ifdef OPAQUE
+ gl_FragColor.a = 1.0;
+ #endif
+}`,meshphong_vert:`#define PHONG
+varying vec3 vViewPosition;
+#include <common>
+#include <batching_pars_vertex>
+#include <uv_pars_vertex>
+#include <displacementmap_pars_vertex>
+#include <envmap_pars_vertex>
+#include <color_pars_vertex>
+#include <fog_pars_vertex>
+#include <normal_pars_vertex>
+#include <morphtarget_pars_vertex>
+#include <skinning_pars_vertex>
+#include <shadowmap_pars_vertex>
+#include <logdepthbuf_pars_vertex>
+#include <clipping_planes_pars_vertex>
+void main() {
+ #include <uv_vertex>
+ #include <color_vertex>
+ #include <morphcolor_vertex>
+ #include <batching_vertex>
+ #include <beginnormal_vertex>
+ #include <morphinstance_vertex>
+ #include <morphnormal_vertex>
+ #include <skinbase_vertex>
+ #include <skinnormal_vertex>
+ #include <defaultnormal_vertex>
+ #include <normal_vertex>
+ #include <begin_vertex>
+ #include <morphtarget_vertex>
+ #include <skinning_vertex>
+ #include <displacementmap_vertex>
+ #include <project_vertex>
+ #include <logdepthbuf_vertex>
+ #include <clipping_planes_vertex>
+ vViewPosition = - mvPosition.xyz;
+ #include <worldpos_vertex>
+ #include <envmap_vertex>
+ #include <shadowmap_vertex>
+ #include <fog_vertex>
+}`,meshphong_frag:`#define PHONG
+uniform vec3 diffuse;
+uniform vec3 emissive;
+uniform vec3 specular;
+uniform float shininess;
+uniform float opacity;
+#include <common>
+#include <dithering_pars_fragment>
+#include <color_pars_fragment>
+#include <uv_pars_fragment>
+#include <map_pars_fragment>
+#include <alphamap_pars_fragment>
+#include <alphatest_pars_fragment>
+#include <alphahash_pars_fragment>
+#include <aomap_pars_fragment>
+#include <lightmap_pars_fragment>
+#include <emissivemap_pars_fragment>
+#include <cube_uv_reflection_fragment>
+#include <envmap_common_pars_fragment>
+#include <envmap_pars_fragment>
+#include <envmap_physical_pars_fragment>
+#include <fog_pars_fragment>
+#include <bsdfs>
+#include <lights_pars_begin>
+#include <normal_pars_fragment>
+#include <lights_phong_pars_fragment>
+#include <shadowmap_pars_fragment>
+#include <bumpmap_pars_fragment>
+#include <normalmap_pars_fragment>
+#include <specularmap_pars_fragment>
+#include <logdepthbuf_pars_fragment>
+#include <clipping_planes_pars_fragment>
+void main() {
+ vec4 diffuseColor = vec4( diffuse, opacity );
+ #include <clipping_planes_fragment>
+ ReflectedLight reflectedLight = ReflectedLight( vec3( 0.0 ), vec3( 0.0 ), vec3( 0.0 ), vec3( 0.0 ) );
+ vec3 totalEmissiveRadiance = emissive;
+ #include <logdepthbuf_fragment>
+ #include <map_fragment>
+ #include <color_fragment>
+ #include <alphamap_fragment>
+ #include <alphatest_fragment>
+ #include <alphahash_fragment>
+ #include <specularmap_fragment>
+ #include <normal_fragment_begin>
+ #include <normal_fragment_maps>
+ #include <emissivemap_fragment>
+ #include <lights_phong_fragment>
+ #include <lights_fragment_begin>
+ #include <lights_fragment_maps>
+ #include <lights_fragment_end>
+ #include <aomap_fragment>
+ vec3 outgoingLight = reflectedLight.directDiffuse + reflectedLight.indirectDiffuse + reflectedLight.directSpecular + reflectedLight.indirectSpecular + totalEmissiveRadiance;
+ #include <envmap_fragment>
+ #include <opaque_fragment>
+ #include <tonemapping_fragment>
+ #include <colorspace_fragment>
+ #include <fog_fragment>
+ #include <premultiplied_alpha_fragment>
+ #include <dithering_fragment>
+}`,meshphysical_vert:`#define STANDARD
+varying vec3 vViewPosition;
+#ifdef USE_TRANSMISSION
+ varying vec3 vWorldPosition;
+#endif
+#include <common>
+#include <batching_pars_vertex>
+#include <uv_pars_vertex>
+#include <displacementmap_pars_vertex>
+#include <color_pars_vertex>
+#include <fog_pars_vertex>
+#include <normal_pars_vertex>
+#include <morphtarget_pars_vertex>
+#include <skinning_pars_vertex>
+#include <shadowmap_pars_vertex>
+#include <logdepthbuf_pars_vertex>
+#include <clipping_planes_pars_vertex>
+void main() {
+ #include <uv_vertex>
+ #include <color_vertex>
+ #include <morphinstance_vertex>
+ #include <morphcolor_vertex>
+ #include <batching_vertex>
+ #include <beginnormal_vertex>
+ #include <morphnormal_vertex>
+ #include <skinbase_vertex>
+ #include <skinnormal_vertex>
+ #include <defaultnormal_vertex>
+ #include <normal_vertex>
+ #include <begin_vertex>
+ #include <morphtarget_vertex>
+ #include <skinning_vertex>
+ #include <displacementmap_vertex>
+ #include <project_vertex>
+ #include <logdepthbuf_vertex>
+ #include <clipping_planes_vertex>
+ vViewPosition = - mvPosition.xyz;
+ #include <worldpos_vertex>
+ #include <shadowmap_vertex>
+ #include <fog_vertex>
+#ifdef USE_TRANSMISSION
+ vWorldPosition = worldPosition.xyz;
+#endif
+}`,meshphysical_frag:`#define STANDARD
+#ifdef PHYSICAL
+ #define IOR
+ #define USE_SPECULAR
+#endif
+uniform vec3 diffuse;
+uniform vec3 emissive;
+uniform float roughness;
+uniform float metalness;
+uniform float opacity;
+#ifdef IOR
+ uniform float ior;
+#endif
+#ifdef USE_SPECULAR
+ uniform float specularIntensity;
+ uniform vec3 specularColor;
+ #ifdef USE_SPECULAR_COLORMAP
+ uniform sampler2D specularColorMap;
+ #endif
+ #ifdef USE_SPECULAR_INTENSITYMAP
+ uniform sampler2D specularIntensityMap;
+ #endif
+#endif
+#ifdef USE_CLEARCOAT
+ uniform float clearcoat;
+ uniform float clearcoatRoughness;
+#endif
+#ifdef USE_DISPERSION
+ uniform float dispersion;
+#endif
+#ifdef USE_RETROREFLECTION
+ uniform float retroreflectivity;
+#endif
+#ifdef USE_IRIDESCENCE
+ uniform float iridescence;
+ uniform float iridescenceIOR;
+ uniform float iridescenceThicknessMinimum;
+ uniform float iridescenceThicknessMaximum;
+#endif
+#ifdef USE_SHEEN
+ uniform vec3 sheenColor;
+ uniform float sheenRoughness;
+ #ifdef USE_SHEEN_COLORMAP
+ uniform sampler2D sheenColorMap;
+ #endif
+ #ifdef USE_SHEEN_ROUGHNESSMAP
+ uniform sampler2D sheenRoughnessMap;
+ #endif
+#endif
+#ifdef USE_ANISOTROPY
+ uniform vec2 anisotropyVector;
+ #ifdef USE_ANISOTROPYMAP
+ uniform sampler2D anisotropyMap;
+ #endif
+#endif
+varying vec3 vViewPosition;
+#include <common>
+#include <dithering_pars_fragment>
+#include <color_pars_fragment>
+#include <uv_pars_fragment>
+#include <map_pars_fragment>
+#include <alphamap_pars_fragment>
+#include <alphatest_pars_fragment>
+#include <alphahash_pars_fragment>
+#include <aomap_pars_fragment>
+#include <lightmap_pars_fragment>
+#include <emissivemap_pars_fragment>
+#include <iridescence_fragment>
+#include <cube_uv_reflection_fragment>
+#include <envmap_common_pars_fragment>
+#include <envmap_physical_pars_fragment>
+#include <fog_pars_fragment>
+#include <lights_pars_begin>
+#include <normal_pars_fragment>
+#include <lights_physical_pars_fragment>
+#include <transmission_pars_fragment>
+#include <shadowmap_pars_fragment>
+#include <bumpmap_pars_fragment>
+#include <normalmap_pars_fragment>
+#include <clearcoat_pars_fragment>
+#include <iridescence_pars_fragment>
+#include <roughnessmap_pars_fragment>
+#include <metalnessmap_pars_fragment>
+#include <logdepthbuf_pars_fragment>
+#include <clipping_planes_pars_fragment>
+void main() {
+ vec4 diffuseColor = vec4( diffuse, opacity );
+ #include <clipping_planes_fragment>
+ ReflectedLight reflectedLight = ReflectedLight( vec3( 0.0 ), vec3( 0.0 ), vec3( 0.0 ), vec3( 0.0 ) );
+ vec3 totalEmissiveRadiance = emissive;
+ #include <logdepthbuf_fragment>
+ #include <map_fragment>
+ #include <color_fragment>
+ #include <alphamap_fragment>
+ #include <alphatest_fragment>
+ #include <alphahash_fragment>
+ #include <roughnessmap_fragment>
+ #include <metalnessmap_fragment>
+ #include <normal_fragment_begin>
+ #include <normal_fragment_maps>
+ #include <clearcoat_normal_fragment_begin>
+ #include <clearcoat_normal_fragment_maps>
+ #include <emissivemap_fragment>
+ #include <lights_physical_fragment>
+ #include <lights_fragment_begin>
+ #include <lights_fragment_maps>
+ #include <lights_fragment_end>
+ #include <aomap_fragment>
+ vec3 totalDiffuse = reflectedLight.directDiffuse + reflectedLight.indirectDiffuse;
+ vec3 totalSpecular = reflectedLight.directSpecular + reflectedLight.indirectSpecular;
+ #include <transmission_fragment>
+ vec3 outgoingLight = totalDiffuse + totalSpecular + totalEmissiveRadiance;
+ #ifdef USE_SHEEN
+
+ outgoingLight = outgoingLight + sheenSpecularDirect + sheenSpecularIndirect;
+
+ #endif
+ #ifdef USE_CLEARCOAT
+ float dotNVcc = saturate( dot( geometryClearcoatNormal, geometryViewDir ) );
+ vec3 Fcc = F_Schlick( material.clearcoatF0, material.clearcoatF90, dotNVcc );
+ outgoingLight = outgoingLight * ( 1.0 - material.clearcoat * Fcc ) + ( clearcoatSpecularDirect + clearcoatSpecularIndirect ) * material.clearcoat;
+ #endif
+ #include <opaque_fragment>
+ #include <tonemapping_fragment>
+ #include <colorspace_fragment>
+ #include <fog_fragment>
+ #include <premultiplied_alpha_fragment>
+ #include <dithering_fragment>
+}`,meshtoon_vert:`#define TOON
+varying vec3 vViewPosition;
+#include <common>
+#include <batching_pars_vertex>
+#include <uv_pars_vertex>
+#include <displacementmap_pars_vertex>
+#include <color_pars_vertex>
+#include <fog_pars_vertex>
+#include <normal_pars_vertex>
+#include <morphtarget_pars_vertex>
+#include <skinning_pars_vertex>
+#include <shadowmap_pars_vertex>
+#include <logdepthbuf_pars_vertex>
+#include <clipping_planes_pars_vertex>
+void main() {
+ #include <uv_vertex>
+ #include <color_vertex>
+ #include <morphinstance_vertex>
+ #include <morphcolor_vertex>
+ #include <batching_vertex>
+ #include <beginnormal_vertex>
+ #include <morphnormal_vertex>
+ #include <skinbase_vertex>
+ #include <skinnormal_vertex>
+ #include <defaultnormal_vertex>
+ #include <normal_vertex>
+ #include <begin_vertex>
+ #include <morphtarget_vertex>
+ #include <skinning_vertex>
+ #include <displacementmap_vertex>
+ #include <project_vertex>
+ #include <logdepthbuf_vertex>
+ #include <clipping_planes_vertex>
+ vViewPosition = - mvPosition.xyz;
+ #include <worldpos_vertex>
+ #include <shadowmap_vertex>
+ #include <fog_vertex>
+}`,meshtoon_frag:`#define TOON
+uniform vec3 diffuse;
+uniform vec3 emissive;
+uniform float opacity;
+#include <common>
+#include <dithering_pars_fragment>
+#include <color_pars_fragment>
+#include <uv_pars_fragment>
+#include <map_pars_fragment>
+#include <alphamap_pars_fragment>
+#include <alphatest_pars_fragment>
+#include <alphahash_pars_fragment>
+#include <aomap_pars_fragment>
+#include <lightmap_pars_fragment>
+#include <emissivemap_pars_fragment>
+#include <gradientmap_pars_fragment>
+#include <fog_pars_fragment>
+#include <bsdfs>
+#include <lights_pars_begin>
+#include <normal_pars_fragment>
+#include <lights_toon_pars_fragment>
+#include <shadowmap_pars_fragment>
+#include <bumpmap_pars_fragment>
+#include <normalmap_pars_fragment>
+#include <logdepthbuf_pars_fragment>
+#include <clipping_planes_pars_fragment>
+void main() {
+ vec4 diffuseColor = vec4( diffuse, opacity );
+ #include <clipping_planes_fragment>
+ ReflectedLight reflectedLight = ReflectedLight( vec3( 0.0 ), vec3( 0.0 ), vec3( 0.0 ), vec3( 0.0 ) );
+ vec3 totalEmissiveRadiance = emissive;
+ #include <logdepthbuf_fragment>
+ #include <map_fragment>
+ #include <color_fragment>
+ #include <alphamap_fragment>
+ #include <alphatest_fragment>
+ #include <alphahash_fragment>
+ #include <normal_fragment_begin>
+ #include <normal_fragment_maps>
+ #include <emissivemap_fragment>
+ #include <lights_toon_fragment>
+ #include <lights_fragment_begin>
+ #include <lights_fragment_maps>
+ #include <lights_fragment_end>
+ #include <aomap_fragment>
+ vec3 outgoingLight = reflectedLight.directDiffuse + reflectedLight.indirectDiffuse + totalEmissiveRadiance;
+ #include <opaque_fragment>
+ #include <tonemapping_fragment>
+ #include <colorspace_fragment>
+ #include <fog_fragment>
+ #include <premultiplied_alpha_fragment>
+ #include <dithering_fragment>
+}`,points_vert:`uniform float size;
+uniform float scale;
+#include <common>
+#include <color_pars_vertex>
+#include <fog_pars_vertex>
+#include <morphtarget_pars_vertex>
+#include <logdepthbuf_pars_vertex>
+#include <clipping_planes_pars_vertex>
+#ifdef USE_POINTS_UV
+ varying vec2 vUv;
+ uniform mat3 uvTransform;
+#endif
+void main() {
+ #ifdef USE_POINTS_UV
+ vUv = ( uvTransform * vec3( uv, 1 ) ).xy;
+ #endif
+ #include <color_vertex>
+ #include <morphinstance_vertex>
+ #include <morphcolor_vertex>
+ #include <begin_vertex>
+ #include <morphtarget_vertex>
+ #include <project_vertex>
+ gl_PointSize = size;
+ #ifdef USE_SIZEATTENUATION
+ bool isPerspective = isPerspectiveMatrix( projectionMatrix );
+ if ( isPerspective ) gl_PointSize *= ( scale / - mvPosition.z );
+ #endif
+ #include <logdepthbuf_vertex>
+ #include <clipping_planes_vertex>
+ #include <worldpos_vertex>
+ #include <fog_vertex>
+}`,points_frag:`uniform vec3 diffuse;
+uniform float opacity;
+#include <common>
+#include <color_pars_fragment>
+#include <map_particle_pars_fragment>
+#include <alphatest_pars_fragment>
+#include <alphahash_pars_fragment>
+#include <fog_pars_fragment>
+#include <logdepthbuf_pars_fragment>
+#include <clipping_planes_pars_fragment>
+void main() {
+ vec4 diffuseColor = vec4( diffuse, opacity );
+ #include <clipping_planes_fragment>
+ vec3 outgoingLight = vec3( 0.0 );
+ #include <logdepthbuf_fragment>
+ #include <map_particle_fragment>
+ #include <color_fragment>
+ #include <alphatest_fragment>
+ #include <alphahash_fragment>
+ outgoingLight = diffuseColor.rgb;
+ #include <opaque_fragment>
+ #include <tonemapping_fragment>
+ #include <colorspace_fragment>
+ #include <fog_fragment>
+ #include <premultiplied_alpha_fragment>
+}`,shadow_vert:`#include <common>
+#include <batching_pars_vertex>
+#include <fog_pars_vertex>
+#include <morphtarget_pars_vertex>
+#include <skinning_pars_vertex>
+#include <logdepthbuf_pars_vertex>
+#include <shadowmap_pars_vertex>
+void main() {
+ #include <batching_vertex>
+ #include <beginnormal_vertex>
+ #include <morphinstance_vertex>
+ #include <morphnormal_vertex>
+ #include <skinbase_vertex>
+ #include <skinnormal_vertex>
+ #include <defaultnormal_vertex>
+ #include <begin_vertex>
+ #include <morphtarget_vertex>
+ #include <skinning_vertex>
+ #include <project_vertex>
+ #include <logdepthbuf_vertex>
+ #include <worldpos_vertex>
+ #include <shadowmap_vertex>
+ #include <fog_vertex>
+}`,shadow_frag:`uniform vec3 color;
+uniform float opacity;
+#include <common>
+#include <fog_pars_fragment>
+#include <bsdfs>
+#include <lights_pars_begin>
+#include <logdepthbuf_pars_fragment>
+#include <shadowmap_pars_fragment>
+#include <shadowmask_pars_fragment>
+void main() {
+ #include <logdepthbuf_fragment>
+ gl_FragColor = vec4( color, opacity * ( 1.0 - getShadowMask() ) );
+ #include <tonemapping_fragment>
+ #include <colorspace_fragment>
+ #include <fog_fragment>
+ #include <premultiplied_alpha_fragment>
+}`,sprite_vert:`uniform float rotation;
+uniform vec2 center;
+#include <common>
+#include <uv_pars_vertex>
+#include <fog_pars_vertex>
+#include <logdepthbuf_pars_vertex>
+#include <clipping_planes_pars_vertex>
+void main() {
+ #include <uv_vertex>
+ vec4 mvPosition = modelViewMatrix[ 3 ];
+ vec2 scale = vec2( length( modelMatrix[ 0 ].xyz ), length( modelMatrix[ 1 ].xyz ) );
+ #ifndef USE_SIZEATTENUATION
+ bool isPerspective = isPerspectiveMatrix( projectionMatrix );
+ if ( isPerspective ) scale *= - mvPosition.z;
+ #endif
+ vec2 alignedPosition = ( position.xy - ( center - vec2( 0.5 ) ) ) * scale;
+ vec2 rotatedPosition;
+ rotatedPosition.x = cos( rotation ) * alignedPosition.x - sin( rotation ) * alignedPosition.y;
+ rotatedPosition.y = sin( rotation ) * alignedPosition.x + cos( rotation ) * alignedPosition.y;
+ mvPosition.xy += rotatedPosition;
+ gl_Position = projectionMatrix * mvPosition;
+ #include <logdepthbuf_vertex>
+ #include <clipping_planes_vertex>
+ #include <fog_vertex>
+}`,sprite_frag:`uniform vec3 diffuse;
+uniform float opacity;
+#include <common>
+#include <uv_pars_fragment>
+#include <map_pars_fragment>
+#include <alphamap_pars_fragment>
+#include <alphatest_pars_fragment>
+#include <alphahash_pars_fragment>
+#include <fog_pars_fragment>
+#include <logdepthbuf_pars_fragment>
+#include <clipping_planes_pars_fragment>
+void main() {
+ vec4 diffuseColor = vec4( diffuse, opacity );
+ #include <clipping_planes_fragment>
+ vec3 outgoingLight = vec3( 0.0 );
+ #include <logdepthbuf_fragment>
+ #include <map_fragment>
+ #include <alphamap_fragment>
+ #include <alphatest_fragment>
+ #include <alphahash_fragment>
+ outgoingLight = diffuseColor.rgb;
+ #include <opaque_fragment>
+ #include <tonemapping_fragment>
+ #include <colorspace_fragment>
+ #include <fog_fragment>
+}`},$={common:{diffuse:{value:new Z(16777215)},opacity:{value:1},map:{value:null},mapTransform:{value:new J},alphaMap:{value:null},alphaMapTransform:{value:new J},alphaTest:{value:0}},specularmap:{specularMap:{value:null},specularMapTransform:{value:new J}},envmap:{envMap:{value:null},envMapRotation:{value:new J},reflectivity:{value:1},ior:{value:1.5},refractionRatio:{value:.98},dfgLUT:{value:null}},aomap:{aoMap:{value:null},aoMapIntensity:{value:1},aoMapTransform:{value:new J}},lightmap [...]
+
+ precision highp float;
+ precision highp int;
+
+ varying vec3 vOutputDirection;
+
+ uniform sampler2D envMap;
+ uniform float roughness;
+ uniform float mipInt;
+
+ #define ENVMAP_TYPE_CUBE_UV
+ #include <cube_uv_reflection_fragment>
+
+ #define PI 3.14159265359
+
+ // Van der Corput radical inverse
+ float radicalInverse_VdC(uint bits) {
+ bits = (bits << 16u) | (bits >> 16u);
+ bits = ((bits & 0x55555555u) << 1u) | ((bits & 0xAAAAAAAAu) >> 1u);
+ bits = ((bits & 0x33333333u) << 2u) | ((bits & 0xCCCCCCCCu) >> 2u);
+ bits = ((bits & 0x0F0F0F0Fu) << 4u) | ((bits & 0xF0F0F0F0u) >> 4u);
+ bits = ((bits & 0x00FF00FFu) << 8u) | ((bits & 0xFF00FF00u) >> 8u);
+ return float(bits) * 2.3283064365386963e-10; // / 0x100000000
+ }
+
+ // Hammersley sequence
+ vec2 hammersley(uint i, uint N) {
+ return vec2(float(i) / float(N), radicalInverse_VdC(i));
+ }
+
+ // GGX VNDF importance sampling (Eric Heitz 2018)
+ // "Sampling the GGX Distribution of Visible Normals"
+ // https://jcgt.org/published/0007/04/01/
+ vec3 importanceSampleGGX_VNDF(vec2 Xi, vec3 V, float roughness) {
+ float alpha = roughness * roughness;
+
+ // Section 4.1: Orthonormal basis
+ vec3 T1 = vec3(1.0, 0.0, 0.0);
+ vec3 T2 = cross(V, T1);
+
+ // Section 4.2: Parameterization of projected area
+ float r = sqrt(Xi.x);
+ float phi = 2.0 * PI * Xi.y;
+ float t1 = r * cos(phi);
+ float t2 = r * sin(phi);
+ float s = 0.5 * (1.0 + V.z);
+ t2 = (1.0 - s) * sqrt(1.0 - t1 * t1) + s * t2;
+
+ // Section 4.3: Reprojection onto hemisphere
+ vec3 Nh = t1 * T1 + t2 * T2 + sqrt(max(0.0, 1.0 - t1 * t1 - t2 * t2)) * V;
+
+ // Section 3.4: Transform back to ellipsoid configuration
+ return normalize(vec3(alpha * Nh.x, alpha * Nh.y, max(0.0, Nh.z)));
+ }
+
+ void main() {
+ vec3 N = normalize(vOutputDirection);
+ vec3 V = N; // Assume view direction equals normal for pre-filtering
+
+ vec3 prefilteredColor = vec3(0.0);
+ float totalWeight = 0.0;
+
+ // For very low roughness, just sample the environment directly
+ if (roughness < 0.001) {
+ gl_FragColor = vec4(bilinearCubeUV(envMap, N, mipInt), 1.0);
+ return;
+ }
+
+ // Tangent space basis for VNDF sampling
+ vec3 up = abs(N.z) < 0.999 ? vec3(0.0, 0.0, 1.0) : vec3(1.0, 0.0, 0.0);
+ vec3 tangent = normalize(cross(up, N));
+ vec3 bitangent = cross(N, tangent);
+
+ for(uint i = 0u; i < uint(GGX_SAMPLES); i++) {
+ vec2 Xi = hammersley(i, uint(GGX_SAMPLES));
+
+ // For PMREM, V = N, so in tangent space V is always (0, 0, 1)
+ vec3 H_tangent = importanceSampleGGX_VNDF(Xi, vec3(0.0, 0.0, 1.0), roughness);
+
+ // Transform H back to world space
+ vec3 H = normalize(tangent * H_tangent.x + bitangent * H_tangent.y + N * H_tangent.z);
+ vec3 L = normalize(2.0 * dot(V, H) * H - V);
+
+ float NdotL = max(dot(N, L), 0.0);
+
+ if(NdotL > 0.0) {
+ // Sample environment at fixed mip level
+ // VNDF importance sampling handles the distribution filtering
+ vec3 sampleColor = bilinearCubeUV(envMap, L, mipInt);
+
+ // Weight by NdotL for the split-sum approximation
+ // VNDF PDF naturally accounts for the visible microfacet distribution
+ prefilteredColor += sampleColor * NdotL;
+ totalWeight += NdotL;
+ }
+ }
+
+ if (totalWeight > 0.0) {
+ prefilteredColor = prefilteredColor / totalWeight;
+ }
+
+ gl_FragColor = vec4(prefilteredColor, 1.0);
+ }
+ `,blending:0,depthTest:!1,depthWrite:!1})}function ya(e,t,n){return new Nr({name:`SphericalGaussianBlur`,defines:{SAMPLES:ia,CUBEUV_TEXEL_WIDTH:1/t,CUBEUV_TEXEL_HEIGHT:1/n,CUBEUV_MAX_MIP:`${e}.0`},uniforms:{envMap:{value:null},sigma:{value:0},mipInt:{value:0}},vertexShader:Sa(),fragmentShader:`
+
+ precision highp float;
+ precision highp int;
+
+ varying vec3 vOutputDirection;
+
+ uniform sampler2D envMap;
+ uniform float sigma;
+ uniform float mipInt;
+
+ #define ENVMAP_TYPE_CUBE_UV
+ #include <cube_uv_reflection_fragment>
+
+ #define PI 3.14159265359
+ #define GOLDEN_ANGLE 2.39996322973
+
+ void main() {
+
+ if ( sigma == 0.0 ) {
+
+ gl_FragColor = vec4( bilinearCubeUV( envMap, vOutputDirection, mipInt ), 1.0 );
+ return;
+
+ }
+
+ vec3 outputDirection = normalize( vOutputDirection );
+
+ vec3 up = abs( outputDirection.z ) < 0.999 ? vec3( 0.0, 0.0, 1.0 ) : vec3( 1.0, 0.0, 0.0 );
+ vec3 tangent = normalize( cross( up, outputDirection ) );
+ vec3 bitangent = cross( outputDirection, tangent );
+
+ // Truncate the kernel at three standard deviations or at the antipode.
+ float thetaMax = min( 3.0 * sigma, PI );
+ float truncation = 1.0 - exp( - 0.5 * thetaMax * thetaMax / ( sigma * sigma ) );
+
+ vec3 accumColor = vec3( 0.0 );
+ float accumWeight = 0.0;
+
+ for ( int i = 0; i < SAMPLES; i ++ ) {
+
+ // Stratified inverse-CDF sampling of the Gaussian, placed on a golden-angle spiral.
+ float stratum = ( float( i ) + 0.5 ) / float( SAMPLES );
+ float theta = sigma * sqrt( - 2.0 * log( 1.0 - stratum * truncation ) );
+ float phi = float( i ) * GOLDEN_ANGLE;
+
+ vec3 offset = cos( phi ) * tangent + sin( phi ) * bitangent;
+ vec3 sampleDirection = cos( theta ) * outputDirection + sin( theta ) * offset;
+
+ // Correct the planar sample density to solid angle.
+ float weight = sin( theta ) / theta;
+
+ accumColor += weight * bilinearCubeUV( envMap, sampleDirection, mipInt );
+ accumWeight += weight;
+
+ }
+
+ gl_FragColor = vec4( accumColor / accumWeight, 1.0 );
+
+ }
+ `,blending:0,depthTest:!1,depthWrite:!1})}function ba(){return new Nr({name:`EquirectangularToCubeUV`,uniforms:{envMap:{value:null}},vertexShader:Sa(),fragmentShader:`
+
+ precision mediump float;
+ precision mediump int;
+
+ varying vec3 vOutputDirection;
+
+ uniform sampler2D envMap;
+
+ #include <common>
+
+ void main() {
+
+ vec3 outputDirection = normalize( vOutputDirection );
+ vec2 uv = equirectUv( outputDirection );
+
+ gl_FragColor = vec4( texture2D ( envMap, uv ).rgb, 1.0 );
+
+ }
+ `,blending:0,depthTest:!1,depthWrite:!1})}function xa(){return new Nr({name:`CubemapToCubeUV`,uniforms:{envMap:{value:null},flipEnvMap:{value:-1}},vertexShader:Sa(),fragmentShader:`
+
+ precision mediump float;
+ precision mediump int;
+
+ uniform float flipEnvMap;
+
+ varying vec3 vOutputDirection;
+
+ uniform samplerCube envMap;
+
+ void main() {
+
+ gl_FragColor = textureCube( envMap, vec3( flipEnvMap * vOutputDirection.x, vOutputDirection.yz ) );
+
+ }
+ `,blending:0,depthTest:!1,depthWrite:!1})}function Sa(){return`
+
+ precision mediump float;
+ precision mediump int;
+
+ attribute vec3 outputDirection;
+
+ varying vec3 vOutputDirection;
+
+ void main() {
+
+ vOutputDirection = outputDirection;
+ gl_Position = vec4( position, 1.0 );
+
+ }
+ `}var Ca=class extends Xe{constructor(e=1,t={}){super(e,e,t),this.isWebGLCubeRenderTarget=!0;let n={width:e,height:e,depth:1},r=[n,n,n,n,n,n];this.texture=new cr(r),this._setTextureOptions(t),this.texture.isRenderTargetTexture=!0}fromEquirectangularTexture(e,t){this.texture.type=t.type,this.texture.colorSpace=t.colorSpace,this.texture.generateMipmaps=t.generateMipmaps,this.texture.minFilter=t.minFilter,this.texture.magFilter=t.magFilter;let n={uniforms:{tEquirect:{value:null}},vertexShader:`
+
+ varying vec3 vWorldDirection;
+
+ vec3 transformDirection( in vec3 dir, in mat4 matrix ) {
+
+ return normalize( ( matrix * vec4( dir, 0.0 ) ).xyz );
+
+ }
+
+ void main() {
+
+ vWorldDirection = transformDirection( position, modelMatrix );
+
+ #include <begin_vertex>
+ #include <project_vertex>
+
+ }
+ `,fragmentShader:`
+
+ uniform sampler2D tEquirect;
+
+ varying vec3 vWorldDirection;
+
+ #include <common>
+
+ void main() {
+
+ vec3 direction = normalize( vWorldDirection );
+
+ vec2 sampleUV = equirectUv( direction );
+
+ gl_FragColor = texture2D( tEquirect, sampleUV );
+
+ }
+ `},r=new fr(5,5,5),i=new Nr({name:`CubemapFromEquirect`,uniforms:Tr(n.uniforms),vertexShader:n.vertexShader,fragmentShader:n.fragmentShader,side:1,blending:0});i.uniforms.tEquirect.value=t;let a=new er(r,i),o=t.minFilter;return t.minFilter===1008&&(t.minFilter=s),new Ti(1,10,this).update(e,a),t.minFilter=o,a.geometry.dispose(),a.material.dispose(),this}clear(e,t=!0,n=!0,r=!0){let i=e.getRenderTarget();for(let i=0;i<6;i++)e.setRenderTarget(this,i),e.clear(t,n,r);e.setRenderTarget(i)}}; [...]
+ precision highp float;
+
+ uniform mat4 modelViewMatrix;
+ uniform mat4 projectionMatrix;
+
+ attribute vec3 position;
+ attribute vec2 uv;
+
+ varying vec2 vUv;
+
+ void main() {
+ vUv = uv;
+ gl_Position = projectionMatrix * modelViewMatrix * vec4( position, 1.0 );
+ }`,fragmentShader:`
+ precision highp float;
+
+ uniform sampler2D tDiffuse;
+
+ varying vec2 vUv;
+
+ #include <tonemapping_pars_fragment>
+ #include <colorspace_pars_fragment>
+
+ void main() {
+ gl_FragColor = texture2D( tDiffuse, vUv );
+
+ #ifdef LINEAR_TONE_MAPPING
+ gl_FragColor.rgb = LinearToneMapping( gl_FragColor.rgb );
+ #elif defined( REINHARD_TONE_MAPPING )
+ gl_FragColor.rgb = ReinhardToneMapping( gl_FragColor.rgb );
+ #elif defined( CINEON_TONE_MAPPING )
+ gl_FragColor.rgb = CineonToneMapping( gl_FragColor.rgb );
+ #elif defined( ACES_FILMIC_TONE_MAPPING )
+ gl_FragColor.rgb = ACESFilmicToneMapping( gl_FragColor.rgb );
+ #elif defined( AGX_TONE_MAPPING )
+ gl_FragColor.rgb = AgXToneMapping( gl_FragColor.rgb );
+ #elif defined( NEUTRAL_TONE_MAPPING )
+ gl_FragColor.rgb = NeutralToneMapping( gl_FragColor.rgb );
+ #elif defined( CUSTOM_TONE_MAPPING )
+ gl_FragColor.rgb = CustomToneMapping( gl_FragColor.rgb );
+ #endif
+
+ #ifdef SRGB_TRANSFER
+ gl_FragColor = sRGBTransferOETF( gl_FragColor );
+ #endif
+ }`,depthTest:!1,depthWrite:!1}),d=new er(l,u),f=new bi(-1,1,1,-1,0,1),m=null,h=null,g=!1,_,v=null,y=[],b=!1;this.setSize=function(e,t){o.setSize(e,t),s!==null&&s.setSize(e,t),c!==null&&c.setSize(e,t);for(let n=0;n<y.length;n++){let r=y[n];r.setSize&&r.setSize(e,t)}},this.setEffects=function(e){y=e,b=y.length>0&&y[0].isRenderPass===!0;let t=o.width,n=o.height;y.length>0&&s===null&&(s=new Xe(t,n,{type:p,depthBuffer:!1,stencilBuffer:!1}),c=new Xe(t,n,{type:p,depthBuffer:!1,stencilBuffer: [...]
+`),r=[],i=Math.max(t-6,0),a=Math.min(t+6,n.length);for(let e=i;e<a;e++){let i=e+1;r.push(`${i===t?`>`:` `} ${i}: ${n[e]}`)}return r.join(`
+`)}var Go=new J;function Ko(e){X._getMatrix(Go,X.workingColorSpace,e);let t=`mat3( ${Go.elements.map(e=>e.toFixed(4))} )`;switch(X.getTransfer(e)){case N:return[t,`LinearTransferOETF`];case P:return[t,`sRGBTransferOETF`];default:return B(`WebGLProgram: Unsupported color space: `,e),[t,`LinearTransferOETF`]}}function qo(e,t,n){let r=e.getShaderParameter(t,e.COMPILE_STATUS),i=(e.getShaderInfoLog(t)||``).trim();if(r&&i===``)return``;let a=/ERROR: 0:(\d+)/.exec(i);if(a){let r=parseInt(a[1]); [...]
+
+`+i+`
+
+`+Wo(e.getShaderSource(t),r)}else return i}function Jo(e,t){let n=Ko(t);return[`vec4 ${e}( vec4 value ) {`,` return ${n[1]}( vec4( value.rgb * ${n[0]}, value.a ) );`,`}`].join(`
+`)}var Yo={1:`Linear`,2:`Reinhard`,3:`Cineon`,4:`ACESFilmic`,6:`AgX`,7:`Neutral`,5:`Custom`};function Xo(e,t){let n=Yo[t];return n===void 0?(B(`WebGLProgram: Unsupported toneMapping:`,t),`vec3 `+e+`( vec3 color ) { return LinearToneMapping( color ); }`):`vec3 `+e+`( vec3 color ) { return `+n+`ToneMapping( color ); }`}var Zo=new K;function Qo(){return X.getLuminanceCoefficients(Zo),[`float luminance( const in vec3 rgb ) {`,` const vec3 weights = vec3( ${Zo.x.toFixed(4)}, ${Zo.y.toFixed(4) [...]
+`)}function $o(e){return[e.extensionClipCullDistance?`#extension GL_ANGLE_clip_cull_distance : require`:``,e.extensionMultiDraw?`#extension GL_ANGLE_multi_draw : require`:``].filter(ns).join(`
+`)}function es(e){let t=[];for(let n in e){let r=e[n];r!==!1&&t.push(`#define `+n+` `+r)}return t.join(`
+`)}function ts(e,t){let n={},r=e.getProgramParameter(t,e.ACTIVE_ATTRIBUTES);for(let i=0;i<r;i++){let r=e.getActiveAttrib(t,i),a=r.name,o=1;r.type===e.FLOAT_MAT2&&(o=2),r.type===e.FLOAT_MAT3&&(o=3),r.type===e.FLOAT_MAT4&&(o=4),n[a]={type:r.type,location:e.getAttribLocation(t,a),locationSize:o}}return n}function ns(e){return e!==``}function rs(e,t){let n=t.numSpotLightShadows+t.numSpotLightMaps-t.numSpotLightShadowsWithMaps;return e.replace(/NUM_SUN_LIGHTS/g,t.numSunLights).replace(/NUM_DI [...]
+ precision ${e.precision} int;
+ precision ${e.precision} sampler2D;
+ precision ${e.precision} samplerCube;
+ precision ${e.precision} sampler3D;
+ precision ${e.precision} sampler2DArray;
+ precision ${e.precision} sampler2DShadow;
+ precision ${e.precision} samplerCubeShadow;
+ precision ${e.precision} sampler2DArrayShadow;
+ precision ${e.precision} isampler2D;
+ precision ${e.precision} isampler3D;
+ precision ${e.precision} isamplerCube;
+ precision ${e.precision} isampler2DArray;
+ precision ${e.precision} usampler2D;
+ precision ${e.precision} usampler3D;
+ precision ${e.precision} usamplerCube;
+ precision ${e.precision} usampler2DArray;
+ `;return e.precision===`highp`?t+=`
+#define HIGH_PRECISION`:e.precision===`mediump`?t+=`
+#define MEDIUM_PRECISION`:e.precision===`lowp`&&(t+=`
+#define LOW_PRECISION`),t}var ps={1:`SHADOWMAP_TYPE_PCF`,3:`SHADOWMAP_TYPE_VSM`};function ms(e){return ps[e.shadowMapType]||`SHADOWMAP_TYPE_BASIC`}var hs={301:`ENVMAP_TYPE_CUBE`,302:`ENVMAP_TYPE_CUBE`,306:`ENVMAP_TYPE_CUBE_UV`};function gs(e){return e.envMap===!1?`ENVMAP_TYPE_CUBE`:hs[e.envMapMode]||`ENVMAP_TYPE_CUBE`}var _s={302:`ENVMAP_MODE_REFRACTION`};function vs(e){return e.envMap===!1?`ENVMAP_MODE_REFLECTION`:_s[e.envMapMode]||`ENVMAP_MODE_REFLECTION`}var ys={0:`ENVMAP_BLENDING_MUL [...]
+`:``;n.isRawShaderMaterial?(g=[`#define SHADER_TYPE `+n.shaderType,`#define SHADER_NAME `+n.shaderName,m].filter(ns).join(`
+`),g.length>0&&(g+=`
+`),_=[`#define SHADER_TYPE `+n.shaderType,`#define SHADER_NAME `+n.shaderName,m].filter(ns).join(`
+`),_.length>0&&(_+=`
+`)):(g=[fs(n),`#define SHADER_TYPE `+n.shaderType,`#define SHADER_NAME `+n.shaderName,m,n.extensionClipCullDistance?`#define USE_CLIP_DISTANCE`:``,n.batching?`#define USE_BATCHING`:``,n.batchingColor?`#define USE_BATCHING_COLOR`:``,n.instancing?`#define USE_INSTANCING`:``,n.instancingColor?`#define USE_INSTANCING_COLOR`:``,n.instancingMorph?`#define USE_INSTANCING_MORPH`:``,n.useFog&&n.fog?`#define USE_FOG`:``,n.useFog&&n.fogExp2?`#define FOG_EXP2`:``,n.map?`#define USE_MAP`:``,n.envMap? [...]
+`].filter(ns).join(`
+`),_=[fs(n),`#define SHADER_TYPE `+n.shaderType,`#define SHADER_NAME `+n.shaderName,m,n.useFog&&n.fog?`#define USE_FOG`:``,n.useFog&&n.fogExp2?`#define FOG_EXP2`:``,n.alphaToCoverage?`#define ALPHA_TO_COVERAGE`:``,n.map?`#define USE_MAP`:``,n.matcap?`#define USE_MATCAP`:``,n.envMap?`#define USE_ENVMAP`:``,n.envMap?`#define `+l:``,n.envMap?`#define `+u:``,n.envMap?`#define `+d:``,f?`#define CUBEUV_TEXEL_WIDTH `+f.texelWidth:``,f?`#define CUBEUV_TEXEL_HEIGHT `+f.texelHeight:``,f?`#define C [...]
+`].filter(ns).join(`
+`)),o=os(o),o=rs(o,n),o=is(o,n),s=os(s),s=rs(s,n),s=is(s,n),o=us(o),s=us(s),n.isRawShaderMaterial!==!0&&(v=`#version 300 es
+`,g=[p,`#define attribute in`,`#define varying out`,`#define texture2D texture`].join(`
+`)+`
+`+g,_=[`#define varying in`,n.glslVersion===`300 es`?``:`layout(location = 0) out highp vec4 pc_fragColor;`,n.glslVersion===`300 es`?``:`#define gl_FragColor pc_fragColor`,`#define gl_FragDepthEXT gl_FragDepth`,`#define texture2D texture`,`#define textureCube texture`,`#define texture2DProj textureProj`,`#define texture2DLodEXT textureLod`,`#define texture2DProjLodEXT textureProjLod`,`#define textureCubeLodEXT textureLod`,`#define texture2DGradEXT textureGrad`,`#define texture2DProjGradE [...]
+`)+`
+`+_);let y=v+g+o,b=v+_+s,x=Vo(i,i.VERTEX_SHADER,y),S=Vo(i,i.FRAGMENT_SHADER,b);i.attachShader(h,x),i.attachShader(h,S),n.index0AttributeName===void 0?n.hasPositionAttribute===!0&&i.bindAttribLocation(h,0,`position`):i.bindAttribLocation(h,0,n.index0AttributeName),i.linkProgram(h);function C(t){if(e.debug.checkShaderErrors){let n=i.getProgramInfoLog(h)||``,r=i.getShaderInfoLog(x)||``,a=i.getShaderInfoLog(S)||``,o=n.trim(),s=r.trim(),c=a.trim(),l=!0,u=!0;if(i.getProgramParameter(h,i.LINK_S [...]
+
+Material Name: `+t.name+`
+Material Type: `+t.type+`
+
+Program Info Log: `+o+`
+`+e+`
+`+n)}else o===``?(s===``||c===``)&&(u=!1):B(`WebGLProgram: Program Info Log:`,o);u&&(t.diagnostics={runnable:l,programLog:o,vertexShader:{log:s,prefix:g},fragmentShader:{log:c,prefix:_}})}i.deleteShader(x),i.deleteShader(S),w=new Bo(i,h),T=ts(i,h)}let w;this.getUniforms=function(){return w===void 0&&C(this),w};let T;this.getAttributes=function(){return T===void 0&&C(this),T};let E=n.rendererExtensionParallelShaderCompile===!1;return this.isReady=function(){return E===!1&&(E=i.getProgramP [...]
+ gl_Position = vec4( position, 1.0 );
+}`,Vs=`uniform sampler2D shadow_pass;
+uniform vec2 resolution;
+uniform float radius;
+void main() {
+ const float samples = float( VSM_SAMPLES );
+ float mean = 0.0;
+ float squared_mean = 0.0;
+ float uvStride = samples <= 1.0 ? 0.0 : 2.0 / ( samples - 1.0 );
+ float uvStart = samples <= 1.0 ? 0.0 : - 1.0;
+ for ( float i = 0.0; i < samples; i ++ ) {
+ float uvOffset = uvStart + i * uvStride;
+ #ifdef HORIZONTAL_PASS
+ vec2 distribution = texture2D( shadow_pass, ( gl_FragCoord.xy + vec2( uvOffset, 0.0 ) * radius ) / resolution ).rg;
+ mean += distribution.x;
+ squared_mean += distribution.y * distribution.y + distribution.x * distribution.x;
+ #else
+ float depth = texture2D( shadow_pass, ( gl_FragCoord.xy + vec2( 0.0, uvOffset ) * radius ) / resolution ).r;
+ mean += depth;
+ squared_mean += depth * depth;
+ #endif
+ }
+ mean = mean / samples;
+ squared_mean = squared_mean / samples;
+ float std_dev = sqrt( max( 0.0, squared_mean - mean * mean ) );
+ gl_FragColor = vec4( mean, std_dev, 0.0, 1.0 );
+}`,Hs=[new K(1,0,0),new K(-1,0,0),new K(0,1,0),new K(0,-1,0),new K(0,0,1),new K(0,0,-1)],Us=[new K(0,-1,0),new K(0,-1,0),new K(0,0,1),new K(0,0,-1),new K(0,-1,0),new K(0,-1,0)],Ws=new $e,Gs=new K,Ks=new K;function qs(e,t,n){let r=new sr,i=new G,a=new G,c=new Je,l=new Lr,u=new Rr,m={},h=n.maxTextureSize,g={0:1,1:0,2:2},_=new Nr({defines:{VSM_SAMPLES:8},uniforms:{shadow_pass:{value:null},resolution:{value:new G},radius:{value:4}},vertexShader:Bs,fragmentShader:Vs}),y=_.clone();y.defines.HO [...]
+void main() {
+
+ gl_Position = vec4( position, 1.0 );
+
+}`,Qs=`
+uniform sampler2DArray depthColor;
+uniform float depthWidth;
+uniform float depthHeight;
+
+void main() {
+
+ vec2 coord = vec2( gl_FragCoord.x / depthWidth, gl_FragCoord.y / depthHeight );
+
+ if ( coord.x >= 1.0 ) {
+
+ gl_FragDepth = texture( depthColor, vec3( coord.x - 1.0, coord.y, 1 ) ).r;
+
+ } else {
+
+ gl_FragDepth = texture( depthColor, vec3( coord.x, coord.y, 0 ) ).r;
+
+ }
+
+}`,$s=class{constructor(){this.texture=null,this.mesh=null,this.depthNear=0,this.depthFar=0}init(e,t){if(this.texture===null){let n=new dr(e.texture);(e.depthNear!==t.depthNear||e.depthFar!==t.depthFar)&&(this.depthNear=e.depthNear,this.depthFar=e.depthFar),this.texture=n}}getMesh(e){if(this.texture!==null&&this.mesh===null){let t=e.cameras[0].viewport,n=new Nr({vertexShader:Zs,fragmentShader:Qs,uniforms:{depthColor:{value:this.texture},depthWidth:{value:t.z},depthHeight:{value:t.w}}});t [...]
\ No newline at end of file
diff --git a/animation-test/index.html b/animation-test/index.html
new file mode 100644
index 0000000..2f86b7d
--- /dev/null
+++ b/animation-test/index.html
@@ -0,0 +1 @@
+<!DOCTYPE html><html lang="pt-BR"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><meta name="robots" content="noindex, nofollow"><title>Magpie | Teste de animação</title><link rel="stylesheet" href="/_astro/animation-test.CneHVBNE.css"></head><body><style>astro-island,astro-slot,astro-static-slot{display:contents}</style><script>(()=>{var e=async t=>{await(await t())()};(self.Astro||(self.Astro={})).load=e;window.dispatchEvent(new Event("a [...]
\ No newline at end of file
diff --git a/architecture/index.html b/architecture/index.html
new file mode 100644
index 0000000..cf7e407
--- /dev/null
+++ b/architecture/index.html
@@ -0,0 +1,75 @@
+<!DOCTYPE html><html lang="en" data-astro-cid-z4jru4n3><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="description" content="Apache Magpie's architecture: skills declare capabilities, tools provide contract and substrate interfaces, adapters implement them, and organizations bundle the defaults. Generated from the framework repo."><link rel="icon" type="image/svg+xml" href="/favicon.svg"><link rel="icon" type="image/x-icon" si [...]
+ var _paq = (window._paq = window._paq || []);
+ /* tracker methods like "setCustomDimension" should be called before "trackPageView" */
+ _paq.push(["setDoNotTrack", true]);
+ _paq.push(["disableCookies"]);
+ _paq.push(["trackPageView"]);
+ _paq.push(["enableLinkTracking"]);
+ (function () {
+ var u = "https://analytics.apache.org/";
+ _paq.push(["setTrackerUrl", u + "matomo.php"]);
+ _paq.push(["setSiteId", "89"]);
+ var d = document,
+ g = d.createElement("script"),
+ s = d.getElementsByTagName("script")[0];
+ g.async = true;
+ g.src = u + "matomo.js";
+ s.parentNode.insertBefore(g, s);
+ })();
+ </script><link rel="stylesheet" href="/_astro/BaseLayout.H4DLRpYn.css"></head><body data-astro-cid-z4jru4n3><nav class="relative z-10 flex w-full items-center justify-between bg-default-background px-8 py-5 mobile:px-4"><a href="/" aria-label="Apache Magpie home" class="flex items-end justify-end gap-2 px-2 py-2"><img class="h-10 w-10 flex-none object-cover" src="/subframe-mark.svg" alt="Apache Magpie"/><img class="h-10 flex-none object-contain" src="/subframe-wordmark.png" alt="Magp [...]
+ │ the capability is the only coupling
+ TOOL ──provides──▶ contract:tracker ─┘ (skills never branch on the backend)
+ │
+ ├─ contract:* one per capability seam → an ADAPTER implements it for a vendor
+ └─ substrate:* framework plumbing (sandbox, privacy, analytics, …)
+
+ ORGANIZATION (ASF, independent, …) ──bundles──▶ which adapter fulfils each capability
+ + governance vocabulary + identity/logo</pre></div></div></section><!-- Skill capabilities --><section id="skill-capabilities" class="w-full px-8 py-16 mobile:px-4 mobile:py-12 bg-default-background scroll-mt-14"><div class="mx-auto flex w-full max-w-[1100px] flex-col gap-5"><div class="flex flex-col gap-1"><h2 class="text-heading-2 font-heading-2 text-default-font">Skill capabilities</h2><p class="text-body font-body text-subtext-color [...]
+ (() => {
+ const links = [...document.querySelectorAll("[data-arch-link]")];
+ if (!links.length) return;
+ let current = null;
+ const setActive = (id) => {
+ if (id === current) return;
+ current = id;
+ for (const a of links) {
+ const on = a.getAttribute("data-arch-link") === id;
+ a.classList.toggle("bg-brand-100", on);
+ a.classList.toggle("text-brand-800", on);
+ a.classList.toggle("text-default-font", !on);
+ if (on) a.setAttribute("aria-current", "true");
+ else a.removeAttribute("aria-current");
+ }
+ };
+ const ids = links.map((a) => a.getAttribute("data-arch-link"));
+ const lastId = ids[ids.length - 1];
+ const sections = ids.map((id) => document.getElementById(id)).filter(Boolean);
+
+ // Near the bottom the last section can never reach the top active-band, so
+ // the observer would otherwise leave a higher section highlighted. Force
+ // the last item active whenever the page can't scroll any further.
+ const atBottom = () =>
+ window.innerHeight + Math.ceil(window.scrollY) >=
+ document.documentElement.scrollHeight - 2;
+
+ const obs = new IntersectionObserver(
+ (entries) => {
+ if (atBottom()) return setActive(lastId);
+ const visible = entries.filter((e) => e.isIntersecting);
+ if (!visible.length) return;
+ visible.sort((a, b) => a.boundingClientRect.top - b.boundingClientRect.top);
+ setActive(visible[0].target.id);
+ },
+ { rootMargin: "-10% 0px -80% 0px", threshold: 0 },
+ );
+ for (const s of sections) obs.observe(s);
+ window.addEventListener("scroll", () => { if (atBottom()) setActive(lastId); }, { passive: true });
+
+ // Clicking a nav item highlights it right away and keeps it highlighted —
+ // important for short sections (e.g. the last one) that the scroll-spy's
+ // active-band can't reach.
+ for (const a of links) {
+ a.addEventListener("click", () => setActive(a.getAttribute("data-arch-link")));
+ }
+ })();
+ </script><a href="https://github.com/apache/magpie-site/edit/main/src/pages/architecture.astro" target="_blank" rel="noopener noreferrer" class="suggest-change" aria-label="Suggest a change to this page on GitHub" data-astro-cid-z4jru4n3><svg viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" data-astro-cid-z4jru4n3><path d="M12 20h9" data-astro-cid-z4jru4n3></path><path d="M16. [...]
\ No newline at end of file
diff --git a/brand/avatar-1000.png b/brand/avatar-1000.png
new file mode 100644
index 0000000..9a39fa5
Binary files /dev/null and b/brand/avatar-1000.png differ
diff --git a/brand/avatar-400.png b/brand/avatar-400.png
new file mode 100644
index 0000000..6d6b0f5
Binary files /dev/null and b/brand/avatar-400.png differ
diff --git a/brand/banner-1500x500.png b/brand/banner-1500x500.png
new file mode 100644
index 0000000..30b8985
Binary files /dev/null and b/brand/banner-1500x500.png differ
diff --git a/brand/banner-bluesky-3000x1000.png b/brand/banner-bluesky-3000x1000.png
new file mode 100644
index 0000000..8a5f65f
Binary files /dev/null and b/brand/banner-bluesky-3000x1000.png differ
diff --git a/brand/banner-linkedin-1128x191.png b/brand/banner-linkedin-1128x191.png
new file mode 100644
index 0000000..6e5fbc8
Binary files /dev/null and b/brand/banner-linkedin-1128x191.png differ
diff --git a/brand/index.html b/brand/index.html
new file mode 100644
index 0000000..1df1dd9
--- /dev/null
+++ b/brand/index.html
@@ -0,0 +1,19 @@
+<!DOCTYPE html><html lang="en" data-astro-cid-z4jru4n3><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="description" content="The Apache Magpie brand book: logo and mark, color palette, typography, and ready-to-use social-media avatars and banners for X, LinkedIn, Fosstodon/Mastodon and Bluesky."><link rel="icon" type="image/svg+xml" href="/favicon.svg"><link rel="icon" type="image/x-icon" sizes="any" href="/favicon.ico"><title [...]
+ var _paq = (window._paq = window._paq || []);
+ /* tracker methods like "setCustomDimension" should be called before "trackPageView" */
+ _paq.push(["setDoNotTrack", true]);
+ _paq.push(["disableCookies"]);
+ _paq.push(["trackPageView"]);
+ _paq.push(["enableLinkTracking"]);
+ (function () {
+ var u = "https://analytics.apache.org/";
+ _paq.push(["setTrackerUrl", u + "matomo.php"]);
+ _paq.push(["setSiteId", "89"]);
+ var d = document,
+ g = d.createElement("script"),
+ s = d.getElementsByTagName("script")[0];
+ g.async = true;
+ g.src = u + "matomo.js";
+ s.parentNode.insertBefore(g, s);
+ })();
+ </script><link rel="stylesheet" href="/_astro/BaseLayout.H4DLRpYn.css"></head><body data-astro-cid-z4jru4n3><nav class="relative z-10 flex w-full items-center justify-between bg-default-background px-8 py-5 mobile:px-4"><a href="/" aria-label="Apache Magpie home" class="flex items-end justify-end gap-2 px-2 py-2"><img class="h-10 w-10 flex-none object-cover" src="/subframe-mark.svg" alt="Apache Magpie"/><img class="h-10 flex-none object-contain" src="/subframe-wordmark.png" alt="Magp [...]
\ No newline at end of file
diff --git a/community-avatars/CalvinKirs.png b/community-avatars/CalvinKirs.png
new file mode 100644
index 0000000..8b8e5d4
Binary files /dev/null and b/community-avatars/CalvinKirs.png differ
diff --git a/community-avatars/RussellSpitzer.png b/community-avatars/RussellSpitzer.png
new file mode 100644
index 0000000..af1abd6
Binary files /dev/null and b/community-avatars/RussellSpitzer.png differ
diff --git a/community-avatars/amoghrajesh.png b/community-avatars/amoghrajesh.png
new file mode 100644
index 0000000..852471f
Binary files /dev/null and b/community-avatars/amoghrajesh.png differ
diff --git a/community-avatars/andreahlert.png b/community-avatars/andreahlert.png
new file mode 100644
index 0000000..a96535f
Binary files /dev/null and b/community-avatars/andreahlert.png differ
diff --git a/community-avatars/andrewmusselman.png b/community-avatars/andrewmusselman.png
new file mode 100644
index 0000000..8e40e77
Binary files /dev/null and b/community-avatars/andrewmusselman.png differ
diff --git a/community-avatars/choo121600.png b/community-avatars/choo121600.png
new file mode 100644
index 0000000..041c0ae
Binary files /dev/null and b/community-avatars/choo121600.png differ
diff --git a/community-avatars/clr-apache.png b/community-avatars/clr-apache.png
new file mode 100644
index 0000000..30e0202
Binary files /dev/null and b/community-avatars/clr-apache.png differ
diff --git a/community-avatars/csutherl.png b/community-avatars/csutherl.png
new file mode 100644
index 0000000..d386755
Binary files /dev/null and b/community-avatars/csutherl.png differ
diff --git a/community-avatars/eladkal.png b/community-avatars/eladkal.png
new file mode 100644
index 0000000..70fbfd4
Binary files /dev/null and b/community-avatars/eladkal.png differ
diff --git a/community-avatars/gopidesupavan.png b/community-avatars/gopidesupavan.png
new file mode 100644
index 0000000..2b3e9c0
Binary files /dev/null and b/community-avatars/gopidesupavan.png differ
diff --git a/community-avatars/iemejia.png b/community-avatars/iemejia.png
new file mode 100644
index 0000000..69fa30c
Binary files /dev/null and b/community-avatars/iemejia.png differ
diff --git a/community-avatars/jamesfredley.png b/community-avatars/jamesfredley.png
new file mode 100644
index 0000000..a3e92ef
Binary files /dev/null and b/community-avatars/jamesfredley.png differ
diff --git a/community-avatars/jbonofre.png b/community-avatars/jbonofre.png
new file mode 100644
index 0000000..6a8c1ce
Binary files /dev/null and b/community-avatars/jbonofre.png differ
diff --git a/community-avatars/justinmclean.png b/community-avatars/justinmclean.png
new file mode 100644
index 0000000..35f8a2a
Binary files /dev/null and b/community-avatars/justinmclean.png differ
diff --git a/community-avatars/madrob.png b/community-avatars/madrob.png
new file mode 100644
index 0000000..4e290bf
Binary files /dev/null and b/community-avatars/madrob.png differ
diff --git a/community-avatars/onlyarnav.png b/community-avatars/onlyarnav.png
new file mode 100644
index 0000000..6d5d22a
Binary files /dev/null and b/community-avatars/onlyarnav.png differ
diff --git a/community-avatars/paulk-asert.png b/community-avatars/paulk-asert.png
new file mode 100644
index 0000000..ec7a550
Binary files /dev/null and b/community-avatars/paulk-asert.png differ
diff --git a/community-avatars/potiuk.png b/community-avatars/potiuk.png
new file mode 100644
index 0000000..32a2e8e
Binary files /dev/null and b/community-avatars/potiuk.png differ
diff --git a/community-avatars/ppkarwasz.png b/community-avatars/ppkarwasz.png
new file mode 100644
index 0000000..871ba0e
Binary files /dev/null and b/community-avatars/ppkarwasz.png differ
diff --git a/community-avatars/rbowen.png b/community-avatars/rbowen.png
new file mode 100644
index 0000000..6741308
Binary files /dev/null and b/community-avatars/rbowen.png differ
diff --git a/community-avatars/rmaucher.png b/community-avatars/rmaucher.png
new file mode 100644
index 0000000..58c5a6d
Binary files /dev/null and b/community-avatars/rmaucher.png differ
diff --git a/community-avatars/rusackas.png b/community-avatars/rusackas.png
new file mode 100644
index 0000000..37eedb1
Binary files /dev/null and b/community-avatars/rusackas.png differ
diff --git a/community-avatars/rzo1.png b/community-avatars/rzo1.png
new file mode 100644
index 0000000..23e350d
Binary files /dev/null and b/community-avatars/rzo1.png differ
diff --git a/community-avatars/tisonkun.png b/community-avatars/tisonkun.png
new file mode 100644
index 0000000..eead4fa
Binary files /dev/null and b/community-avatars/tisonkun.png differ
diff --git a/community-avatars/zeroshade.png b/community-avatars/zeroshade.png
new file mode 100644
index 0000000..9abe36b
Binary files /dev/null and b/community-avatars/zeroshade.png differ
diff --git a/demo/index.html b/demo/index.html
new file mode 100644
index 0000000..67741bf
--- /dev/null
+++ b/demo/index.html
@@ -0,0 +1,21 @@
+<!DOCTYPE html><html lang="en" data-astro-cid-z4jru4n3><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="description" content="Explore a simulated Magpie maintainer session. Triage pull requests, inspect findings, and decide what happens next."><link rel="icon" type="image/svg+xml" href="/favicon.svg"><link rel="icon" type="image/x-icon" sizes="any" href="/favicon.ico"><title>Interactive demo | Apache Magpie</title><link rel="ca [...]
+ var _paq = (window._paq = window._paq || []);
+ /* tracker methods like "setCustomDimension" should be called before "trackPageView" */
+ _paq.push(["setDoNotTrack", true]);
+ _paq.push(["disableCookies"]);
+ _paq.push(["trackPageView"]);
+ _paq.push(["enableLinkTracking"]);
+ (function () {
+ var u = "https://analytics.apache.org/";
+ _paq.push(["setTrackerUrl", u + "matomo.php"]);
+ _paq.push(["setSiteId", "89"]);
+ var d = document,
+ g = d.createElement("script"),
+ s = d.getElementsByTagName("script")[0];
+ g.async = true;
+ g.src = u + "matomo.js";
+ s.parentNode.insertBefore(g, s);
+ })();
+ </script><link rel="stylesheet" href="/_astro/BaseLayout.H4DLRpYn.css"><link rel="stylesheet" href="/_astro/TerminalDemo._B8BWLul.css"></head><body data-astro-cid-z4jru4n3><style>astro-island,astro-slot,astro-static-slot{display:contents}</style><script>(()=>{var e=async t=>{await(await t())()};(self.Astro||(self.Astro={})).load=e;window.dispatchEvent(new Event("astro:load"));})();</script><script>(()=>{var g=Object.defineProperty;var w=(a,s,c)=>s in a?g(a,s,{enumerable:!0,configurab [...]
+Fictional repository · simulated actions · no account required
+Choose a task below or type help. No shell commands are executed.</pre></div><div class="t-suggestions" aria-label="Suggested demo commands"><button>triage PRs</button><button>triage issues</button><button>help</button></div><form class="t-prompt-form"><label for="terminal-input">›</label><input id="terminal-input" aria-label="Command or request" placeholder="Ask Magpie, or type help" autoComplete="off" spellCheck="false" maxLength="500" value=""/><button disabled="" type="submit">Run ↵< [...]
\ No newline at end of file
diff --git a/docs-assets/badge.json b/docs-assets/badge.json
new file mode 100644
index 0000000..78a59c2
--- /dev/null
+++ b/docs-assets/badge.json
@@ -0,0 +1,8 @@
+{
+ "label": "",
+ "message": "Magpie",
+ "logoSvg": "<svg xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\" width=\"2000\" zoomAndPan=\"magnify\" viewBox=\"0 0 1500 1499.999933\" height=\"2000\" preserveAspectRatio=\"xMidYMid meet\" version=\"1.0\"><defs><clipPath id=\"9639fc2a4f\"><path d=\"M 16.496094 41.253906 L 1483.496094 41.253906 L 1483.496094 1458.753906 L 16.496094 1458.753906 Z M 16.496094 41.253906 \" clip-rule=\"nonzero\"/></clipPath></defs><g clip-path=\"url(#9639fc2a4f)\"><path fi [...]
+ "logoWidth": 10,
+ "labelColor": "#004aae",
+ "color": "#004aae"
+}
diff --git a/docs-assets/bump-dev-version-run.png b/docs-assets/bump-dev-version-run.png
new file mode 100644
index 0000000..d07369a
Binary files /dev/null and b/docs-assets/bump-dev-version-run.png differ
diff --git a/docs-assets/installed-plugins.png b/docs-assets/installed-plugins.png
new file mode 100644
index 0000000..09cee6e
Binary files /dev/null and b/docs-assets/installed-plugins.png differ
diff --git a/docs-assets/quickstart/README.md b/docs-assets/quickstart/README.md
new file mode 100644
index 0000000..5688d7f
--- /dev/null
+++ b/docs-assets/quickstart/README.md
@@ -0,0 +1,167 @@
+<!-- SPDX-License-Identifier: Apache-2.0
+ https://www.apache.org/licenses/LICENSE-2.0 -->
+
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+**Table of Contents** *generated with [DocToc](https://github.com/thlorenz/doctoc)*
+
+- [One recording, and a set of authored screenshots](#one-recording-and-a-set-of-authored-screenshots)
+ - [Why one is recorded and the rest are written](#why-one-is-recorded-and-the-rest-are-written)
+ - [What the check can prove, and what it cannot](#what-the-check-can-prove-and-what-it-cannot)
+ - [Adding a screenshot](#adding-a-screenshot)
+ - [Conventions](#conventions)
+ - [The animated runs](#the-animated-runs)
+ - [Why SVG](#why-svg)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
+
+<!-- SPDX-License-Identifier: Apache-2.0
+ https://www.apache.org/licenses/LICENSE-2.0 -->
+
+# One recording, and a set of authored screenshots
+
+| File | Embedded by | Shows |
+|---|---|---|
+| `magpie-setup.svg` | [`docs/quick-start.md`](../../docs/quick-start.md), and [`docs/setup/README.md`](../../docs/setup/README.md) | `/magpie-setup` detecting the checkout, printing its plan, and waiting for approval. A real recording of a real run. |
+| `wizard/<family>.svg` | that family's README, *Before the first run* | An **animated** `/magpie-setup config` run for that family. Generated from `requires_config:` frontmatter by [`render-wizard.py`](../../tools/dev/render-wizard.py) — there is no transcript to edit. Illustrative of the shape of a run, not a recording of one. |
+| `families/<family>/<skill>.txt` | — | The authored transcript. This is the source file. |
+| `families/<family>/<skill>.svg` | that family's README, *Try these first* | The transcript rendered. Generated; never hand-edited. |
+
+The setup family has no screenshot of `/magpie-setup` itself: its first run
+*is* `magpie-setup.svg`, so `docs/setup/README.md` embeds that rather than a
+copy.
+
+## Why one is recorded and the rest are written
+
+A capture needs a terminal, a scratch project, and a human — and it needs all
+three again the next time any output moves.
+
+That price is worth paying once. `/magpie-setup` is the run a reader has not
+done yet, and seeing it actually happen, at the pace it happens, is worth more
+than a description of it. So that one is a recording.
+
+It was not worth paying ten times, and the proof is what happened when the
+repository tried: nine family recordings sat in the tree as placeholders for
+months, and when they were written they all showed the *same* thing — a
+pre-flight stopping on an unadopted repo, which is setup's arc, not the
+family's. Nine copies of the quick start, filed under ten families.
+
+A screenshot's job on a family page is to show the shape of a run: what comes
+back, and how it is laid out. That does not need a capture. It needs someone
+to write down what a typical run looks like, which is a text file anyone can
+fix in a pull request without booking a recording session.
+
+## What the check can prove, and what it cannot
+
+[`render-screenshot.sh`](../../tools/dev/render-screenshot.sh) is
+deterministic: the same `.txt` produces the same `.svg`, byte for byte, on any
+machine. So
+[`check-quickstart-recording.py`](../../tools/dev/check-quickstart-recording.py)
+can prove that **every committed `.svg` still matches its transcript**. Edit
+one without re-rendering and the build fails.
+
+It **cannot** prove that a transcript still matches what the skill prints
+today. Nothing here can. That is the real cost of authoring rather than
+capturing, and it is accepted deliberately: a screenshot on these pages is
+there to show the shape of a run, not to serve as a test oracle. Write
+transcripts to be robust to cosmetic change and the gap stays small — see the
+conventions below.
+
+## Adding a screenshot
+
+```bash
+$EDITOR assets/quickstart/families/pairing/self-review.txt
+tools/dev/render-screenshot.sh assets/quickstart/families/pairing/self-review.txt
+```
+
+Then embed the `.svg` in that family's README under *Try these first*, with
+alt text describing what the run shows. `--all` re-renders everything and
+`--check` fails on anything stale, which is what runs on commit.
+
+Colour comes from the line itself, so a transcript stays something you read as
+a terminal rather than as markup:
+
+| Line | Rendered |
+|---|---|
+| starts with `> ` | the command, in the prompt colour |
+| starts with `✓` | green |
+| starts with `⚠` | amber |
+| starts with `✗` | red |
+| ALL CAPS on its own | a section label, in amber |
+| anything else | ordinary output |
+
+## Conventions
+
+- **Under ~20 lines.** A screenshot shows a shape. A reader who wants the
+ whole output runs the command.
+- **No version strings, no dates, no counts a minor change would move.** The
+ check cannot tell you a transcript has gone stale, so write ones that do not
+ go stale easily. "reviewed 4 changed files" is fine; "74 skills" is a number
+ that will be wrong.
+- **Nothing secret in frame** — tokens, private repository names, reporter
+ addresses. These files are *text*: anything in them is greppable in the
+ repository forever. For `magpie-security` in particular, invent the tracker
+ numbers and use a scratch tracker name; a real transcript would put an
+ embargoed report in a public repository permanently.
+- **Say what the skill does not do.** Most of these skills are read-only or
+ draft-then-confirm, and that is the single most reassuring thing a first-time
+ reader can see. Several transcripts end on it.
+- **Keep the ASF header.** Every `.txt` opens with the licence header as a
+ block of `#` comments, exactly like any other authored file here, and the
+ renderer strips it before drawing — so it satisfies Apache RAT without being
+ rendered into the picture and without needing a `.rat-excludes` entry. The
+ one constraint it buys: a transcript cannot open with a literal `#` line.
+- **Never hand-edit an `.svg`.** It is generated. Edit the `.txt` and
+ re-render.
+- **Under 1536 KB**, enforced on commit. Nothing generated here comes close;
+ the cap catches a transcript that grew without anyone noticing.
+
+## The animated runs
+
+[`tools/dev/render-wizard.py`](../../tools/dev/render-wizard.py) writes them
+all:
+
+```bash
+python3 tools/dev/render-wizard.py # write
+python3 tools/dev/render-wizard.py --check # fail on drift
+```
+
+`magpie-setup.svg` is one fixed arc — the agent detected, the families picked,
+the install commands, then the secure-agent setup applying the sandbox, the
+clean-environment wrapper, the hooks and the status line. Edit
+`setup_script()` to change it. The per-family runs under `wizard/` have no
+script to edit: they are derived from each family's skills' `requires_config:`
+frontmatter, so a family that gains a required file gains a frame by itself.
+
+Animation is SMIL — one `<animate>` on opacity per line, all sharing one
+duration so the sequence loops as a unit. A viewer that does not animate SVG
+shows the first frame, which is the command about to be typed.
+
+**Nothing in this repository is captured.** `magpie-setup.svg` was the last
+recording, made with `asciinema` and `svg-term-cli`. It was also wrong: it
+opened with the marketplace install, which became a prerequisite with its own
+page, and fixing that needed a terminal, a scratch project and a human — which
+is why it stayed wrong for as long as it did. The recorder is retired and the
+Node dependency with it.
+
+What that costs is the same thing the authored screenshots cost, and it is
+worth restating here: a generated animation cannot prove the program still
+behaves the way the picture says. It shows the *shape* of a run — what is
+asked, in what order, and what is written where — and every embed says so.
+
+## Why SVG
+
+The output is text, which is most of the argument:
+
+- it goes through review as a diff, not as an opaque binary blob;
+- it carries its own Apache licence header, so RAT is satisfied by the file
+ itself;
+- it needs no player and no external host;
+- it stays sharp at any width;
+- it costs a fraction of what a terminal GIF or a PNG set would add to every
+ source release.
+
+The tradeoff for the one animated file: a renderer that does not run SVG
+animation shows the first frame rather than the loop. That is an acceptable
+still, and GitHub — where these pages are actually read — animates it. The
+authored screenshots are static, so they have no such tradeoff.
diff --git a/docs-assets/quickstart/demo.svg b/docs-assets/quickstart/demo.svg
new file mode 100644
index 0000000..b21a444
--- /dev/null
+++ b/docs-assets/quickstart/demo.svg
@@ -0,0 +1,60 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE - do not edit.
+
+ Written by tools/dev/render-wizard.py. Illustrative of the shape of a
+ run, not a recording of one.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 705 760"
+ width="705" height="760" role="img"
+ data-magpie-generated="render-wizard"
+ aria-label="An animated walk-through: Magpie installed from the marketplace, the agent sandboxed and guarded, privacy configured, then a security report imported, triaged, fixed and published as a CVE">
+ <title>One security report, start to finish</title>
+ <desc>Illustrative animation of the security lifecycle end to end. Not a recording.</desc>
+ <rect width="705" height="760" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="705" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="705" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="17" xml:space="preserve">
+ <text x="26" y="80" fill="#8abeb7" opacity="0">> /plugin marketplace add apache/magpie<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0000;0.0010;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="104" fill="#7f9f7f" opacity="0"> ✓ apache-magpie added - 12 plugins<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0388;0.0398;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="152" fill="#8abeb7" opacity="0">> /magpie-setup<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0776;0.0786;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="176" fill="#7f9f7f" opacity="0"> ✓ detected example-org/example-app - configuration written<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1163;0.1173;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="224" fill="#8abeb7" opacity="0">> /magpie-setup:isolated-setup-install<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1551;0.1561;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="248" fill="#7f9f7f" opacity="0"> ✓ sandbox, clean env, guard hook - 3 settings changes, 1 sudo<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1939;0.1949;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="296" fill="#8abeb7" opacity="0">> /magpie-setup:privacy-llm<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.2327;0.2337;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="320" fill="#7f9f7f" opacity="0"> ✓ gate passed - third-party names redacted: N-a3f9d2, E-7c1b04<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.2714;0.2724;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="368" fill="#8abeb7" opacity="0">> /magpie-security:issue-import<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3102;0.3112;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="392" fill="#c5c8c6" opacity="0"> Opened #41 and #42 in example-app-security<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3490;0.3500;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="440" fill="#8abeb7" opacity="0">> /magpie-security:issue-triage<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3878;0.3888;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="464" fill="#c5c8c6" opacity="0"> #41 path traversal in archive extraction high<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.4265;0.4275;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="488" fill="#8a8f94" opacity="0"> #42 not a vulnerability - reported behaviour is intended<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.4653;0.4663;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="536" fill="#8abeb7" opacity="0">> /magpie-security:issue-fix 41<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5041;0.5051;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="560" fill="#c5c8c6" opacity="0"> Fix drafted, PR opened - title and body carry no CVE,<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5429;0.5439;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="584" fill="#8a8f94" opacity="0"> no security wording, and no link back to the tracker.<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5816;0.5826;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="632" fill="#8abeb7" opacity="0">> /magpie-security:cve-allocate 41<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.6204;0.6214;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="656" fill="#7f9f7f" opacity="0"> ✓ CVE-2026-XXXXX published, advisory drafted<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.6592;0.6602;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="704" fill="#d8a657" opacity="0"> Every message that leaves the project was drafted here<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.6980;0.6990;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="728" fill="#d8a657" opacity="0"> and sent by a person. Nothing was posted unattended.<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.7367;0.7377;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <rect x="26" y="715" width="10" height="17" fill="#c5c8c6"><animate attributeName="opacity" values="1;1;0;0;1" dur="1.2s" repeatCount="indefinite"/></rect>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/contributor-growth/activity-sweep.svg b/docs-assets/quickstart/families/contributor-growth/activity-sweep.svg
new file mode 100644
index 0000000..8faa5bb
--- /dev/null
+++ b/docs-assets/quickstart/families/contributor-growth/activity-sweep.svg
@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 845 430"
+ width="845" height="430" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: activity-sweep">
+ <title>activity-sweep</title>
+ <rect width="845" height="430" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="845" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="845" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-contributor-growth:activity-sweep alex-dev 90d</text>
+ <text x="28" y="136" fill="#c5c8c6"> GitHub activity, last 90 days</text>
+ <text x="28" y="188" fill="#c5c8c6"> Authored 7 PRs, 6 merged, 1 open</text>
+ <text x="28" y="214" fill="#c5c8c6"> Reviewed 19 PRs, 14 with substantive comments</text>
+ <text x="28" y="240" fill="#c5c8c6"> Issues 11 triaged, 3 reproduced</text>
+ <text x="28" y="266" fill="#c5c8c6"> Comments 52 across issues and PRs</text>
+ <text x="28" y="318" fill="#c5c8c6"> Busiest area providers/aws</text>
+ <text x="28" y="370" fill="#c5c8c6"> This is what GitHub can see. Mailing lists, release votes and mentoring</text>
+ <text x="28" y="396" fill="#c5c8c6"> are not in here, and for most candidates they are half the picture.</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/contributor-growth/activity-sweep.txt b/docs-assets/quickstart/families/contributor-growth/activity-sweep.txt
new file mode 100644
index 0000000..b444c36
--- /dev/null
+++ b/docs-assets/quickstart/families/contributor-growth/activity-sweep.txt
@@ -0,0 +1,33 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-contributor-growth:activity-sweep alex-dev 90d
+
+ GitHub activity, last 90 days
+
+ Authored 7 PRs, 6 merged, 1 open
+ Reviewed 19 PRs, 14 with substantive comments
+ Issues 11 triaged, 3 reproduced
+ Comments 52 across issues and PRs
+
+ Busiest area providers/aws
+
+ This is what GitHub can see. Mailing lists, release votes and mentoring
+ are not in here, and for most candidates they are half the picture.
diff --git a/docs-assets/quickstart/families/contributor-growth/committer-onboarding.svg b/docs-assets/quickstart/families/contributor-growth/committer-onboarding.svg
new file mode 100644
index 0000000..a9f8058
--- /dev/null
+++ b/docs-assets/quickstart/families/contributor-growth/committer-onboarding.svg
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 812 456"
+ width="812" height="456" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: committer-onboarding">
+ <title>committer-onboarding</title>
+ <rect width="812" height="456" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="812" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="812" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-contributor-growth:committer-onboarding</text>
+ <text x="28" y="136" fill="#c5c8c6"> The vote on @kasia-w passed. 8 steps to close it out.</text>
+ <text x="28" y="188" fill="#7f9f7f"> ✓ ICLA on file</text>
+ <text x="28" y="214" fill="#7f9f7f"> ✓ Apache account requested</text>
+ <text x="28" y="240" fill="#d8a657"> ⚠ karma grant needs a PMC chair</text>
+ <text x="28" y="266" fill="#d8a657"> ⚠ private@ notification needs a PMC chair</text>
+ <text x="28" y="292" fill="#c5c8c6"> welcome announcement drafted, not sent</text>
+ <text x="28" y="344" fill="#c5c8c6"> Podling or TLP changes two of these steps; this project is a TLP, so</text>
+ <text x="28" y="370" fill="#c5c8c6"> the secretary request is skipped.</text>
+ <text x="28" y="422" fill="#c5c8c6"> Walk the remaining steps one at a time? [Y/n]</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/contributor-growth/committer-onboarding.txt b/docs-assets/quickstart/families/contributor-growth/committer-onboarding.txt
new file mode 100644
index 0000000..9bca8db
--- /dev/null
+++ b/docs-assets/quickstart/families/contributor-growth/committer-onboarding.txt
@@ -0,0 +1,34 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-contributor-growth:committer-onboarding
+
+ The vote on @kasia-w passed. 8 steps to close it out.
+
+ ✓ ICLA on file
+ ✓ Apache account requested
+ ⚠ karma grant needs a PMC chair
+ ⚠ private@ notification needs a PMC chair
+ welcome announcement drafted, not sent
+
+ Podling or TLP changes two of these steps; this project is a TLP, so
+ the secretary request is skipped.
+
+ Walk the remaining steps one at a time? [Y/n]
diff --git a/docs-assets/quickstart/families/contributor-growth/nomination.svg b/docs-assets/quickstart/families/contributor-growth/nomination.svg
new file mode 100644
index 0000000..9125994
--- /dev/null
+++ b/docs-assets/quickstart/families/contributor-growth/nomination.svg
@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 802 456"
+ width="802" height="456" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: nomination">
+ <title>nomination</title>
+ <rect width="802" height="456" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="802" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="802" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-contributor-growth:nomination</text>
+ <text x="28" y="136" fill="#c5c8c6"> Building the nomination brief</text>
+ <text x="28" y="188" fill="#c5c8c6"> On GitHub, last 12 months</text>
+ <text x="28" y="214" fill="#c5c8c6"> 24 merged PRs across 4 areas, 61 reviews given, 38 issues triaged</text>
+ <text x="28" y="240" fill="#c5c8c6"> steady since the spring, not a single burst</text>
+ <text x="28" y="292" fill="#c5c8c6"> Not visible from here - you fill these in</text>
+ <text x="28" y="318" fill="#c5c8c6"> mailing-list participation, release verification, mentoring</text>
+ <text x="28" y="370" fill="#c5c8c6"> Drafted the [DISCUSS] thread and the private nomination summary.</text>
+ <text x="28" y="422" fill="#c5c8c6"> Neither is sent. A nomination is the PMC's decision, not a score.</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/contributor-growth/nomination.txt b/docs-assets/quickstart/families/contributor-growth/nomination.txt
new file mode 100644
index 0000000..e1f4fb2
--- /dev/null
+++ b/docs-assets/quickstart/families/contributor-growth/nomination.txt
@@ -0,0 +1,34 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-contributor-growth:nomination
+
+ Building the nomination brief
+
+ On GitHub, last 12 months
+ 24 merged PRs across 4 areas, 61 reviews given, 38 issues triaged
+ steady since the spring, not a single burst
+
+ Not visible from here - you fill these in
+ mailing-list participation, release verification, mentoring
+
+ Drafted the [DISCUSS] thread and the private nomination summary.
+
+ Neither is sent. A nomination is the PMC's decision, not a score.
diff --git a/docs-assets/quickstart/families/issue/deduplicate.svg b/docs-assets/quickstart/families/issue/deduplicate.svg
new file mode 100644
index 0000000..4b7ae32
--- /dev/null
+++ b/docs-assets/quickstart/families/issue/deduplicate.svg
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 834 482"
+ width="834" height="482" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: deduplicate">
+ <title>deduplicate</title>
+ <rect width="834" height="482" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="834" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="834" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-issue:deduplicate</text>
+ <text x="28" y="136" fill="#c5c8c6"> Scanning 140 open issues for duplicate root causes</text>
+ <text x="28" y="188" fill="#d8a657"> STRONG</text>
+ <text x="28" y="214" fill="#c5c8c6"> #3324 and #3298 same traceback, same config key</text>
+ <text x="28" y="266" fill="#d8a657"> WORTH A LOOK</text>
+ <text x="28" y="292" fill="#c5c8c6"> #3201 and #3155 both describe a hang on shutdown, different paths</text>
+ <text x="28" y="344" fill="#c5c8c6"> Proposed for the strong match: keep #3298, close #3324 as a duplicate,</text>
+ <text x="28" y="370" fill="#c5c8c6"> and carry the second reporter's extra detail into the kept issue so no</text>
+ <text x="28" y="396" fill="#c5c8c6"> one loses credit.</text>
+ <text x="28" y="448" fill="#c5c8c6"> Apply? [y/N]</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/issue/deduplicate.txt b/docs-assets/quickstart/families/issue/deduplicate.txt
new file mode 100644
index 0000000..870e840
--- /dev/null
+++ b/docs-assets/quickstart/families/issue/deduplicate.txt
@@ -0,0 +1,35 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-issue:deduplicate
+
+ Scanning 140 open issues for duplicate root causes
+
+ STRONG
+ #3324 and #3298 same traceback, same config key
+
+ WORTH A LOOK
+ #3201 and #3155 both describe a hang on shutdown, different paths
+
+ Proposed for the strong match: keep #3298, close #3324 as a duplicate,
+ and carry the second reporter's extra detail into the kept issue so no
+ one loses credit.
+
+ Apply? [y/N]
diff --git a/docs-assets/quickstart/families/issue/reproducer.svg b/docs-assets/quickstart/families/issue/reproducer.svg
new file mode 100644
index 0000000..e543293
--- /dev/null
+++ b/docs-assets/quickstart/families/issue/reproducer.svg
@@ -0,0 +1,47 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 780 430"
+ width="780" height="430" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: reproducer">
+ <title>reproducer</title>
+ <rect width="780" height="430" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="780" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="780" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-issue:reproducer 3312</text>
+ <text x="28" y="136" fill="#c5c8c6"> Extracting a runnable case from the report</text>
+ <text x="28" y="188" fill="#c5c8c6"> Found config snippet, stack trace, version pin</text>
+ <text x="28" y="214" fill="#c5c8c6"> Missing the platform - assuming linux from the traceback paths</text>
+ <text x="28" y="266" fill="#c5c8c6"> Wrote a probe: 11 lines, stdlib only, no network</text>
+ <text x="28" y="318" fill="#7f9f7f"> ✓ reproduced - the same KeyError on line 88</text>
+ <text x="28" y="370" fill="#c5c8c6"> The report is actionable. The probe is attached to the issue as a</text>
+ <text x="28" y="396" fill="#c5c8c6"> comment for you to review before anything is posted.</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/issue/reproducer.txt b/docs-assets/quickstart/families/issue/reproducer.txt
new file mode 100644
index 0000000..e7b6a2a
--- /dev/null
+++ b/docs-assets/quickstart/families/issue/reproducer.txt
@@ -0,0 +1,33 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-issue:reproducer 3312
+
+ Extracting a runnable case from the report
+
+ Found config snippet, stack trace, version pin
+ Missing the platform - assuming linux from the traceback paths
+
+ Wrote a probe: 11 lines, stdlib only, no network
+
+ ✓ reproduced - the same KeyError on line 88
+
+ The report is actionable. The probe is attached to the issue as a
+ comment for you to review before anything is posted.
diff --git a/docs-assets/quickstart/families/issue/triage.svg b/docs-assets/quickstart/families/issue/triage.svg
new file mode 100644
index 0000000..b942b5c
--- /dev/null
+++ b/docs-assets/quickstart/families/issue/triage.svg
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 780 430"
+ width="780" height="430" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: triage">
+ <title>triage</title>
+ <rect width="780" height="430" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="780" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="780" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-issue:triage</text>
+ <text x="28" y="136" fill="#c5c8c6"> 23 issues carry needs-triage</text>
+ <text x="28" y="188" fill="#c5c8c6"> #3312 crash on startup with an empty config file</text>
+ <text x="28" y="214" fill="#c5c8c6"> bug - reproducible from the report, has a stack trace</text>
+ <text x="28" y="240" fill="#c5c8c6"> #3319 "add a dark mode"</text>
+ <text x="28" y="266" fill="#c5c8c6"> feature request - no design, routing to discussion</text>
+ <text x="28" y="292" fill="#c5c8c6"> #3321 "it does not work"</text>
+ <text x="28" y="318" fill="#c5c8c6"> needs info - drafted a reply asking for version and steps</text>
+ <text x="28" y="344" fill="#c5c8c6"> #3324 duplicate of #3298, same root cause</text>
+ <text x="28" y="396" fill="#c5c8c6"> Labels, replies and closes are all proposals. Confirm each? [Y/n]</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/issue/triage.txt b/docs-assets/quickstart/families/issue/triage.txt
new file mode 100644
index 0000000..7b48bcd
--- /dev/null
+++ b/docs-assets/quickstart/families/issue/triage.txt
@@ -0,0 +1,33 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-issue:triage
+
+ 23 issues carry needs-triage
+
+ #3312 crash on startup with an empty config file
+ bug - reproducible from the report, has a stack trace
+ #3319 "add a dark mode"
+ feature request - no design, routing to discussion
+ #3321 "it does not work"
+ needs info - drafted a reply asking for version and steps
+ #3324 duplicate of #3298, same root cause
+
+ Labels, replies and closes are all proposals. Confirm each? [Y/n]
diff --git a/docs-assets/quickstart/families/mentoring/good-first-issue-sweep.svg b/docs-assets/quickstart/families/mentoring/good-first-issue-sweep.svg
new file mode 100644
index 0000000..c4df88d
--- /dev/null
+++ b/docs-assets/quickstart/families/mentoring/good-first-issue-sweep.svg
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 823 456"
+ width="823" height="456" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: good-first-issue-sweep">
+ <title>good-first-issue-sweep</title>
+ <rect width="823" height="456" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="823" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="823" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-mentoring:good-first-issue-sweep</text>
+ <text x="28" y="136" fill="#c5c8c6"> Looking for issues a newcomer could actually finish</text>
+ <text x="28" y="188" fill="#d8a657"> READY</text>
+ <text x="28" y="214" fill="#c5c8c6"> #2890 add a unit test for the retry helper</text>
+ <text x="28" y="240" fill="#c5c8c6"> scoped, has a pointer to the file, no design decision left</text>
+ <text x="28" y="266" fill="#c5c8c6"> #2912 fix a broken link in the install docs</text>
+ <text x="28" y="318" fill="#c5c8c6"> NOT READY, BUT CLOSE</text>
+ <text x="28" y="344" fill="#c5c8c6"> #2877 needs one sentence saying where the code lives</text>
+ <text x="28" y="370" fill="#c5c8c6"> #2901 labelled good first issue, but the fix needs a schema change</text>
+ <text x="28" y="422" fill="#c5c8c6"> Drafted the label changes and the missing-context comments. Confirm?</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/mentoring/good-first-issue-sweep.txt b/docs-assets/quickstart/families/mentoring/good-first-issue-sweep.txt
new file mode 100644
index 0000000..210509e
--- /dev/null
+++ b/docs-assets/quickstart/families/mentoring/good-first-issue-sweep.txt
@@ -0,0 +1,34 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-mentoring:good-first-issue-sweep
+
+ Looking for issues a newcomer could actually finish
+
+ READY
+ #2890 add a unit test for the retry helper
+ scoped, has a pointer to the file, no design decision left
+ #2912 fix a broken link in the install docs
+
+ NOT READY, BUT CLOSE
+ #2877 needs one sentence saying where the code lives
+ #2901 labelled good first issue, but the fix needs a schema change
+
+ Drafted the label changes and the missing-context comments. Confirm?
diff --git a/docs-assets/quickstart/families/mentoring/newcomer-issue-explainer.svg b/docs-assets/quickstart/families/mentoring/newcomer-issue-explainer.svg
new file mode 100644
index 0000000..5a5b110
--- /dev/null
+++ b/docs-assets/quickstart/families/mentoring/newcomer-issue-explainer.svg
@@ -0,0 +1,47 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 834 404"
+ width="834" height="404" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: newcomer-issue-explainer">
+ <title>newcomer-issue-explainer</title>
+ <rect width="834" height="404" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="834" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="834" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-mentoring:newcomer-issue-explainer 8144</text>
+ <text x="28" y="136" fill="#c5c8c6"> Reading the issue, then the code it points at</text>
+ <text x="28" y="188" fill="#c5c8c6"> What breaks the parser drops the last field on a trailing comma</text>
+ <text x="28" y="214" fill="#c5c8c6"> Where two files - the tokenizer and one test</text>
+ <text x="28" y="240" fill="#c5c8c6"> How to check one test, named in the comment, runs in under a second</text>
+ <text x="28" y="292" fill="#c5c8c6"> Drafted a comment in a teaching register: what to change and why, not</text>
+ <text x="28" y="318" fill="#c5c8c6"> what to type. It asks nothing of the newcomer they cannot answer.</text>
+ <text x="28" y="370" fill="#c5c8c6"> Post it? [y/N]</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/mentoring/newcomer-issue-explainer.txt b/docs-assets/quickstart/families/mentoring/newcomer-issue-explainer.txt
new file mode 100644
index 0000000..e8c7644
--- /dev/null
+++ b/docs-assets/quickstart/families/mentoring/newcomer-issue-explainer.txt
@@ -0,0 +1,32 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-mentoring:newcomer-issue-explainer 8144
+
+ Reading the issue, then the code it points at
+
+ What breaks the parser drops the last field on a trailing comma
+ Where two files - the tokenizer and one test
+ How to check one test, named in the comment, runs in under a second
+
+ Drafted a comment in a teaching register: what to change and why, not
+ what to type. It asks nothing of the newcomer they cannot answer.
+
+ Post it? [y/N]
diff --git a/docs-assets/quickstart/families/mentoring/welcome.svg b/docs-assets/quickstart/families/mentoring/welcome.svg
new file mode 100644
index 0000000..51d9c81
--- /dev/null
+++ b/docs-assets/quickstart/families/mentoring/welcome.svg
@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 834 430"
+ width="834" height="430" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: welcome">
+ <title>welcome</title>
+ <rect width="834" height="430" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="834" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="834" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-mentoring:welcome</text>
+ <text x="28" y="136" fill="#c5c8c6"> 3 first-time contributors opened a PR today</text>
+ <text x="28" y="188" fill="#c5c8c6"> #1421 alex-dev first PR to this project</text>
+ <text x="28" y="214" fill="#c5c8c6"> #1425 sam-builds first PR to this project</text>
+ <text x="28" y="240" fill="#c5c8c6"> #1427 jo-writes first PR, docs only</text>
+ <text x="28" y="292" fill="#c5c8c6"> Drafted a welcome for each: what happens next, roughly how long review</text>
+ <text x="28" y="318" fill="#c5c8c6"> takes, and who to ask if it stalls. No template stamping - each one</text>
+ <text x="28" y="344" fill="#c5c8c6"> names what the PR actually changed.</text>
+ <text x="28" y="396" fill="#c5c8c6"> Review the three drafts before anything is posted? [Y/n]</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/mentoring/welcome.txt b/docs-assets/quickstart/families/mentoring/welcome.txt
new file mode 100644
index 0000000..705e068
--- /dev/null
+++ b/docs-assets/quickstart/families/mentoring/welcome.txt
@@ -0,0 +1,33 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-mentoring:welcome
+
+ 3 first-time contributors opened a PR today
+
+ #1421 alex-dev first PR to this project
+ #1425 sam-builds first PR to this project
+ #1427 jo-writes first PR, docs only
+
+ Drafted a welcome for each: what happens next, roughly how long review
+ takes, and who to ask if it stalls. No template stamping - each one
+ names what the PR actually changed.
+
+ Review the three drafts before anything is posted? [Y/n]
diff --git a/docs-assets/quickstart/families/pairing/multi-agent-review.svg b/docs-assets/quickstart/families/pairing/multi-agent-review.svg
new file mode 100644
index 0000000..0f03923
--- /dev/null
+++ b/docs-assets/quickstart/families/pairing/multi-agent-review.svg
@@ -0,0 +1,50 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 845 534"
+ width="845" height="534" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: multi-agent-review">
+ <title>multi-agent-review</title>
+ <rect width="845" height="534" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="845" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="845" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-pairing:multi-agent-review</text>
+ <text x="28" y="136" fill="#c5c8c6"> Two independent reads of the same diff</text>
+ <text x="28" y="188" fill="#d8a657"> BOTH FOUND</text>
+ <text x="28" y="214" fill="#c5c8c6"> src/queue.py:142 the retry loop can spin forever on a 5xx</text>
+ <text x="28" y="266" fill="#d8a657"> ONLY THE FIRST READ</text>
+ <text x="28" y="292" fill="#c5c8c6"> src/queue.py:88 the lock is held across a network call</text>
+ <text x="28" y="344" fill="#d8a657"> ONLY THE SECOND READ</text>
+ <text x="28" y="370" fill="#c5c8c6"> tests/test_queue.py:30 the test passes if the function does nothing</text>
+ <text x="28" y="422" fill="#c5c8c6"> Disagreement is the point: a finding one read missed is worth more than</text>
+ <text x="28" y="448" fill="#c5c8c6"> a finding both agreed on.</text>
+ <text x="28" y="500" fill="#c5c8c6"> Nothing was posted.</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/pairing/multi-agent-review.txt b/docs-assets/quickstart/families/pairing/multi-agent-review.txt
new file mode 100644
index 0000000..1ae5493
--- /dev/null
+++ b/docs-assets/quickstart/families/pairing/multi-agent-review.txt
@@ -0,0 +1,37 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-pairing:multi-agent-review
+
+ Two independent reads of the same diff
+
+ BOTH FOUND
+ src/queue.py:142 the retry loop can spin forever on a 5xx
+
+ ONLY THE FIRST READ
+ src/queue.py:88 the lock is held across a network call
+
+ ONLY THE SECOND READ
+ tests/test_queue.py:30 the test passes if the function does nothing
+
+ Disagreement is the point: a finding one read missed is worth more than
+ a finding both agreed on.
+
+ Nothing was posted.
diff --git a/docs-assets/quickstart/families/pairing/self-review.svg b/docs-assets/quickstart/families/pairing/self-review.svg
new file mode 100644
index 0000000..c9a4ec4
--- /dev/null
+++ b/docs-assets/quickstart/families/pairing/self-review.svg
@@ -0,0 +1,47 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 791 404"
+ width="791" height="404" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: self-review">
+ <title>self-review</title>
+ <rect width="791" height="404" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="791" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="791" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-pairing:self-review</text>
+ <text x="28" y="136" fill="#c5c8c6"> Reviewing 4 changed files against origin/main</text>
+ <text x="28" y="188" fill="#d8a657"> BLOCKING</text>
+ <text x="28" y="214" fill="#c5c8c6"> src/cache.py:88 unchecked dict access on a caller-supplied key</text>
+ <text x="28" y="266" fill="#d8a657"> NON-BLOCKING</text>
+ <text x="28" y="292" fill="#c5c8c6"> src/cache.py:12 module docstring omits the eviction policy</text>
+ <text x="28" y="318" fill="#c5c8c6"> tests/test_cache.py:40 asserts the mock, not the behaviour</text>
+ <text x="28" y="370" fill="#c5c8c6"> Nothing was sent, posted, or merged - the report is the output.</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/pairing/self-review.txt b/docs-assets/quickstart/families/pairing/self-review.txt
new file mode 100644
index 0000000..89ec9f4
--- /dev/null
+++ b/docs-assets/quickstart/families/pairing/self-review.txt
@@ -0,0 +1,32 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-pairing:self-review
+
+ Reviewing 4 changed files against origin/main
+
+ BLOCKING
+ src/cache.py:88 unchecked dict access on a caller-supplied key
+
+ NON-BLOCKING
+ src/cache.py:12 module docstring omits the eviction policy
+ tests/test_cache.py:40 asserts the mock, not the behaviour
+
+ Nothing was sent, posted, or merged - the report is the output.
diff --git a/docs-assets/quickstart/families/pr-management/stats.svg b/docs-assets/quickstart/families/pr-management/stats.svg
new file mode 100644
index 0000000..ffbd25c
--- /dev/null
+++ b/docs-assets/quickstart/families/pr-management/stats.svg
@@ -0,0 +1,50 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 834 534"
+ width="834" height="534" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: stats">
+ <title>stats</title>
+ <rect width="834" height="534" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="834" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="834" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-pr-management:stats</text>
+ <text x="28" y="136" fill="#c5c8c6"> Open PR backlog</text>
+ <text x="28" y="188" fill="#c5c8c6"> Health FAIR - the queue is growing slowly</text>
+ <text x="28" y="240" fill="#c5c8c6"> This week opened 19 closed 14 net +5</text>
+ <text x="28" y="266" fill="#c5c8c6"> Last week opened 15 closed 21 net -6</text>
+ <text x="28" y="318" fill="#c5c8c6"> Where the pressure is</text>
+ <text x="28" y="344" fill="#c5c8c6"> scheduler 11 open, oldest 62 days</text>
+ <text x="28" y="370" fill="#c5c8c6"> providers 9 open, oldest 21 days</text>
+ <text x="28" y="396" fill="#c5c8c6"> docs 4 open, oldest 6 days</text>
+ <text x="28" y="448" fill="#c5c8c6"> Triage funnel 12 untriaged -> 17 ready for review -> 9 in review</text>
+ <text x="28" y="500" fill="#c5c8c6"> Start with the scheduler queue: it is both the largest and the oldest.</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/pr-management/stats.txt b/docs-assets/quickstart/families/pr-management/stats.txt
new file mode 100644
index 0000000..8b35f20
--- /dev/null
+++ b/docs-assets/quickstart/families/pr-management/stats.txt
@@ -0,0 +1,37 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-pr-management:stats
+
+ Open PR backlog
+
+ Health FAIR - the queue is growing slowly
+
+ This week opened 19 closed 14 net +5
+ Last week opened 15 closed 21 net -6
+
+ Where the pressure is
+ scheduler 11 open, oldest 62 days
+ providers 9 open, oldest 21 days
+ docs 4 open, oldest 6 days
+
+ Triage funnel 12 untriaged -> 17 ready for review -> 9 in review
+
+ Start with the scheduler queue: it is both the largest and the oldest.
diff --git a/docs-assets/quickstart/families/pr-management/triage.svg b/docs-assets/quickstart/families/pr-management/triage.svg
new file mode 100644
index 0000000..41a3032
--- /dev/null
+++ b/docs-assets/quickstart/families/pr-management/triage.svg
@@ -0,0 +1,50 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 802 456"
+ width="802" height="456" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: triage">
+ <title>triage</title>
+ <rect width="802" height="456" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="802" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="802" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-pr-management:triage</text>
+ <text x="28" y="136" fill="#c5c8c6"> 38 open PRs, 12 untriaged</text>
+ <text x="28" y="188" fill="#c5c8c6"> #1421 first-time contributor, CI green, no reviewer</text>
+ <text x="28" y="214" fill="#c5c8c6"> -> mark ready for maintainer review</text>
+ <text x="28" y="240" fill="#c5c8c6"> #1388 draft for 3 weeks, no commits since</text>
+ <text x="28" y="266" fill="#c5c8c6"> -> comment asking whether it is still active</text>
+ <text x="28" y="292" fill="#c5c8c6"> #1402 branch 200 commits behind, conflicts</text>
+ <text x="28" y="318" fill="#c5c8c6"> -> ask the author to rebase</text>
+ <text x="28" y="344" fill="#c5c8c6"> #1377 bot-authored dependency bump, CI green</text>
+ <text x="28" y="370" fill="#c5c8c6"> -> promote out of draft</text>
+ <text x="28" y="422" fill="#c5c8c6"> Each action needs your confirmation. Walk them one at a time? [Y/n]</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/pr-management/triage.txt b/docs-assets/quickstart/families/pr-management/triage.txt
new file mode 100644
index 0000000..3726d9b
--- /dev/null
+++ b/docs-assets/quickstart/families/pr-management/triage.txt
@@ -0,0 +1,34 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-pr-management:triage
+
+ 38 open PRs, 12 untriaged
+
+ #1421 first-time contributor, CI green, no reviewer
+ -> mark ready for maintainer review
+ #1388 draft for 3 weeks, no commits since
+ -> comment asking whether it is still active
+ #1402 branch 200 commits behind, conflicts
+ -> ask the author to rebase
+ #1377 bot-authored dependency bump, CI green
+ -> promote out of draft
+
+ Each action needs your confirmation. Walk them one at a time? [Y/n]
diff --git a/docs-assets/quickstart/families/release-management/prepare.svg b/docs-assets/quickstart/families/release-management/prepare.svg
new file mode 100644
index 0000000..d442ed2
--- /dev/null
+++ b/docs-assets/quickstart/families/release-management/prepare.svg
@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 845 430"
+ width="845" height="430" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: prepare">
+ <title>prepare</title>
+ <rect width="845" height="430" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="845" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="845" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-release-management:prepare 1.4.0</text>
+ <text x="28" y="136" fill="#c5c8c6"> Reading the release train and the release-management config</text>
+ <text x="28" y="188" fill="#c5c8c6"> Drafted, nothing filed:</text>
+ <text x="28" y="240" fill="#c5c8c6"> Planning issue "Release 1.4.0" - the 14-step checklist, the RM named,</text>
+ <text x="28" y="266" fill="#c5c8c6"> the target date from the train</text>
+ <text x="28" y="292" fill="#c5c8c6"> Prep PR version bump across 4 files, changelog assembled from</text>
+ <text x="28" y="318" fill="#c5c8c6"> the merged PRs since 1.3.0</text>
+ <text x="28" y="370" fill="#c5c8c6"> Review both, then say the word. The agent never marks a PR ready and</text>
+ <text x="28" y="396" fill="#c5c8c6"> never merges one.</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/release-management/prepare.txt b/docs-assets/quickstart/families/release-management/prepare.txt
new file mode 100644
index 0000000..a5eb926
--- /dev/null
+++ b/docs-assets/quickstart/families/release-management/prepare.txt
@@ -0,0 +1,33 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-release-management:prepare 1.4.0
+
+ Reading the release train and the release-management config
+
+ Drafted, nothing filed:
+
+ Planning issue "Release 1.4.0" - the 14-step checklist, the RM named,
+ the target date from the train
+ Prep PR version bump across 4 files, changelog assembled from
+ the merged PRs since 1.3.0
+
+ Review both, then say the word. The agent never marks a PR ready and
+ never merges one.
diff --git a/docs-assets/quickstart/families/release-management/verify-rc.svg b/docs-assets/quickstart/families/release-management/verify-rc.svg
new file mode 100644
index 0000000..517c10c
--- /dev/null
+++ b/docs-assets/quickstart/families/release-management/verify-rc.svg
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 877 456"
+ width="877" height="456" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: verify-rc">
+ <title>verify-rc</title>
+ <rect width="877" height="456" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="877" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="877" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-release-management:verify-rc 1.4.0-rc2</text>
+ <text x="28" y="136" fill="#c5c8c6"> Pre-flight on the staged candidate</text>
+ <text x="28" y="188" fill="#7f9f7f"> ✓ signatures every artefact verifies against the KEYS file</text>
+ <text x="28" y="214" fill="#7f9f7f"> ✓ checksums sha512 matches for all 6 artefacts</text>
+ <text x="28" y="240" fill="#7f9f7f"> ✓ licence headers Apache RAT reports no unapproved file</text>
+ <text x="28" y="266" fill="#7f9f7f"> ✓ NOTICE/LICENSE present, and NOTICE names every bundled dependency</text>
+ <text x="28" y="292" fill="#7f9f7f"> ✓ no binaries no .pyc, no __pycache__, no jar in the source archive</text>
+ <text x="28" y="318" fill="#d8a657"> ⚠ version strings docs/conf.py still reads 1.3.0</text>
+ <text x="28" y="370" fill="#d8a657"> PASS WITH WARNINGS</text>
+ <text x="28" y="422" fill="#c5c8c6"> Read-only. Nothing was posted to the planning issue.</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/release-management/verify-rc.txt b/docs-assets/quickstart/families/release-management/verify-rc.txt
new file mode 100644
index 0000000..061146b
--- /dev/null
+++ b/docs-assets/quickstart/families/release-management/verify-rc.txt
@@ -0,0 +1,34 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-release-management:verify-rc 1.4.0-rc2
+
+ Pre-flight on the staged candidate
+
+ ✓ signatures every artefact verifies against the KEYS file
+ ✓ checksums sha512 matches for all 6 artefacts
+ ✓ licence headers Apache RAT reports no unapproved file
+ ✓ NOTICE/LICENSE present, and NOTICE names every bundled dependency
+ ✓ no binaries no .pyc, no __pycache__, no jar in the source archive
+ ⚠ version strings docs/conf.py still reads 1.3.0
+
+ PASS WITH WARNINGS
+
+ Read-only. Nothing was posted to the planning issue.
diff --git a/docs-assets/quickstart/families/release-management/vote-tally.svg b/docs-assets/quickstart/families/release-management/vote-tally.svg
new file mode 100644
index 0000000..ad40aeb
--- /dev/null
+++ b/docs-assets/quickstart/families/release-management/vote-tally.svg
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 791 482"
+ width="791" height="482" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: vote-tally">
+ <title>vote-tally</title>
+ <rect width="791" height="482" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="791" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="791" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-release-management:vote-tally 1.4.0-rc2</text>
+ <text x="28" y="136" fill="#c5c8c6"> Vote window closed 6 hours ago</text>
+ <text x="28" y="188" fill="#d8a657"> BINDING</text>
+ <text x="28" y="214" fill="#c5c8c6"> +1 three PMC members</text>
+ <text x="28" y="240" fill="#c5c8c6"> 0 one PMC member (did not verify)</text>
+ <text x="28" y="292" fill="#d8a657"> NON-BINDING</text>
+ <text x="28" y="318" fill="#c5c8c6"> +1 two contributors</text>
+ <text x="28" y="370" fill="#c5c8c6"> 3 binding +1, no -1: the vote passes.</text>
+ <text x="28" y="422" fill="#c5c8c6"> Drafted the [RESULT][VOTE] email and the vote-passed label change.</text>
+ <text x="28" y="448" fill="#c5c8c6"> Neither is sent or applied until you confirm.</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/release-management/vote-tally.txt b/docs-assets/quickstart/families/release-management/vote-tally.txt
new file mode 100644
index 0000000..98a02e3
--- /dev/null
+++ b/docs-assets/quickstart/families/release-management/vote-tally.txt
@@ -0,0 +1,35 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-release-management:vote-tally 1.4.0-rc2
+
+ Vote window closed 6 hours ago
+
+ BINDING
+ +1 three PMC members
+ 0 one PMC member (did not verify)
+
+ NON-BINDING
+ +1 two contributors
+
+ 3 binding +1, no -1: the vote passes.
+
+ Drafted the [RESULT][VOTE] email and the vote-passed label change.
+ Neither is sent or applied until you confirm.
diff --git a/docs-assets/quickstart/families/repo-health/dependency-audit.svg b/docs-assets/quickstart/families/repo-health/dependency-audit.svg
new file mode 100644
index 0000000..3a73dcc
--- /dev/null
+++ b/docs-assets/quickstart/families/repo-health/dependency-audit.svg
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 834 482"
+ width="834" height="482" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: dependency-audit">
+ <title>dependency-audit</title>
+ <rect width="834" height="482" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="834" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="834" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-repo-health:dependency-audit</text>
+ <text x="28" y="136" fill="#c5c8c6"> Resolving the dependency tree</text>
+ <text x="28" y="188" fill="#d8a657"> OUTDATED WITH A FIX AVAILABLE</text>
+ <text x="28" y="214" fill="#c5c8c6"> requests 2 minor versions behind</text>
+ <text x="28" y="240" fill="#c5c8c6"> cryptography 1 major behind - the upgrade has a breaking API change</text>
+ <text x="28" y="292" fill="#d8a657"> UNMAINTAINED</text>
+ <text x="28" y="318" fill="#c5c8c6"> parsedatetime no release in 4 years, 2 open security reports</text>
+ <text x="28" y="370" fill="#d8a657"> PINNED BUT UNUSED</text>
+ <text x="28" y="396" fill="#c5c8c6"> six no import anywhere in the tree</text>
+ <text x="28" y="448" fill="#c5c8c6"> Read-only. Nothing was upgraded and no PR was opened.</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/repo-health/dependency-audit.txt b/docs-assets/quickstart/families/repo-health/dependency-audit.txt
new file mode 100644
index 0000000..71cd78c
--- /dev/null
+++ b/docs-assets/quickstart/families/repo-health/dependency-audit.txt
@@ -0,0 +1,35 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-repo-health:dependency-audit
+
+ Resolving the dependency tree
+
+ OUTDATED WITH A FIX AVAILABLE
+ requests 2 minor versions behind
+ cryptography 1 major behind - the upgrade has a breaking API change
+
+ UNMAINTAINED
+ parsedatetime no release in 4 years, 2 open security reports
+
+ PINNED BUT UNUSED
+ six no import anywhere in the tree
+
+ Read-only. Nothing was upgraded and no PR was opened.
diff --git a/docs-assets/quickstart/families/repo-health/flaky-test-triage.svg b/docs-assets/quickstart/families/repo-health/flaky-test-triage.svg
new file mode 100644
index 0000000..54ffcaa
--- /dev/null
+++ b/docs-assets/quickstart/families/repo-health/flaky-test-triage.svg
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 845 482"
+ width="845" height="482" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: flaky-test-triage">
+ <title>flaky-test-triage</title>
+ <rect width="845" height="482" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="845" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="845" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-repo-health:flaky-test-triage</text>
+ <text x="28" y="136" fill="#c5c8c6"> Reading the last 200 CI runs on main</text>
+ <text x="28" y="188" fill="#d8a657"> FLAKY</text>
+ <text x="28" y="214" fill="#c5c8c6"> test_scheduler_timeout fails 1 run in 9, always on the slow runner</text>
+ <text x="28" y="240" fill="#c5c8c6"> test_upload_retry fails 1 run in 30, no pattern in the runner</text>
+ <text x="28" y="292" fill="#c5c8c6"> FAILING, NOT FLAKY</text>
+ <text x="28" y="318" fill="#c5c8c6"> test_config_defaults fails every run since the config change</text>
+ <text x="28" y="370" fill="#c5c8c6"> The last one is a real regression wearing a flake's clothes - it is in</text>
+ <text x="28" y="396" fill="#c5c8c6"> the same file as two genuine flakes, which is why nobody looked.</text>
+ <text x="28" y="448" fill="#c5c8c6"> Read-only.</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/repo-health/flaky-test-triage.txt b/docs-assets/quickstart/families/repo-health/flaky-test-triage.txt
new file mode 100644
index 0000000..92999ad
--- /dev/null
+++ b/docs-assets/quickstart/families/repo-health/flaky-test-triage.txt
@@ -0,0 +1,35 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-repo-health:flaky-test-triage
+
+ Reading the last 200 CI runs on main
+
+ FLAKY
+ test_scheduler_timeout fails 1 run in 9, always on the slow runner
+ test_upload_retry fails 1 run in 30, no pattern in the runner
+
+ FAILING, NOT FLAKY
+ test_config_defaults fails every run since the config change
+
+ The last one is a real regression wearing a flake's clothes - it is in
+ the same file as two genuine flakes, which is why nobody looked.
+
+ Read-only.
diff --git a/docs-assets/quickstart/families/repo-health/workflow-security-audit.svg b/docs-assets/quickstart/families/repo-health/workflow-security-audit.svg
new file mode 100644
index 0000000..58acbb7
--- /dev/null
+++ b/docs-assets/quickstart/families/repo-health/workflow-security-audit.svg
@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 834 430"
+ width="834" height="430" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: workflow-security-audit">
+ <title>workflow-security-audit</title>
+ <rect width="834" height="430" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="834" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="834" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-repo-health:workflow-security-audit</text>
+ <text x="28" y="136" fill="#c5c8c6"> 12 workflow files</text>
+ <text x="28" y="188" fill="#cc6666"> ✗ release.yml pull_request_target with a checkout of the PR head</text>
+ <text x="28" y="214" fill="#c5c8c6"> - runs untrusted code with write permissions</text>
+ <text x="28" y="240" fill="#d8a657"> ⚠ ci.yml actions/checkout pinned to a tag, not a SHA</text>
+ <text x="28" y="266" fill="#d8a657"> ⚠ docs.yml no explicit permissions block - inherits write-all</text>
+ <text x="28" y="292" fill="#7f9f7f"> ✓ nine others no finding</text>
+ <text x="28" y="344" fill="#c5c8c6"> The first one is the one to fix today.</text>
+ <text x="28" y="396" fill="#c5c8c6"> Read-only. No workflow was edited.</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/repo-health/workflow-security-audit.txt b/docs-assets/quickstart/families/repo-health/workflow-security-audit.txt
new file mode 100644
index 0000000..fc54b25
--- /dev/null
+++ b/docs-assets/quickstart/families/repo-health/workflow-security-audit.txt
@@ -0,0 +1,33 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-repo-health:workflow-security-audit
+
+ 12 workflow files
+
+ ✗ release.yml pull_request_target with a checkout of the PR head
+ - runs untrusted code with write permissions
+ ⚠ ci.yml actions/checkout pinned to a tag, not a SHA
+ ⚠ docs.yml no explicit permissions block - inherits write-all
+ ✓ nine others no finding
+
+ The first one is the one to fix today.
+
+ Read-only. No workflow was edited.
diff --git a/docs-assets/quickstart/families/security/issue-import.svg b/docs-assets/quickstart/families/security/issue-import.svg
new file mode 100644
index 0000000..6efd199
--- /dev/null
+++ b/docs-assets/quickstart/families/security/issue-import.svg
@@ -0,0 +1,47 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 834 430"
+ width="834" height="430" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: issue-import">
+ <title>issue-import</title>
+ <rect width="834" height="430" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="834" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="834" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-security:issue-import</text>
+ <text x="28" y="136" fill="#c5c8c6"> Scanning security@ for reports with no tracker (last 14 days)</text>
+ <text x="28" y="188" fill="#c5c8c6"> 2 threads to import, 3 already tracked, 1 already answered and closed</text>
+ <text x="28" y="240" fill="#c5c8c6"> "Extractor writes outside the destination directory"</text>
+ <text x="28" y="266" fill="#c5c8c6"> -> new tracker, status Needs triage, receipt drafted to the reporter</text>
+ <text x="28" y="318" fill="#c5c8c6"> "Stack trace on malformed input"</text>
+ <text x="28" y="344" fill="#c5c8c6"> -> new tracker, status Needs triage, receipt drafted to the reporter</text>
+ <text x="28" y="396" fill="#c5c8c6"> Import both and draft the receipts? [Y/n]</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/security/issue-import.txt b/docs-assets/quickstart/families/security/issue-import.txt
new file mode 100644
index 0000000..820cd70
--- /dev/null
+++ b/docs-assets/quickstart/families/security/issue-import.txt
@@ -0,0 +1,33 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-security:issue-import
+
+ Scanning security@ for reports with no tracker (last 14 days)
+
+ 2 threads to import, 3 already tracked, 1 already answered and closed
+
+ "Extractor writes outside the destination directory"
+ -> new tracker, status Needs triage, receipt drafted to the reporter
+
+ "Stack trace on malformed input"
+ -> new tracker, status Needs triage, receipt drafted to the reporter
+
+ Import both and draft the receipts? [Y/n]
diff --git a/docs-assets/quickstart/families/security/issue-triage.svg b/docs-assets/quickstart/families/security/issue-triage.svg
new file mode 100644
index 0000000..f5c8d4f
--- /dev/null
+++ b/docs-assets/quickstart/families/security/issue-triage.svg
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 866 456"
+ width="866" height="456" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: issue-triage">
+ <title>issue-triage</title>
+ <rect width="866" height="456" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="866" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="866" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-security:issue-triage</text>
+ <text x="28" y="136" fill="#c5c8c6"> 4 trackers carry needs triage</text>
+ <text x="28" y="188" fill="#c5c8c6"> #218 path traversal in the archive extractor VALID</text>
+ <text x="28" y="214" fill="#c5c8c6"> #221 missing rate limit on the public status page DEFENSE-IN-DEPTH</text>
+ <text x="28" y="240" fill="#c5c8c6"> #223 "your TLS certificate expires soon" INFO-ONLY</text>
+ <text x="28" y="266" fill="#c5c8c6"> #224 same extractor bug, reported independently PROBABLE-DUP of #218</text>
+ <text x="28" y="318" fill="#c5c8c6"> Proposed dispositions are comments, not decisions. Posting one invites</text>
+ <text x="28" y="344" fill="#c5c8c6"> the security team to react; no label is flipped, nothing is closed, and</text>
+ <text x="28" y="370" fill="#c5c8c6"> no CVE is allocated here.</text>
+ <text x="28" y="422" fill="#c5c8c6"> Post all four? [y/N]</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/security/issue-triage.txt b/docs-assets/quickstart/families/security/issue-triage.txt
new file mode 100644
index 0000000..f4c0195
--- /dev/null
+++ b/docs-assets/quickstart/families/security/issue-triage.txt
@@ -0,0 +1,34 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-security:issue-triage
+
+ 4 trackers carry needs triage
+
+ #218 path traversal in the archive extractor VALID
+ #221 missing rate limit on the public status page DEFENSE-IN-DEPTH
+ #223 "your TLS certificate expires soon" INFO-ONLY
+ #224 same extractor bug, reported independently PROBABLE-DUP of #218
+
+ Proposed dispositions are comments, not decisions. Posting one invites
+ the security team to react; no label is flipped, nothing is closed, and
+ no CVE is allocated here.
+
+ Post all four? [y/N]
diff --git a/docs-assets/quickstart/families/security/model-verify.svg b/docs-assets/quickstart/families/security/model-verify.svg
new file mode 100644
index 0000000..f03622f
--- /dev/null
+++ b/docs-assets/quickstart/families/security/model-verify.svg
@@ -0,0 +1,47 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 856 404"
+ width="856" height="404" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: model-verify">
+ <title>model-verify</title>
+ <rect width="856" height="404" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="856" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="856" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-security:model-verify</text>
+ <text x="28" y="136" fill="#c5c8c6"> Verifying the threat model against the repository</text>
+ <text x="28" y="188" fill="#7f9f7f"> ✓ every trust boundary in the model has a component that implements it</text>
+ <text x="28" y="214" fill="#7f9f7f"> ✓ every entry point in the code appears in the model</text>
+ <text x="28" y="240" fill="#cc6666"> ✗ model names an "admin API" surface that no route serves any more</text>
+ <text x="28" y="292" fill="#c5c8c6"> One stale assertion. The model is a document that rots like any other;</text>
+ <text x="28" y="318" fill="#c5c8c6"> this is the check that notices.</text>
+ <text x="28" y="370" fill="#c5c8c6"> Nothing was edited - use model-update to propose the change.</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/security/model-verify.txt b/docs-assets/quickstart/families/security/model-verify.txt
new file mode 100644
index 0000000..0aca541
--- /dev/null
+++ b/docs-assets/quickstart/families/security/model-verify.txt
@@ -0,0 +1,32 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-security:model-verify
+
+ Verifying the threat model against the repository
+
+ ✓ every trust boundary in the model has a component that implements it
+ ✓ every entry point in the code appears in the model
+ ✗ model names an "admin API" surface that no route serves any more
+
+ One stale assertion. The model is a document that rots like any other;
+ this is the check that notices.
+
+ Nothing was edited - use model-update to propose the change.
diff --git a/docs-assets/quickstart/families/setup/isolated-setup-install.svg b/docs-assets/quickstart/families/setup/isolated-setup-install.svg
new file mode 100644
index 0000000..682f8f5
--- /dev/null
+++ b/docs-assets/quickstart/families/setup/isolated-setup-install.svg
@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 845 430"
+ width="845" height="430" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: isolated-setup-install">
+ <title>isolated-setup-install</title>
+ <rect width="845" height="430" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="845" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="845" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-setup:isolated-setup-install</text>
+ <text x="28" y="136" fill="#c5c8c6"> Proposed changes - nothing applied yet</text>
+ <text x="28" y="188" fill="#c5c8c6"> 1 .claude/settings.json sandbox on, 14 deny rules</text>
+ <text x="28" y="214" fill="#c5c8c6"> 2 ~/.claude/scripts/ 3 hooks and the status line</text>
+ <text x="28" y="240" fill="#c5c8c6"> 3 ~/.zshrc source agent-iso.sh</text>
+ <text x="28" y="292" fill="#c5c8c6"> Every step is shown before it runs. Nothing is written with sudo, no</text>
+ <text x="28" y="318" fill="#c5c8c6"> shell rc file is edited behind your back, and an existing settings.json</text>
+ <text x="28" y="344" fill="#c5c8c6"> is merged, never replaced.</text>
+ <text x="28" y="396" fill="#c5c8c6"> Apply 1-3? [y/N]</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/setup/isolated-setup-install.txt b/docs-assets/quickstart/families/setup/isolated-setup-install.txt
new file mode 100644
index 0000000..6d0ab8e
--- /dev/null
+++ b/docs-assets/quickstart/families/setup/isolated-setup-install.txt
@@ -0,0 +1,33 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-setup:isolated-setup-install
+
+ Proposed changes - nothing applied yet
+
+ 1 .claude/settings.json sandbox on, 14 deny rules
+ 2 ~/.claude/scripts/ 3 hooks and the status line
+ 3 ~/.zshrc source agent-iso.sh
+
+ Every step is shown before it runs. Nothing is written with sudo, no
+ shell rc file is edited behind your back, and an existing settings.json
+ is merged, never replaced.
+
+ Apply 1-3? [y/N]
diff --git a/docs-assets/quickstart/families/setup/isolated-setup-verify.svg b/docs-assets/quickstart/families/setup/isolated-setup-verify.svg
new file mode 100644
index 0000000..dca3c18
--- /dev/null
+++ b/docs-assets/quickstart/families/setup/isolated-setup-verify.svg
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 877 456"
+ width="877" height="456" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: isolated-setup-verify">
+ <title>isolated-setup-verify</title>
+ <rect width="877" height="456" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="877" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="877" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-setup:isolated-setup-verify</text>
+ <text x="28" y="136" fill="#c5c8c6"> Checking the secure-agent setup</text>
+ <text x="28" y="188" fill="#7f9f7f"> ✓ settings wiring sandbox, permissions and clean-env layers present</text>
+ <text x="28" y="214" fill="#7f9f7f"> ✓ bubblewrap installed, version recorded in the pin file</text>
+ <text x="28" y="240" fill="#7f9f7f"> ✓ socat installed</text>
+ <text x="28" y="266" fill="#7f9f7f"> ✓ agent socket reachable from inside the sandbox</text>
+ <text x="28" y="292" fill="#d8a657"> ⚠ docker socket not exposed - container work will fail in-session</text>
+ <text x="28" y="344" fill="#c5c8c6"> One warning. Entry 4 of the troubleshooting guide has the settings.json</text>
+ <text x="28" y="370" fill="#c5c8c6"> change that exposes the runtime socket, if you need it.</text>
+ <text x="28" y="422" fill="#c5c8c6"> Nothing was modified: this check is read-only.</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/setup/isolated-setup-verify.txt b/docs-assets/quickstart/families/setup/isolated-setup-verify.txt
new file mode 100644
index 0000000..be44156
--- /dev/null
+++ b/docs-assets/quickstart/families/setup/isolated-setup-verify.txt
@@ -0,0 +1,34 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-setup:isolated-setup-verify
+
+ Checking the secure-agent setup
+
+ ✓ settings wiring sandbox, permissions and clean-env layers present
+ ✓ bubblewrap installed, version recorded in the pin file
+ ✓ socat installed
+ ✓ agent socket reachable from inside the sandbox
+ ⚠ docker socket not exposed - container work will fail in-session
+
+ One warning. Entry 4 of the troubleshooting guide has the settings.json
+ change that exposes the runtime socket, if you need it.
+
+ Nothing was modified: this check is read-only.
diff --git a/docs-assets/quickstart/families/setup/status.svg b/docs-assets/quickstart/families/setup/status.svg
new file mode 100644
index 0000000..a2393c2
--- /dev/null
+++ b/docs-assets/quickstart/families/setup/status.svg
@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 802 404"
+ width="802" height="404" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: status">
+ <title>status</title>
+ <rect width="802" height="404" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="802" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="802" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-setup:status</text>
+ <text x="28" y="136" fill="#c5c8c6"> Install marketplace (apache-magpie), tracking main</text>
+ <text x="28" y="162" fill="#c5c8c6"> Plugins magpie-setup, magpie-utilities, magpie-agent-guard,</text>
+ <text x="28" y="188" fill="#c5c8c6"> magpie-pr-management</text>
+ <text x="28" y="214" fill="#c5c8c6"> Project floor .apache-magpie.lock - method: marketplace</text>
+ <text x="28" y="266" fill="#7f9f7f"> ✓ every floor plugin is installed and at or above the floor</text>
+ <text x="28" y="292" fill="#7f9f7f"> ✓ no drift between the committed floor and this machine</text>
+ <text x="28" y="344" fill="#c5c8c6"> Ahead of the floor is not drift: magpie-pr-management is yours, not</text>
+ <text x="28" y="370" fill="#c5c8c6"> the project's, and nothing will remove it.</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/setup/status.txt b/docs-assets/quickstart/families/setup/status.txt
new file mode 100644
index 0000000..51a9e76
--- /dev/null
+++ b/docs-assets/quickstart/families/setup/status.txt
@@ -0,0 +1,32 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-setup:status
+
+ Install marketplace (apache-magpie), tracking main
+ Plugins magpie-setup, magpie-utilities, magpie-agent-guard,
+ magpie-pr-management
+ Project floor .apache-magpie.lock - method: marketplace
+
+ ✓ every floor plugin is installed and at or above the floor
+ ✓ no drift between the committed floor and this machine
+
+ Ahead of the floor is not drift: magpie-pr-management is yours, not
+ the project's, and nothing will remove it.
diff --git a/docs-assets/quickstart/families/utilities/list-skills.svg b/docs-assets/quickstart/families/utilities/list-skills.svg
new file mode 100644
index 0000000..9265c14
--- /dev/null
+++ b/docs-assets/quickstart/families/utilities/list-skills.svg
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 834 482"
+ width="834" height="482" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: list-skills">
+ <title>list-skills</title>
+ <rect width="834" height="482" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="834" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="834" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-utilities:list-skills</text>
+ <text x="28" y="136" fill="#c5c8c6"> Installed here</text>
+ <text x="28" y="188" fill="#c5c8c6"> magpie-setup 9 skills install, upgrade, adopt, sandbox</text>
+ <text x="28" y="214" fill="#c5c8c6"> magpie-pr-management 8 skills triage, review, stats, quick-merge</text>
+ <text x="28" y="240" fill="#c5c8c6"> magpie-utilities 5 skills author and index your own skills</text>
+ <text x="28" y="292" fill="#c5c8c6"> Available in the marketplace, not installed</text>
+ <text x="28" y="344" fill="#c5c8c6"> magpie-security, magpie-release-management, magpie-issue,</text>
+ <text x="28" y="370" fill="#c5c8c6"> magpie-repo-health, magpie-contributor-growth, magpie-mentoring,</text>
+ <text x="28" y="396" fill="#c5c8c6"> magpie-pairing</text>
+ <text x="28" y="448" fill="#c5c8c6"> Ask about any of them by name and I will read that skill and answer.</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/utilities/list-skills.txt b/docs-assets/quickstart/families/utilities/list-skills.txt
new file mode 100644
index 0000000..f7b69e5
--- /dev/null
+++ b/docs-assets/quickstart/families/utilities/list-skills.txt
@@ -0,0 +1,35 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-utilities:list-skills
+
+ Installed here
+
+ magpie-setup 9 skills install, upgrade, adopt, sandbox
+ magpie-pr-management 8 skills triage, review, stats, quick-merge
+ magpie-utilities 5 skills author and index your own skills
+
+ Available in the marketplace, not installed
+
+ magpie-security, magpie-release-management, magpie-issue,
+ magpie-repo-health, magpie-contributor-growth, magpie-mentoring,
+ magpie-pairing
+
+ Ask about any of them by name and I will read that skill and answer.
diff --git a/docs-assets/quickstart/families/utilities/report-framework-issue.svg b/docs-assets/quickstart/families/utilities/report-framework-issue.svg
new file mode 100644
index 0000000..f049a05
--- /dev/null
+++ b/docs-assets/quickstart/families/utilities/report-framework-issue.svg
@@ -0,0 +1,47 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 856 404"
+ width="856" height="404" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: report-framework-issue">
+ <title>report-framework-issue</title>
+ <rect width="856" height="404" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="856" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="856" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-utilities:report-framework-issue</text>
+ <text x="28" y="136" fill="#c5c8c6"> You hit: setup-status misreports drift on a fork</text>
+ <text x="28" y="188" fill="#c5c8c6"> Searched apache/magpie</text>
+ <text x="28" y="214" fill="#c5c8c6"> no open issue matches</text>
+ <text x="28" y="240" fill="#c5c8c6"> no open PR matches</text>
+ <text x="28" y="292" fill="#c5c8c6"> Drafted an issue: what you were doing, what happened, what you expected,</text>
+ <text x="28" y="318" fill="#c5c8c6"> and the one command that reproduces it.</text>
+ <text x="28" y="370" fill="#c5c8c6"> This goes to the framework, not to your project. Open it? [y/N]</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/utilities/report-framework-issue.txt b/docs-assets/quickstart/families/utilities/report-framework-issue.txt
new file mode 100644
index 0000000..90253bf
--- /dev/null
+++ b/docs-assets/quickstart/families/utilities/report-framework-issue.txt
@@ -0,0 +1,32 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-utilities:report-framework-issue
+
+ You hit: setup-status misreports drift on a fork
+
+ Searched apache/magpie
+ no open issue matches
+ no open PR matches
+
+ Drafted an issue: what you were doing, what happened, what you expected,
+ and the one command that reproduces it.
+
+ This goes to the framework, not to your project. Open it? [y/N]
diff --git a/docs-assets/quickstart/families/utilities/write-skill.svg b/docs-assets/quickstart/families/utilities/write-skill.svg
new file mode 100644
index 0000000..fff4485
--- /dev/null
+++ b/docs-assets/quickstart/families/utilities/write-skill.svg
@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 845 456"
+ width="845" height="456" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: write-skill">
+ <title>write-skill</title>
+ <rect width="845" height="456" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="845" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="845" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-utilities:write-skill</text>
+ <text x="28" y="136" fill="#c5c8c6"> What should the skill do? Sweep stale release branches</text>
+ <text x="28" y="188" fill="#c5c8c6"> Drafting against the framework's conventions</text>
+ <text x="28" y="240" fill="#7f9f7f"> ✓ frontmatter name, description, family, mode, status</text>
+ <text x="28" y="266" fill="#7f9f7f"> ✓ pre-flight the shared block every skill runs first</text>
+ <text x="28" y="292" fill="#7f9f7f"> ✓ hard rules read-only by default; every state change confirmed</text>
+ <text x="28" y="318" fill="#d8a657"> ⚠ eval suite none yet - a skill without one is unverifiable</text>
+ <text x="28" y="370" fill="#c5c8c6"> Wrote the draft to skills/release-branch-sweep/SKILL.md.</text>
+ <text x="28" y="422" fill="#c5c8c6"> Next: the eval suite. It is the part that stops a rewrite breaking it.</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/families/utilities/write-skill.txt b/docs-assets/quickstart/families/utilities/write-skill.txt
new file mode 100644
index 0000000..2fe9877
--- /dev/null
+++ b/docs-assets/quickstart/families/utilities/write-skill.txt
@@ -0,0 +1,34 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-utilities:write-skill
+
+ What should the skill do? Sweep stale release branches
+
+ Drafting against the framework's conventions
+
+ ✓ frontmatter name, description, family, mode, status
+ ✓ pre-flight the shared block every skill runs first
+ ✓ hard rules read-only by default; every state change confirmed
+ ⚠ eval suite none yet - a skill without one is unverifiable
+
+ Wrote the draft to skills/release-branch-sweep/SKILL.md.
+
+ Next: the eval suite. It is the part that stops a rewrite breaking it.
diff --git a/docs-assets/quickstart/install.svg b/docs-assets/quickstart/install.svg
new file mode 100644
index 0000000..3176255
--- /dev/null
+++ b/docs-assets/quickstart/install.svg
@@ -0,0 +1,53 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE - do not edit.
+
+ Written by tools/dev/render-wizard.py. Illustrative of the shape of a
+ run, not a recording of one.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 675 520"
+ width="675" height="520" role="img"
+ data-magpie-generated="render-wizard"
+ aria-label="An animated first look: three install commands, then a triage run returning 38 open PRs with a proposed action for each and a confirmation prompt">
+ <title>Install Magpie, and use it</title>
+ <desc>Illustrative animation of installing Magpie and running one skill. Not a recording.</desc>
+ <rect width="675" height="520" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="675" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="675" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="17" xml:space="preserve">
+ <text x="26" y="80" fill="#8abeb7" opacity="0">> /plugin marketplace add apache/magpie<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0000;0.0010;1" dur="7.1s" repeatCount="indefinite"/></text>
+ <text x="26" y="104" fill="#8abeb7" opacity="0">> /plugin install magpie-setup@apache-magpie<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0532;0.0542;1" dur="7.1s" repeatCount="indefinite"/></text>
+ <text x="26" y="128" fill="#8abeb7" opacity="0">> /plugin install magpie-agent-guard@apache-magpie<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1064;0.1074;1" dur="7.1s" repeatCount="indefinite"/></text>
+ <text x="26" y="152" fill="#8abeb7" opacity="0">> /plugin install magpie-utilities@apache-magpie<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1597;0.1607;1" dur="7.1s" repeatCount="indefinite"/></text>
+ <text x="26" y="176" fill="#8abeb7" opacity="0">> /plugin install magpie-pr-management@apache-magpie<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.2129;0.2139;1" dur="7.1s" repeatCount="indefinite"/></text>
+ <text x="26" y="224" fill="#7f9f7f" opacity="0"> ✓ baseline + one family - nothing written to the repository<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.2661;0.2671;1" dur="7.1s" repeatCount="indefinite"/></text>
+ <text x="26" y="272" fill="#8abeb7" opacity="0">> /magpie-pr-management:triage<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3193;0.3203;1" dur="7.1s" repeatCount="indefinite"/></text>
+ <text x="26" y="320" fill="#c5c8c6" opacity="0"> 38 open PRs, 12 untriaged<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3725;0.3735;1" dur="7.1s" repeatCount="indefinite"/></text>
+ <text x="26" y="368" fill="#c5c8c6" opacity="0"> #1421 first contribution, CI green, no reviewer<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.4258;0.4268;1" dur="7.1s" repeatCount="indefinite"/></text>
+ <text x="26" y="392" fill="#8a8f94" opacity="0"> -> mark ready for maintainer review<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.4790;0.4800;1" dur="7.1s" repeatCount="indefinite"/></text>
+ <text x="26" y="416" fill="#c5c8c6" opacity="0"> #1388 draft 3 weeks, no commits since<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5322;0.5332;1" dur="7.1s" repeatCount="indefinite"/></text>
+ <text x="26" y="440" fill="#8a8f94" opacity="0"> -> ask the author if it is still active<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5854;0.5864;1" dur="7.1s" repeatCount="indefinite"/></text>
+ <text x="26" y="488" fill="#8a8f94" opacity="0"> Each action needs your confirmation. [Y/n]<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.6387;0.6397;1" dur="7.1s" repeatCount="indefinite"/></text>
+ <rect x="26" y="475" width="10" height="17" fill="#c5c8c6"><animate attributeName="opacity" values="1;1;0;0;1" dur="1.2s" repeatCount="indefinite"/></rect>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/magpie-setup.svg b/docs-assets/quickstart/magpie-setup.svg
new file mode 100644
index 0000000..dd7abfa
--- /dev/null
+++ b/docs-assets/quickstart/magpie-setup.svg
@@ -0,0 +1,69 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE - do not edit.
+
+ Written by tools/dev/render-wizard.py. Illustrative of the shape of a
+ run, not a recording of one.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 726 1024"
+ width="726" height="1024" role="img"
+ data-magpie-generated="render-wizard"
+ aria-label="An animated first run of /magpie-setup: the agent detected, the skill families picked, the install commands emitted, then the secure-agent setup applying the sandbox, the clean-environment wrapper, the hooks and the status line">
+ <title>/magpie-setup — the first run</title>
+ <desc>Illustrative animation of a first /magpie-setup run and the secure-agent setup that follows it. Not a recording.</desc>
+ <rect width="726" height="1024" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="726" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="726" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="17" xml:space="preserve">
+ <text x="26" y="80" fill="#8abeb7" opacity="0">> /magpie-setup<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0000;0.0010;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <text x="26" y="128" fill="#8a8f94" opacity="0"> Agent Claude Code<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0287;0.0297;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <text x="26" y="152" fill="#8a8f94" opacity="0"> Installed nothing yet<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0575;0.0585;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <text x="26" y="176" fill="#8a8f94" opacity="0"> Repo github.com/acme/toolkit, not adopted<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0862;0.0872;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <text x="26" y="224" fill="#c5c8c6" opacity="0"> Which families? The baseline three are ticked already.<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1150;0.1160;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <text x="26" y="248" fill="#7f9f7f" opacity="0"> [x] setup install, upgrade, adopt, sandbox<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1437;0.1447;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <text x="26" y="272" fill="#7f9f7f" opacity="0"> [x] agent-guard denies dangerous commands before they run<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1725;0.1735;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <text x="26" y="296" fill="#7f9f7f" opacity="0"> [x] utilities author and index your own skills<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.2012;0.2022;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <text x="26" y="320" fill="#7f9f7f" opacity="0"> [x] pr-management you said "triage"<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.2300;0.2310;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <text x="26" y="344" fill="#8a8f94" opacity="0"> [ ] security [ ] issue [ ] release-management [ ] …<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.2587;0.2597;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <text x="26" y="392" fill="#c5c8c6" opacity="0"> Installing 4 plugins for you - user scope:<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.2874;0.2884;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <text x="26" y="416" fill="#7f9f7f" opacity="0"> ✓ apache-magpie marketplace added<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3162;0.3172;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <text x="26" y="440" fill="#7f9f7f" opacity="0"> ✓ magpie-setup ✓ magpie-agent-guard<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3449;0.3459;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <text x="26" y="464" fill="#7f9f7f" opacity="0"> ✓ magpie-utilities ✓ magpie-pr-management<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3737;0.3747;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <text x="26" y="512" fill="#8a8f94" opacity="0"> Live in your next session. Nothing was written to the<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.4024;0.4034;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <text x="26" y="536" fill="#8a8f94" opacity="0"> repository - that is the finished state.<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.4312;0.4322;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <text x="26" y="584" fill="#d8a657" opacity="0"> One follow-up that is not optional - these skills read<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.4599;0.4609;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <text x="26" y="608" fill="#d8a657" opacity="0"> pre-disclosure security content, so sandbox the agent:<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.4887;0.4897;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <text x="26" y="656" fill="#8abeb7" opacity="0">> /magpie-setup:isolated-setup-install<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5174;0.5184;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <text x="26" y="704" fill="#c5c8c6" opacity="0"> Proposed - nothing applied yet:<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5461;0.5471;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <text x="26" y="728" fill="#c5c8c6" opacity="0"> 1 .claude/settings.json sandbox on, 14 deny rules<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5749;0.5759;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <text x="26" y="752" fill="#c5c8c6" opacity="0"> 2 ~/.claude/scripts/ 3 hooks and the status line<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.6036;0.6046;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <text x="26" y="776" fill="#c5c8c6" opacity="0"> 3 ~/.zshrc source agent-iso.sh<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.6324;0.6334;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <text x="26" y="824" fill="#c5c8c6" opacity="0"> Apply 1-3? [y/N] y<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.6611;0.6621;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <text x="26" y="872" fill="#7f9f7f" opacity="0"> ✓ sandbox filesystem and network confined to this repo<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.6899;0.6909;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <text x="26" y="896" fill="#7f9f7f" opacity="0"> ✓ clean env credentials stripped before the agent starts<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.7186;0.7196;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <text x="26" y="920" fill="#7f9f7f" opacity="0"> ✓ status line shows the sandbox state and the Magpie version<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.7474;0.7484;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <text x="26" y="968" fill="#8a8f94" opacity="0"> Run a skill when you are ready. The first one that needs project<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.7761;0.7771;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <text x="26" y="992" fill="#8a8f94" opacity="0"> configuration writes it itself, into gitignored files.<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.8048;0.8058;1" dur="13.2s" repeatCount="indefinite"/></text>
+ <rect x="26" y="979" width="10" height="17" fill="#c5c8c6"><animate attributeName="opacity" values="1;1;0;0;1" dur="1.2s" repeatCount="indefinite"/></rect>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/step-adopt.svg b/docs-assets/quickstart/step-adopt.svg
new file mode 100644
index 0000000..6462870
--- /dev/null
+++ b/docs-assets/quickstart/step-adopt.svg
@@ -0,0 +1,50 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE - do not edit.
+
+ Written by tools/dev/render-wizard.py. Illustrative of the shape of a
+ run, not a recording of one.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 685 424"
+ width="685" height="424" role="img"
+ data-magpie-generated="render-wizard"
+ aria-label="An animated adopt run: three paths staged and not committed, what a contributor gets on clone, and what it does not restrict">
+ <title>Step 6 — adopt it for the project</title>
+ <desc>Illustrative animation of adopting Magpie for a project. Not a recording.</desc>
+ <rect width="685" height="424" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="685" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="685" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="17" xml:space="preserve">
+ <text x="26" y="80" fill="#d8a657" opacity="0"> Only if you are a maintainer, deciding with the others.<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0000;0.0010;1" dur="6.0s" repeatCount="indefinite"/></text>
+ <text x="26" y="128" fill="#8abeb7" opacity="0">> /magpie-setup adopt<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0633;0.0643;1" dur="6.0s" repeatCount="indefinite"/></text>
+ <text x="26" y="176" fill="#c5c8c6" opacity="0"> Staged, not committed:<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1267;0.1277;1" dur="6.0s" repeatCount="indefinite"/></text>
+ <text x="26" y="200" fill="#c5c8c6" opacity="0"> .apache-magpie.lock the floor - a minimum, not a pin<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1900;0.1910;1" dur="6.0s" repeatCount="indefinite"/></text>
+ <text x="26" y="224" fill="#c5c8c6" opacity="0"> .claude/settings.json derived from it<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.2533;0.2543;1" dur="6.0s" repeatCount="indefinite"/></text>
+ <text x="26" y="248" fill="#c5c8c6" opacity="0"> .apache-magpie-overrides/ the project's configuration<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3167;0.3177;1" dur="6.0s" repeatCount="indefinite"/></text>
+ <text x="26" y="296" fill="#7f9f7f" opacity="0"> ✓ a contributor who clones this arrives with the floor<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3800;0.3810;1" dur="6.0s" repeatCount="indefinite"/></text>
+ <text x="26" y="320" fill="#7f9f7f" opacity="0"> ✓ review it and commit it like any other change<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.4433;0.4443;1" dur="6.0s" repeatCount="indefinite"/></text>
+ <text x="26" y="368" fill="#8a8f94" opacity="0"> It limits nobody: anyone may install more, run a newer<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5067;0.5077;1" dur="6.0s" repeatCount="indefinite"/></text>
+ <text x="26" y="392" fill="#8a8f94" opacity="0"> Magpie, or ignore the recommendation entirely.<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5700;0.5710;1" dur="6.0s" repeatCount="indefinite"/></text>
+ <rect x="26" y="379" width="10" height="17" fill="#c5c8c6"><animate attributeName="opacity" values="1;1;0;0;1" dur="1.2s" repeatCount="indefinite"/></rect>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/step-guard.svg b/docs-assets/quickstart/step-guard.svg
new file mode 100644
index 0000000..8c65180
--- /dev/null
+++ b/docs-assets/quickstart/step-guard.svg
@@ -0,0 +1,54 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE - do not edit.
+
+ Written by tools/dev/render-wizard.py. Illustrative of the shape of a
+ run, not a recording of one.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 777 592"
+ width="777" height="592" role="img"
+ data-magpie-generated="render-wizard"
+ aria-label="An animated agent-guard setup: the dispatcher, the rules and the PreToolUse hook registered, then a real denial of an unwanted review ping before it was posted">
+ <title>Step 3 — isolate & guard: the action guard</title>
+ <desc>Illustrative animation of the deterministic action guard. Not a recording.</desc>
+ <rect width="777" height="592" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="777" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="777" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="17" xml:space="preserve">
+ <text x="26" y="80" fill="#8abeb7" opacity="0">> /magpie-setup:isolated-setup-install<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0000;0.0010;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="128" fill="#c5c8c6" opacity="0"> Registering the deterministic guard:<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0505;0.0515;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="152" fill="#c5c8c6" opacity="0"> ~/.claude/scripts/agent-guard.py the dispatcher<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1011;0.1021;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="176" fill="#c5c8c6" opacity="0"> ~/.claude/scripts/guards.d/ 5 rules, bundled + skill-owned<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1516;0.1526;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="200" fill="#c5c8c6" opacity="0"> .claude/settings.json PreToolUse hook on Bash<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.2021;0.2031;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="248" fill="#7f9f7f" opacity="0"> ✓ every shell command is inspected before it runs<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.2527;0.2537;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="296" fill="#8a8f94" opacity="0"> Later that session -<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3032;0.3042;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="344" fill="#8abeb7" opacity="0">> gh pr comment 1421 --body "@alice @bob please take a look"<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3537;0.3547;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="392" fill="#d8a657" opacity="0"> ⚠ agent-guard[mention] denied this before it ran<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.4043;0.4053;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="440" fill="#c5c8c6" opacity="0"> A review ping to two maintainers who did not ask for it.<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.4548;0.4558;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="464" fill="#c5c8c6" opacity="0"> The author is @carol - anyone else is noise.<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5053;0.5063;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="488" fill="#8a8f94" opacity="0"> Fix: write `alice` in backticks, or MAGPIE_ALLOW_MENTIONS=1.<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5559;0.5569;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="536" fill="#8a8f94" opacity="0"> Nothing was posted. The rule is code, not a line in a SKILL.md<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.6064;0.6074;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="560" fill="#8a8f94" opacity="0"> the model has to remember - so it holds on the turn it matters.<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.6569;0.6579;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <rect x="26" y="547" width="10" height="17" fill="#c5c8c6"><animate attributeName="opacity" values="1;1;0;0;1" dur="1.2s" repeatCount="indefinite"/></rect>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/step-install.svg b/docs-assets/quickstart/step-install.svg
new file mode 100644
index 0000000..6123f15
--- /dev/null
+++ b/docs-assets/quickstart/step-install.svg
@@ -0,0 +1,55 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE - do not edit.
+
+ Written by tools/dev/render-wizard.py. Illustrative of the shape of a
+ run, not a recording of one.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 685 592"
+ width="685" height="592" role="img"
+ data-magpie-generated="render-wizard"
+ aria-label="An animated marketplace install: adding apache-magpie, then installing magpie-setup and one family, with nothing written to the repository">
+ <title>Step 1 — install from the marketplace</title>
+ <desc>Illustrative animation of the marketplace install step. Not a recording.</desc>
+ <rect width="685" height="592" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="685" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="685" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="17" xml:space="preserve">
+ <text x="26" y="80" fill="#8abeb7" opacity="0">> /plugin marketplace add apache/magpie<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0000;0.0010;1" dur="7.9s" repeatCount="indefinite"/></text>
+ <text x="26" y="128" fill="#7f9f7f" opacity="0"> ✓ apache-magpie added<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0481;0.0491;1" dur="7.9s" repeatCount="indefinite"/></text>
+ <text x="26" y="176" fill="#8abeb7" opacity="0">> /plugin install magpie-setup@apache-magpie<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0962;0.0972;1" dur="7.9s" repeatCount="indefinite"/></text>
+ <text x="26" y="200" fill="#7f9f7f" opacity="0"> ✓ magpie-setup install this one first - nothing<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1443;0.1453;1" dur="7.9s" repeatCount="indefinite"/></text>
+ <text x="26" y="224" fill="#8a8f94" opacity="0"> else installs or upgrades without it<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1924;0.1934;1" dur="7.9s" repeatCount="indefinite"/></text>
+ <text x="26" y="272" fill="#8abeb7" opacity="0">> /plugin install magpie-agent-guard@apache-magpie<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.2405;0.2415;1" dur="7.9s" repeatCount="indefinite"/></text>
+ <text x="26" y="296" fill="#7f9f7f" opacity="0"> ✓ magpie-agent-guard denies dangerous shell shapes before<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.2886;0.2896;1" dur="7.9s" repeatCount="indefinite"/></text>
+ <text x="26" y="320" fill="#8a8f94" opacity="0"> they run<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3367;0.3377;1" dur="7.9s" repeatCount="indefinite"/></text>
+ <text x="26" y="368" fill="#8abeb7" opacity="0">> /plugin install magpie-utilities@apache-magpie<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3848;0.3858;1" dur="7.9s" repeatCount="indefinite"/></text>
+ <text x="26" y="392" fill="#7f9f7f" opacity="0"> ✓ magpie-utilities list-skills, and the small tools<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.4329;0.4339;1" dur="7.9s" repeatCount="indefinite"/></text>
+ <text x="26" y="440" fill="#8abeb7" opacity="0">> /plugin install magpie-pr-management@apache-magpie<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.4810;0.4820;1" dur="7.9s" repeatCount="indefinite"/></text>
+ <text x="26" y="464" fill="#7f9f7f" opacity="0"> ✓ magpie-pr-management the family you picked<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5291;0.5301;1" dur="7.9s" repeatCount="indefinite"/></text>
+ <text x="26" y="512" fill="#8a8f94" opacity="0"> The first three are the baseline - the same set a project<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5772;0.5782;1" dur="7.9s" repeatCount="indefinite"/></text>
+ <text x="26" y="536" fill="#8a8f94" opacity="0"> commits when it adopts. Nothing was written to this<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.6253;0.6263;1" dur="7.9s" repeatCount="indefinite"/></text>
+ <text x="26" y="560" fill="#8a8f94" opacity="0"> repository, and your teammates are unaffected.<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.6734;0.6744;1" dur="7.9s" repeatCount="indefinite"/></text>
+ <rect x="26" y="547" width="10" height="17" fill="#c5c8c6"><animate attributeName="opacity" values="1;1;0;0;1" dur="1.2s" repeatCount="indefinite"/></rect>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/step-isolation.svg b/docs-assets/quickstart/step-isolation.svg
new file mode 100644
index 0000000..3b96629
--- /dev/null
+++ b/docs-assets/quickstart/step-isolation.svg
@@ -0,0 +1,51 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE - do not edit.
+
+ Written by tools/dev/render-wizard.py. Illustrative of the shape of a
+ run, not a recording of one.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 685 448"
+ width="685" height="448" role="img"
+ data-magpie-generated="render-wizard"
+ aria-label="An animated secure-agent setup: three proposed changes, a confirmation, then the sandbox, the clean environment and the status line in place">
+ <title>Step 3 — isolate & guard: the sandbox</title>
+ <desc>Illustrative animation of the secure-agent setup step. Not a recording.</desc>
+ <rect width="685" height="448" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="685" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="685" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="17" xml:space="preserve">
+ <text x="26" y="80" fill="#8abeb7" opacity="0">> /magpie-setup:isolated-setup-install<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0000;0.0010;1" dur="6.4s" repeatCount="indefinite"/></text>
+ <text x="26" y="128" fill="#c5c8c6" opacity="0"> Proposed - nothing applied yet:<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0596;0.0606;1" dur="6.4s" repeatCount="indefinite"/></text>
+ <text x="26" y="152" fill="#c5c8c6" opacity="0"> 1 .claude/settings.json sandbox on, credential denies<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1191;0.1201;1" dur="6.4s" repeatCount="indefinite"/></text>
+ <text x="26" y="176" fill="#c5c8c6" opacity="0"> 2 ~/.claude/scripts/ hooks and the status line<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1787;0.1797;1" dur="6.4s" repeatCount="indefinite"/></text>
+ <text x="26" y="200" fill="#c5c8c6" opacity="0"> 3 ~/.zshrc source agent-iso.sh<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.2382;0.2392;1" dur="6.4s" repeatCount="indefinite"/></text>
+ <text x="26" y="248" fill="#c5c8c6" opacity="0"> Apply 1-3? [y/N] y<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.2978;0.2988;1" dur="6.4s" repeatCount="indefinite"/></text>
+ <text x="26" y="296" fill="#7f9f7f" opacity="0"> ✓ sandbox bash sees only the paths you allow<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3574;0.3584;1" dur="6.4s" repeatCount="indefinite"/></text>
+ <text x="26" y="320" fill="#7f9f7f" opacity="0"> ✓ clean env credentials stripped before the agent starts<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.4169;0.4179;1" dur="6.4s" repeatCount="indefinite"/></text>
+ <text x="26" y="344" fill="#7f9f7f" opacity="0"> ✓ status line [sandbox] in the footer, green when it is on<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.4765;0.4775;1" dur="6.4s" repeatCount="indefinite"/></text>
+ <text x="26" y="392" fill="#8a8f94" opacity="0"> Your ~/.ssh, ~/.aws and tokens are out of reach. Every sudo,<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5361;0.5371;1" dur="6.4s" repeatCount="indefinite"/></text>
+ <text x="26" y="416" fill="#8a8f94" opacity="0"> shell-rc and settings change was shown before it ran.<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5956;0.5966;1" dur="6.4s" repeatCount="indefinite"/></text>
+ <rect x="26" y="403" width="10" height="17" fill="#c5c8c6"><animate attributeName="opacity" values="1;1;0;0;1" dur="1.2s" repeatCount="indefinite"/></rect>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/step-privacy.svg b/docs-assets/quickstart/step-privacy.svg
new file mode 100644
index 0000000..14ad194
--- /dev/null
+++ b/docs-assets/quickstart/step-privacy.svg
@@ -0,0 +1,54 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE - do not edit.
+
+ Written by tools/dev/render-wizard.py. Illustrative of the shape of a
+ run, not a recording of one.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 675 544"
+ width="675" height="544" role="img"
+ data-magpie-generated="render-wizard"
+ aria-label="An animated privacy-llm run: the stack detected, the variant written locally, the PII redactor proven, and the approved-LLM gate refusing an unregistered local model">
+ <title>Step 4 — set up privacy</title>
+ <desc>Illustrative animation of the privacy-LLM setup. Not a recording.</desc>
+ <rect width="675" height="544" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="675" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="675" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="17" xml:space="preserve">
+ <text x="26" y="80" fill="#8abeb7" opacity="0">> /magpie-setup:privacy-llm<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0000;0.0010;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="128" fill="#c5c8c6" opacity="0"> Detected, not asked:<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0505;0.0515;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="152" fill="#c5c8c6" opacity="0"> agent Claude Code<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1011;0.1021;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="176" fill="#c5c8c6" opacity="0"> local inference ollama, llama3.1:70b on :11434<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1516;0.1526;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="200" fill="#c5c8c6" opacity="0"> private lists private@acme.apache.org<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.2021;0.2031;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="248" fill="#c5c8c6" opacity="0"> That is variant 2 - local inference. Written to<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.2527;0.2537;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="272" fill="#c5c8c6" opacity="0"> .apache-magpie-local/privacy-llm.md (gitignored, yours)<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3032;0.3042;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="320" fill="#7f9f7f" opacity="0"> ✓ PII redactor Other Researcher -> N-a3f9d2<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3537;0.3547;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="344" fill="#7f9f7f" opacity="0"> other@example.com -> E-7c1b04<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.4043;0.4053;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="392" fill="#d8a657" opacity="0"> ⚠ approved-LLM gate: llama3.1:70b is not in the registry<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.4548;0.4558;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="440" fill="#c5c8c6" opacity="0"> Until it is, skills will refuse to fetch private@ mail.<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5053;0.5063;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="464" fill="#8a8f94" opacity="0"> Drop it from the stack, or take the opt-in recipe for it.<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5559;0.5569;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="488" fill="#8a8f94" opacity="0"> Nothing was widened to make this pass - the gate failing<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.6064;0.6074;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="512" fill="#8a8f94" opacity="0"> is the answer, not an obstacle.<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.6569;0.6579;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <rect x="26" y="499" width="10" height="17" fill="#c5c8c6"><animate attributeName="opacity" values="1;1;0;0;1" dur="1.2s" repeatCount="indefinite"/></rect>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/step-use.svg b/docs-assets/quickstart/step-use.svg
new file mode 100644
index 0000000..d5f94ad
--- /dev/null
+++ b/docs-assets/quickstart/step-use.svg
@@ -0,0 +1,51 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE - do not edit.
+
+ Written by tools/dev/render-wizard.py. Illustrative of the shape of a
+ run, not a recording of one.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 654 472"
+ width="654" height="472" role="img"
+ data-magpie-generated="render-wizard"
+ aria-label="An animated skill run: listing what is installed, then a triage pass returning 38 open PRs with a proposed action each and nothing posted">
+ <title>Step 5 — use it</title>
+ <desc>Illustrative animation of running a skill. Not a recording.</desc>
+ <rect width="654" height="472" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="654" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="654" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="17" xml:space="preserve">
+ <text x="26" y="80" fill="#8abeb7" opacity="0">> /magpie-utilities:list-skills<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0000;0.0010;1" dur="6.4s" repeatCount="indefinite"/></text>
+ <text x="26" y="128" fill="#c5c8c6" opacity="0"> magpie-setup install, upgrade, adopt, sandbox<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0596;0.0606;1" dur="6.4s" repeatCount="indefinite"/></text>
+ <text x="26" y="152" fill="#c5c8c6" opacity="0"> magpie-utilities author and index your own skills<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1191;0.1201;1" dur="6.4s" repeatCount="indefinite"/></text>
+ <text x="26" y="176" fill="#c5c8c6" opacity="0"> magpie-pr-management triage, review, stats, quick-merge<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1787;0.1797;1" dur="6.4s" repeatCount="indefinite"/></text>
+ <text x="26" y="224" fill="#8abeb7" opacity="0">> /magpie-pr-management:triage<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.2382;0.2392;1" dur="6.4s" repeatCount="indefinite"/></text>
+ <text x="26" y="272" fill="#c5c8c6" opacity="0"> 38 open PRs, 12 untriaged<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.2978;0.2988;1" dur="6.4s" repeatCount="indefinite"/></text>
+ <text x="26" y="320" fill="#c5c8c6" opacity="0"> #1421 first contribution, CI green, no reviewer<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3574;0.3584;1" dur="6.4s" repeatCount="indefinite"/></text>
+ <text x="26" y="344" fill="#8a8f94" opacity="0"> -> mark ready for maintainer review<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.4169;0.4179;1" dur="6.4s" repeatCount="indefinite"/></text>
+ <text x="26" y="368" fill="#c5c8c6" opacity="0"> #1402 branch 200 commits behind, conflicts<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.4765;0.4775;1" dur="6.4s" repeatCount="indefinite"/></text>
+ <text x="26" y="392" fill="#8a8f94" opacity="0"> -> ask the author to rebase<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5361;0.5371;1" dur="6.4s" repeatCount="indefinite"/></text>
+ <text x="26" y="440" fill="#7f9f7f" opacity="0"> Nothing has been posted. Every action waits for you.<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5956;0.5966;1" dur="6.4s" repeatCount="indefinite"/></text>
+ <rect x="26" y="427" width="10" height="17" fill="#c5c8c6"><animate attributeName="opacity" values="1;1;0;0;1" dur="1.2s" repeatCount="indefinite"/></rect>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/walkthrough/1-preflight-stops.svg b/docs-assets/quickstart/walkthrough/1-preflight-stops.svg
new file mode 100644
index 0000000..46f0dae
--- /dev/null
+++ b/docs-assets/quickstart/walkthrough/1-preflight-stops.svg
@@ -0,0 +1,47 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 791 404"
+ width="791" height="404" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: 1-preflight-stops">
+ <title>1-preflight-stops</title>
+ <rect width="791" height="404" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="791" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="791" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-pr-management:triage</text>
+ <text x="28" y="136" fill="#c5c8c6"> Pre-flight</text>
+ <text x="28" y="188" fill="#7f9f7f"> ✓ plugin installed magpie-pr-management</text>
+ <text x="28" y="214" fill="#cc6666"> ✗ project configuration 3 required files, none found</text>
+ <text x="28" y="266" fill="#c5c8c6"> Triage needs to know this project's committer team, its area-label</text>
+ <text x="28" y="292" fill="#c5c8c6"> prefix, and which labels mean "ready" - none of which I can infer.</text>
+ <text x="28" y="344" fill="#c5c8c6"> Configuring now. This writes gitignored files in your clone only:</text>
+ <text x="28" y="370" fill="#c5c8c6"> nothing staged, nothing committed, nobody else affected.</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/walkthrough/1-preflight-stops.txt b/docs-assets/quickstart/walkthrough/1-preflight-stops.txt
new file mode 100644
index 0000000..ddb81e3
--- /dev/null
+++ b/docs-assets/quickstart/walkthrough/1-preflight-stops.txt
@@ -0,0 +1,32 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-pr-management:triage
+
+ Pre-flight
+
+ ✓ plugin installed magpie-pr-management
+ ✗ project configuration 3 required files, none found
+
+ Triage needs to know this project's committer team, its area-label
+ prefix, and which labels mean "ready" - none of which I can infer.
+
+ Configuring now. This writes gitignored files in your clone only:
+ nothing staged, nothing committed, nobody else affected.
diff --git a/docs-assets/quickstart/walkthrough/2-config-wizard.svg b/docs-assets/quickstart/walkthrough/2-config-wizard.svg
new file mode 100644
index 0000000..7ee3660
--- /dev/null
+++ b/docs-assets/quickstart/walkthrough/2-config-wizard.svg
@@ -0,0 +1,47 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 877 404"
+ width="877" height="404" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: 2-config-wizard">
+ <title>2-config-wizard</title>
+ <rect width="877" height="404" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="877" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="877" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#c5c8c6"> Derived from the repository:</text>
+ <text x="28" y="136" fill="#c5c8c6"> project.md upstream_repo acme/toolkit (origin remote)</text>
+ <text x="28" y="162" fill="#c5c8c6"> pr-management-config.md area_prefix area: (17 labels use it)</text>
+ <text x="28" y="214" fill="#c5c8c6"> Three values left. One question:</text>
+ <text x="28" y="266" fill="#c5c8c6"> tracker_url ?</text>
+ <text x="28" y="292" fill="#c5c8c6"> committers team ?</text>
+ <text x="28" y="318" fill="#c5c8c6"> comment footer ?</text>
+ <text x="28" y="370" fill="#c5c8c6"> Answer, or skip any of them - a TODO left in place is not an error.</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/walkthrough/2-config-wizard.txt b/docs-assets/quickstart/walkthrough/2-config-wizard.txt
new file mode 100644
index 0000000..a0d4078
--- /dev/null
+++ b/docs-assets/quickstart/walkthrough/2-config-wizard.txt
@@ -0,0 +1,32 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+ Derived from the repository:
+
+ project.md upstream_repo acme/toolkit (origin remote)
+ pr-management-config.md area_prefix area: (17 labels use it)
+
+ Three values left. One question:
+
+ tracker_url ?
+ committers team ?
+ comment footer ?
+
+ Answer, or skip any of them - a TODO left in place is not an error.
diff --git a/docs-assets/quickstart/walkthrough/3-scaffolded.svg b/docs-assets/quickstart/walkthrough/3-scaffolded.svg
new file mode 100644
index 0000000..0feb071
--- /dev/null
+++ b/docs-assets/quickstart/walkthrough/3-scaffolded.svg
@@ -0,0 +1,50 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 834 534"
+ width="834" height="534" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: 3-scaffolded">
+ <title>3-scaffolded</title>
+ <rect width="834" height="534" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="834" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="834" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-setup config</text>
+ <text x="28" y="136" fill="#c5c8c6"> Written to .apache-magpie-local/ - gitignored, this clone only</text>
+ <text x="28" y="188" fill="#c5c8c6"> project.md 2 values, 1 TODO</text>
+ <text x="28" y="214" fill="#c5c8c6"> pr-management-config.md 2 values, 1 TODO</text>
+ <text x="28" y="240" fill="#c5c8c6"> pr-management-triage-comment-templates.md 0 values, 4 TODO</text>
+ <text x="28" y="292" fill="#c5c8c6"> Added /.apache-magpie-local/ to .git/info/exclude, not to .gitignore -</text>
+ <text x="28" y="318" fill="#c5c8c6"> .gitignore is committed, and nothing here should be.</text>
+ <text x="28" y="370" fill="#c5c8c6"> Nothing staged. Nothing committed. No teammate sees any of this.</text>
+ <text x="28" y="422" fill="#7f9f7f"> ✓ magpie-pr-management:triage can run now</text>
+ <text x="28" y="474" fill="#c5c8c6"> A TODO left in place is not an error: the skill that needs one names</text>
+ <text x="28" y="500" fill="#c5c8c6"> it when it needs it, and the skills that do not never look.</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/walkthrough/3-scaffolded.txt b/docs-assets/quickstart/walkthrough/3-scaffolded.txt
new file mode 100644
index 0000000..3e30e29
--- /dev/null
+++ b/docs-assets/quickstart/walkthrough/3-scaffolded.txt
@@ -0,0 +1,37 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-setup config
+
+ Written to .apache-magpie-local/ - gitignored, this clone only
+
+ project.md 2 values, 1 TODO
+ pr-management-config.md 2 values, 1 TODO
+ pr-management-triage-comment-templates.md 0 values, 4 TODO
+
+ Added /.apache-magpie-local/ to .git/info/exclude, not to .gitignore -
+ .gitignore is committed, and nothing here should be.
+
+ Nothing staged. Nothing committed. No teammate sees any of this.
+
+ ✓ magpie-pr-management:triage can run now
+
+ A TODO left in place is not an error: the skill that needs one names
+ it when it needs it, and the skills that do not never look.
diff --git a/docs-assets/quickstart/walkthrough/4-it-runs.svg b/docs-assets/quickstart/walkthrough/4-it-runs.svg
new file mode 100644
index 0000000..1d5b1b5
--- /dev/null
+++ b/docs-assets/quickstart/walkthrough/4-it-runs.svg
@@ -0,0 +1,47 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 802 404"
+ width="802" height="404" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: 4-it-runs">
+ <title>4-it-runs</title>
+ <rect width="802" height="404" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="802" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="802" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-pr-management:triage</text>
+ <text x="28" y="136" fill="#c5c8c6"> Pre-flight ✓ plugin installed ✓ project configuration</text>
+ <text x="28" y="188" fill="#c5c8c6"> 38 open PRs, 12 untriaged</text>
+ <text x="28" y="240" fill="#c5c8c6"> #1421 first-time contributor, CI green, no reviewer</text>
+ <text x="28" y="266" fill="#c5c8c6"> -> mark ready for maintainer review</text>
+ <text x="28" y="292" fill="#c5c8c6"> #1388 draft for 3 weeks, no commits since</text>
+ <text x="28" y="318" fill="#c5c8c6"> -> comment asking whether it is still active</text>
+ <text x="28" y="370" fill="#c5c8c6"> Each action needs your confirmation. Walk them one at a time? [Y/n]</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/walkthrough/4-it-runs.txt b/docs-assets/quickstart/walkthrough/4-it-runs.txt
new file mode 100644
index 0000000..164cc48
--- /dev/null
+++ b/docs-assets/quickstart/walkthrough/4-it-runs.txt
@@ -0,0 +1,32 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-pr-management:triage
+
+ Pre-flight ✓ plugin installed ✓ project configuration
+
+ 38 open PRs, 12 untriaged
+
+ #1421 first-time contributor, CI green, no reviewer
+ -> mark ready for maintainer review
+ #1388 draft for 3 weeks, no commits since
+ -> comment asking whether it is still active
+
+ Each action needs your confirmation. Walk them one at a time? [Y/n]
diff --git a/docs-assets/quickstart/walkthrough/5-adopt-promotes.svg b/docs-assets/quickstart/walkthrough/5-adopt-promotes.svg
new file mode 100644
index 0000000..b944592
--- /dev/null
+++ b/docs-assets/quickstart/walkthrough/5-adopt-promotes.svg
@@ -0,0 +1,54 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE — do not edit.
+
+ Rendered from the .txt beside it by tools/dev/render-screenshot.sh.
+ Edit the transcript and re-render; check-quickstart-recording.py fails
+ the build when this file no longer matches its source.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 823 612"
+ width="823" height="612" role="img"
+ data-magpie-rendered="render-screenshot"
+ aria-label="Terminal transcript: 5-adopt-promotes">
+ <title>5-adopt-promotes</title>
+ <rect width="823" height="612" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="823" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="823" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" xml:space="preserve">
+ <text x="28" y="84" fill="#8abeb7">> /magpie-setup adopt</text>
+ <text x="28" y="136" fill="#c5c8c6"> You configured three files locally. Adopting publishes them.</text>
+ <text x="28" y="188" fill="#d8a657"> PROMOTE TO THE PROJECT</text>
+ <text x="28" y="214" fill="#c5c8c6"> [x] project.md upstream repo, tracker, mail lists</text>
+ <text x="28" y="240" fill="#c5c8c6"> [x] pr-management-config.md committers team, label prefix</text>
+ <text x="28" y="266" fill="#c5c8c6"> [ ] pr-management-triage-comment-templates.md</text>
+ <text x="28" y="292" fill="#c5c8c6"> still has 4 TODOs - promote it once it says something</text>
+ <text x="28" y="344" fill="#c5c8c6"> Staged, not committed:</text>
+ <text x="28" y="370" fill="#c5c8c6"> .apache-magpie.lock method: marketplace, floor 0.2.0</text>
+ <text x="28" y="396" fill="#c5c8c6"> .claude/settings.json marketplace + 3 plugins, merged</text>
+ <text x="28" y="422" fill="#c5c8c6"> .apache-magpie-overrides/ the 2 files above</text>
+ <text x="28" y="448" fill="#c5c8c6"> .gitignore /.apache-magpie-local/</text>
+ <text x="28" y="500" fill="#c5c8c6"> Local copies now identical to the project's: removed, so the project</text>
+ <text x="28" y="526" fill="#c5c8c6"> can correct them later and you will get the correction.</text>
+ <text x="28" y="578" fill="#c5c8c6"> Nothing else in .apache-magpie-local/ changed. It is still yours.</text>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/walkthrough/5-adopt-promotes.txt b/docs-assets/quickstart/walkthrough/5-adopt-promotes.txt
new file mode 100644
index 0000000..d7632bc
--- /dev/null
+++ b/docs-assets/quickstart/walkthrough/5-adopt-promotes.txt
@@ -0,0 +1,40 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# Rendered to the .svg beside it by tools/dev/render-screenshot.sh, which
+# strips this header. Edit here, never there.
+
+> /magpie-setup adopt
+
+ You configured three files locally. Adopting publishes them.
+
+ PROMOTE TO THE PROJECT
+ [x] project.md upstream repo, tracker, mail lists
+ [x] pr-management-config.md committers team, label prefix
+ [ ] pr-management-triage-comment-templates.md
+ still has 4 TODOs - promote it once it says something
+
+ Staged, not committed:
+ .apache-magpie.lock method: marketplace, floor 0.2.0
+ .claude/settings.json marketplace + 3 plugins, merged
+ .apache-magpie-overrides/ the 2 files above
+ .gitignore /.apache-magpie-local/
+
+ Local copies now identical to the project's: removed, so the project
+ can correct them later and you will get the correction.
+
+ Nothing else in .apache-magpie-local/ changed. It is still yours.
diff --git a/docs-assets/quickstart/wizard/contributor-growth.svg b/docs-assets/quickstart/wizard/contributor-growth.svg
new file mode 100644
index 0000000..178033b
--- /dev/null
+++ b/docs-assets/quickstart/wizard/contributor-growth.svg
@@ -0,0 +1,60 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE - do not edit.
+
+ Written by tools/dev/render-wizard.py. Illustrative of the shape of a
+ run, not a recording of one.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 705 712"
+ width="705" height="712" role="img"
+ data-magpie-generated="render-wizard"
+ aria-label="An animated /magpie-setup config run for the contributor-growth family: the check failing, values derived from the repository, one question, and gitignored files written">
+ <title>/magpie-setup config — contributor-growth</title>
+ <desc>Illustrative animation of a configuration run for the contributor-growth family. Derived from the skills' declared required configuration.</desc>
+ <rect width="705" height="712" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="705" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="705" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="17" xml:space="preserve">
+ <text x="26" y="80" fill="#8abeb7" opacity="0">> /magpie-contributor-growth:<skill><animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0000;0.0010;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="128" fill="#d8a657" opacity="0"> ✗ project configuration — 6 required, none found<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0388;0.0398;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="176" fill="#8a8f94" opacity="0"> Configuring now. Gitignored files in this clone only.<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0776;0.0786;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="224" fill="#7f9f7f" opacity="0"> ✓ project.md<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1163;0.1173;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="248" fill="#8a8f94" opacity="0"> upstream_repo acme/toolkit from the origin remote<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1551;0.1561;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="296" fill="#c5c8c6" opacity="0"> One question, for what the repository cannot tell me:<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1939;0.1949;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="320" fill="#c5c8c6" opacity="0"> committer-onboarding-config.md<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.2327;0.2337;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="344" fill="#8a8f94" opacity="0"> Capability-flag vocabulary for committer intake and…<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.2714;0.2724;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="368" fill="#c5c8c6" opacity="0"> committer-readiness.md<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3102;0.3112;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="392" fill="#8a8f94" opacity="0"> The project's declared committer and PMC thresholds —…<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3490;0.3500;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="416" fill="#c5c8c6" opacity="0"> contributor-nomination-config.md<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3878;0.3888;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="440" fill="#8a8f94" opacity="0"> Nomination-brief thresholds and assessment window<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.4265;0.4275;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="464" fill="#c5c8c6" opacity="0"> contributor-sentiment-config.md<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.4653;0.4663;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="488" fill="#8a8f94" opacity="0"> Signal thresholds for the sentiment gate<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5041;0.5051;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="512" fill="#c5c8c6" opacity="0"> onboarding-concierge-config.md<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5429;0.5439;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="536" fill="#8a8f94" opacity="0"> The path a new contributor is walked through, and who…<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5816;0.5826;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="584" fill="#7f9f7f" opacity="0"> Written to .apache-magpie-local/ — nothing staged, nothing<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.6204;0.6214;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="608" fill="#7f9f7f" opacity="0"> committed, no teammate affected.<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.6592;0.6602;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="656" fill="#8a8f94" opacity="0"> The project can also adopt Magpie, so contributors get this<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.6980;0.6990;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="680" fill="#8a8f94" opacity="0"> on clone: /magpie-setup adopt<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.7367;0.7377;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <rect x="26" y="667" width="10" height="17" fill="#c5c8c6"><animate attributeName="opacity" values="1;1;0;0;1" dur="1.2s" repeatCount="indefinite"/></rect>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/wizard/issue.svg b/docs-assets/quickstart/wizard/issue.svg
new file mode 100644
index 0000000..b900e8e
--- /dev/null
+++ b/docs-assets/quickstart/wizard/issue.svg
@@ -0,0 +1,60 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE - do not edit.
+
+ Written by tools/dev/render-wizard.py. Illustrative of the shape of a
+ run, not a recording of one.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 685 712"
+ width="685" height="712" role="img"
+ data-magpie-generated="render-wizard"
+ aria-label="An animated /magpie-setup config run for the issue family: the check failing, values derived from the repository, one question, and gitignored files written">
+ <title>/magpie-setup config — issue</title>
+ <desc>Illustrative animation of a configuration run for the issue family. Derived from the skills' declared required configuration.</desc>
+ <rect width="685" height="712" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="685" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="685" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="17" xml:space="preserve">
+ <text x="26" y="80" fill="#8abeb7" opacity="0">> /magpie-issue:<skill><animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0000;0.0010;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="128" fill="#d8a657" opacity="0"> ✗ project configuration — 6 required, none found<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0388;0.0398;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="176" fill="#8a8f94" opacity="0"> Configuring now. Gitignored files in this clone only.<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0776;0.0786;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="224" fill="#7f9f7f" opacity="0"> ✓ project.md<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1163;0.1173;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="248" fill="#8a8f94" opacity="0"> upstream_repo acme/toolkit from the origin remote<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1551;0.1561;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="296" fill="#c5c8c6" opacity="0"> One question, for what the repository cannot tell me:<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1939;0.1949;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="320" fill="#c5c8c6" opacity="0"> fix-workflow.md<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.2327;0.2337;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="344" fill="#8a8f94" opacity="0"> Fork / clone / toolchain specifics, backport-label…<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.2714;0.2724;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="368" fill="#c5c8c6" opacity="0"> issue-tracker-config.md<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3102;0.3112;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="392" fill="#8a8f94" opacity="0"> Tracker URL, project key, auth model, default query…<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3490;0.3500;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="416" fill="#c5c8c6" opacity="0"> reassess-pool-defaults.md<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3878;0.3888;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="440" fill="#8a8f94" opacity="0"> Named pools for reassessment sweeps (`open-eol`,…<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.4265;0.4275;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="464" fill="#c5c8c6" opacity="0"> reproducer-conventions.md<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.4653;0.4663;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="488" fill="#8a8f94" opacity="0"> Evidence-package directory layout and frozen-copy…<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5041;0.5051;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="512" fill="#c5c8c6" opacity="0"> runtime-invocation.md<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5429;0.5439;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="536" fill="#8a8f94" opacity="0"> Build prerequisite, run-a-single-file recipe,…<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5816;0.5826;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="584" fill="#7f9f7f" opacity="0"> Written to .apache-magpie-local/ — nothing staged, nothing<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.6204;0.6214;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="608" fill="#7f9f7f" opacity="0"> committed, no teammate affected.<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.6592;0.6602;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="656" fill="#8a8f94" opacity="0"> The project can also adopt Magpie, so contributors get this<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.6980;0.6990;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="680" fill="#8a8f94" opacity="0"> on clone: /magpie-setup adopt<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.7367;0.7377;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <rect x="26" y="667" width="10" height="17" fill="#c5c8c6"><animate attributeName="opacity" values="1;1;0;0;1" dur="1.2s" repeatCount="indefinite"/></rect>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/wizard/mentoring.svg b/docs-assets/quickstart/wizard/mentoring.svg
new file mode 100644
index 0000000..e60c785
--- /dev/null
+++ b/docs-assets/quickstart/wizard/mentoring.svg
@@ -0,0 +1,54 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE - do not edit.
+
+ Written by tools/dev/render-wizard.py. Illustrative of the shape of a
+ run, not a recording of one.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 695 568"
+ width="695" height="568" role="img"
+ data-magpie-generated="render-wizard"
+ aria-label="An animated /magpie-setup config run for the mentoring family: the check failing, values derived from the repository, one question, and gitignored files written">
+ <title>/magpie-setup config — mentoring</title>
+ <desc>Illustrative animation of a configuration run for the mentoring family. Derived from the skills' declared required configuration.</desc>
+ <rect width="695" height="568" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="695" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="695" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="17" xml:space="preserve">
+ <text x="26" y="80" fill="#8abeb7" opacity="0">> /magpie-mentoring:<skill><animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0000;0.0010;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="128" fill="#d8a657" opacity="0"> ✗ project configuration — 3 required, none found<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0505;0.0515;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="176" fill="#8a8f94" opacity="0"> Configuring now. Gitignored files in this clone only.<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1011;0.1021;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="224" fill="#7f9f7f" opacity="0"> ✓ project.md<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1516;0.1526;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="248" fill="#8a8f94" opacity="0"> upstream_repo acme/toolkit from the origin remote<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.2021;0.2031;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="296" fill="#c5c8c6" opacity="0"> One question, for what the repository cannot tell me:<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.2527;0.2537;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="320" fill="#c5c8c6" opacity="0"> good-first-issue-config.md<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3032;0.3042;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="344" fill="#8a8f94" opacity="0"> What counts as a good first issue here: labels, size…<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3537;0.3547;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="368" fill="#c5c8c6" opacity="0"> issue-tracker-config.md<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.4043;0.4053;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="392" fill="#8a8f94" opacity="0"> Tracker URL, project key, auth model, default query…<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.4548;0.4558;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="440" fill="#7f9f7f" opacity="0"> Written to .apache-magpie-local/ — nothing staged, nothing<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5053;0.5063;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="464" fill="#7f9f7f" opacity="0"> committed, no teammate affected.<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5559;0.5569;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="512" fill="#8a8f94" opacity="0"> The project can also adopt Magpie, so contributors get this<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.6064;0.6074;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <text x="26" y="536" fill="#8a8f94" opacity="0"> on clone: /magpie-setup adopt<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.6569;0.6579;1" dur="7.5s" repeatCount="indefinite"/></text>
+ <rect x="26" y="523" width="10" height="17" fill="#c5c8c6"><animate attributeName="opacity" values="1;1;0;0;1" dur="1.2s" repeatCount="indefinite"/></rect>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/wizard/pr-management.svg b/docs-assets/quickstart/wizard/pr-management.svg
new file mode 100644
index 0000000..8083099
--- /dev/null
+++ b/docs-assets/quickstart/wizard/pr-management.svg
@@ -0,0 +1,60 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+ GENERATED FILE - do not edit.
+
+ Written by tools/dev/render-wizard.py. Illustrative of the shape of a
+ run, not a recording of one.
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 715 712"
+ width="715" height="712" role="img"
+ data-magpie-generated="render-wizard"
+ aria-label="An animated /magpie-setup config run for the pr-management family: the check failing, values derived from the repository, one question, and gitignored files written">
+ <title>/magpie-setup config — pr-management</title>
+ <desc>Illustrative animation of a configuration run for the pr-management family. Derived from the skills' declared required configuration.</desc>
+ <rect width="715" height="712" rx="10" fill="#1d1f21"/>
+ <rect x="0" y="0" width="715" height="34" rx="10" fill="#2b2e31"/>
+ <rect x="0" y="24" width="715" height="10" fill="#2b2e31"/>
+ <circle cx="22" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="44" cy="17" r="6" fill="#3f4448"/>
+ <circle cx="66" cy="17" r="6" fill="#3f4448"/>
+ <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="17" xml:space="preserve">
+ <text x="26" y="80" fill="#8abeb7" opacity="0">> /magpie-pr-management:<skill><animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0000;0.0010;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="128" fill="#d8a657" opacity="0"> ✗ project configuration — 6 required, none found<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0388;0.0398;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="176" fill="#8a8f94" opacity="0"> Configuring now. Gitignored files in this clone only.<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.0776;0.0786;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="224" fill="#7f9f7f" opacity="0"> ✓ project.md<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1163;0.1173;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="248" fill="#8a8f94" opacity="0"> upstream_repo acme/toolkit from the origin remote<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1551;0.1561;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="296" fill="#c5c8c6" opacity="0"> One question, for what the repository cannot tell me:<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.1939;0.1949;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="320" fill="#c5c8c6" opacity="0"> pr-management-code-review-criteria.md<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.2327;0.2337;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="344" fill="#8a8f94" opacity="0"> List of project's review-criteria source files…<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.2714;0.2724;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="368" fill="#c5c8c6" opacity="0"> pr-management-config.md<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3102;0.3112;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="392" fill="#8a8f94" opacity="0"> Committers team handle, area-label prefix,…<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3490;0.3500;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="416" fill="#c5c8c6" opacity="0"> pr-management-quick-merge-config.md<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.3878;0.3888;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="440" fill="#8a8f94" opacity="0"> Thresholds, path globs, and the merge-command template…<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.4265;0.4275;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="464" fill="#c5c8c6" opacity="0"> pr-management-triage-comment-templates.md<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.4653;0.4663;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="488" fill="#8a8f94" opacity="0"> Comment-body URLs (PR quality criteria, two-stage…<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5041;0.5051;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="512" fill="#c5c8c6" opacity="0"> reviewer-roster.md<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5429;0.5439;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="536" fill="#8a8f94" opacity="0"> Who reviews what<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.5816;0.5826;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="584" fill="#7f9f7f" opacity="0"> Written to .apache-magpie-local/ — nothing staged, nothing<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.6204;0.6214;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="608" fill="#7f9f7f" opacity="0"> committed, no teammate affected.<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.6592;0.6602;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="656" fill="#8a8f94" opacity="0"> The project can also adopt Magpie, so contributors get this<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.6980;0.6990;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <text x="26" y="680" fill="#8a8f94" opacity="0"> on clone: /magpie-setup adopt<animate attributeName="opacity" values="0;0;1;1" keyTimes="0;0.7367;0.7377;1" dur="9.8s" repeatCount="indefinite"/></text>
+ <rect x="26" y="667" width="10" height="17" fill="#c5c8c6"><animate attributeName="opacity" values="1;1;0;0;1" dur="1.2s" repeatCount="indefinite"/></rect>
+ </g>
+</svg>
diff --git a/docs-assets/quickstart/wizard/release-management.svg b/docs-assets/quickstart/wizard/release-management.svg
new file mode 100644
index 0000000..bc94356
... 136531 lines suppressed ...