@agent-native/core 0.69.0 → 0.70.1

package/dist/agent/run-loop-with-resume.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-loop-with-resume.js","sourceRoot":"","sources":["../../src/agent/run-loop-with-resume.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Wraps `runAgentLoop` with two layered recovery mechanisms so a single hosted\n * invocation can survive interruptions without showing the user a dead chat:\n *\n * 1. **Soft timeout** — an inner timer that aborts the LLM call before the\n *    hosting function's hard limit (Lambda 75s, Vercel 60s, etc.) so we have a\n *    chance to gracefully wind down and append a continuation nudge. Without\n *    this the function gets killed mid-stream and the user sees a frozen\n *    spinner.\n *\n * 2. **Resumable-error continuation** — when the LLM call errors with a\n *    transport- or gateway-level interruption (Builder gateway 45s timeout,\n *    socket hang up, ECONNRESET, upstream 5xx that survived engine retries),\n *    we save the conversation prefix, append a \"continue from where you left\n *    off\" message, and run another LLM call. Anthropic's prompt cache makes\n *    the resume call dramatically faster than the cold first attempt, and the\n *    agent gets explicit context that it was cut off so it doesn't re-do\n *    completed work.\n *\n * Both paths route through `appendAgentLoopContinuation` so the agent sees a\n * uniform \"continue\" instruction regardless of which recovery fired.\n */\n\nimport {\n  runAgentLoop,\n  appendAgentLoopContinuation,\n  isResumableEngineError,\n  continuationReasonForResumableError,\n} from \"./production-agent.js\";\nimport { resolveRunSoftTimeoutMs } from \"./run-manager.js\";\nimport { getCurrentTurnEventsForThread } from \"./run-store.js\";\nimport {\n  classifyToolCallJournal,\n  buildResumeJournalNote,\n} from \"./tool-call-journal.js\";\nimport type { EngineMessage } from \"./engine/types.js\";\n\n/**\n * Derive the per-turn tool-call journal from the durable run-event ledger and,\n * when there is anything to report, append a STRUCTURED note to the message\n * prefix so the resumed model:\n *   - does NOT re-execute tool calls that already completed (avoiding duplicate\n *     side effects like re-sending an email or re-creating a ticket), and\n *   - is explicitly told about any tool call that started but whose outcome was\n *     never recorded (\"interrupted, unknown outcome\") so it can decide.\n *\n * This is additive to the existing \"continue from where you left off\" nudge —\n * it is appended right after it. When the journal is empty (no completed or\n * interrupted tool calls — e.g. a turn with no tool activity, or a clean\n * continuation), nothing extra is appended and resume behavior is byte-for-byte\n * what it was before. Best-effort: any ledger read/parse failure is swallowed so\n * a journal hiccup can never block a recovery that would otherwise succeed.\n *\n * This prompt-level journal is paired with tool-layer enforcement in\n * production-agent.ts/runToolCall, which refuses to re-execute a journaled-\n * complete write tool (returning the journaled result instead). See\n * `tool-call-journal.ts` (`findCompletedJournalEntry`) for the keying used.\n */\nasync function appendToolCallJournalNote(\n  messages: EngineMessage[],\n  threadId: string | undefined,\n): Promise<void> {\n  if (!threadId) return;\n  try {\n    const events = await getCurrentTurnEventsForThread(threadId);\n    if (events.length === 0) return;\n    const journal = classifyToolCallJournal(events);\n    const note = buildResumeJournalNote(journal);\n    if (!note) return;\n    messages.push({\n      role: \"user\",\n      content: [{ type: \"text\", text: note }],\n    });\n  } catch {\n    // The journal is a hardening layer, never a gate. A failed ledger read or\n    // parse must not break the resume that the continuation nudge already set\n    // up — the model still continues, just without the structured journal.\n  }\n}\n\n/**\n * Cap on continuation iterations inside a single\n * `runAgentLoopDirectWithSoftTimeout` invocation. The host's hard function\n * timeout usually bounds this naturally — but a defensive cap prevents an\n * instant-error spiral from looping forever inside hosting environments with a\n * generous budget.\n *\n * 6 leaves room for: 1 normal completion + a few resume rounds for design\n * generation (prompt + 3 variants ≈ 4 LLM calls), with a small safety margin.\n */\nexport const MAX_RUN_LOOP_CONTINUATIONS = 6;\n\n/**\n * Internal entry point used by the agent-chat plugin's run handler. Wraps\n * `runAgentLoop` with soft-timeout + resumable-error continuation recovery.\n *\n * The `softTimeoutMs` argument falls back to `resolveRunSoftTimeoutMs(...)` so\n * different hosting environments (Lambda, Vercel, Cloudflare, local dev) get\n * an appropriate inner budget. Setting it to <= 0 disables both layers — the\n * call goes straight to `runAgentLoop` with no wrapping.\n */\nexport async function runAgentLoopDirectWithSoftTimeout(\n  opts: Parameters<typeof runAgentLoop>[0],\n  softTimeoutMs?: number,\n): Promise<Awaited<ReturnType<typeof runAgentLoop>>> {\n  const timeoutMs = resolveRunSoftTimeoutMs(softTimeoutMs);\n  if (timeoutMs <= 0) return runAgentLoop(opts);\n\n  const upstreamSignal = opts.signal;\n  const usage: Awaited<ReturnType<typeof runAgentLoop>> = {\n    inputTokens: 0,\n    outputTokens: 0,\n    cacheReadTokens: 0,\n    cacheWriteTokens: 0,\n    model: opts.model,\n  };\n\n  const addUsage = (next: Awaited<ReturnType<typeof runAgentLoop>>) => {\n    usage.inputTokens += next.inputTokens;\n    usage.outputTokens += next.outputTokens;\n    usage.cacheReadTokens += next.cacheReadTokens;\n    usage.cacheWriteTokens += next.cacheWriteTokens;\n    usage.model = next.model;\n  };\n\n  let attempts = 0;\n  while (!upstreamSignal.aborted && attempts < MAX_RUN_LOOP_CONTINUATIONS) {\n    attempts++;\n    const controller = new AbortController();\n    const abortFromUpstream = () => controller.abort();\n    if (upstreamSignal.aborted) {\n      controller.abort();\n    } else {\n      upstreamSignal.addEventListener(\"abort\", abortFromUpstream, {\n        once: true,\n      });\n    }\n\n    let softTimedOut = false;\n    const timer = setTimeout(() => {\n      if (controller.signal.aborted) return;\n      softTimedOut = true;\n      controller.abort();\n    }, timeoutMs);\n\n    try {\n      const nextUsage = await runAgentLoop({\n        ...opts,\n        signal: controller.signal,\n      });\n      addUsage(nextUsage);\n      if (softTimedOut && !upstreamSignal.aborted) {\n        appendAgentLoopContinuation(opts.messages, \"run_timeout\");\n        await appendToolCallJournalNote(opts.messages, opts.threadId);\n        continue;\n      }\n      return usage;\n    } catch (err) {\n      if (softTimedOut && !upstreamSignal.aborted) {\n        // Clear partial text the client received before the abort so the\n        // resumed model doesn't re-emit it and produce duplicated output.\n        opts.send({ type: \"clear\" });\n        appendAgentLoopContinuation(opts.messages, \"run_timeout\");\n        await appendToolCallJournalNote(opts.messages, opts.threadId);\n        continue;\n      }\n      // Resumable transport / gateway interruptions: the LLM call was cut off\n      // mid-stream (gateway 45s timeout, socket hang up, function-level\n      // timeout that didn't trip our soft timer first). Treat it the same way\n      // as a soft timeout — append a \"continue from where you left off\" nudge\n      // and let the loop run another LLM call. The conversation prefix up to\n      // the cut-off is preserved in opts.messages, and Anthropic's prompt\n      // cache makes the resume call much faster.\n      //\n      // Emit 'clear' so any partial streamed text is discarded on the client\n      // before the model resumes. Without this the model restarts its sentence\n      // from scratch and the fold produces duplicated text in one message\n      // (the partial text was already sent to the client but never entered\n      // the in-memory messages array, so the next attempt re-emits it).\n      if (!upstreamSignal.aborted && isResumableEngineError(err)) {\n        opts.send({ type: \"clear\" });\n        appendAgentLoopContinuation(\n          opts.messages,\n          continuationReasonForResumableError(err),\n        );\n        await appendToolCallJournalNote(opts.messages, opts.threadId);\n        continue;\n      }\n      throw err;\n    } finally {\n      clearTimeout(timer);\n      upstreamSignal.removeEventListener(\"abort\", abortFromUpstream);\n    }\n  }\n\n  return usage;\n}\n"]}
+{"version":3,"file":"run-loop-with-resume.js","sourceRoot":"","sources":["../../src/agent/run-loop-with-resume.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Wraps `runAgentLoop` with two layered recovery mechanisms so a single hosted\n * invocation can survive interruptions without showing the user a dead chat:\n *\n * 1. **Soft timeout** — an inner timer that aborts the LLM call before the\n *    hosting function's hard limit (Lambda 75s, Vercel 60s, etc.) so we have a\n *    chance to gracefully wind down and append a continuation nudge. Without\n *    this the function gets killed mid-stream and the user sees a frozen\n *    spinner.\n *\n * 2. **Resumable-error continuation** — when the LLM call errors with a\n *    transport- or gateway-level interruption (Builder gateway 45s timeout,\n *    socket hang up, ECONNRESET, upstream 5xx that survived engine retries),\n *    we save the conversation prefix, append a \"continue from where you left\n *    off\" message, and run another LLM call. Anthropic's prompt cache makes\n *    the resume call dramatically faster than the cold first attempt, and the\n *    agent gets explicit context that it was cut off so it doesn't re-do\n *    completed work.\n *\n * Both paths route through `appendAgentLoopContinuation` so the agent sees a\n * uniform \"continue\" instruction regardless of which recovery fired.\n */\n\nimport {\n  runAgentLoop,\n  appendAgentLoopContinuation,\n  isResumableEngineError,\n  continuationReasonForResumableError,\n} from \"./production-agent.js\";\nimport { resolveRunSoftTimeoutMs } from \"./run-manager.js\";\nimport { getCurrentTurnEventsForThread } from \"./run-store.js\";\nimport {\n  classifyToolCallJournal,\n  buildResumeJournalNote,\n} from \"./tool-call-journal.js\";\nimport type { EngineMessage } from \"./engine/types.js\";\n\n/**\n * Derive the per-turn tool-call journal from the durable run-event ledger and,\n * when there is anything to report, append a STRUCTURED note to the message\n * prefix so the resumed model:\n *   - does NOT re-execute tool calls that already completed (avoiding duplicate\n *     side effects like re-sending an email or re-creating a ticket), and\n *   - is explicitly told about any tool call that started but whose outcome was\n *     never recorded (\"interrupted, unknown outcome\") so it can decide.\n *\n * This is additive to the existing \"continue from where you left off\" nudge —\n * it is appended right after it. When the journal is empty (no completed or\n * interrupted tool calls — e.g. a turn with no tool activity, or a clean\n * continuation), nothing extra is appended and resume behavior is byte-for-byte\n * what it was before. Best-effort: any ledger read/parse failure is swallowed so\n * a journal hiccup can never block a recovery that would otherwise succeed.\n *\n * This prompt-level journal is paired with tool-layer enforcement in\n * production-agent.ts/runToolCall, which refuses to re-execute a journaled-\n * complete write tool (returning the journaled result instead). See\n * `tool-call-journal.ts` (`findCompletedJournalEntry`) for the keying used.\n */\nasync function appendToolCallJournalNote(\n  messages: EngineMessage[],\n  threadId: string | undefined,\n): Promise<void> {\n  if (!threadId) return;\n  try {\n    const events = await getCurrentTurnEventsForThread(threadId);\n    if (events.length === 0) return;\n    const journal = classifyToolCallJournal(events);\n    const note = buildResumeJournalNote(journal);\n    if (!note) return;\n    messages.push({\n      role: \"user\",\n      content: [{ type: \"text\", text: note }],\n    });\n  } catch {\n    // The journal is a hardening layer, never a gate. A failed ledger read or\n    // parse must not break the resume that the continuation nudge already set\n    // up — the model still continues, just without the structured journal.\n  }\n}\n\n/**\n * Cap on continuation iterations inside a single\n * `runAgentLoopDirectWithSoftTimeout` invocation. The host's hard function\n * timeout usually bounds this naturally — but a defensive cap prevents an\n * instant-error spiral from looping forever inside hosting environments with a\n * generous budget.\n *\n * 6 leaves room for: 1 normal completion + a few resume rounds for design\n * generation (prompt + 3 variants ≈ 4 LLM calls), with a small safety margin.\n */\nexport const MAX_RUN_LOOP_CONTINUATIONS = 6;\n\n/** Machine-readable code carried on the give-up terminal `error` event so the\n * client renders a loud \"stopped before finishing\" terminal instead of an\n * ambiguous silent stall. Deliberately NOT in the client's auto-recoverable\n * allow-list (`isAutoRecoverableError`) so it terminates the chain rather than\n * looping another POST that would hit the same wall. */\nexport const RUN_BUDGET_EXHAUSTED_ERROR_CODE = \"run_budget_exhausted\";\n\n/** User-facing terminal message when a hosted run is cut off mid-step and\n * exhausts its in-invocation continuation budget without finishing. Generic and\n * framework-level (not app-specific). Mirrors the `reliable-mutations` skill's\n * \"fail loud, retry as a single bulk action\" guidance so the user understands\n * the turn stopped before finishing and was not partially saved by the run\n * itself. */\nexport const RUN_BUDGET_EXHAUSTED_MESSAGE =\n  \"I ran out of time before finishing this step (hosted runs have a ~40s budget). \" +\n  \"I stopped rather than leave things half-done — nothing was partially saved by me here. \" +\n  \"Please retry, ideally as a single bulk action.\";\n\n/**\n * Internal entry point used by the agent-chat plugin's run handler. Wraps\n * `runAgentLoop` with soft-timeout + resumable-error continuation recovery.\n *\n * The `softTimeoutMs` argument falls back to `resolveRunSoftTimeoutMs(...)` so\n * different hosting environments (Lambda, Vercel, Cloudflare, local dev) get\n * an appropriate inner budget. Setting it to <= 0 disables both layers — the\n * call goes straight to `runAgentLoop` with no wrapping.\n */\nexport async function runAgentLoopDirectWithSoftTimeout(\n  opts: Parameters<typeof runAgentLoop>[0],\n  softTimeoutMs?: number,\n): Promise<Awaited<ReturnType<typeof runAgentLoop>>> {\n  const timeoutMs = resolveRunSoftTimeoutMs(softTimeoutMs);\n  if (timeoutMs <= 0) return runAgentLoop(opts);\n\n  const upstreamSignal = opts.signal;\n  const usage: Awaited<ReturnType<typeof runAgentLoop>> = {\n    inputTokens: 0,\n    outputTokens: 0,\n    cacheReadTokens: 0,\n    cacheWriteTokens: 0,\n    model: opts.model,\n  };\n\n  const addUsage = (next: Awaited<ReturnType<typeof runAgentLoop>>) => {\n    usage.inputTokens += next.inputTokens;\n    usage.outputTokens += next.outputTokens;\n    usage.cacheReadTokens += next.cacheReadTokens;\n    usage.cacheWriteTokens += next.cacheWriteTokens;\n    usage.model = next.model;\n  };\n\n  let attempts = 0;\n  // Tracks whether the most recent attempt ended by scheduling another\n  // continuation (soft-timeout or resumable error → `continue`) rather than\n  // returning a finished turn. When the loop then exits because the budget is\n  // exhausted (NOT because the user aborted and NOT because the turn finished),\n  // this is the silent give-up case: emit a loud terminal so the user sees an\n  // unambiguous \"stopped before finishing\" instead of a bare done/\"…\".\n  let lastAttemptWasUnfinishedContinuation = false;\n  while (!upstreamSignal.aborted && attempts < MAX_RUN_LOOP_CONTINUATIONS) {\n    attempts++;\n    lastAttemptWasUnfinishedContinuation = false;\n    const controller = new AbortController();\n    const abortFromUpstream = () => controller.abort();\n    if (upstreamSignal.aborted) {\n      controller.abort();\n    } else {\n      upstreamSignal.addEventListener(\"abort\", abortFromUpstream, {\n        once: true,\n      });\n    }\n\n    let softTimedOut = false;\n    const timer = setTimeout(() => {\n      if (controller.signal.aborted) return;\n      softTimedOut = true;\n      controller.abort();\n    }, timeoutMs);\n\n    try {\n      const nextUsage = await runAgentLoop({\n        ...opts,\n        signal: controller.signal,\n      });\n      addUsage(nextUsage);\n      if (softTimedOut && !upstreamSignal.aborted) {\n        lastAttemptWasUnfinishedContinuation = true;\n        appendAgentLoopContinuation(opts.messages, \"run_timeout\");\n        await appendToolCallJournalNote(opts.messages, opts.threadId);\n        continue;\n      }\n      return usage;\n    } catch (err) {\n      if (softTimedOut && !upstreamSignal.aborted) {\n        // Clear partial text the client received before the abort so the\n        // resumed model doesn't re-emit it and produce duplicated output.\n        lastAttemptWasUnfinishedContinuation = true;\n        opts.send({ type: \"clear\" });\n        appendAgentLoopContinuation(opts.messages, \"run_timeout\");\n        await appendToolCallJournalNote(opts.messages, opts.threadId);\n        continue;\n      }\n      // Resumable transport / gateway interruptions: the LLM call was cut off\n      // mid-stream (gateway 45s timeout, socket hang up, function-level\n      // timeout that didn't trip our soft timer first). Treat it the same way\n      // as a soft timeout — append a \"continue from where you left off\" nudge\n      // and let the loop run another LLM call. The conversation prefix up to\n      // the cut-off is preserved in opts.messages, and Anthropic's prompt\n      // cache makes the resume call much faster.\n      //\n      // Emit 'clear' so any partial streamed text is discarded on the client\n      // before the model resumes. Without this the model restarts its sentence\n      // from scratch and the fold produces duplicated text in one message\n      // (the partial text was already sent to the client but never entered\n      // the in-memory messages array, so the next attempt re-emits it).\n      if (!upstreamSignal.aborted && isResumableEngineError(err)) {\n        lastAttemptWasUnfinishedContinuation = true;\n        opts.send({ type: \"clear\" });\n        appendAgentLoopContinuation(\n          opts.messages,\n          continuationReasonForResumableError(err),\n        );\n        await appendToolCallJournalNote(opts.messages, opts.threadId);\n        continue;\n      }\n      throw err;\n    } finally {\n      clearTimeout(timer);\n      upstreamSignal.removeEventListener(\"abort\", abortFromUpstream);\n    }\n  }\n\n  // The loop exited without a clean return. If the user aborted, that's a Stop —\n  // stay silent. Otherwise we only get here by exhausting\n  // MAX_RUN_LOOP_CONTINUATIONS while the last attempt was still trying to\n  // continue (soft-timeout / resumable error). That is the genuinely-silent\n  // give-up the run-manager would otherwise report as a clean `done`: emit a\n  // loud, non-auto-continuing terminal so the user knows the turn stopped\n  // before finishing and nothing was partially saved by the run itself.\n  if (!upstreamSignal.aborted && lastAttemptWasUnfinishedContinuation) {\n    // Discard any partial text already streamed for the unfinished attempt so\n    // the terminal message stands alone instead of trailing a half sentence.\n    opts.send({ type: \"clear\" });\n    opts.send({\n      type: \"error\",\n      error: RUN_BUDGET_EXHAUSTED_MESSAGE,\n      errorCode: RUN_BUDGET_EXHAUSTED_ERROR_CODE,\n      recoverable: true,\n    });\n  }\n\n  return usage;\n}\n"]}

package/dist/changelog/parse.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Shared, dependency-free changelog parsing + serialization.
+ *
+ * Used by BOTH:
+ *   - the browser bundle (rendering an app's CHANGELOG.md in the command
+ *     menu / settings "What's new" surface), and
+ *   - the `agent-native changelog` CLI (rolling pending entry files up into
+ *     CHANGELOG.md).
+ *
+ * Keep this file isomorphic: no Node, no browser, no third-party deps. The
+ * markdown shape is the conventional "Keep a Changelog" layout — a top-level
+ * `# Changelog` heading followed by one `## <release>` section per release.
+ */
+/** A single released section of a CHANGELOG.md file. */
+export interface ChangelogEntry {
+    /** Stable id derived from the heading — used for "unseen" tracking. */
+    id: string;
+    /** Raw heading text, e.g. `2026-06-23` or `v1.2.0 — 2026-06-23`. */
+    title: string;
+    /** ISO date (YYYY-MM-DD) extracted from the heading, if present. */
+    date?: string;
+    /** Version label extracted from the heading, if present. */
+    version?: string;
+    /** Markdown body beneath the heading (until the next `## ` section). */
+    body: string;
+}
+/** A not-yet-released entry authored as a `changelog/<file>.md` file. */
+export interface PendingChangelogEntry {
+    /** Category — `added`, `improved`, `fixed`, `changed`, etc. */
+    type: ChangelogChangeType;
+    /** ISO date the entry was authored (YYYY-MM-DD). */
+    date?: string;
+    /** User-facing description (markdown, single bullet). */
+    text: string;
+}
+export type ChangelogChangeType = "added" | "improved" | "fixed" | "changed" | "removed" | "security";
+/**
+ * Order changes are grouped under a release heading. Anything not listed here
+ * falls back to the "changed" group, then renders in insertion order.
+ */
+export declare const CHANGELOG_GROUP_ORDER: ChangelogChangeType[];
+declare const GROUP_LABELS: Record<ChangelogChangeType, string>;
+/** Lowercase, hyphenate, and strip to a URL/id-safe slug. */
+export declare function changelogSlug(value: string): string;
+/**
+ * Parse a CHANGELOG.md document into structured release entries.
+ *
+ * Tolerant by design: an empty or malformed file yields an empty list rather
+ * than throwing, so a missing/partial changelog never breaks the UI.
+ */
+export declare function parseChangelog(markdown: string): ChangelogEntry[];
+/**
+ * Parse a pending `changelog/<file>.md` entry: optional `---` frontmatter
+ * (`type:` / `date:`) followed by the markdown description body.
+ */
+export declare function parsePendingEntry(content: string): PendingChangelogEntry;
+/**
+ * Render a set of pending entries as a single dated release section (the body
+ * that goes beneath a `## <date>` heading). Groups bullets by type.
+ */
+export declare function renderReleaseBody(entries: PendingChangelogEntry[]): string;
+declare const CHANGELOG_HEADER: string;
+/**
+ * Roll a batch of pending entries into an existing CHANGELOG.md document,
+ * prepending a new `## <date>` section above the most recent release. Returns
+ * the full updated document. Pure — the CLI handles file IO and deletion.
+ */
+export declare function rollupChangelog(existing: string, pending: PendingChangelogEntry[], releaseDate: string): string;
+export { CHANGELOG_HEADER, GROUP_LABELS };
+//# sourceMappingURL=parse.d.ts.map

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

@@ -0,0 +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"}

package/dist/changelog/parse.js

@@ -0,0 +1,200 @@
+/**
+ * Shared, dependency-free changelog parsing + serialization.
+ *
+ * Used by BOTH:
+ *   - the browser bundle (rendering an app's CHANGELOG.md in the command
+ *     menu / settings "What's new" surface), and
+ *   - the `agent-native changelog` CLI (rolling pending entry files up into
+ *     CHANGELOG.md).
+ *
+ * Keep this file isomorphic: no Node, no browser, no third-party deps. The
+ * markdown shape is the conventional "Keep a Changelog" layout — a top-level
+ * `# Changelog` heading followed by one `## <release>` section per release.
+ */
+/**
+ * Order changes are grouped under a release heading. Anything not listed here
+ * falls back to the "changed" group, then renders in insertion order.
+ */
+export const CHANGELOG_GROUP_ORDER = [
+    "added",
+    "improved",
+    "fixed",
+    "changed",
+    "removed",
+    "security",
+];
+const GROUP_LABELS = {
+    added: "Added",
+    improved: "Improved",
+    fixed: "Fixed",
+    changed: "Changed",
+    removed: "Removed",
+    security: "Security",
+};
+const ISO_DATE = /(\d{4}-\d{2}-\d{2})/;
+/** Lowercase, hyphenate, and strip to a URL/id-safe slug. */
+export function changelogSlug(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 60);
+}
+function normalizeType(raw) {
+    const value = (raw ?? "").trim().toLowerCase();
+    if (CHANGELOG_GROUP_ORDER.includes(value)) {
+        return value;
+    }
+    // Friendly aliases.
+    if (value === "feature" || value === "new" || value === "add")
+        return "added";
+    if (value === "improvement" || value === "enhancement" || value === "perf") {
+        return "improved";
+    }
+    if (value === "fix" || value === "bugfix" || value === "bug")
+        return "fixed";
+    if (value === "remove" || value === "deprecated")
+        return "removed";
+    return "changed";
+}
+/**
+ * Parse a CHANGELOG.md document into structured release entries.
+ *
+ * Tolerant by design: an empty or malformed file yields an empty list rather
+ * than throwing, so a missing/partial changelog never breaks the UI.
+ */
+export function parseChangelog(markdown) {
+    if (!markdown || typeof markdown !== "string")
+        return [];
+    const lines = markdown.split(/\r?\n/);
+    const entries = [];
+    const seenIds = new Set();
+    let currentTitle = null;
+    let bodyLines = [];
+    const flush = () => {
+        if (currentTitle === null)
+            return;
+        const title = currentTitle.trim();
+        const date = title.match(ISO_DATE)?.[1];
+        const version = title.match(/v?\d+\.\d+(?:\.\d+)?/)?.[0];
+        // Build a stable, unique id from the heading.
+        let base = changelogSlug(title) || "entry";
+        let id = base;
+        let n = 2;
+        while (seenIds.has(id))
+            id = `${base}-${n++}`;
+        seenIds.add(id);
+        entries.push({
+            id,
+            title,
+            date,
+            version: version && version !== date ? version : undefined,
+            body: bodyLines.join("\n").trim(),
+        });
+        currentTitle = null;
+        bodyLines = [];
+    };
+    for (const line of lines) {
+        // `## ` (but not `### `) starts a new release section.
+        const match = /^##\s+(?!#)(.+?)\s*$/.exec(line);
+        if (match) {
+            flush();
+            currentTitle = stripBrackets(match[1]);
+            continue;
+        }
+        // Skip the top-level `# Changelog` title and anything before the first `##`.
+        if (currentTitle === null)
+            continue;
+        bodyLines.push(line);
+    }
+    flush();
+    return entries;
+}
+/** `## [1.2.0]` → `1.2.0`; leaves un-bracketed headings untouched. */
+function stripBrackets(title) {
+    return title.replace(/^\[(.+?)\]\s*/, "$1 ").trim();
+}
+/**
+ * Parse a pending `changelog/<file>.md` entry: optional `---` frontmatter
+ * (`type:` / `date:`) followed by the markdown description body.
+ */
+export function parsePendingEntry(content) {
+    let type;
+    let date;
+    let body = content;
+    const fm = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/.exec(content);
+    if (fm) {
+        for (const raw of fm[1].split(/\r?\n/)) {
+            const kv = /^([a-zA-Z]+)\s*:\s*(.+?)\s*$/.exec(raw);
+            if (!kv)
+                continue;
+            const key = kv[1].toLowerCase();
+            const value = kv[2].replace(/^["']|["']$/g, "").trim();
+            if (key === "type")
+                type = value;
+            else if (key === "date")
+                date = value.match(ISO_DATE)?.[1] ?? value;
+        }
+        body = content.slice(fm[0].length);
+    }
+    return {
+        type: normalizeType(type),
+        date,
+        text: body.trim(),
+    };
+}
+/**
+ * Render a set of pending entries as a single dated release section (the body
+ * that goes beneath a `## <date>` heading). Groups bullets by type.
+ */
+export function renderReleaseBody(entries) {
+    const groups = new Map();
+    for (const entry of entries) {
+        const text = entry.text.trim();
+        if (!text)
+            continue;
+        const bullet = text.includes("\n")
+            ? // Preserve multi-line bodies, indenting continuation lines.
+                text
+                    .split(/\r?\n/)
+                    .map((l, i) => (i === 0 ? `- ${l}` : `  ${l}`))
+                    .join("\n")
+            : `- ${text}`;
+        const list = groups.get(entry.type) ?? [];
+        list.push(bullet);
+        groups.set(entry.type, list);
+    }
+    const sections = [];
+    for (const type of CHANGELOG_GROUP_ORDER) {
+        const list = groups.get(type);
+        if (!list?.length)
+            continue;
+        sections.push(`### ${GROUP_LABELS[type]}\n\n${list.join("\n")}`);
+    }
+    return sections.join("\n\n");
+}
+const CHANGELOG_HEADER = "# Changelog\n\n" +
+    "All notable user-facing changes to this app are documented here.\n";
+/**
+ * Roll a batch of pending entries into an existing CHANGELOG.md document,
+ * prepending a new `## <date>` section above the most recent release. Returns
+ * the full updated document. Pure — the CLI handles file IO and deletion.
+ */
+export function rollupChangelog(existing, pending, releaseDate) {
+    const body = renderReleaseBody(pending);
+    if (!body)
+        return existing || `${CHANGELOG_HEADER}`;
+    const section = `## ${releaseDate}\n\n${body}\n`;
+    const doc = (existing || CHANGELOG_HEADER).replace(/\s+$/, "");
+    // Insert the new section immediately before the first existing `## ` release
+    // so the header/intro stays on top and releases stay newest-first.
+    const firstRelease = doc.search(/^##\s+(?!#)/m);
+    if (firstRelease === -1) {
+        return `${doc}\n\n${section}\n`;
+    }
+    const head = doc.slice(0, firstRelease).replace(/\s+$/, "");
+    const rest = doc.slice(firstRelease);
+    return `${head}\n\n${section}\n${rest}\n`;
+}
+export { CHANGELOG_HEADER, GROUP_LABELS };
+//# sourceMappingURL=parse.js.map

package/dist/changelog/parse.js.map

@@ -0,0 +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"]}

package/dist/cli/changelog.d.ts

@@ -0,0 +1,4 @@
+import { CHANGELOG_HEADER } from "../changelog/parse.js";
+export declare function runChangelog(args: string[]): Promise<number>;
+export { CHANGELOG_HEADER };
+//# sourceMappingURL=changelog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.d.ts","sourceRoot":"","sources":["../../src/cli/changelog.ts"],"names":[],"mappings":"AAiBA,OAAO,EAKL,gBAAgB,EAEjB,MAAM,uBAAuB,CAAC;AAsJ/B,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBlE;AAGD,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/cli/changelog.js

@@ -0,0 +1,166 @@
+/**
+ * `agent-native changelog` — author and roll up an app's user-facing changelog.
+ *
+ * The model mirrors changesets: instead of editing the shared CHANGELOG.md
+ * directly (which conflicts when many agents work in parallel), each change
+ * drops a small pending entry file under `changelog/`. A later `release` rolls
+ * every pending file up into a single dated section of CHANGELOG.md.
+ *
+ *   agent-native changelog add "Recordings can be trimmed before sharing" --type added
+ *   agent-native changelog release           # roll pending → CHANGELOG.md (today)
+ *   agent-native changelog list              # show pending + released
+ *
+ * Runs in the current app directory (process.cwd()).
+ */
+import fs from "fs";
+import path from "path";
+import { parsePendingEntry, parseChangelog, rollupChangelog, changelogSlug, CHANGELOG_HEADER, } from "../changelog/parse.js";
+const CHANGELOG_FILE = "CHANGELOG.md";
+const PENDING_DIR = "changelog";
+function todayIso() {
+    // Local date in YYYY-MM-DD. The CLI is the one place a wall-clock read is
+    // appropriate (unlike workflow scripts), so `new Date()` is fine here.
+    const d = new Date();
+    const pad = (n) => String(n).padStart(2, "0");
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;
+}
+/** Minimal flag parser: supports `--key value` and `--key=value`. */
+function parseFlags(args) {
+    const flags = {};
+    const rest = [];
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg.startsWith("--")) {
+            const eq = arg.indexOf("=");
+            if (eq !== -1) {
+                flags[arg.slice(2, eq)] = arg.slice(eq + 1);
+            }
+            else {
+                const next = args[i + 1];
+                if (next && !next.startsWith("--")) {
+                    flags[arg.slice(2)] = next;
+                    i++;
+                }
+                else {
+                    flags[arg.slice(2)] = "true";
+                }
+            }
+        }
+        else {
+            rest.push(arg);
+        }
+    }
+    return { flags, rest };
+}
+function printUsage() {
+    console.log([
+        "Usage:",
+        '  agent-native changelog add "<summary>" [--type added|improved|fixed|changed|removed|security] [--date YYYY-MM-DD]',
+        "  agent-native changelog release [--date YYYY-MM-DD]",
+        "  agent-native changelog list",
+        "",
+        "Entries are user-facing notes. `add` writes a pending file under",
+        `  ${PENDING_DIR}/; \`release\` rolls all pending files into ${CHANGELOG_FILE}.`,
+    ].join("\n"));
+}
+function cmdAdd(args) {
+    const { flags, rest } = parseFlags(args);
+    const summary = rest.join(" ").trim();
+    if (!summary) {
+        console.error('Provide a summary, e.g. changelog add "Faster search"');
+        return 1;
+    }
+    const type = (flags.type ?? "changed");
+    const date = flags.date?.match(/\d{4}-\d{2}-\d{2}/)?.[0] ?? todayIso();
+    const dir = path.resolve(PENDING_DIR);
+    fs.mkdirSync(dir, { recursive: true });
+    const slug = changelogSlug(summary) || "entry";
+    let file = path.join(dir, `${date}-${slug}.md`);
+    let n = 2;
+    while (fs.existsSync(file)) {
+        file = path.join(dir, `${date}-${slug}-${n++}.md`);
+    }
+    // Blank line after the closing frontmatter delimiter so the generated file
+    // is already Prettier-clean (Markdown requires a blank line before body text)
+    // and never trips the repo fmt check.
+    const content = `---\ntype: ${type}\ndate: ${date}\n---\n\n${summary}\n`;
+    fs.writeFileSync(file, content, "utf-8");
+    console.log(`Added changelog entry: ${path.relative(process.cwd(), file)}`);
+    return 0;
+}
+function readPending() {
+    const dir = path.resolve(PENDING_DIR);
+    if (!fs.existsSync(dir))
+        return [];
+    return fs
+        .readdirSync(dir)
+        .filter((f) => f.endsWith(".md") && f.toLowerCase() !== "readme.md")
+        .sort()
+        .map((f) => ({
+        file: path.join(dir, f),
+        content: fs.readFileSync(path.join(dir, f), "utf-8"),
+    }));
+}
+function cmdRelease(args) {
+    const { flags } = parseFlags(args);
+    const date = flags.date?.match(/\d{4}-\d{2}-\d{2}/)?.[0] ?? todayIso();
+    const pendingFiles = readPending();
+    if (pendingFiles.length === 0) {
+        console.log("No pending changelog entries to release.");
+        return 0;
+    }
+    const pending = pendingFiles.map((p) => parsePendingEntry(p.content));
+    const changelogPath = path.resolve(CHANGELOG_FILE);
+    const existing = fs.existsSync(changelogPath)
+        ? fs.readFileSync(changelogPath, "utf-8")
+        : "";
+    const next = rollupChangelog(existing, pending, date);
+    fs.writeFileSync(changelogPath, next, "utf-8");
+    // Remove the pending entries now that they're released.
+    for (const p of pendingFiles)
+        fs.rmSync(p.file);
+    console.log(`Released ${pendingFiles.length} entr${pendingFiles.length === 1 ? "y" : "ies"} into ${CHANGELOG_FILE} (## ${date}).`);
+    return 0;
+}
+function cmdList() {
+    const pending = readPending();
+    const changelogPath = path.resolve(CHANGELOG_FILE);
+    const released = fs.existsSync(changelogPath)
+        ? parseChangelog(fs.readFileSync(changelogPath, "utf-8"))
+        : [];
+    console.log(`Pending (${pending.length}):`);
+    for (const p of pending) {
+        const entry = parsePendingEntry(p.content);
+        console.log(`  - [${entry.type}] ${entry.text.split("\n")[0]}  (${path.basename(p.file)})`);
+    }
+    console.log("");
+    console.log(`Released (${released.length}):`);
+    for (const r of released.slice(0, 10))
+        console.log(`  - ${r.title}`);
+    return 0;
+}
+export async function runChangelog(args) {
+    const sub = args[0];
+    const rest = args.slice(1);
+    switch (sub) {
+        case "add":
+            return cmdAdd(rest);
+        case "release":
+            return cmdRelease(rest);
+        case "list":
+            return cmdList();
+        case undefined:
+        case "help":
+        case "--help":
+        case "-h":
+            printUsage();
+            return 0;
+        default:
+            console.error(`Unknown changelog subcommand: ${sub}\n`);
+            printUsage();
+            return 1;
+    }
+}
+// Re-export header for callers that want to seed an empty CHANGELOG.md.
+export { CHANGELOG_HEADER };
+//# sourceMappingURL=changelog.js.map

package/dist/cli/changelog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.js","sourceRoot":"","sources":["../../src/cli/changelog.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `agent-native changelog` — author and roll up an app's user-facing changelog.\n *\n * The model mirrors changesets: instead of editing the shared CHANGELOG.md\n * directly (which conflicts when many agents work in parallel), each change\n * drops a small pending entry file under `changelog/`. A later `release` rolls\n * every pending file up into a single dated section of CHANGELOG.md.\n *\n *   agent-native changelog add \"Recordings can be trimmed before sharing\" --type added\n *   agent-native changelog release           # roll pending → CHANGELOG.md (today)\n *   agent-native changelog list              # show pending + released\n *\n * Runs in the current app directory (process.cwd()).\n */\nimport fs from \"fs\";\nimport path from \"path\";\n\nimport {\n  parsePendingEntry,\n  parseChangelog,\n  rollupChangelog,\n  changelogSlug,\n  CHANGELOG_HEADER,\n  type ChangelogChangeType,\n} from \"../changelog/parse.js\";\n\nconst CHANGELOG_FILE = \"CHANGELOG.md\";\nconst PENDING_DIR = \"changelog\";\n\nfunction todayIso(): string {\n  // Local date in YYYY-MM-DD. The CLI is the one place a wall-clock read is\n  // appropriate (unlike workflow scripts), so `new Date()` is fine here.\n  const d = new Date();\n  const pad = (n: number) => String(n).padStart(2, \"0\");\n  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;\n}\n\n/** Minimal flag parser: supports `--key value` and `--key=value`. */\nfunction parseFlags(args: string[]): {\n  flags: Record<string, string>;\n  rest: string[];\n} {\n  const flags: Record<string, string> = {};\n  const rest: string[] = [];\n  for (let i = 0; i < args.length; i++) {\n    const arg = args[i];\n    if (arg.startsWith(\"--\")) {\n      const eq = arg.indexOf(\"=\");\n      if (eq !== -1) {\n        flags[arg.slice(2, eq)] = arg.slice(eq + 1);\n      } else {\n        const next = args[i + 1];\n        if (next && !next.startsWith(\"--\")) {\n          flags[arg.slice(2)] = next;\n          i++;\n        } else {\n          flags[arg.slice(2)] = \"true\";\n        }\n      }\n    } else {\n      rest.push(arg);\n    }\n  }\n  return { flags, rest };\n}\n\nfunction printUsage(): void {\n  console.log(\n    [\n      \"Usage:\",\n      '  agent-native changelog add \"<summary>\" [--type added|improved|fixed|changed|removed|security] [--date YYYY-MM-DD]',\n      \"  agent-native changelog release [--date YYYY-MM-DD]\",\n      \"  agent-native changelog list\",\n      \"\",\n      \"Entries are user-facing notes. `add` writes a pending file under\",\n      `  ${PENDING_DIR}/; \\`release\\` rolls all pending files into ${CHANGELOG_FILE}.`,\n    ].join(\"\\n\"),\n  );\n}\n\nfunction cmdAdd(args: string[]): number {\n  const { flags, rest } = parseFlags(args);\n  const summary = rest.join(\" \").trim();\n  if (!summary) {\n    console.error('Provide a summary, e.g. changelog add \"Faster search\"');\n    return 1;\n  }\n  const type = (flags.type ?? \"changed\") as ChangelogChangeType;\n  const date = flags.date?.match(/\\d{4}-\\d{2}-\\d{2}/)?.[0] ?? todayIso();\n\n  const dir = path.resolve(PENDING_DIR);\n  fs.mkdirSync(dir, { recursive: true });\n\n  const slug = changelogSlug(summary) || \"entry\";\n  let file = path.join(dir, `${date}-${slug}.md`);\n  let n = 2;\n  while (fs.existsSync(file)) {\n    file = path.join(dir, `${date}-${slug}-${n++}.md`);\n  }\n\n  // Blank line after the closing frontmatter delimiter so the generated file\n  // is already Prettier-clean (Markdown requires a blank line before body text)\n  // and never trips the repo fmt check.\n  const content = `---\\ntype: ${type}\\ndate: ${date}\\n---\\n\\n${summary}\\n`;\n  fs.writeFileSync(file, content, \"utf-8\");\n  console.log(`Added changelog entry: ${path.relative(process.cwd(), file)}`);\n  return 0;\n}\n\nfunction readPending(): { file: string; content: string }[] {\n  const dir = path.resolve(PENDING_DIR);\n  if (!fs.existsSync(dir)) return [];\n  return fs\n    .readdirSync(dir)\n    .filter((f) => f.endsWith(\".md\") && f.toLowerCase() !== \"readme.md\")\n    .sort()\n    .map((f) => ({\n      file: path.join(dir, f),\n      content: fs.readFileSync(path.join(dir, f), \"utf-8\"),\n    }));\n}\n\nfunction cmdRelease(args: string[]): number {\n  const { flags } = parseFlags(args);\n  const date = flags.date?.match(/\\d{4}-\\d{2}-\\d{2}/)?.[0] ?? todayIso();\n\n  const pendingFiles = readPending();\n  if (pendingFiles.length === 0) {\n    console.log(\"No pending changelog entries to release.\");\n    return 0;\n  }\n\n  const pending = pendingFiles.map((p) => parsePendingEntry(p.content));\n  const changelogPath = path.resolve(CHANGELOG_FILE);\n  const existing = fs.existsSync(changelogPath)\n    ? fs.readFileSync(changelogPath, \"utf-8\")\n    : \"\";\n\n  const next = rollupChangelog(existing, pending, date);\n  fs.writeFileSync(changelogPath, next, \"utf-8\");\n\n  // Remove the pending entries now that they're released.\n  for (const p of pendingFiles) fs.rmSync(p.file);\n\n  console.log(\n    `Released ${pendingFiles.length} entr${\n      pendingFiles.length === 1 ? \"y\" : \"ies\"\n    } into ${CHANGELOG_FILE} (## ${date}).`,\n  );\n  return 0;\n}\n\nfunction cmdList(): number {\n  const pending = readPending();\n  const changelogPath = path.resolve(CHANGELOG_FILE);\n  const released = fs.existsSync(changelogPath)\n    ? parseChangelog(fs.readFileSync(changelogPath, \"utf-8\"))\n    : [];\n\n  console.log(`Pending (${pending.length}):`);\n  for (const p of pending) {\n    const entry = parsePendingEntry(p.content);\n    console.log(\n      `  - [${entry.type}] ${entry.text.split(\"\\n\")[0]}  (${path.basename(\n        p.file,\n      )})`,\n    );\n  }\n  console.log(\"\");\n  console.log(`Released (${released.length}):`);\n  for (const r of released.slice(0, 10)) console.log(`  - ${r.title}`);\n  return 0;\n}\n\nexport async function runChangelog(args: string[]): Promise<number> {\n  const sub = args[0];\n  const rest = args.slice(1);\n  switch (sub) {\n    case \"add\":\n      return cmdAdd(rest);\n    case \"release\":\n      return cmdRelease(rest);\n    case \"list\":\n      return cmdList();\n    case undefined:\n    case \"help\":\n    case \"--help\":\n    case \"-h\":\n      printUsage();\n      return 0;\n    default:\n      console.error(`Unknown changelog subcommand: ${sub}\\n`);\n      printUsage();\n      return 1;\n  }\n}\n\n// Re-export header for callers that want to seed an empty CHANGELOG.md.\nexport { CHANGELOG_HEADER };\n"]}

package/dist/cli/index.js

@@ -730,6 +730,20 @@ switch (command) {
         });
         break;
     }
+    case "changelog": {
+        // Author and roll up the app's user-facing changelog (changeset-style
+        // pending entry files → a dated CHANGELOG.md section).
+        import("./changelog.js")
+            .then(async (m) => {
+            const code = await m.runChangelog(args);
+            process.exit(code);
+        })
+            .catch((err) => {
+            console.error(err?.message ?? err);
+            process.exit(1);
+        });
+        break;
+    }
     case "--version":
     case "-v": {
         console.log(_version);
@@ -807,6 +821,10 @@ Usage:
                                 Pass a URL instead of a name for a generic
                                 research-and-integrate blueprint. --list to
                                 browse available blueprints.
+  agent-native changelog <cmd>  Author the app's user-facing changelog.
+                                cmds: add "<summary>" [--type added|fixed|...] |
+                                release | list. Pending entries live in
+                                changelog/; 'release' rolls them into CHANGELOG.md.
   agent-native audit-agent-web  Audit a public URL for agent-readable surfaces
   agent-native eval [pattern]   Run the app's evals (**/*.eval.ts, evals/*.ts)
                                 and exit non-zero if any scores below its