codex-genesis-harness 0.1.4 → 0.1.6

package/scripts/transition_state.sh

@@ -0,0 +1,67 @@
+#!/bin/bash
+
+if [ -z "$1" ]; then
+  echo "Usage: bash scripts/transition_state.sh <NEW_STATE> [Reason]"
+  exit 1
+fi
+
+NEW_STATE=$1
+REASON=${2:-"State transition"}
+STATE_FILE=".codebase/state.json"
+CURRENT_STATE_MD=".codebase/CURRENT_STATE.md"
+
+if [ ! -f "$STATE_FILE" ]; then
+  echo "Error: $STATE_FILE not found."
+  exit 1
+fi
+
+if [ "$NEW_STATE" == "COMPLETED" ]; then
+  if [ -f "scripts/validation_gates.sh" ]; then
+    echo "Running Validation Gates before transitioning to COMPLETED..."
+    if ! bash scripts/validation_gates.sh; then
+      echo "Transition blocked by Validation Gates."
+      exit 1
+    fi
+  fi
+fi
+
+node -e "
+const fs = require('fs');
+const file = '$STATE_FILE';
+const newState = '$NEW_STATE';
+const reason = '$REASON';
+
+const allowed = {
+  'INIT': ['REQUIREMENTS_GATHERING', 'PLANNING'],
+  'REQUIREMENTS_GATHERING': ['PLANNING'],
+  'PLANNING': ['IMPLEMENTATION'],
+  'IMPLEMENTATION': ['VERIFICATION', 'PLANNING'],
+  'VERIFICATION': ['COMPLETED', 'IMPLEMENTATION'],
+  'COMPLETED': ['INIT', 'REQUIREMENTS_GATHERING']
+};
+
+let data = JSON.parse(fs.readFileSync(file, 'utf8'));
+const current = data.current_state || 'INIT';
+
+if (allowed[current] && allowed[current].includes(newState)) {
+  data.history = data.history || [];
+  data.history.push({ from: current, to: newState, reason: reason, timestamp: new Date().toISOString() });
+  data.current_state = newState;
+  fs.writeFileSync(file, JSON.stringify(data, null, 2));
+  console.log('Transition successful: ' + current + ' -> ' + newState);
+} else {
+  console.error('Invalid transition from ' + current + ' to ' + newState);
+  process.exit(1);
+}
+"
+
+if [ $? -eq 0 ]; then
+  echo "# Current State: $NEW_STATE" > "$CURRENT_STATE_MD"
+  echo "Last updated: $(date)" >> "$CURRENT_STATE_MD"
+  echo "" >> "$CURRENT_STATE_MD"
+  echo "## Reason" >> "$CURRENT_STATE_MD"
+  echo "$REASON" >> "$CURRENT_STATE_MD"
+  exit 0
+else
+  exit 1
+fi

package/scripts/uninstall.sh

@@ -7,6 +7,7 @@ skill_names=(
   genesis-upgrade-design
   genesis-architecture
   genesis-planning
+  genesis-mvp-planning
   genesis-codebase-map
   genesis-design-spec
   genesis-api-contract

package/scripts/validation_gates.sh

@@ -0,0 +1,85 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+echo "====================================="
+echo "   RUNNING VALIDATION GATES          "
+echo "====================================="
+
+repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+FAILURES=0
+
+fail() {
+  echo "❌ VALIDATION FAILED: $*" >&2
+  FAILURES=$((FAILURES + 1))
+}
+
+echo "1. Checking for leftover debug logs and TODOs..."
+# Exclude node_modules, .git, .codex, scripts, .codebase, bin, and md files
+EXCLUDES="--exclude-dir=node_modules --exclude-dir=.git --exclude-dir=.codex --exclude-dir=scripts --exclude-dir=.codebase --exclude-dir=bin --exclude=*.md"
+
+# We check for TODO, FIXME, console.log, print( (python)
+# Using grep recursively
+if grep -rn $EXCLUDES -E 'TODO|FIXME|console\.log|print\(' "$repo_root" | grep -v 'validation_gates.sh'; then
+  fail "Found unresolved TODOs or leftover debug logs in codebase!"
+else
+  echo "✅ Codebase cleanliness gate passed."
+fi
+
+echo "2. Verifying Harness Integrity..."
+if [ -f "$repo_root/scripts/verify.sh" ]; then
+  if bash "$repo_root/scripts/verify.sh" > /dev/null 2>&1; then
+    echo "✅ Harness Integrity gate passed."
+  else
+    fail "verify.sh failed. Core files or templates are missing."
+  fi
+fi
+
+echo "3. Checking for Documentation Drift (Alignment with Code changes)..."
+if [ -d "$repo_root/.git" ]; then
+  # Get list of modified files in git
+  CHANGED_FILES=$(git diff --name-only HEAD 2>/dev/null || true)
+  
+  if [ -n "$CHANGED_FILES" ]; then
+    # API Drift: code under src/ modified, but API contracts not updated
+    if echo "$CHANGED_FILES" | grep -qE "src/.*api|src/.*endpoint|src/.*route" && ! echo "$CHANGED_FILES" | grep -qE "contracts/api/|.codebase/API_CONTRACTS.md|.planning/API_DOCS.md"; then
+      echo "⚠️  WARNING: You changed API code under src/ but did not update API_CONTRACTS.md, API_DOCS.md or contracts/api/!"
+    fi
+
+    # Database Drift: models or schemas modified, but DOMAIN_MODELS.md not updated
+    if echo "$CHANGED_FILES" | grep -qE "model|schema|db" && ! echo "$CHANGED_FILES" | grep -qE ".codebase/DOMAIN_MODELS.md"; then
+      echo "⚠️  WARNING: You changed database/model files but did not update DOMAIN_MODELS.md!"
+    fi
+
+    # Test Drift: test files modified, but TEST_MATRIX.md not updated
+    if echo "$CHANGED_FILES" | grep -qE "tests/|playwright/" && ! echo "$CHANGED_FILES" | grep -qE ".codebase/TEST_MATRIX.md"; then
+      echo "⚠️  WARNING: You changed test files but did not update TEST_MATRIX.md!"
+    fi
+
+    # Dependency Drift: package.json dependencies modified, but DEPENDENCY_GRAPH.md not updated
+    if echo "$CHANGED_FILES" | grep -q "package.json" && ! echo "$CHANGED_FILES" | grep -q ".codebase/DEPENDENCY_GRAPH.md"; then
+      if git diff package.json 2>/dev/null | grep -qE '^\+.*"(dependencies|devDependencies)"'; then
+        echo "⚠️  WARNING: You updated package.json dependencies but did not update DEPENDENCY_GRAPH.md!"
+      fi
+    fi
+    echo "✅ Documentation alignment check complete."
+  fi
+else
+  echo "⚠️  Git repository not found. Skipping drift check."
+fi
+
+echo "4. Running Pre-emptive Prompt Sentinel check..."
+if [ -f "$repo_root/scripts/prompt_sentinel.js" ] && [ -f "$repo_root/.codebase/CURRENT_STATE.md" ]; then
+  # Run prompt sentinel check on the state file as a pre-flight test
+  node "$repo_root/scripts/prompt_sentinel.js" --check "$repo_root/.codebase/CURRENT_STATE.md" --threshold 1500
+fi
+
+
+
+echo "====================================="
+if [ $FAILURES -gt 0 ]; then
+  echo "❌ $FAILURES Validation Gate(s) failed."
+  exit 1
+else
+  echo "✅ All Validation Gates passed! Output is ready for production."
+  exit 0
+fi

package/scripts/verify.sh

@@ -9,6 +9,7 @@ skill_names=(
   genesis-upgrade-design
   genesis-architecture
   genesis-planning
+  genesis-mvp-planning
   genesis-codebase-map
   genesis-design-spec
   genesis-api-contract
@@ -275,6 +276,10 @@ verify_one() {
       verify_skill_metadata "$skill_dir" "planning-skill"
       verify_skill_protocol "$skill_dir"
       ;;
+    genesis-mvp-planning)
+      verify_skill_metadata "$skill_dir" "genesis-mvp-planning"
+      verify_minimal_skill "$skill_dir"
+      ;;
     genesis-codebase-map)
       verify_skill_metadata "$skill_dir" "codebase-map-skill"
       verify_skill_protocol "$skill_dir"

package/tests/unit/contract_integrity_gate.test.js

@@ -0,0 +1,74 @@
+/**
+ * Unit Test for contract_integrity_gate.js
+ * Part of Genesis Codex Harness v0.1.8
+ */
+
+const assert = require('assert');
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+console.log('Running contract_integrity_gate.js unit tests...');
+
+const TEST_CODE_PATH = path.resolve(__dirname, 'temp_dummy_code.js');
+const TEST_CONTRACT_PATH = path.resolve(__dirname, 'temp_dummy_contract.json');
+
+try {
+  // Setup dummy contract
+  const dummySchema = {
+    $schema: 'http://json-schema.org/draft-07/schema#',
+    title: 'Dummy Contract',
+    type: 'object',
+    properties: {
+      name: { type: 'string' },
+      score: { type: 'number' }
+    },
+    required: ['name', 'score']
+  };
+  fs.writeFileSync(TEST_CONTRACT_PATH, JSON.stringify(dummySchema, null, 2), 'utf8');
+
+  // Test case 1: Happy path (clean code matching schema keys)
+  console.log('  1. Testing matching code content...');
+  const cleanCode = `
+    const user = {
+      name: 'Alice',
+      score: 95
+    };
+  `;
+  fs.writeFileSync(TEST_CODE_PATH, cleanCode, 'utf8');
+
+  const stdoutHappy = execSync(`node scripts/contract_integrity_gate.js --code "${TEST_CODE_PATH}" --contract "${TEST_CONTRACT_PATH}"`, { encoding: 'utf8' });
+  assert.ok(stdoutHappy.includes('INTEGRITY SUCCESS'), 'Must report integrity success when keys match.');
+  console.log('  ✓ Test case 1 passed: Matching keys pass gate successfully.');
+
+  // Test case 2: Failure path (missing a key in the code)
+  console.log('  2. Testing missing key code content...');
+  const brokenCode = `
+    const user = {
+      name: 'Bob'
+      // score is missing!
+    };
+  `;
+  fs.writeFileSync(TEST_CODE_PATH, brokenCode, 'utf8');
+
+  try {
+    execSync(`node scripts/contract_integrity_gate.js --code "${TEST_CODE_PATH}" --contract "${TEST_CONTRACT_PATH}" 2>&1`, { encoding: 'utf8' });
+    assert.fail('Should throw an error and return exit code 1 for missing fields.');
+  } catch (err) {
+    const errorOutput = err.stdout || err.message;
+    assert.ok(errorOutput.includes('INTEGRITY FAILURE'), 'Must report integrity failure.');
+    assert.ok(errorOutput.includes('Missing property: "score"'), 'Must report exact missing property name.');
+    console.log('  ✓ Test case 2 passed: Missing key correctly blocks the gate.');
+  }
+
+} finally {
+  if (fs.existsSync(TEST_CODE_PATH)) {
+    fs.unlinkSync(TEST_CODE_PATH);
+  }
+  if (fs.existsSync(TEST_CONTRACT_PATH)) {
+    fs.unlinkSync(TEST_CONTRACT_PATH);
+  }
+}
+
+console.log('All contract_integrity_gate.js tests passed! ✓\n');
+process.exit(0);

package/tests/unit/healing_telemetry.test.js

@@ -0,0 +1,58 @@
+/**
+ * Unit Test for healing_telemetry.js
+ * Part of Genesis Codex Harness v0.1.8
+ */
+
+const assert = require('assert');
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+console.log('Running healing_telemetry.js unit tests...');
+
+const TEST_LESSONS_PATH = path.resolve(__dirname, '../../.codebase/failures/lessons_learned.md');
+
+// Backup existing if any
+let originalLessons = null;
+if (fs.existsSync(TEST_LESSONS_PATH)) {
+  originalLessons = fs.readFileSync(TEST_LESSONS_PATH, 'utf8');
+} else {
+  // Ensure directory exists
+  fs.mkdirSync(path.dirname(TEST_LESSONS_PATH), { recursive: true });
+}
+
+try {
+  // Clean start
+  if (fs.existsSync(TEST_LESSONS_PATH)) {
+    fs.unlinkSync(TEST_LESSONS_PATH);
+  }
+
+  // Test case 1: Record a successful self-healing fix signature
+  console.log('  1. Testing record signature...');
+  execSync('node scripts/healing_telemetry.js --record --error "SyntaxError: Unexpected token" --file "src/routes.js" --fix "Add missing closing brace to route handler"', { encoding: 'utf8' });
+
+  assert.ok(fs.existsSync(TEST_LESSONS_PATH), 'Lessons database file must be created.');
+  const dbContent = fs.readFileSync(TEST_LESSONS_PATH, 'utf8');
+  assert.ok(dbContent.includes('SyntaxError: Unexpected token'), 'Must contain matching error signature.');
+  assert.ok(dbContent.includes('Add missing closing brace'), 'Must contain matching fix payload.');
+  console.log('  ✓ Test case 1 passed: Lessons correctly recorded in markdown database.');
+
+  // Test case 2: Recall / retrieve matching fix signature
+  console.log('  2. Testing recall search query matching...');
+  const stdoutRecall = execSync('node scripts/healing_telemetry.js --recall --error "SyntaxError: Unexpected token at src/routes.js:25"', { encoding: 'utf8' });
+  
+  assert.ok(stdoutRecall.includes('RECALL MATCH FOUND'), 'Must report matching signature is found.');
+  assert.ok(stdoutRecall.includes('SUGGESTED_FIX_START: Add missing closing brace to route handler'), 'Must output matching corrective snippet.');
+  console.log('  ✓ Test case 2 passed: Match recall and fix parsing is 100% correct.');
+
+} finally {
+  // Cleanup test structures
+  if (originalLessons !== null) {
+    fs.writeFileSync(TEST_LESSONS_PATH, originalLessons, 'utf8');
+  } else if (fs.existsSync(TEST_LESSONS_PATH)) {
+    fs.unlinkSync(TEST_LESSONS_PATH);
+  }
+}
+
+console.log('All healing_telemetry.js tests passed! ✓\n');
+process.exit(0);

package/tests/unit/prompt_sentinel.test.js

@@ -0,0 +1,50 @@
+/**
+ * Unit Test for prompt_sentinel.js
+ * Part of Genesis Codex Harness v0.1.7
+ */
+
+const assert = require('assert');
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+console.log('Running prompt_sentinel.js unit tests...');
+
+const TEST_FILE_PATH = path.resolve(__dirname, 'prompt_sentinel_bloated_temp.log');
+
+try {
+  // Test case 1: In bounds threshold
+  console.log('  1. Testing in-bounds file check...');
+  fs.writeFileSync(TEST_FILE_PATH, 'Short log lines for in-bounds testing.\n'.repeat(10), 'utf8');
+  
+  const stdoutSafe = execSync(`node scripts/prompt_sentinel.js --check "${TEST_FILE_PATH}" --threshold 100`, { encoding: 'utf8' });
+  assert.ok(stdoutSafe.includes('Token payload is within safe boundaries'), 'Must report safe bounds.');
+  
+  const lineCountSafe = fs.readFileSync(TEST_FILE_PATH, 'utf8').trim().split('\n').length;
+  assert.strictEqual(lineCountSafe, 10, 'File must not be truncated when in bounds.');
+  console.log('  ✓ Test case 1 passed: Safe boundaries are respected without changes.');
+
+  // Test case 2: Out of bounds threshold (triggers truncation)
+  console.log('  2. Testing out-of-bounds file check and truncation...');
+  fs.writeFileSync(TEST_FILE_PATH, 'Redundant bloated log data line entry.\n'.repeat(1200), 'utf8');
+
+  // Run with threshold of 100 tokens (will exceed, trigger truncation)
+  const stdoutExcessive = execSync(`node scripts/prompt_sentinel.js --check "${TEST_FILE_PATH}" --threshold 100 2>&1`, { encoding: 'utf8' });
+  assert.ok(stdoutExcessive.includes('exceeds the safety threshold'), 'Must log threshold exceeded warning.');
+  assert.ok(stdoutExcessive.includes('truncated successfully'), 'Must log truncation success message.');
+
+  const truncatedContent = fs.readFileSync(TEST_FILE_PATH, 'utf8');
+  const truncatedLines = truncatedContent.split('\n');
+  assert.ok(truncatedLines.length <= 1005, 'File must be truncated to standard boundaries (approx. 1000 lines).');
+  assert.ok(truncatedContent.includes('PROMPT SENTINEL AUTO-TRUNCATION'), 'Must contain sentinel truncation statement.');
+
+  console.log('  ✓ Test case 2 passed: Out-of-bounds trigger successfully auto-truncates data.');
+
+} finally {
+  if (fs.existsSync(TEST_FILE_PATH)) {
+    fs.unlinkSync(TEST_FILE_PATH);
+  }
+}
+
+console.log('All prompt_sentinel.js tests passed! ✓\n');
+process.exit(0);

package/tests/unit/spec_visual_sync.test.js

@@ -0,0 +1,77 @@
+/**
+ * Unit Test for spec_visual_sync.js
+ * Part of Genesis Codex Harness v0.1.7
+ */
+
+const assert = require('assert');
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+console.log('Running spec_visual_sync.js unit tests...');
+
+const TEST_PLANNING_DIR = path.resolve(__dirname, '../../.planning/diagrams');
+const TEST_ERD_PATH = path.join(TEST_PLANNING_DIR, 'database-erd.mmd');
+const TEST_CONTRACTS_DIR = path.resolve(__dirname, '../../contracts/api/testentity');
+const TEST_CONTRACT_PATH = path.join(TEST_CONTRACTS_DIR, 'response.json');
+
+// Backup existing if any
+let originalErd = null;
+if (fs.existsSync(TEST_ERD_PATH)) {
+  originalErd = fs.readFileSync(TEST_ERD_PATH, 'utf8');
+}
+
+// Ensure clean directories
+fs.mkdirSync(TEST_PLANNING_DIR, { recursive: true });
+fs.mkdirSync(TEST_CONTRACTS_DIR, { recursive: true });
+
+try {
+  // Test case 1: Parse ERD to Contract JSON
+  const dummyErd = `erDiagram
+  TESTENTITY {
+    string name
+    int id
+    bool active
+  }
+`;
+  fs.writeFileSync(TEST_ERD_PATH, dummyErd, 'utf8');
+
+  console.log('  1. Running spec_visual_sync.js --from-erd...');
+  execSync('node scripts/spec_visual_sync.js --from-erd');
+
+  assert.ok(fs.existsSync(TEST_CONTRACT_PATH), 'Contract file response.json must be created.');
+  const contract = JSON.parse(fs.readFileSync(TEST_CONTRACT_PATH, 'utf8'));
+
+  assert.strictEqual(contract.title, 'Testentity Contract');
+  assert.strictEqual(contract.properties.name.type, 'string');
+  assert.strictEqual(contract.properties.id.type, 'number');
+  assert.strictEqual(contract.properties.active.type, 'boolean');
+  console.log('  ✓ Test case 1 passed: ERD to Contract parsing is 100% correct.');
+
+  // Test case 2: Generate ERD from Contract
+  console.log('  2. Running spec_visual_sync.js --to-erd...');
+  execSync('node scripts/spec_visual_sync.js --to-erd');
+
+  const compiledErd = fs.readFileSync(TEST_ERD_PATH, 'utf8');
+  assert.ok(compiledErd.includes('TESTENTITY'), 'Erd must contain entity TESTENTITY.');
+  assert.ok(compiledErd.includes('int id'), 'Erd must contain attribute int id.');
+  assert.ok(compiledErd.includes('bool active'), 'Erd must contain attribute bool active.');
+  console.log('  ✓ Test case 2 passed: Contract to ERD generation is 100% correct.');
+
+} finally {
+  // Cleanup test structures
+  if (fs.existsSync(TEST_CONTRACT_PATH)) {
+    fs.unlinkSync(TEST_CONTRACT_PATH);
+  }
+  if (fs.existsSync(TEST_CONTRACTS_DIR)) {
+    fs.rmdirSync(TEST_CONTRACTS_DIR);
+  }
+  if (originalErd !== null) {
+    fs.writeFileSync(TEST_ERD_PATH, originalErd, 'utf8');
+  } else if (fs.existsSync(TEST_ERD_PATH)) {
+    fs.unlinkSync(TEST_ERD_PATH);
+  }
+}
+
+console.log('All spec_visual_sync.js tests passed! ✓\n');
+process.exit(0);

package/tests/unit/test_generator.test.js

@@ -0,0 +1,62 @@
+/**
+ * Unit Test for test_generator.js
+ * Part of Genesis Codex Harness v0.1.7
+ */
+
+const assert = require('assert');
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+console.log('Running test_generator.js unit tests...');
+
+const TEST_CONTRACT_DIR = path.resolve(__dirname, '../../contracts/api/testendpoint');
+const TEST_RESPONSE_PATH = path.join(TEST_CONTRACT_DIR, 'response.json');
+const EXPECTED_TEST_PATH = path.resolve(__dirname, '../../tests/integration/testendpoint.test.js');
+
+// Ensure clean directories
+fs.mkdirSync(TEST_CONTRACT_DIR, { recursive: true });
+
+try {
+  // Setup mock contract
+  const mockSchema = {
+    $schema: 'http://json-schema.org/draft-07/schema#',
+    title: 'Test Endpoint response schema',
+    type: 'object',
+    properties: {
+      name: { type: 'string' },
+      score: { type: 'number' }
+    },
+    required: ['name']
+  };
+
+  fs.writeFileSync(TEST_RESPONSE_PATH, JSON.stringify(mockSchema, null, 2), 'utf8');
+
+  console.log('  1. Running test_generator.js testendpoint...');
+  execSync('node scripts/test_generator.js testendpoint');
+
+  assert.ok(fs.existsSync(EXPECTED_TEST_PATH), 'Integration test file must be generated.');
+
+  const generatedCode = fs.readFileSync(EXPECTED_TEST_PATH, 'utf8');
+  assert.ok(generatedCode.includes('TDD Contract Compliance Test Suite'), 'Test suite must contain header statement.');
+  assert.ok(generatedCode.includes("data.name, 'string'"), 'Test code must assert property name is string.');
+  assert.ok(generatedCode.includes("data.score, 'number'"), 'Test code must assert property score is number.');
+  assert.ok(generatedCode.includes('["name"]'), 'Test code must assert required fields list matches contract.');
+
+  console.log('  ✓ Test case passed: Integration test template compilation is 100% correct.');
+
+} finally {
+  // Cleanup
+  if (fs.existsSync(TEST_RESPONSE_PATH)) {
+    fs.unlinkSync(TEST_RESPONSE_PATH);
+  }
+  if (fs.existsSync(TEST_CONTRACT_DIR)) {
+    fs.rmdirSync(TEST_CONTRACT_DIR);
+  }
+  if (fs.existsSync(EXPECTED_TEST_PATH)) {
+    fs.unlinkSync(EXPECTED_TEST_PATH);
+  }
+}
+
+console.log('All test_generator.js tests passed! ✓\n');
+process.exit(0);