@hasna/prompts 0.2.2 → 0.3.1

package/dist/mcp/index.js

@@ -4118,6 +4118,26 @@ function runMigrations(db) {
         CREATE INDEX IF NOT EXISTS idx_prompts_project_id ON prompts(project_id);
       `
     },
+    {
+      name: "005_chaining",
+      sql: `ALTER TABLE prompts ADD COLUMN next_prompt TEXT;`
+    },
+    {
+      name: "006_expiry",
+      sql: `ALTER TABLE prompts ADD COLUMN expires_at TEXT;`
+    },
+    {
+      name: "007_usage_log",
+      sql: `
+        CREATE TABLE IF NOT EXISTS usage_log (
+          id TEXT PRIMARY KEY,
+          prompt_id TEXT NOT NULL REFERENCES prompts(id) ON DELETE CASCADE,
+          used_at TEXT NOT NULL DEFAULT (datetime('now'))
+        );
+        CREATE INDEX IF NOT EXISTS idx_usage_log_prompt_id ON usage_log(prompt_id);
+        CREATE INDEX IF NOT EXISTS idx_usage_log_used_at ON usage_log(used_at);
+      `
+    },
     {
       name: "002_fts5",
       sql: `
@@ -4401,6 +4421,40 @@ class ProjectNotFoundError extends Error {
 }
 
 // src/db/prompts.ts
+function rowToSlimPrompt(row) {
+  const variables = JSON.parse(row["variables"] || "[]");
+  return {
+    id: row["id"],
+    slug: row["slug"],
+    title: row["title"],
+    description: row["description"] ?? null,
+    collection: row["collection"],
+    tags: JSON.parse(row["tags"] || "[]"),
+    variable_names: variables.map((v) => v.name),
+    is_template: Boolean(row["is_template"]),
+    source: row["source"],
+    pinned: Boolean(row["pinned"]),
+    next_prompt: row["next_prompt"] ?? null,
+    expires_at: row["expires_at"] ?? null,
+    project_id: row["project_id"] ?? null,
+    use_count: row["use_count"],
+    last_used_at: row["last_used_at"] ?? null,
+    created_at: row["created_at"],
+    updated_at: row["updated_at"]
+  };
+}
+function promptToSaveResult(prompt, created, duplicate_warning) {
+  return {
+    id: prompt.id,
+    slug: prompt.slug,
+    title: prompt.title,
+    collection: prompt.collection,
+    is_template: prompt.is_template,
+    variable_names: prompt.variables.map((v) => v.name),
+    created,
+    duplicate_warning: duplicate_warning ?? null
+  };
+}
 function rowToPrompt(row) {
   return {
     id: row["id"],
@@ -4413,6 +4467,8 @@ function rowToPrompt(row) {
     tags: JSON.parse(row["tags"] || "[]"),
     variables: JSON.parse(row["variables"] || "[]"),
     pinned: Boolean(row["pinned"]),
+    next_prompt: row["next_prompt"] ?? null,
+    expires_at: row["expires_at"] ?? null,
     project_id: row["project_id"] ?? null,
     is_template: Boolean(row["is_template"]),
     source: row["source"],
@@ -4493,11 +4549,45 @@ function listPrompts(filter = {}) {
     orderBy = `(CASE WHEN project_id = '${filter.project_id}' THEN 0 ELSE 1 END), pinned DESC, use_count DESC, updated_at DESC`;
   }
   const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-  const limit = filter.limit ?? 100;
+  const limit = filter.limit ?? 20;
   const offset = filter.offset ?? 0;
   const rows = db.query(`SELECT * FROM prompts ${where} ORDER BY ${orderBy} LIMIT ? OFFSET ?`).all(...params, limit, offset);
   return rows.map(rowToPrompt);
 }
+function listPromptsSlim(filter = {}) {
+  const db = getDatabase();
+  const conditions = [];
+  const params = [];
+  if (filter.collection) {
+    conditions.push("collection = ?");
+    params.push(filter.collection);
+  }
+  if (filter.is_template !== undefined) {
+    conditions.push("is_template = ?");
+    params.push(filter.is_template ? 1 : 0);
+  }
+  if (filter.source) {
+    conditions.push("source = ?");
+    params.push(filter.source);
+  }
+  if (filter.tags && filter.tags.length > 0) {
+    const tagConds = filter.tags.map(() => "tags LIKE ?");
+    conditions.push(`(${tagConds.join(" OR ")})`);
+    for (const tag of filter.tags)
+      params.push(`%"${tag}"%`);
+  }
+  let orderBy = "pinned DESC, use_count DESC, updated_at DESC";
+  if (filter.project_id) {
+    conditions.push("(project_id = ? OR project_id IS NULL)");
+    params.push(filter.project_id);
+    orderBy = `(CASE WHEN project_id = '${filter.project_id}' THEN 0 ELSE 1 END), pinned DESC, use_count DESC, updated_at DESC`;
+  }
+  const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+  const limit = filter.limit ?? 20;
+  const offset = filter.offset ?? 0;
+  const rows = db.query(`SELECT id, slug, name, title, description, collection, tags, variables, is_template, source, pinned, next_prompt, expires_at, project_id, use_count, last_used_at, created_at, updated_at FROM prompts ${where} ORDER BY ${orderBy} LIMIT ? OFFSET ?`).all(...params, limit, offset);
+  return rows.map(rowToSlimPrompt);
+}
 function updatePrompt(idOrSlug, input) {
   const db = getDatabase();
   const prompt = requirePrompt(idOrSlug);
@@ -4511,6 +4601,7 @@ function updatePrompt(idOrSlug, input) {
       description = COALESCE(?, description),
       collection = COALESCE(?, collection),
       tags = COALESCE(?, tags),
+      next_prompt = CASE WHEN ? IS NOT NULL THEN ? ELSE next_prompt END,
       variables = ?,
       is_template = ?,
       version = version + 1,
@@ -4521,6 +4612,8 @@ function updatePrompt(idOrSlug, input) {
     input.description ?? null,
     input.collection ?? null,
     input.tags ? JSON.stringify(input.tags) : null,
+    "next_prompt" in input ? input.next_prompt ?? "" : null,
+    "next_prompt" in input ? input.next_prompt ?? null : null,
     variables,
     is_template,
     prompt.id,
@@ -4543,6 +4636,30 @@ function usePrompt(idOrSlug) {
   const db = getDatabase();
   const prompt = requirePrompt(idOrSlug);
   db.run("UPDATE prompts SET use_count = use_count + 1, last_used_at = datetime('now') WHERE id = ?", [prompt.id]);
+  db.run("INSERT INTO usage_log (id, prompt_id) VALUES (?, ?)", [generateId("UL"), prompt.id]);
+  return requirePrompt(prompt.id);
+}
+function getTrending(days = 7, limit = 10) {
+  const db = getDatabase();
+  const cutoff = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString();
+  return db.query(`SELECT p.id, p.slug, p.title, COUNT(ul.id) as uses
+     FROM usage_log ul
+     JOIN prompts p ON p.id = ul.prompt_id
+     WHERE ul.used_at >= ?
+     GROUP BY p.id
+     ORDER BY uses DESC
+     LIMIT ?`).all(cutoff, limit);
+}
+function setExpiry(idOrSlug, expiresAt) {
+  const db = getDatabase();
+  const prompt = requirePrompt(idOrSlug);
+  db.run("UPDATE prompts SET expires_at = ?, updated_at = datetime('now') WHERE id = ?", [expiresAt, prompt.id]);
+  return requirePrompt(prompt.id);
+}
+function setNextPrompt(idOrSlug, nextSlug) {
+  const db = getDatabase();
+  const prompt = requirePrompt(idOrSlug);
+  db.run("UPDATE prompts SET next_prompt = ?, updated_at = datetime('now') WHERE id = ?", [nextSlug, prompt.id]);
   return requirePrompt(prompt.id);
 }
 function pinPrompt(idOrSlug, pinned) {
@@ -4700,6 +4817,22 @@ function deleteProject(idOrSlug) {
 }
 
 // src/lib/search.ts
+function rowToSlimSearchResult(row, snippet) {
+  const variables = JSON.parse(row["variables"] || "[]");
+  return {
+    id: row["id"],
+    slug: row["slug"],
+    title: row["title"],
+    description: row["description"] ?? null,
+    collection: row["collection"],
+    tags: JSON.parse(row["tags"] || "[]"),
+    variable_names: variables.map((v) => v.name),
+    is_template: Boolean(row["is_template"]),
+    use_count: row["use_count"],
+    score: row["score"] ?? 1,
+    snippet
+  };
+}
 function rowToSearchResult(row, snippet) {
   return {
     prompt: {
@@ -4713,6 +4846,8 @@ function rowToSearchResult(row, snippet) {
       tags: JSON.parse(row["tags"] || "[]"),
       variables: JSON.parse(row["variables"] || "[]"),
       pinned: Boolean(row["pinned"]),
+      next_prompt: row["next_prompt"] ?? null,
+      expires_at: row["expires_at"] ?? null,
       project_id: row["project_id"] ?? null,
       is_template: Boolean(row["is_template"]),
       source: row["source"],
@@ -4780,9 +4915,75 @@ function searchPrompts(query, filter = {}) {
   const rows = db.query(`SELECT *, 1 as score FROM prompts
        WHERE (name LIKE ? OR slug LIKE ? OR title LIKE ? OR body LIKE ? OR description LIKE ? OR tags LIKE ?)
        ORDER BY use_count DESC, updated_at DESC
-       LIMIT ? OFFSET ?`).all(like, like, like, like, like, like, filter.limit ?? 50, filter.offset ?? 0);
+       LIMIT ? OFFSET ?`).all(like, like, like, like, like, like, filter.limit ?? 10, filter.offset ?? 0);
   return rows.map((r) => rowToSearchResult(r));
 }
+function searchPromptsSlim(query, filter = {}) {
+  const db = getDatabase();
+  if (!query.trim()) {
+    return listPromptsSlim(filter).map((p) => ({
+      id: p.id,
+      slug: p.slug,
+      title: p.title,
+      description: p.description,
+      collection: p.collection,
+      tags: p.tags,
+      variable_names: p.variable_names,
+      is_template: p.is_template,
+      use_count: p.use_count,
+      score: 1
+    }));
+  }
+  if (hasFts(db)) {
+    const ftsQuery = escapeFtsQuery(query);
+    const conditions = [];
+    const params = [];
+    if (filter.collection) {
+      conditions.push("p.collection = ?");
+      params.push(filter.collection);
+    }
+    if (filter.is_template !== undefined) {
+      conditions.push("p.is_template = ?");
+      params.push(filter.is_template ? 1 : 0);
+    }
+    if (filter.source) {
+      conditions.push("p.source = ?");
+      params.push(filter.source);
+    }
+    if (filter.tags && filter.tags.length > 0) {
+      const tagConds = filter.tags.map(() => "p.tags LIKE ?");
+      conditions.push(`(${tagConds.join(" OR ")})`);
+      for (const tag of filter.tags)
+        params.push(`%"${tag}"%`);
+    }
+    if (filter.project_id) {
+      conditions.push("(p.project_id = ? OR p.project_id IS NULL)");
+      params.push(filter.project_id);
+    }
+    const where = conditions.length > 0 ? `AND ${conditions.join(" AND ")}` : "";
+    const limit = filter.limit ?? 10;
+    const offset = filter.offset ?? 0;
+    try {
+      const rows2 = db.query(`SELECT p.id, p.slug, p.name, p.title, p.description, p.collection, p.tags, p.variables,
+                p.is_template, p.use_count, bm25(prompts_fts) as score,
+                snippet(prompts_fts, 2, '[', ']', '...', 10) as snippet
+         FROM prompts p
+         INNER JOIN prompts_fts ON prompts_fts.rowid = p.rowid
+         WHERE prompts_fts MATCH ?
+         ${where}
+         ORDER BY bm25(prompts_fts)
+         LIMIT ? OFFSET ?`).all(ftsQuery, ...params, limit, offset);
+      return rows2.map((r) => rowToSlimSearchResult(r, r["snippet"]));
+    } catch {}
+  }
+  const like = `%${query}%`;
+  const rows = db.query(`SELECT id, slug, name, title, description, collection, tags, variables, is_template, use_count, 1 as score
+     FROM prompts
+     WHERE (name LIKE ? OR slug LIKE ? OR title LIKE ? OR body LIKE ? OR description LIKE ? OR tags LIKE ?)
+     ORDER BY use_count DESC, updated_at DESC
+     LIMIT ? OFFSET ?`).all(like, like, like, like, like, like, filter.limit ?? 10, filter.offset ?? 0);
+  return rows.map((r) => rowToSlimSearchResult(r));
+}
 function findSimilar(promptId, limit = 5) {
   const db = getDatabase();
   const prompt = db.query("SELECT * FROM prompts WHERE id = ?").get(promptId);
@@ -4836,6 +5037,77 @@ function exportToJson(collection) {
   const prompts = listPrompts({ collection, limit: 1e4 });
   return { prompts, exported_at: new Date().toISOString(), collection };
 }
+function markdownToImportItem(content, filename) {
+  const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---\n+([\s\S]*)$/);
+  if (!frontmatterMatch) {
+    if (!filename)
+      return null;
+    const title2 = filename.replace(/\.md$/, "").replace(/-/g, " ");
+    return { title: title2, body: content.trim() };
+  }
+  const frontmatter = frontmatterMatch[1] ?? "";
+  const body = (frontmatterMatch[2] ?? "").trim();
+  const get = (key) => {
+    const m = frontmatter.match(new RegExp(`^${key}:\\s*(.+)$`, "m"));
+    return m ? (m[1] ?? "").trim() : null;
+  };
+  const title = get("title") ?? (filename?.replace(/\.md$/, "").replace(/-/g, " ") ?? "Untitled");
+  const slug = get("slug") ?? undefined;
+  const collection = get("collection") ?? undefined;
+  const description = get("description") ?? undefined;
+  const tagsStr = get("tags");
+  let tags;
+  if (tagsStr) {
+    const inner = tagsStr.replace(/^\[/, "").replace(/\]$/, "");
+    tags = inner.split(",").map((t) => t.trim()).filter(Boolean);
+  }
+  return { title, slug, body, collection, tags, description };
+}
+function scanAndImportSlashCommands(rootDir, changedBy) {
+  const { existsSync: existsSync2, readdirSync, readFileSync } = __require("fs");
+  const { join: join2 } = __require("path");
+  const home = process.env["HOME"] ?? "~";
+  const sources = [
+    { dir: join2(rootDir, ".claude", "commands"), collection: "claude-commands", tags: ["claude", "slash-command"] },
+    { dir: join2(home, ".claude", "commands"), collection: "claude-commands", tags: ["claude", "slash-command"] },
+    { dir: join2(rootDir, ".codex", "skills"), collection: "codex-skills", tags: ["codex", "skill"] },
+    { dir: join2(home, ".codex", "skills"), collection: "codex-skills", tags: ["codex", "skill"] },
+    { dir: join2(rootDir, ".gemini", "extensions"), collection: "gemini-extensions", tags: ["gemini", "extension"] },
+    { dir: join2(home, ".gemini", "extensions"), collection: "gemini-extensions", tags: ["gemini", "extension"] }
+  ];
+  const files = [];
+  const scanned = [];
+  for (const { dir, collection, tags } of sources) {
+    if (!existsSync2(dir))
+      continue;
+    let entries;
+    try {
+      entries = readdirSync(dir);
+    } catch {
+      continue;
+    }
+    for (const entry of entries) {
+      if (!entry.endsWith(".md"))
+        continue;
+      const filePath = join2(dir, entry);
+      try {
+        const content = readFileSync(filePath, "utf-8");
+        files.push({ filename: entry, content, collection, tags });
+        scanned.push({ source: dir, file: entry });
+      } catch {}
+    }
+  }
+  const items = files.map((f) => {
+    const base = markdownToImportItem(f.content, f.filename);
+    if (base)
+      return { ...base, collection: base.collection ?? f.collection, tags: base.tags ?? f.tags };
+    const name = f.filename.replace(/\.md$/, "");
+    const title = name.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+    return { title, slug: name, body: f.content.trim(), collection: f.collection, tags: f.tags };
+  });
+  const imported = importFromJson(items, changedBy);
+  return { scanned, imported };
+}
 
 // src/lib/mementos.ts
 async function maybeSaveMemento(opts) {
@@ -4861,6 +5133,48 @@ async function maybeSaveMemento(opts) {
   } catch {}
 }
 
+// src/lib/diff.ts
+function diffTexts(a, b) {
+  const aLines = a.split(`
+`);
+  const bLines = b.split(`
+`);
+  const m = aLines.length;
+  const n = bLines.length;
+  const lcs = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
+  for (let i2 = 1;i2 <= m; i2++) {
+    for (let j2 = 1;j2 <= n; j2++) {
+      lcs[i2][j2] = aLines[i2 - 1] === bLines[j2 - 1] ? (lcs[i2 - 1][j2 - 1] ?? 0) + 1 : Math.max(lcs[i2 - 1][j2] ?? 0, lcs[i2][j2 - 1] ?? 0);
+    }
+  }
+  const trace = [];
+  let i = m, j = n;
+  while (i > 0 || j > 0) {
+    if (i > 0 && j > 0 && aLines[i - 1] === bLines[j - 1]) {
+      trace.unshift({ type: "unchanged", content: aLines[i - 1] ?? "" });
+      i--;
+      j--;
+    } else if (j > 0 && (i === 0 || (lcs[i][j - 1] ?? 0) >= (lcs[i - 1][j] ?? 0))) {
+      trace.unshift({ type: "added", content: bLines[j - 1] ?? "" });
+      j--;
+    } else {
+      trace.unshift({ type: "removed", content: aLines[i - 1] ?? "" });
+      i--;
+    }
+  }
+  return trace;
+}
+function formatDiff(lines) {
+  return lines.map((l) => {
+    if (l.type === "added")
+      return `+ ${l.content}`;
+    if (l.type === "removed")
+      return `- ${l.content}`;
+    return `  ${l.content}`;
+  }).join(`
+`);
+}
+
 // src/lib/lint.ts
 function lintPrompt(p) {
   const issues = [];
@@ -4895,6 +5209,83 @@ function lintAll(prompts) {
   return prompts.map((p) => ({ prompt: p, issues: lintPrompt(p) })).filter((r) => r.issues.length > 0);
 }
 
+// src/lib/audit.ts
+function runAudit() {
+  const db = getDatabase();
+  const issues = [];
+  const orphaned = db.query(`
+    SELECT p.id, p.slug FROM prompts p
+    WHERE p.project_id IS NOT NULL
+    AND NOT EXISTS (SELECT 1 FROM projects pr WHERE pr.id = p.project_id)
+  `).all();
+  for (const p of orphaned) {
+    issues.push({
+      type: "orphaned-project",
+      severity: "error",
+      prompt_id: p.id,
+      slug: p.slug,
+      message: `Prompt "${p.slug}" references a deleted project`
+    });
+  }
+  const emptyCollections = db.query(`
+    SELECT c.name FROM collections c
+    WHERE NOT EXISTS (SELECT 1 FROM prompts p WHERE p.collection = c.name)
+    AND c.name != 'default'
+  `).all();
+  for (const c of emptyCollections) {
+    issues.push({
+      type: "empty-collection",
+      severity: "info",
+      message: `Collection "${c.name}" has no prompts`
+    });
+  }
+  const missingHistory = db.query(`
+    SELECT p.id, p.slug FROM prompts p
+    WHERE NOT EXISTS (SELECT 1 FROM prompt_versions v WHERE v.prompt_id = p.id)
+  `).all();
+  for (const p of missingHistory) {
+    issues.push({
+      type: "missing-version-history",
+      severity: "warn",
+      prompt_id: p.id,
+      slug: p.slug,
+      message: `Prompt "${p.slug}" has no version history entries`
+    });
+  }
+  const slugs = db.query("SELECT id, slug FROM prompts").all();
+  const seen = new Map;
+  for (const { id, slug } of slugs) {
+    const base = slug.replace(/-\d+$/, "");
+    if (seen.has(base) && seen.get(base) !== id) {
+      issues.push({
+        type: "near-duplicate-slug",
+        severity: "info",
+        slug,
+        message: `"${slug}" looks like a duplicate of "${base}" \u2014 consider merging`
+      });
+    } else {
+      seen.set(base, id);
+    }
+  }
+  const now = new Date().toISOString();
+  const expired = db.query(`
+    SELECT id, slug FROM prompts WHERE expires_at IS NOT NULL AND expires_at < ?
+  `).all(now);
+  for (const p of expired) {
+    issues.push({
+      type: "expired",
+      severity: "warn",
+      prompt_id: p.id,
+      slug: p.slug,
+      message: `Prompt "${p.slug}" has expired`
+    });
+  }
+  const errors2 = issues.filter((i) => i.severity === "error").length;
+  const warnings = issues.filter((i) => i.severity === "warn").length;
+  const info = issues.filter((i) => i.severity === "info").length;
+  return { issues, errors: errors2, warnings, info, checked_at: new Date().toISOString() };
+}
+
 // src/mcp/index.ts
 var server = new McpServer({ name: "open-prompts", version: "0.1.0" });
 function ok(data) {
@@ -4928,7 +5319,7 @@ server.registerTool("prompts_save", {
       input.project_id = pid;
     }
     const { prompt, created, duplicate_warning } = upsertPrompt(input, force ?? false);
-    return ok({ ...prompt, _created: created, _duplicate_warning: duplicate_warning ?? null });
+    return ok(promptToSaveResult(prompt, created, duplicate_warning));
   } catch (e) {
     return err(e instanceof Error ? e.message : String(e));
   }
@@ -4943,25 +5334,44 @@ server.registerTool("prompts_get", {
   return ok(prompt);
 });
 server.registerTool("prompts_list", {
-  description: "List prompts with optional filters.",
+  description: "List prompts (slim by default \u2014 no body). Use prompts_use or prompts_body to get the actual body. Pass include_body:true only if you need body text for all results. summary_only:true returns just id+slug+title for maximum token savings.",
   inputSchema: {
     collection: exports_external.string().optional(),
     tags: exports_external.array(exports_external.string()).optional(),
     is_template: exports_external.boolean().optional(),
     source: exports_external.enum(["manual", "ai-session", "imported"]).optional(),
-    limit: exports_external.number().optional().default(50),
+    limit: exports_external.number().optional().default(20),
     offset: exports_external.number().optional().default(0),
-    project: exports_external.string().optional().describe("Project name, slug, or ID \u2014 shows project prompts first, then globals")
+    project: exports_external.string().optional().describe("Project name, slug, or ID"),
+    include_body: exports_external.boolean().optional().describe("Include full body text (expensive \u2014 avoid unless needed)"),
+    summary_only: exports_external.boolean().optional().describe("Return only id+slug+title \u2014 maximum token savings")
   }
-}, async ({ project, ...args }) => {
+}, async ({ project, include_body, summary_only, ...args }) => {
+  let project_id;
   if (project) {
     const db = getDatabase();
     const pid = resolveProject(db, project);
     if (!pid)
       return err(`Project not found: ${project}`);
-    return ok(listPrompts({ ...args, project_id: pid }));
+    project_id = pid;
   }
-  return ok(listPrompts(args));
+  const filter = { ...args, ...project_id ? { project_id } : {} };
+  if (summary_only) {
+    const items = listPromptsSlim(filter);
+    return ok(items.map((p) => ({ id: p.id, slug: p.slug, title: p.title })));
+  }
+  if (include_body)
+    return ok(listPrompts(filter));
+  return ok(listPromptsSlim(filter));
+});
+server.registerTool("prompts_body", {
+  description: "Get just the body text of a prompt without incrementing the use counter. Use prompts_use when you want to actually use a prompt (increments counter). Use this just to read/inspect the body.",
+  inputSchema: { id: exports_external.string().describe("Prompt ID or slug") }
+}, async ({ id }) => {
+  const prompt = getPrompt(id);
+  if (!prompt)
+    return err(`Prompt not found: ${id}`);
+  return ok({ id: prompt.id, slug: prompt.slug, body: prompt.body, is_template: prompt.is_template, variable_names: prompt.variables.map((v) => v.name) });
 });
 server.registerTool("prompts_delete", {
   description: "Delete a prompt by ID or slug.",
@@ -5013,7 +5423,7 @@ server.registerTool("prompts_list_templates", {
     tags: exports_external.array(exports_external.string()).optional(),
     limit: exports_external.number().optional().default(50)
   }
-}, async (args) => ok(listPrompts({ ...args, is_template: true })));
+}, async (args) => ok(listPromptsSlim({ ...args, is_template: true })));
 server.registerTool("prompts_variables", {
   description: "Inspect what variables a template needs, including defaults and required status.",
   inputSchema: { id: exports_external.string() }
@@ -5025,25 +5435,30 @@ server.registerTool("prompts_variables", {
   return ok({ prompt_id: prompt.id, slug: prompt.slug, variables: vars });
 });
 server.registerTool("prompts_search", {
-  description: "Full-text search across prompt name, slug, title, body, description, and tags. Uses FTS5 BM25 ranking.",
+  description: "Search prompts by text (FTS5 BM25). Returns slim results with snippet \u2014 no body. Use prompts_use/prompts_body to get the body of a result.",
   inputSchema: {
     q: exports_external.string().describe("Search query"),
     collection: exports_external.string().optional(),
     tags: exports_external.array(exports_external.string()).optional(),
     is_template: exports_external.boolean().optional(),
     source: exports_external.enum(["manual", "ai-session", "imported"]).optional(),
-    limit: exports_external.number().optional().default(20),
-    project: exports_external.string().optional().describe("Project name, slug, or ID to scope search")
+    limit: exports_external.number().optional().default(10),
+    project: exports_external.string().optional(),
+    include_body: exports_external.boolean().optional().describe("Include full body in results (expensive)")
   }
-}, async ({ q, project, ...filter }) => {
+}, async ({ q, project, include_body, ...filter }) => {
+  let project_id;
   if (project) {
     const db = getDatabase();
     const pid = resolveProject(db, project);
     if (!pid)
       return err(`Project not found: ${project}`);
-    return ok(searchPrompts(q, { ...filter, project_id: pid }));
+    project_id = pid;
   }
-  return ok(searchPrompts(q, filter));
+  const f = { ...filter, ...project_id ? { project_id } : {} };
+  if (include_body)
+    return ok(searchPrompts(q, f));
+  return ok(searchPromptsSlim(q, f));
 });
 server.registerTool("prompts_similar", {
   description: "Find prompts similar to a given prompt (by tag overlap and collection).",
@@ -5128,6 +5543,17 @@ server.registerTool("prompts_import", {
   const results = importFromJson(prompts, changed_by);
   return ok(results);
 });
+server.registerTool("prompts_import_slash_commands", {
+  description: "Auto-scan .claude/commands, .codex/skills, .gemini/extensions (both project and home dir) and import all .md files as prompts.",
+  inputSchema: {
+    dir: exports_external.string().optional().describe("Root directory to scan (default: cwd)"),
+    changed_by: exports_external.string().optional()
+  }
+}, async ({ dir, changed_by }) => {
+  const rootDir = dir ?? process.cwd();
+  const result = scanAndImportSlashCommands(rootDir, changed_by);
+  return ok(result);
+});
 server.registerTool("prompts_update", {
   description: "Update an existing prompt's fields.",
   inputSchema: {
@@ -5142,7 +5568,7 @@ server.registerTool("prompts_update", {
 }, async ({ id, ...updates }) => {
   try {
     const prompt = updatePrompt(id, updates);
-    return ok(prompt);
+    return ok(promptToSaveResult(prompt, false));
   } catch (e) {
     return err(e instanceof Error ? e.message : String(e));
   }
@@ -5183,9 +5609,10 @@ server.registerTool("prompts_save_from_session", {
     collection: exports_external.string().optional().describe("Collection to save into (default: 'sessions')"),
     description: exports_external.string().optional().describe("One-line description of what this prompt does"),
     agent: exports_external.string().optional().describe("Agent name saving this prompt"),
-    project: exports_external.string().optional().describe("Project name, slug, or ID to scope this prompt to")
+    project: exports_external.string().optional().describe("Project name, slug, or ID to scope this prompt to"),
+    pin: exports_external.boolean().optional().describe("Pin the prompt immediately so it surfaces first in all lists")
   }
-}, async ({ title, body, slug, tags, collection, description, agent, project }) => {
+}, async ({ title, body, slug, tags, collection, description, agent, project, pin }) => {
   try {
     let project_id;
     if (project) {
@@ -5206,7 +5633,118 @@ server.registerTool("prompts_save_from_session", {
       changed_by: agent,
       project_id
     });
-    return ok({ ...prompt, _created: created, _tip: created ? `Saved as "${prompt.slug}". Use prompts_use("${prompt.slug}") to retrieve it.` : `Updated existing prompt "${prompt.slug}".` });
+    if (pin)
+      pinPrompt(prompt.id, true);
+    const result = promptToSaveResult(prompt, created);
+    return ok({ ...result, pinned: pin ?? false, _tip: created ? `Saved as "${prompt.slug}". Use prompts_use("${prompt.slug}") to retrieve it.` : `Updated "${prompt.slug}".` });
+  } catch (e) {
+    return err(e instanceof Error ? e.message : String(e));
+  }
+});
+server.registerTool("prompts_audit", {
+  description: "Run a full audit: orphaned project refs, empty collections, missing version history, near-duplicate slugs, expired prompts.",
+  inputSchema: {}
+}, async () => ok(runAudit()));
+server.registerTool("prompts_unused", {
+  description: "List prompts with use_count = 0 \u2014 never used. Good for library cleanup.",
+  inputSchema: { collection: exports_external.string().optional(), limit: exports_external.number().optional().default(50) }
+}, async ({ collection, limit }) => {
+  const all = listPromptsSlim({ collection, limit: 1e4 });
+  const unused = all.filter((p) => p.use_count === 0).slice(0, limit).map((p) => ({ id: p.id, slug: p.slug, title: p.title, collection: p.collection, created_at: p.created_at }));
+  return ok({ unused, count: unused.length });
+});
+server.registerTool("prompts_trending", {
+  description: "Get most-used prompts in the last N days based on per-use log.",
+  inputSchema: {
+    days: exports_external.number().optional().default(7),
+    limit: exports_external.number().optional().default(10)
+  }
+}, async ({ days, limit }) => ok(getTrending(days, limit)));
+server.registerTool("prompts_set_expiry", {
+  description: "Set or clear an expiry date on a prompt. Pass expires_at=null to clear.",
+  inputSchema: {
+    id: exports_external.string(),
+    expires_at: exports_external.string().nullable().describe("ISO date string (e.g. 2026-12-31) or null to clear")
+  }
+}, async ({ id, expires_at }) => {
+  try {
+    return ok(setExpiry(id, expires_at));
+  } catch (e) {
+    return err(e instanceof Error ? e.message : String(e));
+  }
+});
+server.registerTool("prompts_duplicate", {
+  description: "Clone a prompt with a new slug. Copies body, tags, collection, description. Version resets to 1.",
+  inputSchema: {
+    id: exports_external.string(),
+    slug: exports_external.string().optional().describe("New slug (auto-generated if omitted)"),
+    title: exports_external.string().optional().describe("New title (defaults to 'Copy of <original>')")
+  }
+}, async ({ id, slug, title }) => {
+  try {
+    const source = getPrompt(id);
+    if (!source)
+      return err(`Prompt not found: ${id}`);
+    const { prompt } = upsertPrompt({
+      title: title ?? `Copy of ${source.title}`,
+      slug,
+      body: source.body,
+      description: source.description ?? undefined,
+      collection: source.collection,
+      tags: source.tags,
+      source: "manual"
+    });
+    return ok(prompt);
+  } catch (e) {
+    return err(e instanceof Error ? e.message : String(e));
+  }
+});
+server.registerTool("prompts_diff", {
+  description: "Show a line diff between two versions of a prompt body. v2 defaults to current version.",
+  inputSchema: {
+    id: exports_external.string(),
+    v1: exports_external.number().describe("First version number"),
+    v2: exports_external.number().optional().describe("Second version (default: current)")
+  }
+}, async ({ id, v1, v2 }) => {
+  try {
+    const prompt = getPrompt(id);
+    if (!prompt)
+      return err(`Prompt not found: ${id}`);
+    const versions = listVersions(prompt.id);
+    const versionA = versions.find((v) => v.version === v1);
+    if (!versionA)
+      return err(`Version ${v1} not found`);
+    const bodyB = v2 ? versions.find((v) => v.version === v2)?.body ?? null : prompt.body;
+    if (bodyB === null)
+      return err(`Version ${v2} not found`);
+    const lines = diffTexts(versionA.body, bodyB);
+    return ok({ lines, formatted: formatDiff(lines), v1, v2: v2 ?? prompt.version });
+  } catch (e) {
+    return err(e instanceof Error ? e.message : String(e));
+  }
+});
+server.registerTool("prompts_chain", {
+  description: "Set or get the next prompt in a chain. After using prompt A, the agent is suggested prompt B. Pass next_prompt=null to clear.",
+  inputSchema: {
+    id: exports_external.string().describe("Prompt ID or slug"),
+    next_prompt: exports_external.string().nullable().optional().describe("Slug of the next prompt in the chain, or null to clear")
+  }
+}, async ({ id, next_prompt }) => {
+  try {
+    if (next_prompt !== undefined) {
+      const p = setNextPrompt(id, next_prompt ?? null);
+      return ok(p);
+    }
+    const chain = [];
+    let cur = getPrompt(id);
+    const seen = new Set;
+    while (cur && !seen.has(cur.id)) {
+      chain.push({ id: cur.id, slug: cur.slug, title: cur.title });
+      seen.add(cur.id);
+      cur = cur.next_prompt ? getPrompt(cur.next_prompt) : null;
+    }
+    return ok(chain);
   } catch (e) {
     return err(e instanceof Error ? e.message : String(e));
   }
@@ -5232,10 +5770,10 @@ server.registerTool("prompts_unpin", {
   }
 });
 server.registerTool("prompts_recent", {
-  description: "Get recently used prompts, ordered by last_used_at descending.",
+  description: "Get recently used prompts (slim \u2014 no body). Returns id, slug, title, tags, use_count, last_used_at.",
   inputSchema: { limit: exports_external.number().optional().default(10) }
 }, async ({ limit }) => {
-  const prompts = listPrompts({ limit: 500 }).filter((p) => p.last_used_at !== null).sort((a, b) => (b.last_used_at ?? "").localeCompare(a.last_used_at ?? "")).slice(0, limit);
+  const prompts = listPromptsSlim({ limit: 500 }).filter((p) => p.last_used_at !== null).sort((a, b) => (b.last_used_at ?? "").localeCompare(a.last_used_at ?? "")).slice(0, limit);
   return ok(prompts);
 });
 server.registerTool("prompts_lint", {
@@ -5259,8 +5797,8 @@ server.registerTool("prompts_stale", {
   inputSchema: { days: exports_external.number().optional().default(30).describe("Inactivity threshold in days") }
 }, async ({ days }) => {
   const cutoff = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString();
-  const all = listPrompts({ limit: 1e4 });
-  const stale = all.filter((p) => p.last_used_at === null || p.last_used_at < cutoff).sort((a, b) => (a.last_used_at ?? "").localeCompare(b.last_used_at ?? ""));
+  const all = listPromptsSlim({ limit: 1e4 });
+  const stale = all.filter((p) => p.last_used_at === null || p.last_used_at < cutoff).sort((a, b) => (a.last_used_at ?? "").localeCompare(b.last_used_at ?? "")).map((p) => ({ id: p.id, slug: p.slug, title: p.title, last_used_at: p.last_used_at, use_count: p.use_count }));
   return ok({ stale, count: stale.length, threshold_days: days });
 });
 server.registerTool("prompts_stats", {