pi-harness-runtime 0.10.7 → 0.10.12

package/CHANGELOG.md

@@ -2,27 +2,34 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
-### [0.10.1](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.9.24...v0.10.1) (2026-07-31)
+### [0.10.11](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.10.9...v0.10.11) (2026-08-03)
 
 
 ### Features
 
-* blackboard-coordinated loop controller with early exit ([f3cf3ea](https://github.com/ManotLuijiu/pi-harness-runtime/commit/f3cf3ea479170dd75b7e9a7c3515dde230bb0da7))
-* herdr inter-agent event bus for autonomous code review ([1490cdd](https://github.com/ManotLuijiu/pi-harness-runtime/commit/1490cddec80dac812065c3c681984524ad3194e1))
-* loop controller for write-review cycles with early exit ([95066ce](https://github.com/ManotLuijiu/pi-harness-runtime/commit/95066ce8cb58c55eaa14d69fd826b5aaff680c16))
-* release adapters, stale reminder fix, tests, and bug fixes ([5fe5a26](https://github.com/ManotLuijiu/pi-harness-runtime/commit/5fe5a260e0d9a005965b43e4973cbe04a371b85e))
-
-
-### Bug Fixes
-
-* **clipboard:** pass UTF-8 bytes directly to xclip via stdin, avoid pipeline corruption ([051ca18](https://github.com/ManotLuijiu/pi-harness-runtime/commit/051ca18fb1deb1169a8a4da16aa9314d2e6ec66d))
-* disable todo-bd auto-reminder (Phase 1 containment) ([e1b16c1](https://github.com/ManotLuijiu/pi-harness-runtime/commit/e1b16c11e34cee8e35ec813081b17dd171671771))
-* herdr-bus refactoring — rename publishers to *Simple variants ([d727591](https://github.com/ManotLuijiu/pi-harness-runtime/commit/d7275913a89deb56a6bcfdb912ea9d17e3a80ce1))
-* import LoopConfig from index.js, remove unused LoopNextAction import ([1100a4e](https://github.com/ManotLuijiu/pi-harness-runtime/commit/1100a4e87433e54416259dfdad41bc5e0def19b3))
-* periodic quota refresh every 15 minutes via setInterval ([f28e700](https://github.com/ManotLuijiu/pi-harness-runtime/commit/f28e7004d089aeada1659f4d55a35461baba76fc))
-* replace all Unicode box-drawing characters with ASCII ([dd4223a](https://github.com/ManotLuijiu/pi-harness-runtime/commit/dd4223abb0e25f746ee09ced05f6b3e40a10eb85))
-* replace Unicode dashes and arrows with ASCII equivalents ([e9027e6](https://github.com/ManotLuijiu/pi-harness-runtime/commit/e9027e689c06fdc1ca2ac4a6365ed6a6a0a384fd))
-* trigger cookie sync on startup so pre-existing cookies aren't ignored ([2914299](https://github.com/ManotLuijiu/pi-harness-runtime/commit/2914299b8caa02acbb06620c7cb8e4870acfa40e))
+* add knowledge-retrieval package for TencentDB-Agent-Memory MCP (RFC-0105) ([a4558d0](https://github.com/ManotLuijiu/pi-harness-runtime/commit/a4558d098c7b662b01d9502c8560219eafbf1941))
+* add okf-indexer package for SKILL.md indexing (RFC-0106) ([a3cc7da](https://github.com/ManotLuijiu/pi-harness-runtime/commit/a3cc7da0a390d5c8176d0d871418780facabcb5c))
+* extend a2a-adapter with discovery server (RFC-0104) ([0c4fc18](https://github.com/ManotLuijiu/pi-harness-runtime/commit/0c4fc1826fd55f10305bfbd894b32b5b55f1ab86))
+
+
+### Bug Fixes
+
+* act on CONFLICTING immediately even when mergeStateStatus=DIRTY ([b7f290e](https://github.com/ManotLuijiu/pi-harness-runtime/commit/b7f290ece8e0e989635aacc456fffd4ee19183ec))
+* add --provenance to npm publish for OIDC ([72aa76f](https://github.com/ManotLuijiu/pi-harness-runtime/commit/72aa76f8a5d4cfba984479da834e6695888902a0))
+* add diagnostics to npm publish and remove provenance ([124dabe](https://github.com/ManotLuijiu/pi-harness-runtime/commit/124dabea98b59e891fa95b9c92860d9c85657cd4))
+* apply stashed release workflow change ([8257689](https://github.com/ManotLuijiu/pi-harness-runtime/commit/82576896795c7cbc3adfbfa8500a77779896169a))
+* auto-merge detects fork PRs and posts helpful comments ([c7ff0b9](https://github.com/ManotLuijiu/pi-harness-runtime/commit/c7ff0b90b7b03ca061b1dcaf4ae8b865050f72a4))
+* fall back to local merge for workflow PRs ([5fabebd](https://github.com/ManotLuijiu/pi-harness-runtime/commit/5fabebd293cbb9180f3c6c3887873b645ecc8956))
+* improve auto-merge workflow with longer backoff and auto-resolve conflicts ([0c33f29](https://github.com/ManotLuijiu/pi-harness-runtime/commit/0c33f290097cf7c990909dbace88434fab72744b))
+* move permissions to job level for OIDC npm publish ([a8345d1](https://github.com/ManotLuijiu/pi-harness-runtime/commit/a8345d1ff2e9ade96335c56b973ba8ccf1df9296))
+* npm publish with token and provenance ([4529b4c](https://github.com/ManotLuijiu/pi-harness-runtime/commit/4529b4c72751e07a6e6317133c222a501c828e45))
+* remove local keyword from bash script in publish step ([4ef5810](https://github.com/ManotLuijiu/pi-harness-runtime/commit/4ef5810145e1233a66fecde2d985e070ab8f2524))
+* remove NPM_TOKEN env - use OIDC only for npm publish ([4107ecf](https://github.com/ManotLuijiu/pi-harness-runtime/commit/4107ecf0eb4217127b57d3be5fa3d2788d1a2175))
+* rewrite release workflow - pure OIDC publish ([056d25b](https://github.com/ManotLuijiu/pi-harness-runtime/commit/056d25b5ac673ab6ff9fad88283cd9eb5b3092ae))
+* run release workflow on main pushes ([225b284](https://github.com/ManotLuijiu/pi-harness-runtime/commit/225b28489921c1f178fc8586816c8cc8e0019e12))
+* use NPM_TOKEN in .npmrc format ([cd6be04](https://github.com/ManotLuijiu/pi-harness-runtime/commit/cd6be048bcfb245c741b3e6b6af92d6400eed621))
+* use NPM_TOKEN secret directly for npm publish ([48a3bb2](https://github.com/ManotLuijiu/pi-harness-runtime/commit/48a3bb2bd7ca3c41cd81c2bf4935dc872dc78a57))
+* use npm-publish-github-action for OIDC ([dbf3bd4](https://github.com/ManotLuijiu/pi-harness-runtime/commit/dbf3bd47d4448c2df4247fda0b67e3c9315923a9))
 
 ## [0.10.0](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.9.24...v0.10.0) (2026-07-30)
 

package/harness/task-graph.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Task Graph Manager — RFC-0028 Phase 3
+ *
+ * Manages task dependency graph for compact-aware scheduling.
+ * Currently a stub — integrates with CompactOrchestrator for
+ * dependency-aware compaction prioritization.
+ *
+ * Future work:
+ * - Track task dependencies (blocking/ready tasks)
+ * - Prioritize compaction to keep blocking path messages
+ * - Track which tasks depend on which checkpoint artifacts
+ */
+import type { RuntimeTask } from "../packages/types/src/runtime-types.js";
+export interface TaskNode {
+    task: RuntimeTask;
+    dependencies: Set<string>;
+    dependents: Set<string>;
+    status: "pending" | "ready" | "running" | "done" | "blocked";
+}
+export interface TaskGraphManager {
+    /** Add a task to the graph */
+    addTask(task: RuntimeTask): void;
+    /** Mark a task as done and update dependents */
+    completeTask(taskId: string): void;
+    /** Get tasks ready for execution */
+    getReadyTasks(): RuntimeTask[];
+    /** Get tasks blocked by a given task */
+    getBlockedTasks(taskId: string): RuntimeTask[];
+    /** Get all pending tasks */
+    getPendingTasks(): RuntimeTask[];
+    /** Get all tasks */
+    getAllTasks(): RuntimeTask[];
+    /** Get current progress summary */
+    getProgressSummary(): {
+        total: number;
+        done: number;
+        running: number;
+        failed: number;
+    };
+    /** Get compact priority: tasks to keep in context vs prune */
+    getCompactPriority(): {
+        keep: string[];
+        prune: string[];
+    };
+}
+/**
+ * Creates a new TaskGraphManager instance.
+ * Stub implementation — returns minimal working graph.
+ */
+export declare function createTaskGraphManager(): TaskGraphManager;
+//# sourceMappingURL=task-graph.d.ts.map

package/index.ts

@@ -290,6 +290,16 @@ When working on a feature from {project}/wiki/* or {project}/.write-review/:
 4. When code is ready, trigger review with \`{done} bd create "Review: <task>" -t review -p 1 && bd close <id> --reason "Approved"\`
 5. If reviewer requests changes, update code and re-review
 6. Never skip review on non-trivial features
+`;
+
+	const DOCKER_CLEANUP_HINT = `
+
+DOCKER CLEANUP WORKFLOW:
+AFTER running any Docker build command (docker build, docker compose build, docker compose up --build):
+1. ALWAYS run \`docker builder prune -f\` to clean up build cache
+2. This saves disk space - Docker build cache grows fast
+3. Example: After \`docker compose up --build\`, run \`docker builder prune -f\`
+4. For aggressive cleanup: \`docker builder prune -a -f\` (removes ALL unused cache)
 `;
 	let firstAgentStart = true;
 	pi.on("before_agent_start", async (event) => {
@@ -297,10 +307,60 @@ When working on a feature from {project}/wiki/* or {project}/.write-review/:
 			event.systemPrompt += AUTO_TODO_INVOKE_HINT;
 			event.systemPrompt += COMMIT_BUILD_CHECKLIST;
 			event.systemPrompt += WRITE_REVIEW_HINT;
+			event.systemPrompt += DOCKER_CLEANUP_HINT;
 			firstAgentStart = false;
 		}
 	});
 
+	// --- Auto-Todo Reminder on Build Commands ---------------------------
+	// Detect build commands and remind agent to update todos
+	const BUILD_COMMANDS = [
+		"docker build",
+		"docker compose build",
+		"docker compose up",
+		"npm run build",
+		"yarn build",
+		"pnpm build",
+		"bun run build",
+		"make build",
+		"gradle build",
+		"dotnet build",
+		"cargo build",
+		"go build",
+		"bench build",
+	];
+
+	const TODO_BUILD_REMINDER = `
+
+IMPORTANT - TODO UPDATE REMINDER:
+Before running a build, ensure you update the current task status:
+1. Mark the task as in_progress with bd update <id> --status in_progress
+2. After build succeeds, update the task: bd close <id> --reason "Done" or bd update <id> --status pending
+
+Run \`bd ready\` to see current tasks.
+`;
+
+	// Detect build commands and append todo reminder to their output
+	pi.on("tool_execution_end", async (event) => {
+		const toolName = (event as { toolName?: string }).toolName;
+		if (toolName !== "bash") return;
+
+		const result = (event as { result?: { content?: string } }).result;
+		if (!result) return;
+
+		const content = result.content ?? "";
+
+		// Check if this is a build command
+		const isBuildCommand = BUILD_COMMANDS.some(
+			(cmd) => content.toLowerCase().includes(cmd.toLowerCase()),
+		);
+
+		if (isBuildCommand && !content.includes("bd ready") && !content.includes("TODO UPDATE")) {
+			// Append todo reminder to build output
+			result.content = content + TODO_BUILD_REMINDER;
+		}
+	});
+
 	// --- Auto-track every assistant message ------------------------------
 	pi.on("message_end", async (event, ctx) => {
 		if (isOutputLimitResumePromptMessage(event.message)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-harness-runtime",
-  "version": "0.10.7",
+  "version": "0.10.12",
   "description": "[BETA] Codex-style /usage status + autonomous coding harness for pi. Not production ready — expect breaking changes.",
   "type": "module",
   "scripts": {
@@ -16,26 +16,18 @@
     "auth:minimax:scrape": "bun packages/auth/src/run-minimax-auth.ts scrape",
     "skills:sync": "bun scripts/skills-sync.ts",
     "skills:sync:check": "bun scripts/skills-sync.ts --check-only",
-    "build": "for pkg in packages/*/; do [ -f \"${pkg}tsconfig.json\" ] && [ \"$pkg\" != \"packages/provider-router/\" ] && node_modules/.bin/tsc -p \"${pkg}tsconfig.json\" --skipLibCheck || true; done",
-    "check:version": "bun scripts/check-version-sync.ts"
+    "build": "for pkg in packages/*/; do [ -f \"${pkg}tsconfig.json\" ] && [ \"$pkg\" != \"packages/provider-router/\" ] && node_modules/.bin/tsc -p \"${pkg}tsconfig.json\" --skipLibCheck > /dev/null 2>&1 || true; done"
   },
   "bin": {
     "harness-auth": "packages/auth/src/run-minimax-auth.ts"
   },
   "files": [
-    "index.ts",
-    "footer-status.ts",
-    "proactive-compact.ts",
-    "tracker.ts",
-    "mirror.ts",
-    "windows.ts",
-    "renderer.ts",
-    "cli.ts",
+    "*.ts",
     "harness/**/*.ts",
-    "packages",
-    "skills",
+    "packages/**/src/**/*.{ts,js}",
+    "skills/**/*",
+    "prompts/**/*",
     "package.json",
-    "status-parsers.ts",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"
@@ -66,6 +58,9 @@
     ],
     "skills": [
       "./skills"
+    ],
+    "prompts": [
+      "./prompts"
     ]
   },
   "peerDependencies": {

package/packages/a2a-adapter/src/discovery.ts

@@ -0,0 +1,106 @@
+/**
+ * A2A Discovery Server (RFC-0104)
+ *
+ * Advertises agent capabilities and handles agent registry.
+ */
+
+import { fetch } from "undici";
+import type { AgentSearchCriteria } from "./client.js";
+import { createAgentCard } from "./agent.js";
+import type { AgentCard, AgentCapabilities, Skill, Authentication } from "./types.js";
+
+/**
+ * Discovery configuration
+ */
+export interface A2ADiscoveryConfig {
+  /** Agent ID */
+  agentId: string;
+  /** Agent URL */
+  url: string;
+  /** Capabilities */
+  capabilities: AgentCapabilities;
+  /** Skills this agent provides */
+  skills: Skill[];
+  /** Authentication */
+  authentication?: Authentication;
+  /** Metadata */
+  metadata?: Record<string, string>;
+}
+
+/**
+ * Start a local A2A discovery agent
+ */
+export function startDiscoveryAgent(config: A2ADiscoveryConfig): DiscoveryAgent {
+  return new DiscoveryAgent(config);
+}
+
+export class DiscoveryAgent {
+  private card: AgentCard;
+
+  constructor(config: A2ADiscoveryConfig) {
+    this.card = createAgentCard({
+      name: config.agentId,
+      description: config.skills[0]?.description ?? "Harness Agent",
+      url: config.url,
+      version: "1.0.0",
+      capabilities: config.capabilities,
+      skills: config.skills,
+    });
+  }
+
+  getAgentCard(): AgentCard {
+    return this.card;
+  }
+}
+
+/**
+ * Registry of known agents
+ */
+export class AgentRegistry {
+  private agents = new Map<string, AgentCard>();
+
+  register(card: AgentCard): void {
+    this.agents.set(card.name, card);
+  }
+
+  unregister(name: string): void {
+    this.agents.delete(name);
+  }
+
+  list(): AgentCard[] {
+    return Array.from(this.agents.values());
+  }
+
+  find(criteria: AgentSearchCriteria): AgentCard[] {
+    return this.list().filter((agent) => {
+      if (criteria.skill && !agent.skills.some((s) => s.id === criteria.skill)) return false;
+      return true;
+    });
+  }
+}
+
+/**
+ * Load agent card from URL
+ */
+export async function loadAgentCard(url: string): Promise<AgentCard | null> {
+  try {
+    const response = await fetch(`${url}/.well-known/agent.json`);
+    if (!response.ok) return null;
+    return response.json() as Promise<AgentCard>;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Discover agents via seed URLs
+ */
+export async function discoverAgents(seedUrls: string[]): Promise<AgentCard[]> {
+  const results = await Promise.all(
+    seedUrls.map(async (url): Promise<AgentCard | null> => {
+      const card = await loadAgentCard(url);
+      return card;
+    }),
+  );
+  return results.filter((c): c is AgentCard => c !== null);
+}

package/packages/a2a-adapter/src/index.ts

@@ -3,6 +3,14 @@
  */
 
 export { A2AClient, type AgentSearchCriteria } from "./client.js";
+export {
+	startDiscoveryAgent,
+	DiscoveryAgent,
+	AgentRegistry,
+	loadAgentCard,
+	discoverAgents,
+	type A2ADiscoveryConfig,
+} from "./discovery.js";
 export { A2ATransport } from "./transport.js";
 export {
 	createAgentCard,

package/packages/knowledge-retrieval/src/index.ts

@@ -0,0 +1,18 @@
+/**
+ * Knowledge Retrieval (RFC-0105)
+ *
+ * Centralized knowledge retrieval via TencentDB-Agent-Memory MCP.
+ */
+
+export {
+  KnowledgeRetrievalClient,
+  createKnowledgeClient,
+  type KnowledgeRetrievalConfig,
+} from "./mcp-client.js";
+export type {
+  SearchOptions,
+  SearchResult,
+  CodeGraphResult,
+  SyncResult,
+  OKFDocument,
+} from "./types.js";

package/packages/knowledge-retrieval/src/mcp-client.ts

@@ -0,0 +1,212 @@
+/**
+ * TencentDB-Agent-Memory MCP Client (RFC-0105)
+ *
+ * Client for interacting with TencentDB-Agent-Memory server via MCP protocol.
+ */
+
+import { fetch } from "undici";
+import type {
+  SearchOptions,
+  SearchResult,
+  CodeGraphResult,
+} from "./types.js";
+
+const DEFAULT_TIMEOUT_MS = 5000;
+const DEFAULT_MAX_RESULTS = 5;
+
+/**
+ * Configuration for TencentDB-Agent-Memory server connection
+ */
+export interface KnowledgeRetrievalConfig {
+  /** Server URL (e.g., http://localhost:8080 or https://memory.example.com) */
+  serverUrl: string;
+  /** Optional API key for authentication */
+  apiKey?: string;
+  /** Default max results per search */
+  maxResults?: number;
+  /** Request timeout in ms */
+  timeoutMs?: number;
+}
+
+/**
+ * MCP Client for TencentDB-Agent-Memory
+ */
+export class KnowledgeRetrievalClient {
+  private config: Required<KnowledgeRetrievalConfig>;
+
+  constructor(config: KnowledgeRetrievalConfig) {
+    this.config = {
+      serverUrl: config.serverUrl.replace(/\/$/, ""),
+      apiKey: config.apiKey ?? "",
+      maxResults: config.maxResults ?? DEFAULT_MAX_RESULTS,
+      timeoutMs: config.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+    };
+  }
+
+  /**
+   * Make MCP request to server
+   */
+  private async request<T>(
+    method: string,
+    params: Record<string, unknown> = {},
+  ): Promise<T> {
+    const headers: Record<string, string> = {
+      "Content-Type": "application/json",
+    };
+
+    if (this.config.apiKey) {
+      headers["Authorization"] = `Bearer ${this.config.apiKey}`;
+    }
+
+    const response = await fetch(`${this.config.serverUrl}/mcp`, {
+      method: "POST",
+      headers,
+      body: JSON.stringify({
+        jsonrpc: "2.0",
+        id: crypto.randomUUID(),
+        method,
+        params,
+      }),
+      signal: AbortSignal.timeout(this.config.timeoutMs),
+    });
+
+    if (!response.ok) {
+      throw new Error(
+        `MCP request failed: ${response.status} ${response.statusText}`,
+      );
+    }
+
+    const data = (await response.json()) as {
+      result?: T;
+      error?: { code: number; message: string };
+    };
+
+    if (data.error) {
+      throw new Error(`MCP error: ${data.error.message}`);
+    }
+
+    return data.result as T;
+  }
+
+  /**
+   * Search skills/knowledge via hybrid retrieval
+   */
+  async search(options: SearchOptions): Promise<SearchResult[]> {
+    const limit = options.limit ?? this.config.maxResults;
+
+    const result = await this.request<{
+      results: Array<{
+        id: string;
+        title: string;
+        content: string;
+        score: number;
+        source: string;
+        tags: string[];
+        links: string[];
+        updatedAt: string;
+      }>;
+    }>("tdai_memory_search", {
+      query: options.query,
+      limit,
+      ...(options.tags && { tags: options.tags }),
+      ...(options.source && { source: options.source }),
+    });
+
+    return result.results.map((r) => ({
+      id: r.id,
+      title: r.title,
+      content: r.content,
+      score: r.score,
+      source: r.source,
+      tags: r.tags,
+      links: r.links,
+      updatedAt: r.updatedAt,
+    }));
+  }
+
+  /**
+   * Search conversations
+   */
+  async searchConversations(
+    query: string,
+    limit?: number,
+  ): Promise<SearchResult[]> {
+    const result = await this.request<{
+      results: Array<{
+        id: string;
+        title: string;
+        content: string;
+        score: number;
+        source: string;
+        tags: string[];
+        links: string[];
+        updatedAt: string;
+      }>;
+    }>("tdai_conversation_search", {
+      query,
+      limit: limit ?? this.config.maxResults,
+    });
+
+    return result.results.map((r) => ({
+      id: r.id,
+      title: r.title,
+      content: r.content,
+      score: r.score,
+      source: r.source,
+      tags: r.tags,
+      links: r.links,
+      updatedAt: r.updatedAt,
+    }));
+  }
+
+  /**
+   * Query code graph
+   */
+  async queryCodeGraph(symbol: string): Promise<CodeGraphResult> {
+    return this.request<CodeGraphResult>("tdai_codegraph_query", {
+      symbol,
+    });
+  }
+
+  /**
+   * Get list of available tools from server
+   */
+  async listTools(): Promise<
+    Array<{ name: string; description: string }>
+  > {
+    const result = await this.request<{
+      tools: Array<{ name: string; description: string }>;
+    }>("tools/list", {});
+
+    return result.tools;
+  }
+
+  /**
+   * Check server health
+   */
+  async healthCheck(): Promise<{ status: string; version?: string }> {
+    try {
+      const response = await fetch(`${this.config.serverUrl}/health`, {
+        signal: AbortSignal.timeout(2000),
+      });
+
+      if (response.ok) {
+        return response.json() as Promise<{ status: string; version?: string }>;
+      }
+
+      return { status: "unhealthy" };
+    } catch {
+      return { status: "unreachable" };
+    }
+  }
+}
+
+/**
+ * Create a KnowledgeRetrievalClient from URL string
+ */
+export function createKnowledgeClient(
+  serverUrl: string,
+  options?: Partial<Omit<KnowledgeRetrievalConfig, "serverUrl">>,
+): KnowledgeRetrievalClient {
+  return new KnowledgeRetrievalClient({ serverUrl, ...options });
+}