feat(plan-01): Phase 1 — relocate harness code to packages/casan-harness (symlink facade)

Physically move the pure-code subtrees out of .specify into the package, leaving compat symlinks at the old .specify/<dir> paths so every existing reference (internal CASAN_HARNESS_ROOT + external CI/docker/mjs) keeps resolving. Runtime state stays put. Moved (git mv): scripts/ tests/ security/ templates/ config/ governance/ memory/ .specify/<dir> -> packages/casan-harness/<dir> (+ .specify/<dir> symlink) Stays in .specify (state/governance/domain, handled later): logs/ agentops/ level5/ init-options.json traceability-map.json Python `.resolve()` self-location followed the compat symlink into packages and lost the app root; generate-casan-demo-context.py, generate-agentops-dashboard.py and dashboard-server.py now walk UP for the `.specify` state marker instead of a fixed parent depth (fixes "missing trace files" in run-casan4). Full gate: PASS=64 FAIL=0 SKIP=3 (CASAN_CI_STEP_TIMEOUT_SEC=1200 — track-a ~450s runs close to the 600s default and can tip over under load; this is timing variance, not a regression — it passed cleanly with headroom). Runtime log/audit artifacts kept unstaged. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-08 00:06:00 +09:00
parent 2c765c9a45
commit 664bd1f00c
229 changed files with 268 additions and 3 deletions
@@ -0,0 +1,85 @@
+#!/usr/bin/env python3
+"""CASAN H4 PII masker driven by .specify/security/pii-rules.yaml.
+
+Reads content on stdin, applies every `action: mask` rule from the rules
+file, and writes the masked content to stdout. Type-specific replacement
+tokens are preserved so downstream evidence stays stable
+(***MASKED_EMAIL***, ***MASKED_PHONE***, ***MASKED_ID***).
+
+This makes pii-rules.yaml the source of truth for PII masking instead of
+dead config: editing/removing a rule changes runtime behavior.
+"""
+import re
+import sys
+
+REPLACEMENT_BY_TYPE = {
+    "email": "***MASKED_EMAIL***",
+    "phone": "***MASKED_PHONE***",
+    "personal_id": "***MASKED_ID***",
+    "address": "***MASKED_ADDRESS***",
+}
+
+
+def load_rules(path):
+    rules, cur = [], {}
+    with open(path, encoding="utf-8") as fh:
+        for raw in fh:
+            s = raw.strip()
+            m = re.match(r"-\s*id:\s*(\S+)", s)
+            if m:
+                if cur:
+                    rules.append(cur)
+                cur = {"id": m.group(1)}
+                continue
+            m = re.match(r'type:\s*"?([^"\s]+)"?', s)
+            if m:
+                cur["type"] = m.group(1)
+                continue
+            m = re.match(r'regex:\s*"(.*)"\s*$', s)
+            if m:
+                # YAML double-quoted: collapse \\ -> \ to recover the real regex.
+                cur["regex"] = m.group(1).replace("\\\\", "\\")
+                continue
+            m = re.match(r"action:\s*(\S+)", s)
+            if m:
+                cur["action"] = m.group(1)
+                continue
+    if cur:
+        rules.append(cur)
+    return rules
+
+
+def main():
+    data = sys.stdin.read()
+    # SEC-08 (M-06): FAIL CLOSED. Previously a missing rules file, an unreadable
+    # file, or a broken rule regex all emitted the RAW data — so a mask rule that
+    # failed to load silently leaked the PII it was meant to hide. Now any such
+    # condition emits NOTHING and exits non-zero: no unmasked content ever escapes.
+    if len(sys.argv) < 2:
+        sys.stderr.write("PII_MASK_FAIL no rules file provided (fail-closed)\n")
+        return 1
+    try:
+        rules = load_rules(sys.argv[1])
+    except OSError as exc:
+        sys.stderr.write(f"PII_MASK_FAIL rules file unreadable (fail-closed): {exc}\n")
+        return 1
+    # Pre-compile every mask rule; a broken regex is fatal (that PII type would
+    # otherwise pass through unmasked). Validate all BEFORE emitting anything.
+    compiled = []
+    for rule in rules:
+        if rule.get("action") != "mask" or "regex" not in rule:
+            continue
+        token = REPLACEMENT_BY_TYPE.get(rule.get("type", ""), "***MASKED***")
+        try:
+            compiled.append((re.compile(rule["regex"]), token))
+        except re.error as exc:
+            sys.stderr.write(f"PII_MASK_FAIL bad regex in rule {rule.get('id')} (fail-closed): {exc}\n")
+            return 1
+    for rx, token in compiled:
+        data = rx.sub(token, data)
+    sys.stdout.write(data)
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())