@bongos/core 1.25.17 → 1.25.18

package/modules/public-landing/public/assets/guide-scene.js

@@ -27,309 +27,38 @@
    - write innerHTML, or move anything from script: the waiting dots are CSS, so the world's
      reduced-motion switch (world.css) stops them.
 
-   The state machine (reduce) and the plan reader (readPlan) are pure and exported for
-   tests/landing_guide_scene.mjs; boot() is the DOM half and runs only in a browser. */
+   Since task 1005276 the conversation itself (the state machine, the plan reader, the
+   server's client rules, the doors) is assets/guide-core.js, shared with the plain hall
+   presentation (assets/guide-hall.js); this file is the game's look on top of it, and
+   re-exports the core's pure half for tests/landing_guide_scene.mjs. "Use the simple
+   version" swaps to the hall panel with the same chat. */
 (function (factory) {
   'use strict';
-  var api = factory();
+  var core = typeof module === 'object' && module.exports ? require('./guide-core.js') : window.GuideCore;
+  var api = factory(core);
   if (typeof module === 'object' && module.exports) module.exports = api;
   if (typeof window !== 'undefined' && typeof document !== 'undefined') {
     window.GuideScene = api;
     api.boot(window, document);
   }
-})(function () {
+})(function (core) {
   'use strict';
 
-  var API = '/api/bongos/front-door-guide';
-  var MODULE_KEY = 'front-door-guide';
-  // the server refuses a first message sooner than 1500ms after the start (a bot); wait a
-  // little longer so a clock edge never turns a person into one
-  var MIN_FIRST_MS = 1600;
-  // the chat's { id, token } in local storage: the server's contract keeps it there, not in
-  // session storage, so a closed browser comes back to the same chat
-  var STORE_KEY = 'cb-front-door-guide';
+  var COPY = core.COPY;
   var HELM_FONTS = 'https://fonts.googleapis.com/css2?family=Barlow+Condensed:wght@400;500;600&family=Barlow:wght@400;500&display=swap';
-  var SIGN_UP = 'Sign up and get started';
-
-  // Every sentence the scene says on its own. The guide's replies are the server's.
-  var COPY = {
-    fallback: 'The guide is resting right now. You can still start your project.',
-    lost: 'This chat has ended. You can still start your project.',
-    failed: 'That did not send. Try again.',
-    planFailed: 'Your plan did not come through. Try again.',
-    tooEarly: 'Tell the guide a little about your project first.',
-    empty: 'Type a message first.',
-    tooLong: function (n) { return 'That is too long. Keep it under ' + n + ' characters.'; },
-    tooFast: function (s) { return 'Too quick. Try again in ' + s + (s === 1 ? ' second.' : ' seconds.'); },
-    left: function (left, total) {
-      if (left <= 0) return 'No messages left';
-      return left + ' of ' + total + (total === 1 ? ' message left' : ' messages left');
-    },
-    waitTalk: 'Your guide is thinking',
-    waitPlan: 'Your guide is writing your plan',
-  };
-
-  /* ── is the guide on for this page? The module set the server injected. ── */
-  function guideOn(mods) {
-    return !!(mods && mods.enabled && mods.enabled[MODULE_KEY] === true);
-  }
-
-  /* ── the plan, read leniently. The server's Plan (modules/front-door-guide/plan.js) is
-     { summary, project_type, how_it_works[], modules[{label, summary, why}], steps[{title,
-     detail}], needs[{item, detail}], open_questions[], cost_and_time }: each list becomes a
-     section under its own heading, in that order. Anything else it carries is read as text
-     where it can be and dropped where it cannot; no plan at all is null. ── */
-  var SECTIONS = [
-    ['how_it_works', 'How it works'],
-    ['steps', 'Steps'],
-    ['modules', 'Modules to start with'],
-    ['needs', 'You will need'],
-    ['open_questions', 'Still to decide'],
-  ];
-  function asText(v) {
-    if (typeof v === 'string') return v.trim();
-    if (typeof v === 'number') return String(v);
-    if (v && typeof v === 'object') {
-      var head = [v.title, v.label, v.item, v.name, v.heading].filter(function (s) { return typeof s === 'string' && s.trim(); })[0];
-      var body = [v.why, v.detail, v.text, v.summary, v.description].filter(function (s) { return typeof s === 'string' && s.trim(); })[0];
-      return [head, body].filter(Boolean).map(function (s) { return s.trim(); }).join(': ');
-    }
-    return '';
-  }
-  function asItems(arr) {
-    return (Array.isArray(arr) ? arr : []).map(asText).filter(Boolean).slice(0, 12);
-  }
-  function readPlan(raw) {
-    if (raw == null) return null;
-    if (typeof raw === 'string') return raw.trim() ? { summary: raw.trim(), sections: [], note: '' } : null;
-    if (typeof raw !== 'object' || Array.isArray(raw)) return null;
-    var plan = { summary: asText(raw.summary || ''), sections: [], note: typeof raw.cost_and_time === 'string' ? raw.cost_and_time.trim() : '' };
-    var seen = {};
-    SECTIONS.forEach(function (s) {
-      seen[s[0]] = true;
-      var its = asItems(raw[s[0]]);
-      if (its.length) plan.sections.push({ heading: s[1], items: its });
-    });
-    Object.keys(raw).forEach(function (k) {
-      if (seen[k] || !Array.isArray(raw[k])) return;
-      var its = asItems(raw[k]);
-      if (its.length) plan.sections.push({ heading: '', items: its });
-    });
-    return plan.summary || plan.sections.length ? plan : null;
-  }
-
-  /* ── the state machine. One state object; every event returns a new one. ──
-     phase: closed · starting · chat · sending · planning · ended · fallback
-     A chat that has ended with no plan yet (the plan call failed, or a resumed chat never
-     asked) is 'ended' with plan null: the end strip then offers "Make my plan" again. */
-  function initial() {
-    return { phase: 'closed', messages: [], left: 0, total: 0, maxChars: 1000, plan: null, error: '', fallback: '', conv: null, startedAt: 0, restore: '', saved: '', next: SIGN_UP, sent: 0 };
-  }
-  function copyState(s) {
-    var n = {};
-    Object.keys(s).forEach(function (k) { n[k] = s[k]; });
-    n.messages = s.messages.slice();
-    return n;
-  }
-  function conversationCounts(n, c) {
-    if (!c || typeof c !== 'object') return;
-    if (typeof c.messages_left === 'number') n.left = Math.max(0, c.messages_left);
-    if (typeof c.messages_used === 'number') n.sent = c.messages_used;
-    if (typeof c.messages_used === 'number' && typeof c.messages_left === 'number') n.total = Math.max(n.total, c.messages_used + c.messages_left);
-    if (typeof c.max_message_chars === 'number') n.maxChars = c.max_message_chars;
-  }
-  function takeExtras(n, b) {
-    if (b.saved && typeof b.saved.message === 'string' && b.saved.message) n.saved = b.saved.message;
-    if (b.next && typeof b.next.label === 'string' && b.next.label) n.next = b.next.label;
-    var p = readPlan(b.plan);
-    if (p) n.plan = p;
-  }
-  function toFallback(n, message) {
-    n.phase = 'fallback';
-    n.fallback = message || COPY.fallback;
-    n.error = '';
-    n.restore = '';
-    return n;
-  }
-  function dropLastVisitor(n) {
-    for (var i = n.messages.length - 1; i >= 0; i--) {
-      if (n.messages[i].role === 'visitor') { n.restore = n.messages[i].text; n.messages.splice(i, 1); n.sent = Math.max(0, n.sent - 1); return; }
-    }
-  }
-  function errCode(body) {
-    return body && (body.error && typeof body.error === 'object' ? body.error.code : body.error || body.code);
-  }
-  function reduce(state, ev) {
-    var n = copyState(state || initial());
-    n.restore = '';
-    var b = (ev && ev.body) || {};
-    var ok = ev && ev.status >= 200 && ev.status < 300;
-    switch (ev && ev.type) {
-      case 'start':
-        n.phase = 'starting';
-        n.error = '';
-        return n;
-      case 'started':
-        if (ok && b.mode === 'chat' && b.conversation && b.conversation.id && b.conversation.token) {
-          n.phase = 'chat';
-          n.conv = { id: String(b.conversation.id), token: String(b.conversation.token) };
-          n.startedAt = ev.now || 0;
-          n.total = 0;
-          conversationCounts(n, b.conversation);
-          n.messages = typeof b.greeting === 'string' && b.greeting ? [{ role: 'guide', text: b.greeting }] : [];
-          takeExtras(n, b);
-          return n;
-        }
-        return toFallback(n, b.mode === 'form' ? b.message : '');
-      case 'resumed': {
-        // GET /conversations/:id on load: the transcript (no greeting), the plan if written
-        if (!ok || !b.conversation || !Array.isArray(b.transcript)) return initial();
-        n.conv = ev.conv;
-        n.total = 0;
-        conversationCounts(n, b.conversation);
-        n.messages = b.transcript
-          .filter(function (m) { return m && typeof m.text === 'string' && (m.role === 'visitor' || m.role === 'guide'); })
-          .map(function (m) { return { role: m.role, text: m.text }; });
-        n.sent = Math.max(n.sent, n.messages.filter(function (m) { return m.role === 'visitor'; }).length);
-        takeExtras(n, b);
-        n.phase = b.conversation.status === 'ended' || n.plan ? 'ended' : 'chat';
-        // a resumed chat with nothing said yet is new enough for the bot check to apply
-        n.startedAt = n.sent ? 0 : (ev.now || 0);
-        return n;
-      }
-      case 'send':
-        n.phase = 'sending';
-        n.error = '';
-        n.sent += 1;
-        n.messages.push({ role: 'visitor', text: ev.text });
-        return n;
-      case 'answer': {
-        if (ok) {
-          takeExtras(n, b);
-          if (b.mode === 'chat') {
-            if (b.reply && typeof b.reply.text === 'string') n.messages.push({ role: 'guide', text: b.reply.text });
-            conversationCounts(n, b.conversation);
-            n.phase = n.left > 0 ? 'chat' : 'planning';
-            return n;
-          }
-          if (b.mode === 'ended') {
-            if (b.reply && typeof b.reply.text === 'string') n.messages.push({ role: 'guide', text: b.reply.text });
-            conversationCounts(n, b.conversation);
-            n.left = 0;
-            if (typeof b.message === 'string' && b.message) n.messages.push({ role: 'note', text: b.message });
-            // next_step 'plan': ask for it now; 'sign_up': it already exists
-            n.phase = b.next_step === 'sign_up' && n.plan ? 'ended' : 'planning';
-            return n;
-          }
-          return toFallback(n, b.mode === 'form' ? b.message : '');
-        }
-        var code = errCode(b);
-        if (ev.status === 404) return toFallback(n, COPY.lost);
-        dropLastVisitor(n);
-        n.phase = 'chat';
-        if (ev.status === 400 && code === 'too_long') {
-          n.maxChars = Number(b.max_message_chars) || n.maxChars;
-          n.error = COPY.tooLong(n.maxChars);
-        } else if (ev.status === 400 && code === 'empty') {
-          n.error = COPY.empty;
-        } else if (ev.status === 429) {
-          n.error = COPY.tooFast(Math.max(1, Math.ceil(Number(b.retry_after_seconds) || 5)));
-        } else {
-          n.error = COPY.failed;
-        }
-        return n;
-      }
-      case 'failed':
-        dropLastVisitor(n);
-        n.phase = n.conv ? 'chat' : 'fallback';
-        if (n.phase === 'fallback') n.fallback = COPY.fallback;
-        else n.error = COPY.failed;
-        return n;
-      case 'plan':
-        n.phase = 'planning';
-        n.error = '';
-        return n;
-      case 'planned': {
-        if (ok && b.mode === 'plan') {
-          takeExtras(n, b);
-          conversationCounts(n, b.conversation);
-          n.left = 0;
-          n.phase = 'ended';
-          return n;
-        }
-        if (ok && b.mode === 'form') return toFallback(n, b.message);
-        if (ev.status === 404) return toFallback(n, COPY.lost);
-        if (ev.status === 409 && errCode(b) === 'too_early') { n.phase = 'chat'; n.error = COPY.tooEarly; return n; }
-        // anything else: the chat is over but the plan can be asked for again
-        n.phase = 'ended';
-        n.error = ev.status === 429 ? COPY.tooFast(Math.max(1, Math.ceil(Number(b.retry_after_seconds) || 5))) : COPY.planFailed;
-        return n;
-      }
-      default:
-        return n;
-    }
-  }
-
-  // how long the first send must still wait (0 once the bot check is behind us)
-  function firstSendWait(state, now) {
-    if (state.sent || !state.startedAt) return 0;
-    return Math.max(0, state.startedAt + MIN_FIRST_MS - now);
-  }
-
-  function readStore(win) {
-    try {
-      var raw = JSON.parse(win.localStorage.getItem(STORE_KEY) || 'null');
-      return raw && typeof raw.id === 'string' && typeof raw.token === 'string' ? raw : null;
-    } catch (e) { return null; }
-  }
-  function writeStore(win, conv) {
-    try {
-      if (conv) win.localStorage.setItem(STORE_KEY, JSON.stringify({ id: conv.id, token: conv.token }));
-      else win.localStorage.removeItem(STORE_KEY);
-    } catch (e) { /* storage off: the chat still works, it just does not come back */ }
-  }
 
   /* ──────────────────────────── the DOM half ──────────────────────────── */
   function boot(win, doc) {
     var scene = doc.getElementById('guide');
-    if (!scene || !guideOn(win.__MODULES__)) return;
+    if (!scene || !core.guideOn(win.__MODULES__)) return;
+    var ctl = core.controller(win, doc);
+    if (!ctl) return;
     var $ = function (name) { return scene.querySelector('[data-gd="' + name + '"]'); };
     var log = $('log'), err = $('err'), form = $('form'), text = $('text'), hp = $('website');
     var send = $('send'), end = $('end'), go = $('go'), left = $('left'), segs = $('segs');
     var planBody = $('plan-body'), planToggle = $('plan-toggle'), planClose = $('plan-close');
     var makePlan = $('make-plan'), againPlan = $('plan-again'), saved = $('saved');
-    var state = initial();
-    var chatOK = false;      // the status read said 'chat'
-    var opener = null;
-    var limits = null;
-
-    function json(method, url, body, headers) {
-      var h = { accept: 'application/json' };
-      if (body) h['content-type'] = 'application/json';
-      Object.keys(headers || {}).forEach(function (k) { h[k] = headers[k]; });
-      return win.fetch(url, { method: method, credentials: 'same-origin', headers: h, body: body ? JSON.stringify(body) : undefined })
-        .then(function (res) {
-          return res.json().then(function (b) { return { status: res.status, body: b || {} }; }, function () { return { status: res.status, body: {} }; });
-        });
-    }
-    function convUrl(suffix) { return API + '/conversations/' + encodeURIComponent(state.conv.id) + (suffix || ''); }
-
-    // ask once, on load, whether the guide can talk: a click must never wait on it
-    json('GET', API + '/status').then(function (r) {
-      chatOK = r.status === 200 && r.body.mode === 'chat';
-      limits = r.body.limits;
-    }, function () { chatOK = false; });
-    // and pick up a chat this browser already holds
-    var held = readStore(win);
-    if (held) {
-      json('GET', API + '/conversations/' + encodeURIComponent(held.id), null, { 'x-guide-token': held.token }).then(function (r) {
-        if (state.phase !== 'closed') return;
-        if (r.status === 404 || r.status === 400) { writeStore(win, null); return; }
-        state = reduce(state, { type: 'resumed', status: r.status, body: r.body, conv: held, now: Date.now() });
-        // a held chat can always be shown, even once the day's budget says 'form'
-        if (state.conv) chatOK = true;
-      }, function () { /* offline: a click starts fresh or falls back */ });
-    }
+    var simple = $('switch');
 
     function el(tag, cls, txt) {
       var e = doc.createElement(tag);
@@ -348,7 +77,7 @@
       wait.appendChild(p);
       return wait;
     }
-    function paintLog() {
+    function paintLog(state) {
       clear(log);
       state.messages.forEach(function (m) {
         var li = el('li', 'gd__msg gd__msg--' + m.role);
@@ -367,7 +96,8 @@
       log.scrollTop = log.scrollHeight;
     }
 
-    function paintCount() {
+    function paintCount(state) {
+      var limits = ctl.limits();
       var total = state.total || (limits && limits.max_messages) || 0;
       var shown = state.phase !== 'fallback' && state.phase !== 'starting' && total > 0;
       left.hidden = !shown;
@@ -378,15 +108,11 @@
       for (var i = 0; i < total; i++) segs.appendChild(el('span', 'gd__seg' + (i < total - state.left ? ' gd__seg--used' : '')));
     }
 
-    function paintPlan() {
+    function paintPlan(state) {
       clear(planBody);
       var plan = state.plan;
       if (!plan) {
-        var wait = state.phase === 'planning' ? 'Your guide is writing your plan.'
-          : state.phase === 'ended' ? 'No plan yet.'
-          : state.phase === 'fallback' ? 'No plan to show.'
-          : 'When the chat ends, your guide writes your plan here.';
-        planBody.appendChild(el('p', 'gd__planwait', wait));
+        planBody.appendChild(el('p', 'gd__planwait', COPY.planWait(state.phase)));
       } else {
         if (plan.summary) planBody.appendChild(el('p', 'gd__plansum', plan.summary));
         plan.sections.forEach(function (s) {
@@ -401,11 +127,11 @@
       saved.hidden = !state.saved || state.phase === 'fallback';
     }
 
-    function paint() {
+    function paint(state) {
       scene.setAttribute('data-phase', state.phase);
-      paintLog();
-      paintCount();
-      paintPlan();
+      paintLog(state);
+      paintCount(state);
+      paintPlan(state);
       var talking = state.phase === 'chat' || state.phase === 'sending' || state.phase === 'starting';
       form.hidden = !talking;
       end.hidden = talking;
@@ -422,14 +148,6 @@
       scene.classList.toggle('gd--done', state.phase === 'ended' && !!state.plan);
     }
 
-    function dispatch(ev) {
-      state = reduce(state, ev);
-      if (ev.type === 'started' && state.conv) writeStore(win, state.conv);
-      if (state.phase === 'fallback' && (ev.status === 404)) writeStore(win, null);
-      paint();
-      if (state.phase === 'planning' && ev.type !== 'plan') askPlan();
-    }
-
     /* the Helm faces: loaded the first time the scene opens, never on a plain visit */
     function loadFaces() {
       if (doc.querySelector('link[data-gd-faces]')) return;
@@ -446,121 +164,80 @@
         function (n) { return n.offsetParent !== null; });
     }
 
-    function open(door) {
-      opener = door;
+    function show() {
       loadFaces();
+      // the simple version is offered only when the page carries it
+      if (simple) simple.hidden = !ctl.has('hall');
       scene.hidden = false;
       doc.documentElement.classList.add('gd-open');
-      if (state.phase === 'closed') {
-        dispatch({ type: 'start' });
-        json('POST', API + '/conversations', { website: hp.value }).then(function (r) {
-          dispatch({ type: 'started', status: r.status, body: r.body, now: Date.now() });
-          focusFirst();
-        }, function () {
-          dispatch({ type: 'started', status: 0, body: {} });
-          focusFirst();
-        });
-      } else {
-        paint();
-      }
-      focusFirst();
+    }
+    function hide() {
+      scene.hidden = true;
+      setPlan(false);
+      doc.documentElement.classList.remove('gd-open');
     }
     function focusFirst() {
       if (scene.hidden) return;
       var target = !text.disabled && !form.hidden ? text : (!end.hidden && !go.hidden ? go : $('close'));
       try { target.focus(); } catch (e) { /* not focusable yet */ }
     }
-    function close() {
-      scene.hidden = true;
-      setPlan(false);
-      doc.documentElement.classList.remove('gd-open');
-      if (opener) { try { opener.focus(); } catch (e) { /* gone */ } }
-    }
     function setPlan(on) {
       scene.classList.toggle('gd--plan', !!on);
       planToggle.setAttribute('aria-expanded', on ? 'true' : 'false');
       if (on) { try { planClose.focus(); } catch (e) { /* hidden */ } }
     }
 
+    ctl.addView('game', {
+      show: show,
+      hide: hide,
+      paint: paint,
+      focusFirst: focusFirst,
+      website: function () { return hp.value; },
+      // one column: the plan is the reward, so it opens by itself
+      onPlanned: function (state) { if (state.plan && planToggle.offsetParent !== null) setPlan(true); },
+    });
+
     function submit() {
-      if (state.phase !== 'chat') return;
+      if (ctl.state().phase !== 'chat') return;
       var words = text.value.trim();
-      if (!words) { state.error = COPY.empty; paint(); return; }
-      var wait = firstSendWait(state, Date.now());
-      var conv = state.conv;
-      text.value = '';
-      dispatch({ type: 'send', text: words });
-      win.setTimeout(function () {
-        json('POST', API + '/conversations/' + encodeURIComponent(conv.id) + '/messages', { token: conv.token, text: words, website: hp.value })
-          .then(function (r) { dispatch({ type: 'answer', status: r.status, body: r.body }); },
-                function () { dispatch({ type: 'failed' }); })
-          .then(focusFirst);
-      }, wait);
-    }
-
-    // the plan: asked for once the chat ends (or the visitor presses "Make my plan");
-    // the server writes it once and re-reads it for free after that
-    var asking = false;
-    function askPlan() {
-      if (asking || !state.conv) return;
-      asking = true;
-      if (state.phase !== 'planning') dispatch({ type: 'plan' });
-      json('POST', convUrl('/plan'), { token: state.conv.token, website: hp.value })
-        .then(function (r) { asking = false; dispatch({ type: 'planned', status: r.status, body: r.body }); },
-              function () { asking = false; dispatch({ type: 'planned', status: 0, body: {} }); })
-        .then(function () {
-          focusFirst();
-          // one column: the plan is the reward, so it opens by itself
-          if (state.plan && planToggle.offsetParent !== null) setPlan(true);
-        });
+      if (words) text.value = '';
+      ctl.send(words);
     }
 
-    /* the doors: a click is the guide only when everything says it can talk */
-    doc.addEventListener('click', function (e) {
-      var door = e.target && e.target.closest && e.target.closest('[data-guide-door]');
-      if (!door || !chatOK || e.defaultPrevented || e.button !== 0 || e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;
-      e.preventDefault();
-      open(door);
-    });
-
     form.addEventListener('submit', function (e) { e.preventDefault(); submit(); });
     text.addEventListener('keydown', function (e) {
       if (e.key === 'Enter' && !e.shiftKey && !e.isComposing) { e.preventDefault(); submit(); }
     });
-    makePlan.addEventListener('click', askPlan);
-    againPlan.addEventListener('click', askPlan);
-    $('close').addEventListener('click', close);
+    makePlan.addEventListener('click', ctl.askPlan);
+    againPlan.addEventListener('click', ctl.askPlan);
+    $('close').addEventListener('click', ctl.close);
+    if (simple) simple.addEventListener('click', function () { ctl.switchTo('hall'); });
     planToggle.addEventListener('click', function () { setPlan(planToggle.getAttribute('aria-expanded') !== 'true'); });
     planClose.addEventListener('click', function () { setPlan(false); try { planToggle.focus(); } catch (e) { /* hidden */ } });
-    scene.addEventListener('click', function (e) { if (e.target === scene) close(); });
+    scene.addEventListener('click', function (e) { if (e.target === scene) ctl.close(); });
     scene.addEventListener('keydown', function (e) {
       if (e.key === 'Escape') {
         e.preventDefault();
         if (scene.classList.contains('gd--plan')) { setPlan(false); try { planToggle.focus(); } catch (x) { /* hidden */ } }
-        else close();
+        else ctl.close();
         return;
       }
-      if (e.key !== 'Tab') return;
-      var f = focusables();
-      if (!f.length) return;
-      var first = f[0], last = f[f.length - 1];
-      if (e.shiftKey && doc.activeElement === first) { e.preventDefault(); last.focus(); }
-      else if (!e.shiftKey && doc.activeElement === last) { e.preventDefault(); first.focus(); }
+      if (e.key === 'Tab') core.trapTab(doc, focusables(), e);
     });
     var face = scene.querySelector('.gd__face img');
     if (face) face.addEventListener('error', function () { face.hidden = true; });
   }
 
   return {
-    API: API,
-    MIN_FIRST_MS: MIN_FIRST_MS,
-    STORE_KEY: STORE_KEY,
+    API: core.API,
+    MIN_FIRST_MS: core.MIN_FIRST_MS,
+    STORE_KEY: core.STORE_KEY,
     COPY: COPY,
-    guideOn: guideOn,
-    readPlan: readPlan,
-    initial: initial,
-    reduce: reduce,
-    firstSendWait: firstSendWait,
+    guideOn: core.guideOn,
+    readPlan: core.readPlan,
+    initial: core.initial,
+    reduce: core.reduce,
+    firstSendWait: core.firstSendWait,
     boot: boot,
   };
 });

package/modules/public-landing/public/index.html

@@ -46,6 +46,8 @@
 <!-- the start-a-project guide, as a scene in the game (task 1005275): drawn only when the
      front-door-guide module is on and its server can talk -->
 <link rel="stylesheet" href="/assets/guide-scene.css">
+<!-- and plainly, for a visitor who does not want the game (task 1005276) -->
+<link rel="stylesheet" href="/assets/guide-hall.css">
 <style>
 /* ── PAGE-LOCAL SHEET ────────────────────────────────────────────────────
    The composition: how this page arranges the world's sculpture, and nothing
@@ -583,6 +585,8 @@ body{
     --gd-gutter:var(--ds-space-gutter-narrow);--gd-face:56px;--gd-face-img:48px;
     --gd-planbtn:inline-flex;--gd-planx:inline-grid;--gd-go-w:100%;
     --gd-plan-show:none;--gd-plan-pos:absolute;--gd-plan-edge:0px;--gd-talk-under-plan:hidden;
+    /* and its plain twin (assets/guide-hall.css, task 1005276): the whole screen, square */
+    --gd-hall-radius:0;
   }
   :root[data-mode="dark"] body{
     --layer-pos:relative;
@@ -974,6 +978,7 @@ composition A; landing composition v3, picked by the owner 2026-08-27. No roll,
     <section class="gd__talk" aria-labelledby="gdTitle">
       <div class="gd__head">
         <h2 class="gd__title" id="gdTitle">Start a project</h2>
+        <button type="button" class="gd__switch" data-gd="switch" hidden>Use the simple version</button>
         <button type="button" class="gd__x" data-gd="close" aria-label="Close"><svg viewBox="0 0 20 20" aria-hidden="true"><path d="M5 5l10 10M15 5L5 15"/></svg></button>
       </div>
       <div class="gd__who-row">
@@ -1013,6 +1018,43 @@ composition A; landing composition v3, picked by the owner 2026-08-27. No roll,
   </div>
 </div>
 
+<!-- THE GUIDE, PLAIN (task 1005276): the same conversation for a visitor who does not want
+     the game. One chat behind both (assets/guide-core.js); the doors open the game unless
+     this browser picked this one, and each offers the other. Hidden, like the scene. -->
+<div class="gh" id="guideHall" role="dialog" aria-modal="true" aria-labelledby="ghTitle" hidden>
+  <section class="gh__panel" aria-labelledby="ghTitle">
+    <div class="gh__head">
+      <h2 class="gh__title" id="ghTitle">Start a project</h2>
+      <button type="button" class="gh__link" data-gh="switch">Use the game version</button>
+      <button type="button" class="gh__x" data-gh="close" aria-label="Close"><svg viewBox="0 0 20 20" aria-hidden="true"><path d="M5 5l10 10M15 5L5 15"/></svg></button>
+    </div>
+    <p class="gh__left" data-gh="left" aria-live="polite" hidden></p>
+    <div class="gh__body" data-gh="body">
+      <ol class="gh__log" data-gh="log" aria-live="polite" aria-label="Conversation"></ol>
+      <section class="gh__plan" data-gh="plan" aria-labelledby="ghPlanH" hidden>
+        <h3 class="gh__planh" id="ghPlanH">Your plan</h3>
+        <div data-gh="plan-body"></div>
+      </section>
+      <p class="gh__saved" data-gh="saved" hidden></p>
+    </div>
+    <p class="gh__err" data-gh="err" role="alert" hidden></p>
+    <form class="gh__say" data-gh="form" hidden>
+      <label class="gh__label" for="ghText">Your message</label>
+      <textarea class="gh__text" id="ghText" data-gh="text" rows="3" maxlength="1000" placeholder="What do you want to build?"></textarea>
+      <input class="gh__hp" type="text" name="website" data-gh="website" tabindex="-1" autocomplete="off" aria-hidden="true">
+      <div class="gh__row">
+        <button type="submit" class="door door--go" data-gh="send">Send</button>
+        <button type="button" class="door" data-gh="make-plan" hidden>Make my plan</button>
+        <a class="gh__link" href="/projects?view=new">Skip to sign up</a>
+      </div>
+    </form>
+    <div class="gh__end" data-gh="end" hidden>
+      <button type="button" class="door" data-gh="plan-again" hidden>Make my plan</button>
+      <a class="door door--go" data-gh="go" href="/projects?view=new">Sign up and get started</a>
+    </div>
+  </section>
+</div>
+
 <footer>
   <div class="footrow">
     <p><!--apex-only:start-->A non-profit, capture-resistant commons. <!--apex-only:end-->Built by agents, on Cloud&nbsp;Bongos. <a href="https://www.npmjs.com/package/@bongos/core" target="_blank" rel="noopener">Open source</a> (<a href="https://www.gnu.org/licenses/agpl-3.0.html" target="_blank" rel="noopener">AGPL-3.0</a>).</p>
@@ -1360,8 +1402,11 @@ composition A; landing composition v3, picked by the owner 2026-08-27. No roll,
   });
 })();
 </script>
-<!-- the start-a-project guide (task 1005275) -->
+<!-- the start-a-project guide: the shared conversation, then the game scene (task 1005275)
+     and its plain twin (task 1005276) -->
+<script src="/assets/guide-core.js"></script>
 <script src="/assets/guide-scene.js"></script>
+<script src="/assets/guide-hall.js"></script>
 <!-- the Artist review button: signed-in builders only (task 1004499) -->
 <script src="/assets/artist-review.js" data-hall="{{buildersOrigin}}"></script>
 </body>

package/modules/public-landing/public/projects.html

@@ -2766,7 +2766,7 @@ summary{min-height:24px;padding:3px 0;}
       try { id = new URLSearchParams(location.search).get('id'); } catch (e) {}
       if (id) { manageId = String(id); return 'manage'; }
       try { handedProject = new URLSearchParams(location.search).get('project') || null; } catch (e) {}
-      if (handedProject && /^#m(Delete|Disconnect)$/.test(location.hash || '')) handedSection = location.hash.slice(1);
+      if (handedProject && /^#m(Delete|Disconnect|AppCard)$/.test(location.hash || '')) handedSection = location.hash.slice(1);
       return 'mine';
     }
     return VIEWS[v] ? v : 'map';
@@ -9693,7 +9693,16 @@ summary{min-height:24px;padding:3px 0;}
         if (handedSection) {
           var target = $(handedSection);
           handedSection = null;
-          if (target && target.scrollIntoView) target.scrollIntoView({ block: 'start' });
+          /* the app card (#mAppCard, the hall's Connect Render link — task 1004571) is
+             drawn by its own read below, so it is still hidden here: land on it once shown */
+          if (target && target.hidden && typeof MutationObserver === 'function') {
+            var seen = new MutationObserver(function () {
+              if (target.hidden) return;
+              seen.disconnect();
+              if (target.scrollIntoView) target.scrollIntoView({ block: 'start' });
+            });
+            seen.observe(target, { attributes: true, attributeFilter: ['hidden'] });
+          } else if (target && target.scrollIntoView) target.scrollIntoView({ block: 'start' });
         }
         /* the SECOND, GitHub-backed read — fired only here (entry + tab
            return), never from renderManage, which the fetch-free tick calls */