@caupulican/pi-adaptative 0.80.88 → 0.80.89

package/CHANGELOG.md

@@ -1,3 +1,32 @@
+## [0.80.89] - 2026-07-02
+
+### Added
+
+- Added the brain-assisted context curator (opt-in `contextPolicy.curation` settings + Settings ->
+  Context Curation submenu): a local-model sidecar that (a) writes 1-2 line semantic digests into
+  Context GC's packed stubs so the main model stops re-running tools to rediscover packed content,
+  and (b) scores stale artifact-backed tool outputs against the current goal so the prompt-policy
+  enforcement pilot can evict irrelevant content earlier. Advisories are asymmetric by design: a
+  verdict can only ever shrink the prompt, never keep or stub protected content, and every consumer
+  behaves identically when a result is absent. Curation jobs are queued/bounded/idempotent, drain
+  off-turn through the isolated-completion path with spawned-usage accounting, and persist auditable
+  session records. The curator refuses models that have not PASSED the new `digest` fitness surface
+  on this host (visible skip reasons, never silent degradation).
+- Added a `digest` surface to the `model_fitness` probe: chunks carry nonce identifiers, and a
+  digest only scores as faithful when strict JSON parses AND the nonce survives verbatim — measuring
+  extraction fidelity, not narration.
+- Added `/context`, a user-facing context composition dashboard decomposing what rides on EVERY
+  request: system prompt tokens, per-tool schema costs (heaviest first), per-extension contributions,
+  message classes (raw vs GC-packed vs policy-stubbed vs memory recall pages), GC/enforcement/curation
+  activity, spawned background spend, and provider-reported vs estimated deltas — plus actionable
+  observations (e.g. an oversized tool schema riding on every request) for users building their own
+  pi integrations.
+- Added `/fitness [model] [trials]` as a first-class, discoverable command: with no arguments it
+  opens the model picker, runs the probe on the selection, shows the six-surface report, and then
+  offers ONE-STEP role assignment — context curator, router cheap/medium/expensive tier, routing
+  judge, or learning model — writing the matching settings for you (with a hint when the model
+  router itself is still disabled). With an explicit model it behaves like `/autonomy fitness`.
+
 ## [0.80.88] - 2026-07-02
 
 ## [0.80.87] - 2026-07-02

package/dist/core/agent-session.d.ts

@@ -5,7 +5,9 @@ import { type LaneRecord } from "./autonomy/lane-tracker.ts";
 import type { AutonomyDiagnosticSnapshot, AutonomyStatusSnapshot } from "./autonomy/status.ts";
 import { type BashResult } from "./bash-executor.ts";
 import { type CompactionResult } from "./compaction/index.ts";
+import { type CurationTelemetrySnapshot } from "./context/brain-curator.ts";
 import { type ContextAuditReport } from "./context/context-audit.ts";
+import { type ContextCompositionReport } from "./context/context-composition.ts";
 import { type PromptEnforcementReport } from "./context/context-prompt-enforcement.ts";
 import { type PromptPolicyGcCorrelationReport, type PromptPolicyShadowReport } from "./context/context-prompt-policy.ts";
 import { type MemoryPromptInclusionReport } from "./context/memory-diagnostics.ts";
@@ -333,6 +335,10 @@ export declare class AgentSession {
     private _autoCompactionAbortController;
     private _overflowRecoveryAttempted;
     private _latestContextGcReport;
+    /** Brain-curation sidecar (design: brain-context-curation-design.md). Inert unless the
+     * contextPolicy.curation setting is enabled AND the model passes the digest fitness gate. */
+    private readonly _brainCurator;
+    private _lastCurationSkipReason;
     private _toolArtifactStore;
     private _latestContextAuditReport;
     private _latestPromptPolicyReport;
@@ -551,6 +557,35 @@ export declare class AgentSession {
      * Never throws into a live turn: any failure degrades to returning `messages` unchanged.
      */
     private _runPromptEnforcement;
+    /**
+     * Enqueue relevance-scoring jobs for stale, artifact-backed tool outputs the enforcement
+     * pilot could act on. Pure queueing — the verdicts only ever take effect through the
+     * asymmetric advisory lever inside enforcePromptPolicy. Never throws into a turn.
+     */
+    private _enqueueRelevanceCuration;
+    /**
+     * Drain gate: settings on, model configured+authed, and the model has PASSED the digest
+     * fitness probe on THIS host (design: unfit or unprobed models are refused with a visible
+     * reason, never silently degraded). Fire-and-forget; never throws into a turn.
+     */
+    private _maybeDrainBrainCuration;
+    private _drainBrainCuration;
+    /**
+     * Context composition dashboard data: decomposes the per-request payload (system prompt, tool
+     * schemas, extension contributions, message classes incl. GC/policy stubs and recall pages)
+     * plus background spend, so users can see exactly what their integrations cost per request.
+     * Read-only: uses the GC report path (writePayloads=false), never mutates anything.
+     */
+    getContextCompositionReport(): ContextCompositionReport;
+    /** Bounded plain-text rendering of {@link getContextCompositionReport} for the /context command. */
+    formatContextCompositionDashboard(): string;
+    /** Curation status for diagnostics/dashboard: settings, live telemetry, last refusal reason. */
+    getContextCurationStatus(): {
+        enabled: boolean;
+        model?: string;
+        telemetry: CurationTelemetrySnapshot;
+        lastSkipReason?: string;
+    };
     /** Read-only inspection of the latest prompt-enforcement report, for tests/debugging. */
     getPromptEnforcementReport(): PromptEnforcementReport;
     private _runMemoryRetrieval;