@sjawhar/opencode-legion-envoy 3.12.1 → 3.14.0

package/dist/src/server.js

@@ -13793,6 +13793,16 @@ var AGENT_STREAM_LIMITS = {
   historyBytes: 512 * 1024,
   snapshotIntervalMs: 100
 };
+// ../contracts/src/claim-holds.ts
+function claimHolds(claim, titles) {
+  if (claim.actor.kind !== "session") {
+    return "holds";
+  }
+  if (titles === undefined) {
+    return "unknown";
+  }
+  return titles.has(claim.actor.id) ? "holds" : "lapsed";
+}
 // ../contracts/src/dispatch-href.ts
 function itemFromSearch(search) {
   const params = new URLSearchParams(search);
@@ -16201,17 +16211,19 @@ function componentsLine(components) {
   }
 }
 function claimText(claim, titles) {
-  return `${actorLabel(claim.actor, titles)} since ${claim.at}`;
+  const holding = claimHolds(claim, titles);
+  const marker = holding === "unknown" ? " \xB7 liveness unknown" : holding === "lapsed" ? " \xB7 not running" : "";
+  return `${actorLabel(claim.actor, titles)} since ${claim.at}${marker}`;
 }
 async function liveSessionTitles(client, needed) {
   if (!needed) {
-    return new Map;
+    return;
   }
   try {
     const agents = await client.listAgents();
     return new Map(agents.map((agent) => [agent.session_id, agent.title]));
   } catch {
-    return new Map;
+    return;
   }
 }
 function holdsSession(claim) {
@@ -16243,6 +16255,9 @@ function issueSummary(issue2, events, references, graph, titles) {
     throw new Error("Dispatch issue is missing components");
   if (issue2.claim === undefined)
     throw new Error("Dispatch issue is missing claim");
+  if (issue2.external_links === undefined) {
+    throw new Error("Dispatch issue is missing external_links");
+  }
   return [
     `Title: ${issue2.title}`,
     `Key: ${issue2.key}`,
@@ -16254,6 +16269,8 @@ function issueSummary(issue2, events, references, graph, titles) {
     componentsLine(issue2.components),
     `Route: ${routeText(issue2, titles)}`,
     ...specApproval === undefined ? [] : [`Spec ${specApproval.replace(/^Approval/, "approval")}`],
+    "External links:",
+    ...issue2.external_links.length === 0 ? ["- none"] : issue2.external_links.map((link) => `- ${link.url}${link.kind === undefined ? "" : ` (${link.kind})`}`),
     "Open asks:",
     ...asks.length === 0 ? ["- none"] : asks.map((ask) => `- ${ask.id}: ${ask.question}`),
     "References:",
@@ -17287,6 +17304,12 @@ function asObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
 }
 
+// ../envoy-client/src/dispatch-first.ts
+import { join as join2 } from "path";
+function dispatchFirstSkillFile(skillsDirectory) {
+  return join2(skillsDirectory, "dispatch-first", "SKILL.md");
+}
+
 // ../envoy-client/src/tool-contract.ts
 var DELIVERY_CONTRACT = "Delivery is at-least-once, possibly out of order across topics; use id for dedupe and at for freshness.";
 var TOPIC_GUIDE = "Topic guide (all are under notifications.): agent.<session_id> (subscribe: own inbox); role.<role> " + "(publish-to; holders claim via envoy_role_set). > matches one or more trailing tokens and does not " + "match the base subject. Envoy registers the concrete base when you subscribe to <subject>.>, so " + "the recommended default remains github.<owner>.<repo>.pr.<n>.>. <owner> and <repo> are one token " + "each, with every dot in the name written _ (sjawhar/.github is github.sjawhar._github; " + "acme/site.io is github.acme.site_io), and a topic spelled with the dot receives nothing. " + "Default PR subscription: " + "github.<owner>.<repo>.pr.<n>.> (it receives the quiet PR family): pr.<n> (lifecycle: " + "opened/synchronize/closed; closed carries merged, merge_commit_sha, merged_by, head_sha), " + "pr.<n>.comment, pr.<n>.review, pr.<n>.mention, pr.<n>.checks (one settlement event per commit whose checks settle, the head or not, naming its sha: " + 'passed/failed/cancelled/skipped with failing names and URLs; re-fires with superseded_settlement: "true" ' + "when new runs appear for the same commit). Other GitHub: issue.<n>, issue.<n>.comment, " + "issue.<n>.mention, mention, push.branch.<name>, push.tag.<name>, workflow.<file>.<action> (only " + "runs without an associated PR); slack.<team>.<channel>.message|mention and " + "slack.<team>.<channel>.thread.<ts>.message|mention; ghostwispr.<session>.<kind>; " + "whatsapp.<phone>.<jid>.<kind>; envoy.exceptions.<original-topic>.";
@@ -17752,6 +17775,16 @@ var server_default = async (input) => {
   if (!dispatchConfig.enabled) {
     logger.warn(`envoy: dispatch tools disabled \u2014 ${dispatchConfig.error ?? "no Dispatch URL configured"}`);
   }
+  let dispatchFirst;
+  if (dispatchConfig.enabled) {
+    if (skillsDirectory === undefined) {
+      throw new Error(`envoy: no skills directory beside ${moduleDirectory}`);
+    }
+    dispatchFirst = dispatchFirstSkillFile(skillsDirectory);
+    if (!existsSync(dispatchFirst)) {
+      throw new Error(`envoy: the dispatch-first skill ${dispatchFirst} is missing`);
+    }
+  }
   const envoyDefaults = envoyDefaultsFromEnvironment(process.env);
   const envoy = createEnvoyClient({ baseUrl: envoyDefaults.envoyUrl, fetch: globalThis.fetch });
   let activeSessionID = null;
@@ -17854,6 +17887,11 @@ var server_default = async (input) => {
           cfg.skills.paths.push(skillsDirectory);
         }
       }
+      if (dispatchFirst !== undefined) {
+        cfg.instructions ??= [];
+        if (!cfg.instructions.includes(dispatchFirst))
+          cfg.instructions.push(dispatchFirst);
+      }
     },
     event: async ({
       event

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sjawhar/opencode-legion-envoy",
-  "version": "3.12.1",
+  "version": "3.14.0",
   "type": "module",
   "main": "dist/src/server.js",
   "exports": {

package/skills/AGENTS.md

@@ -8,9 +8,10 @@ event intake, process lifecycle, credentials, and role delivery.
 | --- | --- | --- |
 | `ce-simplify-code/` | the implementer, once per pull request | the behaviour-preserving simplify pass before the reviewer's final pass (Legion's copy of the MIT-licensed Compound Engineering skill; `LICENSE` beside it) |
 | `dispatch/` | every role, and any session writing to Dispatch | specs, asks, comments, artifacts, and messages on native Dispatch |
+| `dispatch-first/` | every session with Dispatch configured, injected by each host plugin on every request (Oh My Pi), on every `SessionStart` (startup, resume, clear, compact, fork) and `SubagentStart` (Claude Code), or as an instruction file (OpenCode) | searching Dispatch before acting, extending the existing issue, citing decisions, closing duplicates; kept under 60 lines and 6,000 characters |
 | `envoy/` | every role | subscriptions, agent-to-agent messages, and topic formats |
 | `legion-architect/` | root and sub-architects | tree ownership, decomposition, waves, gates, integration, sign-off |
-| `legion-controller/` | the controller root process | wake routing, backlog admission, escalation |
+| `legion-controller/` | the controller root process | wake routing, keeping the admission slots full from `todo`, the daily report, escalation |
 | `legion-oracle/` | any role doing research | repository-grounded research |
 | `legion-retro/` | the implementer, at retro | the pre-merge retrospective and its Dispatch message |
 | `legion-worker/` | planner, implementer, tester, reviewer, merger | the phase contracts: handoffs, GitHub identity, PR body and READY discipline, the merge-gate order |
@@ -19,6 +20,7 @@ event intake, process lifecycle, credentials, and role delivery.
 
 The owning skill above is where each contract is defined; a role prompt that needs a contract from its own seat points there or restates only its own step. This file lists and does not restate.
 A Legion prompt (a skill here, a role prompt, or an agent definition in `packages/pi-envoy/agents/`) names a task agent only as `task(agent="<name>")` and a skill it tells the model to load only as `skill://<name>`. Those are the two forms the Go daemon's boot gate and `legion probe-image` resolve through Oh My Pi, refusing by name one it cannot find; a dispatch or a load written any other way goes unchecked. An agent or skill Legion's prompts name is shipped here or in `packages/pi-envoy/agents/`, unless Oh My Pi bundles it.
+A skill file an agent loads stays under 51,200 bytes, Oh My Pi's spill threshold (a longer one arrives with its middle cut out), and a skill's detail lives in `references/` files linked as `skill://<name>/references/<file>.md`, never by relative path, which a read by path cuts at 300 lines. `packages/pi-envoy/src/skills-guard.test.ts` fails on a file at the threshold, on any `SKILL.md` body of 500 lines or more, on a skill whose frontmatter `name` is not its directory's name, on a `dispatch-first` over its budget, on a `skill://<name>/<path>` link that names a missing file or a missing `#heading`, and on a `legion-worker` reference nothing links.
 The text a worker boots with (its role prompt) lives in `packages/pi-envoy/roles/` and is
 composed per role in `packages/daemon/src/daemon/processes.ts`; `packages/pi-envoy/roles/roles.test.ts`
 holds the structural rules for those parts.