@entelligentsia/forgecli 0.7.6 → 0.7.9

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

@@ -0,0 +1,21 @@
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { type ChangeSummary, type WhatsNewRuntime } from "./whats-new.js";
+/**
+ * Compute startup summaries and, if any, mount the strip widget. Marks
+ * versions as seen via the standard cache so subsequent sessions won't
+ * auto-mount unless a new bump occurs. Returns true when mounted.
+ */
+export declare function mountWhatsNewWidgetOnStartup(pi: ExtensionAPI, ctx: ExtensionContext, rt: WhatsNewRuntime): Promise<boolean>;
+/**
+ * Mount the strip directly with a pre-computed summary list. Used by the
+ * `/whats-new` slash command to replay the panel without re-touching the
+ * seen baseline.
+ */
+export declare function mountStripWithSummaries(pi: ExtensionAPI, ctx: ExtensionContext, rt: WhatsNewRuntime, summaries: ChangeSummary[]): void;
+/**
+ * Register the /whats-new slash command: re-mounts the interactive strip
+ * widget (same UI as the startup auto-mount). `/whats-new dismiss` clears
+ * the replay baseline. Headless / non-TTY callers fall through to a text
+ * notify so the command is still usable.
+ */
+export declare function registerWhatsNewWidgetCommand(pi: ExtensionAPI, rt: WhatsNewRuntime): void;

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

@@ -0,0 +1,303 @@
+// What's-New strip + detail widget.
+//
+// Mounts a single-row strip below the editor on session_start when the
+// running versions of pi / forge-plugin / forge-cli have advanced past
+// the last-seen baseline. UX mirrors thread-switcher.ts:
+//
+//   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 dismiss"
+//
+//   Enter on a chip → setOutputSource(WhatsNewDetailComponent) showing
+//   that component's full changelog between previous-seen and current.
+//   Esc → setOutputSource(null), strip remains until user dismisses.
+//   Esc twice (or `d`) → dismissWhatsNew(): collapse prev baseline to
+//   seen so the strip stops auto-mounting and /whats-new returns empty.
+//
+// Activation key (↓) only fires when the editor has no newlines, same
+// guard thread-switcher uses to avoid breaking multi-line nav.
+//
+// Coexistence with thread-switcher: both register widgets at
+// `belowEditor` and both consume ↓ when active. In practice the
+// What's-New strip is short-lived (clears on first Esc/dismiss), and
+// auto-clears its summaries once the user has interacted; thread-switcher
+// only activates once a run-task session exists, which doesn't happen
+// during the startup-banner window.
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import { computeAndPersistStartupPanel, computeSummaries, computeWhatsNewView, dismissWhatsNew, readSeenState, renderComponentDetail, renderSummaryPanel, resolveChangelogPaths, } from "./whats-new.js";
+import * as os from "node:os";
+import * as path from "node:path";
+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 dismiss") : dim("  ↓ to view");
+        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, mount the strip widget. Marks
+ * versions as seen via the standard cache so subsequent sessions won't
+ * auto-mount unless a new bump occurs. Returns true when mounted.
+ */
+export async function mountWhatsNewWidgetOnStartup(pi, ctx, rt) {
+    const result = await computeAndPersistStartupPanel(rt);
+    if (!result || result.summaries.length === 0)
+        return false;
+    mountStripWithSummaries(pi, ctx, rt, result.summaries);
+    return true;
+}
+/**
+ * Mount the strip directly with a pre-computed summary list. Used by the
+ * `/whats-new` slash command to replay the panel without re-touching the
+ * seen baseline.
+ */
+export function mountStripWithSummaries(pi, ctx, rt, summaries) {
+    let stripRef;
+    let tuiRef;
+    let detailRef;
+    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;
+        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());
+        }
+        ctx.ui.setOutputSource(detailRef);
+    };
+    ctx.ui.onTerminalInput((data) => {
+        if (!stripRef || !stripRef.hasContent())
+            return undefined;
+        if (!stripRef.getStripActive()) {
+            if (!isDownArrow(data))
+                return undefined;
+            const editorText = ctx.ui.getEditorText();
+            if (editorText.includes("\n"))
+                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)) {
+            stripRef.setStripActive(false);
+            setFocusToMain();
+            // Permanent dismiss: collapse prev baseline to seen so the strip
+            // stops auto-mounting AND /whats-new returns empty.
+            void dismissWhatsNew(rt)
+                .catch(() => undefined)
+                .then(() => stripRef?.clearSummaries());
+            return { consume: true };
+        }
+        return undefined;
+    });
+}
+/**
+ * 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 ?? path.join(process.env.XDG_CACHE_HOME ?? path.join(os.homedir(), ".cache"), "forgecli");
+    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 /whats-new slash command: re-mounts the interactive strip
+ * widget (same UI as the startup auto-mount). `/whats-new dismiss` clears
+ * the replay baseline. Headless / non-TTY callers fall through to a text
+ * notify so the command is still usable.
+ */
+export function registerWhatsNewWidgetCommand(pi, rt) {
+    pi.registerCommand("whats-new", {
+        description: "Re-show the What's New strip (or /whats-new dismiss to clear)",
+        async handler(args, ctx) {
+            const arg = args.trim().toLowerCase();
+            try {
+                if (arg === "dismiss" || arg === "--dismiss") {
+                    await dismissWhatsNew(rt);
+                    ctx.ui.notify("whats-new: dismissed.", "info");
+                    return;
+                }
+                const summaries = await computeReplaySummaries(rt);
+                if (summaries.length === 0) {
+                    ctx.ui.notify("What's New: 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(Use the strip below the editor: ↓ to activate, ←→ to navigate, Enter to expand.)`, "info");
+                mountStripWithSummaries(pi, ctx, rt, summaries);
+            }
+            catch (err) {
+                if (process.env.FORGE_DEBUG_WHATS_NEW === "1") {
+                    console.error("[forge-cli whats-new] handler failed:", err);
+                }
+                ctx.ui.notify("whats-new: failed to render — set FORGE_DEBUG_WHATS_NEW=1 for details.", "warning");
+            }
+        },
+    });
+}
+//# sourceMappingURL=whats-new-widget.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"whats-new-widget.js","sourceRoot":"","sources":["../../../src/extensions/forgecli/whats-new-widget.ts"],"names":[],"mappings":"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"}

package/dist/extensions/forgecli/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 {};