@goodtek/vibeops 1.1.1 → 2.0.0

package/dist/lib/task.js

@@ -155,6 +155,13 @@ export function pickLatestDoneTask(tasks) {
         return null;
     return [...done].sort((a, b) => taskSortKey(b.id) - taskSortKey(a.id))[0];
 }
+/** Latest TASK in Review (awaiting merge / sync). */
+export function pickLatestReviewTask(tasks) {
+    const review = filterActionableTasks(tasks).filter((t) => t.status === "review");
+    if (review.length === 0)
+        return null;
+    return [...review].sort((a, b) => taskSortKey(b.id) - taskSortKey(a.id))[0];
+}
 export async function loadActionableTasks(tasksDir) {
     return filterActionableTasks(await scanTasks(tasksDir));
 }

package/package.json

@@ -1,9 +1,8 @@
 {
   "name": "@goodtek/vibeops",
-  "version": "1.1.1",
+  "version": "2.0.0",
   "description": "Minimal CLI rails for Cursor-based TASK-driven vibe coding.",
   "type": "module",
-  "packageManager": "pnpm@9.15.9",
   "author": "VibeOps contributors",
   "license": "MIT",
   "repository": {
@@ -30,16 +29,6 @@
   "engines": {
     "node": ">=20"
   },
-  "scripts": {
-    "dev": "tsx src/cli.ts",
-    "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "start": "node dist/cli.js",
-    "smoke": "pnpm typecheck && pnpm build && node scripts/smoke.mjs",
-    "clean": "rm -rf dist",
-    "prepack": "pnpm clean && pnpm build",
-    "publish:dry": "pnpm publish --dry-run --no-git-checks"
-  },
   "keywords": [
     "cursor",
     "ai",
@@ -58,5 +47,14 @@
     "@types/node": "^20.14.0",
     "tsx": "^4.19.0",
     "typescript": "^5.5.4"
+  },
+  "scripts": {
+    "dev": "tsx src/cli.ts",
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "start": "node dist/cli.js",
+    "smoke": "pnpm typecheck && pnpm build && node scripts/smoke.mjs",
+    "clean": "rm -rf dist",
+    "publish:dry": "pnpm publish --dry-run --no-git-checks"
   }
-}
+}

package/templates/clients/claude/CLAUDE.md

@@ -1,28 +1,6 @@
-# {{PROJECT_NAME}} — Claude Code
+# Claude Code — VibeOps
 
-Read **`AGENTS.md`** first (VibeOps workflow and source of truth).
-
-## Skills (project)
-
-| Skill | When |
-|-------|------|
-| `/plan-task` | Refine `docs/tasks/TASK-NNN-*.md` before coding |
-| `/implement-task` | Build per TASK Scope and Acceptance Criteria |
-
-Skills live in `.claude/skills/`.
-
-## Session start
-
-1. `docs/project/05-current-state.md`
-2. The **full** current `docs/tasks/TASK-NNN-*.md` file
-3. `docs/project/03-architecture.md` and `06-decisions.md` when relevant
-
-## Git
-
-- Branch: `task/*` from `vibeops task add`
-- Commit messages include the TASK id, e.g. `feat(task-015): short title`
-- Do not merge to main unless the human runs `vibeops task done` or asks
-
-## Finishing
-
-Fill **Result** and **Test Result** in the TASK file, then tell the human to run `vibeops task done TASK-NNN`.
+- Work from `docs/tasks/TASK-NNN-*.md` only.
+- One TASK at a time.
+- Fill **Result** and **Test Result** before telling the human to run `vibeops task ship TASK-NNN`.
+- Do not merge to integration or main unless the human runs `vibeops task merge` / `task release`.

package/templates/clients/cursor/.cursor/rules/02-git-safety.mdc

@@ -1,11 +1,11 @@
 ---
-description: Git safety for task branches and commits
+description: Git safety for TASK branches
 alwaysApply: true
 ---
 
 # Git safety
 
-- Use branch pattern `task/*` created by `vibeops task add`.
-- Include the TASK id in commit messages, e.g. `feat(task-015): short title`.
-- **No force-push** to shared branches (`main`, `master`).
-- Do not merge or push unless the human runs `vibeops task done` or asks explicitly.
+- Use branch pattern `task/*` from `vibeops task add`.
+- Include TASK id in commits: `feat(task-nnn): …`.
+- No force-push to shared branches.
+- Run `vibeops task ship`, `task merge`, `task sync` when the human asks — do not merge locally in the IDE unless requested.

package/templates/clients/cursor/.cursor/rules/03-docs-before-ship.mdc

@@ -0,0 +1,13 @@
+---
+description: Update TASK Result and project memory before shipping
+alwaysApply: true
+---
+
+# Docs before task ship
+
+Before `vibeops task ship`:
+
+1. Fill **Result** and **Test Result** in the TASK file (paths, commands, outcomes — facts only).
+2. If architecture or decisions changed, note them in the TASK; `task ship` can update `docs/project/*` via LLM.
+
+Do not ship with placeholder `(not yet)` sections.

package/templates/core/AGENTS.md

@@ -1,44 +1,26 @@
-# {{PROJECT_NAME}} — AI agent guide
+# Project — AI Agent Guide
 
-> Installed by **VibeOps**. Agents read this repo and `docs/tasks/`, not chat history.
+> Installed by VibeOps. Read before coding.
 
-## Source of truth
+## TASK workflow
 
-| What | Where |
-|------|--------|
-| Current work | `docs/tasks/TASK-NNN-*.md` |
-| Project memory | `docs/project/05-current-state.md`, `03-architecture.md`, `06-decisions.md` |
-| Change history | Git commits on task branches |
-| **Not** trusted | Chat history, Slack |
-
-## Before you code
+```bash
+vibeops task add
+# Plan / build in your agent (@docs/tasks/TASK-NNN-*.md)
 
-1. `docs/project/05-current-state.md`
-2. `docs/project/03-architecture.md` and `06-decisions.md` when relevant
-3. **The full current TASK file** under `docs/tasks/`
+vibeops task ship
+vibeops task merge
+vibeops task sync
+```
 
-## Workflow (human + CLI)
+Optional release to production: `vibeops task release`.
 
 ```bash
-vibeops init              # once (pick Cursor / Claude Code / Codex packs)
-vibeops task add          # new TASK + branch
-# Plan: refine TASK file with your agent (see client skills below)
-# Build: implement per TASK Scope / Acceptance Criteria
-vibeops task done         # close TASK, update project docs, merge
-vibeops status            # briefing
-vibeops llm connect       # LLM for task add / task done
+vibeops llm connect   # optional — task add / task ship
 ```
 
-## Client packs (installed at init)
-
-| Tool | Rules / guide | Skills |
-|------|----------------|--------|
-| **Cursor** | `.cursor/rules/` | `.cursor/skills/` (`plan-task`, `implement-task`) |
-| **Claude Code** | `CLAUDE.md` | `.claude/skills/` |
-| **Codex CLI** | `AGENTS.md` (this file) | `.agents/skills/` |
-
-## Rules (all agents)
+## Rules
 
-- **One TASK at a time** — stay inside Scope and Acceptance Criteria.
-- **Search** before adding files; reuse existing patterns.
-- Fill **Result** and **Test Result** before `vibeops task done`.
+- One TASK at a time; scope from `docs/tasks/TASK-NNN-*.md`.
+- Fill **Result** and **Test Result** before `vibeops task ship`.
+- Agents do not merge or sync unless the human asks.

package/templates/core/docs/logs/README.md

@@ -2,6 +2,6 @@
 
 Append-only files: `docs/logs/YYYY-MM-DD.md`.
 
-`vibeops task done` may append a short entry when a TASK closes.
+`vibeops task ship` may append a short entry via LLM when shipping a TASK.
 
 Keep entries factual: TASK id, paths touched, commands run.

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

@@ -1,6 +1,6 @@
 # Architecture
 
-> Living overview. Update when structure or major paths change (often via `vibeops task done`).
+> Living overview. Update when structure or major paths change (often via `vibeops task ship`).
 
 ## System
 

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

@@ -1,6 +1,6 @@
 # Current state
 
-> Facts only. Updated by `vibeops task done` and humans.
+> Facts only. Updated by `vibeops task ship` / humans; stage changes on `task sync`.
 
 ## Stage
 

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

@@ -5,5 +5,5 @@
 ## D-001 · VibeOps workflow
 
 - **Date:** {{CREATED_AT}}
-- **Decision:** TASK-driven development with `vibeops task add` / `task done` and Cursor for plan/build.
+- **Decision:** TASK-driven development with `vibeops task add` / `task ship` / `merge` / `sync` and Cursor for plan/build.
 - **Why:** Git `docs/tasks` beats chat as source of truth.

package/templates/skills-shared/implement-task/SKILL.md

@@ -1,22 +1,13 @@
 ---
 name: implement-task
-description: Implements the current VibeOps TASK per Scope and Acceptance Criteria. Use when building features for docs/tasks/TASK-NNN.md.
-disable-model-invocation: true
+description: Implement the current VibeOps TASK file in the repo.
 ---
 
-# Implement a TASK
+# Implement TASK
 
-## Read first
+1. Read the full `docs/tasks/TASK-NNN-*.md` (Scope, Acceptance Criteria, Test Plan).
+2. Search the codebase before adding new patterns.
+3. Implement only within the TASK scope.
+4. Do not run `vibeops task ship`, `merge`, or `sync` — the human runs the CLI lifecycle.
 
-1. `AGENTS.md` and your agent rules (e.g. `.cursor/rules/`, `CLAUDE.md`)
-2. `docs/project/05-current-state.md`, `03-architecture.md`, `06-decisions.md`
-3. The TASK file referenced by the human
-
-## Instructions
-
-1. Work **only** within Scope and Acceptance Criteria.
-2. Search the repo before adding files; match existing patterns.
-3. Fill **Result** and **Test Result** with facts when done.
-4. Do not run `vibeops task done` or merge — the human closes the TASK.
-
-Tell the human to run `vibeops task done TASK-NNN` when ready.
+When implementation is ready, tell the human to run `vibeops task ship TASK-NNN`.

package/templates/.cursor/rules/02-git-safety.mdc

@@ -1,12 +0,0 @@
----
-description: Git safety for task branches and merge requests
-alwaysApply: true
----
-
-# Git safety
-
-- Branch policy lives in `.vibeops.json` (`integrationBranch`, `productionBranch`).
-- `vibeops task add` creates `task/*` from the **integration** branch (e.g. `develop`).
-- Include the TASK id in commit messages, e.g. `feat(task-015): short title`.
-- **`vibeops task done`** pushes the branch and opens an MR/PR — it does **not** merge locally.
-- Merge on GitHub/GitLab; CI deploys after merge. No force-push to shared branches.

package/templates/AGENTS.md

@@ -1,38 +0,0 @@
-# {{PROJECT_NAME}} — AI agent guide
-
-> Installed by **VibeOps**. Cursor reads this repo, not chat history.
-
-## Source of truth
-
-| What | Where |
-|------|--------|
-| Current work | `docs/tasks/TASK-NNN-*.md` |
-| Project memory | `docs/project/05-current-state.md`, `03-architecture.md`, `06-decisions.md` |
-| Change history | Git commits on task branches |
-| **Not** trusted | Cursor chat, Slack |
-
-## Before you code
-
-1. `docs/project/05-current-state.md`
-2. `docs/project/03-architecture.md` and `06-decisions.md` when relevant
-3. **The full current TASK file** under `docs/tasks/`
-
-## Workflow (human + CLI)
-
-```bash
-vibeops init              # once
-vibeops task add          # new TASK + branch
-# Plan in Cursor Ask: @docs/tasks/TASK-NNN-….md
-# Build in Cursor Agent: same file + Scope / Acceptance Criteria
-vibeops task done         # close TASK, update project docs, push + open MR/PR
-vibeops status            # briefing
-vibeops llm connect       # set up LLM providers and pick default
-```
-
-## Rules
-
-- **One TASK at a time** — stay inside Scope and Acceptance Criteria.
-- **Search** before adding files; reuse existing patterns.
-- When the TASK is finished, **Result** and **Test Result** must be filled before `vibeops task done`.
-
-Details: `.cursor/rules/`.

package/templates/clients/cursor/.cursor/rules/03-docs-on-done.mdc

@@ -1,13 +0,0 @@
----
-description: Update TASK Result and project memory when finishing work
-alwaysApply: true
----
-
-# Docs when finishing a TASK
-
-Before `vibeops task done`:
-
-1. Fill **Result** and **Test Result** in the TASK file (paths, commands, outcomes — facts only).
-2. If architecture or decisions changed, note them in the TASK; `task done` updates `docs/project/*`.
-
-Do not mark a TASK complete with placeholder `(not yet)` sections.