uilint 0.2.44 → 0.2.46

package/dist/{plan-N453UW4O.js → plan-ZWGKTWQ3.js}

@@ -3,7 +3,7 @@ import {
   GENSTYLEGUIDE_COMMAND_MD,
   loadSkill,
   toInstallSpecifier
-} from "./chunk-TWUDB36F.js";
+} from "./chunk-VSBVUS56.js";
 import {
   loadSelectedRules
 } from "./chunk-Y7ZNZFVZ.js";
@@ -11,7 +11,7 @@ import {
   detectPackageManager
 } from "./chunk-JPE27ROY.js";
 
-// src/commands/install/plan.ts
+// src/commands/init/plan.ts
 import { join } from "path";
 function createPlan(state, choices, options = {}) {
   const actions = [];
@@ -256,4 +256,4 @@ export {
   createPlan,
   getMissingRules
 };
-//# sourceMappingURL=plan-N453UW4O.js.map
+//# sourceMappingURL=plan-ZWGKTWQ3.js.map

package/dist/plan-ZWGKTWQ3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/init/plan.ts"],"sourcesContent":["/**\n * Plan phase - pure function generating InstallPlan from state + choices\n *\n * This function has NO I/O whatsoever. It takes the analyzed ProjectState,\n * user choices, and options, then returns an InstallPlan describing exactly\n * what actions to take.\n */\n\nimport { join } from \"path\";\nimport type { RuleMetadata } from \"uilint-eslint\";\nimport type {\n  ProjectState,\n  UserChoices,\n  InstallPlan,\n  InstallAction,\n  DependencyInstall,\n  PlanOptions,\n} from \"./types.js\";\nimport { GENSTYLEGUIDE_COMMAND_MD } from \"./constants.js\";\nimport { toInstallSpecifier } from \"./versioning.js\";\nimport { loadSkill } from \"../../utils/skill-loader.js\";\nimport { loadSelectedRules } from \"../../utils/rule-loader.js\";\nimport { detectPackageManager } from \"../../utils/package-manager.js\";\n\n/**\n * Create the install plan from project state and user choices\n *\n * @param state - The analyzed project state\n * @param choices - User's installation choices\n * @param options - Planning options (force, etc.)\n * @returns InstallPlan with all actions and dependencies\n */\nexport function createPlan(\n  state: ProjectState,\n  choices: UserChoices,\n  options: PlanOptions = {}\n): InstallPlan {\n  const actions: InstallAction[] = [];\n  const dependencies: DependencyInstall[] = [];\n\n  const { force = false } = options;\n  const { items } = choices;\n\n  // Ensure .cursor directory exists if needed\n  const needsCursorDir =\n    items.includes(\"genstyleguide\") || items.includes(\"skill\");\n\n  if (needsCursorDir && !state.cursorDir.exists) {\n    actions.push({\n      type: \"create_directory\",\n      path: state.cursorDir.path,\n    });\n  }\n\n  // =========================================================================\n  // Genstyleguide Command\n  // =========================================================================\n  if (items.includes(\"genstyleguide\")) {\n    const commandsDir = join(state.cursorDir.path, \"commands\");\n\n    actions.push({\n      type: \"create_directory\",\n      path: commandsDir,\n    });\n\n    actions.push({\n      type: \"create_file\",\n      path: join(commandsDir, \"genstyleguide.md\"),\n      content: GENSTYLEGUIDE_COMMAND_MD,\n    });\n  }\n\n  // =========================================================================\n  // Agent Skill Installation\n  // =========================================================================\n  if (items.includes(\"skill\")) {\n    const skillsDir = join(state.cursorDir.path, \"skills\");\n\n    // Create skills directory\n    actions.push({\n      type: \"create_directory\",\n      path: skillsDir,\n    });\n\n    // Load and install the ui-consistency-enforcer skill\n    try {\n      const skill = loadSkill(\"ui-consistency-enforcer\");\n      const skillDir = join(skillsDir, skill.name);\n\n      // Create skill directory\n      actions.push({\n        type: \"create_directory\",\n        path: skillDir,\n      });\n\n      // Create all skill files\n      for (const file of skill.files) {\n        const filePath = join(skillDir, file.relativePath);\n\n        // Ensure subdirectories exist (e.g., references/)\n        const fileDir = join(\n          skillDir,\n          file.relativePath.split(\"/\").slice(0, -1).join(\"/\")\n        );\n        if (fileDir !== skillDir && file.relativePath.includes(\"/\")) {\n          actions.push({\n            type: \"create_directory\",\n            path: fileDir,\n          });\n        }\n\n        actions.push({\n          type: \"create_file\",\n          path: filePath,\n          content: file.content,\n        });\n      }\n    } catch {\n      // Skill not found - skip silently (shouldn't happen in normal install)\n    }\n  }\n\n  // =========================================================================\n  // Next.js Overlay Installation\n  // =========================================================================\n  if (items.includes(\"next\") && choices.next) {\n    const { projectPath, detection, targetFile, createProviders } =\n      choices.next;\n\n    // Install Next.js routes\n    actions.push({\n      type: \"install_next_routes\",\n      projectPath,\n      appRoot: detection.appRoot,\n    });\n\n    // Install React overlay dependencies using the package manager for this specific target\n    dependencies.push({\n      packagePath: projectPath,\n      packageManager: detectPackageManager(projectPath),\n      packages: [\n        toInstallSpecifier(\"uilint-react\", {\n          preferWorkspaceProtocol: state.packageManager === \"pnpm\",\n          workspaceRoot: state.workspaceRoot,\n          targetProjectPath: projectPath,\n        }),\n        toInstallSpecifier(\"uilint-core\", {\n          preferWorkspaceProtocol: state.packageManager === \"pnpm\",\n          workspaceRoot: state.workspaceRoot,\n          targetProjectPath: projectPath,\n        }),\n        \"jsx-loc-plugin\",\n      ],\n    });\n\n    // Inject <uilint-devtools /> web component into React\n    // Use targetFile or createProviders if specified by the user\n    actions.push({\n      type: \"inject_react\",\n      projectPath,\n      appRoot: detection.appRoot,\n      targetFile,\n      createProviders,\n    });\n\n    // Inject jsx-loc-plugin into next.config\n    actions.push({\n      type: \"inject_next_config\",\n      projectPath,\n    });\n  }\n\n  // =========================================================================\n  // Vite Overlay Installation\n  // =========================================================================\n  if (items.includes(\"vite\") && choices.vite) {\n    const { projectPath, detection } = choices.vite;\n\n    // Install React overlay dependencies using the package manager for this specific target\n    dependencies.push({\n      packagePath: projectPath,\n      packageManager: detectPackageManager(projectPath),\n      packages: [\n        toInstallSpecifier(\"uilint-react\", {\n          preferWorkspaceProtocol: state.packageManager === \"pnpm\",\n          workspaceRoot: state.workspaceRoot,\n          targetProjectPath: projectPath,\n        }),\n        toInstallSpecifier(\"uilint-core\", {\n          preferWorkspaceProtocol: state.packageManager === \"pnpm\",\n          workspaceRoot: state.workspaceRoot,\n          targetProjectPath: projectPath,\n        }),\n        \"jsx-loc-plugin\",\n      ],\n    });\n\n    // Inject <uilint-devtools /> web component into React entry\n    actions.push({\n      type: \"inject_react\",\n      projectPath,\n      appRoot: detection.entryRoot,\n      mode: \"vite\",\n    });\n\n    // Inject jsx-loc-plugin into vite.config\n    actions.push({\n      type: \"inject_vite_config\",\n      projectPath,\n    });\n  }\n\n  // =========================================================================\n  // ESLint Plugin Installation\n  // =========================================================================\n  if (items.includes(\"eslint\") && choices.eslint) {\n    const { packagePaths, selectedRules } = choices.eslint;\n\n    for (const pkgPath of packagePaths) {\n      const pkgInfo = state.packages.find((p) => p.path === pkgPath);\n\n      // Create .uilint/rules directory alongside the target app (not at workspace root)\n      const rulesDir = join(pkgPath, \".uilint\", \"rules\");\n      actions.push({\n        type: \"create_directory\",\n        path: rulesDir,\n      });\n\n      // Load and copy rule files into this target package\n      // Use TypeScript rule files if the ESLint config is TypeScript (.ts)\n      // This ensures the imports match the actual rule files being copied\n      const isTypeScriptConfig =\n        pkgInfo?.eslintConfigPath?.endsWith(\".ts\") ?? false;\n      const ruleFiles = loadSelectedRules(\n        selectedRules.map((r) => r.id),\n        {\n          typescript: isTypeScriptConfig,\n        }\n      );\n      for (const ruleFile of ruleFiles) {\n        // For directory-based rules, create the directory structure first\n        if (ruleFile.additionalFiles && ruleFile.additionalFiles.length > 0) {\n          // Create rule directory (e.g., .uilint/rules/no-mixed-component-libraries/)\n          const ruleDir = join(rulesDir, ruleFile.ruleId);\n          actions.push({\n            type: \"create_directory\",\n            path: ruleDir,\n          });\n\n          // Create lib/ subdirectory if any files are in lib/\n          const hasLibFiles = ruleFile.additionalFiles.some((f) =>\n            f.relativePath.includes(\"/lib/\")\n          );\n          if (hasLibFiles) {\n            actions.push({\n              type: \"create_directory\",\n              path: join(ruleDir, \"lib\"),\n            });\n          }\n        }\n\n        // Copy implementation file\n        actions.push({\n          type: \"create_file\",\n          path: join(rulesDir, ruleFile.implementation.relativePath),\n          content: ruleFile.implementation.content,\n        });\n\n        // Copy additional files for directory-based rules\n        if (ruleFile.additionalFiles) {\n          for (const additionalFile of ruleFile.additionalFiles) {\n            actions.push({\n              type: \"create_file\",\n              path: join(rulesDir, additionalFile.relativePath),\n              content: additionalFile.content,\n            });\n          }\n        }\n\n        // Copy test file if it exists (only for TypeScript configs)\n        if (ruleFile.test && isTypeScriptConfig) {\n          actions.push({\n            type: \"create_file\",\n            path: join(rulesDir, ruleFile.test.relativePath),\n            content: ruleFile.test.content,\n          });\n        }\n      }\n\n      // Install dependencies using the package manager for this specific target\n      const packagesToInstall = [\n        toInstallSpecifier(\"uilint-eslint\", {\n          preferWorkspaceProtocol: state.packageManager === \"pnpm\",\n          workspaceRoot: state.workspaceRoot,\n          targetProjectPath: pkgPath,\n        }),\n        \"typescript-eslint\",\n      ];\n\n      // If require-test-coverage rule is selected, add coverage package and config\n      const hasCoverageRule = selectedRules.some(\n        (r) => r.id === \"require-test-coverage\"\n      );\n      if (hasCoverageRule) {\n        packagesToInstall.push(\"@vitest/coverage-v8\");\n\n        // Add action to inject coverage config into vitest.config.ts\n        actions.push({\n          type: \"inject_vitest_coverage\",\n          projectPath: pkgPath,\n        });\n      }\n\n      dependencies.push({\n        packagePath: pkgPath,\n        packageManager: detectPackageManager(pkgPath),\n        packages: packagesToInstall,\n      });\n\n      // Inject ESLint rules (will reference local .uilint/rules/ files)\n      if (pkgInfo?.eslintConfigPath) {\n        actions.push({\n          type: \"inject_eslint\",\n          packagePath: pkgPath,\n          configPath: pkgInfo.eslintConfigPath,\n          rules: selectedRules,\n          hasExistingRules: pkgInfo.hasUilintRules,\n        });\n      }\n\n      // Add .uilint to tsconfig.json exclude to prevent build errors\n      // The rule files are loaded by ESLint at runtime, not compiled with the app\n      actions.push({\n        type: \"inject_tsconfig\",\n        projectPath: pkgPath,\n      });\n\n      // Update manifest with installed rule versions\n      const ruleVersions: Record<string, string> = {};\n      for (const rule of selectedRules) {\n        // Use version from RuleMeta, default to \"1.0.0\" if not specified\n        ruleVersions[rule.id] = rule.version ?? \"1.0.0\";\n      }\n      actions.push({\n        type: \"update_manifest\",\n        projectPath: pkgPath,\n        rules: ruleVersions,\n      });\n    }\n\n    // Add .uilint/.cache to .gitignore at workspace root\n    const gitignorePath = join(state.workspaceRoot, \".gitignore\");\n    actions.push({\n      type: \"append_to_file\",\n      path: gitignorePath,\n      content: \"\\n# UILint cache\\n.uilint/.cache\\n\",\n      ifNotContains: \".uilint/.cache\",\n    });\n  }\n\n  return { actions, dependencies };\n}\n\n/**\n * Get the list of rules that are missing from a package's ESLint config\n */\nexport function getMissingRules(\n  configuredRuleIds: string[],\n  selectedRules: RuleMetadata[]\n): RuleMetadata[] {\n  const configuredSet = new Set(configuredRuleIds);\n  return selectedRules.filter((rule) => !configuredSet.has(rule.id));\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uilint",
-  "version": "0.2.44",
+  "version": "0.2.46",
   "description": "CLI for UILint - AI-powered UI consistency checking",
   "author": "Peter Suggate",
   "repository": {
@@ -48,9 +48,9 @@
     "react": "^19.2.3",
     "typescript": "^5.9.3",
     "ws": "^8.19.0",
-    "uilint-core": "0.2.44",
-    "uilint-duplicates": "0.2.44",
-    "uilint-eslint": "0.2.44"
+    "uilint-core": "0.2.46",
+    "uilint-eslint": "0.2.46",
+    "uilint-duplicates": "0.2.46"
   },
   "optionalDependencies": {
     "@langfuse/client": "^4.5.1",
@@ -66,7 +66,7 @@
     "ink-testing-library": "^4.0.0",
     "tsup": "^8.5.1",
     "vitest": "^4.0.17",
-    "uilint-react": "0.2.44"
+    "uilint-react": "0.2.46"
   },
   "keywords": [
     "cli",

package/skills/ui-consistency-enforcer/references/REGISTRY-ENTRY.md

@@ -159,5 +159,5 @@ Here's a complete registry entry for a rule that enforces design system buttons:
 ## After Adding Entry
 
 1. Run `pnpm -C packages/uilint-eslint generate:index` to regenerate the index
-2. The rule will now appear in `uilint install` prompts
-3. Users can configure it interactively during installation
+2. The rule will now appear in `uilint init` prompts
+3. Users can configure it interactively during initialization

package/dist/chunk-TWUDB36F.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/install/versioning.ts","../src/commands/install/constants.ts","../src/utils/skill-loader.ts"],"sourcesContent":["import { createRequire } from \"module\";\nimport { existsSync, readFileSync } from \"fs\";\nimport { join } from \"path\";\n\nconst require = createRequire(import.meta.url);\n\nexport interface ToInstallSpecifierOptions {\n  /**\n   * When true, prefer pnpm workspace protocol for internal packages so local\n   * monorepo installs always link the latest workspace version.\n   */\n  preferWorkspaceProtocol?: boolean;\n  /** Workspace root (used for pnpm-workspace detection) */\n  workspaceRoot?: string;\n  /** Target project path (used to ensure target is within workspace) */\n  targetProjectPath?: string;\n}\n\nfunction isWithinDir(childPath: string, parentPath: string): boolean {\n  const parent = parentPath.endsWith(\"/\") ? parentPath : parentPath + \"/\";\n  return childPath === parentPath || childPath.startsWith(parent);\n}\n\nfunction isPnpmWorkspaceRoot(dir: string | undefined): boolean {\n  if (!dir) return false;\n  return existsSync(join(dir, \"pnpm-workspace.yaml\"));\n}\n\nfunction workspaceHasPackage(\n  workspaceRoot: string | undefined,\n  pkgName: string\n): boolean {\n  if (!workspaceRoot) return false;\n  // In this repo, workspace packages live under /packages/<name>/package.json\n  return existsSync(join(workspaceRoot, \"packages\", pkgName, \"package.json\"));\n}\n\nfunction tryReadInstalledVersion(pkgName: string): string | null {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n    const depPkg = require(`${pkgName}/package.json`) as Record<\n      string,\n      unknown\n    >;\n    const v = depPkg?.version;\n    return typeof v === \"string\" ? v : null;\n  } catch {\n    // Fallback: try filesystem relative to this package (best-effort)\n    try {\n      const p = require.resolve(`${pkgName}/package.json`);\n      const raw = readFileSync(p, \"utf-8\");\n      const parsed = JSON.parse(raw) as { version?: string };\n      return typeof parsed.version === \"string\" ? parsed.version : null;\n    } catch {\n      return null;\n    }\n  }\n}\n\n/**\n * Get the version range for a dependency from uilint's package.json\n *\n * Note: We also check devDependencies so we can expose install-time version\n * ranges (e.g. for uilint-react) without forcing them to be runtime deps of the CLI.\n */\nexport function getSelfDependencyVersionRange(pkgName: string): string | null {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n    const pkgJson = require(\"uilint/package.json\") as Record<string, unknown>;\n    const deps = pkgJson?.dependencies as Record<string, string> | undefined;\n    const optDeps = pkgJson?.optionalDependencies as\n      | Record<string, string>\n      | undefined;\n    const peerDeps = pkgJson?.peerDependencies as\n      | Record<string, string>\n      | undefined;\n    const devDeps = pkgJson?.devDependencies as\n      | Record<string, string>\n      | undefined;\n\n    const v =\n      deps?.[pkgName] ??\n      optDeps?.[pkgName] ??\n      peerDeps?.[pkgName] ??\n      devDeps?.[pkgName];\n    return typeof v === \"string\" ? v : null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Convert package name to install specifier with version (when possible)\n */\nexport function toInstallSpecifier(\n  pkgName: string,\n  options: ToInstallSpecifierOptions = {}\n): string {\n  const { preferWorkspaceProtocol, workspaceRoot, targetProjectPath } = options;\n\n  // Local monorepo: force workspace protocol for internal packages.\n  if (\n    preferWorkspaceProtocol &&\n    isPnpmWorkspaceRoot(workspaceRoot) &&\n    typeof targetProjectPath === \"string\" &&\n    isWithinDir(targetProjectPath, workspaceRoot || \"\") &&\n    workspaceHasPackage(workspaceRoot, pkgName)\n  ) {\n    return `${pkgName}@workspace:*`;\n  }\n\n  const range = getSelfDependencyVersionRange(pkgName);\n  if (!range) return pkgName;\n  if (range.startsWith(\"workspace:\")) {\n    // In published builds, pnpm usually rewrites workspace: to a semver range.\n    // But if it doesn't, fall back to the actually installed dependency version.\n    const installed = tryReadInstalledVersion(pkgName);\n    return installed ? `${pkgName}@^${installed}` : pkgName;\n  }\n  if (range.startsWith(\"file:\")) return pkgName;\n  if (range.startsWith(\"link:\")) return pkgName;\n  return `${pkgName}@${range}`;\n}\n","/**\n * Constants for the install command\n *\n * Contains file content templates for commands.\n */\n\n// ============================================================================\n// Cursor Commands\n// ============================================================================\n\nexport const GENSTYLEGUIDE_COMMAND_MD = `# React Style Guide Generator\n\nAnalyze the React UI codebase to produce a **prescriptive, semantic** style guide. Focus on consistency, intent, and relationships—not specific values.\n\n## Philosophy\n\n1. **Identify the intended architecture** from the best patterns in use\n2. **Prescribe semantic rules** — about consistency and relationships, not pixels\n3. **Stay general** — \"primary buttons should be visually consistent\" not \"buttons use px-4\"\n4. **Focus on intent** — what should FEEL the same, not what values to use\n\n## Analysis Steps\n\n### 1. Detect the Stack\n- Framework: Next.js (App Router? Pages?), Vite, CRA\n- Component system: shadcn, MUI, Chakra, Radix, custom\n- Styling: Tailwind, CSS Modules, styled-components\n- Forms: react-hook-form, Formik, native\n- State: React context, Zustand, Redux, Jotai\n\n### 2. Identify Best Patterns\nExamine the **best-written** components. Look at:\n- \\`components/ui/*\\` — the design system\n- Recently modified files — current standards\n- Shared layouts — structural patterns\n\n### 3. Infer Visual Hierarchy & Intent\nUnderstand the design language:\n- What distinguishes primary vs secondary actions?\n- How is visual hierarchy established?\n- What creates consistency across similar elements?\n\n## Output Format\n\nGenerate at \\`<nextjs app root>/.uilint/styleguide.md\\`:\n\\`\\`\\`yaml\n# Stack\nframework: \nstyling: \ncomponents: \ncomponent_path: \nforms: \n\n# Component Usage (MUST use these)\nuse:\n  buttons: \n  inputs: \n  modals: \n  cards: \n  feedback: \n  icons: \n  links: \n\n# Semantic Rules (consistency & relationships)\nsemantics:\n  hierarchy:\n    - <e.g., \"primary actions must be visually distinct from secondary\">\n    - <e.g., \"destructive actions should be visually cautionary\">\n    - <e.g., \"page titles should be visually heavier than section titles\">\n  consistency:\n    - <e.g., \"all primary buttons should share the same visual weight\">\n    - <e.g., \"form inputs should have uniform height and padding\">\n    - <e.g., \"card padding should be consistent across the app\">\n    - <e.g., \"interactive elements should have consistent hover/focus states\">\n  spacing:\n    - <e.g., \"use the spacing scale — no arbitrary values\">\n    - <e.g., \"related elements should be closer than unrelated\">\n    - <e.g., \"section spacing should be larger than element spacing\">\n  layout:\n    - <e.g., \"use gap for sibling spacing, not margin\">\n    - <e.g., \"containers should have consistent max-width and padding\">\n\n# Patterns (structural, not values)\npatterns:\n  forms: <e.g., \"FormField + Controller + zod schema\">\n  conditionals: <e.g., \"cn() for class merging\">\n  loading: <e.g., \"Skeleton for content, Spinner for actions\">\n  errors: <e.g., \"ErrorBoundary at route, inline for forms\">\n  responsive: <e.g., \"mobile-first, standard breakpoints only\">\n\n# Component Authoring\nauthoring:\n  - <e.g., \"forwardRef for interactive components\">\n  - <e.g., \"variants via CVA or component props, not className overrides\">\n  - <e.g., \"extract when used 2+ times\">\n  - <e.g., \"'use client' only when needed\">\n\n# Forbidden\nforbidden:\n  - <e.g., \"inline style={{}}\">\n  - <e.g., \"raw HTML elements when component exists\">\n  - <e.g., \"arbitrary values — use scale\">\n  - <e.g., \"className overrides that break visual consistency\">\n  - <e.g., \"one-off spacing that doesn't match siblings\">\n\n# Legacy (if migration in progress)\nlegacy:\n  - <e.g., \"old: CSS modules → new: Tailwind\">\n  - <e.g., \"old: Formik → new: react-hook-form\">\n\n# Conventions\nconventions:\n  - \n  - \n  - \n\\`\\`\\`\n\n## Rules\n\n- **Semantic over specific**: \"consistent padding\" not \"p-4\"\n- **Relationships over absolutes**: \"heavier than\" not \"font-bold\"\n- **Intent over implementation**: \"visually distinct\" not \"blue background\"\n- **Prescriptive**: Define target state, not current state\n- **Terse**: No prose. Fragments and short phrases only.\n- **Actionable**: Every rule should be human-verifiable\n- **Omit if N/A**: Skip sections that don't apply\n- **Max 5 items** per section — highest impact only\n`;\n\n","/**\n * Skill Loader Utility\n *\n * Loads Agent Skill files from the bundled skills directory for installation\n * into user projects. Skills follow the Agent Skills specification\n * (agentskills.io).\n */\n\nimport { readFileSync, readdirSync, statSync, existsSync } from \"fs\";\nimport { join, dirname, relative } from \"path\";\nimport { fileURLToPath } from \"url\";\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\n/**\n * Represents a file in a skill directory\n */\nexport interface SkillFile {\n  /** Relative path within the skill directory */\n  relativePath: string;\n  /** File content */\n  content: string;\n}\n\n/**\n * Represents a complete skill ready for installation\n */\nexport interface Skill {\n  /** Skill name (directory name) */\n  name: string;\n  /** All files in the skill */\n  files: SkillFile[];\n}\n\n/**\n * Get the path to the bundled skills directory\n */\nfunction getSkillsDir(): string {\n  // In development: packages/uilint/skills/\n  // In production (installed): node_modules/uilint/dist/ -> ../skills/\n  const devPath = join(__dirname, \"..\", \"..\", \"skills\");\n  const prodPath = join(__dirname, \"..\", \"skills\");\n\n  if (existsSync(devPath)) {\n    return devPath;\n  }\n  if (existsSync(prodPath)) {\n    return prodPath;\n  }\n\n  throw new Error(\n    \"Could not find skills directory. This is a bug in uilint installation.\"\n  );\n}\n\n/**\n * Recursively collect all files in a directory\n */\nfunction collectFiles(dir: string, baseDir: string): SkillFile[] {\n  const files: SkillFile[] = [];\n  const entries = readdirSync(dir);\n\n  for (const entry of entries) {\n    const fullPath = join(dir, entry);\n    const stat = statSync(fullPath);\n\n    if (stat.isDirectory()) {\n      files.push(...collectFiles(fullPath, baseDir));\n    } else if (stat.isFile()) {\n      const relativePath = relative(baseDir, fullPath);\n      const content = readFileSync(fullPath, \"utf-8\");\n      files.push({ relativePath, content });\n    }\n  }\n\n  return files;\n}\n\n/**\n * Load a specific skill by name\n */\nexport function loadSkill(name: string): Skill {\n  const skillsDir = getSkillsDir();\n  const skillDir = join(skillsDir, name);\n\n  if (!existsSync(skillDir)) {\n    throw new Error(`Skill \"${name}\" not found in ${skillsDir}`);\n  }\n\n  const skillMdPath = join(skillDir, \"SKILL.md\");\n  if (!existsSync(skillMdPath)) {\n    throw new Error(`Skill \"${name}\" is missing SKILL.md`);\n  }\n\n  const files = collectFiles(skillDir, skillDir);\n\n  return { name, files };\n}\n\n/**\n * Load all available skills\n */\nexport function loadAllSkills(): Skill[] {\n  const skillsDir = getSkillsDir();\n  const entries = readdirSync(skillsDir);\n  const skills: Skill[] = [];\n\n  for (const entry of entries) {\n    const skillDir = join(skillsDir, entry);\n    const stat = statSync(skillDir);\n\n    if (stat.isDirectory()) {\n      const skillMdPath = join(skillDir, \"SKILL.md\");\n      if (existsSync(skillMdPath)) {\n        skills.push(loadSkill(entry));\n      }\n    }\n  }\n\n  return skills;\n}\n\n/**\n * Get the list of available skill names\n */\nexport function getAvailableSkillNames(): string[] {\n  const skillsDir = getSkillsDir();\n  const entries = readdirSync(skillsDir);\n  const names: string[] = [];\n\n  for (const entry of entries) {\n    const skillDir = join(skillsDir, entry);\n    const stat = statSync(skillDir);\n\n    if (stat.isDirectory()) {\n      const skillMdPath = join(skillDir, \"SKILL.md\");\n      if (existsSync(skillMdPath)) {\n        names.push(entry);\n      }\n    }\n  }\n\n  return names;\n}\n"],"mappings":"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","names":["require","readFileSync","existsSync","join"]}