flowviant 0.106.0 → 0.107.0

package/bin/lib/agentTaskKinds.mjs

@@ -27,10 +27,8 @@
  * The kinds. Per kind:
  *  - `posture`: the turn profile the card runs under (turnProfile.mjs);
  *  - `artifact`: null for code (it delivers commits), else what proves a
- *    delivery — `match` over the artifact file name, an optional `companion`
- *    that must ALSO stand beside it (the 3D-model kind's model file: an HTML
- *    viewer alone is a page, not a model), and the `missing` sentence a turn
- *    settles `nothing` with when the proof was not written;
+ *    delivery — `match` over the artifact file name, and the `missing`
+ *    sentence a turn settles `nothing` with when the proof was not written;
  *  - `offRuntime(rt)`: the sentence when the chosen CLI cannot run the posture.
  */
 /** Every non-code kind runs on Claude: the one CLI that declares their postures. */
@@ -51,18 +49,19 @@ export const AGENT_TASK_KINDS = Object.freeze({
     offRuntime: () => CLAUDE_ONLY,
   }),
   /**
-   * THE 3D-MODEL KIND (0.105.0): a viewable bundle — an HTML viewer and the
-   * model files beside it. Under the design fence (read the repo, write only
-   * `.flowviant/artifacts/**`): a model is a picture of an asset, and
-   * committing it is a separate code card a person raises at Accept.
+   * THE 3D-MODEL KIND (0.105.0; one page since 0.107.0): a three.js page that
+   * builds the model in code, which the person exports to one .glb in Review.
+   * Under the design fence (read the repo, write only `.flowviant/artifacts/**`):
+   * a model is a picture of an asset, and committing it is a separate code
+   * card a person raises at Accept. Proven by its page alone — the model is
+   * IN the page; 0.105.0's second proof (a .gltf/.glb/.obj beside it) went
+   * with the files it asked for.
    */
   model: Object.freeze({
     posture: 'design',
     artifact: Object.freeze({
       match: /\.html?$/i,
-      companion: /\.(gltf|glb|obj)$/i,
-      missing:
-        'the turn ended without writing a model bundle (an HTML viewer and a .gltf, .glb or .obj file) under .flowviant/artifacts/',
+      missing: 'the turn ended without writing a 3D model page under .flowviant/artifacts/',
     }),
     offRuntime: () => CLAUDE_ONLY,
   }),

package/bin/lib/agentTaskTypes.mjs

@@ -91,8 +91,8 @@ export const AGENT_TASK_TYPES = Object.freeze({
     label: '3D model',
     kind: 'model',
     contract:
-      'model the object the card describes as the viewable bundle, at the scale and in the units of any ' +
-      '3D assets the repository already has.',
+      'model the object the card describes in the one three.js page, at the scale and in the units of the ' +
+      'target the card names, else of any 3D assets the repository already has.',
   }),
   vector: Object.freeze({
     label: 'Icons & vector',

package/bin/lib/artifactContracts.mjs

@@ -56,62 +56,84 @@ or, if you are stopping to ask:
 past tense, plain sentences, no card ids.`;
 
 /**
- * THE 3D-MODEL CARD. The product is a model a person can turn around in
- * Review: one folder holding a three.js viewer and the model files it loads
- * by relative URL — the bundle shape the artifact scan keeps (relative paths
- * to depth four, 0.99.0) and the library keeps as one versioned folder. The
- * daemon calls it delivered only when an `.html` AND a `.gltf`/`.glb`/`.obj`
- * stand under `.flowviant/artifacts/` (agentTaskKinds.mjs).
+ * THE 3D-MODEL CARD (rewritten 0.107.0, the owner, 2026-09-27: "yeah just
+ * glb"). The product is ONE .glb a person downloads and imports; the card
+ * hands back ONE three.js page that builds the model in code and shows it —
+ * how Claude makes a model a person can look at anywhere else — and Flowviant
+ * exports that page's model group to a .glb with three.js's own GLTFExporter
+ * when the person presses Download .glb in Review (apps/web
+ * `workbench/glbExport.ts`, the other half of the handshake below).
  *
- * TEXT, BECAUSE TEXT IS ALL THIS POSTURE WRITES (2026-09-27, a call the owner
- * may overrule). The kind runs under the `design` posture: Read, `ls`, and
- * `Edit(.flowviant/artifacts/**)` — Claude's Write/Edit tools write text, and
- * there is no shell that could produce bytes. The spec's first wording asked
- * for glTF with a `.bin`, or a `.glb`, and `.png`/`.jpg` textures: outputs
- * this card cannot make. So the contract asks for OBJ + `.mtl` (text, fetched
- * by relative URL from the artifact host, which the viewer's `connect-src`
- * admits) and SVG or procedural textures (`img-src` admits the host). NOT a
- * `.gltf` with its buffer as a `data:` URI: three.js fetches that buffer, and
- * the artifact CSP's `connect-src` names only the artifact host
- * (apps/api/src/lib/artifactDelivery.ts), so the review viewer would refuse
- * it. Binary files are still accepted — the artifact policy, the proof, the
- * library and the 20 MB cap all keep them — for a folder that already holds
- * one; widening the posture to write them is the owner's decision.
+ * WHY NOT A MODEL FILE ON DISK. This kind runs under the `design` posture:
+ * Read, `ls`, and `Edit(.flowviant/artifacts/**)` — text only, no shell. A
+ * .glb is binary; a .gltf's buffer is base64 floats nobody writes by hand.
+ * The 0.105.0 contract asked for OBJ + .mtl + SVG textures instead, and a
+ * katana came back as seven files, textures no game engine imports and a
+ * generator script (2026-09-27). Built in code, drawn textures are canvases,
+ * and the exporter embeds them in the .glb as PNGs.
+ *
+ * THE HANDSHAKE IS SPELLED WORD FOR WORD because the web keys on it: the page
+ * announces `glb-ready` once its model stands, and answers `export-glb` with
+ * the binary. The page runs in a scripts-only sandbox with an opaque origin,
+ * so it posts to `parent` with `'*'`; the app accepts only its own frame's
+ * messages. A page with no handshake (every 0.105.0 bundle) is still viewed;
+ * it is just never offered a Download .glb.
  */
 export const SYSTEM_AGENT_MODEL = `You are the human's own Claude, working one 3D MODEL card in a git worktree of
 their repository. Nobody is watching this run. You have the repo and nothing
 else — no project tools, no board, no chat.
 
 A 3D MODEL CARD HANDS BACK A MODEL YOU CAN LOOK AT, NOT A CHANGE. Nothing you
-do here edits the product: the person turns the model around, and decides.
+do here edits the product: the person turns the model around, downloads it as
+one .glb, and decides.
 
 WHAT TO DO:
 
-1. Read the repository first — the existing 3D assets and the scene they sit
-   in: their scale and units, their up axis, their style, their materials and
-   texture sizes. The model must fit THIS project, not a stock asset library.
-
-2. Write ONE folder, .flowviant/artifacts/<kebab-name>/ — a short kebab-case
-   name for what it is (for example .flowviant/artifacts/reading-chair/) —
-   holding:
-   - index.html, a viewer: three.js loaded from cdn.jsdelivr.net/npm or
-     unpkg.com, with orbit controls, loading the model by a RELATIVE URL
-     (./reading-chair.obj — never a path outside the folder);
-   - the model, written as TEXT: a .obj with its .mtl, each loaded by a
-     relative URL;
-   - its textures as .svg files referenced by relative paths, or drawn by
-     the viewer itself (procedural materials, canvas textures).
-   You can write only text files here. A .glb, .bin, .png or .jpg is kept
-   and shown if one already stands in the folder, but this card cannot make
-   one — never plan on one. Nothing else may load from the network, and
-   nothing can be sent. Keep every file under 2 MB — the viewer, the .obj,
-   the .mtl, each texture.
+1. Read the card and the repository first. If the card names where the model
+   will be used — a game engine, a platform, a printer — meet that target's
+   import rules: its scale and units, its up axis, its triangle and texture
+   limits. Otherwise match the scale and units of any 3D assets the repository
+   already has. Say in your summary what you assumed.
+
+2. Write ONE file, .flowviant/artifacts/<kebab-name>/index.html — a short
+   kebab-case name for what it is (for example
+   .flowviant/artifacts/reading-chair/index.html). Nothing else goes in that
+   folder: no model files, no textures, no scripts, no notes. The page BUILDS
+   THE MODEL IN CODE and shows it:
+   - three.js as ES modules from cdn.jsdelivr.net/npm, through an import map
+     for "three" and "three/addons/"; orbit controls, lights and a neutral
+     ground. Nothing else loads from the network, and nothing can be sent.
+   - the model is ONE THREE.Group named for what it is, built from three.js
+     geometry (lathe, extrude, tube, box and the rest, one mesh per part),
+     with MeshStandardMaterial only. Colour, roughness and metalness are
+     material values, or textures you DRAW ON A CANVAS in the page
+     (THREE.CanvasTexture, 1024px or less) — never an image file.
+   - the ground, a grid, the lights, a figure for scale and every other
+     helper stay OUTSIDE that group: they are the viewer's, not the model.
+   - no download or save button of your own: the page cannot download
+     anything. Flowviant's Download .glb is the way out.
+   - once the group is built, hand it to Flowviant exactly like this, with
+     MODEL the group:
+
+     import { GLTFExporter } from 'three/addons/exporters/GLTFExporter.js';
+     addEventListener('message', (e) => {
+       if (e.source !== parent || e.data?.flowviant !== 'export-glb') return;
+       new GLTFExporter().parse(
+         MODEL,
+         (glb) => parent.postMessage({ flowviant: 'glb', glb }, '*', [glb]),
+         (err) => parent.postMessage({ flowviant: 'glb-error', message: String(err) }, '*'),
+         { binary: true }
+       );
+     });
+     parent.postMessage({ flowviant: 'glb-ready' }, '*');
+
+   Keep the page under 2 MB.
 
 ${ARTIFACT_CONTRACT_TAIL({
   ask: `If you cannot model it without a DECISION only a person can make — which of
    two directions, what size or style, which asset it stands beside — STOP AND
    ASK. Do not guess. A question costs one reply; a guessed model costs a review.`,
-  summary: 'one or two sentences on what the model shows, and the folder it is in',
+  summary: 'one or two sentences on what the model shows, the folder it is in, and the scale and target you assumed',
 })}`;
 
 /**

package/bin/lib/prompts.mjs

@@ -545,8 +545,8 @@ MECHANICS OF THIS CHAT:
    - "code": a change to the code — commits they review and merge. The default.
    - "design": a UI mockup — one HTML page to look at; no code changed.
      "Mockup", "design page X", "show me what the settings page could look like".
-   - "model": a 3D model — a viewable bundle (an HTML viewer and the model
-     files); no code changed. "3D model", "mesh", "a chair model", "glTF", "OBJ".
+   - "model": a 3D model — one page to turn it around in, downloaded as a
+     .glb; no code changed. "3D model", "mesh", "a chair model", "glTF", "OBJ".
    - "deck": a presentation — one HTML slide deck; no code changed. "Slides",
      "a deck", "a presentation", "a pitch".
    - "research": a write-up — read the repo and the web; no code changed.
@@ -1048,7 +1048,7 @@ export const AGENT_CONTRACTS = Object.freeze({
 });
 export const AGENT_HANDS_BACK = Object.freeze({
   design: 'a DESIGN card: it hands back a mockup',
-  model: 'a 3D MODEL card: it hands back a viewable model bundle',
+  model: 'a 3D MODEL card: it hands back a model to view and download as a .glb',
   deck: 'a PRESENTATION card: it hands back an HTML slide deck',
   research: 'a RESEARCH card: it hands back a write-up',
 });

package/bin/lib/workAgentTurnOutcome.mjs

@@ -78,8 +78,8 @@ export function agentTurnSettlement({ turnId, job, kind, out, lastAnswer, usage,
    *
    * Its product is under `.flowviant/artifacts/`, and the kind's table
    * (agentTaskKinds.mjs) says which file proves it: a `.html` mockup for
-   * design, a `.html` deck, a `.md` write-up for research, and for a 3D
-   * model a `.html` viewer AND a `.gltf`/`.glb`/`.obj` beside it. A turn that
+   * design, a `.html` deck, a `.md` write-up for research, and a `.html`
+   * page for a 3D model (the model is built in it, 0.107.0). A turn that
    * says "delivered" without having written one would land the agent in Review
    * with nothing to look at and a summary describing a page that does not
    * exist — so it settles `nothing` with the measured sentence, and the
@@ -108,19 +108,10 @@ export function agentTurnSettlement({ turnId, job, kind, out, lastAnswer, usage,
    */
   if (res.outcome === 'delivered' && kind.artifact) {
     const want = kind.artifact.match;
-    // THE 3D-MODEL KIND'S SECOND PROOF (0.105.0): its viewer page alone is a
-    // page, not a model — a `.gltf`/`.glb`/`.obj` must stand beside it. A
-    // task turn delivers when it wrote EITHER half this turn and BOTH stand
-    // (a re-modelled mesh — a rewritten .gltf/.glb/.obj — need not rewrite
-    // its viewer; a texture or .mtl alone is neither half). The halves are
-    // not paired by folder (pinned in the test). With no companion this is
-    // exactly the one-file rule design, deck and research have.
-    const also = kind.artifact.companion;
-    const need = (l) => l.some((e) => want.test(e.name)) && (!also || l.some((e) => also.test(e.name)));
+    const has = (l) => l.some((e) => want.test(e.name));
     const standing = scanArtifacts(wt);
-    const touched = changedArtifacts(artifactsBefore, standing);
-    const wrote = touched.some((e) => want.test(e.name) || also?.test(e.name)) && need(standing);
-    const present = wrote || ((job.kind !== 'task' || job.redo === true) && need(standing));
+    const wrote = has(changedArtifacts(artifactsBefore, standing));
+    const present = wrote || ((job.kind !== 'task' || job.redo === true) && has(standing));
     if (!present) {
       return report({
         turnId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flowviant",
-  "version": "0.106.0",
+  "version": "0.107.0",
   "description": "Run your own coding CLIs as build agents for Flowviant — Claude Code, Codex or Antigravity, on your own credentials. Holds your sessions, keeps a worktree per tab, and ships branches on your word.",
   "type": "module",
   "bin": {