@hasna/prompts 0.1.0 → 0.2.1

package/README.md

@@ -12,19 +12,19 @@ bun install -g @hasna/prompts
 
 ```bash
 # Save a prompt
-open-prompts save "TypeScript Code Review" \
+prompts save "TypeScript Code Review" \
   --body "Review this TypeScript code for correctness, types, and style:\n\n{{code}}" \
   --tags "code,review,typescript" \
   --collection "code"
 
 # Use it (prints body, increments counter)
-open-prompts use typescript-code-review
+prompts use typescript-code-review
 
 # Render a template
-open-prompts render typescript-code-review --var code="$(cat myfile.ts)"
+prompts render typescript-code-review --var code="$(cat myfile.ts)"
 
 # Search
-open-prompts search "code review"
+prompts search "code review"
 ```
 
 ---
@@ -37,7 +37,7 @@ Add to your Claude/agent config:
 {
   "mcpServers": {
     "prompts": {
-      "command": "open-prompts-mcp"
+      "command": "prompts-mcp"
     }
   }
 }
@@ -86,28 +86,28 @@ Later, in any session:
 ## CLI Reference
 
 ```bash
-open-prompts save <title>        # Save a prompt (--body, --file, or stdin)
-open-prompts use <id|slug>       # Get body, increment counter
-open-prompts get <id|slug>       # Get details without incrementing
-open-prompts list                # List all prompts
-open-prompts search <query>      # Full-text search
-open-prompts render <id> -v k=v  # Render template with variables
-open-prompts templates           # List templates
-open-prompts inspect <id>        # Show template variables
-open-prompts update <id>         # Update fields
-open-prompts delete <id>         # Delete
-open-prompts history <id>        # Version history
-open-prompts restore <id> <v>    # Restore version
-open-prompts collections         # List collections
-open-prompts move <id> <col>     # Move to collection
-open-prompts export              # Export as JSON
-open-prompts import <file>       # Import from JSON
-open-prompts stats               # Usage statistics
+prompts save <title>        # Save a prompt (--body, --file, or stdin)
+prompts use <id|slug>       # Get body, increment counter
+prompts get <id|slug>       # Get details without incrementing
+prompts list                # List all prompts
+prompts search <query>      # Full-text search
+prompts render <id> -v k=v  # Render template with variables
+prompts templates           # List templates
+prompts inspect <id>        # Show template variables
+prompts update <id>         # Update fields
+prompts delete <id>         # Delete
+prompts history <id>        # Version history
+prompts restore <id> <v>    # Restore version
+prompts collections         # List collections
+prompts move <id> <col>     # Move to collection
+prompts export              # Export as JSON
+prompts import <file>       # Import from JSON
+prompts stats               # Usage statistics
 
 # Global flags
-open-prompts list --json         # Machine-readable output
-open-prompts list -c code        # Filter by collection
-open-prompts list -t review,ts   # Filter by tags
+prompts list --json         # Machine-readable output
+prompts list -c code        # Filter by collection
+prompts list -t review,ts   # Filter by tags
 ```
 
 ---
@@ -118,18 +118,18 @@ Prompts with `{{variable}}` syntax are automatically detected as templates.
 
 ```bash
 # Save a template
-open-prompts save "PR Description" \
+prompts save "PR Description" \
   --body "Write a PR description for this {{language|TypeScript}} change:\n\n{{diff}}\n\nFocus on: {{focus|what changed and why}}"
 
 # Inspect variables
-open-prompts inspect pr-description
+prompts inspect pr-description
 # Variables for pr-description:
 #   language  optional  (default: "TypeScript")
 #   diff      required
 #   focus     optional  (default: "what changed and why")
 
 # Render
-open-prompts render pr-description \
+prompts render pr-description \
   --var diff="$(git diff main)" \
   --var language=Go
 ```
@@ -183,7 +183,7 @@ importFromClaudeCommands([
 ## REST API
 
 ```bash
-open-prompts-serve   # starts on port 19430
+prompts-serve   # starts on port 19430
 ```
 
 | Method | Endpoint | Description |
@@ -212,7 +212,7 @@ open-prompts-serve   # starts on port 19430
 ## Web Dashboard
 
 ```bash
-open-prompts-serve   # start API on :19430
+prompts-serve   # start API on :19430
 # open dashboard/dist/index.html or run dashboard dev server
 ```
 
@@ -256,7 +256,7 @@ Priority order:
 # Export existing slash commands as prompts
 for f in .claude/commands/*.md; do
   name=$(basename "$f" .md)
-  open-prompts save "$name" --file "$f" --collection claude-commands --tags "slash-command"
+  prompts save "$name" --file "$f" --collection claude-commands --tags "slash-command"
 done
 ```
 

package/dist/cli/index.js

@@ -2183,6 +2183,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: `
@@ -2236,6 +2240,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;
 }
 
@@ -2253,25 +2266,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
@@ -2329,6 +2341,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) {
@@ -2406,6 +2448,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"],
@@ -2480,7 +2523,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) {
@@ -2530,7 +2573,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);
@@ -2545,8 +2594,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();
@@ -2612,6 +2669,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"],
@@ -2666,7 +2724,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 {}
   }
@@ -2674,7 +2732,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));
 }
 
@@ -2711,10 +2769,44 @@ function exportToJson(collection) {
   return { prompts, exported_at: new Date().toISOString(), collection };
 }
 
+// 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/cli/index.tsx
 var require2 = createRequire(import.meta.url);
 var pkg = require2("../../package.json");
-var program2 = new Command().name("open-prompts").version(pkg.version).description("Reusable prompt library \u2014 save, search, render prompts from any AI session").option("--json", "Output as JSON");
+var program2 = new Command().name("prompts").version(pkg.version).description("Reusable prompt library \u2014 save, search, render prompts from any AI session").option("--json", "Output as JSON");
 function isJson() {
   return Boolean(program2.opts()["json"]);
 }
@@ -2737,9 +2829,10 @@ function handleError(e) {
 function fmtPrompt(p) {
   const tags = p.tags.length > 0 ? chalk.gray(` [${p.tags.join(", ")}]`) : "";
   const template = p.is_template ? chalk.cyan(" \u25C7") : "";
-  return `${chalk.bold(p.id)} ${chalk.green(p.slug)}${template}  ${p.title}${tags}  ${chalk.gray(p.collection)}`;
+  const pin = p.pinned ? chalk.yellow(" \uD83D\uDCCC") : "";
+  return `${chalk.bold(p.id)} ${chalk.green(p.slug)}${template}${pin}  ${p.title}${tags}  ${chalk.gray(p.collection)}`;
 }
-program2.command("save <title>").description("Save a new prompt (or update existing by slug)").option("-b, --body <body>", "Prompt body (use - to read from stdin)").option("-f, --file <path>", "Read body from file").option("-s, --slug <slug>", "Custom slug").option("-d, --description <desc>", "Short description").option("-c, --collection <name>", "Collection", "default").option("-t, --tags <tags>", "Comma-separated tags").option("--source <source>", "Source: manual|ai-session|imported", "manual").option("--agent <name>", "Agent name (for attribution)").action(async (title, opts) => {
+program2.command("save <title>").description("Save a new prompt (or update existing by slug)").option("-b, --body <body>", "Prompt body (use - to read from stdin)").option("-f, --file <path>", "Read body from file").option("-s, --slug <slug>", "Custom slug").option("-d, --description <desc>", "Short description").option("-c, --collection <name>", "Collection", "default").option("-t, --tags <tags>", "Comma-separated tags").option("--source <source>", "Source: manual|ai-session|imported", "manual").option("--agent <name>", "Agent name (for attribution)").option("--force", "Save even if a similar prompt already exists").action(async (title, opts) => {
   try {
     let body = opts["body"] ?? "";
     if (opts["file"]) {
@@ -2753,7 +2846,7 @@ program2.command("save <title>").description("Save a new prompt (or update exist
     }
     if (!body)
       handleError("No body provided. Use --body, --file, or pipe via stdin.");
-    const { prompt, created } = upsertPrompt({
+    const { prompt, created, duplicate_warning } = upsertPrompt({
       title,
       body,
       slug: opts["slug"],
@@ -2762,7 +2855,10 @@ program2.command("save <title>").description("Save a new prompt (or update exist
       tags: opts["tags"] ? opts["tags"].split(",").map((t) => t.trim()) : [],
       source: opts["source"] || "manual",
       changed_by: opts["agent"]
-    });
+    }, Boolean(opts["force"]));
+    if (duplicate_warning && !isJson()) {
+      console.warn(chalk.yellow(`Warning: ${duplicate_warning}`));
+    }
     if (isJson()) {
       output(prompt);
     } else {
@@ -2801,14 +2897,17 @@ program2.command("get <id>").description("Get prompt details without incrementin
     handleError(e);
   }
 });
-program2.command("list").description("List prompts").option("-c, --collection <name>", "Filter by collection").option("-t, --tags <tags>", "Filter by tags (comma-separated)").option("--templates", "Show only templates").option("-n, --limit <n>", "Max results", "50").action((opts) => {
+program2.command("list").description("List prompts").option("-c, --collection <name>", "Filter by collection").option("-t, --tags <tags>", "Filter by tags (comma-separated)").option("--templates", "Show only templates").option("--recent", "Sort by recently used").option("-n, --limit <n>", "Max results", "50").action((opts) => {
   try {
-    const prompts = listPrompts({
+    let prompts = listPrompts({
       collection: opts["collection"],
       tags: opts["tags"] ? opts["tags"].split(",").map((t) => t.trim()) : undefined,
       is_template: opts["templates"] ? true : undefined,
       limit: parseInt(opts["limit"]) || 50
     });
+    if (opts["recent"]) {
+      prompts = prompts.filter((p) => p.last_used_at !== null).sort((a, b) => (b.last_used_at ?? "").localeCompare(a.last_used_at ?? ""));
+    }
     if (isJson()) {
       output(prompts);
     } else if (prompts.length === 0) {
@@ -2828,7 +2927,7 @@ program2.command("search <query>").description("Full-text search across prompts
     const results = searchPrompts(query, {
       collection: opts["collection"],
       tags: opts["tags"] ? opts["tags"].split(",").map((t) => t.trim()) : undefined,
-      limit: parseInt(opts["limit"]) || 20
+      limit: parseInt(opts["limit"] ?? "20") || 20
     });
     if (isJson()) {
       output(results);
@@ -2837,8 +2936,10 @@ program2.command("search <query>").description("Full-text search across prompts
     } else {
       for (const r of results) {
         console.log(fmtPrompt(r.prompt));
-        if (r.snippet)
-          console.log(chalk.gray("  " + r.snippet));
+        if (r.snippet) {
+          const highlighted = r.snippet.replace(/\[([^\]]+)\]/g, (_m, word) => chalk.yellowBright(word));
+          console.log(chalk.gray("  ") + chalk.gray(highlighted));
+        }
       }
       console.log(chalk.gray(`
 ${results.length} result(s)`));
@@ -2915,12 +3016,12 @@ program2.command("inspect <id>").description("Show a prompt's variables (for tem
 program2.command("update <id>").description("Update a prompt's fields").option("--title <title>").option("-b, --body <body>").option("-d, --description <desc>").option("-c, --collection <name>").option("-t, --tags <tags>").option("--agent <name>").action((id, opts) => {
   try {
     const prompt = updatePrompt(id, {
-      title: opts["title"],
-      body: opts["body"],
-      description: opts["description"],
-      collection: opts["collection"],
+      title: opts["title"] ?? undefined,
+      body: opts["body"] ?? undefined,
+      description: opts["description"] ?? undefined,
+      collection: opts["collection"] ?? undefined,
       tags: opts["tags"] ? opts["tags"].split(",").map((t) => t.trim()) : undefined,
-      changed_by: opts["agent"]
+      changed_by: opts["agent"] ?? undefined
     });
     if (isJson())
       output(prompt);
@@ -3079,4 +3180,140 @@ By collection:`));
     handleError(e);
   }
 });
+program2.command("recent [n]").description("Show recently used prompts (default: 10)").action((n) => {
+  try {
+    const limit = parseInt(n ?? "10") || 10;
+    const prompts = listPrompts({ limit }).filter((p) => p.last_used_at !== null).sort((a, b) => (b.last_used_at ?? "").localeCompare(a.last_used_at ?? "")).slice(0, limit);
+    if (isJson()) {
+      output(prompts);
+      return;
+    }
+    if (prompts.length === 0) {
+      console.log(chalk.gray("No recently used prompts."));
+      return;
+    }
+    for (const p of prompts) {
+      const ago = chalk.gray(new Date(p.last_used_at).toLocaleString());
+      console.log(`${chalk.bold(p.id)} ${chalk.green(p.slug)}  ${p.title}  ${ago}`);
+    }
+  } catch (e) {
+    handleError(e);
+  }
+});
+program2.command("lint").description("Check prompt quality: missing descriptions, undocumented vars, short bodies, no tags").option("-c, --collection <name>", "Lint only this collection").action((opts) => {
+  try {
+    const prompts = listPrompts({ collection: opts["collection"], limit: 1e4 });
+    const results = lintAll(prompts);
+    if (isJson()) {
+      output(results);
+      return;
+    }
+    if (results.length === 0) {
+      console.log(chalk.green("\u2713 All prompts pass lint."));
+      return;
+    }
+    let errors = 0, warns = 0, infos = 0;
+    for (const { prompt: p, issues } of results) {
+      console.log(`
+${chalk.bold(p.slug)}  ${chalk.gray(p.id)}`);
+      for (const issue of issues) {
+        if (issue.severity === "error") {
+          console.log(chalk.red(`  \u2717 [${issue.rule}] ${issue.message}`));
+          errors++;
+        } else if (issue.severity === "warn") {
+          console.log(chalk.yellow(`  \u26A0 [${issue.rule}] ${issue.message}`));
+          warns++;
+        } else {
+          console.log(chalk.gray(`  \u2139 [${issue.rule}] ${issue.message}`));
+          infos++;
+        }
+      }
+    }
+    console.log(chalk.bold(`
+${results.length} prompt(s) with issues \u2014 ${errors} errors, ${warns} warnings, ${infos} info`));
+    if (errors > 0)
+      process.exit(1);
+  } catch (e) {
+    handleError(e);
+  }
+});
+program2.command("stale [days]").description("List prompts not used in N days (default: 30)").action((days) => {
+  try {
+    const threshold = parseInt(days ?? "30") || 30;
+    const cutoff = new Date(Date.now() - threshold * 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 ?? ""));
+    if (isJson()) {
+      output(stale);
+      return;
+    }
+    if (stale.length === 0) {
+      console.log(chalk.green(`No stale prompts (threshold: ${threshold} days).`));
+      return;
+    }
+    console.log(chalk.bold(`Stale prompts (not used in ${threshold}+ days):`));
+    for (const p of stale) {
+      const last = p.last_used_at ? chalk.gray(new Date(p.last_used_at).toLocaleDateString()) : chalk.red("never");
+      console.log(`  ${chalk.green(p.slug)}  ${chalk.gray(`${p.use_count}\xD7`)}  last used: ${last}`);
+    }
+    console.log(chalk.gray(`
+${stale.length} stale prompt(s)`));
+  } catch (e) {
+    handleError(e);
+  }
+});
+program2.command("pin <id>").description("Pin a prompt so it always appears first in lists").action((id) => {
+  try {
+    const p = pinPrompt(id, true);
+    if (isJson())
+      output(p);
+    else
+      console.log(chalk.yellow(`\uD83D\uDCCC Pinned ${chalk.bold(p.slug)}`));
+  } catch (e) {
+    handleError(e);
+  }
+});
+program2.command("unpin <id>").description("Unpin a prompt").action((id) => {
+  try {
+    const p = pinPrompt(id, false);
+    if (isJson())
+      output(p);
+    else
+      console.log(chalk.gray(`Unpinned ${chalk.bold(p.slug)}`));
+  } catch (e) {
+    handleError(e);
+  }
+});
+program2.command("copy <id>").description("Copy prompt body to clipboard and increment use counter").action(async (id) => {
+  try {
+    const prompt = usePrompt(id);
+    const { platform } = process;
+    if (platform === "darwin") {
+      const proc = Bun.spawn(["pbcopy"], { stdin: "pipe" });
+      proc.stdin.write(prompt.body);
+      proc.stdin.end();
+      await proc.exited;
+    } else if (platform === "linux") {
+      try {
+        const proc = Bun.spawn(["xclip", "-selection", "clipboard"], { stdin: "pipe" });
+        proc.stdin.write(prompt.body);
+        proc.stdin.end();
+        await proc.exited;
+      } catch {
+        const proc = Bun.spawn(["xsel", "--clipboard", "--input"], { stdin: "pipe" });
+        proc.stdin.write(prompt.body);
+        proc.stdin.end();
+        await proc.exited;
+      }
+    } else {
+      handleError("Clipboard not supported on this platform. Use `prompts use` instead.");
+    }
+    if (isJson())
+      output({ copied: true, id: prompt.id, slug: prompt.slug });
+    else
+      console.log(chalk.green(`Copied ${chalk.bold(prompt.slug)} to clipboard`));
+  } catch (e) {
+    handleError(e);
+  }
+});
 program2.parse();

package/dist/db/database.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/db/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAMrC,wBAAgB,SAAS,IAAI,MAAM,CAsBlC;AAED,wBAAgB,WAAW,IAAI,QAAQ,CAmBtC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAGD,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAkHD,wBAAgB,MAAM,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAM5C;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgB3E"}
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/db/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAMrC,wBAAgB,SAAS,IAAI,MAAM,CAsBlC;AAED,wBAAgB,WAAW,IAAI,QAAQ,CAmBtC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAGD,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAsHD,wBAAgB,MAAM,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAM5C;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkC3E"}

package/dist/db/prompts.d.ts

@@ -6,9 +6,11 @@ export declare function listPrompts(filter?: ListPromptsFilter): Prompt[];
 export declare function updatePrompt(idOrSlug: string, input: UpdatePromptInput): Prompt;
 export declare function deletePrompt(idOrSlug: string): void;
 export declare function usePrompt(idOrSlug: string): Prompt;
-export declare function upsertPrompt(input: CreatePromptInput): {
+export declare function pinPrompt(idOrSlug: string, pinned: boolean): Prompt;
+export declare function upsertPrompt(input: CreatePromptInput, force?: boolean): {
     prompt: Prompt;
     created: boolean;
+    duplicate_warning?: string;
 };
 export declare function getPromptStats(): {
     total_prompts: number;

package/dist/db/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/db/prompts.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,MAAM,EACN,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EAGlB,MAAM,mBAAmB,CAAA;AAyB1B,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAyC7D;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOzD;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAItD;AAED,wBAAgB,WAAW,CAAC,MAAM,GAAE,iBAAsB,GAAG,MAAM,EAAE,CAmCpE;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,MAAM,CA8C/E;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAInD;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQlD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAmB3F;AAED,wBAAgB,cAAc;;;;;YAOJ,MAAM;cAAQ,MAAM;cAAQ,MAAM;eAAS,MAAM;mBAAa,MAAM;;;YAGpE,MAAM;cAAQ,MAAM;cAAQ,MAAM;eAAS,MAAM;sBAAgB,MAAM;;;oBAG/D,MAAM;eAAS,MAAM;;;gBAGzB,MAAM;eAAS,MAAM;;EAGlD"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/db/prompts.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,MAAM,EACN,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EAGlB,MAAM,mBAAmB,CAAA;AA0B1B,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAyC7D;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOzD;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAItD;AAED,wBAAgB,WAAW,CAAC,MAAM,GAAE,iBAAsB,GAAG,MAAM,EAAE,CAmCpE;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,MAAM,CA8C/E;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAInD;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQlD;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAKnE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,EAAE,KAAK,UAAQ,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAE,CA6BtI;AAED,wBAAgB,cAAc;;;;;YAOJ,MAAM;cAAQ,MAAM;cAAQ,MAAM;eAAS,MAAM;mBAAa,MAAM;;;YAGpE,MAAM;cAAQ,MAAM;cAAQ,MAAM;eAAS,MAAM;sBAAgB,MAAM;;;oBAG/D,MAAM;eAAS,MAAM;;;gBAGzB,MAAM;eAAS,MAAM;;EAGlD"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { createPrompt, getPrompt, requirePrompt, listPrompts, updatePrompt, deletePrompt, usePrompt, upsertPrompt, getPromptStats } from "./db/prompts.js";
+export { createPrompt, getPrompt, requirePrompt, listPrompts, updatePrompt, deletePrompt, usePrompt, upsertPrompt, getPromptStats, pinPrompt } from "./db/prompts.js";
 export { listVersions, getVersion, restoreVersion } from "./db/versions.js";
 export { listCollections, getCollection, ensureCollection, movePrompt } from "./db/collections.js";
 export { registerAgent, listAgents } from "./db/agents.js";
@@ -7,6 +7,8 @@ export { searchPrompts, findSimilar } from "./lib/search.js";
 export { extractVariables, extractVariableInfo, renderTemplate, validateVars } from "./lib/template.js";
 export type { VariableInfo } from "./lib/template.js";
 export { importFromJson, exportToJson } from "./lib/importer.js";
+export { findDuplicates } from "./lib/duplicates.js";
+export type { DuplicateMatch } from "./lib/duplicates.js";
 export { generateSlug, uniqueSlug, generatePromptId } from "./lib/ids.js";
 export type { Prompt, PromptVersion, Collection, Agent, TemplateVariable, PromptSource, CreatePromptInput, UpdatePromptInput, ListPromptsFilter, SearchResult, RenderResult, PromptStats, } from "./types/index.js";
 export { PromptNotFoundError, VersionConflictError, DuplicateSlugError, TemplateRenderError, } from "./types/index.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAC1J,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAC3E,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAClG,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAGzD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAG5D,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACvG,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGrD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGhE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAGzE,YAAY,EACV,MAAM,EACN,aAAa,EACb,UAAU,EACV,KAAK,EACL,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,WAAW,GACZ,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AACrK,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAC3E,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAClG,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAGzD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAG5D,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACvG,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGrD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAGzD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAGzE,YAAY,EACV,MAAM,EACN,aAAa,EACb,UAAU,EACV,KAAK,EACL,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,WAAW,GACZ,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,kBAAkB,CAAA"}