@xopcai/xopc 0.0.111 → 0.0.113

package/dist/src/agent/skills/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/agent/skills/index.ts"],"sourcesContent":["import { existsSync, readdirSync, readFileSync } from 'fs';\nimport { basename, dirname, join, relative, sep } from 'path';\nimport { parseFrontmatter } from '../../markdown/frontmatter.js';\nimport { resolveStateDir } from '../../config/paths.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { createSkillConfigManager, isSkillEnabled } from './config.js';\nimport { formatSkillsForPrompt } from './format-skills-prompt.js';\nimport { parseRequiredEnvVarNames } from './required-env-vars.js';\nimport { parseSkillMetadata } from './parse-skill-metadata.js';\nimport { parseSkillToolConditions } from './skill-tool-gating.js';\nimport type { Skill, SkillDiagnostic, LoadSkillsResult, SkillConfig, SkillsConfig } from './types.js';\n\nconst log = createLogger('SkillLoader');\n\nconst IGNORE_FILES = ['.gitignore', '.ignore', '.fdignore'];\n\nfunction toPosixPath(p: string): string {\n  return p.split(sep).join('/');\n}\n\nfunction prefixIgnorePattern(line: string, prefix: string): string | null {\n  const trimmed = line.trim();\n  if (!trimmed) return null;\n  if (trimmed.startsWith('#') && !trimmed.startsWith('\\\\#')) return null;\n\n  let pattern = line;\n  let negated = false;\n\n  if (pattern.startsWith('!')) {\n    negated = true;\n    pattern = pattern.slice(1);\n  } else if (pattern.startsWith('\\\\!')) {\n    pattern = pattern.slice(1);\n  }\n\n  if (pattern.startsWith('/')) {\n    pattern = pattern.slice(1);\n  }\n\n  const prefixed = prefix ? `${prefix}${pattern}` : pattern;\n  return negated ? `!${prefixed}` : prefixed;\n}\n\nfunction loadIgnoreRules(dir: string, rootDir: string): Set<string> {\n  const ignoredPaths = new Set<string>();\n  const relativeDir = relative(rootDir, dir);\n  const prefix = relativeDir ? `${toPosixPath(relativeDir)}/` : '';\n\n  for (const filename of IGNORE_FILES) {\n    const ignorePath = join(dir, filename);\n    if (!existsSync(ignorePath)) continue;\n\n    try {\n      const content = readFileSync(ignorePath, 'utf-8');\n      for (const line of content.split(/\\r?\\n/)) {\n        const pattern = prefixIgnorePattern(line, prefix);\n        if (pattern) {\n          const fullPattern = pattern.startsWith('!')\n            ? `!${prefix}${pattern.slice(1)}`\n            : `${prefix}${pattern}`;\n          ignoredPaths.add(fullPattern);\n        }\n      }\n    } catch {}\n  }\n\n  return ignoredPaths;\n}\n\nfunction shouldIgnore(path: string, ignoredPaths: Set<string>): boolean {\n  for (const pattern of ignoredPaths) {\n    if (pattern.startsWith('!')) {\n      const positive = pattern.slice(1);\n      if (path === positive || path.startsWith(`${positive}/`)) {\n        return false;\n      }\n    } else {\n      if (path === pattern || path.startsWith(`${pattern}/`)) {\n        return true;\n      }\n    }\n  }\n  return false;\n}\n\nfunction discoverSkills(dir: string, source: 'builtin' | 'workspace' | 'global'): Skill[] {\n  const skills: Skill[] = [];\n  if (!existsSync(dir)) return skills;\n\n  function scan(currentDir: string, currentIgnoredPaths: Set<string>) {\n    try {\n      const entries = readdirSync(currentDir, { withFileTypes: true });\n\n      for (const entry of entries) {\n        if (entry.name.startsWith('.') || entry.name === 'node_modules') continue;\n\n        const fullPath = join(currentDir, entry.name);\n        const relPath = toPosixPath(relative(dir, fullPath));\n\n        if (shouldIgnore(relPath, currentIgnoredPaths)) continue;\n\n        if (entry.isDirectory()) {\n          const skillMdPath = join(fullPath, 'SKILL.md');\n          const skillRelPath = `${relPath}/`;\n\n          const subIgnoredPaths = new Set(currentIgnoredPaths);\n          const subIgnoreFile = join(fullPath, '.gitignore');\n          if (existsSync(subIgnoreFile)) {\n            const subRules = loadIgnoreRules(fullPath, dir);\n            for (const rule of subRules) {\n              subIgnoredPaths.add(`${skillRelPath}${rule}`);\n            }\n          }\n\n          if (existsSync(skillMdPath) && !shouldIgnore(skillRelPath, currentIgnoredPaths)) {\n            const skill = loadSkillFromFile(skillMdPath, source, dir);\n            if (skill) skills.push(skill);\n          }\n\n          scan(fullPath, subIgnoredPaths);\n        }\n      }\n    } catch {}\n  }\n\n  scan(dir, loadIgnoreRules(dir, dir));\n  return skills;\n}\n\nfunction deriveDescriptionFromMarkdown(content: string): string | undefined {\n  let fallbackHeading = '';\n\n  for (const rawLine of content.split(/\\r?\\n/)) {\n    const line = rawLine.trim();\n    if (!line) continue;\n\n    const heading = line.match(/^#{1,6}\\s+(.+)$/);\n    if (heading) {\n      fallbackHeading ||= heading[1]?.trim() ?? '';\n      continue;\n    }\n\n    return line\n      .replace(/\\[([^\\]]+)\\]\\([^)]*\\)/g, '$1')\n      .replace(/[*_`~]/g, '')\n      .trim() || undefined;\n  }\n\n  return fallbackHeading || undefined;\n}\n\nfunction loadSkillFromFile(filePath: string, source: 'builtin' | 'workspace' | 'global', rootDir?: string): Skill | null {\n  try {\n    const rawContent = readFileSync(filePath, 'utf-8');\n    const { frontmatter, content } = parseFrontmatter(rawContent);\n    const skillDir = dirname(filePath);\n    const parentDirName = basename(skillDir);\n\n    const name = (frontmatter.name as string | undefined) || parentDirName;\n    const description =\n      (frontmatter.description as string | undefined)?.trim() || deriveDescriptionFromMarkdown(content);\n    if (!description?.trim()) return null;\n\n    // Derive category from directory path: skills/creative/algorithmic-art → 'creative'\n    // Only assign a category when the skill is nested at least two levels below rootDir.\n    let category: string | undefined;\n    if (rootDir) {\n      const relDir = toPosixPath(relative(rootDir, skillDir));\n      const segments = relDir.split('/');\n      if (segments.length > 1) {\n        category = segments[0];\n      }\n    }\n\n    const metadata = parseSkillMetadata(frontmatter);\n    metadata.name ||= name;\n    metadata.description ||= description.trim();\n    const toolConditions = parseSkillToolConditions(frontmatter);\n    const requiredEnvVarNames = parseRequiredEnvVarNames(frontmatter);\n\n    return {\n      name,\n      description: description.trim(),\n      category,\n      filePath,\n      baseDir: skillDir,\n      source,\n      disableModelInvocation: frontmatter['disable-model-invocation'] === true,\n      metadata,\n      toolConditions,\n      requiredEnvVarNames: requiredEnvVarNames.length > 0 ? requiredEnvVarNames : undefined,\n      content,\n    };\n  } catch {\n    return null;\n  }\n}\n\nexport function loadSkills(options: {\n  workspaceDir?: string;\n  globalDir?: string;\n  builtinDir?: string;\n  extraDirs?: string[];\n}): LoadSkillsResult {\n  const { workspaceDir, builtinDir, extraDirs = [] } = options;\n\n  const skillMap = new Map<string, Skill>();\n  const diagnostics: SkillDiagnostic[] = [];\n\n  if (builtinDir) {\n    for (const skill of discoverSkills(builtinDir, 'builtin')) {\n      const existing = skillMap.get(skill.name);\n      if (existing) {\n        diagnostics.push({\n          type: 'collision',\n          skillName: skill.name,\n          message: `Skill \"${skill.name}\" collision: ${existing.source} overrides ${skill.source}`,\n          path: skill.filePath,\n        });\n      } else {\n        skillMap.set(skill.name, skill);\n      }\n    }\n  }\n\n  const globalDirs = [\n    options.globalDir,\n    join(resolveStateDir(), 'skills'),\n  ].filter((d): d is string => !!d && existsSync(d));\n\n  for (const dir of globalDirs) {\n    for (const skill of discoverSkills(dir, 'global')) {\n      const existing = skillMap.get(skill.name);\n      if (existing) {\n        diagnostics.push({\n          type: 'collision',\n          skillName: skill.name,\n          message: `Skill \"${skill.name}\" collision: ${skill.source} overrides ${existing.source}`,\n          path: skill.filePath,\n        });\n      }\n      // Global must win over bundled when names match (Workspace > Global > Bundled).\n      skillMap.set(skill.name, skill);\n    }\n  }\n\n  if (workspaceDir) {\n    const workspaceSkills = discoverSkills(join(workspaceDir, 'skills'), 'workspace');\n    for (const skill of workspaceSkills) {\n      const existing = skillMap.get(skill.name);\n      if (existing) {\n        diagnostics.push({\n          type: 'collision',\n          skillName: skill.name,\n          message: `Skill \"${skill.name}\" collision: ${skill.source} overrides ${existing.source}`,\n          path: skill.filePath,\n        });\n      }\n      skillMap.set(skill.name, skill);\n    }\n  }\n\n  // Scan extra directories\n  for (const extraDir of extraDirs) {\n    if (existsSync(extraDir)) {\n      for (const skill of discoverSkills(extraDir, 'global')) {\n        const existing = skillMap.get(skill.name);\n        if (existing) {\n          diagnostics.push({\n            type: 'collision',\n            skillName: skill.name,\n            message: `Skill \"${skill.name}\" collision: ${existing.source} overrides ${skill.source}`,\n            path: skill.filePath,\n          });\n        } else {\n          skillMap.set(skill.name, skill);\n        }\n      }\n    }\n  }\n\n  const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n  const merged = Array.from(skillMap.values());\n\n  return {\n    skills: merged,\n    prompt: formatSkillsForPrompt(merged, skillsConfig),\n    diagnostics,\n  };\n}\n\nexport interface SkillLoader {\n  init: (workspace: string, builtin: string | null) => LoadSkillsResult;\n  load: () => LoadSkillsResult;\n  reload: () => LoadSkillsResult;\n  /** Recompute `<available_skills>` from disk-loaded skills and current ~/.xopc/skills.json (no filesystem rescan). */\n  refreshPromptFromConfig: () => void;\n  getSkills: () => Skill[];\n  getPrompt: () => string;\n  getDiagnostics: () => SkillDiagnostic[];\n  getLastLoadTime: () => number;\n  getSkillByName: (name: string) => Skill | undefined;\n  getEnabledSkills: (config?: Record<string, SkillConfig>) => Skill[];\n}\n\nexport function createSkillLoader(): SkillLoader {\n  let cachedSkills: Skill[] = [];\n  let cachedPrompt: string = '';\n  let cachedDiagnostics: SkillDiagnostic[] = [];\n  let lastLoadTime = 0;\n  let workspaceDir: string | undefined;\n  let builtinDir: string | undefined;\n  let extraDirs: string[] = [];\n\n  function updateCache(result: LoadSkillsResult): LoadSkillsResult {\n    cachedSkills = result.skills;\n    cachedPrompt = result.prompt;\n    cachedDiagnostics = result.diagnostics;\n    lastLoadTime = Date.now();\n    return result;\n  }\n\n  return {\n    init: (workspace: string, builtin: string | null) => {\n      workspaceDir = workspace;\n      builtinDir = builtin || undefined;\n      return updateCache(loadSkills({ workspaceDir, builtinDir, extraDirs }));\n    },\n    \n    load: () => {\n      return updateCache(loadSkills({ workspaceDir, builtinDir, extraDirs }));\n    },\n    \n    reload: () => {\n      log.info('Reloading skills');\n      return updateCache(loadSkills({ workspaceDir, builtinDir, extraDirs }));\n    },\n\n    refreshPromptFromConfig: () => {\n      const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n      cachedPrompt = formatSkillsForPrompt(cachedSkills, skillsConfig);\n      lastLoadTime = Date.now();\n    },\n\n    getSkills: () => cachedSkills,\n    getPrompt: () => cachedPrompt,\n    getDiagnostics: () => cachedDiagnostics,\n    getLastLoadTime: () => lastLoadTime,\n    \n    getSkillByName: (name: string) => {\n      return cachedSkills.find(s => s.name === name);\n    },\n    \n    getEnabledSkills: (entries?: Record<string, SkillConfig>) => {\n      const skillsConfig: SkillsConfig =\n        entries !== undefined ? { entries } : createSkillConfigManager(resolveStateDir()).load();\n      return cachedSkills.filter(\n        (skill) => !skill.disableModelInvocation && isSkillEnabled(skill, skillsConfig),\n      );\n    },\n  };\n}\n\n// `SkillManager` + sibling types removed from this barrel — `skill-manager.ts`\n// imports `createSkillLoader` from THIS file, so re-exporting it back here\n// formed a circular cycle. External callers should import directly from\n// `./skill-manager.js`.\n\n// Re-export types for convenience\nexport type { \n  Skill, \n  SkillMetadata, \n  SkillConfig,\n  SkillInstallSpec,\n  SkillInstallResult,\n  SkillInstallRequest,\n  LoadSkillsResult,\n  // Note: SkillDiagnostic is re-exported from skill-manager.ts above\n  SkillSnapshot,\n} from './types.js';\n\n// Re-export installer\nexport { \n  installSkill, \n  findInstallSpec,\n  hasBinary,\n  getDefaultInstallerPreferences,\n  type InstallerPreferences,\n  type InstallContext,\n} from './installer.js';\n\n// Re-export scanner\nexport {\n  scanSkillDirectory,\n  formatScanSummary,\n  collectSkillInstallWarnings,\n  type ScanSummary,\n  type SecurityFinding,\n  type Severity,\n} from './scanner.js';\n\n// Re-export config manager\nexport {\n  resolveSkillConfig,\n  applySkillEnvOverrides,\n  getSkillEnvironment,\n  createSkillConfigManager,\n  isSkillEnabled,\n  validateSkillConfig,\n  type SkillConfigFile,\n} from './config.js';\n\n// `watcher.ts` re-exports removed — it imports `SkillLoader` from THIS file, so\n// re-exporting back here formed a circular cycle. External callers should\n// import directly from `./watcher.js`.\n\n// Re-export test framework\nexport {\n  SkillTestFramework,\n  SkillTestRunner,\n  formatTestResults,\n  formatTestResultsJson,\n  formatTestResultsTap,\n  type TestResult,\n  type TestStatus,\n  type SkillTestReport,\n  type TestOptions,\n  type TestRunnerOptions,\n} from './test-framework.js';\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/agent/skills/index.ts"],"sourcesContent":["import { existsSync, readdirSync, readFileSync } from 'fs';\nimport { basename, dirname, join, relative, sep } from 'path';\nimport { parseFrontmatter } from '../../markdown/frontmatter.js';\nimport { resolveStateDir } from '../../config/paths.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { createSkillConfigManager, isSkillEnabled } from './config.js';\nimport { formatSkillsForPrompt } from './format-skills-prompt.js';\nimport { parseRequiredEnvVarNames } from './required-env-vars.js';\nimport { parseSkillMetadata } from './parse-skill-metadata.js';\nimport { parseSkillToolConditions } from './skill-tool-gating.js';\nimport type { Skill, SkillDiagnostic, LoadSkillsResult, SkillConfig, SkillsConfig } from './types.js';\n\nconst log = createLogger('SkillLoader');\n\nconst IGNORE_FILES = ['.gitignore', '.ignore', '.fdignore'];\n\nfunction toPosixPath(p: string): string {\n  return p.split(sep).join('/');\n}\n\nfunction prefixIgnorePattern(line: string, prefix: string): string | null {\n  const trimmed = line.trim();\n  if (!trimmed) return null;\n  if (trimmed.startsWith('#') && !trimmed.startsWith('\\\\#')) return null;\n\n  let pattern = line;\n  let negated = false;\n\n  if (pattern.startsWith('!')) {\n    negated = true;\n    pattern = pattern.slice(1);\n  } else if (pattern.startsWith('\\\\!')) {\n    pattern = pattern.slice(1);\n  }\n\n  if (pattern.startsWith('/')) {\n    pattern = pattern.slice(1);\n  }\n\n  const prefixed = prefix ? `${prefix}${pattern}` : pattern;\n  return negated ? `!${prefixed}` : prefixed;\n}\n\nfunction loadIgnoreRules(dir: string, rootDir: string): Set<string> {\n  const ignoredPaths = new Set<string>();\n  const relativeDir = relative(rootDir, dir);\n  const prefix = relativeDir ? `${toPosixPath(relativeDir)}/` : '';\n\n  for (const filename of IGNORE_FILES) {\n    const ignorePath = join(dir, filename);\n    if (!existsSync(ignorePath)) continue;\n\n    try {\n      const content = readFileSync(ignorePath, 'utf-8');\n      for (const line of content.split(/\\r?\\n/)) {\n        const pattern = prefixIgnorePattern(line, prefix);\n        if (pattern) {\n          const fullPattern = pattern.startsWith('!')\n            ? `!${prefix}${pattern.slice(1)}`\n            : `${prefix}${pattern}`;\n          ignoredPaths.add(fullPattern);\n        }\n      }\n    } catch {}\n  }\n\n  return ignoredPaths;\n}\n\nfunction shouldIgnore(path: string, ignoredPaths: Set<string>): boolean {\n  for (const pattern of ignoredPaths) {\n    if (pattern.startsWith('!')) {\n      const positive = pattern.slice(1);\n      if (path === positive || path.startsWith(`${positive}/`)) {\n        return false;\n      }\n    } else {\n      if (path === pattern || path.startsWith(`${pattern}/`)) {\n        return true;\n      }\n    }\n  }\n  return false;\n}\n\nfunction discoverSkills(\n  dir: string,\n  source: 'builtin' | 'workspace' | 'global',\n): { skills: Skill[]; diagnostics: SkillDiagnostic[] } {\n  const skills: Skill[] = [];\n  const diagnostics: SkillDiagnostic[] = [];\n  if (!existsSync(dir)) return { skills, diagnostics };\n\n  function scan(currentDir: string, currentIgnoredPaths: Set<string>) {\n    try {\n      const entries = readdirSync(currentDir, { withFileTypes: true });\n\n      for (const entry of entries) {\n        if (entry.name.startsWith('.') || entry.name === 'node_modules') continue;\n\n        const fullPath = join(currentDir, entry.name);\n        const relPath = toPosixPath(relative(dir, fullPath));\n\n        if (shouldIgnore(relPath, currentIgnoredPaths)) continue;\n\n        if (entry.isDirectory()) {\n          const skillMdPath = join(fullPath, 'SKILL.md');\n          const skillRelPath = `${relPath}/`;\n\n          const subIgnoredPaths = new Set(currentIgnoredPaths);\n          const subIgnoreFile = join(fullPath, '.gitignore');\n          if (existsSync(subIgnoreFile)) {\n            const subRules = loadIgnoreRules(fullPath, dir);\n            for (const rule of subRules) {\n              subIgnoredPaths.add(`${skillRelPath}${rule}`);\n            }\n          }\n\n          if (existsSync(skillMdPath) && !shouldIgnore(skillRelPath, currentIgnoredPaths)) {\n            const { skill, diagnostic } = loadSkillFromFile(skillMdPath, source, dir);\n            if (diagnostic) diagnostics.push(diagnostic);\n            if (skill) skills.push(skill);\n          }\n\n          scan(fullPath, subIgnoredPaths);\n        }\n      }\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      diagnostics.push({\n        type: 'error',\n        message: `Failed to scan skills directory: ${message}`,\n        path: currentDir,\n      });\n    }\n  }\n\n  scan(dir, loadIgnoreRules(dir, dir));\n  return { skills, diagnostics };\n}\n\nfunction deriveDescriptionFromMarkdown(content: string): string | undefined {\n  let fallbackHeading = '';\n\n  for (const rawLine of content.split(/\\r?\\n/)) {\n    const line = rawLine.trim();\n    if (!line) continue;\n\n    const heading = line.match(/^#{1,6}\\s+(.+)$/);\n    if (heading) {\n      fallbackHeading ||= heading[1]?.trim() ?? '';\n      continue;\n    }\n\n    return line\n      .replace(/\\[([^\\]]+)\\]\\([^)]*\\)/g, '$1')\n      .replace(/[*_`~]/g, '')\n      .trim() || undefined;\n  }\n\n  return fallbackHeading || undefined;\n}\n\nfunction loadSkillFromFile(\n  filePath: string,\n  source: 'builtin' | 'workspace' | 'global',\n  rootDir?: string,\n): { skill: Skill | null; diagnostic?: SkillDiagnostic } {\n  try {\n    const rawContent = readFileSync(filePath, 'utf-8');\n    const { frontmatter, content } = parseFrontmatter(rawContent);\n    const skillDir = dirname(filePath);\n    const parentDirName = basename(skillDir);\n\n    const name = (frontmatter.name as string | undefined) || parentDirName;\n    const description =\n      (frontmatter.description as string | undefined)?.trim() || deriveDescriptionFromMarkdown(content);\n    if (!description?.trim()) {\n      return {\n        skill: null,\n        diagnostic: {\n          type: 'error',\n          skillName: name,\n          message: `Skill \"${name}\" is missing a description`,\n          path: filePath,\n        },\n      };\n    }\n\n    // Derive category from directory path: skills/creative/algorithmic-art → 'creative'\n    // Only assign a category when the skill is nested at least two levels below rootDir.\n    let category: string | undefined;\n    if (rootDir) {\n      const relDir = toPosixPath(relative(rootDir, skillDir));\n      const segments = relDir.split('/');\n      if (segments.length > 1) {\n        category = segments[0];\n      }\n    }\n\n    const metadata = parseSkillMetadata(frontmatter);\n    metadata.name ||= name;\n    metadata.description ||= description.trim();\n    const toolConditions = parseSkillToolConditions(frontmatter);\n    const requiredEnvVarNames = parseRequiredEnvVarNames(frontmatter);\n\n    return {\n      skill: {\n        name,\n        description: description.trim(),\n        category,\n        filePath,\n        baseDir: skillDir,\n        source,\n        disableModelInvocation: frontmatter['disable-model-invocation'] === true,\n        metadata,\n        toolConditions,\n        requiredEnvVarNames: requiredEnvVarNames.length > 0 ? requiredEnvVarNames : undefined,\n        content,\n      },\n    };\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    return {\n      skill: null,\n      diagnostic: {\n        type: 'error',\n        message: `Failed to load skill file: ${message}`,\n        path: filePath,\n      },\n    };\n  }\n}\n\nexport function loadSkills(options: {\n  workspaceDir?: string;\n  globalDir?: string;\n  builtinDir?: string;\n  extraDirs?: string[];\n}): LoadSkillsResult {\n  const { workspaceDir, builtinDir, extraDirs = [] } = options;\n\n  const skillMap = new Map<string, Skill>();\n  const diagnostics: SkillDiagnostic[] = [];\n\n  if (builtinDir) {\n    const discovered = discoverSkills(builtinDir, 'builtin');\n    diagnostics.push(...discovered.diagnostics);\n    for (const skill of discovered.skills) {\n      const existing = skillMap.get(skill.name);\n      if (existing) {\n        diagnostics.push({\n          type: 'collision',\n          skillName: skill.name,\n          message: `Skill \"${skill.name}\" collision: ${existing.source} overrides ${skill.source}`,\n          path: skill.filePath,\n        });\n      } else {\n        skillMap.set(skill.name, skill);\n      }\n    }\n  }\n\n  const globalDirs = [\n    options.globalDir,\n    join(resolveStateDir(), 'skills'),\n  ].filter((d): d is string => !!d && existsSync(d));\n\n  for (const dir of globalDirs) {\n    const discovered = discoverSkills(dir, 'global');\n    diagnostics.push(...discovered.diagnostics);\n    for (const skill of discovered.skills) {\n      const existing = skillMap.get(skill.name);\n      if (existing) {\n        diagnostics.push({\n          type: 'collision',\n          skillName: skill.name,\n          message: `Skill \"${skill.name}\" collision: ${skill.source} overrides ${existing.source}`,\n          path: skill.filePath,\n        });\n      }\n      // Global must win over bundled when names match (Workspace > Global > Bundled).\n      skillMap.set(skill.name, skill);\n    }\n  }\n\n  if (workspaceDir) {\n    const discovered = discoverSkills(join(workspaceDir, 'skills'), 'workspace');\n    diagnostics.push(...discovered.diagnostics);\n    const workspaceSkills = discovered.skills;\n    for (const skill of workspaceSkills) {\n      const existing = skillMap.get(skill.name);\n      if (existing) {\n        diagnostics.push({\n          type: 'collision',\n          skillName: skill.name,\n          message: `Skill \"${skill.name}\" collision: ${skill.source} overrides ${existing.source}`,\n          path: skill.filePath,\n        });\n      }\n      skillMap.set(skill.name, skill);\n    }\n  }\n\n  // Scan extra directories\n  for (const extraDir of extraDirs) {\n    if (existsSync(extraDir)) {\n      const discovered = discoverSkills(extraDir, 'global');\n      diagnostics.push(...discovered.diagnostics);\n      for (const skill of discovered.skills) {\n        const existing = skillMap.get(skill.name);\n        if (existing) {\n          diagnostics.push({\n            type: 'collision',\n            skillName: skill.name,\n            message: `Skill \"${skill.name}\" collision: ${existing.source} overrides ${skill.source}`,\n            path: skill.filePath,\n          });\n        } else {\n          skillMap.set(skill.name, skill);\n        }\n      }\n    }\n  }\n\n  const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n  const merged = Array.from(skillMap.values());\n\n  return {\n    skills: merged,\n    prompt: formatSkillsForPrompt(merged, skillsConfig),\n    diagnostics,\n  };\n}\n\nexport interface SkillLoader {\n  init: (workspace: string, builtin: string | null) => LoadSkillsResult;\n  load: () => LoadSkillsResult;\n  reload: () => LoadSkillsResult;\n  /** Recompute `<available_skills>` from disk-loaded skills and current ~/.xopc/skills.json (no filesystem rescan). */\n  refreshPromptFromConfig: () => void;\n  getSkills: () => Skill[];\n  getPrompt: () => string;\n  getDiagnostics: () => SkillDiagnostic[];\n  getLastLoadTime: () => number;\n  getSkillByName: (name: string) => Skill | undefined;\n  getEnabledSkills: (config?: Record<string, SkillConfig>) => Skill[];\n}\n\nexport function createSkillLoader(): SkillLoader {\n  let cachedSkills: Skill[] = [];\n  let cachedPrompt: string = '';\n  let cachedDiagnostics: SkillDiagnostic[] = [];\n  let lastLoadTime = 0;\n  let workspaceDir: string | undefined;\n  let builtinDir: string | undefined;\n  let extraDirs: string[] = [];\n\n  function updateCache(result: LoadSkillsResult): LoadSkillsResult {\n    cachedSkills = result.skills;\n    cachedPrompt = result.prompt;\n    cachedDiagnostics = result.diagnostics;\n    lastLoadTime = Date.now();\n    return result;\n  }\n\n  return {\n    init: (workspace: string, builtin: string | null) => {\n      workspaceDir = workspace;\n      builtinDir = builtin || undefined;\n      return updateCache(loadSkills({ workspaceDir, builtinDir, extraDirs }));\n    },\n    \n    load: () => {\n      return updateCache(loadSkills({ workspaceDir, builtinDir, extraDirs }));\n    },\n    \n    reload: () => {\n      log.info('Reloading skills');\n      return updateCache(loadSkills({ workspaceDir, builtinDir, extraDirs }));\n    },\n\n    refreshPromptFromConfig: () => {\n      const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n      cachedPrompt = formatSkillsForPrompt(cachedSkills, skillsConfig);\n      lastLoadTime = Date.now();\n    },\n\n    getSkills: () => cachedSkills,\n    getPrompt: () => cachedPrompt,\n    getDiagnostics: () => cachedDiagnostics,\n    getLastLoadTime: () => lastLoadTime,\n    \n    getSkillByName: (name: string) => {\n      return cachedSkills.find(s => s.name === name);\n    },\n    \n    getEnabledSkills: (entries?: Record<string, SkillConfig>) => {\n      const skillsConfig: SkillsConfig =\n        entries !== undefined ? { entries } : createSkillConfigManager(resolveStateDir()).load();\n      return cachedSkills.filter(\n        (skill) => !skill.disableModelInvocation && isSkillEnabled(skill, skillsConfig),\n      );\n    },\n  };\n}\n\n// `SkillManager` + sibling types removed from this barrel — `skill-manager.ts`\n// imports `createSkillLoader` from THIS file, so re-exporting it back here\n// formed a circular cycle. External callers should import directly from\n// `./skill-manager.js`.\n\n// Re-export types for convenience\nexport type { \n  Skill, \n  SkillMetadata, \n  SkillConfig,\n  SkillInstallSpec,\n  SkillInstallResult,\n  SkillInstallRequest,\n  LoadSkillsResult,\n  // Note: SkillDiagnostic is re-exported from skill-manager.ts above\n  SkillSnapshot,\n} from './types.js';\n\n// Re-export installer\nexport { \n  installSkill, \n  findInstallSpec,\n  hasBinary,\n  getDefaultInstallerPreferences,\n  type InstallerPreferences,\n  type InstallContext,\n} from './installer.js';\n\n// Re-export scanner\nexport {\n  scanSkillDirectory,\n  formatScanSummary,\n  collectSkillInstallWarnings,\n  type ScanSummary,\n  type SecurityFinding,\n  type Severity,\n} from './scanner.js';\n\n// Re-export config manager\nexport {\n  resolveSkillConfig,\n  applySkillEnvOverrides,\n  getSkillEnvironment,\n  createSkillConfigManager,\n  isSkillEnabled,\n  validateSkillConfig,\n  type SkillConfigFile,\n} from './config.js';\n\n// `watcher.ts` re-exports removed — it imports `SkillLoader` from THIS file, so\n// re-exporting back here formed a circular cycle. External callers should\n// import directly from `./watcher.js`.\n\n// Re-export test framework\nexport {\n  SkillTestFramework,\n  SkillTestRunner,\n  formatTestResults,\n  formatTestResultsJson,\n  formatTestResultsTap,\n  type TestResult,\n  type TestStatus,\n  type SkillTestReport,\n  type TestOptions,\n  type TestRunnerOptions,\n} from './test-framework.js';\n"],"mappings":"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"}

package/dist/src/agent/skills/installer.js

@@ -1,9 +1,9 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { delimiter, join } from "path";
 import { accessSync, constants, existsSync } from "fs";
-import { promisify } from "util";
 import { exec } from "child_process";
+import { delimiter, join } from "path";
+import { promisify } from "util";
 //#region src/agent/skills/installer.ts
 /**
 * Skill Installer

package/dist/src/agent/skills/managed-store.d.ts

@@ -5,6 +5,7 @@
 import { type SkillHubLockEntry } from './hub-lock.js';
 export declare const MAX_SKILL_ZIP_BYTES: number;
 export declare function isValidSkillId(id: string): boolean;
+export declare function isManagedSkillTransientDirName(name: string): boolean;
 /** True when `baseDir` is the global managed skills root or a direct child folder. */
 export declare function isUnderManagedSkillsDir(baseDir: string): boolean;
 /** macOS/Windows noise; not part of the skill tree. */
@@ -19,6 +20,24 @@ export interface ManagedSkillListItem {
 }
 export declare function listManagedSkillDirs(): ManagedSkillListItem[];
 export declare function deleteManagedSkill(skillId: string): void;
+export declare function getManagedSkillDir(skillId: string): string;
+export declare function assertManagedSkillDestination(skillId: string): {
+    root: string;
+    destDir: string;
+};
+export declare function prepareManagedSkillTempDir(skillId: string): {
+    root: string;
+    destDir: string;
+    tempDir: string;
+};
+export declare function promoteManagedSkillTempDir(params: {
+    skillId: string;
+    tempDir: string;
+    overwrite?: boolean;
+}): {
+    skillId: string;
+    path: string;
+};
 /**
  * Install or replace a skill from a zip buffer. Layout: either `SKILL.md` at archive root
  * or a single top-level folder containing `SKILL.md` (optionally nested one level).

package/dist/src/agent/skills/managed-store.js

@@ -1,8 +1,8 @@
 import { init_paths, resolveSkillsDir } from "../../config/paths.js";
 import { parseFrontmatter } from "../../markdown/frontmatter.js";
 import { loadSkillsLock } from "./hub-lock.js";
+import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { dirname, join, resolve, sep } from "node:path";
-import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import AdmZip from "adm-zip";
 //#region src/agent/skills/managed-store.ts
 /**
@@ -12,9 +12,14 @@ import AdmZip from "adm-zip";
 init_paths();
 const MAX_SKILL_ZIP_BYTES = 15 * 1024 * 1024;
 const SKILL_ID_RE = /^[a-zA-Z0-9]([a-zA-Z0-9._-]{0,62})$/;
+const TEMP_PREFIX = ".tmp-";
+const TRASH_PREFIX = ".trash-";
 function isValidSkillId(id) {
 	return SKILL_ID_RE.test(id);
 }
+function isManagedSkillTransientDirName(name) {
+	return name.startsWith(TEMP_PREFIX) || name.startsWith(TRASH_PREFIX);
+}
 /** True when `baseDir` is the global managed skills root or a direct child folder. */
 function isUnderManagedSkillsDir(baseDir) {
 	const b = resolve(baseDir);
@@ -89,11 +94,73 @@ function deleteManagedSkill(skillId) {
 	const rootResolved = resolve(root);
 	if (!dir.startsWith(rootResolved + sep) && dir !== rootResolved) throw new Error("Invalid path");
 	if (!existsSync(join(dir, "SKILL.md"))) throw new Error("Skill not found");
-	rmSync(dir, {
+	const trashDir = createTransientManagedDir(root, TRASH_PREFIX, skillId);
+	renameSync(dir, trashDir);
+	rmSync(trashDir, {
 		recursive: true,
 		force: true
 	});
 }
+function createTransientManagedDir(root, prefix, skillId) {
+	for (let i = 0; i < 100; i += 1) {
+		const dir = join(root, `${prefix}${skillId}-${`${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}-${i}`}`);
+		if (!existsSync(dir)) return dir;
+	}
+	throw new Error("Could not allocate temporary skill directory");
+}
+function getManagedSkillDir(skillId) {
+	if (!isValidSkillId(skillId)) throw new Error("Invalid skill id");
+	return join(resolveSkillsDir(), skillId);
+}
+function assertManagedSkillDestination(skillId) {
+	if (!isValidSkillId(skillId)) throw new Error(`Invalid skill id "${skillId}" (letters, digits, ._-; max 63 chars after first)`);
+	const root = resolveSkillsDir();
+	mkdirSync(root, { recursive: true });
+	const destDir = join(root, skillId);
+	const destResolved = resolve(destDir);
+	const rootResolved = resolve(root);
+	if (!destResolved.startsWith(rootResolved + sep) && destResolved !== rootResolved) throw new Error("Invalid destination path");
+	return {
+		root,
+		destDir
+	};
+}
+function prepareManagedSkillTempDir(skillId) {
+	const { root, destDir } = assertManagedSkillDestination(skillId);
+	const tempDir = createTransientManagedDir(root, TEMP_PREFIX, skillId);
+	mkdirSync(tempDir, { recursive: true });
+	return {
+		root,
+		destDir,
+		tempDir
+	};
+}
+function promoteManagedSkillTempDir(params) {
+	const { root, destDir } = assertManagedSkillDestination(params.skillId);
+	const tempResolved = resolve(params.tempDir);
+	const rootResolved = resolve(root);
+	if (!tempResolved.startsWith(rootResolved + sep)) throw new Error("Invalid temporary skill directory");
+	if (!existsSync(join(params.tempDir, "SKILL.md"))) throw new Error("Installed tree is missing SKILL.md");
+	if (existsSync(destDir)) {
+		if (!params.overwrite) throw new Error(`Skill "${params.skillId}" already exists. Pass overwrite to replace.`);
+		const trashDir = createTransientManagedDir(root, TRASH_PREFIX, params.skillId);
+		renameSync(destDir, trashDir);
+		try {
+			renameSync(params.tempDir, destDir);
+		} catch (err) {
+			renameSync(trashDir, destDir);
+			throw err;
+		}
+		rmSync(trashDir, {
+			recursive: true,
+			force: true
+		});
+	} else renameSync(params.tempDir, destDir);
+	return {
+		skillId: params.skillId,
+		path: destDir
+	};
+}
 function inferStripPrefix(primary) {
 	const parts = primary.split("/").filter(Boolean);
 	if (parts.length === 1 && parts[0].toLowerCase() === "skill.md") return "";
@@ -120,8 +187,6 @@ function installSkillFromZip(buffer, options) {
 		const outside = names.filter((n) => !n.startsWith(prefixNorm) && !isIgnorableZipEntry(n));
 		if (outside.length > 0) throw new Error(`Invalid zip: expected all skill files under "${prefixNorm.replace(/\/$/, "")}/", but found "${outside[0]}". Put SKILL.md and assets in one folder, or zip that folder only.`);
 	}
-	const root = resolveSkillsDir();
-	mkdirSync(root, { recursive: true });
 	let targetId = options.skillId?.trim();
 	if (!targetId) {
 		if (stripPrefix) targetId = stripPrefix.replace(/\/$/, "").split("/")[0] || "";
@@ -134,46 +199,40 @@ function installSkillFromZip(buffer, options) {
 		}
 	}
 	if (!targetId || !isValidSkillId(targetId)) throw new Error("Could not determine skill id: use a folder named with the skill id, pass skillId, or set name: in SKILL.md (letters, digits, ._-)");
-	const destDir = join(root, targetId);
-	const destResolved = resolve(destDir);
-	const rootResolved = resolve(root);
-	if (!destResolved.startsWith(rootResolved + sep) && destResolved !== rootResolved) throw new Error("Invalid destination");
-	if (existsSync(destDir)) {
-		if (!options.overwrite) throw new Error(`Skill "${targetId}" already exists. Pass overwrite to replace.`);
-		rmSync(destDir, {
-			recursive: true,
-			force: true
+	const { destDir, tempDir } = prepareManagedSkillTempDir(targetId);
+	const tempResolved = resolve(tempDir);
+	try {
+		if (existsSync(destDir) && !options.overwrite) throw new Error(`Skill "${targetId}" already exists. Pass overwrite to replace.`);
+		for (const e of safeEntries) {
+			const norm = e.entryName.replace(/\\/g, "/");
+			let rel;
+			if (stripPrefix) {
+				const prefixNorm = stripPrefix.replace(/\\/g, "/");
+				if (!norm.startsWith(prefixNorm)) continue;
+				rel = norm.slice(prefixNorm.length).replace(/^\//, "");
+			} else rel = norm;
+			if (!rel || rel.includes("..")) continue;
+			const targetPath = join(tempDir, rel);
+			const resolvedTarget = resolve(targetPath);
+			if (!resolvedTarget.startsWith(tempResolved + sep) && resolvedTarget !== tempResolved) continue;
+			mkdirSync(dirname(targetPath), { recursive: true });
+			writeFileSync(targetPath, e.getData());
+		}
+		if (!existsSync(join(tempDir, "SKILL.md"))) throw new Error("Extracted content is missing SKILL.md");
+		return promoteManagedSkillTempDir({
+			skillId: targetId,
+			tempDir,
+			overwrite: options.overwrite
 		});
-	}
-	mkdirSync(destDir, { recursive: true });
-	for (const e of safeEntries) {
-		const norm = e.entryName.replace(/\\/g, "/");
-		let rel;
-		if (stripPrefix) {
-			const prefixNorm = stripPrefix.replace(/\\/g, "/");
-			if (!norm.startsWith(prefixNorm)) continue;
-			rel = norm.slice(prefixNorm.length).replace(/^\//, "");
-		} else rel = norm;
-		if (!rel || rel.includes("..")) continue;
-		const targetPath = join(destDir, rel);
-		const resolvedTarget = resolve(targetPath);
-		if (!resolvedTarget.startsWith(destResolved + sep) && resolvedTarget !== destResolved) continue;
-		mkdirSync(dirname(targetPath), { recursive: true });
-		writeFileSync(targetPath, e.getData());
-	}
-	if (!existsSync(join(destDir, "SKILL.md"))) {
-		rmSync(destDir, {
+	} catch (err) {
+		rmSync(tempDir, {
 			recursive: true,
 			force: true
 		});
-		throw new Error("Extracted content is missing SKILL.md");
+		throw err;
 	}
-	return {
-		skillId: targetId,
-		path: destDir
-	};
 }
 //#endregion
-export { MAX_SKILL_ZIP_BYTES, deleteManagedSkill, installSkillFromZip, isIgnorableZipEntry, isUnderManagedSkillsDir, isValidSkillId, listManagedSkillDirs };
+export { MAX_SKILL_ZIP_BYTES, assertManagedSkillDestination, deleteManagedSkill, getManagedSkillDir, installSkillFromZip, isIgnorableZipEntry, isManagedSkillTransientDirName, isUnderManagedSkillsDir, isValidSkillId, listManagedSkillDirs, prepareManagedSkillTempDir, promoteManagedSkillTempDir };
 
 //# sourceMappingURL=managed-store.js.map

package/dist/src/agent/skills/managed-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"managed-store.js","names":[],"sources":["../../../../src/agent/skills/managed-store.ts"],"sourcesContent":["/**\n * Managed skills live under ~/.xopc/skills (see resolveSkillsDir).\n * Install/update/delete via zip or folder operations; used by gateway API.\n */\n\nimport AdmZip from 'adm-zip';\nimport {\n  existsSync,\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  rmSync,\n  writeFileSync,\n} from 'node:fs';\nimport { dirname, join, resolve, sep } from 'node:path';\nimport { resolveSkillsDir } from '../../config/paths.js';\nimport { parseFrontmatter } from '../../markdown/frontmatter.js';\nimport { loadSkillsLock, type SkillHubLockEntry } from './hub-lock.js';\n\nexport const MAX_SKILL_ZIP_BYTES = 15 * 1024 * 1024;\n\nconst SKILL_ID_RE = /^[a-zA-Z0-9]([a-zA-Z0-9._-]{0,62})$/;\n\nexport function isValidSkillId(id: string): boolean {\n  return SKILL_ID_RE.test(id);\n}\n\n/** True when `baseDir` is the global managed skills root or a direct child folder. */\nexport function isUnderManagedSkillsDir(baseDir: string): boolean {\n  const b = resolve(baseDir);\n  const r = resolve(resolveSkillsDir());\n  return b === r || b.startsWith(r + sep);\n}\n\nfunction isSafeZipPath(name: string): boolean {\n  if (!name) return false;\n  const normalized = name.replace(/\\\\/g, '/');\n  if (normalized.includes('..')) return false;\n  if (normalized.startsWith('/') || /^\\w:/.test(normalized)) return false;\n  for (const p of normalized.split('/')) {\n    if (p === '..') return false;\n  }\n  return true;\n}\n\n/** macOS/Windows noise; not part of the skill tree. */\nexport function isIgnorableZipEntry(name: string): boolean {\n  const n = name.replace(/\\\\/g, '/');\n  if (n.startsWith('__MACOSX/')) return true;\n  const segments = n.split('/').filter(Boolean);\n  for (const s of segments) {\n    if (s === '.DS_Store' || s === 'Thumbs.db' || s === 'desktop.ini') return true;\n    if (s.startsWith('._')) return true;\n  }\n  return false;\n}\n\nexport interface ManagedSkillListItem {\n  id: string;\n  name: string;\n  description: string;\n  path: string;\n  /** Set when this folder was installed via `skills hub pull` / lock file. */\n  hub?: SkillHubLockEntry;\n}\n\nfunction readSkillMdMeta(skillMdPath: string): { name: string; description: string } {\n  try {\n    const raw = readFileSync(skillMdPath, 'utf-8');\n    const { frontmatter } = parseFrontmatter(raw);\n    return {\n      name: (frontmatter.name as string) || '',\n      description: (frontmatter.description as string)?.trim() || '',\n    };\n  } catch {\n    return { name: '', description: '' };\n  }\n}\n\nexport function listManagedSkillDirs(): ManagedSkillListItem[] {\n  const root = resolveSkillsDir();\n  mkdirSync(root, { recursive: true });\n  const lock = loadSkillsLock();\n  let dirNames: string[];\n  try {\n    dirNames = readdirSync(root, { withFileTypes: true })\n      .filter((e) => e.isDirectory() && !e.name.startsWith('.'))\n      .map((e) => e.name);\n  } catch {\n    return [];\n  }\n  const out: ManagedSkillListItem[] = [];\n  for (const id of dirNames) {\n    if (!isValidSkillId(id)) continue;\n    const skillMd = join(root, id, 'SKILL.md');\n    if (!existsSync(skillMd)) continue;\n    const meta = readSkillMdMeta(skillMd);\n    const hub = lock.entries[id];\n    out.push({\n      id,\n      name: meta.name || id,\n      description: meta.description || '',\n      path: join(root, id),\n      ...(hub ? { hub } : {}),\n    });\n  }\n  out.sort((a, b) => a.id.localeCompare(b.id));\n  return out;\n}\n\nexport function deleteManagedSkill(skillId: string): void {\n  if (!isValidSkillId(skillId)) {\n    throw new Error('Invalid skill id');\n  }\n  const root = resolveSkillsDir();\n  const dir = resolve(join(root, skillId));\n  const rootResolved = resolve(root);\n  if (!dir.startsWith(rootResolved + sep) && dir !== rootResolved) {\n    throw new Error('Invalid path');\n  }\n  if (!existsSync(join(dir, 'SKILL.md'))) {\n    throw new Error('Skill not found');\n  }\n  rmSync(dir, { recursive: true, force: true });\n}\n\nfunction inferStripPrefix(primary: string): string {\n  const parts = primary.split('/').filter(Boolean);\n  if (parts.length === 1 && parts[0].toLowerCase() === 'skill.md') {\n    return '';\n  }\n  return primary.slice(0, -'SKILL.md'.length);\n}\n\n/**\n * Install or replace a skill from a zip buffer. Layout: either `SKILL.md` at archive root\n * or a single top-level folder containing `SKILL.md` (optionally nested one level).\n */\nexport function installSkillFromZip(\n  buffer: Buffer,\n  options: { skillId?: string; overwrite?: boolean },\n): { skillId: string; path: string } {\n  if (buffer.length > MAX_SKILL_ZIP_BYTES) {\n    throw new Error(`Zip exceeds maximum size (${MAX_SKILL_ZIP_BYTES} bytes)`);\n  }\n\n  const zip = new AdmZip(buffer);\n  const entries = zip\n    .getEntries()\n    .filter((e) => !e.isDirectory && e.entryName && !isIgnorableZipEntry(e.entryName));\n\n  const safeEntries = entries.filter((e) => isSafeZipPath(e.entryName));\n  if (safeEntries.length === 0) {\n    throw new Error('Zip is empty or invalid');\n  }\n\n  const names = safeEntries.map((e) => e.entryName.replace(/\\\\/g, '/'));\n  const skillMdPaths = names.filter((n) => /(^|\\/)SKILL\\.md$/i.test(n));\n  if (skillMdPaths.length === 0) {\n    throw new Error('Zip must contain at least one SKILL.md');\n  }\n\n  const shallow = skillMdPaths.filter((p) => p.split('/').filter(Boolean).length <= 2);\n  if (shallow.length === 0) {\n    throw new Error(\n      'SKILL.md is nested too deeply; use a zip with SKILL.md at archive root or one folder (e.g. my-skill/SKILL.md)',\n    );\n  }\n\n  shallow.sort((a, b) => a.length - b.length);\n  const stripPrefix = inferStripPrefix(shallow[0]);\n\n  if (stripPrefix) {\n    const prefixNorm = stripPrefix.replace(/\\\\/g, '/');\n    const outside = names.filter((n) => !n.startsWith(prefixNorm) && !isIgnorableZipEntry(n));\n    if (outside.length > 0) {\n      throw new Error(\n        `Invalid zip: expected all skill files under \"${prefixNorm.replace(/\\/$/, '')}/\", but found \"${outside[0]}\". ` +\n          'Put SKILL.md and assets in one folder, or zip that folder only.',\n      );\n    }\n  }\n\n  const root = resolveSkillsDir();\n  mkdirSync(root, { recursive: true });\n\n  let targetId = options.skillId?.trim();\n  if (!targetId) {\n    if (stripPrefix) {\n      const first = stripPrefix.replace(/\\/$/, '').split('/')[0];\n      targetId = first || '';\n    }\n    if (!targetId) {\n      const skillName = shallow.find((n) => /(^|\\/)SKILL\\.md$/i.test(n)) || '';\n      const entry = zip.getEntry(skillName);\n      if (!entry) throw new Error('SKILL.md missing');\n      const raw = entry.getData().toString('utf-8');\n      const { frontmatter } = parseFrontmatter(raw);\n      targetId = String(frontmatter.name || '').trim();\n    }\n  }\n\n  if (!targetId || !isValidSkillId(targetId)) {\n    throw new Error(\n      'Could not determine skill id: use a folder named with the skill id, pass skillId, or set name: in SKILL.md (letters, digits, ._-)',\n    );\n  }\n\n  const destDir = join(root, targetId);\n  const destResolved = resolve(destDir);\n  const rootResolved = resolve(root);\n  if (!destResolved.startsWith(rootResolved + sep) && destResolved !== rootResolved) {\n    throw new Error('Invalid destination');\n  }\n\n  if (existsSync(destDir)) {\n    if (!options.overwrite) {\n      throw new Error(`Skill \"${targetId}\" already exists. Pass overwrite to replace.`);\n    }\n    rmSync(destDir, { recursive: true, force: true });\n  }\n  mkdirSync(destDir, { recursive: true });\n\n  for (const e of safeEntries) {\n    const norm = e.entryName.replace(/\\\\/g, '/');\n    let rel: string;\n    if (stripPrefix) {\n      const prefixNorm = stripPrefix.replace(/\\\\/g, '/');\n      if (!norm.startsWith(prefixNorm)) continue;\n      rel = norm.slice(prefixNorm.length).replace(/^\\//, '');\n    } else {\n      rel = norm;\n    }\n    if (!rel || rel.includes('..')) continue;\n\n    const targetPath = join(destDir, rel);\n    const resolvedTarget = resolve(targetPath);\n    if (!resolvedTarget.startsWith(destResolved + sep) && resolvedTarget !== destResolved) {\n      continue;\n    }\n    mkdirSync(dirname(targetPath), { recursive: true });\n    writeFileSync(targetPath, e.getData());\n  }\n\n  if (!existsSync(join(destDir, 'SKILL.md'))) {\n    rmSync(destDir, { recursive: true, force: true });\n    throw new Error('Extracted content is missing SKILL.md');\n  }\n\n  return { skillId: targetId, path: destDir };\n}\n"],"mappings":"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"}
+{"version":3,"file":"managed-store.js","names":[],"sources":["../../../../src/agent/skills/managed-store.ts"],"sourcesContent":["/**\n * Managed skills live under ~/.xopc/skills (see resolveSkillsDir).\n * Install/update/delete via zip or folder operations; used by gateway API.\n */\n\nimport AdmZip from 'adm-zip';\nimport {\n  existsSync,\n  mkdirSync,\n  renameSync,\n  readdirSync,\n  readFileSync,\n  rmSync,\n  writeFileSync,\n} from 'node:fs';\nimport { dirname, join, resolve, sep } from 'node:path';\nimport { resolveSkillsDir } from '../../config/paths.js';\nimport { parseFrontmatter } from '../../markdown/frontmatter.js';\nimport { loadSkillsLock, type SkillHubLockEntry } from './hub-lock.js';\n\nexport const MAX_SKILL_ZIP_BYTES = 15 * 1024 * 1024;\n\nconst SKILL_ID_RE = /^[a-zA-Z0-9]([a-zA-Z0-9._-]{0,62})$/;\nconst TEMP_PREFIX = '.tmp-';\nconst TRASH_PREFIX = '.trash-';\n\nexport function isValidSkillId(id: string): boolean {\n  return SKILL_ID_RE.test(id);\n}\n\nexport function isManagedSkillTransientDirName(name: string): boolean {\n  return name.startsWith(TEMP_PREFIX) || name.startsWith(TRASH_PREFIX);\n}\n\n/** True when `baseDir` is the global managed skills root or a direct child folder. */\nexport function isUnderManagedSkillsDir(baseDir: string): boolean {\n  const b = resolve(baseDir);\n  const r = resolve(resolveSkillsDir());\n  return b === r || b.startsWith(r + sep);\n}\n\nfunction isSafeZipPath(name: string): boolean {\n  if (!name) return false;\n  const normalized = name.replace(/\\\\/g, '/');\n  if (normalized.includes('..')) return false;\n  if (normalized.startsWith('/') || /^\\w:/.test(normalized)) return false;\n  for (const p of normalized.split('/')) {\n    if (p === '..') return false;\n  }\n  return true;\n}\n\n/** macOS/Windows noise; not part of the skill tree. */\nexport function isIgnorableZipEntry(name: string): boolean {\n  const n = name.replace(/\\\\/g, '/');\n  if (n.startsWith('__MACOSX/')) return true;\n  const segments = n.split('/').filter(Boolean);\n  for (const s of segments) {\n    if (s === '.DS_Store' || s === 'Thumbs.db' || s === 'desktop.ini') return true;\n    if (s.startsWith('._')) return true;\n  }\n  return false;\n}\n\nexport interface ManagedSkillListItem {\n  id: string;\n  name: string;\n  description: string;\n  path: string;\n  /** Set when this folder was installed via `skills hub pull` / lock file. */\n  hub?: SkillHubLockEntry;\n}\n\nfunction readSkillMdMeta(skillMdPath: string): { name: string; description: string } {\n  try {\n    const raw = readFileSync(skillMdPath, 'utf-8');\n    const { frontmatter } = parseFrontmatter(raw);\n    return {\n      name: (frontmatter.name as string) || '',\n      description: (frontmatter.description as string)?.trim() || '',\n    };\n  } catch {\n    return { name: '', description: '' };\n  }\n}\n\nexport function listManagedSkillDirs(): ManagedSkillListItem[] {\n  const root = resolveSkillsDir();\n  mkdirSync(root, { recursive: true });\n  const lock = loadSkillsLock();\n  let dirNames: string[];\n  try {\n    dirNames = readdirSync(root, { withFileTypes: true })\n      .filter((e) => e.isDirectory() && !e.name.startsWith('.'))\n      .map((e) => e.name);\n  } catch {\n    return [];\n  }\n  const out: ManagedSkillListItem[] = [];\n  for (const id of dirNames) {\n    if (!isValidSkillId(id)) continue;\n    const skillMd = join(root, id, 'SKILL.md');\n    if (!existsSync(skillMd)) continue;\n    const meta = readSkillMdMeta(skillMd);\n    const hub = lock.entries[id];\n    out.push({\n      id,\n      name: meta.name || id,\n      description: meta.description || '',\n      path: join(root, id),\n      ...(hub ? { hub } : {}),\n    });\n  }\n  out.sort((a, b) => a.id.localeCompare(b.id));\n  return out;\n}\n\nexport function deleteManagedSkill(skillId: string): void {\n  if (!isValidSkillId(skillId)) {\n    throw new Error('Invalid skill id');\n  }\n  const root = resolveSkillsDir();\n  const dir = resolve(join(root, skillId));\n  const rootResolved = resolve(root);\n  if (!dir.startsWith(rootResolved + sep) && dir !== rootResolved) {\n    throw new Error('Invalid path');\n  }\n  if (!existsSync(join(dir, 'SKILL.md'))) {\n    throw new Error('Skill not found');\n  }\n  const trashDir = createTransientManagedDir(root, TRASH_PREFIX, skillId);\n  renameSync(dir, trashDir);\n  rmSync(trashDir, { recursive: true, force: true });\n}\n\nfunction createTransientManagedDir(root: string, prefix: string, skillId: string): string {\n  for (let i = 0; i < 100; i += 1) {\n    const suffix = `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}-${i}`;\n    const dir = join(root, `${prefix}${skillId}-${suffix}`);\n    if (!existsSync(dir)) return dir;\n  }\n  throw new Error('Could not allocate temporary skill directory');\n}\n\nexport function getManagedSkillDir(skillId: string): string {\n  if (!isValidSkillId(skillId)) {\n    throw new Error('Invalid skill id');\n  }\n  return join(resolveSkillsDir(), skillId);\n}\n\nexport function assertManagedSkillDestination(skillId: string): { root: string; destDir: string } {\n  if (!isValidSkillId(skillId)) {\n    throw new Error(`Invalid skill id \"${skillId}\" (letters, digits, ._-; max 63 chars after first)`);\n  }\n  const root = resolveSkillsDir();\n  mkdirSync(root, { recursive: true });\n  const destDir = join(root, skillId);\n  const destResolved = resolve(destDir);\n  const rootResolved = resolve(root);\n  if (!destResolved.startsWith(rootResolved + sep) && destResolved !== rootResolved) {\n    throw new Error('Invalid destination path');\n  }\n  return { root, destDir };\n}\n\nexport function prepareManagedSkillTempDir(skillId: string): { root: string; destDir: string; tempDir: string } {\n  const { root, destDir } = assertManagedSkillDestination(skillId);\n  const tempDir = createTransientManagedDir(root, TEMP_PREFIX, skillId);\n  mkdirSync(tempDir, { recursive: true });\n  return { root, destDir, tempDir };\n}\n\nexport function promoteManagedSkillTempDir(params: {\n  skillId: string;\n  tempDir: string;\n  overwrite?: boolean;\n}): { skillId: string; path: string } {\n  const { root, destDir } = assertManagedSkillDestination(params.skillId);\n  const tempResolved = resolve(params.tempDir);\n  const rootResolved = resolve(root);\n  if (!tempResolved.startsWith(rootResolved + sep)) {\n    throw new Error('Invalid temporary skill directory');\n  }\n  if (!existsSync(join(params.tempDir, 'SKILL.md'))) {\n    throw new Error('Installed tree is missing SKILL.md');\n  }\n\n  if (existsSync(destDir)) {\n    if (!params.overwrite) {\n      throw new Error(`Skill \"${params.skillId}\" already exists. Pass overwrite to replace.`);\n    }\n    const trashDir = createTransientManagedDir(root, TRASH_PREFIX, params.skillId);\n    renameSync(destDir, trashDir);\n    try {\n      renameSync(params.tempDir, destDir);\n    } catch (err) {\n      renameSync(trashDir, destDir);\n      throw err;\n    }\n    rmSync(trashDir, { recursive: true, force: true });\n  } else {\n    renameSync(params.tempDir, destDir);\n  }\n\n  return { skillId: params.skillId, path: destDir };\n}\n\nfunction inferStripPrefix(primary: string): string {\n  const parts = primary.split('/').filter(Boolean);\n  if (parts.length === 1 && parts[0].toLowerCase() === 'skill.md') {\n    return '';\n  }\n  return primary.slice(0, -'SKILL.md'.length);\n}\n\n/**\n * Install or replace a skill from a zip buffer. Layout: either `SKILL.md` at archive root\n * or a single top-level folder containing `SKILL.md` (optionally nested one level).\n */\nexport function installSkillFromZip(\n  buffer: Buffer,\n  options: { skillId?: string; overwrite?: boolean },\n): { skillId: string; path: string } {\n  if (buffer.length > MAX_SKILL_ZIP_BYTES) {\n    throw new Error(`Zip exceeds maximum size (${MAX_SKILL_ZIP_BYTES} bytes)`);\n  }\n\n  const zip = new AdmZip(buffer);\n  const entries = zip\n    .getEntries()\n    .filter((e) => !e.isDirectory && e.entryName && !isIgnorableZipEntry(e.entryName));\n\n  const safeEntries = entries.filter((e) => isSafeZipPath(e.entryName));\n  if (safeEntries.length === 0) {\n    throw new Error('Zip is empty or invalid');\n  }\n\n  const names = safeEntries.map((e) => e.entryName.replace(/\\\\/g, '/'));\n  const skillMdPaths = names.filter((n) => /(^|\\/)SKILL\\.md$/i.test(n));\n  if (skillMdPaths.length === 0) {\n    throw new Error('Zip must contain at least one SKILL.md');\n  }\n\n  const shallow = skillMdPaths.filter((p) => p.split('/').filter(Boolean).length <= 2);\n  if (shallow.length === 0) {\n    throw new Error(\n      'SKILL.md is nested too deeply; use a zip with SKILL.md at archive root or one folder (e.g. my-skill/SKILL.md)',\n    );\n  }\n\n  shallow.sort((a, b) => a.length - b.length);\n  const stripPrefix = inferStripPrefix(shallow[0]);\n\n  if (stripPrefix) {\n    const prefixNorm = stripPrefix.replace(/\\\\/g, '/');\n    const outside = names.filter((n) => !n.startsWith(prefixNorm) && !isIgnorableZipEntry(n));\n    if (outside.length > 0) {\n      throw new Error(\n        `Invalid zip: expected all skill files under \"${prefixNorm.replace(/\\/$/, '')}/\", but found \"${outside[0]}\". ` +\n          'Put SKILL.md and assets in one folder, or zip that folder only.',\n      );\n    }\n  }\n\n  let targetId = options.skillId?.trim();\n  if (!targetId) {\n    if (stripPrefix) {\n      const first = stripPrefix.replace(/\\/$/, '').split('/')[0];\n      targetId = first || '';\n    }\n    if (!targetId) {\n      const skillName = shallow.find((n) => /(^|\\/)SKILL\\.md$/i.test(n)) || '';\n      const entry = zip.getEntry(skillName);\n      if (!entry) throw new Error('SKILL.md missing');\n      const raw = entry.getData().toString('utf-8');\n      const { frontmatter } = parseFrontmatter(raw);\n      targetId = String(frontmatter.name || '').trim();\n    }\n  }\n\n  if (!targetId || !isValidSkillId(targetId)) {\n    throw new Error(\n      'Could not determine skill id: use a folder named with the skill id, pass skillId, or set name: in SKILL.md (letters, digits, ._-)',\n    );\n  }\n\n  const { destDir, tempDir } = prepareManagedSkillTempDir(targetId);\n  const tempResolved = resolve(tempDir);\n  try {\n    if (existsSync(destDir) && !options.overwrite) {\n      throw new Error(`Skill \"${targetId}\" already exists. Pass overwrite to replace.`);\n    }\n\n    for (const e of safeEntries) {\n      const norm = e.entryName.replace(/\\\\/g, '/');\n      let rel: string;\n      if (stripPrefix) {\n        const prefixNorm = stripPrefix.replace(/\\\\/g, '/');\n        if (!norm.startsWith(prefixNorm)) continue;\n        rel = norm.slice(prefixNorm.length).replace(/^\\//, '');\n      } else {\n        rel = norm;\n      }\n      if (!rel || rel.includes('..')) continue;\n\n      const targetPath = join(tempDir, rel);\n      const resolvedTarget = resolve(targetPath);\n      if (!resolvedTarget.startsWith(tempResolved + sep) && resolvedTarget !== tempResolved) {\n        continue;\n      }\n      mkdirSync(dirname(targetPath), { recursive: true });\n      writeFileSync(targetPath, e.getData());\n    }\n\n    if (!existsSync(join(tempDir, 'SKILL.md'))) {\n      throw new Error('Extracted content is missing SKILL.md');\n    }\n\n    return promoteManagedSkillTempDir({\n      skillId: targetId,\n      tempDir,\n      overwrite: options.overwrite,\n    });\n  } catch (err) {\n    rmSync(tempDir, { recursive: true, force: true });\n    throw err;\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/skills/skill-manage-ops.js

@@ -2,8 +2,8 @@ import { init_paths, resolveSkillsDir } from "../../config/paths.js";
 import { parseFrontmatter } from "../../markdown/frontmatter.js";
 import { fuzzyFindText, normalizeForFuzzyMatch, normalizeToLF, restoreLineEndings } from "../tools/edit-diff.js";
 import { formatScanSummary, scanSkillDirectory } from "./scanner.js";
-import { join, resolve, sep } from "path";
 import { existsSync, realpathSync } from "fs";
+import { join, resolve, sep } from "path";
 import { mkdir, writeFile } from "fs/promises";
 //#region src/agent/skills/skill-manage-ops.ts
 /**

package/dist/src/agent/skills/skill-manager.d.ts

@@ -3,12 +3,7 @@
  *
  * Handles skill initialization, reloading, and command expansion.
  */
-import { type Skill } from './index.js';
-export interface SkillDiagnostic {
-    type: 'collision' | 'warning' | 'error' | 'info';
-    skillName: string;
-    message: string;
-}
+import type { Skill, SkillDiagnostic, SkillRuntimeStatus } from './types.js';
 export interface SkillLoadResult {
     skills: Skill[];
     prompt: string;
@@ -20,6 +15,15 @@ export declare class SkillManager {
     private skillLoader;
     private workspace;
     private bundledSkillsDir;
+    private version;
+    private loadedAt;
+    private reloadInProgress;
+    private reloadPending;
+    private lastReloadStartedAt;
+    private lastReloadFinishedAt;
+    private lastReloadReason;
+    private lastReloadOk;
+    private lastReloadError;
     constructor(workspace: string, bundledSkillsDir?: string);
     /**
      * Initialize skills from workspace and bundled directories
@@ -33,6 +37,8 @@ export declare class SkillManager {
      * Reload skills from disk
      */
     reload(): void;
+    private runReload;
+    private applyLoadResult;
     /**
      * Get the skill prompt to append to system prompt
      */
@@ -51,6 +57,10 @@ export declare class SkillManager {
      * Get all loaded skills
      */
     getSkills(): Skill[];
+    getDiagnostics(): SkillDiagnostic[];
+    getVersion(): string;
+    getLoadedAt(): number;
+    getStatus(): SkillRuntimeStatus;
     /**
      * Get skill names
      */

package/dist/src/agent/skills/skill-manager.js

@@ -1,7 +1,7 @@
 import { resolveStateDir } from "../../config/paths-state.js";
+import { init_paths, resolveBundledSkillsDir } from "../../config/paths.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { init_paths, resolveBundledSkillsDir } from "../../config/paths.js";
 import { createSkillConfigManager, isSkillEnabled } from "./config.js";
 import { formatSkillsForPrompt, selectSkillsVisibleInPrompt } from "./format-skills-prompt.js";
 import { createSkillLoader } from "./index.js";
@@ -20,6 +20,15 @@ var SkillManager = class {
 	skillLoader = createSkillLoader();
 	workspace;
 	bundledSkillsDir;
+	version = 0;
+	loadedAt = 0;
+	reloadInProgress = false;
+	reloadPending = false;
+	lastReloadStartedAt;
+	lastReloadFinishedAt;
+	lastReloadReason;
+	lastReloadOk;
+	lastReloadError;
 	constructor(workspace, bundledSkillsDir) {
 		this.workspace = workspace;
 		this.bundledSkillsDir = bundledSkillsDir || resolveBundledSkillsDir();
@@ -29,26 +38,7 @@ var SkillManager = class {
 	* Initialize skills from workspace and bundled directories
 	*/
 	initialize() {
-		const result = this.skillLoader.init(this.workspace, this.bundledSkillsDir);
-		this.skillPrompt = result.prompt;
-		this.skills = result.skills;
-		for (const diag of result.diagnostics) if (diag.type === "collision") log.warn({
-			skill: diag.skillName,
-			message: diag.message
-		}, "Skill collision");
-		else if (diag.type === "warning") log.warn({
-			skill: diag.skillName,
-			message: diag.message
-		}, "Skill warning");
-		else if (diag.type === "error") log.error({
-			skill: diag.skillName,
-			message: diag.message
-		}, "Skill error");
-		else log.info({
-			skill: diag.skillName,
-			message: diag.message
-		}, "Skill info");
-		log.debug({ count: result.skills.length }, "Skills loaded");
+		this.runReload("initial", () => this.skillLoader.init(this.workspace, this.bundledSkillsDir));
 	}
 	/**
 	* Recompute skill XML prompt from current skills.json (no disk rescan).
@@ -56,28 +46,71 @@ var SkillManager = class {
 	refreshPromptFromConfig() {
 		this.skillLoader.refreshPromptFromConfig();
 		this.skillPrompt = this.skillLoader.getPrompt();
+		this.version += 1;
+		this.loadedAt = Date.now();
+		this.lastReloadReason = "config";
+		this.lastReloadOk = true;
+		this.lastReloadError = void 0;
 	}
 	/**
 	* Reload skills from disk
 	*/
 	reload() {
-		log.info("Reloading skills...");
-		const result = this.skillLoader.reload();
+		this.runReload("disk", () => this.skillLoader.reload());
+	}
+	runReload(reason, load) {
+		if (this.reloadInProgress) {
+			this.reloadPending = true;
+			return;
+		}
+		do {
+			this.reloadPending = false;
+			this.reloadInProgress = true;
+			this.lastReloadStartedAt = Date.now();
+			this.lastReloadReason = reason;
+			try {
+				const result = load();
+				this.applyLoadResult(result);
+				this.lastReloadOk = true;
+				this.lastReloadError = void 0;
+				log.info({
+					count: result.skills.length,
+					version: this.version
+				}, "Skills reloaded");
+			} catch (err) {
+				const errorMessage = err instanceof Error ? err.message : String(err);
+				this.lastReloadOk = false;
+				this.lastReloadError = errorMessage;
+				log.error({
+					err,
+					errorMessage
+				}, `Skills reload failed: ${errorMessage}`);
+			} finally {
+				this.lastReloadFinishedAt = Date.now();
+				this.reloadInProgress = false;
+			}
+		} while (this.reloadPending);
+	}
+	applyLoadResult(result) {
 		this.skillPrompt = result.prompt;
 		this.skills = result.skills;
+		this.version += 1;
+		this.loadedAt = Date.now();
 		for (const diag of result.diagnostics) if (diag.type === "collision") log.warn({
 			skill: diag.skillName,
+			path: diag.path,
 			message: diag.message
 		}, "Skill collision");
 		else if (diag.type === "warning") log.warn({
 			skill: diag.skillName,
+			path: diag.path,
 			message: diag.message
 		}, "Skill warning");
 		else if (diag.type === "error") log.error({
 			skill: diag.skillName,
+			path: diag.path,
 			message: diag.message
 		}, "Skill error");
-		log.info({ count: result.skills.length }, "Skills reloaded");
 	}
 	/**
 	* Get the skill prompt to append to system prompt
@@ -108,6 +141,28 @@ var SkillManager = class {
 	getSkills() {
 		return [...this.skills];
 	}
+	getDiagnostics() {
+		return this.skillLoader.getDiagnostics();
+	}
+	getVersion() {
+		return String(this.version);
+	}
+	getLoadedAt() {
+		return this.loadedAt;
+	}
+	getStatus() {
+		return {
+			version: this.getVersion(),
+			loadedAt: this.loadedAt,
+			reloadInProgress: this.reloadInProgress,
+			reloadPending: this.reloadPending,
+			...this.lastReloadStartedAt !== void 0 ? { lastReloadStartedAt: this.lastReloadStartedAt } : {},
+			...this.lastReloadFinishedAt !== void 0 ? { lastReloadFinishedAt: this.lastReloadFinishedAt } : {},
+			...this.lastReloadReason !== void 0 ? { lastReloadReason: this.lastReloadReason } : {},
+			...this.lastReloadOk !== void 0 ? { lastReloadOk: this.lastReloadOk } : {},
+			...this.lastReloadError !== void 0 ? { lastReloadError: this.lastReloadError } : {}
+		};
+	}
 	/**
 	* Get skill names
 	*/