* fix(context): migrate delegation references to split workflow files * chore(ci): add markdown link validation with regex skip rules * fix(context): migrate index references to navigation * fix(agent): allow limited bash for task status updates * refactor(skills): migrate to .opencode/skills and normalize skill files * fix(agent): align subagent permissions and workflow structure * docs: reconcile workflow examples and design iteration references * feat(skill): enforce schema checks in task validate command * fix(install): improve colored output and skills collision grouping |
||
|---|---|---|
| .. | ||
| auto-detect-components.sh | ||
| check-dependencies.ts | ||
| fix-registry.py | ||
| README.md | ||
| register-component.sh | ||
| validate-component.sh | ||
| validate-profile-coverage.sh | ||
| validate-registry.sh | ||
| validate-registry.ts | ||
Registry Validation Scripts
This directory contains scripts to validate the registry.json file.
Available Scripts
TypeScript Version (Recommended) ⚡
Fast, modern, and easy to debug
# Run validation
npm run validate:registry
# Run with verbose output
npm run validate:registry:verbose
# Run with fix suggestions
npm run validate:registry:fix
# Or run directly with bun
bun run scripts/registry/validate-registry.ts
bun run scripts/registry/validate-registry.ts -v
bun run scripts/registry/validate-registry.ts -f
Requirements:
- Bun runtime
Features:
- ✅ Fast execution (< 1 second)
- ✅ Easy to debug
- ✅ Type-safe
- ✅ Validates all registry paths
- ✅ Validates component dependencies
- ✅ Colored output
- ✅ Verbose mode
- ✅ Fix suggestions
Bash Version (Legacy)
Original bash script - still maintained for CI compatibility
# Run validation
./scripts/registry/validate-registry.sh
# Run with verbose output
./scripts/registry/validate-registry.sh -v
# Run with fix suggestions
./scripts/registry/validate-registry.sh -f
Requirements:
- bash
- jq
Note: The bash version may hang in some CI environments. The TypeScript version is recommended for local development.
What Gets Validated
Both scripts validate:
- Registry JSON Format - Ensures
registry.jsonis valid JSON - Component Paths - Verifies all file paths in the registry exist
- Component Dependencies - Validates that all dependencies reference existing components
Exit Codes
0- All paths valid, all dependencies valid1- Missing files or missing dependencies found2- Registry parse error or missing script dependencies
CI Integration
The GitHub Actions workflow (.github/workflows/validate-registry.yml) currently uses the bash version for compatibility with the base branch workflow file. Once this PR is merged, future PRs can use the TypeScript version.
Development
To modify the TypeScript validator:
- Edit
scripts/registry/validate-registry.ts - Test locally:
npm run validate:registry - Commit changes
The TypeScript version is the source of truth for new features.