@goodtek/vibeops 0.4.0 → 1.0.0

package/dist/lib/task-scaffold.js

@@ -1,107 +1,59 @@
 import { basename, join } from "node:path";
-import { pathExists, writeText } from "./filesystem.js";
-import { formatTaskId, highestTaskNumber } from "./task.js";
-import { slugify } from "./task-generator.js";
-export async function planScaffoldEntries(inputs) {
-    const startNumber = (await highestTaskNumber(inputs.tasksDir)) + 1;
-    const baseSlug = slugify(inputs.slug ?? "planned-task", "planned-task");
-    const baseTitle = inputs.title ?? "(scaffolded TASK — fill in)";
-    const phase = inputs.phase ?? "(unassigned)";
-    const entries = [];
-    let cursor = startNumber;
-    for (let i = 0; i < inputs.count; i++) {
-        // skip numbers whose file already exists on disk so users running scaffold
-        // twice in a row don't collide with previously generated skeletons.
-        let candidatePath = "";
-        let chosen = -1;
-        while (chosen < 0) {
-            const fileName = `${formatTaskId(cursor)}-${baseSlug}.md`;
-            const abs = join(inputs.tasksDir, fileName);
-            if (!(await pathExists(abs))) {
-                chosen = cursor;
-                candidatePath = abs;
-            }
-            cursor++;
-        }
-        entries.push({
-            id: formatTaskId(chosen),
-            number: chosen,
-            slug: baseSlug,
-            title: baseTitle,
-            fileName: basename(candidatePath),
-            absPath: candidatePath,
-            phase,
-        });
+import { statusDisplay } from "./task.js";
+export const V3_TASK_SECTIONS = [
+    "Status",
+    "Goal",
+    "Scope",
+    "Out of Scope",
+    "Acceptance Criteria",
+    "Test Plan",
+    "Git Context",
+    "Result",
+    "Test Result",
+];
+export function allocateNextTaskNumber(tasks) {
+    let max = 0;
+    for (const t of tasks) {
+        const m = /^TASK-(\d+)$/i.exec(t.id.trim());
+        if (m)
+            max = Math.max(max, Number.parseInt(m[1], 10));
     }
-    return { entries, startNumber };
+    return max + 1;
 }
-export function renderScaffoldMarkdown(entry) {
-    return `# ${entry.id} · ${entry.title}
-
-> This file is a skeleton produced by \`vibeops task generate --scaffold\`. \`vibeops task done\` will refuse to advance the task until every section is filled in.
+export function formatTaskId(number) {
+    return `TASK-${String(number).padStart(3, "0")}`;
+}
+export function buildMinimalTaskMarkdown(draft) {
+    return `# ${draft.id}: ${draft.title}
 
 ## Status
 
-planned
-
-## MVP Phase
-
-${entry.phase}
+${statusDisplay("planned")}
 
 ## Goal
 
-(scaffold — describe in 2-4 sentences what becomes possible when this TASK ships.)
-
-## Background
-
-(scaffold — why now, which earlier TASKs or decisions this builds on.)
+${draft.idea.trim()}
 
 ## Scope
 
-- (scaffold — item 1)
-- (scaffold — item 2)
+- Deliver the goal above in a single focused pass.
 
 ## Out of Scope
 
-- (scaffold — items intentionally excluded)
+- Unrelated refactors and features outside this slice.
 
 ## Acceptance Criteria
 
-1. (scaffold — verifiable statement 1)
-2. (scaffold — verifiable statement 2)
-
-## Files to Inspect First
-
-- (scaffold)
-
-## Expected Files to Change
-
-- new: (scaffold)
-- update: (scaffold)
-
-## Risks
-
-- (scaffold)
+1. Goal and Scope are met and verifiable via Test Plan.
+2. Result and Test Result are filled before \`vibeops task done\`.
 
 ## Test Plan
 
-- (scaffold)
-
-## Rollback Plan
-
-- (scaffold — branch deletion or another recovery flow)
+- Project-specific checks for this change
 
 ## Git Context
 
-(populated by \`vibeops task start ${entry.id}\`)
-
-## Notion Page
-
-(populated by \`vibeops notion sync\`)
-
-## Implementation Plan
-
-1. (scaffold)
+(populated by \`vibeops task add\`)
 
 ## Result
 
@@ -109,20 +61,46 @@ ${entry.phase}
 
 ## Test Result
 
-(not yet)
-
-## Review Notes
-
 (not yet)
 `;
 }
-export async function writeScaffoldFiles(plan) {
-    const written = [];
-    for (const entry of plan.entries) {
-        if (await pathExists(entry.absPath))
-            continue;
-        await writeText(entry.absPath, renderScaffoldMarkdown(entry));
-        written.push(entry.absPath);
+export function taskFilename(taskId, slug) {
+    return `${taskId}-${slug}.md`;
+}
+export function uniqueTaskPath(tasksDir, taskId, baseSlug, existingPaths) {
+    const names = new Set(existingPaths.map((p) => basename(p)));
+    let slug = baseSlug;
+    let name = taskFilename(taskId, slug);
+    let n = 2;
+    while (names.has(name)) {
+        slug = `${baseSlug}-${n}`;
+        name = taskFilename(taskId, slug);
+        n++;
+    }
+    return { slug, filePath: join(tasksDir, name) };
+}
+export function titleFromIdea(idea) {
+    const oneLine = idea.replace(/\s+/g, " ").trim();
+    if (oneLine.length <= 80)
+        return oneLine;
+    return `${oneLine.slice(0, 77).trimEnd()}...`;
+}
+export function ensureV3Sections(markdown) {
+    let body = markdown;
+    for (const section of V3_TASK_SECTIONS) {
+        const re = new RegExp(`^##\\s+${section.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\s*$`, "im");
+        if (!re.test(body)) {
+            body = `${body.trimEnd()}\n\n## ${section}\n\n(not yet)\n`;
+        }
+    }
+    return body;
+}
+export function normalizeTaskHeader(markdown, taskId, title) {
+    const lines = markdown.split("\n");
+    const header = `# ${taskId}: ${title}`;
+    if (lines.length > 0 && /^#\s+/.test(lines[0])) {
+        lines[0] = header;
+        return lines.join("\n");
     }
-    return written;
+    return `${header}\n\n${markdown}`;
 }

package/dist/lib/task-start.js

@@ -0,0 +1,72 @@
+import { relative, resolve } from "node:path";
+import { branchNameForTaskFile, readGitContext, readTaskFile, updateInlineStatus, upsertGitContext, } from "./task.js";
+import { detectDefaultBranch, gitBranchExists, gitCheckout, gitCheckoutNewBranch, gitGovernanceOnlyDirty, gitHeadCommit, readGitInfo, } from "./git.js";
+import { cyan, dim, log } from "./logger.js";
+function relOrAbs(root, p) {
+    const r = relative(root, p);
+    return r === "" ? "." : r.startsWith("..") ? p : r;
+}
+/** Create or resume task branch and mark TASK In Progress (used by `task add`). */
+export async function startTaskBranch(opts) {
+    const cwd = resolve(opts.cwd);
+    const taskFile = opts.taskFile;
+    const meta = await readTaskFile(taskFile);
+    const git = await readGitInfo(cwd);
+    if (!git.isRepo) {
+        if (opts.dryRun) {
+            log.info(dim("dry-run — would require a git repository"));
+            return true;
+        }
+        log.error("Not a git repository. Run `vibeops init --git` first.");
+        return false;
+    }
+    if (git.dirty === true && opts.allowDirty !== true) {
+        const gov = await gitGovernanceOnlyDirty(cwd);
+        if (!gov.onlyGovernance) {
+            log.error("Git working tree is dirty. Commit or stash, or rerun with --allow-dirty.");
+            return false;
+        }
+        log.warn("Only governance paths are dirty — proceeding.");
+    }
+    const baseBranch = git.branch ?? (await detectDefaultBranch(cwd)) ?? "main";
+    const baseCommit = (await gitHeadCommit(cwd)) ?? "";
+    if (baseCommit.length === 0) {
+        log.error("No commits on HEAD yet. Create an initial commit first.");
+        return false;
+    }
+    const taskBranch = branchNameForTaskFile(taskFile);
+    const ctx = {
+        baseBranch,
+        baseCommit,
+        taskBranch,
+        startedAt: new Date().toISOString(),
+    };
+    const existingCtx = await readGitContext(taskFile);
+    const branchExists = await gitBranchExists(cwd, taskBranch);
+    log.info(`  ${dim("task branch")}  ${cyan(taskBranch)}`);
+    log.info(`  ${dim("base")}         ${baseBranch} @ ${baseCommit.slice(0, 7)}`);
+    if (opts.dryRun) {
+        log.info(dim(branchExists
+            ? `dry-run — would git switch ${taskBranch}`
+            : `dry-run — would git switch -c ${taskBranch}`));
+        return true;
+    }
+    if (branchExists) {
+        await gitCheckout(cwd, taskBranch);
+        if (meta.status === "planned") {
+            await updateInlineStatus(taskFile, "in_progress");
+        }
+        if (existingCtx === null) {
+            await upsertGitContext(taskFile, ctx);
+        }
+        log.ok(`Resumed ${taskBranch}`);
+    }
+    else {
+        await gitCheckoutNewBranch(cwd, taskBranch, baseBranch);
+        await updateInlineStatus(taskFile, "in_progress");
+        await upsertGitContext(taskFile, ctx);
+        log.ok(`Branch ${taskBranch} ready`);
+    }
+    log.info(`  ${dim("file")}         ${relOrAbs(cwd, taskFile)}`);
+    return true;
+}

package/dist/lib/task-summary.js

@@ -1,27 +1,12 @@
-/**
- * Small text-extraction helpers used by `vibeops notion sync` and
- * `vibeops task pull`.
- *
- * Everything here is read-only (`extract*`) or returns new strings the caller
- * may write back (`upsertNotionPageSection`, `renderPulledTaskMarkdown`).
- *
- * Goal/Background extraction is deliberately heuristic:
- *   - we strip markdown bullet/numbering prefixes,
- *   - we collapse blank-line groups so the first non-empty paragraph wins,
- *   - we truncate to `NOTION_TEXT_LIMIT` (default 1500 chars).
- *
- * We never include placeholder content such as `(not yet)`, legacy localized
- * placeholders, or `(scaffolded ...)`; those become an empty string.
- */
-import { readTextOrNull, writeText } from "./filesystem.js";
 import { isPlaceholderContent, readSection } from "./task.js";
-import { truncate } from "./notion-mappers.js";
-const PLACEHOLDER_RE = new RegExp(String.raw `^\(.*(not yet|fill in|unassigned|scaffold|\uBBF8\uC218\uD589|\uBBF8\uC815|\uCC44\uC6CC\uB77C).*\)$`, "i");
+const PLACEHOLDER_RE = new RegExp(String.raw `^\(.*(not yet|fill in|unassigned|scaffold|\uBBF8\uC218\uD589).*\)$`, "i");
 function stripBullet(line) {
     return line.replace(/^\s*(?:[-*+]|\d+\.)\s+/, "").trim();
 }
-function isHeading(line) {
-    return /^#{1,6}\s+/.test(line);
+function truncate(text, limit) {
+    if (text.length <= limit)
+        return text;
+    return `${text.slice(0, limit - 1)}…`;
 }
 function compressBlank(lines) {
     const out = [];
@@ -39,19 +24,12 @@ function compressBlank(lines) {
     }
     return out.join("\n").trim();
 }
-/**
- * Pull a flattened, single-string summary from a `## Section`. Bullet points
- * and numbered list items are joined with " · ". Placeholder bodies become "".
- */
-export function summarizeSection(body, title, limit) {
+export function summarizeSection(body, title, limit = 280) {
     const raw = readSection(body, title);
-    if (raw.length === 0)
+    if (raw.length === 0 || isPlaceholderContent(raw))
         return "";
-    if (isPlaceholderContent(raw))
-        return "";
-    const lines = raw.split("\n");
     const cleaned = [];
-    for (const line of lines) {
+    for (const line of raw.split("\n")) {
         const t = line.trim();
         if (t.length === 0) {
             cleaned.push("");
@@ -59,218 +37,13 @@ export function summarizeSection(body, title, limit) {
         }
         if (PLACEHOLDER_RE.test(t))
             continue;
-        if (isHeading(t))
+        if (/^#{1,6}\s+/.test(t))
             continue;
         cleaned.push(stripBullet(t));
     }
-    const compact = compressBlank(cleaned);
-    return truncate(compact, limit);
+    return truncate(compressBlank(cleaned), limit);
 }
-export function summarizeGoal(body, limit) {
+export function summarizeGoal(body, limit = 280) {
     const goal = summarizeSection(body, "Goal", limit);
-    if (goal.length > 0)
-        return goal;
-    return summarizeSection(body, "Background", limit);
-}
-export function summarizeResult(body, limit) {
-    return summarizeSection(body, "Result", limit);
-}
-/**
- * Best-effort: pull the very first non-heading paragraph from an arbitrary
- * markdown body (e.g. `docs/project/00-overview.md`). Returns "" if nothing
- * useful is found.
- */
-export function summarizeMarkdownLead(body, limit) {
-    const lines = body.split("\n");
-    const collected = [];
-    let started = false;
-    for (const raw of lines) {
-        const t = raw.trim();
-        if (t.length === 0) {
-            if (started)
-                break;
-            continue;
-        }
-        if (isHeading(t)) {
-            if (started)
-                break;
-            continue;
-        }
-        if (t.startsWith(">"))
-            continue;
-        started = true;
-        collected.push(stripBullet(t));
-    }
-    return truncate(collected.join(" ").trim(), limit);
-}
-/**
- * Heuristic: scan `docs/project/05-current-state.md` (or any markdown) for an
- * "MVP 1 ~ N" hint. Falls back to the first heading-derived MVP token.
- */
-export function detectCurrentPhase(body) {
-    if (body.length === 0)
-        return "";
-    const m = body.match(/MVP\s*\d+(?:\s*[·•:\-]\s*[^\n]+)?/i);
-    if (m)
-        return m[0].trim().replace(/\s+/g, " ");
-    return "";
-}
-export function renderNotionPageBlock(inputs) {
-    return [
-        `- Page ID: \`${inputs.pageId}\``,
-        `- Docs Path: \`${inputs.docsRelativePath}\``,
-    ].join("\n");
-}
-const NOTION_PAGE_RE = /^-\s+Page ID:\s*`([^`]+)`/m;
-export function readNotionPageId(body) {
-    const section = readSection(body, "Notion Page");
-    if (section.length === 0)
-        return null;
-    const m = section.match(NOTION_PAGE_RE);
-    return m ? m[1].trim() : null;
-}
-/**
- * Replace the body of an existing `## Notion Page` section, or append the
- * section to the file if it doesn't exist yet. Returns the new file body
- * (caller is responsible for writing it back).
- */
-export function upsertNotionPageSection(body, inputs) {
-    const block = renderNotionPageBlock(inputs);
-    const HEADING_RE = /^(##+)\s+(.+?)\s*$/;
-    const lines = body.split("\n");
-    let startIdx = -1;
-    let endIdx = -1;
-    let level = 2;
-    for (let i = 0; i < lines.length; i++) {
-        const m = HEADING_RE.exec(lines[i]);
-        if (!m)
-            continue;
-        if (m[2].trim().toLowerCase() !== "notion page")
-            continue;
-        startIdx = i;
-        level = m[1].length;
-        let j = i + 1;
-        while (j < lines.length) {
-            const nm = HEADING_RE.exec(lines[j]);
-            if (nm && nm[1].length <= level)
-                break;
-            j++;
-        }
-        endIdx = j;
-        break;
-    }
-    if (startIdx < 0) {
-        const trimmed = body.replace(/\s+$/u, "");
-        return `${trimmed}\n\n## Notion Page\n\n${block}\n`;
-    }
-    const before = lines.slice(0, startIdx + 1);
-    const after = lines.slice(endIdx);
-    return [...before, "", block, "", ...after].join("\n").replace(/\n{3,}/g, "\n\n");
-}
-export async function writeNotionPageSection(filePath, inputs) {
-    const current = await readTextOrNull(filePath);
-    if (current === null)
-        return false;
-    const next = upsertNotionPageSection(current, inputs);
-    if (next === current)
-        return false;
-    await writeText(filePath, next);
-    return true;
-}
-/**
- * Render the markdown body for a TASK file that `vibeops task pull` is
- * creating from a Notion row. Always uses the 18-section skeleton so the
- * downstream `vibeops task done` validation can still run.
- *
- * Only the fields Notion actually carries get prefilled; everything else
- * stays a placeholder.
- */
-export function renderPulledTaskMarkdown(inputs) {
-    const title = inputs.title.length > 0 ? inputs.title : "(pulled from Notion — fill in)";
-    const status = inputs.status.length > 0 ? inputs.status : "planned";
-    const phase = inputs.mvpPhase.length > 0 ? inputs.mvpPhase : "(unassigned)";
-    const summary = inputs.summary.length > 0 ? inputs.summary : "(Notion Summary is empty — fill in.)";
-    const notionBlock = renderNotionPageBlock({
-        pageId: inputs.pageId,
-        docsRelativePath: inputs.docsRelativePath,
-    });
-    return `# ${inputs.taskId} · ${title}
-
-> This file was generated by \`vibeops task pull\` from Notion metadata. The body is empty — the Builder/Planner Agent should fill it in.
-
-## Status
-
-${status}
-
-## MVP Phase
-
-${phase}
-
-## Goal
-
-${summary}
-
-## Background
-
-(pulled — fill in context beyond the Notion Summary.)
-
-## Scope
-
-- (pulled — Scope item 1)
-- (pulled — Scope item 2)
-
-## Out of Scope
-
-- (pulled)
-
-## Acceptance Criteria
-
-1. (pulled — verifiable statement 1)
-2. (pulled — verifiable statement 2)
-
-## Files to Inspect First
-
-- (pulled)
-
-## Expected Files to Change
-
-- new: (pulled)
-- update: (pulled)
-
-## Risks
-
-- (pulled)
-
-## Test Plan
-
-- (pulled)
-
-## Rollback Plan
-
-- (pulled)
-
-## Git Context
-
-(populated by \`vibeops task start ${inputs.taskId}\`)
-
-## Notion Page
-
-${notionBlock}
-
-## Implementation Plan
-
-1. (pulled)
-
-## Result
-
-(not yet)
-
-## Test Result
-
-(not yet)
-
-## Review Notes
-
-(not yet)
-`;
+    return goal.length > 0 ? goal : summarizeSection(body, "Scope", limit);
 }