@agents-inc/cli 0.47.0 → 0.50.0

package/dist/commands/validate.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli/commands/validate.ts","../../src/cli/lib/schema-validator.ts","../../src/cli/lib/source-validator.ts"],"sourcesContent":["import { Args, Flags } from \"@oclif/core\";\nimport path from \"path\";\nimport { BaseCommand } from \"../base-command.js\";\nimport { getErrorMessage } from \"../utils/errors.js\";\nimport { EXIT_CODES } from \"../lib/exit-codes.js\";\nimport { ERROR_MESSAGES } from \"../utils/messages.js\";\nimport { validateAllSchemas, printValidationResults } from \"../lib/schema-validator.js\";\nimport {\n  validatePlugin,\n  validateAllPlugins,\n  printPluginValidationResult,\n} from \"../lib/plugins/index.js\";\nimport { validateSource } from \"../lib/source-validator.js\";\n\nexport default class Validate extends BaseCommand {\n  static summary =\n    \"Validate YAML files against schemas, validate compiled plugins, or validate a skills source\";\n  static description =\n    \"Validates skill/agent YAML files against JSON schemas, validates compiled plugin structure and content, \" +\n    \"or validates a skills source repository for metadata correctness. \" +\n    \"Without arguments, validates all YAML files in the current directory against their schemas. \" +\n    \"With --source, validates all skills in the source for schema compliance, cross-references, and conventions. \" +\n    \"With a path argument or --plugins flag, validates plugin(s) instead.\";\n\n  static examples = [\n    {\n      description: \"Validate all YAML schemas\",\n      command: \"<%= config.bin %> <%= command.id %>\",\n    },\n    {\n      description: \"Validate a skills source repository\",\n      command: \"<%= config.bin %> <%= command.id %> --source .\",\n    },\n    {\n      description: \"Validate a remote skills source\",\n      command: \"<%= config.bin %> <%= command.id %> --source github:acme-corp/skills\",\n    },\n    {\n      description: \"Validate a specific plugin\",\n      command: \"<%= config.bin %> <%= command.id %> ./path/to/plugin\",\n    },\n    {\n      description: \"Validate all plugins in a directory\",\n      command: \"<%= config.bin %> <%= command.id %> ./plugins --all\",\n    },\n    {\n      description: \"Validate plugins with verbose output\",\n      command: \"<%= config.bin %> <%= command.id %> --plugins --verbose\",\n    },\n  ];\n\n  static args = {\n    path: Args.string({\n      description: \"Path to plugin or plugins directory to validate\",\n      required: false,\n    }),\n  };\n\n  static flags = {\n    ...BaseCommand.baseFlags,\n    verbose: Flags.boolean({\n      char: \"v\",\n      description: \"Enable verbose logging\",\n      default: false,\n    }),\n    all: Flags.boolean({\n      char: \"a\",\n      description: \"Validate all plugins in directory\",\n      default: false,\n    }),\n    plugins: Flags.boolean({\n      char: \"p\",\n      description: \"Validate plugins instead of schemas\",\n      default: false,\n    }),\n  };\n\n  async run(): Promise<void> {\n    const { args, flags } = await this.parse(Validate);\n\n    if (flags.source) {\n      await this.validateSkillsSource(flags.source);\n    } else if (args.path || flags.plugins) {\n      await this.validatePlugins(args.path, flags.verbose, flags.all);\n    } else {\n      await this.validateSchemas();\n    }\n  }\n\n  private async validateSchemas(): Promise<void> {\n    this.log(\"\");\n    this.log(\"Validating all schemas\");\n    this.log(\"\");\n\n    try {\n      const result = await validateAllSchemas();\n\n      const summary = result.valid\n        ? `Done: ${result.summary.validFiles}/${result.summary.totalFiles} files valid`\n        : `Done: ${result.summary.invalidFiles} invalid files`;\n\n      this.log(summary);\n      printValidationResults(result);\n\n      if (!result.valid) {\n        this.exit(EXIT_CODES.ERROR);\n      }\n    } catch (error) {\n      const message = getErrorMessage(error);\n      this.error(`${ERROR_MESSAGES.VALIDATION_FAILED}: ${message}`, { exit: EXIT_CODES.ERROR });\n    }\n  }\n\n  private async validatePlugins(\n    pluginPath: string | undefined,\n    verbose: boolean,\n    all: boolean,\n  ): Promise<void> {\n    const targetPath = pluginPath ? path.resolve(pluginPath) : process.cwd();\n\n    if (all) {\n      await this.validateAllPluginsInDirectory(targetPath, verbose);\n    } else {\n      await this.validateSinglePlugin(targetPath, verbose);\n    }\n  }\n\n  private async validateAllPluginsInDirectory(targetPath: string, verbose: boolean): Promise<void> {\n    this.log(\"\");\n    this.log(`Validating all plugins in: ${targetPath}`);\n    this.log(\"\");\n\n    try {\n      const result = await validateAllPlugins(targetPath);\n\n      const summary = result.valid\n        ? `Done: ${result.summary.valid}/${result.summary.total} plugins valid`\n        : `Done: ${result.summary.invalid} invalid plugins`;\n\n      this.log(summary);\n\n      this.log(\"\");\n      this.log(\"  Plugin Validation Summary:\");\n      this.log(\"  -------------------------\");\n      this.log(`  Total plugins: ${result.summary.total}`);\n      this.log(`  Valid: ${result.summary.valid}`);\n      this.log(`  Invalid: ${result.summary.invalid}`);\n      this.log(`  With warnings: ${result.summary.withWarnings}`);\n\n      for (const { name, result: pluginResult } of result.results) {\n        printPluginValidationResult(name, pluginResult, verbose);\n      }\n\n      if (result.valid) {\n        this.log(\"\");\n        this.logSuccess(\"All plugins validated successfully\");\n        this.log(\"\");\n      } else {\n        this.log(\"\");\n        this.error(ERROR_MESSAGES.VALIDATION_FAILED, { exit: EXIT_CODES.ERROR });\n      }\n    } catch (error) {\n      const message = getErrorMessage(error);\n      this.error(`${ERROR_MESSAGES.VALIDATION_FAILED}: ${message}`, { exit: EXIT_CODES.ERROR });\n    }\n  }\n\n  private async validateSinglePlugin(targetPath: string, _verbose: boolean): Promise<void> {\n    this.log(\"\");\n    this.log(`Validating plugin: ${targetPath}`);\n    this.log(\"\");\n\n    try {\n      const result = await validatePlugin(targetPath);\n\n      const summary = result.valid ? \"Done: Plugin is valid\" : \"Done: Plugin has errors\";\n\n      this.log(summary);\n\n      printPluginValidationResult(path.basename(targetPath), result, true);\n\n      if (result.valid && result.warnings.length === 0) {\n        this.log(\"\");\n        this.logSuccess(\"Plugin validated successfully\");\n        this.log(\"\");\n      } else if (result.valid) {\n        this.log(\"\");\n        this.logWarning(\"Plugin valid with warnings\");\n        this.log(\"\");\n      } else {\n        this.log(\"\");\n        this.error(ERROR_MESSAGES.VALIDATION_FAILED, { exit: EXIT_CODES.ERROR });\n      }\n    } catch (error) {\n      const message = getErrorMessage(error);\n      this.error(`${ERROR_MESSAGES.VALIDATION_FAILED}: ${message}`, { exit: EXIT_CODES.ERROR });\n    }\n  }\n\n  private async validateSkillsSource(source: string): Promise<void> {\n    this.log(\"\");\n    this.log(`Validating source: ${source}`);\n    this.log(\"\");\n\n    try {\n      const result = await validateSource(source);\n\n      this.log(`Checked ${result.skillCount} skill(s)`);\n      this.log(\"\");\n\n      for (const issue of result.issues) {\n        const prefix = issue.severity === \"error\" ? \"ERROR\" : \"WARN\";\n        this.log(`  [${prefix}] ${issue.file}: ${issue.message}`);\n      }\n\n      if (result.issues.length > 0) {\n        this.log(\"\");\n      }\n\n      this.log(`Result: ${result.errorCount} error(s), ${result.warningCount} warning(s)`);\n\n      if (result.errorCount > 0) {\n        this.log(\"\");\n        this.error(ERROR_MESSAGES.VALIDATION_FAILED, { exit: EXIT_CODES.ERROR });\n      } else if (result.warningCount > 0) {\n        this.log(\"\");\n        this.logWarning(\"Source valid with warnings\");\n        this.log(\"\");\n      } else {\n        this.log(\"\");\n        this.logSuccess(\"Source validated successfully\");\n        this.log(\"\");\n      }\n    } catch (error) {\n      const message = getErrorMessage(error);\n      this.error(`${ERROR_MESSAGES.VALIDATION_FAILED}: ${message}`, { exit: EXIT_CODES.ERROR });\n    }\n  }\n}\n","import { sumBy } from \"remeda\";\nimport { z } from \"zod\";\nimport path from \"path\";\nimport { getErrorMessage } from \"../utils/errors\";\nimport { readFile, fileExists } from \"../utils/fs\";\nimport { parse as parseYaml } from \"yaml\";\nimport fg from \"fast-glob\";\nimport { extractFrontmatter } from \"../utils/frontmatter\";\nimport { log } from \"../utils/logger\";\nimport {\n  skillsMatrixConfigSchema,\n  metadataValidationSchema,\n  stackConfigValidationSchema,\n  skillFrontmatterValidationSchema,\n  agentFrontmatterValidationSchema,\n  agentYamlGenerationSchema,\n  stacksConfigSchema,\n  projectSourceConfigSchema,\n  pluginManifestSchema,\n} from \"./schemas\";\nimport { CLAUDE_DIR, CLAUDE_SRC_DIR, STANDARD_FILES } from \"../consts\";\n\ntype FileValidationError = {\n  file: string;\n  errors: string[];\n};\n\ntype SchemaValidationResult = {\n  schemaName: string;\n  valid: boolean;\n  totalFiles: number;\n  validFiles: number;\n  invalidFiles: FileValidationError[];\n};\n\nexport type FullValidationResult = {\n  valid: boolean;\n  results: SchemaValidationResult[];\n  summary: {\n    totalSchemas: number;\n    totalFiles: number;\n    validFiles: number;\n    invalidFiles: number;\n  };\n};\n\ntype ContentExtractor = (content: string) => unknown | null;\n\ntype ValidationTarget = {\n  name: string;\n  schema: z.ZodType<unknown>;\n  pattern: string;\n  baseDir: string;\n  extractor?: ContentExtractor;\n};\n\nconst VALIDATION_TARGETS: ValidationTarget[] = [\n  {\n    name: \"Skills Matrix\",\n    schema: skillsMatrixConfigSchema,\n    pattern: STANDARD_FILES.SKILLS_MATRIX_YAML,\n    baseDir: \"src/config\",\n  },\n  {\n    name: \"Skill Metadata\",\n    schema: metadataValidationSchema,\n    pattern: `**/${STANDARD_FILES.METADATA_YAML}`,\n    baseDir: \"src/skills\",\n  },\n  {\n    name: \"Stack Skill Metadata\",\n    schema: metadataValidationSchema,\n    pattern: `**/skills/**/${STANDARD_FILES.METADATA_YAML}`,\n    baseDir: \"src/stacks\",\n  },\n  {\n    name: \"Stack Config\",\n    schema: stackConfigValidationSchema,\n    pattern: `*/${STANDARD_FILES.CONFIG_YAML}`,\n    baseDir: \"src/stacks\",\n  },\n  {\n    name: \"Agent Definition\",\n    schema: agentYamlGenerationSchema,\n    pattern: `**/${STANDARD_FILES.AGENT_YAML}`,\n    baseDir: \"src/agents\",\n  },\n  {\n    name: \"Skill Frontmatter\",\n    schema: skillFrontmatterValidationSchema,\n    pattern: `**/${STANDARD_FILES.SKILL_MD}`,\n    baseDir: \"src/skills\",\n    extractor: extractFrontmatter,\n  },\n  {\n    name: \"Stack Skill Frontmatter\",\n    schema: skillFrontmatterValidationSchema,\n    pattern: `**/skills/**/${STANDARD_FILES.SKILL_MD}`,\n    baseDir: \"src/stacks\",\n    extractor: extractFrontmatter,\n  },\n  {\n    name: \"Stacks Config\",\n    schema: stacksConfigSchema,\n    pattern: \"stacks.yaml\",\n    baseDir: \"config\",\n  },\n  {\n    name: \"Project Source Config\",\n    schema: projectSourceConfigSchema,\n    pattern: STANDARD_FILES.CONFIG_YAML,\n    baseDir: CLAUDE_SRC_DIR,\n  },\n  {\n    name: \"Project Skill Metadata\",\n    schema: metadataValidationSchema,\n    pattern: `*/${STANDARD_FILES.METADATA_YAML}`,\n    baseDir: `${CLAUDE_DIR}/skills`,\n  },\n  {\n    name: \"Project Skill Frontmatter\",\n    schema: skillFrontmatterValidationSchema,\n    pattern: `*/${STANDARD_FILES.SKILL_MD}`,\n    baseDir: `${CLAUDE_DIR}/skills`,\n    extractor: extractFrontmatter,\n  },\n  {\n    name: \"Project Agent Frontmatter\",\n    schema: agentFrontmatterValidationSchema,\n    pattern: \"*.md\",\n    baseDir: `${CLAUDE_DIR}/agents`,\n    extractor: extractFrontmatter,\n  },\n  {\n    name: \"Plugin Manifest\",\n    schema: pluginManifestSchema,\n    pattern: `*/${STANDARD_FILES.PLUGIN_JSON}`,\n    baseDir: `${CLAUDE_DIR}/plugins`,\n    extractor: (content: string) => JSON.parse(content) as unknown,\n  },\n];\n\nfunction formatZodErrors(error: z.ZodError): string[] {\n  return error.issues.map((issue) => {\n    const path = issue.path.join(\".\");\n    if (issue.code === \"unrecognized_keys\") {\n      return `Unrecognized key: \"${issue.keys.join('\", \"')}\"`;\n    }\n    return path ? `${path}: ${issue.message}` : issue.message;\n  });\n}\n\nasync function validateFile(\n  filePath: string,\n  schema: z.ZodType<unknown>,\n  extractor?: ContentExtractor,\n): Promise<{ valid: boolean; errors: string[] }> {\n  try {\n    if (!(await fileExists(filePath))) {\n      return { valid: false, errors: [`File not found: ${filePath}`] };\n    }\n\n    const content = await readFile(filePath);\n\n    let parsed: unknown;\n    if (extractor) {\n      parsed = extractor(content);\n      if (parsed === null) {\n        return {\n          valid: false,\n          errors: [\"Failed to extract content (no valid frontmatter found)\"],\n        };\n      }\n    } else {\n      parsed = parseYaml(content);\n    }\n\n    const result = schema.safeParse(parsed);\n\n    if (result.success) {\n      return { valid: true, errors: [] };\n    }\n\n    return { valid: false, errors: formatZodErrors(result.error) };\n  } catch (error) {\n    const message = getErrorMessage(error);\n    return { valid: false, errors: [`Failed to parse content: ${message}`] };\n  }\n}\n\nasync function validateTarget(\n  target: ValidationTarget,\n  rootDir: string = process.cwd(),\n): Promise<SchemaValidationResult> {\n  const baseDir = path.join(rootDir, target.baseDir);\n  const pattern = path.join(baseDir, target.pattern);\n  const files = await fg(pattern, { absolute: true });\n\n  const result: SchemaValidationResult = {\n    schemaName: target.name,\n    valid: true,\n    totalFiles: files.length,\n    validFiles: 0,\n    invalidFiles: [],\n  };\n\n  if (files.length === 0) {\n    return result;\n  }\n\n  for (const file of files) {\n    const validation = await validateFile(file, target.schema, target.extractor);\n    const relativePath = path.relative(rootDir, file);\n\n    if (validation.valid) {\n      result.validFiles++;\n    } else {\n      result.valid = false;\n      result.invalidFiles.push({\n        file: relativePath,\n        errors: validation.errors,\n      });\n    }\n  }\n\n  return result;\n}\n\nexport async function validateAllSchemas(\n  rootDir: string = process.cwd(),\n): Promise<FullValidationResult> {\n  const results: SchemaValidationResult[] = [];\n\n  for (const target of VALIDATION_TARGETS) {\n    const result = await validateTarget(target, rootDir);\n    results.push(result);\n  }\n\n  const summary = {\n    totalSchemas: results.length,\n    totalFiles: sumBy(results, (r) => r.totalFiles),\n    validFiles: sumBy(results, (r) => r.validFiles),\n    invalidFiles: sumBy(results, (r) => r.invalidFiles.length),\n  };\n\n  return {\n    valid: results.every((r) => r.valid),\n    results,\n    summary,\n  };\n}\n\nexport function printValidationResults(result: FullValidationResult): void {\n  log(\"\\n  Schema Validation Summary:\");\n  log(\"  ─────────────────────────\");\n  log(`  Total schemas checked: ${result.summary.totalSchemas}`);\n  log(`  Total files: ${result.summary.totalFiles}`);\n  log(`  Valid: ${result.summary.validFiles}`);\n  log(`  Invalid: ${result.summary.invalidFiles}`);\n\n  for (const schemaResult of result.results) {\n    if (schemaResult.totalFiles === 0) continue;\n\n    const status = schemaResult.valid ? \"✓\" : \"✗\";\n    log(\n      `\\n  ${status} ${schemaResult.schemaName}: ${schemaResult.validFiles}/${schemaResult.totalFiles} valid`,\n    );\n\n    if (schemaResult.invalidFiles.length > 0) {\n      for (const file of schemaResult.invalidFiles) {\n        log(`\\n    ${file.file}:`);\n        file.errors.forEach((e) => log(`      - ${e}`));\n      }\n    }\n  }\n\n  if (result.valid) {\n    log(\"\\n  ✓ All schemas validated successfully\\n\");\n  } else {\n    log(\"\\n  ✗ Validation failed\\n\");\n  }\n}\n","import path from \"path\";\nimport { parse as parseYaml } from \"yaml\";\nimport { glob, readFile, fileExists, directoryExists } from \"../utils/fs\";\nimport { verbose } from \"../utils/logger\";\nimport { STANDARD_FILES } from \"../consts\";\nimport { metadataValidationSchema, formatZodErrors, SKILL_ID_PATTERN } from \"./schemas\";\nimport { parseFrontmatter } from \"./loading/loader\";\nimport { loadProjectSourceConfig } from \"./configuration\";\nimport {\n  checkMatrixHealth,\n  extractAllSkills,\n  loadSkillsMatrix,\n  mergeMatrixWithSkills,\n} from \"./matrix\";\n\nexport type SourceValidationIssue = {\n  severity: \"error\" | \"warning\";\n  file: string;\n  message: string;\n};\n\nexport type SourceValidationResult = {\n  issues: SourceValidationIssue[];\n  skillCount: number;\n  errorCount: number;\n  warningCount: number;\n};\n\n/** Checks if a key uses snake_case (has underscore between lowercase letters) */\nfunction isSnakeCase(key: string): boolean {\n  return /[a-z]_[a-z]/.test(key);\n}\n\n/**\n * Validates a skills source repository for metadata correctness.\n *\n * Checks:\n * 1. Every metadata.yaml against the strict validation schema\n * 2. cliName format and directory name consistency\n * 3. category values against known domain-prefixed patterns\n * 4. Cross-references resolve to existing skill IDs (via checkMatrixHealth)\n * 5. categoryExclusive presence when required\n * 6. camelCase key convention (no snake_case)\n * 7. Every skill directory has both SKILL.md and metadata.yaml\n */\nexport async function validateSource(sourcePath: string): Promise<SourceValidationResult> {\n  const issues: SourceValidationIssue[] = [];\n\n  const resolvedPath = path.isAbsolute(sourcePath) ? sourcePath : path.resolve(sourcePath);\n\n  if (!(await directoryExists(resolvedPath))) {\n    issues.push({\n      severity: \"error\",\n      file: resolvedPath,\n      message: \"Source directory does not exist\",\n    });\n    return buildResult(issues, 0);\n  }\n\n  const sourceProjectConfig = await loadProjectSourceConfig(resolvedPath);\n  const skillsDirRelPath = sourceProjectConfig?.skillsDir ?? \"src/skills\";\n  const skillsDir = path.join(resolvedPath, skillsDirRelPath);\n\n  if (!(await directoryExists(skillsDir))) {\n    issues.push({\n      severity: \"error\",\n      file: skillsDir,\n      message: \"Skills directory does not exist\",\n    });\n    return buildResult(issues, 0);\n  }\n\n  // Phase 1: Check every skill directory has both SKILL.md and metadata.yaml\n  const skillMdFiles = await glob(`**/${STANDARD_FILES.SKILL_MD}`, skillsDir);\n  const metadataFiles = await glob(`**/${STANDARD_FILES.METADATA_YAML}`, skillsDir);\n\n  const skillMdDirs = new Set(skillMdFiles.map((f) => path.dirname(f)));\n  const metadataDirs = new Set(metadataFiles.map((f) => path.dirname(f)));\n\n  // Dirs with SKILL.md but no metadata.yaml\n  for (const dir of skillMdDirs) {\n    if (!metadataDirs.has(dir)) {\n      issues.push({\n        severity: \"error\",\n        file: path.join(skillsDir, dir),\n        message: `Missing ${STANDARD_FILES.METADATA_YAML} — skill directory has ${STANDARD_FILES.SKILL_MD} but no metadata`,\n      });\n    }\n  }\n\n  // Dirs with metadata.yaml but no SKILL.md\n  for (const dir of metadataDirs) {\n    if (!skillMdDirs.has(dir)) {\n      issues.push({\n        severity: \"error\",\n        file: path.join(skillsDir, dir),\n        message: `Missing ${STANDARD_FILES.SKILL_MD} — skill directory has ${STANDARD_FILES.METADATA_YAML} but no SKILL.md`,\n      });\n    }\n  }\n\n  // Phase 2: Validate each metadata.yaml against strict schema and conventions\n  let skillCount = 0;\n  for (const metadataFile of metadataFiles) {\n    const metadataPath = path.join(skillsDir, metadataFile);\n    const skillDir = path.dirname(metadataFile);\n    const skillMdPath = path.join(skillsDir, skillDir, STANDARD_FILES.SKILL_MD);\n\n    if (!(await fileExists(skillMdPath))) {\n      // Already reported above\n      continue;\n    }\n\n    skillCount++;\n    const relPath = path.join(skillsDirRelPath, metadataFile);\n\n    // Read and parse metadata.yaml\n    let rawMetadata: unknown;\n    try {\n      const metadataContent = await readFile(metadataPath);\n      rawMetadata = parseYaml(metadataContent);\n    } catch (error) {\n      issues.push({\n        severity: \"error\",\n        file: relPath,\n        message: \"Failed to parse YAML\",\n      });\n      continue;\n    }\n\n    // Check for snake_case keys\n    if (rawMetadata && typeof rawMetadata === \"object\" && !Array.isArray(rawMetadata)) {\n      for (const key of Object.keys(rawMetadata as Record<string, unknown>)) {\n        if (isSnakeCase(key)) {\n          issues.push({\n            severity: \"error\",\n            file: relPath,\n            message: `Key '${key}' uses snake_case — use camelCase instead`,\n          });\n        }\n      }\n    }\n\n    // Validate against strict metadata schema\n    const result = metadataValidationSchema.safeParse(rawMetadata);\n    if (!result.success) {\n      for (const issue of result.error.issues) {\n        const fieldPath = issue.path.join(\".\");\n        issues.push({\n          severity: \"error\",\n          file: relPath,\n          message: `${fieldPath}: ${issue.message}`,\n        });\n      }\n      continue;\n    }\n\n    const metadata = result.data;\n\n    // Check cliName matches directory name\n    const dirName = path.basename(skillDir);\n    if (metadata.cliName !== dirName) {\n      issues.push({\n        severity: \"warning\",\n        file: relPath,\n        message: `cliName '${metadata.cliName}' does not match directory name '${dirName}'`,\n      });\n    }\n\n    // Parse SKILL.md frontmatter and check name matches cliName\n    const skillMdContent = await readFile(skillMdPath);\n    const frontmatter = parseFrontmatter(skillMdContent, skillMdPath);\n    if (frontmatter) {\n      if (!SKILL_ID_PATTERN.test(frontmatter.name)) {\n        issues.push({\n          severity: \"warning\",\n          file: path.join(skillsDirRelPath, skillDir, STANDARD_FILES.SKILL_MD),\n          message: `SKILL.md name '${frontmatter.name}' does not match expected skill ID pattern (domain-subcategory-name)`,\n        });\n      }\n    }\n\n    // Check category follows domain-prefixed pattern\n    if (\n      metadata.category &&\n      !/^(web|api|cli|mobile|infra|meta|security|shared)-.+$/.test(metadata.category)\n    ) {\n      issues.push({\n        severity: \"warning\",\n        file: relPath,\n        message: `Category '${metadata.category}' does not follow domain-prefixed pattern (e.g., 'web-framework', 'api-database')`,\n      });\n    }\n  }\n\n  // Phase 3: Cross-reference validation via matrix health check\n  try {\n    const matrixRelPath = sourceProjectConfig?.matrixFile ?? \"config/skills-matrix.yaml\";\n    const matrixPath = path.join(resolvedPath, matrixRelPath);\n\n    if (await fileExists(matrixPath)) {\n      const matrix = await loadSkillsMatrix(matrixPath);\n      const skills = await extractAllSkills(skillsDir);\n      const mergedMatrix = await mergeMatrixWithSkills(matrix, skills);\n      const healthIssues = checkMatrixHealth(mergedMatrix);\n\n      for (const healthIssue of healthIssues) {\n        issues.push({\n          severity: healthIssue.severity,\n          file: matrixRelPath,\n          message: healthIssue.details,\n        });\n      }\n    } else {\n      verbose(`No matrix file at '${matrixPath}' — skipping cross-reference validation`);\n    }\n  } catch (error) {\n    issues.push({\n      severity: \"warning\",\n      file: \"config/skills-matrix.yaml\",\n      message: `Cross-reference validation skipped: failed to load matrix`,\n    });\n  }\n\n  return buildResult(issues, skillCount);\n}\n\nfunction buildResult(issues: SourceValidationIssue[], skillCount: number): SourceValidationResult {\n  const errorCount = issues.filter((i) => i.severity === \"error\").length;\n  const warningCount = issues.filter((i) => i.severity === \"warning\").length;\n  return { issues, skillCount, errorCount, warningCount };\n}\n"],"mappings":"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","names":["path","path","path","parseYaml","path","parseYaml","verbose","path"]}
+{"version":3,"sources":["../../src/cli/commands/validate.ts","../../src/cli/lib/source-validator.ts"],"sourcesContent":["import { Args, Flags } from \"@oclif/core\";\nimport path from \"path\";\nimport { BaseCommand } from \"../base-command.js\";\nimport { getErrorMessage } from \"../utils/errors.js\";\nimport { EXIT_CODES } from \"../lib/exit-codes.js\";\nimport { ERROR_MESSAGES } from \"../utils/messages.js\";\nimport { validateAllSchemas, printValidationResults } from \"../lib/schema-validator.js\";\nimport {\n  validatePlugin,\n  validateAllPlugins,\n  printPluginValidationResult,\n} from \"../lib/plugins/index.js\";\nimport { validateSource } from \"../lib/source-validator.js\";\n\nexport default class Validate extends BaseCommand {\n  static summary =\n    \"Validate YAML files against schemas, validate compiled plugins, or validate a skills source\";\n  static description =\n    \"Validates skill/agent YAML files against JSON schemas, validates compiled plugin structure and content, \" +\n    \"or validates a skills source repository for metadata correctness. \" +\n    \"Without arguments, validates all YAML files in the current directory against their schemas. \" +\n    \"With --source, validates all skills in the source for schema compliance, cross-references, and conventions. \" +\n    \"With a path argument or --plugins flag, validates plugin(s) instead.\";\n\n  static examples = [\n    {\n      description: \"Validate all YAML schemas\",\n      command: \"<%= config.bin %> <%= command.id %>\",\n    },\n    {\n      description: \"Validate a skills source repository\",\n      command: \"<%= config.bin %> <%= command.id %> --source .\",\n    },\n    {\n      description: \"Validate a remote skills source\",\n      command: \"<%= config.bin %> <%= command.id %> --source github:acme-corp/skills\",\n    },\n    {\n      description: \"Validate a specific plugin\",\n      command: \"<%= config.bin %> <%= command.id %> ./path/to/plugin\",\n    },\n    {\n      description: \"Validate all plugins in a directory\",\n      command: \"<%= config.bin %> <%= command.id %> ./plugins --all\",\n    },\n    {\n      description: \"Validate plugins with verbose output\",\n      command: \"<%= config.bin %> <%= command.id %> --plugins --verbose\",\n    },\n  ];\n\n  static args = {\n    path: Args.string({\n      description: \"Path to plugin or plugins directory to validate\",\n      required: false,\n    }),\n  };\n\n  static flags = {\n    ...BaseCommand.baseFlags,\n    verbose: Flags.boolean({\n      char: \"v\",\n      description: \"Enable verbose logging\",\n      default: false,\n    }),\n    all: Flags.boolean({\n      char: \"a\",\n      description: \"Validate all plugins in directory\",\n      default: false,\n    }),\n    plugins: Flags.boolean({\n      char: \"p\",\n      description: \"Validate plugins instead of schemas\",\n      default: false,\n    }),\n  };\n\n  async run(): Promise<void> {\n    const { args, flags } = await this.parse(Validate);\n\n    if (flags.source) {\n      await this.validateSkillsSource(flags.source);\n    } else if (args.path || flags.plugins) {\n      await this.validatePlugins(args.path, flags.verbose, flags.all);\n    } else {\n      await this.validateSchemas();\n    }\n  }\n\n  private async validateSchemas(): Promise<void> {\n    this.log(\"\");\n    this.log(\"Validating all schemas\");\n    this.log(\"\");\n\n    try {\n      const result = await validateAllSchemas();\n\n      const summary = result.valid\n        ? `Done: ${result.summary.validFiles}/${result.summary.totalFiles} files valid`\n        : `Done: ${result.summary.invalidFiles} invalid files`;\n\n      this.log(summary);\n      printValidationResults(result);\n\n      if (!result.valid) {\n        this.exit(EXIT_CODES.ERROR);\n      }\n    } catch (error) {\n      const message = getErrorMessage(error);\n      this.error(`${ERROR_MESSAGES.VALIDATION_FAILED}: ${message}`, { exit: EXIT_CODES.ERROR });\n    }\n  }\n\n  private async validatePlugins(\n    pluginPath: string | undefined,\n    verbose: boolean,\n    all: boolean,\n  ): Promise<void> {\n    const targetPath = pluginPath ? path.resolve(pluginPath) : process.cwd();\n\n    if (all) {\n      await this.validateAllPluginsInDirectory(targetPath, verbose);\n    } else {\n      await this.validateSinglePlugin(targetPath, verbose);\n    }\n  }\n\n  private async validateAllPluginsInDirectory(targetPath: string, verbose: boolean): Promise<void> {\n    this.log(\"\");\n    this.log(`Validating all plugins in: ${targetPath}`);\n    this.log(\"\");\n\n    try {\n      const result = await validateAllPlugins(targetPath);\n\n      const summary = result.valid\n        ? `Done: ${result.summary.valid}/${result.summary.total} plugins valid`\n        : `Done: ${result.summary.invalid} invalid plugins`;\n\n      this.log(summary);\n\n      this.log(\"\");\n      this.log(\"  Plugin Validation Summary:\");\n      this.log(\"  -------------------------\");\n      this.log(`  Total plugins: ${result.summary.total}`);\n      this.log(`  Valid: ${result.summary.valid}`);\n      this.log(`  Invalid: ${result.summary.invalid}`);\n      this.log(`  With warnings: ${result.summary.withWarnings}`);\n\n      for (const { name, result: pluginResult } of result.results) {\n        printPluginValidationResult(name, pluginResult, verbose);\n      }\n\n      if (result.valid) {\n        this.log(\"\");\n        this.logSuccess(\"All plugins validated successfully\");\n        this.log(\"\");\n      } else {\n        this.log(\"\");\n        this.error(ERROR_MESSAGES.VALIDATION_FAILED, { exit: EXIT_CODES.ERROR });\n      }\n    } catch (error) {\n      const message = getErrorMessage(error);\n      this.error(`${ERROR_MESSAGES.VALIDATION_FAILED}: ${message}`, { exit: EXIT_CODES.ERROR });\n    }\n  }\n\n  private async validateSinglePlugin(targetPath: string, _verbose: boolean): Promise<void> {\n    this.log(\"\");\n    this.log(`Validating plugin: ${targetPath}`);\n    this.log(\"\");\n\n    try {\n      const result = await validatePlugin(targetPath);\n\n      const summary = result.valid ? \"Done: Plugin is valid\" : \"Done: Plugin has errors\";\n\n      this.log(summary);\n\n      printPluginValidationResult(path.basename(targetPath), result, true);\n\n      if (result.valid && result.warnings.length === 0) {\n        this.log(\"\");\n        this.logSuccess(\"Plugin validated successfully\");\n        this.log(\"\");\n      } else if (result.valid) {\n        this.log(\"\");\n        this.logWarning(\"Plugin valid with warnings\");\n        this.log(\"\");\n      } else {\n        this.log(\"\");\n        this.error(ERROR_MESSAGES.VALIDATION_FAILED, { exit: EXIT_CODES.ERROR });\n      }\n    } catch (error) {\n      const message = getErrorMessage(error);\n      this.error(`${ERROR_MESSAGES.VALIDATION_FAILED}: ${message}`, { exit: EXIT_CODES.ERROR });\n    }\n  }\n\n  private async validateSkillsSource(source: string): Promise<void> {\n    this.log(\"\");\n    this.log(`Validating source: ${source}`);\n    this.log(\"\");\n\n    try {\n      const result = await validateSource(source);\n\n      this.log(`Checked ${result.skillCount} skill(s)`);\n      this.log(\"\");\n\n      for (const issue of result.issues) {\n        const prefix = issue.severity === \"error\" ? \"ERROR\" : \"WARN\";\n        this.log(`  [${prefix}] ${issue.file}: ${issue.message}`);\n      }\n\n      if (result.issues.length > 0) {\n        this.log(\"\");\n      }\n\n      this.log(`Result: ${result.errorCount} error(s), ${result.warningCount} warning(s)`);\n\n      if (result.errorCount > 0) {\n        this.log(\"\");\n        this.error(ERROR_MESSAGES.VALIDATION_FAILED, { exit: EXIT_CODES.ERROR });\n      } else if (result.warningCount > 0) {\n        this.log(\"\");\n        this.logWarning(\"Source valid with warnings\");\n        this.log(\"\");\n      } else {\n        this.log(\"\");\n        this.logSuccess(\"Source validated successfully\");\n        this.log(\"\");\n      }\n    } catch (error) {\n      const message = getErrorMessage(error);\n      this.error(`${ERROR_MESSAGES.VALIDATION_FAILED}: ${message}`, { exit: EXIT_CODES.ERROR });\n    }\n  }\n}\n","import path from \"path\";\nimport { parse as parseYaml } from \"yaml\";\nimport { glob, readFile, fileExists, directoryExists } from \"../utils/fs\";\nimport { verbose } from \"../utils/logger\";\nimport { SKILL_CATEGORIES_YAML_PATH, SKILL_RULES_YAML_PATH, STANDARD_FILES } from \"../consts\";\nimport { metadataValidationSchema, formatZodErrors, SKILL_ID_PATTERN } from \"./schemas\";\nimport { parseFrontmatter } from \"./loading/loader\";\nimport { loadProjectSourceConfig } from \"./configuration\";\nimport {\n  checkMatrixHealth,\n  extractAllSkills,\n  loadSkillCategories,\n  loadSkillRules,\n  mergeMatrixWithSkills,\n} from \"./matrix\";\n\nexport type SourceValidationIssue = {\n  severity: \"error\" | \"warning\";\n  file: string;\n  message: string;\n};\n\nexport type SourceValidationResult = {\n  issues: SourceValidationIssue[];\n  skillCount: number;\n  errorCount: number;\n  warningCount: number;\n};\n\n/** Checks if a key uses snake_case (has underscore between lowercase letters) */\nfunction isSnakeCase(key: string): boolean {\n  return /[a-z]_[a-z]/.test(key);\n}\n\n/**\n * Validates a skills source repository for metadata correctness.\n *\n * Checks:\n * 1. Every metadata.yaml against the strict validation schema\n * 2. displayName format and directory name consistency\n * 3. category values against known domain-prefixed patterns\n * 4. Cross-references resolve to existing skill IDs (via checkMatrixHealth)\n * 5. camelCase key convention (no snake_case)\n * 7. Every skill directory has both SKILL.md and metadata.yaml\n */\nexport async function validateSource(sourcePath: string): Promise<SourceValidationResult> {\n  const issues: SourceValidationIssue[] = [];\n\n  const resolvedPath = path.isAbsolute(sourcePath) ? sourcePath : path.resolve(sourcePath);\n\n  if (!(await directoryExists(resolvedPath))) {\n    issues.push({\n      severity: \"error\",\n      file: resolvedPath,\n      message: \"Source directory does not exist\",\n    });\n    return buildResult(issues, 0);\n  }\n\n  const sourceProjectConfig = await loadProjectSourceConfig(resolvedPath);\n  const skillsDirRelPath = sourceProjectConfig?.skillsDir ?? \"src/skills\";\n  const skillsDir = path.join(resolvedPath, skillsDirRelPath);\n\n  if (!(await directoryExists(skillsDir))) {\n    issues.push({\n      severity: \"error\",\n      file: skillsDir,\n      message: \"Skills directory does not exist\",\n    });\n    return buildResult(issues, 0);\n  }\n\n  // Phase 1: Check every skill directory has both SKILL.md and metadata.yaml\n  const skillMdFiles = await glob(`**/${STANDARD_FILES.SKILL_MD}`, skillsDir);\n  const metadataFiles = await glob(`**/${STANDARD_FILES.METADATA_YAML}`, skillsDir);\n\n  const skillMdDirs = new Set(skillMdFiles.map((f) => path.dirname(f)));\n  const metadataDirs = new Set(metadataFiles.map((f) => path.dirname(f)));\n\n  // Dirs with SKILL.md but no metadata.yaml\n  for (const dir of skillMdDirs) {\n    if (!metadataDirs.has(dir)) {\n      issues.push({\n        severity: \"error\",\n        file: path.join(skillsDir, dir),\n        message: `Missing ${STANDARD_FILES.METADATA_YAML} — skill directory has ${STANDARD_FILES.SKILL_MD} but no metadata`,\n      });\n    }\n  }\n\n  // Dirs with metadata.yaml but no SKILL.md\n  for (const dir of metadataDirs) {\n    if (!skillMdDirs.has(dir)) {\n      issues.push({\n        severity: \"error\",\n        file: path.join(skillsDir, dir),\n        message: `Missing ${STANDARD_FILES.SKILL_MD} — skill directory has ${STANDARD_FILES.METADATA_YAML} but no SKILL.md`,\n      });\n    }\n  }\n\n  // Phase 2: Validate each metadata.yaml against strict schema and conventions\n  let skillCount = 0;\n  for (const metadataFile of metadataFiles) {\n    const metadataPath = path.join(skillsDir, metadataFile);\n    const skillDir = path.dirname(metadataFile);\n    const skillMdPath = path.join(skillsDir, skillDir, STANDARD_FILES.SKILL_MD);\n\n    if (!(await fileExists(skillMdPath))) {\n      // Already reported above\n      continue;\n    }\n\n    skillCount++;\n    const relPath = path.join(skillsDirRelPath, metadataFile);\n\n    // Read and parse metadata.yaml\n    let rawMetadata: unknown;\n    try {\n      const metadataContent = await readFile(metadataPath);\n      rawMetadata = parseYaml(metadataContent);\n    } catch (error) {\n      issues.push({\n        severity: \"error\",\n        file: relPath,\n        message: \"Failed to parse YAML\",\n      });\n      continue;\n    }\n\n    // Check for snake_case keys\n    if (rawMetadata && typeof rawMetadata === \"object\" && !Array.isArray(rawMetadata)) {\n      for (const key of Object.keys(rawMetadata as Record<string, unknown>)) {\n        if (isSnakeCase(key)) {\n          issues.push({\n            severity: \"error\",\n            file: relPath,\n            message: `Key '${key}' uses snake_case — use camelCase instead`,\n          });\n        }\n      }\n    }\n\n    // Validate against strict metadata schema\n    const result = metadataValidationSchema.safeParse(rawMetadata);\n    if (!result.success) {\n      for (const issue of result.error.issues) {\n        const fieldPath = issue.path.join(\".\");\n        issues.push({\n          severity: \"error\",\n          file: relPath,\n          message: `${fieldPath}: ${issue.message}`,\n        });\n      }\n      continue;\n    }\n\n    const metadata = result.data;\n\n    // Check displayName matches directory name\n    const dirName = path.basename(skillDir);\n    if (metadata.displayName !== dirName) {\n      issues.push({\n        severity: \"warning\",\n        file: relPath,\n        message: `displayName '${metadata.displayName}' does not match directory name '${dirName}'`,\n      });\n    }\n\n    // Parse SKILL.md frontmatter and check name matches displayName\n    const skillMdContent = await readFile(skillMdPath);\n    const frontmatter = parseFrontmatter(skillMdContent, skillMdPath);\n    if (frontmatter) {\n      if (!SKILL_ID_PATTERN.test(frontmatter.name)) {\n        issues.push({\n          severity: \"warning\",\n          file: path.join(skillsDirRelPath, skillDir, STANDARD_FILES.SKILL_MD),\n          message: `SKILL.md name '${frontmatter.name}' does not match expected skill ID pattern (domain-subcategory-name)`,\n        });\n      }\n    }\n\n    // Check category follows domain-prefixed pattern\n    if (\n      metadata.category &&\n      !/^(web|api|cli|mobile|infra|meta|security|shared)-.+$/.test(metadata.category)\n    ) {\n      issues.push({\n        severity: \"warning\",\n        file: relPath,\n        message: `Category '${metadata.category}' does not follow domain-prefixed pattern (e.g., 'web-framework', 'api-database')`,\n      });\n    }\n  }\n\n  // Phase 3: Cross-reference validation via matrix health check\n  try {\n    const categoriesPath = path.join(resolvedPath, SKILL_CATEGORIES_YAML_PATH);\n    const rulesPath = path.join(resolvedPath, SKILL_RULES_YAML_PATH);\n\n    const hasCats = await fileExists(categoriesPath);\n    const hasRules = await fileExists(rulesPath);\n\n    if (hasCats || hasRules) {\n      const cats = hasCats ? await loadSkillCategories(categoriesPath) : {};\n      const defaultRelationships = {\n        conflicts: [],\n        discourages: [],\n        recommends: [],\n        requires: [],\n        alternatives: [],\n      };\n      const rules = hasRules\n        ? await loadSkillRules(rulesPath)\n        : {\n            version: \"1.0.0\",\n            aliases: {},\n            relationships: defaultRelationships,\n            perSkill: {},\n          };\n      const skills = await extractAllSkills(skillsDir);\n      const mergedMatrix = await mergeMatrixWithSkills(\n        cats,\n        rules.relationships,\n        rules.aliases,\n        skills,\n        rules.perSkill,\n      );\n      const healthIssues = checkMatrixHealth(mergedMatrix);\n\n      for (const healthIssue of healthIssues) {\n        issues.push({\n          severity: healthIssue.severity,\n          file: SKILL_CATEGORIES_YAML_PATH,\n          message: healthIssue.details,\n        });\n      }\n    } else {\n      verbose(\n        `No categories/rules files at '${resolvedPath}' — skipping cross-reference validation`,\n      );\n    }\n  } catch (error) {\n    issues.push({\n      severity: \"warning\",\n      file: SKILL_CATEGORIES_YAML_PATH,\n      message: `Cross-reference validation skipped: failed to load categories/rules`,\n    });\n  }\n\n  return buildResult(issues, skillCount);\n}\n\nfunction buildResult(issues: SourceValidationIssue[], skillCount: number): SourceValidationResult {\n  const errorCount = issues.filter((i) => i.severity === \"error\").length;\n  const warningCount = issues.filter((i) => i.severity === \"warning\").length;\n  return { issues, skillCount, errorCount, warningCount };\n}\n"],"mappings":"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","names":["path","verbose","path"]}

package/dist/components/skill-search/skill-search.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   SkillSearch
-} from "../../chunk-EZ46ZTAQ.js";
-import "../../chunk-N5OCAAXY.js";
+} from "../../chunk-U2W5SENM.js";
+import "../../chunk-JWYRXE6C.js";
 import "../../chunk-U3IGFMCY.js";
-import "../../chunk-FTD5Z6QD.js";
+import "../../chunk-AWP5A6IM.js";
 import "../../chunk-DHET7RCE.js";
 export {
   SkillSearch

package/dist/components/wizard/category-grid.js

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 import {
   CategoryGrid
-} from "../../chunk-3APMMQUA.js";
+} from "../../chunk-JFF7P4LC.js";
 import "../../chunk-GG4BSB6S.js";
-import "../../chunk-FTD5Z6QD.js";
+import "../../chunk-GBOW6FUW.js";
+import "../../chunk-AWP5A6IM.js";
 import "../../chunk-DHET7RCE.js";
 export {
   CategoryGrid

package/dist/components/wizard/category-grid.test.js

@@ -21,9 +21,10 @@ import {
 } from "../../chunk-XY3XDVMI.js";
 import {
   CategoryGrid
-} from "../../chunk-3APMMQUA.js";
+} from "../../chunk-JFF7P4LC.js";
 import "../../chunk-GG4BSB6S.js";
-import "../../chunk-FTD5Z6QD.js";
+import "../../chunk-GBOW6FUW.js";
+import "../../chunk-AWP5A6IM.js";
 import {
   init_esm_shims
 } from "../../chunk-DHET7RCE.js";
@@ -186,7 +187,6 @@ var defaultProps = {
   defaultFocusedRow: 0,
   defaultFocusedCol: 0,
   showLabels: false,
-  expertMode: false,
   onToggle: vi.fn(),
   onFocusChange: vi.fn(),
   onToggleLabels: vi.fn()
@@ -274,11 +274,11 @@ describe("CategoryGrid component", () => {
       const output = lastFrame();
       globalExpect(output).not.toContain("\u26A0");
     });
-    it("should show disabled options with dimmed styling", () => {
+    it("should show discouraged options with warning styling", () => {
       const categories = [
         createCategory("web-testing", "Test", [
           createOption("web-forms-react-hook-form", "Option 1"),
-          createOption("web-forms-vee-validate", "Option 2", { state: "disabled" })
+          createOption("web-forms-vee-validate", "Option 2", { state: "discouraged" })
         ])
       ];
       const { lastFrame, unmount } = renderGrid({ categories });
@@ -311,26 +311,26 @@ describe("CategoryGrid component", () => {
       const output = lastFrame();
       globalExpect(output).toContain("Unselected Skill");
     });
-    it("should render disabled skills with label text", () => {
+    it("should render discouraged skills with label text", () => {
       const categories = [
         createCategory("web-forms", "Forms", [
-          createOption("web-forms-react-hook-form", "Disabled Skill", { state: "disabled" })
+          createOption("web-forms-react-hook-form", "Discouraged Skill", { state: "discouraged" })
         ])
       ];
       const { lastFrame, unmount } = renderGrid({ categories });
       cleanup = unmount;
       const output = lastFrame();
-      globalExpect(output).toContain("Disabled Skill");
+      globalExpect(output).toContain("Discouraged Skill");
     });
-    it("should render disabled+selected skills with label text", () => {
+    it("should render discouraged+selected skills with label text", () => {
       const categories = [
         createCategory("web-forms", "Forms", [
-          createOption("web-forms-react-hook-form", "Disabled Selected", {
-            state: "disabled",
+          createOption("web-forms-react-hook-form", "Discouraged Selected", {
+            state: "discouraged",
             selected: true
           }),
-          createOption("web-forms-vee-validate", "Disabled Only", {
-            state: "disabled",
+          createOption("web-forms-vee-validate", "Discouraged Only", {
+            state: "discouraged",
             selected: false
           })
         ])
@@ -338,8 +338,8 @@ describe("CategoryGrid component", () => {
       const { lastFrame, unmount } = renderGrid({ categories });
       cleanup = unmount;
       const output = lastFrame();
-      globalExpect(output).toContain("Disabled Selected");
-      globalExpect(output).toContain("Disabled Only");
+      globalExpect(output).toContain("Discouraged Selected");
+      globalExpect(output).toContain("Discouraged Only");
     });
     it("should render discouraged skills with label text", () => {
       const categories = [
@@ -359,7 +359,7 @@ describe("CategoryGrid component", () => {
           createOption("web-forms-vee-validate", "Inactive", { selected: false })
         ])
       ];
-      const { lastFrame, unmount } = renderGrid({ categories, expertMode: true });
+      const { lastFrame, unmount } = renderGrid({ categories });
       cleanup = unmount;
       const output = lastFrame();
       globalExpect(output).toContain("Active");
@@ -646,7 +646,6 @@ describe("CategoryGrid component", () => {
         defaultFocusedRow: 0,
         defaultFocusedCol: 0,
         // react (selected)
-        expertMode: true,
         onToggle
       });
       cleanup = unmount;
@@ -655,26 +654,25 @@ describe("CategoryGrid component", () => {
       await delay(INPUT_DELAY_MS);
       globalExpect(onToggle).toHaveBeenCalledWith("web-framework", "web-framework-react");
     });
-    it("should NOT call onToggle when all options in a category are disabled", async () => {
+    it("should call onToggle for discouraged options (still selectable)", async () => {
       const onToggle = vi.fn();
       const categories = [
         createCategory("web-testing", "Test", [
-          createOption("web-forms-react-hook-form", "Option 1", { state: "disabled" }),
-          createOption("web-forms-vee-validate", "Option 2", { state: "disabled" })
+          createOption("web-forms-react-hook-form", "Option 1", { state: "discouraged" }),
+          createOption("web-forms-vee-validate", "Option 2", { state: "discouraged" })
         ])
       ];
       const { stdin, unmount } = renderGrid({
         categories,
         defaultFocusedRow: 0,
         defaultFocusedCol: 0,
-        expertMode: true,
         onToggle
       });
       cleanup = unmount;
       await delay(RENDER_DELAY_MS);
       await stdin.write(" ");
       await delay(INPUT_DELAY_MS);
-      globalExpect(onToggle).not.toHaveBeenCalled();
+      globalExpect(onToggle).toHaveBeenCalled();
     });
     it("should bounce focus away from locked sections on mount", async () => {
       const onFocusChange = vi.fn();
@@ -689,13 +687,13 @@ describe("CategoryGrid component", () => {
       globalExpect(onFocusChange).toHaveBeenCalledWith(0, 0);
     });
   });
-  describe("disabled options navigation", () => {
-    it("should navigate to disabled options when navigating right", async () => {
+  describe("discouraged options navigation", () => {
+    it("should navigate to discouraged options when navigating right", async () => {
       const onFocusChange = vi.fn();
       const categories = [
         createCategory("web-testing", "Test", [
           createOption("web-forms-react-hook-form", "Option 1"),
-          createOption("web-forms-vee-validate", "Option 2", { state: "disabled" }),
+          createOption("web-forms-vee-validate", "Option 2", { state: "discouraged" }),
           createOption("web-forms-zod-validation", "Option 3")
         ])
       ];
@@ -703,7 +701,6 @@ describe("CategoryGrid component", () => {
         categories,
         defaultFocusedRow: 0,
         defaultFocusedCol: 0,
-        expertMode: true,
         onFocusChange
       });
       cleanup = unmount;
@@ -712,12 +709,12 @@ describe("CategoryGrid component", () => {
       await delay(INPUT_DELAY_MS);
       globalExpect(onFocusChange).toHaveBeenCalledWith(0, 1);
     });
-    it("should navigate to disabled options when navigating left", async () => {
+    it("should navigate to discouraged options when navigating left", async () => {
       const onFocusChange = vi.fn();
       const categories = [
         createCategory("web-testing", "Test", [
           createOption("web-forms-react-hook-form", "Option 1"),
-          createOption("web-forms-vee-validate", "Option 2", { state: "disabled" }),
+          createOption("web-forms-vee-validate", "Option 2", { state: "discouraged" }),
           createOption("web-forms-zod-validation", "Option 3")
         ])
       ];
@@ -725,8 +722,7 @@ describe("CategoryGrid component", () => {
         categories,
         defaultFocusedRow: 0,
         defaultFocusedCol: 2,
-        // Start at opt2 (disabled, sorted to end)
-        expertMode: true,
+        // Start at opt3 (index 2)
         onFocusChange
       });
       cleanup = unmount;
@@ -735,19 +731,18 @@ describe("CategoryGrid component", () => {
       await delay(INPUT_DELAY_MS);
       globalExpect(onFocusChange).toHaveBeenCalledWith(0, 1);
     });
-    it("should navigate between all-disabled options in a row", async () => {
+    it("should navigate between all-discouraged options in a row", async () => {
       const onFocusChange = vi.fn();
       const categories = [
         createCategory("web-testing", "Test", [
-          createOption("web-forms-react-hook-form", "Option 1", { state: "disabled" }),
-          createOption("web-forms-vee-validate", "Option 2", { state: "disabled" })
+          createOption("web-forms-react-hook-form", "Option 1", { state: "discouraged" }),
+          createOption("web-forms-vee-validate", "Option 2", { state: "discouraged" })
         ])
       ];
       const { stdin, unmount } = renderGrid({
         categories,
         defaultFocusedRow: 0,
         defaultFocusedCol: 0,
-        expertMode: true,
         onFocusChange
       });
       cleanup = unmount;
@@ -834,41 +829,100 @@ describe("CategoryGrid component", () => {
       globalExpect(output).not.toContain("(recommended)");
       globalExpect(output).not.toContain("(selected)");
       globalExpect(output).not.toContain("(discouraged)");
-      globalExpect(output).not.toContain("(disabled)");
     });
-    it("should show Disabled label for disabled options when showLabels is true", () => {
+    it("should show discouraged label for discouraged options when showLabels is true", () => {
       const categories = [
         createCategory("web-testing", "Test", [
           createOption("web-forms-react-hook-form", "Option 1"),
-          createOption("web-forms-vee-validate", "Option 2", { state: "disabled" })
+          createOption("web-forms-vee-validate", "Option 2", { state: "discouraged" })
         ])
       ];
       const { lastFrame, unmount } = renderGrid({ categories, showLabels: true });
       cleanup = unmount;
       const output = lastFrame();
-      globalExpect(output).toContain("(disabled)");
-    });
-  });
-  describe("expert mode", () => {
-    it("should not handle expert mode toggle locally (handled globally)", () => {
-      const { lastFrame, unmount } = renderGrid();
-      cleanup = unmount;
-      const output = lastFrame();
-      globalExpect(output).not.toContain("[e] Expert Mode");
+      globalExpect(output).toContain("(discouraged)");
     });
   });
   describe("option ordering", () => {
     it("should preserve original order regardless of state", () => {
-      const { lastFrame, unmount } = renderGrid({ expertMode: false });
-      cleanup = unmount;
-      const output = lastFrame();
-      globalExpect(output).toBeDefined();
-    });
-    it("should preserve original order in expert mode", () => {
-      const { lastFrame, unmount } = renderGrid({ expertMode: true });
+      const categories = [
+        createCategory("web-client-state", "State", [
+          createOption("web-state-jotai", "Jotai"),
+          createOption("web-state-zustand", "Zustand", { state: "recommended" }),
+          createOption("web-state-redux-toolkit", "Redux", { state: "discouraged" }),
+          createOption("web-state-mobx", "MobX")
+        ])
+      ];
+      const { lastFrame, unmount } = renderGrid({ categories });
       cleanup = unmount;
       const output = lastFrame();
-      globalExpect(output).toBeDefined();
+      const jotaiIdx = output.indexOf("Jotai");
+      const zustandIdx = output.indexOf("Zustand");
+      const reduxIdx = output.indexOf("Redux");
+      const mobxIdx = output.indexOf("MobX");
+      globalExpect(jotaiIdx).toBeLessThan(zustandIdx);
+      globalExpect(zustandIdx).toBeLessThan(reduxIdx);
+      globalExpect(reduxIdx).toBeLessThan(mobxIdx);
+    });
+    it("should not change order when a skill is selected", () => {
+      const categoriesBefore = [
+        createCategory("web-client-state", "State", [
+          createOption("web-state-jotai", "Jotai"),
+          createOption("web-state-zustand", "Zustand"),
+          createOption("web-state-redux-toolkit", "Redux")
+        ])
+      ];
+      const categoriesAfter = [
+        createCategory("web-client-state", "State", [
+          createOption("web-state-jotai", "Jotai"),
+          createOption("web-state-zustand", "Zustand", { selected: true }),
+          createOption("web-state-redux-toolkit", "Redux")
+        ])
+      ];
+      const { lastFrame: frameBefore, unmount: unmountBefore } = renderGrid({
+        categories: categoriesBefore
+      });
+      const outputBefore = frameBefore();
+      unmountBefore();
+      const { lastFrame: frameAfter, unmount: unmountAfter } = renderGrid({
+        categories: categoriesAfter
+      });
+      cleanup = unmountAfter;
+      const outputAfter = frameAfter();
+      globalExpect(outputBefore.indexOf("Jotai")).toBeLessThan(outputBefore.indexOf("Zustand"));
+      globalExpect(outputBefore.indexOf("Zustand")).toBeLessThan(outputBefore.indexOf("Redux"));
+      globalExpect(outputAfter.indexOf("Jotai")).toBeLessThan(outputAfter.indexOf("Zustand"));
+      globalExpect(outputAfter.indexOf("Zustand")).toBeLessThan(outputAfter.indexOf("Redux"));
+    });
+    it("should not change order when a skill state changes from normal to discouraged", () => {
+      const categoriesBefore = [
+        createCategory("web-client-state", "State", [
+          createOption("web-state-jotai", "Jotai"),
+          createOption("web-state-zustand", "Zustand"),
+          createOption("web-state-redux-toolkit", "Redux")
+        ])
+      ];
+      const categoriesAfter = [
+        createCategory("web-client-state", "State", [
+          createOption("web-state-jotai", "Jotai"),
+          createOption("web-state-zustand", "Zustand", { state: "discouraged" }),
+          createOption("web-state-redux-toolkit", "Redux")
+        ])
+      ];
+      const { lastFrame: frameBefore, unmount: unmountBefore } = renderGrid({
+        categories: categoriesBefore
+      });
+      const outputBefore = frameBefore();
+      unmountBefore();
+      const { lastFrame: frameAfter, unmount: unmountAfter } = renderGrid({
+        categories: categoriesAfter
+      });
+      cleanup = unmountAfter;
+      const outputAfter = frameAfter();
+      globalExpect(outputBefore.indexOf("Jotai")).toBeLessThan(outputBefore.indexOf("Zustand"));
+      globalExpect(outputBefore.indexOf("Zustand")).toBeLessThan(outputBefore.indexOf("Redux"));
+      globalExpect(outputAfter.indexOf("Jotai")).toBeLessThan(outputAfter.indexOf("Zustand"));
+      globalExpect(outputAfter.indexOf("Zustand")).toBeLessThan(outputAfter.indexOf("Redux"));
     });
   });
   describe("edge cases", () => {
@@ -1138,7 +1192,7 @@ describe("CategoryGrid component", () => {
       const output = lastFrame();
       globalExpect(output).toContain("(0 selected)");
     });
-    it("should hide counter in expert mode", () => {
+    it("should always show selection counter", () => {
       const categories = [
         createCategory(
           "web-framework",
@@ -1153,11 +1207,11 @@ describe("CategoryGrid component", () => {
           { exclusive: false }
         )
       ];
-      const { lastFrame, unmount } = renderGrid({ categories, expertMode: true });
+      const { lastFrame, unmount } = renderGrid({ categories });
       cleanup = unmount;
       const output = lastFrame();
-      globalExpect(output).not.toContain("of 1");
-      globalExpect(output).not.toContain("selected");
+      globalExpect(output).toContain("1 of 1");
+      globalExpect(output).toContain("1 selected");
     });
     it("should show correct counts for mixed exclusive and non-exclusive categories", () => {
       const categories = [