pi-soly 2.2.7 → 2.3.2

package/commands/_helpers.ts

@@ -40,6 +40,9 @@ export interface CommandsDeps {
 	getConfig: () => SolyConfig;
 	reloadConfig: () => void;
 	getIntentDocs: () => IntentDoc[];
+	/** Record a soly event (any level). Everything goes through the
+	 *  Working sub-line — no popups at all. */
+	recordEvent: (text: string, level?: "info" | "warning" | "error") => void;
 }
 
 /** Open a focused list modal (overlay) for the given grouped items. */

package/commands/artifacts.ts

@@ -6,16 +6,16 @@ import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-c
 import { getArtifactServer, ensureArtifactServer, artifactDir } from "../artifact/session.ts";
 import { openListPanel, openExternally, type CommandsDeps } from "./_helpers.ts";
 
-type ArtifactsDeps = Pick<CommandsDeps, "getConfig">;
+type ArtifactsDeps = Pick<CommandsDeps, "getConfig" | "recordEvent">;
 
 export function registerArtifactsCommand(pi: ExtensionAPI, deps: ArtifactsDeps): void {
-	const { getConfig } = deps;
+	const { getConfig, recordEvent } = deps;
 
 	pi.registerCommand("artifacts", {
 		description: "browse this project's html_artifact gallery (list, open, clear)",
 		handler: async (args, ctx) => {
 			if (!getConfig().artifacts.server) {
-				ctx.ui.notify("soly: artifact server is disabled (artifacts.server=false)", "info");
+				recordEvent("artifact server is disabled (artifacts.server=false)");
 				return;
 			}
 			// Always re-resolve: reuse another window's server or start ours, and
@@ -27,7 +27,7 @@ export function registerArtifactsCommand(pi: ExtensionAPI, deps: ArtifactsDeps):
 				// ignore — handled by the count check below
 			}
 			if (!server || server.count === 0) {
-				ctx.ui.notify("soly: no artifacts for this project yet (use the html_artifact tool)", "info");
+				recordEvent("no artifacts for this project yet (use the html_artifact tool)");
 				return;
 			}
 			const gallery = server.galleryUrl();
@@ -35,15 +35,15 @@ export function registerArtifactsCommand(pi: ExtensionAPI, deps: ArtifactsDeps):
 
 			if (sub === "clear") {
 				const n = server.clear();
-				ctx.ui.notify(`soly: cleared ${n} artifact(s)`, "info");
+				recordEvent(`cleared ${n} artifact(s)`);
 				return;
 			}
 			if (sub === "open" || sub === "gallery") {
 				try {
 					await openExternally(pi, gallery);
-					ctx.ui.notify(`soly: opened ${gallery}`, "info");
+					recordEvent(`opened ${gallery}`);
 				} catch {
-					ctx.ui.notify(`soly artifacts gallery: ${gallery}`, "info");
+					recordEvent(`soly artifacts gallery: ${gallery}`);
 				}
 				return;
 			}
@@ -80,7 +80,7 @@ export function registerArtifactsCommand(pi: ExtensionAPI, deps: ArtifactsDeps):
 
 			// Non-TUI: print the list + gallery URL.
 			const lines = server.list().map((a) => `🖼 ${a.title} — ${a.url}`);
-			ctx.ui.notify([`soly artifacts gallery: ${gallery}`, "", ...lines].join("\n"), "info");
+			recordEvent([`soly artifacts gallery: ${gallery}`, "", ...lines].join("\n"));
 		},
 	});
 }

package/commands/docs.ts

@@ -7,10 +7,10 @@ import { formatTok, solyDirFor } from "../core.ts";
 import { buildIntentStats, formatIntentStats, loadInlineIntentBodies, type IntentInlineDoc } from "../intent.ts";
 import { openListPanel, type CommandUI, type CommandsDeps } from "./_helpers.ts";
 
-type DocsDeps = Pick<CommandsDeps, "getIntentDocs">;
+type DocsDeps = Pick<CommandsDeps, "getIntentDocs" | "recordEvent">;
 
 export function registerDocsCommand(pi: ExtensionAPI, deps: DocsDeps): void {
-	const { getIntentDocs } = deps;
+	const { getIntentDocs, recordEvent } = deps;
 
 	pi.registerCommand("docs", {
 		description: "manage soly intent docs (stats — show context breakdown)",
@@ -30,7 +30,7 @@ export function registerDocsCommand(pi: ExtensionAPI, deps: DocsDeps): void {
 			if (sub === "list") {
 				const docs = getIntentDocs();
 				if (docs.length === 0) {
-					ui.notify("no intent docs found in .agents/docs/ — drop your vision/domain docs there", "info");
+					recordEvent("no intent docs found in .agents/docs/ — drop your vision/domain docs there");
 					return;
 				}
 				if (ctx.mode === "tui") {
@@ -55,7 +55,7 @@ export function registerDocsCommand(pi: ExtensionAPI, deps: DocsDeps): void {
 					});
 					return;
 				}
-				ui.notify(docs.map((d) => `○ ${d.title || d.relPath} (${formatTok(d.tokens)} tok)`).join("\n"), "info");
+				recordEvent(docs.map((d) => `○ ${d.title || d.relPath} (${formatTok(d.tokens)} tok)`).join("\n"));
 				return;
 			}
 
@@ -63,11 +63,11 @@ export function registerDocsCommand(pi: ExtensionAPI, deps: DocsDeps): void {
 				const docs = getIntentDocs();
 				const inlineBodies: IntentInlineDoc[] = loadInlineIntentBodies(docs);
 				const stats = buildIntentStats(docs, inlineBodies);
-				ui.notify(formatIntentStats(stats), "info");
+				recordEvent(formatIntentStats(stats));
 				return;
 			}
 
-			ui.notify("Usage: /docs <list|stats>", "error");
+			recordEvent("Usage: /docs <list|stats>", "error");
 			void solyDirFor; // kept available for future subcommands
 		},
 	});

package/commands/rules.ts

@@ -30,10 +30,10 @@ function ruleItem(r: RuleFile): ListItem {
 	};
 }
 
-type RulesDeps = Pick<CommandsDeps, "getRules" | "getOverridden" | "refreshRules" | "updateStatus">;
+type RulesDeps = Pick<CommandsDeps, "getRules" | "getOverridden" | "refreshRules" | "updateStatus" | "recordEvent">;
 
 export function registerRulesCommand(pi: ExtensionAPI, deps: RulesDeps): void {
-	const { getRules, getOverridden, refreshRules, updateStatus } = deps;
+	const { getRules, getOverridden, refreshRules, updateStatus, recordEvent } = deps;
 
 	pi.registerCommand("rules", {
 		description: "manage soly rules (list, show, stats, analytics, reload, enable, disable)",
@@ -55,7 +55,7 @@ export function registerRulesCommand(pi: ExtensionAPI, deps: RulesDeps): void {
 				const rules = getRules();
 				const overridden = getOverridden();
 				if (rules.length === 0 && overridden.length === 0) {
-					ui.notify("soly: no rules loaded — check `.agents/rules/` or `~/.agents/rules/`", "warning");
+					recordEvent("no rules loaded — check `.agents/rules/` or `~/.agents/rules/`", "warning");
 					return;
 				}
 				// Rich modal in the TUI; plain select elsewhere (RPC/print).
@@ -85,63 +85,63 @@ export function registerRulesCommand(pi: ExtensionAPI, deps: RulesDeps): void {
 				for (const p of overridden) {
 					lines.push(`⊘ [overridden] ${p}`);
 				}
-				ui.notify(lines.join("\n"), "info");
+				recordEvent(lines.join("\n"));
 				return;
 			}
 
 			if (sub === "show") {
 				if (!target) {
-					ui.notify("Usage: /rules show <relPath>", "error");
+					recordEvent("Usage: /rules show <relPath>", "error");
 					return;
 				}
 				const r = getRules().find((x) => x.relPath === target);
 				if (!r) {
-					ui.notify(`Rule not found: ${target}`, "error");
+					recordEvent(`Rule not found: ${target}`, "error");
 					return;
 				}
 				const text = `---\n${r.meta.description ? `description: ${r.meta.description}\n` : ""}source: ${r.sourceLabel}\nenabled: ${r.enabled}\n---\n\n${r.body}`;
-				ui.notify(text, "info");
+				recordEvent(text);
 				return;
 			}
 
 			if (sub === "stats") {
 				const analytics = analyzeRules(getRules(), CONTEXT_WINDOW_TOKENS);
-				ui.notify(formatAnalyticsFull(analytics), "info");
+				recordEvent(formatAnalyticsFull(analytics));
 				return;
 			}
 
 			if (sub === "analytics") {
 				const rules = getRules();
 				const stats = buildRulesContextStats(rules, CONTEXT_WINDOW_TOKENS);
-				ui.notify(formatRulesContextStats(stats), "info");
+				recordEvent(formatRulesContextStats(stats));
 				return;
 			}
 
 			if (sub === "enable" || sub === "disable") {
 				if (!target) {
-					ui.notify(`Usage: /rules ${sub} <relPath>`, "error");
+					recordEvent(`Usage: /rules ${sub} <relPath>`, "error");
 					return;
 				}
 				const r = getRules().find((x) => x.relPath === target);
 				if (!r) {
-					ui.notify(`Rule not found: ${target}`, "error");
+					recordEvent(`Rule not found: ${target}`, "error");
 					return;
 				}
 				r.enabled = sub === "enable";
 				updateStatus(ui);
-				ui.notify(`Rule ${target}: ${sub}d`, "info");
+				recordEvent(`Rule ${target}: ${sub}d`);
 				return;
 			}
 
 			if (sub === "reload") {
 				refreshRules();
 				updateStatus(ui);
-				ui.notify(`Reloaded ${getRules().length} rules`, "info");
+				recordEvent(`Reloaded ${getRules().length} rules`);
 				return;
 			}
 
 			if (sub === "add") {
-				ui.notify(
+				recordEvent(
 					"Use /rulewizard add <url> (or /rules add for the rule-creation guide).",
 					"info",
 				);
@@ -149,7 +149,7 @@ export function registerRulesCommand(pi: ExtensionAPI, deps: RulesDeps): void {
 			}
 
 			if (sub === "new") {
-				ui.notify(
+				recordEvent(
 					"Use /rulewizard to scaffold a new rule (it guides the rule-vs-editorconfig-vs-linter decision).",
 					"info",
 				);
@@ -165,7 +165,7 @@ export function registerRulesCommand(pi: ExtensionAPI, deps: RulesDeps): void {
 					path.join(require("node:os").homedir(), ".agents", "rules"),
 				];
 				const found = dirs.filter((d) => fs.existsSync(d));
-				ui.notify(
+				recordEvent(
 					"Rules sources (existing first):\n" +
 						(found.length ? found.map((d) => `  ✓ ${d}`).join("\n") : "  (none)") +
 						"\n" +
@@ -178,7 +178,7 @@ export function registerRulesCommand(pi: ExtensionAPI, deps: RulesDeps): void {
 				return;
 			}
 
-			ui.notify(
+			recordEvent(
 				`Usage: /rules <list|show|stats|analytics|enable|disable|reload|add|new|path> [target]`,
 				"error",
 			);

package/commands/rulewizard.ts

@@ -1,15 +1,18 @@
+import { emit } from "../visual/event-sink.ts";
 // =============================================================================
 // commands/rulewizard.ts — /rulewizard command (interactive guide)
 // =============================================================================
 
 import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import type { CommandsDeps } from "./_helpers.ts";
 
-export function registerRulewizardCommand(pi: ExtensionAPI): void {
+export function registerRulewizardCommand(pi: ExtensionAPI, deps: CommandsDeps): void {
+	void deps; // rulewizard doesn't currently emit non-error events
 	pi.registerCommand("rulewizard", {
 		description:
 			"interactive guide: decide whether a constraint should be a soly rule, an .editorconfig entry, or a linter config (eslint/biome/prettier). Use this BEFORE writing a new rule to avoid duplicating what linters already enforce.",
 		handler: async (_args, ctx) => {
-			ctx.ui.notify(
+			emit(
 				[
 					"soly-rule-wizard:",
 					"",

package/commands/soly.ts

@@ -25,10 +25,10 @@ import { initSolyProject } from "../init.js";
 import { parseSolyCommand, type SolyCommand, type WorkflowVerb } from "../workflows/parser.ts";
 import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
 
-type SolyDeps = Pick<CommandsDeps, "getState" | "getConfig" | "reloadConfig" | "updateStatus" | "refreshState">;
+type SolyDeps = Pick<CommandsDeps, "getState" | "getConfig" | "reloadConfig" | "updateStatus" | "refreshState" | "recordEvent">;
 
 export function registerSolyCommand(pi: ExtensionAPI, deps: SolyDeps): void {
-	const { getState, getConfig, reloadConfig, updateStatus, refreshState } = deps;
+	const { getState, getConfig, reloadConfig, updateStatus, refreshState, recordEvent } = deps;
 
 	const solyBody = async (args: string, ctx: ExtensionCommandContext): Promise<void> => {
 			const ui: CommandUI = {
@@ -68,7 +68,7 @@ export function registerSolyCommand(pi: ExtensionAPI, deps: SolyDeps): void {
 
 			const showFile = (label: string, content: string | null) => {
 				if (!content) {
-					ui.notify(`${label}: not found`, "error");
+					recordEvent(`${label}: not found`, "error");
 					return;
 				}
 				const MAX = 4000;
@@ -105,22 +105,22 @@ export function registerSolyCommand(pi: ExtensionAPI, deps: SolyDeps): void {
 				switch (verb) {
 					case "new": {
 						const r = buildNewTransform(cmd, state, ui, ctx.cwd, getConfig().plan.defaultBranchPrefix);
-						if (r.handled && r.transformedText) ui.notify(r.transformedText, "info");
+						if (r.handled && r.transformedText) recordEvent(r.transformedText);
 						return;
 					}
 					case "done": {
 						const r = buildDoneTransform(cmd, state, ui, ctx.cwd, { defaultBranchPrefix: getConfig().plan.defaultBranchPrefix });
-						if (r.handled && r.transformedText) ui.notify(r.transformedText, "info");
+						if (r.handled && r.transformedText) recordEvent(r.transformedText);
 						return;
 					}
 					case "migrate": {
 						const r = buildMigrateTransform(state, ui, ctx.cwd);
-						if (r.handled && r.transformedText) ui.notify(r.transformedText, "info");
+						if (r.handled && r.transformedText) recordEvent(r.transformedText);
 						return;
 					}
 					case "plan": {
 						const r = buildPlanTransform(cmd, state);
-						if (r.handled && r.transformedText) ui.notify(r.transformedText, "info");
+						if (r.handled && r.transformedText) recordEvent(r.transformedText);
 						return;
 					}
 					case "discuss": {
@@ -129,13 +129,13 @@ export function registerSolyCommand(pi: ExtensionAPI, deps: SolyDeps): void {
 						// plain-text discussion format; the LLM-driven path still
 						// gets the richer ask_pro flow.
 						const r = buildDiscussTransform(cmd, state, { hasAskPro: false });
-						if (r.handled && r.transformedText) ui.notify(r.transformedText, "info");
+						if (r.handled && r.transformedText) recordEvent(r.transformedText);
 						return;
 					}
 					case "execute": {
 						// Slash-command path doesn't have live interactive rules.
 						const r = buildExecuteTransform(cmd, state, []);
-						if (r.handled && r.transformedText) ui.notify(r.transformedText, "info");
+						if (r.handled && r.transformedText) recordEvent(r.transformedText);
 						return;
 					}
 					default:
@@ -176,12 +176,12 @@ export function registerSolyCommand(pi: ExtensionAPI, deps: SolyDeps): void {
 						const s = getState();
 						if (s.position) {
 							// Brief status; full inspector lives in `/soly inspect`.
-							ui.notify(
+							recordEvent(
 								`pos: ${s.position.phase} · ${s.position.plan} (${s.position.status}) · ${s.progress.percent}%`,
 								"info",
 							);
 						} else {
-							ui.notify(`${s.milestone} — no position set`, "info");
+							recordEvent(`${s.milestone} — no position set`);
 						}
 					},
 				},
@@ -199,7 +199,7 @@ export function registerSolyCommand(pi: ExtensionAPI, deps: SolyDeps): void {
 						if (parts.length <= 1) {
 							const s = getState();
 							if (!s.currentPlanPath) {
-								ui.notify("soly: no current plan", "error");
+								recordEvent("soly: no current plan", "error");
 								return;
 							}
 							showFile(
@@ -216,7 +216,7 @@ export function registerSolyCommand(pi: ExtensionAPI, deps: SolyDeps): void {
 					run: () => {
 						const s = getState();
 						if (!s.currentPhase) {
-							ui.notify("soly: no current phase", "error");
+							recordEvent("soly: no current phase", "error");
 							return;
 						}
 						const p = path.join(s.currentPhase.dir, `${s.currentPhase.slug}-CONTEXT.md`);
@@ -228,7 +228,7 @@ export function registerSolyCommand(pi: ExtensionAPI, deps: SolyDeps): void {
 					run: () => {
 						const s = getState();
 						if (!s.currentPhase) {
-							ui.notify("soly: no current phase", "error");
+							recordEvent("soly: no current phase", "error");
 							return;
 						}
 						const p = path.join(s.currentPhase.dir, `${s.currentPhase.slug}-RESEARCH.md`);
@@ -244,7 +244,7 @@ export function registerSolyCommand(pi: ExtensionAPI, deps: SolyDeps): void {
 					run: () => {
 						const s = getState();
 						const line = `${s.progress.percent}% · ${s.progress.completedPhases}/${s.progress.totalPhases} phases · ${s.progress.completedPlans}/${s.progress.totalPlans} plans`;
-						ui.notify(line, "info");
+						recordEvent(line);
 					},
 				},
 				phases: {
@@ -252,7 +252,7 @@ export function registerSolyCommand(pi: ExtensionAPI, deps: SolyDeps): void {
 					run: () => {
 						const phases = getState().phases;
 						if (phases.length === 0) {
-							ui.notify("no phases", "info");
+							recordEvent("no phases");
 							return;
 						}
 						const current = getState().currentPhase?.number;
@@ -261,7 +261,7 @@ export function registerSolyCommand(pi: ExtensionAPI, deps: SolyDeps): void {
 							const cr = (p.contextExists ? "C" : "·") + (p.researchExists ? "R" : "·");
 							return `${marker} ${String(p.number).padStart(2, "0")}. ${p.name}  [${cr}]  plans=${p.planCount}`;
 						});
-						ui.notify(lines.join("\n"), "info");
+						recordEvent(lines.join("\n"));
 					},
 				},
 				tasks: {
@@ -269,7 +269,7 @@ export function registerSolyCommand(pi: ExtensionAPI, deps: SolyDeps): void {
 					run: () => {
 						const s = getState();
 						if (s.tasks.length === 0) {
-							ui.notify("no tasks", "info");
+							recordEvent("no tasks");
 							return;
 						}
 						const byFeature = new Map<string, typeof s.tasks>();
@@ -288,7 +288,7 @@ export function registerSolyCommand(pi: ExtensionAPI, deps: SolyDeps): void {
 							}
 							out.push("");
 						}
-						ui.notify(out.join("\n"), "info");
+						recordEvent(out.join("\n"));
 					},
 				},
 				task: {
@@ -296,13 +296,13 @@ export function registerSolyCommand(pi: ExtensionAPI, deps: SolyDeps): void {
 					run: (parts: string[]) => {
 						const id = (parts[1] ?? "").trim();
 						if (!id) {
-							ui.notify("Usage: /soly task <task-id>", "error");
+							recordEvent("Usage: /soly task <task-id>", "error");
 							return;
 						}
 						const s = getState();
 						const task = s.tasks.find((t) => t.id === id);
 						if (!task) {
-							ui.notify(
+							recordEvent(
 								`soly: task ${id} not found.\nKnown: ${s.tasks.map((t) => t.id).join(", ") || "(none)"}`,
 								"error",
 							);
@@ -319,7 +319,7 @@ export function registerSolyCommand(pi: ExtensionAPI, deps: SolyDeps): void {
 						if (summaryBody) {
 							showFile("SUMMARY.md", summaryBody);
 						} else {
-							ui.notify("no SUMMARY.md yet", "info");
+							recordEvent("no SUMMARY.md yet");
 						}
 					},
 				},
@@ -328,14 +328,14 @@ export function registerSolyCommand(pi: ExtensionAPI, deps: SolyDeps): void {
 					run: () => {
 						const features = getState().features;
 						if (features.length === 0) {
-							ui.notify("no features", "info");
+							recordEvent("no features");
 							return;
 						}
 						const lines = features.map((f) => {
 							const rm = f.readmeExists ? "R" : "·";
 							return `  ${f.name.padEnd(28)} tasks=${f.taskCount}  [${rm}]`;
 						});
-						ui.notify(lines.join("\n"), "info");
+						recordEvent(lines.join("\n"));
 					},
 				},
 				milestone: {
@@ -343,7 +343,7 @@ export function registerSolyCommand(pi: ExtensionAPI, deps: SolyDeps): void {
 					run: () => {
 						const s = getState();
 						if (!s.milestone || s.milestone === "—") {
-							ui.notify("soly: no milestone set", "info");
+							recordEvent("no milestone set");
 							return;
 						}
 						const candidates = [
@@ -357,7 +357,7 @@ export function registerSolyCommand(pi: ExtensionAPI, deps: SolyDeps): void {
 								return;
 							}
 						}
-						ui.notify(
+						recordEvent(
 							`soly: no milestone file found. tried:\n  ${candidates.map((c) => path.relative(process.cwd(), c)).join("\n  ")}`,
 							"error",
 						);
@@ -369,7 +369,7 @@ export function registerSolyCommand(pi: ExtensionAPI, deps: SolyDeps): void {
 						refreshState();
 						updateStatus(ui);
 						const s = getState();
-						ui.notify(`re-read state: ${s.phases.length} phases · ${s.tasks.length} tasks`, "info");
+						recordEvent(`re-read state: ${s.phases.length} phases · ${s.tasks.length} tasks`);
 					},
 				},
 				// ------------------------------------------------------------------
@@ -536,7 +536,7 @@ export function registerSolyCommand(pi: ExtensionAPI, deps: SolyDeps): void {
 			}
 
 			if (!(subcommands as Record<string, unknown>)[sub]) {
-				ui.notify(`soly: unknown subcommand '${sub}'`, "error");
+				recordEvent(`soly: unknown subcommand '${sub}'`, "error");
 				return openMenu();
 			}
 

package/commands/why.ts

@@ -5,10 +5,10 @@
 import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
 import type { CommandsDeps } from "./_helpers.ts";
 
-type WhyDeps = Pick<CommandsDeps, "getState" | "getRules">;
+type WhyDeps = Pick<CommandsDeps, "getState" | "getRules" | "recordEvent">;
 
 export function registerWhyCommand(pi: ExtensionAPI, deps: WhyDeps): void {
-	const { getState, getRules } = deps;
+	const { getState, getRules, recordEvent } = deps;
 
 	pi.registerCommand("why", {
 		description:
@@ -97,7 +97,7 @@ export function registerWhyCommand(pi: ExtensionAPI, deps: WhyDeps): void {
 					"If a behavior surprises you, look here first for the basis.",
 			);
 
-			ctx.ui.notify(lines.join("\n"), "info");
+			recordEvent(lines.join("\n"), "info");
 
 			// Suppress unused arg
 			void args;

package/commands.ts

@@ -39,6 +39,6 @@ export function registerCommands(pi: ExtensionAPI, deps: CommandsDeps): void {
 	registerDocsCommand(pi, deps);
 	registerSolyCommand(pi, deps); // also registers /sly and /s
 	registerArtifactsCommand(pi, deps);
-	registerRulewizardCommand(pi);
+	registerRulewizardCommand(pi, deps);
 	registerWhyCommand(pi, deps);
 }

package/index.ts

@@ -77,6 +77,7 @@ import piAskExtension from "./ask/index.ts";
 import piDeckExtension from "./deck/index.ts";
 import piArtifactExtension from "./artifact/index.ts";
 import { getArtifactServer } from "./artifact/session.ts";
+import { emit } from "./visual/event-sink.ts";
 
 /** Compact phase label for the chrome top bar, e.g. "plan 2/5". Null when idle. */
 function phaseLabelFromState(s: SolyState): string | null {
@@ -384,6 +385,10 @@ export default function solyExtension(pi: ExtensionAPI) {
 			}
 		},
 		getIntentDocs: () => intentDocs,
+		// Non-error soly events land in the Working sub-line (└─ prefixed).
+		// The route goes through the chrome so the sub-line auto-clears on
+		// the next agent_start.
+		recordEvent: (text, level) => chrome.emit(text, level),
 	});
 
 	registerTools(pi, {
@@ -393,6 +398,7 @@ export default function solyExtension(pi: ExtensionAPI) {
 	});
 
 	registerWorkflows(pi, {
+		recordEvent: (text, level) => chrome.emit(text, level),
 		getState: () => state,
 		getInteractiveRules: () =>
 			combinedRules()
@@ -458,20 +464,20 @@ export default function solyExtension(pi: ExtensionAPI) {
 		const cfgResult = loadConfig(ctx.cwd);
 		activeConfig = cfgResult.config;
 		for (const w of cfgResult.warnings) {
-			ctx.ui.notify(`soly config: ${w}`, "warning");
+			emit(`soly config: ${w}`, "warning");
 		}
 		if (cfgResult.sources.global || cfgResult.sources.project) {
 			const sources = [
 				cfgResult.sources.global ? `global: ${cfgResult.sources.global}` : null,
 				cfgResult.sources.project ? `project: ${cfgResult.sources.project}` : null,
 			].filter(Boolean).join(", ");
-			ctx.ui.notify(`soly config loaded (${sources})`, "info");
+			emit(`soly config loaded (${sources})`, "info");
 		}
 		// Auto-prune old iteration files per retention config
 		if (state.exists) {
 			const r = pruneOldIterations(state.solyDir, activeConfig.iteration.retentionDays);
 			if (r.pruned > 0) {
-				ctx.ui.notify(
+				emit(
 					`soly: pruned ${r.pruned} old iteration file(s) (retention ${activeConfig.iteration.retentionDays}d)`,
 					"info",
 				);
@@ -531,9 +537,11 @@ export default function solyExtension(pi: ExtensionAPI) {
 			},
 		});
 		// Editors save in bursts (write to .tmp, rename, touch). Coalesce
-		// those rapid reload events into a single user-visible notify.
+		// those rapid reload events into a single sub-line event under the
+		// Working indicator (└─ reloaded 47 rules). Errors here are real
+		// (disk I/O failed) and stay as popups.
 		hotReload.setNotifyHandler((reason) => {
-			ctx.ui.notify(`soly: rules reloaded (${reason})`, "info");
+			chrome.emit(`reloaded rules (${reason})`);
 		});
 
 		// Notifications (one-shot at startup)
@@ -549,10 +557,10 @@ export default function solyExtension(pi: ExtensionAPI) {
 			if (phaseRules.length > 0) {
 				summary += ` + ${phaseRules.length} phase-${state.currentPhase?.number}`;
 			}
-			ctx.ui.notify(summary, "info");
+			emit(summary, "info");
 
 			if (overriddenRulePaths.length > 0) {
-				ctx.ui.notify(
+				emit(
 					`soly: ${overriddenRulePaths.length} rule(s) overridden by project (${overriddenRulePaths.join(", ")})`,
 					"info",
 				);
@@ -576,23 +584,23 @@ export default function solyExtension(pi: ExtensionAPI) {
 				if (added.length) parts.push(`+${added.length}`);
 				if (removed.length) parts.push(`-${removed.length}`);
 				if (changed.length) parts.push(`~${changed.length}`);
-				ctx.ui.notify(`soly: rules changed since last session (${parts.join(" ")})`, "info");
+				emit(`soly: rules changed since last session (${parts.join(" ")})`, "info");
 			}
 
 			// Rule budget analytics
 			const analytics = analyzeRules(alwaysOnRules, CONTEXT_WINDOW_TOKENS);
 			if (analytics.contextBudgetPct > 5) {
-				ctx.ui.notify(
+				emit(
 					`soly: rules use ${analytics.contextBudgetPct.toFixed(1)}% of context window (${formatTok(analytics.totalTokens)} across ${analytics.fileCount} files)`,
 					"info",
 				);
 			}
 		} else {
-			ctx.ui.notify("soly rules: none found in .agents/rules.local, .agents/rules, or ~/.agents/rules", "info");
+			emit("soly rules: none found in .agents/rules.local, .agents/rules, or ~/.agents/rules", "info");
 		}
 
 		if (state.exists) {
-			ctx.ui.notify(`soly state: ${state.milestone} (${state.phases.length} phases)`, "info");
+			emit(`soly state: ${state.milestone} (${state.phases.length} phases)`, "info");
 		}
 
 		updateStatus(ctx);

package/init.ts

@@ -35,6 +35,7 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { SOLY_DIRNAME } from "./core.js";
+import { emit } from "./visual/event-sink.ts";
 
 export type InitTemplate = "minimal" | "web-app" | "library" | "cli";
 
@@ -207,7 +208,7 @@ export async function initSolyProject(
 
 	// Preconditions
 	if (fs.existsSync(agentsDir)) {
-		ui.notify(
+		emit(
 			`soly init: project already initialized (found ${SOLY_DIRNAME}/). ` +
 				`Aborting to avoid overwriting.`,
 			"error",