pi-harness-runtime 0.4.0 → 0.6.3-beta.12

package/CHANGELOG.md

@@ -4,7 +4,6 @@ All notable changes to this project will be documented in this file. See [standa
 
 ## [0.4.0](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.3.1...v0.4.0) (2026-07-05)
 
-
 ### Features
 
 * **auth:** Add curator-mode MiniMax browser authentication ([4914517](https://github.com/ManotLuijiu/pi-harness-runtime/commit/49145171d0205e78454472f5f4e540ff7c70a711))
@@ -13,7 +12,6 @@ All notable changes to this project will be documented in this file. See [standa
 * Fixed Chrome ([98becb8](https://github.com/ManotLuijiu/pi-harness-runtime/commit/98becb8bed6b94612db648d4bdd58f8a45d23040))
 * implement RFC-0019 through RFC-0022 ([4468dcb](https://github.com/ManotLuijiu/pi-harness-runtime/commit/4468dcb1cfcb320f8eeab50c8ef590de74de979a))
 
-
 ### Bug Fixes
 
 * **auth:** Don't re-navigate after login detection ([133e6d5](https://github.com/ManotLuijiu/pi-harness-runtime/commit/133e6d5ac852cc3048881eb4e28700c3aceca792))
@@ -25,31 +23,30 @@ All notable changes to this project will be documented in this file. See [standa
 
 ### Changed
 
-- **Project rename**: `pi-usage-status` → `pi-harness-runtime`
-  - npm package name: `pi-usage-status` → `pi-harness-runtime`
-  - Repository: `ManotLuijiu/pi-usage-status` → `ManotLuijiu/pi-harness-runtime`
-  - Bundled skill: `usage-status` → `harness-runtime` (file path `skills/usage-status/` → `skills/harness-runtime/`)
-  - Status bar key: `usage-status` → `harness-runtime`
-  - **Data directory unchanged**: still `~/.pi/usage-status/` (preserves existing user data)
-  - **Env var unchanged**: still `PI_USAGE_DIR` (preserves existing user configs)
-  - **Extension symlink unchanged**: still `~/.pi/agent/extensions/pi-usage-status` (repointed to renamed project directory)
-  - Added `"files"` whitelist to `package.json` — publish only the 7 runtime `.ts` files, `skills/`, `package.json`, `README.md`, `CHANGELOG.md`, `LICENSE` (excludes `test/`, `ADR/`, `docs/`, `examples/`, `packages/`, `PRD/`, `RFC/`)
+* **Project rename**: `pi-usage-status` → `pi-harness-runtime`
+  * npm package name: `pi-usage-status` → `pi-harness-runtime`
+  * Repository: `ManotLuijiu/pi-usage-status` → `ManotLuijiu/pi-harness-runtime`
+  * Bundled skill: `usage-status` → `harness-runtime` (file path `skills/usage-status/` → `skills/harness-runtime/`)
+  * Status bar key: `usage-status` → `harness-runtime`
+  * **Data directory unchanged**: still `~/.pi/usage-status/` (preserves existing user data)
+  * **Env var unchanged**: still `PI_USAGE_DIR` (preserves existing user configs)
+  * **Extension symlink unchanged**: still `~/.pi/agent/extensions/pi-usage-status` (repointed to renamed project directory)
+  * Added `"files"` whitelist to `package.json` — publish only the 7 runtime `.ts` files, `skills/`, `package.json`, `README.md`, `CHANGELOG.md`, `LICENSE` (excludes `test/`, `ADR/`, `docs/`, `examples/`, `packages/`, `PRD/`, `RFC/`)
 
 ## [0.1.0] - 2026-06-26
 
 ### Added
 
-- Initial release
-- `/usage` slash command — show Codex-style usage status (model, directory, local tracking, provider mirror)
-- `/usage sync` slash command — open form to manually mirror provider-side quota from console.minimax.io
-- `/usage today` / `/usage week` / `/usage reset` focused views
-- Local SQLite tracking of every assistant message (input/output tokens + cost)
-- Manual provider-mirror JSON at `~/.pi/usage-status/mirror.json` (synced_at, 5h_used_pct, 5h_resets_at, weekly_used_pct, weekly_resets_at)
-- Rolling 5h window aggregation (auto-computed from local data)
-- Rolling weekly window aggregation
-- Reset-time computation (`oldest_request_in_window + window_duration`)
-- Progress bar renderer matching Codex's `[████████░░░░░░░░░░░░]` style
-- Local-vs-mirror divergence detection (warns if local tracking diverges from manual mirror by >5%)
-- Burn-rate projection ("Weekly burn rate: 11.4% / day")
-- Bundled skill `usage-status` (loaded automatically)
-- MIT license
+* Initial release
+* `/usage` slash command — show Codex-style usage status (model, directory, local tracking, provider mirror)
+* `/usage today` / `/usage week` / `/usage reset` focused views
+* Local SQLite tracking of every assistant message (input/output tokens + cost)
+* Provider-mirror JSON at `~/.pi/usage-status/mirror.json` (synced_at, 5h_used_pct, 5h_resets_at, weekly_used_pct, weekly_resets_at)
+* Rolling 5h window aggregation (auto-computed from local data)
+* Rolling weekly window aggregation
+* Reset-time computation (`oldest_request_in_window + window_duration`)
+* Progress bar renderer matching Codex's `[████████░░░░░░░░░░░░]` style
+* Local-vs-mirror divergence detection (warns if local tracking diverges from provider mirror by >5%)
+* Burn-rate projection ("Weekly burn rate: 11.4% / day")
+* Bundled skill `usage-status` (loaded automatically)
+* MIT license

package/README.md

@@ -30,11 +30,11 @@ Requires Pi v0.37.3+.
 ## Usage Commands
 
 ```bash
-/usage           # show full status (local tracking + provider mirror)
-/usage sync      # mirror provider quota from console.minimax.io
-/usage today     # today's usage + 5h window
-/usage week      # this week's usage + lifetime totals
-/usage reset     # clear provider mirror
+/usage              # show full status (local tracking + provider mirror)
+/usage refresh     # force refresh quota from MiniMax console
+/usage today       # today's usage + 5h window
+/usage week        # this week's usage + lifetime totals
+/usage reset       # clear provider mirror
 ```
 
 ## Harness Commands
@@ -134,16 +134,47 @@ All data stored locally in `~/.pi/`:
 ├── usage-status/         # /usage data
 │   ├── usage.jsonl
 │   └── mirror.json
-└── harness/            # /harness data
-    └── jobs/
-        └── <job-id>/
-            ├── checkpoint.json
-            ├── events.jsonl
-            ├── task-graph.json
-            ├── blackboard/
-            └── repair-tasks.jsonl
+├── harness/            # /harness data
+│   └── jobs/
+│       └── <job-id>/
+│           ├── checkpoint.json
+│           ├── events.jsonl
+│           ├── task-graph.json
+│           ├── blackboard/
+│           └── repair-tasks.jsonl
+└── okf/               # (optional) Your custom OKF knowledge
 ```
 
+## Custom OKF Knowledge (Optional)
+
+Create `~/.pi/okf/` to add your custom knowledge that the runtime reads during context compilation:
+
+```
+~/.pi/okf/
+├── <skill-name>.md      # Your custom skill/procedure
+├── <domain>.md          # Domain-specific knowledge
+└── <project>.md        # Project-specific rules
+```
+
+The runtime automatically detects and reads these files. If the folder doesn't exist, compilation proceeds without them.
+
+**Example:**
+
+```markdown
+# my-custom-skill
+
+## When to use
+
+This skill applies when...
+
+## Procedure
+
+1. Step one
+2. Step two
+```
+
+See `packages/context-compiler/` for how OKF concepts are loaded.
+
 ## Safety Properties
 
 - ✅ **Local-first**: All data stays on disk
@@ -158,14 +189,35 @@ All data stored locally in `~/.pi/`:
 bun test   # 131+ tests passing
 ```
 
+## Automatic Quota Fetching
+
+Quota data is automatically fetched from MiniMax console every 5 minutes:
+
+1. **Setup cookies** (one-time):
+
+   ```bash
+   # Install EditThisCookie Chrome extension
+   # Go to platform.minimax.io
+   # Export cookies → Netscape format
+   # Save to ~/.config/minimax-cookies.txt
+   ```
+
+2. **Environment** (optional):
+
+   ```bash
+   export QUOTA_COOKIE_FILE=~/.config/minimax-cookies.txt
+   ```
+
+3. **Done!** Quota auto-refreshes every 5 minutes
+
 ## Roadmap
 
 - [x] Core harness infrastructure (job state machine, task graph)
 - [x] Master planner
 - [x] Repair engine
 - [x] Shared blackboard
+- [x] MiniMax Web automatic quota detection
 - [ ] E2E test engine integration
-- [ ] MiniMax Web automatic quota detection
 - [ ] Claude adapter
 - [ ] Production stress testing
 

package/harness/auto-compact.ts

@@ -4,6 +4,11 @@
  * Automatically resume work after model/session compaction without requiring
  * human intervention. Keeps the human out of the message-bus role.
  *
+ * This module integrates with:
+ * - `continue-prompt.ts` for prompt generation
+ * - `context-compact-orchestrator.ts` for compact decisions
+ * - `partial-recovery.ts` for artifact persistence
+ *
  * Artifact Layout:
  *   harness/context/
  *     compaction_events.jsonl
@@ -20,6 +25,10 @@ import {
 } from "node:fs";
 import { join } from "node:path";
 import { homedir } from "node:os";
+import {
+	continuePromptGenerator,
+	type ContinueContext,
+} from "./continue-prompt.js";
 
 export interface CompactionEvent {
 	timestamp: string;
@@ -37,15 +46,7 @@ export interface CompactionConfig {
 	rootDir?: string;
 	maxContinueAttempts?: number;
 	continuationBackoffMs?: number;
-}
-
-export interface ContinuePrompt {
-	taskId: string;
-	originalRequirement: string;
-	whatWasCompleted: string;
-	whatNeedsToBeDone: string;
-	partialFiles: string[];
-	nextSteps: string;
+	requirement?: string;
 }
 
 const COMPACTION_PATTERNS = [
@@ -55,6 +56,7 @@ const COMPACTION_PATTERNS = [
 	/error.*output.*token.*limit/i,
 	/context.*truncated/i,
 	/session.*compact/i,
+	/\[Earlier conversation summarized\]/i,
 ];
 
 const CONTINUE_MARKERS = [
@@ -63,13 +65,14 @@ const CONTINUE_MARKERS = [
 	/type.*continue/i,
 	/\[continue\]/i,
 	/waiting for your response/i,
+	/do not repeat work already completed/i,
 ];
 
 export class AutoCompactEngine {
 	private readonly rootDir: string;
 	private readonly jobId: string;
+	private readonly requirement: string;
 	private readonly maxAttempts: number;
-	private readonly backoffMs: number;
 	private continueAttempts = 0;
 
 	constructor(config: CompactionConfig) {
@@ -77,8 +80,8 @@ export class AutoCompactEngine {
 			config.rootDir ??
 			join(homedir(), ".pi", "harness", config.jobId, "context");
 		this.jobId = config.jobId;
+		this.requirement = config.requirement ?? "";
 		this.maxAttempts = config.maxContinueAttempts ?? 5;
-		this.backoffMs = config.continuationBackoffMs ?? 1000;
 	}
 
 	/**
@@ -99,7 +102,6 @@ export class AutoCompactEngine {
 	 * Parse compaction details from output
 	 */
 	parseCompactionEvent(output: string, taskId: string): CompactionEvent | null {
-		const lines = output.split("\n");
 		let compactedFromTokens = 0;
 		let reason = "unknown";
 		let errorMessage: string | undefined;
@@ -119,6 +121,8 @@ export class AutoCompactEngine {
 			reason = "context_truncated";
 		} else if (/session.*compact/i.test(output)) {
 			reason = "session_compact";
+		} else if (/\[Earlier conversation summarized\]/i.test(output)) {
+			reason = "context_compact";
 		}
 
 		// Extract error message
@@ -155,29 +159,51 @@ export class AutoCompactEngine {
 	}
 
 	/**
-	 * Generate continue prompt
+	 * Generate continue prompt using ContinuePromptGenerator
 	 */
 	generateContinuePrompt(
 		taskId: string,
-		completedWork: string,
-		remainingWork: string,
-	): ContinuePrompt {
-		const prompt: ContinuePrompt = {
+		completedWork: string[],
+		remainingWork: string[],
+	): string {
+		const context: ContinueContext = {
 			taskId,
-			originalRequirement: this.getRequirement(),
+			requirement: this.requirement || "Continue from previous session",
 			whatWasCompleted: completedWork,
 			whatNeedsToBeDone: remainingWork,
 			partialFiles: this.findPartialFiles(),
-			nextSteps: remainingWork,
+			decisions: [],
 		};
 
+		const prompt = continuePromptGenerator.generate(context);
+
+		// Also save to file for persistence
 		const promptPath = join(this.rootDir, "continue_prompt.md");
-		const promptContent = this.formatContinuePrompt(prompt);
-		writeFileSync(promptPath, promptContent, "utf-8");
+		writeFileSync(promptPath, prompt, "utf-8");
 
 		return prompt;
 	}
 
+	/**
+	 * Generate minimal continue prompt
+	 */
+	generateMinimalContinuePrompt(
+		summary: string,
+		recentContent: string,
+	): string {
+		return [
+			"Continue from where you left off.",
+			"",
+			"## Summary",
+			summary,
+			"",
+			"## Recent Context",
+			recentContent.substring(0, 2000),
+			"",
+			"**Do not repeat work already completed.** Focus on completing the remaining work.",
+		].join("\n");
+	}
+
 	/**
 	 * Check if we should continue (respects max attempts)
 	 */
@@ -212,6 +238,24 @@ export class AutoCompactEngine {
 		return "continue";
 	}
 
+	/**
+	 * Load continue prompt from file
+	 */
+	loadContinuePrompt(): string | null {
+		const promptPath = join(this.rootDir, "continue_prompt.md");
+		if (existsSync(promptPath)) {
+			return readFileSync(promptPath, "utf-8");
+		}
+		return null;
+	}
+
+	/**
+	 * Check if there's a pending continue prompt
+	 */
+	hasContinuePrompt(): boolean {
+		return existsSync(join(this.rootDir, "continue_prompt.md"));
+	}
+
 	// ─── Private Methods ────────────────────────────────────────────────
 
 	private ensureDir(): void {
@@ -249,67 +293,6 @@ Continue attempts: ${this.continueAttempts}/${this.maxAttempts}
 `;
 	}
 
-	private formatContinuePrompt(prompt: ContinuePrompt): string {
-		const lines = [
-			"# Continue Previous Task",
-			"",
-			"## Task Context",
-			"",
-			"**Requirement:** " + prompt.originalRequirement,
-			"",
-			"## What Was Completed",
-			"",
-			prompt.whatWasCompleted ||
-				"Work was in progress when session was compacted.",
-			"",
-		];
-
-		if (prompt.partialFiles.length > 0) {
-			lines.push("## Partial Files Created");
-			lines.push("");
-			for (const file of prompt.partialFiles) {
-				lines.push(`- ${file}`);
-			}
-			lines.push("");
-		}
-
-		lines.push("## What Needs To Be Done");
-		lines.push("");
-		lines.push(
-			prompt.whatNeedsToBeDone || "Continue the task from where it left off.",
-		);
-		lines.push("");
-		lines.push("## Instructions");
-		lines.push("");
-		lines.push("1. Review any partial files created");
-		lines.push("2. Continue from where the previous session ended");
-		lines.push("3. Complete the remaining work");
-		lines.push("4. Ensure all tests pass");
-		lines.push("");
-		lines.push("**Do not repeat work that was already completed.**");
-
-		return lines.join("\n");
-	}
-
-	private getRequirement(): string {
-		const checkpointPath = join(
-			homedir(),
-			".pi",
-			"harness",
-			this.jobId,
-			"checkpoint.json",
-		);
-		if (existsSync(checkpointPath)) {
-			try {
-				const checkpoint = JSON.parse(readFileSync(checkpointPath, "utf-8"));
-				return checkpoint.requirement ?? "Unknown requirement";
-			} catch {
-				return "Unknown requirement";
-			}
-		}
-		return "Unknown requirement";
-	}
-
 	private findPartialFiles(): string[] {
 		const partialDir = join(this.rootDir, "..", "partial", this.jobId);
 		if (!existsSync(partialDir)) {