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: reconcile installation and roadmap with Kiln 1.3.0

Matt Kissinger2ce4841ee034
diff --git a/ROADMAP.md b/ROADMAP.md
index a511b778..4d83fcce 100644
--- a/ROADMAP.md
+++ b/ROADMAP.md
@@ -1,20 +1,32 @@
# Kiln roadmap
-Updated 7 October 2026 for the public 1.1 release cycle. Delivered scene evidence
-below remains the 5 October checkpoint; it does not attest to a new scene release.
+Updated 17 October 2026 after the public 1.3.0 release.
+Scene performance evidence below retains its original candidate scope; Cabin in
+the Woods carries its own 1.2.3 review report.
[CHANGELOG.md](CHANGELOG.md) defines engine release behavior.
The [backlog](docs/backlog.md) separates completed work, known limits and future decisions.
Dated plans and reviews retain their original candidate scopes.
## Delivered
-Kiln 1.0.0 is published on npm as `@instruktlabs/kiln`, with a matching GitHub
-release and tag. Standalone authoring, optional projects,
-materials, Live Review, calibrated review lighting, bounded tool results and the
-current CLI/MCP contracts are included. This release incorporated the previously
-planned 0.11 optimizer changes, compiled SDK and compatible dependency upgrades.
-The public repository is owned by Instrukt Labs. The separate private hosted
-application has a tested main-branch handoff; its public deployment is deferred.
+Kiln 1.3.0 is published on npm as `@instruktlabs/kiln`, with a matching
+[GitHub release and tag](https://github.com/instruktlabs/kiln/releases/tag/v1.3.0).
+The public site is deployed with the 1.3.0 publication record. Standalone authoring,
+optional projects, materials, Live Review, calibrated review lighting, bounded
+tool results, the compiled SDK and shared CLI/MCP contracts remain the core.
+
+Version 1.3.0 adds optional delivery roles, colliders, anchors, kit ports, surface
+bakes, budgets, solid assertions, atlas packing and a compressed Three.js runtime
+target. Selected organic helpers contributed by
+[FaberVi](https://github.com/FaberVi) are integrated with attribution, alongside
+review/export fidelity fixes, Windows material-publication recovery, renderer
+startup fixes and maintained authoring guidance. No default asset budget,
+universal closed-mesh rule or mandatory modeling approach is introduced.
+See the [changelog](CHANGELOG.md) and [delivery contract](docs/delivery-contract.md).
+
+The public repository is owned by Instrukt Labs. Hosted access is a separate,
+invite-only service; public package publication does not upgrade or qualify its
+runtime. See the [community and hosted access information](README.md#community-and-hosted-access).
The completed scene optimization pass landed in #131, ORM UV/transform fixes in
#132 and the core/stabilization/site follow-ups in #133. Their bounded qualification
@@ -22,45 +34,42 @@ and remaining performance limits are recorded in the
[3 October release disposition](docs/reviews/2026-10-03-release-disposition.md).
These are completed changes, not an instruction to restart that pass.
-Troy's hub source and in-progress work have been migrated to this computer. The
-maintained, portable scene source is [scenes/packages/troy](scenes/packages/troy/README.md).
-Development continues locally; the hub is used for isolated performance testing.
+Troy's maintained, portable scene source is
+[scenes/packages/troy](scenes/packages/troy/README.md).
The coast, terrain/ocean, fleet transitions, crowds and archers, playable
Achilles/Hector, combat, blocking, stamina, bots, simple hands/grips and consistent
scene controls are delivered. The old private playfield-review prototype is retired.
-The public site now includes Troy's scene, pack and gallery, together with Farm,
-Vehicles, Bridge and Foundry packs. All five packs have source in `packs/`; all
-four runnable scenes have source in `scenes/packages/`. Vehicles supplies shared
-assets rather than an invented fifth scene. Runtime and Editable downloads are
-available across the packs. Large generated payloads are delivered through
+The public site now includes Troy's and Cabin in the Woods' scenes, packs and
+galleries, together with Farm, Vehicles, Bridge and Foundry packs. All six packs have
+source in `packs/`; all five runnable scenes have source in `scenes/packages/`.
+Vehicles supplies shared assets rather than a runnable scene of its own.
+Runtime and Editable downloads are available across the packs. Large generated
+payloads are delivered through
Cloudflare R2; hydration is optional, so cloning source does not fetch them.
The [delivery/source plan](docs/plans/2026-10-05-asset-delivery-and-source-organization.md)
records the adopted organization.
Current site pins at this checkpoint are Farm `r36-local-review`, Bridge
-`g9-code6`, Foundry `ff3-review2-code5` and Troy `troy-20261005-07`.
+`g9-code6`, Foundry `ff3-review2-code5`, Troy `troy-20261005-07` and Cabin
+`cabin-20261012-01`.
The public text encoding cleanup, Troy homepage pictures and revised Foundry
campus preview are deployed. The current data manifests govern subsequent pins;
this dated list is not a substitute for inspecting them.
## Next engine and product milestones
-1. Finish the [public 1.1 release](docs/plans/2026-10-07-public-release-goal.md):
- shared setup for existing projects and new workspaces, stable host SDK
- interfaces, concise npm-first documentation, Troy README images and blind
- clone/package dogfooding. Qualify the exact archive, publish the approved npm
- version and GitHub release, then deploy and verify the updated static site.
+1. Carry forward the explicitly unfinished work in the
+ [1.3.0 cycle handoff](docs/backlog.md#cycle-handoff-17-october). The delivery
+ contract, selected organic helpers and reviewed dogfood guidance have shipped;
+ their old proposal branches are not pending engine work.
2. Qualify broader destination/importer support when adopted, especially LOD,
visibility and optional compressed runtime derivatives. Current scene delivery
does not imply universal Meshopt, Draco or KTX2 loader support.
-3. In a later hosting cycle, qualify and deploy the authenticated Cloudflare
- service and resume applicable vendor directory submissions. Local Claude
- Code/Codex plugins are distributed with the public package. Hosted
- access stays free within quotas, with optional sponsorship and no user billing.
- Track npm publication, hosting, plugin distribution and vendor review separately.
- Hosting launch, further packs and community contribution triage stay outside
- the current public release cycle.
+3. Review the prepared scenes trailer and any new packs as separate product work.
+ Continue applicable directory submissions independently of package publication.
+ Local Claude Code/Codex plugins are distributed with the public package;
+ hosted runtime changes require their own qualification and release.
The full optimizer now preserves semantic nodes, hierarchy, placements, animated
targets and LOD relationships; ordinary named meshes can become empty semantic
diff --git a/docs/backlog.md b/docs/backlog.md
index 9b3e40cd..db90137e 100644
--- a/docs/backlog.md
+++ b/docs/backlog.md
@@ -1,7 +1,11 @@
# Kiln current backlog
-Current release status: npm 1.2.1 and GitHub v1.2.1 are published.
-Scene delivery evidence below retains its 5 October scope.
+Current release status (17 October 2026): npm 1.3.0 and
+[GitHub v1.3.0](https://github.com/instruktlabs/kiln/releases/tag/v1.3.0) are published,
+and the public site is deployed. The publication record is on main through #174.
+Open work is listed under [Cycle handoff](#cycle-handoff-17-october).
+Scene performance evidence retains its original candidate scope; Cabin carries
+its own review report.
This is a work queue and known-limit inventory, not a count of defects.
The [roadmap](../ROADMAP.md) describes the delivered state and future milestones.
[Historical reports](reviews/2026-10-05-status-reconciliation.md) keep their original
@@ -9,21 +13,21 @@ test, device and candidate scopes.
## Completed delivery cycle
-The hub migration, Troy environment/gameplay/control/asset work, public scene
-integration, pack downloads, portable scene source and source organization are
-complete. Development happens on this computer; the hub is reserved for isolated
-performance testing. The canonical Troy entry is
+Troy environment/gameplay/control/asset work, public scene integration, pack
+downloads, portable scene source and source organization are complete within
+their recorded scope. The canonical Troy entry is
[scenes/packages/troy](../scenes/packages/troy/README.md).
-All five packs (Farm, Vehicles, Bridge, Foundry and Troy) have checked-in editable
-source; all four runnable scenes have maintained source packages. Runtime and
-Editable downloads are public. Large generated files remain outside the normal
+All six packs (Farm, Vehicles, Bridge, Foundry, Troy and Cabin in the Woods) have
+checked-in editable source; all five runnable scenes have maintained source packages.
+Runtime and Editable downloads are public. Large generated files remain outside the normal
clone through hash-pinned Cloudflare R2 delivery and explicit hydration.
Bridge is in the gallery. The unwanted Battle before the gate composition is
removed from gallery presentation while its saved source/history remains.
Current scene pins are Farm `r36-local-review`, Bridge `g9-code6`, Foundry
-`ff3-review2-code5` and Troy `troy-20261005-07`.
+`ff3-review2-code5`, Troy `troy-20261005-07` and Cabin `cabin-20261012-01`
+(Cabin shipped in 1.2.3).
The horse-ear child revision, loading transport/bundling changes, public-text
encoding guard, Troy homepage images and revised Foundry campus preview are delivered.
The obsolete private `/reviews/troy/` prototype has been retired; use the normal
@@ -53,14 +57,40 @@ handling; CORE-1's shared-image isolation and the remaining core changes landed
through #133 and shipped in npm 1.0.0. Later candidate changes still require their
own package qualification and publication.
+## Released in 1.3.0
+
+The optional game-delivery contract from #171 and selected organic helpers from
+#141 were integrated through #172. FaberVi's contribution is acknowledged in the
+[changelog](../CHANGELOG.md) and [provenance record](reviews/2026-10-16-organic-adoption.md).
+The original PRs #140, #141, #142 and #171, plus umbrella proposal #134, are closed
+with their individual dispositions recorded. Rock helpers remain deferred; the
+universal topology heuristic and benchmark runner were not adopted.
+
+Review/export fidelity, measured runtime draw diagnostics, Windows material-file
+publication and renderer startup fixes are released. Reviewed 1.2.3 dogfood lessons
+are incorporated into the maintained skills and clean-room guidance. The earlier
+circular-wall and export-receipt guidance from #163 shipped in 1.2.2 and remains
+included. These are completed integrations, not pending PRs.
+
+## Cycle handoff (17 October)
+
+The 1.3.0 integration and publication cycle is complete. Remaining work below has
+its own review and completion boundary.
+
+| Item | State | Next step |
+| --- | --- | --- |
+| Catalog listing | [awesome-ai-plugins#771](https://github.com/hashgraph-online/awesome-ai-plugins/pull/771) remains open. Format validation passes; the source scan and aggregate catalog gate are not satisfied | Await catalog maintainer review; assess any requested changes separately |
+| Repository hygiene | A security policy and dependency-update configuration remain follow-ups; Codex plugin metadata is already present | Review in a small, separately scoped PR |
+| Scenes trailer | Capture tooling and preview cuts are prepared separately from the released scene runtimes | Owner review of the cuts; decide what, if anything, lands on main |
+| Organic authoring follow-up | Selected helpers have shipped; rock displacement helpers remain deferred | Require demonstrated authoring need and explicit contracts before adding another helper |
+| HOL Guard integration | Separate command-classification experiment | Reassess after the catalog listing decision; no upstream adoption is implied |
+
## Remaining package and product work
| Item | Completion boundary |
| --- | --- |
-| Authoring guidance follow-up | PR #163 contains circular-wall orientation and export-receipt guidance; still unmerged at the October 9 readback and not included in npm 1.2.1 |
-| Hosted service | Invite-only launch work is owned by the private application's handoff; public package publication does not establish hosted availability |
-| Community and site alignment | Discord setup, hosted-access instructions and current-version documentation are in progress; publish only after review |
-| Directory submissions | Separate from package publication and hosted deployment; no submission is implied by either |
+| Hosted service | Hosted runtime upgrades require separate qualification; public package publication does not establish hosted availability |
+| Directory submissions | Separate from package publication and hosted deployment; see the cycle handoff for the open catalog listing. Vendor review remains separate from local plugin distribution |
| Further packs | Separate product work; ten-pack production is not a Troy release chore |
| Broader importer qualification | Actual destination tests for LOD, visibility and supported export profiles |
| Optional compressed runtime derivatives | Explicit loader/profile adoption and measured size/startup/render tradeoffs; current shared runtime loading is not universal Meshopt/Draco/KTX2 support |
diff --git a/docs/install.md b/docs/install.md
index 06a4230b..b37dd293 100644
--- a/docs/install.md
+++ b/docs/install.md
@@ -484,9 +484,9 @@ The v1 local plugin below uses a smaller bundle and creates an explicit workspac
## Local Claude Code and Codex plugins
-The commands below select the 1.2.1 plugin, which supports new workspaces and
-existing-project adoption. Use them once the matching GitHub tag and npm version
-are available. To qualify an unpublished candidate, select its exact source ref
+The commands below select the released 1.3.0 plugin, which supports new workspaces
+and existing-project adoption. The matching GitHub tag and npm version are
+available. To qualify an unpublished candidate, select its exact source ref
and supply the matching local engine archive as described in its bundled setup
reference. Normal use should select a published release tag.
@@ -499,14 +499,14 @@ does not start a second global Kiln MCP server.
For Claude Code:
```sh
-claude plugin marketplace add instruktlabs/kiln#v1.2.1 --sparse .claude-plugin plugins/kiln-engine
+claude plugin marketplace add instruktlabs/kiln#v1.3.0 --sparse .claude-plugin plugins/kiln-engine
claude plugin install kiln-engine@instruktlabs
```
For Codex:
```sh
-codex plugin marketplace add instruktlabs/kiln --ref v1.2.1 --sparse .agents/plugins --sparse plugins/kiln-engine
+codex plugin marketplace add instruktlabs/kiln --ref v1.3.0 --sparse .agents/plugins --sparse plugins/kiln-engine
codex plugin add kiln-engine@instruktlabs
```