@mzwing/pi-permission-auto-review 0.3.2 → 0.4.0

package/README.md

@@ -35,9 +35,9 @@ pi install npm:@gotgenes/pi-permission-system # dependency
 pi install npm:@mzwing/pi-permission-auto-review
 ```
 
-Pi 0.84.2+ (0.84.x and 0.85.x) and `@gotgenes/pi-permission-system` 27.x, 28.x, 29.x, or 30.x are required.
+Pi 0.84.2+ (0.84.x and 0.85.x) and `@gotgenes/pi-permission-system` 27.x - 32.x are required.
 
-The authorizer registers itself against the service keyed by its own session id, so a subagent's reviewer lands in the node whose gates actually read it.
+The authorizer registers itself against the service keyed by its own session id, so a subagent's reviewer lands in its own node. A node that relays its asks to a live parent session runs no chain of its own, and the parent session's reviewer decides for it.
 
 ## Enable
 
@@ -135,6 +135,26 @@ Each `auto_review.decision` emitted after transcript construction adds content-f
 
 These fields distinguish missing or truncated authorization evidence from a model decision made after receiving trusted evidence. Transcript text and model rationale are not persisted. The records are written through pi-permission-system's existing permission-review log when that log is enabled.
 
+## Programmatic use
+
+`@mzwing/pi-permission-auto-review/review` exposes the evidence, prompt, and verdict pipeline the live reviewer runs, for tools that test the classifier outside a Pi session.
+
+```ts
+import {
+  buildReviewPrompt,
+  DEFAULT_CONFIG,
+  parseReviewAssessment,
+  renderTranscript,
+} from '@mzwing/pi-permission-auto-review/review'
+
+const prompt = buildReviewPrompt(DEFAULT_CONFIG, renderTranscript(sessionEntries), details)
+const assessment = parseReviewAssessment(modelReply)
+```
+
+`details` is a `PromptPermissionDetails` from `@gotgenes/pi-permission-system`. The subpath needs no Pi peer dependency at runtime.
+
+`buildSystemPrompt`, `FIXED_REVIEW_PROTOCOL`, and `POLICY_REVISION` are exported alongside them. Prompt text tracks the bundled Guardian policy and changes with `POLICY_REVISION`; assert on that rather than on exact wording.
+
 ## License
 
 [MIT](LICENSE)

package/dist/index.d.ts

@@ -1,6 +1,5 @@
 import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 //#region src/index.d.ts
-declare function permissionAutoReviewExtension(pi: ExtensionAPI): void;
+export default function permissionAutoReviewExtension(pi: ExtensionAPI): void;
 //#endregion
-export { permissionAutoReviewExtension as default };
 //# sourceMappingURL=index.d.ts.map