@goodtek/vibeops 0.7.22 → 1.0.0

package/templates/docs/project/03-architecture.md

@@ -1,34 +1,15 @@
-# 03 — Architecture
+# Architecture
 
-> Filled in by the `architect` agent.
+> Living overview. Update when structure or major paths change (often via `vibeops task done`).
 
-## Big picture
+## System
 
-<!--
-Use an ASCII diagram to draw the "inside / outside the system" boundary.
-Flows like user → frontend → backend → DB / external services.
--->
+(describe stack and main folders as the project grows)
 
-## Components
+## Key paths
 
-<!--
-| Name        | Responsibility           | Inputs        | Outputs       |
-| ----------- | ------------------------ | ------------- | ------------- |
-| component-a | ...                      | ...           | ...           |
--->
-
-## Data model
-
-<!-- The 3 to 7 core entities and how they relate. Field-level detail belongs to a separate TASK. -->
-
-## Data flow
-
-<!-- The call sequence for the 1 to 2 most common user scenarios. -->
-
-## External boundaries
-
-<!-- Which external services / APIs we talk to. Auth method, public or private. -->
-
-## Non-deterministic / failure paths
-
-<!-- High-level behavior under network failures, concurrency, data loss. -->
+| Area | Path |
+|------|------|
+| Application | (TBD) |
+| TASK docs | `docs/tasks/` |
+| Project memory | `docs/project/` |

package/templates/docs/project/05-current-state.md

@@ -1,35 +1,15 @@
-# 05 — Current State
+# Current state
 
-> Record **facts only**. The `docs` agent refreshes this document after each implementation.
+> Facts only. Updated by `vibeops task done` and humans.
 
 ## Stage
 
-- **Current stage**: bootstrap complete. Planning and implementation have not started yet.
-- No code (`src/`, `package.json`, …) exists yet.
+- Bootstrapped with VibeOps. No TASK started yet.
 
-## What is in place
+## Active TASK
 
-| Item              | Location                              | Notes                       |
-| ----------------- | ------------------------------------- | --------------------------- |
-| Operating guide   | `AGENTS.md`, `.cursor/rules/*`        | Installed by VibeOps        |
-| Agent definitions | `.vibeops/agents/*`                   | 8 agents                    |
-| Project docs      | `docs/project/00 ~ 09`                | Empty (waiting for plan)    |
-| TASK folder       | `docs/tasks/`                         | Empty (waiting for generate) |
-| Logs folder       | `docs/logs/`                          | Empty                       |
+(none)
 
-## What is missing
+## Next step
 
-- The actual bodies of `docs/project/*` (planner / architect will fill these in).
-- `docs/tasks/TASK-001-*.md` (`task generate`).
-- Any code at all.
-- Notion connection (run `vibeops notion init` if desired).
-
-## Next TASK
-
-**The backlog is empty.** Run `vibeops plan --idea "<your idea>"` to fill in `docs/project/{00,01,02,07}`; the first TASK candidates fall out of that.
-
-## Working rules (short summary)
-
-- Implement **one TASK at a time**.
-- Every mutating command should support `--dry-run` when possible.
-- After implementation, update this document, the TASK file, and `docs/logs/YYYY-MM-DD.md` together.
+Run `vibeops task add` to create the first TASK.

package/templates/docs/project/06-decisions.md

@@ -1,20 +1,9 @@
-# 06 — Decisions
+# Decisions
 
-Decisions that have already been made. A conflicting proposal changes them only after a separate TASK reopens the discussion.
+> Append-only log. Add bullets when a TASK locks a choice — do not rewrite history.
 
-## D-001 · Source of truth is Git `docs/`
+## D-001 · VibeOps workflow
 
-Chat is not trusted. When docs and chat disagree, fix the docs first, then implement.
-
-## D-002 · One TASK at a time
-
-Large refactors do not happen without a dedicated TASK.
-
-## D-003 · Notion is the human dashboard (metadata only)
-
-No body sync. No realtime.
-
-<!--
-Add later decisions as `D-NNN · one-line summary`.
-Keep each entry short — one paragraph that covers "why" and "result".
--->
+- **Date:** {{CREATED_AT}}
+- **Decision:** TASK-driven development with `vibeops task add` / `task done` and Cursor for plan/build.
+- **Why:** Git `docs/tasks` beats chat as source of truth.

package/templates/docs/tasks/TASK-000-template.md

@@ -1,67 +1,32 @@
-# TASK-NNN · <one-line title>
-
-> This file is an example produced from VibeOps' `TASK-000-template.md`.
-> Real TASKs come from `vibeops plan` (TASK-mvp), `vibeops task add` (work-now slice), or your backlog process. Filenames follow `TASK-NNN-<slug>.md`.
+# TASK-NNN · title
 
 ## Status
 
-planned
-
-## MVP Phase
-
-MVP 1 · <phase name>
+Planned
 
 ## Goal
 
-<2 to 4 sentences. What becomes possible when this TASK ships.>
-
-## Background
-
-<Why this is needed now. Which prior decisions / TASKs this builds on.>
+(what becomes possible when this TASK ships)
 
 ## Scope
 
-- <bullet 1>
-- <bullet 2>
+- 
 
 ## Out of Scope
 
-- <explicit exclusion 1>
-- <explicit exclusion 2>
+- 
 
 ## Acceptance Criteria
 
-1. <verifiable statement>
-2. <verifiable statement>
-
-## Files to Inspect First
-
-- <path 1>
-- <path 2>
-
-## Expected Files to Change
-
-- new: <path>
-- update: <path>
-
-## Risks
-
-- <risk 1 and mitigation>
-- <risk 2 and mitigation>
+1. 
 
 ## Test Plan
 
-- <command / case 1>
-- <command / case 2>
-
-## Rollback Plan
-
-- <how to roll back>
+- 
 
-## Implementation Plan
+## Git Context
 
-1. <step 1>
-2. <step 2>
+(populated by `vibeops task add`)
 
 ## Result
 

package/dist/agent/loader.js

@@ -1,71 +0,0 @@
-import { readdir } from "node:fs/promises";
-import { basename, extname, join } from "node:path";
-import matter from "gray-matter";
-import { isDirectory, readText } from "../lib/filesystem.js";
-function metaFromFile(filePath, data, body) {
-    const fallbackName = basename(filePath, extname(filePath));
-    const name = typeof data["name"] === "string" ? data["name"] : fallbackName;
-    const role = typeof data["role"] === "string" ? data["role"] : extractFirstHeading(body);
-    const description = typeof data["description"] === "string" ? data["description"] : undefined;
-    return { name, role, description, filePath };
-}
-function extractFirstHeading(body) {
-    for (const line of body.split("\n")) {
-        const m = /^#\s+(.*)$/.exec(line.trim());
-        if (m)
-            return m[1].trim();
-    }
-    return "(no role)";
-}
-function frontmatterSlice(raw) {
-    if (!raw.startsWith("---"))
-        return "";
-    const end = raw.indexOf("\n---", 3);
-    if (end < 0)
-        return "";
-    return raw.slice(0, end + 4);
-}
-export async function loadAgent(filePath) {
-    const raw = await readText(filePath);
-    const parsed = matter(raw);
-    const meta = metaFromFile(filePath, parsed.data, parsed.content);
-    return {
-        meta,
-        body: parsed.content.trimStart(),
-        rawFrontmatter: frontmatterSlice(raw),
-        raw,
-    };
-}
-export async function listAgents(agentsDir) {
-    if (!(await isDirectory(agentsDir)))
-        return [];
-    const entries = await readdir(agentsDir, { withFileTypes: true });
-    const files = entries
-        .filter((e) => e.isFile() && e.name.endsWith(".md"))
-        .map((e) => join(agentsDir, e.name))
-        .sort();
-    const records = [];
-    for (const f of files) {
-        try {
-            records.push(await loadAgent(f));
-        }
-        catch {
-            // skip malformed agent files
-        }
-    }
-    return records;
-}
-export async function findAgent(agentsDir, name) {
-    const all = await listAgents(agentsDir);
-    const target = name.toLowerCase();
-    for (const a of all) {
-        if (a.meta.name.toLowerCase() === target)
-            return a;
-    }
-    for (const a of all) {
-        const filenameKey = basename(a.meta.filePath, extname(a.meta.filePath)).toLowerCase();
-        if (filenameKey === target)
-            return a;
-    }
-    return null;
-}

package/dist/agent/prompt.js

@@ -1,66 +0,0 @@
-import { relative } from "node:path";
-import { readText } from "../lib/filesystem.js";
-function relOrAbs(root, p) {
-    const r = relative(root, p);
-    return r === "" ? "." : r.startsWith("..") ? p : r;
-}
-function header(inputs) {
-    const lines = [];
-    lines.push(`# Cursor prompt — agent: ${inputs.agent.meta.name}`);
-    lines.push("");
-    if (inputs.config) {
-        lines.push(`Project: \`${inputs.config.name}\``);
-        lines.push(`VibeOps: \`${inputs.config.vibeopsVersion}\``);
-    }
-    else {
-        lines.push("Project: (no .vibeops.json found — running outside a VibeOps project)");
-    }
-    if (inputs.task) {
-        lines.push(`TASK: \`${inputs.task.meta.id}\``);
-        lines.push(`TASK file: \`${relOrAbs(inputs.projectRoot, inputs.task.meta.filePath)}\``);
-    }
-    lines.push("");
-    return lines.join("\n");
-}
-function agentSection(agent) {
-    return `## Agent definition (${agent.meta.name})\n\n${agent.body.trim()}\n`;
-}
-function taskSection(task) {
-    return `## TASK file content\n\n${task.body.trim()}\n`;
-}
-async function contextSection(paths, projectRoot) {
-    if (paths.length === 0)
-        return "";
-    const parts = ["## Extra context\n"];
-    for (const p of paths) {
-        try {
-            const text = await readText(p);
-            parts.push(`### ${relOrAbs(projectRoot, p)}\n\n\`\`\`\n${text}\n\`\`\`\n`);
-        }
-        catch {
-            parts.push(`### ${relOrAbs(projectRoot, p)}\n\n_(could not read file)_\n`);
-        }
-    }
-    return parts.join("\n");
-}
-const FOOTER = `---
-
-Apply the **Role / Inputs / Output Format / Rules / Forbidden** sections of the agent definition above as-is.
-Your output must be a single markdown blob that pastes cleanly into the Cursor chat.
-
-When done, follow the "Completion report" format in \`AGENTS.md\`:
-TASK ID · summary · changed files · verification · doc updates (05-current-state / TASK / docs/logs).
-`;
-export async function buildPrompt(inputs) {
-    const parts = [
-        header(inputs),
-        agentSection(inputs.agent),
-    ];
-    if (inputs.task)
-        parts.push(taskSection(inputs.task));
-    const extra = await contextSection(inputs.contextPaths ?? [], inputs.projectRoot);
-    if (extra.length > 0)
-        parts.push(extra);
-    parts.push(FOOTER);
-    return parts.join("\n");
-}

package/dist/commands/agent-list.js

@@ -1,32 +0,0 @@
-import { resolve } from "node:path";
-import { listAgents } from "../agent/loader.js";
-import { bold, dim, log } from "../lib/logger.js";
-import { projectPaths } from "../lib/paths.js";
-export async function agentListCommand(options = {}) {
-    const cwd = resolve(options.cwd ?? process.cwd());
-    const paths = projectPaths(cwd);
-    const agents = await listAgents(paths.vibeopsAgents);
-    if (options.json) {
-        const payload = agents.map((a) => ({
-            name: a.meta.name,
-            role: a.meta.role,
-            description: a.meta.description ?? null,
-            filePath: a.meta.filePath,
-        }));
-        log.raw(`${JSON.stringify(payload, null, 2)}\n`);
-        return;
-    }
-    if (agents.length === 0) {
-        log.warn(`No agents found in ${paths.vibeopsAgents}`);
-        log.info(dim("Run `vibeops init` first."));
-        process.exitCode = 1;
-        return;
-    }
-    log.info(bold("Agents"));
-    const nameWidth = Math.max(...agents.map((a) => a.meta.name.length));
-    for (const a of agents) {
-        const padded = a.meta.name.padEnd(nameWidth);
-        const summary = a.meta.description ?? a.meta.role;
-        log.info(`  ${padded}  ${dim(summary)}`);
-    }
-}

package/dist/commands/agent-prompt.js

@@ -1,59 +0,0 @@
-import { resolve } from "node:path";
-import { findAgent, listAgents } from "../agent/loader.js";
-import { buildPrompt } from "../agent/prompt.js";
-import { readConfig } from "../lib/config.js";
-import { readText } from "../lib/filesystem.js";
-import { log } from "../lib/logger.js";
-import { projectPaths } from "../lib/paths.js";
-import { readTaskFile, scanTasks } from "../lib/task.js";
-async function locateTaskFile(tasksDir, taskId) {
-    const all = await scanTasks(tasksDir);
-    const target = taskId.toUpperCase();
-    for (const t of all) {
-        if (t.id.toUpperCase() === target)
-            return t.filePath;
-    }
-    return null;
-}
-export async function agentPromptCommand(name, taskId, options = {}) {
-    const cwd = resolve(options.cwd ?? process.cwd());
-    const paths = projectPaths(cwd);
-    const agent = await findAgent(paths.vibeopsAgents, name);
-    if (!agent) {
-        const available = (await listAgents(paths.vibeopsAgents)).map((a) => a.meta.name);
-        log.error(`Unknown agent: "${name}".`);
-        if (available.length > 0) {
-            log.info(`Available: ${available.join(", ")}`);
-        }
-        else {
-            log.info(`No agents installed in ${paths.vibeopsAgents}. Run \`vibeops init\` first.`);
-        }
-        process.exitCode = 1;
-        return;
-    }
-    const config = await readConfig(paths.root);
-    let task;
-    const looksLikeTaskId = /^TASK-\d+/i.test(taskId);
-    if (looksLikeTaskId) {
-        const filePath = await locateTaskFile(paths.docsTasks, taskId);
-        if (!filePath) {
-            log.error(`TASK not found: ${taskId} (looked in ${paths.docsTasks})`);
-            process.exitCode = 1;
-            return;
-        }
-        const meta = await readTaskFile(filePath);
-        const body = await readText(filePath);
-        task = { meta, body };
-    }
-    else if (taskId !== "(unspecified)" && taskId.length > 0) {
-        log.warn(`"${taskId}" does not look like a TASK id (expected TASK-NNN). Continuing without TASK context.`);
-    }
-    const prompt = await buildPrompt({
-        agent,
-        config,
-        task,
-        projectRoot: paths.root,
-        contextPaths: options.context ?? [],
-    });
-    log.raw(prompt.endsWith("\n") ? prompt : `${prompt}\n`);
-}

package/dist/commands/agent-show.js

@@ -1,26 +0,0 @@
-import { resolve } from "node:path";
-import { findAgent, listAgents } from "../agent/loader.js";
-import { log } from "../lib/logger.js";
-import { projectPaths } from "../lib/paths.js";
-export async function agentShowCommand(name, options = {}) {
-    const cwd = resolve(options.cwd ?? process.cwd());
-    const paths = projectPaths(cwd);
-    const agent = await findAgent(paths.vibeopsAgents, name);
-    if (!agent) {
-        const available = (await listAgents(paths.vibeopsAgents)).map((a) => a.meta.name);
-        log.error(`Unknown agent: "${name}".`);
-        if (available.length > 0) {
-            log.info(`Available: ${available.join(", ")}`);
-        }
-        else {
-            log.info(`No agents installed in ${paths.vibeopsAgents}. Run \`vibeops init\` first.`);
-        }
-        process.exitCode = 1;
-        return;
-    }
-    if (options.raw) {
-        log.raw(agent.raw.endsWith("\n") ? agent.raw : `${agent.raw}\n`);
-        return;
-    }
-    log.raw(agent.body.endsWith("\n") ? agent.body : `${agent.body}\n`);
-}

package/dist/commands/done.js

@@ -1,160 +0,0 @@
-import { relative, resolve } from "node:path";
-import { askYesNo } from "../lib/inquirer-helpers.js";
-import { readText } from "../lib/filesystem.js";
-import { bold, dim, green, log, yellow } from "../lib/logger.js";
-import { writeDoneSummary } from "../lib/mvp-done-summary.js";
-import { mergeTaskBranch } from "../lib/task-merge.js";
-import { projectPaths } from "../lib/paths.js";
-import { commandTaskNotFoundMessage, resolveCommandTask, } from "../lib/resolve-command-task.js";
-import { hasNonEmptySection, parseTaskFilename, readGitContext, readTaskFile, updateInlineStatus, } from "../lib/task.js";
-import { runDoneFollowUp } from "../lib/done-follow-up.js";
-import { gitAddPaths, listWorkingTreeRelPaths, partitionPathsForAutoCommit, readGitInfo, runGit, } from "../lib/git.js";
-function relOrAbs(root, p) {
-    const r = relative(root, p);
-    return r === "" ? "." : r.startsWith("..") ? p : r;
-}
-function commitMessageFor(taskId, title) {
-    const trimmed = (title || taskId).trim();
-    const slug = trimmed.replace(/^TASK-(?:\d+|mvp)\s*[·:\-]\s*/i, "").trim() || trimmed;
-    return `feat(${taskId.toLowerCase()}): ${slug}`;
-}
-async function tryCommitDirty(cwd, message, dryRun) {
-    const git = await readGitInfo(cwd);
-    if (!git.isRepo || git.dirty !== true)
-        return false;
-    const { committable, excluded } = partitionPathsForAutoCommit(await listWorkingTreeRelPaths(cwd), { unmerged: [] });
-    if (committable.length === 0) {
-        if (excluded.length > 0) {
-            log.warn("Dirty tree is only node_modules/.next-style paths — add them to .gitignore; commit skipped.");
-        }
-        return false;
-    }
-    if (excluded.length > 0) {
-        log.warn(`Skipping ${excluded.length} build/install path(s) from auto-commit (e.g. ${excluded[0]}).`);
-    }
-    if (dryRun) {
-        log.info(dim(`  would: git add (${committable.length} paths) && git commit -m "${message}"`));
-        return true;
-    }
-    try {
-        await gitAddPaths(cwd, committable);
-        await runGit(cwd, ["commit", "-q", "-m", message]);
-        log.ok(`Committed: ${message}`);
-        return true;
-    }
-    catch (e) {
-        const msg = e instanceof Error ? e.message : String(e);
-        log.warn(`Commit skipped (${msg}).`);
-        return false;
-    }
-}
-/** Finalize TASK-mvp: auto-fill Result/Test Result, summary md, merge, Notion. */
-export async function doneCommand(taskRef, options = {}) {
-    const cwd = resolve(options.cwd ?? process.cwd());
-    const paths = projectPaths(cwd);
-    const dryRun = options.dryRun === true;
-    const interactive = !dryRun && process.stdin.isTTY === true;
-    const resolved = await resolveCommandTask(paths, cwd, taskRef);
-    if (resolved === null) {
-        log.error(commandTaskNotFoundMessage(taskRef));
-        process.exitCode = 1;
-        return;
-    }
-    const { taskFile, source } = resolved;
-    if (source === "backlog-active") {
-        log.info(dim(`No TASK-mvp — using ${resolved.taskId}.`));
-    }
-    const meta = await readTaskFile(taskFile);
-    log.info(bold(`vibeops done ${meta.id}`));
-    log.info(`  ${dim("file")}  ${relOrAbs(cwd, taskFile)}`);
-    log.blank();
-    if (options.skipSummary !== true) {
-        log.step(bold("Summary + TASK sections"));
-        await writeDoneSummary({
-            cwd,
-            taskId: meta.id,
-            taskTitle: meta.title,
-            taskFile,
-            dryRun,
-            refreshTaskSections: options.refreshTaskSections === true,
-        });
-        log.blank();
-    }
-    const body = await readText(taskFile);
-    const resultOk = hasNonEmptySection(body, "Result");
-    const testResultOk = hasNonEmptySection(body, "Test Result");
-    log.info(bold("Required sections"));
-    let missing = 0;
-    for (const [label, ok] of [
-        ["Result", resultOk],
-        ["Test Result", testResultOk],
-    ]) {
-        if (!ok)
-            missing++;
-        log.info(`  ${ok ? green("✓") : yellow("·")} ${label}`);
-    }
-    log.blank();
-    if (missing > 0) {
-        log.error(`Could not auto-fill Result / Test Result. Connect Codex OAuth, Cursor Agent CLI, or OPENAI_API_KEY — or fill sections manually.`);
-        process.exitCode = 1;
-        return;
-    }
-    if (dryRun) {
-        log.info(bold("dry-run — would:"));
-        log.info(`  · Status → Done`);
-        log.info(`  · commit if dirty, then merge (unless --no-merge)`);
-        log.info(`  · Notion sync (if enabled)`);
-        await runDoneFollowUp({
-            cwd,
-            taskFile,
-            taskTitle: meta.title,
-            dryRun: true,
-            noNotionSync: options.noNotionSync,
-            interactive,
-        });
-        return;
-    }
-    await updateInlineStatus(taskFile, "done");
-    log.ok(`Status → Done`);
-    const parts = parseTaskFilename(taskFile);
-    const commitMsg = commitMessageFor(parts.id, meta.title);
-    await tryCommitDirty(cwd, commitMsg, false);
-    const gitCtx = await readGitContext(taskFile);
-    if (options.noMerge !== true && gitCtx !== null) {
-        let doMerge = !interactive;
-        if (interactive) {
-            doMerge = await askYesNo({
-                message: `Push, merge into ${gitCtx.baseBranch}, and delete ${gitCtx.taskBranch}?`,
-                nonInteractive: false,
-                defaultValue: true,
-            });
-        }
-        if (doMerge) {
-            const mergeResult = await mergeTaskBranch({
-                cwd,
-                taskId: meta.id,
-                taskTitle: meta.title,
-                gitCtx,
-                mode: options.mergeViaPr === true ? "pr" : "direct",
-                allowDirty: options.allowDirty,
-            });
-            if (!mergeResult.ok) {
-                process.exitCode = 1;
-            }
-        }
-        else {
-            log.info(dim("Merge skipped — run `vibeops next` later."));
-        }
-    }
-    else if (gitCtx === null) {
-        log.info(dim("No Git Context — merge skipped. Run `vibeops start` before the next MVP."));
-    }
-    await runDoneFollowUp({
-        cwd,
-        taskFile,
-        taskTitle: meta.title,
-        dryRun: false,
-        noNotionSync: options.noNotionSync,
-        interactive,
-    });
-}