beth-copilot 1.0.14 → 1.0.15

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.
Files changed (104) hide show
  1. package/CHANGELOG.md +195 -177
  2. package/README.md +408 -185
  3. package/bin/cli.js +0 -0
  4. package/dist/cli/commands/doctor.e2e.test.d.ts +8 -0
  5. package/dist/cli/commands/doctor.e2e.test.d.ts.map +1 -0
  6. package/dist/cli/commands/doctor.e2e.test.js +428 -0
  7. package/dist/cli/commands/doctor.e2e.test.js.map +1 -0
  8. package/dist/cli/commands/doctor.test.js +1 -1
  9. package/dist/cli/commands/help.e2e.test.d.ts +9 -0
  10. package/dist/cli/commands/help.e2e.test.d.ts.map +1 -0
  11. package/dist/cli/commands/help.e2e.test.js +150 -0
  12. package/dist/cli/commands/help.e2e.test.js.map +1 -0
  13. package/dist/cli/commands/init.test.d.ts +6 -0
  14. package/dist/cli/commands/init.test.d.ts.map +1 -0
  15. package/dist/cli/commands/init.test.js +289 -0
  16. package/dist/cli/commands/init.test.js.map +1 -0
  17. package/dist/cli/commands/mcp.e2e.test.d.ts +9 -0
  18. package/dist/cli/commands/mcp.e2e.test.d.ts.map +1 -0
  19. package/dist/cli/commands/mcp.e2e.test.js +139 -0
  20. package/dist/cli/commands/mcp.e2e.test.js.map +1 -0
  21. package/dist/cli/commands/pipeline.e2e.test.d.ts +9 -0
  22. package/dist/cli/commands/pipeline.e2e.test.d.ts.map +1 -0
  23. package/dist/cli/commands/pipeline.e2e.test.js +192 -0
  24. package/dist/cli/commands/pipeline.e2e.test.js.map +1 -0
  25. package/dist/cli/commands/quickstart.test.d.ts +6 -0
  26. package/dist/cli/commands/quickstart.test.d.ts.map +1 -0
  27. package/dist/cli/commands/quickstart.test.js +232 -0
  28. package/dist/cli/commands/quickstart.test.js.map +1 -0
  29. package/dist/core/agents/frontmatter.test.d.ts +8 -0
  30. package/dist/core/agents/frontmatter.test.d.ts.map +1 -0
  31. package/dist/core/agents/frontmatter.test.js +589 -0
  32. package/dist/core/agents/frontmatter.test.js.map +1 -0
  33. package/dist/core/agents/handoffs.test.d.ts +8 -0
  34. package/dist/core/agents/handoffs.test.d.ts.map +1 -0
  35. package/dist/core/agents/handoffs.test.js +320 -0
  36. package/dist/core/agents/handoffs.test.js.map +1 -0
  37. package/dist/core/agents/loader.test.js +1 -1
  38. package/dist/core/agents/suite.test.d.ts +8 -0
  39. package/dist/core/agents/suite.test.d.ts.map +1 -0
  40. package/dist/core/agents/suite.test.js +207 -0
  41. package/dist/core/agents/suite.test.js.map +1 -0
  42. package/dist/core/agents/tools.test.d.ts +8 -0
  43. package/dist/core/agents/tools.test.d.ts.map +1 -0
  44. package/dist/core/agents/tools.test.js +332 -0
  45. package/dist/core/agents/tools.test.js.map +1 -0
  46. package/dist/init.test.js +288 -0
  47. package/dist/providers/azure.d.ts +147 -0
  48. package/dist/providers/azure.d.ts.map +1 -0
  49. package/dist/providers/azure.js +491 -0
  50. package/dist/providers/azure.js.map +1 -0
  51. package/dist/providers/azure.test.d.ts +11 -0
  52. package/dist/providers/azure.test.d.ts.map +1 -0
  53. package/dist/providers/azure.test.js +330 -0
  54. package/dist/providers/azure.test.js.map +1 -0
  55. package/dist/providers/config.d.ts +87 -0
  56. package/dist/providers/config.d.ts.map +1 -0
  57. package/dist/providers/config.js +193 -0
  58. package/dist/providers/config.js.map +1 -0
  59. package/dist/providers/config.test.d.ts +7 -0
  60. package/dist/providers/config.test.d.ts.map +1 -0
  61. package/dist/providers/config.test.js +370 -0
  62. package/dist/providers/config.test.js.map +1 -0
  63. package/dist/providers/index.d.ts +18 -0
  64. package/dist/providers/index.d.ts.map +1 -0
  65. package/dist/providers/index.js +14 -0
  66. package/dist/providers/index.js.map +1 -0
  67. package/dist/providers/interface.d.ts +191 -0
  68. package/dist/providers/interface.d.ts.map +1 -0
  69. package/dist/providers/interface.js +94 -0
  70. package/dist/providers/interface.js.map +1 -0
  71. package/dist/providers/retry.d.ts +128 -0
  72. package/dist/providers/retry.d.ts.map +1 -0
  73. package/dist/providers/retry.js +205 -0
  74. package/dist/providers/retry.js.map +1 -0
  75. package/dist/providers/retry.test.d.ts +7 -0
  76. package/dist/providers/retry.test.d.ts.map +1 -0
  77. package/dist/providers/retry.test.js +439 -0
  78. package/dist/providers/retry.test.js.map +1 -0
  79. package/dist/providers/streaming.d.ts +157 -0
  80. package/dist/providers/streaming.d.ts.map +1 -0
  81. package/dist/providers/streaming.js +233 -0
  82. package/dist/providers/streaming.js.map +1 -0
  83. package/dist/providers/streaming.test.d.ts +7 -0
  84. package/dist/providers/streaming.test.d.ts.map +1 -0
  85. package/dist/providers/streaming.test.js +372 -0
  86. package/dist/providers/streaming.test.js.map +1 -0
  87. package/dist/providers/types.d.ts +209 -0
  88. package/dist/providers/types.d.ts.map +1 -0
  89. package/dist/providers/types.js +53 -0
  90. package/dist/providers/types.js.map +1 -0
  91. package/dist/providers/types.test.d.ts +7 -0
  92. package/dist/providers/types.test.d.ts.map +1 -0
  93. package/dist/providers/types.test.js +141 -0
  94. package/dist/providers/types.test.js.map +1 -0
  95. package/package.json +60 -56
  96. package/sbom.json +3302 -8
  97. package/templates/.github/agents/beth.agent.md +329 -329
  98. package/templates/.github/agents/developer.agent.md +572 -572
  99. package/templates/.github/agents/product-manager.agent.md +272 -272
  100. package/templates/.github/agents/researcher.agent.md +338 -338
  101. package/templates/.github/agents/security-reviewer.agent.md +465 -465
  102. package/templates/.github/agents/tester.agent.md +496 -496
  103. package/templates/.github/agents/ux-designer.agent.md +393 -393
  104. package/templates/mcp.json.example +4 -0
package/CHANGELOG.md CHANGED
@@ -1,177 +1,195 @@
1
- # Changelog
2
-
3
- > *"Here's what changed. I don't repeat myself."*
4
-
5
- All notable changes to Beth are documented here. Format based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
6
-
7
- ---
8
-
9
- ## [1.0.14] - 2026-02-04
10
-
11
- ### Changed
12
- - **User-friendly error messages** — CLI errors now display formatted boxes with clear problem descriptions, fix instructions, and the exact command to run. No more raw stack traces.
13
-
14
- ---
15
-
16
- ## [1.0.13] - 2026-02-04
17
-
18
- ### Fixed
19
- - **ENOTDIR crash during init** — Fixed `copyDirRecursive` crashing when destination path exists as a file instead of a directory. Now properly detects the conflict and provides a clear error message (or removes the file with `--force`).
20
-
21
- ---
22
-
23
- ## [Unreleased]
24
-
25
- ### Added
26
- - **CLI TypeScript foundation** — Migrated CLI to TypeScript with proper build system
27
- - **Doctor command** — `beth doctor` validates installation and configuration
28
- - **Quickstart command** — `beth quickstart` for guided setup
29
- - **Agent schema types** — TypeScript types for agent definitions
30
- - **Unit tests** — 86 tests passing for CLI commands and path validation
31
- - **Architecture diagrams** — Interactive mermaid diagrams with zoom in README
32
-
33
- ### Changed
34
- - **DEMO.md** — Rewritten with Beth's personality and beads integration
35
- - **P2 backlog completed** — Beth orchestrator references added to all agents, MCP skills updated, documentation fixes
36
-
37
- ### Fixed
38
- - Removed unnecessary backlog.md CLI dependency
39
- - Fixed security-reviewer.agent.md syntax errors
40
- - Corrected agent/skill counts in help output
41
- - Allowlisted security documentation examples in Gitleaks config
42
-
43
- ### Documentation
44
- - CLI Architecture guide (docs/CLI-ARCHITECTURE.md)
45
- - CLI Implementation Plan (docs/CLI-IMPLEMENTATION-PLAN.md)
46
-
47
- ---
48
-
49
- ## [1.0.12] - 2026-02-01
50
-
51
- ### Changed
52
- - Added CHANGELOG.md to npm package
53
-
54
- ---
55
-
56
- ## [1.0.11] - 2026-02-01
57
-
58
- ### Changed
59
- - Reverted to fire animation for BETH banner (the way it should be)
60
-
61
- ### Fixed
62
- - SBOM regeneration for accurate dependency tracking
63
-
64
- ---
65
-
66
- ## [1.0.10] - 2026-01-31
67
-
68
- ### Added
69
- - **Path validation security** — 33 tests covering traversal detection, injection prevention, and allowlist validation
70
- - **Work tracking for all agents** — Every agent now uses the dual tracking system (beads for agents, Backlog.md for humans)
71
- - **Cross-platform npm installation** — Consistent installation across macOS, Linux, and Windows
72
-
73
- ### Security
74
- - Path validation for user-supplied binary paths to prevent command injection
75
- - Documented shell:true security constraints in SECURITY.md
76
-
77
- ---
78
-
79
- ## [1.0.6] - 2026-01-29
80
-
81
- ### Added
82
- - **Multi-agent coordination system** — Epic patterns with dependencies, parallel execution, and hierarchical issue tracking
83
- - **Beads integration** — Structured work tracking with `bd` CLI for agent memory and coordination
84
- - **Subagent templates** — Ready-to-use patterns for spawning specialists
85
-
86
- ### Changed
87
- - Beth instructions now include full orchestration workflows
88
- - Updated SYSTEM-FLOW.md with multi-agent patterns
89
-
90
- ---
91
-
92
- ## [1.0.5] - 2026-01-28
93
-
94
- ### Added
95
- - Beads multi-agent coordination documentation
96
-
97
- ---
98
-
99
- ## [1.0.4] - 2026-01-27
100
-
101
- ### Added
102
- - **backlog.md CLI installation prompt** — Auto-prompts during init for human-readable tracking
103
- - **.vscode/settings.json template** — Auto-configured agent settings for VS Code
104
-
105
- ---
106
-
107
- ## [1.0.3] - 2026-01-26
108
-
109
- ### Added
110
- - **Version check** — CLI warns users when a newer version is available
111
-
112
- ---
113
-
114
- ## [1.0.2] - 2026-01-25
115
-
116
- ### Added
117
- - **Security automation** — GitHub Actions workflow with npm audit, gitleaks, CodeQL, SBOM generation
118
- - **Pre-commit hooks** — Secret scanning with gitleaks before commits
119
- - **Subagent delegation settings** — Documentation for enabling autonomous agent coordination
120
-
121
- ### Changed
122
- - Clarified Product Manager vs UX Designer roles in documentation
123
-
124
- ### Fixed
125
- - Security hardening for enterprise production readiness
126
-
127
- ---
128
-
129
- ## [1.0.1] - 2026-01-24
130
-
131
- ### Added
132
- - **Security Reviewer agent** — OWASP Top 10, compliance audits, threat modeling
133
- - **Security Analysis skill** — Vulnerability assessment workflows
134
- - **MCP setup guide** — docs/MCP-SETUP.md with all optional servers
135
- - **Installation guide** — docs/INSTALLATION.md with full setup instructions
136
- - **Dependabot configuration** — Weekly npm/GH Actions updates with grouped PRs
137
-
138
- ### Changed
139
- - **Consolidated frontend-engineer into developer** — Developer now handles UI, full-stack, and shadcn-ui MCP integration
140
- - Updated all agent handoffs to include security-reviewer
141
-
142
- ### Security
143
- - Full enterprise security review completed
144
- - HIGH findings addressed
145
- - SECURITY.md created with security policies
146
-
147
- ---
148
-
149
- ## [1.0.0] - 2026-01-23
150
-
151
- ### Added
152
- - **Beth orchestrator** — The ruthless, hyper-competent AI coordinator
153
- - **Six specialist agents** — Product Manager, Researcher, UX Designer, Developer, Tester, (later Security Reviewer)
154
- - **Five skills** — PRD generation, Framer components, Vercel React best practices, Web Design guidelines, shadcn-ui
155
- - **npm package** — `npx beth-copilot init` for one-command installation
156
- - **IDEO Design Thinking workflow** — Empathize → Define → Ideate → Prototype → Test
157
- - **Dual tracking system** — beads for agents, Backlog.md for humans
158
- - **ASCII art animation** Beth's entrance with fire effect banner
159
-
160
- ### Architecture
161
- - Agent definition format with YAML frontmatter
162
- - Skills as domain-knowledge modules loaded on-demand
163
- - Subagent vs handoff patterns for different control levels
164
- - Hierarchical issue tracking for complex workflows
165
-
166
- ---
167
-
168
- ## What's Next
169
-
170
- See [Backlog.md](Backlog.md) for planned work:
171
- - MCP skill enhancements (web search, Playwright, Azure, Microsoft Learn)
172
- - Agent consistency review
173
- - Additional skills for API security and performance profiling
174
-
175
- ---
176
-
177
- *"That's the history. Now stop looking backward and let's build something."*
1
+ # Changelog
2
+
3
+ > *"Here's what changed. I don't repeat myself."*
4
+
5
+ All notable changes to Beth are documented here. Format based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
6
+
7
+ ---
8
+
9
+ ## [1.0.15] - 2026-02-19
10
+
11
+ ### Added
12
+ - **LLM Provider abstraction** — Azure OpenAI provider with Entra ID auth, streaming support, retry logic, and full TypeScript types
13
+ - **E2E test suite** — MCP validation, help command, init-to-doctor pipeline tests
14
+ - **485 tests passing** — Comprehensive unit and integration test coverage
15
+
16
+ ### Changed
17
+ - **Optional Azure dependencies** — `openai` and `@azure/identity` added as optionalDependencies so users only install them when needed
18
+ - **README rewritten** — Architecture diagrams, tech stack docs, CLI/MCP/A2A/provider documentation
19
+
20
+ ### Fixed
21
+ - **CodeQL security fixes** — Shell command built from environment values, incomplete URL substring sanitization
22
+ - **Package-lock sync** — package-lock.json synced with package.json
23
+
24
+ ---
25
+
26
+ ## [1.0.14] - 2026-02-04
27
+
28
+ ### Changed
29
+ - **User-friendly error messages** — CLI errors now display formatted boxes with clear problem descriptions, fix instructions, and the exact command to run. No more raw stack traces.
30
+
31
+ ---
32
+
33
+ ## [1.0.13] - 2026-02-04
34
+
35
+ ### Fixed
36
+ - **ENOTDIR crash during init** — Fixed `copyDirRecursive` crashing when destination path exists as a file instead of a directory. Now properly detects the conflict and provides a clear error message (or removes the file with `--force`).
37
+
38
+ ---
39
+
40
+ ## [Unreleased]
41
+
42
+ ### Added
43
+ - **CLI TypeScript foundation** — Migrated CLI to TypeScript with proper build system
44
+ - **Doctor command** `beth doctor` validates installation and configuration
45
+ - **Quickstart command** `beth quickstart` for guided setup
46
+ - **Agent schema types** — TypeScript types for agent definitions
47
+ - **Unit tests** — 86 tests passing for CLI commands and path validation
48
+ - **Architecture diagrams** — Interactive mermaid diagrams with zoom in README
49
+
50
+ ### Changed
51
+ - **DEMO.md** — Rewritten with Beth's personality and beads integration
52
+ - **P2 backlog completed** — Beth orchestrator references added to all agents, MCP skills updated, documentation fixes
53
+
54
+ ### Fixed
55
+ - Security-reviewer agent format — Removed obsolete `chatagent` wrapper to match standard YAML frontmatter format used by all other agents
56
+ - Removed unnecessary backlog.md CLI dependency
57
+ - Fixed security-reviewer.agent.md syntax errors
58
+ - Corrected agent/skill counts in help output
59
+ - Allowlisted security documentation examples in Gitleaks config
60
+
61
+ ### Documentation
62
+ - CLI Architecture guide (docs/CLI-ARCHITECTURE.md)
63
+ - CLI Implementation Plan (docs/CLI-IMPLEMENTATION-PLAN.md)
64
+
65
+ ---
66
+
67
+ ## [1.0.12] - 2026-02-01
68
+
69
+ ### Changed
70
+ - Added CHANGELOG.md to npm package
71
+
72
+ ---
73
+
74
+ ## [1.0.11] - 2026-02-01
75
+
76
+ ### Changed
77
+ - Reverted to fire animation for BETH banner (the way it should be)
78
+
79
+ ### Fixed
80
+ - SBOM regeneration for accurate dependency tracking
81
+
82
+ ---
83
+
84
+ ## [1.0.10] - 2026-01-31
85
+
86
+ ### Added
87
+ - **Path validation security** 33 tests covering traversal detection, injection prevention, and allowlist validation
88
+ - **Work tracking for all agents** — Every agent now uses the dual tracking system (beads for agents, Backlog.md for humans)
89
+ - **Cross-platform npm installation** — Consistent installation across macOS, Linux, and Windows
90
+
91
+ ### Security
92
+ - Path validation for user-supplied binary paths to prevent command injection
93
+ - Documented shell:true security constraints in SECURITY.md
94
+
95
+ ---
96
+
97
+ ## [1.0.6] - 2026-01-29
98
+
99
+ ### Added
100
+ - **Multi-agent coordination system** — Epic patterns with dependencies, parallel execution, and hierarchical issue tracking
101
+ - **Beads integration** — Structured work tracking with `bd` CLI for agent memory and coordination
102
+ - **Subagent templates** — Ready-to-use patterns for spawning specialists
103
+
104
+ ### Changed
105
+ - Beth instructions now include full orchestration workflows
106
+ - Updated SYSTEM-FLOW.md with multi-agent patterns
107
+
108
+ ---
109
+
110
+ ## [1.0.5] - 2026-01-28
111
+
112
+ ### Added
113
+ - Beads multi-agent coordination documentation
114
+
115
+ ---
116
+
117
+ ## [1.0.4] - 2026-01-27
118
+
119
+ ### Added
120
+ - **backlog.md CLI installation prompt** — Auto-prompts during init for human-readable tracking
121
+ - **.vscode/settings.json template** — Auto-configured agent settings for VS Code
122
+
123
+ ---
124
+
125
+ ## [1.0.3] - 2026-01-26
126
+
127
+ ### Added
128
+ - **Version check** — CLI warns users when a newer version is available
129
+
130
+ ---
131
+
132
+ ## [1.0.2] - 2026-01-25
133
+
134
+ ### Added
135
+ - **Security automation** — GitHub Actions workflow with npm audit, gitleaks, CodeQL, SBOM generation
136
+ - **Pre-commit hooks** — Secret scanning with gitleaks before commits
137
+ - **Subagent delegation settings** — Documentation for enabling autonomous agent coordination
138
+
139
+ ### Changed
140
+ - Clarified Product Manager vs UX Designer roles in documentation
141
+
142
+ ### Fixed
143
+ - Security hardening for enterprise production readiness
144
+
145
+ ---
146
+
147
+ ## [1.0.1] - 2026-01-24
148
+
149
+ ### Added
150
+ - **Security Reviewer agent** — OWASP Top 10, compliance audits, threat modeling
151
+ - **Security Analysis skill** — Vulnerability assessment workflows
152
+ - **MCP setup guide** — docs/MCP-SETUP.md with all optional servers
153
+ - **Installation guide** — docs/INSTALLATION.md with full setup instructions
154
+ - **Dependabot configuration** — Weekly npm/GH Actions updates with grouped PRs
155
+
156
+ ### Changed
157
+ - **Consolidated frontend-engineer into developer** — Developer now handles UI, full-stack, and shadcn-ui MCP integration
158
+ - Updated all agent handoffs to include security-reviewer
159
+
160
+ ### Security
161
+ - Full enterprise security review completed
162
+ - HIGH findings addressed
163
+ - SECURITY.md created with security policies
164
+
165
+ ---
166
+
167
+ ## [1.0.0] - 2026-01-23
168
+
169
+ ### Added
170
+ - **Beth orchestrator** The ruthless, hyper-competent AI coordinator
171
+ - **Six specialist agents** Product Manager, Researcher, UX Designer, Developer, Tester, (later Security Reviewer)
172
+ - **Five skills** — PRD generation, Framer components, Vercel React best practices, Web Design guidelines, shadcn-ui
173
+ - **npm package** `npx beth-copilot init` for one-command installation
174
+ - **IDEO Design Thinking workflow** — Empathize → Define → Ideate → Prototype → Test
175
+ - **Dual tracking system** — beads for agents, Backlog.md for humans
176
+ - **ASCII art animation** — Beth's entrance with fire effect banner
177
+
178
+ ### Architecture
179
+ - Agent definition format with YAML frontmatter
180
+ - Skills as domain-knowledge modules loaded on-demand
181
+ - Subagent vs handoff patterns for different control levels
182
+ - Hierarchical issue tracking for complex workflows
183
+
184
+ ---
185
+
186
+ ## What's Next
187
+
188
+ See [Backlog.md](Backlog.md) for planned work:
189
+ - MCP skill enhancements (web search, Playwright, Azure, Microsoft Learn)
190
+ - Agent consistency review
191
+ - Additional skills for API security and performance profiling
192
+
193
+ ---
194
+
195
+ *"That's the history. Now stop looking backward and let's build something."*