pi-continual-harness 0.12.0 → 0.13.0

package/README.md

@@ -440,7 +440,9 @@ Then `"my-proposer"` is selectable via `/refine --proposer my-proposer` or
 - **Boundary delivery for auto-refine**: the steering prompt is persisted as a
   structural entry with `{ entries, continue: true }` at `turn_end` (no
   synthetic user message, no follow-up-scheduling side effects); manual
-  `/refine` still steers via a user message.
+  `/refine` still steers via a user message. Each new boundary also omits
+  prior auto-refine request drafts from future provider context (pi ≥ 0.87
+  context edits; `autoRefine.omitStaleDrafts: false` to keep them).
 
 Open extension points (see `docs/ROADMAP.md`):
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-continual-harness",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Online self-improvement layer for pi. A unified, in-trajectory harness-state store (prompt notes, memory, skill descriptions, sub-agent specs) with a manual /refine that proposes evidence-backed structured CRUD deltas. Composes with pi-reflect (offline) and pi-mem (storage); owns only the online optimizer layer. Inspired by Continual Harness (arXiv 2605.09998) and ACE (arXiv 2510.04618).",
   "keywords": [
     "pi-package",

package/src/auto-refine.ts

@@ -75,6 +75,39 @@ export function buildRefineDraft(steeringMessage: string): {
   return { type: "custom_message", customType: AUTO_REFINE_ENTRY, content: steeringMessage, display: true };
 }
 
+/** Structural slice of pi's ProjectedSessionEntry (sourceEntry + messages). */
+export interface ProjectedLike {
+  sourceEntry?: { type?: string; customType?: string; id?: string };
+  messages?: unknown[];
+}
+
+/** A context_edit boundary draft (pi ≥ 0.87): omit one entry from future
+ *  provider context — raw history, usage, and UI history stay untouched. */
+export interface OmissionDraft {
+  type: "context_edit";
+  targetId: string;
+  replacement: null;
+}
+
+/**
+ * Context-edit drafts omitting every LIVE prior auto-refine request from
+ * future provider context (pi ≥ 0.87 ContextEditEntry). Invariant: at most
+ * ONE auto-refine request is ever model-visible — the newest. Already-omitted
+ * drafts surface in the projection with empty `messages` and are skipped, so
+ * the operation is idempotent and never stacks redundant edits. Raw history
+ * (and the HTML export) keeps every draft: /tree rollback still applies.
+ */
+export function buildOmissionDrafts(projected: Iterable<ProjectedLike>): OmissionDraft[] {
+  const drafts: OmissionDraft[] = [];
+  for (const p of projected) {
+    const src = p.sourceEntry;
+    if (src?.type !== "custom_message" || src.customType !== AUTO_REFINE_ENTRY) continue;
+    if ((p.messages?.length ?? 0) === 0) continue; // already omitted → skip
+    if (typeof src.id === "string") drafts.push({ type: "context_edit", targetId: src.id, replacement: null });
+  }
+  return drafts;
+}
+
 /** Subscribe to turn_end and run /refine on the configured cadence. */
 export function registerAutoRefine(pi: ExtensionAPI): void {
   pi.on("turn_end", async (event, ctx) => {
@@ -118,7 +151,19 @@ export function registerAutoRefine(pi: ExtensionAPI): void {
           pi.sendUserMessage(result.steeringMessage);
           return;
         }
-        return { entries: [...event.entries, buildRefineDraft(result.steeringMessage)], continue: true };
+        // Hygiene (pi ≥ 0.87 context edits): omit every LIVE prior auto-refine
+        // request from future provider context, so at most one draft (the new
+        // one) is ever model-visible. Already-omitted drafts are skipped by
+        // buildOmissionDrafts; raw history and /tree rollback are untouched.
+        // Kill-switch: autoRefine.omitStaleDrafts: false.
+        const omissions =
+          config.autoRefine?.omitStaleDrafts === false
+            ? []
+            : buildOmissionDrafts(event.context?.contextEntries ?? []);
+        return {
+          entries: [...event.entries, ...omissions, buildRefineDraft(result.steeringMessage)],
+          continue: true,
+        };
       }
     } catch (err) {
       ctx.ui.notify(`Auto-refine failed: ${(err as Error).message}`, "error");

package/src/config.ts

@@ -62,6 +62,11 @@ export interface HarnessConfig {
      *  trajectory contains a durable correction; skip the refine when it says
      *  no. Soft-fails to the plain cadence on classifier errors. Default false. */
     gate?: boolean;
+    /** Boundary-delivery hygiene (pi ≥ 0.87 context edits, default true): omit
+     *  prior auto-refine request drafts from future provider context so at most
+     *  one (the newest) is ever model-visible. Raw history and /tree rollback
+     *  are untouched; set false to keep every draft in context. */
+    omitStaleDrafts?: boolean;
   };
   /** Classifier model for the cheap gated paths (pi ≥ 0.99): "provider/id" or
    *  a bare id of a classifier catalog entry (e.g. "typesafe/jev-latest" or a
@@ -92,7 +97,7 @@ export const DEFAULT_CONFIG: HarnessConfig = {
   durableScope: "global",
   autoImport: false,
   remindRefine: { enabled: false, everyTurns: DEFAULT_EVERY_TURNS },
-  autoRefine: { enabled: false, everyTurns: DEFAULT_AUTO_EVERY_TURNS, commit: false, gate: false },
+  autoRefine: { enabled: false, everyTurns: DEFAULT_AUTO_EVERY_TURNS, commit: false, gate: false, omitStaleDrafts: true },
   classifier: { model: undefined },
   virtualBinding: "virtual",
   proposer: "steering",
@@ -125,6 +130,7 @@ function mergeConfig(over: Partial<HarnessConfig>): HarnessConfig {
       everyTurns: over.autoRefine?.everyTurns ?? DEFAULT_AUTO_EVERY_TURNS,
       commit: over.autoRefine?.commit ?? false,
       gate: over.autoRefine?.gate === true,
+      omitStaleDrafts: over.autoRefine?.omitStaleDrafts !== false,
     },
     classifier: {
       model: typeof over.classifier?.model === "string" && over.classifier.model ? over.classifier.model : undefined,

package/src/index.ts

@@ -139,3 +139,14 @@ export {
   type ClassifyBoolResult,
   type ClassifyFn,
 } from "./classify.js";
+
+// Auto-refine boundary helpers (pi ≥ 0.87, 0.12.0–0.13.0): the steering draft
+// and the stale-draft context-edit omissions. Re-exported for tests and
+// companion packages without reaching into internal paths.
+export {
+  AUTO_REFINE_ENTRY,
+  buildOmissionDrafts,
+  buildRefineDraft,
+  type OmissionDraft,
+  type ProjectedLike,
+} from "./auto-refine.js";