pi-harness-runtime 0.9.4 → 0.9.6

package/packages/context-manager/dist/core.js

@@ -0,0 +1,62 @@
+/**
+ * Context Manager Core — pressure estimation, TTL, prioritization (RFC-0010)
+ */
+export const DEFAULT_POLICY = {
+    warningThreshold: 0.6,
+    compactThreshold: 0.7,
+    hardStopThreshold: 0.85,
+};
+/** Estimate context pressure as a ratio (0-1). */
+export function estimatePressure(currentTokens, maxTokens) {
+    if (maxTokens <= 0)
+        return 1;
+    return Math.min(currentTokens / maxTokens, 1);
+}
+/** Determine pressure level from a ratio. */
+export function getPressureLevel(pressure, policy = DEFAULT_POLICY) {
+    if (pressure >= policy.hardStopThreshold)
+        return "hard_stop";
+    if (pressure >= policy.compactThreshold)
+        return "compact";
+    if (pressure >= policy.warningThreshold)
+        return "warning";
+    return "normal";
+}
+/** Create a new session-scoped context bucket. */
+export function createSessionScope(id) {
+    return { id, items: [], ttlMs: 30 * 60 * 1000, createdAt: Date.now() };
+}
+/** Set TTL on a scope (in milliseconds). */
+export function setTTL(scope, ttlMs) {
+    return { ...scope, ttlMs };
+}
+/** Add an item to a session scope. */
+export function addToScope(scope, item) {
+    return { ...scope, items: [...scope.items, item] };
+}
+/** Remove expired items from a scope based on TTL. */
+export function evictExpired(scope) {
+    const now = Date.now();
+    return {
+        ...scope,
+        items: scope.items.filter((item) => {
+            if (!item.expiresAt)
+                return true;
+            return item.expiresAt > now;
+        }),
+    };
+}
+/** Prioritize items: lower priority number = higher importance. */
+export function prioritize(items, limit) {
+    const sorted = [...items].sort((a, b) => a.priority - b.priority);
+    return limit ? sorted.slice(0, limit) : sorted;
+}
+/** Count tokens using a simple word-based estimator (4 chars/token). */
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+/** Calculate total tokens in a list of items. */
+export function calculateTotalTokens(items) {
+    return items.reduce((sum, item) => sum + item.tokens, 0);
+}
+//# sourceMappingURL=core.js.map

package/packages/context-manager/dist/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,MAAM,CAAC,MAAM,cAAc,GAAkB;IAC5C,gBAAgB,EAAE,GAAG;IACrB,gBAAgB,EAAE,GAAG;IACrB,iBAAiB,EAAE,IAAI;CACvB,CAAC;AAEF,kDAAkD;AAClD,MAAM,UAAU,gBAAgB,CAC/B,aAAqB,EACrB,SAAiB;IAEjB,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,gBAAgB,CAC/B,QAAgB,EAChB,MAAM,GAAkB,cAAc;IAEtC,IAAI,QAAQ,IAAI,MAAM,CAAC,iBAAiB;QAAE,OAAO,WAAW,CAAC;IAC7D,IAAI,QAAQ,IAAI,MAAM,CAAC,gBAAgB;QAAE,OAAO,SAAS,CAAC;IAC1D,IAAI,QAAQ,IAAI,MAAM,CAAC,gBAAgB;QAAE,OAAO,SAAS,CAAC;IAC1D,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,kBAAkB,CAAC,EAAU;IAC5C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;AACxE,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,MAAM,CAAC,KAAmB,EAAE,KAAa;IACxD,OAAO,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,UAAU,CACzB,KAAmB,EACnB,IAAiB;IAEjB,OAAO,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;AACpD,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,YAAY,CAAC,KAAmB;IAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,OAAO;QACN,GAAG,KAAK;QACR,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;YAClC,IAAI,CAAC,IAAI,CAAC,SAAS;gBAAE,OAAO,IAAI,CAAC;YACjC,OAAO,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;QAC7B,CAAC,CAAC;KACF,CAAC;AACH,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,UAAU,CACzB,KAAoB,EACpB,KAAc;IAEd,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAClE,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAChD,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,cAAc,CAAC,IAAY;IAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACnC,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,oBAAoB,CAAC,KAAoB;IACxD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/packages/context-manager/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Context Manager — Main Entry (RFC-0010)
+ */
+export { DEFAULT_POLICY, estimatePressure, getPressureLevel, createSessionScope, setTTL, addToScope, evictExpired, prioritize, estimateTokens, calculateTotalTokens, } from "./core.js";
+export { compactContext, generateResumePrompt, formatResumeMarkdown, } from "./compaction.js";
+export type * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/context-manager/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACN,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,MAAM,EACN,UAAU,EACV,YAAY,EACZ,UAAU,EACV,cAAc,EACd,oBAAoB,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,cAAc,EACd,oBAAoB,EACpB,oBAAoB,GACpB,MAAM,iBAAiB,CAAC;AACzB,mBAAmB,YAAY,CAAC"}

package/packages/context-manager/dist/index.js

@@ -0,0 +1,6 @@
+/**
+ * Context Manager — Main Entry (RFC-0010)
+ */
+export { DEFAULT_POLICY, estimatePressure, getPressureLevel, createSessionScope, setTTL, addToScope, evictExpired, prioritize, estimateTokens, calculateTotalTokens, } from "./core.js";
+export { compactContext, generateResumePrompt, formatResumeMarkdown, } from "./compaction.js";
+//# sourceMappingURL=index.js.map

package/packages/context-manager/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACN,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,MAAM,EACN,UAAU,EACV,YAAY,EACZ,UAAU,EACV,cAAc,EACd,oBAAoB,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,cAAc,EACd,oBAAoB,EACpB,oBAAoB,GACpB,MAAM,iBAAiB,CAAC"}

package/packages/context-manager/dist/types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Context Manager Types (RFC-0010)
+ */
+export type PressureLevel = "normal" | "warning" | "compact" | "hard_stop";
+export interface TriggerPolicy {
+    warningThreshold: number;
+    compactThreshold: number;
+    hardStopThreshold: number;
+}
+export interface ContextItem {
+    id: string;
+    role: "user" | "assistant" | "system";
+    content: string;
+    tokens: number;
+    priority: number;
+    timestamp: number;
+    expiresAt?: number;
+}
+export interface CompactionResult {
+    decisions: string[];
+    openQuestions: string[];
+    taskProgress: Record<string, string>;
+    remainingTokens: number;
+    compactedContent: string;
+}
+export interface SessionScope {
+    id: string;
+    items: ContextItem[];
+    ttlMs: number;
+    createdAt: number;
+}
+export interface ResumePrompt {
+    summary: string;
+    decisions: string[];
+    openQuestions: string[];
+    taskProgress: Record<string, string>;
+    nextAction: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/context-manager/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;AAE3E,MAAM,WAAW,aAAa;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAChC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;CACnB"}

package/packages/context-manager/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Context Manager Types (RFC-0010)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/packages/context-manager/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/packages/context-manager/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@pi-harness/context-manager",
+  "version": "0.9.6",
+  "description": "Context Window Manager — prevents model context overflow via compaction and resume prompts (RFC-0010)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "bun test"
+  },
+  "devDependencies": {
+    "bun-types": "^1.0.0"
+  }
+}

package/packages/context-manager/src/compaction.ts

@@ -0,0 +1,139 @@
+/**
+ * Context Manager — Compaction Engine (RFC-0010)
+ */
+
+import type {
+	ContextItem,
+	CompactionResult,
+	ResumePrompt,
+	TriggerPolicy,
+} from "./types.js";
+import { DEFAULT_POLICY } from "./core.js";
+import { prioritize } from "./core.js";
+
+/** Extract decisions from messages (lines starting with DECISION markers). */
+function extractDecisions(messages: ContextItem[]): string[] {
+	const decisions: string[] = [];
+	for (const msg of messages) {
+		for (const line of msg.content.split("\n")) {
+			const trimmed = line.trim();
+			if (
+				trimmed.startsWith("- DECISION:") ||
+				trimmed.startsWith("**DECISION**") ||
+				/^(?:decision|decided):/i.test(trimmed)
+			) {
+				decisions.push(trimmed.replace(/^[*>-]+\s*/i, "").trim());
+			}
+		}
+	}
+	return [...new Set(decisions)];
+}
+
+/** Extract open questions (lines with ?, TODO, TBD, OPEN markers). */
+function extractQuestions(messages: ContextItem[]): string[] {
+	const questions: string[] = [];
+	for (const msg of messages) {
+		for (const line of msg.content.split("\n")) {
+			const trimmed = line.trim();
+			if (
+				trimmed.includes("?") ||
+				/\bTODO\b/i.test(trimmed) ||
+				/\bTBD\b/i.test(trimmed)
+			) {
+				const cleaned = trimmed.replace(/^[*>-]+\s*/, "").trim();
+				if (cleaned.length > 5) questions.push(cleaned);
+			}
+		}
+	}
+	return [...new Set(questions)];
+}
+
+/** Extract task progress from messages. */
+function extractTaskProgress(messages: ContextItem[]): Record<string, string> {
+	const progress: Record<string, string> = {};
+	for (const msg of messages) {
+		for (const line of msg.content.split("\n")) {
+			const match = line.match(
+				/^(?:progress|task|step)[:\s]+([^|]+)\|\s*(.+)/i,
+			);
+			if (match) progress[match[1].trim()] = match[2].trim();
+		}
+	}
+	return progress;
+}
+
+/** Compact context by extracting durable state and keeping high-priority items. */
+export function compactContext(
+	messages: ContextItem[],
+	maxTokens: number,
+	policy: TriggerPolicy = DEFAULT_POLICY,
+): CompactionResult {
+	const decisions = extractDecisions(messages);
+	const openQuestions = extractQuestions(messages);
+	const taskProgress = extractTaskProgress(messages);
+
+	const prioritized = prioritize(messages, Math.floor(messages.length * 0.6));
+	let tokenCount = 0;
+	const kept: string[] = [];
+
+	for (const msg of prioritized) {
+		if (
+			tokenCount + msg.tokens <=
+			Math.floor(maxTokens * policy.compactThreshold)
+		) {
+			kept.push(msg.content);
+			tokenCount += msg.tokens;
+		}
+	}
+
+	return {
+		decisions,
+		openQuestions,
+		taskProgress,
+		remainingTokens: tokenCount,
+		compactedContent: kept.join("\n\n"),
+	};
+}
+
+/** Generate a resume prompt from compaction result. */
+export function generateResumePrompt(
+	result: CompactionResult,
+	nextAction?: string,
+): ResumePrompt {
+	const summary = [
+		"## Session Summary",
+		`Decisions: ${result.decisions.length > 0 ? result.decisions.join("; ") : "none"}`,
+		`Questions: ${result.openQuestions.length > 0 ? result.openQuestions.join("; ") : "none"}`,
+		`Context size: ${result.remainingTokens} tokens`,
+	].join("\n");
+
+	return {
+		summary,
+		decisions: result.decisions,
+		openQuestions: result.openQuestions,
+		taskProgress: result.taskProgress,
+		nextAction: nextAction ?? "Continue from last position",
+	};
+}
+
+/** Format resume prompt as markdown string. */
+export function formatResumeMarkdown(prompt: ResumePrompt): string {
+	const lines = [
+		"# Resume Prompt",
+		"",
+		prompt.summary,
+		"",
+		"## Decisions",
+		...prompt.decisions.map((d) => `- ${d}`),
+		"",
+		"## Open Questions",
+		...prompt.openQuestions.map((q) => `- ${q}`),
+		"",
+		"## Task Progress",
+		...Object.entries(prompt.taskProgress).map(([k, v]) => `- **${k}**: ${v}`),
+		"",
+		"## Next Action",
+		`- ${prompt.nextAction}`,
+	];
+	return lines.filter((l) => l).join("\n");
+}

package/packages/context-manager/src/core.ts

@@ -0,0 +1,85 @@
+/**
+ * Context Manager Core — pressure estimation, TTL, prioritization (RFC-0010)
+ */
+
+import type {
+	PressureLevel,
+	TriggerPolicy,
+	ContextItem,
+	SessionScope,
+} from "./types.js";
+
+export const DEFAULT_POLICY: TriggerPolicy = {
+	warningThreshold: 0.6,
+	compactThreshold: 0.7,
+	hardStopThreshold: 0.85,
+};
+
+/** Estimate context pressure as a ratio (0-1). */
+export function estimatePressure(
+	currentTokens: number,
+	maxTokens: number,
+): number {
+	if (maxTokens <= 0) return 1;
+	return Math.min(currentTokens / maxTokens, 1);
+}
+
+/** Determine pressure level from a ratio. */
+export function getPressureLevel(
+	pressure: number,
+	policy: TriggerPolicy = DEFAULT_POLICY,
+): PressureLevel {
+	if (pressure >= policy.hardStopThreshold) return "hard_stop";
+	if (pressure >= policy.compactThreshold) return "compact";
+	if (pressure >= policy.warningThreshold) return "warning";
+	return "normal";
+}
+
+/** Create a new session-scoped context bucket. */
+export function createSessionScope(id: string): SessionScope {
+	return { id, items: [], ttlMs: 30 * 60 * 1000, createdAt: Date.now() };
+}
+
+/** Set TTL on a scope (in milliseconds). */
+export function setTTL(scope: SessionScope, ttlMs: number): SessionScope {
+	return { ...scope, ttlMs };
+}
+
+/** Add an item to a session scope. */
+export function addToScope(
+	scope: SessionScope,
+	item: ContextItem,
+): SessionScope {
+	return { ...scope, items: [...scope.items, item] };
+}
+
+/** Remove expired items from a scope based on TTL. */
+export function evictExpired(scope: SessionScope): SessionScope {
+	const now = Date.now();
+	return {
+		...scope,
+		items: scope.items.filter((item) => {
+			if (!item.expiresAt) return true;
+			return item.expiresAt > now;
+		}),
+	};
+}
+
+/** Prioritize items: lower priority number = higher importance. */
+export function prioritize(
+	items: ContextItem[],
+	limit?: number,
+): ContextItem[] {
+	const sorted = [...items].sort((a, b) => a.priority - b.priority);
+	return limit ? sorted.slice(0, limit) : sorted;
+}
+
+/** Count tokens using a simple word-based estimator (4 chars/token). */
+export function estimateTokens(text: string): number {
+	return Math.ceil(text.length / 4);
+}
+
+/** Calculate total tokens in a list of items. */
+export function calculateTotalTokens(items: ContextItem[]): number {
+	return items.reduce((sum, item) => sum + item.tokens, 0);
+}

package/packages/context-manager/src/index.ts

@@ -0,0 +1,22 @@
+/**
+ * Context Manager — Main Entry (RFC-0010)
+ */
+
+export {
+	DEFAULT_POLICY,
+	estimatePressure,
+	getPressureLevel,
+	createSessionScope,
+	setTTL,
+	addToScope,
+	evictExpired,
+	prioritize,
+	estimateTokens,
+	calculateTotalTokens,
+} from "./core.js";
+export {
+	compactContext,
+	generateResumePrompt,
+	formatResumeMarkdown,
+} from "./compaction.js";
+export type * from "./types.js";

package/packages/context-manager/src/types.ts

@@ -0,0 +1,44 @@
+/**
+ * Context Manager Types (RFC-0010)
+ */
+
+export type PressureLevel = "normal" | "warning" | "compact" | "hard_stop";
+
+export interface TriggerPolicy {
+	warningThreshold: number;
+	compactThreshold: number;
+	hardStopThreshold: number;
+}
+
+export interface ContextItem {
+	id: string;
+	role: "user" | "assistant" | "system";
+	content: string;
+	tokens: number;
+	priority: number;
+	timestamp: number;
+	expiresAt?: number;
+}
+
+export interface CompactionResult {
+	decisions: string[];
+	openQuestions: string[];
+	taskProgress: Record<string, string>;
+	remainingTokens: number;
+	compactedContent: string;
+}
+
+export interface SessionScope {
+	id: string;
+	items: ContextItem[];
+	ttlMs: number;
+	createdAt: number;
+}
+
+export interface ResumePrompt {
+	summary: string;
+	decisions: string[];
+	openQuestions: string[];
+	taskProgress: Record<string, string>;
+	nextAction: string;
+}

package/packages/context-manager/test/context.test.ts

@@ -0,0 +1,198 @@
+/**
+ * Context Manager Tests (RFC-0010)
+ */
+
+import { describe, it, expect } from "bun:test";
+import {
+	DEFAULT_POLICY,
+	estimatePressure,
+	getPressureLevel,
+	createSessionScope,
+	setTTL,
+	addToScope,
+	evictExpired,
+	prioritize,
+	estimateTokens,
+	calculateTotalTokens,
+	compactContext,
+	generateResumePrompt,
+	formatResumeMarkdown,
+} from "../src/index.js";
+
+const makeItem = (
+	overrides?: Partial<import("../src/index.js").ContextItem>,
+): import("../src/index.js").ContextItem => ({
+	id: `item-${Math.random().toString(36).slice(2)}`,
+	role: "user",
+	content: "Test content",
+	tokens: 10,
+	priority: 5,
+	timestamp: Date.now(),
+	...overrides,
+});
+
+describe("DEFAULT_POLICY", () => {
+	it("has threshold values", () => {
+		expect(DEFAULT_POLICY.warningThreshold).toBe(0.6);
+		expect(DEFAULT_POLICY.compactThreshold).toBe(0.7);
+		expect(DEFAULT_POLICY.hardStopThreshold).toBe(0.85);
+	});
+});
+
+describe("estimatePressure", () => {
+	it("returns ratio", () => expect(estimatePressure(5000, 10000)).toBe(0.5));
+	it("caps at 1", () => expect(estimatePressure(15000, 10000)).toBe(1));
+	it("handles zero max", () => expect(estimatePressure(100, 0)).toBe(1));
+});
+
+describe("getPressureLevel", () => {
+	it("normal below warning", () =>
+		expect(getPressureLevel(0.3)).toBe("normal"));
+	it("warning above warningThreshold", () =>
+		expect(getPressureLevel(0.65)).toBe("warning"));
+	it("compact above compactThreshold", () =>
+		expect(getPressureLevel(0.75)).toBe("compact"));
+	it("hard_stop above hardStopThreshold", () =>
+		expect(getPressureLevel(0.9)).toBe("hard_stop"));
+	it("uses custom policy", () => {
+		const custom = {
+			warningThreshold: 0.1,
+			compactThreshold: 0.2,
+			hardStopThreshold: 0.3,
+		};
+		expect(getPressureLevel(0.25, custom)).toBe("compact");
+	});
+});
+
+describe("createSessionScope", () => {
+	it("creates with defaults", () => {
+		const scope = createSessionScope("session-1");
+		expect(scope.id).toBe("session-1");
+		expect(scope.items).toEqual([]);
+		expect(scope.ttlMs).toBe(30 * 60 * 1000);
+		expect(scope.createdAt).toBeGreaterThan(0);
+	});
+});
+
+describe("setTTL", () => {
+	it("updates ttl", () => {
+		const scope = createSessionScope("s1");
+		const updated = setTTL(scope, 60_000);
+		expect(updated.ttlMs).toBe(60_000);
+		expect(updated.id).toBe("s1");
+	});
+});
+
+describe("addToScope", () => {
+	it("appends item", () => {
+		const scope = createSessionScope("s1");
+		const item = makeItem({ id: "i1" });
+		const updated = addToScope(scope, item);
+		expect(updated.items).toHaveLength(1);
+		expect(updated.items[0].id).toBe("i1");
+	});
+});
+
+describe("evictExpired", () => {
+	it("removes expired items", () => {
+		const scope = createSessionScope("s1");
+		const item1 = makeItem({ id: "i1", expiresAt: Date.now() + 10000 });
+		const item2 = makeItem({ id: "i2", expiresAt: Date.now() - 1000 });
+		const updated = addToScope(addToScope(scope, item1), item2);
+		const evicted = evictExpired(updated);
+		expect(evicted.items.map((i) => i.id)).toEqual(["i1"]);
+	});
+
+	it("keeps items without expiry", () => {
+		const scope = createSessionScope("s1");
+		const item = makeItem({ id: "i1" });
+		const updated = addToScope(scope, item);
+		expect(evictExpired(updated).items).toHaveLength(1);
+	});
+});
+
+describe("prioritize", () => {
+	it("sorts by priority ascending", () => {
+		const items = [
+			makeItem({ id: "low", priority: 9 }),
+			makeItem({ id: "high", priority: 1 }),
+			makeItem({ id: "mid", priority: 5 }),
+		];
+		const sorted = prioritize(items);
+		expect(sorted.map((i) => i.id)).toEqual(["high", "mid", "low"]);
+	});
+
+	it("respects limit", () => {
+		const items = [
+			makeItem({ id: "a", priority: 3 }),
+			makeItem({ id: "b", priority: 1 }),
+			makeItem({ id: "c", priority: 2 }),
+		];
+		expect(prioritize(items, 2)).toHaveLength(2);
+	});
+});
+
+describe("estimateTokens", () => {
+	it("counts chars/4", () => expect(estimateTokens("abcdefgh")).toBe(2));
+	it("rounds up", () => expect(estimateTokens("abc")).toBe(1));
+});
+
+describe("calculateTotalTokens", () => {
+	it("sums tokens", () => {
+		const items = [makeItem({ tokens: 10 }), makeItem({ tokens: 20 })];
+		expect(calculateTotalTokens(items)).toBe(30);
+	});
+	it("empty returns 0", () => expect(calculateTotalTokens([])).toBe(0));
+});
+
+describe("compactContext", () => {
+	it("extracts decisions", () => {
+		const items = [makeItem({ content: "DECISION: use tRPC for API" })];
+		const result = compactContext(items, 1000);
+		expect(result.decisions.length).toBeGreaterThan(0);
+	});
+
+	it("extracts questions", () => {
+		const items = [
+			makeItem({
+				content: "Should we use Redis? TODO: decide caching strategy",
+			}),
+		];
+		const result = compactContext(items, 1000);
+		expect(result.openQuestions.length).toBeGreaterThan(0);
+	});
+
+	it("respects maxTokens threshold", () => {
+		const items = [makeItem({ tokens: 100 })];
+		const result = compactContext(items, 50);
+		expect(result.remainingTokens).toBeLessThan(100);
+	});
+});
+
+describe("generateResumePrompt", () => {
+	it("creates prompt from result", () => {
+		const result = compactContext([], 1000);
+		const prompt = generateResumePrompt(result, "Continue with API");
+		expect(prompt.nextAction).toBe("Continue with API");
+		expect(prompt.decisions).toEqual([]);
+	});
+});
+
+describe("formatResumeMarkdown", () => {
+	it("includes headings", () => {
+		const prompt = generateResumePrompt(
+			{
+				decisions: ["Use tRPC"],
+				openQuestions: ["Which DB?"],
+				taskProgress: {},
+				remainingTokens: 100,
+				compactedContent: "",
+			},
+			"Continue",
+		);
+		const md = formatResumeMarkdown(prompt);
+		expect(md).toContain("# Resume Prompt");
+		expect(md).toContain("## Decisions");
+		expect(md).toContain("## Next Action");
+	});
+});

package/packages/context-manager/tsconfig.json

@@ -0,0 +1,6 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": { "outDir": "./dist", "rootDir": "./src", "types": ["node"], "lib": ["ES2022"] },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "test"]
+}

package/packages/cost-optimizer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/cost-optimizer",
-  "version": "0.9.4",
+  "version": "0.9.6",
   "description": "Cost Optimizer for pi-harness-runtime — budget tracking, forecasting, and model selection optimization",
   "type": "module",
   "main": "./dist/index.js",

package/packages/django-plugin/README.md

@@ -0,0 +1 @@
+# django-plugin