skilld 1.5.0 → 1.5.2

package/dist/_chunks/pool2.mjs

@@ -0,0 +1,118 @@
+import { dirname, join } from "pathe";
+import { existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { Worker } from "node:worker_threads";
+//#region src/retriv/pool.ts
+let worker = null;
+let taskId = 0;
+const pending = /* @__PURE__ */ new Map();
+const queue = [];
+let running = false;
+function resolveWorkerPath() {
+	const dir = dirname(fileURLToPath(import.meta.url));
+	for (const candidate of [join(dir, "worker.mjs"), join(dir, "..", "retriv", "worker.mjs")]) if (existsSync(candidate)) return { path: candidate };
+	return {
+		path: join(dir, "worker.ts"),
+		execArgv: ["--experimental-strip-types"]
+	};
+}
+function ensureWorker() {
+	if (worker) return worker;
+	const config = resolveWorkerPath();
+	const w = new Worker(config.path, { execArgv: config.execArgv });
+	w.on("message", (msg) => {
+		const task = pending.get(msg.id);
+		if (!task) return;
+		if (msg.type === "progress") task.onProgress?.({
+			phase: msg.phase,
+			current: msg.current,
+			total: msg.total
+		});
+		else if (msg.type === "done") {
+			pending.delete(msg.id);
+			task.resolve();
+		} else if (msg.type === "error") {
+			pending.delete(msg.id);
+			task.reject(new Error(msg.message));
+		}
+	});
+	w.on("error", (err) => {
+		for (const task of pending.values()) task.reject(err);
+		pending.clear();
+		worker = null;
+	});
+	w.on("exit", (code) => {
+		if (pending.size > 0) {
+			const err = /* @__PURE__ */ new Error(`Worker exited (code ${code}) with ${pending.size} pending tasks`);
+			for (const task of pending.values()) task.reject(err);
+			pending.clear();
+		}
+		worker = null;
+	});
+	worker = w;
+	return w;
+}
+function drainQueue() {
+	if (running || queue.length === 0) return;
+	queue.shift()();
+}
+async function createIndexInWorker(documents, config) {
+	return new Promise((resolve, reject) => {
+		const run = () => {
+			running = true;
+			const id = ++taskId;
+			let w;
+			try {
+				w = ensureWorker();
+			} catch (err) {
+				running = false;
+				drainQueue();
+				reject(err instanceof Error ? err : new Error(String(err)));
+				return;
+			}
+			pending.set(id, {
+				id,
+				resolve: () => {
+					running = false;
+					drainQueue();
+					resolve();
+				},
+				reject: (err) => {
+					running = false;
+					drainQueue();
+					reject(err);
+				},
+				onProgress: config.onProgress
+			});
+			const msg = {
+				type: "index",
+				id,
+				documents,
+				dbPath: config.dbPath,
+				removeIds: config.removeIds
+			};
+			w.postMessage(msg);
+		};
+		if (running) queue.push(run);
+		else run();
+	});
+}
+async function shutdownWorker() {
+	if (!worker) return;
+	const w = worker;
+	worker = null;
+	return new Promise((resolve) => {
+		const timeout = setTimeout(() => {
+			w.terminate().then(() => resolve(), () => resolve());
+		}, 5e3);
+		w.once("exit", () => {
+			clearTimeout(timeout);
+			resolve();
+		});
+		w.postMessage({ type: "shutdown" });
+	});
+}
+//#endregion
+export { shutdownWorker as n, createIndexInWorker as t };
+
+//# sourceMappingURL=pool2.mjs.map

package/dist/_chunks/pool2.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool2.mjs","names":[],"sources":["../../src/retriv/pool.ts"],"sourcesContent":["import type { IndexConfig, Document as RetrivDocument } from './types.ts'\nimport type { WorkerMessage, WorkerResponse } from './worker.ts'\nimport { existsSync } from 'node:fs'\nimport { fileURLToPath } from 'node:url'\nimport { Worker } from 'node:worker_threads'\nimport { dirname, join } from 'pathe'\n\ninterface PendingTask {\n  id: number\n  resolve: () => void\n  reject: (err: Error) => void\n  onProgress?: IndexConfig['onProgress']\n}\n\nlet worker: Worker | null = null\nlet taskId = 0\nconst pending = new Map<number, PendingTask>()\nconst queue: Array<() => void> = []\nlet running = false\n\nfunction resolveWorkerPath(): { path: string, execArgv?: string[] } {\n  const dir = dirname(fileURLToPath(import.meta.url))\n\n  // Bundled: dist/retriv/worker.mjs (resolve from package root, not chunk dir)\n  for (const candidate of [join(dir, 'worker.mjs'), join(dir, '..', 'retriv', 'worker.mjs')]) {\n    if (existsSync(candidate))\n      return { path: candidate }\n  }\n\n  // Dev stub: src/retriv/pool.ts → src/retriv/worker.ts\n  return { path: join(dir, 'worker.ts'), execArgv: ['--experimental-strip-types'] }\n}\n\nfunction ensureWorker(): Worker {\n  if (worker)\n    return worker\n\n  const config = resolveWorkerPath()\n  const w = new Worker(config.path, {\n    execArgv: config.execArgv,\n  })\n\n  w.on('message', (msg: WorkerResponse) => {\n    const task = pending.get(msg.id)\n    if (!task)\n      return\n\n    if (msg.type === 'progress') {\n      task.onProgress?.({ phase: msg.phase as any, current: msg.current, total: msg.total })\n    }\n    else if (msg.type === 'done') {\n      pending.delete(msg.id)\n      task.resolve()\n    }\n    else if (msg.type === 'error') {\n      pending.delete(msg.id)\n      task.reject(new Error(msg.message))\n    }\n  })\n\n  w.on('error', (err: Error) => {\n    for (const task of pending.values())\n      task.reject(err)\n    pending.clear()\n    worker = null\n  })\n\n  w.on('exit', (code) => {\n    if (pending.size > 0) {\n      const err = new Error(`Worker exited (code ${code}) with ${pending.size} pending tasks`)\n      for (const task of pending.values())\n        task.reject(err)\n      pending.clear()\n    }\n    worker = null\n  })\n\n  worker = w\n  return w\n}\n\nfunction drainQueue() {\n  if (running || queue.length === 0)\n    return\n  const next = queue.shift()!\n  next()\n}\n\nexport async function createIndexInWorker(\n  documents: RetrivDocument[],\n  config: IndexConfig & { removeIds?: string[] },\n): Promise<void> {\n  return new Promise<void>((resolve, reject) => {\n    const run = () => {\n      running = true\n      const id = ++taskId\n\n      let w: Worker\n      try {\n        w = ensureWorker()\n      }\n      catch (err) {\n        running = false\n        drainQueue()\n        reject(err instanceof Error ? err : new Error(String(err)))\n        return\n      }\n\n      pending.set(id, {\n        id,\n        resolve: () => {\n          running = false\n          drainQueue()\n          resolve()\n        },\n        reject: (err) => {\n          running = false\n          drainQueue()\n          reject(err)\n        },\n        onProgress: config.onProgress,\n      })\n\n      const msg: WorkerMessage = {\n        type: 'index',\n        id,\n        documents,\n        dbPath: config.dbPath,\n        removeIds: config.removeIds,\n      }\n\n      w.postMessage(msg)\n    }\n\n    if (running) {\n      queue.push(run)\n    }\n    else {\n      run()\n    }\n  })\n}\n\nexport async function shutdownWorker(): Promise<void> {\n  if (!worker)\n    return\n\n  const w = worker\n  worker = null\n\n  return new Promise<void>((resolve) => {\n    const timeout = setTimeout(() => {\n      w.terminate().then(() => resolve(), () => resolve())\n    }, 5000)\n\n    w.once('exit', () => {\n      clearTimeout(timeout)\n      resolve()\n    })\n\n    w.postMessage({ type: 'shutdown' } satisfies WorkerMessage)\n  })\n}\n"],"mappings":";;;;;AAcA,IAAI,SAAwB;AAC5B,IAAI,SAAS;AACb,MAAM,0BAAU,IAAI,KAA0B;AAC9C,MAAM,QAA2B,EAAE;AACnC,IAAI,UAAU;AAEd,SAAS,oBAA2D;CAClE,MAAM,MAAM,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;AAGnD,MAAK,MAAM,aAAa,CAAC,KAAK,KAAK,aAAa,EAAE,KAAK,KAAK,MAAM,UAAU,aAAa,CAAC,CACxF,KAAI,WAAW,UAAU,CACvB,QAAO,EAAE,MAAM,WAAW;AAI9B,QAAO;EAAE,MAAM,KAAK,KAAK,YAAY;EAAE,UAAU,CAAC,6BAAA;EAA+B;;AAGnF,SAAS,eAAuB;AAC9B,KAAI,OACF,QAAO;CAET,MAAM,SAAS,mBAAmB;CAClC,MAAM,IAAI,IAAI,OAAO,OAAO,MAAM,EAChC,UAAU,OAAO,UAClB,CAAC;AAEF,GAAE,GAAG,YAAY,QAAwB;EACvC,MAAM,OAAO,QAAQ,IAAI,IAAI,GAAG;AAChC,MAAI,CAAC,KACH;AAEF,MAAI,IAAI,SAAS,WACf,MAAK,aAAa;GAAE,OAAO,IAAI;GAAc,SAAS,IAAI;GAAS,OAAO,IAAI;GAAO,CAAC;WAE/E,IAAI,SAAS,QAAQ;AAC5B,WAAQ,OAAO,IAAI,GAAG;AACtB,QAAK,SAAS;aAEP,IAAI,SAAS,SAAS;AAC7B,WAAQ,OAAO,IAAI,GAAG;AACtB,QAAK,OAAO,IAAI,MAAM,IAAI,QAAQ,CAAC;;GAErC;AAEF,GAAE,GAAG,UAAU,QAAe;AAC5B,OAAK,MAAM,QAAQ,QAAQ,QAAQ,CACjC,MAAK,OAAO,IAAI;AAClB,UAAQ,OAAO;AACf,WAAS;GACT;AAEF,GAAE,GAAG,SAAS,SAAS;AACrB,MAAI,QAAQ,OAAO,GAAG;GACpB,MAAM,sBAAM,IAAI,MAAM,uBAAuB,KAAK,SAAS,QAAQ,KAAK,gBAAgB;AACxF,QAAK,MAAM,QAAQ,QAAQ,QAAQ,CACjC,MAAK,OAAO,IAAI;AAClB,WAAQ,OAAO;;AAEjB,WAAS;GACT;AAEF,UAAS;AACT,QAAO;;AAGT,SAAS,aAAa;AACpB,KAAI,WAAW,MAAM,WAAW,EAC9B;AACW,OAAM,OAAO,EACpB;;AAGR,eAAsB,oBACpB,WACA,QACe;AACf,QAAO,IAAI,SAAe,SAAS,WAAW;EAC5C,MAAM,YAAY;AAChB,aAAU;GACV,MAAM,KAAK,EAAE;GAEb,IAAI;AACJ,OAAI;AACF,QAAI,cAAc;YAEb,KAAK;AACV,cAAU;AACV,gBAAY;AACZ,WAAO,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,IAAI,CAAC,CAAC;AAC3D;;AAGF,WAAQ,IAAI,IAAI;IACd;IACA,eAAe;AACb,eAAU;AACV,iBAAY;AACZ,cAAS;;IAEX,SAAS,QAAQ;AACf,eAAU;AACV,iBAAY;AACZ,YAAO,IAAI;;IAEb,YAAY,OAAO;IACpB,CAAC;GAEF,MAAM,MAAqB;IACzB,MAAM;IACN;IACA;IACA,QAAQ,OAAO;IACf,WAAW,OAAO;IACnB;AAED,KAAE,YAAY,IAAI;;AAGpB,MAAI,QACF,OAAM,KAAK,IAAI;MAGf,MAAK;GAEP;;AAGJ,eAAsB,iBAAgC;AACpD,KAAI,CAAC,OACH;CAEF,MAAM,IAAI;AACV,UAAS;AAET,QAAO,IAAI,SAAe,YAAY;EACpC,MAAM,UAAU,iBAAiB;AAC/B,KAAE,WAAW,CAAC,WAAW,SAAS,QAAQ,SAAS,CAAC;KACnD,IAAK;AAER,IAAE,KAAK,cAAc;AACnB,gBAAa,QAAQ;AACrB,YAAS;IACT;AAEF,IAAE,YAAY,EAAE,MAAM,YAAY,CAAyB;GAC3D"}

package/dist/_chunks/prepare.mjs

@@ -1,82 +1,17 @@
-import "./agent.mjs";
-import "./config.mjs";
-import "./sanitize.mjs";
-import { _ as resolvePkgDir, a as getShippedSkills, f as linkShippedSkill } from "./cache.mjs";
-import "./yaml.mjs";
-import "./markdown.mjs";
-import { n as getSharedSkillsDir } from "./shared.mjs";
-import "./sources.mjs";
-import { a as targets } from "./detect.mjs";
-import { i as linkSkillToAgents } from "./prompts.mjs";
-import { g as resolveAgent } from "./cli-helpers.mjs";
-import { i as readLock, s as writeLock, t as mergeLocks } from "./lockfile.mjs";
-import { t as getProjectState } from "./skills.mjs";
+import { o as getCacheDir } from "./config.mjs";
 import { join } from "pathe";
-import { existsSync, mkdirSync, symlinkSync } from "node:fs";
-import * as p from "@clack/prompts";
-import { defineCommand } from "citty";
-//#region src/commands/prepare.ts
-const prepareCommandDef = defineCommand({
-	meta: {
-		name: "prepare",
-		description: "Restore references and sync shipped skills (for package.json hooks)"
-	},
-	args: { agent: {
-		type: "enum",
-		options: Object.keys(targets),
-		alias: "a",
-		description: "Target agent"
-	} },
-	async run({ args }) {
-		const cwd = process.cwd();
-		const agent = resolveAgent(args.agent);
-		if (!agent || agent === "none") return;
-		const agentConfig = targets[agent];
-		const shared = getSharedSkillsDir(cwd);
-		const skillsDir = shared || join(cwd, agentConfig.skillsDir);
-		const allLocks = (shared ? [shared] : Object.values(targets).map((t) => join(cwd, t.skillsDir))).map((dir) => readLock(dir)).filter((l) => !!l && Object.keys(l.skills).length > 0);
-		if (allLocks.length > 0) {
-			const lock = mergeLocks(allLocks);
-			for (const [name, info] of Object.entries(lock.skills)) {
-				if (!info.version) continue;
-				if (info.source === "shipped") {
-					if (!existsSync(join(skillsDir, name))) {
-						const match = getShippedSkills(info.packageName || name, cwd, info.version).find((s) => s.skillName === name);
-						if (match) linkShippedSkill(skillsDir, name, match.skillDir);
-					}
-					continue;
-				}
-				restorePkgSymlink(skillsDir, name, info, cwd);
-			}
-		}
-		const state = await getProjectState(cwd);
-		let shippedCount = 0;
-		if (state.shipped.length > 0) {
-			mkdirSync(skillsDir, { recursive: true });
-			for (const entry of state.shipped) {
-				const version = state.deps.get(entry.packageName)?.replace(/^[\^~>=<]+/, "") || "0.0.0";
-				for (const skill of entry.skills) {
-					linkShippedSkill(skillsDir, skill.skillName, skill.skillDir);
-					writeLock(skillsDir, skill.skillName, {
-						packageName: entry.packageName,
-						version,
-						source: "shipped",
-						syncedAt: (/* @__PURE__ */ new Date()).toISOString().split("T")[0],
-						generator: "skilld"
-					});
-					if (shared) linkSkillToAgents(skill.skillName, shared, cwd, agent);
-					shippedCount++;
-				}
-			}
-			if (shippedCount > 0) p.log.success(`Installed ${shippedCount} shipped skill${shippedCount > 1 ? "s" : ""}`);
-		}
-		const freshState = shippedCount > 0 ? await getProjectState(cwd) : state;
-		if (freshState.outdated.length > 0) {
-			const n = freshState.outdated.length;
-			p.log.info(`${n} package${n > 1 ? "s" : ""} ha${n > 1 ? "ve" : "s"} new features and/or breaking changes. Run \`skilld update\` to sync.`);
-		}
+import { existsSync, lstatSync, mkdirSync, readdirSync, rmSync, symlinkSync, unlinkSync } from "node:fs";
+//#region src/core/prepare.ts
+/** Resolve package directory: node_modules first, then global cache */
+function resolvePkgDir(name, cwd, version) {
+	const nodeModulesPath = join(cwd, "node_modules", name);
+	if (existsSync(nodeModulesPath)) return nodeModulesPath;
+	if (version) {
+		const cachedPkgDir = join(getCacheDir(name, version), "pkg");
+		if (existsSync(join(cachedPkgDir, "package.json"))) return cachedPkgDir;
 	}
-});
+	return null;
+}
 /** Restore .skilld/pkg symlink to node_modules if broken */
 function restorePkgSymlink(skillsDir, name, info, cwd) {
 	const refsDir = join(skillsDir, name, ".skilld");
@@ -88,7 +23,28 @@ function restorePkgSymlink(skillsDir, name, info, cwd) {
 	mkdirSync(refsDir, { recursive: true });
 	symlinkSync(pkgDir, pkgLink);
 }
+/** Check if package ships a skills/ directory with SKILL.md or _SKILL.md subdirs */
+function getShippedSkills(name, cwd, version) {
+	const pkgPath = resolvePkgDir(name, cwd, version);
+	if (!pkgPath) return [];
+	const skillsPath = join(pkgPath, "skills");
+	if (!existsSync(skillsPath)) return [];
+	return readdirSync(skillsPath, { withFileTypes: true }).filter((d) => d.isDirectory() && (existsSync(join(skillsPath, d.name, "SKILL.md")) || existsSync(join(skillsPath, d.name, "_SKILL.md")))).map((d) => ({
+		skillName: d.name,
+		skillDir: join(skillsPath, d.name)
+	}));
+}
+/** Create symlink from skills dir to shipped skill dir */
+function linkShippedSkill(baseDir, skillName, targetDir) {
+	const linkPath = join(baseDir, skillName);
+	if (existsSync(linkPath)) if (lstatSync(linkPath).isSymbolicLink()) unlinkSync(linkPath);
+	else rmSync(linkPath, {
+		recursive: true,
+		force: true
+	});
+	symlinkSync(targetDir, linkPath);
+}
 //#endregion
-export { prepareCommandDef };
+export { restorePkgSymlink as i, linkShippedSkill as n, resolvePkgDir as r, getShippedSkills as t };
 
 //# sourceMappingURL=prepare.mjs.map

package/dist/_chunks/prepare.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"prepare.mjs","names":["agents"],"sources":["../../src/commands/prepare.ts"],"sourcesContent":["/**\n * Prepare command — lightweight hook for package.json \"prepare\" script.\n *\n * Designed to run on every `pnpm install` / `npm install`. Blocking, fast, no LLM calls.\n * 1. Restore broken symlinks from lockfile (like `install` but skips doc fetching)\n * 2. Auto-install shipped skills from deps (just symlinks + lockfile writes)\n * 3. Report outdated skills count and suggest `skilld update`\n */\n\nimport type { SkillInfo } from '../core/lockfile.ts'\nimport { existsSync, mkdirSync, symlinkSync } from 'node:fs'\nimport * as p from '@clack/prompts'\nimport { defineCommand } from 'citty'\nimport { join } from 'pathe'\nimport { agents, linkSkillToAgents } from '../agent/index.ts'\nimport { getShippedSkills, linkShippedSkill, resolvePkgDir } from '../cache/index.ts'\nimport { resolveAgent } from '../cli-helpers.ts'\nimport { mergeLocks, readLock, writeLock } from '../core/lockfile.ts'\nimport { getSharedSkillsDir } from '../core/shared.ts'\nimport { getProjectState } from '../core/skills.ts'\n\nexport const prepareCommandDef = defineCommand({\n  meta: { name: 'prepare', description: 'Restore references and sync shipped skills (for package.json hooks)' },\n  args: {\n    agent: {\n      type: 'enum' as const,\n      options: Object.keys(agents),\n      alias: 'a',\n      description: 'Target agent',\n    },\n  },\n  async run({ args }) {\n    const cwd = process.cwd()\n\n    const agent = resolveAgent(args.agent)\n    if (!agent || agent === 'none')\n      return\n\n    const agentConfig = agents[agent]\n    const shared = getSharedSkillsDir(cwd)\n    const skillsDir = shared || join(cwd, agentConfig.skillsDir)\n\n    // ── 1. Restore broken symlinks from lockfile ──\n\n    const allSkillsDirs = shared\n      ? [shared]\n      : Object.values(agents).map(t => join(cwd, t.skillsDir))\n    const allLocks = allSkillsDirs\n      .map(dir => readLock(dir))\n      .filter((l): l is NonNullable<typeof l> => !!l && Object.keys(l.skills).length > 0)\n\n    if (allLocks.length > 0) {\n      const lock = mergeLocks(allLocks)\n\n      for (const [name, info] of Object.entries(lock.skills)) {\n        if (!info.version)\n          continue\n\n        if (info.source === 'shipped') {\n          const skillDir = join(skillsDir, name)\n          if (!existsSync(skillDir)) {\n            const pkgName = info.packageName || name\n            const shipped = getShippedSkills(pkgName, cwd, info.version)\n            const match = shipped.find(s => s.skillName === name)\n            if (match)\n              linkShippedSkill(skillsDir, name, match.skillDir)\n          }\n          continue\n        }\n\n        // Non-shipped: restore .skilld/pkg symlink if broken\n        restorePkgSymlink(skillsDir, name, info, cwd)\n      }\n    }\n\n    // ── 2. Auto-install shipped skills from deps ──\n\n    const state = await getProjectState(cwd)\n    let shippedCount = 0\n\n    if (state.shipped.length > 0) {\n      mkdirSync(skillsDir, { recursive: true })\n\n      for (const entry of state.shipped) {\n        const version = state.deps.get(entry.packageName)?.replace(/^[\\^~>=<]+/, '') || '0.0.0'\n\n        for (const skill of entry.skills) {\n          linkShippedSkill(skillsDir, skill.skillName, skill.skillDir)\n          writeLock(skillsDir, skill.skillName, {\n            packageName: entry.packageName,\n            version,\n            source: 'shipped',\n            syncedAt: new Date().toISOString().split('T')[0],\n            generator: 'skilld',\n          })\n\n          if (shared)\n            linkSkillToAgents(skill.skillName, shared, cwd, agent)\n\n          shippedCount++\n        }\n      }\n\n      if (shippedCount > 0)\n        p.log.success(`Installed ${shippedCount} shipped skill${shippedCount > 1 ? 's' : ''}`)\n    }\n\n    // ── 3. Report outdated skills ──\n\n    // Re-read state after shipped installs so they don't show as missing\n    const freshState = shippedCount > 0 ? await getProjectState(cwd) : state\n\n    if (freshState.outdated.length > 0) {\n      const n = freshState.outdated.length\n      p.log.info(`${n} package${n > 1 ? 's' : ''} ha${n > 1 ? 've' : 's'} new features and/or breaking changes. Run \\`skilld update\\` to sync.`)\n    }\n  },\n})\n\n/** Restore .skilld/pkg symlink to node_modules if broken */\nfunction restorePkgSymlink(skillsDir: string, name: string, info: SkillInfo, cwd: string): void {\n  const refsDir = join(skillsDir, name, '.skilld')\n  const pkgLink = join(refsDir, 'pkg')\n\n  // Only fix if the skill dir exists but the pkg symlink is broken\n  if (!existsSync(join(skillsDir, name)))\n    return\n\n  if (existsSync(pkgLink))\n    return\n\n  const pkgName = info.packageName || name\n  const pkgDir = resolvePkgDir(pkgName, cwd, info.version)\n  if (!pkgDir)\n    return\n\n  mkdirSync(refsDir, { recursive: true })\n  symlinkSync(pkgDir, pkgLink)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAqBA,MAAa,oBAAoB,cAAc;CAC7C,MAAM;EAAE,MAAM;EAAW,aAAa;EAAuE;CAC7G,MAAM,EACJ,OAAO;EACL,MAAM;EACN,SAAS,OAAO,KAAKA,QAAO;EAC5B,OAAO;EACP,aAAa;EACd,EACF;CACD,MAAM,IAAI,EAAE,QAAQ;EAClB,MAAM,MAAM,QAAQ,KAAK;EAEzB,MAAM,QAAQ,aAAa,KAAK,MAAM;AACtC,MAAI,CAAC,SAAS,UAAU,OACtB;EAEF,MAAM,cAAcA,QAAO;EAC3B,MAAM,SAAS,mBAAmB,IAAI;EACtC,MAAM,YAAY,UAAU,KAAK,KAAK,YAAY,UAAU;EAO5D,MAAM,YAHgB,SAClB,CAAC,OAAO,GACR,OAAO,OAAOA,QAAO,CAAC,KAAI,MAAK,KAAK,KAAK,EAAE,UAAU,CAAC,EAEvD,KAAI,QAAO,SAAS,IAAI,CAAC,CACzB,QAAQ,MAAkC,CAAC,CAAC,KAAK,OAAO,KAAK,EAAE,OAAO,CAAC,SAAS,EAAE;AAErF,MAAI,SAAS,SAAS,GAAG;GACvB,MAAM,OAAO,WAAW,SAAS;AAEjC,QAAK,MAAM,CAAC,MAAM,SAAS,OAAO,QAAQ,KAAK,OAAO,EAAE;AACtD,QAAI,CAAC,KAAK,QACR;AAEF,QAAI,KAAK,WAAW,WAAW;AAE7B,SAAI,CAAC,WADY,KAAK,WAAW,KAAK,CACb,EAAE;MAGzB,MAAM,QADU,iBADA,KAAK,eAAe,MACM,KAAK,KAAK,QAAQ,CACtC,MAAK,MAAK,EAAE,cAAc,KAAK;AACrD,UAAI,MACF,kBAAiB,WAAW,MAAM,MAAM,SAAS;;AAErD;;AAIF,sBAAkB,WAAW,MAAM,MAAM,IAAI;;;EAMjD,MAAM,QAAQ,MAAM,gBAAgB,IAAI;EACxC,IAAI,eAAe;AAEnB,MAAI,MAAM,QAAQ,SAAS,GAAG;AAC5B,aAAU,WAAW,EAAE,WAAW,MAAM,CAAC;AAEzC,QAAK,MAAM,SAAS,MAAM,SAAS;IACjC,MAAM,UAAU,MAAM,KAAK,IAAI,MAAM,YAAY,EAAE,QAAQ,cAAc,GAAG,IAAI;AAEhF,SAAK,MAAM,SAAS,MAAM,QAAQ;AAChC,sBAAiB,WAAW,MAAM,WAAW,MAAM,SAAS;AAC5D,eAAU,WAAW,MAAM,WAAW;MACpC,aAAa,MAAM;MACnB;MACA,QAAQ;MACR,2BAAU,IAAI,MAAM,EAAC,aAAa,CAAC,MAAM,IAAI,CAAC;MAC9C,WAAW;MACZ,CAAC;AAEF,SAAI,OACF,mBAAkB,MAAM,WAAW,QAAQ,KAAK,MAAM;AAExD;;;AAIJ,OAAI,eAAe,EACjB,GAAE,IAAI,QAAQ,aAAa,aAAa,gBAAgB,eAAe,IAAI,MAAM,KAAK;;EAM1F,MAAM,aAAa,eAAe,IAAI,MAAM,gBAAgB,IAAI,GAAG;AAEnE,MAAI,WAAW,SAAS,SAAS,GAAG;GAClC,MAAM,IAAI,WAAW,SAAS;AAC9B,KAAE,IAAI,KAAK,GAAG,EAAE,UAAU,IAAI,IAAI,MAAM,GAAG,KAAK,IAAI,IAAI,OAAO,IAAI,uEAAuE;;;CAG/I,CAAC;;AAGF,SAAS,kBAAkB,WAAmB,MAAc,MAAiB,KAAmB;CAC9F,MAAM,UAAU,KAAK,WAAW,MAAM,UAAU;CAChD,MAAM,UAAU,KAAK,SAAS,MAAM;AAGpC,KAAI,CAAC,WAAW,KAAK,WAAW,KAAK,CAAC,CACpC;AAEF,KAAI,WAAW,QAAQ,CACrB;CAGF,MAAM,SAAS,cADC,KAAK,eAAe,MACE,KAAK,KAAK,QAAQ;AACxD,KAAI,CAAC,OACH;AAEF,WAAU,SAAS,EAAE,WAAW,MAAM,CAAC;AACvC,aAAY,QAAQ,QAAQ"}
+{"version":3,"file":"prepare.mjs","names":[],"sources":["../../src/core/prepare.ts"],"sourcesContent":["/**\n * Shared prepare utilities used by both the fast entry (src/prepare.ts)\n * and the full CLI command (src/commands/prepare.ts).\n *\n * Keep this module lightweight: no imports from agent/, cache/storage.ts,\n * or any module that pulls in sanitize/clack/citty.\n */\n\nimport type { SkillInfo } from './lockfile.ts'\nimport { existsSync, lstatSync, mkdirSync, readdirSync, rmSync, symlinkSync, unlinkSync } from 'node:fs'\nimport { join } from 'pathe'\nimport { getCacheDir } from '../cache/version.ts'\n\n/** Resolve package directory: node_modules first, then global cache */\nexport function resolvePkgDir(name: string, cwd: string, version?: string): string | null {\n  const nodeModulesPath = join(cwd, 'node_modules', name)\n  if (existsSync(nodeModulesPath))\n    return nodeModulesPath\n\n  if (version) {\n    const cachedPkgDir = join(getCacheDir(name, version), 'pkg')\n    if (existsSync(join(cachedPkgDir, 'package.json')))\n      return cachedPkgDir\n  }\n\n  return null\n}\n\n/** Restore .skilld/pkg symlink to node_modules if broken */\nexport function restorePkgSymlink(skillsDir: string, name: string, info: SkillInfo, cwd: string): void {\n  const refsDir = join(skillsDir, name, '.skilld')\n  const pkgLink = join(refsDir, 'pkg')\n\n  if (!existsSync(join(skillsDir, name)))\n    return\n\n  if (existsSync(pkgLink))\n    return\n\n  const pkgName = info.packageName || name\n  const pkgDir = resolvePkgDir(pkgName, cwd, info.version)\n  if (!pkgDir)\n    return\n\n  mkdirSync(refsDir, { recursive: true })\n  symlinkSync(pkgDir, pkgLink)\n}\n\nexport interface ShippedSkill {\n  skillName: string\n  skillDir: string\n}\n\n/** Check if package ships a skills/ directory with SKILL.md or _SKILL.md subdirs */\nexport function getShippedSkills(name: string, cwd: string, version?: string): ShippedSkill[] {\n  const pkgPath = resolvePkgDir(name, cwd, version)\n  if (!pkgPath)\n    return []\n\n  const skillsPath = join(pkgPath, 'skills')\n  if (!existsSync(skillsPath))\n    return []\n\n  return readdirSync(skillsPath, { withFileTypes: true })\n    .filter(d => d.isDirectory() && (existsSync(join(skillsPath, d.name, 'SKILL.md')) || existsSync(join(skillsPath, d.name, '_SKILL.md'))))\n    .map(d => ({ skillName: d.name, skillDir: join(skillsPath, d.name) }))\n}\n\n/** Create symlink from skills dir to shipped skill dir */\nexport function linkShippedSkill(baseDir: string, skillName: string, targetDir: string): void {\n  const linkPath = join(baseDir, skillName)\n  if (existsSync(linkPath)) {\n    const stat = lstatSync(linkPath)\n    if (stat.isSymbolicLink())\n      unlinkSync(linkPath)\n    else rmSync(linkPath, { recursive: true, force: true })\n  }\n  symlinkSync(targetDir, linkPath)\n}\n"],"mappings":";;;;;AAcA,SAAgB,cAAc,MAAc,KAAa,SAAiC;CACxF,MAAM,kBAAkB,KAAK,KAAK,gBAAgB,KAAK;AACvD,KAAI,WAAW,gBAAgB,CAC7B,QAAO;AAET,KAAI,SAAS;EACX,MAAM,eAAe,KAAK,YAAY,MAAM,QAAQ,EAAE,MAAM;AAC5D,MAAI,WAAW,KAAK,cAAc,eAAe,CAAC,CAChD,QAAO;;AAGX,QAAO;;;AAIT,SAAgB,kBAAkB,WAAmB,MAAc,MAAiB,KAAmB;CACrG,MAAM,UAAU,KAAK,WAAW,MAAM,UAAU;CAChD,MAAM,UAAU,KAAK,SAAS,MAAM;AAEpC,KAAI,CAAC,WAAW,KAAK,WAAW,KAAK,CAAC,CACpC;AAEF,KAAI,WAAW,QAAQ,CACrB;CAGF,MAAM,SAAS,cADC,KAAK,eAAe,MACE,KAAK,KAAK,QAAQ;AACxD,KAAI,CAAC,OACH;AAEF,WAAU,SAAS,EAAE,WAAW,MAAM,CAAC;AACvC,aAAY,QAAQ,QAAQ;;;AAS9B,SAAgB,iBAAiB,MAAc,KAAa,SAAkC;CAC5F,MAAM,UAAU,cAAc,MAAM,KAAK,QAAQ;AACjD,KAAI,CAAC,QACH,QAAO,EAAE;CAEX,MAAM,aAAa,KAAK,SAAS,SAAS;AAC1C,KAAI,CAAC,WAAW,WAAW,CACzB,QAAO,EAAE;AAEX,QAAO,YAAY,YAAY,EAAE,eAAe,MAAM,CAAC,CACpD,QAAO,MAAK,EAAE,aAAa,KAAK,WAAW,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC,IAAI,WAAW,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC,EAAE,CACvI,KAAI,OAAM;EAAE,WAAW,EAAE;EAAM,UAAU,KAAK,YAAY,EAAE,KAAA;EAAO,EAAE;;;AAI1E,SAAgB,iBAAiB,SAAiB,WAAmB,WAAyB;CAC5F,MAAM,WAAW,KAAK,SAAS,UAAU;AACzC,KAAI,WAAW,SAAS,CAEtB,KADa,UAAU,SAAS,CACvB,gBAAgB,CACvB,YAAW,SAAS;KACjB,QAAO,UAAU;EAAE,WAAW;EAAM,OAAO;EAAM,CAAC;AAEzD,aAAY,WAAW,SAAS"}

package/dist/_chunks/prepare2.mjs

@@ -0,0 +1,94 @@
+import "./agent.mjs";
+import "./config.mjs";
+import "./package-json.mjs";
+import { i as restorePkgSymlink, n as linkShippedSkill, t as getShippedSkills } from "./prepare.mjs";
+import "./sanitize.mjs";
+import "./cache.mjs";
+import "./yaml.mjs";
+import "./markdown.mjs";
+import { n as getSharedSkillsDir } from "./shared.mjs";
+import "./sources.mjs";
+import { a as targets } from "./detect.mjs";
+import { i as linkSkillToAgents } from "./prompts.mjs";
+import { b as resolveAgent } from "./cli-helpers.mjs";
+import { i as readLock, s as writeLock } from "./lockfile.mjs";
+import { t as getProjectState } from "./skills.mjs";
+import { join } from "pathe";
+import { existsSync, mkdirSync } from "node:fs";
+import * as p from "@clack/prompts";
+import { defineCommand } from "citty";
+//#region src/commands/prepare.ts
+/**
+* Prepare command — lightweight hook for package.json "prepare" script.
+*
+* Designed to run on every `pnpm install` / `npm install`. Blocking, fast, no LLM calls.
+* 1. Restore broken symlinks from lockfile (like `install` but skips doc fetching)
+* 2. Auto-install shipped skills from deps (just symlinks + lockfile writes)
+* 3. Report outdated skills count and suggest `skilld update`
+*/
+const prepareCommandDef = defineCommand({
+	meta: {
+		name: "prepare",
+		description: "Restore references and sync shipped skills (for package.json hooks)"
+	},
+	args: { agent: {
+		type: "enum",
+		options: Object.keys(targets),
+		alias: "a",
+		description: "Target agent"
+	} },
+	async run({ args }) {
+		const cwd = process.cwd();
+		const agent = resolveAgent(args.agent);
+		if (!agent || agent === "none") return;
+		const agentConfig = targets[agent];
+		const shared = getSharedSkillsDir(cwd);
+		const skillsDir = shared || join(cwd, agentConfig.skillsDir);
+		const lock = readLock(skillsDir);
+		if (lock && Object.keys(lock.skills).length > 0) {
+			let allIntact = true;
+			for (const [name, info] of Object.entries(lock.skills)) {
+				if (!info.version) continue;
+				if (existsSync(join(skillsDir, name))) {
+					if (info.source !== "shipped") restorePkgSymlink(skillsDir, name, info, cwd);
+					continue;
+				}
+				allIntact = false;
+				if (info.source === "shipped") {
+					const match = getShippedSkills(info.packageName || name, cwd, info.version).find((s) => s.skillName === name);
+					if (match) linkShippedSkill(skillsDir, name, match.skillDir);
+				}
+			}
+			if (allIntact) return;
+		}
+		const state = await getProjectState(cwd);
+		let shippedCount = 0;
+		if (state.shipped.length > 0) {
+			mkdirSync(skillsDir, { recursive: true });
+			for (const entry of state.shipped) {
+				const version = state.deps.get(entry.packageName)?.replace(/^[\^~>=<]+/, "") || "0.0.0";
+				for (const skill of entry.skills) {
+					linkShippedSkill(skillsDir, skill.skillName, skill.skillDir);
+					writeLock(skillsDir, skill.skillName, {
+						packageName: entry.packageName,
+						version,
+						source: "shipped",
+						syncedAt: (/* @__PURE__ */ new Date()).toISOString().split("T")[0],
+						generator: "skilld"
+					});
+					if (shared) linkSkillToAgents(skill.skillName, shared, cwd, agent);
+					shippedCount++;
+				}
+			}
+			if (shippedCount > 0) p.log.success(`Installed ${shippedCount} shipped skill${shippedCount > 1 ? "s" : ""}`);
+		}
+		if (state.outdated.length > 0) {
+			const n = state.outdated.length;
+			p.log.info(`${n} package${n > 1 ? "s" : ""} ha${n > 1 ? "ve" : "s"} new features and/or breaking changes. Run \`skilld update\` to sync.`);
+		}
+	}
+});
+//#endregion
+export { prepareCommandDef };
+
+//# sourceMappingURL=prepare2.mjs.map

package/dist/_chunks/prepare2.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare2.mjs","names":["agents"],"sources":["../../src/commands/prepare.ts"],"sourcesContent":["/**\n * Prepare command — lightweight hook for package.json \"prepare\" script.\n *\n * Designed to run on every `pnpm install` / `npm install`. Blocking, fast, no LLM calls.\n * 1. Restore broken symlinks from lockfile (like `install` but skips doc fetching)\n * 2. Auto-install shipped skills from deps (just symlinks + lockfile writes)\n * 3. Report outdated skills count and suggest `skilld update`\n */\n\nimport { existsSync, mkdirSync } from 'node:fs'\nimport * as p from '@clack/prompts'\nimport { defineCommand } from 'citty'\nimport { join } from 'pathe'\nimport { agents, linkSkillToAgents } from '../agent/index.ts'\nimport { resolveAgent } from '../cli-helpers.ts'\nimport { readLock, writeLock } from '../core/lockfile.ts'\nimport { getShippedSkills, linkShippedSkill, restorePkgSymlink } from '../core/prepare.ts'\nimport { getSharedSkillsDir } from '../core/shared.ts'\nimport { getProjectState } from '../core/skills.ts'\n\nexport const prepareCommandDef = defineCommand({\n  meta: { name: 'prepare', description: 'Restore references and sync shipped skills (for package.json hooks)' },\n  args: {\n    agent: {\n      type: 'enum' as const,\n      options: Object.keys(agents),\n      alias: 'a',\n      description: 'Target agent',\n    },\n  },\n  async run({ args }) {\n    const cwd = process.cwd()\n\n    const agent = resolveAgent(args.agent)\n    if (!agent || agent === 'none')\n      return\n\n    const agentConfig = agents[agent]\n    const shared = getSharedSkillsDir(cwd)\n    const skillsDir = shared || join(cwd, agentConfig.skillsDir)\n\n    // ── Fast path: read primary lockfile, check all skills intact ──\n\n    const lock = readLock(skillsDir)\n    if (lock && Object.keys(lock.skills).length > 0) {\n      let allIntact = true\n\n      for (const [name, info] of Object.entries(lock.skills)) {\n        if (!info.version)\n          continue\n\n        const skillDir = join(skillsDir, name)\n        if (existsSync(skillDir)) {\n          // Skill dir exists; for non-shipped, also check .skilld/pkg symlink\n          if (info.source !== 'shipped')\n            restorePkgSymlink(skillsDir, name, info, cwd)\n          continue\n        }\n\n        // Skill dir missing, needs restore\n        allIntact = false\n\n        if (info.source === 'shipped') {\n          const pkgName = info.packageName || name\n          const shipped = getShippedSkills(pkgName, cwd, info.version)\n          const match = shipped.find(s => s.skillName === name)\n          if (match)\n            linkShippedSkill(skillsDir, name, match.skillDir)\n        }\n      }\n\n      // If all skills intact, skip expensive getProjectState entirely\n      if (allIntact)\n        return\n    }\n\n    // ── Slow path: discover new shipped skills + report outdated ──\n\n    const state = await getProjectState(cwd)\n    let shippedCount = 0\n\n    if (state.shipped.length > 0) {\n      mkdirSync(skillsDir, { recursive: true })\n\n      for (const entry of state.shipped) {\n        const version = state.deps.get(entry.packageName)?.replace(/^[\\^~>=<]+/, '') || '0.0.0'\n\n        for (const skill of entry.skills) {\n          linkShippedSkill(skillsDir, skill.skillName, skill.skillDir)\n          writeLock(skillsDir, skill.skillName, {\n            packageName: entry.packageName,\n            version,\n            source: 'shipped',\n            syncedAt: new Date().toISOString().split('T')[0],\n            generator: 'skilld',\n          })\n\n          if (shared)\n            linkSkillToAgents(skill.skillName, shared, cwd, agent)\n\n          shippedCount++\n        }\n      }\n\n      if (shippedCount > 0)\n        p.log.success(`Installed ${shippedCount} shipped skill${shippedCount > 1 ? 's' : ''}`)\n    }\n\n    if (state.outdated.length > 0) {\n      const n = state.outdated.length\n      p.log.info(`${n} package${n > 1 ? 's' : ''} ha${n > 1 ? 've' : 's'} new features and/or breaking changes. Run \\`skilld update\\` to sync.`)\n    }\n  },\n})\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoBA,MAAa,oBAAoB,cAAc;CAC7C,MAAM;EAAE,MAAM;EAAW,aAAa;EAAuE;CAC7G,MAAM,EACJ,OAAO;EACL,MAAM;EACN,SAAS,OAAO,KAAKA,QAAO;EAC5B,OAAO;EACP,aAAa;EACd,EACF;CACD,MAAM,IAAI,EAAE,QAAQ;EAClB,MAAM,MAAM,QAAQ,KAAK;EAEzB,MAAM,QAAQ,aAAa,KAAK,MAAM;AACtC,MAAI,CAAC,SAAS,UAAU,OACtB;EAEF,MAAM,cAAcA,QAAO;EAC3B,MAAM,SAAS,mBAAmB,IAAI;EACtC,MAAM,YAAY,UAAU,KAAK,KAAK,YAAY,UAAU;EAI5D,MAAM,OAAO,SAAS,UAAU;AAChC,MAAI,QAAQ,OAAO,KAAK,KAAK,OAAO,CAAC,SAAS,GAAG;GAC/C,IAAI,YAAY;AAEhB,QAAK,MAAM,CAAC,MAAM,SAAS,OAAO,QAAQ,KAAK,OAAO,EAAE;AACtD,QAAI,CAAC,KAAK,QACR;AAGF,QAAI,WADa,KAAK,WAAW,KAAK,CACd,EAAE;AAExB,SAAI,KAAK,WAAW,UAClB,mBAAkB,WAAW,MAAM,MAAM,IAAI;AAC/C;;AAIF,gBAAY;AAEZ,QAAI,KAAK,WAAW,WAAW;KAG7B,MAAM,QADU,iBADA,KAAK,eAAe,MACM,KAAK,KAAK,QAAQ,CACtC,MAAK,MAAK,EAAE,cAAc,KAAK;AACrD,SAAI,MACF,kBAAiB,WAAW,MAAM,MAAM,SAAS;;;AAKvD,OAAI,UACF;;EAKJ,MAAM,QAAQ,MAAM,gBAAgB,IAAI;EACxC,IAAI,eAAe;AAEnB,MAAI,MAAM,QAAQ,SAAS,GAAG;AAC5B,aAAU,WAAW,EAAE,WAAW,MAAM,CAAC;AAEzC,QAAK,MAAM,SAAS,MAAM,SAAS;IACjC,MAAM,UAAU,MAAM,KAAK,IAAI,MAAM,YAAY,EAAE,QAAQ,cAAc,GAAG,IAAI;AAEhF,SAAK,MAAM,SAAS,MAAM,QAAQ;AAChC,sBAAiB,WAAW,MAAM,WAAW,MAAM,SAAS;AAC5D,eAAU,WAAW,MAAM,WAAW;MACpC,aAAa,MAAM;MACnB;MACA,QAAQ;MACR,2BAAU,IAAI,MAAM,EAAC,aAAa,CAAC,MAAM,IAAI,CAAC;MAC9C,WAAW;MACZ,CAAC;AAEF,SAAI,OACF,mBAAkB,MAAM,WAAW,QAAQ,KAAK,MAAM;AAExD;;;AAIJ,OAAI,eAAe,EACjB,GAAE,IAAI,QAAQ,aAAa,aAAa,gBAAgB,eAAe,IAAI,MAAM,KAAK;;AAG1F,MAAI,MAAM,SAAS,SAAS,GAAG;GAC7B,MAAM,IAAI,MAAM,SAAS;AACzB,KAAE,IAAI,KAAK,GAAG,EAAE,UAAU,IAAI,IAAI,MAAM,GAAG,KAAK,IAAI,IAAI,OAAO,IAAI,uEAAuE;;;CAG/I,CAAC"}

package/dist/_chunks/retriv.mjs

@@ -0,0 +1,172 @@
+import { a as stripFrontmatter } from "./markdown.mjs";
+//#region src/retriv/index.ts
+var SearchDepsUnavailableError = class extends Error {
+	constructor(cause) {
+		super("Search dependencies unavailable (sqlite-vec or retriv not installed). Search indexing skipped.");
+		this.name = "SearchDepsUnavailableError";
+		this.cause = cause;
+	}
+};
+async function getDb(config) {
+	let createRetriv, autoChunker, sqliteMod, sqliteVec, transformersJs, cachedEmbeddings;
+	try {
+		[{createRetriv}, {autoChunker}, sqliteMod, sqliteVec, {transformersJs}, {cachedEmbeddings}] = await Promise.all([
+			import("retriv"),
+			import("retriv/chunkers/auto"),
+			import("retriv/db/sqlite"),
+			import("sqlite-vec"),
+			import("retriv/embeddings/transformers-js"),
+			import("./embedding-cache.mjs")
+		]);
+	} catch (err) {
+		if (err?.code === "ERR_MODULE_NOT_FOUND") throw new SearchDepsUnavailableError(err);
+		throw err;
+	}
+	const embeddings = await cachedEmbeddings(transformersJs());
+	return createRetriv({
+		driver: sqliteMod.default({
+			path: config.dbPath,
+			embeddings,
+			sqliteVec
+		}),
+		chunking: autoChunker()
+	});
+}
+/**
+* Index documents in-process (no worker thread).
+* Preferred for tests and environments where worker_threads is unreliable.
+*/
+async function createIndexDirect(documents, config) {
+	const db = await getDb(config);
+	if (config.removeIds?.length) await db.remove?.(config.removeIds);
+	await db.index(documents, { onProgress: config.onProgress });
+	await db.close?.();
+}
+/**
+* Index documents in a background worker thread.
+* Falls back to direct indexing if worker fails to spawn.
+*/
+async function createIndex(documents, config) {
+	const { createIndexInWorker } = await import("./pool.mjs");
+	return createIndexInWorker(documents, config);
+}
+/**
+* List all raw document IDs in an existing index.
+* Returns chunk IDs (e.g. "doc-id#chunk-0") for chunked docs.
+* Queries sqlite directly to bypass createRetriv's parent-ID deduplication,
+* so callers can use these IDs for exact removal and parent-ID grouping.
+*/
+async function listIndexIds(config) {
+	const nodeSqlite = globalThis.process?.getBuiltinModule?.("node:sqlite");
+	if (!nodeSqlite) return [];
+	const db = new nodeSqlite.DatabaseSync(config.dbPath, {
+		open: true,
+		readOnly: true
+	});
+	try {
+		return db.prepare("SELECT id FROM documents_meta").all().map((r) => r.id);
+	} finally {
+		db.close();
+	}
+}
+/**
+* Remove documents by ID from an existing index.
+*/
+async function removeFromIndex(ids, config) {
+	if (ids.length === 0) return;
+	const db = await getDb(config);
+	await db.remove?.(ids);
+	await db.close?.();
+}
+async function search(query, config, options = {}) {
+	const { limit = 10, filter } = options;
+	const db = await getDb(config);
+	const results = await db.search(query, {
+		limit,
+		filter,
+		returnContent: true,
+		returnMetadata: true,
+		returnMeta: true
+	});
+	await db.close?.();
+	return results.map((r) => ({
+		id: r.id,
+		content: r.content ?? "",
+		score: r.score,
+		metadata: r.metadata ?? {},
+		highlights: r._meta?.highlights ?? [],
+		lineRange: r._chunk?.lineRange,
+		entities: r._chunk?.entities,
+		scope: r._chunk?.scope
+	}));
+}
+/**
+* Search and return formatted snippets
+*/
+async function searchSnippets(query, config, options = {}) {
+	return toSnippets(await search(query, config, options));
+}
+function toSnippets(results) {
+	return results.map((r) => {
+		const content = stripFrontmatter(r.content);
+		const source = r.metadata.source || r.id;
+		const lines = content.split("\n").length;
+		return {
+			package: r.metadata.package || "unknown",
+			source,
+			lineStart: r.lineRange?.[0] ?? 1,
+			lineEnd: r.lineRange?.[1] ?? lines,
+			content,
+			score: r.score,
+			highlights: r.highlights,
+			entities: r.entities,
+			scope: r.scope
+		};
+	});
+}
+async function openPool(dbPaths) {
+	const pool = /* @__PURE__ */ new Map();
+	await Promise.all(dbPaths.map(async (dbPath) => {
+		const db = await getDb({ dbPath });
+		pool.set(dbPath, db);
+	}));
+	return pool;
+}
+async function searchPooled(query, pool, options = {}) {
+	const { limit = 10, filter } = options;
+	const fetchLimit = limit * 2;
+	const allResults = await Promise.all(Array.from(pool.values(), async (db) => {
+		return (await db.search(query, {
+			limit: fetchLimit,
+			filter,
+			returnContent: true,
+			returnMetadata: true,
+			returnMeta: true
+		})).map((r) => ({
+			id: r.id,
+			content: r.content ?? "",
+			score: r.score,
+			metadata: r.metadata ?? {},
+			highlights: r._meta?.highlights ?? [],
+			lineRange: r._chunk?.lineRange,
+			entities: r._chunk?.entities,
+			scope: r._chunk?.scope
+		}));
+	}));
+	const seen = /* @__PURE__ */ new Set();
+	return toSnippets(allResults.flat().sort((a, b) => b.score - a.score).filter((r) => {
+		const lr = r.lineRange;
+		const key = `${r.metadata.source || r.id}:${lr?.[0]}-${lr?.[1]}`;
+		if (seen.has(key)) return false;
+		seen.add(key);
+		return true;
+	}).slice(0, limit));
+}
+async function closePool(pool) {
+	await Promise.all(Array.from(pool.values(), (db) => db.close?.()));
+	pool.clear();
+}
+//#endregion
+export { getDb as a, removeFromIndex as c, searchSnippets as d, createIndexDirect as i, search as l, closePool as n, listIndexIds as o, createIndex as r, openPool as s, SearchDepsUnavailableError as t, searchPooled as u };
+
+//# sourceMappingURL=retriv.mjs.map

package/dist/_chunks/retriv.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"retriv.mjs","names":[],"sources":["../../src/retriv/index.ts"],"sourcesContent":["import type { ChunkEntity, Document, IndexConfig, IndexPhase, IndexProgress, SearchFilter, SearchOptions, SearchResult, SearchSnippet } from './types.ts'\nimport { stripFrontmatter } from '../core/markdown.ts'\n\nexport type { ChunkEntity, Document, IndexConfig, IndexPhase, IndexProgress, SearchFilter, SearchOptions, SearchResult, SearchSnippet }\n\ntype RetrivInstance = Awaited<ReturnType<typeof getDb>>\n\nexport class SearchDepsUnavailableError extends Error {\n  constructor(cause: unknown) {\n    super('Search dependencies unavailable (sqlite-vec or retriv not installed). Search indexing skipped.')\n    this.name = 'SearchDepsUnavailableError'\n    this.cause = cause\n  }\n}\n\n// Dynamic imports: retriv/chunkers/auto eagerly loads typescript which may not be installed (e.g. npx)\nexport async function getDb(config: Pick<IndexConfig, 'dbPath'>) {\n  let createRetriv, autoChunker, sqliteMod, sqliteVec, transformersJs, cachedEmbeddings\n  try {\n    ;([\n      { createRetriv },\n      { autoChunker },\n      sqliteMod,\n      sqliteVec,\n      { transformersJs },\n      { cachedEmbeddings },\n    ] = await Promise.all([\n      import('retriv'),\n      import('retriv/chunkers/auto'),\n      import('retriv/db/sqlite'),\n      import('sqlite-vec'),\n      import('retriv/embeddings/transformers-js'),\n      import('./embedding-cache.ts'),\n    ]))\n  }\n  catch (err: any) {\n    if (err?.code === 'ERR_MODULE_NOT_FOUND')\n      throw new SearchDepsUnavailableError(err)\n    throw err\n  }\n  const embeddings = await cachedEmbeddings(transformersJs())\n  return createRetriv({\n    driver: sqliteMod.default({\n      path: config.dbPath,\n      embeddings,\n      sqliteVec,\n    }),\n    chunking: autoChunker(),\n  })\n}\n\n/**\n * Index documents in-process (no worker thread).\n * Preferred for tests and environments where worker_threads is unreliable.\n */\nexport async function createIndexDirect(\n  documents: Document[],\n  config: IndexConfig & { removeIds?: string[] },\n): Promise<void> {\n  const db = await getDb(config)\n  if (config.removeIds?.length)\n    await db.remove?.(config.removeIds)\n  await db.index(documents, { onProgress: config.onProgress })\n  await db.close?.()\n}\n\n/**\n * Index documents in a background worker thread.\n * Falls back to direct indexing if worker fails to spawn.\n */\nexport async function createIndex(\n  documents: Document[],\n  config: IndexConfig & { removeIds?: string[] },\n): Promise<void> {\n  // Dynamic import justified: search/searchSnippets shouldn't pull in worker_threads\n  const { createIndexInWorker } = await import('./pool.ts')\n  return createIndexInWorker(documents, config)\n}\n\n/**\n * List all raw document IDs in an existing index.\n * Returns chunk IDs (e.g. \"doc-id#chunk-0\") for chunked docs.\n * Queries sqlite directly to bypass createRetriv's parent-ID deduplication,\n * so callers can use these IDs for exact removal and parent-ID grouping.\n */\nexport async function listIndexIds(\n  config: Pick<IndexConfig, 'dbPath'>,\n): Promise<string[]> {\n  const nodeSqlite = globalThis.process?.getBuiltinModule?.('node:sqlite') as typeof import('node:sqlite') | undefined\n  if (!nodeSqlite)\n    return []\n  const db = new nodeSqlite.DatabaseSync(config.dbPath, { open: true, readOnly: true })\n  try {\n    const rows = db.prepare('SELECT id FROM documents_meta').all() as Array<{ id: string }>\n    return rows.map(r => r.id)\n  }\n  finally {\n    db.close()\n  }\n}\n\n/**\n * Remove documents by ID from an existing index.\n */\nexport async function removeFromIndex(\n  ids: string[],\n  config: Pick<IndexConfig, 'dbPath'>,\n): Promise<void> {\n  if (ids.length === 0)\n    return\n  const db = await getDb(config)\n  await db.remove?.(ids)\n  await db.close?.()\n}\n\nexport async function search(\n  query: string,\n  config: IndexConfig,\n  options: SearchOptions = {},\n): Promise<SearchResult[]> {\n  const { limit = 10, filter } = options\n  const db = await getDb(config)\n  const results = await db.search(query, { limit, filter, returnContent: true, returnMetadata: true, returnMeta: true })\n  await db.close?.()\n\n  return results.map(r => ({\n    id: r.id,\n    content: r.content ?? '',\n    score: r.score,\n    metadata: r.metadata ?? {},\n    highlights: r._meta?.highlights ?? [],\n    lineRange: r._chunk?.lineRange,\n    entities: r._chunk?.entities,\n    scope: r._chunk?.scope,\n  }))\n}\n\n/**\n * Search and return formatted snippets\n */\nexport async function searchSnippets(\n  query: string,\n  config: IndexConfig,\n  options: SearchOptions = {},\n): Promise<SearchSnippet[]> {\n  const results = await search(query, config, options)\n  return toSnippets(results)\n}\n\nfunction toSnippets(results: SearchResult[]): SearchSnippet[] {\n  return results.map((r) => {\n    const content = stripFrontmatter(r.content)\n    const source = r.metadata.source || r.id\n    const lines = content.split('\\n').length\n\n    return {\n      package: r.metadata.package || 'unknown',\n      source,\n      lineStart: r.lineRange?.[0] ?? 1,\n      lineEnd: r.lineRange?.[1] ?? lines,\n      content,\n      score: r.score,\n      highlights: r.highlights,\n      entities: r.entities,\n      scope: r.scope,\n    }\n  })\n}\n\n// ── Pooled DB access for interactive search ──\n\nexport async function openPool(dbPaths: string[]): Promise<Map<string, RetrivInstance>> {\n  const pool = new Map<string, RetrivInstance>()\n  await Promise.all(dbPaths.map(async (dbPath) => {\n    const db = await getDb({ dbPath })\n    pool.set(dbPath, db)\n  }))\n  return pool\n}\n\nexport async function searchPooled(\n  query: string,\n  pool: Map<string, RetrivInstance>,\n  options: SearchOptions = {},\n): Promise<SearchSnippet[]> {\n  const { limit = 10, filter } = options\n  const fetchLimit = limit * 2 // Over-fetch to compensate for dedup\n  const allResults = await Promise.all(\n    Array.from(pool.values(), async (db) => {\n      const results = await db.search(query, { limit: fetchLimit, filter, returnContent: true, returnMetadata: true, returnMeta: true })\n      return results.map(r => ({\n        id: r.id,\n        content: r.content ?? '',\n        score: r.score,\n        metadata: r.metadata ?? {},\n        highlights: r._meta?.highlights ?? [],\n        lineRange: r._chunk?.lineRange as [number, number] | undefined,\n        entities: r._chunk?.entities,\n        scope: r._chunk?.scope,\n      }))\n    }),\n  )\n  // Deduplicate by source+lineRange (overlapping chunks from same doc)\n  const seen = new Set<string>()\n  const merged = allResults.flat()\n    .sort((a, b) => b.score - a.score)\n    .filter((r) => {\n      const lr = r.lineRange\n      const key = `${r.metadata.source || r.id}:${lr?.[0]}-${lr?.[1]}`\n      if (seen.has(key))\n        return false\n      seen.add(key)\n      return true\n    })\n    .slice(0, limit)\n  return toSnippets(merged)\n}\n\nexport async function closePool(pool: Map<string, RetrivInstance>): Promise<void> {\n  await Promise.all(Array.from(pool.values(), db => db.close?.()))\n  pool.clear()\n}\n"],"mappings":"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"}

package/dist/_chunks/search-interactive.mjs

@@ -1,10 +1,12 @@
 import "./agent.mjs";
 import "./config.mjs";
+import "./package-json.mjs";
+import "./prepare.mjs";
 import { n as sanitizeMarkdown } from "./sanitize.mjs";
 import "./cache.mjs";
 import "./yaml.mjs";
 import "./markdown.mjs";
-import { SearchDepsUnavailableError, closePool, openPool, searchPooled } from "../retriv/index.mjs";
+import { n as closePool, s as openPool, t as SearchDepsUnavailableError, u as searchPooled } from "./retriv.mjs";
 import "./shared.mjs";
 import "./sources.mjs";
 import "./detect.mjs";
@@ -13,8 +15,8 @@ import "./cli-helpers.mjs";
 import "./lockfile.mjs";
 import "./skills.mjs";
 import { a as highlightTerms, o as normalizeScores, s as scoreLabel, t as formatCompactSnippet } from "./formatting.mjs";
-import "../cli.mjs";
-import { findPackageDbs, getPackageVersions, listLockPackages, parseFilterPrefix } from "./search.mjs";
+import "./core.mjs";
+import { a as parseFilterPrefix, i as listLockPackages, r as getPackageVersions, t as findPackageDbs } from "./search2.mjs";
 import { createLogUpdate } from "log-update";
 //#region src/commands/search-interactive.ts
 const FILTER_CYCLE = [