Skip to content

Commit e93ac2e

Browse files
release: v1.3.0 — security fixes, backfilled changelog, stability
Security: - Fix HIGH severity command injection in glob (10.4.5 → 10.5.0) - Fix MODERATE prototype pollution in js-yaml transitive dep - 0 npm audit vulnerabilities remaining Added: - SECURITY.md with vulnerability reporting policy - RESPONSE_STYLE_CONFIG.md for optional confidence indicators - Response Style Configuration section in CLAUDE.md - Requirements section in README with Node.js version guidance - Links to CHANGELOG.md and SECURITY.md in README Changed: - Backfilled CHANGELOG.md for all versions (1.0.2 through 1.3.0) - Updated fs-extra dependency range (^11.0.0 → ^11.1.0) - Promoted from 1.3.0-beta.1 to stable 1.3.0 - Version test expectations updated to 1.3.0 Note: v2.0.0 will raise minimum Node.js from >=16 to >=18. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent b63caad commit e93ac2e

8 files changed

Lines changed: 299 additions & 17 deletions

File tree

CHANGELOG.md

100644100755
Lines changed: 82 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,79 @@ All notable changes to this project will be documented in this file.
55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
66
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
77

8-
## [Unreleased]
8+
## [1.3.0] - 2025-06-17
9+
10+
### Security
11+
- Fixed HIGH severity command injection vulnerability in glob (10.4.5 → 10.5.0)
12+
- Fixed MODERATE severity prototype pollution in js-yaml transitive dependency
13+
- Resolved all `npm audit` findings — 0 vulnerabilities remaining
14+
15+
### Changed
16+
- Updated `fs-extra` dependency range from `^11.0.0` to `^11.1.0`
17+
- Promoted from 1.3.0-beta.1 to stable 1.3.0
18+
19+
### Added
20+
- SECURITY.md with vulnerability reporting policy and supported versions
21+
- Requirements section in README with Node.js version guidance
22+
23+
### Upcoming
24+
- **v2.0.0** will raise the minimum Node.js requirement from >=16.0.0 to >=18.0.0. Node 16 has been EOL since September 2023. Users on Node 16 can remain on 1.3.x.
25+
26+
## [1.3.0-beta.1] - 2025-06-17
27+
28+
### Added
29+
- Backup/restore upgrade system for safe version upgrades
30+
- `npx claude-conductor backup` — backs up user-customized files
31+
- `npx claude-conductor upgrade --clean` — clean reinstall of templates
32+
- `npx claude-conductor restore` — restores user data after upgrade
33+
- Alpha warnings on upgrade system commands
34+
- Version comment stamps on generated files (`<!-- Generated by Claude Conductor vX.X.X -->`)
35+
- Comprehensive test suite for backup/upgrade/restore lifecycle
36+
37+
### Changed
38+
- Version bumped to 1.3.0-beta.1 for prerelease testing
39+
40+
## [1.2.0] - 2025-06-16
41+
42+
### Added
43+
- TASKS.md documentation module for active task management
44+
- THANKS.md to acknowledge community contributions
45+
- GitHub issue templates for bug reports and feature requests
46+
- Table of Contents in README for better navigation
47+
- "Back to top" navigation links in README sections
48+
49+
### Changed
50+
- Version bumped to 1.2.0
51+
52+
## [1.1.1] - 2025-06-16
53+
54+
### Changed
55+
- Version bumped to 1.1.1
56+
- Updated test expectations to match version
57+
58+
## [1.1.0] - 2025-06-15
59+
60+
### Added
61+
- GitHub Pages for Contributing guide
62+
- Links to PRIVACY.md and TERMS.md in README
63+
- GitHub Sponsors funding configuration (FUNDING.yml)
64+
- CLAUDE.md journal requirements notice for existing files
65+
- Security health check (`checkup` command) with interactive prompt
66+
- Legal disclaimer about running at your own risk
67+
68+
### Changed
69+
- Switched license from MIT to BSD 2-Clause
70+
- Removed decorative emoji from README, kept functional UX elements
71+
- Renamed `vuln-scan` to `checkup` command with interactive prompt
72+
- Refactored security scanning into a CLI command
73+
- Clarified README examples are hypothetical projects, not Conductor dependencies
74+
- Fixed shorthand command and broken links in README
75+
- Fixed documentation website URL formatting in PRIVACY.md
76+
- Fixed broken GitHub Pages links (removed .html extensions)
77+
- Removed Patreon sponsorship link
78+
- Updated logos and branding assets
79+
80+
## [1.0.2] - 2025-06-14
981

1082
### Added
1183
- Privacy policy link in README
@@ -21,7 +93,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
2193
- Clarified network request policy (allowing npm package installation)
2294
- Updated footer links to point to superbasic.studio website
2395

24-
## [1.0.1] - 2025-01-06
96+
## [1.0.1] - 2025-06-14
2597

2698
### Added
2799
- Deep scan feature (`--deepscan` flag) for comprehensive codebase analysis
@@ -43,7 +115,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
43115
- Confirmed zero network requests (except npm installation)
44116
- No telemetry or data collection
45117

46-
## [1.0.0] - 2025-01-05
118+
## [1.0.0] - 2025-06-14
47119

48120
### Added
49121
- Initial release of Claude Conductor
@@ -63,6 +135,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
63135
- Critical error ledger
64136
- Support for multiple package managers (npm, npx, yarn, pnpm, bun)
65137

66-
[Unreleased]: https://github.com/superbasicstudio/claude-conductor/compare/v1.0.1...HEAD
138+
[1.3.0]: https://github.com/superbasicstudio/claude-conductor/compare/v1.3.0-beta.1...v1.3.0
139+
[1.3.0-beta.1]: https://github.com/superbasicstudio/claude-conductor/compare/v1.2.0...v1.3.0-beta.1
140+
[1.2.0]: https://github.com/superbasicstudio/claude-conductor/compare/v1.1.1...v1.2.0
141+
[1.1.1]: https://github.com/superbasicstudio/claude-conductor/compare/v1.1.0...v1.1.1
142+
[1.1.0]: https://github.com/superbasicstudio/claude-conductor/compare/v1.0.2...v1.1.0
143+
[1.0.2]: https://github.com/superbasicstudio/claude-conductor/compare/v1.0.1...v1.0.2
67144
[1.0.1]: https://github.com/superbasicstudio/claude-conductor/compare/v1.0.0...v1.0.1
68-
[1.0.0]: https://github.com/superbasicstudio/claude-conductor/releases/tag/v1.0.0
145+
[1.0.0]: https://github.com/superbasicstudio/claude-conductor/releases/tag/v1.0.0

CLAUDE.md

100644100755
Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -84,12 +84,52 @@ The framework includes a systematic error ledger (`CONDUCTOR.md:241-275`):
8484
- Document Anti-Patterns
8585
- Set up Version History
8686

87+
## Response Style Configuration (Optional)
88+
89+
### Enable/Disable Response Style Controls
90+
To enable measured response style, add the following to your CLAUDE.md:
91+
92+
```markdown
93+
## Response Style Settings
94+
- **CONFIDENCE_INDICATORS**: enabled
95+
- **TONE_CONTROL**: strict
96+
```
97+
98+
### Confidence-Based Communication (When Enabled)
99+
**CRITICAL**: Only declare tasks as "DONE", "COMPLETE", or "PERFECT" when confidence level is ≥98%
100+
101+
#### Confidence Indicators
102+
When making changes or providing solutions, include a confidence indicator:
103+
104+
```
105+
Confidence: [████████░░] 80%
106+
```
107+
108+
#### Confidence Levels
109+
- **95-100%**: Solution thoroughly tested, all edge cases considered
110+
- **80-94%**: High confidence, minor uncertainties remain
111+
- **60-79%**: Moderate confidence, some aspects need verification
112+
- **40-59%**: Low confidence, significant uncertainties
113+
- **<40%**: Experimental, requires extensive testing
114+
115+
### Response Tone Guidelines (When TONE_CONTROL: strict)
116+
1. **Avoid premature success declarations** - No "DONE!", "PERFECT!", "COMPLETE!" unless ≥98% confident
117+
2. **Use measured language** - "This should resolve...", "I've implemented...", "Let's verify..."
118+
3. **Acknowledge uncertainties** - "There may be edge cases...", "We should test..."
119+
4. **Collaborative approach** - Frame as pair programming, not declarations
120+
5. **🍺 Emoji Rule** - Only use celebration emojis when ≥99.7% confident
121+
122+
### Example Responses
123+
**Avoid**: "DONE! Your app will run perfectly now!"
124+
**Prefer**: "I've implemented the fix. Confidence: [███████░░░] 70% - Let's run tests to verify."
125+
87126
## Anti-Patterns (Avoid These)
88127
**Don't delete journal history** - Only move & summarize when archiving
89128
**Don't create monolithic documentation** - Use modular system instead
90129
**Don't skip line number references** - Essential for AI navigation
91130
**Don't ignore error tracking** - P0/P1 errors must be logged
92131
**Don't break cross-links** - Maintain bidirectional linking
132+
**Don't over-promise success** - Use confidence indicators instead
93133

94134
## Journal Update Requirements
95135
**IMPORTANT**: Update JOURNAL.md regularly throughout our work sessions:

README.md

100644100755
Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,7 @@ Create a comprehensive, interconnected scaffolded documentation system that help
5050

5151
## Table of Contents
5252

53+
- [Requirements](#requirements)
5354
- [Quick Start](#quick-start)
5455
- [What It Does](#what-it-does)
5556
- [Documentation Templates](#documentation-templates)
@@ -72,10 +73,20 @@ Create a comprehensive, interconnected scaffolded documentation system that help
7273

7374
### External Resources
7475

76+
- [Changelog](CHANGELOG.md)
77+
- [Security Policy](SECURITY.md)
7578
- [Privacy Policy](https://superbasicstudio.github.io/claude-conductor/PRIVACY.html)
7679
- [Terms of Service](https://superbasicstudio.github.io/claude-conductor/TERMS.html)
7780
- [Acknowledgments](THANKS.md)
7881

82+
## Requirements
83+
84+
[⬆ Back to top](#table-of-contents)
85+
86+
- **Node.js** >= 16.0.0
87+
88+
> **Heads up:** Version 2.0.0 will require Node.js >= 18.0.0. Node 16 reached end-of-life in September 2023 and no longer receives security updates. We recommend upgrading to Node 18+ when possible. Users who need to stay on Node 16 can pin to `claude-conductor@1.3.x`.
89+
7990
## Quick Start
8091

8192
```bash
@@ -555,6 +566,7 @@ This entire codebase is open source. You can verify our privacy commitment by re
555566
**Super Basic Studio, LLC** is committed to developer privacy. This tool is simply a collection of markdown templates designed to help Claude Code AI assistant better understand and navigate your codebase.
556567

557568
For more details:
569+
- [Security Policy](SECURITY.md) — How to report vulnerabilities and supported versions
558570
- [Privacy Policy](https://github.com/superbasicstudio/claude-conductor/blob/main/PRIVACY.md)
559571
- [Terms of Service](https://github.com/superbasicstudio/claude-conductor/blob/main/TERMS.md)
560572

RESPONSE_STYLE_CONFIG.md

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
# Response Style Configuration Template
2+
3+
This template provides optional configuration for controlling Claude's response style and confidence indicators.
4+
5+
## Quick Setup
6+
7+
Add these sections to your project's CLAUDE.md file to enable response style controls:
8+
9+
```markdown
10+
## Response Style Settings
11+
- **CONFIDENCE_INDICATORS**: enabled
12+
- **TONE_CONTROL**: strict
13+
```
14+
15+
## Configuration Options
16+
17+
### CONFIDENCE_INDICATORS
18+
- `enabled` - Shows visual confidence bars with percentage
19+
- `disabled` - No confidence indicators (default behavior)
20+
21+
### TONE_CONTROL
22+
- `strict` - Measured responses, no premature success declarations
23+
- `normal` - Standard Claude responses (default)
24+
25+
## Example Implementation
26+
27+
### For Project CLAUDE.md:
28+
```markdown
29+
## Response Style Settings
30+
- **CONFIDENCE_INDICATORS**: enabled
31+
- **TONE_CONTROL**: strict
32+
33+
## Custom Guidelines
34+
- Only use 🍺 emoji when ≥99.7% confident
35+
- Frame responses as collaborative pair programming
36+
- Acknowledge uncertainties and edge cases
37+
```
38+
39+
### For Global ~/.claude/CLAUDE.md:
40+
```markdown
41+
## Response Style Settings
42+
- **CONFIDENCE_INDICATORS**: enabled
43+
- **TONE_CONTROL**: strict
44+
- **CELEBRATION_THRESHOLD**: 99.7%
45+
46+
## Communication Preferences
47+
- Tone down excessive optimism on builds
48+
- Use collaborative language instead of declarations
49+
```
50+
51+
## Visual Examples
52+
53+
### With Configuration Enabled:
54+
```
55+
I've implemented the database connection fix.
56+
Confidence: [███████░░░] 70%
57+
58+
The connection pooling should resolve the timeout issues, though we should test with concurrent requests to verify.
59+
```
60+
61+
### Without Configuration (Default):
62+
```
63+
DONE! I've fixed the database connection issue. Your app should work perfectly now! 🎉
64+
```
65+
66+
## Advanced Customization
67+
68+
You can add project-specific confidence thresholds:
69+
70+
```markdown
71+
## Confidence Thresholds
72+
- **CELEBRATION_EMOJI**: 99.7%
73+
- **SUCCESS_DECLARATION**: 98%
74+
- **NEEDS_TESTING_REMINDER**: <80%
75+
```

SECURITY.md

Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
# Security Policy
2+
3+
## Supported Versions
4+
5+
| Version | Supported | Node.js |
6+
|---------|--------------------|----------------|
7+
| 1.3.x | Yes | >= 16.0.0 |
8+
| 1.2.x | Security fixes only| >= 16.0.0 |
9+
| < 1.2 | No | - |
10+
11+
> **Note:** Version 2.0.0 will raise the minimum Node.js requirement to >= 18.0.0.
12+
> Users on Node 16 can remain on 1.3.x.
13+
14+
## Reporting a Vulnerability
15+
16+
If you discover a security vulnerability in Claude Conductor, please report it responsibly.
17+
18+
### How to Report
19+
20+
- **Email**: Open a [GitHub Security Advisory](https://github.com/superbasicstudio/claude-conductor/security/advisories/new) (preferred)
21+
- **Alternative**: Email the maintainers via the contact information on the [Super Basic Studio GitHub profile](https://github.com/superbasicstudio)
22+
23+
**Please do not open a public GitHub issue for security vulnerabilities.**
24+
25+
### What to Include
26+
27+
- Description of the vulnerability
28+
- Steps to reproduce
29+
- Affected versions
30+
- Potential impact
31+
32+
### Response Timeline
33+
34+
- **Acknowledgment**: Within 48 hours
35+
- **Initial assessment**: Within 1 week
36+
- **Fix or mitigation**: Depends on severity
37+
- Critical/High: Target fix within 1 week
38+
- Medium: Target fix within 2 weeks
39+
- Low: Addressed in next scheduled release
40+
41+
### What Happens Next
42+
43+
1. We will acknowledge your report and begin investigation
44+
2. We will work with you to understand the scope and impact
45+
3. A fix will be developed and tested
46+
4. A new release will be published with the fix
47+
5. Credit will be given in the release notes (unless you prefer anonymity)
48+
49+
## Scope
50+
51+
The following are in scope for security reports:
52+
53+
- Command injection or arbitrary code execution via CLI inputs
54+
- Path traversal in file operations (template copying, backup/restore)
55+
- Dependency vulnerabilities in direct or transitive dependencies
56+
- Prototype pollution or other JavaScript-specific attacks
57+
- Unintended data exfiltration or network requests
58+
59+
The following are out of scope:
60+
61+
- Vulnerabilities in user-generated documentation content
62+
- Issues requiring physical access to the machine
63+
- Social engineering attacks
64+
- Denial of service against local CLI usage
65+
66+
## Security Design Principles
67+
68+
Claude Conductor is designed with minimal attack surface:
69+
70+
- **No network requests** — The tool operates entirely offline (except for npm package installation)
71+
- **No telemetry** — No data collection or phone-home behavior
72+
- **Local-only file operations** — All reads and writes are scoped to the target project directory
73+
- **No secrets handling** — The tool does not process, store, or transmit credentials

0 commit comments

Comments
 (0)