Skip to main content
The parmana monorepo’s core runtime is split into eight focused packages under packages/. Each has a single, well-defined responsibility, and dependencies flow in one direction — shared has no internal dependencies, while api depends on nearly everything else as the composition root. 
                shared
                  |
   +------+-------+-------+-------+
   v      v       v       v       v
crypto  policy  storage  replay  verification
   |      |       |       |       |
   +------+-------+-------+-------+
                  v
               runtime
                  |
                  v
                 api

​
Package responsibilities

PackageResponsibility
sharedCanonical domain model, repository contracts, immutable trust artifacts.
runtimeApplication workflow, runtime orchestration, the execution pipeline, ExecutionTrustApplication.
storageRepository implementations — in-memory today, with PostgreSQL/Supabase and other cloud adapters as the storage-agnostic design allows.
cryptoCanonical serialization, hashing, digital signatures, receipt generation.
replayReplay verification, deterministic validation, execution comparison.
verificationVerification engines, evidence validation, compliance verification.
policyPolicy evaluation, decision generation, business rule execution.
apiREST interface, authentication, HTTP transport, application composition root.

​
Why this split

Each package maps directly onto one stage of the canonical trust model: policy produces Decisions, runtime orchestrates Execution, verification produces Verifications, crypto produces Receipts, and replay re-derives outcomes independently of the original run. No package reaches into another’s internals — they interact only through the contracts defined in shared.

​
SDK and language surfaces

Outside packages/, the monorepo also has:
  • typescript/ — the published TypeScript SDK (@parmana/sdk), a thin client over the REST API. See TypeScript SDK.
  • python/ — the Python SDK, mirroring the TypeScript SDK’s API surface. See Python SDK.