@a2f0/skyline 0.2.39 → 0.2.43

package/README.md

@@ -41,7 +41,7 @@ covers installing, asset copying, mounting, imports, and releases.
 ## Development
 
 ```sh
-sh scripts/git/install-hooks.sh   # once per clone
+bun run hooks:install             # once per clone
 bun run check                     # typecheck, unit and browser suites; needs Google Chrome
 bun run deploy                    # publish to Cloudflare; needs Node.js 22+ and wrangler login
 ```

package/docs/package.md

@@ -76,11 +76,16 @@ prepare the same artifacts:
 ```json
 {
   "scripts": {
-    "postinstall": "bun node_modules/@a2f0/skyline/scripts/build-package.ts"
+    "postinstall": "bun node_modules/@a2f0/skyline/scripts/build/build-package.ts"
   }
 }
 ```
 
+The original documented source entrypoint, `scripts/build-package.ts`, remains
+as a compatibility export and launcher for existing `postinstall` commands.
+New source installations can use the grouped path above. The implementation
+lives only under `scripts/build/`; npm tarballs and library exports are unchanged.
+
 The host needs TypeScript 7, `@tsconfig/strictest`, `@types/bun`, and `@types/node`
 as development dependencies. The build resolves those tools from the host;
 it does not install Skyline's development dependencies or run dependency
@@ -350,6 +355,12 @@ files directly; bundlers do not automatically copy that directory.
 
 ## Releases
 
+The pack job installs the exact agent-tool dependency, then `bun run release:plan`
+uses its shared public-registry decision and GitHub step output. After merge,
+`bun run agent-tool release verify @a2f0/skyline <version> <merge-sha> --workflow
+'Publish npm package'` verifies the matching workflow, registry metadata and
+tarball integrity. Registry propagation is polled before reporting a missing release.
+
 ship-pr bumps the `package.json` patch version on every merge (see
 [the PR workflow](development.md#pr-workflow)), and the
 [publish workflow](../.github/workflows/npm-publish.yml) publishes each version newer than
@@ -370,9 +381,11 @@ It also runs the
 tarball and viewer package suite on Node.js 22 to verify the supported minimum.
 Only when those pass does it build and pack the tarball; both jobs run without
 publish rights, and the publish job receives only that tarball and runs
-`npm publish --ignore-scripts`. Dispatching the workflow on another branch
-(`gh workflow run npm-publish.yml --ref <branch>`) runs only the tests, in a queue of its own,
-so it never displaces a pending publish.
+`npm publish --ignore-scripts`. Dispatching the workflow on another branch that
+satisfies the configured naming policy (`<type>/<topic>`, plus the documented
+exemptions) runs only the tests, in a queue of its own. Use
+`gh workflow run npm-publish.yml --ref <branch>`;
+that queue never displaces a pending publish.
 
 npm adds a trusted publisher only to a package that already exists, so the first version
 is published by hand from an up-to-date `main`. Until then the workflow fails with that

package/docs/skyline-geography.md

@@ -40,7 +40,7 @@ reusing the original layout's fitted one, which describes the drawing's own
 geometry, not a place. The mapped buildings stay where they are mapped; only
 the camera is fitted.
 
-`scripts/fit-geographic-camera.ts` solves the study's orbit camera, aimed at the
+`scripts/fidelity/fit-geographic-camera.ts` solves the study's orbit camera, aimed at the
 centre of the reference excerpt's frame, against the 26 correspondences in
 `geographicLandmarks` in `tests/skyline-landmarks.ts`. These pair mapped spire
 tips, eaves, roof corners, and Crain's peaks, shoulders, foot and step with

package/lib/models/colour-palette.js

@@ -126,7 +126,7 @@ export const measuredColours = {
     },
     // FID-COL-005, the Michigan Avenue wall. Its fronts face east, into the photograph's shade; where a
     // building shows only that front, its stone or terracotta is the shaded median's sunlit estimate,
-    // through the shade-to-sun ratio of the Railway Exchange's terracotta (scripts/sample-colours.ts,
+    // through the shade-to-sun ratio of the Railway Exchange's terracotta (scripts/fidelity/sample-colours.ts,
     // the day study's shade): provisional, since cross-checks disagree with that ratio.
     // docs/borg-warner-reference.md, 2026-10-10 — Daytime colours from Chicago.jpg.
     "building-200-south-michigan": {
@@ -237,7 +237,7 @@ export const measuredColours = {
     },
     // Michigan Avenue fronts Grant Park's trees hide in the panorama: measured in a close-up under an
     // overcast sky and calibrated to the panorama through Willoughby Tower's limestone beside them,
-    // its ratio in linear light between the two photographs (scripts/sample-colours.ts, the day
+    // its ratio in linear light between the two photographs (scripts/fidelity/sample-colours.ts, the day
     // study's references). Their glass, reflecting the overcast, stays grey.
     // docs/chicago-athletic-association-reference.md, 2026-10-10 — Daytime colours from a close-up calibrated to Chicago.jpg.
     "building-chicago-athletic-association": {
@@ -291,7 +291,7 @@ export const measuredColours = {
     },
 };
 // The sunny day the colour toggle shows: the sky's blue at the top of the view and its haze just
-// above the horizon, each the median of a clear box of the same panorama (scripts/sample-colours.ts,
+// above the horizon, each the median of a clear box of the same panorama (scripts/fidelity/sample-colours.ts,
 // the day study's sky), and the sun's warm white, chosen.
 export const daylightColours = { sky: 0x9ebbdb, horizon: 0xc4d1e1, sun: 0xfff4e6 };
 // Illustrated warm, neutral and cool white fixtures; not calibrated Kelvin values.

package/lib/skyline-scene.js

@@ -35,7 +35,7 @@ export function createGeographicSkyline(anchor = [0, 0, 0]) {
         shadowCamera: { left: -1300, right: 1300, top: 1300, bottom: -1300, near: 1, far: 2600 },
     };
     // The drawing traces a lakefront photograph. Fitting the mapped buildings'
-    // roofs and tips to their drawn positions (scripts/fit-geographic-camera.ts)
+    // roofs and tips to their drawn positions (scripts/fidelity/fit-geographic-camera.ts)
     // puts its eye on the shore by the Adler Planetarium, 2 m above the street
     // datum, looking up at the skyline; it is held there while the angles and lens
     // are refitted, since the drawing barely tells its distance from its lens. The

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a2f0/skyline",
-  "version": "0.2.39",
+  "version": "0.2.43",
   "description": "Interactive Chicago skyline viewer and reusable Three.js building models",
   "license": "UNLICENSED",
   "repository": {
@@ -12,8 +12,16 @@
   },
   "type": "module",
   "packageManager": "bun@1.4.3",
-  "sideEffects": ["./site/**/*.js"],
-  "files": ["lib/", "site/", "NOTICE.md", "docs/package.md", "docs/skyline-geography.md"],
+  "sideEffects": [
+    "./site/**/*.js"
+  ],
+  "files": [
+    "lib/",
+    "site/",
+    "NOTICE.md",
+    "docs/package.md",
+    "docs/skyline-geography.md"
+  ],
   "main": "./lib/skyline-package.js",
   "types": "./lib/skyline-package.d.ts",
   "exports": {
@@ -60,27 +68,32 @@
     "agent:run": "agent-tool run",
     "agents:sync": "bun run agent-tool skills install --apply",
     "agents:check": "bun run agent-tool skills check",
-    "check": "bun scripts/check.ts",
-    "test": "bun scripts/check.ts",
+    "check": "bun scripts/testing/check.ts",
+    "test": "bun scripts/testing/check.ts",
     "typecheck": "bunx --bun tsc -p tsconfig.json",
-    "build:site": "bun scripts/build-site.ts",
-    "build:package": "bun scripts/build-package.ts",
+    "build:site": "bun scripts/build/build-site.ts",
+    "build:package": "bun scripts/build/build-package.ts",
     "check:package": "bun test tests/package.test.ts",
     "prepack": "bun run build:package",
     "prepublishOnly": "bun run check",
-    "fidelity": "bun scripts/fidelity-report.ts",
-    "renders": "bun scripts/render-study.ts",
-    "vendor:three": "bun scripts/vendor-three.ts",
-    "deploy": "scripts/deploy.sh",
-    "verify:deploy": "bun scripts/verify-deploy.ts"
+    "fidelity": "bun scripts/fidelity/fidelity-report.ts",
+    "renders": "bun scripts/fidelity/render-study.ts",
+    "vendor:three": "bun scripts/build/vendor-three.ts",
+    "deploy": "scripts/deploy/deploy.sh",
+    "verify:deploy": "bun scripts/deploy/verify-deploy.ts",
+    "hooks:install": "agent-tool hooks install --apply",
+    "hooks:check": "agent-tool hooks check",
+    "lint:branch-name": "agent-tool branch check",
+    "release:plan": "agent-tool release plan package.json --github-output",
+    "timings": "bun scripts/testing/show-timings.ts"
   },
   "devDependencies": {
-    "@a2f0/agent-tool": "0.1.17",
+    "@a2f0/agent-tool": "0.1.19",
     "@tsconfig/strictest": "^2.0.8",
     "@types/bun": "^1.4.3",
     "esbuild": "0.28.2",
-    "three": "0.186.1",
     "playwright": "1.64.1",
+    "three": "0.186.1",
     "typescript": "^7.0.2",
     "wrangler": "4.151.3"
   }

package/site/models/colour-palette.js

@@ -126,7 +126,7 @@ export const measuredColours = {
     },
     // FID-COL-005, the Michigan Avenue wall. Its fronts face east, into the photograph's shade; where a
     // building shows only that front, its stone or terracotta is the shaded median's sunlit estimate,
-    // through the shade-to-sun ratio of the Railway Exchange's terracotta (scripts/sample-colours.ts,
+    // through the shade-to-sun ratio of the Railway Exchange's terracotta (scripts/fidelity/sample-colours.ts,
     // the day study's shade): provisional, since cross-checks disagree with that ratio.
     // docs/borg-warner-reference.md, 2026-10-10 — Daytime colours from Chicago.jpg.
     "building-200-south-michigan": {
@@ -237,7 +237,7 @@ export const measuredColours = {
     },
     // Michigan Avenue fronts Grant Park's trees hide in the panorama: measured in a close-up under an
     // overcast sky and calibrated to the panorama through Willoughby Tower's limestone beside them,
-    // its ratio in linear light between the two photographs (scripts/sample-colours.ts, the day
+    // its ratio in linear light between the two photographs (scripts/fidelity/sample-colours.ts, the day
     // study's references). Their glass, reflecting the overcast, stays grey.
     // docs/chicago-athletic-association-reference.md, 2026-10-10 — Daytime colours from a close-up calibrated to Chicago.jpg.
     "building-chicago-athletic-association": {
@@ -291,7 +291,7 @@ export const measuredColours = {
     },
 };
 // The sunny day the colour toggle shows: the sky's blue at the top of the view and its haze just
-// above the horizon, each the median of a clear box of the same panorama (scripts/sample-colours.ts,
+// above the horizon, each the median of a clear box of the same panorama (scripts/fidelity/sample-colours.ts,
 // the day study's sky), and the sun's warm white, chosen.
 export const daylightColours = { sky: 0x9ebbdb, horizon: 0xc4d1e1, sun: 0xfff4e6 };
 // Illustrated warm, neutral and cool white fixtures; not calibrated Kelvin values.

package/site/skyline-scene.js

@@ -35,7 +35,7 @@ export function createGeographicSkyline(anchor = [0, 0, 0]) {
         shadowCamera: { left: -1300, right: 1300, top: 1300, bottom: -1300, near: 1, far: 2600 },
     };
     // The drawing traces a lakefront photograph. Fitting the mapped buildings'
-    // roofs and tips to their drawn positions (scripts/fit-geographic-camera.ts)
+    // roofs and tips to their drawn positions (scripts/fidelity/fit-geographic-camera.ts)
     // puts its eye on the shore by the Adler Planetarium, 2 m above the street
     // datum, looking up at the skyline; it is held there while the angles and lens
     // are refitted, since the drawing barely tells its distance from its lens. The

package/site/vendor/three-r186.js

@@ -1,4 +1,4 @@
-// Generated by scripts/build-package.ts: the Three.js the viewer's scene renders with. The
+// Generated by scripts/build/build-package.ts: the Three.js the viewer's scene renders with. The
 // host's engine when the page offered one (mountSkyline's `three` option), and otherwise the
 // vendored bundle beside this file, which then loads only when a scene first needs it.
 import { providedThree } from "../three-engine.js";