Snoozer10/synthesize-skills / .opencode/skills/repo-blast-radius-sync
repo-blast-radius-sync
VerifiedUse when checking code changes for orphaned callers, outdated tests, or stale documentation, discovering change blast radius, or verifying git staged parity against the dependency registry
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.8 KB |
| SKILL.md.bak-20260909-094445 | other | 3.3 KB |
| SKILL.md.bak-20260909-102612 | other | 3.7 KB |
| SKILL.md.bak-20260922-055209 | other | 3.8 KB |
| references/append_ledger.py.example | other | 3.6 KB |
| references/mcp_manifest.json.example | other | 2.7 KB |
| references/registry_schema.json | config | 1.5 KB |
| scripts/blast_radius.py | script | 9.5 KB |
| scripts/blast_radius.py.bak-20260909-094445 | other | 8.3 KB |
| scripts/build_registry.py | script | 6.2 KB |
| scripts/build_registry.py.bak-20260909-094445 | other | 5.2 KB |
| scripts/dashboard.py | script | 6.6 KB |
| scripts/dashboard.py.bak-20260922-055210 | other | 6.3 KB |
| scripts/draft_doc_updates.py | script | 4.6 KB |
| scripts/draft_doc_updates.py.bak-20260909-094445 | other | 4.1 KB |
| scripts/verify_parity.py | script | 11.1 KB |
| scripts/verify_parity.py.bak-20260909-094445 | other | 7.3 KB |
scripts/verify_parity.py
View on GitHub#!/usr/bin/env python3
"""
Pre-commit Verification Gate for repo-blast-radius-sync.
Analyzes current dirty git status against compiled blast radius definitions.
Enforces strict synchronization to prevent orphaned edits.
"""
import json
import os
import sys
import subprocess
import argparse
from pathlib import Path
from typing import Set, Dict, List, Any
try:
from blast_radius import BlastRadiusResolver
except ImportError:
from scripts.blast_radius import BlastRadiusResolver
if hasattr(sys.stdout, "reconfigure"):
sys.stdout.reconfigure(encoding="utf-8", errors="replace")
if hasattr(sys.stderr, "reconfigure"):
sys.stderr.reconfigure(encoding="utf-8", errors="replace")
class ParityVerifier:
def __init__(self, root_dir: Path, strict_mode: bool = False, staged_only: bool = False, dry_run: bool = False):
self.root_dir = root_dir
self.resolver = BlastRadiusResolver(root_dir)
self.strict_mode = strict_mode
self.staged_only = staged_only
self.dry_run = dry_run
self.stale_registry = False
def get_dirty_git_files(self) -> Set[str]:
"""Obtains changed files via -z NUL parse with line-mode fallback."""
from pathlib import PurePosixPath
dirty_files: Set[str] = set()
try:
out = subprocess.check_output(
["git", "status", "--porcelain=v1", "-z"],
cwd=str(self.root_dir), stderr=subprocess.DEVNULL
)
parts = out.split(b"\x00")
i = 0
while i < len(parts):
raw = parts[i]; i += 1
if not raw: continue
if len(raw) < 3: continue
xy = raw[:2]
path = raw[3:]
try: s = path.decode("utf-8")
except: s = path.decode("utf-8", errors="replace")
if s.startswith('"') and s.endswith('"'):
try: s = s[1:-1].encode("utf-8").decode("unicode_escape").encode("latin1").decode("utf-8", errors="replace")
except: pass
if xy[0:1] in b"RC" and i < len(parts):
new_raw = parts[i]; i += 1
if new_raw:
try: ns = new_raw.decode("utf-8")
except: ns = new_raw.decode("utf-8", errors="replace")
if ns.startswith('"') and ns.endswith('"'):
try: ns = ns[1:-1].encode("utf-8").decode("unicode_escape").encode("latin1").decode("utf-8", errors="replace")
except: pass
# Preserve both the old origin path and the new target path
dirty_files.add(PurePosixPath(ns).as_posix())
ps = PurePosixPath(s).as_posix()
staged_indicator = chr(xy[0]) if len(xy) > 0 else " "
unstaged_indicator = chr(xy[1]) if len(xy) > 1 else " "
if self.staged_only:
if staged_indicator in ("M", "A", "D", "R", "C", "T"):
dirty_files.add(ps)
else:
if staged_indicator in ("M", "A", "D", "R", "C", "T", "?") or unstaged_indicator in ("M", "A", "D", "R", "C", "T"):
dirty_files.add(ps)
except subprocess.CalledProcessError:
try:
out2 = subprocess.check_output(
["git", "status", "--porcelain=v1"],
cwd=str(self.root_dir), stderr=subprocess.DEVNULL
).decode("utf-8", errors="replace")
import shlex
for line in out2.splitlines():
if not line.strip(): continue
xy = line[:2]; rest = line[3:]
lexer = shlex.shlex(rest, posix=True); lexer.whitespace = " "; lexer.whitespace_split = True
try: toks = list(lexer)
except: toks = [rest.strip().strip('"')]
s = toks[-1] if "->" in toks and len(toks) >= 3 else (toks[0] if toks else rest.strip().strip('"'))
ps = PurePosixPath(s).as_posix()
staged_indicator = xy[0] if len(xy) > 0 else " "
unstaged_indicator = xy[1] if len(xy) > 1 else " "
if self.staged_only:
if staged_indicator in ("M", "A", "D", "R", "C", "T"):
dirty_files.add(ps)
else:
if staged_indicator in ("M", "A", "D", "R", "C", "T", "?") or unstaged_indicator in ("M", "A", "D", "R", "C", "T"):
dirty_files.add(ps)
print("WARN: legacy porcelain", file=sys.stderr)
except Exception as e:
print(f"Warning: Failed to parse git workspace state: {e}", file=sys.stderr)
except Exception as e:
print(f"Warning: Failed to parse git workspace state: {e}", file=sys.stderr)
# stale registry check
self.stale_registry = False
try:
reg = self.root_dir / ".agent" / "registry.json"
if reg.exists():
mtime = reg.stat().st_mtime
ignore_dirs = {".git", "node_modules", ".venv", "venv", "__pycache__", "dist", "build"}
py_files = [
p for p in self.root_dir.rglob("*.py")
if p.is_file() and not any(part in ignore_dirs for part in p.parts)
]
max_src = max((p.stat().st_mtime for p in py_files), default=mtime)
if max_src > mtime:
self.stale_registry = True
print("ERR_STALE_REGISTRY: registry stale, run build_registry", file=sys.stderr)
except Exception:
pass
return {PurePosixPath(p).as_posix().replace("\\", "/") for p in dirty_files}
def verify(self) -> int:
"""Audits dirty files vs their target blast-radius constraints."""
dirty_files = self.get_dirty_git_files()
if self.stale_registry and self.strict_mode:
print("CRITICAL VERIFICATION ERROR: Stale registry detected in strict mode. Run build_registry.py.", file=sys.stderr)
return 1
if not dirty_files:
print("Parity Verification PASSED: Git workspace is fully clean.")
return 0
failures: Dict[str, List[Dict[str, str]]] = {}
for file in dirty_files:
# Only audit code files (source code edits)
if not file.endswith((".py", ".js", ".ts", ".go", ".cpp", ".java")):
continue
radius = self.resolver.resolve(file)
docs_radius = set(radius["GOVERNING DOCS"])
tests_radius = set(radius["TEST SUITES"])
configs_radius = set(radius["CONFIGS/SCHEMAS"])
callers_radius = set(radius["CODE CALLERS"])
missing_docs = docs_radius - dirty_files
missing_tests = tests_radius - dirty_files
missing_configs = configs_radius - dirty_files
missing_callers = callers_radius - dirty_files
file_failures = []
# Non-strict mode enforcement: coupled files defined in annotations must be touched
if missing_docs:
for doc in missing_docs:
file_failures.append({"file": doc, "type": "GOVERNING DOC", "reason": "Explicit coupling annotation"})
if missing_tests:
for test in missing_tests:
file_failures.append({"file": test, "type": "TEST SUITE", "reason": "Explicit coupling annotation"})
# Strict mode enforcement: Caller updates and adjacent config synchronization required
if self.strict_mode:
if missing_configs:
for cfg in missing_configs:
file_failures.append({"file": cfg, "type": "CONFIG/SCHEMA", "reason": "Strict dependency synchronization"})
if missing_callers:
for caller in missing_callers:
file_failures.append({"file": caller, "type": "CODE CALLER", "reason": "Strict upstream interface synchronization"})
# Heuristic advisory (WARN, not ERR): only warn if no explicit links
if not docs_radius:
doc_stem_found = any(f.endswith(".md") and Path(file).stem in f for f in dirty_files)
if not doc_stem_found and not any(f.startswith("docs/") for f in dirty_files):
print(f"WARN: heuristic missing docs for {file} — docs/ or .md matching {Path(file).stem}", file=sys.stderr)
if not tests_radius:
test_stem_found = any(f.startswith("tests/") and Path(file).stem in f for f in dirty_files)
if not test_stem_found:
print(f"WARN: heuristic missing tests for {file} — tests/ matching {Path(file).stem}", file=sys.stderr)
if file_failures:
failures[file] = file_failures
if failures:
# Construct a structured, machine-readable validation failure block to stderr
structured_error = {
"status": "gate_failed",
"error_code": "ERR_ORPHAN_EDIT_VIOLATION",
"summary": "Orphaned edits detected in repository! Changes to source code files require synchronized docs/tests.",
"payload": {
"dirty_files": sorted(list(dirty_files)),
"failures": {
src: [{ "file": f["file"], "type": f["type"], "coupled_via": f["reason"] } for f in flist]
for src, flist in failures.items()
}
}
}
print("=================================================================", file=sys.stderr)
print("CRITICAL VERIFICATION ERROR: SYSTEMIC ORPHANED EDITS", file=sys.stderr)
print("=================================================================", file=sys.stderr)
print(json.dumps(structured_error, indent=2), file=sys.stderr)
print("=================================================================", file=sys.stderr)
print("Action Required: Modify or add the missing test/documentation files listed above before completing your task.", file=sys.stderr)
return 1
print("Parity Verification PASSED: All blast-radius couplings are fully synchronized.")
return 0
if __name__ == "__main__":
parser = argparse.ArgumentParser(description="Enforce synchronous repository edits across tests and documentation", epilog="Example: python scripts/verify_parity.py --strict --dry-run")
parser.add_argument("--strict", action="store_true", help="Enforce verification across configs and upstream callers")
parser.add_argument("--staged-only", action="store_true", help="Verify only files staged in git index")
parser.add_argument("--dry-run", action="store_true", help="Print JSON to stdout, preserve exit code, no FS write")
args = parser.parse_args()
verifier = ParityVerifier(
Path(os.getcwd()),
strict_mode=args.strict,
staged_only=args.staged_only,
dry_run=args.dry_run
)
sys.exit(verifier.verify())Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |