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.

First CCR Handoff

npx pic-ts phase plan --request .pic-demo/asi_proxy_phase_request.json --compact --emit ccr-tasks --output tasks.jsonl
npx pic-ts phase gap --request .pic-demo/asi_proxy_phase_request.json --compact --emit ccr-residuals --output residuals.jsonl

The JSONL files are candidate handoff records for Collective Capability Runtime or another scheduler. They do not authorize command execution.

First TRC Operation Candidate Check

From a repository checkout, or from packaged examples under node_modules/percolation-inversion-compiler-ts/examples:

npx pic-ts trc trace-normalize --input examples/asi_proxy_benchmark_bundle/trc_agent_trace.json --output trace_nf.json
npx pic-ts trc trace-check --trace trace_nf.json --output trace_check.json
npx pic-ts trc trace-to-packet --trace trace_nf.json --output trace_packet.json

operation_ready=true means the scoped trace declares authority, resources, rollback or escrow, witnesses, schedule, and tolerance data. It still does not mean the action was executed or settled.

Read These Fields First

• accepted
• workflow_usable
• operationally_usable
• operation_ready
• settled
• missing_obligations
• residual_ledger
• candidate_only_reasons
• candidate_only_until_checked
• 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
• CCR Interop
• ASI Proxy Acceleration
• How To Read The JSON
• CLI Recipes