@hasna/prompts 0.2.2 → 0.3.0

package/dist/cli/index.js

@@ -17,6 +17,16 @@ var __toESM = (mod, isNodeMode, target) => {
   return to;
 };
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = import.meta.require;
 
 // node_modules/commander/lib/error.js
@@ -2053,31 +2063,10 @@ var require_commander = __commonJS((exports) => {
   exports.InvalidOptionArgumentError = InvalidArgumentError;
 });
 
-// node_modules/commander/esm.mjs
-var import__ = __toESM(require_commander(), 1);
-var {
-  program,
-  createCommand,
-  createArgument,
-  createOption,
-  CommanderError,
-  InvalidArgumentError,
-  InvalidOptionArgumentError,
-  Command,
-  Argument,
-  Option,
-  Help
-} = import__.default;
-
-// src/cli/index.tsx
-import chalk from "chalk";
-import { createRequire } from "module";
-
 // src/db/database.ts
 import { Database } from "bun:sqlite";
 import { join } from "path";
 import { existsSync, mkdirSync } from "fs";
-var _db = null;
 function getDbPath() {
   if (process.env["PROMPTS_DB_PATH"]) {
     return process.env["PROMPTS_DB_PATH"];
@@ -2202,6 +2191,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: `
@@ -2284,6 +2293,8 @@ function resolvePrompt(db, idOrSlug) {
     return byTitle[0].id;
   return null;
 }
+var _db = null;
+var init_database = () => {};
 
 // src/lib/ids.ts
 function generateSlug(title) {
@@ -2299,7 +2310,6 @@ function uniqueSlug(baseSlug) {
   }
   return slug;
 }
-var CHARS = "abcdefghijklmnopqrstuvwxyz0123456789";
 function nanoid(len) {
   let id = "";
   for (let i = 0;i < len; i++) {
@@ -2318,6 +2328,10 @@ function generatePromptId() {
 function generateId(prefix) {
   return `${prefix}-${nanoid(8)}`;
 }
+var CHARS = "abcdefghijklmnopqrstuvwxyz0123456789";
+var init_ids = __esm(() => {
+  init_database();
+});
 
 // src/db/collections.ts
 function rowToCollection(row) {
@@ -2373,6 +2387,10 @@ function movePrompt(promptIdOrSlug, targetCollection) {
     row.id
   ]);
 }
+var init_collections = __esm(() => {
+  init_database();
+  init_ids();
+});
 
 // src/lib/duplicates.ts
 function tokenize(text) {
@@ -2403,9 +2421,11 @@ function findDuplicates(body, threshold = 0.8, excludeSlug) {
   }
   return matches.sort((a, b) => b.score - a.score);
 }
+var init_duplicates = __esm(() => {
+  init_prompts();
+});
 
 // src/lib/template.ts
-var VAR_PATTERN = /\{\{\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*(?:\|\s*(.*?)\s*)?\}\}/g;
 function extractVariables(body) {
   const vars = new Set;
   const pattern = new RegExp(VAR_PATTERN.source, "g");
@@ -2446,34 +2466,39 @@ function renderTemplate(body, vars) {
   });
   return { rendered, missing_vars: missing, used_defaults: usedDefaults };
 }
+var VAR_PATTERN;
+var init_template = __esm(() => {
+  VAR_PATTERN = /\{\{\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*(?:\|\s*(.*?)\s*)?\}\}/g;
+});
 
 // src/types/index.ts
-class PromptNotFoundError extends Error {
-  constructor(id) {
-    super(`Prompt not found: ${id}`);
-    this.name = "PromptNotFoundError";
-  }
-}
-
-class VersionConflictError extends Error {
-  constructor(id) {
-    super(`Version conflict on prompt: ${id}`);
-    this.name = "VersionConflictError";
-  }
-}
-
-class DuplicateSlugError extends Error {
-  constructor(slug) {
-    super(`A prompt with slug "${slug}" already exists`);
-    this.name = "DuplicateSlugError";
-  }
-}
-class ProjectNotFoundError extends Error {
-  constructor(id) {
-    super(`Project not found: ${id}`);
-    this.name = "ProjectNotFoundError";
-  }
-}
+var PromptNotFoundError, VersionConflictError, DuplicateSlugError, ProjectNotFoundError;
+var init_types = __esm(() => {
+  PromptNotFoundError = class PromptNotFoundError extends Error {
+    constructor(id) {
+      super(`Prompt not found: ${id}`);
+      this.name = "PromptNotFoundError";
+    }
+  };
+  VersionConflictError = class VersionConflictError extends Error {
+    constructor(id) {
+      super(`Version conflict on prompt: ${id}`);
+      this.name = "VersionConflictError";
+    }
+  };
+  DuplicateSlugError = class DuplicateSlugError extends Error {
+    constructor(slug) {
+      super(`A prompt with slug "${slug}" already exists`);
+      this.name = "DuplicateSlugError";
+    }
+  };
+  ProjectNotFoundError = class ProjectNotFoundError extends Error {
+    constructor(id) {
+      super(`Project not found: ${id}`);
+      this.name = "ProjectNotFoundError";
+    }
+  };
+});
 
 // src/db/prompts.ts
 function rowToPrompt(row) {
@@ -2488,6 +2513,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"],
@@ -2586,6 +2613,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,
@@ -2596,6 +2624,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,
@@ -2618,6 +2648,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) {
@@ -2663,8 +2717,198 @@ function getPromptStats() {
   const bySource = db.query("SELECT source, COUNT(*) as count FROM prompts GROUP BY source ORDER BY count DESC").all();
   return { total_prompts: total, total_templates: templates, total_collections: collections, most_used: mostUsed, recently_used: recentlyUsed, by_collection: byCollection, by_source: bySource };
 }
+var init_prompts = __esm(() => {
+  init_database();
+  init_ids();
+  init_collections();
+  init_duplicates();
+  init_template();
+  init_types();
+  init_ids();
+});
+
+// src/lib/importer.ts
+var exports_importer = {};
+__export(exports_importer, {
+  scanAndImportSlashCommands: () => scanAndImportSlashCommands,
+  promptToMarkdown: () => promptToMarkdown,
+  markdownToImportItem: () => markdownToImportItem,
+  importFromMarkdown: () => importFromMarkdown,
+  importFromJson: () => importFromJson,
+  importFromClaudeCommands: () => importFromClaudeCommands,
+  exportToMarkdownFiles: () => exportToMarkdownFiles,
+  exportToJson: () => exportToJson
+});
+function importFromJson(items, changedBy) {
+  let created = 0;
+  let updated = 0;
+  const errors = [];
+  for (const item of items) {
+    try {
+      const input = {
+        title: item.title,
+        body: item.body,
+        slug: item.slug,
+        description: item.description,
+        collection: item.collection,
+        tags: item.tags,
+        source: "imported",
+        changed_by: changedBy
+      };
+      const { created: wasCreated } = upsertPrompt(input);
+      if (wasCreated)
+        created++;
+      else
+        updated++;
+    } catch (e) {
+      errors.push({ item: item.title, error: e instanceof Error ? e.message : String(e) });
+    }
+  }
+  return { created, updated, errors };
+}
+function exportToJson(collection) {
+  const prompts = listPrompts({ collection, limit: 1e4 });
+  return { prompts, exported_at: new Date().toISOString(), collection };
+}
+function promptToMarkdown(prompt) {
+  const tags = prompt.tags.length > 0 ? `[${prompt.tags.join(", ")}]` : "[]";
+  const desc = prompt.description ? `
+description: ${prompt.description}` : "";
+  return `---
+title: ${prompt.title}
+slug: ${prompt.slug}
+collection: ${prompt.collection}
+tags: ${tags}${desc}
+---
+
+${prompt.body}
+`;
+}
+function exportToMarkdownFiles(collection) {
+  const prompts = listPrompts({ collection, limit: 1e4 });
+  return prompts.map((p) => ({
+    filename: `${p.slug}.md`,
+    content: promptToMarkdown(p)
+  }));
+}
+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 importFromMarkdown(files, changedBy) {
+  const items = files.map((f) => markdownToImportItem(f.content, f.filename)).filter((item) => item !== null);
+  return importFromJson(items, changedBy);
+}
+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 };
+}
+function importFromClaudeCommands(files, changedBy) {
+  const items = files.map((f) => {
+    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: "claude-commands",
+      tags: ["claude", "slash-command"]
+    };
+  });
+  return importFromJson(items, changedBy);
+}
+var init_importer = __esm(() => {
+  init_prompts();
+});
+
+// node_modules/commander/esm.mjs
+var import__ = __toESM(require_commander(), 1);
+var {
+  program,
+  createCommand,
+  createArgument,
+  createOption,
+  CommanderError,
+  InvalidArgumentError,
+  InvalidOptionArgumentError,
+  Command,
+  Argument,
+  Option,
+  Help
+} = import__.default;
+
+// src/cli/index.tsx
+init_prompts();
+import chalk from "chalk";
+import { createRequire } from "module";
 
 // src/db/versions.ts
+init_database();
+init_ids();
+init_types();
 function rowToVersion(row) {
   return {
     id: row["id"],
@@ -2703,7 +2947,13 @@ function restoreVersion(promptId, version, changedBy) {
      VALUES (?, ?, ?, ?, ?)`, [generateId("VER"), promptId, ver.body, newVersion, changedBy ?? null]);
 }
 
+// src/cli/index.tsx
+init_collections();
+
 // src/db/projects.ts
+init_database();
+init_ids();
+init_types();
 function rowToProject(row, promptCount) {
   return {
     id: row["id"],
@@ -2749,7 +2999,12 @@ function deleteProject(idOrSlug) {
   db.run("DELETE FROM projects WHERE id = ?", [id]);
 }
 
+// src/cli/index.tsx
+init_database();
+
 // src/lib/search.ts
+init_database();
+init_prompts();
 function rowToSearchResult(row, snippet) {
   return {
     prompt: {
@@ -2763,6 +3018,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"],
@@ -2833,40 +3090,31 @@ function searchPrompts(query, filter = {}) {
        LIMIT ? OFFSET ?`).all(like, like, like, like, like, like, filter.limit ?? 50, filter.offset ?? 0);
   return rows.map((r) => rowToSearchResult(r));
 }
-
-// src/lib/importer.ts
-function importFromJson(items, changedBy) {
-  let created = 0;
-  let updated = 0;
-  const errors = [];
-  for (const item of items) {
-    try {
-      const input = {
-        title: item.title,
-        body: item.body,
-        slug: item.slug,
-        description: item.description,
-        collection: item.collection,
-        tags: item.tags,
-        source: "imported",
-        changed_by: changedBy
-      };
-      const { created: wasCreated } = upsertPrompt(input);
-      if (wasCreated)
-        created++;
-      else
-        updated++;
-    } catch (e) {
-      errors.push({ item: item.title, error: e instanceof Error ? e.message : String(e) });
-    }
+function findSimilar(promptId, limit = 5) {
+  const db = getDatabase();
+  const prompt = db.query("SELECT * FROM prompts WHERE id = ?").get(promptId);
+  if (!prompt)
+    return [];
+  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);
+    return rows.map((r) => rowToSearchResult(r));
   }
-  return { created, updated, errors };
-}
-function exportToJson(collection) {
-  const prompts = listPrompts({ collection, limit: 1e4 });
-  return { prompts, exported_at: new Date().toISOString(), collection };
+  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;
+    const sameCollection = row["collection"] === collection ? 1 : 0;
+    return { row, score: overlap * 2 + sameCollection };
+  });
+  return scored.filter((s) => s.score > 0).sort((a, b) => b.score - a.score).slice(0, limit).map((s) => rowToSearchResult(s.row, undefined));
 }
 
+// src/cli/index.tsx
+init_template();
+init_importer();
+
 // src/lib/lint.ts
 function lintPrompt(p) {
   const issues = [];
@@ -2901,6 +3149,271 @@ function lintAll(prompts) {
   return prompts.map((p) => ({ prompt: p, issues: lintPrompt(p) })).filter((r) => r.issues.length > 0);
 }
 
+// src/lib/audit.ts
+init_database();
+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 errors = 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, warnings, info, checked_at: new Date().toISOString() };
+}
+
+// src/lib/completion.ts
+var SUBCOMMANDS = [
+  "save",
+  "use",
+  "get",
+  "list",
+  "search",
+  "render",
+  "templates",
+  "inspect",
+  "update",
+  "delete",
+  "history",
+  "restore",
+  "collections",
+  "move",
+  "pin",
+  "unpin",
+  "copy",
+  "recent",
+  "stale",
+  "unused",
+  "lint",
+  "stats",
+  "export",
+  "import",
+  "import-slash-commands",
+  "watch",
+  "similar",
+  "diff",
+  "duplicate",
+  "trending",
+  "audit",
+  "completion",
+  "project"
+];
+var GLOBAL_OPTIONS = ["--json", "--project"];
+var SOURCES = ["manual", "ai-session", "imported"];
+function generateZshCompletion() {
+  return `#compdef prompts
+
+_prompts() {
+  local state line
+  typeset -A opt_args
+
+  _arguments \\
+    '--json[Output as JSON]' \\
+    '--project[Active project]:project:->projects' \\
+    '1:command:->commands' \\
+    '*::args:->args'
+
+  case $state in
+    commands)
+      local commands=(${SUBCOMMANDS.map((c) => `'${c}'`).join(" ")})
+      _describe 'command' commands
+      ;;
+    projects)
+      local projects=($(prompts project list --json 2>/dev/null | command grep -o '"slug":"[^"]*"' | cut -d'"' -f4))
+      _describe 'project' projects
+      ;;
+    args)
+      case $line[1] in
+        use|get|copy|pin|unpin|inspect|history|diff|duplicate|similar)
+          local slugs=($(prompts list --json 2>/dev/null | command grep -o '"slug":"[^"]*"' | cut -d'"' -f4))
+          _describe 'prompt' slugs
+          ;;
+        save|update)
+          _arguments \\
+            '-b[Body]:body:' \\
+            '-f[File]:file:_files' \\
+            '-s[Slug]:slug:' \\
+            '-d[Description]:description:' \\
+            '-c[Collection]:collection:($(prompts collections --json 2>/dev/null | command grep -o '"name":"[^"]*"' | cut -d'"' -f4))' \\
+            '-t[Tags]:tags:' \\
+            '--source[Source]:source:(${SOURCES.join(" ")})' \\
+            '--pin[Pin immediately]' \\
+            '--force[Force save]'
+          ;;
+        list|search)
+          _arguments \\
+            '-c[Collection]:collection:($(prompts collections --json 2>/dev/null | command grep -o '"name":"[^"]*"' | cut -d'"' -f4))' \\
+            '-t[Tags]:tags:' \\
+            '--templates[Templates only]' \\
+            '--recent[Sort by recent]' \\
+            '-n[Limit]:number:'
+          ;;
+        move)
+          local slugs=($(prompts list --json 2>/dev/null | command grep -o '"slug":"[^"]*"' | cut -d'"' -f4))
+          _describe 'prompt' slugs
+          ;;
+        restore)
+          local slugs=($(prompts list --json 2>/dev/null | command grep -o '"slug":"[^"]*"' | cut -d'"' -f4))
+          _describe 'prompt' slugs
+          ;;
+        completion)
+          _arguments '1:shell:(zsh bash)'
+          ;;
+      esac
+      ;;
+  esac
+}
+
+_prompts
+`;
+}
+function generateBashCompletion() {
+  return `_prompts_completions() {
+  local cur prev words
+  COMPREPLY=()
+  cur="\${COMP_WORDS[COMP_CWORD]}"
+  prev="\${COMP_WORDS[COMP_CWORD-1]}"
+
+  local subcommands="${SUBCOMMANDS.join(" ")}"
+
+  if [[ \${COMP_CWORD} -eq 1 ]]; then
+    COMPREPLY=($(compgen -W "\${subcommands}" -- "\${cur}"))
+    return 0
+  fi
+
+  case "\${prev}" in
+    --project)
+      local projects=$(prompts project list --json 2>/dev/null | grep -o '"slug":"[^"]*"' | cut -d'"' -f4)
+      COMPREPLY=($(compgen -W "\${projects}" -- "\${cur}"))
+      return 0
+      ;;
+    -c)
+      local cols=$(prompts collections --json 2>/dev/null | grep -o '"name":"[^"]*"' | cut -d'"' -f4)
+      COMPREPLY=($(compgen -W "\${cols}" -- "\${cur}"))
+      return 0
+      ;;
+    --source)
+      COMPREPLY=($(compgen -W "${SOURCES.join(" ")}" -- "\${cur}"))
+      return 0
+      ;;
+  esac
+
+  local cmd="\${COMP_WORDS[1]}"
+  case "\${cmd}" in
+    use|get|copy|pin|unpin|inspect|history|diff|duplicate|similar|render|restore|move|update|delete)
+      local slugs=$(prompts list --json 2>/dev/null | grep -o '"slug":"[^"]*"' | cut -d'"' -f4)
+      COMPREPLY=($(compgen -W "\${slugs}" -- "\${cur}"))
+      ;;
+    completion)
+      COMPREPLY=($(compgen -W "zsh bash" -- "\${cur}"))
+      ;;
+    *)
+      COMPREPLY=($(compgen -W "${GLOBAL_OPTIONS.join(" ")}" -- "\${cur}"))
+      ;;
+  esac
+}
+
+complete -F _prompts_completions prompts
+`;
+}
+
+// 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;
+}
+
 // src/cli/index.tsx
 var require2 = createRequire(import.meta.url);
 var pkg = require2("../../package.json");
@@ -2937,7 +3450,7 @@ function fmtPrompt(p) {
   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)").option("--force", "Save even if a similar prompt already exists").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").option("--pin", "Pin immediately so it appears first in all lists").action(async (title, opts) => {
   try {
     let body = opts["body"] ?? "";
     if (opts["file"]) {
@@ -2966,13 +3479,17 @@ program2.command("save <title>").description("Save a new prompt (or update exist
     if (duplicate_warning && !isJson()) {
       console.warn(chalk.yellow(`Warning: ${duplicate_warning}`));
     }
+    if (opts["pin"])
+      pinPrompt(prompt.id, true);
     if (isJson()) {
-      output(prompt);
+      output(opts["pin"] ? { ...prompt, pinned: true } : prompt);
     } else {
       const action = created ? chalk.green("Created") : chalk.yellow("Updated");
       console.log(`${action} ${chalk.bold(prompt.id)} \u2014 ${chalk.green(prompt.slug)}`);
       console.log(chalk.gray(`  Title: ${prompt.title}`));
       console.log(chalk.gray(`  Collection: ${prompt.collection}`));
+      if (opts["pin"])
+        console.log(chalk.yellow("  \uD83D\uDCCC Pinned"));
       if (prompt.is_template) {
         const vars = extractVariableInfo(prompt.body);
         console.log(chalk.cyan(`  Template vars: ${vars.map((v) => v.name).join(", ")}`));
@@ -2982,13 +3499,33 @@ program2.command("save <title>").description("Save a new prompt (or update exist
     handleError(e);
   }
 });
-program2.command("use <id>").description("Get a prompt's body and increment its use counter").action((id) => {
+program2.command("use <id>").description("Get a prompt's body and increment its use counter").option("--edit", "Open in $EDITOR for quick tweaks before printing").action(async (id, opts) => {
   try {
     const prompt = usePrompt(id);
+    let body = prompt.body;
+    if (opts.edit) {
+      const editor = process.env["EDITOR"] ?? process.env["VISUAL"] ?? "nano";
+      const { writeFileSync, readFileSync, unlinkSync } = await import("fs");
+      const { tmpdir } = await import("os");
+      const { join: join2 } = await import("path");
+      const tmp = join2(tmpdir(), `prompts-${prompt.id}-${Date.now()}.md`);
+      writeFileSync(tmp, body);
+      const proc = Bun.spawnSync([editor, tmp], { stdio: ["inherit", "inherit", "inherit"] });
+      if (proc.exitCode === 0) {
+        body = readFileSync(tmp, "utf-8");
+      }
+      try {
+        unlinkSync(tmp);
+      } catch {}
+    }
     if (isJson()) {
-      output(prompt);
+      output({ ...prompt, body });
     } else {
-      console.log(prompt.body);
+      console.log(body);
+      if (prompt.next_prompt) {
+        console.error(chalk.gray(`
+\u2192 next: ${chalk.bold(prompt.next_prompt)}`));
+      }
     }
   } catch (e) {
     handleError(e);
@@ -3354,18 +3891,29 @@ program2.command("stale [days]").description("List prompts not used in N days (d
     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 ?? ""));
+    const now = new Date().toISOString();
+    const expired = all.filter((p) => p.expires_at !== null && p.expires_at < now);
     if (isJson()) {
-      output(stale);
+      output({ stale, expired });
       return;
     }
-    if (stale.length === 0) {
+    if (expired.length > 0) {
+      console.log(chalk.red(`
+Expired (${expired.length}):`));
+      for (const p of expired)
+        console.log(chalk.red(`  \u2717 ${p.slug}`) + chalk.gray(` expired ${new Date(p.expires_at).toLocaleDateString()}`));
+    }
+    if (stale.length === 0 && expired.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}`);
+    if (stale.length > 0) {
+      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)`));
@@ -3472,6 +4020,31 @@ projectCmd.command("get <id>").description("Get project details").action((id) =>
     handleError(e);
   }
 });
+projectCmd.command("prompts <id>").description("List all prompts for a project (project-scoped + globals)").option("-n, --limit <n>", "Max results", "100").action((id, opts) => {
+  try {
+    const project = getProject(id);
+    if (!project)
+      handleError(`Project not found: ${id}`);
+    const prompts = listPrompts({ project_id: project.id, limit: parseInt(opts["limit"] ?? "100") || 100 });
+    if (isJson()) {
+      output(prompts);
+      return;
+    }
+    if (prompts.length === 0) {
+      console.log(chalk.gray("No prompts."));
+      return;
+    }
+    console.log(chalk.bold(`Prompts for project: ${project.name}`));
+    for (const p of prompts) {
+      const scope = p.project_id ? chalk.cyan(" [project]") : chalk.gray(" [global]");
+      console.log(fmtPrompt(p) + scope);
+    }
+    console.log(chalk.gray(`
+${prompts.length} prompt(s)`));
+  } catch (e) {
+    handleError(e);
+  }
+});
 projectCmd.command("delete <id>").description("Delete a project (prompts become global)").option("-y, --yes", "Skip confirmation").action(async (id, opts) => {
   try {
     const project = getProject(id);
@@ -3500,4 +4073,245 @@ projectCmd.command("delete <id>").description("Delete a project (prompts become
     handleError(e);
   }
 });
+program2.command("audit").description("Check for orphaned project refs, empty collections, missing history, near-duplicate slugs, expired prompts").action(() => {
+  try {
+    const report = runAudit();
+    if (isJson()) {
+      output(report);
+      return;
+    }
+    if (report.issues.length === 0) {
+      console.log(chalk.green("\u2713 No audit issues found."));
+      return;
+    }
+    for (const issue of report.issues) {
+      const sym = issue.severity === "error" ? chalk.red("\u2717") : issue.severity === "warn" ? chalk.yellow("\u26A0") : chalk.gray("\u2139");
+      const slug = issue.slug ? chalk.green(` ${issue.slug}`) : "";
+      console.log(`${sym}${slug}  ${issue.message}`);
+    }
+    console.log(chalk.bold(`
+${report.issues.length} issue(s) \u2014 ${report.errors} errors, ${report.warnings} warnings, ${report.info} info`));
+    if (report.errors > 0)
+      process.exit(1);
+  } catch (e) {
+    handleError(e);
+  }
+});
+program2.command("unused").description("List prompts that have never been used (use_count = 0)").option("-c, --collection <name>").option("-n, --limit <n>", "Max results", "50").action((opts) => {
+  try {
+    const all = listPrompts({ collection: opts["collection"], limit: parseInt(opts["limit"] ?? "50") || 50 });
+    const unused = all.filter((p) => p.use_count === 0).sort((a, b) => a.created_at.localeCompare(b.created_at));
+    if (isJson()) {
+      output(unused);
+      return;
+    }
+    if (unused.length === 0) {
+      console.log(chalk.green("All prompts have been used at least once."));
+      return;
+    }
+    console.log(chalk.bold(`Unused prompts (${unused.length}):`));
+    for (const p of unused) {
+      console.log(`  ${fmtPrompt(p)}  ${chalk.gray(`created ${new Date(p.created_at).toLocaleDateString()}`)}`);
+    }
+  } catch (e) {
+    handleError(e);
+  }
+});
+program2.command("trending").description("Most used prompts in the last N days").option("--days <n>", "Lookback window in days", "7").option("-n, --limit <n>", "Max results", "10").action((opts) => {
+  try {
+    const results = getTrending(parseInt(opts["days"] ?? "7") || 7, parseInt(opts["limit"] ?? "10") || 10);
+    if (isJson()) {
+      output(results);
+      return;
+    }
+    if (results.length === 0) {
+      console.log(chalk.gray("No usage data yet."));
+      return;
+    }
+    console.log(chalk.bold(`Trending (last ${opts["days"] ?? "7"} days):`));
+    for (const r of results) {
+      console.log(`  ${chalk.green(r.slug)}  ${chalk.bold(String(r.uses))}\xD7  ${chalk.gray(r.title)}`);
+    }
+  } catch (e) {
+    handleError(e);
+  }
+});
+program2.command("expire <id> [date]").description("Set expiry date for a prompt (ISO date, e.g. 2026-12-31). Use 'none' to clear.").action((id, date) => {
+  try {
+    const expiresAt = !date || date === "none" ? null : new Date(date).toISOString();
+    const p = setExpiry(id, expiresAt);
+    if (isJson())
+      output(p);
+    else
+      console.log(expiresAt ? chalk.yellow(`Expires ${p.slug} on ${new Date(expiresAt).toLocaleDateString()}`) : chalk.gray(`Cleared expiry for ${p.slug}`));
+  } catch (e) {
+    handleError(e);
+  }
+});
+program2.command("duplicate <id>").description("Clone a prompt with a new slug").option("-s, --to <slug>", "New slug (auto-generated if omitted)").option("--title <title>", "New title (defaults to 'Copy of <original>')").action((id, opts) => {
+  try {
+    const source = getPrompt(id);
+    if (!source)
+      handleError(`Prompt not found: ${id}`);
+    const p = source;
+    const { prompt } = upsertPrompt({
+      title: opts["title"] ?? `Copy of ${p.title}`,
+      slug: opts["to"],
+      body: p.body,
+      description: p.description ?? undefined,
+      collection: p.collection,
+      tags: p.tags,
+      source: "manual"
+    });
+    if (isJson())
+      output(prompt);
+    else
+      console.log(`${chalk.green("Duplicated")} ${chalk.bold(p.slug)} \u2192 ${chalk.bold(prompt.slug)}`);
+  } catch (e) {
+    handleError(e);
+  }
+});
+program2.command("diff <id> <v1> [v2]").description("Show diff between two versions of a prompt (v2 defaults to current)").action((id, v1, v2) => {
+  try {
+    const prompt = getPrompt(id);
+    if (!prompt)
+      handleError(`Prompt not found: ${id}`);
+    const versions = listVersions(prompt.id);
+    const versionA = versions.find((v) => v.version === parseInt(v1));
+    if (!versionA)
+      handleError(`Version ${v1} not found`);
+    const bodyB = v2 ? versions.find((v) => v.version === parseInt(v2))?.body ?? null : prompt.body;
+    if (bodyB === null)
+      handleError(`Version ${v2} not found`);
+    const lines = diffTexts(versionA.body, bodyB);
+    if (isJson()) {
+      output(lines);
+      return;
+    }
+    const label2 = v2 ? `v${v2}` : "current";
+    console.log(chalk.bold(`${prompt.slug}: v${v1} \u2192 ${label2}`));
+    for (const l of lines) {
+      if (l.type === "added")
+        console.log(chalk.green(`+ ${l.content}`));
+      else if (l.type === "removed")
+        console.log(chalk.red(`- ${l.content}`));
+      else
+        console.log(chalk.gray(`  ${l.content}`));
+    }
+  } catch (e) {
+    handleError(e);
+  }
+});
+program2.command("chain <id> [next]").description("Set the next prompt in a chain, or show the chain for a prompt. Use 'none' to clear.").action((id, next) => {
+  try {
+    if (next !== undefined) {
+      const nextSlug = next === "none" ? null : next;
+      const p = setNextPrompt(id, nextSlug);
+      if (isJson())
+        output(p);
+      else
+        console.log(nextSlug ? `${chalk.green(p.slug)} \u2192 ${chalk.bold(nextSlug)}` : chalk.gray(`Cleared chain for ${p.slug}`));
+      return;
+    }
+    const prompt = getPrompt(id);
+    if (!prompt)
+      handleError(`Prompt not found: ${id}`);
+    const chain = [];
+    let cur = prompt;
+    const seen = new Set;
+    while (cur && !seen.has(cur.id)) {
+      chain.push({ slug: cur.slug, title: cur.title });
+      seen.add(cur.id);
+      cur = cur.next_prompt ? getPrompt(cur.next_prompt) : null;
+    }
+    if (isJson()) {
+      output(chain);
+      return;
+    }
+    console.log(chain.map((c) => chalk.green(c.slug)).join(chalk.gray(" \u2192 ")));
+  } catch (e) {
+    handleError(e);
+  }
+});
+program2.command("similar <id>").description("Find prompts similar to a given prompt (by tag overlap and collection)").option("-n, --limit <n>", "Max results", "5").action((id, opts) => {
+  try {
+    const prompt = getPrompt(id);
+    if (!prompt)
+      handleError(`Prompt not found: ${id}`);
+    const results = findSimilar(prompt.id, parseInt(opts["limit"] ?? "5") || 5);
+    if (isJson()) {
+      output(results);
+      return;
+    }
+    if (results.length === 0) {
+      console.log(chalk.gray("No similar prompts found."));
+      return;
+    }
+    for (const r of results) {
+      const score = chalk.gray(`${Math.round(r.score * 100)}%`);
+      console.log(`${fmtPrompt(r.prompt)}  ${score}`);
+    }
+  } catch (e) {
+    handleError(e);
+  }
+});
+program2.command("completion [shell]").description("Output shell completion script (zsh or bash)").action((shell) => {
+  const sh = shell ?? (process.env["SHELL"]?.includes("zsh") ? "zsh" : "bash");
+  if (sh === "zsh") {
+    console.log(generateZshCompletion());
+  } else if (sh === "bash") {
+    console.log(generateBashCompletion());
+  } else {
+    handleError(`Unknown shell: ${sh}. Use 'zsh' or 'bash'.`);
+  }
+});
+program2.command("watch [dir]").description("Watch a directory for .md changes and auto-import prompts (default: .prompts/)").option("-c, --collection <name>", "Collection to import into", "watched").option("--agent <name>", "Attribution").action(async (dir, opts) => {
+  const { existsSync: existsSync2, mkdirSync: mkdirSync2 } = await import("fs");
+  const { resolve, join: join2 } = await import("path");
+  const watchDir = resolve(dir ?? join2(process.cwd(), ".prompts"));
+  if (!existsSync2(watchDir))
+    mkdirSync2(watchDir, { recursive: true });
+  console.log(chalk.bold(`Watching ${watchDir} for .md changes\u2026`) + chalk.gray(" (Ctrl+C to stop)"));
+  const { importFromMarkdown: importFromMarkdown2 } = await Promise.resolve().then(() => (init_importer(), exports_importer));
+  const { readFileSync } = await import("fs");
+  const fsWatch = (await import("fs")).watch;
+  fsWatch(watchDir, { persistent: true }, async (_event, filename) => {
+    if (!filename?.endsWith(".md"))
+      return;
+    const filePath = join2(watchDir, filename);
+    try {
+      const content = readFileSync(filePath, "utf-8");
+      const result = importFromMarkdown2([{ filename, content }], opts["agent"]);
+      const action = result.created > 0 ? chalk.green("Created") : chalk.yellow("Updated");
+      console.log(`${action}: ${chalk.bold(filename.replace(".md", ""))}  ${chalk.gray(new Date().toLocaleTimeString())}`);
+    } catch {
+      console.error(chalk.red(`Failed to import: ${filename}`));
+    }
+  });
+  await new Promise(() => {});
+});
+program2.command("import-slash-commands").description("Auto-scan .claude/commands, .codex/skills, .gemini/extensions and import all prompts").option("--dir <path>", "Root dir to scan (default: cwd)", process.cwd()).option("--agent <name>", "Attribution").action((opts) => {
+  try {
+    const { scanned, imported } = scanAndImportSlashCommands(opts["dir"] ?? process.cwd(), opts["agent"]);
+    if (isJson()) {
+      output({ scanned, imported });
+      return;
+    }
+    if (scanned.length === 0) {
+      console.log(chalk.gray("No slash command files found."));
+      return;
+    }
+    console.log(chalk.bold(`Scanned ${scanned.length} file(s):`));
+    for (const s of scanned)
+      console.log(chalk.gray(`  ${s.source}/${s.file}`));
+    console.log(`
+${chalk.green(`Created: ${imported.created}`)}  ${chalk.yellow(`Updated: ${imported.updated}`)}`);
+    if (imported.errors.length > 0) {
+      for (const e of imported.errors)
+        console.error(chalk.red(`  \u2717 ${e.item}: ${e.error}`));
+    }
+  } catch (e) {
+    handleError(e);
+  }
+});
 program2.parse();