First commit

Author: Dee66

fix_blank_lines.py

@@ -0,0 +1,32 @@
+#!/usr/bin/env python3
+import os
+
+
+def fix_blank_lines(file_path):
+    with open(file_path, 'r') as f:
+        lines = f.readlines()
+
+    new_lines = []
+    blank_count = 0
+    for line in lines:
+        if line.strip() == '':
+            blank_count += 1
+            if blank_count <= 2:
+                new_lines.append(line)
+        else:
+            blank_count = 0
+            new_lines.append(line)
+
+    with open(file_path, 'w') as f:
+        f.writelines(new_lines)
+
+
+def main():
+    for root, dirs, files in os.walk('src'):
+        for file in files:
+            if file.endswith('.py'):
+                fix_blank_lines(os.path.join(root, file))
+
+
+if __name__ == '__main__':
+    main()

scripts/attach_test_refs.py

@@ -14,6 +14,7 @@
 registry = []
 hex_id_re = re.compile(r"[0-9a-f]{10,}")
 
+
 def extract_tests_from_file(p: Path):
     txt = p.read_text()
     functions = re.findall(r"def\s+(test_[A-Za-z0-9_]+)", txt)
@@ -28,6 +29,7 @@ def extract_tests_from_file(p: Path):
         'content': txt,
     }
 
+
 for f in sorted(TEST_ROOT.rglob('test_*.py')):
     registry.append(extract_tests_from_file(f))
 

scripts/audit_docs.py

@@ -32,4 +32,4 @@
 report = {'categories': categories, 'total_files': sum(len(v) for v in categories.values())}
 report_path = OUT / 'doc_classification_report.json'
 report_path.write_text(json.dumps(report, indent=2))
-print(json.dumps(report, indent=2))
+print(json.dumps(report, indent=2))

scripts/canonical_full_run.py

@@ -28,7 +28,11 @@ def run_once(tag: str):
 
     # Clear persona/exec state
     exec_dir = Path("artifacts")
-    for fname in ["execution_state_v1.json", "persona_annotations_v1.json", "persona_events_v1.json", "persona_events_v1.hash"]:
+    for fname in [
+        "execution_state_v1.json",
+        "persona_annotations_v1.json",
+        "persona_events_v1.json",
+            "persona_events_v1.hash"]:
         p = exec_dir / fname
         if p.exists():
             p.unlink()
@@ -83,6 +87,8 @@ def run_once(tag: str):
     return run_dir, produced
 
 # Run twice
+
+
 def main():
     run1_dir, run1_files = run_once("run1")
     run2_dir, run2_files = run_once("run2")

scripts/canonicalize_spec.py

@@ -1,4 +1,4 @@
-import os
+import yaml
 import json
 import hashlib
 from pathlib import Path
@@ -10,7 +10,6 @@
 OUT_DIR.mkdir(parents=True, exist_ok=True)
 
 # Load source YAML via safe loader
-import yaml
 src = yaml.safe_load(open(SRC))
 
 # Helper
@@ -122,8 +121,27 @@
 out_spec.write_text(json.dumps(canonical, indent=2, sort_keys=True))
 
 # Step 3: produce gap report
-missing_required_fields = [k for k, v in canonical.items() if v == UNKNOWN or (isinstance(v, dict) and any(vv == UNKNOWN or (isinstance(vv, list) and UNKNOWN in vv) for vv in v.values()))]
-ambiguous_sections = ["build_contract", "error_contract", "evidence_bundle", "state_machine", "schema_contract", "artifact_contract", "ci_contract", "generation_mappings", "observability", "security"]
+missing_required_fields = [
+    k for k,
+    v in canonical.items() if v == UNKNOWN or (
+        isinstance(
+            v,
+            dict) and any(
+                vv == UNKNOWN or (
+                    isinstance(
+                        vv,
+                        list) and UNKNOWN in vv) for vv in v.values()))]
+ambiguous_sections = [
+    "build_contract",
+    "error_contract",
+    "evidence_bundle",
+    "state_machine",
+    "schema_contract",
+    "artifact_contract",
+    "ci_contract",
+    "generation_mappings",
+    "observability",
+    "security"]
 blocked_generation_reasons = []
 if metadata["product_id"] == UNKNOWN:
     blocked_generation_reasons.append("missing_product_id")

scripts/ci/clean_pycache.py

@@ -1,6 +1,5 @@
 #!/usr/bin/env python3
 """Utility: remove stale __pycache__ and .pyc files in the repository (for CI hygiene)."""
-import os
 import pathlib
 
 root = pathlib.Path(__file__).resolve().parents[2]

scripts/deep_dsl_field_trace.py

@@ -1,8 +1,12 @@
-import ast, json, os
+import ast
+import json
+import os
 
 TARGET = "artifacts/dsl_field_usage.json"
 
 # Keys accessed via obj["key"] or dict.get("key")
+
+
 class FieldAccessVisitor(ast.NodeVisitor):
     def __init__(self):
         self.keys = set()
@@ -27,6 +31,8 @@ def visit_Call(self, node):
         self.generic_visit(node)
 
 # JSON pointer fragments inside string literals
+
+
 class PointerVisitor(ast.NodeVisitor):
     def __init__(self):
         self.fragments = set()
@@ -77,5 +83,6 @@ def main():
     with open(TARGET, "w", encoding="utf-8") as f:
         json.dump(out, f, indent=2)
 
+
 if __name__ == "__main__":
     main()

scripts/dsl_runtime_reflector.py

@@ -1,4 +1,5 @@
-import json, os, importlib
+import json
+import importlib
 from inspect import getmembers, isclass, isfunction
 
 SCHEMA_PATH = 'spec/schemas/se_dsl_v1.schema.json'
@@ -10,6 +11,7 @@
 
 schema_fields = set()
 
+
 def walk_schema(node, prefix=''):
     if isinstance(node, dict):
         for k, v in node.items():
@@ -22,6 +24,7 @@ def walk_schema(node, prefix=''):
         for item in node:
             walk_schema(item, prefix)
 
+
 walk_schema(schema)
 
 # Runtime structural extraction
@@ -35,6 +38,7 @@ def walk_schema(node, prefix=''):
     'shieldcraft',
 ]
 
+
 def collect_from_object(obj):
     # Look for attribute access patterns
     for name in dir(obj):
@@ -61,6 +65,7 @@ def load_and_reflect():
             except Exception:
                 pass
 
+
 load_and_reflect()
 
 # Compare schema fields and runtime fields

scripts/emit_manifest_dryrun.py

@@ -2,40 +2,38 @@
 """
 Emit manifest in dry-run mode for CI validation.
 """
+from shieldcraft.services.spec.schema_validator import validate_spec_against_schema
+from shieldcraft.dsl.loader import load_spec
 import json
 import sys
 from pathlib import Path
 
 # Add src to path
 sys.path.insert(0, str(Path(__file__).parent.parent / "src"))
 
-from shieldcraft.dsl.loader import load_spec
-from shieldcraft.services.spec.schema_validator import validate_spec_against_schema
-from shieldcraft.services.io.manifest_writer import write_manifest_v2
-
 
 def main():
     spec_path = "spec/se_dsl_v1.spec.json"
     schema_path = "spec/schemas/se_dsl_v1.schema.json"
-    
+
     # Load spec using canonical DSL
     spec = load_spec(spec_path)
-    
+
     # Extract raw dict from SpecModel if needed
     if hasattr(spec, 'raw'):
         spec_raw = spec.raw
     else:
         spec_raw = spec
-    
+
     # Validate
     valid, errors = validate_spec_against_schema(spec_raw, schema_path)
-    
+
     if not valid:
         print("ERROR: Schema validation failed")
         for error in errors:
             print(f"  - {error}")
         sys.exit(1)
-    
+
     # Create dry-run manifest preview
     manifest_data = {
         "spec_path": spec_path,
@@ -44,12 +42,12 @@ def main():
         "validation": "passed",
         "dry_run": True
     }
-    
+
     # Write preview
     Path("artifacts").mkdir(exist_ok=True)
     with open("artifacts/manifest_preview.json", "w") as f:
         json.dump(manifest_data, f, indent=2)
-    
+
     print("Manifest preview written to artifacts/manifest_preview.json")
     return 0
 

scripts/extract_dsl_field_usage.py

@@ -1,7 +1,10 @@
-import os, json, ast
+import os
+import json
+import ast
 
 TARGET_FILE = "artifacts/dsl_field_usage.json"
 
+
 def extract_keys_from_dict_nodes(node):
     keys = []
     if isinstance(node, ast.Dict):
@@ -10,6 +13,7 @@ def extract_keys_from_dict_nodes(node):
                 keys.append(k.value)
     return keys
 
+
 def walk_file(path):
     keys = []
     try:
@@ -21,6 +25,7 @@ def walk_file(path):
         pass
     return keys
 
+
 def list_python_files():
     result = []
     for root, dirs, files in os.walk("src/shieldcraft"):
@@ -29,6 +34,7 @@ def list_python_files():
                 result.append(os.path.join(root, f))
     return result
 
+
 def main():
     files = list_python_files()
     ast_fields = set()
@@ -64,5 +70,6 @@ def main():
     with open(TARGET_FILE, "w", encoding="utf-8") as f:
         json.dump(final, f, indent=2)
 
+
 if __name__ == "__main__":
     main()