@parmanasystems/provenance
v1.98.43
Published
Signal provenance types and verification for Parmana Systems
Readme
Parmana Systems
Deterministic governance infrastructure for high-consequence execution systems.
AI may recommend.
Parmana determines whether execution is allowed.Why Parmana Exists
Modern AI systems are increasingly capable of making recommendations, triggering workflows, and initiating actions.
However, most systems still struggle to answer critical governance questions:
- Why was an action executed?
- Was execution authorized?
- Which evidence existed at decision time?
- Can the decision be reproduced independently?
- Can auditors verify governance continuity?
- Can replay reconstruction reproduce the same result?
- Can governance survive outside the runtime?
Traditional workflow systems often depend heavily on:
- mutable runtime state
- operational trust
- unverifiable execution history
- centralized infrastructure
- nondeterministic behavior
Parmana exists to provide:
deterministic governance integritythrough:
- append-only lineage
- deterministic replay
- portable verification
- cryptographic continuity
- replay-safe execution
- independent auditability
Core Principle
Parmana intentionally separates:
probabilistic evaluationfrom:
deterministic governance enforcementAI systems may:
- classify
- summarize
- predict
- recommend
- extract signals
Parmana determines whether execution is allowed.
This separation preserves:
- reproducibility
- replay continuity
- auditability
- independent verification
- operational defensibility
What Parmana Does
Parmana governs:
- admissibility
- authorization continuity
- deterministic execution
- replay reconstruction
- append-only lineage
- execution authority
- fail-closed enforcement
- audit continuity
- cryptographic verification
- portable governance proofs
Parmana provides deterministic governance infrastructure around execution systems.
What Parmana Does NOT Do
Parmana does NOT:
- perform AI inference
- determine objective truth
- replace human judgment
- guarantee external reality
- validate medical correctness
- validate financial correctness
- eliminate all operational trust
- replace cybersecurity infrastructure
Parmana verifies:
governance integritynot:
objective realityArchitecture Overview
Parmana architecture includes:
- Signal Layer
- Governance Layer
- Execution Layer
- Provenance Layer
- Replay Layer
- Verification Layer
- Audit Layer
- Persistence Layer
Core architectural properties:
- deterministic execution
- append-only lineage
- replay-safe semantics
- portable verification
- cryptographic continuity
- independent verification
Portable Verification
Portable verification is a foundational Parmana capability.
Governance evidence remains independently verifiable outside the original runtime environment.
Verification requires only:
- governance proof bundle
- trust-root public key
- deterministic verifier
Verification does NOT require:
- application servers
- runtime APIs
- cloud infrastructure
- operational databases
- runtime operators
This enables:
- regulator audits
- third-party verification
- long-term archival validation
- infrastructure-independent trust
Governance vs Truth
One of the most important Parmana principles is:
governance integrity
!=
objective realityParmana can prove:
- deterministic authorization continuity
- admissibility enforcement
- replay integrity
- append-only lineage continuity
- cryptographic consistency
Parmana cannot prove:
- whether a bank balance is objectively correct
- whether an AI hallucinated
- whether a medical diagnosis is factually accurate
- whether external systems are truthful
This boundary is intentional.
Deterministic Replay
Replay reconstruction is central to Parmana.
The same lineage must always reconstruct the same governance state.
Replay determinism enables:
- reproducibility
- independent verification
- audit continuity
- regulator validation
- portable trust proofs
Nondeterministic governance invalidates replay integrity.
Append-Only Lineage
Governance history is append-only.
Lineage events describe:
- authorization
- execution
- reconciliation
- provenance
- escalation
- governance state transitions
Historical mutation invalidates cryptographic continuity.
This provides:
- tamper evidence
- historical continuity
- replay reconstruction
- audit traceability
Independent Verification
Parmana verification intentionally minimizes runtime trust.
Independent verifiers validate:
- signatures
- manifest hashes
- replay integrity
- lineage continuity
- governance invariants
directly from portable governance artifacts.
Verification survives independently from runtime infrastructure.
Example Use Cases
Parmana is designed for systems where execution integrity matters.
Examples include:
- healthcare triage governance
- insurance authorization workflows
- financial approval systems
- AI voice agent escalation
- enterprise approval chains
- compliance workflows
- security operations governance
- regulated automation systems
Parmana is especially valuable when organizations must later prove:
- why execution occurred
- who authorized it
- which evidence existed
- whether governance policy was followed
- whether replay reconstruction succeeds
Quick Example
const lineage = [
createLineageEvent({
type: "authorization",
payload: {
approved: true,
},
previousHash: null,
}),
];
const replay =
replayLineage(
lineage,
);
const bundle =
createGovernanceProofBundle(
{
lineage,
replay,
privateKey,
keyId: "root-1",
},
);
const result =
verifyGovernanceProof(
{
bundle,
publicKey,
},
);Portable governance verification now succeeds independently from the original runtime environment.
Packages
Core ecosystem packages include:
@parmanasystems/core@parmanasystems/execution@parmanasystems/governance@parmanasystems/provenance@parmanasystems/crypto@parmanasystems/verifier@parmanasystems/verifier-cli@parmanasystems/server@parmanasystems/sdk-client@parmanasystems/audit-db
Deterministic Guarantees
Parmana is designed around explicit deterministic guarantees:
- same governance input → same governance output
- replay reconstruction remains reproducible
- lineage remains append-only
- verification remains portable
- governance evidence remains tamper-evident
- execution authority remains replay-safe
These guarantees enable reproducible governance integrity.
Threat Model
Parmana is specifically designed to mitigate:
- governance tampering
- replay attacks
- audit mutation
- unverifiable authorization
- mutable operational evidence
- nondeterministic governance execution
through:
- append-only lineage
- deterministic replay
- cryptographic verification
- portable governance proofs
- independent verification
Parmana intentionally does not attempt to solve universal cybersecurity or objective truth determination.
Documentation
Core documentation includes:
docs/architecture.mddocs/principles.mddocs/trust-model.mddocs/threat-model.mddocs/portable-verification.mddocs/governance-vs-truth.mddocs/use-cases.mddocs/faq.md
Current Status
Parmana currently includes operational support for:
- deterministic replay reconstruction
- append-only lineage
- execution authority
- replay-safe consumption
- portable proof bundles
- independent verification
- audit reconstruction
- provenance lineage
- admissibility enforcement
- fail-closed governance
- cryptographic signing
- Redis-backed consumption stores
- PostgreSQL lineage persistence
Philosophy
Parmana follows this operational philosophy:
minimize trust.
make assumptions explicit.
cryptographically verify everything possible.License
Apache-2.0 License.
Runtime Requirements
Parmana Systems packages are ESM-only.
Requirements:
- Node.js >= 20.19
- Native ES module support
Example:
` s import { verifyDecision } from "@parmanasystems/verifier";
