lean-spec 0.1.5 → 0.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/CHANGELOG.md +101 -0
- package/package.json +2 -2
package/CHANGELOG.md
CHANGED
|
@@ -7,6 +7,107 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
7
7
|
|
|
8
8
|
## [Unreleased]
|
|
9
9
|
|
|
10
|
+
## [0.2.0] - 2025-11-10
|
|
11
|
+
|
|
12
|
+
**🎉 Official Public Release - Production Ready**
|
|
13
|
+
|
|
14
|
+
This is the official v0.2.0 release, treating v0.1.x as alpha versions. LeanSpec is now production-ready for teams and solo developers.
|
|
15
|
+
|
|
16
|
+
### Highlights
|
|
17
|
+
|
|
18
|
+
**First Principles Foundation:**
|
|
19
|
+
- Operationalized five first principles with validation tooling
|
|
20
|
+
- Context Economy enforced: Specs under 300 lines, warnings at 400+
|
|
21
|
+
- Signal-to-Noise validation: Every line must inform decisions
|
|
22
|
+
- Complete philosophy documentation guiding methodology
|
|
23
|
+
|
|
24
|
+
**Quality & Validation:**
|
|
25
|
+
- Comprehensive `lean-spec validate` with complexity analysis
|
|
26
|
+
- Lint-style output format matching ESLint/TypeScript conventions
|
|
27
|
+
- Sub-spec validation and relationship checking
|
|
28
|
+
- Dogfooding complete: All specs follow our own principles
|
|
29
|
+
|
|
30
|
+
**Documentation Excellence:**
|
|
31
|
+
- 100% accurate documentation site (verified)
|
|
32
|
+
- AI-assisted spec writing guide
|
|
33
|
+
- Clear WHY vs HOW separation in docs
|
|
34
|
+
- Comprehensive migration guides from ADRs/RFCs
|
|
35
|
+
- First principles deeply documented
|
|
36
|
+
|
|
37
|
+
**Developer Experience:**
|
|
38
|
+
- Unified dashboard (board + stats + health metrics)
|
|
39
|
+
- Pattern-aware list grouping with visual clarity
|
|
40
|
+
- Improved init flow with pattern selection
|
|
41
|
+
- MCP server stability improvements
|
|
42
|
+
- Better error handling throughout
|
|
43
|
+
|
|
44
|
+
### Added
|
|
45
|
+
|
|
46
|
+
**New Commands:**
|
|
47
|
+
- `lean-spec migrate` - Migrate from existing tools (ADRs, RFCs, design docs)
|
|
48
|
+
- `lean-spec archive` - Archive completed specs with metadata updates
|
|
49
|
+
- `lean-spec backfill` - Backfill timestamps from git history
|
|
50
|
+
- `lean-spec validate` - Comprehensive spec validation
|
|
51
|
+
|
|
52
|
+
**Core Features:**
|
|
53
|
+
- First principles validation (Context Economy, Signal-to-Noise, etc.)
|
|
54
|
+
- Complexity analysis for specs and sub-specs
|
|
55
|
+
- Bidirectional `related` and directional `depends_on` relationships
|
|
56
|
+
- Sub-spec file support with validation
|
|
57
|
+
- Pattern-based folder organization
|
|
58
|
+
|
|
59
|
+
### Changed
|
|
60
|
+
|
|
61
|
+
**Breaking Changes:**
|
|
62
|
+
- `lean-spec validate` output format now matches lint tools (ESLint-style)
|
|
63
|
+
- Default validation mode is quiet success (use `--verbose` for all details)
|
|
64
|
+
|
|
65
|
+
**User Experience:**
|
|
66
|
+
- Unified dashboard combining board + stats + health summary
|
|
67
|
+
- Pattern-aware list with visual icons and better grouping
|
|
68
|
+
- Enhanced init flow with template/pattern selection
|
|
69
|
+
- Clearer stats dashboard with actionable insights
|
|
70
|
+
|
|
71
|
+
### Fixed
|
|
72
|
+
- MCP server error handling and stability
|
|
73
|
+
- Documentation accuracy across all pages
|
|
74
|
+
- Test suite: 402/402 passing (100%)
|
|
75
|
+
- TypeScript/lint: Zero errors
|
|
76
|
+
- Frontmatter parsing edge cases
|
|
77
|
+
|
|
78
|
+
### Philosophy & Methodology
|
|
79
|
+
|
|
80
|
+
This release operationalizes LeanSpec's five first principles:
|
|
81
|
+
|
|
82
|
+
1. **Context Economy** - Fit in working memory (<300 lines target, 400 max)
|
|
83
|
+
2. **Signal-to-Noise Maximization** - Every word informs decisions
|
|
84
|
+
3. **Intent Over Implementation** - Capture why, not just how
|
|
85
|
+
4. **Bridge the Gap** - Both human and AI understand
|
|
86
|
+
5. **Progressive Disclosure** - Add complexity only when pain is felt
|
|
87
|
+
|
|
88
|
+
**Practice What We Preach:**
|
|
89
|
+
- All specs validated against principles
|
|
90
|
+
- Large specs split using sub-spec pattern
|
|
91
|
+
- Documentation follows progressive disclosure
|
|
92
|
+
- Validation tooling prevents principle violations
|
|
93
|
+
|
|
94
|
+
### Migration Notes
|
|
95
|
+
|
|
96
|
+
**From v0.1.x:**
|
|
97
|
+
- Run `lean-spec validate` to check your specs
|
|
98
|
+
- Review any specs >400 lines and consider splitting
|
|
99
|
+
- Update to new validate output format (ESLint-style)
|
|
100
|
+
- No breaking changes to commands or file formats
|
|
101
|
+
|
|
102
|
+
**From other tools:**
|
|
103
|
+
- Use `lean-spec migrate` for ADRs, RFCs, design docs
|
|
104
|
+
- See documentation for detailed migration guides
|
|
105
|
+
- AI-assisted migration available (Claude, Copilot)
|
|
106
|
+
|
|
107
|
+
### Acknowledgments
|
|
108
|
+
|
|
109
|
+
Built with dogfooding: 63 specs written, 28 archived, all following our own principles.
|
|
110
|
+
|
|
10
111
|
## [0.1.5] - 2025-11-10
|
|
11
112
|
|
|
12
113
|
### Fixed
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "lean-spec",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0",
|
|
4
4
|
"description": "Lightweight spec methodology for AI-powered development",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -27,7 +27,7 @@
|
|
|
27
27
|
"agent",
|
|
28
28
|
"sdd"
|
|
29
29
|
],
|
|
30
|
-
"author": "
|
|
30
|
+
"author": "Marvin Zhang",
|
|
31
31
|
"license": "MIT",
|
|
32
32
|
"repository": {
|
|
33
33
|
"type": "git",
|