@lnittman/pi-interview 0.4.0

package/README.md

@@ -0,0 +1,33 @@
+# pi-quiz
+
+> Multiple-choice next-prompt quiz for [pi](https://github.com/badlogic/pi-mono)
+
+After each agent turn, generates structured multiple-choice questions to help you decide what to do next. Every question has options — no blank text fields.
+
+## Install
+
+```json
+{
+  "extensions": ["/path/to/pi-quiz/dist/index.js"]
+}
+```
+
+## How it works
+
+1. Agent finishes → pi-quiz analyzes the conversation
+2. Calls haiku to generate 1-3 multiple-choice questions
+3. Shows an interactive quiz in the TUI
+4. You pick options (or "Type something else...")
+5. Composed prompt lands in your editor
+
+## Usage
+
+**Auto mode** (default): Quiz appears after substantial agent turns.
+
+**Manual**: `/quiz config mode manual`, then `Ctrl+Q` or `/quiz ask`.
+
+**Number keys** for instant pick. `Tab` between questions. `Esc` to dismiss.
+
+## License
+
+MIT

package/dist/adapters/model-client.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Model client for pi-interview.
+ * Uses getApiKeyAndHeaders (correct pi API).
+ */
+import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
+import { completeSimple } from "@mariozechner/pi-ai";
+import type { QuizResult, QuizConfig } from "../core/types.js";
+import type { QuizPromptContext } from "../prompts/interview-template.js";
+type CompleteSimpleFn = typeof completeSimple;
+interface RuntimeProvider {
+    getContext(): ExtensionContext | undefined;
+}
+export declare class QuizModelClient {
+    private runtime;
+    private completeFn;
+    constructor(runtime: RuntimeProvider, completeFn: CompleteSimpleFn);
+    generateQuiz(promptContext: QuizPromptContext, config: QuizConfig): Promise<QuizResult>;
+}
+export {};
+//# sourceMappingURL=model-client.d.ts.map

package/dist/adapters/model-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-client.d.ts","sourceRoot":"","sources":["../../src/adapters/model-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EACV,UAAU,EAEV,UAAU,EAEX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAG1E,KAAK,gBAAgB,GAAG,OAAO,cAAc,CAAC;AAE9C,UAAU,eAAe;IACvB,UAAU,IAAI,gBAAgB,GAAG,SAAS,CAAC;CAC5C;AAiFD,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,UAAU,CAAmB;gBAEzB,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,gBAAgB;IAK5D,YAAY,CAChB,aAAa,EAAE,iBAAiB,EAChC,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,UAAU,CAAC;CAkEvB"}

package/dist/adapters/model-client.js

@@ -0,0 +1,129 @@
+/**
+ * Model client for pi-interview.
+ * Uses getApiKeyAndHeaders (correct pi API).
+ */
+import { renderQuizPrompt } from "../prompts/interview-template.js";
+function resolveModel(ctx, configuredModelRef) {
+    const allModels = ctx.modelRegistry.getAll();
+    if (configuredModelRef && configuredModelRef !== "session-default") {
+        const [provider, id] = configuredModelRef.split("/");
+        const found = allModels.find((m) => m.provider === provider && m.id === id);
+        if (found)
+            return found;
+        const byId = allModels.find((m) => m.id === configuredModelRef);
+        if (byId)
+            return byId;
+    }
+    return ctx.model;
+}
+function parseQuizResponse(text, maxQuestions, maxOptions) {
+    let cleaned = text.trim();
+    if (cleaned.startsWith("```")) {
+        cleaned = cleaned.replace(/^```(?:json)?\s*\n?/, "").replace(/\n?```\s*$/, "");
+    }
+    const jsonMatch = cleaned.match(/\{[\s\S]*\}/);
+    if (!jsonMatch) {
+        return { questions: [], skipped: true, skipReason: "Failed to parse response" };
+    }
+    try {
+        const parsed = JSON.parse(jsonMatch[0]);
+        if (parsed.skipped === true) {
+            return {
+                questions: [],
+                skipped: true,
+                skipReason: parsed.skipReason || "Model chose to skip",
+            };
+        }
+        if (!Array.isArray(parsed.questions)) {
+            return { questions: [], skipped: true, skipReason: "No questions array" };
+        }
+        const questions = parsed.questions
+            .slice(0, maxQuestions)
+            .map((q, i) => ({
+            id: q.id || `q${i + 1}`,
+            text: String(q.text || "").slice(0, 120),
+            // Always multi — user picks one or more with checkboxes
+            type: "multi",
+            options: Array.isArray(q.options)
+                ? q.options.slice(0, maxOptions).map((o) => ({
+                    label: String(o.label || "").slice(0, 80),
+                    description: o.description
+                        ? String(o.description).slice(0, 100)
+                        : undefined,
+                }))
+                : [],
+        }))
+            .filter((q) => q.text.length > 0 && q.options.length >= 2);
+        return {
+            questions,
+            skipped: questions.length === 0,
+            skipReason: questions.length === 0 ? "No valid questions generated" : undefined,
+        };
+    }
+    catch {
+        return { questions: [], skipped: true, skipReason: "JSON parse error" };
+    }
+}
+export class QuizModelClient {
+    runtime;
+    completeFn;
+    constructor(runtime, completeFn) {
+        this.runtime = runtime;
+        this.completeFn = completeFn;
+    }
+    async generateQuiz(promptContext, config) {
+        const ctx = this.runtime.getContext();
+        if (!ctx?.model) {
+            return { questions: [], skipped: true, skipReason: "No model available" };
+        }
+        const model = resolveModel(ctx, config.model);
+        if (!model) {
+            return { questions: [], skipped: true, skipReason: "Configured model not found" };
+        }
+        const auth = await ctx.modelRegistry.getApiKeyAndHeaders(model);
+        if (!auth.ok) {
+            return { questions: [], skipped: true, skipReason: `Auth failed: ${auth.error}` };
+        }
+        const prompt = renderQuizPrompt(promptContext);
+        try {
+            const response = await this.completeFn(model, {
+                systemPrompt: "You generate multiple-choice interview questions for a coding agent session. Return ONLY valid JSON. Every question MUST have options grounded in specific files, errors, and tool outputs from the context — never generic options. No text-only questions.",
+                messages: [
+                    {
+                        role: "user",
+                        content: [{ type: "text", text: prompt }],
+                        timestamp: Date.now(),
+                    },
+                ],
+            }, {
+                apiKey: auth.apiKey,
+                headers: auth.headers,
+                reasoning: config.thinkingLevel === "off" ? undefined : config.thinkingLevel,
+            });
+            const text = response.content
+                .filter((block) => block.type === "text")
+                .map((block) => block.text)
+                .join("\n");
+            const usage = response.usage
+                ? {
+                    inputTokens: response.usage.input ?? 0,
+                    outputTokens: response.usage.output ?? 0,
+                    totalTokens: response.usage.totalTokens ?? 0,
+                    costTotal: response.usage.cost?.total ?? 0,
+                }
+                : undefined;
+            const result = parseQuizResponse(text, config.maxQuestions, config.maxOptions);
+            result.usage = usage;
+            return result;
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            return {
+                questions: [],
+                skipped: true,
+                skipReason: `Generation failed: ${msg.slice(0, 100)}`,
+            };
+        }
+    }
+}
+//# sourceMappingURL=model-client.js.map

package/dist/adapters/model-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-client.js","sourceRoot":"","sources":["../../src/adapters/model-client.ts"],"names":[],"mappings":"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"}

package/dist/core/demo.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Demo turn contexts for testing pi-quiz without a real agent session.
+ * Used by /quiz demo command.
+ */
+import type { TurnContext } from "./types.js";
+export declare const DEMO_TURNS: Record<string, TurnContext>;
+export declare function getDemoTurn(scenario?: string): TurnContext;
+export declare function listDemoScenarios(): string[];
+//# sourceMappingURL=demo.d.ts.map

package/dist/core/demo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo.d.ts","sourceRoot":"","sources":["../../src/core/demo.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAyGlD,CAAC;AAEF,wBAAgB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,CAO1D;AAED,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAE5C"}

package/dist/core/demo.js

@@ -0,0 +1,118 @@
+/**
+ * Demo turn contexts for testing pi-quiz without a real agent session.
+ * Used by /quiz demo command.
+ */
+export const DEMO_TURNS = {
+    /** Agent just built something and finished */
+    build: {
+        turnId: "demo-build",
+        sourceLeafId: "demo-build",
+        assistantText: `I've implemented the authentication module with JWT token refresh. Created src/auth/jwt.ts with token generation and validation, updated src/middleware/auth.ts to use the new JWT flow, and added tests in src/auth/__tests__/jwt.test.ts. All 12 existing tests pass, but the 3 new token refresh tests are failing because the mock Redis client doesn't support TTL operations. The linting also shows 2 warnings in auth.ts about unused imports from the old session-based auth that I didn't remove yet.`,
+        status: "success",
+        occurredAt: new Date().toISOString(),
+        recentUserPrompts: [
+            "implement JWT auth with token refresh",
+            "yes, use the existing middleware pattern",
+        ],
+        toolSignals: [
+            "write(src/auth/jwt.ts)",
+            "edit(src/middleware/auth.ts)",
+            "write(src/auth/__tests__/jwt.test.ts)",
+            "bash(npm test)",
+            "bash(npm run lint)",
+        ],
+        touchedFiles: [
+            "src/auth/jwt.ts",
+            "src/middleware/auth.ts",
+            "src/auth/__tests__/jwt.test.ts",
+        ],
+        unresolvedQuestions: [],
+    },
+    /** Agent hit errors */
+    error: {
+        turnId: "demo-error",
+        sourceLeafId: "demo-error",
+        assistantText: `I tried to run the migration but hit an error. The database connection to the staging environment timed out after 30s. The migration file packages/db/migrations/003_add_user_roles.sql looks correct syntactically, but the connection string in .env.staging might be stale — the last successful connection was 3 days ago. I also noticed the docker-compose.staging.yml has the old port mapping (5432:5432) while the staging DB was moved to port 5433 last week.`,
+        status: "error",
+        occurredAt: new Date().toISOString(),
+        recentUserPrompts: [
+            "run the staging migration",
+            "use the new roles table schema",
+        ],
+        toolSignals: [
+            "read(packages/db/migrations/003_add_user_roles.sql)",
+            "read(.env.staging)",
+            "bash(npx knex migrate:latest --env staging):error",
+            "read(docker-compose.staging.yml)",
+        ],
+        touchedFiles: [],
+        unresolvedQuestions: [],
+    },
+    /** Agent was interrupted */
+    aborted: {
+        turnId: "demo-aborted",
+        sourceLeafId: "demo-aborted",
+        assistantText: `I was in the middle of refactoring the notification service. So far I've split src/services/notifications.ts into three files: src/services/notifications/email.ts, src/services/notifications/push.ts, and src/services/notifications/index.ts. The email module is complete but push notifications are half-done — I was updating the Firebase config when you interrupted. The old monolithic file still exists and the imports in src/api/routes/alerts.ts and src/workers/digest.ts still point to it.`,
+        status: "aborted",
+        occurredAt: new Date().toISOString(),
+        recentUserPrompts: [
+            "refactor the notification service into separate modules",
+        ],
+        toolSignals: [
+            "write(src/services/notifications/email.ts)",
+            "write(src/services/notifications/push.ts)",
+            "write(src/services/notifications/index.ts)",
+            "read(src/services/notifications.ts)",
+            "edit(src/services/notifications/push.ts)",
+        ],
+        touchedFiles: [
+            "src/services/notifications/email.ts",
+            "src/services/notifications/push.ts",
+            "src/services/notifications/index.ts",
+        ],
+        unresolvedQuestions: [],
+        abortContextNote: "User interrupted mid-refactor. Push notification module is incomplete, old file still exists, imports not updated.",
+    },
+    /** Agent asked questions */
+    questions: {
+        turnId: "demo-questions",
+        sourceLeafId: "demo-questions",
+        assistantText: `I've analyzed the codebase and have a few questions before proceeding with the API redesign:
+
+1. The current REST endpoints in src/api/v1/ use Express middleware chains. Should we keep Express or migrate to Hono for the v2 API?
+2. The auth tokens are currently stored in Redis with a 24h TTL. Should v2 tokens use shorter TTLs with refresh, or keep the current approach?
+3. There are 47 endpoints total. Should we migrate all at once, or start with the 12 high-traffic endpoints in src/api/v1/core/?
+4. The OpenAPI spec in docs/api.yaml is 6 months stale. Should I regenerate it as part of this work?`,
+        status: "success",
+        occurredAt: new Date().toISOString(),
+        recentUserPrompts: [
+            "let's redesign the API for v2",
+            "focus on performance and developer experience",
+        ],
+        toolSignals: [
+            "bash(find src/api -name '*.ts' | wc -l)",
+            "read(src/api/v1/core/users.ts)",
+            "read(docs/api.yaml)",
+            "outline(src/api/)",
+        ],
+        touchedFiles: [],
+        unresolvedQuestions: [
+            "Should we keep Express or migrate to Hono for the v2 API?",
+            "Should v2 tokens use shorter TTLs with refresh, or keep the current approach?",
+            "Should we migrate all at once, or start with the 12 high-traffic endpoints in src/api/v1/core/?",
+            "Should I regenerate the OpenAPI spec in docs/api.yaml as part of this work?",
+        ],
+    },
+};
+export function getDemoTurn(scenario) {
+    if (scenario && scenario in DEMO_TURNS) {
+        return DEMO_TURNS[scenario];
+    }
+    // Random demo
+    const keys = Object.keys(DEMO_TURNS);
+    return DEMO_TURNS[keys[Math.floor(Math.random() * keys.length)]];
+}
+export function listDemoScenarios() {
+    return Object.keys(DEMO_TURNS);
+}
+//# sourceMappingURL=demo.js.map

package/dist/core/demo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo.js","sourceRoot":"","sources":["../../src/core/demo.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,CAAC,MAAM,UAAU,GAAgC;IACrD,8CAA8C;IAC9C,KAAK,EAAE;QACL,MAAM,EAAE,YAAY;QACpB,YAAY,EAAE,YAAY;QAC1B,aAAa,EAAE,ifAAif;QAChgB,MAAM,EAAE,SAAS;QACjB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,iBAAiB,EAAE;YACjB,uCAAuC;YACvC,0CAA0C;SAC3C;QACD,WAAW,EAAE;YACX,wBAAwB;YACxB,8BAA8B;YAC9B,uCAAuC;YACvC,gBAAgB;YAChB,oBAAoB;SACrB;QACD,YAAY,EAAE;YACZ,iBAAiB;YACjB,wBAAwB;YACxB,gCAAgC;SACjC;QACD,mBAAmB,EAAE,EAAE;KACxB;IAED,uBAAuB;IACvB,KAAK,EAAE;QACL,MAAM,EAAE,YAAY;QACpB,YAAY,EAAE,YAAY;QAC1B,aAAa,EAAE,0cAA0c;QACzd,MAAM,EAAE,OAAO;QACf,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,iBAAiB,EAAE;YACjB,2BAA2B;YAC3B,gCAAgC;SACjC;QACD,WAAW,EAAE;YACX,qDAAqD;YACrD,oBAAoB;YACpB,mDAAmD;YACnD,kCAAkC;SACnC;QACD,YAAY,EAAE,EAAE;QAChB,mBAAmB,EAAE,EAAE;KACxB;IAED,4BAA4B;IAC5B,OAAO,EAAE;QACP,MAAM,EAAE,cAAc;QACtB,YAAY,EAAE,cAAc;QAC5B,aAAa,EAAE,6eAA6e;QAC5f,MAAM,EAAE,SAAS;QACjB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,iBAAiB,EAAE;YACjB,yDAAyD;SAC1D;QACD,WAAW,EAAE;YACX,4CAA4C;YAC5C,2CAA2C;YAC3C,4CAA4C;YAC5C,qCAAqC;YACrC,0CAA0C;SAC3C;QACD,YAAY,EAAE;YACZ,qCAAqC;YACrC,oCAAoC;YACpC,qCAAqC;SACtC;QACD,mBAAmB,EAAE,EAAE;QACvB,gBAAgB,EACd,oHAAoH;KACvH;IAED,4BAA4B;IAC5B,SAAS,EAAE;QACT,MAAM,EAAE,gBAAgB;QACxB,YAAY,EAAE,gBAAgB;QAC9B,aAAa,EAAE;;;;;qGAKkF;QACjG,MAAM,EAAE,SAAS;QACjB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,iBAAiB,EAAE;YACjB,+BAA+B;YAC/B,+CAA+C;SAChD;QACD,WAAW,EAAE;YACX,yCAAyC;YACzC,gCAAgC;YAChC,qBAAqB;YACrB,mBAAmB;SACpB;QACD,YAAY,EAAE,EAAE;QAChB,mBAAmB,EAAE;YACnB,2DAA2D;YAC3D,+EAA+E;YAC/E,iGAAiG;YACjG,6EAA6E;SAC9E;KACF;CACF,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,QAAiB;IAC3C,IAAI,QAAQ,IAAI,QAAQ,IAAI,UAAU,EAAE,CAAC;QACvC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IACD,cAAc;IACd,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrC,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACjC,CAAC"}

package/dist/core/project-context.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Lightweight project context for pi-quiz.
+ *
+ * Instead of prompt-suggester's heavy agentic seeding loop,
+ * we do a fast one-shot scan: package.json + git status + cwd name.
+ * Gives the model just enough project awareness to generate grounded questions.
+ */
+export interface ProjectSnapshot {
+    /** Project name from package.json or directory */
+    name: string;
+    /** Brief description from package.json */
+    description?: string;
+    /** Key scripts available */
+    scripts: string[];
+    /** Current git branch */
+    branch?: string;
+    /** Whether there are uncommitted changes */
+    dirty: boolean;
+    /** Recent commit subjects (last 3) */
+    recentCommits: string[];
+}
+/**
+ * Build a fast project snapshot from cwd.
+ * Designed to complete in <500ms.
+ */
+export declare function buildProjectSnapshot(cwd: string): Promise<ProjectSnapshot>;
+/**
+ * Format project snapshot as a compact string for the prompt.
+ */
+export declare function formatProjectContext(snapshot: ProjectSnapshot): string;
+//# sourceMappingURL=project-context.d.ts.map

package/dist/core/project-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context.d.ts","sourceRoot":"","sources":["../../src/core/project-context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,KAAK,EAAE,OAAO,CAAC;IACf,sCAAsC;IACtC,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AA4BD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,eAAe,CAAC,CA2B1B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAgBtE"}

package/dist/core/project-context.js

@@ -0,0 +1,82 @@
+/**
+ * Lightweight project context for pi-quiz.
+ *
+ * Instead of prompt-suggester's heavy agentic seeding loop,
+ * we do a fast one-shot scan: package.json + git status + cwd name.
+ * Gives the model just enough project awareness to generate grounded questions.
+ */
+import { execFile } from "node:child_process";
+import { readFile } from "node:fs/promises";
+import { basename, join } from "node:path";
+import { promisify } from "node:util";
+const exec = promisify(execFile);
+async function tryExec(cmd, args, cwd) {
+    try {
+        const { stdout } = await exec(cmd, args, {
+            cwd,
+            timeout: 3000,
+            env: { ...process.env, GIT_TERMINAL_PROMPT: "0" },
+        });
+        return stdout.trim();
+    }
+    catch {
+        return "";
+    }
+}
+async function tryReadJson(path) {
+    try {
+        const content = await readFile(path, "utf8");
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Build a fast project snapshot from cwd.
+ * Designed to complete in <500ms.
+ */
+export async function buildProjectSnapshot(cwd) {
+    // Run all lookups in parallel
+    const [pkg, branch, status, log] = await Promise.all([
+        tryReadJson(join(cwd, "package.json")),
+        tryExec("git", ["rev-parse", "--abbrev-ref", "HEAD"], cwd),
+        tryExec("git", ["status", "--porcelain", "--short"], cwd),
+        tryExec("git", ["log", "--oneline", "-3", "--no-decorate"], cwd),
+    ]);
+    const name = pkg?.name ?? basename(cwd);
+    const description = pkg?.description;
+    // Extract key script names (not the commands themselves)
+    const allScripts = Object.keys(pkg?.scripts ?? {});
+    const keyScripts = allScripts.filter((s) => /^(dev|build|test|lint|start|deploy|typecheck|verify)/.test(s));
+    const scripts = keyScripts.length > 0 ? keyScripts.slice(0, 8) : allScripts.slice(0, 5);
+    return {
+        name,
+        description,
+        scripts,
+        branch: branch || undefined,
+        dirty: status.length > 0,
+        recentCommits: log ? log.split("\n").filter(Boolean).slice(0, 3) : [],
+    };
+}
+/**
+ * Format project snapshot as a compact string for the prompt.
+ */
+export function formatProjectContext(snapshot) {
+    const lines = [];
+    lines.push(`Project: ${snapshot.name}${snapshot.description ? ` — ${snapshot.description}` : ""}`);
+    if (snapshot.branch) {
+        lines.push(`Branch: ${snapshot.branch}${snapshot.dirty ? " (dirty)" : ""}`);
+    }
+    if (snapshot.scripts.length > 0) {
+        lines.push(`Scripts: ${snapshot.scripts.join(", ")}`);
+    }
+    if (snapshot.recentCommits.length > 0) {
+        lines.push(`Recent commits:`);
+        for (const c of snapshot.recentCommits) {
+            lines.push(`  ${c}`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=project-context.js.map

package/dist/core/project-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context.js","sourceRoot":"","sources":["../../src/core/project-context.ts"],"names":[],"mappings":"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"}

package/dist/core/signals.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Conversation signal extraction — builds TurnContext from pi session data.
+ * Adapted from pi-prompt-suggester's conversation-signals.ts with simplifications.
+ */
+import type { TurnContext } from "./types.js";
+interface AgentMessage {
+    role: string;
+    content?: unknown;
+    stopReason?: string;
+    timestamp?: number;
+    toolName?: string;
+    isError?: boolean;
+    usage?: {
+        input?: number;
+        output?: number;
+        totalTokens?: number;
+        cost?: {
+            total?: number;
+        };
+    };
+}
+interface BranchEntry {
+    id: string;
+    type: string;
+    message: AgentMessage;
+}
+/**
+ * Build turn context from agent_end event messages + full branch.
+ * Returns null if no usable assistant message found.
+ */
+export declare function buildTurnContext(params: {
+    turnId: string;
+    sourceLeafId: string;
+    messagesFromPrompt: AgentMessage[];
+    branchMessages: AgentMessage[];
+    occurredAt: string;
+}): TurnContext | null;
+/**
+ * Build turn context from the latest branch entries (for session restore).
+ */
+export declare function buildTurnContextFromBranch(branchEntries: BranchEntry[]): TurnContext | null;
+export {};
+//# sourceMappingURL=signals.d.ts.map

package/dist/core/signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../src/core/signals.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAI1D,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC3B,CAAC;CACH;AAED,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;CACvB;AAmFD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,YAAY,EAAE,CAAC;IACnC,cAAc,EAAE,YAAY,EAAE,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,WAAW,GAAG,IAAI,CAkDrB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,WAAW,EAAE,GAC3B,WAAW,GAAG,IAAI,CAsCpB"}