@agent-native/core 0.90.11 → 0.91.1

package/corpus/templates/slides/actions/get-design-system.ts

@@ -8,9 +8,146 @@ import { z } from "zod";
 
 import "../server/db/index.js"; // ensure registerShareableResource runs
 
+const MAX_AGENT_CONTEXT_CHARS = 14_000;
+const MAX_JSON_CONTEXT_CHARS = 2_500;
+const MAX_BUILDER_DOCS = 8;
+const MAX_BUILDER_DOC_CHARS = 1_200;
+const MAX_TOKEN_VALUES = 48;
+
+interface BuilderGenerationContext {
+  builderDesignSystemId: string;
+  builderJobId: string;
+  builderProjectId?: string;
+  builderUrl?: string;
+  builderStatus?: string;
+  docs: Array<{
+    name?: string;
+    type?: string;
+    description?: string;
+    content?: string;
+    tokenValues?: Record<string, string>;
+  }>;
+  tokenValues: Record<string, string>;
+  docCount: number;
+  warning?: string;
+}
+
+function truncate(value: string, maxChars: number): string {
+  if (value.length <= maxChars) return value;
+  return `${value.slice(0, maxChars).trimEnd()}\n[truncated]`;
+}
+
+function parseJson(value: string | null | undefined): unknown {
+  if (!value) return null;
+  try {
+    return JSON.parse(value);
+  } catch {
+    return null;
+  }
+}
+
+function formatJson(value: unknown, maxChars = MAX_JSON_CONTEXT_CHARS): string {
+  return truncate(JSON.stringify(value, null, 2), maxChars);
+}
+
+function formatTokenValues(tokenValues: Record<string, string>): string[] {
+  const entries = Object.entries(tokenValues)
+    .filter(([, value]) => typeof value === "string" && value.trim())
+    .slice(0, MAX_TOKEN_VALUES);
+  if (entries.length === 0) return [];
+  return [
+    "Builder DSI token values to apply first:",
+    ...entries.map(([name, value]) => `- ${name}: ${value}`),
+  ];
+}
+
+function buildDesignSystemAgentContext({
+  id,
+  title,
+  description,
+  data,
+  assets,
+  customInstructions,
+  builder,
+}: {
+  id: string;
+  title: string;
+  description?: string | null;
+  data?: string | null;
+  assets?: string | null;
+  customInstructions?: string | null;
+  builder: BuilderGenerationContext | null;
+}): string {
+  const lines: string[] = [
+    "## Selected Design System Context",
+    `Use "${title}" (id: ${id}) as the visual source of truth for this deck.`,
+    "Apply these tokens, assets, and usage notes before choosing colors, type, spacing, radius, imagery, slide defaults, or component language.",
+  ];
+
+  if (description?.trim()) {
+    lines.push("", "Description:", description.trim());
+  }
+
+  if (customInstructions?.trim()) {
+    lines.push("", "Custom instructions:", customInstructions.trim());
+  }
+
+  const parsedAssets = parseJson(assets);
+  if (Array.isArray(parsedAssets) && parsedAssets.length > 0) {
+    lines.push("", "Design system assets:", formatJson(parsedAssets));
+  }
+
+  if (builder) {
+    lines.push(
+      "",
+      "Builder DSI:",
+      `- Design system id: ${builder.builderDesignSystemId}`,
+      `- Job id: ${builder.builderJobId}`,
+      builder.builderProjectId
+        ? `- Project id: ${builder.builderProjectId}`
+        : "",
+      builder.builderUrl ? `- URL: ${builder.builderUrl}` : "",
+      builder.builderStatus ? `- Status: ${builder.builderStatus}` : "",
+      "- Builder DSI docs and token values override local proxy placeholders.",
+      "- Do not substitute a generic style if DSI docs or tokens are unavailable; call get-design-system again or tell the user Builder indexing is not ready.",
+    );
+
+    if (builder.warning) {
+      lines.push(`- Warning: ${builder.warning}`);
+    }
+
+    lines.push("", ...formatTokenValues(builder.tokenValues));
+
+    const docs = builder.docs.slice(0, MAX_BUILDER_DOCS);
+    if (docs.length > 0) {
+      lines.push("", "Builder DSI docs to follow:");
+      for (const doc of docs) {
+        const label = [doc.name, doc.type ? `(${doc.type})` : ""]
+          .filter(Boolean)
+          .join(" ");
+        lines.push(
+          "",
+          `### ${label || "Design system doc"}`,
+          doc.description?.trim() ? doc.description.trim() : "",
+          doc.content?.trim()
+            ? truncate(doc.content.trim(), MAX_BUILDER_DOC_CHARS)
+            : "",
+        );
+      }
+    }
+  } else {
+    const parsedData = parseJson(data);
+    if (parsedData) {
+      lines.push("", "Local design-system tokens:", formatJson(parsedData));
+    }
+  }
+
+  return truncate(lines.filter(Boolean).join("\n"), MAX_AGENT_CONTEXT_CHARS);
+}
+
 export default defineAction({
   description:
-    "Get a design system by ID. Returns full design system data including colors, typography, spacing, and assets.",
+    "Get a design system by ID. Returns full design system data including colors, typography, spacing, assets, and a compact agentContext for generation.",
   schema: z.object({
     id: z.string().describe("Design system ID"),
   }),
@@ -51,6 +188,15 @@ export default defineAction({
       createdAt: row.createdAt,
       updatedAt: row.updatedAt,
       builder,
+      agentContext: buildDesignSystemAgentContext({
+        id: row.id,
+        title: row.title,
+        description: row.description,
+        data: row.data,
+        assets: row.assets,
+        customInstructions: row.customInstructions,
+        builder,
+      }),
     };
   },
 });

package/corpus/templates/slides/app/pages/Index.tsx

@@ -101,6 +101,47 @@ function truncateSourceForContext(prompt: string): {
   };
 }
 
+interface DesignSystemGenerationContextResult {
+  title?: string;
+  agentContext?: string;
+}
+
+async function loadDesignSystemGenerationContext(
+  designSystemId?: string | null,
+): Promise<string> {
+  if (!designSystemId) return "";
+  try {
+    const result = (await callAction(
+      "get-design-system",
+      { id: designSystemId },
+      { method: "GET" },
+    )) as DesignSystemGenerationContextResult | undefined;
+    if (result?.agentContext?.trim()) {
+      return [
+        "",
+        result.agentContext.trim(),
+        "",
+        "The selected design system context above was hydrated before this agent run. Follow it directly; do not replace it with generic colors, fonts, spacing, imagery, or slide components.",
+      ].join("\n");
+    }
+  } catch (error) {
+    const message =
+      error instanceof Error ? error.message : "unknown loading error";
+    return [
+      "",
+      "## Selected Design System Context",
+      `The selected design system id "${designSystemId}" could not be loaded before generation: ${message}`,
+      "Before adding slides, call `get-design-system` for this id. If it still fails, stop and tell the user the selected design system is unavailable instead of improvising a generic style.",
+    ].join("\n");
+  }
+  return [
+    "",
+    "## Selected Design System Context",
+    `The selected design system id "${designSystemId}" returned no generation context.`,
+    "Call `get-design-system` for this id before adding slides. If it still has no usable tokens/docs, stop and ask the user to finish design-system indexing instead of improvising a generic style.",
+  ].join("\n");
+}
+
 function describeUploadedFilesForAgent(
   files: UploadedFile[],
   deckId: string,
@@ -359,13 +400,17 @@ export default function Index() {
             "If the action cannot read a private document, tell the user the exact sharing step from the action error instead of generating from the URL alone.",
           ].join("\n")
         : "";
+    const hydratedDesignSystemContext = await loadDesignSystemGenerationContext(
+      selectedDesignSystem?.id,
+    );
     const designSystemContext = selectedDesignSystem
       ? [
           "",
           "Design system selection:",
           `- Use "${selectedDesignSystem.title}" (id: ${selectedDesignSystem.id}).`,
           "- The deck has already been linked to this design system.",
-          `- Before adding slides, call \`get-design-system --id ${selectedDesignSystem.id}\` and use its tokens for colors, typography, spacing, imagery, and slide defaults.`,
+          "- Use the hydrated design system context below for colors, typography, spacing, imagery, and slide defaults.",
+          hydratedDesignSystemContext,
           "- Do not choose or apply a different design system.",
         ].join("\n")
       : [

package/corpus/templates/slides/app/routes/settings.tsx

@@ -4,9 +4,11 @@ import {
   SettingsTabsPage,
   useAgentSettingsTabs,
   useT,
+  type SettingsSearchEntry,
 } from "@agent-native/core/client";
 import { TeamPage } from "@agent-native/core/client/org";
 import { useSetPageTitle } from "@agent-native/toolkit/app-shell";
+import { useMemo } from "react";
 
 import {
   Card,
@@ -29,17 +31,30 @@ export default function SettingsRoute() {
   const agentSettingsTabs = useAgentSettingsTabs();
   useSetPageTitle(t("settings.title"));
 
+  const generalSearchEntries = useMemo<SettingsSearchEntry[]>(
+    () => [
+      {
+        id: "slides-language",
+        label: t("settings.languageTitle"),
+        keywords: "language locale translation i18n",
+        hash: "language",
+      },
+    ],
+    [t],
+  );
+
   return (
     <SettingsTabsPage
       teamLabel={t("navigation.team")}
       extraTabs={agentSettingsTabs}
+      generalSearchEntries={generalSearchEntries}
       general={
         <div className="mx-auto w-full max-w-3xl space-y-6">
           <p className="text-sm leading-6 text-muted-foreground">
             {t("settings.description")}
           </p>
 
-          <Card>
+          <Card id="language" className="scroll-mt-16">
             <CardHeader>
               <CardTitle className="text-base">
                 {t("settings.languageTitle")}

package/corpus/templates/slides/changelog/2026-07-08-deck-generation-now-follows-hydrated-builder-design-system-g.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-08
+---
+
+Deck generation now follows hydrated Builder design-system guidance before adding slides.

package/corpus/templates/slides/changelog/2026-07-08-settings-are-cleaner-and-searchable.md

@@ -0,0 +1,5 @@
+---
+type: improved
+---
+
+Settings are cleaner and searchable, with a consistent navigation that jumps straight to any setting.

package/dist/agent/run-ownership.d.ts

@@ -1,3 +1,5 @@
+import type { AccessContext } from "../sharing/access.js";
+import type { ShareRole } from "../sharing/schema.js";
 /**
  * Resolve a run's owning thread id. Checks in-memory run state first (populated
  * synchronously by startRun, so there is no race against the async SQL insert),
@@ -7,6 +9,10 @@
 export declare function resolveRunThreadId(runId: string): Promise<string | null>;
 /** True when `owner` owns the chat thread `threadId`. */
 export declare function callerOwnsThread(owner: string, threadId: string | null | undefined): Promise<boolean>;
+/** True when `owner` has at least `role` access to the chat thread. */
+export declare function callerHasThreadAccess(owner: string, threadId: string | null | undefined, role?: ShareRole | "owner", ctx?: Omit<AccessContext, "userEmail">): Promise<boolean>;
 /** True when `owner` owns the thread that run `runId` belongs to. */
 export declare function callerOwnsRun(owner: string, runId: string): Promise<boolean>;
+/** True when `owner` has at least `role` access to the thread behind `runId`. */
+export declare function callerHasRunAccess(owner: string, runId: string, role?: ShareRole | "owner", ctx?: Omit<AccessContext, "userEmail">): Promise<boolean>;
 //# sourceMappingURL=run-ownership.d.ts.map

package/dist/agent/run-ownership.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-ownership.d.ts","sourceRoot":"","sources":["../../src/agent/run-ownership.ts"],"names":[],"mappings":"AAeA;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAKxB;AAED,yDAAyD;AACzD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAClC,OAAO,CAAC,OAAO,CAAC,CAIlB;AAED,qEAAqE;AACrE,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC,CAElB"}
+{"version":3,"file":"run-ownership.d.ts","sourceRoot":"","sources":["../../src/agent/run-ownership.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAetD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAKxB;AAED,yDAAyD;AACzD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAClC,OAAO,CAAC,OAAO,CAAC,CAIlB;AAED,uEAAuE;AACvE,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,IAAI,GAAE,SAAS,GAAG,OAAkB,EACpC,GAAG,GAAE,IAAI,CAAC,aAAa,EAAE,WAAW,CAAM,GACzC,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED,qEAAqE;AACrE,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC,CAElB;AAED,iFAAiF;AACjF,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,SAAS,GAAG,OAAkB,EACpC,GAAG,GAAE,IAAI,CAAC,aAAa,EAAE,WAAW,CAAM,GACzC,OAAO,CAAC,OAAO,CAAC,CAOlB"}

package/dist/agent/run-ownership.js

@@ -1,4 +1,4 @@
-import { getThread } from "../chat-threads/store.js";
+import { getThread, resolveThreadAccess } from "../chat-threads/store.js";
 /**
  * Ownership checks for the agent run HTTP routes (`/runs/:id/events`,
  * `/runs/:id/abort`, `/runs/active`).
@@ -32,8 +32,18 @@ export async function callerOwnsThread(owner, threadId) {
     const thread = await getThread(threadId);
     return !!thread && thread.ownerEmail === owner;
 }
+/** True when `owner` has at least `role` access to the chat thread. */
+export async function callerHasThreadAccess(owner, threadId, role = "viewer", ctx = {}) {
+    if (!threadId)
+        return false;
+    return !!(await resolveThreadAccess(owner, threadId, role, ctx));
+}
 /** True when `owner` owns the thread that run `runId` belongs to. */
 export async function callerOwnsRun(owner, runId) {
     return callerOwnsThread(owner, await resolveRunThreadId(runId));
 }
+/** True when `owner` has at least `role` access to the thread behind `runId`. */
+export async function callerHasRunAccess(owner, runId, role = "viewer", ctx = {}) {
+    return callerHasThreadAccess(owner, await resolveRunThreadId(runId), role, ctx);
+}
 //# sourceMappingURL=run-ownership.js.map

package/dist/agent/run-ownership.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-ownership.js","sourceRoot":"","sources":["../../src/agent/run-ownership.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD;;;;;;;;;;GAUG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAa;IAEb,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC;IACnC,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;IACpC,OAAO,GAAG,EAAE,QAAQ,IAAI,IAAI,CAAC;AAC/B,CAAC;AAED,yDAAyD;AACzD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAa,EACb,QAAmC;IAEnC,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;IACzC,OAAO,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU,KAAK,KAAK,CAAC;AACjD,CAAC;AAED,qEAAqE;AACrE,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAa,EACb,KAAa;IAEb,OAAO,gBAAgB,CAAC,KAAK,EAAE,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;AAClE,CAAC","sourcesContent":["import { getThread } from \"../chat-threads/store.js\";\n/**\n * Ownership checks for the agent run HTTP routes (`/runs/:id/events`,\n * `/runs/:id/abort`, `/runs/active`).\n *\n * `agent_runs` has no owner column — a run's ownership lives on its\n * `chat_threads` row via `thread_id`. These helpers resolve that link and\n * compare the thread's owner to the requesting user, so the run routes can\n * reject cross-tenant access (any authenticated user who learns another\n * tenant's runId/threadId must not be able to stream their live agent turn or\n * abort their run).\n */\nimport { getRun } from \"./run-manager.js\";\nimport { getRunById } from \"./run-store.js\";\n\n/**\n * Resolve a run's owning thread id. Checks in-memory run state first (populated\n * synchronously by startRun, so there is no race against the async SQL insert),\n * then falls back to SQL for cross-isolate / post-reload lookups. Returns null\n * when the run is unknown.\n */\nexport async function resolveRunThreadId(\n  runId: string,\n): Promise<string | null> {\n  const memRun = getRun(runId);\n  if (memRun) return memRun.threadId;\n  const row = await getRunById(runId);\n  return row?.threadId ?? null;\n}\n\n/** True when `owner` owns the chat thread `threadId`. */\nexport async function callerOwnsThread(\n  owner: string,\n  threadId: string | null | undefined,\n): Promise<boolean> {\n  if (!threadId) return false;\n  const thread = await getThread(threadId);\n  return !!thread && thread.ownerEmail === owner;\n}\n\n/** True when `owner` owns the thread that run `runId` belongs to. */\nexport async function callerOwnsRun(\n  owner: string,\n  runId: string,\n): Promise<boolean> {\n  return callerOwnsThread(owner, await resolveRunThreadId(runId));\n}\n"]}
+{"version":3,"file":"run-ownership.js","sourceRoot":"","sources":["../../src/agent/run-ownership.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG1E;;;;;;;;;;GAUG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAa;IAEb,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC;IACnC,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;IACpC,OAAO,GAAG,EAAE,QAAQ,IAAI,IAAI,CAAC;AAC/B,CAAC;AAED,yDAAyD;AACzD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAa,EACb,QAAmC;IAEnC,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;IACzC,OAAO,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU,KAAK,KAAK,CAAC;AACjD,CAAC;AAED,uEAAuE;AACvE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAa,EACb,QAAmC,EACnC,IAAI,GAAwB,QAAQ,EACpC,GAAG,GAAqC,EAAE;IAE1C,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,OAAO,CAAC,CAAC,CAAC,MAAM,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,qEAAqE;AACrE,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAa,EACb,KAAa;IAEb,OAAO,gBAAgB,CAAC,KAAK,EAAE,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAa,EACb,KAAa,EACb,IAAI,GAAwB,QAAQ,EACpC,GAAG,GAAqC,EAAE;IAE1C,OAAO,qBAAqB,CAC1B,KAAK,EACL,MAAM,kBAAkB,CAAC,KAAK,CAAC,EAC/B,IAAI,EACJ,GAAG,CACJ,CAAC;AACJ,CAAC","sourcesContent":["import { getThread, resolveThreadAccess } from \"../chat-threads/store.js\";\nimport type { AccessContext } from \"../sharing/access.js\";\nimport type { ShareRole } from \"../sharing/schema.js\";\n/**\n * Ownership checks for the agent run HTTP routes (`/runs/:id/events`,\n * `/runs/:id/abort`, `/runs/active`).\n *\n * `agent_runs` has no owner column — a run's ownership lives on its\n * `chat_threads` row via `thread_id`. These helpers resolve that link and\n * compare the thread's owner to the requesting user, so the run routes can\n * reject cross-tenant access (any authenticated user who learns another\n * tenant's runId/threadId must not be able to stream their live agent turn or\n * abort their run).\n */\nimport { getRun } from \"./run-manager.js\";\nimport { getRunById } from \"./run-store.js\";\n\n/**\n * Resolve a run's owning thread id. Checks in-memory run state first (populated\n * synchronously by startRun, so there is no race against the async SQL insert),\n * then falls back to SQL for cross-isolate / post-reload lookups. Returns null\n * when the run is unknown.\n */\nexport async function resolveRunThreadId(\n  runId: string,\n): Promise<string | null> {\n  const memRun = getRun(runId);\n  if (memRun) return memRun.threadId;\n  const row = await getRunById(runId);\n  return row?.threadId ?? null;\n}\n\n/** True when `owner` owns the chat thread `threadId`. */\nexport async function callerOwnsThread(\n  owner: string,\n  threadId: string | null | undefined,\n): Promise<boolean> {\n  if (!threadId) return false;\n  const thread = await getThread(threadId);\n  return !!thread && thread.ownerEmail === owner;\n}\n\n/** True when `owner` has at least `role` access to the chat thread. */\nexport async function callerHasThreadAccess(\n  owner: string,\n  threadId: string | null | undefined,\n  role: ShareRole | \"owner\" = \"viewer\",\n  ctx: Omit<AccessContext, \"userEmail\"> = {},\n): Promise<boolean> {\n  if (!threadId) return false;\n  return !!(await resolveThreadAccess(owner, threadId, role, ctx));\n}\n\n/** True when `owner` owns the thread that run `runId` belongs to. */\nexport async function callerOwnsRun(\n  owner: string,\n  runId: string,\n): Promise<boolean> {\n  return callerOwnsThread(owner, await resolveRunThreadId(runId));\n}\n\n/** True when `owner` has at least `role` access to the thread behind `runId`. */\nexport async function callerHasRunAccess(\n  owner: string,\n  runId: string,\n  role: ShareRole | \"owner\" = \"viewer\",\n  ctx: Omit<AccessContext, \"userEmail\"> = {},\n): Promise<boolean> {\n  return callerHasThreadAccess(\n    owner,\n    await resolveRunThreadId(runId),\n    role,\n    ctx,\n  );\n}\n"]}

package/dist/changelog/parse.d.ts

@@ -66,5 +66,12 @@ declare const CHANGELOG_HEADER: string;
  * the full updated document. Pure — the CLI handles file IO and deletion.
  */
 export declare function rollupChangelog(existing: string, pending: PendingChangelogEntry[], releaseDate: string): string;
+/**
+ * Render an app-facing changelog that includes both released CHANGELOG.md
+ * sections and adjacent pending `changelog/*.md` entries. Unlike `release`,
+ * this is pure and non-destructive, so build/dev bundles can show current
+ * product notes without deleting the conflict-free pending files.
+ */
+export declare function mergePendingChangelog(existing: string, pending: PendingChangelogEntry[]): string;
 export { CHANGELOG_HEADER, GROUP_LABELS };
 //# sourceMappingURL=parse.d.ts.map

package/dist/changelog/parse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/changelog/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,yEAAyE;AACzE,MAAM,WAAW,qBAAqB;IACpC,+DAA+D;IAC/D,IAAI,EAAE,mBAAmB,CAAC;IAC1B,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,mBAAmB,GAC3B,OAAO,GACP,UAAU,GACV,OAAO,GACP,SAAS,GACT,SAAS,GACT,UAAU,CAAC;AAEf;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,mBAAmB,EAOtD,CAAC;AAEF,QAAA,MAAM,YAAY,EAAE,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAOrD,CAAC;AAIF,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMnD;AAiBD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE,CA+CjE;AAOD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAuBxE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG,MAAM,CAwB1E;AAED,QAAA,MAAM,gBAAgB,QAEgD,CAAC;AAEvE;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,qBAAqB,EAAE,EAChC,WAAW,EAAE,MAAM,GAClB,MAAM,CAgBR;AAED,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/changelog/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,yEAAyE;AACzE,MAAM,WAAW,qBAAqB;IACpC,+DAA+D;IAC/D,IAAI,EAAE,mBAAmB,CAAC;IAC1B,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,mBAAmB,GAC3B,OAAO,GACP,UAAU,GACV,OAAO,GACP,SAAS,GACT,SAAS,GACT,UAAU,CAAC;AAEf;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,mBAAmB,EAOtD,CAAC;AAEF,QAAA,MAAM,YAAY,EAAE,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAOrD,CAAC;AAIF,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMnD;AAiBD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE,CA+CjE;AAOD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAuBxE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG,MAAM,CAwB1E;AAED,QAAA,MAAM,gBAAgB,QAEgD,CAAC;AAEvE;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,qBAAqB,EAAE,EAChC,WAAW,EAAE,MAAM,GAClB,MAAM,CAgBR;AA0BD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,qBAAqB,EAAE,GAC/B,MAAM,CA2CR;AAED,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,CAAC"}

package/dist/changelog/parse.js

@@ -196,5 +196,69 @@ export function rollupChangelog(existing, pending, releaseDate) {
     const rest = doc.slice(firstRelease);
     return `${head}\n\n${section}\n${rest}\n`;
 }
+function changelogHeader(markdown) {
+    const doc = (markdown || CHANGELOG_HEADER).replace(/\s+$/, "");
+    const firstRelease = doc.search(/^##\s+(?!#)/m);
+    const header = (firstRelease === -1 ? doc : doc.slice(0, firstRelease)).replace(/\s+$/, "") || CHANGELOG_HEADER.trim();
+    return header;
+}
+function pendingSectionTitle(entry) {
+    return entry.date?.match(ISO_DATE)?.[1] ?? "Unreleased";
+}
+function pendingSectionSort(a, b) {
+    const aDate = a.match(ISO_DATE)?.[1];
+    const bDate = b.match(ISO_DATE)?.[1];
+    if (aDate && bDate)
+        return bDate.localeCompare(aDate);
+    if (!aDate && bDate)
+        return -1;
+    if (aDate && !bDate)
+        return 1;
+    return a.localeCompare(b);
+}
+/**
+ * Render an app-facing changelog that includes both released CHANGELOG.md
+ * sections and adjacent pending `changelog/*.md` entries. Unlike `release`,
+ * this is pure and non-destructive, so build/dev bundles can show current
+ * product notes without deleting the conflict-free pending files.
+ */
+export function mergePendingChangelog(existing, pending) {
+    const pendingWithText = pending.filter((entry) => entry.text.trim());
+    if (pendingWithText.length === 0)
+        return existing || CHANGELOG_HEADER;
+    const existingEntries = parseChangelog(existing);
+    const usedExistingIndexes = new Set();
+    const pendingByTitle = new Map();
+    for (const entry of pendingWithText) {
+        const title = pendingSectionTitle(entry);
+        pendingByTitle.set(title, [...(pendingByTitle.get(title) ?? []), entry]);
+    }
+    const sections = [];
+    for (const title of [...pendingByTitle.keys()].sort(pendingSectionSort)) {
+        const body = renderReleaseBody(pendingByTitle.get(title) ?? []);
+        if (!body)
+            continue;
+        const existingIndex = existingEntries.findIndex((entry, index) => {
+            if (usedExistingIndexes.has(index))
+                return false;
+            return entry.date === title || entry.title === title;
+        });
+        if (existingIndex === -1) {
+            sections.push(`## ${title}\n\n${body}`);
+            continue;
+        }
+        usedExistingIndexes.add(existingIndex);
+        const existingEntry = existingEntries[existingIndex];
+        sections.push(`## ${existingEntry.title}\n\n${[body, existingEntry.body]
+            .filter(Boolean)
+            .join("\n\n")}`);
+    }
+    existingEntries.forEach((entry, index) => {
+        if (usedExistingIndexes.has(index))
+            return;
+        sections.push(`## ${entry.title}\n\n${entry.body}`);
+    });
+    return `${changelogHeader(existing)}\n\n${sections.join("\n\n")}\n`;
+}
 export { CHANGELOG_HEADER, GROUP_LABELS };
 //# sourceMappingURL=parse.js.map

package/dist/changelog/parse.js.map

@@ -1 +1 @@
-{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/changelog/parse.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared, dependency-free changelog parsing + serialization.\n *\n * Used by BOTH:\n *   - the browser bundle (rendering an app's CHANGELOG.md in the command\n *     menu / settings \"What's new\" surface), and\n *   - the `agent-native changelog` CLI (rolling pending entry files up into\n *     CHANGELOG.md).\n *\n * Keep this file isomorphic: no Node, no browser, no third-party deps. The\n * markdown shape is the conventional \"Keep a Changelog\" layout — a top-level\n * `# Changelog` heading followed by one `## <release>` section per release.\n */\n\n/** A single released section of a CHANGELOG.md file. */\nexport interface ChangelogEntry {\n  /** Stable id derived from the heading — used for \"unseen\" tracking. */\n  id: string;\n  /** Raw heading text, e.g. `2026-06-23` or `v1.2.0 — 2026-06-23`. */\n  title: string;\n  /** ISO date (YYYY-MM-DD) extracted from the heading, if present. */\n  date?: string;\n  /** Version label extracted from the heading, if present. */\n  version?: string;\n  /** Markdown body beneath the heading (until the next `## ` section). */\n  body: string;\n}\n\n/** A not-yet-released entry authored as a `changelog/<file>.md` file. */\nexport interface PendingChangelogEntry {\n  /** Category — `added`, `improved`, `fixed`, `changed`, etc. */\n  type: ChangelogChangeType;\n  /** ISO date the entry was authored (YYYY-MM-DD). */\n  date?: string;\n  /** User-facing description (markdown, single bullet). */\n  text: string;\n}\n\nexport type ChangelogChangeType =\n  | \"added\"\n  | \"improved\"\n  | \"fixed\"\n  | \"changed\"\n  | \"removed\"\n  | \"security\";\n\n/**\n * Order changes are grouped under a release heading. Anything not listed here\n * falls back to the \"changed\" group, then renders in insertion order.\n */\nexport const CHANGELOG_GROUP_ORDER: ChangelogChangeType[] = [\n  \"added\",\n  \"improved\",\n  \"fixed\",\n  \"changed\",\n  \"removed\",\n  \"security\",\n];\n\nconst GROUP_LABELS: Record<ChangelogChangeType, string> = {\n  added: \"Added\",\n  improved: \"Improved\",\n  fixed: \"Fixed\",\n  changed: \"Changed\",\n  removed: \"Removed\",\n  security: \"Security\",\n};\n\nconst ISO_DATE = /(\\d{4}-\\d{2}-\\d{2})/;\n\n/** Lowercase, hyphenate, and strip to a URL/id-safe slug. */\nexport function changelogSlug(value: string): string {\n  return value\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\")\n    .slice(0, 60);\n}\n\nfunction normalizeType(raw: string | undefined): ChangelogChangeType {\n  const value = (raw ?? \"\").trim().toLowerCase();\n  if ((CHANGELOG_GROUP_ORDER as string[]).includes(value)) {\n    return value as ChangelogChangeType;\n  }\n  // Friendly aliases.\n  if (value === \"feature\" || value === \"new\" || value === \"add\") return \"added\";\n  if (value === \"improvement\" || value === \"enhancement\" || value === \"perf\") {\n    return \"improved\";\n  }\n  if (value === \"fix\" || value === \"bugfix\" || value === \"bug\") return \"fixed\";\n  if (value === \"remove\" || value === \"deprecated\") return \"removed\";\n  return \"changed\";\n}\n\n/**\n * Parse a CHANGELOG.md document into structured release entries.\n *\n * Tolerant by design: an empty or malformed file yields an empty list rather\n * than throwing, so a missing/partial changelog never breaks the UI.\n */\nexport function parseChangelog(markdown: string): ChangelogEntry[] {\n  if (!markdown || typeof markdown !== \"string\") return [];\n\n  const lines = markdown.split(/\\r?\\n/);\n  const entries: ChangelogEntry[] = [];\n  const seenIds = new Set<string>();\n\n  let currentTitle: string | null = null;\n  let bodyLines: string[] = [];\n\n  const flush = () => {\n    if (currentTitle === null) return;\n    const title = currentTitle.trim();\n    const date = title.match(ISO_DATE)?.[1];\n    const version = title.match(/v?\\d+\\.\\d+(?:\\.\\d+)?/)?.[0];\n    // Build a stable, unique id from the heading.\n    let base = changelogSlug(title) || \"entry\";\n    let id = base;\n    let n = 2;\n    while (seenIds.has(id)) id = `${base}-${n++}`;\n    seenIds.add(id);\n    entries.push({\n      id,\n      title,\n      date,\n      version: version && version !== date ? version : undefined,\n      body: bodyLines.join(\"\\n\").trim(),\n    });\n    currentTitle = null;\n    bodyLines = [];\n  };\n\n  for (const line of lines) {\n    // `## ` (but not `### `) starts a new release section.\n    const match = /^##\\s+(?!#)(.+?)\\s*$/.exec(line);\n    if (match) {\n      flush();\n      currentTitle = stripBrackets(match[1]);\n      continue;\n    }\n    // Skip the top-level `# Changelog` title and anything before the first `##`.\n    if (currentTitle === null) continue;\n    bodyLines.push(line);\n  }\n  flush();\n\n  return entries;\n}\n\n/** `## [1.2.0]` → `1.2.0`; leaves un-bracketed headings untouched. */\nfunction stripBrackets(title: string): string {\n  return title.replace(/^\\[(.+?)\\]\\s*/, \"$1 \").trim();\n}\n\n/**\n * Parse a pending `changelog/<file>.md` entry: optional `---` frontmatter\n * (`type:` / `date:`) followed by the markdown description body.\n */\nexport function parsePendingEntry(content: string): PendingChangelogEntry {\n  let type: string | undefined;\n  let date: string | undefined;\n  let body = content;\n\n  const fm = /^---\\r?\\n([\\s\\S]*?)\\r?\\n---\\r?\\n?/.exec(content);\n  if (fm) {\n    for (const raw of fm[1].split(/\\r?\\n/)) {\n      const kv = /^([a-zA-Z]+)\\s*:\\s*(.+?)\\s*$/.exec(raw);\n      if (!kv) continue;\n      const key = kv[1].toLowerCase();\n      const value = kv[2].replace(/^[\"']|[\"']$/g, \"\").trim();\n      if (key === \"type\") type = value;\n      else if (key === \"date\") date = value.match(ISO_DATE)?.[1] ?? value;\n    }\n    body = content.slice(fm[0].length);\n  }\n\n  return {\n    type: normalizeType(type),\n    date,\n    text: body.trim(),\n  };\n}\n\n/**\n * Render a set of pending entries as a single dated release section (the body\n * that goes beneath a `## <date>` heading). Groups bullets by type.\n */\nexport function renderReleaseBody(entries: PendingChangelogEntry[]): string {\n  const groups = new Map<ChangelogChangeType, string[]>();\n  for (const entry of entries) {\n    const text = entry.text.trim();\n    if (!text) continue;\n    const bullet = text.includes(\"\\n\")\n      ? // Preserve multi-line bodies, indenting continuation lines.\n        text\n          .split(/\\r?\\n/)\n          .map((l, i) => (i === 0 ? `- ${l}` : `  ${l}`))\n          .join(\"\\n\")\n      : `- ${text}`;\n    const list = groups.get(entry.type) ?? [];\n    list.push(bullet);\n    groups.set(entry.type, list);\n  }\n\n  const sections: string[] = [];\n  for (const type of CHANGELOG_GROUP_ORDER) {\n    const list = groups.get(type);\n    if (!list?.length) continue;\n    sections.push(`### ${GROUP_LABELS[type]}\\n\\n${list.join(\"\\n\")}`);\n  }\n  return sections.join(\"\\n\\n\");\n}\n\nconst CHANGELOG_HEADER =\n  \"# Changelog\\n\\n\" +\n  \"All notable user-facing changes to this app are documented here.\\n\";\n\n/**\n * Roll a batch of pending entries into an existing CHANGELOG.md document,\n * prepending a new `## <date>` section above the most recent release. Returns\n * the full updated document. Pure — the CLI handles file IO and deletion.\n */\nexport function rollupChangelog(\n  existing: string,\n  pending: PendingChangelogEntry[],\n  releaseDate: string,\n): string {\n  const body = renderReleaseBody(pending);\n  if (!body) return existing || `${CHANGELOG_HEADER}`;\n\n  const section = `## ${releaseDate}\\n\\n${body}\\n`;\n\n  const doc = (existing || CHANGELOG_HEADER).replace(/\\s+$/, \"\");\n  // Insert the new section immediately before the first existing `## ` release\n  // so the header/intro stays on top and releases stay newest-first.\n  const firstRelease = doc.search(/^##\\s+(?!#)/m);\n  if (firstRelease === -1) {\n    return `${doc}\\n\\n${section}\\n`;\n  }\n  const head = doc.slice(0, firstRelease).replace(/\\s+$/, \"\");\n  const rest = doc.slice(firstRelease);\n  return `${head}\\n\\n${section}\\n${rest}\\n`;\n}\n\nexport { CHANGELOG_HEADER, GROUP_LABELS };\n"]}
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/changelog/parse.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared, dependency-free changelog parsing + serialization.\n *\n * Used by BOTH:\n *   - the browser bundle (rendering an app's CHANGELOG.md in the command\n *     menu / settings \"What's new\" surface), and\n *   - the `agent-native changelog` CLI (rolling pending entry files up into\n *     CHANGELOG.md).\n *\n * Keep this file isomorphic: no Node, no browser, no third-party deps. The\n * markdown shape is the conventional \"Keep a Changelog\" layout — a top-level\n * `# Changelog` heading followed by one `## <release>` section per release.\n */\n\n/** A single released section of a CHANGELOG.md file. */\nexport interface ChangelogEntry {\n  /** Stable id derived from the heading — used for \"unseen\" tracking. */\n  id: string;\n  /** Raw heading text, e.g. `2026-06-23` or `v1.2.0 — 2026-06-23`. */\n  title: string;\n  /** ISO date (YYYY-MM-DD) extracted from the heading, if present. */\n  date?: string;\n  /** Version label extracted from the heading, if present. */\n  version?: string;\n  /** Markdown body beneath the heading (until the next `## ` section). */\n  body: string;\n}\n\n/** A not-yet-released entry authored as a `changelog/<file>.md` file. */\nexport interface PendingChangelogEntry {\n  /** Category — `added`, `improved`, `fixed`, `changed`, etc. */\n  type: ChangelogChangeType;\n  /** ISO date the entry was authored (YYYY-MM-DD). */\n  date?: string;\n  /** User-facing description (markdown, single bullet). */\n  text: string;\n}\n\nexport type ChangelogChangeType =\n  | \"added\"\n  | \"improved\"\n  | \"fixed\"\n  | \"changed\"\n  | \"removed\"\n  | \"security\";\n\n/**\n * Order changes are grouped under a release heading. Anything not listed here\n * falls back to the \"changed\" group, then renders in insertion order.\n */\nexport const CHANGELOG_GROUP_ORDER: ChangelogChangeType[] = [\n  \"added\",\n  \"improved\",\n  \"fixed\",\n  \"changed\",\n  \"removed\",\n  \"security\",\n];\n\nconst GROUP_LABELS: Record<ChangelogChangeType, string> = {\n  added: \"Added\",\n  improved: \"Improved\",\n  fixed: \"Fixed\",\n  changed: \"Changed\",\n  removed: \"Removed\",\n  security: \"Security\",\n};\n\nconst ISO_DATE = /(\\d{4}-\\d{2}-\\d{2})/;\n\n/** Lowercase, hyphenate, and strip to a URL/id-safe slug. */\nexport function changelogSlug(value: string): string {\n  return value\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\")\n    .slice(0, 60);\n}\n\nfunction normalizeType(raw: string | undefined): ChangelogChangeType {\n  const value = (raw ?? \"\").trim().toLowerCase();\n  if ((CHANGELOG_GROUP_ORDER as string[]).includes(value)) {\n    return value as ChangelogChangeType;\n  }\n  // Friendly aliases.\n  if (value === \"feature\" || value === \"new\" || value === \"add\") return \"added\";\n  if (value === \"improvement\" || value === \"enhancement\" || value === \"perf\") {\n    return \"improved\";\n  }\n  if (value === \"fix\" || value === \"bugfix\" || value === \"bug\") return \"fixed\";\n  if (value === \"remove\" || value === \"deprecated\") return \"removed\";\n  return \"changed\";\n}\n\n/**\n * Parse a CHANGELOG.md document into structured release entries.\n *\n * Tolerant by design: an empty or malformed file yields an empty list rather\n * than throwing, so a missing/partial changelog never breaks the UI.\n */\nexport function parseChangelog(markdown: string): ChangelogEntry[] {\n  if (!markdown || typeof markdown !== \"string\") return [];\n\n  const lines = markdown.split(/\\r?\\n/);\n  const entries: ChangelogEntry[] = [];\n  const seenIds = new Set<string>();\n\n  let currentTitle: string | null = null;\n  let bodyLines: string[] = [];\n\n  const flush = () => {\n    if (currentTitle === null) return;\n    const title = currentTitle.trim();\n    const date = title.match(ISO_DATE)?.[1];\n    const version = title.match(/v?\\d+\\.\\d+(?:\\.\\d+)?/)?.[0];\n    // Build a stable, unique id from the heading.\n    let base = changelogSlug(title) || \"entry\";\n    let id = base;\n    let n = 2;\n    while (seenIds.has(id)) id = `${base}-${n++}`;\n    seenIds.add(id);\n    entries.push({\n      id,\n      title,\n      date,\n      version: version && version !== date ? version : undefined,\n      body: bodyLines.join(\"\\n\").trim(),\n    });\n    currentTitle = null;\n    bodyLines = [];\n  };\n\n  for (const line of lines) {\n    // `## ` (but not `### `) starts a new release section.\n    const match = /^##\\s+(?!#)(.+?)\\s*$/.exec(line);\n    if (match) {\n      flush();\n      currentTitle = stripBrackets(match[1]);\n      continue;\n    }\n    // Skip the top-level `# Changelog` title and anything before the first `##`.\n    if (currentTitle === null) continue;\n    bodyLines.push(line);\n  }\n  flush();\n\n  return entries;\n}\n\n/** `## [1.2.0]` → `1.2.0`; leaves un-bracketed headings untouched. */\nfunction stripBrackets(title: string): string {\n  return title.replace(/^\\[(.+?)\\]\\s*/, \"$1 \").trim();\n}\n\n/**\n * Parse a pending `changelog/<file>.md` entry: optional `---` frontmatter\n * (`type:` / `date:`) followed by the markdown description body.\n */\nexport function parsePendingEntry(content: string): PendingChangelogEntry {\n  let type: string | undefined;\n  let date: string | undefined;\n  let body = content;\n\n  const fm = /^---\\r?\\n([\\s\\S]*?)\\r?\\n---\\r?\\n?/.exec(content);\n  if (fm) {\n    for (const raw of fm[1].split(/\\r?\\n/)) {\n      const kv = /^([a-zA-Z]+)\\s*:\\s*(.+?)\\s*$/.exec(raw);\n      if (!kv) continue;\n      const key = kv[1].toLowerCase();\n      const value = kv[2].replace(/^[\"']|[\"']$/g, \"\").trim();\n      if (key === \"type\") type = value;\n      else if (key === \"date\") date = value.match(ISO_DATE)?.[1] ?? value;\n    }\n    body = content.slice(fm[0].length);\n  }\n\n  return {\n    type: normalizeType(type),\n    date,\n    text: body.trim(),\n  };\n}\n\n/**\n * Render a set of pending entries as a single dated release section (the body\n * that goes beneath a `## <date>` heading). Groups bullets by type.\n */\nexport function renderReleaseBody(entries: PendingChangelogEntry[]): string {\n  const groups = new Map<ChangelogChangeType, string[]>();\n  for (const entry of entries) {\n    const text = entry.text.trim();\n    if (!text) continue;\n    const bullet = text.includes(\"\\n\")\n      ? // Preserve multi-line bodies, indenting continuation lines.\n        text\n          .split(/\\r?\\n/)\n          .map((l, i) => (i === 0 ? `- ${l}` : `  ${l}`))\n          .join(\"\\n\")\n      : `- ${text}`;\n    const list = groups.get(entry.type) ?? [];\n    list.push(bullet);\n    groups.set(entry.type, list);\n  }\n\n  const sections: string[] = [];\n  for (const type of CHANGELOG_GROUP_ORDER) {\n    const list = groups.get(type);\n    if (!list?.length) continue;\n    sections.push(`### ${GROUP_LABELS[type]}\\n\\n${list.join(\"\\n\")}`);\n  }\n  return sections.join(\"\\n\\n\");\n}\n\nconst CHANGELOG_HEADER =\n  \"# Changelog\\n\\n\" +\n  \"All notable user-facing changes to this app are documented here.\\n\";\n\n/**\n * Roll a batch of pending entries into an existing CHANGELOG.md document,\n * prepending a new `## <date>` section above the most recent release. Returns\n * the full updated document. Pure — the CLI handles file IO and deletion.\n */\nexport function rollupChangelog(\n  existing: string,\n  pending: PendingChangelogEntry[],\n  releaseDate: string,\n): string {\n  const body = renderReleaseBody(pending);\n  if (!body) return existing || `${CHANGELOG_HEADER}`;\n\n  const section = `## ${releaseDate}\\n\\n${body}\\n`;\n\n  const doc = (existing || CHANGELOG_HEADER).replace(/\\s+$/, \"\");\n  // Insert the new section immediately before the first existing `## ` release\n  // so the header/intro stays on top and releases stay newest-first.\n  const firstRelease = doc.search(/^##\\s+(?!#)/m);\n  if (firstRelease === -1) {\n    return `${doc}\\n\\n${section}\\n`;\n  }\n  const head = doc.slice(0, firstRelease).replace(/\\s+$/, \"\");\n  const rest = doc.slice(firstRelease);\n  return `${head}\\n\\n${section}\\n${rest}\\n`;\n}\n\nfunction changelogHeader(markdown: string): string {\n  const doc = (markdown || CHANGELOG_HEADER).replace(/\\s+$/, \"\");\n  const firstRelease = doc.search(/^##\\s+(?!#)/m);\n  const header =\n    (firstRelease === -1 ? doc : doc.slice(0, firstRelease)).replace(\n      /\\s+$/,\n      \"\",\n    ) || CHANGELOG_HEADER.trim();\n  return header;\n}\n\nfunction pendingSectionTitle(entry: PendingChangelogEntry): string {\n  return entry.date?.match(ISO_DATE)?.[1] ?? \"Unreleased\";\n}\n\nfunction pendingSectionSort(a: string, b: string): number {\n  const aDate = a.match(ISO_DATE)?.[1];\n  const bDate = b.match(ISO_DATE)?.[1];\n  if (aDate && bDate) return bDate.localeCompare(aDate);\n  if (!aDate && bDate) return -1;\n  if (aDate && !bDate) return 1;\n  return a.localeCompare(b);\n}\n\n/**\n * Render an app-facing changelog that includes both released CHANGELOG.md\n * sections and adjacent pending `changelog/*.md` entries. Unlike `release`,\n * this is pure and non-destructive, so build/dev bundles can show current\n * product notes without deleting the conflict-free pending files.\n */\nexport function mergePendingChangelog(\n  existing: string,\n  pending: PendingChangelogEntry[],\n): string {\n  const pendingWithText = pending.filter((entry) => entry.text.trim());\n  if (pendingWithText.length === 0) return existing || CHANGELOG_HEADER;\n\n  const existingEntries = parseChangelog(existing);\n  const usedExistingIndexes = new Set<number>();\n  const pendingByTitle = new Map<string, PendingChangelogEntry[]>();\n\n  for (const entry of pendingWithText) {\n    const title = pendingSectionTitle(entry);\n    pendingByTitle.set(title, [...(pendingByTitle.get(title) ?? []), entry]);\n  }\n\n  const sections: string[] = [];\n  for (const title of [...pendingByTitle.keys()].sort(pendingSectionSort)) {\n    const body = renderReleaseBody(pendingByTitle.get(title) ?? []);\n    if (!body) continue;\n\n    const existingIndex = existingEntries.findIndex((entry, index) => {\n      if (usedExistingIndexes.has(index)) return false;\n      return entry.date === title || entry.title === title;\n    });\n\n    if (existingIndex === -1) {\n      sections.push(`## ${title}\\n\\n${body}`);\n      continue;\n    }\n\n    usedExistingIndexes.add(existingIndex);\n    const existingEntry = existingEntries[existingIndex];\n    sections.push(\n      `## ${existingEntry.title}\\n\\n${[body, existingEntry.body]\n        .filter(Boolean)\n        .join(\"\\n\\n\")}`,\n    );\n  }\n\n  existingEntries.forEach((entry, index) => {\n    if (usedExistingIndexes.has(index)) return;\n    sections.push(`## ${entry.title}\\n\\n${entry.body}`);\n  });\n\n  return `${changelogHeader(existing)}\\n\\n${sections.join(\"\\n\\n\")}\\n`;\n}\n\nexport { CHANGELOG_HEADER, GROUP_LABELS };\n"]}