@goodtek/vibeops 3.2.0 → 3.3.0

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to VibeOps are documented here.
 
 ## Unreleased
 
+## 3.3.0 - 2026-10-18
+
+### Added
+
+- **`task add --repair-baseline`**: open the TASK that repairs a broken baseline even in `enforce` mode (failures shown as warnings for that command only); the TASK file records it (`## Baseline` → Repair) and its `task ship` requires every baseline check to pass, whatever the mode (D-015, TASK-052).
+
 ## 3.2.0 - 2026-10-18
 
 ### Fixed

package/README.md

@@ -220,6 +220,7 @@ If a configured remote cannot be fetched, `task add` stops without creating a TA
 - `crew`: persona crew to require; omitted → the crew checks are skipped.
 - `vibeops status` shows the same checks (`Baseline …`), the crew's pinned catalog commit, and remote branches other than integration / production / `task/*` / `sync/*` (`status --json` → `baseline`).
 - The block is validated strictly (unknown keys / values are errors and stop the command).
+- **Repairing in `enforce` mode:** `vibeops task add --repair-baseline` opens the TASK anyway (failures shown as warnings for that command only) and writes a `## Baseline` section ("Repair …") into the TASK file; `task ship` of that TASK goes through only when every baseline check passes, whatever `baseline.mode` is.
 
 ## Merge gate
 

package/dist/cli.js

@@ -67,9 +67,11 @@ task
     .option("--dry-run", "Plan only")
     .option("--non-interactive", "CI: minimal scaffold (optional --idea)")
     .option("--idea <text>", "Short description (CI)")
+    .option("--repair-baseline", "Open a TASK that repairs the baseline even in enforce mode (its ship requires every check to pass)")
     .option("--cwd <path>", "Target directory")
     .action(async (opts) => {
     await taskAddCommand({
+        repairBaseline: Boolean(opts.repairBaseline),
         dryRun: Boolean(opts.dryRun),
         nonInteractive: Boolean(opts.nonInteractive),
         idea: opts.idea,

package/dist/commands/task-add.js

@@ -3,7 +3,7 @@ import { pathExists, writeText } from "../lib/filesystem.js";
 import { GitConfigError, requireGitConfig } from "../lib/git-config.js";
 import { ensureIntegrationSynced, printIntegrationSyncDiagnosis, } from "../lib/git-integration-sync.js";
 import { askInput } from "../lib/inquirer-helpers.js";
-import { preflightBaseline } from "../lib/project-baseline.js";
+import { BASELINE_REPAIR_SECTION, BASELINE_REPAIR_TEXT, preflightBaseline, } from "../lib/project-baseline.js";
 import { bold, cyan, dim, log, yellow } from "../lib/logger.js";
 import { projectPaths } from "../lib/paths.js";
 import { slugify } from "../lib/slug.js";
@@ -13,7 +13,7 @@ import { findBlockingTask, relPath } from "../lib/task-context.js";
 import { allocateTaskId, TaskIdAllocationError } from "../lib/task-id-allocation.js";
 import { readTaskLockConfig, TaskLockConfigError, TaskLockHeldError, withTaskLock, } from "../lib/task-lock.js";
 import { isIncompleteTaskStart, startTaskBranch } from "../lib/task-start.js";
-import { branchNameForTaskFile, damagedGitContext, loadActionableTasks, readGitContext, } from "../lib/task.js";
+import { branchNameForTaskFile, damagedGitContext, withSectionAfterStatus, loadActionableTasks, readGitContext, } from "../lib/task.js";
 async function loadGitConfigOrNull(root, dryRun) {
     try {
         return await requireGitConfig(root);
@@ -81,7 +81,8 @@ export async function taskAddCommand(opts = {}) {
     const gitCfg = await loadGitConfigOrNull(root, dryRun);
     if (!dryRun && gitCfg === null)
         return;
-    if (gitCfg !== null && !(await preflightBaseline(root, gitCfg, "task add"))) {
+    const repair = opts.repairBaseline === true;
+    if (gitCfg !== null && !(await preflightBaseline(root, gitCfg, "task add", { repair }))) {
         process.exitCode = 1;
         return;
     }
@@ -248,9 +249,12 @@ export async function taskAddCommand(opts = {}) {
             }
         }
         const taskId = formatTaskId(taskNumber);
-        const markdown = taskId === provisionalId
+        const drafted = taskId === provisionalId
             ? draftMarkdown
             : draftMarkdown.replace(new RegExp(`\\b${provisionalId}\\b`, "g"), taskId);
+        const markdown = repair
+            ? withSectionAfterStatus(drafted, BASELINE_REPAIR_SECTION, BASELINE_REPAIR_TEXT)
+            : drafted;
         const { filePath } = uniqueTaskPath(paths.docsTasks, taskId, slugify(slug || title), tasks.map((t) => t.filePath));
         const relFile = relPath(root, filePath);
         const integration = gitCfg?.integrationBranch ?? "integration";

package/dist/commands/task-ship.js

@@ -1,7 +1,7 @@
 import { resolve } from "node:path";
 import { readText } from "../lib/filesystem.js";
 import { requireGitConfig } from "../lib/git-config.js";
-import { preflightBaseline } from "../lib/project-baseline.js";
+import { BASELINE_REPAIR_SECTION, preflightBaseline } from "../lib/project-baseline.js";
 import { gitCommitsAhead, gitHeadCommit, gitPush, gitRemoteBranchExists, readGitInfo, } from "../lib/git.js";
 import { askYesNo, isInteractiveSession } from "../lib/inquirer-helpers.js";
 import { bold, cyan, dim, green, log, yellow } from "../lib/logger.js";
@@ -15,7 +15,7 @@ import { runPostMergeNewCycle } from "../lib/task-new-cycle.js";
 import { applyTaskShipMemory, fallbackResultSections, llmCompleteTaskShip, writeTaskResultSections, } from "../lib/task-ship-llm.js";
 import { detectShipPrState, prRefLabel, resolveShipAction, } from "../lib/task-ship-state.js";
 import { finishTaskWithPullRequest } from "../lib/task-push-pr.js";
-import { hasNonEmptySection, parseTaskFilename, gitContextProblem, readGitContext, readTaskFile, updateInlineStatus, } from "../lib/task.js";
+import { hasNonEmptySection, parseTaskFilename, gitContextProblem, readGitContext, readSection, readTaskFile, updateInlineStatus, } from "../lib/task.js";
 import { assertTaskIdFreeOnRemote } from "../lib/task-id-allocation.js";
 function describePushFailure(message) {
     const lower = message.toLowerCase();
@@ -332,7 +332,9 @@ export async function taskShipCommand(taskRef, options = {}) {
     }
     log.blank();
     const baselineGit = await requireGitConfig(cwd).catch(() => null);
-    if (baselineGit !== null && !(await preflightBaseline(cwd, baselineGit, "task ship"))) {
+    const repairTask = readSection(body, BASELINE_REPAIR_SECTION).startsWith("Repair");
+    if (baselineGit !== null &&
+        !(await preflightBaseline(cwd, baselineGit, "task ship", { requireOk: repairTask }))) {
         process.exitCode = 1;
         return;
     }

package/dist/lib/project-baseline.js

@@ -109,38 +109,56 @@ export async function runBaselineChecks(cwd, git, cfg) {
     }
     return checks;
 }
+/** Section `task add --repair-baseline` writes into the TASK file (read back by `task ship`). */
+export const BASELINE_REPAIR_SECTION = "Baseline";
+export const BASELINE_REPAIR_TEXT = "Repair — opened with `vibeops task add --repair-baseline`. `task ship` requires every baseline check to pass (whatever `baseline.mode` is).";
 /**
  * Run the configured checks and print failures. Returns false only in `enforce` mode with a
- * failing check (the caller stops); `warn` prints and continues; `off` skips.
+ * failing check (the caller stops); `warn` prints and continues; `off` skips. See
+ * {@link PreflightOptions} for the baseline-repair flow.
  */
-export async function preflightBaseline(cwd, git, command) {
+export async function preflightBaseline(cwd, git, command, opts = {}) {
     let cfg;
     try {
         cfg = await readBaselineConfig(cwd);
     }
     catch (e) {
-        log.error(e instanceof Error ? e.message : String(e));
-        return false;
+        const msg = e instanceof Error ? e.message : String(e);
+        if (opts.repair !== true) {
+            log.error(msg);
+            return false;
+        }
+        log.warn(`${msg} — continuing with defaults (baseline repair).`);
+        cfg = BASELINE_DEFAULTS;
     }
-    if (cfg.mode === "off")
+    if (cfg.mode === "off" && opts.repair !== true && opts.requireOk !== true)
         return true;
     const failed = (await runBaselineChecks(cwd, git, cfg)).filter((c) => !c.ok);
-    if (failed.length === 0)
+    if (failed.length === 0) {
+        if (opts.repair === true)
+            log.info(dim("baseline: every check passes already (--repair-baseline not needed)."));
         return true;
-    const enforce = cfg.mode === "enforce";
+    }
+    const stop = opts.requireOk === true || (cfg.mode === "enforce" && opts.repair !== true);
     for (const c of failed) {
         const line = `baseline ${c.id}: ${c.detail}`;
-        if (enforce)
+        if (stop)
             log.error(line);
         else
             log.warn(line);
         if (c.fix)
             log.info(dim(`  fix: ${c.fix}`));
     }
-    if (enforce) {
-        log.info(dim(`${command} stopped (.vibeops.json baseline.mode: enforce).`));
+    if (opts.requireOk === true) {
+        log.info(dim(`${command} stopped: a baseline-repair TASK ships only when every check passes.`));
+        return false;
+    }
+    if (stop) {
+        log.info(dim(`${command} stopped (.vibeops.json baseline.mode: enforce). To repair: vibeops task add --repair-baseline`));
         return false;
     }
+    if (opts.repair === true)
+        log.info(dim("baseline repair: failures reported as warnings for this TASK."));
     return true;
 }
 /** Read-only summary for `vibeops status` (never throws). */

package/dist/lib/task.js

@@ -335,6 +335,12 @@ function insertSectionAfter(body, afterTitle, newTitle, newContent) {
     const after = lines.slice(block.end);
     return [...before, ...newSection, ...after].join("\n");
 }
+/** Add (or replace) a `## <title>` section right after `## Status`. */
+export function withSectionAfterStatus(body, title, content) {
+    if (locateSection(body, title) !== null)
+        return replaceSectionContent(body, title, content);
+    return insertSectionAfter(body, "Status", title, content);
+}
 export async function updateInlineStatus(filePath, next) {
     const raw = await readText(filePath);
     const display = statusDisplay(next);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodtek/vibeops",
-  "version": "3.2.0",
+  "version": "3.3.0",
   "description": "Minimal CLI rails for Cursor-based TASK-driven vibe coding.",
   "type": "module",
   "packageManager": "pnpm@9.15.9",