@c-d-cc/reap 0.15.13 → 0.15.14

package/RELEASE_NOTICE.md

@@ -1,5 +1,11 @@
 # Release Notices
 
+## v0.15.14
+### en
+Auto-update guard for breaking changes. New Release Notes docs page with v0.16 pre-announcement.
+### ko
+Breaking change 대비 자동 업데이트 차단 기능 추가. v0.16 사전 고지가 포함된 릴리스 노트 페이지 신규.
+
 ## v0.15.13
 ### en
 Replaced `commander.js` with built-in CLI library. Runtime dependencies: 2 → 1.

package/dist/cli.js

@@ -8391,7 +8391,7 @@ function checkLatestVersion() {
   }
 }
 function getCurrentVersion() {
-  return "0.15.13";
+  return "0.15.14";
 }
 function formatVersionLine(current, skipCheck) {
   if (skipCheck) {
@@ -10604,7 +10604,7 @@ async function execute17(paths) {
   const gm = new GenerationManager(paths);
   const state = await gm.current();
   const configContent = await readTextFile(paths.config);
-  const installedVersion = "0.15.13";
+  const installedVersion = "0.15.14";
   const autoUpdate = configContent?.match(/autoUpdate:\s*(true|false)/)?.[1] === "true";
   const versionDisplay = formatVersionLine(installedVersion, !autoUpdate);
   const rawLang = detectLanguage(configContent);
@@ -12332,7 +12332,7 @@ async function execute30(paths) {
   const lines = [
     `REAP Configuration (${paths.config})`,
     "",
-    `  version:         ${"0.15.13"} (package)`,
+    `  version:         ${"0.15.14"} (package)`,
     `  project:         ${config.project}`,
     `  entryMode:       ${config.entryMode}`,
     `  strict:          ${config.strict ?? false}`,
@@ -12638,7 +12638,7 @@ async function runCommand(command, phase, argv = []) {
     try {
       const config = await ConfigManager.read(paths);
       if (config.autoIssueReport) {
-        const version = "0.15.13";
+        const version = "0.15.14";
         const errMsg = err instanceof Error ? err.message : String(err);
         const title = `[auto] reap run ${command}: ${errMsg.slice(0, 80)}`;
         const body = [
@@ -14959,12 +14959,54 @@ function selfUpgrade() {
     if (installed === latest) {
       return { upgraded: false };
     }
+    const minVersion = queryAutoUpdateMinVersion();
+    if (minVersion && !semverGte(installed, minVersion)) {
+      return {
+        upgraded: false,
+        blocked: true,
+        from: installed,
+        to: latest,
+        reason: `Breaking change: v${installed} -> v${latest}. Run '/reap.update' to upgrade manually. See https://reap.cc/docs/release-notes`
+      };
+    }
     execSync3("npm update -g @c-d-cc/reap", { encoding: "utf-8", timeout: 60000, stdio: "pipe" });
     return { upgraded: true, from: installed, to: latest };
   } catch {
     return { upgraded: false };
   }
 }
+function semverGte(a, b) {
+  const pa = a.split(".").map(Number);
+  const pb = b.split(".").map(Number);
+  for (let i = 0;i < 3; i++) {
+    if ((pa[i] ?? 0) > (pb[i] ?? 0))
+      return true;
+    if ((pa[i] ?? 0) < (pb[i] ?? 0))
+      return false;
+  }
+  return true;
+}
+function forceUpgrade(to) {
+  try {
+    const installed = execSync3("reap --version", { encoding: "utf-8", timeout: 5000 }).trim();
+    execSync3(`npm install -g @c-d-cc/reap@${to}`, { encoding: "utf-8", timeout: 60000, stdio: "pipe" });
+    return { upgraded: true, from: installed, to };
+  } catch {
+    return { upgraded: false };
+  }
+}
+function queryAutoUpdateMinVersion() {
+  try {
+    const result = execSync3("npm view @c-d-cc/reap reap.autoUpdateMinVersion", {
+      encoding: "utf-8",
+      timeout: 1e4,
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    return result.trim() || null;
+  } catch {
+    return null;
+  }
+}
 async function updateProject(projectRoot, dryRun = false) {
   const paths = new ReapPaths(projectRoot);
   const result = { updated: [], skipped: [], removed: [] };
@@ -15259,7 +15301,7 @@ async function getStatus(projectRoot) {
   const totalCompleted = await mgr.countAllCompleted();
   const integrityResult = await checkIntegrity(paths);
   return {
-    version: "0.15.13",
+    version: "0.15.14",
     project: config.project,
     entryMode: config.entryMode,
     lastSyncedGeneration: config.lastSyncedGeneration,
@@ -15582,7 +15624,7 @@ init_fs();
 init_version();
 init_config();
 import { join as join34 } from "path";
-program.name("reap").description("REAP — Recursive Evolutionary Autonomous Pipeline").version("0.15.13");
+program.name("reap").description("REAP — Recursive Evolutionary Autonomous Pipeline").version("0.15.14");
 program.command("init").description("Initialize a new REAP project (Genesis)").argument("[project-name]", "Project name (defaults to current directory name)").option("-m, --mode <mode>", "Entry mode: greenfield, migration, adoption", "greenfield").option("-p, --preset <preset>", "Bootstrap with a genome preset (e.g., bun-hono-react)").action(async (projectName, options) => {
   try {
     const cwd = process.cwd();
@@ -15639,7 +15681,7 @@ program.command("status").description("Show current project and Generation statu
     const paths = new ReapPaths(cwd);
     const config = await ConfigManager.read(paths);
     const skipCheck = config.autoUpdate === false;
-    const installedVersion = "0.15.13";
+    const installedVersion = "0.15.14";
     const versionLine = formatVersionLine(installedVersion, skipCheck);
     console.log(`${versionLine} | Project: ${status.project} (${status.entryMode})`);
     console.log(`Completed Generations: ${status.totalGenerations}`);
@@ -15711,8 +15753,29 @@ program.command("fix").description("Diagnose and repair .reap/ directory structu
 });
 program.command("update").description("Upgrade REAP package and sync slash commands, templates, and hooks").option("--dry-run", "Show changes without applying them").action(async (options) => {
   try {
-    const upgrade = !options.dryRun ? selfUpgrade() : { upgraded: false };
-    if (upgrade.upgraded) {
+    let upgrade = !options.dryRun ? selfUpgrade() : { upgraded: false };
+    if (upgrade.blocked) {
+      console.log(`
+⚠ Breaking change detected: v${upgrade.from} → v${upgrade.to}`);
+      console.log(`  This update contains breaking changes that may require manual migration.`);
+      console.log(`  See release notes: https://reap.cc/docs/release-notes
+`);
+      const rl = createInterface({ input: process.stdin, output: process.stdout });
+      const answer = await new Promise((resolve) => {
+        rl.question("  Proceed with update? (y/N) ", resolve);
+      });
+      rl.close();
+      if (answer.toLowerCase() === "y" || answer.toLowerCase() === "yes") {
+        upgrade = forceUpgrade(upgrade.to);
+        if (upgrade.upgraded) {
+          console.log(`Upgraded: v${upgrade.from} → v${upgrade.to}`);
+        } else {
+          console.log("Upgrade failed. Try manually: npm install -g @c-d-cc/reap@latest");
+        }
+      } else {
+        console.log("Update skipped.");
+      }
+    } else if (upgrade.upgraded) {
       console.log(`Upgraded: v${upgrade.from} → v${upgrade.to}`);
     }
     const result = await updateProject(process.cwd(), options.dryRun ?? false);

package/dist/templates/hooks/opencode-session-start.js

@@ -5,6 +5,17 @@ const { execSync } = require("child_process");
 const fs = require("fs");
 const path = require("path");
 
+// Inline semver comparison (no external deps): returns true if a >= b
+function semverGte(a, b) {
+  const pa = a.split(".").map(Number);
+  const pb = b.split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((pa[i] || 0) > (pb[i] || 0)) return true;
+    if ((pa[i] || 0) < (pb[i] || 0)) return false;
+  }
+  return true;
+}
+
 module.exports = async (ctx) => {
   return {
     "session.start": async ({ trigger }) => {
@@ -50,9 +61,15 @@ module.exports = async (ctx) => {
               const installed = gl.exec("reap --version 2>/dev/null", execOpts);
               const latest = gl.exec("npm view @c-d-cc/reap version 2>/dev/null", execOpts);
               if (installed && latest && installed !== latest) {
-                execSync("npm update -g @c-d-cc/reap >/dev/null 2>&1", { ...execOpts, stdio: "ignore" });
-                execSync("reap update >/dev/null 2>&1", { ...execOpts, stdio: "ignore" });
-                autoUpdateMessage = `REAP auto-updated: v${installed} → v${latest}`;
+                // Auto-update guard: check autoUpdateMinVersion
+                const minVersion = gl.exec("npm view @c-d-cc/reap reap.autoUpdateMinVersion 2>/dev/null", execOpts);
+                if (minVersion && !semverGte(installed, minVersion)) {
+                  autoUpdateMessage = `[BREAKING] Auto-update blocked: v${installed} -> v${latest} contains breaking changes. Inform the user about this breaking change and ask if they want to update via '/reap.update'. Release notes: https://reap.cc/docs/release-notes`;
+                } else {
+                  execSync("npm update -g @c-d-cc/reap >/dev/null 2>&1", { ...execOpts, stdio: "ignore" });
+                  execSync("reap update >/dev/null 2>&1", { ...execOpts, stdio: "ignore" });
+                  autoUpdateMessage = `REAP auto-updated: v${installed} → v${latest}`;
+                }
               }
             } catch { /* update check failed, skip */ }
           }
@@ -109,7 +126,11 @@ module.exports = async (ctx) => {
       // Build auto-update section
       let updateSection = "";
       if (autoUpdateMessage) {
-        updateSection = `\n\n## Auto-Update\n${autoUpdateMessage}. Tell the user: "${autoUpdateMessage}"`;
+        if (autoUpdateMessage.startsWith("[BREAKING]")) {
+          updateSection = `\n\n## Auto-Update (Breaking Change Detected)\n${autoUpdateMessage}\n\nIMPORTANT: On your first response, explain to the user that a new REAP version is available but contains breaking changes. Show them the release notes link and ask for explicit confirmation before they run the manual update command. Do NOT silently skip this.`;
+        } else {
+          updateSection = `\n\n## Auto-Update\n${autoUpdateMessage}. Tell the user: "${autoUpdateMessage}"`;
+        }
       }
 
       const context = `<REAP_WORKFLOW>\n${reapGuide}\n\n---\n\n## Genome (Project Knowledge)\n${genomeContent}\n\n---\n\n## Current State\n${generationContext}${staleSection}${strictSection}${updateSection}${langSection}\n\n## Rules\n1. ALL development work MUST follow the REAP lifecycle.\n2. Before writing any code, check if a Generation is active and what stage it is in.\n3. If a Generation is active, use \`${nextCmd}\` to proceed with the current stage.\n4. If no Generation is active, use \`/reap.start\` to start a new one.\n5. Do NOT implement features outside of the REAP lifecycle unless explicitly asked.\n6. Genome is the authoritative knowledge source.\n</REAP_WORKFLOW>`;

package/dist/templates/hooks/session-start.cjs

@@ -117,6 +117,17 @@ if (gl.dirExists(userReapCommands)) {
   }
 }
 
+// Inline semver comparison (no external deps): returns true if a >= b
+function semverGte(a, b) {
+  const pa = a.split('.').map(Number);
+  const pb = b.split('.').map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((pa[i] || 0) > (pb[i] || 0)) return true;
+    if ((pa[i] || 0) < (pb[i] || 0)) return false;
+  }
+  return true;
+}
+
 // Step 1: Version check + Auto-update
 log('Checking for updates...');
 let autoUpdateMessage = '';
@@ -129,10 +140,17 @@ if (installed && installed.includes('+dev')) {
 } else if (installed && latest && installed !== latest) {
   const autoUpdate = configContent ? /^autoUpdate:\s*true/m.test(configContent) : false;
   if (autoUpdate) {
-    const updated = gl.exec('npm update -g @c-d-cc/reap');
-    if (updated !== null) {
-      gl.exec('reap update');
-      autoUpdateMessage = `REAP auto-updated: v${installed} → v${latest}`;
+    // Auto-update guard: check autoUpdateMinVersion before upgrading
+    const minVersion = gl.exec('npm view @c-d-cc/reap reap.autoUpdateMinVersion');
+    if (minVersion && !semverGte(installed, minVersion)) {
+      // Breaking change detected — block auto-update
+      autoUpdateMessage = `[BREAKING] Auto-update blocked: v${installed} → v${latest} contains breaking changes. Inform the user about this breaking change and ask if they want to update via '/reap.update'. Release notes: https://reap.cc/docs/release-notes`;
+    } else {
+      const updated = gl.exec('npm update -g @c-d-cc/reap');
+      if (updated !== null) {
+        gl.exec('reap update');
+        autoUpdateMessage = `REAP auto-updated: v${installed} → v${latest}`;
+      }
     }
   } else {
     updateAvailableMessage = `update available: v${installed} → v${latest}`;
@@ -178,7 +196,11 @@ if (genomeStaleWarning) {
 // Build auto-update section
 let updateSection = '';
 if (autoUpdateMessage) {
-  updateSection = `\n\n## Auto-Update\n${autoUpdateMessage}. Tell the user: "${autoUpdateMessage}"`;
+  if (autoUpdateMessage.startsWith('[BREAKING]')) {
+    updateSection = `\n\n## Auto-Update (Breaking Change Detected)\n${autoUpdateMessage}\n\nIMPORTANT: On your first response, explain to the user that a new REAP version is available but contains breaking changes. Show them the release notes link and ask for explicit confirmation before they run the manual update command. Do NOT silently skip this.`;
+  } else {
+    updateSection = `\n\n## Auto-Update\n${autoUpdateMessage}. Tell the user: "${autoUpdateMessage}"`;
+  }
 }
 
 // Build session init display

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c-d-cc/reap",
-  "version": "0.15.13",
+  "version": "0.15.14",
   "description": "Recursive Evolutionary Autonomous Pipeline — AI and humans evolve software across generations",
   "type": "module",
   "license": "MIT",
@@ -46,5 +46,8 @@
   },
   "dependencies": {
     "yaml": "^2.0.0"
+  },
+  "reap": {
+    "autoUpdateMinVersion": "0.15.0"
   }
 }