pi-qq 0.1.6 → 0.1.8

package/README.md

@@ -2,13 +2,14 @@
 
 Ask quick side questions about your current [pi](https://pi.dev) session without polluting the main transcript.
 
-`pi-qq` adds `/qq <question>` plus an **alt+q** / **Option+Q** shortcut that toggles `/qq ` in the editor. The answer appears ephemerally in a bottom overlay, using the current session as read-only context, and nothing is added to the main conversation.
+`pi-qq` adds `/qq <question>` plus an **alt+q** / **Option+Q** shortcut that toggles `/qq ` in the editor. Answers appear in a dismissible bottom overlay, can be reopened from in-memory `/qq-history`, and never enter the main conversation.
 
 ## Why try it?
 
 - **A real side channel:** ask `/qq why are we changing this file?` while the main agent keeps working. The answer shows in a bottom overlay and does not enter the main transcript.
-- **Context-aware, intentionally constrained:** `/qq` passes read-only main-session context, treats ambiguous references like “this”, “that”, “we”, and “the plan” as references to the active session, gives the side call no tools, and keeps no `/qq` history.
-- **Fast, low-friction UX:** `/qq` uses recent context by default, automatically switches to broader context for retrospective questions, and supports explicit `--recent` / `--full` modes. Press **alt+q** / **Option+Q** to toggle `/qq `, then use **Esc** to cancel/dismiss or **↑/↓** to scroll longer answers.
+- **Context-aware, intentionally constrained:** `/qq` passes read-only main-session context, treats ambiguous references like “this”, “that”, “we”, and “the plan” as references to the active session, and gives the side call no tools. Previous `/qq` answers are available only through `/qq-history`; they are not fed back into future `/qq` calls.
+- **Fast, low-friction UX:** press **alt+q** / **Option+Q** to toggle `/qq `, then use **Esc** to cancel/dismiss or **↑/↓** to scroll longer answers.
+- **Smart context modes:** `/qq` uses recent context by default, automatically switches to broader bounded context for retrospective questions, and supports explicit `--recent` / `--full` modes.
 
 ## Demo
 
@@ -23,7 +24,7 @@ Another common flow:
 1. Press **alt+q** / **Option+Q**.
 2. Type `what's the risk with this plan?`.
 3. Hit Enter.
-4. Read the concise overlay answer; press **Esc** to dismiss.
+4. Read the concise overlay answer; press **Esc** to dismiss. If you close it too soon, run `/qq-history` to reopen recent answers.
 
 ## Install
 
@@ -41,14 +42,18 @@ After installing, run `/reload` in pi or restart the session.
 /qq <question>
 /qq --recent <question>
 /qq --full <question>
+/qq-history
 ```
 
 By default, `/qq` chooses a context mode automatically:
 
-- **Recent mode** for immediate questions like `what did we do in the last turn?`, `what are we doing right now?`, or `why are we changing this?`.
-- **Full mode** for retrospective questions like `summarize this session`, `what did we decide so far?`, or `what did we try earlier?`.
+| Mode | When to use it | Context sent |
+| --- | --- | --- |
+| Auto | Default for `/qq <question>` | Recent context for immediate questions, broader bounded context for retrospective questions |
+| `--recent` | Fastest answers about the latest work | Latest messages only |
+| `--full` | Recaps or questions about earlier decisions | Broader but still bounded session context, not unlimited history |
 
-Use `--recent` when you want the fastest answer from the latest messages. Use `--full` when you explicitly want broader session context.
+Use `/qq-history` to reopen recent `/qq` answers from the current session. History is view-only and is not included as context for future `/qq` model calls.
 
 ### Shortcut
 
@@ -68,10 +73,11 @@ Press **alt+q** / **Option+Q** to toggle `/qq ` at the front of the editor:
 
 - The main transcript is never polluted by `/qq` questions or answers.
 - The side call receives read-only main-session context.
-- Recent mode sends only the latest messages for speed; full mode sends broader bounded context.
+- Recent mode sends only the latest messages for speed; full mode sends broader but still bounded context, not unlimited history.
 - Large text parts are clipped, thinking blocks are removed, and images are omitted from the side-call context for speed.
 - The side call has no tools.
-- `/qq` stores no quick-question history; each call is independent except for the main-session context.
+- Recent `/qq` answers are kept in memory only so `/qq-history` can reopen them after dismissal.
+- `/qq-history` is view-only; it is not used as context for future `/qq` model calls.
 - The system prompt biases answers toward concise, direct responses.
 
 ## License

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-qq",
-  "version": "0.1.6",
-  "description": "Pi extension. Ask context-aware side questions with /qq or alt+q without polluting the main transcript.",
+  "version": "0.1.8",
+  "description": "Ask transcript-safe, context-aware side questions in Pi with /qq or alt+q, then reopen recent answers with /qq-history.",
   "keywords": [
     "pi-package",
     "pi-extension",
@@ -9,7 +9,7 @@
     "side-question",
     "context-aware",
     "transcript-safe",
-    "no-history",
+    "history",
     "question",
     "shortcut",
     "keybinding",

package/qq-ui.ts

@@ -12,7 +12,7 @@
  *   Esc → abort in-flight call + dismiss
  *   ↑/↓ → scroll when content exceeds terminal
  *
- * Does not keep quick-question history.
+ * Used for both live /qq answers and view-only /qq-history.
  */
 
 import type { ExtensionCommandContext, Theme } from "@earendil-works/pi-coding-agent";
@@ -49,6 +49,7 @@ export interface ShowQqOverlayParams {
 	ctx: ExtensionCommandContext;
 	question: string;
 	controller: AbortController;
+	commandLabel?: string;
 }
 
 export interface ShowQqOverlayResult {
@@ -68,6 +69,7 @@ export class QqOverlayController implements Component {
 		private readonly tui: TUI,
 		private readonly done: (result?: undefined) => void,
 		private readonly controller: AbortController,
+		private readonly commandLabel: string = QQ_LITERAL,
 	) {}
 
 	setAnswer(text: string): void {
@@ -128,7 +130,7 @@ export class QqOverlayController implements Component {
 	}
 
 	private renderBanner(width: number): string {
-		const prefix = `${SIDE_PAD}${QQ_LITERAL} `;
+		const prefix = `${SIDE_PAD}${this.commandLabel} `;
 		const prefixWidth = visibleWidth(prefix);
 		const questionWidth = Math.max(0, width - prefixWidth);
 		const truncatedQuestion = truncateToWidth(this.question, questionWidth, "…", false);
@@ -170,7 +172,14 @@ export function showQqOverlay(params: ShowQqOverlayParams): ShowQqOverlayResult
 
 	const overlayPromise = params.ctx.ui.custom<void>(
 		(tui, theme, _keybindings, done) => {
-			const controller = new QqOverlayController(params.question, theme, tui, done, params.controller);
+			const controller = new QqOverlayController(
+				params.question,
+				theme,
+				tui,
+				done,
+				params.controller,
+				params.commandLabel,
+			);
 			resolveReady(controller);
 			return controller;
 		},

package/qq.ts

@@ -5,7 +5,7 @@
  * conversation as read-only context. The answer is rendered ephemerally in a
  * bottom-slot overlay and never enters the main session transcript.
  *
- * Does not keep quick-question history.
+ * Keeps in-memory, view-only answer history for /qq-history.
  */
 
 import { readFileSync } from "node:fs";
@@ -27,6 +27,7 @@ import {
 import { showQqOverlay } from "./qq-ui.js";
 
 export const QQ_COMMAND_NAME = "qq";
+export const QQ_HISTORY_COMMAND_NAME = "qq-history";
 export const QQ_PREFIX = `/${QQ_COMMAND_NAME} `;
 export const QQ_STATE_KEY = Symbol.for("pi-qq:qq");
 
@@ -34,6 +35,8 @@ const MSG_REQUIRES_INTERACTIVE = "/qq requires interactive mode";
 const MSG_USAGE = "Usage: /qq [--recent|--full] <question>";
 const MSG_NO_MODEL = "/qq requires an active model";
 const ERR_EMPTY_RESPONSE = "/qq returned no text content.";
+const MSG_NO_HISTORY = "No /qq history for this session yet";
+const QQ_HISTORY_LIMIT = 20;
 const RECENT_CONTEXT_MESSAGE_LIMIT = 12;
 const FULL_CONTEXT_HEAD_MESSAGE_LIMIT = 4;
 const FULL_CONTEXT_TAIL_MESSAGE_LIMIT = 80;
@@ -51,8 +54,15 @@ interface ParsedQqArgs {
 	mode: QqContextMode;
 }
 
+interface QqHistoryEntry {
+	question: string;
+	answer: string;
+	timestamp: number;
+}
+
 interface QqState {
 	snapshots: Map<string, { messages: Message[] }>;
+	histories: Map<string, QqHistoryEntry[]>;
 }
 
 export const QQ_SYSTEM_PROMPT = readFileSync(
@@ -61,13 +71,15 @@ export const QQ_SYSTEM_PROMPT = readFileSync(
 ).trimEnd();
 
 function getState(): QqState {
-	const globalState = globalThis as unknown as { [k: symbol]: QqState | undefined };
+	const globalState = globalThis as unknown as { [k: symbol]: Partial<QqState> | undefined };
 	let state = globalState[QQ_STATE_KEY];
 	if (!state) {
-		state = { snapshots: new Map() };
+		state = {};
 		globalState[QQ_STATE_KEY] = state;
 	}
-	return state;
+	state.snapshots ??= new Map();
+	state.histories ??= new Map();
+	return state as QqState;
 }
 
 function getSessionFile(ctx: ExtensionContext): string {
@@ -82,10 +94,45 @@ function setSnapshot(ctx: ExtensionContext, snapshot: { messages: Message[] }):
 	getState().snapshots.set(getSessionFile(ctx), snapshot);
 }
 
+function getSessionHistory(ctx: ExtensionContext): QqHistoryEntry[] {
+	const key = getSessionFile(ctx);
+	const state = getState();
+	let history = state.histories.get(key);
+	if (!history) {
+		history = [];
+		state.histories.set(key, history);
+	}
+	return history;
+}
+
+function pushSessionHistory(ctx: ExtensionContext, entry: QqHistoryEntry): void {
+	const history = getSessionHistory(ctx);
+	history.push(entry);
+	if (history.length > QQ_HISTORY_LIMIT) {
+		history.splice(0, history.length - QQ_HISTORY_LIMIT);
+	}
+}
+
 export function invalidateSnapshot(ctx: ExtensionContext): void {
 	getState().snapshots.delete(getSessionFile(ctx));
 }
 
+function formatHistoryTimestamp(timestamp: number): string {
+	return new Date(timestamp).toLocaleTimeString(undefined, { hour: "numeric", minute: "2-digit" });
+}
+
+function formatQqHistory(entries: QqHistoryEntry[]): string {
+	return entries
+		.slice()
+		.reverse()
+		.map((entry, index) => {
+			const question = entry.question.replace(/\s+/g, " ").trim();
+			const answer = entry.answer.trim();
+			return `${index + 1}. ${formatHistoryTimestamp(entry.timestamp)} — /qq ${question}\n${answer}`;
+		})
+		.join("\n\n");
+}
+
 export function assistantMessageText(msg: AssistantMessage): string {
 	return msg.content
 		.filter((content): content is { type: "text"; text: string } => content.type === "text")
@@ -344,6 +391,10 @@ export function registerQqCommand(pi: ExtensionAPI): void {
 		description: "Ask a quick question without polluting the main conversation",
 		handler: (args: string, ctx: ExtensionCommandContext) => handleQqCommand(args, ctx),
 	});
+	pi.registerCommand(QQ_HISTORY_COMMAND_NAME, {
+		description: "Show recent /qq answers for this session",
+		handler: (_args: string, ctx: ExtensionCommandContext) => handleQqHistoryCommand(ctx),
+	});
 }
 
 async function handleQqCommand(args: string, ctx: ExtensionCommandContext): Promise<void> {
@@ -372,6 +423,11 @@ async function handleQqCommand(args: string, ctx: ExtensionCommandContext): Prom
 	const result = await executeQq(parsedArgs.question, parsedArgs.mode, ctx, controller);
 
 	if (result.ok && result.answer) {
+		pushSessionHistory(ctx, {
+			question: parsedArgs.question,
+			answer: result.answer,
+			timestamp: Date.now(),
+		});
 		overlayCtl.setAnswer(result.answer);
 	} else if (result.aborted) {
 		// User Esc'd — overlay already dismissed via done(); no further action.
@@ -381,3 +437,27 @@ async function handleQqCommand(args: string, ctx: ExtensionCommandContext): Prom
 
 	await overlayPromise;
 }
+
+async function handleQqHistoryCommand(ctx: ExtensionCommandContext): Promise<void> {
+	if (!ctx.hasUI) {
+		ctx.ui.notify(MSG_REQUIRES_INTERACTIVE, "error");
+		return;
+	}
+	const history = getSessionHistory(ctx);
+	if (history.length === 0) {
+		ctx.ui.notify(MSG_NO_HISTORY, "info");
+		return;
+	}
+
+	const controller = new AbortController();
+	const { overlayPromise, controllerReady } = showQqOverlay({
+		ctx,
+		question: `${history.length} recent answer${history.length === 1 ? "" : "s"}`,
+		controller,
+		commandLabel: "/qq-history",
+	});
+
+	const overlayCtl = await controllerReady;
+	overlayCtl.setAnswer(formatQqHistory(history));
+	await overlayPromise;
+}