@floless/app 0.43.0 → 0.44.0

package/dist/templates/tekla-watch-logger.flo

@@ -0,0 +1,57 @@
+app:           tekla-watch-logger
+version:       0.1.0
+display-name:  Tekla Watch → file log
+description: |
+  Event-triggered demo: a tekla.watch source streams every model change, and a
+  downstream exec node appends each event's details (mark, type, change, guid,
+  timestamp) to ~/Documents/floless-watch-log.txt — one line per event. Proves the
+  "On trigger" chain end-to-end and leaves a durable, app-closed-verifiable record.
+  self_test:true drives 5 synthetic events with no live Tekla; against a real model
+  it logs forever while the routine is enabled.
+exposes-as-agent: false
+layout: linear
+requires:
+  - tekla@0.1.x
+nodes:
+  - id: watch                       # SOURCE — streaming lifecycle:start; one fire per change
+    agent: tekla
+    command: watch
+    config:
+      filter: all
+      self_test: true
+      include_deleted: true
+  - id: log                         # SINK — append this event's details to the file
+    agent: tekla
+    command: exec
+    mode: read                      # author intent; AWARE defaults exec→write (issue #165), cosmetic
+    config:
+      version: "2025.0"
+      # Per-event payload bound by the streaming runtime as {{ inputs.<field> }}
+      # (orchestrator.propagate_from → execute_and_chain inserts the fired event
+      # under `inputs`). Fields: mark, type, change, guid, host, delivered_at.
+      args:
+        mark:  "{{ inputs.mark }}"
+        type:  "{{ inputs.type }}"
+        change: "{{ inputs.change }}"
+        guid:  "{{ inputs.guid }}"
+        at:    "{{ inputs.delivered_at }}"
+      code: |
+        // Append one line per fired event to ~/Documents/floless-watch-log.txt.
+        // System.IO is available in exec (System.Net / System.Diagnostics.Process are not).
+        string Get(string k) => args != null && args.ContainsKey(k) && args[k] != null
+          ? args[k].ToString() : "";
+        string mark = Get("mark");
+        string type = Get("type");
+        string change = Get("change");
+        string guid = Get("guid");
+        string at = Get("at");
+
+        string dir = System.Environment.GetFolderPath(System.Environment.SpecialFolder.MyDocuments);
+        string path = System.IO.Path.Combine(dir, "floless-watch-log.txt");
+        string stampedAt = string.IsNullOrEmpty(at) ? System.DateTime.UtcNow.ToString("o") : at;
+        string line = string.Format("{0}\t{1}\t{2}\t{3}\tguid={4}", stampedAt, change, type, mark, guid);
+        System.IO.File.AppendAllText(path, line + System.Environment.NewLine);
+
+        return new { ok = true, logged = line, path = path };
+connections:
+  - { from: watch, to: log }

package/dist/templates/tekla-watch-smoke.flo

@@ -0,0 +1,20 @@
+app:           tekla-watch-smoke
+version:       0.1.0
+display-name:  Tekla Watch (smoke)
+description: |
+  Minimal tekla.watch event-source app for capturing the streaming run-trace
+  shape (self_test:true drives synthetic events with no live Tekla). Used to
+  ground floless.app's "On trigger" fire-detection.
+exposes-as-agent: false
+layout: linear
+requires:
+  - tekla@0.1.x
+nodes:
+  - id: watch
+    agent: tekla
+    command: watch
+    config:
+      filter: all
+      self_test: true
+      include_deleted: true
+connections: []

package/dist/templates/trimble-list-projects.flo

@@ -0,0 +1,41 @@
+app:           trimble-list-projects
+version:       0.1.0
+display-name:  Trimble — list my projects
+description: |
+  Lists the Trimble Connect projects you can access (read-only) and renders them
+  as an HTML report. Uses the connected `trimble-connect` credential — AWARE
+  attaches the stored OAuth token as a Bearer automatically, floless.app never sees
+  it — then html-report's generic auto-render turns the result into a table the
+  in-app Viewer shows. Foundation demo for Trimble workflow support.
+exposes-as-agent: false
+requires:
+  - trimble-connect@0.2.x
+  - html-report@0.2.x
+requires-permissions:
+  network:
+    - https://app.connect.trimble.com
+layout: linear
+# Explicit edge so `report` waits for `projects`. As of AWARE 0.59.0 (#208) a ref
+# like `{{ projects.body }}` auto-derives this edge, so it's belt-and-suspenders now —
+# kept for clarity.
+connections:
+  - from: projects
+    to: report
+nodes:
+  - id: projects
+    agent: trimble-connect
+    command: list-projects
+    config:
+      top: 100
+  - id: report
+    agent: html-report
+    command: render
+    config:
+      data: '{{ projects.body }}'
+      title: My Trimble Connect projects
+      # The API returns ~20 columns (incl. raw thumbnail URLs + createdBy JSON blobs);
+      # keep a clean, useful set and lead with the most recently modified.
+      # (html-report columns + sort, AWARE 0.61.0 / #210.)
+      columns: [name, location, modifiedOn, filesCount, foldersCount, access]
+      sort: modifiedOn
+      sort-desc: true

package/dist/templates/viewer-3d-demo.flo

@@ -0,0 +1,65 @@
+app:           viewer-3d-demo
+version:       0.1.0
+display-name:  3D Viewer Demo
+description: |
+  A self-contained demo of the viewer-3d agent — renders a small steel portal frame as an
+  interactive 3D model in the in-app viewer (orbit/zoom, click a member to inspect, a legend
+  and a takeoff table). No Tekla model required: a single viewer-3d `render` node with an
+  inline, domain-agnostic scene. Use it to preview the interactive 3D surface end to end.
+exposes-as-agent: false
+requires:
+  - viewer-3d@0.1.x
+layout: linear
+nodes:
+  # The viewer-3d render node IS the terminal: it returns the interactive HTML the viewer shows.
+  - id: view
+    agent: viewer-3d
+    command: render
+    config:
+      scene:
+        meta: { name: "Sample portal frame — 20 m × 24 m", units: mm, up: z }
+        groups:
+          - { key: column, label: Columns, color: "#60a5fa" }
+          - { key: rafter, label: Rafters, color: "#38bdf8" }
+          - { key: beam,   label: Beams,   color: "#94a3b8" }
+          - { key: brace,  label: Bracing, color: "#818cf8" }
+        elements:
+          # columns (z 0 -> 6000)
+          - { id: COL-A1, group: column, kind: box, from: [0,0,0],      to: [0,0,6000],      section: { w: 310, d: 310 }, meta: { profile: "UC 305x305x97" } }
+          - { id: COL-C1, group: column, kind: box, from: [20000,0,0],  to: [20000,0,6000],  section: { w: 310, d: 310 }, meta: { profile: "UC 305x305x97" } }
+          - { id: COL-A2, group: column, kind: box, from: [0,6000,0],   to: [0,6000,6000],   section: { w: 310, d: 310 }, meta: { profile: "UC 305x305x97" } }
+          - { id: COL-C2, group: column, kind: box, from: [20000,6000,0], to: [20000,6000,6000], section: { w: 310, d: 310 }, meta: { profile: "UC 305x305x97" } }
+          - { id: COL-A3, group: column, kind: box, from: [0,12000,0],  to: [0,12000,6000],  section: { w: 310, d: 310 }, meta: { profile: "UC 305x305x97" } }
+          - { id: COL-C3, group: column, kind: box, from: [20000,12000,0], to: [20000,12000,6000], section: { w: 310, d: 310 }, meta: { profile: "UC 305x305x97" } }
+          # rafters (eave -> apex -> eave) per frame
+          - { id: RAF-L1, group: rafter, kind: box, from: [0,0,6000],      to: [10000,0,7500],     section: { w: 190, d: 460 }, meta: { profile: "UB 457x191x67" } }
+          - { id: RAF-R1, group: rafter, kind: box, from: [10000,0,7500],  to: [20000,0,6000],     section: { w: 190, d: 460 }, meta: { profile: "UB 457x191x67" } }
+          - { id: RAF-L2, group: rafter, kind: box, from: [0,6000,6000],   to: [10000,6000,7500],  section: { w: 190, d: 460 }, meta: { profile: "UB 457x191x67" } }
+          - { id: RAF-R2, group: rafter, kind: box, from: [10000,6000,7500], to: [20000,6000,6000], section: { w: 190, d: 460 }, meta: { profile: "UB 457x191x67" } }
+          - { id: RAF-L3, group: rafter, kind: box, from: [0,12000,6000],  to: [10000,12000,7500], section: { w: 190, d: 460 }, meta: { profile: "UB 457x191x67" } }
+          - { id: RAF-R3, group: rafter, kind: box, from: [10000,12000,7500], to: [20000,12000,6000], section: { w: 190, d: 460 }, meta: { profile: "UB 457x191x67" } }
+          # eaves beams (along Y, z 6000) + ridge (x 10000, z 7500)
+          - { id: EAV-A1, group: beam, kind: box, from: [0,0,6000],      to: [0,6000,6000],      section: { w: 170, d: 310 }, meta: { profile: "UB 305x165x40" } }
+          - { id: EAV-A2, group: beam, kind: box, from: [0,6000,6000],   to: [0,12000,6000],     section: { w: 170, d: 310 }, meta: { profile: "UB 305x165x40" } }
+          - { id: EAV-C1, group: beam, kind: box, from: [20000,0,6000],  to: [20000,6000,6000],  section: { w: 170, d: 310 }, meta: { profile: "UB 305x165x40" } }
+          - { id: EAV-C2, group: beam, kind: box, from: [20000,6000,6000], to: [20000,12000,6000], section: { w: 170, d: 310 }, meta: { profile: "UB 305x165x40" } }
+          - { id: RDG-1,  group: beam, kind: box, from: [10000,0,7500],   to: [10000,6000,7500],  section: { w: 170, d: 310 }, meta: { profile: "UB 305x165x40" } }
+          - { id: RDG-2,  group: beam, kind: box, from: [10000,6000,7500], to: [10000,12000,7500], section: { w: 170, d: 310 }, meta: { profile: "UB 305x165x40" } }
+          # vertical X-bracing (end bay, wall A)
+          - { id: BR-A1, group: brace, kind: box, from: [0,0,0],    to: [0,6000,6000], section: { w: 140, d: 140 }, meta: { profile: "CHS 139.7x5.0" } }
+          - { id: BR-A2, group: brace, kind: box, from: [0,0,6000], to: [0,6000,0],    section: { w: 140, d: 140 }, meta: { profile: "CHS 139.7x5.0" } }
+        grids:
+          - { label: A, at: [0,-2000,0] }
+          - { label: B, at: [10000,-2000,0] }
+          - { label: C, at: [20000,-2000,0] }
+          - { label: "1", at: [-2000,0,0] }
+          - { label: "3", at: [-2000,12000,0] }
+        panels:
+          - title: Takeoff
+            note: "Counted from the scene — no Tekla licence."
+            columns: [Section, "No.", Length]
+            rows:
+              - ["UC 305x305x97", 6, "36.0 m"]
+              - ["UB 457x191x67", 6, "60.7 m"]
+              - ["UB 305x165x40", 6, "36.0 m"]
+              - ["CHS 139.7x5.0", 2, "17.0 m"]

package/dist/web/app.css

@@ -1599,6 +1599,23 @@
   .app-update:hover { border-color: var(--accent); color: var(--accent); }
   .app-update[disabled] { opacity: 0.6; cursor: default; }
 
+  /* Workflow-update pill (a published workflow has a newer version) — mirrors the app-update pill. */
+  .wf-update-pill { display: none; border: 1px solid var(--accent-dim); background: var(--accent-soft); color: var(--accent-bright); font-size: 10px; padding: 1px 7px; border-radius: 999px; cursor: pointer; margin-left: 8px; line-height: 1.5; }
+  .wf-update-pill:not([hidden]) { display: inline-flex; align-items: center; gap: 4px; }
+  .wf-update-pill:hover { border-color: var(--accent); color: var(--accent); }
+  .wf-update-pill:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
+  /* Changelog list inside the update modal — themed scroll container (no native bar leaks). */
+  .wf-update-changelog { max-height: 280px; overflow-y: auto; margin-bottom: 14px; display: flex; flex-direction: column; gap: 12px; scrollbar-width: thin; scrollbar-color: var(--border-strong) transparent; }
+  .wf-update-changelog::-webkit-scrollbar { width: 6px; }
+  .wf-update-changelog::-webkit-scrollbar-thumb { background: var(--border-strong); border-radius: 6px; }
+  .wf-update-changelog::-webkit-scrollbar-track { background: transparent; }
+  .wf-update-changelog .wf-ver-head { font-family: var(--mono); font-weight: 700; color: var(--text); font-size: 12px; }
+  .wf-update-changelog .wf-ver-sum { color: var(--text-muted); font-size: 11px; margin: 2px 0 6px; }
+  .wf-update-changelog ul { margin: 0; padding-left: 16px; }
+  .wf-update-changelog li { color: var(--text); font-size: 12px; margin: 2px 0; }
+  #wf-update-sub { color: var(--text-muted); }
+  .wf-update-note { font-size: 11px; color: var(--text-muted); margin: 0 0 16px; line-height: 1.5; padding-top: 12px; border-top: 1px solid var(--border); }
+
   /* Add/edit form */
   .modal.routine-edit { width: 540px; max-width: 92vw; max-height: 90vh; overflow-y: auto; }
   #rtn-workflow, .rtn-kind-select { min-width: 0; width: 100%; }

package/dist/web/aware.js

@@ -533,6 +533,8 @@
 
   // ── load / select / compile / run ───────────────────────────────────────────
 
+  let _wfUpdates = []; // workflow updates available, keyed by app id — polled by refreshWorkflowUpdates() below
+
   async function loadApp(id) {
     const { app } = await api(`/api/app/${encodeURIComponent(id)}`);
     apps.set(id, app);
@@ -554,6 +556,7 @@
     markSpecialNodes();
     paintGate(app);
     refreshDirtyIndicator(); // clean app → dot off; switched back to a dirty one → dot on
+    renderWfUpdatePill(); // show the "↑ Update to vX" pill when THIS app has a newer published version
   }
 
   async function loadApps() {
@@ -2826,6 +2829,82 @@
     setInterval(refreshUpdate, 60 * 60 * 1000); // hourly backstop; the focus re-check (below) is the fast path
   }
 
+  // ── Workflow update (module-shaped) ─────────────────────────────────────────────
+  // A FloLess-published workflow (e.g. steel-takeoff) has a newer bundled template. Poll GET
+  // /api/workflows/updates; when the OPEN app has one, show a pill → modal with the changelog →
+  // "Back up & update" POSTs /api/workflows/:id/update (backup → swap structure → re-bake the user's
+  // data from the contract store → recompile) → reload the app. No auto-update. `_wfUpdates` + the
+  // renderWfUpdatePill() call in loadApp() live earlier; renderWfUpdatePill queries the DOM so it's
+  // safe to call before this block initialises.
+  const $wfUpdate = document.getElementById('wf-update');
+  const $wfUpdateModal = document.getElementById('wf-update-modal');
+  let _wfUpdateApplying = false;
+  function wfUpdateFor(id) { return _wfUpdates.find((u) => u.id === id) || null; }
+  function renderWfUpdatePill() {
+    const el = document.getElementById('wf-update');
+    if (!el) return;
+    const u = currentId ? wfUpdateFor(currentId) : null;
+    if (u) {
+      el.textContent = '↑ Update to v' + u.available;
+      el.dataset.tip = 'A newer version of this workflow is available — see what changed';
+      el.hidden = false;
+    } else {
+      el.hidden = true;
+    }
+  }
+  async function refreshWorkflowUpdates() {
+    try {
+      const r = await fetch('/api/workflows/updates');
+      const d = await r.json();
+      _wfUpdates = (r.ok && d.ok && Array.isArray(d.updates)) ? d.updates : [];
+    } catch { _wfUpdates = []; }
+    renderWfUpdatePill();
+  }
+  function openWfUpdateModal(u) {
+    if (!$wfUpdateModal) return;
+    const a = apps.get(u.id);
+    const name = (a && a.displayName) || u.id;
+    document.getElementById('wf-update-title').textContent = `Update “${name}” to v${u.available}`;
+    document.getElementById('wf-update-sub').textContent = `You’re on v${u.installed}. What’s new:`;
+    const changelog = Array.isArray(u.changelog) ? u.changelog : [];
+    document.getElementById('wf-update-changelog').innerHTML = changelog.map((e) => {
+      const changes = Array.isArray(e.changes) && e.changes.length
+        ? '<ul>' + e.changes.map((c) => `<li>${escapeHtml(String(c))}</li>`).join('') + '</ul>' : '';
+      return `<div class="wf-ver"><div class="wf-ver-head">v${escapeHtml(String(e.version))}</div>`
+        + (e.summary ? `<div class="wf-ver-sum">${escapeHtml(String(e.summary))}</div>` : '') + changes + '</div>';
+    }).join('') || '<div class="wf-ver-sum">No changelog provided.</div>';
+    showModal($wfUpdateModal);
+  }
+  async function applyWfUpdate(u) {
+    if (_wfUpdateApplying) return;
+    _wfUpdateApplying = true;
+    const $ok = document.getElementById('wf-update-ok');
+    const prev = $ok ? $ok.textContent : '';
+    if ($ok) { $ok.disabled = true; $ok.textContent = 'Updating…'; }
+    try {
+      const r = await fetch(`/api/workflows/${encodeURIComponent(u.id)}/update`, { method: 'POST', headers: { 'content-type': 'application/json' } });
+      const d = await r.json().catch(() => ({}));
+      if (!r.ok || !d.ok) throw new Error(d.error || 'update failed');
+      hideModal($wfUpdateModal);
+      showToast(`Updated to v${d.toVersion} — your data is preserved, a backup was saved.`, 'ok');
+      await refreshWorkflowUpdates();
+      if (currentId === u.id) await loadApp(currentId); // reload to show the new structure
+    } catch (e) {
+      showToast('Workflow update failed — ' + String((e && e.message) || e).slice(0, 100), 'warn');
+    } finally {
+      _wfUpdateApplying = false;
+      if ($ok) { $ok.disabled = false; $ok.textContent = prev; }
+    }
+  }
+  if ($wfUpdate) {
+    $wfUpdate.onclick = () => { const u = currentId && wfUpdateFor(currentId); if (u) openWfUpdateModal(u); };
+    const $cancel = document.getElementById('wf-update-cancel'); if ($cancel) $cancel.onclick = () => hideModal($wfUpdateModal);
+    const $ok = document.getElementById('wf-update-ok'); if ($ok) $ok.onclick = () => { const u = currentId && wfUpdateFor(currentId); if (u) applyWfUpdate(u); };
+    if ($wfUpdateModal) onBackdropDismiss($wfUpdateModal, () => hideModal($wfUpdateModal));
+    refreshWorkflowUpdates();
+    setInterval(refreshWorkflowUpdates, 60 * 60 * 1000);
+  }
+
   // Dev-override helper — the ONLY forced-visible path. Reveals a pill with a fixed
   // version when localStorage['floless.dev.forceUpdate'] matches the component, so an
   // E2E can exercise the popover without a real pending update. Returns true if forced.

package/dist/web/index.html

@@ -54,6 +54,7 @@
           </div>
         </div>
         <select id="prompt-select" hidden></select>
+        <button id="wf-update" class="wf-update-pill" type="button" hidden aria-haspopup="dialog"></button>
         <!-- Agents (⊞) and Routines (⏱) buttons moved into the ≡ menu in #149
              (Ctrl+G / Ctrl+R); the toolbar keeps only the run-critical controls. -->
         <span class="ctl-sep" aria-hidden="true"></span>
@@ -241,6 +242,22 @@
     </div>
   </div>
 
+  <!-- Workflow update: a FloLess-published workflow has a newer version. The changelog (entries
+       newer than installed) renders into #wf-update-changelog; "Back up & update" swaps the
+       structure but keeps the user's data (re-baked from the contract store). -->
+  <div class="modal-backdrop" id="wf-update-modal">
+    <div class="modal">
+      <div class="modal-title" id="wf-update-title">Workflow update</div>
+      <div class="modal-sub" id="wf-update-sub"></div>
+      <div class="wf-update-changelog" id="wf-update-changelog"></div>
+      <div class="wf-update-note">Your work is safe — this updates the workflow's steps and keeps your data. A backup of the current version is saved first.</div>
+      <div class="modal-actions">
+        <button id="wf-update-cancel">Not now</button>
+        <button id="wf-update-ok" class="primary">↑ Back up &amp; update</button>
+      </div>
+    </div>
+  </div>
+
   <div class="menu" id="menu" role="menu">
     <button class="menu-item" data-action="open" role="menuitem">
       <span class="menu-icon" aria-hidden="true"><svg viewBox="0 0 24 24"><path d="m6 14 1.5-2.9A2 2 0 0 1 9.24 10H20a2 2 0 0 1 1.94 2.5l-1.54 6a2 2 0 0 1-1.95 1.5H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h3.9a2 2 0 0 1 1.69.9l.81 1.2a2 2 0 0 0 1.67.9H18a2 2 0 0 1 2 2v2"/></svg></span>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@floless/app",
-  "version": "0.43.0",
+  "version": "0.44.0",
   "type": "module",
   "description": "Thin localhost host for floless.app — serves web/ and shells the aware CLI. No engine, no LLM.",
   "bin": {