@entelligentsia/forgecli 1.0.20 → 1.0.21

package/dist/extensions/forgecli/transcripts-tui/screens/types.d.ts

@@ -0,0 +1,22 @@
+import type { Theme } from "@earendil-works/pi-coding-agent";
+import type { BrowseAction, BrowseState } from "../state/model.js";
+export type InputResult = {
+    kind: "consumed";
+} | {
+    kind: "no-op";
+} | {
+    kind: "dispatch";
+    action: BrowseAction;
+} | {
+    kind: "dispatch-seq";
+    actions: BrowseAction[];
+} | {
+    kind: "quit";
+} | {
+    kind: "error";
+    message: string;
+};
+export interface Screen {
+    render(state: BrowseState, width: number, theme: Theme): string[];
+    handleInput(data: string, state: BrowseState): InputResult;
+}

package/dist/extensions/forgecli/transcripts-tui/screens/types.js

@@ -0,0 +1,4 @@
+// Screen interface + InputResult discriminated union — same contract as
+// config-tui/screens/types.ts, parameterized to the browse-TUI action type.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/extensions/forgecli/transcripts-tui/screens/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/extensions/forgecli/transcripts-tui/screens/types.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,4EAA4E"}

package/dist/extensions/forgecli/transcripts-tui/state/index.d.ts

@@ -0,0 +1,4 @@
+export type { BrowseAction, BrowseFilters, BrowseState, KindFilter, ListRow, OutcomeFilter, SinceFilter, } from "./model.js";
+export { type BrowseInitOptions, initialBrowseState } from "./init.js";
+export { reducer } from "./reducer.js";
+export { activeFilterSummary, filteredRows, nextKind, nextOutcome, nextProject, nextSince, } from "./selectors.js";

package/dist/extensions/forgecli/transcripts-tui/state/index.js

@@ -0,0 +1,5 @@
+// Barrel for the browse-TUI state layer.
+export { initialBrowseState } from "./init.js";
+export { reducer } from "./reducer.js";
+export { activeFilterSummary, filteredRows, nextKind, nextOutcome, nextProject, nextSince, } from "./selectors.js";
+//# sourceMappingURL=index.js.map

package/dist/extensions/forgecli/transcripts-tui/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/extensions/forgecli/transcripts-tui/state/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AAWzC,OAAO,EAA0B,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EACN,mBAAmB,EACnB,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,WAAW,EACX,SAAS,GACT,MAAM,gBAAgB,CAAC"}

package/dist/extensions/forgecli/transcripts-tui/state/init.d.ts

@@ -0,0 +1,8 @@
+import type { BrowseState, ListRow } from "./model.js";
+export interface BrowseInitOptions {
+    rows: ListRow[];
+    knownProjects: string[];
+    /** Test seam; defaults to Date.now(). */
+    now?: number;
+}
+export declare function initialBrowseState(opts: BrowseInitOptions): BrowseState;

package/dist/extensions/forgecli/transcripts-tui/state/init.js

@@ -0,0 +1,18 @@
+// Initial browse state. Pure — the caller does the archive I/O
+// (collectListRows / readProjects) and hands the data in.
+export function initialBrowseState(opts) {
+    return {
+        // Most recent first, guaranteed here rather than trusted from the
+        // caller — ISO startedAt compares lexicographically as time.
+        rows: [...opts.rows].sort((a, b) => b.startedAt.localeCompare(a.startedAt)),
+        knownProjects: opts.knownProjects,
+        cursor: 0,
+        filters: { kind: "all", outcome: "all", projectKey: null, sinceDays: null },
+        searchActive: false,
+        searchQuery: "",
+        shouldExit: false,
+        selectedRunId: null,
+        now: opts.now ?? Date.now(),
+    };
+}
+//# sourceMappingURL=init.js.map

package/dist/extensions/forgecli/transcripts-tui/state/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../../../src/extensions/forgecli/transcripts-tui/state/init.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,0DAA0D;AAW1D,MAAM,UAAU,kBAAkB,CAAC,IAAuB;IACzD,OAAO;QACN,kEAAkE;QAClE,6DAA6D;QAC7D,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC3E,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,MAAM,EAAE,CAAC;QACT,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;QAC3E,YAAY,EAAE,KAAK;QACnB,WAAW,EAAE,EAAE;QACf,UAAU,EAAE,KAAK;QACjB,aAAa,EAAE,IAAI;QACnB,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE;KAC3B,CAAC;AACH,CAAC"}

package/dist/extensions/forgecli/transcripts-tui/state/model.d.ts

@@ -0,0 +1,56 @@
+import type { ListRow } from "../../commands/transcripts-command.js";
+export type { ListRow };
+export type KindFilter = "all" | "task" | "bug" | "sprint";
+export type OutcomeFilter = "all" | "complete" | "halted" | "error" | "incomplete" | "cancelled";
+/** Recency window in days; null = no limit. Cycles 7 → 30 → 90 → null. */
+export type SinceFilter = 7 | 30 | 90 | null;
+export interface BrowseFilters {
+    kind: KindFilter;
+    outcome: OutcomeFilter;
+    /** Project key to pin, or null for all projects. */
+    projectKey: string | null;
+    sinceDays: SinceFilter;
+}
+export interface BrowseState {
+    /** All archived runs, loaded once by the caller (I/O stays outside). */
+    rows: ListRow[];
+    /** Known project keys, cycle order for the project filter. */
+    knownProjects: string[];
+    /** Cursor index into filteredRows(state) — NOT into rows. */
+    cursor: number;
+    filters: BrowseFilters;
+    searchActive: boolean;
+    searchQuery: string;
+    shouldExit: boolean;
+    /** Set by select-run; the component surfaces it via onSelect. */
+    selectedRunId: string | null;
+    /** Captured at init so the since-filter cutoff is pure + testable. */
+    now: number;
+}
+export type BrowseAction = {
+    kind: "cursor-move";
+    delta: number;
+} | {
+    kind: "cursor-clamp";
+    max: number;
+} | {
+    kind: "cycle-kind";
+} | {
+    kind: "cycle-outcome";
+} | {
+    kind: "cycle-project";
+} | {
+    kind: "cycle-since";
+} | {
+    kind: "enter-search";
+} | {
+    kind: "set-search";
+    query: string;
+} | {
+    kind: "exit-search";
+} | {
+    kind: "select-run";
+    runId: string;
+} | {
+    kind: "request-quit";
+};

package/dist/extensions/forgecli/transcripts-tui/state/model.js

@@ -0,0 +1,6 @@
+// Browse-TUI state model — pure data, no I/O (three-layer architecture).
+//
+// One screen (the run browser) plus an overlaid incremental-search mode, so
+// no view stack is needed — far simpler than config-tui's View[] stack.
+export {};
+//# sourceMappingURL=model.js.map

package/dist/extensions/forgecli/transcripts-tui/state/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../../../src/extensions/forgecli/transcripts-tui/state/model.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,EAAE;AACF,4EAA4E;AAC5E,wEAAwE"}

package/dist/extensions/forgecli/transcripts-tui/state/reducer.d.ts

@@ -0,0 +1,2 @@
+import type { BrowseAction, BrowseState } from "./model.js";
+export declare function reducer(state: BrowseState, action: BrowseAction): BrowseState;

package/dist/extensions/forgecli/transcripts-tui/state/reducer.js

@@ -0,0 +1,51 @@
+// Pure (state, action) → state reducer for the browse TUI.
+//
+// Cursor lower-bound clamps here; the UPPER bound depends on
+// filteredRows().length, which the component knows — it dispatches an
+// explicit cursor-clamp after every state change (mirrors config-tui's
+// documented reducer/component split).
+import { nextKind, nextOutcome, nextProject, nextSince } from "./selectors.js";
+export function reducer(state, action) {
+    switch (action.kind) {
+        case "cursor-move":
+            return { ...state, cursor: Math.max(0, state.cursor + action.delta) };
+        case "cursor-clamp":
+            return { ...state, cursor: Math.max(0, Math.min(state.cursor, action.max)) };
+        case "cycle-kind":
+            return {
+                ...state,
+                cursor: 0,
+                filters: { ...state.filters, kind: nextKind(state.filters.kind) },
+            };
+        case "cycle-outcome":
+            return {
+                ...state,
+                cursor: 0,
+                filters: { ...state.filters, outcome: nextOutcome(state.filters.outcome) },
+            };
+        case "cycle-project":
+            return {
+                ...state,
+                cursor: 0,
+                filters: { ...state.filters, projectKey: nextProject(state.filters.projectKey, state.knownProjects) },
+            };
+        case "cycle-since":
+            return {
+                ...state,
+                cursor: 0,
+                filters: { ...state.filters, sinceDays: nextSince(state.filters.sinceDays) },
+            };
+        case "enter-search":
+            return { ...state, searchActive: true };
+        case "set-search":
+            // Query change invalidates the selection — reset to the top match.
+            return { ...state, searchQuery: action.query, cursor: 0 };
+        case "exit-search":
+            return { ...state, searchActive: false };
+        case "select-run":
+            return { ...state, selectedRunId: action.runId, shouldExit: true };
+        case "request-quit":
+            return { ...state, shouldExit: true };
+    }
+}
+//# sourceMappingURL=reducer.js.map

package/dist/extensions/forgecli/transcripts-tui/state/reducer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reducer.js","sourceRoot":"","sources":["../../../../../src/extensions/forgecli/transcripts-tui/state/reducer.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,EAAE;AACF,6DAA6D;AAC7D,sEAAsE;AACtE,uEAAuE;AACvE,uCAAuC;AAGvC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE/E,MAAM,UAAU,OAAO,CAAC,KAAkB,EAAE,MAAoB;IAC/D,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,aAAa;YACjB,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACvE,KAAK,cAAc;YAClB,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QAC9E,KAAK,YAAY;YAChB,OAAO;gBACN,GAAG,KAAK;gBACR,MAAM,EAAE,CAAC;gBACT,OAAO,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;aACjE,CAAC;QACH,KAAK,eAAe;YACnB,OAAO;gBACN,GAAG,KAAK;gBACR,MAAM,EAAE,CAAC;gBACT,OAAO,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;aAC1E,CAAC;QACH,KAAK,eAAe;YACnB,OAAO;gBACN,GAAG,KAAK;gBACR,MAAM,EAAE,CAAC;gBACT,OAAO,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,aAAa,CAAC,EAAE;aACrG,CAAC;QACH,KAAK,aAAa;YACjB,OAAO;gBACN,GAAG,KAAK;gBACR,MAAM,EAAE,CAAC;gBACT,OAAO,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE;aAC5E,CAAC;QACH,KAAK,cAAc;YAClB,OAAO,EAAE,GAAG,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;QACzC,KAAK,YAAY;YAChB,mEAAmE;YACnE,OAAO,EAAE,GAAG,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAC3D,KAAK,aAAa;YACjB,OAAO,EAAE,GAAG,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;QAC1C,KAAK,YAAY;YAChB,OAAO,EAAE,GAAG,KAAK,EAAE,aAAa,EAAE,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;QACpE,KAAK,cAAc;YAClB,OAAO,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IACxC,CAAC;AACF,CAAC"}

package/dist/extensions/forgecli/transcripts-tui/state/selectors.d.ts

@@ -0,0 +1,10 @@
+import type { BrowseState, KindFilter, ListRow, OutcomeFilter, SinceFilter } from "./model.js";
+export declare function filteredRows(state: BrowseState): ListRow[];
+/** Header line summarizing the active filters, e.g.
+ *  "kind:bug · outcome:all · project:Cartographer · since:7d · /cart". */
+export declare function activeFilterSummary(state: BrowseState): string;
+export declare function nextKind(current: KindFilter): KindFilter;
+export declare function nextOutcome(current: OutcomeFilter): OutcomeFilter;
+export declare function nextSince(current: SinceFilter): SinceFilter;
+/** null → first known project → … → last → null. */
+export declare function nextProject(current: string | null, known: string[]): string | null;

package/dist/extensions/forgecli/transcripts-tui/state/selectors.js

@@ -0,0 +1,62 @@
+// Pure read helpers over BrowseState. filteredRows is the single source of
+// truth for what's visible — the screen renders it and the component's
+// Enter handler indexes into it, so cursor↔row mapping can never drift.
+export function filteredRows(state) {
+    const { kind, outcome, projectKey, sinceDays } = state.filters;
+    const cutoff = sinceDays === null ? null : new Date(state.now - sinceDays * 86_400_000).toISOString();
+    const query = state.searchQuery.trim().toLowerCase();
+    return state.rows.filter((row) => {
+        if (kind !== "all" && row.entityKind !== kind)
+            return false;
+        if (outcome !== "all" && row.outcome !== outcome)
+            return false;
+        if (projectKey !== null && row.projectKey !== projectKey)
+            return false;
+        if (cutoff !== null && row.startedAt < cutoff)
+            return false;
+        if (query) {
+            const haystack = `${row.entityId} ${row.sprintId ?? ""} ${row.projectName}`.toLowerCase();
+            if (!haystack.includes(query))
+                return false;
+        }
+        return true;
+    });
+}
+/** Header line summarizing the active filters, e.g.
+ *  "kind:bug · outcome:all · project:Cartographer · since:7d · /cart". */
+export function activeFilterSummary(state) {
+    const { kind, outcome, projectKey, sinceDays } = state.filters;
+    const parts = [
+        `kind:${kind}`,
+        `outcome:${outcome}`,
+        `project:${projectKey ?? "all"}`,
+        `since:${sinceDays === null ? "all" : `${sinceDays}d`}`,
+    ];
+    if (state.searchQuery)
+        parts.push(`/${state.searchQuery}`);
+    return parts.join(" · ");
+}
+const KIND_CYCLE = ["all", "task", "bug", "sprint"];
+const OUTCOME_CYCLE = ["all", "complete", "halted", "error", "incomplete", "cancelled"];
+const SINCE_CYCLE = [null, 7, 30, 90];
+export function nextKind(current) {
+    return KIND_CYCLE[(KIND_CYCLE.indexOf(current) + 1) % KIND_CYCLE.length];
+}
+export function nextOutcome(current) {
+    return OUTCOME_CYCLE[(OUTCOME_CYCLE.indexOf(current) + 1) % OUTCOME_CYCLE.length];
+}
+export function nextSince(current) {
+    return SINCE_CYCLE[(SINCE_CYCLE.indexOf(current) + 1) % SINCE_CYCLE.length];
+}
+/** null → first known project → … → last → null. */
+export function nextProject(current, known) {
+    if (known.length === 0)
+        return null;
+    if (current === null)
+        return known[0];
+    const idx = known.indexOf(current);
+    if (idx < 0 || idx === known.length - 1)
+        return null;
+    return known[idx + 1];
+}
+//# sourceMappingURL=selectors.js.map

package/dist/extensions/forgecli/transcripts-tui/state/selectors.js.map

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

package/dist/extensions/forgecli/transcripts-tui/theme.d.ts

@@ -0,0 +1,20 @@
+import type { Theme } from "@earendil-works/pi-coding-agent";
+export type { Theme };
+/** Horizontal rule spanning the full width, themed as a border. */
+export declare function rule(width: number, theme: Theme): string;
+export declare function cursor(isSelected: boolean, theme: Theme): string;
+export declare function muted(text: string, theme: Theme): string;
+export declare function accent(text: string, theme: Theme): string;
+export declare function accentBold(text: string, theme: Theme): string;
+/**
+ * Truncate a potentially-ANSI string to a visible width, padding with
+ * spaces if shorter. ANSI-safe column alignment (Iron Law 10).
+ */
+export declare function padOrTruncate(text: string, width: number): string;
+/**
+ * Truncate every line to the given visible width. Final safety guard in
+ * every screen's render (Iron Law 2, layer 1).
+ */
+export declare function truncateLines(lines: string[], width: number): string[];
+/** Alias matching the config-tui screens/shared.ts vocabulary. */
+export declare function safeLines(lines: string[], width: number): string[];

package/dist/extensions/forgecli/transcripts-tui/theme.js

@@ -0,0 +1,47 @@
+// Transcripts-TUI theme helpers — wraps pi Theme for consistent styling.
+//
+// Local copies of the handful of helpers this TUI needs (config-tui keeps
+// its own set; copying ~6 trivial theme-only helpers avoids cross-TUI
+// coupling — see forge-cli-ui-engineer skill, module layout).
+//
+// Every render function receives a Theme instance and routes all visible
+// text through these helpers or theme.fg/bg/bold directly (Iron Law 1).
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+/** Horizontal rule spanning the full width, themed as a border. */
+export function rule(width, theme) {
+    return theme.fg("border", "─".repeat(Math.max(1, width)));
+}
+export function cursor(isSelected, theme) {
+    return isSelected ? theme.fg("accent", "▸") : " ";
+}
+export function muted(text, theme) {
+    return theme.fg("muted", text);
+}
+export function accent(text, theme) {
+    return theme.fg("accent", text);
+}
+export function accentBold(text, theme) {
+    return theme.fg("accent", theme.bold(text));
+}
+/**
+ * Truncate a potentially-ANSI string to a visible width, padding with
+ * spaces if shorter. ANSI-safe column alignment (Iron Law 10).
+ */
+export function padOrTruncate(text, width) {
+    const vis = visibleWidth(text);
+    if (vis >= width)
+        return truncateToWidth(text, width, "");
+    return text + " ".repeat(width - vis);
+}
+/**
+ * Truncate every line to the given visible width. Final safety guard in
+ * every screen's render (Iron Law 2, layer 1).
+ */
+export function truncateLines(lines, width) {
+    return lines.map((line) => truncateToWidth(line, width, ""));
+}
+/** Alias matching the config-tui screens/shared.ts vocabulary. */
+export function safeLines(lines, width) {
+    return truncateLines(lines, width);
+}
+//# sourceMappingURL=theme.js.map

package/dist/extensions/forgecli/transcripts-tui/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/transcripts-tui/theme.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,EAAE;AACF,0EAA0E;AAC1E,sEAAsE;AACtE,8DAA8D;AAC9D,EAAE;AACF,yEAAyE;AACzE,wEAAwE;AAGxE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAIvE,mEAAmE;AACnE,MAAM,UAAU,IAAI,CAAC,KAAa,EAAE,KAAY;IAC/C,OAAO,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,UAAmB,EAAE,KAAY;IACvD,OAAO,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,IAAY,EAAE,KAAY;IAC/C,OAAO,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,KAAY;IAChD,OAAO,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,KAAY;IACpD,OAAO,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,KAAa;IACxD,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,GAAG,IAAI,KAAK;QAAE,OAAO,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;IAC1D,OAAO,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAe,EAAE,KAAa;IAC3D,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,SAAS,CAAC,KAAe,EAAE,KAAa;IACvD,OAAO,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACpC,CAAC"}

package/dist/extensions/forgecli/tui/banner.d.ts

@@ -0,0 +1,10 @@
+export interface ProjectMeta {
+    name: string;
+    prefix: string;
+}
+/**
+ * Read project.name and project.prefix from a `.forge/config.json` path.
+ * Returns null when the file is missing, unreadable, malformed, or lacks
+ * the required fields. Never throws.
+ */
+export declare function readProjectMeta(configPath: string): ProjectMeta | null;

package/dist/extensions/forgecli/tui/banner.js

@@ -0,0 +1,36 @@
+// Banner helpers — reads .forge/config.json for project metadata.
+//
+// Pure utility module; no side effects on import.
+import * as fs from "node:fs";
+/**
+ * Read project.name and project.prefix from a `.forge/config.json` path.
+ * Returns null when the file is missing, unreadable, malformed, or lacks
+ * the required fields. Never throws.
+ */
+export function readProjectMeta(configPath) {
+    let raw;
+    try {
+        raw = fs.readFileSync(configPath, "utf8");
+    }
+    catch {
+        return null;
+    }
+    let config;
+    try {
+        config = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (!config || typeof config !== "object")
+        return null;
+    const cfg = config;
+    const name = cfg.project?.name;
+    const prefix = cfg.project?.prefix;
+    if (typeof name !== "string" || name.length === 0)
+        return null;
+    if (typeof prefix !== "string" || prefix.length === 0)
+        return null;
+    return { name, prefix };
+}
+//# sourceMappingURL=banner.js.map

package/dist/extensions/forgecli/tui/banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/tui/banner.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,EAAE;AACF,kDAAkD;AAElD,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAc9B;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB;IACjD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACJ,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACJ,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;IAED,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAEvD,MAAM,GAAG,GAAG,MAAqB,CAAC;IAClC,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC;IAC/B,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC;IAEnC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/D,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEnE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AACzB,CAAC"}

package/dist/extensions/forgecli/tui/forge-header.d.ts

@@ -0,0 +1,12 @@
+import type { Theme } from "@earendil-works/pi-coding-agent";
+import type { Component } from "@earendil-works/pi-tui";
+import { type TUI } from "@earendil-works/pi-tui";
+export interface ForgeHeader extends Component {
+    dispose?(): void;
+    setStartupDone(): void;
+}
+export declare function createForgeHeader(versions: {
+    cliVersion: string;
+    bundledForgeVersion: string;
+    piVersion: string;
+}): (tui: TUI, theme: Theme) => ForgeHeader;

package/dist/extensions/forgecli/tui/forge-header.js

@@ -0,0 +1,114 @@
+// forge-header.ts — branded header component with animated startup loader.
+//
+// Renders an animated "kindling forge" spinner during session_start, then
+// transitions to the full ANSI-Shadow logo + keybinding hints once startup
+// tasks are complete. The caller calls setStartupDone() to trigger the swap.
+import { keyHint, keyText, rawKeyHint } from "@earendil-works/pi-coding-agent";
+import { Container, Loader, Spacer, Text } from "@earendil-works/pi-tui";
+const SPINNER_FRAMES = ["⠋", "⠙", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+const LOGO_SEP_WIDTH = 46;
+const LOGO_LINES_FORGE = [
+    "███████╗  ██████╗ ██████╗   ██████╗ ███████╗",
+    "██╔════╝ ██╔═══██╗██╔══██╗ ██╔════╝ ██╔════╝",
+    "█████╗   ██║   ██║██████╔╝ ██║  ███╗█████╗  ",
+    "██╔══╝   ██║   ██║██╔══██╗ ██║   ██║██╔══╝  ",
+    "██║      ╚██████╔╝██║  ██║ ╚██████╔╝███████╗",
+    "╚═╝       ╚═════╝ ╚═╝  ╚═╝  ╚═════╝ ╚══════╝",
+];
+const LOGO_LINES = [
+    "     ▄██                     ",
+    "   ▄█▀██   ▄▄▄▄▄▄▄   ▄▄▄▄▄▄▄ ",
+    " ▄█▀  ██  ██     ██ ██     ██",
+    "██▄▄▄▄██▄ ▀█▄▄▄▄▄██ ██▀▀▀▀▀▀▀",
+    "      ██         ██ ▀█▄▄▄▄▄█▀",
+    "      ▀▀  ▀▀▀▀▀▀▀▀           ",
+];
+class ExpandableText extends Text {
+    getCollapsedText;
+    getExpandedText;
+    constructor(getCollapsedText, getExpandedText, expanded = false, paddingX = 0, paddingY = 0) {
+        super(expanded ? getExpandedText() : getCollapsedText(), paddingX, paddingY);
+        this.getCollapsedText = getCollapsedText;
+        this.getExpandedText = getExpandedText;
+    }
+    setExpanded(expanded) {
+        this.setText(expanded ? this.getExpandedText() : this.getCollapsedText());
+    }
+}
+class ForgeHeaderContainer extends Container {
+    tui;
+    loader;
+    builtInHeader;
+    done = false;
+    constructor(tui, theme, versions) {
+        super();
+        this.tui = tui;
+        // ── Loading state ──────────────────────────────────────────────────────
+        this.loader = new Loader(tui, (s) => theme.bold(theme.fg("accent", s)), (s) => "  " + theme.fg("muted", s), "kindling forge", { frames: SPINNER_FRAMES, intervalMs: 80 });
+        // ── Static state ───────────────────────────────────────────────────────
+        const asciiLogo = LOGO_LINES.map((line) => theme.bold(theme.fg("accent", line))).join("\n");
+        const sep = theme.fg("dim", "─".repeat(LOGO_SEP_WIDTH));
+        const versionLine = "  " +
+            theme.bold(theme.fg("accent", "Forge")) +
+            " " +
+            theme.fg("dim", `v${versions.cliVersion}`) +
+            "  " +
+            theme.fg("dim", `(forgecli v${versions.cliVersion}, forge-plugin v${versions.bundledForgeVersion}, pi v${versions.piVersion})`);
+        const logoBlock = `\n${asciiLogo}\n${sep}\n${versionLine}`;
+        const hint = (keybinding, description) => keyHint(keybinding, description);
+        const dot = theme.fg("muted", " · ");
+        const expandedInstructions = [
+            hint("app.interrupt", "to interrupt"),
+            hint("app.clear", "to clear"),
+            rawKeyHint(`${keyText("app.clear")} twice`, "to exit"),
+            hint("app.exit", "to exit (empty)"),
+            hint("app.suspend", "to suspend"),
+            keyHint("tui.editor.deleteToLineEnd", "to delete to end"),
+            hint("app.thinking.cycle", "to cycle thinking level"),
+            rawKeyHint(`${keyText("app.model.cycleForward")}/${keyText("app.model.cycleBackward")}`, "to cycle models"),
+            hint("app.model.select", "to select model"),
+            hint("app.tools.expand", "to expand tools"),
+            hint("app.thinking.toggle", "to expand thinking"),
+            hint("app.editor.external", "for external editor"),
+            rawKeyHint("/", "for commands"),
+            rawKeyHint("!", "to run bash"),
+            rawKeyHint("!!", "to run bash (no context)"),
+            hint("app.message.followUp", "to queue follow-up"),
+            hint("app.message.dequeue", "to edit all queued messages"),
+            hint("app.clipboard.pasteImage", "to paste image"),
+            rawKeyHint("drop files", "to attach"),
+        ].join("\n");
+        const compactInstructions = [
+            hint("app.interrupt", "interrupt"),
+            rawKeyHint(`${keyText("app.clear")}/${keyText("app.exit")}`, "clear/exit"),
+            rawKeyHint("/", "commands"),
+            rawKeyHint("!", "bash"),
+            hint("app.tools.expand", "more"),
+        ].join(dot);
+        const compactOnboarding = theme.fg("dim", `Press ${keyText("app.tools.expand")} to show full startup help and loaded resources.`);
+        const onboarding = theme.fg("dim", "Pi can explain its own features and look up its docs. Ask it how to use or extend Pi.");
+        this.builtInHeader = new ExpandableText(() => `${logoBlock}\n${compactInstructions}\n${compactOnboarding}\n\n${onboarding}`, () => `${logoBlock}\n${expandedInstructions}\n\n${onboarding}`, false, 1, 0);
+        this.addChild(this.loader);
+        this.addChild(new Spacer(1));
+        this.loader.start();
+    }
+    setStartupDone() {
+        if (this.done)
+            return;
+        this.done = true;
+        this.loader.stop();
+        this.clear();
+        this.addChild(this.builtInHeader);
+        this.addChild(new Spacer(1));
+        this.tui.requestRender();
+    }
+    dispose() {
+        this.loader.stop();
+    }
+}
+export function createForgeHeader(versions) {
+    return (tui, theme) => {
+        return new ForgeHeaderContainer(tui, theme, versions);
+    };
+}
+//# sourceMappingURL=forge-header.js.map

package/dist/extensions/forgecli/tui/forge-header.js.map

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

package/dist/extensions/forgecli/tui/input-router.d.ts

@@ -0,0 +1,33 @@
+export type RouterResult = {
+    consume?: boolean;
+    data?: string;
+} | undefined;
+export type RouterListener = (data: string) => RouterResult;
+export interface RegisterOptions {
+    /** Stable name for debugging and unsubscription tracking. */
+    name: string;
+    /** When true, this listener is bypassed while any overlay is active.
+     *  Use for keys that "activate" a widget (e.g. ↓ to open a strip) — the
+     *  overlay needs the same key for navigation. Default: false. */
+    skipWhenOverlayActive?: boolean;
+}
+export declare class ForgeInputRouter {
+    private listeners;
+    private overlayDepth;
+    register(listener: RouterListener, opts: RegisterOptions): () => void;
+    pushOverlay(): void;
+    popOverlay(): void;
+    isOverlayActive(): boolean;
+    /**
+     * Mirrors pi's listener-chain semantics (tui.ts:544-560):
+     * - Each listener may return { consume: true } to stop dispatch.
+     * - Each listener may return { data: rewritten } to alter the value the
+     *   next listener (and ultimately the focused overlay) sees.
+     * - Listeners flagged skipWhenOverlayActive=true are silently bypassed
+     *   whenever overlayDepth > 0.
+     */
+    dispatch(data: string): RouterResult;
+}
+export declare function getInputRouter(): ForgeInputRouter;
+/** Test helper — replace the singleton with a fresh router. */
+export declare function __resetInputRouterForTesting(): void;