kodelyth-ecc 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agent/rules/README.md +108 -0
- package/.agent/rules/agents.md +94 -0
- package/.agent/rules/code-review.md +124 -0
- package/.agent/rules/coding-style.md +122 -0
- package/.agent/rules/design-quality.md +63 -0
- package/.agent/rules/development-workflow.md +44 -0
- package/.agent/rules/git-mastery.md +366 -0
- package/.agent/rules/git-workflow.md +24 -0
- package/.agent/rules/hooks.md +25 -0
- package/.agent/rules/kodelyth-always-on.md +63 -0
- package/.agent/rules/kodelyth-quickstart.md +207 -0
- package/.agent/rules/observability.md +390 -0
- package/.agent/rules/patterns.md +50 -0
- package/.agent/rules/performance.md +178 -0
- package/.agent/rules/security.md +58 -0
- package/.agent/rules/smart-debug.md +241 -0
- package/.agent/rules/soul.md +32 -0
- package/.agent/rules/testing.md +46 -0
- package/.agent/skills/api-guardian.md +279 -0
- package/.agent/skills/architect.md +211 -0
- package/.agent/skills/build-error-resolver.md +114 -0
- package/.agent/skills/chief-of-staff.md +151 -0
- package/.agent/skills/code-architect.md +71 -0
- package/.agent/skills/code-explorer.md +69 -0
- package/.agent/skills/code-reviewer.md +237 -0
- package/.agent/skills/code-simplifier.md +47 -0
- package/.agent/skills/comment-analyzer.md +45 -0
- package/.agent/skills/conversation-analyzer.md +52 -0
- package/.agent/skills/cpp-build-resolver.md +90 -0
- package/.agent/skills/cpp-reviewer.md +72 -0
- package/.agent/skills/csharp-reviewer.md +101 -0
- package/.agent/skills/dart-build-resolver.md +201 -0
- package/.agent/skills/database-reviewer.md +91 -0
- package/.agent/skills/debug-detective.md +409 -0
- package/.agent/skills/doc-updater.md +107 -0
- package/.agent/skills/docs-lookup.md +68 -0
- package/.agent/skills/e2e-runner.md +107 -0
- package/.agent/skills/flutter-reviewer.md +243 -0
- package/.agent/skills/gan-evaluator.md +209 -0
- package/.agent/skills/gan-generator.md +131 -0
- package/.agent/skills/gan-planner.md +99 -0
- package/.agent/skills/go-build-resolver.md +94 -0
- package/.agent/skills/go-reviewer.md +76 -0
- package/.agent/skills/harness-optimizer.md +35 -0
- package/.agent/skills/healthcare-reviewer.md +83 -0
- package/.agent/skills/java-build-resolver.md +153 -0
- package/.agent/skills/java-reviewer.md +92 -0
- package/.agent/skills/kodelyth-advisor.md +172 -0
- package/.agent/skills/kotlin-build-resolver.md +118 -0
- package/.agent/skills/kotlin-reviewer.md +159 -0
- package/.agent/skills/loop-operator.md +36 -0
- package/.agent/skills/migration-guide.md +368 -0
- package/.agent/skills/opensource-forker.md +198 -0
- package/.agent/skills/opensource-packager.md +249 -0
- package/.agent/skills/opensource-sanitizer.md +188 -0
- package/.agent/skills/pair-programmer.md +260 -0
- package/.agent/skills/performance-optimizer.md +446 -0
- package/.agent/skills/planner.md +212 -0
- package/.agent/skills/pr-test-analyzer.md +45 -0
- package/.agent/skills/python-reviewer.md +98 -0
- package/.agent/skills/pytorch-build-resolver.md +120 -0
- package/.agent/skills/refactor-cleaner.md +85 -0
- package/.agent/skills/rust-build-resolver.md +148 -0
- package/.agent/skills/rust-reviewer.md +94 -0
- package/.agent/skills/security-reviewer.md +108 -0
- package/.agent/skills/seo-specialist.md +62 -0
- package/.agent/skills/silent-failure-hunter.md +50 -0
- package/.agent/skills/tdd-guide.md +91 -0
- package/.agent/skills/type-design-analyzer.md +41 -0
- package/.agent/skills/typescript-reviewer.md +112 -0
- package/.agent/skills/ux-reviewer.md +483 -0
- package/.agent/workflows/agent-sort.md +23 -0
- package/.agent/workflows/aside.md +164 -0
- package/.agent/workflows/build-fix.md +62 -0
- package/.agent/workflows/checkpoint.md +74 -0
- package/.agent/workflows/claw.md +23 -0
- package/.agent/workflows/code-review.md +289 -0
- package/.agent/workflows/context-budget.md +23 -0
- package/.agent/workflows/cpp-build.md +173 -0
- package/.agent/workflows/cpp-review.md +132 -0
- package/.agent/workflows/cpp-test.md +251 -0
- package/.agent/workflows/devfleet.md +23 -0
- package/.agent/workflows/docs.md +23 -0
- package/.agent/workflows/e2e.md +268 -0
- package/.agent/workflows/eval.md +23 -0
- package/.agent/workflows/evolve.md +178 -0
- package/.agent/workflows/feature-dev.md +49 -0
- package/.agent/workflows/flutter-build.md +164 -0
- package/.agent/workflows/flutter-review.md +116 -0
- package/.agent/workflows/flutter-test.md +144 -0
- package/.agent/workflows/gan-build.md +99 -0
- package/.agent/workflows/gan-design.md +35 -0
- package/.agent/workflows/go-build.md +183 -0
- package/.agent/workflows/go-review.md +148 -0
- package/.agent/workflows/go-test.md +268 -0
- package/.agent/workflows/gradle-build.md +70 -0
- package/.agent/workflows/harness-audit.md +73 -0
- package/.agent/workflows/hookify-configure.md +14 -0
- package/.agent/workflows/hookify-help.md +46 -0
- package/.agent/workflows/hookify-list.md +21 -0
- package/.agent/workflows/hookify.md +50 -0
- package/.agent/workflows/instinct-export.md +66 -0
- package/.agent/workflows/instinct-import.md +114 -0
- package/.agent/workflows/instinct-status.md +59 -0
- package/.agent/workflows/jira.md +106 -0
- package/.agent/workflows/kotlin-build.md +174 -0
- package/.agent/workflows/kotlin-review.md +140 -0
- package/.agent/workflows/kotlin-test.md +312 -0
- package/.agent/workflows/learn-eval.md +116 -0
- package/.agent/workflows/learn.md +70 -0
- package/.agent/workflows/loop-start.md +32 -0
- package/.agent/workflows/loop-status.md +24 -0
- package/.agent/workflows/model-route.md +26 -0
- package/.agent/workflows/multi-backend.md +158 -0
- package/.agent/workflows/multi-execute.md +315 -0
- package/.agent/workflows/multi-frontend.md +158 -0
- package/.agent/workflows/multi-plan.md +268 -0
- package/.agent/workflows/multi-workflow.md +191 -0
- package/.agent/workflows/orchestrate.md +135 -0
- package/.agent/workflows/plan.md +117 -0
- package/.agent/workflows/pm2.md +272 -0
- package/.agent/workflows/projects.md +39 -0
- package/.agent/workflows/promote.md +41 -0
- package/.agent/workflows/prompt-optimize.md +23 -0
- package/.agent/workflows/prp-commit.md +112 -0
- package/.agent/workflows/prp-implement.md +385 -0
- package/.agent/workflows/prp-plan.md +502 -0
- package/.agent/workflows/prp-pr.md +184 -0
- package/.agent/workflows/prp-prd.md +447 -0
- package/.agent/workflows/prune.md +31 -0
- package/.agent/workflows/python-review.md +297 -0
- package/.agent/workflows/quality-gate.md +29 -0
- package/.agent/workflows/refactor-clean.md +80 -0
- package/.agent/workflows/resume-session.md +156 -0
- package/.agent/workflows/review-pr.md +37 -0
- package/.agent/workflows/rules-distill.md +20 -0
- package/.agent/workflows/rust-build.md +187 -0
- package/.agent/workflows/rust-review.md +142 -0
- package/.agent/workflows/rust-test.md +308 -0
- package/.agent/workflows/santa-loop.md +175 -0
- package/.agent/workflows/save-session.md +275 -0
- package/.agent/workflows/sessions.md +333 -0
- package/.agent/workflows/setup-pm.md +80 -0
- package/.agent/workflows/skill-create.md +174 -0
- package/.agent/workflows/skill-health.md +54 -0
- package/.agent/workflows/tdd.md +231 -0
- package/.agent/workflows/test-coverage.md +69 -0
- package/.agent/workflows/update-codemaps.md +72 -0
- package/.agent/workflows/update-docs.md +84 -0
- package/.agent/workflows/verify.md +23 -0
- package/.github/workflows/ci.yml +46 -0
- package/.github/workflows/publish.yml +41 -0
- package/AGENTS.md +209 -0
- package/CHANGELOG.md +236 -0
- package/CLAUDE.md +90 -0
- package/CONTRIBUTING.md +255 -0
- package/KODELYTH.md +74 -0
- package/LICENSE +21 -0
- package/README.md +414 -0
- package/SECURITY.md +77 -0
- package/SOUL.md +32 -0
- package/VERSION +1 -0
- package/agents/api-guardian.md +279 -0
- package/agents/architect.md +211 -0
- package/agents/build-error-resolver.md +114 -0
- package/agents/chief-of-staff.md +151 -0
- package/agents/code-architect.md +71 -0
- package/agents/code-explorer.md +69 -0
- package/agents/code-reviewer.md +237 -0
- package/agents/code-simplifier.md +47 -0
- package/agents/comment-analyzer.md +45 -0
- package/agents/conversation-analyzer.md +52 -0
- package/agents/cpp-build-resolver.md +90 -0
- package/agents/cpp-reviewer.md +72 -0
- package/agents/csharp-reviewer.md +101 -0
- package/agents/dart-build-resolver.md +201 -0
- package/agents/database-reviewer.md +91 -0
- package/agents/debug-detective.md +409 -0
- package/agents/doc-updater.md +107 -0
- package/agents/docs-lookup.md +68 -0
- package/agents/e2e-runner.md +107 -0
- package/agents/flutter-reviewer.md +243 -0
- package/agents/gan-evaluator.md +209 -0
- package/agents/gan-generator.md +131 -0
- package/agents/gan-planner.md +99 -0
- package/agents/go-build-resolver.md +94 -0
- package/agents/go-reviewer.md +76 -0
- package/agents/harness-optimizer.md +35 -0
- package/agents/healthcare-reviewer.md +83 -0
- package/agents/java-build-resolver.md +153 -0
- package/agents/java-reviewer.md +92 -0
- package/agents/kodelyth-advisor.md +172 -0
- package/agents/kotlin-build-resolver.md +118 -0
- package/agents/kotlin-reviewer.md +159 -0
- package/agents/loop-operator.md +36 -0
- package/agents/migration-guide.md +368 -0
- package/agents/opensource-forker.md +198 -0
- package/agents/opensource-packager.md +249 -0
- package/agents/opensource-sanitizer.md +188 -0
- package/agents/pair-programmer.md +260 -0
- package/agents/performance-optimizer.md +446 -0
- package/agents/planner.md +212 -0
- package/agents/pr-test-analyzer.md +45 -0
- package/agents/python-reviewer.md +98 -0
- package/agents/pytorch-build-resolver.md +120 -0
- package/agents/refactor-cleaner.md +85 -0
- package/agents/rust-build-resolver.md +148 -0
- package/agents/rust-reviewer.md +94 -0
- package/agents/security-reviewer.md +108 -0
- package/agents/seo-specialist.md +62 -0
- package/agents/silent-failure-hunter.md +50 -0
- package/agents/tdd-guide.md +91 -0
- package/agents/type-design-analyzer.md +41 -0
- package/agents/typescript-reviewer.md +112 -0
- package/agents/ux-reviewer.md +483 -0
- package/bin/kodelyth-ecc.js +87 -0
- package/commands/agent-sort.md +23 -0
- package/commands/aside.md +164 -0
- package/commands/build-fix.md +62 -0
- package/commands/checkpoint.md +74 -0
- package/commands/claw.md +23 -0
- package/commands/code-review.md +289 -0
- package/commands/context-budget.md +23 -0
- package/commands/cpp-build.md +173 -0
- package/commands/cpp-review.md +132 -0
- package/commands/cpp-test.md +251 -0
- package/commands/devfleet.md +23 -0
- package/commands/docs.md +23 -0
- package/commands/e2e.md +268 -0
- package/commands/eval.md +23 -0
- package/commands/evolve.md +178 -0
- package/commands/feature-dev.md +49 -0
- package/commands/flutter-build.md +164 -0
- package/commands/flutter-review.md +116 -0
- package/commands/flutter-test.md +144 -0
- package/commands/gan-build.md +99 -0
- package/commands/gan-design.md +35 -0
- package/commands/go-build.md +183 -0
- package/commands/go-review.md +148 -0
- package/commands/go-test.md +268 -0
- package/commands/gradle-build.md +70 -0
- package/commands/harness-audit.md +73 -0
- package/commands/hookify-configure.md +14 -0
- package/commands/hookify-help.md +46 -0
- package/commands/hookify-list.md +21 -0
- package/commands/hookify.md +50 -0
- package/commands/instinct-export.md +66 -0
- package/commands/instinct-import.md +114 -0
- package/commands/instinct-status.md +59 -0
- package/commands/jira.md +106 -0
- package/commands/kotlin-build.md +174 -0
- package/commands/kotlin-review.md +140 -0
- package/commands/kotlin-test.md +312 -0
- package/commands/learn-eval.md +116 -0
- package/commands/learn.md +70 -0
- package/commands/loop-start.md +32 -0
- package/commands/loop-status.md +24 -0
- package/commands/model-route.md +26 -0
- package/commands/multi-backend.md +158 -0
- package/commands/multi-execute.md +315 -0
- package/commands/multi-frontend.md +158 -0
- package/commands/multi-plan.md +268 -0
- package/commands/multi-workflow.md +191 -0
- package/commands/orchestrate.md +135 -0
- package/commands/plan.md +117 -0
- package/commands/pm2.md +272 -0
- package/commands/projects.md +39 -0
- package/commands/promote.md +41 -0
- package/commands/prompt-optimize.md +23 -0
- package/commands/prp-commit.md +112 -0
- package/commands/prp-implement.md +385 -0
- package/commands/prp-plan.md +502 -0
- package/commands/prp-pr.md +184 -0
- package/commands/prp-prd.md +447 -0
- package/commands/prune.md +31 -0
- package/commands/python-review.md +297 -0
- package/commands/quality-gate.md +29 -0
- package/commands/refactor-clean.md +80 -0
- package/commands/resume-session.md +156 -0
- package/commands/review-pr.md +37 -0
- package/commands/rules-distill.md +20 -0
- package/commands/rust-build.md +187 -0
- package/commands/rust-review.md +142 -0
- package/commands/rust-test.md +308 -0
- package/commands/santa-loop.md +175 -0
- package/commands/save-session.md +275 -0
- package/commands/sessions.md +333 -0
- package/commands/setup-pm.md +80 -0
- package/commands/skill-create.md +174 -0
- package/commands/skill-health.md +54 -0
- package/commands/tdd.md +231 -0
- package/commands/test-coverage.md +69 -0
- package/commands/update-codemaps.md +72 -0
- package/commands/update-docs.md +84 -0
- package/commands/verify.md +23 -0
- package/contexts/dev.md +20 -0
- package/contexts/research.md +26 -0
- package/contexts/review.md +22 -0
- package/dashboard/lib/agent-tracker.js +366 -0
- package/dashboard/lib/aggregator.js +118 -0
- package/dashboard/lib/cost-calculator.js +50 -0
- package/dashboard/lib/platform-detector.js +89 -0
- package/dashboard/lib/readers/antigravity-reader.js +113 -0
- package/dashboard/lib/readers/claude-reader.js +135 -0
- package/dashboard/lib/readers/codex-reader.js +192 -0
- package/dashboard/lib/readers/cursor-reader.js +135 -0
- package/dashboard/lib/readers/opencode-reader.js +201 -0
- package/dashboard/lib/readers/windsurf-reader.js +126 -0
- package/dashboard/package.json +24 -0
- package/dashboard/public/index.html +1147 -0
- package/dashboard/server.js +119 -0
- package/hooks/README.md +220 -0
- package/hooks/hooks.json +420 -0
- package/install.ps1 +190 -0
- package/install.sh +583 -0
- package/package.json +33 -0
- package/rules/README.md +111 -0
- package/rules/common/agents.md +50 -0
- package/rules/common/code-review.md +124 -0
- package/rules/common/coding-style.md +122 -0
- package/rules/common/development-workflow.md +44 -0
- package/rules/common/git-workflow.md +24 -0
- package/rules/common/hooks.md +30 -0
- package/rules/common/patterns.md +31 -0
- package/rules/common/performance.md +178 -0
- package/rules/common/security.md +29 -0
- package/rules/common/testing.md +57 -0
- package/rules/cpp/coding-style.md +44 -0
- package/rules/cpp/hooks.md +39 -0
- package/rules/cpp/patterns.md +51 -0
- package/rules/cpp/security.md +51 -0
- package/rules/cpp/testing.md +44 -0
- package/rules/csharp/coding-style.md +72 -0
- package/rules/csharp/hooks.md +25 -0
- package/rules/csharp/patterns.md +50 -0
- package/rules/csharp/security.md +58 -0
- package/rules/csharp/testing.md +46 -0
- package/rules/dart/coding-style.md +159 -0
- package/rules/dart/hooks.md +66 -0
- package/rules/dart/patterns.md +261 -0
- package/rules/dart/security.md +135 -0
- package/rules/dart/testing.md +215 -0
- package/rules/golang/coding-style.md +32 -0
- package/rules/golang/hooks.md +17 -0
- package/rules/golang/patterns.md +45 -0
- package/rules/golang/security.md +34 -0
- package/rules/golang/testing.md +31 -0
- package/rules/java/coding-style.md +114 -0
- package/rules/java/hooks.md +18 -0
- package/rules/java/patterns.md +146 -0
- package/rules/java/security.md +100 -0
- package/rules/java/testing.md +131 -0
- package/rules/kotlin/coding-style.md +86 -0
- package/rules/kotlin/hooks.md +17 -0
- package/rules/kotlin/patterns.md +146 -0
- package/rules/kotlin/security.md +82 -0
- package/rules/kotlin/testing.md +128 -0
- package/rules/perl/coding-style.md +46 -0
- package/rules/perl/hooks.md +22 -0
- package/rules/perl/patterns.md +76 -0
- package/rules/perl/security.md +69 -0
- package/rules/perl/testing.md +54 -0
- package/rules/php/coding-style.md +40 -0
- package/rules/php/hooks.md +24 -0
- package/rules/php/patterns.md +33 -0
- package/rules/php/security.md +37 -0
- package/rules/php/testing.md +39 -0
- package/rules/python/coding-style.md +42 -0
- package/rules/python/hooks.md +19 -0
- package/rules/python/patterns.md +39 -0
- package/rules/python/security.md +30 -0
- package/rules/python/testing.md +38 -0
- package/rules/rust/coding-style.md +151 -0
- package/rules/rust/hooks.md +16 -0
- package/rules/rust/patterns.md +168 -0
- package/rules/rust/security.md +141 -0
- package/rules/rust/testing.md +154 -0
- package/rules/swift/coding-style.md +47 -0
- package/rules/swift/hooks.md +20 -0
- package/rules/swift/patterns.md +66 -0
- package/rules/swift/security.md +33 -0
- package/rules/swift/testing.md +45 -0
- package/rules/typescript/coding-style.md +199 -0
- package/rules/typescript/hooks.md +22 -0
- package/rules/typescript/patterns.md +52 -0
- package/rules/typescript/security.md +28 -0
- package/rules/typescript/testing.md +18 -0
- package/rules/web/coding-style.md +96 -0
- package/rules/web/design-quality.md +63 -0
- package/rules/web/hooks.md +120 -0
- package/rules/web/patterns.md +79 -0
- package/rules/web/performance.md +64 -0
- package/rules/web/security.md +57 -0
- package/rules/web/testing.md +55 -0
- package/rules/zh/README.md +108 -0
- package/rules/zh/agents.md +50 -0
- package/rules/zh/code-review.md +124 -0
- package/rules/zh/coding-style.md +48 -0
- package/rules/zh/development-workflow.md +44 -0
- package/rules/zh/git-workflow.md +24 -0
- package/rules/zh/hooks.md +30 -0
- package/rules/zh/patterns.md +31 -0
- package/rules/zh/performance.md +55 -0
- package/rules/zh/security.md +29 -0
- package/rules/zh/testing.md +29 -0
- package/scripts/agent-tracker-hook.js +81 -0
- package/scripts/build-opencode.js +26 -0
- package/scripts/catalog.js +186 -0
- package/scripts/ci/catalog.js +648 -0
- package/scripts/ci/check-unicode-safety.js +246 -0
- package/scripts/ci/validate-agents.js +81 -0
- package/scripts/ci/validate-commands.js +136 -0
- package/scripts/ci/validate-hooks.js +239 -0
- package/scripts/ci/validate-install-manifests.js +214 -0
- package/scripts/ci/validate-no-personal-paths.js +63 -0
- package/scripts/ci/validate-rules.js +81 -0
- package/scripts/ci/validate-skills.js +56 -0
- package/scripts/claw.js +468 -0
- package/scripts/codemaps/generate.ts +330 -0
- package/scripts/codex/check-codex-global-state.sh +250 -0
- package/scripts/codex/install-global-git-hooks.sh +65 -0
- package/scripts/codex/merge-codex-config.js +317 -0
- package/scripts/codex/merge-mcp-config.js +335 -0
- package/scripts/codex-git-hooks/pre-commit +77 -0
- package/scripts/codex-git-hooks/pre-push +124 -0
- package/scripts/doctor.js +111 -0
- package/scripts/ecc.js +216 -0
- package/scripts/gan-harness.sh +299 -0
- package/scripts/harness-audit.js +735 -0
- package/scripts/hooks/auto-tmux-dev.js +88 -0
- package/scripts/hooks/branch-name-check.js +163 -0
- package/scripts/hooks/check-console-log.js +71 -0
- package/scripts/hooks/check-hook-enabled.js +12 -0
- package/scripts/hooks/config-protection.js +140 -0
- package/scripts/hooks/cost-tracker.js +78 -0
- package/scripts/hooks/design-quality-check.js +131 -0
- package/scripts/hooks/desktop-notify.js +168 -0
- package/scripts/hooks/doc-file-warning.js +90 -0
- package/scripts/hooks/evaluate-session.js +100 -0
- package/scripts/hooks/governance-capture.js +334 -0
- package/scripts/hooks/mcp-health-check.js +619 -0
- package/scripts/hooks/post-bash-build-complete.js +27 -0
- package/scripts/hooks/post-bash-command-log.js +73 -0
- package/scripts/hooks/post-bash-pr-created.js +36 -0
- package/scripts/hooks/post-edit-accumulator.js +78 -0
- package/scripts/hooks/post-edit-console-warn.js +54 -0
- package/scripts/hooks/post-edit-format.js +109 -0
- package/scripts/hooks/post-edit-typecheck.js +96 -0
- package/scripts/hooks/pre-bash-commit-quality.js +405 -0
- package/scripts/hooks/pre-bash-dev-server-block.js +187 -0
- package/scripts/hooks/pre-bash-git-push-reminder.js +28 -0
- package/scripts/hooks/pre-bash-tmux-reminder.js +33 -0
- package/scripts/hooks/pre-compact.js +48 -0
- package/scripts/hooks/pre-write-doc-warn.js +9 -0
- package/scripts/hooks/quality-gate.js +168 -0
- package/scripts/hooks/run-with-flags-shell.sh +36 -0
- package/scripts/hooks/run-with-flags.js +181 -0
- package/scripts/hooks/session-end-marker.js +67 -0
- package/scripts/hooks/session-end.js +301 -0
- package/scripts/hooks/session-start-bootstrap.js +161 -0
- package/scripts/hooks/session-start.js +492 -0
- package/scripts/hooks/smart-suggest.js +138 -0
- package/scripts/hooks/stop-format-typecheck.js +209 -0
- package/scripts/hooks/suggest-compact.js +80 -0
- package/scripts/hooks/test-reminder.js +128 -0
- package/scripts/install-apply.js +150 -0
- package/scripts/install-plan.js +266 -0
- package/scripts/lib/agent-compress.js +244 -0
- package/scripts/lib/hook-flags.js +74 -0
- package/scripts/lib/inspection.js +212 -0
- package/scripts/lib/install/apply.js +265 -0
- package/scripts/lib/install/config.js +89 -0
- package/scripts/lib/install/request.js +120 -0
- package/scripts/lib/install/runtime.js +54 -0
- package/scripts/lib/install-executor.js +672 -0
- package/scripts/lib/install-lifecycle.js +1226 -0
- package/scripts/lib/install-manifests.js +551 -0
- package/scripts/lib/install-state.js +313 -0
- package/scripts/lib/install-targets/antigravity-project.js +85 -0
- package/scripts/lib/install-targets/claude-home.js +10 -0
- package/scripts/lib/install-targets/codebuddy-project.js +50 -0
- package/scripts/lib/install-targets/codex-home.js +10 -0
- package/scripts/lib/install-targets/cursor-project.js +50 -0
- package/scripts/lib/install-targets/gemini-project.js +10 -0
- package/scripts/lib/install-targets/helpers.js +340 -0
- package/scripts/lib/install-targets/opencode-home.js +10 -0
- package/scripts/lib/install-targets/registry.js +70 -0
- package/scripts/lib/mcp-config.js +56 -0
- package/scripts/lib/observer-sessions.js +175 -0
- package/scripts/lib/orchestration-session.js +299 -0
- package/scripts/lib/package-manager.d.ts +119 -0
- package/scripts/lib/package-manager.js +431 -0
- package/scripts/lib/project-detect.js +428 -0
- package/scripts/lib/resolve-ecc-root.js +118 -0
- package/scripts/lib/resolve-formatter.js +185 -0
- package/scripts/lib/session-adapters/canonical-session.js +531 -0
- package/scripts/lib/session-adapters/claude-history.js +160 -0
- package/scripts/lib/session-adapters/dmux-tmux.js +90 -0
- package/scripts/lib/session-adapters/registry.js +127 -0
- package/scripts/lib/session-aliases.d.ts +136 -0
- package/scripts/lib/session-aliases.js +481 -0
- package/scripts/lib/session-manager.d.ts +132 -0
- package/scripts/lib/session-manager.js +533 -0
- package/scripts/lib/shell-split.js +86 -0
- package/scripts/lib/skill-evolution/dashboard.js +401 -0
- package/scripts/lib/skill-evolution/health.js +263 -0
- package/scripts/lib/skill-evolution/index.js +20 -0
- package/scripts/lib/skill-evolution/provenance.js +187 -0
- package/scripts/lib/skill-evolution/tracker.js +146 -0
- package/scripts/lib/skill-evolution/versioning.js +237 -0
- package/scripts/lib/skill-improvement/amendify.js +89 -0
- package/scripts/lib/skill-improvement/evaluate.js +59 -0
- package/scripts/lib/skill-improvement/health.js +118 -0
- package/scripts/lib/skill-improvement/observations.js +108 -0
- package/scripts/lib/state-store/index.js +191 -0
- package/scripts/lib/state-store/migrations.js +178 -0
- package/scripts/lib/state-store/queries.js +697 -0
- package/scripts/lib/state-store/schema.js +92 -0
- package/scripts/lib/tmux-worktree-orchestrator.js +598 -0
- package/scripts/lib/utils.d.ts +196 -0
- package/scripts/lib/utils.js +629 -0
- package/scripts/list-installed.js +91 -0
- package/scripts/orchestrate-codex-worker.sh +107 -0
- package/scripts/orchestrate-worktrees.js +108 -0
- package/scripts/orchestration-status.js +62 -0
- package/scripts/release.sh +83 -0
- package/scripts/repair.js +98 -0
- package/scripts/session-inspect.js +150 -0
- package/scripts/sessions-cli.js +178 -0
- package/scripts/setup-package-manager.js +204 -0
- package/scripts/skill-create-output.js +244 -0
- package/scripts/skills-health.js +132 -0
- package/scripts/status.js +177 -0
- package/scripts/sync-ecc-to-codex.sh +534 -0
- package/scripts/uninstall.js +97 -0
- package/skills/agent-eval/SKILL.md +145 -0
- package/skills/agent-harness-construction/SKILL.md +73 -0
- package/skills/agent-introspection-debugging/SKILL.md +153 -0
- package/skills/agent-payment-x402/SKILL.md +178 -0
- package/skills/agent-sort/SKILL.md +215 -0
- package/skills/agentic-engineering/SKILL.md +63 -0
- package/skills/ai-first-engineering/SKILL.md +51 -0
- package/skills/ai-regression-testing/SKILL.md +385 -0
- package/skills/android-clean-architecture/SKILL.md +339 -0
- package/skills/api-connector-builder/SKILL.md +121 -0
- package/skills/api-design/SKILL.md +523 -0
- package/skills/architecture-decision-records/SKILL.md +179 -0
- package/skills/article-writing/SKILL.md +79 -0
- package/skills/automation-audit-ops/SKILL.md +142 -0
- package/skills/autonomous-agent-harness/SKILL.md +267 -0
- package/skills/autonomous-loops/SKILL.md +610 -0
- package/skills/backend-patterns/SKILL.md +598 -0
- package/skills/benchmark/SKILL.md +93 -0
- package/skills/blueprint/SKILL.md +105 -0
- package/skills/brand-voice/SKILL.md +97 -0
- package/skills/brand-voice/references/voice-profile-schema.md +55 -0
- package/skills/browser-qa/SKILL.md +87 -0
- package/skills/bun-runtime/SKILL.md +84 -0
- package/skills/canary-watch/SKILL.md +99 -0
- package/skills/carrier-relationship-management/SKILL.md +212 -0
- package/skills/ck/SKILL.md +147 -0
- package/skills/ck/commands/forget.mjs +44 -0
- package/skills/ck/commands/info.mjs +24 -0
- package/skills/ck/commands/init.mjs +143 -0
- package/skills/ck/commands/list.mjs +40 -0
- package/skills/ck/commands/migrate.mjs +202 -0
- package/skills/ck/commands/resume.mjs +36 -0
- package/skills/ck/commands/save.mjs +210 -0
- package/skills/ck/commands/shared.mjs +387 -0
- package/skills/ck/hooks/session-start.mjs +224 -0
- package/skills/claude-api/SKILL.md +337 -0
- package/skills/claude-devfleet/SKILL.md +103 -0
- package/skills/click-path-audit/SKILL.md +244 -0
- package/skills/clickhouse-io/SKILL.md +439 -0
- package/skills/code-tour/SKILL.md +236 -0
- package/skills/codebase-onboarding/SKILL.md +233 -0
- package/skills/coding-standards/SKILL.md +549 -0
- package/skills/compose-multiplatform-patterns/SKILL.md +299 -0
- package/skills/configure-ecc/SKILL.md +367 -0
- package/skills/connections-optimizer/SKILL.md +189 -0
- package/skills/content-engine/SKILL.md +131 -0
- package/skills/content-hash-cache-pattern/SKILL.md +161 -0
- package/skills/context-budget/SKILL.md +135 -0
- package/skills/continuous-agent-loop/SKILL.md +45 -0
- package/skills/continuous-learning/SKILL.md +123 -0
- package/skills/continuous-learning/config.json +18 -0
- package/skills/continuous-learning/evaluate-session.sh +69 -0
- package/skills/continuous-learning-v2/SKILL.md +365 -0
- package/skills/continuous-learning-v2/agents/observer-loop.sh +271 -0
- package/skills/continuous-learning-v2/agents/observer.md +198 -0
- package/skills/continuous-learning-v2/agents/session-guardian.sh +150 -0
- package/skills/continuous-learning-v2/agents/start-observer.sh +244 -0
- package/skills/continuous-learning-v2/config.json +8 -0
- package/skills/continuous-learning-v2/hooks/observe.sh +428 -0
- package/skills/continuous-learning-v2/scripts/detect-project.sh +228 -0
- package/skills/continuous-learning-v2/scripts/instinct-cli.py +1426 -0
- package/skills/continuous-learning-v2/scripts/test_parse_instinct.py +984 -0
- package/skills/cost-aware-llm-pipeline/SKILL.md +183 -0
- package/skills/council/SKILL.md +203 -0
- package/skills/cpp-coding-standards/SKILL.md +723 -0
- package/skills/cpp-testing/SKILL.md +324 -0
- package/skills/crosspost/SKILL.md +111 -0
- package/skills/csharp-testing/SKILL.md +321 -0
- package/skills/customer-billing-ops/SKILL.md +140 -0
- package/skills/customs-trade-compliance/SKILL.md +263 -0
- package/skills/dart-flutter-patterns/SKILL.md +563 -0
- package/skills/dashboard-builder/SKILL.md +109 -0
- package/skills/data-scraper-agent/SKILL.md +764 -0
- package/skills/database-migrations/SKILL.md +429 -0
- package/skills/deep-research/SKILL.md +155 -0
- package/skills/defi-amm-security/SKILL.md +160 -0
- package/skills/deployment-patterns/SKILL.md +427 -0
- package/skills/design-system/SKILL.md +82 -0
- package/skills/django-patterns/SKILL.md +734 -0
- package/skills/django-security/SKILL.md +593 -0
- package/skills/django-tdd/SKILL.md +729 -0
- package/skills/django-verification/SKILL.md +469 -0
- package/skills/dmux-workflows/SKILL.md +191 -0
- package/skills/docker-patterns/SKILL.md +364 -0
- package/skills/documentation-lookup/SKILL.md +90 -0
- package/skills/dotnet-patterns/SKILL.md +321 -0
- package/skills/e2e-testing/SKILL.md +326 -0
- package/skills/ecc-tools-cost-audit/SKILL.md +160 -0
- package/skills/email-ops/SKILL.md +121 -0
- package/skills/energy-procurement/SKILL.md +228 -0
- package/skills/enterprise-agent-ops/SKILL.md +50 -0
- package/skills/eval-harness/SKILL.md +270 -0
- package/skills/evm-token-decimals/SKILL.md +130 -0
- package/skills/exa-search/SKILL.md +103 -0
- package/skills/fal-ai-media/SKILL.md +284 -0
- package/skills/finance-billing-ops/SKILL.md +127 -0
- package/skills/flutter-dart-code-review/SKILL.md +435 -0
- package/skills/foundation-models-on-device/SKILL.md +243 -0
- package/skills/frontend-design/SKILL.md +145 -0
- package/skills/frontend-patterns/SKILL.md +642 -0
- package/skills/frontend-slides/SKILL.md +184 -0
- package/skills/frontend-slides/STYLE_PRESETS.md +330 -0
- package/skills/gan-style-harness/SKILL.md +278 -0
- package/skills/git-mastery/SKILL.md +366 -0
- package/skills/git-workflow/SKILL.md +715 -0
- package/skills/github-ops/SKILL.md +144 -0
- package/skills/golang-patterns/SKILL.md +674 -0
- package/skills/golang-testing/SKILL.md +720 -0
- package/skills/google-workspace-ops/SKILL.md +95 -0
- package/skills/healthcare-cdss-patterns/SKILL.md +245 -0
- package/skills/healthcare-emr-patterns/SKILL.md +159 -0
- package/skills/healthcare-eval-harness/SKILL.md +207 -0
- package/skills/healthcare-phi-compliance/SKILL.md +145 -0
- package/skills/hexagonal-architecture/SKILL.md +276 -0
- package/skills/hipaa-compliance/SKILL.md +78 -0
- package/skills/hookify-rules/SKILL.md +128 -0
- package/skills/inventory-demand-planning/SKILL.md +247 -0
- package/skills/investor-materials/SKILL.md +96 -0
- package/skills/investor-outreach/SKILL.md +91 -0
- package/skills/iterative-retrieval/SKILL.md +211 -0
- package/skills/java-coding-standards/SKILL.md +147 -0
- package/skills/jira-integration/SKILL.md +293 -0
- package/skills/jpa-patterns/SKILL.md +151 -0
- package/skills/knowledge-ops/SKILL.md +154 -0
- package/skills/kodelyth-quickstart/SKILL.md +207 -0
- package/skills/kotlin-coroutines-flows/SKILL.md +284 -0
- package/skills/kotlin-exposed-patterns/SKILL.md +719 -0
- package/skills/kotlin-ktor-patterns/SKILL.md +689 -0
- package/skills/kotlin-patterns/SKILL.md +711 -0
- package/skills/kotlin-testing/SKILL.md +824 -0
- package/skills/laravel-patterns/SKILL.md +415 -0
- package/skills/laravel-plugin-discovery/SKILL.md +229 -0
- package/skills/laravel-security/SKILL.md +285 -0
- package/skills/laravel-tdd/SKILL.md +283 -0
- package/skills/laravel-verification/SKILL.md +179 -0
- package/skills/lead-intelligence/SKILL.md +321 -0
- package/skills/lead-intelligence/agents/enrichment-agent.md +85 -0
- package/skills/lead-intelligence/agents/mutual-mapper.md +75 -0
- package/skills/lead-intelligence/agents/outreach-drafter.md +98 -0
- package/skills/lead-intelligence/agents/signal-scorer.md +60 -0
- package/skills/liquid-glass-design/SKILL.md +279 -0
- package/skills/llm-trading-agent-security/SKILL.md +146 -0
- package/skills/logistics-exception-management/SKILL.md +222 -0
- package/skills/manim-video/SKILL.md +89 -0
- package/skills/manim-video/assets/network_graph_scene.py +52 -0
- package/skills/market-research/SKILL.md +75 -0
- package/skills/mcp-server-patterns/SKILL.md +67 -0
- package/skills/messages-ops/SKILL.md +104 -0
- package/skills/nanoclaw-repl/SKILL.md +33 -0
- package/skills/nestjs-patterns/SKILL.md +230 -0
- package/skills/nextjs-turbopack/SKILL.md +44 -0
- package/skills/nodejs-keccak256/SKILL.md +102 -0
- package/skills/nutrient-document-processing/SKILL.md +167 -0
- package/skills/nuxt4-patterns/SKILL.md +100 -0
- package/skills/observability/SKILL.md +390 -0
- package/skills/openclaw-persona-forge/SKILL.md +296 -0
- package/skills/openclaw-persona-forge/gacha.py +224 -0
- package/skills/openclaw-persona-forge/gacha.sh +5 -0
- package/skills/openclaw-persona-forge/references/avatar-style.md +124 -0
- package/skills/openclaw-persona-forge/references/boundary-rules.md +53 -0
- package/skills/openclaw-persona-forge/references/error-handling.md +53 -0
- package/skills/openclaw-persona-forge/references/identity-tension.md +48 -0
- package/skills/openclaw-persona-forge/references/naming-system.md +39 -0
- package/skills/openclaw-persona-forge/references/output-template.md +166 -0
- package/skills/opensource-pipeline/SKILL.md +255 -0
- package/skills/perl-patterns/SKILL.md +504 -0
- package/skills/perl-security/SKILL.md +503 -0
- package/skills/perl-testing/SKILL.md +475 -0
- package/skills/plankton-code-quality/SKILL.md +236 -0
- package/skills/postgres-patterns/SKILL.md +147 -0
- package/skills/product-capability/SKILL.md +141 -0
- package/skills/product-lens/SKILL.md +92 -0
- package/skills/production-scheduling/SKILL.md +238 -0
- package/skills/project-flow-ops/SKILL.md +111 -0
- package/skills/prompt-optimizer/SKILL.md +397 -0
- package/skills/python-patterns/SKILL.md +750 -0
- package/skills/python-testing/SKILL.md +816 -0
- package/skills/pytorch-patterns/SKILL.md +396 -0
- package/skills/quality-nonconformance/SKILL.md +260 -0
- package/skills/ralphinho-rfc-pipeline/SKILL.md +67 -0
- package/skills/regex-vs-llm-structured-text/SKILL.md +220 -0
- package/skills/remotion-video-creation/SKILL.md +43 -0
- package/skills/remotion-video-creation/rules/3d.md +86 -0
- package/skills/remotion-video-creation/rules/animations.md +29 -0
- package/skills/remotion-video-creation/rules/assets/charts-bar-chart.tsx +173 -0
- package/skills/remotion-video-creation/rules/assets/text-animations-typewriter.tsx +100 -0
- package/skills/remotion-video-creation/rules/assets/text-animations-word-highlight.tsx +108 -0
- package/skills/remotion-video-creation/rules/assets.md +78 -0
- package/skills/remotion-video-creation/rules/audio.md +172 -0
- package/skills/remotion-video-creation/rules/calculate-metadata.md +104 -0
- package/skills/remotion-video-creation/rules/can-decode.md +75 -0
- package/skills/remotion-video-creation/rules/charts.md +58 -0
- package/skills/remotion-video-creation/rules/compositions.md +146 -0
- package/skills/remotion-video-creation/rules/display-captions.md +126 -0
- package/skills/remotion-video-creation/rules/extract-frames.md +229 -0
- package/skills/remotion-video-creation/rules/fonts.md +152 -0
- package/skills/remotion-video-creation/rules/get-audio-duration.md +58 -0
- package/skills/remotion-video-creation/rules/get-video-dimensions.md +68 -0
- package/skills/remotion-video-creation/rules/get-video-duration.md +58 -0
- package/skills/remotion-video-creation/rules/gifs.md +138 -0
- package/skills/remotion-video-creation/rules/images.md +130 -0
- package/skills/remotion-video-creation/rules/import-srt-captions.md +67 -0
- package/skills/remotion-video-creation/rules/lottie.md +67 -0
- package/skills/remotion-video-creation/rules/measuring-dom-nodes.md +34 -0
- package/skills/remotion-video-creation/rules/measuring-text.md +143 -0
- package/skills/remotion-video-creation/rules/sequencing.md +106 -0
- package/skills/remotion-video-creation/rules/tailwind.md +11 -0
- package/skills/remotion-video-creation/rules/text-animations.md +20 -0
- package/skills/remotion-video-creation/rules/timing.md +179 -0
- package/skills/remotion-video-creation/rules/transcribe-captions.md +19 -0
- package/skills/remotion-video-creation/rules/transitions.md +122 -0
- package/skills/remotion-video-creation/rules/trimming.md +52 -0
- package/skills/remotion-video-creation/rules/videos.md +171 -0
- package/skills/repo-scan/SKILL.md +78 -0
- package/skills/research-ops/SKILL.md +112 -0
- package/skills/returns-reverse-logistics/SKILL.md +240 -0
- package/skills/rules-distill/SKILL.md +264 -0
- package/skills/rules-distill/scripts/scan-rules.sh +58 -0
- package/skills/rules-distill/scripts/scan-skills.sh +129 -0
- package/skills/rust-patterns/SKILL.md +499 -0
- package/skills/rust-testing/SKILL.md +500 -0
- package/skills/safety-guard/SKILL.md +75 -0
- package/skills/santa-method/SKILL.md +306 -0
- package/skills/search-first/SKILL.md +161 -0
- package/skills/security-bounty-hunter/SKILL.md +99 -0
- package/skills/security-review/SKILL.md +495 -0
- package/skills/security-review/cloud-infrastructure-security.md +361 -0
- package/skills/security-scan/SKILL.md +165 -0
- package/skills/seo/SKILL.md +154 -0
- package/skills/skill-comply/SKILL.md +58 -0
- package/skills/skill-comply/fixtures/compliant_trace.jsonl +5 -0
- package/skills/skill-comply/fixtures/noncompliant_trace.jsonl +3 -0
- package/skills/skill-comply/fixtures/tdd_spec.yaml +44 -0
- package/skills/skill-comply/prompts/classifier.md +24 -0
- package/skills/skill-comply/prompts/scenario_generator.md +62 -0
- package/skills/skill-comply/prompts/spec_generator.md +42 -0
- package/skills/skill-comply/pyproject.toml +15 -0
- package/skills/skill-comply/scripts/__init__.py +0 -0
- package/skills/skill-comply/scripts/classifier.py +85 -0
- package/skills/skill-comply/scripts/grader.py +122 -0
- package/skills/skill-comply/scripts/parser.py +107 -0
- package/skills/skill-comply/scripts/report.py +170 -0
- package/skills/skill-comply/scripts/run.py +127 -0
- package/skills/skill-comply/scripts/runner.py +161 -0
- package/skills/skill-comply/scripts/scenario_generator.py +70 -0
- package/skills/skill-comply/scripts/spec_generator.py +72 -0
- package/skills/skill-comply/scripts/utils.py +13 -0
- package/skills/skill-comply/tests/test_grader.py +137 -0
- package/skills/skill-comply/tests/test_parser.py +90 -0
- package/skills/skill-stocktake/SKILL.md +193 -0
- package/skills/skill-stocktake/scripts/quick-diff.sh +87 -0
- package/skills/skill-stocktake/scripts/save-results.sh +56 -0
- package/skills/skill-stocktake/scripts/scan.sh +170 -0
- package/skills/smart-debug/SKILL.md +241 -0
- package/skills/social-graph-ranker/SKILL.md +154 -0
- package/skills/springboot-patterns/SKILL.md +314 -0
- package/skills/springboot-security/SKILL.md +272 -0
- package/skills/springboot-tdd/SKILL.md +158 -0
- package/skills/springboot-verification/SKILL.md +231 -0
- package/skills/strategic-compact/SKILL.md +131 -0
- package/skills/strategic-compact/suggest-compact.sh +54 -0
- package/skills/swift-actor-persistence/SKILL.md +143 -0
- package/skills/swift-concurrency-6-2/SKILL.md +216 -0
- package/skills/swift-protocol-di-testing/SKILL.md +190 -0
- package/skills/swiftui-patterns/SKILL.md +259 -0
- package/skills/tdd-workflow/SKILL.md +463 -0
- package/skills/team-builder/SKILL.md +168 -0
- package/skills/terminal-ops/SKILL.md +109 -0
- package/skills/token-budget-advisor/SKILL.md +133 -0
- package/skills/ui-demo/SKILL.md +465 -0
- package/skills/unified-notifications-ops/SKILL.md +187 -0
- package/skills/verification-loop/SKILL.md +126 -0
- package/skills/video-editing/SKILL.md +310 -0
- package/skills/videodb/SKILL.md +374 -0
- package/skills/videodb/reference/api-reference.md +550 -0
- package/skills/videodb/reference/capture-reference.md +407 -0
- package/skills/videodb/reference/capture.md +101 -0
- package/skills/videodb/reference/editor.md +443 -0
- package/skills/videodb/reference/generative.md +331 -0
- package/skills/videodb/reference/rtstream-reference.md +564 -0
- package/skills/videodb/reference/rtstream.md +65 -0
- package/skills/videodb/reference/search.md +230 -0
- package/skills/videodb/reference/streaming.md +406 -0
- package/skills/videodb/reference/use-cases.md +118 -0
- package/skills/videodb/scripts/ws_listener.py +282 -0
- package/skills/visa-doc-translate/README.md +86 -0
- package/skills/visa-doc-translate/SKILL.md +117 -0
- package/skills/workspace-surface-audit/SKILL.md +125 -0
- package/skills/x-api/SKILL.md +230 -0
- package/social/card-agents.svg +96 -0
- package/social/card-install.svg +99 -0
- package/social/card-main.svg +133 -0
- package/social/github-social-preview.svg +147 -0
- package/social/readme-agents.svg +139 -0
- package/social/readme-hero.svg +131 -0
- package/social/readme-lens.svg +140 -0
- package/social/readme-savings.svg +56 -0
- package/social/x-card-agents-grid.svg +94 -0
- package/social/x-card-free.svg +95 -0
- package/social/x-card-hook.svg +77 -0
- package/tests/hooks/branch-name-check.test.js +184 -0
- package/tests/hooks/smart-suggest.test.js +149 -0
- package/tests/hooks/test-reminder.test.js +181 -0
- package/tests/run-all.js +55 -0
- package/wiki/Agent-Reference.md +199 -0
- package/wiki/FAQ.md +142 -0
- package/wiki/Home.md +50 -0
- package/wiki/Hook-Reference.md +101 -0
- package/wiki/Installation-Guide.md +126 -0
- package/wiki/Platform-Support.md +106 -0
- package/wiki/Skill-Reference.md +103 -0
|
@@ -0,0 +1,246 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
|
|
3
|
+
const fs = require('fs');
|
|
4
|
+
const path = require('path');
|
|
5
|
+
|
|
6
|
+
const repoRoot = process.env.ECC_UNICODE_SCAN_ROOT
|
|
7
|
+
? path.resolve(process.env.ECC_UNICODE_SCAN_ROOT)
|
|
8
|
+
: path.resolve(__dirname, '..', '..');
|
|
9
|
+
|
|
10
|
+
const writeMode = process.argv.includes('--write');
|
|
11
|
+
|
|
12
|
+
const ignoredDirs = new Set([
|
|
13
|
+
'.git',
|
|
14
|
+
'node_modules',
|
|
15
|
+
'.dmux',
|
|
16
|
+
'.next',
|
|
17
|
+
'coverage',
|
|
18
|
+
]);
|
|
19
|
+
|
|
20
|
+
const textExtensions = new Set([
|
|
21
|
+
'.md',
|
|
22
|
+
'.mdx',
|
|
23
|
+
'.txt',
|
|
24
|
+
'.js',
|
|
25
|
+
'.cjs',
|
|
26
|
+
'.mjs',
|
|
27
|
+
'.ts',
|
|
28
|
+
'.tsx',
|
|
29
|
+
'.jsx',
|
|
30
|
+
'.json',
|
|
31
|
+
'.toml',
|
|
32
|
+
'.yml',
|
|
33
|
+
'.yaml',
|
|
34
|
+
'.sh',
|
|
35
|
+
'.bash',
|
|
36
|
+
'.zsh',
|
|
37
|
+
'.ps1',
|
|
38
|
+
'.py',
|
|
39
|
+
'.rs',
|
|
40
|
+
]);
|
|
41
|
+
|
|
42
|
+
const writableExtensions = new Set([
|
|
43
|
+
'.md',
|
|
44
|
+
'.mdx',
|
|
45
|
+
'.txt',
|
|
46
|
+
]);
|
|
47
|
+
|
|
48
|
+
const writeModeSkip = new Set([
|
|
49
|
+
path.normalize('scripts/ci/check-unicode-safety.js'),
|
|
50
|
+
path.normalize('tests/scripts/check-unicode-safety.test.js'),
|
|
51
|
+
]);
|
|
52
|
+
|
|
53
|
+
const emojiRe = /(?:\p{Extended_Pictographic}|\p{Regional_Indicator})/gu;
|
|
54
|
+
const allowedSymbolCodePoints = new Set([
|
|
55
|
+
0x00A9,
|
|
56
|
+
0x00AE,
|
|
57
|
+
0x2122,
|
|
58
|
+
]);
|
|
59
|
+
|
|
60
|
+
const targetedReplacements = [
|
|
61
|
+
[new RegExp(`${String.fromCodePoint(0x26A0)}(?:\\uFE0F)?`, 'gu'), 'WARNING:'],
|
|
62
|
+
[new RegExp(`${String.fromCodePoint(0x23ED)}(?:\\uFE0F)?`, 'gu'), 'SKIPPED:'],
|
|
63
|
+
[new RegExp(String.fromCodePoint(0x2705), 'gu'), 'PASS:'],
|
|
64
|
+
[new RegExp(String.fromCodePoint(0x274C), 'gu'), 'FAIL:'],
|
|
65
|
+
[new RegExp(String.fromCodePoint(0x2728), 'gu'), ''],
|
|
66
|
+
];
|
|
67
|
+
|
|
68
|
+
function shouldSkip(entryPath) {
|
|
69
|
+
return entryPath.split(path.sep).some(part => ignoredDirs.has(part));
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
function isTextFile(filePath) {
|
|
73
|
+
return textExtensions.has(path.extname(filePath).toLowerCase());
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
function canAutoWrite(relativePath) {
|
|
77
|
+
return writableExtensions.has(path.extname(relativePath).toLowerCase());
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
function listFiles(dirPath) {
|
|
81
|
+
const results = [];
|
|
82
|
+
for (const entry of fs.readdirSync(dirPath, { withFileTypes: true })) {
|
|
83
|
+
const entryPath = path.join(dirPath, entry.name);
|
|
84
|
+
if (shouldSkip(entryPath)) continue;
|
|
85
|
+
if (entry.isDirectory()) {
|
|
86
|
+
results.push(...listFiles(entryPath));
|
|
87
|
+
continue;
|
|
88
|
+
}
|
|
89
|
+
if (entry.isFile() && isTextFile(entryPath)) {
|
|
90
|
+
results.push(entryPath);
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
return results;
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
function lineAndColumn(text, index) {
|
|
97
|
+
const line = text.slice(0, index).split('\n').length;
|
|
98
|
+
const lastNewline = text.lastIndexOf('\n', index - 1);
|
|
99
|
+
const column = index - lastNewline;
|
|
100
|
+
return { line, column };
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
function isAllowedEmojiLikeSymbol(char) {
|
|
104
|
+
return allowedSymbolCodePoints.has(char.codePointAt(0));
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
function isDangerousInvisibleCodePoint(codePoint) {
|
|
108
|
+
return (
|
|
109
|
+
(codePoint >= 0x200B && codePoint <= 0x200D) ||
|
|
110
|
+
codePoint === 0x2060 ||
|
|
111
|
+
codePoint === 0xFEFF ||
|
|
112
|
+
(codePoint >= 0x202A && codePoint <= 0x202E) ||
|
|
113
|
+
(codePoint >= 0x2066 && codePoint <= 0x2069) ||
|
|
114
|
+
(codePoint >= 0xFE00 && codePoint <= 0xFE0F) ||
|
|
115
|
+
(codePoint >= 0xE0100 && codePoint <= 0xE01EF)
|
|
116
|
+
);
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
function stripDangerousInvisibleChars(text) {
|
|
120
|
+
let next = '';
|
|
121
|
+
for (const char of text) {
|
|
122
|
+
if (!isDangerousInvisibleCodePoint(char.codePointAt(0))) {
|
|
123
|
+
next += char;
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
return next;
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
function sanitizeText(text) {
|
|
130
|
+
let next = text;
|
|
131
|
+
next = stripDangerousInvisibleChars(next);
|
|
132
|
+
|
|
133
|
+
for (const [pattern, replacement] of targetedReplacements) {
|
|
134
|
+
next = next.replace(pattern, replacement);
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
next = next.replace(emojiRe, match => (isAllowedEmojiLikeSymbol(match) ? match : ''));
|
|
138
|
+
next = next.replace(/^ +(?=\*\*)/gm, '');
|
|
139
|
+
next = next.replace(/^(\*\*)\s+/gm, '$1');
|
|
140
|
+
next = next.replace(/^(#+)\s{2,}/gm, '$1 ');
|
|
141
|
+
next = next.replace(/^>\s{2,}/gm, '> ');
|
|
142
|
+
next = next.replace(/^-\s{2,}/gm, '- ');
|
|
143
|
+
next = next.replace(/^(\d+\.)\s{2,}/gm, '$1 ');
|
|
144
|
+
next = next.replace(/[ \t]+$/gm, '');
|
|
145
|
+
|
|
146
|
+
return next;
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
function collectMatches(text, regex, kind) {
|
|
150
|
+
const matches = [];
|
|
151
|
+
for (const match of text.matchAll(regex)) {
|
|
152
|
+
const char = match[0];
|
|
153
|
+
if (kind === 'emoji' && isAllowedEmojiLikeSymbol(char)) {
|
|
154
|
+
continue;
|
|
155
|
+
}
|
|
156
|
+
const index = match.index ?? 0;
|
|
157
|
+
const { line, column } = lineAndColumn(text, index);
|
|
158
|
+
matches.push({
|
|
159
|
+
kind,
|
|
160
|
+
char,
|
|
161
|
+
codePoint: `U+${char.codePointAt(0).toString(16).toUpperCase()}`,
|
|
162
|
+
line,
|
|
163
|
+
column,
|
|
164
|
+
});
|
|
165
|
+
}
|
|
166
|
+
return matches;
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
function collectDangerousInvisibleMatches(text) {
|
|
170
|
+
const matches = [];
|
|
171
|
+
let index = 0;
|
|
172
|
+
|
|
173
|
+
for (const char of text) {
|
|
174
|
+
const codePoint = char.codePointAt(0);
|
|
175
|
+
if (isDangerousInvisibleCodePoint(codePoint)) {
|
|
176
|
+
const { line, column } = lineAndColumn(text, index);
|
|
177
|
+
matches.push({
|
|
178
|
+
kind: 'dangerous-invisible',
|
|
179
|
+
char,
|
|
180
|
+
codePoint: `U+${codePoint.toString(16).toUpperCase()}`,
|
|
181
|
+
line,
|
|
182
|
+
column,
|
|
183
|
+
});
|
|
184
|
+
}
|
|
185
|
+
index += char.length;
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
return matches;
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
const changedFiles = [];
|
|
192
|
+
const violations = [];
|
|
193
|
+
|
|
194
|
+
for (const filePath of listFiles(repoRoot)) {
|
|
195
|
+
const relativePath = path.relative(repoRoot, filePath);
|
|
196
|
+
let text;
|
|
197
|
+
try {
|
|
198
|
+
text = fs.readFileSync(filePath, 'utf8');
|
|
199
|
+
} catch {
|
|
200
|
+
continue;
|
|
201
|
+
}
|
|
202
|
+
|
|
203
|
+
if (
|
|
204
|
+
writeMode &&
|
|
205
|
+
!writeModeSkip.has(path.normalize(relativePath)) &&
|
|
206
|
+
canAutoWrite(relativePath)
|
|
207
|
+
) {
|
|
208
|
+
const sanitized = sanitizeText(text);
|
|
209
|
+
if (sanitized !== text) {
|
|
210
|
+
fs.writeFileSync(filePath, sanitized, 'utf8');
|
|
211
|
+
changedFiles.push(relativePath);
|
|
212
|
+
text = sanitized;
|
|
213
|
+
}
|
|
214
|
+
}
|
|
215
|
+
|
|
216
|
+
const fileViolations = [
|
|
217
|
+
...collectDangerousInvisibleMatches(text),
|
|
218
|
+
...collectMatches(text, emojiRe, 'emoji'),
|
|
219
|
+
];
|
|
220
|
+
|
|
221
|
+
for (const violation of fileViolations) {
|
|
222
|
+
violations.push({
|
|
223
|
+
file: relativePath,
|
|
224
|
+
...violation,
|
|
225
|
+
});
|
|
226
|
+
}
|
|
227
|
+
}
|
|
228
|
+
|
|
229
|
+
if (changedFiles.length > 0) {
|
|
230
|
+
console.log(`Sanitized ${changedFiles.length} files:`);
|
|
231
|
+
for (const file of changedFiles) {
|
|
232
|
+
console.log(`- ${file}`);
|
|
233
|
+
}
|
|
234
|
+
}
|
|
235
|
+
|
|
236
|
+
if (violations.length > 0) {
|
|
237
|
+
console.error('Unicode safety violations detected:');
|
|
238
|
+
for (const violation of violations) {
|
|
239
|
+
console.error(
|
|
240
|
+
`${violation.file}:${violation.line}:${violation.column} ${violation.kind} ${violation.codePoint}`
|
|
241
|
+
);
|
|
242
|
+
}
|
|
243
|
+
process.exit(1);
|
|
244
|
+
}
|
|
245
|
+
|
|
246
|
+
console.log('Unicode safety check passed.');
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* Validate agent markdown files have required frontmatter
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
const fs = require('fs');
|
|
7
|
+
const path = require('path');
|
|
8
|
+
|
|
9
|
+
const AGENTS_DIR = path.join(__dirname, '../../agents');
|
|
10
|
+
const REQUIRED_FIELDS = ['model', 'tools'];
|
|
11
|
+
const VALID_MODELS = ['haiku', 'sonnet', 'opus'];
|
|
12
|
+
|
|
13
|
+
function extractFrontmatter(content) {
|
|
14
|
+
// Strip BOM if present (UTF-8 BOM: \uFEFF)
|
|
15
|
+
const cleanContent = content.replace(/^\uFEFF/, '');
|
|
16
|
+
// Support both LF and CRLF line endings
|
|
17
|
+
const match = cleanContent.match(/^---\r?\n([\s\S]*?)\r?\n---/);
|
|
18
|
+
if (!match) return null;
|
|
19
|
+
|
|
20
|
+
const frontmatter = {};
|
|
21
|
+
const lines = match[1].split(/\r?\n/);
|
|
22
|
+
for (const line of lines) {
|
|
23
|
+
const colonIdx = line.indexOf(':');
|
|
24
|
+
if (colonIdx > 0) {
|
|
25
|
+
const key = line.slice(0, colonIdx).trim();
|
|
26
|
+
const value = line.slice(colonIdx + 1).trim();
|
|
27
|
+
frontmatter[key] = value;
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
return frontmatter;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
function validateAgents() {
|
|
34
|
+
if (!fs.existsSync(AGENTS_DIR)) {
|
|
35
|
+
console.log('No agents directory found, skipping validation');
|
|
36
|
+
process.exit(0);
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
const files = fs.readdirSync(AGENTS_DIR).filter(f => f.endsWith('.md'));
|
|
40
|
+
let hasErrors = false;
|
|
41
|
+
|
|
42
|
+
for (const file of files) {
|
|
43
|
+
const filePath = path.join(AGENTS_DIR, file);
|
|
44
|
+
let content;
|
|
45
|
+
try {
|
|
46
|
+
content = fs.readFileSync(filePath, 'utf-8');
|
|
47
|
+
} catch (err) {
|
|
48
|
+
console.error(`ERROR: ${file} - ${err.message}`);
|
|
49
|
+
hasErrors = true;
|
|
50
|
+
continue;
|
|
51
|
+
}
|
|
52
|
+
const frontmatter = extractFrontmatter(content);
|
|
53
|
+
|
|
54
|
+
if (!frontmatter) {
|
|
55
|
+
console.error(`ERROR: ${file} - Missing frontmatter`);
|
|
56
|
+
hasErrors = true;
|
|
57
|
+
continue;
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
for (const field of REQUIRED_FIELDS) {
|
|
61
|
+
if (!frontmatter[field] || (typeof frontmatter[field] === 'string' && !frontmatter[field].trim())) {
|
|
62
|
+
console.error(`ERROR: ${file} - Missing required field: ${field}`);
|
|
63
|
+
hasErrors = true;
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
// Validate model is a known value
|
|
68
|
+
if (frontmatter.model && !VALID_MODELS.includes(frontmatter.model)) {
|
|
69
|
+
console.error(`ERROR: ${file} - Invalid model '${frontmatter.model}'. Must be one of: ${VALID_MODELS.join(', ')}`);
|
|
70
|
+
hasErrors = true;
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
if (hasErrors) {
|
|
75
|
+
process.exit(1);
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
console.log(`Validated ${files.length} agent files`);
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
validateAgents();
|
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* Validate command markdown files are non-empty, readable,
|
|
4
|
+
* and have valid cross-references to other commands, agents, and skills.
|
|
5
|
+
*/
|
|
6
|
+
|
|
7
|
+
const fs = require('fs');
|
|
8
|
+
const path = require('path');
|
|
9
|
+
|
|
10
|
+
const ROOT_DIR = path.join(__dirname, '../..');
|
|
11
|
+
const COMMANDS_DIR = path.join(ROOT_DIR, 'commands');
|
|
12
|
+
const AGENTS_DIR = path.join(ROOT_DIR, 'agents');
|
|
13
|
+
const SKILLS_DIR = path.join(ROOT_DIR, 'skills');
|
|
14
|
+
|
|
15
|
+
function validateCommands() {
|
|
16
|
+
if (!fs.existsSync(COMMANDS_DIR)) {
|
|
17
|
+
console.log('No commands directory found, skipping validation');
|
|
18
|
+
process.exit(0);
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
const files = fs.readdirSync(COMMANDS_DIR).filter(f => f.endsWith('.md'));
|
|
22
|
+
let hasErrors = false;
|
|
23
|
+
let warnCount = 0;
|
|
24
|
+
|
|
25
|
+
// Build set of valid command names (without .md extension)
|
|
26
|
+
const validCommands = new Set(files.map(f => f.replace(/\.md$/, '')));
|
|
27
|
+
|
|
28
|
+
// Build set of valid agent names (without .md extension)
|
|
29
|
+
const validAgents = new Set();
|
|
30
|
+
if (fs.existsSync(AGENTS_DIR)) {
|
|
31
|
+
for (const f of fs.readdirSync(AGENTS_DIR)) {
|
|
32
|
+
if (f.endsWith('.md')) {
|
|
33
|
+
validAgents.add(f.replace(/\.md$/, ''));
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
// Build set of valid skill directory names
|
|
39
|
+
const validSkills = new Set();
|
|
40
|
+
if (fs.existsSync(SKILLS_DIR)) {
|
|
41
|
+
for (const f of fs.readdirSync(SKILLS_DIR)) {
|
|
42
|
+
const skillPath = path.join(SKILLS_DIR, f);
|
|
43
|
+
try {
|
|
44
|
+
if (fs.statSync(skillPath).isDirectory()) {
|
|
45
|
+
validSkills.add(f);
|
|
46
|
+
}
|
|
47
|
+
} catch {
|
|
48
|
+
// skip unreadable entries
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
for (const file of files) {
|
|
54
|
+
const filePath = path.join(COMMANDS_DIR, file);
|
|
55
|
+
let content;
|
|
56
|
+
try {
|
|
57
|
+
content = fs.readFileSync(filePath, 'utf-8');
|
|
58
|
+
} catch (err) {
|
|
59
|
+
console.error(`ERROR: ${file} - ${err.message}`);
|
|
60
|
+
hasErrors = true;
|
|
61
|
+
continue;
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
// Validate the file is non-empty readable markdown
|
|
65
|
+
if (content.trim().length === 0) {
|
|
66
|
+
console.error(`ERROR: ${file} - Empty command file`);
|
|
67
|
+
hasErrors = true;
|
|
68
|
+
continue;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
// Strip fenced code blocks before checking cross-references.
|
|
72
|
+
// Examples/templates inside ``` blocks are not real references.
|
|
73
|
+
const contentNoCodeBlocks = content.replace(/```[\s\S]*?```/g, '');
|
|
74
|
+
|
|
75
|
+
// Check cross-references to other commands (e.g., `/build-fix`)
|
|
76
|
+
// Skip lines that describe hypothetical output (e.g., "→ Creates: `/new-table`")
|
|
77
|
+
// Process line-by-line so ALL command refs per line are captured
|
|
78
|
+
// (previous anchored regex /^.*`\/...`.*$/gm only matched the last ref per line)
|
|
79
|
+
for (const line of contentNoCodeBlocks.split('\n')) {
|
|
80
|
+
if (/creates:|would create:/i.test(line)) continue;
|
|
81
|
+
const lineRefs = line.matchAll(/`\/([a-z][-a-z0-9]*)`/g);
|
|
82
|
+
for (const match of lineRefs) {
|
|
83
|
+
const refName = match[1];
|
|
84
|
+
if (!validCommands.has(refName)) {
|
|
85
|
+
console.error(`ERROR: ${file} - references non-existent command /${refName}`);
|
|
86
|
+
hasErrors = true;
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
// Check agent references (e.g., "agents/planner.md" or "`planner` agent")
|
|
92
|
+
const agentPathRefs = contentNoCodeBlocks.matchAll(/agents\/([a-z][-a-z0-9]*)\.md/g);
|
|
93
|
+
for (const match of agentPathRefs) {
|
|
94
|
+
const refName = match[1];
|
|
95
|
+
if (!validAgents.has(refName)) {
|
|
96
|
+
console.error(`ERROR: ${file} - references non-existent agent agents/${refName}.md`);
|
|
97
|
+
hasErrors = true;
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
// Check skill directory references (e.g., "skills/tdd-workflow/")
|
|
102
|
+
// learned and imported are reserved roots (~/.claude/skills/); no local dir expected
|
|
103
|
+
const reservedSkillRoots = new Set(['learned', 'imported']);
|
|
104
|
+
const skillRefs = contentNoCodeBlocks.matchAll(/skills\/([a-z][-a-z0-9]*)\//g);
|
|
105
|
+
for (const match of skillRefs) {
|
|
106
|
+
const refName = match[1];
|
|
107
|
+
if (reservedSkillRoots.has(refName) || validSkills.has(refName)) continue;
|
|
108
|
+
console.warn(`WARN: ${file} - references skill directory skills/${refName}/ (not found locally)`);
|
|
109
|
+
warnCount++;
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
// Check agent name references in workflow diagrams (e.g., "planner -> tdd-guide")
|
|
113
|
+
const workflowLines = contentNoCodeBlocks.matchAll(/^([a-z][-a-z0-9]*(?:\s*->\s*[a-z][-a-z0-9]*)+)$/gm);
|
|
114
|
+
for (const match of workflowLines) {
|
|
115
|
+
const agents = match[1].split(/\s*->\s*/);
|
|
116
|
+
for (const agent of agents) {
|
|
117
|
+
if (!validAgents.has(agent)) {
|
|
118
|
+
console.error(`ERROR: ${file} - workflow references non-existent agent "${agent}"`);
|
|
119
|
+
hasErrors = true;
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
if (hasErrors) {
|
|
126
|
+
process.exit(1);
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
let msg = `Validated ${files.length} command files`;
|
|
130
|
+
if (warnCount > 0) {
|
|
131
|
+
msg += ` (${warnCount} warnings)`;
|
|
132
|
+
}
|
|
133
|
+
console.log(msg);
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
validateCommands();
|
|
@@ -0,0 +1,239 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* Validate hooks.json schema and hook entry rules.
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
const fs = require('fs');
|
|
7
|
+
const path = require('path');
|
|
8
|
+
const vm = require('vm');
|
|
9
|
+
const Ajv = require('ajv');
|
|
10
|
+
|
|
11
|
+
const HOOKS_FILE = path.join(__dirname, '../../hooks/hooks.json');
|
|
12
|
+
const HOOKS_SCHEMA_PATH = path.join(__dirname, '../../schemas/hooks.schema.json');
|
|
13
|
+
const VALID_EVENTS = [
|
|
14
|
+
'SessionStart',
|
|
15
|
+
'UserPromptSubmit',
|
|
16
|
+
'PreToolUse',
|
|
17
|
+
'PermissionRequest',
|
|
18
|
+
'PostToolUse',
|
|
19
|
+
'PostToolUseFailure',
|
|
20
|
+
'Notification',
|
|
21
|
+
'SubagentStart',
|
|
22
|
+
'Stop',
|
|
23
|
+
'SubagentStop',
|
|
24
|
+
'PreCompact',
|
|
25
|
+
'InstructionsLoaded',
|
|
26
|
+
'TeammateIdle',
|
|
27
|
+
'TaskCompleted',
|
|
28
|
+
'ConfigChange',
|
|
29
|
+
'WorktreeCreate',
|
|
30
|
+
'WorktreeRemove',
|
|
31
|
+
'SessionEnd',
|
|
32
|
+
];
|
|
33
|
+
const VALID_HOOK_TYPES = ['command', 'http', 'prompt', 'agent'];
|
|
34
|
+
const EVENTS_WITHOUT_MATCHER = new Set(['UserPromptSubmit', 'Notification', 'Stop', 'SubagentStop']);
|
|
35
|
+
|
|
36
|
+
function isNonEmptyString(value) {
|
|
37
|
+
return typeof value === 'string' && value.trim().length > 0;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
function isNonEmptyStringArray(value) {
|
|
41
|
+
return Array.isArray(value) && value.length > 0 && value.every(item => isNonEmptyString(item));
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* Validate a single hook entry has required fields and valid inline JS
|
|
46
|
+
* @param {object} hook - Hook object with type and command fields
|
|
47
|
+
* @param {string} label - Label for error messages (e.g., "PreToolUse[0].hooks[1]")
|
|
48
|
+
* @returns {boolean} true if errors were found
|
|
49
|
+
*/
|
|
50
|
+
function validateHookEntry(hook, label) {
|
|
51
|
+
let hasErrors = false;
|
|
52
|
+
|
|
53
|
+
if (!hook.type || typeof hook.type !== 'string') {
|
|
54
|
+
console.error(`ERROR: ${label} missing or invalid 'type' field`);
|
|
55
|
+
hasErrors = true;
|
|
56
|
+
} else if (!VALID_HOOK_TYPES.includes(hook.type)) {
|
|
57
|
+
console.error(`ERROR: ${label} has unsupported hook type '${hook.type}'`);
|
|
58
|
+
hasErrors = true;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
if ('timeout' in hook && (typeof hook.timeout !== 'number' || hook.timeout < 0)) {
|
|
62
|
+
console.error(`ERROR: ${label} 'timeout' must be a non-negative number`);
|
|
63
|
+
hasErrors = true;
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
if (hook.type === 'command') {
|
|
67
|
+
if ('async' in hook && typeof hook.async !== 'boolean') {
|
|
68
|
+
console.error(`ERROR: ${label} 'async' must be a boolean`);
|
|
69
|
+
hasErrors = true;
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
if (!isNonEmptyString(hook.command) && !isNonEmptyStringArray(hook.command)) {
|
|
73
|
+
console.error(`ERROR: ${label} missing or invalid 'command' field`);
|
|
74
|
+
hasErrors = true;
|
|
75
|
+
} else if (typeof hook.command === 'string') {
|
|
76
|
+
const nodeEMatch = hook.command.match(/^node -e "(.*)"$/s);
|
|
77
|
+
if (nodeEMatch) {
|
|
78
|
+
try {
|
|
79
|
+
new vm.Script(nodeEMatch[1].replace(/\\\\/g, '\\').replace(/\\"/g, '"').replace(/\\n/g, '\n').replace(/\\t/g, '\t'));
|
|
80
|
+
} catch (syntaxErr) {
|
|
81
|
+
console.error(`ERROR: ${label} has invalid inline JS: ${syntaxErr.message}`);
|
|
82
|
+
hasErrors = true;
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
return hasErrors;
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
if ('async' in hook) {
|
|
91
|
+
console.error(`ERROR: ${label} 'async' is only supported for command hooks`);
|
|
92
|
+
hasErrors = true;
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
if (hook.type === 'http') {
|
|
96
|
+
if (!isNonEmptyString(hook.url)) {
|
|
97
|
+
console.error(`ERROR: ${label} missing or invalid 'url' field`);
|
|
98
|
+
hasErrors = true;
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
if ('headers' in hook && (typeof hook.headers !== 'object' || hook.headers === null || Array.isArray(hook.headers) || !Object.values(hook.headers).every(value => typeof value === 'string'))) {
|
|
102
|
+
console.error(`ERROR: ${label} 'headers' must be an object with string values`);
|
|
103
|
+
hasErrors = true;
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
if ('allowedEnvVars' in hook && (!Array.isArray(hook.allowedEnvVars) || !hook.allowedEnvVars.every(value => isNonEmptyString(value)))) {
|
|
107
|
+
console.error(`ERROR: ${label} 'allowedEnvVars' must be an array of strings`);
|
|
108
|
+
hasErrors = true;
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
return hasErrors;
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
if (!isNonEmptyString(hook.prompt)) {
|
|
115
|
+
console.error(`ERROR: ${label} missing or invalid 'prompt' field`);
|
|
116
|
+
hasErrors = true;
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
if ('model' in hook && !isNonEmptyString(hook.model)) {
|
|
120
|
+
console.error(`ERROR: ${label} 'model' must be a non-empty string`);
|
|
121
|
+
hasErrors = true;
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
return hasErrors;
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
function validateHooks() {
|
|
128
|
+
if (!fs.existsSync(HOOKS_FILE)) {
|
|
129
|
+
console.log('No hooks.json found, skipping validation');
|
|
130
|
+
process.exit(0);
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
let data;
|
|
134
|
+
try {
|
|
135
|
+
data = JSON.parse(fs.readFileSync(HOOKS_FILE, 'utf-8'));
|
|
136
|
+
} catch (e) {
|
|
137
|
+
console.error(`ERROR: Invalid JSON in hooks.json: ${e.message}`);
|
|
138
|
+
process.exit(1);
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
// Validate against JSON schema
|
|
142
|
+
if (fs.existsSync(HOOKS_SCHEMA_PATH)) {
|
|
143
|
+
const schema = JSON.parse(fs.readFileSync(HOOKS_SCHEMA_PATH, 'utf-8'));
|
|
144
|
+
const ajv = new Ajv({ allErrors: true });
|
|
145
|
+
const validate = ajv.compile(schema);
|
|
146
|
+
const valid = validate(data);
|
|
147
|
+
if (!valid) {
|
|
148
|
+
for (const err of validate.errors) {
|
|
149
|
+
console.error(`ERROR: hooks.json schema: ${err.instancePath || '/'} ${err.message}`);
|
|
150
|
+
}
|
|
151
|
+
process.exit(1);
|
|
152
|
+
}
|
|
153
|
+
}
|
|
154
|
+
|
|
155
|
+
// Support both object format { hooks: {...} } and array format
|
|
156
|
+
const hooks = data.hooks || data;
|
|
157
|
+
let hasErrors = false;
|
|
158
|
+
let totalMatchers = 0;
|
|
159
|
+
|
|
160
|
+
if (typeof hooks === 'object' && !Array.isArray(hooks)) {
|
|
161
|
+
// Object format: { EventType: [matchers] }
|
|
162
|
+
for (const [eventType, matchers] of Object.entries(hooks)) {
|
|
163
|
+
if (!VALID_EVENTS.includes(eventType)) {
|
|
164
|
+
console.error(`ERROR: Invalid event type: ${eventType}`);
|
|
165
|
+
hasErrors = true;
|
|
166
|
+
continue;
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
if (!Array.isArray(matchers)) {
|
|
170
|
+
console.error(`ERROR: ${eventType} must be an array`);
|
|
171
|
+
hasErrors = true;
|
|
172
|
+
continue;
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
for (let i = 0; i < matchers.length; i++) {
|
|
176
|
+
const matcher = matchers[i];
|
|
177
|
+
if (typeof matcher !== 'object' || matcher === null) {
|
|
178
|
+
console.error(`ERROR: ${eventType}[${i}] is not an object`);
|
|
179
|
+
hasErrors = true;
|
|
180
|
+
continue;
|
|
181
|
+
}
|
|
182
|
+
if (!('matcher' in matcher) && !EVENTS_WITHOUT_MATCHER.has(eventType)) {
|
|
183
|
+
console.error(`ERROR: ${eventType}[${i}] missing 'matcher' field`);
|
|
184
|
+
hasErrors = true;
|
|
185
|
+
} else if ('matcher' in matcher && typeof matcher.matcher !== 'string' && (typeof matcher.matcher !== 'object' || matcher.matcher === null)) {
|
|
186
|
+
console.error(`ERROR: ${eventType}[${i}] has invalid 'matcher' field`);
|
|
187
|
+
hasErrors = true;
|
|
188
|
+
}
|
|
189
|
+
if (!matcher.hooks || !Array.isArray(matcher.hooks)) {
|
|
190
|
+
console.error(`ERROR: ${eventType}[${i}] missing 'hooks' array`);
|
|
191
|
+
hasErrors = true;
|
|
192
|
+
} else {
|
|
193
|
+
// Validate each hook entry
|
|
194
|
+
for (let j = 0; j < matcher.hooks.length; j++) {
|
|
195
|
+
if (validateHookEntry(matcher.hooks[j], `${eventType}[${i}].hooks[${j}]`)) {
|
|
196
|
+
hasErrors = true;
|
|
197
|
+
}
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
totalMatchers++;
|
|
201
|
+
}
|
|
202
|
+
}
|
|
203
|
+
} else if (Array.isArray(hooks)) {
|
|
204
|
+
// Array format (legacy)
|
|
205
|
+
for (let i = 0; i < hooks.length; i++) {
|
|
206
|
+
const hook = hooks[i];
|
|
207
|
+
if (!('matcher' in hook)) {
|
|
208
|
+
console.error(`ERROR: Hook ${i} missing 'matcher' field`);
|
|
209
|
+
hasErrors = true;
|
|
210
|
+
} else if (typeof hook.matcher !== 'string' && (typeof hook.matcher !== 'object' || hook.matcher === null)) {
|
|
211
|
+
console.error(`ERROR: Hook ${i} has invalid 'matcher' field`);
|
|
212
|
+
hasErrors = true;
|
|
213
|
+
}
|
|
214
|
+
if (!hook.hooks || !Array.isArray(hook.hooks)) {
|
|
215
|
+
console.error(`ERROR: Hook ${i} missing 'hooks' array`);
|
|
216
|
+
hasErrors = true;
|
|
217
|
+
} else {
|
|
218
|
+
// Validate each hook entry
|
|
219
|
+
for (let j = 0; j < hook.hooks.length; j++) {
|
|
220
|
+
if (validateHookEntry(hook.hooks[j], `Hook ${i}.hooks[${j}]`)) {
|
|
221
|
+
hasErrors = true;
|
|
222
|
+
}
|
|
223
|
+
}
|
|
224
|
+
}
|
|
225
|
+
totalMatchers++;
|
|
226
|
+
}
|
|
227
|
+
} else {
|
|
228
|
+
console.error('ERROR: hooks.json must be an object or array');
|
|
229
|
+
process.exit(1);
|
|
230
|
+
}
|
|
231
|
+
|
|
232
|
+
if (hasErrors) {
|
|
233
|
+
process.exit(1);
|
|
234
|
+
}
|
|
235
|
+
|
|
236
|
+
console.log(`Validated ${totalMatchers} hook matchers`);
|
|
237
|
+
}
|
|
238
|
+
|
|
239
|
+
validateHooks();
|