@goodtek/vibeops 0.7.22 → 1.1.1

package/dist/lib/task-generator.js

@@ -1,183 +0,0 @@
-export const TASK_GENERATE_SCHEMA_VERSION = 1;
-export const REQUIRED_TASK_SECTIONS = [
-    "Status",
-    "MVP Phase",
-    "Goal",
-    "Background",
-    "Scope",
-    "Out of Scope",
-    "Acceptance Criteria",
-    "Files to Inspect First",
-    "Expected Files to Change",
-    "Risks",
-    "Test Plan",
-    "Rollback Plan",
-    "Git Context",
-    "Notion Page",
-    "Implementation Plan",
-    "Result",
-    "Test Result",
-    "Review Notes",
-];
-/**
- * Convert an arbitrary string to a TASK-filename slug.
- * - lowercase
- * - ASCII-only (non-ASCII letters dropped)
- * - non-alphanum collapsed to `-`
- * - leading/trailing `-` removed, repeated `-` compressed
- * - empty result → `task`
- */
-export function slugify(input, fallback = "task") {
-    const cleaned = input
-        .toLowerCase()
-        .normalize("NFKD")
-        .replace(/[\u0300-\u036f]/g, "")
-        .replace(/[^a-z0-9]+/g, "-")
-        .replace(/^-+|-+$/g, "")
-        .replace(/-+/g, "-");
-    return cleaned.length > 0 ? cleaned : fallback;
-}
-function header(inputs) {
-    const lines = [];
-    lines.push("# VibeOps Task-Generation Prompt — Cursor Planner Agent");
-    lines.push("");
-    lines.push("> This file was produced by `vibeops task generate`. Open a new chat in **Cursor** and paste the full contents of this file. VibeOps does not call LLM, Cursor CLI, Notion, or GitHub APIs directly — the **Planner Agent** receiving this prompt creates the `docs/tasks/TASK-*.md` files.");
-    lines.push("");
-    lines.push(`- VibeOps version: ${inputs.vibeopsVersion}`);
-    lines.push(`- Generated: ${inputs.generatedAt}`);
-    lines.push(`- Generated by: \`vibeops task generate\``);
-    lines.push(`- Prompt location: \`${inputs.outputRelative}\``);
-    lines.push(`- Schema version: ${TASK_GENERATE_SCHEMA_VERSION}`);
-    lines.push("");
-    return lines.join("\n");
-}
-function role() {
-    return `## Role: Planner Agent
-
-Follow the definition in \`.vibeops/agents/planner.md\` if it is installed. You **do not write application code**. You produce \`docs/tasks/TASK-NNN-slug.md\` files. Each TASK must be small enough for a single Builder Agent to finish in one Cursor session.`;
-}
-function hardRules() {
-    return `## Hard rules (failure if violated)
-
-- Never produce application code (\`src/**\`, \`lib/**\`, \`app/**\`, tests, build scripts, etc.). The deliverable for this round is \`docs/tasks/TASK-NNN-slug.md\` files only.
-- Do not touch VibeOps' own config (\`.vibeops/\`, \`.vibeops.json\`, \`templates/\`).
-- Never call LLM APIs, Cursor CLI, Notion APIs, or GitHub APIs directly. You only produce markdown.
-- Source-of-truth rules:
-  - **\`docs/tasks/*.md\` = AI execution source of truth** (Builder/Reviewer/Tester agents only read these files).
-  - **\`docs/project/*.md\` = design + current-state baseline** (the input the Planner reads for this round).
-  - **Git commits/branches = change history**.
-  - **Notion = human dashboard** (exposes summary / status / priority / docs path only — never execution details).
-  - Do not trust chat memory.
-- One TASK, one focus. Surface inter-TASK dependencies in the body (e.g. "TASK-014 depends on TASK-013").
-- Never hide assumptions. Record them in the closing "Assumptions" section of the response.`;
-}
-function inventoryRow(slot) {
-    const flag = slot.content === null ? "·" : "✓";
-    const note = slot.content === null ? " _(missing)_" : "";
-    const primaryTag = slot.primary ? " **(primary)**" : "";
-    return `- [${flag}] \`${slot.relativePath}\` — ${slot.label}${primaryTag}${note}`;
-}
-function inventory(docs) {
-    const lines = ["## Input documents (for this round)"];
-    lines.push("");
-    if (docs.from)
-        lines.push(inventoryRow(docs.from));
-    for (const slot of docs.slots)
-        lines.push(inventoryRow(slot));
-    lines.push(inventoryRow(docs.brief));
-    lines.push("");
-    lines.push("> `[✓]` = file read from disk. `[·]` = missing or empty slot — its content is not inlined below. Do not over-guess for missing slots; record them in \"Assumptions\".");
-    return lines.join("\n");
-}
-function objective(inputs) {
-    const lines = ["## Objective"];
-    lines.push("");
-    lines.push(`Read the inputs above and produce roughly **${inputs.count} new TASK files**. The first TASK number is \`${inputs.nextTaskId}\` (the next number after the highest existing \`docs/tasks/TASK-*.md\`). Skip any number that already exists on disk.`);
-    if (typeof inputs.phase === "string" && inputs.phase.length > 0) {
-        lines.push("");
-        lines.push(`- **Phase filter**: this round only produces TASKs whose phase is \`${inputs.phase}\`. Even if you see work for other phases, leave it for a separate round.`);
-    }
-    if (inputs.countWarning) {
-        lines.push("");
-        lines.push(`- ⚠️ A recommended count of ${inputs.count} is on the high side. Make sure each TASK really does fit a single Cursor session, and lower the count if anything is vague.`);
-    }
-    lines.push("");
-    lines.push("Each TASK must satisfy:");
-    lines.push("");
-    lines.push("- **Small, verifiable scope**. One Builder finishes it in one Cursor session.");
-    lines.push("- **Self-contained**. A reader can determine the files to change and the Acceptance Criteria from the TASK body alone.");
-    lines.push("- **Explicit dependencies**. If TASK depends on another, write \"depends on TASK-NNN\" in Background.");
-    return lines.join("\n");
-}
-function fileFormat(inputs) {
-    const sections = REQUIRED_TASK_SECTIONS.map((s) => `   - \`## ${s}\``).join("\n");
-    return `## Output format
-
-Produce the response in this exact order:
-
-1. **Plan summary** — 5 to 8 bullets. Priorities / decomposition derived from the inputs.
-2. **TASK files** — each in its own fenced code block. The first line of each block must be \`<!-- file: docs/tasks/TASK-NNN-slug.md -->\` (an HTML comment) marking the path. Numbers increase sequentially from \`${inputs.nextTaskId}\`. Slugs are lowercase / ASCII / hyphen-separated (e.g. \`docs-and-readme\`).
-3. **Changed file list** — every \`docs/tasks/TASK-NNN-*.md\` path produced above.
-4. **Generated TASK summary** — table or bullet list: \`TASK-NNN · title · MVP Phase · one-line summary\`.
-5. **Assumptions** — items a human needs to reconfirm (use \`(none)\` if there are none).
-
-### Required sections per TASK file (same order, same heading text)
-
-Each TASK markdown begins with \`# ${inputs.nextTaskId} · <one-line title>\` and includes **all** of the following \`##\` sections:
-
-${sections}
-
-Additional rules:
-
-- The body of \`## Status\` is the single word \`planned\`.
-- The body of \`## MVP Phase\` follows \`${typeof inputs.phase === "string" && inputs.phase.length > 0 ? inputs.phase : "MVP <n> · <phase name>"}\` (or \`(unassigned)\` when unknown).
-- The body of \`## Git Context\` is \`(populated by \\\`vibeops task start TASK-NNN\\\`)\`.
-- The body of \`## Notion Page\` is \`(populated by \\\`vibeops notion sync\\\`)\`.
-- The body of \`## Result\` / \`## Test Result\` / \`## Review Notes\` is \`(not yet)\`.`;
-}
-function workflowReminders() {
-    return `## Workflow reminders
-
-- **VibeOps source of truth = \`docs/tasks/\` + \`docs/project/\` + Git.** Notion is a human dashboard and is never used for AI execution.
-- Once produced, each TASK must be ready for \`vibeops task start TASK-NNN\`. Keep slugs clean and numbers conflict-free.
-- Never produce application code — a separate Builder Agent does that in a different round.
-- Separate ambiguity into \`Risks\` (known unknowns) and \`Assumptions\` (need confirmation).`;
-}
-function fileSection(doc, fenceLang = "") {
-    if (doc.content === null) {
-        return `### \`${doc.relativePath}\` _(missing)_\n\n_(file not found — the Planner Agent must record this in Assumptions.)_`;
-    }
-    const fence = "```";
-    const lang = fenceLang.length > 0 ? fenceLang : "markdown";
-    return `### \`${doc.relativePath}\`\n\n${fence}${lang}\n${doc.content.trimEnd()}\n${fence}`;
-}
-function inlineInputs(docs) {
-    const parts = ["## Inline inputs"];
-    parts.push("");
-    parts.push("The code blocks below are the on-disk snapshot at prompt generation time. Cursor may open additional context, but **start from these**.");
-    parts.push("");
-    if (docs.from)
-        parts.push(fileSection(docs.from));
-    for (const slot of docs.slots)
-        parts.push(fileSection(slot));
-    parts.push(fileSection(docs.brief));
-    return parts.join("\n\n");
-}
-function footer() {
-    return `---
-
-Apply the rules above and produce the response. After you respond, a human reviews the generated \`docs/tasks/TASK-*.md\` files via \`git diff\` and commits them, then starts the first TASK with \`vibeops task start TASK-NNN\`.`;
-}
-export function buildTaskGeneratePrompt(inputs) {
-    return [
-        header(inputs),
-        role(),
-        hardRules(),
-        inventory(inputs.docs),
-        objective(inputs),
-        fileFormat(inputs),
-        workflowReminders(),
-        inlineInputs(inputs.docs),
-        footer(),
-    ].join("\n\n");
-}

package/dist/lib/task-merge.js

@@ -1,220 +0,0 @@
-import { ghAuthStatus, runGh } from "./github-cli.js";
-import { gitBranchExists, gitCheckout, gitCommitsAhead, gitDeleteBranch, gitGovernanceOnlyDirty, gitRemoteUrl, readGitInfo, runGit, } from "./git.js";
-import { bold, cyan, dim, log } from "./logger.js";
-function mergeCommitMessage(taskId, taskTitle, taskBranch) {
-    const slug = taskTitle.replace(/^TASK-\d+\s*[·:\-]\s*/i, "").trim() || taskId;
-    return `merge(${taskId.toLowerCase()}): ${slug} (${taskBranch})`;
-}
-function prTitle(taskId, taskTitle) {
-    const slug = taskTitle.replace(/^TASK-\d+\s*[·:\-]\s*/i, "").trim() || taskId;
-    return `feat(${taskId.toLowerCase()}): ${slug}`;
-}
-async function gitPush(cwd, remote, ref, setUpstream) {
-    const args = ["push"];
-    if (setUpstream)
-        args.push("-u");
-    args.push(remote, ref);
-    await runGit(cwd, args);
-}
-async function findOpenPrNumber(baseBranch, headBranch) {
-    const res = await runGh([
-        "pr",
-        "list",
-        "--head",
-        headBranch,
-        "--base",
-        baseBranch,
-        "--state",
-        "open",
-        "--json",
-        "number,url",
-        "--limit",
-        "1",
-    ]);
-    if (!res.ok)
-        return null;
-    try {
-        const rows = JSON.parse(res.stdout);
-        const row = rows[0];
-        if (row && typeof row.number === "number") {
-            return { number: row.number, url: row.url };
-        }
-    }
-    catch {
-        return null;
-    }
-    return null;
-}
-export async function mergeTaskBranch(opts) {
-    const mode = opts.mode ?? "direct";
-    const remote = opts.remote ?? "origin";
-    const { cwd, gitCtx, taskId, taskTitle } = opts;
-    const { baseBranch, taskBranch } = gitCtx;
-    if (baseBranch === taskBranch) {
-        log.error("Task branch matches base branch; nothing to merge.");
-        return { ok: false, mode };
-    }
-    const git = await readGitInfo(cwd);
-    if (!git.isRepo) {
-        log.error("Not a git repository.");
-        return { ok: false, mode };
-    }
-    const remoteUrl = await gitRemoteUrl(cwd, remote);
-    if (!remoteUrl) {
-        log.error(`No git remote "${remote}". Run ${cyan("vibeops github init")} or add the remote first.`);
-        return { ok: false, mode };
-    }
-    const branchExists = await gitBranchExists(cwd, taskBranch);
-    if (!branchExists) {
-        log.error(`Local task branch not found: ${taskBranch}`);
-        return { ok: false, mode };
-    }
-    const ahead = await gitCommitsAhead(cwd, baseBranch, taskBranch);
-    if (ahead === 0) {
-        log.warn(`No commits on ${taskBranch} ahead of ${baseBranch}. Merge may be a no-op.`);
-    }
-    const planLines = [
-        `push ${remote} ${taskBranch}`,
-        mode === "direct"
-            ? `checkout ${baseBranch} · pull · merge --no-ff ${taskBranch} · push ${remote} ${baseBranch}`
-            : `gh pr create (if needed) · gh pr merge --merge --delete-branch`,
-        `delete local branch ${taskBranch}`,
-        mode === "direct" ? `delete remote branch ${remote}/${taskBranch}` : "(remote branch removed by gh if supported)",
-    ];
-    if (opts.dryRun === true) {
-        log.info(bold("dry-run — would perform:"));
-        for (const line of planLines) {
-            log.info(`  · ${line}`);
-        }
-        return { ok: true, mode };
-    }
-    log.step(bold(`Merging ${cyan(taskBranch)} → ${cyan(baseBranch)} (${mode})`));
-    try {
-        log.step(`Pushing ${taskBranch} to ${remote}…`);
-        await gitPush(cwd, remote, taskBranch, true);
-        log.ok(`pushed ${taskBranch}`);
-    }
-    catch (e) {
-        const msg = e instanceof Error ? e.message : String(e);
-        log.error(`git push failed: ${msg}`);
-        return { ok: false, mode };
-    }
-    if (mode === "pr") {
-        const auth = await ghAuthStatus();
-        if (!auth.authenticated) {
-            log.error(`gh is not authenticated. Run ${cyan("gh auth login")} or use direct merge (default).`);
-            return { ok: false, mode };
-        }
-        let pr = await findOpenPrNumber(baseBranch, taskBranch);
-        if (!pr) {
-            log.step("Opening pull request…");
-            const create = await runGh([
-                "pr",
-                "create",
-                "--base",
-                baseBranch,
-                "--head",
-                taskBranch,
-                "--title",
-                prTitle(taskId, taskTitle),
-                "--body",
-                `Automated via vibeops next for ${taskId}.`,
-            ]);
-            if (!create.ok) {
-                log.error(`gh pr create failed: ${create.stderr.trim() || create.stdout.trim()}`);
-                return { ok: false, mode };
-            }
-            const url = create.stdout.trim();
-            log.ok(`PR created${url.length > 0 ? `: ${url}` : ""}`);
-            pr = await findOpenPrNumber(baseBranch, taskBranch);
-        }
-        else {
-            log.ok(`Using existing PR #${pr.number}`);
-        }
-        if (!pr) {
-            log.error("Could not find PR number after create.");
-            return { ok: false, mode };
-        }
-        log.step(`Merging PR #${pr.number}…`);
-        const merged = await runGh([
-            "pr",
-            "merge",
-            String(pr.number),
-            "--merge",
-            "--delete-branch",
-        ]);
-        if (!merged.ok) {
-            log.error(`gh pr merge failed: ${merged.stderr.trim() || merged.stdout.trim()}`);
-            return { ok: false, mode };
-        }
-        log.ok(`PR #${pr.number} merged`);
-        try {
-            await gitCheckout(cwd, baseBranch);
-            await runGit(cwd, ["pull", remote, baseBranch]);
-        }
-        catch {
-            log.warn(`Run manually: git switch ${baseBranch} && git pull ${remote} ${baseBranch}`);
-        }
-        if (await gitBranchExists(cwd, taskBranch)) {
-            try {
-                await gitDeleteBranch(cwd, taskBranch, { force: true });
-                log.ok(`deleted local branch ${taskBranch}`);
-            }
-            catch {
-                log.warn(`Could not delete local branch ${taskBranch}.`);
-            }
-        }
-        return { ok: true, mode, prUrl: pr.url };
-    }
-    // direct merge
-    if (git.dirty === true && opts.allowDirty !== true) {
-        const gov = await gitGovernanceOnlyDirty(cwd);
-        if (!gov.onlyGovernance) {
-            log.error("Working tree is dirty. Commit or stash before merging, or rerun with --allow-dirty.");
-            return { ok: false, mode };
-        }
-        log.warn("Dirty tree has only governance docs — proceeding.");
-    }
-    try {
-        await runGit(cwd, ["fetch", remote]);
-        await gitCheckout(cwd, baseBranch);
-        await runGit(cwd, ["pull", remote, baseBranch]);
-        log.step(`Merging ${taskBranch} into ${baseBranch}…`);
-        await runGit(cwd, [
-            "merge",
-            "--no-ff",
-            taskBranch,
-            "-m",
-            mergeCommitMessage(taskId, taskTitle, taskBranch),
-        ]);
-        await gitPush(cwd, remote, baseBranch, false);
-        log.ok(`merged and pushed ${baseBranch}`);
-    }
-    catch (e) {
-        const msg = e instanceof Error ? e.message : String(e);
-        log.error(`merge failed: ${msg}`);
-        log.info(dim(`  Resolve conflicts on ${baseBranch}, then commit and push manually.`));
-        return { ok: false, mode };
-    }
-    try {
-        await gitDeleteBranch(cwd, taskBranch, { force: false });
-        log.ok(`deleted local branch ${taskBranch}`);
-    }
-    catch {
-        try {
-            await gitDeleteBranch(cwd, taskBranch, { force: true });
-            log.ok(`deleted local branch ${taskBranch} (force)`);
-        }
-        catch {
-            log.warn(`Could not delete local branch ${taskBranch}.`);
-        }
-    }
-    try {
-        await runGit(cwd, ["push", remote, "--delete", taskBranch]);
-        log.ok(`deleted remote branch ${remote}/${taskBranch}`);
-    }
-    catch {
-        log.warn(dim(`Remote branch may already be gone. To remove: git push ${remote} --delete ${taskBranch}`));
-    }
-    return { ok: true, mode };
-}

package/dist/lib/task-prompt.js

@@ -1,23 +0,0 @@
-import { findAgent, listAgents } from "../agent/loader.js";
-import { buildPrompt } from "../agent/prompt.js";
-import { readConfig } from "./config.js";
-import { readText } from "./filesystem.js";
-import { readTaskFile } from "./task.js";
-export async function buildTaskPromptString(inputs) {
-    const agent = await findAgent(inputs.agentsDir, inputs.agentName);
-    if (!agent) {
-        const available = (await listAgents(inputs.agentsDir)).map((a) => a.meta.name);
-        return { ok: false, reason: "agent-not-found", available };
-    }
-    const config = await readConfig(inputs.projectRoot);
-    const meta = await readTaskFile(inputs.taskFilePath);
-    const body = await readText(inputs.taskFilePath);
-    const prompt = await buildPrompt({
-        agent,
-        config,
-        task: { meta, body },
-        projectRoot: inputs.projectRoot,
-        contextPaths: inputs.contextPaths ?? [],
-    });
-    return { ok: true, prompt };
-}