Open-source AI Security Operations Center: alert fusion, LLM-agent triage, MITRE ATT&CK investigation, and a replayable decision ledger for every agent step. Self-hostable, runs with no API keys, MIT licensed. Ships an MCP server for Claude, Cursor and Continue.
Python agentic-aiai-securityalert-triageblue-teamcybersecuritydetection-engineeringincident-responselanggraphllm-agentsmcpmitre-attackmodel-context-protocolpurple-teamsecurity-operationsself-hostedsiemsoarsocthreat-detectionthreat-intelligence
#!/usr/bin/env python3
"""Governance-completeness gate (Phase 12 — observability + governance).
Open-source trust rests on a small set of documents actually existing and being
non-trivial: governance model, maintainers, security policy, code of conduct,
trademark, and a DCO sign-off requirement. This gate fails if any is missing,
empty, or (for DCO) unreferenced — so the project's governance surface can't
silently rot.
Usage:
python3 scripts/check_governance.py
"""
from __future__ import annotations
import sys
from pathlib import Path
# `scripts/` is on sys.path when this file is run as a program, but not when a
# test loads it by path with importlib. gate_toolkit sits beside it either way.
sys.path.insert(0, str(Path(__file__).resolve().parent))
from gate_toolkit import repo_root, self_test_if_requested
self_test_if_requested(__file__)
ROOT = repo_root()
# file → (min non-whitespace chars, [required substrings])
_REQUIRED = {
"GOVERNANCE.md": (600, ["maintainer", "Neutral home", "Decision-making"]),
"MAINTAINERS.md": (150, ["Maintainers"]),
"SECURITY.md": (300, []),
"CODE_OF_CONDUCT.md": (300, []),
"TRADEMARK.md": (150, []),
"CONTRIBUTING.md": (600, ["Developer Certificate of Origin", "Signed-off-by"]),
"docs/operations/slos.yaml": (300, ["availability_target"]),
"docs/operations/observability.md": (500, ["golden signal", "trace"]),
}
def main() -> int:
errors: list[str] = []
for rel, (min_chars, substrings) in _REQUIRED.items():
path = ROOT / rel
if not path.exists():
errors.append(f"missing required governance file: {rel}")
continue
text = path.read_text(encoding="utf-8")
if len(text.strip()) < min_chars:
errors.append(f"{rel} is too short ({len(text.strip())} < {min_chars} chars) — looks like a stub")
low = text.lower()
for sub in substrings:
if sub.lower() not in low:
errors.append(f"{rel} is missing required content: '{sub}'")
if errors:
print("ERROR: governance-completeness gate failed:", file=sys.stderr)
for e in errors:
print(f" - {e}", file=sys.stderr)
return 1
print(f"OK: all {len(_REQUIRED)} governance documents present and non-trivial")
return 0
if __name__ == "__main__":
raise SystemExit(main())