@bongos/core 1.24.27 → 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>
@@ -67,6 +89,8 @@
 <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/settings.css

@@ -157,138 +157,8 @@ select.voices__select { min-width: 140px; }
 .settings-btn--discord { background: #5865F2; border-color: #4853c4; color: #ffffff; }
 .settings-btn--discord:hover:not(:disabled) { background: #4853c4; border-color: #4853c4; color: #ffffff; }
 
-/* Specialities panel (task 1003855, ADR 0296). A speciality is a named bundle of
-   knowledge and terms under a craft; this styles the list, the train form and the
-   create form. Tokens only — no literal colours, so light/dark follow the page. */
-.speciality-craft {
-  font-size: 0.78rem;
-  text-transform: lowercase;
-  opacity: 0.72;
-  margin-left: 0.4rem;
-}
-.speciality-badge {
-  font-size: 0.7rem;
-  padding: 0.05rem 0.4rem;
-  border-radius: 0.5rem;
-  margin-left: 0.4rem;
-  border: 1px solid currentColor;
-}
-.speciality-counts { opacity: 0.82; }
-.speciality-card { flex-wrap: wrap; }
-.speciality-train,
-.speciality-create {
-  flex-basis: 100%;
-  margin-top: 0.75rem;
-  padding-top: 0.75rem;
-  border-top: 1px solid var(--rule, rgba(128, 128, 128, 0.25));
-  display: flex;
-  flex-direction: column;
-  gap: 0.6rem;
-}
-.speciality-create__h { margin: 0; font-size: 0.95rem; }
-.speciality-field { display: flex; flex-direction: column; gap: 0.25rem; }
-.speciality-field > span { font-size: 0.85rem; }
-.speciality-field small { display: block; opacity: 0.7; font-weight: normal; }
-.speciality-field input[type='text'],
-.speciality-field select,
-.speciality-field textarea {
-  width: 100%;
-  box-sizing: border-box;
-}
-/* The checkbox row reads as one sentence, so it runs inline rather than stacked. */
-.speciality-field--check { flex-direction: row; align-items: flex-start; gap: 0.5rem; }
-.speciality-field--check input { margin-top: 0.2rem; }
-.speciality-actions { display: flex; gap: 0.5rem; }
-/* What a speciality OFFERS (task 1004404): the owner's pick-list of this
-   instance's skills, each with its plain line. Sixty-odd rows, so the list
-   scrolls inside its own box rather than pushing the form's buttons off-screen;
-   the reading lines keep the measure. */
-.speciality-field input[type='search'] { width: 100%; box-sizing: border-box; }
-.speciality-offer,
-.speciality-offer-box { flex-basis: 100%; display: flex; flex-direction: column; gap: 0.6rem; }
-.speciality-offer { margin-top: 0.75rem; padding-top: 0.75rem; border-top: 1px solid var(--rule); }
-.speciality-offer > *, .speciality-offer-box > * { max-width: var(--measure); }
-.speciality-offer-box > summary { cursor: pointer; font-size: 0.85rem; min-height: 24px; padding-block: 2px; box-sizing: border-box; }
-.speciality-offer-box > summary small { opacity: 0.7; }
-.speciality-offer__choices, #speciality-create-skills { display: flex; flex-direction: column; gap: 0.6rem; }
-.speciality-offer__list {
-  list-style: none;
-  margin: 0;
-  padding: 0 0.25rem 0 0;
-  display: flex;
-  flex-direction: column;
-  gap: 0.5rem;
-  max-height: 24rem;
-  overflow-y: auto;
-  overflow-x: hidden;
-}
-.speciality-offer__list li[hidden] { display: none; }
-.speciality-offer__list strong { font-family: var(--font-mono); font-weight: 600; }
-.speciality-offer__list .speciality-field--check > span { font-size: 0.85rem; line-height: 1.45; }
-/* The adopted contract, shown in full before "Use this" — another builder's prose
-   reaching your sessions is the one thing here that must never be folded away. */
-.speciality-contract { flex-basis: 100%; margin-top: 0.5rem; font-size: 0.85rem; }
-/* 24px tall: the panel was never revealed until task 1004073, so the kit had
-   never measured this toggle; it came back 21px. */
-.speciality-contract > summary { cursor: pointer; opacity: 0.85; min-height: 24px; padding-block: 2px; box-sizing: border-box; }
-.speciality-contract__body {
-  white-space: pre-wrap;
-  margin: 0.4rem 0 0;
-  padding: 0.5rem 0.65rem;
-  border-left: 2px solid var(--rule, rgba(128, 128, 128, 0.35));
-  border-radius: 0;
-  font-family: inherit;
-  opacity: 0.92;
-}
-/* The skills walkthrough (task 1004073, ADR 0310 §3): one offered skill at a
-   time, three answers as a definition list, then a decision. It sits inside the
-   card like the train form, so it inherits the card's ground in both modes. */
-.skill-walk {
-  flex-basis: 100%;
-  margin-top: 0.75rem;
-  padding-top: 0.75rem;
-  border-top: 1px solid var(--rule);
-  display: flex;
-  flex-direction: column;
-  gap: 0.6rem;
-}
-/* The measure caps the reading lines, never the section: a capped flex-basis
-   lets the section fit beside the card's actions instead of wrapping under them. */
-.skill-walk > * { max-width: var(--measure); }
-.skill-walk__progress { margin: 0; font-size: 0.8rem; color: var(--ink-soft); }
-.skill-walk__name { margin: 0; font-family: var(--font-mono); font-size: 1rem; color: var(--ink); }
-.skill-walk__facts { margin: 0; display: grid; gap: 0.2rem 0; }
-.skill-walk__facts dt { font-size: 0.8rem; color: var(--ink-soft); margin-top: 0.4rem; }
-.skill-walk__facts dt:first-child { margin-top: 0; }
-.skill-walk__facts dd { margin: 0; color: var(--ink); line-height: 1.5; }
-.skill-walk__note { font-size: 0.8rem; }
-/* "Leave it off" and "Turn it on" are the panel family's plain pill at EQUAL
-   weight: the default is off, so the page must not lean on the reader toward on.
-   Only "Save my choices" takes the accent. A decision already made reads through
-   aria-pressed when the person steps Back to it. */
-.skill-walk__actions { flex-wrap: wrap; }
-.skill-walk__actions .pbtn[aria-pressed="true"] { border-color: var(--ink-soft); }
-.skill-walk__recap { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: 0.5rem; }
-.skill-walk__recap li { display: flex; flex-wrap: wrap; align-items: baseline; gap: 0 0.4rem; }
-.skill-walk__recap .prow__hint { flex-basis: 100%; margin: 0; }
-.skill-walk__recap strong { font-family: var(--font-mono); font-weight: 600; }
-/* "Finish later" is a way out, not a choice about a skill, so it reads as a quiet
-   link below the decision rather than a third button beside it. */
-.skill-walk__later {
-  align-self: flex-start;
-  background: none;
-  border: 0;
-  padding: 0 0.25rem;
-  margin-inline-start: -0.25rem;
-  min-height: 24px;
-  font: inherit;
-  font-size: 0.8rem;
-  color: var(--ink-soft);
-  text-decoration: underline;
-  text-underline-offset: 3px;
-  cursor: pointer;
-}
-.skill-walk__later:hover { color: var(--ink); }
+/* The specialities panel's rules moved to speciality-tools.css (task 1005052),
+   which Settings links right after this sheet and My agents links too. */
 
 /* ---- Software update (task 1004296) -------------------------------------- */
 /* A version is read digit by digit and compared against another, so it takes the mono