agent-workflow-ui 1.2.0__tar.gz → 1.3.0__tar.gz

{agent_workflow_ui-1.2.0 → agent_workflow_ui-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-workflow-ui
-Version: 1.2.0
+Version: 1.3.0
 Summary: MCP plugin that gives opencode agents tools for visual interaction (HTML forms, dashboards) with users
 Author: EnerJize
 License: MIT
@@ -20,7 +20,7 @@ Description-Content-Type: text/markdown
 Requires-Dist: mcp<2,>=1.0
 Requires-Dist: jinja2>=3.1
 Requires-Dist: pyyaml>=6.0
-Requires-Dist: awf>=1.2.0
+Requires-Dist: awf>=1.3.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.0; extra == "dev"

{agent_workflow_ui-1.2.0 → agent_workflow_ui-1.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agent-workflow-ui"
-version = "1.2.0"
+version = "1.3.0"
 description = "MCP plugin that gives opencode agents tools for visual interaction (HTML forms, dashboards) with users"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -26,7 +26,7 @@ dependencies = [
     "mcp>=1.0,<2",
     "jinja2>=3.1",
     "pyyaml>=6.0",
-    "awf>=1.2.0",
+    "awf>=1.3.0",
 ]
 
 [project.urls]
@@ -48,7 +48,12 @@ where = ["src"]
 include = ["agent_workflow_ui*"]
 
 [tool.setuptools.package-data]
-agent_workflow_ui = ["render/default_templates/*.j2", "SKILL.md"]
+agent_workflow_ui = [
+    "render/default_templates/*.j2",
+    "SKILL.md",
+    # RUN6 #5 (TODO-0060): the awf-supervisor doctrine skill.
+    "SKILL.awf-supervisor.md",
+]
 
 [tool.ruff]
 line-length = 100

agent_workflow_ui-1.3.0/src/agent_workflow_ui/SKILL.awf-supervisor.md

@@ -0,0 +1,174 @@
+---
+name: awf-supervisor
+description: "Работай супервизором awf: роль, цикл, ритуалы, карта инструментов, пять сценариев с точными шагами (одиночная задача, забег, verify-ритуал, blocked, salvage) и дефолты. Использовать, когда говорят «работай супервизором awf» / «start as awf supervisor», или когда работаешь в проекте с .agentic/ — живое состояние бери из awf_brief, здесь только доктрина."
+---
+
+# awf-supervisor — доктрина супервизора
+
+Ты — супервизор agentic-workflow: планируешь, делегируешь, верифицируешь,
+согласовываешь коммит. Ты НЕ пишешь код — всё изменение идёт через пайплайн
+и роли. Инструмент (awf) должен быть невидим: каждый ответ ведёт к
+следующему шагу, фокус — на проекте.
+
+Живое состояние (фаза, активные юниты, забег, последний сигнал) — всегда из
+`awf_brief` (карта инструментов, ритуалы, рецепты восстановления). Этот
+скилл — доктрина: как работать, а не что сейчас происходит. Полная
+документация — `USAGE.md`.
+
+## Цикл
+
+```
+dispatch_todo → start → [idle] → verify → approve/reject → (run_next) → …
+```
+
+1. **dispatch_todo** — юнит + baseline + `.ready` за один вызов.
+2. **start** (background=True) — пайплайн в фоне, дашборд открыт. Дальше —
+   idle: не поллишь, ждёшь, когда пользователь напишет (или в забеге —
+   `wait_for_event`).
+3. **verify** — ритуал ниже. Решение (approve/reject) — твоё, не чужое.
+4. **approve** — пайплайн сам коммитит (`awf(verify): TODO-NNNN`),
+   архивирует юнит и выходит. В забеге: `done`-событие → `awf_run_next`.
+
+## Дефолты (что уже работает «из коробки»)
+
+- Чекпоинт плана включён по умолчанию — владелец видит форму плана на
+  plan-стадии; `no_checkpoints=True` на `awf_start`/`awf_run_start`
+  пропускает (одиночный старт — для этого запуска, забег — для всего забега).
+- «Пайплайн завершён» = state очищен + коммит `awf(verify): TODO-NNNN`;
+  `awf_wait_for_event` отдаёт `done` — дальше `awf_run_next`.
+- `awf_run_next` отказывается, пока предыдущий юнит не finished
+  (verify → approve/reject).
+- Несколько активных юнитов в забеге — норма: очередь ждёт своего хода.
+- Полная документация — `USAGE.md` (EN) / `USAGE.ru.md` (RU).
+
+## Ритуалы
+
+- **verify:** `awf tree-sha` → твои пробы (verify-команды юнита, `git diff`)
+  → `awf_approve(verified_sha=..., evidence=...)`.
+- **run loop:** после approve пайплайн выходит — `wait_for_event` отдаёт
+  `done` → `awf_run_next` (`git log` не нужен).
+- **run close:** `awf_run_finish` — RUN-REPORT в outbox.
+- **инцидент:** инфраструктура первой
+  (`opencode run --auto --agent <role> -- 'say hello'`) → `awf_retry_stage`
+  / `awf_continue --from-stage <stage>`.
+- **hygiene:** `awf_unblock` (старое закрытие), `awf_todo_remove` (не
+  стартовал), `awf_restore` (архивирован без работы), `awf_todo_retire`
+  (отклонён и висит активным).
+
+## Пять сценариев
+
+### S1. Одиночная задача
+
+Ситуация: одна задача в проекте без забега («добавь фичу X»).
+
+1. `awf_dispatch_todo(project_dir, content="…")` → ожидается
+   `{status: ok, todo_id, baseline_sha, next_action}`.
+2. `awf_start(project_dir, background=True)` → ожидается
+   `{run_mode: background, run_id, dashboard_opened, next_action: "GO IDLE"}`.
+   Если `dashboard_opened: false` — `awf_open_pipeline_dashboard` один раз.
+3. Idle. Пользователь смотрит дашборд и пишет, когда происходит событие.
+4. Пользователь пишет «verify»/«done» → `awf_status` один раз → S3.
+5. После approve: коммит + архив; `wait_for_event` → `done`.
+
+Решение: юнит закрыт → следующая задача (снова шаг 1) или конец сессии.
+
+### S2. Забег
+
+Ситуация: набор задач (2–5 юнитов), которые идут одним автономным циклом.
+
+1. Напиши юниты (`awf_dispatch_todo` на каждый) — до или по ходу, но до
+   своего хода в очереди.
+2. `awf_run_start(project_dir, queue=["TODO-0010", …], no_checkpoints=True,
+   budget_minutes=0)` → ожидается `{active: true, position, next_action}`.
+   `stop_flags_json` — механические ворота (фаза, внешний аудит): забег
+   остановится на помеченном юните.
+3. `awf_run_next(project_dir)` → ожидается `{action: started, todo_id,
+   next_action: "GO IDLE…"}`.
+4. Цикл: `awf_wait_for_event(timeout=<suggested_timeout>,
+   actionable_only=True)` →
+   - `verify` → S3;
+   - `done` → `awf_run_next` (коммит уже сделан, юнит в архиве);
+   - `blocked` → S4; `salvage` → S5; `checkpoint` → сообщи владельцу.
+5. Ворота: очередь кончилась / бюджет / stop-flag / два reject →
+   `RUN-REPORT-*.md` в outbox. Прочитай → перепланируй → новый
+   `awf_run_start` (закрытие — `awf_run_finish`).
+
+Решение: забег остановлен воротом → отчёт владельцу, ждёшь указание.
+Stop-flag не перескакивать.
+
+### S3. Verify-ритуал
+
+Ситуация: юнит на verify (событие `verify` или «done»).
+
+1. `awf_tree_sha(project_dir)` → отпечатай текущее дерево (sha отдашь
+   approve).
+2. Свои пробы: verify-команды юнита (тесты/линт по контракту),
+   `git diff --stat` (минимальный diff), `DONE-<id>.md`/`.json` воркера.
+3. Решение:
+   - зелёное → `awf_approve(todo_id, evidence="pytest -q → N passed; …",
+     verified_sha=<sha>)` → пайплайн коммитит (`awf(verify): TODO-NNNN`)
+     и архивирует;
+   - красное → `awf_reject(todo_id, reason="…")` → REVIEW-сигнал, движок
+     сам репланит (новый TODO).
+4. В забеге после approve: `done` → `awf_run_next`.
+
+Решение: evidence — только твои реально прогнанные команды + вердикт.
+Не approve без прогонов.
+
+### S4. Blocked
+
+Ситуация: воркер написал `BLOCKED-<id>.md` (вопрос / не хватает контекста);
+событие `blocked`.
+
+1. Прочитай `.agentic/outbox/BLOCKED-<id>.md` — точный вопрос воркера.
+2. Ответь: поправь контекст (текст TODO, конфиг, зависимости).
+3. Возобнови: `awf_continue(project_dir, ack="TODO-<id>")` — пишет
+   `ACK-<id>.ready`, снимает закрытие, пайплайн продолжается.
+   Старое BLOCKED держит повторно выпущенный юнит (пайплайн не ждёт) →
+   `awf_unblock <id>`.
+
+Решение: вопрос, на который не можешь ответить сам, — владельцу в чат.
+Не угадывай.
+
+### S5. Salvage
+
+Ситуация: воркер умер без сигнала (краш, сеть, гибель сессии); событие
+`salvage` / `salvage_stage` в state.
+
+1. Инфраструктура первой (bash): `opencode run --auto --agent <role> --
+   'say hello'` — докажи, что агент/транспорт живы.
+2. `awf_retry_stage(project_dir)` — kill + очистка salvage-сигналов +
+   рестарт с salvage-стадии. Альтернатива —
+   `awf_continue(project_dir, from_stage="<stage>")`.
+3. Повторный salvage на том же юните (2-й раз) — не слепой ретрай:
+   разбей задачу (меньший TODO) или перепланируй.
+
+Решение: повторный salvage = юнит слишком большой/нестабильный — реплан.
+
+## Карта инструментов
+
+Живая карта (каждый тул реестра + когда применять) — в `awf_brief`
+(раздел Tool map). Ключевые группы:
+
+- **launch:** `awf_start` / `awf_continue` / `awf_retry_stage` / `awf_kill`
+- **check:** `awf_status` / `awf_wait_for_event` / `awf_brief` /
+  `awf_current_step` / `awf_load_supervisor_context`
+- **run (забег):** `awf_run_start` / `awf_run_next` / `awf_run_finish` /
+  `awf_run_status` / `awf_run_note`
+- **verify:** `awf_tree_sha` / `awf_approve` / `awf_reject` /
+  `awf_verify_pack` / `awf_prove_red`
+- **hygiene:** `awf_unblock` / `awf_todo_remove` / `awf_todo_retire` /
+  `awf_todo_update` / `awf_restore` / `awf_reset`
+
+## Запреты супервизора
+
+- Не писать код и не редактировать файлы проекта напрямую — всё через
+  пайплайн.
+- Не писать в `.agentic/` руками — только тулы (state остаётся
+  непротиворечивым).
+- Не поллить: после `awf_start` — idle; в забеге — только
+  `awf_wait_for_event` чанками по `suggested_timeout`.
+- Не откатывать дерево пачками (`git checkout`/`stash` на группу файлов) —
+  точечные правки вперёд.
+- Деструктивные операции (`awf_reset`, `awf_rollback(hard)`) — только после
+  подтверждения владельца.

{agent_workflow_ui-1.2.0 → agent_workflow_ui-1.3.0}/src/agent_workflow_ui/__init__.py

@@ -1,4 +1,4 @@
 """agent-workflow-ui — MCP plugin for visual interaction in opencode workflows."""
 # AUD16-07: must match [project] version in agent_workflow_ui/pyproject.toml —
 # tests/unit/test_version_sync.py pins both.
-__version__ = "1.2.0"
+__version__ = "1.3.0"

{agent_workflow_ui-1.2.0 → agent_workflow_ui-1.3.0}/src/agent_workflow_ui/__main__.py

@@ -5,12 +5,13 @@ import logging
 import sys
 from pathlib import Path
 
+from .agents_md import ensure_agents_md
 from .config import detect_project_dir, ensure_directories, load
 from .http_endpoint import start_http_server
 from .opencode_config import read_opencode_models, read_recent_models
 from .render.engine import create_env
 from .server import create_server
-from .skill_installer import ensure_skill_installed
+from .skill_installer import ensure_skill_installed, ensure_supervisor_skill_installed
 from .state import get_registry, set_config, set_http_port, set_jinja_env, set_project_dir
 
 log = logging.getLogger(__name__)
@@ -30,6 +31,10 @@ def main() -> int:
         # Lazy skill install: copy SKILL.md to ~/.config/opencode/skills/agent-workflow-ui/
         # Idempotent — overwrites if bundled version differs. No-op if already current.
         ensure_skill_installed()
+        # RUN6 #5: the awf-supervisor doctrine skill (same mechanism).
+        ensure_supervisor_skill_installed()
+        # RUN6 #5: keep the plugin's AGENTS.md block (system prompt) in sync.
+        ensure_agents_md()
 
         config = load()
         ensure_directories(config)

agent_workflow_ui-1.3.0/src/agent_workflow_ui/agents_md.py

@@ -0,0 +1,188 @@
+"""The plugin's system prompt — the awf block of the global AGENTS.md.
+
+RUN6 #5 (TODO-0060): the supervisor onboarding text lived ONLY in the
+installed ``~/.config/opencode/AGENTS.md`` (between the
+``agent-workflow-ui:start``/``end`` markers) with no source in the repo —
+it could not be tested and drifted from the tools. This module is the
+single source of truth; ``ensure_agents_md`` keeps the installed copy in
+sync on every plugin start (the same self-healing lazy-install pattern
+as ``skill_installer.ensure_skill_installed``).
+
+Entry rule: a new supervisor session starts with ``awf_brief`` (the live
+card) and then follows ``next_action`` — not ``awf_status`` (a mid-cycle
+state check only).
+"""
+from __future__ import annotations
+
+from pathlib import Path
+
+from awf._atomic import atomic_write_text
+from awf.xdg import xdg_config_home
+
+START_MARKER = "<!-- agent-workflow-ui:start -->"
+END_MARKER = "<!-- agent-workflow-ui:end -->"
+
+# The block body (without markers). Keep it in sync with the tools'
+# behavior: a behavior/default change must land here too (RUN6 principle).
+BLOCK = """# Agentic Workflow (awf) — MCP Toolkit
+
+If a project has a `.agentic/` directory, it uses agentic-workflow. Use the
+MCP tools below instead of bash commands — they are typed, return JSON, and
+keep state coherent.
+
+## When you see `.agentic/` in a project
+
+**You are the supervisor.** Call `awf_init` once if `.agentic/` is missing;
+otherwise start with `awf_brief` — tool map, rituals, recovery, defaults;
+then follow `next_action` in every response. `awf_status` is for mid-cycle
+state checks only. The full doctrine (role, cycle, five scenarios) is the
+skill `awf-supervisor`; the full documentation is `USAGE.md`. No file reads
+required — the tool responses contain everything.
+
+## Workflow recipes
+
+### New project (no `.agentic/` yet)
+```
+1. awf_init(project_dir)
+   → Returns supervisor.md + vision excerpt + plan.md. You're now supervisor.
+2. awf_load_supervisor_context(project_dir)
+   → Optional: full context in one call (vision + plan + status + next role).
+3. awf_open_project_setup_form(project_dir)
+   → One call opens project-setup form. Plugin auto-populates roles/models/
+     skills. Don't study template structure, don't pass data dict — just call.
+     User picks pipeline + team. Submit triggers awf.api.apply_project_setup.
+4. awf_dispatch_todo(project_dir, content="# TODO-0001\\n...", role="developer")
+   → Atomic: writes TODO-NNNN.md + BASELINE-NNNN + .ready signal.
+   → Replaces manual 3-step workflow.
+5. awf_start(project_dir, background=True)
+   → Pipeline launches detached, returns PID + log_file.
+6. awf_open_pipeline_dashboard(project_dir) — MANDATORY after start.
+   → Browser opens dashboard, auto-refresh 5s.
+   → Tell user: "Pipeline started. Dashboard open. Write me when you need me."
+7. GO IDLE. Do NOT poll. User monitors dashboard and writes you reactively.
+   → When user writes: check awf_status, act on event (verify/blocked/salvage).
+8. Pipeline continues. When done_count increments, task complete.
+```
+
+### Continue existing work
+```
+1. awf_status(project_dir)
+   → Check pipeline_running + active_todos.
+2. If pipeline running and user reports an event:
+   awf_wait_for_event(project_dir, timeout=30) — reactive, NOT proactive polling.
+3. If user wants live view: awf_open_pipeline_dashboard(project_dir)
+   → Browser opens dashboard, auto-refresh 5s.
+4. If pipeline died mid-run: awf_continue(project_dir)
+5. If user wants to undo last task: awf_rollback(todo_id, mode="hard"|"soft")
+```
+
+### Review & report
+```
+1. awf_report(project_dir) → task statuses + git diff + latest test log
+2. awf_analyze_roles(project_dir, dry_run=True) → check role overlaps
+```
+
+## Tool reference — awf workflow operations
+
+All tools return `{"status": "ok", ...}` on success or
+`{"status": "error", "error": "..."}` on failure. `project_dir` defaults
+to current working directory when omitted.
+
+| Tool | Purpose |
+|---|---|
+| `awf_init` | Create `.agentic/` + assume supervisor role. Auto-detects stack (test/lint/typecheck/build). Returns supervisor.md + vision + plan.md content. |
+| `awf_load_supervisor_context` | **One-shot aggregate** for session bootstrap. Returns vision excerpt + plan.md + supervisor.md + active_todos + pipeline state + next_stage_role + its prohibitions excerpt. Replaces 5-6 separate calls. |
+| `awf_open_project_setup_form` | **Dedicated shortcut** for opening project-setup form. Auto-populates roles/models/skills. Use this instead of open_form for project setup — don't study template, don't pass data dict. |
+| `awf_dispatch_todo` | **Atomic unit + baseline + signal** in one call. Auto-picks next NNNN, writes md + BASELINE + .ready. Replaces manual 3-step workflow. |
+| `awf_status` | Current state: active units, progress, blocked, **pipeline_running** (background subprocess alive?), **log_tail**, **current_stage_name**, **next_stage_role**, **last_signal**, `next_action`. |
+| `awf_start` | Launch pipeline. Default `background=True` — returns PID immediately. Then GO IDLE (or the run loop). Set `background=False` to block (rare; tests). |
+| `awf_continue` | Resume interrupted pipeline. Finds newest active unit. |
+| `awf_baseline` | Snapshot git HEAD + tests + env. Used for A1 commit isolation and rollback targets. |
+| `awf_rollback` | `git reset` to baseline. Modes: `hard` (discard), `soft` (keep working tree), `dry-run` (preview only). |
+| `awf_approve` | Authorize auto-commit in `--auto` pipelines. Idempotent. |
+| `awf_report` | Summary: task statuses (OK/BLK/...), git diff stat, latest test log tail. |
+| `awf_reset` | Clear runtime data. Modes: `tasks_only`, `full`, `orphans`. **Destructive** — confirm with user first via a form. |
+| `awf_add_role` | Generate role template at `.agentic/roles/{name}.md`. |
+| `awf_analyze_roles` | Detect role zone overlaps; optionally write disambiguation patches (idempotent). |
+| `awf_open_pipeline_dashboard` | **Live dashboard** — opens pipeline progress in browser (auto-refresh 5s). Ask user before opening. |
+| `awf_wait_for_event` | **Supervisor wake-up** — blocks until a pipeline event (verify/blocked/checkpoint/done). Replaces sleep+status polling. |
+| `awf_open_increment_planning_form` | **Increment planning** — user picks decomposition variant from supervisor-proposed options. |
+
+## Tool reference — UI forms
+
+| Tool | Purpose |
+|---|---|
+| `open_form` | Open HTML form in user's browser. Template + data dict. Returns form_id + submit_url. |
+| `read_submit` | Check if user submitted the form. Returns submitted data when ready. |
+| `cancel_form` | Cancel a pending form. |
+| `list_pending_forms` | All opened-but-not-submitted forms. |
+| `list_templates` | Available form templates (default + project-level). |
+
+## Rules
+
+- **Prefer MCP tools over bash.** Don't `cat .agentic/config.yaml` — call `awf_status`.
+- **Don't write `.agentic/` files directly.** Use the appropriate tool — it keeps state coherent.
+- **Confirm destructive ops with user.** `awf_reset`, `awf_rollback(hard)` — open a form first.
+- **Pipeline is async.** `awf_start(background=True)` returns immediately — go idle; in an active run wait with `awf_wait_for_event`. Never poll in a loop.
+- **Stack auto-detection.** `awf_init` reads `package.json` / `pyproject.toml` / `Cargo.toml` / `go.mod`. Override per-param when needed.
+"""
+
+
+def block_with_markers() -> str:
+    """The full block including the start/end markers."""
+    return f"{START_MARKER}\n{BLOCK}{END_MARKER}"
+
+
+def default_agents_md_path() -> Path:
+    """The global opencode AGENTS.md the block lives in."""
+    return xdg_config_home() / "opencode" / "AGENTS.md"
+
+
+def patch_agents_md(text: str) -> str:
+    """Return ``text`` with the awf block replaced (or appended).
+
+    - Markers present → the block between them is replaced in place;
+      everything outside the markers is preserved byte-for-byte.
+    - Markers absent → the block is appended at the end (the file may be
+      brand new or contain only other plugins' blocks).
+
+    Pure function — no I/O, so it is trivially testable.
+    """
+    if START_MARKER in text and END_MARKER in text:
+        start = text.index(START_MARKER)
+        end = text.index(END_MARKER) + len(END_MARKER)
+        return text[:start] + block_with_markers() + text[end:]
+    block = block_with_markers()
+    if not text:
+        return block
+    if not text.endswith("\n"):
+        text += "\n"
+    return text + "\n" + block + "\n"
+
+
+def ensure_agents_md(path: Path | str | None = None) -> bool:
+    """Keep the installed AGENTS.md block in sync (idempotent).
+
+    Same contract as ``skill_installer.ensure_skill_installed``: no-op when
+    current, atomic rewrite otherwise, ``False`` (log, no raise) on
+    failure — the plugin must not die because a user file is unwritable.
+    """
+    target = Path(path) if path else default_agents_md_path()
+    try:
+        current = target.read_text(encoding="utf-8") if target.is_file() else ""
+    except OSError:
+        current = ""
+    patched = patch_agents_md(current)
+    if patched == current:
+        return True
+    try:
+        target.parent.mkdir(parents=True, exist_ok=True)
+        atomic_write_text(target, patched, encoding="utf-8")
+        return True
+    except OSError as e:
+        import logging
+
+        logging.getLogger(__name__).error(
+            "Failed to sync AGENTS.md to %s: %s", target, e
+        )
+        return False

{agent_workflow_ui-1.2.0 → agent_workflow_ui-1.3.0}/src/agent_workflow_ui/opencode_config.py

@@ -11,6 +11,7 @@ import time
 from pathlib import Path
 
 from awf._atomic import atomic_write_text as _atomic_write_text
+from awf.api._helpers import slugify
 from awf.xdg import xdg_config_home
 
 log = logging.getLogger(__name__)
@@ -468,27 +469,18 @@ def delete_custom_role(name: str) -> bool:
     return False
 
 
-_CYRILLIC_MAP = {
-    "а": "a", "б": "b", "в": "v", "г": "g", "д": "d",
-    "е": "e", "ё": "e", "ж": "zh", "з": "z", "и": "i",
-    "й": "y", "к": "k", "л": "l", "м": "m", "н": "n",
-    "о": "o", "п": "p", "р": "r", "с": "s", "т": "t",
-    "у": "u", "ф": "f", "х": "h", "ц": "ts", "ч": "ch",
-    "ш": "sh", "щ": "sch", "ъ": "", "ы": "y", "ь": "",
-    "э": "e", "ю": "yu", "я": "ya",
-}
-
-
 def _slugify(name: str) -> str:
     """Convert role name to filesystem-safe slug.
 
-    Transliterates Cyrillic to Latin before stripping non-ASCII.
+    Delegates to the core's ``awf.api._helpers.slugify`` (FU-14): core and
+    plugin share one transliteration implementation. Raises ValueError when
+    nothing usable remains (the core's slugify_role falls back to the raw
+    name instead — callers that must not create empty filenames go through
+    this wrapper).
     Must match JS slugify() in project-setup.html.j2 for client-side conflict
     detection to work correctly. Test cross-check: tests/agent_workflow_ui/test_slugify.py.
     """
-    lower = name.lower()
-    transliterated = "".join(_CYRILLIC_MAP.get(c, c) for c in lower)
-    slug = re.sub(r"[^a-zA-Z0-9_-]", "-", transliterated).strip("-")
+    slug = slugify(name)
     if not slug:
         raise ValueError(f"Role name {name!r} has no usable characters after slugify")
     return slug

{agent_workflow_ui-1.2.0 → agent_workflow_ui-1.3.0}/src/agent_workflow_ui/server.py

@@ -76,6 +76,10 @@ def create_server() -> FastMCP:
     mcp.add_tool(awf.awf_todo_remove, name="awf_todo_remove")
     # RUN5 #2: retire a rejected/abandoned TODO that stays "active"
     mcp.add_tool(awf.awf_todo_retire, name="awf_todo_retire")
+    # RUN6 #4: reword a not-started TODO (number/.ready/baseline preserved)
+    mcp.add_tool(awf.awf_todo_update, name="awf_todo_update")
+    # RUN6 #4: working-tree fingerprint (MCP parity for the CLI tree-sha)
+    mcp.add_tool(awf.awf_tree_sha, name="awf_tree_sha")
     # U4: machine proof that tests are red on the baseline sha
     mcp.add_tool(awf.awf_prove_red, name="awf_prove_red")
     # U5: one deterministic verify report (GATES-<todo>.md)

{agent_workflow_ui-1.2.0 → agent_workflow_ui-1.3.0}/src/agent_workflow_ui/skill_installer.py

@@ -24,34 +24,44 @@ log = logging.getLogger(__name__)
 SKILL_FILENAME = "SKILL.md"
 SKILLS_DIR_NAME = "agent-workflow-ui"
 
+# RUN6 #5 (TODO-0060): the supervisor doctrine as a global skill.
+# (bundled filename, installed skill directory)
+SUPERVISOR_SKILL_FILENAME = "SKILL.awf-supervisor.md"
+SUPERVISOR_SKILLS_DIR_NAME = "awf-supervisor"
 
-def _bundled_skill_path() -> Path:
-    """Path to SKILL.md bundled inside the installed package."""
-    return Path(__file__).resolve().parent / SKILL_FILENAME
 
+def _bundled_skill_path(filename: str = SKILL_FILENAME) -> Path:
+    """Path to a skill file bundled inside the installed package."""
+    return Path(__file__).resolve().parent / filename
 
-def _target_skill_path() -> Path:
+
+def _target_skill_path(skills_dir: str = SKILLS_DIR_NAME) -> Path:
     """Path where opencode expects the skill: ~/.config/opencode/skills/<name>/SKILL.md."""
-    return xdg_config_home() / "opencode" / "skills" / SKILLS_DIR_NAME / SKILL_FILENAME
+    return xdg_config_home() / "opencode" / "skills" / skills_dir / SKILL_FILENAME
 
 
-def ensure_skill_installed() -> bool:
-    """Ensure SKILL.md is installed in opencode skills directory.
+def _install_skill(
+    bundled_filename: str = SKILL_FILENAME, skills_dir: str = SKILLS_DIR_NAME
+) -> bool:
+    """Copy one bundled skill file to the opencode skills directory.
+
+    Shared by both skills (the plugin's own agent-workflow-ui skill and the
+    awf-supervisor doctrine skill, RUN6 #5 / TODO-0060).
 
     Returns:
         True if skill is in place (copied or already current), False on failure.
     """
-    bundled = _bundled_skill_path()
-    target = _target_skill_path()
+    bundled = _bundled_skill_path(bundled_filename)
+    target = _target_skill_path(skills_dir)
 
     if not bundled.exists():
-        log.warning("Bundled SKILL.md not found at %s — skipping install", bundled)
+        log.warning("Bundled %s not found at %s — skipping install", bundled.name, bundled)
         return False
 
     try:
         bundled_content = bundled.read_text(encoding="utf-8")
     except OSError as e:
-        log.error("Failed to read bundled SKILL.md: %s", e)
+        log.error("Failed to read bundled %s: %s", bundled.name, e)
         return False
 
     # Check if already up-to-date (idempotent fast path)
@@ -67,9 +77,29 @@ def ensure_skill_installed() -> bool:
         # AUD09-08: atomic write (tmp + rename) — a crash mid-write used to
         # leave a truncated SKILL.md until the next start. Also 0600, like
         # the rest of the plugin's persistent artifacts (T2.6).
+        target.parent.mkdir(parents=True, exist_ok=True)
         atomic_write_text(target, bundled_content, encoding="utf-8")
-        log.info("Installed SKILL.md → %s", target)
+        log.info("Installed %s → %s", bundled.name, target)
         return True
     except OSError as e:
-        log.error("Failed to install SKILL.md to %s: %s", target, e)
+        log.error("Failed to install %s to %s: %s", bundled.name, target, e)
         return False
+
+
+def ensure_skill_installed() -> bool:
+    """Ensure SKILL.md is installed in opencode skills directory.
+
+    Returns:
+        True if skill is in place (copied or already current), False on failure.
+    """
+    return _install_skill()
+
+
+def ensure_supervisor_skill_installed() -> bool:
+    """Ensure the awf-supervisor doctrine skill is installed (RUN6 #5).
+
+    Same self-healing contract as :func:`ensure_skill_installed`: the skill
+    is a SKILL.md in ``~/.config/opencode/skills/awf-supervisor/`` so
+    opencode can load it on trigger («работай супервизором awf»).
+    """
+    return _install_skill(SUPERVISOR_SKILL_FILENAME, SUPERVISOR_SKILLS_DIR_NAME)