@paths.design/caws-cli 10.2.0 → 11.0.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/README.md +125 -374
- package/dist/index.js +43 -785
- package/dist/shell/binding/resolve-binding.d.ts +4 -0
- package/dist/shell/binding/resolve-binding.d.ts.map +1 -0
- package/dist/shell/binding/resolve-binding.js +228 -0
- package/dist/shell/binding/resolve-binding.js.map +1 -0
- package/dist/shell/binding/types.d.ts +42 -0
- package/dist/shell/binding/types.d.ts.map +1 -0
- package/dist/shell/binding/types.js +21 -0
- package/dist/shell/binding/types.js.map +1 -0
- package/dist/shell/commands/claim.d.ts +14 -0
- package/dist/shell/commands/claim.d.ts.map +1 -0
- package/dist/shell/commands/claim.js +197 -0
- package/dist/shell/commands/claim.js.map +1 -0
- package/dist/shell/commands/doctor.d.ts +13 -0
- package/dist/shell/commands/doctor.d.ts.map +1 -0
- package/dist/shell/commands/doctor.js +97 -0
- package/dist/shell/commands/doctor.js.map +1 -0
- package/dist/shell/commands/evidence.d.ts +28 -0
- package/dist/shell/commands/evidence.d.ts.map +1 -0
- package/dist/shell/commands/evidence.js +166 -0
- package/dist/shell/commands/evidence.js.map +1 -0
- package/dist/shell/commands/gates.d.ts +19 -0
- package/dist/shell/commands/gates.d.ts.map +1 -0
- package/dist/shell/commands/gates.js +181 -0
- package/dist/shell/commands/gates.js.map +1 -0
- package/dist/shell/commands/init.d.ts +8 -0
- package/dist/shell/commands/init.d.ts.map +1 -0
- package/dist/shell/commands/init.js +64 -0
- package/dist/shell/commands/init.js.map +1 -0
- package/dist/shell/commands/scope.d.ts +11 -0
- package/dist/shell/commands/scope.d.ts.map +1 -0
- package/dist/shell/commands/scope.js +92 -0
- package/dist/shell/commands/scope.js.map +1 -0
- package/dist/shell/commands/status.d.ts +15 -0
- package/dist/shell/commands/status.d.ts.map +1 -0
- package/dist/shell/commands/status.js +106 -0
- package/dist/shell/commands/status.js.map +1 -0
- package/dist/shell/commands/waiver.d.ts +38 -0
- package/dist/shell/commands/waiver.d.ts.map +1 -0
- package/dist/shell/commands/waiver.js +240 -0
- package/dist/shell/commands/waiver.js.map +1 -0
- package/dist/shell/gates/disposition.d.ts +23 -0
- package/dist/shell/gates/disposition.d.ts.map +1 -0
- package/dist/shell/gates/disposition.js +87 -0
- package/dist/shell/gates/disposition.js.map +1 -0
- package/dist/shell/gates/gate-result-contract.d.ts +39 -0
- package/dist/shell/gates/gate-result-contract.d.ts.map +1 -0
- package/dist/shell/gates/gate-result-contract.js +150 -0
- package/dist/shell/gates/gate-result-contract.js.map +1 -0
- package/dist/shell/gates/quality-gates-adapter.d.ts +55 -0
- package/dist/shell/gates/quality-gates-adapter.d.ts.map +1 -0
- package/dist/shell/gates/quality-gates-adapter.js +161 -0
- package/dist/shell/gates/quality-gates-adapter.js.map +1 -0
- package/dist/shell/gates/waiver-filter.d.ts +58 -0
- package/dist/shell/gates/waiver-filter.d.ts.map +1 -0
- package/dist/shell/gates/waiver-filter.js +119 -0
- package/dist/shell/gates/waiver-filter.js.map +1 -0
- package/dist/shell/index.d.ts +50 -0
- package/dist/shell/index.d.ts.map +1 -0
- package/dist/shell/index.js +73 -0
- package/dist/shell/index.js.map +1 -0
- package/dist/shell/register.d.ts +11 -0
- package/dist/shell/register.d.ts.map +1 -0
- package/dist/shell/register.js +274 -0
- package/dist/shell/register.js.map +1 -0
- package/dist/shell/render/claim.d.ts +22 -0
- package/dist/shell/render/claim.d.ts.map +1 -0
- package/dist/shell/render/claim.js +75 -0
- package/dist/shell/render/claim.js.map +1 -0
- package/dist/shell/render/decision.d.ts +15 -0
- package/dist/shell/render/decision.d.ts.map +1 -0
- package/dist/shell/render/decision.js +66 -0
- package/dist/shell/render/decision.js.map +1 -0
- package/dist/shell/render/diagnostic.d.ts +19 -0
- package/dist/shell/render/diagnostic.d.ts.map +1 -0
- package/dist/shell/render/diagnostic.js +76 -0
- package/dist/shell/render/diagnostic.js.map +1 -0
- package/dist/shell/render/finding.d.ts +15 -0
- package/dist/shell/render/finding.d.ts.map +1 -0
- package/dist/shell/render/finding.js +57 -0
- package/dist/shell/render/finding.js.map +1 -0
- package/dist/shell/render/gates.d.ts +3 -0
- package/dist/shell/render/gates.d.ts.map +1 -0
- package/dist/shell/render/gates.js +56 -0
- package/dist/shell/render/gates.js.map +1 -0
- package/dist/shell/render/init.d.ts +11 -0
- package/dist/shell/render/init.d.ts.map +1 -0
- package/dist/shell/render/init.js +32 -0
- package/dist/shell/render/init.js.map +1 -0
- package/dist/shell/render/status.d.ts +26 -0
- package/dist/shell/render/status.d.ts.map +1 -0
- package/dist/shell/render/status.js +143 -0
- package/dist/shell/render/status.js.map +1 -0
- package/dist/shell/render/waiver.d.ts +21 -0
- package/dist/shell/render/waiver.d.ts.map +1 -0
- package/dist/shell/render/waiver.js +94 -0
- package/dist/shell/render/waiver.js.map +1 -0
- package/dist/shell/rules.d.ts +37 -0
- package/dist/shell/rules.d.ts.map +1 -0
- package/dist/shell/rules.js +51 -0
- package/dist/shell/rules.js.map +1 -0
- package/dist/shell/session/actor.d.ts +14 -0
- package/dist/shell/session/actor.d.ts.map +1 -0
- package/dist/shell/session/actor.js +34 -0
- package/dist/shell/session/actor.js.map +1 -0
- package/dist/shell/session/resolve-session.d.ts +5 -0
- package/dist/shell/session/resolve-session.d.ts.map +1 -0
- package/dist/shell/session/resolve-session.js +239 -0
- package/dist/shell/session/resolve-session.js.map +1 -0
- package/dist/shell/session/types.d.ts +56 -0
- package/dist/shell/session/types.d.ts.map +1 -0
- package/dist/shell/session/types.js +15 -0
- package/dist/shell/session/types.js.map +1 -0
- package/dist/store/agents-store.d.ts +3 -0
- package/dist/store/agents-store.d.ts.map +1 -0
- package/dist/store/agents-store.js +63 -0
- package/dist/store/agents-store.js.map +1 -0
- package/dist/store/apply-patch.d.ts +16 -0
- package/dist/store/apply-patch.d.ts.map +1 -0
- package/dist/store/apply-patch.js +191 -0
- package/dist/store/apply-patch.js.map +1 -0
- package/dist/store/atomic-write.d.ts +16 -0
- package/dist/store/atomic-write.d.ts.map +1 -0
- package/dist/store/atomic-write.js +132 -0
- package/dist/store/atomic-write.js.map +1 -0
- package/dist/store/doctor-snapshot.d.ts +20 -0
- package/dist/store/doctor-snapshot.d.ts.map +1 -0
- package/dist/store/doctor-snapshot.js +176 -0
- package/dist/store/doctor-snapshot.js.map +1 -0
- package/dist/store/events-store.d.ts +33 -0
- package/dist/store/events-store.d.ts.map +1 -0
- package/dist/store/events-store.js +297 -0
- package/dist/store/events-store.js.map +1 -0
- package/dist/store/index.d.ts +21 -0
- package/dist/store/index.d.ts.map +1 -0
- package/dist/store/index.js +47 -0
- package/dist/store/index.js.map +1 -0
- package/dist/store/init-store.d.ts +21 -0
- package/dist/store/init-store.d.ts.map +1 -0
- package/dist/store/init-store.js +295 -0
- package/dist/store/init-store.js.map +1 -0
- package/dist/store/json-store.d.ts +3 -0
- package/dist/store/json-store.d.ts.map +1 -0
- package/dist/store/json-store.js +65 -0
- package/dist/store/json-store.js.map +1 -0
- package/dist/store/policy-store.d.ts +3 -0
- package/dist/store/policy-store.d.ts.map +1 -0
- package/dist/store/policy-store.js +65 -0
- package/dist/store/policy-store.js.map +1 -0
- package/dist/store/repo-root.d.ts +46 -0
- package/dist/store/repo-root.d.ts.map +1 -0
- package/dist/store/repo-root.js +145 -0
- package/dist/store/repo-root.js.map +1 -0
- package/dist/store/rules.d.ts +53 -0
- package/dist/store/rules.d.ts.map +1 -0
- package/dist/store/rules.js +78 -0
- package/dist/store/rules.js.map +1 -0
- package/dist/store/specs-store.d.ts +3 -0
- package/dist/store/specs-store.d.ts.map +1 -0
- package/dist/store/specs-store.js +131 -0
- package/dist/store/specs-store.js.map +1 -0
- package/dist/store/types.d.ts +84 -0
- package/dist/store/types.d.ts.map +1 -0
- package/dist/store/types.js +14 -0
- package/dist/store/types.js.map +1 -0
- package/dist/store/waivers-store.d.ts +25 -0
- package/dist/store/waivers-store.d.ts.map +1 -0
- package/dist/store/waivers-store.js +232 -0
- package/dist/store/waivers-store.js.map +1 -0
- package/dist/store/worktrees-store.d.ts +3 -0
- package/dist/store/worktrees-store.d.ts.map +1 -0
- package/dist/store/worktrees-store.js +62 -0
- package/dist/store/worktrees-store.js.map +1 -0
- package/dist/store/yaml-store.d.ts +9 -0
- package/dist/store/yaml-store.d.ts.map +1 -0
- package/dist/store/yaml-store.js +121 -0
- package/dist/store/yaml-store.js.map +1 -0
- package/package.json +15 -13
- package/dist/budget-derivation.js +0 -751
- package/dist/cicd-optimizer.js +0 -504
- package/dist/commands/agents.js +0 -124
- package/dist/commands/archive.js +0 -500
- package/dist/commands/burnup.js +0 -198
- package/dist/commands/diagnose.js +0 -525
- package/dist/commands/evaluate.js +0 -314
- package/dist/commands/gates.js +0 -149
- package/dist/commands/init.js +0 -857
- package/dist/commands/iterate.js +0 -417
- package/dist/commands/mode.js +0 -269
- package/dist/commands/parallel.js +0 -242
- package/dist/commands/plan.js +0 -438
- package/dist/commands/provenance.js +0 -1143
- package/dist/commands/quality-monitor.js +0 -284
- package/dist/commands/scope.js +0 -264
- package/dist/commands/session.js +0 -312
- package/dist/commands/sidecar.js +0 -74
- package/dist/commands/specs.js +0 -1656
- package/dist/commands/status.js +0 -1172
- package/dist/commands/templates.js +0 -237
- package/dist/commands/tool.js +0 -136
- package/dist/commands/tutorial.js +0 -480
- package/dist/commands/validate.js +0 -357
- package/dist/commands/verify-acs.js +0 -443
- package/dist/commands/waivers.js +0 -599
- package/dist/commands/workflow.js +0 -243
- package/dist/commands/worktree.js +0 -502
- package/dist/config/lite-scope.js +0 -158
- package/dist/config/modes.js +0 -347
- package/dist/constants/spec-types.js +0 -65
- package/dist/gates/budget-limit.js +0 -121
- package/dist/gates/feedback.js +0 -260
- package/dist/gates/format.js +0 -179
- package/dist/gates/god-object.js +0 -117
- package/dist/gates/pipeline.js +0 -167
- package/dist/gates/scope-boundary.js +0 -112
- package/dist/gates/spec-completeness.js +0 -109
- package/dist/gates/todo-detection.js +0 -205
- package/dist/generators/jest-config-generator.js +0 -242
- package/dist/generators/working-spec.js +0 -237
- package/dist/minimal-cli.js +0 -88
- package/dist/parallel/parallel-manager.js +0 -433
- package/dist/policy/PolicyManager.js +0 -470
- package/dist/scaffold/claude-hooks.js +0 -443
- package/dist/scaffold/cursor-hooks.js +0 -177
- package/dist/scaffold/git-hooks.js +0 -928
- package/dist/scaffold/index.js +0 -794
- package/dist/session/session-manager.js +0 -653
- package/dist/sidecars/index.js +0 -33
- package/dist/sidecars/listeners.js +0 -40
- package/dist/sidecars/provenance-summary.js +0 -238
- package/dist/sidecars/quality-gaps.js +0 -258
- package/dist/sidecars/schema.js +0 -149
- package/dist/sidecars/spec-drift.js +0 -151
- package/dist/sidecars/waiver-draft.js +0 -176
- package/dist/spec/SpecFileManager.js +0 -419
- package/dist/templates/.caws/schemas/policy.schema.json +0 -117
- package/dist/templates/.caws/schemas/scope.schema.json +0 -52
- package/dist/templates/.caws/schemas/waivers.schema.json +0 -106
- package/dist/templates/.caws/schemas/working-spec.schema.json +0 -340
- package/dist/templates/.caws/schemas/worktrees.schema.json +0 -38
- package/dist/templates/.caws/templates/working-spec.template.yml +0 -80
- package/dist/templates/.caws/tools/README.md +0 -18
- package/dist/templates/.caws/tools/scope-guard.js +0 -203
- package/dist/templates/.caws/tools-allow.json +0 -331
- package/dist/templates/.caws/waivers.yml +0 -19
- package/dist/templates/.claude/README.md +0 -190
- package/dist/templates/.claude/hooks/audit.sh +0 -121
- package/dist/templates/.claude/hooks/block-dangerous.sh +0 -203
- package/dist/templates/.claude/hooks/classify_command.py +0 -592
- package/dist/templates/.claude/hooks/doc-frontmatter-check.sh +0 -173
- package/dist/templates/.claude/hooks/lite-sprawl-check.sh +0 -145
- package/dist/templates/.claude/hooks/naming-check.sh +0 -100
- package/dist/templates/.claude/hooks/protected-paths.sh +0 -39
- package/dist/templates/.claude/hooks/quality-check.sh +0 -81
- package/dist/templates/.claude/hooks/scan-secrets.sh +0 -85
- package/dist/templates/.claude/hooks/scope-guard.sh +0 -381
- package/dist/templates/.claude/hooks/session-caws-status.sh +0 -117
- package/dist/templates/.claude/hooks/session-log.sh +0 -634
- package/dist/templates/.claude/hooks/simplification-guard.sh +0 -92
- package/dist/templates/.claude/hooks/stop-worktree-check.sh +0 -46
- package/dist/templates/.claude/hooks/test_classify_command.py +0 -370
- package/dist/templates/.claude/hooks/test_wrapper_smoke.sh +0 -96
- package/dist/templates/.claude/hooks/validate-spec.sh +0 -76
- package/dist/templates/.claude/hooks/worktree-guard.sh +0 -220
- package/dist/templates/.claude/hooks/worktree-write-guard.sh +0 -190
- package/dist/templates/.claude/rules/git-safety.md +0 -26
- package/dist/templates/.claude/rules/worktree-isolation.md +0 -101
- package/dist/templates/.claude/settings.json +0 -141
- package/dist/templates/.cursor/README.md +0 -299
- package/dist/templates/.cursor/hooks/audit.sh +0 -55
- package/dist/templates/.cursor/hooks/block-dangerous.sh +0 -84
- package/dist/templates/.cursor/hooks/caws-quality-check.sh +0 -52
- package/dist/templates/.cursor/hooks/caws-scope-guard.sh +0 -130
- package/dist/templates/.cursor/hooks/format.sh +0 -38
- package/dist/templates/.cursor/hooks/naming-check.sh +0 -64
- package/dist/templates/.cursor/hooks/scan-secrets.sh +0 -51
- package/dist/templates/.cursor/hooks/scope-guard.sh +0 -52
- package/dist/templates/.cursor/hooks/session-log.sh +0 -924
- package/dist/templates/.cursor/hooks/validate-spec.sh +0 -83
- package/dist/templates/.cursor/hooks.json +0 -76
- package/dist/templates/.cursor/rules/00-claims-verification.mdc +0 -144
- package/dist/templates/.cursor/rules/01-working-style.mdc +0 -50
- package/dist/templates/.cursor/rules/02-quality-gates.mdc +0 -368
- package/dist/templates/.cursor/rules/03-naming-and-refactor.mdc +0 -33
- package/dist/templates/.cursor/rules/04-logging-language-style.mdc +0 -23
- package/dist/templates/.cursor/rules/05-safe-defaults-guards.mdc +0 -23
- package/dist/templates/.cursor/rules/06-typescript-conventions.mdc +0 -36
- package/dist/templates/.cursor/rules/07-process-ops.mdc +0 -20
- package/dist/templates/.cursor/rules/08-solid-and-architecture.mdc +0 -16
- package/dist/templates/.cursor/rules/09-docstrings.mdc +0 -89
- package/dist/templates/.cursor/rules/10-documentation-quality-standards.mdc +0 -385
- package/dist/templates/.cursor/rules/11-scope-management-waivers.mdc +0 -381
- package/dist/templates/.cursor/rules/12-implementation-completeness.mdc +0 -516
- package/dist/templates/.cursor/rules/13-language-agnostic-standards.mdc +0 -578
- package/dist/templates/.cursor/rules/README.md +0 -148
- package/dist/templates/.github/copilot-instructions.md +0 -82
- package/dist/templates/.idea/runConfigurations/CAWS_Evaluate.xml +0 -5
- package/dist/templates/.idea/runConfigurations/CAWS_Validate.xml +0 -5
- package/dist/templates/.junie/guidelines.md +0 -73
- package/dist/templates/.vscode/launch.json +0 -17
- package/dist/templates/.vscode/settings.json +0 -95
- package/dist/templates/.windsurf/rules/caws-quality-standards.md +0 -54
- package/dist/templates/.windsurf/workflows/caws-guided-development.md +0 -92
- package/dist/templates/CLAUDE.md +0 -196
- package/dist/templates/COMMIT_CONVENTIONS.md +0 -86
- package/dist/templates/OIDC_SETUP.md +0 -300
- package/dist/templates/agents.md +0 -171
- package/dist/templates/codemod/README.md +0 -1
- package/dist/templates/codemod/test.js +0 -93
- package/dist/templates/docs/README.md +0 -151
- package/dist/templates/scripts/new_feature.sh +0 -80
- package/dist/templates/scripts/quality-gates/check-god-objects.js +0 -146
- package/dist/templates/scripts/quality-gates/run-quality-gates.js +0 -50
- package/dist/templates/scripts/v3/analysis/todo_analyzer.py +0 -1997
- package/dist/test-analysis.js +0 -786
- package/dist/tool-interface.js +0 -314
- package/dist/tool-loader.js +0 -303
- package/dist/tool-validator.js +0 -393
- package/dist/utils/agent-display.js +0 -210
- package/dist/utils/agent-session.js +0 -344
- package/dist/utils/async-utils.js +0 -188
- package/dist/utils/command-wrapper.js +0 -200
- package/dist/utils/event-log.js +0 -584
- package/dist/utils/event-renderer.js +0 -521
- package/dist/utils/finalization.js +0 -230
- package/dist/utils/git-lock.js +0 -119
- package/dist/utils/gitignore-updater.js +0 -158
- package/dist/utils/ide-detection.js +0 -133
- package/dist/utils/lifecycle-events.js +0 -94
- package/dist/utils/project-analysis.js +0 -367
- package/dist/utils/promise-utils.js +0 -72
- package/dist/utils/quality-gates-errors.js +0 -520
- package/dist/utils/quality-gates-utils.js +0 -387
- package/dist/utils/schema-validator.js +0 -50
- package/dist/utils/spec-resolver.js +0 -711
- package/dist/utils/typescript-detector.js +0 -369
- package/dist/utils/working-state.js +0 -530
- package/dist/utils/yaml-validation.js +0 -156
- package/dist/validation/spec-validation.js +0 -924
- package/dist/waivers-manager.js +0 -732
- package/dist/worktree/worktree-manager.js +0 -1735
- package/templates/.caws/schemas/policy.schema.json +0 -117
- package/templates/.caws/schemas/scope.schema.json +0 -52
- package/templates/.caws/schemas/waivers.schema.json +0 -106
- package/templates/.caws/schemas/working-spec.schema.json +0 -340
- package/templates/.caws/schemas/worktrees.schema.json +0 -38
- package/templates/.caws/templates/working-spec.template.yml +0 -80
- package/templates/.caws/tools/README.md +0 -18
- package/templates/.caws/tools/scope-guard.js +0 -203
- package/templates/.caws/tools-allow.json +0 -331
- package/templates/.caws/waivers.yml +0 -19
- package/templates/.claude/README.md +0 -190
- package/templates/.claude/hooks/audit.sh +0 -121
- package/templates/.claude/hooks/block-dangerous.sh +0 -203
- package/templates/.claude/hooks/classify_command.py +0 -592
- package/templates/.claude/hooks/doc-frontmatter-check.sh +0 -173
- package/templates/.claude/hooks/lite-sprawl-check.sh +0 -145
- package/templates/.claude/hooks/naming-check.sh +0 -100
- package/templates/.claude/hooks/protected-paths.sh +0 -39
- package/templates/.claude/hooks/quality-check.sh +0 -81
- package/templates/.claude/hooks/scan-secrets.sh +0 -85
- package/templates/.claude/hooks/scope-guard.sh +0 -381
- package/templates/.claude/hooks/session-caws-status.sh +0 -117
- package/templates/.claude/hooks/session-log.sh +0 -634
- package/templates/.claude/hooks/simplification-guard.sh +0 -92
- package/templates/.claude/hooks/stop-worktree-check.sh +0 -46
- package/templates/.claude/hooks/test_classify_command.py +0 -370
- package/templates/.claude/hooks/test_wrapper_smoke.sh +0 -96
- package/templates/.claude/hooks/validate-spec.sh +0 -76
- package/templates/.claude/hooks/worktree-guard.sh +0 -220
- package/templates/.claude/hooks/worktree-write-guard.sh +0 -190
- package/templates/.claude/rules/git-safety.md +0 -26
- package/templates/.claude/rules/worktree-isolation.md +0 -101
- package/templates/.claude/settings.json +0 -141
- package/templates/.cursor/README.md +0 -299
- package/templates/.cursor/hooks/audit.sh +0 -55
- package/templates/.cursor/hooks/block-dangerous.sh +0 -84
- package/templates/.cursor/hooks/caws-quality-check.sh +0 -52
- package/templates/.cursor/hooks/caws-scope-guard.sh +0 -130
- package/templates/.cursor/hooks/format.sh +0 -38
- package/templates/.cursor/hooks/naming-check.sh +0 -64
- package/templates/.cursor/hooks/scan-secrets.sh +0 -51
- package/templates/.cursor/hooks/scope-guard.sh +0 -52
- package/templates/.cursor/hooks/session-log.sh +0 -924
- package/templates/.cursor/hooks/validate-spec.sh +0 -83
- package/templates/.cursor/hooks.json +0 -76
- package/templates/.cursor/rules/00-claims-verification.mdc +0 -144
- package/templates/.cursor/rules/01-working-style.mdc +0 -50
- package/templates/.cursor/rules/02-quality-gates.mdc +0 -368
- package/templates/.cursor/rules/03-naming-and-refactor.mdc +0 -33
- package/templates/.cursor/rules/04-logging-language-style.mdc +0 -23
- package/templates/.cursor/rules/05-safe-defaults-guards.mdc +0 -23
- package/templates/.cursor/rules/06-typescript-conventions.mdc +0 -36
- package/templates/.cursor/rules/07-process-ops.mdc +0 -20
- package/templates/.cursor/rules/08-solid-and-architecture.mdc +0 -16
- package/templates/.cursor/rules/09-docstrings.mdc +0 -89
- package/templates/.cursor/rules/10-documentation-quality-standards.mdc +0 -385
- package/templates/.cursor/rules/11-scope-management-waivers.mdc +0 -381
- package/templates/.cursor/rules/12-implementation-completeness.mdc +0 -516
- package/templates/.cursor/rules/13-language-agnostic-standards.mdc +0 -578
- package/templates/.cursor/rules/README.md +0 -148
- package/templates/.github/copilot-instructions.md +0 -82
- package/templates/.idea/runConfigurations/CAWS_Evaluate.xml +0 -5
- package/templates/.idea/runConfigurations/CAWS_Validate.xml +0 -5
- package/templates/.junie/guidelines.md +0 -73
- package/templates/.vscode/launch.json +0 -17
- package/templates/.vscode/settings.json +0 -95
- package/templates/.windsurf/rules/caws-quality-standards.md +0 -54
- package/templates/.windsurf/workflows/caws-guided-development.md +0 -92
- package/templates/CLAUDE.md +0 -196
- package/templates/COMMIT_CONVENTIONS.md +0 -86
- package/templates/OIDC_SETUP.md +0 -300
- package/templates/agents.md +0 -171
- package/templates/codemod/README.md +0 -1
- package/templates/codemod/test.js +0 -93
- package/templates/docs/README.md +0 -151
- package/templates/scripts/new_feature.sh +0 -80
- package/templates/scripts/quality-gates/check-god-objects.js +0 -146
- package/templates/scripts/quality-gates/run-quality-gates.js +0 -50
- package/templates/scripts/v3/analysis/todo_analyzer.py +0 -1997
|
@@ -1,237 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @fileoverview CAWS Templates Command
|
|
3
|
-
* Discover and manage project templates
|
|
4
|
-
* @author @darianrosebrook
|
|
5
|
-
*/
|
|
6
|
-
|
|
7
|
-
const fs = require('fs-extra');
|
|
8
|
-
const path = require('path');
|
|
9
|
-
const chalk = require('chalk');
|
|
10
|
-
const { findPackageRoot } = require('../utils/detection');
|
|
11
|
-
|
|
12
|
-
/**
|
|
13
|
-
* Built-in template definitions
|
|
14
|
-
*/
|
|
15
|
-
const BUILTIN_TEMPLATES = {
|
|
16
|
-
'typescript-library': {
|
|
17
|
-
name: 'TypeScript Library',
|
|
18
|
-
description: 'Production-ready TypeScript library with Jest testing',
|
|
19
|
-
category: 'TypeScript',
|
|
20
|
-
tier: 2,
|
|
21
|
-
features: ['TypeScript', 'Jest', 'ESLint', 'Prettier', 'Publishing'],
|
|
22
|
-
path: 'templates/typescript/library',
|
|
23
|
-
},
|
|
24
|
-
'typescript-api': {
|
|
25
|
-
name: 'TypeScript API',
|
|
26
|
-
description: 'REST API with Express and TypeScript',
|
|
27
|
-
category: 'TypeScript',
|
|
28
|
-
tier: 1,
|
|
29
|
-
features: ['TypeScript', 'Express', 'Jest', 'OpenAPI', 'Docker'],
|
|
30
|
-
path: 'templates/typescript/api',
|
|
31
|
-
},
|
|
32
|
-
'typescript-monorepo': {
|
|
33
|
-
name: 'TypeScript Monorepo',
|
|
34
|
-
description: 'Multi-package TypeScript monorepo with Turbo',
|
|
35
|
-
category: 'TypeScript',
|
|
36
|
-
tier: 2,
|
|
37
|
-
features: ['TypeScript', 'Turborepo', 'Jest', 'Changesets'],
|
|
38
|
-
path: 'templates/typescript/monorepo',
|
|
39
|
-
},
|
|
40
|
-
'javascript-package': {
|
|
41
|
-
name: 'JavaScript Package',
|
|
42
|
-
description: 'NPM package with modern JavaScript',
|
|
43
|
-
category: 'JavaScript',
|
|
44
|
-
tier: 3,
|
|
45
|
-
features: ['JavaScript', 'Jest', 'ESLint', 'Publishing'],
|
|
46
|
-
path: 'templates/javascript/package',
|
|
47
|
-
},
|
|
48
|
-
'react-component-lib': {
|
|
49
|
-
name: 'React Component Library',
|
|
50
|
-
description: 'Reusable React component library with Storybook',
|
|
51
|
-
category: 'React',
|
|
52
|
-
tier: 2,
|
|
53
|
-
features: ['React', 'TypeScript', 'Storybook', 'Jest', 'Publishing'],
|
|
54
|
-
path: 'templates/react/component-library',
|
|
55
|
-
},
|
|
56
|
-
};
|
|
57
|
-
|
|
58
|
-
/**
|
|
59
|
-
* Get template directory path
|
|
60
|
-
* Works in both development and global install scenarios
|
|
61
|
-
* @returns {string|null} Template directory path or null
|
|
62
|
-
*/
|
|
63
|
-
function getTemplateDir() {
|
|
64
|
-
// Find package root using shared utility
|
|
65
|
-
const packageRoot = findPackageRoot(__dirname);
|
|
66
|
-
|
|
67
|
-
const possiblePaths = [
|
|
68
|
-
// First: Try templates relative to package root (works in dev and global install)
|
|
69
|
-
path.join(packageRoot, 'templates'),
|
|
70
|
-
// Fallback: Try relative to current file location (for development)
|
|
71
|
-
path.join(__dirname, '../../templates'),
|
|
72
|
-
path.join(__dirname, '../templates'),
|
|
73
|
-
// Legacy fallbacks
|
|
74
|
-
path.join(process.cwd(), 'packages/caws-cli/templates'),
|
|
75
|
-
path.join(process.cwd(), 'templates'),
|
|
76
|
-
];
|
|
77
|
-
|
|
78
|
-
for (const testPath of possiblePaths) {
|
|
79
|
-
if (fs.existsSync(testPath)) {
|
|
80
|
-
return testPath;
|
|
81
|
-
}
|
|
82
|
-
}
|
|
83
|
-
|
|
84
|
-
return null;
|
|
85
|
-
}
|
|
86
|
-
|
|
87
|
-
/**
|
|
88
|
-
* Check which templates actually exist
|
|
89
|
-
* @returns {Object} Available templates
|
|
90
|
-
*/
|
|
91
|
-
function getAvailableTemplates() {
|
|
92
|
-
const templateDir = getTemplateDir();
|
|
93
|
-
const available = {};
|
|
94
|
-
|
|
95
|
-
for (const [id, template] of Object.entries(BUILTIN_TEMPLATES)) {
|
|
96
|
-
const templatePath = templateDir
|
|
97
|
-
? path.join(templateDir, template.path.replace('templates/', ''))
|
|
98
|
-
: null;
|
|
99
|
-
|
|
100
|
-
available[id] = {
|
|
101
|
-
...template,
|
|
102
|
-
available: templatePath ? fs.existsSync(templatePath) : false,
|
|
103
|
-
fullPath: templatePath,
|
|
104
|
-
};
|
|
105
|
-
}
|
|
106
|
-
|
|
107
|
-
return available;
|
|
108
|
-
}
|
|
109
|
-
|
|
110
|
-
/**
|
|
111
|
-
* List all available templates
|
|
112
|
-
*/
|
|
113
|
-
function listTemplates() {
|
|
114
|
-
const templates = getAvailableTemplates();
|
|
115
|
-
const categories = {};
|
|
116
|
-
|
|
117
|
-
// Group by category
|
|
118
|
-
for (const [id, template] of Object.entries(templates)) {
|
|
119
|
-
if (!categories[template.category]) {
|
|
120
|
-
categories[template.category] = [];
|
|
121
|
-
}
|
|
122
|
-
categories[template.category].push({ id, ...template });
|
|
123
|
-
}
|
|
124
|
-
|
|
125
|
-
console.log(chalk.bold.cyan('\nAvailable CAWS Templates\n'));
|
|
126
|
-
|
|
127
|
-
// Display by category
|
|
128
|
-
for (const [category, categoryTemplates] of Object.entries(categories)) {
|
|
129
|
-
console.log(chalk.bold.white(`${category}:`));
|
|
130
|
-
|
|
131
|
-
for (const template of categoryTemplates) {
|
|
132
|
-
const status = template.available ? chalk.green('') : chalk.gray('');
|
|
133
|
-
console.log(`${status} ${chalk.bold(template.id.padEnd(25))} - ${template.description}`);
|
|
134
|
-
console.log(chalk.gray(` Usage: caws init --template=${template.id} my-project`));
|
|
135
|
-
console.log(chalk.gray(` Features: ${template.features.join(', ')}`));
|
|
136
|
-
console.log('');
|
|
137
|
-
}
|
|
138
|
-
}
|
|
139
|
-
|
|
140
|
-
const totalAvailable = Object.values(templates).filter((t) => t.available).length;
|
|
141
|
-
const totalTemplates = Object.keys(templates).length;
|
|
142
|
-
|
|
143
|
-
if (totalAvailable < totalTemplates) {
|
|
144
|
-
console.log(chalk.yellow(`\n${totalTemplates - totalAvailable} additional templates in development`));
|
|
145
|
-
}
|
|
146
|
-
|
|
147
|
-
console.log(chalk.blue('\nLearn more:'));
|
|
148
|
-
console.log(chalk.blue(' caws templates --help'));
|
|
149
|
-
console.log(chalk.blue(' docs/guides/template-usage.md'));
|
|
150
|
-
|
|
151
|
-
console.log('');
|
|
152
|
-
}
|
|
153
|
-
|
|
154
|
-
/**
|
|
155
|
-
* Show detailed template information
|
|
156
|
-
* @param {string} templateId - Template ID
|
|
157
|
-
*/
|
|
158
|
-
function showTemplateInfo(templateId) {
|
|
159
|
-
const templates = getAvailableTemplates();
|
|
160
|
-
const template = templates[templateId];
|
|
161
|
-
|
|
162
|
-
if (!template) {
|
|
163
|
-
console.error(chalk.red(`\nTemplate not found: ${templateId}`));
|
|
164
|
-
console.error(chalk.yellow('\nAvailable templates:'));
|
|
165
|
-
console.error(chalk.yellow(` ${Object.keys(templates).join(', ')}`));
|
|
166
|
-
console.error(chalk.yellow('\nTry: caws templates list'));
|
|
167
|
-
process.exit(1);
|
|
168
|
-
}
|
|
169
|
-
|
|
170
|
-
console.log(chalk.bold.cyan(`\nTemplate: ${template.name}\n`));
|
|
171
|
-
console.log(chalk.white(`Description: ${template.description}`));
|
|
172
|
-
console.log(chalk.white(`Category: ${template.category}`));
|
|
173
|
-
console.log(chalk.white(`Risk Tier: ${template.tier}`));
|
|
174
|
-
console.log(
|
|
175
|
-
chalk.white(
|
|
176
|
-
`Status: ${template.available ? chalk.green('Available') : chalk.yellow('In Development')}`
|
|
177
|
-
)
|
|
178
|
-
);
|
|
179
|
-
|
|
180
|
-
console.log(chalk.bold.white('\nFeatures:'));
|
|
181
|
-
template.features.forEach((feature) => {
|
|
182
|
-
console.log(chalk.gray(` - ${feature}`));
|
|
183
|
-
});
|
|
184
|
-
|
|
185
|
-
console.log(chalk.bold.white('\nUsage:'));
|
|
186
|
-
console.log(chalk.cyan(` caws init --template=${templateId} my-project`));
|
|
187
|
-
console.log(chalk.cyan(` cd my-project`));
|
|
188
|
-
console.log(chalk.cyan(` npm install`));
|
|
189
|
-
console.log(chalk.cyan(` npm test`));
|
|
190
|
-
|
|
191
|
-
if (template.available && template.fullPath) {
|
|
192
|
-
console.log(chalk.bold.white('\nTemplate Location:'));
|
|
193
|
-
console.log(chalk.gray(` ${template.fullPath}`));
|
|
194
|
-
}
|
|
195
|
-
|
|
196
|
-
console.log('');
|
|
197
|
-
}
|
|
198
|
-
|
|
199
|
-
/**
|
|
200
|
-
* Templates command handler
|
|
201
|
-
* @param {string} subcommand - Subcommand (list, info)
|
|
202
|
-
* @param {Object} options - Command options
|
|
203
|
-
*/
|
|
204
|
-
async function templatesCommand(subcommand = 'list', options = {}) {
|
|
205
|
-
try {
|
|
206
|
-
switch (subcommand) {
|
|
207
|
-
case 'list':
|
|
208
|
-
listTemplates();
|
|
209
|
-
break;
|
|
210
|
-
|
|
211
|
-
case 'info':
|
|
212
|
-
if (!options.name) {
|
|
213
|
-
console.error(chalk.red('\nTemplate name required'));
|
|
214
|
-
console.error(chalk.yellow('Usage: caws templates info <template-name>'));
|
|
215
|
-
console.error(chalk.yellow('Try: caws templates list to see available templates'));
|
|
216
|
-
process.exit(1);
|
|
217
|
-
}
|
|
218
|
-
showTemplateInfo(options.name);
|
|
219
|
-
break;
|
|
220
|
-
|
|
221
|
-
default:
|
|
222
|
-
listTemplates();
|
|
223
|
-
}
|
|
224
|
-
} catch (error) {
|
|
225
|
-
console.error(chalk.red('\nError:'), error.message);
|
|
226
|
-
console.error(chalk.yellow('\nTry: caws templates list'));
|
|
227
|
-
process.exit(1);
|
|
228
|
-
}
|
|
229
|
-
}
|
|
230
|
-
|
|
231
|
-
module.exports = {
|
|
232
|
-
templatesCommand,
|
|
233
|
-
listTemplates,
|
|
234
|
-
showTemplateInfo,
|
|
235
|
-
getAvailableTemplates,
|
|
236
|
-
BUILTIN_TEMPLATES,
|
|
237
|
-
};
|
package/dist/commands/tool.js
DELETED
|
@@ -1,136 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @fileoverview Tool Command Handler
|
|
3
|
-
* Handles tool execution commands for CAWS CLI
|
|
4
|
-
* @author @darianrosebrook
|
|
5
|
-
*/
|
|
6
|
-
|
|
7
|
-
const { commandWrapper, Output } = require('../utils/command-wrapper');
|
|
8
|
-
|
|
9
|
-
// Import tool system
|
|
10
|
-
const ToolLoader = require('../tool-loader');
|
|
11
|
-
const ToolValidator = require('../tool-validator');
|
|
12
|
-
|
|
13
|
-
// Tool system state
|
|
14
|
-
let toolLoader = null;
|
|
15
|
-
let toolValidator = null;
|
|
16
|
-
|
|
17
|
-
/**
|
|
18
|
-
* Initialize tool system
|
|
19
|
-
* @returns {Promise<ToolLoader|null>} Initialized tool loader or null if failed
|
|
20
|
-
*/
|
|
21
|
-
async function initializeToolSystem() {
|
|
22
|
-
if (toolLoader) return toolLoader;
|
|
23
|
-
|
|
24
|
-
try {
|
|
25
|
-
// ToolLoader now checks .caws/tools first, then falls back to legacy location
|
|
26
|
-
toolLoader = new ToolLoader();
|
|
27
|
-
|
|
28
|
-
toolValidator = new ToolValidator();
|
|
29
|
-
|
|
30
|
-
// Set up event listeners for tool system
|
|
31
|
-
toolLoader.on('discovery:complete', ({ tools: _tools, count }) => {
|
|
32
|
-
if (count > 0) {
|
|
33
|
-
Output.info(`Discovered ${count} tools`);
|
|
34
|
-
}
|
|
35
|
-
});
|
|
36
|
-
|
|
37
|
-
toolLoader.on('tool:loaded', ({ id, metadata }) => {
|
|
38
|
-
// Only log in verbose mode or when not using JSON output
|
|
39
|
-
if (!process.env.CAWS_OUTPUT_FORMAT || process.env.CAWS_OUTPUT_FORMAT !== 'json') {
|
|
40
|
-
console.log(` [ok] Loaded tool: ${metadata.name} (${id})`);
|
|
41
|
-
}
|
|
42
|
-
});
|
|
43
|
-
|
|
44
|
-
toolLoader.on('tool:error', ({ id, error }) => {
|
|
45
|
-
Output.warning(`Failed to load tool ${id}: ${error}`);
|
|
46
|
-
});
|
|
47
|
-
|
|
48
|
-
// Auto-discover tools on initialization
|
|
49
|
-
await toolLoader.discoverTools();
|
|
50
|
-
|
|
51
|
-
return toolLoader;
|
|
52
|
-
} catch (error) {
|
|
53
|
-
Output.warning(
|
|
54
|
-
`Tool system initialization failed: ${error.message}`,
|
|
55
|
-
'Continuing without dynamic tools'
|
|
56
|
-
);
|
|
57
|
-
return null;
|
|
58
|
-
}
|
|
59
|
-
}
|
|
60
|
-
|
|
61
|
-
/**
|
|
62
|
-
* Execute tool command handler
|
|
63
|
-
* @param {string} toolId - ID of the tool to execute
|
|
64
|
-
* @param {Object} options - Command options
|
|
65
|
-
*/
|
|
66
|
-
async function executeTool(toolId, options) {
|
|
67
|
-
return commandWrapper(
|
|
68
|
-
async () => {
|
|
69
|
-
// Initialize tool system
|
|
70
|
-
const loader = await initializeToolSystem();
|
|
71
|
-
|
|
72
|
-
if (!loader) {
|
|
73
|
-
throw new Error('Tool system not available');
|
|
74
|
-
}
|
|
75
|
-
|
|
76
|
-
// Load all tools first
|
|
77
|
-
await loader.loadAllTools();
|
|
78
|
-
const tool = loader.getTool(toolId);
|
|
79
|
-
|
|
80
|
-
if (!tool) {
|
|
81
|
-
const tools = loader.getAllTools();
|
|
82
|
-
const availableTools = Array.from(tools, ([id, t]) => `${id}: ${t.metadata.name}`).join(
|
|
83
|
-
', '
|
|
84
|
-
);
|
|
85
|
-
throw new Error(`Tool '${toolId}' not found.\n` + `Available tools: ${availableTools}`);
|
|
86
|
-
}
|
|
87
|
-
|
|
88
|
-
// Validate tool before execution
|
|
89
|
-
const validation = await toolValidator.validateTool(tool);
|
|
90
|
-
if (!validation.valid) {
|
|
91
|
-
throw new Error(
|
|
92
|
-
`Tool validation failed:\n` + validation.errors.map((e) => ` - ${e}`).join('\n')
|
|
93
|
-
);
|
|
94
|
-
}
|
|
95
|
-
|
|
96
|
-
// Parse parameters
|
|
97
|
-
let params = {};
|
|
98
|
-
if (options.params) {
|
|
99
|
-
try {
|
|
100
|
-
params = JSON.parse(options.params);
|
|
101
|
-
} catch (error) {
|
|
102
|
-
throw new Error(`Invalid JSON parameters: ${error.message}`);
|
|
103
|
-
}
|
|
104
|
-
}
|
|
105
|
-
|
|
106
|
-
Output.progress(`Executing tool: ${tool.metadata.name}`);
|
|
107
|
-
|
|
108
|
-
// Execute tool
|
|
109
|
-
const result = await tool.module.execute(params, {
|
|
110
|
-
workingDirectory: process.cwd(),
|
|
111
|
-
timeout: options.timeout,
|
|
112
|
-
});
|
|
113
|
-
|
|
114
|
-
// Display results
|
|
115
|
-
if (result.success) {
|
|
116
|
-
Output.success('Tool execution successful', {
|
|
117
|
-
output: result.output,
|
|
118
|
-
});
|
|
119
|
-
return result;
|
|
120
|
-
} else {
|
|
121
|
-
throw new Error(
|
|
122
|
-
`Tool execution failed:\n` + result.errors.map((e) => ` - ${e}`).join('\n')
|
|
123
|
-
);
|
|
124
|
-
}
|
|
125
|
-
},
|
|
126
|
-
{
|
|
127
|
-
commandName: `tool ${toolId}`,
|
|
128
|
-
context: { toolId, options },
|
|
129
|
-
}
|
|
130
|
-
);
|
|
131
|
-
}
|
|
132
|
-
|
|
133
|
-
module.exports = {
|
|
134
|
-
initializeToolSystem,
|
|
135
|
-
executeTool,
|
|
136
|
-
};
|