@rol1n/prompt-snipaste 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,27 @@
-# Temporary Holding Version
+# prompt-snipaste
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Select prompt snippets to prepend or append to the next user message, with live preview and a session transcript card. Bundles 7 built-in prompt snippets under `prompts/`.
+
+## Install
+
+```sh
+pi install npm:@rol1n/prompt-snipaste
+```
+
+Also included in `@rol1n/pi-kit`.
+
+## Use
+
+Open with `/snipaste` or `Alt+S`. Navigate with arrow keys, toggle with `Space`, preview with `Tab`, confirm with `Enter`, and cancel with `Escape`.
+
+## Frontmatter
+
+```markdown
+---
+name: Review checklist
+description: Add review criteria to the next message
+placement: append
+order: 100
+---
+Check correctness, error handling, and missing validation.
+```

package/index.ts

@@ -0,0 +1,143 @@
+/** Select prompt snippets for the next user message with /snipaste or Alt+S. */
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { Key } from "@earendil-works/pi-tui";
+import type { PromptCardData, Snippet } from "./types.ts";
+import { loadSnippets } from "./snippets.ts";
+import { showSnippetMenu } from "./menu.ts";
+import { buildPromptCardComponent, updateSnippetWidget } from "./renderers.ts";
+
+export default function promptSnipaste(pi: ExtensionAPI) {
+	let enabled = new Set<string>();
+	let snippets: Snippet[] = [];
+
+	function updateWidget(ctx: ExtensionContext) {
+		updateSnippetWidget(ctx, () => ({ snippets, enabled }));
+	}
+
+	async function openMenu(ctx: ExtensionContext) {
+		if (ctx.mode !== "tui") {
+			ctx.ui.notify("Prompt snippets menu is only available in interactive terminals", "warning");
+			return;
+		}
+
+		snippets = loadSnippets(ctx.cwd, pi);
+		enabled = new Set([...enabled].filter((id) => snippets.some((s) => s.id === id)));
+
+		if (snippets.length === 0) {
+			ctx.ui.notify("No Markdown files found in prompt directories", "warning");
+			updateWidget(ctx);
+			return;
+		}
+
+		const working = new Set(enabled);
+
+		const confirmed = await showSnippetMenu(ctx, snippets, working);
+
+		if (confirmed) {
+			enabled = working;
+		}
+		updateWidget(ctx);
+	}
+
+	let pendingTurnSnippets: Snippet[] | null = null;
+
+	pi.registerEntryRenderer<PromptCardData>("prompt-snipaste-card", (entry, _options, theme) => {
+		const data = entry.data;
+		if (!data?.snippets || data.snippets.length === 0) return undefined;
+		return buildPromptCardComponent(data.snippets, theme);
+	});
+
+	pi.on("session_start", (_event, ctx) => {
+		enabled = new Set();
+		pendingTurnSnippets = null;
+		snippets = loadSnippets(ctx.cwd, pi);
+		updateWidget(ctx);
+	});
+
+	pi.on("input", async (_event, ctx) => {
+		if (enabled.size === 0) return undefined;
+
+		snippets = loadSnippets(ctx.cwd, pi);
+		const active = snippets.filter((s) => enabled.has(s.id));
+		enabled = new Set();
+		updateWidget(ctx);
+
+		if (active.length === 0) return undefined;
+
+		pendingTurnSnippets = active;
+
+		pi.appendEntry<PromptCardData>("prompt-snipaste-card", {
+			snippets: active.map((s) => ({
+				id: s.id,
+				name: s.name,
+				placement: s.placement,
+				order: s.order,
+				body: s.body,
+			})),
+		});
+
+		return undefined;
+	});
+
+	pi.on("context", async (event, _ctx) => {
+		if (!pendingTurnSnippets || pendingTurnSnippets.length === 0) return undefined;
+
+		const active = pendingTurnSnippets;
+		pendingTurnSnippets = null;
+
+		const prepends = active.filter((s) => s.placement === "prepend");
+		const appends = active.filter((s) => s.placement === "append");
+
+		const messages = [...event.messages];
+		for (let i = messages.length - 1; i >= 0; i--) {
+			const msg = messages[i];
+			if (msg.role === "user") {
+				if (typeof msg.content === "string") {
+					const parts: string[] = [];
+
+					if (prepends.length > 0) {
+						parts.push(prepends.map((s) => s.body.trim()).join("\n\n"));
+					}
+					if (msg.content.trim()) {
+						parts.push(msg.content.trim());
+					}
+					if (appends.length > 0) {
+						parts.push(appends.map((s) => s.body.trim()).join("\n\n"));
+					}
+
+					messages[i] = {
+						...msg,
+						content: parts.join("\n\n"),
+					};
+				} else if (Array.isArray(msg.content)) {
+					const prependText = prepends.map((s) => s.body.trim()).join("\n\n");
+					const appendText = appends.map((s) => s.body.trim()).join("\n\n");
+					const newContent = [...msg.content];
+					if (prependText) {
+						newContent.unshift({ type: "text", text: prependText });
+					}
+					if (appendText) {
+						newContent.push({ type: "text", text: appendText });
+					}
+					messages[i] = {
+						...msg,
+						content: newContent as any,
+					};
+				}
+				return { messages };
+			}
+		}
+
+		return undefined;
+	});
+
+	pi.registerCommand("snipaste", {
+		description: "Select prepended or appended prompt snippets to inject into the next message",
+		handler: (_args, ctx) => openMenu(ctx),
+	});
+
+	pi.registerShortcut(Key.alt("s"), {
+		description: "Open prompt snippets menu",
+		handler: (ctx) => openMenu(ctx),
+	});
+}

package/menu.ts

@@ -0,0 +1,159 @@
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { Key, matchesKey, truncateToWidth, visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
+import type { Snippet } from "./types.ts";
+
+/** Edit a working selection; the caller commits it only after confirmation. */
+export function showSnippetMenu(ctx: ExtensionContext, snippets: Snippet[], working: Set<string>): Promise<boolean> {
+	return ctx.ui.custom<boolean>((tui, theme, _keybindings, done) => {
+		const prepends = snippets.filter((s) => s.placement === "prepend");
+		const appends = snippets.filter((s) => s.placement === "append");
+		const items = [...prepends, ...appends];
+
+		let mode: "list" | "preview" = "list";
+		let cursor = 0;
+		let listScroll = 0;
+		let previewScroll = 0;
+
+		const itemRow = (snippet: Snippet, idx: number, width: number): string => {
+			const pointer = idx === cursor ? theme.fg("accent", "> ") : "  ";
+			const checkbox = working.has(snippet.id) ? theme.fg("success", "[x]") : theme.fg("dim", "[ ]");
+			const desc = snippet.description ? theme.fg("dim", ` — ${snippet.description}`) : "";
+			return truncateToWidth(`${pointer}${checkbox} ${theme.bold(snippet.name)}${desc}`, width);
+		};
+
+		const buildListRows = (width: number): { text: string; itemIndex: number | null }[] => {
+			const rows: { text: string; itemIndex: number | null }[] = [];
+			rows.push({ text: theme.fg("dim", "↑ Prepend Prompts"), itemIndex: null });
+			prepends.forEach((s, i) => rows.push({ text: itemRow(s, i, width), itemIndex: i }));
+			rows.push({ text: "", itemIndex: null });
+			rows.push({ text: theme.fg("dim", "↓ Append Prompts"), itemIndex: null });
+			appends.forEach((s, i) => rows.push({ text: itemRow(s, prepends.length + i, width), itemIndex: prepends.length + i }));
+			return rows;
+		};
+
+		const buildPreviewRows = (snippet: Snippet, width: number): string[] => {
+			const rows: string[] = [];
+			rows.push(truncateToWidth(theme.bold(snippet.name), width));
+			rows.push(truncateToWidth(theme.fg("dim", `${snippet.placement === "prepend" ? "Prepend" : "Append"} · Order ${snippet.order} · ${snippet.id}`), width));
+			rows.push(theme.fg("dim", "─".repeat(Math.min(width, 40))));
+			for (const line of snippet.body.split("\n")) {
+				for (const wrapped of wrapTextWithAnsi(line, width)) {
+					rows.push(truncateToWidth(wrapped, width));
+				}
+			}
+			return rows;
+		};
+
+		const viewport = (
+			lines: string[],
+			scroll: number,
+			maxView: number,
+			focusRow?: number,
+		): { out: string[]; scroll: number } => {
+			const clipped = lines.length > maxView;
+			const view = clipped ? Math.max(1, maxView - 2) : maxView;
+
+			let s = Math.min(Math.max(0, scroll), Math.max(0, lines.length - view));
+			if (focusRow !== undefined) {
+				if (focusRow < s) s = focusRow;
+				else if (focusRow >= s + view) s = focusRow - view + 1;
+			}
+
+			const visible = lines.slice(s, s + view);
+			if (!clipped) return { out: visible, scroll: s };
+
+			const above = s;
+			const below = lines.length - (s + view);
+			return {
+				out: [
+					above > 0 ? theme.fg("dim", `  ↑ ${above} more`) : "",
+					...visible,
+					below > 0 ? theme.fg("dim", `  ↓ ${below} more`) : "",
+				],
+				scroll: s,
+			};
+		};
+
+		return {
+			render(width: number): string[] {
+				const maxView = Math.max(5, tui.terminal.rows - 10);
+
+				let content: string[];
+				let title: string;
+				let hints: string;
+				if (mode === "list") {
+					const rows = buildListRows(width);
+					const cursorRow = rows.findIndex((r) => r.itemIndex === cursor);
+					const v = viewport(rows.map((r) => r.text), listScroll, maxView, cursorRow);
+					content = v.out;
+					listScroll = v.scroll;
+					title = "Prompt Snippets";
+					hints = "↑↓ Navigate • Space Select • Tab Preview • Enter Confirm • Esc Cancel";
+				} else {
+					const snippet = items[cursor];
+					const rows = buildPreviewRows(snippet, width);
+					const v = viewport(rows, previewScroll, maxView);
+					content = v.out;
+					previewScroll = v.scroll;
+					title = `Preview: ${snippet.name}`;
+					hints = "↑↓ Scroll • Tab/Esc Back to list";
+				}
+
+				const innerW = width - 4;
+				const titleVisW = visibleWidth(title);
+				const hintsVisW = visibleWidth(hints);
+				const titlePad = Math.max(0, innerW - titleVisW);
+				const hintsPad = Math.max(0, innerW - hintsVisW);
+
+				const rawLines = [
+					theme.fg("border", `╭─ ${theme.bold(title)} ${"─".repeat(titlePad)}╮`),
+					...content.map((l) => {
+						const pad = Math.max(0, innerW - visibleWidth(l));
+						return theme.fg("border", "│ ") + l + " ".repeat(pad) + theme.fg("border", " │");
+					}),
+					theme.fg("border", `├${"─".repeat(innerW + 2)}┤`),
+					theme.fg("border", "│ ") + theme.fg("dim", hints) + " ".repeat(hintsPad) + theme.fg("border", " │"),
+					theme.fg("border", `╰${"─".repeat(innerW + 2)}╯`),
+				];
+
+				return rawLines.map((line) => truncateToWidth(line, width));
+			},
+			invalidate() {},
+			handleInput(data: string) {
+				if (mode === "list") {
+					if (matchesKey(data, Key.up)) {
+						cursor = (cursor - 1 + items.length) % items.length;
+						tui.requestRender();
+					} else if (matchesKey(data, Key.down)) {
+						cursor = (cursor + 1) % items.length;
+						tui.requestRender();
+					} else if (matchesKey(data, Key.space)) {
+						const id = items[cursor].id;
+						if (working.has(id)) working.delete(id);
+						else working.add(id);
+						tui.requestRender();
+					} else if (matchesKey(data, Key.tab)) {
+						mode = "preview";
+						previewScroll = 0;
+						tui.requestRender();
+					} else if (matchesKey(data, Key.enter)) {
+						done(true);
+					} else if (matchesKey(data, Key.escape)) {
+						done(false);
+					}
+				} else {
+					if (matchesKey(data, Key.up)) {
+						previewScroll--;
+						tui.requestRender();
+					} else if (matchesKey(data, Key.down)) {
+						previewScroll++;
+						tui.requestRender();
+					} else if (matchesKey(data, Key.tab) || matchesKey(data, Key.escape)) {
+						mode = "list";
+						tui.requestRender();
+					}
+				}
+			},
+		};
+	});
+}

package/package.json

@@ -1,6 +1,41 @@
 {
   "name": "@rol1n/prompt-snipaste",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "type": "module",
+  "description": "prompt-snipaste extension from pi-kit",
+  "keywords": [
+    "pi-package"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RolinShmily/pi-kit.git",
+    "directory": "prompt-snipaste"
+  },
+  "homepage": "https://github.com/RolinShmily/pi-kit#readme",
+  "bugs": {
+    "url": "https://github.com/RolinShmily/pi-kit/issues"
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-agent-core": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
+    "typebox": "*"
+  },
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "skills": [],
+    "prompts": [
+      "./prompts"
+    ],
+    "themes": []
+  }
+}

package/prompts/ask-questions.md

@@ -0,0 +1,8 @@
+---
+name: Ask questions
+description: Ask questions to reach a shared understanding.
+placement: append
+order: 10
+---
+Use the `ask_user_question` tool to ask questions until you are 100% sure you know exactly what to do.
+Do not act on this until I confirm we have reached a shared understanding.

package/prompts/delegate-exploration.md

@@ -0,0 +1,7 @@
+---
+name: Delegate exploration
+description: Keep context lean. Subagents explore, you verify critical parts
+placement: append
+order: 30
+---
+Keep your context window lean. Delegate codebase exploration to subagents — ask them specific, targeted questions instead of reading many files yourself. Read files directly only to verify critical parts.

package/prompts/diagnose-report.md

@@ -0,0 +1,7 @@
+---
+name: Diagnose, don't fix
+description: Read-only, report findings and a proposed fix
+placement: append
+order: 40
+---
+Investigate and diagnose the issue. Do not change any code. Report back with your findings and a proposed fix. Do not apply the fix yet.

package/prompts/frontend-tech-preset.md

@@ -0,0 +1,18 @@
+---
+name: Frontend tech preset
+description: Reuse a unified React/Next.js frontend stack
+placement: prepend
+order: 15
+---
+For new frontend work, prefer this [React](https://react.dev/) stack; respect existing project constraints. Reuse mature components, keep one design language, avoid overlapping libraries, and add dependencies only when needed and approved.
+
+- Full-stack & routing: [Next.js App Router](https://nextjs.org/docs/app); no extra router.
+- UI: [shadcn/ui](https://ui.shadcn.com/create), Nova style; own and customize the component source.
+- Custom styling: [Tailwind CSS](https://tailwindcss.com/docs).
+- Fonts: [Google Fonts](https://fonts.google.com/), loaded via `next/font/google`.
+- Icons: [Lucide React](https://lucide.dev/guide/packages/lucide-react).
+- Animation: [Motion for React](https://motion.dev/docs/react).
+- Resizable layouts: [react-resizable-panels](https://github.com/bvaughn/react-resizable-panels).
+- Drag & drop: [dnd-kit](https://dndkit.com/), React integration.
+- Client state: [Zustand](https://zustand.docs.pmnd.rs/).
+- 3D/WebGPU: [Three.js](https://threejs.org/), `WebGPURenderer`; optional React integration: [React Three Fiber](https://r3f.docs.pmnd.rs/).

package/prompts/orchestrator-mode.md

@@ -0,0 +1,7 @@
+---
+name: Orchestrator mode
+description: Pure high-level orchestrator session
+placement: prepend
+order: 30
+---
+This is a pure high-level orchestrator session. Outsource mechanical work — file exploration, code reading, implementation — to subagents. Keep your own context window lean so your reasoning stays sharp; do not bloat it by reading code yourself.

package/prompts/session-kickoff.md

@@ -0,0 +1,7 @@
+---
+name: Session kickoff
+description: Get oriented, report back before starting work
+placement: prepend
+order: 10
+---
+Familiarize yourself with this project before we start. Once you have a clear picture, report back. Do not begin any work until we have aligned on what's next.

package/prompts/verify-not-assume.md

@@ -0,0 +1,7 @@
+---
+name: Verify, don't assume
+description: Do not assume — verify
+placement: append
+order: 20
+---
+Do not assume — verify. Verify critical facts rather than guessing. And ask me, if you cannot verify something. Only begin once you are 100% sure of what to do. If you catch yourself being even slightly unsure, that's a sign to check first.

package/renderers.ts

@@ -0,0 +1,87 @@
+import type { ExtensionContext, Theme } from "@earendil-works/pi-coding-agent";
+import { truncateToWidth, visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
+import type { PromptCardData, Snippet } from "./types.ts";
+
+const WIDGET_ID = "prompt-snipaste";
+
+export function buildPromptCardComponent(
+	snippets: PromptCardData["snippets"],
+	theme: Theme,
+) {
+	const borderCol = (s: string) => theme.fg("borderAccent", s);
+	const dim = (s: string) => theme.fg("dim", s);
+	const bold = (s: string) => theme.bold(s);
+
+	const titleText = ` Prompt Snippets (${snippets.length}) `;
+
+	return {
+		render(width: number): string[] {
+			const effectiveWidth = Math.max(20, Math.min(width, 100));
+			const innerW = effectiveWidth - 4;
+
+			const titleVisW = visibleWidth(titleText);
+			const topDashLen = Math.max(1, innerW - titleVisW);
+			const topLine = borderCol("╭─") + bold(titleText) + borderCol("─".repeat(topDashLen) + "╮");
+			const botLine = borderCol("╰" + "─".repeat(innerW + 2) + "╯");
+
+			const lines: string[] = [];
+			lines.push(topLine);
+
+			snippets.forEach((item, idx) => {
+				if (idx > 0) {
+					lines.push(borderCol("├" + "─".repeat(innerW + 2) + "┤"));
+				}
+				const header = `● ${item.name}`;
+				const headerVisW = visibleWidth(header);
+				const headerPad = Math.max(0, innerW - headerVisW);
+				lines.push(borderCol("│ ") + bold(header) + " ".repeat(headerPad) + borderCol(" │"));
+
+				const bodyLines = item.body.split(/\r?\n/);
+				for (const line of bodyLines) {
+					if (!line.trim()) continue;
+					for (const wrapped of wrapTextWithAnsi(line, innerW)) {
+						const pad = Math.max(0, innerW - visibleWidth(wrapped));
+						lines.push(borderCol("│ ") + dim(wrapped) + " ".repeat(pad) + borderCol(" │"));
+					}
+				}
+			});
+
+			lines.push(botLine);
+			return lines.map((l) => truncateToWidth(l, width));
+		},
+		invalidate() {},
+	};
+}
+
+export function updateSnippetWidget(
+	ctx: ExtensionContext,
+	getSelection: () => { snippets: Snippet[]; enabled: Set<string> },
+) {
+	if (getSelection().enabled.size === 0) {
+		ctx.ui.setWidget(WIDGET_ID, undefined);
+		return;
+	}
+
+	ctx.ui.setWidget(WIDGET_ID, (_tui, theme) => ({
+		render(width: number): string[] {
+			const { snippets, enabled } = getSelection();
+			const active = snippets.filter((s) => enabled.has(s.id));
+			if (active.length === 0) return [];
+
+			const prepends = active.filter((s) => s.placement === "prepend");
+			const appends = active.filter((s) => s.placement === "append");
+
+			const parts: string[] = [];
+			if (prepends.length > 0) {
+				parts.push(theme.fg("accent", `↑ ${prepends.map((s) => s.name).join(", ")}`));
+			}
+			if (appends.length > 0) {
+				parts.push(theme.fg("warning", `↓ ${appends.map((s) => s.name).join(", ")}`));
+			}
+
+			const text = `[Prompts: ${parts.join(" · ")}]`;
+			return [truncateToWidth(text, width)];
+		},
+		invalidate() {},
+	}));
+}

package/snippets.ts

@@ -0,0 +1,206 @@
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, dirname, isAbsolute, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const BUNDLED_PROMPTS_DIR = join(dirname(fileURLToPath(import.meta.url)), "prompts");
+import { CONFIG_DIR_NAME, getAgentDir, type ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { Snippet } from "./types.ts";
+
+export function parseSnippet(filename: string, raw: string): Snippet | null {
+	const cleanRaw = raw.replace(/^\uFEFF/, "");
+	const match = cleanRaw.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+
+	let name = filename.replace(/\.md$/, "");
+	let description = "";
+	let placement: "prepend" | "append" = "append";
+	let order = 100;
+	let body = "";
+
+	if (match) {
+		const meta: Record<string, string> = {};
+		for (const line of match[1].split(/\r?\n/)) {
+			const kv = line.match(/^([A-Za-z][\w-]*)\s*:\s*(.*)$/);
+			if (kv) meta[kv[1].toLowerCase()] = kv[2].trim().replace(/^["']|["']$/g, "");
+		}
+		if (meta.name) name = meta.name;
+		if (meta.description) description = meta.description;
+		if (meta.placement === "prepend") placement = "prepend";
+		const parsedOrder = Number.parseInt(meta.order ?? "100", 10);
+		if (!Number.isNaN(parsedOrder)) order = parsedOrder;
+		body = match[2].trim();
+	} else {
+		body = cleanRaw.trim();
+		if (!body) return null;
+		const firstLine = body.split(/\r?\n/).find((l) => l.trim().length > 0) ?? "";
+		description = firstLine.replace(/^#+\s*/, "").slice(0, 80);
+	}
+
+	if (!body) return null;
+
+	return {
+		id: filename,
+		name,
+		description,
+		placement,
+		order,
+		body,
+	};
+}
+
+function resolveSnippetPath(rawPath: string, cwd: string): string {
+	const trimmed = rawPath.trim();
+	if (trimmed === "~" || trimmed.startsWith("~/") || (process.platform === "win32" && trimmed.startsWith("~\\"))) {
+		return resolve(homedir(), trimmed.replace(/^~[/\\]?/, ""));
+	}
+	if (isAbsolute(trimmed)) {
+		return resolve(trimmed);
+	}
+	const fromCwd = resolve(cwd, trimmed);
+	if (existsSync(fromCwd)) return fromCwd;
+	const fromAgent = resolve(getAgentDir(), trimmed);
+	if (existsSync(fromAgent)) return fromAgent;
+	return fromCwd;
+}
+
+function getSettingsPrompts(cwd: string, pi?: ExtensionAPI): string[] {
+	const results: string[] = [];
+
+	if (pi) {
+		try {
+			const settings = pi.getSettings();
+			if (Array.isArray(settings?.prompts)) {
+				results.push(...settings.prompts);
+				return results;
+			}
+		} catch {
+			// pi.getSettings() may throw before runner binds
+		}
+	}
+
+	const settingsFiles = [
+		join(getAgentDir(), "settings.json"),
+		join(cwd, CONFIG_DIR_NAME, "settings.json"),
+	];
+
+	for (const sf of settingsFiles) {
+		if (!existsSync(sf)) continue;
+		try {
+			const content = readFileSync(sf, "utf-8");
+			const parsed = JSON.parse(content.replace(/^\uFEFF/, ""));
+			if (Array.isArray(parsed?.prompts)) {
+				for (const p of parsed.prompts) {
+					if (typeof p === "string" && !results.includes(p)) {
+						results.push(p);
+					}
+				}
+			}
+		} catch {
+			// ignore JSON parse errors
+		}
+	}
+
+	return results;
+}
+
+export function loadSnippets(cwd: string, pi?: ExtensionAPI): Snippet[] {
+	const seen = new Map<string, Snippet>();
+	const excludedNames = new Set<string>();
+
+	const loadedPromptPaths = pi?.getCommands()
+		.filter((command) => command.source === "prompt")
+		.map((command) => command.sourceInfo.path);
+	const defaultDirs = loadedPromptPaths ? [] : [
+		BUNDLED_PROMPTS_DIR,
+		join(getAgentDir(), "prompts"),
+		join(cwd, CONFIG_DIR_NAME, "prompts"),
+	];
+	const settingsPrompts = loadedPromptPaths ?? getSettingsPrompts(cwd, pi);
+
+	const processDirectory = (dir: string) => {
+		if (!existsSync(dir)) return;
+		let files: string[];
+		try {
+			files = readdirSync(dir);
+		} catch (error) {
+			if (!(error instanceof Error) || !("code" in error)) throw error;
+			console.error(`Failed to read prompt directory ${dir}: ${error.message}`);
+			return;
+		}
+		for (const file of files) {
+			if (!file.endsWith(".md")) continue;
+			if (excludedNames.has(file)) continue;
+			const fullPath = join(dir, file);
+			try {
+				const snippet = parseSnippet(file, readFileSync(fullPath, "utf-8"));
+				if (snippet) seen.set(file, snippet);
+			} catch (error) {
+				if (!(error instanceof Error) || !("code" in error)) throw error;
+				console.error(`Failed to read prompt ${fullPath}: ${error.message}`);
+			}
+		}
+	};
+
+	const processFile = (filePath: string) => {
+		if (!existsSync(filePath) || !filePath.endsWith(".md")) return;
+		const filename = basename(filePath);
+		if (excludedNames.has(filename)) return;
+		try {
+			const snippet = parseSnippet(filename, readFileSync(filePath, "utf-8"));
+			if (snippet) seen.set(filename, snippet);
+		} catch (error) {
+			if (!(error instanceof Error) || !("code" in error)) throw error;
+			console.error(`Failed to read prompt file ${filePath}: ${error.message}`);
+		}
+	};
+
+	// Collect exclusions first
+	for (const raw of settingsPrompts) {
+		if (typeof raw !== "string") continue;
+		const trimmed = raw.trim();
+		if (trimmed.startsWith("-") || trimmed.startsWith("!")) {
+			const clean = trimmed.slice(1).trim();
+			excludedNames.add(basename(clean));
+		}
+	}
+
+	// 1. Load default prompt directories
+	for (const dir of defaultDirs) {
+		processDirectory(dir);
+	}
+
+	// 2. Load Pi's resolved prompts, or explicit settings paths without a runtime.
+	for (const raw of settingsPrompts) {
+		if (typeof raw !== "string") continue;
+		let trimmed = raw.trim();
+		if (trimmed.startsWith("-") || trimmed.startsWith("!")) continue;
+		if (trimmed.startsWith("+")) trimmed = trimmed.slice(1).trim();
+		if (!trimmed) continue;
+
+		const resolved = resolveSnippetPath(trimmed, cwd);
+		if (!existsSync(resolved)) continue;
+
+		try {
+			const stat = statSync(resolved);
+			if (stat.isDirectory()) {
+				processDirectory(resolved);
+			} else if (stat.isFile() && resolved.endsWith(".md")) {
+				processFile(resolved);
+			}
+		} catch (error) {
+			if (!(error instanceof Error) || !("code" in error)) throw error;
+			console.error(`Failed to inspect prompt path ${resolved}: ${error.message}`);
+		}
+	}
+
+	// Remove any excluded items
+	for (const ex of excludedNames) {
+		seen.delete(ex);
+	}
+
+	return Array.from(seen.values()).sort((a, b) => {
+		if (a.placement !== b.placement) return a.placement === "prepend" ? -1 : 1;
+		if (a.order !== b.order) return a.order - b.order;
+		return a.name.localeCompare(b.name);
+	});
+}

package/types.ts

@@ -0,0 +1,18 @@
+export interface Snippet {
+	id: string;
+	name: string;
+	description: string;
+	placement: "prepend" | "append";
+	order: number;
+	body: string;
+}
+
+export interface PromptCardData {
+	snippets: {
+		id: string;
+		name: string;
+		placement: "prepend" | "append";
+		order: number;
+		body: string;
+	}[];
+}