aimeat 1.25.1 → 1.26.0

package/dist/public/views/portal-dev.js

@@ -7,6 +7,7 @@
  *   v1.1.0 — 2026-06-02 — Component unification (#11): node-badge dot uses
  *     canonical <StatusDot status="online" /> instead of bespoke .dv-dot
  *     (which had a hardcoded #22c55e — now tokenized via the component).
+ *   v1.1.1 — 2026-06-19 — JSDoc type annotations for frontend type-checking
  */
 import { h } from 'preact';
 import { useState, useEffect, useRef, useCallback } from 'preact/hooks';
@@ -23,7 +24,9 @@ const NODE_URL = window.location.origin;
 /* ══════════════════════════════════════════════
    i18n — use SPA i18n.js t() with 'dev.' prefix
    ══════════════════════════════════════════════ */
-function dt(key) {
+// `locale` is accepted for call-site symmetry but currently unused — t() resolves against
+// the active global locale, not a per-call override.
+function dt(key, _locale) {
   return globalT('dev.' + key);
 }
 
@@ -612,7 +615,7 @@ function CommunityApps({ locale, isLoggedIn, session }) {
                            style="background:var(--bg);border:1px solid var(--border);border-radius:4px;padding:.25rem .4rem;color:var(--text);font-size:.8rem;width:120px" />
                     <a href="#" onClick=${e => {
                       e.preventDefault();
-                      const code = document.getElementById(codeInputId)?.value?.trim();
+                      const code = /** @type {HTMLInputElement} */ (document.getElementById(codeInputId))?.value?.trim();
                       if (!code) return;
                       window.open(NODE_URL + app.download_url + '?code=' + encodeURIComponent(code));
                     }} style="font-size:.85rem">\u2b07 ${dt('download', locale)}</a>

package/dist/public/views/portal.js

@@ -5,6 +5,7 @@
  * @version-history
  *   v1.1.0 — 2026-06-02 — Component unification (#11): live-feed header dot uses
  *     canonical <StatusDot status="live" /> instead of bespoke .live-dot.
+ *   v1.1.1 — 2026-06-19 — JSDoc type annotations for frontend type-checking
  */
 import { h } from 'preact';
 import { useState, useEffect, useRef, useCallback } from 'preact/hooks';
@@ -1180,7 +1181,7 @@ function TheWorld({ navigate }) {
     // Trigger login modal
     const slot = document.getElementById('headerAuth');
     const loginBtn = slot && slot.querySelector('#aimeat-login-btn');
-    if (loginBtn) loginBtn.click();
+    if (loginBtn) /** @type {HTMLElement} */ (loginBtn).click();
   }, [navigate]);
 
   return html`
@@ -1289,7 +1290,7 @@ export default function Portal({ navigate, locale }) {
       // Trigger login via the header auth button
       const loginBtn = document.querySelector('#headerAuth #aimeat-login-btn');
       if (loginBtn) {
-        loginBtn.click();
+        /** @type {HTMLElement} */ (loginBtn).click();
         // After login, the aimeat-auth-change event will fire and we re-check
         const handler = () => {
           const s = getCurrentSession();

package/dist/public/views/profile/agents/shared-board.js

@@ -33,10 +33,10 @@ const BUCKETS = [
 
 export default function SharedBoard({ agents, onboardings, onAgentClick }) {
   const [bucketFilter, setBucketFilter] = useState(null);
-  if (!agents || agents.length === 0) return null;
 
+  // Hooks must run unconditionally before any early return (Rules of Hooks).
   const agentStates = useMemo(() => {
-    const rows = agents.map(agent => {
+    const rows = (agents || []).map(agent => {
       const state = detectAgentState(agent, onboardings?.[agent.name]);
       return { agent, state, bucket: BUCKET_OF[state] || 'quiet', onboarding: onboardings?.[agent.name] };
     });
@@ -63,6 +63,8 @@ export default function SharedBoard({ agents, onboardings, onAgentClick }) {
     return tagCounts;
   }, [agentStates]);
 
+  if (!agents || agents.length === 0) return null;
+
   return html`
     <div class="pf-agd-board">
       <div class="pf-agd-board-legend">

package/dist/public/views/profile/agents/tab-messages.js

@@ -18,6 +18,7 @@
  *   v1.2.0 -- 2026-05-24 -- Add command-reply visual pairing for slash commands
  *   v1.1.0 -- 2026-05-24 -- M7: visual distinction for command messages (slash prefix)
  *   v1.0.0 -- 2026-05-24 -- Initial creation for Agent Detail Tab-View
+ *   v1.6.1 -- 2026-06-19 -- JSDoc type annotations for frontend type-checking
  */
 
 import { h } from 'preact';
@@ -47,6 +48,17 @@ function threadLabel(thread) {
 function CommandPalette({ commands, onSend }) {
   const [expanded, setExpanded] = useState(false);
 
+  // Hooks must run unconditionally before any early return (Rules of Hooks).
+  const categories = useMemo(() => {
+    const cats = {};
+    for (const cmd of (commands || [])) {
+      const cat = cmd.category || t('profile.agents.detail.messages.commands.defaultCategory');
+      if (!cats[cat]) cats[cat] = [];
+      cats[cat].push(cmd);
+    }
+    return cats;
+  }, [commands]);
+
   if (!commands || commands.length === 0) {
     // No registered commands → one quiet line, not an expandable empty box.
     return html`
@@ -57,16 +69,6 @@ function CommandPalette({ commands, onSend }) {
     `;
   }
 
-  const categories = useMemo(() => {
-    const cats = {};
-    for (const cmd of commands) {
-      const cat = cmd.category || t('profile.agents.detail.messages.commands.defaultCategory');
-      if (!cats[cat]) cats[cat] = [];
-      cats[cat].push(cmd);
-    }
-    return cats;
-  }, [commands]);
-
   return html`
     <div class="pf-agd-commands">
       <div class="pf-agd-commands-header" onClick=${() => setExpanded(!expanded)}>
@@ -332,7 +334,7 @@ export default function TabMessages({ agent, agentName, session, showToast }) {
       ${messages.length > 0 && html`
         <div class="pf-agd-msg-history" ref=${historyRef}>
           ${(() => {
-            const sorted = [...messages].sort((a, b) => new Date(a.createdAt || 0) - new Date(b.createdAt || 0));
+            const sorted = [...messages].sort((a, b) => +new Date(a.createdAt || 0) - +new Date(b.createdAt || 0));
             // An option-prompt is answerable only while it is the newest message
             // in its thread (any later message locks it). Map each thread to its
             // last message id, and each prompt_id to the owner's chosen text.

package/dist/public/views/profile/agents-messages-subtab.js

@@ -16,6 +16,7 @@
  *   v1.2.0 -- 2026-05-22 -- Fix: use camelCase field names from API (createdAt, metadata.tokensUsed)
  *   v1.1.0 -- 2026-05-22 -- Show timestamp on messages, sort oldest-first (chat-style)
  *   v1.0.0 -- 2026-05-22 -- Initial creation for Agent Dashboard Phase 3
+ *   v1.3.1 -- 2026-06-19 -- JSDoc type annotations for frontend type-checking
  */
 import { h } from 'preact';
 import { useState, useEffect, useRef } from 'preact/hooks';
@@ -262,7 +263,7 @@ export default function AgentMessagesSubtab({ agentName, session, showToast }) {
   const lastSeen = null; // TODO Phase 2+: derive from agent.last_seen
 
   // Oldest-first (chat order).
-  const sorted = [...messages].sort((a, b) => new Date(a.createdAt || 0) - new Date(b.createdAt || 0));
+  const sorted = [...messages].sort((a, b) => +new Date(a.createdAt || 0) - +new Date(b.createdAt || 0));
   // Latest message id per thread -> an option-prompt is answerable only while it
   // is the newest message in its thread (any later message locks it).
   const lastIdByThread = {};

package/dist/public/views/profile/apps-tab.js

@@ -4,6 +4,7 @@
  * @version-history
  *   v1.1.0 — 2026-03-19 — Add launch button to My Apps list
  *   v1.0.0 — 2026-03-17 — Refactor: replace inline styles with CSS utility classes (card-h3, text-caption, etc.)
+ *   v1.1.1 — 2026-06-19 — JSDoc type annotations for frontend type-checking
  */
 import { h } from 'preact';
 import { useState, useEffect, useRef } from 'preact/hooks';
@@ -42,7 +43,7 @@ export default function AppsTab({ session, showToast, onStats }) {
 
   async function handleUpload(file, screenshot, accessCode) {
     if (!file) { showToast(t('profile.apps.selectFile'), true); return; }
-    const readFile = (f) => new Promise(res => { const r = new FileReader(); r.onload = () => res(r.result.split(',')[1]); r.readAsDataURL(f); });
+    const readFile = (f) => new Promise(res => { const r = new FileReader(); r.onload = () => res(/** @type {string} */ (r.result).split(',')[1]); r.readAsDataURL(f); });
     const contentBase64 = await readFile(file);
     const opts = {};
     if (accessCode) opts.accessCode = accessCode;

package/dist/public/views/profile/boards-tab.js

@@ -34,6 +34,9 @@ export default function BoardsTab({ session, showToast }) {
   const [boardView, setBoardView] = useState(null);
   const [brdSubTab, setBrdSubTab] = useState('mine');
   const [showBrdForm, setShowBrdForm] = useState(false);
+  // Refs used by the board-detail view below — declared unconditionally (Rules of Hooks).
+  const postRef = useRef(null);
+  const memberInputRef = useRef(null);
 
   useEffect(() => {
     if (session) loadMyData();
@@ -176,8 +179,6 @@ export default function BoardsTab({ session, showToast }) {
   }
 
   if (boardView) {
-    const postRef = useRef(null);
-    const memberInputRef = useRef(null);
     const bd = boardView.boardData;
     const showMembers = bd && bd.visibility === 'shared' && isBoardOwner(bd);
     return html`

package/dist/public/views/profile/calibrator-batch.js

@@ -14,6 +14,7 @@
  *   - renderStep4 — Step 4 UI (Synthesis — grouped proposals + A/B/C options)
  * @version-history
  *   v1.0.0 — 2026-03-29 — Initial V2 implementation
+ *   v1.0.1 — 2026-06-19 — lint fixes (misleading-char-class/unused-expression/empty-block)
  */
 import { h } from 'preact';
 import { useState, useEffect, useCallback } from 'preact/hooks';
@@ -40,7 +41,7 @@ import { getBatch, updateBatch, createVersion } from '/js/services/calibrator.js
 
 // ── Helpers ──
 
-async function callModel(projectId, prompt, modelId, { retries = 1, temperature, top_p, max_tokens } = {}) {
+async function callModel(projectId, prompt, modelId, { retries = 1, temperature, top_p, max_tokens } = /** @type {{ retries?: number, temperature?: number, top_p?: number, max_tokens?: number }} */ ({})) {
   for (let attempt = 0; attempt <= retries; attempt++) {
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), 1_800_000); // 30 min
@@ -436,7 +437,7 @@ export default function BatchCard({ batchSummary, index, projectId, project, cur
         const { getVersion } = await import('/js/services/calibrator.js');
         const ver = await getVersion(projectId, batchVersion);
         if (ver?.prompt) batchPrompt = ver.prompt;
-      } catch {}
+      } catch { /* best effort — fall through to the no-prompt guard below */ }
     }
     if (!batchPrompt) { showToast?.('Could not load prompt for this batch\'s version', true); return; }
 

package/dist/public/views/profile/data-wallet-tab.js

@@ -10,6 +10,7 @@
  * @version-history
  *   v1.0.0 — 2026-03-10 — Initial data wallet tab implementation
  *   v1.1.0 — 2026-03-17 — Refactor: replace all inline styles with CSS classes
+ *   v1.1.1 — 2026-06-19 — lint fixes (misleading-char-class/unused-expression/empty-block)
  */
 import { h } from 'preact';
 import { useState, useEffect, useRef } from 'preact/hooks';
@@ -279,7 +280,7 @@ export default function DataWalletTab({ session, showToast }) {
                 <td><input type="checkbox" checked=${selectedConsents.has(cId)}
                   onChange=${(e) => {
                     const next = new Set(selectedConsents);
-                    e.target.checked ? next.add(cId) : next.delete(cId);
+                    if (e.target.checked) next.add(cId); else next.delete(cId);
                     setSelectedConsents(next);
                   }} /></td>
                 <td><span class="dw-code-accent">${escHtml(c.data_pattern || c.pattern || '-')}</span></td>

package/dist/public/views/profile/extensions-tab.js

@@ -23,6 +23,7 @@
  *   v1.4.0 — 2026-06-02 — Component unification (#11): all six extension/instance
  *     status dots use the canonical <StatusDot> instead of bespoke .ext-status-dot
  *     (which had hardcoded #4ade80/#9ca3af — now tokenized via the component).
+ *   v1.4.1 — 2026-06-19 — JSDoc type annotations for frontend type-checking
  */
 import { h } from 'preact';
 import { useState, useEffect } from 'preact/hooks';
@@ -577,18 +578,18 @@ export default function ExtensionsTab({ session, showToast }) {
     try {
       let manifest = '';
       if (manifestMode === 'upload') {
-        const fileInput = document.getElementById('ext-manifest-file');
+        const fileInput = /** @type {HTMLInputElement} */ (document.getElementById('ext-manifest-file'));
         if (!fileInput?.files[0]) throw new Error('No manifest file selected');
         manifest = await fileInput.files[0].text();
       } else {
-        const textarea = document.getElementById('ext-manifest-text');
+        const textarea = /** @type {HTMLInputElement} */ (document.getElementById('ext-manifest-text'));
         manifest = textarea?.value || '';
         if (!manifest.trim()) throw new Error('Manifest is empty');
       }
 
       const libs = {};
       if (libMode === 'upload') {
-        const libInput = document.getElementById('ext-lib-files');
+        const libInput = /** @type {HTMLInputElement} */ (document.getElementById('ext-lib-files'));
         if (libInput?.files) {
           for (const f of libInput.files) {
             libs[f.name] = await f.text();

package/dist/public/views/profile/federation-tab.js

@@ -6,6 +6,8 @@
  *   v1.1.0 — 2026-03-17 — Replace inline styles with CSS classes
  *   v1.2.0 — 2026-06-02 — Component unification (#11): peer online/offline dot
  *     uses canonical <StatusDot> (alive/dead) instead of bespoke .peer-dot.
+ *   v1.3.0 — 2026-06-19 — Show peer tier (visiting/member/genesis) + availability
+ *     (temporary/permanent) pills next to the status (visiting-node feature).
  */
 import { h } from 'preact';
 import { useState, useEffect, useRef } from 'preact/hooks';
@@ -56,6 +58,8 @@ export default function FederationTab({ session, showToast }) {
                     <div class="card-subtitle">${escHtml(p.url || '')}</div>
                   </div>
                   <div class="peer-status">
+                    <span class="badge ${(p.tier || 'member') === 'visiting' ? 'badge-info' : (p.tier || 'member') === 'genesis' ? 'badge-info' : 'badge-success'}">${t('profile.federation.tier_' + (p.tier || 'member')) || (p.tier || 'member')}</span>
+                    ${p.availability && p.availability !== 'unknown' ? html`<span class="badge ${p.availability === 'permanent' ? 'badge-success' : 'badge-info'}">${t('profile.federation.avail_' + p.availability) || p.availability}</span>` : null}
                     <${StatusDot} status=${alive ? 'alive' : 'dead'} />
                     <span class="fed-status-text ${alive ? 'online' : 'offline'}">${alive ? t('profile.federation.online') : t('profile.federation.offline')}</span>
                   </div>

package/dist/public/views/profile/foundry-dashboard/use-autopilot.js

@@ -27,6 +27,7 @@
  * @version-history
  *   v1.0.0 — 2026-03-22 — Extracted from foundry-tab.js ProjectDashboard
  *   v2.0.0 — 2026-03-26 — Wire multi-pass flow: runComponentPasses for extension/cortex/app
+ *   v2.0.1 — 2026-06-19 — JSDoc type annotations for frontend type-checking
  */
 import { t } from '/js/i18n.js';
 import { apiPost, apiDelete } from '/js/api.js';
@@ -206,7 +207,7 @@ export function useAutopilot(core, autopilotState, projectId, orSettings, sessio
    * @param {string} cid - Component ID
    * @param {Object} project - Project object (with blueprint)
    * @param {Object} interviewSpec - Interview spec
-   * @returns {{ success: boolean, content: string|null, updated: Object }} - Final result
+   * @returns {Promise<{ success: boolean, content: string|null, updated: Object }>} - Final result
    */
   async function runComponentPasses(comp, cid, project, interviewSpec) {
     const blueprint = project.blueprint;
@@ -734,7 +735,7 @@ export function useAutopilot(core, autopilotState, projectId, orSettings, sessio
               await writeProjectLog(projectId, 'extension_probe_start', { meta: { component: comp.label, extensionName: updated.registeredAs, scenarios: probeScenarios.length, by: 'autopilot' } });
 
               const probeResp = await probeExtension(projectId, updated.registeredAs, probeScenarios);
-              const probeResults = probeResp?.data?.results || [];
+              const probeResults = /** @type {any} */ (probeResp)?.data?.results || [];
 
               // Save probe results + context bundle — downstream prompts will inject these
               const contextBundle = createBundle(updated, probeResults);

package/dist/public/views/profile/foundry-detail.js

@@ -131,7 +131,7 @@ export function getWorkflowStep(component, validationResult, result) {
 
 /** Small circle-with-arrow SVG placed inline next to the current action target.
  * @param {Object} props
- * @param {'right'|'down'} [props.direction='right'] — arrow direction
+ * @param {'right'|'down'} [props.direction='right'] - arrow direction
  */
 function StepArrow({ direction = 'right' } = {}) {
   const chevron = direction === 'down'

package/dist/public/views/profile/generator-detail.js

@@ -162,7 +162,7 @@ export function getWorkflowStep(component, validationResult, result) {
 
 /** Small circle-with-arrow SVG placed inline next to the current action target.
  * @param {Object} props
- * @param {'right'|'down'} [props.direction='right'] — arrow direction
+ * @param {'right'|'down'} [props.direction='right'] - arrow direction
  */
 function StepArrow({ direction = 'right' } = {}) {
   const chevron = direction === 'down'

package/dist/public/views/profile/inbox-tab.js

@@ -11,10 +11,13 @@
  * @structure InboxTab (default) · Composer (Toast UI) · MessageBubble · Avatar · helpers
  * @usage Lazy-loaded profile tab; registered in profile.js TABS as id `messages`.
  * @version-history
+ *   v1.3.0 -- 2026-06-19 -- Show a presence dot next to peers (request rows, conversation list,
+ *     thread header) via the shared <PresenceDot>.
  *   v1.2.0 -- 2026-06-16 -- Composer upgraded to the shared Toast UI editor (parity with the
  *     workspace document editor) + markdown-preview fallback.
  *   v1.1.0 -- 2026-06-16 -- Redesigned as a proper messenger (avatars, bubbles, ticks, dividers).
  *   v1.0.0 -- 2026-06-16 -- Initial creation for user-to-user messaging (layer 5).
+ *   v1.3.1 -- 2026-06-19 -- JSDoc type annotations for frontend type-checking
  */
 import { h } from 'preact';
 import { useState, useEffect, useCallback, useRef } from 'preact/hooks';
@@ -24,6 +27,7 @@ import { t, getLocale } from '/js/i18n.js';
 import { escHtml } from '/js/utils.js';
 import { Markdown } from '/components/Markdown.js';
 import { minidenticon } from '/lib/minidenticons.min.js';
+import { PresenceDot } from '/components/PresenceDot.js';
 import * as messages from '/js/services/messages.js';
 
 /* Lazy-load the vendored Toast UI Editor (MIT, /lib/toastui/) — the same editor the workspace
@@ -313,7 +317,7 @@ export default function InboxTab({ showToast }) {
             <div class="inbox-request-top">
               <${Avatar} seed=${r.contactId} size=${36} />
               <div class="inbox-request-id">
-                <div class="inbox-name">${escHtml(peerName(r.contactId))}</div>
+                <div class="inbox-name">${escHtml(peerName(r.contactId))} <${PresenceDot} ghii=${r.contactId} /></div>
                 <div class="inbox-sub">${escHtml(r.contactId)}</div>
               </div>
             </div>
@@ -332,7 +336,7 @@ export default function InboxTab({ showToast }) {
           <${Avatar} seed=${c.peerGhii} size=${40} />
           <div class="inbox-conv-main">
             <div class="inbox-conv-line1">
-              <span class="inbox-name">${escHtml(peerName(c.peerGhii))}</span>
+              <span class="inbox-name">${escHtml(peerName(c.peerGhii))} <${PresenceDot} ghii=${c.peerGhii} /></span>
               <span class="inbox-conv-time">${c.updatedAt ? timeShort(c.updatedAt) : ''}</span>
             </div>
             <div class="inbox-conv-line2">
@@ -350,7 +354,7 @@ export default function InboxTab({ showToast }) {
         <div class="inbox-thread-head">
           <${Avatar} seed=${activeConv.peerGhii} size=${36} />
           <div class="inbox-thread-id">
-            <div class="inbox-name">${escHtml(peerName(activeConv.peerGhii))}</div>
+            <div class="inbox-name">${escHtml(peerName(activeConv.peerGhii))} <${PresenceDot} ghii=${activeConv.peerGhii} label=${true} /></div>
             <div class="inbox-sub">${escHtml(activeConv.peerGhii)}</div>
           </div>
         </div>

package/dist/public/views/profile/inline-panels.js

@@ -35,8 +35,8 @@ const PANELS = {
 
 export function InlinePanel({ panelId, onClose, switchTab, session }) {
   const cfg = PANELS[panelId];
-  if (!cfg) return null;
 
+  // Hooks must run unconditionally before any early return (Rules of Hooks).
   const panelRef = useRef(null);
 
   /* Smooth scroll into view after opening */
@@ -48,6 +48,8 @@ export function InlinePanel({ panelId, onClose, switchTab, session }) {
     }
   }, [panelId]);
 
+  if (!cfg) return null;
+
   return html`
     <div class="pf-inline-panel open" ref=${panelRef}>
       <div class="pf-inline-panel-header">

package/dist/public/views/profile/knowledge-tab.js

@@ -18,6 +18,7 @@
  *     pf-sharing-box, pf-sharing-heading, kpkg-detail-loading). Replace inline
  *     visibility pill with shared VisibilityPill component. Replace hardcoded English
  *     strings with i18n t() calls.
+ *   v1.0.1 — 2026-06-19 — JSDoc type annotations for frontend type-checking
  */
 import { h } from 'preact';
 import { useState, useEffect, useCallback, useRef } from 'preact/hooks';
@@ -393,7 +394,7 @@ export default function KnowledgeTab({ session, showToast, onStats }) {
     if (!el) {
       const all = document.querySelectorAll('[data-entry-key]');
       for (const candidate of all) {
-        if (candidate.dataset.entryKey.endsWith('/' + entryKey)) { el = candidate; break; }
+        if (/** @type {HTMLElement} */ (candidate).dataset.entryKey.endsWith('/' + entryKey)) { el = candidate; break; }
       }
     }
     if (el) { el.scrollIntoView({ behavior: 'smooth', block: 'center' }); el.classList.add('kpkg-entry-highlight'); setTimeout(() => el.classList.remove('kpkg-entry-highlight'), 1500); }

package/dist/public/views/profile/landing-page.js

@@ -15,6 +15,8 @@
  *     AppStrip — home/section sub-components
  *   - LandingPage — main orchestrator (default export)
  * @version-history
+ *   v3.3.0 — 2026-06-19 — Add the PresenceControl card to the home dashboard (own availability:
+ *     auto/manual status + who-can-see visibility), previewing the shared <PresenceDot>.
  *   v3.2.0 — 2026-06-10 — Sidebar reorg: groups follow the information-refinement pipeline
  *     (Information / Automation / Activity / Build & Share / Account / Infrastructure) —
  *     Daily/Personal/Technical are gone. Pinned section under Home (pin-on-hover 📌, max 5,
@@ -65,7 +67,9 @@ import * as orgService from '/js/services/organisms.js';
 import { listRecents } from '/js/recents.js';
 import { getMemory, createMemory } from '/js/services/memory.js';
 import { listInbox } from '/js/services/messages.js';
+import { getMyPresence, setMyPresence } from '/js/services/presence.js';
 import { Spinner } from './shared.js';
+import { PresenceDot } from '/components/PresenceDot.js';
 import { minidenticon } from '/lib/minidenticons.min.js';
 
 /* ───── Small time helpers (reuse the organisms rel-time keys) ───── */
@@ -515,6 +519,88 @@ function AgentsCard({ owner }) {
   `;
 }
 
+/* "Presence" — the owner's own availability control: status source (auto/manual),
+ * chosen status, and who-can-see visibility. One self-contained card; the dot it
+ * previews is the same <PresenceDot> rendered next to people everywhere else. */
+function PresenceControl() {
+  const [cfg, setCfg] = useState(null);
+  const [status, setStatus] = useState('unknown');
+  const [saving, setSaving] = useState(false);
+
+  const load = useCallback(async () => {
+    try {
+      const r = await getMyPresence();
+      if (r?.data) { setCfg(r.data.config); setStatus(r.data.status || 'unknown'); }
+    } catch { /* control stays hidden until it loads */ }
+  }, []);
+  useEffect(() => { load(); }, [load]);
+
+  const save = async (partial) => {
+    if (!cfg) return;
+    const optimistic = { ...cfg, ...partial };
+    setCfg(optimistic);
+    setSaving(true);
+    try {
+      const r = await setMyPresence(partial);
+      if (r?.data) { setCfg(r.data.config); setStatus(r.data.status || 'unknown'); }
+    } catch { setCfg(cfg); /* revert */ }
+    setSaving(false);
+  };
+
+  if (!cfg) return null;
+
+  return html`
+    <div class="pf-presence-card">
+      <div class="pf-presence-head">
+        <div>
+          <div class="section-title">${t('presence.control.title')}</div>
+          <div class="section-desc">${t('presence.control.desc')}</div>
+        </div>
+        <${PresenceDot} status=${status} size="md" label=${true} />
+      </div>
+
+      <div class="pf-presence-row">
+        <label class="pf-presence-label">${t('presence.control.modeLabel')}</label>
+        <div class="pf-presence-modes">
+          <button class=${'pf-presence-pill' + (cfg.mode === 'auto' ? ' pf-presence-pill--on' : '')}
+            disabled=${saving} onClick=${() => save({ mode: 'auto' })}>${t('presence.control.modeAuto')}</button>
+          <button class=${'pf-presence-pill' + (cfg.mode === 'manual' ? ' pf-presence-pill--on' : '')}
+            disabled=${saving} onClick=${() => save({ mode: 'manual' })}>${t('presence.control.modeManual')}</button>
+        </div>
+      </div>
+
+      ${cfg.mode === 'auto' ? html`
+        <div class="pf-presence-hint">${t('presence.control.modeAutoHint')}</div>
+      ` : html`
+        <div class="pf-presence-row">
+          <label class="pf-presence-label" for="pf-presence-status">${t('presence.control.statusLabel')}</label>
+          <select id="pf-presence-status" class="pf-edit-select" value=${cfg.status} disabled=${saving}
+            onChange=${(e) => save({ status: e.target.value })}>
+            <option value="available">${t('presence.status.available')}</option>
+            <option value="busy">${t('presence.status.busy')}</option>
+            <option value="away">${t('presence.status.away')}</option>
+            <option value="invisible">${t('presence.status.invisible')}</option>
+          </select>
+        </div>
+      `}
+
+      <div class="pf-presence-row">
+        <label class="pf-presence-label" for="pf-presence-vis">${t('presence.control.visibilityLabel')}</label>
+        <select id="pf-presence-vis" class="pf-edit-select" value=${cfg.visibility} disabled=${saving}
+          onChange=${(e) => save({ visibility: e.target.value })}>
+          <option value="everyone">${t('presence.control.visEveryone')}</option>
+          <option value="contacts">${t('presence.control.visContacts')}</option>
+          <option value="nobody">${t('presence.control.visNobody')}</option>
+        </select>
+      </div>
+      <div class="pf-presence-hint">
+        ${cfg.visibility === 'everyone' ? t('presence.control.visEveryoneHint')
+          : cfg.visibility === 'contacts' ? t('presence.control.visContactsHint') : ''}
+      </div>
+    </div>
+  `;
+}
+
 /* ───── Sub-components ───── */
 
 function ProfileCard({ tier, stats, session, onEditProfile, switchTab }) {
@@ -771,6 +857,7 @@ const SIDEBAR_GROUPS = [
   { titleKey: 'profile.landing.menuInformation', items: [   // raw → curated → governed
     { id: 'organisms', icon: '\u{1F3E2}', labelKey: 'profile.tabs.organisms' },
     { id: 'memory', icon: '\u{1F9E0}', labelKey: 'profile.tabs.memory' },
+    { id: 'notebook', icon: '\u{1F4D3}', labelKey: 'profile.tabs.notebook' },
     { id: 'knowledge', icon: '\u{1F4DA}', labelKey: 'knowledge.tabLabel' },
     { id: 'boards', icon: '\u{1F4CB}', labelKey: 'profile.tabs.boards' },
   ] },
@@ -1035,6 +1122,7 @@ export default function LandingPage({ tier, stats, session, navigate, showToast,
           <${ProfileCard} tier=${tier} stats=${stats} session=${session}
             onEditProfile=${() => setEditOpen(true)}
             switchTab=${(id) => open(id, 'main')} />
+          <${PresenceControl} />
           ${isNew ? html`<${HeroOnboarding} switchTab=${(id) => open(id, 'main')} />` : null}
           ${(isNew || isActive) ? html`<${KnowledgeCallout} switchTab=${() => open('knowledge', 'main')} />` : null}
           ${isNew ? html`<${GhostTiles} switchTab=${() => open('packages', 'main')} />` : null}

package/dist/public/views/profile/memory-tab.js

@@ -33,6 +33,7 @@
  *     group-share brought into Memory; "Create a group →" when none exist). Plus bulk edit:
  *     per-row checkboxes + a bulk bar (change visibility incl. group / delete with confirm /
  *     clear). The detail-row select and edit-modal select remain as alternate paths.
+ *   v2.2.1 — 2026-06-19 — JSDoc type annotations for frontend type-checking
  */
 import { h } from 'preact';
 import { useState, useEffect, useRef } from 'preact/hooks';
@@ -279,7 +280,7 @@ export default function MemoryTab({ session, showToast, onStats }) {
   function readFileAsBase64(file) {
     return new Promise((resolve, reject) => {
       const reader = new FileReader();
-      reader.onload = () => resolve(reader.result.split(',')[1]);
+      reader.onload = () => resolve(/** @type {string} */ (reader.result).split(',')[1]);
       reader.onerror = reject;
       reader.readAsDataURL(file);
     });
@@ -287,13 +288,13 @@ export default function MemoryTab({ session, showToast, onStats }) {
 
   async function handleDownloadFile(key) {
     try {
-      const headers = {};
+      const headers = /** @type {Record<string,string>} */ ({});
       if (window.AIMEAT?.auth?.hasSession) {
         const session = window.AIMEAT.auth.getSession();
         if (session?.jwt) headers['Authorization'] = 'Bearer ' + session.jwt;
       }
       const resp = await fetch(`${NODE_URL}/v1/memory/files/${encodeURIComponent(key)}`, { headers });
-      if (!resp.ok) throw new Error(resp.status);
+      if (!resp.ok) throw new Error(String(resp.status));
       const blob = await resp.blob();
       const url = URL.createObjectURL(blob);
       const a = document.createElement('a');
@@ -433,9 +434,9 @@ export default function MemoryTab({ session, showToast, onStats }) {
     const sorted = [...entries];
     switch (sortBy) {
       case 'updated':
-        return sorted.sort((a, b) => new Date(b.updated_at || 0) - new Date(a.updated_at || 0));
+        return sorted.sort((a, b) => +new Date(b.updated_at || 0) - +new Date(a.updated_at || 0));
       case 'created':
-        return sorted.sort((a, b) => new Date(b.created_at || 0) - new Date(a.created_at || 0));
+        return sorted.sort((a, b) => +new Date(b.created_at || 0) - +new Date(a.created_at || 0));
       case 'alpha':
         return sorted.sort((a, b) => a.key.localeCompare(b.key));
       default: