Heads up This site is currently under heavy development.
← all tools
◆ AI/LLM Security

ai-safe2-framework

v3.1 open-source

The Universal Governance, Risk, Compliance (GRC) Operating System with Integrated Security for Agentic AI, Non-Human Identities, and Swarm Governance. AI SAFE² + AI Sovereignty Maturity Model (AISM), NEXUS-A2A Protocol, FORGE-Act, Marshal Plan for AI [Dual License: MIT + CC-BY-SA]

Summary

ai-safe2-framework is an open-source GRC framework, dual-licensed under MIT and CC BY-SA 4.0, that defines controls for governing agentic AI systems and mapping them to compliance standards such as ISO 42001, NIST AI RMF, and the EU AI Act. It ships as a set of specification documents, control mappings, and enforcement scripts you drop into a project or agent workspace, with a CLI for generating compliance reports and setting failure thresholds by tier, rather than a hosted service. It targets compliance and AI governance teams working with agentic or multi-agent ("swarm") systems who need audit evidence rather than a code library. Its README frames it as a comparison point for existing GRC standards rather than naming a specific competing tool, positioning itself as a universal mapping layer across 32 frameworks.

The Universal Governance, Risk, Compliance (GRC) Operating System with Integrated Security for Agentic AI, Non-Human Identities, and Swarm Governance. AI SAFE² + AI Sovereignty Maturity Model (AISM), NEXUS-A2A Protocol, FORGE-Act, Marshal Plan for AI [Dual License: MIT + CC-BY-SA]

What ai-safe2-framework answers

Which agent platforms does it actually have enforcement code for, versus just controls on paper?

the concrete detection and blocking logic ships for Lovable subagent workflows specifically; other platforms get the specification and control mappings but not a matching enforcement package

Does adding this to a project require rewriting how agents call tools or memory?

no, the enforcement is a drop-in workspace knowledge file plus a file-access gate that intercepts path lists before subagents read them, so existing agent code is not restructured

How do I know the control set is actually being enforced and not just documented?

a smoke test runs all named controls and reports a pass count, so you can verify enforcement before relying on it in an environment

Can I get audit evidence for a specific regulation instead of the whole 32-framework map?

yes, at least one paragraph-by-paragraph mapping exists for a named regulation with an attestation document, showing the level of detail to expect if your framework needs the same treatment

How strict is "compliance" here — is it a fixed pass/fail or something I can tune per team?

failure thresholds are set by tier, so a stricter group can fail a run at a much higher score than a team using the baseline tier

all 7 features, with the evidence for each →

Features

7 capabilities · 1 backed by code, an API document or a real run

Built from everything we hold on ai-safe2-framework — every release we have summarised, its product documentation and how that documentation has changed, its README, its command-line surface and API, and runs we performed ourselves. Dates are when we first saw a capability, not when the vendor introduced it.

Capability area
All capabilities 7 capabilities
Lovable agent runtime enforcement shipped Enforces AI SAFE2 trust boundary rules across Lovable agent sessions workspace-wide, covering subagent file access interception, API key and environment variable exfiltration blocking, and a named set of controls verified by a smoke test. 5 releases · first seen Jul 2026

release

  • Ships examples/lovable-sovereign-runtime enforcement package covering a new sixth attack surface, LV-SUBAGENT, missed by the prior five-surface design. 2026-07-18_lovable-sovereign-runtime · Jul 2026 · source · release history
  • Adds workspace-knowledge/ai-safe2-workspace-knowledge.md, a no-code drop-in for Lovable → Settings → Knowledge → Workspace knowledge that applies AI SAFE2 trust boundary rules to every future agent session workspace-wide. 2026-07-18_lovable-sovereign-runtime · Jul 2026 · source · release history
  • Expands detection coverage to block sk-live-* API key format (hyphen in key body), natural-language destructive plan steps ('delete all existing user records'), and Response.json(process.env) (Web API environment variable exfiltration). 2026-07-18_lovable-sovereign-runtime · Jul 2026 · source · release history
  • Enforces 17 named AI SAFE2 v3.0 controls: P1.T1.2, P1.T1.10, P1.T1.4_ADV, P1.T1.1, P1.T2.5, P1.T2.6, S1.3, S1.5, S1.6, P2.T3.1, A2.5, P3.T5.5, P4.T7.1, M4.5, E5.1, CP.4, CP.10, verified at 21/21 smoke-test passing. 2026-07-18_lovable-sovereign-runtime · Jul 2026 · source · release history
  • Adds scan_subagent_file_access() enforcement gate that intercepts file path lists before Lovable subagents read them, blocking access to credential files (e.g. .env.production) by path pattern to close the subagent exfiltration gap. 2026-07-18_lovable-sovereign-runtime · Jul 2026 · source · release history
Compliance report generation verified Generates a compliance report artifact from a scan, with options to suppress console output, show passing controls, and set a failure threshold tier. 4 other sources · first seen Apr 2026

command line

  • --report — Generate compliance report artifact v3.0 · Apr 2026 · command-line history
  • --tier — Failure threshold tier. Tier3=strict (fail <90), Tier2=balanced (fail <70), Tier1=baseline (fail <50) v3.0 · Apr 2026 · command-line history
  • --quiet — Suppress console output (report only) v3.0 · Apr 2026 · command-line history
  • --show-passes — Show controls that passed (for full audit output) v3.0 · Apr 2026 · command-line history
Enforcement smoke testing shipped Runs a full sovereign baseline smoke test to verify that all enforcement controls pass before the runtime is deployed. 2 other sources · first seen Jul 2026

example

  • Apply workspace-wide AI SAFE2 trust boundary rules to every Lovable agent session — no code integration required. In the Lovable console, go to Settings > Knowledge > Workspace knowledge and paste the contents of `workspace-knowledge/ai-safe2-workspace-knowledge.md`. 2026-07-18_lovable-sovereign-runtime · Jul 2026 · source
  • Run the full sovereign baseline smoke test to verify all 21 enforcement controls pass before deploying the runtime in your environment. cd examples/lovable-sovereign-runtime && PYTHONPATH=enforcement python3 smoke_test.py 2026-07-18_lovable-sovereign-runtime · Jul 2026 · source
AI SAFE2 controls system shipped Provides a structured set of controls spanning system-side pillars, human-side Cognitive Sovereignty Framework domains, and cross-domain bridge controls for AI trustworthiness assurance. 2 releases · first seen Jul 2026

release

  • Adds controls/uas-controls-system.md with 27 controls: 14 system-side (pillars P1–P5 and NEXUS), 8 human-side sourced from Cognitive Sovereignty Framework Domains 1–6 (UAS-H1 through UAS-H8), and 5 cross-domain bridge controls. 2026-07-13_Unbiased_AI_Standard_(UAS) · Jul 2026 · source · release history
  • First cross-pillar control to formally integrate the Cognitive Sovereignty Framework (CSF), with CTSS scoring feeding directly into the CP.11 evidence package. 2026-07-13_Unbiased_AI_Standard_(UAS) · Jul 2026 · source · release history
GSAR 552.239-7001 due-diligence evidence package shipped Provides a paragraph-by-paragraph mapping to GSAR 552.239-7001 sections (j)(1) and (f)(7) across five due-diligence documents, including a formal attestation document. 2 releases · first seen Jul 2026

release

  • Adds compliance/gsar-552-239-7001-mapping.md and a five-document due-diligence evidence package mapped paragraph-by-paragraph to GSAR 552.239-7001 sections (j)(1) and (f)(7), including an attestation document at compliance/due-diligence-attestation.md. 2026-07-13_Unbiased_AI_Standard_(UAS) · Jul 2026 · source · release history
  • Adds STANDARD.md (Sections 1–8) as the normative specification for CP.11, covering scope, definitions, requirements, testing, evidence, and independent review criteria. 2026-07-13_Unbiased_AI_Standard_(UAS) · Jul 2026 · source · release history
AI bias taxonomy (UAS-B1–B8) shipped Defines an 8-class bias taxonomy for AI models, each class mapped to a pillar source, CSF domain, and GSAR trigger, including a methodology for detecting foreign-regulator-driven model modifications. 1 release · first seen Jul 2026

release

  • Adds taxonomy/bias-taxonomy.md defining UAS-B1 through UAS-B8 — an 8-class bias taxonomy, each mapped to a pillar source, CSF domain, and GSAR trigger, including UAS-B8 (Foreign Regulatory Embedding) as the first published methodology for detecting model modifications made to satisfy foreign regulators. 2026-07-13_Unbiased_AI_Standard_(UAS) · Jul 2026 · source · release history
Bias testing protocol shipped Specifies eight bias test types with published pass thresholds including a neutrality classification floor, inter-rater agreement minimum, and demographic parity requirement. 1 release · first seen Jul 2026

release

  • Adds testing/bias-test-protocol.md specifying 8 test types with published pass thresholds: 85% neutrality classification floor, Cohen's kappa ≥ 0.7 inter-rater minimum, and p > 0.05 demographic parity requirement across matched framings. 2026-07-13_Unbiased_AI_Standard_(UAS) · Jul 2026 · source · release history
Capability
Evidence

Lines in monospace are the tool's own words — help text parsed from its source, or an endpoint from its API document. Everything else is our summary of a dated release or documentation change, linked back to the source it came from.

Release history

  1. v3.1 Aug 29, 2026 · issue 011

    AI SAFE² v3.1 adds 6 new MCP controls, three enforcement planes, protocol-independent persistence vocabulary, 12 new scanner rules, and a machine-readable manifest entry point for agents and bots.

    └──▷ GET THIS VERSION
    $ git clone --branch v3.1 https://github.com/CyberStrategyInstitute/ai-safe2-framework.git
    # already have the repo? check out this version:
    $ git checkout v3.1
    • Adds ai-safe2.manifest.json and AGENTS.md as first-class machine entry points, exposing framework version, component versions, normative paths, control counts, enforcement planes, persistence vocabulary, conformance boundaries, and machine-readable datasets so agents and compliance bots can consume the framework without scraping prose.
    • Adds skills/mcp/data/mcp-profile-v3.1.json as a machine-readable MCP profile covering all 19 CP.5.MCP controls.
    • Adds skills/mcp/data/ai-safe2-controls-v3.0.json as the 161-control core dataset for automated consumption.
    • Adds six new CP.5.MCP controls: MCP-14 (Extension Capability Negotiation), MCP-15 (Header and Body Assertion Integrity), MCP-16 (State Handle Binding and Lifecycle), MCP-17 (MRTR Round-Trip Integrity and Replay Resistance), MCP-18 (Catalog Cache Integrity and Provenance Revalidation), and MCP-19 (Authorization Chain Integrity, intended-resource/audience binding, and SSRF boundaries), bringing the MCP profile to 19 controls.
    • Formalizes a protocol-independent persistence vocabulary with four canonical values — request, handle_scoped, durable, and swarm_shared — replacing protocol-owned session language at the governance boundary.
    +7 moreshow less
    • Expands the scanner rule registry to 64 rules by adding 12 new grouped CP.5.MCP v3.1 rules covering the new and re-anchored MCP controls.
    • Re-anchors MCP-4, MCP-7, MCP-8, MCP-11, and MCP-13 from protocol session state to framework-owned governance state (verified principals, capability grants, provenance baselines, delegation chains, governed state handles) so controls survive protocol changes such as MCP 2026-07-28.
    • Establishes three explicit enforcement planes — north-south (agent to model provider), east-west (agent to agent), and agent-to-tool (agent to MCP server or tool) — with the rule that a successful control result on one plane does not automatically establish coverage on another.
    • Introduces an explicit MCP-19 conformance boundary: a deployment must evidence intended-resource, audience, or equivalent binding before protected dispatch; opaque bearer-token possession alone does not satisfy the control.
    • Adds MCP 2026-07-28 as the primary binding for CP.5.MCP, with a twelve-month legacy compatibility window for MCP 2025-11-25; server/discover is optional under the primary binding and its absence is not treated as a scanner failure.
    • Scopes the Challenge Lab by enforcement plane — maturity, framework/profile conformance, the plane exercised, and required evidence — adding v3.1 MCP cases covering header/body desynchronization, catalog/schema drift, replay, audience/resource confusion, endpoint impersonation, SSRF, and legacy state-handle misuse.
    • Adds a dedicated Agent Discovery and Manifest Integrity CI gate that verifies manifest claims against the repository, failing on incorrect claims and broken paths.
    └──▷ BREAKING ON UPGRADE
    • !Controls MCP-4, MCP-7, MCP-8, MCP-11, and MCP-13 now bind to framework-owned governance state rather than protocol session state; implementations that anchored those controls to MCP session constructs must be re-implemented against the new bindings.
my-toolchain — 0 tools
paste an install list to detect your tools

A brew list, a Brewfile, requirements.txt, a Dockerfile — or just the product names, free-form. Nothing leaves your browser.

    browse all tools →