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.
JavaScript 3d3d-assets3d-modelingagent-skillsagent-toolsai-agentsasset-pipelinecligame-assetsglbgltfmcpmcp-servermodel-context-protocolprocedural-generationprocedural-modelingtext-to-3dthreejstypescript
docs: reconcile installation and roadmap with Kiln 1.3.0
Matt Kissinger2ce4841ee034
diff --git a/ROADMAP.md b/ROADMAP.mdindex 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, playableAchilles/Hector, combat, blocking, stamina, bots, simple hands/grips and consistentscene 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 throughCloudflare 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 Foundrycampus 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 deliverydoes 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, animatedtargets and LOD relationships; ordinary named meshes can become empty semanticdiff --git a/docs/backlog.md b/docs/backlog.mdindex 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 normalclone through hash-pinned Cloudflare R2 delivery and explicit hydration.Bridge is in the gallery. The unwanted Battle before the gate composition isremoved 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-textencoding 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 landedthrough #133 and shipped in npm 1.0.0. Later candidate changes still require theirown 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.mdindex 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 refand supply the matching local engine archive as described in its bundled setupreference. 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-engineclaude 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-enginecodex plugin add kiln-engine@instruktlabs```