@parmanasystems/server

Fastify REST API server for Parmana Systems governed execution.

Overview

@parmanasystems/server is the production REST API server for the Parmana Systems governance runtime. It exposes HTTP endpoints for governed execution, attestation verification, runtime inspection, and audit queries. The server uses Fastify with optional PostgreSQL audit persistence and supports Docker deployment.

Install

npm install @parmanasystems/server

Running

# Start directly
node dist/index.js

# With environment configuration
PORT=3000 HOST=0.0.0.0 DATABASE_URL=postgres://... node dist/index.js

Docker

FROM node:20-alpine
WORKDIR /app
COPY . .
RUN npm ci --workspace=packages/server --include-workspace-root
EXPOSE 3000
CMD ["node", "packages/server/dist/index.js"]

Environment variables

Variable	Default	Description
`PORT`	`3000`	TCP port to listen on
`HOST`	`0.0.0.0`	Bind address
`DATABASE_URL`	-	PostgreSQL connection string; omit to disable audit persistence
`SIGNING_KEY_PATH`	`trust/root.key`	Path to Ed25519 private key PEM

API endpoints

Method	Path	Description
`POST`	`/execute`	Execute a governed decision and return a signed `ExecutionAttestation`
`POST`	`/verify`	Verify an `ExecutionAttestation` without runtime access
`GET`	`/runtime`	Return current runtime manifest and version
`GET`	`/health`	Liveness check

Full OpenAPI schema: see openapi.json at the repository root.

Programmatic usage

import { startServer, app } from "@parmanasystems/server";

await startServer();
// Server is now listening

Documentation

Full docs: parmanasystems.mintlify.app Package page: parmanasystems.mintlify.app/packages/server

License

Apache-2.0