@sjawhar/pi-envoy 10.25.0 → 10.26.0

package/dist/envoy.js

@@ -30013,6 +30013,7 @@ var SEARCH_QUERY_HINT = "search with a short phrase of a few words, not a passag
 var SEARCH_KIND_DEPTH = 100;
 var PROJECT_KEY_PATTERN = /^[A-Z][A-Z0-9]{1,9}$/;
 var PROJECT_KEY_RULE = "an uppercase letter, then 1 to 9 uppercase letters or digits, such as CORE";
+var ARCHITECTURE_SOURCE_REPO_PATTERN = /^[A-Za-z0-9-]+\/(?!\.\.?$)[A-Za-z0-9._-]+$/;
 var ISSUE_STATUSES = [
   "triage",
   "icebox",
@@ -30378,7 +30379,7 @@ var dispatchToolSpecs = [
   {
     name: "dispatch_issues",
     example: { project: "PROJ", limit: 250, offset: 250 },
-    description: "List a project's issues for a roadmap or backlog pass: every issue in one project, each carrying " + "its status, priority, parent, labels, open-ask count, progress (its spec's task-list items and " + "its direct children, each done of total, as `tasks 3/7 \xB7 children 2/5`, each only when it has " + "any), and route with whether it reaches anyone, " + "so you can see backlog shape without opening every issue. Optionally filter by status, parent, " + "label, priority, route status, or how recently it changed; priority takes one or more of 0-3 " + "(P0-P3) and null for an issue with no priority, so an owner's P0/P1 audit is priority [0, 1]. " + 'route_status "no_holder" lists every open issue whose route names a role nobody holds or a ' + "session that is not running at the moment of the read, whatever its priority. A restarting " + "session is absent for minutes, so an issue is unowned only when a read ten minutes later agrees. " + "Do not use it to search by keyword or phrase; dispatch search remains the keyword surface. " + "Dispatch pages the list: limit sets the page size (default " + `${DEFAULT_ISSUE_PAGE_LIMIT}, max ${MAX_ISSUE_PAGE_LIMIT}) and offset selects where it starts ` + "(default 0), and the answer names how many issues match, so repeat with the next offset to " + "walk every matching issue. A walk is exact only while the list does not change: an issue " + "that enters or leaves what the filters match, or whose status or rank changes, between two " + "pages shifts rows across a page boundary, so one issue can come back twice and another never.",
+    description: "List a project's issues for a roadmap or backlog pass: every issue in one project, each carrying " + "its status, priority, parent, labels, open-ask count, progress (its spec's task-list items and " + "its direct children, each done of total, as `tasks 3/7 \xB7 children 2/5`, each only when it has " + "any), and route with whether it reaches anyone, " + "so you can see backlog shape without opening every issue. Optionally filter by status, parent, " + "label, priority, route status, or how recently it changed; priority takes one or more of 0-3 " + "(P0-P3) and null for an issue with no priority, so an owner's P0/P1 audit is priority [0, 1]. " + 'route_status "no_holder" lists every open issue whose route names a role nobody holds or a ' + "session that is not running at the moment of the read, whatever its priority. A restarting " + "session is absent for minutes, so an issue is unowned only when a read ten minutes later agrees. " + "Do not use it to search by keyword or phrase; dispatch search remains the keyword surface. " + "Dispatch pages the list: limit sets the page size (default " + `${DEFAULT_ISSUE_PAGE_LIMIT}, max ${MAX_ISSUE_PAGE_LIMIT}) and offset selects where it starts ` + "(default 0), and the answer names how many issues match, so repeat with the next offset to " + "walk every matching issue. A walk is exact only while the list does not change: an issue " + "that enters or leaves what the filters match, or whose status or rank changes, between two " + "pages shifts rows across a page boundary, so one issue can come back twice and another never. " + "all takes the whole filtered list in one read instead, for a caller that must not miss or " + "repeat a row while other writers change the list, and especially for one whose own writes " + "move issues out of what it filtered on.",
     arguments: (z2) => ({
       project: z2.string().describe("Project key to list issues from."),
       status: z2.enum(ISSUE_STATUSES).describe("Optional lifecycle status filter.").optional(),
@@ -30388,7 +30389,8 @@ var dispatchToolSpecs = [
       updated_since: z2.string().describe("Optional RFC3339 timestamp; only issues updated at or after it.").optional(),
       route_status: z2.enum(ISSUE_ROUTE_STATUSES).describe("Optional: only open issues whose route is in this state. live: a running session holds " + "the role or is the routed session. no_holder: nobody running holds the role, or the " + "session is not running, right now. unknown: the Envoy listener did not answer.").optional(),
       limit: z2.number({ int: true, min: 1, max: MAX_ISSUE_PAGE_LIMIT }).describe(`Maximum rows, 1-${MAX_ISSUE_PAGE_LIMIT}; default ${DEFAULT_ISSUE_PAGE_LIMIT}.`).optional(),
-      offset: z2.number({ int: true, min: 0 }).describe("Rows to skip before the page; nonnegative integer; default 0.").optional()
+      offset: z2.number({ int: true, min: 0 }).describe("Rows to skip before the page; nonnegative integer; default 0.").optional(),
+      all: z2.boolean().describe("Take every matching issue in one unpaged read, so no row is missed or repeated while " + "the list changes. Refused with limit or offset.").optional()
     })
   },
   {
@@ -30410,11 +30412,19 @@ var dispatchToolSpecs = [
   },
   {
     name: "dispatch_architecture_sync",
-    example: { project: "CORE" },
-    description: "Import a project's architecture model from its configured source repository now, instead of " + "waiting for the server's five-minute schedule. Returns the imported commit and component " + "count, or the recorded error when the model was rejected (the previous model stays up). " + "The source itself is configured by a human in Settings; 404 SOURCE_NOT_FOUND without one.",
+    example: { project: "CORE", repo: "acme/infra" },
+    description: "Import a project's architecture model from its source repositories now, instead of waiting " + "for the server's five-minute schedule. A project may have several sources, one per " + "repository, and its model is every source's components together. Without repo every " + "source imports and each answers on its own line; with repo only that source does. Each " + "line names the imported commit, or the recorded error when that source's model was " + "rejected (its previous components stay up, and every other source is untouched). Sources " + "are saved in Settings or with PUT /api/v1/projects/{key}/architecture-sources/{owner}/{repo}; " + "404 SOURCE_NOT_FOUND when the project has none, or none for that repository.",
     arguments: (z2) => ({
-      project: z2.string().describe("Project key whose architecture source to sync, such as CORE.")
+      project: z2.string().describe("Project key whose architecture sources to sync, such as CORE."),
+      repo: z2.string().describe("One source repository of the project to sync alone, owner/name; omit it to sync every source.").optional()
     }),
+    validation: {
+      check: (value) => {
+        const { repo } = value;
+        return typeof repo !== "string" || ARCHITECTURE_SOURCE_REPO_PATTERN.test(repo);
+      },
+      message: "repo is not a repository: give it as owner/name, such as acme/infra."
+    },
     strict: true
   },
   {
@@ -32708,6 +32718,9 @@ function asErrorShape(value) {
 function isJson(response) {
   return response.headers.get("content-type")?.includes("application/json") ?? false;
 }
+function isNoRoute(error48) {
+  return error48 instanceof DispatchServiceError && error48.status === 404 && error48.code === "NOT_FOUND" && error48.message.startsWith("no route for ");
+}
 var ISSUE_EVENTS_PAGE_MAX = 200;
 var DISPATCH_TOOL_DEADLINE_MS = 60000;
 function requestSignal(signal) {
@@ -32735,6 +32748,18 @@ function whyNotAPage(answer) {
   }
   return `${what}. Retrying will not help: the same request gets the same answer until that ` + "Dispatch is upgraded or fixed.";
 }
+function whyNotAnArray(answer) {
+  if (typeof answer === "string")
+    return `text that is not JSON, ${GATEWAY_PAGE}, so a retry may succeed`;
+  if (answer === null)
+    return "null";
+  if (typeof answer !== "object")
+    return `a ${typeof answer}`;
+  if ("issues" in answer && Array.isArray(answer.issues)) {
+    return "a page, so this Dispatch pages a request that carries no limit and no offset";
+  }
+  return "an object that is not the listing";
+}
 var GATEWAY_PAGE = "which looks like a proxy or gateway page rather than Dispatch's own answer";
 function gatewayAdvice(method, status) {
   if (!transientStatus(status)) {
@@ -32810,6 +32835,14 @@ class DispatchClient {
       return answer;
     throw new Error(`GET ${this.#url(path2, query)} asked for a page ({issues, total, limit, offset}) and got ` + refusal);
   }
+  async listAllIssues(options) {
+    const path2 = ["api", "v1", "issues"];
+    const query = { ...options };
+    const answer = await this.#json("GET", path2, undefined, query);
+    if (Array.isArray(answer))
+      return answer;
+    throw new Error(`GET ${this.#url(path2, query)} asked for the unpaged listing and got ${whyNotAnArray(answer)}.`);
+  }
   async listProjectArtifacts(project, unlinked = false) {
     return this.#json("GET", ["api", "v1", "projects", project, "artifacts"], undefined, unlinked ? { unlinked: "true" } : undefined);
   }
@@ -32898,19 +32931,69 @@ class DispatchClient {
   async listProjects() {
     return this.#json("GET", ["api", "v1", "projects"]);
   }
-  async syncArchitectureSource(project) {
-    return this.#json("POST", ["api", "v1", "projects", project, "architecture-source", "sync"]);
-  }
-  async getArchitectureSource(project) {
+  async listArchitectureSources(project) {
     try {
-      return await this.#json("GET", ["api", "v1", "projects", project, "architecture-source"]);
+      return await this.#json("GET", ["api", "v1", "projects", project, "architecture-sources"]);
+    } catch (error48) {
+      if (!isNoRoute(error48))
+        throw error48;
+    }
+    try {
+      const source = await this.#json("GET", [
+        "api",
+        "v1",
+        "projects",
+        project,
+        "architecture-source"
+      ]);
+      return source === null ? [] : [source];
     } catch (error48) {
       if (error48 instanceof DispatchServiceError && error48.status === 404 && error48.code === "SOURCE_NOT_FOUND") {
-        return null;
+        return [];
       }
       throw error48;
     }
   }
+  async syncArchitectureSources(project) {
+    try {
+      return await this.#json("POST", [
+        "api",
+        "v1",
+        "projects",
+        project,
+        "architecture-sources",
+        "sync"
+      ]);
+    } catch (error48) {
+      if (!isNoRoute(error48))
+        throw error48;
+    }
+    const source = await this.#json("POST", [
+      "api",
+      "v1",
+      "projects",
+      project,
+      "architecture-source",
+      "sync"
+    ]);
+    return [source];
+  }
+  async syncArchitectureSource(project, repo2) {
+    const [owner, name, ...rest] = repo2.split("/");
+    if (!owner || !name || rest.length > 0) {
+      throw new Error(`repository must be owner/name, got ${JSON.stringify(repo2)}`);
+    }
+    return this.#json("POST", [
+      "api",
+      "v1",
+      "projects",
+      project,
+      "architecture-sources",
+      owner,
+      name,
+      "sync"
+    ]);
+  }
   async resolveAsk(id, input) {
     return this.#json("POST", ["api", "v1", "asks", id, "resolve"], input);
   }
@@ -34151,7 +34234,7 @@ var envoyToolSpecs = [
   },
   {
     name: "envoy_publish",
-    description: `Publish an Envoy message to a notifications. topic. A role or built-in topic is delivered as its guide says; any other notifications. topic you name (a team topic such as notifications.team.deploy-squad.all) is live only: it reaches every subscribed session that holds its own NATS connection, yours included, and is not retained. A session the listener delivers to over a serve port, such as an OpenCode agent, receives nothing on such a topic and is told nothing (dispatch://INFRA-122). ${DELIVERY_CONTRACT}`,
+    description: `Publish an Envoy message to a notifications. topic. A role or built-in topic is delivered as its guide says; any other notifications. topic you name (a team topic such as notifications.team.deploy-squad.all) is live only: it reaches every session subscribed to it when you publish, and is not retained. A session that holds its own NATS connection receives it directly, yours included; a session the listener delivers to over a serve port, such as an OpenCode agent, receives it through its machine's listener when that listener subscribes to every topic (ENVOY_SUBSCRIBE_ALL_TOPICS=1; the shared hub's listener does not). ${DELIVERY_CONTRACT}`,
     arguments: (schema) => ({ topic: schema.string(), ...messageArguments(schema) }),
     operation: EnvoyToolOperation.publish
   },
@@ -34724,12 +34807,17 @@ var REPLAY_ARRAY_BYTES = 2;
 function jsonBytes(value) {
   return encoder.encode(JSON.stringify(value)).length;
 }
-function readModel(message) {
-  if (typeof message.model !== "string" || message.model === "")
+var SEQ_PER_MS = 1000;
+function modelReference(provider, id) {
+  if (typeof id !== "string" || id === "")
     return;
-  if (typeof message.provider !== "string" || message.provider === "")
+  if (typeof provider !== "string" || provider === "")
     return;
-  return capAgentStreamText(`${message.provider}/${message.model}`, AGENT_STREAM_LIMITS.modelChars);
+  return `${provider}/${id}`;
+}
+function readModel(message) {
+  const model = modelReference(message.provider, message.model);
+  return model === undefined ? undefined : capAgentStreamText(model, AGENT_STREAM_LIMITS.modelChars);
 }
 function readMessage(raw) {
   if (typeof raw !== "object" || raw === null)
@@ -34854,16 +34942,31 @@ class AgentStreamPublisher {
   #history = new Map;
   #settled = new Set;
   #publishedAt = new Map;
-  #seq = 0;
+  #seq;
   #watchedUntil = 0;
+  #listedCommands;
   #commands;
   #commandsSeq = 0;
+  #settings;
+  #settingsSeq = 0;
+  #settingsJson;
   constructor(deps) {
     this.#deps = deps;
+    this.#seq = Math.trunc(deps.now()) * SEQ_PER_MS;
   }
   noteViewer() {
     this.#watchedUntil = this.#deps.now() + AGENT_STREAM_WATCH_TTL_MS;
   }
+  publishState(subject2) {
+    if (!this.watched)
+      return;
+    if (this.#settings !== undefined) {
+      this.#deps.publish(subject2, JSON.stringify(this.#settingsFrame(this.#settings)));
+    }
+    if (this.#commands !== undefined) {
+      this.#deps.publish(subject2, JSON.stringify(this.#commandsFrame(this.#commands)));
+    }
+  }
   get watched() {
     return this.#deps.now() < this.#watchedUntil;
   }
@@ -34872,35 +34975,67 @@ class AgentStreamPublisher {
     this.#settled.clear();
     this.#publishedAt.clear();
     this.#watchedUntil = 0;
+    this.#listedCommands = undefined;
     this.#commands = undefined;
+    this.#settings = undefined;
+    this.#settingsJson = undefined;
   }
   setCommands(subject2, commands) {
-    const limit = AGENT_STREAM_LIMITS.historyBytes - REPLAY_ARRAY_BYTES;
-    let bytes = jsonBytes(this.#commandsFrame([], this.#seq + 1));
     const seen = new Set;
-    const kept = [];
+    const listed = [];
     for (const command of commands) {
-      if (kept.length >= AGENT_STREAM_LIMITS.commands)
+      if (listed.length >= AGENT_STREAM_LIMITS.commands)
         break;
       const name = command.name;
       if (name.length > AGENT_STREAM_LIMITS.commandNameChars)
         continue;
       if (!isTypableCommandName(name) || seen.has(name))
         continue;
-      const listed = {
+      seen.add(name);
+      listed.push({
         name,
         source: command.source,
         ...command.description !== undefined && {
           description: capAgentStreamText(command.description, AGENT_STREAM_LIMITS.commandDescriptionChars)
         },
         ...command.terminalOnly === true && { terminalOnly: true }
-      };
-      const cost = jsonBytes(listed) + (kept.length === 0 ? 0 : 1);
+      });
+    }
+    this.#listedCommands = listed;
+    this.#fitCommands(subject2);
+  }
+  setSettings(subject2, settings) {
+    const kept = settings.reported ? {
+      ...settings.model !== undefined && { model: settings.model },
+      models: [...settings.models],
+      reported: true,
+      thinking: settings.thinking === null ? null : { level: settings.thinking.level, levels: [...settings.thinking.levels] }
+    } : { reported: false };
+    const json2 = JSON.stringify(kept);
+    if (json2 === this.#settingsJson)
+      return;
+    this.#settings = kept;
+    this.#settingsJson = json2;
+    this.#seq += 1;
+    this.#settingsSeq = this.#seq;
+    if (this.watched)
+      this.#deps.publish(subject2, JSON.stringify(this.#settingsFrame(kept)));
+    this.#fitCommands(subject2);
+  }
+  #fitCommands(subject2) {
+    const listed = this.#listedCommands;
+    if (listed === undefined)
+      return;
+    const settings = this.#settings === undefined ? 0 : jsonBytes(this.#settingsFrame(this.#settings)) + 1;
+    const limit = AGENT_STREAM_LIMITS.historyBytes - REPLAY_ARRAY_BYTES - settings;
+    let bytes = jsonBytes(this.#commandsFrame([], this.#seq + 1));
+    const kept = [];
+    for (const command of listed) {
+      const cost = jsonBytes(command) + (kept.length === 0 ? 0 : 1);
       if (bytes + cost > limit)
         break;
       bytes += cost;
-      seen.add(name);
-      kept.push(listed);
+      kept.push(command);
     }
     if (JSON.stringify(kept) === JSON.stringify(this.#commands))
       return;
@@ -34913,6 +35048,9 @@ class AgentStreamPublisher {
   #commandsFrame(commands, seq = this.#commandsSeq) {
     return { commands, kind: "commands", seq, v: AGENT_STREAM_PROTOCOL };
   }
+  #settingsFrame(settings) {
+    return { ...settings, kind: "settings", seq: this.#settingsSeq, v: AGENT_STREAM_PROTOCOL };
+  }
   record(subject2, raw, streaming, dispatchMessageId) {
     const message = readMessage(raw);
     if (message === null)
@@ -34958,23 +35096,26 @@ class AgentStreamPublisher {
     if (!this.watched)
       return { frames: [], session_id: sessionID, v: AGENT_STREAM_PROTOCOL };
     const ordered = [...this.#history.values()].sort((left, right) => left.at === right.at ? left.seq - right.seq : left.at - right.at);
-    const commands = this.#commands === undefined ? undefined : this.#commandsFrame(this.#commands);
-    let used = REPLAY_ARRAY_BYTES + (commands === undefined ? 0 : jsonBytes(commands));
+    const tail = [];
+    if (this.#settings !== undefined)
+      tail.push(this.#settingsFrame(this.#settings));
+    if (this.#commands !== undefined)
+      tail.push(this.#commandsFrame(this.#commands));
+    let used = REPLAY_ARRAY_BYTES + tail.reduce((bytes, frame, index) => bytes + jsonBytes(frame) + (index === 0 ? 0 : 1), 0);
     const kept = [];
     for (let index = ordered.length - 1;index >= 0; index -= 1) {
       const entry = ordered[index];
       if (entry === undefined)
         continue;
       const frame = frameFor(entry);
-      const separated = kept.length > 0 || commands !== undefined;
+      const separated = kept.length > 0 || tail.length > 0;
       const cost = jsonBytes(frame) + (separated ? 1 : 0);
       if (used + cost > AGENT_STREAM_LIMITS.historyBytes)
         break;
       used += cost;
       kept.unshift(frame);
     }
-    if (commands !== undefined)
-      kept.push(commands);
+    kept.push(...tail);
     return { frames: kept, session_id: sessionID, v: AGENT_STREAM_PROTOCOL };
   }
 }
@@ -35334,6 +35475,25 @@ import("@oh-my-pi/pi-coding-agent/extensibility/extensions/send-user-input-handl
 }, () => {
   return;
 });
+function liveAgentSession(session) {
+  return host2.AgentRegistry?.global().list().find((ref) => ref.session?.sessionManager.getSessionId() === session)?.session ?? undefined;
+}
+function liveSessionSettings(live) {
+  if (live === undefined || !("model" in live) || typeof live.configuredThinkingLevel !== "function" || typeof live.getAvailableModels !== "function" || typeof live.getAvailableEffortSelectors !== "function") {
+    return { reported: false };
+  }
+  const model = modelReference(live.model?.provider, live.model?.id);
+  const levels = live.getAvailableEffortSelectors();
+  return {
+    ...model !== undefined && { model },
+    models: live.getAvailableModels().flatMap((available) => {
+      const listed = modelReference(available.provider, available.id);
+      return listed === undefined ? [] : [listed];
+    }),
+    reported: true,
+    thinking: levels.length === 0 ? null : { level: live.configuredThinkingLevel() ?? null, levels }
+  };
+}
 var codec2 = import_nats2.StringCodec();
 var NATS_RETRY_INTERVAL_MS = 15000;
 var DELIVERY_PICTURES_TIMEOUT_MS = 20000;
@@ -35739,6 +35899,7 @@ function envoyExtension(pi) {
       typedPictures.withdraw(turn.messageId);
       return typedInputReply(turn.body, { error: messageFor(error48) });
     }).then(async (reply) => {
+      refreshAgentStreamSettings(sessionID);
       if (reply !== undefined)
         await postDispatchReply(delivery, { body: reply }, replySessionID);
     }).catch((error48) => {
@@ -35960,7 +36121,7 @@ function envoyExtension(pi) {
       return;
     const builtins = hostBuiltinCommands?.() ?? [];
     const reserved = new Set(builtins.flatMap((builtin) => [builtin.name, ...builtin.aliases]));
-    const live = host2.AgentRegistry?.global().list().find((ref) => ref.session?.sessionManager.getSessionId() === session)?.session;
+    const live = liveAgentSession(session);
     const commands = builtins.map((builtin) => ({
       description: builtin.description,
       name: builtin.name,
@@ -35986,6 +36147,18 @@ function envoyExtension(pi) {
     }
     agentStream.setCommands(agentStreamFramesSubject(session), commands);
   };
+  const refreshAgentStreamSettings = (session) => {
+    if (session === "")
+      return;
+    try {
+      agentStream.setSettings(agentStreamFramesSubject(session), liveSessionSettings(liveAgentSession(session)));
+    } catch (error48) {
+      logger3.warn("envoy: could not refresh agent stream settings", {
+        error: messageFor(error48),
+        sessionID: session
+      });
+    }
+  };
   const pumpAgentStreamControl = async (subscription, session) => {
     try {
       for await (const message of subscription) {
@@ -35996,6 +36169,7 @@ function envoyExtension(pi) {
           const request = parsed;
           if (request.type !== "replay" && request.type !== "watch")
             continue;
+          refreshAgentStreamSettings(session);
           const attached = agentStreamViewerAttached;
           if (request.type === "replay" || !attached || Date.now() - agentStreamCommandsRefreshedOnWatchAt >= AGENT_STREAM_WATCH_INTERVAL_MS) {
             try {
@@ -36012,8 +36186,11 @@ function envoyExtension(pi) {
           }
           const reply = message.reply;
           const answer = request.type === "replay" && reply !== undefined ? JSON.stringify(agentStream.replay(session)) : undefined;
+          const arming = !agentStream.watched;
           agentStream.noteViewer();
           agentStreamViewerAttached = true;
+          if (arming)
+            agentStream.publishState(agentStreamFramesSubject(session));
           if (answer === undefined || reply === undefined)
             continue;
           connection?.publish(reply, codec2.encode(answer));
@@ -36072,6 +36249,12 @@ function envoyExtension(pi) {
   pi.on("message_end", async (event) => {
     recordAgentStreamMessage(event.message, false);
   });
+  pi.on("turn_start", async () => {
+    refreshAgentStreamSettings(sessionID);
+  });
+  pi.on("retry_fallback_applied", async () => {
+    refreshAgentStreamSettings(sessionID);
+  });
   const endRole = () => {
     claimedRoleTopic = undefined;
     claimedRoleSessionID = undefined;

package/dist/skills/dispatch/SKILL.md

@@ -136,7 +136,7 @@ EOF
 
 - Attach every architectural issue to the components it changes. Attach the root before you decompose it: children inherit.
 - `--components-json '{"mode":"explicit","ids":["web"]}'`, `'{"mode":"none","reason":"hiring, not code"}'` (only for non-architectural work, with a concrete reason), or `'{"mode":"inherit"}'`.
-- Component ids: each non-external `components[].id` from `GET /api/v1/projects/{key}/architecture`, or the file names under `.dispatch/architecture/` in its source repository. Others are refused `COMPONENTS_INPUT`. A closed issue can be classified without reopening.
+- Component ids: each non-external `components[].id` from `GET /api/v1/projects/{key}/architecture`, or the file names under `.dispatch/architecture/` in any of the project's source repositories. A project may import from several; ids are project-wide, so one issue can name components of different sources. Others are refused `COMPONENTS_INPUT`. A closed issue can be classified without reopening.
 - Change code and `.dispatch/architecture/<id>.md` in the same review. A stale model: `dispatch architecture-sync` ([issues.md](skill://dispatch/references/issues.md#syncing-a-projects-architecture-model)).
 
 ## Close what you opened

package/dist/skills/dispatch/references/issues.md

@@ -63,4 +63,4 @@ As a surface's owner, run `dispatch issues --project <KEY> --priority 0 --priori
 
 ## Syncing a project's architecture model
 
-`dispatch architecture-sync --project CORE` imports the model now. It prints the commit, or the error, and keeps the old model. No source configured answers `SOURCE_NOT_FOUND`.
+A project imports its model from one or more source repositories, each on its own branch. `dispatch architecture-sync --project CORE` imports every source now and prints a line for each: `Synced CORE architecture from <repo>@<branch>: commit <sha> (<time>).`, or `Sync failed for CORE (<repo>@<branch>): <error>` followed by what of that source still shows: its commit, its component count when the source was re-saved on another branch and has not imported from it yet, or that none ever imported. A failed source keeps its previous components; every other source is untouched. `--repo <owner/name>` imports that one source alone. No source configured, or no source from that repository, answers `SOURCE_NOT_FOUND`. A credential or branch problem is that source's failed line, or with `--repo` an error, `SOURCE_ACCESS`.