@nklisch/pi-enhanced 0.1.3 → 0.1.4

package/node_modules/@nklisch/pi-clearance/src/contracts/QuoteKind.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 
 export type QuoteKind = "none" | "single" | "double" | "mixed";

package/node_modules/@nklisch/pi-clearance/src/contracts/Redirect.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 import type { RedirectStream } from "./RedirectStream.ts";
 import type { RedirectTargetKind } from "./RedirectTargetKind.ts";

package/node_modules/@nklisch/pi-clearance/src/contracts/RedirectStream.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 
 export type RedirectStream = "stdout" | "stderr" | "stdin" | "fd" | "both";

package/node_modules/@nklisch/pi-clearance/src/contracts/RedirectTargetKind.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 
 export type RedirectTargetKind = "file" | "fd" | "heredoc" | "herestring";

package/node_modules/@nklisch/pi-clearance/src/contracts/ReplayCorpus.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 import type { CorpusEntry } from "./CorpusEntry.ts";
 import type { CountByLabel } from "./CountByLabel.ts";

package/node_modules/@nklisch/pi-clearance/src/contracts/ReplayDelta.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 import type { CorpusQuerySummarySnapshot } from "./CorpusQuerySummarySnapshot.ts";
 import type { ProposalNotRunReason } from "./ProposalNotRunReason.ts";

package/node_modules/@nklisch/pi-clearance/src/contracts/ReplayDeltaBlockedSummary.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 
 export type ReplayDeltaBlockedSummary = {

package/node_modules/@nklisch/pi-clearance/src/contracts/ReplayDeltaChangedRecord.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 import type { CorpusFidelity } from "./CorpusFidelity.ts";
 import type { ReplayStatus } from "./ReplayStatus.ts";

package/node_modules/@nklisch/pi-clearance/src/contracts/ReplayDeltaFamily.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 import type { CountByLabel } from "./CountByLabel.ts";
 import type { ReplayDeltaRegression } from "./ReplayDeltaRegression.ts";

package/node_modules/@nklisch/pi-clearance/src/contracts/ReplayDeltaImprovement.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 
 export type ReplayDeltaImprovement = {

package/node_modules/@nklisch/pi-clearance/src/contracts/ReplayDeltaRegression.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 
 export type ReplayDeltaRegression = {

package/node_modules/@nklisch/pi-clearance/src/contracts/ReplayDeltaStatus.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 
 export type ReplayDeltaStatus = "not-run" | "passed" | "regression";

package/node_modules/@nklisch/pi-clearance/src/contracts/ReplayDeltaTransitionCount.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 
 export type ReplayDeltaTransitionCount = {

package/node_modules/@nklisch/pi-clearance/src/contracts/ReplayPathFacts.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 import type { BashPathFacts } from "./BashPathFacts.ts";
 import type { ToolPathFacts } from "./ToolPathFacts.ts";

package/node_modules/@nklisch/pi-clearance/src/contracts/ReplayReviewerMode.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 
 export type ReplayReviewerMode =

package/node_modules/@nklisch/pi-clearance/src/contracts/ReplayReviewerOutcome.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 import type { DecisionEffect } from "./DecisionEffect.ts";
 import type { ReplayReviewerMode } from "./ReplayReviewerMode.ts";

package/node_modules/@nklisch/pi-clearance/src/contracts/ReplayStatus.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 
 export type ReplayStatus = "fast_path" | "review" | "hard_block";

package/node_modules/@nklisch/pi-clearance/src/contracts/ReplayedDecision.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 import type { Decision } from "./Decision.ts";
 import type { DecisionProvenance } from "./DecisionProvenance.ts";

package/node_modules/@nklisch/pi-clearance/src/contracts/ShapeDiagnostic.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 import type { DiagnosticSeverity } from "./DiagnosticSeverity.ts";
 import type { SourceSpan } from "./SourceSpan.ts";

package/node_modules/@nklisch/pi-clearance/src/contracts/SourceFidelity.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 import type { CorpusFidelity } from "./CorpusFidelity.ts";
 import type { CorpusSource } from "./CorpusSource.ts";

package/node_modules/@nklisch/pi-clearance/src/contracts/SourceSpan.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 
 export type SourceSpan = { start: number; end: number };

package/node_modules/@nklisch/pi-clearance/src/contracts/Substitution.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 import type { SourceSpan } from "./SourceSpan.ts";
 import type { SubstitutionKind } from "./SubstitutionKind.ts";

package/node_modules/@nklisch/pi-clearance/src/contracts/SubstitutionKind.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 
 export type SubstitutionKind = "command" | "process" | "arithmetic";

package/node_modules/@nklisch/pi-clearance/src/contracts/ToolCallIdentity.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 
 export type ToolCallIdentity = {

package/node_modules/@nklisch/pi-clearance/src/contracts/ToolPathAccess.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 
 export type ToolPathAccess = "read" | "write" | "create";

package/node_modules/@nklisch/pi-clearance/src/contracts/ToolPathFact.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 import type { PathNormalization } from "./PathNormalization.ts";
 import type { PathScope } from "./PathScope.ts";

package/node_modules/@nklisch/pi-clearance/src/contracts/ToolPathFactContext.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 import type { PathFactProjectScope } from "./PathFactProjectScope.ts";
 

package/node_modules/@nklisch/pi-clearance/src/contracts/ToolPathFacts.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 import type { ToolPathFact } from "./ToolPathFact.ts";
 

package/node_modules/@nklisch/pi-clearance/src/contracts/ToolPathUsage.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 
 export type ToolPathUsage = "argument" | "implicit-cwd";

package/node_modules/@nklisch/pi-clearance/src/contracts/ToolShape.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 import type { BashCommandShape } from "./BashCommandShape.ts";
 import type { PiBuiltinToolShape } from "./PiBuiltinToolShape.ts";

package/node_modules/@nklisch/pi-clearance/src/contracts/UnknownPathBehavior.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 
 export type UnknownPathBehavior = "review" | "deny";

package/node_modules/@nklisch/pi-clearance/src/contracts/UnknownToolShape.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 import type { ShapeDiagnostic } from "./ShapeDiagnostic.ts";
 

package/node_modules/@nklisch/pi-clearance/src/contracts/index.ts

@@ -1,4 +1,4 @@
-// @generated by ts-rs; do not edit. Run `pnpm contracts:generate`.
+// @generated by ts-rs; do not edit. Run `npm run contracts:generate`.
 export * from "./AdversarialCase.ts";
 export * from "./AdversarialCaseCategory.ts";
 export * from "./AdversarialCaseExpectation.ts";

package/node_modules/@nklisch/pi-clearance/src/index.ts

@@ -5,6 +5,10 @@ import type {
 } from "@earendil-works/pi-coding-agent";
 
 import { createAuditLogger } from "./audit/logger.ts";
+import {
+  CLEARANCE_ALLOW_REQUEST_CUSTOM_TYPE,
+  renderClearanceAllowRequest,
+} from "./runtime/allow-request-message.ts";
 import { requireNativeEngine } from "./native/loader.ts";
 import { createPackageRegistrationStore } from "./packs/package-registration.ts";
 import { createDefaultAnalyzerRegistry } from "./parse/registry.ts";
@@ -60,6 +64,21 @@ const piAutoApprove: ExtensionFactory = (pi: ExtensionAPI) => {
   // partially initialized clearance runtime in place.
   const nativeHealth = requireNativeEngine().health();
   const audit = createAuditLogger({ sink: createDefaultAuditSink() });
+  const registerMessageRenderer = (
+    pi as unknown as {
+      registerMessageRenderer?: (
+        customType: string,
+        renderer: typeof renderClearanceAllowRequest,
+      ) => void;
+    }
+  ).registerMessageRenderer;
+  if (typeof registerMessageRenderer === "function") {
+    registerMessageRenderer.call(
+      pi,
+      CLEARANCE_ALLOW_REQUEST_CUSTOM_TYPE,
+      renderClearanceAllowRequest,
+    );
+  }
   let invalidatePolicyCache: (cwd?: string) => void = () => {
     /* resolver not constructed yet */
   };
@@ -111,6 +130,7 @@ const piAutoApprove: ExtensionFactory = (pi: ExtensionAPI) => {
     audit,
     recentDecisionSource,
     analyzerRegistry,
+    toolMetadata: () => toolMetadata(pi),
   });
   registerProposalTools(
     pi,
@@ -179,13 +199,24 @@ const piAutoApprove: ExtensionFactory = (pi: ExtensionAPI) => {
 };
 
 function registeredToolNames(pi: ExtensionAPI): readonly string[] {
+  return toolMetadata(pi).allToolNames;
+}
+
+function toolMetadata(pi: ExtensionAPI): {
+  readonly activeToolNames: readonly string[];
+  readonly allToolNames: readonly string[];
+} {
   try {
-    return pi
+    const allToolNames = pi
       .getAllTools()
       .map((tool) => tool.name)
       .filter((name): name is string => typeof name === "string");
+    return {
+      activeToolNames: pi.getActiveTools(),
+      allToolNames,
+    };
   } catch {
-    return [];
+    return { activeToolNames: [], allToolNames: [] };
   }
 }
 

package/node_modules/@nklisch/pi-clearance/src/native/loader.ts

@@ -195,12 +195,18 @@ let cachedStatus: NativeEngineStatus | undefined;
  * prebuild files staged by `native:prepare`.
  */
 export function nativePlatformTriple(): string | undefined {
-  if (process.platform === "linux" && process.arch === "x64") {
-    return "linux-x64-gnu";
-  }
-  if (process.platform === "darwin" && process.arch === "arm64") {
-    return "darwin-arm64";
-  }
+  // Map the host platform/arch to a napi-rs platform-package suffix. Every
+  // common dev platform is covered. The list of *built* prebuilds is the
+  // narrower one in `package.json` `napi.targets`; this function returns a
+  // suffix for any platform Node can run on so the load path produces a
+  // precise "no prebuild for this platform" error rather than a generic
+  // "unsupported native platform" when the host is genuinely novel.
+  if (process.platform === "linux" && process.arch === "x64") return "linux-x64-gnu";
+  if (process.platform === "linux" && process.arch === "arm64") return "linux-arm64-gnu";
+  if (process.platform === "darwin" && process.arch === "x64") return "darwin-x64";
+  if (process.platform === "darwin" && process.arch === "arm64") return "darwin-arm64";
+  if (process.platform === "win32" && process.arch === "x64") return "win32-x64-msvc";
+  if (process.platform === "win32" && process.arch === "arm64") return "win32-arm64-msvc";
   return undefined;
 }
 

package/node_modules/@nklisch/pi-clearance/src/replay/reviewer-config-proposals.ts

@@ -9,6 +9,7 @@ import {
   ReviewerConfigSchema,
 } from "../config/schema.ts";
 import {
+  isShippedReviewerPostureId,
   REVIEWER_BASE_CONTRACT,
   SHIPPED_REVIEWER_POSTURES,
   validatePromptOverride,
@@ -146,8 +147,10 @@ export type ReviewerModelDrafter = (
 ) => Promise<ReviewerModelDraftResult | undefined>;
 
 /** True iff `postureId` is one of the shipped reviewer posture fragments. */
-export function isShippedReviewerPosture(postureId: string): boolean {
-  return Object.hasOwn(SHIPPED_REVIEWER_POSTURES, postureId);
+export function isShippedReviewerPosture(
+  postureId: string,
+): postureId is keyof typeof SHIPPED_REVIEWER_POSTURES {
+  return isShippedReviewerPostureId(postureId);
 }
 
 /**
@@ -700,9 +703,9 @@ function draftOverrideSet(
   const postureFragments =
     SHIPPED_REVIEWER_POSTURES[
       isShippedReviewerPosture(current.promptPosture)
-        ? (current.promptPosture as keyof typeof SHIPPED_REVIEWER_POSTURES)
+        ? current.promptPosture
         : "reviewer.default"
-    ];
+    ].fragments;
   const text = [
     REVIEWER_BASE_CONTRACT.text,
     ...postureFragments.map((fragment) => fragment.text),

package/node_modules/@nklisch/pi-clearance/src/runtime/allow-request-message.ts

@@ -0,0 +1,21 @@
+import type { MessageRenderer } from "@earendil-works/pi-coding-agent";
+import { Text } from "@earendil-works/pi-tui";
+
+export const CLEARANCE_ALLOW_REQUEST_CUSTOM_TYPE = "clearance.allow-request";
+
+export interface ClearanceAllowRequestDetails {
+  readonly brief: string;
+  readonly form: "free-text" | "recent-command" | "no-recent-command";
+}
+
+/**
+ * Keep the transcript row compact while the custom message content remains the
+ * complete, clearly labelled brief that Pi sends to the model. The renderer is
+ * deliberately not the source of model context.
+ */
+export const renderClearanceAllowRequest: MessageRenderer<
+  ClearanceAllowRequestDetails
+> = (message) => {
+  const form = message.details?.form ?? "request";
+  return new Text(`[Pi Clearance] Allow request handed to agent (${form})`);
+};

package/node_modules/@nklisch/pi-clearance/src/runtime/auto-reviewer-read-models.ts

@@ -5,6 +5,16 @@ import type {
   ResolvedConfig,
   ResolvedReviewerConfig,
 } from "../config/loader.ts";
+import {
+  DEFAULT_PROJECT_SCOPE_BEHAVIOR,
+  DEFAULT_REVIEWER_CONTEXT_MODE,
+  DEFAULT_REVIEWER_ESCALATION,
+  DEFAULT_REVIEWER_PROMPT_POSTURE,
+  DEFAULT_REVIEWER_RECENT_CONTEXT,
+  DEFAULT_REVIEWER_TOKEN_BUDGET,
+  DEFAULT_REVIEW_NOTE_DISPLAY,
+  DEFAULT_UNKNOWN_TOOL_POSTURE,
+} from "../config/defaults.ts";
 import { shippedPackActivationCondition } from "../packs/activation.ts";
 import type { PackageRegistrationSnapshot } from "../packs/package-registration.ts";
 import {
@@ -49,6 +59,9 @@ export interface AutoReviewerStatusView {
     readonly cwd: string;
   };
   readonly mode: ResolvedPolicy["config"]["mode"];
+  readonly gatedTools?: readonly string[];
+  /** Concise category labels for non-default user-owned settings. */
+  readonly customizations?: readonly string[];
   readonly reviewer: {
     readonly promptPosture: string;
     readonly configuredModel: string | null;
@@ -63,7 +76,10 @@ export interface AutoReviewerStatusView {
       readonly global: number;
       readonly globalProjectConfigured: number;
       readonly projectOverlayConfigured: number;
+      readonly repositoryConfigured: number;
       readonly activeProject: number;
+      /** Configured or active append count, whichever is more informative. */
+      readonly total: number;
     };
     readonly promptOverrideConfigured?: boolean;
     /** Plain-language current reviewer path for gray-area calls. */
@@ -149,7 +165,6 @@ export function buildAutoReviewerStatusView(input: {
   const entries = input.policy.registry.entries;
   const enabled = entries.filter((entry) => entry.availability.enabled).length;
   const reviewer = input.policy.config.reviewer;
-  const snapshots = input.policy.config.sourceSnapshots;
   const resolvedReviewerModel = resolveReviewerModel({
     registry: reviewerModelRegistry(input.ctx),
     spec: reviewer.model,
@@ -158,6 +173,7 @@ export function buildAutoReviewerStatusView(input: {
   const modelHighCost =
     resolvedReviewerModel.model !== undefined &&
     isHighCostReviewerModel(resolvedReviewerModel.model.id);
+  const promptAppendCounts = reviewerPromptAppendCounts(input.policy.config);
   const reviewerPath = resolveReviewerPath({
     config: input.policy.config,
     hasUI: hasHumanReviewUi(input.ctx),
@@ -170,6 +186,8 @@ export function buildAutoReviewerStatusView(input: {
       cwd: projectCwd(input.ctx, input.policy),
     },
     mode: input.policy.config.mode,
+    gatedTools: [...(input.policy.config.gatedTools ?? [])],
+    customizations: customizationCategories(input.policy.config),
     reviewer: {
       promptPosture: reviewer.promptPosture,
       configuredModel: reviewer.model,
@@ -185,13 +203,7 @@ export function buildAutoReviewerStatusView(input: {
       contextMode: reviewer.contextMode,
       tokenBudget: { ...reviewer.tokenBudget },
       escalation: { ...reviewer.escalation },
-      promptAppends: {
-        global: reviewer.promptAppends.length,
-        globalProjectConfigured:
-          snapshots?.global.reviewer.projectPromptAppends.length ?? 0,
-        projectOverlayConfigured: snapshots?.project.promptAppends.length ?? 0,
-        activeProject: reviewer.projectPromptAppends.length,
-      },
+      promptAppends: promptAppendCounts,
       promptOverrideConfigured: reviewer.promptOverride !== null,
       path: reviewerPath,
       consequence: reviewerConsequence(reviewerPath),
@@ -460,6 +472,151 @@ function syntheticPackageRow(
   };
 }
 
+function customizationCategories(
+  config: ResolvedPolicy["config"],
+): readonly string[] {
+  const categories: string[] = [];
+  const snapshots = config.sourceSnapshots;
+  const reviewer = config.reviewer;
+  const promptAppendCounts = reviewerPromptAppendCounts(config);
+
+  if (reviewer.promptOverride !== null) categories.push("prompt override");
+  if (promptAppendCounts.total > 0) {
+    categories.push(`prompt appends (${promptAppendCounts.total})`);
+  }
+  if (reviewer.promptPosture !== DEFAULT_REVIEWER_PROMPT_POSTURE) {
+    categories.push("posture");
+  }
+  if (reviewer.model !== null) categories.push("model pin");
+  if (config.unknownToolPosture !== DEFAULT_UNKNOWN_TOOL_POSTURE) {
+    categories.push("unknown-tool posture");
+  }
+  const recentContext = reviewer.recentContext;
+  if (
+    reviewer.contextMode !== DEFAULT_REVIEWER_CONTEXT_MODE ||
+    recentContext.decisionLimit !== DEFAULT_REVIEWER_RECENT_CONTEXT.decisionLimit ||
+    recentContext.decisionWindow !== DEFAULT_REVIEWER_RECENT_CONTEXT.decisionWindow ||
+    (recentContext.conversationTurns ??
+      DEFAULT_REVIEWER_RECENT_CONTEXT.conversationTurns) !==
+      DEFAULT_REVIEWER_RECENT_CONTEXT.conversationTurns ||
+    (recentContext.userTurns ?? DEFAULT_REVIEWER_RECENT_CONTEXT.userTurns) !==
+      DEFAULT_REVIEWER_RECENT_CONTEXT.userTurns ||
+    recentContext.conversationCharLimit !==
+      DEFAULT_REVIEWER_RECENT_CONTEXT.conversationCharLimit
+  ) {
+    categories.push("context");
+  }
+  if (
+    reviewer.tokenBudget.window !== DEFAULT_REVIEWER_TOKEN_BUDGET.window ||
+    reviewer.tokenBudget.limit !== DEFAULT_REVIEWER_TOKEN_BUDGET.limit
+  ) {
+    categories.push("budget");
+  }
+  if (
+    reviewer.escalation.enabled !== DEFAULT_REVIEWER_ESCALATION.enabled ||
+    reviewer.escalation.denialLimit !==
+      DEFAULT_REVIEWER_ESCALATION.denialLimit ||
+    reviewer.escalation.window !== DEFAULT_REVIEWER_ESCALATION.window
+  ) {
+    categories.push("escalation");
+  }
+  const gatedTools = config.gatedTools ?? [];
+  if (gatedTools.length > 0) {
+    categories.push(`gated tools (${gatedTools.length})`);
+  }
+  if (scopeIsCustomized(snapshots?.project.projectScope)) {
+    categories.push("scope");
+  }
+  const packCount = customizedPackCount(snapshots);
+  if (packCount > 0) categories.push(`packs (${packCount})`);
+  if (
+    config.display.reviewNote.mode !== DEFAULT_REVIEW_NOTE_DISPLAY.mode ||
+    config.display.reviewNote.showModelLabel !==
+      DEFAULT_REVIEW_NOTE_DISPLAY.showModelLabel ||
+    config.display.reviewNote.accent !== DEFAULT_REVIEW_NOTE_DISPLAY.accent
+  ) {
+    categories.push("display");
+  }
+
+  return categories;
+}
+
+function reviewerPromptAppendCounts(
+  config: ResolvedPolicy["config"],
+): NonNullable<AutoReviewerStatusView["reviewer"]["promptAppends"]> {
+  const snapshots = config.sourceSnapshots;
+  const global = config.reviewer.promptAppends.length;
+  const globalProjectConfigured =
+    snapshots?.global.reviewer.projectPromptAppends.length ?? 0;
+  const projectOverlayConfigured = snapshots?.project.promptAppends.length ?? 0;
+  const repositoryConfigured = snapshots?.repository.promptAppends.length ?? 0;
+  const activeProject = config.reviewer.projectPromptAppends.length;
+  const configuredTotal =
+    global +
+    globalProjectConfigured +
+    projectOverlayConfigured +
+    repositoryConfigured;
+  const activeTotal = global + activeProject;
+
+  return {
+    global,
+    globalProjectConfigured,
+    projectOverlayConfigured,
+    repositoryConfigured,
+    activeProject,
+    total: Math.max(configuredTotal, activeTotal),
+  };
+}
+
+function scopeIsCustomized(scope: unknown): boolean {
+  if (scope === undefined || typeof scope !== "object" || scope === null) {
+    return false;
+  }
+  const value = scope as Record<string, unknown>;
+  return (
+    [
+      "roots",
+      "writableDirectories",
+      "tempDirectories",
+      "deniedDirectories",
+      "safeHomeDirectories",
+      "agentSupportDirectories",
+    ].some((key) => Array.isArray(value[key]) && value[key].length > 0) ||
+    (value.safeHomeUseDefaults !== undefined &&
+      value.safeHomeUseDefaults !==
+        DEFAULT_PROJECT_SCOPE_BEHAVIOR.safeHomeUseDefaults) ||
+    (value.agentSupportUseDefaults !== undefined &&
+      value.agentSupportUseDefaults !==
+        DEFAULT_PROJECT_SCOPE_BEHAVIOR.agentSupportUseDefaults) ||
+    (value.unknownPathBehavior !== undefined &&
+      value.unknownPathBehavior !==
+        DEFAULT_PROJECT_SCOPE_BEHAVIOR.unknownPathBehavior) ||
+    (value.sensitivePathBehavior !== undefined &&
+      value.sensitivePathBehavior !==
+        DEFAULT_PROJECT_SCOPE_BEHAVIOR.sensitivePathBehavior) ||
+    (value.homePathBehavior !== undefined &&
+      value.homePathBehavior !== DEFAULT_PROJECT_SCOPE_BEHAVIOR.homePathBehavior)
+  );
+}
+
+function customizedPackCount(
+  snapshots: ResolvedPolicy["config"]["sourceSnapshots"],
+): number {
+  if (snapshots === undefined) return 0;
+  const { global, project, repository } = snapshots;
+  return [
+    global.packs.length,
+    project.packs.length,
+    repository.packs.length,
+    global.packEnablement.enabledPackagePacks.length,
+    global.packEnablement.disabledPackagePacks.length,
+    global.packEnablement.disabledConfigPacks.length,
+    project.packEnablement.enabledPackagePacks.length,
+    project.packEnablement.disabledPackagePacks.length,
+    project.packEnablement.disabledConfigPacks.length,
+  ].reduce((total, count) => total + count, 0);
+}
+
 function effectCopy(effect: PackEffectSummary): string {
   switch (effect) {
     case "deny-floor":

package/node_modules/@nklisch/pi-clearance/src/runtime/command-registry.ts

@@ -101,7 +101,7 @@ export async function handleClearanceCommand(
 ): Promise<CommandReport> {
   const tokens = parseCommandArgs(args);
   if (tokens.length === 0) {
-    return await handleSettingsCommand([], ctx, deps);
+    return await handleSetupCommand([], ctx, pi, deps);
   }
 
   const command = tokens[0] as string;