Skip to content

armgit / ECC

Public Imported from GitHub
0

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

feat: add command registry and coverage checks (#1906)

Affaan Mustafaf7315016c047
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 7f8cb3c0e..2a7c021a4 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -220,6 +220,10 @@ jobs:
run: node scripts/ci/catalog.js --text
continue-on-error: false
+ - name: Validate command registry
+ run: npm run command-registry:check
+ continue-on-error: false
+
- name: Check unicode safety
run: node scripts/ci/check-unicode-safety.js
continue-on-error: false
@@ -253,6 +257,33 @@ jobs:
- name: Run supply-chain IOC scan
run: npm run security:ioc-scan
+ coverage:
+ name: Coverage
+ runs-on: ubuntu-latest
+ timeout-minutes: 10
+
+ steps:
+ - name: Checkout
+ uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+
+ - name: Setup Node.js
+ uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
+ with:
+ node-version: '20.x'
+
+ - name: Install dependencies
+ run: npm ci --ignore-scripts
+
+ - name: Run coverage
+ run: npm run coverage
+
+ - name: Upload coverage report
+ if: always()
+ uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+ with:
+ name: coverage-ubuntu-node20-npm
+ path: coverage/
+
lint:
name: Lint
runs-on: ubuntu-latest
diff --git a/README.md b/README.md
index 663c8fcc0..a7c5ee8f2 100644
--- a/README.md
+++ b/README.md
@@ -89,7 +89,7 @@ This repo is the raw code only. The guides explain everything.
### v2.0.0-rc.1 — Surface Refresh, Operator Workflows, and ECC 2.0 Alpha (Apr 2026)
- **Dashboard GUI** — New Tkinter-based desktop application (`ecc_dashboard.py` or `npm run dashboard`) with dark/light theme toggle, font customization, and project logo in header and taskbar.
-- **Public surface synced to the live repo** — metadata, catalog counts, plugin manifests, and install-facing docs now match the actual OSS surface: 55 agents, 208 skills, and 72 legacy command shims.
+- **Public surface synced to the live repo** — metadata, catalog counts, plugin manifests, and install-facing docs now match the actual OSS surface: 60 agents, 229 skills, and 75 legacy command shims.
- **Operator and outbound workflow expansion** — `brand-voice`, `social-graph-ranker`, `connections-optimizer`, `customer-billing-ops`, `ecc-tools-cost-audit`, `google-workspace-ops`, `project-flow-ops`, and `workspace-surface-audit` round out the operator lane.
- **Media and launch tooling** — `manim-video`, `remotion-video-creation`, and upgraded social publishing surfaces make technical explainers and launch content part of the same system.
- **Framework and product surface growth** — `nestjs-patterns`, richer Codex/OpenCode install surfaces, and expanded cross-harness packaging keep the repo usable beyond Claude Code alone.
diff --git a/docs/COMMAND-REGISTRY.json b/docs/COMMAND-REGISTRY.json
new file mode 100644
index 000000000..0f9e4de2f
--- /dev/null
+++ b/docs/COMMAND-REGISTRY.json
@@ -0,0 +1,898 @@
+{
+ "schemaVersion": 1,
+ "totalCommands": 75,
+ "commands": [
+ {
+ "command": "aside",
+ "description": "Answer a quick side question without interrupting or losing context from the current task. Resume work automatically after answering.",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/aside.md"
+ },
+ {
+ "command": "auto-update",
+ "description": "Pull the latest ECC repo changes and reinstall the current managed targets.",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/auto-update.md"
+ },
+ {
+ "command": "build-fix",
+ "description": "Detect the project build system and incrementally fix build/type errors with minimal safe changes.",
+ "type": "refactoring",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/build-fix.md"
+ },
+ {
+ "command": "checkpoint",
+ "description": "Create, verify, or list workflow checkpoints after running verification checks.",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/checkpoint.md"
+ },
+ {
+ "command": "code-review",
+ "description": "Code review — local uncommitted changes or GitHub PR (pass PR number/URL for PR mode)",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/code-review.md"
+ },
+ {
+ "command": "cost-report",
+ "description": "Generate a local Claude Code cost report from a cost-tracker SQLite database.",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/cost-report.md"
+ },
+ {
+ "command": "cpp-build",
+ "description": "Fix C++ build errors, CMake issues, and linker problems incrementally. Invokes the cpp-build-resolver agent for minimal, surgical fixes.",
+ "type": "testing",
+ "primaryAgents": [
+ "cpp-build-resolver"
+ ],
+ "allAgents": [
+ "cpp-build-resolver"
+ ],
+ "skills": [
+ "cpp-coding-standards"
+ ],
+ "path": "commands/cpp-build.md"
+ },
+ {
+ "command": "cpp-review",
+ "description": "Comprehensive C++ code review for memory safety, modern C++ idioms, concurrency, and security. Invokes the cpp-reviewer agent.",
+ "type": "testing",
+ "primaryAgents": [
+ "cpp-reviewer"
+ ],
+ "allAgents": [
+ "cpp-reviewer"
+ ],
+ "skills": [
+ "cpp-coding-standards",
+ "cpp-testing"
+ ],
+ "path": "commands/cpp-review.md"
+ },
+ {
+ "command": "cpp-test",
+ "description": "Enforce TDD workflow for C++. Write GoogleTest tests first, then implement. Verify coverage with gcov/lcov.",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [
+ "cpp-testing",
+ "tdd-workflow"
+ ],
+ "path": "commands/cpp-test.md"
+ },
+ {
+ "command": "ecc-guide",
+ "description": "Navigate ECC's current agents, skills, commands, hooks, install profiles, and docs from the live repository surface.",
+ "type": "review",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [
+ "ecc-guide",
+ "security-scan"
+ ],
+ "path": "commands/ecc-guide.md"
+ },
+ {
+ "command": "evolve",
+ "description": "Analyze instincts and suggest or generate evolved structures",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [
+ "continuous-learning-v2"
+ ],
+ "path": "commands/evolve.md"
+ },
+ {
+ "command": "fastapi-review",
+ "description": "Review a FastAPI application for architecture, async correctness, dependency injection, Pydantic schemas, security, performance, and testability.",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/fastapi-review.md"
+ },
+ {
+ "command": "feature-dev",
+ "description": "Guided feature development with codebase understanding and architecture focus",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/feature-dev.md"
+ },
+ {
+ "command": "flutter-build",
+ "description": "Fix Dart analyzer errors and Flutter build failures incrementally. Invokes the dart-build-resolver agent for minimal, surgical fixes.",
+ "type": "testing",
+ "primaryAgents": [
+ "dart-build-resolver"
+ ],
+ "allAgents": [
+ "dart-build-resolver"
+ ],
+ "skills": [
+ "flutter-dart-code-review"
+ ],
+ "path": "commands/flutter-build.md"
+ },
+ {
+ "command": "flutter-review",
+ "description": "Review Flutter/Dart code for idiomatic patterns, widget best practices, state management, performance, accessibility, and security. Invokes the flutter-reviewer agent.",
+ "type": "testing",
+ "primaryAgents": [
+ "flutter-reviewer"
+ ],
+ "allAgents": [
+ "flutter-reviewer"
+ ],
+ "skills": [
+ "flutter-dart-code-review"
+ ],
+ "path": "commands/flutter-review.md"
+ },
+ {
+ "command": "flutter-test",
+ "description": "Run Flutter/Dart tests, report failures, and incrementally fix test issues. Covers unit, widget, golden, and integration tests.",
+ "type": "testing",
+ "primaryAgents": [
+ "dart-build-resolver",
+ "flutter-reviewer"
+ ],
+ "allAgents": [
+ "dart-build-resolver",
+ "flutter-reviewer"
+ ],
+ "skills": [
+ "flutter-dart-code-review"
+ ],
+ "path": "commands/flutter-test.md"
+ },
+ {
+ "command": "gan-build",
+ "description": "Run a generator/evaluator build loop for implementation tasks with bounded iterations and scoring.",
+ "type": "orchestration",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/gan-build.md"
+ },
+ {
+ "command": "gan-design",
+ "description": "Run a generator/evaluator design loop for frontend or visual work with bounded iterations and scoring.",
+ "type": "planning",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/gan-design.md"
+ },
+ {
+ "command": "go-build",
+ "description": "Fix Go build errors, go vet warnings, and linter issues incrementally. Invokes the go-build-resolver agent for minimal, surgical fixes.",
+ "type": "testing",
+ "primaryAgents": [
+ "go-build-resolver"
+ ],
+ "allAgents": [
+ "go-build-resolver"
+ ],
+ "skills": [
+ "golang-patterns"
+ ],
+ "path": "commands/go-build.md"
+ },
+ {
+ "command": "go-review",
+ "description": "Comprehensive Go code review for idiomatic patterns, concurrency safety, error handling, and security. Invokes the go-reviewer agent.",
+ "type": "testing",
+ "primaryAgents": [
+ "go-reviewer"
+ ],
+ "allAgents": [
+ "go-reviewer"
+ ],
+ "skills": [
+ "golang-patterns",
+ "golang-testing"
+ ],
+ "path": "commands/go-review.md"
+ },
+ {
+ "command": "go-test",
+ "description": "Enforce TDD workflow for Go. Write table-driven tests first, then implement. Verify 80%+ coverage with go test -cover.",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [
+ "golang-testing",
+ "tdd-workflow"
+ ],
+ "path": "commands/go-test.md"
+ },
+ {
+ "command": "gradle-build",
+ "description": "Fix Gradle build errors for Android and KMP projects",
+ "type": "build",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/gradle-build.md"
+ },
+ {
+ "command": "harness-audit",
+ "description": "Run a deterministic repository harness audit and return a prioritized scorecard.",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/harness-audit.md"
+ },
+ {
+ "command": "hookify-configure",
+ "description": "Enable or disable hookify rules interactively",
+ "type": "general",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/hookify-configure.md"
+ },
+ {
+ "command": "hookify-help",
+ "description": "Get help with the hookify system",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/hookify-help.md"
+ },
+ {
+ "command": "hookify-list",
+ "description": "List all configured hookify rules",
+ "type": "general",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/hookify-list.md"
+ },
+ {
+ "command": "hookify",
+ "description": "Create hooks to prevent unwanted behaviors from conversation analysis or explicit instructions",
+ "type": "general",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/hookify.md"
+ },
+ {
+ "command": "instinct-export",
+ "description": "Export instincts from project/global scope to a file",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/instinct-export.md"
+ },
+ {
+ "command": "instinct-import",
+ "description": "Import instincts from file or URL into project/global scope",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [
+ "continuous-learning-v2"
+ ],
+ "path": "commands/instinct-import.md"
+ },
+ {
+ "command": "instinct-status",
+ "description": "Show learned instincts (project + global) with confidence",
+ "type": "review",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [
+ "continuous-learning-v2"
+ ],
+ "path": "commands/instinct-status.md"
+ },
+ {
+ "command": "jira",
+ "description": "Retrieve a Jira ticket, analyze requirements, update status, or add comments. Uses the jira-integration skill and MCP or REST API.",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [
+ "jira-integration"
+ ],
+ "path": "commands/jira.md"
+ },
+ {
+ "command": "kotlin-build",
+ "description": "Fix Kotlin/Gradle build errors, compiler warnings, and dependency issues incrementally. Invokes the kotlin-build-resolver agent for minimal, surgical fixes.",
+ "type": "testing",
+ "primaryAgents": [
+ "kotlin-build-resolver"
+ ],
+ "allAgents": [
+ "kotlin-build-resolver"
+ ],
+ "skills": [
+ "kotlin-patterns"
+ ],
+ "path": "commands/kotlin-build.md"
+ },
+ {
+ "command": "kotlin-review",
+ "description": "Comprehensive Kotlin code review for idiomatic patterns, null safety, coroutine safety, and security. Invokes the kotlin-reviewer agent.",
+ "type": "testing",
+ "primaryAgents": [
+ "kotlin-reviewer"
+ ],
+ "allAgents": [
+ "kotlin-reviewer"
+ ],
+ "skills": [
+ "kotlin-patterns",
+ "kotlin-testing"
+ ],
+ "path": "commands/kotlin-review.md"
+ },
+ {
+ "command": "kotlin-test",
+ "description": "Enforce TDD workflow for Kotlin. Write Kotest tests first, then implement. Verify 80%+ coverage with Kover.",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [
+ "kotlin-testing",
+ "tdd-workflow"
+ ],
+ "path": "commands/kotlin-test.md"
+ },
+ {
+ "command": "learn-eval",
+ "description": "Extract reusable patterns from the session, self-evaluate quality before saving, and determine the right save location (Global vs Project).",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/learn-eval.md"
+ },
+ {
+ "command": "learn",
+ "description": "Extract reusable patterns from the current session and save them as candidate skills or guidance.",
+ "type": "review",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/learn.md"
+ },
+ {
+ "command": "loop-start",
+ "description": "Start a managed autonomous loop pattern with safety defaults and explicit stop conditions.",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/loop-start.md"
+ },
+ {
+ "command": "loop-status",
+ "description": "Inspect active loop state, progress, failure signals, and recommended intervention.",
+ "type": "general",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/loop-status.md"
+ },
+ {
+ "command": "model-route",
+ "description": "Recommend the best model tier for the current task based on complexity, risk, and budget.",
+ "type": "review",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/model-route.md"
+ },
+ {
+ "command": "multi-backend",
+ "description": "Run a backend-focused multi-model workflow for APIs, algorithms, data, and business logic.",
+ "type": "orchestration",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/multi-backend.md"
+ },
+ {
+ "command": "multi-execute",
+ "description": "Execute a multi-model implementation plan while preserving Claude as the only filesystem writer.",
+ "type": "orchestration",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/multi-execute.md"
+ },
+ {
+ "command": "multi-frontend",
+ "description": "Run a frontend-focused multi-model workflow for components, layouts, animation, and UI polish.",
+ "type": "orchestration",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/multi-frontend.md"
+ },
+ {
+ "command": "multi-plan",
+ "description": "Create a multi-model implementation plan without modifying production code.",
+ "type": "orchestration",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [
+ "accessibility"
+ ],
+ "path": "commands/multi-plan.md"
+ },
+ {
+ "command": "multi-workflow",
+ "description": "Run a full multi-model development workflow with research, planning, execution, optimization, and review.",
+ "type": "orchestration",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/multi-workflow.md"
+ },
+ {
+ "command": "plan-prd",
+ "description": "Generate a lean, problem-first PRD and hand off to /plan for implementation planning.",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/plan-prd.md"
+ },
+ {
+ "command": "plan",
+ "description": "Restate requirements, assess risks, and create step-by-step implementation plan. WAIT for user CONFIRM before touching any code.",
+ "type": "testing",
+ "primaryAgents": [
+ "planner"
+ ],
+ "allAgents": [
+ "planner"
+ ],
+ "skills": [],
+ "path": "commands/plan.md"
+ },
+ {
+ "command": "pm2",
+ "description": "Analyze a project and generate PM2 service commands for detected frontend, backend, or database services.",
+ "type": "general",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/pm2.md"
+ },
+ {
+ "command": "pr",
+ "description": "Create a GitHub PR from current branch with unpushed commits — discovers templates, analyzes changes, pushes",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/pr.md"
+ },
+ {
+ "command": "project-init",
+ "description": "Detect a project's stack and produce a dry-run ECC onboarding plan using the repository's install manifests and stack mappings.",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [
+ "ecc-guide"
+ ],
+ "path": "commands/project-init.md"
+ },
+ {
+ "command": "projects",
+ "description": "List known projects and their instinct statistics",
+ "type": "general",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [
+ "continuous-learning-v2"
+ ],
+ "path": "commands/projects.md"
+ },
+ {
+ "command": "promote",
+ "description": "Promote project-scoped instincts to global scope",
+ "type": "review",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [
+ "continuous-learning-v2"
+ ],
+ "path": "commands/promote.md"
+ },
+ {
+ "command": "prp-commit",
+ "description": "Quick commit with natural language file targeting — describe what to commit in plain English",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/prp-commit.md"
+ },
+ {
+ "command": "prp-implement",
+ "description": "Execute an implementation plan with rigorous validation loops",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/prp-implement.md"
+ },
+ {
+ "command": "prp-plan",
+ "description": "Create comprehensive feature implementation plan with codebase analysis and pattern extraction",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/prp-plan.md"
+ },
+ {
+ "command": "prp-pr",
+ "description": "Create a GitHub PR from current branch with unpushed commits — discovers templates, analyzes changes, pushes",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/prp-pr.md"
+ },
+ {
+ "command": "prp-prd",
+ "description": "Interactive PRD generator - problem-first, hypothesis-driven product spec with back-and-forth questioning",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/prp-prd.md"
+ },
+ {
+ "command": "prune",
+ "description": "Delete pending instincts older than 30 days that were never promoted",
+ "type": "review",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [
+ "continuous-learning-v2"
+ ],
+ "path": "commands/prune.md"
+ },
+ {
+ "command": "python-review",
+ "description": "Comprehensive Python code review for PEP 8 compliance, type hints, security, and Pythonic idioms. Invokes the python-reviewer agent.",
+ "type": "testing",
+ "primaryAgents": [
+ "python-reviewer"
+ ],
+ "allAgents": [
+ "python-reviewer"
+ ],
+ "skills": [
+ "python-patterns",
+ "python-testing"
+ ],
+ "path": "commands/python-review.md"
+ },
+ {
+ "command": "quality-gate",
+ "description": "Run the ECC quality pipeline for a file or project scope and report remediation steps.",
+ "type": "general",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/quality-gate.md"
+ },
+ {
+ "command": "refactor-clean",
+ "description": "Safely identify and remove dead code with verification after each change.",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/refactor-clean.md"
+ },
+ {
+ "command": "resume-session",
+ "description": "Load the most recent session file from ~/.claude/session-data/ and resume work with full context from where the last session ended.",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/resume-session.md"
+ },
+ {
+ "command": "review-pr",
+ "description": "Comprehensive PR review using specialized agents",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/review-pr.md"
+ },
+ {
+ "command": "rust-build",
+ "description": "Fix Rust build errors, borrow checker issues, and dependency problems incrementally. Invokes the rust-build-resolver agent for minimal, surgical fixes.",
+ "type": "testing",
+ "primaryAgents": [
+ "rust-build-resolver"
+ ],
+ "allAgents": [
+ "rust-build-resolver"
+ ],
+ "skills": [
+ "rust-patterns"
+ ],
+ "path": "commands/rust-build.md"
+ },
+ {
+ "command": "rust-review",
+ "description": "Comprehensive Rust code review for ownership, lifetimes, error handling, unsafe usage, and idiomatic patterns. Invokes the rust-reviewer agent.",
+ "type": "testing",
+ "primaryAgents": [
+ "rust-reviewer"
+ ],
+ "allAgents": [
+ "rust-reviewer"
+ ],
+ "skills": [
+ "rust-patterns",
+ "rust-testing"
+ ],
+ "path": "commands/rust-review.md"
+ },
+ {
+ "command": "rust-test",
+ "description": "Enforce TDD workflow for Rust. Write tests first, then implement. Verify 80%+ coverage with cargo-llvm-cov.",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [
+ "rust-patterns",
+ "rust-testing"
+ ],
+ "path": "commands/rust-test.md"
+ },
+ {
+ "command": "santa-loop",
+ "description": "Adversarial dual-review convergence loop — two independent model reviewers must both approve before code ships.",
+ "type": "review",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/santa-loop.md"
+ },
+ {
+ "command": "save-session",
+ "description": "Save current session state to a dated file in ~/.claude/session-data/ so work can be resumed in a future session with full context.",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/save-session.md"
+ },
+ {
+ "command": "security-scan",
+ "description": "Run AgentShield against agent, hook, MCP, permission, and secret surfaces.",
+ "type": "review",
+ "primaryAgents": [
+ "security-reviewer"
+ ],
+ "allAgents": [
+ "security-reviewer"
+ ],
+ "skills": [
+ "security-scan"
+ ],
+ "path": "commands/security-scan.md"
+ },
+ {
+ "command": "sessions",
+ "description": "Manage Claude Code session history, aliases, and session metadata.",
+ "type": "general",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/sessions.md"
+ },
+ {
+ "command": "setup-pm",
+ "description": "Configure your preferred package manager (npm/pnpm/yarn/bun)",
+ "type": "build",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/setup-pm.md"
+ },
+ {
+ "command": "skill-create",
+ "description": "Analyze local git history to extract coding patterns and generate SKILL.md files. Local version of the Skill Creator GitHub App.",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/skill-create.md"
+ },
+ {
+ "command": "skill-health",
+ "description": "Show skill portfolio health dashboard with charts and analytics",
+ "type": "review",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/skill-health.md"
+ },
+ {
+ "command": "test-coverage",
+ "description": "Analyze coverage, identify gaps, and generate missing tests toward the target threshold.",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/test-coverage.md"
+ },
+ {
+ "command": "update-codemaps",
+ "description": "Scan project structure and generate token-lean architecture codemaps.",
+ "type": "planning",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/update-codemaps.md"
+ },
+ {
+ "command": "update-docs",
+ "description": "Sync documentation from source-of-truth files such as scripts, schemas, routes, and exports.",
+ "type": "testing",
+ "primaryAgents": [],
+ "allAgents": [],
+ "skills": [],
+ "path": "commands/update-docs.md"
+ }
+ ],
+ "statistics": {
+ "byType": {
+ "build": 2,
+ "general": 8,
+ "orchestration": 6,
+ "planning": 2,
+ "refactoring": 1,
+ "review": 9,
+ "testing": 47
+ },
+ "topAgents": [
+ {
+ "agent": "dart-build-resolver",
+ "count": 2
+ },
+ {
+ "agent": "flutter-reviewer",
+ "count": 2
+ },
+ {
+ "agent": "cpp-build-resolver",
+ "count": 1
+ },
+ {
+ "agent": "cpp-reviewer",
+ "count": 1
+ },
+ {
+ "agent": "go-build-resolver",
+ "count": 1
+ },
+ {
+ "agent": "go-reviewer",
+ "count": 1
+ },
+ {
+ "agent": "kotlin-build-resolver",
+ "count": 1
+ },
+ {
+ "agent": "kotlin-reviewer",
+ "count": 1
+ },
+ {
+ "agent": "planner",
+ "count": 1
+ },
+ {
+ "agent": "python-reviewer",
+ "count": 1
+ }
+ ],
+ "topSkills": [
+ {
+ "skill": "continuous-learning-v2",
+ "count": 6
+ },
+ {
+ "skill": "flutter-dart-code-review",
+ "count": 3
+ },
+ {
+ "skill": "rust-patterns",
+ "count": 3
+ },
+ {
+ "skill": "tdd-workflow",
+ "count": 3
+ },
+ {
+ "skill": "cpp-coding-standards",
+ "count": 2
+ },
+ {
+ "skill": "cpp-testing",
+ "count": 2
+ },
+ {
+ "skill": "ecc-guide",
+ "count": 2
+ },
+ {
+ "skill": "golang-patterns",
+ "count": 2
+ },
+ {
+ "skill": "golang-testing",
+ "count": 2
+ },
+ {
+ "skill": "kotlin-patterns",
+ "count": 2
+ }
+ ]
+ }
+}
diff --git a/package.json b/package.json
index 098c4ada4..8c30dca4b 100644
--- a/package.json
+++ b/package.json
@@ -286,6 +286,9 @@
"postinstall": "echo '\\n ecc-universal installed!\\n Run: npx ecc typescript\\n Compat: npx ecc-install typescript\\n Docs: https://github.com/affaan-m/everything-claude-code\\n'",
"catalog:check": "node scripts/ci/catalog.js --text",
"catalog:sync": "node scripts/ci/catalog.js --write --text",
+ "command-registry:generate": "node scripts/ci/generate-command-registry.js",
+ "command-registry:write": "node scripts/ci/generate-command-registry.js --write",
+ "command-registry:check": "node scripts/ci/generate-command-registry.js --check",
"lint": "eslint . && markdownlint '**/*.md' --ignore node_modules",
"harness:adapters": "node scripts/harness-adapter-compliance.js",
"harness:audit": "node scripts/harness-audit.js",
@@ -295,7 +298,7 @@
"orchestrate:status": "node scripts/orchestration-status.js",
"orchestrate:worker": "bash scripts/orchestrate-codex-worker.sh",
"orchestrate:tmux": "node scripts/orchestrate-worktrees.js",
- "test": "node scripts/ci/check-unicode-safety.js && node scripts/ci/validate-agents.js && node scripts/ci/validate-commands.js && node scripts/ci/validate-rules.js && node scripts/ci/validate-skills.js && node scripts/ci/validate-hooks.js && node scripts/ci/validate-install-manifests.js && node scripts/ci/validate-no-personal-paths.js && npm run catalog:check && node tests/run-all.js",
+ "test": "node scripts/ci/check-unicode-safety.js && node scripts/ci/validate-agents.js && node scripts/ci/validate-commands.js && node scripts/ci/validate-rules.js && node scripts/ci/validate-skills.js && node scripts/ci/validate-hooks.js && node scripts/ci/validate-install-manifests.js && node scripts/ci/validate-no-personal-paths.js && npm run catalog:check && npm run command-registry:check && node tests/run-all.js",
"coverage": "c8 --all --include=\"scripts/**/*.js\" --check-coverage --lines 80 --functions 80 --branches 80 --statements 80 --reporter=text --reporter=lcov node tests/run-all.js",
"build:opencode": "node scripts/build-opencode.js",
"prepack": "npm run build:opencode",
diff --git a/scripts/ci/catalog.js b/scripts/ci/catalog.js
index 0d18089bc..e5fac9943 100644
--- a/scripts/ci/catalog.js
+++ b/scripts/ci/catalog.js
@@ -101,6 +101,19 @@ function parseReadmeExpectations(readmeContent) {
{ category: 'commands', mode: 'exact', expected: Number(quickStartMatch[3]), source: 'README.md quick-start summary' }
);
+ const releaseNoteMatch = readmeContent.match(
+ /actual OSS surface:\s+(\d+)\s+agents,\s+(\d+)\s+skills,\s+and\s+(\d+)\s+legacy command shims/i
+ );
+ if (!releaseNoteMatch) {
+ throw new Error('README.md is missing the rc.1 release-note catalog summary');
+ }
+
+ expectations.push(
+ { category: 'agents', mode: 'exact', expected: Number(releaseNoteMatch[1]), source: 'README.md rc.1 release-note summary' },
+ { category: 'skills', mode: 'exact', expected: Number(releaseNoteMatch[2]), source: 'README.md rc.1 release-note summary' },
+ { category: 'commands', mode: 'exact', expected: Number(releaseNoteMatch[3]), source: 'README.md rc.1 release-note summary' }
+ );
+
const projectTreeAgentsMatch = readmeContent.match(/^\|\s*--\s*agents\/\s*#\s*(\d+)\s+specialized subagents for delegation\s*$/im);
if (!projectTreeAgentsMatch) {
throw new Error('README.md project tree is missing the agents count');
@@ -415,6 +428,13 @@ function syncEnglishReadme(content, catalog) {
`${prefix}${catalog.agents.count}${agentsSuffix}${catalog.skills.count}${skillsSuffix}${catalog.commands.count} legacy command shims`,
'README.md quick-start summary'
);
+ nextContent = replaceOrThrow(
+ nextContent,
+ /(actual OSS surface:\s+)(\d+)(\s+agents,\s+)(\d+)(\s+skills,\s+and\s+)(\d+)(\s+legacy command shims)/i,
+ (_, prefix, __, agentsSuffix, ___, skillsSuffix, ____, commandsSuffix) =>
+ `${prefix}${catalog.agents.count}${agentsSuffix}${catalog.skills.count}${skillsSuffix}${catalog.commands.count}${commandsSuffix}`,
+ 'README.md rc.1 release-note summary'
+ );
nextContent = replaceOrThrow(
nextContent,
/^(\|\s*--\s*agents\/\s*#\s*)(\d+)(\s+specialized subagents for delegation\s*)$/im,
diff --git a/scripts/ci/generate-command-registry.js b/scripts/ci/generate-command-registry.js
new file mode 100644
index 000000000..838c65641
--- /dev/null
+++ b/scripts/ci/generate-command-registry.js
@@ -0,0 +1,318 @@
+#!/usr/bin/env node
+/**
+ * Generate a deterministic command-to-agent/skill registry.
+ *
+ * Usage:
+ * node scripts/ci/generate-command-registry.js
+ * node scripts/ci/generate-command-registry.js --json
+ * node scripts/ci/generate-command-registry.js --write
+ * node scripts/ci/generate-command-registry.js --check
+ */
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const ROOT = path.join(__dirname, '../..');
+const DEFAULT_OUTPUT_PATH = path.join(ROOT, 'docs', 'COMMAND-REGISTRY.json');
+
+function normalizePath(relativePath) {
+ return relativePath.split(path.sep).join('/');
+}
+
+function listMarkdownFiles(root, relativeDir) {
+ const directory = path.join(root, relativeDir);
+ if (!fs.existsSync(directory)) {
+ return [];
+ }
+
+ return fs.readdirSync(directory, { withFileTypes: true })
+ .filter(entry => entry.isFile() && entry.name.endsWith('.md'))
+ .map(entry => entry.name)
+ .sort();
+}
+
+function listKnownAgents(root) {
+ return new Set(
+ listMarkdownFiles(root, 'agents')
+ .map(filename => filename.replace(/\.md$/, ''))
+ );
+}
+
+function listKnownSkills(root) {
+ const skillsDir = path.join(root, 'skills');
+ if (!fs.existsSync(skillsDir)) {
+ return new Set();
+ }
+
+ return new Set(
+ fs.readdirSync(skillsDir, { withFileTypes: true })
+ .filter(entry => (
+ entry.isDirectory() && fs.existsSync(path.join(skillsDir, entry.name, 'SKILL.md'))
+ ))
+ .map(entry => entry.name)
+ .sort()
+ );
+}
+
+function cleanYamlScalar(value) {
+ return value.trim()
+ .replace(/^['"]/, '')
+ .replace(/['"]$/, '');
+}
+
+function extractDescription(content) {
+ const frontmatter = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+ if (frontmatter) {
+ const description = frontmatter[1].match(/^description:\s*(.+)$/m);
+ if (description) {
+ return cleanYamlScalar(description[1]);
+ }
+ }
+
+ const heading = content.match(/^#\s+(.+)$/m);
+ return heading ? heading[1].trim() : '';
+}
+
+function collectKnownReferences(content, patterns, knownNames) {
+ const refs = new Set();
+
+ for (const pattern of patterns) {
+ for (const match of content.matchAll(pattern)) {
+ const ref = match[1];
+ if (knownNames.has(ref)) {
+ refs.add(ref);
+ }
+ }
+ }
+
+ return refs;
+}
+
+function extractReferences(content, knownAgents, knownSkills) {
+ const agentPatterns = [
+ /@([a-z][a-z0-9-]*)/gi,
+ /\bagent:\s*['"]?([a-z][a-z0-9-]*)/gi,
+ /\bsubagent(?:_type)?:\s*['"]?([a-z][a-z0-9-]*)/gi,
+ /\bagents\/([a-z][a-z0-9-]*)\.md\b/gi,
+ ];
+
+ const skillPatterns = [
+ /\bskill:\s*['"]?\/?([a-z][a-z0-9-]*)/gi,
+ /\bskills\/([a-z][a-z0-9-]*)\/SKILL\.md\b/gi,
+ /\bskills\/([a-z][a-z0-9-]*)\b/gi,
+ /\/([a-z][a-z0-9-]*)\b/gi,
+ ];
+
+ return {
+ agents: Array.from(collectKnownReferences(content, agentPatterns, knownAgents)).sort(),
+ skills: Array.from(collectKnownReferences(content, skillPatterns, knownSkills)).sort(),
+ };
+}
+
+function inferCommandType(content, commandName) {
+ const lower = `${commandName}\n${content}`.toLowerCase();
+
+ if (commandName.startsWith('multi-') || lower.includes('orchestrat')) {
+ return 'orchestration';
+ }
+ if (lower.includes('test') || lower.includes('tdd') || lower.includes('coverage')) {
+ return 'testing';
+ }
+ if (lower.includes('review') || lower.includes('audit') || lower.includes('security')) {
+ return 'review';
+ }
+ if (lower.includes('plan') || lower.includes('design') || lower.includes('architecture')) {
+ return 'planning';
+ }
+ if (lower.includes('refactor') || lower.includes('clean') || lower.includes('simplify')) {
+ return 'refactoring';
+ }
+ if (lower.includes('build') || lower.includes('compile') || lower.includes('setup')) {
+ return 'build';
+ }
+
+ return 'general';
+}
+
+function processCommandFile(root, filename, knownAgents, knownSkills) {
+ const commandName = filename.replace(/\.md$/, '');
+ const relativePath = normalizePath(path.join('commands', filename));
+ const content = fs.readFileSync(path.join(root, relativePath), 'utf8');
+ const references = extractReferences(content, knownAgents, knownSkills);
+
+ return {
+ command: commandName,
+ description: extractDescription(content),
+ type: inferCommandType(content, commandName),
+ primaryAgents: references.agents.slice(0, 3),
+ allAgents: references.agents,
+ skills: references.skills,
+ path: relativePath,
+ };
+}
+
+function sortCountMap(countMap) {
+ return Object.fromEntries(
+ Object.entries(countMap).sort(([left], [right]) => left.localeCompare(right))
+ );
+}
+
+function topUsage(countMap, keyName) {
+ return Object.entries(countMap)
+ .sort(([leftName, leftCount], [rightName, rightCount]) => (
+ rightCount - leftCount || leftName.localeCompare(rightName)
+ ))
+ .slice(0, 10)
+ .map(([name, count]) => ({ [keyName]: name, count }));
+}
+
+function generateRegistry(options = {}) {
+ const root = options.root || ROOT;
+ const commandFiles = listMarkdownFiles(root, 'commands');
+ const knownAgents = listKnownAgents(root);
+ const knownSkills = listKnownSkills(root);
+
+ const commands = commandFiles.map(filename => (
+ processCommandFile(root, filename, knownAgents, knownSkills)
+ ));
+
+ const byType = {};
+ const agentUsage = {};
+ const skillUsage = {};
+
+ for (const command of commands) {
+ byType[command.type] = (byType[command.type] || 0) + 1;
+ for (const agent of command.allAgents) {
+ agentUsage[agent] = (agentUsage[agent] || 0) + 1;
+ }
+ for (const skill of command.skills) {
+ skillUsage[skill] = (skillUsage[skill] || 0) + 1;
+ }
+ }
+
+ return {
+ schemaVersion: 1,
+ totalCommands: commands.length,
+ commands,
+ statistics: {
+ byType: sortCountMap(byType),
+ topAgents: topUsage(agentUsage, 'agent'),
+ topSkills: topUsage(skillUsage, 'skill'),
+ },
+ };
+}
+
+function formatRegistry(registry) {
+ return `${JSON.stringify(registry, null, 2)}\n`;
+}
+
+function writeRegistry(registry, outputPath = DEFAULT_OUTPUT_PATH) {
+ fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+ fs.writeFileSync(outputPath, formatRegistry(registry), 'utf8');
+}
+
+function checkRegistry(registry, outputPath = DEFAULT_OUTPUT_PATH) {
+ const expected = formatRegistry(registry);
+ let current;
+
+ try {
+ current = fs.readFileSync(outputPath, 'utf8');
+ } catch (error) {
+ throw new Error(`Failed to read ${normalizePath(path.relative(ROOT, outputPath))}: ${error.message}`);
+ }
+
+ if (current !== expected) {
+ throw new Error(`${normalizePath(path.relative(ROOT, outputPath))} is out of date; run npm run command-registry:write`);
+ }
+}
+
+function formatTextSummary(registry) {
+ const lines = [
+ 'Command registry statistics',
+ '',
+ `Total commands: ${registry.totalCommands}`,
+ '',
+ 'By type:',
+ ];
+
+ for (const [type, count] of Object.entries(registry.statistics.byType)) {
+ lines.push(` ${type}: ${count}`);
+ }
+
+ lines.push('', 'Top agents:');
+ for (const { agent, count } of registry.statistics.topAgents) {
+ lines.push(` ${agent}: ${count}`);
+ }
+
+ lines.push('', 'Top skills:');
+ for (const { skill, count } of registry.statistics.topSkills) {
+ lines.push(` ${skill}: ${count}`);
+ }
+
+ return `${lines.join('\n')}\n`;
+}
+
+function parseArgs(argv) {
+ const allowed = new Set(['--json', '--write', '--check']);
+ const flags = new Set();
+
+ for (const arg of argv) {
+ if (!allowed.has(arg)) {
+ throw new Error(`Unknown argument: ${arg}`);
+ }
+ flags.add(arg);
+ }
+
+ return {
+ json: flags.has('--json'),
+ write: flags.has('--write'),
+ check: flags.has('--check'),
+ };
+}
+
+function run(argv = process.argv.slice(2), options = {}) {
+ const stdout = options.stdout || process.stdout;
+ const stderr = options.stderr || process.stderr;
+ const outputPath = options.outputPath || DEFAULT_OUTPUT_PATH;
+
+ try {
+ const args = parseArgs(argv);
+ const registry = generateRegistry({ root: options.root || ROOT });
+
+ if (args.check) {
+ checkRegistry(registry, outputPath);
+ stdout.write('Command registry is up to date.\n');
+ return 0;
+ }
+
+ if (args.write) {
+ writeRegistry(registry, outputPath);
+ stdout.write(`Command registry written to ${normalizePath(path.relative(process.cwd(), outputPath))}\n`);
+ return 0;
+ }
+
+ stdout.write(args.json ? formatRegistry(registry) : formatTextSummary(registry));
+ return 0;
+ } catch (error) {
+ stderr.write(`${error.message}\n`);
+ return 1;
+ }
+}
+
+if (require.main === module) {
+ process.exit(run());
+}
+
+module.exports = {
+ checkRegistry,
+ extractDescription,
+ extractReferences,
+ formatRegistry,
+ generateRegistry,
+ inferCommandType,
+ parseArgs,
+ run,
+ writeRegistry,
+};
diff --git a/tests/ci/catalog.test.js b/tests/ci/catalog.test.js
index ee7a65405..f5b05e1c8 100644
--- a/tests/ci/catalog.test.js
+++ b/tests/ci/catalog.test.js
@@ -44,6 +44,7 @@ function writeEnglishReadme(root, counts, options = {}) {
const unrelatedSkillsCount = options.unrelatedSkillsCount || 16;
fs.writeFileSync(path.join(root, 'README.md'), `Access to ${counts.agents} agents, ${counts.skills} skills, and ${counts.commands} commands.
+- **Public surface synced to the live repo** - metadata, catalog counts, plugin manifests, and install-facing docs now match the actual OSS surface: ${counts.agents} agents, ${counts.skills} skills, and ${counts.commands} legacy command shims.
|-- agents/ # ${counts.agents} specialized subagents for delegation
| Feature | Claude Code | Cursor IDE | Codex CLI | OpenCode |
| --- | --- | --- | --- | --- |
@@ -221,6 +222,7 @@ function runTests() {
.join('\n');
assert.ok(formatted.includes('README.md quick-start summary'));
+ assert.ok(formatted.includes('README.md rc.1 release-note summary'));
assert.ok(formatted.includes('README.md project tree'));
assert.ok(formatted.includes('AGENTS.md summary'));
assert.ok(formatted.includes('.claude-plugin/plugin.json description'));
@@ -255,6 +257,7 @@ function runTests() {
const marketplaceJson = fs.readFileSync(path.join(testDir, '.claude-plugin', 'marketplace.json'), 'utf8');
assert.ok(readme.includes('Access to 1 agents, 1 skills, and 1 legacy command shims'));
+ assert.ok(readme.includes('actual OSS surface: 1 agents, 1 skills, and 1 legacy command shims'));
assert.ok(readme.includes('|-- agents/ # 1 specialized subagents for delegation'));
assert.ok(readme.includes('| Skills | 42 | .agents/skills/ |'));
assert.ok(agentsDoc.includes('providing 1 specialized agents, 1+ skills, 1 commands'));
diff --git a/tests/ci/command-registry.test.js b/tests/ci/command-registry.test.js
new file mode 100644
index 000000000..95e6fb107
--- /dev/null
+++ b/tests/ci/command-registry.test.js
@@ -0,0 +1,176 @@
+/**
+ * Direct coverage for scripts/ci/generate-command-registry.js.
+ */
+
+'use strict';
+
+const assert = require('assert');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+const {
+ checkRegistry,
+ formatRegistry,
+ generateRegistry,
+ parseArgs,
+ run,
+ writeRegistry,
+} = require('../../scripts/ci/generate-command-registry');
+
+function createTestDir() {
+ return fs.mkdtempSync(path.join(os.tmpdir(), 'ecc-command-registry-'));
+}
+
+function cleanupTestDir(testDir) {
+ fs.rmSync(testDir, { recursive: true, force: true });
+}
+
+function writeFixture(root) {
+ fs.mkdirSync(path.join(root, 'commands'), { recursive: true });
+ fs.mkdirSync(path.join(root, 'agents'), { recursive: true });
+ fs.mkdirSync(path.join(root, 'skills', 'tdd-workflow'), { recursive: true });
+ fs.mkdirSync(path.join(root, 'skills', 'security-review'), { recursive: true });
+
+ fs.writeFileSync(path.join(root, 'agents', 'code-reviewer.md'), '---\nmodel: sonnet\ntools: Read\n---\n');
+ fs.writeFileSync(path.join(root, 'agents', 'test-writer.md'), '---\nmodel: sonnet\ntools: Read\n---\n');
+ fs.writeFileSync(path.join(root, 'skills', 'tdd-workflow', 'SKILL.md'), '# TDD workflow\n');
+ fs.writeFileSync(path.join(root, 'skills', 'security-review', 'SKILL.md'), '# Security review\n');
+
+ fs.writeFileSync(path.join(root, 'commands', 'review.md'), `---
+description: Review changes
+---
+# Review
+
+Use @code-reviewer and skill: security-review.
+`);
+
+ fs.writeFileSync(path.join(root, 'commands', 'tdd.md'), `---
+description: "Write tests first"
+---
+# TDD
+
+Call subagent_type: test-writer and skills/tdd-workflow/SKILL.md.
+`);
+}
+
+function test(name, fn) {
+ try {
+ fn();
+ console.log(` PASS ${name}`);
+ return true;
+ } catch (error) {
+ console.log(` FAIL ${name}`);
+ console.log(` Error: ${error.message}`);
+ return false;
+ }
+}
+
+function runTests() {
+ console.log('\n=== Testing command registry generation ===\n');
+
+ let passed = 0;
+ let failed = 0;
+
+ if (test('generates deterministic command metadata and usage statistics', () => {
+ const testDir = createTestDir();
+ try {
+ writeFixture(testDir);
+
+ const registry = generateRegistry({ root: testDir });
+
+ assert.strictEqual(registry.schemaVersion, 1);
+ assert.strictEqual(registry.totalCommands, 2);
+ assert.deepStrictEqual(
+ registry.commands.map(command => command.command),
+ ['review', 'tdd']
+ );
+ assert.deepStrictEqual(registry.commands[0].allAgents, ['code-reviewer']);
+ assert.deepStrictEqual(registry.commands[0].skills, ['security-review']);
+ assert.deepStrictEqual(registry.commands[1].allAgents, ['test-writer']);
+ assert.deepStrictEqual(registry.commands[1].skills, ['tdd-workflow']);
+ assert.deepStrictEqual(registry.statistics.byType, { review: 1, testing: 1 });
+ assert.deepStrictEqual(registry.statistics.topAgents[0], { agent: 'code-reviewer', count: 1 });
+ } finally {
+ cleanupTestDir(testDir);
+ }
+ })) passed++; else failed++;
+
+ if (test('write and check modes use stable JSON without timestamps', () => {
+ const testDir = createTestDir();
+ try {
+ writeFixture(testDir);
+ const outputPath = path.join(testDir, 'docs', 'COMMAND-REGISTRY.json');
+ const registry = generateRegistry({ root: testDir });
+
+ writeRegistry(registry, outputPath);
+ const firstWrite = fs.readFileSync(outputPath, 'utf8');
+ writeRegistry(registry, outputPath);
+ const secondWrite = fs.readFileSync(outputPath, 'utf8');
+
+ assert.strictEqual(firstWrite, secondWrite);
+ assert.ok(!firstWrite.includes('generated'));
+ assert.doesNotThrow(() => checkRegistry(registry, outputPath));
+ } finally {
+ cleanupTestDir(testDir);
+ }
+ })) passed++; else failed++;
+
+ if (test('check mode fails when the registry file is stale', () => {
+ const testDir = createTestDir();
+ try {
+ writeFixture(testDir);
+ const outputPath = path.join(testDir, 'docs', 'COMMAND-REGISTRY.json');
+ const registry = generateRegistry({ root: testDir });
+
+ fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+ fs.writeFileSync(outputPath, `${formatRegistry(registry).trimEnd()}\n \n`);
+
+ assert.throws(
+ () => checkRegistry(registry, outputPath),
+ /out of date/
+ );
+ } finally {
+ cleanupTestDir(testDir);
+ }
+ })) passed++; else failed++;
+
+ if (test('CLI reports unknown arguments and supports check output', () => {
+ const testDir = createTestDir();
+ try {
+ writeFixture(testDir);
+ const outputPath = path.join(testDir, 'docs', 'COMMAND-REGISTRY.json');
+ const registry = generateRegistry({ root: testDir });
+ writeRegistry(registry, outputPath);
+
+ let stdout = '';
+ let stderr = '';
+ const streams = {
+ stdout: { write: chunk => { stdout += chunk; } },
+ stderr: { write: chunk => { stderr += chunk; } },
+ };
+
+ assert.deepStrictEqual(parseArgs(['--json', '--write']), {
+ json: true,
+ write: true,
+ check: false,
+ });
+ assert.strictEqual(run(['--check'], { root: testDir, outputPath, ...streams }), 0);
+ assert.ok(stdout.includes('up to date'));
+ assert.strictEqual(stderr, '');
+
+ stdout = '';
+ stderr = '';
+ assert.strictEqual(run(['--bogus'], { root: testDir, outputPath, ...streams }), 1);
+ assert.strictEqual(stdout, '');
+ assert.ok(stderr.includes('Unknown argument'));
+ } finally {
+ cleanupTestDir(testDir);
+ }
+ })) passed++; else failed++;
+
+ console.log(`\nResults: Passed: ${passed}, Failed: ${failed}`);
+ process.exit(failed > 0 ? 1 : 0);
+}
+
+runTests();
diff --git a/tests/ci/validators.test.js b/tests/ci/validators.test.js
index fe9fee658..0e6810849 100644
--- a/tests/ci/validators.test.js
+++ b/tests/ci/validators.test.js
@@ -270,7 +270,7 @@ function writeCatalogFixture(testDir, options = {}) {
fs.writeFileSync(path.join(testDir, 'commands', 'plan.md'), '---\ndescription: Plan\n---\n# Plan');
fs.writeFileSync(path.join(testDir, 'skills', 'demo-skill', 'SKILL.md'), '---\nname: demo-skill\ndescription: Demo skill\norigin: ECC\n---\n# Demo Skill');
- fs.writeFileSync(readmePath, `Access to ${readmeCounts.agents} agents, ${readmeCounts.skills} skills, and ${readmeCounts.commands} commands.\n|-- agents/ # ${readmeProjectTreeAgents} specialized subagents for delegation\n| Feature | Claude Code | Cursor IDE | Codex CLI | OpenCode |\n|---------|------------|------------|-----------|----------|\n| Agents | PASS: ${readmeTableCounts.agents} agents | Shared | Shared | 1 |\n| Commands | PASS: ${readmeTableCounts.commands} commands | Shared | Shared | 1 |\n| Skills | PASS: ${readmeTableCounts.skills} skills | Shared | Shared | 1 |\n\n| Feature | Count | Format |\n|-----------|-------|---------|\n| Skills | ${readmeUnrelatedSkillsCount} | .agents/skills/ |\n\n## Cross-Tool Feature Parity\n\n| Feature | Claude Code | Cursor IDE | Codex CLI | OpenCode |\n|---------|------------|------------|-----------|----------|\n| **Agents** | ${readmeParityCounts.agents} | Shared (AGENTS.md) | Shared (AGENTS.md) | 12 |\n| **Commands** | ${readmeParityCounts.commands} | Shared | Instruction-based | 31 |\n| **Skills** | ${readmeParityCounts.skills} | Shared | 10 (native format) | 37 |\n`);
+ fs.writeFileSync(readmePath, `Access to ${readmeCounts.agents} agents, ${readmeCounts.skills} skills, and ${readmeCounts.commands} commands.\n- **Public surface synced to the live repo** - metadata, catalog counts, plugin manifests, and install-facing docs now match the actual OSS surface: ${readmeCounts.agents} agents, ${readmeCounts.skills} skills, and ${readmeCounts.commands} legacy command shims.\n|-- agents/ # ${readmeProjectTreeAgents} specialized subagents for delegation\n| Feature | Claude Code | Cursor IDE | Codex CLI | OpenCode |\n|---------|------------|------------|-----------|----------|\n| Agents | PASS: ${readmeTableCounts.agents} agents | Shared | Shared | 1 |\n| Commands | PASS: ${readmeTableCounts.commands} commands | Shared | Shared | 1 |\n| Skills | PASS: ${readmeTableCounts.skills} skills | Shared | Shared | 1 |\n\n| Feature | Count | Format |\n|-----------|-------|---------|\n| Skills | ${readmeUnrelatedSkillsCount} | .agents/skills/ |\n\n## Cross-Tool Feature Parity\n\n| Feature | Claude Code | Cursor IDE | Codex CLI | OpenCode |\n|---------|------------|------------|-----------|----------|\n| **Agents** | ${readmeParityCounts.agents} | Shared (AGENTS.md) | Shared (AGENTS.md) | 12 |\n| **Commands** | ${readmeParityCounts.commands} | Shared | Instruction-based | 31 |\n| **Skills** | ${readmeParityCounts.skills} | Shared | 10 (native format) | 37 |\n`);
fs.writeFileSync(agentsPath, `This is a **production-ready AI coding plugin** providing ${summaryCounts.agents} specialized agents, ${summaryCounts.skills} skills, ${summaryCounts.commands} commands, and automated hook workflows for software development.\n\n\`\`\`\n${structureLines.join('\n')}\n\`\`\`\n`);
fs.writeFileSync(zhRootReadmePath, `**完成!** 你现在可以使用 ${zhRootReadmeCounts.agents} 个代理、${zhRootReadmeCounts.skills} 个技能和 ${zhRootReadmeCounts.commands} 个命令。\n`);
fs.writeFileSync(zhDocsReadmePath, `**搞定!** 你现在可以使用 ${zhDocsReadmeCounts.agents} 个智能体、${zhDocsReadmeCounts.skills} 项技能和 ${zhDocsReadmeCounts.commands} 个命令了。\n| 功能特性 | Claude Code | OpenCode | 状态 |\n|---------|-------------|----------|--------|\n| 智能体 | \u2705 ${zhDocsTableCounts.agents} 个 | \u2705 12 个 | **Claude Code 领先** |\n| 命令 | \u2705 ${zhDocsTableCounts.commands} 个 | \u2705 31 个 | **Claude Code 领先** |\n| 技能 | \u2705 ${zhDocsTableCounts.skills} 项 | \u2705 37 项 | **Claude Code 领先** |\n\n| 功能特性 | 数量 | 格式 |\n|-----------|-------|---------|\n| 技能 | ${zhDocsUnrelatedSkillsCount} | .agents/skills/ |\n\n## 跨工具功能对等\n\n| 功能特性 | Claude Code | Cursor IDE | Codex CLI | OpenCode |\n|---------|------------|------------|-----------|----------|\n| **智能体** | ${zhDocsParityCounts.agents} | 共享 (AGENTS.md) | 共享 (AGENTS.md) | 12 |\n| **命令** | ${zhDocsParityCounts.commands} | 共享 | 基于指令 | 31 |\n| **技能** | ${zhDocsParityCounts.skills} | 共享 | 10 (原生格式) | 37 |\n`);
@@ -595,6 +595,7 @@ function runTests() {
const marketplaceJson = fs.readFileSync(marketplaceJsonPath, 'utf8');
assert.ok(readme.includes('Access to 1 agents, 1 skills, and 1 legacy command shims'), 'Should sync README quick-start summary');
+ assert.ok(readme.includes('actual OSS surface: 1 agents, 1 skills, and 1 legacy command shims'), 'Should sync README release-note summary');
assert.ok(readme.includes('|-- agents/ # 1 specialized subagents for delegation'), 'Should sync README project tree agents count');
assert.ok(readme.includes('| Agents | PASS: 1 agents |'), 'Should sync README comparison table');
assert.ok(readme.includes('| Skills | 16 | .agents/skills/ |'), 'Should not rewrite unrelated README tables');