@m8t-stack/cli 0.2.19 → 0.2.21

package/dist/cli.js

@@ -1157,6 +1157,10 @@ async function enableHostedBrain(args) {
     memory: def.memory,
     env,
     metadata: {
+      // Spread the current metadata first so unmanaged keys (a2a, a2aCard, …)
+      // survive the relink version; the managed fields are re-asserted over the
+      // spread, and createCoderVersion applies the `brain` arg last.
+      ...current.metadata,
       source: "m8t-stack-POC",
       kind: "hosted",
       persona: current.metadata?.persona ?? "coding-agent",
@@ -1227,7 +1231,7 @@ var init_enable_hosted_brain = __esm({
 import { Builtins, Cli } from "clipanion";
 
 // src/lib/package-version.ts
-var CLI_VERSION = "0.2.19";
+var CLI_VERSION = "0.2.21";
 
 // src/lib/render-error.ts
 init_errors();
@@ -3326,12 +3330,12 @@ function encodeURIPath(str4) {
   return str4.replace(/[^A-Za-z0-9\-._~!$&'()*+,;=:@]+/g, encodeURIComponent);
 }
 var EMPTY = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.create(null));
-var createPathTagFunction = (pathEncoder = encodeURIPath) => function path33(statics, ...params) {
+var createPathTagFunction = (pathEncoder = encodeURIPath) => function path37(statics, ...params) {
   if (statics.length === 1)
     return statics[0];
   let postPath = false;
   const invalidSegments = [];
-  const path34 = statics.reduce((previousValue, currentValue, index) => {
+  const path38 = statics.reduce((previousValue, currentValue, index) => {
     if (/[?#]/.test(currentValue)) {
       postPath = true;
     }
@@ -3348,7 +3352,7 @@ var createPathTagFunction = (pathEncoder = encodeURIPath) => function path33(sta
     }
     return previousValue + currentValue + (index === params.length ? "" : encoded);
   }, "");
-  const pathOnly = path34.split(/[?#]/, 1)[0];
+  const pathOnly = path38.split(/[?#]/, 1)[0];
   const invalidSegmentPattern = /(?<=^|\/)(?:\.|%2e){1,2}(?=\/|$)/gi;
   let match;
   while ((match = invalidSegmentPattern.exec(pathOnly)) !== null) {
@@ -3369,10 +3373,10 @@ var createPathTagFunction = (pathEncoder = encodeURIPath) => function path33(sta
     }, "");
     throw new OpenAIError(`Path parameters result in path with invalid segments:
 ${invalidSegments.map((e) => e.error).join("\n")}
-${path34}
+${path38}
 ${underline}`);
   }
-  return path34;
+  return path38;
 };
 var path = /* @__PURE__ */ createPathTagFunction(encodeURIPath);
 
@@ -10889,9 +10893,9 @@ var OpenAI = class {
     this.apiKey = token;
     return true;
   }
-  buildURL(path33, query, defaultBaseURL) {
+  buildURL(path37, query, defaultBaseURL) {
     const baseURL = !__classPrivateFieldGet(this, _OpenAI_instances, "m", _OpenAI_baseURLOverridden).call(this) && defaultBaseURL || this.baseURL;
-    const url = isAbsoluteURL(path33) ? new URL(path33) : new URL(baseURL + (baseURL.endsWith("/") && path33.startsWith("/") ? path33.slice(1) : path33));
+    const url = isAbsoluteURL(path37) ? new URL(path37) : new URL(baseURL + (baseURL.endsWith("/") && path37.startsWith("/") ? path37.slice(1) : path37));
     const defaultQuery = this.defaultQuery();
     const pathQuery = Object.fromEntries(url.searchParams);
     if (!isEmptyObj(defaultQuery) || !isEmptyObj(pathQuery)) {
@@ -10919,24 +10923,24 @@ var OpenAI = class {
    */
   async prepareRequest(request, { url, options }) {
   }
-  get(path33, opts) {
-    return this.methodRequest("get", path33, opts);
+  get(path37, opts) {
+    return this.methodRequest("get", path37, opts);
   }
-  post(path33, opts) {
-    return this.methodRequest("post", path33, opts);
+  post(path37, opts) {
+    return this.methodRequest("post", path37, opts);
   }
-  patch(path33, opts) {
-    return this.methodRequest("patch", path33, opts);
+  patch(path37, opts) {
+    return this.methodRequest("patch", path37, opts);
   }
-  put(path33, opts) {
-    return this.methodRequest("put", path33, opts);
+  put(path37, opts) {
+    return this.methodRequest("put", path37, opts);
   }
-  delete(path33, opts) {
-    return this.methodRequest("delete", path33, opts);
+  delete(path37, opts) {
+    return this.methodRequest("delete", path37, opts);
   }
-  methodRequest(method, path33, opts) {
+  methodRequest(method, path37, opts) {
     return this.request(Promise.resolve(opts).then((opts2) => {
-      return { method, path: path33, ...opts2 };
+      return { method, path: path37, ...opts2 };
     }));
   }
   request(options, remainingRetries = null) {
@@ -11058,8 +11062,8 @@ var OpenAI = class {
     }));
     return { response, options, controller, requestLogID, retryOfRequestLogID, startTime };
   }
-  getAPIList(path33, Page2, opts) {
-    return this.requestAPIList(Page2, opts && "then" in opts ? opts.then((opts2) => ({ method: "get", path: path33, ...opts2 })) : { method: "get", path: path33, ...opts });
+  getAPIList(path37, Page2, opts) {
+    return this.requestAPIList(Page2, opts && "then" in opts ? opts.then((opts2) => ({ method: "get", path: path37, ...opts2 })) : { method: "get", path: path37, ...opts });
   }
   requestAPIList(Page2, options) {
     const request = this.makeRequest(options, null, void 0);
@@ -11153,8 +11157,8 @@ var OpenAI = class {
   }
   async buildRequest(inputOptions, { retryCount = 0 } = {}) {
     const options = { ...inputOptions };
-    const { method, path: path33, query, defaultBaseURL } = options;
-    const url = this.buildURL(path33, query, defaultBaseURL);
+    const { method, path: path37, query, defaultBaseURL } = options;
+    const url = this.buildURL(path37, query, defaultBaseURL);
     if ("timeout" in options)
       validatePositiveInteger("timeout", options.timeout);
     options.timeout = options.timeout ?? this.timeout;
@@ -12156,10 +12160,10 @@ var BindListCommand = class extends M8tCommand {
     const qs = new URLSearchParams();
     if (this.channel) qs.set("channel", this.channel);
     if (this.status) qs.set("status", this.status);
-    const path33 = qs.toString().length > 0 ? `/api/bindings?${qs.toString()}` : "/api/bindings";
+    const path37 = qs.toString().length > 0 ? `/api/bindings?${qs.toString()}` : "/api/bindings";
     const data = await apiCall(
       { gatewayUrl: ctx.gatewayUrl, gatewayClientId: ctx.gatewayClientId },
-      { method: "GET", path: path33 },
+      { method: "GET", path: path37 },
       (msg) => this.context.stderr.write(msg + "\n")
     );
     if (mode === "json") {
@@ -13370,8 +13374,8 @@ ${r.stderr}`;
         message: `gh api /repos/${slug} failed (exit ${r.exitCode.toString()}): ${(r.stderr || r.stdout).slice(0, 200)}`
       });
     },
-    getFile: async (path33) => {
-      const r = await exec("gh", ["api", "-H", "Accept: application/vnd.github.raw+json", `/repos/${slug}/contents/${path33}`]);
+    getFile: async (path37) => {
+      const r = await exec("gh", ["api", "-H", "Accept: application/vnd.github.raw+json", `/repos/${slug}/contents/${path37}`]);
       return r.exitCode === 0 ? r.stdout : null;
     },
     isEmpty: async () => {
@@ -13615,11 +13619,11 @@ var BrainCheckAppCommand = class extends M8tCommand {
 // src/commands/brain/create.ts
 init_esm2();
 import { Command as Command18, Option as Option17 } from "clipanion";
-import { spawnSync } from "child_process";
+import { execFileSync, spawnSync } from "child_process";
 import { readFileSync as readFileSync6 } from "fs";
-import * as fs10 from "fs";
+import * as fs11 from "fs";
 import * as os4 from "os";
-import * as path9 from "path";
+import * as path10 from "path";
 import * as readline2 from "readline/promises";
 import { DefaultAzureCredential as DefaultAzureCredential4 } from "@azure/identity";
 init_errors();
@@ -14135,11 +14139,66 @@ async function createBrainEnabledVersion(args) {
 
 // src/lib/brain-seed.ts
 init_errors();
+import * as fs10 from "fs";
+import * as path9 from "path";
+
+// src/lib/seed-manifest.ts
 import * as fs9 from "fs";
 import * as path8 from "path";
+var SEED_MANIFEST_PATH = ".m8t/seed-manifest.json";
+var SEED_PATHS = ["skills", "references", "targets"];
+function isLineage(v) {
+  if (!v || typeof v !== "object") return false;
+  const l = v;
+  return typeof l.name === "string" && typeof l.refreshedToCommit === "string" && typeof l.refreshedToVersion === "string" && Array.isArray(l.ownedPaths) && l.ownedPaths.every((p) => typeof p === "string");
+}
+function parseSeedManifest(text) {
+  if (!text?.trim()) return null;
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    return null;
+  }
+  if (!parsed || typeof parsed !== "object") return null;
+  const m = parsed;
+  if (m.schemaVersion !== 1 || !Array.isArray(m.seeds) || !m.seeds.every(isLineage)) return null;
+  return { schemaVersion: 1, seeds: m.seeds };
+}
+function buildSeedManifest(seeds) {
+  return { schemaVersion: 1, seeds };
+}
+function upsertLineage(manifest, lineage) {
+  const prior = manifest?.seeds ?? [];
+  const others = prior.filter((s) => s.name !== lineage.name);
+  return { schemaVersion: 1, seeds: [...others, lineage].sort((a, b) => a.name.localeCompare(b.name)) };
+}
+function serializeSeedManifest(m) {
+  return JSON.stringify(m, null, 2) + "\n";
+}
+function walkFiles(root, rel = "") {
+  const abs = path8.join(root, rel);
+  if (!fs9.existsSync(abs)) return [];
+  const out = [];
+  for (const entry of fs9.readdirSync(abs, { withFileTypes: true })) {
+    const childRel = rel ? `${rel}/${entry.name}` : entry.name;
+    if (entry.isDirectory()) out.push(...walkFiles(root, childRel));
+    else if (entry.isFile()) out.push(childRel);
+  }
+  return out;
+}
+function deriveOwnedPaths(seedDir) {
+  const owned = /* @__PURE__ */ new Set([SEED_MANIFEST_PATH]);
+  for (const sub of SEED_PATHS) {
+    for (const rel of walkFiles(path8.join(seedDir, sub))) owned.add(`${sub}/${rel}`);
+  }
+  return [...owned].sort((a, b) => a.localeCompare(b));
+}
+
+// src/lib/brain-seed.ts
 function resolveSeed(name) {
-  const dir = path8.join(resolveRepoRoot(), "brain-seeds", name);
-  if (!fs9.existsSync(dir)) {
+  const dir = path9.join(resolveRepoRoot(), "brain-seeds", name);
+  if (!fs10.existsSync(dir)) {
     throw new LocalCliError({
       code: "SEED_NOT_FOUND",
       message: `--seed "${name}": no brain-seeds/${name}/ directory found.`,
@@ -14149,11 +14208,22 @@ function resolveSeed(name) {
   return dir;
 }
 function materializeBrainTree(opts) {
-  fs9.cpSync(opts.templateSrc, opts.destDir, { recursive: true });
+  fs10.cpSync(opts.templateSrc, opts.destDir, { recursive: true });
   if (opts.seedDir) {
-    fs9.cpSync(opts.seedDir, opts.destDir, { recursive: true });
+    fs10.cpSync(opts.seedDir, opts.destDir, { recursive: true });
   }
 }
+function writeSeedMarker(args) {
+  const manifest = buildSeedManifest([{
+    name: args.seedName,
+    refreshedToCommit: args.refreshedToCommit,
+    refreshedToVersion: args.version,
+    ownedPaths: deriveOwnedPaths(args.seedDir)
+  }]);
+  const dest = path9.join(args.destDir, SEED_MANIFEST_PATH);
+  fs10.mkdirSync(path9.dirname(dest), { recursive: true });
+  fs10.writeFileSync(dest, serializeSeedManifest(manifest));
+}
 
 // src/lib/github-app-repo.ts
 init_errors();
@@ -14260,18 +14330,32 @@ async function mintInstallationTokenFromPem(args) {
 }
 async function readRepoFileViaApp(args) {
   const doFetch = args.fetchImpl ?? fetch;
-  const res = await doFetch(`${GH_API}/repos/${args.repo}/contents/${args.path}`, { headers: ghHeaders(args.token), signal: AbortSignal.timeout(GH_REQUEST_TIMEOUT_MS) });
+  const q = args.ref ? `?ref=${encodeURIComponent(args.ref)}` : "";
+  const res = await doFetch(`${GH_API}/repos/${args.repo}/contents/${args.path}${q}`, { headers: ghHeaders(args.token), signal: AbortSignal.timeout(GH_REQUEST_TIMEOUT_MS) });
   if (res.status === 404) return null;
   const text = await res.text();
   if (!res.ok) {
     throw new LocalCliError({
       code: "GH_APP_FILE_READ_FAILED",
-      message: `GET /repos/${args.repo}/contents/${args.path} HTTP ${res.status.toString()}: ${text.slice(0, 300)}`
+      message: `GET /repos/${args.repo}/contents/${args.path}${q} HTTP ${res.status.toString()}: ${text.slice(0, 300)}`
     });
   }
   const data = JSON.parse(text);
   return Buffer.from(data.content ?? "", "base64").toString("utf8");
 }
+async function getInitialSeedCommitSha(args) {
+  const doFetch = args.fetchImpl ?? fetch;
+  const H = ghHeaders(args.token);
+  const first = await doFetch(`${GH_API}/repos/${args.repo}/commits?per_page=1`, { headers: H, signal: AbortSignal.timeout(GH_REQUEST_TIMEOUT_MS) });
+  if (!first.ok) return null;
+  const link = first.headers.get("link");
+  const lastUrl = /<([^>]+)>;\s*rel="last"/.exec(link ?? "")?.[1];
+  const url = lastUrl ?? `${GH_API}/repos/${args.repo}/commits?per_page=1`;
+  const res = await doFetch(url, { headers: H, signal: AbortSignal.timeout(GH_REQUEST_TIMEOUT_MS) });
+  if (!res.ok) return null;
+  const commits = JSON.parse(await res.text());
+  return commits.length > 0 ? commits[commits.length - 1].sha ?? null : null;
+}
 async function commitFilesViaApp(args) {
   const doFetch = args.fetchImpl ?? fetch;
   const H = ghHeaders(args.token);
@@ -14289,19 +14373,68 @@ async function commitFilesViaApp(args) {
   const ref = await api(`/git/ref/heads/${args.branch}`);
   const baseCommitSha = ref.object.sha;
   const baseCommit = await api(`/git/commits/${baseCommitSha}`);
-  const blobs = await Promise.all(args.files.map((f) => api(`/git/blobs`, { method: "POST", body: JSON.stringify({ content: f.content, encoding: "utf-8" }) })));
-  const tree = await api(`/git/trees`, {
+  const upserts = args.files.filter((f) => !("delete" in f));
+  const blobs = await Promise.all(upserts.map((f) => api(`/git/blobs`, { method: "POST", body: JSON.stringify({ content: f.content, encoding: "utf-8" }) })));
+  const tree = args.files.map((f) => "delete" in f ? { path: f.path, mode: "100644", type: "blob", sha: null } : { path: f.path, mode: "100644", type: "blob", sha: blobs[upserts.indexOf(f)].sha });
+  const newTree = await api(`/git/trees`, { method: "POST", body: JSON.stringify({ base_tree: baseCommit.tree.sha, tree }) });
+  const commit = await api(`/git/commits`, {
     method: "POST",
-    body: JSON.stringify({
-      base_tree: baseCommit.tree.sha,
-      tree: args.files.map((f, i) => ({ path: f.path, mode: "100644", type: "blob", sha: blobs[i].sha }))
-    })
+    body: JSON.stringify({ message: args.message, tree: newTree.sha, parents: [baseCommitSha] })
+  });
+  await api(`/git/refs/heads/${args.branch}`, { method: "PATCH", body: JSON.stringify({ sha: commit.sha }) });
+}
+async function createBranchViaApp(args) {
+  const doFetch = args.fetchImpl ?? fetch;
+  const H = ghHeaders(args.token);
+  const res = await doFetch(`${GH_API}/repos/${args.repo}/git/refs`, {
+    method: "POST",
+    headers: H,
+    signal: AbortSignal.timeout(GH_REQUEST_TIMEOUT_MS),
+    body: JSON.stringify({ ref: `refs/heads/${args.branch}`, sha: args.fromSha })
+  });
+  if (res.ok) return;
+  if (res.status === 422) {
+    const patch = await doFetch(`${GH_API}/repos/${args.repo}/git/refs/heads/${args.branch}`, {
+      method: "PATCH",
+      headers: H,
+      signal: AbortSignal.timeout(GH_REQUEST_TIMEOUT_MS),
+      body: JSON.stringify({ sha: args.fromSha, force: true })
+    });
+    if (patch.ok) return;
+    throw new LocalCliError({
+      code: "GH_APP_BRANCH_FAILED",
+      message: `PATCH refs/heads/${args.branch} HTTP ${patch.status.toString()}: ${(await patch.text()).slice(0, 300)}`
+    });
+  }
+  throw new LocalCliError({
+    code: "GH_APP_BRANCH_FAILED",
+    message: `POST /git/refs HTTP ${res.status.toString()}: ${(await res.text()).slice(0, 300)}`
   });
+}
+async function commitFilesFromBaseViaApp(args) {
+  const doFetch = args.fetchImpl ?? fetch;
+  const H = ghHeaders(args.token);
+  const api = async (p, init) => {
+    const res = await doFetch(`${GH_API}/repos/${args.repo}${p}`, init ? { ...init, headers: H, signal: AbortSignal.timeout(GH_REQUEST_TIMEOUT_MS) } : { headers: H, signal: AbortSignal.timeout(GH_REQUEST_TIMEOUT_MS) });
+    const text = await res.text();
+    if (!res.ok) {
+      throw new LocalCliError({
+        code: "GH_APP_COMMIT_FAILED",
+        message: `${init?.method ?? "GET"} ${p} HTTP ${res.status.toString()}: ${text.slice(0, 300)}`
+      });
+    }
+    return text ? JSON.parse(text) : {};
+  };
+  const baseCommit = await api(`/git/commits/${args.baseSha}`);
+  const upserts = args.files.filter((f) => !("delete" in f));
+  const blobs = await Promise.all(upserts.map((f) => api(`/git/blobs`, { method: "POST", body: JSON.stringify({ content: f.content, encoding: "utf-8" }) })));
+  const tree = args.files.map((f) => "delete" in f ? { path: f.path, mode: "100644", type: "blob", sha: null } : { path: f.path, mode: "100644", type: "blob", sha: blobs[upserts.indexOf(f)].sha });
+  const newTree = await api(`/git/trees`, { method: "POST", body: JSON.stringify({ base_tree: baseCommit.tree.sha, tree }) });
   const commit = await api(`/git/commits`, {
     method: "POST",
-    body: JSON.stringify({ message: args.message, tree: tree.sha, parents: [baseCommitSha] })
+    body: JSON.stringify({ message: args.message, tree: newTree.sha, parents: [args.baseSha] })
   });
-  await api(`/git/refs/heads/${args.branch}`, { method: "PATCH", body: JSON.stringify({ sha: commit.sha }) });
+  await createBranchViaApp({ token: args.token, repo: args.repo, branch: args.branch, fromSha: commit.sha, fetchImpl: args.fetchImpl });
 }
 async function probeRepoState(probe) {
   const status = await probe.repoStatus();
@@ -14325,13 +14458,66 @@ function appRepoProbe(args) {
       const res = await doFetch(`${GH_API}/repos/${args.repo}`, { headers: H, signal: AbortSignal.timeout(GH_REQUEST_TIMEOUT_MS) });
       return res.status;
     },
-    getFile: (path33) => readRepoFileViaApp({ token: args.token, repo: args.repo, path: path33, fetchImpl: args.fetchImpl }),
+    getFile: (path37) => readRepoFileViaApp({ token: args.token, repo: args.repo, path: path37, fetchImpl: args.fetchImpl }),
     isEmpty: async () => {
       const res = await doFetch(`${GH_API}/repos/${args.repo}/contents`, { headers: H, signal: AbortSignal.timeout(GH_REQUEST_TIMEOUT_MS) });
       return res.status === 404;
     }
   };
 }
+async function openPullRequestViaApp(args) {
+  const doFetch = args.fetchImpl ?? fetch;
+  const res = await doFetch(`${GH_API}/repos/${args.repo}/pulls`, {
+    method: "POST",
+    headers: ghHeaders(args.token),
+    signal: AbortSignal.timeout(GH_REQUEST_TIMEOUT_MS),
+    body: JSON.stringify({ base: args.base, head: args.head, title: args.title, body: args.body })
+  });
+  const text = await res.text();
+  if (!res.ok) throw new LocalCliError({ code: "GH_APP_PR_OPEN_FAILED", message: `POST /pulls HTTP ${res.status.toString()}: ${text.slice(0, 300)}` });
+  const j = JSON.parse(text);
+  return { number: j.number, htmlUrl: j.html_url };
+}
+async function findOpenPr(args) {
+  const doFetch = args.fetchImpl ?? fetch;
+  const owner = args.repo.split("/")[0];
+  const res = await doFetch(`${GH_API}/repos/${args.repo}/pulls?state=open&head=${owner}:${args.head}`, { headers: ghHeaders(args.token), signal: AbortSignal.timeout(GH_REQUEST_TIMEOUT_MS) });
+  if (!res.ok) return null;
+  const list = JSON.parse(await res.text());
+  return list.length > 0 ? { number: list[0].number, htmlUrl: list[0].html_url } : null;
+}
+async function updatePullRequestViaApp(args) {
+  const doFetch = args.fetchImpl ?? fetch;
+  const patch = {};
+  if (args.title !== void 0) patch.title = args.title;
+  if (args.body !== void 0) patch.body = args.body;
+  const res = await doFetch(`${GH_API}/repos/${args.repo}/pulls/${args.number.toString()}`, {
+    method: "PATCH",
+    headers: ghHeaders(args.token),
+    signal: AbortSignal.timeout(GH_REQUEST_TIMEOUT_MS),
+    body: JSON.stringify(patch)
+  });
+  if (!res.ok) throw new LocalCliError({ code: "GH_APP_PR_UPDATE_FAILED", message: `PATCH /pulls/${args.number.toString()} HTTP ${res.status.toString()}: ${(await res.text()).slice(0, 300)}` });
+}
+async function closePullRequestViaApp(args) {
+  const doFetch = args.fetchImpl ?? fetch;
+  const H = ghHeaders(args.token);
+  if (args.comment) {
+    await doFetch(`${GH_API}/repos/${args.repo}/issues/${args.number.toString()}/comments`, {
+      method: "POST",
+      headers: H,
+      signal: AbortSignal.timeout(GH_REQUEST_TIMEOUT_MS),
+      body: JSON.stringify({ body: args.comment })
+    });
+  }
+  const res = await doFetch(`${GH_API}/repos/${args.repo}/pulls/${args.number.toString()}`, {
+    method: "PATCH",
+    headers: H,
+    signal: AbortSignal.timeout(GH_REQUEST_TIMEOUT_MS),
+    body: JSON.stringify({ state: "closed" })
+  });
+  if (!res.ok) throw new LocalCliError({ code: "GH_APP_PR_CLOSE_FAILED", message: `PATCH /pulls/${args.number.toString()} HTTP ${res.status.toString()}: ${(await res.text()).slice(0, 300)}` });
+}
 
 // src/lib/brain-repo-collision.ts
 init_errors();
@@ -14513,15 +14699,15 @@ var BrainCreateCommand = class extends M8tCommand {
       agentEndpoint
     });
     const repoRoot = resolveRepoRoot();
-    const templateSrc = path9.join(repoRoot, "brain-template");
-    if (!fs10.existsSync(templateSrc)) {
+    const templateSrc = path10.join(repoRoot, "brain-template");
+    if (!fs11.existsSync(templateSrc)) {
       throw new LocalCliError({
         code: "TEMPLATE_MISSING",
         message: `brain-template/ missing at ${templateSrc}`,
         hint: "Ensure brain-template/ exists at the repo root (same level as apps/)."
       });
     }
-    const tmpDir = fs10.mkdtempSync(path9.join(os4.tmpdir(), `m8t-brain-create-${worker}-`));
+    const tmpDir = fs11.mkdtempSync(path10.join(os4.tmpdir(), `m8t-brain-create-${worker}-`));
     let result;
     let resolvedInstallationId = null;
     const force = this.reuse === true ? "reuse" : this.newName === true ? "new" : void 0;
@@ -14558,6 +14744,10 @@ var BrainCreateCommand = class extends M8tCommand {
     try {
       if (needsPush) {
         materializeBrainTree({ templateSrc, destDir: tmpDir, seedDir });
+        if (seedName && seedDir) {
+          const headSha = execFileSync("git", ["rev-parse", "HEAD"], { cwd: repoRoot, encoding: "utf8" }).trim();
+          writeSeedMarker({ destDir: tmpDir, seedName, seedDir, refreshedToCommit: headSha, version: "(scaffold)" });
+        }
         this.context.stdout.write(
           seedName ? `${colors.dim("\u2192")} copied brain-template/ + overlaid seed ${colors.field(seedName)} to ${tmpDir}
 ` : `${colors.dim("\u2192")} copied brain-template/ to ${tmpDir}
@@ -14649,7 +14839,7 @@ var BrainCreateCommand = class extends M8tCommand {
         project
       });
     } finally {
-      fs10.rmSync(tmpDir, { recursive: true, force: true });
+      fs11.rmSync(tmpDir, { recursive: true, force: true });
     }
     if (mode === "json") {
       this.context.stdout.write(
@@ -14986,9 +15176,9 @@ init_errors();
 // src/lib/brain-unlink.ts
 init_esm2();
 init_errors();
-import * as fs11 from "fs";
+import * as fs12 from "fs";
 import * as os5 from "os";
-import * as path10 from "path";
+import * as path11 from "path";
 init_foundry_agent_get();
 var FOUNDRY_ARM_API2 = "2025-04-01-preview";
 var FOUNDRY_DATA_SCOPE2 = "https://ai.azure.com/.default";
@@ -15019,15 +15209,15 @@ async function unlinkBrain(args) {
   if (yaml?.personaPath) {
     let personaPath = yaml.personaPath;
     if (!personaPath.startsWith("/")) {
-      const marker = path10.join(args.home ?? os5.homedir(), ".m8t-stack", "repo-root");
-      if (!fs11.existsSync(marker)) {
+      const marker = path11.join(args.home ?? os5.homedir(), ".m8t-stack", "repo-root");
+      if (!fs12.existsSync(marker)) {
         throw new LocalCliError({
           code: "PERSONA_PATH_NOT_ABSOLUTE",
           message: `personaPath '${personaPath}' is relative and the repo-root marker is missing.`,
           hint: "Re-run 'm8t install' from a fresh m8t-stack checkout (writes ~/.m8t-stack/repo-root) \u2014 or edit the personaPath to absolute."
         });
       }
-      personaPath = path10.join(fs11.readFileSync(marker, "utf8").trim(), personaPath);
+      personaPath = path11.join(fs12.readFileSync(marker, "utf8").trim(), personaPath);
     }
     strippedInstructions = renderPersonaBody(personaPath, yaml.fillableFieldValues ?? {}, args.agentName);
   } else {
@@ -15267,27 +15457,27 @@ import { DefaultAzureCredential as DefaultAzureCredential9 } from "@azure/identi
 init_errors();
 
 // src/lib/deploy-prompt-advisor.ts
-import * as fs12 from "fs";
-import * as path11 from "path";
+import * as fs13 from "fs";
+import * as path12 from "path";
 import { parse as parseYaml6 } from "yaml";
 init_foundry_agents();
 init_errors();
 function findPersonasRoot(hint) {
-  let dir = path11.resolve(hint);
-  const fsRoot = path11.parse(dir).root;
+  let dir = path12.resolve(hint);
+  const fsRoot = path12.parse(dir).root;
   for (; ; ) {
-    if (fs12.existsSync(path11.join(dir, "personas"))) return dir;
-    const parent = path11.dirname(dir);
+    if (fs13.existsSync(path12.join(dir, "personas"))) return dir;
+    const parent = path12.dirname(dir);
     if (parent === dir || dir === fsRoot) return null;
     dir = parent;
   }
 }
 async function deployPromptAdvisor(args) {
   const resolvedRoot = findPersonasRoot(args.repoRoot);
-  const personaPath = resolvedRoot ? path11.join(resolvedRoot, "personas", args.persona, "persona.md") : path11.join(args.repoRoot, "personas", args.persona, "persona.md");
+  const personaPath = resolvedRoot ? path12.join(resolvedRoot, "personas", args.persona, "persona.md") : path12.join(args.repoRoot, "personas", args.persona, "persona.md");
   let raw;
   try {
-    raw = fs12.readFileSync(personaPath, "utf8");
+    raw = fs13.readFileSync(personaPath, "utf8");
   } catch (e) {
     throw new LocalCliError({
       code: "ADVISOR_PERSONA_MISSING",
@@ -15449,7 +15639,7 @@ init_errors();
 // src/lib/agent-remove.ts
 init_errors();
 init_foundry_agent_get();
-import * as fs14 from "fs";
+import * as fs15 from "fs";
 import { spawnSync as spawnSync2 } from "child_process";
 
 // src/lib/a2a-enable.ts
@@ -15563,12 +15753,12 @@ async function awaitAgentQueryable(args) {
 // src/lib/persona-a2a.ts
 init_errors();
 init_esm();
-import * as fs13 from "fs";
+import * as fs14 from "fs";
 import { parse as parseYaml7 } from "yaml";
 function readPersonaA2aCard(personaPath) {
   let raw;
   try {
-    raw = fs13.readFileSync(personaPath, "utf8");
+    raw = fs14.readFileSync(personaPath, "utf8");
   } catch (e) {
     throw new LocalCliError({ code: "PERSONA_READ_FAILED", message: `Could not read persona '${personaPath}': ${e.message}` });
   }
@@ -15893,7 +16083,7 @@ function defaultRemoveAgentDeps(args) {
     },
     removeLocalYaml(agentName) {
       const p = agentYamlPath(agentName, home);
-      if (fs14.existsSync(p)) fs14.rmSync(p);
+      if (fs15.existsSync(p)) fs15.rmSync(p);
     }
   };
 }
@@ -16035,16 +16225,16 @@ ${colors.success("\u2713")} removed ${colors.field(name)}.
 };
 
 // src/commands/a2a/enable.ts
-import * as path13 from "path";
+import * as path14 from "path";
 import { Command as Command25, Option as Option24 } from "clipanion";
 import { DefaultAzureCredential as DefaultAzureCredential11 } from "@azure/identity";
 init_errors();
 
 // src/lib/bridge-url.ts
 init_errors();
-import * as fs15 from "fs";
+import * as fs16 from "fs";
 import * as os6 from "os";
-import * as path12 from "path";
+import * as path13 from "path";
 import { parse as parseYaml8 } from "yaml";
 var A2A_PATH = "/api/a2a/mcp";
 function resolveBridgeUrl(opts) {
@@ -16066,10 +16256,10 @@ function clean(v) {
   return t.length ? t : void 0;
 }
 function readConfigGatewayUrl(home) {
-  const cfg = path12.join(home ?? os6.homedir(), ".m8t-stack", "config.yaml");
-  if (!fs15.existsSync(cfg)) return void 0;
+  const cfg = path13.join(home ?? os6.homedir(), ".m8t-stack", "config.yaml");
+  if (!fs16.existsSync(cfg)) return void 0;
   try {
-    const o = parseYaml8(fs15.readFileSync(cfg, "utf8"));
+    const o = parseYaml8(fs16.readFileSync(cfg, "utf8"));
     return typeof o.gatewayUrl === "string" ? o.gatewayUrl : void 0;
   } catch {
     return void 0;
@@ -16138,11 +16328,11 @@ var A2aEnableCommand = class extends M8tCommand {
   resolvePersonaPath() {
     if (typeof this.persona === "string" && this.persona.length > 0) {
       if (this.persona.includes("/") || this.persona.endsWith(".md")) return this.persona;
-      return path13.join(resolveRepoRoot(), "personas", this.persona, "persona.md");
+      return path14.join(resolveRepoRoot(), "personas", this.persona, "persona.md");
     }
     const yaml = readAgentYaml(this.worker);
     if (yaml?.personaPath) {
-      return yaml.personaPath.startsWith("/") ? yaml.personaPath : path13.join(resolveRepoRoot(), yaml.personaPath);
+      return yaml.personaPath.startsWith("/") ? yaml.personaPath : path14.join(resolveRepoRoot(), yaml.personaPath);
     }
     throw new LocalCliError({ code: "A2A_NO_PERSONA", message: `Could not resolve a persona for '${this.worker}'. Pass --persona <name>.` });
   }
@@ -16198,12 +16388,12 @@ import { Command as Command27 } from "clipanion";
 
 // src/lib/architect-version.ts
 import { createHash as createHash2 } from "crypto";
-import * as fs16 from "fs";
+import * as fs17 from "fs";
 import * as os7 from "os";
-import * as path14 from "path";
+import * as path15 from "path";
 function readVersionFrontmatter(file) {
-  if (!fs16.existsSync(file)) return "";
-  const text = fs16.readFileSync(file, "utf8");
+  if (!fs17.existsSync(file)) return "";
+  const text = fs17.readFileSync(file, "utf8");
   if (!text.startsWith("---")) return "";
   const closeIdx = text.indexOf("\n---", 3);
   if (closeIdx < 0) return "";
@@ -16212,23 +16402,23 @@ function readVersionFrontmatter(file) {
   return m ? m[1].trim() : "";
 }
 function sha256File(filePath) {
-  return createHash2("sha256").update(fs16.readFileSync(filePath)).digest("hex");
+  return createHash2("sha256").update(fs17.readFileSync(filePath)).digest("hex");
 }
 function checkArchitectDrift() {
-  const sourcePath = path14.join(
+  const sourcePath = path15.join(
     resolveRepoRoot(),
     "personas",
     "m8t-architect",
     "persona.md"
   );
-  const sidecarPath = path14.join(
+  const sidecarPath = path15.join(
     os7.homedir(),
     ".claude",
     "skills",
     "m8t-architect",
     ".m8t-skill.json"
   );
-  if (!fs16.existsSync(sourcePath)) {
+  if (!fs17.existsSync(sourcePath)) {
     return {
       match: false,
       sourceVersion: "",
@@ -16238,9 +16428,9 @@ function checkArchitectDrift() {
   }
   const sourceVersion = readVersionFrontmatter(sourcePath);
   let sidecar = null;
-  if (fs16.existsSync(sidecarPath)) {
+  if (fs17.existsSync(sidecarPath)) {
     try {
-      const raw = JSON.parse(fs16.readFileSync(sidecarPath, "utf8"));
+      const raw = JSON.parse(fs17.readFileSync(sidecarPath, "utf8"));
       if (raw !== null && typeof raw === "object") {
         const r = raw;
         sidecar = {
@@ -16303,7 +16493,7 @@ var ArchitectCheckCommand = class extends M8tCommand {
 
 // src/commands/coder/deploy.ts
 init_esm2();
-import * as path16 from "path";
+import * as path17 from "path";
 import { Command as Command28, Option as Option26 } from "clipanion";
 import { DefaultAzureCredential as DefaultAzureCredential13 } from "@azure/identity";
 init_errors();
@@ -16570,14 +16760,14 @@ async function deployHostedWorker(args) {
 }
 
 // src/lib/persona.ts
-import * as fs17 from "fs";
-import * as path15 from "path";
+import * as fs18 from "fs";
+import * as path16 from "path";
 import { parse as parseYaml9 } from "yaml";
 function findRepoRoot(startDir) {
-  let dir = path15.resolve(startDir);
+  let dir = path16.resolve(startDir);
   for (; ; ) {
-    if (fs17.existsSync(path15.join(dir, "personas"))) return dir;
-    const parent = path15.dirname(dir);
+    if (fs18.existsSync(path16.join(dir, "personas"))) return dir;
+    const parent = path16.dirname(dir);
     if (parent === dir) return null;
     dir = parent;
   }
@@ -16585,10 +16775,10 @@ function findRepoRoot(startDir) {
 function resolvePersona(persona, cwd = process.cwd()) {
   const root = findRepoRoot(cwd);
   if (!root) return { persona, personaVersion: null };
-  const file = path15.join(root, "personas", persona, "persona.md");
+  const file = path16.join(root, "personas", persona, "persona.md");
   let raw;
   try {
-    raw = fs17.readFileSync(file, "utf-8");
+    raw = fs18.readFileSync(file, "utf-8");
   } catch {
     return { persona, personaVersion: null };
   }
@@ -16925,7 +17115,7 @@ var CoderDeployCommand = class extends M8tCommand {
         projectEndpoint: project.endpoint,
         projectArmId: `${project.accountScope}/projects/${project.projectName}`,
         agentName: this.name,
-        personaPath: path16.join(resolveRepoRoot(), "personas", personaName, "persona.md"),
+        personaPath: path17.join(resolveRepoRoot(), "personas", personaName, "persona.md"),
         bridgeUrl,
         onProgress
       });
@@ -17051,7 +17241,7 @@ var CoderTeardownCommand = class extends M8tCommand {
 
 // src/commands/azure-exec/deploy.ts
 init_esm2();
-import * as path17 from "path";
+import * as path18 from "path";
 import { Command as Command30, Option as Option28 } from "clipanion";
 import { DefaultAzureCredential as DefaultAzureCredential15 } from "@azure/identity";
 init_errors();
@@ -17321,7 +17511,7 @@ var AzureExecDeployCommand = class extends M8tCommand {
       kvUri
     });
     onProgress?.("a2a-enabling as a target\u2026");
-    const personaPath = path17.join(resolveRepoRoot(), "personas", "azure-executor", "persona.md");
+    const personaPath = path18.join(resolveRepoRoot(), "personas", "azure-executor", "persona.md");
     const bridgeUrl = resolveBridgeUrl({
       flag: typeof this.gatewayUrl === "string" ? this.gatewayUrl : void 0,
       env: processEnv
@@ -17463,8 +17653,8 @@ async function fetchPublicTags(repo, fetchImpl = fetch) {
       hint: "Pass a ghcr.io/<owner>/<name> repo, or use the BYOC private-ACR deploy flow."
     });
   }
-  const path33 = repo.replace(/^ghcr\.io\//, "");
-  const tokenRes = await fetchImpl(`https://ghcr.io/token?scope=repository:${path33}:pull`);
+  const path37 = repo.replace(/^ghcr\.io\//, "");
+  const tokenRes = await fetchImpl(`https://ghcr.io/token?scope=repository:${path37}:pull`);
   if (!tokenRes.ok) {
     throw new LocalCliError({
       code: "PLATFORM_GHCR_TOKEN_FAILED",
@@ -17480,7 +17670,7 @@ async function fetchPublicTags(repo, fetchImpl = fetch) {
       hint: "Make the package public (deploy/ghcr-package-visibility.md), then retry."
     });
   }
-  const tagsRes = await fetchImpl(`https://ghcr.io/v2/${path33}/tags/list`, {
+  const tagsRes = await fetchImpl(`https://ghcr.io/v2/${path37}/tags/list`, {
     headers: { Authorization: `Bearer ${token}` }
   });
   if (!tagsRes.ok) {
@@ -17494,7 +17684,7 @@ async function fetchPublicTags(repo, fetchImpl = fetch) {
 }
 
 // src/lib/release-channel.ts
-import * as fs18 from "fs";
+import * as fs19 from "fs";
 
 // ../../packages/platform-release/dist/esm/manifest.js
 var SEVERITIES = ["critical", "recommended", "optional"];
@@ -17661,7 +17851,7 @@ function manifestSourceForVersionTag(channelUrl, version) {
   return { url: custom };
 }
 async function fetchManifest(source, deps = {}) {
-  const readFile8 = deps.readFile ?? ((p) => fs18.readFileSync(p, "utf8"));
+  const readFile8 = deps.readFile ?? ((p) => fs19.readFileSync(p, "utf8"));
   const fetchImpl = deps.fetchImpl ?? fetch;
   const ghToken = deps.ghToken ?? getGhToken;
   let raw;
@@ -17707,10 +17897,10 @@ async function fetchManifest(source, deps = {}) {
 }
 
 // src/lib/release-content.ts
-import * as fs19 from "fs";
+import * as fs20 from "fs";
 import * as os8 from "os";
-import * as path18 from "path";
-import { execFileSync } from "child_process";
+import * as path19 from "path";
+import { execFileSync as execFileSync2 } from "child_process";
 init_errors();
 var OWNER_REPO = "m8t-run/m8t";
 function parseTreeResponse(body) {
@@ -17748,15 +17938,15 @@ function verifyPersonaTrees(manifest, tree) {
 }
 async function resolveReleaseContent(manifest, opts = {}) {
   if (opts.contentDir) {
-    if (!fs19.existsSync(path18.join(opts.contentDir, "personas"))) {
+    if (!fs20.existsSync(path19.join(opts.contentDir, "personas"))) {
       throw new LocalCliError({ code: "PLATFORM_CONTENT_DIR_INVALID", message: `--content-dir '${opts.contentDir}' has no personas/ \u2014 not a repo checkout.` });
     }
     return opts.contentDir;
   }
   const commit = manifest.platform.commit;
-  const cacheRoot = opts.cacheRoot ?? path18.join(os8.homedir(), ".m8t-stack", "cache");
-  const dest = path18.join(cacheRoot, `release-${commit}`);
-  if (fs19.existsSync(path18.join(dest, "personas"))) return dest;
+  const cacheRoot = opts.cacheRoot ?? path19.join(os8.homedir(), ".m8t-stack", "cache");
+  const dest = path19.join(cacheRoot, `release-${commit}`);
+  if (fs20.existsSync(path19.join(dest, "personas"))) return dest;
   const fetchImpl = opts.fetchImpl ?? fetch;
   const ghToken = opts.ghToken ?? getGhToken;
   let token;
@@ -17770,19 +17960,19 @@ async function resolveReleaseContent(manifest, opts = {}) {
   if (!res.ok) {
     throw new LocalCliError({ code: "PLATFORM_TARBALL_FETCH_FAILED", message: `GET ${url} \u2192 HTTP ${res.status.toString()}.` });
   }
-  fs19.mkdirSync(cacheRoot, { recursive: true });
-  const tmp = fs19.mkdtempSync(path18.join(cacheRoot, `.dl-${commit.slice(0, 8)}-`));
+  fs20.mkdirSync(cacheRoot, { recursive: true });
+  const tmp = fs20.mkdtempSync(path19.join(cacheRoot, `.dl-${commit.slice(0, 8)}-`));
   try {
-    const tgz = path18.join(tmp, "src.tar.gz");
-    fs19.writeFileSync(tgz, Buffer.from(await res.arrayBuffer()));
-    const unpacked = path18.join(tmp, "unpacked");
-    fs19.mkdirSync(unpacked);
+    const tgz = path19.join(tmp, "src.tar.gz");
+    fs20.writeFileSync(tgz, Buffer.from(await res.arrayBuffer()));
+    const unpacked = path19.join(tmp, "unpacked");
+    fs20.mkdirSync(unpacked);
     extractTarGz(tgz, unpacked);
     try {
-      fs19.renameSync(unpacked, dest);
+      fs20.renameSync(unpacked, dest);
     } catch (e) {
       const err = e;
-      const isBenignRace = (err.code === "EEXIST" || err.code === "ENOTEMPTY") && fs19.existsSync(path18.join(dest, "personas"));
+      const isBenignRace = (err.code === "EEXIST" || err.code === "ENOTEMPTY") && fs20.existsSync(path19.join(dest, "personas"));
       if (!isBenignRace) {
         throw new LocalCliError({
           code: "PLATFORM_CACHE_PUBLISH_FAILED",
@@ -17791,12 +17981,12 @@ async function resolveReleaseContent(manifest, opts = {}) {
       }
     }
   } finally {
-    fs19.rmSync(tmp, { recursive: true, force: true });
+    fs20.rmSync(tmp, { recursive: true, force: true });
   }
   return dest;
 }
 function extractTarGz(tgz, into) {
-  execFileSync("tar", ["-xzf", tgz, "-C", into, "--strip-components=1"]);
+  execFileSync2("tar", ["-xzf", tgz, "-C", into, "--strip-components=1"]);
 }
 
 // src/lib/platform-stamp.ts
@@ -17918,14 +18108,14 @@ function sleep2(ms) {
 }
 
 // src/lib/platform-converge.ts
-import * as fs21 from "fs";
-import * as path20 from "path";
+import * as fs22 from "fs";
+import * as path21 from "path";
 import { parse as parseYaml10 } from "yaml";
 
 // src/lib/deploy.ts
-import * as fs20 from "fs/promises";
+import * as fs21 from "fs/promises";
 import * as os9 from "os";
-import * as path19 from "path";
+import * as path20 from "path";
 init_errors();
 var FOUNDRY_TRACING_MODES = ["project", "account", "skip"];
 function parseFoundryTracingMode(v) {
@@ -17973,9 +18163,9 @@ function buildBicepParams(p) {
   return params;
 }
 async function resolveRepoRoot2(home = os9.homedir()) {
-  const marker = path19.join(home, ".m8t-stack", "repo-root");
+  const marker = path20.join(home, ".m8t-stack", "repo-root");
   try {
-    const root = (await fs20.readFile(marker, "utf8")).trim();
+    const root = (await fs21.readFile(marker, "utf8")).trim();
     if (!root) throw new Error("empty");
     return root;
   } catch {
@@ -18052,7 +18242,7 @@ function resolveAcrPullIdentity(opts) {
   return opts.explicit ?? "";
 }
 async function runBicepDeployment(opts) {
-  const bicepPath = path19.join(opts.repoRoot, "deploy", "main.bicep");
+  const bicepPath = path20.join(opts.repoRoot, "deploy", "main.bicep");
   const result = JSON.parse(
     await runAz([
       "deployment",
@@ -18123,7 +18313,16 @@ function sortObj(o) {
 }
 
 // src/lib/platform-converge.ts
-var ORDER = ["infra", "gateway", "codingAgent", "azureExecutor", "personas"];
+var ORDER = ["infra", "gateway", "codingAgent", "azureExecutor", "personas", "brainSeeds"];
+function seedSetRev(manifest) {
+  const items = manifest.components.brainSeeds.items;
+  const parts = [];
+  for (const name of Object.keys(items).sort()) {
+    const subs = items[name].subtrees;
+    for (const sub of Object.keys(subs).sort()) parts.push(`${name}:${sub}:${subs[sub] ?? "-"}`);
+  }
+  return parts.join("|");
+}
 function infraTargetSha(manifest, tree) {
   return manifest.components.infra?.treeSha ?? tree.treeShaOf("deploy") ?? "";
 }
@@ -18159,6 +18358,16 @@ function diffPlan(manifest, stamp, tree, opts = {}) {
       }
       continue;
     }
+    if (component === "brainSeeds") {
+      const to = seedSetRev(manifest);
+      const from2 = stamp?.components.brainSeeds?.seedRev ?? null;
+      const targeted = opts.only === "brainSeeds";
+      if (adopt) actions.push({ component, reason: "adopt", from: from2, to });
+      else if (targeted) actions.push({ component, reason: from2 === to ? "forced" : "changed", from: from2, to });
+      else if (from2 !== to) actions.push({ component, reason: "changed", from: from2, to });
+      else skipped.push({ component, reason: "up-to-date" });
+      continue;
+    }
     const img = manifest.components[component];
     const cur = stamp?.components[component];
     if (cur?.state === "external") {
@@ -18202,6 +18411,7 @@ function installedValueOf(stamp, component, personaName) {
     if (!personaName || !Object.hasOwn(stamp.components.personas, personaName)) return "-";
     return stamp.components.personas[personaName].treeSha;
   }
+  if (component === "brainSeeds") return stamp.components.brainSeeds?.seedRev ?? "-";
   return stamp.components[component].tag;
 }
 function targetValueOf(manifest, tree, component, personaName) {
@@ -18210,6 +18420,7 @@ function targetValueOf(manifest, tree, component, personaName) {
     if (!personaName || !Object.hasOwn(manifest.components.personas.items, personaName)) return "-";
     return manifest.components.personas.items[personaName].treeSha;
   }
+  if (component === "brainSeeds") return seedSetRev(manifest) || "-";
   return manifest.components[component].tag;
 }
 async function applyPlan(plan, deps, ctx) {
@@ -18230,6 +18441,18 @@ async function applyPlan(plan, deps, ctx) {
           continue;
         }
         stamp.components[a.component] = { ...r, state: "managed" };
+      } else if (a.component === "brainSeeds") {
+        if (!deps.applySeedRefresh) {
+          ctx.onProgress?.("brainSeeds: seed refresh is not supported by this driver (CLI-only in v1) \u2014 skipped.");
+          continue;
+        }
+        const r = await deps.applySeedRefresh(a, ctx);
+        ctx.onProgress?.(`brainSeeds: delivered to ${r.delivered.toString()} repo(s), ${r.noop.toString()} already current.`);
+        if (!r.converged) {
+          ctx.onProgress?.("brainSeeds: not fully delivered (no Key Vault, or some repos failed) \u2014 stamp NOT advanced; will retry next converge.");
+          continue;
+        }
+        stamp.components.brainSeeds = { seedRev: a.to };
       } else {
         if (!a.personaName) {
           throw new LocalCliError({ code: "PLATFORM_PERSONA_NO_NAME", message: "persona action missing personaName" });
@@ -18282,7 +18505,14 @@ function seedStamp(prior, manifest, plan) {
     updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
     lastResult: "partial",
     cli: "",
-    components: { gateway: blankImg(), codingAgent: blankImg(), azureExecutor: blankImg(), personas: {}, infra: { treeSha: "" } }
+    components: {
+      gateway: blankImg(),
+      codingAgent: blankImg(),
+      azureExecutor: blankImg(),
+      personas: {},
+      infra: { treeSha: "" },
+      brainSeeds: { seedRev: "" }
+    }
   };
 }
 async function applyGatewayImage(a, ctx, gatewayResourceId) {
@@ -18376,7 +18606,7 @@ async function applyAgentImage(a, ctx, opts) {
 function declaredFillableFields(personaPath) {
   let raw;
   try {
-    raw = fs21.readFileSync(personaPath, "utf8");
+    raw = fs22.readFileSync(personaPath, "utf8");
   } catch {
     return [];
   }
@@ -18402,7 +18632,7 @@ function injectAndRender(personaPath, values, agentName) {
 function loaderText(loaderPath) {
   if (!loaderPath) return null;
   try {
-    return fs21.readFileSync(loaderPath, "utf8");
+    return fs22.readFileSync(loaderPath, "utf8");
   } catch {
     return null;
   }
@@ -18419,7 +18649,7 @@ function brainRepoOf(current) {
 }
 async function applyPersona(a, ctx, opts) {
   const current = await getAgentVersion({ credential: ctx.credential, projectEndpoint: opts.project.endpoint, agentName: opts.agentName });
-  const personaPath = path20.join(opts.personaDir, "persona.md");
+  const personaPath = path21.join(opts.personaDir, "persona.md");
   const yamlValues = readAgentYaml(opts.agentName)?.fillableFieldValues ?? null;
   const values = resolveFillableValues(current, yamlValues);
   const declared = declaredFillableFields(personaPath);
@@ -18618,7 +18848,7 @@ import { confirm as confirm5 } from "@inquirer/prompts";
 import { DefaultAzureCredential as DefaultAzureCredential17 } from "@azure/identity";
 
 // src/lib/platform-converge-cli.ts
-import * as path21 from "path";
+import * as path25 from "path";
 
 // src/lib/platform-infra-params.ts
 import { TableClient as TableClient2 } from "@azure/data-tables";
@@ -18673,6 +18903,356 @@ async function deriveSuffixVerified(opts) {
 
 // src/lib/platform-converge-cli.ts
 init_errors();
+
+// src/lib/seed-refresh-driver.ts
+init_esm2();
+import * as path24 from "path";
+
+// src/lib/seed-refresh.ts
+init_errors();
+import * as fs24 from "fs";
+import * as path23 from "path";
+
+// src/lib/seed-merge.ts
+import * as fs23 from "fs";
+import * as os10 from "os";
+import * as path22 from "path";
+import { spawnSync as spawnSync3 } from "child_process";
+function isProbablyText(s) {
+  return !s.includes("\0");
+}
+function mergeThreeWay(ours, base, theirs) {
+  if (![ours, base, theirs].every(isProbablyText)) {
+    return { ok: false, merged: "" };
+  }
+  const lf = (s) => s.replace(/\r\n/g, "\n");
+  const dir = fs23.mkdtempSync(path22.join(os10.tmpdir(), "seed-merge-"));
+  try {
+    const o = path22.join(dir, "ours");
+    const b = path22.join(dir, "base");
+    const t = path22.join(dir, "theirs");
+    fs23.writeFileSync(o, lf(ours));
+    fs23.writeFileSync(b, lf(base));
+    fs23.writeFileSync(t, lf(theirs));
+    const res = spawnSync3(
+      "git",
+      ["merge-file", "-p", "--diff3", o, b, t],
+      {
+        encoding: "utf8",
+        maxBuffer: 32 * 1024 * 1024
+      }
+    );
+    if (res.status === 0) {
+      return { ok: true, merged: res.stdout };
+    }
+    return { ok: false, merged: "" };
+  } finally {
+    fs23.rmSync(dir, { recursive: true, force: true });
+  }
+}
+var skip = (path37, skipReason) => ({ path: path37, kind: "skip", skipReason });
+function classifyCandidate(c) {
+  const { path: path37, base, ours, theirs } = c;
+  if (theirs === base) return { path: path37, kind: "noop" };
+  if (base === null) {
+    if (theirs === null) return { path: path37, kind: "noop" };
+    if (ours === null) return { path: path37, kind: "add", content: theirs };
+    if (ours === theirs) return { path: path37, kind: "noop" };
+    return skip(path37, "you already have a file at this path");
+  }
+  if (ours === null) {
+    return theirs === null ? { path: path37, kind: "noop" } : skip(path37, "you removed this file; upstream changed it");
+  }
+  if (theirs === null) {
+    return ours === base ? { path: path37, kind: "delete" } : skip(path37, "you edited this file; upstream removed it");
+  }
+  if (ours === base) return { path: path37, kind: "update", content: theirs };
+  const m = mergeThreeWay(ours, base, theirs);
+  return m.ok ? { path: path37, kind: "update", content: m.merged } : skip(path37, "your edits conflict with the update");
+}
+
+// src/lib/seed-pr-body.ts
+function composeSeedPrTitle(s) {
+  return `Update your ${s.advisorLabel}'s built-in skills & guides (${s.version})`;
+}
+var basename = (p) => p.split("/").filter(Boolean).slice(-2).join("/");
+function composeSeedPrBody(s) {
+  const lines = [];
+  lines.push(`This refreshes the skills and reference guides that came built into your ${s.advisorLabel}, bringing them up to date with platform release **${s.version}**.`);
+  lines.push("");
+  if (s.updated.length || s.added.length || s.deleted.length) {
+    lines.push("**What changed**");
+    if (s.updated.length) lines.push(`- \u270F\uFE0F Updated ${s.updated.length.toString()}: ${s.updated.map(basename).join(", ")}`);
+    if (s.added.length) lines.push(`- \u2795 Added ${s.added.length.toString()}: ${s.added.map(basename).join(", ")}`);
+    if (s.deleted.length) lines.push(`- \u{1F5D1}\uFE0F Removed ${s.deleted.length.toString()}: ${s.deleted.map(basename).join(", ")}`);
+    lines.push("");
+  }
+  lines.push("**Your own content is untouched.** Only built-in files change here \u2014 nothing you or your advisor wrote (your memory, your inbox, skills your advisor learned on its own) is modified.");
+  if (s.skipped.length) {
+    lines.push("");
+    lines.push(`**${s.skipped.length.toString()} file(s) were left as-is** because you've customized them and we won't overwrite your edits. To take an update anyway, open that file in the latest release and copy the changes over by hand:`);
+    for (const sk of s.skipped) lines.push(`- \`${sk.path}\` \u2014 ${sk.skipReason}`);
+  }
+  lines.push("");
+  lines.push("Your advisor's review workflow will check this PR automatically. Merge whenever you're ready.");
+  lines.push("");
+  lines.push(`\u2014 Opened by the m8t platform \xB7 release ${s.version}${s.notesUrl ? ` \xB7 [release notes](${s.notesUrl})` : ""}`);
+  return lines.join("\n");
+}
+
+// src/lib/seed-refresh.ts
+function readIf(dir, rel) {
+  if (!dir) return null;
+  const abs = path23.join(dir, rel);
+  return fs24.existsSync(abs) ? fs24.readFileSync(abs, "utf8") : null;
+}
+async function assembleCandidates(args) {
+  const paths = /* @__PURE__ */ new Set([...args.lineage?.ownedPaths ?? [], ...args.trees.ownedAtTheirs]);
+  const out = [];
+  for (const p of [...paths].sort((a, b) => a.localeCompare(b))) {
+    out.push({ path: p, base: readIf(args.trees.baseDir, p), theirs: readIf(args.trees.theirsDir, p), ours: await args.source.readOurs(p) });
+  }
+  return out;
+}
+function assertNoDanglingIndexRefs(finalPaths, repoHas, indexBodies) {
+  const refRe = /skills\/[^)\s]+\/SKILL\.md/g;
+  for (const idx of indexBodies) {
+    for (const m of idx.body.matchAll(refRe)) {
+      const ref = m[0];
+      if (!finalPaths.has(ref) && !repoHas(ref)) {
+        throw new LocalCliError({
+          code: "PLATFORM_SEED_INDEX_DANGLING",
+          message: `Refusing to open a PR: ${idx.path} would reference a missing skill '${ref}'. The brain loader only opens indexed paths.`
+        });
+      }
+    }
+  }
+}
+async function refreshBrainRepo(args) {
+  const cands = await assembleCandidates({ lineage: args.lineage, trees: args.trees, source: args.source, seedName: args.seedName });
+  const outcomes = cands.map(classifyCandidate);
+  const files = [];
+  const updated = [];
+  const added = [];
+  const deleted = [];
+  const skipped = [];
+  const indexBodies = [];
+  const finalPaths = /* @__PURE__ */ new Set();
+  for (const o of outcomes) {
+    if (o.path === SEED_MANIFEST_PATH) continue;
+    if (o.kind === "update") {
+      files.push({ path: o.path, content: o.content ?? "" });
+      updated.push(o.path);
+      finalPaths.add(o.path);
+    } else if (o.kind === "add") {
+      files.push({ path: o.path, content: o.content ?? "" });
+      added.push(o.path);
+      finalPaths.add(o.path);
+    } else if (o.kind === "delete") {
+      files.push({ path: o.path, delete: true });
+      deleted.push(o.path);
+    } else if (o.kind === "skip") {
+      skipped.push({ path: o.path, skipReason: o.skipReason ?? "left as-is" });
+    }
+    if (o.path.endsWith("/_index.md") && (o.kind === "update" || o.kind === "add")) {
+      indexBodies.push({ path: o.path, body: o.content ?? "" });
+    }
+  }
+  const contentChanged = updated.length + added.length + deleted.length > 0;
+  if (!contentChanged) {
+    return { repo: args.repo, prUrl: null, action: "noop", updated, added, deleted, skipped };
+  }
+  const ownedNow = new Set(args.trees.ownedAtTheirs);
+  assertNoDanglingIndexRefs(finalPaths, (p) => ownedNow.has(p), indexBodies);
+  const newOwned = deriveOwnedPaths(args.trees.theirsDir);
+  const nextManifest = upsertLineage(
+    args.priorManifest ?? (args.lineage ? { schemaVersion: 1, seeds: [args.lineage] } : null),
+    {
+      name: args.seedName,
+      refreshedToCommit: args.targetCommit ?? "",
+      refreshedToVersion: args.version,
+      ownedPaths: newOwned
+    }
+  );
+  files.push({ path: SEED_MANIFEST_PATH, content: serializeSeedManifest(nextManifest) });
+  for (const sb of args.supersedeBranches ?? []) {
+    if (sb === args.branch) continue;
+    const stale = await args.api.findOpenPr(sb);
+    if (stale) await args.api.closePr(stale.number, `superseded by the newer update on \`${args.branch}\`.`);
+  }
+  const opened = await args.api.findOpenPr(args.branch);
+  const headSha = await args.api.getHeadSha(args.base);
+  await args.api.commitFromBase(files, args.branch, headSha, `chore(seed): refresh built-in skills & guides (${args.version})`);
+  const summary = {
+    advisorLabel: args.advisorLabel,
+    version: args.version,
+    notesUrl: args.notesUrl,
+    repo: args.repo,
+    updated,
+    added,
+    deleted,
+    skipped
+  };
+  const title = composeSeedPrTitle(summary);
+  const body = composeSeedPrBody(summary);
+  if (opened) {
+    await args.api.updatePr(opened.number, title, body);
+    return { repo: args.repo, prUrl: opened.htmlUrl, action: "updated", updated, added, deleted, skipped };
+  }
+  const pr = await args.api.openPr(args.branch, args.base, title, body);
+  return { repo: args.repo, prUrl: pr.htmlUrl, action: args.lineage ? "opened" : "bootstrapped", updated, added, deleted, skipped };
+}
+
+// src/lib/seed-refresh-driver.ts
+var PERSONA_SEED_MAP = {
+  "startup-advisor": "startup-advisor",
+  "azure-advisor": "azure-advisor"
+};
+var ADVISOR_LABEL = {
+  "startup-advisor": "Startup Advisor",
+  "azure-advisor": "Azure Advisor"
+};
+function dedupeBrainRepos(agents) {
+  const byRepo = /* @__PURE__ */ new Map();
+  for (const a of agents) {
+    const raw = a.metadata.brain;
+    if (!raw) continue;
+    let repo;
+    let installationId;
+    try {
+      const parsed = JSON.parse(raw);
+      repo = parsed.repo;
+      installationId = parsed.installationId;
+    } catch {
+      repo = void 0;
+      installationId = void 0;
+    }
+    if (!repo || !installationId) continue;
+    const seedName = a.metadata.persona ? PERSONA_SEED_MAP[a.metadata.persona] ?? null : null;
+    if (!byRepo.has(repo)) byRepo.set(repo, { repo, seedName, installationId });
+  }
+  return [...byRepo.values()];
+}
+function seedContentDir(contentRoot, manifest, seedName) {
+  const items = manifest.components.brainSeeds.items;
+  if (!Object.hasOwn(items, seedName)) return null;
+  return path24.join(contentRoot, items[seedName].path);
+}
+function bindRepoApi(token, repo) {
+  return {
+    getDefaultBranch: () => Promise.resolve("main"),
+    getHeadSha: async (branch) => {
+      const res = await fetch(`https://api.github.com/repos/${repo}/git/ref/heads/${branch}`, {
+        headers: { Authorization: `token ${token}`, Accept: "application/vnd.github+json", "User-Agent": "m8t" }
+      });
+      const j = await res.json();
+      return j.object?.sha ?? "";
+    },
+    findOpenPr: (head) => findOpenPr({ token, repo, head }),
+    commitFromBase: (files, branch, baseSha, message) => commitFilesFromBaseViaApp({ token, repo, branch, baseSha, files, message }),
+    openPr: (head, base, title, body) => openPullRequestViaApp({ token, repo, base, head, title, body }),
+    updatePr: (n, title, body) => updatePullRequestViaApp({ token, repo, number: n, title, body }),
+    closePr: (n, comment) => closePullRequestViaApp({ token, repo, number: n, comment }),
+    readFileAtRef: (path37, ref) => readRepoFileViaApp({ token, repo, path: path37, ref })
+  };
+}
+async function runSeedRefresh(args) {
+  const targetCommit = args.manifest.platform.commit;
+  const theirsRoot = await resolveReleaseContent(args.manifest, {});
+  const repos = dedupeBrainRepos(args.agents);
+  const results = [];
+  let delivered = 0;
+  let noop2 = 0;
+  let failed = 0;
+  for (const ref of repos) {
+    try {
+      const minted = await mintInstallationToken({
+        credential: args.credential,
+        kvUri: args.kvUri,
+        installationId: ref.installationId,
+        repository: ref.repo,
+        permissions: { contents: "write", pull_requests: "write" }
+      });
+      const token = minted.token;
+      const probe = appRepoProbe({ token, repo: ref.repo });
+      const state = await probeRepoState(probe);
+      if (state !== "m8t-brain") {
+        args.onWarn?.(`${ref.repo}: not a reachable m8t brain (${state}) \u2014 skipped.`);
+        continue;
+      }
+      const markerText = await readRepoFileViaApp({ token, repo: ref.repo, path: SEED_MANIFEST_PATH });
+      const marker = parseSeedManifest(markerText);
+      const seedName = ref.seedName ?? marker?.seeds[0]?.name ?? null;
+      if (!seedName) {
+        args.onWarn?.(`${ref.repo}: cannot determine seed lineage \u2014 skipped.`);
+        continue;
+      }
+      const theirsDir = seedContentDir(theirsRoot, args.manifest, seedName);
+      if (!theirsDir) {
+        args.onWarn?.(`${ref.repo}: seed '${seedName}' is not in this release \u2014 skipped.`);
+        continue;
+      }
+      const advisorLabel = ADVISOR_LABEL[seedName] ?? seedName;
+      let lineage = marker?.seeds.find((s) => s.name === seedName) ?? null;
+      let baseDir = null;
+      if (lineage) {
+        try {
+          const baseRoot = await resolveReleaseContent(
+            { ...args.manifest, platform: { ...args.manifest.platform, commit: lineage.refreshedToCommit } },
+            {}
+          );
+          baseDir = seedContentDir(baseRoot, args.manifest, seedName);
+        } catch {
+          baseDir = null;
+          args.onWarn?.(`${ref.repo}: base rev ${lineage.refreshedToCommit} unfetchable \u2014 falling back to marker-only re-adopt.`);
+          lineage = null;
+        }
+      } else {
+        const initSha = await getInitialSeedCommitSha({ token, repo: ref.repo });
+        if (initSha) {
+          try {
+            const baseRoot = await resolveReleaseContent(
+              { ...args.manifest, platform: { ...args.manifest.platform, commit: initSha } },
+              {}
+            );
+            baseDir = seedContentDir(baseRoot, args.manifest, seedName);
+            lineage = baseDir ? { name: seedName, refreshedToCommit: initSha, refreshedToVersion: "(bootstrap)", ownedPaths: deriveOwnedPaths(baseDir) } : null;
+          } catch {
+            baseDir = null;
+          }
+        }
+      }
+      const trees = { baseDir, theirsDir, ownedAtTheirs: deriveOwnedPaths(theirsDir) };
+      const source = { readOurs: (p) => readRepoFileViaApp({ token, repo: ref.repo, path: p }) };
+      const res = await refreshBrainRepo({
+        repo: ref.repo,
+        branch: `m8t/seed-update-${args.version}`,
+        base: "main",
+        version: args.version,
+        notesUrl: args.manifest.platform.notesUrl,
+        advisorLabel,
+        seedName,
+        lineage,
+        trees,
+        source,
+        api: bindRepoApi(token, ref.repo),
+        targetCommit,
+        priorManifest: marker
+      });
+      results.push(res);
+      if (res.action === "noop") noop2++;
+      else delivered++;
+      args.onProgress?.(`${ref.repo}: ${res.action}${res.prUrl ? ` \u2192 ${res.prUrl}` : ""}`);
+    } catch (e) {
+      failed++;
+      args.onWarn?.(`${ref.repo}: seed refresh failed \u2014 ${e.message}; skipped this repo.`);
+      continue;
+    }
+  }
+  return { delivered, noop: noop2, failed, results };
+}
+
+// src/lib/platform-converge-cli.ts
 var HOSTED_AGENT_PERSONA_DIR = {
   codingAgent: "coding-agent",
   azureExecutor: "azure-executor"
@@ -18686,7 +19266,7 @@ async function buildConvergeDeps(args) {
     const persona = a.metadata.persona;
     if (persona) discovered[persona] = a.name;
   }
-  const loaderPath = path21.join(args.contentDir, "targets/foundry/brain-loader.md");
+  const loaderPath = path25.join(args.contentDir, "targets/foundry/brain-loader.md");
   return {
     async applyPersona(a, ctx) {
       const personaName = a.personaName;
@@ -18702,7 +19282,7 @@ async function buildConvergeDeps(args) {
       return applyPersona(a, ctx, {
         agentName,
         project: args.project,
-        personaDir: path21.join(ctx.contentDir, personaItem.path),
+        personaDir: path25.join(ctx.contentDir, personaItem.path),
         loaderPath
       });
     },
@@ -18804,6 +19384,31 @@ async function buildConvergeDeps(args) {
         },
         updatedAt: (/* @__PURE__ */ new Date()).toISOString()
       });
+    },
+    async applySeedRefresh(_a3, ctx) {
+      let kvUri;
+      try {
+        kvUri = discoverKvUri(process.env);
+      } catch {
+        kvUri = void 0;
+      }
+      if (!kvUri) {
+        warn("brainSeeds: no Key Vault URI (set AZURE_KEYVAULT_URI) \u2014 skipping seed refresh.");
+        return { delivered: 0, noop: 0, converged: false };
+      }
+      const { delivered, noop: noop2, failed } = await runSeedRefresh({
+        credential: args.credential,
+        kvUri,
+        manifest: ctx.manifest,
+        agents: discoveredAgents,
+        version: ctx.manifest.platform.version,
+        onProgress: args.onProgress,
+        onWarn: args.onWarn
+      });
+      if (failed > 0) {
+        warn(`brainSeeds: ${failed.toString()} repo(s) failed to receive a seed update \u2014 re-run 'm8t platform update --only brainSeeds' to retry.`);
+      }
+      return { delivered, noop: noop2, converged: failed === 0 };
     }
   };
 }
@@ -18843,7 +19448,7 @@ var PlatformUpdateCommand = class extends M8tCommand {
     description: "Pin the platform version to converge to (defaults to the current release channel)."
   });
   only = Option30.String("--only", {
-    description: "Converge only one component: infra | gateway | codingAgent | azureExecutor | personas."
+    description: "Converge only one component: infra | gateway | codingAgent | azureExecutor | personas | brainSeeds."
   });
   check = Option30.Boolean("--check", false);
   yes = Option30.Boolean("--yes", false);
@@ -19057,15 +19662,15 @@ async function patchApplyRequest(client, mutate) {
 }
 
 // src/lib/platform-self-update.ts
-import * as fs22 from "fs";
-import * as path22 from "path";
+import * as fs25 from "fs";
+import * as path26 from "path";
 function toVTag2(v) {
   return v.startsWith("v") ? v : `v${v}`;
 }
 function readBakedReleaseVersion(repoRoot) {
   if (!repoRoot) return null;
   try {
-    const raw = fs22.readFileSync(path22.join(repoRoot, "installer", "version.json"), "utf8");
+    const raw = fs25.readFileSync(path26.join(repoRoot, "installer", "version.json"), "utf8");
     const v = JSON.parse(raw).version;
     return typeof v === "string" && v.length > 0 ? v : null;
   } catch {
@@ -20020,7 +20625,7 @@ async function patchRedirectUris(appObjectId, fqdn) {
 init_errors();
 
 // src/lib/whatif.ts
-import * as path23 from "path";
+import * as path27 from "path";
 function deriveResourceType(resourceId) {
   if (resourceId.startsWith("[")) return "";
   const afterProviders = resourceId.split("/providers/")[1];
@@ -20031,7 +20636,7 @@ function deriveResourceType(resourceId) {
   return parts.join("/");
 }
 async function runWhatIf(opts) {
-  const bicepPath = path23.join(opts.repoRoot, "deploy", "main.bicep");
+  const bicepPath = path27.join(opts.repoRoot, "deploy", "main.bicep");
   const out = await runAz([
     "deployment",
     "group",
@@ -20096,9 +20701,9 @@ function flattenDelta(delta, prefix = "") {
   const out = [];
   for (const d of delta) {
     const segment = /^[0-9]+$/.test(d.path) ? `[${d.path}]` : prefix ? `.${d.path}` : d.path;
-    const path33 = prefix ? `${prefix}${segment}` : d.path;
-    if (d.children && d.children.length > 0) out.push(...flattenDelta(d.children, path33));
-    else out.push({ ...d, path: path33 });
+    const path37 = prefix ? `${prefix}${segment}` : d.path;
+    if (d.children && d.children.length > 0) out.push(...flattenDelta(d.children, path37));
+    else out.push({ ...d, path: path37 });
   }
   return out;
 }
@@ -20320,7 +20925,7 @@ var DeployCommand = class extends M8tCommand {
 };
 
 // src/commands/eval/skill.ts
-import { spawnSync as spawnSync3 } from "child_process";
+import { spawnSync as spawnSync4 } from "child_process";
 import { Command as Command37, Option as Option34 } from "clipanion";
 init_errors();
 var DECISIONS = /* @__PURE__ */ new Set(["promote", "reject", "needs_review"]);
@@ -20372,7 +20977,7 @@ var EvalSkillCommand = class extends M8tCommand {
     const args = ["skill", candidate2, "--skills-dir", skillsDir, "--json"];
     if (this.noJudge === true) args.push("--no-judge");
     if (typeof this.deployment === "string") args.push("--deployment", this.deployment);
-    const res = spawnSync3(bin, args, { encoding: "utf-8" });
+    const res = spawnSync4(bin, args, { encoding: "utf-8" });
     if (res.error) {
       throw new LocalCliError({
         code: "BRAIN_EVAL_SPAWN",
@@ -20409,9 +21014,9 @@ var EvalSkillCommand = class extends M8tCommand {
 };
 
 // src/commands/eval/exam.ts
-import { spawnSync as spawnSync4 } from "child_process";
-import { writeFileSync as writeFileSync4, mkdirSync as mkdirSync4, readFileSync as readFileSync16, existsSync as existsSync13, readdirSync } from "fs";
-import { join as join23 } from "path";
+import { spawnSync as spawnSync5 } from "child_process";
+import { writeFileSync as writeFileSync6, mkdirSync as mkdirSync5, readFileSync as readFileSync17, existsSync as existsSync15, readdirSync as readdirSync2 } from "fs";
+import { join as join27 } from "path";
 import { Command as Command38, Option as Option35 } from "clipanion";
 init_errors();
 init_esm();
@@ -20593,11 +21198,11 @@ function resolveRefereeHome(refereeHomeOut, env) {
   return null;
 }
 function resolveTaskSetDir(base, worker, version) {
-  if (existsSync13(join23(base, version))) return version;
+  if (existsSync15(join27(base, version))) return version;
   const prefixed = `${worker}-${version}`;
-  if (existsSync13(join23(base, prefixed))) return prefixed;
-  if (version === "latest" && existsSync13(base)) {
-    const dirs = readdirSync(base, { withFileTypes: true }).filter((d) => d.isDirectory() && d.name.startsWith(`${worker}-`)).map((d) => d.name).sort();
+  if (existsSync15(join27(base, prefixed))) return prefixed;
+  if (version === "latest" && existsSync15(base)) {
+    const dirs = readdirSync2(base, { withFileTypes: true }).filter((d) => d.isDirectory() && d.name.startsWith(`${worker}-`)).map((d) => d.name).sort();
     if (dirs.length > 0) return dirs[dirs.length - 1];
   }
   return version;
@@ -20611,11 +21216,11 @@ function readSealedTaskIds(taskSetVersion, refereeHomeOut, env = process.env) {
       message: "cannot resolve the referee home to read the sealed-task manifest \u2014 set $REFEREE_HOME (mirroring the Python runner) so the feed can be redacted; refusing to emit a possibly-unredacted feed (Law-1)"
     });
   }
-  const versionDir = resolveTaskSetDir(join23(home, "tasksets", worker), worker, version);
-  const manifestPath = join23(home, "tasksets", worker, versionDir, "manifest.yaml");
+  const versionDir = resolveTaskSetDir(join27(home, "tasksets", worker), worker, version);
+  const manifestPath = join27(home, "tasksets", worker, versionDir, "manifest.yaml");
   let text;
   try {
-    text = readFileSync16(manifestPath, "utf-8");
+    text = readFileSync17(manifestPath, "utf-8");
   } catch (e) {
     throw new LocalCliError({
       code: "EXAM_REDACTION_UNSAFE",
@@ -20722,7 +21327,7 @@ var EvalExamCommand = class extends M8tCommand {
       return 0;
     }
     const bin = process.env.BRAIN_EXAM_BIN ?? "brain-exam";
-    const res = spawnSync4(bin, ["run", "--plan", "-", "--json"], { encoding: "utf-8", input: renderJson(plan) });
+    const res = spawnSync5(bin, ["run", "--plan", "-", "--json"], { encoding: "utf-8", input: renderJson(plan) });
     if (res.error) {
       throw new LocalCliError({
         code: "EXAM_SPAWN",
@@ -20735,10 +21340,10 @@ var EvalExamCommand = class extends M8tCommand {
     const verdict = parseExamVerdict(res.stdout);
     if (out !== void 0) {
       const sealedTaskIds = taskSetVersion ? readSealedTaskIds(taskSetVersion, out) : /* @__PURE__ */ new Set();
-      mkdirSync4(out, { recursive: true });
-      writeFileSync4(join23(out, "verdict.json"), JSON.stringify(verdict, null, 2));
+      mkdirSync5(out, { recursive: true });
+      writeFileSync6(join27(out, "verdict.json"), JSON.stringify(verdict, null, 2));
       const feed = redactForFeed(verdict, sealedTaskIds);
-      writeFileSync4(join23(out, "feed.json"), JSON.stringify(feed, null, 2));
+      writeFileSync6(join27(out, "feed.json"), JSON.stringify(feed, null, 2));
     }
     if (mode === "json") {
       this.context.stdout.write(renderJson(verdict) + "\n");
@@ -21001,9 +21606,9 @@ var StatusCommand = class extends M8tCommand {
 // src/commands/doctor.ts
 import { Command as Command42, Option as Option39 } from "clipanion";
 import { DefaultAzureCredential as DefaultAzureCredential19 } from "@azure/identity";
-import * as fs23 from "fs";
-import * as os10 from "os";
-import * as path24 from "path";
+import * as fs26 from "fs";
+import * as os11 from "os";
+import * as path28 from "path";
 
 // src/lib/doctor-checks.ts
 function checkAzSignedIn(az) {
@@ -21228,24 +21833,24 @@ async function resolveAccountLocation(accountId) {
   }
 }
 function probeRepoRoot() {
-  const marker = path24.join(os10.homedir(), ".m8t-stack", "repo-root");
-  if (!fs23.existsSync(marker)) {
+  const marker = path28.join(os11.homedir(), ".m8t-stack", "repo-root");
+  if (!fs26.existsSync(marker)) {
     return { markerExists: false, path: null, isDir: false, isGitCheckout: false };
   }
   let repoPath;
   try {
-    repoPath = fs23.readFileSync(marker, "utf8").trim();
+    repoPath = fs26.readFileSync(marker, "utf8").trim();
   } catch {
     return { markerExists: true, path: null, isDir: false, isGitCheckout: false };
   }
   if (!repoPath) return { markerExists: true, path: null, isDir: false, isGitCheckout: false };
   let isDir = false;
   try {
-    isDir = fs23.statSync(repoPath).isDirectory();
+    isDir = fs26.statSync(repoPath).isDirectory();
   } catch {
     isDir = false;
   }
-  const isGitCheckout = isDir && fs23.existsSync(path24.join(repoPath, ".git"));
+  const isGitCheckout = isDir && fs26.existsSync(path28.join(repoPath, ".git"));
   return { markerExists: true, path: repoPath, isDir, isGitCheckout };
 }
 var DoctorCommand = class extends M8tCommand {
@@ -21374,15 +21979,15 @@ var DoctorCommand = class extends M8tCommand {
 import { Command as Command43, Option as Option40 } from "clipanion";
 
 // src/lib/profiles.ts
-import * as fs24 from "fs/promises";
-import * as path25 from "path";
+import * as fs27 from "fs/promises";
+import * as path29 from "path";
 import { parse as parseYaml11, stringify as stringifyYaml4 } from "yaml";
 function profilesDir() {
   const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
-  return path25.join(home, ".m8t-stack", "profiles");
+  return path29.join(home, ".m8t-stack", "profiles");
 }
 function getProfilePath(name) {
-  return path25.join(profilesDir(), `${path25.basename(name)}.yaml`);
+  return path29.join(profilesDir(), `${path29.basename(name)}.yaml`);
 }
 function slugifyTenant(domainOrId) {
   const base = domainOrId.split(".")[0].toLowerCase();
@@ -21391,7 +21996,7 @@ function slugifyTenant(domainOrId) {
 }
 async function listProfiles() {
   try {
-    const entries = await fs24.readdir(profilesDir());
+    const entries = await fs27.readdir(profilesDir());
     return entries.filter((e) => e.endsWith(".yaml")).map((e) => e.replace(/\.yaml$/, "")).sort();
   } catch (e) {
     if (e.code === "ENOENT") return [];
@@ -21400,7 +22005,7 @@ async function listProfiles() {
 }
 async function readProfile(name) {
   try {
-    const raw = await fs24.readFile(getProfilePath(name), "utf8");
+    const raw = await fs27.readFile(getProfilePath(name), "utf8");
     const parsed = parseYaml11(raw);
     if (!parsed || typeof parsed !== "object") return null;
     return parsed;
@@ -21411,14 +22016,14 @@ async function readProfile(name) {
 }
 async function exists(p) {
   try {
-    await fs24.stat(p);
+    await fs27.stat(p);
     return true;
   } catch {
     return false;
   }
 }
 async function saveProfile(p) {
-  await fs24.mkdir(profilesDir(), { recursive: true });
+  await fs27.mkdir(profilesDir(), { recursive: true });
   let name = p.name;
   let n = 2;
   while (await exists(getProfilePath(name))) {
@@ -21427,8 +22032,8 @@ async function saveProfile(p) {
   }
   const target = getProfilePath(name);
   const tmp = `${target}.tmp`;
-  await fs24.writeFile(tmp, stringifyYaml4({ ...p, name }, { indent: 2 }), "utf8");
-  await fs24.rename(tmp, target);
+  await fs27.writeFile(tmp, stringifyYaml4({ ...p, name }, { indent: 2 }), "utf8");
+  await fs27.rename(tmp, target);
   return name;
 }
 
@@ -21814,6 +22419,8 @@ function odataFilter(worker, f) {
     parts.unshift(`PartitionKey eq '${esc2(worker)}'`);
   if (f.source !== "all")
     parts.push(`source eq '${esc2(f.source)}'`);
+  if (f.foundryConversationId)
+    parts.push(`foundryConversationId eq '${esc2(f.foundryConversationId)}'`);
   return parts.join(" and ");
 }
 async function fetchLedgerRows(filters, client) {
@@ -21965,7 +22572,7 @@ init_errors();
 // ../../packages/brain/engine/dist/esm/types.js
 var ENGINE_VERSION = "0.1.0";
 var DEFAULT_SAFETY_LAG_SECONDS = 3600;
-var SOURCES = ["webapp", "a2a", "mcp", "telegram"];
+var SOURCES = ["webapp", "a2a", "mcp", "telegram", "voice-relay"];
 var WORKER_ALIASES = { "azure-advisor": "azzy" };
 function canonicalWorker(pk) {
   const lower = pk.toLowerCase();
@@ -22029,9 +22636,11 @@ var TableCursor = class {
       throw e;
     }
     const watermarks = row.watermarks ? JSON.parse(row.watermarks) : {};
+    const fetchFailures = row.fetchFailures ? JSON.parse(row.fetchFailures) : void 0;
     return {
       worker: canonical,
       watermarks,
+      ...fetchFailures && Object.keys(fetchFailures).length > 0 ? { fetchFailures } : {},
       safetyLagSeconds: row.safetyLagSeconds ?? DEFAULT_SAFETY_LAG_SECONDS,
       engineVersion: row.engineVersion ?? ENGINE_VERSION,
       ...row.lastDreamAt ? { lastDreamAt: row.lastDreamAt } : {}
@@ -22054,9 +22663,12 @@ var TableCursor = class {
       safetyLagSeconds: cursor.safetyLagSeconds,
       engineVersion: cursor.engineVersion
     };
+    if (cursor.fetchFailures && Object.keys(cursor.fetchFailures).length > 0) {
+      entity.fetchFailures = JSON.stringify(cursor.fetchFailures);
+    }
     if (cursor.lastDreamAt)
       entity.lastDreamAt = cursor.lastDreamAt;
-    await this.client.upsertEntity(entity);
+    await this.client.upsertEntity(entity, "Replace");
   }
   async ensureTable() {
     try {
@@ -22092,9 +22704,22 @@ function computeWatermark(rows, now, safetyLagSeconds) {
 }
 async function commitCursorAdvance(plan, cursor) {
   const prior = await cursor.read(plan.worker);
+  const watermarks = {};
+  for (const [pk, watermark] of Object.entries(plan.watermarks)) {
+    const priorWatermark = Object.hasOwn(prior.watermarks, pk) ? prior.watermarks[pk] : void 0;
+    if (priorWatermark && watermark.ts <= priorWatermark.ts) {
+      watermarks[pk] = {
+        ts: watermark.ts,
+        consumedRowKeys: [.../* @__PURE__ */ new Set([...priorWatermark.consumedRowKeys, ...watermark.consumedRowKeys])]
+      };
+    } else {
+      watermarks[pk] = watermark;
+    }
+  }
   const next = {
     worker: plan.worker,
-    watermarks: plan.watermarks,
+    watermarks,
+    ...plan.fetchFailures && Object.keys(plan.fetchFailures).length > 0 ? { fetchFailures: plan.fetchFailures } : {},
     safetyLagSeconds: prior.safetyLagSeconds || DEFAULT_SAFETY_LAG_SECONDS,
     engineVersion: ENGINE_VERSION,
     lastDreamAt: (/* @__PURE__ */ new Date()).toISOString()
@@ -22348,6 +22973,7 @@ function normalize(group, items, enrichment) {
 
 // ../../packages/brain/engine/dist/esm/pipeline.js
 var isKnownSource = (s) => SOURCES.includes(s);
+var MAX_CONV_FETCH_ATTEMPTS = 3;
 async function runPipeline(args) {
   const { worker, sources, now, since, reset } = args;
   const monotonicNow = args.monotonicNow ?? Date.now;
@@ -22374,6 +23000,7 @@ async function runPipeline(args) {
   let recovered = 0;
   const consumedRowsByPk = {};
   const failedTsByPk = {};
+  const newFailures = {};
   const window2 = windowFor(rows, now, since);
   for (const g of groups) {
     const pk = g.worker;
@@ -22464,8 +23091,17 @@ async function runPipeline(args) {
       else
         recovered += 1;
     } else {
-      skips.addSkip(outcome, sampleId(g), fetchError?.message);
-      if (outcome === "conv-fetch-failed" || outcome === "auth-failed") {
+      let lastError = fetchError?.message;
+      if (outcome === "conv-fetch-failed") {
+        const id = conversationId ?? "";
+        const next = (cursor.fetchFailures?.[id] ?? 0) + 1;
+        newFailures[id] = next;
+        if (next >= MAX_CONV_FETCH_ATTEMPTS) {
+          lastError = `terminal after ${String(next)} cycles \u2014 watermark released`;
+        }
+      }
+      skips.addSkip(outcome, sampleId(g), lastError);
+      if (outcome === "auth-failed" || outcome === "conv-fetch-failed" && conversationId && newFailures[conversationId] < MAX_CONV_FETCH_ATTEMPTS) {
         const cur = failedTsByPk[pk];
         if (!cur || g.startedAt < cur)
           failedTsByPk[pk] = g.startedAt;
@@ -22485,7 +23121,7 @@ async function runPipeline(args) {
     latencyMs: Math.round(monotonicNow() - t0)
   };
   assertInvariant(stats, groups.length);
-  const advance = buildAdvancePlan(target, cursor, physicalPks, consumedRowsByPk, failedTsByPk, now, safetyLag);
+  const advance = buildAdvancePlan(target, cursor, physicalPks, consumedRowsByPk, failedTsByPk, newFailures, now, safetyLag);
   const out = {
     worker: target,
     window: window2,
@@ -22564,7 +23200,7 @@ function windowFor(rows, now, since) {
       from = r.eventTimestamp;
   return { from, to };
 }
-function buildAdvancePlan(worker, cursor, physicalPks, consumedRowsByPk, failedTsByPk, now, safetyLagSeconds) {
+function buildAdvancePlan(worker, cursor, physicalPks, consumedRowsByPk, failedTsByPk, fetchFailures, now, safetyLagSeconds) {
   const watermarks = {};
   const consumedKeysByPk = {};
   const priorTsByPk = {};
@@ -22588,6 +23224,7 @@ function buildAdvancePlan(worker, cursor, physicalPks, consumedRowsByPk, failedT
     watermarks,
     consumedRowsByPk: consumedKeysByPk,
     failedTsByPk,
+    ...Object.keys(fetchFailures).length > 0 ? { fetchFailures } : {},
     now: now.toISOString(),
     safetyLagSeconds,
     priorTsByPk
@@ -22597,7 +23234,7 @@ function buildAdvancePlan(worker, cursor, physicalPks, consumedRowsByPk, failedT
 // ../../packages/brain/engine/dist/esm/dream/writer.js
 var API2 = "https://api.github.com";
 var WRITER_ALLOWED_PREFIX = /^(memory|inbox|quarantine|artifacts)\//;
-var isAllowedWritePath = (path33, allowedPrefix) => allowedPrefix.test(path33) && !path33.split("/").includes("..");
+var isAllowedWritePath = (path37, allowedPrefix) => allowedPrefix.test(path37) && !path37.split("/").includes("..");
 var unquote = (s) => s.trim().replace(/^["']|["']$/g, "");
 function parseFrontmatter(content) {
   const m = /^---\n([\s\S]*?)\n---/.exec(content);
@@ -22640,8 +23277,8 @@ function makeGitDataWriter(args) {
   if (args.allowedPathPrefix && !args.allowedPathPrefix.source.startsWith("^")) {
     throw new Error(`makeGitDataWriter: allowedPathPrefix must be anchored with "^" (got /${args.allowedPathPrefix.source}/) \u2014 an unanchored regex would widen the B1 write-path allowlist`);
   }
-  async function gh(token, method, path33, body) {
-    const res = await doFetch(`${API2}/repos/${repoPath}${path33}`, {
+  async function gh(token, method, path37, body) {
+    const res = await doFetch(`${API2}/repos/${repoPath}${path37}`, {
       method,
       headers: {
         Authorization: `Bearer ${token}`,
@@ -22654,8 +23291,8 @@ function makeGitDataWriter(args) {
     const text = await res.text();
     return { status: res.status, ok: res.ok, json: text ? JSON.parse(text) : {} };
   }
-  async function readFileWith(token, path33) {
-    const encodedPath = path33.split("/").map(encodeURIComponent).join("/");
+  async function readFileWith(token, path37) {
+    const encodedPath = path37.split("/").map(encodeURIComponent).join("/");
     const r = await gh(token, "GET", `/contents/${encodedPath}?ref=${args.branch}`);
     if (r.status === 404)
       return null;
@@ -22671,9 +23308,9 @@ function makeGitDataWriter(args) {
         throw new Error(`fetchTip: HTTP ${String(r.status)}`);
       return r.json.object.sha;
     },
-    async readFile(path33) {
+    async readFile(path37) {
       const token = await args.mintToken();
-      return readFileWith(token, path33);
+      return readFileWith(token, path37);
     },
     async listMemory() {
       const token = await args.mintToken();
@@ -22682,9 +23319,9 @@ function makeGitDataWriter(args) {
         return [];
       const paths = r.json.tree.filter((e) => e.type === "blob" && e.path.startsWith("memory/") && e.path.endsWith(".md")).map((e) => e.path);
       const out = [];
-      for (const path33 of paths) {
-        const content = await readFileWith(token, path33);
-        out.push({ path: path33, frontmatter: content ? parseFrontmatter(content) : {} });
+      for (const path37 of paths) {
+        const content = await readFileWith(token, path37);
+        out.push({ path: path37, frontmatter: content ? parseFrontmatter(content) : {} });
       }
       return out;
     },
@@ -23123,7 +23760,7 @@ async function loadMemoryContext(brain) {
   return {
     files,
     indexEntries,
-    originOf: (path33) => originByPath.get(path33) ?? "worker"
+    originOf: (path37) => originByPath.get(path37) ?? "worker"
   };
 }
 
@@ -23144,14 +23781,14 @@ function checkEvidenceMembership(delta, harvested) {
 }
 var BatchAbort = class extends Error {
   path;
-  constructor(path33, message) {
+  constructor(path37, message) {
     super(message);
-    this.path = path33;
+    this.path = path37;
     this.name = "BatchAbort";
   }
 };
-var isIndexFile = (path33) => /(^|\/)[^/]*_index\.md$/.test(path33);
-var isMemoryIndex = (path33) => path33 === "memory/MEMORY.md";
+var isIndexFile = (path37) => /(^|\/)[^/]*_index\.md$/.test(path37);
+var isMemoryIndex = (path37) => path37 === "memory/MEMORY.md";
 function targetPath(delta) {
   switch (delta.verb) {
     case "new":
@@ -23168,29 +23805,29 @@ function targetPath(delta) {
 }
 async function checkOriginTier(delta, lookup) {
   const evidence = evidenceOf(delta) ?? [];
-  const path33 = targetPath(delta);
-  if (path33 === null)
+  const path37 = targetPath(delta);
+  if (path37 === null)
     return { ok: true };
-  if (isIndexFile(path33) && !isMemoryIndex(path33)) {
-    return { ok: false, flagged: { kind: "flagged", path: path33, tension: `refused: ${path33} is an index file (only memory/MEMORY.md is editable)`, evidence } };
+  if (isIndexFile(path37) && !isMemoryIndex(path37)) {
+    return { ok: false, flagged: { kind: "flagged", path: path37, tension: `refused: ${path37} is an index file (only memory/MEMORY.md is editable)`, evidence } };
   }
-  const target = await lookup(path33);
-  const isStructural = path33.startsWith("references/");
+  const target = await lookup(path37);
+  const isStructural = path37.startsWith("references/");
   const origin = target?.frontmatter.origin ?? (isStructural ? "operator" : "worker");
   const editable = origin === "worker" || origin === "dream";
   if (editable)
     return { ok: true };
   const removesOperatorTarget = delta.verb === "retract" || delta.verb === "supersede" && delta.oldPath !== delta.newPath;
   if (removesOperatorTarget) {
-    throw new BatchAbort(path33, `supersede/retract OLD target ${path33} is origin: ${origin} \u2014 aborting batch (never half-apply)`);
+    throw new BatchAbort(path37, `supersede/retract OLD target ${path37} is origin: ${origin} \u2014 aborting batch (never half-apply)`);
   }
-  return { ok: false, flagged: { kind: "flagged", path: path33, tension: `operator-origin (${origin}); flag-only`, evidence } };
+  return { ok: false, flagged: { kind: "flagged", path: path37, tension: `operator-origin (${origin}); flag-only`, evidence } };
 }
 var ALLOWED_MEMORY = /^memory\/.+\.md$/;
 var ALLOWED_INBOX = /^inbox\//;
 var ALLOWED_QUARANTINE = /^quarantine\//;
 var ALLOWED_FLAG = /^memory\//;
-var hasTraversal = (path33) => path33.split("/").includes("..");
+var hasTraversal = (path37) => path37.split("/").includes("..");
 function checkPathAllowed(delta) {
   const evidence = evidenceOf(delta) ?? [];
   const reject = (detail) => ({ ok: false, rejected: { kind: "rejected", detail, evidence } });
@@ -23297,7 +23934,7 @@ ${inject}
 ---
 `);
 }
-var indexLine = (path33, title, date, tags) => `- \`${path33}\` \u2014 **${title}**: ${title}. (${date} \xB7 ${tags.join(", ")})`;
+var indexLine = (path37, title, date, tags) => `- \`${path37}\` \u2014 **${title}**: ${title}. (${date} \xB7 ${tags.join(", ")})`;
 function splitIndex(index) {
   const all = index.split("\n");
   const firstLineIdx = all.findIndex((l) => l.startsWith("- `memory/"));
@@ -23470,16 +24107,16 @@ function defaultDreamSeams(opts = {}) {
       const mem = await memory(deps.brain);
       const harvested = harvestedIds(input);
       const ctx = { readFile: (p) => deps.brain.readFile(p), at: deps.clock() };
-      const lookup = (path33) => Promise.resolve(mem.files.find((f) => f.path === path33) ?? null);
+      const lookup = (path37) => Promise.resolve(mem.files.find((f) => f.path === path37) ?? null);
       const digest = [...pendingRejected];
       let changes = [];
       let indexEdit;
       try {
         for (const raw of deltas) {
           const delta = forcePolicyQuarantine(raw);
-          const path33 = checkPathAllowed(delta);
-          if (!path33.ok) {
-            digest.push(path33.rejected);
+          const path37 = checkPathAllowed(delta);
+          if (!path37.ok) {
+            digest.push(path37.rejected);
             continue;
           }
           const ev = checkEvidenceMembership(delta, harvested);
@@ -23580,6 +24217,7 @@ function narrowAdvance(src, kept) {
     watermarks,
     consumedRowsByPk,
     failedTsByPk: src.failedTsByPk,
+    ...src.fetchFailures ? { fetchFailures: src.fetchFailures } : {},
     now,
     safetyLagSeconds,
     priorTsByPk
@@ -23597,7 +24235,13 @@ function filterAdvance(src, keptRowsByPk) {
     consumedRowsByPk[pk] = (src.consumedRowsByPk[pk] ?? []).filter((rk) => keep.has(rk));
     watermarks[pk] = { ts: wm.ts, consumedRowKeys: wm.consumedRowKeys.filter((rk) => keep.has(rk)) };
   }
-  return { worker: src.worker, watermarks, consumedRowsByPk, failedTsByPk: src.failedTsByPk };
+  return {
+    worker: src.worker,
+    watermarks,
+    consumedRowsByPk,
+    failedTsByPk: src.failedTsByPk,
+    ...src.fetchFailures ? { fetchFailures: src.fetchFailures } : {}
+  };
 }
 
 // ../../packages/brain/engine/dist/esm/dream/index.js
@@ -23615,6 +24259,18 @@ async function runDream(input, deps, seams = defaultDreamSeams()) {
     });
   }
   input = capped;
+  if (input.conversations.length === 0) {
+    await commitCursorAdvance(input.advance, deps.cursor);
+    deps.logger.info({
+      at: "runDream",
+      worker: input.worker,
+      terminal: "no-corpus",
+      skipped: input.stats.skipped,
+      advanced: true,
+      skipLedger: input.skipLedger.map((s) => `${s.reason}:${String(s.count)}`)
+    });
+    return { worker: input.worker, applied: [], digest, advanced: true };
+  }
   const proposed = await seams.propose(input, deps);
   digest.push({ kind: "cost", model: proposed.cost.model, inputTokens: proposed.cost.inputTokens, outputTokens: proposed.cost.outputTokens, ms: proposed.cost.ms });
   if (!proposed.deltas) {
@@ -24699,9 +25355,9 @@ ${colors.error("  " + why)}
 }
 
 // src/commands/bootstrap/launch.ts
-import * as fs27 from "fs";
-import * as os13 from "os";
-import * as path28 from "path";
+import * as fs30 from "fs";
+import * as os14 from "os";
+import * as path32 from "path";
 import { Command as Command49, Option as Option46 } from "clipanion";
 init_errors();
 
@@ -24847,9 +25503,9 @@ async function kickInstaller(s) {
 
 // src/lib/bootstrap-status.ts
 import { createHash as createHash4, randomUUID as randomUUID2 } from "crypto";
-import * as fs25 from "fs/promises";
-import * as os11 from "os";
-import * as path26 from "path";
+import * as fs28 from "fs/promises";
+import * as os12 from "os";
+import * as path30 from "path";
 init_errors();
 var STATUS_CONTAINER = "status";
 var STATUS_BLOB = "status.json";
@@ -24888,7 +25544,7 @@ async function readStatusBlob(opts) {
       cause: e
     });
   }
-  const tmpFile = path26.join(os11.tmpdir(), `m8t-status-${randomUUID2()}.json`);
+  const tmpFile = path30.join(os12.tmpdir(), `m8t-status-${randomUUID2()}.json`);
   try {
     await runAz([
       "storage",
@@ -24907,7 +25563,7 @@ async function readStatusBlob(opts) {
       "--no-progress",
       "--only-show-errors"
     ]);
-    const raw = await fs25.readFile(tmpFile, "utf8");
+    const raw = await fs28.readFile(tmpFile, "utf8");
     return JSON.parse(raw.trim());
   } catch (e) {
     throw new LocalCliError({
@@ -24917,34 +25573,34 @@ async function readStatusBlob(opts) {
       cause: e
     });
   } finally {
-    await fs25.rm(tmpFile, { force: true });
+    await fs28.rm(tmpFile, { force: true });
   }
 }
 
 // src/lib/bootstrap-state.ts
-import * as fs26 from "fs/promises";
-import * as os12 from "os";
-import * as path27 from "path";
+import * as fs29 from "fs/promises";
+import * as os13 from "os";
+import * as path31 from "path";
 function stateDir(home) {
-  return path27.join(home, ".m8t-stack");
+  return path31.join(home, ".m8t-stack");
 }
 function statePath(home) {
-  return path27.join(stateDir(home), "bootstrap.json");
+  return path31.join(stateDir(home), "bootstrap.json");
 }
-async function readBootstrapState(home = os12.homedir()) {
+async function readBootstrapState(home = os13.homedir()) {
   try {
-    const raw = await fs26.readFile(statePath(home), "utf8");
+    const raw = await fs29.readFile(statePath(home), "utf8");
     return JSON.parse(raw);
   } catch (e) {
     if (e.code === "ENOENT") return null;
     throw e;
   }
 }
-async function writeBootstrapState(state, home = os12.homedir()) {
-  await fs26.mkdir(stateDir(home), { recursive: true });
+async function writeBootstrapState(state, home = os13.homedir()) {
+  await fs29.mkdir(stateDir(home), { recursive: true });
   const tmp = `${statePath(home)}.tmp`;
-  await fs26.writeFile(tmp, JSON.stringify(state, null, 2), "utf8");
-  await fs26.rename(tmp, statePath(home));
+  await fs29.writeFile(tmp, JSON.stringify(state, null, 2), "utf8");
+  await fs29.rename(tmp, statePath(home));
 }
 
 // src/commands/bootstrap/launch.ts
@@ -24984,12 +25640,12 @@ var BootstrapLaunchCommand = class extends M8tCommand {
     const subscriptionId = (typeof this.subscription === "string" ? this.subscription : void 0) ?? account.subscriptionId;
     const out = (m) => this.context.stderr.write(`  ${colors.dim(m)}
 `);
-    const credsPath = typeof this.githubAppCreds === "string" ? this.githubAppCreds : path28.join(os13.homedir(), ".m8t-stack", "github-app.json");
+    const credsPath = typeof this.githubAppCreds === "string" ? this.githubAppCreds : path32.join(os14.homedir(), ".m8t-stack", "github-app.json");
     let githubApp;
-    if (fs27.existsSync(credsPath)) {
+    if (fs30.existsSync(credsPath)) {
       let parsed;
       try {
-        parsed = JSON.parse(fs27.readFileSync(credsPath, "utf8"));
+        parsed = JSON.parse(fs30.readFileSync(credsPath, "utf8"));
       } catch {
         throw new LocalCliError({
           code: "GITHUB_APP_CREDS_INVALID",
@@ -24999,7 +25655,7 @@ var BootstrapLaunchCommand = class extends M8tCommand {
       }
       let pem;
       try {
-        pem = fs27.readFileSync(parsed.pemPath, "utf8");
+        pem = fs30.readFileSync(parsed.pemPath, "utf8");
       } catch {
         throw new LocalCliError({
           code: "GITHUB_APP_PEM_MISSING",
@@ -25324,17 +25980,17 @@ Found ${String(found.length)} orphaned Owner@sub assignment(s) (dry-run). ${colo
 };
 
 // src/commands/bootstrap/finish.ts
-import * as fs28 from "fs/promises";
-import * as os15 from "os";
-import * as path30 from "path";
+import * as fs31 from "fs/promises";
+import * as os16 from "os";
+import * as path34 from "path";
 import { Command as Command52, Option as Option49 } from "clipanion";
 init_errors();
 
 // src/lib/company-profile-seed.ts
 import { spawn as spawn6 } from "child_process";
-import { closeSync, openSync, readFileSync as readFileSync19 } from "fs";
-import * as os14 from "os";
-import * as path29 from "path";
+import { closeSync, openSync, readFileSync as readFileSync20 } from "fs";
+import * as os15 from "os";
+import * as path33 from "path";
 init_errors();
 
 // src/lib/onboarding-profile.ts
@@ -25515,9 +26171,9 @@ function composeFounderIdentityNote(id) {
 
 // src/lib/company-profile-seed.ts
 function readGithubAppCreds(credsPath) {
-  const p = credsPath ?? path29.join(os14.homedir(), ".m8t-stack", "github-app.json");
+  const p = credsPath ?? path33.join(os15.homedir(), ".m8t-stack", "github-app.json");
   try {
-    return JSON.parse(readFileSync19(p, "utf8"));
+    return JSON.parse(readFileSync20(p, "utf8"));
   } catch {
     return null;
   }
@@ -25545,7 +26201,7 @@ async function resolveSeedContext(opts) {
 async function applyProfileToBrain(args) {
   const token = await mintInstallationTokenFromPem({
     appId: args.appCreds.appId,
-    privateKeyPem: readFileSync19(args.appCreds.pemPath, "utf8"),
+    privateKeyPem: readFileSync20(args.appCreds.pemPath, "utf8"),
     installationId: args.appCreds.installationId,
     fetchImpl: args.fetchImpl
   });
@@ -25580,7 +26236,7 @@ async function applyProfileToBrain(args) {
   });
 }
 function spawnDetachedSeedWatch() {
-  const logPath = path29.join(os14.homedir(), ".m8t-stack", "seed-profile.log");
+  const logPath = path33.join(os15.homedir(), ".m8t-stack", "seed-profile.log");
   const fd = openSync(logPath, "a");
   try {
     const child = spawn6(process.execPath, [process.argv[1] ?? "", "bootstrap", "seed-profile", "--watch"], {
@@ -25679,9 +26335,9 @@ var BootstrapFinishCommand = class extends M8tCommand {
       });
     }
     const repoRoot = (typeof this.repoRoot === "string" ? this.repoRoot : void 0) ?? process.cwd();
-    const markerDir = path30.join(os15.homedir(), ".m8t-stack");
-    await fs28.mkdir(markerDir, { recursive: true });
-    await fs28.writeFile(path30.join(markerDir, "repo-root"), `${repoRoot}
+    const markerDir = path34.join(os16.homedir(), ".m8t-stack");
+    await fs31.mkdir(markerDir, { recursive: true });
+    await fs31.writeFile(path34.join(markerDir, "repo-root"), `${repoRoot}
 `, "utf8");
     const subscriptionId = (typeof this.subscription === "string" ? this.subscription : void 0) ?? state.subscriptionId;
     const resourceGroup = (typeof this.resourceGroup === "string" ? this.resourceGroup : void 0) ?? state.resourceGroup;
@@ -25717,7 +26373,7 @@ var BootstrapFinishCommand = class extends M8tCommand {
     }
     let brainOrg = null;
     try {
-      const credsRaw = await fs28.readFile(path30.join(markerDir, "github-app.json"), "utf8");
+      const credsRaw = await fs31.readFile(path34.join(markerDir, "github-app.json"), "utf8");
       const creds = JSON.parse(credsRaw);
       brainOrg = typeof creds.org === "string" ? creds.org : null;
     } catch {
@@ -25748,18 +26404,18 @@ ${colors.field("Then open a brand new chat/session")} \u2014 new skills + MCP se
 };
 
 // src/commands/bootstrap/ui.ts
-import * as fs30 from "fs";
-import * as os17 from "os";
-import * as path32 from "path";
+import * as fs33 from "fs";
+import * as os18 from "os";
+import * as path36 from "path";
 import { Command as Command53, Option as Option50 } from "clipanion";
 import { DefaultAzureCredential as DefaultAzureCredential20 } from "@azure/identity";
 init_errors();
 
 // src/lib/bootstrap-ui.ts
-import * as fs29 from "fs";
+import * as fs32 from "fs";
 import * as net from "net";
-import * as os16 from "os";
-import * as path31 from "path";
+import * as os17 from "os";
+import * as path35 from "path";
 import { spawn as spawn7 } from "child_process";
 init_errors();
 init_rbac();
@@ -25826,9 +26482,9 @@ async function ensureFounderFoundryRole(args) {
   });
 }
 function writeWebEnvLocal(args) {
-  const envPath = path31.join(args.repoRoot, "apps", "web", ".env.local");
-  if (fs29.existsSync(envPath)) {
-    fs29.copyFileSync(envPath, envPath + ".bak");
+  const envPath = path35.join(args.repoRoot, "apps", "web", ".env.local");
+  if (fs32.existsSync(envPath)) {
+    fs32.copyFileSync(envPath, envPath + ".bak");
   }
   const body = [
     "# Written by `m8t bootstrap ui` \u2014 onboarding chat-only run (Simple Stacey).",
@@ -25836,13 +26492,14 @@ function writeWebEnvLocal(args) {
     `AZURE_TENANT_ID=${args.tenantId}`,
     `AZURE_CLIENT_ID=${args.clientId}`,
     `FOUNDRY_PROJECT_ENDPOINT=${args.foundryEndpoint}`,
+    "VOICE_RELAY_PUBLIC_URL=ws://localhost:8790",
     "STORAGE_ACCOUNT_NAME=",
     "M8T_DISABLE_WORKER=1",
     "M8T_ONBOARDING=1",
     "NEXT_PUBLIC_M8T_ONBOARDING=1",
     ""
   ].join("\n");
-  fs29.writeFileSync(envPath, body, "utf8");
+  fs32.writeFileSync(envPath, body, "utf8");
   return envPath;
 }
 function assertNodeVersion(versionString = process.version) {
@@ -25883,18 +26540,23 @@ async function installWebDeps(repoRoot) {
   });
   await runInherit("pnpm", ["install"], repoRoot, "BOOTSTRAP_UI_INSTALL_FAILED");
 }
-function onboardingUiPaths(home = os16.homedir()) {
-  const dir = path31.join(home, ".m8t-stack");
+function onboardingUiPaths(home = os17.homedir()) {
+  const dir = path35.join(home, ".m8t-stack");
   return {
-    logPath: path31.join(dir, "onboarding-ui.log"),
-    pidPath: path31.join(dir, "onboarding-ui.pid")
+    logPath: path35.join(dir, "onboarding-ui.log"),
+    pidPath: path35.join(dir, "onboarding-ui.pid")
   };
 }
-async function serveOnboardingUiDetached(args) {
-  const { logPath, pidPath } = onboardingUiPaths();
-  const portNum = Number(args.port);
-  const isPortOpen = () => new Promise((resolve3) => {
-    const s = net.createConnection({ host: "127.0.0.1", port: portNum });
+function onboardingRelayPaths(home = os17.homedir()) {
+  const dir = path35.join(home, ".m8t-stack");
+  return {
+    logPath: path35.join(dir, "onboarding-relay.log"),
+    pidPath: path35.join(dir, "onboarding-relay.pid")
+  };
+}
+function isLocalPortOpen(port) {
+  return new Promise((resolve3) => {
+    const s = net.createConnection({ host: "127.0.0.1", port });
     s.setTimeout(1e3);
     s.on("connect", () => {
       s.destroy();
@@ -25908,11 +26570,16 @@ async function serveOnboardingUiDetached(args) {
       resolve3(false);
     });
   });
+}
+async function serveOnboardingUiDetached(args) {
+  const { logPath, pidPath } = onboardingUiPaths();
+  const portNum = Number(args.port);
+  const isPortOpen = () => isLocalPortOpen(portNum);
   if (await isPortOpen()) {
     return { alreadyRunning: true, logPath };
   }
-  fs29.mkdirSync(path31.dirname(logPath), { recursive: true });
-  const fd = fs29.openSync(logPath, "a");
+  fs32.mkdirSync(path35.dirname(logPath), { recursive: true });
+  const fd = fs32.openSync(logPath, "a");
   const child = spawn7("pnpm", ["--filter", "web", "dev"], {
     cwd: args.repoRoot,
     detached: true,
@@ -25920,7 +26587,7 @@ async function serveOnboardingUiDetached(args) {
     env: { ...process.env, PORT: args.port },
     shell: false
   });
-  fs29.closeSync(fd);
+  fs32.closeSync(fd);
   if (child.pid == null) {
     throw new LocalCliError({
       code: "BOOTSTRAP_UI_DEV_SPAWN_FAILED",
@@ -25929,7 +26596,7 @@ async function serveOnboardingUiDetached(args) {
     });
   }
   child.unref();
-  fs29.writeFileSync(pidPath, String(child.pid), "utf8");
+  fs32.writeFileSync(pidPath, String(child.pid), "utf8");
   const deadline = Date.now() + 45e3;
   const sleep3 = (ms) => new Promise((r) => setTimeout(r, ms));
   while (Date.now() < deadline) {
@@ -25938,6 +26605,46 @@ async function serveOnboardingUiDetached(args) {
   }
   return { alreadyRunning: false, logPath };
 }
+async function serveOnboardingRelayDetached(args) {
+  const { logPath, pidPath } = onboardingRelayPaths();
+  const portNum = 8790;
+  if (await isLocalPortOpen(portNum)) {
+    return { alreadyRunning: true, logPath };
+  }
+  fs32.mkdirSync(path35.dirname(logPath), { recursive: true });
+  const fd = fs32.openSync(logPath, "a");
+  const child = spawn7("pnpm", ["--filter", "web", "exec", "tsx", "voice-relay-entry.ts"], {
+    cwd: args.repoRoot,
+    detached: true,
+    stdio: ["ignore", fd, fd],
+    env: {
+      ...process.env,
+      FOUNDRY_PROJECT_ENDPOINT: args.foundryEndpoint,
+      AZURE_TENANT_ID: args.tenantId,
+      AZURE_CLIENT_ID: args.clientId,
+      RELAY_ALLOWED_ORIGINS: "http://localhost:3000",
+      RELAY_PORT: "8790"
+    },
+    shell: false
+  });
+  fs32.closeSync(fd);
+  if (child.pid == null) {
+    throw new LocalCliError({
+      code: "BOOTSTRAP_UI_RELAY_SPAWN_FAILED",
+      message: "Could not start the voice relay (pnpm did not spawn).",
+      hint: "Check that pnpm + Node 20+ are installed; see the log at " + logPath + "."
+    });
+  }
+  child.unref();
+  fs32.writeFileSync(pidPath, String(child.pid), "utf8");
+  const deadline = Date.now() + 45e3;
+  const sleep3 = (ms) => new Promise((r) => setTimeout(r, ms));
+  while (Date.now() < deadline) {
+    await sleep3(500);
+    if (await isLocalPortOpen(portNum)) break;
+  }
+  return { alreadyRunning: false, logPath };
+}
 function autoOpenOnboardingUi(url, open = tryOpenUrl) {
   try {
     const result = open(url);
@@ -25948,11 +26655,10 @@ function autoOpenOnboardingUi(url, open = tryOpenUrl) {
   } catch {
   }
 }
-function stopOnboardingUi(home = os16.homedir()) {
-  const { pidPath } = onboardingUiPaths(home);
+function stopPidFile(pidPath) {
   let pidStr;
   try {
-    pidStr = fs29.readFileSync(pidPath, "utf8").trim();
+    pidStr = fs32.readFileSync(pidPath, "utf8").trim();
   } catch {
     return false;
   }
@@ -25965,11 +26671,16 @@ function stopOnboardingUi(home = os16.homedir()) {
     }
   }
   try {
-    fs29.unlinkSync(pidPath);
+    fs32.unlinkSync(pidPath);
   } catch {
   }
   return true;
 }
+function stopOnboardingUi(home = os17.homedir()) {
+  const uiStopped = stopPidFile(onboardingUiPaths(home).pidPath);
+  const relayStopped = stopPidFile(onboardingRelayPaths(home).pidPath);
+  return uiStopped || relayStopped;
+}
 
 // src/lib/simple-stacey.ts
 var SIMPLE_STACEY_PERSONA = "startup-advisor-intake";
@@ -26081,7 +26792,7 @@ var BootstrapUiCommand = class extends M8tCommand {
       this.context.stderr.write(`  ${colors.dim(m)}
 `);
     };
-    if (fs30.existsSync(path32.join(os17.homedir(), ".m8t-stack", "config.yaml"))) {
+    if (fs33.existsSync(path36.join(os18.homedir(), ".m8t-stack", "config.yaml"))) {
       out(colors.error("\u26A0 an existing ~/.m8t-stack/config.yaml will override the onboarding app registration in apps/web \u2014 if Microsoft sign-in fails, move it aside and retry."));
     }
     const credential2 = new DefaultAzureCredential20();
@@ -26131,10 +26842,26 @@ var BootstrapUiCommand = class extends M8tCommand {
       return 0;
     }
     if (this.foreground === true) {
+      out("starting the voice relay on :8790 in the background\u2026");
+      await serveOnboardingRelayDetached({
+        repoRoot,
+        foundryEndpoint: endpoint,
+        tenantId: account.tenantId,
+        clientId: state.appRegClientId
+      });
+      out("voice relay on :8790");
       out("starting the webapp on :3000 (Ctrl-C to stop)\u2026");
       await runInherit("pnpm", ["--filter", "web", "dev"], repoRoot, "BOOTSTRAP_UI_DEV_FAILED");
       return 0;
     }
+    out("starting the voice relay on :8790 in the background\u2026");
+    await serveOnboardingRelayDetached({
+      repoRoot,
+      foundryEndpoint: endpoint,
+      tenantId: account.tenantId,
+      clientId: state.appRegClientId
+    });
+    out("voice relay on :8790");
     out("starting the webapp on :3000 in the background\u2026");
     const { alreadyRunning, logPath } = await serveOnboardingUiDetached({ repoRoot, port: this.port });
     if (alreadyRunning) {