lean-spec 0.1.4 → 0.2.0

package/CHANGELOG.md

@@ -7,6 +7,113 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.0] - 2025-11-10
+
+**🎉 Official Public Release - Production Ready**
+
+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.
+
+### Highlights
+
+**First Principles Foundation:**
+- Operationalized five first principles with validation tooling
+- Context Economy enforced: Specs under 300 lines, warnings at 400+
+- Signal-to-Noise validation: Every line must inform decisions
+- Complete philosophy documentation guiding methodology
+
+**Quality & Validation:**
+- Comprehensive `lean-spec validate` with complexity analysis
+- Lint-style output format matching ESLint/TypeScript conventions
+- Sub-spec validation and relationship checking
+- Dogfooding complete: All specs follow our own principles
+
+**Documentation Excellence:**
+- 100% accurate documentation site (verified)
+- AI-assisted spec writing guide
+- Clear WHY vs HOW separation in docs
+- Comprehensive migration guides from ADRs/RFCs
+- First principles deeply documented
+
+**Developer Experience:**
+- Unified dashboard (board + stats + health metrics)
+- Pattern-aware list grouping with visual clarity
+- Improved init flow with pattern selection
+- MCP server stability improvements
+- Better error handling throughout
+
+### Added
+
+**New Commands:**
+- `lean-spec migrate` - Migrate from existing tools (ADRs, RFCs, design docs)
+- `lean-spec archive` - Archive completed specs with metadata updates
+- `lean-spec backfill` - Backfill timestamps from git history
+- `lean-spec validate` - Comprehensive spec validation
+
+**Core Features:**
+- First principles validation (Context Economy, Signal-to-Noise, etc.)
+- Complexity analysis for specs and sub-specs
+- Bidirectional `related` and directional `depends_on` relationships
+- Sub-spec file support with validation
+- Pattern-based folder organization
+
+### Changed
+
+**Breaking Changes:**
+- `lean-spec validate` output format now matches lint tools (ESLint-style)
+- Default validation mode is quiet success (use `--verbose` for all details)
+
+**User Experience:**
+- Unified dashboard combining board + stats + health summary
+- Pattern-aware list with visual icons and better grouping
+- Enhanced init flow with template/pattern selection
+- Clearer stats dashboard with actionable insights
+
+### Fixed
+- MCP server error handling and stability
+- Documentation accuracy across all pages
+- Test suite: 402/402 passing (100%)
+- TypeScript/lint: Zero errors
+- Frontmatter parsing edge cases
+
+### Philosophy & Methodology
+
+This release operationalizes LeanSpec's five first principles:
+
+1. **Context Economy** - Fit in working memory (<300 lines target, 400 max)
+2. **Signal-to-Noise Maximization** - Every word informs decisions
+3. **Intent Over Implementation** - Capture why, not just how
+4. **Bridge the Gap** - Both human and AI understand
+5. **Progressive Disclosure** - Add complexity only when pain is felt
+
+**Practice What We Preach:**
+- All specs validated against principles
+- Large specs split using sub-spec pattern
+- Documentation follows progressive disclosure
+- Validation tooling prevents principle violations
+
+### Migration Notes
+
+**From v0.1.x:**
+- Run `lean-spec validate` to check your specs
+- Review any specs >400 lines and consider splitting
+- Update to new validate output format (ESLint-style)
+- No breaking changes to commands or file formats
+
+**From other tools:**
+- Use `lean-spec migrate` for ADRs, RFCs, design docs
+- See documentation for detailed migration guides
+- AI-assisted migration available (Claude, Copilot)
+
+### Acknowledgments
+
+Built with dogfooding: 63 specs written, 28 archived, all following our own principles.
+
+## [0.1.5] - 2025-11-10
+
+### Fixed
+- MCP server version now also read dynamically from package.json
+- Complete version consistency across CLI and MCP server
+
 ## [0.1.4] - 2025-11-10
 
 ### Fixed
@@ -211,6 +318,7 @@ This UAT release operationalizes LeanSpec's five first principles:
 - Gray-matter for frontmatter parsing
 - Dayjs for date handling
 
+[0.1.5]: https://github.com/codervisor/lean-spec/releases/tag/v0.1.5
 [0.1.4]: https://github.com/codervisor/lean-spec/releases/tag/v0.1.4
 [0.1.3]: https://github.com/codervisor/lean-spec/releases/tag/v0.1.3
 [0.1.2]: https://github.com/codervisor/lean-spec/releases/tag/v0.1.2

package/dist/{chunk-S6TGAL75.js → chunk-J7ZSZ5VJ.js}

@@ -459,8 +459,8 @@ async function getProjectName(cwd = process.cwd()) {
   try {
     const packageJsonPath = path4.join(cwd, "package.json");
     const content = await fs4.readFile(packageJsonPath, "utf-8");
-    const packageJson = JSON.parse(content);
-    return packageJson.name || null;
+    const packageJson2 = JSON.parse(content);
+    return packageJson2.name || null;
   } catch {
     return null;
   }
@@ -4710,6 +4710,14 @@ async function mcpCommand() {
 }
 
 // src/mcp-server.ts
+import { readFileSync } from "fs";
+import { fileURLToPath as fileURLToPath2 } from "url";
+import { dirname as dirname3, join as join18 } from "path";
+var __filename2 = fileURLToPath2(import.meta.url);
+var __dirname3 = dirname3(__filename2);
+var packageJson = JSON.parse(
+  readFileSync(join18(__dirname3, "../package.json"), "utf-8")
+);
 function formatErrorMessage(prefix, error) {
   const errorMsg = error instanceof Error ? error.message : String(error);
   return `${prefix}: ${errorMsg}`;
@@ -4861,7 +4869,7 @@ async function getDepsData(specPath) {
 async function createMcpServer() {
   const server = new McpServer({
     name: "lean-spec",
-    version: "0.1.0"
+    version: packageJson.version
   });
   server.registerTool(
     "list",
@@ -5645,4 +5653,4 @@ export {
   createMcpServer,
   mcpCommand
 };
-//# sourceMappingURL=chunk-S6TGAL75.js.map
+//# sourceMappingURL=chunk-J7ZSZ5VJ.js.map