skilld 1.7.4 → 2.0.0

package/dist/_chunks/add.mjs

@@ -0,0 +1,66 @@
+import { n as COMMA_OR_WHITESPACE_RE } from "./regex.mjs";
+import { l as hasCompletedWizard } from "./cache.mjs";
+import { t as autoResolveAgent } from "./agent-prompt.mjs";
+import { t as sharedArgs } from "./args.mjs";
+import { s as parseSkillInput } from "./semver.mjs";
+import { t as runWizard } from "./wizard2.mjs";
+import { t as installSkills } from "./install-many.mjs";
+import { t as exportPortablePrompts } from "./portable.mjs";
+import * as p from "@clack/prompts";
+import { defineCommand } from "citty";
+const addCommandDef = defineCommand({
+	meta: {
+		name: "add",
+		description: "Install skills (npm:<pkg>, crate:<name>, gh:<owner/repo>, @<curator>)"
+	},
+	args: {
+		"package": {
+			type: "positional",
+			description: "Package(s) to sync (space/comma-separated; npm:<pkg>, crate:<name>, or owner/repo)",
+			required: true
+		},
+		"skill": {
+			type: "string",
+			alias: "s",
+			description: "Select specific skills from a git repo (comma-separated)",
+			valueHint: "name"
+		},
+		"allow-unsafe": {
+			type: "boolean",
+			description: "Install skills that fail the upstream audit gate"
+		},
+		...sharedArgs
+	},
+	async run({ args }) {
+		const rawInputs = [...new Set([args.package, ...args._ || []].map((s) => s.trim()).filter(Boolean))];
+		if (args.agent === "none") {
+			const packages = [...new Set(rawInputs.flatMap((s) => s.split(COMMA_OR_WHITESPACE_RE)).map((s) => s.trim()).filter(Boolean))];
+			for (const pkg of packages) await exportPortablePrompts(pkg, {
+				force: args.force,
+				agent: "none"
+			});
+			return;
+		}
+		const agent = autoResolveAgent(args.agent);
+		if (!agent) {
+			p.log.error("No target agent detected.\n  Pass --agent <name> (claude-code, cursor, codex, …) or run `skilld config` to set a default.\n  Use --agent none for portable export.");
+			process.exitCode = 1;
+			return;
+		}
+		if (!hasCompletedWizard()) await runWizard({ agent });
+		await installSkills(rawInputs.map(parseSkillInput), {
+			agent,
+			surface: "cli:add",
+			global: args.global,
+			yes: args.yes,
+			force: args.force,
+			debug: args.debug,
+			model: args.model,
+			skillFilter: args.skill,
+			allowUnsafe: args["allow-unsafe"]
+		});
+	}
+});
+export { addCommandDef };
+
+//# sourceMappingURL=add.mjs.map

package/dist/_chunks/add.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.mjs","names":[],"sources":["../../src/commands/sync/add.ts"],"sourcesContent":["import type { AgentType, OptimizeModel } from '../../agent/index.ts'\nimport * as p from '@clack/prompts'\nimport { defineCommand } from 'citty'\nimport { autoResolveAgent } from '../../cli/agent-prompt.ts'\nimport { sharedArgs } from '../../cli/args.ts'\nimport { hasCompletedWizard } from '../../core/config.ts'\nimport { parseSkillInput } from '../../core/prefix.ts'\nimport { COMMA_OR_WHITESPACE_RE } from '../../core/regex.ts'\nimport { runWizard } from '../wizard.ts'\nimport { installSkills } from './install-many.ts'\nimport { exportPortablePrompts } from './portable.ts'\n\nexport const addCommandDef = defineCommand({\n  meta: { name: 'add', description: 'Install skills (npm:<pkg>, crate:<name>, gh:<owner/repo>, @<curator>)' },\n  args: {\n    'package': {\n      type: 'positional',\n      description: 'Package(s) to sync (space/comma-separated; npm:<pkg>, crate:<name>, or owner/repo)',\n      required: true,\n    },\n    'skill': {\n      type: 'string',\n      alias: 's',\n      description: 'Select specific skills from a git repo (comma-separated)',\n      valueHint: 'name',\n    },\n    'allow-unsafe': {\n      type: 'boolean',\n      description: 'Install skills that fail the upstream audit gate',\n    },\n    ...sharedArgs,\n  },\n  async run({ args }) {\n    const rawInputs = [...new Set(\n      [args.package, ...((args as any)._ || [])]\n        .map((s: string) => s.trim())\n        .filter(Boolean),\n    )]\n\n    // --agent none → portable export (no installed-agent target needed).\n    if (args.agent === 'none') {\n      const packages = [...new Set(rawInputs.flatMap(s => s.split(COMMA_OR_WHITESPACE_RE)).map(s => s.trim()).filter(Boolean))]\n      for (const pkg of packages)\n        await exportPortablePrompts(pkg, { force: args.force, agent: 'none' })\n      return\n    }\n\n    const agent: AgentType | null = autoResolveAgent(args.agent)\n    if (!agent) {\n      p.log.error('No target agent detected.\\n  Pass --agent <name> (claude-code, cursor, codex, …) or run `skilld config` to set a default.\\n  Use --agent none for portable export.')\n      process.exitCode = 1\n      return\n    }\n\n    if (!hasCompletedWizard())\n      await runWizard({ agent })\n\n    const items = rawInputs.map(parseSkillInput)\n    await installSkills(items, {\n      agent,\n      surface: 'cli:add',\n      global: args.global,\n      yes: args.yes,\n      force: args.force,\n      debug: args.debug,\n      model: args.model as OptimizeModel | undefined,\n      skillFilter: args.skill,\n      allowUnsafe: args['allow-unsafe'],\n    })\n  },\n})\n"],"mappings":";;;;;;;;;;AAYA,MAAa,gBAAgB,cAAc;CACzC,MAAM;EAAE,MAAM;EAAO,aAAa;EAAyE;CAC3G,MAAM;EACJ,WAAW;GACT,MAAM;GACN,aAAa;GACb,UAAU;GACX;EACD,SAAS;GACP,MAAM;GACN,OAAO;GACP,aAAa;GACb,WAAW;GACZ;EACD,gBAAgB;GACd,MAAM;GACN,aAAa;GACd;EACD,GAAG;EACJ;CACD,MAAM,IAAI,EAAE,QAAQ;EAClB,MAAM,YAAY,CAAC,GAAG,IAAI,IACxB,CAAC,KAAK,SAAS,GAAK,KAAa,KAAK,EAAE,CAAE,CACvC,KAAK,MAAc,EAAE,MAAM,CAAC,CAC5B,OAAO,QAAQ,CACnB,CAAC;EAGF,IAAI,KAAK,UAAU,QAAQ;GACzB,MAAM,WAAW,CAAC,GAAG,IAAI,IAAI,UAAU,SAAQ,MAAK,EAAE,MAAM,uBAAuB,CAAC,CAAC,KAAI,MAAK,EAAE,MAAM,CAAC,CAAC,OAAO,QAAQ,CAAC,CAAC;GACzH,KAAK,MAAM,OAAO,UAChB,MAAM,sBAAsB,KAAK;IAAE,OAAO,KAAK;IAAO,OAAO;IAAQ,CAAC;GACxE;;EAGF,MAAM,QAA0B,iBAAiB,KAAK,MAAM;EAC5D,IAAI,CAAC,OAAO;GACV,EAAE,IAAI,MAAM,qKAAqK;GACjL,QAAQ,WAAW;GACnB;;EAGF,IAAI,CAAC,oBAAoB,EACvB,MAAM,UAAU,EAAE,OAAO,CAAC;EAG5B,MAAM,cADQ,UAAU,IAAI,gBACH,EAAE;GACzB;GACA,SAAS;GACT,QAAQ,KAAK;GACb,KAAK,KAAK;GACV,OAAO,KAAK;GACZ,OAAO,KAAK;GACZ,OAAO,KAAK;GACZ,aAAa,KAAK;GAClB,aAAa,KAAK;GACnB,CAAC;;CAEL,CAAC"}

package/dist/_chunks/agent-prompt.mjs

@@ -0,0 +1,88 @@
+import { a as targets, n as detectProjectAgents, r as detectTargetAgent, t as detectInstalledAgents } from "./detect.mjs";
+import "./agent.mjs";
+import { d as readConfig, m as updateConfig } from "./cache.mjs";
+import { t as isInteractive } from "./env.mjs";
+import { styleText } from "node:util";
+import * as p from "@clack/prompts";
+function resolveAgent(agentFlag) {
+	if (process.env.SKILLD_NO_AGENT) return null;
+	return agentFlag ?? detectTargetAgent() ?? readConfig().agent ?? null;
+}
+function autoResolveAgent(agentFlag) {
+	const resolved = resolveAgent(agentFlag);
+	if (resolved && resolved !== "none") return resolved;
+	if (process.env.SKILLD_NO_AGENT) return null;
+	const projectMatches = detectProjectAgents();
+	if (projectMatches.length === 1) return projectMatches[0];
+	const installed = detectInstalledAgents();
+	if (installed.length === 1) return installed[0];
+	return null;
+}
+let _warnedNoAgent = false;
+function warnNoAgent() {
+	if (_warnedNoAgent) return;
+	_warnedNoAgent = true;
+	p.log.warn("No target agent detected — falling back to prompt-only mode.\n  Use --agent <name> to specify, or run `skilld config` to set a default.");
+}
+async function promptForAgent() {
+	const noAgent = !!process.env.SKILLD_NO_AGENT;
+	const installed = noAgent ? [] : detectInstalledAgents();
+	const projectMatches = noAgent ? [] : detectProjectAgents();
+	if (!isInteractive()) {
+		if (installed.length === 1) {
+			updateConfig({ agent: installed[0] });
+			return installed[0];
+		}
+		warnNoAgent();
+		return "none";
+	}
+	p.log.info("Skilld generates reference cards from package docs so your AI agent\n  always has accurate APIs for your exact dependency versions.");
+	const candidateIds = projectMatches.length > 0 ? projectMatches : installed.length > 0 ? installed : Object.keys(targets);
+	const sharedAgents = new Set(Object.entries(targets).filter(([, a]) => a.additionalSkillsDirs.some((d) => d.includes(".claude/skills"))).map(([id]) => id));
+	const sharedIds = candidateIds.filter((id) => id === "claude-code" || sharedAgents.has(id));
+	const isolatedIds = candidateIds.filter((id) => id !== "claude-code" && !sharedAgents.has(id));
+	const options = [];
+	if (sharedIds.length > 0 && isolatedIds.length > 0) for (const id of sharedIds) {
+		const a = targets[id];
+		const hint = id === "claude-code" ? `skills shared with ${sharedIds.length - 1} other agents` : `skills shared with Claude Code and others`;
+		options.push({
+			label: a.displayName,
+			value: id,
+			hint
+		});
+	}
+	const isolatedAgentIds = new Set(Object.entries(targets).filter(([, a]) => a.additionalSkillsDirs.length === 0).map(([id]) => id));
+	for (const id of sharedIds.length > 0 && isolatedIds.length > 0 ? isolatedIds : candidateIds) {
+		if (options.some((o) => o.value === id)) continue;
+		const a = targets[id];
+		const hint = sharedAgents.has(id) && id !== "claude-code" ? "skills shared with Claude Code and others" : isolatedAgentIds.has(id) ? "skills only visible to this agent" : void 0;
+		options.push({
+			label: a.displayName,
+			value: id,
+			hint
+		});
+	}
+	options.push({
+		label: "No agent",
+		value: "none",
+		hint: "export as standalone files for any AI"
+	});
+	if (!_warnedNoAgent) {
+		_warnedNoAgent = true;
+		const hint = projectMatches.length > 1 ? `Multiple agent directories found: ${projectMatches.map((t) => targets[t].displayName).join(", ")}` : installed.length > 0 ? `Found ${installed.map((t) => targets[t].displayName).join(", ")} but couldn't determine which to use` : "No agents auto-detected";
+		const crossNote = sharedIds.length > 1 ? `\n  ${styleText("gray", `Tip: Picking Claude Code shares skills with ${sharedIds.filter((id) => id !== "claude-code").map((id) => targets[id].displayName).join(", ")} automatically.`)}` : "";
+		p.log.warn(`${hint}\n  Pick the agent you actively code with.${crossNote}`);
+	}
+	const choice = await p.select({
+		message: "Which AI coding agent do you use?",
+		options
+	});
+	if (p.isCancel(choice)) return null;
+	if (choice === "none") return "none";
+	updateConfig({ agent: choice });
+	p.log.success(`Target agent set to ${targets[choice].displayName}`);
+	return choice;
+}
+export { promptForAgent as n, resolveAgent as r, autoResolveAgent as t };
+
+//# sourceMappingURL=agent-prompt.mjs.map

package/dist/_chunks/agent-prompt.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-prompt.mjs","names":["agents"],"sources":["../../src/cli/agent-prompt.ts"],"sourcesContent":["import type { AgentType } from '../agent/index.ts'\nimport { styleText } from 'node:util'\nimport * as p from '@clack/prompts'\nimport { agents, detectInstalledAgents, detectProjectAgents, detectTargetAgent } from '../agent/index.ts'\nimport { readConfig, updateConfig } from '../core/config.ts'\nimport { isInteractive } from './env.ts'\n\nexport function resolveAgent(agentFlag?: string): AgentType | 'none' | null {\n  if (process.env.SKILLD_NO_AGENT)\n    return null\n  return (agentFlag as AgentType | undefined)\n    ?? detectTargetAgent()\n    ?? (readConfig().agent as AgentType | undefined)\n    ?? null\n}\n\n/**\n * Auto-resolve target agent without prompting. Consults, in order:\n *   1. Explicit `--agent` flag.\n *   2. Env-detected target (`CLAUDE_CODE`, `CURSOR_SESSION`, etc).\n *   3. Saved config default.\n *   4. Project marker dirs (`.claude/skills`, `.cursor/`, …) when exactly one\n *      agent matches the cwd.\n *   5. Installed agents on the machine when exactly one is found.\n *\n * Returns `null` when nothing is determined. Callers should error with a clear\n * \"pass --agent <name>\" hint rather than prompting — keeps commands\n * scriptable.\n */\nexport function autoResolveAgent(agentFlag?: string): AgentType | null {\n  const resolved = resolveAgent(agentFlag)\n  if (resolved && resolved !== 'none')\n    return resolved\n\n  if (process.env.SKILLD_NO_AGENT)\n    return null\n\n  const projectMatches = detectProjectAgents()\n  if (projectMatches.length === 1)\n    return projectMatches[0]!\n\n  const installed = detectInstalledAgents()\n  if (installed.length === 1)\n    return installed[0]!\n\n  return null\n}\n\nexport function listKnownAgents(): AgentType[] {\n  return Object.keys(agents) as AgentType[]\n}\n\nlet _warnedNoAgent = false\nfunction warnNoAgent(): void {\n  if (_warnedNoAgent)\n    return\n  _warnedNoAgent = true\n  p.log.warn('No target agent detected — falling back to prompt-only mode.\\n  Use --agent <name> to specify, or run `skilld config` to set a default.')\n}\n\nexport async function promptForAgent(): Promise<AgentType | 'none' | null> {\n  const noAgent = !!process.env.SKILLD_NO_AGENT\n  const installed = noAgent ? [] : detectInstalledAgents()\n  const projectMatches = noAgent ? [] : detectProjectAgents()\n\n  if (!isInteractive()) {\n    if (installed.length === 1) {\n      updateConfig({ agent: installed[0] })\n      return installed[0]!\n    }\n    warnNoAgent()\n    return 'none'\n  }\n\n  p.log.info(\n    `Skilld generates reference cards from package docs so your AI agent\\n`\n    + `  always has accurate APIs for your exact dependency versions.`,\n  )\n\n  const candidateIds = projectMatches.length > 0\n    ? projectMatches\n    : installed.length > 0\n      ? installed\n      : Object.keys(agents) as AgentType[]\n\n  const sharedAgents = new Set(\n    Object.entries(agents)\n      .filter(([, a]) => a.additionalSkillsDirs.some(d => d.includes('.claude/skills')))\n      .map(([id]) => id),\n  )\n\n  const sharedIds = candidateIds.filter(id => id === 'claude-code' || sharedAgents.has(id))\n  const isolatedIds = candidateIds.filter(id => id !== 'claude-code' && !sharedAgents.has(id))\n\n  const options: Array<{ label: string, value: AgentType | 'none', hint?: string }> = []\n\n  if (sharedIds.length > 0 && isolatedIds.length > 0) {\n    for (const id of sharedIds) {\n      const a = agents[id]\n      const hint = id === 'claude-code'\n        ? `skills shared with ${sharedIds.length - 1} other agents`\n        : `skills shared with Claude Code and others`\n      options.push({ label: a.displayName, value: id as AgentType, hint })\n    }\n  }\n\n  const isolatedAgentIds = new Set(\n    Object.entries(agents)\n      .filter(([, a]) => a.additionalSkillsDirs.length === 0)\n      .map(([id]) => id),\n  )\n\n  for (const id of (sharedIds.length > 0 && isolatedIds.length > 0 ? isolatedIds : candidateIds)) {\n    if (options.some(o => o.value === id))\n      continue\n    const a = agents[id]\n    const hint = sharedAgents.has(id) && id !== 'claude-code'\n      ? 'skills shared with Claude Code and others'\n      : isolatedAgentIds.has(id)\n        ? 'skills only visible to this agent'\n        : undefined\n    options.push({ label: a.displayName, value: id as AgentType, hint })\n  }\n\n  options.push({ label: 'No agent', value: 'none', hint: 'export as standalone files for any AI' })\n\n  if (!_warnedNoAgent) {\n    _warnedNoAgent = true\n    const hint = projectMatches.length > 1\n      ? `Multiple agent directories found: ${projectMatches.map(t => agents[t].displayName).join(', ')}`\n      : installed.length > 0\n        ? `Found ${installed.map(t => agents[t].displayName).join(', ')} but couldn't determine which to use`\n        : 'No agents auto-detected'\n    const crossNote = sharedIds.length > 1\n      ? `\\n  ${styleText('gray', `Tip: Picking Claude Code shares skills with ${sharedIds.filter(id => id !== 'claude-code').map(id => agents[id].displayName).join(', ')} automatically.`)}`\n      : ''\n    p.log.warn(`${hint}\\n  Pick the agent you actively code with.${crossNote}`)\n  }\n\n  const choice = await p.select({\n    message: 'Which AI coding agent do you use?',\n    options,\n  })\n\n  if (p.isCancel(choice))\n    return null\n\n  if (choice === 'none')\n    return 'none'\n\n  updateConfig({ agent: choice })\n  p.log.success(`Target agent set to ${agents[choice].displayName}`)\n  return choice\n}\n"],"mappings":";;;;;;AAOA,SAAgB,aAAa,WAA+C;CAC1E,IAAI,QAAQ,IAAI,iBACd,OAAO;CACT,OAAQ,aACH,mBAAmB,IAClB,YAAY,CAAC,SACd;;;;;;;;;;;;;;CAgBP,IAAA,gBAAgB;CACd,iBAAiB;CACjB,EAAA,IAAI,KAAA,0IACK;;eAKH,iBAAiB;CACvB,MAAI,UAAA,CAAA,CAAA,QAAe,IAAW;CAG9B,MAAM,YAAY,UAAA,EAAA,GAAA,uBAAuB;CACzC,MAAI,iBAAU,UACZ,EAAO,GAAA,qBAAU;CAEnB,IAAA,CAAA,eAAO,EAAA;;GAOT,aAAI,EAAA,OAAiB,UAAA,IAAA,CAAA;GACrB,OAAS,UAAA;;EAGP,aAAA;EACA,OAAM;;CAGR,EAAA,IAAA,KAAA,sIAA2E;CACzE,MAAM,eAAY,eAAY,SAAA,IAAA,iBAAA,UAAA,SAAA,IAAA,YAAA,OAAA,KAAA,QAAA;CAC9B,MAAM,eAAY,IAAA,IAAU,OAAK,QAAA,QAAA,CAAA,QAAuB,GAAA,OAAA,EAAA,qBAAA,MAAA,MAAA,EAAA,SAAA,iBAAA,CAAA,CAAA,CAAA,KAAA,CAAA,QAAA,GAAA,CAAA;CACxD,MAAM,YAAA,aAAiB,QAAe,OAAA,OAAA,iBAAqB,aAAA,IAAA,GAAA,CAAA;CAE3D,MAAK,cAAe,aAAE,QAAA,OAAA,OAAA,iBAAA,CAAA,aAAA,IAAA,GAAA,CAAA;OAChB,UAAU,EAAA;KACZ,UAAA,SAAe,KAAO,YAAe,SAAA,GAAA,KAAA,MAAA,MAAA,WAAA;QACrC,IAAO,QAAU;;EAEnB,QAAA,KAAa;GACb,OAAO,EAAA;;GAGP;GAKF,CAAA;;CAYA,MAAM,mBAAY,IAAA,IAAa,OAAO,QAAM,QAAO,CAAA,QAAA,GAAA,OAAiB,EAAA,qBAAqB,WAAA,EAAA,CAAA,KAAA,CAAA,QAAA,GAAA,CAAA;CACzF,KAAA,MAAM,MAAA,UAAc,SAAa,KAAO,YAAM,SAAO,IAAA,cAAkB,cAAqB;EAE5F,IAAA,QAAM,MAAgF,MAAA,EAAA,UAAA,GAAA,EAAA;EAEtF,MAAI,IAAA,QAAU;EAEV,MAAM,OAAIA,aAAO,IAAA,GAAA,IAAA,OAAA,gBAAA,8CAAA,iBAAA,IAAA,GAAA,GAAA,sCAAA,KAAA;EACjB,QAAM,KAAO;GAGb,OAAQ,EAAA;GAAO,OAAO;GAAe;GAAwB,CAAA;;;EAIjE,OAAM;EAMN,OAAK;EACH,MAAI;EAEJ,CAAA;KACA,CAAA,gBAAa;EAKb,iBAAa;QAAE,OAAS,eAAA,SAAA,IAAA,qCAAA,eAAA,KAAA,MAAA,QAAA,GAAA,YAAA,CAAA,KAAA,KAAA,KAAA,UAAA,SAAA,IAAA,SAAA,UAAA,KAAA,MAAA,QAAA,GAAA,YAAA,CAAA,KAAA,KAAA,CAAA,wCAAA;QAAa,YAAO,UAAA,SAAA,IAAA,OAAA,UAAA,QAAA,+CAAA,UAAA,QAAA,OAAA,OAAA,cAAA,CAAA,KAAA,OAAA,QAAA,IAAA,YAAA,CAAA,KAAA,KAAA,CAAA,iBAAA,KAAA;IAAiB,IAAA,KAAA,GAAA,KAAA,4CAAA,YAAA;;;EAG/D,SAAQ;EAAO;EAAmB,CAAA;KAAe,EAAA,SAAM,OAAA,EAAA,OAAA;KAA0C,WAAA,QAAA,OAAA;CAEjG,aAAK,EAAA,OAAgB,QAAA,CAAA;GACnB,IAAA,QAAA,uBAAiB,QAAA,QAAA,cAAA;QACX"}

package/dist/_chunks/agent.mjs

@@ -1,28 +1,30 @@
-import { a as PI_AI_AUTH_PATH, h as skillLogDir, p as skillInternalDir, r as LLM_CACHE_DIR, t as CACHE_DIR } from "./paths.mjs";
-import { E as getSkillReferenceDirs, t as createReferenceCache } from "./cache.mjs";
-import { n as sanitizeMarkdown } from "./sanitize.mjs";
 import { a as targets, t as detectInstalledAgents } from "./detect.mjs";
-import { E as SECTION_OUTPUT_FILES, S as getSectionValidator, T as SECTION_MERGE_ORDER, k as resolveSkilldCommand, w as wrapSection, y as buildAllSectionPrompts } from "./prompts.mjs";
+import { A as resolveSkilldCommand, C as SECTION_OUTPUT_FILES, S as SECTION_MERGE_ORDER, _ as buildAllSectionPrompts, x as wrapSection, y as getSectionValidator } from "./prompts.mjs";
+import { g as skillLogDir, i as LLM_CACHE_DIR, m as skillInternalDir, n as CACHE_DIR, o as PI_AI_AUTH_PATH } from "./paths.mjs";
+import { d as SECTION_HEADING_RE, m as TRAILING_SLASH_RE, p as SOURCE_LINK_RE, t as API_CHANGE_BULLET_RE } from "./regex.mjs";
+import { n as sanitizeMarkdown } from "./sanitize.mjs";
+import { n as getSkillReferenceDirs, t as createReferenceCache } from "./cache.mjs";
 import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from "node:fs";
-import { homedir } from "node:os";
+import { promisify, styleText } from "node:util";
 import { join } from "pathe";
 import { exec, execFileSync, spawn } from "node:child_process";
-import { glob } from "tinyglobby";
-import { findDynamicImports, findStaticImports } from "mlly";
-import { promisify } from "node:util";
 import { isWindows } from "std-env";
-import { getEnvApiKey, getEnvApiKey as getEnvApiKey$1, getModel, getModels, getProviders, streamSimple } from "@mariozechner/pi-ai";
-import { getOAuthApiKey, getOAuthProvider, getOAuthProviders } from "@mariozechner/pi-ai/oauth";
+import { homedir } from "node:os";
+import { getEnvApiKey, getEnvApiKey as getEnvApiKey$1, getModel, getModels, getProviders, streamSimple } from "@earendil-works/pi-ai";
+import { getOAuthApiKey, getOAuthProvider, getOAuthProviders } from "@earendil-works/pi-ai/oauth";
 import { resolve as resolve$1 } from "node:path";
 import { Type } from "typebox";
-import { readFile } from "node:fs/promises";
+import { glob, readFile } from "node:fs/promises";
 import { parseSync } from "oxc-parser";
 import { setTimeout as setTimeout$1 } from "node:timers/promises";
 import { createHash } from "node:crypto";
+const STATIC_REGEX_1$6 = /-\d{8}$/;
+const STATIC_REGEX_2$5 = /-\d{4}-\d{2}-\d{2}$/;
+const STATIC_REGEX_3$3 = /-preview/;
 function isStableId(id) {
-	if (/-\d{8}$/.test(id)) return false;
-	if (/-\d{4}-\d{2}-\d{2}$/.test(id)) return false;
-	if (/-preview/.test(id)) return false;
+	if (STATIC_REGEX_1$6.test(id)) return false;
+	if (STATIC_REGEX_2$5.test(id)) return false;
+	if (STATIC_REGEX_3$3.test(id)) return false;
 	return true;
 }
 function compareVersions(a, b) {
@@ -120,7 +122,9 @@ function extractToolHint(input) {
 		if (typeof v === "string" && v) return v;
 	}
 }
-const stripClaude = (n) => n.replace(/^Claude\s+/, "").replace(/\s*\(latest\)\s*$/i, "");
+const STATIC_REGEX_1$5 = /^Claude\s+/;
+const STATIC_REGEX_2$4 = /\s*\(latest\)\s*$/i;
+const stripClaude = (n) => n.replace(STATIC_REGEX_1$5, "").replace(STATIC_REGEX_2$4, "");
 function buildArgs$2(model, skillDir, symlinkDirs) {
 	return [
 		"-p",
@@ -218,6 +222,7 @@ const adapter$2 = {
 	buildArgs: buildArgs$2,
 	parseEvent: parseEvent$2
 };
+const STATIC_REGEX_1$4 = /^cat\s*>|>/;
 function buildArgs$1(model, _skillDir, _symlinkDirs) {
 	return [
 		"exec",
@@ -240,7 +245,7 @@ function parseEvent$1(line) {
 			};
 			if (item.type === "command_execution" && item.aggregated_output) {
 				const cmd = item.command || "";
-				const writeContent = /^cat\s*>|>/.test(cmd) ? item.aggregated_output : void 0;
+				const writeContent = STATIC_REGEX_1$4.test(cmd) ? item.aggregated_output : void 0;
 				return {
 					kind: "tool-call",
 					tool: "Bash",
@@ -546,6 +551,10 @@ function getAvailablePiAiModels() {
 	}
 	return available;
 }
+const STATIC_REGEX_1$3 = /^\.\/\.skilld\//;
+const STATIC_REGEX_2$3 = /^\.skilld\//;
+const STATIC_REGEX_3$2 = /^\.\//;
+const STATIC_REGEX_5$2 = /\s+/;
 const TOOLS = [
 	{
 		name: "Read",
@@ -582,7 +591,7 @@ const SAFE_COMMANDS = new Set([
 ]);
 const SHELL_META_RE = /[;&|`$()<>]/;
 function resolveSandboxedPath(p, skilldDir) {
-	const resolved = resolve$1(skilldDir, String(p).replace(/^\.\/\.skilld\//, "./").replace(/^\.skilld\//, "./").replace(/^\.\//, ""));
+	const resolved = resolve$1(skilldDir, String(p).replace(STATIC_REGEX_1$3, "./").replace(STATIC_REGEX_2$3, "./").replace(STATIC_REGEX_3$2, ""));
 	if (!resolved.startsWith(`${skilldDir}/`) && resolved !== skilldDir) throw new Error(`Path traversal blocked: ${p}`);
 	return resolved;
 }
@@ -638,7 +647,7 @@ function executeTool(toolCall, skilldDir) {
 			return sanitizeMarkdown(readFileSync(filePath, "utf-8"));
 		}
 		case "Glob": {
-			const pattern = String(args.pattern).replace(/^\.\/\.skilld\//, "./").replace(/^\.skilld\//, "./").replace(/^\.\//, "");
+			const pattern = String(args.pattern).replace(STATIC_REGEX_1$3, "./").replace(STATIC_REGEX_2$3, "./").replace(STATIC_REGEX_3$2, "");
 			const results = [];
 			const walkDir = (dir, prefix) => {
 				if (!existsSync(dir)) return;
@@ -648,9 +657,9 @@ function executeTool(toolCall, skilldDir) {
 					else results.push(`./.skilld/${relPath}`);
 				}
 			};
-			const baseDir = pattern.split("*")[0]?.replace(/\/$/, "") ?? "";
+			const baseDir = pattern.split("*")[0]?.replace(TRAILING_SLASH_RE, "") ?? "";
 			walkDir(join(skilldDir, baseDir), baseDir);
-			const matched = results.filter((r) => globMatch(r.replace(/^\.\/\.skilld\//, ""), pattern));
+			const matched = results.filter((r) => globMatch(r.replace(STATIC_REGEX_1$3, ""), pattern));
 			return matched.length > 0 ? matched.join("\n") : `No files matching: ${args.pattern}`;
 		}
 		case "Write":
@@ -658,7 +667,7 @@ function executeTool(toolCall, skilldDir) {
 			return "File written successfully.";
 		case "Bash": {
 			const cmd = String(args.command).trim();
-			const parts = cmd.split(/\s+/);
+			const parts = cmd.split(STATIC_REGEX_5$2);
 			const bin = parts[0] ?? "";
 			if (!SAFE_COMMANDS.has(bin) || SHELL_META_RE.test(cmd)) return `Error: command not allowed. Only skilld, ls, cat, find commands are permitted.`;
 			try {
@@ -789,24 +798,31 @@ async function optimizeSectionPiAi(opts) {
 		cost: totalCost
 	};
 }
+const STATIC_REGEX_1$2 = /^```(?:markdown|md)?[^\S\n]*\n([\s\S]+)\n```[^\S\n]*$/;
+const STATIC_REGEX_2$2 = /^```(?:markdown|md)/;
+const STATIC_REGEX_5$1 = /^-{3,}\n/;
+const STATIC_REGEX_6 = /\n-{3,}/;
+const STATIC_REGEX_7 = /^(##\s|- (?:BREAKING|DEPRECATED|NEW): )/m;
+const STATIC_REGEX_8 = /^(## .+)\n/;
+const STATIC_REGEX_9 = /^\.\/(?:\.skilld\/|references\/)/;
 function cleanSectionOutput(content) {
 	let cleaned = content.trim();
-	const wrapMatch = cleaned.match(/^```(?:markdown|md)?[^\S\n]*\n([\s\S]+)\n```[^\S\n]*$/);
+	const wrapMatch = cleaned.match(STATIC_REGEX_1$2);
 	if (wrapMatch) {
 		const inner = wrapMatch[1].trim();
-		if (/^```(?:markdown|md)/.test(cleaned) || /^##\s/m.test(inner) || /^- (?:BREAKING|DEPRECATED|NEW): /m.test(inner)) cleaned = inner;
+		if (STATIC_REGEX_2$2.test(cleaned) || SECTION_HEADING_RE.test(inner) || API_CHANGE_BULLET_RE.test(inner)) cleaned = inner;
 	}
 	cleaned = cleaned.replace(/^# (?!#)/gm, "## ");
-	const fmMatch = cleaned.match(/^-{3,}\n/);
+	const fmMatch = cleaned.match(STATIC_REGEX_5$1);
 	if (fmMatch) {
 		const afterOpen = fmMatch[0].length;
-		const closeMatch = cleaned.slice(afterOpen).match(/\n-{3,}/);
+		const closeMatch = cleaned.slice(afterOpen).match(STATIC_REGEX_6);
 		if (closeMatch) cleaned = cleaned.slice(afterOpen + closeMatch.index + closeMatch[0].length).trim();
 		else cleaned = cleaned.slice(afterOpen).trim();
 	}
-	const firstMarker = cleaned.match(/^(##\s|- (?:BREAKING|DEPRECATED|NEW): )/m);
+	const firstMarker = cleaned.match(STATIC_REGEX_7);
 	if (firstMarker?.index && firstMarker.index > 0) cleaned = cleaned.slice(firstMarker.index).trim();
-	const headingMatch = cleaned.match(/^(## .+)\n/);
+	const headingMatch = cleaned.match(STATIC_REGEX_8);
 	if (headingMatch) {
 		const heading = headingMatch[1];
 		const afterFirst = headingMatch[0].length;
@@ -816,14 +832,17 @@ function cleanSectionOutput(content) {
 		}
 	}
 	cleaned = cleaned.replace(/\(?\[`?\.\/(?:\.skilld\/|references\/)[^)\]]*\]\(([^)]+)\)\)?/g, (match, url) => {
-		if (/^\.\/(?:\.skilld\/|references\/)/.test(url)) return `[source](${url})`;
+		if (STATIC_REGEX_9.test(url)) return `[source](${url})`;
 		return match;
 	});
 	cleaned = cleaned.replace(/\[source\]\(\.\/((docs|issues|discussions|releases|pkg|guide)\/)/g, "[source](./.skilld/$1");
 	cleaned = sanitizeMarkdown(cleaned);
-	if (!/^##\s/m.test(cleaned) && !/^- (?:BREAKING|DEPRECATED|NEW): /m.test(cleaned) && !/\[source\]/.test(cleaned)) return "";
+	if (!SECTION_HEADING_RE.test(cleaned) && !API_CHANGE_BULLET_RE.test(cleaned) && !SOURCE_LINK_RE.test(cleaned)) return "";
 	return cleaned;
 }
+const STATIC_REGEX_1$1 = /^\[(?:starting|retrying|cached)/;
+const STATIC_REGEX_2$1 = /^\[([^:[\]]+)(?::\s(.+))?\]$/;
+const STATIC_REGEX_3$1 = /skilld search\s+"([^"]+)"/;
 function createToolProgress(log) {
 	let lastMsg = "";
 	let repeatCount = 0;
@@ -832,7 +851,7 @@ function createToolProgress(log) {
 	function emit(msg) {
 		if (msg === lastMsg) {
 			repeatCount++;
-			log.message(`${msg} \x1B[90m(+${repeatCount})\x1B[0m`);
+			log.message(`${msg} ${styleText("gray", `(+${repeatCount})`)}`);
 		} else {
 			lastMsg = msg;
 			repeatCount = 0;
@@ -845,17 +864,17 @@ function createToolProgress(log) {
 			const now = Date.now();
 			if (now - (lastTextEmit.get(key) ?? 0) < TEXT_THROTTLE_MS) return;
 			lastTextEmit.set(key, now);
-			const prefix = section ? `\x1B[90m[${section}]\x1B[0m ` : "";
+			const prefix = section ? `${styleText("gray", `[${section}]`)} ` : "";
 			const items = text ? text.match(/^- (?:BREAKING|DEPRECATED|NEW|CHANGED|REMOVED|Use |Do |Set |Add |Avoid |Always |Never |Prefer |Check |Ensure )/gm)?.length ?? 0 : 0;
-			emit(items > 0 ? `${prefix}Writing... \x1B[90m(${items} items)\x1B[0m` : `${prefix}Writing...`);
+			emit(items > 0 ? `${prefix}Writing... ${styleText("gray", `(${items} items)`)}` : `${prefix}Writing...`);
 			return;
 		}
 		if (type !== "reasoning" || !chunk.startsWith("[")) return;
-		if (/^\[(?:starting|retrying|cached)/.test(chunk)) {
-			emit(`${section ? `\x1B[90m[${section}]\x1B[0m ` : ""}${chunk.slice(1, -1)}`);
+		if (STATIC_REGEX_1$1.test(chunk)) {
+			emit(`${section ? `${styleText("gray", `[${section}]`)} ` : ""}${chunk.slice(1, -1)}`);
 			return;
 		}
-		const match = chunk.match(/^\[([^:[\]]+)(?::\s(.+))?\]$/);
+		const match = chunk.match(STATIC_REGEX_2$1);
 		if (!match) return;
 		const names = match[1].split(",").map((n) => n.trim());
 		const hints = match[2]?.split(",").map((h) => h.trim()) ?? [];
@@ -863,16 +882,16 @@ function createToolProgress(log) {
 			const rawName = names[i];
 			const hint = hints[i] ?? hints[0] ?? "";
 			const verb = TOOL_NAMES[rawName]?.verb ?? rawName;
-			const prefix = section ? `\x1B[90m[${section}]\x1B[0m ` : "";
+			const prefix = section ? `${styleText("gray", `[${section}]`)} ` : "";
 			if ((rawName === "Bash" || rawName === "run_shell_command") && hint) {
-				const searchMatch = hint.match(/skilld search\s+"([^"]+)"/);
-				if (searchMatch) emit(`${prefix}Searching \x1B[36m"${searchMatch[1]}"\x1B[0m`);
+				const searchMatch = hint.match(STATIC_REGEX_3$1);
+				if (searchMatch) emit(`${prefix}Searching ${styleText("cyan", `"${searchMatch[1]}"`)}`);
 				else if (hint.includes("skilld validate")) emit(`${prefix}Validating...`);
 				else {
 					const shortened = shortenCommand(hint);
 					emit(`${prefix}Running ${shortened.length > 50 ? `${shortened.slice(0, 47)}...` : shortened}`);
 				}
-			} else emit(`${prefix}${verb} \x1B[90m${shortenPath(hint || "...")}\x1B[0m`);
+			} else emit(`${prefix}${verb} ${styleText("gray", shortenPath(hint || "..."))}`);
 		}
 	};
 }
@@ -1031,13 +1050,16 @@ async function detectNuxtModules(cwd) {
 async function detectPresetPackages(cwd) {
 	return detectNuxtModules(cwd);
 }
+const FROM_STATIC_IMPORT_RE = /\bfrom\s*['"]([^'"\n]+)['"]/g;
+const SIDE_EFFECT_IMPORT_RE = /\bimport\s*['"]([^'"\n]+)['"]/g;
+const DYNAMIC_IMPORT_RE = /\bimport\s*\(\s*['"]([^'"\n]+)['"]\s*\)/g;
 const PATTERNS = ["**/*.{ts,js,vue,mjs,cjs,tsx,jsx,mts,cts}"];
-const IGNORE = [
-	"**/node_modules/**",
-	"**/dist/**",
-	"**/.nuxt/**",
-	"**/.output/**",
-	"**/coverage/**"
+const IGNORE_DIRS = [
+	"node_modules",
+	"dist",
+	".nuxt",
+	".output",
+	"coverage"
 ];
 function addPackage(counts, specifier) {
 	if (!specifier || specifier.startsWith(".") || specifier.startsWith("/")) return;
@@ -1047,19 +1069,16 @@ function addPackage(counts, specifier) {
 async function detectImportedPackages(cwd = process.cwd()) {
 	try {
 		const counts = /* @__PURE__ */ new Map();
-		const files = await glob(PATTERNS, {
+		const files = [];
+		for await (const file of glob(PATTERNS, {
 			cwd,
-			ignore: IGNORE,
-			absolute: true,
-			expandDirectories: false
-		});
+			exclude: (p) => IGNORE_DIRS.some((dir) => p === dir || p.endsWith(`/${dir}`))
+		})) files.push(join(cwd, file));
 		await Promise.all(files.map(async (file) => {
 			const content = await readFile(file, "utf8");
-			for (const imp of findStaticImports(content)) addPackage(counts, imp.specifier);
-			for (const imp of findDynamicImports(content)) {
-				const match = imp.expression.match(/^['"]([^'"]+)['"]$/);
-				if (match) addPackage(counts, match[1]);
-			}
+			for (const m of content.matchAll(FROM_STATIC_IMPORT_RE)) addPackage(counts, m[1]);
+			for (const m of content.matchAll(SIDE_EFFECT_IMPORT_RE)) addPackage(counts, m[1]);
+			for (const m of content.matchAll(DYNAMIC_IMPORT_RE)) addPackage(counts, m[1]);
 		}));
 		const packages = Array.from(counts.entries(), ([name, count]) => ({
 			name,
@@ -1358,6 +1377,11 @@ function piAiExecutor(model) {
 function selectExecutor(model) {
 	return isPiAiModel(model) ? piAiExecutor(model) : cliExecutor(model);
 }
+const STATIC_REGEX_1 = /\b429\b/;
+const STATIC_REGEX_2 = /rate.?limit/i;
+const STATIC_REGEX_3 = /exhausted.*capacity/i;
+const STATIC_REGEX_4 = /quota.*reset/i;
+const STATIC_REGEX_5 = /reset\s+after\s+(\d+)s/i;
 async function optimizeSection(opts) {
 	const { section, prompt, outputFile, skillDir, executor, onProgress, timeout, debug, preExistingFiles } = opts;
 	const skilldDir = skillInternalDir(skillDir);
@@ -1604,11 +1628,11 @@ async function optimizeDocs(opts) {
 }
 function isRateLimitError(error) {
 	if (!error) return false;
-	return /\b429\b/.test(error) || /rate.?limit/i.test(error) || /exhausted.*capacity/i.test(error) || /quota.*reset/i.test(error);
+	return STATIC_REGEX_1.test(error) || STATIC_REGEX_2.test(error) || STATIC_REGEX_3.test(error) || STATIC_REGEX_4.test(error);
 }
 function parseRateLimitDelay(error) {
 	if (!error || !isRateLimitError(error)) return void 0;
-	const match = error.match(/reset\s+after\s+(\d+)s/i);
+	const match = error.match(STATIC_REGEX_5);
 	return match ? Number(match[1]) : 10;
 }
 function getRetryError(result) {