013682c499
* fix: ContextScout falls back to global core/ when local core/ missing Users who install OAC globally have core standards at ~/.config/opencode/context/core/ but no local core/ directory. ContextScout now does a one-time check on startup: if local core/navigation.md doesn't exist, it checks the global path from paths.json. This resolves the ENOENT errors when agents try to read core/standards/ files that only exist globally. - paths.json: enabled global path (~/.config/opencode/context) - contextscout.md: added global_fallback rule with 2-glob cap - Fallback is ONLY for core/ files, never project-intelligence * docs: add context resolution explanation to README Explains how ContextScout resolves context files: local-first, global fallback only for core/ files, project-intelligence always local. Includes flow diagram, key rules, and common setup table. * fix: resolve installer failures and add comprehensive validation ## Summary Fixes critical installer failures where ContextScout and other components couldn't find their configuration files after installation. Adds comprehensive validation system to prevent future issues. ## Problems Fixed ### 1. Missing Critical Files (13 dead registry references) Files were referenced in registry but didn't exist on disk: - workflows-delegation (split into 3 files) - design-iteration (split into 8 files) - animation-patterns (split into 6 files) - adding-agent (split into 2 files) - adding-skill (split into 3 files) - navigation-design (split into 2 files) - external-libraries (split into 3 files) - claude-code-docs/* (directory removed) ### 2. Missing Infrastructure Files ContextScout failed after installation because 2 critical files weren't in registry: - paths.json - Context root configuration - navigation.md - Root navigation for discovery ### 3. Profile Inconsistencies Profiles referenced components that don't exist: - context:adding-skill → context:adding-skill-basics - context:animation-patterns → animation-basics/components/advanced - context:design-assets (removed - doesn't exist) - context:to-be-consumed/* (removed - directory doesn't exist) - skill:context-manager → subagent:context-manager ## Changes Made ### Registry (registry.json) - Removed 13 dead references - Added 27 new split-file entries - Added 2 critical infrastructure entries - Fixed all 5 profile configurations - Updated ContextScout dependencies - Updated agent-metadata.json dependencies ### New Validation Scripts - scripts/registry/check-dependencies.ts - Comprehensive dependency checker - scripts/tests/test-installer-files.sh - Installer simulation test - scripts/registry/fix-registry.py - Automated registry fixer - scripts/hooks/pre-commit - Git pre-commit hook ### Documentation - docs/maintenance/REGISTRY_FIXES_SUMMARY.md - docs/maintenance/CONTEXTSCOUT_FIX.md - docs/maintenance/REGISTRY_VALIDATION.md ## Validation Results Before: - 13 missing files in registry - 78 orphaned files on disk - 3 missing dependencies - Installer would fail After: - 244 total paths, 0 missing - 262 dependency checks, 0 failures - 0 orphaned dependencies - All profiles consistent - Installer works correctly ## Testing ```bash # Registry validation bun run scripts/registry/validate-registry.ts # ✓ All 244 paths valid # Dependency checking bun run scripts/registry/check-dependencies.ts # ✓ All 262 checks passed # Installer test ./scripts/tests/test-installer-files.sh --local --profile=essential # ✓ All files accessible ``` ## Usage ### Run validation before commits: ```bash bun run scripts/registry/check-dependencies.ts ``` ### Install pre-commit hook: ```bash cp scripts/hooks/pre-commit .git/hooks/pre-commit chmod +x .git/hooks/pre-commit ``` ### Test installer: ```bash ./scripts/tests/test-installer-files.sh --local --profile=essential ``` ## Impact This fix ensures: - ✓ Installer downloads all required files - ✓ ContextScout works immediately after install - ✓ No broken dependencies - ✓ No missing profile components - ✓ Future issues caught by validation ## Breaking Changes None - all changes are additive or fix broken references. ## Related - Fixes: ContextScout failing after installation - Prevents: Missing file errors during install - Adds: Comprehensive validation system * fix: resolve shellcheck warnings in test scripts - Remove unused REPO_URL variable from test-installer-files.sh - Add shellcheck disable comments for cleanup functions used via trap - Fixes CI failures in ShellCheck Analysis workflow * fix: resolve shellcheck errors across all scripts Fixed arithmetic expansion issues and code quality warnings: - Changed ((var++)) to POSIX-compliant 1 syntax - Fixed unquoted variables and grep pipe issues (SC2002, SC2143) - Added shellcheck disable comments for intentional patterns - Fixed variable initialization and return statement placement Scripts fixed: - scripts/tests/*.sh (5 files) - scripts/registry/*.sh (4 files) - scripts/validation/*.sh (2 files) - scripts/*.sh (2 files) - evals/framework/scripts/*.sh (2 files) All scripts now pass shellcheck --severity=warning * chore: trigger CI shellcheck validation
363 lines
10 KiB
JSON
363 lines
10 KiB
JSON
{
|
|
"$schema": "https://opencode.ai/schemas/agent-metadata.json",
|
|
"schema_version": "1.0.0",
|
|
"description": "Centralized metadata for OpenAgents Control agents. This file stores metadata that is not part of the OpenCode agent schema but is needed for registry management, installation, and documentation.",
|
|
"agents": {
|
|
"openagent": {
|
|
"id": "openagent",
|
|
"name": "OpenAgent",
|
|
"category": "core",
|
|
"type": "agent",
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"tags": ["universal", "coordination", "primary"],
|
|
"dependencies": [
|
|
"subagent:task-manager",
|
|
"subagent:batch-executor",
|
|
"subagent:documentation",
|
|
"subagent:contextscout",
|
|
"subagent:externalscout",
|
|
"context:standards-code",
|
|
"context:standards-docs",
|
|
"context:standards-tests",
|
|
"context:review-ref",
|
|
"context:delegation-ref",
|
|
"context:external-libraries-workflow"
|
|
]
|
|
},
|
|
"opencoder": {
|
|
"id": "opencoder",
|
|
"name": "OpenCoder",
|
|
"category": "core",
|
|
"type": "agent",
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"tags": ["development", "coding", "implementation"],
|
|
"dependencies": [
|
|
"subagent:documentation",
|
|
"subagent:task-manager",
|
|
"subagent:batch-executor",
|
|
"subagent:coder-agent",
|
|
"subagent:tester",
|
|
"subagent:reviewer",
|
|
"subagent:build-agent",
|
|
"subagent:contextscout",
|
|
"subagent:externalscout",
|
|
"context:standards-code",
|
|
"context:task-delegation-basics",
|
|
"context:component-planning",
|
|
"context:external-libraries-workflow"
|
|
]
|
|
},
|
|
"repo-manager": {
|
|
"id": "repo-manager",
|
|
"name": "Repo Manager",
|
|
"category": "meta",
|
|
"type": "agent",
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"tags": ["repository", "management", "orchestration"],
|
|
"dependencies": [
|
|
"subagent:task-manager",
|
|
"subagent:contextscout",
|
|
"subagent:documentation",
|
|
"subagent:coder-agent",
|
|
"subagent:tester",
|
|
"subagent:reviewer",
|
|
"subagent:build-agent"
|
|
]
|
|
},
|
|
"system-builder": {
|
|
"id": "system-builder",
|
|
"name": "System Builder",
|
|
"category": "meta",
|
|
"type": "agent",
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"tags": ["system-generation", "architecture", "scaffolding"],
|
|
"dependencies": [
|
|
"subagent:agent-generator",
|
|
"subagent:command-creator",
|
|
"subagent:domain-analyzer",
|
|
"subagent:context-organizer",
|
|
"subagent:workflow-designer"
|
|
]
|
|
},
|
|
"copywriter": {
|
|
"id": "copywriter",
|
|
"name": "Copywriter",
|
|
"category": "content",
|
|
"type": "agent",
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"tags": ["content", "marketing", "writing"],
|
|
"dependencies": [
|
|
"context:standards-docs"
|
|
]
|
|
},
|
|
"technical-writer": {
|
|
"id": "technical-writer",
|
|
"name": "Technical Writer",
|
|
"category": "content",
|
|
"type": "agent",
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"tags": ["documentation", "technical", "writing"],
|
|
"dependencies": [
|
|
"context:standards-docs"
|
|
]
|
|
},
|
|
"data-analyst": {
|
|
"id": "data-analyst",
|
|
"name": "Data Analyst",
|
|
"category": "data",
|
|
"type": "agent",
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"tags": ["data", "analysis", "visualization"],
|
|
"dependencies": []
|
|
},
|
|
"eval-runner": {
|
|
"id": "eval-runner",
|
|
"name": "Eval Runner",
|
|
"category": "testing",
|
|
"type": "agent",
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"tags": ["testing", "evaluation", "quality"],
|
|
"dependencies": [
|
|
"context:standards-tests"
|
|
]
|
|
},
|
|
"task-manager": {
|
|
"id": "task-manager",
|
|
"name": "TaskManager",
|
|
"category": "subagents/core",
|
|
"type": "subagent",
|
|
"version": "2.0.0",
|
|
"author": "opencode",
|
|
"tags": ["task-breakdown", "planning", "coordination"],
|
|
"dependencies": [
|
|
"context:task-delegation-basics"
|
|
]
|
|
},
|
|
"batch-executor": {
|
|
"id": "batch-executor",
|
|
"name": "BatchExecutor",
|
|
"category": "subagents/core",
|
|
"type": "subagent",
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"tags": ["parallel-execution", "batch-management", "coordination"],
|
|
"dependencies": [
|
|
"subagent:coder-agent",
|
|
"subagent:task-manager"
|
|
]
|
|
},
|
|
"documentation": {
|
|
"id": "documentation",
|
|
"name": "DocWriter",
|
|
"category": "subagents/core",
|
|
"type": "subagent",
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"tags": ["documentation", "writing"],
|
|
"dependencies": [
|
|
"context:standards-docs"
|
|
]
|
|
},
|
|
"contextscout": {
|
|
"id": "contextscout",
|
|
"name": "ContextScout",
|
|
"category": "subagents/core",
|
|
"type": "subagent",
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"tags": ["context", "discovery", "search"],
|
|
"dependencies": []
|
|
},
|
|
"externalscout": {
|
|
"id": "externalscout",
|
|
"name": "ExternalScout",
|
|
"category": "subagents/core",
|
|
"type": "subagent",
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"tags": ["external", "documentation", "search"],
|
|
"dependencies": []
|
|
},
|
|
"context-manager": {
|
|
"id": "context-manager",
|
|
"name": "ContextManager",
|
|
"category": "subagents/core",
|
|
"type": "subagent",
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"tags": ["context", "management", "organization"],
|
|
"dependencies": []
|
|
},
|
|
"context-retriever": {
|
|
"id": "context-retriever",
|
|
"name": "Context Retriever",
|
|
"category": "subagents/core",
|
|
"type": "subagent",
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"tags": ["context", "retrieval", "search"],
|
|
"dependencies": []
|
|
},
|
|
"coder-agent": {
|
|
"id": "coder-agent",
|
|
"name": "CoderAgent",
|
|
"category": "subagents/code",
|
|
"type": "subagent",
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"tags": ["coding", "implementation"],
|
|
"dependencies": [
|
|
"context:standards-code"
|
|
]
|
|
},
|
|
"tester": {
|
|
"id": "tester",
|
|
"name": "TestEngineer",
|
|
"category": "subagents/code",
|
|
"type": "subagent",
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"tags": ["testing", "tdd", "quality"],
|
|
"dependencies": [
|
|
"context:standards-tests"
|
|
]
|
|
},
|
|
"reviewer": {
|
|
"id": "reviewer",
|
|
"name": "CodeReviewer",
|
|
"category": "subagents/code",
|
|
"type": "subagent",
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"tags": ["review", "security", "quality"],
|
|
"dependencies": [
|
|
"context:standards-code",
|
|
"context:review-ref"
|
|
]
|
|
},
|
|
"build-agent": {
|
|
"id": "build-agent",
|
|
"name": "BuildAgent",
|
|
"category": "subagents/code",
|
|
"type": "subagent",
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"tags": ["build", "validation", "type-checking"],
|
|
"dependencies": []
|
|
},
|
|
"frontend-specialist": {
|
|
"id": "frontend-specialist",
|
|
"name": "OpenFrontendSpecialist",
|
|
"category": "subagents/development",
|
|
"type": "subagent",
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"tags": ["frontend", "ui", "design"],
|
|
"dependencies": [
|
|
"context:standards-code"
|
|
]
|
|
},
|
|
"devops-specialist": {
|
|
"id": "devops-specialist",
|
|
"name": "OpenDevopsSpecialist",
|
|
"category": "subagents/development",
|
|
"type": "subagent",
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"tags": ["devops", "ci-cd", "infrastructure"],
|
|
"dependencies": []
|
|
},
|
|
"agent-generator": {
|
|
"id": "agent-generator",
|
|
"name": "AgentGenerator",
|
|
"category": "subagents/system-builder",
|
|
"type": "subagent",
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"tags": ["generation", "agents", "scaffolding"],
|
|
"dependencies": []
|
|
},
|
|
"command-creator": {
|
|
"id": "command-creator",
|
|
"name": "CommandCreator",
|
|
"category": "subagents/system-builder",
|
|
"type": "subagent",
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"tags": ["commands", "generation", "scaffolding"],
|
|
"dependencies": []
|
|
},
|
|
"domain-analyzer": {
|
|
"id": "domain-analyzer",
|
|
"name": "DomainAnalyzer",
|
|
"category": "subagents/system-builder",
|
|
"type": "subagent",
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"tags": ["analysis", "domain", "architecture"],
|
|
"dependencies": []
|
|
},
|
|
"context-organizer": {
|
|
"id": "context-organizer",
|
|
"name": "ContextOrganizer",
|
|
"category": "subagents/system-builder",
|
|
"type": "subagent",
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"tags": ["context", "organization", "structure"],
|
|
"dependencies": []
|
|
},
|
|
"workflow-designer": {
|
|
"id": "workflow-designer",
|
|
"name": "WorkflowDesigner",
|
|
"category": "subagents/system-builder",
|
|
"type": "subagent",
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"tags": ["workflow", "design", "architecture"],
|
|
"dependencies": []
|
|
},
|
|
"image-specialist": {
|
|
"id": "image-specialist",
|
|
"name": "Image Specialist",
|
|
"category": "subagents/utils",
|
|
"type": "subagent",
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"tags": ["images", "editing", "generation"],
|
|
"dependencies": []
|
|
},
|
|
"simple-responder": {
|
|
"id": "simple-responder",
|
|
"name": "Simple Responder",
|
|
"category": "subagents/test",
|
|
"type": "subagent",
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"tags": ["testing", "evaluation"],
|
|
"dependencies": []
|
|
}
|
|
},
|
|
"defaults": {
|
|
"agent": {
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"type": "agent",
|
|
"tags": []
|
|
},
|
|
"subagent": {
|
|
"version": "1.0.0",
|
|
"author": "opencode",
|
|
"type": "subagent",
|
|
"tags": []
|
|
}
|
|
}
|
|
}
|