ai-foreman 1.7.8 → 1.7.10

package/README.md

@@ -115,9 +115,7 @@ What each part does:
 | `--branch-prefix <prefix>` | `feature` / `rafi` / another valid Git prefix | `feature` | Prefix for generated ticket branches. Explicit prefixes are preserved verbatim. |
 | `--max-branch-depth <n>` | positive integer | `5` | Maximum selected branch/PR stack depth (root PR is depth 1). |
 | `--show-session-cost` / `--hide-session-cost` | flags | saved role preferences | Show authoritative provider cost or trustworthy cumulative tokens for Builder and QA; does not change context occupancy display. |
-| `--auto-compact-threshold <percent>` | integer `1`–`99` | saved Builder value, then `50` | Initial Builder threshold override. A later explicit Builder-threshold revision wins for the active run. |
-
-Builder and QA context ceilings are configured independently (default `50%`, maximum `10` successful compactions per scoped provider session). Claude and Codex install the ceiling as a native in-turn auto-compaction limit before real work begins; Rafi verifies the post-compaction occupancy and counts provider-native and host-requested compactions together. An ineffective or failed compact receives one bounded retry, followed by a validated cumulative handoff. Status output reports the configured and installed ceilings, lifecycle state, scoped count/maximum, and settings revision without substituting cumulative session tokens for active context occupancy.
+| `--auto-compact-threshold <percent>` | integer `1`–`99` | saved Builder value, then `50` | Initial run threshold override. A newer persistent settings revision wins at the next safe boundary. |
 
 Auto-detected tracker files:
 
@@ -609,14 +607,6 @@ pnpm build
 pnpm dev -- start ../../examples/dummy-project --steps 2
 ```
 
-Changes to provider adapters or context lifecycle enforcement also require the opt-in authenticated gate:
-
-```bash
-pnpm test:live-providers
-```
-
-It exercises Claude and Codex as both Builder and QA with a low native ceiling, verifies in-turn compaction and same-session continuation, then verifies a maximum-one boundary interruption and validated fresh handoff. Set `RAFI_LIVE_CONTEXT_THRESHOLD_PERCENT` to an integer from `1` through `10` to override its default `10%` ceiling. Very low Claude ceilings can intentionally fail the capability check when they fall below the SDK's minimum native window. The gate uses locally authenticated provider CLIs and is intentionally skipped by the ordinary test suite.
-
 Package output:
 
 - The package publishes an `ai-foreman` binary from `dist/index.js`.

package/dist/activity.js

@@ -236,8 +236,8 @@ export function reportBuilderEvent(event) {
         reporter.update("processing agent response");
     else if (event.kind === "session-transition")
         reporter.update(`session ${event.transition}`, event.detail);
-    else if (event.kind === "context-compaction")
-        reporter.update(event.phase === "started" ? "compacting context" : event.phase === "succeeded" ? "context compacted" : "context compaction failed", `${event.origin} ${event.providerEventId}`, { provider: event.provider });
+    else if (event.kind === "context-usage")
+        reporter.pulse(event.percentage === undefined ? undefined : `context ${event.percentage.toFixed(0)}%`);
     else if (event.kind === "turn-complete")
         reporter.update(event.result.isError ? "agent turn failed" : "agent turn complete");
     else if (event.kind === "error")

package/dist/adapters/claude.d.ts

@@ -1,7 +1,7 @@
 import type { SDKSessionInfo, PermissionResult } from "@anthropic-ai/claude-agent-sdk";
 /** Lazy-load the Claude Agent SDK. Throws an actionable error if not installed. */
 export declare function requireClaudeSDK(): Promise<typeof import("@anthropic-ai/claude-agent-sdk")>;
-import type { BuilderAdapter, BuilderAdapterOptions, BuilderEvent, CompactResult, ContextManagementPolicy, ContextUsage, InterruptResult, PermissionDecision, PreparedContextManagement, ProviderSettingSwitch, ProviderSessionUsage, TurnResult } from "./types.js";
+import type { BuilderAdapter, BuilderAdapterOptions, BuilderEvent, NativeCompaction, NativeAutoCompactionPolicy, CompactResult, ContextUsage, PermissionDecision, ProviderSettingSwitch, ProviderSessionUsage, TurnResult } from "./types.js";
 import type { ProviderSessionRefV1, SessionAvailabilityV1 } from "rafi-spec";
 /**
  * Pure function: build the `options` object passed to `query()`.
@@ -43,14 +43,11 @@ export declare function claudeApiRetryEvent(message: {
 export declare class ClaudeAdapter implements BuilderAdapter {
     private readonly opts;
     readonly agent: "claude";
-    private inbox;
+    private readonly inbox;
     private readonly eventQueue;
-    private query;
-    private abort;
-    private pumpDone;
-    private readonly queryFactory;
-    private transportGeneration;
-    private transportObservedSessionId?;
+    private readonly query;
+    private readonly abort;
+    private readonly pumpDone;
     private _sessionId?;
     private _sessionRef?;
     private readonly stderrChunks;
@@ -58,19 +55,12 @@ export declare class ClaudeAdapter implements BuilderAdapter {
     private structuredError?;
     private apiErrorStatus?;
     private compactResult?;
-    private contextPolicy?;
-    private contextSequence;
-    private compactionSequence;
-    private activeCompaction?;
-    private manualCompactionPending;
-    private boundaryInterrupt?;
-    private compactionTerminalObserved;
-    private lastContextUsage?;
-    /** Full provider context capacity, before Rafi narrows Claude's auto-compact window. */
-    private modelContextWindow?;
-    /** SDK-owned space between autoCompactWindow and the actual used-token trigger. */
-    private nativeAutoCompactReserve?;
-    private contextPrepared;
+    private autoCompactionPrepared;
+    private preparedAutoCompactThreshold?;
+    private preparedAutoCompactionPolicy?;
+    private manualCompactionInFlight;
+    private nativeCompactions;
+    private nativeCompactionSequence;
     private cumulativeUsage;
     private pending?;
     private terminalResult?;
@@ -78,7 +68,6 @@ export declare class ClaudeAdapter implements BuilderAdapter {
     private closed;
     static create(opts: BuilderAdapterOptions): Promise<ClaudeAdapter>;
     private constructor();
-    private openQuery;
     /** Background loop: consume the SDK message stream until it ends. */
     private pump;
     private handle;
@@ -90,19 +79,16 @@ export declare class ClaudeAdapter implements BuilderAdapter {
     adoptSessionRef(ref: ProviderSessionRefV1): void;
     validateSession(): Promise<SessionAvailabilityV1>;
     compact(): Promise<CompactResult>;
+    prepareAutoCompaction(thresholdPercent?: number | undefined): Promise<NativeAutoCompactionPolicy | void>;
+    autoCompactionPolicy(): NativeAutoCompactionPolicy | undefined;
+    drainNativeCompactions(): NativeCompaction[];
+    restoreNativeCompactions(compactions: NativeCompaction[]): void;
     contextUsage(): Promise<ContextUsage | undefined>;
-    prepareContextManagement(policy: ContextManagementPolicy): Promise<PreparedContextManagement>;
-    updateContextManagement(policy: ContextManagementPolicy): Promise<PreparedContextManagement>;
-    interruptTurnAtCompactionBoundary(providerEventId?: string): Promise<InterruptResult>;
     sessionUsage(): Promise<ProviderSessionUsage | undefined>;
     switchSettings(settings: ProviderSettingSwitch): Promise<CompactResult>;
     events(): AsyncIterable<BuilderEvent>;
     close(): Promise<void>;
     private observeSession;
-    private makeContextUsage;
-    private configureContextManagement;
-    private restartTransport;
-    private completeCompaction;
     private settlePending;
     private streamFailureResult;
 }