skilld 1.7.1 → 1.7.3

package/dist/_chunks/skills.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"skills.mjs","names":["agents"],"sources":["../../src/core/skills.ts"],"sourcesContent":["import type { AgentType } from '../agent/index.ts'\nimport type { ShippedSkill } from '../cache/storage.ts'\nimport type { SkillInfo } from './lockfile.ts'\nimport { existsSync, readdirSync } from 'node:fs'\nimport { join } from 'pathe'\nimport { agents } from '../agent/index.ts'\nimport { getShippedSkills } from '../cache/storage.ts'\nimport { readLocalDependencies } from '../sources/index.ts'\nimport { parsePackages, parseSkillFrontmatter, readLock } from './lockfile.ts'\nimport { getSharedSkillsDir, semverGt, semverValid } from './shared.ts'\n\nexport interface SkillEntry {\n  name: string\n  dir: string\n  agent: AgentType\n  info: SkillInfo | null\n  scope: 'local' | 'global'\n  /** Original package name from package.json (e.g., @scope/pkg) */\n  packageName?: string\n  /** Latest version from package.json deps */\n  latestVersion?: string\n}\n\nexport interface AvailableShippedSkill {\n  /** npm package that ships the skill */\n  packageName: string\n  skills: ShippedSkill[]\n}\n\nexport interface ProjectState {\n  skills: SkillEntry[]\n  deps: Map<string, string>\n  missing: string[]\n  outdated: SkillEntry[]\n  synced: SkillEntry[]\n  /** Skills in lockfile but not matched to any local dep */\n  unmatched: SkillEntry[]\n  /** Dependencies that ship skills not yet installed */\n  shipped: AvailableShippedSkill[]\n}\n\nexport interface IterateSkillsOptions {\n  scope?: 'local' | 'global' | 'all'\n  agents?: AgentType[]\n  cwd?: string\n}\n\nexport function* iterateSkills(opts: IterateSkillsOptions = {}): Generator<SkillEntry> {\n  const { scope = 'all', cwd = process.cwd() } = opts\n  const agentTypes = opts.agents ?? (Object.keys(agents) as AgentType[])\n\n  // When shared dir exists, read local skills from there (avoid duplicates from agent symlinks)\n  const sharedDir = getSharedSkillsDir(cwd)\n  let yieldedLocal = false\n\n  if (sharedDir && (scope === 'local' || scope === 'all')) {\n    yieldedLocal = true\n    const lock = readLock(sharedDir)\n    const entries = readdirSync(sharedDir).filter(f => !f.startsWith('.') && f !== 'skilld-lock.yaml')\n    // Use first detected agent as the representative\n    const firstAgent = agentTypes[0] ?? (Object.keys(agents) as AgentType[])[0]!\n    for (const name of entries) {\n      const dir = join(sharedDir, name)\n      if (lock?.skills[name]) {\n        yield { name, dir, agent: firstAgent, info: lock.skills[name], scope: 'local' }\n      }\n      else {\n        const info = parseSkillFrontmatter(join(dir, '.skilld', '_SKILL.md'))\n        if (info?.generator === 'skilld') {\n          yield { name, dir, agent: firstAgent, info, scope: 'local' }\n        }\n      }\n    }\n  }\n\n  for (const agentType of agentTypes) {\n    const agent = agents[agentType]\n\n    // Local skills (skip if already yielded from shared dir)\n    if (!yieldedLocal && (scope === 'local' || scope === 'all')) {\n      const localDir = join(cwd, agent.skillsDir)\n      if (existsSync(localDir)) {\n        const lock = readLock(localDir)\n        const entries = readdirSync(localDir).filter(f => !f.startsWith('.') && f !== 'skilld-lock.yaml')\n        for (const name of entries) {\n          const dir = join(localDir, name)\n          // Only track skills in lockfile OR with generator: \"skilld\"\n          if (lock?.skills[name]) {\n            yield { name, dir, agent: agentType, info: lock.skills[name], scope: 'local' }\n          }\n          else {\n            const info = parseSkillFrontmatter(join(dir, '.skilld', '_SKILL.md'))\n            if (info?.generator === 'skilld') {\n              yield { name, dir, agent: agentType, info, scope: 'local' }\n            }\n          }\n        }\n      }\n    }\n\n    // Global skills\n    if ((scope === 'global' || scope === 'all') && agent.globalSkillsDir) {\n      const globalDir = agent.globalSkillsDir\n      if (existsSync(globalDir)) {\n        const lock = readLock(globalDir)\n        const entries = readdirSync(globalDir).filter(f => !f.startsWith('.') && f !== 'skilld-lock.yaml')\n        for (const name of entries) {\n          const dir = join(globalDir, name)\n          // Only track skills in lockfile OR with generator: \"skilld\"\n          if (lock?.skills[name]) {\n            yield { name, dir, agent: agentType, info: lock.skills[name], scope: 'global' }\n          }\n          else {\n            const info = parseSkillFrontmatter(join(dir, '.skilld', '_SKILL.md'))\n            if (info?.generator === 'skilld') {\n              yield { name, dir, agent: agentType, info, scope: 'global' }\n            }\n          }\n        }\n      }\n    }\n  }\n}\n\nexport function isOutdated(skill: SkillEntry, depVersion: string): boolean {\n  if (!skill.info?.version)\n    return true\n\n  const depClean = depVersion.replace(/^[\\^~>=<]+/, '')\n\n  // Non-semver versions (e.g. '*' from catalog:/workspace: specifiers) can't be compared\n  if (!semverValid(depClean))\n    return false\n\n  return semverGt(depClean, skill.info.version)\n}\n\nexport async function getProjectState(cwd: string = process.cwd()): Promise<ProjectState> {\n  const skills = [...iterateSkills({ scope: 'local', cwd })]\n\n  // Get package.json deps\n  const localDeps = await readLocalDependencies(cwd).catch(() => [])\n  const deps = new Map(localDeps.map(d => [d.name, d.version]))\n\n  // Build unified lookup: packageName -> best skill entry\n  // When multiple skills claim the same package, prefer the one with the newer version\n  const skillByPkgName = new Map<string, SkillEntry>()\n  const setBestSkill = (key: string, s: SkillEntry) => {\n    const existing = skillByPkgName.get(key)\n    if (!existing) {\n      skillByPkgName.set(key, s)\n      return\n    }\n    // Prefer the skill with the newer version (more recently synced)\n    if (s.info?.version && existing.info?.version && semverValid(s.info.version) && semverValid(existing.info.version) && semverGt(s.info.version, existing.info.version))\n      skillByPkgName.set(key, s)\n  }\n  for (const s of skills) {\n    if (s.info?.packageName)\n      setBestSkill(s.info.packageName, s)\n    for (const pkg of parsePackages(s.info?.packages))\n      setBestSkill(pkg.name, s)\n  }\n\n  // Also build name-based lookups, but defer to pkgName map for conflicts\n  const skillByName = new Map(skills.map(s => [s.name, s]))\n\n  const missing: string[] = []\n  const outdated: SkillEntry[] = []\n  const synced: SkillEntry[] = []\n  const matchedSkillNames = new Set<string>()\n\n  for (const [pkgName, version] of deps) {\n    // Normalize package name (e.g., @scope/pkg -> scope-pkg)\n    const normalizedName = pkgName.replace(/^@/, '').replace(/\\//g, '-')\n    // Prefer packageName-based lookup (handles duplicates correctly), fall back to name-based\n    const skill = skillByPkgName.get(pkgName) || skillByName.get(`${normalizedName}-skilld`) || skillByName.get(normalizedName) || skillByName.get(pkgName)\n\n    if (!skill) {\n      missing.push(pkgName)\n    }\n    else {\n      matchedSkillNames.add(skill.name)\n      if (isOutdated(skill, version)) {\n        outdated.push({ ...skill, packageName: pkgName, latestVersion: version })\n      }\n      else {\n        synced.push({ ...skill, packageName: pkgName, latestVersion: version })\n      }\n    }\n  }\n\n  // Skills in lockfile but not matched to any local dep\n  const unmatched = skills.filter(s => !matchedSkillNames.has(s.name))\n\n  // Discover dependencies that ship skills not yet installed\n  const installedSkillNames = new Set(skills.map(s => s.name))\n  const shipped: AvailableShippedSkill[] = []\n  for (const pkgName of deps.keys()) {\n    const pkgShipped = getShippedSkills(pkgName, cwd)\n    const uninstalled = pkgShipped.filter(s => !installedSkillNames.has(s.skillName))\n    if (uninstalled.length > 0)\n      shipped.push({ packageName: pkgName, skills: uninstalled })\n  }\n\n  return { skills, deps, missing, outdated, synced, unmatched, shipped }\n}\n\nexport function getSkillsDir(agent: AgentType, scope: 'local' | 'global', cwd: string = process.cwd()): string {\n  const agentConfig = agents[agent]\n  if (scope === 'global') {\n    if (!agentConfig.globalSkillsDir) {\n      throw new Error(`Agent ${agent} does not support global skills`)\n    }\n    return agentConfig.globalSkillsDir\n  }\n  return getSharedSkillsDir(cwd) || join(cwd, agentConfig.skillsDir)\n}\n"],"mappings":"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"}
+{"version":3,"file":"skills.mjs","names":["agents"],"sources":["../../src/core/skills.ts"],"sourcesContent":["import type { AgentType } from '../agent/index.ts'\nimport type { ShippedSkill } from '../cache/storage.ts'\nimport type { SkillInfo } from './lockfile.ts'\nimport { existsSync, readdirSync } from 'node:fs'\nimport { join } from 'pathe'\nimport { agents } from '../agent/index.ts'\nimport { getShippedSkills } from '../cache/storage.ts'\nimport { readLocalDependencies } from '../sources/index.ts'\nimport { parsePackages, parseSkillFrontmatter, readLock } from './lockfile.ts'\nimport { getSharedSkillsDir, semverGt, semverValid } from './shared.ts'\n\nexport interface SkillEntry {\n  name: string\n  dir: string\n  agent: AgentType\n  info: SkillInfo | null\n  scope: 'local' | 'global'\n  /** Original package name from package.json (e.g., @scope/pkg) */\n  packageName?: string\n  /** Latest version from package.json deps */\n  latestVersion?: string\n}\n\nexport interface AvailableShippedSkill {\n  /** npm package that ships the skill */\n  packageName: string\n  skills: ShippedSkill[]\n}\n\nexport interface ProjectState {\n  skills: SkillEntry[]\n  deps: Map<string, string>\n  missing: string[]\n  outdated: SkillEntry[]\n  synced: SkillEntry[]\n  /** Skills in lockfile but not matched to any local dep */\n  unmatched: SkillEntry[]\n  /** Dependencies that ship skills not yet installed */\n  shipped: AvailableShippedSkill[]\n}\n\nexport interface IterateSkillsOptions {\n  scope?: 'local' | 'global' | 'all'\n  agents?: AgentType[]\n  cwd?: string\n}\n\nexport function* iterateSkills(opts: IterateSkillsOptions = {}): Generator<SkillEntry> {\n  const { scope = 'all', cwd = process.cwd() } = opts\n  const agentTypes = opts.agents ?? (Object.keys(agents) as AgentType[])\n\n  // When shared dir exists, read local skills from there (avoid duplicates from agent symlinks)\n  const sharedDir = getSharedSkillsDir(cwd)\n  let yieldedLocal = false\n\n  if (sharedDir && (scope === 'local' || scope === 'all')) {\n    yieldedLocal = true\n    const lock = readLock(sharedDir)\n    const entries = readdirSync(sharedDir).filter(f => !f.startsWith('.') && f !== 'skilld-lock.yaml')\n    // Use first detected agent as the representative\n    const firstAgent = agentTypes[0] ?? (Object.keys(agents) as AgentType[])[0]!\n    for (const name of entries) {\n      const dir = join(sharedDir, name)\n      if (lock?.skills[name]) {\n        yield { name, dir, agent: firstAgent, info: lock.skills[name], scope: 'local' }\n      }\n      else {\n        const info = parseSkillFrontmatter(join(dir, '.skilld', '_SKILL.md'))\n        if (info?.generator === 'skilld') {\n          yield { name, dir, agent: firstAgent, info, scope: 'local' }\n        }\n      }\n    }\n  }\n\n  for (const agentType of agentTypes) {\n    const agent = agents[agentType]\n\n    // Local skills (skip if already yielded from shared dir)\n    if (!yieldedLocal && (scope === 'local' || scope === 'all')) {\n      const localDir = join(cwd, agent.skillsDir)\n      if (existsSync(localDir)) {\n        const lock = readLock(localDir)\n        const entries = readdirSync(localDir).filter(f => !f.startsWith('.') && f !== 'skilld-lock.yaml')\n        for (const name of entries) {\n          const dir = join(localDir, name)\n          // Only track skills in lockfile OR with generator: \"skilld\"\n          if (lock?.skills[name]) {\n            yield { name, dir, agent: agentType, info: lock.skills[name], scope: 'local' }\n          }\n          else {\n            const info = parseSkillFrontmatter(join(dir, '.skilld', '_SKILL.md'))\n            if (info?.generator === 'skilld') {\n              yield { name, dir, agent: agentType, info, scope: 'local' }\n            }\n          }\n        }\n      }\n    }\n\n    // Global skills\n    if ((scope === 'global' || scope === 'all') && agent.globalSkillsDir) {\n      const globalDir = agent.globalSkillsDir\n      if (existsSync(globalDir)) {\n        const lock = readLock(globalDir)\n        const entries = readdirSync(globalDir).filter(f => !f.startsWith('.') && f !== 'skilld-lock.yaml')\n        for (const name of entries) {\n          const dir = join(globalDir, name)\n          // Only track skills in lockfile OR with generator: \"skilld\"\n          if (lock?.skills[name]) {\n            yield { name, dir, agent: agentType, info: lock.skills[name], scope: 'global' }\n          }\n          else {\n            const info = parseSkillFrontmatter(join(dir, '.skilld', '_SKILL.md'))\n            if (info?.generator === 'skilld') {\n              yield { name, dir, agent: agentType, info, scope: 'global' }\n            }\n          }\n        }\n      }\n    }\n  }\n}\n\nexport function isOutdated(skill: SkillEntry, depVersion: string): boolean {\n  if (!skill.info?.version)\n    return true\n\n  const depClean = depVersion.replace(/^[\\^~>=<]+/, '')\n\n  // Non-semver versions (e.g. '*' from catalog:/workspace: specifiers) can't be compared\n  if (!semverValid(depClean))\n    return false\n\n  return semverGt(depClean, skill.info.version)\n}\n\nexport async function getProjectState(cwd: string = process.cwd()): Promise<ProjectState> {\n  const skills = [...iterateSkills({ scope: 'local', cwd })]\n\n  // Get package.json deps\n  const localDeps = await readLocalDependencies(cwd).catch(() => [])\n  const deps = new Map(localDeps.map(d => [d.name, d.version]))\n\n  // Build unified lookup: packageName -> best skill entry\n  // When multiple skills claim the same package, prefer the one with the newer version\n  const skillByPkgName = new Map<string, SkillEntry>()\n  const setBestSkill = (key: string, s: SkillEntry) => {\n    const existing = skillByPkgName.get(key)\n    if (!existing) {\n      skillByPkgName.set(key, s)\n      return\n    }\n    // Prefer the skill with the newer version (more recently synced)\n    if (s.info?.version && existing.info?.version && semverValid(s.info.version) && semverValid(existing.info.version) && semverGt(s.info.version, existing.info.version))\n      skillByPkgName.set(key, s)\n  }\n  for (const s of skills) {\n    if (s.info?.packageName)\n      setBestSkill(s.info.packageName, s)\n    for (const pkg of parsePackages(s.info?.packages))\n      setBestSkill(pkg.name, s)\n  }\n\n  // Also build name-based lookups, but defer to pkgName map for conflicts\n  const skillByName = new Map(skills.map(s => [s.name, s]))\n\n  const missing: string[] = []\n  const outdated: SkillEntry[] = []\n  const synced: SkillEntry[] = []\n  const matchedSkillNames = new Set<string>()\n\n  for (const [pkgName, version] of deps) {\n    // Normalize package name (e.g., @scope/pkg -> scope-pkg)\n    const normalizedName = pkgName.replace(/^@/, '').replace(/\\//g, '-')\n    // Prefer packageName-based lookup (handles duplicates correctly), fall back to name-based\n    const skill = skillByPkgName.get(pkgName) || skillByName.get(`${normalizedName}-skilld`) || skillByName.get(normalizedName) || skillByName.get(pkgName)\n\n    if (!skill) {\n      missing.push(pkgName)\n    }\n    else {\n      matchedSkillNames.add(skill.name)\n      if (isOutdated(skill, version)) {\n        outdated.push({ ...skill, packageName: pkgName, latestVersion: version })\n      }\n      else {\n        synced.push({ ...skill, packageName: pkgName, latestVersion: version })\n      }\n    }\n  }\n\n  // Skills in lockfile but not matched to any local dep\n  const unmatched = skills.filter(s => !matchedSkillNames.has(s.name))\n\n  // Discover dependencies that ship skills not yet installed\n  const installedSkillNames = new Set(skills.map(s => s.name))\n  const shipped: AvailableShippedSkill[] = []\n  for (const pkgName of deps.keys()) {\n    const pkgShipped = getShippedSkills(pkgName, cwd)\n    const uninstalled = pkgShipped.filter(s => !installedSkillNames.has(s.skillName))\n    if (uninstalled.length > 0)\n      shipped.push({ packageName: pkgName, skills: uninstalled })\n  }\n\n  return { skills, deps, missing, outdated, synced, unmatched, shipped }\n}\n\nexport function getSkillsDir(agent: AgentType, scope: 'local' | 'global', cwd: string = process.cwd()): string {\n  const agentConfig = agents[agent]\n  if (scope === 'global') {\n    if (!agentConfig.globalSkillsDir) {\n      throw new Error(`Agent ${agent} does not support global skills`)\n    }\n    return agentConfig.globalSkillsDir\n  }\n  return getSharedSkillsDir(cwd) || join(cwd, agentConfig.skillsDir)\n}\n"],"mappings":"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"}

package/dist/_chunks/sources.mjs

@@ -1887,6 +1887,21 @@ function parseSkillFrontmatterName(content) {
 		description: fm.description
 	};
 }
+function findSkillDirs(root, prefix = "") {
+	const out = [];
+	if (!existsSync(root)) return out;
+	for (const entry of readdirSync(root, { withFileTypes: true })) {
+		if (!entry.isDirectory()) continue;
+		const dir = resolve(root, entry.name);
+		const repoPath = prefix ? `${prefix}/${entry.name}` : entry.name;
+		if (existsSync(resolve(dir, "SKILL.md"))) out.push({
+			dir,
+			repoPath
+		});
+		else out.push(...findSkillDirs(dir, repoPath));
+	}
+	return out;
+}
 function collectFiles(dir, prefix = "") {
 	const files = [];
 	if (!existsSync(dir)) return files;
@@ -1912,9 +1927,8 @@ function fetchLocalSkills(source) {
 	if (!existsSync(base)) return { skills: [] };
 	const skills = [];
 	const skillsDir = resolve(base, "skills");
-	if (existsSync(skillsDir)) for (const entry of readdirSync(skillsDir, { withFileTypes: true })) {
-		if (!entry.isDirectory()) continue;
-		const skill = readLocalSkill(resolve(skillsDir, entry.name), `skills/${entry.name}`);
+	if (existsSync(skillsDir)) for (const { dir, repoPath } of findSkillDirs(skillsDir, "skills")) {
+		const skill = readLocalSkill(dir, repoPath);
 		if (skill) skills.push(skill);
 	}
 	if (skills.length === 0) {
@@ -1971,9 +1985,8 @@ async function downloadGitHubSkills(owner, repo, ref, skillPath, onProgress) {
 				auth: getGitHubToken() || void 0
 			});
 			const skills = [];
-			for (const entry of readdirSync(dir, { withFileTypes: true })) {
-				if (!entry.isDirectory()) continue;
-				const skill = readLocalSkill(resolve(dir, entry.name), `skills/${entry.name}`);
+			for (const { dir: skillDir, repoPath } of findSkillDirs(dir, "skills")) {
+				const skill = readLocalSkill(skillDir, repoPath);
 				if (skill) skills.push(skill);
 			}
 			if (skills.length > 0) {
@@ -2020,9 +2033,8 @@ async function fetchGitLabSkills(source, onProgress) {
 			return { skills: skill ? [skill] : [] };
 		}
 		const skills = [];
-		for (const entry of readdirSync(dir, { withFileTypes: true })) {
-			if (!entry.isDirectory()) continue;
-			const skill = readLocalSkill(resolve(dir, entry.name), `skills/${entry.name}`);
+		for (const { dir: skillDir, repoPath } of findSkillDirs(dir, "skills")) {
+			const skill = readLocalSkill(skillDir, repoPath);
 			if (skill) skills.push(skill);
 		}
 		if (skills.length > 0) {