bigpowers 2.64.2 → 2.65.1

package/.pi/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigpowers",
-  "version": "2.64.2",
+  "version": "2.65.1",
   "description": "74 skills — 73 agent skills synthesizing 17 years of software engineering discipline into a prescriptive methodology for solo developers",
   "keywords": [
     "pi-package"

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [2.65.1](https://github.com/danielvm-git/bigpowers/compare/v2.65.0...v2.65.1) (2026-07-05)
+
+
+### Bug Fixes
+
+* **ci:** add workflow_dispatch trigger to docs-site workflow ([eaf2b0b](https://github.com/danielvm-git/bigpowers/commit/eaf2b0b4210b14d3ee6e24a44a208cf4280eaa5e))
+
+# [2.65.0](https://github.com/danielvm-git/bigpowers/compare/v2.64.2...v2.65.0) (2026-07-05)
+
+
+### Features
+
+* OKF Completion — wikis, verification reports, viz graph (e45) ([e04d209](https://github.com/danielvm-git/bigpowers/commit/e04d209c3e70c7e3c9aa2d19606294fde9b4cb23))
+
 ## [2.64.2](https://github.com/danielvm-git/bigpowers/compare/v2.64.1...v2.64.2) (2026-07-05)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigpowers",
-  "version": "2.64.2",
+  "version": "2.65.1",
   "description": "73 agent skills synthesizing 17 years of software engineering discipline into a prescriptive methodology for solo developers",
   "main": "index.js",
   "scripts": {

package/scripts/audit-compliance.sh

@@ -286,6 +286,40 @@ if [[ $TOTAL_GLOBAL_ALL -gt 0 ]]; then
 else
   SCORE=0
 fi
+
+# ── OKF verification-report (e45s02) ────────────────────────────────────
+OKF_DIR="specs/verifications/reports"
+mkdir -p "$OKF_DIR"
+OKF_FILE="$OKF_DIR/audit-$(date +%Y-%m-%d).okf.md"
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+GIT_COMMIT=$(git rev-parse HEAD 2>/dev/null || echo "unknown")
+GATE=$(if [[ $SCORE -ge 94 ]]; then echo "pass"; else echo "fail"; fi)
+
+cat > "$OKF_FILE" << OKF_EOF
+---
+okf_kind: verification-report
+okf_version: "0.1"
+score: ${SCORE}
+gate_status: "${GATE}"
+threshold: 94
+total_pass: ${TOTAL_GLOBAL_PASS}
+total_fail: ${TOTAL_GLOBAL_FAIL}
+total_waived: ${TOTAL_GLOBAL_WAIVED}
+generated_by: scripts/audit-compliance.sh
+generated_at: "${TIMESTAMP}"
+git_commit: "${GIT_COMMIT}"
+---
+
+# Compliance Audit — $(date +%Y-%m-%d)
+
+**Score:** ${SCORE}% (${TOTAL_GLOBAL_PASS}/${TOTAL_GLOBAL_ALL} passed, ${TOTAL_GLOBAL_WAIVED} waived)
+**Gate:** ${GATE} | **Threshold:** 94%
+
+See \`specs/verifications/reports/audit-*.md\` for detailed step-by-step reports.
+OKF_EOF
+
+echo "OKF report: $OKF_FILE"
+
 if [[ $TOTAL_GLOBAL_WAIVED -gt 0 ]]; then
   echo "  SCORE: ${SCORE}% (of ${TOTAL_GLOBAL_ALL} unwaived checks, threshold 94%)"
 else

package/scripts/generate-adr-wiki.sh

@@ -0,0 +1,86 @@
+#!/usr/bin/env bash
+# story: e45s01 e45s06
+# generate-adr-wiki.sh — emit OKF concept bundles from specs/adr/*.md
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+ADRS="$ROOT/specs/adr"
+WIKI="$ROOT/specs/adr-wiki"
+mkdir -p "$WIKI"
+
+if [ ! -d "$ADRS" ]; then
+  echo "generate-adr-wiki: no ADR directory at $ADRS"
+  exit 0
+fi
+
+count=0
+
+assign_tier() {
+  local adr_id="$1"
+  case "$adr_id" in
+    ADR-0001|ADR-0002|ADR-0003|0001-*|0002-*|0003-*) echo "core" ;;
+    *)                                          echo "extended" ;;
+  esac
+}
+
+for adr_file in "$ADRS"/*.md; do
+  [ -f "$adr_file" ] || continue
+  adr_name=$(basename "$adr_file" .md)
+
+  # Parse YAML frontmatter if present
+  fm="{}"
+  if head -1 "$adr_file" 2>/dev/null | grep -q '^---$'; then
+    fm=$(python3 -c "
+import sys, yaml, json
+content = open('$adr_file').read()
+parts = content.split('---')
+if len(parts) >= 3:
+    try:
+        d = yaml.safe_load(parts[1])
+        if d:
+            print(json.dumps(d))
+    except: pass
+" 2>/dev/null) || fm="{}"
+  fi
+
+  title=$(echo "$fm" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d.get('title',''))" 2>/dev/null || echo "")
+  status=$(echo "$fm" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d.get('status','accepted'))" 2>/dev/null || echo "accepted")
+  decision=$(echo "$fm" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d.get('decision',''))" 2>/dev/null || echo "")
+
+  # Fallback title from first heading
+  if [ -z "$title" ]; then
+    title=$(grep -m1 '^# ' "$adr_file" 2>/dev/null | sed 's/^# //' || echo "$adr_name")
+  fi
+  [ -z "$title" ] && title="$adr_name"
+
+  tier=$(assign_tier "$adr_name")
+
+  bundle="$WIKI/${adr_name}.okf.md"
+
+  cat > "$bundle" << OKFEOF
+---
+okf_kind: concept
+okf_version: "0.1"
+id: "${adr_name}"
+title: "${title}"
+category: adr
+tier: ${tier}
+status: ${status}
+decision: "${decision}"
+generator: scripts/generate-adr-wiki.sh
+references:
+    - specs/adr/${adr_name}.md
+---
+
+# ${title}
+
+**ADR:** ${adr_name} | **Status:** ${status} | **Tier:** ${tier}
+
+See \`specs/adr/${adr_name}.md\` for the full architectural decision record.
+OKFEOF
+
+  count=$((count + 1))
+  echo "  → ${adr_name}: ${title} [${tier}]"
+done
+
+echo "generate-adr-wiki: ${count} concept bundles → $WIKI/"

package/scripts/generate-epics-wiki.sh

@@ -0,0 +1,84 @@
+#!/usr/bin/env bash
+# story: e45s01 e45s06
+# generate-epics-wiki.sh — emit OKF concept bundles from specs/epics/*/epic.yaml
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+WIKI="$ROOT/specs/epics-wiki"
+mkdir -p "$WIKI"
+
+# Helper: extract YAML scalar field (graceful missing → empty)
+extract() {
+  local file="$1" key="$2"
+  grep -m1 "^${key}:" "$file" 2>/dev/null | sed "s/^${key}: *//" | sed 's/^"//;s/"$//' | sed "s/^'//;s/'$//" || echo ""
+}
+
+count=0
+
+assign_tier() {
+  local epic_id="$1"
+  case "$epic_id" in
+    e28|e38|e40|e41|e44|e45|e46) echo "core" ;;
+    e39|e42|e43|e47|e48|e49)       echo "extended" ;;
+    e12|e18|e19|e21|e25)            echo "extended" ;;
+    e33|e35|e36|e37)                echo "extended" ;;
+    *)                              echo "specialized" ;;
+  esac
+}
+
+for epic_yaml in "$ROOT"/specs/epics/*/epic.yaml; do
+  [ -f "$epic_yaml" ] || continue
+
+  epic_dir=$(dirname "$epic_yaml")
+  epic_slug=$(basename "$epic_dir")
+
+  epic_id=$(extract "$epic_yaml" "id")
+  title=$(extract "$epic_yaml" "title" | tr -d '"')
+  wsjf=$(extract "$epic_yaml" "wsjf")
+  bcps=$(extract "$epic_yaml" "bcps")
+  status=$(extract "$epic_yaml" "status")
+  release=$(extract "$epic_yaml" "release")
+  codename=$(extract "$epic_yaml" "codename" | tr -d '"')
+
+  [[ -z "$epic_id" ]] && continue
+
+  tier=$(assign_tier "$epic_id")
+
+  # Build references array from story list
+  story_count=$(grep -c '^\s\+- id:' "$epic_yaml" 2>/dev/null || echo "0")
+  refs=$(grep '^\s\+- id:' "$epic_yaml" 2>/dev/null | sed 's/.*- id: */    - /' || echo "")
+
+  bundle="$WIKI/${epic_id}.okf.md"
+
+  cat > "$bundle" << OKFEOF
+---
+okf_kind: concept
+okf_version: "0.1"
+id: "${epic_id}"
+title: "${title:-${epic_slug}}"
+category: epic
+tier: ${tier}
+wsjf: ${wsjf:-0}
+bcps: ${bcps:-0}
+status: ${status:-proposed}
+release: ${release:-unknown}
+codename: "${codename:-}"
+story_count: ${story_count}
+generator: scripts/generate-epics-wiki.sh
+references:
+${refs}
+---
+
+# ${title:-${epic_slug}}
+
+**Epic:** ${epic_id} | **WSJF:** ${wsjf:-0} | **BCP:** ${bcps:-0} | **Status:** ${status:-proposed}
+**Release:** ${release:-unknown} | **Tier:** ${tier}
+
+${story_count} stories. See \`${epic_yaml}\` for full specifications.
+OKFEOF
+
+  count=$((count + 1))
+  echo "  → ${epic_id}: ${title:-${epic_slug}} [${tier}]"
+done
+
+echo "generate-epics-wiki: ${count} concept bundles → $WIKI/"

package/scripts/generate-viz-graph.sh

@@ -0,0 +1,147 @@
+#!/usr/bin/env bash
+# story: e45s04
+# generate-viz-graph.sh — build specs/viz.html from bigpowers-mcp/graph.jsonl
+set -euo pipefail
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+GRAPH="$ROOT/bigpowers-mcp/graph.jsonl"
+OUT="$ROOT/specs/viz.html"
+
+ENTITIES_JSON=$(python3 -c "
+import json, sys
+entities = []
+with open('$GRAPH') as f:
+    for line in f:
+        obj = json.loads(line)
+        if obj.get('type') == 'entity':
+            entities.append(obj)
+print(json.dumps(entities))
+")
+
+EDGES_JSON=$(python3 -c "
+import json, sys
+edges = []
+with open('$GRAPH') as f:
+    for line in f:
+        obj = json.loads(line)
+        if obj.get('type') == 'relation':
+            edges.append({'from': obj['from'], 'to': obj['to'], 'relationType': obj.get('relationType','')})
+print(json.dumps(edges))
+")
+
+python3 - "$ENTITIES_JSON" "$EDGES_JSON" "$OUT" << 'PY'
+import sys, json
+
+entities_json = sys.argv[1]
+edges_json = sys.argv[2]
+out_path = sys.argv[3]
+
+entities = json.loads(entities_json)
+edges = json.loads(edges_json)
+
+html = f'''<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>bigpowers — Skill Graph</title>
+<style>
+* {{ margin: 0; padding: 0; box-sizing: border-box; }}
+body {{ background: #0d1117; color: #c9d1d9; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; overflow: hidden; }}
+#graph {{ width: 100vw; height: 100vh; }}
+.node {{ cursor: pointer; }}
+.node circle {{ stroke-width: 1.5px; }}
+.node text {{ font-size: 10px; fill: #c9d1d9; pointer-events: none; }}
+.link {{ stroke: #30363d; stroke-opacity: 0.6; }}
+.tooltip {{
+  position: absolute; background: #161b22; border: 1px solid #30363d;
+  border-radius: 6px; padding: 10px 14px; font-size: 12px; max-width: 320px;
+  pointer-events: none; opacity: 0; transition: opacity 0.15s;
+  box-shadow: 0 4px 12px rgba(0,0,0,0.4); z-index: 100;
+}}
+.tooltip .name {{ font-weight: 600; font-size: 14px; color: #58a6ff; margin-bottom: 4px; }}
+.tooltip .meta {{ color: #8b949e; font-size: 11px; margin-bottom: 4px; }}
+.tooltip .desc {{ color: #c9d1d9; font-size: 11px; line-height: 1.4; }}
+.legend {{ position: absolute; top: 16px; right: 16px; background: #161b22; border: 1px solid #30363d; border-radius: 6px; padding: 10px 14px; font-size: 11px; z-index: 100; }}
+.legend-item {{ display: flex; align-items: center; gap: 6px; margin: 4px 0; }}
+.legend-swatch {{ width: 12px; height: 12px; border-radius: 50%; }}
+header {{ position: absolute; top: 16px; left: 16px; z-index: 100; }}
+header h1 {{ font-size: 18px; color: #58a6ff; margin: 0; }}
+header p {{ font-size: 11px; color: #8b949e; margin: 2px 0 0; }}
+</style>
+</head>
+<body>
+<div id="graph"></div>
+<div class="tooltip" id="tooltip"></div>
+<header><h1>bigpowers Skill Graph</h1><p>{len(entities)} skills · {len(edges)} relationships</p></header>
+<div class="legend">
+  <div class="legend-item"><span class="legend-swatch" style="background:#58a6ff"></span> light</div>
+  <div class="legend-item"><span class="legend-swatch" style="background:#3fb950"></span> standard</div>
+  <div class="legend-item"><span class="legend-swatch" style="background:#d29922"></span> heavy</div>
+</div>
+<script src="https://d3js.org/d3.v7.min.js"></script>
+<script>
+const ENTITIES = {json.dumps(entities)};
+const EDGES = {json.dumps(edges)};
+
+const effortColors = {{ light: '#58a6ff', standard: '#3fb950', heavy: '#d29922' }};
+const effortRadii = {{ light: 8, standard: 12, heavy: 16 }};
+
+const nodes = ENTITIES.map(e => {{
+  const obs = (e.observations || []).join(' ');
+  const effortMatch = obs.match(/effort:\\s*(\\w+)/);
+  const effort = effortMatch ? effortMatch[1] : 'standard';
+  const descMatch = obs.match(/description:\\s*(.+?)(?:\\]|$)/);
+  const desc = descMatch ? descMatch[1] : '';
+  const modelMatch = obs.match(/model:\\s*(\\w+)/);
+  const model = modelMatch ? modelMatch[1] : '';
+  return {{ id: e.name, type: e.entityType, effort, model, description: desc, radius: effortRadii[effort] || 12, color: effortColors[effort] || '#8b949e' }};
+}});
+
+const nodeIds = new Set(nodes.map(n => n.id));
+const links = EDGES.filter(e => nodeIds.has(e.from) && nodeIds.has(e.to))
+  .map(e => ({{ source: e.from, target: e.to, type: e.relationType }}));
+
+const width = window.innerWidth, height = window.innerHeight;
+const svg = d3.select('#graph').append('svg').attr('width', width).attr('height', height);
+const g = svg.append('g');
+const tooltip = d3.select('#tooltip');
+svg.call(d3.zoom().scaleExtent([0.2, 4]).on('zoom', (e) => g.attr('transform', e.transform)));
+
+const simulation = d3.forceSimulation(nodes)
+  .force('link', d3.forceLink(links).id(d => d.id).distance(80))
+  .force('charge', d3.forceManyBody().strength(-200))
+  .force('center', d3.forceCenter(width / 2, height / 2))
+  .force('collision', d3.forceCollide().radius(d => d.radius + 4));
+
+g.append('g').selectAll('line').data(links).join('line')
+  .attr('class', 'link').attr('stroke-width', 1);
+
+const node = g.append('g').selectAll('g').data(nodes).join('g')
+  .attr('class', 'node')
+  .call(d3.drag()
+    .on('start', (e, d) => {{ if (!e.active) simulation.alphaTarget(0.3).restart(); d.fx = d.x; d.fy = d.y; }})
+    .on('drag', (e, d) => {{ d.fx = e.x; d.fy = e.y; }})
+    .on('end', (e, d) => {{ if (!e.active) simulation.alphaTarget(0); d.fx = null; d.fy = null; }}));
+
+node.append('circle').attr('r', d => d.radius).attr('fill', d => d.color).attr('stroke', '#30363d');
+node.append('text').attr('dy', d => d.radius + 12).attr('text-anchor', 'middle').text(d => d.id);
+
+node.on('mouseenter', (e, d) => {{
+  tooltip.style('opacity', 1)
+    .html('<div class="name">' + d.id + '</div><div class="meta">' + d.type + ' · ' + d.effort + (d.model ? ' · model: ' + d.model : '') + '</div><div class="desc">' + d.description.slice(0, 200) + '</div>');
+}}).on('mousemove', (e) => {{
+  tooltip.style('left', (e.pageX + 14) + 'px').style('top', (e.pageY - 10) + 'px');
+}}).on('mouseleave', () => tooltip.style('opacity', 0));
+
+simulation.on('tick', () => {{
+  svg.selectAll('.link').attr('x1', d => d.source.x).attr('y1', d => d.source.y).attr('x2', d => d.target.x).attr('y2', d => d.target.y);
+  node.attr('transform', d => 'translate(' + d.x + ',' + d.y + ')');
+}});
+</script>
+</body>
+</html>'''
+
+with open(out_path, 'w') as f:
+    f.write(html)
+print(f"generate-viz-graph: {len(entities)} entities + {len(edges)} edges -> {out_path}")
+PY

package/scripts/run-golden-suite.sh

@@ -31,6 +31,7 @@ done
 GATES=(
   "compliance:npm run compliance:false"
   "g04-selftest:bash scripts/golden-g04-selftest.sh:true"
+  "g06-migrate-version:bash tests/run-golden-migrate-version.sh:true"
   "g07-negative-path:bash scripts/golden-g07-negative-path.sh:false"
   "g08-anti-vacuity:bash scripts/golden-g08-anti-vacuity.sh:false"
   "g09-yaml-roundtrip:bash scripts/golden-g09-yaml-roundtrip.sh:false"
@@ -174,6 +175,38 @@ summary:
   overall: "$OVERALL"
 YAML_EOF
 
+# ── OKF verification-report (e45s02) ────────────────────────────────────
+OKF_DIR="specs/verifications/reports"
+mkdir -p "$OKF_DIR"
+OKF_FILE="$OKF_DIR/GOLDEN-${TODAY}.okf.md"
+THRESHOLD=100
+GATE_STATUS="$OVERALL"
+
+cat > "$OKF_FILE" << OKF_EOF
+---
+okf_kind: verification-report
+okf_version: "0.1"
+score: ${PASS_RATE}
+gate_status: "${GATE_STATUS}"
+threshold: ${THRESHOLD}
+total_pass: ${PASS_COUNT}
+total_fail: ${FAIL_COUNT}
+total_skip: ${SKIP_COUNT}
+generated_by: scripts/run-golden-suite.sh
+generated_at: "${TIMESTAMP}"
+git_commit: "${GIT_COMMIT}"
+---
+
+# Golden Suite — ${TODAY}
+
+**Score:** ${PASS_RATE} (${PASS_COUNT}/${TOTAL} passed)
+**Gate:** ${GATE_STATUS} | **Threshold:** ${THRESHOLD}%
+
+See \`${REPORT_FILE}\` for the full YAML report.
+OKF_EOF
+
+echo "OKF report: $OKF_FILE"
+
 # ── Size budget (placeholder for e31s04) ──────────────────────────────
 
 if $BASELINE_MODE; then

package/scripts/sync-bugs-registry.sh

@@ -1,16 +1,20 @@
 #!/usr/bin/env bash
-# sync-bugs-registry.sh — rebuild specs/bugs/registry.yaml from BUG-*.md frontmatter
+# story: e45s03
+# sync-bugs-registry.sh — rebuild specs/bugs/registry.yaml + OKF concept bundles
 set -euo pipefail
-REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+source "$(dirname "${BASH_SOURCE[0]}")/lib/skill-common.sh"
 BUGS="$REPO_ROOT/specs/bugs"
 mkdir -p "$BUGS"
 
-python3 - "$BUGS" <<'PY'
+python3 - "$BUGS" "$REPO_ROOT" <<'PY'
 import re
 import sys
 from pathlib import Path
 
 bugs_dir = Path(sys.argv[1])
+repo_root = Path(sys.argv[2])
+
+# ---- Phase 1: Build registry.yaml ----
 entries = []
 for path in sorted(bugs_dir.glob("BUG-*.md")):
     text = path.read_text(encoding="utf-8")
@@ -56,4 +60,40 @@ for e in entries:
 lines.append("")
 out.write_text("\n".join(lines), encoding="utf-8")
 print(f"sync-bugs-registry: {len(entries)} bugs -> {out}")
+
+# ---- Phase 2: Emit OKF concept bundles (e45s03) ----
+okf_count = 0
+for e in entries:
+    bug_id = e["id"]
+    slug = bug_id.replace("BUG-", "").lower()
+    bundle_path = bugs_dir / f"{bug_id}.okf.md"
+
+    title_escaped = e["title"].replace('"', "'")
+    refs = f"    - specs/bugs/{bug_id}.md"
+
+    bundle = f"""---
+okf_kind: concept
+okf_version: "0.1"
+id: "{bug_id}"
+title: "{title_escaped}"
+category: bug
+tier: extended
+severity: {e["severity"]}
+status: {e["status"]}
+generator: scripts/sync-bugs-registry.sh
+references:
+{refs}
+---
+
+# {title_escaped}
+
+**Bug:** {bug_id} | **Severity:** {e["severity"]} | **Status:** {e["status"]} | **Scope:** {e.get("scope", "general")}
+**Tier:** extended
+
+See `specs/bugs/{bug_id}.md` for full investigation and fix details.
+"""
+    bundle_path.write_text(bundle, encoding="utf-8")
+    okf_count += 1
+
+print(f"sync-bugs-registry: {okf_count} OKF concept bundles -> {bugs_dir}/")
 PY

package/scripts/sync-skills.sh

@@ -1,10 +1,35 @@
 #!/usr/bin/env bash
-# story: e13s03 e28s03
-# sync-skills.sh — generate Cursor, Gemini CLI, and pi artifacts from SKILL.md source files
+# story: e13s03 e28s03 e39s04
+# sync-skills.sh — generate Cursor, Gemini CLI, pi, and OKF artifacts from SKILL.md source files
 # Architecture: Parse→IR→Render. Each target is its own render_<target>() function.
 # Run this after adding or updating any skill. Symlinks carry changes through automatically.
+#
+# Flags:
+#   --okf          Generate specs/skills-wiki/ OKF concept bundle from SKILL.md frontmatter
+#   --opencode <p> Sync to bigpowers-opencode repo
 set -euo pipefail
 
+# ── Parse CLI flags (must happen before source to allow early --help) ─
+OKF_MODE=0
+OPN_TARGET=""
+
+for arg in "$@"; do
+  case "$arg" in
+    --okf) OKF_MODE=1 ;;
+    --opencode=*) OPN_TARGET="${arg#*=}" ;;
+    --opencode) shift; OPN_TARGET="$1" ;;
+    --help|-h)
+      echo "Usage: sync-skills.sh [--okf] [--opencode <path>]"
+      echo ""
+      echo "  --okf        Generate specs/skills-wiki/ OKF concept bundle"
+      echo "  --opencode   Sync skills to bigpowers-opencode repo"
+      echo "  --help       Show this message"
+      exit 0
+      ;;
+    *) echo "sync-skills: unknown flag: $arg" >&2; exit 2 ;;
+  esac
+done
+
 source "$(dirname "${BASH_SOURCE[0]}")/lib/skill-common.sh"
 
 CURSOR_RULES="$REPO_ROOT/.cursor/rules"
@@ -120,9 +145,104 @@ render_pi_prompt() {
   } > "$PI_PROMPTS/$IR_NAME.md"
 }
 
+# ── Render target: OKF Concept (e39s04) ──────────────────────────────
+# Writes specs/skills-wiki/skills/<name>.md with OKF concept frontmatter.
+# Globals used: IR_NAME, IR_MODEL, IR_DESCRIPTION, IR_DESC_ESCAPED, IR_BODY
+# Also reads _PF_EFFORT from the extended parse_frontmatter.
+OKF_WIKI_SKILLS="$REPO_ROOT/specs/skills-wiki/skills"
+OKF_WIKI_DIR="$REPO_ROOT/specs/skills-wiki"
+
+render_okf_concept() {
+  mkdir -p "$OKF_WIKI_SKILLS"
+  local okf_file="$OKF_WIKI_SKILLS/$IR_NAME.md"
+
+  # Determine phase: critical-path skills per the bigpowers core loop
+  local phase="utility"
+  case "$IR_NAME" in
+    survey-context|elaborate-spec|model-domain|define-language|\
+    design-interface|plan-work|plan-release|slice-tasks|\
+    kickoff-branch|develop-tdd|verify-work|audit-code|\
+    commit-message|release-branch|security-review|\
+    assess-impact|investigate-bug|validate-fix|dispatch-agents|\
+    request-review|respond-review|hook-commits|guard-git|\
+    wire-observability|wire-ci|smoke-test|deploy|enforce-first)
+      phase="critical-path" ;;
+  esac
+
+  # Build title from name: kebab-case → Title Case
+  local title
+  title=$(echo "$IR_NAME" | sed -E 's/-/ /g; s/\b(.)/\U\1/g')
+
+  # Escape description for YAML double-quoted string
+  local desc_escaped
+  desc_escaped=$(echo "$IR_DESCRIPTION" | sed 's/\\/\\\\/g; s/"/\\"/g')
+
+  # Truncate description to avoid overly long lines (OKF convention)
+  local short_desc="$IR_DESCRIPTION"
+  if [[ ${#short_desc} -gt 200 ]]; then
+    short_desc="${short_desc:0:197}..."
+  fi
+
+  local effort_val="${_PF_EFFORT:-standard}"
+
+  {
+    echo "---"
+    echo "okf_kind: concept"
+    echo "type: Skill"
+    echo "id: $IR_NAME"
+    echo "title: \"$title\""
+    echo "name: $IR_NAME"
+    echo "category: skills"
+    [[ -n "$IR_MODEL" ]] && echo "model: $IR_MODEL"
+    echo "effort: $effort_val"
+    echo "phase: $phase"
+    echo "description: \"$desc_escaped\""
+    echo "references: []"
+    echo "---"
+    echo ""
+    echo "# $title"
+    echo ""
+    echo "**Phase:** $phase"
+    [[ -n "$IR_MODEL" ]] && echo "**Model:** $IR_MODEL"
+    echo "**Effort:** $effort_val"
+    echo ""
+    echo "$IR_DESCRIPTION"
+    echo ""
+    echo "> Auto-generated by sync-skills.sh --okf (e39s04) from $SKILLS_ROOT/$IR_NAME/SKILL.md"
+  } > "$okf_file"
+}
+
+# ── Parse extended frontmatter for OKF (includes effort) ────────────
+# Extends the base parse_frontmatter with _PF_EFFORT.
+parse_frontmatter_okf() {
+  local file="$1"
+  _PF_EFFORT=""
+
+  if [[ ! -f "$file" ]]; then
+    return 1
+  fi
+
+  if ! grep -q '^---$' "$file"; then
+    return 1
+  fi
+
+  _PF_NAME=$(awk '/^---/{f++} f==1 && /^name:/{print; exit}' "$file" | sed 's/^name:[[:space:]]*//')
+  _PF_MODEL=$(awk '/^---/{f++} f==1 && /^model:/{print; exit}' "$file" | sed 's/^model:[[:space:]]*//')
+  _PF_EFFORT=$(awk '/^---/{f++} f==1 && /^effort:/{print; exit}' "$file" | sed 's/^effort:[[:space:]]*//')
+  _PF_DESCRIPTION=$(awk '/^---/{f++; next} f==1 && /^description:/{p=1; sub(/^description:[[:space:]]*/,""); print; next} f==1 && p && /^[a-z]+:/{exit} f==1 && p{print}' "$file" \
+    | tr -d '\n' \
+    | sed -E 's/[[:space:]]+/ /g')
+
+  [[ -z "$_PF_NAME" ]] && return 1
+  return 0
+}
+
 # ── Target registry ─────────────────────────────────────────────────
 # Order matters: render functions are called in this order per skill.
 TARGETS=(render_cursor render_gemini_skill render_gemini_command render_pi_skill render_pi_prompt)
+if [[ "$OKF_MODE" -eq 1 ]]; then
+  TARGETS+=(render_okf_concept)
+fi
 
 skill_count=0
 
@@ -130,14 +250,18 @@ skill_count=0
 while IFS= read -r skill_dir; do
   skill_md="$skill_dir/SKILL.md"
 
-  parse_frontmatter "$skill_md" || continue
+  if [[ "$OKF_MODE" -eq 1 ]]; then
+    parse_frontmatter_okf "$skill_md" || continue
+  else
+    parse_frontmatter "$skill_md" || continue
+  fi
 
   IR_NAME="$_PF_NAME"
   IR_MODEL="$_PF_MODEL"
   IR_DESCRIPTION="$_PF_DESCRIPTION"
 
   # Escape double quotes and backslashes for safe double-quoted YAML output
-  IR_DESC_ESCAPED=$(echo "$IR_DESCRIPTION" | sed 's/\\/\\\\/g; s/"/\\"/g')
+  IR_DESC_ESCAPED=$(echo "$IR_DESCRIPTION" | sed 's/\\/\\\\/g; s/\"/\\"/g')
 
   [[ -z "$IR_NAME" ]] && continue
 
@@ -185,14 +309,6 @@ jq -n --arg version "$pkg_version" \
 } > "$REPO_ROOT/opencode.json"
 
 # Sync to bigpowers-opencode repo (if --opencode path is provided)
-OPN_TARGET=""
-for arg in "$@"; do
-  case "$arg" in
-    --opencode=*) OPN_TARGET="${arg#*=}" ;;
-    --opencode)   shift; OPN_TARGET="$1" ;;
-  esac
-done
-
 if [[ -n "$OPN_TARGET" ]] && [[ -d "$OPN_TARGET" ]]; then
   echo ""
   echo "Syncing skills to opencode repo: $OPN_TARGET"
@@ -258,6 +374,258 @@ echo "  → SKILL-INDEX.md (auto-generated skill reference)"
 echo "  → opencode.json (CLAUDE.md + CONVENTIONS.md instructions)"
 [[ -n "$OPN_TARGET" ]] && echo "  → bigpowers-opencode: $opencode_count skills"
 
+# ── OKF post-sync pipeline (e39s04) ──────────────────────────────────
+if [[ "$OKF_MODE" -eq 1 ]]; then
+  echo ""
+  echo "--- OKF skills-wiki post-sync ---"
+
+  # Step 2: Run build-skill-graph.sh to get cross-references in skill-graph.json
+  GRAPH_JSON="$REPO_ROOT/specs/skill-graph.json"
+  if [[ -x "$REPO_ROOT/scripts/build-skill-graph.sh" ]]; then
+    echo "Running build-skill-graph.sh for cross-references..."
+    bash "$REPO_ROOT/scripts/build-skill-graph.sh" --json || {
+      echo "sync-skills: WARNING — build-skill-graph.sh --json failed; cross-references will be empty" >&2
+    }
+  else
+    echo "sync-skills: WARNING — build-skill-graph.sh not found; skipping cross-references" >&2
+  fi
+
+  # Step 2b: Add cross-references from skill-graph.json edges into OKF concepts
+  if [[ -f "$GRAPH_JSON" ]]; then
+    echo "Adding cross-references from skill-graph.json..."
+    python3 - "$GRAPH_JSON" "$OKF_WIKI_SKILLS" <<'PYEOF'
+import json, sys, re
+from pathlib import Path
+
+graph_json = Path(sys.argv[1])
+wiki_skills = Path(sys.argv[2])
+
+# Load graph edges
+with open(graph_json) as f:
+    graph = json.load(f)
+
+edges = graph.get("edges", [])
+nodes = {n["name"] for n in graph.get("nodes", [])}
+
+# Build adjacency: skill_name -> list of {concept, type} refs
+refs = {}
+for e in edges:
+    src, tgt, rel = e["from"], e["to"], e.get("relationType", "references")
+    # Only include edges where both ends are known skills
+    if src in nodes and tgt in nodes:
+        refs.setdefault(src, []).append({"concept": tgt, "type": rel})
+
+# Also detect intra-description references: scan description for skill names
+skill_names = set()
+for f in wiki_skills.glob("*.md"):
+    skill_names.add(f.stem)
+
+# Update each concept file with references
+count_updated = 0
+for f in wiki_skills.glob("*.md"):
+    name = f.stem
+    content = f.read_text()
+
+    # Collect references for this skill
+    concept_refs = refs.get(name, [])
+
+    # Also scan description for mentions of other skill names
+    desc_match = re.search(r'description:\s*"(.*?)"', content, re.DOTALL)
+    if desc_match:
+        desc = desc_match.group(1)
+        for sn in skill_names:
+            if sn != name and sn in desc and not any(r["concept"] == sn for r in concept_refs):
+                concept_refs.append({"concept": sn, "type": "references"})
+
+    # Deduplicate
+    seen = set()
+    unique_refs = []
+    for r in concept_refs:
+        key = (r["concept"], r["type"])
+        if key not in seen:
+            seen.add(key)
+            unique_refs.append(r)
+
+    # Build YAML references block
+    if unique_refs:
+        ref_lines = []
+        for r in unique_refs:
+            ref_lines.append(f'  - concept: {r["concept"]}')
+            ref_lines.append(f'    type: {r["type"]}')
+        ref_block = "\n".join(ref_lines)
+        content = re.sub(r'references:\s*\[\]', f'references:\n{ref_block}', content)
+        count_updated += 1
+    else:
+        # No edges and no description mentions → self-reference as fallback
+        content = re.sub(
+            r'references:\s*\[\]',
+            f'references:\n  - concept: skills-wiki\n    type: belongs_to',
+            content
+        )
+        count_updated += 1
+
+    f.write_text(content)
+
+print(f"  concepts with cross-references: {count_updated}", file=sys.stderr)
+PYEOF
+  else
+    echo "sync-skills: WARNING — $GRAPH_JSON not found; adding fallback references" >&2
+    # Add fallback references to all concepts
+    for f in "$OKF_WIKI_SKILLS"/*.md; do
+      [[ -f "$f" ]] || continue
+      if command -v python3 &>/dev/null; then
+        python3 -c "
+import re, sys
+content = open('$f').read()
+content = re.sub(r'references:\s*\[\]', 'references:\n  - concept: skills-wiki\n    type: belongs_to', content)
+open('$f', 'w').write(content)
+"
+      fi
+    done
+  fi
+
+  # Step 3: Generate specs/skills-wiki/index.md with progressive disclosure
+  echo "Generating index.md..."
+  OKF_INDEX="$OKF_WIKI_DIR/index.md"
+  python3 - "$OKF_WIKI_SKILLS" "$OKF_WIKI_DIR" "$OKF_INDEX" <<'PYEOF'
+import json, sys, re
+from pathlib import Path
+from collections import defaultdict
+
+wiki_skills = Path(sys.argv[1])
+wiki_dir = Path(sys.argv[2])
+index_path = Path(sys.argv[3])
+
+# Collect all concepts
+concepts = []
+for f in sorted(wiki_skills.glob("*.md")):
+    content = f.read_text()
+    fm_match = re.search(r'^---\n(.*?)\n---', content, re.DOTALL)
+    if not fm_match:
+        continue
+    fm_text = fm_match.group(1)
+    # Simple YAML extraction
+    name = ""
+    title = ""
+    phase = "utility"
+    model = ""
+    effort = ""
+    description = ""
+    for line in fm_text.split('\n'):
+        line = line.strip()
+        if line.startswith('name:'):
+            name = line.split(':', 1)[1].strip()
+        elif line.startswith('title:'):
+            title = line.split(':', 1)[1].strip().strip('"')
+        elif line.startswith('phase:'):
+            phase = line.split(':', 1)[1].strip()
+        elif line.startswith('model:'):
+            model = line.split(':', 1)[1].strip()
+        elif line.startswith('effort:'):
+            effort = line.split(':', 1)[1].strip()
+        elif line.startswith('description:'):
+            description = line.split(':', 1)[1].strip().strip('"')
+    if not name:
+        continue
+    concepts.append({
+        "name": name,
+        "title": title or name.replace('-', ' ').title(),
+        "phase": phase,
+        "model": model,
+        "effort": effort,
+        "description": description[:120] + "..." if len(description) > 120 else description,
+    })
+
+# Group by phase
+phases = defaultdict(list)
+for c in concepts:
+    phases[c["phase"]].append(c)
+
+# Count
+total = len(concepts)
+cp_count = len(phases.get("critical-path", []))
+util_count = len(phases.get("utility", []))
+
+# Generate index.md
+with open(index_path, "w") as out:
+    out.write(f"""---
+okf_kind: concept
+type: Index
+id: skills-wiki
+title: "BigPowers Skills Wiki"
+category: skills
+description: "Progressive-disclosure index of {total} bigpowers skills ({cp_count} critical-path, {util_count} utility) — auto-generated by sync-skills.sh --okf (e39s04)."
+references:
+  - concept: bigpowers
+    type: belongs_to
+---
+
+# BigPowers Skills Wiki
+
+**{total} skills** ({cp_count} critical-path, {util_count} utility)
+
+> Auto-generated by sync-skills.sh --okf (e39s04).
+> Source of truth: skills/*/SKILL.md files.
+
+## Critical-Path Skills ({cp_count})
+
+These skills form the bigpowers core development loop — used on every feature.
+
+| Skill | Model | Effort | Description |
+|-------|-------|--------|-------------|
+""")
+
+    for c in phases.get("critical-path", []):
+        out.write(f"| [{c['title']}](skills/{c['name']}.md) | {c['model']} | {c['effort']} | {c['description']} |\n")
+
+    out.write(f"""
+## Utility Skills ({util_count})
+
+Supporting skills for specialised workflows.
+
+| Skill | Model | Effort | Description |
+|-------|-------|--------|-------------|
+""")
+
+    for c in phases.get("utility", []):
+        out.write(f"| [{c['title']}](skills/{c['name']}.md) | {c['model']} | {c['effort']} | {c['description']} |\n")
+
+    out.write(f"""
+## Quick Reference
+
+- **Total skills:** {total}
+- **Critical-path:** {cp_count}
+- **Utility:** {util_count}
+- **Format:** OKF concept bundles (okf_kind: concept)
+- **Validation:** `bash scripts/validate-okf.sh --dir specs/skills-wiki/skills`
+""")
+
+print(f"  index.md written: {total} skills indexed", file=sys.stderr)
+PYEOF
+
+  # Step 4: Validate OKF conformance via validate-okf.sh
+  echo ""
+  echo "Validating OKF conformance..."
+  VALIDATE_SCRIPT="$REPO_ROOT/scripts/validate-okf.sh"
+  if [[ -x "$VALIDATE_SCRIPT" ]]; then
+    if bash "$VALIDATE_SCRIPT" --dir "$OKF_WIKI_SKILLS" 2>&1; then
+      echo "sync-skills: OKF validation PASSED"
+    else
+      OKF_EXIT=$?
+      echo "sync-skills: OKF validation returned exit code $OKF_EXIT (non-zero — check output above)" >&2
+      # Don't hard-fail on validation warnings; the bundle is still generated
+    fi
+  else
+    echo "sync-skills: WARNING — validate-okf.sh not found; skipping validation" >&2
+  fi
+
+  OKF_CONCEPT_COUNT=$(find "$OKF_WIKI_SKILLS" -name "*.md" 2>/dev/null | wc -l | tr -d ' ')
+  echo ""
+  echo "sync-skills (--okf): $OKF_CONCEPT_COUNT OKF concepts generated"
+  echo "  → specs/skills-wiki/skills/ ($OKF_CONCEPT_COUNT .md files)"
+  echo "  → specs/skills-wiki/index.md (progressive-disclosure index)"
+fi
+
 # Regression guard (BUG-2026-06-02T164500)
 trace_mdc="$REPO_ROOT/.cursor/rules/trace-requirement.mdc"
 if [[ -f "$trace_mdc" ]] && ! grep -q 'release-plan.yaml + epic' "$trace_mdc"; then
@@ -297,4 +665,11 @@ if [[ -d "$REPO_ROOT/.git" ]]; then
   bash "$REPO_ROOT/scripts/generate-reference-tables.sh"
 fi
 
+# ── OKF wiki generation (e45s01) ──────────────────────────────────────
+echo ""
+echo "Generating OKF wikis..."
+bash "$REPO_ROOT/scripts/generate-epics-wiki.sh"
+bash "$REPO_ROOT/scripts/generate-adr-wiki.sh"
+echo "sync-skills: OKF wikis regenerated"
+
 exit 0

package/scripts/validate-okf.sh

@@ -1,7 +1,8 @@
 #!/usr/bin/env bash
-# story: e38s09
+# story: e38s09 e45s02
 # validate-okf.sh — kind-aware, fail-closed provenance gate for OKF bundles.
-# Validates story-metrics, spec-migration, and migration-registry bundles.
+# Validates story-metrics, spec-migration, migration-registry, concept,
+# and verification-report bundles.
 # Multi-dir default: specs/metrics/ + specs/migrations/.
 set -euo pipefail
 
@@ -11,7 +12,7 @@ EXIT_CODE=0
 RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[0;33m'; NC='\033[0m'
 
 usage_okf() {
-  cat <<'EOF'
+  cat <<'USAGEEOF'
 Usage: scripts/validate-okf.sh [flags]
 
 Flags:
@@ -28,19 +29,17 @@ Description:
     story-metrics       — effort/lead-time provenance (e40)
     spec-migration      — migration bundle schema (e44)
     migration-registry  — registry index integrity (e44)
-EOF
+    concept             — domain concept / wiki entry (e45)
+    verification-report — compliance/golden suite gate report (e45)
+USAGEEOF
   exit 0
 }
 
 # ---- Helpers ------------------------------------------------------------
 
-# True if value is empty, null JSON literal, or Python None string.
 val_nullish() { [ -z "$1" ] || [ "$1" = "null" ] || [ "$1" = "None" ]; }
-
-# True if value is nullish OR the JSON empty array literal.
 val_nullish_or_empty() { val_nullish "$1" || [ "$1" = "[]" ]; }
 
-# ---- YAML frontmatter parser (datetime-safe) ---------------------------
 parse_frontmatter() {
   local file="$1"
   python3 -c "
@@ -73,7 +72,6 @@ except Exception as e:
 validate_story_metrics() {
   local file="$1" fm="$2" name="$3"
   local errs=0
-
   for key in id epic bcps commit_range source generated_at generator; do
     local val
     val="$(echo "$fm" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d.get('$key',''))" 2>/dev/null)"
@@ -84,7 +82,6 @@ validate_story_metrics() {
   done
   [ "$errs" -gt 0 ] && { EXIT_CODE=1; return; }
 
-  # Source enum
   local source
   source="$(echo "$fm" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d.get('source',''))" 2>/dev/null)"
   if ! echo "measured estimated backfilled" | grep -qw "$source"; then
@@ -92,7 +89,6 @@ validate_story_metrics() {
     EXIT_CODE=1; return
   fi
 
-  # Generator
   local generator
   generator="$(echo "$fm" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d.get('generator',''))" 2>/dev/null)"
   if [ "$generator" != "scripts/record-cycle-time.sh" ]; then
@@ -100,7 +96,6 @@ validate_story_metrics() {
     EXIT_CODE=1; return
   fi
 
-  # commit_range resolves
   local commit_range
   commit_range="$(echo "$fm" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d.get('commit_range',''))" 2>/dev/null)"
   if ! git -C "$ROOT" log --oneline -1 "$commit_range" >/dev/null 2>&1; then
@@ -108,7 +103,6 @@ validate_story_metrics() {
     EXIT_CODE=1; return
   fi
 
-  # effort.effort_hours present and non-negative
   local eff
   eff="$(echo "$fm" | python3 -c "
 import json,sys
@@ -126,14 +120,12 @@ print(e)
     fi
     EXIT_CODE=1; return
   }
-
   printf "${GREEN}PASS${NC} %s (source=%s, generator=%s, commit_range resolves)\n" "$name" "$source" "$generator"
 }
 
 validate_spec_migration() {
   local file="$1" fm="$2" name="$3"
   local errs=0
-
   for key in id title since_version order actions_needed; do
     local val
     val="$(echo "$fm" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d.get('$key',''))" 2>/dev/null)"
@@ -144,7 +136,6 @@ validate_spec_migration() {
   done
   [ "$errs" -gt 0 ] && { EXIT_CODE=1; return; }
 
-  # fingerprint.any has at least one check
   local fp_count
   fp_count="$(echo "$fm" | python3 -c "
 import json,sys
@@ -165,7 +156,6 @@ print(len(fp))
 
 validate_migration_registry() {
   local file="$1" fm="$2" name="$3"
-
   local count
   count="$(echo "$fm" | python3 -c "
 import json,sys
@@ -178,7 +168,6 @@ print(len(migrations))
     EXIT_CODE=1; return
   fi
 
-  # Check each migration has id + file + status
   local bad
   bad="$(echo "$fm" | python3 -c "
 import json,sys
@@ -190,11 +179,85 @@ for m in d.get('migrations',[]):
     printf "${RED}FAIL${NC} %s: migration '%s' missing id/file/status\n" "$name" "${bad:-?}"
     EXIT_CODE=1; return
   }
-
   printf "${GREEN}PASS${NC} %s (%s migrations indexed)\n" "$name" "$count"
 }
 
-# ---- Receipts validation (e41s04) ----------------------------------------
+# ---- Concept validator (e45s02) ----
+validate_concept() {
+  local file="$1" fm="$2" name="$3"
+  local errs=0
+  for key in id title category; do
+    local val
+    val="$(echo "$fm" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d.get('$key',''))" 2>/dev/null)"
+    if val_nullish "$val"; then
+      printf "${RED}FAIL${NC} %s: missing required key '%s'\n" "$name" "$key"
+      errs=$((errs + 1))
+    fi
+  done
+  local ref_count
+  ref_count="$(echo "$fm" | python3 -c "
+import json,sys
+d=json.load(sys.stdin)
+r=d.get('references',[])
+print(len(r) if isinstance(r,list) else 0)
+" 2>/dev/null)"
+  if [ "${ref_count:-0}" -eq 0 ]; then
+    printf "${RED}FAIL${NC} %s: references[] is empty or missing\n" "$name"
+    errs=$((errs + 1))
+  fi
+  [ "$errs" -gt 0 ] && { EXIT_CODE=1; return; }
+  local cat
+  cat="$(echo "$fm" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d.get('category',''))" 2>/dev/null)"
+  printf "${GREEN}PASS${NC} %s (category=%s, %s reference(s))\n" "$name" "$cat" "$ref_count"
+}
+
+# ---- Verification-report validator (e45s02) ----
+validate_verification_report() {
+  local file="$1" fm="$2" name="$3"
+  local errs=0
+  for key in score gate_status threshold total_pass total_fail generated_by; do
+    local val
+    val="$(echo "$fm" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d.get('$key',''))" 2>/dev/null)"
+    if val_nullish "$val"; then
+      printf "${RED}FAIL${NC} %s: missing required key '%s'\n" "$name" "$key"
+      errs=$((errs + 1))
+    fi
+  done
+  [ "$errs" -gt 0 ] && { EXIT_CODE=1; return; }
+
+  local gs
+  gs="$(echo "$fm" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d.get('gate_status',''))" 2>/dev/null)"
+  if ! echo "pass fail concerns waived" | grep -qw "$gs"; then
+    printf "${RED}FAIL${NC} %s: invalid gate_status '%s' — must be pass|fail|concerns|waived\n" "$name" "$gs"
+    EXIT_CODE=1; return
+  fi
+
+  local score
+  score="$(echo "$fm" | python3 -c "
+import json,sys
+d=json.load(sys.stdin)
+s=d.get('score')
+if s is None or not isinstance(s,(int,float)):
+    sys.exit(1)
+if s < 0 or s > 100:
+    sys.exit(2)
+print(s)
+" 2>/dev/null)" || {
+    local rc=$?
+    if [ "$rc" -eq 1 ]; then
+      printf "${RED}FAIL${NC} %s: score missing or not numeric\n" "$name"
+    else
+      printf "${RED}FAIL${NC} %s: score out of bounds (0-100)\n" "$name"
+    fi
+    EXIT_CODE=1; return
+  }
+
+  printf "${GREEN}PASS${NC} %s (score=%.1f, gate=%s, threshold=%.1f)\n" \
+    "$name" "$score" "$gs" \
+    "$(echo "$fm" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d.get('threshold',0))" 2>/dev/null)"
+}
+
+# ---- Receipts validation (e41s04) ----
 validate_receipts() {
   local f="$ROOT/specs/receipts.json"
   if [ ! -f "$f" ]; then printf "${YELLOW}SKIP${NC} receipts.json not found\n"; return; fi
@@ -219,25 +282,24 @@ sys.exit(errs)
 " || { EXIT_CODE=1; return; }
 }
 
-# ---- Main validation dispatcher ----------------------------------------
+# ---- Main validation dispatcher ----
 validate_bundle() {
   local file="$1"
   local name; name="$(basename "$file")"
-
   local fm
   fm="$(parse_frontmatter "$file")" || {
     printf "${RED}FAIL${NC} %s: cannot parse YAML frontmatter\n" "$name"
     EXIT_CODE=1
     return
   }
-
   local kind
   kind="$(echo "$fm" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d.get('okf_kind',''))" 2>/dev/null)"
-
   case "$kind" in
     story-metrics)       validate_story_metrics "$file" "$fm" "$name" ;;
     spec-migration)      validate_spec_migration "$file" "$fm" "$name" ;;
     migration-registry)  validate_migration_registry "$file" "$fm" "$name" ;;
+    concept)             validate_concept "$file" "$fm" "$name" ;;
+    verification-report) validate_verification_report "$file" "$fm" "$name" ;;
     "")
       printf "${YELLOW}SKIP${NC} %s: no okf_kind — not an OKF bundle\n" "$name"
       ;;
@@ -247,7 +309,6 @@ validate_bundle() {
   esac
 }
 
-# ---- Scan directory ----------------------------------------------------
 scan_dir() {
   local dir="$1"
   if [ ! -d "$dir" ]; then
@@ -267,9 +328,10 @@ scan_dir() {
   fi
 }
 
-# ---- main ----------------------------------------------------------------
+# ---- main ----
 DIRS=()
 BUNDLE=""
+STAMPLINE="# e45s02 stamp -- concept and verification-report validators added"
 
 if [ $# -eq 0 ]; then
   DIRS=("$ROOT/specs/metrics" "$ROOT/specs/migrations")
@@ -280,32 +342,21 @@ while [ $# -gt 0 ]; do
     --dir)     DIRS+=("$2"); shift 2 ;;
     --bundle)  BUNDLE="$2"; shift 2 ;;
     --help|-h) usage_okf ;;
-    *)
-      echo "validate-okf: unknown flag: $1" >&2
-      echo "Run 'scripts/validate-okf.sh --help' for help." >&2
-      exit 2
-      ;;
+    *)         echo "validate-okf: unknown flag: $1" >&2; exit 2 ;;
   esac
 done
 
 echo "validate-okf: scanning for OKF bundles..."
 
 if [ -n "$BUNDLE" ]; then
-  if [ ! -f "$BUNDLE" ]; then
-    printf "${RED}FAIL${NC} bundle not found: %s\n" "$BUNDLE"
-    exit 1
-  fi
+  [ ! -f "$BUNDLE" ] && { printf "${RED}FAIL${NC} bundle not found: %s\n" "$BUNDLE"; exit 1; }
   validate_bundle "$BUNDLE"
 elif [ ${#DIRS[@]} -gt 0 ]; then
-  for d in "${DIRS[@]}"; do
-    scan_dir "$d"
-  done
+  for d in "${DIRS[@]}"; do scan_dir "$d"; done
 else
   echo "validate-okf: nothing to validate (no --dir or --bundle)" >&2
   exit 1
 fi
 
-# e41s04: always validate receipts.json
 validate_receipts
-
 exit "$EXIT_CODE"