aimeat 1.25.0 → 1.26.0

package/dist/public/views/admin.js

@@ -1,6 +1,11 @@
 /**
- * Admin Dashboard — SPA View
- * Sidebar layout with data preloading and tab components.
+ * @file public/views/admin.js
+ * @description Admin Dashboard SPA view — sidebar layout with data preloading and tab components.
+ * @structure Single `loadAll` fetches all dashboard data; tabs render slices of it. SSE
+ *            live-updates trigger a debounced, silent background refresh.
+ * @version-history
+ *   v1.1.0 — 2026-06-18 — Debounce + silence SSE-driven refresh so busy nodes don't flicker "Loading…".
+ *   v1.1.1 — 2026-06-19 — JSDoc type annotations for frontend type-checking
  */
 import { h } from 'preact';
 import { useState, useEffect, useCallback, useRef } from 'preact/hooks';
@@ -31,6 +36,7 @@ import BoardsTab       from './admin/boards-tab.js';
 import ChatInstancesTab from './admin/chat-instances-tab.js';
 import RealtimeTab     from './admin/realtime-tab.js';
 import WorkTab         from './admin/work-tab.js';
+import MessagesAdminTab from './admin/messages-tab.js';
 import EmailTab        from './admin/email-tab.js';
 import PushTab         from './admin/push-tab.js';
 import DirectoryTab    from './admin/directory-tab.js';
@@ -81,6 +87,7 @@ const NAV_GROUPS = [
     { id: 'chatInstances', icon: '\u{1F4AC}',  key: 'dashboard.chatInstances', component: ChatInstancesTab,  count: 'chatInstances' },
     { id: 'realtime',      icon: '\u{1F4E1}',  key: 'dashboard.realtime',      component: RealtimeTab,       count: 'rooms' },
     { id: 'work',          icon: '\u{1F4E6}',  key: 'dashboard.work',          component: WorkTab,           count: 'work' },
+    { id: 'messages',      icon: '\u{1F4EC}',  key: 'admin.messages.title',    component: MessagesAdminTab },
     { id: 'memory-admin',  icon: '\u{1F5C4}',  key: 'dashboard.memoryAdmin',   component: MemoryAdminTab },
     { id: 'agent-tasks',  icon: '\u{1F4CB}',  key: 'dashboard.agentTasksTab', component: AgentTasksAdminTab },
     { id: 'sharing-groups', icon: '\u{1F465}', key: 'dashboard.sharingGroupsTab', component: SharingGroupsAdminTab },
@@ -130,6 +137,7 @@ export default function Admin({ navigate, locale }) {
   const [lastUpdate, setLastUpdate] = useState(null);
   const mountRef = useRef(true);
   const retriedRef = useRef(false);
+  const reloadTimerRef = useRef(null);
 
   // Auth listener
   useEffect(() => {
@@ -156,9 +164,11 @@ export default function Admin({ navigate, locale }) {
   // Cleanup
   useEffect(() => { mountRef.current = true; return () => { mountRef.current = false; }; }, []);
 
-  // Load all data — server-side auth is the source of truth
-  const loadAll = useCallback(async () => {
-    setLoading(true);
+  // Load all data — server-side auth is the source of truth.
+  // `silent` skips the loading spinner so SSE-driven background refreshes don't
+  // flicker the "Loading…" button on busy nodes (only manual refresh shows it).
+  const loadAll = useCallback(async (silent = false) => {
+    if (!silent) setLoading(true);
     setError(null);
     setAccessDenied(false);
     try {
@@ -307,13 +317,23 @@ export default function Admin({ navigate, locale }) {
     if (session) loadAll();
   }, [session, loadAll]);
 
-  // SSE live updates — auto-reload on server-side data changes
+  // SSE live updates — auto-reload on server-side data changes.
+  // Debounced + silent: busy nodes emit many events per second; without this the
+  // whole dashboard re-fetches (and flickers "Loading…") on every single event.
   useEffect(() => {
     if (!session) return;
     connect(() => getSession()?.jwt);
-    onUpdate(loadAll);
+    const debouncedReload = () => {
+      if (reloadTimerRef.current) clearTimeout(reloadTimerRef.current);
+      reloadTimerRef.current = setTimeout(() => {
+        reloadTimerRef.current = null;
+        if (mountRef.current) loadAll(true);
+      }, 1500);
+    };
+    onUpdate(debouncedReload);
     return () => {
-      offUpdate(loadAll);
+      offUpdate(debouncedReload);
+      if (reloadTimerRef.current) clearTimeout(reloadTimerRef.current);
       disconnect();
     };
   }, [session, loadAll]);
@@ -322,7 +342,7 @@ export default function Admin({ navigate, locale }) {
   function switchPage(id) {
     setActivePage(id);
     // Update URL without reload
-    const url = new URL(window.location);
+    const url = new URL(window.location.href);
     url.searchParams.set('tab', id);
     history.replaceState(null, '', url);
   }

package/dist/public/views/doc-solo.js

@@ -9,6 +9,8 @@
  * @structure DocSolo (default export)
  * @version-history
  *   v1.0.0 — 2026-06-09 — Initial: pop-out document window.
+ *   v1.0.1 — 2026-06-19 — Import DocumentView/DocumentEditor from their new home
+ *     (./profile/organisms/document.js) after the organisms-tab module split.
  */
 import { h } from 'preact';
 import { useState, useEffect, useRef, useCallback } from 'preact/hooks';
@@ -18,7 +20,7 @@ import { getSession } from '/js/services/auth.js';
 import { connect, disconnect, onUpdate, offUpdate } from '/lib/live-updates.js';
 import { useViewCSS } from '/components/useViewCSS.js';
 import * as orgService from '/js/services/organisms.js';
-import { DocumentView, DocumentEditor } from './profile/organisms-tab.js';
+import { DocumentView, DocumentEditor } from './profile/organisms/document.js';
 
 const html = htm.bind(h);
 

package/dist/public/views/guides.js

@@ -300,11 +300,12 @@ function GuideIndex({ locale, onSelectGuide, navigate }) {
 function GuideDetail({ slug, locale, onBack }) {
   const labels = LABELS[locale] || LABELS.en;
   const guide = GUIDES[slug];
-  if (!guide) return html`<div class="gd-container"><p>Guide not found.</p></div>`;
-  const data = guide[locale] || guide.en;
+  const data = guide ? (guide[locale] || guide.en) : null;
 
-  // Build markdown for clipboard
+  // Hooks must run unconditionally before any early return (Rules of Hooks) — guard their
+  // bodies against a missing guide instead.
   const buildMarkdown = useCallback(() => {
+    if (!data) return '';
     let md = '# ' + data.title + '\n\nNode URL: ' + NODE_URL + '\n\nIMPORTANT: Make it a single downloadable HTML file.\n\n';
     data.sections.forEach(s => {
       md += '## ' + s.heading + '\n\n' + s.body + '\n\n';
@@ -316,9 +317,12 @@ function GuideDetail({ slug, locale, onBack }) {
   }, [data]);
 
   useEffect(() => {
+    if (!data) return;
     document.title = data.title + ' | AIME AT';
     window.scrollTo(0, 0);
-  }, [slug, data.title]);
+  }, [slug, data]);
+
+  if (!guide) return html`<div class="gd-container"><p>Guide not found.</p></div>`;
 
   return html`
     <div class="gd-container">

package/dist/public/views/hobbies.js

@@ -2,6 +2,7 @@
  * @file hobbies.js
  * @description Hobbies view module — multi-view hobby directory (home, search, profile, join, me, matches) rendered with Preact + HTM.
  * @version-history
+ *   v1.3.0 — 2026-06-19 — Show a presence dot next to people in the directory results + profile header (shared <PresenceDot>)
  *   v1.1.0 — 2026-06-02 — Phase 5: tokenize for dark mode (replaced light-only rgba(255,255,255,...) divider with var(--border))
  *   v1.2.0 — 2026-06-02 — Component unification (#4 buttons): hb-btn* → canonical
  *     theme.css btn-primary / btn-outline / btn-danger / btn-sm.
@@ -15,6 +16,7 @@ import { escHtml, escAttr } from '/js/utils.js';
 import { t, getLocale, switchLocale } from '/js/i18n.js';
 import { apiGet, apiPost, apiPut, apiDelete } from '/js/api.js';
 import { useViewCSS } from '/components/useViewCSS.js';
+import { PresenceDot } from '/components/PresenceDot.js';
 
 const html = htm.bind(h);
 
@@ -207,7 +209,7 @@ function SearchView({ goTo, initData }) {
               <div style="display:flex;align-items:center;gap:12px;margin-bottom:8px;">
                 <span style="font-size:1.5rem;">${entry.avatar || '\uD83D\uDE0A'}</span>
                 <div>
-                  <div class="hb-card-title">${entry.displayName}</div>
+                  <div class="hb-card-title">${entry.displayName} <${PresenceDot} ghii=${entry.ghii} /></div>
                   ${(entry.city || entry.area) && html`<div class="hb-card-meta">${[entry.city, entry.area].filter(Boolean).join(', ')}</div>`}
                 </div>
               </div>
@@ -282,7 +284,7 @@ function ProfileView({ goTo, ghii }) {
     <div class="hb-profile-header">
       <span class="hb-profile-avatar">${entry.avatar || '\uD83D\uDE0A'}</span>
       <div>
-        <div class="hb-profile-name">${entry.displayName}</div>
+        <div class="hb-profile-name">${entry.displayName} <${PresenceDot} ghii=${ghii} label=${true} /></div>
         <div class="hb-profile-ghii">${ghii}</div>
       </div>
     </div>

package/dist/public/views/marketplace.js

@@ -5,6 +5,7 @@
  * @version-history
  *   v1.1.0 — 2026-06-02 — Component unification (#18 category cards): category tiles
  *     use canonical theme.css .category-card / -icon / -name / -count (was .mk-category-*).
+ *   v1.1.1 — 2026-06-19 — JSDoc type annotations for frontend type-checking
  */
 import { h } from 'preact';
 import { useState, useEffect, useCallback } from 'preact/hooks';
@@ -379,19 +380,19 @@ function CreateListingView({ extAction, instanceConfig, onNav, tl }) {
   const submit = () => {
     setMsg(''); setErr(''); setSending(true);
     const data = {
-      title: document.getElementById('mk-sell-title').value,
-      description: document.getElementById('mk-sell-desc').value,
-      category: document.getElementById('mk-sell-category').value,
-      price: parseInt(document.getElementById('mk-sell-price').value, 10),
+      title: /** @type {HTMLInputElement} */ (document.getElementById('mk-sell-title')).value,
+      description: /** @type {HTMLInputElement} */ (document.getElementById('mk-sell-desc')).value,
+      category: /** @type {HTMLInputElement} */ (document.getElementById('mk-sell-category')).value,
+      price: parseInt(/** @type {HTMLInputElement} */ (document.getElementById('mk-sell-price')).value, 10),
     };
-    const condition = document.getElementById('mk-sell-condition').value;
+    const condition = /** @type {HTMLInputElement} */ (document.getElementById('mk-sell-condition')).value;
     if (condition) data.condition = condition;
-    const availability = document.getElementById('mk-sell-avail').value;
+    const availability = /** @type {HTMLInputElement} */ (document.getElementById('mk-sell-avail')).value;
     if (availability) data.availability = availability;
-    const city = document.getElementById('mk-sell-city').value;
-    const area = document.getElementById('mk-sell-area').value;
+    const city = /** @type {HTMLInputElement} */ (document.getElementById('mk-sell-city')).value;
+    const area = /** @type {HTMLInputElement} */ (document.getElementById('mk-sell-area')).value;
     if (city || area) { data.location = {}; if (city) data.location.city = city; if (area) data.location.area = area; }
-    const tags = document.getElementById('mk-sell-tags').value;
+    const tags = /** @type {HTMLInputElement} */ (document.getElementById('mk-sell-tags')).value;
     if (tags) data.tags = tags.split(',').map(s => s.trim()).filter(Boolean);
 
     extAction('create-listing', data)

package/dist/public/views/openclaw.js

@@ -176,7 +176,7 @@ function OpenClawView() {
         ].map(([title, steps]) => html`
           <div class="oc-scenario">
             <h4>${title}</h4>
-            <div class="flow"><ol>${steps.map(s => html`<li>${s}</li>`)}</ol></div>
+            <div class="flow"><ol>${(/** @type {any[]} */ (steps)).map(s => html`<li>${s}</li>`)}</ol></div>
           </div>
         `)}
       </div>

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); }