@hasna/prompts 0.1.0 → 0.2.1

package/dist/index.js

@@ -109,6 +109,10 @@ function runMigrations(db) {
         CREATE INDEX IF NOT EXISTS idx_versions_prompt_id ON prompt_versions(prompt_id);
       `
     },
+    {
+      name: "003_pinned",
+      sql: `ALTER TABLE prompts ADD COLUMN pinned INTEGER NOT NULL DEFAULT 0;`
+    },
     {
       name: "002_fts5",
       sql: `
@@ -162,6 +166,15 @@ function resolvePrompt(db, idOrSlug) {
   const byPrefix = db.query("SELECT id FROM prompts WHERE id LIKE ? LIMIT 2").all(`${idOrSlug}%`);
   if (byPrefix.length === 1 && byPrefix[0])
     return byPrefix[0].id;
+  const bySlugPrefix = db.query("SELECT id FROM prompts WHERE slug LIKE ? LIMIT 2").all(`${idOrSlug}%`);
+  if (bySlugPrefix.length === 1 && bySlugPrefix[0])
+    return bySlugPrefix[0].id;
+  const bySlugSub = db.query("SELECT id FROM prompts WHERE slug LIKE ? LIMIT 2").all(`%${idOrSlug}%`);
+  if (bySlugSub.length === 1 && bySlugSub[0])
+    return bySlugSub[0].id;
+  const byTitle = db.query("SELECT id FROM prompts WHERE lower(title) LIKE ? LIMIT 2").all(`%${idOrSlug.toLowerCase()}%`);
+  if (byTitle.length === 1 && byTitle[0])
+    return byTitle[0].id;
   return null;
 }
 
@@ -179,25 +192,24 @@ function uniqueSlug(baseSlug) {
   }
   return slug;
 }
+var CHARS = "abcdefghijklmnopqrstuvwxyz0123456789";
+function nanoid(len) {
+  let id = "";
+  for (let i = 0;i < len; i++) {
+    id += CHARS[Math.floor(Math.random() * CHARS.length)];
+  }
+  return id;
+}
 function generatePromptId() {
   const db = getDatabase();
-  const row = db.query("SELECT id FROM prompts ORDER BY rowid DESC LIMIT 1").get();
-  let next = 1;
-  if (row) {
-    const match = row.id.match(/PRMT-(\d+)/);
-    if (match && match[1]) {
-      next = parseInt(match[1], 10) + 1;
-    }
-  }
-  return `PRMT-${String(next).padStart(5, "0")}`;
+  let id;
+  do {
+    id = `prmt-${nanoid(8)}`;
+  } while (db.query("SELECT 1 FROM prompts WHERE id = ?").get(id));
+  return id;
 }
 function generateId(prefix) {
-  const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
-  let id = prefix + "-";
-  for (let i = 0;i < 8; i++) {
-    id += chars[Math.floor(Math.random() * chars.length)];
-  }
-  return id;
+  return `${prefix}-${nanoid(8)}`;
 }
 
 // src/db/collections.ts
@@ -255,6 +267,36 @@ function movePrompt(promptIdOrSlug, targetCollection) {
   ]);
 }
 
+// src/lib/duplicates.ts
+function tokenize(text) {
+  return new Set(text.toLowerCase().replace(/[^a-z0-9\s]/g, " ").split(/\s+/).filter((w) => w.length > 2));
+}
+function similarity(a, b) {
+  const ta = tokenize(a);
+  const tb = tokenize(b);
+  if (ta.size === 0 || tb.size === 0)
+    return 0;
+  let shared = 0;
+  for (const word of ta) {
+    if (tb.has(word))
+      shared++;
+  }
+  return shared / Math.max(ta.size, tb.size);
+}
+function findDuplicates(body, threshold = 0.8, excludeSlug) {
+  const all = listPrompts({ limit: 1e4 });
+  const matches = [];
+  for (const p of all) {
+    if (excludeSlug && p.slug === excludeSlug)
+      continue;
+    const score = similarity(body, p.body);
+    if (score >= threshold) {
+      matches.push({ prompt: p, score });
+    }
+  }
+  return matches.sort((a, b) => b.score - a.score);
+}
+
 // src/lib/template.ts
 var VAR_PATTERN = /\{\{\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*(?:\|\s*(.*?)\s*)?\}\}/g;
 function extractVariables(body) {
@@ -348,6 +390,7 @@ function rowToPrompt(row) {
     collection: row["collection"],
     tags: JSON.parse(row["tags"] || "[]"),
     variables: JSON.parse(row["variables"] || "[]"),
+    pinned: Boolean(row["pinned"]),
     is_template: Boolean(row["is_template"]),
     source: row["source"],
     version: row["version"],
@@ -422,7 +465,7 @@ function listPrompts(filter = {}) {
   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 use_count DESC, updated_at DESC LIMIT ? OFFSET ?`).all(...params, limit, offset);
+  const rows = db.query(`SELECT * FROM prompts ${where} ORDER BY pinned DESC, use_count DESC, updated_at DESC LIMIT ? OFFSET ?`).all(...params, limit, offset);
   return rows.map(rowToPrompt);
 }
 function updatePrompt(idOrSlug, input) {
@@ -472,7 +515,13 @@ function usePrompt(idOrSlug) {
   db.run("UPDATE prompts SET use_count = use_count + 1, last_used_at = datetime('now') WHERE id = ?", [prompt.id]);
   return requirePrompt(prompt.id);
 }
-function upsertPrompt(input) {
+function pinPrompt(idOrSlug, pinned) {
+  const db = getDatabase();
+  const prompt = requirePrompt(idOrSlug);
+  db.run("UPDATE prompts SET pinned = ?, updated_at = datetime('now') WHERE id = ?", [pinned ? 1 : 0, prompt.id]);
+  return requirePrompt(prompt.id);
+}
+function upsertPrompt(input, force = false) {
   const db = getDatabase();
   const slug = input.slug || generateSlug(input.title);
   const existing = db.query("SELECT id FROM prompts WHERE slug = ?").get(slug);
@@ -487,8 +536,16 @@ function upsertPrompt(input) {
     });
     return { prompt: prompt2, created: false };
   }
+  let duplicate_warning;
+  if (!force && input.body) {
+    const dupes = findDuplicates(input.body, 0.8, slug);
+    if (dupes.length > 0) {
+      const top = dupes[0];
+      duplicate_warning = `Similar prompt already exists: "${top.prompt.slug}" (${Math.round(top.score * 100)}% match). Use --force to save anyway.`;
+    }
+  }
   const prompt = createPrompt({ ...input, slug });
-  return { prompt, created: true };
+  return { prompt, created: true, duplicate_warning };
 }
 function getPromptStats() {
   const db = getDatabase();
@@ -581,6 +638,7 @@ function rowToSearchResult(row, snippet) {
       collection: row["collection"],
       tags: JSON.parse(row["tags"] || "[]"),
       variables: JSON.parse(row["variables"] || "[]"),
+      pinned: Boolean(row["pinned"]),
       is_template: Boolean(row["is_template"]),
       source: row["source"],
       version: row["version"],
@@ -709,6 +767,7 @@ export {
   requirePrompt,
   renderTemplate,
   registerAgent,
+  pinPrompt,
   movePrompt,
   listVersions,
   listPrompts,
@@ -724,6 +783,7 @@ export {
   generateSlug,
   generatePromptId,
   findSimilar,
+  findDuplicates,
   extractVariables,
   extractVariableInfo,
   exportToJson,

package/dist/lib/duplicates.d.ts

@@ -0,0 +1,7 @@
+import type { Prompt } from "../types/index.js";
+export interface DuplicateMatch {
+    prompt: Prompt;
+    score: number;
+}
+export declare function findDuplicates(body: string, threshold?: number, excludeSlug?: string): DuplicateMatch[];
+//# sourceMappingURL=duplicates.d.ts.map

package/dist/lib/duplicates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicates.d.ts","sourceRoot":"","sources":["../../src/lib/duplicates.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAuB/C,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACd;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE,CAapG"}

package/dist/lib/ids.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/lib/ids.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQlD;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CASnD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAezC;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOjD"}
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/lib/ids.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQlD;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CASnD;AAYD,wBAAgB,gBAAgB,IAAI,MAAM,CAOzC;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/lib/lint.d.ts

@@ -0,0 +1,16 @@
+import type { Prompt } from "../types/index.js";
+export type LintSeverity = "error" | "warn" | "info";
+export interface LintIssue {
+    prompt_id: string;
+    slug: string;
+    severity: LintSeverity;
+    rule: string;
+    message: string;
+}
+export interface LintResult {
+    prompt: Prompt;
+    issues: LintIssue[];
+}
+export declare function lintPrompt(p: Prompt): LintIssue[];
+export declare function lintAll(prompts: Prompt[]): LintResult[];
+//# sourceMappingURL=lint.d.ts.map

package/dist/lib/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/lib/lint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE/C,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAA;AAEpD,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,YAAY,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,SAAS,EAAE,CAAA;CACpB;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CA2CjD;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,UAAU,EAAE,CAIvD"}

package/dist/lib/mementos.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Optional open-mementos integration.
+ * Saves a memory when a prompt is used/rendered, if PROMPTS_SAVE_MEMENTOS=1
+ * and @hasna/mementos is installed. Gracefully no-ops if not available.
+ */
+export interface MementoSaveOptions {
+    slug: string;
+    body: string;
+    rendered?: string;
+    agentId?: string;
+}
+export declare function maybeSaveMemento(opts: MementoSaveOptions): Promise<void>;
+//# sourceMappingURL=mementos.d.ts.map

package/dist/lib/mementos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mementos.d.ts","sourceRoot":"","sources":["../../src/lib/mementos.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2B9E"}

package/dist/lib/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/lib/search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAsCxE,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,IAAI,CAAC,iBAAiB,EAAE,GAAG,CAAM,GACxC,YAAY,EAAE,CAoEhB;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,YAAY,EAAE,CAmCvE"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/lib/search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAuCxE,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,IAAI,CAAC,iBAAiB,EAAE,GAAG,CAAM,GACxC,YAAY,EAAE,CAoEhB;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,YAAY,EAAE,CAmCvE"}

package/dist/mcp/index.js

@@ -10,6 +10,7 @@ var __export = (target, all) => {
       set: (newValue) => all[name] = () => newValue
     });
 };
+var __require = import.meta.require;
 
 // src/mcp/index.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -4098,6 +4099,10 @@ function runMigrations(db) {
         CREATE INDEX IF NOT EXISTS idx_versions_prompt_id ON prompt_versions(prompt_id);
       `
     },
+    {
+      name: "003_pinned",
+      sql: `ALTER TABLE prompts ADD COLUMN pinned INTEGER NOT NULL DEFAULT 0;`
+    },
     {
       name: "002_fts5",
       sql: `
@@ -4151,6 +4156,15 @@ function resolvePrompt(db, idOrSlug) {
   const byPrefix = db.query("SELECT id FROM prompts WHERE id LIKE ? LIMIT 2").all(`${idOrSlug}%`);
   if (byPrefix.length === 1 && byPrefix[0])
     return byPrefix[0].id;
+  const bySlugPrefix = db.query("SELECT id FROM prompts WHERE slug LIKE ? LIMIT 2").all(`${idOrSlug}%`);
+  if (bySlugPrefix.length === 1 && bySlugPrefix[0])
+    return bySlugPrefix[0].id;
+  const bySlugSub = db.query("SELECT id FROM prompts WHERE slug LIKE ? LIMIT 2").all(`%${idOrSlug}%`);
+  if (bySlugSub.length === 1 && bySlugSub[0])
+    return bySlugSub[0].id;
+  const byTitle = db.query("SELECT id FROM prompts WHERE lower(title) LIKE ? LIMIT 2").all(`%${idOrSlug.toLowerCase()}%`);
+  if (byTitle.length === 1 && byTitle[0])
+    return byTitle[0].id;
   return null;
 }
 
@@ -4168,25 +4182,24 @@ function uniqueSlug(baseSlug) {
   }
   return slug;
 }
+var CHARS = "abcdefghijklmnopqrstuvwxyz0123456789";
+function nanoid(len) {
+  let id = "";
+  for (let i = 0;i < len; i++) {
+    id += CHARS[Math.floor(Math.random() * CHARS.length)];
+  }
+  return id;
+}
 function generatePromptId() {
   const db = getDatabase();
-  const row = db.query("SELECT id FROM prompts ORDER BY rowid DESC LIMIT 1").get();
-  let next = 1;
-  if (row) {
-    const match = row.id.match(/PRMT-(\d+)/);
-    if (match && match[1]) {
-      next = parseInt(match[1], 10) + 1;
-    }
-  }
-  return `PRMT-${String(next).padStart(5, "0")}`;
+  let id;
+  do {
+    id = `prmt-${nanoid(8)}`;
+  } while (db.query("SELECT 1 FROM prompts WHERE id = ?").get(id));
+  return id;
 }
 function generateId(prefix) {
-  const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
-  let id = prefix + "-";
-  for (let i = 0;i < 8; i++) {
-    id += chars[Math.floor(Math.random() * chars.length)];
-  }
-  return id;
+  return `${prefix}-${nanoid(8)}`;
 }
 
 // src/db/collections.ts
@@ -4244,6 +4257,36 @@ function movePrompt(promptIdOrSlug, targetCollection) {
   ]);
 }
 
+// src/lib/duplicates.ts
+function tokenize(text) {
+  return new Set(text.toLowerCase().replace(/[^a-z0-9\s]/g, " ").split(/\s+/).filter((w) => w.length > 2));
+}
+function similarity(a, b) {
+  const ta = tokenize(a);
+  const tb = tokenize(b);
+  if (ta.size === 0 || tb.size === 0)
+    return 0;
+  let shared = 0;
+  for (const word of ta) {
+    if (tb.has(word))
+      shared++;
+  }
+  return shared / Math.max(ta.size, tb.size);
+}
+function findDuplicates(body, threshold = 0.8, excludeSlug) {
+  const all = listPrompts({ limit: 1e4 });
+  const matches = [];
+  for (const p of all) {
+    if (excludeSlug && p.slug === excludeSlug)
+      continue;
+    const score = similarity(body, p.body);
+    if (score >= threshold) {
+      matches.push({ prompt: p, score });
+    }
+  }
+  return matches.sort((a, b) => b.score - a.score);
+}
+
 // src/lib/template.ts
 var VAR_PATTERN = /\{\{\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*(?:\|\s*(.*?)\s*)?\}\}/g;
 function extractVariables(body) {
@@ -4330,6 +4373,7 @@ function rowToPrompt(row) {
     collection: row["collection"],
     tags: JSON.parse(row["tags"] || "[]"),
     variables: JSON.parse(row["variables"] || "[]"),
+    pinned: Boolean(row["pinned"]),
     is_template: Boolean(row["is_template"]),
     source: row["source"],
     version: row["version"],
@@ -4404,7 +4448,7 @@ function listPrompts(filter = {}) {
   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 use_count DESC, updated_at DESC LIMIT ? OFFSET ?`).all([...params, limit, offset]);
+  const rows = db.query(`SELECT * FROM prompts ${where} ORDER BY pinned DESC, use_count DESC, updated_at DESC LIMIT ? OFFSET ?`).all(...params, limit, offset);
   return rows.map(rowToPrompt);
 }
 function updatePrompt(idOrSlug, input) {
@@ -4454,7 +4498,13 @@ function usePrompt(idOrSlug) {
   db.run("UPDATE prompts SET use_count = use_count + 1, last_used_at = datetime('now') WHERE id = ?", [prompt.id]);
   return requirePrompt(prompt.id);
 }
-function upsertPrompt(input) {
+function pinPrompt(idOrSlug, pinned) {
+  const db = getDatabase();
+  const prompt = requirePrompt(idOrSlug);
+  db.run("UPDATE prompts SET pinned = ?, updated_at = datetime('now') WHERE id = ?", [pinned ? 1 : 0, prompt.id]);
+  return requirePrompt(prompt.id);
+}
+function upsertPrompt(input, force = false) {
   const db = getDatabase();
   const slug = input.slug || generateSlug(input.title);
   const existing = db.query("SELECT id FROM prompts WHERE slug = ?").get(slug);
@@ -4469,8 +4519,16 @@ function upsertPrompt(input) {
     });
     return { prompt: prompt2, created: false };
   }
+  let duplicate_warning;
+  if (!force && input.body) {
+    const dupes = findDuplicates(input.body, 0.8, slug);
+    if (dupes.length > 0) {
+      const top = dupes[0];
+      duplicate_warning = `Similar prompt already exists: "${top.prompt.slug}" (${Math.round(top.score * 100)}% match). Use --force to save anyway.`;
+    }
+  }
   const prompt = createPrompt({ ...input, slug });
-  return { prompt, created: true };
+  return { prompt, created: true, duplicate_warning };
 }
 function getPromptStats() {
   const db = getDatabase();
@@ -4561,6 +4619,7 @@ function rowToSearchResult(row, snippet) {
       collection: row["collection"],
       tags: JSON.parse(row["tags"] || "[]"),
       variables: JSON.parse(row["variables"] || "[]"),
+      pinned: Boolean(row["pinned"]),
       is_template: Boolean(row["is_template"]),
       source: row["source"],
       version: row["version"],
@@ -4615,7 +4674,7 @@ function searchPrompts(query, filter = {}) {
            WHERE prompts_fts MATCH ?
            ${where}
            ORDER BY bm25(prompts_fts)
-           LIMIT ? OFFSET ?`).all([ftsQuery, ...params, limit, offset]);
+           LIMIT ? OFFSET ?`).all(ftsQuery, ...params, limit, offset);
       return rows2.map((r) => rowToSearchResult(r, r["snippet"]));
     } catch {}
   }
@@ -4623,7 +4682,7 @@ 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 ?? 50, filter.offset ?? 0);
   return rows.map((r) => rowToSearchResult(r));
 }
 function findSimilar(promptId, limit = 5) {
@@ -4634,10 +4693,10 @@ function findSimilar(promptId, limit = 5) {
   const tags = JSON.parse(prompt["tags"] || "[]");
   const collection = prompt["collection"];
   if (tags.length === 0) {
-    const rows = db.query("SELECT *, 1 as score FROM prompts WHERE collection = ? AND id != ? ORDER BY use_count DESC LIMIT ?").all([collection, promptId, limit]);
+    const rows = db.query("SELECT *, 1 as score FROM prompts WHERE collection = ? AND id != ? ORDER BY use_count DESC LIMIT ?").all(collection, promptId, limit);
     return rows.map((r) => rowToSearchResult(r));
   }
-  const allRows = db.query("SELECT * FROM prompts WHERE id != ?").all([promptId]);
+  const allRows = db.query("SELECT * FROM prompts WHERE id != ?").all(promptId);
   const scored = allRows.map((row) => {
     const rowTags = JSON.parse(row["tags"] || "[]");
     const overlap = rowTags.filter((t) => tags.includes(t)).length;
@@ -4680,6 +4739,64 @@ function exportToJson(collection) {
   return { prompts, exported_at: new Date().toISOString(), collection };
 }
 
+// src/lib/mementos.ts
+async function maybeSaveMemento(opts) {
+  if (process.env["PROMPTS_SAVE_MEMENTOS"] !== "1")
+    return;
+  try {
+    const mod = await import("@hasna/mementos").catch(() => null);
+    if (!mod)
+      return;
+    const key = `prompts/used/${opts.slug}`;
+    const value = opts.rendered ?? opts.body;
+    const save = mod["createMemory"] ?? mod["saveMemory"];
+    if (typeof save !== "function")
+      return;
+    await save({
+      key,
+      value,
+      scope: "private",
+      agent_id: opts.agentId,
+      tags: ["prompts", opts.slug],
+      summary: `Used prompt: ${opts.slug}`
+    });
+  } catch {}
+}
+
+// src/lib/lint.ts
+function lintPrompt(p) {
+  const issues = [];
+  const issue = (severity, rule, message) => ({
+    prompt_id: p.id,
+    slug: p.slug,
+    severity,
+    rule,
+    message
+  });
+  if (!p.description) {
+    issues.push(issue("warn", "missing-description", "No description provided"));
+  }
+  if (p.body.trim().length < 10) {
+    issues.push(issue("error", "body-too-short", `Body is only ${p.body.trim().length} characters`));
+  }
+  if (p.tags.length === 0) {
+    issues.push(issue("info", "no-tags", "No tags \u2014 prompt will be harder to discover"));
+  }
+  if (p.is_template) {
+    const undocumented = p.variables.filter((v) => !v.description || v.description.trim() === "");
+    if (undocumented.length > 0) {
+      issues.push(issue("warn", "undocumented-vars", `Template variables without description: ${undocumented.map((v) => v.name).join(", ")}`));
+    }
+  }
+  if (p.collection === "default" && p.use_count === 0) {
+    issues.push(issue("info", "uncollected", "In default collection and never used \u2014 consider organizing"));
+  }
+  return issues;
+}
+function lintAll(prompts) {
+  return prompts.map((p) => ({ prompt: p, issues: lintPrompt(p) })).filter((r) => r.issues.length > 0);
+}
+
 // src/mcp/index.ts
 var server = new McpServer({ name: "open-prompts", version: "0.1.0" });
 function ok(data) {
@@ -4698,12 +4815,14 @@ server.registerTool("prompts_save", {
     collection: exports_external.string().optional().describe("Collection/namespace (default: 'default')"),
     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")
+    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")
   }
 }, async (args) => {
   try {
-    const { prompt, created } = await upsertPrompt(args);
-    return ok({ ...prompt, _created: created });
+    const { force, ...input } = args;
+    const { prompt, created, duplicate_warning } = upsertPrompt(input, force ?? false);
+    return ok({ ...prompt, _created: created, _duplicate_warning: duplicate_warning ?? null });
   } catch (e) {
     return err(e instanceof Error ? e.message : String(e));
   }
@@ -4741,10 +4860,14 @@ server.registerTool("prompts_delete", {
 });
 server.registerTool("prompts_use", {
   description: "Get a prompt's body and increment its use counter. This is the primary way to retrieve a prompt for actual use.",
-  inputSchema: { id: exports_external.string().describe("Prompt ID or slug") }
-}, async ({ id }) => {
+  inputSchema: {
+    id: exports_external.string().describe("Prompt ID or slug"),
+    agent: exports_external.string().optional().describe("Agent ID for mementos integration")
+  }
+}, async ({ id, agent }) => {
   try {
     const prompt = usePrompt(id);
+    await maybeSaveMemento({ slug: prompt.slug, body: prompt.body, agentId: agent });
     return ok({ body: prompt.body, prompt });
   } catch (e) {
     return err(e instanceof Error ? e.message : String(e));
@@ -4754,12 +4877,14 @@ server.registerTool("prompts_render", {
   description: "Render a template prompt by filling in {{variables}}. Returns rendered body plus info on missing/defaulted vars.",
   inputSchema: {
     id: exports_external.string().describe("Prompt ID or slug"),
-    vars: exports_external.record(exports_external.string()).describe("Variable values as key-value pairs")
+    vars: exports_external.record(exports_external.string()).describe("Variable values as key-value pairs"),
+    agent: exports_external.string().optional().describe("Agent ID for mementos integration")
   }
-}, async ({ id, vars }) => {
+}, async ({ id, vars, agent }) => {
   try {
     const prompt = usePrompt(id);
     const result = renderTemplate(prompt.body, vars);
+    await maybeSaveMemento({ slug: prompt.slug, body: prompt.body, rendered: result.rendered, agentId: agent });
     return ok(result);
   } catch (e) {
     return err(e instanceof Error ? e.message : String(e));
@@ -4922,6 +5047,86 @@ server.registerTool("prompts_ensure_collection", {
     description: exports_external.string().optional()
   }
 }, async ({ name, description }) => ok(ensureCollection(name, description)));
+server.registerTool("prompts_save_from_session", {
+  description: "Minimal frictionless save for AI agents mid-conversation. The agent is expected to derive title, slug, and tags from the body before calling this. Automatically sets source=ai-session. Perfect for 'save this as a reusable prompt' moments.",
+  inputSchema: {
+    title: exports_external.string().describe("A short descriptive title for this prompt"),
+    body: exports_external.string().describe("The prompt content to save"),
+    slug: exports_external.string().optional().describe("URL-friendly identifier (auto-generated from title if omitted)"),
+    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")
+  }
+}, async ({ title, body, slug, tags, collection, description, agent }) => {
+  try {
+    const { prompt, created } = upsertPrompt({
+      title,
+      body,
+      slug,
+      tags,
+      collection: collection ?? "sessions",
+      description,
+      source: "ai-session",
+      changed_by: agent
+    });
+    return ok({ ...prompt, _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_pin", {
+  description: "Pin a prompt so it always appears first in lists.",
+  inputSchema: { id: exports_external.string() }
+}, async ({ id }) => {
+  try {
+    return ok(pinPrompt(id, true));
+  } catch (e) {
+    return err(e instanceof Error ? e.message : String(e));
+  }
+});
+server.registerTool("prompts_unpin", {
+  description: "Unpin a previously pinned prompt.",
+  inputSchema: { id: exports_external.string() }
+}, async ({ id }) => {
+  try {
+    return ok(pinPrompt(id, false));
+  } catch (e) {
+    return err(e instanceof Error ? e.message : String(e));
+  }
+});
+server.registerTool("prompts_recent", {
+  description: "Get recently used prompts, ordered by last_used_at descending.",
+  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);
+  return ok(prompts);
+});
+server.registerTool("prompts_lint", {
+  description: "Check prompt quality: missing descriptions, undocumented template vars, short bodies, no tags.",
+  inputSchema: { collection: exports_external.string().optional() }
+}, async ({ collection }) => {
+  const prompts = listPrompts({ collection, limit: 1e4 });
+  const results = lintAll(prompts);
+  const summary = {
+    total_checked: prompts.length,
+    prompts_with_issues: results.length,
+    errors: results.flatMap((r) => r.issues).filter((i) => i.severity === "error").length,
+    warnings: results.flatMap((r) => r.issues).filter((i) => i.severity === "warn").length,
+    info: results.flatMap((r) => r.issues).filter((i) => i.severity === "info").length,
+    results
+  };
+  return ok(summary);
+});
+server.registerTool("prompts_stale", {
+  description: "List prompts not used in N days. Useful for library hygiene.",
+  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 ?? ""));
+  return ok({ stale, count: stale.length, threshold_days: days });
+});
 server.registerTool("prompts_stats", {
   description: "Get usage statistics: most used prompts, recently used, counts by collection and source.",
   inputSchema: {}