@goodandready/dsh-moa 0.2.3 → 0.2.5

package/README.md

@@ -37,6 +37,10 @@ Single-model AI generation often suffers from blind spots, single-perspective bi
 4. **Instant Live Canvas Previewing**: When web applications or UI components are generated, `dsh-moa` integrates seamlessly with `@goodandready/dsh-live-canvas`, automatically spawning sandboxes for 1-click browser previewing.
 5. **Token-Saving Chat Summarization**: Replaces massive code dumps in chat bubbles with compact file listings and clean architectural summaries.
 6. **One-Shot Session Model Restoration**: Executes cleanly as a one-shot turn modifier, automatically reverting back to the user's primary session model immediately after completion.
+7. **Dynamic Model Pricing Catalog & Token Estimation**: Real-time rate resolution for 300+ models fetched automatically in the background from OpenRouter's public catalog (cached locally in `~/.dsh/storages/dsh-moa-catalog.json` for 24h), plus support for direct vendor rates and custom `prices` overrides in `settings.yaml`.
+8. **Refinement Mode (Incremental Edits)**: Automatically detects existing codebase context to generate precise delta modifications instead of destructive full-file rewrites.
+9. **Fast Mode & Custom Judge Criteria**: Ultra-fast single-model preset for quick tasks and customizable evaluation guidelines for the judge.
+10. **Run History & Win-Rate Leaderboard**: Persistent logging with built-in REST endpoints (`/dsh-moa/history` and `/dsh-moa/leaderboard`).
 
 ---
 
@@ -152,6 +156,13 @@ dsh-moa:
       aggregator:
         provider: "your-reasoning-provider"
         model: "your-judge-model"
+  prices:
+    "my-provider/my-model":
+      input: 0.20
+      output: 0.80
+    "ollama/*":
+      input: 0
+      output: 0
     code-review:
       references:
         - provider: "your-fast-provider"
@@ -175,6 +186,16 @@ dsh-moa:
 
 ---
 
+## 📊 REST API & Endpoints
+
+| Endpoint | Method | Description |
+|:---|:---|:---|
+| `/dsh-moa/presets` | `GET` | Returns list of configured MoA presets |
+| `/dsh-moa/history?limit=20&offset=0` | `GET` | Returns recent MoA runs with candidates, winner, cost, and tokens |
+| `/dsh-moa/leaderboard` | `GET` | Computes model win-rate leaderboard and average execution costs |
+
+---
+
 ## 🧪 Testing
 
 Run the automated test suite:

package/docs/README.ru.md

@@ -37,6 +37,10 @@
 4. **Мгновенный предпросмотр через Live Canvas**: При создании веб-приложений и UI-компонентов `dsh-moa` бесшовно интегрируется с `@goodandready/dsh-live-canvas`, автоматически инициализируя контейнер для предпросмотра в браузере в 1 клик.
 5. **Экономия токенов в чате**: Вместо вывода огромных листингов кода в чат формируется компактный отчет с перечнем созданных файлов и архитектурным резюме.
 6. **Одноразовый модификатор сессии**: Команда выполняется в рамках одного такта и автоматически возвращает исходную модель сессии пользователя сразу после завершения.
+7. **Динамический каталог тарифов и подсчет токенов**: Актуальные цены на 300+ моделей автоматически подтягиваются из публичного каталога OpenRouter (без ключей и авторизации), кешируются в `~/.dsh/storages/dsh-moa-catalog.json` на 24 часа, а также поддерживают прямые вендорские тарифы и пользовательские оверрайды `prices` в `settings.yaml`.
+8. **Режим доработки (Refinement Mode)**: Автоматически считывает контекст существующего проекта и генерирует точечные дельта-правки без перетирания всей кодовой базы.
+9. **Быстрый режим (Fast Mode) и критерии судьи**: Режим для одиночных быстрых задач без судьи и гибкая настройка фокуса оценки (безопасность, производительность, минимализм).
+10. **История запусков и лидерборд моделей**: Персистентное логирование запусков и REST-эндпоинты (`/dsh-moa/history` и `/dsh-moa/leaderboard`).
 
 ---
 
@@ -152,6 +156,13 @@ dsh-moa:
       aggregator:
         provider: "your-reasoning-provider"
         model: "your-judge-model"
+  prices:
+    "my-provider/my-model":
+      input: 0.20
+      output: 0.80
+    "ollama/*":
+      input: 0
+      output: 0
     code-review:
       references:
         - provider: "your-fast-provider"
@@ -175,6 +186,16 @@ dsh-moa:
 
 ---
 
+## 📊 REST API эндпоинты
+
+| Эндпоинт | Метод | Описание |
+|:---|:---|:---|
+| `/dsh-moa/presets` | `GET` | Возвращает список настроенных пресетов MoA |
+| `/dsh-moa/history?limit=20&offset=0` | `GET` | История запусков с кандидатами, победителем, токенами и ценой |
+| `/dsh-moa/leaderboard` | `GET` | Лидерборд побед моделей и средняя стоимость генерации |
+
+---
+
 ## 🧪 Тестирование
 
 Запуск автоматического набора тестов:

package/lib/client.js

@@ -6,6 +6,7 @@ window.__ModuleLoader__.load({
     let React = require('react')
 
     const NS = 'dsh-moa'
+    let localeRegistered = false
 
     let ChevronIcon = null
     try {
@@ -378,6 +379,10 @@ window.__ModuleLoader__.load({
         updateCurrentPreset((p) => ({ ...p, reference_temperature: val }))
       }
 
+      const setJudgeCriteria = (criteria) => {
+        updateCurrentPreset((p) => ({ ...p, judge_criteria: criteria }))
+      }
+
       const setReferenceModel = (idx, prov, mod) => {
         updateCurrentPreset((p) => {
           const refs = [...(p.reference_models || [])]
@@ -468,6 +473,7 @@ window.__ModuleLoader__.load({
       const currentRefs = currentPreset.reference_models || []
       const aggTemp = currentPreset.aggregator_temperature ?? 0.4
       const refTemp = currentPreset.reference_temperature ?? 0.6
+      const judgeCriteria = currentPreset.judge_criteria || ''
 
       return React.createElement(
         React.Fragment,
@@ -621,6 +627,30 @@ window.__ModuleLoader__.load({
               })
             ),
             React.createElement('div', { className: 'moa-hint' }, t('aggTempHint') || 'Рекомендуется 0.2 – 0.4 для точной проверки и синтеза без галлюцинаций.')
+          ),
+          React.createElement(
+            'div',
+            { className: 'moa-field', style: { marginTop: 4, borderTop: '1px solid var(--dsw-alias-border-l2)', paddingTop: 8 } },
+            React.createElement('label', { className: 'moa-label', style: { fontSize: 12 } }, t('judgeCriteriaLabel') || 'Критерии оценки судьи (опционально):'),
+            React.createElement('textarea', {
+              className: 'moa-textarea',
+              rows: 2,
+              style: {
+                width: '100%',
+                boxSizing: 'border-box',
+                padding: '8px 10px',
+                borderRadius: 8,
+                border: '1px solid var(--dsw-alias-border-l2)',
+                background: 'var(--dsw-alias-bg-layer-3)',
+                color: 'var(--dsw-alias-label-primary)',
+                fontSize: 13,
+                resize: 'vertical',
+                outline: 'none',
+              },
+              placeholder: t('judgeCriteriaPlaceholder') || 'например: Приоритет — производительность, чистый код, минимум зависимостей...',
+              value: judgeCriteria,
+              onChange: (e) => setJudgeCriteria(e.target.value),
+            })
           )
         ),
         /* Proposers / Advisors Box with Temperature Slider */
@@ -744,8 +774,120 @@ window.__ModuleLoader__.load({
       )
     }
 
+    let rootCtx = null
+
+    const en = {
+        title: 'Mixture of Agents (MoA)',
+        description: 'Run tasks with multiple parallel proposer models and a synthesizing judge model',
+        slashMoa: 'Run task through Mixture of Agents (/moa <prompt>)',
+        defaultPreset: 'Default Preset (used on /moa without arguments)',
+        isDefault: 'default',
+        presetSelectLabel: 'Active Preset to Configure:',
+        createNewPreset: 'Create new preset...',
+        makeDefault: 'Make Default',
+        makeDefaultHint: 'Use this preset for /moa when no preset argument is given',
+        deletePreset: 'Delete preset',
+        delete: 'Delete',
+        confirmDeletePreset: 'Are you sure you want to delete preset',
+        newPresetPlaceholder: 'New preset name (e.g. fast-audit)',
+        create: 'Create',
+        cancel: 'Cancel',
+        aggregatorTitle: 'Judge / Aggregator Model (who reviews and synthesizes)',
+        aggregatorDesc: 'Evaluates candidate proposals, corrects hallucinations, and outputs the final unified solution.',
+        temperature: 'Temperature',
+        aggTempHint: 'Recommended 0.2 - 0.4 for rigorous verification and factual synthesis.',
+        proposersTitle: 'Candidate Models (Advisors)',
+        proposersDesc: 'Generates independent candidate answers in parallel to provide diverse perspectives.',
+        refTempLabel: 'Candidates Temperature (solution diversity):',
+        refTempHint: 'Recommended 0.6 - 0.8 for diverse creative hypotheses.',
+        parallelCount: 'Parallel workers',
+        candidate: 'Candidate',
+        addCandidate: 'Add parallel model slot',
+        remove: 'Remove',
+        save: 'Save Changes',
+        saved: 'Saved successfully',
+        loading: 'Saving…',
+        retry: 'Retry connection',
+        unavailable: 'MoA service temporarily unavailable (reconnecting...)',
+        searchPlaceholder: 'Search by model name or provider...',
+        modelsFound: 'Found',
+        of: 'of',
+        clear: 'Clear',
+        noModelsMatch: 'No models found matching query.',
+        useCustom: 'Use custom',
+        selectModel: 'Select model...',
+        judgeCriteriaLabel: 'Custom Judge Evaluation Criteria (optional):',
+        judgeCriteriaPlaceholder: 'e.g. Priority: performance, zero external dependencies, robust edge-case handling...',
+      }
+
+    const ru = {
+        title: 'Mixture of Agents (MoA)',
+        description: 'Запуск задач через ансамбль параллельных моделей-советников и модель-судью',
+        slashMoa: 'Запустить задачу через архитектуру Mixture of Agents (/moa <prompt>)',
+        defaultPreset: 'Основной пресет (при вызове /moa без параметров)',
+        isDefault: 'основной',
+        presetSelectLabel: 'Текущий пресет для настройки:',
+        createNewPreset: 'Создать новый пресет...',
+        makeDefault: 'Сделать основным',
+        makeDefaultHint: 'Использовать этот пресет для /moa при вызове без параметров',
+        deletePreset: 'Удалить пресет',
+        delete: 'Удалить',
+        confirmDeletePreset: 'Вы уверены, что хотите удалить пресет',
+        newPresetPlaceholder: 'Название нового пресета (например: fast-audit)',
+        create: 'Создать',
+        cancel: 'Отмена',
+        aggregatorTitle: 'Ведущая модель / Судья (кто проверяет и объединяет)',
+        aggregatorDesc: 'Сопоставляет варианты кандидатов, устраняет ошибки и синтезирует итоговое решение.',
+        temperature: 'Температура',
+        aggTempHint: 'Рекомендуется 0.2 – 0.4 для строгой проверки и синтеза без выдумок.',
+        proposersTitle: 'Модели-кандидаты (советники)',
+        proposersDesc: 'Параллельно формируют независимые варианты решения одной задачи.',
+        refTempLabel: 'Температура кандидатов (разнообразие решений):',
+        refTempHint: 'Рекомендуется 0.6 – 0.8 для получения независимых и креативных вариантов.',
+        parallelCount: 'Параллельных моделей',
+        candidate: 'Кандидат',
+        addCandidate: 'Добавить модель в параллель',
+        remove: 'Удалить',
+        save: 'Сохранить',
+        saved: 'Успешно сохранено',
+        loading: 'Сохранение…',
+        retry: 'Повторить подключение',
+        unavailable: 'Служба MoA временно недоступна (переподключение...)',
+        searchPlaceholder: 'Поиск модели по названию или провайдеру...',
+        modelsFound: 'Найдено',
+        of: 'из',
+        clear: 'Сбросить',
+        noModelsMatch: 'Модели не найдены.',
+        useCustom: 'Использовать кастомное',
+        selectModel: 'Выберите модель...',
+        judgeCriteriaLabel: 'Критерии оценки судьи (опционально):',
+        judgeCriteriaPlaceholder: 'например: Приоритет — производительность, минимум зависимостей, обработка граничных случаев...',
+      }
+
+    function makeT(ctx, props) {
+      return (key) => {
+        if (props && typeof props.t === 'function') {
+          try {
+            const res = props.t(key)
+            if (res && res !== key) return res
+          } catch (_) {}
+        }
+        const effectiveCtx = (props && props.ctx) || ctx || rootCtx
+        if (effectiveCtx && effectiveCtx.locale && typeof effectiveCtx.locale.bind === 'function') {
+          try {
+            const bound = effectiveCtx.locale.bind(NS)
+            const res = bound(key)
+            if (res && res !== key) return res
+          } catch (_) {}
+        }
+        const curLocale = (effectiveCtx && effectiveCtx.locale && effectiveCtx.locale.getSnapshot && effectiveCtx.locale.getSnapshot().active) || 'ru'
+        const dict = curLocale === 'en' ? en : ru
+        return dict[key] || ru[key] || en[key] || key
+      }
+    }
+
     function useMoASettings(props) {
-      const t = props.t || ((k) => k)
+      const t = makeT(rootCtx, props)
       const [status, setStatus] = React.useState('loading')
       const [presets, setPresets] = React.useState([])
       const [defaultPreset, setDefaultPreset] = React.useState('default')
@@ -858,6 +1000,64 @@ window.__ModuleLoader__.load({
       )
     }
 
+
+    // ── ERROR BOUNDARY ──────────────────────────────────────────────
+    class MoAErrorBoundary extends React.Component {
+      constructor(props) {
+        super(props)
+        this.state = { hasError: false, error: null, errorInfo: null }
+      }
+      static getDerivedStateFromError(error) {
+        return { hasError: true, error }
+      }
+      componentDidCatch(error, errorInfo) {
+        console.error('[dsh-moa] MoAErrorBoundary caught error:', error, errorInfo)
+        this.setState({ errorInfo })
+      }
+      render() {
+        if (this.state.hasError) {
+          return React.createElement(
+            'div',
+            {
+              style: {
+                padding: '16px',
+                borderRadius: '8px',
+                border: '1px solid #ef4444',
+                background: 'rgba(239,68,68,0.08)',
+                color: '#ef4444',
+                fontSize: '13px',
+                fontFamily: 'monospace',
+                whiteSpace: 'pre-wrap',
+                wordBreak: 'break-word',
+              },
+            },
+            React.createElement('div', { style: { fontWeight: 700, marginBottom: 8 } }, '⚠ MoA Settings Error'),
+            React.createElement('div', null, String(this.state.error)),
+            this.state.errorInfo && React.createElement(
+              'details',
+              { style: { marginTop: 8 } },
+              React.createElement('summary', null, 'Component stack'),
+              React.createElement('pre', { style: { fontSize: 11 } }, this.state.errorInfo.componentStack || '')
+            ),
+            React.createElement(
+              'button',
+              {
+                type: 'button',
+                style: {
+                  marginTop: 12, padding: '6px 16px', border: '1px solid #ef4444',
+                  background: 'transparent', color: '#ef4444', borderRadius: 6,
+                  cursor: 'pointer', fontSize: 12,
+                },
+                onClick: () => this.setState({ hasError: false, error: null, errorInfo: null }),
+              },
+              'Retry'
+            )
+          )
+        }
+        return this.props.children
+      }
+    }
+
     function MoACard(props) {
       ensureStyles()
       const state = useMoASettings(props)
@@ -913,134 +1113,39 @@ window.__ModuleLoader__.load({
 
     exports.inject = ['slots', 'locale', 'inputTriggers']
     exports.apply = function apply(ctx) {
-      const registerLocale = () => {
+      rootCtx = ctx
+      const t = makeT(ctx)
+      const addLocale = (locale, dictionary) => {
         try {
           if (ctx.locale && typeof ctx.locale.register === 'function') {
-            return ctx.locale.register(NS, {
-        en: {
-          title: 'Mixture of Agents (MoA)',
-          description: 'Run tasks with multiple parallel proposer models and a synthesizing judge model',
-          slashMoa: 'Run task through Mixture of Agents (/moa <prompt>)',
-          defaultPreset: 'Default Preset (used on /moa without arguments)',
-          isDefault: 'default',
-          presetSelectLabel: 'Active Preset to Configure:',
-          createNewPreset: 'Create new preset...',
-          makeDefault: 'Make Default',
-          makeDefaultHint: 'Use this preset for /moa when no preset argument is given',
-          deletePreset: 'Delete preset',
-          delete: 'Delete',
-          confirmDeletePreset: 'Are you sure you want to delete preset',
-          newPresetPlaceholder: 'New preset name (e.g. fast-audit)',
-          create: 'Create',
-          cancel: 'Cancel',
-          aggregatorTitle: 'Judge / Aggregator Model (who reviews and synthesizes)',
-          aggregatorDesc: 'Evaluates candidate proposals, corrects hallucinations, and outputs the final unified solution.',
-          temperature: 'Temperature',
-          aggTempHint: 'Recommended 0.2 - 0.4 for rigorous verification and factual synthesis.',
-          proposersTitle: 'Candidate Models (Advisors)',
-          proposersDesc: 'Generates independent candidate answers in parallel to provide diverse perspectives.',
-          refTempLabel: 'Candidates Temperature (solution diversity):',
-          refTempHint: 'Recommended 0.6 - 0.8 for diverse creative hypotheses.',
-          parallelCount: 'Parallel workers',
-          candidate: 'Candidate',
-          addCandidate: 'Add parallel model slot',
-          remove: 'Remove',
-          save: 'Save Changes',
-          saved: 'Saved successfully',
-          loading: 'Saving…',
-          retry: 'Retry connection',
-          unavailable: 'MoA service temporarily unavailable (reconnecting...)',
-          searchPlaceholder: 'Search by model name or provider...',
-          modelsFound: 'Found',
-          of: 'of',
-          clear: 'Clear',
-          noModelsMatch: 'No models found matching query.',
-          useCustom: 'Use custom',
-          selectModel: 'Select model...',
-        },
-        ru: {
-          title: 'Mixture of Agents (MoA)',
-          description: 'Запуск задач через ансамбль параллельных моделей-советников и модель-судью',
-          slashMoa: 'Запустить задачу через архитектуру Mixture of Agents (/moa <prompt>)',
-          defaultPreset: 'Основной пресет (при вызове /moa без параметров)',
-          isDefault: 'основной',
-          presetSelectLabel: 'Текущий пресет для настройки:',
-          createNewPreset: 'Создать новый пресет...',
-          makeDefault: 'Сделать основным',
-          makeDefaultHint: 'Использовать этот пресет для /moa при вызове без параметров',
-          deletePreset: 'Удалить пресет',
-          delete: 'Удалить',
-          confirmDeletePreset: 'Вы уверены, что хотите удалить пресет',
-          newPresetPlaceholder: 'Название нового пресета (например: fast-audit)',
-          create: 'Создать',
-          cancel: 'Отмена',
-          aggregatorTitle: 'Ведущая модель / Судья (кто проверяет и объединяет)',
-          aggregatorDesc: 'Сопоставляет варианты кандидатов, устраняет ошибки и синтезирует итоговое решение.',
-          temperature: 'Температура',
-          aggTempHint: 'Рекомендуется 0.2 – 0.4 для строгой проверки и синтеза без выдумок.',
-          proposersTitle: 'Модели-кандидаты (советники)',
-          proposersDesc: 'Параллельно формируют независимые варианты решения одной задачи.',
-          refTempLabel: 'Температура кандидатов (разнообразие решений):',
-          refTempHint: 'Рекомендуется 0.6 – 0.8 для получения независимых и креативных вариантов.',
-          parallelCount: 'Параллельных моделей',
-          candidate: 'Кандидат',
-          addCandidate: 'Добавить модель в параллель',
-          remove: 'Удалить',
-          save: 'Сохранить',
-          saved: 'Успешно сохранено',
-          loading: 'Сохранение…',
-          retry: 'Повторить подключение',
-          unavailable: 'Служба MoA временно недоступна (переподключение...)',
-          searchPlaceholder: 'Поиск модели по названию или провайдеру...',
-          modelsFound: 'Найдено',
-          of: 'из',
-          clear: 'Сбросить',
-          noModelsMatch: 'Модели не найдены.',
-          useCustom: 'Использовать кастомное',
-          selectModel: 'Выберите модель...',
-        },
-      })
+            return ctx.locale.register(NS, locale, dictionary)
           }
-        } catch (err) {
-          console.warn('[dsh-moa] locale registration error:', err)
+        } catch {
+          // Если язык уже занят (например, dsh-russian-lang) или зарегистрирован ранее — уступаем без ошибки
+          return () => {}
         }
+        return () => {}
       }
 
       if (typeof ctx.effect === 'function') {
-        ctx.effect(() => registerLocale(), 'dsh-moa: dictionaries')
+        ctx.effect(() => {
+          const undo = [addLocale('en', en), addLocale('ru', ru)]
+          return () => {
+            for (const off of undo) {
+              if (typeof off === 'function') {
+                try { off() } catch {}
+              }
+            }
+          }
+        }, 'dsh-moa: dictionaries')
       } else {
-        registerLocale()
+        addLocale('en', en)
+        addLocale('ru', ru)
       }
 
-      const t = (key) => {
-        try {
-          if (ctx.locale && typeof ctx.locale.bind === 'function') {
-            return ctx.locale.bind(NS)(key) || key
-          }
-        } catch {}
-        return key
-      }
 
       if (ctx.slots) {
-        const registerDirectSection = () => {
-          try {
-            ctx.slots.register(
-              {
-                name: 'settings.section',
-                id: NS,
-                order: 35,
-                locale: NS,
-                label: () => t('title'),
-                inject: () => ({ ctx, t }),
-              },
-              MoASection
-            )
-          } catch (err) {
-            console.warn('[dsh-moa] Failed to register settings.section:', err)
-          }
-        }
-
-        const registerPluginCard = () => {
+        const registerCard = () => {
           try {
             ctx.slots.register(
               {
@@ -1048,10 +1153,9 @@ window.__ModuleLoader__.load({
                 key: NS,
                 order: 35,
                 locale: NS,
-                label: () => t('title'),
-                inject: () => ({ ctx, t }),
+                inject: () => ({ ctx }),
               },
-              MoACard
+              (props) => React.createElement(MoAErrorBoundary, null, React.createElement(MoACard, props))
             )
           } catch (err) {
             console.warn('[dsh-moa] Failed to register settings.plugin.item:', err)
@@ -1059,11 +1163,9 @@ window.__ModuleLoader__.load({
         }
 
         if (typeof ctx.slots.inject === 'function') {
-          ctx.slots.inject('settings.section', registerDirectSection)
-          ctx.slots.inject('settings.plugin.item', registerPluginCard)
+          ctx.slots.inject('settings.plugin.item', registerCard)
         } else {
-          registerDirectSection()
-          registerPluginCard()
+          registerCard()
         }
       }
 

package/lib/file-workspace.js

@@ -85,6 +85,89 @@ function sanitizePath(filePath) {
   return normalized.replace(/^[\\\/]+/, '')
 }
 
+/**
+ * Collects readable text files from current workspace to feed as context for candidate models (#6).
+ * Ignores node_modules, .git, .moa, binary files, large bundles.
+ */
+export async function collectProjectContext(baseDir, maxCharBudget = 16000) {
+  if (!baseDir) return { files: [], totalChars: 0 }
+
+  const ignoreDirs = new Set(['node_modules', '.git', '.moa', '.worktrees', 'dist', 'build', '.dsh'])
+  const codeExts = new Set([
+    '.html', '.htm', '.css', '.js', '.mjs', '.cjs', '.jsx', '.ts', '.tsx',
+    '.vue', '.svelte', '.json', '.py', '.md', '.txt', '.sh', '.yaml', '.yml',
+  ])
+
+  const collected = []
+  let totalChars = 0
+
+  async function scan(currentDir, relPrefix = '') {
+    if (totalChars >= maxCharBudget) return
+    try {
+      const list = await fs.readdir(currentDir, { withFileTypes: true })
+      for (const item of list) {
+        if (totalChars >= maxCharBudget) break
+        if (item.name.startsWith('.') && item.name !== '.env') continue
+
+        const rel = relPrefix ? `${relPrefix}/${item.name}` : item.name
+        const full = path.join(currentDir, item.name)
+
+        if (item.isDirectory()) {
+          if (!ignoreDirs.has(item.name)) {
+            await scan(full, rel)
+          }
+        } else if (item.isFile()) {
+          const ext = path.extname(item.name).toLowerCase()
+          if (codeExts.has(ext)) {
+            try {
+              const stat = await fs.stat(full)
+              if (stat.size > 100000) continue // skip files > 100kb
+              const content = await fs.readFile(full, 'utf8')
+              const budgetRemaining = maxCharBudget - totalChars
+              const truncated = content.length > budgetRemaining ? content.slice(0, budgetRemaining) + '\n... [truncated]' : content
+              totalChars += truncated.length
+              collected.push({ relativePath: rel, content: truncated, size: stat.size })
+            } catch {}
+          }
+        }
+      }
+    } catch {}
+  }
+
+  await scan(baseDir)
+  return { files: collected, totalChars }
+}
+
+/**
+ * Checks if a task prompt is an iterative refinement / modification
+ * of an existing project rather than a greenfield project creation (#4).
+ */
+export function isRefinementTask(userPrompt = '', projectFiles = []) {
+  if (!Array.isArray(projectFiles) || projectFiles.length === 0) return false
+  const p = userPrompt.toLowerCase().trim()
+  if (!p) return false
+
+  // Greenfield creation phrases - ALWAYS fresh task
+  const freshPhrases = [
+    'с нуля', 'from scratch', 'новый проект', 'новое приложение', 'new project', 'new app',
+    'создай проект', 'создай приложение', 'создай игру', 'создай сервис',
+    'сделай проект', 'сделай приложение', 'сделай игру',
+    'create a new', 'build a new', 'generate a new',
+  ]
+  if (freshPhrases.some((phrase) => p.includes(phrase))) {
+    return false
+  }
+
+  // Modification keywords
+  const modKeywords = [
+    'добавь', 'измени', 'поменяй', 'исправь', 'обнови', 'переделай', 'доработай', 'удали',
+    'add', 'change', 'update', 'fix', 'modify', 'refactor', 'improve', 'enhance', 'adjust',
+    'style', 'css', 'темн', 'светл', 'color', 'цвет', 'кнопк', 'theme', 'bug', 'баг',
+  ]
+
+  return modKeywords.some((kw) => p.includes(kw))
+}
+
 /**
  * Writes candidate files into an isolated candidate workspace:
  * <baseDir>/.moa/candidate-<index>/
@@ -114,7 +197,7 @@ export async function writeCandidateWorkspace(baseDir, candidateIndex, files = [
  * Promotes winning candidate files to baseDir root,
  * then cleans up the temporary .moa folder.
  */
-export async function promoteCandidateWorkspace(baseDir, winningIndex) {
+export async function promoteCandidateWorkspace(baseDir, winningIndex, options = { keepMoa: false }) {
   if (!baseDir || winningIndex === null || winningIndex === undefined) return []
 
   const winningDir = path.join(baseDir, '.moa', `candidate-${winningIndex}`)
@@ -123,7 +206,9 @@ export async function promoteCandidateWorkspace(baseDir, winningIndex) {
   try {
     const entries = await getFilesRecursively(winningDir)
     if (entries.length === 0) {
-      try { await fs.rm(moaRoot, { recursive: true, force: true }) } catch {}
+      if (!options.keepMoa) {
+        try { await fs.rm(moaRoot, { recursive: true, force: true }) } catch {}
+      }
       return []
     }
 
@@ -137,12 +222,16 @@ export async function promoteCandidateWorkspace(baseDir, winningIndex) {
       promoted.push(rel)
     }
 
-    // Clean up temporary .moa folder
-    await fs.rm(moaRoot, { recursive: true, force: true })
+    if (!options.keepMoa) {
+      // Clean up temporary .moa folder
+      await fs.rm(moaRoot, { recursive: true, force: true })
+    }
 
     return promoted
   } catch (err) {
-    try { await fs.rm(moaRoot, { recursive: true, force: true }) } catch {}
+    if (!options.keepMoa) {
+      try { await fs.rm(moaRoot, { recursive: true, force: true }) } catch {}
+    }
     return []
   }
 }