diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
new file mode 100644
index 0000000..3a5d3d9
--- /dev/null
+++ b/.github/workflows/deploy.yml
@@ -0,0 +1,124 @@
+name: Deploy
+
+on:
+  push:
+    branches: [rebuild/v3, main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+    inputs:
+      skip_cname:
+        description: >-
+          Omit the CNAME file. Only for a deliberate rollback to the
+          servicetomankind.github.io URL — constitution.stmorg.in points here now
+          and a deploy without CNAME can drop the domain setting.
+        type: boolean
+        default: false
+        required: false
+
+permissions:
+  contents: read
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+env:
+  # The custom domain serves from the root, so the base path is "/". Every
+  # internal link and asset derives from these two; changing one without the
+  # other ships a site whose links point at a directory that is not there.
+  BASE_PATH: /
+  SITE_ORIGIN: https://constitution.stmorg.in
+
+jobs:
+  # A schema violation, a failing test or a dead internal link must block
+  # publication rather than ship a broken or legally incorrect constitution.
+  validate:
+    name: Validate and test (Node ${{ matrix.node }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        # 22 is the target floor; 20 stays until the local floor moves. See README.
+        node: ['20', '22']
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node }}
+          cache: npm
+      - run: npm ci
+
+      - name: Validate constitution
+        run: npm run validate
+
+      - name: Build
+        run: npm run build
+
+      - name: Check links
+        run: npm run linkcheck
+
+      - name: Test
+        run: npm test
+
+  build:
+    name: Build artifact
+    needs: validate
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: npm
+      - run: npm ci
+
+      - name: Build static site
+        run: npm run build
+
+      - name: Check links
+        run: npm run linkcheck
+
+      # The validate matrix already tested both runtimes, but it builds its own
+      # copy. Running the suite here means the exact artifact that ships was
+      # tested against the exact Node it was produced on.
+      - name: Test the artifact build
+        run: npm test
+
+      # constitution.stmorg.in is live. An Actions deploy whose artifact has no
+      # CNAME can drop the custom domain setting, so its absence is now the
+      # failure — the opposite of the pre-cutover rule.
+      - name: Guard the custom domain
+        run: |
+          if [ ! -f dist/CNAME ]; then
+            echo "::error::dist/CNAME missing — a deploy without it can drop the custom domain."
+            exit 1
+          fi
+          echo "CNAME present: $(cat dist/CNAME)"
+          if grep -rqE 'href="/OpenCodeLaw/|src="/OpenCodeLaw/' dist; then
+            echo "::error::Built pages still carry the /OpenCodeLaw/ prefix but the site serves from /."
+            exit 1
+          fi
+          echo "No stale project-Pages prefix in the output."
+
+      - name: Upload Pages artifact
+        if: github.event_name != 'pull_request'
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./dist
+
+  deploy:
+    name: Deploy to Pages
+    needs: build
+    if: github.event_name != 'pull_request'
+    runs-on: ubuntu-latest
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy
+        id: deployment
+        uses: actions/deploy-pages@v4
diff --git a/.gitignore b/.gitignore
index 18c426d..1cf1a43 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,2 +1,14 @@
+# Build output — published by GitHub Actions, never committed.
+dist/
+
+# Dependencies — restored with `npm ci` from the committed lockfile.
+node_modules/
+
+# Legacy SCSS source map. NOTE: css/style.css is deliberately NOT ignored;
+# ignoring the site's only stylesheet is what made a clean checkout ship
+# with no CSS. See AUDIT-CONFIRMED.md §6.
 css/style.css.map
-css/style.css
\ No newline at end of file
+
+*.log
+.DS_Store
+assets/og/
diff --git a/.htaccess b/.htaccess
deleted file mode 100644
index 3910f13..0000000
--- a/.htaccess
+++ /dev/null
@@ -1,12 +0,0 @@
-RewriteEngine on
-
-DirectoryIndex index.html
-
-RewriteCond %{THE_REQUEST} /([^.]+)\.html [NC]
-RewriteRule ^ /%1 [NC,L,R]
-
-RewriteCond %{REQUEST_FILENAME}.html -f
-RewriteRule ^ %{REQUEST_URI}.html [NC,L]
-
-# Deny access to .git directory
-RedirectMatch 404 /\.git
\ No newline at end of file
diff --git a/.night-run/CUTOVER.md b/.night-run/CUTOVER.md
new file mode 100644
index 0000000..f70740b
--- /dev/null
+++ b/.night-run/CUTOVER.md
@@ -0,0 +1,186 @@
+# Cutover — constitution.stmorg.in
+
+**Status: the domain is already live on this build.** It was pointed here on 15 Aug 2026, ahead of
+this document. What follows is therefore part record, part the checklist that remains.
+
+The old site was **not** on GitHub Pages — `has_pages` was `false` until this rebuild, and the
+committed `.htaccess` shows it was served by Apache. Cutover was a DNS repoint, not a Pages setting,
+which is why the old site kept serving until the moment DNS changed.
+
+---
+
+## What happened, and what broke
+
+| | |
+|---|---|
+| Pages enabled, Source: GitHub Actions | done |
+| `rebuild/v3` added to the `github-pages` branch policy | done — it was `main`-only and was silently failing the deploy job |
+| Custom domain set to `constitution.stmorg.in` | done, by Pranay |
+| **Base path switched `/OpenCodeLaw/` → `/`** | **done, after the domain went live** |
+| CNAME shipped in the artifact | done |
+| Legacy `/archives/v1` redirects | done |
+
+**The breakage.** The artifact was compiled for `BASE_PATH=/OpenCodeLaw/` while the apex domain
+serves from `/`. Every asset and internal link resolved to a directory that did not exist —
+`/styles/tokens.css` returned 200 while the HTML asked for `/OpenCodeLaw/styles/tokens.css`.
+
+Fixed by rebuilding at `BASE_PATH=/`. Three guards now make it unrepeatable:
+
+- the base path and origin are defined once, in `src/lib/paths.mjs`, and read by the build, the link
+  checker and the tests — three copies of a default is how they drift;
+- a test asserts that if a `CNAME` is present the build must be compiled for `/`;
+- CI greps the built output for a stale `/OpenCodeLaw/` prefix and fails on it.
+
+---
+
+## Still outstanding
+
+### 0. Cloudflare rewrites the contact link, breaking the no-JS guarantee
+
+**Confirmed live.** The build ships `href="mailto:pranay@stmorg.in"`; the served page carries
+`/cdn-cgi/l/email-protection#<hex>`, which only resolves once Cloudflare's script has run. On a site
+whose premise is that it works with JavaScript disabled, the one outbound link a reader is most
+likely to need is the only thing that requires it.
+
+This is Cloudflare's **Email Address Obfuscation** (Scrape Shield). It is applied at the edge and
+**cannot be fixed in the build** — `npm test` asserts the build output is clean, which it is.
+
+Two routes, both Pranay's to choose:
+
+1. **Turn it off.** Cloudflare dashboard → the zone → **Scrape Shield** → disable *Email Address
+   Obfuscation*. Narrower option: leave it on globally and add a Configuration Rule disabling it for
+   `constitution.stmorg.in`.
+2. **Stop publishing a raw address.** Replace `info.contact.email` with `info.contact.url` pointing
+   at a contact page. Nothing to obfuscate, and the address stops being scraped — which is what the
+   feature is for.
+
+Verify after either:
+
+```bash
+curl -sS "https://constitution.stmorg.in/?cb=$(date +%s)" | grep -c "cdn-cgi/l/email-protection"   # 0
+```
+
+### 1. HTTPS is not enforced by GitHub
+
+`gh api repos/ServiceToMankind/OpenCodeLaw/pages` reports `https_enforced: false`, and the Pages
+`html_url` is `http://`. HTTPS does work for visitors — but it is terminated by **Cloudflare**, not
+by GitHub. The served HTML contains `/cdn-cgi/l/email-protection`, which is Cloudflare rewriting the
+`mailto:` in the footer, so the domain is proxied (orange cloud).
+
+**Direct evidence that no GitHub certificate exists for this hostname.** Fetching GitHub's Pages
+origin with the right Host header fails TLS verification:
+
+```
+$ curl --resolve constitution.stmorg.in:443:185.199.108.153 https://constitution.stmorg.in/
+curl: (60) SSL: no alternative certificate subject name matches target host name
+      'constitution.stmorg.in'
+```
+
+Visitors are unaffected — Cloudflare terminates TLS with its own certificate — but it confirms the
+GitHub-side certificate has never been issued, which is what `https_enforced: false` reflects. It
+also means **Cloudflare's SSL mode cannot currently be Full (strict)** against this origin without
+returning [error 526][cf-526]: strict mode validates the origin certificate, and there is not a
+valid one for this hostname. Whatever the mode is today, it is not that. Check it.
+
+**What the documentation actually says** — checked rather than recalled, because the usual advice
+here is folklore:
+
+- GitHub's own pages on [securing a Pages site with HTTPS][gh-https] and
+  [troubleshooting custom domains][gh-tsh] **do not mention CDNs, proxies or Cloudflare at all.**
+  They say certificate provisioning depends on the DNS records resolving to GitHub's infrastructure,
+  that stray `A`/`AAAA`/`ALIAS`/`ANAME`/`CNAME` records "may prevent the HTTPS certificate from
+  generating", and that the fix for a stuck certificate is to remove and re-add the custom domain.
+  So the DNS-only step is **inference from those requirements, not documented GitHub guidance.**
+- Cloudflare's side is clearer. Its community guidance is that using GitHub Pages with Cloudflare
+  requires disabling the HTTP proxy, and that under **Full (strict)** Cloudflare blocks the HTTP
+  validation GitHub uses to issue a certificate — see [the Cloudflare community thread][cf-gh] and
+  [Full (strict) mode][cf-strict].
+
+**Therefore the sequence, stated as a proposal to verify and not as fact:** set the record to
+DNS-only (grey cloud), wait for GitHub to issue the certificate and for *Enforce HTTPS* to become
+available, then re-enable the proxy if it is wanted. **Confirm before running it** — if GitHub's
+certificate does not cover the hostname once the proxy is back on, Full (strict) returns
+[error 526][cf-526].
+
+- **SSL mode.** If Cloudflare is set to **Flexible**, the Cloudflare→GitHub leg is plaintext while
+  the padlock still shows for visitors. It should be **Full (strict)**, which
+  [requires a valid publicly-trusted certificate on the origin][cf-strict] — which GitHub provides
+  once provisioning has succeeded. Check this first: it is the item with a real security consequence,
+  and it is independent of whether *Enforce HTTPS* is ever turned on.
+- **Bytes served are not bytes built.** See item 0.
+
+**Nothing changed. This is DNS and a third-party dashboard, outside anything authorised here.**
+
+[gh-https]: https://docs.github.com/en/pages/getting-started-with-github-pages/securing-your-github-pages-site-with-https
+[gh-tsh]: https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site/troubleshooting-custom-domains-and-github-pages
+[cf-gh]: https://community.cloudflare.com/t/github-pages-require-disabling-cfs-http-proxy/147401
+[cf-strict]: https://developers.cloudflare.com/ssl/origin-configuration/ssl-modes/full-strict/
+[cf-526]: https://developers.cloudflare.com/support/troubleshooting/http-status-codes/cloudflare-5xx-errors/error-526/
+
+### 1b. Six section anchors changed meaning
+
+Applying Act 2 restructured Articles 14 and 15. Anyone holding a bookmark to a *section* of either
+will land on different text than before:
+
+| Anchor | meant | now means |
+|---|---|---|
+| `art-14-s-1` | Eligibility | Sabbatical Leave |
+| `art-15-s-1` | Eligibility | Voluntary |
+| `art-15-s-2` | Application | Involuntary |
+| `art-14-s-2`, `art-14-s-3`, `art-15-s-3` | Application / Duration | no longer exist |
+
+Article-level anchors (`art-14`, `art-15`) are unaffected. `/archive/2.0.0/` still serves the old
+structure, so a stale citation remains readable as it stood. No redirect is possible or appropriate:
+the Act changed what the provision says, and silently forwarding would hide that.
+
+### 2. Caching
+
+Pages serves `cache-control: max-age=600`. After a deploy, expect up to ten minutes of stale HTML at
+the edge. A cache-busting query (`?cb=…`) confirms the origin immediately. If Cloudflare caching is
+enabled for HTML, purge after deploys or the window is longer.
+
+### 3. Verify after any future deploy
+
+```bash
+curl -sS "https://constitution.stmorg.in/?cb=$(date +%s)" | grep -c "/OpenCodeLaw/"   # must be 0
+curl -sS -o /dev/null -w "%{http_code}\n" https://constitution.stmorg.in/styles/tokens.css
+curl -sS "https://constitution.stmorg.in/?cb=$(date +%s)" | grep -oE '<link rel="canonical"[^>]*>'
+curl -sS "https://constitution.stmorg.in/?cb=$(date +%s)" | grep -c "cdn-cgi/l/email-protection"  # must be 0
+gh api repos/ServiceToMankind/OpenCodeLaw/pages --jq '{cname, https_enforced}'
+```
+
+---
+
+## Rollback
+
+If the new site has to come down quickly, in increasing order of severity:
+
+1. **Revert the content, keep the domain.** `git revert` the offending commit and push; CI
+   redeploys in about two minutes. Preferred — the domain and DNS stay untouched.
+2. **Roll back to a known-good commit.** `git revert` back to it and push. Do not force-push; the
+   deploy is driven by the branch head, and history rewriting is what makes the archive
+   untrustworthy.
+3. **Take the new site off the domain.** Remove the custom domain in Pages settings and point DNS
+   back at the old Apache host. The old content still exists on that host; nothing in this
+   repository deleted it.
+4. **Deploy without the domain.** Run the workflow manually with `skip_cname: true`. Only for a
+   deliberate return to `servicetomankind.github.io/OpenCodeLaw/`, and note that the build would
+   then also need `BASE_PATH=/OpenCodeLaw/` to be coherent.
+
+**Do not** delete the `rebuild/v3` branch or the Pages deployment while the domain points here —
+that leaves the constitution domain serving a 404.
+
+---
+
+## The thing worth pausing on
+
+The site is now the public face of a governing document that is **mid-reconciliation**. It says so
+on every page, which is the right behaviour and the point of the whole exercise. But it also means
+`constitution.stmorg.in` currently publishes a constitution that:
+
+- reflects **one of three** enacted Amendment Acts, and only partly;
+- holds Articles 6 and 7 pending Q2;
+- carries 32 headings that no instrument enacted, now visibly marked.
+
+None of that is hidden, and all of it is more honest than what the domain served before. It is still
+worth the board knowing the domain went live in that state rather than after sign-off.
diff --git a/.night-run/LOG.md b/.night-run/LOG.md
new file mode 100644
index 0000000..8b0f8c9
--- /dev/null
+++ b/.night-run/LOG.md
@@ -0,0 +1,20 @@
+# Night run log
+
+| Time (IST) | Task | Result |
+|---|---|---|
+| 00:44 | S1 tripwire baseline | 82 provision strings, GREEN |
+| 00:44 | S2 queue + log | 44 tasks queued |
+| 00:44 | S3 commit scaffolding | done |
+| 00:48 | L1 acts/register.yaml | 3 acts, 5 Act-1 provisions, validates clean |
+| 00:51 | L2 art-11 | DEVIATED: Act1 has no article-level body; removed empty content key (tripwire-permitted). Sections carry 99.4% of Act1 art-11 |
+| 00:51 | L3 amended_by | 5 articles (9,10,11,12,18); 6,7 untouched |
+| 00:51 | L4 version | 3.0.0-alpha.1 + reconciliation_state |
+| 00:51 | L5 validate | PASSED 0 errors, 3 warnings |
+| 01:06 | Phase 4 build+deploy pipeline | 24 pages, 41 tests, 0 internal 404s, 21 OG images |
+| 01:11 | GATE 4 PASS | live at https://servicetomankind.github.io/OpenCodeLaw/ — all pages 200, PDFs 200, CNAME 404 (correct), pages.cname=null |
+| 01:11 | Pages enabled | build_type=workflow; rebuild/v3 added to github-pages branch policy (was main-only) |
+| 01:11 | CI fix | node --test tests/ fails on Node 22 (treats dir as module); switched to shell glob |
+| 06:56 | GATE 6 PASS | LIVE Lighthouse 100/100/100/100 mobile AND desktop; a11y 100 in all 4 theme/viewport combos |
+| 06:56 | Keyboard walkthrough | 10/10 pass — skip link, focus trap, Escape return, legacy anchor, 0 console errors |
+| 06:56 | GATE 7 PASS | starter builds standalone (79 files, base /), SPEC.md idempotent, CLI works |
+| 06:58 | R1 report | REPORT.md written; all 50 queue items done |
diff --git a/.night-run/PHASE-8-AMENDMENT-WORKFLOW.md b/.night-run/PHASE-8-AMENDMENT-WORKFLOW.md
new file mode 100644
index 0000000..d15a8e6
--- /dev/null
+++ b/.night-run/PHASE-8-AMENDMENT-WORKFLOW.md
@@ -0,0 +1,75 @@
+# Phase 8 — improved amendment workflow (deferred, nothing built)
+
+Requirements noted while applying Acts 1, 2 and 3. **Nothing here is implemented.** Recorded now
+because this is when the gaps were visible; they will not be as obvious later.
+
+## What applying three Acts actually cost
+
+The engine records amendments well. It does not help you *make* one. Every step below was manual,
+and each is a place a future amendment can go wrong quietly.
+
+### 1. Structure cannot be inferred from a PDF
+
+The single largest cost. Deriving article/section shape from the Act's layout failed in both
+directions on the same heuristic: it read Article 9's sentences as section titles, collapsed Article
+10's three clauses into one, and found none of Article 8's five. PDF indentation is not a structural
+signal.
+
+Resolved by declaring structure explicitly in `src/act-application.mjs` as line ranges, with
+`verifyCoverage` asserting the slices reconstruct the span exactly. That works, but it is a
+hand-authored file per Act.
+
+**Requirement:** Acts should be authored in a machine-readable form — the same YAML schema, as a
+patch — with the PDF as the signed rendering of it rather than the source of truth. An Act would
+then declare `target`, `operation`, `scope` and its text directly, and applying it would need no
+transcription at all.
+
+### 2. Clause-scope edits are surgery
+
+Act 1's Article 7 replaces sub-clause (a) *point 6* and sub-clause (b), inside a nested list whose
+points (a)1–5 stay. That was declared by line range into the current text — which means the
+declaration goes stale the moment the provision changes.
+
+**Requirement:** clauses need addressable ids of their own (`art-7-c-6-a-6`), so an Act can target a
+clause rather than a line. Today only articles and sections are addressable.
+
+### 3. Nothing proposes, everything asserts
+
+`apply-act.mjs` writes the change and verifies it after. There is no state where an amendment is
+drafted, reviewed and approved before it lands.
+
+**Requirement:** a proposed amendment should be a branch plus a rendered diff of the *provisions*,
+not of the YAML — a reviewer should see "Article 13 becomes …", not a unified diff.
+
+### 4. The approval chain is recorded, never enforced
+
+`procedure` holds the bodies Article 16(3) requires, and it is prose. Nothing checks that an Act
+with `complete: false` has not been applied — Acts 1–3 were applied with intermediate-board and unit
+approval still unconfirmed, which was authorised, but the engine could not have stopped it.
+
+**Requirement:** the validator should refuse to apply an Act whose `procedure.complete` is false
+unless an explicit override is recorded, with who authorised it and when.
+
+### 5. Section ids move when an Act restructures
+
+Act 2 changed what six section anchors mean. That is correct — a section id names a position — but
+nothing warned before it happened; it was noticed by reading the diff.
+
+**Requirement:** the applier should detect and report anchor meaning changes as part of its
+verification, the way it reports provisions changing outside the manifest.
+
+### 6. Numbering gaps are discovered late
+
+Inserting Article 20 created an unaccounted gap at 19, caught only when validation failed after the
+write.
+
+**Requirement:** the manifest should predict the post-application numbering and require a `reserved`
+entry up front, before anything is written.
+
+## What already works and should not be rebuilt
+
+- `verifyCoverage` — proving declared slices reconstruct the Act span exactly.
+- The expected-change manifest, and aborting on any provision changing outside it.
+- The tripwire, re-baselined per Act rather than disabled.
+- `sor-as-authority` — a Statement of Objects can never be cited as authority.
+- Text comparison that folds enumerators and typography but strips tags first.
diff --git a/.night-run/QUEUE.md b/.night-run/QUEUE.md
new file mode 100644
index 0000000..1c072d6
--- /dev/null
+++ b/.night-run/QUEUE.md
@@ -0,0 +1,84 @@
+# Night run queue
+
+**Protocol:** resume at the first unchecked item. Do not re-plan or re-audit.
+One task → verify → commit → tick → next. Never batch. Max 3 attempts per gate, then `BLOCKED`.
+Run `node .night-run/tripwire.mjs` before **every** commit. Red = stop everything.
+
+**Branch:** `rebuild/v3` · never push to `main`, never force-push.
+**Deploy target:** `https://servicetomankind.github.io/OpenCodeLaw/` · base path `/OpenCodeLaw/` · **no CNAME in artifact**.
+
+---
+
+## S — Scaffolding
+
+- [x] S1 Tripwire script + baseline (82 provision strings)
+- [x] S2 QUEUE.md, LOG.md
+- [x] S3 Commit scaffolding
+
+## L — Authorised legal metadata (no provision text changes except L2)
+
+- [x] L1 `acts/register.yaml` — all three Acts; Act 1 provisions for arts. 9,10,11,12,18 only
+- [x] L2 **DEVIATED** — Act 1 supplies no article-level body for art-11; empty `content` key removed instead. See REPORT.
+- [x] L3 `amended_by: [act-1-2024]` on arts. 9,10,11,12,18 only
+- [x] L4 `version: 3.0.0-alpha.1` + `reconciliation_state` block
+- [x] L5 Validation green on the two remaining known items only
+
+## 4 — Build and deploy
+
+- [x] 4a `src/build.mjs` skeleton + base-path helper + YAML load
+- [x] 4b Templates: layout, provision rendering, sanitised Markdown
+- [x] 4c `index.html` — full constitution, all provisions inline
+- [x] 4d `articles/<slug>/index.html` per article
+- [x] 4e `amendments/index.html` from register
+- [x] 4f `archive/` index + `archive/v1.0.0/` + `archive/v2.0.0/` w/ banner + canonical
+- [x] 4g `404.html`, `.nojekyll`, static asset copy, Act PDFs
+- [x] 4h Reconciliation banner from `reconciliation_state` (never hardcoded)
+- [x] 4i Hash resolution after DOM ready + sticky offset + legacy `#articleN` map
+- [x] 4j Link checker — zero internal 404s
+- [x] 4k Workflow: ci → validate → test → build → linkcheck → deploy (CNAME gated off)
+- [x] 4l **Gate 4** + enable Pages + deploy + log URL
+
+## 5 — SEO
+
+- [x] 5a Per-page title, description from provision text, canonical
+- [x] 5b OG + Twitter tags, real `<h1>` in source
+- [x] 5c Build-time OG images (SVG→PNG, banner base plate)
+- [x] 5d JSON-LD: Legislation, Article, BreadcrumbList, Organization
+- [x] 5e `sitemap.xml` w/ per-provision lastmod + `robots.txt`
+- [x] 5f **Gate 5** — raw curl checks, JSON-LD validates, sitemap URLs 200
+
+## 6 — UI
+
+- [x] 6a `tokens.css` — palette + `data-theme` + no-flash head script
+- [x] 6b Font fixes (truetype, Cuprum format, font-display, Open Sans decision)
+- [x] 6c `layout.css` — 18px/1.65/68ch, ragged-right, margin article numbers
+- [x] 6d Desktop sticky ToC w/ overflow; **mobile bottom-sheet ToC (#1)**
+- [x] 6e IntersectionObserver scroll-spy + auto-expand (#4)
+- [x] 6f ⌘K search over build-time index
+- [x] 6g Progress bar, focus mode, amended-by chips
+- [x] 6h Copy-link toast `aria-live` (#7)
+- [x] 6i A11y pass: skip link, landmarks, focus-visible, keyboard, reduced-motion, `<button aria-pressed>` (#25, #26)
+- [x] 6j `print.css`
+- [x] 6k **Gate 6** — Lighthouse a11y ≥95 / perf ≥90, keyboard walkthrough, screenshots, zero console errors
+
+## 7 — Reusability
+
+- [x] 7a `examples/starter/` minimal valid constitution
+- [x] 7b `opencodelaw validate|build` bin entries
+- [x] 7c `schema/SPEC.md` generated from JSON Schema (idempotent)
+- [x] 7d `README.md` rewrite (no CDN install), `CONTRIBUTING.md`
+- [x] 7e **Gate 7** — starter builds from clean checkout; SPEC.md regenerates identically twice
+
+## V — Verification suite (add as built)
+
+- [x] V1 No-JS render assertion
+- [x] V2 Every anchor resolves
+- [x] V3 Legacy `#articleN` maps for all 18
+- [x] V4 Base-path correctness — nothing escapes `/OpenCodeLaw/`
+- [x] V5 OG + JSON-LD per page type
+- [x] V6 Citation stability stays green
+- [x] V7 Tripwire green before every commit
+
+## R — Report
+
+- [x] R1 `.night-run/REPORT.md`
diff --git a/.night-run/REPORT.md b/.night-run/REPORT.md
new file mode 100644
index 0000000..85a0628
--- /dev/null
+++ b/.night-run/REPORT.md
@@ -0,0 +1,124 @@
+# Night run — morning report
+
+## 1. It is live
+
+**https://servicetomankind.github.io/OpenCodeLaw/**
+
+**The custom domain was not touched.** `constitution.stmorg.in` still serves the old site.
+Verified three ways: Pages API reports `cname: null`; `/OpenCodeLaw/CNAME` returns 404; and CI
+fails the build if a CNAME appears in the artifact without `include_cname: true`.
+
+Worth knowing: Pages was **not enabled at all** on this repo before tonight (`has_pages: false`),
+so the old site is hosted elsewhere and enabling Pages could not have disturbed it.
+
+Two settings changes, both inside what you authorised: Pages enabled with **Source: GitHub Actions**,
+and `rebuild/v3` added to the `github-pages` environment branch policy, which was `main`-only and
+was silently failing the deploy job.
+
+## 2. Screenshots — `.night-run/screenshots/`
+
+`home-{375,768,1440}-{light,dark}.png` · `article-1440-{light,dark}.png` ·
+`amendments-1440-{light,dark}.png` · `archive-superseded-1440-light.png` · `print-preview.pdf`
+
+## 3. Phases
+
+| Phase | State |
+|---|---|
+| 4 — Build and deploy | **Complete**, deployed |
+| 5 — SEO | **Complete** |
+| 6 — UI | **Complete** |
+| 7 — Reusability | **Complete** |
+
+48 of 50 queue items done. 10 commits.
+
+## 4. Gates
+
+| Gate | Result |
+|---|---|
+| 4 — build clean, zero internal 404s, no-JS text, PDFs reachable, live | **PASS** — 24 pages, 1807 links, 150 anchors, 0 dead |
+| 5 — title/description/canonical/OG/JSON-LD in raw HTML, sitemap resolves | **PASS** — SEO 100 |
+| 6 — Lighthouse a11y ≥95 and perf ≥90, keyboard walkthrough, screenshots, no console errors | **PASS, exceeded** |
+| 7 — starter builds from clean checkout, SPEC.md idempotent | **PASS** |
+
+**Lighthouse on the live site — 100 / 100 / 100 / 100 on both mobile and desktop**
+(performance, accessibility, best practices, SEO). Accessibility is 100 in all four
+combinations of desktop/mobile × light/dark.
+
+**Keyboard walkthrough: 10/10** — skip link, theme toggle as a real `aria-pressed` button,
+⌘K search with focus return, the mobile sheet trapping focus through a full 25-tab lap and
+returning it on Escape, copy-link's polite live region, one `<main>`/one `<h1>` per page type,
+a cold load of `#art-11-s-2` landing clear of the sticky header, `#article5` rewriting itself
+to `#art-5`, and zero console errors across six page types.
+
+Issues **#1, #4, #7, #25, #26** are addressed and covered by tests.
+
+## 5. Nothing is blocked — but one thing deviated
+
+**L2 (restore Article 11's body) was not done as written, and should not be.**
+
+The instruction assumed Act 1 supplies article-level text for Article 11 that someone
+misfiled into a subsection. It does not. Act 1's Article 11 is exactly two clauses, and:
+
+- clause (1) is a **100.0% match** to the existing `art-11-s-1` (103 tokens against 103)
+- clause (2) is a **98.6% match** to `art-11-s-2`
+- together **99.4%** of the enacted text is already there
+
+Act 1 runs its heading straight into clause (1) and supplies no article-level body at all.
+Writing clause (1) at article level would have duplicated section 1 verbatim; removing that
+section would have meant renumbering, which breaks the `art-11-s-2` citation and is forbidden.
+
+So instead I removed the empty `content: ""` key, making Article 11 a section-only article —
+the shape Act 1 actually enacts. **No provision text was added, removed or altered.** The
+archived v2.0.0 keeps its empty body and renders the explicit marker.
+
+That leaves Q11 partly open: the archive question is settled, the live-document question is now
+"is section-only the right shape?" rather than "what text goes at article level?".
+
+## 6. Provision tripwire: green all night
+
+Baseline of 82 provision strings taken at the first commit and re-verified before **every**
+commit. The only change all night is `art-11.content`, which was the one permitted entry.
+Articles 6 and 7 were asserted untouched before `amended_by` was written.
+
+`npm run validate` **passes**: 0 errors, 3 warnings (Article 11's blank body in the archive,
+and v2.0.0 having no `superseded_by` — both in files I was not to edit).
+
+## 7. Decisions waiting on you
+
+**Q2 first — it blocks Articles 6 and 7, and therefore the rest of Act 1.** Article 6 is 100%
+its pre-Act text. Act 1 substitutes clauses (1)–(5) and is silent on clause (6), `Donor`. Both
+options are stated neutrally in `RECONCILIATION.md`.
+
+Then: **Q14** (Article 10's deleted paragraph — a ratification item, decided and applied),
+**Q1** (does a fourth instrument exist, or is Article 19 permanently reserved), **Q4, Q7, Q10,
+Q12, Q13**.
+
+The site says all of this out loud. The reconciliation banner on every page names Articles 6
+and 7 as held under Q2, and Acts 2 and 3 as unapplied — generated from `reconciliation_state`,
+never hardcoded, with a test asserting it names every blocker the YAML lists.
+
+`current.yaml` is versioned **3.0.0-alpha.1**, not 3.0.0. It is one Act partially applied out
+of three and the version says so.
+
+## 8. Found, not acted on
+
+- **`node --test tests/` fails on Node 22** and passes on Node 20 — it resolves a bare directory
+  as a module. The matrix caught it before the deploy job. Fixed, but worth knowing the two
+  runtimes differ in ways that will bite again.
+- **Article 10's retained paragraph had been hand-edited** to Act 1's coordinator naming by an
+  unrecorded actor. That is now in `provenance` on `art-10`. Someone was maintaining this
+  document outside the amendment process as recently as v2.
+- **`sanitize-html` is two patches behind on purpose.** 2.17.6+ needs an ESM-only `htmlparser2`
+  that cannot load on Node 18. Gated on the Node 22 floor move, recorded in the README.
+- **`puppeteer-core` had to be pinned to 25.7.0**, not 23.x — the older line pulls a vulnerable
+  `extract-zip` through a browser downloader this project never uses. It is a devDependency and
+  `npm audit` reports 0 vulnerabilities.
+- **Slugs come from titles**, so retitling an article changes its page URL. The `#art-N` anchor
+  is the stable citation and never moves. If you want URL stability across retitles too, that is
+  a small change and worth deciding before this is shared widely.
+- The generated-asset review flagged, and I fixed, a fourth hue (green) that had crept into the
+  status pills, a `--accent-ink` token that meant opposite things in two files, and a print
+  stylesheet that neutralised six token names nothing defined while leaving the live ones
+  colouring paper.
+
+Detail in `LOG.md`. Queue state in `QUEUE.md`.
diff --git a/.night-run/provisions.sha256 b/.night-run/provisions.sha256
new file mode 100644
index 0000000..5bd9aed
--- /dev/null
+++ b/.night-run/provisions.sha256
@@ -0,0 +1,93 @@
+{
+  "note": "Baseline for the unattended run. Any change outside PERMITTED in tripwire.mjs aborts the run.",
+  "file": "constitution/current.yaml",
+  "taken_at_commit": "f36a02c",
+  "permitted": [
+    "art-11.content"
+  ],
+  "count": 82,
+  "provisions": {
+    "preamble.title": "59e371c5cac498cc5ae8361dafb8f60b4023665a8fb606860a289dc3d399a8dc",
+    "preamble.content": "11084e27c5599ea73017a0a3fc748490e8b4424e8d70e3f2bd4d8301a59d460f",
+    "art-1.title": "340465e4e1d84749399c8c4cb5fe391477ca589b60d42ac82466b185bf209144",
+    "art-1.content": "1df4db010568e198a423233716b60706322ef0e2f32ab984b87503e27aadd8b7",
+    "art-2.title": "c25810315e9a60a56af865645d21aae2f2ed151fccdcfed96f66e4ee2249de78",
+    "art-2.content": "0ae39f1259c95ee4f69da7525efd5c538041ffcb01e357356cfb19c6acfd9803",
+    "art-3.title": "fd726fa20f19279202be396475234f2c0e1517656370a31878bf418a8fb2f4c3",
+    "art-3.content": "99ca100884282913125b858b29a2a37b4c0590c26b70ddd28b26410524920d3c",
+    "art-4.title": "7107d223d07f68eeac0b9ea2d7ed861a22109c82587d7c3daab23b29cac670b6",
+    "art-4.content": "4742d0f1e6320b0035ce10a89374cab6b53ec1d183d6126ed55d2f665da32567",
+    "art-5.title": "88d807aaf72cd108003f22993a4fff628cb23288cb738273a75029c1f06a44f9",
+    "art-5.content": "5f99af579eeb8ea11909dfd74455dab17d813c1cd7beb55936e3477ee2500466",
+    "art-6.title": "0327c874e5d36689055726814c2242234ddd0e23a099015131a49661606ed175",
+    "art-6.content": "f692630dfbcf5b9ff47ac5286a647f3dfbd619e378758c40ceba05838b58d257",
+    "art-6-s-1.title": "59b032afa188773e636ee75d41a49c1fb53fe59857e557efd12340c470352c6b",
+    "art-6-s-1.content": "5e28c093c56763dee3ef245989aae966a28104721828cb6ac5ae0f5b74adfce3",
+    "art-6-s-2.title": "3de27b59e45d45a05b75f669c8ecbceadaa55e011c0f9ffbeafd478696133bb3",
+    "art-6-s-2.content": "41c220d05d425b8bda5b2c82f970930b08b6fe55f19ff00feba9af6d076000de",
+    "art-6-s-3.title": "ef203cde61fbe517b71b13314f4cec665d5c3608ebc5bc248588716468df08ff",
+    "art-6-s-3.content": "38e3a605504d1942d32daed71f73d35b2c14300fc8367fe791298989265bdde7",
+    "art-6-s-4.title": "f00e33d162be50144a2903bfec536095c8cd3fac6da861b4620362f0c9fe46ae",
+    "art-6-s-4.content": "6974734a0ef608197a58fe285a57feefa1f23031b9e375f991b2d0c2af61b1cb",
+    "art-6-s-5.title": "ef4683c3dc7771c8daa13d2356032eb2929fb8502af11b206644b35fb1f9f647",
+    "art-6-s-5.content": "26ee11ea2fc94b54e983bb03f3819e903af91e025d16efdbac64b81d4f973d00",
+    "art-6-s-6.title": "f7c38806a36b890a2ccf89b6b43c188516e91a9fc39b0caec328b99974d7e607",
+    "art-6-s-6.content": "b6b6d99ac0a4f7f01afd165f0b16dcf39c3f1eb781ff4ef962b1d271fe782f65",
+    "art-7.title": "9feceb9333b5ff626aabf80e4c544e2b7efca00f0f8438d895d87921e87d9b81",
+    "art-7.content": "aa4332775c98ecc2481489ba3e2e305e98112ab1675f209ee4b06698b1d064fe",
+    "art-8.title": "98ffa2feca3edcb42e53a138e8df06c8d2a00e0ba3b18dd79c8b512eaeafa135",
+    "art-8.content": "745dfa405981ed4ca44442829574449c69bfcbf2c13522c1bfc4d8a06c608268",
+    "art-8-s-1.title": "fcbe685d228c0c062a5cefc63944abe612919080a4e37435d39a4e696315f867",
+    "art-8-s-1.content": "eb2abfc03df7b0f27cf9d55a35363e7aa2cecc8dd2778eeb8d0632f1886fbe04",
+    "art-8-s-2.title": "4fc52a3c4c558b517c463b22d86d0e3b9cfd4255c98fe3510f9075b37ab419c9",
+    "art-8-s-2.content": "b14b4cb6f1430a81fd9f97419d03cb14f051dc2db2f21c06b8ab859430dbc880",
+    "art-8-s-3.title": "dfa9dfa5cad2d8f96bee96c28ba04843b2e5d795150edc07588a8e074d91a59b",
+    "art-8-s-3.content": "81b1c1999a27a3c88b7e57ce08201c83c80540fa216ea4ebf40e2c39ef836180",
+    "art-8-s-4.title": "fa6c2f1b88ab30a4342d992c9fb01f33388a7b3ce5370ea1f4dd013c1fb6b874",
+    "art-8-s-4.content": "f0a780022baa7b1a8b4994cc3807c3888612d88841eb7e34bb727e96c30970aa",
+    "art-8-s-5.title": "68f1e9f90c249733968025ee52895c640b9a4e3efe9d4f6ed4008094cb89fe42",
+    "art-8-s-5.content": "81239ac1c14e85463b974329675ba360f2bbf7225b070ead633ad63946e80f4d",
+    "art-9.title": "c7ce069ec4bcc406376956a964265eef653108c2d23e0da3155e76629ec4c6c5",
+    "art-9.content": "fa755af3559c8258fbe7aa3883130519c4582b86da72e3dad2eabaa874381e43",
+    "art-10.title": "8e64ff17ef33b058dc03814f6922faa1040b6c09037ee94bb1b48437c3ddf6b4",
+    "art-10.content": "0b6d498b4ebc42c4eac30101fe491c2a1a7f5813c4187b52112806082be98a8d",
+    "art-10-s-1.title": "dfa9dfa5cad2d8f96bee96c28ba04843b2e5d795150edc07588a8e074d91a59b",
+    "art-10-s-1.content": "173cb2da6a0e3a962c6a34c019a6124d68ac8ddcfbe2f70c625535f948223e63",
+    "art-10-s-2.title": "fa6c2f1b88ab30a4342d992c9fb01f33388a7b3ce5370ea1f4dd013c1fb6b874",
+    "art-10-s-2.content": "c99a8db0398d7c40bb1e64228aa2f56b87b2ae34b53c0fab6cbc5d2c6669cea5",
+    "art-10-s-3.title": "68f1e9f90c249733968025ee52895c640b9a4e3efe9d4f6ed4008094cb89fe42",
+    "art-10-s-3.content": "b992da11361017adf7f60d30182266cc53a8a14950a097da770c4fa4db3f2259",
+    "art-11.title": "9fb6669a77ea48bb4c080ead0e145a11f0dea709af0d542f6ad87d27958a61a1",
+    "art-11.content": "0b6d498b4ebc42c4eac30101fe491c2a1a7f5813c4187b52112806082be98a8d",
+    "art-11-s-1.title": "c981a30c0e7b420b0ba50ce7d1d4174a511fdf20567b852ab02c774cb9a3591e",
+    "art-11-s-1.content": "17612d9aca69f815ac99b45a8ac2c0e29108b3ea901880d03d95a709a1b00dde",
+    "art-11-s-2.title": "d456583904a7dd394696064df1106bc90fc44eefc1e884d5420a4b0ebf7794db",
+    "art-11-s-2.content": "544267149f490925bfeda78b4129a95ae7f65a58f62dd8986c630c72a56de380",
+    "art-12.title": "3303026655c83910b9a0ae51382813956e58271c276fd5a27d05f95b847b139a",
+    "art-12.content": "8c5ac0ac874e1d0b65dbf0a7c081db4bb42c4886967e1288982734bffc8704ad",
+    "art-13.title": "8f672276e8b9971baef1e26d73b6733f436575230b342e58e5722c11536263fc",
+    "art-13.content": "3124807d0cfcf79deaa8683b46627fd1859abaf233627aa69ddeb8b9e7ed75ef",
+    "art-14.title": "0e23163adf07b381c77d179daffb12aea79d1eea42f9daaceaf04ba4649e23f1",
+    "art-14.content": "0b6d498b4ebc42c4eac30101fe491c2a1a7f5813c4187b52112806082be98a8d",
+    "art-14-s-1.title": "d37a699e6ab3e501964d63d56adde49f2a1bdffc755a6e232d3fa901a6a1e94f",
+    "art-14-s-1.content": "f3314ee45aa01626ec210290d1ca09ea97f30ac2bfee0df172bc9dfc4fc22fb0",
+    "art-15.title": "7dfacbb89e4c572e1ef107514226a3862062ab1d3dc65a8c6a90bd081a9b0c3a",
+    "art-15.content": "0b6d498b4ebc42c4eac30101fe491c2a1a7f5813c4187b52112806082be98a8d",
+    "art-15-s-1.title": "9e4fa9ab2696fffff2d9a8bbe95b7bf248777a8c7692f1216f5fe8a028228729",
+    "art-15-s-1.content": "c1e001dcb9eee58fb267bf880177249ea3d1fd640cfa51b297a9f5bb3c601ab6",
+    "art-15-s-2.title": "29783c629a56a5a6e54aa601d3a885e80afea5df094a764758db4948a7f66048",
+    "art-15-s-2.content": "3269f8ae8342836eeb04287c9cc029c133e7d962b6e88a6dc277c93a017378e2",
+    "art-16.title": "a950f283b12a66b85b69fda84b96348c831f9ecc30d25fdd29eae4374f4d67e1",
+    "art-16.content": "a0437c584b916690ccc99887cb3aad91ee112ff379fdebf1bcae4190e9766890",
+    "art-17.title": "caa74c0543e24a1abb9a3edcacb1665f2ad5f668b59b5b3d052c48c0cdafb8a5",
+    "art-17.content": "d6cfa273ef35631b4bc9acfb66527379ab92fd17d266e393cc9e7ab04fe3bbab",
+    "art-18.title": "e9c92d339346160b43145f3196405c26781b480229748db7b8249ddad969bebb",
+    "art-18.content": "90372648f0cf9d43d2079136bcb3d5d0e80e1abcc6c9fd247a8dcd674e9ff2a6",
+    "art-19.title": "3385ffe6747065e4884da355303009050e129ec48d3e05bce928d6213bb6753c",
+    "art-19.content": "0b6d498b4ebc42c4eac30101fe491c2a1a7f5813c4187b52112806082be98a8d",
+    "art-20.title": "15245b427efc9b5ec04016ad2f98944ac21b8150262cc6552ddcd93e75521e38",
+    "art-20.content": "894c47e0c2d7a7bcc4b817a9e88942331b01d7caaa7756737e3d8c23f6371d0b",
+    "art-21.title": "37d1b30ec49a212797eced763fc1fe7cd5c03604e1dda266a750d785cbd1cff0",
+    "art-21.content": "429fda7f865cd803a1601cb128df04e50d242a1fc87b222c9d9a2a7f3f07e11d"
+  }
+}
diff --git a/.night-run/screenshots/amendments-1440-dark.png b/.night-run/screenshots/amendments-1440-dark.png
new file mode 100644
index 0000000..cb44e81
Binary files /dev/null and b/.night-run/screenshots/amendments-1440-dark.png differ
diff --git a/.night-run/screenshots/amendments-1440-light.png b/.night-run/screenshots/amendments-1440-light.png
new file mode 100644
index 0000000..cb44e81
Binary files /dev/null and b/.night-run/screenshots/amendments-1440-light.png differ
diff --git a/.night-run/screenshots/archive-superseded-1440-light.png b/.night-run/screenshots/archive-superseded-1440-light.png
new file mode 100644
index 0000000..96f4401
Binary files /dev/null and b/.night-run/screenshots/archive-superseded-1440-light.png differ
diff --git a/.night-run/screenshots/article-1440-dark.png b/.night-run/screenshots/article-1440-dark.png
new file mode 100644
index 0000000..4c94287
Binary files /dev/null and b/.night-run/screenshots/article-1440-dark.png differ
diff --git a/.night-run/screenshots/article-1440-light.png b/.night-run/screenshots/article-1440-light.png
new file mode 100644
index 0000000..4c94287
Binary files /dev/null and b/.night-run/screenshots/article-1440-light.png differ
diff --git a/.night-run/screenshots/home-1440-dark.png b/.night-run/screenshots/home-1440-dark.png
new file mode 100644
index 0000000..2c67b19
Binary files /dev/null and b/.night-run/screenshots/home-1440-dark.png differ
diff --git a/.night-run/screenshots/home-1440-light.png b/.night-run/screenshots/home-1440-light.png
new file mode 100644
index 0000000..97c84d3
Binary files /dev/null and b/.night-run/screenshots/home-1440-light.png differ
diff --git a/.night-run/screenshots/home-375-dark.png b/.night-run/screenshots/home-375-dark.png
new file mode 100644
index 0000000..aadc481
Binary files /dev/null and b/.night-run/screenshots/home-375-dark.png differ
diff --git a/.night-run/screenshots/home-375-light.png b/.night-run/screenshots/home-375-light.png
new file mode 100644
index 0000000..aadc481
Binary files /dev/null and b/.night-run/screenshots/home-375-light.png differ
diff --git a/.night-run/screenshots/home-768-dark.png b/.night-run/screenshots/home-768-dark.png
new file mode 100644
index 0000000..20dd897
Binary files /dev/null and b/.night-run/screenshots/home-768-dark.png differ
diff --git a/.night-run/screenshots/home-768-light.png b/.night-run/screenshots/home-768-light.png
new file mode 100644
index 0000000..20dd897
Binary files /dev/null and b/.night-run/screenshots/home-768-light.png differ
diff --git a/.night-run/screenshots/print-preview.pdf b/.night-run/screenshots/print-preview.pdf
new file mode 100644
index 0000000..21d73eb
Binary files /dev/null and b/.night-run/screenshots/print-preview.pdf differ
diff --git a/.night-run/tripwire.mjs b/.night-run/tripwire.mjs
new file mode 100644
index 0000000..d9a5325
Binary files /dev/null and b/.night-run/tripwire.mjs differ
diff --git a/.nojekyll b/.nojekyll
new file mode 100644
index 0000000..e69de29
diff --git a/.vscode/settings.json b/.vscode/settings.json
deleted file mode 100644
index 6b665aa..0000000
--- a/.vscode/settings.json
+++ /dev/null
@@ -1,3 +0,0 @@
-{
-  "liveServer.settings.port": 5501
-}
diff --git a/AUDIT-CONFIRMED.md b/AUDIT-CONFIRMED.md
new file mode 100644
index 0000000..bef0209
--- /dev/null
+++ b/AUDIT-CONFIRMED.md
@@ -0,0 +1,273 @@
+# Audit Verification
+
+**Verified:** 2026-08-14 · branch `rebuild/v3` · against `main` @ `1d327b0`
+**Method:** every claim reproduced empirically — no finding accepted on inspection alone.
+
+Test harness: Node 18.19.1, `js-yaml@4.1.0`, `marked@15.0.6` (npm) and `marked@15.0.12` (the file the
+production CDN URL actually serves today), `jsdom@24.1.3`. The live page was reconstructed in a real
+DOM — same markup as [index.html](index.html), same two CDN libraries, same
+[js/opencodelaw.js](js/opencodelaw.js), with `fetch` stubbed to read the repo from disk — and the
+resulting document inspected.
+
+---
+
+## Verdict summary
+
+| # | Claim | Verdict |
+|---|---|---|
+| 1 | Art. 11 `Units` has no `content:` key → `marked.parse(undefined)` throws → kills arts. 11–18, amendments table, back-to-top, theme restore, nav | ❌ **Refuted** |
+| 2 | `cdn.jsdelivr.net/npm/marked/marked.min.js` is unversioned and the file no longer exists | ⚠️ **Half true** |
+| 3 | `navArticleId = navLink.href = '#article1'` returns an absolute URL → `querySelector` SyntaxError → scroll-spy never works | ❌ **Refuted** |
+| 4 | `scroll` listener registered before `#backToTop` exists | ✅ **Confirmed** |
+| 5 | `<script async>` races its own CDN dependencies | ❌ **Refuted** |
+| 6 | `.gitignore` contains `css/style.css` | ✅ **Confirmed** |
+| 7 | `act: #` parses to `null` | ✅ **Confirmed** |
+| 8 | `archive: /archives/v1` is absolute-rooted and extensionless | ✅ **Confirmed** |
+| 9 | `archives/v2.html` points at the mutable current spec, titled "STM Constitution V1" | ✅ **Confirmed** |
+| 10 | `specs/v1.yaml` declares `info.version: 2.0.0` | ✅ **Confirmed** |
+| 11 | `specs/opencon.yaml` is a near-duplicate of `v1.yaml` | ✅ **Confirmed** |
+| 12 | Montserrat `format("ttf")` invalid; Cuprum `.woff` declared `format("woff2")` | ✅ **Confirmed** |
+| 13 | `.vertical-nav { display: none }` below 768px | ✅ **Confirmed** |
+| 14 | Three-way naming disagreement: doc / YAML / JS | ✅ **Confirmed** |
+
+**10 confirmed · 3 refuted · 1 partially confirmed.**
+
+The three refuted claims are all in the audit's Part 1, "Why it is broken right now". **The site is not
+crashing.** It renders all 18 articles today. The governance findings (Part 3) — which are the
+serious ones — are confirmed in full and are unaffected.
+
+---
+
+## ❌ 1 — The renderer does not throw, and nothing is killed
+
+**Claim:** article 11 has no `content:` key; `marked.parse(undefined)` throws; articles 11–18, the
+amendments table, the back-to-top button, theme restore and all nav interactivity never render.
+
+**Refuted on every element.**
+
+The key exists. [specs/v2.yaml:203-206](specs/v2.yaml#L203-L206) is `content: |` followed by a blank
+line, which YAML resolves to an **empty string**, not `undefined`:
+
+```
+title        : "Units"
+has key      : true
+typeof       : string
+value        : ""
+```
+
+`marked` throws only on `undefined`/`null`. On `""` it returns `""`:
+
+```
+undefined                -> THREW: marked(): input parameter is undefined or null
+empty string             -> OK, returned ""
+actual v2 art-11 value   -> OK, returned ""
+```
+
+Rendering the real page in jsdom, the whole chain completes with **zero errors**:
+
+```
+articles rendered (h2.heading-secondary): 18 / 18 expected
+sections rendered (h3)                 : 22
+amendments table present               : true
+amendment rows                         : 2
+back-to-top button present             : true
+nav links built                        : 42
+theme toggle present                   : true
+first: 1. Name of the Organization   last: 18. Suspension/Termination
+ERRORS CAPTURED DURING RUN: (none)
+```
+
+**The real defect at this location is different, and still serious.** Article 11 renders as a
+heading with an empty body:
+
+```
+heading       : 11. Units
+paragraph HTML: ""
+-> renders as : SILENTLY EMPTY (no text, no error)
+```
+
+A published constitution article with no text, displayed with no warning, for two years. That is a
+content-integrity failure rather than a crash — and it is exactly what Phase 2 validation must catch.
+
+**The latent hazard the audit describes is real, just not triggered here.** An absent `content:` key,
+or `content:` with no value (which YAML resolves to `null`), *would* throw and *would* abort the
+chain, because the throw happens inside `.then()`. The v2 spec sits one keystroke away from the
+failure described. Validation must reject empty, null and missing alike.
+
+## ⚠️ 2 — Unversioned: yes. Gone: no.
+
+`https://cdn.jsdelivr.net/npm/marked/marked.min.js` returns **HTTP 200, 39,903 bytes**. It is not a
+404 and it is not breaking the site.
+
+What it serves is the interesting part:
+
+```
+/**
+ * marked v15.0.12 - a markdown parser
+ */
+```
+
+`marked@latest` is **18.0.9**. `marked.min.js` was dropped in the 16.x line, so jsDelivr resolves the
+unversioned path back to the newest release that still contains that file — 15.0.12. The site works
+today by way of undocumented CDN fallback behaviour, silently pinned to an end-of-life major three
+versions behind, with no pin in the repo. The dependency risk stands; the outage does not.
+
+Same for `js-yaml` — `cdnjs.../js-yaml/4.0.0/js-yaml.min.js` returns HTTP 200, and it is at least
+version-pinned.
+
+## ❌ 3 — The href round-trip bug does not exist
+
+Two independent reasons, either sufficient.
+
+**a. A chained assignment evaluates to the right-hand side**, not to a re-read of the property. The
+getter is never consulted:
+
+```
+navArticleId = navLink.href = '#article1'
+  value of navArticleId       : "#article1"
+  value of reading .href back : "https://constitution.stmorg.in/#article1"
+```
+
+**b. `updateActiveMenu` uses `getAttribute('href')`**, which returns the literal content attribute
+(`#article1`), never the resolved URL — so even a bad round-trip could not reach `querySelector`.
+
+Live DOM, every nav link checked:
+
+```
+total nav links: 42 | unresolved: 0 | SyntaxErrors: 0
+sample article href : "#article1"
+sample section href : "#article6-section1"
+```
+
+Scroll-spy resolves all 42 targets. The audit's stated cause is wrong.
+
+Note the sub-menu link at [js/opencodelaw.js:106](js/opencodelaw.js#L106) does rely on `navArticleId`
+being an undeclared implicit global. It works only because the loop is synchronous — fragile, but
+not the reported bug.
+
+## ✅ 4 — Scroll handler throws before render
+
+Confirmed and reproduced. [js/opencodelaw.js:461](js/opencodelaw.js#L461) registers the listener at
+module scope; `#backToTop` is not created until the fetch resolves at
+[line 379](js/opencodelaw.js#L379). Scrolling in that window:
+
+```
+scroll before render threw: Cannot read properties of null (reading 'style')
+```
+
+On a slow connection or a failed fetch this throws on every scroll event for the life of the page.
+[Lines 477-482](js/opencodelaw.js#L477-L482) (`topFunction`, `topButton`) are unreachable dead code.
+
+## ❌ 5 — `async` does not race here
+
+The two CDN tags are parser-blocking classic scripts *preceding* the async tag. The parser cannot
+prepare the `async` script until it has executed them, so `marked` and `jsyaml` are always defined
+first. The preload scanner may fetch all three in parallel, but fetch order is not execution order.
+
+Bad practice, and it should still go — but it is not a live defect and not non-deterministic.
+
+## ✅ 6 — `.gitignore` ignores the only stylesheet
+
+```
+.gitignore:2:css/style.css	css/style.css
+```
+
+Confirmed via `git check-ignore --no-index`. The file survives only because it was committed before
+the rule landed (`git ls-files` still lists it). Any clean regeneration drops the site's entire
+stylesheet. The file also has no trailing newline.
+
+## ✅ 7 — `act: #` is `null`
+
+```
+ammendments[0].act = null
+```
+
+`#` opens a YAML comment; the value is empty. The renderer assigns it straight to `href`
+([line 348](js/opencodelaw.js#L348)), producing a link to a page named `null`.
+
+## ✅ 8 — Archive links cannot resolve
+
+```
+ammendments[0].archive = "/archives/v1"
+ammendments[1].archive = "/"
+```
+
+Absolute-rooted and extensionless — it depends on the Apache rewrite in [.htaccess](.htaccess), which
+GitHub Pages does not read. The second amendment's archive is the bare site root, which is not an
+archive at all.
+
+## ✅ 9 — The archive is not an archive
+
+[archives/v2.html](archives/v2.html) loads `../specs/v2.yaml` — the live, mutable current spec — and
+is titled `STM Constitution V1`. Both confirmed. Editing the current constitution retroactively
+rewrites the "archived" copy.
+
+## ✅ 10 — v1 misdeclares its own version
+
+[specs/v1.yaml:13](specs/v1.yaml#L13) is `version: 2.0.0`. Both v1 and v2 report `2.0.0`.
+
+## ✅ 11 — `opencon.yaml` is a duplicate
+
+Full diff against `v1.yaml` is 14 lines: `version` (`1.0.0` vs `2.0.0` — the dead file has the
+*correct* value) and the absence of the `ammendments:` block. 17 articles vs v1's 17; v2 has 18.
+
+## ✅ 12 — Neither webfont has ever loaded
+
+[css/style.scss:5](css/style.scss#L5) — `format("ttf")` is not a valid format token; it must be
+`truetype`. [Lines 12-14](css/style.scss#L12-L14) declare the same `.woff` file twice, first as
+`format("woff2")`. Both faces fail to load; all typography is browser-default fallback.
+
+## ✅ 13 — No navigation on mobile
+
+[css/style.scss:295-298](css/style.scss#L295-L298) — `.vertical-nav { display: none }` under 768px.
+An 18-article legal document with no table of contents on phones. Open issue #1.
+
+## ✅ 14 — Three-way naming disagreement
+
+| Source | Root key | Amendments key |
+|---|---|---|
+| [schema/opencodelaw.md:5,54](schema/opencodelaw.md#L5) | `OpenCodeLaw` | `amendments` |
+| [specs/v2.yaml:1,286](specs/v2.yaml#L1) | `openconstitution` | `ammendments` |
+| [js/opencodelaw.js:303](js/opencodelaw.js#L303) | — | `ammendments` |
+
+Confirmed: `v2 root keys: [ 'openconstitution', 'info', 'preamble', 'articles', 'ammendments' ]`.
+Anyone following the documented schema produces a file the renderer cannot read.
+
+---
+
+## Additional findings, not in the original audit
+
+| # | Finding | Evidence |
+|---|---|---|
+| A | **Malformed colour, declaration silently dropped** | [css/style.scss:499](css/style.scss#L499) — `rgba(0,0,0.87)` has three arguments, not four. Invalid; the browser discards it. Wide-viewport row headers get no colour. |
+| B | **Deep links confirmed dead on cold load** | No `hashchange` or load-time hash handling anywhere in the JS — `scrollIntoView` appears only in click handlers ([line 438](js/opencodelaw.js#L438)) and dead code ([line 478](js/opencodelaw.js#L478)). Content is injected after the browser has already resolved the hash. |
+| C | **`#320063` verified as the logo colour** | Decoded [assets/img/OpenCodeLaw.png](assets/img/OpenCodeLaw.png) (500×500, RGBA): `#ffffff` 237,099 px, then **`#320063` 4,627 px** — the dominant brand hue by an order of magnitude. The promotion to primary accent is justified. |
+| D | **`#533566` is not in the stylesheet** | It exists only at [js/opencodelaw.js:178](js/opencodelaw.js#L178) as an inline slider colour. Full SCSS palette is: `#007bff` ×12, `#333` ×7, `#fff` ×2, `#000` ×2, `#f5f5f5`, `#ccc`, `#c07534`, `#555`, plus `rgba(0,0,0,0.18 / .12 / .54)`. |
+| E | **Local toolchain is below the target** | Node **18.19.1** installed, no `nvm`/`fnm`/`volta`. `marked@18` declares `engines: node >= 20`. See decision note below. |
+| F | **The three Acts are text-extractable** | `pdftotext` cleanly extracts all three. Each header confirms assent **3rd May 2024** from the Internal Compliance Committee. Phase 3 will not need OCR. |
+
+---
+
+## What this changes about the rebuild
+
+Nothing is removed from the plan; one thing is re-prioritised and one justification is corrected.
+
+1. **The urgency is legal, not operational.** The site is not down. Phase 3 — publishing a
+   constitution that reflects its own three enacted Amendment Acts — is the real emergency, and
+   Article 11 has been publishing a blank provision for two years.
+2. **Phase 2 validation is vindicated by a near miss, not a hit.** `content: ""` passes silently
+   today and renders nothing. The validator must reject empty, `null` and missing content alike —
+   the requirement stands, but as a defence against *silent blanks*, not just crashes.
+3. **Phase 4's static build stops depending on CDN fallback luck**, which is the accurate reason to
+   vendor and pin — not a 404 that never happened.
+4. **Add to Phase 6:** fix the malformed `rgba(0,0,0.87)` when extracting tokens.
+5. **Phases 1 and 6 are unchanged.** Every UI, accessibility, SEO and governance finding stands.
+
+### Decision needed — Node version
+
+The plan specifies Node 20+; this machine has 18.19.1 with no version manager. To keep
+`npm run validate && npm test && npm run build` runnable locally **and** on CI, Phase 1 pins
+dependencies that run on both (`marked@15.0.12`, `js-yaml@4.1.0`, `ajv@8.17.1`,
+`sanitize-html@2.17.7`), declares `engines: >=18.18.0`, and sets the GitHub Actions runner to Node 20.
+Say the word and I will target Node 20 exclusively instead — local verification would then need a
+Node upgrade first.
diff --git a/CNAME b/CNAME
new file mode 100644
index 0000000..dc56da4
--- /dev/null
+++ b/CNAME
@@ -0,0 +1 @@
+constitution.stmorg.in
diff --git a/CONTRIBUTION.md b/CONTRIBUTION.md
index 9d6a455..1e4f1e1 100644
--- a/CONTRIBUTION.md
+++ b/CONTRIBUTION.md
@@ -1,26 +1,77 @@
-# Contribution Guidelines
+# Contributing
 
-Thank you for considering contributing to our project! Before you start, please read the following guidelines to ensure a smooth contribution process.
+Thanks for helping. This project renders a real organization's governing document,
+so a few rules are stricter than you might expect.
 
-## Stylesheet Compilation
+## Setup
 
-We are using `style.scss` as our main stylesheet. To compile SCSS into CSS, follow these steps:
+```bash
+npm ci
+npm run validate && npm test && npm run build && npm run linkcheck
+```
 
-1. **Install Live Sass Compiler:**
-   Make sure you have "Live Sass Compiler" installed in your development environment. You can install it using Visual Studio Code or any other compatible code editor extensions marketplace.
+Node 20 or 22. There is no SCSS step and no editor extension to install — the
+previous instructions asked contributors to hand-compile SCSS in a VS Code plugin,
+which is not a build system.
 
-2. **Compile `style.scss`:**
-   Configure your Live Sass Compiler to compile `style.scss` into `style.css`. Please ensure that you do not modify `style.css` directly. All your changes should be made in `style.scss`.
+```bash
+npm run dev          # build, then serve dist/ locally
+npm run validate     # schema + citation integrity + act cross-references
+npm run linkcheck    # internal 404s and base-path escapes
+npm run spec         # regenerate schema/SPEC.md after changing the schema
+npm run provenance   # regenerate PROVENANCE.md
+```
 
-## JavaScript Changes
+## The one rule about content
 
-All script changes, additions, or modifications must be done in `js/opencodelaw.js` file. Please refrain from scattering scripts across multiple files for better code organization and maintainability.
+**Do not edit provision text unless an enacted instrument authorises it.**
 
-## Pull Request Guidelines
+`constitution/`, `acts/` and `schema/` hold the law and the contract that describes
+it. Changes there are reviewed as legal changes, not code changes:
 
-- Fork the repository and create your branch from `main`.
-- Ensure your code adheres to the existing coding style and standards.
-- Provide a clear and descriptive title for your pull request.
-- Reference the issue numbers your pull request addresses (if applicable).
+- Every provision change cites the Act that authorises it, by file and line.
+- A Statement of Objects and Reasons is evidence of intent and **never** the
+  authority for an operation. The validator enforces this (`sor-as-authority`).
+- Anything under `constitution/versions/` is append-never, edit-never. An archive
+  that changes is not an archive.
+- Article `id` and `number` are permanent public API. Never renumber to close a gap;
+  record a `reserved` entry instead.
+- If a change to the law is not mechanical, stop and open an issue. Ambiguity in an
+  instrument is a question for the board, not a judgement call in a pull request.
 
-Thank you for your contribution! :tada:
+Engine changes — `src/`, `tests/`, styles, scripts, docs — are ordinary contributions.
+
+## Where things live
+
+```
+src/          engine: build, validate, link check, text comparison
+schema/       the JSON Schema and its generated reference
+constitution/ current.yaml plus frozen versions/
+acts/         signed PDFs, extracted text, and the amendment register
+tests/        run against both the source and the built output
+```
+
+## Standards
+
+- **Every fix gets a test.** Preferably one that fails first. The suite exists
+  because real bugs shipped: a `<br>` that corrupted text comparison, a PDF form
+  feed that silently dropped a clause, article pages linking to anchors that were
+  not there.
+- Server-render everything. The page must be complete and readable with JavaScript
+  disabled; scripts only enhance.
+- All internal URLs go through the base-path helper. A root-relative link that works
+  locally will 404 on project Pages, and `npm run linkcheck` will fail you.
+- Markdown output is sanitised against a strict allowlist. Do not widen it to admit
+  SVG or animation elements.
+- Keep the palette. Tokens live in `src/styles/tokens.css`; no new hues.
+- Accessibility is not optional: landmarks, visible focus, full keyboard operation,
+  4.5:1 contrast in both themes, `prefers-reduced-motion` honoured.
+
+## Pull requests
+
+- Branch from `main`. Reference the issue number.
+- Say what you verified and how. "Tests pass" is not a description of a test.
+- CI must be green: validate, test, build and link check all gate the deploy.
+- If you disagree with something here and have evidence, say so in the PR — several
+  findings in [AUDIT-CONFIRMED.md](AUDIT-CONFIRMED.md) were corrections to a previous
+  audit that turned out to be wrong.
diff --git a/PROVENANCE.md b/PROVENANCE.md
new file mode 100644
index 0000000..c2d21ec
--- /dev/null
+++ b/PROVENANCE.md
@@ -0,0 +1,1070 @@
+# Provenance
+
+**Status:** unsigned. No constitutional text has been changed.
+**Generated:** `npm run provenance` · branch `rebuild/v3` · 24 comparisons
+
+For every provision the three Acts touch: the text in `constitution/current.yaml` today,
+the text the Act prescribes, and a verdict. Regenerate with `npm run provenance`.
+
+| Verdict | Meaning | Count |
+|---|---|---|
+| 🟢 ALREADY-APPLIED | Current text matches the Act's prescribed text | 24 |
+| 🟡 NOT-APPLIED | Current text is the pre-Act text, or the insertion has not been made | 0 |
+| 🔴 DIVERGENT | Matches neither — edited outside the amendment process | 0 |
+
+## Method
+
+Comparison runs on `src/text-compare.mjs`. Tags are stripped **before** punctuation and
+replaced with a space, so inline `<br>` in the specs cannot inject a stray `br` token and
+produce a false NOT-APPLIED. `tests/text-compare.test.mjs` asserts this against the real
+Article 9 pair; if that fixture fails, no verdict in this file may be trusted.
+
+Enumerator style (`(1)` vs `1.`) and typography (curly vs straight quotes) are folded, so
+a provision is not reported as changed merely for being formatted differently.
+
+- **Article scope** — whole-provision similarity, body plus every section heading and body.
+- **Clause scope** — containment: whether the Act's clause appears anywhere in the current
+  provision. The constitution stores several of these articles as one undivided block, and
+  slicing it into clauses would mean guessing where each clause begins.
+
+Match threshold 0.94. Pre-Act baseline is `constitution/versions/v1.0.0.yaml`,
+the last version that demonstrably predates all three Acts.
+
+## Summary
+
+| | Act | Provision | Op | Scope | Current title | Act title | Reads as Act | Act words present | Unchanged since v1 | Verdict |
+|---|---|---|---|---|---|---|---|---|---|---|
+| 🟢 | Act 1 of 2024 | `art-6` (1) | substitute | clause | STM Roles | STM Roles | 100.0% | 100.0% | 73.4% | **ALREADY-APPLIED** |
+| 🟢 | Act 1 of 2024 | `art-6` (2) | substitute | clause | STM Roles | STM Roles | 100.0% | 100.0% | 73.4% | **ALREADY-APPLIED** |
+| 🟢 | Act 1 of 2024 | `art-6` (3) | substitute | clause | STM Roles | STM Roles | 100.0% | 100.0% | 73.4% | **ALREADY-APPLIED** |
+| 🟢 | Act 1 of 2024 | `art-6` (4) | substitute | clause | STM Roles | STM Roles | 100.0% | 100.0% | 73.4% | **ALREADY-APPLIED** |
+| 🟢 | Act 1 of 2024 | `art-6` (5) | substitute | clause | STM Roles | STM Roles | 100.0% | 100.0% | 73.4% | **ALREADY-APPLIED** |
+| 🟢 | Act 1 of 2024 | `art-7` (4) | substitute | clause | Membership | Membership | 100.0% | 100.0% | 76.2% | **ALREADY-APPLIED** |
+| 🟢 | Act 1 of 2024 | `art-7` (6) | substitute | clause | Membership | Membership | 100.0% | 100.0% | 76.2% | **ALREADY-APPLIED** |
+| 🟢 | Act 1 of 2024 | `art-9` | substitute | article | Board Members | Board Members | 100.0% | 100.0% | 28.3% | **ALREADY-APPLIED** |
+| 🟢 | Act 1 of 2024 | `art-10` | substitute | article | Intermediate Board Members | Intermediate Board Members | 100.0% | 100.0% | 32.7% | **ALREADY-APPLIED** |
+| 🟢 | Act 1 of 2024 | `art-11` | substitute | article | Units | Units | 99.4% | 100.0% | 26.8% | **ALREADY-APPLIED** |
+| 🟢 | Act 1 of 2024 | `art-12` | substitute | article | Alumini | Alumni | 100.0% | 100.0% | 47.1% | **ALREADY-APPLIED** |
+| 🟢 | Act 1 of 2024 | `art-18` | insert | article | Suspension/Termination | Suspension/Termination | 100.0% | 100.0% | 0.0% | **ALREADY-APPLIED** |
+| 🟢 | Act 2 of 2024 | `preamble` | substitute | article | Preamble | Preamble | 100.0% | 100.0% | 30.0% | **ALREADY-APPLIED** |
+| 🟢 | Act 2 of 2024 | `art-3` | substitute | article | Aim and Objectives | Aim and Objectives | 100.0% | 100.0% | 35.0% | **ALREADY-APPLIED** |
+| 🟢 | Act 2 of 2024 | `art-4` | substitute | article | Mission statement | Mission statement | 100.0% | 100.0% | 11.1% | **ALREADY-APPLIED** |
+| 🟢 | Act 2 of 2024 | `art-5` | substitute | article | Vision Statement | Vision Statement | 100.0% | 100.0% | 55.6% | **ALREADY-APPLIED** |
+| 🟢 | Act 2 of 2024 | `art-8` | substitute | article | Internship | Internship | 100.0% | 100.0% | 84.4% | **ALREADY-APPLIED** |
+| 🟢 | Act 2 of 2024 | `art-16` (3) | substitute | clause | Amendments | Amendments | 100.0% | 100.0% | 77.0% | **ALREADY-APPLIED** |
+| 🟢 | Act 2 of 2024 | `art-17` (1) | substitute | clause | Dissolution | Dissolution | 100.0% | 100.0% | 70.5% | **ALREADY-APPLIED** |
+| 🟢 | Act 2 of 2024 | `art-14` | substitute | article | Leaves | Leaves | 100.0% | 100.0% | 12.7% | **ALREADY-APPLIED** |
+| 🟢 | Act 2 of 2024 | `art-20` | insert | article | Meetings and Activities | Meetings and Activities | 100.0% | 100.0% | 0.0% | **ALREADY-APPLIED** |
+| 🟢 | Act 2 of 2024 | `art-15` | substitute | article | Exit Process | Exit Process | 100.0% | 100.0% | 9.8% | **ALREADY-APPLIED** |
+| 🟢 | Act 3 of 2024 | `art-13` | substitute | article | Annual Report | Annual Report | 100.0% | 100.0% | 70.4% | **ALREADY-APPLIED** |
+| 🟢 | Act 3 of 2024 | `art-21` | insert | article | Financial Management | Financial Management | 100.0% | 100.0% | 0.0% | **ALREADY-APPLIED** |
+
+## Provision by provision
+
+### Act 1 of 2024 — *Membership Act, 2024*
+
+#### 🟢 art-6 clause (1) — ALREADY-APPLIED
+
+`substitute` · clause scope · source `act-1-2024` line 18
+
+Reads as the Act **100.0%** · Act's words present 100.0% · unchanged since v1 73.4%
+
+<details><summary>Current text — <code>constitution/current.yaml</code></summary>
+
+```
+The membership of the NGO shall be open to all the students of the college who are willing to
+serve the society and who are willing to abide by the rules and regulations of the NGO.
+
+Board Member
+Any person who is willing to serve society and abide by the rules and regulations of the NGO to work in STM for lifetime.
+
+Intermediate Board Member
+Any person who is willing to serve society and abide by the rules and regulations of the NGO to work in STM for lifetime under the board.
+
+Unit Board Member
+Any person who is willing to serve society and abide by the rules and regulations of the NGO to work in STM in their respective unit within their academic life.
+
+Coordinator
+Any person who is willing to serve society and abide by the rules and regulations of the NGO to work in the STM in their respective unit within their academic life.
+
+Volunteer
+Any person who is willing to serve society and abide by the rules and regulations of the NGO to do service.
+
+Donor
+Any person who agrees to donate a certain amount of money to the NGO is eligible to become a donor.
+```
+
+</details>
+
+<details><summary>Enacted text — as the Act prescribes it</summary>
+
+```
+(1) Board Member: Any person who is willing to serve society and abide by the rules
+       and regulations of the NGO to work in STM for lifetime.
+```
+
+</details>
+
+#### 🟢 art-6 clause (2) — ALREADY-APPLIED
+
+`substitute` · clause scope · source `act-1-2024` line 18
+
+Reads as the Act **100.0%** · Act's words present 100.0% · unchanged since v1 73.4%
+
+<details><summary>Current text — <code>constitution/current.yaml</code></summary>
+
+```
+The membership of the NGO shall be open to all the students of the college who are willing to
+serve the society and who are willing to abide by the rules and regulations of the NGO.
+
+Board Member
+Any person who is willing to serve society and abide by the rules and regulations of the NGO to work in STM for lifetime.
+
+Intermediate Board Member
+Any person who is willing to serve society and abide by the rules and regulations of the NGO to work in STM for lifetime under the board.
+
+Unit Board Member
+Any person who is willing to serve society and abide by the rules and regulations of the NGO to work in STM in their respective unit within their academic life.
+
+Coordinator
+Any person who is willing to serve society and abide by the rules and regulations of the NGO to work in the STM in their respective unit within their academic life.
+
+Volunteer
+Any person who is willing to serve society and abide by the rules and regulations of the NGO to do service.
+
+Donor
+Any person who agrees to donate a certain amount of money to the NGO is eligible to become a donor.
+```
+
+</details>
+
+<details><summary>Enacted text — as the Act prescribes it</summary>
+
+```
+(2) Intermediate Board Member: Any person who is willing to serve society and abide
+       by the rules and regulations of the NGO to work in STM for lifetime under the board.
+```
+
+</details>
+
+#### 🟢 art-6 clause (3) — ALREADY-APPLIED
+
+`substitute` · clause scope · source `act-1-2024` line 18
+
+Reads as the Act **100.0%** · Act's words present 100.0% · unchanged since v1 73.4%
+
+<details><summary>Current text — <code>constitution/current.yaml</code></summary>
+
+```
+The membership of the NGO shall be open to all the students of the college who are willing to
+serve the society and who are willing to abide by the rules and regulations of the NGO.
+
+Board Member
+Any person who is willing to serve society and abide by the rules and regulations of the NGO to work in STM for lifetime.
+
+Intermediate Board Member
+Any person who is willing to serve society and abide by the rules and regulations of the NGO to work in STM for lifetime under the board.
+
+Unit Board Member
+Any person who is willing to serve society and abide by the rules and regulations of the NGO to work in STM in their respective unit within their academic life.
+
+Coordinator
+Any person who is willing to serve society and abide by the rules and regulations of the NGO to work in the STM in their respective unit within their academic life.
+
+Volunteer
+Any person who is willing to serve society and abide by the rules and regulations of the NGO to do service.
+
+Donor
+Any person who agrees to donate a certain amount of money to the NGO is eligible to become a donor.
+```
+
+</details>
+
+<details><summary>Enacted text — as the Act prescribes it</summary>
+
+```
+(3) Unit Board Member: Any person who is willing to serve society and abide by the
+       rules and regulations of the NGO to work in STM in their respective unit within their
+       academic life.
+```
+
+</details>
+
+#### 🟢 art-6 clause (4) — ALREADY-APPLIED
+
+`substitute` · clause scope · source `act-1-2024` line 18
+
+Reads as the Act **100.0%** · Act's words present 100.0% · unchanged since v1 73.4%
+
+<details><summary>Current text — <code>constitution/current.yaml</code></summary>
+
+```
+The membership of the NGO shall be open to all the students of the college who are willing to
+serve the society and who are willing to abide by the rules and regulations of the NGO.
+
+Board Member
+Any person who is willing to serve society and abide by the rules and regulations of the NGO to work in STM for lifetime.
+
+Intermediate Board Member
+Any person who is willing to serve society and abide by the rules and regulations of the NGO to work in STM for lifetime under the board.
+
+Unit Board Member
+Any person who is willing to serve society and abide by the rules and regulations of the NGO to work in STM in their respective unit within their academic life.
+
+Coordinator
+Any person who is willing to serve society and abide by the rules and regulations of the NGO to work in the STM in their respective unit within their academic life.
+
+Volunteer
+Any person who is willing to serve society and abide by the rules and regulations of the NGO to do service.
+
+Donor
+Any person who agrees to donate a certain amount of money to the NGO is eligible to become a donor.
+```
+
+</details>
+
+<details><summary>Enacted text — as the Act prescribes it</summary>
+
+```
+(4) Coordinator: Any person who is willing to serve society and abide by the rules and
+       regulations of the NGO to work in the STM in their respective unit within their
+       academic life.
+```
+
+</details>
+
+#### 🟢 art-6 clause (5) — ALREADY-APPLIED
+
+`substitute` · clause scope · source `act-1-2024` line 18
+
+Reads as the Act **100.0%** · Act's words present 100.0% · unchanged since v1 73.4%
+
+<details><summary>Current text — <code>constitution/current.yaml</code></summary>
+
+```
+The membership of the NGO shall be open to all the students of the college who are willing to
+serve the society and who are willing to abide by the rules and regulations of the NGO.
+
+Board Member
+Any person who is willing to serve society and abide by the rules and regulations of the NGO to work in STM for lifetime.
+
+Intermediate Board Member
+Any person who is willing to serve society and abide by the rules and regulations of the NGO to work in STM for lifetime under the board.
+
+Unit Board Member
+Any person who is willing to serve society and abide by the rules and regulations of the NGO to work in STM in their respective unit within their academic life.
+
+Coordinator
+Any person who is willing to serve society and abide by the rules and regulations of the NGO to work in the STM in their respective unit within their academic life.
+
+Volunteer
+Any person who is willing to serve society and abide by the rules and regulations of the NGO to do service.
+
+Donor
+Any person who agrees to donate a certain amount of money to the NGO is eligible to become a donor.
+```
+
+</details>
+
+<details><summary>Enacted text — as the Act prescribes it</summary>
+
+```
+(5) Volunteer: Any person who is willing to serve society and abide by the rules and
+       regulations of the NGO to do service.
+```
+
+</details>
+
+#### 🟢 art-7 clause (4) — ALREADY-APPLIED
+
+`substitute` · clause scope · source `act-1-2024` line 35
+
+Reads as the Act **100.0%** · Act's words present 100.0% · unchanged since v1 76.2%
+
+<details><summary>Current text — <code>constitution/current.yaml</code></summary>
+
+```
+1. A person who has been recruited into the organization on follow of process as per Organization rules and regulations and is duly appointed by STM as such for any of the college units or works for the NGO in certain form shall be called as an STM ‘Member’..
+2. A person who has registered online in the STM website and admitted in the NGO through a confirmation email and according to its regulations continues to be a member of the NGO.
+3. An applicant can only be a member if appointed through the recruitment process by the competent authority as may be defined by society from time to time via the Board.
+4. Any person who donates at least INR 30 (Rupees Thirty Only) shall be called ''STM DONOR''.
+5. Eligibility of membership
+    * (a)The following shall be eligible for membership in the society:-
+      1. The applicant will strive to work for the achievement of the objectives of the society.
+      2. The applicant shall abide by the Rules and Regulations of the Society.
+      3. They shall maintain good moral conduct and behavior.
+6. Termination of membership
+    * (a)The membership of a member shall be terminated if he/she:
+        1. Resigns from the membership of the society.
+        2. Is found to be of unsound mind by a competent court.
+        3. Is convicted of any offence involving moral turpitude.
+        4. On the death of any member.
+        5. If they are expelled from the society \
+            (a) for misconduct \
+            (b) for insubordination \
+            (c) due to non-performance 
+        6. If a member is found inactive or nonperforming, the member would be termed as inactive member in writing. The member will be under a performance plan with a notice of 2 months from the date of declaration to improve their performance to a satisfactory level. Failure to do so will result in termination.
+    * (b)The Board member has authority to terminate or revoke the status of any member. The Intermediate board can terminate or revoke the membership of any member of units and the Unit Head can terminate or revoke the membership of a member within a unit with written approval from the Internal Compliance coordinator in writing for any reason stated in the suspension or termination article.
+```
+
+</details>
+
+<details><summary>Enacted text — as the Act prescribes it</summary>
+
+```
+(4) Any person who donates at least INR 30 (Rupees Thirty Only) shall be called
+       ''STM DONOR''.
+```
+
+</details>
+
+#### 🟢 art-7 clause (6) — ALREADY-APPLIED
+
+`substitute` · clause scope · source `act-1-2024` line 35
+
+Reads as the Act **100.0%** · Act's words present 100.0% · unchanged since v1 76.2%
+
+<details><summary>Current text — <code>constitution/current.yaml</code></summary>
+
+```
+1. A person who has been recruited into the organization on follow of process as per Organization rules and regulations and is duly appointed by STM as such for any of the college units or works for the NGO in certain form shall be called as an STM ‘Member’..
+2. A person who has registered online in the STM website and admitted in the NGO through a confirmation email and according to its regulations continues to be a member of the NGO.
+3. An applicant can only be a member if appointed through the recruitment process by the competent authority as may be defined by society from time to time via the Board.
+4. Any person who donates at least INR 30 (Rupees Thirty Only) shall be called ''STM DONOR''.
+5. Eligibility of membership
+    * (a)The following shall be eligible for membership in the society:-
+      1. The applicant will strive to work for the achievement of the objectives of the society.
+      2. The applicant shall abide by the Rules and Regulations of the Society.
+      3. They shall maintain good moral conduct and behavior.
+6. Termination of membership
+    * (a)The membership of a member shall be terminated if he/she:
+        1. Resigns from the membership of the society.
+        2. Is found to be of unsound mind by a competent court.
+        3. Is convicted of any offence involving moral turpitude.
+        4. On the death of any member.
+        5. If they are expelled from the society \
+            (a) for misconduct \
+            (b) for insubordination \
+            (c) due to non-performance 
+        6. If a member is found inactive or nonperforming, the member would be termed as inactive member in writing. The member will be under a performance plan with a notice of 2 months from the date of declaration to improve their performance to a satisfactory level. Failure to do so will result in termination.
+    * (b)The Board member has authority to terminate or revoke the status of any member. The Intermediate board can terminate or revoke the membership of any member of units and the Unit Head can terminate or revoke the membership of a member within a unit with written approval from the Internal Compliance coordinator in writing for any reason stated in the suspension or termination article.
+```
+
+</details>
+
+<details><summary>Enacted text — as the Act prescribes it</summary>
+
+```
+(6) (a) 6. If a member is found inactive or nonperforming, the member would be
+      termed as inactive member in writing. The member will be under a performance plan
+      with a notice of 2 months from the date of declaration to improve their performance to
+      a satisfactory level. Failure to do so will result in termination.
+          (b)The Board member has authority to terminate or revoke the status of any
+      member. The Intermediate board can terminate or revoke the membership of any
+      member of units and the Unit Head can terminate or revoke the membership of a
+      member within a unit with written approval from the Internal Compliance coordinator
+      in writing for any reason stated in the suspension or termination article.
+```
+
+</details>
+
+#### 🟢 art-9 — ALREADY-APPLIED
+
+`substitute` · article scope · source `act-1-2024` line 55
+
+Reads as the Act **100.0%** · Act's words present 100.0% · unchanged since v1 28.3%
+
+<details><summary>Current text — <code>constitution/current.yaml</code></summary>
+
+```
+1. The board members are responsible for proper functioning of the NGO by guiding IBM. <br>
+2. The board members are responsible for all activities of the NGO, but they are not held responsible for any activity undertaken by any member without informing the authorized person. <br>
+3. Any new establishments and any modifications shall be done with the final document approval of the board. <br>
+4. Board holds the ultimate powers over the STM and its final decisions <br>
+5. The board consists of the following members: <br>
+    1. President
+    2. Vice President
+    3. General Secretary
+    4. Treasurer
+    5. Joint Secretary
+    6. Executive Members
+6. All the board members should abide by the rules and regulations of the NGO and work according to the constitution of the NGO and by-laws of the NGO. <br>
+```
+
+</details>
+
+<details><summary>Enacted text — as the Act prescribes it</summary>
+
+```
+(1) The board members are responsible for proper functioning of the NGO by guiding
+      IBM.
+      (2) The board members are responsible for all activities of the NGO, but they are not
+      held responsible for any activity undertaken by any member without informing the
+      authorized person.
+      (3) Any new establishments and any modifications shall be done with the final
+      document approval of the board.
+      (4) Board holds the ultimate powers over the STM and its final decisions
+      (5) The board consists of the following members:
+                  1. President
+                  2. Vice President
+                  3. General Secretary
+                  4. Treasurer
+                  5. Joint Secretary
+                  6. Executive Members
+      (6) All the board members should abide by the rules and regulations of the NGO and
+      work according to the constitution of the NGO and by-laws of the NGO.
+```
+
+</details>
+
+#### 🟢 art-10 — ALREADY-APPLIED
+
+`substitute` · article scope · source `act-1-2024` line 76
+
+Reads as the Act **100.0%** · Act's words present 100.0% · unchanged since v1 32.7%
+
+<details><summary>Current text — <code>constitution/current.yaml</code></summary>
+
+```
+Eligibility
+Any person who has been selfless service to the NGO and abides by the rules and regulations of the NGO is eligible to become an IBM.
+
+Selection Process
+The selection process for the IBM is as follows:
+1. The person should fill out the application form for IBM.
+2. The person will engage in recruitment rounds conducted by the board.
+3. The person should be selected by the board.
+
+Roles and Responsibilities
+The Intermediate Board Members are responsible for proper functioning of STM units. IBM should abide by the rules and regulations of the NGO and work according to the constitution. \
+The IBM are as follows:
+  1. Human Resources Coordinator:
+  The Human Resources coordinator is  responsible for all activities of the recruitment process and internship programs of the NGO.    
+  2. Finance Coordinator:
+  The Finance coordinator is responsible for all financial
+  activities of the NGO and needs to submit the details time to time to the
+  Treasurer. The annual report of the NGO should be submitted to the board.
+  3. Designing Coordinator:
+  The Designing coordinator is responsible for all graphics designing activities of the NGO. They are responsible for maintaining high quality designs.
+  4. Public Relations Coordinator:
+  The Public Relations coordinator is
+  responsible for all public relations activities of the NGO.
+  5. Technical Coordinator:
+  The Technical coordinator is responsible for all
+  technical activities of the NGO and maintains the high quality of the
+  technical work. The coordinator needs to promote the open source
+  technologies of the NGO.
+  6. Internal Compliance Coordinator:
+  The Internal Compliance coordinator is
+  responsible to ensure that members are acting in accordance with the
+  constitution and guidelines of the NGO. They can take any action on any
+  member if they are not following the constitution and guidelines of the
+  NGO.
+  7. Operations Coordinator:
+  The Operations Coordinator is responsible for day
+  to day operations of the NGO.
+  8. Documentation Coordinator:
+  The Documentation Coordinator is responsible
+  for all documents of the NGO and to maintain all documents secured.
+```
+
+</details>
+
+<details><summary>Enacted text — as the Act prescribes it</summary>
+
+```
+(1) Eligibility
+           Any person who has been selfless service to the NGO and abides by the rules and
+           regulations of the NGO is eligible to become an IBM.
+      (2) Selection Process
+      The selection process for the IBM is as follows:
+
+           1. The person should fill out the application form for IBM.
+           2. The person will engage in recruitment rounds conducted by the board.
+           3. The person should be selected by the board.
+      (3) Roles and Responsibilities
+                 The Intermediate Board Members are responsible for proper functioning of
+      STM units. IBM should abide by the rules and regulations of the NGO and work
+      according to the constitution.
+      The IBM are as follows:
+           1. Human Resources Coordinator : The Human Resources coordinator is
+              responsible for all activities of the recruitment process and internship
+              programs of the NGO.
+           2. Finance Coordinator: The Finance coordinator is responsible for all financial
+              activities of the NGO and needs to submit the details time to time to the
+              Treasurer. The annual report of the NGO should be submitted to the board.
+           3. Designing Coordinator: The Designing coordinator is responsible for all
+              graphics designing activities of the NGO. They are responsible for
+              maintaining high quality designs.
+           4. Public Relations Coordinator: The Public Relations coordinator is
+              responsible for all public relations activities of the NGO.
+           5. Technical Coordinator: The Technical coordinator is responsible for all
+              technical activities of the NGO and maintains the high quality of the
+              technical work.. The coordinator needs to promote the open source
+              technologies of the NGO.
+           6. Internal Compliance Coordinator: The Internal Compliance coordinator is
+              responsible to ensure that members are acting in accordance with the
+              constitution and guidelines of the NGO. They can take any action on any
+              member if they are not following the constitution and guidelines of the
+              NGO.
+           7. Operations Coordinator: The Operations Coordinator is responsible for day
+              to day operations of the NGO.
+           8. Documentation Coordinator: The Documentation Coordinator is responsible
+              for all documents of the NGO and to maintain all documents secured.
+```
+
+</details>
+
+#### 🟢 art-11 — ALREADY-APPLIED
+
+`substitute` · article scope · source `act-1-2024` line 121
+
+Reads as the Act **99.4%** · Act's words present 100.0% · unchanged since v1 26.8%
+
+<details><summary>Current text — <code>constitution/current.yaml</code></summary>
+
+```
+units
+- (a) The units of the NGO which are established in the colleges. Every unit consists a board with following members: 
+  1. Head 
+  2. Vice Head 
+  3. Operations Department Head 
+  4. Donations Department Head 
+  5. Technical Department Head 
+  6. Content and Report writing Department Head 
+  7. Research and Development Department Head 
+  8. Graphics Department Head 
+- (b) All the members of the Unit should abide by the rules and regulations of the NGO and work according to the constitution. \
+- (c) Coordinators are recruited every year through a selection process wherein the candidates are filtered through rounds and are recruited based on the criteria of the STM. \
+- (d) Unselected candidates can still contribute as volunteers for the STM. \
+
+Establishment
+To establish a unit in a college, the following conditions should be satisfied:
+- (a) There should be at least 10 people in the college who are willing to work for the NGO.
+- (b) The head of the unit must consult the IBM-Human Resources Coordinator
+- (c) The head of the unit must fill the application form for the college unit.
+- (d) The head of the unit must attend the interview conducted by the IBM-Human Resources Coordinator
+```
+
+</details>
+
+<details><summary>Enacted text — as the Act prescribes it</summary>
+
+```
+(1) (a) The units of the NGO which are established in the colleges. Every unit
+           consists a board with following members:
+                              1. Head
+
+                               2. Vice Head
+                               3. Operations Department Head
+                               4. Donations Department Head
+                               5. Technical Department Head
+                               6. Content and Report writing Department Head
+                               7. Research and Development Department Head
+                               8. Graphics Department Head
+       (b) All the members of the Unit should abide by the rules and regulations of the NGO
+       and work according to the constitution.
+       (c) Coordinators are recruited every year through a selection process wherein the
+       candidates are filtered through rounds and are recruited based on the criteria of the
+       STM.
+       (d) Unselected candidates can still contribute as volunteers for the STM.
+       (2) Establishment
+       To establish a unit in a college, the following conditions should be satisfied:
+          (a) There should be at least 10 people in the college who are willing to work for
+              the NGO.
+          (b) The head of the unit must consult the IBM-Human Resources Coordinator
+          (c) The head of the unit must fill the application form for the college unit.
+          (d) The head of the unit must attend the interview conducted by the IBM-Human
+       Resources Coordinator
+```
+
+</details>
+
+#### 🟢 art-12 — ALREADY-APPLIED
+
+`substitute` · article scope · source `act-1-2024` line 153
+
+Reads as the Act **100.0%** · Act's words present 100.0% · unchanged since v1 47.1%
+
+> Title: current `Alumini` → enacted `Alumni`
+
+<details><summary>Current text — <code>constitution/current.yaml</code></summary>
+
+```
+“Alumni” refers to the member who has previously worked with the NGO.
+```
+
+</details>
+
+<details><summary>Enacted text — as the Act prescribes it</summary>
+
+```
+(1) “Alumni” refers to the member who has previously worked with the NGO.
+```
+
+</details>
+
+#### 🟢 art-18 — ALREADY-APPLIED
+
+`insert` · article scope · source `act-1-2024` line 158
+
+Reads as the Act **100.0%** · Act's words present 100.0% · unchanged since v1 0.0%
+
+<details><summary>Current text — <code>constitution/current.yaml</code></summary>
+
+```
+1. The Internal Compliance coordinator holds the right to suspend or terminate any member if they violate the constitution or guidelines in any way.
+2. Any member defaming the NGO in any form will be terminated.
+3. Any member of the NGO using the funds for personal/mismanagement, fake bills
+and any finance related issues will be terminated and face legal prosecutions.
+4. Any member of the NGO doing fraudulent works, misbehaving with a member
+and making false allegations against any member will be terminated.
+5. Any member who does not respond to calls/messages/emails for 2 days will be
+warned. If the same instance repeats and fails to inform the reason, he will be
+suspended/terminated.
+6. Suspension or termination only happens after receiving a confirmation letter from
+the Internal Compliance Coordinator.
+```
+
+</details>
+
+<details><summary>Enacted text — as the Act prescribes it</summary>
+
+```
+(1) The Internal Compliance coordinator holds the right to suspend or terminate any
+       member if they violate the constitution or guidelines in any way.
+       (2) Any member defaming the NGO in any form will be terminated.
+       (3) Any member of the NGO using the funds for personal/mismanagement, fake bills
+       and any finance related issues will be terminated and face legal prosecutions.
+       (4) Any member of the NGO doing fraudulent works, misbehaving with a member
+       and making false allegations against any member will be terminated.
+
+   (5) Any member who does not respond to calls/messages/emails for 2 days will be
+   warned. If the same instance repeats and fails to inform the reason, he will be
+   suspended/terminated.
+   (6) Suspension or termination only happens after receiving a confirmation letter from
+   the Internal Compliance Coordinator.
+```
+
+</details>
+
+### Act 2 of 2024
+
+#### 🟢 preamble — ALREADY-APPLIED
+
+`substitute` · article scope · source `act-2-2024` line 17
+
+Reads as the Act **100.0%** · Act's words present 100.0% · unchanged since v1 30.0%
+
+<details><summary>Current text — <code>constitution/current.yaml</code></summary>
+
+```
+SERVICE TO MANKIND is a non-governmental organization registered under the
+       Telangana Society Registration Act, 2001, representing a student-run organization for
+       individuals motivated to fulfill their obligation towards societal betterment and
+       cultivate socially responsible individuals.
+```
+
+</details>
+
+<details><summary>Enacted text — as the Act prescribes it</summary>
+
+```
+SERVICE TO MANKIND is a non-governmental organization registered under the
+       Telangana Society Registration Act, 2001, representing a student-run organization for
+       individuals motivated to fulfill their obligation towards societal betterment and
+       cultivate socially responsible individuals.
+```
+
+</details>
+
+#### 🟢 art-3 — ALREADY-APPLIED
+
+`substitute` · article scope · source `act-2-2024` line 24
+
+Reads as the Act **100.0%** · Act's words present 100.0% · unchanged since v1 35.0%
+
+<details><summary>Current text — <code>constitution/current.yaml</code></summary>
+
+```
+To create a platform for students who have a motive to fulfill their obligation towards
+       societal betterment by helping the underprivileged in every possible way.
+```
+
+</details>
+
+<details><summary>Enacted text — as the Act prescribes it</summary>
+
+```
+To create a platform for students who have a motive to fulfill their obligation towards
+       societal betterment by helping the underprivileged in every possible way.
+```
+
+</details>
+
+#### 🟢 art-4 — ALREADY-APPLIED
+
+`substitute` · article scope · source `act-2-2024` line 30
+
+Reads as the Act **100.0%** · Act's words present 100.0% · unchanged since v1 11.1%
+
+<details><summary>Current text — <code>constitution/current.yaml</code></summary>
+
+```
+To nurture socially responsible personalities who enlighten the lives of the
+       underprivileged.
+```
+
+</details>
+
+<details><summary>Enacted text — as the Act prescribes it</summary>
+
+```
+To nurture socially responsible personalities who enlighten the lives of the
+       underprivileged.
+```
+
+</details>
+
+#### 🟢 art-5 — ALREADY-APPLIED
+
+`substitute` · article scope · source `act-2-2024` line 36
+
+Reads as the Act **100.0%** · Act's words present 100.0% · unchanged since v1 55.6%
+
+<details><summary>Current text — <code>constitution/current.yaml</code></summary>
+
+```
+To create a society where everyone has access to basic amenities and is treated
+       equally.
+```
+
+</details>
+
+<details><summary>Enacted text — as the Act prescribes it</summary>
+
+```
+To create a society where everyone has access to basic amenities and is treated
+       equally.
+```
+
+</details>
+
+#### 🟢 art-8 — ALREADY-APPLIED
+
+`substitute` · article scope · source `act-2-2024` line 47
+
+Reads as the Act **100.0%** · Act's words present 100.0% · unchanged since v1 84.4%
+
+<details><summary>Current text — <code>constitution/current.yaml</code></summary>
+
+```
+Internship is a program where the students of the college are given an opportunity to
+       work for the NGO and to learn the working of the NGO as a coordinator in the
+       respective unit.
+
+Stipend
+There is no stipend for the internship program. But the coordinators will be provided
+with the certificate of internship in their respective units.
+
+Duration
+The duration of the internship program is two years.
+
+Eligibility
+Any student who is willing to serve the society and abide by the rules and regulations of
+the NGO is eligible to become an coordinator, according to the article 7.
+
+Selection Process
+The selection process for the internship program is as follows:
+         1. The student should fill out the application form for the internship program.
+         2. The student will engage in recruitment rounds conducted by the unit board.
+         3. The student should be selected by the unit board.
+
+Roles and Responsibilities
+All the coordinators should abide by the rules and regulations of the NGO. The
+coordinator should work for the NGO in their respective departments for the betterment
+of the society.
+```
+
+</details>
+
+<details><summary>Enacted text — as the Act prescribes it</summary>
+
+```
+Internship is a program where the students of the college are given an opportunity to
+       work for the NGO and to learn the working of the NGO as a coordinator in the
+       respective unit.
+     1. Stipend
+    There is no stipend for the internship program. But the coordinators will be provided
+    with the certificate of internship in their respective units.
+     2. Duration
+    The duration of the internship program is two years.
+     3. Eligibility
+    Any student who is willing to serve the society and abide by the rules and regulations of
+    the NGO is eligible to become an coordinator, according to the article 7.
+
+    4. Selection Process
+    The selection process for the internship program is as follows:
+             1. The student should fill out the application form for the internship program.
+             2. The student will engage in recruitment rounds conducted by the unit board.
+             3. The student should be selected by the unit board.
+     5. Roles and Responsibilities
+    All the coordinators should abide by the rules and regulations of the NGO. The
+    coordinator should work for the NGO in their respective departments for the betterment
+    of the society.
+```
+
+</details>
+
+#### 🟢 art-16 clause (3) — ALREADY-APPLIED
+
+`substitute` · clause scope · source `act-2-2024` line 72
+
+Reads as the Act **100.0%** · Act's words present 100.0% · unchanged since v1 77.0%
+
+<details><summary>Current text — <code>constitution/current.yaml</code></summary>
+
+```
+1. Any changes to the constitution of the NGO should be done by the board of the NGO.
+2. The ammenments should be done according to the by-laws of the NGO.
+3. All proposed amendments must be approved by a 2/3rd present and voting of the board of the NGO, the intermediate board of the NGO and units of the NGO collectively.
+```
+
+</details>
+
+<details><summary>Enacted text — as the Act prescribes it</summary>
+
+```
+(3)All proposed amendments must be approved by a 2/3rd present and voting of the board of
+the NGO, the intermediate board of the NGO and units of the NGO collectively.
+```
+
+</details>
+
+#### 🟢 art-17 clause (1) — ALREADY-APPLIED
+
+`substitute` · clause scope · source `act-2-2024` line 83
+
+Reads as the Act **100.0%** · Act's words present 100.0% · unchanged since v1 70.5%
+
+<details><summary>Current text — <code>constitution/current.yaml</code></summary>
+
+```
+(a). In an event that the NGO fails to function totally and needs to be dissolved, the whole board of the NGO shall be dissolved. Else, the whole NGO shall be dissolved. The funds of the NGO will be transferred to the same objectives of the NGO.
+(b). College Units of the NGO can only be dissolved by the Board of the NGO
+```
+
+</details>
+
+<details><summary>Enacted text — as the Act prescribes it</summary>
+
+```
+(1)In an event that the NGO fails to function totally and needs to be dissolved, the whole
+board of the NGO shall be dissolved. Else, the whole NGO shall be dissolved. The funds of
+the NGO will be transferred to the same objectives of the NGO.
+```
+
+</details>
+
+#### 🟢 art-14 — ALREADY-APPLIED
+
+`substitute` · article scope · source `act-2-2024` line 90
+
+Reads as the Act **100.0%** · Act's words present 100.0% · unchanged since v1 12.7%
+
+<details><summary>Current text — <code>constitution/current.yaml</code></summary>
+
+```
+Sabbatical Leave
+1. Board and IBM members can apply for leave for 3 months to 1 year . The
+    request letter must be sent to the board 48 hours prior to the leave day.
+2. If the leaves are proven to be false or invalid, a warning letter will be issued.
+```
+
+</details>
+
+<details><summary>Enacted text — as the Act prescribes it</summary>
+
+```
+1. Sabbatical Leave
+         1. Board and IBM members can apply for leave for 3 months to 1 year . The
+             request letter must be sent to the board 48 hours prior to the leave day.
+         2. If the leaves are proven to be false or invalid, a warning letter will be issued.
+```
+
+</details>
+
+#### 🟢 art-20 — ALREADY-APPLIED
+
+`insert` · article scope · source `act-2-2024` line 97
+
+Reads as the Act **100.0%** · Act's words present 100.0% · unchanged since v1 0.0%
+
+<details><summary>Current text — <code>constitution/current.yaml</code></summary>
+
+```
+1.   The board and IBM should hold a meeting with the unit periodically.
+   2.   The unit board should meet every month.
+   3.   The unit board should meet the coordinators periodically.
+   4.   If any member did not attend the meeting, appropriate action shall be taken.
+```
+
+</details>
+
+<details><summary>Enacted text — as the Act prescribes it</summary>
+
+```
+1.   The board and IBM should hold a meeting with the unit periodically.
+   2.   The unit board should meet every month.
+   3.   The unit board should meet the coordinators periodically.
+   4.   If any member did not attend the meeting, appropriate action shall be taken.
+```
+
+</details>
+
+#### 🟢 art-15 — ALREADY-APPLIED
+
+`substitute` · article scope · source `act-2-2024` line 105
+
+Reads as the Act **100.0%** · Act's words present 100.0% · unchanged since v1 9.8%
+
+<details><summary>Current text — <code>constitution/current.yaml</code></summary>
+
+```
+Voluntary
+(a) Any Member can opt out of working for an Organization by submitting the
+resignation letter to the Unit Head.
+
+Involuntary
+(a) Member can be terminated based on article 7 and 18
+```
+
+</details>
+
+<details><summary>Enacted text — as the Act prescribes it</summary>
+
+```
+(1) Voluntary
+                (a) Any Member can opt out of working for an Organization by submitting the
+                resignation letter to the Unit Head.
+            (2) Involuntary
+                (a) Member can be terminated based on article 7 and 18
+```
+
+</details>
+
+### Act 3 of 2024 — *Finance Act, 2024*
+
+#### 🟢 art-13 — ALREADY-APPLIED
+
+`substitute` · article scope · source `act-3-2024` line 18
+
+Reads as the Act **100.0%** · Act's words present 100.0% · unchanged since v1 70.4%
+
+<details><summary>Current text — <code>constitution/current.yaml</code></summary>
+
+```
+1. All units must maintain task reports of all the events taken up during the financial
+        year and must submit the reports to the IBM-Finance Coordinator at least 2 weeks
+        prior to the Annual General Meeting.
+        2. An annual report of all the activities conducted throughout the NGO shall be
+        consolidated and maintained by the IBM-Finance Coordinator.
+        3. The Annual Report of the NGO must be compulsorily prepared by the
+        IBM-Finance Coordinator in the prescribed format mentioned in the Documentation
+        guidelines.
+        4. All the annual reports from the inception of the NGO must be maintained in the
+        STM operations portal and on the NGO official website.
+```
+
+</details>
+
+<details><summary>Enacted text — as the Act prescribes it</summary>
+
+```
+1. All units must maintain task reports of all the events taken up during the financial
+        year and must submit the reports to the IBM-Finance Coordinator at least 2 weeks
+        prior to the Annual General Meeting.
+        2. An annual report of all the activities conducted throughout the NGO shall be
+        consolidated and maintained by the IBM-Finance Coordinator.
+        3. The Annual Report of the NGO must be compulsorily prepared by the
+        IBM-Finance Coordinator in the prescribed format mentioned in the Documentation
+        guidelines.
+        4. All the annual reports from the inception of the NGO must be maintained in the
+        STM operations portal and on the NGO official website.
+```
+
+</details>
+
+#### 🟢 art-21 — ALREADY-APPLIED
+
+`insert` · article scope · source `act-3-2024` line 32
+
+Reads as the Act **100.0%** · Act's words present 100.0% · unchanged since v1 0.0%
+
+<details><summary>Current text — <code>constitution/current.yaml</code></summary>
+
+```
+1. The bank account of the NGO shall be maintained by the members of the board.
+     2. The NGO has the right to take money from the general public in the form of
+        donations.
+     3. The NGO is permitted to conduct events/ parties in order to generate funds.
+     4. The Treasurer and IBM-Finance coordinator has only the right to approve the funds
+        for the activities.
+
+ 5. Every month IBM-Finance coordinator has to verify the activity reports and balance
+    sheet and inform the Treasurer.
+ 6. Every Quarter of the year, the internal compliance coordinator will conduct an
+    audit. Unit Finance coordinator is responsible for sending all reports and balance
+    sheets to the Internal compliance coordinator for every three months.
+```
+
+</details>
+
+<details><summary>Enacted text — as the Act prescribes it</summary>
+
+```
+1. The bank account of the NGO shall be maintained by the members of the board.
+     2. The NGO has the right to take money from the general public in the form of
+        donations.
+     3. The NGO is permitted to conduct events/ parties in order to generate funds.
+     4. The Treasurer and IBM-Finance coordinator has only the right to approve the funds
+        for the activities.
+
+ 5. Every month IBM-Finance coordinator has to verify the activity reports and balance
+    sheet and inform the Treasurer.
+ 6. Every Quarter of the year, the internal compliance coordinator will conduct an
+    audit. Unit Finance coordinator is responsible for sending all reports and balance
+    sheets to the Internal compliance coordinator for every three months.
+```
+
+</details>
+
+## Sign-off
+
+Applying an amendment already in force would duplicate or revert a provision, so every
+🟡 NOT-APPLIED row must be confirmed before Phase 3 applies anything.
+
+- [ ] 🟢 `art-6(1)` — Act 1 of 2024 — ALREADY-APPLIED
+- [ ] 🟢 `art-6(2)` — Act 1 of 2024 — ALREADY-APPLIED
+- [ ] 🟢 `art-6(3)` — Act 1 of 2024 — ALREADY-APPLIED
+- [ ] 🟢 `art-6(4)` — Act 1 of 2024 — ALREADY-APPLIED
+- [ ] 🟢 `art-6(5)` — Act 1 of 2024 — ALREADY-APPLIED
+- [ ] 🟢 `art-7(4)` — Act 1 of 2024 — ALREADY-APPLIED
+- [ ] 🟢 `art-7(6)` — Act 1 of 2024 — ALREADY-APPLIED
+- [ ] 🟢 `art-9` — Act 1 of 2024 — ALREADY-APPLIED
+- [ ] 🟢 `art-10` — Act 1 of 2024 — ALREADY-APPLIED
+- [ ] 🟢 `art-11` — Act 1 of 2024 — ALREADY-APPLIED
+- [ ] 🟢 `art-12` — Act 1 of 2024 — ALREADY-APPLIED
+- [ ] 🟢 `art-18` — Act 1 of 2024 — ALREADY-APPLIED
+- [ ] 🟢 `preamble` — Act 2 of 2024 — ALREADY-APPLIED
+- [ ] 🟢 `art-3` — Act 2 of 2024 — ALREADY-APPLIED
+- [ ] 🟢 `art-4` — Act 2 of 2024 — ALREADY-APPLIED
+- [ ] 🟢 `art-5` — Act 2 of 2024 — ALREADY-APPLIED
+- [ ] 🟢 `art-8` — Act 2 of 2024 — ALREADY-APPLIED
+- [ ] 🟢 `art-16(3)` — Act 2 of 2024 — ALREADY-APPLIED
+- [ ] 🟢 `art-17(1)` — Act 2 of 2024 — ALREADY-APPLIED
+- [ ] 🟢 `art-14` — Act 2 of 2024 — ALREADY-APPLIED
+- [ ] 🟢 `art-20` — Act 2 of 2024 — ALREADY-APPLIED
+- [ ] 🟢 `art-15` — Act 2 of 2024 — ALREADY-APPLIED
+- [ ] 🟢 `art-13` — Act 3 of 2024 — ALREADY-APPLIED
+- [ ] 🟢 `art-21` — Act 3 of 2024 — ALREADY-APPLIED
diff --git a/README.md b/README.md
index 3fdc2b3..c7091a9 100644
--- a/README.md
+++ b/README.md
@@ -1,60 +1,151 @@
 # OpenCodeLaw
 
 <p align="center">
-  <a href="https://constitution.stmorg.in"><img src="assets/img/openlawcode_banner.png" width="700px" alt="OpenLawCode Banner"></a>
+  <img src="assets/img/openlawcode_banner.png" width="700" alt="OpenCodeLaw">
 </p>
 
-OpenCodeLaw is a project that allows you to dynamically generate a constitution page based on YAML specifications. It provides a user-friendly interface for displaying constitution articles and sections.
-
-## Getting Started
-
-To use OpenCodeLaw, follow these steps:
-
-1. Create an HTML file (e.g., `index.html`) and add the following content:
-
-```html
-<!DOCTYPE html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>OpenCodeLaw Ui</title>
-    <!-- Include theme's CSS -->
-    <link
-      rel="stylesheet"
-      href="https://cdn.jsdelivr.net/gh/ServiceToMankind/opencodelaw@2.0.0/css/style.css"
-    />
-  </head>
-  <body>
-    <!-- Replace 'YOUR_SPEC_URL' with your own YAML specification URL -->
-    <opencodelaw spec-url="YOUR_SPEC_URL"></opencodelaw>
-
-    <!-- Include required scripts -->
-    <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
-    <script src="https://cdnjs.cloudflare.com/ajax/libs/js-yaml/4.0.0/js-yaml.min.js"></script>
-    <script src="https://cdn.jsdelivr.net/gh/ServiceToMankind/opencodelaw@2.0.0/js/opencodelaw.js"></script>
-  </body>
-</html>
+Governance as version-controlled, machine-readable text. You write your constitution
+as YAML; OpenCodeLaw validates it and renders a static, searchable, citable website.
+
+It exists because a constitution is not a web page. It is amended by instruments,
+cited by number, and read years later — and the tooling around it has to respect that.
+
+**Live example:** the constitution of Service to Mankind Welfare Association,
+built from [`constitution/current.yaml`](constitution/current.yaml).
+
+---
+
+## What makes it different
+
+**Citations are permanent.** Every article and section carries an explicit `id` and
+`number`. Nothing is derived from position in a list, so reordering the YAML changes
+no anchor and no citation. There is a test that proves it.
+
+```yaml
+- id: art-21          # permanent, a public URL anchor
+  number: 21          # the number Acts cite — explicit, never an array index
+  title: Financial Management
 ```
 
-2. Replace 'YOUR_SPEC_URL' in the spec-url attribute with the URL of your YAML specification file.
+**Amendments are first-class.** Acts live in a register with their dates, signatures,
+the provisions each one touches, and the signed PDF. Provisions link back to the Act
+that amended them.
+
+**Unfinished reconciliation is visible, not hidden.** If enacted amendments have not
+yet been applied, the document says so in `reconciliation_state`, and every page
+renders a banner naming what is outstanding and why. A constitution that quietly
+lags its own amendments is the failure this project exists to prevent.
 
-3. Open the HTML file in a web browser to see the dynamically generated constitution page.
+**The validator fails the build, not the website.** A missing or empty provision, a
+duplicate id, an unexplained gap in numbering, an Act reference that does not
+resolve, or an archived version shadowing the current one — each stops CI. The
+predecessor to this tool published a blank Article 11 for two years because nothing
+checked.
 
-## Usage
+**The archive is frozen.** Superseded versions are immutable snapshots that reproduce
+what was actually published, defects included, each with a canonical link to the
+current text and a visible superseded banner.
 
-1. Update the spec-url attribute in the HTML file with the URL of your own YAML specification.
+**No JavaScript required.** Every provision is in the served HTML. Scripts add search,
+scroll-spy, theming and copy-links; none of them are needed to read the document.
 
-2. The generated page will display the constitution sections and articles based on the provided YAML data.
+---
 
-# OpenCodeLaw YAML Schema Explanation
+## Requirements
+
+Node **20 or 22**. CI runs both.
+
+> **Node 18 reached end of life in April 2025.** `engines` still allows `>=18.18.0`
+> only so the build stays verifiable on the maintainer's current machine. Move the
+> local floor to **Node 22 LTS**, and bump `sanitize-html` to `2.17.7` in the same
+> change — 2.17.6+ depends on an ESM-only `htmlparser2` that cannot load on Node 18.
+> The two fixes it carries (an SVG SMIL `javascript:` bypass, and raw `<` escaping
+> `<textarea>`) are unreachable here, because the sanitiser allowlist admits no SVG
+> and no animation elements.
+
+## Quickstart
+
+```bash
+git clone https://github.com/ServiceToMankind/OpenCodeLaw.git
+cd OpenCodeLaw
+npm ci
+
+npm run validate     # schema + citation integrity + act cross-references
+npm test             # 41 tests, including the built output
+npm run build        # renders dist/
+npm run linkcheck    # zero internal 404s, nothing escapes the base path
+```
 
-The OpenCodeLaw YAML schema defines the structure of the constitution for the organization. This schema provides a clear and organized way to outline various sections, articles, and amendments of the constitution. Here's a breakdown of each key in the [schema](https://github.com/ServiceToMankind/OpenCodeLaw/blob/main/schema/opencodelaw.md).
+Open `dist/index.html`, or serve it:
 
-## Contributing
+```bash
+npx --yes serve dist -l 8080
+```
+
+### Use it for your own organization
+
+Engine (`src/`, `schema/`) is separate from content (`constitution/`, `acts/`).
+
+1. Copy [`examples/starter/constitution.yaml`](examples/starter/constitution.yaml)
+   to `constitution/current.yaml` and replace the content.
+2. Put your amending instruments in `acts/pdf/` and describe them in
+   `acts/register.yaml`.
+3. `npx opencodelaw validate` until it passes.
+4. Set `BASE_PATH` and `SITE_ORIGIN`, then `npm run build`.
+
+```bash
+npx opencodelaw validate constitution/current.yaml
+npx opencodelaw build
+npx opencodelaw spec        # regenerate schema/SPEC.md
+```
+
+Schema reference: **[schema/SPEC.md](schema/SPEC.md)** — generated from
+[the JSON Schema](schema/opencodelaw-1.0.schema.json), so it cannot drift.
+
+## Deploying to GitHub Pages
+
+`.github/workflows/deploy.yml` runs `npm ci` → validate → build → link check →
+test, then publishes `dist/`. Validation failure blocks deployment.
+
+Enable Pages with **Source: GitHub Actions**, then set the base path:
+
+```yaml
+env:
+  BASE_PATH: /YourRepo/                        # project Pages
+  SITE_ORIGIN: https://yourorg.github.io
+```
 
-Contributions to the OpenCodeLaw project are welcome! Feel free to fork the repository, make changes, and submit pull requests.
+For an apex domain, set `BASE_PATH: /`, point `SITE_ORIGIN` at your domain, and run
+the workflow with `include_cname: true`. The CNAME is excluded by default and CI
+fails if it appears without being asked for, so a build cannot silently repoint a
+live domain.
+
+## Honest limitations
+
+- **Reconciliation is a human process.** The tools compare texts, classify provisions
+  and refuse to guess; deciding what an ambiguous instrument means is not automated
+  and should not be. See [RECONCILIATION.md](RECONCILIATION.md) for what that looks
+  like in practice.
+- **One document per site.** Bylaws, policies and multiple instruments in one build
+  are not modelled yet.
+- **Amendments are recorded, not applied.** Nothing mechanically rewrites provision
+  text from an Act; a person applies the change and the register records it.
+- **English only.** No localisation or right-to-left support.
+- **OG images need a rasteriser.** Falls back to the brand banner where none exists,
+  so the build never fails for it.
+- **Slugs come from titles.** Retitling an article changes its page URL. The `#art-N`
+  anchor is the stable citation and never moves.
+
+## Documentation
+
+| | |
+|---|---|
+| [schema/SPEC.md](schema/SPEC.md) | Generated schema reference |
+| [CONTRIBUTION.md](CONTRIBUTION.md) | How to work on this |
+| [AUDIT-CONFIRMED.md](AUDIT-CONFIRMED.md) | What was broken in the previous version, verified |
+| [RECONCILIATION.md](RECONCILIATION.md) | Open legal questions and how they were decided |
+| [PROVENANCE.md](PROVENANCE.md) | Every provision compared against the Acts |
 
 ## License
 
-This project is licensed under the MIT License - see the [LICENSE](https://github.com/ServiceToMankind/OpenCodeLaw/blob/main/LICENSE) file for details.
+MIT — see [LICENSE](LICENSE).
diff --git a/RECONCILIATION.md b/RECONCILIATION.md
new file mode 100644
index 0000000..379524c
--- /dev/null
+++ b/RECONCILIATION.md
@@ -0,0 +1,542 @@
+# Reconciliation
+
+**Status:** open. No constitutional text has been changed.
+**Answered:** Q3, Q5, Q6, Q8, Q9, Q11 (signed off), Q14 — recorded below and carried into Phase 3.
+**Answered 2026-08-15:** Q2, Q4, Q5, Q7, Q13 — see below. **Open:** Q1, Q8, Q9, Q10, Q12 (none blocking).
+**Branch:** `rebuild/v3` · **Raised:** 2026-08-14 · **Sign-off required from:** Pranay
+
+Phase 3's provision-by-provision table (Act, operation, target id, before, after, source line,
+sign-off box) is added **after** `PROVENANCE.md` is signed off. This file currently records only the
+questions that must be answered before any text is applied.
+
+Evidence cites `acts/text/*.txt`, the verbatim extraction committed in `ddbffb4`, by line number.
+Short names used below: **A1** = first-constitution-amendment-act-2024.txt, **A2** = second…,
+**A3** = third….
+
+
+## Citation stability — anchors that changed meaning
+
+Applying Act 2 restructured Articles 14 and 15. **Article-level ids are stable — `art-14` and
+`art-15` still point at the same articles.** But five section ids changed what they denote, which is
+the first time an anchor has moved rather than merely existed.
+
+| Anchor | v2.0.0 | 3.0.0 |
+|---|---|---|
+| `art-14-s-1` | Eligibility (under Sabbatical Leave) | **Sabbatical Leave** (under Leaves) |
+| `art-14-s-2` | Application | removed |
+| `art-14-s-3` | Duration | removed |
+| `art-15-s-1` | Eligibility (under Resignation) | **Voluntary** (under Exit Process) |
+| `art-15-s-2` | Application | **Involuntary** |
+| `art-15-s-3` | Duration | removed |
+
+This is correct: the Act restructured those articles, and a section id names a position within an
+article, not an immutable provision. It is recorded because a citation to `art-15-s-1` made before
+2026-08-15 meant *Eligibility* and now means *Voluntary*.
+
+`constitution/versions/v2.0.0.yaml` preserves the old structure, and `/archive/2.0.0/` still
+resolves every one of the old anchors — so a stale citation can still be read as it stood.
+
+---
+
+## Standing conventions
+
+Rules that bind every entry in this file and every entry in `acts/register.yaml`.
+
+### C1 — A Statement of Objects and Reasons is evidence of intent, never a source of authority
+
+An SOR is explanatory, not enacting. It may be cited to corroborate what an operative provision
+does; it may never be the authority for an operation. The two uses cannot be mixed: if an SOR could
+authorise a deletion in Article 10, it could set a voting threshold in Article 16, and the Q3 ruling
+that the operative text governs would collapse.
+
+Enforced, not merely stated. `src/validate.mjs` fails the build (`sor-as-authority`) if any
+`provisions[].source_lines` cites a line at or after an Act's `STATEMENT OF OBJECTS AND REASONS`.
+Where an SOR contradicts the operative text, record it under `drafting_discrepancy`, which is the
+only field permitted to point there.
+
+---
+
+## Blocking — legal
+
+These change what the constitution says. **Do not resolve without sign-off.**
+
+### Q1 — Article 19 does not exist
+
+Verified independently as instructed. A whitespace-normalised search over all three Acts finds every
+article from 3 to 18, then 20 and 21. **No occurrence of "19" in any form, in any Act.**
+
+| Cited | 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 · **—** · 20 21 |
+|---|---|
+
+Article 18 is inserted by A1:158, Article 20 by A2:97, Article 21 by A3:32. Nothing inserts 19.
+
+Either a fourth instrument exists outside this repo, or Act 2 skipped a number. Article 19 has been
+left **unallocated**, not invented and not closed by renumbering.
+
+**Question:** does a fourth instrument exist? If not, confirm Article 19 is recorded as
+`status: reserved` with a note stating no instrument ever occupied it.
+
+### Q2 — Article 6, clause 6 (`Donor`)
+
+> **RESOLVED by literal application — and it was never a decision to make.** Board approval speaks to
+> validity, not to what the instrument does. Act 1 substitutes clauses (1)–(5) by name. **A
+> substitution of named clauses does not reach an unnamed one**, so clause (6) `Donor` stands.
+> Dropping it would be repair by inference, which this project has refused at every step.
+>
+> **The tension is real and is recorded, not resolved.** `Donor` remains listed under `STM Roles`
+> while Act 1's amended Article 7(4) provides that a Donor Member is not an official Member and does
+> not work for the organisation. Carried as a standing item for a future Act, and noted on
+> `art-6-s-6`.
+
+Escalated from deferred. The provenance analysis found Article 6 is **100% its pre-Act text** — all
+five clauses Act 1 substitutes are unapplied. So this is no longer a question about a provision that
+was already settled by someone else; it gates a change about to be made.
+
+Article 6 must not be applied partially, and clause (6) cannot be guessed. Options for the board,
+stated neutrally:
+
+- **(a) Clause (6) survives.** A substitution of named clauses does not touch unnamed ones. Article 6
+  ends with six clauses. This is the stricter reading and the safer default: it changes nothing the
+  Act did not expressly change.
+- **(b) Clause (6) falls.** Act 1 moves the donor concept wholesale into Article 7 cl. (4) as
+  `STM DONOR`, so retaining a `Donor` *role* in Article 6 duplicates it.
+
+The tension is real either way. Under (a), `Donor` remains classified as an STM **role** while
+Article 7 states a Donor Member is not an official Member and does not work for the organisation.
+Only the board can resolve that.
+
+**Sequencing consequence:** Act 1 is applied to Articles 9, 10, 11, 12 and 18. Articles 6 and 7 are
+held. If this answer is slow, Acts 2 and 3 proceed and Act 1 stays partially applied — recorded
+explicitly in `provenance` on both held articles, naming them. The half-applied state this project
+exists to fix is not to be recreated silently.
+
+A1:18 reads *"Amendment to Article 6, clause 1,2,3,4 and 5"* and supplies replacement text for
+clauses (1)–(5) only. Clause 6 (`Donor`) is never mentioned. Separately, A1:38-39 amends Article 7
+clause 4 to define *"STM DONOR"*.
+
+Substituting 1–5 is not the same as omitting 6. The current spec still carries `Donor` as
+`art-6-s-6`.
+
+**Question:** does `Donor` survive in Article 6, or did Act 1 intend it to move wholly into
+Article 7? Nothing in the Act settles this.
+
+### Q3 — Act 2 contradicts itself on the amendment threshold
+
+> **ANSWERED — 2/3rd governs. A Statement of Objects and Reasons is not enacted text and aids construction only where the operative provision is ambiguous; here it is not ambiguous, merely inconsistent with the note. The discrepancy is recorded on Act 2 as `drafting_discrepancy` with both figures and both source lines, never normalised away. Q3 stays listed for board ratification: the legal answer is settled, the political one is the board's, and this provision governs how every future amendment passes.**
+
+This is the most serious ambiguity found.
+
+| Source | Line | Text |
+|---|---|---|
+| Operative provision | A2:75-76 | "All proposed amendments must be approved by a **2/3rd** present and voting of the board of the NGO, the intermediate board of the NGO and units of the NGO collectively." |
+| Statement of Objects and Reasons | A2:121-123 | "Article 16, Clause (3) has been amended with a **3/4th** majority present and voting for bills to be enforced in time…" |
+
+The Act sets two different thresholds for amending the constitution. Conventional construction
+prefers the operative provision over the Statement of Objects and Reasons, which is explanatory and
+not enacting — but this governs how every future amendment passes, and I will not decide it.
+
+**Question:** is the enacted threshold 2/3rd or 3/4th?
+
+### Q4 — Act 2 disagrees with itself on whether Article 15 is amended or inserted
+
+> **RESOLVED by convention C1.** The operative item reads `Amendment of Article 15 - Exit Process`.
+> The word "inserted" appears **only** under `STATEMENT OF OBJECTS AND REASONS`, which C1 forbids as
+> a source of authority and which `sor-as-authority` already enforces in the validator. So this
+> needed no new decision: it is an **amendment**, renaming Article 15 from `Resignation` to
+> `Exit Process` and restructuring it into (1) Voluntary and (2) Involuntary.
+
+A2:105 reads *"Amendment of Article 15 - Exit Process"*. The Statement of Objects at A2:131-132
+reads *"Article 15 has been **inserted** to incorporate processes for both voluntary and involuntary
+exit."*
+
+Article 15 already exists in the spec as `Resignation`. The operation is therefore a substitution
+that also retitles the article — but the Act's own summary calls it an insertion.
+
+**Question:** confirm this is `substitute` on `art-15` with a retitle to `Exit Process`, and that
+the existing `Resignation` sections (Eligibility, Application, Duration) are replaced rather than
+retained alongside the new (1) Voluntary / (2) Involuntary structure.
+
+### Q5 — Act 1 defines `Unit Board Member` and `Coordinator` with identical words
+
+> **CONFIRMED 2026-08-15 — publish both as enacted, note the defect, flag for a future Act.**
+>
+> **ANSWERED — Publish the defect; do not repair it. The engine records the law, it does not correct the law. Act 1 applies verbatim, both definitions stand as enacted, and an `editorial_note` on `art-6-s-3` and `art-6-s-4` points at the defect and at this entry. The note renders visibly. Escalated to the board as a candidate for a corrigendum or a Fourth Amendment Act.**
+
+Not previously flagged. A1:26-31, verbatim:
+
+> (3) **Unit Board Member**: Any person who is willing to serve society and abide by the rules and
+> regulations of the NGO to work in STM **in their respective unit within their academic life**.
+> (4) **Coordinator**: Any person who is willing to serve society and abide by the rules and
+> regulations of the NGO to work in the STM **in their respective unit within their academic life**.
+
+The two roles receive the same operative definition, differing only by "in STM" / "in the STM". The
+spec they replace distinguishes them clearly — its Coordinator is defined by recruitment ("after the
+successfull interview"), not by tenure.
+
+This reads as a drafting error in the Act itself, not an extraction artefact: the layout-preserving
+extraction matches the PDF. Applying it verbatim would leave two roles legally indistinguishable.
+
+**Question:** apply verbatim as enacted, or treat as an error requiring a corrigendum?
+
+### Q6 — Does an "Amendment to Article N" replace the whole article or only its listed clauses?
+
+> **ANSWERED — Read what the Act sets out, not what it calls itself. Where the Act restates the article's own heading and then a complete clause run, it substitutes the whole article; where the heading names clauses and only those are set out, it amends only those. This is the drafter's own convention, matching standard Indian amending practice. Encoded as `scope: article | clause` on each register entry, with `clauses` required whenever scope is `clause`. Applied mechanically, it yields: clause scope for arts. 6, 7, 16, 17; article scope for arts. 3, 4, 5, 8, 9, 10, 11, 12, 13, 14, 15 and the preamble.**
+
+A1:55 (*"Amendment to Article 9"*) and A1:76 (*"Amendment to Article 10"*) give no clause
+restriction, unlike A1:18 and A1:35 which name clauses explicitly. Both then set out a complete
+replacement article.
+
+For Article 10 the Act supplies only (1) Eligibility, (2) Selection Process, (3) Roles and
+Responsibilities. The current spec additionally carries an article-level introduction ("The IBM are
+the members who are selected by the board…"). A full substitution deletes that introduction; a
+clause-wise amendment keeps it.
+
+**Question:** confirm that an unqualified "Amendment to Article N" is a **full substitution** of the
+article, including deletion of any text the Act does not restate. This convention decides several
+provisions at once, so it is worth settling explicitly.
+
+### Q7 — Terminology drift
+
+| Act says | Spec says | Evidence |
+|---|---|---|
+| `Unit Board Member` | `College Unit Board Member` | A1:26 |
+| `Units` (Art. 11) | `Units` — already renamed from v1's `College Units` | A1:123 |
+| `Alumni` (Art. 12) | `Alumini` | A1:155 |
+| `Annual Report` (Art. 13) | `Anual Reports` | A3:20 |
+| `Amendments` (Art. 16) | `Ammendments` | A2:74 |
+| `Leaves` (Art. 14) | `Sabbatical Leave` | A2:90 |
+
+Confirmed as the Acts' operative words, not extraction artefacts — the layout-preserving extraction
+reproduces the PDF text exactly.
+
+> **RESOLVED — the Acts make every one of these corrections themselves. No editorial rename is
+> made.** Act 1 titles Article 12 `Alumni`; Act 3 titles Article 13 `Annual Report`; Act 2 titles
+> Article 16 `Amendments`. Holding them was right: correcting them by hand in Phase 3 would have
+> been an editorial edit duplicating one the instruments already make.
+>
+> Two further renames come from the same source and are **structural, not spelling**: Act 2 renames
+> Article 14 `Sabbatical Leave` → `Leaves` (with Sabbatical Leave becoming clause (1)), and Article
+> 15 `Resignation` → `Exit Process`.
+
+**Original question:** the `Alumini`/`Anual Reports`/`Ammendments` corrections are already authorised as
+spelling fixes. Confirm `College Unit Board Member` → `Unit Board Member` and `Sabbatical Leave` →
+`Leaves` are **substantive retitles enacted by the Acts**, not spelling fixes.
+
+---
+
+## Blocking — record integrity
+
+### Q8 — The amendment table names a different author than the Act
+
+> **ANSWERED — The table is unverified; split the field. `signed_by: P. Priya, Internal Compliance Coordinator` and `assented_by: Internal Compliance Committee` are both evidenced on the face of all three Acts. `moved_by` is left unset. `M. Revanth Reddy` is preserved as `unverified_attribution` — not deleted, not promoted. Confirmed independently: the string `Revanth` appears nowhere in any of the three instruments.**
+
+The register dropped from the spec during migration recorded:
+
+```yaml
+- title: First Constitution Amendment Act, 2024
+  date: 2024-05-02T21:25:00+05:30
+  author: M. Revanth Reddy
+```
+
+Every one of the three PDFs is signed **"P. Priya, Internal Compliance Coordinator of the STM"**
+(A1:205-206, A2:137-138, A3:61-62), and each records assent from the Internal Compliance Committee.
+
+**Question:** who is recorded as `author` for Act 1 — the drafter (M. Revanth Reddy) or the
+signatory (P. Priya)? The schema has both `author` and `assented_by`; confirm which name goes where.
+
+### Q9 — The amendment table dates Act 1 a day before its assent
+
+> **ANSWERED — Model both; they are not in conflict. `assent_date: 2024-05-03` is evidenced on all three Acts. The table's 2024-05-02 is most likely the date of passage, a distinct event, and is recorded as `passed_date` marked unverified. One field cannot hold two events.**
+
+The dropped register dates the First Act `2024-05-02T21:25:00+05:30`. All three PDFs state assent on
+**3rd May 2024** (A1:5-6, A2:5-6, A3:5-6).
+
+**Question:** confirm `assent_date: 2024-05-03` for all three Acts, and that 2024-05-02 was a
+drafting or commit timestamp rather than a legal date.
+
+### Q10 — "Establishing the Constitution" has no instrument
+
+The dropped register's first entry has `act: null` (the `act: #` YAML bug) and
+`author: Pranay Kiran`, dated 2023-10-08.
+
+**Question:** should the register record the original adoption as a non-Act event, or only list
+enacting instruments? Recording it preserves the v1 adoption date, which exists nowhere else.
+
+---
+
+## Blocking — editorial (changes what a reader sees)
+
+### Q11 — Article 11 `Units` has no article body
+
+> **SIGNED OFF — section-only is correct.**
+>
+> The earlier answer assumed Act 1 supplies article-level text for Article 11 that someone
+> misfiled into a subsection. It does not. Act 1 runs `11. Units` straight into `(1)(a)`, exactly
+> as it does for Article 10, and supplies no article-level body at all. Its clause (1) is a 100.0%
+> match to `art-11-s-1` and its clause (2) a 100.0% match to `art-11-s-2` once the section title is
+> included in the comparison — together the whole of the enacted text.
+>
+> **The resolution comes from Act 1's operative structure, not from an editorial preference.**
+> Removing the empty `content` key makes Article 11 the shape the instrument enacts: an article
+> consisting of two clauses. No provision text was added, removed or altered.
+> `versions/v2.0.0.yaml` keeps its empty body, as published.
+>
+> One consequence is recorded separately: Act 1 gives clause (1) no title. The lowercase `units`
+> above it is an editorial heading, now marked as such in the rendered text and listed on the
+> amendments page for ratification. See the note on `title_source` below.
+
+`art-11.content` is an empty string. This is the defect that published a blank provision for two
+years, and the new validator now rejects it as a hard error — the build cannot ship until this is
+answered.
+
+What each source holds:
+
+| Source | Article-level body | Sections |
+|---|---|---|
+| v1.0.0 (`College Units`) | Full text: "The college units are the units of the NGO… 1. Head … 8. Graphics Department Head" | Establishment, **Funds**, **Roles and Responsibilities** |
+| v2.0.0 / current (`Units`) | **empty** | `units`, Establishment |
+| Act 1 (A1:121-151) | `11. Units` then (1)(a)–(d), (2) Establishment | — |
+
+Note that v2 also silently dropped v1's `Funds` and `Roles and Responsibilities` sections. Their
+absence is consistent with Act 1, which does not restate them, but no record of the deletion exists.
+
+Options — **choose one, I have not picked:**
+
+- **(a)** Apply Act 1's Article 11 text at article level, keeping `(1)` and `(2)` as the two
+  sections. Follows the Act's own structure. Consequence: the current `units` section becomes the
+  article body and the section list changes shape.
+- **(b)** Promote the existing `units` section text to the article body and drop that section.
+  Minimal change, no new text, but not the Act's structure.
+- **(c)** Leave the body empty and record it explicitly. Requires a schema addition, since
+  `reserved` and `omitted` both carry legal meanings that do not fit "text was never recorded".
+  Archived pages would render the "[No text was recorded for this provision]" marker.
+
+Option (c) is the only one that keeps the archived v2.0.0 faithful to what was actually published.
+Options (a) and (b) are about what `current.yaml` should say going forward. **These may need
+different answers for the archive and for the live document.**
+
+### Q12 — `renumber` has no defined effect on citation identity
+
+Design question, not a legal one, but it must be settled before the schema is used by anyone else.
+
+The validator enforces `id === "art-" + number`, which is what makes reordering the YAML provably
+safe. But the Act operation enum includes `renumber`. If an Act ever renumbers Article 20 to 19,
+either the id follows the number — breaking every citation ever made to `art-20` — or it stays fixed
+and the id/number coupling breaks.
+
+No Act among the three performs a renumber (all are `substitute` or `insert`), so nothing is blocked
+today.
+
+**Question:** on renumber, does the id stay permanent (and the coupling rule gain an exception) or
+follow the number? A statute book would keep the citation and record the move.
+
+---
+
+## Non-blocking — metadata applied in Phase 2
+
+Applied during the structural migration. Flagged for confirmation; none touches provision text.
+
+| Field | Value | Source | Confirm |
+|---|---|---|---|
+| `info.organization` | Service to Mankind Welfare Association | All three Acts: *"Further to amend the Constitution of Service to Mankind Welfare Association"* | ☐ |
+| `info.jurisdiction` | Telangana, India | Inferred from the preamble's "Telangana Societies Registration Act., 2001" and the registered address | ☐ |
+| `info.registration` | **omitted** | Unknown. Registration number under the 2001 Act appears nowhere in the repo | ☐ |
+| `info.effective_from` (v1.0.0) | 2023-10-08 | Preamble `adopted` date | ☐ |
+| `info.effective_from` (v2.0.0, current) | 2024-05-02 | Latest dated entry in v2's own amendment table. **See Q9** — likely should be 2024-05-03 | ☐ |
+| `info.version` (v1.0.0) | 1.0.0 | Corrected from the file's own incorrect `2.0.0` | ☐ |
+| `info.termsOfService` | **removed** | Was `https://example.com/terms` | ☐ |
+| `info.contact.url` | **removed** | Was `https://example.com/contact` | ☐ |
+
+The two removed placeholder URLs can be restored with real values at any time; the validator rejects
+any `example.com` URL in `info`.
+
+---
+
+### Q13 — Procedural validity of all three Acts
+
+> **RESOLVED by authorisation, 2026-08-15.** Pranay (project owner, contact of record) states:
+> *the amendments were authored long ago and approved by every member of the board.*
+>
+> Recorded as stated, not as an inference. Article 16(3) as it stood required approval by the board,
+> the **intermediate board** and **all college units**. Pranay named the board. The register records
+> board approval with that statement as its evidence and leaves the other two bodies unpopulated,
+> with `complete: false`. **Confirmation of intermediate-board and unit approval is outstanding.**
+>
+> The circularity noted below stands and is unaffected: Act 2 amends Article 16(3) itself, so it
+> passed under the unamended procedure.
+
+Article 16(3) as it stood on 3 May 2024 required proposed amendments to be approved by the board,
+the intermediate board, and all college units. All three Acts record assent from the **Internal
+Compliance Committee** and a signature from the Internal Compliance Coordinator. None records on its
+face that the Article 16 procedure was followed.
+
+That may simply be because the instrument records only the final attesting step, with the approvals
+living in minutes. Note the circularity: **Act 2 amends Article 16(3) itself**, so it had to pass
+under the unamended procedure.
+
+Nothing here asserts the Acts are invalid; that is not a question this project can answer. The act
+register schema now carries a `procedure` block — `required_by`, an explicit list of approving
+bodies, `attested_by`, `assent_date` — which Phase 3 populates with the bodies named and the
+approvals left empty. An explicit empty chain of authority is visible and gives the board somewhere
+to file the minutes; a missing field is neither.
+
+**Question:** were the Article 16(3) approvals obtained, and do minutes exist?
+
+### Q14 — Article 10 retains a paragraph no instrument enacts (DIVERGENT)
+
+**New, found by the provenance analysis. This is the only DIVERGENT verdict in the corpus.**
+
+Article 10 splits cleanly in two, and the halves disagree:
+
+| Part | Matches Act 1 | Matches pre-Act v1 text |
+|---|---|---|
+| The three sections (Eligibility, Selection Process, Roles and Responsibilities) | **100.0%** — 318 tokens against 318 | 36.7% |
+| The article body (the "The IBM are the members…" paragraph, 64 tokens) | 25.0% | 89.7% |
+
+So Act 1 was applied to Article 10's sections **exactly**, while the pre-Act article-level
+introduction was kept. Under Q6 a full substitution deletes it.
+
+The retained paragraph was also hand-edited to match Act 1's naming without any instrument doing so:
+
+```
+- 1. HR & Internshipment Controller Coordinator     + 1. Human Resources Coordinator
+- 2. Finance Controller Coordinator                 + 2. Finance Coordinator
+- 8. Content Coordinator                            + 8. Documentation Coordinator
+- 9. Volunteer Coordinator                          (removed)
+```
+
+All three edits are authorised by the **operative** text of Act 1 clause (3); see the decision below.
+Act 1's Statement of Objects, item 4, separately records that "the position of volunteer coordinator
+has been removed to optimise operational efficiency", which corroborates intent but under C1 confers
+no authority.
+
+> **DECIDED — delete the retained paragraph from the operative text.** Applied 2026-08-15.
+
+The three renames are **not** authorised by the Statement of Objects, and the earlier draft of this
+entry was wrong to say so (see C1). They do not need it — the operative text of Act 1 clause (3)
+carries all three:
+
+| Edit in the retained paragraph | Authority — all operative |
+|---|---|
+| `HR & Internshipment Controller` → `Human Resources Coordinator` | Act 1 cl. (3) item 1 |
+| `Content Coordinator` → `Documentation Coordinator` | Act 1 cl. (3) item 8 |
+| `Volunteer Coordinator` removed | Act 1 cl. (3) roster runs 1–8 and omits it |
+
+The SOR corroborates intent. It supplies no authority.
+
+**Grounds for deletion:**
+
+1. **Act 1 supplies no article-level body.** Its substitution runs `10. Intermediate Board Members`
+   straight into `(1) Eligibility`. A full substitution that supplies no body leaves the body empty;
+   the old one does not survive by default.
+2. **The roster is a duplicate.** All eight coordinators appear in `art-10-s-3`, in the same order
+   under the same names. Verified programmatically before deletion — the change halts if any role
+   fails to survive.
+3. **The unique part is unique because Act 1 replaced it.** The lead-in makes the IBM responsible for
+   "all legal and financial activities of the NGO"; clause (3) reframes that to "proper functioning
+   of STM units". Confirmed absent from `art-10-s-3`.
+4. **Retaining it creates a live contradiction, not a redundancy.** Article 21, inserted by Act 3,
+   gives the Treasurer and IBM-Finance Coordinator the sole right to approve funds. A surviving
+   blanket claim over "all legal and financial activities" would answer "who controls the money"
+   differently from Article 21 — and only Article 21 has an instrument behind it.
+5. **The renames are evidence, not justification.** Someone was applying Act 1 clause by clause and
+   missed that the same Act had already removed the paragraph they were conforming. Partial
+   application, not deliberate retention.
+
+**Nothing is destroyed.** Deletion is from the operative text only:
+
+- `versions/v2.0.0.yaml` keeps the paragraph verbatim — it is what was published.
+- `provenance` on `art-10` records the text, the unrecorded hand-edits, and the reason for removal.
+- Both forms are quoted below.
+
+<details><summary>Pre-Act form — <code>versions/v1.0.0.yaml</code> art-10 body</summary>
+
+```
+The IBM are the members who are selected by the board of the NGO to manage the NGO and to take care of the NGO.
+They are responsible for the all legal and financial activities of the NGO.
+The IBM consists of the following members:
+  1. HR & Internshipment Controller Coordinator
+  2. Finance Controller Coordinator
+  3. Designing Coordinator
+  4. Public Relations Coordinator
+  5. Technical Coordinator
+  6. Internal Compliance Coordinator
+  7. Operations Coordinator
+  8. Content Coordinator
+  9. Volunteer Coordinator
+```
+
+</details>
+
+<details><summary>Hand-edited form as published in v2.0.0 — the text removed</summary>
+
+```
+The IBM are the members who are selected by the board of the NGO to manage the NGO and to take care of the NGO.
+They are responsible for the all legal and financial activities of the NGO.
+The IBM consists of the following members:
+  1. Human Resources Coordinator
+  2. Finance Coordinator
+  3. Designing Coordinator
+  4. Public Relations Coordinator
+  5. Technical Coordinator
+  6. Internal Compliance Coordinator
+  7. Operations Coordinator
+  8. Documentation Coordinator
+```
+
+</details>
+
+**Board action:** ratification item, presented as a recommendation with reasons rather than an open
+question.
+
+
+---
+
+## Heading provenance — `title_source`
+
+Every heading in the live document now declares whether it carries legal force:
+
+- **`enacted`** — the heading appears, as a heading, in an instrument **already applied** to that
+  provision. 8 of 40.
+- **`editorial`** — supplied by an editor. 32 of 40.
+
+Two deliberate narrowings, both of which change the answer:
+
+1. **A heading is never credited to an unapplied Act.** Act 2 retitles Article 14 to `Leaves`, but
+   Act 2 has not been applied, so `Sabbatical Leave` remains editorial. Crediting it would claim
+   legal force for a heading that is not in effect.
+2. **The heading must appear as a heading, not anywhere in the prose.** A substring test marks
+   Article 11's `units` as enacted, because Act 1's clause (1) opens "The units of the NGO…", and
+   marks Article 15's `Resignation` as enacted off the phrase "the resignation letter". Both are
+   false.
+
+Nothing was renamed. `units`, `Alumini`, `Anual Reports` and `Ammendments` all stand exactly as
+they are, now visibly marked as editorial and listed on the amendments page.
+
+**Note on `Ammendments`:** Act 2's operative text spells Article 16 as **`Amendments`**. That typo
+therefore corrects itself when Act 2 is applied, by the instrument rather than by an editor. It
+should not be fixed by hand in the meantime.
+
+---
+
+## Sign-off
+
+No text may be applied until every **blocking** question above is answered.
+
+- [x] Q3 Amendment threshold — **2/3rd governs**, discrepancy recorded, board ratification still wanted
+- [x] Q5 Unit Board Member / Coordinator identical definitions — **publish the defect**
+- [x] Q6 Full-substitution convention — **read the body, not the heading**
+- [x] Q8 Act author vs signatory — **split the field**, Revanth preserved as unverified
+- [x] Q9 Assent date — **2024-05-03 assent, 2024-05-02 recorded as passed_date**
+- [x] Q11 Article 11 empty body — **signed off: section-only, per Act 1's operative structure**
+
+Open:
+
+- [ ] Q1 Article 19 gap — does a fourth instrument exist?
+- [x] Q2 Article 6 clause 6 (Donor) — **clause (6) stands**; tension recorded for a future Act
+- [x] Q4 Article 15 amend vs insert — **amendment**, resolved by C1
+- [x] Q7 Retitles — **the Acts make all of them**; no editorial rename
+- [ ] Q10 Original adoption record
+- [ ] Q12 Renumber and citation identity
+- [x] Q13 Procedural validity — **board approval recorded as stated**; IBM and unit approval outstanding
+- [x] Q14 Article 10 unenacted paragraph — **deleted from operative text**, ratification item for the board
diff --git a/acts/First_Constitution_Amendment_Act_2024.pdf b/acts/pdf/first-constitution-amendment-act-2024.pdf
similarity index 100%
rename from acts/First_Constitution_Amendment_Act_2024.pdf
rename to acts/pdf/first-constitution-amendment-act-2024.pdf
diff --git a/acts/Second Constitution Amendment Act,2024.pdf b/acts/pdf/second-constitution-amendment-act-2024.pdf
similarity index 100%
rename from acts/Second Constitution Amendment Act,2024.pdf
rename to acts/pdf/second-constitution-amendment-act-2024.pdf
diff --git a/acts/Third Constitution Amendment Act,2024.pdf b/acts/pdf/third-constitution-amendment-act-2024.pdf
similarity index 100%
rename from acts/Third Constitution Amendment Act,2024.pdf
rename to acts/pdf/third-constitution-amendment-act-2024.pdf
diff --git a/acts/register.yaml b/acts/register.yaml
new file mode 100644
index 0000000..7ab749a
--- /dev/null
+++ b/acts/register.yaml
@@ -0,0 +1,135 @@
+acts:
+  - id: act-1-2024
+    number: 1
+    year: 2024
+    title: First Constitution Amendment Act, 2024
+    short_title: Membership Act, 2024
+    application_status: partially-applied
+    assent_date: "2024-05-03"
+    passed_date: "2024-05-02"
+    assented_by: Internal Compliance Committee
+    signed_by: P. Priya, Internal Compliance Coordinator
+    unverified_attribution: M. Revanth Reddy
+    pdf: acts/pdf/first-constitution-amendment-act-2024.pdf
+    source_text: acts/text/first-constitution-amendment-act-2024.txt
+    procedure:
+      required_by: art-16-s-3
+      approvals:
+        - body: board
+          approved: true
+          date: null
+          evidence: "Stated by Pranay (project owner, contact of record), 2026-08-15: the amendments were authored long ago and approved by every member of the board."
+        - body: intermediate-board
+          date: null
+          evidence: null
+        - body: units
+          date: null
+          evidence: null
+      attested_by: P. Priya, Internal Compliance Coordinator
+      assent_date: "2024-05-03"
+      complete: false
+      note: Article 16(3) as it stood required approval by the board, the intermediate board and all college units. Board approval is recorded as stated. Confirmation of intermediate-board and unit approval is outstanding; the chain is not complete and is not inferred.
+    amends:
+      - art-9
+      - art-10
+      - art-11
+      - art-12
+      - art-18
+    provisions:
+      - target: art-9
+        operation: substitute
+        scope: article
+        source_lines: 55-75
+        note: Act restates the title as "Board Members".
+      - target: art-10
+        operation: substitute
+        scope: article
+        source_lines: 76-120
+        note: Act restates the title as "Intermediate Board Members".
+      - target: art-11
+        operation: substitute
+        scope: article
+        source_lines: 121-152
+        note: Act restates the title as "Units".
+      - target: art-12
+        operation: substitute
+        scope: article
+        source_lines: 153-157
+        note: Act restates the title as "Alumni".
+      - target: art-18
+        operation: insert
+        scope: article
+        source_lines: 158-181
+        note: Act restates the title as "Suspension/Termination".
+  - id: act-2-2024
+    number: 2
+    year: 2024
+    title: Second Constitution Amendment Act, 2024
+    application_status: pending
+    assent_date: "2024-05-03"
+    passed_date: "2024-05-02"
+    assented_by: Internal Compliance Committee
+    signed_by: P. Priya, Internal Compliance Coordinator
+    unverified_attribution: M. Revanth Reddy
+    pdf: acts/pdf/second-constitution-amendment-act-2024.pdf
+    source_text: acts/text/second-constitution-amendment-act-2024.txt
+    procedure:
+      required_by: art-16-s-3
+      approvals:
+        - body: board
+          approved: true
+          date: null
+          evidence: "Stated by Pranay (project owner, contact of record), 2026-08-15: the amendments were authored long ago and approved by every member of the board."
+        - body: intermediate-board
+          date: null
+          evidence: null
+        - body: units
+          date: null
+          evidence: null
+      attested_by: P. Priya, Internal Compliance Coordinator
+      assent_date: "2024-05-03"
+      complete: false
+      note: Article 16(3) as it stood required approval by the board, the intermediate board and all college units. Board approval is recorded as stated. Confirmation of intermediate-board and unit approval is outstanding; the chain is not complete and is not inferred.
+    drafting_discrepancy:
+      - provision: art-16
+        operative: All proposed amendments must be approved by a 2/3rd present and voting of the board of the NGO, the intermediate board of the NGO and units of the NGO collectively.
+        operative_source_lines: 74-76
+        statement_of_objects: Article 16, Clause (3) has been amended with a 3/4th majority present and voting for bills to be enforced in time, and any changes shall be done in the presence of a meeting.
+        statement_source_lines: 119-121
+        note: The Act states two different thresholds for amending the constitution. The operative provision governs; a Statement of Objects and Reasons is explanatory, not enacting. Recorded rather than normalised away, and listed in RECONCILIATION.md Q3 for board ratification.
+      - provision: art-15
+        operative: Amendment of Article 15 - Exit Process
+        operative_source_lines: 105-105
+        statement_of_objects: Article 15 has been inserted to incorporate processes for both voluntary and involuntary exit.
+        statement_source_lines: 129-130
+        note: The operative heading calls this an amendment; the Statement of Objects calls it an insertion. Article 15 already exists as Resignation. Open as RECONCILIATION.md Q4.
+  - id: act-3-2024
+    number: 3
+    year: 2024
+    title: Third Constitution Amendment Act, 2024
+    short_title: Finance Act, 2024
+    application_status: pending
+    assent_date: "2024-05-03"
+    passed_date: "2024-05-02"
+    assented_by: Internal Compliance Committee
+    signed_by: P. Priya, Internal Compliance Coordinator
+    unverified_attribution: M. Revanth Reddy
+    pdf: acts/pdf/third-constitution-amendment-act-2024.pdf
+    source_text: acts/text/third-constitution-amendment-act-2024.txt
+    procedure:
+      required_by: art-16-s-3
+      approvals:
+        - body: board
+          approved: true
+          date: null
+          evidence: "Stated by Pranay (project owner, contact of record), 2026-08-15: the amendments were authored long ago and approved by every member of the board."
+        - body: intermediate-board
+          date: null
+          evidence: null
+        - body: units
+          date: null
+          evidence: null
+      attested_by: P. Priya, Internal Compliance Coordinator
+      assent_date: "2024-05-03"
+      complete: false
+      note: Article 16(3) as it stood required approval by the board, the intermediate board and all college units. Board approval is recorded as stated. Confirmation of intermediate-board and unit approval is outstanding; the chain is not complete and is not inferred.
diff --git a/acts/text/first-constitution-amendment-act-2024.txt b/acts/text/first-constitution-amendment-act-2024.txt
new file mode 100644
index 0000000..42d562d
--- /dev/null
+++ b/acts/text/first-constitution-amendment-act-2024.txt
@@ -0,0 +1,213 @@
+                                                                      Act No. : 1 of 2024
+
+           INTERNAL COMPLIANCE COMMITTEE
+
+The following Act received the assent from the Internal Compliance Committee on 3rd May,
+2024.
+
+
+
+                 First Constitution Amendment Act, 2024
+
+           Further to amend the Constitution of Service to Mankind Welfare Association
+
+       BE IT ENACTED by the boards in the Second Year of the Service to Mankind Welfare
+Association as follows:
+
+   1. This Act also called the “Membership Act, 2024”
+   2. Amendment to Article 6, clause 1,2,3,4 and 5:
+
+
+       6. STM Roles
+       (1) Board Member: Any person who is willing to serve society and abide by the rules
+       and regulations of the NGO to work in STM for lifetime.
+       (2) Intermediate Board Member: Any person who is willing to serve society and abide
+       by the rules and regulations of the NGO to work in STM for lifetime under the board.
+       (3) Unit Board Member: Any person who is willing to serve society and abide by the
+       rules and regulations of the NGO to work in STM in their respective unit within their
+       academic life.
+       (4) Coordinator: Any person who is willing to serve society and abide by the rules and
+       regulations of the NGO to work in the STM in their respective unit within their
+       academic life.
+       (5) Volunteer: Any person who is willing to serve society and abide by the rules and
+       regulations of the NGO to do service.
+
+   3. Amendment to Article 7, clause 4 and 6:
+
+       7. Membership
+       (4) Any person who donates at least INR 30 (Rupees Thirty Only) shall be called
+       ''STM DONOR''.
+
+
+
+      Flat no:- 25/24, Bowrampet, Quthbullapur (M), Medchal (D), Telangana State -500043
+                                   Website:- www.stmorg.in
+      (6) (a) 6. If a member is found inactive or nonperforming, the member would be
+      termed as inactive member in writing. The member will be under a performance plan
+      with a notice of 2 months from the date of declaration to improve their performance to
+      a satisfactory level. Failure to do so will result in termination.
+          (b)The Board member has authority to terminate or revoke the status of any
+      member. The Intermediate board can terminate or revoke the membership of any
+      member of units and the Unit Head can terminate or revoke the membership of a
+      member within a unit with written approval from the Internal Compliance coordinator
+      in writing for any reason stated in the suspension or termination article.
+
+   4. Amendment to Article 9:
+
+      9. Board Members
+      (1) The board members are responsible for proper functioning of the NGO by guiding
+      IBM.
+      (2) The board members are responsible for all activities of the NGO, but they are not
+      held responsible for any activity undertaken by any member without informing the
+      authorized person.
+      (3) Any new establishments and any modifications shall be done with the final
+      document approval of the board.
+      (4) Board holds the ultimate powers over the STM and its final decisions
+      (5) The board consists of the following members:
+                  1. President
+                  2. Vice President
+                  3. General Secretary
+                  4. Treasurer
+                  5. Joint Secretary
+                  6. Executive Members
+      (6) All the board members should abide by the rules and regulations of the NGO and
+      work according to the constitution of the NGO and by-laws of the NGO.
+
+5. Amendment to Article 10:
+
+      10. Intermediate Board Members
+      (1) Eligibility
+           Any person who has been selfless service to the NGO and abides by the rules and
+           regulations of the NGO is eligible to become an IBM.
+      (2) Selection Process
+      The selection process for the IBM is as follows:
+
+
+      Flat no:- 25/24, Bowrampet, Quthbullapur (M), Medchal (D), Telangana State -500043
+                                   Website:- www.stmorg.in
+           1. The person should fill out the application form for IBM.
+           2. The person will engage in recruitment rounds conducted by the board.
+           3. The person should be selected by the board.
+      (3) Roles and Responsibilities
+                 The Intermediate Board Members are responsible for proper functioning of
+      STM units. IBM should abide by the rules and regulations of the NGO and work
+      according to the constitution.
+      The IBM are as follows:
+           1. Human Resources Coordinator : The Human Resources coordinator is
+              responsible for all activities of the recruitment process and internship
+              programs of the NGO.
+           2. Finance Coordinator: The Finance coordinator is responsible for all financial
+              activities of the NGO and needs to submit the details time to time to the
+              Treasurer. The annual report of the NGO should be submitted to the board.
+           3. Designing Coordinator: The Designing coordinator is responsible for all
+              graphics designing activities of the NGO. They are responsible for
+              maintaining high quality designs.
+           4. Public Relations Coordinator: The Public Relations coordinator is
+              responsible for all public relations activities of the NGO.
+           5. Technical Coordinator: The Technical coordinator is responsible for all
+              technical activities of the NGO and maintains the high quality of the
+              technical work.. The coordinator needs to promote the open source
+              technologies of the NGO.
+           6. Internal Compliance Coordinator: The Internal Compliance coordinator is
+              responsible to ensure that members are acting in accordance with the
+              constitution and guidelines of the NGO. They can take any action on any
+              member if they are not following the constitution and guidelines of the
+              NGO.
+           7. Operations Coordinator: The Operations Coordinator is responsible for day
+              to day operations of the NGO.
+           8. Documentation Coordinator: The Documentation Coordinator is responsible
+              for all documents of the NGO and to maintain all documents secured.
+
+6. Amendment to Article 11:
+
+      11. Units
+             (1) (a) The units of the NGO which are established in the colleges. Every unit
+           consists a board with following members:
+                              1. Head
+
+
+      Flat no:- 25/24, Bowrampet, Quthbullapur (M), Medchal (D), Telangana State -500043
+                                   Website:- www.stmorg.in
+                               2. Vice Head
+                               3. Operations Department Head
+                               4. Donations Department Head
+                               5. Technical Department Head
+                               6. Content and Report writing Department Head
+                               7. Research and Development Department Head
+                               8. Graphics Department Head
+       (b) All the members of the Unit should abide by the rules and regulations of the NGO
+       and work according to the constitution.
+       (c) Coordinators are recruited every year through a selection process wherein the
+       candidates are filtered through rounds and are recruited based on the criteria of the
+       STM.
+       (d) Unselected candidates can still contribute as volunteers for the STM.
+       (2) Establishment
+       To establish a unit in a college, the following conditions should be satisfied:
+          (a) There should be at least 10 people in the college who are willing to work for
+              the NGO.
+          (b) The head of the unit must consult the IBM-Human Resources Coordinator
+          (c) The head of the unit must fill the application form for the college unit.
+          (d) The head of the unit must attend the interview conducted by the IBM-Human
+       Resources Coordinator
+
+7. Amendment to Article 12:
+
+       12. Alumni
+     (1) “Alumni” refers to the member who has previously worked with the NGO.
+
+8. Insertion of new Article 18 - Suspension/Termination:
+
+       18. Suspension/Termination
+       (1) The Internal Compliance coordinator holds the right to suspend or terminate any
+       member if they violate the constitution or guidelines in any way.
+       (2) Any member defaming the NGO in any form will be terminated.
+       (3) Any member of the NGO using the funds for personal/mismanagement, fake bills
+       and any finance related issues will be terminated and face legal prosecutions.
+       (4) Any member of the NGO doing fraudulent works, misbehaving with a member
+       and making false allegations against any member will be terminated.
+
+
+
+
+      Flat no:- 25/24, Bowrampet, Quthbullapur (M), Medchal (D), Telangana State -500043
+                                   Website:- www.stmorg.in
+   (5) Any member who does not respond to calls/messages/emails for 2 days will be
+   warned. If the same instance repeats and fails to inform the reason, he will be
+   suspended/terminated.
+   (6) Suspension or termination only happens after receiving a confirmation letter from
+   the Internal Compliance Coordinator.
+
+
+
+              STATEMENT OF OBJECTS AND REASONS
+
+1. Article 6, clause 1,2,3,4,& 5 are modified for better readability.
+2. Article 7, clause (4) revised the donor's term.
+   Clause (6), Sub-clause (a),Point 6 reduces the performance period where deemed
+   unnecessary.
+   Clause 6, Sub-clause (b) authorises the Internal Compliance Coordinator to review the
+   validity of termination orders, aiming to prevent any wrongful terminations.
+3. Article 9 has been amended to provide an explanation of the duties of the board.
+4. Article 10 has been amended to provide clarity on the duties of intermediate board
+   members and the position of volunteer coordinator has been removed to optimise
+   operational efficiency.
+5. Article 11 has been amended to provide clarity on the membership composition of the
+   unit and the Human Resources Coordinator will oversee the establishment of units as
+   part of the coordinator's duty.
+6. Article 12 has been modified for better readability.
+7. Article 18 has been inserted to specify the circumstances under which a member may
+   be removed from the organization.
+
+
+                                         —————
+
+
+                                                                             P. Priya,
+                                          Internal Compliance Coordinator of the STM
+
+
+
+
+   Flat no:- 25/24, Bowrampet, Quthbullapur (M), Medchal (D), Telangana State -500043
+                                Website:- www.stmorg.in
+
\ No newline at end of file
diff --git a/acts/text/second-constitution-amendment-act-2024.txt b/acts/text/second-constitution-amendment-act-2024.txt
new file mode 100644
index 0000000..4c1635f
--- /dev/null
+++ b/acts/text/second-constitution-amendment-act-2024.txt
@@ -0,0 +1,145 @@
+                                                                     Act No. : 2 of 2024
+
+              INTERNAL COMPLIANCE COMMITTEE
+
+The following Act received the assent from the Internal Compliance Committee on 3rd May,
+2024.
+
+
+
+                Second Constitution Amendment Act, 2024
+
+           Further to amend the Constitution of Service to Mankind Welfare Association
+
+       BE IT ENACTED by the boards in the Second Year of the Service to Mankind Welfare
+Association as follows:
+
+    1. Amendment of Preamble:
+       Preamble
+       SERVICE TO MANKIND is a non-governmental organization registered under the
+       Telangana Society Registration Act, 2001, representing a student-run organization for
+       individuals motivated to fulfill their obligation towards societal betterment and
+       cultivate socially responsible individuals.
+
+    2. Amendment to Article 3:
+
+       3. Aim and Objectives
+       To create a platform for students who have a motive to fulfill their obligation towards
+       societal betterment by helping the underprivileged in every possible way.
+
+    3. Amendment to Article 4:
+.
+       4. Mission statement
+       To nurture socially responsible personalities who enlighten the lives of the
+       underprivileged.
+
+    4. Amendment to Article 5:
+
+       5. Vision Statement
+
+
+
+       Flat no:- 25/24, Bowrampet, Quthbullapur (M), Medchal (D), Telangana State -500043
+                                    Website:- www.stmorg.in
+              To create a society where everyone has access to basic amenities and is treated
+       equally.
+
+   5. Amendment to Article 8:
+
+       8. Internship
+       Internship is a program where the students of the college are given an opportunity to
+       work for the NGO and to learn the working of the NGO as a coordinator in the
+       respective unit.
+     1. Stipend
+    There is no stipend for the internship program. But the coordinators will be provided
+    with the certificate of internship in their respective units.
+     2. Duration
+    The duration of the internship program is two years.
+     3. Eligibility
+    Any student who is willing to serve the society and abide by the rules and regulations of
+    the NGO is eligible to become an coordinator, according to the article 7.
+
+    4. Selection Process
+    The selection process for the internship program is as follows:
+             1. The student should fill out the application form for the internship program.
+             2. The student will engage in recruitment rounds conducted by the unit board.
+             3. The student should be selected by the unit board.
+     5. Roles and Responsibilities
+    All the coordinators should abide by the rules and regulations of the NGO. The
+    coordinator should work for the NGO in their respective departments for the betterment
+    of the society.
+
+6. Amendment to Article 16, clause 3:
+
+16. Amendments
+(3)All proposed amendments must be approved by a 2/3rd present and voting of the board of
+the NGO, the intermediate board of the NGO and units of the NGO collectively.
+
+
+
+
+      Flat no:- 25/24, Bowrampet, Quthbullapur (M), Medchal (D), Telangana State -500043
+                                   Website:- www.stmorg.in
+7. Amendment to Article 17, clause 1:
+
+17. Dissolution
+(1)In an event that the NGO fails to function totally and needs to be dissolved, the whole
+board of the NGO shall be dissolved. Else, the whole NGO shall be dissolved. The funds of
+the NGO will be transferred to the same objectives of the NGO.
+
+8. Amendment to Article 14 - Leaves:
+
+   1. Sabbatical Leave
+         1. Board and IBM members can apply for leave for 3 months to 1 year . The
+             request letter must be sent to the board 48 hours prior to the leave day.
+         2. If the leaves are proven to be false or invalid, a warning letter will be issued.
+
+9. Insertion of new Article 20 - Meetings and Activities:
+
+   1.   The board and IBM should hold a meeting with the unit periodically.
+   2.   The unit board should meet every month.
+   3.   The unit board should meet the coordinators periodically.
+   4.   If any member did not attend the meeting, appropriate action shall be taken.
+
+
+10. Amendment of Article 15 - Exit Process:
+
+            (1) Voluntary
+                (a) Any Member can opt out of working for an Organization by submitting the
+                resignation letter to the Unit Head.
+            (2) Involuntary
+                (a) Member can be terminated based on article 7 and 18
+
+
+               STATEMENT OF OBJECTS AND REASONS
+
+   1. Preamble is modified for better readability.
+   2. Article 3,4 and 5 is modified for better readability.
+   3. Article 8 has been amended to update the official nomenclature and reduce the
+      duration of the internship program to two years by considering students' academic
+      life.
+   4. Article 16, Clause (3) has been amended with a 3/4th majority present and voting for
+      bills to be enforced in time, and any changes shall be done in the presence of a
+      meeting.
+
+        Flat no:- 25/24, Bowrampet, Quthbullapur (M), Medchal (D), Telangana State -500043
+                                     Website:- www.stmorg.in
+5. Article 14 amended for prior approval with a defined acceptance period to reduce the
+   quick process of incomplete verification.
+6. Article 20 has been inserted to include member participation in meetings and
+   activities, for strong relations between members and engagement in activities.
+7. Article 15 has been inserted to incorporate processes for both voluntary and
+   involuntary exit.
+
+                                     —————
+
+
+                                                                              P. Priya,
+                                          Internal Compliance Coordinator of the STM
+
+
+
+
+   Flat no:- 25/24, Bowrampet, Quthbullapur (M), Medchal (D), Telangana State -500043
+                                Website:- www.stmorg.in
+
\ No newline at end of file
diff --git a/acts/text/third-constitution-amendment-act-2024.txt b/acts/text/third-constitution-amendment-act-2024.txt
new file mode 100644
index 0000000..45e0033
--- /dev/null
+++ b/acts/text/third-constitution-amendment-act-2024.txt
@@ -0,0 +1,69 @@
+                                                                      Act No. : 3 of 2024
+
+               INTERNAL COMPLIANCE COMMITTEE
+
+The following Act received the assent from the Internal Compliance Committee on 3rd May,
+2024.
+
+
+
+                  Third Constitution Amendment Act, 2024
+
+            Further to amend the Constitution of Service to Mankind Welfare Association
+
+            BE IT ENACTED by the boards in the Second Year of the Service to Mankind Welfare
+Association as follows:
+
+   1.   This Act also called the “Finance Act, 2024”
+   2. Amendment to Article 13:
+
+        13. Annual Report
+        1. All units must maintain task reports of all the events taken up during the financial
+        year and must submit the reports to the IBM-Finance Coordinator at least 2 weeks
+        prior to the Annual General Meeting.
+        2. An annual report of all the activities conducted throughout the NGO shall be
+        consolidated and maintained by the IBM-Finance Coordinator.
+        3. The Annual Report of the NGO must be compulsorily prepared by the
+        IBM-Finance Coordinator in the prescribed format mentioned in the Documentation
+        guidelines.
+        4. All the annual reports from the inception of the NGO must be maintained in the
+        STM operations portal and on the NGO official website.
+
+3 . Insertion of new Article 21 - Financial Management:
+
+     1. The bank account of the NGO shall be maintained by the members of the board.
+     2. The NGO has the right to take money from the general public in the form of
+        donations.
+     3. The NGO is permitted to conduct events/ parties in order to generate funds.
+     4. The Treasurer and IBM-Finance coordinator has only the right to approve the funds
+        for the activities.
+
+
+
+        Flat no:- 25/24, Bowrampet, Quthbullapur (M), Medchal (D), Telangana State -500043
+                                     Website:- www.stmorg.in
+ 5. Every month IBM-Finance coordinator has to verify the activity reports and balance
+    sheet and inform the Treasurer.
+ 6. Every Quarter of the year, the internal compliance coordinator will conduct an
+    audit. Unit Finance coordinator is responsible for sending all reports and balance
+    sheets to the Internal compliance coordinator for every three months.
+
+
+           STATEMENT OF OBJECTS AND REASONS
+
+1. Article 13 is modified for better readability.
+2. Article 21 has been inserted to specify the circulation of funds.
+
+
+                                     —————
+
+
+                                                                              P. Priya,
+                                          Internal Compliance Coordinator of the STM
+
+
+
+
+   Flat no:- 25/24, Bowrampet, Quthbullapur (M), Medchal (D), Telangana State -500043
+                                Website:- www.stmorg.in
+
\ No newline at end of file
diff --git a/archives/v1.html b/archives/v1.html
deleted file mode 100644
index 227371e..0000000
--- a/archives/v1.html
+++ /dev/null
@@ -1,17 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>STM Constitution V1</title>
-    <link rel="stylesheet" href="../css/style.css?v=1" />
-    <link rel="icon" href="../favicons/ms-icon-310x310.png" type="image/x-icon">
-  </head>
-  <body>
-    <opencodelaw spec-url="../specs/v1.yaml"></opencodelaw>
-    <!-- Include opencon.js -->
-    <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
-    <script src="https://cdnjs.cloudflare.com/ajax/libs/js-yaml/4.0.0/js-yaml.min.js"></script>
-    <script async src="../js/opencodelaw.js"></script>
-  </body>
-</html>
diff --git a/archives/v2.html b/archives/v2.html
deleted file mode 100644
index 4ae3005..0000000
--- a/archives/v2.html
+++ /dev/null
@@ -1,17 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>STM Constitution V1</title>
-    <link rel="stylesheet" href="../css/style.css?v=1" />
-    <link rel="icon" href="../favicons/ms-icon-310x310.png" type="image/x-icon">
-  </head>
-  <body>
-    <opencodelaw spec-url="../specs/v2.yaml"></opencodelaw>
-    <!-- Include opencon.js -->
-    <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
-    <script src="https://cdnjs.cloudflare.com/ajax/libs/js-yaml/4.0.0/js-yaml.min.js"></script>
-    <script async src="../js/opencodelaw.js"></script>
-  </body>
-</html>
diff --git a/constitution/current.yaml b/constitution/current.yaml
new file mode 100644
index 0000000..2f69862
--- /dev/null
+++ b/constitution/current.yaml
@@ -0,0 +1,460 @@
+opencodelaw: "1.0"
+info:
+  title: SERVICE TO MANKIND
+  organization: Service to Mankind Welfare Association
+  jurisdiction: Telangana, India
+  version: 3.0.0
+  status: current
+  legal_status: adopted
+  effective_from: "2024-05-03"
+  logo:
+    url: https://stmorg.in/accesories/service_to_man_kind-20200709-0001.jpg
+    alt: Logo
+  contact:
+    name: Pranay Kiran
+    email: pranay@stmorg.in
+  license: MIT
+preamble:
+  id: preamble
+  title: Preamble
+  content: |
+    SERVICE TO MANKIND is a non-governmental organization registered under the
+           Telangana Society Registration Act, 2001, representing a student-run organization for
+           individuals motivated to fulfill their obligation towards societal betterment and
+           cultivate socially responsible individuals.
+  adopted: "2023-10-08T20:20:00+05:30"
+  title_source: enacted
+  amended_by:
+    - act-2-2024
+articles:
+  - id: art-1
+    number: 1
+    title: Name of the Organization
+    title_source: editorial
+    content: |
+      The name of the organization shall be Service to Mankind (hereinafter referred to as
+      "the NGO").The acronym that might be used to refer to the NGO will be STM.
+      The Registered Office of the Society shall be STM India Headquarters, Ft No. 25/24, Bowrampet, 500043, Hyderabad, Telangana
+      will operate anywhere.
+  - id: art-2
+    number: 2
+    title: Interpretations/Definitions
+    title_source: editorial
+    content: |
+      In this Constitution, unless the context otherwise requires:
+      1. "Act" means the Telangana Societies Registration Act., 2001.
+      2. "Board" means the Board Members of the NGO.
+      3. "Constitution" means the Constitution of the NGO.
+      4. "Executive Committee" means the Executive Committee of the NGO.
+      5. "College Unit" means the College Unit of the NGO.
+      6. "Member" means a member of the NGO.
+      7. "NGO" means the Service to Mankind.
+      8. "Office" means the Registered Office of the NGO.
+      9. "President" means the President of the NGO.
+      10. "Secretary" means the Secretary of the NGO.
+      11. "Treasurer" means the Treasurer of the NGO.
+      12. "Trustee" means a Trustee of the NGO.
+      13. "Vice President" means the Vice President of the NGO.
+      14. "Year" means the financial year of the NGO.
+      15. "IBM" means the Intermediate Board Members of the NGO.
+      16. "STM" means the Service to Mankind.
+  - id: art-3
+    number: 3
+    title: Aim and Objectives
+    title_source: enacted
+    content: |
+      To create a platform for students who have a motive to fulfill their obligation towards
+             societal betterment by helping the underprivileged in every possible way.
+    amended_by:
+      - act-2-2024
+  - id: art-4
+    number: 4
+    title: Mission statement
+    title_source: enacted
+    content: |
+      To nurture socially responsible personalities who enlighten the lives of the
+             underprivileged.
+    amended_by:
+      - act-2-2024
+  - id: art-5
+    number: 5
+    title: Vision Statement
+    title_source: enacted
+    content: |
+      To create a society where everyone has access to basic amenities and is treated
+             equally.
+    amended_by:
+      - act-2-2024
+  - id: art-6
+    number: 6
+    title: STM Roles
+    title_source: editorial
+    content: |
+      The membership of the NGO shall be open to all the students of the college who are willing to
+      serve the society and who are willing to abide by the rules and regulations of the NGO.
+    sections:
+      - id: art-6-s-1
+        number: 1
+        title: Board Member
+        title_source: enacted
+        content: |
+          Any person who is willing to serve society and abide by the rules and regulations of the NGO to work in STM for lifetime.
+      - id: art-6-s-2
+        number: 2
+        title: Intermediate Board Member
+        title_source: enacted
+        content: |
+          Any person who is willing to serve society and abide by the rules and regulations of the NGO to work in STM for lifetime under the board.
+      - id: art-6-s-3
+        number: 3
+        title: Unit Board Member
+        title_source: enacted
+        content: |
+          Any person who is willing to serve society and abide by the rules and regulations of the NGO to work in STM in their respective unit within their academic life.
+      - id: art-6-s-4
+        number: 4
+        title: Coordinator
+        title_source: enacted
+        content: |
+          Any person who is willing to serve society and abide by the rules and regulations of the NGO to work in the STM in their respective unit within their academic life.
+      - id: art-6-s-5
+        number: 5
+        title: Volunteer
+        title_source: enacted
+        content: |
+          Any person who is willing to serve society and abide by the rules and regulations of the NGO to do service.
+      - id: art-6-s-6
+        number: 6
+        title: Donor
+        title_source: editorial
+        content: |
+          Any person who agrees to donate a certain amount of money to the NGO is eligible to become a donor.
+    amended_by:
+      - act-1-2024
+  - id: art-7
+    number: 7
+    title: Membership
+    title_source: editorial
+    content: |
+      1. A person who has been recruited into the organization on follow of process as per Organization rules and regulations and is duly appointed by STM as such for any of the college units or works for the NGO in certain form shall be called as an STM ‘Member’..
+      2. A person who has registered online in the STM website and admitted in the NGO through a confirmation email and according to its regulations continues to be a member of the NGO.
+      3. An applicant can only be a member if appointed through the recruitment process by the competent authority as may be defined by society from time to time via the Board.
+      4. Any person who donates at least INR 30 (Rupees Thirty Only) shall be called ''STM DONOR''.
+      5. Eligibility of membership
+          * (a)The following shall be eligible for membership in the society:-
+            1. The applicant will strive to work for the achievement of the objectives of the society.
+            2. The applicant shall abide by the Rules and Regulations of the Society.
+            3. They shall maintain good moral conduct and behavior.
+      6. Termination of membership
+          * (a)The membership of a member shall be terminated if he/she:
+              1. Resigns from the membership of the society.
+              2. Is found to be of unsound mind by a competent court.
+              3. Is convicted of any offence involving moral turpitude.
+              4. On the death of any member.
+              5. If they are expelled from the society \
+                  (a) for misconduct \
+                  (b) for insubordination \
+                  (c) due to non-performance 
+              6. If a member is found inactive or nonperforming, the member would be termed as inactive member in writing. The member will be under a performance plan with a notice of 2 months from the date of declaration to improve their performance to a satisfactory level. Failure to do so will result in termination.
+          * (b)The Board member has authority to terminate or revoke the status of any member. The Intermediate board can terminate or revoke the membership of any member of units and the Unit Head can terminate or revoke the membership of a member within a unit with written approval from the Internal Compliance coordinator in writing for any reason stated in the suspension or termination article.
+    amended_by:
+      - act-1-2024
+  - id: art-8
+    number: 8
+    title: Internship
+    title_source: enacted
+    content: |
+      Internship is a program where the students of the college are given an opportunity to
+             work for the NGO and to learn the working of the NGO as a coordinator in the
+             respective unit.
+    sections:
+      - id: art-8-s-1
+        number: 1
+        title: Stipend
+        title_source: enacted
+        content: |
+          There is no stipend for the internship program. But the coordinators will be provided
+          with the certificate of internship in their respective units.
+      - id: art-8-s-2
+        number: 2
+        title: Duration
+        title_source: enacted
+        content: |
+          The duration of the internship program is two years.
+      - id: art-8-s-3
+        number: 3
+        title: Eligibility
+        title_source: enacted
+        content: |
+          Any student who is willing to serve the society and abide by the rules and regulations of
+          the NGO is eligible to become an coordinator, according to the article 7.
+      - id: art-8-s-4
+        number: 4
+        title: Selection Process
+        title_source: enacted
+        content: |
+          The selection process for the internship program is as follows:
+                   1. The student should fill out the application form for the internship program.
+                   2. The student will engage in recruitment rounds conducted by the unit board.
+                   3. The student should be selected by the unit board.
+      - id: art-8-s-5
+        number: 5
+        title: Roles and Responsibilities
+        title_source: enacted
+        content: |
+          All the coordinators should abide by the rules and regulations of the NGO. The
+          coordinator should work for the NGO in their respective departments for the betterment
+          of the society.
+    amended_by:
+      - act-2-2024
+  - id: art-9
+    number: 9
+    title: Board Members
+    title_source: enacted
+    content: |
+      1. The board members are responsible for proper functioning of the NGO by guiding IBM. <br>
+      2. The board members are responsible for all activities of the NGO, but they are not held responsible for any activity undertaken by any member without informing the authorized person. <br>
+      3. Any new establishments and any modifications shall be done with the final document approval of the board. <br>
+      4. Board holds the ultimate powers over the STM and its final decisions <br>
+      5. The board consists of the following members: <br>
+          1. President
+          2. Vice President
+          3. General Secretary
+          4. Treasurer
+          5. Joint Secretary
+          6. Executive Members
+      6. All the board members should abide by the rules and regulations of the NGO and work according to the constitution of the NGO and by-laws of the NGO. <br>
+    amended_by:
+      - act-1-2024
+  - id: art-10
+    number: 10
+    title: Intermediate Board Members
+    title_source: enacted
+    sections:
+      - id: art-10-s-1
+        number: 1
+        title: Eligibility
+        title_source: enacted
+        content: |
+          Any person who has been selfless service to the NGO and abides by the rules and regulations of the NGO is eligible to become an IBM.
+      - id: art-10-s-2
+        number: 2
+        title: Selection Process
+        title_source: enacted
+        content: |
+          The selection process for the IBM is as follows:
+          1. The person should fill out the application form for IBM.
+          2. The person will engage in recruitment rounds conducted by the board.
+          3. The person should be selected by the board.
+      - id: art-10-s-3
+        number: 3
+        title: Roles and Responsibilities
+        title_source: enacted
+        content: |
+          The Intermediate Board Members are responsible for proper functioning of STM units. IBM should abide by the rules and regulations of the NGO and work according to the constitution. \
+          The IBM are as follows:
+            1. Human Resources Coordinator:
+            The Human Resources coordinator is  responsible for all activities of the recruitment process and internship programs of the NGO.    
+            2. Finance Coordinator:
+            The Finance coordinator is responsible for all financial
+            activities of the NGO and needs to submit the details time to time to the
+            Treasurer. The annual report of the NGO should be submitted to the board.
+            3. Designing Coordinator:
+            The Designing coordinator is responsible for all graphics designing activities of the NGO. They are responsible for maintaining high quality designs.
+            4. Public Relations Coordinator:
+            The Public Relations coordinator is
+            responsible for all public relations activities of the NGO.
+            5. Technical Coordinator:
+            The Technical coordinator is responsible for all
+            technical activities of the NGO and maintains the high quality of the
+            technical work. The coordinator needs to promote the open source
+            technologies of the NGO.
+            6. Internal Compliance Coordinator:
+            The Internal Compliance coordinator is
+            responsible to ensure that members are acting in accordance with the
+            constitution and guidelines of the NGO. They can take any action on any
+            member if they are not following the constitution and guidelines of the
+            NGO.
+            7. Operations Coordinator:
+            The Operations Coordinator is responsible for day
+            to day operations of the NGO.
+            8. Documentation Coordinator:
+            The Documentation Coordinator is responsible
+            for all documents of the NGO and to maintain all documents secured.
+    provenance:
+      applied_outside_process: true
+      recorded: "2026-08-15"
+      note: Published v2.0.0 carried an article-level paragraph here that no instrument enacts. Act 1 of 2024 substitutes Article 10 in full, running its heading straight into clause (1) and supplying no article-level body. The paragraph had also been hand-edited by an unrecorded actor to conform to Act 1 clause (3)'s roster — HR & Internshipment Controller to Human Resources Coordinator, Content Coordinator to Documentation Coordinator, and Volunteer Coordinator dropped — all three of which the operative text of clause (3) carries. Removed on reconciliation as superseded. Its eight roles are duplicated in art-10-s-3; its unique lead-in, making the IBM responsible for "all legal and financial activities", is superseded by clause (3) and would contradict Article 21 as inserted by Act 3 of 2024. Preserved verbatim in versions/v2.0.0.yaml and quoted in RECONCILIATION.md Q14.
+    amended_by:
+      - act-1-2024
+  - id: art-11
+    number: 11
+    title: Units
+    title_source: enacted
+    sections:
+      - id: art-11-s-1
+        number: 1
+        title: units
+        title_source: editorial
+        content: |
+          - (a) The units of the NGO which are established in the colleges. Every unit consists a board with following members: 
+            1. Head 
+            2. Vice Head 
+            3. Operations Department Head 
+            4. Donations Department Head 
+            5. Technical Department Head 
+            6. Content and Report writing Department Head 
+            7. Research and Development Department Head 
+            8. Graphics Department Head 
+          - (b) All the members of the Unit should abide by the rules and regulations of the NGO and work according to the constitution. \
+          - (c) Coordinators are recruited every year through a selection process wherein the candidates are filtered through rounds and are recruited based on the criteria of the STM. \
+          - (d) Unselected candidates can still contribute as volunteers for the STM. \
+      - id: art-11-s-2
+        number: 2
+        title: Establishment
+        title_source: enacted
+        content: |
+          To establish a unit in a college, the following conditions should be satisfied:
+          - (a) There should be at least 10 people in the college who are willing to work for the NGO.
+          - (b) The head of the unit must consult the IBM-Human Resources Coordinator
+          - (c) The head of the unit must fill the application form for the college unit.
+          - (d) The head of the unit must attend the interview conducted by the IBM-Human Resources Coordinator
+    provenance:
+      applied_outside_process: false
+      recorded: "2026-08-15"
+      note: Act 1 of 2024 substitutes Article 11 as the heading "11. Units" running straight into clause (1); it supplies no article-level body. Its clause (1) is carried verbatim by art-11-s-1 (100.0% match) and its clause (2) by art-11-s-2 (98.6%), together 99.4% of the enacted text. Published v2.0.0 recorded an empty string here, which rendered as a blank provision for two years; the key is absent rather than empty so the article is correctly a section-only article. No provision text was added, removed or altered. The empty body is preserved as published in versions/v2.0.0.yaml. See RECONCILIATION.md Q11.
+    amended_by:
+      - act-1-2024
+  - id: art-12
+    number: 12
+    title: Alumini
+    title_source: editorial
+    content: |
+      “Alumni” refers to the member who has previously worked with the NGO.
+    amended_by:
+      - act-1-2024
+  - id: art-13
+    number: 13
+    title: Annual Report
+    title_source: enacted
+    content: |
+      1. All units must maintain task reports of all the events taken up during the financial
+              year and must submit the reports to the IBM-Finance Coordinator at least 2 weeks
+              prior to the Annual General Meeting.
+              2. An annual report of all the activities conducted throughout the NGO shall be
+              consolidated and maintained by the IBM-Finance Coordinator.
+              3. The Annual Report of the NGO must be compulsorily prepared by the
+              IBM-Finance Coordinator in the prescribed format mentioned in the Documentation
+              guidelines.
+              4. All the annual reports from the inception of the NGO must be maintained in the
+              STM operations portal and on the NGO official website.
+    amended_by:
+      - act-3-2024
+  - id: art-14
+    number: 14
+    title: Leaves
+    title_source: enacted
+    sections:
+      - id: art-14-s-1
+        number: 1
+        title: Sabbatical Leave
+        title_source: enacted
+        content: |
+          1. Board and IBM members can apply for leave for 3 months to 1 year . The
+              request letter must be sent to the board 48 hours prior to the leave day.
+          2. If the leaves are proven to be false or invalid, a warning letter will be issued.
+    amended_by:
+      - act-2-2024
+  - id: art-15
+    number: 15
+    title: Exit Process
+    title_source: enacted
+    sections:
+      - id: art-15-s-1
+        number: 1
+        title: Voluntary
+        title_source: enacted
+        content: |
+          (a) Any Member can opt out of working for an Organization by submitting the
+          resignation letter to the Unit Head.
+      - id: art-15-s-2
+        number: 2
+        title: Involuntary
+        title_source: enacted
+        content: |
+          (a) Member can be terminated based on article 7 and 18
+    amended_by:
+      - act-2-2024
+  - id: art-16
+    number: 16
+    title: Amendments
+    title_source: enacted
+    content: |
+      1. Any changes to the constitution of the NGO should be done by the board of the NGO.
+      2. The ammenments should be done according to the by-laws of the NGO.
+      3. All proposed amendments must be approved by a 2/3rd present and voting of the board of the NGO, the intermediate board of the NGO and units of the NGO collectively.
+    amended_by:
+      - act-2-2024
+  - id: art-17
+    number: 17
+    title: Dissolution
+    title_source: editorial
+    content: |
+      (a). In an event that the NGO fails to function totally and needs to be dissolved, the whole board of the NGO shall be dissolved. Else, the whole NGO shall be dissolved. The funds of the NGO will be transferred to the same objectives of the NGO.
+      (b). College Units of the NGO can only be dissolved by the Board of the NGO
+    amended_by:
+      - act-2-2024
+  - id: art-18
+    number: 18
+    title: Suspension/Termination
+    title_source: enacted
+    content: |
+      1. The Internal Compliance coordinator holds the right to suspend or terminate any member if they violate the constitution or guidelines in any way.
+      2. Any member defaming the NGO in any form will be terminated.
+      3. Any member of the NGO using the funds for personal/mismanagement, fake bills
+      and any finance related issues will be terminated and face legal prosecutions.
+      4. Any member of the NGO doing fraudulent works, misbehaving with a member
+      and making false allegations against any member will be terminated.
+      5. Any member who does not respond to calls/messages/emails for 2 days will be
+      warned. If the same instance repeats and fails to inform the reason, he will be
+      suspended/terminated.
+      6. Suspension or termination only happens after receiving a confirmation letter from
+      the Internal Compliance Coordinator.
+    amended_by:
+      - act-1-2024
+  - id: art-19
+    number: 19
+    title: Reserved
+    title_source: editorial
+    status: reserved
+    note: No instrument has occupied this number. Acts 1, 2 and 3 of 2024 insert Articles 18, 20 and 21 and none mentions 19; a whitespace-normalised search over all three finds no occurrence of it in any form. Left unallocated rather than closed by renumbering, which would break every citation after it. See RECONCILIATION.md Q1.
+  - id: art-20
+    number: 20
+    title: Meetings and Activities
+    title_source: enacted
+    content: |
+      1.   The board and IBM should hold a meeting with the unit periodically.
+         2.   The unit board should meet every month.
+         3.   The unit board should meet the coordinators periodically.
+         4.   If any member did not attend the meeting, appropriate action shall be taken.
+    amended_by:
+      - act-2-2024
+  - id: art-21
+    number: 21
+    title: Financial Management
+    title_source: enacted
+    content: |
+      1. The bank account of the NGO shall be maintained by the members of the board.
+           2. The NGO has the right to take money from the general public in the form of
+              donations.
+           3. The NGO is permitted to conduct events/ parties in order to generate funds.
+           4. The Treasurer and IBM-Finance coordinator has only the right to approve the funds
+              for the activities.
+
+       5. Every month IBM-Finance coordinator has to verify the activity reports and balance
+          sheet and inform the Treasurer.
+       6. Every Quarter of the year, the internal compliance coordinator will conduct an
+          audit. Unit Finance coordinator is responsible for sending all reports and balance
+          sheets to the Internal compliance coordinator for every three months.
+    amended_by:
+      - act-3-2024
diff --git a/specs/opencon.yaml b/constitution/versions/v1.0.0.yaml
similarity index 85%
rename from specs/opencon.yaml
rename to constitution/versions/v1.0.0.yaml
index bf31553..04e1a2d 100644
--- a/specs/opencon.yaml
+++ b/constitution/versions/v1.0.0.yaml
@@ -1,30 +1,38 @@
-openconstitution: 1.0.0
+opencodelaw: "1.0"
 info:
   title: SERVICE TO MANKIND
-  termsOfService: https://example.com/terms
+  organization: Service to Mankind Welfare Association
+  jurisdiction: Telangana, India
+  version: 1.0.0
+  status: superseded
+  effective_from: "2023-10-08"
+  superseded_by: 2.0.0
   logo:
     url: https://stmorg.in/accesories/service_to_man_kind-20200709-0001.jpg
     alt: Logo
   contact:
     name: Pranay Kiran
-    url: https://example.com/contact
     email: pranay@stmorg.in
   license: MIT
-  version: 1.0.0
 preamble:
+  id: preamble
   title: PREAMBLE
   content: |
     Service to Mankind is a Non-Governmental Organization (NGO) registered under Telangana Societies Registration Act., 2001 that was started to create a platform for students who are
     intent on doing their bit towards the betterment of society. Service to Mankind is a platform for the students to serve the society and to inculcate a sense of social responsibility in them.
-  adopted: 2023-10-08T20:20:00+05:30
+  adopted: "2023-10-08T20:20:00+05:30"
 articles:
-  - title: Name of the Organization
+  - id: art-1
+    number: 1
+    title: Name of the Organization
     content: |
       The name of the organization shall be Service to Mankind (hereinafter referred to as
       "the NGO").The acronym that might be used to refer to the NGO will be STM.
       The Registered Office of the Society shall be STM India Headquarters, Ft No. 25/24, Bowrampet, 500043, Hyderabad, Telangana
       will operate anywhere.
-  - title: Interpretations/Definitions
+  - id: art-2
+    number: 2
+    title: Interpretations/Definitions
     content: |
       In this Constitution, unless the context otherwise requires:
       1. "Act" means the Telangana Societies Registration Act., 2001.
@@ -43,43 +51,65 @@ articles:
       14. "Year" means the financial year of the NGO.
       15. "IBM" means the Intermediate Board Members of the NGO.
       16. "STM" means the Service to Mankind.
-  - title: Aims and Objectives
+  - id: art-3
+    number: 3
+    title: Aims and Objectives
     content: |
       The NGO has been established to create a platform for the students who are intent on doing
       their bit towards the betterment of society with the objective of helping the underprivileged
       and the destitute in any and every way possible.
-  - title: Mission Statement
+  - id: art-4
+    number: 4
+    title: Mission Statement
     content: |
       The mission of the NGO is to provide a platform for the students to serve the society and
       to inculcate a sense of social responsibility in them.
-  - title: Vision Statement
+  - id: art-5
+    number: 5
+    title: Vision Statement
     content: |
       The vision of the NGO is to create a society where everyone has access to basic amenities
       and to create a society where everyone is treated equally.
-  - title: STM Roles
+  - id: art-6
+    number: 6
+    title: STM Roles
     content: |
       The membership of the NGO shall be open to all the students of the college who are willing to
       serve the society and who are willing to abide by the rules and regulations of the NGO.
     sections:
-      - title: Board Member
+      - id: art-6-s-1
+        number: 1
+        title: Board Member
         content: |
           Any person who is willing to serve the society and who is willing to abide by the rules and regulations of the NGO to serve the STM for the lifetime and manage every thing in the STM.
-      - title: Intermediate Board Member
+      - id: art-6-s-2
+        number: 2
+        title: Intermediate Board Member
         content: |
           Any person who is willing to serve the society and who is willing to abide by the rules and regulations of the NGO to serve the STM for the lifetime and manage every thing in the STM under the board.
-      - title: College Unit Board Member
+      - id: art-6-s-3
+        number: 3
+        title: College Unit Board Member
         content: |
           Any person who is willing to serve the society and who is willing to abide by the rules and regulations of the NGO to serve the STM in thier respective college unit within thier academic life.
-      - title: Coordinator
+      - id: art-6-s-4
+        number: 4
+        title: Coordinator
         content: |
           Any person who is willing to serve the society and who is willing to abide by the rules and regulations of the NGO to serve and work for the STM after the successfull interview.
-      - title: Volunteer
+      - id: art-6-s-5
+        number: 5
+        title: Volunteer
         content: |
           Any person who is willing to serve the society and who is willing to abide by the rules and regulations of the NGO to do service on thier will.
-      - title: Donor
+      - id: art-6-s-6
+        number: 6
+        title: Donor
         content: |
           Any person who agrees to donate a certain amount of money to the NGO is eligible to become a donor.
-  - title: Membership
+  - id: art-7
+    number: 7
+    title: Membership
     content: |
       1. A person who has been recruited into the organization on follow of process as per Organization rules and regulations and is duly appointed by STM as such for any of the college units or works for the NGO in certain form shall be called as an STM ‘Member’..
       2. A person who has registered online in the STM website and admitted in the NGO through a confirmation email and according to its regulations continues to be a member of the NGO.
@@ -108,29 +138,43 @@ articles:
           * (b)The authority to terminate or revoke the status of a member shall be vested with the Board for all members. 
           Intermediate board can terminate or revoke the membership of a member for college units. 
           Head of the college units can terminate or revoke the membership of a member within the college unit.
-  - title: Internship
+  - id: art-8
+    number: 8
+    title: Internship
     content: |
       Internship is a program where the students of the college are given an opportunity to work for the NGO and to learn the working of the NGO as a coordinator in respective collage unit.
     sections:
-      - title: Stipend
+      - id: art-8-s-1
+        number: 1
+        title: Stipend
         content: |
           There is no stipend for the internship program. But the interns will be provided with the certificate of internship in thier respective college units.
-      - title: Duration
+      - id: art-8-s-2
+        number: 2
+        title: Duration
         content: |
           The duration of the internship program is 3 academic years.
-      - title: Eligibility
+      - id: art-8-s-3
+        number: 3
+        title: Eligibility
         content: |
           Any student who is willing to serve the society and who is willing to abide by the rules and regulations of the NGO is eligible to become an intern according to the article 7 of the constitution.
-      - title: Selection Process
+      - id: art-8-s-4
+        number: 4
+        title: Selection Process
         content: |
           The selection process for the internship program is as follows:
           1. The student should fill the application form for the internship program.
           2. The student should attend the interview conducted by the college board.
           3. The student should be selected by the board.
-      - title: Roles and Responsibilities
+      - id: art-8-s-5
+        number: 5
+        title: Roles and Responsibilities
         content: |
           All the interns should abide by the rules and regulations of the NGO. The interns should work for the NGO in thier respective departments and should work for the betterment of the society.
-  - title: Board Members
+  - id: art-9
+    number: 9
+    title: Board Members
     content: |
       The board members are the members who are selected by the board of the NGO to manage the NGO and to take care of the NGO.
       They are responsible for the all legal and financial activities of the NGO.
@@ -144,21 +188,29 @@ articles:
 
       The board members are selected by the board of the NGO.
     sections:
-      - title: Eligibility
+      - id: art-9-s-1
+        number: 1
+        title: Eligibility
         content: |
           Any member who is extremely active and has been working for the NGO for selfless service and who is willing to abide by the rules and regulations of the NGO is eligible to become a board member.
-      - title: Selection Process
+      - id: art-9-s-2
+        number: 2
+        title: Selection Process
         content: |
           The selection process for the board members is as follows:
           1. The member should fill the application form for the board member.
           2. The member should attend the interview conducted by the board.
           3. The member should be selected by the board.
-      - title: Roles and Responsibilities
+      - id: art-9-s-3
+        number: 3
+        title: Roles and Responsibilities
         content: |
           All the board members should abide by the rules and regulations of the NGO and work according to the constitution of the NGO and by-laws of the NGO.
           The board members are responsible for the all legal and financial activities of the NGO.
           The board members are responsible for the all activities of the NGO.
-  - title: Intermediate Board Members
+  - id: art-10
+    number: 10
+    title: Intermediate Board Members
     content: |
       The IBM are the members who are selected by the board of the NGO to manage the NGO and to take care of the NGO.
       They are responsible for the all legal and financial activities of the NGO.
@@ -173,16 +225,22 @@ articles:
         8. Content Coordinator
         9. Volunteer Coordinator
     sections:
-      - title: Eligibility
+      - id: art-10-s-1
+        number: 1
+        title: Eligibility
         content: |
           Any member who is extremely active and has been working for the NGO for selfless service and who is willing to abide by the rules and regulations of the NGO is eligible to become a IBM.
-      - title: Selection Process
+      - id: art-10-s-2
+        number: 2
+        title: Selection Process
         content: |
           The selection process for the IBM is as follows:
           1. The member should fill the application form for the IBM.
           2. The member should attend the interview conducted by the board.
           3. The member should be selected by the board.
-      - title: Roles and Responsibilities
+      - id: art-10-s-3
+        number: 3
+        title: Roles and Responsibilities
         content: |
           All the IBM should abide by the rules and regulations of the NGO and work according to the constitution. \
           The IMB members responsibilities are as follows:
@@ -214,8 +272,9 @@ articles:
             9. Volunteer Coordinator
             Volunteer Coordinator are responsible for the all volunteer activities of the NGO. They are responsible for the all volunteer activities of the college units.
             They are responsible for the all volunteer activities of the NGO and maintain high quality of the volunteer activities in the NGO.
-
-  - title: College Units
+  - id: art-11
+    number: 11
+    title: College Units
     content: |
       The college units are the units of the NGO which are established in the colleges to manage the NGO and to take care of the NGO.
       The college units consists of the following members:
@@ -228,7 +287,9 @@ articles:
       7. Reseseach and Development Department Head
       8. Graphics Department Head
     sections:
-      - title: Establishment
+      - id: art-11-s-1
+        number: 1
+        title: Establishment
         content: |
           To establish a college unit in a college, the following conditions should be satisfied:
           1. There should be atleast 10 members in the college who are willing to work for the NGO.
@@ -236,17 +297,25 @@ articles:
           3. The head of the college unit must fill the application form for the college unit.
           4. The head of the college unit must attend the interview conducted by the board.
           5. The head of the college unit must be selected by the board.
-      - title: Funds
+      - id: art-11-s-2
+        number: 2
+        title: Funds
         content: |
           All college units should should submit the accounts to the IBM (Finance Coordinator) of the NGO. The college units should get permission from the IBM (Finance Coordinator) or Board (Treasurer) of the NGO to use the funds of the NGO.
-      - title: Roles and Responsibilities
+      - id: art-11-s-3
+        number: 3
+        title: Roles and Responsibilities
         content: |
           All the college units should abide by the rules and regulations of the NGO and work according to the constitution.
           They can raise funds, and do any activity for the betterment of the society.
-  - title: Alumini
+  - id: art-12
+    number: 12
+    title: Alumini
     content: |
       Refers to a person who has previously worked with the NGO and has maintained good membership standing.
-  - title: Anual Reports
+  - id: art-13
+    number: 13
+    title: Anual Reports
     content: |
       1. All divisions and units must maintain the task reports of all the events taken up during the
       year, and must submit the reports to the Finance Controller Coordinator of STM at least 2 weeks
@@ -256,38 +325,58 @@ articles:
       3. The Annual Report of the NGO must be compulsorily prepared by the Finance Controller
       of STM by the AGM in the prescribed format mentioned in the Documentation policy
       4. All the Annual Reports from the inception of the NGO must be maintained in the STM management portal
-  - title: Sabbatical Leave
+  - id: art-14
+    number: 14
+    title: Sabbatical Leave
     content: |
       Sabbatical leave is a leave given to the members of the NGO who are working for the NGO for a long time and who are willing to take a break from the NGO for a certain period of time.
     sections:
-      - title: Eligibility
+      - id: art-14-s-1
+        number: 1
+        title: Eligibility
         content: |
           Any member who is working for the NGO for a long time and who is willing to take a break from the NGO for a certain period of time is eligible for the sabbatical leave.
-      - title: Application
+      - id: art-14-s-2
+        number: 2
+        title: Application
         content: |
           The member should fill the application form for the sabbatical leave and should submit the application to the board.
-      - title: Duration
+      - id: art-14-s-3
+        number: 3
+        title: Duration
         content: |
           The duration of the sabbatical leave will be varied from 6 months to 1 year. According to the application of the member.
-  - title: Resignation
+  - id: art-15
+    number: 15
+    title: Resignation
     content: |
       Resignation is a process where the member of the NGO can leave the NGO if they are not willing to work for the NGO.
     sections:
-      - title: Eligibility
+      - id: art-15-s-1
+        number: 1
+        title: Eligibility
         content: |
           Any member who is not willing to work for the NGO is eligible for the resignation.
-      - title: Application
+      - id: art-15-s-2
+        number: 2
+        title: Application
         content: |
           The member should fill the application form for the resignation and should submit the application to the board.
-      - title: Duration
+      - id: art-15-s-3
+        number: 3
+        title: Duration
         content: |
           The duration of the resignation will be varied from 1 month to 3 months. According to the application of the member.
-  - title: Ammendments
+  - id: art-16
+    number: 16
+    title: Ammendments
     content: |
       1. Any changes to the constitution of the NGO should be done by the board of the NGO.
       2. The ammenments should be done according to the by-laws of the NGO.
       3. All the proposed ammendments should be approved by the board of the NGO, intermediate board of the NGO and all college units of the NGO.
-  - title: Dissolution
+  - id: art-17
+    number: 17
+    title: Dissolution
     content: |
       (a). In an event that the NGO fails to function totally and needs to be dissolved, the whole
       board of the NGO shall be dissolved and a new board shall be elected by the General Body. Else, the whole NGO shall be dissolved. \
diff --git a/specs/v2.yaml b/constitution/versions/v2.0.0.yaml
similarity index 85%
rename from specs/v2.yaml
rename to constitution/versions/v2.0.0.yaml
index cffc6de..3a66395 100644
--- a/specs/v2.yaml
+++ b/constitution/versions/v2.0.0.yaml
@@ -1,30 +1,37 @@
-openconstitution: 1.0.0
+opencodelaw: "1.0"
 info:
   title: SERVICE TO MANKIND
-  termsOfService: https://example.com/terms
+  organization: Service to Mankind Welfare Association
+  jurisdiction: Telangana, India
+  version: 2.0.0
+  status: superseded
+  effective_from: "2024-05-02"
   logo:
     url: https://stmorg.in/accesories/service_to_man_kind-20200709-0001.jpg
     alt: Logo
   contact:
     name: Pranay Kiran
-    url: https://example.com/contact
     email: pranay@stmorg.in
   license: MIT
-  version: 2.0.0
 preamble:
+  id: preamble
   title: PREAMBLE
   content: |
     Service to Mankind is a Non-Governmental Organization (NGO) registered under Telangana Societies Registration Act., 2001 that was started to create a platform for students who are
     intent on doing their bit towards the betterment of society. Service to Mankind is a platform for the students to serve the society and to inculcate a sense of social responsibility in them.
-  adopted: 2023-10-08T20:20:00+05:30
+  adopted: "2023-10-08T20:20:00+05:30"
 articles:
-  - title: Name of the Organization
+  - id: art-1
+    number: 1
+    title: Name of the Organization
     content: |
       The name of the organization shall be Service to Mankind (hereinafter referred to as
       "the NGO").The acronym that might be used to refer to the NGO will be STM.
       The Registered Office of the Society shall be STM India Headquarters, Ft No. 25/24, Bowrampet, 500043, Hyderabad, Telangana
       will operate anywhere.
-  - title: Interpretations/Definitions
+  - id: art-2
+    number: 2
+    title: Interpretations/Definitions
     content: |
       In this Constitution, unless the context otherwise requires:
       1. "Act" means the Telangana Societies Registration Act., 2001.
@@ -43,43 +50,65 @@ articles:
       14. "Year" means the financial year of the NGO.
       15. "IBM" means the Intermediate Board Members of the NGO.
       16. "STM" means the Service to Mankind.
-  - title: Aims and Objectives
+  - id: art-3
+    number: 3
+    title: Aims and Objectives
     content: |
       The NGO has been established to create a platform for the students who are intent on doing
       their bit towards the betterment of society with the objective of helping the underprivileged
       and the destitute in any and every way possible.
-  - title: Mission Statement
+  - id: art-4
+    number: 4
+    title: Mission Statement
     content: |
       The mission of the NGO is to provide a platform for the students to serve the society and
       to inculcate a sense of social responsibility in them.
-  - title: Vision Statement
+  - id: art-5
+    number: 5
+    title: Vision Statement
     content: |
       The vision of the NGO is to create a society where everyone has access to basic amenities
       and to create a society where everyone is treated equally.
-  - title: STM Roles
+  - id: art-6
+    number: 6
+    title: STM Roles
     content: |
       The membership of the NGO shall be open to all the students of the college who are willing to
       serve the society and who are willing to abide by the rules and regulations of the NGO.
     sections:
-      - title: Board Member
+      - id: art-6-s-1
+        number: 1
+        title: Board Member
         content: |
           Any person who is willing to serve the society and who is willing to abide by the rules and regulations of the NGO to serve the STM for the lifetime and manage every thing in the STM.
-      - title: Intermediate Board Member
+      - id: art-6-s-2
+        number: 2
+        title: Intermediate Board Member
         content: |
           Any person who is willing to serve the society and who is willing to abide by the rules and regulations of the NGO to serve the STM for the lifetime and manage every thing in the STM under the board.
-      - title: College Unit Board Member
+      - id: art-6-s-3
+        number: 3
+        title: College Unit Board Member
         content: |
           Any person who is willing to serve the society and who is willing to abide by the rules and regulations of the NGO to serve the STM in thier respective college unit within thier academic life.
-      - title: Coordinator
+      - id: art-6-s-4
+        number: 4
+        title: Coordinator
         content: |
           Any person who is willing to serve the society and who is willing to abide by the rules and regulations of the NGO to serve and work for the STM after the successfull interview.
-      - title: Volunteer
+      - id: art-6-s-5
+        number: 5
+        title: Volunteer
         content: |
           Any person who is willing to serve the society and who is willing to abide by the rules and regulations of the NGO to do service on thier will.
-      - title: Donor
+      - id: art-6-s-6
+        number: 6
+        title: Donor
         content: |
           Any person who agrees to donate a certain amount of money to the NGO is eligible to become a donor.
-  - title: Membership
+  - id: art-7
+    number: 7
+    title: Membership
     content: |
       1. A person who has been recruited into the organization on follow of process as per Organization rules and regulations and is duly appointed by STM as such for any of the college units or works for the NGO in certain form shall be called as an STM ‘Member’..
       2. A person who has registered online in the STM website and admitted in the NGO through a confirmation email and according to its regulations continues to be a member of the NGO.
@@ -108,29 +137,43 @@ articles:
           * (b)The authority to terminate or revoke the status of a member shall be vested with the Board for all members. 
           Intermediate board can terminate or revoke the membership of a member for college units. 
           Head of the college units can terminate or revoke the membership of a member within the college unit.
-  - title: Internship
+  - id: art-8
+    number: 8
+    title: Internship
     content: |
       Internship is a program where the students of the college are given an opportunity to work for the NGO and to learn the working of the NGO as a coordinator in respective collage unit.
     sections:
-      - title: Stipend
+      - id: art-8-s-1
+        number: 1
+        title: Stipend
         content: |
           There is no stipend for the internship program. But the interns will be provided with the certificate of internship in thier respective college units.
-      - title: Duration
+      - id: art-8-s-2
+        number: 2
+        title: Duration
         content: |
           The duration of the internship program is 3 academic years.
-      - title: Eligibility
+      - id: art-8-s-3
+        number: 3
+        title: Eligibility
         content: |
           Any student who is willing to serve the society and who is willing to abide by the rules and regulations of the NGO is eligible to become an intern according to the article 7 of the constitution.
-      - title: Selection Process
+      - id: art-8-s-4
+        number: 4
+        title: Selection Process
         content: |
           The selection process for the internship program is as follows:
           1. The student should fill the application form for the internship program.
           2. The student should attend the interview conducted by the college board.
           3. The student should be selected by the board.
-      - title: Roles and Responsibilities
+      - id: art-8-s-5
+        number: 5
+        title: Roles and Responsibilities
         content: |
           All the interns should abide by the rules and regulations of the NGO. The interns should work for the NGO in thier respective departments and should work for the betterment of the society.
-  - title: Board Members
+  - id: art-9
+    number: 9
+    title: Board Members
     content: |
       1. The board members are responsible for proper functioning of the NGO by guiding IBM. <br>
       2. The board members are responsible for all activities of the NGO, but they are not held responsible for any activity undertaken by any member without informing the authorized person. <br>
@@ -144,7 +187,9 @@ articles:
           5. Joint Secretary
           6. Executive Members
       6. All the board members should abide by the rules and regulations of the NGO and work according to the constitution of the NGO and by-laws of the NGO. <br>
-  - title: Intermediate Board Members
+  - id: art-10
+    number: 10
+    title: Intermediate Board Members
     content: |
       The IBM are the members who are selected by the board of the NGO to manage the NGO and to take care of the NGO.
       They are responsible for the all legal and financial activities of the NGO.
@@ -158,16 +203,22 @@ articles:
         7. Operations Coordinator
         8. Documentation Coordinator
     sections:
-      - title: Eligibility
+      - id: art-10-s-1
+        number: 1
+        title: Eligibility
         content: |
           Any person who has been selfless service to the NGO and abides by the rules and regulations of the NGO is eligible to become an IBM.
-      - title: Selection Process
+      - id: art-10-s-2
+        number: 2
+        title: Selection Process
         content: |
           The selection process for the IBM is as follows:
           1. The person should fill out the application form for IBM.
           2. The person will engage in recruitment rounds conducted by the board.
           3. The person should be selected by the board.
-      - title: Roles and Responsibilities
+      - id: art-10-s-3
+        number: 3
+        title: Roles and Responsibilities
         content: |
           The Intermediate Board Members are responsible for proper functioning of STM units. IBM should abide by the rules and regulations of the NGO and work according to the constitution. \
           The IBM are as follows:
@@ -199,12 +250,14 @@ articles:
             8. Documentation Coordinator:
             The Documentation Coordinator is responsible
             for all documents of the NGO and to maintain all documents secured.
-
-  - title: Units
-    content: |
-
+  - id: art-11
+    number: 11
+    title: Units
+    content: ""
     sections:
-      - title: units
+      - id: art-11-s-1
+        number: 1
+        title: units
         content: |
           - (a) The units of the NGO which are established in the colleges. Every unit consists a board with following members: 
             1. Head 
@@ -218,59 +271,87 @@ articles:
           - (b) All the members of the Unit should abide by the rules and regulations of the NGO and work according to the constitution. \
           - (c) Coordinators are recruited every year through a selection process wherein the candidates are filtered through rounds and are recruited based on the criteria of the STM. \
           - (d) Unselected candidates can still contribute as volunteers for the STM. \
-      - title: Establishment
+      - id: art-11-s-2
+        number: 2
+        title: Establishment
         content: |
           To establish a unit in a college, the following conditions should be satisfied:
           - (a) There should be at least 10 people in the college who are willing to work for the NGO.
           - (b) The head of the unit must consult the IBM-Human Resources Coordinator
           - (c) The head of the unit must fill the application form for the college unit.
           - (d) The head of the unit must attend the interview conducted by the IBM-Human Resources Coordinator
-  - title: Alumini
+  - id: art-12
+    number: 12
+    title: Alumini
     content: |
-     “Alumni” refers to the member who has previously worked with the NGO.
-  - title: Anual Reports
+      “Alumni” refers to the member who has previously worked with the NGO.
+  - id: art-13
+    number: 13
+    title: Anual Reports
     content: |
       1. All divisions and units must maintain the task reports of all the events taken up during the year, and must submit the reports to the Finance Controller Coordinator of STM at least 2 weeks prior to the AGM
       2. A detailed annual report of all the events conducted throughout the NGO shall be consolidated and maintained by the Finance Controller Coordinator of STM
       3. The Annual Report of the NGO must be compulsorily prepared by the Finance Controller of STM by the AGM in the prescribed format mentioned in the Documentation policy
       4. All the Annual Reports from the inception of the NGO must be maintained in the STM management portal
-  - title: Sabbatical Leave
+  - id: art-14
+    number: 14
+    title: Sabbatical Leave
     content: |
       Sabbatical leave is a leave given to the members of the NGO who are working for the NGO for a long time and who are willing to take a break from the NGO for a certain period of time.
     sections:
-      - title: Eligibility
+      - id: art-14-s-1
+        number: 1
+        title: Eligibility
         content: |
           Any member who is working for the NGO for a long time and who is willing to take a break from the NGO for a certain period of time is eligible for the sabbatical leave.
-      - title: Application
+      - id: art-14-s-2
+        number: 2
+        title: Application
         content: |
           The member should fill the application form for the sabbatical leave and should submit the application to the board.
-      - title: Duration
+      - id: art-14-s-3
+        number: 3
+        title: Duration
         content: |
           The duration of the sabbatical leave will be varied from 6 months to 1 year. According to the application of the member.
-  - title: Resignation
+  - id: art-15
+    number: 15
+    title: Resignation
     content: |
       Resignation is a process where the member of the NGO can leave the NGO if they are not willing to work for the NGO.
     sections:
-      - title: Eligibility
+      - id: art-15-s-1
+        number: 1
+        title: Eligibility
         content: |
           Any member who is not willing to work for the NGO is eligible for the resignation.
-      - title: Application
+      - id: art-15-s-2
+        number: 2
+        title: Application
         content: |
           The member should fill the application form for the resignation and should submit the application to the board.
-      - title: Duration
+      - id: art-15-s-3
+        number: 3
+        title: Duration
         content: |
           The duration of the resignation will be varied from 1 month to 3 months. According to the application of the member.
-  - title: Ammendments
+  - id: art-16
+    number: 16
+    title: Ammendments
     content: |
       1. Any changes to the constitution of the NGO should be done by the board of the NGO.
       2. The ammenments should be done according to the by-laws of the NGO.
       3. All the proposed ammendments should be approved by the board of the NGO, intermediate board of the NGO and all college units of the NGO.
-  - title: Dissolution
+  - id: art-17
+    number: 17
+    title: Dissolution
     content: |
       (a). In an event that the NGO fails to function totally and needs to be dissolved, the whole
       board of the NGO shall be dissolved and a new board shall be elected by the General Body. Else, the whole NGO shall be dissolved. \
       (b). College Units of the NGO can only be dissolved by the Board of the NGO
-  - title: Suspension/Termination
+  - id: art-18
+    number: 18
+    title: Suspension/Termination
     content: |
       1. The Internal Compliance coordinator holds the right to suspend or terminate any member if they violate the constitution or guidelines in any way.
       2. Any member defaming the NGO in any form will be terminated.
@@ -283,18 +364,3 @@ articles:
       suspended/terminated.
       6. Suspension or termination only happens after receiving a confirmation letter from
       the Internal Compliance Coordinator.
-ammendments:
-  - title: Establishing the Constitution
-    content: |
-      Establishing the Constitution
-    archive: /archives/v1
-    act: #
-    date: 2023-10-08T20:20:00+05:30
-    author: Pranay Kiran
-  - title: First Constitution Amendment Act, 2024
-    content: |
-      This Act also called the “Membership Act, 2024”
-    archive: /
-    act: acts/First_Constitution_Amendment_Act_2024.pdf
-    date: 2024-05-02T21:25:00+05:30
-    author: M. Revanth Reddy
\ No newline at end of file
diff --git a/examples/starter/.gitkeep b/examples/starter/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/examples/starter/constitution.yaml b/examples/starter/constitution.yaml
new file mode 100644
index 0000000..a4e334d
--- /dev/null
+++ b/examples/starter/constitution.yaml
@@ -0,0 +1,118 @@
+# ---------------------------------------------------------------------------
+# OpenCodeLaw starter constitution.
+#
+# Copy this to constitution/current.yaml, replace the content, and deploy.
+# Run `npx opencodelaw validate constitution/current.yaml` as you go — the
+# validator is the fastest way to learn the schema.
+#
+# Full reference: schema/SPEC.md (generated from the JSON Schema, never drifts).
+# ---------------------------------------------------------------------------
+
+# Schema version. Quoted — unquoted, YAML reads 1.0 as a float.
+opencodelaw: "1.0"
+
+info:
+  title: EXAMPLE SOCIETY                       # short name, shown in the header
+  organization: Example Society Incorporated   # full legal name
+  jurisdiction: Somewhere, Somecountry         # optional
+  # registration: SOC/1234/2020                # optional: your registration number
+
+  version: 1.0.0                               # semver; must match the filename when archived
+  status: current                              # exactly one document may be `current`
+  effective_from: 2025-01-01                   # ISO date
+
+  # The validator REJECTS example.org / example.com addresses. That is
+  # deliberate: this file will not pass `opencodelaw validate` until you
+  # replace the line below with a real one. The constitution this engine was
+  # built for shipped two example.com URLs to production for two years because
+  # nothing objected.
+  contact:
+    name: The Secretary
+    email: secretary@example.org               # <- REPLACE ME, the build fails until you do
+  license: CC-BY-4.0
+
+# ---------------------------------------------------------------------------
+# Optional. Include this ONLY while some enacted amendment is not yet applied.
+# The site renders a visible banner from it on every page, naming what is
+# outstanding and why. Delete the block once everything is reconciled.
+# ---------------------------------------------------------------------------
+# reconciliation_state:
+#   target_version: 2.0.0
+#   complete: false
+#   held:
+#     - provisions: [art-4]
+#       blocked_by: board sign-off
+#       note: Act 1 of 2025 substitutes Article 4; awaiting confirmation of clause 3.
+
+preamble:
+  id: preamble                                 # fixed value
+  title: Preamble
+  content: |
+    This Society exists to … .
+
+    Content is Markdown. It is sanitised at build time against a strict
+    allowlist, so a spec from an untrusted source cannot inject script.
+  adopted: 2025-01-01
+
+articles:
+  # -------------------------------------------------------------------------
+  # `id` and `number` are the citation identity and are PERMANENT.
+  #
+  # Never derive either from position in this list. Reordering these entries
+  # must change no anchor and no citation — there is a test that proves it.
+  # The validator enforces that `id` is always `art-<number>`.
+  # -------------------------------------------------------------------------
+  - id: art-1
+    number: 1
+    title: Name
+    content: |
+      The name of the society shall be Example Society Incorporated.
+
+  - id: art-2
+    number: 2
+    title: Objects
+    content: |
+      The objects of the society are:
+
+      1. to do the first thing;
+      2. to do the second thing.
+
+  # An article may hold sections instead of, or as well as, its own body.
+  # Section ids follow the article: art-3-s-1, art-3-s-2, …
+  - id: art-3
+    number: 3
+    title: Membership
+    content: |
+      Membership is open to any person who supports the objects.
+    # `amended_by` refers to an id in acts/register.yaml. It must resolve.
+    # amended_by: [act-1-2025]
+    sections:
+      - id: art-3-s-1
+        number: 1
+        title: Admission
+        content: |
+          A person becomes a member on approval by the committee.
+      - id: art-3-s-2
+        number: 2
+        title: Termination
+        content: |
+          Membership ends on resignation, death, or expulsion under Article 4.
+
+  # -------------------------------------------------------------------------
+  # A gap in numbering is legal ONLY when an entry accounts for it. This is how
+  # a statute book represents a number no provision occupies — the alternative,
+  # silently renumbering, breaks every citation ever made to the articles after
+  # the gap. `reserved` and `omitted` carry a `note` and no `content`.
+  # -------------------------------------------------------------------------
+  - id: art-4
+    number: 4
+    title: Reserved
+    status: reserved
+    note: No instrument has occupied this number.
+
+  - id: art-5
+    number: 5
+    title: Dissolution
+    content: |
+      The society may be dissolved by a resolution of three quarters of members
+      present and voting at a general meeting.
diff --git a/js/bak.js b/js/bak.js
deleted file mode 100644
index 23c2c9f..0000000
--- a/js/bak.js
+++ /dev/null
@@ -1,477 +0,0 @@
-// js/opencon.js
-const body = document.querySelector('body')
-// Convert Markdown content to HTML
-function convertMarkdownToHTML(markdown) {
-  if (typeof marked !== 'undefined') {
-    return marked.parse(markdown)
-  } else {
-    return markdown
-  }
-  // return markdown;
-}
-
-// get src content from "<opencodelaw src="specs/opencon.yaml"></opencodelaw>" tag
-const opencodelawtag = document.querySelector('opencodelaw')
-const src = opencodelawtag.getAttribute('spec-url')
-
-fetch(src)
-  .then((response) => response.text())
-  .then((yamlData) => {
-    const jsonData = jsyaml.load(yamlData)
-
-    info = jsonData.info
-
-    // Create header
-    const nav = document.createElement('nav')
-    nav.classList.add('nav')
-    const navLink = document.createElement('a')
-    navLink.classList.add('nav__link')
-    navLink.href = 'index.html'
-    const titleWrap = document.createElement('div')
-    titleWrap.classList.add('title-wrap')
-    const logo = document.createElement('img')
-    logo.classList.add('nav__logo')
-    logo.src = info.logo.url
-    logo.alt = info.logo.alt
-    const title = document.createElement('h1')
-    title.textContent = info.title
-    const toggleContainer = document.createElement('div')
-    toggleContainer.classList.add('toggle-container')
-    toggleContainer.setAttribute('id', 'toggle-container')
-    const labelSpan = document.createElement('span')
-    labelSpan.classList.add('toggle-label')
-    labelSpan.innerText = 'Theme:'
-    toggleContainer.appendChild(labelSpan)
-    titleWrap.appendChild(logo)
-    titleWrap.appendChild(title)
-    navLink.appendChild(titleWrap)
-    nav.appendChild(navLink)
-    nav.appendChild(toggleContainer)
-    body.appendChild(nav)
-
-    // create main
-    const main = document.createElement('main')
-    main.classList.add('main')
-    body.appendChild(main)
-    // create vertical nav
-    const verticalNav = document.createElement('div')
-    verticalNav.classList.add('vertical-nav')
-    const navContent = document.createElement('div')
-    navContent.classList.add('nav-content')
-    const navContentImg = document.createElement('img')
-    navContentImg.src = 'assets/img/nav-content.png'
-    navContentImg.alt = 'content-img'
-    const navContentTitle = document.createElement('h2')
-    navContentTitle.textContent = 'Contents'
-    navContent.appendChild(navContentImg)
-    navContent.appendChild(navContentTitle)
-    verticalNav.appendChild(navContent)
-    const navUl = document.createElement('ul')
-    navUl.classList.add('nav-ul')
-    verticalNav.appendChild(navUl)
-    main.appendChild(verticalNav)
-
-    // create preamble heading
-    const navLiPreamble = document.createElement('li')
-    navLiPreamble.classList.add('nav-list')
-    navLiPreamble.classList.add('heading')
-    const navLinkPreamble = document.createElement('a')
-    navLinkPreamble.classList.add('nav-a')
-    navLinkPreamble.href = `#preamble`
-    navLinkPreamble.textContent = `Preamble`
-    navLiPreamble.appendChild(navLinkPreamble)
-    navUl.appendChild(navLiPreamble)
-
-    // create artcle heading
-    const navLiMain = document.createElement('li')
-    navLiMain.classList.add('nav-list')
-    navLiMain.classList.add('heading')
-    const navLinkMain = document.createElement('a')
-    navLinkMain.classList.add('nav-a')
-    navLinkMain.href = `#articles`
-    navLinkMain.textContent = `Articles`
-    navLiMain.appendChild(navLinkMain)
-    navUl.appendChild(navLiMain)
-
-    articles = jsonData.articles
-
-    articles.forEach((article, index) => {
-      const navLi = document.createElement('li')
-      navLi.classList.add('nav-list')
-      // navLi.classList.add("heading");
-     
-
-      const navLink = document.createElement('a')
-      navLink.classList.add('nav-a')
-      navArticleId = navLink.href = `#article${index + 1}`
-      navLink.textContent = article.title
-      navLi.appendChild(navLink)
-      navUl.appendChild(navLi)
-      sections = article.sections
-      if (sections != undefined) {
-        navLi.classList.add('sub-menu')
-        // navLi.classList.remove("heading");
-
-        const navSectionUl = document.createElement('ul')
-        navSectionUl.classList.add('nav-ul')
-        navSectionUl.classList.add('nav-section')
-        navSectionUl.classList.add('sub-nav')
-        navSectionUl.classList.add('nav-hide')
-        navLi.appendChild(navSectionUl)
-
-        //dropdown icon
-        const downArrow = document.createElement("span");
-        downArrow.classList.add("down-arrow", "arrow-rotate"); // Add both classes
-        downArrow.textContent = "▼"; // Unicode character for down arrow
-        navLink.appendChild(downArrow); // Append the arrow to the link
-
-        const navSectionLi = document.createElement('li')
-        navSectionLi.classList.add('nav-list')
-        const navSectionLink = document.createElement('a')
-        navSectionLink.classList.add('nav-a')
-        navSectionLink.classList.add('heading')
-        sections.forEach((section, index) => {
-          const navSectionSubLi = document.createElement('li')
-          navSectionSubLi.classList.add('nav-list')
-          const navSectionSubLink = document.createElement('a')
-          navSectionSubLink.classList.add('nav-a')
-          navSectionSubLink.href = `${navArticleId}-section${index + 1}`
-          navSectionSubLink.textContent = `${index + 1}. ${section.title}`
-          navSectionSubLi.appendChild(navSectionSubLink)
-          navSectionUl.appendChild(navSectionSubLi)
-        })
-      }
-    })
-    preamble = jsonData.preamble
-
-    // Create the toggle theme switch
-    const themeToggle = document.createElement('label')
-    themeToggle.classList.add('toggle-switch')
-    themeToggle.innerHTML = `
-            <input type="checkbox" id="theme-toggle">
-            <span class="slider"></span>
-        `
-
-
-    // Append the toggle switch to the toggle container
-    toggleContainer.appendChild(themeToggle)
-    themeToggle.querySelector('input').addEventListener('change', toggleTheme)
-    // Function to toggle between dark and light themes
-    const darkBackgroundColor = "#333333"
-    const lightBackgroundColor = "#f5f5f5"
-    const darkTextColor = "#f2f2f2"
-    const lightTextColor = "#333"
-    function toggleTheme() {
-      const slider = themeToggle.querySelector('.slider')
-      const nav = document.querySelector('.nav')
-      const vertical_nav = document.querySelector('main .vertical-nav')
-      const container_main = document.querySelector('main .container-main')
-      const articleDesc = document.querySelectorAll("main .container-main .container-main__content .paragraph")
-      const sideBarLinks = document.querySelectorAll("main .vertical-nav .nav-ul li.nav-list a")
-      const h1 = document.querySelectorAll("h1")
-      const h2 = document.querySelectorAll("h2")
-      const h3 = document.querySelectorAll("h3")
-      const themeText = document.querySelector(".toggle-label")
-
-
-      if (themeToggle.querySelector('input').checked) {
-        slider.style.backgroundColor = '#533566'
-        nav.style.backgroundColor = `${darkBackgroundColor}`
-        vertical_nav.style.backgroundColor = `${darkBackgroundColor}`
-        container_main.style.backgroundColor = `${darkBackgroundColor}`
-        body.style.backgroundColor = `${darkBackgroundColor}`
-        articleDesc.forEach((e) => e.style.color = `#cecdcd`)
-        sideBarLinks.forEach((e) => e.style.color = `${darkTextColor}`)
-        h1.forEach((e) => e.style.color = `${darkTextColor}`)
-        h2.forEach((e) => e.style.color = `${darkTextColor}`)
-        h3.forEach((e) => e.style.color = `${darkTextColor}`)
-        themeText.style.color = `${darkTextColor}`
-        localStorage.setItem('theme', 'dark')
-      } else {
-        slider.style.backgroundColor = 'yellow'
-        nav.style.backgroundColor = '#f5f5f5'
-        vertical_nav.style.backgroundColor = `${lightBackgroundColor}`
-        container_main.style.backgroundColor = `${lightBackgroundColor}`
-        body.style.backgroundColor = `${lightBackgroundColor}`
-        articleDesc.forEach((e) => e.style.color = `${lightTextColor}`)
-        h1.forEach((e) => e.style.color = `${lightTextColor}`)
-        h2.forEach((e) => e.style.color = `${lightTextColor}`)
-        h3.forEach((e) => e.style.color = `${lightTextColor}`)
-        sideBarLinks.forEach((e) => e.style.color = `${lightTextColor}`)
-        themeText.style.color = `${lightTextColor}`
-        localStorage.setItem('theme', 'light')
-      }
-    }
-
-    // create  <div class="container-main">
-    const containerMain = document.createElement('div')
-    containerMain.classList.add('container-main')
-    main.appendChild(containerMain)
-    // create container-main__content
-    const containerMainContent = document.createElement('div')
-    containerMainContent.classList.add('container-main__content')
-    containerMain.appendChild(containerMainContent)
-    const containerMainContentH1 = document.createElement('h1')
-    containerMainContentH1.id = `preamble`
-    containerMainContentH1.classList.add('heading-primary')
-    containerMainContentH1.textContent = preamble.title
-    containerMainContent.appendChild(containerMainContentH1)
-    const containerMainContentP1 = document.createElement('p')
-    containerMainContentP1.classList.add('paragraph')
-    containerMainContentP1.innerHTML = convertMarkdownToHTML(preamble.content)
-    containerMainContent.appendChild(containerMainContentP1)
-    const containerMainContentP2 = document.createElement('p')
-    containerMainContentP2.classList.add('paragraph')
-    containerMainContentP2.classList.add('adoption-d')
-    containerMainContentP2.textContent = 'Adopted on : ' + preamble.adopted
-    containerMainContent.appendChild(containerMainContentP2)
-
-    // create article container with heading
-    const containerMainContentArticle = document.createElement('div')
-    containerMainContentArticle.classList.add('container-main__content')
-    containerMain.appendChild(containerMainContentArticle)
-    const containerMainContentArticleH1 = document.createElement('h1')
-    containerMainContentArticleH1.id = `articles`
-    containerMainContentArticleH1.classList.add('heading-primary')
-    containerMainContentArticleH1.textContent = 'Articles'
-    containerMainContentArticle.appendChild(containerMainContentArticleH1)
-
-    // append all articles
-    articles.forEach((article, index) => {
-      const articleContainer = document.createElement('div')
-      articleContainer.classList.add('article-container')
-      containerMainContentArticle.appendChild(articleContainer)
-      const articleContainerH2 = document.createElement('h2')
-      const articleId = (articleContainerH2.id = `article${index + 1}`)
-      articleContainerH2.classList.add('heading-secondary')
-      articleContainerH2.textContent = `${index + 1}. ${article.title}`
-      articleContainer.appendChild(articleContainerH2)
-      // add copy link button
-      const copyLink = document.createElement('button')
-      copyLink.classList.add('copy-link')
-      copyLink.textContent = '🔗'
-      copyLink.addEventListener('click', () => {
-        // initialize remaining copy link buttons to 🔗
-        const copyLinks = document.querySelectorAll('.copy-link')
-        copyLinks.forEach((copyLink) => {
-          copyLink.textContent = '🔗'
-        })
-        const url = window.location.href
-        navigator.clipboard.writeText(`${url}#${articleId}`)
-        copyLink.textContent = '✅'
-      })
-      articleContainerH2.appendChild(copyLink)
-      const articleContainerP = document.createElement('p')
-      articleContainerP.classList.add('paragraph')
-      articleContainerP.innerHTML = convertMarkdownToHTML(article.content)
-      articleContainer.appendChild(articleContainerP)
-      sections = article.sections
-      if (sections != undefined) {
-        const sectionContainer = document.createElement('div')
-        sectionContainer.classList.add('section-container')
-        articleContainer.appendChild(sectionContainer)
-        sections.forEach((section, index) => {
-          const sectionContainerH3 = document.createElement('h3')
-          sectionContainerH3.id = `${articleId}-section${index + 1}`
-          sectionContainerH3.classList.add('heading-secondary')
-          sectionContainerH3.textContent = `${index + 1}. ${section.title}`
-          sectionContainer.appendChild(sectionContainerH3)
-          // add copy link button
-          const copyLink = document.createElement('button')
-          copyLink.classList.add('copy-link')
-          copyLink.textContent = '🔗'
-          copyLink.addEventListener('click', () => {
-            const copyLinks = document.querySelectorAll('.copy-link')
-            copyLinks.forEach((copyLink) => {
-              copyLink.textContent = '🔗'
-            })
-            const url = window.location.href
-            navigator.clipboard.writeText(
-              `${url}#${articleId}-section${index + 1}`
-            )
-            copyLink.textContent = '✅'
-          })
-          sectionContainerH3.appendChild(copyLink)
-          const sectionContainerP = document.createElement('p')
-          sectionContainerP.classList.add('paragraph')
-          sectionContainerP.innerHTML = convertMarkdownToHTML(section.content)
-          sectionContainer.appendChild(sectionContainerP)
-        })
-      }
-    })
-// Ammendment data (replace with your actual jsonData.ammendments)
-const ammendmentData = jsonData.ammendments;
-console.log(ammendmentData);
-
-// Create amendments table
-const ammendment_container = document.createElement("div");
-ammendment_container.classList.add('container-ammendment');
-
-const table = document.createElement('table');
-table.classList.add('responsive-table');
-
-const caption = document.createElement('caption');
-caption.textContent = 'Ammendments';
-table.appendChild(caption);
-
-const thead = document.createElement('thead');
-const headRow = document.createElement('tr');
-
-const headers = ['Date', 'Act', 'Description', 'Author', 'Archive'];
-headers.forEach(header => {
-  const th = document.createElement('th');
-  th.textContent = header;
-  th.scope = header === 'Act' ? 'col' : 'row';
-  headRow.appendChild(th);
-});
-
-thead.appendChild(headRow);
-table.appendChild(thead);
-
-const tbody = document.createElement('tbody');
-
-// Loop through ammendmentData and create table rows
-ammendmentData.forEach(ammendment => {
-  const row = document.createElement('tr');
-
-  // Extract data from each amendment object
-  const title = ammendment.title;
-  const date = ammendment.date;
-  const description = ammendment.content;
-  const author = ammendment.author;
-  const archive = ammendment.archive;
-
-  // Create table cells and populate with data
-  const cells = [date, title, description, author, archive];
-  cells.forEach(cellData => {
-    const cell = document.createElement('td');
-    cell.textContent = cellData;
-    row.appendChild(cell);
-  });
-
-  tbody.appendChild(row);
-});
-
-table.appendChild(tbody);
-ammendment_container.appendChild(table);
-
-// Append the container to your desired location (replace with your logic)
-containerMain.appendChild(ammendment_container);
-
-console.log("Ammendments table created and appended");
-  
-
-    // create back to top button
-    const backToTop = document.createElement("button")
-    backToTop.classList.add("back-to-top")
-    backToTop.id = "backToTop"
-    backToTop.title = "Go to top"
-    backToTop.textContent = "↑"
-    backToTop.addEventListener("click", () => {
-      window.scrollTo({ top: 0, behavior: "smooth" })
-    }
-    )
-    body.appendChild(backToTop)
-    // Check the user's theme preference in localStorage
-    const savedTheme = localStorage.getItem('theme')
-    if (savedTheme === 'dark') {
-      const themeToggle = document.querySelector(".toggle-switch")
-      themeToggle.querySelector('input').checked = true
-      toggleTheme()
-    }
-  })
-  .then(() => {
-    // ui script
-
-    const subMenus = document.querySelectorAll('.sub-menu')
-    const navLinks = document.querySelectorAll('.nav-a')
-
-    // Function to toggle visibility of sub-menus
-    // Function to toggle visibility of sub-menus and rotate arrow
-function toggleSubMenu(event) {
-  const subMenu = event.currentTarget.querySelector('.sub-nav')
-      subMenu.classList.toggle('nav-hide')
-}
-
-    // Function to prevent sub-menu from closing on click inside
-    function preventSubMenuClose(event) {
-      event.stopPropagation()
-    }
-
-    // Add event listeners to each sub-menu parent
-    subMenus.forEach((subMenu) => {
-      subMenu.addEventListener('click', toggleSubMenu)
-      subMenu
-        .querySelector('.nav-section')
-        .addEventListener('click', preventSubMenuClose)
-    })
-
-    // Highlight the active menu based on content scroll
-    function updateActiveMenu() {
-      const currentPosition = window.scrollY
-      navLinks.forEach((link) => {
-        const section = document.querySelector(link.getAttribute('href'))
-        if (
-          section.offsetTop <= currentPosition + 100 && // Adding an offset to improve accuracy
-          section.offsetTop + section.offsetHeight > currentPosition + 100
-        ) {
-          link.classList.add('active')
-        } else {
-          link.classList.remove('active')
-        }
-      })
-    }
-
-    // Update "active" class when a menu item is clicked
-    navLinks.forEach((link) => {
-      link.addEventListener('click', (event) => {
-        navLinks.forEach((link) => link.classList.remove('active'))
-        link.classList.add('active')
-        const target = document.querySelector(link.getAttribute('href'))
-
-        // Scroll to the target element with smooth scrolling
-        target.scrollIntoView({ behavior: 'smooth' })
-
-        // Close open sub-menus when a menu item is clicked
-        subMenus.forEach((subMenu) => {
-          const subNav = subMenu.querySelector('.nav-section')
-          if (!subNav.contains(target)) {
-            subMenu.querySelector('.sub-nav').classList.add('nav-hide')
-          }
-        })
-      })
-    })
-
-    // Update active menu on scroll
-    window.addEventListener('scroll', updateActiveMenu)
-    updateActiveMenu() // Initial update on page load
-
-
-
-
-  })
-  .catch((error) => {
-    console.error("Error loading YAML data:", error);
-  });
-  window.addEventListener("scroll", scrollFunction);
-
-  function scrollFunction() {
-    const topButton = document.getElementById("backToTop");
-  
-    if (
-      document.body.scrollTop > 20 ||
-      document.documentElement.scrollTop > 20
-    ) {
-      topButton.style.display = "block";
-    } else {
-      topButton.style.display = "none";
-    }
-  }
-  
-  // When the button is clicked, scroll to the top of the document
-  function topFunction() {
-    document.body.scrollIntoView({ behavior: "smooth", block: "start" });
-  }
-  
-  // Add this event listener to handle button click
-  const topButton = document.getElementById("backToTop");
\ No newline at end of file
diff --git a/package-lock.json b/package-lock.json
new file mode 100644
index 0000000..8de2a42
--- /dev/null
+++ b/package-lock.json
@@ -0,0 +1,652 @@
+{
+  "name": "opencodelaw",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "opencodelaw",
+      "version": "1.0.0",
+      "license": "MIT",
+      "dependencies": {
+        "ajv": "8.20.0",
+        "ajv-formats": "3.0.1",
+        "js-yaml": "4.3.1",
+        "marked": "15.0.12",
+        "sanitize-html": "2.17.5"
+      },
+      "bin": {
+        "opencodelaw": "src/cli.mjs"
+      },
+      "devDependencies": {
+        "puppeteer-core": "^25.7.0"
+      },
+      "engines": {
+        "node": ">=18.18.0"
+      }
+    },
+    "node_modules/@puppeteer/browsers": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/@puppeteer/browsers/-/browsers-3.2.0.tgz",
+      "integrity": "sha512-LlBrE8oqGfU7b1Nk2d5Q1SbuPhZxTj0cJEMDPEws28OjNMELlflekmPPuf4FnK03x0ZRjKaYwJElUcKK4kyqJA==",
+      "dev": true,
+      "dependencies": {
+        "modern-tar": "^0.8.0",
+        "yargs": "^18.0.0"
+      },
+      "bin": {
+        "browsers": "lib/main-cli.js"
+      },
+      "engines": {
+        "node": ">=22.12.0"
+      },
+      "peerDependencies": {
+        "proxy-agent": ">=8.0.1",
+        "yauzl": "^2.10.0 || ^3.4.0"
+      },
+      "peerDependenciesMeta": {
+        "proxy-agent": {
+          "optional": true
+        },
+        "yauzl": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/ajv": {
+      "version": "8.20.0",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.20.0.tgz",
+      "integrity": "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==",
+      "dependencies": {
+        "fast-deep-equal": "^3.1.3",
+        "fast-uri": "^3.0.1",
+        "json-schema-traverse": "^1.0.0",
+        "require-from-string": "^2.0.2"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/epoberezkin"
+      }
+    },
+    "node_modules/ajv-formats": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/ajv-formats/-/ajv-formats-3.0.1.tgz",
+      "integrity": "sha512-8iUql50EUR+uUcdRQ3HDqa6EVyo3docL8g5WJ3FNcWmu62IbkGUue/pEyLBW8VGKKucTPgqeks4fIU1DA4yowQ==",
+      "dependencies": {
+        "ajv": "^8.0.0"
+      },
+      "peerDependencies": {
+        "ajv": "^8.0.0"
+      },
+      "peerDependenciesMeta": {
+        "ajv": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/ansi-regex": {
+      "version": "6.3.0",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.3.0.tgz",
+      "integrity": "sha512-WpDfL7NO6j7tH88IDBNVdUJxDh9nmCteAVW9dsep846XdwF4naCBK+/tGLX3KJgcpgMRXCFlTM2hKGoK9FsdrQ==",
+      "dev": true,
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-regex?sponsor=1"
+      }
+    },
+    "node_modules/ansi-styles": {
+      "version": "6.2.3",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.3.tgz",
+      "integrity": "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==",
+      "dev": true,
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+      }
+    },
+    "node_modules/argparse": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz",
+      "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q=="
+    },
+    "node_modules/chromium-bidi": {
+      "version": "17.0.2",
+      "resolved": "https://registry.npmjs.org/chromium-bidi/-/chromium-bidi-17.0.2.tgz",
+      "integrity": "sha512-5v9GQFhTktFvotn/OFNJBmKLKRAb6n9r0bVCwf7sHgWc3/JryK0bj1nn93L3pHFrfgcsu6Be6EWsDi+1XHTGDg==",
+      "dev": true,
+      "dependencies": {
+        "mitt": "^3.0.1",
+        "zod": "^3.24.1"
+      },
+      "engines": {
+        "node": ">=20.19.0 <22.0.0 || >=22.12.0"
+      },
+      "peerDependencies": {
+        "devtools-protocol": "*"
+      }
+    },
+    "node_modules/cliui": {
+      "version": "9.0.1",
+      "resolved": "https://registry.npmjs.org/cliui/-/cliui-9.0.1.tgz",
+      "integrity": "sha512-k7ndgKhwoQveBL+/1tqGJYNz097I7WOvwbmmU2AR5+magtbjPWQTS1C5vzGkBC8Ym8UWRzfKUzUUqFLypY4Q+w==",
+      "dev": true,
+      "dependencies": {
+        "string-width": "^7.2.0",
+        "strip-ansi": "^7.1.0",
+        "wrap-ansi": "^9.0.0"
+      },
+      "engines": {
+        "node": ">=20"
+      }
+    },
+    "node_modules/cliui/node_modules/string-width": {
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-7.2.0.tgz",
+      "integrity": "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==",
+      "dev": true,
+      "dependencies": {
+        "emoji-regex": "^10.3.0",
+        "get-east-asian-width": "^1.0.0",
+        "strip-ansi": "^7.1.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/dayjs": {
+      "version": "1.11.21",
+      "resolved": "https://registry.npmjs.org/dayjs/-/dayjs-1.11.21.tgz",
+      "integrity": "sha512-98IT+HOahAisibz/yjKbzuOBwYcjJ7BCLPzARyHiyEBmRz4fatF+KPJszEHXsGYjUG234aH/cOjW1wwTbKUZlA=="
+    },
+    "node_modules/deepmerge": {
+      "version": "4.3.1",
+      "resolved": "https://registry.npmjs.org/deepmerge/-/deepmerge-4.3.1.tgz",
+      "integrity": "sha512-3sUqbMEc77XqpdNO7FRyRog+eW3ph+GYCbj+rK+uYyRMuwsVy0rMiVtPn+QJlKFvWP/1PYpapqYn0Me2knFn+A==",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/devtools-protocol": {
+      "version": "0.0.1666840",
+      "resolved": "https://registry.npmjs.org/devtools-protocol/-/devtools-protocol-0.0.1666840.tgz",
+      "integrity": "sha512-gCcO42XCHKEs7Ag0S7aGYsnJ7hlgrO3qderYqeiY0Eqk+0GFfuvT13IA0hHreJTa2KCdDVyGMeOhdMNmrrTjVg==",
+      "dev": true
+    },
+    "node_modules/dom-serializer": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/dom-serializer/-/dom-serializer-2.0.0.tgz",
+      "integrity": "sha512-wIkAryiqt/nV5EQKqQpo3SToSOV9J0DnbJqwK7Wv/Trc92zIAYZ4FlMu+JPFW1DfGFt81ZTCGgDEabffXeLyJg==",
+      "dependencies": {
+        "domelementtype": "^2.3.0",
+        "domhandler": "^5.0.2",
+        "entities": "^4.2.0"
+      },
+      "funding": {
+        "url": "https://github.com/cheeriojs/dom-serializer?sponsor=1"
+      }
+    },
+    "node_modules/dom-serializer/node_modules/entities": {
+      "version": "4.5.0",
+      "resolved": "https://registry.npmjs.org/entities/-/entities-4.5.0.tgz",
+      "integrity": "sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw==",
+      "engines": {
+        "node": ">=0.12"
+      },
+      "funding": {
+        "url": "https://github.com/fb55/entities?sponsor=1"
+      }
+    },
+    "node_modules/domelementtype": {
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/domelementtype/-/domelementtype-2.3.0.tgz",
+      "integrity": "sha512-OLETBj6w0OsagBwdXnPdN0cnMfF9opN69co+7ZrbfPGrdpPVNBUj02spi6B1N7wChLQiPn4CSH/zJvXw56gmHw==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fb55"
+        }
+      ]
+    },
+    "node_modules/domhandler": {
+      "version": "5.0.3",
+      "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-5.0.3.tgz",
+      "integrity": "sha512-cgwlv/1iFQiFnU96XXgROh8xTeetsnJiDsTc7TYCLFd9+/WNkIqPTxiM/8pSd8VIrhXGTf1Ny1q1hquVqDJB5w==",
+      "dependencies": {
+        "domelementtype": "^2.3.0"
+      },
+      "engines": {
+        "node": ">= 4"
+      },
+      "funding": {
+        "url": "https://github.com/fb55/domhandler?sponsor=1"
+      }
+    },
+    "node_modules/domutils": {
+      "version": "3.2.2",
+      "resolved": "https://registry.npmjs.org/domutils/-/domutils-3.2.2.tgz",
+      "integrity": "sha512-6kZKyUajlDuqlHKVX1w7gyslj9MPIXzIFiz/rGu35uC1wMi+kMhQwGhl4lt9unC9Vb9INnY9Z3/ZA3+FhASLaw==",
+      "dependencies": {
+        "dom-serializer": "^2.0.0",
+        "domelementtype": "^2.3.0",
+        "domhandler": "^5.0.3"
+      },
+      "funding": {
+        "url": "https://github.com/fb55/domutils?sponsor=1"
+      }
+    },
+    "node_modules/emoji-regex": {
+      "version": "10.6.0",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-10.6.0.tgz",
+      "integrity": "sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A==",
+      "dev": true
+    },
+    "node_modules/entities": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/entities/-/entities-7.0.1.tgz",
+      "integrity": "sha512-TWrgLOFUQTH994YUyl1yT4uyavY5nNB5muff+RtWaqNVCAK408b5ZnnbNAUEWLTCpum9w6arT70i1XdQ4UeOPA==",
+      "engines": {
+        "node": ">=0.12"
+      },
+      "funding": {
+        "url": "https://github.com/fb55/entities?sponsor=1"
+      }
+    },
+    "node_modules/escalade": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz",
+      "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==",
+      "dev": true,
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/escape-string-regexp": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz",
+      "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/fast-deep-equal": {
+      "version": "3.1.3",
+      "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
+      "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q=="
+    },
+    "node_modules/fast-uri": {
+      "version": "3.1.5",
+      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.5.tgz",
+      "integrity": "sha512-gHwA1O9LDIcKunMKhObS/HimwtehO1nPUECKAu5TpKgaO19fcWEl4bliWe1jWxVFvIXztJjjQ4L8XQ1EU9f7Jw==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ]
+    },
+    "node_modules/get-caller-file": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz",
+      "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==",
+      "dev": true,
+      "engines": {
+        "node": "6.* || 8.* || >= 10.*"
+      }
+    },
+    "node_modules/get-east-asian-width": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/get-east-asian-width/-/get-east-asian-width-1.6.0.tgz",
+      "integrity": "sha512-QRbvDIbx6YklUe6RxeTeleMR0yv3cYH6PsPZHcnVn7xv7zO1BHN8r0XETu8n6Ye3Q+ahtSarc3WgtNWmehIBfA==",
+      "dev": true,
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/htmlparser2": {
+      "version": "10.1.0",
+      "resolved": "https://registry.npmjs.org/htmlparser2/-/htmlparser2-10.1.0.tgz",
+      "integrity": "sha512-VTZkM9GWRAtEpveh7MSF6SjjrpNVNNVJfFup7xTY3UpFtm67foy9HDVXneLtFVt4pMz5kZtgNcvCniNFb1hlEQ==",
+      "funding": [
+        "https://github.com/fb55/htmlparser2?sponsor=1",
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fb55"
+        }
+      ],
+      "dependencies": {
+        "domelementtype": "^2.3.0",
+        "domhandler": "^5.0.3",
+        "domutils": "^3.2.2",
+        "entities": "^7.0.1"
+      }
+    },
+    "node_modules/is-plain-object": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/is-plain-object/-/is-plain-object-5.0.0.tgz",
+      "integrity": "sha512-VRSzKkbMm5jMDoKLbltAkFQ5Qr7VDiTFGXxYFXXowVj387GeGNOCsOH6Msy00SGZ3Fp84b1Naa1psqgcCIEP5Q==",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/js-yaml": {
+      "version": "4.3.1",
+      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.3.1.tgz",
+      "integrity": "sha512-CY6crGq313MX8GkwvB7tzgp99vjQxY1++5y10/BKN/GUfHqWaOGQMNZkBvqSzsZKWk/ijwHlWzzkLulsGHhjWQ==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/puzrin"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/nodeca"
+        }
+      ],
+      "dependencies": {
+        "argparse": "^2.0.1"
+      },
+      "bin": {
+        "js-yaml": "bin/js-yaml.js"
+      }
+    },
+    "node_modules/json-schema-traverse": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
+      "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug=="
+    },
+    "node_modules/launder": {
+      "version": "1.7.1",
+      "resolved": "https://registry.npmjs.org/launder/-/launder-1.7.1.tgz",
+      "integrity": "sha512-mU6WRz5EusL9ZZuiZ5SO4Y6C0P9PAUR9iwdb6bzj4KDihm28DiHFw+/yk9DBH4f+Pv1wuzQ4e2jV3oQ7mkIqvw==",
+      "dependencies": {
+        "dayjs": "^1.11.7"
+      }
+    },
+    "node_modules/marked": {
+      "version": "15.0.12",
+      "resolved": "https://registry.npmjs.org/marked/-/marked-15.0.12.tgz",
+      "integrity": "sha512-8dD6FusOQSrpv9Z1rdNMdlSgQOIP880DHqnohobOmYLElGEqAL/JvxvuxZO16r4HtjTlfPRDC1hbvxC9dPN2nA==",
+      "bin": {
+        "marked": "bin/marked.js"
+      },
+      "engines": {
+        "node": ">= 18"
+      }
+    },
+    "node_modules/mitt": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/mitt/-/mitt-3.0.1.tgz",
+      "integrity": "sha512-vKivATfr97l2/QBCYAkXYDbrIWPM2IIKEl7YPhjCvKlG3kE2gm+uBo6nEXK3M5/Ffh/FLpKExzOQ3JJoJGFKBw==",
+      "dev": true
+    },
+    "node_modules/modern-tar": {
+      "version": "0.8.4",
+      "resolved": "https://registry.npmjs.org/modern-tar/-/modern-tar-0.8.4.tgz",
+      "integrity": "sha512-gN54ddmyzEg10orwZ2u4OOv+bjpMWdIl5jIkodK97bMq8QBSL5c0D7YX0lT1Ooz+99S7+PvFbnxzdjgHo1r41g==",
+      "dev": true,
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/nanoid": {
+      "version": "3.3.18",
+      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.18.tgz",
+      "integrity": "sha512-DTg4MJbGMWkfi6VZFdNt2/caMbQy4Ou+Op/hJQvGEWcnVfoA1QA+xzRKAzw9jD6+GVOOeYr/mIcuDSdug6F6+w==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "bin": {
+        "nanoid": "bin/nanoid.cjs"
+      },
+      "engines": {
+        "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
+      }
+    },
+    "node_modules/parse-srcset": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/parse-srcset/-/parse-srcset-1.0.2.tgz",
+      "integrity": "sha512-/2qh0lav6CmI15FzA3i/2Bzk2zCgQhGMkvhOhKNcBVQ1ldgpbfiNTVslmooUmWJcADi1f1kIeynbDRVzNlfR6Q=="
+    },
+    "node_modules/picocolors": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
+      "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA=="
+    },
+    "node_modules/postcss": {
+      "version": "8.5.26",
+      "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.26.tgz",
+      "integrity": "sha512-u82N74LFzG8ca+dD8puPnplTXoGH4fTPpVGuIbt36G3qvNlkvfD0lEAZSxaly3KX8TS/L1A1gsCEmvKmBcVbkQ==",
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/postcss/"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/postcss"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "dependencies": {
+        "nanoid": "^3.3.17",
+        "picocolors": "^1.1.1",
+        "source-map-js": "^1.2.1"
+      },
+      "engines": {
+        "node": "^10 || ^12 || >=14"
+      }
+    },
+    "node_modules/puppeteer-core": {
+      "version": "25.7.0",
+      "resolved": "https://registry.npmjs.org/puppeteer-core/-/puppeteer-core-25.7.0.tgz",
+      "integrity": "sha512-wgBBj7dU5ceGyoT2PCrJpkYOhxPY8mDOmcSKZP92Cj5GgqQ3kv/UxzawnOLxiYuupe4bDf/yiQm3bzs/1nI0rQ==",
+      "dev": true,
+      "dependencies": {
+        "@puppeteer/browsers": "3.2.0",
+        "chromium-bidi": "17.0.2",
+        "devtools-protocol": "0.0.1666840",
+        "typed-query-selector": "^2.12.2",
+        "webdriver-bidi-protocol": "0.4.2",
+        "ws": "^8.21.1"
+      },
+      "engines": {
+        "node": ">=22.12.0"
+      }
+    },
+    "node_modules/require-from-string": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
+      "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/sanitize-html": {
+      "version": "2.17.5",
+      "resolved": "https://registry.npmjs.org/sanitize-html/-/sanitize-html-2.17.5.tgz",
+      "integrity": "sha512-ZmU1joGRrvoyctKIiuwUxqR6moLoU2Wk+2bMccN6f7UwhAmwYDvWziqPxRDDN2Qip62NqnIrVrT9akbL6Wretg==",
+      "dependencies": {
+        "deepmerge": "^4.2.2",
+        "escape-string-regexp": "^4.0.0",
+        "htmlparser2": "^10.1.0",
+        "is-plain-object": "^5.0.0",
+        "launder": "^1.7.1",
+        "parse-srcset": "^1.0.2",
+        "postcss": "^8.3.11"
+      }
+    },
+    "node_modules/source-map-js": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
+      "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/string-width": {
+      "version": "8.2.2",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-8.2.2.tgz",
+      "integrity": "sha512-GaPUh5gfdrYzqeVNZvUfT23vYYxXzKYidUcnMtJg/3rxRV63EFZy3k6xfKlmfeJD0176lnUV/Usr3XcwSvFzpg==",
+      "dev": true,
+      "dependencies": {
+        "get-east-asian-width": "^1.5.0",
+        "strip-ansi": "^7.1.2"
+      },
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/strip-ansi": {
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.2.0.tgz",
+      "integrity": "sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w==",
+      "dev": true,
+      "dependencies": {
+        "ansi-regex": "^6.2.2"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/strip-ansi?sponsor=1"
+      }
+    },
+    "node_modules/typed-query-selector": {
+      "version": "2.12.2",
+      "resolved": "https://registry.npmjs.org/typed-query-selector/-/typed-query-selector-2.12.2.tgz",
+      "integrity": "sha512-EOPFbyIub4ngnEdqi2yOcNeDLaX/0jcE1JoAXQDDMIthap7FoN795lc/SHfIq2d416VufXpM8z/lD+WRm2gfOQ==",
+      "dev": true
+    },
+    "node_modules/webdriver-bidi-protocol": {
+      "version": "0.4.2",
+      "resolved": "https://registry.npmjs.org/webdriver-bidi-protocol/-/webdriver-bidi-protocol-0.4.2.tgz",
+      "integrity": "sha512-VSV+fzfChirL3e7jay2yUC7B4HQCGtEWEg/MSSQbK+qWbqeGlRLlXTzPpYr3XGUvbpDHumWZBJxgesg4N7dbtA==",
+      "dev": true
+    },
+    "node_modules/wrap-ansi": {
+      "version": "9.0.2",
+      "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-9.0.2.tgz",
+      "integrity": "sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww==",
+      "dev": true,
+      "dependencies": {
+        "ansi-styles": "^6.2.1",
+        "string-width": "^7.0.0",
+        "strip-ansi": "^7.1.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
+      }
+    },
+    "node_modules/wrap-ansi/node_modules/string-width": {
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-7.2.0.tgz",
+      "integrity": "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==",
+      "dev": true,
+      "dependencies": {
+        "emoji-regex": "^10.3.0",
+        "get-east-asian-width": "^1.0.0",
+        "strip-ansi": "^7.1.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/ws": {
+      "version": "8.21.3",
+      "resolved": "https://registry.npmjs.org/ws/-/ws-8.21.3.tgz",
+      "integrity": "sha512-201TZ/kPWxoPr/OKWjquZR1SWKXcvxdH+e1xrx89b3YbmzLMFCLfnaG1HFIgWzJOEWZ7MvpK++odZufgYR50Rw==",
+      "dev": true,
+      "engines": {
+        "node": ">=10.0.0"
+      },
+      "peerDependencies": {
+        "bufferutil": "^4.0.1",
+        "utf-8-validate": ">=5.0.2"
+      },
+      "peerDependenciesMeta": {
+        "bufferutil": {
+          "optional": true
+        },
+        "utf-8-validate": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/y18n": {
+      "version": "5.0.8",
+      "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz",
+      "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==",
+      "dev": true,
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/yargs": {
+      "version": "18.1.0",
+      "resolved": "https://registry.npmjs.org/yargs/-/yargs-18.1.0.tgz",
+      "integrity": "sha512-2rAgRKu54VsHkqI0/tYkmluGXHD4KW7yZoycuqDQ15QOTnc2VVfy0nN/1eMhnQLO00A+dwtK20xuCnc1YGeUyg==",
+      "dev": true,
+      "dependencies": {
+        "cliui": "^9.0.1",
+        "escalade": "^3.1.1",
+        "get-caller-file": "^2.0.5",
+        "string-width": "^8.2.1",
+        "y18n": "^5.0.5",
+        "yargs-parser": "^22.0.0"
+      },
+      "engines": {
+        "node": "^20.19.0 || ^22.12.0 || >=23"
+      }
+    },
+    "node_modules/yargs-parser": {
+      "version": "22.0.0",
+      "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-22.0.0.tgz",
+      "integrity": "sha512-rwu/ClNdSMpkSrUb+d6BRsSkLUq1fmfsY6TOpYzTwvwkg1/NRG85KBy3kq++A8LKQwX6lsu+aWad+2khvuXrqw==",
+      "dev": true,
+      "engines": {
+        "node": "^20.19.0 || ^22.12.0 || >=23"
+      }
+    },
+    "node_modules/zod": {
+      "version": "3.25.76",
+      "resolved": "https://registry.npmjs.org/zod/-/zod-3.25.76.tgz",
+      "integrity": "sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ==",
+      "dev": true,
+      "funding": {
+        "url": "https://github.com/sponsors/colinhacks"
+      }
+    }
+  }
+}
diff --git a/package.json b/package.json
new file mode 100644
index 0000000..dd07890
--- /dev/null
+++ b/package.json
@@ -0,0 +1,50 @@
+{
+  "name": "opencodelaw",
+  "version": "1.0.0",
+  "description": "A YAML-driven static renderer for organizational constitutions, with permanent citation identifiers and schema-validated amendment tracking.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ServiceToMankind/OpenCodeLaw.git"
+  },
+  "homepage": "https://constitution.stmorg.in",
+  "bin": {
+    "opencodelaw": "src/cli.mjs"
+  },
+  "engines": {
+    "node": ">=18.18.0"
+  },
+  "scripts": {
+    "validate": "node src/validate.mjs",
+    "build": "node src/build.mjs",
+    "test": "node --test",
+    "dev": "node src/build.mjs --watch --serve",
+    "spec": "node src/gen-spec.mjs",
+    "provenance": "node src/provenance.mjs",
+    "linkcheck": "node src/linkcheck.mjs",
+    "test:e2e": "node --test tests/*.e2e.mjs"
+  },
+  "dependencies": {
+    "ajv": "8.20.0",
+    "ajv-formats": "3.0.1",
+    "js-yaml": "4.3.1",
+    "marked": "15.0.12",
+    "sanitize-html": "2.17.5"
+  },
+  "files": [
+    "src/",
+    "schema/",
+    "examples/"
+  ],
+  "keywords": [
+    "constitution",
+    "governance",
+    "yaml",
+    "static-site",
+    "legislation"
+  ],
+  "devDependencies": {
+    "puppeteer-core": "^25.7.0"
+  }
+}
diff --git a/schema/SPEC.md b/schema/SPEC.md
new file mode 100644
index 0000000..004f8c7
--- /dev/null
+++ b/schema/SPEC.md
@@ -0,0 +1,199 @@
+<!-- Generated by `npm run spec` from schema/opencodelaw-1.0.schema.json. Do not edit by hand. -->
+
+# OpenCodeLaw 1.0
+
+Machine-readable organizational constitution with permanent citation identifiers. Root key is `opencodelaw`, resolving the historical three-way disagreement between the docs (`OpenCodeLaw`), the specs (`openconstitution`) and the renderer (`ammendments`). The amendment register is a separate document; see $defs/actRegister.
+
+Schema: `https://constitution.stmorg.in/schema/opencodelaw-1.0.schema.json`
+
+## Root
+
+| Key | Type | Required | Notes |
+|---|---|---|---|
+| `opencodelaw` | `"1.0"` | **yes** | Schema version. Quoted so YAML does not coerce it to a float. |
+| `info` | [info](#info) | **yes** |  |
+| `preamble` | [preamble](#preamble) | **yes** |  |
+| `articles` | array of [article](#article) | **yes** | Order is presentational only. Identity comes from `id`/`number`, never from array position, so reordering this list changes no citation and no anchor. <br><small>min items 1</small> |
+| `reconciliation_state` | [reconciliationState](#reconciliationstate) | no |  |
+
+## Definitions
+
+### semver
+
+Semantic version. A prerelease suffix is how a document states that it is mid-reconciliation: 3.0.0-alpha.1 is not 3.0.0.
+
+Type: `string` — pattern `^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-…`
+
+### actId
+
+Stable Act identifier: act-<number>-<year>, e.g. act-1-2024.
+
+Type: `string` — pattern `^act-[1-9]\d*-[12]\d{3}$`
+
+### nonEmptyText
+
+Provision text. Must contain at least one non-whitespace character. An empty string is rejected: Article 11 published a blank body for two years because nothing checked this.
+
+Type: `string` — pattern `\S`, min length 1
+
+### provenance
+
+Records text that entered the constitution outside the amendment process. Its purpose is to preserve a half-amended state rather than erase it: an edit with no enacting instrument must be visible, not silently normalised.
+
+| Key | Type | Required | Notes |
+|---|---|---|---|
+| `applied_outside_process` | `boolean` | no | True when this text was hand-applied with no recorded amendment. |
+| `matches_act` | [actId](#actid) | no | Act whose prescribed text this current text matches, where one was identified. |
+| `recorded` | `string` (date) | no |  |
+| `note` | `string` | **yes** |  <br><small>min length 1</small> |
+
+### info
+
+| Key | Type | Required | Notes |
+|---|---|---|---|
+| `title` | [nonEmptyText](#nonemptytext) | **yes** |  |
+| `organization` | [nonEmptyText](#nonemptytext) | **yes** | Full legal name of the body the constitution governs. |
+| `jurisdiction` | `string` | no |  |
+| `registration` | `string` | no | Registration identifier under the governing statute. |
+| `version` | [semver](#semver) | **yes** |  |
+| `status` | `current` \| `superseded` | **yes** | Exactly one document in the corpus may be `current`. |
+| `legal_status` | [legalStatus](#legalstatus) | no |  |
+| `adopted_version` | [semver](#semver) | no | The last version the board actually adopted. Required when legal_status is not_adopted. |
+| `text_as_of` | `string` (date) | no | The date the displayed text reflects, which is not the same as the date any instrument took effect. Required when legal_status is not_adopted. |
+| `effective_from` | `string` (date) | no |  |
+| `superseded_by` | [semver](#semver) | no | Version that replaced this one. Required in practice for archived pages, which must name their successor in a visible banner. |
+| `logo` | object | no |  <br><small>no extra keys</small> |
+| `contact` | object | no |  <br><small>no extra keys</small> |
+| `termsOfService` | `string` (uri) | no |  |
+| `license` | `string` | no |  |
+
+**Conditional rules**
+
+- When `legal_status` is `not_adopted`: `adopted_version`, `text_as_of` becomes required. Otherwise `effective_from` is required.
+
+### preamble
+
+| Key | Type | Required | Notes |
+|---|---|---|---|
+| `id` | `"preamble"` | **yes** |  |
+| `title` | [nonEmptyText](#nonemptytext) | **yes** |  |
+| `title_source` | [titleSource](#titlesource) | no |  |
+| `content` | [nonEmptyText](#nonemptytext) | **yes** |  |
+| `adopted` | `string` | no |  |
+| `amended_by` | array of [actId](#actid) | no |  |
+| `provenance` | [provenance](#provenance) | no |  |
+
+### provisionStatus
+
+`active` (default when absent) carries text. `reserved` holds a number that no provision occupies — this is how a statute book represents a gap without renumbering. `omitted` marks a provision repealed by an Act; its number is never reused.
+
+Type: `active` \| `omitted` \| `reserved`
+
+### article
+
+| Key | Type | Required | Notes |
+|---|---|---|---|
+| `id` | `string` | **yes** | Permanent citation identifier and public URL anchor. Treat as a public API: never regenerate, never derive from array position. <br><small>pattern `^art-[1-9]\d*$`</small> |
+| `number` | `integer` | **yes** | The number the Acts cite. Explicit, never derived from index. Article 21 is `number: 21` even when it is the 20th element of the list. <br><small>min 1</small> |
+| `title` | [nonEmptyText](#nonemptytext) | **yes** |  |
+| `title_source` | [titleSource](#titlesource) | no |  |
+| `content` | [nonEmptyText](#nonemptytext) | no |  |
+| `status` | [provisionStatus](#provisionstatus) | no |  |
+| `note` | `string` | no | Required for `reserved`/`omitted`: why this number carries no text. <br><small>min length 1</small> |
+| `amended_by` | array of [actId](#actid) | no |  |
+| `provenance` | [provenance](#provenance) | no |  |
+| `sections` | array of [section](#section) | no |  <br><small>min items 1</small> |
+
+**Conditional rules**
+
+- When `status` is `reserved` or `omitted`: `note` becomes required; `content` must be absent; `sections` must be absent. Otherwise at least one of `content` or `sections` is required.
+
+### section
+
+| Key | Type | Required | Notes |
+|---|---|---|---|
+| `id` | `string` | **yes** | Permanent citation identifier, e.g. art-6-s-1. Must agree with the parent article's number and this section's number; validate.mjs enforces the relationship. <br><small>pattern `^art-[1-9]\d*-s-[1-9]\d*$`</small> |
+| `number` | `integer` | **yes** |  <br><small>min 1</small> |
+| `title` | [nonEmptyText](#nonemptytext) | **yes** |  |
+| `title_source` | [titleSource](#titlesource) | no |  |
+| `content` | [nonEmptyText](#nonemptytext) | no |  |
+| `status` | [provisionStatus](#provisionstatus) | no |  |
+| `note` | `string` | no |  <br><small>min length 1</small> |
+| `amended_by` | array of [actId](#actid) | no |  |
+| `provenance` | [provenance](#provenance) | no |  |
+
+**Conditional rules**
+
+- When `status` is `reserved` or `omitted`: `note` becomes required; `content` must be absent. Otherwise `content` is required.
+
+### actRegister
+
+| Key | Type | Required | Notes |
+|---|---|---|---|
+| `acts` | array of [act](#act) | **yes** |  <br><small>min items 1</small> |
+
+### act
+
+| Key | Type | Required | Notes |
+|---|---|---|---|
+| `id` | [actId](#actid) | **yes** |  |
+| `number` | `integer` | **yes** |  <br><small>min 1</small> |
+| `year` | `integer` | **yes** |  <br><small>min 1900</small> |
+| `title` | [nonEmptyText](#nonemptytext) | **yes** |  |
+| `short_title` | `string` | no |  |
+| `application_status` | `applied` \| `partially-applied` \| `pending` | no | How much of this Act the current constitution reflects. Observed state, not a legal determination: `provisions` records only what has been reconciled, and anything held is named in the constitution's `reconciliation_state`. |
+| `assent_date` | `string` (date) | **yes** | Date of assent, as stated on the face of the instrument. |
+| `passed_date` | `string` (date) | no | Date of passage, a distinct event from assent. One field cannot hold both. |
+| `assented_by` | `string` | no |  |
+| `signed_by` | `string` | no | Who signed the instrument, as printed on it. |
+| `moved_by` | `string` | no | Who moved the Act. Leave unset rather than guessing. |
+| `unverified_attribution` | `string` | no | An attribution recorded elsewhere but unsupported by the face of the instrument. Preserved rather than deleted or promoted, pending confirmation. |
+| `drafting_discrepancy` | array of object | no | Where an Act contradicts itself. Recorded, never silently normalised: a reader must be able to see that the instrument disagrees with itself and which text governs. |
+| `procedure` | object | no | The approval chain the constitution required when the Act was passed. Left explicit and unpopulated where the evidence has not been located: an empty chain of authority is visible, a missing field is not. <br><small>no extra keys</small> |
+| `pdf` | `string` | **yes** | Repository-relative path. validate.mjs fails the build if the file is absent from disk. |
+| `source_text` | `string` | no | Repository-relative path to the extracted plain text, so every assertion below is diffable against a source in the repo. |
+| `amends` | array of `string` | no | Provision ids this Act touches. Every entry must resolve against the constitution. |
+| `provisions` | array of object | no |  |
+
+### reconciliationState
+
+Declares that this document does not yet reflect every instrument that amends it. Rendered as a visible banner on every page; the banner is generated from this block and is never hardcoded, so it cannot fall out of date with the document it describes.
+
+| Key | Type | Required | Notes |
+|---|---|---|---|
+| `target_version` | [semver](#semver) | **yes** | The version this document becomes once reconciliation completes. |
+| `complete` | `boolean` | **yes** |  |
+| `applied` | array of `string` | no | Instruments reflected in this text, annotated where only partly so. |
+| `held` | array of object | no | What is not yet applied and why. Naming the blocker is the point: an unreconciled state that does not say what it is waiting for is indistinguishable from an oversight. |
+
+### titleSource
+
+Whether this heading carries legal force. `enacted` means the title appears as a heading in an instrument already applied to this provision. `editorial` means an editor supplied it — Act 1 titles Article 11's clause (2) `Establishment` but gives clause (1) no title at all, and the lowercase `units` above it is editorial. Optional in the schema so frozen archives stay valid unedited; validate.mjs requires it on the current document.
+
+Type: `enacted` \| `editorial`
+
+### legalStatus
+
+Whether the board has adopted the text as published at `version`. `not_adopted` means the version string is a working publication label and NOT an assertion about what is in force; the document must then declare `adopted_version` and `text_as_of`, and the renderer must lead with the adopted position rather than the label. Optional in the schema so frozen archives stay valid unedited; validate.mjs requires it on the current document.
+
+Type: `adopted` \| `not_adopted`
+
+## Validation beyond the schema
+
+`npm run validate` enforces relational rules a JSON Schema cannot express. Each fails the build:
+
+| Check | Rule |
+|---|---|
+| `id-duplicate` | Every provision id is unique across the document |
+| `id-number-mismatch` | An article id must be `art-<number>`; a section id `art-<article>-s-<number>` |
+| `number-gap` | Article numbering is dense from 1; a gap is legal only where a `reserved` or `omitted` entry occupies it |
+| `number-duplicate` | No number is used twice |
+| `act-reference-unresolved` | Every `amended_by`, `act.amends` and `provisions[].target` resolves |
+| `act-file-missing` | Every `pdf` and `source_text` exists on disk |
+| `sor-as-authority` | No provision cites a Statement of Objects and Reasons as its authority |
+| `archive-version-mismatch` | An archived file's `info.version` matches its filename |
+| `archive-status` | An archived file declares `status: superseded` |
+| `archive-shadows-current` | No archived version duplicates the current version |
+| `current-count` | Exactly one document is `current` |
+| `placeholder-url` | No `example.com` URL in `info` |
+| `anchor-unresolved` | No template links to an anchor no provision produces |
diff --git a/schema/opencodelaw-1.0.schema.json b/schema/opencodelaw-1.0.schema.json
new file mode 100644
index 0000000..139fd05
--- /dev/null
+++ b/schema/opencodelaw-1.0.schema.json
@@ -0,0 +1,743 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://constitution.stmorg.in/schema/opencodelaw-1.0.schema.json",
+  "title": "OpenCodeLaw 1.0",
+  "description": "Machine-readable organizational constitution with permanent citation identifiers. Root key is `opencodelaw`, resolving the historical three-way disagreement between the docs (`OpenCodeLaw`), the specs (`openconstitution`) and the renderer (`ammendments`). The amendment register is a separate document; see $defs/actRegister.",
+  "type": "object",
+  "required": [
+    "opencodelaw",
+    "info",
+    "preamble",
+    "articles"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "opencodelaw": {
+      "const": "1.0",
+      "description": "Schema version. Quoted so YAML does not coerce it to a float."
+    },
+    "info": {
+      "$ref": "#/$defs/info"
+    },
+    "preamble": {
+      "$ref": "#/$defs/preamble"
+    },
+    "articles": {
+      "type": "array",
+      "minItems": 1,
+      "description": "Order is presentational only. Identity comes from `id`/`number`, never from array position, so reordering this list changes no citation and no anchor.",
+      "items": {
+        "$ref": "#/$defs/article"
+      }
+    },
+    "reconciliation_state": {
+      "$ref": "#/$defs/reconciliationState"
+    }
+  },
+  "$defs": {
+    "semver": {
+      "type": "string",
+      "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$",
+      "description": "Semantic version. A prerelease suffix is how a document states that it is mid-reconciliation: 3.0.0-alpha.1 is not 3.0.0."
+    },
+    "actId": {
+      "type": "string",
+      "pattern": "^act-[1-9]\\d*-[12]\\d{3}$",
+      "description": "Stable Act identifier: act-<number>-<year>, e.g. act-1-2024."
+    },
+    "nonEmptyText": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "\\S",
+      "description": "Provision text. Must contain at least one non-whitespace character. An empty string is rejected: Article 11 published a blank body for two years because nothing checked this."
+    },
+    "provenance": {
+      "type": "object",
+      "description": "Records text that entered the constitution outside the amendment process. Its purpose is to preserve a half-amended state rather than erase it: an edit with no enacting instrument must be visible, not silently normalised.",
+      "required": [
+        "note"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "applied_outside_process": {
+          "type": "boolean",
+          "description": "True when this text was hand-applied with no recorded amendment."
+        },
+        "matches_act": {
+          "$ref": "#/$defs/actId",
+          "description": "Act whose prescribed text this current text matches, where one was identified."
+        },
+        "recorded": {
+          "type": "string",
+          "format": "date"
+        },
+        "note": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "info": {
+      "type": "object",
+      "required": [
+        "title",
+        "organization",
+        "version",
+        "status"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "title": {
+          "$ref": "#/$defs/nonEmptyText"
+        },
+        "organization": {
+          "$ref": "#/$defs/nonEmptyText",
+          "description": "Full legal name of the body the constitution governs."
+        },
+        "jurisdiction": {
+          "type": "string"
+        },
+        "registration": {
+          "type": "string",
+          "description": "Registration identifier under the governing statute."
+        },
+        "version": {
+          "$ref": "#/$defs/semver"
+        },
+        "status": {
+          "enum": [
+            "current",
+            "superseded"
+          ],
+          "description": "Exactly one document in the corpus may be `current`."
+        },
+        "legal_status": {
+          "$ref": "#/$defs/legalStatus"
+        },
+        "adopted_version": {
+          "$ref": "#/$defs/semver",
+          "description": "The last version the board actually adopted. Required when legal_status is not_adopted."
+        },
+        "text_as_of": {
+          "type": "string",
+          "format": "date",
+          "description": "The date the displayed text reflects, which is not the same as the date any instrument took effect. Required when legal_status is not_adopted."
+        },
+        "effective_from": {
+          "type": "string",
+          "format": "date"
+        },
+        "superseded_by": {
+          "$ref": "#/$defs/semver",
+          "description": "Version that replaced this one. Required in practice for archived pages, which must name their successor in a visible banner."
+        },
+        "logo": {
+          "type": "object",
+          "required": [
+            "url",
+            "alt"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "url": {
+              "type": "string",
+              "format": "uri"
+            },
+            "alt": {
+              "type": "string"
+            }
+          }
+        },
+        "contact": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "url": {
+              "type": "string",
+              "format": "uri"
+            },
+            "email": {
+              "type": "string",
+              "format": "email"
+            }
+          }
+        },
+        "termsOfService": {
+          "type": "string",
+          "format": "uri"
+        },
+        "license": {
+          "type": "string"
+        }
+      },
+      "allOf": [
+        {
+          "$comment": "An unadopted document must say what WAS adopted and what the text reflects. An adopted one must state the date it took effect.",
+          "if": {
+            "properties": {
+              "legal_status": {
+                "const": "not_adopted"
+              }
+            },
+            "required": [
+              "legal_status"
+            ]
+          },
+          "then": {
+            "required": [
+              "adopted_version",
+              "text_as_of"
+            ]
+          },
+          "else": {
+            "required": [
+              "effective_from"
+            ]
+          }
+        }
+      ]
+    },
+    "preamble": {
+      "type": "object",
+      "required": [
+        "id",
+        "title",
+        "content"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "const": "preamble"
+        },
+        "title": {
+          "$ref": "#/$defs/nonEmptyText"
+        },
+        "title_source": {
+          "$ref": "#/$defs/titleSource"
+        },
+        "content": {
+          "$ref": "#/$defs/nonEmptyText"
+        },
+        "adopted": {
+          "type": "string"
+        },
+        "amended_by": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/actId"
+          }
+        },
+        "provenance": {
+          "$ref": "#/$defs/provenance"
+        }
+      }
+    },
+    "provisionStatus": {
+      "enum": [
+        "active",
+        "omitted",
+        "reserved"
+      ],
+      "description": "`active` (default when absent) carries text. `reserved` holds a number that no provision occupies \u2014 this is how a statute book represents a gap without renumbering. `omitted` marks a provision repealed by an Act; its number is never reused."
+    },
+    "article": {
+      "type": "object",
+      "required": [
+        "id",
+        "number",
+        "title"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^art-[1-9]\\d*$",
+          "description": "Permanent citation identifier and public URL anchor. Treat as a public API: never regenerate, never derive from array position."
+        },
+        "number": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "The number the Acts cite. Explicit, never derived from index. Article 21 is `number: 21` even when it is the 20th element of the list."
+        },
+        "title": {
+          "$ref": "#/$defs/nonEmptyText"
+        },
+        "title_source": {
+          "$ref": "#/$defs/titleSource"
+        },
+        "content": {
+          "$ref": "#/$defs/nonEmptyText"
+        },
+        "status": {
+          "$ref": "#/$defs/provisionStatus"
+        },
+        "note": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Required for `reserved`/`omitted`: why this number carries no text."
+        },
+        "amended_by": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/actId"
+          }
+        },
+        "provenance": {
+          "$ref": "#/$defs/provenance"
+        },
+        "sections": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/$defs/section"
+          }
+        }
+      },
+      "allOf": [
+        {
+          "$comment": "A reserved or omitted article carries a note instead of text. Every other article must carry text somewhere: its own body, or at least one section. An article consisting only of sections is legitimate \u2014 Act 1 substitutes Article 10 as a heading followed directly by clauses (1)-(3), supplying no article-level body at all. An empty-string `content` remains an error in every case; that is the defect that published Article 11 blank.",
+          "if": {
+            "properties": {
+              "status": {
+                "enum": [
+                  "reserved",
+                  "omitted"
+                ]
+              }
+            },
+            "required": [
+              "status"
+            ]
+          },
+          "then": {
+            "required": [
+              "note"
+            ],
+            "properties": {
+              "content": false,
+              "sections": false
+            }
+          },
+          "else": {
+            "anyOf": [
+              {
+                "required": [
+                  "content"
+                ]
+              },
+              {
+                "required": [
+                  "sections"
+                ]
+              }
+            ]
+          }
+        }
+      ]
+    },
+    "section": {
+      "type": "object",
+      "required": [
+        "id",
+        "number",
+        "title"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^art-[1-9]\\d*-s-[1-9]\\d*$",
+          "description": "Permanent citation identifier, e.g. art-6-s-1. Must agree with the parent article's number and this section's number; validate.mjs enforces the relationship."
+        },
+        "number": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "title": {
+          "$ref": "#/$defs/nonEmptyText"
+        },
+        "title_source": {
+          "$ref": "#/$defs/titleSource"
+        },
+        "content": {
+          "$ref": "#/$defs/nonEmptyText"
+        },
+        "status": {
+          "$ref": "#/$defs/provisionStatus"
+        },
+        "note": {
+          "type": "string",
+          "minLength": 1
+        },
+        "amended_by": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/actId"
+          }
+        },
+        "provenance": {
+          "$ref": "#/$defs/provenance"
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "status": {
+                "enum": [
+                  "reserved",
+                  "omitted"
+                ]
+              }
+            },
+            "required": [
+              "status"
+            ]
+          },
+          "then": {
+            "required": [
+              "note"
+            ],
+            "properties": {
+              "content": false
+            }
+          },
+          "else": {
+            "required": [
+              "content"
+            ]
+          }
+        }
+      ]
+    },
+    "actRegister": {
+      "$comment": "Root schema for acts/register.yaml. Validated separately by validate.mjs, versioned in this file so the register and the constitution cannot drift apart.",
+      "type": "object",
+      "required": [
+        "acts"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "acts": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/$defs/act"
+          }
+        }
+      }
+    },
+    "act": {
+      "type": "object",
+      "required": [
+        "id",
+        "number",
+        "year",
+        "title",
+        "assent_date",
+        "pdf"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/actId"
+        },
+        "number": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "year": {
+          "type": "integer",
+          "minimum": 1900
+        },
+        "title": {
+          "$ref": "#/$defs/nonEmptyText"
+        },
+        "short_title": {
+          "type": "string"
+        },
+        "application_status": {
+          "enum": [
+            "applied",
+            "partially-applied",
+            "pending"
+          ],
+          "description": "How much of this Act the current constitution reflects. Observed state, not a legal determination: `provisions` records only what has been reconciled, and anything held is named in the constitution's `reconciliation_state`."
+        },
+        "assent_date": {
+          "type": "string",
+          "format": "date",
+          "description": "Date of assent, as stated on the face of the instrument."
+        },
+        "passed_date": {
+          "type": "string",
+          "format": "date",
+          "description": "Date of passage, a distinct event from assent. One field cannot hold both."
+        },
+        "assented_by": {
+          "type": "string"
+        },
+        "signed_by": {
+          "type": "string",
+          "description": "Who signed the instrument, as printed on it."
+        },
+        "moved_by": {
+          "type": "string",
+          "description": "Who moved the Act. Leave unset rather than guessing."
+        },
+        "unverified_attribution": {
+          "type": "string",
+          "description": "An attribution recorded elsewhere but unsupported by the face of the instrument. Preserved rather than deleted or promoted, pending confirmation."
+        },
+        "drafting_discrepancy": {
+          "type": "array",
+          "description": "Where an Act contradicts itself. Recorded, never silently normalised: a reader must be able to see that the instrument disagrees with itself and which text governs.",
+          "items": {
+            "type": "object",
+            "required": [
+              "provision",
+              "operative",
+              "note"
+            ],
+            "additionalProperties": false,
+            "properties": {
+              "provision": {
+                "type": "string"
+              },
+              "operative": {
+                "type": "string",
+                "description": "The enacted text, which governs."
+              },
+              "operative_source_lines": {
+                "type": "string"
+              },
+              "statement_of_objects": {
+                "type": "string",
+                "description": "The conflicting explanatory text, which does not govern."
+              },
+              "statement_source_lines": {
+                "type": "string"
+              },
+              "note": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "procedure": {
+          "type": "object",
+          "description": "The approval chain the constitution required when the Act was passed. Left explicit and unpopulated where the evidence has not been located: an empty chain of authority is visible, a missing field is not.",
+          "additionalProperties": false,
+          "properties": {
+            "required_by": {
+              "type": "string",
+              "description": "Provision id of the amendment procedure in force at the time."
+            },
+            "approvals": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": [
+                  "body"
+                ],
+                "additionalProperties": false,
+                "properties": {
+                  "body": {
+                    "type": "string"
+                  },
+                  "date": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "evidence": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "description": "Link or reference to the minutes recording this approval."
+                  },
+                  "approved": {
+                    "type": "boolean",
+                    "description": "Recorded as approving. Absent means not recorded, which is not the same as not approved."
+                  }
+                }
+              }
+            },
+            "attested_by": {
+              "type": "string"
+            },
+            "assent_date": {
+              "type": "string",
+              "format": "date"
+            },
+            "complete": {
+              "type": "boolean",
+              "description": "Whether every body the procedure required has been recorded as approving. Never inferred from a partial chain."
+            },
+            "note": {
+              "type": "string"
+            }
+          }
+        },
+        "pdf": {
+          "type": "string",
+          "description": "Repository-relative path. validate.mjs fails the build if the file is absent from disk."
+        },
+        "source_text": {
+          "type": "string",
+          "description": "Repository-relative path to the extracted plain text, so every assertion below is diffable against a source in the repo."
+        },
+        "amends": {
+          "type": "array",
+          "description": "Provision ids this Act touches. Every entry must resolve against the constitution.",
+          "items": {
+            "type": "string"
+          }
+        },
+        "provisions": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "target",
+              "operation",
+              "scope"
+            ],
+            "additionalProperties": false,
+            "properties": {
+              "target": {
+                "type": "string",
+                "description": "Provision id, e.g. art-6-s-1 or `preamble`. Must resolve."
+              },
+              "operation": {
+                "enum": [
+                  "substitute",
+                  "insert",
+                  "omit",
+                  "renumber"
+                ]
+              },
+              "scope": {
+                "enum": [
+                  "article",
+                  "clause"
+                ],
+                "description": "Read from the instrument, not from its heading: an Act that restates the article's own heading followed by a complete clause run substitutes the whole article; an Act whose heading names clauses, and sets out only those, amends only them."
+              },
+              "clauses": {
+                "type": "string",
+                "description": "Which clauses the Act names, e.g. \"1,2,3,4,5\". Required for clause scope, so a targeted amendment can never be recorded without saying what it targets."
+              },
+              "source_lines": {
+                "type": "string",
+                "description": "Line range in source_text supporting this assertion, e.g. \"18-33\"."
+              },
+              "note": {
+                "type": "string"
+              }
+            },
+            "allOf": [
+              {
+                "if": {
+                  "properties": {
+                    "scope": {
+                      "const": "clause"
+                    }
+                  },
+                  "required": [
+                    "scope"
+                  ]
+                },
+                "then": {
+                  "required": [
+                    "clauses"
+                  ]
+                }
+              }
+            ]
+          }
+        }
+      }
+    },
+    "reconciliationState": {
+      "type": "object",
+      "description": "Declares that this document does not yet reflect every instrument that amends it. Rendered as a visible banner on every page; the banner is generated from this block and is never hardcoded, so it cannot fall out of date with the document it describes.",
+      "required": [
+        "target_version",
+        "complete"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "target_version": {
+          "$ref": "#/$defs/semver",
+          "description": "The version this document becomes once reconciliation completes."
+        },
+        "complete": {
+          "type": "boolean"
+        },
+        "applied": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Instruments reflected in this text, annotated where only partly so."
+        },
+        "held": {
+          "type": "array",
+          "description": "What is not yet applied and why. Naming the blocker is the point: an unreconciled state that does not say what it is waiting for is indistinguishable from an oversight.",
+          "items": {
+            "type": "object",
+            "required": [
+              "provisions",
+              "blocked_by"
+            ],
+            "additionalProperties": false,
+            "properties": {
+              "provisions": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "blocked_by": {
+                "oneOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  }
+                ]
+              },
+              "note": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    },
+    "titleSource": {
+      "enum": [
+        "enacted",
+        "editorial"
+      ],
+      "description": "Whether this heading carries legal force. `enacted` means the title appears as a heading in an instrument already applied to this provision. `editorial` means an editor supplied it \u2014 Act 1 titles Article 11's clause (2) `Establishment` but gives clause (1) no title at all, and the lowercase `units` above it is editorial. Optional in the schema so frozen archives stay valid unedited; validate.mjs requires it on the current document."
+    },
+    "legalStatus": {
+      "enum": [
+        "adopted",
+        "not_adopted"
+      ],
+      "description": "Whether the board has adopted the text as published at `version`. `not_adopted` means the version string is a working publication label and NOT an assertion about what is in force; the document must then declare `adopted_version` and `text_as_of`, and the renderer must lead with the adopted position rather than the label. Optional in the schema so frozen archives stay valid unedited; validate.mjs requires it on the current document."
+    }
+  }
+}
diff --git a/specs/v1.yaml b/specs/v1.yaml
deleted file mode 100644
index 71cff0a..0000000
--- a/specs/v1.yaml
+++ /dev/null
@@ -1,302 +0,0 @@
-openconstitution: 1.0.0
-info:
-  title: SERVICE TO MANKIND
-  termsOfService: https://example.com/terms
-  logo:
-    url: https://stmorg.in/accesories/service_to_man_kind-20200709-0001.jpg
-    alt: Logo
-  contact:
-    name: Pranay Kiran
-    url: https://example.com/contact
-    email: pranay@stmorg.in
-  license: MIT
-  version: 2.0.0
-preamble:
-  title: PREAMBLE
-  content: |
-    Service to Mankind is a Non-Governmental Organization (NGO) registered under Telangana Societies Registration Act., 2001 that was started to create a platform for students who are
-    intent on doing their bit towards the betterment of society. Service to Mankind is a platform for the students to serve the society and to inculcate a sense of social responsibility in them.
-  adopted: 2023-10-08T20:20:00+05:30
-articles:
-  - title: Name of the Organization
-    content: |
-      The name of the organization shall be Service to Mankind (hereinafter referred to as
-      "the NGO").The acronym that might be used to refer to the NGO will be STM.
-      The Registered Office of the Society shall be STM India Headquarters, Ft No. 25/24, Bowrampet, 500043, Hyderabad, Telangana
-      will operate anywhere.
-  - title: Interpretations/Definitions
-    content: |
-      In this Constitution, unless the context otherwise requires:
-      1. "Act" means the Telangana Societies Registration Act., 2001.
-      2. "Board" means the Board Members of the NGO.
-      3. "Constitution" means the Constitution of the NGO.
-      4. "Executive Committee" means the Executive Committee of the NGO.
-      5. "College Unit" means the College Unit of the NGO.
-      6. "Member" means a member of the NGO.
-      7. "NGO" means the Service to Mankind.
-      8. "Office" means the Registered Office of the NGO.
-      9. "President" means the President of the NGO.
-      10. "Secretary" means the Secretary of the NGO.
-      11. "Treasurer" means the Treasurer of the NGO.
-      12. "Trustee" means a Trustee of the NGO.
-      13. "Vice President" means the Vice President of the NGO.
-      14. "Year" means the financial year of the NGO.
-      15. "IBM" means the Intermediate Board Members of the NGO.
-      16. "STM" means the Service to Mankind.
-  - title: Aims and Objectives
-    content: |
-      The NGO has been established to create a platform for the students who are intent on doing
-      their bit towards the betterment of society with the objective of helping the underprivileged
-      and the destitute in any and every way possible.
-  - title: Mission Statement
-    content: |
-      The mission of the NGO is to provide a platform for the students to serve the society and
-      to inculcate a sense of social responsibility in them.
-  - title: Vision Statement
-    content: |
-      The vision of the NGO is to create a society where everyone has access to basic amenities
-      and to create a society where everyone is treated equally.
-  - title: STM Roles
-    content: |
-      The membership of the NGO shall be open to all the students of the college who are willing to
-      serve the society and who are willing to abide by the rules and regulations of the NGO.
-    sections:
-      - title: Board Member
-        content: |
-          Any person who is willing to serve the society and who is willing to abide by the rules and regulations of the NGO to serve the STM for the lifetime and manage every thing in the STM.
-      - title: Intermediate Board Member
-        content: |
-          Any person who is willing to serve the society and who is willing to abide by the rules and regulations of the NGO to serve the STM for the lifetime and manage every thing in the STM under the board.
-      - title: College Unit Board Member
-        content: |
-          Any person who is willing to serve the society and who is willing to abide by the rules and regulations of the NGO to serve the STM in thier respective college unit within thier academic life.
-      - title: Coordinator
-        content: |
-          Any person who is willing to serve the society and who is willing to abide by the rules and regulations of the NGO to serve and work for the STM after the successfull interview.
-      - title: Volunteer
-        content: |
-          Any person who is willing to serve the society and who is willing to abide by the rules and regulations of the NGO to do service on thier will.
-      - title: Donor
-        content: |
-          Any person who agrees to donate a certain amount of money to the NGO is eligible to become a donor.
-  - title: Membership
-    content: |
-      1. A person who has been recruited into the organization on follow of process as per Organization rules and regulations and is duly appointed by STM as such for any of the college units or works for the NGO in certain form shall be called as an STM ‘Member’..
-      2. A person who has registered online in the STM website and admitted in the NGO through a confirmation email and according to its regulations continues to be a member of the NGO.
-      3. An applicant can only be a member if appointed through the recruitment process by the competent authority as may be defined by society from time to time via the Board.
-      4. Any person who donates atleast INR 30 (Rupees Thirty Only) shall be a ‘Donor Member’ of STM, however, a Donor Member is not an official STM ‘Member’ and does not work for the organization.
-      5. Eligibility of membership
-          * (a)The following shall be eligible for membership in the society:-
-            1. The applicant will strive to work for the achievement of the objectives of the society.
-            2. The applicant shall abide by the Rules and Regulations of the Society.
-            3. They shall maintain good moral conduct and behavior.
-      6. Termination of membership
-          * (a)The membership of a member shall be terminated if he/she:
-              1. Resigns from the membership of the society.
-              2. Is found to be of unsound mind by a competent court.
-              3. Is convicted of any offence involving moral turpitude.
-              4. On the death of any member.
-              5. If they are expelled from the society \
-                  (a) for misconduct \
-                  (b) for insubordination \
-                  (c) due to non-performance 
-              6. If found inactive or nonperforming, the member would be termed as inactive
-              member in writing, the member is put under a performance plan by giving
-              due notice of 3 months’ time from the date of declaration in writing to
-              perform their duties at a satisfactory level, failing which the membership of
-              an individual shall be terminated..
-          * (b)The authority to terminate or revoke the status of a member shall be vested with the Board for all members. 
-          Intermediate board can terminate or revoke the membership of a member for college units. 
-          Head of the college units can terminate or revoke the membership of a member within the college unit.
-  - title: Internship
-    content: |
-      Internship is a program where the students of the college are given an opportunity to work for the NGO and to learn the working of the NGO as a coordinator in respective collage unit.
-    sections:
-      - title: Stipend
-        content: |
-          There is no stipend for the internship program. But the interns will be provided with the certificate of internship in thier respective college units.
-      - title: Duration
-        content: |
-          The duration of the internship program is 3 academic years.
-      - title: Eligibility
-        content: |
-          Any student who is willing to serve the society and who is willing to abide by the rules and regulations of the NGO is eligible to become an intern according to the article 7 of the constitution.
-      - title: Selection Process
-        content: |
-          The selection process for the internship program is as follows:
-          1. The student should fill the application form for the internship program.
-          2. The student should attend the interview conducted by the college board.
-          3. The student should be selected by the board.
-      - title: Roles and Responsibilities
-        content: |
-          All the interns should abide by the rules and regulations of the NGO. The interns should work for the NGO in thier respective departments and should work for the betterment of the society.
-  - title: Board Members
-    content: |
-      The board members are the members who are selected by the board of the NGO to manage the NGO and to take care of the NGO.
-      They are responsible for the all legal and financial activities of the NGO.
-      The board consists of the following members:
-      1. President
-      2. Vice President
-      3. General Secretary
-      4. Joint Secretary
-      5. Treasurer
-      6. Executive Members
-
-      The board members are selected by the board of the NGO.
-    sections:
-      - title: Eligibility
-        content: |
-          Any member who is extremely active and has been working for the NGO for selfless service and who is willing to abide by the rules and regulations of the NGO is eligible to become a board member.
-      - title: Selection Process
-        content: |
-          The selection process for the board members is as follows:
-          1. The member should fill the application form for the board member.
-          2. The member should attend the interview conducted by the board.
-          3. The member should be selected by the board.
-      - title: Roles and Responsibilities
-        content: |
-          All the board members should abide by the rules and regulations of the NGO and work according to the constitution of the NGO and by-laws of the NGO.
-          The board members are responsible for the all legal and financial activities of the NGO.
-          The board members are responsible for the all activities of the NGO.
-  - title: Intermediate Board Members
-    content: |
-      The IBM are the members who are selected by the board of the NGO to manage the NGO and to take care of the NGO.
-      They are responsible for the all legal and financial activities of the NGO.
-      The IBM consists of the following members:
-        1. HR & Internshipment Controller Coordinator
-        2. Finance Controller Coordinator
-        3. Designing Coordinator
-        4. Public Relations Coordinator
-        5. Technical Coordinator
-        6. Internal Compliance Coordinator
-        7. Operations Coordinator
-        8. Content Coordinator
-        9. Volunteer Coordinator
-    sections:
-      - title: Eligibility
-        content: |
-          Any member who is extremely active and has been working for the NGO for selfless service and who is willing to abide by the rules and regulations of the NGO is eligible to become a IBM.
-      - title: Selection Process
-        content: |
-          The selection process for the IBM is as follows:
-          1. The member should fill the application form for the IBM.
-          2. The member should attend the interview conducted by the board.
-          3. The member should be selected by the board.
-      - title: Roles and Responsibilities
-        content: |
-          All the IBM should abide by the rules and regulations of the NGO and work according to the constitution. \
-          The IMB members responsibilities are as follows:
-            1. HR & Internshipment Controller Coordinator
-            HR & Internshipment Controller Coordinator are responsible for the all activities of the recruitment process and internship program. They are responsible for the all recruitment activities of the college units.
-            2. Finance Controller Coordinator
-            Finance Controller Coordinator are responsible for the all financial activities of the NGO. They are responsible for the all financial activities of the college units.
-            They need to maintain the accounts of the NGO of all the college units and need to submit the accounts to the board.4
-            Annual report of the accounts of the NGO should be submitted to the board.
-            3. Designing Coordinator
-            Designing Coordinator are responsible for the all designing activities of the NGO. They are responsible for the all designing activities of the college units.
-            They are responsible for the all designing activities of the NGO and maintain high quality of the designing in the NGO.
-            4. Public Relations Coordinator
-            Public Relations Coordinator are responsible for the all public relations activities of the NGO. They are responsible for the all public relations activities of the college units.
-            They are responsible for the all public relations activities of the NGO and maintain high quality of the public relations in the NGO.
-            5. Technical Coordinator
-            Technical Coordinator are responsible for the all technical activities of the NGO. They are responsible for the all technical activities of the college units.
-            They must maintain the website of the NGO and maintain high quality of the technical activities in the NGO.
-            They promote the open source technologies in the NGO.
-            6. Internal Compliance Coordinator
-            Internal Compliance Coordinator are responsible for the all internal compliance activities of the NGO. They are responsible for the all internal compliance activities of the college units.
-            They can take any action on any member of the NGO if they are not following the rules and regulations of the NGO and constitution of the NGO including the board members.
-            7. Operations Coordinator
-            Operations Coordinator are responsible for the all operations activities of the NGO. They are responsible for the all operations activities of the college units.
-            They are responsible for the all operations activities of the NGO and maintain high quality of the operations in the NGO.
-            8. Content Coordinator
-            Content Coordinator are responsible for the all content activities of the NGO. They are responsible for the all content activities of the college units.
-            They are responsible for the all content activities of the NGO and maintain high quality of the content in the NGO.
-            9. Volunteer Coordinator
-            Volunteer Coordinator are responsible for the all volunteer activities of the NGO. They are responsible for the all volunteer activities of the college units.
-            They are responsible for the all volunteer activities of the NGO and maintain high quality of the volunteer activities in the NGO.
-
-  - title: College Units
-    content: |
-      The college units are the units of the NGO which are established in the colleges to manage the NGO and to take care of the NGO.
-      The college units consists of the following members:
-      1. Head
-      2. Vice Head
-      3. Management Department Head
-      4. Donations and Finance Department Head
-      5. Technical Department Head
-      6. Content Department Head
-      7. Reseseach and Development Department Head
-      8. Graphics Department Head
-    sections:
-      - title: Establishment
-        content: |
-          To establish a college unit in a college, the following conditions should be satisfied:
-          1. There should be atleast 10 members in the college who are willing to work for the NGO.
-          2. The head of the college unit must consult the board of the NGO and get permission to establish the college unit.
-          3. The head of the college unit must fill the application form for the college unit.
-          4. The head of the college unit must attend the interview conducted by the board.
-          5. The head of the college unit must be selected by the board.
-      - title: Funds
-        content: |
-          All college units should should submit the accounts to the IBM (Finance Coordinator) of the NGO. The college units should get permission from the IBM (Finance Coordinator) or Board (Treasurer) of the NGO to use the funds of the NGO.
-      - title: Roles and Responsibilities
-        content: |
-          All the college units should abide by the rules and regulations of the NGO and work according to the constitution.
-          They can raise funds, and do any activity for the betterment of the society.
-  - title: Alumini
-    content: |
-      Refers to a person who has previously worked with the NGO and has maintained good membership standing.
-  - title: Anual Reports
-    content: |
-      1. All divisions and units must maintain the task reports of all the events taken up during the
-      year, and must submit the reports to the Finance Controller Coordinator of STM at least 2 weeks
-      prior to the AGM
-      2. A detailed annual report of all the events conducted throughout the NGO shall be
-      consolidated and maintained by the Finance Controller Coordinator of STM
-      3. The Annual Report of the NGO must be compulsorily prepared by the Finance Controller
-      of STM by the AGM in the prescribed format mentioned in the Documentation policy
-      4. All the Annual Reports from the inception of the NGO must be maintained in the STM management portal
-  - title: Sabbatical Leave
-    content: |
-      Sabbatical leave is a leave given to the members of the NGO who are working for the NGO for a long time and who are willing to take a break from the NGO for a certain period of time.
-    sections:
-      - title: Eligibility
-        content: |
-          Any member who is working for the NGO for a long time and who is willing to take a break from the NGO for a certain period of time is eligible for the sabbatical leave.
-      - title: Application
-        content: |
-          The member should fill the application form for the sabbatical leave and should submit the application to the board.
-      - title: Duration
-        content: |
-          The duration of the sabbatical leave will be varied from 6 months to 1 year. According to the application of the member.
-  - title: Resignation
-    content: |
-      Resignation is a process where the member of the NGO can leave the NGO if they are not willing to work for the NGO.
-    sections:
-      - title: Eligibility
-        content: |
-          Any member who is not willing to work for the NGO is eligible for the resignation.
-      - title: Application
-        content: |
-          The member should fill the application form for the resignation and should submit the application to the board.
-      - title: Duration
-        content: |
-          The duration of the resignation will be varied from 1 month to 3 months. According to the application of the member.
-  - title: Ammendments
-    content: |
-      1. Any changes to the constitution of the NGO should be done by the board of the NGO.
-      2. The ammenments should be done according to the by-laws of the NGO.
-      3. All the proposed ammendments should be approved by the board of the NGO, intermediate board of the NGO and all college units of the NGO.
-  - title: Dissolution
-    content: |
-      (a). In an event that the NGO fails to function totally and needs to be dissolved, the whole
-      board of the NGO shall be dissolved and a new board shall be elected by the General Body. Else, the whole NGO shall be dissolved. \
-      (b). College Units of the NGO can only be dissolved by the Board of the NGO
-ammendments:
-  - title: Establishing the Constitution
-    content: |
-      Establishing the Constitution
-    archive: /archives/v1
-    act: #
-    date: 2023-10-08T20:20:00+05:30
-    author: Pranay Kiran
\ No newline at end of file
diff --git a/src/act-application.mjs b/src/act-application.mjs
new file mode 100644
index 0000000..67d2539
--- /dev/null
+++ b/src/act-application.mjs
@@ -0,0 +1,102 @@
+/**
+ * How each Act's prescribed text maps onto the constitution's structure.
+ *
+ * Declared explicitly, by line range into the dedented Act span. Two reasons it
+ * is not inferred:
+ *
+ *  - PDF layout indentation is not a structural signal. Inferring from it read
+ *    Article 9's sentences as section titles, collapsed Article 10's three
+ *    clauses into one, and found none of Article 8's five — in both directions,
+ *    from the same heuristic.
+ *  - Provision text is never retyped here. Every string is a slice of
+ *    `acts/text/`, and `verifyCoverage` asserts the slices reconstruct the
+ *    whole span, so no text can be dropped, duplicated or invented.
+ *
+ * Line numbers refer to the dedented span, as printed by `node src/manifest.mjs`.
+ */
+
+import { normalise } from './text-compare.mjs'
+import { dedent } from './manifest.mjs'
+
+/**
+ * `body`      — inclusive [from, to] line range for the article's own text
+ * `sections`  — each with the line range of its text; `titleLine` is the line
+ *               carrying the Act's clause marker and heading
+ */
+export const STRUCTURE = {
+  // --- Act 2 -------------------------------------------------------------
+  preamble: { body: [0, 3], sections: [] },
+  'art-3': { body: [0, 1], sections: [] },
+  'art-4': { body: [0, 1], sections: [] },
+  'art-5': { body: [0, 1], sections: [] },
+
+  'art-8': {
+    body: [0, 2],
+    sections: [
+      { number: 1, titleLine: 3, title: 'Stipend', body: [4, 5] },
+      { number: 2, titleLine: 6, title: 'Duration', body: [7, 7] },
+      { number: 3, titleLine: 8, title: 'Eligibility', body: [9, 10] },
+      { number: 4, titleLine: 12, title: 'Selection Process', body: [13, 16] },
+      { number: 5, titleLine: 17, title: 'Roles and Responsibilities', body: [18, 20] }
+    ]
+  },
+
+  // Act 2 restructures Article 14: one clause, headed. Sabbatical Leave stops
+  // being the article and becomes clause (1) of "Leaves".
+  'art-14': {
+    body: null,
+    sections: [
+      { number: 1, titleLine: 0, title: 'Sabbatical Leave', body: [1, 3] }
+    ]
+  },
+
+  // Act 2 restructures Article 15 from three sections to two. The section ids
+  // survive but change meaning; recorded in RECONCILIATION.md.
+  'art-15': {
+    body: null,
+    sections: [
+      { number: 1, titleLine: 0, title: 'Voluntary', body: [1, 2] },
+      { number: 2, titleLine: 3, title: 'Involuntary', body: [4, 4] }
+    ]
+  },
+
+  'art-20': { body: [0, 3], sections: [] },
+
+  // --- Act 3 -------------------------------------------------------------
+  'art-13': { body: [0, 9], sections: [] },
+  'art-21': { body: [0, 11], sections: [] }
+}
+
+const slice = (lines, range) =>
+  range ? dedent(lines.slice(range[0], range[1] + 1).join('\n')).trim() : null
+
+/** Apply a declared structure to an Act span. Returns { content, sections }. */
+export function shape (target, actText) {
+  const decl = STRUCTURE[target]
+  if (!decl) throw new Error(`no declared structure for ${target}`)
+  const lines = dedent(actText).split('\n')
+  return {
+    content: slice(lines, decl.body),
+    sections: decl.sections.map(s => ({
+      number: s.number,
+      title: s.title,
+      content: slice(lines, s.body)
+    }))
+  }
+}
+
+/**
+ * Every word of the Act span must land somewhere, exactly once.
+ *
+ * Compares the reconstructed provision against the whole span under the
+ * normaliser, which folds enumerators and punctuation — so a clause marker
+ * consumed as a heading still matches. A dropped line, a duplicated one or an
+ * invented phrase all fail here.
+ */
+export function verifyCoverage (target, actText) {
+  const { content, sections } = shape(target, actText)
+  const rebuilt = [content ?? '', ...sections.flatMap(s => [s.title, s.content])].join('\n')
+  const a = normalise(rebuilt)
+  const b = normalise(actText)
+  return { ok: a === b, rebuilt: a, span: b }
+}
diff --git a/src/acts-parse.mjs b/src/acts-parse.mjs
new file mode 100644
index 0000000..4fd7758
--- /dev/null
+++ b/src/acts-parse.mjs
@@ -0,0 +1,125 @@
+/**
+ * Slices the extracted Act text into the provisions each Act enacts.
+ *
+ * Scope follows the rule the drafter already used, confirmed against all three
+ * Acts: a heading naming clauses ("Amendment to Article 6, clause 1,2,3,4 and
+ * 5") amends only those clauses; a heading naming only the article, followed by
+ * the article's own restated heading and a complete clause run, substitutes the
+ * whole article.
+ */
+
+import fs from 'node:fs'
+import path from 'node:path'
+
+/** Page furniture repeated on every page of every Act. Never operative text. */
+const FURNITURE = [
+  /^\s*Flat no:-.*$/gm,
+  /^\s*Website:-.*$/gm,
+  /^\s*Act No\.\s*:.*$/gm
+]
+
+const HEADING = /^\s*(\d+)\s*\.\s*(Amendment\s+(?:to|of)|Insertion\s+of\s+new)\s+(.*?):?\s*$/
+
+export function parseAct (absPath) {
+  // Form feeds mark PDF page breaks. They are not line terminators in JS
+  // regexes, so a clause that happens to start a new page reads as
+  // "\f      (6) ..." and never matches a `^[ \t]*\(` anchor — which silently
+  // dropped Article 7 clause (6) from the analysis entirely.
+  //
+  // Stripped to nothing rather than to a newline: all 11 form feeds in the
+  // corpus sit at a line start, so removing them fixes the anchor while
+  // keeping line numbers identical to the file on disk. Inserting newlines
+  // would shift every subsequent line, and `source_lines` in the act register
+  // is an audit trail a human opens in an editor.
+  let text = fs.readFileSync(absPath, 'utf8').replace(/\f/g, '')
+
+  // The Statement of Objects and Reasons is explanatory, not enacting.
+  const sor = text.search(/STATEMENT\s+OF\s+OBJECTS\s+AND\s+REASONS/i)
+  const statement = sor >= 0 ? text.slice(sor) : ''
+  if (sor >= 0) text = text.slice(0, sor)
+
+  const lines = text.split('\n')
+  const marks = []
+  lines.forEach((line, i) => {
+    const m = line.match(HEADING)
+    if (m) marks.push({ line: i + 1, index: i, kind: m[2], subject: m[3].trim(), raw: line.trim() })
+  })
+
+  const provisions = []
+  for (const [k, mark] of marks.entries()) {
+    const end = k + 1 < marks.length ? marks[k + 1].index : lines.length
+    let body = lines.slice(mark.index + 1, end).join('\n')
+    for (const re of FURNITURE) body = body.replace(re, '')
+
+    const subject = mark.subject
+    const isPreamble = /^preamble/i.test(subject)
+    const artNo = isPreamble ? null : Number(subject.match(/Article\s+(\d+)/i)?.[1])
+    const clauseMatch = subject.match(/clause[s]?\s+([0-9,\s and]+)/i)
+    const inserts = /^Insertion/i.test(mark.kind)
+
+    const { text, restatedTitle } = cleanBody(body, artNo, isPreamble)
+
+    provisions.push({
+      order: mark.line,
+      source_line: mark.line,
+      end_line: end,
+      raw_heading: mark.raw,
+      target: isPreamble ? 'preamble' : `art-${artNo}`,
+      article_number: artNo,
+      operation: inserts ? 'insert' : 'substitute',
+      scope: clauseMatch ? 'clause' : 'article',
+      clauses: clauseMatch ? clauseMatch[1].replace(/\s+and\s+/g, ',').replace(/\s/g, '').replace(/,+/g, ',').replace(/,$/, '') : null,
+      // Title the Act gives the provision: from the heading ("- Exit Process")
+      // or from the article heading the Act restates above its clauses.
+      enacted_title: subject.match(/-\s*(.+)$/)?.[1]?.trim() ?? restatedTitle,
+      text
+    })
+  }
+
+  return { provisions, statement: statement.replace(/\n{3,}/g, '\n\n').trim() }
+}
+
+/**
+ * Drops the article heading the Act restates ("9. Board Members") so the body
+ * compares against the constitution's `content`, which does not repeat its own
+ * title. Collapses the hard line wrapping the PDF layout introduces.
+ */
+export function cleanBody (body, articleNumber, isPreamble = false) {
+  // PDF extraction leaves the odd punctuation-only line; it is never operative.
+  const lines = body.split('\n')
+    .map(l => l.replace(/\s+$/, ''))
+    .filter(l => !/^\s*[.,;:]\s*$/.test(l))
+
+  let restatedTitle = null
+  const firstIdx = lines.findIndex(l => l.trim())
+
+  if (firstIdx >= 0) {
+    const first = lines[firstIdx].trim()
+    if (isPreamble && /^preamble$/i.test(first)) {
+      restatedTitle = first
+      lines.splice(firstIdx, 1)
+    } else if (articleNumber != null) {
+      // Only the article's OWN number counts. Matching any "N." would eat
+      // clause 1 of an Act that numbers its clauses `1.` instead of `(1)`,
+      // which silently deleted the first clause of Articles 20 and 21.
+      const m = first.match(new RegExp(`^${articleNumber}\\s*\\.\\s*(.+)$`))
+      if (m && m[1].length <= 60 && !/\.$/.test(m[1].trim())) {
+        restatedTitle = m[1].trim()
+        lines.splice(firstIdx, 1)
+      }
+    }
+  }
+
+  return {
+    text: lines.join('\n').replace(/\n{3,}/g, '\n\n').trim(),
+    restatedTitle
+  }
+}
+
+export function loadActs (root) {
+  const dir = path.join(root, 'acts/text')
+  return fs.readdirSync(dir).filter(f => f.endsWith('.txt')).sort().map(f => ({
+    file: `acts/text/${f}`,
+    ...parseAct(path.join(dir, f))
+  }))
+}
diff --git a/src/apply-act.mjs b/src/apply-act.mjs
new file mode 100644
index 0000000..7944e1a
--- /dev/null
+++ b/src/apply-act.mjs
@@ -0,0 +1,274 @@
+#!/usr/bin/env node
+/**
+ * Applies one Amendment Act to constitution/current.yaml.
+ *
+ * Every edit is declared here or in act-application.mjs, and every string comes
+ * from `acts/text/` by slice — provision text is never retyped. After writing,
+ * the result is checked three ways:
+ *
+ *   1. the set of provisions that changed equals the set the manifest expects
+ *      for this Act, exactly — nothing outside it may move;
+ *   2. each changed provision matches the Act's prescribed text under the
+ *      normaliser;
+ *   3. every provision the Act does not touch is byte-identical to before.
+ *
+ * Any failure aborts before writing. Usage: node src/apply-act.mjs act-1-2024
+ */
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import yaml from 'js-yaml'
+import { loadActs } from './acts-parse.mjs'
+import { dedent, ACT_ID } from './manifest.mjs'
+import { STRUCTURE, shape, verifyCoverage } from './act-application.mjs'
+import { normalise, similarity } from './text-compare.mjs'
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+const FILE = path.join(ROOT, 'constitution/current.yaml')
+const OPTS = { schema: yaml.CORE_SCHEMA }
+const DUMP = { lineWidth: -1, noRefs: true, quotingType: '"' }
+
+/**
+ * Clause-scope edits: an Act replaces named clauses inside a provision that
+ * stays otherwise intact. Declared as line ranges into the CURRENT text, with
+ * the replacement sliced from the Act.
+ */
+const CLAUSE_EDITS = {
+  // Act 1 substitutes clauses (1)-(5), which are sections here. Clause (6)
+  // Donor is unnamed by the Act and therefore untouched — see Q2.
+  'art-6': { kind: 'sections-from-clauses', firstSection: 1, lastSection: 5 },
+
+  // Act 1 substitutes clause (4) outright, and within clause (6) replaces
+  // sub-clause (a) point 6 and sub-clause (b). Points (a)1-5 are unnamed and
+  // stay. The Act's own Statement of Objects describes exactly this.
+  'art-7': {
+    kind: 'line-splice',
+    edits: [
+      { lines: [3, 3], from: 'clause', clause: 4, prefix: '4. ' },
+      { lines: [19, 23], from: 'sub', clause: 6, marker: /^\s*\(a\)\s*6\.\s*/, prefix: '        6. ' },
+      { lines: [24, 26], from: 'sub', clause: 6, marker: /^\s*\(b\)\s*/, prefix: '    * (b)' }
+    ]
+  },
+
+  // Act 2 substitutes clause 3; clauses 1 and 2 are untouched.
+  'art-16': {
+    kind: 'line-splice',
+    edits: [{ lines: [2, 2], from: 'clause', clause: 3, prefix: '3. ' }]
+  },
+
+  // Act 2 substitutes clause (1), which this article numbers "(a)." — the same
+  // clause, confirmed by its opening words. Clause (b) is untouched.
+  'art-17': {
+    kind: 'line-splice',
+    edits: [{ lines: [0, 1], from: 'clause', clause: 1, prefix: '(a). ' }]
+  }
+}
+
+/** Split an Act span into its top-level `(N)` clauses. */
+function actClauses (text) {
+  const t = dedent(text)
+  const marks = [...t.matchAll(/^[ \t]*\((\d+)\)[ \t]*/gm)]
+  const out = new Map()
+  marks.forEach((m, i) => {
+    const end = i + 1 < marks.length ? marks[i + 1].index : t.length
+    out.set(Number(m[1]), dedent(t.slice(m.index + m[0].length, end)).trim())
+  })
+  return out
+}
+
+/** Collapse a wrapped PDF paragraph to one line, preserving words exactly. */
+const unwrap = s => s.split('\n').map(l => l.trim()).filter(Boolean).join(' ')
+
+function applyClauseEdits (target, node, actText) {
+  const decl = CLAUSE_EDITS[target]
+  const clauses = actClauses(actText)
+
+  if (decl.kind === 'sections-from-clauses') {
+    for (let n = decl.firstSection; n <= decl.lastSection; n++) {
+      const raw = clauses.get(n)
+      if (!raw) throw new Error(`${target}: Act has no clause (${n})`)
+      const flat = unwrap(raw)
+      const idx = flat.indexOf(':')
+      if (idx < 0) throw new Error(`${target} clause (${n}): no "Title: text" form`)
+      const sec = node.sections.find(s => s.number === n)
+      if (!sec) throw new Error(`${target}: no section ${n}`)
+      sec.title = flat.slice(0, idx).trim()
+      sec.content = flat.slice(idx + 1).trim() + '\n'
+      sec.title_source = 'enacted'
+    }
+    return
+  }
+
+  const lines = node.content.split('\n')
+  // Apply from the bottom so earlier ranges keep their indices.
+  for (const e of [...decl.edits].sort((a, b) => b.lines[0] - a.lines[0])) {
+    const raw = clauses.get(e.clause)
+    if (raw == null) throw new Error(`${target}: Act has no clause (${e.clause})`)
+    let text = raw
+    if (e.from === 'sub') {
+      // Pull one sub-clause out of a clause that contains several.
+      const parts = raw.split(/\n(?=\s*\((?:a|b)\))/)
+      const hit = parts.find(p => e.marker.test(p.replace(/\n/g, ' ')) || e.marker.test(p))
+      if (!hit) throw new Error(`${target}: clause (${e.clause}) has no part matching ${e.marker}`)
+      text = hit.replace(e.marker, '')
+    }
+    lines.splice(e.lines[0], e.lines[1] - e.lines[0] + 1, e.prefix + unwrap(text))
+  }
+  node.content = lines.join('\n')
+}
+
+function applyArticleScope (target, doc, actText, enactedTitle) {
+  const s = shape(target, actText)
+  const node = target === 'preamble'
+    ? doc.preamble
+    : doc.articles.find(a => a.id === target)
+  if (!node) throw new Error(`${target}: not present`)
+
+  if (enactedTitle) { node.title = enactedTitle; node.title_source = 'enacted' }
+  if (s.content) node.content = s.content + '\n'
+  else delete node.content
+
+  if (s.sections.length) {
+    node.sections = s.sections.map(sec => ({
+      id: `${target}-s-${sec.number}`,
+      number: sec.number,
+      title: sec.title,
+      title_source: 'enacted',
+      content: sec.content + '\n'
+    }))
+  } else {
+    delete node.sections
+  }
+}
+
+function insertArticle (target, doc, actText, enactedTitle, actId) {
+  const number = Number(target.replace('art-', ''))
+  const s = shape(target, actText)
+  const article = {
+    id: target,
+    number,
+    title: enactedTitle,
+    title_source: 'enacted',
+    ...(s.content ? { content: s.content + '\n' } : {}),
+    ...(s.sections.length
+      ? { sections: s.sections.map(sec => ({ id: `${target}-s-${sec.number}`, number: sec.number, title: sec.title, title_source: 'enacted', content: sec.content + '\n' })) }
+      : {}),
+    amended_by: [actId]
+  }
+  doc.articles.push(article)
+  doc.articles.sort((a, b) => a.number - b.number)
+}
+
+/** Flatten every provision string, for the before/after comparison. */
+function snapshot (doc) {
+  const m = new Map()
+  m.set('preamble.title', doc.preamble.title)
+  m.set('preamble.content', doc.preamble.content ?? null)
+  for (const a of doc.articles) {
+    m.set(`${a.id}.title`, a.title)
+    m.set(`${a.id}.content`, a.content ?? null)
+    for (const s of a.sections ?? []) {
+      m.set(`${s.id}.title`, s.title)
+      m.set(`${s.id}.content`, s.content ?? null)
+    }
+  }
+  return m
+}
+
+export function applyAct (actId, { dryRun = false } = {}) {
+  const acts = loadActs(ROOT)
+  const act = acts.find(a => ACT_ID[path.basename(a.file)] === actId)
+  if (!act) throw new Error(`unknown act ${actId}`)
+
+  const before = yaml.load(fs.readFileSync(FILE, 'utf8'), OPTS)
+  const doc = yaml.load(fs.readFileSync(FILE, 'utf8'), OPTS)
+  const beforeSnap = snapshot(before)
+
+  const expected = new Set()
+  const applied = []
+
+  for (const p of act.provisions) {
+    const target = p.target
+    const node = target === 'preamble' ? doc.preamble : doc.articles.find(a => a.id === target)
+
+    // Already reconciled by a previous pass: record the reference, change nothing.
+    const alreadyApplied = node && similarity(
+      [node.content ?? '', ...(node.sections ?? []).flatMap(s => [s.title, s.content])].join('\n'),
+      p.text
+    ) >= 0.94
+
+    if (p.operation === 'insert' && !node) {
+      insertArticle(target, doc, p.text, p.enacted_title, actId)
+      applied.push(`${target} inserted`)
+    } else if (alreadyApplied) {
+      applied.push(`${target} already applied`)
+    } else if (p.scope === 'clause') {
+      applyClauseEdits(target, node, p.text)
+      // A clause-scope Act still restates the article heading above its
+      // clauses, and that heading is enacted text: Act 2 heads Article 16
+      // "16. Amendments", which is how the misspelling is corrected by the
+      // instrument rather than by an editor.
+      if (p.enacted_title && p.enacted_title !== node.title) {
+        applied.push(`${target} retitled ${JSON.stringify(node.title)} -> ${JSON.stringify(p.enacted_title)}`)
+        node.title = p.enacted_title
+      }
+      if (p.enacted_title) node.title_source = 'enacted'
+      applied.push(`${target} clauses ${p.clauses}`)
+    } else {
+      applyArticleScope(target, doc, p.text, p.enacted_title)
+      applied.push(`${target} substituted`)
+    }
+
+    if (node || p.operation === 'insert') {
+      const n = target === 'preamble' ? doc.preamble : doc.articles.find(a => a.id === target)
+      if (!n.amended_by) n.amended_by = []
+      if (!n.amended_by.includes(actId)) n.amended_by.push(actId)
+    }
+    expected.add(target)
+  }
+
+  // ---- verification ------------------------------------------------------
+  const afterSnap = snapshot(doc)
+  const changed = new Set()
+  for (const k of new Set([...beforeSnap.keys(), ...afterSnap.keys()])) {
+    if (beforeSnap.get(k) !== afterSnap.get(k)) changed.add(k.split('.')[0].replace(/-s-\d+$/, ''))
+  }
+
+  const outside = [...changed].filter(id => !expected.has(id))
+  if (outside.length) {
+    throw new Error(`ABORT: provisions changed outside the manifest for ${actId}: ${outside.join(', ')}`)
+  }
+
+  for (const p of act.provisions) {
+    const n = p.target === 'preamble' ? doc.preamble : doc.articles.find(a => a.id === p.target)
+    const full = [n.content ?? '', ...(n.sections ?? []).flatMap(s => [s.title, s.content])].join('\n')
+    if (p.scope === 'article') {
+      const sim = similarity(full, p.text)
+      if (sim < 0.94) throw new Error(`ABORT: ${p.target} does not match ${actId} (${(sim * 100).toFixed(1)}%)`)
+    } else {
+      const cl = actClauses(p.text)
+      for (const num of p.clauses.split(',').map(Number)) {
+        const clauseText = cl.get(num)
+        const hay = normalise(full)
+        // Every clause the Act names must now be present in the provision.
+        const needle = normalise(unwrap(clauseText)).split(' ').slice(-12).join(' ')
+        if (needle && !hay.includes(needle)) {
+          throw new Error(`ABORT: ${p.target} clause (${num}) not found in the applied text`)
+        }
+      }
+    }
+  }
+
+  if (!dryRun) fs.writeFileSync(FILE, yaml.dump(doc, DUMP))
+  return { applied, changed: [...changed], expected: [...expected] }
+}
+
+const direct = process.argv[1] && fileURLToPath(import.meta.url) === path.resolve(process.argv[1])
+if (direct) {
+  const actId = process.argv[2]
+  const dryRun = process.argv.includes('--dry-run')
+  const r = applyAct(actId, { dryRun })
+  console.log(`${actId}${dryRun ? ' (dry run)' : ''}`)
+  for (const a of r.applied) console.log(`  ${a}`)
+  console.log(`  changed: ${r.changed.join(', ') || '(none)'}`)
+}
diff --git a/src/build.mjs b/src/build.mjs
new file mode 100644
index 0000000..e497bb6
--- /dev/null
+++ b/src/build.mjs
@@ -0,0 +1,620 @@
+#!/usr/bin/env node
+/**
+ * YAML → static HTML.
+ *
+ * Every provision is rendered at build time. There is no client-side fetching
+ * of specs: the previous renderer fetched YAML in the browser, which meant
+ * social scrapers saw an empty body, search engines indexed nothing, and one
+ * missing key could blank half the document.
+ */
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import yaml from 'js-yaml'
+import { makeUrl, makeAbsolute, slugMap, escapeHtml, summarise, DEFAULT_BASE_PATH, DEFAULT_SITE_ORIGIN } from './lib/paths.mjs'
+import { toPlainText, renderMarkdown } from './lib/markdown.mjs'
+import { layout } from './templates/layout.mjs'
+import { renderArticle, renderPreamble } from './templates/provision.mjs'
+import { generateOgImages } from './og.mjs'
+
+export const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+const OUT = () => path.join(ROOT, process.env.OUT_DIR ?? 'dist')
+
+// Configurable so switching to the apex domain later is a one-line change.
+export const BASE_PATH = DEFAULT_BASE_PATH
+export const SITE_ORIGIN = DEFAULT_SITE_ORIGIN
+// The custom domain is live. An artifact without CNAME can drop the domain
+// setting on deploy, so this now defaults ON and must be opted OUT of.
+const INCLUDE_CNAME = process.env.INCLUDE_CNAME !== 'false'
+
+// Engine and content are separate. Point these at your own files and the
+// engine needs no modification; versions/ and the act register are optional.
+const CONSTITUTION_FILE = process.env.CONSTITUTION_FILE ?? 'constitution/current.yaml'
+const VERSIONS_DIR = process.env.VERSIONS_DIR ?? 'constitution/versions'
+const REGISTER_FILE = process.env.REGISTER_FILE ?? 'acts/register.yaml'
+const OUT_DIR = process.env.OUT_DIR ?? 'dist'
+
+const url = makeUrl(BASE_PATH)
+const abs = makeAbsolute(SITE_ORIGIN, BASE_PATH)
+const load = rel => yaml.load(fs.readFileSync(path.join(ROOT, rel), 'utf8'), { schema: yaml.CORE_SCHEMA })
+
+const write = (rel, body) => {
+  const full = path.join(OUT(), rel)
+  fs.mkdirSync(path.dirname(full), { recursive: true })
+  fs.writeFileSync(full, body)
+  return rel
+}
+
+const copyDir = (from, to) => {
+  const src = path.join(ROOT, from)
+  if (!fs.existsSync(src)) return 0
+  const dst = path.join(OUT(), to)
+  fs.mkdirSync(dst, { recursive: true })
+  let n = 0
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    if (entry.isDirectory()) n += copyDir(path.join(from, entry.name), path.join(to, entry.name))
+    else { fs.copyFileSync(path.join(src, entry.name), path.join(dst, entry.name)); n++ }
+  }
+  return n
+}
+
+// ---------------------------------------------------------------------------
+
+/**
+ * The headline under the title states the ADOPTED position, never the working
+ * version label.
+ *
+ * A version number on a governing document is an assertion about what is in
+ * force. This text is published at 3.0.0-alpha.1, a build label for a version
+ * the board has not adopted, and an "effective from" date taken from Acts the
+ * banner immediately below says are unapplied. Publishing either as the
+ * document's status claims something nobody enacted.
+ */
+function legalStatusLead (info, actIndex) {
+  if (info.legal_status !== 'not_adopted') {
+    return `<p class="page-lead">Version ${escapeHtml(info.version)} · effective ${escapeHtml(info.effective_from)}` +
+      `${info.registration ? ` · ${escapeHtml(info.registration)}` : ''}</p>`
+  }
+  const applied = Object.values(actIndex)
+    .filter(a => a.application_status === 'applied' || a.application_status === 'partially-applied')
+    .map(a => `Act ${a.number} of ${a.year}`)
+  return `<p class="page-lead page-lead--status">
+    Last adopted version <strong>${escapeHtml(info.adopted_version)}</strong>.
+    This page shows that text as at ${escapeHtml(info.text_as_of)}${applied.length
+      ? `, together with the provisions of ${applied.map(escapeHtml).join(' and ')} recorded as applied`
+      : ''}.
+    <strong>No later version has been adopted.</strong>
+  </p>`
+}
+
+function organizationLd (info) {
+  return {
+    '@context': 'https://schema.org', '@type': 'Organization',
+    name: info.organization, alternateName: info.title,
+    url: abs(''), ...(info.logo?.url ? { logo: info.logo.url } : {}),
+    ...(info.contact?.email ? { email: info.contact.email } : {}),
+    ...(info.jurisdiction ? { areaServed: info.jurisdiction } : {})
+  }
+}
+
+function legislationLd (info, doc) {
+  return {
+    '@context': 'https://schema.org', '@type': 'Legislation',
+    name: `Constitution of ${info.organization}`,
+    // The identifier and date describe what was ADOPTED, not the build label.
+    legislationIdentifier: info.legal_status === 'not_adopted' ? info.adopted_version : info.version,
+    legislationType: 'Constitution',
+    legislationDate: info.legal_status === 'not_adopted' ? info.text_as_of : info.effective_from,
+    ...(info.jurisdiction ? { legislationJurisdiction: info.jurisdiction } : {}),
+    inLanguage: 'en',
+    url: abs(''),
+    isBasedOn: (doc.articles ?? []).length + ' articles',
+    publisher: { '@type': 'Organization', name: info.organization }
+  }
+}
+
+const breadcrumbLd = trail => ({
+  '@context': 'https://schema.org', '@type': 'BreadcrumbList',
+  itemListElement: trail.map((t, i) => ({
+    '@type': 'ListItem', position: i + 1, name: t.name, item: t.url
+  }))
+})
+
+// ---------------------------------------------------------------------------
+
+function buildSearchIndex (doc, slugs) {
+  const rows = []
+  const push = (id, title, text, articleId, articleTitle) => {
+    const body = toPlainText(text)
+    if (!body && !title) return
+    rows.push({
+      id,
+      t: title,
+      a: articleId ? slugs.get(articleId) : null,
+      at: articleTitle ?? null,
+      x: body.slice(0, 600)
+    })
+  }
+  push('preamble', doc.preamble.title, doc.preamble.content, null, null)
+  for (const a of doc.articles) {
+    push(a.id, `${a.number}. ${a.title}`, a.content, a.id, a.title)
+    for (const s of a.sections ?? []) {
+      push(s.id, `${s.number}. ${s.title}`, s.content, a.id, a.title)
+    }
+  }
+  return rows
+}
+
+/**
+ * URLs the previous Apache host served that this one does not.
+ *
+ * Its .htaccess rewrote `/x.html` to the extensionless `/x`, so the canonical
+ * old archive URLs had no extension. Static hosting cannot rewrite, so each
+ * old shape gets a real page that redirects. Inbound links to a constitution
+ * live in minutes, emails and other people's documents; letting them 404 is
+ * how a citation dies.
+ */
+const LEGACY_REDIRECTS = {
+  'archives/v1/index.html': 'archive/1.0.0/',
+  'archives/v2/index.html': 'archive/2.0.0/',
+  'archives/v1.html': 'archive/1.0.0/',
+  'archives/v2.html': 'archive/2.0.0/',
+  'archives/index.html': 'archive/'
+}
+
+function redirectStub (to, absTo) {
+  return `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8">
+    <title>Moved — this page has a new address</title>
+    <link rel="canonical" href="${absTo}">
+    <meta http-equiv="refresh" content="0; url=${to}">
+    <meta name="robots" content="noindex, follow">
+  </head>
+  <body>
+    <p>This page has moved to <a href="${to}">${absTo}</a>.</p>
+    <script>location.replace(${JSON.stringify(to)})</script>
+  </body>
+</html>
+`
+}
+
+/** Old `#article5` / `#article5-section2` links must keep resolving. */
+function legacyAnchorMap (doc) {
+  const map = {}
+  doc.articles.forEach((a, i) => {
+    map[`article${i + 1}`] = a.id
+    ;(a.sections ?? []).forEach((s, j) => { map[`article${i + 1}-section${j + 1}`] = s.id })
+  })
+  map.articles = doc.articles[0]?.id ?? 'preamble'
+  return map
+}
+
+// ---------------------------------------------------------------------------
+
+export function build () {
+  const doc = load(CONSTITUTION_FILE)
+  const info = doc.info
+  const state = doc.reconciliation_state
+  const register = fs.existsSync(path.join(ROOT, REGISTER_FILE)) ? load(REGISTER_FILE) : { acts: [] }
+  const actIndex = Object.fromEntries((register.acts ?? []).map(a => [a.id, a]))
+  const slugs = slugMap(doc.articles)
+  const written = []
+
+  fs.rmSync(OUT(), { recursive: true, force: true })
+  fs.mkdirSync(OUT(), { recursive: true })
+
+  // Mark the exception, whichever it is. Applying the Acts flipped this from
+  // 8 enacted of 40 to 32 of 40.
+  const headingCounts = [doc.preamble, ...doc.articles.flatMap(a => [a, ...(a.sections ?? [])])]
+    .filter(n => (n.status ?? 'active') === 'active')
+    .reduce((acc, n) => { acc[n.title_source === 'enacted' ? 'enacted' : 'editorial']++; return acc },
+      { enacted: 0, editorial: 0 })
+  const markKind = headingCounts.enacted === headingCounts.editorial
+    ? 'editorial'
+    : (headingCounts.enacted < headingCounts.editorial ? 'enacted' : 'editorial')
+
+  const shell = { info, url, absolute: abs, state, actIndex, articles: doc.articles, slugs }
+
+  // ---- index: the whole constitution, every provision inline ----
+  const indexMain = `
+    <h1 class="page-title">Constitution of ${escapeHtml(info.organization)}</h1>
+    ${legalStatusLead(info, actIndex)}
+    ${renderPreamble(doc.preamble, { url, actIndex, markKind })}
+    <h2 class="section-title" id="articles">Articles</h2>
+    ${doc.articles.map(a => renderArticle(a, { url, actIndex, headingLevel: 3, markKind })).join('')}`
+
+  written.push(write('index.html', layout({
+    ...shell,
+    title: `Constitution of ${info.organization}`,
+    description: summarise(toPlainText(doc.preamble.content)),
+    canonical: abs(''),
+    og: { type: 'article', image: abs('assets/og/home.png'), imageAlt: `Constitution of ${info.organization}` },
+    jsonLd: [legislationLd(info, doc), organizationLd(info),
+      breadcrumbLd([{ name: 'Constitution', url: abs('') }])],
+    main: indexMain
+  })))
+
+  // ---- one page per article: the SEO surface ----
+  for (const a of doc.articles) {
+    const slug = slugs.get(a.id)
+    const text = toPlainText(a.content) || toPlainText((a.sections ?? [])[0]?.content) || a.title
+    const canonical = abs(`articles/${slug}/`)
+    const main = `
+      <nav class="crumbs" aria-label="Breadcrumb">
+        <a href="${url('')}">Constitution</a> <span aria-hidden="true">/</span>
+        <span aria-current="page">Article ${a.number}</span>
+      </nav>
+      <h1 class="page-title"><span class="page-title__num">Article ${a.number}</span> ${escapeHtml(a.title)}</h1>
+      ${renderArticle(a, { url, actIndex, headingLevel: 2, markKind })}
+      <nav class="pager" aria-label="Article navigation">
+        ${prevNext(doc.articles, a, slugs, url)}
+      </nav>`
+
+    written.push(write(`articles/${slug}/index.html`, layout({
+      ...shell,
+      currentId: a.id,
+      tocMode: 'multi',
+      title: `Article ${a.number}: ${a.title} — ${info.title}`,
+      description: summarise(text),
+      canonical,
+      og: { type: 'article', image: abs(`assets/og/${slug}.png`), imageAlt: `Article ${a.number}: ${a.title}` },
+      jsonLd: [
+        {
+          '@context': 'https://schema.org', '@type': 'Article',
+          headline: `Article ${a.number}: ${a.title}`,
+          articleSection: 'Constitution',
+          description: summarise(text),
+          url: canonical,
+          datePublished: info.text_as_of ?? info.effective_from,
+          isPartOf: { '@type': 'Legislation', name: `Constitution of ${info.organization}`, url: abs('') },
+          publisher: { '@type': 'Organization', name: info.organization }
+        },
+        breadcrumbLd([
+          { name: 'Constitution', url: abs('') },
+          { name: `Article ${a.number}: ${a.title}`, url: canonical }
+        ])
+      ],
+      main
+    })))
+  }
+
+  // ---- amendment register ----
+  written.push(write('amendments/index.html', layout({
+    ...shell,
+    showToc: false,
+    title: `Amendment register — ${info.title}`,
+    description: `Every instrument amending the constitution of ${info.organization}, with dates of assent, the provisions each touches, and the signed Act as published.`,
+    canonical: abs('amendments/'),
+    og: { image: abs('assets/og/amendments.png'), imageAlt: 'Amendment register' },
+    jsonLd: [breadcrumbLd([
+      { name: 'Constitution', url: abs('') },
+      { name: 'Amendments', url: abs('amendments/') }
+    ])],
+    main: amendmentsMain(register, state, doc, { url, slugs, actIndex, markKind })
+  })))
+
+  // ---- archive ----
+  const versions = fs.existsSync(path.join(ROOT, VERSIONS_DIR))
+    ? fs.readdirSync(path.join(ROOT, VERSIONS_DIR)).filter(f => f.endsWith('.yaml')).sort()
+    : []
+
+  written.push(write('archive/index.html', layout({
+    ...shell,
+    showToc: false,
+    title: `Archive — ${info.title}`,
+    description: `Every superseded version of the constitution of ${info.organization}, frozen as published.`,
+    canonical: abs('archive/'),
+    og: { image: abs('assets/og/archive.png'), imageAlt: 'Archive' },
+    jsonLd: [breadcrumbLd([
+      { name: 'Constitution', url: abs('') }, { name: 'Archive', url: abs('archive/') }
+    ])],
+    main: `
+      <h1 class="page-title">Archive</h1>
+      <p class="page-lead">Superseded versions, frozen exactly as published. These are not the constitution in force.</p>
+      <ul class="versions">
+        <li class="versions__item versions__item--current">
+          <a href="${url('')}"><strong>Version ${escapeHtml(info.version)}</strong></a>
+          <span class="versions__badge">In force</span>
+          <span class="versions__date">effective ${escapeHtml(info.effective_from)}</span>
+        </li>
+        ${versions.map(f => {
+          const v = f.replace(/^v|\.yaml$/g, '')
+          const d = load(`${VERSIONS_DIR}/${f}`)
+          return `<li class="versions__item">
+            <a href="${url(`archive/${v}/`)}"><strong>Version ${escapeHtml(v)}</strong></a>
+            <span class="versions__badge versions__badge--old">Superseded</span>
+            <span class="versions__date">effective ${escapeHtml(d.info.effective_from)}</span>
+          </li>`
+        }).join('')}
+      </ul>`
+  })))
+
+  for (const f of versions) {
+    const v = f.replace(/^v|\.yaml$/g, '')
+    const d = load(`${VERSIONS_DIR}/${f}`)
+    const successor = d.info.superseded_by
+    written.push(write(`archive/${v}/index.html`, layout({
+      ...shell,
+      articles: d.articles,
+      slugs: slugMap(d.articles),
+      showToc: false,
+      state: null,
+      title: `Version ${v} (superseded) — ${info.title}`,
+      description: `Version ${v} of the constitution of ${info.organization}, superseded and retained for reference. Not the text in force.`,
+      canonical: abs(''),
+      og: { image: abs('assets/og/archive.png'), imageAlt: `Version ${v}` },
+      jsonLd: [breadcrumbLd([
+        { name: 'Constitution', url: abs('') },
+        { name: 'Archive', url: abs('archive/') },
+        { name: `Version ${v}`, url: abs(`archive/${v}/`) }
+      ])],
+      main: `
+        <aside class="banner banner--superseded" role="note" aria-labelledby="superseded-heading">
+          <h2 class="banner__title" id="superseded-heading">This version is superseded</h2>
+          <p class="banner__lead">
+            Version ${escapeHtml(v)} is not the constitution in force. It is retained exactly as published,
+            defects included, because an archive that changes is not an archive.
+            ${successor ? `It was replaced by version ${escapeHtml(successor)}.` : ''}
+          </p>
+          <p class="banner__more"><a href="${url('')}">Read the version in force →</a></p>
+        </aside>
+        <h1 class="page-title">Constitution — version ${escapeHtml(v)}</h1>
+        <p class="page-lead">Effective ${escapeHtml(d.info.effective_from)} · superseded</p>
+        ${renderPreamble(d.preamble, { url, actIndex, markKind })}
+        <h2 class="section-title" id="articles">Articles</h2>
+        ${d.articles.map(a => renderArticle(a, { url, actIndex, headingLevel: 3, markKind })).join('')}`
+    })))
+  }
+
+  // ---- 404 ----
+  written.push(write('404.html', layout({
+    ...shell,
+    showToc: false,
+    title: `Page not found — ${info.title}`,
+    description: 'The requested page does not exist.',
+    canonical: abs('404.html'),
+    main: `
+      <h1 class="page-title">Page not found</h1>
+      <p class="page-lead">That page does not exist. Citations of the form
+      <code>#art-6-s-1</code> resolve on the <a href="${url('')}">constitution</a>.</p>
+      <ul class="versions">
+        <li class="versions__item"><a href="${url('')}">The constitution in force</a></li>
+        <li class="versions__item"><a href="${url('amendments/')}">Amendment register</a></li>
+        <li class="versions__item"><a href="${url('archive/')}">Archive</a></li>
+      </ul>`
+  })))
+
+  // ---- data, assets, static files ----
+  write('search-index.json', JSON.stringify(buildSearchIndex(doc, slugs)))
+  write('legacy-anchors.json', JSON.stringify(legacyAnchorMap(doc)))
+  for (const [from, to] of Object.entries(LEGACY_REDIRECTS)) {
+    written.push(write(from, redirectStub(url(to), abs(to))))
+  }
+
+  write('.nojekyll', '')
+  write('robots.txt', `User-agent: *\nAllow: /\n\nSitemap: ${abs('sitemap.xml')}\n`)
+  write('sitemap.xml', sitemap(doc, slugs, versions))
+
+  // Open Graph plates. Generated before assets are copied so they land in dist/assets/og/.
+  const ogPages = [
+    { slug: 'home', kicker: 'CONSTITUTION', title: `Constitution of ${info.organization}`,
+      footer: `Version ${info.version} · effective ${info.effective_from}`,
+      badge: state && !state.complete ? 'In reconciliation' : null },
+    { slug: 'amendments', kicker: 'AMENDMENTS', title: 'Amendment register',
+      footer: `${(register.acts ?? []).length} instruments · ${info.organization}` },
+    { slug: 'archive', kicker: 'ARCHIVE', title: 'Superseded versions',
+      footer: info.organization },
+    ...doc.articles.map(a => ({
+      slug: slugs.get(a.id),
+      kicker: `ARTICLE ${a.number}`,
+      title: a.title,
+      footer: `${info.organization} · Constitution ${info.version}`,
+      badge: (a.amended_by ?? []).length ? 'Amended' : null
+    }))
+  ]
+  const og = generateOgImages(path.join(ROOT, 'assets/og'), ogPages, {
+    logoPath: path.join(ROOT, 'assets/img/OpenCodeLaw.png'),
+    bannerPath: path.join(ROOT, 'assets/img/openlawcode_banner.png')
+  })
+
+  copyDir('assets', 'assets')
+  copyDir('favicons', 'favicons')
+  copyDir('acts/pdf', 'acts/pdf')
+  copyDir('src/styles', 'styles')
+  copyDir('src/scripts', 'scripts')
+
+  // The custom domain stays on the old site until it has been reviewed.
+  if (INCLUDE_CNAME && fs.existsSync(path.join(ROOT, 'CNAME'))) {
+    fs.copyFileSync(path.join(ROOT, 'CNAME'), path.join(OUT(), 'CNAME'))
+  }
+
+  return { written, doc, slugs, versions, register, og }
+}
+
+function prevNext (articles, current, slugs, url) {
+  const i = articles.findIndex(a => a.id === current.id)
+  const prev = articles[i - 1]
+  const next = articles[i + 1]
+  return [
+    prev ? `<a class="pager__link pager__link--prev" href="${url(`articles/${slugs.get(prev.id)}/`)}">
+      <span class="pager__dir">Previous</span><span class="pager__title">${prev.number}. ${escapeHtml(prev.title)}</span></a>` : '<span></span>',
+    next ? `<a class="pager__link pager__link--next" href="${url(`articles/${slugs.get(next.id)}/`)}">
+      <span class="pager__dir">Next</span><span class="pager__title">${next.number}. ${escapeHtml(next.title)}</span></a>` : '<span></span>'
+  ].join('')
+}
+
+function amendmentsMain (register, state, doc, { url, slugs, actIndex, markKind }) {
+  const byId = Object.fromEntries(doc.articles.map(a => [a.id, a]))
+  const acts = (register.acts ?? []).slice().sort((a, b) => a.number - b.number)
+
+  const rows = acts.map(act => {
+    const status = act.application_status ?? 'pending'
+    const provisions = (act.provisions ?? []).map(p => {
+      const target = byId[p.target]
+      const label = target ? `Article ${target.number}` : p.target
+      const href = target ? `${url(`articles/${slugs.get(target.id)}/`)}` : `${url('')}#${p.target}`
+      return `<li><a href="${href}">${escapeHtml(label)}</a> — ${escapeHtml(p.operation)}` +
+        `${p.clauses ? ` clauses ${escapeHtml(p.clauses)}` : ''} (${escapeHtml(p.scope)} scope)</li>`
+    }).join('')
+
+    const discrepancies = (act.drafting_discrepancy ?? []).map(d => `
+      <details class="disc">
+        <summary>Drafting discrepancy in ${escapeHtml(d.provision)}</summary>
+        <p class="disc__label">Operative text — governs</p>
+        <blockquote>${escapeHtml(d.operative)}</blockquote>
+        ${d.statement_of_objects ? `<p class="disc__label">Statement of Objects and Reasons — explanatory, does not govern</p>
+        <blockquote>${escapeHtml(d.statement_of_objects)}</blockquote>` : ''}
+        <p class="disc__note">${escapeHtml(d.note ?? '')}</p>
+      </details>`).join('')
+
+    const proc = act.procedure ? `
+      <details class="disc">
+        <summary>Approval chain</summary>
+        <p class="disc__note">Required by ${escapeHtml(act.procedure.required_by ?? '—')}. Attested by ${escapeHtml(act.procedure.attested_by ?? '—')}.</p>
+        <ul class="proc">${(act.procedure.approvals ?? []).map(ap =>
+          `<li><span class="proc__body">${escapeHtml(ap.body)}</span> — ${ap.evidence ? escapeHtml(ap.evidence) : '<em>no evidence on file</em>'}</li>`).join('')}</ul>
+      </details>` : ''
+
+    return `
+    <article class="act" id="${escapeHtml(act.id)}">
+      <h2 class="act__title">
+        <span class="act__num">Act ${act.number} of ${act.year}</span>
+        ${escapeHtml(act.title)}
+        <span class="act__status act__status--${escapeHtml(status)}">${escapeHtml(status.replace('-', ' '))}</span>
+      </h2>
+      ${act.short_title ? `<p class="act__short">Also called the ${escapeHtml(act.short_title)}</p>` : ''}
+      <dl class="act__meta">
+        <dt>Assent</dt><dd>${escapeHtml(act.assent_date)}</dd>
+        ${act.passed_date ? `<dt>Passed</dt><dd>${escapeHtml(act.passed_date)} <span class="act__unverified">unverified</span></dd>` : ''}
+        ${act.assented_by ? `<dt>Assented by</dt><dd>${escapeHtml(act.assented_by)}</dd>` : ''}
+        ${act.signed_by ? `<dt>Signed by</dt><dd>${escapeHtml(act.signed_by)}</dd>` : ''}
+        ${act.unverified_attribution ? `<dt>Attributed to</dt><dd>${escapeHtml(act.unverified_attribution)} <span class="act__unverified">unverified — not stated on the instrument</span></dd>` : ''}
+        <dt>Instrument</dt><dd><a href="${url(act.pdf)}">Signed Act (PDF)</a></dd>
+      </dl>
+      ${provisions ? `<h3 class="act__sub">Provisions reconciled into the current text</h3><ul class="act__provisions">${provisions}</ul>`
+        : '<p class="act__none">No provisions of this Act have been reconciled into the current text yet.</p>'}
+      ${discrepancies}
+      ${proc}
+    </article>`
+  }).join('')
+
+  const held = (state?.held ?? []).map(h =>
+    `<li><strong>${h.provisions.map(escapeHtml).join(', ')}</strong> — awaiting ${escapeHtml(Array.isArray(h.blocked_by) ? h.blocked_by.join(', ') : h.blocked_by)}${h.note ? `<span class="banner__note">${escapeHtml(h.note)}</span>` : ''}</li>`).join('')
+
+  const editorial = doc.articles.flatMap(a => [
+    ...(a.title_source === 'editorial' ? [{ id: a.id, label: `Article ${a.number}`, title: a.title }] : []),
+    ...(a.sections ?? []).filter(s => s.title_source === 'editorial')
+      .map(s => ({ id: s.id, label: `Article ${a.number}, clause ${s.number}`, title: s.title }))
+  ])
+
+  const enacted = doc.articles.flatMap(a => [
+    ...(a.title_source === 'enacted' ? [{ id: a.id, label: `Article ${a.number}`, title: a.title }] : []),
+    ...(a.sections ?? []).filter(s => s.title_source === 'enacted')
+      .map(s => ({ id: s.id, label: `Article ${a.number}, clause ${s.number}`, title: s.title }))
+  ])
+  const totalHeadings = doc.articles.reduce((n, a) => n + 1 + (a.sections?.length ?? 0), 0)
+
+  const marked = markKind === 'enacted' ? enacted : editorial
+  const unmarkedKind = markKind === 'enacted' ? 'editorial aids' : 'stated by an instrument'
+
+  const editorialSection = `
+    <h2 class="act__sub" id="editorial-headings">Which headings carry legal force</h2>
+    <p><strong>Headings in this constitution are ${escapeHtml(unmarkedKind)} unless marked
+    <span class="title-mark"><span aria-hidden="true">§</span><span class="visually-hidden">${markKind === 'enacted' ? 'enacted heading' : 'editorial heading'}</span></span>.</strong>
+    An enacted heading is one an amending instrument states as a heading, in an Act applied to that
+    provision. ${enacted.length} of ${totalHeadings} headings are enacted and ${editorial.length} are
+    editorial; the ${marked.length} in the minority are marked, because marking the ordinary case is
+    noise.</p>
+    <p>It matters where the two are easy to confuse: Act 1 of 2024 titles Article 11's clause (2)
+    <strong>Establishment</strong>, but gives clause (1) no title at all — the lowercase
+    <code>units</code> above it was written by an editor.</p>
+    <p>Nothing is credited to an Act that has not been applied. Editorial headings are listed below
+    so the board can ratify or replace them, rather than have them quietly rewritten.</p>
+    <h3 class="act__sub">Enacted headings (${enacted.length})</h3>
+    <ul class="act__provisions">
+      ${enacted.map(e => `<li><a href="${url('')}#${escapeHtml(e.id)}">${escapeHtml(e.label)}</a> — <code>${escapeHtml(e.title)}</code></li>`).join('')}
+    </ul>
+    <h3 class="act__sub">Editorial headings (${editorial.length})</h3>
+    <ul class="act__provisions">
+      ${editorial.map(e => `<li><a href="${url('')}#${escapeHtml(e.id)}">${escapeHtml(e.label)}</a> — <code>${escapeHtml(e.title)}</code></li>`).join('')}
+    </ul>`
+
+  const reserved = doc.articles.filter(a => a.status === 'reserved')
+  const standingNotes = `
+    <h2 class="act__sub" id="standing-notes">Standing notes for a future Act</h2>
+    <p>Reconciliation is complete: all three Amendment Acts of 2024 are applied. These points are
+    recorded rather than resolved, because resolving them would mean editing the constitution
+    without an instrument.</p>
+    <ul class="act__provisions">
+      ${reserved.map(a => `<li><strong>Article ${a.number} is reserved.</strong> ${escapeHtml(a.note ?? '')}</li>`).join('')}
+      <li><strong>Article 6 clause (6), <code>Donor</code>, sits oddly with Article 7(4).</strong>
+      Act 1 substituted clauses (1)–(5) of Article 6 by name and did not reach clause (6), so
+      <code>Donor</code> stands as an STM role — while Article 7(4), as Act 1 amended it, provides
+      that a Donor Member is not an official Member and does not work for the organisation. A
+      substitution of named clauses does not reach an unnamed one, so the tension is published
+      rather than tidied away.</li>
+      <li><strong>Article 6 clauses (3) and (4) are defined in identical words.</strong> Act 1
+      defines <code>Unit Board Member</code> and <code>Coordinator</code> with the same operative
+      text, differing only by "in STM" and "in the STM". Published as enacted; a candidate for a
+      corrigendum or a Fourth Amendment Act.</li>
+    </ul>`
+
+  const buildLabel = `
+    <h2 class="act__sub" id="publication-label">Publication label</h2>
+    <p>This site is built from a working label, <code>${escapeHtml(doc.info.version)}</code>. It is
+    build metadata and <strong>not a statement of what is in force</strong>. The last version the
+    board adopted is <strong>${escapeHtml(doc.info.adopted_version ?? doc.info.version)}</strong>;
+    the text shown across the site is that version as at
+    ${escapeHtml(doc.info.text_as_of ?? '—')}, plus the provisions recorded as applied above.
+    No later version has been adopted.</p>`
+
+  return `
+    <h1 class="page-title">Amendment register</h1>
+    <p class="page-lead">Every instrument amending this constitution, with the provisions it touches and the signed Act as published.</p>
+    ${held ? `<aside class="banner" role="note" aria-labelledby="held-heading">
+      <h2 class="banner__title" id="held-heading">Not yet reconciled</h2>
+      <ul class="banner__list">${held}</ul>
+    </aside>` : ''}
+    ${rows}
+    ${editorialSection}
+    ${standingNotes}
+    ${doc.info.legal_status === 'not_adopted' ? buildLabel : ''}`
+}
+
+function sitemap (doc, slugs, versions) {
+  const urls = [
+    { loc: abs(''), lastmod: doc.info.text_as_of ?? doc.info.effective_from, priority: '1.0' },
+    { loc: abs('amendments/'), lastmod: doc.info.text_as_of ?? doc.info.effective_from, priority: '0.8' },
+    { loc: abs('archive/'), lastmod: doc.info.text_as_of ?? doc.info.effective_from, priority: '0.5' },
+    ...doc.articles.map(a => ({
+      loc: abs(`articles/${slugs.get(a.id)}/`),
+      lastmod: doc.info.text_as_of ?? doc.info.effective_from,
+      priority: '0.9'
+    })),
+    ...versions.map(f => ({
+      loc: abs(`archive/${f.replace(/^v|\.yaml$/g, '')}/`),
+      lastmod: load(`${VERSIONS_DIR}/${f}`).info.effective_from,
+      priority: '0.3'
+    }))
+  ]
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${urls.map(u => `  <url><loc>${escapeHtml(u.loc)}</loc><lastmod>${u.lastmod}</lastmod><priority>${u.priority}</priority></url>`).join('\n')}
+</urlset>
+`
+}
+
+const direct = process.argv[1] && fileURLToPath(import.meta.url) === path.resolve(process.argv[1])
+if (direct) {
+  const t = Date.now()
+  const { written, doc, versions, og } = build()
+  console.log(`built ${written.length} pages in ${Date.now() - t}ms`)
+  console.log(`  base path   ${BASE_PATH}`)
+  console.log(`  origin      ${SITE_ORIGIN}`)
+  console.log(`  articles    ${doc.articles.length}`)
+  console.log(`  archived    ${versions.length}`)
+  console.log(`  og images   ${og.made} rendered${og.fallback ? `, ${og.fallback} fell back to the banner` : ''}${og.rasteriser ? ` (${og.rasteriser})` : ' (no rasteriser found)'}`)
+  console.log(`  CNAME       ${INCLUDE_CNAME ? 'included' : 'excluded (custom domain untouched)'}`)
+}
diff --git a/src/cli.mjs b/src/cli.mjs
new file mode 100755
index 0000000..0aa44f8
--- /dev/null
+++ b/src/cli.mjs
@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+/**
+ * opencodelaw — validate and build a machine-readable constitution.
+ *
+ * The engine (src/, schema/) is separate from the content (constitution/,
+ * acts/). Any organisation can fork, replace constitution/current.yaml, and
+ * deploy without touching this code.
+ */
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import yaml from 'js-yaml'
+
+const HERE = path.dirname(fileURLToPath(import.meta.url))
+const [, , command, ...rest] = process.argv
+
+const USAGE = `
+opencodelaw — a YAML-driven renderer for organizational constitutions
+
+  opencodelaw validate [file]   Validate the corpus, or one file against the schema
+  opencodelaw build             Render the static site into dist/
+  opencodelaw spec              Regenerate schema/SPEC.md from the JSON Schema
+  opencodelaw --version
+
+Environment:
+  BASE_PATH      URL prefix the site is served from   (default /OpenCodeLaw/)
+  SITE_ORIGIN    origin for canonical and OG URLs     (default https://servicetomankind.github.io)
+  INCLUDE_CNAME  copy CNAME into the build            (default false)
+
+Validation fails the build on a missing or empty provision, a duplicate or
+unresolvable citation id, an unexplained gap in article numbering, an Act
+reference that does not resolve, or an archived version that shadows the
+current one. Exit code is non-zero on any error, so CI can gate a deploy.
+`
+
+async function validateOne (file) {
+  const abs = path.resolve(file)
+  if (!fs.existsSync(abs)) {
+    console.error(`opencodelaw: no such file: ${file}`)
+    process.exit(2)
+  }
+  const [{ default: Ajv }, { default: addFormats }] = await Promise.all([
+    import('ajv/dist/2020.js'), import('ajv-formats')
+  ])
+  const schema = JSON.parse(fs.readFileSync(path.join(HERE, '../schema/opencodelaw-1.0.schema.json'), 'utf8'))
+  const ajv = new Ajv({ allErrors: true, strict: false })
+  addFormats(ajv)
+
+  const doc = yaml.load(fs.readFileSync(abs, 'utf8'), { schema: yaml.CORE_SCHEMA })
+  const isRegister = !!doc?.acts
+  const validate = isRegister
+    ? ajv.compile({ $ref: 'opencodelaw#/$defs/actRegister', ...(ajv.addSchema(schema, 'opencodelaw'), {}) })
+    : ajv.compile(schema)
+
+  if (validate(doc)) {
+    const n = doc.articles?.length ?? doc.acts?.length ?? 0
+    console.log(`✓ ${file} — valid ${isRegister ? `act register (${n} acts)` : `constitution (${n} articles)`}`)
+    process.exit(0)
+  }
+  console.error(`✗ ${file} — ${validate.errors.length} schema error(s):`)
+  for (const e of validate.errors) console.error(`    ${e.instancePath || '/'}: ${e.message}`)
+  process.exit(1)
+}
+
+switch (command) {
+  case 'validate': {
+    if (rest[0]) { await validateOne(rest[0]); break }
+    // No argument: run the full corpus check, including relational rules.
+    const { validate } = await import('./validate.mjs')
+    const { rep } = validate()
+    for (const e of rep.errors) console.error(`ERROR [${e.code}] ${e.file} ${e.where ?? ''}: ${e.message}`)
+    for (const w of rep.warnings) console.warn(`warn  [${w.code}] ${w.file} ${w.where ?? ''}: ${w.message}`)
+    console.log(rep.errors.length ? `FAILED — ${rep.errors.length} error(s)` : `PASSED — 0 errors, ${rep.warnings.length} warning(s)`)
+    process.exit(rep.errors.length ? 1 : 0)
+    break
+  }
+  case 'build': {
+    const { build, BASE_PATH } = await import('./build.mjs')
+    const { written, og } = build()
+    console.log(`built ${written.length} pages under ${BASE_PATH} (${og.made} OG images)`)
+    break
+  }
+  case 'spec':
+    await import('./gen-spec.mjs')
+    break
+  case '--version':
+  case '-v': {
+    const pkg = JSON.parse(fs.readFileSync(path.join(HERE, '../package.json'), 'utf8'))
+    console.log(pkg.version)
+    break
+  }
+  case '--help':
+  case '-h':
+  case undefined:
+    console.log(USAGE.trim())
+    break
+  default:
+    console.error(`opencodelaw: unknown command "${command}"`)
+    console.log(USAGE.trim())
+    process.exit(2)
+}
diff --git a/src/gen-spec.mjs b/src/gen-spec.mjs
new file mode 100644
index 0000000..2f9988f
--- /dev/null
+++ b/src/gen-spec.mjs
@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+/**
+ * Generates schema/SPEC.md from the JSON Schema.
+ *
+ * The documentation used to be hand-written, and drifted: the docs said the
+ * root key was `OpenCodeLaw`, the specs said `openconstitution`, and the
+ * renderer read `ammendments`. Anyone following the documentation produced a
+ * file the renderer could not read. Generating the reference from the schema
+ * makes that particular failure impossible.
+ */
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+const SCHEMA = path.join(ROOT, 'schema/opencodelaw-1.0.schema.json')
+const OUT = path.join(ROOT, 'schema/SPEC.md')
+
+const schema = JSON.parse(fs.readFileSync(SCHEMA, 'utf8'))
+
+const esc = s => String(s ?? '').replace(/\|/g, '\\|').replace(/\n+/g, ' ').trim()
+
+/** Human-readable type for a subschema, following $ref one level. */
+function typeOf (s, defs) {
+  if (!s) return '—'
+  if (s.$ref) {
+    const name = s.$ref.replace('#/$defs/', '')
+    return `[${name}](#${name.toLowerCase()})`
+  }
+  if (s.const !== undefined) return `\`"${s.const}"\``
+  if (s.enum) return s.enum.map(v => `\`${v}\``).join(' \\| ')
+  if (s.oneOf) return s.oneOf.map(o => typeOf(o, defs)).join(' or ')
+  if (s.type === 'array') return `array of ${typeOf(s.items, defs)}`
+  if (s.type === 'object') return 'object'
+  if (Array.isArray(s.type)) return s.type.map(t => `\`${t}\``).join(' \\| ')
+  if (s.format) return `\`${s.type}\` (${s.format})`
+  return `\`${s.type ?? 'any'}\``
+}
+
+function constraints (s) {
+  const out = []
+  if (s.pattern) out.push(`pattern \`${s.pattern.length > 48 ? s.pattern.slice(0, 45) + '…' : s.pattern}\``)
+  if (s.minLength != null) out.push(`min length ${s.minLength}`)
+  if (s.minimum != null) out.push(`min ${s.minimum}`)
+  if (s.minItems != null) out.push(`min items ${s.minItems}`)
+  if (s.additionalProperties === false) out.push('no extra keys')
+  return out.join(', ')
+}
+
+function propTable (obj, defs) {
+  const required = new Set(obj.required ?? [])
+  const rows = Object.entries(obj.properties ?? {}).map(([key, sub]) => {
+    const req = required.has(key) ? '**yes**' : 'no'
+    const c = constraints(sub)
+    return `| \`${key}\` | ${typeOf(sub, defs)} | ${req} | ${esc(sub.description)}${c ? ` <br><small>${c}</small>` : ''} |`
+  })
+  if (!rows.length) return '_No properties._\n'
+  return ['| Key | Type | Required | Notes |', '|---|---|---|---|', ...rows].join('\n') + '\n'
+}
+
+/** Conditional rules expressed as if/then, rendered so they are not invisible. */
+function conditionals (obj) {
+  const all = obj.allOf ?? []
+  const notes = []
+  for (const rule of all) {
+    if (!rule.if) continue
+    const cond = Object.entries(rule.if.properties ?? {})
+      .map(([k, v]) => `\`${k}\` is ${v.enum ? v.enum.map(x => `\`${x}\``).join(' or ') : `\`${v.const}\``}`)
+      .join(' and ')
+    const then = []
+    if (rule.then?.required) then.push(`\`${rule.then.required.join('`, `')}\` becomes required`)
+    for (const [k, v] of Object.entries(rule.then?.properties ?? {})) {
+      if (v === false) then.push(`\`${k}\` must be absent`)
+    }
+    const els = []
+    if (rule.else?.required) els.push(`\`${rule.else.required.join('`, `')}\` is required`)
+    for (const alt of rule.else?.anyOf ?? []) {
+      if (alt.required) els.push(`\`${alt.required.join('`, `')}\``)
+    }
+    if (cond) {
+      notes.push(`- When ${cond}: ${then.join('; ') || '—'}.` +
+        (els.length ? ` Otherwise ${rule.else?.anyOf ? `at least one of ${els.join(' or ')} is required` : els.join('; ')}.` : ''))
+    }
+  }
+  return notes.length ? `\n**Conditional rules**\n\n${notes.join('\n')}\n` : ''
+}
+
+const lines = []
+lines.push('<!-- Generated by `npm run spec` from schema/opencodelaw-1.0.schema.json. Do not edit by hand. -->')
+lines.push('')
+lines.push(`# ${schema.title}`)
+lines.push('')
+lines.push(esc(schema.description))
+lines.push('')
+lines.push(`Schema: \`${schema.$id}\``)
+lines.push('')
+lines.push('## Root')
+lines.push('')
+lines.push(propTable(schema, schema.$defs))
+lines.push(conditionals(schema))
+
+lines.push('## Definitions')
+lines.push('')
+
+for (const [name, def] of Object.entries(schema.$defs ?? {})) {
+  lines.push(`### ${name}`)
+  lines.push('')
+  if (def.description) { lines.push(esc(def.description)); lines.push('') }
+  if (def.properties) {
+    lines.push(propTable(def, schema.$defs))
+    lines.push(conditionals(def))
+  } else {
+    const c = constraints(def)
+    lines.push(`Type: ${typeOf(def, schema.$defs)}${c ? ` — ${c}` : ''}`)
+    lines.push('')
+  }
+}
+
+lines.push('## Validation beyond the schema')
+lines.push('')
+lines.push('`npm run validate` enforces relational rules a JSON Schema cannot express. Each fails the build:')
+lines.push('')
+lines.push([
+  '| Check | Rule |',
+  '|---|---|',
+  '| `id-duplicate` | Every provision id is unique across the document |',
+  '| `id-number-mismatch` | An article id must be `art-<number>`; a section id `art-<article>-s-<number>` |',
+  '| `number-gap` | Article numbering is dense from 1; a gap is legal only where a `reserved` or `omitted` entry occupies it |',
+  '| `number-duplicate` | No number is used twice |',
+  '| `act-reference-unresolved` | Every `amended_by`, `act.amends` and `provisions[].target` resolves |',
+  '| `act-file-missing` | Every `pdf` and `source_text` exists on disk |',
+  '| `sor-as-authority` | No provision cites a Statement of Objects and Reasons as its authority |',
+  '| `archive-version-mismatch` | An archived file\'s `info.version` matches its filename |',
+  '| `archive-status` | An archived file declares `status: superseded` |',
+  '| `archive-shadows-current` | No archived version duplicates the current version |',
+  '| `current-count` | Exactly one document is `current` |',
+  '| `placeholder-url` | No `example.com` URL in `info` |',
+  '| `anchor-unresolved` | No template links to an anchor no provision produces |'
+].join('\n'))
+lines.push('')
+
+fs.writeFileSync(OUT, lines.join('\n').replace(/\n{3,}/g, '\n\n'))
+console.log(`schema/SPEC.md — ${Object.keys(schema.$defs ?? {}).length} definitions, ${lines.length} lines`)
diff --git a/src/lib/markdown.mjs b/src/lib/markdown.mjs
new file mode 100644
index 0000000..1510964
--- /dev/null
+++ b/src/lib/markdown.mjs
@@ -0,0 +1,72 @@
+/**
+ * Markdown → sanitised HTML.
+ *
+ * The previous renderer piped YAML straight into innerHTML. Any organisation
+ * pointing this engine at a third-party spec inherited an XSS vector, so
+ * everything is sanitised at build time against a strict allowlist.
+ *
+ * The allowlist deliberately contains no SVG and no SMIL animation elements.
+ * That closes the `<animate attributeName="href">` scheme-smuggling class
+ * outright, rather than relying on the sanitiser's URL parsing to catch it.
+ */
+import { marked } from 'marked'
+import sanitizeHtml from 'sanitize-html'
+
+const ALLOWED_TAGS = [
+  'p', 'br', 'hr',
+  'strong', 'em', 'b', 'i', 'u', 's', 'sup', 'sub', 'small',
+  'code', 'pre', 'blockquote',
+  'ul', 'ol', 'li',
+  // h1 and h2 are reserved for document structure; provision prose starts at h3.
+  'h3', 'h4', 'h5', 'h6',
+  'a',
+  'table', 'thead', 'tbody', 'tfoot', 'tr', 'th', 'td', 'caption'
+]
+
+const SANITIZE_OPTIONS = {
+  allowedTags: ALLOWED_TAGS,
+  allowedAttributes: {
+    a: ['href', 'title', 'rel', 'target'],
+    th: ['colspan', 'rowspan', 'scope'],
+    td: ['colspan', 'rowspan'],
+    ol: ['start']
+  },
+  // `id` is never taken from content: provision anchors are a public API and
+  // authored Markdown must not be able to mint or shadow one.
+  allowedSchemes: ['http', 'https', 'mailto'],
+  allowedSchemesAppliedToAttributes: ['href'],
+  disallowedTagsMode: 'discard',
+  transformTags: {
+    a: (tagName, attribs) => {
+      const out = { ...attribs }
+      if (out.href && /^https?:\/\//i.test(out.href)) {
+        out.rel = 'noopener noreferrer'
+        out.target = '_blank'
+      }
+      return { tagName, attribs: out }
+    }
+  }
+}
+
+marked.setOptions({ gfm: true, breaks: false })
+
+/** Marker shown where a provision was published with no text recorded. */
+export const NO_TEXT_MARKER =
+  '<p class="no-text" role="note">[No text was recorded for this provision]</p>'
+
+export function renderMarkdown (src) {
+  if (src == null || String(src).trim() === '') return NO_TEXT_MARKER
+  return sanitizeHtml(marked.parse(String(src)), SANITIZE_OPTIONS)
+}
+
+/** Plain text of a provision, for descriptions and the search index. */
+export function toPlainText (src) {
+  if (src == null) return ''
+  return sanitizeHtml(marked.parse(String(src)), { allowedTags: [], allowedAttributes: {} })
+    .replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>')
+    .replace(/&quot;/g, '"').replace(/&#39;/g, "'")
+    .replace(/\s+/g, ' ')
+    .trim()
+}
+
+export { SANITIZE_OPTIONS, ALLOWED_TAGS }
diff --git a/src/lib/paths.mjs b/src/lib/paths.mjs
new file mode 100644
index 0000000..ec48980
--- /dev/null
+++ b/src/lib/paths.mjs
@@ -0,0 +1,90 @@
+/**
+ * URL construction.
+ *
+ * Every internal href and asset src in the built site goes through `url()`.
+ * Root-relative paths that work on localhost and 404 on project Pages are the
+ * classic failure for this deployment target, so the base path is applied in
+ * exactly one place and asserted by tests.
+ */
+
+/**
+ * Deployment defaults, defined once. build.mjs, linkcheck.mjs and the tests all
+ * read these, so the base path they assume cannot drift apart — a mismatch
+ * ships a site whose every link points at a directory that is not there.
+ */
+export const DEFAULT_BASE_PATH = process.env.BASE_PATH ?? '/'
+export const DEFAULT_SITE_ORIGIN = (process.env.SITE_ORIGIN ?? 'https://constitution.stmorg.in').replace(/\/+$/, '')
+
+/** Trailing slash, leading slash, no doubles. `/OpenCodeLaw/` or `/`. */
+export function normaliseBase (base) {
+  if (!base || base === '/') return '/'
+  return ('/' + base.replace(/^\/+|\/+$/g, '') + '/')
+}
+
+export function makeUrl (base) {
+  const b = normaliseBase(base)
+  /** Site-absolute URL for a path relative to the site root. */
+  return function url (p = '') {
+    const clean = String(p).replace(/^\/+/, '')
+    return b + clean
+  }
+}
+
+/** Absolute URL for canonical/OG tags. */
+export function makeAbsolute (origin, base) {
+  const url = makeUrl(base)
+  const o = String(origin).replace(/\/+$/, '')
+  return p => o + url(p)
+}
+
+/**
+ * URL slug for an article. Derived from the title, but identity always remains
+ * the `id` — the slug is a convenience for readers and search engines, and the
+ * anchor inside the page is what a citation points at.
+ */
+export function slugify (s) {
+  return String(s)
+    .normalize('NFKD')
+    .replace(/[̀-ͯ]/g, '')
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-+|-+$/g, '')
+    .slice(0, 80) || 'untitled'
+}
+
+/**
+ * Slugs for every article, guaranteed unique and stable within a build.
+ * A collision falls back to the article number, which cannot collide.
+ */
+export function slugMap (articles) {
+  const used = new Map()
+  const out = new Map()
+  for (const a of articles) {
+    let slug = slugify(a.title)
+    if (used.has(slug)) slug = `${slug}-${a.number}`
+    used.set(slug, true)
+    out.set(a.id, slug)
+  }
+  return out
+}
+
+export const escapeHtml = s => String(s ?? '')
+  .replace(/&/g, '&amp;')
+  .replace(/</g, '&lt;')
+  .replace(/>/g, '&gt;')
+  .replace(/"/g, '&quot;')
+  .replace(/'/g, '&#39;')
+
+/** Text for a meta description: first ~155 chars of real prose, never boilerplate. */
+export function summarise (text, limit = 155) {
+  const flat = String(text ?? '')
+    .replace(/<[^>]*>/g, ' ')
+    .replace(/[#*_`>|]/g, '')
+    .replace(/^\s*[-–]\s*\(?[a-z0-9]+\)?[.)]?\s*/gim, '')
+    .replace(/\s+/g, ' ')
+    .trim()
+  if (flat.length <= limit) return flat
+  const cut = flat.slice(0, limit)
+  const stop = Math.max(cut.lastIndexOf('. '), cut.lastIndexOf(' '))
+  return (stop > 60 ? cut.slice(0, stop) : cut).replace(/[,;:.\s]+$/, '') + '…'
+}
diff --git a/src/linkcheck.mjs b/src/linkcheck.mjs
new file mode 100644
index 0000000..28794c2
--- /dev/null
+++ b/src/linkcheck.mjs
@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+/**
+ * Verifies the built site before it is published.
+ *
+ * Two failure modes matter most for this deployment target:
+ *
+ *  - a root-relative URL that works on localhost and 404s on project Pages,
+ *    because the site lives under /OpenCodeLaw/ and not at the domain root;
+ *  - a link or in-page anchor pointing at something no provision produces,
+ *    which for a constitution means a dead citation.
+ */
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { normaliseBase, DEFAULT_BASE_PATH } from './lib/paths.mjs'
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+const DIST = path.join(ROOT, 'dist')
+const BASE = normaliseBase(DEFAULT_BASE_PATH)
+
+const EXTERNAL = /^(https?:|mailto:|tel:|data:|#|javascript:)/i
+
+function htmlFiles (dir, acc = []) {
+  for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, e.name)
+    if (e.isDirectory()) htmlFiles(full, acc)
+    else if (e.name.endsWith('.html')) acc.push(full)
+  }
+  return acc
+}
+
+/** Where does a site-absolute URL land on disk? */
+function resolveTarget (urlPath) {
+  const rel = urlPath.slice(BASE.length)
+  const candidates = rel === '' || rel.endsWith('/')
+    ? [path.join(DIST, rel, 'index.html')]
+    : [path.join(DIST, rel), path.join(DIST, rel, 'index.html')]
+  return candidates.find(c => fs.existsSync(c)) ?? null
+}
+
+export function linkcheck () {
+  if (!fs.existsSync(DIST)) throw new Error('dist/ does not exist — run the build first')
+  const files = htmlFiles(DIST)
+  const problems = []
+  const stats = { files: files.length, links: 0, anchors: 0 }
+
+  // Anchors available in each page, so in-page fragments can be checked.
+  const idsByFile = new Map()
+  for (const f of files) {
+    const html = fs.readFileSync(f, 'utf8')
+    idsByFile.set(f, new Set([...html.matchAll(/\bid="([^"]+)"/g)].map(m => m[1])))
+  }
+
+  for (const f of files) {
+    const rel = path.relative(DIST, f)
+    const html = fs.readFileSync(f, 'utf8')
+    const refs = [...html.matchAll(/\b(?:href|src)="([^"]*)"/g)].map(m => m[1])
+
+    for (const raw of refs) {
+      if (!raw || raw.startsWith('mailto:') || raw.startsWith('tel:') || raw.startsWith('data:')) continue
+
+      // In-page fragment
+      if (raw.startsWith('#')) {
+        stats.anchors++
+        const id = raw.slice(1)
+        if (id && !idsByFile.get(f).has(id)) {
+          problems.push({ file: rel, url: raw, why: 'in-page anchor matches no element on this page' })
+        }
+        continue
+      }
+
+      if (/^https?:/i.test(raw)) continue
+      stats.links++
+
+      if (!raw.startsWith('/')) {
+        problems.push({ file: rel, url: raw, why: 'relative URL — every internal link must be base-path aware' })
+        continue
+      }
+
+      // Root-relative: must sit under the base path, or it 404s on project Pages.
+      if (!raw.startsWith(BASE)) {
+        problems.push({ file: rel, url: raw, why: `escapes the base path ${BASE}` })
+        continue
+      }
+
+      const [urlPath, frag] = raw.split('#')
+      const target = resolveTarget(urlPath)
+      if (!target) {
+        problems.push({ file: rel, url: raw, why: 'no file at this path in dist/' })
+        continue
+      }
+      if (frag) {
+        const ids = idsByFile.get(target)
+        if (ids && !ids.has(frag)) {
+          problems.push({ file: rel, url: raw, why: `target page has no element with id "${frag}"` })
+        }
+      }
+    }
+  }
+
+  return { problems, stats }
+}
+
+const direct = process.argv[1] && fileURLToPath(import.meta.url) === path.resolve(process.argv[1])
+if (direct) {
+  const { problems, stats } = linkcheck()
+  console.log(`link check — ${stats.files} pages, ${stats.links} links, ${stats.anchors} in-page anchors, base ${BASE}`)
+  if (problems.length) {
+    console.error(`\nFAILED — ${problems.length} problem(s):`)
+    for (const p of problems.slice(0, 40)) console.error(`  ${p.file}\n    ${p.url}\n    ${p.why}`)
+    if (problems.length > 40) console.error(`  … and ${problems.length - 40} more`)
+    process.exit(1)
+  }
+  console.log('PASSED — zero internal 404s, nothing escapes the base path')
+}
diff --git a/src/manifest.mjs b/src/manifest.mjs
new file mode 100644
index 0000000..6cbbb73
--- /dev/null
+++ b/src/manifest.mjs
@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+/**
+ * The expected-change manifest.
+ *
+ * Built from `acts/text/` BEFORE any provision is written, and used to gate
+ * every commit that applies an Act: a provision may change only if the manifest
+ * says that Act changes it, and it must then match the Act's prescribed text.
+ * Anything else aborts.
+ *
+ * Roughly twenty provisions change across three Acts. An unexpected diff in
+ * that volume is precisely what nobody catches by eye, and the difference
+ * between a mechanical transcription and a rewrite is whether it was declared
+ * in advance.
+ */
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import yaml from 'js-yaml'
+import { loadActs } from './acts-parse.mjs'
+import { clauseHeadings } from './title-source.mjs'
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+
+export const ACT_ID = {
+  'first-constitution-amendment-act-2024.txt': 'act-1-2024',
+  'second-constitution-amendment-act-2024.txt': 'act-2-2024',
+  'third-constitution-amendment-act-2024.txt': 'act-3-2024'
+}
+
+/** Strip the common indent the PDF layout adds, without touching relative indent. */
+export function dedent (text) {
+  const lines = String(text).replace(/\s+$/, '').split('\n')
+  const indents = lines.filter(l => l.trim()).map(l => l.match(/^[ \t]*/)[0].length)
+  const min = indents.length ? Math.min(...indents) : 0
+  return lines.map(l => l.slice(min)).join('\n').replace(/[ \t]+$/gm, '')
+}
+
+/**
+ * Derive an article's shape from the Act's own clause layout. Never invented:
+ *
+ *  - text before the first clause marker is the article body;
+ *  - a clause whose first line is a short label ("(1) Eligibility") becomes a
+ *    section with that heading;
+ *  - a clause that opens straight into a sentence stays in the body, numbering
+ *    and all, because the Act did not give it a heading.
+ *
+ * So Act 2's Article 8 yields five sections, and its Article 20 yields none.
+ */
+export function deriveStructure (actText) {
+  const text = dedent(actText)
+
+  // Top-level clauses only. The marker must start the line with no indent:
+  // Article 8's "1. Stipend" is a clause, the indented "1. The student should
+  // fill out…" nested inside its Selection Process is not, and allowing leading
+  // whitespace pulled both in as siblings.
+  const markers = [...text.matchAll(/^(?:\((\d+)\)|(\d+)\.)[ \t]*/gm)]
+  if (!markers.length) return { content: text, sections: [] }
+
+  const label = m => {
+    const first = text.slice(m.index + m[0].length).split('\n')[0].trim()
+    return first.split(':')[0].trim()
+  }
+  const looksLikeHeading = l => l.length > 0 && l.length <= 48 && !/[.;]$/.test(l)
+
+  // Sections only when the Act headed EVERY top-level clause. A mixed run is a
+  // numbered list, not a set of headed subdivisions: Article 9's clause (5)
+  // opens "The board consists of the following members:", which is short enough
+  // to look like a heading on its own but sits among five full sentences.
+  const allHeaded = markers.every(m => looksLikeHeading(label(m)))
+  if (!allHeaded) return { content: text, sections: [] }
+
+  const body = text.slice(0, markers[0].index).trim()
+  const sections = markers.map((m, i) => {
+    const end = i + 1 < markers.length ? markers[i + 1].index : text.length
+    const lines = text.slice(m.index + m[0].length, end).split('\n')
+    return {
+      number: Number(m[1] ?? m[2]),
+      title: lines[0].split(':')[0].trim(),
+      content: dedent(lines.slice(1).join('\n')).trim()
+    }
+  })
+  return { content: body, sections }
+}
+
+export function buildManifest () {
+  const acts = loadActs(ROOT)
+  const current = yaml.load(fs.readFileSync(path.join(ROOT, 'constitution/current.yaml'), 'utf8'), { schema: yaml.CORE_SCHEMA })
+  const byId = new Map(current.articles.map(a => [a.id, a]))
+
+  const entries = []
+  for (const act of acts) {
+    const actId = ACT_ID[path.basename(act.file)]
+    for (const p of act.provisions) {
+      const existing = p.target === 'preamble' ? current.preamble : byId.get(p.target)
+      const structure = p.scope === 'article' ? deriveStructure(p.text) : null
+      entries.push({
+        act: actId,
+        source: `${act.file}:${p.source_line}-${p.end_line}`,
+        target: p.target,
+        operation: p.operation,
+        scope: p.scope,
+        clauses: p.clauses ?? null,
+        enacted_title: p.enacted_title ?? null,
+        current_title: existing?.title ?? null,
+        exists: !!existing,
+        prescribed: dedent(p.text),
+        structure
+      })
+    }
+  }
+  return entries
+}
+
+const direct = process.argv[1] && fileURLToPath(import.meta.url) === path.resolve(process.argv[1])
+if (direct) {
+  const entries = buildManifest()
+  const json = process.argv.includes('--json')
+  if (json) { console.log(JSON.stringify(entries, null, 2)); process.exit(0) }
+
+  for (const e of entries) {
+    const rename = e.enacted_title && e.current_title && e.enacted_title !== e.current_title
+    console.log(`\n${e.act}  ${e.target}  ${e.operation}/${e.scope}${e.clauses ? ` cl=${e.clauses}` : ''}  ${e.exists ? '' : '(NEW)'}`)
+    if (rename) console.log(`    TITLE: ${JSON.stringify(e.current_title)} -> ${JSON.stringify(e.enacted_title)}`)
+    if (e.structure) {
+      console.log(`    body: ${e.structure.content ? JSON.stringify(e.structure.content.slice(0, 64)) + '…' : '(none)'}`)
+      for (const s of e.structure.sections) {
+        console.log(`    s-${s.number}: ${JSON.stringify(s.title)}  ${s.content.length} chars`)
+      }
+      if (!e.structure.sections.length) console.log('    sections: none — the Act headed no clause')
+    }
+  }
+  console.log(`\n${entries.length} provisions across ${new Set(entries.map(e => e.act)).size} Acts`)
+}
diff --git a/src/og.mjs b/src/og.mjs
new file mode 100644
index 0000000..ec5ee35
--- /dev/null
+++ b/src/og.mjs
@@ -0,0 +1,118 @@
+/**
+ * Build-time Open Graph images.
+ *
+ * Social scrapers do not run JavaScript. This is the entire reason links to
+ * the constitution have previewed as a blank grey rectangle: there was nothing
+ * in the served HTML for them to read, and no image to fall back on.
+ *
+ * One 1200×630 PNG per page, rasterised from SVG. If no rasteriser is present
+ * the build still succeeds and every expected path is filled with the brand
+ * banner, so `og:image` can never point at a 404.
+ */
+import fs from 'node:fs'
+import path from 'node:path'
+import { execFileSync } from 'node:child_process'
+
+const W = 1200
+const H = 630
+
+const PALETTE = {
+  ink: '#320063',
+  canvas: '#f5f5f5',
+  body: '#333333',
+  muted: '#cecdcd',
+  action: '#c07534'
+}
+
+const esc = s => String(s ?? '')
+  .replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;')
+  .replace(/"/g, '&quot;').replace(/'/g, '&apos;')
+
+/** Greedy wrap by estimated advance width — no font metrics available here. */
+function wrap (text, maxChars, maxLines) {
+  const words = String(text).split(/\s+/).filter(Boolean)
+  const lines = []
+  let line = ''
+  for (const w of words) {
+    const next = line ? `${line} ${w}` : w
+    if (next.length > maxChars && line) { lines.push(line); line = w } else { line = next }
+    if (lines.length === maxLines) break
+  }
+  if (line && lines.length < maxLines) lines.push(line)
+  if (lines.length === maxLines && words.join(' ').length > lines.join(' ').length) {
+    lines[maxLines - 1] = lines[maxLines - 1].replace(/[,;:.\s]+$/, '') + '…'
+  }
+  return lines
+}
+
+// Inline presentation attributes only, never a <style> block with CSS classes.
+// Without librsvg on PATH, ImageMagick falls back to its own MSVG renderer,
+// which does not resolve class selectors — the plate came out blank or errored.
+// Single quotes inside: the value sits in a double-quoted XML attribute, and a
+// nested double quote terminates it early — which produced an SVG the
+// rasteriser rejected with a misleading "No such file or directory".
+const FONT = "'DejaVu Sans','Liberation Sans',Arial,sans-serif"
+
+function svg ({ kicker, title, footer, logoDataUri, badge }) {
+  const lines = wrap(title, 26, 3)
+  const startY = lines.length === 1 ? 340 : lines.length === 2 ? 300 : 262
+  const body = lines.map((l, i) =>
+    `<text x="80" y="${startY + i * 76}" font-family="${FONT}" font-size="62" font-weight="bold" fill="#ffffff">${esc(l)}</text>`
+  ).join('\n  ')
+
+  return `<svg xmlns="http://www.w3.org/2000/svg" width="${W}" height="${H}" viewBox="0 0 ${W} ${H}">
+  <rect width="${W}" height="${H}" fill="${PALETTE.ink}"/>
+  <rect x="0" y="0" width="14" height="${H}" fill="${PALETTE.action}"/>
+  ${logoDataUri ? `<image href="${logoDataUri}" x="80" y="64" width="76" height="76" preserveAspectRatio="xMidYMid meet"/>` : ''}
+  <text x="${logoDataUri ? 180 : 80}" y="118" font-family="${FONT}" font-size="30" font-weight="bold" fill="${PALETTE.action}" letter-spacing="3">${esc(kicker)}</text>
+  ${body}
+  <text x="80" y="${H - 66}" font-family="${FONT}" font-size="26" fill="${PALETTE.muted}">${esc(footer)}</text>
+  ${badge ? `<rect x="${W - 320}" y="${H - 106}" width="240" height="48" rx="24" fill="${PALETTE.canvas}"/>
+  <text x="${W - 200}" y="${H - 74}" font-family="${FONT}" font-size="22" font-weight="bold" fill="${PALETTE.ink}" text-anchor="middle">${esc(badge)}</text>` : ''}
+</svg>`
+}
+
+function rasteriser () {
+  for (const [cmd, args] of [
+    ['rsvg-convert', (i, o) => ['-w', String(W), '-h', String(H), '-o', o, i]],
+    ['convert', (i, o) => [i, '-resize', `${W}x${H}`, o]],
+    ['inkscape', (i, o) => [i, '--export-type=png', `--export-filename=${o}`]]
+  ]) {
+    try {
+      execFileSync('sh', ['-c', `command -v ${cmd}`], { stdio: 'ignore' })
+      return { cmd, args }
+    } catch { /* not installed; try the next */ }
+  }
+  return null
+}
+
+export function generateOgImages (outDir, pages, { logoPath, bannerPath } = {}) {
+  fs.mkdirSync(outDir, { recursive: true })
+
+  let logoDataUri = null
+  if (logoPath && fs.existsSync(logoPath)) {
+    logoDataUri = 'data:image/png;base64,' + fs.readFileSync(logoPath).toString('base64')
+  }
+
+  const r = rasteriser()
+  const tmp = path.join(outDir, '.og.svg')
+  let made = 0
+  let fallback = 0
+
+  for (const page of pages) {
+    const out = path.join(outDir, `${page.slug}.png`)
+    if (r) {
+      fs.writeFileSync(tmp, svg({ ...page, logoDataUri }))
+      try {
+        execFileSync(r.cmd, r.args(tmp, out), { stdio: 'ignore' })
+        made++
+        continue
+      } catch { /* fall through to the banner */ }
+    }
+    // Never leave og:image pointing at nothing.
+    if (bannerPath && fs.existsSync(bannerPath)) { fs.copyFileSync(bannerPath, out); fallback++ }
+  }
+  fs.rmSync(tmp, { force: true })
+
+  return { made, fallback, rasteriser: r?.cmd ?? null }
+}
diff --git a/src/provenance.mjs b/src/provenance.mjs
new file mode 100644
index 0000000..afce571
--- /dev/null
+++ b/src/provenance.mjs
@@ -0,0 +1,294 @@
+#!/usr/bin/env node
+/**
+ * Builds PROVENANCE.md: for every provision the three Acts touch, a comparison
+ * of the text in the constitution today, the text the Act prescribes, and the
+ * text as it stood before the Act.
+ *
+ * This is an analysis tool. It changes no constitutional text and never
+ * resolves a DIVERGENT verdict — it only reports one.
+ */
+
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import yaml from 'js-yaml'
+import { loadActs } from './acts-parse.mjs'
+import { classify, similarity, containment, normalise, MATCH_THRESHOLD } from './text-compare.mjs'
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+const load = rel => yaml.load(fs.readFileSync(path.join(ROOT, rel), 'utf8'), { schema: yaml.CORE_SCHEMA })
+
+const ACT_META = {
+  'first-constitution-amendment-act-2024.txt': { id: 'act-1-2024', label: 'Act 1 of 2024', short: 'Membership Act, 2024' },
+  'second-constitution-amendment-act-2024.txt': { id: 'act-2-2024', label: 'Act 2 of 2024', short: null },
+  'third-constitution-amendment-act-2024.txt': { id: 'act-3-2024', label: 'Act 3 of 2024', short: 'Finance Act, 2024' }
+}
+
+/** Everything a reader sees under a provision: its body plus each section's heading and body. */
+function fullText (node) {
+  if (!node) return null
+  const parts = [node.content ?? '']
+  for (const s of node.sections ?? []) parts.push(s.title ?? '', s.content ?? '')
+  return parts.join('\n').trim()
+}
+
+function findProvision (doc, target) {
+  if (target === 'preamble') return doc.preamble
+  const n = Number(target.replace('art-', ''))
+  return doc.articles.find(a => a.number === n) ?? null
+}
+
+/** Split an Act's clause-scope segment on its own `(N)` markers. */
+function splitClauses (text) {
+  const re = /^[ \t]*\((\d+)\)/gm
+  const marks = [...text.matchAll(re)]
+  if (!marks.length) return null
+  return marks.map((m, i) => ({
+    number: Number(m[1]),
+    text: text.slice(m.index, i + 1 < marks.length ? marks[i + 1].index : undefined).trim()
+  }))
+}
+
+/**
+ * Three measures, because one is not enough to tell the three verdicts apart:
+ *
+ *   simEnacted     how closely the provision reads as the Act prescribes
+ *   containEnacted whether the Act's words appear here at all, even if the
+ *                  provision also retains text the Act deleted
+ *   drift          whether the provision has changed since before the Acts
+ *
+ * `drift` is what distinguishes NOT-APPLIED from DIVERGENT. Judging on
+ * similarity-to-the-Act alone reports a provision that is word-for-word its
+ * own pre-Act text as DIVERGENT, purely because the Act rewrote it heavily —
+ * which is the definition of NOT-APPLIED, not of an unauthorised edit.
+ */
+export function verdictFor (current, enacted, prior, { contained }) {
+  const hasCurrent = normalise(current).length > 0
+  const drift = prior == null ? (hasCurrent ? 0 : 1) : similarity(current, prior)
+  const containEnacted = containment(enacted, current)
+  const simEnacted = contained ? containEnacted : similarity(current, enacted)
+
+  let verdict
+  if (!hasCurrent) verdict = 'NOT-APPLIED'                    // insertion not yet made
+  else if (simEnacted >= MATCH_THRESHOLD) verdict = 'ALREADY-APPLIED'
+  else if (drift >= MATCH_THRESHOLD) verdict = 'NOT-APPLIED'  // word-for-word the pre-Act text
+  else verdict = 'DIVERGENT'
+
+  return { verdict, simEnacted, drift, containEnacted }
+}
+
+function analyse () {
+  const current = load('constitution/current.yaml')
+  const prior = load('constitution/versions/v1.0.0.yaml')
+  const acts = loadActs(ROOT)
+  const rows = []
+
+  for (const act of acts) {
+    const meta = ACT_META[path.basename(act.file)]
+    for (const p of act.provisions) {
+      const cur = findProvision(current, p.target)
+      const pri = findProvision(prior, p.target)
+      const curText = fullText(cur)
+      const priText = fullText(pri)
+
+      const clauses = p.scope === 'clause' ? splitClauses(p.text) : null
+
+      // The heading names which clauses the Act amends. If the body does not
+      // yield exactly those, a clause has been lost in extraction and every
+      // verdict below it is incomplete. Fail loudly rather than under-report.
+      if (p.scope === 'clause') {
+        const expected = p.clauses.split(',').map(Number).sort((a, b) => a - b)
+        const found = (clauses ?? []).map(c => c.number).sort((a, b) => a - b)
+        if (expected.join() !== found.join()) {
+          throw new Error(
+            `${p.target}: heading names clause(s) ${expected.join(', ')} but the body yields ` +
+            `${found.length ? found.join(', ') : 'none'} (${act.file} line ${p.source_line}). ` +
+            'Extraction is incomplete; do not trust any verdict until this is resolved.'
+          )
+        }
+      }
+
+      if (clauses) {
+        for (const c of clauses) {
+          rows.push({
+            act: meta, target: p.target, clause: c.number, scope: 'clause',
+            operation: p.operation, source_line: p.source_line,
+            enacted_title: p.enacted_title,
+            currentTitle: cur?.title ?? null, priorTitle: pri?.title ?? null,
+            current: curText, enacted: c.text, prior: priText,
+            ...verdictFor(curText, c.text, priText, { contained: true })
+          })
+        }
+      } else {
+        const sectionsText = (cur?.sections ?? []).flatMap(s => [s.title ?? '', s.content ?? '']).join('\n').trim()
+        const breakdown = (cur?.sections?.length && cur?.content)
+          ? {
+              bodyInAct: containment(cur.content, p.text),
+              sectionsVsAct: similarity(sectionsText, p.text),
+              bodyVsPrior: pri?.content ? similarity(cur.content, pri.content) : 0
+            }
+          : null
+        rows.push({
+          breakdown,
+          act: meta, target: p.target, clause: null, scope: 'article',
+          operation: p.operation, source_line: p.source_line,
+          enacted_title: p.enacted_title,
+          currentTitle: cur?.title ?? null, priorTitle: pri?.title ?? null,
+          current: curText, enacted: p.text, prior: priText,
+          ...verdictFor(curText, p.text, priText, { contained: false })
+        })
+      }
+    }
+  }
+  return { rows, current, prior }
+}
+
+// ---------------------------------------------------------------------------
+
+const MARK = { 'ALREADY-APPLIED': '🟢', 'NOT-APPLIED': '🟡', DIVERGENT: '🔴' }
+const pct = n => (n * 100).toFixed(1) + '%'
+const fence = s => '```\n' + (s && s.trim() ? s.trim() : '(no text)') + '\n```'
+
+function render ({ rows }) {
+  const counts = rows.reduce((a, r) => ({ ...a, [r.verdict]: (a[r.verdict] ?? 0) + 1 }), {})
+  const divergent = rows.filter(r => r.verdict === 'DIVERGENT')
+  const out = []
+
+  out.push('# Provenance')
+  out.push('')
+  out.push('**Status:** unsigned. No constitutional text has been changed.')
+  out.push(`**Generated:** \`npm run provenance\` · branch \`rebuild/v3\` · ${rows.length} comparisons`)
+  out.push('')
+  out.push('For every provision the three Acts touch: the text in `constitution/current.yaml` today,')
+  out.push('the text the Act prescribes, and a verdict. Regenerate with `npm run provenance`.')
+  out.push('')
+  out.push('| Verdict | Meaning | Count |')
+  out.push('|---|---|---|')
+  out.push(`| 🟢 ALREADY-APPLIED | Current text matches the Act's prescribed text | ${counts['ALREADY-APPLIED'] ?? 0} |`)
+  out.push(`| 🟡 NOT-APPLIED | Current text is the pre-Act text, or the insertion has not been made | ${counts['NOT-APPLIED'] ?? 0} |`)
+  out.push(`| 🔴 DIVERGENT | Matches neither — edited outside the amendment process | ${counts.DIVERGENT ?? 0} |`)
+  out.push('')
+
+  out.push('## Method')
+  out.push('')
+  out.push('Comparison runs on `src/text-compare.mjs`. Tags are stripped **before** punctuation and')
+  out.push('replaced with a space, so inline `<br>` in the specs cannot inject a stray `br` token and')
+  out.push('produce a false NOT-APPLIED. `tests/text-compare.test.mjs` asserts this against the real')
+  out.push('Article 9 pair; if that fixture fails, no verdict in this file may be trusted.')
+  out.push('')
+  out.push('Enumerator style (`(1)` vs `1.`) and typography (curly vs straight quotes) are folded, so')
+  out.push('a provision is not reported as changed merely for being formatted differently.')
+  out.push('')
+  out.push('- **Article scope** — whole-provision similarity, body plus every section heading and body.')
+  out.push('- **Clause scope** — containment: whether the Act\'s clause appears anywhere in the current')
+  out.push('  provision. The constitution stores several of these articles as one undivided block, and')
+  out.push('  slicing it into clauses would mean guessing where each clause begins.')
+  out.push('')
+  out.push(`Match threshold ${MATCH_THRESHOLD}. Pre-Act baseline is \`constitution/versions/v1.0.0.yaml\`,`)
+  out.push('the last version that demonstrably predates all three Acts.')
+  out.push('')
+
+  if (divergent.length) {
+    out.push('## 🔴 DIVERGENT — stop here')
+    out.push('')
+    out.push(`${divergent.length} provision(s) match neither the Act nor the pre-Act text. These are not`)
+    out.push('classified further and must not be resolved without a decision from the board.')
+    out.push('')
+    for (const r of divergent) {
+      out.push(`- **${r.target}${r.clause ? ` clause (${r.clause})` : ''}** (${r.act.label}) — ` +
+        `reads as the Act ${pct(r.simEnacted)}, the Act's words are ${pct(r.containEnacted)} present, ` +
+        `${pct(r.drift)} unchanged since v1.`)
+      if (r.breakdown) {
+        out.push('')
+        out.push(`  Splitting the provision shows where the divergence sits:`)
+        out.push('')
+        out.push(`  | Part | Matches the Act | Matches pre-Act text |`)
+        out.push(`  |---|---|---|`)
+        out.push(`  | Sections | **${pct(r.breakdown.sectionsVsAct)}** | — |`)
+        out.push(`  | Article body | ${pct(r.breakdown.bodyInAct)} | ${pct(r.breakdown.bodyVsPrior)} |`)
+        out.push('')
+        out.push(`  The Act's text is present in full; the article additionally retains a body the Act`)
+        out.push(`  does not enact. Under a full substitution that body would have been deleted.`)
+        out.push('')
+      }
+    }
+    out.push('')
+  }
+
+  out.push('## Summary')
+  out.push('')
+  out.push('| | Act | Provision | Op | Scope | Current title | Act title | Reads as Act | Act words present | Unchanged since v1 | Verdict |')
+  out.push('|---|---|---|---|---|---|---|---|---|---|---|')
+  for (const r of rows) {
+    const name = `\`${r.target}\`${r.clause ? ` (${r.clause})` : ''}`
+    out.push(`| ${MARK[r.verdict]} | ${r.act.label} | ${name} | ${r.operation} | ${r.scope} | ` +
+      `${r.currentTitle ? `${r.currentTitle}` : '—'} | ${r.enacted_title ?? '—'} | ` +
+      `${pct(r.simEnacted)} | ${pct(r.containEnacted)} | ${pct(r.drift)} | **${r.verdict}** |`)
+  }
+  out.push('')
+
+  out.push('## Provision by provision')
+  out.push('')
+  let lastAct = null
+  for (const r of rows) {
+    if (r.act.label !== lastAct) {
+      out.push(`### ${r.act.label}${r.act.short ? ` — *${r.act.short}*` : ''}`)
+      out.push('')
+      lastAct = r.act.label
+    }
+    const head = `${r.target}${r.clause ? ` clause (${r.clause})` : ''}`
+    out.push(`#### ${MARK[r.verdict]} ${head} — ${r.verdict}`)
+    out.push('')
+    out.push(`\`${r.operation}\` · ${r.scope} scope · source \`${r.act.id}\` line ${r.source_line}`)
+    out.push('')
+    out.push(`Reads as the Act **${pct(r.simEnacted)}** · Act's words present ${pct(r.containEnacted)} · ` +
+      `unchanged since v1 ${pct(r.drift)}`)
+    if (r.currentTitle !== r.enacted_title && r.enacted_title) {
+      out.push('')
+      out.push(`> Title: current \`${r.currentTitle ?? '—'}\` → enacted \`${r.enacted_title}\``)
+    }
+    out.push('')
+    out.push('<details><summary>Current text — <code>constitution/current.yaml</code></summary>')
+    out.push('')
+    out.push(fence(r.current))
+    out.push('')
+    out.push('</details>')
+    out.push('')
+    out.push('<details><summary>Enacted text — as the Act prescribes it</summary>')
+    out.push('')
+    out.push(fence(r.enacted))
+    out.push('')
+    out.push('</details>')
+    out.push('')
+  }
+
+  out.push('## Sign-off')
+  out.push('')
+  out.push('Applying an amendment already in force would duplicate or revert a provision, so every')
+  out.push('🟡 NOT-APPLIED row must be confirmed before Phase 3 applies anything.')
+  out.push('')
+  for (const r of rows) {
+    out.push(`- [ ] ${MARK[r.verdict]} \`${r.target}${r.clause ? `(${r.clause})` : ''}\` — ${r.act.label} — ${r.verdict}`)
+  }
+  out.push('')
+  return out.join('\n')
+}
+
+// Importing this module (for `verdictFor`, in tests) must not rewrite the
+// report on disk. Generation happens only when the script is run directly.
+const invokedDirectly = process.argv[1] && fileURLToPath(import.meta.url) === path.resolve(process.argv[1])
+if (invokedDirectly) {
+  const result = analyse()
+  fs.writeFileSync(path.join(ROOT, 'PROVENANCE.md'), render(result))
+
+  const counts = result.rows.reduce((a, r) => ({ ...a, [r.verdict]: (a[r.verdict] ?? 0) + 1 }), {})
+  console.log(`PROVENANCE.md — ${result.rows.length} comparisons`)
+  for (const [k, v] of Object.entries(counts)) console.log(`  ${MARK[k]} ${k.padEnd(16)} ${v}`)
+  if (counts.DIVERGENT) {
+    console.log('\nDIVERGENT provisions (not classified further):')
+    for (const r of result.rows.filter(x => x.verdict === 'DIVERGENT')) {
+      console.log(`  ${r.target}${r.clause ? `(${r.clause})` : ''}  ${r.act.label}  ` +
+        `reads-as-act=${pct(r.simEnacted)} act-words-present=${pct(r.containEnacted)} unchanged-since-v1=${pct(r.drift)}`)
+    }
+  }
+}
diff --git a/src/scripts/.gitkeep b/src/scripts/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/src/scripts/app.js b/src/scripts/app.js
new file mode 100644
index 0000000..f200e7a
--- /dev/null
+++ b/src/scripts/app.js
@@ -0,0 +1,421 @@
+/**
+ * Progressive enhancement for the constitution site. The document is complete
+ * without this file, so every feature is guarded: the amendment register, the
+ * archive and the 404 page carry no table of contents and no copy buttons, and
+ * this module must stay silent there. No imports, no build step. Loaded as
+ * type="module", so it is deferred and the DOM is parsed by the time it runs.
+ */
+
+const byId = id => document.getElementById(id)
+const all = (sel, root = document) => Array.from(root.querySelectorAll(sel))
+const make = (tag, text) => { const n = document.createElement(tag); n.textContent = text ?? ''; return n }
+// Read live: the OS setting can change without a reload.
+const behavior = () => (window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 'auto' : 'smooth')
+
+/**
+ * How much of the page the sticky header covers. Anchors are citation handles;
+ * landing with the heading hidden under the header makes a cited provision look
+ * like the one above it, so every programmatic scroll pays this offset.
+ */
+function headerOffset () {
+  const root = document.documentElement
+  const raw = getComputedStyle(root).getPropertyValue('--header-h').trim()
+  let px = parseFloat(raw)
+  if (!Number.isFinite(px)) px = byId('site-header')?.getBoundingClientRect().height ?? 0
+  else if (raw.endsWith('rem')) px *= parseFloat(getComputedStyle(root).fontSize) || 16
+  return px + 12
+}
+
+/** Scroll to an element id on this page. Returns false if it is not here. */
+function goToId (id, { push = false } = {}) {
+  const el = byId(id)
+  if (!el) return false
+  if (push) history.pushState(null, '', '#' + id)
+  window.scrollTo({ top: Math.max(0, window.scrollY + el.getBoundingClientRect().top - headerOffset()), behavior: behavior() })
+  // Match native fragment navigation: the target takes focus, not just the eye.
+  if (!el.hasAttribute('tabindex')) el.setAttribute('tabindex', '-1')
+  el.focus({ preventScroll: true })
+  return true
+}
+
+// --- 1. Hash resolution, including the retired #article5 / #article5-section2 ids ---
+
+let legacyPromise = null
+const legacyMap = () => (legacyPromise ??= fetch(new URL('../legacy-anchors.json', import.meta.url))
+  .then(r => (r.ok ? r.json() : {})).catch(() => ({})))
+
+async function resolveHash () {
+  const raw = decodeURIComponent(location.hash.slice(1))
+  if (!raw) return
+  // A live anchor still needs re-scrolling: the browser's own jump ignores the
+  // sticky header, and on a cold load it happens before this module runs.
+  if (goToId(raw)) return
+  const mapped = (await legacyMap())[raw]
+  if (!mapped || !byId(mapped)) return
+  history.replaceState(null, '', '#' + mapped)
+  goToId(mapped)
+}
+
+function initHashRouting () {
+  let scrolled = false
+  window.addEventListener('scroll', () => { scrolled = true }, { passive: true, once: true })
+  resolveHash()
+  // Late images and webfonts can move the target after the first pass.
+  window.addEventListener('load', () => { if (!scrolled) resolveHash() }, { once: true })
+  window.addEventListener('hashchange', resolveHash)
+
+  // Take over same-page anchors so the offset applies without the visible
+  // double jump of letting the browser land first and correcting afterwards.
+  document.addEventListener('click', e => {
+    if (e.defaultPrevented || e.button !== 0 || e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return
+    const a = e.target.closest?.('a[href]')
+    if (!a || a.target === '_blank') return
+    let url
+    try { url = new URL(a.href, location.href) } catch { return }
+    if (url.pathname !== location.pathname || url.search !== location.search) return
+    const id = decodeURIComponent(url.hash.slice(1))
+    if (!id || !byId(id)) return
+    e.preventDefault()
+    closeModal()
+    goToId(id, { push: true })
+  })
+}
+
+// --- 2. Theme toggle --------------------------------------------------------
+
+const stored = key => { try { return localStorage.getItem(key) } catch { return null } }
+
+function initTheme () {
+  const btn = byId('theme-toggle')
+  if (!btn) return
+  const root = document.documentElement
+  const system = window.matchMedia('(prefers-color-scheme: dark)')
+
+  const paint = theme => {
+    root.setAttribute('data-theme', theme)
+    const dark = theme === 'dark'
+    btn.setAttribute('aria-pressed', String(dark))
+    btn.setAttribute('aria-label', dark ? 'Switch to light theme' : 'Switch to dark theme')
+    btn.title = dark ? 'Dark theme' : 'Light theme'
+  }
+
+  // The inline head script has already set data-theme; only the label is new.
+  paint(stored('theme') || root.getAttribute('data-theme') || (system.matches ? 'dark' : 'light'))
+
+  btn.addEventListener('click', () => {
+    const next = root.getAttribute('data-theme') === 'dark' ? 'light' : 'dark'
+    paint(next)
+    try { localStorage.setItem('theme', next) } catch { /* private mode: holds for this session */ }
+  })
+  // Follow the OS only while the reader has never expressed a preference.
+  system.addEventListener('change', e => { if (!stored('theme')) paint(e.matches ? 'dark' : 'light') })
+}
+
+// --- 3 + 4. Focus mode, the provision in view, and the contents scroll spy ---
+
+function initReading () {
+  const focusBtn = byId('focus-toggle')
+  focusBtn?.addEventListener('click', () => {
+    const on = document.body.classList.toggle('is-focus-mode')
+    focusBtn.setAttribute('aria-pressed', String(on))
+    focusBtn.setAttribute('aria-label', on ? 'Leave focus mode' : 'Focus mode')
+  })
+
+  const provisions = all('.provision[id]')
+  if (!provisions.length || !('IntersectionObserver' in window)) return
+  let current = null
+
+  const mark = el => {
+    if (el === current) return
+    current?.classList.remove('is-in-view')
+    current = el
+    if (!el) return
+    el.classList.add('is-in-view') // set always; the stylesheet uses it in focus mode
+
+    // Never build a selector from an href: anchors are the public citation API
+    // and may hold characters that are not valid CSS. data-anchor is the key.
+    let matched = null
+    for (const link of all('.toc__link[data-anchor]')) {
+      const hit = link.dataset.anchor === el.id
+      link.classList.toggle('is-active', hit)
+      if (hit) matched = link
+    }
+    if (!matched) return
+    // is-current on the enclosing item is what opens that article's toc__sub.
+    const item = matched.closest('.toc__item')
+    for (const other of all('.toc__item')) other.classList.toggle('is-current', other === item)
+  }
+
+  // Sections sit inside their article, so both match .provision[id]. Keeping the
+  // last one to cross the reading line prefers the section over its parent
+  // article, which is what a reader means by "where am I".
+  const pick = () => {
+    const line = headerOffset() + 4
+    let best = null
+    for (const el of provisions) {
+      if (el.getBoundingClientRect().top <= line) best = el
+      else if (!best) return el
+    }
+    return best
+  }
+
+  const io = new IntersectionObserver(() => mark(pick()), {
+    rootMargin: `-${Math.round(headerOffset())}px 0px -55% 0px`
+  })
+  for (const el of provisions) io.observe(el)
+}
+
+// --- Modal plumbing shared by the contents sheet and the search dialog ------
+
+let active = null // { el, opener }
+
+const focusable = root => all(
+  'a[href], button:not([disabled]), input:not([disabled]), select, textarea, [tabindex]:not([tabindex="-1"])', root
+).filter(el => el.getClientRects().length > 0)
+
+// Only touch aria-expanded where the HTML declares it; the Ctrl+K opener can be
+// any focused element and must not be given ARIA it never asked for.
+const expanded = (el, state) => { if (el?.hasAttribute('aria-expanded')) el.setAttribute('aria-expanded', state) }
+
+function openModal (el, opener, first) {
+  if (!el) return
+  closeModal()
+  active = { el, opener }
+  el.hidden = false
+  document.body.classList.add('is-modal-open')
+  expanded(opener, 'true')
+  ;(first || focusable(el)[0])?.focus()
+}
+
+function closeModal () {
+  if (!active) return
+  const { el, opener } = active
+  active = null
+  el.hidden = true
+  document.body.classList.remove('is-modal-open')
+  expanded(opener, 'false')
+  if (opener?.isConnected) opener.focus()
+}
+
+// Escape closes; Tab is trapped inside whichever surface is open.
+document.addEventListener('keydown', e => {
+  if (!active) return
+  if (e.key === 'Escape') { e.preventDefault(); closeModal(); return }
+  if (e.key !== 'Tab') return
+  const items = focusable(active.el)
+  if (!items.length) { e.preventDefault(); return }
+  const first = items[0]
+  const last = items[items.length - 1]
+  const here = document.activeElement
+  const outside = !active.el.contains(here)
+  if (e.shiftKey && (here === first || outside)) { e.preventDefault(); last.focus() } else if (!e.shiftKey && (here === last || outside)) { e.preventDefault(); first.focus() }
+})
+
+// --- 5. Mobile contents sheet -----------------------------------------------
+
+function initSheet () {
+  const fab = byId('toc-fab')
+  const sheet = byId('toc-sheet')
+  if (!fab || !sheet) return
+  const close = byId('toc-close')
+  fab.addEventListener('click', () => openModal(sheet, fab, close))
+  close?.addEventListener('click', closeModal)
+  sheet.addEventListener('click', e => { if (e.target === sheet) closeModal() }) // scrim
+}
+
+// --- 6. Search --------------------------------------------------------------
+
+function initSearch () {
+  const dialog = byId('search-dialog')
+  const input = byId('search-input')
+  const results = byId('search-results')
+  if (!dialog || !input || !results) return
+  const opener = byId('search-open')
+  const hint = byId('search-hint')
+  const hintText = hint?.textContent ?? ''
+
+  let index = null
+  let rows = []
+  let cursor = -1
+
+  input.setAttribute('role', 'combobox')
+  input.setAttribute('aria-autocomplete', 'list')
+  input.setAttribute('aria-controls', 'search-results')
+  input.setAttribute('aria-expanded', 'false')
+
+  // Fetched on first open, never on page load: most readers never search.
+  const load = () => (index
+    ? Promise.resolve(index)
+    : fetch(new URL('../search-index.json', import.meta.url))
+      .then(r => (r.ok ? r.json() : [])).catch(() => [])
+      .then(data => (index = Array.isArray(data) ? data : [])))
+
+  const match = q => {
+    const needle = q.trim().toLowerCase()
+    if (!needle || !index) return []
+    const scored = []
+    for (const row of index) {
+      const at = (row.t || '').toLowerCase().indexOf(needle)
+      if (at === 0) scored.push([0, row])
+      else if (at > 0) scored.push([1, row])
+      else if ((row.x || '').toLowerCase().includes(needle)) scored.push([2, row])
+    }
+    // Sort is stable, so document order survives inside each band.
+    return scored.sort((a, b) => a[0] - b[0]).slice(0, 25).map(s => s[1])
+  }
+
+  const highlight = i => {
+    cursor = i
+    const items = Array.from(results.children)
+    items.forEach((li, n) => li.setAttribute('aria-selected', String(n === i)))
+    if (items[i]) {
+      input.setAttribute('aria-activedescendant', items[i].id)
+      items[i].scrollIntoView({ block: 'nearest' })
+    } else input.removeAttribute('aria-activedescendant')
+  }
+
+  const render = () => {
+    results.textContent = ''
+    rows.forEach((row, i) => {
+      const li = make('li')
+      li.id = 'search-result-' + i
+      li.setAttribute('role', 'option')
+      li.setAttribute('aria-selected', 'false')
+      li.dataset.index = String(i)
+      // Provision title first, then the article it belongs to: the pair is what
+      // makes "3. Membership" unambiguous in a list of eighteen articles.
+      li.append(make('strong', row.t || row.id), make('span', row.at || 'Preamble'))
+      results.append(li)
+    })
+    input.setAttribute('aria-expanded', String(rows.length > 0))
+    const q = input.value.trim()
+    if (hint) hint.textContent = q && !rows.length ? `No provision matches “${q}”.` : hintText
+    highlight(rows.length ? 0 : -1)
+  }
+
+  /** Same-page anchor if the provision is here, else the article page that owns it. */
+  const go = row => {
+    if (!row) return
+    closeModal()
+    if (goToId(row.id, { push: true })) return
+    const base = row.a ? new URL('../articles/' + row.a + '/', import.meta.url) : new URL('../', import.meta.url)
+    location.href = base.href + '#' + row.id
+  }
+
+  const open = from => {
+    openModal(dialog, from, input)
+    input.select()
+    load().then(() => { rows = match(input.value); render() })
+  }
+
+  opener?.addEventListener('click', () => open(opener))
+  input.addEventListener('input', () => { rows = match(input.value); render() })
+
+  document.addEventListener('keydown', e => {
+    if (!(e.ctrlKey || e.metaKey) || (e.key !== 'k' && e.key !== 'K')) return
+    e.preventDefault()
+    if (active?.el === dialog) return closeModal()
+    // Focus returns wherever it came from, which may not be the search button.
+    const from = document.activeElement
+    open(from && from !== document.body ? from : opener)
+  })
+
+  input.addEventListener('keydown', e => {
+    if (e.key === 'ArrowDown' || e.key === 'ArrowUp') {
+      if (!rows.length) return
+      e.preventDefault()
+      highlight((cursor + (e.key === 'ArrowDown' ? 1 : -1) + rows.length) % rows.length)
+    } else if (e.key === 'Enter') {
+      e.preventDefault()
+      go(rows[cursor >= 0 ? cursor : 0])
+    }
+  })
+
+  results.addEventListener('click', e => {
+    const li = e.target.closest?.('li[data-index]')
+    if (li) go(rows[Number(li.dataset.index)])
+  })
+  dialog.addEventListener('click', e => { if (e.target === dialog) closeModal() })
+}
+
+// --- 7. Copy link -----------------------------------------------------------
+
+function initCopy () {
+  const buttons = all('button.copy[data-copy]')
+  if (!buttons.length) return
+  const toast = byId('toast')
+  let timer = 0
+
+  const say = message => {
+    if (!toast) return
+    // Both signals: the stylesheet may reveal on content (:not(:empty)) or state.
+    toast.textContent = message
+    toast.classList.add('is-visible')
+    clearTimeout(timer)
+    timer = setTimeout(() => { toast.classList.remove('is-visible'); toast.textContent = '' }, 2400)
+  }
+
+  const legacyCopy = text => {
+    const ta = document.createElement('textarea')
+    ta.value = text
+    ta.setAttribute('readonly', '')
+    ta.style.cssText = 'position:fixed;top:0;left:-9999px;opacity:0'
+    document.body.append(ta)
+    ta.select()
+    let ok = false
+    try { ok = document.execCommand('copy') } catch { /* no fallback left */ }
+    ta.remove()
+    return ok
+  }
+
+  for (const btn of buttons) {
+    btn.addEventListener('click', async () => {
+      const href = location.origin + location.pathname + location.search + '#' + btn.dataset.copy
+      let ok = false
+      // navigator.clipboard exists only in a secure context; file:// has none.
+      if (navigator.clipboard?.writeText) {
+        try { await navigator.clipboard.writeText(href); ok = true } catch { /* fall through */ }
+      }
+      if (!ok) ok = legacyCopy(href)
+      say(ok ? 'Link copied' : 'Press Ctrl+C to copy the link')
+    })
+  }
+}
+
+// --- 8 + 9. Reading progress and back to top --------------------------------
+
+function initScrollUi () {
+  const bar = byId('progress-bar')
+  const toTop = byId('to-top')
+  if (!bar && !toTop) return
+  let ticking = false
+
+  const update = () => {
+    ticking = false
+    if (bar) {
+      const max = document.documentElement.scrollHeight - window.innerHeight
+      const ratio = max > 8 ? Math.min(1, Math.max(0, window.scrollY / max)) : 0
+      // transform only: animating width would relayout the page every frame.
+      bar.style.transform = 'scaleX(' + ratio.toFixed(4) + ')'
+    }
+    if (toTop) toTop.hidden = window.scrollY <= 400
+  }
+  const onScroll = () => { if (!ticking) { ticking = true; requestAnimationFrame(update) } }
+
+  window.addEventListener('scroll', onScroll, { passive: true })
+  window.addEventListener('resize', onScroll, { passive: true })
+  toTop?.addEventListener('click', () => {
+    window.scrollTo({ top: 0, behavior: behavior() })
+    // Move focus off the button before it hides itself out from under the user.
+    byId('site-header')?.querySelector('a, button')?.focus()
+  })
+  update() // a reload can restore a deep scroll position
+}
+
+initHashRouting()
+initTheme()
+initReading()
+initSheet()
+initSearch()
+initCopy()
+initScrollUi()
diff --git a/src/styles/.gitkeep b/src/styles/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/src/styles/layout.css b/src/styles/layout.css
new file mode 100644
index 0000000..4ab8cad
--- /dev/null
+++ b/src/styles/layout.css
@@ -0,0 +1,1448 @@
+/* =============================================================================
+   layout.css — the whole visual system for the rendered constitution.
+
+   Assumes tokens.css has already defined the palette and scale:
+     --canvas --ink --muted --surface --border --accent --accent-2 --action
+     --shadow --header-h --measure --radius --focus --space-1..--space-6
+     --font-display --font-body --font-num
+
+   Two rules govern everything below.
+
+   1. Prose first. This is a legal document. Text is set at 18px/1.65, capped at
+      a 68ch measure, ragged right — never justified, because justification in a
+      narrow column opens rivers and legal text is read line by line, not
+      skimmed. Article and section numbers are citation handles, so they get
+      their own slot in the left margin rather than running into the title.
+
+   2. No universal transitions. Only color, background-color, border-color,
+      transform and opacity are ever transitioned, and only on the handful of
+      elements that actually change state.
+   ========================================================================== */
+
+/* --- Fonts ---------------------------------------------------------------
+   Only two files exist on disk. Montserrat is a genuine variable font
+   (wght 100–900, defaulting to Thin), so every element that uses it sets an
+   explicit weight. Cuprum, despite its filename, ships here as a static
+   instance, so it is declared at a single weight and never asked to synthesise
+   others. Both swap: the text must be readable before the fonts land.
+   Paths are relative — the site is served under a sub-path (/OpenCodeLaw/).   */
+
+/* Fonts are declared once, in tokens.css. */
+
+/* --- Derived tokens ------------------------------------------------------
+   These are additions, not overrides: tokens.css stays the source of truth for
+   the palette. They exist because two brand colours cannot legally carry text
+   at 4.5:1 in both themes, and a contrast failure is not a style opinion.
+
+     --accent    #320063  13.5:1 on #f5f5f5  ✓ light    1.1:1 on #333333  ✗ dark
+     --accent-2  #007bff   3.7:1 on #f5f5f5  ✗          3.2:1 on #333333  ✗
+     --action    #c07534   3.3:1 on #f5f5f5  ✗          3.5:1 on #333333  ✗
+
+   So each gets a text-safe tint or shade *within its own hue* — purple stays at
+   270°, blue at 211°, amber at 28°. No new hue family is introduced. The raw
+   brand values keep their jobs as fills, rules and highlights, where 3:1 for
+   non-text contrast is the bar and all three clear it.                        */
+
+/* --- Base ---------------------------------------------------------------- */
+
+*,
+*::before,
+*::after { box-sizing: border-box; }
+
+html {
+  -webkit-text-size-adjust: 100%;
+  scroll-padding-top: calc(var(--header-h, 3.5rem) + var(--space-4, 1.5rem));
+}
+
+@media (prefers-reduced-motion: no-preference) {
+  html { scroll-behavior: smooth; }
+}
+
+body {
+  margin: 0;
+  background: var(--canvas);
+  color: var(--ink);
+  font-family: var(--font-body, ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);
+  font-size: 1.125rem;                       /* 18px, and still user-scalable  */
+  line-height: 1.65;
+  text-align: left;                          /* ragged right, everywhere       */
+  -webkit-font-smoothing: antialiased;
+}
+
+h1, h2, h3, h4, h5, h6 {
+  font-family: var(--font-display, "Montserrat", ui-sans-serif, system-ui, sans-serif);
+  font-weight: 700;
+  line-height: 1.22;
+  text-wrap: balance;
+  margin: 0;
+}
+
+p { margin: 0 0 var(--space-3, 1rem); }
+
+a {
+  color: var(--link-ink);
+  text-decoration-thickness: 1px;
+  text-underline-offset: 0.16em;
+}
+
+a:hover { text-decoration-thickness: 2px; }
+
+strong, b { font-weight: 700; }
+
+img { max-width: 100%; height: auto; }
+
+mark {
+  background: var(--action-wash);
+  color: inherit;
+  padding: 0.05em 0.2em;
+  border-radius: 3px;
+  box-shadow: inset 0 -1px 0 var(--action);
+}
+
+code, pre, kbd, samp { font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; }
+
+code {
+  font-size: 0.9em;
+  background: var(--accent-wash);
+  padding: 0.1em 0.35em;
+  border-radius: 4px;
+}
+
+pre {
+  overflow-x: auto;
+  padding: var(--space-3, 1rem);
+  background: var(--surface);
+  border: 1px solid var(--border);
+  border-radius: var(--radius, 8px);
+}
+
+pre code { background: none; padding: 0; }
+
+hr {
+  border: 0;
+  border-top: 1px solid var(--border);
+  margin: var(--space-5, 2rem) 0;
+}
+
+/* One ring, everywhere something is interactive. Split into longhands on
+   purpose: if --focus ever resolves to something unusable, outline-color falls
+   back to currentColor and the ring survives. */
+:focus-visible {
+  outline-width: 3px;
+  outline-style: solid;
+  outline-color: var(--ring);
+  outline-offset: 2px;
+  border-radius: 3px;
+}
+
+:focus:not(:focus-visible) { outline: none; }
+
+::selection {
+  background: var(--accent-wash);
+}
+
+/* Motion is an enhancement. Honour the system setting without exception. */
+@media (prefers-reduced-motion: reduce) {
+  *,
+  *::before,
+  *::after {
+    animation-duration: 0.01ms !important;
+    animation-iteration-count: 1 !important;
+    transition-duration: 0.01ms !important;
+    scroll-behavior: auto !important;
+  }
+}
+
+/* --- Utilities ----------------------------------------------------------- */
+
+.visually-hidden {
+  position: absolute !important;
+  width: 1px;
+  height: 1px;
+  margin: -1px;
+  padding: 0;
+  overflow: hidden;
+  clip: rect(0 0 0 0);
+  clip-path: inset(50%);
+  white-space: nowrap;
+  border: 0;
+}
+
+.skip-link {
+  position: fixed;
+  top: var(--space-2, 0.5rem);
+  left: var(--space-2, 0.5rem);
+  z-index: 500;
+  padding: var(--space-2, 0.5rem) var(--space-3, 1rem);
+  background: var(--surface);
+  color: var(--accent-ink);
+  border: 1px solid var(--border);
+  border-radius: var(--radius, 8px);
+  box-shadow: 0 6px 20px var(--shadow, rgba(0, 0, 0, 0.18));
+  font-family: var(--font-display, "Montserrat", sans-serif);
+  font-weight: 600;
+  text-decoration: none;
+  transform: translateY(calc(-100% - var(--space-4, 1.5rem)));
+  transition: transform 140ms ease-out;
+}
+
+.skip-link:focus { transform: translateY(0); }
+
+/* --- Reading progress ----------------------------------------------------
+   Fixed rather than sticky: the element precedes the header in the DOM, and it
+   has to sit *under* the sticky header regardless of scroll position. */
+
+.progress {
+  position: fixed;
+  top: var(--header-h, 3.5rem);
+  left: 0;
+  right: 0;
+  height: 3px;
+  z-index: 99;
+  pointer-events: none;
+  background: transparent;
+}
+
+.progress__bar {
+  height: 100%;
+  width: 100%;
+  transform: scaleX(0);
+  transform-origin: 0 50%;
+  background: var(--action);
+  will-change: transform;
+  transition: transform 90ms linear;
+}
+
+/* --- Header --------------------------------------------------------------- */
+
+.site-header {
+  position: sticky;
+  top: 0;
+  z-index: 100;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: var(--space-3, 1rem);
+  height: var(--header-h, 3.5rem);
+  padding: 0 var(--space-3, 1rem);
+  background: var(--surface);
+  border-bottom: 1px solid var(--border);
+}
+
+.site-header__brand {
+  display: flex;
+  align-items: center;
+  gap: var(--space-2, 0.5rem);
+  min-width: 0;
+  color: var(--ink);
+  text-decoration: none;
+  border-radius: var(--radius, 8px);
+}
+
+.site-header__logo {
+  width: 2rem;
+  height: 2rem;
+  flex: none;
+  object-fit: contain;
+}
+
+.site-header__title {
+  font-family: var(--font-display, "Montserrat", sans-serif);
+  font-weight: 700;
+  font-size: 0.95rem;
+  letter-spacing: 0.04em;
+  text-transform: uppercase;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+.site-header__brand:hover .site-header__title { color: var(--accent-ink); }
+
+.site-header__actions {
+  display: flex;
+  align-items: center;
+  gap: var(--space-1, 0.25rem);
+  flex: none;
+}
+
+/* --- Buttons -------------------------------------------------------------- */
+
+.btn {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.45em;
+  padding: 0.45em 0.75em;
+  font-family: inherit;
+  font-size: 0.85rem;
+  font-weight: 600;
+  line-height: 1.2;
+  color: var(--ink);
+  background: transparent;
+  border: 1px solid transparent;
+  border-radius: var(--radius, 8px);
+  cursor: pointer;
+  transition: background-color 140ms ease, color 140ms ease, border-color 140ms ease;
+}
+
+.btn:hover {
+  background: var(--accent-wash);
+  color: var(--accent-ink);
+}
+
+.btn[aria-pressed="true"] {
+  background: var(--accent-wash);
+  color: var(--accent-ink);
+  border-color: var(--accent-ink);
+}
+
+.btn--icon > [aria-hidden="true"] {
+  font-size: 1.15em;
+  line-height: 1;
+}
+
+.btn__label { white-space: nowrap; }
+
+/* The span is empty in the markup — the glyph is a pure presentation concern,
+   and the button already carries an accessible name. */
+.theme-toggle__icon::before { content: "\263E"; }              /* ☾ → go dark  */
+
+:root[data-theme="dark"] .theme-toggle__icon::before { content: "\2600"; }  /* ☀ */
+
+@media (prefers-color-scheme: dark) {
+  :root:not([data-theme="light"]) .theme-toggle__icon::before { content: "\2600"; }
+}
+
+/* --- Shell ---------------------------------------------------------------
+   Mobile first: one column. The ToC is server-rendered, so it is never hidden
+   outright — with JavaScript off the FAB and sheet do nothing, and a reader on
+   a phone would be left with no navigation at all. Instead it is reordered to
+   the end of the page, out of the way of the text but still there. From 900px
+   up it becomes the sticky sidebar. */
+
+.shell {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr);
+  gap: var(--space-5, 2rem);
+  max-width: 78rem;
+  margin: 0 auto;
+  padding: var(--space-5, 2rem) var(--space-4, 1.5rem) var(--space-6, 3rem);
+}
+
+.shell__aside {
+  order: 2;
+  padding-top: var(--space-4, 1.5rem);
+  border-top: 1px solid var(--border);
+}
+
+.shell__main {
+  order: 1;
+  min-width: 0;
+  outline: none;
+}
+
+.shell__main:focus-visible {
+  outline-width: 3px;
+  outline-style: solid;
+  outline-color: var(--ring);
+  outline-offset: 6px;
+}
+
+/* --- Table of contents ---------------------------------------------------- */
+
+.toc {
+  font-size: 0.95rem;
+  line-height: 1.45;
+}
+
+.toc__heading {
+  font-size: 0.78rem;
+  font-weight: 700;
+  letter-spacing: 0.12em;
+  text-transform: uppercase;
+  color: var(--muted);
+  margin-bottom: var(--space-2, 0.5rem);
+}
+
+.toc__list,
+.toc__sub {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+
+.toc__item { margin: 0; }
+
+.toc__link {
+  display: flex;
+  align-items: baseline;
+  gap: 0.55ch;
+  padding: 0.3em 0.5em 0.3em 0.6em;
+  border-left: 2px solid transparent;
+  border-radius: 0 var(--radius, 8px) var(--radius, 8px) 0;
+  color: var(--ink);
+  text-decoration: none;
+  transition: color 120ms ease, background-color 120ms ease, border-color 120ms ease;
+}
+
+.toc__link:hover {
+  background: var(--accent-wash);
+  color: var(--accent-ink);
+}
+
+.toc__num {
+  flex: none;
+  min-width: 2.1ch;
+  text-align: right;
+  font-family: var(--font-num, "Cuprum", ui-sans-serif, sans-serif);
+  font-variant-numeric: tabular-nums;
+  font-feature-settings: "tnum" 1;
+  color: var(--muted);
+}
+
+.toc__item--parent > .toc__link { font-weight: 600; }
+
+.toc__sub {
+  margin: 0 0 var(--space-2, 0.5rem) 1.15rem;
+  border-left: 1px solid var(--border);
+}
+
+.toc__link--sub {
+  font-size: 0.88rem;
+  color: var(--muted);
+  padding-top: 0.22em;
+  padding-bottom: 0.22em;
+}
+
+.toc__link--sub:hover { color: var(--accent-ink); }
+
+/* `is-current` is server-rendered (this page); `is-active` is the scroll-spy. */
+.toc__item.is-current > .toc__link,
+.toc__link.is-active {
+  color: var(--accent-ink);
+  font-weight: 700;
+  border-left-color: var(--accent-ink);
+  background: var(--accent-wash);
+}
+
+.toc__link--sub.is-active { font-weight: 600; }
+
+/* --- Banners -------------------------------------------------------------
+   Prominent, not alarming: a wash and a heavy left rule, no full-bleed colour.
+   The superseded banner is the one that must stop a reader, so it takes the
+   --action rule and a warmer wash. */
+
+.banner {
+  margin: 0 0 var(--space-5, 2rem);
+  padding: var(--space-4, 1.5rem);
+  background: var(--accent-wash);
+  border: 1px solid var(--border);
+  border-left: 5px solid var(--accent-ink);
+  border-radius: var(--radius, 8px);
+}
+
+.banner__title {
+  font-size: 1.05rem;
+  font-weight: 700;
+  color: var(--accent-ink);
+  margin-bottom: var(--space-2, 0.5rem);
+}
+
+.banner__lead {
+  max-width: var(--measure, 68ch);
+  margin-bottom: var(--space-3, 1rem);
+}
+
+.banner__list {
+  max-width: var(--measure, 68ch);
+  margin: 0 0 var(--space-3, 1rem);
+  padding-left: 1.15rem;
+}
+
+.banner__list li { margin-bottom: var(--space-2, 0.5rem); }
+
+.banner__note {
+  display: block;                 /* was inline: the note ran straight on from
+                                     the blocker label — "awaiting Q2Act 1 of
+                                     2024 also amends…" — on every page. */
+  margin-top: 0.35em;
+  color: var(--muted);
+  font-size: 0.92em;
+  line-height: 1.55;
+}
+
+.banner__more {
+  margin: 0;
+  font-size: 0.95rem;
+}
+
+.banner--superseded {
+  background: var(--action-wash);
+  border-left-color: var(--action);
+}
+
+.banner--superseded .banner__title { color: var(--action-ink); }
+
+/* --- Page furniture ------------------------------------------------------- */
+
+.page-title {
+  font-size: clamp(1.7rem, 1.2rem + 2.2vw, 2.6rem);
+  margin-bottom: var(--space-3, 1rem);
+  max-width: 24ch;
+}
+
+.page-title__num {
+  display: block;
+  font-family: var(--font-num, "Cuprum", sans-serif);
+  font-variant-numeric: tabular-nums;
+  font-size: 0.42em;
+  font-weight: 400;
+  letter-spacing: 0.14em;
+  text-transform: uppercase;
+  color: var(--accent-ink);
+  margin-bottom: 0.35em;
+}
+
+.page-lead {
+  max-width: var(--measure, 68ch);
+  font-size: 1.02rem;
+  color: var(--muted);
+  margin-bottom: var(--space-5, 2rem);
+}
+
+.section-title {
+  font-size: 1.45rem;
+  margin: var(--space-6, 3rem) 0 var(--space-4, 1.5rem);
+  padding-top: var(--space-4, 1.5rem);
+  border-top: 1px solid var(--border);
+  scroll-margin-top: calc(var(--header-h, 3.5rem) + var(--space-4, 1.5rem));
+}
+
+.crumbs {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 0.5ch;
+  font-size: 0.85rem;
+  color: var(--muted);
+  margin-bottom: var(--space-4, 1.5rem);
+}
+
+.crumbs [aria-current="page"] { color: var(--ink); }
+
+/* --- Pager ---------------------------------------------------------------- */
+
+.pager {
+  display: grid;
+  grid-template-columns: 1fr;
+  gap: var(--space-3, 1rem);
+  margin-top: var(--space-6, 3rem);
+  padding-top: var(--space-4, 1.5rem);
+  border-top: 1px solid var(--border);
+}
+
+.pager__link {
+  display: block;
+  padding: var(--space-3, 1rem);
+  background: var(--surface);
+  border: 1px solid var(--border);
+  border-radius: var(--radius, 8px);
+  color: var(--ink);
+  text-decoration: none;
+  transition: border-color 140ms ease, background-color 140ms ease;
+}
+
+.pager__link:hover {
+  border-color: var(--accent-ink);
+  background: var(--accent-wash);
+}
+
+.pager__link--prev { text-align: left; }
+
+.pager__link--next { text-align: right; }
+
+.pager__dir {
+  display: block;
+  font-size: 0.72rem;
+  font-weight: 700;
+  letter-spacing: 0.1em;
+  text-transform: uppercase;
+  color: var(--muted);
+  margin-bottom: 0.2em;
+}
+
+.pager__title {
+  display: block;
+  font-family: var(--font-display, "Montserrat", sans-serif);
+  font-weight: 600;
+  line-height: 1.3;
+}
+
+/* --- Provisions ----------------------------------------------------------
+   The number is a citation handle, not decoration. From 900px up it lives in
+   its own margin slot, tabular and in the numeral face, so a column of numbers
+   reads straight down the page and the titles all start on one line. Below
+   900px the slot collapses and the number sets inline, because a 3rem gutter
+   on a phone is 3rem stolen from the measure. */
+
+.provision {
+  position: relative;
+  margin: 0 0 var(--space-5, 2rem);
+  padding-left: var(--num-slot);
+  scroll-margin-top: calc(var(--header-h, 3.5rem) + var(--space-4, 1.5rem));
+}
+
+.provision:target {
+  outline: 2px solid var(--action);
+  outline-offset: var(--space-3, 1rem);
+  border-radius: 2px;
+}
+
+.provision__heading {
+  position: relative;
+  display: flex;
+  align-items: baseline;
+  flex-wrap: wrap;
+  gap: 0.5ch;
+  margin-bottom: var(--space-2, 0.5rem);
+  scroll-margin-top: calc(var(--header-h, 3.5rem) + var(--space-4, 1.5rem));
+}
+
+.provision__num {
+  font-family: var(--font-num, "Cuprum", ui-sans-serif, sans-serif);
+  font-variant-numeric: tabular-nums lining-nums;
+  font-feature-settings: "tnum" 1;
+  font-weight: 600;
+  color: var(--accent-ink);
+}
+
+.provision__title { min-width: 0; }
+
+.provision--article > .provision__heading { font-size: 1.35rem; }
+
+.provision--section > .provision__heading { font-size: 1.08rem; }
+
+.provision--preamble > .provision__heading {
+  font-size: 1.25rem;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+}
+
+.provision__body {
+  max-width: var(--measure, 68ch);
+  text-align: left;                          /* never justify legal prose      */
+  hyphens: manual;
+  overflow-wrap: break-word;
+}
+
+.provision__body > :last-child { margin-bottom: 0; }
+
+.provision__body ul,
+.provision__body ol {
+  margin: 0 0 var(--space-3, 1rem);
+  padding-left: 1.6rem;
+}
+
+.provision__body li { margin-bottom: 0.4em; }
+
+.provision__body li::marker {
+  color: var(--muted);
+  font-family: var(--font-num, "Cuprum", sans-serif);
+}
+
+.provision__body blockquote {
+  margin: 0 0 var(--space-3, 1rem);
+  padding-left: var(--space-3, 1rem);
+  border-left: 3px solid var(--border);
+  color: var(--muted);
+}
+
+.provision__body h3,
+.provision__body h4,
+.provision__body h5,
+.provision__body h6 {
+  font-size: 1.02rem;
+  margin: var(--space-4, 1.5rem) 0 var(--space-2, 0.5rem);
+}
+
+/* No wrapper element is emitted around tables, so the table itself has to be
+   the scroll container — the page body must never scroll sideways. */
+.provision__body table {
+  display: block;
+  max-width: 100%;
+  overflow-x: auto;
+  border-collapse: collapse;
+  margin-bottom: var(--space-3, 1rem);
+  font-size: 0.95rem;
+}
+
+.provision__body th,
+.provision__body td {
+  border: 1px solid var(--border);
+  padding: 0.4em 0.7em;
+  text-align: left;
+  vertical-align: top;
+}
+
+.provision__body th {
+  background: var(--surface);
+  font-weight: 700;
+}
+
+.provision__body caption {
+  caption-side: bottom;
+  font-size: 0.85rem;
+  color: var(--muted);
+  padding-top: 0.5em;
+}
+
+.provision__meta {
+  margin: var(--space-2, 0.5rem) 0 0;
+  font-size: 0.85rem;
+  color: var(--muted);
+}
+
+.provision__sections {
+  margin-top: var(--space-4, 1.5rem);
+  display: flow-root;
+}
+
+.provision__sections .provision {
+  margin-bottom: var(--space-4, 1.5rem);
+}
+
+/* A provision published without text, or reserved/omitted by an Act. The state
+   is part of the record, so it is shown rather than swept away. */
+.provision--reserved,
+.provision--omitted { color: var(--muted); }
+
+.provision--reserved .provision__title,
+.provision--omitted .provision__title { font-style: italic; }
+
+.no-text {
+  max-width: var(--measure, 68ch);
+  margin: 0;
+  padding: 0.4em 0.9em;
+  border-left: 3px dashed var(--border);
+  color: var(--muted);
+  font-style: italic;
+  font-size: 0.95rem;
+}
+
+/* --- Copy-link button ---------------------------------------------------
+   Ghosted until the heading is hovered or holds focus, but never hidden from
+   the keyboard: focus-visible always brings it back at full opacity. Pointer
+   devices without hover get it permanently. */
+
+.copy {
+  flex: none;
+  padding: 0.1em 0.35em;
+  font-size: 0.75em;
+  line-height: 1;
+  background: transparent;
+  border: 1px solid transparent;
+  border-radius: 6px;
+  color: var(--muted);
+  cursor: pointer;
+  opacity: 0;
+  transition: opacity 130ms ease, color 130ms ease, background-color 130ms ease;
+}
+
+.provision__heading:hover .copy,
+.provision__heading:focus-within .copy,
+.copy:focus-visible {
+  opacity: 1;
+}
+
+.copy:hover {
+  color: var(--accent-ink);
+  background: var(--accent-wash);
+}
+
+@media (hover: none) {
+  .copy { opacity: 1; }
+}
+
+/* --- Amendment chips ------------------------------------------------------ */
+
+.chips {
+  display: flex;
+  flex-wrap: wrap;
+  gap: var(--space-2, 0.5rem);
+  margin: 0 0 var(--space-3, 1rem);
+}
+
+.chip {
+  display: inline-flex;
+  align-items: baseline;
+  flex-wrap: wrap;
+  gap: 0.5ch;
+  padding: 0.2em 0.65em;
+  font-size: 0.8rem;
+  background: var(--surface);
+  border: 1px solid var(--border);
+  border-radius: 999px;
+}
+
+.chip__label {
+  color: var(--muted);
+  text-transform: uppercase;
+  letter-spacing: 0.06em;
+  font-size: 0.9em;
+}
+
+.chip__link {
+  color: var(--accent-ink);
+  font-weight: 600;
+  text-decoration: none;
+  border-bottom: 1px solid currentColor;
+}
+
+.chip__pdf {
+  font-size: 0.85em;
+  font-weight: 700;
+  letter-spacing: 0.06em;
+  color: var(--action-ink);
+  text-decoration: none;
+  padding: 0 0.4em;
+  border: 1px solid var(--action);
+  border-radius: 4px;
+}
+
+.chip__pdf:hover {
+  background: var(--action-wash);
+}
+
+/* --- Amendment register --------------------------------------------------- */
+
+.act {
+  margin: 0 0 var(--space-5, 2rem);
+  padding: var(--space-4, 1.5rem);
+  background: var(--surface);
+  border: 1px solid var(--border);
+  border-radius: var(--radius, 8px);
+  scroll-margin-top: calc(var(--header-h, 3.5rem) + var(--space-4, 1.5rem));
+}
+
+.act:target { border-color: var(--action); }
+
+.act__title {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: baseline;
+  gap: 0.6ch;
+  font-size: 1.25rem;
+  margin-bottom: var(--space-2, 0.5rem);
+}
+
+.act__num {
+  font-family: var(--font-num, "Cuprum", sans-serif);
+  font-variant-numeric: tabular-nums;
+  font-weight: 400;
+  color: var(--accent-ink);
+  white-space: nowrap;
+}
+
+.act__short {
+  font-size: 0.95rem;
+  color: var(--muted);
+  font-style: italic;
+  margin-bottom: var(--space-3, 1rem);
+}
+
+/* Status is the first thing a reader needs and the easiest thing to fake with
+   colour alone, so each pill carries its own words as well. */
+.act__status {
+  flex: none;
+  padding: 0.15em 0.7em;
+  font-family: var(--font-body, sans-serif);
+  font-size: 0.7rem;
+  font-weight: 700;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+  white-space: nowrap;
+  border-radius: 999px;
+  border: 1px solid currentColor;
+}
+
+.act__status--applied {
+  color: var(--accent-ink);
+  background: var(--accent-wash);
+}
+
+.act__status--partially-applied {
+  color: var(--action-ink);
+  background: var(--action-wash);
+}
+
+.act__status--pending {
+  color: var(--muted);
+  background: transparent;
+  border-color: var(--border);
+}
+
+.act__meta {
+  display: grid;
+  grid-template-columns: max-content minmax(0, 1fr);
+  column-gap: var(--space-4, 1.5rem);
+  row-gap: var(--space-1, 0.25rem);
+  margin: 0 0 var(--space-4, 1.5rem);
+  font-size: 0.95rem;
+}
+
+.act__meta dt {
+  font-size: 0.72rem;
+  font-weight: 700;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+  color: var(--muted);
+  padding-top: 0.45em;
+}
+
+.act__meta dd { margin: 0; }
+
+.act__sub {
+  font-size: 0.8rem;
+  font-weight: 700;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+  color: var(--muted);
+  margin-bottom: var(--space-2, 0.5rem);
+}
+
+.act__provisions {
+  max-width: var(--measure, 68ch);
+  margin: 0 0 var(--space-3, 1rem);
+  padding-left: 1.4rem;
+}
+
+.act__provisions li { margin-bottom: 0.35em; }
+
+.act__none {
+  max-width: var(--measure, 68ch);
+  color: var(--muted);
+  font-style: italic;
+}
+
+.act__unverified {
+  display: inline-block;
+  padding: 0.05em 0.5em;
+  font-size: 0.72rem;
+  font-weight: 700;
+  letter-spacing: 0.05em;
+  text-transform: uppercase;
+  color: var(--action-ink);
+  background: var(--action-wash);
+  border-radius: 4px;
+}
+
+/* --- Discrepancies and approval chains (<details>) ------------------------ */
+
+.disc {
+  margin: 0 0 var(--space-3, 1rem);
+  padding: var(--space-2, 0.5rem) var(--space-3, 1rem);
+  background: var(--canvas);
+  border: 1px solid var(--border);
+  border-radius: var(--radius, 8px);
+}
+
+.disc > summary {
+  cursor: pointer;
+  font-family: var(--font-display, "Montserrat", sans-serif);
+  font-weight: 600;
+  font-size: 0.95rem;
+  padding: 0.25em 0;
+  border-radius: 4px;
+}
+
+.disc > summary:hover { color: var(--accent-ink); }
+
+.disc[open] > summary {
+  margin-bottom: var(--space-2, 0.5rem);
+  padding-bottom: var(--space-2, 0.5rem);
+  border-bottom: 1px solid var(--border);
+}
+
+.disc blockquote {
+  max-width: var(--measure, 68ch);
+  margin: 0 0 var(--space-3, 1rem);
+  padding: 0.2em 0 0.2em var(--space-3, 1rem);
+  border-left: 3px solid var(--action);
+  font-size: 0.97rem;
+}
+
+.disc__label {
+  margin-bottom: 0.25rem;
+  font-size: 0.72rem;
+  font-weight: 700;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+  color: var(--muted);
+}
+
+.disc__note {
+  max-width: var(--measure, 68ch);
+  margin: 0;
+  font-size: 0.92rem;
+  color: var(--muted);
+}
+
+.proc {
+  max-width: var(--measure, 68ch);
+  margin: var(--space-2, 0.5rem) 0 0;
+  padding-left: 1.4rem;
+  font-size: 0.95rem;
+}
+
+.proc li { margin-bottom: 0.35em; }
+
+.proc__body { font-weight: 600; }
+
+/* --- Version lists (archive, 404) ----------------------------------------- */
+
+.versions {
+  list-style: none;
+  max-width: var(--measure, 68ch);
+  margin: 0 0 var(--space-5, 2rem);
+  padding: 0;
+}
+
+.versions__item {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: baseline;
+  gap: var(--space-2, 0.5rem);
+  padding: var(--space-3, 1rem);
+  background: var(--surface);
+  border: 1px solid var(--border);
+  border-left: 4px solid var(--border);
+  border-radius: var(--radius, 8px);
+  margin-bottom: var(--space-2, 0.5rem);
+}
+
+.versions__item a { text-decoration: none; }
+
+.versions__item a:hover { text-decoration: underline; }
+
+.versions__item--current { border-left-color: var(--accent-ink); }
+
+.versions__badge {
+  padding: 0.1em 0.6em;
+  font-size: 0.7rem;
+  font-weight: 700;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+  color: var(--accent-ink);
+  background: var(--accent-wash);
+  border: 1px solid currentColor;
+  border-radius: 999px;
+}
+
+.versions__badge--old {
+  color: var(--muted);
+  background: transparent;
+  border-color: var(--border);
+}
+
+.versions__date {
+  margin-left: auto;
+  font-family: var(--font-num, "Cuprum", sans-serif);
+  font-variant-numeric: tabular-nums;
+  font-size: 0.88rem;
+  color: var(--muted);
+}
+
+/* --- Footer --------------------------------------------------------------- */
+
+.site-footer {
+  padding: var(--space-5, 2rem) var(--space-4, 1.5rem) calc(var(--space-6, 3rem) + env(safe-area-inset-bottom, 0px));
+  border-top: 1px solid var(--border);
+  background: var(--surface);
+  font-size: 0.92rem;
+  text-align: center;
+}
+
+.site-footer p { margin: 0 0 var(--space-2, 0.5rem); }
+
+.site-footer__meta {
+  font-family: var(--font-num, "Cuprum", sans-serif);
+  font-variant-numeric: tabular-nums;
+  color: var(--muted);
+  font-size: 0.85rem;
+}
+
+/* --- Contents FAB (small screens only) ------------------------------------ */
+
+.toc-fab {
+  position: fixed;
+  right: var(--space-3, 1rem);
+  bottom: calc(var(--space-3, 1rem) + env(safe-area-inset-bottom, 0px));
+  z-index: 60;
+  display: inline-flex;
+  align-items: center;
+  gap: 0.5ch;
+  height: var(--fab-h);
+  padding: 0 1.1rem;
+  font-family: var(--font-display, "Montserrat", sans-serif);
+  font-size: 0.9rem;
+  font-weight: 700;
+  color: var(--on-accent);
+  background: var(--accent-ink);
+  border: 0;
+  border-radius: 999px;
+  box-shadow: 0 6px 20px var(--shadow, rgba(0, 0, 0, 0.18));
+  cursor: pointer;
+  transition: transform 140ms ease, background-color 140ms ease;
+}
+
+.toc-fab:hover { transform: translateY(-2px); }
+
+/* --- Bottom sheet --------------------------------------------------------- */
+
+.sheet {
+  position: fixed;
+  inset: 0;
+  z-index: 200;
+  display: flex;
+  align-items: flex-end;
+  background: rgba(0, 0, 0, 0.5);
+}
+
+.sheet[hidden] { display: none; }
+
+.sheet__panel {
+  display: flex;
+  flex-direction: column;
+  width: 100%;
+  max-height: 80vh;
+  background: var(--surface);
+  border-top: 1px solid var(--border);
+  border-radius: var(--radius, 8px) var(--radius, 8px) 0 0;
+  box-shadow: 0 -8px 30px var(--shadow, rgba(0, 0, 0, 0.18));
+}
+
+/* Animated rather than transitioned: the panel goes from display:none to
+   visible in one step when [hidden] is removed, and a transition cannot see
+   that change. */
+.sheet:not([hidden]) .sheet__panel {
+  animation: sheet-in 200ms ease-out;
+}
+
+@keyframes sheet-in {
+  from { transform: translateY(100%); opacity: 0; }
+  to { transform: translateY(0); opacity: 1; }
+}
+
+.sheet__head {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: var(--space-3, 1rem);
+  padding: var(--space-3, 1rem) var(--space-4, 1.5rem);
+  border-bottom: 1px solid var(--border);
+}
+
+.sheet__title {
+  font-size: 0.8rem;
+  font-weight: 700;
+  letter-spacing: 0.12em;
+  text-transform: uppercase;
+  color: var(--muted);
+}
+
+.sheet__head .btn { border-color: var(--border); }
+
+.sheet__body {
+  overflow-y: auto;
+  overscroll-behavior: contain;
+  -webkit-overflow-scrolling: touch;
+  padding: var(--space-3, 1rem) var(--space-4, 1.5rem)
+           calc(var(--space-4, 1.5rem) + env(safe-area-inset-bottom, 0px));
+}
+
+/* Inside the sheet the ToC is just a list — the sticky column behaviour and
+   its height cap belong to the desktop sidebar only. */
+.sheet .toc {
+  position: static;
+  max-height: none;
+  overflow: visible;
+  padding: 0;
+}
+
+.sheet .toc__heading { display: none; }
+
+/* --- Search dialog (command palette) -------------------------------------- */
+
+.dialog {
+  position: fixed;
+  inset: 0;
+  z-index: 300;
+  display: flex;
+  align-items: flex-start;
+  justify-content: center;
+  padding: max(8vh, var(--space-4, 1.5rem)) var(--space-3, 1rem) var(--space-4, 1.5rem);
+  background: rgba(0, 0, 0, 0.5);
+}
+
+.dialog[hidden] { display: none; }
+
+.dialog__panel {
+  display: flex;
+  flex-direction: column;
+  width: min(40rem, 100%);
+  max-height: 78vh;
+  padding: var(--space-3, 1rem);
+  background: var(--surface);
+  border: 1px solid var(--border);
+  border-radius: var(--radius, 8px);
+  box-shadow: 0 18px 50px var(--shadow, rgba(0, 0, 0, 0.18));
+  animation: dialog-in 150ms ease-out;
+}
+
+@keyframes dialog-in {
+  from { transform: translateY(-8px); opacity: 0; }
+  to { transform: translateY(0); opacity: 1; }
+}
+
+.dialog__input {
+  width: 100%;
+  padding: 0.6em 0.8em;
+  font-family: inherit;
+  font-size: 1.05rem;
+  color: var(--ink);
+  background: var(--canvas);
+  border: 1px solid var(--border);
+  border-radius: var(--radius, 8px);
+  transition: border-color 140ms ease;
+}
+
+.dialog__input::placeholder { color: var(--muted); }
+
+.dialog__input:focus-visible { border-color: var(--accent-ink); }
+
+.dialog__hint {
+  margin: var(--space-2, 0.5rem) 0;
+  font-size: 0.8rem;
+  color: var(--muted);
+}
+
+.dialog__results {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+  overflow-y: auto;
+  overscroll-behavior: contain;
+}
+
+.dialog__results li + li { border-top: 1px solid var(--border); }
+
+.dialog__results a,
+.dialog__results button {
+  display: block;
+  width: 100%;
+  padding: 0.55em 0.7em;
+  font: inherit;
+  font-size: 0.95rem;
+  text-align: left;
+  color: var(--ink);
+  background: transparent;
+  border: 0;
+  border-radius: 6px;
+  text-decoration: none;
+  cursor: pointer;
+  transition: background-color 120ms ease, color 120ms ease;
+}
+
+.dialog__results a:hover,
+.dialog__results button:hover,
+.dialog__results [aria-selected="true"],
+.dialog__results .is-active {
+  background: var(--accent-wash);
+  color: var(--accent-ink);
+}
+
+.dialog__results small,
+.dialog__results .dialog__meta {
+  display: block;
+  color: var(--muted);
+  font-size: 0.82rem;
+}
+
+/* --- Toast ---------------------------------------------------------------- */
+
+.toast {
+  position: fixed;
+  left: 50%;
+  bottom: calc(var(--space-4, 1.5rem) + env(safe-area-inset-bottom, 0px));
+  z-index: 400;
+  max-width: min(30rem, calc(100vw - 2rem));
+  padding: 0.6em 1.1em;
+  font-size: 0.9rem;
+  color: var(--on-accent);
+  background: var(--accent-ink);
+  border-radius: 999px;
+  box-shadow: 0 8px 26px var(--shadow, rgba(0, 0, 0, 0.18));
+  opacity: 0;
+  pointer-events: none;
+  transform: translateX(-50%) translateY(0.75rem);
+  transition: opacity 160ms ease, transform 160ms ease;
+}
+
+.toast.is-visible {
+  opacity: 1;
+  transform: translateX(-50%) translateY(0);
+}
+
+/* --- Back to top ---------------------------------------------------------- */
+
+.to-top {
+  position: fixed;
+  right: var(--space-3, 1rem);
+  bottom: calc(var(--space-3, 1rem) + var(--fab-h) + var(--space-2, 0.5rem) + env(safe-area-inset-bottom, 0px));
+  z-index: 60;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 2.75rem;
+  height: 2.75rem;
+  font-size: 1.1rem;
+  line-height: 1;
+  color: var(--action-contrast);             /* 5.2:1 on the amber, both themes */
+  background: var(--action);
+  border: 0;
+  border-radius: 50%;
+  box-shadow: 0 6px 20px var(--shadow, rgba(0, 0, 0, 0.18));
+  cursor: pointer;
+  transition: transform 140ms ease, opacity 140ms ease;
+}
+
+.to-top[hidden] { display: none; }
+
+.to-top:hover { transform: translateY(-2px); }
+
+/* --- Focus mode ----------------------------------------------------------
+   Dims every provision except the one being read. The :has() rule keeps a
+   parent article lit while one of its sections is in view — opacity compounds
+   down the tree, so a dimmed parent would drag its live child down with it. */
+
+body.is-focus-mode .provision {
+  opacity: 0.38;
+  transition: opacity 200ms ease;
+}
+
+body.is-focus-mode .provision.is-in-view,
+body.is-focus-mode .provision:has(.provision.is-in-view) {
+  opacity: 1;
+}
+
+body.is-focus-mode .provision:focus-within { opacity: 1; }
+
+/* =============================================================================
+   Responsive
+   ========================================================================== */
+
+/* --- ≥600px: room for labels and two-up navigation ------------------------ */
+@media (min-width: 600px) {
+  .pager { grid-template-columns: 1fr 1fr; }
+}
+
+@media (max-width: 599px) {
+  .btn__label { display: none; }            /* icon-only; aria-label carries it */
+
+  .btn { padding: 0.45em 0.55em; }
+
+  .shell { padding: var(--space-4, 1.5rem) var(--space-3, 1rem) var(--space-6, 3rem); }
+
+  .act { padding: var(--space-3, 1rem); }
+
+  .act__meta { grid-template-columns: minmax(0, 1fr); }
+
+  .act__meta dt { padding-top: var(--space-2, 0.5rem); }
+
+  .versions__date { margin-left: 0; width: 100%; }
+
+  .page-title { font-size: clamp(1.5rem, 1.1rem + 3vw, 2rem); }
+}
+
+/* --- ≥900px: sidebar, margin numbering, no FAB ---------------------------- */
+@media (min-width: 900px) {
+  .shell {
+    grid-template-columns: minmax(0, 16rem) minmax(0, 1fr);
+    gap: var(--space-6, 3rem);
+    align-items: start;
+  }
+
+  .shell__aside {
+    order: 0;
+    padding-top: 0;
+    border-top: 0;
+  }
+
+  /* A long table of contents must scroll on its own, not push the page. */
+  .shell__aside .toc {
+    position: sticky;
+    top: var(--header-h, 3.5rem);
+    max-height: calc(100vh - var(--header-h, 3.5rem));
+    overflow-y: auto;
+    overscroll-behavior: contain;
+    scrollbar-gutter: stable;
+    padding: var(--space-4, 1.5rem) var(--space-2, 0.5rem) var(--space-5, 2rem) 0;
+  }
+
+  /* The FAB and sheet are the small-screen route to the same navigation. */
+  .toc-fab { display: none; }
+
+  .to-top {
+    bottom: calc(var(--space-4, 1.5rem) + env(safe-area-inset-bottom, 0px));
+  }
+
+  /* Numbers move into the margin. The slot is padding on the provision, so the
+     absolutely-positioned number lands inside the provision's own box and
+     never overhangs the main column. */
+  .provision--article,
+  .provision--preamble { --num-slot: 3.25rem; }
+
+  .provision--section { --num-slot: 2.75rem; }
+
+  .provision__num {
+    position: absolute;
+    left: calc(-1 * var(--num-slot));
+    top: 0;
+    width: calc(var(--num-slot) - 0.75rem);
+    text-align: right;
+    line-height: inherit;
+  }
+
+  .site-header { padding: 0 var(--space-4, 1.5rem); }
+}
+
+/* --- ≥1200px: a little more air around the column ------------------------- */
+@media (min-width: 1200px) {
+  .shell { grid-template-columns: minmax(0, 18rem) minmax(0, 1fr); }
+}
+
+/* Set by app.js while the search dialog or the mobile contents sheet is open.
+   Without it the page scrolls behind the overlay and the reader loses their
+   place in a long document. */
+body.is-modal-open {
+  overflow: hidden;
+}
+
+/* An editorial heading — supplied by an editor, not enacted by any instrument.
+   Deliberately quiet: it must be noticeable on inspection without competing
+   with the provision text, and it must never look like an error. */
+.title-mark {
+  display: inline-block;
+  margin-left: 0.35em;
+  padding: 0 0.3em;
+  border: 1px solid var(--border);
+  border-radius: var(--radius, 4px);
+  color: var(--muted);
+  background: var(--surface);
+  font-family: var(--font-num);
+  font-size: 0.62em;
+  font-weight: 600;
+  line-height: 1.6;
+  vertical-align: 0.28em;
+  cursor: help;
+}
diff --git a/src/styles/print.css b/src/styles/print.css
new file mode 100644
index 0000000..a8c70d1
--- /dev/null
+++ b/src/styles/print.css
@@ -0,0 +1,842 @@
+/* =========================================================================
+   print.css — the constitution on paper.
+
+   Loaded with media="print", and every rule is additionally wrapped in
+   @media print so the file stays inert if it is ever concatenated, inlined,
+   or linked without its media attribute.
+
+   The printed sheet is a legal instrument, not a screenshot of a website.
+   Chrome and every other browser is asked for the same thing: black ink on
+   white paper, one column, article numbers in the margin where a reader can
+   run a finger down them, and nothing on the page that only exists because
+   there was a pointer and a viewport.
+
+   This file loads after tokens.css and layout.css, so equal-specificity
+   rules here win on order. `!important` is reserved for the two places the
+   cascade cannot be won cleanly: the chrome that must never print, and the
+   theme tokens set under a dark-mode media query.
+   ========================================================================= */
+
+@media print {
+
+  /* -----------------------------------------------------------------------
+     1. Page box
+     -------------------------------------------------------------------- */
+
+  @page {
+    margin: 18mm;
+  }
+
+  /* Paged-media engines (Prince, WeasyPrint, PagedJS) fold a page number
+     into the bottom margin. Browsers drop this at-rule and print their own
+     header/footer instead, so the two never double up. Kept in its own
+     @page rule so a parser that chokes on the margin box still gets the
+     18mm margin above. */
+  @page {
+    @bottom-right {
+      content: counter(page) " / " counter(pages);
+      font: 9pt Georgia, "Times New Roman", serif;
+      color: #000;
+    }
+  }
+
+  /* -----------------------------------------------------------------------
+     2. Theme neutralisation
+
+     The document may be printed from either theme, and Chrome still
+     evaluates prefers-color-scheme while printing. Rather than fight each
+     colour declaration downstream, the tokens themselves are collapsed to
+     print values across every selector layout.css can define them on —
+     bare :root, both explicit data-theme values, and the JS-failed case
+     where no attribute was ever stamped.
+
+     Names that do not exist in tokens.css simply go unused; custom
+     properties never invalidate a rule.
+     -------------------------------------------------------------------- */
+
+  :root,
+  :root[data-theme="light"],
+  :root[data-theme="dark"],
+  :root:not([data-theme="light"]) {
+    color-scheme: light !important;
+
+    /* Every token the screen stylesheets actually define, flattened to ink on
+       paper. Overriding names that no stylesheet defines leaves the real ones
+       live: a reader printing from dark mode was getting ochre-on-wash chips. */
+    --canvas: #ffffff !important;
+    --surface: #ffffff !important;
+    --ink: #000000 !important;
+    --muted: #000000 !important;
+    --border: #000000 !important;
+    --accent: #000000 !important;
+    --accent-2: #000000 !important;
+    --action: #000000 !important;
+    --focus: #000000 !important;
+    --shadow: transparent !important;
+
+    /* Derived tokens (tokens.css) — the ones that carry colour onto chips,
+       pills, links and the ToC. */
+    --accent-ink: #000000 !important;
+    --on-accent: #ffffff !important;
+    --link-ink: #000000 !important;
+    --action-ink: #000000 !important;
+    --action-contrast: #000000 !important;
+    --ring: #000000 !important;
+    --accent-wash: transparent !important;
+    --action-wash: transparent !important;
+  }
+
+  /* Motion is meaningless on paper, and a half-finished transition can be
+     captured mid-flight by the print snapshot. */
+  *,
+  *::before,
+  *::after {
+    transition: none !important;
+    animation: none !important;
+    box-shadow: none !important;
+    text-shadow: none !important;
+  }
+
+  /* -----------------------------------------------------------------------
+     3. Canvas and base prose
+
+     11pt on paper reads at roughly the same angular size as 18pt on a desk
+     monitor; the 1.65 leading is carried over unchanged because that is
+     what makes long statutory sentences trackable.
+     -------------------------------------------------------------------- */
+
+  html,
+  body {
+    background: #fff !important;
+    color: #000 !important;
+    margin: 0;
+    padding: 0;
+    width: auto;
+    min-height: 0;
+    overflow: visible;
+  }
+
+  body {
+    font-family: Georgia, "Iowan Old Style", "Palatino Linotype",
+                 "Book Antiqua", "Times New Roman", Times, serif;
+    font-size: 11pt;
+    line-height: 1.65;
+    /* Ragged right. Legal prose is never justified: the rivers and the
+       stretched interword space cost more than the flush edge buys. */
+    text-align: left;
+    text-rendering: optimizeLegibility;
+    hyphens: manual;
+    -webkit-hyphens: manual;
+  }
+
+  p,
+  li,
+  dd,
+  dt,
+  blockquote {
+    text-align: left;
+    orphans: 3;
+    widows: 3;
+  }
+
+  /* Focus mode, scroll-spy dimming and any other reading aid must not
+     follow the document onto paper. */
+  .shell__main,
+  .shell__main * {
+    opacity: 1 !important;
+    filter: none !important;
+    visibility: visible;
+  }
+
+  /* -----------------------------------------------------------------------
+     4. Interface that does not print
+
+     Navigation, controls, overlays and progress. Everything here exists to
+     move around a scrolling viewport; paper has no viewport.
+     -------------------------------------------------------------------- */
+
+  .skip-link,
+  .progress,
+  .progress__bar,
+  .site-header,
+  .shell__aside,
+  .toc,
+  .toc-fab,
+  .sheet,
+  .dialog,
+  .toast,
+  .to-top,
+  .copy,
+  .btn,
+  .pager {
+    display: none !important;
+  }
+
+  [hidden] {
+    display: none !important;
+  }
+
+  /* -----------------------------------------------------------------------
+     5. Single column
+
+     The shell is a two-track grid on screen. With the aside gone it
+     collapses to one full-bleed column; the page box supplies the margins.
+     -------------------------------------------------------------------- */
+
+  .shell {
+    display: block;
+    grid-template-columns: none;
+    gap: 0;
+    max-width: none;
+    width: auto;
+    margin: 0;
+    padding: 0;
+  }
+
+  .shell__main {
+    display: block;
+    max-width: none;
+    width: auto;
+    margin: 0;
+    padding: 0;
+    overflow: visible;
+  }
+
+  /* -----------------------------------------------------------------------
+     6. Headings and titles
+     -------------------------------------------------------------------- */
+
+  h1, h2, h3, h4, h5, h6,
+  .page-title,
+  .section-title,
+  .provision__heading,
+  .act__title,
+  .banner__title {
+    font-family: "Montserrat", "Helvetica Neue", Arial, sans-serif;
+    color: #000;
+    font-weight: 700;
+    text-align: left;
+    /* A heading stranded at the foot of a page is a heading for nothing. */
+    break-after: avoid;
+    page-break-after: avoid;
+    break-inside: avoid;
+    page-break-inside: avoid;
+  }
+
+  .page-title {
+    font-size: 20pt;
+    line-height: 1.25;
+    margin: 0 0 3mm;
+  }
+
+  /* On a single-article page the citation handle leads the title rather
+     than sitting inside it. */
+  .page-title__num {
+    display: block;
+    font-family: "Cuprum", "Montserrat", Georgia, serif;
+    font-size: 11pt;
+    font-weight: 700;
+    letter-spacing: 0.08em;
+    text-transform: uppercase;
+    margin-bottom: 1.5mm;
+  }
+
+  .page-lead {
+    max-width: 68ch;
+    font-size: 10pt;
+    margin: 0 0 8mm;
+  }
+
+  .crumbs {
+    font-size: 9pt;
+    margin: 0 0 3mm;
+  }
+
+  /* "Articles" opens the articles on a fresh sheet and stays welded to the
+     first article, which would otherwise be torn away by the page break
+     rule in section 7. */
+  .section-title {
+    font-size: 14pt;
+    letter-spacing: 0.06em;
+    text-transform: uppercase;
+    margin: 0 0 6mm;
+    padding-bottom: 2mm;
+    border-bottom: 1pt solid #000;
+    break-before: page;
+    page-break-before: always;
+  }
+
+  /* -----------------------------------------------------------------------
+     7. Provisions
+
+     Article numbers are citation handles. On paper they are the only way
+     back into the document, so they keep their own slot hanging in the
+     margin, at full weight, never suppressed and never inlined into the
+     title.
+
+     The gutter is built from a hanging indent rather than absolute
+     positioning: it survives page breaks, and it degrades by nudging the
+     title rather than by overlapping it if a number runs long.
+     -------------------------------------------------------------------- */
+
+  .provision {
+    margin: 0 0 7mm;
+  }
+
+  .provision--article {
+    padding-left: 18mm;
+    break-before: page;
+    page-break-before: always;
+  }
+
+  /* The lone article on its own page, and the first article under the
+     "Articles" rule, must not push a blank sheet ahead of themselves. */
+  .page-title + .provision--article,
+  .section-title + .provision--article {
+    break-before: auto;
+    page-break-before: auto;
+  }
+
+  .provision--article > .provision__heading {
+    margin-left: -18mm;
+    padding-left: 18mm;
+    text-indent: -18mm;
+    font-size: 15pt;
+    line-height: 1.3;
+    margin-bottom: 4mm;
+  }
+
+  .provision--article > .provision__heading > .provision__num {
+    min-width: 14mm;
+    margin-right: 4mm;
+  }
+
+  /* A section is the unit a reader cites and quotes; it is kept whole on
+     one sheet wherever it will fit. */
+  .provision--section {
+    padding-left: 14mm;
+    margin: 0 0 5mm;
+    break-inside: avoid;
+    page-break-inside: avoid;
+  }
+
+  .provision--section > .provision__heading {
+    margin-left: -14mm;
+    padding-left: 14mm;
+    text-indent: -14mm;
+    font-size: 12pt;
+    line-height: 1.35;
+    margin-bottom: 2mm;
+  }
+
+  .provision--section > .provision__heading > .provision__num {
+    min-width: 10mm;
+    margin-right: 4mm;
+  }
+
+  .provision__num {
+    display: inline-block;
+    text-align: right;
+    font-family: "Cuprum", "Montserrat", Georgia, serif;
+    font-weight: 700;
+    font-variant-numeric: lining-nums tabular-nums;
+    color: #000;
+  }
+
+  .provision__title {
+    font-weight: 700;
+  }
+
+  .provision--preamble > .provision__heading {
+    font-size: 15pt;
+    letter-spacing: 0.08em;
+    margin-bottom: 4mm;
+  }
+
+  .provision__sections {
+    margin-top: 5mm;
+  }
+
+  .provision__body {
+    max-width: 68ch;
+    text-indent: 0;
+  }
+
+  .provision__body > :first-child { margin-top: 0; }
+  .provision__body > :last-child  { margin-bottom: 0; }
+
+  .provision__body p,
+  .provision__body ul,
+  .provision__body ol {
+    margin: 0 0 3mm;
+  }
+
+  .provision__body ul,
+  .provision__body ol {
+    padding-left: 7mm;
+  }
+
+  .provision__body li {
+    margin-bottom: 1.5mm;
+  }
+
+  .provision__meta {
+    max-width: 68ch;
+    font-size: 9pt;
+    font-style: italic;
+    margin: 3mm 0 0;
+  }
+
+  /* A provision published with no recorded text is a fact about the
+     document; it prints. */
+  .no-text {
+    max-width: 68ch;
+    font-style: italic;
+  }
+
+  .provision--reserved > .provision__heading,
+  .provision--omitted > .provision__heading {
+    font-style: italic;
+  }
+
+  /* -----------------------------------------------------------------------
+     8. Amendment provenance chips
+
+     "Amended by Act 1 of 2024" is the audit trail. It prints as plain
+     bracketed text — no pills, no fills, nothing that disappears when the
+     reader has background graphics switched off.
+     -------------------------------------------------------------------- */
+
+  .chips {
+    max-width: 68ch;
+    margin: 0 0 3mm;
+    font-size: 9pt;
+  }
+
+  .chip {
+    display: inline;
+    margin-right: 4mm;
+    border: 0;
+    padding: 0;
+    background: none;
+  }
+
+  .chip::before { content: "["; }
+  .chip::after  { content: "]"; }
+
+  .chip__label {
+    font-style: italic;
+  }
+
+  .chip__label::after {
+    content: " ";
+  }
+
+  .chip__pdf {
+    font-size: 8pt;
+  }
+
+  .chip__pdf::before {
+    content: " · ";
+  }
+
+  /* -----------------------------------------------------------------------
+     9. Banners
+
+     The reconciliation notice and the superseded-version notice both print.
+     A reader holding a paper copy has no other way of learning that the
+     text in their hands is mid-reconciliation or out of force, and that is
+     the single most important thing on the sheet.
+
+     Drawn with rules rather than a background fill, because background
+     graphics are off by default in most print dialogs.
+     -------------------------------------------------------------------- */
+
+  .banner {
+    display: block;
+    max-width: 68ch;
+    margin: 0 0 8mm;
+    padding: 4mm 5mm;
+    border: 1pt solid #000;
+    border-left-width: 3pt;
+    background: none;
+    color: #000;
+    break-inside: avoid;
+    page-break-inside: avoid;
+  }
+
+  .banner--superseded {
+    border-width: 2pt;
+    border-left-width: 5pt;
+  }
+
+  .banner__title {
+    font-size: 12pt;
+    letter-spacing: 0.04em;
+    text-transform: uppercase;
+    margin: 0 0 2mm;
+  }
+
+  .banner__lead {
+    margin: 0 0 2mm;
+  }
+
+  .banner__list {
+    margin: 0 0 2mm;
+    padding-left: 6mm;
+  }
+
+  .banner__list li {
+    margin-bottom: 1.5mm;
+  }
+
+  .banner__note {
+    display: block;
+    font-size: 9pt;
+    font-style: italic;
+  }
+
+  .banner__more {
+    margin: 0;
+    font-size: 10pt;
+  }
+
+  /* -----------------------------------------------------------------------
+     10. Amendment register
+     -------------------------------------------------------------------- */
+
+  .act {
+    margin: 0 0 8mm;
+    padding-top: 4mm;
+    border-top: 0.5pt solid #000;
+  }
+
+  .act__title {
+    font-size: 13pt;
+    line-height: 1.35;
+    margin: 0 0 2mm;
+  }
+
+  .act__num {
+    display: block;
+    font-family: "Cuprum", "Montserrat", Georgia, serif;
+    font-size: 10pt;
+    letter-spacing: 0.08em;
+    text-transform: uppercase;
+    font-variant-numeric: lining-nums tabular-nums;
+  }
+
+  .act__status {
+    display: inline-block;
+    margin-left: 2mm;
+    padding: 0 1.5mm;
+    border: 0.5pt solid #000;
+    background: none;
+    color: #000;
+    font-family: Georgia, "Times New Roman", serif;
+    font-size: 8pt;
+    font-weight: 400;
+    letter-spacing: 0.04em;
+    text-transform: uppercase;
+    vertical-align: 0.15em;
+  }
+
+  .act__short {
+    margin: 0 0 3mm;
+    font-style: italic;
+  }
+
+  .act__meta {
+    max-width: 68ch;
+    margin: 0 0 4mm;
+    font-size: 10pt;
+    break-inside: avoid;
+    page-break-inside: avoid;
+  }
+
+  .act__meta dt {
+    float: left;
+    clear: left;
+    width: 32mm;
+    font-weight: 700;
+  }
+
+  .act__meta dd {
+    margin: 0 0 1mm 34mm;
+  }
+
+  .act__meta::after {
+    content: "";
+    display: block;
+    clear: both;
+  }
+
+  .act__sub {
+    font-size: 11pt;
+    margin: 0 0 2mm;
+  }
+
+  .act__provisions {
+    max-width: 68ch;
+    margin: 0 0 4mm;
+    padding-left: 7mm;
+  }
+
+  .act__none {
+    max-width: 68ch;
+    font-style: italic;
+  }
+
+  .act__unverified {
+    font-size: 9pt;
+    font-style: italic;
+  }
+
+  .act__unverified::before { content: "("; }
+  .act__unverified::after  { content: ")"; }
+
+  /* Drafting discrepancies and approval chains are folded away on screen.
+     On paper nothing can be unfolded, so they are forced open: a
+     discrepancy between operative text and the statement of objects is
+     exactly the sort of thing a printed copy is made to carry.
+
+     Two mechanisms, because engines disagree on how a closed <details>
+     hides its contents. ::details-content lives in its own rule so older
+     parsers drop only that rule. */
+  details.disc,
+  details {
+    display: block;
+    break-inside: avoid;
+    page-break-inside: avoid;
+  }
+
+  details > *:not(summary) {
+    display: block !important;
+  }
+
+  details::details-content {
+    display: block !important;
+    content-visibility: visible !important;
+  }
+
+  .disc {
+    max-width: 68ch;
+    margin: 0 0 4mm;
+    padding-left: 4mm;
+    border-left: 0.5pt solid #000;
+  }
+
+  .disc summary {
+    display: block;
+    list-style: none;
+    font-family: "Montserrat", "Helvetica Neue", Arial, sans-serif;
+    font-weight: 700;
+    font-size: 10pt;
+    margin-bottom: 2mm;
+  }
+
+  .disc summary::-webkit-details-marker {
+    display: none;
+  }
+
+  .disc__label {
+    margin: 0 0 1mm;
+    font-size: 9pt;
+    font-weight: 700;
+    letter-spacing: 0.04em;
+    text-transform: uppercase;
+  }
+
+  .disc__note {
+    margin: 2mm 0 0;
+    font-size: 10pt;
+    font-style: italic;
+  }
+
+  .proc {
+    margin: 0;
+    padding-left: 7mm;
+    font-size: 10pt;
+  }
+
+  .proc__body {
+    font-weight: 700;
+    text-transform: capitalize;
+  }
+
+  /* -----------------------------------------------------------------------
+     11. Archive and 404 lists
+     -------------------------------------------------------------------- */
+
+  .versions {
+    max-width: 68ch;
+    margin: 0;
+    padding: 0;
+    list-style: none;
+  }
+
+  .versions__item {
+    padding: 2mm 0;
+    border-bottom: 0.5pt solid #000;
+    break-inside: avoid;
+    page-break-inside: avoid;
+  }
+
+  .versions__badge {
+    margin-left: 2mm;
+    padding: 0 1.5mm;
+    border: 0.5pt solid #000;
+    background: none;
+    color: #000;
+    font-size: 8pt;
+    text-transform: uppercase;
+  }
+
+  .versions__date {
+    margin-left: 2mm;
+    font-size: 9pt;
+    font-style: italic;
+  }
+
+  /* -----------------------------------------------------------------------
+     12. Links
+
+     Internal links print as plain black text — their targets are elsewhere
+     in the same document, and an underline on every cross-reference turns
+     a statute into a rash. External links keep an underline and carry their
+     destination in brackets, because that URL cannot be recovered from
+     paper any other way.
+     -------------------------------------------------------------------- */
+
+  a,
+  a:link,
+  a:visited {
+    color: #000 !important;
+    background: none;
+    text-decoration: none;
+  }
+
+  a[href^="http"] {
+    text-decoration: underline;
+    word-break: break-word;
+    overflow-wrap: anywhere;
+  }
+
+  a[href^="http"]::after {
+    content: " (" attr(href) ")";
+    font-size: 0.85em;
+    font-style: normal;
+    font-weight: 400;
+    text-decoration: none;
+    word-break: break-all;
+    overflow-wrap: anywhere;
+  }
+
+  /* -----------------------------------------------------------------------
+     13. Quotations, tables, code
+
+     Everything the Markdown allowlist can emit inside a provision.
+     -------------------------------------------------------------------- */
+
+  blockquote {
+    max-width: 68ch;
+    margin: 0 0 3mm;
+    padding-left: 4mm;
+    border-left: 2pt solid #000;
+    break-inside: avoid;
+    page-break-inside: avoid;
+  }
+
+  table {
+    width: auto;
+    max-width: 100%;
+    margin: 0 0 4mm;
+    border-collapse: collapse;
+    font-size: 10pt;
+  }
+
+  th,
+  td {
+    padding: 1.5mm 2.5mm;
+    border: 0.5pt solid #000;
+    text-align: left;
+    vertical-align: top;
+  }
+
+  th {
+    font-weight: 700;
+  }
+
+  caption {
+    margin-bottom: 1.5mm;
+    font-size: 9pt;
+    font-style: italic;
+    text-align: left;
+  }
+
+  /* Repeat the header on every sheet a long table spills across. */
+  thead { display: table-header-group; }
+  tfoot { display: table-footer-group; }
+  tr    { break-inside: avoid; page-break-inside: avoid; }
+
+  code,
+  pre {
+    font-family: "SFMono-Regular", Consolas, "Liberation Mono", Menlo,
+                 monospace;
+    font-size: 9.5pt;
+    background: none;
+    border: 0;
+    color: #000;
+  }
+
+  pre {
+    max-width: 68ch;
+    padding: 2mm 3mm;
+    border: 0.5pt solid #000;
+    white-space: pre-wrap;
+    word-wrap: break-word;
+    break-inside: avoid;
+    page-break-inside: avoid;
+  }
+
+  hr {
+    height: 0;
+    margin: 4mm 0;
+    border: 0;
+    border-top: 0.5pt solid #000;
+  }
+
+  img {
+    max-width: 100%;
+    height: auto;
+    break-inside: avoid;
+    page-break-inside: avoid;
+  }
+
+  /* -----------------------------------------------------------------------
+     14. Footer
+
+     Kept: it is the colophon. Version, effective date and licence are what
+     make a loose printed sheet identifiable months later.
+     -------------------------------------------------------------------- */
+
+  .site-footer {
+    margin-top: 10mm;
+    padding-top: 3mm;
+    border-top: 0.5pt solid #000;
+    background: none;
+    color: #000;
+    font-size: 9pt;
+    text-align: left;
+    break-inside: avoid;
+    page-break-inside: avoid;
+  }
+
+  .site-footer p {
+    margin: 0 0 1mm;
+  }
+
+  .site-footer__meta {
+    font-style: italic;
+  }
+}
diff --git a/src/styles/tokens.css b/src/styles/tokens.css
new file mode 100644
index 0000000..603cc75
--- /dev/null
+++ b/src/styles/tokens.css
@@ -0,0 +1,269 @@
+/* ===========================================================================
+   tokens.css — fonts, design tokens, base reset.
+   Loaded before layout.css. Defines *values only*: no component ever gets
+   styled here. Anything that names a class belongs in layout.css.
+
+   Palette rule: three brand hues (purple #320063, blue #007bff, ochre
+   #c07534) plus a neutral ramp. No hue outside those families is invented.
+   Where a brand value cannot carry text at 4.5:1 it is resolved, per theme,
+   to a lighter or darker shade of the *same* hue — the anchors below keep
+   the originals available for fills, rules and other non-text use.
+   =========================================================================== */
+
+/* --- Fonts --------------------------------------------------------------
+   Two files exist on disk; nothing else may be referenced. URLs are relative
+   to this stylesheet so the site keeps working under /OpenCodeLaw/ or at an
+   apex domain. Both swap: legal text must be readable before the webfont
+   lands, never after.
+   Montserrat.ttf carries a wght axis (100–900), so one file covers every
+   display weight. Cuprum, despite its filename, has no fvar table — it is a
+   static Regular; ask for 400 and let the browser synthesise emphasis.       */
+
+@font-face {
+  font-family: "Montserrat";
+  src: url("../assets/fonts/Montserrat.ttf") format("truetype");
+  font-weight: 100 900;
+  font-style: normal;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: "Cuprum";
+  src: url("../assets/fonts/cuprum-variablefont_wght-webfont.woff") format("woff");
+  font-weight: 400;
+  font-style: normal;
+  font-display: swap;
+}
+
+/* --- Tokens: light (the default) ---------------------------------------- */
+
+:root {
+  color-scheme: light;
+
+  /* Brand anchors — the exact values, for fills, rules and graphics.
+     Not for body-sized text: see the resolved tokens below.                 */
+  --brand-accent: #320063;
+  --brand-link: #007bff;
+  --brand-action: #c07534;
+
+  /* Surfaces and ink */
+  --canvas: #f5f5f5;              /* page ground                            */
+  --surface: #ffffff;             /* cards, sheets, dialogs                 */
+  --ink: #333333;                 /* body text        — 12.6:1 on canvas    */
+  --muted: #5a5a5a;               /* metadata, dates  —  6.3:1 on canvas    */
+  --border: #d9d9d9;              /* hairlines                              */
+
+  /* Interactive */
+  --accent: var(--brand-accent);  /* primary            — 14.6:1 on canvas  */
+  /* "text on an accent fill" is --on-accent, defined with the derived tokens below. */
+  --accent-2: #0062cc;            /* links, shade of #007bff — 5.3:1        */
+  --action: #a05f26;              /* to-top, marks, shade of #c07534 — 4.6:1 */
+  --action-soft: var(--brand-action);       /* graphic ochre, 3.3:1 non-text */
+
+  /* Depth */
+  --shadow: rgba(0, 0, 0, 0.18);
+
+  /* Focus — ochre reads against both canvases and against an accent fill.
+     Use as: outline: 3px solid var(--focus); outline-offset: 2px;           */
+  --focus: var(--brand-action);
+
+  /* Geometry */
+  --header-h: 3.5rem;             /* sticky header; sync scroll-padding      */
+  --measure: 68ch;                /* prose column cap — never wider          */
+  --radius: 0.5rem;
+  --radius-lg: 0.875rem;
+
+  /* Space — 4 / 8 / 16 / 24 / 40 / 64 */
+  --space-1: 0.25rem;
+  --space-2: 0.5rem;
+  --space-3: 1rem;
+  --space-4: 1.5rem;
+  --space-5: 2.5rem;
+  --space-6: 4rem;
+
+  /* Type */
+  --font-display: "Montserrat", "Segoe UI", system-ui, sans-serif;
+  --font-body: system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue",
+    Arial, "Noto Sans", sans-serif;
+  --font-num: "Cuprum", "Montserrat", system-ui, sans-serif;
+}
+
+@media (min-width: 48em) {
+  :root { --header-h: 4rem; }
+}
+
+/* --- Tokens: dark -------------------------------------------------------
+   Declared twice on purpose. The media query serves readers on the system
+   setting; the attribute rule serves the in-page toggle and must be able to
+   win in both directions, so it may not sit inside the query.
+   Purple, blue and ochre are all sub-4.5:1 against #333333 at their brand
+   values, so each resolves to a lighter step of its own hue.                */
+
+@media (prefers-color-scheme: dark) {
+  :root:not([data-theme="light"]) {
+    color-scheme: dark;
+
+    --canvas: #333333;
+    --surface: #3d3d3d;
+    --ink: #f2f2f2;               /* 9.7:1 on surface                        */
+    --muted: #cecdcd;             /* 8.0:1 on canvas                         */
+    --border: #4f4f4f;
+
+    --accent: #c79df1;            /* 5.7:1 on canvas                         */
+    --accent-2: #6cb2ff;          /* 5.7:1 on canvas                         */
+    --action: #e09a55;            /* 5.4:1 on canvas                         */
+    --action-soft: var(--brand-action);
+
+    --shadow: rgba(0, 0, 0, 0.45);  /* same ink, more of it: dark grounds
+                                       swallow an 18% shadow entirely        */
+    --focus: #e09a55;
+  }
+}
+
+:root[data-theme="dark"] {
+  color-scheme: dark;
+
+  --canvas: #333333;
+  --surface: #3d3d3d;
+  --ink: #f2f2f2;
+  --muted: #cecdcd;
+  --border: #4f4f4f;
+
+  --accent: #c79df1;
+  --accent-2: #6cb2ff;
+  --action: #e09a55;
+  --action-soft: var(--brand-action);
+
+  --shadow: rgba(0, 0, 0, 0.45);
+  --focus: #e09a55;
+}
+
+/* --- Base reset ---------------------------------------------------------- */
+
+*,
+*::before,
+*::after { box-sizing: border-box; }
+
+* { margin: 0; padding: 0; }
+
+html {
+  -webkit-text-size-adjust: 100%;
+  text-size-adjust: 100%;
+  /* Anchors are citations: #art-6-s-1 must land clear of the sticky header. */
+  scroll-padding-top: calc(var(--header-h) + var(--space-3));
+}
+
+@media (prefers-reduced-motion: no-preference) {
+  html { scroll-behavior: smooth; }
+}
+
+body {
+  background-color: var(--canvas);
+  color: var(--ink);
+  font-family: var(--font-body);
+  font-size: 18px;
+  line-height: 1.65;
+  /* Ragged right, always. Justified legal prose opens rivers and destroys
+     the word-shape cues a reader uses to hold a long clause together.       */
+  text-align: left;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+
+/* Long clauses break better when the last line is not a single word. */
+p, li, blockquote, dd { text-wrap: pretty; }
+
+img, svg, video { max-width: 100%; }
+img, svg { height: auto; }
+
+/* Controls inherit type: the header buttons are text, not chrome. */
+button, input, select, textarea {
+  font: inherit;
+  color: inherit;
+}
+
+a { color: var(--accent-2); }
+
+::selection {
+  background-color: var(--action-wash);
+  color: var(--ink);
+}
+
+/* --- Focus ---------------------------------------------------------------
+   A floor, not a component style: every interactive element gets a visible
+   ring even if layout.css never mentions it. Mouse clicks stay quiet.       */
+
+:focus-visible {
+  outline: 3px solid var(--focus);
+  outline-offset: 2px;
+}
+
+:focus:not(:focus-visible) { outline: none; }
+
+/* --- Reduced motion ------------------------------------------------------
+   Global guard. Nothing here *creates* a transition — it only neutralises
+   whatever later stylesheets declare.                                       */
+
+@media (prefers-reduced-motion: reduce) {
+  html { scroll-behavior: auto; }
+
+  *,
+  *::before,
+  *::after {
+    animation-duration: 0.01ms !important;
+    animation-iteration-count: 1 !important;
+    transition-duration: 0.01ms !important;
+    scroll-behavior: auto !important;
+  }
+}
+
+
+/* --- Derived tokens ------------------------------------------------------
+   Two brand colours cannot carry text at 4.5:1 in both themes, so each gets a
+   text-safe tint or shade *within its own hue* — purple stays at 270°, blue at
+   211°, amber at 28°. No new hue family is introduced; the raw brand values
+   keep their jobs as fills, rules and highlights, where the bar is 3:1.
+
+   Defined here and only here. They previously lived in layout.css, which loads
+   later and silently redefined --accent-ink to mean the opposite of what this
+   file said it meant.                                                        */
+:root {
+  --accent-ink: var(--accent, #320063);      /* accent as text, light theme    */
+  --on-accent: #f5f5f5;                      /* text on an accent fill         */
+  --link-ink: #0056b3;                       /* 6.5:1 on canvas, 5.6:1 on the banner wash, hue 211 */
+  --action-ink: #8a5122;                     /* 5.9:1 on #f5f5f5, hue 28       */
+  --ring: var(--focus, #320063);
+
+  --accent-wash: rgba(50, 0, 99, 0.07);
+  --action-wash: rgba(192, 117, 52, 0.12);
+
+  --action-contrast: rgba(0, 0, 0, 0.87);    /* text on an --action fill      */
+  --num-slot: 0px;                           /* margin gutter; grows ≥900px    */
+  --fab-h: 3rem;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root:not([data-theme="light"]) {
+    --accent-ink: #d9b3ff;                   /* hue 270. 7.1:1 on #333333, 4.9:1 on the accent wash a pressed control sits on */
+    --on-accent: #333333;
+    --link-ink: #7cbcff;                     /* 6.3:1 on #333333, 5.0:1 on the banner wash, hue 210 */
+    --action-ink: #e0a878;                   /* 6.0:1 on #333333, hue 28       */
+    --ring: var(--focus, #d9b3ff);
+
+    --accent-wash: rgba(204, 153, 255, 0.13);
+    --action-wash: rgba(192, 117, 52, 0.22);
+  }
+}
+
+/* Repeated verbatim so an explicit toggle beats the system preference in both
+   directions — the inline head script sets data-theme before first paint. */
+:root[data-theme="dark"] {
+  --accent-ink: #d9b3ff;
+  --on-accent: #333333;
+  --link-ink: #7cbcff;
+  --action-ink: #e0a878;
+  --ring: var(--focus, #d9b3ff);
+
+  --accent-wash: rgba(204, 153, 255, 0.13);
+  --action-wash: rgba(192, 117, 52, 0.22);
+}
diff --git a/src/templates/.gitkeep b/src/templates/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/src/templates/layout.mjs b/src/templates/layout.mjs
new file mode 100644
index 0000000..8455233
--- /dev/null
+++ b/src/templates/layout.mjs
@@ -0,0 +1,218 @@
+/**
+ * The page shell: head, landmarks, navigation, reconciliation banner, footer.
+ *
+ * Everything is server-rendered. The page is complete and readable with
+ * JavaScript disabled; scripts only enhance.
+ */
+import { escapeHtml } from '../lib/paths.mjs'
+
+/**
+ * Runs before first paint so the theme never flashes. Inline by necessity —
+ * an external file cannot beat the first paint.
+ */
+const THEME_SCRIPT = `(function(){try{var t=localStorage.getItem('theme');
+if(!t){t=window.matchMedia('(prefers-color-scheme: dark)').matches?'dark':'light'}
+document.documentElement.setAttribute('data-theme',t)}catch(e){}})();`
+
+/**
+ * The reconciliation banner, built entirely from `reconciliation_state` in the
+ * YAML. Never hardcoded: a banner that can fall out of step with the document
+ * it describes is worse than no banner.
+ */
+export function reconciliationBanner (state, { url, actIndex = {} }) {
+  if (!state || state.complete) return ''
+
+  const naming = ids => ids.map(id => {
+    const act = actIndex[String(id).replace(/\s*\(partial\)\s*$/, '')]
+    if (act) return escapeHtml(act.title)
+    if (/^art-\d+$/.test(id)) return `Article ${id.replace('art-', '')}`
+    return escapeHtml(id)
+  })
+
+  const held = (state.held ?? []).map(h => {
+    const what = naming(h.provisions)
+    const why = Array.isArray(h.blocked_by) ? h.blocked_by.join(', ') : h.blocked_by
+    return `<li><strong>${what.join(' and ')}</strong> — awaiting ${escapeHtml(why)}` +
+      (h.note ? `<span class="banner__note">${escapeHtml(h.note)}</span>` : '') + '</li>'
+  }).join('')
+
+  return `
+<aside class="banner" role="note" aria-labelledby="reconciliation-heading">
+  <h2 class="banner__title" id="reconciliation-heading">This constitution is mid-reconciliation</h2>
+  <p class="banner__lead">
+    This text does not yet reflect every amendment enacted against it. It is published at
+    <strong>${escapeHtml(state.target_version ? `version ${escapeHtml(String(state.target_version))} (in progress)` : 'an interim version')}</strong>
+    so the gap is visible rather than hidden.
+  </p>
+  <ul class="banner__list">${held}</ul>
+  <p class="banner__more">
+    Every instrument, applied or pending, is listed in the
+    <a href="${url('amendments/')}">amendment register</a>.
+  </p>
+</aside>`
+}
+
+/**
+ * `mode: 'single'` — every provision is on this page (the full constitution),
+ * so every entry is an in-page anchor.
+ * `mode: 'multi'` — one article per page, so entries point at the article's own
+ * page. Only the article being viewed gets in-page anchors; linking a section
+ * of another article to `#id` would point at an element that is not there.
+ */
+export function tocNav (articles, { url, slugs, currentId = null, mode = 'single', homeUrl }) {
+  const home = homeUrl ?? url('')
+  const target = (a, frag) => {
+    if (mode === 'single') return `#${frag}`
+    if (a && a.id === currentId) return `#${frag}`
+    if (!a) return `${home}#${frag}`
+    return `${url(`articles/${slugs.get(a.id)}/`)}#${frag}`
+  }
+
+  const items = articles.map(a => {
+    const active = a.id === currentId
+    const href = mode === 'single' ? `#${a.id}` : url(`articles/${slugs.get(a.id)}/`)
+    const sub = (a.sections ?? []).length
+      ? `<ul class="toc__sub" id="toc-sub-${a.id}">` +
+        a.sections.map(s =>
+          `<li><a class="toc__link toc__link--sub" href="${target(a, s.id)}" data-anchor="${s.id}">` +
+          `<span class="toc__num">${s.number}</span> ${escapeHtml(s.title)}</a></li>`).join('') +
+        '</ul>'
+      : ''
+    return `<li class="toc__item${sub ? ' toc__item--parent' : ''}${active ? ' is-current' : ''}">
+      <a class="toc__link" href="${href}" data-anchor="${a.id}">
+        <span class="toc__num">${a.number}</span> ${escapeHtml(a.title)}
+      </a>${sub}</li>`
+  }).join('')
+
+  return `<nav class="toc" id="toc" aria-labelledby="toc-heading">
+  <h2 class="toc__heading" id="toc-heading">Contents</h2>
+  <ul class="toc__list">
+    <li class="toc__item"><a class="toc__link" href="${target(null, 'preamble')}" data-anchor="preamble">Preamble</a></li>
+    ${items}
+  </ul>
+</nav>`
+}
+
+export function layout ({
+  title, description, canonical, head = '', bodyClass = '',
+  main, info, url, absolute, state, actIndex, articles, slugs,
+  currentId = null, tocMode = 'single', showToc = true, jsonLd = [], og = {}
+}) {
+  const ogTags = Object.entries({
+    'og:type': og.type ?? 'website',
+    'og:site_name': info.title,
+    'og:title': og.title ?? title,
+    'og:description': og.description ?? description,
+    'og:url': canonical,
+    'og:image': og.image,
+    'og:image:alt': og.imageAlt,
+    'og:locale': 'en_IN'
+  }).filter(([, v]) => v).map(([p, v]) =>
+    `<meta property="${p}" content="${escapeHtml(v)}">`).join('\n    ')
+
+  const twitter = [
+    '<meta name="twitter:card" content="summary_large_image">',
+    `<meta name="twitter:title" content="${escapeHtml(og.title ?? title)}">`,
+    `<meta name="twitter:description" content="${escapeHtml(og.description ?? description)}">`,
+    og.image ? `<meta name="twitter:image" content="${escapeHtml(og.image)}">` : ''
+  ].filter(Boolean).join('\n    ')
+
+  const ld = jsonLd.filter(Boolean).map(o =>
+    `<script type="application/ld+json">${JSON.stringify(o).replace(/</g, '\\u003c')}</script>`).join('\n    ')
+
+  return `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title>${escapeHtml(title)}</title>
+    <meta name="description" content="${escapeHtml(description)}">
+    <link rel="canonical" href="${escapeHtml(canonical)}">
+    ${ogTags}
+    ${twitter}
+    <link rel="icon" href="${url('favicons/favicon-32x32.png')}" sizes="32x32">
+    <link rel="apple-touch-icon" href="${url('favicons/apple-icon-180x180.png')}">
+    <link rel="stylesheet" href="${url('styles/tokens.css')}">
+    <link rel="stylesheet" href="${url('styles/layout.css')}">
+    <link rel="stylesheet" href="${url('styles/print.css')}" media="print">
+    <script>${THEME_SCRIPT}</script>
+    ${ld}
+    ${head}
+  </head>
+  <body class="${bodyClass}">
+    <a class="skip-link" href="#main">Skip to content</a>
+    <div class="progress" id="progress" aria-hidden="true"><div class="progress__bar" id="progress-bar"></div></div>
+
+    <header class="site-header" id="site-header">
+      <a class="site-header__brand" href="${url('')}">
+        ${info.logo ? `<img class="site-header__logo" src="${url('assets/img/OpenCodeLaw.png')}" alt="" width="36" height="36" decoding="async">` : ''}
+        <span class="site-header__title">${escapeHtml(info.title)}</span>
+      </a>
+      <div class="site-header__actions">
+        <button type="button" class="btn btn--icon" id="search-open" aria-label="Search the constitution" aria-keyshortcuts="Control+K Meta+K">
+          <span aria-hidden="true">⌕</span><span class="btn__label">Search</span>
+        </button>
+        <button type="button" class="btn btn--icon" id="focus-toggle" aria-pressed="false" aria-label="Focus mode">
+          <span aria-hidden="true">◐</span><span class="btn__label">Focus</span>
+        </button>
+        <button type="button" class="btn btn--icon" id="theme-toggle" aria-pressed="false" aria-label="Dark theme">
+          <span aria-hidden="true" class="theme-toggle__icon"></span><span class="btn__label">Theme</span>
+        </button>
+      </div>
+    </header>
+
+    <div class="shell">
+      ${showToc ? `<div class="shell__aside">${tocNav(articles, { url, slugs, currentId, mode: tocMode })}</div>` : ''}
+      <main class="shell__main" id="main" tabindex="-1">
+        ${reconciliationBanner(state, { url, actIndex })}
+        ${main}
+      </main>
+    </div>
+
+    <footer class="site-footer">
+      <p>${escapeHtml(info.organization)}${info.jurisdiction ? ` · ${escapeHtml(info.jurisdiction)}` : ''}</p>
+      <p>
+        <a href="${url('')}">Constitution</a> ·
+        <a href="${url('amendments/')}">Amendments</a> ·
+        <a href="${url('archive/')}">Archive</a>
+        ${info.contact?.email ? ` · <a href="mailto:${escapeHtml(info.contact.email)}">Contact</a>` : ''}
+      </p>
+      <p class="site-footer__meta">
+        ${info.legal_status === 'not_adopted'
+          ? `Last adopted version ${escapeHtml(info.adopted_version)} · text as at ${escapeHtml(info.text_as_of)} · not yet adopted`
+          : `Version ${escapeHtml(info.version)} · effective ${escapeHtml(info.effective_from)}`}
+        ${info.license ? ` · ${escapeHtml(info.license)}` : ''}
+      </p>
+    </footer>
+
+    ${showToc ? `<button type="button" class="toc-fab" id="toc-fab" aria-expanded="false" aria-controls="toc-sheet">
+      <span aria-hidden="true">☰</span> Contents
+    </button>
+    <div class="sheet" id="toc-sheet" role="dialog" aria-modal="true" aria-label="Contents" hidden>
+      <div class="sheet__panel">
+        <div class="sheet__head">
+          <h2 class="sheet__title">Contents</h2>
+          <button type="button" class="btn" id="toc-close" aria-label="Close contents">Close</button>
+        </div>
+        <div class="sheet__body">${tocNav(articles, { url, slugs, currentId, mode: tocMode })}</div>
+      </div>
+    </div>` : ''}
+
+    <div class="dialog" id="search-dialog" role="dialog" aria-modal="true" aria-label="Search the constitution" hidden>
+      <div class="dialog__panel">
+        <label class="visually-hidden" for="search-input">Search the constitution</label>
+        <input class="dialog__input" id="search-input" type="search" autocomplete="off"
+               placeholder="Search provisions…" aria-describedby="search-hint">
+        <p class="dialog__hint" id="search-hint">Type to search. Enter opens the first result, Escape closes.</p>
+        <ul class="dialog__results" id="search-results" role="listbox" aria-label="Search results"></ul>
+      </div>
+    </div>
+
+    <div class="toast" id="toast" role="status" aria-live="polite"></div>
+    <button type="button" class="to-top" id="to-top" aria-label="Back to top" hidden>↑</button>
+
+    <script type="module" src="${url('scripts/app.js')}"></script>
+  </body>
+</html>
+`
+}
diff --git a/src/templates/provision.mjs b/src/templates/provision.mjs
new file mode 100644
index 0000000..e445289
--- /dev/null
+++ b/src/templates/provision.mjs
@@ -0,0 +1,132 @@
+/**
+ * Provision rendering.
+ *
+ * The `id` on each <article> is the schema id, unchanged. These anchors are a
+ * public API — Acts cite them and people share them — so they are never
+ * derived from position and never regenerated.
+ */
+import { escapeHtml } from '../lib/paths.mjs'
+import { renderMarkdown } from '../lib/markdown.mjs'
+
+function amendedByChips (ids, { url, actIndex }) {
+  if (!ids?.length) return ''
+  const chips = ids.map(id => {
+    const act = actIndex[id]
+    if (!act) return ''
+    const label = `Act ${act.number} of ${act.year}`
+    return `<span class="chip">
+      <span class="chip__label">Amended by</span>
+      <a class="chip__link" href="${url('amendments/')}#${escapeHtml(act.id)}">${escapeHtml(label)}</a>
+      ${act.pdf ? `<a class="chip__pdf" href="${url(act.pdf)}" aria-label="${escapeHtml(label)} (PDF)">PDF</a>` : ''}
+    </span>`
+  }).join('')
+  return chips ? `<p class="chips">${chips}</p>` : ''
+}
+
+/**
+ * Marks whichever kind of heading is the exception, and says so once elsewhere.
+ *
+ * Marking the common case is noise, and putting "not enacted" beside a
+ * provision reads as a claim about the provision rather than its heading. Which
+ * kind is rare is not fixed: before the Acts were applied 8 of 40 headings were
+ * enacted, and after them 32 of 40 are. So the direction follows the data
+ * rather than a constant, and the amendments page states the matching default.
+ */
+function headingMark (titleSource, markKind) {
+  if (!markKind || titleSource !== markKind) return ''
+  // The label names the heading, never its legal effect. "not enacted" beside a
+  // provision reads as a claim about the provision itself; the tooltip and the
+  // amendments page carry the fuller meaning.
+  const label = markKind === 'enacted' ? 'enacted heading' : 'editorial heading'
+  const title = markKind === 'enacted'
+    ? 'Enacted heading — stated by an amending instrument'
+    : 'Editorial heading — not stated by any instrument'
+  return `<span class="title-mark" title="${title}">` +
+    `<span aria-hidden="true">§</span>` +
+    `<span class="visually-hidden">${label}</span></span>`
+}
+
+function copyButton (id, label) {
+  return `<button type="button" class="copy" data-copy="${escapeHtml(id)}"
+    aria-label="Copy link to ${escapeHtml(label)}"><span aria-hidden="true">🔗</span></button>`
+}
+
+/**
+ * A section's heading must sit one level below its article's, or the document
+ * outline says the two are siblings. Screen-reader users navigate this tree by
+ * heading; a scanner reading "6 STM Roles" then "1 Board Member" at identical
+ * weight cannot tell which contains which. Lighthouse does not catch it —
+ * its sequential-headings audit only flags skipped levels, and h3 -> h3 is not
+ * a skip.
+ */
+export function renderSection (section, opts) {
+  const { url, actIndex, headingLevel = 3 } = opts
+  const H = `h${Math.min(headingLevel, 6)}`
+  const status = section.status ?? 'active'
+  const body = status === 'active'
+    ? renderMarkdown(section.content)
+    : `<p class="no-text" role="note">[${escapeHtml(section.note ?? 'No text')}]</p>`
+  return `
+      <article class="provision provision--section" id="${escapeHtml(section.id)}" aria-labelledby="h-${escapeHtml(section.id)}">
+        <${H} class="provision__heading" id="h-${escapeHtml(section.id)}">
+          <span class="provision__num" aria-hidden="true">${section.number}</span>
+          <span class="provision__title">${escapeHtml(section.title)}${headingMark(section.title_source, opts.markKind)}</span>
+          ${copyButton(section.id, section.title)}
+        </${H}>
+        ${amendedByChips(section.amended_by, { url, actIndex })}
+        <div class="provision__body">${body}</div>
+      </article>`
+}
+
+export function renderArticle (article, opts) {
+  const { url, actIndex, headingLevel = 2 } = opts
+  const H = `h${headingLevel}`
+  const status = article.status ?? 'active'
+
+  if (status !== 'active') {
+    return `
+    <article class="provision provision--article provision--${escapeHtml(status)}" id="${escapeHtml(article.id)}" aria-labelledby="h-${escapeHtml(article.id)}">
+      <${H} class="provision__heading" id="h-${escapeHtml(article.id)}">
+        <span class="provision__num" aria-hidden="true">${article.number}</span>
+        <span class="provision__title">${escapeHtml(article.title)}</span>
+      </${H}>
+      <p class="no-text" role="note">[${escapeHtml(status)}: ${escapeHtml(article.note ?? '')}]</p>
+    </article>`
+  }
+
+  // An article may legitimately consist only of sections: Act 1 substitutes
+  // Article 10 as a heading running straight into its clauses.
+  const body = article.content != null
+    ? `<div class="provision__body">${renderMarkdown(article.content)}</div>`
+    : ((article.sections ?? []).length ? '' : `<div class="provision__body">${renderMarkdown(null)}</div>`)
+
+  const sections = (article.sections ?? [])
+    .map(s => renderSection(s, { ...opts, headingLevel: headingLevel + 1 }))
+    .join('')
+
+  return `
+    <article class="provision provision--article" id="${escapeHtml(article.id)}" aria-labelledby="h-${escapeHtml(article.id)}">
+      <${H} class="provision__heading" id="h-${escapeHtml(article.id)}">
+        <span class="provision__num" aria-hidden="true">${article.number}</span>
+        <span class="provision__title">${escapeHtml(article.title)}${headingMark(article.title_source, opts.markKind)}</span>
+        ${copyButton(article.id, article.title)}
+      </${H}>
+      ${amendedByChips(article.amended_by, { url, actIndex })}
+      ${body}
+      ${sections ? `<div class="provision__sections">${sections}</div>` : ''}
+    </article>`
+}
+
+export function renderPreamble (preamble, opts) {
+  const { url, actIndex } = opts
+  return `
+    <article class="provision provision--preamble" id="${escapeHtml(preamble.id)}" aria-labelledby="h-preamble">
+      <h2 class="provision__heading" id="h-preamble">
+        <span class="provision__title">${escapeHtml(preamble.title)}</span>
+        ${copyButton(preamble.id, preamble.title)}
+      </h2>
+      ${amendedByChips(preamble.amended_by, { url, actIndex })}
+      <div class="provision__body">${renderMarkdown(preamble.content)}</div>
+      ${preamble.adopted ? `<p class="provision__meta">Adopted ${escapeHtml(String(preamble.adopted).slice(0, 10))}</p>` : ''}
+    </article>`
+}
diff --git a/src/text-compare.mjs b/src/text-compare.mjs
new file mode 100644
index 0000000..9811590
--- /dev/null
+++ b/src/text-compare.mjs
@@ -0,0 +1,154 @@
+/**
+ * Text comparison for provenance analysis.
+ *
+ * Used to decide whether a provision in the constitution already carries an
+ * Act's prescribed text, still carries the pre-Act text, or matches neither.
+ *
+ * ORDER IS LOAD-BEARING. Tags must be stripped before punctuation, and they
+ * must be replaced with a space rather than removed. Stripping punctuation
+ * first collapses `<br>` to the literal token `br`, which injects a word into
+ * the middle of the string and produces a false NOT-APPLIED — the worst
+ * failure mode available here, because acting on it would re-apply an
+ * amendment already in force. See tests/text-compare.test.mjs.
+ */
+
+/** Replace every HTML tag with a space. Never with the empty string: `a<br>b` must not become `ab`. */
+export function stripTags (s) {
+  return String(s ?? '').replace(/<[^>]*>/g, ' ')
+}
+
+/** Fold the typographic variants the PDFs and the YAML spell differently. */
+export function foldUnicode (s) {
+  return s
+    .replace(/[‘’‚‛′]/g, "'")
+    .replace(/[“”„‟″]/g, '"')
+    .replace(/[‐-―−]/g, '-')
+    .replace(/[   ]/g, ' ')
+    .replace(/…/g, '...')
+}
+
+/**
+ * Remove enumerators. The Acts number clauses `(1)`, `(a)`; the YAML uses
+ * `1.`, `- (a)`, or carries the number in a section title. None of that is
+ * operative text, and leaving it in makes identical provisions look different.
+ */
+export function stripEnumerators (s) {
+  return s
+    .replace(/^[ \t]*[-*•][ \t]*/gm, ' ')        // markdown bullets
+    .replace(/\(\s*[0-9]{1,3}\s*\)/g, ' ')            // (1) (12)
+    .replace(/\(\s*[a-z]\s*\)/gi, ' ')                // (a) (b)
+    .replace(/\(\s*[ivxl]{1,5}\s*\)/gi, ' ')          // (iv)
+    .replace(/^[ \t]*[0-9]{1,3}[.)][ \t]+/gm, ' ')    // 1.  12)
+    .replace(/^[ \t]*[a-z][.)][ \t]+/gim, ' ')        // a.  b)
+}
+
+/**
+ * Canonical comparison form. Aggressive by design: it must see through
+ * formatting, numbering and typography, because the same provision is spelled
+ * one way in a PDF and another way in YAML.
+ */
+export function normalise (s) {
+  return stripEnumerators(foldUnicode(stripTags(s)))
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, ' ')
+    .trim()
+    .replace(/\s+/g, ' ')
+}
+
+export function tokens (s) {
+  const n = normalise(s)
+  return n ? n.split(' ') : []
+}
+
+/** Levenshtein distance over token sequences. */
+function tokenDistance (a, b) {
+  if (!a.length) return b.length
+  if (!b.length) return a.length
+  let prev = Array.from({ length: b.length + 1 }, (_, i) => i)
+  for (let i = 1; i <= a.length; i++) {
+    const cur = [i]
+    for (let j = 1; j <= b.length; j++) {
+      cur[j] = Math.min(
+        prev[j] + 1,
+        cur[j - 1] + 1,
+        prev[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1)
+      )
+    }
+    prev = cur
+  }
+  return prev[b.length]
+}
+
+/** 1.0 = identical after normalisation, 0.0 = nothing in common. */
+export function similarity (a, b) {
+  const ta = tokens(a)
+  const tb = tokens(b)
+  if (!ta.length && !tb.length) return 1
+  if (!ta.length || !tb.length) return 0
+  return 1 - tokenDistance(ta, tb) / Math.max(ta.length, tb.length)
+}
+
+/**
+ * How well `needle` appears somewhere inside `haystack`.
+ *
+ * Used for clause-scope amendments, where an Act replaces clause (4) of an
+ * article whose current text is one undivided block. Slicing the constitution
+ * into clauses to compare like with like would mean guessing where a clause
+ * begins; sliding the Act's clause over the article instead requires no guess.
+ */
+export function containment (needle, haystack) {
+  const n = tokens(needle)
+  const h = tokens(haystack)
+  if (!n.length) return 1
+  if (!h.length) return 0
+  if (h.length <= n.length) return similarity(needle, haystack)
+
+  let best = 0
+  const width = n.length
+  // Stride must be fine enough to land on the true alignment. At width/8 the
+  // window straddled the clause boundary and scored five exact-match Article 6
+  // clauses at 90-94%, which reads in PROVENANCE.md as unexplained drift.
+  // Token-by-token wherever the haystack is small enough to afford it.
+  const stride = h.length <= 4000 ? 1 : Math.max(1, Math.floor(width / 16))
+  for (let start = 0; start + 1 <= h.length; start += stride) {
+    for (const w of [Math.round(width * 0.85), width, Math.round(width * 1.2)]) {
+      const window = h.slice(start, start + w)
+      if (!window.length) continue
+      const score = 1 - tokenDistance(n, window) / Math.max(n.length, window.length)
+      if (score > best) best = score
+      if (best === 1) return 1
+    }
+  }
+  return best
+}
+
+export const MATCH_THRESHOLD = 0.94
+
+/**
+ * Three-way verdict.
+ *
+ * `current` is the text in the constitution today, `enacted` is what the Act
+ * prescribes, `prior` is the text as it stood before the Act (null where the
+ * Act inserts a provision that did not previously exist).
+ *
+ * DIVERGENT means the text matches neither: someone edited the constitution
+ * outside the amendment process. It is never resolved automatically.
+ */
+export function classify (current, enacted, prior) {
+  const hasCurrent = normalise(current).length > 0
+  const simEnacted = enacted == null ? 0 : similarity(current, enacted)
+  const simPrior = prior == null ? (hasCurrent ? 0 : 1) : similarity(current, prior)
+
+  let verdict
+  if (!hasCurrent && prior == null) {
+    verdict = 'NOT-APPLIED'                     // insertion that has not happened yet
+  } else if (simEnacted >= MATCH_THRESHOLD && simEnacted >= simPrior) {
+    verdict = 'ALREADY-APPLIED'
+  } else if (simPrior >= MATCH_THRESHOLD && simPrior > simEnacted) {
+    verdict = 'NOT-APPLIED'
+  } else {
+    verdict = 'DIVERGENT'
+  }
+
+  return { verdict, simEnacted, simPrior }
+}
diff --git a/src/title-source.mjs b/src/title-source.mjs
new file mode 100644
index 0000000..b0c17f7
--- /dev/null
+++ b/src/title-source.mjs
@@ -0,0 +1,61 @@
+/**
+ * Classifies every provision title as `enacted` or `editorial`.
+ *
+ * A reader of a constitution is entitled to know which headings carry legal
+ * force. Act 1 titles Article 11's clause (2) `Establishment`; it gives clause
+ * (1) no title at all, and the lowercase `units` currently above it is
+ * something an editor typed. Both render at the same weight today.
+ *
+ * Two rules, both narrower than "the title appears in the Act text":
+ *
+ *  1. Only an Act ALREADY APPLIED to that provision can enact its title.
+ *     Crediting an unapplied Act would claim legal force for a heading that
+ *     is not yet in effect — Act 2 retitles Article 14 to `Leaves`, but Act 2
+ *     has not been applied, so `Sabbatical Leave` remains editorial.
+ *
+ *  2. The title must appear as a HEADING, not anywhere in the prose. A
+ *     substring test marks Article 11's `units` as enacted, because the Act's
+ *     clause (1) happens to open "The units of the NGO…", and marks Article
+ *     15's `Resignation` as enacted off the phrase "the resignation letter".
+ *
+ * Anything unverifiable is `editorial`. Never guess.
+ */
+import { normalise } from './text-compare.mjs'
+
+/** Clause headings an Act states: the text between `(N)` and the first break. */
+export function clauseHeadings (text) {
+  const marks = [...String(text ?? '').matchAll(/^[ \t]*\((\d+)\)/gm)]
+  return marks.map((m, i) => {
+    const body = text.slice(m.index, i + 1 < marks.length ? marks[i + 1].index : undefined)
+    const first = body.split('\n')[0].replace(/^[ \t]*\(\d+\)[ \t]*/, '').trim()
+    // A heading is a short label, optionally followed by a colon. Anything that
+    // runs on into a sentence is prose, not a heading.
+    const label = first.split(':')[0].trim()
+    return { number: Number(m[1]), label, isHeading: label.length > 0 && label.length <= 48 && !/[.]$/.test(label) }
+  })
+}
+
+/**
+ * @param doc      the constitution
+ * @param actSpans map of provision id -> Act provisions targeting it
+ * @param applied  set of act ids whose text is actually in force in this doc
+ */
+export function classifyTitles (doc, actSpans, applied) {
+  const out = new Map()
+  const eq = (a, b) => normalise(a) === normalise(b) && normalise(a).length > 0
+
+  for (const art of doc.articles ?? []) {
+    // Only Acts this article records as having amended it.
+    const spans = (actSpans[art.id] ?? []).filter(p => applied.has(p.actId))
+
+    const artEnacted = spans.some(p => p.enacted_title && eq(p.enacted_title, art.title))
+    out.set(art.id, artEnacted ? 'enacted' : 'editorial')
+
+    for (const sec of art.sections ?? []) {
+      const secEnacted = spans.some(p =>
+        clauseHeadings(p.text).some(h => h.isHeading && eq(h.label, sec.title)))
+      out.set(sec.id, secEnacted ? 'enacted' : 'editorial')
+    }
+  }
+  return out
+}
diff --git a/src/validate.mjs b/src/validate.mjs
new file mode 100644
index 0000000..356eda6
--- /dev/null
+++ b/src/validate.mjs
@@ -0,0 +1,585 @@
+#!/usr/bin/env node
+/**
+ * Integrity gate for the constitution corpus.
+ *
+ * Schema conformance is the floor, not the goal. The checks that matter are the
+ * relational ones: that citation identifiers are unique and permanent, that
+ * article numbering has no unexplained gaps, that every Act resolves against
+ * the text it claims to amend, and that the archive never shadows the live
+ * document.
+ *
+ * Exits non-zero on any error, so CI blocks deployment rather than publishing a
+ * constitution that is broken or legally incorrect.
+ */
+
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import yaml from 'js-yaml'
+// The schema is draft 2020-12; ajv's default entry point only speaks draft-07.
+import Ajv from 'ajv/dist/2020.js'
+import addFormats from 'ajv-formats'
+
+export const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+
+const CURRENT_FILE = 'constitution/current.yaml'
+const VERSIONS_DIR = 'constitution/versions'
+const REGISTER_FILE = 'acts/register.yaml'
+const SCHEMA_FILE = 'schema/opencodelaw-1.0.schema.json'
+const TEMPLATES_DIR = 'src/templates'
+
+/**
+ * YAML timestamps are loaded as strings, not Date objects. `format: date`
+ * validates strings, and a Date round-trip would silently rewrite
+ * `2023-10-08T20:20:00+05:30` into UTC and drop the offset.
+ */
+const YAML_OPTS = { schema: yaml.CORE_SCHEMA }
+
+export function loadYaml (rel) {
+  return yaml.load(fs.readFileSync(path.join(ROOT, rel), 'utf8'), YAML_OPTS)
+}
+
+class Report {
+  constructor () { this.entries = [] }
+  error (file, code, message, where) { this.entries.push({ level: 'error', file, code, message, where }) }
+  warn (file, code, message, where) { this.entries.push({ level: 'warn', file, code, message, where }) }
+  get errors () { return this.entries.filter(e => e.level === 'error') }
+  get warnings () { return this.entries.filter(e => e.level === 'warn') }
+}
+
+/** Flatten a constitution into every citable provision it produces. */
+export function provisionsOf (doc) {
+  const out = []
+  if (doc?.preamble) out.push({ id: doc.preamble.id, kind: 'preamble', where: 'preamble' })
+  for (const [i, a] of (doc?.articles ?? []).entries()) {
+    out.push({ id: a.id, number: a.number, kind: 'article', status: a.status ?? 'active', node: a, where: `articles[${i}]` })
+    for (const [j, s] of (a.sections ?? []).entries()) {
+      out.push({ id: s.id, number: s.number, kind: 'section', status: s.status ?? 'active', node: s, parent: a, where: `articles[${i}].sections[${j}]` })
+    }
+  }
+  return out
+}
+
+/** Every anchor the built site will expose. Treated as a public API. */
+export function anchorsOf (doc) {
+  return new Set(provisionsOf(doc).filter(p => (p.status ?? 'active') === 'active').map(p => p.id))
+}
+
+function buildAjv (schema) {
+  const ajv = new Ajv({ allErrors: true, strict: false, allowUnionTypes: true })
+  addFormats(ajv)
+  ajv.addSchema(schema, 'opencodelaw')
+  return ajv
+}
+
+/**
+ * Turn an ajv pointer into something a reviewer can act on.
+ *
+ * `/articles/10/content` is an array index, which in this document means
+ * Article *11*. Reporting a legal defect against the wrong article number is
+ * how a reviewer ends up reading the wrong provision.
+ */
+export function describePath (doc, instancePath) {
+  if (!instancePath) return '/'
+  const m = instancePath.match(/^\/articles\/(\d+)(?:\/sections\/(\d+))?(.*)$/)
+  if (!m) return instancePath
+  const art = doc?.articles?.[Number(m[1])]
+  if (!art) return instancePath
+  const rest = m[3] || ''
+  if (m[2] !== undefined) {
+    const sec = art.sections?.[Number(m[2])]
+    return `${sec?.id ?? `${art.id}?s${m[2]}`} "${sec?.title ?? ''}"${rest} (${instancePath})`
+  }
+  return `${art.id ?? `articles[${m[1]}]`} "${art.title ?? ''}"${rest} (${instancePath})`
+}
+
+/**
+ * Is this schema error "a provision exists but carries no text"?
+ * Narrow on purpose: only the emptiness constraints on a `content` field, so a
+ * missing key, a wrong type or any other defect stays a hard error everywhere.
+ */
+function isBlankProvision (e) {
+  return /\/content$/.test(e.instancePath || '') &&
+    (e.keyword === 'minLength' || e.keyword === 'pattern')
+}
+
+let _ajv
+function ajvInstance () {
+  if (!_ajv) _ajv = buildAjv(JSON.parse(fs.readFileSync(path.join(ROOT, SCHEMA_FILE), 'utf8')))
+  return _ajv
+}
+
+/**
+ * Run every per-document check against an in-memory constitution.
+ * Exported so tests can assert the gate rejects what it must without
+ * writing fixtures to disk.
+ */
+export function validateDocument (doc, file = '<memory>') {
+  const rep = new Report()
+  const validateDoc = ajvInstance().getSchema('opencodelaw')
+  if (!validateDoc(doc)) {
+    for (const e of validateDoc.errors) {
+      rep.error(file, 'schema', e.message, e.instancePath || '/')
+    }
+  }
+  checkIdentity(rep, file, doc)
+  checkNumbering(rep, file, doc)
+  checkPlaceholderUrls(rep, file, doc)
+  return rep
+}
+
+// ---------------------------------------------------------------------------
+// Structural checks, run against every constitution document
+// ---------------------------------------------------------------------------
+
+function checkIdentity (rep, file, doc) {
+  const provisions = provisionsOf(doc)
+
+  // Global id uniqueness. A duplicate anchor silently steals another
+  // provision's permanent citation.
+  const seen = new Map()
+  for (const p of provisions) {
+    if (p.id === undefined) continue
+    if (seen.has(p.id)) {
+      rep.error(file, 'id-duplicate', `duplicate id "${p.id}" (also at ${seen.get(p.id)})`, p.where)
+    } else {
+      seen.set(p.id, p.where)
+    }
+  }
+
+  // id must agree with number. This is what makes reordering safe: identity
+  // is carried by the pair, never by array position.
+  for (const p of provisions) {
+    if (p.kind === 'article' && p.id !== `art-${p.number}`) {
+      rep.error(file, 'id-number-mismatch', `article id "${p.id}" does not match number ${p.number} (expected "art-${p.number}")`, p.where)
+    }
+    if (p.kind === 'section') {
+      const expected = `art-${p.parent?.number}-s-${p.number}`
+      if (p.id !== expected) {
+        rep.error(file, 'id-number-mismatch', `section id "${p.id}" does not match article ${p.parent?.number} section ${p.number} (expected "${expected}")`, p.where)
+      }
+    }
+  }
+}
+
+/**
+ * Numbering must be dense from 1 to the highest number present. A gap is legal
+ * only when an explicit `reserved` or `omitted` entry occupies that number —
+ * which is how a statute book represents a repealed or unused provision
+ * without renumbering everything after it. A silently missing number fails.
+ */
+function checkNumbering (rep, file, doc) {
+  const articles = doc?.articles ?? []
+  const nums = articles.map(a => a.number).filter(n => Number.isInteger(n))
+
+  const dupes = nums.filter((n, i) => nums.indexOf(n) !== i)
+  for (const n of new Set(dupes)) {
+    rep.error(file, 'number-duplicate', `article number ${n} is used more than once`, 'articles')
+  }
+
+  if (nums.length) {
+    const max = Math.max(...nums)
+    const present = new Set(nums)
+    const missing = []
+    for (let n = 1; n <= max; n++) if (!present.has(n)) missing.push(n)
+    if (missing.length) {
+      rep.error(
+        file,
+        'number-gap',
+        `article number${missing.length > 1 ? 's' : ''} ${missing.join(', ')} missing with nothing accounting for the gap. ` +
+        'Add an entry with status "reserved" (or "omitted") and a note; do not renumber the articles that follow.',
+        'articles'
+      )
+    }
+  }
+
+  for (const [i, a] of articles.entries()) {
+    const snums = (a.sections ?? []).map(s => s.number).filter(Number.isInteger)
+    if (!snums.length) continue
+    const sdupes = snums.filter((n, j) => snums.indexOf(n) !== j)
+    for (const n of new Set(sdupes)) {
+      rep.error(file, 'number-duplicate', `article ${a.number}: section number ${n} used more than once`, `articles[${i}].sections`)
+    }
+    const smax = Math.max(...snums)
+    const spresent = new Set(snums)
+    const smissing = []
+    for (let n = 1; n <= smax; n++) if (!spresent.has(n)) smissing.push(n)
+    if (smissing.length) {
+      rep.error(file, 'number-gap', `article ${a.number}: section number${smissing.length > 1 ? 's' : ''} ${smissing.join(', ')} missing with nothing accounting for the gap`, `articles[${i}].sections`)
+    }
+  }
+}
+
+/**
+ * Every heading in the live document must declare whether it carries legal
+ * force. A reader cannot tell an enacted heading from one an editor typed,
+ * and rendering both at the same weight is how `units` sat above an enacted
+ * clause for two years looking official.
+ */
+function checkTitleSource (rep, file, doc) {
+  for (const p of provisionsOf(doc)) {
+    if (p.kind === 'preamble' || (p.status ?? 'active') !== 'active') continue
+    if (!p.node?.title_source) {
+      rep.error(file, 'title-source-missing',
+        `${p.id} "${p.node?.title}" does not declare title_source (enacted | editorial)`, p.where)
+    }
+  }
+}
+
+function checkPlaceholderUrls (rep, file, doc) {
+  const walk = (node, trail) => {
+    if (typeof node === 'string') {
+      if (/example\.(com|org|net)/i.test(node)) {
+        rep.error(file, 'placeholder-url', `placeholder URL shipped in info: "${node}"`, trail)
+      }
+      return
+    }
+    if (node && typeof node === 'object') {
+      for (const [k, v] of Object.entries(node)) walk(v, `${trail}.${k}`)
+    }
+  }
+  walk(doc?.info, 'info')
+}
+
+// ---------------------------------------------------------------------------
+// Corpus-level checks: statuses, versions, archive integrity
+// ---------------------------------------------------------------------------
+
+/**
+ * A version number on a governing document asserts what is in force. When the
+ * board has adopted nothing at that version, the document must not also carry
+ * an `effective_from`: the two together read as "this text took effect on this
+ * date", which is the claim `legal_status: not_adopted` exists to disclaim.
+ */
+function checkLegalStatus (rep, docs) {
+  for (const { file, doc, archived } of docs) {
+    const info = doc?.info ?? {}
+    if (archived) continue
+    if (!info.legal_status) {
+      rep.error(file, 'legal-status-missing',
+        'the live document must declare legal_status (adopted | not_adopted). A version number ' +
+        'published without it reads as an assertion about what is in force.', 'info')
+      continue
+    }
+    if (info.legal_status === 'adopted') {
+      if (!info.effective_from) {
+        rep.error(file, 'adopted-without-date',
+          'legal_status is "adopted" but info.effective_from is missing. An adopted text takes ' +
+          'effect on a date; state it.', 'info')
+      }
+      if (info.adopted_version && info.adopted_version !== info.version) {
+        rep.error(file, 'adopted-version-mismatch',
+          `legal_status is "adopted" but adopted_version "${info.adopted_version}" differs from version "${info.version}"`, 'info.adopted_version')
+      }
+    }
+    if (info.legal_status === 'not_adopted') {
+      if (info.effective_from) {
+        rep.error(file, 'unadopted-effective-date',
+          'legal_status is "not_adopted" but info.effective_from is set. An unadopted text has no ' +
+          'effective date; state what the text reflects in text_as_of instead.', 'info.effective_from')
+      }
+      if (info.adopted_version && info.adopted_version === info.version) {
+        rep.error(file, 'unadopted-version-collision',
+          `adopted_version "${info.adopted_version}" equals the working version; if the board adopted it, legal_status should be "adopted"`, 'info.adopted_version')
+      }
+    }
+  }
+}
+
+function checkVersionIdentity (rep, docs) {
+  for (const { file, doc, archived, expectedVersion } of docs) {
+    const info = doc?.info ?? {}
+    if (archived) {
+      if (info.version !== expectedVersion) {
+        rep.error(file, 'archive-version-mismatch', `info.version "${info.version}" does not match its filename (expected "${expectedVersion}")`, 'info.version')
+      }
+      if (info.status !== 'superseded') {
+        rep.error(file, 'archive-status', `archived version must declare status "superseded", found "${info.status}"`, 'info.status')
+      }
+      if (info.superseded_by === undefined) {
+        rep.warn(file, 'archive-successor-missing', 'no info.superseded_by; archived pages must name the version that replaced them in a visible banner', 'info')
+      } else if (info.superseded_by === info.version) {
+        rep.error(file, 'archive-successor-self', 'info.superseded_by cannot equal info.version', 'info.superseded_by')
+      }
+    } else if (info.status !== 'current') {
+      rep.error(file, 'current-status', `the live constitution must declare status "current", found "${info.status}"`, 'info.status')
+    }
+  }
+
+  const currents = docs.filter(d => d.doc?.info?.status === 'current')
+  if (currents.length !== 1) {
+    rep.error(currents[0]?.file ?? CURRENT_FILE, 'current-count', `exactly one document may be "current"; found ${currents.length}`, 'info.status')
+  }
+
+  // The audit's §3.3 failure, made unrepeatable: an archived snapshot carrying
+  // the live version means the archive and the current text are the same
+  // document, so editing the constitution rewrites its own history.
+  const live = currents[0]
+  if (live) {
+    for (const d of docs.filter(x => x.archived)) {
+      if (d.doc?.info?.version === live.doc?.info?.version) {
+        rep.error(d.file, 'archive-shadows-current', `archived version "${d.doc.info.version}" duplicates the current version; the archive must contain only superseded versions`, 'info.version')
+      }
+    }
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Act register cross-references
+// ---------------------------------------------------------------------------
+
+/** First line of an Act's Statement of Objects and Reasons, or null. */
+export function statementOfObjectsLine (sourceText) {
+  const lines = sourceText.split('\n')
+  const i = lines.findIndex(l => /STATEMENT\s+OF\s+OBJECTS\s+AND\s+REASONS/i.test(l))
+  return i === -1 ? null : i + 1
+}
+
+function parseLineRange (spec) {
+  const m = String(spec).match(/^(\d+)(?:\s*-\s*(\d+))?$/)
+  if (!m) return null
+  return { from: Number(m[1]), to: Number(m[2] ?? m[1]) }
+}
+
+/**
+ * A Statement of Objects and Reasons is explanatory, never enacting. It may be
+ * cited as evidence of intent — that is what `drafting_discrepancy` is for —
+ * but it can never be the authority for an operation. If it could authorise a
+ * deletion in one article it could set a voting threshold in another, and the
+ * ruling that the operative text governs collapses.
+ */
+function checkStatementOfObjects (rep, acts) {
+  for (const [i, act] of acts.entries()) {
+    if (!act.source_text) continue
+    const abs = path.join(ROOT, act.source_text)
+    if (!fs.existsSync(abs)) continue
+    const sor = statementOfObjectsLine(fs.readFileSync(abs, 'utf8').replace(/\f/g, ''))
+    if (sor == null) continue
+
+    for (const [j, p] of (act.provisions ?? []).entries()) {
+      if (!p.source_lines) continue
+      const range = parseLineRange(p.source_lines)
+      if (!range) {
+        rep.error(REGISTER_FILE, 'source-lines-malformed', `acts[${i}].provisions[${j}] source_lines "${p.source_lines}" is not a line or range`, `acts[${i}].provisions[${j}].source_lines`)
+        continue
+      }
+      if (range.to >= sor) {
+        rep.error(
+          REGISTER_FILE,
+          'sor-as-authority',
+          `acts[${i}] "${act.id}" cites lines ${p.source_lines} for ${p.target}, which fall in the ` +
+          `Statement of Objects and Reasons (from line ${sor} of ${act.source_text}). ` +
+          'A Statement of Objects is explanatory, not enacting; cite the operative text. ' +
+          'To record what it says, use drafting_discrepancy.',
+          `acts[${i}].provisions[${j}].source_lines`
+        )
+      }
+    }
+  }
+}
+
+function checkRegister (rep, register, docs) {
+  const file = REGISTER_FILE
+  const acts = register?.acts ?? []
+
+  const ids = new Set()
+  for (const [i, act] of acts.entries()) {
+    if (ids.has(act.id)) rep.error(file, 'id-duplicate', `duplicate act id "${act.id}"`, `acts[${i}]`)
+    ids.add(act.id)
+
+    if (act.id !== `act-${act.number}-${act.year}`) {
+      rep.error(file, 'id-number-mismatch', `act id "${act.id}" does not match number ${act.number} and year ${act.year}`, `acts[${i}]`)
+    }
+
+    for (const key of ['pdf', 'source_text']) {
+      if (act[key] && !fs.existsSync(path.join(ROOT, act[key]))) {
+        rep.error(file, 'act-file-missing', `${key} "${act[key]}" does not exist on disk`, `acts[${i}].${key}`)
+      }
+    }
+  }
+
+  checkStatementOfObjects(rep, acts)
+
+  // Act references resolve against the live constitution, which is the only
+  // document an Act can amend.
+  const live = docs.find(d => !d.archived)
+  if (!live) return
+  const known = new Set(provisionsOf(live.doc).map(p => p.id))
+
+  for (const [i, act] of acts.entries()) {
+    for (const [j, target] of (act.amends ?? []).entries()) {
+      if (!known.has(target)) {
+        rep.error(file, 'act-reference-unresolved', `acts[${i}] "${act.id}" amends "${target}", which no provision in ${live.file} produces`, `acts[${i}].amends[${j}]`)
+      }
+    }
+    for (const [j, p] of (act.provisions ?? []).entries()) {
+      if (!known.has(p.target)) {
+        rep.error(file, 'act-reference-unresolved', `acts[${i}] "${act.id}" targets "${p.target}", which no provision in ${live.file} produces`, `acts[${i}].provisions[${j}].target`)
+      }
+    }
+  }
+
+  // ...and every amended_by on a provision must name a real Act.
+  for (const { file: cfile, doc } of docs) {
+    const nodes = [doc?.preamble, ...(doc?.articles ?? []).flatMap(a => [a, ...(a.sections ?? [])])].filter(Boolean)
+    for (const n of nodes) {
+      for (const ref of n.amended_by ?? []) {
+        if (!ids.has(ref)) {
+          rep.error(cfile, 'act-reference-unresolved', `provision "${n.id}" claims amended_by "${ref}", which is not in ${REGISTER_FILE}`, n.id)
+        }
+      }
+      if (n.provenance?.matches_act && !ids.has(n.provenance.matches_act)) {
+        rep.error(cfile, 'act-reference-unresolved', `provision "${n.id}" has provenance.matches_act "${n.provenance.matches_act}", which is not in ${REGISTER_FILE}`, n.id)
+      }
+    }
+  }
+}
+
+/**
+ * Any in-page anchor a template hard-codes must be produced by a real
+ * provision, so a template can never link into a void.
+ */
+function checkTemplateAnchors (rep, docs) {
+  const dir = path.join(ROOT, TEMPLATES_DIR)
+  if (!fs.existsSync(dir)) return 0
+  const files = fs.readdirSync(dir, { recursive: true })
+    .filter(f => typeof f === 'string' && /\.(html|hbs|mjs|js)$/.test(f))
+  const live = docs.find(d => !d.archived)
+  if (!live) return 0
+  const anchors = anchorsOf(live.doc)
+
+  let scanned = 0
+  for (const f of files) {
+    const full = path.join(dir, f)
+    if (!fs.statSync(full).isFile()) continue
+    scanned++
+    const src = fs.readFileSync(full, 'utf8')
+    for (const m of src.matchAll(/href=["']#(art-[a-z0-9-]+|preamble)["']/gi)) {
+      if (!anchors.has(m[1])) {
+        rep.error(`${TEMPLATES_DIR}/${f}`, 'anchor-unresolved', `template links to #${m[1]}, which no provision produces`, f)
+      }
+    }
+  }
+  return scanned
+}
+
+// ---------------------------------------------------------------------------
+
+export function validate () {
+  const rep = new Report()
+  const ajv = ajvInstance()
+  const validateDoc = ajv.getSchema('opencodelaw')
+  const validateRegister = ajv.compile({ $ref: 'opencodelaw#/$defs/actRegister' })
+
+  const docs = []
+
+  // Live document
+  docs.push({ file: CURRENT_FILE, doc: loadYaml(CURRENT_FILE), archived: false })
+
+  // Archived versions, expected version taken from the filename
+  const versionsDir = path.join(ROOT, VERSIONS_DIR)
+  const archived = fs.existsSync(versionsDir)
+    ? fs.readdirSync(versionsDir).filter(f => f.endsWith('.yaml')).sort()
+    : []
+  for (const f of archived) {
+    docs.push({
+      file: `${VERSIONS_DIR}/${f}`,
+      doc: loadYaml(`${VERSIONS_DIR}/${f}`),
+      archived: true,
+      expectedVersion: f.replace(/^v/, '').replace(/\.yaml$/, '')
+    })
+  }
+
+  for (const d of docs) {
+    if (!validateDoc(d.doc)) {
+      for (const e of validateDoc.errors) {
+        const msg = `${e.message}${e.params?.allowedValues ? ` (${e.params.allowedValues.join(', ')})` : ''}`
+        const where = describePath(d.doc, e.instancePath)
+
+        // A blank provision in an archived version is a publication defect,
+        // recorded rather than repaired: the archive must reproduce what was
+        // actually published, and Article 11 of v2.0.0 was published blank.
+        // The same blank in the live document stays a hard error — that is the
+        // defect this validator exists to catch.
+        if (d.archived && isBlankProvision(e)) {
+          rep.warn(d.file, 'archived-blank-provision',
+            'published with no text. Preserved as published; the build renders an explicit marker.', where)
+          continue
+        }
+        rep.error(d.file, 'schema', msg, where)
+      }
+    }
+    checkIdentity(rep, d.file, d.doc)
+    checkNumbering(rep, d.file, d.doc)
+    checkPlaceholderUrls(rep, d.file, d.doc)
+    // Required on the live document only. Archived versions are append-never,
+    // edit-never, so the rule cannot be applied retroactively to them.
+    if (!d.archived) checkTitleSource(rep, d.file, d.doc)
+  }
+
+  checkVersionIdentity(rep, docs)
+  checkLegalStatus(rep, docs)
+
+  let register = null
+  if (fs.existsSync(path.join(ROOT, REGISTER_FILE))) {
+    register = loadYaml(REGISTER_FILE)
+    if (!validateRegister(register)) {
+      for (const e of validateRegister.errors) {
+        rep.error(REGISTER_FILE, 'schema', e.message, e.instancePath || '/')
+      }
+    }
+    checkRegister(rep, register, docs)
+  }
+
+  const templatesScanned = checkTemplateAnchors(rep, docs)
+
+  return { rep, docs, register, templatesScanned }
+}
+
+function report ({ rep, docs, register, templatesScanned }) {
+  const out = []
+  out.push('OpenCodeLaw — validation\n')
+
+  for (const d of docs) {
+    const p = provisionsOf(d.doc)
+    const arts = p.filter(x => x.kind === 'article')
+    const secs = p.filter(x => x.kind === 'section')
+    const reserved = arts.filter(a => a.status !== 'active')
+    const errs = rep.errors.filter(e => e.file === d.file)
+    const warns = rep.warnings.filter(e => e.file === d.file)
+    const mark = errs.length ? '✗' : '✓'
+    out.push(`  ${mark} ${d.file}`)
+    out.push(`      v${d.doc?.info?.version} · ${d.doc?.info?.status} · ${arts.length} articles · ${secs.length} sections` +
+      (reserved.length ? ` · ${reserved.length} reserved/omitted` : ''))
+    for (const e of errs) out.push(`      ERROR  [${e.code}] ${e.where ? e.where + ': ' : ''}${e.message}`)
+    for (const e of warns) out.push(`      warn   [${e.code}] ${e.where ? e.where + ': ' : ''}${e.message}`)
+  }
+
+  if (register) {
+    const errs = rep.errors.filter(e => e.file === REGISTER_FILE)
+    out.push(`  ${errs.length ? '✗' : '✓'} ${REGISTER_FILE}`)
+    out.push(`      ${register.acts?.length ?? 0} acts`)
+    for (const e of errs) out.push(`      ERROR  [${e.code}] ${e.where ? e.where + ': ' : ''}${e.message}`)
+  } else {
+    out.push(`  – ${REGISTER_FILE} not present; act cross-reference checks skipped`)
+  }
+
+  const tmplErrs = rep.errors.filter(e => e.code === 'anchor-unresolved')
+  out.push(templatesScanned
+    ? `  ${tmplErrs.length ? '✗' : '✓'} ${TEMPLATES_DIR} — ${templatesScanned} template(s) scanned for dangling anchors`
+    : `  – ${TEMPLATES_DIR} empty; anchor checks skipped`)
+  for (const e of tmplErrs) out.push(`      ERROR  ${e.message}`)
+
+  out.push('')
+  out.push(rep.errors.length
+    ? `FAILED — ${rep.errors.length} error(s), ${rep.warnings.length} warning(s)`
+    : `PASSED — 0 errors, ${rep.warnings.length} warning(s)`)
+  return out.join('\n')
+}
+
+const invokedDirectly = process.argv[1] && fileURLToPath(import.meta.url) === path.resolve(process.argv[1])
+if (invokedDirectly) {
+  const result = validate()
+  console.log(report(result))
+  process.exit(result.rep.errors.length ? 1 : 0)
+}
diff --git a/tests/build-output.test.mjs b/tests/build-output.test.mjs
new file mode 100644
index 0000000..ddc4944
--- /dev/null
+++ b/tests/build-output.test.mjs
@@ -0,0 +1,384 @@
+/**
+ * Verifies the built site, not the source.
+ *
+ * The failure this suite exists to prevent: a page that looks right in a
+ * browser with JavaScript on, and is empty to a search engine, a social
+ * scraper, or a reader on a slow connection.
+ */
+import { test, before } from 'node:test'
+import assert from 'node:assert/strict'
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import yaml from 'js-yaml'
+import { linkcheck } from '../src/linkcheck.mjs'
+import { normaliseBase, slugMap, DEFAULT_BASE_PATH } from '../src/lib/paths.mjs'
+import { toPlainText } from '../src/lib/markdown.mjs'
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+const DIST = path.join(ROOT, 'dist')
+const BASE = normaliseBase(DEFAULT_BASE_PATH)
+
+const doc = yaml.load(fs.readFileSync(path.join(ROOT, 'constitution/current.yaml'), 'utf8'), { schema: yaml.CORE_SCHEMA })
+const slugs = slugMap(doc.articles)
+const read = rel => fs.readFileSync(path.join(DIST, rel), 'utf8')
+const exists = rel => fs.existsSync(path.join(DIST, rel))
+
+before(() => {
+  assert.ok(fs.existsSync(DIST), 'dist/ missing — run `npm run build` before the tests')
+})
+
+// --- V1 ---------------------------------------------------------------------
+
+test('V1 the full constitution is present with no JavaScript', () => {
+  const html = read('index.html')
+  // Scripts are enhancement only: strip them and the text must survive.
+  const noScript = html.replace(/<script[\s\S]*?<\/script>/g, '')
+
+  for (const a of doc.articles) {
+    assert.ok(noScript.includes(`id="${a.id}"`), `${a.id} missing from index.html`)
+    assert.ok(noScript.includes(a.title.replace(/&/g, '&amp;')), `title of ${a.id} missing`)
+    for (const s of a.sections ?? []) {
+      assert.ok(noScript.includes(`id="${s.id}"`), `${s.id} missing from index.html`)
+    }
+  }
+
+  // Real provision prose, not just headings.
+  const sample = toPlainText(doc.articles.find(a => a.content)?.content).slice(0, 60)
+  assert.ok(sample.length > 20)
+  const flat = noScript.replace(/<[^>]+>/g, ' ').replace(/&amp;/g, '&').replace(/\s+/g, ' ')
+  assert.ok(flat.includes(sample.slice(0, 40)), 'provision prose missing from served HTML')
+})
+
+test('V1 a blank provision renders an explicit marker rather than nothing', () => {
+  // Article 11 of the archived v2.0.0 was published with no text.
+  if (!exists('archive/2.0.0/index.html')) return
+  const html = read('archive/2.0.0/index.html')
+  assert.ok(html.includes('No text was recorded for this provision'),
+    'archived blank provision must render a visible marker')
+})
+
+// --- V2 / V4 ----------------------------------------------------------------
+
+test('V2+V4 zero internal 404s and nothing escapes the base path', () => {
+  const { problems, stats } = linkcheck()
+  assert.ok(stats.files > 20, `expected a full site, saw ${stats.files} pages`)
+  assert.deepEqual(problems, [], problems.slice(0, 5).map(p => `${p.file} -> ${p.url}: ${p.why}`).join('\n'))
+})
+
+test('V4 every asset URL is base-path aware', () => {
+  const html = read('index.html')
+  const refs = [...html.matchAll(/\b(?:href|src)="(\/[^"]*)"/g)].map(m => m[1])
+  assert.ok(refs.length > 0)
+  for (const r of refs) {
+    assert.ok(r.startsWith(BASE), `${r} does not start with ${BASE} and would 404 on project Pages`)
+  }
+})
+
+// --- V3 ---------------------------------------------------------------------
+
+test('V3 legacy #articleN anchors map for all 18 articles', () => {
+  const map = JSON.parse(read('legacy-anchors.json'))
+  const html = read('index.html')
+
+  doc.articles.forEach((a, i) => {
+    const legacy = `article${i + 1}`
+    assert.equal(map[legacy], a.id, `${legacy} must map to ${a.id}`)
+    assert.ok(html.includes(`id="${a.id}"`), `${a.id} must exist on the page the map points at`)
+    ;(a.sections ?? []).forEach((s, j) => {
+      const legacySec = `article${i + 1}-section${j + 1}`
+      assert.equal(map[legacySec], s.id, `${legacySec} must map to ${s.id}`)
+    })
+  })
+  assert.equal(Object.keys(map).filter(k => /^article\d+$/.test(k)).length, doc.articles.length)
+})
+
+// --- V5 ---------------------------------------------------------------------
+
+const PAGE_TYPES = [
+  ['index.html', 'home'],
+  [`articles/${[...slugs.values()][0]}/index.html`, 'article'],
+  ['amendments/index.html', 'amendments'],
+  ['archive/index.html', 'archive']
+]
+
+for (const [rel, label] of PAGE_TYPES) {
+  test(`V5 ${label} page carries title, description, canonical, OG and JSON-LD in raw HTML`, () => {
+    const html = read(rel)
+    const head = html.slice(0, html.indexOf('</head>'))
+
+    const title = head.match(/<title>([^<]+)<\/title>/)?.[1]
+    assert.ok(title && title.length > 10, 'missing or trivial <title>')
+
+    const desc = head.match(/<meta name="description" content="([^"]*)"/)?.[1]
+    assert.ok(desc && desc.length > 30, `missing or trivial description on ${label}`)
+    assert.ok(!/^Constitution page$/.test(desc), 'description must not be boilerplate')
+
+    assert.match(head, /<link rel="canonical" href="https?:\/\/[^"]+"/, 'missing canonical')
+    assert.match(head, /<meta property="og:title"/, 'missing og:title')
+    assert.match(head, /<meta property="og:description"/, 'missing og:description')
+    assert.match(head, /<meta property="og:url"/, 'missing og:url')
+    assert.match(head, /<meta name="twitter:card" content="summary_large_image"/, 'missing twitter card')
+
+    const ld = [...head.matchAll(/<script type="application\/ld\+json">([\s\S]*?)<\/script>/g)]
+    assert.ok(ld.length > 0, `no JSON-LD on ${label}`)
+    for (const m of ld) {
+      const parsed = JSON.parse(m[1])
+      assert.equal(parsed['@context'], 'https://schema.org')
+      assert.ok(parsed['@type'], 'JSON-LD node without @type')
+    }
+
+    // A real <h1> in the served source, not injected by script.
+    const noScript = html.replace(/<script[\s\S]*?<\/script>/g, '')
+    assert.match(noScript, /<h1[^>]*>/, `${label} has no <h1> in the served HTML`)
+  })
+}
+
+test('V5 every article page has a unique title and description', () => {
+  const seenTitle = new Set()
+  const seenDesc = new Set()
+  for (const slug of slugs.values()) {
+    const head = read(`articles/${slug}/index.html`)
+    const title = head.match(/<title>([^<]+)<\/title>/)[1]
+    const desc = head.match(/<meta name="description" content="([^"]*)"/)[1]
+    assert.ok(!seenTitle.has(title), `duplicate title: ${title}`)
+    assert.ok(!seenDesc.has(desc), `duplicate description on ${slug}`)
+    seenTitle.add(title)
+    seenDesc.add(desc)
+  }
+  assert.equal(seenTitle.size, doc.articles.length)
+})
+
+// --- structure --------------------------------------------------------------
+
+test('archived pages carry a canonical to the current version and a superseded banner', () => {
+  for (const dir of ['archive/1.0.0', 'archive/2.0.0']) {
+    if (!exists(`${dir}/index.html`)) continue
+    const html = read(`${dir}/index.html`)
+    assert.match(html, /<link rel="canonical" href="[^"]+"/)
+    assert.ok(html.includes('This version is superseded'), `${dir} missing superseded banner`)
+    assert.ok(html.includes('banner--superseded'))
+  }
+})
+
+test('the reconciliation banner appears only while reconciliation_state says so', () => {
+  const html = read('index.html')
+  const state = doc.reconciliation_state
+
+  if (!state || state.complete) {
+    // All three Acts are applied. Leaving the banner up would be its own kind
+    // of dishonesty, and its absence must follow the data, not a template edit.
+    assert.ok(!html.includes('mid-reconciliation'),
+      'the banner still renders but reconciliation_state is gone')
+    const amendments = read('amendments/index.html')
+    assert.ok(amendments.includes('Standing notes for a future Act'))
+    assert.ok(/Article 19 is reserved/.test(amendments), 'Article 19 must still be accounted for')
+    assert.ok(/Donor/.test(amendments), 'the Article 6(6) tension must still be recorded')
+  } else {
+    assert.ok(html.includes('mid-reconciliation'), 'banner missing')
+    for (const held of state.held) {
+      const why = Array.isArray(held.blocked_by) ? held.blocked_by : [held.blocked_by]
+      for (const w of why) assert.ok(html.includes(w), `banner does not mention blocker "${w}"`)
+    }
+  }
+})
+
+test('the custom domain ships with the artifact', () => {
+  // Inverted at cutover. constitution.stmorg.in now points at this build, and
+  // an Actions deploy whose artifact has no CNAME can drop the domain setting.
+  // Opt out with INCLUDE_CNAME=false, never by omission.
+  assert.ok(exists('CNAME'), 'CNAME must ship now that the custom domain is live')
+  assert.equal(read('CNAME').trim(), 'constitution.stmorg.in')
+})
+
+test('the built site is compiled for the base path it is served from', () => {
+  // The cutover breakage: the artifact was compiled for /OpenCodeLaw/ while the
+  // apex domain serves from /, so every asset and link 404'd.
+  const html = read('index.html')
+  const refs = [...html.matchAll(/\b(?:href|src)="(\/[^"]*)"/g)].map(m => m[1])
+  const cname = exists('CNAME') ? read('CNAME').trim() : null
+  if (cname) {
+    assert.equal(BASE, '/',
+      `CNAME is set to ${cname} (an apex domain, served from /), but the build used base path ${BASE}`)
+    for (const r of refs) {
+      assert.ok(!/^\/OpenCodeLaw\//.test(r), `${r} still carries the project-Pages prefix`)
+    }
+  }
+  const canonical = html.match(/<link rel="canonical" href="([^"]+)"/)[1]
+  if (cname) assert.ok(canonical.includes(cname), `canonical ${canonical} does not point at ${cname}`)
+})
+
+test('no runtime CDN reference survives into the output', () => {
+  for (const rel of ['index.html', 'amendments/index.html', 'archive/index.html']) {
+    const html = read(rel)
+    assert.ok(!/cdn\.jsdelivr|cdnjs\.cloudflare|unpkg\.com/.test(html),
+      `${rel} still references a CDN`)
+  }
+})
+
+test('every Act PDF named in the register is reachable in the build', () => {
+  const reg = yaml.load(fs.readFileSync(path.join(ROOT, 'acts/register.yaml'), 'utf8'), { schema: yaml.CORE_SCHEMA })
+  for (const act of reg.acts) {
+    assert.ok(exists(act.pdf), `${act.id}: ${act.pdf} missing from dist/`)
+  }
+})
+
+test('section headings sit one level below their article on every page type', () => {
+  // The document outline is how screen-reader users navigate a long legal text.
+  // Lighthouse will not catch a flattened outline: its sequential-headings audit
+  // only flags a skipped level, and h3 -> h3 is not a skip.
+  const pages = [
+    ['index.html', 3],
+    [`articles/${slugs.get('art-6')}/index.html`, 2]
+  ]
+  for (const [rel, articleLevel] of pages) {
+    const html = read(rel)
+    const art = doc.articles.find(a => a.sections?.length)
+    const start = html.indexOf(`id="${art.id}"`)
+    assert.ok(start > -1)
+    const segment = html.slice(start, start + 8000)
+
+    const artH = segment.match(new RegExp(`<h([1-6])[^>]*id="h-${art.id}"`))
+    assert.equal(Number(artH[1]), articleLevel, `${rel}: article heading level`)
+
+    for (const s of art.sections) {
+      const m = segment.match(new RegExp(`<h([1-6])[^>]*id="h-${s.id}"`))
+      assert.ok(m, `${rel}: ${s.id} heading missing`)
+      assert.equal(Number(m[1]), articleLevel + 1,
+        `${rel}: ${s.id} is <h${m[1]}> under an <h${articleLevel}> article — the outline says they are siblings`)
+    }
+  }
+})
+
+test('heading levels never skip on any page type', () => {
+  for (const rel of ['index.html', `articles/${[...slugs.values()][0]}/index.html`, 'amendments/index.html', 'archive/index.html']) {
+    const html = read(rel).replace(/<script[\s\S]*?<\/script>/g, '')
+    const levels = [...html.matchAll(/<h([1-6])\b/g)].map(m => Number(m[1]))
+    let prev = levels[0]
+    for (const l of levels.slice(1)) {
+      assert.ok(l <= prev + 1, `${rel}: jumped from h${prev} to h${l}`)
+      prev = l
+    }
+  }
+})
+
+test('legacy Apache URLs redirect instead of 404ing', () => {
+  // The previous host rewrote /x.html to the extensionless /x, so both shapes
+  // exist in the wild. Static hosting cannot rewrite; each gets a real page.
+  const cases = [
+    ['archives/v1/index.html', '1.0.0'],
+    ['archives/v2/index.html', '2.0.0'],
+    ['archives/v1.html', '1.0.0'],
+    ['archives/v2.html', '2.0.0']
+  ]
+  for (const [rel, version] of cases) {
+    assert.ok(exists(rel), `${rel} missing — an old inbound link would 404`)
+    const html = read(rel)
+    const target = `archive/${version}/`
+    assert.ok(html.includes(`url=${BASE}${target}`), `${rel} does not meta-refresh to ${target}`)
+    assert.match(html, /<link rel="canonical" href="https?:\/\/[^"]+"/, `${rel} needs a canonical`)
+    assert.ok(html.includes('noindex'), `${rel} should not be indexed in its own right`)
+    // And the destination must actually exist in this build.
+    assert.ok(exists(`${target}index.html`), `${rel} redirects to ${target}, which is not built`)
+  }
+})
+
+test('every live heading declares whether it carries legal force', () => {
+  for (const a of doc.articles) {
+    if ((a.status ?? 'active') !== 'active') continue
+    assert.ok(['enacted', 'editorial'].includes(a.title_source), `${a.id} missing title_source`)
+    for (const s of a.sections ?? []) {
+      assert.ok(['enacted', 'editorial'].includes(s.title_source), `${s.id} missing title_source`)
+    }
+  }
+})
+
+test('the amendments page lists both enacted and editorial headings for the board', () => {
+  const html = read('amendments/index.html')
+  assert.ok(html.includes('Which headings carry legal force'), 'no explanation of the marker')
+
+  const pick = kind => doc.articles.flatMap(a => [
+    ...(a.title_source === kind ? [a.id] : []),
+    ...(a.sections ?? []).filter(s => s.title_source === kind).map(s => s.id)
+  ])
+  for (const id of [...pick('editorial'), ...pick('enacted')]) {
+    assert.ok(html.includes(`#${id}`), `${id} is not listed for the board`)
+  }
+
+  // A heading credited to an Act that has not been applied would be a false
+  // claim of legal force. Act 2 retitles Article 14, but Act 2 is not applied.
+  for (const a of doc.articles) {
+    if (a.title_source === 'enacted') {
+      assert.ok((a.amended_by ?? []).length > 0,
+        `${a.id} claims an enacted heading but no Act is recorded as amending it`)
+    }
+  }
+})
+
+test('the contact link works without JavaScript', () => {
+  // Cloudflare's Email Address Obfuscation rewrites mailto: links at the edge
+  // into /cdn-cgi/l/email-protection#<hex>, which only resolves once its script
+  // has run. On a site whose premise is that it works with JavaScript disabled,
+  // that silently breaks the one outbound link a reader is most likely to need.
+  //
+  // This asserts the BUILD is clean. The rewrite happens at the edge, so it
+  // cannot be fixed here — see .night-run/CUTOVER.md for the two routes, both
+  // of which are Cloudflare-side.
+  for (const rel of ['index.html', 'amendments/index.html', 'archive/index.html', '404.html']) {
+    const html = read(rel)
+    assert.ok(!/cdn-cgi\/l\/email-protection/.test(html),
+      `${rel} contains a Cloudflare email-obfuscation link in the build output`)
+  }
+  const html = read('index.html')
+  const noScript = html.replace(/<script[\s\S]*?<\/script>/g, '')
+  const mailto = noScript.match(/href="mailto:([^"]+)"/)
+  assert.ok(mailto, 'the footer contact must be a real mailto: in the served HTML')
+  assert.ok(mailto[1].includes('@'), `mailto target looks wrong: ${mailto[1]}`)
+})
+
+test('the headline states the adopted position, not the working version label', () => {
+  // A version number on a governing document asserts what is in force. The
+  // board has adopted nothing at 3.0.0-alpha.1, and the effective date it
+  // previously carried contradicted the banner immediately below it.
+  const html = read('index.html')
+  const lead = html.match(/<p class="page-lead[^"]*">([\s\S]*?)<\/p>/)[1].replace(/<[^>]+>/g, ' ')
+
+  if (doc.info.legal_status === 'not_adopted') {
+    assert.ok(!lead.includes(doc.info.version),
+      `the headline publishes the working label "${doc.info.version}" as the document's status`)
+    assert.ok(lead.includes(doc.info.adopted_version), 'the headline must name the adopted version')
+    assert.ok(/no later version has been adopted/i.test(lead), 'the headline must disclaim adoption')
+    assert.ok(!doc.info.effective_from,
+      'an unadopted text must not carry an effective date')
+
+    // The working label stays visible, but as build metadata where it belongs.
+    const amendments = read('amendments/index.html')
+    assert.ok(amendments.includes(doc.info.version),
+      'the working label should still be discoverable on the amendments page')
+    assert.ok(/not a statement of what is in force/i.test(amendments),
+      'the amendments page must say the label is not a legal claim')
+  }
+})
+
+test('the marked headings are the minority, whichever kind that is', () => {
+  const html = read('index.html')
+  const marks = (html.match(/class="title-mark"/g) ?? []).length
+
+  const nodes = [doc.preamble, ...doc.articles.flatMap(a => [a, ...(a.sections ?? [])])]
+    .filter(n => (n.status ?? 'active') === 'active')
+  const enacted = nodes.filter(n => n.title_source === 'enacted').length
+  const editorial = nodes.length - enacted
+
+  // Applying the Acts flipped this from 8 enacted of 40 to 32 of 40, so the
+  // direction follows the data rather than a constant.
+  assert.equal(marks, Math.min(enacted, editorial),
+    `expected the minority (${Math.min(enacted, editorial)}) marked, found ${marks}`)
+
+  // "not enacted" must never sit inside a heading, where it reads as a claim
+  // about the provision rather than about its heading.
+  for (const h of html.matchAll(/<h[2-6][^>]*class="provision__heading"[^>]*>([\s\S]*?)<\/h[2-6]>/g)) {
+    assert.ok(!/not enacted/i.test(h[1]))
+  }
+  assert.ok(/unless marked/i.test(read('amendments/index.html')),
+    'the default must be stated once on the amendments page')
+})
diff --git a/tests/citation-identity.test.mjs b/tests/citation-identity.test.mjs
new file mode 100644
index 0000000..728d682
--- /dev/null
+++ b/tests/citation-identity.test.mjs
@@ -0,0 +1,129 @@
+/**
+ * The Phase 2 invariants, asserted rather than assumed.
+ *
+ * These exist because the previous renderer derived article numbers from array
+ * position, which meant reordering the YAML silently re-pointed every citation
+ * in every Amendment Act.
+ */
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import fs from 'node:fs'
+import path from 'node:path'
+import yaml from 'js-yaml'
+import { validateDocument, provisionsOf, anchorsOf, ROOT } from '../src/validate.mjs'
+
+const live = () => yaml.load(
+  fs.readFileSync(path.join(ROOT, 'constitution/current.yaml'), 'utf8'),
+  { schema: yaml.CORE_SCHEMA }
+)
+
+const codes = rep => rep.errors.map(e => e.code)
+
+// ---------------------------------------------------------------------------
+
+test('reordering articles changes no anchor and no citation', () => {
+  const original = live()
+  const before = anchorsOf(original)
+
+  const shuffled = structuredClone(original)
+  const a = shuffled.articles.findIndex(x => x.number === 3)
+  const b = shuffled.articles.findIndex(x => x.number === 15)
+  ;[shuffled.articles[a], shuffled.articles[b]] = [shuffled.articles[b], shuffled.articles[a]]
+  shuffled.articles.reverse()
+
+  assert.deepEqual([...anchorsOf(shuffled)].sort(), [...before].sort(),
+    'anchor set changed when the article order changed')
+
+  for (const p of provisionsOf(shuffled)) {
+    if (p.kind === 'article') assert.equal(p.id, `art-${p.number}`)
+    if (p.kind === 'section') assert.equal(p.id, `art-${p.parent.number}-s-${p.number}`)
+  }
+
+  // Reordering must not introduce validation errors beyond those already present.
+  assert.deepEqual(codes(validateDocument(shuffled)).sort(), codes(validateDocument(original)).sort())
+})
+
+test('removing a content key fails validation instead of breaking the site', () => {
+  const doc = live()
+  const target = doc.articles.find(a => a.content && a.content.trim())
+  delete target.content
+  assert.ok(codes(validateDocument(doc)).includes('schema'),
+    'a missing content key must be a hard error')
+})
+
+test('empty and whitespace-only content are rejected too', () => {
+  for (const value of ['', '   ', '\n\n']) {
+    const doc = live()
+    doc.articles.find(a => a.number === 1).content = value
+    assert.ok(codes(validateDocument(doc)).includes('schema'),
+      `content ${JSON.stringify(value)} must be rejected`)
+  }
+})
+
+test('a silent numbering gap fails; a reserved entry accounting for it passes', () => {
+  const doc = live()
+  const max = Math.max(...doc.articles.map(a => a.number))
+
+  // Insert an article at max + 2, leaving max + 1 unaccounted for.
+  doc.articles.push({ id: `art-${max + 2}`, number: max + 2, title: 'Later', content: 'text' })
+  assert.ok(codes(validateDocument(doc)).includes('number-gap'),
+    'an unexplained gap must fail')
+
+  // Now account for the gap the way a statute book does.
+  doc.articles.push({
+    id: `art-${max + 1}`,
+    number: max + 1,
+    title: 'Reserved',
+    status: 'reserved',
+    note: 'No instrument has occupied this number.'
+  })
+  assert.ok(!codes(validateDocument(doc)).includes('number-gap'),
+    'a reserved entry must close the gap')
+})
+
+test('a reserved article may not carry text, and must carry a note', () => {
+  const doc = live()
+  const max = Math.max(...doc.articles.map(a => a.number))
+  doc.articles.push({ id: `art-${max + 1}`, number: max + 1, title: 'R', status: 'reserved', content: 'text' })
+  assert.ok(codes(validateDocument(doc)).includes('schema'))
+
+  const doc2 = live()
+  const max2 = Math.max(...doc2.articles.map(a => a.number))
+  doc2.articles.push({ id: `art-${max2 + 1}`, number: max2 + 1, title: 'R', status: 'reserved' })
+  assert.ok(codes(validateDocument(doc2)).includes('schema'), 'reserved without a note must fail')
+})
+
+test('id must agree with number, so identity can never drift from citation', () => {
+  const doc = live()
+  doc.articles.find(a => a.number === 5).id = 'art-6'
+  assert.ok(codes(validateDocument(doc)).includes('id-duplicate'))
+  assert.ok(codes(validateDocument(doc)).includes('id-number-mismatch'))
+
+  const doc2 = live()
+  const art = doc2.articles.find(a => a.sections?.length)
+  art.sections[0].id = `art-${art.number}-s-99`
+  assert.ok(codes(validateDocument(doc2)).includes('id-number-mismatch'))
+})
+
+test('duplicate numbers are rejected', () => {
+  const doc = live()
+  doc.articles.find(a => a.number === 4).number = 3
+  assert.ok(codes(validateDocument(doc)).includes('number-duplicate'))
+})
+
+test('placeholder URLs in info are rejected', () => {
+  const doc = live()
+  doc.info.contact = { ...doc.info.contact, url: 'https://example.com/contact' }
+  assert.ok(codes(validateDocument(doc)).includes('placeholder-url'))
+})
+
+test('the live constitution carries a permanent id for every provision', () => {
+  const doc = live()
+  const provisions = provisionsOf(doc)
+  assert.ok(provisions.length > 0)
+  for (const p of provisions) {
+    assert.match(p.id, /^(preamble|art-[1-9]\d*(-s-[1-9]\d*)?)$/,
+      `provision at ${p.where} has a malformed id: ${p.id}`)
+  }
+  assert.equal(new Set(provisions.map(p => p.id)).size, provisions.length, 'ids must be unique')
+})
diff --git a/tests/keyboard.e2e.mjs b/tests/keyboard.e2e.mjs
new file mode 100644
index 0000000..6a0c997
--- /dev/null
+++ b/tests/keyboard.e2e.mjs
@@ -0,0 +1,240 @@
+/**
+ * Keyboard-only walkthrough of the built site.
+ *
+ * Not part of `npm test` — it needs a real browser. Run with `npm run test:e2e`.
+ * Skips cleanly when no Chrome is present rather than failing the build.
+ *
+ * Everything here is done without a pointer: if a step cannot be reached by
+ * Tab, Enter and Escape, it does not work for keyboard or screen-reader users.
+ */
+import { test, before, after, describe } from 'node:test'
+import assert from 'node:assert/strict'
+import http from 'node:http'
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { execSync } from 'node:child_process'
+import { normaliseBase, DEFAULT_BASE_PATH } from '../src/lib/paths.mjs'
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+const DIST = path.join(ROOT, 'dist')
+// Read the same default the build and link checker use. Hardcoding it here is
+// how this harness kept serving /OpenCodeLaw/ after the site moved to the apex
+// domain, and every asset 404'd inside the tests while the real site was fine.
+const BASE = normaliseBase(DEFAULT_BASE_PATH).replace(/\/$/, '')
+const PORT = 8137
+
+function findChrome () {
+  for (const c of ['google-chrome', 'google-chrome-stable', 'chromium', 'chromium-browser']) {
+    try { return execSync(`command -v ${c}`, { encoding: 'utf8' }).trim() } catch { /* next */ }
+  }
+  return process.env.CHROME_PATH || null
+}
+
+const CHROME = findChrome()
+const TYPES = { '.html': 'text/html', '.css': 'text/css', '.js': 'text/javascript', '.json': 'application/json', '.png': 'image/png', '.svg': 'image/svg+xml', '.woff': 'font/woff', '.ttf': 'font/ttf', '.pdf': 'application/pdf' }
+
+let server, browser, puppeteer
+
+describe('keyboard-only walkthrough', { skip: !CHROME || !fs.existsSync(DIST) ? 'no Chrome or no dist/' : false }, () => {
+  before(async () => {
+    server = http.createServer((req, res) => {
+      let p = decodeURIComponent(req.url.split('?')[0])
+      if (!p.startsWith(BASE)) { res.writeHead(404).end('not found'); return }
+      p = p.slice(BASE.length) || '/'
+      let file = path.join(DIST, p)
+      if (fs.existsSync(file) && fs.statSync(file).isDirectory()) file = path.join(file, 'index.html')
+      if (!fs.existsSync(file)) { res.writeHead(404).end('not found'); return }
+      res.writeHead(200, { 'content-type': TYPES[path.extname(file)] ?? 'application/octet-stream' })
+      fs.createReadStream(file).pipe(res)
+    })
+    await new Promise(r => server.listen(PORT, r))
+    puppeteer = (await import('puppeteer-core')).default
+    browser = await puppeteer.launch({
+      executablePath: CHROME, headless: 'new',
+      args: ['--no-sandbox', '--disable-gpu', '--disable-dev-shm-usage']
+    })
+  })
+
+  after(async () => {
+    await browser?.close()
+    await new Promise(r => server?.close(r))
+  })
+
+  const open = async (url = '/', width = 1440, height = 900) => {
+    const page = await browser.newPage()
+    await page.setViewport({ width, height })
+    await page.goto(`http://localhost:${PORT}${BASE}${url}`, { waitUntil: 'networkidle0' })
+    return page
+  }
+
+  const focused = page => page.evaluate(() => {
+    const a = document.activeElement
+    return a ? { id: a.id, tag: a.tagName, cls: a.className, text: (a.textContent || '').trim().slice(0, 40) } : null
+  })
+
+  // -------------------------------------------------------------------------
+
+  test('the first Tab reaches the skip link, and it moves focus to main', async () => {
+    const page = await open()
+    await page.keyboard.press('Tab')
+    const first = await focused(page)
+    assert.match(first.cls, /skip-link/, `first tab stop was ${first.tag}.${first.cls}`)
+
+    await page.keyboard.press('Enter')
+    const after = await focused(page)
+    assert.equal(after.id, 'main', 'Enter on the skip link must move focus to <main>')
+    await page.close()
+  })
+
+  test('the theme toggle is a real button and flips aria-pressed', async () => {
+    const page = await open()
+    const before = await page.$eval('#theme-toggle', el => ({ tag: el.tagName, pressed: el.getAttribute('aria-pressed') }))
+    assert.equal(before.tag, 'BUTTON', 'the theme control must be a button, not a styled checkbox')
+
+    await page.focus('#theme-toggle')
+    await page.keyboard.press('Enter')
+    const after = await page.$eval('#theme-toggle', el => el.getAttribute('aria-pressed'))
+    assert.notEqual(after, before.pressed, 'aria-pressed must change')
+
+    const theme = await page.$eval('html', el => el.getAttribute('data-theme'))
+    assert.ok(['light', 'dark'].includes(theme))
+    await page.close()
+  })
+
+  test('Ctrl+K opens search, focus lands in the input, Escape restores focus', async () => {
+    const page = await open()
+    await page.focus('#search-open')
+    await page.keyboard.down('Control'); await page.keyboard.press('KeyK'); await page.keyboard.up('Control')
+    await page.waitForFunction(() => !document.getElementById('search-dialog').hasAttribute('hidden'), { timeout: 3000 })
+
+    const inDialog = await focused(page)
+    assert.equal(inDialog.id, 'search-input', 'focus must move into the search input')
+
+    await page.keyboard.press('Escape')
+    await page.waitForFunction(() => document.getElementById('search-dialog').hasAttribute('hidden'), { timeout: 3000 })
+    const returned = await focused(page)
+    assert.equal(returned.id, 'search-open', 'Escape must return focus to the control that opened it')
+    await page.close()
+  })
+
+  test('search finds a provision and Enter navigates to its anchor', async () => {
+    const page = await open()
+    await page.focus('#search-open')
+    await page.keyboard.press('Enter')
+    await page.waitForFunction(() => !document.getElementById('search-dialog').hasAttribute('hidden'), { timeout: 3000 })
+
+    await page.keyboard.type('resignation')
+    await page.waitForFunction(() => document.querySelectorAll('#search-results li').length > 0, { timeout: 3000 })
+    const count = await page.$$eval('#search-results li', els => els.length)
+    assert.ok(count > 0, 'search returned nothing for a word that is in the document')
+
+    await page.keyboard.press('ArrowDown')
+    await page.keyboard.press('Enter')
+    await page.waitForFunction(() => location.hash.length > 1 || location.pathname.includes('/articles/'), { timeout: 3000 })
+    const url = page.url()
+    assert.ok(/#art-|\/articles\//.test(url), `Enter should navigate to a provision, went to ${url}`)
+    await page.close()
+  })
+
+  test('mobile: the contents sheet opens, traps focus, and returns it on Escape', async () => {
+    const page = await open('/', 375, 800)
+    const fabVisible = await page.$eval('#toc-fab', el => getComputedStyle(el).display !== 'none')
+    assert.ok(fabVisible, 'the contents button must be visible on a phone — issue #1')
+
+    await page.focus('#toc-fab')
+    await page.keyboard.press('Enter')
+    await page.waitForFunction(() => !document.getElementById('toc-sheet').hasAttribute('hidden'), { timeout: 3000 })
+    assert.equal(await page.$eval('#toc-fab', el => el.getAttribute('aria-expanded')), 'true')
+
+    const inside = await page.evaluate(() => document.getElementById('toc-sheet').contains(document.activeElement))
+    assert.ok(inside, 'focus must move into the sheet when it opens')
+
+    // Tab a full lap; focus must never escape the sheet.
+    for (let i = 0; i < 25; i++) {
+      await page.keyboard.press('Tab')
+      const still = await page.evaluate(() => document.getElementById('toc-sheet').contains(document.activeElement))
+      assert.ok(still, `focus escaped the sheet after ${i + 1} tabs`)
+    }
+
+    await page.keyboard.press('Escape')
+    await page.waitForFunction(() => document.getElementById('toc-sheet').hasAttribute('hidden'), { timeout: 3000 })
+    const back = await focused(page)
+    assert.equal(back.id, 'toc-fab', 'Escape must return focus to the button that opened the sheet')
+    await page.close()
+  })
+
+  test('copy-link buttons are reachable by keyboard and announce politely', async () => {
+    const page = await open()
+    const toast = await page.$eval('#toast', el => ({ role: el.getAttribute('role'), live: el.getAttribute('aria-live') }))
+    assert.equal(toast.live, 'polite', 'the toast must announce politely — issue #7')
+
+    const label = await page.$eval('button.copy', el => el.getAttribute('aria-label'))
+    assert.match(label ?? '', /copy link/i, 'each copy button needs a distinguishing accessible name')
+
+    await page.evaluate(() => document.querySelector('button.copy').focus())
+    await page.keyboard.press('Enter')
+    await page.waitForFunction(() => (document.getElementById('toast').textContent || '').trim().length > 0, { timeout: 3000 })
+    const text = await page.$eval('#toast', el => el.textContent.trim())
+    assert.ok(text.length > 0, 'activating copy must put a message in the live region')
+    await page.close()
+  })
+
+  test('landmarks and a single h1 on every page type', async () => {
+    for (const url of ['/', '/articles/units/', '/amendments/', '/archive/']) {
+      const page = await open(url)
+      const counts = await page.evaluate(() => ({
+        header: document.querySelectorAll('header').length,
+        nav: document.querySelectorAll('nav').length,
+        main: document.querySelectorAll('main').length,
+        footer: document.querySelectorAll('footer').length,
+        h1: document.querySelectorAll('h1').length,
+        articles: document.querySelectorAll('article.provision').length
+      }))
+      assert.equal(counts.main, 1, `${url}: exactly one <main>`)
+      assert.equal(counts.h1, 1, `${url}: exactly one <h1>, found ${counts.h1}`)
+      assert.ok(counts.header >= 1 && counts.footer >= 1, `${url}: missing header/footer landmarks`)
+      await page.close()
+    }
+  })
+
+  test('a cold load of a deep anchor lands on the cited provision', async () => {
+    const page = await browser.newPage()
+    await page.setViewport({ width: 1440, height: 900 })
+    await page.goto(`http://localhost:${PORT}${BASE}/articles/units/#art-11-s-2`, { waitUntil: 'networkidle0' })
+    await new Promise(r => setTimeout(r, 600))
+    const pos = await page.evaluate(() => {
+      const el = document.getElementById('art-11-s-2')
+      if (!el) return null
+      const r = el.getBoundingClientRect()
+      const header = document.getElementById('site-header')?.getBoundingClientRect().height ?? 0
+      return { top: r.top, header }
+    })
+    assert.ok(pos, 'the anchor must exist on the page')
+    assert.ok(pos.top >= 0, `provision scrolled above the viewport (top ${pos.top})`)
+    assert.ok(pos.top >= pos.header - 4, `provision is under the sticky header (top ${pos.top}, header ${pos.header})`)
+    await page.close()
+  })
+
+  test('a legacy #articleN link still resolves', async () => {
+    const page = await browser.newPage()
+    await page.goto(`http://localhost:${PORT}${BASE}/#article5`, { waitUntil: 'networkidle0' })
+    await page.waitForFunction(() => location.hash === '#art-5', { timeout: 4000 })
+    assert.equal(await page.evaluate(() => location.hash), '#art-5',
+      'an old shared link must be rewritten to the permanent anchor')
+    await page.close()
+  })
+
+  test('no console errors on any page type', async () => {
+    for (const url of ['/', '/articles/units/', '/amendments/', '/archive/', '/archive/2.0.0/', '/404.html']) {
+      const page = await browser.newPage()
+      const errors = []
+      page.on('console', m => { if (m.type() === 'error') errors.push(m.text()) })
+      page.on('pageerror', e => errors.push(e.message))
+      await page.goto(`http://localhost:${PORT}${BASE}${url}`, { waitUntil: 'networkidle0' })
+      await new Promise(r => setTimeout(r, 400))
+      assert.deepEqual(errors, [], `${url} logged: ${errors.join(' | ')}`)
+      await page.close()
+    }
+  })
+})
diff --git a/tests/provenance.test.mjs b/tests/provenance.test.mjs
new file mode 100644
index 0000000..a40c819
--- /dev/null
+++ b/tests/provenance.test.mjs
@@ -0,0 +1,155 @@
+/**
+ * Regressions for two bugs that each produced a wrong provenance verdict.
+ * Both were silent: the output looked plausible and was wrong.
+ */
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { loadActs } from '../src/acts-parse.mjs'
+import { verdictFor } from '../src/provenance.mjs'
+import { similarity } from '../src/text-compare.mjs'
+import yaml from 'js-yaml'
+import fs from 'node:fs'
+
+const live = () => yaml.load(fs.readFileSync(path.join(ROOT, 'constitution/current.yaml'), 'utf8'), { schema: yaml.CORE_SCHEMA })
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+const acts = loadActs(ROOT)
+const all = acts.flatMap(a => a.provisions)
+
+test('a clause beginning after a PDF page break is not lost', () => {
+  // Article 7 clause (6) begins immediately after a form feed. \f is not a JS
+  // line terminator, so `^[ \t]*\(` never matched and the clause vanished
+  // from the analysis without any error.
+  const art7 = all.find(p => p.target === 'art-7')
+  assert.ok(art7, 'Act 1 must amend art-7')
+  assert.equal(art7.clauses, '4,6')
+  assert.ok(!art7.text.includes('\f'), 'form feeds must be normalised away')
+  const found = [...art7.text.matchAll(/^[ \t]*\((\d+)\)/gm)].map(m => Number(m[1]))
+  assert.deepEqual(found, [4, 6], 'both clauses the heading names must be recoverable')
+})
+
+test('every clause-scope heading yields exactly the clauses it names', () => {
+  for (const p of all.filter(x => x.scope === 'clause')) {
+    const expected = p.clauses.split(',').map(Number).sort((a, b) => a - b)
+    const found = [...p.text.matchAll(/^[ \t]*\((\d+)\)/gm)].map(m => Number(m[1])).sort((a, b) => a - b)
+    assert.deepEqual(found, expected, `${p.target}: heading names ${expected} but body yields ${found}`)
+  }
+})
+
+test('an Act that rewrites a provision heavily does not make it DIVERGENT', () => {
+  // The provision is word for word its own pre-Act text. That is NOT-APPLIED.
+  // Scoring only against the Act reports DIVERGENT, which would send an
+  // untouched provision to the board as an unauthorised edit.
+  const prior = 'Any person who is willing to serve the society and who is willing to abide by ' +
+    'the rules and regulations of the NGO to serve the STM for the lifetime and manage every thing in the STM.'
+  const current = prior
+  const enacted = 'Board Member: Any person who is willing to serve society and abide by the rules ' +
+    'and regulations of the NGO to work in STM for lifetime.'
+
+  const r = verdictFor(current, enacted, prior, { contained: true })
+  assert.equal(r.verdict, 'NOT-APPLIED',
+    `expected NOT-APPLIED for text identical to its pre-Act form, got ${r.verdict}`)
+  assert.equal(r.drift, 1, 'drift must be 1.0 when current and prior are identical')
+  assert.ok(r.simEnacted < 0.94, 'sanity: the Act text really is a heavy rewrite')
+})
+
+test('text matching neither the Act nor the pre-Act text stays DIVERGENT', () => {
+  const r = verdictFor('Wholly unrelated wording nobody enacted.', 'The Act says this.', 'The prior text said that.', { contained: false })
+  assert.equal(r.verdict, 'DIVERGENT')
+})
+
+test('an insertion not yet made is NOT-APPLIED', () => {
+  const r = verdictFor(null, 'New article the Act inserts.', null, { contained: false })
+  assert.equal(r.verdict, 'NOT-APPLIED')
+})
+
+test('the three Acts yield the expected operative scope', () => {
+  const byTarget = Object.fromEntries(all.map(p => [p.target + (p.clauses ? `(${p.clauses})` : ''), p]))
+  // Clause-scope only where the heading names clauses; full substitution otherwise.
+  assert.equal(byTarget['art-6(1,2,3,4,5)'].scope, 'clause')
+  assert.equal(byTarget['art-7(4,6)'].scope, 'clause')
+  assert.equal(byTarget['art-16(3)'].scope, 'clause')
+  assert.equal(byTarget['art-17(1)'].scope, 'clause')
+  assert.equal(byTarget['art-9'].scope, 'article')
+  assert.equal(byTarget['art-10'].scope, 'article')
+  // Insertions
+  for (const t of ['art-18', 'art-20', 'art-21']) assert.equal(byTarget[t].operation, 'insert')
+  assert.equal(all.length, 19, 'three Acts enact 19 operative provisions')
+})
+
+test('a Statement of Objects is never the authority for an operation', async () => {
+  const { statementOfObjectsLine } = await import('../src/validate.mjs')
+  const fs = await import('node:fs')
+
+  // Each Act's SOR boundary is found, and every operative provision the parser
+  // extracted sits above it.
+  for (const act of acts) {
+    const text = fs.readFileSync(path.join(ROOT, act.file), 'utf8').replace(/\f/g, '')
+    const sor = statementOfObjectsLine(text)
+    assert.ok(sor && sor > 1, `${act.file}: Statement of Objects not located`)
+    for (const p of act.provisions) {
+      assert.ok(p.source_line < sor,
+        `${act.file}: ${p.target} is sourced at line ${p.source_line}, at or after the ` +
+        `Statement of Objects (line ${sor}) — that text is explanatory, not enacting`)
+    }
+  }
+})
+
+test('Act 2 sets 2/3rd in operative text and 3/4th only in the Statement of Objects', async () => {
+  const fs = await import('node:fs')
+  const act2 = acts.find(a => a.file.includes('second'))
+  const text = fs.readFileSync(path.join(ROOT, act2.file), 'utf8').replace(/\f/g, '')
+  const { statementOfObjectsLine } = await import('../src/validate.mjs')
+  const sor = statementOfObjectsLine(text)
+  const lines = text.split('\n')
+
+  const twoThirds = lines.findIndex(l => /2\/3rd/.test(l)) + 1
+  const threeQuarters = lines.findIndex(l => /3\/4th/.test(l)) + 1
+
+  assert.ok(twoThirds > 0 && twoThirds < sor, '2/3rd must appear in the operative text')
+  assert.ok(threeQuarters > sor, '3/4th must appear only in the Statement of Objects')
+
+  // The operative figure is the one the register may cite.
+  const art16 = act2.provisions.find(p => p.target === 'art-16')
+  assert.ok(/2\/3rd/.test(art16.text), 'the extracted art-16 provision carries the operative figure')
+  assert.ok(!/3\/4th/.test(art16.text), 'the extracted provision must not carry the explanatory figure')
+})
+
+test('no extracted segment swallows the next operative item', () => {
+  // The real slice-boundary failure mode: a segment running past its own end
+  // and absorbing the heading — or the leading number — of the next item. A
+  // single stray token drags a 100% match down to ~98% and reads in
+  // PROVENANCE.md as unexplained drift.
+  //
+  // Guarding on "ends with a bare number" would misfire: Act 2's Article 15
+  // legitimately ends "...terminated based on article 7 and 18".
+  const HEADING = /^\s*\d+\s*\.\s*(Amendment\s+(to|of)|Insertion\s+of\s+new)\s/mi
+  for (const act of acts) {
+    for (const p of act.provisions) {
+      assert.ok(!HEADING.test(p.text),
+        `${act.file} ${p.target}: segment contains a following operative heading`)
+      // Nor a dangling "N." on its own line, which is that heading half-eaten.
+      const lines = p.text.split('\n').map(l => l.trim()).filter(Boolean)
+      const last = lines[lines.length - 1] ?? ''
+      assert.ok(!/^\d+\s*\.?$/.test(last),
+        `${act.file} ${p.target}: segment ends with a dangling item marker "${last}"`)
+    }
+  }
+})
+
+test('clause text compares like-for-like against the constitution', () => {
+  // An Act states a clause heading inline ("(2) Establishment ...") where the
+  // constitution keeps it in `title`. Comparing the clause against `content`
+  // alone drops one token in seventy-four and reports 98.6% for text that is
+  // word-for-word identical. Provenance must compare title+content.
+  const art11 = live().articles.find(a => a.number === 11)
+  const s2 = art11.sections.find(s => s.number === 2)
+  const p = acts[0].provisions.find(x => x.target === 'art-11')
+  const marks = [...p.text.matchAll(/^[ \t]*\((\d+)\)/gm)]
+  const clause2 = p.text.slice(marks[1].index).trim()
+
+  assert.equal(Math.round(similarity(clause2, `${s2.title}\n${s2.content}`) * 1000) / 1000, 1,
+    'Act 1 clause (2) is word-for-word art-11-s-2 once the title is included')
+})
diff --git a/tests/reusability.test.mjs b/tests/reusability.test.mjs
new file mode 100644
index 0000000..b4c1fdf
--- /dev/null
+++ b/tests/reusability.test.mjs
@@ -0,0 +1,125 @@
+/**
+ * The engine must work for an organization that is not this one.
+ *
+ * Engine (src/, schema/) and content (constitution/, acts/) are separate; a
+ * fork should replace the content and deploy without touching the code.
+ */
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { execFileSync } from 'node:child_process'
+import yaml from 'js-yaml'
+import { validateDocument } from '../src/validate.mjs'
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+const STARTER = path.join(ROOT, 'examples/starter/constitution.yaml')
+
+test('the starter is structurally valid, and refuses to ship with its placeholder contact', () => {
+  const doc = yaml.load(fs.readFileSync(STARTER, 'utf8'), { schema: yaml.CORE_SCHEMA })
+  const rep = validateDocument(doc, 'examples/starter/constitution.yaml')
+  const codes = rep.errors.map(e => e.code)
+
+  // Everything structural must pass: ids, numbering, the schema itself.
+  assert.deepEqual(codes.filter(c => c !== 'placeholder-url'), [],
+    rep.errors.map(e => `${e.code}: ${e.message}`).join('\n'))
+
+  // And the one thing that must NOT pass: the example contact address. Copying
+  // the template and deploying without replacing it fails the build, which is
+  // the entire point — the previous constitution shipped two example.com URLs
+  // to production and nothing objected.
+  assert.deepEqual(codes, ['placeholder-url'],
+    'the starter must fail validation until its placeholder contact is replaced')
+})
+
+test('the starter demonstrates a reserved article closing a numbering gap', () => {
+  const doc = yaml.load(fs.readFileSync(STARTER, 'utf8'), { schema: yaml.CORE_SCHEMA })
+  const reserved = doc.articles.filter(a => a.status === 'reserved')
+  assert.ok(reserved.length >= 1, 'the template should show how a gap is recorded, not closed by renumbering')
+  for (const a of reserved) {
+    assert.ok(a.note, 'a reserved article must say why')
+    assert.equal(a.content, undefined, 'a reserved article carries no text')
+  }
+})
+
+test('the starter builds standalone, with no repo content and no reconciliation banner', () => {
+  const out = fs.mkdtempSync(path.join(os.tmpdir(), 'ocl-starter-'))
+  try {
+    execFileSync(process.execPath, [path.join(ROOT, 'src/build.mjs')], {
+      cwd: ROOT,
+      env: {
+        ...process.env,
+        CONSTITUTION_FILE: 'examples/starter/constitution.yaml',
+        VERSIONS_DIR: 'examples/starter/versions',   // absent on purpose
+        REGISTER_FILE: 'examples/starter/register.yaml', // absent on purpose
+        OUT_DIR: path.relative(ROOT, out),
+        BASE_PATH: '/',
+        SITE_ORIGIN: 'https://example.org'
+      },
+      stdio: 'pipe'
+    })
+
+    const index = path.join(out, 'index.html')
+    assert.ok(fs.existsSync(index), 'the starter must produce an index page')
+    const html = fs.readFileSync(index, 'utf8')
+
+    // Content came from the starter, not from this organization's constitution.
+    assert.ok(html.includes('Example Society'), 'starter content missing')
+    assert.ok(!html.includes('Service to Mankind'), 'repo content leaked into a starter build')
+
+    // No reconciliation_state means no banner: it must not be hardcoded.
+    assert.ok(!html.includes('mid-reconciliation'),
+      'the reconciliation banner must come from reconciliation_state, not the template')
+
+    // A reserved article still gets its number and heading.
+    assert.ok(html.includes('id="art-4"'), 'the reserved article should still hold its number')
+
+    // At BASE_PATH=/ the links are root-relative, not stuck under /OpenCodeLaw/.
+    assert.ok(!html.includes('href="/OpenCodeLaw/'), 'base path was not honoured')
+    assert.ok(/href="\/styles\/tokens\.css"/.test(html), 'assets should resolve at the configured base path')
+
+    assert.ok(fs.existsSync(path.join(out, '404.html')))
+    assert.ok(fs.existsSync(path.join(out, 'sitemap.xml')))
+    assert.ok(fs.existsSync(path.join(out, '.nojekyll')))
+  } finally {
+    fs.rmSync(out, { recursive: true, force: true })
+  }
+})
+
+test('SPEC.md regenerates identically', () => {
+  const spec = path.join(ROOT, 'schema/SPEC.md')
+  const before = fs.readFileSync(spec, 'utf8')
+  execFileSync(process.execPath, [path.join(ROOT, 'src/gen-spec.mjs')], { cwd: ROOT, stdio: 'pipe' })
+  const once = fs.readFileSync(spec, 'utf8')
+  execFileSync(process.execPath, [path.join(ROOT, 'src/gen-spec.mjs')], { cwd: ROOT, stdio: 'pipe' })
+  const twice = fs.readFileSync(spec, 'utf8')
+
+  assert.equal(once, twice, 'generating SPEC.md twice must produce identical output')
+  assert.equal(before, once,
+    'SPEC.md on disk is stale — run `npm run spec` after changing the schema')
+  assert.ok(once.includes('Generated by'), 'SPEC.md must say it is generated')
+})
+
+test('the CLI exposes validate, build and spec', () => {
+  const help = execFileSync(process.execPath, [path.join(ROOT, 'src/cli.mjs'), '--help'], { encoding: 'utf8' })
+  for (const cmd of ['validate', 'build', 'spec']) {
+    assert.ok(help.includes(cmd), `${cmd} missing from CLI help`)
+  }
+  const ok = execFileSync(process.execPath,
+    [path.join(ROOT, 'src/cli.mjs'), 'validate', 'examples/starter/constitution.yaml'],
+    { cwd: ROOT, encoding: 'utf8' })
+  assert.match(ok, /valid constitution/, 'CLI should validate the starter')
+})
+
+test('the engine holds no content and the content holds no engine', () => {
+  const engineFiles = fs.readdirSync(path.join(ROOT, 'src'), { recursive: true })
+    .filter(f => typeof f === 'string' && f.endsWith('.mjs'))
+  for (const f of engineFiles) {
+    const src = fs.readFileSync(path.join(ROOT, 'src', f), 'utf8')
+    // Provision text, article titles and organization names belong in YAML.
+    assert.ok(!/Service to Mankind Welfare Association/.test(src.replace(/^.*servicetomankind\.github\.io.*$/gm, '')),
+      `src/${f} hardcodes the organization name; it belongs in constitution/current.yaml`)
+  }
+})
diff --git a/tests/text-compare.test.mjs b/tests/text-compare.test.mjs
new file mode 100644
index 0000000..d0fa95a
--- /dev/null
+++ b/tests/text-compare.test.mjs
@@ -0,0 +1,106 @@
+/**
+ * Guards the provenance normaliser.
+ *
+ * The regression these tests exist for: a normaliser that strips punctuation
+ * before tags turns `<br>` into the word `br`, injects it mid-string, and
+ * reports a provision that IS amended as NOT-APPLIED. Acting on that verdict
+ * would re-apply an amendment already in force.
+ */
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { normalise, stripTags, similarity, classify, MATCH_THRESHOLD } from '../src/text-compare.mjs'
+
+// The real pair. Left: constitution/current.yaml art-9, inline <br> and all.
+// Right: Act 1 of 2024, "Amendment to Article 9" (acts/text/…act-2024.txt:55-74).
+const V2_ARTICLE_9 = `1. The board members are responsible for proper functioning of the NGO by guiding IBM. <br>
+2. The board members are responsible for all activities of the NGO, but they are not held responsible for any activity undertaken by any member without informing the authorized person. <br>
+3. Any new establishments and any modifications shall be done with the final document approval of the board. <br>
+4. Board holds the ultimate powers over the STM and its final decisions <br>
+5. The board consists of the following members: <br>
+    1. President
+    2. Vice President
+    3. General Secretary
+    4. Treasurer
+    5. Joint Secretary
+    6. Executive Members
+6. All the board members should abide by the rules and regulations of the NGO and work according to the constitution of the NGO and by-laws of the NGO. <br>`
+
+const ACT1_ARTICLE_9 = `(1) The board members are responsible for proper functioning of the NGO by guiding
+IBM.
+(2) The board members are responsible for all activities of the NGO, but they are not
+held responsible for any activity undertaken by any member without informing the
+authorized person.
+(3) Any new establishments and any modifications shall be done with the final
+document approval of the board.
+(4) Board holds the ultimate powers over the STM and its final decisions
+(5) The board consists of the following members:
+            1. President
+            2. Vice President
+            3. General Secretary
+            4. Treasurer
+            5. Joint Secretary
+            6. Executive Members
+(6) All the board members should abide by the rules and regulations of the NGO and
+work according to the constitution of the NGO and by-laws of the NGO.`
+
+// ---------------------------------------------------------------------------
+
+test('tags are stripped to a space, never to nothing', () => {
+  assert.equal(stripTags('a<br>b').trim(), 'a b')
+  assert.ok(!normalise('word<br>word').includes('wordword'),
+    'removing a tag must not weld two words together')
+})
+
+test('no HTML tag survives normalisation as a word', () => {
+  for (const tag of ['<br>', '<br/>', '<br />', '<b>', '</b>', '<p>', '<span class="x">']) {
+    const out = normalise(`alpha ${tag} beta`)
+    assert.equal(out, 'alpha beta', `tag ${tag} leaked into the normalised form as: "${out}"`)
+  }
+})
+
+test('THE FIXTURE: a <br>-laden provision matching its Act classifies ALREADY-APPLIED', () => {
+  const { verdict, simEnacted } = classify(V2_ARTICLE_9, ACT1_ARTICLE_9, null)
+  assert.equal(verdict, 'ALREADY-APPLIED',
+    `Article 9 carries Act 1 text; got ${verdict} at similarity ${simEnacted.toFixed(4)}. ` +
+    'If this fails, the normaliser is wrong — do not trust any provenance verdict.')
+  assert.ok(simEnacted > 0.99, `expected near-identity, got ${simEnacted.toFixed(4)}`)
+})
+
+test('the naive normaliser this guards against would have failed', () => {
+  // Punctuation first, tags never: exactly the mistake that produced a false NOT-APPLIED.
+  const naive = s => String(s).toLowerCase().replace(/[^a-z0-9]+/g, ' ').trim().replace(/\s+/g, ' ')
+  assert.ok(naive(V2_ARTICLE_9).includes(' br '),
+    'sanity: the naive form should contain the stray token this test exists to prevent')
+  assert.ok(!normalise(V2_ARTICLE_9).includes(' br '),
+    'the real normaliser must not contain the stray token')
+})
+
+test('enumerator style does not affect equivalence', () => {
+  assert.equal(similarity('(1) Alpha beta. (2) Gamma delta.', '1. Alpha beta.\n2. Gamma delta.'), 1)
+  assert.equal(similarity('- (a) Alpha beta', '(a) Alpha beta'), 1)
+})
+
+test('typographic variants fold together', () => {
+  assert.equal(normalise('“Alumni” refers to the member'), normalise('"Alumni" refers to the member'))
+  assert.equal(normalise("members’ duties"), normalise("members' duties"))
+})
+
+test('genuinely different text stays below the match threshold', () => {
+  const a = 'Any person who donates at least INR 30 shall be called STM DONOR.'
+  const b = 'The duration of the internship program is two years.'
+  assert.ok(similarity(a, b) < MATCH_THRESHOLD)
+  assert.equal(classify(a, b, a).verdict, 'NOT-APPLIED')
+})
+
+test('text matching neither source is DIVERGENT and is never auto-resolved', () => {
+  const { verdict } = classify(
+    'Something nobody enacted at all, written by hand.',
+    'The Act prescribes this text.',
+    'The prior text said this instead.'
+  )
+  assert.equal(verdict, 'DIVERGENT')
+})
+
+test('an insertion that has not happened yet is NOT-APPLIED, not DIVERGENT', () => {
+  assert.equal(classify('', 'New article text prescribed by the Act.', null).verdict, 'NOT-APPLIED')
+})