total-recall-brain 3.41.3 → 3.41.4

package/scaffold/.agent/skills/total-recall/plugins/meta-harness/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "tr-plugin-meta-harness",
+  "version": "0.3.0",
+  "description": "Total Recall Meta Harness plugin",
+  "type": "module",
+  "scripts": {
+    "test": "node --test test/*.test.mjs",
+    "ssss": "ssss"
+  },
+  "files": [
+    "cli.mjs",
+    "plugin.json",
+    "README.md",
+    "src/",
+    "!src/**/*.spec.mjs",
+    "ui/",
+    "capability/",
+    "skills/"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@gregiteen/ssss-cli": "0.14.3"
+  }
+}

package/scaffold/.agent/skills/total-recall/plugins/meta-harness/plugin.json

@@ -0,0 +1,376 @@
+{
+  "id": "meta-harness",
+  "name": "Meta Harness",
+  "version": "0.3.0",
+  "description": "Discover, configure, document, track, and run coding agent harnesses through Total Recall across mesh nodes.",
+  "cli": {
+    "command": "meta-harness",
+    "alias": "cli-agents",
+    "handler": "cli.mjs",
+    "subcommands": [
+      {
+        "name": "status",
+        "description": "Inspect local agent binaries and authentication metadata",
+        "effect": "read",
+        "output": "json",
+        "args": []
+      },
+      {
+        "name": "catalog",
+        "description": "List documented adapter contracts and source references",
+        "effect": "read",
+        "output": "json",
+        "args": []
+      },
+      {
+        "name": "nodes",
+        "description": "List recorded mesh targets without probing or changing them",
+        "effect": "read",
+        "output": "json",
+        "args": []
+      },
+      {
+        "name": "inspect",
+        "description": "Inspect installed harnesses on a selected node",
+        "effect": "read",
+        "output": "json",
+        "args": [
+          {
+            "name": "node",
+            "flag": "--node",
+            "type": "string",
+            "label": "Mesh node"
+          }
+        ],
+        "timeout_ms": 120000
+      },
+      {
+        "name": "run-command",
+        "description": "Run an explicit plugin command through the selected agent and node using a JSON request on stdin",
+        "effect": "write",
+        "output": "json",
+        "args": [],
+        "timeout_ms": 600000
+      },
+      {
+        "name": "runtime",
+        "description": "Manage any agent runtime; includes Hermes gateway/auth/skills/plugins and DSH observations",
+        "effect": "write",
+        "output": "json",
+        "args": [
+          {
+            "name": "agent",
+            "type": "string",
+            "label": "Agent adapter",
+            "required": true,
+            "positional": true
+          },
+          {
+            "name": "operation",
+            "type": "string",
+            "label": "Native operation",
+            "required": true,
+            "positional": true
+          }
+        ],
+        "timeout_ms": 120000
+      },
+      {
+        "name": "dispatch",
+        "description": "Run a task from stdin after automatic Total Recall bootstrap",
+        "effect": "write",
+        "output": "json",
+        "args": [],
+        "timeout_ms": 120000
+      },
+      {
+        "name": "docs-status",
+        "description": "Verify cached official documentation coverage freshness and hashes",
+        "effect": "read",
+        "output": "json",
+        "args": [
+          {
+            "name": "agent",
+            "flag": "--agent",
+            "type": "string",
+            "label": "Agent adapter"
+          }
+        ],
+        "timeout_ms": 120000
+      },
+      {
+        "name": "docs-refresh",
+        "description": "Download complete official agent documentation and retain last-good content on failure",
+        "effect": "write",
+        "output": "json",
+        "args": [
+          {
+            "name": "agent",
+            "flag": "--agent",
+            "type": "string",
+            "label": "Agent adapter"
+          }
+        ],
+        "timeout_ms": 600000
+      },
+      {
+        "name": "docs-ensure",
+        "description": "Refresh missing or stale documentation automatically",
+        "effect": "write",
+        "output": "json",
+        "args": [
+          {
+            "name": "agent",
+            "flag": "--agent",
+            "type": "string",
+            "label": "Agent adapter"
+          }
+        ],
+        "timeout_ms": 600000
+      },
+      {
+        "name": "maintenance",
+        "description": "Total Recall daemon maintenance: current official documentation and integration surfaces",
+        "effect": "write",
+        "output": "json",
+        "args": [],
+        "timeout_ms": 600000
+      },
+      {
+        "name": "setup",
+        "description": "Configure supported agent instruction surfaces and daemon task placement",
+        "effect": "write",
+        "output": "json",
+        "args": [
+          {
+            "name": "node",
+            "flag": "--node",
+            "type": "string",
+            "label": "Maintenance mesh node"
+          }
+        ],
+        "timeout_ms": 120000
+      },
+      {
+        "name": "docs-sources",
+        "description": "List approved official documentation sources",
+        "effect": "read",
+        "output": "json",
+        "args": []
+      },
+      {
+        "name": "docs-read",
+        "description": "Read integrity-checked cached official documentation",
+        "effect": "read",
+        "output": "json",
+        "args": [
+          {
+            "name": "agent",
+            "flag": "--agent",
+            "type": "string",
+            "label": "Agent"
+          },
+          {
+            "name": "url",
+            "flag": "--url",
+            "type": "string",
+            "label": "Url"
+          }
+        ]
+      },
+      {
+        "name": "docs-search",
+        "description": "Search downloaded official documentation",
+        "effect": "read",
+        "output": "json",
+        "args": [
+          {
+            "name": "agent",
+            "flag": "--agent",
+            "type": "string",
+            "label": "Agent"
+          },
+          {
+            "name": "query",
+            "flag": "--query",
+            "type": "string",
+            "required": true,
+            "label": "Query"
+          }
+        ]
+      },
+      {
+        "name": "upstream",
+        "description": "Probe latest upstream harness versions and update availability",
+        "effect": "read",
+        "output": "json",
+        "args": []
+      },
+      {
+        "name": "changelog",
+        "description": "Inspect recent official changelog highlights for a selected agent",
+        "effect": "read",
+        "output": "json",
+        "args": [
+          {
+            "name": "agent",
+            "type": "string",
+            "label": "Agent identifier",
+            "required": false,
+            "positional": true
+          }
+        ]
+      },
+      {
+        "name": "adapter",
+        "description": "Manage extensible harness adapter definitions (list, add, remove)",
+        "effect": "write",
+        "output": "json",
+        "args": [
+          {
+            "name": "operation",
+            "type": "string",
+            "label": "list | add | remove",
+            "required": true,
+            "positional": true
+          },
+          {
+            "name": "target",
+            "type": "string",
+            "label": "File path, spec JSON, or adapter ID",
+            "required": false,
+            "positional": true
+          }
+        ]
+      },
+      {
+        "name": "quota",
+        "description": "Inspect 5-hour rolling/weekly quotas, credit balances, and host RAM",
+        "effect": "read",
+        "output": "json",
+        "args": [
+          {
+            "name": "node",
+            "flag": "--node",
+            "type": "string",
+            "label": "Mesh node"
+          }
+        ]
+      },
+      {
+        "name": "benchmarks",
+        "description": "Inspect SWE-bench Pro, Terminal-Bench 2.0, and local empirical pass rates",
+        "effect": "read",
+        "output": "json",
+        "args": []
+      },
+      {
+        "name": "route",
+        "description": "Evaluate task complexity and select optimal harness via two-stage RouteLLM classifier",
+        "effect": "read",
+        "output": "json",
+        "args": [
+          {
+            "name": "task",
+            "type": "string",
+            "label": "Task description",
+            "required": true,
+            "positional": true
+          }
+        ]
+      },
+      {
+        "name": "coordinate",
+        "description": "Coordinate multi-agent specialized execution pipelines (pipeline, council, race)",
+        "effect": "write",
+        "output": "json",
+        "args": [
+          {
+            "name": "task",
+            "type": "string",
+            "label": "Task description",
+            "required": true,
+            "positional": true
+          },
+          {
+            "name": "mode",
+            "flag": "--mode",
+            "type": "string",
+            "label": "pipeline | council | race"
+          }
+        ]
+      },
+      {
+        "name": "learn",
+        "description": "Summarize empirical run scorecards and generate memory friction proposals",
+        "effect": "read",
+        "output": "json",
+        "args": []
+      }
+    ]
+  },
+  "runtime": {
+    "modules": {
+      "command-executor": "src/executor.mjs",
+      "documentation": "src/documentation.mjs",
+      "agent-runtime": "src/runtime.mjs",
+      "tracker": "src/tracker.mjs"
+    },
+    "setup_command": "setup"
+  },
+  "branding": {
+    "name": "Meta Harness",
+    "color": "#3b82f6",
+    "accent": "#38bdf8",
+    "background": "#0c1427",
+    "font": "system"
+  },
+  "ui": {
+    "elements": [
+      {
+        "id": "meta-harness-card",
+        "kind": "card",
+        "tag": "meta-harness-card",
+        "module": "ui/card.js",
+        "description": "Meta Harness multi-agent coordination matrix"
+      }
+    ]
+  },
+  "card_face": {
+    "quick_actions": [
+      {
+        "subcommand": "status",
+        "label": "Local agents"
+      },
+      {
+        "subcommand": "nodes",
+        "label": "Mesh nodes"
+      },
+      {
+        "subcommand": "catalog",
+        "label": "Adapters"
+      }
+    ]
+  },
+  "auth": {
+    "plugin": "auth",
+    "methods": [
+      "passkey",
+      "google-oauth2"
+    ],
+    "session_verification": true
+  },
+  "distribution": {
+    "tier": "official",
+    "license": "open"
+  },
+  "tasks": [
+    {
+      "intent": "Keep official agent documentation and Total Recall integrations current",
+      "schedule": "*/15 * * * *",
+      "command": "maintenance",
+      "placement": "selected-node",
+      "timeout_ms": 600000
+    }
+  ]
+}

package/scaffold/.agent/skills/total-recall/plugins/meta-harness/skills/meta-harness/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: meta-harness
+description: Discover, configure, document, track, route, coordinate, and run coding agent harnesses through Total Recall across mesh nodes.
+repo_scoped: false
+---
+
+# Meta Harness
+
+The Meta Harness plugin coordinates 15+ coding agent runtimes (`agy`, `claude`, `codex`, `grok`, `ollama`, `hermes`, `dsh`, `openclaw`, `aider`, `goose`, `openhands`, `cline`, and IDE runners) across local and remote mesh nodes.
+
+## Golden Rules
+1. **Never Hardcode Credential Logic**: All API keys resolve via `total-recall auth secret get <KEY>` using the global encrypted vault.
+2. **Total Recall First**: Every dispatched agent run enforces `total-recall context "<task>"` with `ready:true` and writes a verified preflight receipt.
+3. **Deterministic Complexity Routing**: Use `meta-harness route "<task>"` to classify task complexity and avoid burning frontier quotas on mechanical edits.
+4. **Isolated Verification**: In multi-agent pipelines (`Architect -> Implementer -> Verifier`), the Verifier must execute in an isolated git worktree and employ a distinct model family.
+
+## Command Reference
+
+### Discovery & Upstream Version Tracking
+- `total-recall meta-harness status [--node <id>]`: Check installed binaries, versions, and auth status.
+- `total-recall meta-harness tracking [--node <id>]`: Compare installed versions against upstream release tags and changelogs.
+- `total-recall meta-harness catalog`: List all built-in and custom declarative adapter contracts.
+
+### Smart Routing & Telemetry
+- `total-recall meta-harness quota [--node <id>]`: Inspect 5-hour rolling/weekly quotas, credit balances, and free RAM.
+- `total-recall meta-harness benchmarks`: View SWE-bench Pro, Terminal-Bench 2.0, and local empirical pass rates.
+- `total-recall meta-harness route "<task>"`: Two-stage RouteLLM classifier and gate cascade evaluation.
+
+### Multi-Agent Coordination & Mesh Dispatch
+- `total-recall meta-harness coordinate "<task>" --mode pipeline`: Run Architect -> Implementer -> Verifier pipeline.
+- `total-recall meta-harness coordinate "<task>" --mode council`: Run multi-model consensus review.
+- `total-recall meta-harness dispatch <harness> "<prompt>" [--node <id>]`: Dispatch a single task with preflight receipt.
+
+### Self-Learning & Adapters
+- `total-recall meta-harness learn`: Ingest recent run receipts, update scorecards, and propose memory friction improvements.
+- `total-recall meta-harness adapter add <json-or-file>`: Register custom third-party agent harnesses dynamically.
+- `total-recall meta-harness adapter list`: View custom registered adapters.