@gian-tiaga/eda 0.8.6 → 1.0.1

package/lib/renderers/claude-agent.js

@@ -0,0 +1,24 @@
+function yamlString(value) {
+  return `'${value.replaceAll("'", "''")}'`;
+}
+
+export function renderClaudeAgent(agent, prompt) {
+  const tools = agent.access === 'workspace-write'
+    ? 'Read, Glob, Grep, Bash, Write, Edit, NotebookEdit'
+    : 'Read, Glob, Grep, Bash';
+  const lines = [
+    '---',
+    `name: ${agent.name}`,
+    `description: ${yamlString(agent.description)}`,
+    `tools: ${tools}`
+  ];
+
+  if (agent.access !== 'workspace-write') lines.push('disallowedTools: Write, Edit, NotebookEdit');
+  lines.push(`model: ${agent.models.claude}`);
+  if (agent.reasoning?.claude) lines.push(`effort: ${agent.reasoning.claude}`);
+  if (agent.access === 'read-only') lines.push('permissionMode: plan');
+  if (agent.maxTurns) lines.push(`maxTurns: ${agent.maxTurns}`);
+
+  lines.push('---', '', prompt.trimEnd(), '');
+  return lines.join('\n');
+}

package/lib/renderers/claude-skill.js

@@ -0,0 +1,11 @@
+export function renderClaudeSkill(content, config = {}) {
+  const model = config.models?.claude;
+  if (!model) return content;
+
+  const closingMarker = content.indexOf('\n---', 4);
+  if (!content.startsWith('---\n') || closingMarker === -1) {
+    throw new Error('Не удалось добавить Claude model override: некорректный front matter скила.');
+  }
+
+  return `${content.slice(0, closingMarker)}\nmodel: ${model}${content.slice(closingMarker)}`;
+}

package/lib/renderers/codex-agent.js

@@ -0,0 +1,24 @@
+function tomlString(value) {
+  return JSON.stringify(value);
+}
+
+export function renderCodexAgent(agent, prompt) {
+  if (prompt.includes('"""')) {
+    throw new Error(`Промпт агента ${agent.name} содержит неподдерживаемую последовательность тройных кавычек.`);
+  }
+
+  const lines = [
+    `name = ${tomlString(agent.name)}`,
+    `description = ${tomlString(agent.description)}`,
+    `model = ${tomlString(agent.models.codex)}`
+  ];
+
+  if (agent.reasoning?.codex) {
+    lines.push(`model_reasoning_effort = ${tomlString(agent.reasoning.codex)}`);
+  }
+  if (agent.access === 'read-only') lines.push('sandbox_mode = "read-only"');
+  if (agent.access === 'workspace-write') lines.push('sandbox_mode = "workspace-write"');
+
+  lines.push('developer_instructions = """', prompt.trimEnd(), '"""', '');
+  return lines.join('\n');
+}

package/lib/renderers/codex-skill.js

@@ -0,0 +1,3 @@
+export function renderCodexSkill(content) {
+  return content;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gian-tiaga/eda",
-  "version": "0.8.6",
-  "description": "Набор скилов eda-* для Claude Code и Codex CLI: start, roadmap, explore, plan, plan-polish, execute, fix, review, review-check, fix-by-review, manual-test, polish, send-review, commit, worktree, merge-worktree, docs, automate",
+  "version": "1.0.1",
+  "description": "Пакет скилов и специализированных агентов eda-* для Claude Code и Codex CLI",
   "type": "module",
   "bin": {
     "eda": "bin/cli.js"
@@ -10,7 +10,9 @@
     "bin",
     "lib",
     "skills",
-    "README.md"
+    "agents",
+    "README.md",
+    "MIGRATION.md"
   ],
   "engines": {
     "node": ">=18"

package/skills/eda-aim/SKILL.md

@@ -0,0 +1,212 @@
+---
+name: eda-aim
+description: 'Согласует с пользователем одну или несколько простых проверяемых целей, сохраняет их в компактном файле `docs/aims/` и ведёт работу до достижения. Планирование, выполнение и итоговая проверка идут через отдельных пакетных субагентов; основной агент только оркестрирует вопросы и передачи. Поддерживает automatic/manual из `aim.mode` или текущего вызова; при необходимости использует установленные скилы в изолированных субагентах.'
+---
+
+# Скил: Достижение цели (eda-aim)
+
+Оркестрируй полный цикл: согласовать цель → выполнить работу → независимо проверить результат → при необходимости продолжить. Не выполняй содержательную работу основным агентом.
+
+## Настройки
+
+Прочитай только раздел `aim` из `docs/settings.yaml`, если файл есть. Применяй только `version: 2`.
+
+```yaml
+aim:
+  mode: automatic
+```
+
+`aim.mode` принимает только `automatic` или `manual`; при отсутствующем или невалидном значении используй `automatic`. Прямое указание режима в текущем сообщении всегда важнее настройки. Файл настроек не изменяй.
+
+## Вход из сообщения пользователя
+
+Сохрани весь текст текущего сообщения в `$USER_REQUEST`. Извлеки описание результата, ограничения, указанный файл цели и режим:
+
+- `automatic`, `auto`, `автоматически`, `автоматический`, `автономно`, `без вопросов` → `$MODE=automatic`;
+- `manual`, `вручную`, `ручной`, `спрашивай` → `$MODE=manual`;
+- без явного режима → `$MODE=aim.mode` из валидных настроек, иначе `$MODE=automatic`.
+
+В автоматическом режиме основной агент сам выбирает ответ на рабочие вопросы по рекомендации субагента и фактам проекта. Это не отменяет одно обязательное подтверждение человеком точного списка целей до создания нового файла.
+
+Если пользователь передал существующий файл из `docs/aims/`, продолжай его с текущего статуса. Не создавай второй файл для той же цели.
+
+## Пакетные агенты
+
+| Этап | Агент | Claude Code | Codex | Доступ |
+|---|---|---|---|---|
+| Согласование | `eda-aim-planner` | `opus` | `gpt-5.6-sol` | workspace-write |
+| Выполнение | `eda-aim-executor` | `opus` | `gpt-5.6-sol` | workspace-write |
+| Проверка | `eda-aim-verifier` | `opus` | `gpt-5.6-sol` | workspace-write |
+
+- В Claude Code запускай установленного пакетного агента через инструмент `Agent` по имени.
+- В Codex запускай установленного пакетного агента через `spawn_agent` или аналог по имени.
+- Не копируй системный промпт агента в сообщение с заданием.
+- Если нужный агент или нативные субагенты недоступны, остановись: `blocked: нужен установленный агент <имя>`. Не выполняй его роль основным агентом и не заменяй отдельным CLI-процессом.
+
+## Вопросы и автоматический режим
+
+Агент может вернуть один конкретный `question`, 1–3 взаимоисключающих `options` и `recommended_answer`.
+
+В ручном режиме передай вопрос пользователю:
+
+- Claude Code: используй `AskUserQuestion`;
+- Интерактивный Codex: используй `request_user_input`, если доступен; иначе задай короткий вопрос с вариантами и остановись до ответа;
+- Неинтерактивный Codex: не читай stdin; заверши `blocked: нужен ответ пользователя` и перечисли вопрос с вариантами.
+
+В автоматическом режиме не спрашивай пользователя: выбери `recommended_answer`, если он не противоречит исходному запросу, правилам или безопасности; иначе выбери лучший безопасный вариант по фактам проекта. Запиши автоматический ответ в данные продолжения и передай тому же агенту. Не принимай автоматически необратимые внешние действия, расширение цели, публикацию, расходы, удаление данных или ослабление проверок — для них нужен человек.
+
+Подтверждение точного списка новых целей — отдельный обязательный вопрос человеку в обоих режимах. До ответа файл цели не существует.
+
+## Файл цели
+
+После подтверждения `eda-aim-planner` создаёт `docs/aims/{YYYY-MM-DD}_{HH-MM}_{slug}.md`. Файл должен оставаться коротким и содержать только цель и фактический журнал:
+
+```markdown
+# <Короткое название>
+
+Режим: <ручной | автоматический>
+Статус: <согласована | выполняется | проверяется | достигнута | заблокирована>
+
+## Цели
+
+- [ ] A1 — <ясный наблюдаемый результат>; проверка: <критерий>.
+- [ ] A2 — <результат>; проверка: <критерий>.
+
+## Журнал
+
+- `<YYYY-MM-DD HH:MM>` — цели согласованы пользователем.
+```
+
+Правила файла:
+
+- один пункт допустим и предпочтителен, если задача едина;
+- не превращай цели в план реализации, бэклог, исследование или длинную спецификацию;
+- каждый пункт описывает результат, а не действие агента;
+- новые разделы не добавляй;
+- журнал только дополняй, старые записи не переписывай;
+- используй относительные Markdown-ссылки на изменённые файлы и созданные артефакты;
+- отметку `[x]` ставит только `eda-aim-verifier`, когда критерий подтверждён фактами.
+
+Если применён другой `eda-*`-скил, журнал обязательно содержит его имя, итог и ссылку на каждый созданный им артефакт. Если отдельный артефакт этим скилом не создаётся, явно напиши `артефакт не создаётся`. Без отдельного скила запиши, что выполнено, и дай ссылки на затронутые файлы или иной проверяемый результат.
+
+## Использование установленных скилов
+
+В случае необходимости `eda-aim` может использовать установленные скилы в изолированных субагентах. Субагенты `eda-aim` не запускают их сами: исполнитель или проверяющий возвращает `needs_skill` со структурированным `skill_request`, а основной агент:
+
+1. Приостанавливает запросившего агента и сохраняет его полный YAML.
+2. Запускает новый изолированный субагент с чистым контекстом и поручает ему применить указанный установленный скил к `skill_request`.
+3. Дожидается результата скила и собирает `skill`, `status`, полный результат, пути к артефактам и проверки.
+4. Передаёт эти данные как `SKILL_RESULTS` тому же исполнителю или проверяющему; именно он дополняет общий журнал и продолжает свою роль.
+
+Каждый такой вызов использует отдельного субагента. Основной агент не применяет запрошенный скил сам, не копирует его процедуру и не выполняет его содержательную работу. Субагент следует установленной инструкции скила целиком, включая её правила вопросов и делегации. Если изолированный запуск или обязательные для скила нативные субагенты недоступны, остановись с конкретным `blocked`, не заменяя их работой основного агента или CLI-fallback.
+
+## Процесс
+
+### 1. Согласовать цели
+
+Запусти `eda-aim-planner` и передай:
+
+```text
+Рабочая директория: <cwd>
+USER_REQUEST:
+<полный дословный запрос>
+
+MODE: <manual | automatic>
+GOAL_FILE: <путь | none>
+ANSWERS: <предыдущие вопросы и ответы | none>
+APPROVAL: <approved | rejected | pending>
+
+Верни результат строго по YAML-контракту агента.
+```
+
+Для нового запуска обрабатывай ответы так:
+
+- `needs_input` — получи или самостоятельно выбери ответ по режиму, затем продолжи того же planner;
+- `needs_approval` — покажи человеку точный список целей и задай один вопрос: подтверждает ли он этот список; автоматический режим это подтверждение не пропускает;
+- после подтверждения передай `APPROVAL: approved` тому же planner;
+- `ready` — сохрани `$GOAL_FILE` и переходи к выполнению;
+- `blocked` — назови конкретный блокер.
+
+Если человек отклонил список, передай причину planner и повтори согласование. Основной агент сам цели не формулирует и файл не пишет.
+
+Для существующего файла возьми `pending_goals` из результата планировщика: если список непуст, передай его исполнителю; если все пункты уже отмечены, сразу запусти нового независимого проверяющего и не повторяй выполненную работу.
+
+### 2. Выполнить цели
+
+Раздели независимые пункты между одним или несколькими последовательными вызовами `eda-aim-executor`. Не запускай одновременную запись нескольких агентов в общий файл цели. Связанные пункты передавай одному агенту вместе.
+
+Каждому executor передай:
+
+```text
+Рабочая директория: <cwd>
+GOAL_FILE: <путь>
+ASSIGNED_GOALS: <идентификаторы>
+USER_REQUEST: <полный дословный запрос>
+ANSWER_HISTORY: <вопросы и ответы этого запуска | none>
+PREVIOUS_RESULT: <полный результат предыдущей попытки | none>
+SKILL_RESULTS: <результаты запрошенных скилов и артефакты | none>
+
+Запрашивай установленные eda-* скилы через `needs_skill`, когда они нужны для достижения назначенных целей.
+Дополни журнал после каждого завершённого результата и верни YAML-контракт.
+```
+
+Исполнитель сам выбирает необходимые скилы. Например, он может запросить `eda-explore`, `eda-plan`, `eda-plan-polish`, `eda-plan-execute`, `eda-fix`, `eda-fix-by-review`, `eda-manual-test` или `eda-review`, соблюдая их границы и вопросы. Скил, который только планирует или проверяет, не считается выполнением цели без последующей реализации.
+
+Обработай результат:
+
+- `completed` — передай следующую группу целей или переходи к проверке;
+- `needs_input` — ответь по общим правилам режима и продолжи того же executor;
+- `needs_skill` — запусти `skill_request` по правилам выше и продолжи того же executor с полным `SKILL_RESULTS`;
+- `failed` — не завершай цель: передай полный результат следующему вызову executor для тех же пунктов, чтобы он учёл диагностику и выбрал другую безопасную попытку;
+- `blocked` — остановись только при явно названном внешнем неустранимом препятствии; если блокер требует ответа или изменения среды, продолжи после него.
+
+Не считай отчёт исполнителя доказательством достижения и не ставь отметку `[x]`.
+
+### 3. Независимо проверить
+
+После каждого полного круга выполнения запусти отдельного `eda-aim-verifier`:
+
+```text
+Рабочая директория: <cwd>
+GOAL_FILE: <путь>
+USER_REQUEST: <полный дословный запрос>
+ANSWER_HISTORY: <вопросы и ответы проверки | none>
+SKILL_RESULTS: <результаты запрошенных проверочных скилов | none>
+
+Независимо проверь каждый критерий по текущим файлам и фактическому поведению.
+При необходимости запроси проверочные eda-* скилы через `needs_skill`.
+Обнови только статусы, отметки `[x]` и журнал файла цели. Верни YAML-контракт.
+```
+
+Проверяющий не чинит реализацию. Он перепроверяет результат, запускает применимые тесты и при необходимости использует `eda-manual-test` или `eda-review`; созданные отчёты связывает в журнале. Если журнал ссылается на план, проверяющий также подтверждает, что в нём не осталось обязательных невыполненных пунктов.
+
+- `reached` — все пункты подтверждены, статус файла `достигнута`, цикл завершён;
+- `needs_work` — передай исполнителю только неподтверждённые пункты вместе с найденными пробелами и снова запусти проверяющего после исправлений;
+- `needs_input` — ответь по режиму и продолжи того же verifier;
+- `needs_skill` — запусти проверочный `skill_request` и продолжи того же verifier с полным `SKILL_RESULTS`;
+- `blocked` — сохрани статус `заблокирована` и сообщи, что именно мешает проверке.
+
+Продолжай цикл исполнитель → проверяющий без произвольного лимита, пока все цели не подтверждены либо не возник внешний неустранимый блокер. После повторного сбоя executor обязан использовать накопленную диагностику и изменить способ выполнения либо вернуть доказанный внешний блокер; повтор одного и того же сбоя не является достижением цели.
+
+### 4. Финал
+
+Сообщи:
+
+- достигнута ли цель;
+- путь к файлу цели;
+- какие пункты подтверждены;
+- главные изменённые файлы;
+- использованные скилы и ссылки на их артефакты;
+- выполненные проверки;
+- конкретный блокер и оставшиеся пункты, если работа не завершена.
+
+## Чего НЕ делать
+
+- Формулировать цели, применять запрошенные скилы, менять код, выполнять реализацию или ставить финальную отметку основным агентом.
+- Создавать файл до подтверждения точного списка целей человеком.
+- Раздувать файл деталями реализации или повторять в нём содержимое других артефактов.
+- Считать план, diff или самоотчёт исполнителя доказательством результата.
+- Отмечать цель выполненной без отдельного проверяющего.
+- Давать нескольким агентам параллельно редактировать общий журнал.
+- Терять вопросы, ответы, ссылки на артефакты или причины блокировки при продолжении.
+- Коммитить, пушить, создавать PR или выполнять другие внешние действия без явного запроса пользователя.

package/skills/eda-commit/SKILL.md

@@ -0,0 +1,124 @@
+---
+name: eda-commit
+description: 'Оркестрирует один логический коммит через двух последовательных пакетных агентов. `eda-commit-context` на `haiku` / `gpt-5.6-luna` собирает read-only контекст; `eda-commit-executor` на `sonnet` / `gpt-5.6-terra` формирует сообщение, коммитит и выполняет явно указанные push, PR или merge-действия. Учитывает весь текст текущего сообщения: если пользователь уже попросил отправить ветку, создать PR и дать ссылку, не задаёт общий вопрос после коммита. Не правит код и не отключает hooks.'
+---
+
+# Скил: Коммитер (eda-commit)
+
+Работай как лёгкий оркестратор двух установленных агентов. Сам не исследуй diff, не выбирай файлы, не составляй commit message и не выполняй git/GitHub-команды.
+
+## Вход из сообщения пользователя
+
+Сохрани весь текст текущего сообщения дословно в `$USER_REQUEST`. Это главный вход, а не только слова после имени скила или последний вопрос.
+
+Извлеки `$REQUESTED_ACTIONS`: ограничения и цепочку действий после коммита — `push`, отправить ветку, создать или обновить PR, вернуть ссылку, merge, переключить или удалить ветку. Поздний общий вопрос не отменяет конкретную команду из более ранней части того же сообщения.
+
+Пример: `eda-commit сразу отправь ветку и создай PR и дай ссылку` означает `commit → push → create-or-find PR → return URL`. После коммита не спрашивай, что делать дальше.
+
+При последующих уточнениях более поздняя явная команда или запрет имеют приоритет, но короткий ответ не заменяет остальной `$USER_REQUEST`. Историю прошлых сообщений используй только если пользователь явно связал её с текущим вызовом.
+
+## Агенты
+
+Запускай строго последовательно:
+
+| Этап | Агент | Claude Code | Codex |
+|---|---|---|---|
+| Контекст | `eda-commit-context` | `haiku` | `gpt-5.6-luna` |
+| Коммит и продолжение | `eda-commit-executor` | `sonnet` | `gpt-5.6-terra` |
+
+- В Claude Code запускай установленный custom agent через `Agent` tool по имени.
+- В Codex запускай установленный custom agent через `spawn_agent` или аналог по имени.
+- Не копируй в task-сообщение системный промпт агента: он уже установлен в `.claude/agents/` или `.codex/agents/`.
+- Передавай агенту только рабочую директорию, данные текущего запуска и требуемый формат результата.
+- Если custom agent или инструмент субагентов недоступен, остановись: `blocked: нужен установленный агент <имя>`; не выполняй его роль основным агентом и не заменяй отдельным CLI-процессом.
+
+## Интерактивные вопросы
+
+Когда агент вернул `blocked`, задай его один конкретный вопрос пользователю.
+
+- Claude Code: используй `AskUserQuestion`.
+- Codex interactive: используй `request_user_input`, если доступен; иначе задай короткий вопрос с вариантами 1–3 и остановись до ответа.
+- Codex exec / неинтерактивный запуск: не читай stdin; заверши со статусом `blocked: нужен ответ пользователя`, перечисли вопрос и варианты.
+- Никогда не задавай общий вопрос о дальнейших действиях, если `$REQUESTED_ACTIONS` уже содержит их.
+
+После ответа сохрани исходный `$USER_REQUEST`, добавь новый ответ и продолжи того же агента, если хост это поддерживает. Иначе запусти этого же custom agent заново с предыдущим результатом, актуальным состоянием и ответом.
+
+## Процесс
+
+### 1. Собрать контекст
+
+Запусти `eda-commit-context`. Передай:
+
+```text
+Рабочая директория: <cwd>
+USER_REQUEST:
+<полный дословный запрос>
+
+REQUESTED_ACTIONS:
+<цепочка действий>
+
+Верни результат строго по YAML-контракту агента.
+```
+
+Обработай `status`:
+
+- `empty` — сообщи, что коммитить нечего, и закончи;
+- `blocked` — задай возвращённый вопрос и после ответа повтори контекстный этап;
+- `ready` — передай полный YAML следующему агенту без пересказа и потери полей.
+
+### 2. Сделать коммит и продолжение
+
+Запусти `eda-commit-executor`. Передай:
+
+```text
+Рабочая директория: <cwd>
+USER_REQUEST:
+<полный дословный запрос>
+
+REQUESTED_ACTIONS:
+<цепочка действий>
+
+CONTEXT_RESULT:
+<полный YAML первого агента>
+
+Верни результат строго по YAML-контракту агента.
+```
+
+Явная команда пользователя разрешает обычные ожидаемые действия и безопасные предпосылки в её рамках. Например, «создай PR» разрешает обычный push текущей ветки, если без него PR создать нельзя. Она не разрешает force-push, публикацию секретов или другое не названное рискованное действие.
+
+Если executor вернул `blocked`, задай только его конкретный вопрос. Не теряй commit hash и уже выполненные действия при продолжении.
+
+### 3. Решить, нужен ли вопрос после коммита
+
+Если `$REQUESTED_ACTIONS` не пуст и агент выполнил всю цепочку, сразу переходи к финалу.
+
+Если `$REQUESTED_ACTIONS` пуст и статус `committed`, спроси пользователя, используя только применимые варианты, которые вернул executor:
+
+- push;
+- создать PR и дать ссылку;
+- merge в основную ветку, переключение и удаление текущей ветки;
+- ничего больше.
+
+Передай выбор тому же `eda-commit-executor`. Основной агент команды не выполняет.
+
+### 4. Финал
+
+Коротко сообщи из результата executor:
+
+- hash и заголовок коммита;
+- какие действия выполнены после коммита;
+- номер и фактический URL PR, если есть;
+- текущую ветку;
+- оставшиеся незакоммиченные файлы.
+
+Для `partial` сначала назови выполненные действия, затем ошибку и следующий безопасный шаг.
+
+## Чего НЕ делать
+
+- Выполнять работу `eda-commit-context` или `eda-commit-executor` основным агентом.
+- Запускать executor до готового результата context-agent.
+- Пересказывать YAML между агентами вместо передачи полного результата.
+- Терять начало `$USER_REQUEST` из-за последующего вопроса или ответа.
+- Спрашивать про push или PR, если пользователь уже явно приказал выполнить их.
+- Отключать hooks, использовать `--amend`, делать force-push в `main`/`master` или создавать дубликат PR.
+- Делать ревью или править логику кода — это другие скилы.

package/skills/eda-commit/skill.json

@@ -0,0 +1,6 @@
+{
+  "schemaVersion": 1,
+  "models": {
+    "claude": "haiku"
+  }
+}