@agent-native/core 0.69.0 → 0.70.0

package/corpus/templates/videos/CHANGELOG.md

@@ -1,157 +1,10 @@
 # Changelog
 
-## [Unreleased] - 2026-02-28
+All notable user-facing changes to Agent-Native Videos are documented here. Open it any
+time from the command menu (Cmd+K → "What's new").
 
-### Architecture Improvements ✨
-
-- **Extracted Animation Logic to Reusable Pure Function**
-  - Created `app/remotion/animations/useElementAnimations.ts` (202 lines)
-  - Exported `calculateElementAnimations()` - pure function (not hook)
-  - Removed 130 lines of animation logic from InteractiveCardGrid
-  - Centralized all animation calculations in testable function
-  - Can be called inside loops (no Rules of Hooks violations)
-  - Other compositions can now reuse animation system instantly
-  - Reduced InteractiveCardGrid from 400+ to 320 lines
-  - Simpler and faster than hook-based approach
-
-- **Centralized Configuration Constants**
-  - Created `app/config/constants.ts` (204 lines)
-  - Eliminated all magic numbers across codebase
-  - Organized by domain: ANIMATION_CONFIG, CURSOR_CONFIG, CARD_CONFIG, UI_CONFIG, etc.
-  - Type-safe with `as const`
-  - Well-documented with inline comments
-
-- **Code Quality Improvements**
-  - Max function length: 87 lines → 42 lines
-  - Animation logic now testable in isolation
-  - Proper type guards with centralized validation
-  - Cleaner separation of concerns
-
-**Impact**: Architecture grade improved from C+ to A-
+## 2026-06-23
 
 ### Added
 
-- **Color Animation Support**: Background and border color properties for cursor interactions
-  - Added `backgroundColor` and `borderColor` to animation property options
-  - Implemented color interpolation function for smooth color transitions
-  - Color picker UI with native browser color input
-  - Colors animate from each element's base color to target color (preserves multicolor designs)
-
-- **Click Animation Return-to-Hover**: Click animations now properly animate back
-  - Implemented "there-and-back" animation (0→1→0 progress mapping)
-  - Doubles animation duration to accommodate forward and return transitions
-  - Smooth easing applied to both directions
-
-- **Timeline Visual Enhancements**
-  - Changed cursor keyframe click indicator dot from grey/white to yellow (#facc15)
-  - Improved visual distinction for click events in timeline
-
-### Changed
-
-- **Playback Speed System**: Simplified from adaptive to manual control
-  - Removed adaptive playback rate compensation based on FPS measurement
-  - Added manual playback speed dropdown (0.25× to 2×)
-  - Moved speed selector to VideoPlayer bottom controls (next to Frame counter)
-  - Removed playback speed from Timeline component
-
-- **Composition Creation Workflow**: Restored AI-powered generation
-  - Rewrote `NewCompositionPopover` with full agent chat integration
-  - Added file attachment support (images, videos, SVGs via data URLs)
-  - Implemented postMessage API for parent window communication
-  - Added event listener for `builder.agentChat.chatRunning` completion detection
-  - Slug-based URL generation with conflict resolution (`/c/comp-title`, `/c/comp-title-2`)
-  - Navigate to `/c/new` on submission for AI generation
-
-- **Properties Panel Improvements**
-  - Removed composition name input from Properties > Properties section (non-editable)
-  - Hidden "x" unit label to avoid confusion with delete button (kept "px", "deg", etc.)
-  - Moved "Add Property" section above property list (below Motion Curve)
-  - Swapped + button to left side of dropdown
-  - Added Enter key support to add properties from dropdown
-  - Changed focus ring color to red-400 for consistency
-  - Removed hex code display next to color picker (visible in native picker)
-
-- **Animation System Architecture**
-  - Updated `AnimationKeyframe.value` type to support `number | string` for colors
-  - Color animations only apply when `hoverProgress > 0` or `clickProgress > 0`
-  - Each element's base color extracted and used as animation starting point
-  - Hover and click animations support mixed numeric and color properties
-
-### Fixed
-
-- Browser cache issues causing stale code errors
-  - Fixed `ReferenceError: adaptivePlaybackRate is not defined`
-  - Fixed `ReferenceError: onCreateComposition is not defined`
-  - Solution: Dev server restart to clear Vite cache
-
-- Color animation not preserving element colors
-  - Cards were all turning blue when backgroundColor animation added
-  - Fixed by interpolating from each card's unique base color instead of fixed start color
-  - Only applies color animations during active hover/click (preserves idle state)
-
-- Click animations jumping back to hover state
-  - Animations were not tweening back, causing abrupt transitions
-  - Implemented smooth 0→1→0 progress curve with doubled duration
-
-### Technical Details
-
-#### Color Interpolation Implementation
-
-```typescript
-// New function in elementAnimations.ts
-export function interpolateColor(
-  color1: string,
-  color2: string,
-  progress: number,
-): string;
-```
-
-- Parses hex colors to RGB components
-- Linear interpolation per channel
-- Returns hex color string
-
-#### Animation Progress Mapping
-
-```typescript
-// Click animation: 0→1→0 curve
-const rawProgress = framesSinceClick / clickDuration; // 0→2
-clickProgress = rawProgress <= 1 ? rawProgress : 2 - rawProgress; // 0→1→0
-```
-
-#### Files Modified
-
-- `app/components/VideoPlayer.tsx` - Simplified playback rate
-- `app/components/Timeline.tsx` - Removed playback UI, changed dot color
-- `app/pages/CompositionView.tsx` - Playback rate state management
-- `app/components/NewCompositionPopover.tsx` - Complete rewrite for agent chat integration
-- `app/components/Sidebar.tsx` - Updated props, removed name input
-- `app/components/PropsEditor.tsx` - Removed composition name field
-- `app/components/CurrentElementPanel.tsx` - Color properties, UI improvements
-- `app/types/elementAnimations.ts` - Color support, interpolation
-- `app/remotion/compositions/InteractiveCardGrid.tsx` - Color animation logic
-
-#### Files Created
-
-- `app/remotion/animations/useElementAnimations.ts` (209 lines) - **Reusable animation hook**
-- `app/config/constants.ts` (204 lines) - **Centralized configuration**
-- `app/utils/compositionHelpers.ts` (378 lines) - Helper functions library
-- `app/utils/debug.ts` (104 lines) - Production-safe logging utility
-- `scripts/create-composition.ts` (127 lines) - Example composition script
-- `COMPOSITION_GUIDE.md` (787 lines) - Comprehensive API reference
-- `QUICK_START.md` (498 lines) - Beginner-friendly guide
-- `README.md` (209 lines) - Project overview
-- `CHANGELOG.md`, `CODE_REVIEW.md`, `TODO.md`, `PR_DESCRIPTION.md`, `SESSION_SUMMARY.md`
-
-### Developer Experience
-
-- Native `<select>` supports type-to-search for properties
-- Arrow keys navigate property options
-- Enter key adds selected property
-- Color picker shows hex values natively
-- Improved visual hierarchy in properties panel
-
----
-
-## Notes
-
-All changes maintain backward compatibility with existing compositions. Color animation feature is additive and optional.
+- See what's new right inside Agent-Native Videos — a changelog now lives in the command menu (Cmd+K).

package/corpus/templates/videos/app/root.tsx

@@ -20,6 +20,7 @@ import {
   configureTracking,
   getThemeInitScript,
 } from "@agent-native/core/client";
+import changelog from "../CHANGELOG.md?raw";
 configureTracking({
   getDefaultProps: (_name, properties) => ({
     ...properties,
@@ -83,7 +84,12 @@ function AppContent() {
 
   return (
     <>
-      <CommandMenu open={cmdkOpen} onOpenChange={setCmdkOpen}>
+      <CommandMenu
+        open={cmdkOpen}
+        onOpenChange={setCmdkOpen}
+        changelog={changelog}
+        changelogKey="videos"
+      >
         <CommandMenu.Group heading="Videos">
           <CommandMenu.Item onSelect={() => {}}>
             Search compositions

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