pi-harness-runtime 0.10.5 → 0.10.6

package/index.ts

@@ -78,6 +78,17 @@ async function initTodoBdSync(pi: ExtensionAPI): Promise<void> {
 		// todo-bd-sync not available
 	}
 }
+
+// --- config-capture: Auto-detect and document API configuration -------------
+// Lazy import - only loads when packages/config-capture exists
+async function initConfigCapture(pi: ExtensionAPI): Promise<void> {
+	try {
+		const mod = await import("./packages/config-capture/src/index.js");
+		mod.registerConfigCapture(pi, { debug: false });
+	} catch {
+		// config-capture not available
+	}
+}
 import { homedir } from "node:os";
 import { appendFileSync, existsSync, mkdirSync } from "node:fs";
 import { join } from "node:path";
@@ -229,6 +240,9 @@ export default function (pi: ExtensionAPI) {
 	// Start async init but don't await - runs in background
 	void initTodoBdSync(pi);
 
+	// --- config-capture: Auto-detect API config and document it -----------
+	void initConfigCapture(pi);
+
 	// --- Auto-Invoke rpiv-todo via System Prompt ------------------------
 	// This makes the todo overlay ALWAYS activate at session start
 	const AUTO_TODO_INVOKE_HINT = `
@@ -241,11 +255,21 @@ When the user gives you a multi-step task:
 3. When a task is completed, continue to the next or ask the user
 
 The todo overlay persists and helps track progress across your conversation.
+`;
+
+	const COMMIT_BUILD_CHECKLIST = `
+
+BEFORE committing code or triggering builds, ALWAYS check:
+1. Run 'bd ready' to see pending tasks
+2. Mark completed tasks with 'bd close <id> --reason "Done"'
+3. Acknowledge pending tasks before proceeding
+4. Never commit/build without acknowledging pending todos
 `;
 	let firstAgentStart = true;
 	pi.on("before_agent_start", async (event) => {
 		if (firstAgentStart) {
 			event.systemPrompt += AUTO_TODO_INVOKE_HINT;
+			event.systemPrompt += COMMIT_BUILD_CHECKLIST;
 			firstAgentStart = false;
 		}
 	});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-harness-runtime",
-  "version": "0.10.5",
+  "version": "0.10.6",
   "description": "[BETA] Codex-style /usage status + autonomous coding harness for pi. Not production ready — expect breaking changes.",
   "type": "module",
   "scripts": {

package/packages/a2a-adapter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/a2a-adapter",
-  "version": "0.10.5",
+  "version": "0.10.6",
   "type": "module",
   "description": "Google Agent-to-Agent (A2A) protocol adapter for pi-harness",
   "main": "dist/index.js",

package/packages/auth/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/auth",
-  "version": "0.10.5",
+  "version": "0.10.6",
   "description": "pi-harness-runtime — auth",
   "type": "module",
   "main": "./dist/index.js",

package/packages/autonomous-refactor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/autonomous-refactor",
-  "version": "0.10.5",
+  "version": "0.10.6",
   "type": "module",
   "description": "Autonomous refactoring engine",
   "main": "dist/index.js",

package/packages/autonomous-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/autonomous-runtime",
-  "version": "0.10.5",
+  "version": "0.10.6",
   "description": "Autonomous Operations Runtime — task inbox, lease management, and worker lifecycle (RFC-0101)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/cache-strategy/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/cache-strategy",
-  "version": "0.10.5",
+  "version": "0.10.6",
   "type": "module",
   "description": "Smart caching with TTL and invalidation strategies (RFC-0022)",
   "main": "dist/index.js",

package/packages/capability-registry/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/capability-registry",
-  "version": "0.10.5",
+  "version": "0.10.6",
   "description": "Capability Registry for pi-harness-runtime — tracks model capabilities and enables capability-based routing",
   "type": "module",
   "main": "./dist/index.js",

package/packages/checkpoint/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/checkpoint",
-  "version": "0.10.5",
+  "version": "0.10.6",
   "description": "Enhanced checkpoint system with incremental snapshots, diff-based storage, and recovery strategies",
   "type": "module",
   "main": "./dist/index.js",

package/packages/cli-plugin-sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/cli-plugin-sdk",
-  "version": "0.10.5",
+  "version": "0.10.6",
   "type": "module",
   "description": "CLI Plugin SDK for pi-harness — install, list, remove, update, invoke plugins",
   "main": "dist/index.js",

package/packages/clipboard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/clipboard",
-  "version": "0.10.5",
+  "version": "0.10.6",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/code-generation/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/code-generation",
-  "version": "0.10.5",
+  "version": "0.10.6",
   "description": "Code generation pipeline for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/code-review/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/code-review",
-  "version": "0.10.5",
+  "version": "0.10.6",
   "description": "Automated code review engine for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/codex-adapter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/codex-adapter",
-  "version": "0.10.5",
+  "version": "0.10.6",
   "type": "module",
   "description": "OpenAI Codex provider adapter for pi-harness",
   "main": "dist/index.js",

package/packages/config-capture/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@moocoding/config-capture",
+  "version": "0.10.6",
+  "description": "Auto-capture API-fetched configuration values to AGENTS.md",
+  "type": "module",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "exports": {
+    ".": {
+      "import": "./src/index.ts",
+      "types": "./src/index.ts"
+    }
+  },
+  "keywords": [
+    "pi-extension",
+    "config",
+    "documentation",
+    "dns",
+    "routes"
+  ],
+  "author": "MooCoding",
+  "license": "MIT"
+}

package/packages/config-capture/src/index.ts

@@ -0,0 +1,357 @@
+/**
+ * Config Capture Extension
+ *
+ * Automatically detects API responses containing constant configuration values
+ * (DNS records, routes, feature flags, etc.) and logs a suggestion to document
+ * them to AGENTS.md.
+ *
+ * Pattern: Like todo-bd-sync, this listens to tool execution end events
+ * and logs when constant config is detected. The agent decides whether to
+ * document based on context.
+ *
+ * Usage:
+ *   import { registerConfigCapture } from "@moocoding/config-capture";
+ *   registerConfigCapture(pi);
+ */
+
+// ─── Types ────────────────────────────────────────────────────────────────────
+
+export type ConfigType =
+	| "dns_records"
+	| "routes"
+	| "feature_flags"
+	| "environment_config"
+	| "integration_ids"
+	| "webhook_urls"
+	| "redirect_rules"
+	| "unknown";
+
+export interface ConfigDetection {
+	detected: boolean;
+	configType: ConfigType | null;
+	confidence: "high" | "medium" | "low";
+	sampleData?: string;
+}
+
+// ─── Config Type Detection ────────────────────────────────────────────────────
+
+const DNS_PATTERNS = [
+	"zone_id",
+	"zoneId",
+	"dns_record",
+	"dns-record",
+	"cloudflare",
+	"name_servers",
+	"@",
+	"ttl",
+	"proxied",
+	"record_type",
+	" a ",
+	"aaaa",
+	"cname",
+	"txt",
+	"mx",
+	"ns",
+	"spf",
+];
+
+const ROUTE_PATTERNS = [
+	"routes",
+	"endpoints",
+	"api_routes",
+	"api_rout",
+	"path",
+	"method",
+	" get ",
+	" post ",
+	" put ",
+	" delete ",
+	" patch ",
+	"/api/",
+	"route_path",
+];
+
+const FEATURE_FLAG_PATTERNS = [
+	"feature_flags",
+	"feature-flags",
+	"feature_toggle",
+	"feature-toggle",
+	"enabled",
+	"disabled",
+	"rollout",
+	"variants",
+];
+
+const INTEGRATION_PATTERNS = [
+	"integration_id",
+	"integrationId",
+	"webhook_url",
+	"webhookUrl",
+	"webhook_id",
+	"redirect_url",
+	"account_id",
+	"project_id",
+];
+
+// ─── Detection Logic ─────────────────────────────────────────────────────────
+
+/**
+ * Detect if a tool result contains constant configuration data
+ */
+export function detectConfig(result: unknown): ConfigDetection {
+	if (!result || typeof result !== "object") {
+		return { detected: false, configType: null, confidence: "low" };
+	}
+
+	const resultStr = JSON.stringify(result).toLowerCase();
+	const scores: { type: ConfigType; score: number }[] = [
+		{ type: "dns_records", score: countMatches(resultStr, DNS_PATTERNS) },
+		{ type: "routes", score: countMatches(resultStr, ROUTE_PATTERNS) },
+		{ type: "feature_flags", score: countMatches(resultStr, FEATURE_FLAG_PATTERNS) },
+		{ type: "integration_ids", score: countMatches(resultStr, INTEGRATION_PATTERNS) },
+	];
+
+	// Sort by score descending
+	scores.sort((a, b) => b.score - a.score);
+
+	const best = scores[0];
+	if (best.score < 2) {
+		return { detected: false, configType: null, confidence: "low" };
+	}
+
+	// Check for array of objects (typical config structure)
+	const hasArrayOfObjects = detectArrayOfObjects(result);
+
+	let confidence: "high" | "medium" | "low" = "low";
+	if (best.score >= 4 || (best.score >= 2 && hasArrayOfObjects)) {
+		confidence = "high";
+	} else if (best.score >= 2) {
+		confidence = "medium";
+	}
+
+	// Extract sample data for logging
+	const sampleData = extractSampleData(result, best.type);
+
+	return {
+		detected: true,
+		configType: best.type,
+		confidence,
+		sampleData,
+	};
+}
+
+function countMatches(text: string, patterns: string[]): number {
+	return patterns.filter((p) => text.includes(p.toLowerCase())).length;
+}
+
+function detectArrayOfObjects(result: unknown): boolean {
+	if (Array.isArray(result)) {
+		return result.some((item) => typeof item === "object" && item !== null);
+	}
+	if (typeof result === "object" && result !== null) {
+		const values = Object.values(result);
+		return values.some((v) => Array.isArray(v) && v.length > 0 && typeof v[0] === "object");
+	}
+	return false;
+}
+
+function extractSampleData(result: unknown, _type: ConfigType): string | undefined {
+	if (!Array.isArray(result) || result.length === 0) return undefined;
+
+	const sample = result[0];
+	if (typeof sample !== "object" || sample === null) return undefined;
+
+	const entries = Object.entries(sample).slice(0, 5);
+	if (entries.length === 0) return undefined;
+
+	const lines = entries.map(([k, v]) => `${k}: ${JSON.stringify(v)}`);
+	return lines.join(", ");
+}
+
+// ─── Privacy Filter ────────────────────────────────────────────────────────────
+
+const SENSITIVE_PATTERNS = [
+	"token",
+	"secret",
+	"password",
+	"key",
+	"credential",
+	"auth",
+	"api_key",
+	"apiKey",
+	"bearer",
+	"authorization",
+	"private_",
+	"private-",
+];
+
+/**
+ * Check if a field name is sensitive (should not be documented)
+ */
+export function isSensitiveField(fieldName: string): boolean {
+	const lower = fieldName.toLowerCase();
+	return SENSITIVE_PATTERNS.some((p) => lower.includes(p));
+}
+
+/**
+ * Remove sensitive fields from a config object
+ */
+export function removeSensitiveFields<T extends object>(config: T): Partial<T> {
+	const sanitized: Record<string, unknown> = {};
+
+	for (const [key, value] of Object.entries(config)) {
+		if (!isSensitiveField(key)) {
+			sanitized[key] = value;
+		}
+	}
+
+	return sanitized as Partial<T>;
+}
+
+// ─── Format Output ────────────────────────────────────────────────────────────
+
+export type OutputFormat = "markdown" | "json" | "brief";
+
+/**
+ * Format detected config for AGENTS.md
+ */
+export function formatForAgentsMd(
+	detection: ConfigDetection,
+	sampleData?: string,
+): string {
+	const lines: string[] = [];
+
+	switch (detection.configType) {
+		case "dns_records":
+			lines.push("### DNS Records");
+			lines.push("");
+			lines.push("| Name | Type | Content | Notes |");
+			lines.push("|------|------|---------|-------|");
+			lines.push("| ... | ... | ... | ... |");
+			lines.push("");
+			lines.push("*Source: Auto-captured from API*");
+			break;
+
+		case "routes":
+			lines.push("### API Routes");
+			lines.push("");
+			lines.push("- `GET /api/resource` - Description");
+			lines.push("- `POST /api/resource` - Create");
+			lines.push("");
+			lines.push("*Source: Auto-captured from API*");
+			break;
+
+		case "feature_flags":
+			lines.push("### Feature Flags");
+			lines.push("");
+			lines.push("| Flag | Enabled | Notes |");
+			lines.push("|------|---------|-------|");
+			lines.push("| flag_name | true/false | ... |");
+			lines.push("");
+			lines.push("*Source: Auto-captured from API*");
+			break;
+
+		default:
+			lines.push("### Configuration");
+			lines.push("");
+			if (sampleData) {
+				lines.push("```");
+				lines.push(sampleData);
+				lines.push("```");
+			}
+			lines.push("");
+			lines.push("*Source: Auto-captured from API*");
+	}
+
+	return lines.join("\n");
+}
+
+// ─── Extension Registration ────────────────────────────────────────────────────
+
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+// Type for tool_execution_end event
+interface ToolExecutionEndEvent {
+	type: "tool_execution_end";
+	toolCallId: string;
+	toolName: string;
+	result: unknown;
+	isError: boolean;
+}
+
+interface ConfigCaptureConfig {
+	/** Enable debug logging */
+	debug?: boolean;
+	/** Minimum confidence to trigger capture */
+	minConfidence?: "high" | "medium" | "low";
+}
+
+const DEFAULT_CONFIG = {
+	debug: false,
+	minConfidence: "medium" as const,
+};
+
+/**
+ * Register the config-capture extension
+ */
+export function registerConfigCapture(
+	pi: ExtensionAPI,
+	config: ConfigCaptureConfig = {},
+): void {
+	const cfg = { ...DEFAULT_CONFIG, ...config };
+
+	// Track if we've already suggested documenting this config in this session
+	const documentedConfigs = new Set<string>();
+
+	// Listen to tool execution end
+	pi.on("tool_execution_end", (event: ToolExecutionEndEvent) => {
+		// Skip errors
+		if (event.isError) return;
+
+		// Skip non-API tools (focus on bash/curl/http calls)
+		const apiTools = ["bash", "http_request", "fetch", "curl"];
+		if (!apiTools.includes(event.toolName)) return;
+
+		// Detect config in result
+		const detection = detectConfig(event.result);
+
+		if (!detection.detected) return;
+
+		// Check confidence threshold
+		const confidenceLevels = { low: 0, medium: 1, high: 2 };
+		const minLevel = confidenceLevels[cfg.minConfidence!];
+		const currentLevel = confidenceLevels[detection.confidence];
+
+		if (currentLevel < minLevel) return;
+
+		// Create a unique key for this config type + rough content hash
+		const contentStr = JSON.stringify(event.result).slice(0, 100);
+		const configKey = `${detection.configType}-${contentStr}`;
+
+		// Skip if already suggested in this session
+		if (documentedConfigs.has(configKey)) return;
+
+		// Log detection
+		if (cfg.debug) {
+			console.log(`[config-capture] Detected ${detection.configType} (${detection.confidence})`);
+			console.log(`[config-capture] Sample: ${detection.sampleData}`);
+		}
+
+		// Mark as documented
+		documentedConfigs.add(configKey);
+
+		// Log the suggestion - agent will notice this
+		console.log(`[config-capture] Config detected: ${detection.configType}`);
+		console.log(`[config-capture] Confidence: ${detection.confidence}`);
+		console.log(`[config-capture] Sample: ${detection.sampleData?.slice(0, 200)}`);
+
+		// Suggest action
+		const actionMsg = `[config-capture] Consider documenting this to AGENTS.md section "Discovered Configuration"`;
+		console.log(actionMsg);
+	});
+
+	console.log("[config-capture] Started - detecting API config responses");
+}
+
+// Default export
+export default registerConfigCapture;

package/packages/context-compiler/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/context-compiler",
-  "version": "0.10.5",
+  "version": "0.10.6",
   "description": "Bounded context selection engine for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/context-discovery/package.json

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

package/packages/context-manager/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/context-manager",
-  "version": "0.10.5",
+  "version": "0.10.6",
   "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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/cookie-sanitizer",
-  "version": "0.10.5",
+  "version": "0.10.6",
   "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.10.5",
+  "version": "0.10.6",
   "description": "Cost Optimizer for pi-harness-runtime — budget tracking, forecasting, and model selection optimization",
   "type": "module",
   "main": "./dist/index.js",

package/packages/dependency-analyzer/package.json

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

package/packages/django-plugin/package.json

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

package/packages/doc-generator/package.json

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

package/packages/evaluation-engine/package.json

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

package/packages/evaluation-runner/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/evaluation-runner",
-  "version": "0.10.5",
+  "version": "0.10.6",
   "type": "module",
   "description": "Framework-agnostic evaluation framework for AI outputs (RFC-0020)",
   "main": "dist/index.js",

package/packages/event-bus/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/event-bus",
-  "version": "0.10.5",
+  "version": "0.10.6",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/event-store/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/event-store",
-  "version": "0.10.5",
+  "version": "0.10.6",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/experience-replay/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/experience-replay",
-  "version": "0.10.5",
+  "version": "0.10.6",
   "description": "Experience replay for debugging and reproducibility (RFC-0059)",
   "type": "module",
   "main": "./dist/index.js",