bigpowers 2.65.1 → 2.67.0

package/scripts/build-skill-graph.sh

@@ -1,226 +1,194 @@
 #!/usr/bin/env bash
 # story: e39s01
-# Consumes bigpowers-mcp build_skill_graph MCP tool output (graph.jsonl)
-# and emits specs/skill-graph.json + specs/skills-wiki/ OKF concepts.
-#
-# Supersedes standalone SKILL.md parsing approach (2026-07-04).
-# Graph must be built first: run MCP tool `build_skill_graph` or
-# `node -e "..."` to generate bigpowers-mcp/graph.jsonl.
-
+# Consume e32 build_skill_graph MCP output (bigpowers-mcp/graph.jsonl) and emit:
+#   - specs/skill-graph.json    — machine-readable dependency graph
+#   - specs/skills-wiki/        — OKF wiki with per-skill pages
 set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
-GRAPH_IN="$REPO_ROOT/bigpowers-mcp/graph.jsonl"
-GRAPH_OUT="$REPO_ROOT/specs/skill-graph.json"
-WIKI_DIR="$REPO_ROOT/specs/skills-wiki/skills"
+GRAPH_JSONL="$REPO_ROOT/bigpowers-mcp/graph.jsonl"
+SKILL_GRAPH_JSON="$REPO_ROOT/specs/skill-graph.json"
+SKILLS_WIKI="$REPO_ROOT/specs/skills-wiki/skills"
 
-# --help
-if [[ "${1:-}" == "--help" ]]; then
+show_help() {
   cat <<EOF
-Usage: build-skill-graph.sh
+Usage: $(basename "$0") [OPTION]
 
-Reads bigpowers-mcp/graph.jsonl (generated by e32 build_skill_graph MCP tool)
-and produces:
-  specs/skill-graph.json  — nodes + typed edges (depends_on, gates, references,
-                             enforces, handoff_to)
-  specs/skills-wiki/      — one OKF concept markdown file per skill
+Consume bigpowers-mcp/graph.jsonl and emit:
+  - specs/skill-graph.json          — full skill dependency graph
+  - specs/skills-wiki/skills/*.md   — per-skill OKF wiki pages
 
 Options:
-  --help    Show this message
-  --json    Write only specs/skill-graph.json (skip OKF wiki)
-  --wiki    Write only specs/skills-wiki/ (skip JSON graph)
-
-Requires: bigpowers-mcp/graph.jsonl (run build_skill_graph MCP tool first)
+  --help    Show this help and exit
+  --wiki    Regenerate only the skills-wiki OKF bundle (skip graph.json)
 EOF
-  exit 0
-fi
+}
 
-MODE="${1:-both}"
-case "$MODE" in
-  --json) DO_JSON=1; DO_WIKI=0 ;;
-  --wiki) DO_JSON=0; DO_WIKI=1 ;;
-  both)   DO_JSON=1; DO_WIKI=1 ;;
-  *)      echo "Unknown option: $MODE" >&2; exit 1 ;;
-esac
-
-# Pre-flight: graph.jsonl must exist
-if [[ ! -f "$GRAPH_IN" ]]; then
-  cat >&2 <<EOF
-ERROR: $GRAPH_IN not found.
-
-The skill graph has not been built yet. Run the bigpowers-mcp
-build_skill_graph tool to generate it:
-
-  # Option A: via MCP inspector
-  npx @modelcontextprotocol/inspector node bigpowers-mcp/build/index.js
-  # Then call build_skill_graph
-
-  # Option B: via Node.js directly
-  node -e "
-    const {discoverSkills,readSkillFile}=require('./bigpowers-mcp/build/lib/skill-parser.js');
-    const {buildGraphFromSkills}=require('./bigpowers-mcp/build/lib/graph/builder.js');
-    const {saveGraph}=require('./bigpowers-mcp/build/lib/graph/store.js');
-    const skills=discoverSkills(process.cwd(),()=>'');
-    const parsed=skills.map(s=>readSkillFile(process.cwd(),s.name));
-    saveGraph('bigpowers-mcp/graph.jsonl', buildGraphFromSkills(parsed));
-  "
-EOF
+# --- Error handling ---
+missing_graph() {
+  echo "[ERROR] MCP graph not found at: $GRAPH_JSONL" >&2
+  echo "[ERROR] Run 'cd bigpowers-mcp && npm start' or e32s02 MCP tool first" >&2
   exit 1
-fi
+}
 
-# Parse graph.jsonl into nodes + edges
-echo "Reading $GRAPH_IN ..." >&2
+if [ ! -f "$GRAPH_JSONL" ]; then
+  missing_graph
+fi
 
-NODES_JSON="$REPO_ROOT/specs/.tmp-nodes.json"
-EDGES_JSON="$REPO_ROOT/specs/.tmp-edges.json"
+# --- Read graph.jsonl into temporary JSON ---
+TMP_NODES=$(mktemp)
+TMP_EDGES=$(mktemp)
+TMP_ALL=$(mktemp)
 
-python3 - "$GRAPH_IN" "$NODES_JSON" "$EDGES_JSON" <<'PYEOF'
+python3 -c "
 import json, sys
-from pathlib import Path
 
-graph_in = Path(sys.argv[1])
-nodes_out = Path(sys.argv[2])
-edges_out = Path(sys.argv[3])
-
-nodes = []
+nodes = {}
 edges = []
-entity_count = 0
-relation_count = 0
-parse_errors = 0
-
-with open(graph_in) as f:
-    for lineno, line in enumerate(f, 1):
-        line = line.strip()
-        if not line:
-            continue
-        try:
-            obj = json.loads(line)
-        except json.JSONDecodeError as e:
-            print(f"WARNING: {graph_in}:{lineno}: invalid JSON — {e}", file=sys.stderr)
-            parse_errors += 1
-            continue
-
-        if obj.get("type") == "entity":
-            nodes.append({
-                "name": obj["name"],
-                "entityType": obj.get("entityType", "Skill"),
-                "observations": obj.get("observations", []),
+
+with open('$GRAPH_JSONL') as f:
+    for line in f:
+        obj = json.loads(line)
+        if obj.get('type') == 'entity':
+            nodes[obj['name']] = {
+                'id': obj['name'],
+                'type': obj.get('entityType', 'Skill'),
+                'observations': obj.get('observations', [])
+            }
+        elif obj.get('type') == 'relation':
+            edges.append({
+                'source': obj.get('from', ''),
+                'target': obj.get('to', ''),
+                'relation': obj.get('relationType', 'references'),
+                'provenance': obj.get('provenance', '')
             })
-            entity_count += 1
-        elif obj.get("type") == "relation":
+
+# Emit node list
+print(json.dumps(list(nodes.values()), indent=2))
+" > "$TMP_NODES"
+
+python3 -c "
+import json
+# re-read edges into a separate file
+edges = []
+with open('$GRAPH_JSONL') 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", "unknown"),
+                'source': obj.get('from', ''),
+                'target': obj.get('to', ''),
+                'relation': obj.get('relationType', 'references'),
+                'provenance': obj.get('provenance', '')
             })
-            relation_count += 1
-        else:
-            print(f"WARNING: {graph_in}:{lineno}: unknown type {obj.get('type')}", file=sys.stderr)
-
-with open(nodes_out, "w") as f:
-    json.dump(nodes, f, indent=2)
-with open(edges_out, "w") as f:
-    json.dump(edges, f, indent=2)
-
-print(f"  Entities: {entity_count}, Relations: {relation_count}", file=sys.stderr)
-if parse_errors:
-    print(f"  Parse errors: {parse_errors}", file=sys.stderr)
-PYEOF
-
-# Emit specs/skill-graph.json
-if [[ "$DO_JSON" -eq 1 ]]; then
-  echo "Writing $GRAPH_OUT ..." >&2
-  python3 - "$NODES_JSON" "$EDGES_JSON" "$GRAPH_OUT" <<'PYEOF'
-import json, sys
+print(json.dumps(edges, indent=2))
+" > "$TMP_EDGES"
+
+# --- Write skill-graph.json ---
+python3 -c "
+import json
 
-with open(sys.argv[1]) as f:
+with open('$TMP_NODES') as f:
     nodes = json.load(f)
-with open(sys.argv[2]) as f:
+with open('$TMP_EDGES') as f:
     edges = json.load(f)
 
-graph = {"nodes": nodes, "edges": edges}
-with open(sys.argv[3], "w") as f:
+graph = {
+    'meta': {
+        'source': 'bigpowers-mcp/graph.jsonl',
+        'generated_by': 'scripts/build-skill-graph.sh',
+        'node_count': len(nodes),
+        'edge_count': len(edges)
+    },
+    'nodes': nodes,
+    'edges': edges
+}
+
+with open('$SKILL_GRAPH_JSON', 'w') as f:
     json.dump(graph, f, indent=2)
 
-print(f"  nodes: {len(nodes)}, edges: {len(edges)}", file=sys.stderr)
-PYEOF
-fi
+print(f'OK: {len(nodes)} nodes, {len(edges)} edges written to specs/skill-graph.json')
+"
 
-# Emit specs/skills-wiki/ OKF concepts
-if [[ "$DO_WIKI" -eq 1 ]]; then
-  echo "Writing $WIKI_DIR/ ..." >&2
-  rm -rf "$WIKI_DIR"
-  mkdir -p "$WIKI_DIR"
+# --- Emit specs/skills-wiki/ OKF bundle ---
+WIKI_INDEX="$REPO_ROOT/specs/skills-wiki/index.md"
+mkdir -p "$SKILLS_WIKI"
 
-  python3 - "$NODES_JSON" "$WIKI_DIR" <<'PYEOF'
-import json, sys, re
-from pathlib import Path
+# Generate index page
+cat > "$WIKI_INDEX" << WEOF
+# Skills Wiki — OKF Bundle
 
-nodes_file = Path(sys.argv[1])
-wiki_dir = Path(sys.argv[2])
+---
+type: Index
+title: Skills Wiki
+context: benchmark
+---
+
+**Generated by:** scripts/build-skill-graph.sh  
+**Source:** bigpowers-mcp/graph.jsonl
+
+## Skill Index
 
-with open(nodes_file) as f:
+WEOF
+
+# Generate one .md per skill
+python3 -c "
+import json, os
+
+# Re-read nodes
+with open('$TMP_NODES') as f:
     nodes = json.load(f)
 
-count = 0
-for node in nodes:
-    name = node["name"]
-    observations = node.get("observations", [])
-
-    model = ""
-    effort = ""
-    description = ""
-    for obs in observations:
-        if obs.startswith("model: "):
-            model = obs[7:]
-        elif obs.startswith("effort: "):
-            effort = obs[8:]
-        elif obs.startswith("description: "):
-            description = obs[13:]
-
-    # Derive phase from name convention (simplified)
-    phase = "utility"
-    critical_path = [
-        "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",
-    ]
-    if name in critical_path:
-        phase = "critical-path"
-
-    safe_desc = description.replace('"', '\\"')
-    md = f"""---
-type: Skill
-name: {name}
-phase: {phase}
-model: {model}
-effort: {effort}
-description: "{safe_desc}"
----
+skills_dir = '$SKILLS_WIKI'
+index_path = '$WIKI_INDEX'
 
-# {name}
+# Sort by phase then name
+nodes.sort(key=lambda n: (n.get('type', ''), n['id']))
 
-**Phase:** {phase}
-**Model:** {model}
-**Effort:** {effort}
+with open(index_path, 'a') as idx:
+    for node in nodes:
+        name = node['id']
+        ntype = node.get('type', 'Skill')
+        obs = node.get('observations', [])
 
-{description}
+        slug = name  # already kebab-case
 
-> Auto-generated by build-skill-graph.sh (e39s01) from bigpowers-mcp/graph.jsonl.
-> Source of truth: skills/{name}/SKILL.md
-"""
-    out_path = wiki_dir / f"{name}.md"
-    out_path.write_text(md)
-    count += 1
+        # Extract key fields from observations
+        model = ''
+        effort = ''
+        desc = ''
+        for o in obs:
+            if o.startswith('model:'):
+                model = o.replace('model:', '').strip()
+            elif o.startswith('effort:'):
+                effort = o.replace('effort:', '').strip()
+            elif o.startswith('description:'):
+                desc = o.replace('description:', '').strip()
 
-print(f"  concepts written: {count}", file=sys.stderr)
-PYEOF
-fi
+        # Write skill page
+        page = f'''# {name}
+
+**Type:** {ntype}  
+**Model:** {model or 'default'}  
+**Effort:** {effort or 'standard'}
+
+{desc}
+
+---
+
+*Auto-generated by scripts/build-skill-graph.sh*
+'''
+        with open(os.path.join(skills_dir, f'{slug}.md'), 'w') as pf:
+            pf.write(page)
+
+        # Add to index
+        idx.write(f'- [{name}](skills/{slug}.md) — {desc[:80] if desc else \"\"}\\n')
+
+print(f'OK: {len(nodes)} skill pages written to specs/skills-wiki/skills/')
+"
 
 # Cleanup
-rm -f "$NODES_JSON" "$EDGES_JSON"
+rm -f "$TMP_NODES" "$TMP_EDGES" "$TMP_ALL"
 
-echo "Done." >&2
+echo "Done."

package/scripts/check-spec-drift.sh

@@ -0,0 +1,121 @@
+#!/usr/bin/env bash
+# story: e39s03
+# Compare spec-file mtimes against implementing source-file mtimes,
+# mark suspect links, write to specs/drift-report.json
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+TRACE_MATRIX="$REPO_ROOT/specs/traceability-matrix.json"
+DRIFT_REPORT="$REPO_ROOT/specs/drift-report.json"
+
+show_help() {
+  cat <<EOF
+Usage: $(basename "$0") [OPTION]
+
+Compare spec/story mtimes vs implementing file mtimes to detect drift.
+Output: specs/drift-report.json with suspect and broken links.
+
+Options:
+  --help    Show this help and exit
+EOF
+}
+
+if [ "$#" -eq 1 ] && [ "$1" = "--help" ]; then
+  show_help
+  exit 0
+fi
+
+if [ ! -f "$TRACE_MATRIX" ]; then
+  echo "[ERROR] Traceability matrix not found: $TRACE_MATRIX" >&2
+  echo "[ERROR] Run scripts/trace-stories.sh first" >&2
+  exit 1
+fi
+
+python3 -c "
+import json, os, sys
+
+with open('$TRACE_MATRIX') as f:
+    matrix = json.load(f)
+
+drift = {
+    'meta': {
+        'generated_by': 'scripts/check-spec-drift.sh',
+        'source': 'specs/traceability-matrix.json',
+        'timestamp': __import__('datetime').datetime.now(__import__('datetime').timezone.utc).strftime('%Y-%m-%dT%H:%M:%SZ')
+    },
+    'suspect_links': [],
+    'broken_links': [],
+    'summary': {'suspect': 0, 'broken': 0, 'ok': 0}
+}
+
+repo_root = '$REPO_ROOT'
+
+stories = matrix.get('stories', [])
+assert isinstance(stories, list), 'stories must be a list'
+
+for entry in stories:
+    story_id = entry.get('id', '')
+    spec_path = entry.get('spec_path', '')
+    links = entry.get('links', [])
+
+    if not links:
+        drift['broken_links'].append({
+            'story_id': story_id,
+            'reason': 'no trace links',
+            'severity': 'broken'
+        })
+        drift['summary']['broken'] += 1
+        continue
+
+    impl_files = [link['file'] for link in links if link.get('file')]
+
+    if not impl_files:
+        drift['broken_links'].append({
+            'story_id': story_id,
+            'reason': 'no implementing files in trace links',
+            'severity': 'broken'
+        })
+        drift['summary']['broken'] += 1
+        continue
+
+    suspect_files = []
+
+    for impl_file in impl_files:
+        impl_full = os.path.join(repo_root, impl_file) if not os.path.isabs(impl_file) else impl_file
+        if os.path.exists(impl_full):
+            impl_mtime = os.path.getmtime(impl_full)
+            if spec_path and os.path.exists(spec_path):
+                spec_mtime = os.path.getmtime(spec_path)
+                if impl_mtime > spec_mtime:
+                    suspect_files.append({
+                        'file': impl_file,
+                        'impl_mtime': impl_mtime,
+                        'spec_mtime': spec_mtime,
+                        'age_seconds': impl_mtime - spec_mtime
+                    })
+        else:
+            drift['broken_links'].append({
+                'story_id': story_id,
+                'spec': spec_path,
+                'file': impl_file,
+                'reason': 'implementing file does not exist',
+                'severity': 'broken'
+            })
+            drift['summary']['broken'] += 1
+
+    if suspect_files:
+        drift['suspect_links'].append({
+            'story_id': story_id,
+            'spec': spec_path,
+            'files': suspect_files
+        })
+        drift['summary']['suspect'] += 1
+    else:
+        drift['summary']['ok'] += 1
+
+with open('$DRIFT_REPORT', 'w') as f:
+    json.dump(drift, f, indent=2)
+
+print(f'OK: {drift[\"summary\"][\"ok\"]} clean, {drift[\"summary\"][\"suspect\"]} suspect, {drift[\"summary\"][\"broken\"]} broken')
+"

package/scripts/check-spec-version-gap.sh

@@ -0,0 +1,143 @@
+#!/usr/bin/env bash
+# check-spec-version-gap.sh — detect spec format gap (e44s02)
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+BP_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+usage() {
+  cat <<'EOF'
+Usage: check-spec-version-gap.sh [--help] [--project <dir>] [--json]
+Exit codes: 0=no gap, 1=gap, 2=no specs, 3=blocked, 4=error
+EOF
+  exit 0
+}
+
+PROJECT_DIR="."
+JSON_STDOUT=false
+SKIP_BLOCK=false
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --help|-h) usage ;;
+    --project) PROJECT_DIR="${2:?}"; shift 2 ;;
+    --json) JSON_STDOUT=true; shift ;;
+    --skip-block) SKIP_BLOCK=true; shift ;;
+    *) echo "unknown: $1" >&2; exit 4 ;;
+  esac
+done
+
+PROJECT_DIR="$(cd "$PROJECT_DIR" 2>/dev/null && pwd)" || { echo "bad dir: $PROJECT_DIR" >&2; exit 4; }
+SPECS="$PROJECT_DIR/specs"
+
+emit_json() {
+  if $JSON_STDOUT; then echo "$1"; else echo "$1" >&2; fi
+}
+
+get_installed_version() {
+  python3 -c "import json; d=json.load(open('$BP_ROOT/package.json')); print(d.get('version','unknown'))" 2>/dev/null || echo "unknown"
+}
+
+yaml_get() {
+  [[ ! -f "$1" ]] && { echo ""; return; }
+  python3 -c "
+import sys, yaml
+d = yaml.safe_load(open('$1')) or {}
+parts = '$2'.split('.')
+cur = d
+for p in parts:
+    if isinstance(cur, dict): cur = cur.get(p)
+    else: print(''); sys.exit(0)
+print('' if cur is None else cur)
+" 2>/dev/null
+}
+
+version_lt() {
+  if [[ "$1" == "$2" ]]; then return 1; fi
+  local IFS=.; local a=($1) b=($2)
+  for i in "${!a[@]}"; do
+    local av="${a[$i]:-0}" bv="${b[$i]:-0}"
+    if (( av < bv )); then return 0; fi
+    if (( av > bv )); then return 1; fi
+  done
+  return 1
+}
+
+find_migrations() {
+  local ver="$1" reg="$BP_ROOT/specs/migrations/registry.okf.md"
+  [[ ! -f "$reg" ]] && { echo "[]"; return; }
+  python3 -c "
+import json, yaml
+def vt(v): return tuple(int(p) if p.isdigit() else 0 for p in v.lstrip('v').split('.')[:3])
+dt = vt('$ver')
+c = open('$reg').read()
+parts = c.split('---')
+fm = yaml.safe_load(parts[1]) if len(parts) >= 3 else {}
+out = []
+for m in fm.get('migrations', []):
+    if m.get('status') not in ('implemented','planned'): continue
+    st = vt(m.get('since_version','0'))
+    if dt < st:
+        out.append({'id': m['id'], 'since_version': m['since_version'], 'order': m.get('order',0), 'depends_on': m.get('depends_on',[]), 'actions_needed': m.get('actions_needed',[]), 'status': m.get('status','')})
+print(json.dumps(out))
+" 2>/dev/null
+}
+
+check_active_work() {
+  local branch; branch=$(git -C "$PROJECT_DIR" branch --show-current 2>/dev/null || echo "")
+  if [[ -n "$branch" && "$branch" != "main" && "$branch" != "master" ]]; then echo "true"; return; fi
+  if [[ -d "$SPECS" ]] && git -C "$PROJECT_DIR" status --porcelain -- specs/ 2>/dev/null | grep -q .; then echo "true"; return; fi
+  local af; af=$(yaml_get "$SPECS/state.yaml" "active_flow")
+  if [[ -n "$af" && "$af" != "null" && "$af" != "None" ]]; then
+    case "$af" in build_epic|develop_tdd|fix_bug) echo "true"; return ;; esac
+  fi
+  echo "false"
+}
+
+# Main
+[[ ! -d "$SPECS" ]] && { emit_json '{"gap":false,"reason":"NO_SPECS"}'; exit 2; }
+IV=$(get_installed_version)
+if [ "$SKIP_BLOCK" != "true" ] && [[ "$(check_active_work)" == "true" ]]; then
+  emit_json '{"gap":true,"blocked":true,"reason":"ACTIVE_WORK","installed_version":"'"$IV"'"}'
+  exit 3
+fi
+
+SV=$(yaml_get "$SPECS/state.yaml" "bigpowers_version")
+
+if [[ -n "$SV" && "$SV" != "null" && "$SV" != "None" ]]; then
+  if [[ "$SV" == "$IV" ]]; then
+    emit_json '{"gap":false,"stamp":true,"detected_version":"'"$SV"'","installed_version":"'"$IV"'","detection_method":"stamp","confidence":"high"}'
+    exit 0
+  fi
+  APP=$(find_migrations "$SV")
+  CNT=$(echo "$APP" | python3 -c "import json,sys; print(len(json.load(sys.stdin)))" 2>/dev/null || echo 0)
+  emit_json "$(python3 -c "import json; a=json.loads('''$APP'''); print(json.dumps({'gap':True,'stamp':True,'detected_version':'$SV','detection_method':'stamp','installed_version':'$IV','applicable_migrations':len(a),'migration_ids':[m['id'] for m in a],'confidence':'high','active_work_blocked':False}))")"
+  exit 1
+fi
+
+# Fingerprint
+DV=""; CONF="medium"; MARKERS=()
+[[ -f "$SPECS/STATE.md" ]] && { DV="1.0.0"; CONF="high"; MARKERS+=("STATE.md"); }
+[[ -f "$SPECS/state.yaml" ]] && { [[ -z "$DV" ]] && { DV="2.0.0"; MARKERS+=("state.yaml"); } || MARKERS+=("state.yaml (dual-era)"); }
+for f in release-plan.yaml execution-status.yaml product/SCOPE_LATEST.yaml metrics/cycle-times.yaml; do
+  [[ -f "$SPECS/$f" ]] && { MARKERS+=("$f"); [[ -z "$DV" ]] && DV="2.0.0"; }
+done
+if [[ -f "$SPECS/state.yaml" ]]; then
+  ec=$(yaml_get "$SPECS/state.yaml" "epic_cycle.current_step")
+  if [[ -n "$ec" && "$ec" != "null" && "$ec" != "None" ]]; then
+    MARKERS+=("epic_cycle"); [[ "$DV" == "2.0.0" ]] && DV="2.20.0"
+  fi
+fi
+if ls "$SPECS"/epics/*/epic.yaml 2>/dev/null | head -1 | grep -q .; then
+  MARKERS+=("epic capsules"); [[ "$DV" == "2.0.0" ]] && DV="2.20.0"; [[ -z "$DV" ]] && DV="2.20.0"
+fi
+[[ -z "$DV" ]] && { DV="unknown"; CONF="low"; }
+
+if [[ "$DV" != "unknown" ]] && ! version_lt "$DV" "$IV"; then
+  [[ "$DV" == "$IV" ]] && { emit_json '{"gap":false,"stamp":false,"detected_version":"'"$DV"'","installed_version":"'"$IV"'","detection_method":"fingerprint","confidence":"'"$CONF"'"}'; exit 0; }
+fi
+
+APP=$(find_migrations "$DV")
+CNT=$(echo "$APP" | python3 -c "import json,sys; print(len(json.load(sys.stdin)))" 2>/dev/null || echo 0)
+MJ=$(printf '%s\n' "${MARKERS[@]}" | python3 -c "import json,sys; print(json.dumps([l.strip() for l in sys.stdin if l.strip()]))" 2>/dev/null || echo "[]")
+
+emit_json "$(python3 -c "import json; a=json.loads('''$APP'''); m=json.loads('''$MJ'''); print(json.dumps({'gap':True,'stamp':False,'detected_version':'$DV','detection_method':'fingerprint','installed_version':'$IV','applicable_migrations':len(a),'migration_ids':[x['id'] for x in a],'confidence':'$CONF','active_work_blocked':False,'matched_markers':m}))")"
+exit 1