@hasna/prompts 0.2.1 → 0.3.0

package/dist/mcp/index.js

@@ -4103,6 +4103,41 @@ function runMigrations(db) {
       name: "003_pinned",
       sql: `ALTER TABLE prompts ADD COLUMN pinned INTEGER NOT NULL DEFAULT 0;`
     },
+    {
+      name: "004_projects",
+      sql: `
+        CREATE TABLE IF NOT EXISTS projects (
+          id TEXT PRIMARY KEY,
+          name TEXT NOT NULL UNIQUE,
+          slug TEXT NOT NULL UNIQUE,
+          description TEXT,
+          path TEXT,
+          created_at TEXT NOT NULL DEFAULT (datetime('now'))
+        );
+        ALTER TABLE prompts ADD COLUMN project_id TEXT REFERENCES projects(id) ON DELETE SET NULL;
+        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: `
@@ -4143,6 +4178,24 @@ function runMigrations(db) {
     db.run("INSERT INTO _migrations (name) VALUES (?)", [migration.name]);
   }
 }
+function resolveProject(db, idOrSlug) {
+  const byId = db.query("SELECT id FROM projects WHERE id = ?").get(idOrSlug);
+  if (byId)
+    return byId.id;
+  const bySlug = db.query("SELECT id FROM projects WHERE slug = ?").get(idOrSlug);
+  if (bySlug)
+    return bySlug.id;
+  const byName = db.query("SELECT id FROM projects WHERE lower(name) = ?").get(idOrSlug.toLowerCase());
+  if (byName)
+    return byName.id;
+  const byPrefix = db.query("SELECT id FROM projects WHERE id LIKE ? LIMIT 2").all(`${idOrSlug}%`);
+  if (byPrefix.length === 1 && byPrefix[0])
+    return byPrefix[0].id;
+  const bySlugPrefix = db.query("SELECT id FROM projects WHERE slug LIKE ? LIMIT 2").all(`${idOrSlug}%`);
+  if (bySlugPrefix.length === 1 && bySlugPrefix[0])
+    return bySlugPrefix[0].id;
+  return null;
+}
 function hasFts(db) {
   return db.query("SELECT 1 FROM sqlite_master WHERE type='table' AND name='prompts_fts'").get() !== null;
 }
@@ -4360,6 +4413,12 @@ class DuplicateSlugError extends Error {
     this.name = "DuplicateSlugError";
   }
 }
+class ProjectNotFoundError extends Error {
+  constructor(id) {
+    super(`Project not found: ${id}`);
+    this.name = "ProjectNotFoundError";
+  }
+}
 
 // src/db/prompts.ts
 function rowToPrompt(row) {
@@ -4374,6 +4433,9 @@ 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"],
     version: row["version"],
@@ -4397,11 +4459,12 @@ function createPrompt(input) {
   ensureCollection(collection);
   const tags = JSON.stringify(input.tags || []);
   const source = input.source || "manual";
+  const project_id = input.project_id ?? null;
   const vars = extractVariables(input.body);
   const variables = JSON.stringify(vars.map((v) => ({ name: v, required: true })));
   const is_template = vars.length > 0 ? 1 : 0;
-  db.run(`INSERT INTO prompts (id, name, slug, title, body, description, collection, tags, variables, is_template, source)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [id, name, slug, input.title, input.body, input.description ?? null, collection, tags, variables, is_template, source]);
+  db.run(`INSERT INTO prompts (id, name, slug, title, body, description, collection, tags, variables, is_template, source, project_id)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [id, name, slug, input.title, input.body, input.description ?? null, collection, tags, variables, is_template, source, project_id]);
   db.run(`INSERT INTO prompt_versions (id, prompt_id, body, version, changed_by)
      VALUES (?, ?, ?, 1, ?)`, [generateId("VER"), id, input.body, input.changed_by ?? null]);
   return getPrompt(id);
@@ -4445,10 +4508,16 @@ function listPrompts(filter = {}) {
       params.push(`%"${tag}"%`);
     }
   }
+  let orderBy = "pinned DESC, use_count DESC, updated_at DESC";
+  if (filter.project_id !== undefined && filter.project_id !== null) {
+    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 ?? 100;
   const offset = filter.offset ?? 0;
-  const rows = db.query(`SELECT * FROM prompts ${where} ORDER BY pinned DESC, use_count DESC, updated_at DESC LIMIT ? OFFSET ?`).all(...params, limit, offset);
+  const rows = db.query(`SELECT * FROM prompts ${where} ORDER BY ${orderBy} LIMIT ? OFFSET ?`).all(...params, limit, offset);
   return rows.map(rowToPrompt);
 }
 function updatePrompt(idOrSlug, input) {
@@ -4464,6 +4533,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,
@@ -4474,6 +4544,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,
@@ -4496,6 +4568,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) {
@@ -4606,6 +4702,52 @@ function registerAgent(name, description) {
   return rowToAgent(db.query("SELECT * FROM agents WHERE id = ?").get(id));
 }
 
+// src/db/projects.ts
+function rowToProject(row, promptCount) {
+  return {
+    id: row["id"],
+    name: row["name"],
+    slug: row["slug"],
+    description: row["description"] ?? null,
+    path: row["path"] ?? null,
+    prompt_count: promptCount,
+    created_at: row["created_at"]
+  };
+}
+function createProject(input) {
+  const db = getDatabase();
+  const id = generateId("proj");
+  const slug = generateSlug(input.name);
+  db.run(`INSERT INTO projects (id, name, slug, description, path) VALUES (?, ?, ?, ?, ?)`, [id, input.name, slug, input.description ?? null, input.path ?? null]);
+  return getProject(id);
+}
+function getProject(idOrSlug) {
+  const db = getDatabase();
+  const id = resolveProject(db, idOrSlug);
+  if (!id)
+    return null;
+  const row = db.query("SELECT * FROM projects WHERE id = ?").get(id);
+  if (!row)
+    return null;
+  const countRow = db.query("SELECT COUNT(*) as n FROM prompts WHERE project_id = ?").get(id);
+  return rowToProject(row, countRow.n);
+}
+function listProjects() {
+  const db = getDatabase();
+  const rows = db.query("SELECT * FROM projects ORDER BY name ASC").all();
+  return rows.map((row) => {
+    const countRow = db.query("SELECT COUNT(*) as n FROM prompts WHERE project_id = ?").get(row["id"]);
+    return rowToProject(row, countRow.n);
+  });
+}
+function deleteProject(idOrSlug) {
+  const db = getDatabase();
+  const id = resolveProject(db, idOrSlug);
+  if (!id)
+    throw new ProjectNotFoundError(idOrSlug);
+  db.run("DELETE FROM projects WHERE id = ?", [id]);
+}
+
 // src/lib/search.ts
 function rowToSearchResult(row, snippet) {
   return {
@@ -4620,6 +4762,9 @@ 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"],
       version: row["version"],
@@ -4663,6 +4808,10 @@ function searchPrompts(query, filter = {}) {
       for (const tag of filter.tags)
         params.push(`%"${tag}"%`);
     }
+    if (filter.project_id !== undefined && filter.project_id !== null) {
+      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 ?? 50;
     const offset = filter.offset ?? 0;
@@ -4738,6 +4887,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) {
@@ -4763,6 +4983,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 = [];
@@ -4797,6 +5059,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) {
@@ -4816,11 +5155,19 @@ server.registerTool("prompts_save", {
     tags: exports_external.array(exports_external.string()).optional().describe("Tags for filtering and search"),
     source: exports_external.enum(["manual", "ai-session", "imported"]).optional().describe("Where this prompt came from"),
     changed_by: exports_external.string().optional().describe("Agent name making this change"),
-    force: exports_external.boolean().optional().describe("Save even if a similar prompt already exists")
+    force: exports_external.boolean().optional().describe("Save even if a similar prompt already exists"),
+    project: exports_external.string().optional().describe("Project name, slug, or ID to scope this prompt to")
   }
 }, async (args) => {
   try {
-    const { force, ...input } = args;
+    const { force, project, ...input } = args;
+    if (project) {
+      const db = getDatabase();
+      const pid = resolveProject(db, project);
+      if (!pid)
+        return err(`Project not found: ${project}`);
+      input.project_id = pid;
+    }
     const { prompt, created, duplicate_warning } = upsertPrompt(input, force ?? false);
     return ok({ ...prompt, _created: created, _duplicate_warning: duplicate_warning ?? null });
   } catch (e) {
@@ -4844,9 +5191,19 @@ server.registerTool("prompts_list", {
     is_template: exports_external.boolean().optional(),
     source: exports_external.enum(["manual", "ai-session", "imported"]).optional(),
     limit: exports_external.number().optional().default(50),
-    offset: exports_external.number().optional().default(0)
-  }
-}, async (args) => ok(listPrompts(args)));
+    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")
+  }
+}, async ({ project, ...args }) => {
+  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 }));
+  }
+  return ok(listPrompts(args));
+});
 server.registerTool("prompts_delete", {
   description: "Delete a prompt by ID or slug.",
   inputSchema: { id: exports_external.string() }
@@ -4916,9 +5273,19 @@ server.registerTool("prompts_search", {
     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)
-  }
-}, async ({ q, ...filter }) => ok(searchPrompts(q, filter)));
+    limit: exports_external.number().optional().default(20),
+    project: exports_external.string().optional().describe("Project name, slug, or ID to scope search")
+  }
+}, async ({ q, project, ...filter }) => {
+  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 }));
+  }
+  return ok(searchPrompts(q, filter));
+});
 server.registerTool("prompts_similar", {
   description: "Find prompts similar to a given prompt (by tag overlap and collection).",
   inputSchema: {
@@ -5002,6 +5369,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: {
@@ -5056,10 +5434,20 @@ server.registerTool("prompts_save_from_session", {
     tags: exports_external.array(exports_external.string()).optional().describe("Relevant tags extracted from the prompt context"),
     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")
+    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"),
+    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 }) => {
+}, async ({ title, body, slug, tags, collection, description, agent, project, pin }) => {
   try {
+    let project_id;
+    if (project) {
+      const db = getDatabase();
+      const pid = resolveProject(db, project);
+      if (!pid)
+        return err(`Project not found: ${project}`);
+      project_id = pid;
+    }
     const { prompt, created } = upsertPrompt({
       title,
       body,
@@ -5068,9 +5456,121 @@ server.registerTool("prompts_save_from_session", {
       collection: collection ?? "sessions",
       description,
       source: "ai-session",
-      changed_by: agent
+      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 final = pin ? { ...prompt, pinned: true } : prompt;
+    return ok({ ...final, _created: created, _tip: created ? `Saved as "${prompt.slug}". Use prompts_use("${prompt.slug}") to retrieve it.` : `Updated existing prompt "${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 = listPrompts({ collection, limit: 1e4 });
+  const unused = all.filter((p) => p.use_count === 0).slice(0, limit);
+  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));
   }
@@ -5131,5 +5631,43 @@ server.registerTool("prompts_stats", {
   description: "Get usage statistics: most used prompts, recently used, counts by collection and source.",
   inputSchema: {}
 }, async () => ok(getPromptStats()));
+server.registerTool("prompts_project_create", {
+  description: "Create a new project to scope prompts.",
+  inputSchema: {
+    name: exports_external.string().describe("Project name"),
+    description: exports_external.string().optional().describe("Short description"),
+    path: exports_external.string().optional().describe("Optional filesystem path this project maps to")
+  }
+}, async ({ name, description, path }) => {
+  try {
+    return ok(createProject({ name, description, path }));
+  } catch (e) {
+    return err(e instanceof Error ? e.message : String(e));
+  }
+});
+server.registerTool("prompts_project_list", {
+  description: "List all projects with prompt counts.",
+  inputSchema: {}
+}, async () => ok(listProjects()));
+server.registerTool("prompts_project_get", {
+  description: "Get a project by ID, slug, or name.",
+  inputSchema: { id: exports_external.string().describe("Project ID, slug, or name") }
+}, async ({ id }) => {
+  const project = getProject(id);
+  if (!project)
+    return err(`Project not found: ${id}`);
+  return ok(project);
+});
+server.registerTool("prompts_project_delete", {
+  description: "Delete a project. Prompts in the project become global (project_id set to null).",
+  inputSchema: { id: exports_external.string().describe("Project ID, slug, or name") }
+}, async ({ id }) => {
+  try {
+    deleteProject(id);
+    return ok({ deleted: true, id });
+  } catch (e) {
+    return err(e instanceof Error ? e.message : String(e));
+  }
+});
 var transport = new StdioServerTransport;
 await server.connect(transport);