@entelligentsia/forgecli 1.0.20 → 1.0.21

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

@@ -0,0 +1,470 @@
+// What's-New startup panel.
+//
+// On `session_start`, compares the running versions of pi-coding-agent,
+// the bundled forge plugin, and forge-cli itself against the last-seen
+// versions in `~/.pi/forge-cli/cache/whats-new-seen.json` (resolved via
+// the central path resolver; migrated from the pre-v0.10.0 location at
+// `~/.cache/forgecli/whats-new-seen.json`). When any has advanced, emits
+// a compact 3-line summary via `ctx.ui.notify`, then records the new
+// versions so subsequent sessions stay quiet.
+//
+// `/whats-new` re-renders the summary from the same cache, and
+// `/whats-new <component>` drills into one component's full changelog
+// entries between the previous-seen and current versions.
+//
+// All disk I/O is fail-silent on the user surface; FORGE_DEBUG_WHATS_NEW=1
+// prints diagnostic output to stderr.
+import { existsSync, promises as fs, readFileSync } from "node:fs";
+import * as path from "node:path";
+import { getUserCacheDir } from "../paths/paths.js";
+const COMPONENT_LABELS = {
+    pi: "pi",
+    "forge-plugin": "forge-plugin",
+    "forge-cli": "forge-cli",
+};
+const COMPONENT_ORDER = ["pi", "forge-plugin", "forge-cli"];
+function defaultCacheDir() {
+    return getUserCacheDir();
+}
+function cachePath(cacheDir) {
+    return path.join(cacheDir, "whats-new-seen.json");
+}
+function debug(...args) {
+    if (process.env.FORGE_DEBUG_WHATS_NEW === "1") {
+        console.error("[forge-cli whats-new]", ...args);
+    }
+}
+export function emptySeenState() {
+    return {
+        pi: null,
+        forgePlugin: null,
+        forgeCli: null,
+        prevPi: null,
+        prevForgePlugin: null,
+        prevForgeCli: null,
+        lastShownFromPi: null,
+        lastShownFromForgePlugin: null,
+        lastShownFromForgeCli: null,
+        lastShownAt: 0,
+    };
+}
+export async function readSeenState(cacheDir) {
+    try {
+        const raw = await fs.readFile(cachePath(cacheDir), "utf8");
+        const parsed = JSON.parse(raw);
+        const s = emptySeenState();
+        if (typeof parsed.pi === "string")
+            s.pi = parsed.pi;
+        if (typeof parsed.forgePlugin === "string")
+            s.forgePlugin = parsed.forgePlugin;
+        if (typeof parsed.forgeCli === "string")
+            s.forgeCli = parsed.forgeCli;
+        if (typeof parsed.prevPi === "string")
+            s.prevPi = parsed.prevPi;
+        if (typeof parsed.prevForgePlugin === "string")
+            s.prevForgePlugin = parsed.prevForgePlugin;
+        if (typeof parsed.prevForgeCli === "string")
+            s.prevForgeCli = parsed.prevForgeCli;
+        if (typeof parsed.lastShownFromPi === "string")
+            s.lastShownFromPi = parsed.lastShownFromPi;
+        if (typeof parsed.lastShownFromForgePlugin === "string")
+            s.lastShownFromForgePlugin = parsed.lastShownFromForgePlugin;
+        if (typeof parsed.lastShownFromForgeCli === "string")
+            s.lastShownFromForgeCli = parsed.lastShownFromForgeCli;
+        if (typeof parsed.lastShownAt === "number")
+            s.lastShownAt = parsed.lastShownAt;
+        return s;
+    }
+    catch {
+        return emptySeenState();
+    }
+}
+export async function writeSeenState(cacheDir, state) {
+    await fs.mkdir(cacheDir, { recursive: true });
+    const final = cachePath(cacheDir);
+    const tmp = `${final}.${process.pid}.${Date.now()}.tmp`;
+    await fs.writeFile(tmp, JSON.stringify(state, null, 2), "utf8");
+    await fs.rename(tmp, final);
+}
+// ── semver helpers ────────────────────────────────────────────────────────
+function parseTriple(v) {
+    const cleaned = v.startsWith("v") ? v.slice(1) : v;
+    const parts = cleaned.split("-")[0].split(".");
+    if (parts.length !== 3)
+        return null;
+    const nums = [];
+    for (const p of parts) {
+        if (!/^\d+$/.test(p))
+            return null;
+        nums.push(Number.parseInt(p, 10));
+    }
+    return [nums[0], nums[1], nums[2]];
+}
+export function semverGt(a, b) {
+    const pa = parseTriple(a);
+    const pb = parseTriple(b);
+    if (!pa || !pb)
+        return false;
+    for (let i = 0; i < 3; i++) {
+        if (pa[i] > pb[i])
+            return true;
+        if (pa[i] < pb[i])
+            return false;
+    }
+    return false;
+}
+// ── changelog parsing ─────────────────────────────────────────────────────
+const VERSION_HEADER = /^##\s+\[?([^\]\s]+)\]?(?:\s*[—–-]\s*(.+))?$/;
+const SECTION_HEADER = /^###\s+(.+)$/;
+/**
+ * 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 function parseChangelog(markdown) {
+    const lines = markdown.split("\n");
+    const entries = [];
+    let current = null;
+    let currentSection = null;
+    const currentBodyLines = [];
+    const flushSection = () => {
+        if (current && currentSection && currentSection.bullets.length > 0) {
+            current.sections.push(currentSection);
+        }
+        currentSection = null;
+    };
+    const flushEntry = () => {
+        flushSection();
+        if (current) {
+            current.rawBody = currentBodyLines.join("\n").trim();
+            entries.push(current);
+        }
+        current = null;
+        currentBodyLines.length = 0;
+    };
+    for (const line of lines) {
+        const vMatch = line.match(VERSION_HEADER);
+        if (vMatch) {
+            flushEntry();
+            const version = vMatch[1].trim();
+            if (version.toLowerCase() === "unreleased") {
+                // Skip [Unreleased] blocks entirely.
+                current = null;
+                continue;
+            }
+            current = {
+                version,
+                date: vMatch[2]?.trim() ?? null,
+                sections: [],
+                rawBody: "",
+            };
+            currentBodyLines.length = 0;
+            continue;
+        }
+        if (!current)
+            continue;
+        currentBodyLines.push(line);
+        const sMatch = line.match(SECTION_HEADER);
+        if (sMatch) {
+            flushSection();
+            currentSection = { name: sMatch[1].trim(), bullets: [] };
+            continue;
+        }
+        if (currentSection && /^\s*[-*]\s+/.test(line)) {
+            currentSection.bullets.push(line.replace(/^\s*[-*]\s+/, "").trim());
+        }
+    }
+    flushEntry();
+    return entries;
+}
+/**
+ * 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 function entriesBetween(entries, from, to) {
+    const matchExact = entries.filter((e) => e.version === to);
+    if (from === null) {
+        return matchExact;
+    }
+    return entries.filter((e) => semverGt(e.version, from) && (e.version === to || !semverGt(e.version, to)));
+}
+const CATEGORY_ALIASES = {
+    "new features": "added",
+    added: "added",
+    changed: "changed",
+    fixed: "fixed",
+    deprecated: "deprecated",
+    removed: "removed",
+    security: "security",
+    tests: "tests",
+    docs: "docs",
+};
+function normalizeCategory(name) {
+    const key = name.toLowerCase().trim();
+    return CATEGORY_ALIASES[key] ?? key;
+}
+export function summarizeEntries(entries) {
+    const byCategory = new Map();
+    let total = 0;
+    for (const entry of entries) {
+        for (const section of entry.sections) {
+            const cat = normalizeCategory(section.name);
+            const n = section.bullets.length;
+            if (n === 0)
+                continue;
+            byCategory.set(cat, (byCategory.get(cat) ?? 0) + n);
+            total += n;
+        }
+    }
+    return { total, byCategory };
+}
+export function resolveChangelogPaths(pkgRoot) {
+    const candidates = {
+        pi: [
+            path.join(pkgRoot, "dist", "CHANGELOG-pi.md"),
+            path.join(pkgRoot, "node_modules", "@earendil-works", "pi-coding-agent", "CHANGELOG.md"),
+        ],
+        forgePlugin: [
+            path.join(pkgRoot, "dist", "CHANGELOG-forge-plugin.md"),
+            path.join(pkgRoot, "..", "forge", "CHANGELOG.md"),
+        ],
+        forgeCli: [path.join(pkgRoot, "CHANGELOG.md")],
+    };
+    const pick = (paths) => paths.find((p) => existsSync(p)) ?? null;
+    return {
+        pi: pick(candidates.pi),
+        forgePlugin: pick(candidates.forgePlugin),
+        forgeCli: pick(candidates.forgeCli),
+    };
+}
+function readChangelogSafe(p) {
+    if (!p)
+        return null;
+    try {
+        return readFileSync(p, "utf8");
+    }
+    catch (err) {
+        debug("read failed:", p, err);
+        return null;
+    }
+}
+export function computeSummaries(opts) {
+    const baseline = opts.baseline ?? "seen";
+    const pickFrom = (id) => {
+        const s = opts.seen;
+        switch (baseline) {
+            case "seen":
+                return id === "pi" ? s.pi : id === "forge-plugin" ? s.forgePlugin : s.forgeCli;
+            case "prev":
+                return id === "pi" ? s.prevPi : id === "forge-plugin" ? s.prevForgePlugin : s.prevForgeCli;
+            case "lastShown":
+                return id === "pi"
+                    ? s.lastShownFromPi
+                    : id === "forge-plugin"
+                        ? s.lastShownFromForgePlugin
+                        : s.lastShownFromForgeCli;
+        }
+    };
+    const pairs = [
+        { id: "pi", current: opts.current.pi, src: opts.sources.pi },
+        { id: "forge-plugin", current: opts.current.forgePlugin, src: opts.sources.forgePlugin },
+        { id: "forge-cli", current: opts.current.forgeCli, src: opts.sources.forgeCli },
+    ];
+    const out = [];
+    // For the lastShown baseline, presence of any panel-ever-shown is
+    // signalled by lastShownAt > 0. If no panel was ever shown, return
+    // no summaries so /whats-new prints "no recent updates" cleanly.
+    if (baseline === "lastShown" && opts.seen.lastShownAt === 0)
+        return out;
+    for (const p of pairs) {
+        if (!p.current)
+            continue;
+        const useFrom = pickFrom(p.id);
+        // For the prev baseline, null means we have no replay info for this
+        // component — skip it. (seen and lastShown null are both valid: seen
+        // null = first install; lastShown null with lastShownAt>0 = the most
+        // recent panel was a first-install panel.)
+        if (useFrom === null && baseline === "prev")
+            continue;
+        // When the component has not advanced (useFrom === current), fall back to
+        // null so entriesBetween returns the exact current-version entry. This
+        // ensures all three component tabs always appear in the strip.
+        const effectiveFrom = useFrom !== null && !semverGt(p.current, useFrom) ? null : useFrom;
+        const markdown = readChangelogSafe(p.src);
+        if (!markdown) {
+            debug("no changelog source for", p.id);
+            continue;
+        }
+        const parsed = parseChangelog(markdown);
+        const slice = entriesBetween(parsed, effectiveFrom, p.current);
+        if (slice.length === 0) {
+            debug("no matching entries for", p.id, "between", useFrom, "and", p.current);
+            continue;
+        }
+        const sum = summarizeEntries(slice);
+        out.push({
+            component: p.id,
+            label: COMPONENT_LABELS[p.id],
+            fromVersion: effectiveFrom,
+            toVersion: p.current,
+            totalChanges: sum.total,
+            byCategory: sum.byCategory,
+            entries: slice,
+        });
+    }
+    return out;
+}
+// ── rendering ────────────────────────────────────────────────────────────
+function formatVersionRange(from, to) {
+    return from ? `${from} → ${to}` : to;
+}
+function formatCategoryBreakdown(byCategory) {
+    const order = ["added", "changed", "fixed", "removed", "security", "deprecated", "tests", "docs"];
+    const parts = [];
+    for (const key of order) {
+        const n = byCategory.get(key);
+        if (n)
+            parts.push(`${n} ${key}`);
+    }
+    // Surface unknown categories at the end so we never silently drop counts.
+    for (const [key, n] of byCategory) {
+        if (!order.includes(key))
+            parts.push(`${n} ${key}`);
+    }
+    return parts.length > 0 ? `(${parts.join(" · ")})` : "";
+}
+function padRight(s, n) {
+    return s.length >= n ? s : s + " ".repeat(n - s.length);
+}
+export function renderSummaryPanel(summaries) {
+    if (summaries.length === 0)
+        return "What's New: no recent updates.";
+    const sorted = [...summaries].sort((a, b) => COMPONENT_ORDER.indexOf(a.component) - COMPONENT_ORDER.indexOf(b.component));
+    const labelWidth = Math.max(...sorted.map((s) => s.label.length), 12);
+    const rangeWidth = Math.max(...sorted.map((s) => formatVersionRange(s.fromVersion, s.toVersion).length), 14);
+    const lines = ["What's New since last login:"];
+    for (const s of sorted) {
+        const label = padRight(s.label, labelWidth);
+        const range = padRight(formatVersionRange(s.fromVersion, s.toVersion), rangeWidth);
+        const count = `${s.totalChanges} change${s.totalChanges === 1 ? "" : "s"}`;
+        const breakdown = formatCategoryBreakdown(s.byCategory);
+        lines.push(`  ${label}  ${range}  ${padRight(count, 12)}${breakdown ? "  " + breakdown : ""}`);
+    }
+    lines.push("");
+    lines.push("Run /whats-new pi | forge-plugin | forge-cli for details. /whats-new dismiss to clear.");
+    return lines.join("\n");
+}
+export function renderComponentDetail(summary) {
+    const heading = `What's New — ${summary.label} ${formatVersionRange(summary.fromVersion, summary.toVersion)}`;
+    const lines = [heading, ""];
+    for (const entry of summary.entries) {
+        lines.push(`## ${entry.version}${entry.date ? ` — ${entry.date}` : ""}`);
+        for (const section of entry.sections) {
+            lines.push("");
+            lines.push(`### ${section.name}`);
+            for (const bullet of section.bullets) {
+                lines.push(`- ${bullet}`);
+            }
+        }
+        lines.push("");
+    }
+    return lines.join("\n").trim();
+}
+/**
+ * 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 async function computeAndPersistStartupPanel(rt) {
+    const cacheDir = rt.cacheDir ?? defaultCacheDir();
+    const seen = await readSeenState(cacheDir);
+    const sources = resolveChangelogPaths(rt.pkgRoot);
+    const summaries = computeSummaries({ sources, current: rt.current, seen, baseline: "seen" });
+    if (summaries.length === 0)
+        return null;
+    const findFrom = (id) => summaries.find((s) => s.component === id)?.fromVersion ?? null;
+    const next = {
+        pi: rt.current.pi,
+        forgePlugin: rt.current.forgePlugin,
+        forgeCli: rt.current.forgeCli,
+        // Preserve old prev baseline if present; otherwise snapshot what was seen.
+        prevPi: seen.prevPi ?? seen.pi,
+        prevForgePlugin: seen.prevForgePlugin ?? seen.forgePlugin,
+        prevForgeCli: seen.prevForgeCli ?? seen.forgeCli,
+        // Freeze the just-shown `from` baseline so /whats-new can replay this
+        // exact set even after the user dismisses (which collapses prev).
+        lastShownFromPi: findFrom("pi") ?? seen.lastShownFromPi,
+        lastShownFromForgePlugin: findFrom("forge-plugin") ?? seen.lastShownFromForgePlugin,
+        lastShownFromForgeCli: findFrom("forge-cli") ?? seen.lastShownFromForgeCli,
+        lastShownAt: Date.now(),
+    };
+    try {
+        await writeSeenState(cacheDir, next);
+    }
+    catch (err) {
+        debug("writeSeenState failed:", err);
+    }
+    return { rendered: renderSummaryPanel(summaries), summaries };
+}
+/**
+ * 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 async function computeWhatsNewView(rt, componentArg) {
+    const cacheDir = rt.cacheDir ?? defaultCacheDir();
+    const seen = await readSeenState(cacheDir);
+    const sources = resolveChangelogPaths(rt.pkgRoot);
+    // Prefer the prev baseline (post auto-dismiss, pre explicit dismiss); fall
+    // back to the lastShown frozen baseline so dismissed users can still
+    // re-read what was last shown to them.
+    let summaries = computeSummaries({ sources, current: rt.current, seen, baseline: "prev" });
+    if (summaries.length === 0) {
+        summaries = computeSummaries({ sources, current: rt.current, seen, baseline: "lastShown" });
+    }
+    if (componentArg && componentArg !== "summary") {
+        const wanted = componentArg.toLowerCase();
+        const match = summaries.find((s) => s.component === wanted || s.label === wanted);
+        if (!match) {
+            return `whats-new: no recent changes for "${componentArg}". Components: ${COMPONENT_ORDER.join(", ")}.`;
+        }
+        return renderComponentDetail(match);
+    }
+    return renderSummaryPanel(summaries);
+}
+/**
+ * Clear the `prev*` baseline so /whats-new stops replaying past changes.
+ * Current `seen` values are left untouched.
+ */
+export async function dismissWhatsNew(rt) {
+    const cacheDir = rt.cacheDir ?? defaultCacheDir();
+    const seen = await readSeenState(cacheDir);
+    const next = {
+        ...seen,
+        prevPi: seen.pi,
+        prevForgePlugin: seen.forgePlugin,
+        prevForgeCli: seen.forgeCli,
+    };
+    try {
+        await writeSeenState(cacheDir, next);
+    }
+    catch (err) {
+        debug("writeSeenState (dismiss) failed:", err);
+    }
+    return "whats-new: dismissed.";
+}
+// Slash-command registration lives in whats-new-widget.ts (it owns the
+// interactive surface). This module remains the pure parser + state +
+// computer used by both the widget and the slash handler.
+export const __test__ = {
+    defaultCacheDir,
+    cachePath,
+    normalizeCategory,
+    formatCategoryBreakdown,
+    formatVersionRange,
+};
+//# sourceMappingURL=whats-new.js.map

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

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

package/dist/extensions/forgecli/viewport/events.d.ts

@@ -0,0 +1,113 @@
+import type { SessionRegistry } from "../session-registry.js";
+import { type UsageDelta } from "./renderer.js";
+/** Minimal shape of the AgentSessionEvent union we care about — kept loose
+ * so the file doesn't pull in @earendil-works/pi-agent-core types at compile
+ * time for callers that only consume the factory. */
+type SubagentEvent = {
+    type: "turn_start";
+} | {
+    type: "turn_end";
+    message: unknown;
+} | {
+    type: "tool_execution_start";
+    toolCallId: string;
+    toolName: string;
+    args: unknown;
+} | {
+    type: "tool_execution_end";
+    toolCallId: string;
+    toolName: string;
+    result: unknown;
+    isError: boolean;
+} | {
+    type: "compaction_start";
+    reason: string;
+} | {
+    type: "auto_retry_start";
+    attempt: number;
+    maxAttempts: number;
+    errorMessage?: string;
+} | {
+    type: string;
+    [k: string]: unknown;
+};
+export interface ViewportObserverOpts {
+    registry: SessionRegistry;
+    /** session key in the registry (taskId, bugId, or sprintId:ceremony, etc.) */
+    sessionId: string;
+    /** phase scope for tail buffer and per-phase usage */
+    phaseRole: string;
+    /** Exact OrchestratorTree node ID for this dispatch. Orchestrators know
+     * the node they started (`<sessionId>:<role>:<attempt>`) — passing it pins
+     * every telemetry event to that node. Without it the observer falls back
+     * to a role-prefix scan for the first *running* match, which misattributes
+     * telemetry whenever an earlier same-role node is still open (the
+     * CART-BUG-003 dashboard regression: review-plan:2's logs accumulated on a
+     * leaked review-plan:1). */
+    nodeId?: string;
+    /** displayed in the per-line prefix `[<displayRole> HH:MM:SS tN]`. Usually same
+     * as `phaseRole` but kept separate so callers like run-sprint ceremony can
+     * show a friendlier role label without changing the registry key. */
+    displayRole?: string;
+    /** optional `─── phase X/Y begin · sessionId ───` header to emit immediately */
+    beginHeader?: string;
+    /** optional JSONL audit sink (the run-task debug log). */
+    writeDebug?: (rec: Record<string, unknown>) => void;
+    /** optional verbose status setter — only called when FORGE_VERBOSE=1.
+     * The observer doesn't read FORGE_VERBOSE itself; caller decides whether to
+     * wire this. */
+    setStatusVerbose?: (key: string, msg: string) => void;
+    /** optional toast for compaction/retry; ignore to suppress. */
+    notify?: (msg: string, level: "info" | "warning" | "error") => void;
+    /** keys used for `setStatusVerbose` when caller wants verbose status. */
+    verboseKeys?: {
+        messageKey?: string;
+    };
+    /** invoked after every handled event so orchestrators can refresh their own
+     * status line (e.g. FORGE_VERBOSE status with `lastTool`, elapsed seconds). */
+    afterEach?: () => void;
+}
+/** One persisted tail-view line — exactly what the live dashboard rendered. */
+export interface TailLogEntry {
+    line: string;
+    warning?: boolean;
+}
+/**
+ * Head-preserving cap on the recorded tail log. Live phases rarely exceed a
+ * few hundred lines; the cap only bounds pathological runs. Head-preserving
+ * (stop recording, don't drop oldest) because the log's consumer is the
+ * transcript-archive REPLAY, where the beginning is the valuable part.
+ */
+export declare const TAIL_LOG_CAP = 5000;
+export interface AttachedObserver {
+    onEvent: (event: SubagentEvent) => void;
+    /** Mutable counters orchestrator can read after subagent returns. */
+    state: {
+        turn: number;
+        toolCount: number;
+        errCount: number;
+        lastTool: string;
+        cumUsage: UsageDelta;
+        cumCompression: {
+            calls: number;
+            tokensSaved: number;
+        };
+        /**
+         * Verbatim record of every tail line this observer rendered, in
+         * order — the live view stream. Orchestrators persist it next to
+         * the phase transcript (`<transcript>.tail.jsonl`) so transcript
+         * replay re-reads the EXACT lines the live dashboard showed
+         * instead of reconstructing an approximation from messages.
+         */
+        tailLog: TailLogEntry[];
+    };
+}
+/**
+ * Persist the recorded tail log next to its phase transcript as JSONL
+ * (`<transcript-base>.tail.jsonl`). The transcript archive sweeps it with
+ * the run; replay re-reads the exact lines the live dashboard showed.
+ * Best-effort — observability data, never throws.
+ */
+export declare function persistTailLog(subagentTranscriptPath: string, tailLog: TailLogEntry[]): string | null;
+export declare function attachViewportObserver(opts: ViewportObserverOpts): AttachedObserver;
+export {};