packages/verifier-cli/README.md

Parmana CLI Quickstart

Install globally:

npm install -g @parmanasystems/verifier-cli

Create Workspace

Generate a new deterministic governance workspace:

parmana workspace init hello-world

Move into workspace:

cd hello-world

Validate Workspace

Verify workspace structure and governance configuration:

parmana workspace check

Expected output:

WORKSPACE VALID

Explain Workspace

View workspace overview:

parmana workspace explain

Example output:

Workspace Overview

Policies:
- payment-approval v1.0.0

Governed Signals:
- payment.amount (integer)

Examples:
- approve.json
- reject.json

Deterministic Guarantees:
- reproducible evaluation
- governed signal validation
- explainable outcomes
- fail-closed execution

Inspect Policy

View human-readable governance rules:

parmana policy inspect ./policies/payment/v1/policy.json

Visualize Policy

Render governance decision flow:

parmana policy graph ./policies/payment/v1/policy.json

Example output:

payment-approval v1.0.0

START
  |
  |-- payment.amount < 10000
  |      |
  |      --> APPROVE
  |
  --> catch-all
  |      |
  |      --> REJECT
  |              |
  |              --> escalation required

Simulate Governance Decisions

Approve example:

parmana policy simulate ./policies/payment/v1/policy.json ./examples/approve.json

Reject example:

parmana policy simulate ./policies/payment/v1/policy.json ./examples/reject.json

Verify Governance Artifacts

Verify execution artifact:

parmana verify artifact verification.json

Verify signed bundle:

parmana verify bundle bundle.json bundle.sig

Verify release provenance:

parmana provenance verify release-manifest.json release-manifest.rebuilt.json

Build Policy

Build deterministic governance policy:

parmana policy build ./policies/payment/v1

Runtime Inspection

Inspect runtime provenance:

parmana runtime inspect

Parmana Principles

Parmana separates:

• AI recommendation generation from:
• deterministic governance enforcement

This ensures decisions remain:

• reproducible
• explainable
• independently verifiable
• operationally governable