Skip to main content
PALOPALO FRAMEWORK

Start and adoption | Public documentation

PALO Data Assurance Control Plane

LevelreferenceAudiencegovernance | executive | technicalProductPALO CoreStatusCurrent GuidanceLifecycleCurrentRead6 min

Published HTML view | Source: docs/palo-data-assurance-control-plane.md

On this page
  1. Outcome
  2. Implemented areas
  3. 1. Context Bridge and external evidence references
  4. 2. Deterministic Data Fitness Gate
  5. 3. Data Disclosure/Egress Contract
  6. 4. Action Claim 1.4 and disclosure verification
  7. 5. AI System & Agent Registry
  8. 6. Continuous Assurance Loop
  9. MCP surface
  10. Compliance logic
  11. Security and maturity boundary
  12. Verification

PALO Data Assurance Control Plane#

Assessment addendum, 17 September 2026: this document describes the published runtime or its production target. A separate unreleased swarm snapshot adds central coordination of remote workers, shared exposure, membership revisions and supported cancellation. It does not provide controller HA or qualify the published runtime. See the dated evidence and version boundaries.

Status: PALO-AI v2.7 developer preview. This is an executable reference implementation for isolated testing, not a production authorization boundary, legal determination or compliance certification.

Outcome#

PALO-AI v2.7 implements the first end-to-end form of the product thesis:

PALO decides what an identified agent may do with current, purpose-fit data and produces signed evidence of the information disclosure and authoritative effect that actually followed.

The new cycle is:

text code
external catalog / observability / source evidence
                       |
                       v
           immutable Context Evidence
                       |
                       v
       purpose-bound Data Fitness Decision
                       |
                       v
       signed Data Disclosure Contract
                       |
                       v
     Action Claim 1.4 + policy + approval
                       |
                       v
 one-time capability + governed executor
                       |
                       v
 Execution Receipt + Disclosure Receipt
                       |
                       v
 authoritative outcome / held incident
                       ^
                       |
       continuous assurance invalidation

Implemented areas#

1. Context Bridge and external evidence references#

palo-external-evidence-ref is an immutable, payload-minimized contract. It records:

  • external system, object identifier, version and URI;
  • subject and tenant;
  • normalized quality, freshness, classification, ownership, approval, access, lineage, purpose, lifecycle and incident claims;
  • source authority and read-only connector provenance;
  • observation/expiry timestamps;
  • digest of the source payload.

The source payload is not persisted in the reference. mapActianContextSnapshot in packages/palo-mcp-server/data-assurance.js is the first normalization profile. It maps an Actian asset snapshot into the generic evidence contract and deliberately discards sample rows. It is not an authenticated Actian API client; credentials, pagination, connector assurance and source-specific API calls remain operator responsibilities.

2. Deterministic Data Fitness Gate#

palo-data-fitness-policy defines minimum evidence types and requirements for one tenant and subject type. The evaluator supports:

  • minimum quality score;
  • maximum evidence age;
  • verified source authority;
  • accountable owner and approval;
  • lineage completeness;
  • source access state;
  • open incident denial;
  • prohibited classifications;
  • policy and source-permitted purposes;
  • explicit deny or review handling for missing evidence.

The resulting palo-data-fitness-decision is immutable and binds the exact policy version, purpose, subject, evidence references, normalized-claim digest and expiry. Missing evidence never silently passes. Conflicting current assertions are evaluated conservatively: a lower quality score, denied access, missing approval or incompatible source-purpose constraint causes denial rather than being masked by a more favorable assertion. The maximum evidence-age rule applies to the oldest current reference, and decision expiry is capped at both source validity and each reference's observedAt + maxEvidenceAgeSeconds boundary.

3. Data Disclosure/Egress Contract#

palo-data-disclosure-contract is signed and bound to the exact digest of an allowed Data Fitness Decision. It governs:

  • source identifiers, fields and maximum rows read;
  • zero-row, aggregated or row-level egress;
  • egress fields and row limit;
  • prohibited sensitive categories and required redactions;
  • recipient, provider, model, region and endpoint host;
  • tracing mode and maximum retention;
  • export and output schema;
  • purpose, lawful-basis classification, accountable approver and expiry.

An active contract cannot use pending-review as lawful basis, must name an approver, must include its subject in sourceRefs, cannot predate or outlive the bound fitness decision and must be current when registered and used. A disclosure observation outside that signed time window, or dated before the governed execution started, is a mismatch.

4. Action Claim 1.4 and disclosure verification#

Action Claim 1.4 requires:

  • identity-bound Authority Context from 1.3;
  • Effect Contract;
  • exact Data Fitness Decision ID/digest;
  • exact Data Disclosure Contract ID/digest;
  • subject and purpose.

The runtime validates these bindings before policy evaluation and again before issuing a capability. A continuous-assurance invalidation, expiry, signature failure, digest mismatch, cross-tenant substitution or changed purpose denies execution.

The trusted executor supplies a palo-data-disclosure-observation containing metadata only: actual sources, fields and row counts, sensitive categories, redactions, destination, tracing, retention, export and payload/query digests. It must not include row values.

PALO emits a signed palo-data-disclosure-receipt and binds its digest into Execution Receipt 1.1. Action Claim 1.4 executor result payloads are not persisted; the runtime stores only a digest, a payloadStored: false marker and the disclosure receipt identifier.

If disclosure and contract differ, the authoritative attestation becomes mismatch, a high-severity incident opens and the governed resource is held. A missing or malformed trusted observation is inconclusive, never verified.

5. AI System & Agent Registry#

palo-ai-system-record versions the minimum AI inventory needed by the assurance layer:

  • system, tenant, use case and deployed version;
  • lifecycle status, risk class and jurisdictions;
  • accountable owners;
  • model, agent, tool, data-subject and provider relationships;
  • policy-bundle digest and evidence references.

It is intentionally not a general enterprise data catalog. External catalogs remain the metadata source; PALO records the AI/action graph needed for governance and assurance.

6. Continuous Assurance Loop#

palo-assurance-signal represents quality, classification, lineage, access, contract, incident, system-release or policy-release changes. Ingestion:

  1. stores the signal immutably;
  2. invalidates prior allowed Data Fitness Decisions for the tenant/subject;
  3. revokes matching one-time capabilities that have been issued but not consumed;
  4. emits bounded telemetry;
  5. causes later Action Claim 1.4 evaluation to fail closed until fitness and disclosure are refreshed.

The prototype does not yet reopen a completed historical gate in an enterprise case-management service or deliver ServiceNow/Jira notifications.

MCP surface#

The v2.7 server adds:

text code
palo_import_context_evidence
palo_list_context_evidence
palo_register_data_fitness_policy
palo_evaluate_data_fitness
palo_get_data_fitness_decision
palo_register_disclosure_contract
palo_get_disclosure_contract
palo_register_ai_system
palo_get_ai_system
palo_list_ai_systems
palo_ingest_assurance_signal
palo_list_assurance_signals

Existing palo_verify_action_authority, palo_execute_governed_action, palo_get_execution_status, palo_verify_outcome, incident, ledger and operational-snapshot tools incorporate the new cycle. OIDC requests bind data-assurance tenant inputs, registries, execution reads and incident operations to the authenticated token tenant. Import, policy, contract, registry and signal mutations require palo:admin; fitness evaluation requires palo:execute; signal inspection requires palo:audit; the remaining reads require palo:read.

Compliance logic#

These contracts operationalize evidence relevant to:

  • purpose limitation and data minimization;
  • lawful-basis classification and accountable review;
  • sensitive-data and transfer/region restrictions;
  • processor/provider/model and recipient constraints;
  • trace and retention limits;
  • access state and source authority;
  • AI system inventory, ownership and risk class;
  • continuous monitoring, incident and change response.

They do not constitute a RoPA, DPIA, DSAR, transfer-impact assessment, DPA, conformity assessment or legal determination. Organization-owned workflows must supply those decisions and bind them as evidence.

Security and maturity boundary#

The reference runtime remains SQLite, single-instance and in-process. HMAC signing material enters the application process. The Actian mapper is not remotely attested and cannot prove that the source API returned complete or truthful metadata. A trusted executor observation proves only what that in-process executor reported and caused PALO to sign; non-bypassability requires a separately isolated, allowlisted or remotely attested connector boundary. Plain SHA-256 payload and query digests provide integrity binding, not anonymity; production designs should assess equality/linkability and use organization-controlled keyed commitments where low-entropy sensitive inputs make offline guessing credible.

The production-admission contract therefore continues to deny the bundled runtime. Multi-tenant storage isolation, PostgreSQL/HA, distributed work, KMS/HSM custody, independently assessed remote connectors, SIEM/retention/legal hold and external ledger anchoring remain required production work.

Verification#

Run:

bash code
npm run validate:agentic

The data-assurance test suite covers:

  • Actian payload minimization and allowed fitness evaluation;
  • conservative denial for conflicting current source assertions;
  • conservative evidence freshness and decision-expiry capping;
  • Action Claim 1.4 binding and negative authority-context validation;
  • signed zero-row disclosure receipt;
  • signed disclosure-window enforcement;
  • non-persistence of executor row payloads, including receipt-generation failure;
  • row, field, provider and region mismatch incidents;
  • replayed pre-execution disclosure-observation denial;
  • assurance-signal invalidation;
  • revocation of unconsumed capabilities;
  • same-claim stale-cache denial;
  • OIDC cross-tenant MCP denial;
  • tenant-safe legacy incident listing.