Skip to content

v0.5.0 - Phase Ecology Lab for Node.js agents

Choose a tag to compare

View all tags
@kadubon kadubon released this 22 Jun 03:56
· 9 commits to main since this release
v0.5.0
f3c2cc3

percolation-inversion-compiler-ts v0.5.0

This release updates the TypeScript and npm package to follow the public JSON, CLI, schema, conformance, and safety semantics of the canonical Python package percolation-inversion-compiler==0.5.0.

The package is for JavaScript and TypeScript agent runtimes. It helps an agent check local JSON reports, keep unfinished work visible, export and inspect inert packets, and plan the next workflow step without needing Python at runtime.

What is new

  • Added Phase Ecology Lab support for Node.js with a local JSON/JSONL store.
  • Added effective packet graph records for accepted packets, candidate-only packets, blockers, missing evidence, and residual work.
  • Added diagnostic CLI and SDK surfaces for BIT, SQOT, ALT, TRC, and ecology records.
  • Added v0.5.0 schemas, examples, portability fixtures, snapshot fixtures, and audit documentation.
  • Added npm subpath exports for ./phase-lab, ./bit-engine, ./sqot-controller, ./alt-lift, and ./trc-adapter.
  • Strengthened installed-package smoke tests for Windows, macOS, and Linux.

Quick start

npm install percolation-inversion-compiler-ts
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

Use pic-ts for npm and Node.js projects. The pic command is also provided as a compatibility alias, but it can be ambiguous on machines that also install the Python package.

Safety boundary

PIC-TS checks and routes JSON data. It does not execute packet content, shell commands, trace content, or suggested commands. It does not mutate repositories, crawl in the background, or prove real-world truth.

The status fields stay separate:

  • accepted means the input passed the bounded check for that command.
  • workflow_usable means the report can guide a next workflow step.
  • operationally_usable means the runtime result can be used under the selected profile.
  • settled is only true when scoped finite obligations have actually been discharged.

Candidate-only and diagnostic routes keep residual work, blockers, missing obligations, and safety limits visible. They do not grant execution authority.

Compatibility

The canonical implementation remains the Python package:

This TypeScript package is a runtime-facing npm companion. It targets the same public JSON meaning and safety contract, while using a Node-friendly local JSON/JSONL store for Phase Ecology Lab records.

Validation

Before this release, the following checks passed locally and in GitHub Actions:

  • TypeScript type check
  • ESLint
  • Prettier format check
  • Vitest test suite
  • conformance tests
  • npm pack safety scan
  • installed tarball smoke test
  • publint
  • Are The Types Wrong
  • npm audit at high severity
  • cross-OS smoke tests on Ubuntu, Windows, and macOS with Node 20 and 22

This release is intended for npm users and JavaScript agent runtime workflows that need Python-free JSON checking, packet inspection, workflow report generation, and Phase Ecology Lab diagnostics.

Assets 2
Loading