Quickstart

Quickstart

This page gives the shortest safe path to useful output from npm.

Install

npm install percolation-inversion-compiler-ts

For one-off use, run the CLI through npx.

Recommended CLI Name

Use pic-ts for this npm package.

The package also installs pic as a compatibility alias. If the Python package is installed on the same machine, pic may refer to either implementation depending on your PATH. Use pic-ts when you specifically want the Node.js package.

First Node-Only Loop

npx pic-ts demo bootstrap --output-dir .pic-demo --overwrite
npx pic-ts runtime step --state .pic-demo/runtime_state.json --input .pic-demo/runtime_step_input.json --output .pic-demo/runtime_step_report.generated.json
npx pic-ts packet export --report .pic-demo/runtime_step_report.generated.json --output .pic-demo/packet.json
npx pic-ts packet inspect --packet .pic-demo/packet.json
npx pic-ts phase plan --request .pic-demo/asi_proxy_phase_request.json --compact

This works without Python. It creates a runtime report, exports it as packet data, inspects the packet without running embedded text, and returns a phase plan.

First Agent Check

npx pic-ts agent check --compact --text "Candidate packet: preserve residuals." --profile development
npx pic-ts agent accelerate --compact --text "Candidate packet: preserve residuals." --profile development

First Phase Ecology Lab Check

npx pic-ts phase lab init --output-dir .pic-lab
npx pic-ts phase lab ingest --store .pic-lab --report .pic-demo/runtime_step_report.generated.json
npx pic-ts phase lab observe --store .pic-lab
npx pic-ts phase lab graph --store .pic-lab

The lab records accepted packets, candidate-only data, residual work, and blocked execution paths. It does not execute packet content.

Read These Fields First

• accepted
• workflow_usable
• operationally_usable
• settled
• missing_obligations
• residual_ledger
• candidate_only_reasons
• settled_blockers

settled=false is not a command failure. It means unfinished work is still visible.

Next Pages

• Getting Started
• Node Only Agent Loop
• Phase Ecology Lab
• How To Read The JSON
• CLI Recipes