@goodtek/vibeops 0.7.22 → 1.0.0

package/dist/lib/plan-post-apply-setup.js

@@ -1,116 +0,0 @@
-import { githubInitCommand } from "../commands/github-init.js";
-import { notionInitCommand } from "../commands/notion-init.js";
-import { notionSyncCommand } from "../commands/notion-sync.js";
-import { askYesNo } from "./inquirer-helpers.js";
-import { cyan, dim, log } from "./logger.js";
-import { gitInit, gitRemoteUrl, gitSetDefaultBranch, isGitRepository } from "./git.js";
-import { loadSyncContext } from "./notion-sync.js";
-const DEFAULT_BRANCH = "main";
-/**
- * Ensures `cwd` is a Git work tree before planner `git add` / `git commit`.
- * @returns false when commit should be skipped
- */
-export async function ensureGitForPlannerCommit(params) {
-    if (await isGitRepository(params.cwd)) {
-        return true;
-    }
-    if (!params.interactive) {
-        log.warn(`No Git repository in this folder — skipping commit. Run ${cyan("git init")} or ${cyan("vibeops init")} with Git enabled, then commit manually.`);
-        return false;
-    }
-    const ok = await askYesNo({
-        message: `No Git repository here yet. Run ${cyan("git init")} and set default branch ${cyan(DEFAULT_BRANCH)} now?`,
-        nonInteractive: false,
-        defaultValue: true,
-    });
-    if (!ok) {
-        log.info(dim("Skipping git commit. Initialize Git when ready, then commit the planner files."));
-        return false;
-    }
-    await gitInit(params.cwd);
-    await gitSetDefaultBranch(params.cwd, DEFAULT_BRANCH);
-    log.ok(`Git initialized (default branch ${DEFAULT_BRANCH}).`);
-    return true;
-}
-/**
- * Runs `notion sync`, or when context is missing and stdin is interactive,
- * offers to run `vibeops notion init` first then retries sync once.
- */
-export async function runNotionSyncWithOptionalInit(params) {
-    let ctx = await loadSyncContext(params.cwd);
-    if (ctx.ok) {
-        const priorFailure = process.exitCode === 1;
-        await notionSyncCommand({ cwd: params.cwd });
-        if (priorFailure) {
-            process.exitCode = 1;
-        }
-        return;
-    }
-    if (!params.interactive) {
-        log.warn(`Notion sync skipped: ${ctx.message}`);
-        return;
-    }
-    const setup = await askYesNo({
-        message: `Notion is not ready (${ctx.message}). Run ${cyan("vibeops notion init")} setup here now?`,
-        nonInteractive: false,
-        defaultValue: true,
-    });
-    if (!setup) {
-        log.info(dim("Skipping Notion sync. When ready, run `vibeops notion init` then `vibeops notion sync`."));
-        return;
-    }
-    const priorFailure = process.exitCode === 1;
-    await notionInitCommand({ cwd: params.cwd, nonInteractive: false, dryRun: false });
-    if (process.exitCode === 1) {
-        log.warn("Notion setup exited with an error — sync skipped. Fix issues and run `vibeops notion sync`.");
-        return;
-    }
-    ctx = await loadSyncContext(params.cwd);
-    if (!ctx.ok) {
-        log.warn(`Notion still not ready after setup: ${ctx.message}`);
-        log.info(dim("Try `vibeops notion test` and re-run `vibeops notion sync`."));
-        if (priorFailure) {
-            process.exitCode = 1;
-        }
-        return;
-    }
-    await notionSyncCommand({ cwd: params.cwd });
-    if (priorFailure) {
-        process.exitCode = 1;
-    }
-}
-/**
- * Before `git push`, optionally runs the same flow as `vibeops github init`
- * (connect existing GitHub repo or create new, `gh auth`, `origin`, config).
- */
-export async function offerGithubInitBeforePush(params) {
-    const originUrl = await gitRemoteUrl(params.cwd, "origin");
-    const hasOrigin = Boolean(originUrl && originUrl.trim().length > 0);
-    if (!params.interactive) {
-        if (!hasOrigin) {
-            log.warn(`No ${cyan("origin")} remote — ${cyan("git push")} may fail. Run ${cyan("vibeops github init")} or add a remote, then push again.`);
-        }
-        return;
-    }
-    const wants = await askYesNo({
-        message: hasOrigin
-            ? `Run ${cyan("vibeops github init")} before push? (connect another repo, create a new GitHub repo, or verify remotes / ${cyan("gh auth")})`
-            : `No ${cyan("origin")} remote yet. Run ${cyan("vibeops github init")} now (connect an existing GitHub repo or create a new one)?`,
-        nonInteractive: false,
-        defaultValue: !hasOrigin,
-    });
-    if (!wants) {
-        return;
-    }
-    log.blank();
-    log.step("GitHub / remote setup (same wizard as `vibeops github init`)");
-    const priorFailure = process.exitCode === 1;
-    await githubInitCommand({ cwd: params.cwd });
-    if (process.exitCode === 1) {
-        log.warn("GitHub setup exited with an error — push may still fail.");
-        return;
-    }
-    if (priorFailure) {
-        process.exitCode = 1;
-    }
-}

package/dist/lib/project-docs.js

@@ -1,95 +0,0 @@
-import { join, relative } from "node:path";
-import { readTextOrNull } from "./filesystem.js";
-import { projectPaths } from "./paths.js";
-/**
- * Canonical project documentation slots that `task generate` looks at.
- * Files that don't exist are returned with `content: null` so the caller
- * can decide whether to mention them as "missing" in the generated prompt.
- */
-const PROJECT_SLOTS = [
-    { label: "Backlog (primary)", fileName: "07-backlog.md", category: "backlog", primary: true },
-    { label: "Overview", fileName: "00-overview.md", category: "overview" },
-    { label: "Requirements", fileName: "01-requirements.md", category: "requirements" },
-    { label: "MVP Scope", fileName: "02-mvp-scope.md", category: "mvp-scope" },
-    { label: "Architecture", fileName: "03-architecture.md", category: "architecture" },
-    { label: "Tech Stack", fileName: "04-tech-stack.md", category: "tech-stack" },
-    { label: "Current State", fileName: "05-current-state.md", category: "current-state" },
-    { label: "Decisions", fileName: "06-decisions.md", category: "decisions" },
-    { label: "Env", fileName: "08-env.md", category: "env" },
-    { label: "Deployment", fileName: "09-deployment.md", category: "deployment" },
-];
-/**
- * Fallback set of project doc filenames for repositories that pre-date the
- * 10-file template layout (e.g. this VibeOps repo itself uses 00–05).
- * Only consulted when a slot above is missing.
- */
-const LEGACY_FALLBACKS = new Map([
-    ["07-backlog.md", ["05-backlog.md"]],
-    ["00-overview.md", []],
-    ["03-architecture.md", ["01-architecture.md"]],
-    ["04-tech-stack.md", ["02-tech-stack.md"]],
-    ["05-current-state.md", ["03-current-state.md"]],
-    ["06-decisions.md", ["04-decisions.md"]],
-]);
-function relDisplay(root, abs) {
-    const r = relative(root, abs);
-    return r.length === 0 ? "." : r;
-}
-async function readSlotWithFallback(cwd, spec) {
-    const paths = projectPaths(cwd);
-    const canonical = join(paths.docsProject, spec.fileName);
-    let abs = canonical;
-    let content = await readTextOrNull(abs);
-    if (content === null) {
-        for (const fallback of LEGACY_FALLBACKS.get(spec.fileName) ?? []) {
-            abs = join(paths.docsProject, fallback);
-            content = await readTextOrNull(abs);
-            if (content !== null)
-                break;
-        }
-        if (content === null)
-            abs = canonical;
-    }
-    return {
-        label: spec.label,
-        path: abs,
-        relativePath: relDisplay(cwd, abs),
-        content,
-        primary: spec.primary === true,
-        category: spec.category,
-    };
-}
-export async function collectInputDocs(inputs) {
-    const slots = [];
-    for (const spec of PROJECT_SLOTS) {
-        slots.push(await readSlotWithFallback(inputs.cwd, spec));
-    }
-    const briefContent = await readTextOrNull(inputs.briefAbs);
-    const brief = {
-        label: "Project Brief",
-        path: inputs.briefAbs,
-        relativePath: relDisplay(inputs.cwd, inputs.briefAbs),
-        content: briefContent,
-        primary: false,
-        category: "brief",
-    };
-    let from = null;
-    if (typeof inputs.fromAbs === "string" && inputs.fromAbs.length > 0) {
-        const content = await readTextOrNull(inputs.fromAbs);
-        from = {
-            label: "Custom input (--from)",
-            path: inputs.fromAbs,
-            relativePath: relDisplay(inputs.cwd, inputs.fromAbs),
-            content,
-            primary: true,
-            category: "custom",
-        };
-    }
-    return { slots, brief, from };
-}
-export function presentSlots(docs) {
-    return docs.slots.filter((s) => s.content !== null);
-}
-export function missingSlots(docs) {
-    return docs.slots.filter((s) => s.content === null);
-}

package/dist/lib/prompt-builder.js

@@ -1,135 +0,0 @@
-function renderTopList(values) {
-    if (values.length === 0)
-        return "- _(none selected)_";
-    return values.map((v) => `- ${v}`).join("\n");
-}
-function renderInlineList(label, values) {
-    if (values.length === 0)
-        return `- **${label}**: _(none selected)_`;
-    const head = `- **${label}**:`;
-    const items = values.map((v) => `  - ${v}`).join("\n");
-    return `${head}\n${items}`;
-}
-function renderBool(value) {
-    return value ? "yes" : "no";
-}
-function summary(brief) {
-    const lines = [];
-    lines.push(`- **Project name**: ${brief.projectName}`);
-    lines.push(`- **One-line idea**: ${brief.oneLineIdea}`);
-    lines.push(`- **Project type**: ${brief.projectType}`);
-    lines.push(renderInlineList("Target users", brief.targetUsers));
-    lines.push(`- **Core problem**: ${brief.coreProblem}`);
-    lines.push(renderInlineList("MVP must-have features", brief.mvpFeatures));
-    lines.push(renderInlineList("Out of scope for MVP", brief.outOfScope));
-    lines.push(`- **Frontend**: ${brief.frontend}`);
-    lines.push(`- **Backend**: ${brief.backend}`);
-    lines.push(`- **Database**: ${brief.database}`);
-    lines.push(`- **ORM / DB layer**: ${brief.dbLayer}`);
-    lines.push(`- **Package manager**: ${brief.packageManager}`);
-    lines.push(renderInlineList("Deployment target", brief.deploymentTargets));
-    lines.push(renderInlineList("Auth requirement", brief.authRequirements));
-    lines.push(renderInlineList("External integrations", brief.integrations));
-    lines.push(`- **Use Notion dashboard sync**: ${renderBool(brief.useNotion)}`);
-    lines.push(`- **Use Git task branch workflow**: ${renderBool(brief.useGitWorkflow)}`);
-    lines.push(`- **Agent workflow level**: ${brief.agentWorkflowLevel}`);
-    lines.push(renderInlineList("Risk areas", brief.risks));
-    lines.push(`- **Success criteria**: ${brief.successCriteria}`);
-    return lines.join("\n");
-}
-export function buildPlanPrompt(inputs) {
-    const { brief, meta, briefRelativePath } = inputs;
-    const assumptions = meta.assumptions.length > 0
-        ? meta.assumptions.map((a) => `- ${a}`).join("\n")
-        : "- _(none recorded)_";
-    const viaLlm = meta.source === "llm-openai" ||
-        meta.source === "llm-codex-oauth" ||
-        meta.source === "llm-cursor-agent";
-    const opener = viaLlm
-        ? meta.source === "llm-codex-oauth"
-            ? "This file was produced by `vibeops plan` using **Codex (ChatGPT OAuth)** tokens from your Codex CLI session (`~/.codex/auth.json`). Open a new chat in **Cursor** and paste the full contents of this file. The Planner Agent receives this input and fills in `docs/project/*` plus the initial backlog."
-            : meta.source === "llm-openai"
-                ? "This file was produced by `vibeops plan` using an **OpenAI platform API key**. Open a new chat in **Cursor** and paste the full contents of this file. The Planner Agent receives this input and fills in `docs/project/*` plus the initial backlog."
-                : "This file was produced by `vibeops plan` using the **Cursor Agent CLI**. Open a new chat in **Cursor** and paste the full contents of this file. The Planner Agent receives this input and fills in `docs/project/*` plus the initial backlog."
-        : "This file was produced by `vibeops plan`. Open a new chat in **Cursor** and paste the full contents of this file. VibeOps does not call LLMs for this path — the Planner Agent receives this input and fills in `docs/project/*` plus the initial backlog.";
-    return `# VibeOps Plan Prompt — Cursor Planner Agent
-
-> ${opener}
-
-- Brief location: \`${briefRelativePath}\`
-- VibeOps version: ${meta.vibeopsVersion}
-- Generated: ${meta.generatedAt}
-- Source: ${meta.source} · schemaVersion: ${meta.schemaVersion}
-
----
-
-## Role: Planner Agent
-
-Follow the definition in \`.vibeops/agents/planner.md\`. You do not write application code. You produce:
-
-1. Updates to \`docs/project/*\` — vision / requirements / scope / architecture draft / tech stack / decisions / backlog / environment / deployment notes.
-2. An initial backlog of \`docs/tasks/TASK-NNN-*.md\` files (3-6 to start). Each TASK contains the sections Status · MVP Phase · Goal · Scope · Out of Scope · Acceptance Criteria · Test Plan · Result · Test Result.
-
-## Hard rules (failure if violated)
-
-- Do not produce application code. The deliverable for this round is limited to \`docs/**\`.
-- Do not touch VibeOps' own config (\`.vibeops/\`, \`.vibeops.json\`, \`templates/\`).
-- Source-of-truth rules: \`docs/tasks/*.md\` = AI execution baseline, \`docs/project/*.md\` = design / current-state baseline, Git commits/branches = change history, Notion = human dashboard (summary / status / priority / docs path only), chat is never a baseline.
-- One TASK, one focus. Surface inter-TASK dependencies in the body.
-- Never hide assumptions. Record them in both the docs/project bodies and the closing "Assumptions" section.
-- Notion / Git workflow / agent workflow level follow the ProjectBrief values below as-is. Do not change them on a whim.
-
-## ProjectBrief (user answers)
-
-${summary(brief)}
-
-### Assumptions inherited from the brief
-
-${assumptions}
-
-## Output format
-
-Produce the response in this exact order:
-
-1. **Plan Summary** — 5 to 8 bullets capturing the direction derived from the ProjectBrief (audience, scope, tech selections, key risks).
-2. **docs/project/\\*** — emit the 8 files below, each in its own fenced code block. The first line of each block is \`<!-- file: docs/project/XX-name.md -->\`. (\`03-architecture\` and \`05-current-state\` are not produced in this round.)
-   - \`docs/project/00-overview.md\`
-   - \`docs/project/01-requirements.md\`
-   - \`docs/project/02-mvp-scope.md\`
-   - \`docs/project/04-tech-stack.md\`
-   - \`docs/project/06-decisions.md\`
-   - \`docs/project/07-backlog.md\`
-   - \`docs/project/08-env.md\`
-   - \`docs/project/09-deployment.md\`
-3. **docs/tasks/TASK-NNN-\\*** — 3 to 6 initial backlog items. Each in a fenced block beginning with \`<!-- file: docs/tasks/TASK-NNN-slug.md -->\`.
-4. **Changed file list** — the full list of files produced above.
-5. **Assumptions** — decisions the user must reconfirm (\`(none)\` if there are none).
-
-## Field mapping (brief field → docs file)
-
-- \`00-overview.md\` ← projectName, oneLineIdea, projectType, targetUsers, coreProblem, successCriteria
-- \`01-requirements.md\` ← mvpFeatures, authRequirements, integrations, targetUsers
-- \`02-mvp-scope.md\` ← mvpFeatures (IN), outOfScope (OUT), successCriteria
-- \`04-tech-stack.md\` ← frontend, backend, database, dbLayer, packageManager
-- \`06-decisions.md\` ← useNotion, useGitWorkflow, agentWorkflowLevel, packageManager, plus any auto-derived decisions.
-- \`07-backlog.md\` ← decompose mvpFeatures into TASKs (1-2 per feature + 1 setup). Include priority and definition of done.
-- \`08-env.md\` ← env variables per integration (e.g. OpenAI → OPENAI_API_KEY) and their purpose.
-- \`09-deployment.md\` ← deployment notes per deploymentTargets. If only "Not sure" is selected, state that explicitly and mark the decision as pending.
-
-## Notion / Git / Agent workflow handling
-
-- Use Notion dashboard sync: ${renderBool(brief.useNotion)} → record in \`06-decisions.md\`. ${brief.useNotion ? "Decision: VibeOps will sync Notion DB metadata." : "Decision: no Notion sync (revisit in a future TASK if needed)."}
-- Use Git task branch workflow: ${renderBool(brief.useGitWorkflow)} → ${brief.useGitWorkflow ? "TASK lifecycle assumes the task/TASK-NNN-slug branch model." : "Record that the Git task-branch model is not used (linear workflow)."}
-- Agent workflow level: \`${brief.agentWorkflowLevel}\` → fix the agent line-up in \`06-decisions.md\`.
-
-## Risk areas → docs
-
-${renderTopList(brief.risks)}
-
-Record each risk in \`07-backlog.md\` or in the Risks section of the corresponding TASK. Operational risks such as "Authentication/security" or "Browser automation reliability" become candidates for their own TASK.
-
----
-
-Apply the rules above and produce the response. After you respond, a human reviews via \`git diff\` and commits.
-`;
-}

package/dist/lib/resolve-command-task.js

@@ -1,40 +0,0 @@
-import { findMvpTaskFile } from "./mvp-artifacts.js";
-import { TASK_MVP_ID, resolveTaskRef } from "./mvp-constants.js";
-import { findTaskFile, pickActiveTask, readTaskFile } from "./task.js";
-/**
- * Resolve which TASK file `start` / `done` / `rollback` target.
- * Default (no ref): TASK-mvp if present, else active/next backlog TASK (legacy projects).
- */
-export async function resolveCommandTask(paths, cwd, taskRef) {
-    const trimmed = taskRef?.trim();
-    if (trimmed !== undefined && trimmed.length > 0) {
-        const taskId = resolveTaskRef(trimmed);
-        const taskFile = await findTaskFile(paths.docsTasks, taskId);
-        if (taskFile === null)
-            return null;
-        return { taskId, taskFile, source: "explicit" };
-    }
-    const mvpFile = await findMvpTaskFile(paths.docsTasks);
-    if (mvpFile !== null) {
-        const meta = await readTaskFile(mvpFile);
-        return { taskId: meta.id, taskFile: mvpFile, source: "mvp-default" };
-    }
-    const active = await pickActiveTask(paths.docsTasks, cwd);
-    if (active !== null) {
-        return {
-            taskId: active.id,
-            taskFile: active.filePath,
-            source: "backlog-active",
-        };
-    }
-    return null;
-}
-export function commandTaskNotFoundMessage(taskRef) {
-    const trimmed = taskRef?.trim();
-    if (trimmed !== undefined && trimmed.length > 0) {
-        const id = resolveTaskRef(trimmed);
-        return `TASK not found: ${id}. Check docs/tasks/ or the TASK id.`;
-    }
-    return (`No TASK found (no ${TASK_MVP_ID} — run ${"vibeops plan"} for a new MVP slice, ` +
-        `or add docs/tasks/TASK-NNN-*.md and run vibeops start TASK-NNN).`);
-}

package/dist/lib/task-add-build-prompt.js

@@ -1,39 +0,0 @@
-import { join } from "node:path";
-import { VERSION } from "../version.js";
-export function taskBuildPromptRel(taskId) {
-    const slug = taskId.toLowerCase().replace(/[^a-z0-9-]+/g, "-");
-    return `.vibeops/generated/task-build-${slug}.md`;
-}
-export function buildTaskBuildPrompt(params) {
-    return `# Build ${params.taskId} — ${params.projectName}
-
-You are the **implementer** in Cursor for this repository. Deliver everything in the TASK file below. 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\` if present)
-3. \`docs/project/02-mvp-scope.md\`, \`03-architecture.md\`, \`04-tech-stack.md\`, \`06-decisions.md\`
-4. TASK file: \`${params.taskRelativePath}\` — work **only** inside Scope / Acceptance Criteria
-
-## How to work
-
-- Implement **only** \`${params.taskId}\`. Do not start other TASK ids unless the human asks.
-- **Search** the repo before adding files; reuse existing patterns.
-- Fill **Result** and **Test Result** in the TASK file with facts (paths, commands, outcomes).
-- No \`git push\` or merge — the human runs \`vibeops done ${params.taskId}\` when ready.
-
-## Definition of done
-
-1. Every **Acceptance Criteria** item in \`${params.taskRelativePath}\` is met.
-2. **Result** and **Test Result** are filled (not placeholders).
-3. Working tree is ready to commit on the task branch if needed.
-
----
-
-*Generated by \`vibeops task add\` (VibeOps ${VERSION}).*
-`;
-}
-export function taskBuildPromptAbs(cwd, taskId) {
-    return join(cwd, taskBuildPromptRel(taskId));
-}

package/dist/lib/task-add-cursor.js

@@ -1,81 +0,0 @@
-import { join } from "node:path";
-import { cursorAgentPrint, extractAgentAssistantText } from "./plan-llm-cursor-agent.js";
-import { parsePlannerFenceFiles, writePlannerFiles } from "./plan-apply-planner.js";
-import { probeCursorAgentCli } from "./plan-llm-detect.js";
-import { REQUIRED_TASK_SECTIONS } from "./task-generator.js";
-import { bold, log } from "./logger.js";
-const SINGLE_TASK_SYSTEM = `You are the VibeOps Planner Agent. Create exactly ONE TASK markdown file.
-
-Rules:
-- Output normal markdown with exactly one fenced code block.
-- First line inside the block MUST be: <!-- file: docs/tasks/TASK-NNN-slug.md --> (use the path given in the user message).
-- Fill every section listed in the template. Status must be "planned". Git Context and Result sections use placeholders only.
-- Do not create application code. Do not edit files outside docs/tasks/.
-- Acceptance Criteria must be numbered and testable.`;
-export async function generateTaskFileViaCursor(input) {
-    const relPath = `docs/tasks/${input.taskId}-${input.slug}.md`;
-    const phase = input.phase?.trim() || "MVP 1";
-    if (input.dryRun === true) {
-        return { ok: true, writtenPath: relPath };
-    }
-    const probe = await probeCursorAgentCli(input.cwd);
-    if (!probe.ok) {
-        return {
-            ok: false,
-            reason: probe.reason ?? "Cursor Agent CLI is not ready. Run `agent login` or use quick skeleton mode.",
-        };
-    }
-    const userPrompt = `${SINGLE_TASK_SYSTEM}
-
-Create this file:
-
-<!-- file: ${relPath} -->
-
-Template sections (all required):
-${REQUIRED_TASK_SECTIONS.map((s) => `- ${s}`).join("\n")}
-
-TASK id: ${input.taskId}
-Title: ${input.title}
-MVP Phase: ${phase}
-
-User description:
-${input.idea}
-
-Write the complete TASK markdown body now.`;
-    log.step(bold(`Cursor Agent is writing ${relPath}…`));
-    try {
-        const raw = await cursorAgentPrint({
-            cwd: input.cwd,
-            prompt: userPrompt,
-            model: input.model,
-        });
-        const text = extractAgentAssistantText(raw);
-        const parsed = parsePlannerFenceFiles(text);
-        const match = parsed.find((f) => f.relativePath === relPath) ??
-            parsed.find((f) => f.relativePath.endsWith(`${input.taskId}-${input.slug}.md`)) ??
-            parsed[0];
-        if (!match) {
-            return {
-                ok: false,
-                reason: "Cursor output did not include a valid <!-- file: docs/tasks/... --> block.",
-            };
-        }
-        if (match.relativePath !== relPath) {
-            log.warn(`Model used path ${match.relativePath}; writing to planned ${relPath}.`);
-        }
-        const written = await writePlannerFiles(input.cwd, [
-            { relativePath: relPath, content: match.content },
-        ]);
-        if (written.length === 0) {
-            return { ok: false, reason: "Failed to write TASK file." };
-        }
-        return { ok: true, writtenPath: relPath };
-    }
-    catch (e) {
-        const msg = e instanceof Error ? e.message : String(e);
-        return { ok: false, reason: msg };
-    }
-}
-export function plannedTaskRelPath(taskId, slug) {
-    return join("docs", "tasks", `${taskId}-${slug}.md`);
-}