@goodtek/vibeops 0.7.22 → 1.0.0

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-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 };
-}

package/dist/lib/task-pull.js

@@ -1,354 +0,0 @@
-/**
- * Planning + execution helpers for `vibeops task pull`.
- *
- * Notion is queried for TASK rows whose Status matches `--status` (default
- * "Planned"). For each row that does NOT yet have a local TASK file we plan
- * a new `docs/tasks/TASK-NNN-slug.md` skeleton.
- *
- * Rules:
- *   - Never overwrite an existing local file.
- *   - Never write any TASK body section beyond the Notion-sourced metadata.
- *   - Always include a `## Notion Page` section so `notion sync` can later
- *     update the same row in place.
- *
- * Mutation surface:
- *   - `executePullEntry` writes the local file and (if Docs Path on Notion
- *     was empty) optionally updates the Notion page's Docs Path. Callers in
- *     dry-run mode MUST skip this.
- */
-import { readdir } from "node:fs/promises";
-import { basename, join, posix } from "node:path";
-import { pathExists, writeText } from "./filesystem.js";
-import { projectPaths } from "./paths.js";
-import { formatTaskId, highestTaskNumber, } from "./task.js";
-import { slugify } from "./task-generator.js";
-import { readRichText, readSelect, readStatus, readTitle, richTextEqualsFilter, richTextProperty, statusEqualsFilter, andFilter, } from "./notion-mappers.js";
-import { renderPulledTaskMarkdown, } from "./task-summary.js";
-export function rowFromNotionPage(page) {
-    const p = page.properties;
-    return {
-        pageId: page.id,
-        taskId: readRichText(p["Task ID"]),
-        name: readTitle(p.Name),
-        status: readStatus(p.Status),
-        mvpPhase: readSelect(p["MVP Phase"]),
-        priority: readSelect(p.Priority),
-        summary: readRichText(p.Summary),
-        docsPath: readRichText(p["Docs Path"]),
-    };
-}
-const DEFAULT_STATUS_NAMES = ["Planned"];
-const DEFAULT_LIMIT = 20;
-const MAX_LIMIT = 100;
-function buildPullFilter(projectId, statusNames) {
-    const statusFilters = statusNames.map((n) => statusEqualsFilter("Status", n));
-    const statusFilter = statusFilters.length === 1
-        ? statusFilters[0]
-        : { or: statusFilters };
-    return andFilter([
-        richTextEqualsFilter("Project ID", projectId),
-        statusFilter,
-    ]);
-}
-/**
- * Notion `Docs Path` is **trusted only when its basename matches the TASK
- * ID**. A row whose Task ID is `TASK-099` but whose Docs Path points at
- * `docs/tasks/TASK-012-package-polish-readme.md` is a mismatch — surfacing
- * it as `local-file-exists` silently shadows the real TASK-099 candidate.
- *
- * Acceptable basenames (case sensitive — Notion is case sensitive here):
- *   - `TASK-099.md`
- *   - `TASK-099-anything.md`  (the standard `TASK-NNN-slug.md` form)
- *
- * Anything else is a mismatch.
- */
-export function docsPathMatchesTaskId(docsRelativePath, taskId) {
-    if (docsRelativePath.length === 0 || taskId.length === 0)
-        return false;
-    const base = basename(docsRelativePath);
-    return base === `${taskId}.md` || base.startsWith(`${taskId}-`);
-}
-/** Scan `docs/tasks` for any file whose basename starts with `TASK-NNN`. */
-async function findLocalTaskFileForId(docsTasksDir, taskId) {
-    let entries;
-    try {
-        entries = await readdir(docsTasksDir);
-    }
-    catch {
-        return null;
-    }
-    for (const name of entries) {
-        if (name === `${taskId}.md` || name.startsWith(`${taskId}-`)) {
-            return join(docsTasksDir, name);
-        }
-    }
-    return null;
-}
-export async function planPull(inputs) {
-    const statusNames = inputs.statusNames ?? DEFAULT_STATUS_NAMES;
-    const limit = Math.max(1, Math.min(inputs.limit ?? DEFAULT_LIMIT, MAX_LIMIT));
-    const res = await inputs.client.queryDataSource(inputs.tasksDataSourceId, {
-        filter: buildPullFilter(inputs.projectId, statusNames),
-        pageSize: limit,
-    });
-    const paths = projectPaths(inputs.cwd);
-    const startCounter = await highestTaskNumber(paths.docsTasks);
-    let nextNumber = startCounter + 1;
-    const entries = [];
-    const skipped = [];
-    const trace = [];
-    // First pass: detect duplicate Task IDs across the Notion query result so
-    // a second row with the same id cannot quietly create a second entry. We
-    // keep the first row and skip subsequent ones with `duplicate-task-id`.
-    const seenTaskIds = new Set();
-    const duplicatePageIds = new Set();
-    for (const page of res.results) {
-        const id = rowFromNotionPage(page).taskId.trim();
-        if (id.length === 0)
-            continue;
-        if (seenTaskIds.has(id)) {
-            duplicatePageIds.add(page.id);
-        }
-        else {
-            seenTaskIds.add(id);
-        }
-    }
-    for (const page of res.results) {
-        const row = rowFromNotionPage(page);
-        const notionDocsPath = row.docsPath.trim();
-        // (A) Task ID required — guard against blank ids before we touch local fs.
-        const taskIdRaw = row.taskId.trim();
-        if (taskIdRaw.length === 0 && notionDocsPath.length === 0) {
-            // No Task ID and no Docs Path → allocate a fresh one, treated as a
-            // legitimate "new" candidate (existing behaviour). Trace it so
-            // `--verbose` makes the allocation visible.
-            const taskId = formatTaskId(nextNumber);
-            nextNumber++;
-            const slug = slugify(row.name.length > 0 ? row.name : taskId, taskId.toLowerCase());
-            const docsRelativePath = posix.join("docs/tasks", `${taskId}-${slug}.md`);
-            const absPath = join(paths.docsTasks, `${taskId}-${slug}.md`);
-            // Even an allocated id may already be present on disk (race / manual
-            // creation). Re-check.
-            if (await pathExists(absPath)) {
-                skipped.push({
-                    pageId: page.id,
-                    taskId,
-                    reason: "local-file-exists",
-                    docsRelativePath,
-                    detail: `local resolved path: ${docsRelativePath}`,
-                });
-                trace.push({
-                    taskId,
-                    pageId: page.id,
-                    notionDocsPath,
-                    localResolvedPath: docsRelativePath,
-                    decision: "skip-local-file-exists",
-                    reason: "Task ID was empty, allocated next id already on disk",
-                });
-                continue;
-            }
-            entries.push({
-                pageId: page.id,
-                taskId,
-                title: row.name.length > 0 ? row.name : taskId,
-                status: row.status,
-                mvpPhase: row.mvpPhase,
-                summary: row.summary,
-                docsRelativePath,
-                absPath,
-                notionNeedsDocsPath: true,
-                detail: "allocated Task ID (Notion row had none)",
-            });
-            trace.push({
-                taskId,
-                pageId: page.id,
-                notionDocsPath: "",
-                localResolvedPath: docsRelativePath,
-                decision: "new-file",
-                reason: "Task ID empty → allocated; no local file with that id",
-            });
-            continue;
-        }
-        if (taskIdRaw.length === 0) {
-            // Has a Docs Path but no Task ID — refuse to act. Renaming pages from
-            // empty ids is risky and not in TASK-011 scope.
-            skipped.push({
-                pageId: page.id,
-                taskId: "(none)",
-                reason: "no-task-id",
-                docsRelativePath: notionDocsPath,
-                detail: `notion docs path: ${notionDocsPath}`,
-            });
-            trace.push({
-                taskId: "(none)",
-                pageId: page.id,
-                notionDocsPath,
-                localResolvedPath: notionDocsPath,
-                decision: "skip-no-task-id",
-                reason: "Notion row has Docs Path but no Task ID",
-            });
-            continue;
-        }
-        const taskId = taskIdRaw;
-        // (A.2) duplicate Task ID across the considered rows.
-        if (duplicatePageIds.has(page.id)) {
-            skipped.push({
-                pageId: page.id,
-                taskId,
-                reason: "duplicate-task-id",
-                docsRelativePath: notionDocsPath,
-                detail: `another Notion row already used this Task ID in the same query`,
-            });
-            trace.push({
-                taskId,
-                pageId: page.id,
-                notionDocsPath,
-                localResolvedPath: "",
-                decision: "skip-duplicate-task-id",
-                reason: "duplicate Task ID across considered rows — kept first row only",
-            });
-            continue;
-        }
-        // (B) Notion Docs Path exists but does NOT match this Task ID. Refuse
-        // to create / overwrite — surface a `docs-path-mismatch` so the user
-        // can fix Notion. We deliberately do NOT auto-rename — auto-fixing
-        // Notion's Docs Path on a mismatch is reserved for a future
-        // `--fix-docs-path` opt-in.
-        if (notionDocsPath.length > 0 &&
-            !docsPathMatchesTaskId(notionDocsPath, taskId)) {
-            skipped.push({
-                pageId: page.id,
-                taskId,
-                reason: "docs-path-mismatch",
-                docsRelativePath: notionDocsPath,
-                detail: `notion docs path: ${notionDocsPath}\n` +
-                    `expected basename prefix: ${taskId}- or ${taskId}.md\n` +
-                    `action: fix Notion 'Docs Path' for this row (auto-fix not enabled).`,
-            });
-            trace.push({
-                taskId,
-                pageId: page.id,
-                notionDocsPath,
-                localResolvedPath: notionDocsPath,
-                decision: "skip-docs-path-mismatch",
-                reason: `Notion Docs Path basename does not match ${taskId}- prefix`,
-            });
-            continue;
-        }
-        // (C) / (D) / (F) — resolve where the local file would live and check
-        // for existing files. If Notion gave us a matching Docs Path, honour
-        // it. Otherwise scan `docs/tasks` for any `TASK-NNN-*.md` already on
-        // disk; if found, treat the row as `local-file-exists`. If not, plan a
-        // new `TASK-NNN-slug.md`.
-        const slug = slugify(row.name.length > 0 ? row.name : taskId, taskId.toLowerCase());
-        let docsRelativePath;
-        let absPath;
-        let notionNeedsDocsPath;
-        let decisionDetail;
-        if (notionDocsPath.length > 0) {
-            docsRelativePath = notionDocsPath;
-            absPath = join(inputs.cwd, notionDocsPath);
-            notionNeedsDocsPath = false;
-            decisionDetail = `notion docs path: ${notionDocsPath}`;
-        }
-        else {
-            const existing = await findLocalTaskFileForId(paths.docsTasks, taskId);
-            if (existing !== null) {
-                const rel = posix.join("docs/tasks", basename(existing));
-                skipped.push({
-                    pageId: page.id,
-                    taskId,
-                    reason: "local-file-exists",
-                    docsRelativePath: rel,
-                    detail: `local resolved path: ${rel}\n` +
-                        `notion docs path: (empty)`,
-                });
-                trace.push({
-                    taskId,
-                    pageId: page.id,
-                    notionDocsPath: "",
-                    localResolvedPath: rel,
-                    decision: "skip-local-file-exists",
-                    reason: "Notion Docs Path empty, but a local file matching the Task ID was found on disk",
-                });
-                continue;
-            }
-            docsRelativePath = posix.join("docs/tasks", `${taskId}-${slug}.md`);
-            absPath = join(paths.docsTasks, `${taskId}-${slug}.md`);
-            notionNeedsDocsPath = true;
-            decisionDetail = `local resolved path: ${docsRelativePath}`;
-        }
-        if (await pathExists(absPath)) {
-            skipped.push({
-                pageId: page.id,
-                taskId,
-                reason: "local-file-exists",
-                docsRelativePath,
-                detail: decisionDetail,
-            });
-            trace.push({
-                taskId,
-                pageId: page.id,
-                notionDocsPath,
-                localResolvedPath: docsRelativePath,
-                decision: "skip-local-file-exists",
-                reason: notionDocsPath.length > 0
-                    ? "Notion Docs Path matched Task ID and file already exists on disk"
-                    : "local search found a file matching the Task ID",
-            });
-            continue;
-        }
-        entries.push({
-            pageId: page.id,
-            taskId,
-            title: row.name.length > 0 ? row.name : taskId,
-            status: row.status,
-            mvpPhase: row.mvpPhase,
-            summary: row.summary,
-            docsRelativePath,
-            absPath,
-            notionNeedsDocsPath,
-            detail: decisionDetail,
-        });
-        trace.push({
-            taskId,
-            pageId: page.id,
-            notionDocsPath,
-            localResolvedPath: docsRelativePath,
-            decision: "new-file",
-            reason: notionDocsPath.length > 0
-                ? "Notion Docs Path matched Task ID — local file does not exist yet"
-                : "Notion Docs Path empty — planning fresh local file under docs/tasks",
-        });
-    }
-    return { entries, skipped, considered: res.results.length, trace };
-}
-export async function executePullEntry(client, entry) {
-    const md = renderPulledTaskMarkdown({
-        taskId: entry.taskId,
-        title: entry.title,
-        status: entry.status,
-        mvpPhase: entry.mvpPhase,
-        summary: entry.summary,
-        pageId: entry.pageId,
-        docsRelativePath: entry.docsRelativePath,
-    });
-    await writeText(entry.absPath, md);
-    let notionUpdated = false;
-    if (entry.notionNeedsDocsPath) {
-        await client.updatePage({
-            pageId: entry.pageId,
-            properties: {
-                "Docs Path": richTextProperty(entry.docsRelativePath),
-            },
-        });
-        notionUpdated = true;
-    }
-    return {
-        taskId: entry.taskId,
-        pageId: entry.pageId,
-        absPath: entry.absPath,
-        docsRelativePath: entry.docsRelativePath,
-        notionUpdated,
-    };
-}