Skip to content

armgit / kiln

Public Imported from GitHub
0

Build and revise procedural 3D assets with your coding agent. Local MCP server, CLI and TypeScript engine with rendered review, editable source and GLB export.

docs: record the history rewrite and how to recover an old clone

Matthew Kissingerfbc3da2df144
diff --git a/CHANGELOG.md b/CHANGELOG.md
index b798dd9b..9cbe991d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,29 @@
Changes to `@kiln/engine`. Source and installable packages are distributed through
GitHub. The package is not published on the npm registry.
+## Smaller clone; gallery images served from R2 — 2026-09-10
+
+- Gallery renders and launch video are no longer carried in git history. A clone
+ costs 35 MB on disk rather than 440 MB, and a plugin install no longer pays for
+ 539 MB of repository content twice.
+- The 88 gallery images moved to Cloudflare R2 byte for byte and are served from
+ `assets.kilnstudio.tools`. Nothing was re-encoded: all 83 poster receipts still
+ verify against the stored objects, and `scripts/verify-posters.mjs` checks that
+ on every gallery build.
+- **This rewrote history.** All 177 commits survived and the tree is unchanged
+ apart from the removed images and video, but every commit hash changed. Clones
+ predating this cannot fast-forward; see the note in `README.md`. Links pinned to
+ an old commit SHA will stop resolving; links through `main` are unaffected.
+- The launch video was never what the README served -- that comes from GitHub's
+ asset CDN -- so the README is unaffected. `assets/gallery/` deliberately stays
+ in the repository, so the README grid needs no network.
+- Re-encoding the posters to shrink them was considered and rejected: image tokens
+ scale with pixel dimensions, not file size, so it would have saved no agent
+ context while voiding all 83 receipts.
+
+Full record, including everything rejected and why, in
+[docs/plans/repo-size-and-r2-migration-2026-09-10.md](docs/plans/repo-size-and-r2-migration-2026-09-10.md).
+
## Collections and chat viewing — 2026-09-06
- Save assets into project or personal collections with immutable revisions,
diff --git a/README.md b/README.md
index bdc69260..f705ce8f 100644
--- a/README.md
+++ b/README.md
@@ -80,6 +80,14 @@ bun run kiln render examples/crate.kiln.js --out crate.glb --views sheet.png
file contents on the server, fetching them only if you ask for an old revision.
A plain `git clone` also works and gives you the whole history up front.
+History was rewritten on 2026-09-10 to drop 288 MB of gallery renders and launch
+video that no tool reads, taking a clone from 440 MB to 35 MB on disk. Every
+commit survived and the tree is unchanged apart from those files, but every
+commit hash changed, so a clone made before that date cannot fast-forward.
+Re-clone, or discard local history with `git fetch origin && git reset --hard
+origin/main`. The gallery images are served from `assets.kilnstudio.tools`; the
+83 poster receipts that attest their bytes stayed in `examples/renders/`.
+
This writes a GLB and a six-view image of an existing program. It makes no model call.
Rendering uses the CPU unless a compatible local GPU service is available.
Use `--render cpu` to select the CPU explicitly.