pi-harness-runtime 0.10.12 → 0.10.13

package/RFC/0106_KNOWLEDGE_GRAPH_PROVENANCE.md

@@ -0,0 +1,368 @@
+# RFC-0106 — Knowledge Graph and Provenance Projection
+
+> **Status:** proposed
+> **Author:** pi-harness-runtime
+> **Replaces:** N/A
+> **Superseded by:** N/A
+> **Depends on:** RFC-0105 (Knowledge Retrieval)
+
+---
+
+## Summary
+
+Extend TencentDB-Agent-Memory's Knowledge Service (8424) to index all `moocoding-skills/*/SKILL.md` files as OKF encyclopedia with typed nodes and edges, creating a navigable knowledge graph with provenance linking to `RFC/*` and `IMPLEMENTATION/*`.
+
+---
+
+## Knowledge Service API (Port 8424)
+
+Base URL: `http://{host}:8424/v3`
+
+### Wiki Documents
+
+```bash
+# Create/update document
+POST /v3/wiki/documents
+Headers:
+  x-tdai-user-key: {user_key}
+  x-tdai-service-id: {service_id}
+Body:
+{
+  "title": "Frappe Custom Field Lifecycle",
+  "content": "# Frappe Custom Field Lifecycle\n\n## When to Use\n...",
+  "tags": ["frappe", "custom-field"],
+  "team_id": "moocoding"
+}
+
+# Get document
+GET /v3/wiki/documents/{document_id}
+Headers: x-tdai-user-key, x-tdai-service-id
+
+# List documents
+GET /v3/wiki/documents?team_id={team_id}&limit=100
+Headers: x-tdai-user-key, x-tdai-service-id
+
+# Delete document
+DELETE /v3/wiki/documents/{document_id}
+Headers: x-tdai-user-key, x-tdai-service-id
+```
+
+### Knowledge Graph
+
+```bash
+# Sync nodes and edges
+POST /v3/knowledge/graph/sync
+Headers: x-tdai-user-key, x-tdai-service-id
+Body:
+{
+  "nodes": [
+    {
+      "id": "skill:frappe-custom-field-lifecycle",
+      "type": "skill",
+      "data": {
+        "title": "Frappe Custom Field Lifecycle",
+        "description": "...",
+        "tags": ["frappe", "custom-field"],
+        "source": "frappe-bench/.claude-plugins/moocoding-skills/skills/frappe-custom-field-lifecycle/SKILL.md"
+      }
+    },
+    {
+      "id": "rfc:RFC-0052",
+      "type": "rfc",
+      "data": {
+        "title": "RFC-0052 Skill Registry Fix",
+        "source": "RFC/0052_SKILL_REGISTRY_FIX.md"
+      }
+    }
+  ],
+  "edges": [
+    {
+      "from": "skill:frappe-custom-field-lifecycle",
+      "to": "rfc:RFC-0052",
+      "type": "implements"
+    }
+  ]
+}
+
+# Search graph
+POST /v3/knowledge/graph/search
+Headers: x-tdai-user-key, x-tdai-service-id
+Body:
+{
+  "query": "frappe custom field",
+  "limit": 10
+}
+
+# Query by relationship
+POST /v3/knowledge/graph/query
+Headers: x-tdai-user-key, x-tdai-service-id
+Body:
+{
+  "type": "implements",
+  "from": "skill:frappe-custom-field-lifecycle"
+}
+```
+
+---
+
+## Node Types
+
+```typescript
+type KnowledgeNodeType =
+  | 'skill'           // SKILL.md entry
+  | 'rfc'             // RFC document
+  | 'implementation'  // IMPLEMENTATION/* entry
+  | 'concept'         // Abstract concept
+  | 'api'             // API endpoint
+  | 'cli'             // CLI command
+  | 'pattern'         // Code pattern
+  | 'workflow';       // Workflow/SOP
+
+interface KnowledgeNode {
+  id: string;           // e.g., "skill:frappe-custom-field-lifecycle"
+  type: KnowledgeNodeType;
+  data: {
+    title: string;
+    description?: string;
+    tags: string[];
+    source?: string;     // File path
+    url?: string;        // RFC/IMPLEMENTATION URL
+  };
+}
+```
+
+---
+
+## Edge Types
+
+```typescript
+type KnowledgeEdgeType =
+  | 'implements'       // Skill implements RFC
+  | 'depends_on'       // Skill A depends on Skill B
+  | 'supersedes'       // New version replaces old
+  | 'related_to'      // General relationship
+  | 'authored_by'     // Author attribution
+  | 'documents'        // RFC/Impl documents a skill
+  | 'references';      // RFC references implementation
+
+interface KnowledgeEdge {
+  from: string;          // Node ID
+  to: string;           // Node ID
+  type: KnowledgeEdgeType;
+  metadata?: {
+    confidence?: number;  // 0-1
+    source?: string;      // How was this edge discovered
+  };
+}
+```
+
+---
+
+## Provenance Mapping
+
+```
+RFC-0105 (Distributed Knowledge Retrieval)
+        ↓ implements
+IMPLEMENTATION/RFC-0105/
+        ↓ contains
+packages/tencentdb-memory/
+        ↓ indexes
+moocoding-skills/skills/tencentdb-sync/SKILL.md
+
+Knowledge Graph:
+  skill:tencentdb-sync --implements--> rfc:RFC-0105
+  skill:tencentdb-sync --documents--> implementation:RFC-0105
+```
+
+---
+
+## SKILL.md OKF Structure
+
+```markdown
+---
+id: frappe-custom-field-lifecycle
+type: skill
+title: Frappe Custom Field Lifecycle
+tags: [frappe, custom-field, database, migration]
+version: 1.0.0
+provenance:
+  implements: RFC-0052
+  related_implementation: IMPLEMENTATION/RFC-0052
+  author: moocoding
+---
+
+# Frappe Custom Field Lifecycle
+
+## When to Use
+...
+
+## Procedure
+...
+
+## Pitfalls
+...
+
+## Related Skills
+- [[skill:frappe-doctype-field-order]]
+- [[skill:property-setter-pattern]]
+```
+
+---
+
+## Extraction Pipeline
+
+```typescript
+// Extract knowledge from SKILL.md files → Knowledge Graph
+async function extractKnowledgeGraph(sourcePath: string, config: TencentDBConfig) {
+  // 1. Parse all SKILL.md files
+  const docs = indexDirectory(sourcePath);
+  
+  // 2. Create nodes and edges
+  const nodes: KnowledgeNode[] = [];
+  const edges: KnowledgeEdge[] = [];
+  
+  for (const doc of docs) {
+    // Create skill node
+    nodes.push({
+      id: `skill:${doc.id}`,
+      type: 'skill',
+      data: {
+        title: doc.title,
+        description: doc.sections[0]?.content.slice(0, 200),
+        tags: doc.metadata.tags,
+        source: doc.metadata.source,
+      }
+    });
+    
+    // Extract provenance from frontmatter
+    const provenance = doc.metadata.provenance;
+    if (provenance.implements) {
+      edges.push({
+        from: `skill:${doc.id}`,
+        to: `rfc:${provenance.implements}`,
+        type: 'implements'
+      });
+    }
+    if (provenance.related_implementation) {
+      edges.push({
+        from: `skill:${doc.id}`,
+        to: `implementation:${provenance.related_implementation}`,
+        type: 'documents'
+      });
+    }
+    
+    // Link to RFCs found in content
+    const rfcRefs = extractRFCRefs(doc.content);
+    for (const rfc of rfcRefs) {
+      edges.push({
+        from: `skill:${doc.id}`,
+        to: `rfc:${rfc}`,
+        type: 'references'
+      });
+    }
+    
+    // Wiki links become edges
+    for (const link of doc.links) {
+      if (link.startsWith('skill:')) {
+        edges.push({
+          from: `skill:${doc.id}`,
+          to: link,
+          type: 'related_to'
+        });
+      }
+    }
+  }
+  
+  // 3. Sync to Knowledge Service
+  await syncGraph({
+    nodes,
+    edges,
+    config
+  });
+}
+
+// Sync to Knowledge Service (8424)
+async function syncGraph(payload: { nodes: KnowledgeNode[], edges: KnowledgeEdge[] }, config: TencentDBConfig) {
+  const response = await fetch(`${config.knowledgeUrl}/v3/knowledge/graph/sync`, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      'x-tdai-user-key': config.userKey,
+      'x-tdai-service-id': config.serviceId,
+    },
+    body: JSON.stringify(payload)
+  });
+  return response.json();
+}
+```
+
+---
+
+## MCP Integration (RFC-0106)
+
+```typescript
+interface KnowledgeGraphMCP {
+  // Search skills via Knowledge Service
+  kg_search(query: string): Promise<SearchResult[]>;
+  
+  // Query graph relationships
+  kg_query(type: string, from?: string, to?: string): Promise<Edge[]>;
+  
+  // Get node details
+  kg_node(id: string): Promise<KnowledgeNode>;
+  
+  // Get skill by RFC
+  kg_findByRFC(rfcId: string): Promise<KnowledgeNode[]>;
+  
+  // Get related skills
+  kg_related(skillId: string): Promise<KnowledgeNode[]>;
+}
+```
+
+---
+
+## File Structure
+
+```
+packages/tencentdb-memory/
+├── src/
+│   ├── client.ts          # Memory Core client (8420)
+│   ├── knowledge.ts        # Knowledge Service client (8424)
+│   ├── proxy.ts           # Proxy client (8096)
+│   ├── loader.ts         # SKILL.md loader
+│   ├── indexer.ts        # OKF indexer (from okf-indexer package)
+│   └── sync.ts           # Graph sync pipeline
+└── package.json
+
+packages/okf-indexer/
+├── src/
+│   ├── indexer.ts        # Parse SKILL.md → OKF
+│   ├── extractor.ts      # Extract provenance/edges
+│   └── cli.ts           # CLI for indexing
+└── package.json
+
+scripts/
+└── tencentdb-sync.ts    # Sync CLI
+```
+
+---
+
+## Dependencies
+
+| Dependency | Purpose |
+|------------|---------|
+| TencentDB-Agent-Memory | Knowledge Service (8424) |
+| okf-indexer | SKILL.md → OKF parsing |
+| chokidar | File watching for auto-sync |
+
+---
+
+## Files
+
+See `IMPLEMENTATION/RFC-0106/FILES.md`.
+
+---
+
+## Acceptance Criteria
+
+See `IMPLEMENTATION/RFC-0106/ACCEPTANCE_CRITERIA.md`.

package/RFC/README.md

@@ -0,0 +1,11 @@
+# Day 2 RFC Plan
+
+This folder will contain initial RFC documents.
+
+Planned files:
+
+- `0001_LOOP_RUNTIME.md`
+- `0002_PROVIDER_ADAPTER.md`
+- `0003_QUOTA_MANAGER.md`
+- `0004_PLAYWRIGHT_ADAPTER.md`
+- `0005_GIT_WORKTREE.md`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-harness-runtime",
-  "version": "0.10.12",
+  "version": "0.10.13",
   "description": "[BETA] Codex-style /usage status + autonomous coding harness for pi. Not production ready — expect breaking changes.",
   "type": "module",
   "scripts": {
@@ -16,7 +16,8 @@
     "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 > /dev/null 2>&1 || true; done"
+    "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",
+    "prepublishOnly": "bun run build"
   },
   "bin": {
     "harness-auth": "packages/auth/src/run-minimax-auth.ts"
@@ -24,9 +25,13 @@
   "files": [
     "*.ts",
     "harness/**/*.ts",
-    "packages/**/src/**/*.{ts,js}",
+    "packages/*/dist/**/*",
+    "packages/*/src/**/*.ts",
     "skills/**/*",
     "prompts/**/*",
+    "scripts/**/*",
+    "RFC/**/*",
+    "IMPLEMENTATION/**/*",
     "package.json",
     "README.md",
     "CHANGELOG.md",

package/packages/a2a-adapter/dist/agent.d.ts

@@ -0,0 +1,27 @@
+/**
+ * A2A Adapter — A2A Agent (RFC-0069)
+ *
+ * Expose this harness agent as an A2A-compatible agent.
+ */
+import type { AgentCard, A2AAgentConfig, Task, TaskMessage } from "./types.js";
+/**
+ * Create an AgentCard for this harness agent
+ */
+export declare function createAgentCard(config: A2AAgentConfig): AgentCard;
+/**
+ * Route incoming A2A task to harness skill-registry
+ */
+export declare function routeTask(message: TaskMessage): Promise<Task>;
+/**
+ * Get task by ID
+ */
+export declare function getTask(taskId: string): Task | null;
+/**
+ * Cancel a task
+ */
+export declare function cancelTask(taskId: string): boolean;
+/**
+ * Generate task status update SSE
+ */
+export declare function taskStatusUpdateSSE(taskId: string): string;
+//# sourceMappingURL=agent.d.ts.map

package/packages/a2a-adapter/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACX,SAAS,EACT,cAAc,EACd,IAAI,EACJ,WAAW,EAGX,MAAM,YAAY,CAAC;AAUpB;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAiCjE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BnE;AASD;;GAEG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAEnD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAMlD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAgB1D"}

package/packages/a2a-adapter/dist/agent.js

@@ -0,0 +1,120 @@
+/**
+ * A2A Adapter — A2A Agent (RFC-0069)
+ *
+ * Expose this harness agent as an A2A-compatible agent.
+ */
+/**
+ * Task store — in-memory for now
+ */
+const taskStore = new Map();
+let taskCounter = 0;
+/**
+ * Create an AgentCard for this harness agent
+ */
+export function createAgentCard(config) {
+    return {
+        name: config.name,
+        description: config.description,
+        url: config.url,
+        version: config.version,
+        capabilities: {
+            streaming: true,
+            pushNotifications: false,
+            stateTransitionHistory: false,
+            ...config.capabilities,
+        },
+        skills: config.skills ?? [
+            {
+                id: "code-analysis",
+                name: "Code Analysis",
+                description: "Analyze code structure, dependencies, and quality",
+                tags: ["code", "analysis", "static-analysis"],
+                inputModes: ["text"],
+                outputModes: ["text"],
+            },
+            {
+                id: "code-generation",
+                name: "Code Generation",
+                description: "Generate code from specifications",
+                tags: ["code", "generation", "scaffolding"],
+                inputModes: ["text"],
+                outputModes: ["text"],
+            },
+        ],
+        defaultInputModes: ["text"],
+        defaultOutputModes: ["text"],
+    };
+}
+/**
+ * Route incoming A2A task to harness skill-registry
+ */
+export async function routeTask(message) {
+    const taskId = `task-${++taskCounter}-${Date.now()}`;
+    const task = {
+        id: taskId,
+        status: "working",
+        kind: "message",
+        artifacts: [],
+    };
+    taskStore.set(taskId, task);
+    try {
+        const response = await processMessage(message);
+        task.artifacts = [
+            {
+                name: "response",
+                description: "Agent response",
+                parts: [{ type: "text", text: response }],
+            },
+        ];
+        task.status = "completed";
+    }
+    catch (err) {
+        task.status = "failed";
+        const msg = err instanceof Error ? err.message : String(err);
+        task.artifacts = [{ parts: [{ type: "text", text: `Error: ${msg}` }] }];
+    }
+    taskStore.set(taskId, task);
+    return task;
+}
+/**
+ * Process message — stub for harness integration
+ */
+async function processMessage(message) {
+    return `[A2A Stub] Received: ${message.content}. This would be processed by the harness skill-registry.`;
+}
+/**
+ * Get task by ID
+ */
+export function getTask(taskId) {
+    return taskStore.get(taskId) ?? null;
+}
+/**
+ * Cancel a task
+ */
+export function cancelTask(taskId) {
+    const task = taskStore.get(taskId);
+    if (!task)
+        return false;
+    task.status = "canceled";
+    taskStore.set(taskId, task);
+    return true;
+}
+/**
+ * Generate task status update SSE
+ */
+export function taskStatusUpdateSSE(taskId) {
+    const task = taskStore.get(taskId);
+    if (!task)
+        return "";
+    // Inline SSE formatting to avoid dynamic require at module level
+    return (`event: task_status_update\ndata: ` +
+        JSON.stringify({
+            taskId: task.id,
+            status: task.status,
+            final: task.status === "completed" ||
+                task.status === "failed" ||
+                task.status === "canceled",
+        }) +
+        "\n\n");
+}
+//# sourceMappingURL=agent.js.map

package/packages/a2a-adapter/dist/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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"}

package/packages/a2a-adapter/dist/client.d.ts

@@ -0,0 +1,58 @@
+/**
+ * A2A Adapter — A2A Client (RFC-0069)
+ *
+ * Discover and delegate to remote A2A agents.
+ */
+import type { AgentCard, A2AClientConfig, TaskHandle, Task } from "./types.js";
+export { A2ATransport } from "./transport.js";
+export interface AgentSearchCriteria {
+    skill?: string;
+    capability?: string;
+}
+/**
+ * A2A Client — discover and delegate to remote agents
+ */
+export declare class A2AClient {
+    private transport;
+    constructor(baseUrl: string, config?: A2AClientConfig);
+    /**
+     * Discover agent via URL
+     */
+    discoverAgent(url?: string): Promise<AgentCard>;
+    /**
+     * List agents (if target supports agent listing)
+     */
+    listAgents(_filter?: Record<string, string>): Promise<AgentCard[]>;
+    /**
+     * Find agents by skill/capability
+     * Note: This requires a registry or directory service
+     */
+    findAgents(_criteria: AgentSearchCriteria): Promise<AgentCard[]>;
+    /**
+     * Send task to agent
+     */
+    sendTask(message: string, options?: {
+        taskId?: string;
+        sessionId?: string;
+    }): Promise<TaskHandle>;
+    /**
+     * Send task with streaming updates
+     */
+    sendTaskSubscribe(message: string, options?: {
+        taskId?: string;
+        sessionId?: string;
+    }): Promise<TaskHandle>;
+    /**
+     * Get task result
+     */
+    getTaskResult(taskId: string): Promise<Task>;
+    /**
+     * Cancel task
+     */
+    cancelTask(taskId: string): Promise<void>;
+    /**
+     * Subscribe to task updates via SSE
+     */
+    subscribeToTask(taskId: string): AsyncGenerator<unknown>;
+}
+//# sourceMappingURL=client.d.ts.map

package/packages/a2a-adapter/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EACX,SAAS,EACT,eAAe,EACf,UAAU,EAEV,IAAI,EAEJ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,MAAM,WAAW,mBAAmB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,SAAS;IACrB,OAAO,CAAC,SAAS,CAAe;IAEhC,YAAY,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,EAEpD;IAED;;OAEG;IACG,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAIpD;IAED;;OAEG;IACG,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAEvE;IAED;;;OAGG;IACG,UAAU,CAAC,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAErE;IAED;;OAEG;IACG,QAAQ,CACb,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACnD,OAAO,CAAC,UAAU,CAAC,CAMrB;IAED;;OAEG;IACG,iBAAiB,CACtB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACnD,OAAO,CAAC,UAAU,CAAC,CAMrB;IAED;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjD;IAED;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9C;IAED;;OAEG;IACI,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,CAE9D;CACD"}