Skip to content

Commit 2ab6080

Browse files
docs: 1.1.0 — the 1.6.29 sync round, changelog and development log
CHANGELOG gets the llms-2plot-dev 1.1.0 entry, which is also the traceability record the specs ask for: "consumed SYNC-1.6.10-1.6.16, SYNC-1.6.17-1.6.21 and SYNC-1.6.22-1.6.29 at template 5589318". Specs are deliberately NOT vendored — a copied spec wakes the kit test's path pins against a tree that legitimately lacks the template's newest files. APP_VERSION and index.html's softwareVersion move together; the pin in tests/test_config.py exists because two places hold the version and they drift the moment one is bumped alone. README's Python badge and venv line said 3.11, which stopped being true with this round. DEVELOPMENT-LOG section 13 records what the detects found that a hand-written prompt would not have: render.yaml still describing boilerplate.2plot.dev, the Node layer still in the image (a template release BELOW the spec range), and the fact that nothing in this suite had ever rendered the configured auth branch — conftest pins every CLERK_* variable empty before any import, which is correct and is also why register()'s production half, including the pk_live satellite auto-enable, was certified by nothing. Two pins now render it with a fake config, recording the global registrations rather than executing them so the session-scoped app fixture is left as the other tests found it. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
1 parent 294fe39 commit 2ab6080

4 files changed

Lines changed: 165 additions & 2 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 85 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,91 @@ All notable changes to this project will be documented in this file.
55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
66
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
77

8+
## [llms-2plot-dev 1.1.0] - 2026-08-27
9+
10+
**Kit adoption — consumed `SYNC-1.6.10-1.6.16`, `SYNC-1.6.17-1.6.21` and
11+
`SYNC-1.6.22-1.6.29` at dash-documentation-boilerplate 1.6.29 (`5589318`).**
12+
This host was a live kit-lineage site that had never been on the fleet
13+
roster; it joins with this release. Per-item dispositions are in the sync
14+
report; the deliberate differences are now recorded in `DIVERGENCES.md`.
15+
16+
### Added
17+
18+
- **The `.claude/` development kit** — `CLAUDE.md` (this site's own guide
19+
above the network's behavioral contract and verification traps, both
20+
ported verbatim), `settings.json` pointed at THIS host, and the three
21+
shipped skills (`wire-verify`, `sync-template`, `report`) byte-verbatim.
22+
`.gitignore` moves from a blanket `.claude/` ignore to the template's
23+
ALLOW-LIST form, which is what keeps credentials under `.claude/`
24+
structurally uncommittable, and gains the session-document block.
25+
- **`DIVERGENCES.md`** — six recorded divergences with reasons, plus the
26+
machine-readable `byte-owned` fence (empty: this fork makes no byte-level
27+
claim on any `sync-verbatim` path, and drift is never fenced).
28+
- **`tests/test_claude_kit.py`, `tests/test_auth_demos.py`** — byte-verbatim
29+
kit cargo. **`tests/test_python_version.py`** — the one-fleet-Python
30+
agreement pins.
31+
- **`python` on `/healthz`**, all three backends, plus the battery's
32+
`python_matches_declared` check: the serving interpreter is now on the
33+
wire, so a stale image can be contradicted from outside.
34+
- **The configured-auth branch is certified.** Two pins render
35+
`lib.auth.register()` with a FAKE non-empty Clerk config — the branch a
36+
zero-secret suite had never executed, including the `pk_live`
37+
satellite-mode auto-enable that can only exist in production.
38+
- **CI asserts Docker's own health verdict** (`docker inspect
39+
.State.Health.Status`), failing on `none`: the external curl proves the
40+
app answers, never the HEALTHCHECK instruction itself.
41+
42+
### Changed
43+
44+
- **One fleet Python: 3.14**, in every encoding at once — `Dockerfile`
45+
(`python:3.14-slim`, a MINOR tag: the old `3.11.8` patch pin could never
46+
receive a 3.11.x security release), the CI matrix main, the lint and
47+
pip-audit jobs, `cd.yml`'s verify job, and `render.yaml`'s
48+
`PYTHON_VERSION` (full `X.Y.Z`, as Render's native runtime requires). The
49+
window legs are 3.13 and 3.12.
50+
- **`Dockerfile` honors `$PORT`** — shell-form `CMD` with the default at the
51+
point of use (`${PORT:-8550}`), and the HEALTHCHECK probes the same
52+
variable. Exec-form `CMD` never expands env, so the old form hardcoded the
53+
port whatever the platform asked for.
54+
- **`render.yaml` names THIS host.** Every identity field still said
55+
`boilerplate` — service name, domain, `APP_BASE_URL`, `SATELLITE_APP_KEY`,
56+
`AD_APP_ID` — inherited at fork time and never corrected, while production
57+
served `llms.2plot.dev` with `app: "llms"`. `POLICY_STORE_FILE` is now
58+
declared on the mounted disk beside the other two stores.
59+
- **CD is sized for the worst build**: the build-match wait runs 100 × 15s
60+
under a 30-minute job timeout (a floor bump busts the pip cache by design,
61+
so this pipeline's most important deploy is also its slowest), a hookless
62+
deploy emits `::warning` rather than a quiet notice, and the verify job
63+
now stands down on a `skipped` deploy as well as a `cancelled` one.
64+
- **`.github/dependabot.yml`** — the 1.6.24 rewrite: the pip ecosystem is
65+
removed entirely. On range requirements dependabot can only propose FLOOR
66+
RAISES, so the old allow-list group structurally produced the very PR
67+
class it existed to suppress. Floors move through sync specs, every
68+
encoding at once. Security updates ride GitHub's separate channel.
69+
- **`scripts/smoke_live.py`** is the template's current file: the auth POST
70+
now carries the same SSL context as `fetch` (without it every POST died in
71+
the macOS handshake and read as missing auth wiring), and `wake()`
72+
tolerates a legacy `fetch` stub. A source pin in
73+
`tests/test_auth_wiring.py` holds the SSL half — no wired test can, they
74+
all monkeypatch `post`.
75+
- **The gate card promises only what ships** — "and the AI assistant" is
76+
gone from the demo-card copy; nothing here wires one.
77+
- **`lib/auth_demos.py` points at a demo this site can render.** The
78+
inherited `/examples/visualization` entry named a page and a module that
79+
exist on no fork; every gate card rendered demo-less and silent since fork
80+
time. This site's hero is `/showcase/robots-sandbox`.
81+
82+
### Removed
83+
84+
- **The vestigial Node layer** (template issue #12, CVE-2026-1615, removed
85+
upstream in 1.6.9 and carried here with this Dockerfile sync).
86+
`package.json` / `package-lock.json` were dash-mantine-components'
87+
component-build toolchain, inherited through the fork lineage and used by
88+
nothing in this repo — no webpack config, no `src/ts`, no CI job, no
89+
served asset — while the image apt-installed nodejs+npm and `npm
90+
install`ed a known-vulnerable `jsonpath@1.1.1` into every production
91+
build.
92+
893
## [llms-2plot-dev 1.0.0] - 2026-08-22
994

1095
**This repository forked here.** Everything below this entry is the history of

‎DEVELOPMENT-LOG.md‎

Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -569,3 +569,81 @@ for this pass, the **full suite** passes on it: 600 passed / 4 skipped.
569569

570570
**603 passed / 1 skipped (flask), 600 / 4 (fastapi), 600 / 4 (quart)**,
571571
flake8 clean.
572+
573+
---
574+
575+
## 13. Kit adoption — template 1.6.29, spec-alone (2026-08-27)
576+
577+
The first sync this repo consumed **from the specs rather than from a
578+
hand-written prompt**: `sync/README.md`, then `SYNC-1.6.10-1.6.16`,
579+
`SYNC-1.6.17-1.6.21` and `SYNC-1.6.22-1.6.29` at
580+
dash-documentation-boilerplate `5589318` (1.6.29). Every item's **detect**
581+
ran before anything was applied; four items were already-present from the
582+
two hand-carried syncs in sections 11 and 12, and the rest landed here.
583+
584+
This host had been live on the kit lineage since 2026-08-23 and had never
585+
been on the fleet roster — the F4 battery found it with no row. Joining the
586+
roster is what this section records.
587+
588+
### What the detects found that a prompt would not have
589+
590+
Three things, none of which any earlier session had a reason to look at:
591+
592+
1. **`render.yaml` still described `boilerplate.2plot.dev`** — service name,
593+
domain, `APP_BASE_URL`, `SATELLITE_APP_KEY`, `AD_APP_ID`, all inherited at
594+
fork time and never corrected, while production has served
595+
`llms.2plot.dev` with `app: "llms"` since the cutover. The blueprint was a
596+
document that lied; nothing read it, which is exactly why it survived
597+
three rounds of verification. Spec item 5 sent me into the file for one
598+
line (`PYTHON_VERSION`) and the rest was sitting there.
599+
600+
2. **The Node layer was still in the production image.** `package.json` was
601+
dash-mantine-components' component-build toolchain — webpack, ts-loader,
602+
react-docgen, `jsonpath@1.1.1` — inherited through the fork lineage and
603+
used by nothing here: no webpack config, no `src/ts`, no CI job, no served
604+
asset. The Dockerfile apt-installed nodejs+npm and `npm install`ed it into
605+
every build anyway. The template removed this at **1.6.9**, one release
606+
BELOW the spec range, with the changelog note that docs-fleet forks pick
607+
it up "with the next Dockerfile sync". No spec item carries it, so a
608+
spec-alone consumption would have skipped it — the diff against the
609+
template's Dockerfile is what surfaced it. Filed as a spec correction.
610+
611+
3. **Nothing had ever rendered the configured auth branch.** `conftest.py`
612+
pins every `CLERK_*` variable empty before anything imports `run.py` —
613+
correct, and the reason every fail-closed assertion in `test_access.py`
614+
means something — but the consequence is that `lib.auth.register()`'s
615+
configured half, including the `pk_live` satellite-mode auto-enable that
616+
can only ever exist in production, was certified by nothing. That is spec
617+
item 7 of the last range, whose own template adoption is still `open`.
618+
619+
### The write guard, and how the kit landed anyway
620+
621+
`.claude/settings.json` and `.claude/skills/` are permission-classed in this
622+
seat — `mkdir .claude/skills` answers *Operation not permitted*. The guard is
623+
correct and was not routed around: both were staged in the scratchpad,
624+
verified byte-identical to the template's, and copied by the owner with a
625+
one-line command. `.claude/CLAUDE.md` is writable and was written directly —
626+
this site's own guide above the network's behavioral contract and
627+
verification traps, which port verbatim.
628+
629+
### The fence
630+
631+
`DIVERGENCES.md` is new, with six recorded divergences and an **empty**
632+
`byte-owned` fence. The prose was audited against every `sync-verbatim` path
633+
in the three specs before the fence was filled: this fork makes no
634+
byte-level claim on any of them. Where this fork's `.github/dependabot.yml`
635+
differed from the template's it was **behind** 1.6.24, not chosen — that is
636+
drift, and drift is never fenced, because the fan-out is how it gets fixed.
637+
638+
### One fleet Python
639+
640+
3.14, in every encoding at once: `Dockerfile` (a MINOR tag — the old
641+
`3.11.8` patch pin could never receive a 3.11.x security release), the CI
642+
matrix main with 3.13/3.12 as the window legs, the lint and pip-audit jobs,
643+
`cd.yml`'s verify job, and `render.yaml`'s `PYTHON_VERSION` (full `X.Y.Z`,
644+
which Render's native runtime requires). `/healthz` now carries `python`, so
645+
the wire can contradict a stale image — and `scripts/network_smoke.py`'s
646+
`python_matches_declared` is the teeth. Measured both lanes locally before
647+
pushing: `flask: python='3.12.3' geo.resolved='FR (via cf-ipcountry)'` and
648+
the same for `fastapi` (3.12.3 is this laptop's venv; 3.14 is what the image
649+
and CI serve).

‎lib/constants.py‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,7 @@
6363
PAGE_TITLE_PREFIX = f"{SITE_SHORT_NAME} | "
6464

6565
PRIMARY_COLOR = "teal"
66-
APP_VERSION = "1.0.0"
66+
APP_VERSION = "1.1.0"
6767

6868
# ---------------------------------------------------------------------------
6969
# The network's internal-traffic contract

‎templates/index.html‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -341,7 +341,7 @@
341341
"name": "Pip Install Python LLC",
342342
"url": "https://2plot.ai"
343343
},
344-
"softwareVersion": "1.0.0",
344+
"softwareVersion": "1.1.0",
345345
"programmingLanguage": "Python"
346346
}
347347
</script>

0 commit comments

Comments
 (0)