skilld 1.5.0 → 1.5.1

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,93 @@
+import "./agent.mjs";
+import "./config.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 { y 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,11 @@
 import "./agent.mjs";
 import "./config.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 +14,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 = [

package/dist/_chunks/search-interactive.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"search-interactive.mjs","names":[],"sources":["../../src/commands/search-interactive.ts"],"sourcesContent":["import type { SearchFilter, SearchSnippet } from '../retriv/index.ts'\nimport { createLogUpdate } from 'log-update'\nimport { formatCompactSnippet, highlightTerms, normalizeScores, sanitizeMarkdown, scoreLabel } from '../core/index.ts'\nimport { closePool, openPool, SearchDepsUnavailableError, searchPooled } from '../retriv/index.ts'\nimport { findPackageDbs, getPackageVersions, listLockPackages, parseFilterPrefix } from './search.ts'\n\nconst FILTER_CYCLE = [undefined, 'docs', 'issues', 'releases'] as const\ntype FilterLabel = typeof FILTER_CYCLE[number]\n\nfunction filterToSearchFilter(label: FilterLabel): SearchFilter | undefined {\n  if (!label)\n    return undefined\n  if (label === 'issues')\n    return { type: 'issue' }\n  if (label === 'releases')\n    return { type: 'release' }\n  return { type: { $in: ['doc', 'docs'] } }\n}\n\nconst SPINNER_FRAMES = ['◐', '◓', '◑', '◒']\n\nexport async function interactiveSearch(packageFilter?: string): Promise<void> {\n  const dbs = findPackageDbs(packageFilter)\n  const versions = getPackageVersions()\n  if (dbs.length === 0) {\n    let msg: string\n    if (packageFilter) {\n      const available = listLockPackages()\n      msg = available.length > 0\n        ? `No docs indexed for \"${packageFilter}\". Available: ${available.join(', ')}`\n        : `No docs indexed for \"${packageFilter}\". Run \\`skilld add ${packageFilter}\\` first.`\n    }\n    else {\n      msg = 'No docs indexed yet. Run `skilld add <package>` first.'\n    }\n    process.stderr.write(`\\x1B[33m${msg}\\x1B[0m\\n`)\n    return\n  }\n\n  const logUpdate = createLogUpdate(process.stderr, { showCursor: true })\n  let pool: Awaited<ReturnType<typeof openPool>>\n  try {\n    pool = await openPool(dbs)\n  }\n  catch (err) {\n    if (err instanceof SearchDepsUnavailableError) {\n      process.stderr.write('\\x1B[31mSearch requires native dependencies (sqlite-vec) that are not installed.\\nInstall skilld globally or in a project to use search: npm i -g skilld\\x1B[0m\\n')\n      return\n    }\n    throw err\n  }\n\n  // State\n  let query = ''\n  let results: SearchSnippet[] = []\n  let selectedIndex = 0\n  let isSearching = false\n  let searchId = 0\n  let filterIndex = 0\n  let error = ''\n  let elapsed = 0\n  let spinFrame = 0\n  let debounceTimer: ReturnType<typeof setTimeout> | null = null\n\n  const cols = process.stdout.columns || 80\n  const maxResults = 7\n  const titleLabel = packageFilter ? `Search ${packageFilter} docs` : 'Search docs'\n\n  function getFilterLabel(): string {\n    const f = FILTER_CYCLE[filterIndex]\n    if (!f)\n      return ''\n    return `\\x1B[36m${f}:\\x1B[0m`\n  }\n\n  function render() {\n    const lines: string[] = []\n\n    // Title\n    lines.push('')\n    lines.push(`  \\x1B[1m${titleLabel}\\x1B[0m`)\n    lines.push('')\n\n    // Input line\n    const filterPrefix = getFilterLabel()\n    const prefix = filterPrefix ? `${filterPrefix}` : ''\n    lines.push(`  \\x1B[36m❯\\x1B[0m ${prefix}${query}\\x1B[7m \\x1B[0m`)\n\n    // Separator / spinner\n    if (isSearching) {\n      const frame = SPINNER_FRAMES[spinFrame % SPINNER_FRAMES.length]\n      lines.push(`  \\x1B[36m${frame}\\x1B[0m \\x1B[90mSearching…\\x1B[0m`)\n    }\n    else {\n      lines.push(`  \\x1B[90m${'─'.repeat(Math.min(cols - 4, 40))}\\x1B[0m`)\n    }\n\n    // Results or empty state\n    if (error) {\n      lines.push('')\n      lines.push(`  \\x1B[31m${error}\\x1B[0m`)\n    }\n    else if (query.length === 0) {\n      lines.push('')\n      lines.push('  \\x1B[90mType to search…\\x1B[0m')\n    }\n    else if (query.length < 2 && !isSearching) {\n      lines.push('')\n      lines.push('  \\x1B[90mKeep typing…\\x1B[0m')\n    }\n    else if (results.length === 0 && !isSearching) {\n      lines.push('')\n      lines.push('  \\x1B[90mNo results\\x1B[0m')\n    }\n    else {\n      lines.push('')\n      const shown = results.slice(0, maxResults)\n      const scores = normalizeScores(results)\n      for (let i = 0; i < shown.length; i++) {\n        const r = shown[i]!\n        const selected = i === selectedIndex\n        const bullet = selected ? '\\x1B[36m●\\x1B[0m' : '\\x1B[90m○\\x1B[0m'\n        const sc = scoreLabel(scores.get(r) ?? 0)\n        const { title, path, preview } = formatCompactSnippet(r, cols)\n        const highlighted = highlightTerms(preview, r.highlights)\n\n        const ver = versions.get(r.package)\n        const pkgLabel = ver ? `${r.package}@${ver}` : r.package\n\n        if (selected) {\n          lines.push(`  ${bullet} \\x1B[1m${pkgLabel}\\x1B[0m ${sc}  \\x1B[36m${title}\\x1B[0m`)\n          lines.push(`    \\x1B[90m${path}\\x1B[0m`)\n          lines.push(`    ${highlighted}`)\n        }\n        else {\n          lines.push(`  ${bullet} \\x1B[90m${pkgLabel}\\x1B[0m ${sc}  \\x1B[90m${title}\\x1B[0m`)\n        }\n      }\n    }\n\n    // Footer\n    lines.push('')\n    const parts: string[] = []\n    if (results.length > 0)\n      parts.push(`${results.length} results`)\n    if (elapsed > 0 && !isSearching)\n      parts.push(`${elapsed.toFixed(2)}s`)\n    const footer = parts.length > 0 ? `${parts.join(' · ')}    ` : ''\n    lines.push(`  \\x1B[90m${footer}↑↓ navigate  ↵ select  tab filter  esc quit\\x1B[0m`)\n    lines.push('')\n\n    logUpdate(lines.join('\\n'))\n  }\n\n  async function doSearch() {\n    const id = ++searchId\n    const fullQuery = query.trim()\n    if (fullQuery.length < 2) {\n      results = []\n      isSearching = false\n      render()\n      return\n    }\n\n    isSearching = true\n    error = ''\n    render()\n\n    // Spin animation\n    const spinInterval = setInterval(() => {\n      spinFrame++\n      if (isSearching)\n        render()\n    }, 80)\n\n    const { query: parsed, filter: parsedFilter } = parseFilterPrefix(fullQuery)\n    const filter = parsedFilter || filterToSearchFilter(FILTER_CYCLE[filterIndex])\n    const start = performance.now()\n\n    const res = await searchPooled(parsed, pool, { limit: maxResults, filter }).catch((e) => {\n      if (id === searchId)\n        error = e instanceof Error ? e.message : String(e)\n      return [] as SearchSnippet[]\n    })\n\n    clearInterval(spinInterval)\n\n    // Discard stale results\n    if (id !== searchId)\n      return\n\n    results = res\n    elapsed = (performance.now() - start) / 1000\n    selectedIndex = 0\n    isSearching = false\n    render()\n  }\n\n  function scheduleSearch() {\n    if (debounceTimer)\n      clearTimeout(debounceTimer)\n    debounceTimer = setTimeout(doSearch, 100)\n  }\n\n  // Show initial state\n  render()\n\n  // Raw stdin for keystroke handling\n  const { stdin } = process\n  if (stdin.isTTY)\n    stdin.setRawMode(true)\n  stdin.resume()\n  stdin.setEncoding('utf-8')\n\n  return new Promise<void>((resolve) => {\n    function cleanup() {\n      if (debounceTimer)\n        clearTimeout(debounceTimer)\n      if (stdin.isTTY)\n        stdin.setRawMode(false)\n      stdin.removeListener('data', onData)\n      stdin.pause()\n      closePool(pool)\n    }\n\n    function exit() {\n      cleanup()\n      logUpdate.done()\n      resolve()\n    }\n\n    function selectResult() {\n      if (results.length === 0 || selectedIndex >= results.length)\n        return\n      const r = results[selectedIndex]!\n      cleanup()\n      logUpdate.done()\n\n      // Print full result\n      const refPath = `.claude/skills/${r.package}/.skilld/${r.source}`\n      const lineRange = r.lineStart === r.lineEnd ? `L${r.lineStart}` : `L${r.lineStart}-${r.lineEnd}`\n      const highlighted = highlightTerms(sanitizeMarkdown(r.content), r.highlights)\n      const rVer = versions.get(r.package)\n      const rLabel = rVer ? `${r.package}@${rVer}` : r.package\n      const rScores = normalizeScores(results)\n      const out = [\n        '',\n        `  \\x1B[1m${rLabel}\\x1B[0m ${scoreLabel(rScores.get(r) ?? 0)}`,\n        `  \\x1B[90m${refPath}:${lineRange}\\x1B[0m`,\n        '',\n        `  ${highlighted.replace(/\\n/g, '\\n  ')}`,\n        '',\n      ].join('\\n')\n      process.stdout.write(`${out}\\n`)\n      resolve()\n    }\n\n    function onData(data: string) {\n      // Ctrl+C\n      if (data === '\\x03') {\n        exit()\n        return\n      }\n\n      // Escape\n      if (data === '\\x1B' || data === '\\x1B\\x1B') {\n        exit()\n        return\n      }\n\n      // Enter\n      if (data === '\\r' || data === '\\n') {\n        selectResult()\n        return\n      }\n\n      // Tab — cycle filter\n      if (data === '\\t') {\n        filterIndex = (filterIndex + 1) % FILTER_CYCLE.length\n        if (query.length >= 2)\n          scheduleSearch()\n        render()\n        return\n      }\n\n      // Backspace\n      if (data === '\\x7F' || data === '\\b') {\n        if (query.length > 0) {\n          query = query.slice(0, -1)\n          scheduleSearch()\n          render()\n        }\n        return\n      }\n\n      // Arrow keys (escape sequences)\n      if (data === '\\x1B[A' || data === '\\x1BOA') {\n        // Up\n        if (selectedIndex > 0) {\n          selectedIndex--\n          render()\n        }\n        return\n      }\n      if (data === '\\x1B[B' || data === '\\x1BOB') {\n        // Down\n        if (selectedIndex < results.length - 1) {\n          selectedIndex++\n          render()\n        }\n        return\n      }\n\n      // Ignore other escape sequences\n      if (data.startsWith('\\x1B'))\n        return\n\n      // Printable characters\n      query += data\n      scheduleSearch()\n      render()\n    }\n\n    stdin.on('data', onData)\n  })\n}\n"],"mappings":"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"}
+{"version":3,"file":"search-interactive.mjs","names":[],"sources":["../../src/commands/search-interactive.ts"],"sourcesContent":["import type { SearchFilter, SearchSnippet } from '../retriv/index.ts'\nimport { createLogUpdate } from 'log-update'\nimport { formatCompactSnippet, highlightTerms, normalizeScores, sanitizeMarkdown, scoreLabel } from '../core/index.ts'\nimport { closePool, openPool, SearchDepsUnavailableError, searchPooled } from '../retriv/index.ts'\nimport { findPackageDbs, getPackageVersions, listLockPackages, parseFilterPrefix } from './search.ts'\n\nconst FILTER_CYCLE = [undefined, 'docs', 'issues', 'releases'] as const\ntype FilterLabel = typeof FILTER_CYCLE[number]\n\nfunction filterToSearchFilter(label: FilterLabel): SearchFilter | undefined {\n  if (!label)\n    return undefined\n  if (label === 'issues')\n    return { type: 'issue' }\n  if (label === 'releases')\n    return { type: 'release' }\n  return { type: { $in: ['doc', 'docs'] } }\n}\n\nconst SPINNER_FRAMES = ['◐', '◓', '◑', '◒']\n\nexport async function interactiveSearch(packageFilter?: string): Promise<void> {\n  const dbs = findPackageDbs(packageFilter)\n  const versions = getPackageVersions()\n  if (dbs.length === 0) {\n    let msg: string\n    if (packageFilter) {\n      const available = listLockPackages()\n      msg = available.length > 0\n        ? `No docs indexed for \"${packageFilter}\". Available: ${available.join(', ')}`\n        : `No docs indexed for \"${packageFilter}\". Run \\`skilld add ${packageFilter}\\` first.`\n    }\n    else {\n      msg = 'No docs indexed yet. Run `skilld add <package>` first.'\n    }\n    process.stderr.write(`\\x1B[33m${msg}\\x1B[0m\\n`)\n    return\n  }\n\n  const logUpdate = createLogUpdate(process.stderr, { showCursor: true })\n  let pool: Awaited<ReturnType<typeof openPool>>\n  try {\n    pool = await openPool(dbs)\n  }\n  catch (err) {\n    if (err instanceof SearchDepsUnavailableError) {\n      process.stderr.write('\\x1B[31mSearch requires native dependencies (sqlite-vec) that are not installed.\\nInstall skilld globally or in a project to use search: npm i -g skilld\\x1B[0m\\n')\n      return\n    }\n    throw err\n  }\n\n  // State\n  let query = ''\n  let results: SearchSnippet[] = []\n  let selectedIndex = 0\n  let isSearching = false\n  let searchId = 0\n  let filterIndex = 0\n  let error = ''\n  let elapsed = 0\n  let spinFrame = 0\n  let debounceTimer: ReturnType<typeof setTimeout> | null = null\n\n  const cols = process.stdout.columns || 80\n  const maxResults = 7\n  const titleLabel = packageFilter ? `Search ${packageFilter} docs` : 'Search docs'\n\n  function getFilterLabel(): string {\n    const f = FILTER_CYCLE[filterIndex]\n    if (!f)\n      return ''\n    return `\\x1B[36m${f}:\\x1B[0m`\n  }\n\n  function render() {\n    const lines: string[] = []\n\n    // Title\n    lines.push('')\n    lines.push(`  \\x1B[1m${titleLabel}\\x1B[0m`)\n    lines.push('')\n\n    // Input line\n    const filterPrefix = getFilterLabel()\n    const prefix = filterPrefix ? `${filterPrefix}` : ''\n    lines.push(`  \\x1B[36m❯\\x1B[0m ${prefix}${query}\\x1B[7m \\x1B[0m`)\n\n    // Separator / spinner\n    if (isSearching) {\n      const frame = SPINNER_FRAMES[spinFrame % SPINNER_FRAMES.length]\n      lines.push(`  \\x1B[36m${frame}\\x1B[0m \\x1B[90mSearching…\\x1B[0m`)\n    }\n    else {\n      lines.push(`  \\x1B[90m${'─'.repeat(Math.min(cols - 4, 40))}\\x1B[0m`)\n    }\n\n    // Results or empty state\n    if (error) {\n      lines.push('')\n      lines.push(`  \\x1B[31m${error}\\x1B[0m`)\n    }\n    else if (query.length === 0) {\n      lines.push('')\n      lines.push('  \\x1B[90mType to search…\\x1B[0m')\n    }\n    else if (query.length < 2 && !isSearching) {\n      lines.push('')\n      lines.push('  \\x1B[90mKeep typing…\\x1B[0m')\n    }\n    else if (results.length === 0 && !isSearching) {\n      lines.push('')\n      lines.push('  \\x1B[90mNo results\\x1B[0m')\n    }\n    else {\n      lines.push('')\n      const shown = results.slice(0, maxResults)\n      const scores = normalizeScores(results)\n      for (let i = 0; i < shown.length; i++) {\n        const r = shown[i]!\n        const selected = i === selectedIndex\n        const bullet = selected ? '\\x1B[36m●\\x1B[0m' : '\\x1B[90m○\\x1B[0m'\n        const sc = scoreLabel(scores.get(r) ?? 0)\n        const { title, path, preview } = formatCompactSnippet(r, cols)\n        const highlighted = highlightTerms(preview, r.highlights)\n\n        const ver = versions.get(r.package)\n        const pkgLabel = ver ? `${r.package}@${ver}` : r.package\n\n        if (selected) {\n          lines.push(`  ${bullet} \\x1B[1m${pkgLabel}\\x1B[0m ${sc}  \\x1B[36m${title}\\x1B[0m`)\n          lines.push(`    \\x1B[90m${path}\\x1B[0m`)\n          lines.push(`    ${highlighted}`)\n        }\n        else {\n          lines.push(`  ${bullet} \\x1B[90m${pkgLabel}\\x1B[0m ${sc}  \\x1B[90m${title}\\x1B[0m`)\n        }\n      }\n    }\n\n    // Footer\n    lines.push('')\n    const parts: string[] = []\n    if (results.length > 0)\n      parts.push(`${results.length} results`)\n    if (elapsed > 0 && !isSearching)\n      parts.push(`${elapsed.toFixed(2)}s`)\n    const footer = parts.length > 0 ? `${parts.join(' · ')}    ` : ''\n    lines.push(`  \\x1B[90m${footer}↑↓ navigate  ↵ select  tab filter  esc quit\\x1B[0m`)\n    lines.push('')\n\n    logUpdate(lines.join('\\n'))\n  }\n\n  async function doSearch() {\n    const id = ++searchId\n    const fullQuery = query.trim()\n    if (fullQuery.length < 2) {\n      results = []\n      isSearching = false\n      render()\n      return\n    }\n\n    isSearching = true\n    error = ''\n    render()\n\n    // Spin animation\n    const spinInterval = setInterval(() => {\n      spinFrame++\n      if (isSearching)\n        render()\n    }, 80)\n\n    const { query: parsed, filter: parsedFilter } = parseFilterPrefix(fullQuery)\n    const filter = parsedFilter || filterToSearchFilter(FILTER_CYCLE[filterIndex])\n    const start = performance.now()\n\n    const res = await searchPooled(parsed, pool, { limit: maxResults, filter }).catch((e) => {\n      if (id === searchId)\n        error = e instanceof Error ? e.message : String(e)\n      return [] as SearchSnippet[]\n    })\n\n    clearInterval(spinInterval)\n\n    // Discard stale results\n    if (id !== searchId)\n      return\n\n    results = res\n    elapsed = (performance.now() - start) / 1000\n    selectedIndex = 0\n    isSearching = false\n    render()\n  }\n\n  function scheduleSearch() {\n    if (debounceTimer)\n      clearTimeout(debounceTimer)\n    debounceTimer = setTimeout(doSearch, 100)\n  }\n\n  // Show initial state\n  render()\n\n  // Raw stdin for keystroke handling\n  const { stdin } = process\n  if (stdin.isTTY)\n    stdin.setRawMode(true)\n  stdin.resume()\n  stdin.setEncoding('utf-8')\n\n  return new Promise<void>((resolve) => {\n    function cleanup() {\n      if (debounceTimer)\n        clearTimeout(debounceTimer)\n      if (stdin.isTTY)\n        stdin.setRawMode(false)\n      stdin.removeListener('data', onData)\n      stdin.pause()\n      closePool(pool)\n    }\n\n    function exit() {\n      cleanup()\n      logUpdate.done()\n      resolve()\n    }\n\n    function selectResult() {\n      if (results.length === 0 || selectedIndex >= results.length)\n        return\n      const r = results[selectedIndex]!\n      cleanup()\n      logUpdate.done()\n\n      // Print full result\n      const refPath = `.claude/skills/${r.package}/.skilld/${r.source}`\n      const lineRange = r.lineStart === r.lineEnd ? `L${r.lineStart}` : `L${r.lineStart}-${r.lineEnd}`\n      const highlighted = highlightTerms(sanitizeMarkdown(r.content), r.highlights)\n      const rVer = versions.get(r.package)\n      const rLabel = rVer ? `${r.package}@${rVer}` : r.package\n      const rScores = normalizeScores(results)\n      const out = [\n        '',\n        `  \\x1B[1m${rLabel}\\x1B[0m ${scoreLabel(rScores.get(r) ?? 0)}`,\n        `  \\x1B[90m${refPath}:${lineRange}\\x1B[0m`,\n        '',\n        `  ${highlighted.replace(/\\n/g, '\\n  ')}`,\n        '',\n      ].join('\\n')\n      process.stdout.write(`${out}\\n`)\n      resolve()\n    }\n\n    function onData(data: string) {\n      // Ctrl+C\n      if (data === '\\x03') {\n        exit()\n        return\n      }\n\n      // Escape\n      if (data === '\\x1B' || data === '\\x1B\\x1B') {\n        exit()\n        return\n      }\n\n      // Enter\n      if (data === '\\r' || data === '\\n') {\n        selectResult()\n        return\n      }\n\n      // Tab — cycle filter\n      if (data === '\\t') {\n        filterIndex = (filterIndex + 1) % FILTER_CYCLE.length\n        if (query.length >= 2)\n          scheduleSearch()\n        render()\n        return\n      }\n\n      // Backspace\n      if (data === '\\x7F' || data === '\\b') {\n        if (query.length > 0) {\n          query = query.slice(0, -1)\n          scheduleSearch()\n          render()\n        }\n        return\n      }\n\n      // Arrow keys (escape sequences)\n      if (data === '\\x1B[A' || data === '\\x1BOA') {\n        // Up\n        if (selectedIndex > 0) {\n          selectedIndex--\n          render()\n        }\n        return\n      }\n      if (data === '\\x1B[B' || data === '\\x1BOB') {\n        // Down\n        if (selectedIndex < results.length - 1) {\n          selectedIndex++\n          render()\n        }\n        return\n      }\n\n      // Ignore other escape sequences\n      if (data.startsWith('\\x1B'))\n        return\n\n      // Printable characters\n      query += data\n      scheduleSearch()\n      render()\n    }\n\n    stdin.on('data', onData)\n  })\n}\n"],"mappings":"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"}