pi-harness-runtime 0.9.25 → 0.10.0

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

@@ -5,7 +5,7 @@
  * Every selected item has a source reference; every omitted item has a reason.
  */
 
-// ─── Context candidate kinds ───────────────────────────────────────────
+// --- Context candidate kinds -------------------------------------------
 
 /**
  * Kinds of context that can be collected.
@@ -24,7 +24,7 @@ export type ContextKind =
  */
 export type ContextTrust = "authoritative" | "generated" | "unverified";
 
-// ─── Candidate ────────────────────────────────────────────────────────
+// --- Candidate --------------------------------------------------------
 
 /**
  * A raw context candidate from a source collector.
@@ -49,7 +49,7 @@ export interface ContextCandidate {
 	symbols?: string[];
 }
 
-// ─── Omission ─────────────────────────────────────────────────────────
+// --- Omission ---------------------------------------------------------
 
 /**
  * Reasons why a candidate was omitted.
@@ -76,7 +76,7 @@ export interface OmittedItem {
 	deniedBy?: string;
 }
 
-// ─── Compiled item ────────────────────────────────────────────────────
+// --- Compiled item ----------------------------------------------------
 
 /**
  * An item that made it into the final compiled context.
@@ -97,7 +97,7 @@ export interface CompiledContextItem {
 	symbols?: string[];
 }
 
-// ─── Source graph ─────────────────────────────────────────────────────
+// --- Source graph -----------------------------------------------------
 
 /**
  * An edge in the context source graph.
@@ -109,7 +109,7 @@ export interface ContextSourceEdge {
 	weight: number;
 }
 
-// ─── Compiled context ──────────────────────────────────────────────────
+// --- Compiled context --------------------------------------------------
 
 /**
  * The final compiled context output.
@@ -125,7 +125,7 @@ export interface CompiledContext {
 	mapping: Record<string, string>;
 }
 
-// ─── Scoring ─────────────────────────────────────────────────────────
+// --- Scoring ---------------------------------------------------------
 
 /**
  * Scoring weights for context candidates.
@@ -151,7 +151,7 @@ export const DEFAULT_SCORING_WEIGHTS: ScoringWeights = {
 	duplicationPenalty: 8,
 };
 
-// ─── Policy ─────────────────────────────────────────────────────────
+// --- Policy ---------------------------------------------------------
 
 /**
  * Policy rules for context selection.
@@ -183,7 +183,7 @@ export const DEFAULT_POLICY: ContextPolicy = {
 	maxFileBytes: 200_000,
 };
 
-// ─── Compile request ────────────────────────────────────────────────
+// --- Compile request ------------------------------------------------
 
 /**
  * Input to the context compiler.
@@ -199,7 +199,7 @@ export interface ContextCompileRequest {
 	policy?: Partial<ContextPolicy>;
 }
 
-// ─── Invalidation ───────────────────────────────────────────────────
+// --- Invalidation ---------------------------------------------------
 
 /**
  * Reasons for context invalidation.
@@ -218,7 +218,7 @@ export interface ContextInvalidation {
 	details?: Record<string, unknown>;
 }
 
-// ─── Error codes ────────────────────────────────────────────────────
+// --- Error codes ----------------------------------------------------
 
 export type ContextCompileErrorCode =
 	| "MISSING_REQUIRED_SOURCE"

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

@@ -33,7 +33,7 @@ import type {
 	ContextPolicy,
 } from "../src/types.js";
 
-// ─── Test fixtures ───────────────────────────────────────────────────────
+// --- Test fixtures -------------------------------------------------------
 
 function makeCandidate(
 	overrides?: Partial<ContextCandidate>,
@@ -64,7 +64,7 @@ function makeRequest(
 	};
 }
 
-// ─── AC-1: Required project rules always included ────────────────────────
+// --- AC-1: Required project rules always included ------------------------
 
 describe("AC-1: Required project rules always included", () => {
 	it("includes required project_rule even when budget is tiny", async () => {
@@ -111,7 +111,7 @@ describe("AC-1: Required project rules always included", () => {
 	});
 });
 
-// ─── AC-2: .env content denied ──────────────────────────────────────────
+// --- AC-2: .env content denied ------------------------------------------
 
 describe("AC-2: .env content denied by policy", () => {
 	it("denies .env file content", () => {
@@ -161,7 +161,7 @@ describe("AC-2: .env content denied by policy", () => {
 	});
 });
 
-// ─── AC-3: Broken optional OKF link does not fail compilation ─────────────
+// --- AC-3: Broken optional OKF link does not fail compilation -------------
 
 describe("AC-3: Broken optional OKF link does not fail compilation", () => {
 	it("does not throw when optional OKF has no content", async () => {
@@ -189,7 +189,7 @@ describe("AC-3: Broken optional OKF link does not fail compilation", () => {
 	});
 });
 
-// ─── AC-4: Broken required source fails compilation ──────────────────────
+// --- AC-4: Broken required source fails compilation ----------------------
 
 describe("AC-4: Broken required source fails compilation", () => {
 	it("throws MISSING_REQUIRED_SOURCE when required source has no content", async () => {
@@ -227,7 +227,7 @@ describe("AC-4: Broken required source fails compilation", () => {
 	});
 });
 
-// ─── AC-5: Duplicate source slices merged ───────────────────────────────
+// --- AC-5: Duplicate source slices merged -------------------------------
 
 describe("AC-5: Duplicate source slices merged", () => {
 	it("merges slices from the same file", () => {
@@ -319,7 +319,7 @@ describe("AC-5: Duplicate source slices merged", () => {
 	});
 });
 
-// ─── AC-6: Context under token budget ───────────────────────────────────
+// --- AC-6: Context under token budget -----------------------------------
 
 describe("AC-6: Context remains under requested token budget", () => {
 	it("fits within budget when content is small enough", async () => {
@@ -380,7 +380,7 @@ describe("AC-6: Context remains under requested token budget", () => {
 	});
 });
 
-// ─── AC-7: Changed file hash invalidates cache ───────────────────────────
+// --- AC-7: Changed file hash invalidates cache ---------------------------
 
 describe("AC-7: Changed file hash invalidates cache", () => {
 	it("source_hash_changed invalidates when hash differs", () => {
@@ -478,7 +478,7 @@ describe("AC-7: Changed file hash invalidates cache", () => {
 	});
 });
 
-// ─── AC-8: Identical repo state → identical compiled context ─────────────
+// --- AC-8: Identical repo state → identical compiled context -------------
 
 describe("AC-8: Identical repository state produces identical compiled context", () => {
 	it("same candidates produce same cache key", () => {
@@ -550,7 +550,7 @@ describe("AC-8: Identical repository state produces identical compiled context",
 	});
 });
 
-// ─── AC-9: Omitted items include explicit reasons ──────────────────────
+// --- AC-9: Omitted items include explicit reasons ----------------------
 
 describe("AC-9: Omitted items include explicit reasons", () => {
 	it("policy denied items have reason=policy_denied", async () => {
@@ -619,7 +619,7 @@ describe("AC-9: Omitted items include explicit reasons", () => {
 	});
 });
 
-// ─── Additional coverage ─────────────────────────────────────────────────
+// --- Additional coverage -------------------------------------------------
 
 describe("mergePolicy", () => {
 	it("merges user policy with defaults", () => {

package/packages/context-discovery/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/context-discovery",
-  "version": "0.9.24",
+  "version": "0.9.25",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/context-manager/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/context-manager",
-  "version": "0.9.24",
+  "version": "0.9.25",
   "description": "Context Window Manager — prevents model context overflow via compaction and resume prompts (RFC-0010)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/cookie-sanitizer/README.md

@@ -1,20 +1,20 @@
 # @pi-harness/cookie-sanitizer
 
-> Forgiving input → strict canonical cache for provider-quota mirroring.
+> Forgiving input -> strict canonical cache for provider-quota mirroring.
 
 A normalization boundary that lets users drop **any** cookie file (any name, any format) into a known folder, and turns it into a single standard Netscape file the rest of the runtime can rely on.
 
 ```
-~/.pi-harness-runtime/cookies/          ← user drops anything here
-            │
+~/.pi-harness-runtime/cookies/          <-  user drops anything here
+            |
             ▼
-   Cookie Sanitizer                     ← THIS PACKAGE
-            │
+   Cookie Sanitizer                     <-  THIS PACKAGE
+            |
             ▼
-~/.config/<provider>-cookies.txt        ← canonical, runtime-owned
-            │
+~/.config/<provider>-cookies.txt        <-  canonical, runtime-owned
+            |
             ▼
-   MiniMaxQuotaScraper (unchanged)      ← reads only the canonical
+   MiniMaxQuotaScraper (unchanged)      <-  reads only the canonical
 ```
 
 ## Why
@@ -30,8 +30,8 @@ The previous design expected users to know the exact path (`~/.config/minimax-co
 
 **File names** — any name in the drop folder. Inference prefers:
 
-1. Filename hint (`minimax-*.txt`, `*claude*`, etc.) → provider
-2. Dominant cookie domain (≥ 80% match) → provider
+1. Filename hint (`minimax-*.txt`, `*claude*`, etc.) -> provider
+2. Dominant cookie domain (≥ 80% match) -> provider
 3. `providerHint` option overrides all of the above
 
 **Provider scope** — currently shipping with: `minimax`, `anthropic`, `openai`, `glm`, `openrouter`. The registry is open and inference by domain works for any provider whose cookies are in the drop folder.
@@ -46,7 +46,7 @@ import { sync } from "@pi-harness/cookie-sanitizer";
 const result = sync();
 
 if (result.wrote) {
-  console.log(`Synced ${result.totalCookies} cookies for ${result.provider} → ${result.cachePath}`);
+  console.log(`Synced ${result.totalCookies} cookies for ${result.provider} -> ${result.cachePath}`);
 } else {
   console.log(`No-op: ${result.errors[0]?.message ?? "nothing to sync"}`);
 }
@@ -60,7 +60,7 @@ import { CookieWatcher } from "@pi-harness/cookie-sanitizer";
 const watcher = new CookieWatcher({
   dropDir: "~/.pi-harness-runtime/cookies",
   onEvent: (e) => {
-    if (e.kind === "sync-ok") console.log(`Synced ${e.cookies} cookies → ${e.cachePath}`);
+    if (e.kind === "sync-ok") console.log(`Synced ${e.cookies} cookies -> ${e.cachePath}`);
     if (e.kind === "sync-error") console.error(`Sync error: ${e.message}`);
   },
 });
@@ -115,23 +115,23 @@ bun test test/sync.test.ts
 
 ```
 src/
-├── index.ts            # public API surface
-├── types.ts            # canonical types
-├── detect-format.ts    # Netscape vs JSON detection
-├── parse-netscape.ts   # Netscape parser + serializer
-├── parse-json.ts       # EditThisCookie JSON parser
-├── normalize.ts        # dedupe, expire, domain-match
-├── infer-provider.ts   # filename + domain inference
-├── atomic-write.ts     # POSIX atomic write
-├── sync.ts             # orchestrator
-└── watcher.ts          # chokidar v5 wrapper
++-- index.ts            # public API surface
++-- types.ts            # canonical types
++-- detect-format.ts    # Netscape vs JSON detection
++-- parse-netscape.ts   # Netscape parser + serializer
++-- parse-json.ts       # EditThisCookie JSON parser
++-- normalize.ts        # dedupe, expire, domain-match
++-- infer-provider.ts   # filename + domain inference
++-- atomic-write.ts     # POSIX atomic write
++-- sync.ts             # orchestrator
++-- watcher.ts          # chokidar v5 wrapper
 
 test/
-├── parse.test.ts       # 14 cases — Netscape + JSON
-├── normalize.test.ts   # 12 cases — dedupe/expire/domain
-├── infer.test.ts       # 13 cases — filename + domain + combined
-├── sync.test.ts        # 12 cases — end-to-end
-└── watcher.test.ts     # 2 cases — config sanity (chokidar is exercised live)
++-- parse.test.ts       # 14 cases — Netscape + JSON
++-- normalize.test.ts   # 12 cases — dedupe/expire/domain
++-- infer.test.ts       # 13 cases — filename + domain + combined
++-- sync.test.ts        # 12 cases — end-to-end
++-- watcher.test.ts     # 2 cases — config sanity (chokidar is exercised live)
 ```
 
 ## Limitations

package/packages/cookie-sanitizer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/cookie-sanitizer",
-  "version": "0.9.24",
+  "version": "0.9.25",
   "description": "pi-harness-runtime — cookie sanitizer (provider-quota cookie file normaliser)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/cost-optimizer/package.json

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

package/packages/cost-optimizer/src/types.ts

@@ -5,7 +5,7 @@
 // Re-export Currency type
 export type Currency = "USD" | "THB";
 
-// ─── Cost Entry Types ─────────────────────────────────────────────────
+// --- Cost Entry Types -------------------------------------------------
 
 export interface CostEntry {
 	id: string;
@@ -20,7 +20,7 @@ export interface CostEntry {
 	timestamp: string;
 }
 
-// ─── Budget Types ─────────────────────────────────────────────────────
+// --- Budget Types -----------------------------------------------------
 
 export interface CostBudget {
 	daily?: number;
@@ -53,7 +53,7 @@ export interface CostPeriod {
 	type: "day" | "week" | "month" | "custom";
 }
 
-// ─── Optimization Types ────────────────────────────────────────────────
+// --- Optimization Types ------------------------------------------------
 
 export interface CostOptimizerConfig {
 	defaultBudget: CostBudget;
@@ -99,7 +99,7 @@ export interface OptimizedSelection {
 	tradeoffs: string[];
 }
 
-// ─── Optimizer Interface ─────────────────────────────────────────────
+// --- Optimizer Interface ---------------------------------------------
 
 export interface CostOptimizer {
 	trackCost(entry: Omit<CostEntry, "id" | "timestamp">): CostEntry;
@@ -118,7 +118,7 @@ export interface CostOptimizer {
 	): OptimizedSelection[];
 }
 
-// ─── Event Types ─────────────────────────────────────────────────────
+// --- Event Types -----------------------------------------------------
 
 export type CostOptimizerEvent =
 	| { type: "cost.tracked"; entryId: string; cost: number; total: number }

package/packages/dependency-analyzer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/dependency-analyzer",
-  "version": "0.9.24",
+  "version": "0.9.25",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/django-plugin/dist/analyzer.js

@@ -6,7 +6,7 @@
 import { existsSync } from "node:fs";
 import { readdir, readFile } from "node:fs/promises";
 import { join } from "node:path";
-// ─── Detection ───────────────────────────────────────────────────────────────
+// --- Detection ---------------------------------------------------------------
 function isDjangoWorkspace(root) {
     return (existsSync(join(root, "manage.py")) ||
         (existsSync(join(root, "settings.py")) &&
@@ -14,7 +14,7 @@ function isDjangoWorkspace(root) {
         (existsSync(join(root, "requirements.txt")) &&
             existsSync(join(root, "manage.py"))));
 }
-// ─── Version ────────────────────────────────────────────────────────────────
+// --- Version ----------------------------------------------------------------
 async function detectVersion(root) {
     try {
         const content = await readFile(join(root, "requirements.txt"), "utf-8");
@@ -42,7 +42,7 @@ async function detectVersion(root) {
     }
     return undefined;
 }
-// ─── Settings Parser ─────────────────────────────────────────────────────────
+// --- Settings Parser ---------------------------------------------------------
 async function parseSettings(root) {
     const installedApps = [];
     const middleware = [];
@@ -90,7 +90,7 @@ async function parseSettings(root) {
     }
     return { installedApps, middleware };
 }
-// ─── Django App Scanner ─────────────────────────────────────────────────────
+// --- Django App Scanner -----------------------------------------------------
 async function scanDjangoApps(root) {
     const apps = [];
     // Django project apps can be:
@@ -153,7 +153,7 @@ async function scanDjangoApps(root) {
     }
     return apps;
 }
-// ─── Management Commands ────────────────────────────────────────────────────
+// --- Management Commands ----------------------------------------------------
 async function findManagementCommands(root) {
     const commands = [];
     // Simple recursive scan for management/commands directories
@@ -191,7 +191,7 @@ async function findManagementCommands(root) {
     }
     return [...new Set(commands)];
 }
-// ─── Requirements ───────────────────────────────────────────────────────────
+// --- Requirements -----------------------------------------------------------
 async function parseRequirements(root) {
     const reqPath = join(root, "requirements.txt");
     if (!existsSync(reqPath))
@@ -208,7 +208,7 @@ async function parseRequirements(root) {
         return [];
     }
 }
-// ─── Main Analyzer ─────────────────────────────────────────────────────────
+// --- Main Analyzer ---------------------------------------------------------
 export async function analyzeDjango(root) {
     if (!isDjangoWorkspace(root))
         return null;

package/packages/django-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/django-plugin",
-  "version": "0.9.24",
+  "version": "0.9.25",
   "description": "Django framework analysis — models, management commands, settings",
   "type": "module",
   "main": "./dist/index.js",

package/packages/django-plugin/src/analyzer.ts

@@ -9,7 +9,7 @@ import { readdir, readFile } from "node:fs/promises";
 import { join } from "node:path";
 import type { DjangoAnalysis, DjangoApp, ConfigFile } from "./types.js";
 
-// ─── Detection ───────────────────────────────────────────────────────────────
+// --- Detection ---------------------------------------------------------------
 
 function isDjangoWorkspace(root: string): boolean {
 	return (
@@ -21,7 +21,7 @@ function isDjangoWorkspace(root: string): boolean {
 	);
 }
 
-// ─── Version ────────────────────────────────────────────────────────────────
+// --- Version ----------------------------------------------------------------
 
 async function detectVersion(root: string): Promise<string | undefined> {
 	try {
@@ -48,7 +48,7 @@ async function detectVersion(root: string): Promise<string | undefined> {
 	return undefined;
 }
 
-// ─── Settings Parser ─────────────────────────────────────────────────────────
+// --- Settings Parser ---------------------------------------------------------
 
 async function parseSettings(root: string): Promise<{
 	installedApps: string[];
@@ -110,7 +110,7 @@ async function parseSettings(root: string): Promise<{
 	return { installedApps, middleware };
 }
 
-// ─── Django App Scanner ─────────────────────────────────────────────────────
+// --- Django App Scanner -----------------------------------------------------
 
 async function scanDjangoApps(root: string): Promise<DjangoApp[]> {
 	const apps: DjangoApp[] = [];
@@ -180,7 +180,7 @@ async function scanDjangoApps(root: string): Promise<DjangoApp[]> {
 	return apps;
 }
 
-// ─── Management Commands ────────────────────────────────────────────────────
+// --- Management Commands ----------------------------------------------------
 
 async function findManagementCommands(root: string): Promise<string[]> {
 	const commands: string[] = [];
@@ -219,7 +219,7 @@ async function findManagementCommands(root: string): Promise<string[]> {
 	return [...new Set(commands)];
 }
 
-// ─── Requirements ───────────────────────────────────────────────────────────
+// --- Requirements -----------------------------------------------------------
 
 async function parseRequirements(root: string): Promise<string[]> {
 	const reqPath = join(root, "requirements.txt");
@@ -237,7 +237,7 @@ async function parseRequirements(root: string): Promise<string[]> {
 	}
 }
 
-// ─── Main Analyzer ─────────────────────────────────────────────────────────
+// --- Main Analyzer ---------------------------------------------------------
 
 export async function analyzeDjango(
 	root: string,

package/packages/doc-generator/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/doc-generator",
-  "version": "0.9.24",
+  "version": "0.9.25",
   "description": "Auto-Doc Generator — generate documentation from source code (RFC-0014)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/evaluation-engine/dist/engine.js

@@ -5,7 +5,7 @@
  */
 import { randomUUID } from "node:crypto";
 import { DEFAULT_SCORING_WEIGHTS } from "./types.js";
-// ─── Evidence Collection ───────────────────────────────────────────────────────
+// --- Evidence Collection -------------------------------------------------------
 function collectEvidence(outputs, testResults, policyFindings) {
     const evidence = [];
     // Add test results as evidence
@@ -38,7 +38,7 @@ function collectEvidence(outputs, testResults, policyFindings) {
     }
     return evidence;
 }
-// ─── Missing Output Detection ──────────────────────────────────────────────────
+// --- Missing Output Detection --------------------------------------------------
 function findMissingOutputs(requiredArtifacts, outputs) {
     const findings = [];
     const outputPaths = new Set(outputs.filter((o) => o.path).map((o) => o.path));
@@ -57,7 +57,7 @@ function findMissingOutputs(requiredArtifacts, outputs) {
     }
     return findings;
 }
-// ─── Test Analysis ────────────────────────────────────────────────────────────
+// --- Test Analysis ------------------------------------------------------------
 function analyzeTests(testResults) {
     const findings = [];
     let passedCount = 0;
@@ -87,7 +87,7 @@ function analyzeTests(testResults) {
     }
     return { findings, passedCount, totalCount, hasFailures };
 }
-// ─── Policy Analysis ──────────────────────────────────────────────────────────
+// --- Policy Analysis ----------------------------------------------------------
 function analyzePolicies(policyFindings) {
     const findings = [];
     const criticalFindings = [];
@@ -106,7 +106,7 @@ function analyzePolicies(policyFindings) {
     }
     return { findings, criticalFindings };
 }
-// ─── Acceptance Criteria Coverage ─────────────────────────────────────────────
+// --- Acceptance Criteria Coverage ---------------------------------------------
 function analyzeAcceptanceCoverage(acceptanceCriteria, outputs, testResults) {
     const findings = [];
     const coveredCriteria = [];
@@ -148,7 +148,7 @@ function analyzeAcceptanceCoverage(acceptanceCriteria, outputs, testResults) {
         : 100;
     return { findings, coverage, unmetCriteria };
 }
-// ─── Scoring ─────────────────────────────────────────────────────────────────
+// --- Scoring -----------------------------------------------------------------
 function calculateScore(weights, testAnalysis, acceptanceCoverage, criticalPolicies, securityFindings, regressionFindings) {
     const breakdown = {};
     // Correctness (30%) - based on missing outputs
@@ -188,7 +188,7 @@ function calculateScore(weights, testAnalysis, acceptanceCoverage, criticalPolic
         regressionPenalty));
     return { score: Math.round(totalScore), breakdown };
 }
-// ─── Failure Classification ───────────────────────────────────────────────────
+// --- Failure Classification ---------------------------------------------------
 function classifyFailure(findings) {
     const classes = [];
     for (const finding of findings) {
@@ -226,7 +226,7 @@ function classifyFailure(findings) {
     }
     return classes;
 }
-// ─── Main Engine ───────────────────────────────────────────────────────────────
+// --- Main Engine ---------------------------------------------------------------
 export class EvaluationEngine {
     weights;
     state = "pending";
@@ -337,7 +337,7 @@ export class EvaluationEngine {
         this.state = "pending";
     }
 }
-// ─── Factory ─────────────────────────────────────────────────────────────────
+// --- Factory -----------------------------------------------------------------
 export function createEvaluationEngine(weights) {
     return new EvaluationEngine(weights);
 }

package/packages/evaluation-engine/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/evaluation-engine",
-  "version": "0.9.24",
+  "version": "0.9.25",
   "description": "Evaluation engine for pi-harness runtime (RFC-0057)",
   "type": "module",
   "main": "./dist/index.js",