@chllming/wave-orchestration 0.5.1

package/scripts/research/manifests/harness-and-blackboard-2026-03-21.mjs

@@ -0,0 +1,201 @@
+export const paperManifest = [
+  {
+    title: "Harness engineering: leveraging Codex in an agent-first world",
+    slug: "harness-engineering-leveraging-codex-in-an-agent-first-world",
+    kind: "article",
+    year: 2026,
+    venue: "OpenAI",
+    researchBucket: "Practice and harness patterns",
+    mapsTo: "Reviewer loops, agent legibility, repository-as-record, and environment design for agent-first teams.",
+    fit: "Direct practical guidance for designing a long-running coding-agent harness around explicit feedback loops instead of prompt-only control.",
+    sourcePage: "https://openai.com/index/harness-engineering/",
+    textSourceUrl: "https://r.jina.ai/http://https://openai.com/index/harness-engineering/",
+    textSourceFormat: "jina-markdown",
+    textStartMarker: "February 11, 2026",
+    skipSourcePageFetch: true,
+    notes:
+      "Extracted text fetched via r.jina.ai because the canonical OpenAI page blocks automated retrieval.",
+    topics: ["harnesses-and-practice"],
+  },
+  {
+    title: "Unlocking the Codex harness: how we built the App Server",
+    slug: "unlocking-the-codex-harness-how-we-built-the-app-server",
+    kind: "article",
+    year: 2026,
+    venue: "OpenAI",
+    researchBucket: "Practice and harness patterns",
+    mapsTo: "Shared protocol design, workspace exploration, progress streaming, and diff emission across Codex clients.",
+    fit: "Useful for standardizing a reusable harness protocol instead of coupling orchestration behavior to one client surface.",
+    sourcePage: "https://openai.com/index/unlocking-the-codex-harness/",
+    textSourceUrl:
+      "https://r.jina.ai/http://https://openai.com/index/unlocking-the-codex-harness/",
+    textSourceFormat: "jina-markdown",
+    textStartMarker: "February 4, 2026",
+    skipSourcePageFetch: true,
+    notes:
+      "Extracted text fetched via r.jina.ai because the canonical OpenAI page blocks automated retrieval.",
+    topics: ["harnesses-and-practice"],
+  },
+  {
+    title: "Effective harnesses for long-running agents",
+    slug: "effective-harnesses-for-long-running-agents",
+    kind: "article",
+    preferHtml: true,
+    year: 2025,
+    venue: "Anthropic Engineering",
+    researchBucket: "Practice and harness patterns",
+    mapsTo: "Initializers, resumability, artifact discipline, and long-running harness ergonomics.",
+    fit: "Documents the operational patterns that make long-running agents inspectable and recoverable.",
+    sourcePage: "https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents",
+    topics: ["harnesses-and-practice", "long-running-agents-and-compaction"],
+  },
+  {
+    title:
+      "Building Effective AI Coding Agents for the Terminal: Scaffolding, Harness, Context Engineering, and Lessons Learned",
+    slug: "building-effective-ai-coding-agents-for-the-terminal-scaffolding-harness-context-engineering-and-lessons-learned",
+    kind: "paper",
+    year: 2026,
+    venue: "arXiv 2603.05344",
+    researchBucket: "P0 direct hits",
+    mapsTo: "Terminal-native agent scaffolding, harness construction, and context engineering for long-running coding work.",
+    fit: "One of the closest research-style papers to the repo's terminal-first orchestration goals.",
+    sourcePage: "https://arxiv.org/abs/2603.05344",
+    sourcePdf: "https://arxiv.org/pdf/2603.05344.pdf",
+    topics: ["harnesses-and-practice", "long-running-agents-and-compaction"],
+  },
+  {
+    title: "VeRO: An Evaluation Harness for Agents to Optimize Agents",
+    slug: "vero-an-evaluation-harness-for-agents-to-optimize-agents",
+    kind: "paper",
+    authors: "Varun Ursekar, Apaar Shanker, Veronica Chatrath, Yuan (Emily) Xue, Sam Denton",
+    year: 2026,
+    venue: "arXiv 2602.22480",
+    researchBucket: "P0 direct hits",
+    mapsTo: "Versioned traces, controlled budgets, and reproducible edit-execute-evaluate loops.",
+    fit: "Anchors harness design in experimental infrastructure instead of ad hoc runtime glue.",
+    sourcePage: "https://arxiv.org/abs/2602.22480",
+    sourcePdf: "https://arxiv.org/pdf/2602.22480.pdf",
+    topics: ["long-running-agents-and-compaction", "repo-context-and-evaluation"],
+  },
+  {
+    title: "EvoClaw: Evaluating AI Agents on Continuous Software Evolution",
+    slug: "evoclaw-evaluating-ai-agents-on-continuous-software-evolution",
+    kind: "paper",
+    year: 2026,
+    venue: "arXiv 2603.13428",
+    researchBucket: "P0 direct hits",
+    mapsTo: "Continuous software evolution benchmarks, temporal tasks, and long-horizon coding-agent evaluation.",
+    fit: "Directly addresses the weakness of one-shot coding benchmarks for long-running agents.",
+    sourcePage: "https://arxiv.org/abs/2603.13428",
+    sourcePdf: "https://arxiv.org/pdf/2603.13428.pdf",
+    topics: ["long-running-agents-and-compaction", "repo-context-and-evaluation"],
+  },
+  {
+    title: "Evaluating AGENTS.md: Are Repository-Level Context Files Helpful for Coding Agents?",
+    slug: "evaluating-agents-md-are-repository-level-context-files-helpful-for-coding-agents",
+    kind: "paper",
+    authors: "Thibaud Gloaguen, Niels Mundler, Mark Muller, Veselin Raychev, Martin Vechev",
+    year: 2026,
+    venue: "ICML 2026 / arXiv 2602.11988",
+    researchBucket: "P1 strong adjacent work",
+    mapsTo: "Minimal repository context, cost-quality tradeoffs, and context-file failure modes.",
+    fit: "Provides a concrete check against bloated repository instructions and supports keeping repo context minimal and high-signal.",
+    sourcePage: "https://arxiv.org/html/2602.11988v1",
+    sourcePdf: "https://arxiv.org/pdf/2602.11988v1.pdf",
+    topics: ["repo-context-and-evaluation"],
+  },
+  {
+    title: "LLM-based Multi-Agent Blackboard System for Information Discovery in Data Science",
+    slug: "llm-based-multi-agent-blackboard-system-for-information-discovery-in-data-science",
+    kind: "paper",
+    year: 2025,
+    venue: "arXiv 2510.01285",
+    researchBucket: "P0 direct hits",
+    mapsTo: "Shared blackboard requests, capability-driven volunteering, and coordination without a fully informed central controller.",
+    fit: "The strongest direct modern blackboard reference for shared-workspace coordination.",
+    sourcePage: "https://arxiv.org/abs/2510.01285",
+    sourcePdf: "https://arxiv.org/pdf/2510.01285.pdf",
+    topics: ["blackboard-and-shared-workspaces"],
+  },
+  {
+    title: "Exploring Advanced LLM Multi-Agent Systems Based on Blackboard Architecture",
+    slug: "exploring-advanced-llm-multi-agent-systems-based-on-blackboard-architecture",
+    kind: "paper",
+    year: 2025,
+    venue: "arXiv 2507.01701",
+    researchBucket: "P0 direct hits",
+    mapsTo: "Shared global information, dynamic agent selection, and repeated consensus rounds over a blackboard.",
+    fit: "Adds a modern blackboard coordination loop with explicit next-actor selection based on workspace state.",
+    sourcePage: "https://arxiv.org/abs/2507.01701",
+    sourcePdf: "https://arxiv.org/pdf/2507.01701.pdf",
+    topics: ["blackboard-and-shared-workspaces"],
+  },
+  {
+    title: "DOVA: Deliberation-First Multi-Agent Orchestration for Autonomous Research Automation",
+    slug: "dova-deliberation-first-multi-agent-orchestration-for-autonomous-research-automation",
+    kind: "paper",
+    year: 2026,
+    venue: "arXiv 2603.13327",
+    researchBucket: "P0 direct hits",
+    mapsTo: "Deliberation-first orchestration, iterative refinement, and transparent coordination for autonomous research.",
+    fit: "Useful as a modern hybrid between harness design and blackboard-style coordination.",
+    sourcePage: "https://arxiv.org/abs/2603.13327",
+    sourcePdf: "https://arxiv.org/pdf/2603.13327.pdf",
+    topics: ["blackboard-and-shared-workspaces", "harnesses-and-practice"],
+  },
+  {
+    title: "SYMPHONY: Synergistic Multi-agent Planning with Heterogeneous Language Model Assembly",
+    slug: "symphony-synergistic-multi-agent-planning-with-heterogeneous-language-model-assembly",
+    kind: "paper",
+    year: 2026,
+    venue: "arXiv 2601.22623",
+    researchBucket: "P1 strong adjacent work",
+    mapsTo: "Heterogeneous agent pools, multi-agent planning, and coordination advantages from model diversity.",
+    fit: "Broadens the coordination design space beyond pure blackboard systems while staying relevant to shared-workspace orchestration.",
+    sourcePage: "https://arxiv.org/abs/2601.22623",
+    sourcePdf: "https://arxiv.org/pdf/2601.22623.pdf",
+    topics: ["blackboard-and-shared-workspaces"],
+  },
+  {
+    title: "Silo-Bench: A Scalable Environment for Evaluating Distributed Coordination in Multi-Agent LLM Systems",
+    slug: "silo-bench-a-scalable-environment-for-evaluating-distributed-coordination-in-multi-agent-llm-systems",
+    kind: "paper",
+    year: 2026,
+    venue: "arXiv 2603.01045",
+    researchBucket: "P0 direct hits",
+    mapsTo: "Distributed coordination benchmarks, communication-reasoning gaps, and evidence on integration failures in multi-agent systems.",
+    fit: "A concrete benchmark for testing whether shared-workspace coordination actually improves reasoning integration.",
+    sourcePage: "https://arxiv.org/abs/2603.01045",
+    sourcePdf: "https://arxiv.org/pdf/2603.01045.pdf",
+    topics: ["blackboard-and-shared-workspaces", "repo-context-and-evaluation"],
+  },
+  {
+    title: "Memory for Autonomous LLM Agents: Mechanisms, Evaluation, and Emerging Frontiers",
+    slug: "memory-for-autonomous-llm-agents-mechanisms-evaluation-and-emerging-frontiers",
+    kind: "paper",
+    year: 2026,
+    venue: "arXiv 2603.07670",
+    researchBucket: "P1 strong adjacent work",
+    mapsTo: "Memory architecture, compaction, retrieval, reflection, and policy-aware context management.",
+    fit: "Extends the archive with a current survey of long-running agent memory and compaction design.",
+    sourcePage: "https://arxiv.org/abs/2603.07670",
+    sourcePdf: "https://arxiv.org/pdf/2603.07670.pdf",
+    topics: ["long-running-agents-and-compaction"],
+  },
+  {
+    title: "An Open Agent Architecture",
+    slug: "an-open-agent-architecture",
+    kind: "paper",
+    authors: "Philip R. Cohen, Adam Cheyer, Michelle Wang, Soon Cheol Baeg",
+    year: 1994,
+    venue: "AAAI Spring Symposium 1994",
+    researchBucket: "P2 lineage and older references",
+    mapsTo: "Blackboard servers, delegation, concurrency, and early open agent coordination patterns.",
+    fit: "Provides the older blackboard lineage behind current shared-workspace orchestration ideas.",
+    sourcePage: "https://cdn.aaai.org/Symposia/Spring/1994/SS-94-03/SS94-03-001.pdf",
+    sourcePdf: "https://cdn.aaai.org/Symposia/Spring/1994/SS-94-03/SS94-03-001.pdf",
+    topics: ["blackboard-and-shared-workspaces"],
+  },
+];
+
+export default paperManifest;

package/scripts/wave-autonomous.mjs

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+
+import { bootstrapWaveArgs } from "./wave-cli-bootstrap.mjs";
+
+const argv = bootstrapWaveArgs(process.argv.slice(2));
+const { runAutonomousCli } = await import("./wave-orchestrator/autonomous.mjs");
+
+try {
+  runAutonomousCli(argv);
+} catch (error) {
+  console.error(`[wave-autonomous] ${error instanceof Error ? error.message : String(error)}`);
+  process.exit(1);
+}

package/scripts/wave-cli-bootstrap.mjs

@@ -0,0 +1,27 @@
+import path from "node:path";
+
+function stripRepoRootArg(argv) {
+  const normalizedArgs = [];
+  let repoRoot = null;
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (arg === "--repo-root") {
+      repoRoot = path.resolve(process.cwd(), String(argv[index + 1] || ""));
+      index += 1;
+      continue;
+    }
+    if (String(arg).startsWith("--repo-root=")) {
+      repoRoot = path.resolve(process.cwd(), String(arg).slice("--repo-root=".length));
+      continue;
+    }
+    normalizedArgs.push(arg);
+  }
+  if (repoRoot) {
+    process.env.WAVE_REPO_ROOT = repoRoot;
+  }
+  return normalizedArgs;
+}
+
+export function bootstrapWaveArgs(argv) {
+  return stripRepoRootArg(Array.isArray(argv) ? argv : []);
+}

package/scripts/wave-dashboard.mjs

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+
+import { bootstrapWaveArgs } from "./wave-cli-bootstrap.mjs";
+
+const argv = bootstrapWaveArgs(process.argv.slice(2));
+const { runDashboardCli } = await import("./wave-orchestrator/dashboard-renderer.mjs");
+
+runDashboardCli(argv).catch((error) => {
+  console.error(`[wave-dashboard] ${error instanceof Error ? error.message : String(error)}`);
+  process.exit(1);
+});

package/scripts/wave-human-feedback.mjs

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+
+import { bootstrapWaveArgs } from "./wave-cli-bootstrap.mjs";
+
+const argv = bootstrapWaveArgs(process.argv.slice(2));
+const { runFeedbackCli } = await import("./wave-orchestrator/feedback.mjs");
+
+runFeedbackCli(argv).catch((error) => {
+  console.error(`[wave-human-feedback] ${error instanceof Error ? error.message : String(error)}`);
+  process.exit(1);
+});

package/scripts/wave-launcher.mjs

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+
+import { bootstrapWaveArgs } from "./wave-cli-bootstrap.mjs";
+
+const argv = bootstrapWaveArgs(process.argv.slice(2));
+const { runLauncherCli } = await import("./wave-orchestrator/launcher.mjs");
+
+runLauncherCli(argv).catch((error) => {
+  console.error(`\n[wave-launcher] ${error instanceof Error ? error.message : String(error)}`);
+  process.exit(Number.isInteger(error?.exitCode) ? error.exitCode : 1);
+});

package/scripts/wave-local-executor.mjs

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+
+import { bootstrapWaveArgs } from "./wave-cli-bootstrap.mjs";
+
+const argv = bootstrapWaveArgs(process.argv.slice(2));
+const { runLocalExecutorCli } = await import("./wave-orchestrator/local-executor.mjs");
+
+try {
+  runLocalExecutorCli(argv);
+} catch (error) {
+  console.error(`[wave-local-executor] ${error instanceof Error ? error.message : String(error)}`);
+  process.exit(1);
+}