Pin portal v0.3.21: markdown images, optional sign-in, hero centering

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Y42TyF8Zu7NGRR2893vNcZ

.gitea/workflows/deploy.yml

@@ -18,7 +18,7 @@ on:
       - .gitea/workflows/deploy.yml
 
 env:
-  PORTAL_RELEASE: v0.3.4
+  PORTAL_RELEASE: v0.3.21
   INSTANCE: redoal-portal
 
 jobs:
@@ -83,9 +83,16 @@ jobs:
       # No sudo: the runner's unit sets NoNewPrivileges=yes - systemctl
       # talks to PID1 over D-Bus, authorized by the polkit rule scoped
       # to deploy-runner + the app@* unit pattern.
+      # enable: the unit must come back after a host reboot (2026-08-30 a
+      # reboot left both portal instances down - deploys had only ever
+      # started them). Needs the manage-unit-files polkit grant; until
+      # that's on the host the enable is reported and skipped, never a
+      # failed deploy.
       - name: Activate and restart
         run: |
           ln -sfn "/srv/app/$INSTANCE/releases/$PORTAL_RELEASE" /srv/app/$INSTANCE/current
+          systemctl enable app@$INSTANCE.service \
+            || echo "::warning::could not enable app@$INSTANCE (polkit) - unit will not survive a reboot"
           systemctl restart app@$INSTANCE.service
 
       # www redirects to the apex for the same single-cookie-scope

aggregates.yaml

@@ -14,3 +14,27 @@ aggregates:
       unsubscribed: { event: unsubscribed }
     transitions:
       open: [unsubscribed]
+  # Double opt-in: a watcher is pending until the address confirms from
+  # the mail n8n sends (redoal: confirm watching); only open watchers
+  # are told when something lands at their shape.
+  - bucket: redoal_watchers
+    initial: pending
+    states:
+      pending: { event: requested }
+      open: { event: confirmed }
+      unsubscribed: { event: unsubscribed }
+    transitions:
+      pending: [open, unsubscribed]
+      open: [unsubscribed]
+  # Reports on recordings. The relay watches this bucket: a record
+  # moved to "removed" deletes the recording from its store, the varde
+  # pin, and discovery. "kept" closes the report with the recording in
+  # place. Decisions are human, never automatic.
+  - bucket: redoal_reports
+    initial: open
+    states:
+      open: { event: reported }
+      removed: { event: removed }
+      kept: { event: kept }
+    transitions:
+      open: [removed, kept]

hero.js

@@ -18,18 +18,27 @@
 //
 // prefers-reduced-motion freezes the field fully drawn either way.
 
-import { makePaths, drawPaths } from './paths.js';
+import { makePaths, drawPaths, OVERSCAN } from './paths.js';
 
 const STYLE_ID = 'redoal-hero-style';
 const CYCLE_MS = 28000;
 const SEED = 7;
 const COUNT = 47;
 
+const BLEED = `${((OVERSCAN - 1) / 2) * -100}%`;
+
 const STYLE_TEXT = `
+/* The field bleeds 25% past the hero piece on every side. Sideways
+   it is clipped at the header box (clip, not hidden: no scroll
+   container, and overflow-y stays visible) - an element wider than
+   the viewport, even unscrollable, makes phones re-size the layout
+   viewport when it appears, which read as the page jumping as the
+   input loaded. Vertically it may run into the copy below. */
+.hero-module { overflow-x: clip; overflow-y: visible; }
 .redoal-paths {
   position: absolute;
-  inset: 0;
+  inset: ${BLEED};
-  overflow: hidden;
+  overflow: visible;
   pointer-events: none;
   --redoal-t: 0;
   --redoal-seed: ${SEED};

paths.js

@@ -8,6 +8,11 @@
 // engine likes, and unseeded randomness would reshuffle the picture on
 // every repaint.
 
+// The field bleeds past its box: the painted element is this much
+// larger than the hero piece on each axis (25% each side), and the
+// drawing scales to the piece, not the element, so nothing grows.
+export const OVERSCAN = 1.5;
+
 export function mulberry32(seed) {
     let a = seed >>> 0;
     return () => {
@@ -72,48 +77,96 @@ export function turningFunctionToPoints(turning, samples = 14) {
     return pts;
 }
 
+// A path plus the motion that is its own: where it sits, how it
+// spins, how it drifts, how fast it traces itself in. Every rate is
+// an integer number of cycles so the field loops seamlessly at t = 1.
 export function makePaths(seed, count, stops = 10) {
     const rand = mulberry32(seed);
     const paths = [];
     for (let i = 0; i < count; i++) {
-        paths.push(turningFunctionToPoints(createTurningFunction(rand, stops)));
+        const pts = turningFunctionToPoints(createTurningFunction(rand, stops));
+        let cx = 0, cy = 0;
+        for (let k = 0; k < pts.length; k += 2) { cx += pts[k]; cy += pts[k + 1]; }
+        cx /= pts.length / 2;
+        cy /= pts.length / 2;
+        const sign = rand() > 0.5 ? 1 : -1;
+        paths.push({
+            pts,
+            cx,
+            cy,
+            // own turns per cycle: a third sit still, the rest turn one
+            // or two full turns either way over the cycle
+            spin: rand() < 0.33 ? 0 : sign * (1 + Math.floor(rand() * 2)),
+            // slow orbit around its own place, radius in frame units
+            driftR: 0.01 + rand() * 0.03,
+            driftK: 1 + Math.floor(rand() * 3),
+            driftPhase: rand() * Math.PI * 2,
+            // its own wave along the line
+            waveF: 4 + rand() * 6,
+            waveK: 1 + Math.floor(rand() * 2),
+            waveA: 0.004 + rand() * 0.008,
+            // tracing tempo: how many times it redraws itself per cycle
+            tempo: 1 + Math.floor(rand() * 2),
+            phase: rand(),
+        });
     }
     return paths;
 }
 
-// t in [0, 1) is the animation phase. Each path traces itself in over
+// t in [0, 1) is the animation phase. Each path traces itself in at
-// one cycle, offset by its index so the field is always mid-draw, and
+// its own tempo and phase, fades as it completes, turns at its own
-// fades as it completes; the whole field drifts slowly and a soft
+// rate about its own center and drifts on its own small orbit; a wave
-// wave runs through every line. `colors` is [accent, dim] - the
+// with its own frequency runs along it. The tip is interpolated
-// palette comes from the page's own custom properties either way.
+// between samples so a trace glides instead of stepping. `colors` is
+// [accent, dim] - the palette comes from the page's custom properties.
+const smooth = (u) => u * u * (3 - 2 * u);
+
 export function drawPaths(ctx, width, height, paths, t, colors) {
     ctx.clearRect(0, 0, width, height);
-    const s = Math.min(width, height) * 0.9;
+    const s = (Math.min(width, height) / OVERSCAN) * 0.9;
     ctx.save();
     ctx.translate(width / 2, height / 2);
-    ctx.rotate(t * Math.PI * 2 * 0.08);
     ctx.lineWidth = 1;
     ctx.lineCap = 'round';
     ctx.lineJoin = 'round';
-    const n = paths.length;
+    const TAU = Math.PI * 2;
-    const wave = t * Math.PI * 2;
+    for (let i = 0; i < paths.length; i++) {
-    for (let i = 0; i < n; i++) {
+        const p = paths[i];
-        const pts = paths[i];
+        const phase = (t * p.tempo + p.phase) % 1;
-        const phase = (t + i / n) % 1;
+        // ease: quick to appear, long to complete, then fade
-        // ease: quick to appear, long to complete
+        const progress = smooth(Math.min(1, phase * 1.35));
-        const progress = Math.min(1, phase * 1.35);
-        const count = Math.max(2, Math.floor((pts.length / 2) * progress));
         const alpha = phase < 0.85 ? 0.75 : 0.75 * (1 - (phase - 0.85) / 0.15);
+        const total = p.pts.length / 2;
+        const tip = 1 + (total - 1) * progress; // fractional sample index
+        const whole = Math.floor(tip);
+        const frac = tip - whole;
+
+        const angle = p.spin * TAU * t;
+        const dx = Math.cos(p.driftPhase + p.driftK * TAU * t) * p.driftR;
+        const dy = Math.sin(p.driftPhase + p.driftK * TAU * t) * p.driftR;
+        const wave = p.waveK * TAU * t;
+
+        ctx.save();
+        ctx.translate((p.cx + dx) * s, (p.cy + dy) * s);
+        ctx.rotate(angle);
         ctx.strokeStyle = i % 3 === 0 ? colors[0] : colors[1];
         ctx.globalAlpha = alpha * (i % 3 === 0 ? 1 : 0.55);
         ctx.beginPath();
-        for (let k = 0; k < count; k++) {
+        const at = (k) => {
-            const x = pts[k * 2], y = pts[k * 2 + 1];
+            const x = p.pts[k * 2] - p.cx, y = p.pts[k * 2 + 1] - p.cy;
-            const wy = y + Math.sin(x * 7 + wave + i) * 0.008;
+            return [x, y + Math.sin(x * p.waveF + wave) * p.waveA];
-            if (k === 0) ctx.moveTo(x * s, wy * s);
+        };
-            else ctx.lineTo(x * s, wy * s);
+        for (let k = 0; k <= Math.min(whole, total - 1); k++) {
+            const [x, y] = at(k);
+            if (k === 0) ctx.moveTo(x * s, y * s);
+            else ctx.lineTo(x * s, y * s);
+        }
+        if (whole < total - 1 && frac > 0) {
+            const [ax, ay] = at(whole), [bx, by] = at(whole + 1);
+            ctx.lineTo((ax + (bx - ax) * frac) * s, (ay + (by - ay) * frac) * s);
         }
         ctx.stroke();
+        ctx.restore();
     }
     ctx.restore();
 }

questions/exhibition.yaml

@@ -0,0 +1,45 @@
+# The group exhibition at Podium, part of Attac's «Big Tech må vekk»
+# 2026: opens 23 October 2026 at 19:00 and runs for a month. Announced
+# in every header while it runs (portal's event: window); afterwards a
+# followup, and a "post what happened" task lands on /review.
+name: Where can you see it in person?
+description: >
+  redoal is part of the group exhibition at Podium, opening 23 October
+  and running for a month — the art strand of the conference
+  «Big Tech må vekk». Draw on the screens, leave a voice at a shape,
+  hear who came before you.
+event:
+  starts: 2026-10-23T19:00:00+02:00
+  duration: 31d
+  place: Podium, Hausmanns gate 34, Oslo
+alternatives:
+  - name: Come draw on the wall
+    description: >
+      The installation runs the same code as this site, on screens
+      you can stand in front of together — the network at the scale
+      of a room.
+    features:
+      - name: Opening 23 October, 19:00
+        description: >
+          At [Podium](https://podium.enterprises/), Hausmanns gate 34,
+          and up for a month. Come to the opening, or any Saturday
+          or Sunday after.
+        icon: lucide:calendar-days
+      - name: Part of «Big Tech må vekk»
+        description: >
+          Attac's conference on digital counterculture returns to
+          Hausmania — the same building — on 31 October; the
+          exhibition is its art strand. Programme and details on
+          [attac.no](https://attac.no/arrangement/big-tech-ma-vekk-2026/).
+        icon: lucide:megaphone
+      - name: Draw, then listen
+        description: >
+          Draw a shape on the touch screen and arrive at a place.
+          Listen to the voices left there, add your own, and watch
+          your line find the lines drawn before it.
+        icon: lucide:hand
+      - name: Take the zine with you
+        description: >
+          The printed zine sits in the room — six short pieces on what
+          a network like this could mean. Fold one, hand it on.
+        icon: lucide:book-open

questions/index.yaml

@@ -13,12 +13,10 @@ alternatives:
     description: >
       By associating similar movements while facilitating discourse we
       discover signal within chaos. Draw a path — the network answers
-      with the shapes it heard nearby.
+      with the shape it heard, and with the places kept nearby. Pick
-    action: /shape
+      one of those and it becomes your address.
-    # Announced, not yet open: the network answers with echoes today,
+    action: /shape/{curve.key}
-    # what follows a shape is still being built.
+    consequence: [Go to the place]
-    disabled: true
-    consequence: [Find what follows]
     record_as: redoal_gestures
     encouragements:
       - What you don't know — your collaborators will.
@@ -36,10 +34,6 @@ alternatives:
             type: gesture
             relay: wss://relay.redoal.com
             optional: true
-          - name: email
-            label: Email, if the echoes should reach you later
-            type: email
-            optional: true
 
   - name: Meet a network you carry in your hand
     description: >
@@ -83,15 +77,25 @@ alternatives:
           script arrives on the same terms as everyone else — that is
           the whole entry requirement.
         icon: lucide:hand
-      - name: Young, and honest about it
+      - name: Carried by iroh, through varde
         description: >
-          A prototype and an artwork before it is a product. The
+          What is left at a place is kept and mirrored by
-          gesture math, the fingerprints, the voice recordings, and the
+          [varde](https://project.uhhm.no/uhhm/varde), a small
-          machine-to-machine fetching are real and running; the
+          daemon that moves bytes between consenting machines over
+          [iroh](https://iroh.computer) — verified, rate-limited, and
+          legible to the network it runs on. Recordings travel that way,
+          with no company carrying them.
+        icon: lucide:waypoints
+      - name: Built in the open at UHHM
+        description: >
+          [UHHM](https://uhhm.no) builds and carries the gesture math,
+          the relay, and the portal this page runs on — and hosts the
+          network's first node. It is a prototype and an artwork before
+          it is a product: what you can touch is real and running, the
           transport that reaches across the internet is being built
-          now. The edges are rough, and the edges are where the
+          now, and the rough edges are where the interesting questions
-          interesting questions live.
+          live.
-        icon: lucide:sprout
+        icon: lucide:anvil
 
   - name: Follow the build as it lands
     description: >

questions/report/[digest].yaml

@@ -0,0 +1,47 @@
+# One recording, held up for human review: /report/<digest>. Reached
+# from the place page's per-recording link. Filing creates an open
+# record in redoal_reports; the desk decides, and a removal decision
+# deletes the recording from the relay, varde, and discovery.
+name: Should this stay?
+description: >
+  Every voice here was left by a person, and a person looks at every
+  report. Tell us what you heard and why it needs eyes on it — the
+  recording stays reachable until someone has listened and decided.
+alternatives:
+  - name: Ask for a review
+    description: >
+      Goes straight to the review desk. If the recording breaks
+      something — a person's privacy, the law, basic decency — it is
+      removed everywhere this network keeps it.
+    action: /reported
+    consequence: [Send it to review]
+    record_as: redoal_reports
+    encouragements:
+      - A person will listen.
+    features:
+      - name: What you heard
+        description: >
+          A sentence or two is plenty. Leave an email if you want to
+          hear what was decided.
+        icon: lucide:flag
+        requirements:
+          - name: digest
+            label: Recording
+            type: hidden
+            value: "{digest}"
+          - name: reason
+            label: Why
+            type: textarea
+            placeholder: What is wrong with this recording?
+          - name: email
+            label: Email
+            type: email
+            optional: true
+  - name: Go back to listening
+    description: >
+      The place you came from holds the rest of its voices.
+    features:
+      - name: Nothing sent
+        description: >
+          Leaving this page files nothing — only the button does.
+        icon: lucide:undo-2

questions/reported.yaml

@@ -0,0 +1,10 @@
+# Landing after filing a report.
+name: What happens now?
+description: >
+  Your report is on the review desk. A person listens, decides, and
+  the decision acts everywhere this network keeps the recording.
+alternatives:
+  - name: Draw another
+    description: >
+      The paper keeps listening.
+    action: /

questions/review/index.yaml

@@ -37,3 +37,90 @@ alternatives:
           transitions:
             - to: unsubscribed
               label: Unsubscribe
+
+  - name: Voices
+    description: >
+      Recordings left through the web, one answer per upload: the
+      address, the digest, the length. The audio itself lives in the
+      relay's node and in varde.
+    features:
+      - name: ""
+        description: ""
+        resource:
+          source:
+            kind: kv
+            bucket: redoal_voices
+          requires_group: owners
+
+  - name: Reports
+    description: >
+      Recordings a visitor asked a person to listen to. "Remove it"
+      acts for real: the relay watches this bucket and deletes the
+      recording from its store, the varde pin, and discovery. "Keep
+      it" closes the report with the voice in place.
+    action: /review
+    consequence: [Decide]
+    features:
+      - name: ""
+        description: ""
+        resource:
+          source:
+            kind: kv
+            bucket: redoal_reports
+          requires_group: owners
+          transitions:
+            - from: open
+              to: removed
+              label: Remove it
+            - from: open
+              to: kept
+              label: Keep it
+
+  - name: Watchers
+    description: >
+      Who asked to hear from one exact address. Unsubscribing is
+      theirs (the link in their receipt); the desk can retire an
+      address that bounces.
+    action: /review
+    consequence: [Confirm]
+    features:
+      - name: ""
+        description: ""
+        resource:
+          source:
+            kind: kv
+            bucket: redoal_watchers
+          requires_group: owners
+          transitions:
+            - from: pending
+              to: open
+              label: Confirm by hand
+            - from: pending
+              to: unsubscribed
+              label: Drop
+            - from: open
+              to: unsubscribed
+              label: Unsubscribe
+
+  - name: Announced pages
+    description: >
+      Pages with an `event:` window, kept here by portal itself. When a
+      window closes the record becomes a task: post what happened,
+      then mark it done.
+    action: /review
+    consequence: [Confirm]
+    features:
+      - name: ""
+        description: ""
+        resource:
+          source:
+            kind: kv
+            bucket: portal_events
+          requires_group: owners
+          transitions:
+            - from: awaiting_summary
+              to: summarized
+              label: Posted what happened
+            - from: announced
+              to: summarized
+              label: Needs no summary

questions/shape.yaml

@@ -1,32 +0,0 @@
-id: /shape
-route: ^/shape
-followup: true
-name: Where does the path lead?
-description: >
-  Your shape is in the room now. Echoes of it reach whoever draws
-  nearby — and theirs reach you, whenever you come back to draw again.
-alternatives:
-  - name: What just happened
-    description: ""
-    features:
-      - name: An address, not an upload
-        description: >
-          The stroke became a 20-byte gesture key — a compressed
-          encoding of its shape. Similar shapes land on nearby keys;
-          that proximity is the whole network.
-      - name: Nothing to undo
-        description: >
-          A drawn path is a fact, not an account. There is no profile
-          behind it unless you left an email.
-      - name: What arrives here next
-        description: >
-          In the full network a drawing is a place that holds voices —
-          recordings left by whoever came before, and live talk with
-          whoever is standing here now. On this site it holds echoes
-          today; the voices follow.
-
-  - name: Draw another
-    description: >
-      The network gets more interesting with every shape it hears.
-    action: /
-    consequence: [Back to the canvas]

questions/shape/[key].yaml

@@ -0,0 +1,101 @@
+# The place a drawn (or picked) path leads to: /shape/<gesture key>.
+# Reached through the landing alternative's templated action
+# (/shape/{curve.key}); the key is the URL. What is kept here comes
+# from the relay - the first redoal node - over its /place endpoint,
+# and a voice left here goes back the same way (ADR-0015 in redoal).
+name: Where does the path lead?
+description: >
+  This is a place: the 20-byte address your path became — or the one
+  you picked from what the network keeps nearby. Voices left here play
+  here, for whoever draws their way to this shape. What you see on
+  this site is a preview of the app: the same network, reached
+  through a relay instead of your own machine.
+alternatives:
+  - name: Listen to what was left here
+    description: ""
+    features:
+      - name: ""
+        description: ""
+        icon: lucide:ear
+        resource:
+          source:
+            kind: url
+            url: "https://relay.redoal.com/place/{key}"
+          public: true
+          empty: Nothing has been left at this address yet — yours could be the first voice here.
+          jq: >
+            .recordings[] | {name: ((.duration_ms / 1000 | round | tostring) + " seconds of voice"),
+            description: ("sealed by " + .author[0:8] + "… · [have it reviewed](/report/" + .digest + ")"),
+            audio: ("https://relay.redoal.com" + .audio)}
+
+  - name: Leave your voice here
+    description: >
+      A preview of what the app will give you in full. Record in your
+      browser, listen back, and press *Keep it here* — nothing leaves
+      your phone before that. The relay, the network's first node,
+      keeps it at exactly this address and mirrors it on, sealed with
+      its own key on your behalf; a key of your own comes with the app.
+    action: /shape/{voice.key}
+    consequence: [Keep it here]
+    record_as: redoal_voices
+    encouragements:
+      - It stays where you left it.
+    features:
+      - name: ""
+        description: >
+          Up to a minute. Record, listen back, record again if you like
+          — it is sealed as it is once you keep it.
+        icon: lucide:mic
+        requirements:
+          - name: voice
+            label: Voice
+            type: voice
+            relay: wss://relay.redoal.com
+            value: "{key}"
+            optional: true
+
+  - name: Hear from this address
+    description: >
+      The fallback for a phone without the app: one note when
+      something is left at exactly this shape — and nothing about
+      anywhere else.
+    action: /subscribed
+    consequence: [Watch this address]
+    record_as: redoal_watchers
+    encouragements:
+      - Your shape now has a listener.
+    features:
+      - name: Where the note goes
+        description: >
+          The note is about one exact address, so it needs one exact
+          place to land. One mail comes first, asking you to confirm —
+          nothing is sent before you do, and at most one note a day
+          after.
+        icon: lucide:mail
+        requirements:
+          - name: email
+            label: Email
+            type: email
+          - name: key
+            label: Address
+            type: hidden
+            value: "{key}"
+
+  - name: What just happened
+    description: ""
+    features:
+      - name: An address, not an upload
+        description: >
+          The stroke became a 20-byte gesture key — an ordered chain of
+          headings, drawn back for you under the stroke. Similar shapes
+          land on nearby keys; picking a kept place makes its key yours.
+      - name: Nothing to undo
+        description: >
+          A drawn path is a fact, not an account. There is no profile
+          behind it unless you asked to hear from an address.
+
+  - name: Draw another
+    description: >
+      The network gets more interesting with every shape it hears.
+    action: /
+    consequence: [Back to the canvas]

questions/subscribed.yaml

@@ -21,3 +21,12 @@ alternatives:
       bucket: redoal_subscribers
       to: unsubscribed
       label: Unsubscribe me
+
+  - name: Stop watching an address
+    description: >
+      Using the link from a note about a shape? Confirm below and that
+      address goes quiet for you.
+    self_transition:
+      bucket: redoal_watchers
+      to: unsubscribed
+      label: Stop watching

questions/watching.yaml

@@ -0,0 +1,27 @@
+# Landing page of the confirmation mail: /watching?chain=<record>&email=<address>.
+# A followup - never in the nav; the record id in the link is the only
+# way here, and it plus the matching email is what authorizes the
+# transition (portal's self_transition).
+followup: true
+name: Are you watching this address?
+description: >
+  Someone asked to hear from a shape on redoal with your address. Say
+  yes and you get one note when something is left there — nothing
+  else, ever. Say it wasn't you and the request is dropped.
+alternatives:
+  - name: Yes, watch it
+    description: >
+      One note per day at most, only when a recording or a program
+      lands at exactly this shape.
+    self_transition:
+      bucket: redoal_watchers
+      to: open
+      label: Yes, watch it
+
+  - name: That wasn't me
+    description: >
+      The request is dropped and the address stays unused.
+    self_transition:
+      bucket: redoal_watchers
+      to: unsubscribed
+      label: Drop it