@goodtek/vibeops 0.7.22 → 1.0.0

package/dist/lib/mvp-artifacts.js

@@ -1,204 +0,0 @@
-import { readdir } from "node:fs/promises";
-import { basename, join } from "node:path";
-import { isDirectory, pathExists, writeText } from "./filesystem.js";
-import { MVP_BUILD_PROMPT_REL, TASK_MVP_ID } from "./mvp-constants.js";
-import { excerptDoneSummary, readLastDoneSummary, renderPriorIterationSection, } from "./mvp-done-summary.js";
-import { projectPaths } from "./paths.js";
-import { slugify } from "./slug.js";
-function bulletList(items, empty = "(none listed in brief)") {
-    if (items.length === 0)
-        return `- ${empty}`;
-    return items.map((x) => `- ${x}`).join("\n");
-}
-export function renderMvpTaskMarkdown(bundle, priorSummary) {
-    const { brief } = bundle;
-    const title = `MVP — ${brief.projectName}`;
-    const priorBlock = typeof priorSummary === "string" && priorSummary.trim().length > 0
-        ? `${renderPriorIterationSection(excerptDoneSummary(priorSummary, 55))}\n`
-        : "";
-    const criteria = brief.successCriteria.trim().length > 0
-        ? `1. ${brief.successCriteria.trim()}`
-        : "1. The MVP delivers the scoped features below and matches the success criteria in `docs/project/02-mvp-scope.md` after `vibeops plan`.";
-    const featureCriteria = brief.mvpFeatures
-        .slice(0, 8)
-        .map((f, i) => `${i + 2}. ${f} is implemented and verifiable.`)
-        .join("\n");
-    return `# ${TASK_MVP_ID} · ${title}
-
-> Single MVP TASK for the v2 workflow. Implementation happens in **Cursor** using \`${MVP_BUILD_PROMPT_REL}\` (drag into chat). Git rails: \`vibeops start\` → build → \`vibeops done\`.
-
-## Status
-
-planned
-
-## MVP Phase
-
-MVP (full scope)
-
-## Goal
-
-Ship the **entire MVP** for **${brief.projectName}**: ${brief.oneLineIdea}
-
-## Background
-
-Generated from \`vibeops plan\` (${bundle.meta.source}). Tech: ${brief.frontend} / ${brief.backend} / ${brief.database} (${brief.dbLayer}), package manager ${brief.packageManager}.
-
-${priorBlock}## Scope
-
-${bulletList(brief.mvpFeatures, "(add MVP features in the brief)")}
-
-## Out of Scope
-
-${bulletList(brief.outOfScope)}
-
-## Acceptance Criteria
-
-${criteria}
-${featureCriteria.length > 0 ? featureCriteria : ""}
-
-## Files to Inspect First
-
-- \`AGENTS.md\`
-- \`docs/project/05-current-state.md\` (or \`03-current-state.md\` if present)
-- \`docs/project/02-mvp-scope.md\`
-- \`docs/project/03-architecture.md\`
-- \`${MVP_BUILD_PROMPT_REL}\`
-
-## Expected Files to Change
-
-- (application code and config as required by the MVP — list concrete paths as you implement)
-
-## Risks
-
-${bulletList(brief.risks)}
-
-## Test Plan
-
-- Run the project's test/lint scripts if present (\`pnpm test\`, \`pnpm lint\`, etc.).
-- Manually verify each Acceptance Criterion in Cursor or the running app.
-- Record commands and outcomes in **Test Result** before \`vibeops done\`.
-
-## Rollback Plan
-
-- \`vibeops task rollback ${TASK_MVP_ID}\` for guidance; destructive steps require \`--confirm\`.
-- Or delete branch \`task/mvp-*\` after switching to the base branch.
-
-## Git Context
-
-(populated by \`vibeops start\` or \`vibeops task start ${TASK_MVP_ID}\`)
-
-## Notion Page
-
-(optional — \`vibeops notion sync\` when Notion is enabled)
-
-## Implementation Plan
-
-1. \`vibeops start\` (creates \`task/mvp-*\` branch).
-2. Drag \`${MVP_BUILD_PROMPT_REL}\` into a **new Cursor chat** and implement until Acceptance Criteria pass.
-3. Fill **Result** and **Test Result**, then \`vibeops done\`.
-
-## Result
-
-(not yet)
-
-## Test Result
-
-(not yet)
-
-## Review Notes
-
-(not yet)
-`;
-}
-export function buildMvpBuildPrompt(bundle, taskRelativePath, priorSummary) {
-    const { brief } = bundle;
-    const priorSection = typeof priorSummary === "string" && priorSummary.trim().length > 0
-        ? `\n## Previous iteration (read first)\n\n${excerptDoneSummary(priorSummary, 80)}\n\n---\n`
-        : "";
-    return `# MVP build — ${brief.projectName}
-${priorSection}
-
-You are the **lead implementer** in Cursor for this repository. Deliver the **full MVP** in one focused effort. VibeOps owns Git/docs rails; **you** own code and verification.
-
-## Source of truth (read first)
-
-1. \`AGENTS.md\` and \`.cursor/rules/\`
-2. \`docs/project/05-current-state.md\` (or \`03-current-state.md\`)
-3. \`docs/project/02-mvp-scope.md\`, \`03-architecture.md\`, \`04-tech-stack.md\`
-4. TASK file: \`${taskRelativePath}\` — **only** work within its Scope / Acceptance Criteria
-
-## Project brief
-
-- **Idea:** ${brief.oneLineIdea}
-- **Type:** ${brief.projectType}
-- **Users:** ${brief.targetUsers.join(", ") || "(see brief)"}
-- **Problem:** ${brief.coreProblem}
-- **Stack:** ${brief.frontend} · ${brief.backend} · ${brief.database} · ${brief.dbLayer} · ${brief.packageManager}
-- **Deploy:** ${brief.deploymentTargets.join(", ") || "TBD"}
-- **Auth:** ${brief.authRequirements.join(", ") || "none"}
-- **Integrations (MVP):** ${brief.integrations.join(", ") || "none"}
-- **Success:** ${brief.successCriteria}
-
-### MVP features (in scope)
-
-${bulletList(brief.mvpFeatures)}
-
-### Explicitly out of scope
-
-${bulletList(brief.outOfScope)}
-
-## How to work (orchestration — in this chat, not via CLI)
-
-- Implement **one TASK only**: \`${TASK_MVP_ID}\`. Do not start other TASK ids unless the human asks.
-- **Search** the repo before adding files; reuse existing patterns.
-- You may delegate focused sub-steps with Cursor's **Task** tool (explore, shell) — max **3** attempts per sub-problem, then stop and report blockers.
-- Do **not** rely on \`vibeops agent prompt\` paste loops or multi-TASK \`task generate\` for this MVP pass.
-- No features outside \`docs/project/02-mvp-scope.md\` unless the human expands scope in Git docs first.
-
-## Definition of done
-
-1. Every item in **Acceptance Criteria** in \`${taskRelativePath}\` is met.
-2. **Result** and **Test Result** sections in that TASK file are filled with facts (paths, commands, outcomes).
-3. Working tree is ready for \`vibeops done\` (commit on the task branch if needed).
-
-## Risks to watch
-
-${bulletList(brief.risks)}
-
----
-
-*Generated by \`vibeops plan\`. Re-run plan to refresh after brief changes.*
-`;
-}
-export async function findMvpTaskFile(tasksDir) {
-    if (!(await isDirectory(tasksDir)))
-        return null;
-    const entries = await readdir(tasksDir, { withFileTypes: true });
-    const match = entries
-        .filter((e) => e.isFile() && /^TASK-mvp/i.test(e.name) && e.name.endsWith(".md"))
-        .map((e) => join(tasksDir, e.name))
-        .sort();
-    return match[0] ?? null;
-}
-export async function writeMvpArtifacts(cwd, bundle) {
-    const paths = projectPaths(cwd);
-    const priorSummary = await readLastDoneSummary(cwd);
-    const slug = slugify(bundle.brief.projectName, "mvp");
-    const fileName = `TASK-mvp-${slug}.md`;
-    const taskFile = join(paths.docsTasks, fileName);
-    const existing = await findMvpTaskFile(paths.docsTasks);
-    const targetTask = existing !== null && basename(existing) !== fileName ? existing : taskFile;
-    await writeText(targetTask, renderMvpTaskMarkdown(bundle, priorSummary));
-    const buildPromptFile = join(cwd, MVP_BUILD_PROMPT_REL);
-    const taskRelative = targetTask.startsWith(cwd) ? targetTask.slice(cwd.length + 1) : targetTask;
-    await writeText(buildPromptFile, buildMvpBuildPrompt(bundle, taskRelative, priorSummary));
-    return {
-        taskFile: targetTask,
-        taskRelative,
-        buildPromptFile,
-        buildPromptRelative: MVP_BUILD_PROMPT_REL,
-    };
-}
-export async function mvpBuildPromptExists(cwd) {
-    return pathExists(join(cwd, MVP_BUILD_PROMPT_REL));
-}

package/dist/lib/mvp-constants.js

@@ -1,15 +0,0 @@
-/** Fixed id for the single MVP build TASK (v2 workflow). */
-export const TASK_MVP_ID = "TASK-mvp";
-export const MVP_BUILD_PROMPT_REL = ".vibeops/generated/mvp-build.md";
-export const NEXT_TASK_SUGGESTION_REL = ".vibeops/generated/next-task-suggestion.md";
-/** CLI aliases → canonical TASK id */
-export function resolveTaskRef(ref) {
-    if (ref === undefined || ref.trim().length === 0)
-        return TASK_MVP_ID;
-    const t = ref.trim();
-    if (/^mvp$/i.test(t))
-        return TASK_MVP_ID;
-    if (/^task-mvp$/i.test(t))
-        return TASK_MVP_ID;
-    return t.toUpperCase().startsWith("TASK-") ? t : `TASK-${t}`;
-}

package/dist/lib/mvp-diff-summary.js

@@ -1,43 +0,0 @@
-import { readGitContext } from "./task.js";
-import { runGit } from "./git.js";
-export async function summarizeTaskDiff(cwd, taskFile) {
-    const ctx = await readGitContext(taskFile);
-    if (ctx === null || ctx.baseCommit.length === 0)
-        return null;
-    const range = `${ctx.baseCommit}..HEAD`;
-    const lines = [
-        `Git range: \`${range}\` (base \`${ctx.baseBranch}\` → branch \`${ctx.taskBranch}\`)`,
-        "",
-    ];
-    try {
-        const log = await runGit(cwd, ["log", "--oneline", range]);
-        const commits = log.stdout.trim().split("\n").filter((l) => l.length > 0);
-        lines.push("### Commits");
-        if (commits.length === 0) {
-            lines.push("(no commits on task branch since start)");
-        }
-        else {
-            for (const c of commits.slice(0, 30))
-                lines.push(`- ${c}`);
-            if (commits.length > 30)
-                lines.push(`- … and ${commits.length - 30} more`);
-        }
-        lines.push("");
-    }
-    catch {
-        lines.push("### Commits");
-        lines.push("(could not read git log)");
-        lines.push("");
-    }
-    try {
-        const stat = await runGit(cwd, ["diff", "--stat", range]);
-        lines.push("### Diff stat");
-        const body = stat.stdout.trim();
-        lines.push(body.length > 0 ? "```\n" + body + "\n```" : "(no file changes vs base commit)");
-    }
-    catch {
-        lines.push("### Diff stat");
-        lines.push("(could not read git diff)");
-    }
-    return lines.join("\n");
-}

package/dist/lib/mvp-done-summary.js

@@ -1,335 +0,0 @@
-import { mkdir } from "node:fs/promises";
-import { join, relative } from "node:path";
-import { isDirectory, pathExists, readText, readTextOrNull, writeText } from "./filesystem.js";
-import { runGit } from "./git.js";
-import { llmCompleteJson, llmCompleteText, resolveAvailableLlmProvider } from "./llm-complete.js";
-import { cyan, dim, log } from "./logger.js";
-import { summarizeTaskDiff } from "./mvp-diff-summary.js";
-import { findAcceptanceCriteria, hasNonEmptySection, readGitContext, readSection, updateTaskSection, } from "./task.js";
-export const LAST_DONE_SUMMARY_REL = ".vibeops/generated/last-done-summary.md";
-export const DONE_SUMMARIES_DIR = ".vibeops/generated/done-summaries";
-const MAX_PATCH_CHARS = 48_000;
-function rel(cwd, abs) {
-    const r = relative(cwd, abs);
-    return r.length === 0 ? "." : r.startsWith("..") ? abs : r;
-}
-async function gitNameStatus(cwd, range) {
-    try {
-        const res = await runGit(cwd, ["diff", "--name-status", range]);
-        const body = res.stdout.trim();
-        return body.length > 0 ? body : "(no changed files in range)";
-    }
-    catch {
-        return "(could not read name-status)";
-    }
-}
-async function gitPatchExcerpt(cwd, range) {
-    try {
-        const res = await runGit(cwd, ["diff", "--no-color", range]);
-        let patch = res.stdout;
-        if (patch.length > MAX_PATCH_CHARS) {
-            patch =
-                patch.slice(0, MAX_PATCH_CHARS) +
-                    `\n\n… (patch truncated at ${MAX_PATCH_CHARS} characters)\n`;
-        }
-        return patch.length > 0 ? patch : "(empty patch)";
-    }
-    catch {
-        return "(could not read patch)";
-    }
-}
-async function llmTaskSections(cwd, inputs) {
-    try {
-        const { text: raw, provider } = await llmCompleteJson([
-            {
-                role: "system",
-                content: "You complete a TASK file after implementation. Reply JSON only: result (markdown, what shipped + key paths), testResult (markdown, commands run and outcomes). Be factual; use bullet lists.",
-            },
-            {
-                role: "user",
-                content: [
-                    `TASK: ${inputs.taskId} — ${inputs.taskTitle}`,
-                    "",
-                    "## Acceptance criteria",
-                    inputs.acceptanceCriteria.length > 0
-                        ? inputs.acceptanceCriteria.map((c, i) => `${i + 1}. ${c}`).join("\n")
-                        : "(none listed)",
-                    "",
-                    "## Test plan (from TASK)",
-                    inputs.testPlan.length > 0 ? inputs.testPlan : "(none listed)",
-                    "",
-                    "## Git",
-                    inputs.gitBlock,
-                    "",
-                    "## Files changed",
-                    "```\n" + inputs.nameStatus + "\n```",
-                ].join("\n"),
-            },
-        ], { cwd });
-        const parsed = JSON.parse(raw);
-        const result = String(parsed.result ?? "").trim();
-        const testResult = String(parsed.testResult ?? "").trim();
-        if (result.length === 0 || testResult.length === 0)
-            return null;
-        return { result, testResult, provider };
-    }
-    catch {
-        return null;
-    }
-}
-async function llmChangeNarrative(cwd, inputs) {
-    try {
-        const { text } = await llmCompleteText([
-            {
-                role: "system",
-                content: "You summarize a completed software TASK for the next iteration. Write concise markdown: ## What shipped (bullets), ## Key files, ## Notes for next TASK. No fluff.",
-            },
-            {
-                role: "user",
-                content: [
-                    `TASK: ${inputs.taskId} — ${inputs.taskTitle}`,
-                    "",
-                    "## Result",
-                    inputs.result,
-                    "",
-                    "## Test Result",
-                    inputs.testResult,
-                    "",
-                    inputs.gitBlock,
-                    "",
-                    "## Files changed",
-                    "```\n" + inputs.nameStatus + "\n```",
-                ].join("\n"),
-            },
-        ], { cwd });
-        return text;
-    }
-    catch {
-        return null;
-    }
-}
-function fallbackTaskSections(inputs) {
-    const criteriaLines = inputs.acceptanceCriteria.length > 0
-        ? inputs.acceptanceCriteria.map((c, i) => `- [ ] ${i + 1}. ${c}`).join("\n")
-        : "- [ ] Review Acceptance Criteria in the TASK file.";
-    const result = [
-        `_Auto-generated by vibeops done at ${inputs.completedAt}._`,
-        "",
-        "## What changed",
-        "",
-        inputs.gitBlock,
-        "",
-        "## Files touched",
-        "",
-        "```",
-        inputs.nameStatus,
-        "```",
-    ].join("\n");
-    const testResult = [
-        `_Auto-generated by vibeops done at ${inputs.completedAt}._`,
-        "",
-        "Run your project verification commands (for example `pnpm test`, `pnpm lint`) and update this section if anything differs.",
-        "",
-        "## Acceptance criteria checklist",
-        "",
-        criteriaLines,
-    ].join("\n");
-    return { result, testResult };
-}
-function archiveFileName(taskId) {
-    const safe = taskId.toLowerCase().replace(/[^a-z0-9]+/g, "-");
-    const stamp = new Date().toISOString().replace(/[:.]/g, "-");
-    return `${safe}-${stamp}.md`;
-}
-export async function buildDoneSummaryBundle(input) {
-    const ctx = await readGitContext(input.taskFile);
-    const body = await readText(input.taskFile);
-    const existingResult = readSection(body, "Result");
-    const existingTest = readSection(body, "Test Result");
-    const acceptanceCriteria = findAcceptanceCriteria(body);
-    const testPlan = readSection(body, "Test Plan");
-    const completedAt = new Date().toISOString();
-    const gitBlock = (await summarizeTaskDiff(input.cwd, input.taskFile)) ??
-        "_No Git Context on TASK file — run `vibeops start` before the next done._";
-    const range = ctx !== null && ctx.baseCommit.length > 0 ? `${ctx.baseCommit}..HEAD` : null;
-    const nameStatus = range !== null ? await gitNameStatus(input.cwd, range) : "(no git range)";
-    const patch = range !== null ? await gitPatchExcerpt(input.cwd, range) : "(no git range)";
-    const llmProvider = await resolveAvailableLlmProvider(input.cwd);
-    let llmProviderUsed = null;
-    const llmSections = await llmTaskSections(input.cwd, {
-        taskId: input.taskId,
-        taskTitle: input.taskTitle,
-        gitBlock,
-        nameStatus,
-        acceptanceCriteria,
-        testPlan,
-    });
-    let resultSection;
-    let testResultSection;
-    if (llmSections !== null) {
-        resultSection = llmSections.result;
-        testResultSection = llmSections.testResult;
-        llmProviderUsed = llmSections.provider;
-    }
-    else {
-        const fallback = fallbackTaskSections({
-            completedAt,
-            gitBlock,
-            nameStatus,
-            acceptanceCriteria,
-        });
-        resultSection = fallback.result;
-        testResultSection = fallback.testResult;
-    }
-    const narrative = await llmChangeNarrative(input.cwd, {
-        taskId: input.taskId,
-        taskTitle: input.taskTitle,
-        result: resultSection,
-        testResult: testResultSection,
-        gitBlock,
-        nameStatus,
-    });
-    if (narrative !== null && llmProviderUsed === null && llmProvider !== null) {
-        llmProviderUsed = llmProvider;
-    }
-    const lines = [
-        `# Done summary · ${input.taskId}`,
-        "",
-        `- **Title:** ${input.taskTitle}`,
-        `- **Completed at:** ${completedAt}`,
-        `- **TASK file:** \`${rel(input.cwd, input.taskFile)}\``,
-        ctx
-            ? `- **Git range:** \`${ctx.baseCommit}..HEAD\` (\`${ctx.taskBranch}\` → \`${ctx.baseBranch}\`)`
-            : "",
-        "",
-        "## Result (TASK)",
-        "",
-        input.skipTaskAutoFill === true && hasNonEmptySection(body, "Result")
-            ? existingResult
-            : resultSection,
-        "",
-        "## Test Result (TASK)",
-        "",
-        input.skipTaskAutoFill === true && hasNonEmptySection(body, "Test Result")
-            ? existingTest
-            : testResultSection,
-        "",
-        "## Git",
-        "",
-        gitBlock,
-        "",
-        "## Files changed",
-        "",
-        "```",
-        nameStatus,
-        "```",
-        "",
-    ];
-    if (narrative !== null && narrative.trim().length > 0) {
-        const via = llmProviderUsed ?? llmProvider;
-        const viaLabel = via === "codex-oauth"
-            ? "Codex OAuth"
-            : via === "cursor-agent"
-                ? "Cursor Agent CLI"
-                : via === "openai"
-                    ? "OpenAI API"
-                    : "LLM";
-        lines.push(`## Change summary (${viaLabel})`, "", narrative.trim(), "");
-    }
-    else {
-        lines.push("## Change summary (LLM)", "", "_(Connect Codex OAuth, Cursor Agent CLI, or OPENAI_API_KEY for a narrative; git + TASK sections above are always recorded.)_", "");
-    }
-    lines.push("## Patch excerpt", "", "```diff", patch, "```", "", "---", "", "_Used by `vibeops next` and the next `vibeops plan` as prior iteration context._");
-    return {
-        markdown: lines.join("\n"),
-        resultSection,
-        testResultSection,
-    };
-}
-export async function applyTaskDoneSections(taskFile, sections, opts) {
-    const body = await readText(taskFile);
-    let updated = false;
-    const writeResult = opts.refresh === true || !hasNonEmptySection(body, "Result");
-    const writeTest = opts.refresh === true || !hasNonEmptySection(body, "Test Result");
-    if (writeResult) {
-        if (opts.dryRun === true) {
-            log.info(dim("  dry-run: would update TASK → Result"));
-        }
-        else {
-            await updateTaskSection(taskFile, "Result", sections.result);
-            log.ok("TASK → Result (auto-filled)");
-        }
-        updated = true;
-    }
-    if (writeTest) {
-        if (opts.dryRun === true) {
-            log.info(dim("  dry-run: would update TASK → Test Result"));
-        }
-        else {
-            await updateTaskSection(taskFile, "Test Result", sections.testResult);
-            log.ok("TASK → Test Result (auto-filled)");
-        }
-        updated = true;
-    }
-    return updated;
-}
-/** Write summary files + auto-fill TASK Result / Test Result when empty. */
-export async function writeDoneSummary(input) {
-    const bundle = await buildDoneSummaryBundle(input);
-    let taskSectionsUpdated = false;
-    if (input.skipTaskAutoFill !== true) {
-        taskSectionsUpdated = await applyTaskDoneSections(input.taskFile, { result: bundle.resultSection, testResult: bundle.testResultSection }, { dryRun: input.dryRun, refresh: input.refreshTaskSections === true });
-    }
-    const lastPath = join(input.cwd, LAST_DONE_SUMMARY_REL);
-    const archivePath = join(input.cwd, DONE_SUMMARIES_DIR, archiveFileName(input.taskId));
-    const provider = await resolveAvailableLlmProvider(input.cwd);
-    if (provider !== null) {
-        const label = provider === "codex-oauth"
-            ? "Codex OAuth"
-            : provider === "cursor-agent"
-                ? "Cursor Agent CLI"
-                : "OpenAI API";
-        log.info(dim(`  LLM: ${label}`));
-    }
-    else {
-        log.info(dim("  LLM: none (git-only TASK sections)"));
-    }
-    if (input.dryRun === true) {
-        log.info(dim(`  dry-run: would write ${LAST_DONE_SUMMARY_REL} and archive under done-summaries/`));
-        return { ...bundle, lastPath, archivePath, taskSectionsUpdated };
-    }
-    const archiveDir = join(input.cwd, DONE_SUMMARIES_DIR);
-    if (!(await isDirectory(archiveDir))) {
-        await mkdir(archiveDir, { recursive: true });
-    }
-    await writeText(lastPath, bundle.markdown);
-    await writeText(archivePath, bundle.markdown);
-    log.ok(`Wrote ${cyan(LAST_DONE_SUMMARY_REL)} (+ archive)`);
-    return { ...bundle, lastPath, archivePath, taskSectionsUpdated };
-}
-export async function readLastDoneSummary(cwd) {
-    const path = join(cwd, LAST_DONE_SUMMARY_REL);
-    if (!(await pathExists(path)))
-        return null;
-    const text = await readTextOrNull(path);
-    return text !== null && text.trim().length > 0 ? text : null;
-}
-export function excerptDoneSummary(full, maxLines = 40) {
-    const lines = full.split("\n");
-    if (lines.length <= maxLines)
-        return full;
-    return [...lines.slice(0, maxLines), "", `… (${lines.length - maxLines} more lines in file)`].join("\n");
-}
-export function renderPriorIterationSection(priorSummary) {
-    return `## Previous iteration (from last \`vibeops done\`)
-
-${priorSummary.trim()}
-
----
-`;
-}
-/** @deprecated Use buildDoneSummaryBundle */
-export async function buildDoneSummaryMarkdown(input) {
-    const bundle = await buildDoneSummaryBundle(input);
-    return bundle.markdown;
-}