pi-firecode 0.8.0

package/header.ts

@@ -0,0 +1,92 @@
+/** 会话启动横幅：终端够宽显示火焰 + FireCode 字标，否则退化成一行。 */
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { visibleWidth } from "@earendil-works/pi-tui";
+import { clip } from "./format.js";
+import { ANSI, FLAME } from "./theme.js";
+
+const GAP = "     ";
+const EXTRA_RIGHT_PAD = " ";
+/** 字标相对火焰顶部下沉的行数 */
+const TEXT_TOP_PAD = 4;
+
+const FLAME_ART = [
+	"⠀⠀⠀⠀⠀⠀⢱⣆⠀⠀⠀⠀⠀⠀",
+	"⠀⠀⠀⠀⠀⠀⠈⣿⣷⡀⠀⠀⠀⠀",
+	"⠀⠀⠀⠀⠀⠀⢸⣿⣿⣷⣧⠀⠀⠀",
+	"⠀⠀⠀⠀⡀⢠⣿⡟⣿⣿⣿⡇⠀⠀",
+	"⠀⠀⠀⠀⣳⣼⣿⡏⢸⣿⣿⣿⢀⠀",
+	"⠀⠀⠀⣰⣿⣿⡿⠁⢸⣿⣿⡟⣼⡆",
+	"⢰⢀⣾⣿⣿⠟⠀⠀⣾⢿⣿⣿⣿⣿",
+	"⢸⣿⣿⣿⡏⠀⠀⠀⠃⠸⣿⣿⣿⡿",
+	"⢳⣿⣿⣿⠀⠀⠀⠀⠀⠀⢹⣿⡿⡁",
+	"⠀⠹⣿⣿⡄⠀⠀⠀⠀⠀⢠⣿⡞⠁",
+	"⠀⠀⠈⠛⢿⣄⠀⠀⠀⣠⠞⠋⠀⠀",
+];
+const WORDMARK = [
+	"___________.__                 _________            .___      ",
+	"\\_   _____/|__|______   ____   \\_   ___ \\  ____   __| _/____  ",
+	" |    __)  |  \\_  __ \\_/ __ \\  /    \\  \\/ /  _ \\ / __ |/ __ \\ ",
+	" |     \\   |  ||  | \\/\\  ___/  \\     \\___(  <_> ) /_/ \\  ___/ ",
+	" \\___  /   |__||__|    \\___  >  \\______  /\\____/\\____ |\\___  >",
+	"     \\/                    \\/          \\/            \\/    \\/ ",
+];
+const FLAME_COLORS = [
+	FLAME.red,
+	FLAME.red,
+	FLAME.orange,
+	FLAME.orange,
+	FLAME.gold,
+	FLAME.white,
+	FLAME.white,
+	FLAME.gold,
+	FLAME.orange,
+	FLAME.red,
+	FLAME.red,
+];
+const TEXT_COLORS = [
+	FLAME.textTop,
+	FLAME.textTop,
+	FLAME.textMid,
+	FLAME.textCore,
+	FLAME.gold,
+	FLAME.gold,
+];
+
+function padToWidth(line: string, width: number): string {
+	return line + " ".repeat(Math.max(0, width - visibleWidth(line)));
+}
+
+const FLAME_WIDTH = Math.max(...FLAME_ART.map(visibleWidth));
+const FULL_WIDTH = Math.max(
+	...FLAME_ART.map((flame, index) => {
+		const text = WORDMARK[index - TEXT_TOP_PAD] ?? "";
+		return visibleWidth(`${padToWidth(flame, FLAME_WIDTH)}${GAP}${text}${EXTRA_RIGHT_PAD}`);
+	}),
+);
+const FULL = FLAME_ART.map((art, index) => {
+	const textIndex = index - TEXT_TOP_PAD;
+	const wordmark = WORDMARK[textIndex] ?? "";
+	const flame = `${FLAME_COLORS[index]}${padToWidth(art, FLAME_WIDTH)}${ANSI.reset}`;
+	const title = wordmark
+		? `${ANSI.bold}${TEXT_COLORS[textIndex]}${wordmark}${ANSI.reset}`
+		: "";
+	return padToWidth(`${flame}${GAP}${title}`, FULL_WIDTH);
+});
+const TINY = [`${FLAME.orange}🔥 Fire${ANSI.reset} ${FLAME.textCore}Code${ANSI.reset}`];
+
+function center(line: string, width: number): string {
+	const clipped = clip(line, width, "end", "");
+	return " ".repeat(Math.max(0, Math.floor((width - visibleWidth(clipped)) / 2))) + clipped;
+}
+
+export function registerHeader(pi: ExtensionAPI): void {
+	pi.on("session_start", (_event, ctx) => {
+		ctx.ui.setHeader(() => ({
+			invalidate() {},
+			render(width: number): string[] {
+				const lines = width >= FULL_WIDTH ? FULL : TINY;
+				return ["", ...lines.map((line) => center(line, width)), ""];
+			},
+		}));
+	});
+}

package/herdr-client.ts

@@ -0,0 +1,60 @@
+/**
+ * herdr socket 短连接客户端：单请求单连接，只有 herdr 返回 result 才算送达。
+ * herdr-display（身份投影）与 review（占用 state_label）共用；herdr 之外返回未送达。
+ */
+import net from "node:net";
+
+const REQUEST_TIMEOUT_MS = 500;
+
+export interface HerdrPaneEnv {
+	paneId: string;
+	socketPath: string;
+}
+
+export function herdrPaneEnv(): HerdrPaneEnv | undefined {
+	const paneId = process.env.HERDR_PANE_ID;
+	const socketPath = process.env.HERDR_SOCKET_PATH;
+	if (process.env.HERDR_ENV !== "1" || !paneId || !socketPath) return undefined;
+	return { paneId, socketPath };
+}
+
+export function herdrRequest(
+	source: string,
+	method: string,
+	params: Record<string, unknown>,
+): Promise<boolean> {
+	const env = herdrPaneEnv();
+	if (!env) return Promise.resolve(false);
+	const endpoint =
+		process.platform === "win32" ? `\\\\.\\pipe\\${env.socketPath}` : env.socketPath;
+	return new Promise((resolve) => {
+		const socket = net.createConnection(endpoint);
+		let buffer = "";
+		const finish = (delivered: boolean) => {
+			clearTimeout(timer);
+			socket.destroy();
+			resolve(delivered);
+		};
+		const timer = setTimeout(() => finish(false), REQUEST_TIMEOUT_MS);
+		timer.unref?.();
+		socket.on("error", () => finish(false));
+		socket.on("end", () => finish(false));
+		socket.on("data", (chunk) => {
+			buffer += chunk;
+			const end = buffer.indexOf("\n");
+			if (end >= 0) finish(hasResult(buffer.slice(0, end)));
+		});
+		socket.on("connect", () => {
+			socket.write(`${JSON.stringify({ id: source, method, params })}\n`);
+		});
+	});
+}
+
+function hasResult(line: string): boolean {
+	try {
+		const response = JSON.parse(line) as { result?: unknown; error?: unknown };
+		return !response.error && typeof response.result === "object" && response.result !== null;
+	} catch {
+		return false;
+	}
+}

package/index.ts

@@ -0,0 +1,62 @@
+/**
+ * FireCode：个人 pi 定制层——启动横幅、状态栏、工具行渲染、预设、会话命名，
+ * Claude 归因、OpenAI 请求层、对抗审查与按需 Master。各功能可在 config.jsonc 的 features 里单独关闭。
+ */
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { type Feature, loadConfig } from "./config.js";
+import { registerHeader } from "./header.js";
+import { registerClaudeSub } from "./provider/claude-sub.js";
+import { registerOpenAINative } from "./provider/openai-native/index.js";
+import { registerPresets } from "./session/presets.js";
+import { registerHerdrDisplay } from "./session/herdr-display.js";
+import { registerSessionName } from "./session/rename.js";
+import { registerBark } from "./session/bark.js";
+import { registerStats } from "./session/stats.js";
+import { registerWorkingFlame } from "./session/working-flame.js";
+import { registerStatusBar } from "./statusbar/index.js";
+import { registerToolRendering } from "./tools/index.js";
+import { registerReview } from "./review/index.js";
+import { registerMaster } from "./master/index.js";
+import { currentSubsessionRole } from "./master/role.js";
+import { registerWatcher } from "./watcher/index.js";
+
+const REGISTRARS: Record<Exclude<Feature, "review" | "master" | "watcher" | "statusbar" | "bark">, (pi: ExtensionAPI) => void> = {
+	header: registerHeader,
+	tools: registerToolRendering,
+	presets: registerPresets,
+	rename: registerSessionName,
+	stats: registerStats,
+	claudeSub: registerClaudeSub,
+	openaiNative: registerOpenAINative,
+	workingFlame: registerWorkingFlame,
+};
+
+type FirecodeSessionRole = "main" | "worker" | "observer" | "reviewer" | "advisor";
+
+export function registerFirecode(pi: ExtensionAPI, role: FirecodeSessionRole = "main"): void {
+	const { config, problems } = loadConfig();
+	const subsession = role !== "main";
+	const reviewEnabled = config.features.review !== false;
+	for (const [feature, register] of Object.entries(REGISTRARS)) {
+		const enabled = config.features[feature as Exclude<Feature, "review" | "master" | "watcher" | "statusbar" | "bark">] !== false;
+		if (enabled) register(pi);
+	}
+	if (config.features.statusbar !== false) registerStatusBar(pi, subsession);
+	if (config.features.bark !== false) registerBark(pi, subsession);
+	if (config.features.watcher !== false) registerWatcher(pi, {}, subsession);
+	if (config.features.master !== false) registerMaster(pi, {}, subsession);
+	// herdr 显示投影没有开关：herdr 之外自我禁用，只写显示层。
+	registerHerdrDisplay(pi, subsession);
+	// 历史卡渲染与 checkpoint 收口不受 feature 开关控制；开关只控制命令和执行循环。
+	// features 整节类型错误会被安全回退成全关，但那是配置坏而非用户关闭：不封存 checkpoint。
+	registerReview(pi, reviewEnabled, problems.includes("features 必须是对象"));
+
+	if (problems.length === 0) return;
+	pi.on("session_start", (_event, ctx) => {
+		ctx.ui.notify(`FireCode 配置有问题：${problems.join("；")}`, "warning");
+	});
+}
+
+export default function firecode(pi: ExtensionAPI): void {
+	registerFirecode(pi, currentSubsessionRole() ?? "main");
+}

package/jsonc.ts

@@ -0,0 +1,34 @@
+/** 去掉行注释和块注释，字符串内的斜杠不动。不支持尾逗号。 */
+export function parseJsonc(text: string): unknown {
+	let output = "";
+	let inString = false;
+	let escape = false;
+	for (let index = 0; index < text.length; index++) {
+		const char = text[index];
+		if (inString) {
+			output += char;
+			if (escape) escape = false;
+			else if (char === "\\") escape = true;
+			else if (char === '"') inString = false;
+			continue;
+		}
+		if (char === '"') {
+			inString = true;
+			output += char;
+			continue;
+		}
+		if (char === "/" && text[index + 1] === "/") {
+			index += 1;
+			while (index + 1 < text.length && text[index + 1] !== "\n") index += 1;
+			continue;
+		}
+		if (char === "/" && text[index + 1] === "*") {
+			index += 1;
+			while (index + 1 < text.length && !(text[index] === "*" && text[index + 1] === "/")) index += 1;
+			index += 1;
+			continue;
+		}
+		output += char;
+	}
+	return JSON.parse(output);
+}

package/master/event-card.ts

@@ -0,0 +1,106 @@
+/**
+ * Master 事件卡：默认紧凑（每事件一行标题行），ctrl+o 展开完整内容。
+ * content 给模型（完整事实），details 给渲染——两者刻意不对齐（先例：review/card.ts）。
+ * 提取与校验的格式契约在 event-format.ts；旧会话无 details 的消息与校验失败一律降级
+ * 完整内容；渲染器永不抛异常。
+ */
+import type { ExtensionAPI, Theme } from "@earendil-works/pi-coding-agent";
+import { getMarkdownTheme } from "@earendil-works/pi-coding-agent";
+import { Box, type Component, Markdown, Text } from "@earendil-works/pi-tui";
+import { clip, oneLine } from "../format.js";
+import {
+	MASTER_EVENT_TYPE,
+	isValidMasterEventDetails,
+	type MasterEventDetails,
+} from "./event-format.js";
+
+export function registerMasterEventRenderer(pi: ExtensionAPI): void {
+	pi.registerMessageRenderer<MasterEventDetails>(
+		MASTER_EVENT_TYPE,
+		(message, options, theme) =>
+			new MasterEventCard(message.details, message.content, options.expanded, theme),
+	);
+}
+
+class MasterEventCard implements Component {
+	private readonly card: Component;
+	private readonly fallback: Component;
+
+	constructor(
+		details: MasterEventDetails | undefined,
+		content: string | (string | unknown)[],
+		expanded: boolean,
+		theme: Theme,
+	) {
+		const text = plainContent(content);
+		this.fallback = new Text(text, 0, 0);
+		let card: Component | undefined;
+		try {
+			card = !expanded && isValidMasterEventDetails(details)
+				? compactCard(details, theme)
+				: fullCard(text, theme);
+		} catch {
+			card = undefined;
+		}
+		this.card = card ?? this.fallback;
+	}
+
+	render(width: number): string[] {
+		try {
+			return this.card.render(Math.max(1, width));
+		} catch {
+			try {
+				return this.fallback.render(Math.max(1, width));
+			} catch {
+				return [];
+			}
+		}
+	}
+
+	invalidate(): void {
+		this.card.invalidate?.();
+		this.fallback.invalidate?.();
+	}
+}
+
+function compactCard(details: MasterEventDetails, theme: Theme): Component {
+	return card(theme, details.titles.map((title) => new CompactTitle(`◆ ${title}`)));
+}
+
+/**
+ * 单行截断：不用 pi-tui 的 TruncatedText——它的省略号带 `\x1b[0m` 全量重置，
+ * 会在截断点把外层 Box 的背景色掠断（行尾露底色、右缘参差）；
+ * clip 是纯文本截断，Box 补位后背景整行连续。
+ */
+class CompactTitle implements Component {
+	constructor(private readonly text: string) {}
+
+	invalidate(): void {}
+
+	render(width: number): string[] {
+		return [clip(oneLine(this.text), Math.max(1, width))];
+	}
+}
+
+function fullCard(text: string, theme: Theme): Component {
+	return card(theme, [new Markdown(text, 0, 0, getMarkdownTheme())]);
+}
+
+function card(theme: Theme, children: Component[]): Component {
+	// 宿主 CustomMessageComponent 已自带一行消息间距，这里不再叠加；垂直内边距也为 0。
+	const box = new Box(1, 0, (text) => theme.bg("customMessageBg", text));
+	for (const child of children) box.addChild(child);
+	return box;
+}
+
+function plainContent(content: string | (string | unknown)[]): string {
+	if (typeof content === "string") return content;
+	if (!Array.isArray(content)) return "";
+	return content
+		.map((part) =>
+			typeof part === "object" && part !== null && "text" in part
+				? String((part as { text: unknown }).text)
+				: "")
+		.filter(Boolean)
+		.join("\n");
+}

package/master/event-format.ts

@@ -0,0 +1,52 @@
+/**
+ * Master 事件文本与紧凑行的共享格式契约（纯函数、零宿主依赖，可被测试直接导入）。
+ * 分节标记是事件产文与紧凑卡提取的单一事实源：改词两侧编译期同步，杜绝静默退化
+ * （曾经的隐式跨文件耦合让"改文案→预览悄悄消失"且测试全绿）。
+ */
+export const MASTER_EVENT_TYPE = "firecode-master-event";
+
+/** 正文分节标记：事件产文用它拼标记行，紧凑行提取用它识别正文首句。 */
+export const BODY_SECTIONS = {
+	reply: "回复",
+	error: "错误",
+	question: "问题",
+	finalReply: "最终回复",
+	lastOutput: "中断前最后输出",
+} as const;
+
+/** 产文侧唯一入口：正文段一律以 `<标记>：` 独占一行开头。 */
+export function sectionLine(section: keyof typeof BODY_SECTIONS): string {
+	return `${BODY_SECTIONS[section]}：`;
+}
+
+const BODY_MARKER = new RegExp(`^(?:${Object.values(BODY_SECTIONS).join("|")})：$`, "u");
+
+const VERSION = 1;
+
+export interface MasterEventDetails {
+	version: typeof VERSION;
+	titles: string[];
+}
+
+/** 每个事件一行：首行标题句 + 正文首句预览（渲染时按宽度截断）。 */
+export function masterEventDetails(contents: string[]): MasterEventDetails {
+	return { version: VERSION, titles: contents.map(compactLine) };
+}
+
+function compactLine(content: string): string {
+	const lines = content.split("\n");
+	const title = lines[0] ?? "";
+	const marker = lines.findIndex((line) => BODY_MARKER.test(line.trim()));
+	if (marker < 0) return title;
+	const preview = lines.slice(marker + 1).find((line) => line.trim());
+	return preview ? `${title} — ${preview.trim()}` : title;
+}
+
+export function isValidMasterEventDetails(value: unknown): value is MasterEventDetails {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
+	const record = value as Record<string, unknown>;
+	if (Object.keys(record).length !== 2 || record.version !== VERSION) return false;
+	return Array.isArray(record.titles) &&
+		record.titles.length > 0 &&
+		record.titles.every((title) => typeof title === "string");
+}