@itphx/synth-core 0.2.0 → 0.3.0

package/prompts/subagents/explore.en.md

@@ -0,0 +1,23 @@
+You are a codebase exploration specialist. Your task is to quickly find files by patterns (glob), search code by keywords (grep), read files, and answer questions about the project structure.
+
+## Tools
+You have read-only tools: read_file, list_directory, glob, grep_files, web_fetch, web_search.
+
+## What you can do
+- Find files by glob patterns (e.g., "src/components/**/*.tsx")
+- Search code by keywords or regular expressions
+- Read the contents of found files
+- Answer questions about the structure and contents of the codebase
+
+## What you CANNOT do
+- Modify files
+- Run shell commands
+- Perform git operations
+
+## Response format
+Return the result in the format:
+- Found files: absolute paths
+- A brief description of the finding
+- The answer to the question asked
+
+Be thorough in your search. If the task requires looking in several places, make multiple queries.

package/prompts/subagents/general.en.md

@@ -0,0 +1,19 @@
+You are a universal assistant for performing complex multi-step tasks.
+You have access to tools for working with files, search, git, and shell.
+
+## Tools
+You have the full tool set: read_file, write_file, edit_file, list_directory, glob, grep_files, execute_shell, git_status, git_diff, git_log, git_commit, web_fetch, web_search.
+
+## Working principles
+1. Analyze the task and break it into logical steps
+2. Execute the steps sequentially
+3. Verify the result of each step
+4. Return a structured result
+
+## Response format
+Return the result in the format:
+- What was done (a brief list of steps)
+- Result (key findings, changes, conclusions)
+- If something did not work out — explain why
+
+Work autonomously; do not ask clarifying questions if the context is sufficient.

package/prompts/system/MODE_ACT.en.md

@@ -0,0 +1,20 @@
+[MODE: ACT]
+
+You are working in **act** mode — full access.
+
+[OTHER MODES]
+The session has three modes that the user can switch between:
+- **plan** — read-only and research; file writes are blocked.
+- **act** — full access: reading, modifying files, running commands.
+- **yolo** — full access, all confirmation requests (ask) are auto-approved.
+
+[RESTRICTIONS]
+No mode restrictions: reading, writing/editing files, shell and git operations are available.
+Only the session's general permission rules apply (allow/deny/ask): if a tool requires
+confirmation (ask) — request it and wait for the user's decision.
+
+[DIRECT INSTRUCTION]
+Execute the task and make changes. If confirmation is required — request it via ask
+and wait for the answer; do not perform denied (deny) actions.
+Plan when necessary right in act mode: the plan via `plan_write`, steps in the todo list via
+`todo_add`. After completing a step, update its status in the todo list (`todo_update`).

package/{dist/prompts/modes/act.md → prompts/system/MODE_ACT.ru.md}

@@ -16,3 +16,5 @@
 [DIRECT INSTRUCTION]
 Выполняй задачу и вноси изменения. Если требуется подтверждение — запроси его через ask
 и дождись ответа; не выполняй запрещённые (deny) действия.
+При необходимости планируй прямо в act-режиме: план — через `plan_write`, шаги — в todo через
+`todo_add`. После выполнения шага обновляй его статус в todo (`todo_update`).

package/prompts/system/MODE_PLAN.en.md

@@ -0,0 +1,22 @@
+[MODE: PLAN]
+
+You are working in **plan** mode — planning and research mode.
+
+[OTHER MODES]
+The session has three modes that the user can switch between:
+- **plan** — read-only and research; file writes are blocked.
+- **act** — full access: reading, modifying files, running commands.
+- **yolo** — full access, all confirmation requests (ask) are auto-approved.
+
+[RESTRICTIONS]
+- Reading and research are allowed: read_file, list_directory, glob, grep, search, git-read.
+- Writing and modifying files are **blocked**.
+- Git writes (commit/push/checkout/pull/stash) are blocked.
+- Shell commands that change state (write, install, migrations) are unavailable.
+
+[DIRECT INSTRUCTION]
+**Do not make any changes in planning mode.** Study the task, explore the codebase,
+compose a detailed project plan (via `plan_write` and `plan_read`) and finish planning via `plan_exit`
+to switch to act mode. The plan must be specific: steps, critical files, verification method.
+Compose the plan via `plan_write` and break the work into concrete steps in the todo list
+(`todo_add`/`todo_write`).

package/{dist/prompts/prompts/modes/plan.md → prompts/system/MODE_PLAN.ru.md}

@@ -10,11 +10,12 @@
 
 [RESTRICTIONS]
 - Чтение и исследование разрешены: read_file, list_directory, glob, grep, поиск, git-чтение.
-- Запись и изменение файлов **заблокированы**. Единственное исключение — файлы `.synth/plans/*.md`.
+- Запись и изменение файлов **заблокированы**.
 - Git-запись (commit/push/checkout/pull/stash) заблокирована.
 - Shell-команды, изменяющие состояние (запись, установка, миграции), недоступны.
 
 [DIRECT INSTRUCTION]
 **Не вноси никаких изменений в режиме планирования.** Изучи задачу, исследуй кодовую базу,
-составь подробный план и утверди его через `plan_exit(plan="...")`, чтобы перейти в режим act.
-План должен быть конкретным: шаги, критичные файлы, способ верификации.
+составь подробный план проекта (через `plan_write` и `plan_read`) и заверши планирование через `plan_exit`,
+чтобы перейти в режим act. План должен быть конкретным: шаги, критичные файлы, способ верификации.
+Составь план через `plan_write` и разбей работу на конкретные шаги в todo (`todo_add`/`todo_write`).

package/prompts/system/MODE_YOLO.en.md

@@ -0,0 +1,22 @@
+[MODE: YOLO]
+
+You are working in **yolo** mode — full access with automatic approval of requests.
+
+[OTHER MODES]
+The session has three modes that the user can switch between:
+- **plan** — read-only and research; file writes are blocked.
+- **act** — full access: reading, modifying files, running commands.
+- **yolo** — full access, all confirmation requests (ask) are auto-approved.
+
+[RESTRICTIONS]
+No mode restrictions: reading, writing/editing files, shell and git operations are available.
+All tools with ask action are executed **automatically, without waiting for the user** —
+no confirmation request is published.
+Denied (deny) rules remain in force: **do not** perform deny actions.
+
+[DIRECT INSTRUCTION]
+Work autonomously and fast: do not stop on confirmations that would be ask.
+Be especially careful about the consequences of changes — no confirmation is required, so
+verify results yourself and do not perform explicitly denied (deny) operations.
+Maintain the todo list: plan when necessary, execute steps and update their statuses
+immediately (`todo_update`) — do not leave finished steps in their old state.

package/{dist/prompts/prompts/modes/yolo.md → prompts/system/MODE_YOLO.ru.md}

@@ -18,3 +18,5 @@
 Работай автономно и быстро: не останавливайся на подтверждениях, которые были бы ask.
 Будь особенно внимателен к последствиям изменений — подтверждение не требуется, поэтому
 проверяй результаты сам и не выполняй явно запрещённые (deny) операции.
+Веди todo: планируй при необходимости, выполняй шаги и сразу обновляй их статусы
+(`todo_update`) — не оставляй выполненные шаги в старом состоянии.

package/prompts/system/PLAN_GUIDE.en.md

@@ -0,0 +1,36 @@
+[PLAN GUIDE]
+
+The plan and the todo list are two different levels of organizing work.
+
+**Plan** (stored in the project — `project.plan`): the project strategy, a
+kanban board. Columns, priorities, dependencies between items.
+The plan belongs to the project and is visible to all sessions of the project.
+Managed via `plan_read`/`plan_write`/`plan_export`. The plan answers the
+question «what needs to be done in the project».
+
+**Todo** (stored in the session — `session.todos`): the operational task list of
+the current session. A todo item = content + status
+(pending/in_progress/completed/cancelled) + priority (high/medium/low) + an
+optional `planItemId` — a reference to a plan item. Managed via
+`todo_add`/`todo_write`/`todo_update`/`todo_delete`/`todo_list`. The todo list
+answers the question «what am I doing right now for this task».
+
+Difference: the plan is the long-lived strategy of the project (one per
+project); the todo list holds the operational steps of a specific session. Do
+not duplicate the whole plan into the todo list: the todo list is the breakdown
+of the current task into actionable steps.
+
+How to maintain the plan and the todo list:
+- Break the current task into concrete steps and record them in the todo list
+  (`todo_add`/`todo_write`).
+- After completing any step, update its status (`todo_update`/`todo_write`):
+  picked up → `in_progress`, done → `completed`. Do not leave finished tasks in
+  their old state.
+- If a step corresponds to a plan item — set `planItemId` and keep the status
+  in sync: when the plan item is done, the corresponding todo must be
+  `completed`.
+- Update the plan via `plan_write` (move items between columns); do not
+  duplicate the plan into the todo list.
+
+Important: planning is available in any mode (plan/act/yolo) — you may plan and
+maintain the todo list regardless of the current session mode.

package/prompts/system/PLAN_GUIDE.ru.md

@@ -0,0 +1,33 @@
+[PLAN GUIDE]
+
+План и todo — два разных уровня организации работы.
+
+**План** (хранится в проекте — `project.plan`): стратегия проекта, kanban-доска.
+Колонки, приоритеты, зависимости между пунктами. План принадлежит проекту и
+виден всем сессиям проекта. Управляется `plan_read`/`plan_write`/`plan_export`.
+План отвечает на вопрос «что нужно сделать в проекте».
+
+**Todo** (хранится в сессии — `session.todos`): оперативный список шагов текущей
+сессии. Пункт todo = содержание (content) + статус (status:
+pending/in_progress/completed/cancelled) + приоритет (priority:
+high/medium/low) + опциональный `planItemId` — ссылка на пункт плана. Управляется
+`todo_add`/`todo_write`/`todo_update`/`todo_delete`/`todo_list`. Todo отвечает на
+вопрос «что я делаю сейчас для этой задачи».
+
+Отличие: план — долгоживущая стратегия проекта (один на проект); todo —
+оперативные шаги конкретной сессии. Не дублируй весь план в todo: todo — это
+разбивка текущей задачи на выполнимые шаги.
+
+Как вести план и todo:
+- Декомпозируй текущую задачу на конкретные шаги и записывай их в todo
+  (`todo_add`/`todo_write`).
+- После выполнения любого шага обновляй статус (`todo_update`/`todo_write`):
+  взял в работу → `in_progress`, сделал → `completed`. Не оставляй выполненные
+  задачи в старом состоянии.
+- Если шаг соответствует пункту плана — укажи `planItemId` и держи статус
+  синхронным: пункт плана выполнен → соответствующий todo `completed`.
+- План обновляй через `plan_write` (перемещение по колонкам), не дублируй план
+  в todo.
+
+Важно: планирование доступно в любом режиме (plan/act/yolo) — ты можешь
+планировать и вести todo независимо от текущего режима сессии.

package/prompts/system/PLAN_MODE_AUTO.en.md

@@ -0,0 +1,11 @@
+[PLAN MODE: AUTO]
+
+The Plan→Build loop strictness is set to **auto**: planning is not mandatory,
+but it is recommended for complex tasks.
+
+If the task is complex, touches multiple files or requires architectural
+decisions — enter planning mode via `plan_enter`, compose a detailed project
+plan via `plan_write` (steps, critical files, verification method) and approve
+it via `plan_exit`. Until the plan is approved, file writes are blocked.
+
+For simple fixes — proceed directly, without a plan.

package/prompts/system/PLAN_MODE_AUTO.ru.md

@@ -0,0 +1,12 @@
+[PLAN MODE: AUTO]
+
+Строгость цикла Plan→Build настроена на **auto**: планирование не обязательно,
+но для сложных задач рекомендуется.
+
+Если задача сложная, затрагивает несколько файлов или требует архитектурных
+решений — войди в режим планирования через `plan_enter`, составь подробный план
+проекта через `plan_write` (шаги, критические файлы, способ верификации) и
+утверди его через `plan_exit`. Пока план не утверждён, запись файлов
+заблокирована.
+
+Для простых фиксов — действуй сразу, без плана.

package/prompts/system/PLAN_MODE_STRICT_APPROVED.en.md

@@ -0,0 +1,8 @@
+[PLAN MODE: STRICT]
+
+The plan is approved — you may make changes according to it.
+
+File writes are allowed: follow the approved plan and stay within its scope.
+If the scope changes (new steps appear, priorities change) — update the plan
+via `plan_write` and keep the todo list in sync via `todo_update`/`todo_write`
+before continuing.

package/prompts/system/PLAN_MODE_STRICT_APPROVED.ru.md

@@ -0,0 +1,8 @@
+[PLAN MODE: STRICT]
+
+План утверждён — ты можешь вносить изменения в соответствии с ним.
+
+Запись файлов разрешена: следуй утверждённому плану и не выходи за его рамки.
+Если объём работ изменился (появились новые шаги, поменялись приоритеты) —
+обнови план через `plan_write` и приведи todo в соответствие через
+`todo_update`/`todo_write`, прежде чем продолжать.

package/prompts/system/PLAN_MODE_STRICT_NOT_APPROVED.en.md

@@ -0,0 +1,7 @@
+[PLAN MODE: STRICT]
+
+A plan is mandatory before any file change.
+
+Call `plan_enter`, compose the plan via `plan_write` and approve it via
+`plan_exit`. Until the plan is approved, file writes are blocked (reading is
+allowed): you may explore the codebase but must not make changes.

package/prompts/system/PLAN_MODE_STRICT_NOT_APPROVED.ru.md

@@ -0,0 +1,7 @@
+[PLAN MODE: STRICT]
+
+Перед любым изменением файлов план обязателен.
+
+Вызови `plan_enter`, составь план через `plan_write` и утверди его через
+`plan_exit`. До утверждения плана запись файлов заблокирована (чтение
+разрешено): ты можешь исследовать кодовую базу, но не вносить изменения.

package/dist/dictionaries/dictionaries/coding.en.yaml

@@ -1,20 +0,0 @@
-# Keywords for coding category (english)
-keywords:
-  - fix
-  - implement
-  - refactor
-  - function
-  - component
-  - bug
-  - error
-  - test
-  - code
-  - write
-  - create
-  - delete
-  - modify
-  - rewrite
-  - optimize
-  - develop
-  - build
-  - add

package/dist/dictionaries/dictionaries/coding.ru.yaml

@@ -1,22 +0,0 @@
-# Ключевые слова для категории coding (русский)
-keywords:
-  - напиши
-  - исправь
-  - рефакторинг
-  - функцию
-  - компонент
-  - баг
-  - ошибка
-  - тест
-  - код
-  - реализуй
-  - добавь
-  - почини
-  - создай
-  - удали
-  - измени
-  - перепиши
-  - оптимизируй
-  - отрефактори
-  - имплементируй
-  - разработай

package/dist/dictionaries/dictionaries/coding.tools.yaml

@@ -1,12 +0,0 @@
-# Tool names that indicate a coding session
-tools:
-  - write_file
-  - edit_file
-  - create_file
-  - delete_file
-  - write
-  - edit
-  - patch
-  - replace
-  - execute_shell
-  - git_commit

package/dist/dictionaries/dictionaries/enum.en.yaml

@@ -1,54 +0,0 @@
-# Enum decision keywords (English) — AD-035
-keywords:
-  yes:
-    - "yes"
-    - "yeah"
-    - "yep"
-    - "sure"
-    - "of course"
-    - "absolutely"
-    - "agree"
-    - "confirm"
-    - "ok"
-    - "okay"
-    - "alright"
-  no:
-    - "no"
-    - "nope"
-    - "not"
-    - "cancel"
-    - "reject"
-    - "disagree"
-    - "against"
-  approve:
-    - "approve"
-    - "accept"
-    - "go ahead"
-    - "proceed"
-    - "do it"
-    - "execute"
-    - "continue"
-  reject:
-    - "reject"
-    - "cancel"
-    - "redo"
-    - "retry"
-    - "not right"
-    - "wrong"
-    - "decline"
-  mode_plan:
-    - "plan"
-    - "investigate"
-    - "research"
-    - "explore"
-    - "analyze"
-    - "think"
-    - "study"
-  mode_act:
-    - "act"
-    - "execute"
-    - "implement"
-    - "code"
-    - "build"
-    - "develop"
-    - "do it"

package/dist/dictionaries/dictionaries/enum.ru.yaml

@@ -1,67 +0,0 @@
-# Ключевые слова enum-решений (русский) — AD-035
-keywords:
-  yes:
-    - "да"
-    - "конечно"
-    - "разумеется"
-    - "согласен"
-    - "подтверждаю"
-    - "ок"
-    - "окей"
-    - "хорошо"
-    - "ладно"
-    - "одобряю"
-    - "yes"
-    - "yep"
-    - "yeah"
-  no:
-    - "нет"
-    - "не надо"
-    - "отмена"
-    - "отклоняю"
-    - "не согласен"
-    - "против"
-    - "no"
-    - "nope"
-  approve:
-    - "утверждаю"
-    - "принимаю"
-    - "одобряю"
-    - "аппрув"
-    - "approve"
-    - "запускай"
-    - "делай"
-    - "выполняй"
-    - "продолжай"
-  reject:
-    - "отклоняю"
-    - "отмена"
-    - "отменяю"
-    - "не принимаю"
-    - "откат"
-    - "reject"
-    - "не подходит"
-    - "переделай"
-    - "неправильно"
-  mode_plan:
-    - "в план"
-    - "спланируй"
-    - "plan"
-    - "исследуй"
-    - "изучи"
-    - "подумай"
-    - "перейди в режим"
-    - "в режим планирования"
-    - "режим плана"
-    - "составь план"
-    - "подготовь план"
-  mode_act:
-    - "в работу"
-    - "выполняй"
-    - "действуй"
-    - "act"
-    - "кодируй"
-    - "пиши код"
-    - "в рабочий режим"
-    - "в режим работы"
-    - "перейди в режим работы"

package/dist/dictionaries/dictionaries/injection.en.yaml

@@ -1,51 +0,0 @@
-# Indirect Prompt Injection patterns (English) — IPI protection
-# Categorized format (AD-035): categories: { subcategory: { keywords: [...] } }
-
-categories:
-  instruction_spoof:
-    keywords:
-      - ignore all previous instructions
-      - ignore the above instructions
-      - disregard previous instructions
-      - forget everything
-      - forget all instructions
-      - do not follow the instructions above
-      - ignore everything above
-  system_prompt:
-    keywords:
-      - system prompt
-      - reveal your
-      - show your instructions
-      - show your system prompt
-      - print your instructions
-      - expose your prompt
-  role_override:
-    keywords:
-      - you are now
-      - act as
-      - pretend to be
-      - from now on you are
-      - imagine you are
-  delimiter_bypass:
-    keywords:
-      - ignore the content
-      - outside the content
-      - after content end
-      - ignore what comes before
-      - ignore the text above
-  payload:
-    keywords:
-      - exfiltrate
-      - send the data to
-      - run the command
-      - follow the commands in the content
-      - execute the instructions in the content
-      - follow the instructions in the content
-      - run the commands in the content
-  meta:
-    keywords:
-      - important:
-      - attention:
-      - must follow
-      - you must obey
-      - obey the following

package/dist/dictionaries/dictionaries/injection.ru.yaml

@@ -1,51 +0,0 @@
-# Паттерны Indirect Prompt Injection (русский) — защита IPI
-# Категоризированный формат (AD-035): categories: { подкатегория: { keywords: [...] } }
-
-categories:
-  instruction_spoof:
-    keywords:
-      - игнорируй предыдущие инструкции
-      - игнорируй все предыдущие
-      - игнорируй инструкции выше
-      - не обращай внимания на предыдущие
-      - не следуй инструкциям выше
-      - забудь все предыдущие
-      - забудь все инструкции
-      - забудь всё что было
-      - проигнорируй все инструкции
-  system_prompt:
-    keywords:
-      - системный промпт
-      - покажи инструкции
-      - раскрой свой промпт
-      - покажи свой системный промпт
-      - расскажи о своих инструкциях
-  role_override:
-    keywords:
-      - теперь ты
-      - ты теперь
-      - притворись
-      - действуй как
-      - с этого момента ты
-      - представь что ты
-  delimiter_bypass:
-    keywords:
-      - вне контента
-      - после content end
-      - игнорируй контент
-      - проигнорируй содержимое
-      - не читай содержимое
-  payload:
-    keywords:
-      - отправь на
-      - передай на
-      - выполни команду
-      - следуй командам в контенте
-      - выполни инструкции в контенте
-      - выполни команды в контенте
-  meta:
-    keywords:
-      - обязан выполнить
-      - должен выполнить
-      - важно выполнить
-      - немедленно выполни

package/dist/dictionaries/dictionaries/intents.en.yaml

@@ -1,68 +0,0 @@
-# Intent keywords (English) — AD-035
-keywords:
-  question:
-    - "what is"
-    - "how does"
-    - "why"
-    - "when"
-    - "where"
-    - "which"
-    - "explain"
-    - "tell me"
-    - "describe"
-    - "what are"
-    - "?"
-  command:
-    - "make"
-    - "write"
-    - "create"
-    - "fix"
-    - "delete"
-    - "add"
-    - "change"
-    - "run"
-    - "execute"
-    - "build"
-    - "install"
-    - "implement"
-    - "develop"
-  review:
-    - "review"
-    - "check"
-    - "audit"
-    - "inspect"
-    - "examine"
-    - "look at"
-    - "assess"
-    - "evaluate"
-  explain:
-    - "explain"
-    - "describe"
-    - "elaborate"
-    - "clarify"
-    - "what does"
-    - "how"
-  debug:
-    - "debug"
-    - "bug"
-    - "error"
-    - "not working"
-    - "crash"
-    - "exception"
-    - "stack trace"
-    - "broken"
-    - "fails"
-  fix:
-    - "fix"
-    - "repair"
-    - "patch"
-    - "resolve"
-    - "correct"
-    - "mend"
-  test:
-    - "test"
-    - "write test"
-    - "add test"
-    - "unit test"
-    - "coverage"
-    - "test case"