bigpowers 2.65.1 → 2.67.0

package/scripts/decompose-conventions.sh

@@ -0,0 +1,147 @@
+#!/usr/bin/env bash
+# story: e39s05
+# Decompose CONVENTIONS.md into specs/conventions-wiki/ OKF concept bundle
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+CONVENTIONS="$REPO_ROOT/CONVENTIONS.md"
+CONVENTIONS_WIKI="$REPO_ROOT/specs/conventions-wiki"
+CONVENTIONS_INDEX="$CONVENTIONS_WIKI/index.md"
+SKILL_GRAPH="$REPO_ROOT/specs/skill-graph.json"
+
+show_help() {
+  cat <<EOF
+Usage: $(basename "$0") [OPTION]
+
+Decompose CONVENTIONS.md into specs/conventions-wiki/ OKF concept bundle.
+Each major heading becomes a concept page with cross-references to enforcing skills.
+
+Options:
+  --help    Show this help and exit
+EOF
+}
+
+if [ "$#" -eq 1 ] && [ "$1" = "--help" ]; then
+  show_help
+  exit 0
+fi
+
+if [ ! -f "$CONVENTIONS" ]; then
+  echo "[ERROR] CONVENTIONS.md not found at $CONVENTIONS" >&2
+  exit 1
+fi
+
+mkdir -p "$CONVENTIONS_WIKI"
+
+# Generate index page
+cat > "$CONVENTIONS_INDEX" << 'IDXEOF'
+---
+type: Index
+title: Conventions Wiki
+context: conventions
+---
+
+# Conventions Wiki — OKF Bundle
+
+**Generated by:** scripts/decompose-conventions.sh (e39s05)
+
+## Convention Sections
+
+IDXEOF
+
+# Parse CONVENTIONS.md headings into sections
+python3 -c "
+import re, os, json
+
+with open('$CONVENTIONS') as f:
+    content = f.read()
+
+# Split on markdown headings (## or ###)
+sections = re.split(r'^(#{2,3})\s+(.+)$', content, flags=re.MULTILINE)
+
+# Load skill graph for cross-references
+graph_data = {}
+if os.path.exists('$SKILL_GRAPH'):
+    with open('$SKILL_GRAPH') as gf:
+        graph_data = json.load(gf)
+
+convention_skills = {}  # convention_name -> [skill_names]
+
+# Build mapping from edges (skill -> convention)
+for edge in graph_data.get('edges', []):
+    src = edge.get('source', '')
+    tgt = edge.get('target', '')
+    rel = edge.get('relation', '')
+    if rel == 'enforces' and tgt:
+        # tgt is something like 'CONVENTIONS.md §Tests;'
+        convention_name = tgt.replace('CONVENTIONS.md', '').replace('§', '').replace(';', '').strip()
+        if convention_name:
+            if convention_name not in convention_skills:
+                convention_skills[convention_name] = []
+            convention_skills[convention_name].append(src)
+
+# Process sections
+current_level = ''
+current_title = ''
+current_body = []
+section_count = 0
+
+for part in sections:
+    if part in ('##', '###'):
+        current_level = part
+    elif current_level and (current_title == ''):
+        current_title = part.strip()
+    elif current_level and current_title:
+        current_body.append(part)
+    elif current_level and current_title and not part.startswith('#'):
+        current_body.append(part)
+
+# Actually let me rebuild this properly
+lines = content.split('\n')
+i = 0
+sections_data = []
+current = None
+
+while i < len(lines):
+    line = lines[i]
+    m = re.match(r'^(###?)\s+(.+)$', line)
+    if m:
+        if current:
+            sections_data.append(current)
+        current = {
+            'level': len(m.group(1)),
+            'title': m.group(2).strip(),
+            'body': []
+        }
+    elif current:
+        current['body'].append(line)
+    i += 1
+
+if current:
+    sections_data.append(current)
+
+with open('$CONVENTIONS_INDEX', 'a') as idx:
+    for sec in sections_data:
+        slug = re.sub(r'[^a-z0-9]+', '-', sec['title'].lower()).strip('-')
+        sec_file = os.path.join('$CONVENTIONS_WIKI', f'{slug}.md')
+
+        # Check for enforcing skills
+        enforcing = convention_skills.get(sec['title'], [])
+
+        body_text = '\n'.join(sec['body']).strip()
+
+        with open(sec_file, 'w') as sf:
+            sf.write(f'---\ntype: Convention\ntitle: {sec[\"title\"]}\ncontext: conventions\n')
+            if enforcing:
+                sf.write(f'enforced_by:\n')
+                for sk in enforcing:
+                    sf.write(f'  - {sk}\n')
+            sf.write(f'---\n\n# {sec[\"title\"]}\n\n')
+            sf.write(f'{body_text}\n\n---\n*Auto-generated by scripts/decompose-conventions.sh (e39s05)*\n')
+
+        idx.write(f'- [{sec[\"title\"]}]({slug}.md)\\n')
+        section_count += 1
+
+print(f'OK: {section_count} convention sections written to specs/conventions-wiki/')
+"

package/scripts/generate-agent-guide.sh

@@ -0,0 +1,89 @@
+#!/usr/bin/env bash
+# story: e39s06
+# Decompose CLAUDE.md into specs/agent-guide/ for progressive disclosure
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+CLAUDE_MD="$REPO_ROOT/CLAUDE.md"
+AGENT_GUIDE="$REPO_ROOT/specs/agent-guide"
+
+show_help() {
+  cat <<EOF
+Usage: $(basename "$0") [OPTION]
+
+Decompose CLAUDE.md into specs/agent-guide/ OKF concept pages.
+Each section becomes a Guide concept with thin pointers.
+
+Options:
+  --help    Show this help and exit
+EOF
+}
+
+if [ "$#" -eq 1 ] && [ "$1" = "--help" ]; then
+  show_help
+  exit 0
+fi
+
+if [ ! -f "$CLAUDE_MD" ]; then
+  echo "[WARN] CLAUDE.md not found — trying GEMINI.md" >&2
+  CLAUDE_MD="$REPO_ROOT/GEMINI.md"
+  if [ ! -f "$CLAUDE_MD" ]; then
+    echo "[ERROR] Neither CLAUDE.md nor GEMINI.md found" >&2
+    exit 1
+  fi
+fi
+
+mkdir -p "$AGENT_GUIDE"
+
+python3 -c "
+import re, os
+
+with open('$CLAUDE_MD') as f:
+    content = f.read()
+
+lines = content.split('\n')
+sections = []
+current_title = ''
+current_body = []
+
+for line in lines:
+    m = re.match(r'^(#{2,3})\s+(.+)$', line)
+    if m:
+        if current_title:
+            sections.append((current_title, '\n'.join(current_body)))
+        current_title = m.group(2).strip()
+        current_body = []
+    elif current_title:
+        current_body.append(line)
+
+if current_title:
+    sections.append((current_title, '\n'.join(current_body)))
+
+guide_dir = '$AGENT_GUIDE'
+
+with open(os.path.join(guide_dir, 'index.md'), 'w') as idx:
+    idx.write('---\ntype: Index\ntitle: Agent Guide\ncontext: guide\n---\n\n')
+    idx.write('# Agent Guide — OKF Bundle\n\n')
+    idx.write(f'**Generated by:** scripts/generate-agent-guide.sh (e39s06)\n')
+    idx.write(f'**Source:** CLAUDE.md\n\n')
+    idx.write('## Guide Sections\n\n')
+
+    for title, body in sections:
+        slug = re.sub(r'[^a-z0-9]+', '-', title.lower()).strip('-')
+        sec_file = os.path.join(guide_dir, f'{slug}.md')
+
+        with open(sec_file, 'w') as sf:
+            sf.write(f'---\ntype: Guide\ntitle: {title}\ncontext: guide\n')
+            sf.write(f'source: CLAUDE.md#{slug}\n---\n\n')
+            sf.write(f'# {title}\n\n')
+            # Thin pointer — first 200 chars
+            preview = body.strip()[:200]
+            sf.write(f'{preview}\n\n')
+            sf.write(f'> Full content: $CLAUDE_MD section \"{title}\"\n')
+            sf.write('---\n*Auto-generated by scripts/generate-agent-guide.sh*\n')
+
+        idx.write(f'- [{title}]({slug}.md)\n')
+
+print(f'OK: {len(sections)} guide sections written to specs/agent-guide/')
+"

package/scripts/hermes-verify-e39s02.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+# Ad-hoc verification: e39s02 agent-locks protocol
+REPO="/Users/danielvm/Developer/bigpowers"
+ERR=0
+echo "=== e39s02 agent-locks verification ==="
+
+echo -n "1. agent-locks.yaml: "
+test -f "$REPO/specs/agent-locks.yaml" || { echo "MISSING"; ERR=1; }
+LOCKS=$(yq '.locks | length' "$REPO/specs/agent-locks.yaml" 2>/dev/null)
+[ "$LOCKS" = "0" ] && echo "OK (0 locks)" || { echo "FAIL ($LOCKS)"; ERR=1; }
+
+echo -n "2. kickoff-branch: "
+grep -q 'agent-locks' "$REPO/skills/kickoff-branch/SKILL.md" && echo "OK" || { echo "FAIL"; ERR=1; }
+
+echo -n "3. release-branch: "
+grep -q 'agent-locks' "$REPO/skills/release-branch/SKILL.md" && echo "OK" || { echo "FAIL"; ERR=1; }
+
+echo -n "4. CI workflow: "
+grep -rq 'agent-locks' "$REPO/.github/workflows/" && echo "OK" || { echo "FAIL"; ERR=1; }
+echo -n "   24h threshold: "
+grep -q 'timedelta(hours=24)' "$REPO/.github/workflows/agent-locks.yml" && echo "OK" || { echo "FAIL"; ERR=1; }
+echo -n "   exit(1): "
+grep -q 'sys.exit(1)' "$REPO/.github/workflows/agent-locks.yml" && echo "OK" || { echo "FAIL"; ERR=1; }
+echo -n "   hourly cron: "
+grep -q 'cron: "0 \* \* \* \*"' "$REPO/.github/workflows/agent-locks.yml" && echo "OK" || { echo "FAIL"; ERR=1; }
+
+[ $ERR -eq 0 ] && echo "ALL CHECKS PASSED" || echo "SOME FAILED"
+exit $ERR