@posthog/wizard 2.16.0 → 2.16.1

package/dist/{slides-Dpj4j0w_.js → slides-CL1mv_Kq.js}

@@ -1,11 +1,11 @@
-import { g as SERVICE_LABELS, s as logToFile } from "./debug-C4jRuzny.js";
+import { g as SERVICE_LABELS, s as logToFile } from "./debug-ubpO6102.js";
 import { n as isTaskStatus } from "./wizard-ui-YdGFRyu_.js";
-import { n as analytics, r as sessionProperties } from "./analytics-DZaUgJte.js";
-import { i as buildSession } from "./wizard-session-Bi95IYca.js";
-import { _ as AUDIT_SEVERITY_STYLE } from "./agent-interface-pBnqJL8P.js";
-import { a as isObjectBlock, i as isLinesBlock, n as computeVisibleRange, o as Colors, r as isClearBlock, s as Icons, t as TextBlock } from "./TextBlock-DJVhBkr3.js";
-import { n as Program, r as getProgramConfig, s as getKindMeta, t as PROGRAM_REGISTRY } from "./bin.js";
-import { n as AVAILABLE_FEATURES, t as ALL_FEATURE_VALUES } from "./defaults-GbLPuHxj.js";
+import { n as sessionProperties, t as analytics } from "./analytics-DUuUurR3.js";
+import { i as buildSession } from "./wizard-session-gsn8Z3bZ.js";
+import { _ as AUDIT_SEVERITY_STYLE } from "./agent-interface-B4eUlMso.js";
+import { a as isObjectBlock, i as isLinesBlock, n as computeVisibleRange, o as Colors, r as isClearBlock, s as Icons, t as TextBlock } from "./TextBlock-CdeZog_6.js";
+import { a as getProgramConfig, i as Program, l as getKindMeta, r as PROGRAM_REGISTRY } from "./bin.js";
+import { n as AVAILABLE_FEATURES, t as ALL_FEATURE_VALUES } from "./defaults-zrYmZ2ID.js";
 import * as fs$1 from "fs";
 import { Box, Text, measureElement, useInput, useStdout } from "ink";
 import { Component, Fragment, createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
@@ -487,9 +487,15 @@ var WizardStore = class {
 		this.emitChange();
 	}
 	setDashboardUrl(url) {
+		logToFile(`store.setDashboardUrl: ${url}`);
 		this.$session.setKey("dashboardUrl", url);
 		this.emitChange();
 	}
+	setNotebookUrl(url) {
+		logToFile(`store.setNotebookUrl: ${url}`);
+		this.$session.setKey("notebookUrl", url);
+		this.emitChange();
+	}
 	setFrameworkContext(key, value) {
 		const ctx = {
 			...this.$session.get().frameworkContext,
@@ -786,22 +792,18 @@ function deduplicateAndSort(hints) {
 * KeyboardHintsProvider — Context for collecting and displaying keyboard hints.
 *
 * Input components register their hints via useKeyBindings. The provider
-* flattens, deduplicates, and sorts them. It auto-dismisses 3s after the
-* first keypress and resets when the hint set changes (screen navigation).
+* flattens, deduplicates, and sorts them. The hints bar stays visible for as
+* long as a screen has registered hints — it never auto-dismisses.
 */
 const KeyboardHintsContext = createContext({
 	register: () => void 0,
 	unregister: () => void 0,
-	hints: [],
-	visible: false
+	hints: []
 });
 const useKeyboardHintsContext = () => useContext(KeyboardHintsContext);
-const DISMISS_DELAY = 3e3;
 const KeyboardHintsProvider = ({ children }) => {
 	const registrationsRef = useRef(/* @__PURE__ */ new Map());
 	const [hints, setHints] = useState([]);
-	const [visible, setVisible] = useState(true);
-	const timerRef = useRef(null);
 	const prevHintsKeyRef = useRef("");
 	const recompute = useCallback(() => {
 		const all = [];
@@ -811,13 +813,6 @@ const KeyboardHintsProvider = ({ children }) => {
 		if (newKey !== prevHintsKeyRef.current) {
 			prevHintsKeyRef.current = newKey;
 			setHints(deduped);
-			if (newKey.length > 0) {
-				setVisible(true);
-				if (timerRef.current) {
-					clearTimeout(timerRef.current);
-					timerRef.current = null;
-				}
-			}
 		}
 	}, []);
 	const register = useCallback((id, h) => {
@@ -828,25 +823,11 @@ const KeyboardHintsProvider = ({ children }) => {
 		registrationsRef.current.delete(id);
 		recompute();
 	}, [recompute]);
-	useInput(() => {
-		if (!visible) return;
-		if (timerRef.current) return;
-		timerRef.current = setTimeout(() => {
-			setVisible(false);
-			timerRef.current = null;
-		}, DISMISS_DELAY);
-	});
-	useEffect(() => {
-		return () => {
-			if (timerRef.current) clearTimeout(timerRef.current);
-		};
-	}, []);
 	return /* @__PURE__ */ jsx(KeyboardHintsContext.Provider, {
 		value: {
 			register,
 			unregister,
-			hints,
-			visible
+			hints
 		},
 		children
 	});
@@ -1457,40 +1438,92 @@ const ModalOverlay = ({ borderColor, title, titleColor, width = 68, children, fe
 /**
 * LogViewer — Real-time log tail, pinned to available terminal height.
 * Only renders the last N lines that fit on screen.
+*
+* Reads only the last TAIL_BYTES of the file on each refresh and throttles
+* fs.watch callbacks to one refresh per WATCH_THROTTLE_MS. Without this,
+* fs.readFileSync allocates a string the size of the entire log on every
+* append — during subagent fan-out that's tens of writes per second against
+* a log that grows into the hundreds of MB, producing OOM-grade allocation
+* pressure on V8's heap.
 */
 /** Rows consumed by TitleBar + spacer + ScreenContainer padding + status bar + tab bar */
 const CHROME_ROWS$1 = 8;
+/** Bytes read from the end of the log per refresh — large enough to contain
+*  any practical visible window of lines, small enough to allocate cheaply. */
+const TAIL_BYTES = 256 * 1024;
+/** Minimum gap between watch-triggered refreshes. fs.watch fires on every
+*  append */
+const WATCH_THROTTLE_MS = 250;
+function readTailLines(filePath, visibleLines) {
+	const stat = fs$1.statSync(filePath);
+	if (stat.size === 0) return [];
+	const start = Math.max(0, stat.size - TAIL_BYTES);
+	const length = stat.size - start;
+	const buf = Buffer.alloc(length);
+	const fd = fs$1.openSync(filePath, "r");
+	try {
+		fs$1.readSync(fd, buf, 0, length, start);
+	} finally {
+		fs$1.closeSync(fd);
+	}
+	let text = buf.toString("utf-8");
+	if (start > 0) {
+		const firstNewline = text.indexOf("\n");
+		if (firstNewline >= 0) text = text.slice(firstNewline + 1);
+	}
+	return text.split("\n").slice(-visibleLines);
+}
 const LogViewer = ({ filePath, height }) => {
 	const [, rows] = useStdoutDimensions();
 	const visibleLines = height ?? Math.max(5, rows - CHROME_ROWS$1);
 	const [lines, setLines] = useState([]);
 	useEffect(() => {
+		let lastReadAt = 0;
+		let pendingTimer;
 		const readTail = () => {
 			try {
-				setLines(fs$1.readFileSync(filePath, "utf-8").split("\n").slice(-visibleLines));
+				setLines(readTailLines(filePath, visibleLines));
 			} catch {
 				setLines(["(No log file found)"]);
 			}
 		};
+		const scheduleRead = () => {
+			const now = Date.now();
+			const elapsed = now - lastReadAt;
+			if (elapsed >= WATCH_THROTTLE_MS) {
+				lastReadAt = now;
+				readTail();
+				return;
+			}
+			if (pendingTimer) return;
+			pendingTimer = setTimeout(() => {
+				pendingTimer = void 0;
+				lastReadAt = Date.now();
+				readTail();
+			}, WATCH_THROTTLE_MS - elapsed);
+		};
 		readTail();
+		lastReadAt = Date.now();
 		let watcher;
 		try {
-			watcher = fs$1.watch(filePath, () => {
-				readTail();
-			});
+			watcher = fs$1.watch(filePath, () => scheduleRead());
 		} catch {
 			const interval = setInterval(() => {
 				try {
 					fs$1.accessSync(filePath);
 					readTail();
 					clearInterval(interval);
-					watcher = fs$1.watch(filePath, () => readTail());
+					watcher = fs$1.watch(filePath, () => scheduleRead());
 				} catch {}
 			}, 1e3);
-			return () => clearInterval(interval);
+			return () => {
+				clearInterval(interval);
+				if (pendingTimer) clearTimeout(pendingTimer);
+			};
 		}
 		return () => {
 			watcher?.close();
+			if (pendingTimer) clearTimeout(pendingTimer);
 		};
 	}, [filePath, visibleLines]);
 	return /* @__PURE__ */ jsx(Box, {
@@ -1672,16 +1705,15 @@ const DissolveTransition = ({ transitionKey, width, height, children, direction
 /**
 * KeyboardHintsBar — Row showing active keyboard shortcuts.
 *
-* Always reserves its row to prevent layout shift. When hints are
-* visible, renders them in dimmed grey text. When dismissed, renders
-* an empty reserved row.
+* Always reserves its row to prevent layout shift, and always renders the
+* active hints (in dimmed grey text) while a screen has registered them.
 */
 const KeyboardHintsBar = () => {
-	const { hints, visible } = useKeyboardHintsContext();
+	const { hints } = useKeyboardHintsContext();
 	return /* @__PURE__ */ jsx(Box, {
 		height: 1,
 		paddingX: 1,
-		children: visible && hints.length > 0 && hints.map((hint, i) => /* @__PURE__ */ jsxs(Box, {
+		children: hints.map((hint, i) => /* @__PURE__ */ jsxs(Box, {
 			marginRight: i < hints.length - 1 ? 2 : 0,
 			children: [/* @__PURE__ */ jsx(Text, {
 				bold: true,
@@ -3837,11 +3869,83 @@ const EventCaptureSlide = {
 	docsUrl: "https://posthog.com/docs/product-analytics/capture-events"
 };
 //#endregion
+//#region src/ui/tui/screens/audit/slides/writeReport.tsx
+const ReportVisual = () => /* @__PURE__ */ jsxs(VisualBox, { children: [
+	/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "posthog-audit-report.md"
+	}),
+	/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "  # "
+	}), /* @__PURE__ */ jsx(Text, { children: "Summary" })] }),
+	/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "  # "
+	}), /* @__PURE__ */ jsx(Text, { children: "Recommended actions" })] }),
+	/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "  # "
+	}), /* @__PURE__ */ jsx(Text, { children: "Full audit" })] })
+] });
+const WriteReportSlide = {
+	area: "Write report",
+	intro: [
+		"Now we write an audit report at ./posthog-audit-report.md. that summarizes our findings.",
+		"The report leads with a summary, then a prioritized list of fixes with file:line citations, then every check we ran grouped by area so nothing is hidden.",
+		"We will upload the report into a PostHog notebook in the next step."
+	],
+	visual: /* @__PURE__ */ jsx(ReportVisual, {}),
+	docsUrl: "https://posthog.com/docs/product-analytics/best-practices"
+};
+//#endregion
+//#region src/ui/tui/screens/audit/slides/uploadNotebook.tsx
+const NotebookVisual = () => /* @__PURE__ */ jsxs(VisualBox, { children: [
+	/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "posthog-audit-report.md"
+	}),
+	/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "  │"
+	}),
+	/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "  ▼ "
+	}), /* @__PURE__ */ jsx(Text, {
+		color: "cyan",
+		children: "PostHog notebook"
+	})] }),
+	/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "     # Summary"
+	}),
+	/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "     # Recommended actions"
+	}),
+	/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "     # Full audit"
+	})
+] });
+//#endregion
 //#region src/ui/tui/screens/audit/slides/index.ts
 const AUDIT_AREA_SLIDES = [
 	InstallationSlide,
 	IdentificationSlide,
-	EventCaptureSlide
+	EventCaptureSlide,
+	WriteReportSlide,
+	{
+		area: "Upload notebook",
+		intro: [
+			"Next we upload the report into a PostHog notebook so you can share it with your team as a URL.",
+			"Hang tight.",
+			"The markdown file on disk is still there for you to read locally."
+		],
+		visual: /* @__PURE__ */ jsx(NotebookVisual, {}),
+		docsUrl: "https://posthog.com/docs/notebooks"
+	}
 ];
 //#endregion
 //#region src/ui/tui/screens/audit-3000/slides/eventQuality.tsx
@@ -4014,6 +4118,6 @@ const AUDIT_3000_AREA_SLIDES = [
 	}
 ];
 //#endregion
-export { PickerMenu as C, SplitView as D, LoadingBox as E, CardLayout as O, useStdoutDimensions as S, ProgressList as T, EventPlanViewer as _, TAILORED_ROLES as a, ConfirmationInput as b, SEVERITY_LABEL as c, TipsCard as d, LearnCard as f, ScreenContainer as g, TabContainer as h, McpSuggestedPromptsScreen as i, WizardStore as k, SEVERITY_ORDER as l, HNViewer as m, AUDIT_AREA_SLIDES as n, McpScreen as o, ContentSequencer as p, AuditChecksViewer as r, IssueTable as s, AUDIT_3000_AREA_SLIDES as t, ServiceHealthList as u, LogViewer as v, useKeyBindings as w, GroupedPickerMenu as x, ModalOverlay as y };
+export { WizardStore as A, useStdoutDimensions as C, LoadingBox as D, ProgressList as E, SplitView as O, GroupedPickerMenu as S, useKeyBindings as T, ScreenContainer as _, McpSuggestedPromptsScreen as a, ModalOverlay as b, IssueTable as c, ServiceHealthList as d, TipsCard as f, TabContainer as g, HNViewer as h, AuditChecksViewer as i, CardLayout as k, SEVERITY_LABEL as l, ContentSequencer as m, AUDIT_AREA_SLIDES as n, TAILORED_ROLES as o, LearnCard as p, VisualBox as r, McpScreen as s, AUDIT_3000_AREA_SLIDES as t, SEVERITY_ORDER as u, EventPlanViewer as v, PickerMenu as w, ConfirmationInput as x, LogViewer as y };
 
-//# sourceMappingURL=slides-Dpj4j0w_.js.map
+//# sourceMappingURL=slides-CL1mv_Kq.js.map