Skip to content

percolation-inversion-compiler-ts v0.4.4

Choose a tag to compare

View all tags
@kadubon kadubon released this 21 Jun 15:06
· 12 commits to main since this release
v0.4.4
c279972

What this is

percolation-inversion-compiler-ts is the npm / Node.js version of percolation-inversion-compiler v0.4.4. It helps AI agent runtimes check agent output, produce structured JSON reports, keep unfinished verification work visible, and route the next safe workflow step.

The Python package remains the canonical implementation:

Install

Use it from npm with Node.js 20 or newer:

npm install percolation-inversion-compiler-ts
npx pic-ts agent check --compact

The package also provides a pic bin for CLI compatibility with the Python package name, and pic-ts as the recommended npm-specific command name.

What you can do with it

  • Run pic-ts agent check --compact to inspect agent output.
  • Run pic-ts runtime step with local JSON state/input files.
  • Export and inspect packet sidecars with pic-ts packet export and pic-ts packet inspect.
  • Build workflow repair plans with pic-ts phase plan --compact.
  • Import the SDK from JavaScript or TypeScript, including ./schema, ./agent/messages, and ./packet subpaths.

Safety model

This release separates accepted, workflow_usable, operationally_usable, and settled. A report can be useful for a workflow while still keeping settled=false and listing missing obligations. The package does not execute arbitrary shell commands, mutate repositories, crawl in the background, or promote candidate data into completed work.

Compatibility

This TypeScript package targets Python percolation-inversion-compiler==0.4.4 public behavior for CLI JSON, schemas, conformance fixtures, status semantics, residual ledgers, obligations, phase planner output, and safety boundaries. Python-only heavy routes are exposed as fail-closed diagnostic compatibility routes.

Validation

Before this release, the repository passed:

  • local typecheck, lint, format, tests, conformance, pack safety, installed smoke, publint, Are The Types Wrong, npm audit, prepack, and prepublishOnly
  • GitHub Actions CI on Node 20 and Node 22
  • cross-OS installed smoke on Ubuntu, Windows, and macOS
  • npm registry install smoke for version 0.4.4
Assets 2
Loading