# Changelog

## 2026-11 · Live member count and compact phone header

- **Member count** (`server.js` → `GET /api/member-count`, `member-count.js`): reads “All Members (21036)” from `landsurveyorsunited.com/surveyors` on the server (LSU sends no CORS headers). Kept 6 hours in memory; the last good value is saved in `search_meta` (`member_count`), so if LSU is down or reworded the route answers with that, and failing that 20,700. A failed read is retried after 30 minutes. Returns `{ count, display, source, updated }`.
- The five visible spots (hero line, “at a glance” stat, FAQ answer, footer, “Join … land surveyors” in the sign-in box) are tagged `data-member-count` and show the exact figure (e.g. 21,036). Their HTML text, 21,000+, stays as the fallback. The meta description and structured data keep fixed text (21,000+) for search engines; update them by hand.
- `SITE_CONFIG.memberCountEndpoint`; `tools/build-lsu.py` derives it from `--feeds-endpoint` (same server.js).
- **Phone header** (`mobile.js`, `mobile.css`; ≤760 px and short landscape screens): Sign in, Quick access, Translate and the m | survey ft switch move to the top of the ☰ menu (and back on wider screens); “Community home” is hidden (the menu’s “Enter LSU” goes to the same place). The header is now the brand row plus one row of community tabs with Join LSU, about 112 px instead of about a quarter of the screen. The brand name stays on one line below 560 px. The tab row fades more strongly at the edge where more tabs are waiting.
- **Action bar:** “Find My Place / Enter LSU” stays hidden until the hero (and its search box) has scrolled away.
- **Hero headline:** `clamp(1.8rem, 8vw, 2.6rem)` on phones, three lines from 360 px up. The earlier 760/390/340 px headline sizes never applied (`entrance.css` loads later and overrode them); the rule now lives in `mobile.css`, which loads last.
- Rollback: remove the `nav-extras` and action-bar blocks in `mobile.js` and the matching blocks in `mobile.css`; drop `member-count.js` and its script tag.

## 2026-11 · Fieldbook simulation (From fieldbook to digital twin)

- **Work this point yourself** (`fieldbook-sim.js`, `fieldbook.css`): five steps under the example point record — Recover the monument, Occupy (RTK GNSS, static GNSS or total station, each with its own uncertainty and a to-scale 95% circle), Check (independent check shot against the combined 95% tolerance; “tripod knocked” fails it), Strip context (removes datum and epoch; the numbers no longer pin a place) and Review (the reviewer returns the record until every step holds up). Each step rewrites the record rows; “Show finished record” restores the original. Lengths follow the m | US ft switch. All values stay fictional.
- **Field view:** a frame above the diagram shows an illustration for whatever was just touched. Diagram nodes also show their own illustration and highlight the record rows they contribute to (`model:node` event from `interactions.js`). A signed-off point appears in the diagram centre. On phones the field view sits between the record and the steps.
- **Images (SEO):** 12 SVG illustrations in `assets/field/` with descriptive file names, `<title>`/`<desc>`, and in the page as real `<img>` elements with alt text, width/height and visible captions (not injected by script). Regenerate with `python3 -I tools/make-field-art.py`.
- **Hosting:** `tools/build-lsu.py` copies them to `deploy/united/assets/field/` and points the page at `https://labs.landsurveyorsunited.com/united/assets/field/…` (Neocities). `tools/build-single.py` no longer inlines these images; it links the same hosted files (`--image-host`).
- **Build fix:** `tools/build-single.py`’s leftover-URL guard treated the runtime `url("${…}")` in `atlas.js` as a relative URL and stopped every build; it now skips template expressions.
- Rollback: remove the `fb-sim` block and the `model-side` / `field-view` wrapper in `#citiverse`, the `fieldbook.css` and `fieldbook-sim.js` tags and the `model:node` dispatch in `interactions.js`.

## 2026-11 · Converter page

- New `converter.html` (`converter.js`, `converter.css`): length and area conversions for old records — chains, rods, links, furlongs, US survey miles, Texas varas (33 1/3 in), US survey and international feet, yards, metres, kilometres; acres, square chains, roods, square rods, sections, square varas, square feet, square metres, hectares. Tap a result to convert from it. Historical units use the US survey foot.
- Linked from the converter on the home page. Added to `tools/build-single.py` and `tools/build-lsu.py` (LSU address `/livingland-converter`, change with `--converter`).

## 2026-11 · Mobile pass

- **Breakpoints:** `responsive.css` now has one block per breakpoint (1200 · 980 · 900 · 760 · 520 · 390 · 340, plus component exceptions 560 and 430), merged from three overlapping 760 px passes. Computed styles were compared before and after at 13 widths (320–1440 px): no visible change, and nothing changed above 760 px.
- **WebGL on phones:** on low-power devices every scene releases its GPU context once it is well off screen and restores it on the way back (`parkWhenFar` in `scene-kit.js`, used by the hero, Field Lab and every `mountScene`). Mobile browsers keep only a few live contexts and used to drop scenes silently. Data Saver keeps all scenes on their static designs. The programme network backdrop is skipped on low-power phones (its Connections button stays). The hero waits for an idle moment before fetching three.js.
- **Opening:** plays at double speed on phones (4.5 s), and a tap or click anywhere skips it (`intro.js`).
- **Bottom sheets:** on phones, dialogs (interest, programme, roadmap, quick access, participation) slide up from the bottom with a grab handle and close on a swipe down. A draft that asks to confirm still asks. The account dialog stays full screen. (`mobile.js`, `mobile.css`)
- **Chrome:** the top bar tucks away while scrolling down and returns on scroll up. The bottom action bar hides while a dialog or the keyboard is open.
- **Scrollers:** the subnav links, layer chips, scene tabs, programme shelf and roadmap table fade only on the edge that still has more content.
- **Touch:** vision field-note cards pin on tap (hover previews are mouse-only). Field Lab landmarks are 44 px on narrow phones. Tap highlight is tinted. Search fields show a "search" key.
- **Readability:** small uppercase labels below 0.7 rem are raised to 0.7 rem (11 px) on phones. No text got smaller.
- **Images:** the opening and Find-my-place logo is now `assets/land-surveyors-united-logo.webp` (21 KB, was a 66 KB PNG, which is kept for other uses). The footer logo is lazy-loaded.
- **Other pages:** `participation.html` and `review.html` load `mobile.css` and `mobile.js`.
- Rollback: remove the `mobile.css` and `mobile.js` tags from the three pages and delete both files. Revert `scene-kit.js`, `hero-3d.js`, `fieldlab-3d.js`, `programmes-3d.js`, `globe-3d.js`, `vision-3d.js` and `intro.js`. Restore `responsive.css` from the checkpoint.

## 2026-11 · Living Land updates

- `updates.xml` (upload to `labs.landsurveyorsunited.com/united/updates.xml`, next to `feeds.xml` and `search.xml`): one `<update>` per post with date, title, status (the roadmap list), optional programme letter, link, evidence and id, and a short plain-text description. Instructions are inside the file.
- `server.js` `/api/updates` (JSON) and `/api/updates.rss` (RSS 2.0): re-reads the file at most every 5 minutes, checks each update on its own and lists broken ones under `skipped` with the reason, sorts newest first, holds back future dates until their day (UTC), refuses `Completed` without an evidence link, and keeps the last good copy (stored in `search_meta`) if an edit breaks the file. Built-in first update until the file has been read once.
- Hero: the "In development" line shows the newest update (`updates-hero.js`, `updates-feed.js`); the static sentence in `index.html` stays for no-JS visitors, search engines and when the relay can't be reached. First update and fallback sentence rewritten to name A to Zenith and the SDG Center in Geneva.
- `updates.html` (LSU address `/livingland-updates`, `tools/build-lsu.py --updates`): latest update as a large card, then a timeline grouped by year, status and programme filters, a link per update (`#<date>-<id>`), RSS link.
- `search.xml` and the built-in search sources list the updates feed (chip "Living Land"). `tools/build-lsu.py` now also copies `search.xml` and `updates.xml` to `deploy/united/`.
- Rollback: delete the `updates*` files and the `updates-hero.js` script line, restore the hero sentence, remove the updates block in `server.js`.


## 2026-11 · Find my place: logo and topographic card

- The LSU logo sits in the centre of the ring behind "There is more than one way to belong here." (`.finder:after` in `entrance.css`; hidden below 900 px where the heading would cross it).
- The "Your path" card has an illustrative contour map behind it (`assets/topo-cover.svg`: 2 m contours, index contours every 10 m with labels, spot heights, grid ticks, north arrow) under a paper wash that keeps the text readable. Rebuild with `tools/make-topo-cover.py`.


## 2026-11 · Globe behind "Your crew is already here."

- `globe-3d.js` + `globe.css`: a pale Earth (paper-coloured sphere, ink land dots, 15° graticule, amber rim, soft day/night side) on a 23.4° axis, turning once every 150 s. Copper pins mark LSU hub countries and US states; a note says they are hubs, not members.
- Typing in "Find your local hub", hovering or focusing a hub result or flag shortcut, or a "Browse by region" link turns the globe to that place for 7 s with a pulsing ring and label, then it carries on turning.
- Uses the page's shared Three.js loader and `mountScene`; renders only while on screen; "Pause globe" button; reduced motion shows a still globe and snaps to places; a still SVG globe without WebGL; a 270 px globe above the heading on phones; hidden in print.
- `globe-data.js` is generated from Natural Earth (public domain) by `tools/make-globe-data.py`: 4,760 land dots and coordinates for every hub in `hubs.js`. Re-run it when hubs are added.
- Rollback: delete `globe-3d.js`, `globe.css`, `globe-data.js` and their two lines in `index.html`.


## 2026-11 · Search window and hero survey realism

- Search: the hero "Search LSU" box, `/` or Ctrl/Cmd-K opens a search window (`search.js`, `search.css`) with suggested and recent searches, the latest posts with thumbnails, live results with highlighted matches, filter chips with counts, "did you mean", keyboard navigation, matches from this site, and a "Search all of LSU" hand-off on every search. Feature flag `searchModal` in `config.js`; off, or with the relay unreachable, the old form still works.
- `server.js` `/api/search`: indexes the feeds, sitemaps and pages listed in `search.xml` into `search_docs` (no visitor data), refreshes at most every 30 minutes, keeps older posts after they leave a feed (up to 20,000), ranks by title/text match, source weight and recency. The endpoint is derived from `feedsEndpoint`, so the LSU build needs no new option.
- `search.xml` (upload to `labs.landsurveyorsunited.com/united/search.xml`): sources, filter chips, weights, suggested searches, pinned results and blocked words, with instructions inside. Default sources: LSU forum, articles and videos (Atom feeds on landsurveyorsunited.com), blog, photos and latest activity (FeedBurner). Hub forums: add each hub forum's feed with `chip="Hubs"`.
- Hero (`hero-3d.js`): a round prism in an orange canister on a yoke with a target plate, rod graduations and a level vial, turned to face the instrument; the EDM shows a pulse going out and the reflection returning, with the reading only after it returns; the HUD shows backsight orientation, HZ, zenith angle, slope and horizontal distance and height difference computed from HI 1.562 m and HT 2.000 m; GNSS goes from autonomous to RTK float to fixed with realistic precisions, 30 averaged epochs and residuals against CP-01; a proper GNSS antenna dome. Fixed angle formatting that could show 60″.


## 2026-11 · Road Ahead scene

- `roadmap-scene.js` + `roadmap-scene.css`: an illustrative 2D canvas road behind the roadmap heading. One survey monument per phase; crews (total station and prism, GNSS rover, chain crew, mentor and apprentice, record keeper, community meeting) work along it. Scrolling past the heading travels 2026 → 2050+. Hovering a milestone lights its monument and speeds up that phase's crews; the "Where do I fit?" filter highlights matching crews; the road past 2030 stays in mist until "See the full roadmap" is opened. Crews in phases not yet reached are drawn in outline.
- Own "Pause road" button; reduced motion shows a still frame; animates only while on screen; 30 fps cap on low-power devices; a 230 px strip on phones; hidden in print.
- Rollback: delete the two files and their `<link>` / `<script>` lines in `index.html`.

## 2026-11 · Participation page and route studio

- "How participation works" moved from `index.html#participation` to its own page, `participation.html` (LSU address `/participate`, set by `tools/build-lsu.py --participation`). The home sub-navigation and every `./#participation` / `./?route=…#participation` link now point at it; `?route=<name>` still opens a form directly.
- Each route card opens a route studio window (`route-studio.js`, `route-studio-data.js`, `route-studio.css`): a clickable five-step journey, a "before you start" check, an interactive "Try it" panel per route, the full question list from `participation-schema.js`, and who sees what. "Prepare a draft" opens the existing form, prefilled with anything tried. `#route-<name>` opens a studio directly; ← / → move between routes.
- `participation.js` now exports `service` and `HANDLERS` for the studio. The form dialogs on the home page (roadmap, mentor prompt) are unchanged.
- Rollback: restore the section into `index.html` from this entry's revision and delete `participation.html` and the three `route-studio` files.

## 2026-11 · Signed-in members

- `member.js`: on landsurveyorsunited.com the page requests `/main/profile` with the visitor's own LSU session. A redirect to their profile (`/surveyors/<name>`) means signed in; a redirect to `/` means signed out. No credentials are read or stored. Only the resolved profile URL is kept in localStorage (`lsuMember`), so the next visit hides the sign-in buttons before the check finishes.
- Signed in: every `data-auth-key` / `data-account-trigger` element, the membership note, the "How do I join" FAQ and the footer sign-in/up items (`.guest-only`) are hidden. "My profile" appears in the sub-navigation, hero, Today on LSU, Find my place and footer (`.member-only`, `COMMUNITY_LINKS.myProfile`).
- Off landsurveyorsunited.com the check can't run, so everyone sees the guest view. Add `?member` to the URL to preview the member view.
- `tools/build-single.py` now inlines other classic scripts (`intro.js`) and drops local image preloads, which were stopping the build.
- Split deploy (`tools/build-lsu.py` → `deploy/`): pages for LSU at `/livingland`, `/institutional`, `/briefs.html`; every other file for `labs.landsurveyorsunited.com/united/`. The pledge badge requests its logo with CORS, and the Impact Atlas page snapshot now inlines stylesheets from another host too.
- Feed relay reads `feeds.xml` (OPML) from labs: one tab per OPML folder, RSS and Atom, merged newest first, falling back to the three built-in LSU feeds. The response adds `groups` and keeps the `blog`/`photos`/`forum` keys for older pages. `feeds.js` builds its tabs from `groups`.
- `tools/build-lsu.py`: briefs page at `/briefs` (Ning page names can't contain `.html`); the feeds endpoint defaults to the published relay; `feeds.xml` is copied to `deploy/united/`.
- Rollback: remove `member.js` and its `<script>` lines, then rebuild `dist/`.

## 2026-11 · Phase 4: completion and verification pass

### 1. Search
- Checked every LSU search destination with real queries against a nonsense query: site search, forum (225 results for “total station”, 0 for nonsense), photos (369/0), videos (209/0) and events (35 for “conference”) filter correctly. **Articles ignores `?q=`, so the Articles option was removed.**
- Scope note corrected: “All of LSU searches public discussions, hubs, blog posts, photos and videos… results open on LSU in this tab.”
- Same-tab GET navigation (no popups). Empty input shows a message and doesn’t navigate. Query and type are remembered for the browser session (new sessionStorage key `lsuSearchLast`). If navigation is blocked (e.g. inside an embedding frame), a message with a direct results link appears.

### 2. Coordinates and units
- Point record now separates coordinate reference (NAD83(2011) / UTM zone 17N), datum realization and reference epoch, grid coordinates, stored vs displayed units (live label), height with vertical datum, height type and geoid model, and separate horizontal and vertical uncertainty with their basis. The ambiguous “UTM zone 17N grid, metres” label next to converted values is gone.
- Converted values are labelled “US ft” (US survey feet) instead of a bare “ft”. Every conversion is computed from the stored metres, so repeated switching can’t drift. Historical units (the 1898 plan, the converter) are unchanged.

### 3. Community panels
- Each panel has loading, populated, empty and failed states (`data-state`), a direct source link, a source label per item, and “Published …” dates; the status line says when the feeds were last retrieved, separately from publication dates. Empty and failed states show different messages, then curated links labelled “fixed links, not live and not updated automatically”.

### 4–5. One complete participation workflow: “Preserve one lesson”
- New route `lesson` (title, lesson and where it applies, optional jurisdiction and instrument/workflow context, credit preference, publication preference, rights, optional private contact; no uploads; warns against client records and sensitive coordinates). The earlier record route is now titled “Preserve a historical record or workflow” (same route id and drafts). “Preserve this lesson” on the mentor prompt opens the new route.
- `server.js`: submission opens route by route (`ENABLED_ROUTES = ['lesson']`) and only when every item is configured; `/status` lists exactly what is missing. Acceptance never publishes: a separate publish step uses reviewer-approved text kept apart from the submitted text, is allowed only when the contributor permitted publication, and credits per their choice. Published lessons can be corrected or withdrawn with a public reason; every version is kept. Public lessons carry their own random IDs (`LSN-…`), never submission references, contact details or reviewer notes. Internal reviewer notes are recorded separately.
- **Test mode:** `/api/participation-test/*` mirrors every route on separate `ll_test_*` tables, reviewers only, never public; owner-only reset.
- Review workspace: test-mode switch and banner; detail view separates submitted text and private information, internal notes, decision and note to the contributor, and approved public text with version history; publish, correct and withdraw controls.
- Client: submit appears only for routes the server opened, with the privacy-notice link; a no-contact warning; the acknowledgment explains how to check status and promises no response time; “Who handles this?” in every form and in the participation section; a “Published lessons” panel.
- `PRIVACY-NOTICE-DRAFT.md`: a draft for LSU to approve. Not linked, not in force.

### 6. Accountability
- Six roles (initiative steward, operational contact, programme coordinator, professional reviewer, community liaison, relationship approver), each tagged as managing, reviewing, representing or approving, all **Unfilled**. A name is published only with a confirming document and the holder’s recorded consent; contact is role-based.

### 7–8. Institutional copy and one-page brief
- Overview leads with the problem, purpose, what exists today, the first practical programme and the specific request, under one status line: “An independent Land Surveyors United initiative in development. No United Nations affiliation or endorsement is claimed.” The full disclosure appears once on the page (relationship register) and in every brief’s footer.
- Wording fixes: “None” → “None recorded”; the service is “Built. Verified in development with automated checks and one authorised test-mode run… Not enabled” instead of “Built and tested”; SDG alignment explicitly “not recognition by the UN”.
- New default brief “One-page overview” (briefs.html?brief=onepage). Printed with the page’s own margins it is one page on both A4 and US Letter (body 10.5 pt, footer 8.5 pt, nothing clipped). Fixed print issues that affected all briefs: the site-wide section and footer padding, and the roadmap’s landscape `@page` rule. The full brief, pilot, evidence, progress and request briefs remain.

### Verification (run in this sandbox)
- Server logic, real SQLite: 79/79 checks.
- Authorised end-to-end run against the real preview backend in **test mode**: draft → submitted (duplicate-safe) → under review → clarification requested → reply → accepted → nothing published → published (initials credit) → corrected (v2) → withdrawn (v3); public view contained no contact, reference or internal note; live tables stayed at 0 rows. The test record remains in `ll_test_*` (owner can delete it in the review workspace).
- Browser suites: Phase 1 39/39, Phase 2 41/41, Phase 3 43/43, Phase 4 52/52; built `dist/` pages 21/21; homepage keyboard, phone and contrast checks pass.

### Still required before “Preserve one lesson” is operational
In `server.js`: `PARTICIPATION_ENABLED = true`, `PRIVACY_NOTICE_URL` (approved and published), `RETENTION_DAYS`, `REVIEWER_CONFIRMED = true` (after naming the reviewer); in `config.js`: `participation.endpoint: "/api/participation"`. Plus the identity decision from Phase 2 (websim accounts vs LSU accounts) and hosting the API where the page runs.

### Rollback
- Search: restore `index.html` search form and `entrance.js` search block (or set `siteSearch: false`).
- Units: revert `units.js` (two lines) and the point-record markup.
- Feeds: revert `feeds.js` (or `feedStatus: false`).
- Lesson route and publication: remove the `lesson` route from `participation-schema.js`, run `node tools/sync-server-schema.mjs`, revert `server.js`, `participation.js`, `review.*`. Drafts saved under `livingLandParticipationV2` with route `lesson` stay in visitors’ browsers. `ll_publications` and `ll_test_*` tables can stay empty.
- Institutional copy and briefs: revert `institutional-data.js`, `institutional-render.js`, `institutional.css`, `briefs.js`, then `node tools/build-institutional.mjs`.
- Or restore the websim checkpoint from before this pass. Rebuild `dist/` afterwards.

## 2026-11 · Phase 3: institutional readiness, alignment register, pilot monitoring

Goal: let surveyors, communities, universities, funders and international institutions see what Living Land does,
what is operational, who is accountable, how evidence is reviewed, what a pilot would measure, which published
frameworks are relevant, and what collaboration is requested, without manufacturing any appearance of endorsement.

### Added
- **`institutional.html`** (separate from the community home page): overview, relationship to LSU, operational status,
  founding programmes, pilot methodology, monitoring and evaluation, pilot readiness review, governance, evidence
  practices, community participation, framework alignment register, relationship register, progress, collaboration
  requests, feedback and corrections, sources/revisions/contact. Pre-rendered from the records by
  `tools/build-institutional.mjs`, so it reads fully without JavaScript; `institutional.js` re-renders with
  reviewer-recorded public facts when the review service is enabled. Print styles open every disclosure.
- **`briefs.html`**: five printable briefs (initiative overview, pilot concept, evidence-method summary, programme
  progress, specific collaboration request REQ-01…05) generated by the same renderer from the same records. Each shows
  author, version and date, status, confirmed facts, proposals and assumptions, sources, contact route, and states it
  is not an agreement.
- **Shared, versioned records:** `institutional-data.js` (living-land/institutional@1), `pilot-framework.js`
  (living-land/pilot-framework@1), `alignment-register.js` (living-land/alignment@1, generated), and the rendering in
  `institutional-render.js`. `programme-ideas.js` and `pilot-model.js` now hold the 26 programme ideas and the
  six-phase pilot model that `app.js` previously defined inline, so the home page, institutional page and briefs read
  one source.
- **Alignment register:** `tools/build-alignment.mjs` combines the 17 Impact Atlas entries with official target and
  indicator text from the UN Statistics Division SDG API (retrieved 2026-11-05; 56 of 56 targets verified). Each entry
  records activity, evidence, decision supported, targets with official text and source, explanation, collaborators,
  limitations, adverse effects, and review status. Claim levels: general goal relevance / specific target relevance /
  potential input to an indicator’s data requirements (5 targets: 1.4→1.4.2, 5.a→5.a.1, 6.6→6.6.1, 11.3→11.3.1,
  15.3→15.3.1) / production of official indicator data (never claimed). Every entry: “Not reviewed. No review date.”
- **Impact Atlas:** a collapsible “Alignment register” block for the selected goal (`alignment-atlas.js`), linking to
  the full register.
- **Pilot monitoring framework:** baseline, 4 outputs and 4 outcomes in separate tables, each with definition,
  method, responsible party (“role being established”), review schedule, evidence source, limitations, community
  success criteria and follow-up. States: Not yet measured / Baseline available / Measurement in progress / Reviewed
  finding / Inconclusive. Everything is “Not yet measured”; missing data is never zero.
- **Pilot readiness review:** 11 items with documented / pending / not applicable / needs revision, evidence links and
  reviewer notes. No score or percentage. A reviewer must record an explicit decision; the server refuses “ready”
  until every item is documented or not applicable.
- **Governance:** eight areas; every role shows “Role being established”. Confirmed text only where it is a fact
  (no funding recorded; how decisions are recorded). No advisory board.
- **Relationship register:** four relationship types defined and kept distinct; public listing only for verified
  relationships with a supporting document and approved wording; exploratory records private by default; logo use
  needs its own documented permission. Currently: no relationships beyond educational alignment.
- **Progress view:** seven defined metrics with reporting period; values come only from the review service (counts, no
  contributor details). While it is disabled every value reads “Not collected”. Two metrics (evidence gaps resolved,
  findings returned) are “Not collected” until a data source exists.
- **Feedback and corrections:** new participation route with four kinds (factual error, interpretation, rights or
  permissions review, participation concern), using the Phase 2 review workflow. No response time is promised.
  Deep link: `./?route=feedback#participation`.
- **Server (`server.js`, still disabled):** append-only `ll_records` store for relationship, governance, readiness,
  measure, alignment and pilot-decision records with per-kind validation and visibility rules; public `/records` and
  `/progress`; admin `/admin/record`, `/admin/records`, `/admin/pilot-decision`. 16 new automated checks.
- **Review workspace:** “Record institutional facts” forms for each record kind, plus the pilot readiness decision.
- **Build:** `tools/build-single.py` now builds `index.html`, `institutional.html` and `briefs.html` into `dist/`
  (links between them stay relative) and copies `CHANGELOG.md`.
- **Flag:** `institutionalArea` hides the home-page links and the Atlas register block.

### Changed
- `app.js` imports `programIdeas` and `pilotPhases` from the new data modules (content unchanged).
- Home page: links to the institutional area and briefs in the Institutional divider and the partnership section only;
  a Feedback and corrections card in “How participation works”. The first screen and task shortcuts are unchanged.

### Evidence for public claims
| Claim | Evidence |
|---|---|
| LSU active since March 2007 | landsurveyorsunited.com/about (“Since March of 2007…”), checked 2026-11-05 |
| Official SDG target and indicator wording | UN Statistics Division SDG API, retrieved 2026-11-05 by `tools/build-alignment.mjs` |
| Programmes A–C “Scoping”, D–Z “Idea” | The site’s own programme text (“in development”, “design stage”, “pilot not selected”, “concept”) |
| Milestones for A–C | The site’s roadmap entries heritage-establish, profession-establish, land-establish |
| Submission service built but disabled | `server.js` `PARTICIPATION_ENABLED = false`; `config.js` `participation.endpoint: ""` |
| No funding, partners, endorsement | Long-standing statements on the site; nothing recorded in any register |

### Awaiting verification or configuration
- Qualified review of each alignment-register entry (none reviewed).
- Named holders and confirming documents for every governance role.
- Enabling the review service (see Phase 2 “Enabling submissions”) before any metric, readiness item, relationship or
  decision can be recorded.
- Hosting `institutional.html` and `briefs.html` on landsurveyorsunited.com alongside `index.html`.
- Re-running `node tools/build-alignment.mjs` whenever the UN updates target or indicator text.

### Rollback
- Per feature: set `institutionalArea: false` (home-page links and Atlas block disappear; the pages stay reachable by URL).
- Full: restore the pre-Phase-3 websim checkpoint, or delete `institutional.*`, `briefs.*`, `institutional-*.js`,
  `pilot-framework.js`, `alignment-*.js`, `tools/build-alignment.mjs`, `tools/build-institutional.mjs`, and revert
  `index.html`, `config.js`, `participation.js`, `participation-schema.js`, `participation.css`, `server.js`,
  `review.*`, `tools/build-single.py`. `programme-ideas.js` and `pilot-model.js` can stay (they hold the same data
  `app.js` used before); to fully revert, also revert `app.js`. The `ll_records` table can stay; it is empty.

## 2026-11 · Phase 2: participation, programme status, evidence records

Goal: let a visitor tell apart (1) exploring an idea, (2) preparing a private draft, (3) submitting interest,
(4) having a contribution reviewed and (5) joining an approved activity, without inventing any of the later stages.

### Current state
- **Local drafting: on.** Every route works as a private draft with save-on-device (opt-in) and JSON/text download.
- **Submission service: built, disabled.** `server.js` has `PARTICIPATION_ENABLED = false` and `config.js` has
  `participation.endpoint: ""`. While either is off, nothing is sent, no "Submit" button appears, and every form says
  "Local draft only". See "Enabling submissions" below.
- **File uploads: not offered.** The platform's file storage only produces public URLs, which is unsafe for private
  originals. Forms collect metadata and explain how a transfer would be arranged; there is no upload control.
- **Review workspace: built, closed.** `review.html` shows nothing until the service is enabled and the visitor is an authorised reviewer.

### Added (flags in `config.js → SITE_CONFIG.features`)
| Flag | What it adds |
|---|---|
| `participationWorkflows` | One reusable form system (`participation.js`, `participation-schema.js`) for seven routes: mentorship, preserve a lesson or record, pilot-place nomination, field participation, research collaboration, institutional collaboration, funding or in-kind support. Every form shows its mode track (Local draft only → Submission available → Submitted → Under review → More information requested → Accepted / Declined / Withdrawn). A "How participation works" section (`#participation`) shows the five stages, marks stages 3–5 closed while there is no service, lists the routes, explains recognition levels, and lists this browser's submissions. A "Preserve this lesson" button on the mentor prompt copies the reflection into the lesson route. |
| `structuredProgrammes` | Programme records v2 (`programmes-data.js`, `programmes.js`): purpose, practical problem, status, basis for the status, coordinator (or "coordinator needed"), skills, time, funding and compensation, next milestone, contribution requested, deliverable, last reviewed. Statuses: Idea → Scoping → Recruiting → Ready → Active → Reviewing → Completed / Paused. A, B and C are "Scoping" (the page called them in development / design stage / pilot not selected); D–Z are "Idea". All 26 show "coordinator needed". Milestones and deliverables for A–C are taken from the existing roadmap entries (heritage-establish, profession-establish, land-establish). |
| `evidenceRecords` | Evidence schema v1 (`evidence-schema.js`, `evidence.js`): identifier and version, type, source, custodian, observation and publication dates, original units, CRS, horizontal and vertical references, method, uncertainty and its basis, observer and reviewer roles, review status, limitations, related records, rights, access, consent reference, correction history, plus separate observation / interpretation / decision / outcome layers. Each Field Lab passport now has a "Full evidence record" disclosure and a public-safe JSON export (roles only; withheld when access isn't public). Explicit "unknown", "not supplied" and "not applicable" states; no combined trust score. |

### Changed
- `app.js`: three one-line hooks (`openForm`, `openProgramIdea`, `showEvidence`) hand off to the new modules when their flags are on; programme ideas are exposed read-only as `window.livingLand.programIdeas`. With the flags off the original behaviour runs unchanged.
- `pledge.js` and the pledge form: the badge says "Self-described role", adds "Personal pledge only. Not a licence, certification, accreditation, review or United Nations status", and the licensure option reads "Licensed surveyor (self-described)".
- `server.js`: participation API added (feeds relay unchanged). Its tables were created empty in the project database when the preview first loaded the new file; nothing is written while the adapter is off.
- `review.html`, `review.js`, `review.css`: reviewer workspace (list and filter, detail with private fields, assign reviewer, status with reasons, note to submitter, mentorship match proposals, JSON/CSV export with an explicit, logged "include private fields" choice, programme status recording, owner-managed reviewer list, full event history).
- `tools/sync-server-schema.mjs`: copies the form field whitelist into `server.js` (which must stay self-contained). Run it after editing routes.

### Storage and compatibility
- New key `livingLandParticipationV2` (`{ schema: "living-land/participation@2", items: [...] }`). Drafts are saved only after the visitor ticks "Remember drafts on this device"; submission receipts (reference and status, no answers) are kept automatically so a submission can't be lost.
- `livingLandInterestDraftsV1` is read and listed as "earlier draft (previous form)"; "Copy into this form" creates a new v2 draft and leaves the v1 data untouched. Nothing ever rewrites or deletes v1 except the old form's own "Clear saved drafts".
- `livingLandLesson`, `livingLandLessonOptIn`, `lsuUnits`, all downloads, URLs and anchors are unchanged. New anchor: `#participation`. LSU authentication is untouched.

### Server rules (verified by 39 automated checks against a real SQLite database)
- Disabled → `/status` says not enabled; everything else returns 503.
- Writes need a signed-in platform identity (trusted `x-websim-*` headers); no new account system. Every row carries `user_id`.
- Field whitelist per route, length limits, option checking, 48 KB body limit, 10 submissions per user per day, acknowledgement required.
- Private fields (contact, precise pilot location) are stored separately, never in public responses or default exports. A precise pilot location is discarded unless the contributor ticked "share with reviewers".
- Duplicate protection: one submission per (user, draft key); a retry returns the original reference.
- "Submitted" is returned only after the row is read back from the database.
- Status flow enforced; reasons required for More information requested, Accepted and Declined; every change, view and export is logged.
- Mentorship matches need a rationale; contact details are revealed only after both people agree.
- Programme status: evidence required for every status except Idea; a named coordinator for Recruiting and later; submissions never change a programme status.
- Admins: the project owner, plus reviewers the owner adds.

### Enabling submissions (configuration still needed)
1. **Decide the identity question.** The adapter trusts the platform account of whoever hosts the page (websim today). LSU's Ning accounts can't be checked from here. Either accept websim sign-in for submitters and reviewers, or deploy an equivalent service on LSU's own infrastructure with LSU authentication.
2. **Where it runs.** `server.js` only runs on websim. On landsurveyorsunited.com, either point `participation.endpoint` at the websim project's published `/api/participation` (cross-origin calls need a CORS rule and the visitor signed in there), or port the routes to LSU-hosted infrastructure.
3. **Privacy notice and retention.** Publish who reads submissions, how long they are kept and how to ask for deletion, then link it from the forms.
4. **Reviewers.** Name the responsible reviewers and add them in the review workspace.
5. **Switch on:** set `PARTICIPATION_ENABLED = true` in `server.js` and `participation.endpoint: "/api/participation"` in `config.js`, then rebuild `dist/`.
6. **File transfers** remain off until private storage exists (not the public blob store).

### Rollback
- Per feature: set `participationWorkflows`, `structuredProgrammes` or `evidenceRecords` to `false`. With all three off, the original interest dialog, programme dialog, passports and pledge text run as before (the pledge disclaimer and the "self-described" option label are not flagged).
- Full: restore the websim checkpoint from before Phase 2, or revert `index.html`, `config.js`, `app.js`, `pledge.js`, `server.js` and delete `participation*.{js,css}`, `programmes*.js`, `evidence*.js`, `review.*`, `tools/sync-server-schema.mjs`. The empty `ll_*` tables can stay; they are unused.
- Visitors' saved v2 drafts stay in their browsers under `livingLandParticipationV2`; v1 drafts were never modified.

## 2026-11 · Community entrance phase

Goal: make the page work as the front door to Land Surveyors United (LSU) while keeping every Living Land capability.
All destinations were opened and checked against landsurveyorsunited.com in Nov 2026 (status and page title, so LSU's
"Page Not Found" page, which also returns 200, is not mistaken for a working link).

### Added (each behind a flag in `config.js → SITE_CONFIG.features`)

| Flag | What it adds | Where |
|---|---|---|
| `siteSearch` | "Search LSU" in the hero. Uses LSU's own search (`/main/search/search?q=`); the scope menu switches to the Forum, Articles, Photos, Videos or Events section search, all of which accept `?q=`. Hubs, Jobs and Members ignore `?q=`, so they are not offered. | `index.html` hero, `entrance.js` |
| `taskShortcuts` | "Community now" section with six task cards (ask, work/hire, learn, local hub, equipment, tools), each with one primary link and two more. Includes the membership note. | `#community-now` |
| `needFinder` | "What brings you here today?" as the first step of Find my place, with eight needs. Each gives one primary action, up to two resources and an optional Living Land route. Roles (multi-select) and the contribution path are unchanged. | `#find-place`, `entrance.js` |
| `hubFinder` | Searchable country / US-state hub selector with region links. Countries without a hub show their regional page, labelled "No dedicated hub yet". The flag shelves moved into a "Browse all hubs by flag" disclosure. | `#hub-finder` |
| `sectionGroups` | Five-group navigation (Community now · Learn and explore · Living Land · Participate · Institutional information) and group dividers with jump links. | header nav, `.group-divider` |
| `programmeLibrary` | Founding programmes A–C highlighted; all 26 ideas kept in an expandable library (same cards, filters and dialogs). | `#programmes` |
| `quickAccess` | "Quick access" dialog: a filterable list of verified practical LSU pages (labelled as a fixed list, not a search). Opens from the sub-navigation, the membership note, or `#quick-access`. | `entrance.js` |
| `feedStatus` | Community feeds: newest first, 4–5 items per tab, "last refreshed" time from the relay, and labelled curated links when a feed is empty or unreachable. | `feeds.js` |

### Changed (not flagged)
- **Section order** regrouped into the five groups. Every section keeps its `id`, so all old anchors (`#community`, `#vision`, `#find-place`, `#field-lab`, `#citiverse`, `#measurement-time`, `#programmes`, `#sdgs`, `#responsibility`, `#pilot`, `#roadmap`, `#partners`, `#faq`, `#mentor-answer`, `#ground-truth`) still work. The "00 / … 10 /" numbers were removed from section labels because the order changed. New anchors: `#community-now`, `#learn`, `#living-land`, `#participate`, `#institutional`, `#hub-finder`, `#get-involved`, `#faq-membership`, `#programme-library`, `#quick-access`.
- **Hero:** separate Join LSU, Sign in and Enter the community actions; a Living Land "in development" line; the headline text is unchanged but slightly smaller so the actions fit on the first screen.
- **Sub-navigation:** "Sign In / Join" split into "Sign in" and "Join LSU". Authentication still happens only on LSU's own pages.
- **State hubs:** all 50 now link to the real state hubs (`/hubs/texaslandsurveyors` and so on). The old `/hubs/usa-surveyors/{state}` links all opened the same USA company forum. The "State hubs" heading now opens LSU's US chapters list.
- **Country hubs:** added Bolivia, Dominican Republic, Ecuador, Indonesia, Liberia, Philippines and Vietnam (hubs found in LSU's directory). Haiti, Iran, Norway, Senegal and Venezuela appear only in the finder, as labelled regional fallbacks.
- **Units:** the switch reads "US survey ft" ("survey ft" on phones) with an explanation popover (US survey foot vs international foot, 2022 retirement, original units in historical records).
- **Fictional point record:** horizontal and vertical references are now separate (NAD83(2011) epoch 2010.00, UTM zone 17N; NAVD 88 via GEOID18 with a height), "Accuracy" became "Uncertainty" with its confidence level and reference, plus a note explaining what the values mean.
- **Membership:** the FAQ "Is it free? What does joining include?" (anchor `#faq-membership`) now separates free membership from LSU's optional paid Futurist membership, using LSU's own Futurists page. No prices are quoted (LSU's listed price had expired).
- **Honesty labels:** LSU's contact page needs sign-in; links to it now say so. The Institutional divider states that Living Land has no confirmed partners, funding, accreditation or endorsement, including from the United Nations.
- **Structured data:** FAQ entries regenerated from the visible FAQ; Organization `foundingDate` 2007-03 (from LSU's About page).
- **Contrast (WCAG AA):** copper buttons and eyebrows on light backgrounds darkened slightly; several low-contrast text colours fixed (timeline years, tables, programme status, Impact Atlas Mode 2/3 secondary buttons, which were dark on dark). All overrides are at the end of `entrance.css`.

### New files
- `entrance.js` (flags, search, need routing, hub finder, quick access, programme library hooks)
- `entrance.css` (all new styles and contrast fixes)
- `lsu-destinations.js` (the verified LSU destinations, search scopes, needs and quick-access groups)

### Storage, exports and integrations
No new localStorage keys, exports or network calls. Existing keys (`lsuUnits`, `livingLandLesson`, `livingLandLessonOptIn`, the interest-draft key) and all downloads are unchanged. Authentication, membership terms, payments and LSU data were not touched.

### Rollback
1. **Per feature:** set its flag to `false` in `config.js` (`SITE_CONFIG.features`). With all eight off, the page shows the previous navigation, Find my place intro, open programme shelf, flag shelves and feed behaviour.
2. **Everything:** restore the websim checkpoint saved before this phase, or revert these files: `index.html`, `config.js`, `feeds.js`, `hubs.js`, `interactions.js`, then delete `entrance.js`, `entrance.css`, `lsu-destinations.js`. Section order, unit labels, point-record text, FAQ wording and contrast fixes are not flagged; they revert only with the files.
3. Rebuild `dist/` with `python3 -I tools/build-single.py` after any rollback.
