@goodandready/dsh-moa 0.2.55 → 0.2.57

package/README.md

@@ -51,6 +51,7 @@ Single-model AI generation often suffers from blind spots, single-perspective bi
 8. **Fast Mode & Custom Judge Criteria**: Ultra-fast single-model preset for quick tasks and customizable evaluation guidelines for the judge.
 9. **Run History & Win-Rate Leaderboard**: Persistent logging of every run kind (synthesis, fast mode, questionnaire) with built-in REST endpoints (`/dsh-moa/history`, `/dsh-moa/leaderboard`, `/dsh-moa/runs/<id>`).
 10. **Live Canvas 1-Click Preview (optional)**: when the `@goodandready/dsh-live-canvas` plugin is installed in the same profile, the promoted HTML is pushed to its sandbox and the MoA answer carries a one-click preview link; without it the step is skipped silently.
+11. **Interactive Workbench (File Scoring 1–10, User Pick & Mix, Top-Model Glue & Judge Re-Check)**: Judge scores each candidate file (1–10) with pros and cons. Users can mix and match files across proposals in the WebUI. The turn's top-performing reference model harmonizes cross-file imports and contracts, followed by a final judge re-audit before promotion. Companion integration with [`dsh-time-machine`](https://github.com/goodandready/dsh-time-machine) for safe pre-promotion rollback checkpoints.
 
 ---
 
@@ -150,7 +151,7 @@ Inspect line-by-line differences between candidate proposals and the curator's s
 Before promoting any winning candidate files over the workspace root, `dsh-moa` invokes the local `dsh-time-machine` service to create a shadow Git checkpoint (`moa-pre-promotion: candidate-N`). If `dsh-time-machine` is absent or unreachable, file promotion is blocked (fail-closed) to protect uncheckpointed workspace files against unintended overwrites (override with `force: true` only when automated checkpoints are explicitly unneeded).
 
 ### 9. Automated Test Execution Gate
-When `test_gate_enabled: true` and `test_command` (e.g. `npm test` or `pytest`) are configured, candidate code is executed in an ephemeral sandbox overlay. The test sandbox uses process containment fences and path validation to block unauthorized host file access and computed shell evasion (base64/eval/pipes), while allowing safe HTTP route literals. The judge receives concrete test outcomes, durations, and output logs to ground decisions in objective verification.
+When `test_gate_enabled: true` and `test_command` (e.g. `npm test` or `pytest`) are configured, candidate code is executed in an ephemeral sandbox overlay under Node.js native permission model (`--permission`) and an ephemeral runtime fence (`lib/moa-sandbox.js`). Without OS-level container isolation (bubblewrap), child process execution is strictly prohibited (`--allow-child-process` is omitted) to prevent candidate scripts from stripping `NODE_OPTIONS` and escaping sandbox restrictions (#260). Package manager commands (`npm test`, `pnpm test`) are resolved directly to underlying `package.json` test scripts, while any evasion patterns (`env -u NODE_OPTIONS`, `unset NODE_OPTIONS`, computed shell evasion) are detected and fail-closed prior to execution. The judge receives concrete test outcomes, durations, and output logs to ground decisions in objective verification.
 
 ### 10. Multi-Judge Panel & Consensus Voting
 When `multi_judge_enabled: true`, candidate solutions are independently evaluated by a panel of judge models. Winner selection supports `majority`, `highest_score`, or `unanimous` consensus strategies.
@@ -335,7 +336,7 @@ npm test
 ## 🛠️ Internal Tooling & Development
 
 For local verification and package integrity validation:
-- `npm test`: runs the full test suite (288 tests)
+- `npm test`: runs the full test suite (294 tests)
 - `./deploy.sh`: local infrastructure validation script (verifies package size, identity parity in package.json/cordis.patch.yml/client.js, and tests). Excluded from the published npm package.
 
 ## 📄 License

package/README.ru.md

@@ -51,6 +51,7 @@
 8. **Быстрый режим (Fast Mode) и критерии судьи**: Режим для одиночных быстрых задач без судьи и гибкая настройка фокуса оценки (безопасность, производительность, минимализм).
 9. **История запусков и лидерборд моделей**: Персистентное логирование всех видов запусков (синтез, fast mode, опросник) и REST-эндпоинты (`/dsh-moa/history`, `/dsh-moa/leaderboard`, `/dsh-moa/runs/<id>`).
 10. **Live Canvas 1-клик предпросмотр (опционально)**: если в профиле установлен `@goodandready/dsh-live-canvas`, промоученный HTML отправляется в его песочницу, а ответ MoA содержит ссылку на предпросмотр в 1 клик; без плагина шаг тихо пропускается.
+11. **Интерактивный воркбенч (Оценка файлов 1–10, выбор в UI, склейка лучшей моделью и повторный аудит)**: Судья оценивает каждый сгенерированный файл каждого кандидата (1–10) с указанием ключевых плюсов и минусов. Пользователь комбинирует желаемый набор файлов в WebUI; лучшая модель раунда вызывается для гармонизации импортов и контрактов, после чего судья выполняет финальную валидацию перед промоушеном. Совместимо с [`dsh-time-machine`](https://github.com/goodandready/dsh-time-machine) для безопасных теневых снимков Git.
 
 ---
 
@@ -150,7 +151,7 @@ graph TD
 Перед промоушном файлов победителя в корень рабочей области `dsh-moa` автоматически обращается к сервису `dsh-time-machine` для создания снимка (`moa-pre-promotion: candidate-N`). Если плагин недоступен или создание снимка завершилось ошибкой, перезапись файлов блокируется во избежание потери несохранённых данных (переопределяется параметром `force: true`, только если создание снимков намеренно отключено).
 
 ### 9. Автоматический шлюз выполнения тестов (Automated Test Execution Gate)
-При включении `test_gate_enabled: true` и указании тестовой команды (`test_command`, например `npm test` или `pytest`) каждый кандидат запускается в изолированном оверлейном окружении с защитой от выхода за пределы песочницы (блокировка вычисляемых shell-команд base64/eval/pipes при сохранении безопасных строковых REST-маршрутов). Судья получает объективный вердикт с кодами возврата, временем исполнения и логами тестов до вынесения итогового решения.
+При включении `test_gate_enabled: true` и указании тестовой команды (`test_command`, например `npm test` или `pytest`) каждый кандидат запускается в изолированном оверлейном окружении под нативной моделью прав Node.js (`--permission`) и рантайм-фенсом (`lib/moa-sandbox.js`). При отсутствии изоляции уровня ОС (bubblewrap) создание дочерних процессов строго запрещено (флаг `--allow-child-process` исключён), что предотвращает обход песочницы через сброс `NODE_OPTIONS` (#260). Команды пакетных менеджеров (`npm test`, `pnpm test`) разрешаются напрямую в скрипты `package.json`, а любые векторы уклонения (`env -u NODE_OPTIONS`, `unset NODE_OPTIONS`, base64/eval/pipes) блокируются до запуска. Судья получает объективный вердикт с кодами возврата, временем исполнения и логами тестов до вынесения итогового решения.
 
 ### 10. Коллегия судей и консенсусное голосование (Multi-Judge Panel)
 При активации опции `multi_judge_enabled` решения кандидатов оценивает независимая панель судейских моделей с поддержкой стратегий голосования: `majority` (большинство), `highest_score` (наивысший средний балл) или `unanimous` (единогласный консенсус).

package/README.zh.md

@@ -51,6 +51,7 @@
 8. **快速模式与自定义评审标准**：面向快速任务的单模型极简管线，以及可自定义的裁判评审准则。
 9. **运行历史与胜率排行榜**：对每一类运行（综合、快速模式、问卷）进行持久化记录，并内置 REST 端点（`/dsh-moa/history`、`/dsh-moa/leaderboard`、`/dsh-moa/runs/<id>`）。
 10. **Live Canvas 一键预览（可选）**：当同一 profile 中安装了 `@goodandready/dsh-live-canvas` 时，提升到项目根目录的 HTML 会被推入其沙箱，MoA 回答附带一键预览链接；未安装时该步骤静默跳过。
+11. **交互式工作台 (1-10分文件打分、自由混搭、最优模型粘合与裁判复审)**：裁判对每个候选模型生成的每个文件进行 1–10 分打分并列出优缺点。用户可在 WebUI 中自由勾选组合所需文件；当轮最高分模型被调用以粘合协同跨文件导入与类型接口，随后由裁判进行最终复审。支持配套插件 [`dsh-time-machine`](https://github.com/goodandready/dsh-time-machine) 在文件提升前创建影子 Git 回滚快照。
 
 ---
 
@@ -150,6 +151,9 @@ graph TD
 ### 8. 提升前 Git 快照检查点 (`dsh-time-machine`)
 在将胜出候选者的文件提升并覆盖至项目根目录前，`dsh-moa` 自动调用本地 `dsh-time-machine` 建立影子 Git 检查点 (`moa-pre-promotion: candidate-N`)。如 `dsh-time-machine` 未安装或无法访问，文件提升将被阻断以防止未备份的项目文件被意外覆盖（仅在明确不需要检查点时可通过 `force: true` 覆盖）。
 
+### 9. 自动化测试执行网关 (Automated Test Execution Gate)
+当启用 `test_gate_enabled: true` 并配置 `test_command`（如 `npm test` 或 `pytest`）时，候选代码将在临时沙箱覆盖层中执行。沙箱基于 Node.js 原生权限模型（`--permission`）与运行时防护栏（`lib/moa-sandbox.js`）。在无操作系统级容器隔离（bubblewrap）时，严格禁用子进程创建（省略 `--allow-child-process`），杜绝候选代码通过剥离 `NODE_OPTIONS` 逃逸沙箱 (#260)。包管理器命令（`npm test`）直接映射到底层脚本，并在执行前严密拦截任何规避意图（`env -u NODE_OPTIONS`、`unset NODE_OPTIONS` 等）。裁判在最终决策前将获取客观的测试结果、耗时与输出日志。
+
 ### 18. 平滑降级与本地容灾恢复 (Local Fallback Resilience)
 当 `local_fallback_enabled: true` 时，因网络中断、超时或速率限制（429/500）而失败的候选模型会自动使用配置的本地模型（Ollama / MiniPC）恢复。每个后备模型都拥有独立的超时执行配额与关联主 turn signal 的隔离取消控制器，防止云端超时耗尽本地恢复时间。同时严格检测终止错误与流中断，确保安全容灾且杜绝已取消 turn 的延迟文件提升。
 

package/lib/client.js

@@ -204,6 +204,31 @@ window.__ModuleLoader__.load({
       'diff.select_run': 'Run:',
       'diff.latest_run': 'Latest / Active Workspace',
       'updater.success': 'Successfully updated to v{version}. Restart DSH to apply.',
+
+      // Interactive Workbench (#251)
+      'aggregator.workbench_title': '🛠️ Interactive Workbench (1-10 File Scoring & Top-Model Glue)',
+      'aggregator.workbench_desc': 'Judge scores each candidate file from 1 to 10 with pros/cons. Select desired files across candidates; top model harmonizes and glues them, followed by final judge audit.',
+      'aggregator.workbench_companion': 'Companion Plugin:',
+      'aggregator.workbench_companion_note': 'safe shadow Git checkpoints before file promotion',
+      'workbench.title': '🛠️ Interactive Synthesis Workbench',
+      'workbench.desc': 'Inspect candidate file quality scores (1–10), mix and match files across proposals, harmonize with top-model glue, and run a final judge audit.',
+      'workbench.select_run': 'MoA Run:',
+      'workbench.latest_run': 'Select Run…',
+      'workbench.no_runs': 'No MoA runs with file candidates recorded yet.',
+      'workbench.empty_files': 'No candidate files found for this run.',
+      'workbench.file_header': 'Project File',
+      'workbench.candidate_header': 'Candidate Versions & Scores (1-10)',
+      'workbench.instructions_label': 'Harmonization Instructions (Optional):',
+      'workbench.instructions_placeholder': 'e.g. Ensure all imports match, unify TypeScript types, align function signatures...',
+      'workbench.assemble_btn': '🚀 Harmonize & Assemble (Top-Model Glue)',
+      'workbench.assembling': '⏳ Harmonizing files with Top Model...',
+      'workbench.recheck_title': '⚖️ Judge Re-Audit Verdict',
+      'workbench.audit_passed': 'PASSED',
+      'workbench.audit_failed': 'FAILED',
+      'workbench.promote_btn': 'Promote Harmonized Files to Workspace',
+      'workbench.promoted_ok': '✅ Harmonized deliverable promoted to workspace root!',
+      'workbench.pros': 'Pros:',
+      'workbench.cons': 'Cons:',
     }
 
     const zh = {
@@ -383,6 +408,31 @@ window.__ModuleLoader__.load({
       'diff.select_run': '运行记录：',
       'diff.latest_run': '最新 / 当前工作区',
       'updater.success': '成功更新至 v{version}，请重启 DSH 使其生效。',
+
+      // Interactive Workbench (#251)
+      'aggregator.workbench_title': '🛠️ 交互式工作台 (1-10分文件打分与最优模型粘合)',
+      'aggregator.workbench_desc': '裁判为每个候选文件打分 (1-10) 并标注优缺点。在 UI 中自由组合各候选文件，由当轮最高分模型进行代码粘合统一，最终由裁判复审。',
+      'aggregator.workbench_companion': '配套插件：',
+      'aggregator.workbench_companion_note': '文件提升前安全创建影子 Git 快照',
+      'workbench.title': '🛠️ 交互式合成工作台',
+      'workbench.desc': '查看候选模型的文件质量打分 (1–10)，自由混搭组合目标文件，由最高分模型粘合统一并执行最终裁判复审。',
+      'workbench.select_run': 'MoA 运行：',
+      'workbench.latest_run': '选择运行记录…',
+      'workbench.no_runs': '暂无生成文件的 MoA 记录。',
+      'workbench.empty_files': '此运行记录未发现候选文件。',
+      'workbench.file_header': '项目文件',
+      'workbench.candidate_header': '候选版本与评分 (1-10)',
+      'workbench.instructions_label': '粘合协同指令（可选）：',
+      'workbench.instructions_placeholder': '例如：对齐导入路径、统一 TypeScript 类型、规范导出接口...',
+      'workbench.assemble_btn': '🚀 粘合与装配 (最优模型)',
+      'workbench.assembling': '⏳ 正在通过最优模型协同粘合文件...',
+      'workbench.recheck_title': '⚖️ 裁判复审判定',
+      'workbench.audit_passed': '通过 (PASSED)',
+      'workbench.audit_failed': '未通过 (FAILED)',
+      'workbench.promote_btn': '提升粘合结果至项目根目录',
+      'workbench.promoted_ok': '✅ 粘合方案已成功提升至项目工作区！',
+      'workbench.pros': '优势：',
+      'workbench.cons': '不足：',
     }
 
 
@@ -1023,6 +1073,408 @@ window.__ModuleLoader__.load({
         )
       )
     }
+    function InteractiveWorkbenchSection({ t, currentRefs = [] }) {
+      const [historyRuns, setHistoryRuns] = React.useState([])
+      const [selectedRunId, setSelectedRunId] = React.useState('')
+      const [workbenchData, setWorkbenchData] = React.useState(null)
+      const [loading, setLoading] = React.useState(false)
+      const [error, setError] = React.useState(null)
+      const [selections, setSelections] = React.useState({})
+      const [instructions, setInstructions] = React.useState('')
+      const [assembling, setAssembling] = React.useState(false)
+      const [assembleResult, setAssembleResult] = React.useState(null)
+      const [assembleError, setAssembleError] = React.useState(null)
+      const [promoting, setPromoting] = React.useState(false)
+      const [promoted, setPromoted] = React.useState(false)
+
+      React.useEffect(() => {
+        fetch('/dsh-moa/history?limit=30', { cache: 'no-store' })
+          .then((r) => r.json())
+          .then((data) => {
+            if (data && data.ok && Array.isArray(data.runs)) {
+              setHistoryRuns(data.runs)
+              if (!selectedRunId && data.runs.length > 0) {
+                const runWithFiles = data.runs.find((r) => r.candidates?.some((c) => c.files?.length > 0)) || data.runs[0]
+                if (runWithFiles?.id) setSelectedRunId(runWithFiles.id)
+              }
+            }
+          })
+          .catch(() => {})
+      }, [])
+
+      React.useEffect(() => {
+        if (!selectedRunId) return
+        setLoading(true)
+        setError(null)
+        setAssembleResult(null)
+        setAssembleError(null)
+        setPromoted(false)
+
+        fetch('/dsh-moa/runs/' + encodeURIComponent(selectedRunId) + '/workbench', { cache: 'no-store' })
+          .then(async (r) => {
+            if (!r.ok) {
+              const errJson = await r.json().catch(() => ({}))
+              throw new Error(errJson.error || ('HTTP ' + r.status))
+            }
+            return r.json()
+          })
+          .then((data) => {
+            setWorkbenchData(data)
+            const initial = {}
+            if (data && data.fileScores && data.fileScores.byFile) {
+              for (const [file, scores] of Object.entries(data.fileScores.byFile)) {
+                if (Array.isArray(scores) && scores.length > 0) {
+                  const sorted = [...scores].sort((a, b) => (b.score || 0) - (a.score || 0))
+                  initial[file] = sorted[0].candidateIndex
+                }
+              }
+            } else if (data && Array.isArray(data.candidates)) {
+              for (const cand of data.candidates) {
+                for (const f of (cand.files || [])) {
+                  if (!initial[f.relativePath]) initial[f.relativePath] = cand.index
+                }
+              }
+            }
+            setSelections(initial)
+          })
+          .catch((err) => {
+            setError(err?.message || String(err))
+          })
+          .finally(() => setLoading(false))
+      }, [selectedRunId])
+
+      const handleAssemble = () => {
+        if (!selectedRunId || Object.keys(selections).length === 0) return
+        setAssembling(true)
+        setAssembleResult(null)
+        setAssembleError(null)
+        setPromoted(false)
+
+        const selArray = Object.entries(selections).map(([file, candidateIndex]) => ({
+          file,
+          candidateIndex: Number(candidateIndex),
+        }))
+
+        fetch('/dsh-moa/runs/' + encodeURIComponent(selectedRunId) + '/workbench/assemble', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({
+            selections: selArray,
+            instructions,
+            autoPromote: false,
+          }),
+        })
+          .then(async (r) => {
+            const resJson = await r.json().catch(() => ({}))
+            if (!r.ok || !resJson.ok) {
+              throw new Error(resJson.error || ('HTTP ' + r.status))
+            }
+            return resJson
+          })
+          .then((data) => {
+            setAssembleResult(data)
+          })
+          .catch((err) => {
+            setAssembleError(err?.message || String(err))
+          })
+          .finally(() => setAssembling(false))
+      }
+
+      const handlePromote = () => {
+        if (!selectedRunId) return
+        setPromoting(true)
+        fetch('/dsh-moa/promote', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({
+            runId: selectedRunId,
+            candidate: 'workbench-glue',
+            force: true,
+          }),
+        })
+          .then(async (r) => {
+            const resJson = await r.json().catch(() => ({}))
+            if (!r.ok || !resJson.ok) throw new Error(resJson.error || ('HTTP ' + r.status))
+            setPromoted(true)
+          })
+          .catch((err) => {
+            setAssembleError('Promotion failed: ' + (err?.message || String(err)))
+          })
+          .finally(() => setPromoting(false))
+      }
+
+      // Collect all files from byFile or candidates
+      const allFiles = []
+      if (workbenchData?.fileScores?.byFile) {
+        for (const file of Object.keys(workbenchData.fileScores.byFile)) {
+          allFiles.push(file)
+        }
+      } else if (Array.isArray(workbenchData?.candidates)) {
+        const fileSet = new Set()
+        for (const c of workbenchData.candidates) {
+          for (const f of (c.files || [])) fileSet.add(f.relativePath)
+        }
+        allFiles.push(...Array.from(fileSet))
+      }
+
+      return React.createElement(
+        'div',
+        { className: 'moa-section-card', style: { marginTop: 12 } },
+        React.createElement('div', { className: 'moa-section-title' }, t('workbench.title') || '🛠️ Interactive Synthesis Workbench'),
+        React.createElement('div', { className: 'moa-section-desc' }, t('workbench.desc') || 'Inspect 1–10 file scores across candidate models, pick & mix desired files, harmonize with top-model glue, and execute judge re-audit.'),
+
+        /* Run Selection Bar */
+        React.createElement(
+          'div',
+          { style: { display: 'flex', alignItems: 'center', gap: 8, marginTop: 10, flexWrap: 'wrap' } },
+          React.createElement('span', { style: { fontSize: 12, fontWeight: 600, color: 'var(--dsw-alias-label-secondary)' } }, t('workbench.select_run') || 'MoA Run:'),
+          React.createElement(
+            'select',
+            {
+              className: 'moa-select',
+              style: { height: 28, fontSize: 12, padding: '0 8px', minWidth: 260, maxWidth: '100%' },
+              value: selectedRunId,
+              onChange: (e) => setSelectedRunId(e.target.value),
+            },
+            historyRuns.length === 0 && React.createElement('option', { value: '' }, t('workbench.no_runs') || 'No runs recorded'),
+            historyRuns.map((r) => {
+              const fileCount = (r.candidates || []).reduce((acc, c) => acc + (c.files?.length || 0), 0)
+              const label = `${(r.prompt || '').slice(0, 36)}... [${fileCount} files, winner: ${r.winnerModel || 'none'}]`
+              return React.createElement('option', { key: r.id, value: r.id }, label)
+            })
+          ),
+          /* Companion Plugin Badge */
+          React.createElement(
+            'div',
+            { style: { marginLeft: 'auto', fontSize: 11, color: 'var(--dsw-alias-label-tertiary, #888)', display: 'flex', alignItems: 'center', gap: 4 } },
+            '🔗 Companion: ',
+            React.createElement(
+              'a',
+              {
+                href: 'https://github.com/goodandready/dsh-time-machine',
+                target: '_blank',
+                rel: 'noopener noreferrer',
+                style: { color: 'var(--dsw-alias-state-brand-primary, #3b82f6)', textDecoration: 'underline' },
+              },
+              'dsh-time-machine'
+            )
+          )
+        ),
+
+        loading && React.createElement('div', { style: { padding: '16px 0', fontSize: 12, color: 'var(--dsw-alias-label-secondary)' } }, '⏳ Loading workbench data...'),
+        error && React.createElement('div', { style: { padding: '8px 12px', background: '#fee2e2', color: '#b91c1c', borderRadius: 6, fontSize: 12, marginTop: 8 } }, error),
+
+        /* File Matrix */
+        !loading && !error && allFiles.length === 0 && React.createElement(
+          'div',
+          { style: { padding: '14px', background: 'var(--dsw-alias-bg-layer-2)', borderRadius: 8, fontSize: 12, color: 'var(--dsw-alias-label-secondary)', marginTop: 8 } },
+          t('workbench.empty_files') || 'No candidate files found for this run.'
+        ),
+
+        !loading && !error && allFiles.length > 0 && React.createElement(
+          'div',
+          { style: { display: 'flex', flexDirection: 'column', gap: 10, marginTop: 12 } },
+          allFiles.map((file) => {
+            const fileScores = workbenchData?.fileScores?.byFile?.[file] || []
+            const selectedCand = selections[file]
+
+            return React.createElement(
+              'div',
+              {
+                key: file,
+                style: {
+                  padding: '10px 12px',
+                  background: 'var(--dsw-alias-bg-layer-2)',
+                  borderRadius: 8,
+                  border: '1px solid var(--dsw-alias-border-l2)',
+                },
+              },
+              /* File Title Bar */
+              React.createElement(
+                'div',
+                { style: { display: 'flex', alignItems: 'center', justifyContent: 'space-between', marginBottom: 8 } },
+                React.createElement(
+                  'span',
+                  { style: { fontFamily: 'monospace', fontSize: 13, fontWeight: 700, color: 'var(--dsw-alias-state-brand-primary, var(--dsw-alias-label-primary))' } },
+                  '📄 ' + file
+                ),
+                React.createElement(
+                  'span',
+                  { style: { fontSize: 11, color: 'var(--dsw-alias-label-secondary)' } },
+                  fileScores.length + ' candidate proposal(s)'
+                )
+              ),
+
+              /* Candidate Choices for this file */
+              React.createElement(
+                'div',
+                { style: { display: 'flex', flexDirection: 'column', gap: 6 } },
+                fileScores.map((scoreItem) => {
+                  const isChecked = selectedCand === scoreItem.candidateIndex
+                  const scoreVal = scoreItem.score || 7
+                  const scoreBg = scoreVal >= 8 ? '#10b981' : (scoreVal >= 5 ? '#f59e0b' : '#ef4444')
+
+                  return React.createElement(
+                    'label',
+                    {
+                      key: scoreItem.candidateIndex,
+                      style: {
+                        display: 'flex',
+                        alignItems: 'flex-start',
+                        gap: 8,
+                        cursor: 'pointer',
+                        padding: '6px 8px',
+                        background: isChecked ? 'rgba(59, 130, 246, 0.08)' : 'transparent',
+                        borderRadius: 6,
+                        border: isChecked ? '1px solid var(--dsw-alias-state-brand-primary, #3b82f6)' : '1px solid transparent',
+                      },
+                    },
+                    React.createElement('input', {
+                      type: 'radio',
+                      name: 'file-' + file,
+                      checked: isChecked,
+                      onChange: () => setSelections((prev) => ({ ...prev, [file]: scoreItem.candidateIndex })),
+                      style: { marginTop: 3, accentColor: 'var(--dsw-alias-state-brand-primary, #3b82f6)' },
+                    }),
+                    React.createElement(
+                      'div',
+                      { style: { flex: 1, fontSize: 12 } },
+                      React.createElement(
+                        'div',
+                        { style: { display: 'flex', alignItems: 'center', gap: 6, flexWrap: 'wrap' } },
+                        React.createElement('span', { style: { fontWeight: 600 } }, scoreItem.candidateLabel || ('Candidate ' + scoreItem.candidateIndex)),
+                        React.createElement(
+                          'span',
+                          {
+                            style: {
+                              fontSize: 10,
+                              fontWeight: 700,
+                              color: '#fff',
+                              background: scoreBg,
+                              padding: '1px 6px',
+                              borderRadius: 4,
+                            },
+                          },
+                          'Score: ' + scoreVal + '/10'
+                        )
+                      ),
+                      scoreItem.pros && React.createElement(
+                        'div',
+                        { style: { fontSize: 11, color: '#16a34a', marginTop: 2 } },
+                        '⭐ ' + (t('workbench.pros') || 'Pros:') + ' ' + scoreItem.pros
+                      ),
+                      scoreItem.cons && React.createElement(
+                        'div',
+                        { style: { fontSize: 11, color: '#dc2626', marginTop: 1 } },
+                        '⚠️ ' + (t('workbench.cons') || 'Cons:') + ' ' + scoreItem.cons
+                      )
+                    )
+                  )
+                })
+              )
+            )
+          }),
+
+          /* Harmonization Instructions Input */
+          React.createElement(
+            'div',
+            { style: { marginTop: 6, display: 'flex', flexDirection: 'column', gap: 4 } },
+            React.createElement('span', { style: { fontSize: 12, fontWeight: 600, color: 'var(--dsw-alias-label-secondary)' } }, t('workbench.instructions_label') || 'Harmonization Instructions (Optional):'),
+            React.createElement('input', {
+              type: 'text',
+              className: 'moa-input',
+              style: { height: 32, fontSize: 12, padding: '0 8px' },
+              placeholder: t('workbench.instructions_placeholder') || 'e.g. Ensure all imports match, unify TypeScript types, align function signatures...',
+              value: instructions,
+              onChange: (e) => setInstructions(e.target.value),
+            })
+          ),
+
+          /* Action Button */
+          React.createElement(
+            'button',
+            {
+              className: 'moa-btn moa-btn-primary',
+              style: { height: 36, fontSize: 13, fontWeight: 600, marginTop: 6 },
+              disabled: assembling || Object.keys(selections).length === 0,
+              onClick: handleAssemble,
+            },
+            assembling ? (t('workbench.assembling') || '⏳ Harmonizing files with Top Model...') : (t('workbench.assemble_btn') || '🚀 Harmonize & Assemble (Top-Model Glue)')
+          ),
+
+          assembleError && React.createElement(
+            'div',
+            { style: { padding: '8px 12px', background: '#fee2e2', color: '#b91c1c', borderRadius: 6, fontSize: 12, marginTop: 8 } },
+            assembleError
+          ),
+
+          /* Harmonization Result Card */
+          assembleResult && React.createElement(
+            'div',
+            {
+              style: {
+                marginTop: 10,
+                padding: '12px',
+                background: 'rgba(16, 185, 129, 0.05)',
+                border: '1px solid #10b981',
+                borderRadius: 8,
+              },
+            },
+            React.createElement(
+              'div',
+              { style: { display: 'flex', alignItems: 'center', justifyContent: 'space-between', marginBottom: 8 } },
+              React.createElement('div', { style: { fontWeight: 700, fontSize: 13, color: '#047857' } }, '✨ Harmonization Complete! Top Model: ' + (assembleResult.topModel || 'Master')),
+              React.createElement(
+                'span',
+                {
+                  style: {
+                    fontSize: 11,
+                    fontWeight: 700,
+                    color: '#fff',
+                    background: assembleResult.judgeAudit?.passed ? '#10b981' : '#ef4444',
+                    padding: '2px 8px',
+                    borderRadius: 4,
+                  },
+                },
+                'Judge: ' + (assembleResult.judgeAudit?.rawVerdict || (assembleResult.judgeAudit?.passed ? 'PASSED' : 'FAILED')) + ' (' + (assembleResult.judgeAudit?.score || 8) + '/10)'
+              )
+            ),
+
+            /* Audit notes */
+            assembleResult.judgeAudit?.notes && React.createElement(
+              'div',
+              { style: { fontSize: 11, color: 'var(--dsw-alias-label-secondary)', marginBottom: 8, background: 'var(--dsw-alias-bg-layer-2)', padding: '6px 8px', borderRadius: 4 } },
+              assembleResult.judgeAudit.notes
+            ),
+
+            /* Glued files */
+            React.createElement(
+              'div',
+              { style: { fontSize: 11, color: 'var(--dsw-alias-label-primary)', marginBottom: 8 } },
+              'Glued Files: ' + (assembleResult.gluedFiles || []).map((f) => `${f.relativePath} (${f.size}B)`).join(', ')
+            ),
+
+            /* Promotion Button */
+            !promoted && React.createElement(
+              'button',
+              {
+                className: 'moa-btn moa-btn-success',
+                style: { height: 32, fontSize: 12, fontWeight: 600 },
+                disabled: promoting,
+                onClick: handlePromote,
+              },
+              promoting ? '⏳ Promoting to workspace...' : (t('workbench.promote_btn') || 'Promote Harmonized Files to Workspace')
+            ),
+
+            promoted && React.createElement(
+              'div',
+              { style: { fontSize: 12, fontWeight: 600, color: '#059669', marginTop: 4 } },
+              t('workbench.promoted_ok') || '✅ Harmonized deliverable promoted to workspace root!'
+            )
+          )
+        )
+      )
+    }
     function MoAEditor({
       t,
       presets,
@@ -1713,6 +2165,44 @@ window.__ModuleLoader__.load({
                 )
               ),
 
+              /* Interactive Workbench & File Scoring (#251) */
+              React.createElement(
+                'div',
+                { style: { display: 'flex', flexDirection: 'column', gap: 6, padding: '8px 12px', background: 'var(--dsw-alias-bg-layer-2)', borderRadius: 8, border: '1px solid var(--dsw-alias-border-l2)', marginTop: 8 } },
+                React.createElement(
+                  'label',
+                  { style: { display: 'flex', alignItems: 'center', gap: 8, cursor: 'pointer', fontSize: 13, fontWeight: 500 } },
+                  React.createElement('input', {
+                    type: 'checkbox',
+                    checked: Boolean(currentPreset.interactive_workbench_enabled),
+                    onChange: (e) => updateCurrentPreset((p) => ({ ...p, interactive_workbench_enabled: e.target.checked })),
+                    style: { accentColor: 'var(--dsw-alias-state-brand-primary, var(--dsw-alias-label-primary))', cursor: 'pointer' },
+                  }),
+                  t('aggregator.workbench_title') || '🛠️ Interactive Workbench (1-10 File Scoring & Top-Model Glue)'
+                ),
+                React.createElement(
+                  'div',
+                  { style: { fontSize: 12, color: 'var(--dsw-alias-label-secondary)', marginLeft: 22 } },
+                  t('aggregator.workbench_desc') || 'Judge scores each candidate file (1–10). Mix and match candidate files in the UI; the top model harmonizes them into a unified project followed by judge re-audit.'
+                ),
+                React.createElement(
+                  'div',
+                  { style: { fontSize: 11, color: 'var(--dsw-alias-label-tertiary, #888)', marginLeft: 22, marginTop: 2, display: 'flex', alignItems: 'center', gap: 4 } },
+                  '🔗 ' + (t('aggregator.workbench_companion') || 'Companion Plugin:'),
+                  React.createElement(
+                    'a',
+                    {
+                      href: 'https://github.com/goodandready/dsh-time-machine',
+                      target: '_blank',
+                      rel: 'noopener noreferrer',
+                      style: { color: 'var(--dsw-alias-state-brand-primary, #3b82f6)', textDecoration: 'underline' },
+                    },
+                    'dsh-time-machine'
+                  ),
+                  '(' + (t('aggregator.workbench_companion_note') || 'safe shadow Git checkpoints before file promotion') + ')'
+                )
+              ),
+
               /* Graceful Degradation & Local Fallback (#175, #176) */
               React.createElement(
                 'div',
@@ -2204,6 +2694,11 @@ window.__ModuleLoader__.load({
           t,
           currentRefs,
         }),
+        /* ── SECTION 4c: INTERACTIVE WORKBENCH (FILE PICK & MIX) ── */
+        React.createElement(InteractiveWorkbenchSection, {
+          t,
+          currentRefs,
+        }),
         /* ── PLUGIN UPDATES ── */
         React.createElement(
           'div',

package/lib/index.js

@@ -325,3 +325,12 @@ export function apply(ctx, config) {
 }
 
 export { executeTestGateForCandidates, runCandidateTestGate } from './moa-test-gate.js'
+export {
+  COMPANION_PLUGINS,
+  formatFileScoresDirective,
+  parseFileScores,
+  findTopModel,
+  assembleWorkbenchSelection,
+  handleWorkbenchGet,
+  handleWorkbenchAssemble,
+} from './moa-workbench.js'

package/lib/moa-prompts.js

@@ -272,6 +272,7 @@ ${referenceOutputs.some((r) => r.testResult) ? `\n${TEST_GATE_DIRECTIVE}\n` : ''
 ${referenceOutputs.some((r) => r.syntaxWarning) ? `
 ${SYNTAX_CORRECTION_DIRECTIVE}
 ` : ''}
+${options.fileScoringDirective ? `\n${options.fileScoringDirective}\n` : ''}
 Instructions:
 Your response MUST be structured into three clear parts:
 
@@ -350,6 +351,7 @@ ${referenceOutputs.some((r) => r.syntaxWarning) ? `\n${SYNTAX_CORRECTION_DIRECTI
 ${options.priorTurnBaseline ? `\n### 🔄 Prior Turn Context Baseline:\n${options.priorTurnBaseline}\n` : ''}
 ${consensusReportText ? `\n### ⚖️ Multi-Judge Consensus Advisory:\n${consensusReportText}\n` : ''}
 ${options.compositeMergeDirective ? `\n${options.compositeMergeDirective}\n` : ''}
+${options.fileScoringDirective ? `\n${options.fileScoringDirective}\n` : ''}
 Instructions:
 Your response MUST be structured into three clear parts: