codex-genesis-harness 0.1.7 → 0.1.8

package/scripts/cold-start-check.js

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+"use strict";
+
+/**
+ * cold-start-check.js
+ * L03 – Repository is the Single Source of Truth
+ *
+ * Automated cold-start test: verifies a brand-new agent can answer the
+ * 5 fundamental questions from the repository alone, without external knowledge.
+ *
+ * Usage: node scripts/cold-start-check.js
+ * Exit: 0 = all 5 questions answerable, 1 = gap detected
+ */
+
+const fs = require("fs");
+const path = require("path");
+
+const repoRoot = path.resolve(__dirname, "..");
+
+const fail = (msg) => {
+  console.error(`cold-start FAIL: ${msg}`);
+  process.exit(1);
+};
+
+const check = (condition, failMsg) => {
+  if (!condition) fail(failMsg);
+};
+
+const readFile = (relPath) => {
+  const abs = path.join(repoRoot, relPath);
+  if (!fs.existsSync(abs)) fail(`Required file missing: ${relPath}`);
+  return fs.readFileSync(abs, "utf8");
+};
+
+console.log("Running cold-start check (L03 — Repo as Source of Truth)...\n");
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Q1: What is this project?
+// Answer must be findable in AGENTS.md or README.md
+// ─────────────────────────────────────────────────────────────────────────────
+console.log("Q1: What is this project?");
+const agents = readFile("AGENTS.md");
+check(
+  agents.length > 100,
+  "Q1 FAIL: AGENTS.md is too short to answer 'what is this project?'"
+);
+const readme = readFile("README.md");
+check(
+  readme.includes("genesis-harness") || readme.includes("Genesis"),
+  "Q1 FAIL: README.md does not describe the project by name"
+);
+console.log("  ✅ Answerable from AGENTS.md + README.md\n");
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Q2: How do I run it?
+// Answer must be findable in AGENTS.md with npm run commands
+// ─────────────────────────────────────────────────────────────────────────────
+console.log("Q2: How do I run/verify it?");
+check(
+  agents.includes("npm run verify") || agents.includes("scripts/verify.sh"),
+  "Q2 FAIL: AGENTS.md does not document how to run verification"
+);
+const pkg = JSON.parse(readFile("package.json"));
+check(
+  pkg.scripts && pkg.scripts.verify,
+  "Q2 FAIL: package.json missing 'verify' script"
+);
+console.log("  ✅ Answerable from AGENTS.md + package.json\n");
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Q3: How do I test it?
+// Answer must be findable in TEST_MATRIX.md
+// ─────────────────────────────────────────────────────────────────────────────
+console.log("Q3: How do I run the tests?");
+const testMatrix = readFile(".codebase/TEST_MATRIX.md");
+check(
+  testMatrix.includes("verify.sh") && testMatrix.includes("run-evals.sh"),
+  "Q3 FAIL: TEST_MATRIX.md does not document test commands"
+);
+check(
+  fs.existsSync(path.join(repoRoot, "scripts", "verify.sh")),
+  "Q3 FAIL: scripts/verify.sh does not exist"
+);
+check(
+  fs.existsSync(path.join(repoRoot, "scripts", "run-evals.sh")),
+  "Q3 FAIL: scripts/run-evals.sh does not exist"
+);
+console.log("  ✅ Answerable from TEST_MATRIX.md + scripts/\n");
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Q4: What is the high-level architecture?
+// Answer must be findable in MODULE_INDEX.md + VISUAL_GRAPH.md
+// ─────────────────────────────────────────────────────────────────────────────
+console.log("Q4: What is the architecture?");
+const moduleIndex = readFile(".codebase/MODULE_INDEX.md");
+check(
+  moduleIndex.includes(".codex/skills/") && moduleIndex.includes("contracts/"),
+  "Q4 FAIL: MODULE_INDEX.md does not describe key architectural components"
+);
+const visualGraph = readFile(".codebase/VISUAL_GRAPH.md");
+check(
+  visualGraph.includes("```mermaid"),
+  "Q4 FAIL: VISUAL_GRAPH.md does not contain a Mermaid architecture diagram"
+);
+console.log("  ✅ Answerable from MODULE_INDEX.md + VISUAL_GRAPH.md\n");
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Q5: Where am I / what's the current state?
+// Answer must be findable in CURRENT_STATE.md + state.json
+// ─────────────────────────────────────────────────────────────────────────────
+console.log("Q5: Where are we / what is the current state?");
+const currentState = readFile(".codebase/CURRENT_STATE.md");
+check(
+  currentState.includes("2026"),
+  "Q5 FAIL: CURRENT_STATE.md does not have a current-year timestamp (may be stale)"
+);
+const stateJson = JSON.parse(readFile(".codebase/state.json"));
+check(
+  stateJson.current_state,
+  "Q5 FAIL: state.json missing 'current_state' field"
+);
+check(
+  stateJson.completed_at || stateJson.active_work,
+  "Q5 FAIL: state.json missing completion/active state markers"
+);
+console.log("  ✅ Answerable from CURRENT_STATE.md + state.json\n");
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Summary
+// ─────────────────────────────────────────────────────────────────────────────
+console.log("━".repeat(50));
+console.log("cold-start check passed — all 5 questions answerable");
+console.log("Repository passes L03: Single Source of Truth test.");

package/scripts/install.sh

@@ -24,6 +24,10 @@ skill_names=(
   genesis-research-first
   genesis-release
   spec-impact-engine
+  genesis-executing-plans
+  genesis-test-driven-development
+  genesis-verification-before-completion
+  genesis-using-git-worktrees
 )
 source_root="$repo_root/.codex/skills"
 codex_home="${CODEX_HOME:-$HOME/.codex}"

package/scripts/prompt_sentinel.js

@@ -2,13 +2,38 @@
 
 /**
  * Pre-emptive Prompt Sentinel
- * Part of Genesis Codex Harness v0.1.7
+ * Part of Genesis Codex Harness v0.1.8
  */
 
 const fs = require('fs');
 const path = require('path');
 const { execSync } = require('child_process');
 
+function readJsonIfExists(filePath) {
+  if (!fs.existsSync(filePath)) return null;
+  try {
+    return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+  } catch (error) {
+    return null;
+  }
+}
+
+function loadContextPolicy() {
+  const defaultPolicy = {
+    token_budget: 12000,
+    compact_at: 0.7,
+    hard_stop_at: 0.85
+  };
+  const packageRoot = path.resolve(__dirname, '..');
+  const packagedPolicy = readJsonIfExists(path.join(packageRoot, '.codebase', 'context-policy.json'));
+  const projectPolicy = readJsonIfExists(path.resolve(process.cwd(), '.codebase', 'context-policy.json'));
+  return {
+    ...defaultPolicy,
+    ...(packagedPolicy || {}),
+    ...(projectPolicy || {})
+  };
+}
+
 function printUsage() {
   console.log('Usage:');
   console.log('  node scripts/prompt_sentinel.js --check <file-or-log-path> [--threshold <tokens>]');
@@ -21,7 +46,8 @@ if (args.length < 2 || args[0] !== '--check') {
 }
 
 const targetPath = path.resolve(process.cwd(), args[1]);
-let threshold = 20000; // Default safety threshold is 20k tokens
+const policy = loadContextPolicy();
+let threshold = Math.round(Number(policy.token_budget || 12000) * Number(policy.compact_at || 0.7));
 
 const thresholdIndex = args.indexOf('--threshold');
 if (thresholdIndex !== -1 && args[thresholdIndex + 1]) {
@@ -40,6 +66,7 @@ const estimatedTokens = Math.ceil(fileSizeChars / 4);
 console.log(`[Prompt Sentinel] Evaluating token load for: ${path.basename(targetPath)}`);
 console.log(`  - File size: ${fileSizeChars} characters`);
 console.log(`  - Estimated token payload: ${estimatedTokens} tokens (Safety threshold: ${threshold})`);
+console.log(`  - LeanCTX policy budget: ${policy.token_budget || 12000} tokens`);
 
 if (estimatedTokens > threshold) {
   console.warn(`\n[WARNING] [PROMPT SENTINEL] Payload of ${estimatedTokens} tokens exceeds the safety threshold of ${threshold}!`);
@@ -47,8 +74,12 @@ if (estimatedTokens > threshold) {
   console.warn(`[ACTION] Automatically triggering context compaction and log optimization...\n`);
 
   // Trigger compact-context script if it exists
-  const compactionScript = path.resolve(process.cwd(), 'scripts/compact-context.sh');
-  if (fs.existsSync(compactionScript)) {
+  const compactionScriptCandidates = [
+    path.resolve(process.cwd(), 'scripts/compact-context.sh'),
+    path.resolve(__dirname, '..', '.codex', 'skills', 'genesis-harness', 'scripts', 'compact-context.sh')
+  ];
+  const compactionScript = compactionScriptCandidates.find(candidate => fs.existsSync(candidate));
+  if (compactionScript) {
     try {
       console.log(`Executing: ${compactionScript}`);
       const output = execSync(`bash "${compactionScript}"`, { encoding: 'utf8' });

package/scripts/run-evals.sh

@@ -26,6 +26,10 @@ skill_names=(
   genesis-research-first
   genesis-release
   spec-impact-engine
+  genesis-executing-plans
+  genesis-test-driven-development
+  genesis-verification-before-completion
+  genesis-using-git-worktrees
 )
 
 fail() {
@@ -40,12 +44,44 @@ assert_file() {
 assert_contains() {
   local file="$1"
   local text="$2"
-  grep -q -- "$text" "$file" || fail "missing '$text' in ${file#$repo_root/}"
+  grep -Fq -- "$text" "$file" || fail "missing '$text' in ${file#$repo_root/}"
+}
+
+assert_not_contains() {
+  local file="$1"
+  local text="$2"
+  ! grep -Fq -- "$text" "$file" || fail "unexpected '$text' in ${file#$repo_root/}"
 }
 
 assert_file "$repo_root/.codex-plugin/plugin.json"
 assert_contains "$repo_root/.codex-plugin/plugin.json" '"skills"'
 assert_contains "$repo_root/.codex-plugin/plugin.json" '"genesis-skill-set"'
+assert_contains "$repo_root/.codex-plugin/plugin.json" '$genesis-pipeline-orchestration'
+assert_contains "$repo_root/.codex-plugin/plugin.json" '$genesis-api-contract'
+assert_not_contains "$repo_root/.codex-plugin/plugin.json" '$pipeline-orchestration-skill'
+assert_not_contains "$repo_root/.codex-plugin/plugin.json" '$api-contract-skill'
+assert_contains "$harness_dir/SKILL.md" '/genesis-init'
+assert_contains "$repo_root/.codex/SKILLS_INDEX.md" '/genesis-init'
+assert_contains "$repo_root/bin/genesis-harness.js" 'genesis-harness docs-gate'
+assert_contains "$repo_root/bin/genesis-harness.js" 'check-docs-sync.sh'
+assert_contains "$repo_root/bin/genesis-harness.js" 'npx genesis-harness docs-gate'
+assert_contains "$harness_dir/scripts/check-docs-sync.sh" '.codebase/'
+assert_contains "$harness_dir/scripts/check-docs-sync.sh" 'README(\.[A-Z]{2})?\.md'
+assert_contains "$repo_root/.codebase/VISUAL_GRAPH.md" 'genesis-harness'
+assert_contains "$repo_root/.codebase/PIPELINE_FLOW.md" 'fixture --> contracts["Update contracts when behavior changes"]'
+assert_contains "$repo_root/.codebase/PIPELINE_FLOW.md" 'contracts --> impl'
+assert_not_contains "$repo_root/.codebase/VISUAL_GRAPH.md" 'Đăng nhập'
+assert_not_contains "$repo_root/.codebase/VISUAL_GRAPH.md" 'src/auth.js'
+assert_contains "$repo_root/.codebase/IMPLEMENTATION_HANDOFF.md" 'Harness Drift Gate Hardening'
+assert_contains "$repo_root/.codebase/IMPLEMENTATION_HANDOFF.md" '2026-06-03'
+assert_not_contains "$repo_root/.codebase/IMPLEMENTATION_HANDOFF.md" '_[Name and reference]_'
+assert_not_contains "$repo_root/.codebase/IMPLEMENTATION_HANDOFF.md" 'Feature A'
+assert_not_contains "$repo_root/.codebase/IMPLEMENTATION_HANDOFF.md" 'YYYY-MM-DD'
+assert_contains "$repo_root/.codebase/state.json" '"completed_at": "2026-06-03'
+assert_contains "$repo_root/.codebase/CURRENT_STATE.md" '2026-06-03'
+assert_contains "$repo_root/.codebase/IMPLEMENTATION_HANDOFF.md" 'npm run eval'
+assert_not_contains "$repo_root/.codebase/IMPLEMENTATION_HANDOFF.md" 'rtk '
+assert_not_contains "$repo_root/.codebase/state.json" 'rtk '
 
 for ref in workflows.md planning-schema.md research-rubric.md quality-rubric.md; do
   assert_file "$harness_dir/references/$ref"
@@ -64,6 +100,7 @@ assert_contains "$repo_root/bin/genesis-harness.js" '--target agents|legacy|both
 assert_contains "$repo_root/package.json" '".codex-plugin"'
 assert_contains "$repo_root/package.json" '".codebase"'
 assert_contains "$repo_root/package.json" '"contracts"'
+assert_contains "$repo_root/package.json" '"features"'
 assert_contains "$repo_root/package.json" '"fixtures"'
 assert_contains "$repo_root/package.json" '"playwright"'
 assert_contains "$repo_root/package.json" '"observability"'
@@ -94,21 +131,100 @@ for skill_name in "${skill_names[@]}" project-genesis-harness; do
   [ ! -e "$tmp/codex/skills/$skill_name" ] || fail "legacy uninstall target remains: $skill_name"
 done
 
+install_seed_tmp="$(mktemp -d)"
+printf '{"name":"leanctx-install-fixture"}\n' > "$install_seed_tmp/package.json"
+(
+  cd "$install_seed_tmp"
+  CODEX_HOME="$tmp/codex" GENESIS_HARNESS_HOME="$tmp/agents" node "$repo_root/bin/genesis-harness.js" install --target agents >/dev/null
+)
+assert_file "$install_seed_tmp/.codebase/context-policy.json"
+assert_contains "$install_seed_tmp/.codebase/context-policy.json" '"token_budget": 12000'
+
 assert_contains "$repo_root/bin/genesis-harness.js" "genesis-harness remember"
 assert_contains "$repo_root/bin/genesis-harness.js" "genesis-harness recall"
-assert_contains "$repo_root/bin/genesis-harness.js" "genesis-harness forget"
-assert_contains "$repo_root/bin/genesis-harness.js" "genesis-harness prime"
+assert_contains "$repo_root/bin/genesis-harness.js" 'genesis-harness docs-gate'
+assert_contains "$repo_root/bin/genesis-harness.js" 'genesis-harness verify-gate'
+assert_contains "$repo_root/bin/genesis-harness.js" 'genesis-harness cold-start'
+assert_contains "$repo_root/bin/genesis-harness.js" "genesis-harness remember"
+assert_contains "$repo_root/bin/genesis-harness.js" "genesis-harness leanctx"
+assert_contains "$repo_root/bin/genesis-harness.js" "seedLeanCtxPolicy"
 assert_contains "$repo_root/bin/genesis-harness.js" "genesis-harness view-mockup"
+assert_file "$repo_root/.codebase/context-policy.json"
+assert_contains "$repo_root/.codebase/context-policy.json" '"token_budget"'
+assert_contains "$repo_root/scripts/prompt_sentinel.js" 'context-policy.json'
+assert_contains "$repo_root/README.md" 'LeanCTX'
+assert_contains "$repo_root/README.VI.md" 'LeanCTX'
+assert_contains "$repo_root/README.EN.md" 'LeanCTX'
 
 # Test Beads Memory Commands
 node "$repo_root/bin/genesis-harness.js" remember evalsmoke "Verify that evals can store facts." >/dev/null
 node "$repo_root/bin/genesis-harness.js" recall evalsmoke | grep -q "Verify that evals" || fail "recall failed to find test fact"
 node "$repo_root/bin/genesis-harness.js" prime | grep -q "Verify that evals" || fail "prime failed to include test fact"
+node "$repo_root/bin/genesis-harness.js" leanctx | grep -q "rtk optional" || fail "leanctx must keep rtk optional"
 
 # Find the ID of the stored fact to forget it
 bead_id=$(node "$repo_root/bin/genesis-harness.js" recall evalsmoke | grep -o "\[[0-9a-f]\{6\}\]" | head -n 1 | tr -d '[]')
 node "$repo_root/bin/genesis-harness.js" forget "$bead_id" >/dev/null
 node "$repo_root/bin/genesis-harness.js" recall evalsmoke | grep -q "Verify that evals" && fail "forget failed to delete test fact" || true
 
+for unit_test in "$repo_root"/tests/unit/*.test.js; do
+  node "$unit_test" >/dev/null
+done
+
+node "$repo_root/tests/integration/cli-smoke.test.js" >/dev/null
+
+sync_tmp="$(mktemp -d)"
+mkdir -p "$sync_tmp/.codebase" "$sync_tmp/src"
+printf '# Current State: Sync Fixture\n' > "$sync_tmp/.codebase/CURRENT_STATE.md"
+printf 'export const answer = 42;\n' > "$sync_tmp/src/index.js"
+(
+  cd "$sync_tmp"
+  node "$repo_root/bin/genesis-harness.js" sync >/dev/null
+)
+assert_contains "$sync_tmp/.codebase/VISUAL_GRAPH.md" 'Harness Relationship Map'
+assert_contains "$sync_tmp/.codebase/VISUAL_GRAPH.md" 'genesis-harness docs-gate'
+assert_contains "$sync_tmp/.codebase/VISUAL_GRAPH.md" '```mermaid'
+assert_not_contains "$sync_tmp/.codebase/VISUAL_GRAPH.md" 'Đăng nhập'
+assert_not_contains "$sync_tmp/.codebase/VISUAL_GRAPH.md" 'src/auth.js'
+
+# Test Packaged Install (Tarball)
+echo "Running tarball smoke test..."
+pack_tmp="$(mktemp -d)"
+npm pack --pack-destination "$pack_tmp" >/dev/null
+tarball_path=$(ls "$pack_tmp"/*.tgz | head -n 1)
+[ -f "$tarball_path" ] || fail "npm pack failed to produce tarball"
+(
+  cd "$pack_tmp"
+  tar xzf "$tarball_path"
+  cd package
+  bash scripts/verify.sh .codex/skills >/dev/null || exit 1
+) || fail "verification failed on packaged tarball"
+rm -rf "$pack_tmp"
+
+# L08 — Feature Registry as Harness Primitive
+# Ensures features/REGISTRY.md exists and is schema-valid with verify_cmd per feature.
+assert_file "$repo_root/features/REGISTRY.md"
+assert_contains "$repo_root/features/REGISTRY.md" "| id |"
+assert_contains "$repo_root/features/REGISTRY.md" "| status |"
+assert_contains "$repo_root/features/REGISTRY.md" "| verify_cmd |"
+assert_file "$repo_root/contracts/features/registry-schema.json"
+assert_contains "$repo_root/contracts/features/registry-schema.json" '"required_columns"'
+assert_contains "$repo_root/.codebase/MODULE_INDEX.md" "features/REGISTRY.md"
+
+# L11 — Observability Live Data
+# Ensures observability directories contain actual schema-backed data, not empty scaffolding.
+assert_file "$repo_root/contracts/observability/agent-run-schema.json"
+assert_contains "$repo_root/contracts/observability/agent-run-schema.json" '"required_fields"'
+assert_file "$repo_root/contracts/observability/failure-schema.json"
+assert_contains "$repo_root/contracts/observability/failure-schema.json" '"required_fields"'
+assert_file "$repo_root/observability/agent-runs/sample-run.json"
+assert_contains "$repo_root/observability/agent-runs/sample-run.json" '"session_id"'
+assert_contains "$repo_root/observability/agent-runs/sample-run.json" '"outcome"'
+assert_file "$repo_root/observability/failures/sample-failure.json"
+assert_contains "$repo_root/observability/failures/sample-failure.json" '"error_type"'
+assert_file "$repo_root/observability/decision-logs/sample-decision.md"
+# Must be a real decision, not the blank template
+! grep -Fq "What changed." "$repo_root/observability/decision-logs/sample-decision.md" \
+  || fail "L11: decision-logs/sample-decision.md must be a real decision, not a blank template"
 
 echo "evals passed"

package/scripts/scratch_parser.js

@@ -0,0 +1,49 @@
+const fs = require('fs');
+const parser = require('@babel/parser');
+const traverse = require('@babel/traverse').default;
+
+const code = `
+import { something } from './my-module';
+const x = require('another-module');
+export class MyClass {}
+export function myFunc() {}
+export const myArrow = async () => {};
+`;
+
+const ast = parser.parse(code, {
+  sourceType: 'module',
+  plugins: ['typescript']
+});
+
+const exportsList = [];
+const importsList = [];
+
+traverse(ast, {
+  ExportNamedDeclaration(path) {
+    const decl = path.node.declaration;
+    if (decl) {
+      if (decl.type === 'ClassDeclaration' && decl.id) {
+        exportsList.push('class ' + decl.id.name);
+      } else if (decl.type === 'FunctionDeclaration' && decl.id) {
+        exportsList.push('function ' + decl.id.name);
+      } else if (decl.type === 'VariableDeclaration') {
+        decl.declarations.forEach(d => {
+          if (d.id) exportsList.push('const ' + d.id.name);
+        });
+      }
+    }
+  },
+  ImportDeclaration(path) {
+    importsList.push(path.node.source.value);
+  },
+  CallExpression(path) {
+    if (path.node.callee.name === 'require' && path.node.arguments.length > 0) {
+      if (path.node.arguments[0].type === 'StringLiteral') {
+        importsList.push(path.node.arguments[0].value);
+      }
+    }
+  }
+});
+
+console.log('Exports:', exportsList);
+console.log('Imports:', importsList);

package/scripts/spec_visual_sync.js

@@ -2,7 +2,7 @@
 
 /**
  * Spec Visual Sync - Bi-directional AST Sync between Mermaid ERD and JSON Contracts
- * Part of Genesis Codex Harness v0.1.7
+ * Part of Genesis Codex Harness v0.1.8
  */
 
 const fs = require('fs');

package/scripts/test_generator.js

@@ -2,7 +2,7 @@
 
 /**
  * Contract-Driven Test Auto-Generator
- * Part of Genesis Codex Harness v0.1.7
+ * Part of Genesis Codex Harness v0.1.8
  */
 
 const fs = require('fs');
@@ -62,7 +62,7 @@ const requiredFields = schema.required || Object.keys(properties);
 // Construct test cases content
 let testSuiteCode = `/**
  * Integration Test for Endpoint: /api/${endpoint}
- * Automatically generated by Genesis Contract-Driven Test Generator (v0.1.7)
+ * Automatically generated by Genesis Contract-Driven Test Generator (v0.1.8)
  * Strictly Enforces TDD Contract Compliance.
  */
 

package/scripts/uninstall.sh

@@ -23,6 +23,10 @@ skill_names=(
   genesis-research-first
   genesis-release
   spec-impact-engine
+  genesis-executing-plans
+  genesis-test-driven-development
+  genesis-verification-before-completion
+  genesis-using-git-worktrees
   project-genesis-harness
 )
 codex_home="${CODEX_HOME:-$HOME/.codex}"

package/scripts/verify.sh

@@ -25,6 +25,10 @@ skill_names=(
   genesis-research-first
   genesis-release
   spec-impact-engine
+  genesis-executing-plans
+  genesis-test-driven-development
+  genesis-verification-before-completion
+  genesis-using-git-worktrees
 )
 
 required_memory_files=(
@@ -117,7 +121,14 @@ required_scripts=(
   run-verify-loop.sh
 )
 
+max_skill_lines=500
+
 fail() {
+  if [ "${VIBE_MODE:-0}" = "1" ]; then
+    echo "verify WARN (VIBE_MODE): $*" >&2
+    echo "- [$(date -u +"%Y-%m-%dT%H:%M:%SZ")] VIBE_MODE Bypass: Verify check failed - $*" >> "$repo_root/.codebase/TECH_DEBT.md"
+    return 0
+  fi
   echo "verify failed: $*" >&2
   exit 1
 }
@@ -172,9 +183,12 @@ verify_repository_harness
 verify_skill_metadata() {
   local skill_dir="$1"
   local expected_name="$2"
+  local skill_lines
 
   [ -f "$skill_dir/SKILL.md" ] || fail "missing SKILL.md: $skill_dir"
   [ -f "$skill_dir/agents/openai.yaml" ] || fail "missing agents/openai.yaml: $skill_dir"
+  skill_lines="$(wc -l < "$skill_dir/SKILL.md" | tr -d ' ')"
+  [ "$skill_lines" -le "$max_skill_lines" ] || fail "SKILL.md exceeds ${max_skill_lines} lines ($skill_lines): $skill_dir"
   grep -q "^name: $expected_name[[:space:]]*$" "$skill_dir/SKILL.md" || fail "invalid skill name frontmatter (expected 'name: $expected_name'): $skill_dir"
   grep -q '^description:' "$skill_dir/SKILL.md" || fail "missing description frontmatter: $skill_dir"
   grep -q 'default_prompt:' "$skill_dir/agents/openai.yaml" || fail "missing default_prompt: $skill_dir"
@@ -246,6 +260,7 @@ verify_minimal_skill() {
   local skill_dir="$1"
 
   [ -d "$skill_dir/templates" ] || fail "missing templates/: $skill_dir"
+  [ -d "$skill_dir/checklists" ] || fail "missing checklists/: $skill_dir"
   [ -d "$skill_dir/examples" ] || fail "missing examples/: $skill_dir"
 }
 
@@ -264,7 +279,7 @@ verify_one() {
     genesis-new-design|genesis-upgrade-design)
       verify_design_skill "$skill_dir" "$dir_name"
       ;;
-    genesis-architecture|genesis-planning|genesis-codebase-map|genesis-design-spec|genesis-api-contract|genesis-ui-ux-test|genesis-harness-engineering|genesis-ai-provider|genesis-pipeline-orchestration|genesis-api-sync)
+    genesis-architecture|genesis-planning|genesis-codebase-map|genesis-design-spec|genesis-api-contract|genesis-ui-ux-test|genesis-harness-engineering|genesis-ai-provider|genesis-pipeline-orchestration|genesis-api-sync|genesis-executing-plans|genesis-test-driven-development|genesis-verification-before-completion|genesis-using-git-worktrees)
       verify_skill_metadata "$skill_dir" "$dir_name"
       verify_skill_protocol "$skill_dir"
       ;;

package/tests/integration/cli-smoke.test.js

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+"use strict";
+
+const assert = require("assert");
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+const { execFileSync } = require("child_process");
+
+const repoRoot = path.resolve(__dirname, "..", "..");
+const cli = path.join(repoRoot, "bin", "genesis-harness.js");
+const tmp = fs.mkdtempSync(path.join(os.tmpdir(), "genesis-cli-smoke-"));
+
+function run(args, cwd = tmp) {
+  return execFileSync(process.execPath, [cli, ...args], {
+    cwd,
+    env: {
+      ...process.env,
+      CODEX_HOME: path.join(tmp, "codex-home"),
+      GENESIS_HARNESS_HOME: path.join(tmp, "agents-home"),
+      GENESIS_HARNESS_SKIP_POSTINSTALL: "1"
+    },
+    encoding: "utf8"
+  });
+}
+
+function runPostinstall(initCwd) {
+  return execFileSync(process.execPath, [cli, "postinstall"], {
+    cwd: repoRoot,
+    env: {
+      ...process.env,
+      CODEX_HOME: path.join(initCwd, "codex-postinstall-home"),
+      GENESIS_HARNESS_HOME: path.join(initCwd, "agents-postinstall-home"),
+      INIT_CWD: initCwd
+    },
+    encoding: "utf8"
+  });
+}
+
+fs.mkdirSync(path.join(tmp, ".codebase"), { recursive: true });
+fs.mkdirSync(path.join(tmp, ".planning"), { recursive: true });
+fs.writeFileSync(path.join(tmp, ".codebase", "CURRENT_STATE.md"), "# Current State: TEST\n");
+fs.writeFileSync(path.join(tmp, ".codebase", "API_CONTRACTS.md"), "# API Contracts\n");
+fs.writeFileSync(path.join(tmp, ".planning", "SPEC_CHANGELOG.md"), "# Spec Changelog\n");
+fs.writeFileSync(path.join(tmp, "package.json"), JSON.stringify({ name: "smoke-fixture" }, null, 2));
+
+run(["install", "--target", "agents"]);
+const seededPolicyPath = path.join(tmp, ".codebase", "context-policy.json");
+assert(fs.existsSync(seededPolicyPath), "install should seed LeanCTX policy into project .codebase");
+const seededPolicy = JSON.parse(fs.readFileSync(seededPolicyPath, "utf8"));
+assert.strictEqual(seededPolicy.token_budget, 12000, "seeded LeanCTX policy should use package default");
+
+fs.writeFileSync(
+  seededPolicyPath,
+  JSON.stringify({ token_budget: 8000, compact_at: 0.7, hard_stop_at: 0.9 }, null, 2)
+);
+run(["install", "--target", "agents"]);
+const preservedPolicy = JSON.parse(fs.readFileSync(seededPolicyPath, "utf8"));
+assert.strictEqual(preservedPolicy.token_budget, 8000, "install must not overwrite customized LeanCTX policy");
+
+const postinstallTmp = fs.mkdtempSync(path.join(os.tmpdir(), "genesis-postinstall-smoke-"));
+fs.writeFileSync(path.join(postinstallTmp, "package.json"), JSON.stringify({ name: "postinstall-fixture" }, null, 2));
+runPostinstall(postinstallTmp);
+assert(
+  fs.existsSync(path.join(postinstallTmp, ".codebase", "context-policy.json")),
+  "postinstall should seed LeanCTX policy when npm exposes INIT_CWD"
+);
+
+const pathOutput = run(["path"]);
+assert(pathOutput.includes("genesis-harness"), "path should include installed skill paths");
+
+const statusOutput = run(["status"]);
+assert(statusOutput.includes("GENESIS HARNESS - STATUS REPORT"), "status should render status report");
+
+const docsOutput = run(["docs"]);
+assert(docsOutput.includes("GENESIS HARNESS - DOCUMENTATION REPORT"), "docs should render docs report");
+
+const leanCtxOutput = run(["leanctx"]);
+assert(leanCtxOutput.includes("LeanCTX Policy"), "leanctx should render policy report");
+assert(leanCtxOutput.includes("Token budget: 8000"), "leanctx should read project policy");
+assert(leanCtxOutput.includes("Command wrapper:"), "leanctx should report command wrapper detection");
+assert(leanCtxOutput.includes("rtk optional"), "leanctx should treat rtk as optional");
+assert(leanCtxOutput.includes("genesis-harness sync"), "leanctx should include portable sync command");
+
+const primeOutput = run(["prime"]);
+assert(primeOutput.includes("LeanCTX Policy"), "prime should include LeanCTX policy");
+assert(primeOutput.includes("rtk optional"), "prime should document optional wrapper behavior");
+
+const gateOutput = run(["docs-gate"]);
+assert(
+  gateOutput.includes("Docs sync check passed") || gateOutput.includes("docs sync check is limited"),
+  "docs-gate should pass in fixture"
+);
+
+run(["sync"]);
+const visual = fs.readFileSync(path.join(tmp, ".codebase", "VISUAL_GRAPH.md"), "utf8");
+assert(visual.includes("Harness Relationship Map"), "sync should generate harness relationship map");
+assert(visual.includes("genesis-harness docs-gate"), "sync graph should include docs-gate");
+assert(!visual.includes("Đăng nhập"), "sync graph must not emit stale sample roadmap");
+assert(!visual.includes("src/auth.js"), "sync graph must not emit stale sample source path");
+assert(visual.includes("```mermaid"), "sync graph should contain mermaid fences");
+
+console.log("cli smoke passed");