@parmanasystems/contracts

Shared data interfaces for cross-package governance contracts. This package contains the canonical TypeScript types for execution integrity proofs, decision outcomes, and governed execution requests. It has no runtime logic — it is a pure type boundary that keeps @parmanasystems/execution and @parmanasystems/execution-runtime from depending on each other's internal shapes.

Public API

/** A real-world action that was executed under governance authorization. */
interface ExecutedAction {
  type: string;
  payload: Record<string, unknown>;
  executedAt: string;      // ISO-8601
  executedBy?: string;
}

/** Structural match details produced by confirmExecution(). */
interface MatchDetails {
  actionTypeMatch: boolean;
  payloadConsistent: boolean;
  withinTimeWindow: boolean;
  timeWindowSeconds: number;
}

/**
 * Cryptographic proof that a real-world execution matched its governance authorization.
 * Produced by confirmExecution() and POST /confirm-execution.
 */
interface ExecutionIntegrityProof {
  executionId: string;
  authorizationId: string;
  integrityHash: string;
  authorized: {
    action: string;
    reason: string;
    policyId: string;
    policyVersion: string;
  };
  executed: ExecutedAction;
  match: boolean;
  matchDetails: MatchDetails;
  signature: string;
  confirmedAt: string;
  verified: true;
}

/** The policy decision embedded in every ExecutionToken and ExecutionAttestation. */
interface DecisionOutcome {
  action: "approve" | "reject";
  requires_override: boolean;
  reason?: string;
}

/** The result returned by evaluatePolicy(). */
interface DecisionResult {
  status: "decided";
  outcome: DecisionOutcome;
  rule_id: string;
  source: "rule_match";
}

/** A governed execution request sent to the runtime. */
interface GovernedExecutionRequest { /* see execution-request.js */ }

/** A recorded governed execution, including the attestation. */
interface GovernedExecutionRecord { /* see execution-request.js */ }

Environment variables

None.

Package wiring

@parmanasystems/contracts has no internal @parmanasystems dependencies. It is imported by @parmanasystems/execution (which re-exports ExecutedAction, ExecutionIntegrityProof, MatchDetails) and by @parmanasystems/execution-runtime (which re-exports the same set). @parmanasystems/core re-exports DecisionResult and DecisionOutcome.