Draggable nool: captured-geometry drag rewrites, plus navigation, sound, undo, and persistence

.github/workflows/deploy-branches.yml

@@ -11,16 +11,16 @@ jobs:
       #- name: Debugging with ssh
       #  uses: lhotari/action-upterm@v1
       - name: Checkout nool repo on current branch # STEP 1
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
         with:
           path: source
       - name: Add name of current branch to environment as BRANCH_NAME
         uses: nelonoel/branch-name@v1.0.1
       - name: Retrieve build environment if cached # STEP 2
         id: build-cache
-        uses: actions/cache@v2
+        uses: actions/cache@v4
         with:
-          path: '/home/runner/.opam/'
+          path: "/home/runner/.opam/"
           key: ${{ runner.os }}-modules-${{ hashFiles('./source/pnp-lock.yaml') }}
       #- name: Debugging with ssh
       #  uses: lhotari/action-upterm@v1
@@ -29,7 +29,7 @@ jobs:
       - name: Use Node.js 21.2.0
         uses: actions/setup-node@v3
         with:
-          node-version: '21.2.0'
+          node-version: "21.2.0"
       # yarn global add pnpm@8.10.5
       - name: Install dependencies and build nool # STEP 3
         run: |
@@ -43,7 +43,7 @@ jobs:
           pnpm run build
         working-directory: ./source
       - name: Checkout website build artifacts repo # STEP 4
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
         with:
           repository: disconcision/disconcision.github.io
           token: ${{ secrets.DEPLOY_NOOL }}
@@ -66,4 +66,4 @@ jobs:
           git add -A
           git status
           git diff-index --quiet HEAD || (git commit -m "github-deploy-action-${BRANCH_NAME}"; git push)
-        working-directory: ./server
+        working-directory: ./server

design/TODO.md

@@ -0,0 +1,88 @@
+# TODO — consolidated index (draggable branch)
+
+Single place to find remaining work. Detail lives in the referenced docs;
+items listed in full here are NOT recorded elsewhere.
+
+## Recorded elsewhere (see those files for detail)
+
+- **design/captured-geometry.md** — plan step 4 "Still open": chaining
+  (multi-rewrite drags); Pat-level provenance, execution half (rewrites record
+  correspondence — subsumes comp-match ambiguity and clone-source edge
+  cases; the affordance half — pattern-level moverhood — landed
+  2026-07-30, restoring the factor-via-shared-die gesture symmetrically);
+  near-collinear rail acquisition tie-breaks. Also its findings entry
+  "Rule gating (game design, sketch)".
+- **design/pinned.md** — shadow strategy reevaluation (nine-slice sprite
+  etc.) + Shift+D default decision; drag overlap legibility (shadow + scale
+  on held subtree, dim the rest); toolbox motion (tool flips snap; extend
+  motion layer to pat-* ids); mobile gaps (touch toolbox scroll, landscape
+  crampedness, touch equivalents for keyboard/debug shortcuts).
+- **design/sound.md** — the channel model (meaning → audio channel), the
+  plucks decision, the derivation ladder (size delta → operator multiset →
+  pattern melody), pan sketch; open: undo/redo sound.
+- **design/drag-target-decomposition.md** — tree-edit vs layout-reaction
+  in drag targets; site-frame rail correction (open, next) and staged
+  choreography (open, designed experiment); figs/rail-variants.png.
+
+## Not recorded elsewhere (canonical here)
+
+### Decisions awaiting Andrew
+- Rails vs Closest drag mechanic: comparison toggle exists (8th corner
+  icon); pick one, delete the other.
+- Debug defaults when tuning ends: drag-debug overlay currently ON by
+  default; Shift+S / Shift+D toggles and `window.__knob` debug global
+  should be removed or gated.
+
+### Game-design track (mechanism sketch in captured-geometry.md)
+- Rule ACQUISITION: pick up / put down transforms, earned via levels
+  (loadout toggles are only the enable/disable half).
+- Loadout conflict detection: geometric-ambiguity checking at enumeration
+  (coincident/near-coincident anchors), warnings or disambiguation;
+  curated presets.
+- Loadout persistence: tools.dragActive resets on restart (Escape) and
+  isn't persisted across sessions.
+
+### Polish (Andrew's observations, not yet acted on)
+- Noolbox recess lip: the bottom turquoise line reads thicker than the
+  top edge; the top has a nice cast shadow below (maybe wants slightly
+  more) but lacks a brightness lip on its upper part. Subtle and easy to
+  overdo — parked. (An edge fade-out was tried and reverted: it dissolved
+  the hard lines that make the recess read as a slot; but the current
+  hard cutoff is also "close but imperfect".)
+- Noolbox exact-fit height (no truncated bottom row) would need
+  JS-driven resizing with a moving bottom lip, or elastic inter-rule
+  gaps — both judged worse than truncation for now; see discussion.
+
+### Pending verdicts / watches
+- Shift+A harmony experiment (sound.md): keep or delete after listening.
+- Sound pan (concept 3, sound.md): queued, unbuilt.
+- Adjacent-possible previews: blur-at-rest/sharpen-on-hover fixed and
+  icon moved top-left — Andrew to judge whether the feature earns its
+  keep or gets deleted.
+- Stuck-mid-tween drag state (reported, never reproduced in three
+  scripted chaos campaigns): guards landed — if it recurs, check the
+  console for "manual_start: empty before-capture" and whether
+  window.__knob.frames is still advancing; either datum bisects the
+  hypothesis space.
+- Die loses blue tint during merge flights: diagnosis + candidate fix
+  in captured-geometry.md findings (backdrop baking); Andrew to call.
+
+### Icon workflow (idea, unbuilt)
+- Trying icon candidates in context: fetch SVGs by concept from the
+  Iconify API (aggregates 200+ open sets, no auth:
+  api.iconify.design/<set>/<name>.svg) into assets/icons/candidates/,
+  plus a one-page "icon lab" rendering each candidate at actual corner
+  size with the app's invert filter and hover styling. Noun Project API
+  (Andrew has an account) as the alternative source, same lab.
+
+### Meta
+- Distill the capture-vs-internalize REPORT from captured-geometry.md's
+  findings into a standalone write-up while fresh.
+- Code cleanup nits: unused imports/dead consts (Toolbar, ModelField,
+  palette_1/2, ded), `flipping` dep in package.json.
+
+### Long-horizon (context in memory + first design discussion)
+- Internalization triggers to watch for: vary-style continuous drags,
+  non-CSS layouts, animating layout at 60fps, 3D.
+- Toolbox as a drag surface (tools-as-draggables, palette drags à la
+  stage-builder demo).