@goodtek/vibeops 0.4.0 → 1.0.0

package/dist/commands/task-generate.js

@@ -1,206 +0,0 @@
-import { isAbsolute, join, relative, resolve } from "node:path";
-import { pathExists, writeText } from "../lib/filesystem.js";
-import { bold, cyan, dim, log, yellow } from "../lib/logger.js";
-import { projectPaths } from "../lib/paths.js";
-import { collectInputDocs, } from "../lib/project-docs.js";
-import { formatTaskId, nextTaskNumber } from "../lib/task.js";
-import { buildTaskGeneratePrompt, } from "../lib/task-generator.js";
-import { planScaffoldEntries, renderScaffoldMarkdown, writeScaffoldFiles, } from "../lib/task-scaffold.js";
-import { VERSION } from "../version.js";
-const DEFAULT_PROMPT_REL = ".vibeops/generated/task-generate-prompt.md";
-const DEFAULT_COUNT = 8;
-const COUNT_SOFT_CAP = 20;
-const BRIEF_REL = ".vibeops/brief/project-brief.md";
-function toAbsolute(root, candidate) {
-    return isAbsolute(candidate) ? candidate : resolve(root, candidate);
-}
-function relDisplay(root, abs) {
-    const r = relative(root, abs);
-    return r.length === 0 ? "." : r;
-}
-function parseCount(raw) {
-    if (raw === undefined)
-        return { count: DEFAULT_COUNT, warning: false };
-    const n = typeof raw === "number" ? raw : Number.parseInt(String(raw).trim(), 10);
-    if (!Number.isFinite(n) || n <= 0) {
-        return {
-            count: DEFAULT_COUNT,
-            warning: false,
-            error: `--count must be a positive integer (got: "${String(raw)}"). Falling back to default ${DEFAULT_COUNT}.`,
-        };
-    }
-    return { count: Math.floor(n), warning: n > COUNT_SOFT_CAP };
-}
-function presentInventory(docs) {
-    const present = [];
-    const missing = [];
-    if (docs.from)
-        (docs.from.content !== null ? present : missing).push(docs.from);
-    for (const slot of docs.slots)
-        (slot.content !== null ? present : missing).push(slot);
-    if (docs.brief.content !== null)
-        present.push(docs.brief);
-    else
-        missing.push(docs.brief);
-    return { present, missing };
-}
-export async function taskGenerateCommand(options = {}) {
-    const cwd = resolve(options.cwd ?? process.cwd());
-    const paths = projectPaths(cwd);
-    const dryRun = options.dryRun === true;
-    const scaffold = options.scaffold === true;
-    const briefAbs = join(cwd, BRIEF_REL);
-    const parsedCount = parseCount(options.count);
-    if (parsedCount.error)
-        log.warn(parsedCount.error);
-    const count = parsedCount.count;
-    const countWarning = parsedCount.warning;
-    if (countWarning) {
-        log.warn(`--count ${count} is large (soft cap ${COUNT_SOFT_CAP}). Continuing, but the Planner Agent may push back.`);
-    }
-    const fromAbs = options.from ? toAbsolute(cwd, options.from) : undefined;
-    if (typeof fromAbs === "string" && !(await pathExists(fromAbs))) {
-        log.error(`--from path not found: ${fromAbs}`);
-        log.info(`If you meant a relative path, run from the project root or pass --cwd <path>.`);
-        process.exitCode = 1;
-        return;
-    }
-    log.info(bold(scaffold ? "vibeops task generate --scaffold" : "vibeops task generate"));
-    log.info(`  ${dim("cwd")}        ${cwd}`);
-    log.info(`  ${dim("mode")}       ${scaffold ? "scaffold (write skeleton TASK files)" : "prompt (build Cursor prompt)"}`);
-    if (options.phase)
-        log.info(`  ${dim("phase")}      ${options.phase}`);
-    log.info(`  ${dim("count")}      ${count}${countWarning ? yellow("  (above soft cap)") : ""}`);
-    if (fromAbs)
-        log.info(`  ${dim("--from")}     ${relDisplay(cwd, fromAbs)}`);
-    if (dryRun)
-        log.info(`  ${dim("dry-run")}    on (no file writes)`);
-    log.blank();
-    if (scaffold) {
-        await runScaffold({
-            tasksDir: paths.docsTasks,
-            cwd,
-            count,
-            phase: options.phase,
-            dryRun,
-        });
-        return;
-    }
-    await runPromptMode({
-        cwd,
-        paths,
-        options,
-        fromAbs,
-        briefAbs,
-        count,
-        countWarning,
-        dryRun,
-    });
-}
-async function runPromptMode(inputs) {
-    const { cwd, paths, options, fromAbs, briefAbs, count, countWarning, dryRun } = inputs;
-    const promptAbs = typeof options.output === "string"
-        ? toAbsolute(cwd, options.output)
-        : join(cwd, DEFAULT_PROMPT_REL);
-    const docs = await collectInputDocs({ cwd, fromPath: options.from, fromAbs, briefAbs });
-    const { present, missing } = presentInventory(docs);
-    log.info(bold("Input documents"));
-    for (const s of present)
-        log.info(`  ${cyan("✓")} ${relDisplay(cwd, s.path)}  ${dim(`(${s.label})`)}`);
-    for (const s of missing)
-        log.info(`  ${dim("·")} ${relDisplay(cwd, s.path)}  ${dim(`(${s.label} — missing)`)}`);
-    log.blank();
-    const nextNum = await nextTaskNumber(paths.docsTasks);
-    const nextId = formatTaskId(nextNum);
-    log.info(bold("Plan"));
-    log.info(`  ${dim("next TASK id")}   ${nextId}`);
-    log.info(`  ${dim("prompt output")}  ${relDisplay(cwd, promptAbs)}`);
-    log.blank();
-    if (dryRun) {
-        log.info(bold("dry-run — would perform:"));
-        log.info(`  · read ${present.length} input doc(s) (skipped ${missing.length} missing slot${missing.length === 1 ? "" : "s"})`);
-        log.info(`  · build Cursor prompt for ~${count} TASK starting at ${nextId}`);
-        log.info(`  · write prompt to ${relDisplay(cwd, promptAbs)}`);
-        log.info(`  · no LLM / Cursor / Notion / GitHub / Git call`);
-        log.blank();
-        log.info(dim("no files were written."));
-        return;
-    }
-    const promptInputs = {
-        cwd,
-        vibeopsVersion: VERSION,
-        generatedAt: new Date().toISOString(),
-        nextTaskId: nextId,
-        count,
-        outputPath: promptAbs,
-        outputRelative: relDisplay(cwd, promptAbs),
-        docs,
-        countWarning,
-        ...(typeof options.phase === "string" && options.phase.length > 0
-            ? { phase: options.phase }
-            : {}),
-    };
-    const md = buildTaskGeneratePrompt(promptInputs);
-    await writeText(promptAbs, md);
-    log.ok(`Cursor task-generate prompt: ${relDisplay(cwd, promptAbs)}`);
-    log.blank();
-    log.info(bold("Next steps"));
-    log.info(`  1) Open a new Cursor chat and paste the full contents of ${cyan(relDisplay(cwd, promptAbs))}.`);
-    log.info(`  2) Review the Planner Agent's \`docs/tasks/TASK-NNN-*.md\` files with \`git diff\` and commit.`);
-    log.info(`  3) Start the first new TASK with ${cyan(`vibeops task start ${nextId}`)}.`);
-    if (missing.length > 0) {
-        log.blank();
-        log.info(`${yellow("!")} ${missing.length} input slot(s) are missing on disk. The Planner Agent will see them as "missing"; decide whether to fill them this round.`);
-    }
-}
-async function runScaffold(inputs) {
-    const plan = await planScaffoldEntries({
-        tasksDir: inputs.tasksDir,
-        count: inputs.count,
-        ...(typeof inputs.phase === "string" && inputs.phase.length > 0
-            ? { phase: inputs.phase }
-            : {}),
-    });
-    log.info(bold("Scaffold plan"));
-    log.info(`  ${dim("start at")}  ${formatTaskId(plan.startNumber)}`);
-    log.info(`  ${dim("count")}     ${plan.entries.length}`);
-    log.blank();
-    log.info(bold("Files to create"));
-    for (const e of plan.entries) {
-        log.info(`  · ${relDisplay(inputs.cwd, e.absPath)}  ${dim(`(${e.phase})`)}`);
-    }
-    log.blank();
-    if (inputs.dryRun) {
-        log.info(dim("dry-run — no files were written."));
-        log.info(`Skeleton preview (first entry, ${plan.entries[0]?.id ?? "TASK-???"}):`);
-        log.blank();
-        log.info(dim("─".repeat(60)));
-        log.raw(renderScaffoldMarkdown(plan.entries[0] ?? fallbackPreviewEntry(plan.startNumber, inputs.phase)));
-        log.info(dim("─".repeat(60)));
-        return;
-    }
-    const written = await writeScaffoldFiles(plan);
-    for (const abs of written)
-        log.ok(`created   ${relDisplay(inputs.cwd, abs)}`);
-    if (written.length < plan.entries.length) {
-        const skipped = plan.entries.length - written.length;
-        log.warn(`${skipped} planned file(s) already existed and were skipped (won't overwrite).`);
-    }
-    log.blank();
-    log.info(bold("Next steps"));
-    log.info(`  1) Fill the empty sections of each scaffolded TASK file (in Cursor, via the Planner or Architect Agent).`);
-    log.info(`  2) After filling, run \`git add docs/tasks/ && git commit\`.`);
-    log.info(`  3) Start the first TASK with ${cyan(`vibeops task start ${plan.entries[0]?.id ?? "TASK-???"}`)}.`);
-}
-function fallbackPreviewEntry(start, phase) {
-    const id = formatTaskId(start);
-    return {
-        id,
-        number: start,
-        slug: "planned-task",
-        title: "(scaffolded TASK — fill in)",
-        fileName: `${id}-planned-task.md`,
-        absPath: `${id}-planned-task.md`,
-        phase: phase ?? "(unassigned)",
-    };
-}

package/dist/commands/task-pull.js

@@ -1,277 +0,0 @@
-import { resolve } from "node:path";
-import { bold, cyan, dim, gray, green, log, yellow } from "../lib/logger.js";
-import { maskToken } from "../lib/notion-env.js";
-import { notionApiError } from "../lib/notion-client.js";
-import { createNotionClient, fetchSchemas, loadSyncContext, } from "../lib/notion-sync.js";
-import { executePullEntry, planPull, } from "../lib/task-pull.js";
-function emptyReport(cwd, dryRun) {
-    return {
-        cwd,
-        ok: false,
-        dryRun,
-        tokenMasked: null,
-        notion: null,
-        filter: { projectId: "", statusNames: [], limit: 0 },
-        considered: 0,
-        entries: [],
-        skipped: [],
-        trace: [],
-        errors: [],
-    };
-}
-function parseStatusList(raw) {
-    if (typeof raw !== "string" || raw.trim().length === 0)
-        return ["Planned"];
-    return raw
-        .split(",")
-        .map((s) => s.trim())
-        .filter((s) => s.length > 0);
-}
-function parseLimit(raw) {
-    if (typeof raw === "number")
-        return raw;
-    if (typeof raw === "string" && raw.length > 0) {
-        const n = Number.parseInt(raw, 10);
-        if (Number.isFinite(n) && n > 0)
-            return n;
-    }
-    return 20;
-}
-export async function taskPullCommand(options = {}) {
-    const cwd = resolve(options.cwd ?? process.cwd());
-    const dryRun = options.dryRun === true;
-    const wantJson = options.json === true;
-    const verbose = options.verbose === true;
-    const report = emptyReport(cwd, dryRun);
-    const ctxRes = await loadSyncContext(cwd);
-    if (!ctxRes.ok) {
-        report.errors.push({ reason: ctxRes.reason, message: ctxRes.message });
-        return finalize(report, wantJson, verbose);
-    }
-    const ctx = ctxRes;
-    report.tokenMasked = maskToken(ctx.token);
-    report.notion = {
-        projectsTargetId: ctx.notion.projectsTargetId,
-        tasksTargetId: ctx.notion.tasksTargetId,
-        projectsDatabaseId: ctx.notion.projectsDatabaseId,
-        tasksDatabaseId: ctx.notion.tasksDatabaseId,
-    };
-    const statusNames = parseStatusList(options.status);
-    const limit = parseLimit(options.limit);
-    report.filter = {
-        projectId: ctx.project.projectId,
-        statusNames: [...statusNames],
-        limit,
-    };
-    let client;
-    try {
-        client = await createNotionClient(ctx.token);
-    }
-    catch (err) {
-        const apiErr = notionApiError(err);
-        report.errors.push({
-            reason: "sdk-load",
-            message: `Failed to load @notionhq/client — ${apiErr.message}`,
-            details: apiErr,
-        });
-        return finalize(report, wantJson, verbose);
-    }
-    const schemaRes = await fetchSchemas(client, ctx.notion);
-    if (!schemaRes.ok) {
-        report.errors.push({
-            reason: schemaRes.reason,
-            message: explainNotionError(schemaRes.error),
-            details: schemaRes.error,
-        });
-        return finalize(report, wantJson, verbose);
-    }
-    const violations = [
-        ...schemaRes.projects.violations,
-        ...schemaRes.tasks.violations,
-    ];
-    if (violations.length > 0) {
-        report.errors.push({
-            reason: "schema",
-            message: `Notion DB schema does not match VibeOps requirements (${violations.length} violation${violations.length === 1 ? "" : "s"}). Inspect details with \`vibeops notion test\`.`,
-            details: violations,
-        });
-        return finalize(report, wantJson, verbose);
-    }
-    let plan;
-    try {
-        plan = await planPull({
-            cwd,
-            client,
-            tasksDataSourceId: schemaRes.tasks.resolvedId,
-            projectId: ctx.project.projectId,
-            statusNames,
-            limit,
-        });
-    }
-    catch (err) {
-        const apiErr = notionApiError(err);
-        report.errors.push({
-            reason: "query",
-            message: explainNotionError(apiErr),
-            details: apiErr,
-        });
-        return finalize(report, wantJson, verbose);
-    }
-    report.considered = plan.considered;
-    for (const e of plan.entries) {
-        report.entries.push({
-            taskId: e.taskId,
-            title: e.title,
-            status: e.status,
-            mvpPhase: e.mvpPhase,
-            pageId: e.pageId,
-            docsRelativePath: e.docsRelativePath,
-            notionNeedsDocsPath: e.notionNeedsDocsPath,
-            ...(e.detail !== undefined ? { detail: e.detail } : {}),
-        });
-    }
-    for (const s of plan.skipped) {
-        report.skipped.push({
-            pageId: s.pageId,
-            taskId: s.taskId,
-            reason: s.reason,
-            docsRelativePath: s.docsRelativePath,
-            ...(s.detail !== undefined ? { detail: s.detail } : {}),
-        });
-    }
-    for (const t of plan.trace) {
-        report.trace.push({
-            taskId: t.taskId,
-            pageId: t.pageId,
-            notionDocsPath: t.notionDocsPath,
-            localResolvedPath: t.localResolvedPath,
-            decision: t.decision,
-            reason: t.reason,
-        });
-    }
-    if (dryRun) {
-        report.ok = true;
-        return finalize(report, wantJson, verbose);
-    }
-    let mutateFailed = false;
-    for (let i = 0; i < plan.entries.length; i++) {
-        const entry = plan.entries[i];
-        try {
-            const res = await executePullEntry(client, entry);
-            report.entries[i].created = true;
-            report.entries[i].notionUpdated = res.notionUpdated;
-        }
-        catch (err) {
-            mutateFailed = true;
-            const apiErr = notionApiError(err);
-            report.errors.push({
-                reason: "pull-execute",
-                message: `${entry.taskId}: ${explainNotionError(apiErr)}`,
-                details: apiErr,
-            });
-        }
-    }
-    report.ok = !mutateFailed;
-    finalize(report, wantJson, verbose);
-}
-function explainNotionError(err) {
-    const tail = err.status ? ` (HTTP ${err.status})` : "";
-    switch (err.code) {
-        case "unauthorized":
-            return `NOTION_TOKEN was rejected. Verify the integration is not expired and the value is correct.${tail}`;
-        case "restricted_resource":
-            return `The Notion DB is not shared with the integration. Add it via Notion DB → Connections.${tail}`;
-        case "object_not_found":
-            return `Notion resource not found. Verify the database id / page id.${tail}`;
-        case "validation_error":
-            return `Request rejected (validation_error): ${err.message}${tail}`;
-        case "rate_limited":
-            return `Notion API rate limit — retry shortly.${tail}`;
-        case "request_timeout":
-        case "ETIMEDOUT":
-            return `Notion API 5s timeout. Check your network.${tail}`;
-        default:
-            return `${err.code}: ${err.message}${tail}`;
-    }
-}
-function finalize(report, wantJson, verbose) {
-    if (wantJson) {
-        process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
-        process.exitCode = report.ok ? 0 : 1;
-        return;
-    }
-    log.info(bold("vibeops task pull"));
-    log.info(`  ${dim("cwd")}  ${report.cwd}${report.dryRun ? `  ${yellow("[dry-run]")}` : ""}`);
-    if (report.tokenMasked)
-        log.info(`  ${dim("token")} ${report.tokenMasked}`);
-    if (report.filter.projectId.length > 0) {
-        log.info(`  ${dim("filter")} Project ID=${cyan(report.filter.projectId)}  Status ∈ {${report.filter.statusNames
-            .map((s) => cyan(s))
-            .join(", ")}}  ${dim(`limit=${report.filter.limit}`)}`);
-    }
-    log.blank();
-    for (const e of report.errors) {
-        log.error(`${cyan(e.reason)} — ${e.message}`);
-    }
-    if (report.errors.length > 0)
-        log.blank();
-    log.info(`  ${bold("considered")} ${report.considered} rows  ${dim("→")}  ${green(`new ${report.entries.length}`)}  ${yellow(`skipped ${report.skipped.length}`)}`);
-    log.blank();
-    if (report.entries.length > 0) {
-        log.info(bold("would create"));
-        for (const e of report.entries) {
-            const tag = e.created ? green("✓") : yellow("·");
-            const sync = e.notionUpdated ? cyan(" notion.docsPath←") : "";
-            log.info(`  ${tag} ${cyan(e.taskId)} ${e.title}${gray(`  status=${e.status} phase=${e.mvpPhase}`)}${sync}`);
-            log.info(`      ${dim(e.docsRelativePath)}`);
-            if (verbose && typeof e.detail === "string" && e.detail.length > 0) {
-                for (const line of e.detail.split(/\r?\n/)) {
-                    log.info(`      ${dim(line)}`);
-                }
-            }
-        }
-        log.blank();
-    }
-    if (report.skipped.length > 0) {
-        log.info(bold("skipped"));
-        for (const s of report.skipped) {
-            log.info(`  ${yellow("·")} ${cyan(s.taskId)} ${gray(s.reason)}  ${dim(s.docsRelativePath)}`);
-            if (typeof s.detail === "string" && s.detail.length > 0) {
-                // Print the per-skip detail unconditionally — the new mismatch /
-                // duplicate-task-id branches NEED to call out the Notion docs path
-                // and the action the user should take.
-                for (const line of s.detail.split(/\r?\n/)) {
-                    log.info(`      ${dim(line)}`);
-                }
-            }
-        }
-        log.blank();
-    }
-    if (verbose && report.trace.length > 0) {
-        log.info(bold("trace"));
-        for (const t of report.trace) {
-            log.info(`  ${cyan(t.taskId)}  ${gray(t.decision)}  ${dim(`page=${t.pageId}`)}`);
-            log.info(`      ${dim(`notion docs path : ${t.notionDocsPath || "(empty)"}`)}`);
-            log.info(`      ${dim(`local resolved   : ${t.localResolvedPath || "(none)"}`)}`);
-            log.info(`      ${dim(`reason           : ${t.reason}`)}`);
-        }
-        log.blank();
-    }
-    if (report.dryRun) {
-        log.info(yellow("  dry-run — no file or Notion mutation performed."));
-    }
-    if (report.ok && report.errors.length === 0) {
-        log.ok(report.dryRun
-            ? "Pull plan OK — re-run without --dry-run to apply."
-            : `task pull complete — ${report.entries.filter((e) => e.created).length} file(s) created.`);
-        process.exitCode = 0;
-    }
-    else if (report.ok) {
-        log.warn("Some rows were skipped.");
-        process.exitCode = 0;
-    }
-    else {
-        log.error("task pull failed — see errors above.");
-        process.exitCode = 1;
-    }
-}

package/dist/commands/task-rollback.js

@@ -1,174 +0,0 @@
-import { relative, resolve } from "node:path";
-import { gitBranchExists, gitCheckout, gitDeleteBranch, gitResetHard, readGitInfo, } from "../lib/git.js";
-import { bold, cyan, dim, log, red, yellow } from "../lib/logger.js";
-import { projectPaths } from "../lib/paths.js";
-import { findTaskFile, readGitContext, readTaskFile, statusDisplay } from "../lib/task.js";
-function relOrAbs(root, p) {
-    const r = relative(root, p);
-    return r === "" ? "." : r.startsWith("..") ? p : r;
-}
-function shellQuote(s) {
-    return /^[A-Za-z0-9._/\-]+$/.test(s) ? s : `'${s.replace(/'/g, `'\\''`)}'`;
-}
-function strategyCommands(strategy, ctx) {
-    switch (strategy) {
-        case "branch-delete":
-            return [
-                `git switch ${shellQuote(ctx.baseBranch)}`,
-                `git branch -D ${shellQuote(ctx.taskBranch)}`,
-            ];
-        case "reset-base":
-            return [
-                `git switch ${shellQuote(ctx.taskBranch)}`,
-                `git reset --hard ${shellQuote(ctx.baseCommit)}`,
-            ];
-        case "revert-merge":
-            return [
-                `git switch ${shellQuote(ctx.baseBranch)}`,
-                `# find the merge commit:`,
-                `git log --oneline --merges ${shellQuote(ctx.baseBranch)} | head -5`,
-                `# then:`,
-                `git revert -m 1 <merge-sha>`,
-            ];
-    }
-}
-function strategyRisk(strategy) {
-    switch (strategy) {
-        case "branch-delete":
-            return "The task branch will be deleted along with any unmerged changes on it.";
-        case "reset-base":
-            return "Hard-reset the current branch to the base commit. Uncommitted and unpushed changes will be lost.";
-        case "revert-merge":
-            return "For already-merged-and-pushed work: adds new revert commits while keeping history. VibeOps never force-pushes.";
-    }
-}
-const STRATEGY_LIST = ["branch-delete", "reset-base", "revert-merge"];
-function isDestructive(strategy) {
-    return strategy === "reset-base";
-}
-export async function taskRollbackCommand(taskId, options = {}) {
-    const cwd = resolve(options.cwd ?? process.cwd());
-    const paths = projectPaths(cwd);
-    const taskFile = await findTaskFile(paths.docsTasks, taskId);
-    if (!taskFile) {
-        log.error(`TASK not found: ${taskId} (looked in ${relOrAbs(cwd, paths.docsTasks)})`);
-        process.exitCode = 1;
-        return;
-    }
-    const meta = await readTaskFile(taskFile);
-    const ctx = await readGitContext(taskFile);
-    const git = await readGitInfo(cwd);
-    log.info(bold(`vibeops task rollback ${meta.id}`));
-    log.info(`  ${dim("file")}    ${relOrAbs(cwd, taskFile)}`);
-    log.info(`  ${dim("status")}  ${statusDisplay(meta.status)}`);
-    if (git.isRepo) {
-        log.info(`  ${dim("branch")}  ${git.branch ?? dim("(detached)")}`);
-        log.info(`  ${dim("dirty")}   ${git.dirty ? yellow("yes") : "no"}`);
-    }
-    else {
-        log.info(`  ${red("✗")} not a git repository`);
-    }
-    log.blank();
-    if (ctx === null) {
-        log.error(`Git Context not recorded in ${relOrAbs(cwd, taskFile)}. Was \`vibeops task start ${meta.id}\` ever run?`);
-        log.info(`If you started the branch manually, add a "## Git Context" section to the TASK file with: Base Branch, Base Commit, Task Branch, Started At.`);
-        process.exitCode = 1;
-        return;
-    }
-    log.info(bold("Git Context (from TASK file)"));
-    log.info(`  ${dim("base branch")} ${ctx.baseBranch}`);
-    log.info(`  ${dim("base commit")} ${ctx.baseCommit}`);
-    log.info(`  ${dim("task branch")} ${cyan(ctx.taskBranch)}`);
-    log.info(`  ${dim("started at")}  ${ctx.startedAt}`);
-    log.blank();
-    log.info(bold("Available strategies"));
-    for (const s of STRATEGY_LIST) {
-        const destructive = isDestructive(s);
-        const tag = destructive ? red("destructive") : yellow("non-destructive");
-        log.info(`  ${bold(s)}  ${dim("·")} ${tag}`);
-        log.info(`    ${dim(strategyRisk(s))}`);
-        for (const cmd of strategyCommands(s, ctx)) {
-            if (cmd.startsWith("#")) {
-                log.info(`      ${dim(cmd)}`);
-            }
-            else {
-                log.info(`      ${dim("$")} ${cmd}`);
-            }
-        }
-        log.blank();
-    }
-    const wantConfirm = options.confirm === true || options.confirmDestructive === true;
-    if (!wantConfirm) {
-        log.info(`${yellow("!")} guidance only. add ${cyan("--confirm")} (non-destructive) or ${cyan("--confirm-destructive")} (allows hard reset) to actually run.`);
-        return;
-    }
-    const strategy = options.strategy ?? "branch-delete";
-    if (!STRATEGY_LIST.includes(strategy)) {
-        log.error(`Unknown strategy: ${strategy}. Choose from: ${STRATEGY_LIST.join(", ")}.`);
-        process.exitCode = 1;
-        return;
-    }
-    if (strategy === "revert-merge") {
-        log.info(`${yellow("!")} ${bold("revert-merge")} is never executed automatically. Run the commands above manually. ` +
-            `(VibeOps never force-pushes, regardless of flag combination.)`);
-        return;
-    }
-    if (isDestructive(strategy) && options.confirmDestructive !== true) {
-        log.error(`${strategy} is a destructive operation. --confirm alone is not enough; pass --confirm-destructive to proceed.`);
-        process.exitCode = 1;
-        return;
-    }
-    if (!git.isRepo) {
-        log.error("Cannot run rollback: not a git repository.");
-        process.exitCode = 1;
-        return;
-    }
-    if (git.dirty === true && options.confirmDestructive !== true) {
-        log.error("Working tree is dirty. Commit / stash first, or rerun with --confirm-destructive to acknowledge the risk.");
-        process.exitCode = 1;
-        return;
-    }
-    if (options.dryRun === true) {
-        log.info(bold(`dry-run — would run for strategy=${strategy}:`));
-        for (const cmd of strategyCommands(strategy, ctx)) {
-            if (cmd.startsWith("#"))
-                continue;
-            log.info(`  ${dim("$")} ${cmd}`);
-        }
-        log.blank();
-        log.info(dim("no git command was executed."));
-        return;
-    }
-    if (strategy === "branch-delete") {
-        if (git.branch === ctx.taskBranch) {
-            log.info(`switching off ${ctx.taskBranch} → ${ctx.baseBranch}`);
-            await gitCheckout(cwd, ctx.baseBranch);
-        }
-        if (!(await gitBranchExists(cwd, ctx.taskBranch))) {
-            log.warn(`task branch already absent: ${ctx.taskBranch}`);
-        }
-        else {
-            if (options.keepBranch === true) {
-                log.info(`--keep-branch given → leaving ${ctx.taskBranch} intact.`);
-            }
-            else {
-                await gitDeleteBranch(cwd, ctx.taskBranch, { force: true });
-                log.ok(`deleted branch: ${ctx.taskBranch}`);
-            }
-        }
-        log.blank();
-        log.info(`Done. Current branch: ${cyan(ctx.baseBranch)}. TASK file Status is unchanged on purpose — edit it manually if needed.`);
-        return;
-    }
-    if (strategy === "reset-base") {
-        if (git.branch !== ctx.taskBranch) {
-            log.info(`switching to ${ctx.taskBranch}`);
-            await gitCheckout(cwd, ctx.taskBranch);
-        }
-        await gitResetHard(cwd, ctx.baseCommit);
-        log.ok(`hard reset ${ctx.taskBranch} → ${ctx.baseCommit}`);
-        log.blank();
-        log.info(`Done. Branch ${cyan(ctx.taskBranch)} now points at ${ctx.baseCommit}. TASK file Status is unchanged on purpose.`);
-        return;
-    }
-}