@c-d-cc/reap 0.15.0 → 0.15.1

package/dist/templates/commands/reap.evolve.recovery.md

@@ -0,0 +1,5 @@
+---
+description: "REAP Evolve Recovery — Review past generations and create a recovery generation if needed"
+---
+
+Run `reap run evolve-recovery $ARGUMENTS` and follow the stdout instructions exactly.

package/dist/templates/commands/reap.update-genome.md

@@ -0,0 +1,5 @@
+---
+description: "REAP Update Genome — Apply pending genome-change backlog without a generation"
+---
+
+Run `reap run update-genome $ARGUMENTS` and follow the stdout instructions exactly.

package/dist/templates/hooks/genome-loader.cjs

@@ -123,7 +123,18 @@ function parseConfig(configFile) {
     const langMatch = configContent.match(/^language:\s*(.+)$/m);
     if (langMatch) language = langMatch[1].trim();
   }
-  return { strictEdit, strictMerge, language, configContent };
+
+  // Parse lastSyncedGeneration (and legacy lastSyncedCommit for backward compat)
+  let lastSyncedGeneration = '';
+  let lastSyncedCommit = '';
+  if (configContent) {
+    const genMatch = configContent.match(/^lastSyncedGeneration:\s*["']?(.*)["']?\s*$/m);
+    if (genMatch) lastSyncedGeneration = genMatch[1].trim().replace(/^["']|["']$/g, '') || '';
+    const commitMatch = configContent.match(/^lastSyncedCommit:\s*["']?([a-f0-9]*)["']?$/m);
+    if (commitMatch) lastSyncedCommit = commitMatch[1] || '';
+  }
+
+  return { strictEdit, strictMerge, language, configContent, lastSyncedGeneration, lastSyncedCommit };
 }
 
 /**
@@ -152,14 +163,40 @@ function parseCurrentYml(currentYml) {
 }
 
 /**
- * Detect Genome staleness.
+ * Detect Genome staleness based on lastSyncedGeneration (with lastSyncedCommit fallback).
  * @param {string} projectRoot
- * @returns {{ genomeStaleWarning: string, commitsSince: number }}
+ * @param {string} [lastSyncedGeneration] - from config.yml; empty string = never synced
+ * @param {string} [lastSyncedCommit] - legacy field for backward compatibility
+ * @returns {{ genomeStaleWarning: string, commitsSince: number, neverSynced: boolean }}
  */
-function detectStaleness(projectRoot) {
+function detectStaleness(projectRoot, lastSyncedGeneration, lastSyncedCommit) {
   let genomeStaleWarning = '';
   let commitsSince = 0;
-  if (dirExists(path.join(projectRoot, '.git'))) {
+  let neverSynced = false;
+
+  if (!dirExists(path.join(projectRoot, '.git'))) {
+    return { genomeStaleWarning, commitsSince, neverSynced };
+  }
+
+  // Primary: lastSyncedGeneration — if non-empty, genome has been synced at least once
+  if (lastSyncedGeneration) {
+    // Use git log to count commits since last genome change as staleness heuristic
+    const lastGenomeCommit = exec(`git -C "${projectRoot}" log -1 --format="%H" -- ".reap/genome/"`);
+    if (lastGenomeCommit) {
+      commitsSince = parseInt(exec(`git -C "${projectRoot}" rev-list --count "${lastGenomeCommit}..HEAD" -- src/ tests/ package.json tsconfig.json scripts/`) || '0', 10);
+      if (commitsSince > 10) {
+        genomeStaleWarning = `WARNING: Genome may be stale — ${commitsSince} commits since last sync (${lastSyncedGeneration}). Consider running /reap.sync to synchronize.`;
+      }
+    }
+  } else if (lastSyncedCommit) {
+    // Legacy fallback: lastSyncedCommit (commit hash) for backward compatibility
+    commitsSince = parseInt(exec(`git -C "${projectRoot}" rev-list --count "${lastSyncedCommit}..HEAD" -- src/ tests/ package.json tsconfig.json scripts/`) || '0', 10);
+    if (commitsSince > 10) {
+      genomeStaleWarning = `WARNING: Genome may be stale — ${commitsSince} commits since last sync. Consider running /reap.sync to synchronize.`;
+    }
+  } else {
+    // Neither field set — never synced
+    // Fall back to git log based detection
     const lastGenomeCommit = exec(`git -C "${projectRoot}" log -1 --format="%H" -- ".reap/genome/"`);
     if (lastGenomeCommit) {
       commitsSince = parseInt(exec(`git -C "${projectRoot}" rev-list --count "${lastGenomeCommit}..HEAD" -- src/ tests/ package.json tsconfig.json scripts/`) || '0', 10);
@@ -167,9 +204,10 @@ function detectStaleness(projectRoot) {
         genomeStaleWarning = `WARNING: Genome may be stale — ${commitsSince} commits since last Genome update. Consider running /reap.sync to synchronize.`;
       }
     }
+    neverSynced = true;
   }
 
-  return { genomeStaleWarning, commitsSince };
+  return { genomeStaleWarning, commitsSince, neverSynced };
 }
 
 /**
@@ -215,7 +253,7 @@ function hasPlaceholders(filePath) {
  * @param {object} params
  * @returns {{ initLines: string[], severity: string }}
  */
-function buildGenomeHealth({ l1Lines, genomeDir, configFile, genomeStaleWarning, commitsSince }) {
+function buildGenomeHealth({ l1Lines, genomeDir, configFile, genomeStaleWarning, commitsSince, neverSynced }) {
   const issues = [];
   let severity = 'ok';
   if (l1Lines === 0) { issues.push('empty'); severity = 'danger'; }
@@ -240,6 +278,11 @@ function buildGenomeHealth({ l1Lines, genomeDir, configFile, genomeStaleWarning,
     }
   }
 
+  if (neverSynced) {
+    issues.push('never synced');
+    if (severity === 'ok') severity = 'warn';
+  }
+
   if (genomeStaleWarning && commitsSince > 30) {
     issues.push(`severely stale (${commitsSince} commits)`);
     if (severity !== 'danger') severity = 'danger';

package/dist/templates/hooks/onLifeCompleted.integrity-check.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+# condition: always
+# order: 90
+
+# Structural integrity check — runs after generation completion
+# Outputs warnings only; does NOT block the commit (always exits 0)
+
+result=$(reap fix --check 2>&1) || true
+
+if [ -n "$result" ]; then
+  echo "$result"
+fi
+
+exit 0

package/dist/templates/hooks/reap-guide.md

@@ -58,6 +58,8 @@ Objective → Planning → Implementation ⟷ Validation → Completion
 ### Generation
 A single generation. Carries one goal through the Life Cycle. State is tracked in `life/current.yml`.
 
+**Generation types**: `normal` (standard lifecycle), `merge` (distributed merge lifecycle), `recovery` (recover from failed/interrupted generation via `/reap.evolve.recovery`).
+
 **Generation ID format**: `gen-{NNN}-{hash}` (e.g. `gen-042-a3f8c2`)
 - `{hash}`: 6-char hex from sha256. **MUST be real hex (0-9a-f), NEVER words/slugs.**
 - Lineage directory appends a goal slug: `gen-042-a3f8c2-fix-login-bug`
@@ -146,11 +148,15 @@ Hooks are executed by the AI agent by scanning `.reap/hooks/` for files matching
 
 REAP supports multiple AI agents simultaneously through the AgentAdapter abstraction. Currently supported: **Claude Code** and **OpenCode**. Detected agents are listed in `.reap/config.yml` under the `agents` field (managed by `reap init` / `reap update`). Slash commands and session hooks are installed to each detected agent's configuration directory.
 
+## CLI Subcommands
+
+8 CLI subcommands: `reap init`, `reap status`, `reap update`, `reap fix` (`--check` for read-only), `reap clean`, `reap destroy`, `reap help`, `reap run`.
+
 ## Role Separation
 
 | Component | Role |
 |-----------|------|
-| **CLI (`reap`)** | Project setup and maintenance. Init, status, update, fix |
+| **CLI (`reap`)** | Project setup and maintenance. Init, status, update, fix, clean, destroy |
 | **AI Agent** | Workflow executor. Performs each stage's work via slash commands |
 | **Human** | Decision maker. Sets goals, finalizes specs, reviews code, approves stage transitions |
 

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

@@ -148,18 +148,24 @@ const { content: genomeContent, l1Lines } = gl.loadGenome(genomeDir);
 const envSummaryFile = path.join(reapDir, 'environment', 'summary.md');
 const envSummary = gl.readFile(envSummaryFile) || '';
 
-// Step 4: Check Genome staleness
-log('Checking sync...');
-const { genomeStaleWarning, commitsSince } = gl.detectStaleness(projectRoot);
-
 // Step 5: Read generation state
 log('Reading generation state...');
-const { strictEdit, strictMerge } = gl.parseConfig(configFile);
+const { strictEdit, strictMerge, language, lastSyncedGeneration, lastSyncedCommit } = gl.parseConfig(configFile);
+
+// Step 4: Check Genome staleness
+log('Checking sync...');
+const { genomeStaleWarning, commitsSince, neverSynced } = gl.detectStaleness(projectRoot, lastSyncedGeneration, lastSyncedCommit);
 const { genStage, genId, generationContext, nextCmd } = gl.parseCurrentYml(currentYml);
 
 // Build strict mode section
 const strictSection = gl.buildStrictSection(strictEdit, strictMerge, genStage);
 
+// Build language instruction
+let langSection = '';
+if (language) {
+  langSection = `\n\n## Language\nAlways respond in ${language}. Use ${language} for all explanations, comments, and communications with the user. Technical terms and code identifiers should remain in their original form.`;
+}
+
 // Build staleness section
 let staleSection = '';
 if (genomeStaleWarning) {
@@ -177,7 +183,7 @@ const initLines = [];
 if (autoUpdateMessage) initLines.push(`🟢 ${autoUpdateMessage}`);
 
 // Genome health
-const health = gl.buildGenomeHealth({ l1Lines, genomeDir, configFile, genomeStaleWarning, commitsSince });
+const health = gl.buildGenomeHealth({ l1Lines, genomeDir, configFile, genomeStaleWarning, commitsSince, neverSynced });
 initLines.push(...health.initLines);
 
 // Generation status
@@ -210,7 +216,7 @@ log('Done. Injecting context.');
 
 const envSection = envSummary ? `\n\n---\n\n## Environment (External Context)\n${envSummary}` : '';
 
-const reapContext = `<REAP_WORKFLOW>\n${reapGuide}\n\n---\n\n## Genome (Project Knowledge — treat as authoritative source of truth)\n${genomeContent}${envSection}\n\n---\n\n## Current State\n${generationContext}${staleSection}${strictSection}${updateSection}\n\n## Session Init (display to user on first message)\n${sessionInitDisplay}\n\n## Rules\n1. ALL development work MUST follow the REAP lifecycle. Do NOT bypass it.\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, fix bugs, or make changes outside of the REAP lifecycle unless the user explicitly asks to bypass it.\n6. When the user says "reap evolve", "next stage", "proceed", or similar — invoke the appropriate REAP skill.\n7. **Genome is the authoritative knowledge source.** When making decisions about architecture, conventions, or constraints, ALWAYS reference the Genome first. If code contradicts Genome, flag it as a potential genome-change backlog item.\n8. If you notice the Genome is outdated or missing information relevant to your current task, inform the user and suggest running \`/reap.sync\`.\n</REAP_WORKFLOW>`;
+const reapContext = `<REAP_WORKFLOW>\n${reapGuide}\n\n---\n\n## Genome (Project Knowledge — treat as authoritative source of truth)\n${genomeContent}${envSection}\n\n---\n\n## Current State\n${generationContext}${staleSection}${strictSection}${updateSection}${langSection}\n\n## Session Init (display to user on first message)\n${sessionInitDisplay}\n\n## Rules\n1. ALL development work MUST follow the REAP lifecycle. Do NOT bypass it.\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, fix bugs, or make changes outside of the REAP lifecycle unless the user explicitly asks to bypass it.\n6. When the user says "reap evolve", "next stage", "proceed", or similar — invoke the appropriate REAP skill.\n7. **Genome is the authoritative knowledge source.** When making decisions about architecture, conventions, or constraints, ALWAYS reference the Genome first. If code contradicts Genome, flag it as a potential genome-change backlog item.\n8. If you notice the Genome is outdated or missing information relevant to your current task, inform the user and suggest running \`/reap.sync\`.\n</REAP_WORKFLOW>`;
 
 process.stdout.write(JSON.stringify({
   hookSpecificOutput: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c-d-cc/reap",
-  "version": "0.15.0",
+  "version": "0.15.1",
   "description": "Recursive Evolutionary Autonomous Pipeline — AI and humans evolve software across generations",
   "type": "module",
   "license": "MIT",