Japanese Quick Summary

日本語クイック概要

percolation-inversion-compiler-ts は、Node.js と npm で使える AI エージェント出力チェッカーです。

エージェントの文章、ローカルの実行ステップ、メッセージ、packet JSON を読み取り、次のようなことを JSON レポートとして返します。

• その入力が checker に受け入れられたか。
• ワークフローの次の一手に使えるか。
• まだ不足している証拠や検証作業は何か。
• 未解決の作業をどこに残すべきか。
• 完了扱いにしてはいけない理由は何か。
• CCR などの runtime に渡せる task/residual JSONL は何か。
• TRC trace が operation candidate としてレビュー可能な構造を持つか。

現在の npm release は v0.6.0 です。Python 版 percolation-inversion-compiler==0.6.0 の公開 JSON、CLI、schema、安全境界、CCR interop、TRC operation-readiness の意味に合わせています。

最短コマンド

npm install percolation-inversion-compiler-ts
npx pic-ts agent check --compact --text "Candidate packet: preserve residuals." --profile development
npx pic-ts phase plan --compact --emit ccr-tasks --output tasks.jsonl
npx pic-ts phase gap --compact --emit ccr-residuals --output residuals.jsonl

Node.js 版では pic-ts を推奨します。pic も互換 alias として入っていますが、Python 版 CLI と同じ名前なので混同しやすいです。

JSON の読み方

• accepted: 入力の形が checker に受け入れられた。
• workflow_usable: 次の作業判断に使える。
• operationally_usable: 指定した profile のもとで運用上の判断に使える。
• settled: 限定された検証義務が完了している。
• operation_ready: TRC trace に、限定された operation candidate のための authority、resource、rollback、witness、schedule、tolerance などがそろっている。
• missing_obligations: まだ不足している検証作業。
• residual_ledger: 消してはいけない未解決作業の記録。
• candidate_only_until_checked: downstream runtime 側でまだ検証が必要。

accepted=true や workflow_usable=true は、完了を意味しません。多くの実用的なレポートでは settled=false が正常です。

operation_ready=true も実行済みを意味しません。あくまで trace がレビュー可能な候補として構造化されている、という意味です。

安全境界

この npm package は、コマンド実行、リポジトリ変更、外部送信、支払い、クラウド操作、モデル変更を許可しません。

packet 内に npm install、docker run、kubectl のような文字列があっても、検出して報告するだけで実行しません。

PIC-TS が出す CCR task JSONL では、constraints.allowed_commands=[] が基本です。command hint は review 用のデータであり、実行許可ではありません。

Python 版との関係

Python 版が canonical implementation です。

• Python repository: https://github.com/kadubon/percolation-inversion-compiler
• Python wiki: https://github.com/kadubon/percolation-inversion-compiler/wiki

この TypeScript 版は、npm と Node.js のエージェント実行環境向けに、公開 JSON、CLI、schema、conformance、安全境界を互換実装したものです。