@master.g/pi-wingman 0.0.2 → 0.0.3

package/README.md

@@ -10,7 +10,7 @@
 | **advisor** | oh-my-pi advisor | 指定一个模型当顾问，读主 agent 的每个 turn，以 steer 消息内联注入便签（aside / concern / blocker）让主 agent 纠偏 |
 | **hint** | Claude Code prompt suggestions | 任务结束后按上下文与目标生成下一步 prompt，输入框 ghost text 呈现：Tab 填入、Enter 直接发送 |
 
-> 状态：早期版本（v0.0.2）。hint、advisor、heads-up 三个功能均已实现，默认关闭，尚在试用打磨中。
+> 状态：早期版本（v0.0.3）。hint、advisor、heads-up 三个功能均已实现，默认关闭，尚在试用打磨中。
 
 ## 安装
 
@@ -30,6 +30,8 @@ pi --extension ~/github/pi-wingman/index.ts
 - `/wingman advisor|hint|headsup` — 不带值时弹出 pi 的模型选择器（同 `/model`，可搜索），选完模型再选思考强度（同 `/thinking`，Esc 跳过）；也可直接写 `<provider/model> [effort]`（模型须存在，effort 须是该模型支持的档位）、`on` / `off`（开关，保留已设模型与 effort）；参数支持补全
 - `/ask-advisor <问题>` — 就当前上下文咨询顾问模型，回答注入对话
 
+advisor 与 heads-up 审计通过（ok）时不打扰，只在底栏状态显示 `advisor ⋯`（审计中）、`advisor ✓ ok`（结果级别）或 `advisor ✗ 原因`（调用失败）；自定义 footer 扩展需要自己渲染扩展状态才看得到。
+
 ## 配置
 
 `<agentDir>/wingman.json`（默认 `~/.pi/agent/wingman.json`），由命令自动写入，也可手改：

package/advisor.ts

@@ -13,7 +13,7 @@
  */
 
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
-import { Auditor, buildDigest, type DigestMessage, type VerdictLevel } from "./audit.js";
+import { auditStatus, Auditor, buildDigest, type DigestMessage, type VerdictLevel } from "./audit.js";
 import type { WingmanConfig } from "./config.js";
 import { completeText, messageText, resolveModel, type AnyModel, type ModelRegistry } from "./llm.js";
 
@@ -52,6 +52,8 @@ export class AdvisorState {
 
 const ASK_SYSTEM_PROMPT = `你是资深编程顾问,在旁观察一个编程 agent 的工作。给你用户的目标和 agent 近期动作摘要,以及用户现在问你的问题。直接回答问题本身,简洁具体,≤300 字,用中文。`;
 
+const STATUS_KEY = "wingman-advisor";
+
 const NOTIFY_TYPE: Record<Exclude<VerdictLevel, "ok">, "info" | "warning" | "error"> = {
 	note: "info",
 	concern: "warning",
@@ -68,14 +70,19 @@ export function installAdvisor(pi: ExtensionAPI, getConfig: () => WingmanConfig,
 	let pendingDigests: string[] = [];
 
 	const audit = async (ctx: ExtensionContext, registry: ModelRegistry, model: AnyModel, digest: string) => {
-		const verdict = await auditor.run(
+		ctx.ui.setStatus(STATUS_KEY, auditStatus("advisor"));
+		const result = await auditor.run(
 			registry,
 			model,
 			{ goal: getGoal(), digest },
 			// 后台审计不卡主流程,超时放宽给高 effort 留余地
 			{ timeoutMs: 60_000, signal: shutdown.signal, effort: getConfig().advisor.effort },
 		);
-		if (!verdict || verdict.level === "ok") return;
+		if (!result) return;
+		ctx.ui.setStatus(STATUS_KEY, auditStatus("advisor", result));
+		if (!result.ok) return;
+		const { verdict } = result;
+		if (verdict.level === "ok") return;
 		ctx.ui.notify(`advisor [${verdict.level}] ${verdict.summary}`, NOTIFY_TYPE[verdict.level]);
 		if (ctx.isIdle()) return; // 裁决迟到:agent 已停,只提示用户,不注入
 		pi.sendUserMessage(formatAdvisorNote(verdict), { deliverAs: "steer" });

package/audit.ts

@@ -21,6 +21,15 @@ export interface Verdict {
 	details: string[];
 }
 
+/** 一次审计的结果:成功带裁决,失败带原因(给底栏状态看)。 */
+export type AuditResult = { ok: true; verdict: Verdict } | { ok: false; reason: string };
+
+/** 底栏状态文本:不传结果为审计中,否则 ✓ 级别 / ✗ 原因。 */
+export function auditStatus(feature: string, result?: AuditResult): string {
+	if (!result) return `${feature} ⋯`;
+	return result.ok ? `${feature} ✓ ${result.verdict.level}` : `${feature} ✗ ${result.reason.slice(0, 60)}`;
+}
+
 export type DigestMessage = Message;
 
 export interface DigestOptions {
@@ -93,7 +102,7 @@ export async function runAudit(
 	model: AnyModel,
 	input: { goal: string; digest: string },
 	options: CallOptions = {},
-): Promise<Verdict | undefined> {
+): Promise<AuditResult> {
 	const goal = input.goal ? `用户目标:${input.goal}\n\n` : "";
 	const result = await completeText(
 		registry,
@@ -110,8 +119,9 @@ export async function runAudit(
 		},
 		options,
 	);
-	if (!result.ok) return undefined;
-	return parseVerdict(result.text);
+	if (!result.ok) return result;
+	const verdict = parseVerdict(result.text);
+	return verdict ? { ok: true, verdict } : { ok: false, reason: `无法解析裁决:${result.text.slice(0, 40)}` };
 }
 
 /** 冷却 + 互斥的审计器:advisor(turn_end)与 heads-up(去抖)共用一个实例各管各的。 */
@@ -136,14 +146,14 @@ export class Auditor {
 		model: AnyModel,
 		input: { goal: string; digest: string },
 		options: CallOptions = {},
-	): Promise<Verdict | undefined> {
-		if (!this.ready) return undefined;
+	): Promise<AuditResult | undefined> {
+		if (!this.ready) return undefined; // 冷却或在途:跳过
 		this.inFlight = true;
 		this.lastRunAt = this.now();
 		try {
 			return await runAudit(registry, model, input, options);
-		} catch {
-			return undefined; // 静默降级
+		} catch (error) {
+			return { ok: false, reason: error instanceof Error ? error.message : String(error) };
 		} finally {
 			this.inFlight = false;
 		}

package/editor.ts

@@ -2,7 +2,7 @@
  * editor.ts — WingmanEditor 与其安装管理(EditorManager)。
  *
  * WingmanEditor 是全扩展唯一的 CustomEditor(setEditorComponent 全局只能装
- * 一个):hint 用 ghost 行(M1),heads-up 用数字键捕获(M3)。安装条件是
+ * 一个):hint 用输入行内联的暗色 ghost 文本(M1),heads-up 用数字键捕获(M3)。安装条件是
  * hint.enabled || headsup.enabled;session_start 与配置命令变更后各 sync
  * 一次,条件不变不动(避免重建丢掉 pendingHint)。
  */
@@ -32,10 +32,9 @@ export class WingmanEditor extends CustomEditor {
 
 	render(width: number): string[] {
 		const lines = super.render(width);
-		if (!this.pendingHint || this.getText().length > 0 || lines.length < 2) return lines;
-		// shortcut: ghost 渲染为输入行下方新增一行;如需与输入行内联覆盖再升级。
-		const ghost = truncateToWidth(`\x1b[2m  💡 ${this.pendingHint}\x1b[0m`, width);
-		lines.splice(lines.length - 1, 0, ghost);
+		if (!this.pendingHint || this.getText().length > 0 || lines.length < 3) return lines;
+		// 空编辑器的唯一内容行紧跟上边框:去掉行尾填充,把 hint 以暗色接在光标后
+		lines[1] = truncateToWidth(`${lines[1].replace(/ +$/, "")}\x1b[2m${this.pendingHint}\x1b[22m`, width);
 		return lines;
 	}
 

package/headsup.ts

@@ -20,7 +20,7 @@ import { truncateToWidth } from "@earendil-works/pi-tui";
 import { appendFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
-import { Auditor, type Verdict, type VerdictLevel } from "./audit.js";
+import { auditStatus, Auditor, type Verdict, type VerdictLevel } from "./audit.js";
 import type { WingmanConfig } from "./config.js";
 import type { EditorManager } from "./editor.js";
 import { resolveModel } from "./llm.js";
@@ -31,6 +31,7 @@ const WIDGET_KEY = "wingman-headsup";
 const LEVEL_COLOR: Partial<Record<VerdictLevel, ThemeColor>> = { concern: "warning", blocker: "error" };
 /** 冷却期内最多积压的工具事件数,超出丢最旧的。 */
 const MAX_PENDING = 30;
+const STATUS_KEY = "wingman-headsup";
 
 /** WINGMAN_DEBUG=1 时把管线决策追加到 <tmpdir>/wingman-debug.log;旁路默认静默,这是唯一的观测口。 */
 function debug(message: string): void {
@@ -213,14 +214,19 @@ export function installHeadsUp(
 		const events = pending;
 		pending = [];
 		debug(`flush: ${events.length} 个事件送审计`);
-		const verdict = await auditor.run(
+		ctx.ui.setStatus(STATUS_KEY, auditStatus("headsup"));
+		const result = await auditor.run(
 			ctx.modelRegistry,
 			model,
 			{ goal: getGoal(), digest: formatToolEvents(events) },
 			{ timeoutMs: 60_000, signal: shutdown.signal, effort: config.effort },
 		);
-		debug(`verdict: ${verdict ? `${verdict.level} ${verdict.summary}` : "(调用失败/跳过)"}`);
-		if (!verdict || (verdict.level !== "concern" && verdict.level !== "blocker")) return;
+		if (!result) return;
+		ctx.ui.setStatus(STATUS_KEY, auditStatus("headsup", result));
+		debug(`verdict: ${result.ok ? `${result.verdict.level} ${result.verdict.summary}` : `调用失败 ${result.reason}`}`);
+		if (!result.ok) return;
+		const { verdict } = result;
+		if (verdict.level !== "concern" && verdict.level !== "blocker") return;
 		if (!view.show(verdict)) {
 			debug("已在抑制集,不上屏");
 			return;

package/index.ts

@@ -116,6 +116,7 @@ export default function (pi: ExtensionAPI) {
 			if (value) {
 				saveConfig(config);
 				editors.sync(ctx, config);
+				if (!config[feature].enabled) ctx.ui.setStatus(`wingman-${feature}`, undefined);
 			}
 			ctx.ui.notify(`wingman · ${line}`, "info");
 		},

package/llm.ts

@@ -76,7 +76,8 @@ export async function completeText(
 			.streamSimple(model, context, { signal: controller.signal, reasoning: effort === "off" ? undefined : effort })
 			.result();
 		if (response.stopReason !== "stop") {
-			return { ok: false, reason: `stopReason=${response.stopReason}` };
+			const detail = response.errorMessage ? `: ${response.errorMessage}` : "";
+			return { ok: false, reason: `stopReason=${response.stopReason}${detail}` };
 		}
 		const text = textOf(response.content).trim();
 		if (!text) return { ok: false, reason: "empty response" };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@master.g/pi-wingman",
-	"version": "0.0.2",
+	"version": "0.0.3",
 	"description": "Wingman for pi — heads-up audit while the agent works, a designated advisor model, and next-prompt hints (Tab/Enter to accept)",
 	"type": "module",
 	"license": "MIT",