@goodtek/vibeops 2.4.3 → 2.5.0

package/dist/lib/task-context.js

@@ -49,7 +49,7 @@ export function computeNextHint(input) {
         if (input.hasMergeRequest && !input.mergeRequestMerged)
             return "task-merge";
         if (input.hasLocalChanges)
-            return "task-reship";
+            return "task-ship-followup";
         return "task-add";
     }
     if (!input.resultFilled || !input.testFilled) {
@@ -57,36 +57,48 @@ export function computeNextHint(input) {
     }
     return input.hasMergeRequest ? "task-merge" : "task-ship";
 }
-export function hintToText(hint, cwd, task) {
+/** Multi-line NEXT block lines (without the leading arrow prefix). */
+export function hintToLines(hint, cwd, task) {
     switch (hint) {
         case "init":
-            return "Run `vibeops init` in this directory.";
+            return ["vibeops init"];
         case "task-add":
-            return "Run `vibeops task add` to start the next slice.";
+            return ["vibeops task add"];
         case "task-ship":
-            return task ? `Run \`vibeops task ship ${task.id}\`.` : "Run `vibeops task ship`.";
-        case "task-reship":
+            return [task ? `vibeops task ship ${task.id}` : "vibeops task ship"];
+        case "task-ship-followup":
             return task
-                ? `Follow-up on ${task.id}? Edit files (develop is fine), then \`vibeops task reship ${task.id}\`.`
-                : "Run `vibeops task reship TASK-NNN` for a Shipped follow-up.";
+                ? [
+                    `Follow up on ${task.id} (after merge: confirm or --new-cycle)`,
+                    `vibeops task ship ${task.id}`,
+                ]
+                : ["vibeops task ship --new-cycle"];
         case "task-merge":
             return task
-                ? `Merge the MR (UI or \`vibeops task merge ${task.id}\`), then optional task sync.`
-                : "Merge the MR on the host or with `vibeops task merge`.";
+                ? [`vibeops task merge ${task.id}`, "(or merge in the host UI)"]
+                : ["vibeops task merge"];
         case "task-sync":
             return task
-                ? `Run \`vibeops task sync ${task.id}\` to delete task branches, then task add.`
-                : "Run `vibeops task sync` to delete task branches after merge.";
+                ? [`vibeops task sync ${task.id}`, "then: vibeops task add"]
+                : ["vibeops task sync"];
         case "cursor-plan":
             return task
-                ? `In Cursor Ask: @${relPath(cwd, task.filePath)} — refine Scope / AC.`
-                : "Open the TASK file in Cursor Ask.";
+                ? [
+                    `Cursor Ask: @${relPath(cwd, task.filePath)} — refine Scope / AC`,
+                ]
+                : ["Open the TASK file in Cursor Ask"];
         case "cursor-implement":
             return task
-                ? `In Cursor Agent: @${relPath(cwd, task.filePath)} — implement, then task ship.`
-                : "Implement per the TASK file in Cursor.";
+                ? [
+                    `Cursor Agent: @${relPath(cwd, task.filePath)} — implement`,
+                    `then: vibeops task ship ${task.id}`,
+                ]
+                : ["Implement per the TASK file, then vibeops task ship"];
     }
 }
+export function hintToText(hint, cwd, task) {
+    return hintToLines(hint, cwd, task).join(" · ");
+}
 export async function listInProgressTasks(paths) {
     return (await loadActionableTasks(paths.docsTasks)).filter((t) => t.status === "in_progress");
 }

package/dist/lib/task-push-pr.js

@@ -1,3 +1,4 @@
+import { formatHostCliHint, formatHostCliMissingMessage } from "./git-host-cli.js";
 import { readText } from "./filesystem.js";
 import { readConfig } from "./config.js";
 import { detectGitHost, mergeRequestLabel } from "./git-host.js";
@@ -94,8 +95,11 @@ export async function finishTaskWithPullRequest(opts) {
     }
     const cliOk = await probeMergeRequestCli(gitCfg.host);
     if (!cliOk) {
-        const tool = gitCfg.host === "gitlab" ? "glab" : "gh";
-        log.warn(`${tool} CLI not found — create the ${label} manually: ${gitCtx.taskBranch} → ${gitCtx.baseBranch}`);
+        log.warn(formatHostCliMissingMessage(gitCfg.host, `create the ${label}`));
+        for (const line of formatHostCliHint(gitCfg.host)) {
+            log.info(dim(`  ${line}`));
+        }
+        log.info(dim(`Create the ${label} manually: ${gitCtx.taskBranch} → ${gitCtx.baseBranch}`));
         return { ok: true, pushed: true };
     }
     const config = await readConfig(opts.cwd);

package/dist/lib/task-reship.js

@@ -43,7 +43,7 @@ export function reshipNotFoundMessage(taskRef) {
     if (taskRef?.trim()) {
         return `Shipped TASK not found: ${normalizeTaskRef(taskRef)}. Check docs/tasks/.`;
     }
-    return "No Shipped TASK found. Pass `vibeops task reship TASK-NNN`.";
+    return "No Shipped TASK found. Pass `vibeops task ship TASK-NNN` (use --new-cycle after merge).";
 }
 async function switchToTaskBranch(cwd, taskBranch) {
     try {

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@goodtek/vibeops",
-  "version": "2.4.3",
+  "version": "2.5.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": {
@@ -29,6 +30,17 @@
   "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",
+    "test": "pnpm build && node --test \"tests/*.test.mjs\"",
+    "smoke": "pnpm typecheck && pnpm build && node --test \"tests/*.test.mjs\" && 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",
@@ -47,15 +59,5 @@
     "@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",
-    "test": "pnpm build && node --test \"tests/*.test.mjs\"",
-    "smoke": "pnpm typecheck && pnpm build && node --test \"tests/*.test.mjs\" && node scripts/smoke.mjs",
-    "clean": "rm -rf dist",
-    "publish:dry": "pnpm publish --dry-run --no-git-checks"
   }
-}
+}

package/templates/core/AGENTS.md

@@ -40,5 +40,5 @@ vibeops llm connect   # optional — task add / ship
 
 - One **In Progress** TASK at a time; **Shipped** does not block `task add`.
 - Fill **Result** and **Test Result** before `vibeops task ship` (warned, not blocked, when updating an open PR).
-- `ship` is state-aware: re-run it to update an open PR; after merge it needs `--new-cycle` (or a confirm) to start a new PR cycle. `task reship` still works as a deprecated alias for `task ship --new-cycle`.
+- `ship` is state-aware: re-run it to update an open PR; after merge it needs `--new-cycle` (or a confirm) to start a new PR cycle.
 - Agents do not run `task merge` or `task sync` unless the human asks.

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 ship` / `task reship` / `merge` / `sync` and Cursor for plan/build. TASK status: **In Progress** → **Shipped** only.
+- **Decision:** TASK-driven development with `vibeops task add` / `task ship` / `merge` / `sync` and Cursor for plan/build. TASK status: **In Progress** → **Shipped** only.
 - **Why:** Git `docs/tasks` beats chat as source of truth.

package/dist/commands/task-reship.js

@@ -1,21 +0,0 @@
-import { dim, log, yellow } from "../lib/logger.js";
-import { taskShipCommand } from "./task-ship.js";
-/**
- * @deprecated `reship` is now `vibeops task ship --new-cycle`.
- * Kept as a thin alias for backward compatibility.
- */
-export async function taskReshipCommand(taskRef, options = {}) {
-    log.warn(`${yellow("reship is now `ship` (deprecated alias)")} — delegating to \`vibeops task ship --new-cycle\`.`);
-    log.info(dim("Run `vibeops task ship` directly; it detects first submit / open-PR update / new PR cycle."));
-    log.blank();
-    await taskShipCommand(taskRef, {
-        dryRun: options.dryRun,
-        cwd: options.cwd,
-        noPr: options.noPr,
-        newCycle: true,
-        noIntegrate: options.noIntegrate,
-        recreateBranch: options.recreateBranch,
-        skipLlm: options.skipLlm,
-        allowOpenMr: options.allowOpenMr,
-    });
-}