micro-models-agent 2.16.1 → 2.17.2

package/dist/modules/execution/plan-coverage.js

@@ -1,71 +0,0 @@
-// Покрытие плана: упомянутые в задаче файлы обязаны встречаться в шагах.
-import { stripUrls } from "../hallucination/js-identifiers";
-/**
- * Coverage-allow-list расширений. Считаются только реальные типы deliverable-
- * файлов: проза `e.g` / `i.e` (расширения `g`/`e`) за файлы не сойдёт, а
- * web/doc-результаты (`.css`, `.html`, `.scss`, `.md`) проверяются —
- * старый deny-list их молча пропускал.
- */
-const COVERAGE_EXT = new Set([
-    // Код
-    "ts", "tsx", "js", "jsx", "mjs", "cjs", "py", "rb", "go", "rs", "java",
-    "kt", "kts", "cs", "php", "swift", "c", "cc", "cpp", "cxx", "h", "hpp",
-    "lua", "pl", "sh", "bash", "zsh", "bat", "cmd", "ps1", "sql", "vue",
-    "svelte", "dart", "scala", "clj",
-    // web / доки / конфиги
-    "css", "scss", "less", "html", "htm", "md", "mdx", "json", "json5",
-    "toml", "yaml", "yml", "ini", "env", "txt",
-]);
-const FILE_PATH_RE = /\b[\w./\\-]+\.[a-z]{1,6}\b/gi;
-/**
- * Извлекает пути файлов (с расширениями), упомянутые в формулировке задачи.
- * Проверяет, покрывает ли сгенерированный план каждый требуемый файл.
- */
-export function extractFilePaths(text) {
-    if (!text)
-        return [];
-    const seen = new Set();
-    const result = [];
-    for (const m of stripUrls(text).matchAll(FILE_PATH_RE)) {
-        const p = m[0].replace(/[.,;:)\]>]+$/g, "");
-        if (!p)
-            continue;
-        // Требуем настоящее имя: непустой stem перед расширением в последнем
-        // сегменте (сегменты `tsx/.ts` / `.env` — не "файлы").
-        const slash = Math.max(p.lastIndexOf("/"), p.lastIndexOf("\\"));
-        const last = slash >= 0 ? p.slice(slash + 1) : p;
-        const dot = last.lastIndexOf(".");
-        if (dot <= 0)
-            continue;
-        if (!COVERAGE_EXT.has(last.slice(dot + 1).toLowerCase()))
-            continue;
-        const key = p.toLowerCase();
-        if (seen.has(key))
-            continue;
-        seen.add(key);
-        result.push(p);
-    }
-    return result;
-}
-function basename(p) {
-    const parts = p.split(/[/\\]/);
-    return parts[parts.length - 1] ?? p;
-}
-/**
- * Сравнивает файловые требования задачи с описаниями шагов плана. Требование
- * "покрыто", если его путь (или basename) есть хоть в одном шаге. Возвращает
- * недостающие пути.
- */
-export function checkPlanCoverage(taskText, stepDescriptions) {
-    const taskPaths = extractFilePaths(taskText);
-    if (taskPaths.length === 0)
-        return { missing: [] };
-    const stepText = stepDescriptions.map((s) => s.toLowerCase()).join("\n");
-    const missing = taskPaths.filter((p) => {
-        const lower = p.toLowerCase();
-        const base = basename(lower);
-        // Шаг с полным относительным путём или его basename — засчитывается.
-        return !stepText.includes(lower) && !stepText.includes(base);
-    });
-    return { missing };
-}

package/dist/modules/execution/plan-persister.js

@@ -1,46 +0,0 @@
-import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
-import { join } from "path";
-export class PlanPersister {
-    filePath;
-    constructor(baseDir) {
-        const mmaDir = join(baseDir, ".mma");
-        if (!existsSync(mmaDir)) {
-            mkdirSync(mmaDir, { recursive: true });
-        }
-        this.filePath = join(mmaDir, "plan.json");
-    }
-    save(plan) {
-        const file = {
-            id: plan.id,
-            title: plan.title,
-            steps: plan.steps,
-            createdAt: plan.createdAt,
-            updatedAt: new Date().toISOString(),
-            baseDir: plan.baseDir,
-        };
-        writeFileSync(this.filePath, JSON.stringify(file, null, 2), "utf-8");
-    }
-    load() {
-        if (!existsSync(this.filePath))
-            return null;
-        try {
-            const raw = readFileSync(this.filePath, "utf-8");
-            const file = JSON.parse(raw);
-            return {
-                id: file.id || "plan_legacy",
-                title: file.title,
-                steps: file.steps,
-                createdAt: file.createdAt,
-                baseDir: file.baseDir || process.cwd(),
-            };
-        }
-        catch {
-            return null;
-        }
-    }
-    clear() {
-        if (existsSync(this.filePath)) {
-            writeFileSync(this.filePath, "", "utf-8");
-        }
-    }
-}

package/dist/modules/execution/plan-steps.js

@@ -1,31 +0,0 @@
-/**
- * Авто-переключение шага плана на kind="delete".
- *
- * Два независимых механизма писали `step.kind = "delete"` и сами персистили
- * план:
- * - plan-tool: шаг помечается done, а все его дативные файлы подтверждённо
- *   удалены (deliverable gate);
- * - execution-plugin: модель вызвала delete_file, и удалённый путь
- *   пересекается с описанием шага.
- *
- * Здесь — единая точка, чтобы инвариант «сменить kind и сохранить план»
- * жил в одном месте и не расходился между авторами.
- *
- * @returns true, если шаг был переключён (и план сохранён); false, если
- * kind уже был "delete" — ничего не менялось.
- */
-export function switchStepKind(plan, step, kind, save) {
-    if (step.kind === kind)
-        return false;
-    step.kind = kind;
-    save(plan);
-    return true;
-}
-/** Переключает шаг в kind="delete" (с сохранением плана). Возвращает, был ли сменён. */
-export function switchStepToDelete(plan, step, save) {
-    return switchStepKind(plan, step, "delete", save);
-}
-/** Переключает шаг в kind="create" (с сохранением плана). Возвращает, был ли сменён. */
-export function switchStepToCreate(plan, step, save) {
-    return switchStepKind(plan, step, "create", save);
-}

package/dist/modules/execution/plan-store.js

@@ -1,274 +0,0 @@
-// Персист планов: active/drafts/archive в .mma/plans + миграция legacy plan.json.
-import { readFileSync, writeFileSync, renameSync, mkdirSync, existsSync, readdirSync, rmSync } from "fs";
-import { join } from "path";
-import { Logger } from "../../logger/app-logger";
-import { errMsg } from "../../utils";
-import { projectMmaDir } from "../../config/paths";
-const log = new Logger("info", "plan-store");
-const LEGACY_FILE = "plan.json";
-function readPlanFile(path, fallbackBaseDir) {
-    try {
-        const raw = readFileSync(path, "utf-8");
-        if (!raw.trim())
-            return null;
-        const parsed = JSON.parse(raw);
-        if (!parsed || !Array.isArray(parsed.steps))
-            return null;
-        return {
-            id: parsed.id || "plan_legacy",
-            title: parsed.title || "Legacy plan",
-            steps: parsed.steps,
-            createdAt: parsed.createdAt || new Date().toISOString(),
-            baseDir: parsed.baseDir || fallbackBaseDir,
-            name: parsed.name,
-        };
-    }
-    catch {
-        return null;
-    }
-}
-function writePlanFile(path, plan) {
-    // Атомарная запись: крах посреди записи не оставит обрезанный файл плана
-    // (readPlanFile молча вернёт null на битом JSON → активный план потерян).
-    // Имя tmp уникально на процесс: два `mma` на общем `.mma/plans/active.json`
-    // не уводят друг у друга `.tmp` (ENOENT).
-    const tmpPath = `${path}.${process.pid}.${Math.random().toString(36).slice(2, 8)}.tmp`;
-    try {
-        writeFileSync(tmpPath, JSON.stringify(plan, null, 2), "utf-8");
-        renameSync(tmpPath, path);
-    }
-    catch (e) {
-        try {
-            if (existsSync(tmpPath))
-                rmSync(tmpPath);
-        }
-        catch {
-            /* best-effort очистка */
-        }
-        log.warn(`failed to persist plan to ${path}`, { error: errMsg(e) });
-        throw e;
-    }
-}
-function listDir(dir, baseDir) {
-    if (!existsSync(dir))
-        return [];
-    const files = readdirSync(dir).filter((f) => f.endsWith(".json"));
-    return files.map((f) => readPlanFile(join(dir, f), baseDir)).filter((p) => p !== null);
-}
-function toMeta(plan, status) {
-    return {
-        id: plan.id,
-        name: plan.name,
-        title: plan.title,
-        status,
-        createdAt: plan.createdAt,
-        stepCount: plan.steps.length,
-        doneCount: plan.steps.filter((s) => s.status === "done" || s.status === "skipped").length,
-    };
-}
-/** Хранилище планов: active/drafts/archive + миграция legacy-файла. */
-export class PlanStore {
-    baseDir;
-    plansDir;
-    draftsDir;
-    archiveDir;
-    legacyPath;
-    constructor(baseDir) {
-        const mmaDir = projectMmaDir(baseDir);
-        if (!existsSync(mmaDir))
-            mkdirSync(mmaDir, { recursive: true });
-        this.baseDir = baseDir;
-        this.plansDir = join(mmaDir, "plans");
-        this.draftsDir = join(this.plansDir, "drafts");
-        this.archiveDir = join(this.plansDir, "archive");
-        this.legacyPath = join(mmaDir, LEGACY_FILE);
-        for (const dir of [this.plansDir, this.draftsDir, this.archiveDir]) {
-            if (!existsSync(dir))
-                mkdirSync(dir, { recursive: true });
-        }
-    }
-    activePath() {
-        return join(this.plansDir, "active.json");
-    }
-    /** Корень per-session слотов активного плана. */
-    sessionsDir() {
-        return join(this.plansDir, "sessions");
-    }
-    /** Проверяет id сессии как сегмент пути (без сепараторов/..). */
-    sessionActivePath(sessionId) {
-        if (!/^[A-Za-z0-9_-]+$/.test(sessionId)) {
-            throw new Error(`invalid session id: ${sessionId}`);
-        }
-        return join(this.sessionsDir(), sessionId, "active.json");
-    }
-    // ---- Активный план сессии ----
-    /** Сохраняет активный план сессии. */
-    saveSessionActive(sessionId, plan) {
-        const p = this.sessionActivePath(sessionId);
-        const dir = join(this.sessionsDir(), sessionId);
-        if (!existsSync(dir))
-            mkdirSync(dir, { recursive: true });
-        writePlanFile(p, plan);
-    }
-    /** Загружает активный план сессии. Пустая/новая сессия — null.
-     *  Без fallback на глобальный active.json: усыновление legacy-плана делает
-     *  явно только bootstrap (через switchSession-персист), иначе каждая новая
-     *  сессия наследовала бы чужой план. */
-    loadSessionActive(sessionId) {
-        const p = this.sessionActivePath(sessionId);
-        if (!existsSync(p))
-            return null;
-        return readPlanFile(p, this.baseDir);
-    }
-    /** Убирает активный план сессии. Нет слота — no-op. */
-    clearSessionActive(sessionId) {
-        const p = this.sessionActivePath(sessionId);
-        if (existsSync(p))
-            rmSync(p, { force: true });
-    }
-    // ---- Активный план ----
-    /** Сохраняет активный план. */
-    saveActive(plan) {
-        writePlanFile(this.activePath(), plan);
-    }
-    /** Загружает активный план (с миграцией legacy .mma/plan.json). Null, если нет. */
-    loadActive() {
-        const activePath = this.activePath();
-        if (existsSync(activePath)) {
-            const plan = readPlanFile(activePath, this.baseDir);
-            if (plan)
-                return plan;
-        }
-        // Миграция legacy: читаем .mma/plan.json и переносим в active
-        if (existsSync(this.legacyPath)) {
-            const legacy = readPlanFile(this.legacyPath, this.baseDir);
-            if (legacy) {
-                this.saveActive(legacy);
-                try {
-                    rmSync(this.legacyPath, { force: true });
-                }
-                catch (err) {
-                    log.warn("Failed to remove migrated legacy plan.json", {
-                        path: this.legacyPath,
-                        error: errMsg(err),
-                    });
-                }
-                return legacy;
-            }
-        }
-        return null;
-    }
-    /** Убирает активный план. */
-    clearActive() {
-        const p = this.activePath();
-        if (existsSync(p))
-            rmSync(p, { force: true });
-    }
-    // ---- Черновики (сохранённые планы) ----
-    /** Сохраняет план в черновики. */
-    saveDraft(plan) {
-        writePlanFile(join(this.draftsDir, `${plan.id}.json`), plan);
-    }
-    /** Загружает черновик по id. Null, если нет. */
-    loadDraft(id) {
-        const p = join(this.draftsDir, `${id}.json`);
-        return existsSync(p) ? readPlanFile(p, this.baseDir) : null;
-    }
-    /** Удаляет черновик по id. */
-    removeDraft(id) {
-        const p = join(this.draftsDir, `${id}.json`);
-        if (existsSync(p))
-            rmSync(p, { force: true });
-    }
-    /** Все черновики. */
-    listDrafts() {
-        return listDir(this.draftsDir, this.baseDir);
-    }
-    // ---- Архив ----
-    /** Архивирует план (убирает из черновиков/активного при совпадении). */
-    archivePlan(plan) {
-        writePlanFile(join(this.archiveDir, `${plan.id}.json`), plan);
-        // Убираем из черновиков, если там был
-        this.removeDraft(plan.id);
-        // Если архивируемый был активным — чистим active
-        const active = this.loadActive();
-        if (active && active.id === plan.id) {
-            this.clearActive();
-        }
-    }
-    /** Все архивные планы. */
-    listArchived() {
-        return listDir(this.archiveDir, this.baseDir);
-    }
-    /** Удаляет архивный план по id. */
-    removeArchived(id) {
-        const p = join(this.archiveDir, `${id}.json`);
-        if (existsSync(p))
-            rmSync(p, { force: true });
-    }
-    // ---- Кросс-статусные запросы ----
-    /** Метаданные всех планов (активный + черновики + архив). */
-    listAll() {
-        const metas = [];
-        const active = this.loadActive();
-        if (active)
-            metas.push(toMeta(active, "active"));
-        for (const p of this.listDrafts())
-            metas.push(toMeta(p, "draft"));
-        for (const p of this.listArchived())
-            metas.push(toMeta(p, "archived"));
-        return metas;
-    }
-    /** Находит план по id в любом статусе. Null, если нет. */
-    find(id) {
-        const active = this.loadActive();
-        if (active && active.id === id)
-            return { plan: active, status: "active" };
-        const draft = this.loadDraft(id);
-        if (draft)
-            return { plan: draft, status: "draft" };
-        const archived = this.listArchived().find((p) => p.id === id);
-        if (archived)
-            return { plan: archived, status: "archived" };
-        return null;
-    }
-    // ---- Удаление (юзер просил: планы должны реально исчезать) ----
-    /** Навсегда удаляет план, где бы ни лежал. Возвращает его статус, или null
-     *  если плана с таким id нет. */
-    deletePlan(id) {
-        const active = this.loadActive();
-        if (active && active.id === id) {
-            this.clearActive();
-            return "active";
-        }
-        const draftPath = join(this.draftsDir, `${id}.json`);
-        if (existsSync(draftPath)) {
-            rmSync(draftPath, { force: true });
-            return "draft";
-        }
-        const archivedPath = join(this.archiveDir, `${id}.json`);
-        if (existsSync(archivedPath)) {
-            rmSync(archivedPath, { force: true });
-            return "archived";
-        }
-        return null;
-    }
-    /** Удаляет все планы (активный, черновики, архив). Возвращает число удалённых. */
-    purgeAll() {
-        let n = 0;
-        const active = this.loadActive();
-        if (active) {
-            this.clearActive();
-            n++;
-        }
-        for (const p of this.listDrafts()) {
-            this.removeDraft(p.id);
-            n++;
-        }
-        for (const p of this.listArchived()) {
-            this.removeArchived(p.id);
-            n++;
-        }
-        return n;
-    }
-}

package/dist/modules/execution/plan-tool.js

@@ -1,249 +0,0 @@
-import { t } from "../../i18n/index";
-import { dispatchPlanAction, updatePlanStep } from "./plan-actions";
-/**
- * Маркит подзадачи done по числовым id (предпочтительно) или точному тексту (фолбэк).
- * Возвращает число отмеченных, или строку ошибки если ничего не сошлось.
- */
-function markTodoDone(subs, ids, items) {
-    let marked = 0;
-    if (ids.length > 0) {
-        for (const id of ids) {
-            const sub = subs.find((s) => !s.done && s.id === id);
-            if (sub) {
-                sub.done = true;
-                marked++;
-            }
-        }
-        if (marked === 0) {
-            return {
-                error: t("todo.subtask_id_not_found", { ids: ids.join(", ") }),
-            };
-        }
-        return { marked };
-    }
-    for (const item of items) {
-        const sub = subs.find((s) => !s.done && s.text.toLowerCase() === item.toLowerCase());
-        if (sub) {
-            sub.done = true;
-            marked++;
-        }
-    }
-    if (marked === 0) {
-        return {
-            error: t("todo.subtask_not_found", { items: items.join(", ") }),
-        };
-    }
-    return { marked };
-}
-/**
- * Определения тулов plan / todo / verify для execution-модуля. Хендлеры
- * вынесены дословно из ExecutionModule.getToolDefinitions() — весь доступ к
- * состоянию идёт через `deps`-замыкания (трекер и стор принадлежат модулю).
- */
-export function createPlanToolDefinitions(deps) {
-    return [
-        {
-            name: "plan",
-            icon: "📋",
-            alwaysOn: true,
-            description: 'Create, update, show, abort, list, switch, delete, purge, or re-plan multi-step plans.\n\nActions:\n- create: Start a new plan. Previous active plan is auto-preserved: incomplete → draft, complete → archive.\n- update: Mark step status (done/failed/skipped). To change the plan\'s steps use "re-plan" (keeps completed steps) or "create".\n- show: Print current plan checklist.\n- abort: Archive the current plan (or the plan given by id) and clear the active slot.\n- list: Show all plans (active, drafts, archived) with progress.\n- switch: Make a different plan active (by plan id).\n- re-plan: Iterative replanning: keep completed steps, replace remaining with new steps.\n- delete: Permanently delete a plan by id (plan delete id=plan_xxx).\n- purge: Delete ALL plans (active, drafts, archived).\n\nWrite CONCRETE steps with exact file paths and commands:\n- Specify WHICH files to create with exact paths (e.g. "create src/components/Header.tsx with navigation and logo")\n- Specify WHICH packages to install (e.g. "run npm install react react-dom")\n- Specify WHICH CLI commands to run with exact arguments\n- Each step should include at least one file extension (.ts, .tsx, .json, etc.) or a command verb (install, create, build, run, add, init)\n- Good: "Создать src/components/Header.tsx с навигацией и логотипом"\n- Bad: "Настройка проекта" (too vague — what exactly needs to be configured?)\n- Steps that REMOVE files need no extra flag: create/delete intent is detected automatically from what the agent actually does.\n- Every step needs a verification contract: pass "checks" aligned 1:1 with "steps". Each check is "file-exists:<path>" (verified automatically on done), "command:<exact command>" (run it before done), or "manual:<what to check by eye>" (UI/visual work only). Example: steps ["Create src/a.ts with X"] + checks ["file-exists:src/a.ts"].',
-            parameters: {
-                type: "object",
-                properties: {
-                    action: {
-                        type: "string",
-                        enum: [
-                            "create",
-                            "update",
-                            "show",
-                            "abort",
-                            "list",
-                            "switch",
-                            "re-plan",
-                            "delete",
-                            "purge",
-                        ],
-                    },
-                    title: { type: "string" },
-                    steps: { type: "array", items: { type: "string" } },
-                    checks: {
-                        type: "array",
-                        items: { type: "string" },
-                        description: 'REQUIRED on create/re-plan, aligned 1:1 with steps. One contract per step: "file-exists:<path>", "command:<cmd>", or "manual:<text>".',
-                    },
-                    step: { type: "number" },
-                    status: { type: "string", enum: ["done", "failed", "skipped"] },
-                    note: { type: "string" },
-                    id: { type: "string", description: "Plan id (for switch action)" },
-                },
-                required: ["action"],
-            },
-            handler: async (ctx, args) => {
-                const action = String(args.action);
-                // Диспетчер по действию: по одной функции на action (plan-actions.ts).
-                const result = dispatchPlanAction(action, deps, ctx, args);
-                if (result !== null)
-                    return result;
-                return {
-                    success: false,
-                    output: t("plan.unknown_action", { action }),
-                };
-            },
-        },
-        {
-            name: "plan_step",
-            icon: "📋",
-            alwaysOn: true,
-            description: 'Mark ONE plan step done/failed/skipped: plan_step step=N status=done|failed|skipped (note="..." optional). Prefer this over "plan update" — no action parameter to confuse. The step\'s check contract is verified automatically on done ("file-exists:" hard-verified, "command:"/"manual:" self-certified).',
-            parameters: {
-                type: "object",
-                properties: {
-                    step: { type: "number", description: "Step number to update" },
-                    status: { type: "string", enum: ["done", "failed", "skipped"] },
-                    note: { type: "string" },
-                },
-                required: ["step"],
-            },
-            handler: async (ctx, args) => {
-                if (!deps.trackerRef.current) {
-                    return { success: false, output: t("plan.no_active") };
-                }
-                if (args.step === undefined || args.step === null || Number.isNaN(Number(args.step))) {
-                    return { success: false, output: t("plan.step_required") };
-                }
-                return updatePlanStep(deps, ctx, args);
-            },
-        },
-        {
-            name: "todo",
-            icon: "☑️",
-            alwaysOn: true,
-            description: "Manage sub-tasks within current plan step. Use to break down complex steps into smaller tasks. Mark done by subtask ids from todo list (ids=[...]) — reliable; matching by text is a fallback.",
-            parameters: {
-                type: "object",
-                properties: {
-                    action: { type: "string", enum: ["add", "done", "list"] },
-                    items: { type: "array", items: { type: "string" } },
-                    ids: {
-                        type: "array",
-                        items: { type: "number" },
-                        description: "Subtask ids to mark done (see todo list output). Preferred over items.",
-                    },
-                },
-                required: ["action"],
-            },
-            handler: async (_ctx, args) => {
-                if (!deps.trackerRef.current) {
-                    return { success: false, output: t("plan.no_active") };
-                }
-                const tracker = deps.trackerRef.current;
-                const action = String(args.action);
-                const currentStep = tracker.getCurrentStep();
-                if (!currentStep) {
-                    return { success: false, output: t("plan.step_not_found") };
-                }
-                if (action === "add" && Array.isArray(args.items)) {
-                    const items = args.items.map(String);
-                    const existing = currentStep.subtasks ?? [];
-                    let nextId = existing.reduce((m, s) => Math.max(m, s.id), 0) + 1;
-                    for (const item of items) {
-                        existing.push({ id: nextId++, text: item, done: false });
-                    }
-                    currentStep.subtasks = existing;
-                    deps.store.saveActive(tracker.getPlan());
-                    const display = tracker.toPromptBlock();
-                    const addedIds = existing.slice(-items.length).map((s) => s.id);
-                    const addedOutput = t("todo.added", {
-                        count: String(items.length),
-                        items: items.join(", "),
-                    }) + ` (ids: ${addedIds.join(", ")})`;
-                    return {
-                        success: true,
-                        output: addedOutput,
-                        display,
-                    };
-                }
-                if (action === "done") {
-                    const ids = Array.isArray(args.ids) ? args.ids.map(Number).filter((n) => !Number.isNaN(n)) : [];
-                    const items = Array.isArray(args.items) ? args.items.map(String) : [];
-                    if (ids.length === 0 && items.length === 0) {
-                        return {
-                            success: false,
-                            output: t("todo.no_items"),
-                        };
-                    }
-                    const subs = currentStep.subtasks ?? [];
-                    const done = markTodoDone(subs, ids, items);
-                    if ("error" in done) {
-                        return { success: false, output: done.error };
-                    }
-                    const marked = done.marked;
-                    currentStep.subtasks = subs;
-                    deps.store.saveActive(tracker.getPlan());
-                    const doneCount = subs.filter((s) => s.done).length;
-                    const display = tracker.toPromptBlock();
-                    // Отметка подзадачи done НЕ должна автозавершать шаг плана: шаг done,
-                    // только когда модель подтвердит весь шаг через plan update (было: 3 ×
-                    // "todo done" вернули "Step 3: done" и преждевременно закрыли шаг).
-                    let output = t("todo.marked_done", {
-                        count: String(marked),
-                    });
-                    output += ` (${doneCount}/${subs.length})`;
-                    if (doneCount === subs.length) {
-                        output += `\n${t("plan.subtasks_done", { stepId: String(currentStep.id) })}`;
-                    }
-                    return { success: true, output, display };
-                }
-                if (action === "list") {
-                    const subs = currentStep.subtasks ?? [];
-                    const lines = subs.length
-                        ? subs.map((s) => `[${s.id}] ${s.done ? "[x]" : "[ ]"} ${s.text}`)
-                        : [t("plan.no_subtasks")];
-                    return {
-                        success: true,
-                        output: `${t("plan.step_label", { stepId: String(currentStep.id), description: currentStep.description })}\n${lines.join("\n")}`,
-                    };
-                }
-                return {
-                    success: false,
-                    output: t("todo.unknown_action", { action }),
-                };
-            },
-        },
-        {
-            name: "verify",
-            icon: "✅",
-            alwaysOn: true,
-            description: "Run verification for the current step. Checks files mentioned in the step description.",
-            parameters: {
-                type: "object",
-                properties: {
-                    step: { type: "number", description: "Step number to verify" },
-                },
-            },
-            handler: async (_ctx, args) => {
-                if (!deps.trackerRef.current)
-                    return { success: false, output: t("plan.no_active") };
-                const tracker = deps.trackerRef.current;
-                const step = args.step ? tracker.getStep(Number(args.step)) : tracker.getCurrentStep();
-                if (!step)
-                    return { success: false, output: t("plan.step_not_found") };
-                const result = await deps.verifier.verifyStep(step.description, step.kind);
-                if (result.noFiles) {
-                    return {
-                        success: true,
-                        output: t("verify.no_files", { step: String(step.id) }),
-                    };
-                }
-                return {
-                    success: result.passed,
-                    output: result.passed
-                        ? t("verify.passed")
-                        : t("verify.failed", {
-                            details: result.failed.map((f) => f.message).join("; "),
-                        }),
-                };
-            },
-        },
-    ];
-}