@c-d-cc/reap 0.15.13 → 0.15.15

package/README.ja.md

@@ -23,6 +23,15 @@
 
 REAPはアプリケーションの設計知識 — Genome（アーキテクチャ、コンベンション、制約）とEnvironment（外部API、インフラ） — を記録し、各世代で目標を設定して実装します。その過程で発見した欠陥はKnowledge Baseにフィードバックされます。世代を重ねるごとに知識が進化し、Source Code（Civilization）が成長します。
 
+> **⚠️ v0.16 Breaking Changes予定**
+>
+> - REAPがSelf Evolving Pipelineへ移行
+> - ライフサイクル変更: learning → planning → implementation → validation → completion（Learning stage新規追加、ObjectiveとPlanningをPlanningに統合）
+> - スラッシュコマンド再編: skillマッチング最適化
+> - CLIコマンドがユーザーインターフェースから削除（内部用途のみ）
+>
+> v0.15.xからv0.16.xへの自動アップデートはブロックされます。[リリースノート](https://reap.cc/docs/release-notes)参照。
+
 ## 目次
 
 - [なぜREAPか？](#なぜreapか)

package/README.ko.md

@@ -23,6 +23,15 @@
 
 REAP은 Application의 설계 지식 — Genome(아키텍처, 컨벤션, 제약사항)과 Environment(외부 API, 인프라) — 을 기록하고, 각 세대에서 목표를 설정하여 구현합니다. 그 과정에서 발견한 결함은 Knowledge Base에 반영됩니다. 세대를 거듭하며 지식이 진화하고, Source Code(Civilization)가 성장합니다.
 
+> **⚠️ v0.16 Breaking Changes 예정**
+>
+> - REAP이 Self Evolving Pipeline으로 전환됩니다
+> - Lifecycle 변경: learning → planning → implementation → validation → completion (Learning stage 신규 추가, Objective와 Planning을 Planning으로 병합)
+> - Slash command 구조 변경: skill 매칭 최적화
+> - CLI 커맨드가 사용자 인터페이스에서 제거 (내부 용도로만 사용)
+>
+> v0.15.x에서 v0.16.x로의 자동 업데이트가 차단됩니다. [릴리스 노트](https://reap.cc/docs/release-notes) 참조.
+
 ## 목차
 
 - [Why REAP?](#why-reap)

package/README.md

@@ -23,6 +23,15 @@
 
 REAP captures an application's design knowledge — the Genome (architecture, conventions, constraints) and Environment (external APIs, infrastructure) — then sets objectives for each generation to implement. Defects discovered along the way feed back into the Knowledge Base. As generations accumulate, knowledge evolves and the Source Code (Civilization) grows.
 
+> **⚠️ Breaking Changes in v0.16**
+>
+> - REAP transitions to a Self Evolving Pipeline
+> - Lifecycle changed: learning → planning → implementation → validation → completion (new Learning stage, Objective + Planning merged)
+> - Slash commands restructured for optimal skill matching
+> - CLI commands removed from user-facing interface (internal use only)
+>
+> Automatic updates from v0.15.x → v0.16.x are blocked. See [Release Notes](https://reap.cc/docs/release-notes).
+
 ## Table of Contents
 
 - [Why REAP?](#why-reap)

package/README.zh-CN.md

@@ -23,6 +23,15 @@
 
 REAP记录应用程序的设计知识 — Genome（架构、约定、约束）和Environment（外部API、基础设施） — 并在每个世代设定目标进行实现。过程中发现的缺陷反馈到Knowledge Base。随着世代的积累，知识不断进化，Source Code（Civilization）持续成长。
 
+> **⚠️ v0.16 Breaking Changes 预告**
+>
+> - REAP转型为Self Evolving Pipeline
+> - 生命周期变更: learning → planning → implementation → validation → completion（新增Learning阶段，Objective和Planning合并为Planning）
+> - 斜杠命令重组: skill匹配优化
+> - CLI命令从用户界面移除（仅供内部使用）
+>
+> v0.15.x到v0.16.x的自动更新将被阻止。参见[发布说明](https://reap.cc/docs/release-notes)。
+
 ## 目录
 
 - [为什么选择REAP？](#为什么选择reap)

package/RELEASE_NOTICE.md

@@ -1,5 +1,17 @@
 # Release Notices
 
+## v0.15.15
+### en
+Added v0.16 breaking change pre-announcement to README.
+### ko
+README에 v0.16 breaking change 사전 고지 추가.
+
+## 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.15";
 }
 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.15";
   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.15"} (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.15";
         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.15",
     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.15");
 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.15";
     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.15",
   "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"
   }
 }