@logicseek/hello-cc 1.0.1 → 1.0.2

package/lib/web/ui-terminal-find.mjs

@@ -0,0 +1,98 @@
+export const terminalFindCss = `
+  .terminal-find { flex:none; padding:8px var(--space); border-bottom:1px solid var(--border); background:var(--panel); }
+  .terminal-find-row { display:flex; gap:6px; align-items:center; }
+  .terminal-find-row input { flex:1; min-width:60px; }
+  .terminal-find-row button { flex:none; min-width:36px; }
+  .terminal-find-meta { display:flex; gap:14px; align-items:center; flex-wrap:wrap; margin-top:7px; color:var(--muted); font-size:12px; }
+  .terminal-find-meta label { display:flex; gap:5px; align-items:center; }
+  .terminal-find-meta input { width:auto; margin:0; }
+  #terminalFindResult { flex:1; min-width:100px; }
+  @media(pointer:coarse) { .terminal-find-row button { min-width:44px; min-height:44px; } }
+`;
+
+export function terminalFindHtml() {
+  return `<section id="terminalFind" class="terminal-find" role="search" data-i18n-aria="find.title" aria-label="Find in terminal" hidden>
+    <div class="terminal-find-row"><input id="terminalFindQuery" type="search" maxlength="256" autocomplete="off" data-i18n-placeholder="find.placeholder" data-i18n-aria="find.title" placeholder="Find in terminal output…" aria-label="Find in terminal"><button id="terminalFindPrev" type="button" data-i18n-title="find.previous" data-i18n-aria="find.previous" title="Previous match" aria-label="Previous match">↑</button><button id="terminalFindNext" type="button" data-i18n-title="find.next" data-i18n-aria="find.next" title="Next match" aria-label="Next match">↓</button><button id="terminalFindClose" type="button" data-i18n-title="close" data-i18n-aria="close" aria-label="Close">×</button></div>
+    <div class="terminal-find-meta"><label><input id="terminalFindCase" type="checkbox"><span data-i18n="find.case">Match case</span></label><label><input id="terminalFindWord" type="checkbox"><span data-i18n="find.word">Whole word</span></label><span id="terminalFindResult" role="status" aria-live="polite"></span></div>
+  </section>`;
+}
+
+export function terminalFindScript() {
+  return `(() => {
+    const host = window.hccTerminalFindHost;
+    const bar = document.getElementById('terminalFind');
+    const query = document.getElementById('terminalFindQuery');
+    const caseOption = document.getElementById('terminalFindCase');
+    const wordOption = document.getElementById('terminalFindWord');
+    const result = document.getElementById('terminalFindResult');
+    const prev = document.getElementById('terminalFindPrev'), next = document.getElementById('terminalFindNext');
+    const tr = key => window.hccUi.tr(key);
+    let subject = '', timer = 0, composing = false, searched = false;
+    let count = 0, index = -1;
+    function renderResult() {
+      const message = !query.value ? tr('find.hint') : count === 0 ? tr('find.none') : index < 0 ? tr('find.many').replace('{count}', String(count)) : tr('find.count').replace('{index}', String(index + 1)).replace('{count}', String(count));
+      if (result.textContent !== message) result.textContent = message;
+      prev.disabled = next.disabled = !query.value;
+    }
+    function close(focus = true) {
+      clearTimeout(timer); bar.hidden = true;
+      document.getElementById('terminalFindBtn').setAttribute('aria-expanded','false');
+      if (searched) host.addon.clearDecorations();
+      searched = false;
+      if (focus && host.available()) host.term.focus();
+    }
+    function sync() {
+      if (subject !== host.subject() || !host.available()) {
+        close(false); subject = host.subject(); query.value = ''; count = 0; index = -1;
+      }
+      document.getElementById('terminalFindBtn').disabled = !host.available();
+      document.getElementById('terminalFindBtn').hidden = !host.available();
+      renderResult();
+    }
+    function options(incremental) {
+      const css = getComputedStyle(document.documentElement);
+      const color = name => css.getPropertyValue(name).trim();
+      return {caseSensitive:caseOption.checked, wholeWord:wordOption.checked, incremental, regex:false,
+        decorations:{matchBackground:color('--selection-bg'), matchBorder:color('--border'), matchOverviewRuler:color('--accent'), activeMatchBackground:color('--accent'), activeMatchBorder:color('--accent'), activeMatchColorOverviewRuler:color('--accent')}};
+    }
+    function search(direction = 1, incremental = true) {
+      clearTimeout(timer);
+      if (bar.hidden || composing || !host.available() || subject !== host.subject()) return;
+      if (!query.value) { if (searched) host.addon.clearDecorations(); searched = false; count = 0; index = -1; renderResult(); return; }
+      searched = true;
+      try {
+        const found = direction < 0 ? host.addon.findPrevious(query.value, options(false)) : host.addon.findNext(query.value, options(incremental));
+        if (!found) { count = 0; index = -1; }
+        renderResult();
+      } catch(error) { host.addon.clearDecorations(); searched = false; count = 0; index = -1; result.textContent = tr('find.failed'); prev.disabled = next.disabled = true; }
+    }
+    function schedule() { if (!composing) { clearTimeout(timer); timer = setTimeout(() => search(), 120); } }
+    function refreshMatches() {
+      // The addon caches highlights for the same query; invalidate them when
+      // matching options or theme colors change so counts and colors stay fresh.
+      if (searched) host.addon.clearDecorations();
+      searched = false;
+      search();
+    }
+    function open() {
+      sync(); if (!host.available()) return;
+      host.showTerminal(); bar.hidden = false; document.getElementById('terminalFindBtn').setAttribute('aria-expanded','true'); query.focus(); query.select(); renderResult();
+      if (query.value) search();
+    }
+    host.addon.onDidChangeResults(value => { if (bar.hidden) return; count = value.resultCount; index = value.resultIndex; renderResult(); });
+    query.addEventListener('input', event => { if (!event.isComposing) schedule(); });
+    query.addEventListener('compositionstart', () => { composing = true; clearTimeout(timer); });
+    query.addEventListener('compositionend', () => { composing = false; schedule(); });
+    query.addEventListener('keydown', event => {
+      if (event.isComposing) return;
+      if (event.key === 'Enter') { event.preventDefault(); event.stopPropagation(); search(event.shiftKey ? -1 : 1, false); }
+    });
+    caseOption.addEventListener('change', refreshMatches); wordOption.addEventListener('change', refreshMatches);
+    prev.addEventListener('click', () => search(-1, false)); next.addEventListener('click', () => search(1, false));
+    document.getElementById('terminalFindClose').addEventListener('click', () => close());
+    document.getElementById('terminalFindBtn').addEventListener('click', open);
+    window.addEventListener('hcc:preferences', () => { if (!bar.hidden) { renderResult(); if (query.value) refreshMatches(); } });
+    window.hccTerminalFind = {open, close, sync, capturesEscape:event => !bar.hidden && event.key === 'Escape' && (bar.contains(event.target) || host.term.element.contains(event.target))};
+    sync();
+  })();`;
+}

package/lib/web/ui-workbench.mjs

@@ -0,0 +1,94 @@
+export const workbenchCss = `
+  .inspector { grid-template-rows:auto auto auto minmax(0,1fr); }
+  .state-tabs { display:flex; gap:4px; padding:8px var(--space); border-bottom:1px solid var(--border); }
+  .state-tabs button { flex:1; min-width:0; border:0; background:transparent; color:var(--muted); padding:0 5px; font-size:12px; }
+  .state-tabs button[aria-selected="true"] { background:var(--selection-bg); color:var(--text); }
+  .state-freshness { display:flex; align-items:center; gap:8px; padding:8px var(--space); color:var(--muted); font-size:var(--small-font); }
+  .state-freshness span { flex:1; min-width:0; overflow-wrap:anywhere; }
+  .state-freshness[data-stale="true"] { color:var(--warn); background:var(--panel-2); }
+  .state-freshness button { height:28px; padding:0 8px; font-size:12px; }
+  .state-announcement { position:absolute; width:1px; height:1px; padding:0; margin:-1px; overflow:hidden; clip-path:inset(50%); white-space:nowrap; }
+  .handoff-chips { display:flex; gap:6px; flex-wrap:wrap; align-items:center; }
+  .handoff-chip { display:inline-flex; align-items:center; gap:5px; color:var(--muted); font-size:11px; background:var(--panel-2); padding:4px 8px; border-radius:5px; }
+  .handoff-chip[data-tone="ok"] { color:var(--ok); }
+  .handoff-chip[data-tone="warn"] { color:var(--warn); }
+  .handoff-chip[data-tone="danger"] { color:var(--danger); }
+  .handoff-detail summary { cursor:pointer; width:fit-content; padding:3px 0; }
+  .handoff-detail div { padding-top:5px; line-height:1.6; }
+  @media (pointer:coarse) { .handoff-bar button, .state-tabs button, .state-freshness button { min-height:40px; } }
+`;
+
+export function workbenchControlsHtml() {
+  return `<nav class="state-tabs" role="tablist" aria-label="Project views" id="stateTabs">
+    <button type="button" id="stateTab-overview" role="tab" data-state-view="overview" aria-controls="state" aria-selected="true">Overview</button>
+    <button type="button" id="stateTab-tasks" role="tab" data-state-view="tasks" aria-controls="state" aria-selected="false" tabindex="-1">Tasks</button>
+    <button type="button" id="stateTab-messages" role="tab" data-state-view="messages" aria-controls="state" aria-selected="false" tabindex="-1">Messages</button>
+    <button type="button" id="stateTab-events" role="tab" data-state-view="events" aria-controls="state" aria-selected="false" tabindex="-1">Events</button>
+  </nav>
+  <div class="state-freshness" id="stateFreshness" data-stale="false"><span id="stateUpdated"></span><span id="stateAnnouncement" class="state-announcement" role="status" aria-live="polite"></span><button type="button" id="stateRetry" hidden>Retry</button></div>`;
+}
+
+// Display state only: the caller owns requests, project scope and retry policy.
+export function workbenchScript() {
+  return `(() => {
+    const tabs = document.getElementById('stateTabs');
+    const state = document.getElementById('state');
+    const notice = document.getElementById('stateFreshness');
+    const updated = document.getElementById('stateUpdated');
+    const announcement = document.getElementById('stateAnnouncement');
+    const retry = document.getElementById('stateRetry');
+    const groups = { overview: ['automation', 'tasks', 'locks'], tasks: ['tasks', 'peers', 'locks'], messages: ['messages'], events: ['timeline'] };
+    let view = 'overview', lastUpdated = 0, failure = '', loading = true, announcementKind = '';
+    const text = (en, zh) => window.hccUi.language === 'zh' ? zh : en;
+    function apply() {
+      const labels = { overview: text('Overview', '概览'), tasks: text('Tasks', '任务'), messages: text('Messages', '消息'), events: text('Events', '事件') };
+      tabs.setAttribute('aria-label', text('Project views', '项目视图'));
+      tabs.querySelectorAll('[data-state-view]').forEach(button => {
+        const selected = button.dataset.stateView === view;
+        button.textContent = labels[button.dataset.stateView];
+        button.setAttribute('aria-selected', String(selected));
+        button.tabIndex = selected ? 0 : -1;
+      });
+      state.setAttribute('role', 'tabpanel');
+      state.setAttribute('aria-labelledby', 'stateTab-' + view);
+      state.querySelectorAll('.state-card[data-section]').forEach(card => { card.hidden = !groups[view].includes(card.dataset.section); });
+      notice.dataset.stale = String(Boolean(failure));
+      const time = lastUpdated ? new Date(lastUpdated).toLocaleTimeString(window.hccUi.language === 'zh' ? 'zh-CN' : 'en-US', { hour: '2-digit', minute: '2-digit', second: '2-digit' }) : '';
+      updated.textContent = failure
+        ? text('Update failed. ', '更新失败。') + (time ? text('Showing data from ', '当前数据更新于 ') + time : text('Data unavailable.', '暂时无法获取数据。'))
+        : time ? text('Updated ', '更新于 ') + time : text('Loading project state…', '正在加载项目状态…');
+      updated.title = failure;
+      const announcements = { loading: text('Loading project state', '正在加载项目状态'), loaded: text('Project state loaded', '项目状态已加载'), failed: lastUpdated ? text('Update failed. Previous data is retained.', '更新失败，保留上次成功的数据。') : text('Update failed. Data unavailable.', '更新失败，暂时无法获取数据。'), recovered: text('Project state updates recovered', '项目状态更新已恢复') };
+      const announcementText = announcements[announcementKind] || '';
+      if (announcement.textContent !== announcementText) announcement.textContent = announcementText;
+      retry.textContent = text('Retry', '重试');
+      retry.hidden = !failure;
+      retry.disabled = loading;
+      state.setAttribute('aria-busy', String(loading));
+    }
+    function select(next) {
+      if (!groups[next]) return;
+      view = next; state.scrollTop = 0; apply();
+    }
+    tabs.querySelectorAll('[data-state-view]').forEach(button => {
+      button.addEventListener('click', () => select(button.dataset.stateView));
+      button.addEventListener('keydown', event => {
+        if (!['ArrowLeft', 'ArrowRight', 'Home', 'End'].includes(event.key)) return;
+        event.preventDefault();
+        const buttons = [...tabs.querySelectorAll('[data-state-view]')];
+        const index = buttons.indexOf(button);
+        const next = event.key === 'Home' ? 0 : event.key === 'End' ? buttons.length - 1 : (index + (event.key === 'ArrowRight' ? 1 : -1) + buttons.length) % buttons.length;
+        select(buttons[next].dataset.stateView); buttons[next].focus();
+      });
+    });
+    window.hccWorkbench = {
+      apply,
+      fresh() { if (failure) announcementKind = 'recovered'; else if (!lastUpdated) announcementKind = 'loaded'; lastUpdated = Date.now(); failure = ''; loading = false; apply(); },
+      stale(error) { announcementKind = 'failed'; failure = error?.detail || error?.message || text('Request failed', '请求失败'); loading = false; apply(); },
+      loading() { loading = true; apply(); },
+      reset() { announcementKind = 'loading'; lastUpdated = 0; failure = ''; loading = true; state.textContent = ''; apply(); }
+    };
+    window.addEventListener('hcc:preferences', apply);
+    apply();
+  })();`;
+}

package/lib/web/ui-workspace.mjs

@@ -0,0 +1,222 @@
+export function normalizeWorkspaceLayout(value) {
+  const source = value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+  const ratio = Number(source.ratio);
+  return { version: 1, open: source.open === true, direction: source.direction === 'rows' ? 'rows' : 'columns',
+    ratio: Number.isFinite(ratio) ? Math.max(.25, Math.min(.75, ratio)) : .5,
+    session: typeof source.session === 'string' && source.session.length <= 512 ? source.session : '' };
+}
+
+export function workspaceMessageValid(event, source, origin, project) {
+  const data = event.data;
+  return Boolean(source && event.source === source && event.origin === origin && data && typeof data === 'object'
+    && data.type === 'hcc-workspace' && data.version === 1 && data.project === project
+    && ['ready', 'selection', 'preferences', 'close'].includes(data.action)
+    && (data.session === undefined || typeof data.session === 'string' && data.session.length <= 512)
+    && (data.preferences === undefined || data.preferences && typeof data.preferences === 'object' && !Array.isArray(data.preferences)));
+}
+
+export const workspaceCss = `
+  .workspace { min-width:0; min-height:0; display:flex; flex-direction:column; overflow:hidden; }
+  .workspace-panes { flex:1; min-height:0; min-width:0; display:grid; grid-template-columns:minmax(0,1fr); }
+  .workspace-bar { flex:none; display:flex; align-items:center; flex-wrap:wrap; gap:8px; padding:8px 10px; background:var(--panel); border-bottom:1px solid var(--border); }
+  .workspace-bar[hidden], .workspace-secondary[hidden], .workspace-divider[hidden] { display:none; }
+  .workspace-bar label { display:flex; flex:1; align-items:center; gap:8px; min-width:160px; }
+  .workspace-bar select { min-width:0; flex:1; max-width:350px; }
+  .workspace-pane-tabs { display:none; gap:6px; }
+  .workspace-bar button[aria-pressed="true"] { background:var(--selection-bg); border-color:var(--accent); }
+  .workspace-secondary { display:flex; position:relative; flex-direction:column; min-width:0; min-height:0; overflow:hidden; background:var(--bg); }
+  .workspace-secondary iframe { width:100%; flex:1; min-height:0; border:0; background:var(--bg); }
+  .workspace-status { padding:12px; color:var(--muted); font-size:var(--small-font); }
+  .workspace-status[hidden] { display:none; }
+  .workspace-divider { width:8px; height:100%; border:0; padding:0; cursor:col-resize; border-radius:0; background:var(--border); touch-action:none; }
+  .workspace-divider:focus-visible { outline-offset:-2px; }
+  .workspace-panes[data-direction="columns"] { grid-template-columns:minmax(0,var(--workspace-ratio,1fr)) 8px minmax(0,var(--workspace-rest,1fr)); }
+  .workspace-panes[data-direction="rows"] { grid-template-columns:minmax(0,1fr); grid-template-rows:minmax(420px,var(--workspace-ratio,1fr)) 8px minmax(420px,var(--workspace-rest,1fr)); overflow:auto; }
+  .workspace-panes[data-direction="rows"] .workspace-divider { width:100%; height:8px; cursor:row-resize; }
+  .workspace-panes.resizing iframe { pointer-events:none; }
+  .app.workspace-open { grid-template-columns:var(--left-width) minmax(0,1fr) 0; }
+  .app.workspace-open.left-collapsed, .app.workspace-open.focus-mode { grid-template-columns:0 minmax(0,1fr) 0; }
+  .app.workspace-open .inspector { display:none; }
+  .app.workspace-open .edge-right, .app.workspace-open .edge-resizer-right { display:none; }
+  .workspace-open .main > .toolbar { flex-wrap:wrap; }
+  .workspace-open .main > .toolbar .title { flex-basis:100%; }
+  .workspace-open .quick, .session-pane .quick { flex:1 1 auto; flex-wrap:wrap; min-width:0; }
+  @media(max-width:1099px) {
+    .app .workspace { display:none; }
+    .app[data-view="terminal"] .workspace { display:flex; }
+    .app.workspace-open, .app.workspace-open.left-collapsed, .app.workspace-open.focus-mode { grid-template-columns:minmax(0,1fr); }
+    .app.workspace-open[data-view="state"] .inspector { display:grid; visibility:visible; }
+    .workspace-pane-tabs { display:flex; }
+    .workspace-panes[data-direction] { grid-template-columns:minmax(0,1fr); grid-template-rows:minmax(0,1fr); }
+    .workspace-panes .workspace-divider, #workspaceDirection { display:none; }
+    .app[data-view="terminal"] .workspace[data-active-pane="secondary"] .main { display:none; }
+    .workspace[data-active-pane="primary"] .workspace-secondary { display:none; }
+    .workspace-bar { gap:6px; }
+    .workspace-bar label span { display:none; }
+    .workspace-bar label { min-width:100px; }
+  }
+  .session-pane .global-header, .session-pane .mobile-nav, .session-pane .sidebar,
+  .session-pane .inspector, .session-pane .edge-toggle, .session-pane .edge-resizer,
+  .session-pane #workspaceBar { display:none !important; }
+  .session-pane .app { display:flex; height:100dvh; }
+  .session-pane .app .workspace, .session-pane .app .main { display:flex; flex:1; visibility:visible; }
+  .session-pane .toolbar { flex-wrap:wrap; }
+  .session-pane .toolbar .title { flex-basis:100%; }
+  @media(pointer:coarse) { .workspace-bar button, .workspace-bar select { min-height:44px; } }
+`;
+
+export function workspaceBarHtml() {
+  return `<header class="workspace-bar" id="workspaceBar" hidden>
+    <div class="workspace-pane-tabs" role="group" data-i18n-aria="workspace.panes" aria-label="Session panes">
+      <button id="workspacePrimary" type="button" data-i18n="workspace.primary" aria-pressed="true">Main</button>
+      <button id="workspaceSecondary" type="button" data-i18n="workspace.secondary" aria-pressed="false">Second</button>
+    </div>
+    <label><span data-i18n="workspace.secondSession">Second session</span><select id="workspaceSession" data-i18n-aria="workspace.secondSession" aria-label="Second session"></select></label>
+    <button id="workspaceDirection" type="button">Stack vertically</button>
+    <button id="workspaceClose" type="button" data-i18n="workspace.close" data-i18n-title="workspace.closeHelp" title="Close this pane; the session keeps running">Close split</button>
+  </header>`;
+}
+
+export function workspaceSecondaryHtml() {
+  return `<div class="workspace-divider" id="workspaceDivider" role="separator" tabindex="0" aria-orientation="vertical" aria-valuemin="25" aria-valuemax="75" aria-valuenow="50" data-i18n-aria="workspace.resize" aria-label="Resize session panes" hidden></div>
+    <section class="workspace-secondary" id="workspaceSecondPane" data-i18n-aria="workspace.secondary" aria-label="Second pane" hidden>
+      <div class="workspace-status" id="workspaceStatus" role="status"></div>
+      <button id="workspaceRetry" type="button" data-i18n="workspace.retry" hidden>Reconnect pane</button>
+    </section>`;
+}
+
+function workspaceRuntime(normalize, validMessage) {
+  const host = window.hccWorkspaceHost, ui = window.hccUi;
+  const tr = key => ui.tr(key);
+  const byId = id => document.getElementById(id);
+  const workspace = byId('workspace'), panes = byId('workspacePanes'), bar = byId('workspaceBar');
+  const secondary = byId('workspaceSecondPane'), status = byId('workspaceStatus'), select = byId('workspaceSession');
+  const divider = byId('workspaceDivider'), split = byId('splitBtn');
+  const mobile = window.matchMedia('(max-width:1099px)');
+  let root = '', layout = normalize(null), frame = null, mounted = '', timer = 0, selectedPane = 'primary', resizing = false, applyingParentPreferences = false;
+  const key = () => 'hcc.workspace:' + root;
+  const save = () => { if (root) ui.safeSet(key(), JSON.stringify(layout)); };
+  const post = action => {
+    const data = {type:'hcc-workspace', version:1, action, project:host.project(), session:host.active() || '', preferences:ui.preferences};
+    if (host.embedded) { if (window.parent !== window) window.parent.postMessage(data, location.origin); }
+    else frame?.contentWindow?.postMessage({...data, session:layout.session}, location.origin);
+  };
+  function destroy() {
+    clearTimeout(timer); mounted = ''; frame?.remove(); frame = null;
+    status.hidden = true; byId('workspaceRetry').hidden = true;
+  }
+  function appearance() {
+    bar.hidden = !layout.open; secondary.hidden = divider.hidden = !layout.open;
+    host.app.classList.toggle('workspace-open', layout.open);
+    split.setAttribute('aria-pressed', String(layout.open));
+    if (layout.open) panes.dataset.direction = layout.direction; else delete panes.dataset.direction;
+    panes.style.setProperty('--workspace-ratio', layout.ratio + 'fr');
+    panes.style.setProperty('--workspace-rest', (1-layout.ratio) + 'fr');
+    divider.setAttribute('aria-orientation', layout.direction === 'columns' ? 'vertical' : 'horizontal');
+    divider.setAttribute('aria-valuenow', String(Math.round(layout.ratio*100)));
+    byId('workspaceDirection').textContent = tr(layout.direction === 'columns' ? 'workspace.rows' : 'workspace.columns');
+    workspace.dataset.activePane = selectedPane;
+    byId('workspacePrimary').setAttribute('aria-pressed', String(selectedPane === 'primary'));
+    byId('workspaceSecondary').setAttribute('aria-pressed', String(selectedPane === 'secondary'));
+    secondary.inert = mobile.matches && (selectedPane !== 'secondary' || host.app.dataset.view !== 'terminal');
+    host.primary.inert = mobile.matches && (layout.open && selectedPane !== 'primary' || host.app.dataset.view !== 'terminal');
+    host.layoutChanged();
+  }
+  function mount() {
+    if (!layout.open || !host.ready()) return;
+    const session = host.sessions().find(item => item.id === layout.session && item.status === 'running');
+    if (!session) {
+      destroy(); status.hidden = false; status.textContent = tr('workspace.missing'); return;
+    }
+    const identity = JSON.stringify([root,session.id]);
+    if (frame && mounted === identity) return;
+    destroy(); mounted = identity; status.hidden = false; status.textContent = tr('workspace.connecting');
+    frame = document.createElement('iframe'); frame.id = 'workspaceFrame'; frame.title = tr('workspace.secondary');
+    const url = new URL('/pane', location.origin); url.searchParams.set('project',root); url.searchParams.set('session',session.id);
+    frame.src = url.href; secondary.appendChild(frame);
+    timer = setTimeout(() => { status.hidden = false; status.textContent = tr('workspace.failed'); byId('workspaceRetry').hidden = false; }, 12000);
+  }
+  function sync() {
+    if (host.embedded) { post('selection'); return; }
+    const nextRoot = host.project();
+    if (nextRoot !== root) {
+      destroy(); root = nextRoot;
+      try { layout = normalize(JSON.parse(ui.safeGet(key()) || 'null')); } catch (_) { layout = normalize(null); }
+      selectedPane = 'primary';
+    }
+    split.disabled = !host.ready() || !host.sessions().some(item => item.status === 'running');
+    const options = host.sessions().filter(item => item.status === 'running');
+    const esc = host.esc;
+    const html = options.map(item => '<option value="'+esc(item.id)+'">'+esc(item.name || item.task?.title || item.peer_id || item.id)+'</option>').join('');
+    const missing = layout.session && !options.some(item => item.id === layout.session);
+    const nextHtml = (missing ? '<option value="'+esc(layout.session)+'" disabled>'+esc(layout.session)+' · '+esc(tr('workspace.missingShort'))+'</option>' : '') + html;
+    if (select.innerHTML !== nextHtml) select.innerHTML = nextHtml;
+    select.value = layout.session;
+    appearance(); if (layout.open) mount();
+  }
+  function open() {
+    if (host.embedded || split.disabled) return;
+    if (!layout.session) layout.session = (host.sessions().find(item => item.status === 'running' && item.id !== host.active()) || host.sessions().find(item => item.status === 'running'))?.id || '';
+    layout.open = true; selectedPane = mobile.matches ? 'secondary' : 'primary'; save(); host.showTerminal(); sync();
+  }
+  function close() { layout.open = false; destroy(); selectedPane = 'primary'; save(); appearance(); split.focus(); }
+  function reset() { destroy(); root = ''; layout = normalize(null); appearance(); }
+  function pickPane(value) { selectedPane = value; host.showTerminal(); appearance(); }
+  function resize(event) {
+    if (!resizing) return;
+    const rect = panes.getBoundingClientRect();
+    const fraction = layout.direction === 'columns' ? (event.clientX-rect.left)/rect.width : (event.clientY-rect.top)/rect.height;
+    layout.ratio = Math.max(.25,Math.min(.75,fraction)); appearance();
+  }
+  if (!host.embedded) {
+    split.addEventListener('click', () => layout.open ? close() : open());
+    byId('workspaceClose').addEventListener('click', close);
+    select.addEventListener('change', () => {
+      if (!host.sessions().some(item => item.id === select.value && item.status === 'running')) return;
+      layout.session = select.value; selectedPane = 'secondary'; save(); mount(); appearance();
+    });
+    byId('workspaceDirection').addEventListener('click', () => { layout.direction = layout.direction === 'columns' ? 'rows' : 'columns'; save(); appearance(); });
+    byId('workspacePrimary').addEventListener('click', () => pickPane('primary'));
+    byId('workspaceSecondary').addEventListener('click', () => pickPane('secondary'));
+    byId('workspaceRetry').addEventListener('click', () => { destroy(); mount(); });
+    divider.addEventListener('pointerdown', event => { if (event.button !== 0) return; event.preventDefault(); resizing = true; panes.classList.add('resizing'); divider.setPointerCapture(event.pointerId); });
+    divider.addEventListener('pointermove', resize);
+    for (const name of ['pointerup','pointercancel','lostpointercapture']) divider.addEventListener(name, () => { resizing = false; panes.classList.remove('resizing'); save(); });
+    divider.addEventListener('keydown', event => {
+      const decrease = layout.direction === 'columns' ? 'ArrowLeft' : 'ArrowUp', increase = layout.direction === 'columns' ? 'ArrowRight' : 'ArrowDown';
+      if (![decrease,increase,'Home','End'].includes(event.key)) return;
+      event.preventDefault(); layout.ratio = event.key === 'Home' ? .25 : event.key === 'End' ? .75 : Math.max(.25,Math.min(.75,layout.ratio+(event.key === increase ? .05 : -.05)));
+      save(); appearance();
+    });
+    mobile.addEventListener('change', appearance);
+  }
+  window.addEventListener('message', event => {
+    const source = host.embedded ? window.parent : frame?.contentWindow;
+    if (!validMessage(event, source, location.origin, host.project())) return;
+    const data = event.data;
+    if (host.embedded) {
+      if (data.action === 'preferences') {
+        applyingParentPreferences = true;
+        try { ui.update(data.preferences); } finally { applyingParentPreferences = false; }
+      }
+      return;
+    }
+    if (!layout.open) return;
+    if (data.action === 'ready') post('preferences');
+    if (data.action === 'selection') {
+      if (data.session && host.sessions().some(item => item.id === data.session && item.status === 'running')) {
+        clearTimeout(timer); status.hidden = true; byId('workspaceRetry').hidden = true;
+        layout.session = data.session; mounted = JSON.stringify([root,data.session]); select.value = data.session; save();
+      }
+    }
+    if (data.action === 'preferences') ui.update(data.preferences);
+  });
+  window.addEventListener('hcc:preferences', () => { if (!host.embedded) { sync(); if (frame) frame.title = tr('workspace.secondary'); } if (!applyingParentPreferences) post('preferences'); });
+  window.addEventListener('pagehide', destroy);
+  window.hccWorkspace = {open, close, sync, reset, access:appearance, destroy, primary:() => pickPane('primary'), get isOpen() { return layout.open; }};
+  if (host.embedded) { post('ready'); } else sync();
+}
+
+export function workspaceScript() {
+  return '(' + workspaceRuntime.toString() + ')(' + normalizeWorkspaceLayout.toString() + ',' + workspaceMessageValid.toString() + ');';
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@logicseek/hello-cc",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Local control plane for coordinating Claude Code, Codex, and other coding CLI sessions.",
   "type": "module",
   "bin": {
@@ -19,7 +19,8 @@
     "docs/"
   ],
   "engines": {
-    "node": ">=24.0.0"
+    "node": ">=24.0.0",
+    "dsh": "0.2.0-rc.2"
   },
   "scripts": {
     "release:notes": "node ./scripts/release-notes.mjs",
@@ -55,9 +56,16 @@
   ],
   "dependencies": {
     "@xterm/addon-fit": "^0.11.0",
+    "@xterm/addon-search": "0.16.0",
     "@xterm/xterm": "^6.0.0",
     "node-pty": "1.2.0-beta.15",
     "ws": "^8.21.0"
   },
-  "license": "Apache-2.0"
+  "license": "Apache-2.0",
+  "dsh": {
+    "manifestVersion": 1,
+    "bundle": {
+      "patch": "./lib/integrations/dsh.bundle.yml"
+    }
+  }
 }

package/scripts/check-free-identifiers.mjs

@@ -119,6 +119,37 @@ function stripCommentsAndStrings(source) {
 function collectBindings(stripped, factoryStart) {
   const bound = new Set();
   const body = stripped;
+  // Split variable declarations only at top-level commas: initializer object
+  // keys, calls and array values must never be mistaken for declared names.
+  for (const m of body.matchAll(/\b(?:const|let|var)\s+/g)) {
+    let start = m.index + m[0].length;
+    let depth = 0;
+    for (let i = start; i < body.length; i += 1) {
+      const ch = body[i];
+      if ('([{'.includes(ch)) depth += 1;
+      if (')]}'.includes(ch)) {
+        if (depth === 0) break;
+        depth -= 1;
+      }
+      if (depth === 0 && (ch === ',' || ch === ';')) {
+        for (const leaf of parameterBindings(body.slice(start, i).split('=')[0])) bound.add(leaf);
+        start = i + 1;
+        if (ch === ';') break;
+      }
+      if (depth === 0 && /^\s+(?:of|in)\s/.test(body.slice(i))) {
+        for (const leaf of parameterBindings(body.slice(start, i))) bound.add(leaf);
+        break;
+      }
+    }
+  }
+  for (const m of body.matchAll(/\bfunction\s+[A-Za-z_$][\w$]*\s*\(/g)) {
+    const parameters = balancedContents(body, m.index + m[0].length - 1, '(', ')');
+    for (const leaf of parameterBindings(parameters)) bound.add(leaf);
+  }
+  for (const m of body.matchAll(/\b(?:const|let|var)\s*\{/g)) {
+    const declaration = balancedContents(body, m.index + m[0].length - 1, '{', '}');
+    for (const leaf of parameterBindings(declaration)) bound.add(leaf);
+  }
 
   // imports (whole file)
   for (const m of body.matchAll(/import\s+(?:\*\s+as\s+)?([A-Za-z_$][\w$]*)/g)) bound.add(m[1]);
@@ -141,10 +172,17 @@ function collectBindings(stripped, factoryStart) {
   // function declarations + their parameters
   for (const m of body.matchAll(/(?:^|\n)\s*(?:export\s+)?(?:default\s+)?(?:async\s+)?function\s*\*?\s*([A-Za-z_$][\w$]*)?\s*\(([^)]*)\)/g)) {
     if (m[1]) bound.add(m[1]);
-    for (const p of m[2].split(',')) {
-      const name = p.trim().split(/[=\s]/)[0].replace(/^\.\.\./, '');
-      for (const leaf of destructLeaves(name)) bound.add(leaf);
-    }
+    for (const leaf of parameterBindings(m[2])) bound.add(leaf);
+  }
+  // Object/class methods and destructured options are ordinary local bindings.
+  // Keep this scanner conservative, like its file-wide declaration collection.
+  for (const m of body.matchAll(/(?:^|[\n,{])\s*(?:async\s+)?([A-Za-z_$][\w$]*)\s*\(/g)) {
+    if (['if', 'while', 'switch', 'catch', 'for'].includes(m[1])) continue;
+    const start = m.index + m[0].length - 1;
+    const parameters = balancedContents(body, start, '(', ')');
+    if (!/^\s*\{/.test(body.slice(start + parameters.length + 2))) continue;
+    bound.add(m[1]);
+    for (const leaf of parameterBindings(parameters)) bound.add(leaf);
   }
   // const/let/var with destructuring or plain names
   for (const m of body.matchAll(/(?:^|[^.\w$])(?:const|let|var)\s+([A-Za-z_$][\w$]*|\{[^}]*\})\s*[=;]/g)) {
@@ -161,9 +199,7 @@ function collectBindings(stripped, factoryStart) {
   }
   // arrow function parameters: (a, b) => / single a =>
   for (const m of body.matchAll(/\(\s*([^()]*?)\s*\)\s*=>/g)) {
-    for (const p of m[1].split(',')) {
-      for (const leaf of destructLeaves(p.trim().split(/[=\s]/)[0].replace(/^\.\.\./, ''))) bound.add(leaf);
-    }
+    for (const leaf of parameterBindings(m[1])) bound.add(leaf);
   }
   for (const m of body.matchAll(/(?:^|[^.\w$])([A-Za-z_$][\w$]*)\s*=>/g)) bound.add(m[1]);
   // object literal shorthand keys are uses of bindings, but `{ name }` in a
@@ -186,8 +222,29 @@ function destructLeaves(fragment) {
   return leaves;
 }
 
+function parameterBindings(parameters) {
+  const result = [];
+  // Default expressions are not bindings; after literal stripping their
+  // identifiers still belong to existing imports or declarations.
+  for (const piece of parameters.replace(/[{}\[\]]/g, '').split(',')) {
+    const declaration = piece.split('=')[0].trim();
+    const name = declaration.split(':').pop()?.trim().replace(/^\.\.\./, '');
+    if (name && /^[A-Za-z_$][\w$]*$/.test(name)) result.push(name);
+  }
+  return result;
+}
+
+function balancedContents(source, start, open, close) {
+  let depth = 0;
+  for (let i = start; i < source.length; i += 1) {
+    if (source[i] === open) depth += 1;
+    if (source[i] === close && --depth === 0) return source.slice(start + 1, i);
+  }
+  return '';
+}
+
 const JS_GLOBALS = new Set(('globalThis global console process require module exports Buffer URL URLSearchParams'
-  + ' Array Object String Number Boolean Math JSON Date Promise Symbol BigInt Map Set WeakMap WeakSet'
+  + ' Array Object String Number Boolean Math JSON Date Promise Symbol BigInt Map Set WeakMap WeakSet Proxy Reflect'
   + ' RegExp Error TypeError RangeError SyntaxError ReferenceError EvalError URIError AggregateError'
   + ' parseInt parseFloat isNaN isFinite encodeURIComponent decodeURIComponent'
   + ' undefined NaN Infinity setTimeout setInterval clearTimeout setImmediate clearImmediate queueMicrotask'
@@ -244,6 +301,8 @@ const KNOWN_FALSE_POSITIVES = {
   'lib/cli/commands/doctor.mjs': ['connectReadOnly', 'k', 'v', 'wal'],
   'lib/cli/commands/gc.mjs': ['add', 'apply', 'dry', 'entries', 'gcCutoff', 'id', 'lock', 'run', 'to', 'yes'],
   'lib/cli/commands/install.mjs': ['cc', 'n'],
+  // Literal query key in a nested template interpolation; opts.peer is bound.
+  'lib/cli/commands/native.mjs': ['peer'],
   'lib/cli/commands/peer.mjs': ['pid'],
   'lib/cli/commands/task.mjs': ['child'],
   'lib/cli/commands/team.mjs': ['assignee', 'count', 'owner', 'status'],

package/scripts/codex-diagnostics-installed-acceptance.mjs

@@ -0,0 +1,72 @@
+// Read-only installed CLI diagnostics in a disposable project/home. No model,
+// account configuration, existing session, or user project is used.
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { createHash } from 'node:crypto';
+import { spawnSync } from 'node:child_process';
+import { DatabaseSync } from 'node:sqlite';
+import { fileURLToPath } from 'node:url';
+import { initSchema } from '../lib/db/schema.mjs';
+
+const directory = fs.mkdtempSync(path.join(os.tmpdir(), 'hcc-installed-diagnostics-'));
+const root = path.join(directory, 'project');
+const home = path.join(directory, 'home');
+const codexHome = path.join(directory, 'codex-home');
+const state = path.join(root, '.hello-cc');
+for (const entry of [state, home, codexHome]) fs.mkdirSync(entry, { recursive: true });
+const db = new DatabaseSync(path.join(state, 'mesh.db'));
+try { initSchema(db); } finally { db.close(); }
+fs.writeFileSync(path.join(codexHome, 'hooks.json'), '{}\n');
+const cli = fileURLToPath(new URL('../bin/hcc.mjs', import.meta.url));
+const env = { PATH: process.env.PATH, HOME: home, CODEX_HOME: codexHome,
+  HCC_SHIM_NO_ATTACH: '1', HCC_SHIM_ENSURED: '1' };
+
+function files(parent = directory) {
+  return fs.readdirSync(parent, { withFileTypes: true }).flatMap(entry => {
+    const file = path.join(parent, entry.name);
+    return entry.isDirectory() ? files(file) : [[path.relative(directory, file),
+      createHash('sha256').update(fs.readFileSync(file)).digest('hex')]];
+  }).sort(([left], [right]) => left.localeCompare(right));
+}
+
+function doctor(args = []) {
+  const result = spawnSync(process.execPath, [cli, '--root', root, '--json', 'doctor', ...args], {
+    cwd: root, env, encoding: 'utf8', timeout: 15000, maxBuffer: 128 * 1024,
+    stdio: ['ignore', 'pipe', 'pipe']
+  });
+  // Do not expose arbitrary executable/configuration output on failure.
+  assert.equal(result.error, undefined, 'Isolated doctor process failed');
+  assert.equal(result.status, 0, 'Isolated doctor rejected the healthy database');
+  const response = JSON.parse(result.stdout);
+  assert.equal(response.ok, true, 'Isolated doctor did not return a successful report');
+  return response.data;
+}
+
+let evidence;
+try {
+  const before = files();
+  const plain = doctor();
+  assert.equal(Object.hasOwn(plain, 'codex'), false, 'Default doctor unexpectedly probes Codex');
+  const report = doctor(['--codex']);
+  assert.equal(report.codex.installed.status, 'present');
+  assert.equal(report.codex.version.status, 'known');
+  assert.equal(report.codex.app_server.status, 'advertised');
+  assert.ok(report.codex.app_server.startup_arguments?.length);
+  assert.equal(report.codex.app_server.protocol_handshake, 'unknown');
+  assert.equal(report.codex.hooks.configuration.status, 'missing');
+  assert.equal(report.codex.hooks.invocation.status, 'unknown');
+  assert.equal(report.codex.hooks.stdout_delivery_receipt.status, 'unknown');
+  assert.equal(report.codex.hooks.provider_acceptance, 'unknown');
+  assert.equal(report.codex.hooks.trust, 'unknown');
+  assert.deepEqual(files(), before, 'Diagnostics changed the project, home, or hook configuration');
+  evidence = { installedVersion: report.codex.version.value,
+    appServerStartupArguments: report.codex.app_server.startup_arguments,
+    defaultDoctorDatabaseOnly: true, projectAndHomeUnchanged: true,
+    configurationDoesNotProveDeliveryOrTrust: true, inferenceCalled: false };
+} finally {
+  fs.rmSync(directory, { recursive: true, force: true });
+}
+console.log(JSON.stringify({ ...evidence, temporaryDirectoriesRemoved: true }));
+console.log('INSTALLED_CODEX_DIAGNOSTICS_OK');