Getting Started

Getting Started

PIC-TS supports Node.js 20 or newer on Linux, Windows, and macOS. Python is not required for normal npm use. Start with a check-only command.

Package Install

npm install percolation-inversion-compiler-ts@1.1.0
npx pic-ts --version
npx pic-ts agent check --compact
npx pic-ts demo bootstrap --output-dir .pic-demo --overwrite
npx pic-ts afst check --case .pic-demo/afst/minimal_accepted.json --compact

Use pic-ts in Node projects. The pic binary is only a compatibility alias and can be confused with the Python CLI.

Source Checkout

Use this path for the full examples/... tree, conformance tests, and release engineering.

git clone https://github.com/kadubon/percolation-inversion-compiler-ts.git
cd percolation-inversion-compiler-ts
npm ci
npm run build
npx pic-ts runtime compare --baseline examples/runtime_acceleration/baseline.json --candidate examples/runtime_acceleration/candidate.json

In an installed project, packaged examples are under node_modules/percolation-inversion-compiler-ts/examples/.... Files generated by bootstrap are under .pic-demo/....

Read The Result

• accepted: finite checks accepted the declared scope.
• operationally_usable: the selected operational profile passed.
• acceleration_metrics_certified: a matched comparison improved without an out-of-tolerance regression.
• settled: every declared obligation is discharged.
• blockers and residual_ledger: unresolved work that remains visible.

Acceptance never grants provider authority or implies settlement. Continue with Acceleration Measurement, Operation Guide, and Security.