@bongos/core 1.24.26 → 1.24.28

package/modules/hall-ui/public/my-agents.css

@@ -164,9 +164,12 @@ html[data-theme="dark"] body[data-page="my-agents"] {
 .ma-group { margin-top: var(--sp-md); }
 .ma-group:first-child { margin-top: 4px; }
 .ma-rows { list-style: none; margin: 0; padding: 0; }
+/* the fact keeps a floor (task 1005052): a row with more chips than fit beside it
+   — session cards, with its way back to the profile — wraps its chips instead of
+   squeezing the fact to a word a line */
 .ma-row {
   display: grid;
-  grid-template-columns: minmax(118px, 160px) minmax(0, 1fr) auto;
+  grid-template-columns: minmax(118px, 160px) minmax(132px, 1fr) auto;
   gap: 6px 18px;
   align-items: center;
   min-height: 48px;
@@ -241,6 +244,74 @@ html[data-theme="dark"] body[data-page="my-agents"] {
 .ma-row--sub { min-height: 40px; padding: 4px 0; }
 .ma-row--sub .ma-row__fact { font-size: 13px; }
 
+/* ---- what it knows: the speciality tools (task 1005052) ----
+   The SAME component Settings mounts (speciality-tools.js; its structure in
+   speciality-tools.css, linked before this sheet). Its markup is named in the
+   panel family's words (.prow, .btn, .pbtn) and this page has no panel.css, so
+   this skin draws those names in this page's own look: a hairline row like the
+   desk's, ghost pills, a chosen walkthrough answer as ink on glass. No accent —
+   on this page salmon would mean "needs you", and nothing here does. */
+.ma-col { display: flex; flex-direction: column; gap: var(--sp-md); min-width: 0; }
+.ma-know .prows { list-style: none; margin: 4px 0 0; padding: 0; }
+.ma-know .prow { display: flex; flex-wrap: wrap; align-items: flex-start; gap: 8px 18px; padding: 12px 0; border-top: var(--line) solid var(--rule-soft); }
+.ma-know .prows > .prow:first-child { border-top: 0; }
+.ma-know .prow__main { flex: 1 1 280px; min-width: 0; }
+.ma-know .prow__label { display: flex; flex-wrap: wrap; align-items: baseline; margin: 0; font-size: 14.5px; font-weight: 500; letter-spacing: -0.01em; color: var(--ink); }
+.ma-know .prow__hint { margin: 4px 0 0; max-width: var(--measure); font-size: 13px; line-height: 1.5; color: var(--ink-soft); }
+.ma-know .prow__actions { display: flex; flex-wrap: wrap; justify-content: flex-end; gap: 6px; }
+.ma-know .speciality-create__h { margin: 4px 0 0; font-size: 14px; font-weight: 500; color: var(--ink); }
+.ma-know .btn,
+.ma-know .pbtn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-height: 30px;
+  min-width: 30px;
+  padding: 0 14px;
+  border: var(--line) solid var(--rule);
+  border-radius: var(--radius-pill);
+  background: none;
+  color: var(--ink-soft);
+  font: inherit;
+  font-size: 13px;
+  font-weight: 400;
+  text-transform: lowercase;
+  white-space: nowrap;
+  cursor: pointer;
+}
+.ma-know .btn:hover:not(:disabled),
+.ma-know .pbtn:hover:not(:disabled) { background: none; color: var(--ink); border-color: var(--ink-faint); }
+.ma-know .btn:disabled,
+.ma-know .pbtn:disabled { background: none; color: var(--ink-faint); border-color: var(--rule-soft); cursor: default; }
+/* the walkthrough's answer you gave, and its one commit, read as a chosen chip */
+.ma-know .pbtn[aria-pressed="true"],
+.ma-know .pbtn--save:not(:disabled) { background: var(--glass-strong); color: var(--ink); border-color: var(--ink-soft); }
+/* the 24px floor, drawn in ink: the create form's "for sale" box and the skill picker */
+.ma-know input[type="checkbox"] { width: 24px; height: 24px; margin: 0; flex: none; accent-color: var(--ink); cursor: pointer; }
+.ma-know .speciality-field > span { color: var(--ink-soft); }
+/* "create a speciality": the form folds away until asked for, so the section opens on what you have */
+.ma-know__new { margin-top: 10px; padding-top: 12px; border-top: var(--line) solid var(--rule-soft); }
+.ma-know__new > summary {
+  display: inline-flex;
+  align-items: center;
+  min-height: 30px;
+  padding: 0 14px;
+  border: var(--line) solid var(--rule);
+  border-radius: var(--radius-pill);
+  font-size: 13px;
+  color: var(--ink-soft);
+  list-style: none;
+  cursor: pointer;
+}
+.ma-know__new > summary::-webkit-details-marker { display: none; }
+.ma-know__new > summary:hover { color: var(--ink); border-color: var(--ink-faint); }
+.ma-know__new[open] > summary { color: var(--ink); background: var(--glass-strong); border-color: var(--ink-soft); }
+.ma-know__new .speciality-create { margin-top: 4px; padding-top: 0; border-top: 0; }
+/* the fold's own label already names it, so the form's "Create one" would say it twice */
+.ma-know__new .speciality-create > .speciality-create__h:first-child { display: none; }
+.ma-know__status { margin: 8px 0 0; font-size: 13px; color: var(--ink-soft); }
+.ma-know__status:empty { display: none; }
+
 /* ---- what the agent reads first ---- */
 .ma-read { margin: 0 0 12px; }
 .ma-read--project { padding: 12px 14px; background: var(--ma-law-wash); border-radius: var(--radius-sm); }

package/modules/hall-ui/public/my-agents.html

@@ -13,6 +13,9 @@
        group head and the foot line (records/oversight-family.md). This page's
        repeated thing is that row at the desk's one-line density. -->
   <link rel="stylesheet" href="/builders/oversight.css">
+  <!-- the speciality tools' structural sheet, shared with Settings (task 1005052);
+       before this page's own, whose .ma-know skin draws them in this page's look -->
+  <link rel="stylesheet" href="/builders/speciality-tools.css">
   <link rel="stylesheet" href="/builders/my-agents.css">
 </head>
 <body data-page="my-agents" data-page-title="My agents">
@@ -38,11 +41,30 @@
         <section class="ma-strict" id="ma-strict" aria-labelledby="ma-strict-h" hidden></section>
 
         <div class="ma-grid">
-          <section class="scroll ma-desk" id="ma-desk" aria-labelledby="ma-desk-h">
-            <h2 class="scroll__h" id="ma-desk-h">Your agents</h2>
-            <p class="scroll__lede" id="ma-desk-lede">One line each. Tap to change; it saves straight away.</p>
-            <div id="ma-rows" aria-live="polite"><p class="hall-loading" role="status">Reading your settings…</p></div>
-          </section>
+          <div class="ma-col">
+            <section class="scroll ma-desk" id="ma-desk" aria-labelledby="ma-desk-h">
+              <h2 class="scroll__h" id="ma-desk-h">Your agents</h2>
+              <p class="scroll__lede" id="ma-desk-lede">One line each. Tap to change; it saves straight away.</p>
+              <div id="ma-rows" aria-live="polite"><p class="hall-loading" role="status">Reading your settings…</p></div>
+            </section>
+
+            <!-- task 1005052: WHAT IT KNOWS — every speciality tool Settings has, from
+                 the SAME component (speciality-tools.js fills these hosts by id). A
+                 section of its own, not desk rows: a desk row holds at most two
+                 buttons, and my-agents.js redraws the desk on every change. Ships
+                 hidden; the component reveals it once its reads answer. -->
+            <section class="scroll ma-know" id="specialities-scroll" aria-labelledby="specialities-h" hidden>
+              <h2 class="scroll__h" id="specialities-h">What it knows</h2>
+              <p class="scroll__lede">A speciality is what you work on, and how you want to be asked about it. The one you use reaches every session where you hold work in its role.</p>
+              <div id="speciality-suggestions"></div>
+              <ul class="prows" id="specialities-rows"></ul>
+              <details class="ma-know__new">
+                <summary>create a speciality</summary>
+                <form id="speciality-create" class="speciality-create"></form>
+              </details>
+              <p class="ma-know__status" id="specialities-status" role="status" aria-live="polite"></p>
+            </section>
+          </div>
 
           <aside class="scroll ma-reads" id="ma-reads" aria-labelledby="ma-reads-h">
             <h2 class="scroll__h" id="ma-reads-h">What your agent reads first</h2>
@@ -62,11 +84,13 @@
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
 <script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-10-30-github-chip"></script>
+<script src="/builders/shell.js?v=2026-11-03-update-pill"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/gov-living.js?v=2026-10-10-real1"></script>
 <script src="/builders/gov-positions.js?v=2026-10-09-positions1"></script>
-<script src="/builders/my-agents.js?v=2026-10-17-tidy"></script>
+<script src="/builders/my-agents.js?v=2026-11-03-defaults"></script>
+<!-- the speciality tools (task 1005052): the one component Settings mounts too -->
+<script src="/builders/speciality-tools.js?v=2026-11-03-shared"></script>
 </body>
 </html>

package/modules/hall-ui/public/my-agents.js

@@ -7,12 +7,19 @@
 // yours. Every row is one of your agent settings, and a project law can LOCK it.
 // Every part of it is a real read (task 1004717: the prototype overlay is gone):
 //   real   EVERY ROW (task 1004714). GET /me's interaction profile, wandering,
-//          model allocation and session cards; GET /me/skill-prefs; GET
-//          /specialities; the sounds switch (off by the owner's call,
-//          .claude/sounds/play.js). Writes go to the real routes (PATCH
-//          /me/interaction|wandering|model-allocation|render|skill-prefs, POST
-//          /specialities/:id/adopt), so in the preview harness they reach its
-//          recorder (scripts/hall-preview/pref-writes.js).
+//          model allocation and session cards; GET /me/skill-prefs; the sounds
+//          switch (off by the owner's call, .claude/sounds/play.js). Writes go to
+//          the real routes (PATCH /me/interaction|wandering|model-allocation|
+//          render|skill-prefs), so in the preview harness they reach its recorder
+//          (scripts/hall-preview/pref-writes.js). Session cards and each skill
+//          voice can go BACK to the default (task 1005052): the first chip clears
+//          your own pick (PATCH ... null), as Settings' "default" choices do.
+//   real   WHAT IT KNOWS (task 1005052): every speciality tool Settings has —
+//          create, train, choose what it offers, adopt (its instructions read in
+//          full first), the skills walkthrough, stop using. Not this file: the
+//          SAME component Settings mounts (speciality-tools.js) fills its own
+//          section; this page only re-reads /me when it says a speciality changed,
+//          so "What your agent reads first" stays true.
 //   real   the project's laws and the locks they put on your settings (task
 //          1004707): GET /me's `laws` block — the very words every session reads —
 //          and `laws.locks`, what each lock did to you, enforced by the server. A
@@ -57,7 +64,7 @@
     'model.main': { name: 'Main session' },
     'model.subagentDefault': { name: 'Helpers' },
     'model.subagentRoutine': { name: 'Routine helpers' },
-    render: { name: 'Session cards', words: { minimal: 'one line', text: 'plain text', standard: 'rich card', rich: 'rich, open' } },
+    render: { name: 'Session cards', words: { '': 'follow my profile', minimal: 'one line', text: 'plain text', standard: 'rich card', rich: 'rich, open' } },
   };
   // The law a habit would become, in the ask-format voice: a short plain sentence.
   const LAW_LINES = {
@@ -70,7 +77,9 @@
     { key: 'talk', title: 'How it talks to you', keys: ['technical_level', 'toolchain_familiarity', 'verbosity', 'machinery', 'render', 'sounds'] },
     { key: 'work', title: 'How your agents work', keys: ['wandering'] },
     { key: 'models', title: 'Which models run', keys: ['model.main', 'model.subagentDefault', 'model.subagentRoutine', 'skills'] },
-    { key: 'know', title: 'What it knows', keys: ['specialities'] },
+    // 'What it knows' (the specialities) is a section of its own since task
+    // 1005052: its tools are more than a desk row's two buttons, and they are the
+    // shared speciality-tools.js component, which this desk's redraw would wipe.
   ];
   // the permission atom that may file a laws vote (POST /government/board/laws)
   const PROPOSE_ATOM = 'board.item.open';
@@ -86,8 +95,8 @@
   const nameFor = (key) => (SETTING[key] ? SETTING[key].name : key);
 
   // ---------- the pure view ----------
-  //   buildView({ me, constitution, presets, skills, specialities, preview,
-  //               proposed, switched, adopted, as, project, now }, { GovLiving, GovPositions })
+  //   buildView({ me, constitution, presets, skills, preview,
+  //               proposed, switched, as, project, now }, { GovLiving, GovPositions })
   //     → { project, positions, strict, groups[], habits[], canPropose, reads, counts }
   // `preview` is a strictness preset key to look at instead of the project's own;
   // `presets` is GET /government/presets' body (task 1004715); `switched` maps a
@@ -132,9 +141,16 @@
         if (!r) return null;
         const levels = arr(r.levels).map((l) => l.value);
         const level = str(r.level || r.derived_level);
+        // task 1005052: your own pick, or none — then the cards follow the level
+        // your interaction profile derives, and "follow my profile" (value '',
+        // written as null) is the chip pressed. A pinned level survives a later
+        // profile change; following does not pin today's.
+        const own = r.override_level == null ? null : str(r.override_level);
         return {
-          key, name: nameFor(key), fact: wordFor(key, level), locked: false, lock: null, cap: null, control: 'chips',
-          value: level, effective: level, options: levels.map((v) => ({ value: v, label: wordFor(key, v), pressed: v === level })),
+          key, name: nameFor(key), fact: wordFor(key, level), note: own === null ? 'follows your profile' : null,
+          locked: false, lock: null, cap: null, control: 'chips', value: own === null ? '' : own, effective: level,
+          options: [{ value: '', label: wordFor(key, ''), pressed: own === null }]
+            .concat(levels.map((v) => ({ value: v, label: wordFor(key, v), pressed: v === own }))),
         };
       }
       if (key === 'sounds') {
@@ -149,19 +165,17 @@
         return {
           key, name: 'Per skill', fact: eff.length + ' skills' + (changed ? ' · ' + changed + ' yours' : ' · all default'),
           locked: false, lock: null, cap: null, control: 'expand', options: [],
-          skills: eff.map((e) => ({
-            key: 'skill.' + e.skill, skill: e.skill, value: e.effective_model,
-            options: arr(sk.allowed_models).map((v) => ({ value: v, label: v, pressed: v === e.effective_model })),
-          })),
-        };
-      }
-      if (key === 'specialities') {
-        const adopted = arr(me.specialities).map((x) => str(x.name)).filter(Boolean)
-          .concat(arr(o.adopted).map(str)).filter((v, i, a) => a.indexOf(v) === i);
-        const offer = arr(o.specialities && o.specialities.specialities).filter((x) => x && x.adoptable !== false).slice(0, 3);
-        return {
-          key, name: 'Specialities', fact: adopted.length ? adopted.join(', ') : 'none yet', locked: false, lock: null, cap: null, control: 'adopt',
-          options: offer.map((x) => ({ value: String(x.id), label: str(x.name).toLowerCase(), pressed: adopted.indexOf(str(x.name)) >= 0 })),
+          // task 1005052: "default" (value '', written as null) clears your own
+          // pick, as Settings' Default does; a model is pressed only if you chose it.
+          skills: eff.map((e) => {
+            const own = e.override_model == null ? null : str(e.override_model);
+            return {
+              key: 'skill.' + e.skill, skill: e.skill, value: e.effective_model,
+              note: own === null ? null : 'default: ' + str(e.default_model),
+              options: [{ value: '', label: 'default', pressed: own === null }]
+                .concat(arr(sk.allowed_models).map((v) => ({ value: v, label: v, pressed: v === own }))),
+            };
+          }),
         };
       }
       return null;
@@ -170,7 +184,7 @@
       const rows = g.keys.map((k) => settingRow(k) || extraRow(k)).filter(Boolean);
       return { key: g.key, title: g.title, rows, source: 'real', locked: rows.filter((r) => r.locked).length };
     }).filter((g) => g.rows.length);
-    const lockableKeys = groups.reduce((a, g) => a.concat(g.rows.filter((r) => r.key !== 'sounds' && r.key !== 'specialities').map((r) => r.key)), []);
+    const lockableKeys = groups.reduce((a, g) => a.concat(g.rows.filter((r) => r.key !== 'sounds').map((r) => r.key)), []);
     const total = lockableKeys.length;
     const lockedNow = groups.reduce((n, g) => n + g.locked, 0);
 
@@ -273,8 +287,9 @@
       return n < 0 ? null : { method: 'PATCH', path: '/me/wandering', body: { wandering: n }, slice: 'wandering' };
     }
     if (key.indexOf('model.') === 0) return { method: 'PATCH', path: '/me/model-allocation', body: { [key.slice(6)]: value }, slice: 'model_allocation' };
-    if (key === 'render') return { method: 'PATCH', path: '/me/render', body: { widgets: value }, slice: 'render' };
-    if (key.indexOf('skill.') === 0) return { method: 'PATCH', path: '/me/skill-prefs', body: { [key.slice(6)]: value }, slice: 'skills' };
+    // '' is the way back to the default: null clears your own pick (task 1005052)
+    if (key === 'render') return { method: 'PATCH', path: '/me/render', body: { widgets: value === '' ? null : value }, slice: 'render' };
+    if (key.indexOf('skill.') === 0) return { method: 'PATCH', path: '/me/skill-prefs', body: { [key.slice(6)]: value === '' ? null : value }, slice: 'skills' };
     return null;
   }
 
@@ -322,7 +337,7 @@
   const LOCK = '<svg class="ma-lock__icon" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="3.5" y="7" width="9" height="6.5" rx="1.5"/><path d="M5.5 7V5.2a2.5 2.5 0 0 1 5 0V7"/></svg>';
   const TICK = '<svg class="ma-tick" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M3.5 8.5l3 3 6-7"/></svg>';
 
-  const S = { me: null, constitution: null, presets: null, skills: null, specialities: null, preview: null, proposed: {}, pending: {}, switched: {}, adopted: [], skillsOpen: false, readAll: false, view: null };
+  const S = { me: null, constitution: null, presets: null, skills: null, preview: null, proposed: {}, pending: {}, switched: {}, skillsOpen: false, readAll: false, view: null };
 
   function asNow() {
     try { return root.sessionStorage.getItem('hall-as') === 'nobody' || /[?&]as=nobody\b/.test(root.location.search) ? 'nobody' : null; }
@@ -330,8 +345,8 @@
   }
   function view() {
     S.view = buildView({
-      me: S.me, constitution: S.constitution, presets: S.presets, skills: S.skills, specialities: S.specialities,
-      preview: S.preview, proposed: S.proposed, pending: S.pending, switched: S.switched, adopted: S.adopted, as: asNow(), project: PROJECT, now: Date.now(),
+      me: S.me, constitution: S.constitution, presets: S.presets, skills: S.skills,
+      preview: S.preview, proposed: S.proposed, pending: S.pending, switched: S.switched, as: asNow(), project: PROJECT, now: Date.now(),
     }, { GovLiving: root.GovLiving, GovPositions: root.GovPositions });
     return S.view;
   }
@@ -345,10 +360,6 @@
     // every lock is a real law, enforced by the server (task 1004714)
     if (row.locked) return '<span class="ma-lock">' + LOCK + '<span>' + esc(row.lock.text) + '</span></span>';
     if (row.control === 'chips') return chipsHtml(row, row.name);
-    if (row.control === 'adopt') {
-      return row.options.length ? '<div class="ma-chips" role="group" aria-label="Adopt a speciality">' + row.options.map((op) =>
-        '<button type="button" class="ma-chip" data-adopt="' + esc(op.value) + '" aria-pressed="' + (op.pressed ? 'true' : 'false') + '"' + (op.pressed ? ' disabled' : '') + '>' + esc(op.pressed ? op.label : '+ ' + op.label) + '</button>').join('') + '</div>' : '';
-    }
     if (row.control === 'expand') {
       return '<button type="button" class="btn-ghost ma-more" data-expand="skills" aria-expanded="' + (S.skillsOpen ? 'true' : 'false') + '" aria-controls="ma-skills">' + (S.skillsOpen ? 'hide' : 'show') + '</button>';
     }
@@ -357,14 +368,15 @@
   function rowHtml(row) {
     // a cap (task 1004714): the chips offer the values under it, and the line says which law
     const sub = (row.cap ? '<span class="ma-row__yours ma-row__cap">' + LOCK + 'capped by ' + esc(row.cap.text) + '</span>' : '') +
-      (row.yours ? '<span class="ma-row__yours">yours: ' + esc(row.yours) + '</span>' : '');
+      (row.yours ? '<span class="ma-row__yours">yours: ' + esc(row.yours) + '</span>' : '') +
+      (row.note ? '<span class="ma-row__yours">' + esc(row.note) + '</span>' : '');
     let html = '<li class="ma-row' + (row.locked ? ' ma-row--locked' : '') + '" data-row="' + esc(row.key) + '">' +
       '<span class="ma-row__name">' + esc(row.name) + TICK + '</span>' +
       '<span class="ma-row__fact"><span>' + esc(row.fact) + '</span>' + sub + '</span>' +
       '<span class="ma-row__act">' + controlHtml(row) + '</span></li>';
     if (row.control === 'expand' && S.skillsOpen && !row.locked) {
       html += '<li class="ma-sub" id="ma-skills"><ul class="ma-rows ma-rows--sub">' + row.skills.map((s) =>
-        '<li class="ma-row ma-row--sub" data-row="' + esc(s.key) + '"><span class="ma-row__name ma-mono">' + esc(s.skill) + TICK + '</span><span class="ma-row__fact"><span>' + esc(s.value) + '</span></span>' +
+        '<li class="ma-row ma-row--sub" data-row="' + esc(s.key) + '"><span class="ma-row__name ma-mono">' + esc(s.skill) + TICK + '</span><span class="ma-row__fact"><span>' + esc(s.value) + '</span>' + (s.note ? '<span class="ma-row__yours">' + esc(s.note) + '</span>' : '') + '</span>' +
         '<span class="ma-row__act">' + chipsHtml({ key: s.key, options: s.options }, s.skill) + '</span></li>').join('') + '</ul></li>';
     }
     return html;
@@ -502,7 +514,9 @@
     const row = findRow(key);
     if (!row || row.locked) return;
     const w = writeFor(key, value, S);
-    const said = (key.indexOf('skill.') === 0 ? key.slice(6) : nameFor(key).toLowerCase()) + ' ' + wordFor(key, value);
+    const skill = key.indexOf('skill.') === 0 ? key.slice(6) : null;
+    const said = value === '' ? (skill ? skill + ' on its default model' : nameFor(key).toLowerCase() + ' follow your profile')
+      : (skill || nameFor(key).toLowerCase()) + ' ' + wordFor(key, value);
     if (!w) return;
     api.request(w.method, API + w.path, { body: w.body }).then((r) => {
       if (r && r.ok && r.data) {
@@ -525,8 +539,8 @@
     if (w.slice === 'interaction' && S.me.interaction) { S.me.interaction.effective = Object.assign({}, S.me.interaction.effective, { [key]: value }); S.me.interaction.stored = Object.assign({}, S.me.interaction.stored, { [key]: value }); }
     if (w.slice === 'wandering' && S.me.wandering) { S.me.wandering.effective_key = value; S.me.wandering.override_level = w.body.wandering; }
     if (w.slice === 'model_allocation' && S.me.model_allocation) S.me.model_allocation.effective = Object.assign({}, S.me.model_allocation.effective, w.body);
-    if (w.slice === 'render' && S.me.render) S.me.render.level = value;
-    if (w.slice === 'skills' && S.skills) arr(S.skills.effective).forEach((e) => { if (e.skill === key.slice(6)) { e.effective_model = value; e.override_model = value; } });
+    if (w.slice === 'render' && S.me.render) Object.assign(S.me.render, value === '' ? { level: S.me.render.derived_level, override_level: null } : { level: value, override_level: value });
+    if (w.slice === 'skills' && S.skills) arr(S.skills.effective).forEach((e) => { if (e.skill === key.slice(6)) { e.effective_model = value === '' ? e.default_model : value; e.override_model = value === '' ? null : value; } });
   }
   function findRow(key) {
     const v = S.view;
@@ -539,16 +553,6 @@
     }
     return null;
   }
-  function adopt(id) {
-    const sp = arr(S.specialities && S.specialities.specialities).find((x) => String(x.id) === String(id));
-    if (!sp) return;
-    api.request('POST', API + '/specialities/' + encodeURIComponent(id) + '/adopt', { body: {} }).then((r) => {
-      if (r && r.ok) {
-        S.adopted.push(str(sp.name)); render(); lit('specialities');
-        toast(sp.name + ' adopted. Its skills stay off until you turn them on.');
-      } else toast('Not adopted' + (r && r.status ? ' (' + r.status + ')' : '') + '. Nothing changed.');
-    }, () => toast('Not adopted: no answer.'));
-  }
   // A habit proposed as a law: a real laws vote (POST /government/board/laws,
   // task 1004706), sat under the constitution in force like any amendment.
   function propose(key) {
@@ -604,9 +608,15 @@
       if (b.hasAttribute('data-set')) { const row = findRow(b.getAttribute('data-set')); const raw = b.getAttribute('data-value'); const opt = row && row.options.find((x) => String(x.value) === raw); if (opt && !opt.pressed) choose(row.key, opt.value); return; }
       if (b.hasAttribute('data-expand')) { S.skillsOpen = !S.skillsOpen; render(); return; }
       if (b.hasAttribute('data-readall')) { S.readAll = !S.readAll; render(); return; }
-      if (b.hasAttribute('data-adopt')) { adopt(b.getAttribute('data-adopt')); return; }
       if (b.hasAttribute('data-propose')) { propose(b.getAttribute('data-propose')); }
     });
+    // The speciality tools (speciality-tools.js, their own section) say when what
+    // a session is sent moved: an adopt, a stop, a skills save. /me carries it,
+    // so read it again and "What your agent reads first" stays true (task 1005052).
+    document.addEventListener('otb:specialities-changed', async () => {
+      const me = await getJSON('/me');
+      if (me && me.builder) { S.me = me; render(); }
+    });
   }
 
   async function boot() {
@@ -618,15 +628,14 @@
       return;
     }
     S.me = me;
-    const [constitution, presets, skills, specialities, room] = await Promise.all([
-      getJSON('/government/constitution'), getJSON('/government/presets'), getJSON('/me/skill-prefs'), getJSON('/specialities'),
+    const [constitution, presets, skills, room] = await Promise.all([
+      getJSON('/government/constitution'), getJSON('/government/presets'), getJSON('/me/skill-prefs'),
       getJSON('/government/board/items'),
     ]);
     S.pending = pendingLaws(room);
     S.presets = presets || null;
     S.constitution = constitution;
     S.skills = skills || null;
-    S.specialities = specialities || null;
     render();
   }
   boot();

package/modules/hall-ui/public/my-agents.states.json

@@ -25,6 +25,24 @@
       "actions": [["wait", 900], ["clickIfVisible", "[data-craft-close]"], ["wait", 300], ["click", "button[data-set=\"verbosity\"][aria-pressed=\"false\"]"], ["wait", 400]],
       "expect": { "visible": [".ma-row[data-saved] .ma-tick"] }
     },
+    "what-it-knows": {
+      "auth": true,
+      "_": "Task 1005052: the speciality tools, the same component Settings mounts. Someone else's speciality (Economics) shows its full instructions open beside its one adopt control; your own (Pricing, in use) carries choose its skills, train, offered skills and stop using. Session cards above follow the profile.",
+      "actions": [["wait", 900], ["clickIfVisible", "[data-craft-close]"], ["wait", 300], ["focus", "#specialities-rows button[data-act=\"adopt\"]"], ["wait", 300]],
+      "expect": { "visible": ["#specialities-scroll", ".speciality-contract[open]", "#specialities-rows button[data-act=\"abandon\"]", "#specialities-rows button[data-act=\"walk\"]", "button[data-set=\"render\"][data-value=\"\"][aria-pressed=\"true\"]"] }
+    },
+    "speciality-walk": {
+      "auth": true,
+      "_": "Adopting Economics opens the skills walkthrough in its card: one skill per step, leave it off or turn it on at equal weight.",
+      "actions": [["wait", 900], ["clickIfVisible", "[data-craft-close]"], ["wait", 300], ["click", "#specialities-rows button[data-act=\"adopt\"]"], ["wait", 700]],
+      "expect": { "visible": [".skill-walk", ".skill-walk__facts", "button[data-walk=\"on\"]", "button[data-walk=\"off\"]"] }
+    },
+    "speciality-forms": {
+      "auth": true,
+      "_": "The owner's tools open in place: Train on Pricing, and the folded create form with its skills picker.",
+      "actions": [["wait", 900], ["clickIfVisible", "[data-craft-close]"], ["wait", 300], ["click", "#specialities-rows button[data-act=\"train\"]"], ["wait", 300], ["click", ".ma-know__new > summary"], ["wait", 300], ["click", "#speciality-create-offer > summary"], ["wait", 900]],
+      "expect": { "visible": ["form.speciality-train", "#speciality-create input[name=\"name\"]", "#speciality-create-skills .speciality-offer__list"] }
+    },
     "nobody": {
       "auth": true,
       "url": "/my-agents?as=nobody",

package/modules/hall-ui/public/primer.html

@@ -113,7 +113,7 @@
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
 <script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-10-30-github-chip"></script>
+<script src="/builders/shell.js?v=2026-11-03-update-pill"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- the shared markdown reader (window.OTBMdReader) — primer.js renders through

package/modules/hall-ui/public/profile.html

@@ -208,7 +208,7 @@
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
 <script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-10-30-github-chip"></script>
+<script src="/builders/shell.js?v=2026-11-03-update-pill"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- task 1004727: the ONE karma vote control every task/idea list renders -->

package/modules/hall-ui/public/project-settings.html

@@ -87,7 +87,7 @@
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
 <script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-10-30-github-chip"></script>
+<script src="/builders/shell.js?v=2026-11-03-update-pill"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/hall-kit.js"></script>

package/modules/hall-ui/public/ranks.html

@@ -74,7 +74,7 @@
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
 <script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-10-30-github-chip"></script>
+<script src="/builders/shell.js?v=2026-11-03-update-pill"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/founding-mark.js?v=2026-09-30-founding"></script>

package/modules/hall-ui/public/roadmap.html

@@ -44,7 +44,7 @@
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
 <script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-10-30-github-chip"></script>
+<script src="/builders/shell.js?v=2026-11-03-update-pill"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- The chart kit and the timeline's series builders (task 1003447). Both MUST

package/modules/hall-ui/public/roster.html

@@ -56,7 +56,7 @@
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
 <script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-10-30-github-chip"></script>
+<script src="/builders/shell.js?v=2026-11-03-update-pill"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- the branding pack's currency label, loaded BEFORE roster.js. -->

package/modules/hall-ui/public/sessions.html

@@ -114,7 +114,7 @@
 <script src="/builders/dom-utils.js?v=2026-10-25-escape"></script>
 <script src="/builders/shell-trail.js?v=2026-10-08-city-tab"></script>
 <script src="/builders/craft-mode.js?v=2026-10-30-market-watch"></script>
-<script src="/builders/shell.js?v=2026-10-30-github-chip"></script>
+<script src="/builders/shell.js?v=2026-11-03-update-pill"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/task-detail.js?v=2026-07-03-taskdetail"></script>

package/modules/hall-ui/public/settings-software-update.js

@@ -7,11 +7,12 @@
 // update channel lets it take; what each version in between brings — and, for the people
 // the upgrade door lets through, an Update button.
 //
-// THE BUTTON LEADS TO THE DOOR; IT IS NOT THE DOOR. Taking an update is the deploy door's
-// two steps (see exactly what moves, then confirm that version) with its health check and
-// auto-rollback (ADR 0293), and on a hosted project that door is on the hub (ADR 0339 D3).
-// A second copy of that flow here would be a second place for its safety rules to drift, so
-// the server names where this project's door is (`door`) and the button goes there.
+// THE BUTTON RUNS THE PILL'S FLOW; IT IS NOT A SECOND DOOR. Taking an update is the deploy
+// door's act, with its health check and auto-rollback (ADR 0293), and on a hosted project that
+// door is on the hub (ADR 0339 D3). Since task 1005041 the button hands this panel's reading to
+// update-pill.js, which takes the update in place (this page names the version; the door moves
+// it), so there is one copy of that flow, not two. The server still names the door (`door`),
+// and the button's href is that door, for a page whose pill script did not load.
 //
 // THE PAGE KNOWS NOTHING (deploy.js's rule, kept). Every version here is the server's reading
 // with the time it was taken. "Up to date" is drawn only from an ok reading with nothing
@@ -125,11 +126,14 @@
     if (!sameOrigin && !/^https?:\/\/[^\s"'<>]+$/i.test(url)) return '';
     let where = '';
     if (!sameOrigin) {
-      try { where = ` on ${new URL(url).host}`; } catch (e) { return ''; }
+      try { where = new URL(url).host; } catch (e) { return ''; }
     }
+    // IN PLACE (task 1005041): the button runs the Update pill's flow (update-pill.js) and the
+    // page stays put; the pill in the top bar shows the progress. The href stays the door's,
+    // so a page whose pill script did not load still reaches the update the old way.
     return `<div class="row-end su-door">
-      <a class="pbtn pbtn--save" id="su-update" href="${escapeHtml(url)}">Update to ${escapeHtml(offered)}${sameOrigin ? '' : ' ↗'}</a>
-      <span class="panel-hint">Opens this project's upgrade${escapeHtml(where)}: you see what would move, confirm it, and it installs, checks itself, and rolls back if the project does not come back healthy.</span>
+      <a class="pbtn pbtn--save" id="su-update" href="${escapeHtml(url)}">Update to ${escapeHtml(offered)}</a>
+      <span class="panel-hint">Takes a few minutes. The project restarts once, checks itself, and goes back to the version it runs now if it does not come back healthy.${where ? ` A small window from ${escapeHtml(where)} opens for a moment to start it.` : ''}</span>
     </div>${door.kind === 'hub' && ask.available ? askHtml(ask, offered, { lead: false }) : ''}`;
   }
 
@@ -236,6 +240,16 @@
     const askBtn = byId('su-ask');
     if (askBtn) askBtn.addEventListener('click', () => askForUpgrade(data, askBtn));
 
+    // The same press as the pill's Update now; only when it took the update in place is the
+    // link's own navigation stopped.
+    const updateBtn = byId('su-update');
+    if (updateBtn) {
+      updateBtn.addEventListener('click', (e) => {
+        const pill = window.OTBUpdatePill;
+        if (pill && pill.updateNow(data, { api })) e.preventDefault();
+      });
+    }
+
     const more = byId('su-more');
     if (more) {
       more.addEventListener('click', () => {