From 0472a7374be270dc45a34d457911f00527c9c2ad Mon Sep 17 00:00:00 2001
From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com>
Date: Tue, 27 Oct 2026 21:42:17 -0700
Subject: [PATCH 01/12] feat(byo): harness picker rows come from the walk table
 (TASK-361)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The harness picker lists only harnesses with a passing walk on record,
one row each with the connect method and OS dots. Rows are data in
harnessWalkTable.ts, mirroring ~/agents/shared/d15/harness-walk-table.md:
Claude Code, Codex, OpenCode, Qwen Code, DeepSeek Harness (private pods
only). Hermes, goose, pi, Gemini and Grok Build stay hidden. Walked
dots are filled, unwalked dots dashed, never hidden.

Not wired into the BYO form yet; the next PR replaces the adapter
select with this picker after ux-lead gates the render.

Written by Swift, a Commonly agent — https://commonly.me/v2/pods/6a692a1be833c668acdb84cf

Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
Co-authored-by: swift <WyJzd2lmdCIsImRlZmF1bHQiXQ@agents.commonly.invalid>
Agent-Model: claude/claude-haiku-5-5/default
---
 frontend/src/i18n/locales/en.json             | 10 +++
 frontend/src/i18n/locales/zh-CN.json          | 10 +++
 .../src/v2/__tests__/V2HarnessPicker.test.tsx | 63 +++++++++++++++++
 .../src/v2/components/V2HarnessPicker.tsx     | 68 ++++++++++++++++++
 frontend/src/v2/utils/harnessWalkTable.ts     | 69 +++++++++++++++++++
 frontend/src/v2/v2.css                        | 40 +++++++++++
 6 files changed, 260 insertions(+)
 create mode 100644 frontend/src/v2/__tests__/V2HarnessPicker.test.tsx
 create mode 100644 frontend/src/v2/components/V2HarnessPicker.tsx
 create mode 100644 frontend/src/v2/utils/harnessWalkTable.ts

diff --git a/frontend/src/i18n/locales/en.json b/frontend/src/i18n/locales/en.json
index cd41b29eed..7048917b9d 100644
--- a/frontend/src/i18n/locales/en.json
+++ b/frontend/src/i18n/locales/en.json
@@ -1507,6 +1507,16 @@
     "unavailable": "Connection status unavailable."
   },
   "agentByo": {
+    "harnessPicker": {
+      "label": "Harness",
+      "connects": "connects",
+      "mac": "mac",
+      "linux": "linux",
+      "windows": "windows",
+      "connectsCommand": "one command",
+      "connectsTerminal": "terminal steps",
+      "privateOnly": "private pods only"
+    },
     "title": "Bring your own agent",
     "description": "A running agent answers @mentions in its pod.",
     "form": {
diff --git a/frontend/src/i18n/locales/zh-CN.json b/frontend/src/i18n/locales/zh-CN.json
index 1667dc2a2c..7444adfc6f 100644
--- a/frontend/src/i18n/locales/zh-CN.json
+++ b/frontend/src/i18n/locales/zh-CN.json
@@ -1567,6 +1567,16 @@
     "unavailable": "暂时无法获取连接状态。"
   },
   "agentByo": {
+    "harnessPicker": {
+      "label": "运行环境",
+      "connects": "接入方式",
+      "mac": "Mac",
+      "linux": "Linux",
+      "windows": "Windows",
+      "connectsCommand": "一条命令",
+      "connectsTerminal": "终端步骤",
+      "privateOnly": "仅限私有 Pod"
+    },
     "title": "接入你自己的智能体",
     "description": "智能体运行期间会在所在 Pod 回复 @提及。",
     "form": {
diff --git a/frontend/src/v2/__tests__/V2HarnessPicker.test.tsx b/frontend/src/v2/__tests__/V2HarnessPicker.test.tsx
new file mode 100644
index 0000000000..b47cbfce50
--- /dev/null
+++ b/frontend/src/v2/__tests__/V2HarnessPicker.test.tsx
@@ -0,0 +1,63 @@
+// @ts-nocheck
+import React from 'react';
+import { fireEvent, render, screen, within } from '@testing-library/react';
+import V2HarnessPicker from '../components/V2HarnessPicker';
+import { HARNESS_WALK_TABLE, HIDDEN_HARNESS_IDS } from '../utils/harnessWalkTable';
+
+afterEach(() => jest.clearAllMocks());
+
+describe('V2HarnessPicker', () => {
+  it('renders exactly the walked harnesses from the walk table, in table order', () => {
+    render(<V2HarnessPicker selectedId="claude" onSelect={jest.fn()} />);
+    const rows = within(screen.getByTestId('harness-picker')).getAllByRole('button');
+    expect(rows.map((r) => r.getAttribute('data-testid'))).toEqual(
+      HARNESS_WALK_TABLE.map((row) => `harness-row-${row.id}`),
+    );
+    expect(rows.map((r) => r.textContent.replace(/\s+/g, ' ').trim()).join('|')).toContain('Qwen Code');
+  });
+
+  it('never renders a harness that has no walk on record', () => {
+    render(<V2HarnessPicker selectedId="claude" onSelect={jest.fn()} />);
+    HIDDEN_HARNESS_IDS.forEach((id) => {
+      expect(screen.queryByTestId(`harness-row-${id}`)).toBeNull();
+    });
+    expect(screen.queryByText('Hermes')).toBeNull();
+    expect(screen.queryByText('goose')).toBeNull();
+  });
+
+  it('shows Qwen Code and hides Hermes, per the rev 3 walk table', () => {
+    render(<V2HarnessPicker selectedId="claude" onSelect={jest.fn()} />);
+    expect(screen.getByTestId('harness-row-qwen')).toBeInTheDocument();
+    expect(screen.queryByTestId('harness-row-hermes')).toBeNull();
+  });
+
+  it('draws the OS dots from the table: filled when walked, dashed when not', () => {
+    render(<V2HarnessPicker selectedId="claude" onSelect={jest.fn()} />);
+    const claude = screen.getByTestId('harness-row-claude');
+    expect(within(claude).getByTestId('harness-dot-mac')).toHaveAttribute('data-state', 'walked');
+    expect(within(claude).getByTestId('harness-dot-linux')).toHaveAttribute('data-state', 'not-walked');
+    expect(within(claude).getByTestId('harness-dot-windows')).toHaveAttribute('data-state', 'not-walked');
+  });
+
+  it('marks only DeepSeek Harness as private-pods-only', () => {
+    render(<V2HarnessPicker selectedId="claude" onSelect={jest.fn()} />);
+    const privateRows = HARNESS_WALK_TABLE.filter((row) => row.privatePodsOnly).map((row) => row.id);
+    expect(privateRows).toEqual(['dsh']);
+    expect(within(screen.getByTestId('harness-row-dsh')).getByText('private pods only')).toBeInTheDocument();
+  });
+
+  it('marks the selected row and reports the id it picks', () => {
+    const onSelect = jest.fn();
+    render(<V2HarnessPicker selectedId="codex" onSelect={onSelect} />);
+    expect(screen.getByTestId('harness-row-codex')).toHaveAttribute('aria-pressed', 'true');
+    expect(screen.getByTestId('harness-row-claude')).toHaveAttribute('aria-pressed', 'false');
+    fireEvent.click(screen.getByTestId('harness-row-opencode'));
+    expect(onSelect).toHaveBeenCalledWith('opencode');
+  });
+
+  it('uses the connect method from the table for each row', () => {
+    render(<V2HarnessPicker selectedId="claude" onSelect={jest.fn()} />);
+    expect(screen.getByTestId('harness-connects-claude')).toHaveTextContent('one command');
+    expect(screen.getByTestId('harness-connects-opencode')).toHaveTextContent('terminal steps');
+  });
+});
diff --git a/frontend/src/v2/components/V2HarnessPicker.tsx b/frontend/src/v2/components/V2HarnessPicker.tsx
new file mode 100644
index 0000000000..5c3a6d4721
--- /dev/null
+++ b/frontend/src/v2/components/V2HarnessPicker.tsx
@@ -0,0 +1,68 @@
+import React from 'react';
+import { useTranslation } from 'react-i18next';
+import { HARNESS_WALK_TABLE, HarnessOsState, HarnessWalkRow } from '../utils/harnessWalkTable';
+
+interface V2HarnessPickerProps {
+  selectedId: string;
+  onSelect: (id: string) => void;
+}
+
+// One dot per OS: filled when walked, dashed ring when not. A row never hides an OS.
+const OsDot = ({ state, os }: { state: HarnessOsState; os: string }) => (
+  <span
+    className={`v2-harness-picker__dot v2-harness-picker__dot--${state}`}
+    data-testid={`harness-dot-${os}`}
+    data-state={state}
+    aria-hidden="true"
+  />
+);
+
+const HarnessRow = ({ row, selected, onSelect }: { row: HarnessWalkRow; selected: boolean; onSelect: (id: string) => void }) => {
+  const { t } = useTranslation();
+  return (
+    <button
+      type="button"
+      className={`v2-harness-picker__row${selected ? ' v2-harness-picker__row--selected' : ''}`}
+      aria-pressed={selected}
+      data-testid={`harness-row-${row.id}`}
+      onClick={() => onSelect(row.id)}
+    >
+      <span className="v2-harness-picker__name">
+        <span className="v2-harness-picker__mark" aria-hidden="true">{row.monogram}</span>
+        {row.label}
+        {row.privatePodsOnly && (
+          <span className="v2-harness-picker__lock" title={t('agentByo.harnessPicker.privateOnly')}>
+            {t('agentByo.harnessPicker.privateOnly')}
+          </span>
+        )}
+      </span>
+      <span className="v2-harness-picker__connects" data-testid={`harness-connects-${row.id}`}>
+        {row.connects === 'command' ? t('agentByo.harnessPicker.connectsCommand') : t('agentByo.harnessPicker.connectsTerminal')}
+      </span>
+      <OsDot os="mac" state={row.os.mac} />
+      <OsDot os="linux" state={row.os.linux} />
+      <OsDot os="windows" state={row.os.windows} />
+    </button>
+  );
+};
+
+// Renders only the rows in HARNESS_WALK_TABLE. Hidden harnesses have no entry to render.
+const V2HarnessPicker = ({ selectedId, onSelect }: V2HarnessPickerProps) => {
+  const { t } = useTranslation();
+  return (
+    <div className="v2-harness-picker" role="group" aria-label={t('agentByo.harnessPicker.label')} data-testid="harness-picker">
+      <div className="v2-harness-picker__head" aria-hidden="true">
+        <span />
+        <span>{t('agentByo.harnessPicker.connects')}</span>
+        <span>{t('agentByo.harnessPicker.mac')}</span>
+        <span>{t('agentByo.harnessPicker.linux')}</span>
+        <span>{t('agentByo.harnessPicker.windows')}</span>
+      </div>
+      {HARNESS_WALK_TABLE.map((row) => (
+        <HarnessRow key={row.id} row={row} selected={row.id === selectedId} onSelect={onSelect} />
+      ))}
+    </div>
+  );
+};
+
+export default V2HarnessPicker;
diff --git a/frontend/src/v2/utils/harnessWalkTable.ts b/frontend/src/v2/utils/harnessWalkTable.ts
new file mode 100644
index 0000000000..967d974b26
--- /dev/null
+++ b/frontend/src/v2/utils/harnessWalkTable.ts
@@ -0,0 +1,69 @@
+// The harness walk table, as data. Source of truth: ~/agents/shared/d15/harness-walk-table.md
+// (ux-lead, 2026-10-27). A harness is listed in the picker only when it has a passing walk on
+// record. Change a row here only with a new walk on record, and update the table to match.
+
+export type HarnessOsState = 'walked' | 'not-walked';
+
+export interface HarnessWalkRow {
+  id: string;
+  label: string;
+  /** Two-letter stand-in until the vendor's own mark is wired in. */
+  monogram: string;
+  /** `command` = one clipboard command; `terminal` = steps in your terminal. */
+  connects: 'command' | 'terminal';
+  os: { mac: HarnessOsState; linux: HarnessOsState; windows: HarnessOsState };
+  /** Private pods only (lock glyph). */
+  privatePodsOnly: boolean;
+  walkedOn: string;
+}
+
+export const HARNESS_WALK_TABLE: readonly HarnessWalkRow[] = [
+  {
+    id: 'claude',
+    label: 'Claude Code',
+    monogram: 'CC',
+    connects: 'command',
+    os: { mac: 'walked', linux: 'not-walked', windows: 'not-walked' },
+    privatePodsOnly: false,
+    walkedOn: '2026-10-26',
+  },
+  {
+    id: 'codex',
+    label: 'Codex',
+    monogram: 'CX',
+    connects: 'command',
+    os: { mac: 'walked', linux: 'not-walked', windows: 'not-walked' },
+    privatePodsOnly: false,
+    walkedOn: '2026-10-27',
+  },
+  {
+    id: 'opencode',
+    label: 'OpenCode',
+    monogram: 'OC',
+    connects: 'terminal',
+    os: { mac: 'walked', linux: 'not-walked', windows: 'not-walked' },
+    privatePodsOnly: false,
+    walkedOn: '2026-10-27',
+  },
+  {
+    id: 'qwen',
+    label: 'Qwen Code',
+    monogram: 'QW',
+    connects: 'terminal',
+    os: { mac: 'walked', linux: 'not-walked', windows: 'not-walked' },
+    privatePodsOnly: false,
+    walkedOn: '2026-10-27',
+  },
+  {
+    id: 'dsh',
+    label: 'DeepSeek Harness',
+    monogram: 'DS',
+    connects: 'terminal',
+    os: { mac: 'walked', linux: 'not-walked', windows: 'not-walked' },
+    privatePodsOnly: true,
+    walkedOn: '2026-10-23',
+  },
+];
+
+/** Harnesses with no passing walk on record. They never render in the picker. */
+export const HIDDEN_HARNESS_IDS: readonly string[] = ['hermes', 'goose', 'pi', 'gemini', 'grok-build'];
diff --git a/frontend/src/v2/v2.css b/frontend/src/v2/v2.css
index 23f9de9860..da004005dd 100644
--- a/frontend/src/v2/v2.css
+++ b/frontend/src/v2/v2.css
@@ -13346,3 +13346,43 @@ body.modern-ui.v2-canvas {
 .v2-legal__section { margin-bottom: 28px; }
 .v2-legal__section h2 { font-size: 18px; font-weight: 600; margin: 0 0 8px; }
 .v2-legal__section p { font-size: 15px; line-height: 1.6; color: var(--v2-text-secondary); margin: 0 0 8px; }
+
+/* TASK-361 harness picker: one row per walked harness, OS dots from the walk table. */
+.v2-harness-picker { display: flex; flex-direction: column; gap: 8px; }
+.v2-harness-picker__head,
+.v2-harness-picker__row {
+  display: grid;
+  grid-template-columns: 1fr 96px 56px 56px 56px;
+  align-items: center;
+  gap: 12px;
+}
+.v2-harness-picker__head { padding: 0 16px; font-family: var(--v2-font-mono); font-size: 12px; color: var(--v2-text-tertiary); }
+.v2-harness-picker__row {
+  width: 100%;
+  padding: 14px 16px;
+  background: var(--v2-surface);
+  border: 1px solid var(--v2-border);
+  border-radius: var(--v2-radius-sm);
+  color: var(--v2-text-primary);
+  font: inherit;
+  text-align: left;
+  cursor: pointer;
+}
+.v2-harness-picker__row:hover { background: var(--v2-surface-hover); }
+.v2-harness-picker__row--selected { border-color: var(--v2-accent); }
+.v2-harness-picker__name { display: flex; align-items: center; gap: 8px; font-size: 15px; font-weight: 500; }
+.v2-harness-picker__mark {
+  display: inline-grid;
+  place-items: center;
+  width: 28px;
+  height: 28px;
+  border: 1px solid var(--v2-border);
+  border-radius: var(--v2-radius-sm);
+  font-family: var(--v2-font-mono);
+  font-size: 11px;
+}
+.v2-harness-picker__lock { font-size: 12px; font-weight: 400; color: var(--v2-text-tertiary); }
+.v2-harness-picker__connects { font-size: 13px; color: var(--v2-text-secondary); }
+.v2-harness-picker__dot { justify-self: center; width: 8px; height: 8px; border-radius: 50%; }
+.v2-harness-picker__dot--walked { background: var(--v2-ink); }
+.v2-harness-picker__dot--not-walked { border: 1px dashed var(--v2-text-tertiary); }

From 3fffb3a1595b2d8852bfd09d94a55921a13a284a Mon Sep 17 00:00:00 2001
From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com>
Date: Tue, 27 Oct 2026 21:48:37 -0700
Subject: [PATCH 02/12] test(byo): pin the harness picker dot rules in v2.css
 (TASK-361)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Addresses the CodeRabbit finding on #2930: the filled and dashed dot
assertions covered only the state mapping, so removing either CSS rule
would still pass.

Written by Swift, a Commonly agent — https://commonly.me/v2/pods/6a692a1be833c668acdb84cf

Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
Co-authored-by: swift <WyJzd2lmdCIsImRlZmF1bHQiXQ@agents.commonly.invalid>
Agent-Model: claude/claude-haiku-5-5/default
---
 frontend/src/v2/__tests__/V2HarnessPicker.test.tsx | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/frontend/src/v2/__tests__/V2HarnessPicker.test.tsx b/frontend/src/v2/__tests__/V2HarnessPicker.test.tsx
index b47cbfce50..bbfaa1b42b 100644
--- a/frontend/src/v2/__tests__/V2HarnessPicker.test.tsx
+++ b/frontend/src/v2/__tests__/V2HarnessPicker.test.tsx
@@ -3,6 +3,14 @@ import React from 'react';
 import { fireEvent, render, screen, within } from '@testing-library/react';
 import V2HarnessPicker from '../components/V2HarnessPicker';
 import { HARNESS_WALK_TABLE, HIDDEN_HARNESS_IDS } from '../utils/harnessWalkTable';
+import fs from 'fs';
+import path from 'path';
+
+const v2Css = fs.readFileSync(path.join(__dirname, '../v2.css'), 'utf8');
+const ruleBody = (selector) => {
+  const start = v2Css.indexOf(`${selector} {`);
+  return start === -1 ? '' : v2Css.slice(start, v2Css.indexOf('}', start));
+};
 
 afterEach(() => jest.clearAllMocks());
 
@@ -39,6 +47,11 @@ describe('V2HarnessPicker', () => {
     expect(within(claude).getByTestId('harness-dot-windows')).toHaveAttribute('data-state', 'not-walked');
   });
 
+  it('keeps the filled and dashed dot rules in v2.css', () => {
+    expect(ruleBody('.v2-harness-picker__dot--walked')).toContain('background: var(--v2-ink)');
+    expect(ruleBody('.v2-harness-picker__dot--not-walked')).toContain('border: 1px dashed var(--v2-text-tertiary)');
+  });
+
   it('marks only DeepSeek Harness as private-pods-only', () => {
     render(<V2HarnessPicker selectedId="claude" onSelect={jest.fn()} />);
     const privateRows = HARNESS_WALK_TABLE.filter((row) => row.privatePodsOnly).map((row) => row.id);

From 5f3ee978f8ba8d1bed94ea8ed7cfadee7aa59c29 Mon Sep 17 00:00:00 2001
From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com>
Date: Tue, 27 Oct 2026 21:51:47 -0700
Subject: [PATCH 03/12] fix(byo): fit the harness picker at 390 and label each
 OS dot (TASK-361)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

UX FAIL on #2930 at 3fffb3a1: rows overflowed a 320 px row at 390, so the
Windows dot was cut off everywhere and Linux on two rows.

- Connect method is a clipboard or terminal glyph, with the text as its
  title and aria-label.
- DeepSeek Harness gets a lock glyph.
- Grid tightens at 760 px and below.
- Each OS dot has a title and aria-label. Claude Code on Linux and Windows
  reads "connects over MCP only, no @mention listener"; DeepSeek on Linux
  and Windows reads "not offered".
- Walk table gains mcp-only and not-offered OS states.

Not browser-checked here: the 390 render still needs the ux-lead gate.

Written by Swift, a Commonly agent — https://commonly.me/v2/pods/6a692a1be833c668acdb84cf

Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
Co-authored-by: swift <WyJzd2lmdCIsImRlZmF1bHQiXQ@agents.commonly.invalid>
Agent-Model: claude/claude-haiku-5-5/default
---
 frontend/src/i18n/locales/en.json             | 14 +++--
 frontend/src/i18n/locales/zh-CN.json          |  8 ++-
 .../src/v2/__tests__/V2HarnessPicker.test.tsx | 25 ++++++---
 .../src/v2/components/V2HarnessPicker.tsx     | 51 +++++++++++++------
 frontend/src/v2/utils/harnessWalkTable.ts     | 10 ++--
 frontend/src/v2/v2.css                        | 25 ++++++---
 6 files changed, 95 insertions(+), 38 deletions(-)

diff --git a/frontend/src/i18n/locales/en.json b/frontend/src/i18n/locales/en.json
index 7048917b9d..a77d81f80b 100644
--- a/frontend/src/i18n/locales/en.json
+++ b/frontend/src/i18n/locales/en.json
@@ -1510,12 +1510,18 @@
     "harnessPicker": {
       "label": "Harness",
       "connects": "connects",
-      "mac": "mac",
-      "linux": "linux",
-      "windows": "windows",
+      "mac": "Mac",
+      "linux": "Linux",
+      "windows": "Windows",
       "connectsCommand": "one command",
       "connectsTerminal": "terminal steps",
-      "privateOnly": "private pods only"
+      "privateOnly": "private pods only",
+      "osState": {
+        "walked": "Walked on {{os}}",
+        "mcp-only": "{{os}}: connects over MCP only, no @mention listener",
+        "not-walked": "Not walked on {{os}} yet",
+        "not-offered": "Not offered on {{os}}"
+      }
     },
     "title": "Bring your own agent",
     "description": "A running agent answers @mentions in its pod.",
diff --git a/frontend/src/i18n/locales/zh-CN.json b/frontend/src/i18n/locales/zh-CN.json
index 7444adfc6f..65e05167bf 100644
--- a/frontend/src/i18n/locales/zh-CN.json
+++ b/frontend/src/i18n/locales/zh-CN.json
@@ -1575,7 +1575,13 @@
       "windows": "Windows",
       "connectsCommand": "一条命令",
       "connectsTerminal": "终端步骤",
-      "privateOnly": "仅限私有 Pod"
+      "privateOnly": "仅限私有 Pod",
+      "osState": {
+        "walked": "{{os}} 已验证",
+        "mcp-only": "{{os}}：仅通过 MCP 接入，没有 @提及 监听",
+        "not-walked": "{{os}} 尚未验证",
+        "not-offered": "{{os}} 不提供"
+      }
     },
     "title": "接入你自己的智能体",
     "description": "智能体运行期间会在所在 Pod 回复 @提及。",
diff --git a/frontend/src/v2/__tests__/V2HarnessPicker.test.tsx b/frontend/src/v2/__tests__/V2HarnessPicker.test.tsx
index bbfaa1b42b..e3c5372b89 100644
--- a/frontend/src/v2/__tests__/V2HarnessPicker.test.tsx
+++ b/frontend/src/v2/__tests__/V2HarnessPicker.test.tsx
@@ -7,9 +7,10 @@ import fs from 'fs';
 import path from 'path';
 
 const v2Css = fs.readFileSync(path.join(__dirname, '../v2.css'), 'utf8');
+// Body of the first rule whose selector list includes `selector`, so grouped selectors match too.
 const ruleBody = (selector) => {
-  const start = v2Css.indexOf(`${selector} {`);
-  return start === -1 ? '' : v2Css.slice(start, v2Css.indexOf('}', start));
+  const match = v2Css.match(new RegExp(`${selector}[^{}]*\\{([^}]*)\\}`));
+  return match ? match[1] : '';
 };
 
 afterEach(() => jest.clearAllMocks());
@@ -42,9 +43,17 @@ describe('V2HarnessPicker', () => {
   it('draws the OS dots from the table: filled when walked, dashed when not', () => {
     render(<V2HarnessPicker selectedId="claude" onSelect={jest.fn()} />);
     const claude = screen.getByTestId('harness-row-claude');
-    expect(within(claude).getByTestId('harness-dot-mac')).toHaveAttribute('data-state', 'walked');
-    expect(within(claude).getByTestId('harness-dot-linux')).toHaveAttribute('data-state', 'not-walked');
-    expect(within(claude).getByTestId('harness-dot-windows')).toHaveAttribute('data-state', 'not-walked');
+    expect(within(claude).getByTestId('harness-dot-claude-mac')).toHaveAttribute('data-state', 'walked');
+    expect(within(claude).getByTestId('harness-dot-claude-linux')).toHaveAttribute('data-state', 'mcp-only');
+    expect(within(claude).getByTestId('harness-dot-claude-windows')).toHaveAttribute('data-state', 'mcp-only');
+    expect(within(screen.getByTestId('harness-row-codex')).getByTestId('harness-dot-codex-linux')).toHaveAttribute('data-state', 'not-walked');
+  });
+
+  it('titles each OS dot with why it is filled or dashed', () => {
+    render(<V2HarnessPicker selectedId="claude" onSelect={jest.fn()} />);
+    expect(screen.getByTestId('harness-dot-claude-mac')).toHaveAttribute('title', 'Walked on Mac');
+    expect(screen.getByTestId('harness-dot-claude-linux')).toHaveAttribute('title', 'Linux: connects over MCP only, no @mention listener');
+    expect(screen.getByTestId('harness-dot-dsh-windows')).toHaveAttribute('title', 'Not offered on Windows');
   });
 
   it('keeps the filled and dashed dot rules in v2.css', () => {
@@ -56,7 +65,7 @@ describe('V2HarnessPicker', () => {
     render(<V2HarnessPicker selectedId="claude" onSelect={jest.fn()} />);
     const privateRows = HARNESS_WALK_TABLE.filter((row) => row.privatePodsOnly).map((row) => row.id);
     expect(privateRows).toEqual(['dsh']);
-    expect(within(screen.getByTestId('harness-row-dsh')).getByText('private pods only')).toBeInTheDocument();
+    expect(within(screen.getByTestId('harness-row-dsh')).getByRole('img', { name: 'private pods only' })).toBeInTheDocument();
   });
 
   it('marks the selected row and reports the id it picks', () => {
@@ -70,7 +79,7 @@ describe('V2HarnessPicker', () => {
 
   it('uses the connect method from the table for each row', () => {
     render(<V2HarnessPicker selectedId="claude" onSelect={jest.fn()} />);
-    expect(screen.getByTestId('harness-connects-claude')).toHaveTextContent('one command');
-    expect(screen.getByTestId('harness-connects-opencode')).toHaveTextContent('terminal steps');
+    expect(screen.getByTestId('harness-connects-claude')).toHaveAttribute('aria-label', 'one command');
+    expect(screen.getByTestId('harness-connects-opencode')).toHaveAttribute('aria-label', 'terminal steps');
   });
 });
diff --git a/frontend/src/v2/components/V2HarnessPicker.tsx b/frontend/src/v2/components/V2HarnessPicker.tsx
index 5c3a6d4721..e7398cdf76 100644
--- a/frontend/src/v2/components/V2HarnessPicker.tsx
+++ b/frontend/src/v2/components/V2HarnessPicker.tsx
@@ -7,18 +7,37 @@ interface V2HarnessPickerProps {
   onSelect: (id: string) => void;
 }
 
-// One dot per OS: filled when walked, dashed ring when not. A row never hides an OS.
-const OsDot = ({ state, os }: { state: HarnessOsState; os: string }) => (
-  <span
-    className={`v2-harness-picker__dot v2-harness-picker__dot--${state}`}
-    data-testid={`harness-dot-${os}`}
-    data-state={state}
-    aria-hidden="true"
-  />
+const GLYPH_PROPS = { width: 16, height: 16, viewBox: '0 0 24 24', fill: 'none', stroke: 'currentColor', strokeWidth: 1.8, 'aria-hidden': true };
+
+const ClipboardGlyph = () => (
+  <svg {...GLYPH_PROPS}><rect x="6" y="4" width="12" height="17" rx="2" /><path d="M9 4V3h6v1" /></svg>
+);
+const TerminalGlyph = () => (
+  <svg {...GLYPH_PROPS}><rect x="3" y="4" width="18" height="16" rx="2" /><path d="M7 9l3 3-3 3M13 15h4" /></svg>
 );
+const LockGlyph = () => (
+  <svg {...GLYPH_PROPS}><rect x="5" y="11" width="14" height="10" rx="2" /><path d="M8 11V7a4 4 0 0 1 8 0v4" /></svg>
+);
+
+// One dot per OS. Filled when walked, dashed ring otherwise. The title says why.
+const OsDot = ({ state, os, row }: { state: HarnessOsState; os: 'mac' | 'linux' | 'windows'; row: HarnessWalkRow }) => {
+  const { t } = useTranslation();
+  const title = t(`agentByo.harnessPicker.osState.${state}`, { os: t(`agentByo.harnessPicker.${os}`) });
+  return (
+    <span
+      className={`v2-harness-picker__dot v2-harness-picker__dot--${state}`}
+      data-testid={`harness-dot-${row.id}-${os}`}
+      data-state={state}
+      title={title}
+      aria-label={title}
+      role="img"
+    />
+  );
+};
 
 const HarnessRow = ({ row, selected, onSelect }: { row: HarnessWalkRow; selected: boolean; onSelect: (id: string) => void }) => {
   const { t } = useTranslation();
+  const connectsLabel = t(row.connects === 'command' ? 'agentByo.harnessPicker.connectsCommand' : 'agentByo.harnessPicker.connectsTerminal');
   return (
     <button
       type="button"
@@ -29,19 +48,19 @@ const HarnessRow = ({ row, selected, onSelect }: { row: HarnessWalkRow; selected
     >
       <span className="v2-harness-picker__name">
         <span className="v2-harness-picker__mark" aria-hidden="true">{row.monogram}</span>
-        {row.label}
+        <span>{row.label}</span>
         {row.privatePodsOnly && (
-          <span className="v2-harness-picker__lock" title={t('agentByo.harnessPicker.privateOnly')}>
-            {t('agentByo.harnessPicker.privateOnly')}
+          <span className="v2-harness-picker__lock" role="img" title={t('agentByo.harnessPicker.privateOnly')} aria-label={t('agentByo.harnessPicker.privateOnly')}>
+            <LockGlyph />
           </span>
         )}
       </span>
-      <span className="v2-harness-picker__connects" data-testid={`harness-connects-${row.id}`}>
-        {row.connects === 'command' ? t('agentByo.harnessPicker.connectsCommand') : t('agentByo.harnessPicker.connectsTerminal')}
+      <span className="v2-harness-picker__connects" role="img" title={connectsLabel} aria-label={connectsLabel} data-testid={`harness-connects-${row.id}`}>
+        {row.connects === 'command' ? <ClipboardGlyph /> : <TerminalGlyph />}
       </span>
-      <OsDot os="mac" state={row.os.mac} />
-      <OsDot os="linux" state={row.os.linux} />
-      <OsDot os="windows" state={row.os.windows} />
+      <OsDot state={row.os.mac} os="mac" row={row} />
+      <OsDot state={row.os.linux} os="linux" row={row} />
+      <OsDot state={row.os.windows} os="windows" row={row} />
     </button>
   );
 };
diff --git a/frontend/src/v2/utils/harnessWalkTable.ts b/frontend/src/v2/utils/harnessWalkTable.ts
index 967d974b26..c7538c4ab7 100644
--- a/frontend/src/v2/utils/harnessWalkTable.ts
+++ b/frontend/src/v2/utils/harnessWalkTable.ts
@@ -2,7 +2,11 @@
 // (ux-lead, 2026-10-27). A harness is listed in the picker only when it has a passing walk on
 // record. Change a row here only with a new walk on record, and update the table to match.
 
-export type HarnessOsState = 'walked' | 'not-walked';
+/**
+ * walked: passing walk on record. mcp-only: connects, but no @mention listener on this OS.
+ * not-walked: no walk yet. not-offered: the harness does not ship for this OS.
+ */
+export type HarnessOsState = 'walked' | 'mcp-only' | 'not-walked' | 'not-offered';
 
 export interface HarnessWalkRow {
   id: string;
@@ -23,7 +27,7 @@ export const HARNESS_WALK_TABLE: readonly HarnessWalkRow[] = [
     label: 'Claude Code',
     monogram: 'CC',
     connects: 'command',
-    os: { mac: 'walked', linux: 'not-walked', windows: 'not-walked' },
+    os: { mac: 'walked', linux: 'mcp-only', windows: 'mcp-only' },
     privatePodsOnly: false,
     walkedOn: '2026-10-26',
   },
@@ -59,7 +63,7 @@ export const HARNESS_WALK_TABLE: readonly HarnessWalkRow[] = [
     label: 'DeepSeek Harness',
     monogram: 'DS',
     connects: 'terminal',
-    os: { mac: 'walked', linux: 'not-walked', windows: 'not-walked' },
+    os: { mac: 'walked', linux: 'not-offered', windows: 'not-offered' },
     privatePodsOnly: true,
     walkedOn: '2026-10-23',
   },
diff --git a/frontend/src/v2/v2.css b/frontend/src/v2/v2.css
index da004005dd..0e7844f44d 100644
--- a/frontend/src/v2/v2.css
+++ b/frontend/src/v2/v2.css
@@ -13352,11 +13352,12 @@ body.modern-ui.v2-canvas {
 .v2-harness-picker__head,
 .v2-harness-picker__row {
   display: grid;
-  grid-template-columns: 1fr 96px 56px 56px 56px;
+  grid-template-columns: minmax(0, 1fr) 24px 14px 14px 14px;
   align-items: center;
-  gap: 12px;
+  gap: 16px;
 }
 .v2-harness-picker__head { padding: 0 16px; font-family: var(--v2-font-mono); font-size: 12px; color: var(--v2-text-tertiary); }
+.v2-harness-picker__head > span:nth-child(2) { justify-self: center; }
 .v2-harness-picker__row {
   width: 100%;
   padding: 14px 16px;
@@ -13370,10 +13371,11 @@ body.modern-ui.v2-canvas {
 }
 .v2-harness-picker__row:hover { background: var(--v2-surface-hover); }
 .v2-harness-picker__row--selected { border-color: var(--v2-accent); }
-.v2-harness-picker__name { display: flex; align-items: center; gap: 8px; font-size: 15px; font-weight: 500; }
+.v2-harness-picker__name { display: flex; align-items: center; gap: 8px; min-width: 0; font-size: 15px; font-weight: 500; }
 .v2-harness-picker__mark {
   display: inline-grid;
   place-items: center;
+  flex: none;
   width: 28px;
   height: 28px;
   border: 1px solid var(--v2-border);
@@ -13381,8 +13383,19 @@ body.modern-ui.v2-canvas {
   font-family: var(--v2-font-mono);
   font-size: 11px;
 }
-.v2-harness-picker__lock { font-size: 12px; font-weight: 400; color: var(--v2-text-tertiary); }
-.v2-harness-picker__connects { font-size: 13px; color: var(--v2-text-secondary); }
+.v2-harness-picker__lock { display: inline-flex; color: var(--v2-text-tertiary); }
+.v2-harness-picker__connects { display: inline-flex; justify-self: center; color: var(--v2-text-secondary); }
 .v2-harness-picker__dot { justify-self: center; width: 8px; height: 8px; border-radius: 50%; }
 .v2-harness-picker__dot--walked { background: var(--v2-ink); }
-.v2-harness-picker__dot--not-walked { border: 1px dashed var(--v2-text-tertiary); }
+.v2-harness-picker__dot--mcp-only,
+.v2-harness-picker__dot--not-walked,
+.v2-harness-picker__dot--not-offered { border: 1px dashed var(--v2-text-tertiary); }
+
+@media (max-width: 760px) {
+  .v2-harness-picker__head,
+  .v2-harness-picker__row { grid-template-columns: minmax(0, 1fr) 20px 12px 12px 12px; gap: 10px; }
+  .v2-harness-picker__head,
+  .v2-harness-picker__row { padding-left: 12px; padding-right: 12px; }
+  .v2-harness-picker__mark { width: 24px; height: 24px; font-size: 10px; }
+  .v2-harness-picker__name { font-size: 14px; }
+}

From f18a3c5e5f603651899c4a6beab14a0bd214a941 Mon Sep 17 00:00:00 2001
From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com>
Date: Tue, 27 Oct 2026 21:54:50 -0700
Subject: [PATCH 04/12] fix(byo): size harness picker columns to their headings
 (TASK-361)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Re-gate FAIL on #2930 at 5f3ee978: the fixed 12-14 px OS columns were
narrower than their headings, so "connects", "mac", "linux" and "windows"
overlapped at 390 and 1440, and zh 接入方式 stacked four lines.

Columns are now auto-sized and the headings do not wrap. The monogram
stays 11 px at every width.

Written by Swift, a Commonly agent — https://commonly.me/v2/pods/6a692a1be833c668acdb84cf

Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
Co-authored-by: swift <WyJzd2lmdCIsImRlZmF1bHQiXQ@agents.commonly.invalid>
Agent-Model: claude/claude-haiku-5-5/default
---
 frontend/src/v2/v2.css | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/frontend/src/v2/v2.css b/frontend/src/v2/v2.css
index 0e7844f44d..55c96117e0 100644
--- a/frontend/src/v2/v2.css
+++ b/frontend/src/v2/v2.css
@@ -13349,15 +13349,16 @@ body.modern-ui.v2-canvas {
 
 /* TASK-361 harness picker: one row per walked harness, OS dots from the walk table. */
 .v2-harness-picker { display: flex; flex-direction: column; gap: 8px; }
+/* Columns size to their headings (auto), so "connects", "mac", "linux" and "windows" never overlap. */
 .v2-harness-picker__head,
 .v2-harness-picker__row {
   display: grid;
-  grid-template-columns: minmax(0, 1fr) 24px 14px 14px 14px;
+  grid-template-columns: minmax(0, 1fr) auto auto auto auto;
   align-items: center;
   gap: 16px;
 }
 .v2-harness-picker__head { padding: 0 16px; font-family: var(--v2-font-mono); font-size: 12px; color: var(--v2-text-tertiary); }
-.v2-harness-picker__head > span:nth-child(2) { justify-self: center; }
+.v2-harness-picker__head > span { white-space: nowrap; text-align: center; }
 .v2-harness-picker__row {
   width: 100%;
   padding: 14px 16px;
@@ -13393,9 +13394,6 @@ body.modern-ui.v2-canvas {
 
 @media (max-width: 760px) {
   .v2-harness-picker__head,
-  .v2-harness-picker__row { grid-template-columns: minmax(0, 1fr) 20px 12px 12px 12px; gap: 10px; }
-  .v2-harness-picker__head,
-  .v2-harness-picker__row { padding-left: 12px; padding-right: 12px; }
-  .v2-harness-picker__mark { width: 24px; height: 24px; font-size: 10px; }
+  .v2-harness-picker__row { gap: 10px; padding-left: 12px; padding-right: 12px; }
   .v2-harness-picker__name { font-size: 14px; }
 }

From 1a757ffc0f71dc4058ecb5ff8ee48984abce9850 Mon Sep 17 00:00:00 2001
From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com>
Date: Tue, 27 Oct 2026 21:57:21 -0700
Subject: [PATCH 05/12] fix(byo): put the head and rows on the same fixed
 tracks (TASK-361)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Re-gate FAIL on #2930 at f18a3c5e: auto tracks sized the head grid and
each row grid separately, so the heads drifted up to 100 px from their
dots, and at 390 the clipboard sat under "Linux".

The head and every row now use the same fixed tracks (64/60 px, 52/48 px
at 760 px and below), wide enough for the headings, so each head sits
over its dot.

Written by Swift, a Commonly agent — https://commonly.me/v2/pods/6a692a1be833c668acdb84cf

Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
Co-authored-by: swift <WyJzd2lmdCIsImRlZmF1bHQiXQ@agents.commonly.invalid>
Agent-Model: claude/claude-haiku-5-5/default
---
 frontend/src/v2/v2.css | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/frontend/src/v2/v2.css b/frontend/src/v2/v2.css
index 55c96117e0..3cc385ae0e 100644
--- a/frontend/src/v2/v2.css
+++ b/frontend/src/v2/v2.css
@@ -13348,12 +13348,12 @@ body.modern-ui.v2-canvas {
 .v2-legal__section p { font-size: 15px; line-height: 1.6; color: var(--v2-text-secondary); margin: 0 0 8px; }
 
 /* TASK-361 harness picker: one row per walked harness, OS dots from the walk table. */
-.v2-harness-picker { display: flex; flex-direction: column; gap: 8px; }
-/* Columns size to their headings (auto), so "connects", "mac", "linux" and "windows" never overlap. */
+/* The head and every row share the same fixed tracks, so each head sits over its dot. */
+.v2-harness-picker { --hp-connects: 64px; --hp-os: 60px; display: flex; flex-direction: column; gap: 8px; }
 .v2-harness-picker__head,
 .v2-harness-picker__row {
   display: grid;
-  grid-template-columns: minmax(0, 1fr) auto auto auto auto;
+  grid-template-columns: minmax(0, 1fr) var(--hp-connects) repeat(3, var(--hp-os));
   align-items: center;
   gap: 16px;
 }
@@ -13393,7 +13393,9 @@ body.modern-ui.v2-canvas {
 .v2-harness-picker__dot--not-offered { border: 1px dashed var(--v2-text-tertiary); }
 
 @media (max-width: 760px) {
+  .v2-harness-picker { --hp-connects: 52px; --hp-os: 48px; }
   .v2-harness-picker__head,
-  .v2-harness-picker__row { gap: 10px; padding-left: 12px; padding-right: 12px; }
+  .v2-harness-picker__row { gap: 6px; padding-left: 12px; padding-right: 12px; }
+  .v2-harness-picker__head { font-size: 11px; }
   .v2-harness-picker__name { font-size: 14px; }
 }

From fcef4e8ac90b3a254e890843073178e3364f014f Mon Sep 17 00:00:00 2001
From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com>
Date: Tue, 27 Oct 2026 22:00:43 -0700
Subject: [PATCH 06/12] fix(byo): size the phone harness tracks to their
 headings (TASK-361)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Re-gate FAIL on #2930 at 1a757ffc: four fixed 48-52 px tracks left the
name column 76 px, so OpenCode ran into the connects glyph and the
DeepSeek lock sat on it.

At 760 px and below each track is sized to its heading: connects 54,
mac 24, linux 36, windows 48. The name column gets about 136 px with
10 px clear. Desktop keeps 64 and 60 px.

Written by Swift, a Commonly agent — https://commonly.me/v2/pods/6a692a1be833c668acdb84cf

Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
Co-authored-by: swift <WyJzd2lmdCIsImRlZmF1bHQiXQ@agents.commonly.invalid>
Agent-Model: claude/claude-haiku-5-5/default
---
 frontend/src/v2/v2.css | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/frontend/src/v2/v2.css b/frontend/src/v2/v2.css
index 3cc385ae0e..4e34bedcc3 100644
--- a/frontend/src/v2/v2.css
+++ b/frontend/src/v2/v2.css
@@ -13349,11 +13349,11 @@ body.modern-ui.v2-canvas {
 
 /* TASK-361 harness picker: one row per walked harness, OS dots from the walk table. */
 /* The head and every row share the same fixed tracks, so each head sits over its dot. */
-.v2-harness-picker { --hp-connects: 64px; --hp-os: 60px; display: flex; flex-direction: column; gap: 8px; }
+.v2-harness-picker { --hp-connects: 64px; --hp-mac: 60px; --hp-linux: 60px; --hp-windows: 60px; display: flex; flex-direction: column; gap: 8px; }
 .v2-harness-picker__head,
 .v2-harness-picker__row {
   display: grid;
-  grid-template-columns: minmax(0, 1fr) var(--hp-connects) repeat(3, var(--hp-os));
+  grid-template-columns: minmax(0, 1fr) var(--hp-connects) var(--hp-mac) var(--hp-linux) var(--hp-windows);
   align-items: center;
   gap: 16px;
 }
@@ -13393,9 +13393,9 @@ body.modern-ui.v2-canvas {
 .v2-harness-picker__dot--not-offered { border: 1px dashed var(--v2-text-tertiary); }
 
 @media (max-width: 760px) {
-  .v2-harness-picker { --hp-connects: 52px; --hp-os: 48px; }
+  .v2-harness-picker { --hp-connects: 54px; --hp-mac: 24px; --hp-linux: 36px; --hp-windows: 48px; }
   .v2-harness-picker__head,
-  .v2-harness-picker__row { gap: 6px; padding-left: 12px; padding-right: 12px; }
+  .v2-harness-picker__row { gap: 10px; padding-left: 12px; padding-right: 12px; }
   .v2-harness-picker__head { font-size: 11px; }
   .v2-harness-picker__name { font-size: 14px; }
 }

From 948e9e707946b6690dedba7d006dcbd817f5d235 Mon Sep 17 00:00:00 2001
From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com>
Date: Tue, 27 Oct 2026 22:03:24 -0700
Subject: [PATCH 07/12] fix(byo): restore the phone row gap to 6px and let the
 name wrap (TASK-361)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Re-gate FAIL on #2930 at fcef4e8a: the 10 px phone gap took 16 px from
the name column, so the DeepSeek lock touched the terminal glyph.

The ≤760 px row gap goes back to 6 px, and the name wraps so the lock
moves to a new line instead of colliding at 360 px.

Written by Swift, a Commonly agent — https://commonly.me/v2/pods/6a692a1be833c668acdb84cf

Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
Co-authored-by: swift <WyJzd2lmdCIsImRlZmF1bHQiXQ@agents.commonly.invalid>
Agent-Model: claude/claude-haiku-5-5/default
---
 frontend/src/v2/v2.css | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/frontend/src/v2/v2.css b/frontend/src/v2/v2.css
index 4e34bedcc3..5f16ce42e9 100644
--- a/frontend/src/v2/v2.css
+++ b/frontend/src/v2/v2.css
@@ -13372,7 +13372,7 @@ body.modern-ui.v2-canvas {
 }
 .v2-harness-picker__row:hover { background: var(--v2-surface-hover); }
 .v2-harness-picker__row--selected { border-color: var(--v2-accent); }
-.v2-harness-picker__name { display: flex; align-items: center; gap: 8px; min-width: 0; font-size: 15px; font-weight: 500; }
+.v2-harness-picker__name { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; min-width: 0; font-size: 15px; font-weight: 500; }
 .v2-harness-picker__mark {
   display: inline-grid;
   place-items: center;
@@ -13395,7 +13395,7 @@ body.modern-ui.v2-canvas {
 @media (max-width: 760px) {
   .v2-harness-picker { --hp-connects: 54px; --hp-mac: 24px; --hp-linux: 36px; --hp-windows: 48px; }
   .v2-harness-picker__head,
-  .v2-harness-picker__row { gap: 10px; padding-left: 12px; padding-right: 12px; }
+  .v2-harness-picker__row { gap: 6px; padding-left: 12px; padding-right: 12px; }
   .v2-harness-picker__head { font-size: 11px; }
   .v2-harness-picker__name { font-size: 14px; }
 }

From 17af06c352b324ade4bbf3f64239d88b77268068 Mon Sep 17 00:00:00 2001
From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com>
Date: Tue, 27 Oct 2026 22:21:29 -0700
Subject: [PATCH 08/12] fix(byo): declare the mono family on the phone picker
 head (TASK-361)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The ≤760 head sets 11px, which the type-floor check only allows in the
mono family. The rule did not name it, so Frontend tests failed on
v2-type-floors. Name the family in the same rule. No layout change.

Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
Co-authored-by: swift <WyJzd2lmdCIsImRlZmF1bHQiXQ@agents.commonly.invalid>
Agent-Model: claude/claude-haiku-5-5/default
---
 frontend/src/v2/v2.css | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/src/v2/v2.css b/frontend/src/v2/v2.css
index 5f16ce42e9..57c7aec2ba 100644
--- a/frontend/src/v2/v2.css
+++ b/frontend/src/v2/v2.css
@@ -13396,6 +13396,6 @@ body.modern-ui.v2-canvas {
   .v2-harness-picker { --hp-connects: 54px; --hp-mac: 24px; --hp-linux: 36px; --hp-windows: 48px; }
   .v2-harness-picker__head,
   .v2-harness-picker__row { gap: 6px; padding-left: 12px; padding-right: 12px; }
-  .v2-harness-picker__head { font-size: 11px; }
+  .v2-harness-picker__head { font-family: var(--v2-font-mono); font-size: 11px; }
   .v2-harness-picker__name { font-size: 14px; }
 }

From 8e3561d2b749025e05be9aee8075411f2fc08c59 Mon Sep 17 00:00:00 2001
From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com>
Date: Tue, 27 Oct 2026 22:22:48 -0700
Subject: [PATCH 09/12] test(byo): pin the picker's state classes, complete
 selectors and tracks (TASK-361)

- The CSS rule lookup matches a complete selector and ignores comments, so
  a renamed dashed class can no longer pass by prefix.
- Each dot is asserted to carry its state class, including mcp-only and
  not-offered, so removing the class fails the test.
- The layout-invariant suite pins the shared desktop tracks and the 760
  phone block (54/24/36/48, gap 6).

Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
Co-authored-by: swift <WyJzd2lmdCIsImRlZmF1bHQiXQ@agents.commonly.invalid>
Agent-Model: claude/claude-haiku-5-5/default
---
 .../src/v2/__tests__/V2HarnessPicker.test.tsx     | 15 ++++++++++++---
 .../src/v2/__tests__/v2-layout-invariants.test.ts | 14 ++++++++++++++
 2 files changed, 26 insertions(+), 3 deletions(-)

diff --git a/frontend/src/v2/__tests__/V2HarnessPicker.test.tsx b/frontend/src/v2/__tests__/V2HarnessPicker.test.tsx
index e3c5372b89..7235d51ee3 100644
--- a/frontend/src/v2/__tests__/V2HarnessPicker.test.tsx
+++ b/frontend/src/v2/__tests__/V2HarnessPicker.test.tsx
@@ -6,10 +6,11 @@ import { HARNESS_WALK_TABLE, HIDDEN_HARNESS_IDS } from '../utils/harnessWalkTabl
 import fs from 'fs';
 import path from 'path';
 
-const v2Css = fs.readFileSync(path.join(__dirname, '../v2.css'), 'utf8');
-// Body of the first rule whose selector list includes `selector`, so grouped selectors match too.
+const v2Css = fs.readFileSync(path.join(__dirname, '../v2.css'), 'utf8').replace(/\/\*[\s\S]*?\*\//g, '');
+// Body of the first rule whose selector list includes `selector` as a complete selector
+// (not a prefix of a longer class name), so grouped selectors match too.
 const ruleBody = (selector) => {
-  const match = v2Css.match(new RegExp(`${selector}[^{}]*\\{([^}]*)\\}`));
+  const match = v2Css.match(new RegExp(`${selector}(?![\\w-])[^{}]*\\{([^}]*)\\}`));
   return match ? match[1] : '';
 };
 
@@ -49,6 +50,14 @@ describe('V2HarnessPicker', () => {
     expect(within(screen.getByTestId('harness-row-codex')).getByTestId('harness-dot-codex-linux')).toHaveAttribute('data-state', 'not-walked');
   });
 
+  it('gives each dot the state class the stylesheet keys on, for every state', () => {
+    render(<V2HarnessPicker selectedId="claude" onSelect={jest.fn()} />);
+    expect(screen.getByTestId('harness-dot-claude-mac')).toHaveClass('v2-harness-picker__dot--walked');
+    expect(screen.getByTestId('harness-dot-claude-linux')).toHaveClass('v2-harness-picker__dot--mcp-only');
+    expect(screen.getByTestId('harness-dot-codex-linux')).toHaveClass('v2-harness-picker__dot--not-walked');
+    expect(screen.getByTestId('harness-dot-dsh-windows')).toHaveClass('v2-harness-picker__dot--not-offered');
+  });
+
   it('titles each OS dot with why it is filled or dashed', () => {
     render(<V2HarnessPicker selectedId="claude" onSelect={jest.fn()} />);
     expect(screen.getByTestId('harness-dot-claude-mac')).toHaveAttribute('title', 'Walked on Mac');
diff --git a/frontend/src/v2/__tests__/v2-layout-invariants.test.ts b/frontend/src/v2/__tests__/v2-layout-invariants.test.ts
index 9d2d27a90b..36a34db620 100644
--- a/frontend/src/v2/__tests__/v2-layout-invariants.test.ts
+++ b/frontend/src/v2/__tests__/v2-layout-invariants.test.ts
@@ -5150,3 +5150,17 @@ describe('v2 board on a phone (TASK-576)', () => {
     expect(page).toContain('<V2MobileTabs needsYouCount={attention.count ?? 0} />');
   });
 });
+
+describe('harness picker tracks (TASK-361)', () => {
+  const v2 = read('../v2.css');
+  test('the head and the rows share the same fixed tracks on desktop', () => {
+    const rule = ruleBody(v2, '.v2-harness-picker__head,\n.v2-harness-picker__row');
+    expect(rule).toContain('grid-template-columns: minmax(0, 1fr) var(--hp-connects) var(--hp-mac) var(--hp-linux) var(--hp-windows)');
+    expect(ruleBody(v2, '.v2-harness-picker')).toContain('--hp-connects: 64px');
+  });
+  test('the phone block keeps the 54/24/36/48 tracks and the 6px gap', () => {
+    const block = blockContaining(v2, '@media (max-width: 760px)', '.v2-harness-picker__head');
+    expect(block).toContain('--hp-connects: 54px; --hp-mac: 24px; --hp-linux: 36px; --hp-windows: 48px;');
+    expect(ruleBody(block, '.v2-harness-picker__head,\n  .v2-harness-picker__row')).toContain('gap: 6px');
+  });
+});

From aebe8fe0cd64558661091c4f72a9caa7629a6557 Mon Sep 17 00:00:00 2001
From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com>
Date: Tue, 27 Oct 2026 22:52:52 -0700
Subject: [PATCH 10/12] test(byo): match only standalone selectors and pin the
 one-command rows (TASK-361)

- ruleBody escapes the selector and requires it to start a selector-list
  entry and end at a comma or an opening brace, so a compound selector
  such as `.dot--walked.is-active` cannot satisfy the walked-dot check.
- The one-command rows are pinned to claude and codex, so setting another
  harness to 'command' fails a test.

Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
Co-authored-by: swift <WyJzd2lmdCIsImRlZmF1bHQiXQ@agents.commonly.invalid>
Agent-Model: claude/claude-haiku-5-5/default
---
 frontend/src/v2/__tests__/V2HarnessPicker.test.tsx | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/frontend/src/v2/__tests__/V2HarnessPicker.test.tsx b/frontend/src/v2/__tests__/V2HarnessPicker.test.tsx
index 7235d51ee3..3d41c77a75 100644
--- a/frontend/src/v2/__tests__/V2HarnessPicker.test.tsx
+++ b/frontend/src/v2/__tests__/V2HarnessPicker.test.tsx
@@ -10,7 +10,10 @@ const v2Css = fs.readFileSync(path.join(__dirname, '../v2.css'), 'utf8').replace
 // Body of the first rule whose selector list includes `selector` as a complete selector
 // (not a prefix of a longer class name), so grouped selectors match too.
 const ruleBody = (selector) => {
-  const match = v2Css.match(new RegExp(`${selector}(?![\\w-])[^{}]*\\{([^}]*)\\}`));
+  // Escape the selector, then require it to start a selector-list entry and end at a comma or
+  // an opening brace. A compound selector such as `.dot--walked.is-active` does not match.
+  const escaped = selector.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  const match = v2Css.match(new RegExp(`(?:^|[,\\n])\\s*${escaped}\\s*(?=,|\\{)[^{}]*\\{([^}]*)\\}`));
   return match ? match[1] : '';
 };
 
@@ -86,6 +89,10 @@ describe('V2HarnessPicker', () => {
     expect(onSelect).toHaveBeenCalledWith('opencode');
   });
 
+  it('pins the one-command rows to Claude Code and Codex', () => {
+    expect(HARNESS_WALK_TABLE.filter((row) => row.connects === 'command').map((row) => row.id)).toEqual(['claude', 'codex']);
+  });
+
   it('uses the connect method from the table for each row', () => {
     render(<V2HarnessPicker selectedId="claude" onSelect={jest.fn()} />);
     expect(screen.getByTestId('harness-connects-claude')).toHaveAttribute('aria-label', 'one command');

From a35e69dd2b05a8a04401327349f51803ddbf67d8 Mon Sep 17 00:00:00 2001
From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com>
Date: Tue, 27 Oct 2026 23:10:46 -0700
Subject: [PATCH 11/12] fix(i18n): correct harness picker zh-CN strings per
 Vera's review (TASK-361)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- privateOnly: 仅限私有 Pod -> 仅限私密 Pod (matches private-pod copy elsewhere)
- label: 运行环境 -> 工具 (matches BYO firstRun copy; 运行环境 is Runtime placement)
- osState.not-offered: 不提供 -> 上不提供 (cannot read as Linux not offering it)

Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
Co-authored-by: swift <WyJzd2lmdCIsImRlZmF1bHQiXQ@agents.commonly.invalid>
Agent-Model: claude/claude-haiku-5-5/default
---
 frontend/src/i18n/locales/zh-CN.json | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/frontend/src/i18n/locales/zh-CN.json b/frontend/src/i18n/locales/zh-CN.json
index 65e05167bf..f3ad93568a 100644
--- a/frontend/src/i18n/locales/zh-CN.json
+++ b/frontend/src/i18n/locales/zh-CN.json
@@ -1568,19 +1568,19 @@
   },
   "agentByo": {
     "harnessPicker": {
-      "label": "运行环境",
+      "label": "工具",
       "connects": "接入方式",
       "mac": "Mac",
       "linux": "Linux",
       "windows": "Windows",
       "connectsCommand": "一条命令",
       "connectsTerminal": "终端步骤",
-      "privateOnly": "仅限私有 Pod",
+      "privateOnly": "仅限私密 Pod",
       "osState": {
         "walked": "{{os}} 已验证",
         "mcp-only": "{{os}}：仅通过 MCP 接入，没有 @提及 监听",
         "not-walked": "{{os}} 尚未验证",
-        "not-offered": "{{os}} 不提供"
+        "not-offered": "{{os}} 上不提供"
       }
     },
     "title": "接入你自己的智能体",

From 81a5efe1a3cd75b8531523a05a326504404cd316 Mon Sep 17 00:00:00 2001
From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com>
Date: Wed, 28 Oct 2026 21:47:46 -0700
Subject: [PATCH 12/12] fix(i18n): zh-CN harness label and mcp-only state per
 review (TASK-361)

Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
Co-authored-by: swift <WyJzd2lmdCIsImRlZmF1bHQiXQ@agents.commonly.invalid>
Agent-Model: claude/claude-haiku-5-5/default
---
 frontend/src/i18n/locales/zh-CN.json | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/frontend/src/i18n/locales/zh-CN.json b/frontend/src/i18n/locales/zh-CN.json
index f3ad93568a..c6a27e0a09 100644
--- a/frontend/src/i18n/locales/zh-CN.json
+++ b/frontend/src/i18n/locales/zh-CN.json
@@ -1568,7 +1568,7 @@
   },
   "agentByo": {
     "harnessPicker": {
-      "label": "工具",
+      "label": "运行器",
       "connects": "接入方式",
       "mac": "Mac",
       "linux": "Linux",
@@ -1578,7 +1578,7 @@
       "privateOnly": "仅限私密 Pod",
       "osState": {
         "walked": "{{os}} 已验证",
-        "mcp-only": "{{os}}：仅通过 MCP 接入，没有 @提及 监听",
+        "mcp-only": "{{os}}：仅通过 MCP 接入，不会监听 @提及",
         "not-walked": "{{os}} 尚未验证",
         "not-offered": "{{os}} 上不提供"
       }