@entelligentsia/forgecli 1.0.20 → 1.0.21

package/dist/extensions/forgecli/update/whats-new-widget.js

@@ -0,0 +1,376 @@
+// What's-New strip + detail widget.
+//
+// Startup behavior (post-FORGE-BUG-001 refactor): on session_start we emit
+// a one-line passive notify pointing the user at `/changelog` — we do NOT
+// auto-mount the interactive strip and we do NOT hook the input router.
+// The strip used to live below the editor for the entire session and steal
+// every ↓ key; users hated it.
+//
+// The interactive strip is now ONLY mounted in response to `/changelog`.
+// UX once mounted:
+//
+//   INACTIVE (default): "what's new ─ pi 30 · forge-plugin 8 · forge-cli 2  ↓ to view"
+//   ACTIVE   (↓):       "what's new ─ ▸● pi 30   ○ forge-plugin 8   ○ forge-cli 2  ←→ · enter · esc hide · d forget"
+//
+//   Enter on a chip → setOutputSource(WhatsNewDetailComponent).
+//   Esc → soft hide for this session (unmounts widget, drops input handler;
+//         /changelog cache is untouched, so /changelog still replays).
+//   d   → permanent forget (collapses prev baseline so /changelog returns
+//         "no recent updates" until the next version bump).
+//
+// Activation key (↓) requires an empty editor (no text at all), not just
+// "no newlines" — single-line text used to be enough and that was too
+// eager.
+//
+// Mount is idempotent: a second /changelog while the strip is already
+// mounted unregisters the prior input-router handler before re-registering,
+// so handlers don't stack.
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import { getInputRouter } from "../tui/input-router.js";
+import { getUserCacheDir } from "../paths/paths.js";
+import { computeAndPersistStartupPanel, computeSummaries, computeWhatsNewView, dismissWhatsNew, readSeenState, renderComponentDetail, renderSummaryPanel, resolveChangelogPaths, } from "./whats-new.js";
+const WIDGET_KEY = "forge:whats-new";
+// ── Detail-view component: rendered into chat viewport on Enter ──────────
+class WhatsNewDetailComponent {
+    lines;
+    invalidationCb;
+    constructor(lines) {
+        this.lines = lines;
+    }
+    render(width) {
+        return this.lines.map((l) => (visibleWidth(l) <= width ? l : truncateToWidth(l, width)));
+    }
+    invalidate() {
+        // Static content — re-render only when caller updates `lines`.
+    }
+    setInvalidationCallback(cb) {
+        this.invalidationCb = cb;
+    }
+    updateLines(lines) {
+        this.lines = lines;
+        this.invalidationCb?.();
+    }
+    dispose = () => { };
+}
+// ── Strip component: single row below the editor ─────────────────────────
+class WhatsNewStripComponent {
+    summaries;
+    theme;
+    cursorIdx = 0;
+    stripActive = false;
+    /** Component currently focused into the chat viewport. */
+    focusedComponent = null;
+    invalidationCb;
+    constructor(summaries, theme) {
+        this.summaries = summaries;
+        this.theme = theme;
+    }
+    setInvalidationCallback(cb) {
+        this.invalidationCb = cb;
+    }
+    invalidate() {
+        // Re-render driven by caller via invalidationCb → tui.requestRender().
+    }
+    hasContent() {
+        return this.summaries.length > 0;
+    }
+    getStripActive() {
+        return this.stripActive;
+    }
+    cursorSummary() {
+        return this.summaries[this.cursorIdx];
+    }
+    setStripActive(active) {
+        if (this.stripActive === active)
+            return;
+        this.stripActive = active;
+        this.invalidationCb?.();
+    }
+    moveCursor(delta) {
+        if (this.summaries.length === 0)
+            return;
+        this.cursorIdx = Math.max(0, Math.min(this.summaries.length - 1, this.cursorIdx + delta));
+        this.invalidationCb?.();
+    }
+    setFocused(id) {
+        this.focusedComponent = id;
+        this.invalidationCb?.();
+    }
+    clearSummaries() {
+        this.summaries = [];
+        this.focusedComponent = null;
+        this.invalidationCb?.();
+    }
+    render(width) {
+        if (!this.hasContent())
+            return [];
+        const dim = (s) => this.theme.fg("dim", s);
+        const accent = (s) => this.theme.fg("accent", s);
+        const bold = (s) => this.theme.bold(s);
+        const prefix = this.stripActive ? accent("what's new ─ ") : dim("what's new ─ ");
+        const hint = this.stripActive ? dim("  ←→ · enter · esc hide · d forget") : dim("  ↓ to view (empty editor)");
+        const parts = this.summaries.map((s, i) => {
+            const focusedGlyph = this.focusedComponent === s.component ? "●" : "○";
+            const inner = `${focusedGlyph} ${s.label} ${s.totalChanges}`;
+            if (this.stripActive && i === this.cursorIdx)
+                return accent(bold(`▸${inner}`));
+            return dim(inner);
+        });
+        const chips = parts.join("   ");
+        let line = `${prefix}${chips}${hint}`;
+        if (visibleWidth(line) > width)
+            line = truncateToWidth(line, width);
+        return [line];
+    }
+    dispose = () => { };
+}
+// ── Key recognition (mirrors thread-switcher.ts) ─────────────────────────
+function isLeftArrow(d) {
+    return d === "\x1b[D";
+}
+function isRightArrow(d) {
+    return d === "\x1b[C";
+}
+function isDownArrow(d) {
+    return d === "\x1b[B" || d === "\x1bOB";
+}
+function isUpArrow(d) {
+    return d === "\x1b[A" || d === "\x1bOA";
+}
+function isEnter(d) {
+    return d === "\r" || d === "\n";
+}
+function isEsc(d) {
+    return d === "\x1b";
+}
+// ── Mount ────────────────────────────────────────────────────────────────
+/**
+ * Compute startup summaries and, if any, emit a one-line passive notify
+ * pointing the user at `/changelog`. Marks versions as seen via the
+ * standard cache so subsequent sessions won't re-notify unless a new bump
+ * occurs. Returns true when a notify was emitted.
+ *
+ * Pre-FORGE-BUG-001 this mounted the interactive strip directly; that was
+ * removed because the strip captured the ↓ key for the whole session and
+ * the auto-mount happened before the user had any chance to opt in.
+ */
+export async function mountWhatsNewWidgetOnStartup(_pi, ctx, rt) {
+    const result = await computeAndPersistStartupPanel(rt);
+    if (!result || result.summaries.length === 0)
+        return false;
+    const parts = result.summaries.map((s) => `${s.label} ${s.totalChanges}`).join(" · ");
+    try {
+        ctx.ui.notify(`forge: what's new — ${parts}.  Type /changelog to view.`, "info");
+    }
+    catch {
+        /* stale ctx — non-fatal */
+    }
+    return true;
+}
+/**
+ * Module-level mount state — used to make `mountStripWithSummaries`
+ * idempotent. Calling /changelog twice used to stack input-router
+ * handlers; we now tear down the previous mount first.
+ */
+let currentUnregister = null;
+/**
+ * Mount the strip with a pre-computed summary list. Idempotent — a second
+ * call unregisters the prior handler and replaces the widget surface.
+ * Only `/changelog` calls this; startup notify does not.
+ */
+export function mountStripWithSummaries(_pi, ctx, rt, summaries) {
+    let stripRef;
+    let tuiRef;
+    let detailRef;
+    // FORGE-BUG-001: the captured ExtensionContext goes stale after pi's
+    // session replacement events. Touching ctx.ui after that throws.
+    const safeUi = (fn) => {
+        try {
+            return fn();
+        }
+        catch {
+            return undefined;
+        }
+    };
+    // Idempotency: drop any prior input-router handler before re-registering.
+    if (currentUnregister) {
+        try {
+            currentUnregister();
+        }
+        catch {
+            /* ignore */
+        }
+        currentUnregister = null;
+    }
+    try {
+        ctx.ui.setWidget(WIDGET_KEY, (tui, theme) => {
+            tuiRef = tui;
+            const strip = new WhatsNewStripComponent(summaries, theme);
+            strip.setInvalidationCallback(() => tui.requestRender());
+            stripRef = strip;
+            return strip;
+        }, { placement: "belowEditor" });
+    }
+    catch (err) {
+        if (process.env.FORGE_DEBUG_WHATS_NEW === "1") {
+            console.error("[forge-cli whats-new] setWidget failed:", err);
+        }
+        return;
+    }
+    const setFocusToMain = () => {
+        stripRef?.setFocused(null);
+        detailRef?.dispose?.();
+        detailRef = undefined;
+        safeUi(() => ctx.ui.setOutputSource(null));
+    };
+    const commitFocus = () => {
+        if (!stripRef)
+            return;
+        const summary = stripRef.cursorSummary();
+        if (!summary)
+            return;
+        stripRef.setFocused(summary.component);
+        const lines = renderComponentDetail(summary).split("\n");
+        if (detailRef) {
+            detailRef.updateLines(lines);
+        }
+        else {
+            detailRef = new WhatsNewDetailComponent(lines);
+            if (tuiRef)
+                detailRef.setInvalidationCallback(() => tuiRef?.requestRender());
+        }
+        if (detailRef)
+            safeUi(() => ctx.ui.setOutputSource(detailRef));
+    };
+    // Tear down the entire mount — used by Esc (hide for this session) and
+    // by `d` (permanent forget). Both unmount the widget surface and drop
+    // the input-router handler so ↓ stops being captured. The difference is
+    // whether dismissWhatsNew() is invoked to collapse the prev baseline.
+    const tearDown = () => {
+        setFocusToMain();
+        safeUi(() => ctx.ui.setWidget(WIDGET_KEY, undefined));
+        stripRef?.clearSummaries();
+        stripRef = undefined;
+        if (currentUnregister) {
+            try {
+                currentUnregister();
+            }
+            catch {
+                /* ignore */
+            }
+            currentUnregister = null;
+        }
+    };
+    const unregister = getInputRouter().register((data) => {
+        if (!stripRef || !stripRef.hasContent())
+            return undefined;
+        if (!stripRef.getStripActive()) {
+            if (!isDownArrow(data))
+                return undefined;
+            const editorText = safeUi(() => ctx.ui.getEditorText());
+            if (editorText === undefined)
+                return undefined; // stale ctx
+            // Stricter than the legacy "no newlines" check — only an
+            // empty editor activates the strip. Any in-progress text
+            // (single-line included) means ↓ belongs to the editor.
+            if (editorText !== "")
+                return undefined;
+            stripRef.setStripActive(true);
+            return { consume: true };
+        }
+        if (isLeftArrow(data)) {
+            stripRef.moveCursor(-1);
+            return { consume: true };
+        }
+        if (isRightArrow(data)) {
+            stripRef.moveCursor(1);
+            return { consume: true };
+        }
+        if (isUpArrow(data)) {
+            stripRef.setStripActive(false);
+            return { consume: true };
+        }
+        if (isEnter(data)) {
+            commitFocus();
+            return { consume: true };
+        }
+        if (isEsc(data)) {
+            // Soft hide for this session — strip disappears, ↓ is
+            // released, but the cache is untouched so /changelog can
+            // re-summon the same set.
+            tearDown();
+            return { consume: true };
+        }
+        if (isForgetKey(data)) {
+            // Permanent forget — collapse prev baseline so /changelog
+            // returns "no recent updates" until the next version bump.
+            void dismissWhatsNew(rt).catch(() => undefined);
+            tearDown();
+            return { consume: true };
+        }
+        return undefined;
+    }, { name: "whats-new-strip", skipWhenOverlayActive: true });
+    currentUnregister = unregister;
+}
+function isForgetKey(d) {
+    return d === "d" || d === "D";
+}
+/**
+ * Compute the summaries that should populate the strip when /whats-new is
+ * invoked: prev baseline first (post auto-dismiss), then lastShown frozen
+ * baseline (post explicit dismiss). Returns empty when neither yields a
+ * set — caller falls back to a notify message.
+ */
+async function computeReplaySummaries(rt) {
+    const cacheDir = rt.cacheDir ?? getUserCacheDir();
+    const seen = await readSeenState(cacheDir);
+    const sources = resolveChangelogPaths(rt.pkgRoot);
+    let s = computeSummaries({ sources, current: rt.current, seen, baseline: "prev" });
+    if (s.length === 0)
+        s = computeSummaries({ sources, current: rt.current, seen, baseline: "lastShown" });
+    return s;
+}
+/**
+ * Register the /changelog slash command (overrides pi's built-in): re-mounts
+ * the interactive strip widget covering pi + forge-plugin + forge-cli changelogs.
+ * `/changelog dismiss` clears the replay baseline. Headless / non-TTY callers
+ * fall through to a text notify so the command is still usable.
+ */
+export function registerChangelogCommand(pi, rt) {
+    pi.registerCommand("changelog", {
+        description: "Show What's New across pi, forge-plugin, and forge-cli (or /changelog dismiss to clear)",
+        async handler(args, ctx) {
+            const arg = args.trim().toLowerCase();
+            try {
+                if (arg === "dismiss" || arg === "--dismiss") {
+                    await dismissWhatsNew(rt);
+                    ctx.ui.notify("changelog: dismissed.", "info");
+                    return;
+                }
+                const summaries = await computeReplaySummaries(rt);
+                if (summaries.length === 0) {
+                    ctx.ui.notify("changelog: no recent updates.", "info");
+                    return;
+                }
+                if (!ctx.hasUI) {
+                    // Headless / RPC mode — widget surface unavailable; dump text.
+                    const view = await computeWhatsNewView(rt, arg.length > 0 ? arg : null);
+                    ctx.ui.notify(view, "info");
+                    return;
+                }
+                // Echo the overall summary into the main chat container so
+                // users have a record of the change counts, then mount the
+                // strip below the editor for arrow-key drill-down.
+                ctx.ui.notify(`${renderSummaryPanel(summaries)}\n\n(Strip is below the editor — ↓ on an empty prompt to activate, ←→ to navigate, Enter to expand, Esc to hide, d to forget.)`, "info");
+                mountStripWithSummaries(pi, ctx, rt, summaries);
+            }
+            catch (err) {
+                if (process.env.FORGE_DEBUG_WHATS_NEW === "1") {
+                    console.error("[forge-cli changelog] handler failed:", err);
+                }
+                ctx.ui.notify("changelog: failed to render — set FORGE_DEBUG_WHATS_NEW=1 for details.", "warning");
+            }
+        },
+    });
+}
+//# sourceMappingURL=whats-new-widget.js.map

package/dist/extensions/forgecli/update/whats-new-widget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whats-new-widget.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/update/whats-new-widget.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,EAAE;AACF,2EAA2E;AAC3E,0EAA0E;AAC1E,wEAAwE;AACxE,2EAA2E;AAC3E,+BAA+B;AAC/B,EAAE;AACF,yEAAyE;AACzE,mBAAmB;AACnB,EAAE;AACF,uFAAuF;AACvF,qHAAqH;AACrH,EAAE;AACF,gEAAgE;AAChE,4EAA4E;AAC5E,uEAAuE;AACvE,0EAA0E;AAC1E,4DAA4D;AAC5D,EAAE;AACF,yEAAyE;AACzE,sEAAsE;AACtE,SAAS;AACT,EAAE;AACF,sEAAsE;AACtE,4EAA4E;AAC5E,2BAA2B;AAG3B,OAAO,EAA4B,eAAe,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACjG,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAEN,6BAA6B,EAC7B,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,GAErB,MAAM,gBAAgB,CAAC;AAExB,MAAM,UAAU,GAAG,iBAAiB,CAAC;AAErC,4EAA4E;AAE5E,MAAM,uBAAuB;IAGR;IAFZ,cAAc,CAAc;IAEpC,YAAoB,KAAe;QAAf,UAAK,GAAL,KAAK,CAAU;IAAG,CAAC;IAEvC,MAAM,CAAC,KAAa;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1F,CAAC;IAED,UAAU;QACT,+DAA+D;IAChE,CAAC;IAED,uBAAuB,CAAC,EAAc;QACrC,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;IAC1B,CAAC;IAED,WAAW,CAAC,KAAe;QAC1B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;IACzB,CAAC;IAED,OAAO,GAAe,GAAG,EAAE,GAAE,CAAC,CAAC;CAC/B;AAED,4EAA4E;AAE5E,MAAM,sBAAsB;IAQlB;IACS;IARV,SAAS,GAAG,CAAC,CAAC;IACd,WAAW,GAAG,KAAK,CAAC;IAC5B,0DAA0D;IAClD,gBAAgB,GAAkB,IAAI,CAAC;IACvC,cAAc,CAAc;IAEpC,YACS,SAA0B,EACjB,KAAY;QADrB,cAAS,GAAT,SAAS,CAAiB;QACjB,UAAK,GAAL,KAAK,CAAO;IAC3B,CAAC;IAEJ,uBAAuB,CAAC,EAAc;QACrC,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;IAC1B,CAAC;IAED,UAAU;QACT,uEAAuE;IACxE,CAAC;IAED,UAAU;QACT,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,cAAc;QACb,OAAO,IAAI,CAAC,WAAW,CAAC;IACzB,CAAC;IAED,aAAa;QACZ,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAED,cAAc,CAAC,MAAe;QAC7B,IAAI,IAAI,CAAC,WAAW,KAAK,MAAM;YAAE,OAAO;QACxC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC;QAC1B,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;IACzB,CAAC;IAED,UAAU,CAAC,KAAa;QACvB,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACxC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC;QAC1F,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;IACzB,CAAC;IAED,UAAU,CAAC,EAAiB;QAC3B,IAAI,CAAC,gBAAgB,GAAG,EAAE,CAAC;QAC3B,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;IACzB,CAAC;IAED,cAAc;QACb,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QACpB,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAC7B,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;IACzB,CAAC;IAED,MAAM,CAAC,KAAa;QACnB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE;YAAE,OAAO,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACzD,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAE/C,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACjF,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAE9G,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACzC,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YACvE,MAAM,KAAK,GAAG,GAAG,YAAY,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC;YAC7D,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS;gBAAE,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC;YAC/E,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,IAAI,GAAG,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI,EAAE,CAAC;QACtC,IAAI,YAAY,CAAC,IAAI,CAAC,GAAG,KAAK;YAAE,IAAI,GAAG,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACpE,OAAO,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,OAAO,GAAe,GAAG,EAAE,GAAE,CAAC,CAAC;CAC/B;AAED,4EAA4E;AAE5E,SAAS,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,KAAK,QAAQ,CAAC;AACvB,CAAC;AACD,SAAS,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,KAAK,QAAQ,CAAC;AACvB,CAAC;AACD,SAAS,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,QAAQ,CAAC;AACzC,CAAC;AACD,SAAS,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,QAAQ,CAAC;AACzC,CAAC;AACD,SAAS,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC;AACjC,CAAC;AACD,SAAS,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,KAAK,MAAM,CAAC;AACrB,CAAC;AAED,4EAA4E;AAE5E;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CACjD,GAAiB,EACjB,GAAqB,EACrB,EAAmB;IAEnB,MAAM,MAAM,GAAG,MAAM,6BAA6B,CAAC,EAAE,CAAC,CAAC;IACvD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtF,IAAI,CAAC;QACJ,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,uBAAuB,KAAK,6BAA6B,EAAE,MAAM,CAAC,CAAC;IAClF,CAAC;IAAC,MAAM,CAAC;QACR,2BAA2B;IAC5B,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,IAAI,iBAAiB,GAAwB,IAAI,CAAC;AAElD;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACtC,GAAiB,EACjB,GAAqB,EACrB,EAAmB,EACnB,SAA0B;IAE1B,IAAI,QAA4C,CAAC;IACjD,IAAI,MAAuB,CAAC;IAC5B,IAAI,SAA8C,CAAC;IAEnD,qEAAqE;IACrE,iEAAiE;IACjE,MAAM,MAAM,GAAG,CAAI,EAAW,EAAiB,EAAE;QAChD,IAAI,CAAC;YACJ,OAAO,EAAE,EAAE,CAAC;QACb,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,SAAS,CAAC;QAClB,CAAC;IACF,CAAC,CAAC;IAEF,0EAA0E;IAC1E,IAAI,iBAAiB,EAAE,CAAC;QACvB,IAAI,CAAC;YACJ,iBAAiB,EAAE,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACR,YAAY;QACb,CAAC;QACD,iBAAiB,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,IAAI,CAAC;QACJ,GAAG,CAAC,EAAE,CAAC,SAAS,CACf,UAAU,EACV,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YACd,MAAM,GAAG,GAAG,CAAC;YACb,MAAM,KAAK,GAAG,IAAI,sBAAsB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAC3D,KAAK,CAAC,uBAAuB,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC;YACzD,QAAQ,GAAG,KAAK,CAAC;YACjB,OAAO,KAAK,CAAC;QACd,CAAC,EACD,EAAE,SAAS,EAAE,aAAa,EAAE,CAC5B,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,GAAG,EAAE,CAAC;YAC/C,OAAO,CAAC,KAAK,CAAC,yCAAyC,EAAE,GAAG,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO;IACR,CAAC;IAED,MAAM,cAAc,GAAG,GAAG,EAAE;QAC3B,QAAQ,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QAC3B,SAAS,EAAE,OAAO,EAAE,EAAE,CAAC;QACvB,SAAS,GAAG,SAAS,CAAC;QACtB,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,GAAG,EAAE;QACxB,IAAI,CAAC,QAAQ;YAAE,OAAO;QACtB,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,EAAE,CAAC;QACzC,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,SAAS,EAAE,CAAC;YACf,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACP,SAAS,GAAG,IAAI,uBAAuB,CAAC,KAAK,CAAC,CAAC;YAC/C,IAAI,MAAM;gBAAE,SAAS,CAAC,uBAAuB,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;QAC9E,CAAC;QACD,IAAI,SAAS;YAAE,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,eAAe,CAAC,SAAU,CAAC,CAAC,CAAC;IACjE,CAAC,CAAC;IAEF,uEAAuE;IACvE,sEAAsE;IACtE,wEAAwE;IACxE,sEAAsE;IACtE,MAAM,QAAQ,GAAG,GAAG,EAAE;QACrB,cAAc,EAAE,CAAC;QACjB,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;QACtD,QAAQ,EAAE,cAAc,EAAE,CAAC;QAC3B,QAAQ,GAAG,SAAS,CAAC;QACrB,IAAI,iBAAiB,EAAE,CAAC;YACvB,IAAI,CAAC;gBACJ,iBAAiB,EAAE,CAAC;YACrB,CAAC;YAAC,MAAM,CAAC;gBACR,YAAY;YACb,CAAC;YACD,iBAAiB,GAAG,IAAI,CAAC;QAC1B,CAAC;IACF,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC,QAAQ,CAC3C,CAAC,IAAI,EAAE,EAAE;QACR,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE;YAAE,OAAO,SAAS,CAAC;QAE1D,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,EAAE,CAAC;YAChC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;gBAAE,OAAO,SAAS,CAAC;YACzC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC;YACxD,IAAI,UAAU,KAAK,SAAS;gBAAE,OAAO,SAAS,CAAC,CAAC,YAAY;YAC5D,yDAAyD;YACzD,yDAAyD;YACzD,wDAAwD;YACxD,IAAI,UAAU,KAAK,EAAE;gBAAE,OAAO,SAAS,CAAC;YACxC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;YAC9B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC1B,CAAC;QAED,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;YACxB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC1B,CAAC;QACD,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACvB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC1B,CAAC;QACD,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YAC/B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC1B,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACnB,WAAW,EAAE,CAAC;YACd,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC1B,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACjB,sDAAsD;YACtD,yDAAyD;YACzD,0BAA0B;YAC1B,QAAQ,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC1B,CAAC;QACD,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,0DAA0D;YAC1D,2DAA2D;YAC3D,KAAK,eAAe,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAChD,QAAQ,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC1B,CAAC;QACD,OAAO,SAAS,CAAC;IAClB,CAAC,EACD,EAAE,IAAI,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,IAAI,EAAE,CACxD,CAAC;IACF,iBAAiB,GAAG,UAAU,CAAC;AAChC,CAAC;AAED,SAAS,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,sBAAsB,CAAC,EAAmB;IACxD,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,IAAI,eAAe,EAAE,CAAC;IAClD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,qBAAqB,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,CAAC,GAAG,gBAAgB,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IACnF,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,CAAC,GAAG,gBAAgB,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;IACxG,OAAO,CAAC,CAAC;AACV,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,EAAgB,EAAE,EAAmB;IAC7E,EAAE,CAAC,eAAe,CAAC,WAAW,EAAE;QAC/B,WAAW,EAAE,yFAAyF;QACtG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG;YACtB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACtC,IAAI,CAAC;gBACJ,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;oBAC9C,MAAM,eAAe,CAAC,EAAE,CAAC,CAAC;oBAC1B,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;oBAC/C,OAAO;gBACR,CAAC;gBACD,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAAC,EAAE,CAAC,CAAC;gBACnD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC5B,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,+BAA+B,EAAE,MAAM,CAAC,CAAC;oBACvD,OAAO;gBACR,CAAC;gBACD,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;oBAChB,+DAA+D;oBAC/D,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,EAAE,EAAE,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;oBACxE,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;oBAC5B,OAAO;gBACR,CAAC;gBACD,2DAA2D;gBAC3D,2DAA2D;gBAC3D,mDAAmD;gBACnD,GAAG,CAAC,EAAE,CAAC,MAAM,CACZ,GAAG,kBAAkB,CAAC,SAAS,CAAC,gIAAgI,EAChK,MAAM,CACN,CAAC;gBACF,uBAAuB,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;YACjD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACd,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,GAAG,EAAE,CAAC;oBAC/C,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,GAAG,CAAC,CAAC;gBAC7D,CAAC;gBACD,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,wEAAwE,EAAE,SAAS,CAAC,CAAC;YACpG,CAAC;QACF,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}

package/dist/extensions/forgecli/update/whats-new.d.ts

@@ -0,0 +1,120 @@
+export type ComponentId = "pi" | "forge-plugin" | "forge-cli";
+export interface SeenState {
+    pi: string | null;
+    forgePlugin: string | null;
+    forgeCli: string | null;
+    prevPi: string | null;
+    prevForgePlugin: string | null;
+    prevForgeCli: string | null;
+    lastShownFromPi: string | null;
+    lastShownFromForgePlugin: string | null;
+    lastShownFromForgeCli: string | null;
+    lastShownAt: number;
+}
+export interface ChangelogEntry {
+    version: string;
+    date: string | null;
+    sections: {
+        name: string;
+        bullets: string[];
+    }[];
+    rawBody: string;
+}
+export interface ChangeSummary {
+    component: ComponentId;
+    label: string;
+    fromVersion: string | null;
+    toVersion: string;
+    totalChanges: number;
+    byCategory: Map<string, number>;
+    entries: ChangelogEntry[];
+}
+declare function defaultCacheDir(): string;
+declare function cachePath(cacheDir: string): string;
+export declare function emptySeenState(): SeenState;
+export declare function readSeenState(cacheDir: string): Promise<SeenState>;
+export declare function writeSeenState(cacheDir: string, state: SeenState): Promise<void>;
+export declare function semverGt(a: string, b: string): boolean;
+/**
+ * Parse a Keep-a-Changelog–style markdown body into per-version entries.
+ * Tolerates pi's `### New Features` overview sections (which precede the
+ * standard `### Added`/`### Fixed` sections) and the `[Unreleased]` block.
+ */
+export declare function parseChangelog(markdown: string): ChangelogEntry[];
+/**
+ * Reduce a list of changelog entries down to the ones strictly newer than
+ * `from`, up to and including `to`. When `from` is null, returns only the
+ * `to` entry (first-install case — don't dump the whole history).
+ */
+export declare function entriesBetween(entries: ChangelogEntry[], from: string | null, to: string): ChangelogEntry[];
+declare function normalizeCategory(name: string): string;
+export declare function summarizeEntries(entries: ChangelogEntry[]): {
+    total: number;
+    byCategory: Map<string, number>;
+};
+export interface ChangelogSources {
+    pi: string | null;
+    forgePlugin: string | null;
+    forgeCli: string | null;
+}
+export declare function resolveChangelogPaths(pkgRoot: string): ChangelogSources;
+export interface CurrentVersions {
+    pi: string;
+    forgePlugin: string;
+    forgeCli: string;
+}
+export type Baseline = "seen" | "prev" | "lastShown";
+export interface ComputeOptions {
+    sources: ChangelogSources;
+    current: CurrentVersions;
+    seen: SeenState;
+    /** Which baseline to diff `current` against:
+     *   - "seen" (default): auto-dismiss check at session_start.
+     *   - "prev": /whats-new replay after auto-dismiss.
+     *   - "lastShown": /whats-new replay after explicit dismiss — uses the
+     *     `from` versions frozen at the most recent panel-mount so the
+     *     last-shown set remains viewable forever.
+     */
+    baseline?: Baseline;
+}
+export declare function computeSummaries(opts: ComputeOptions): ChangeSummary[];
+declare function formatVersionRange(from: string | null, to: string): string;
+declare function formatCategoryBreakdown(byCategory: Map<string, number>): string;
+export declare function renderSummaryPanel(summaries: ChangeSummary[]): string;
+export declare function renderComponentDetail(summary: ChangeSummary): string;
+export interface WhatsNewRuntime {
+    pkgRoot: string;
+    current: CurrentVersions;
+    cacheDir?: string;
+}
+/**
+ * Compute the startup summary and, when present, update the seen state
+ * so subsequent sessions don't replay. Returns the rendered string (or
+ * null when there's nothing to show).
+ *
+ * The `prev*` fields in the seen state preserve the prior baseline so
+ * /whats-new can re-render until the user explicitly dismisses.
+ */
+export declare function computeAndPersistStartupPanel(rt: WhatsNewRuntime): Promise<{
+    rendered: string;
+    summaries: ChangeSummary[];
+} | null>;
+/**
+ * Re-compute summaries against the `prev*` baseline (so users can replay
+ * the panel after auto-dismiss). When `componentArg` matches one of the
+ * three component IDs, returns that component's full detail view instead.
+ */
+export declare function computeWhatsNewView(rt: WhatsNewRuntime, componentArg: string | null): Promise<string>;
+/**
+ * Clear the `prev*` baseline so /whats-new stops replaying past changes.
+ * Current `seen` values are left untouched.
+ */
+export declare function dismissWhatsNew(rt: WhatsNewRuntime): Promise<string>;
+export declare const __test__: {
+    defaultCacheDir: typeof defaultCacheDir;
+    cachePath: typeof cachePath;
+    normalizeCategory: typeof normalizeCategory;
+    formatCategoryBreakdown: typeof formatCategoryBreakdown;
+    formatVersionRange: typeof formatVersionRange;
+};
+export {};