@ipation/specbridge 1.0.1 → 1.0.3

package/CHANGELOG.md

@@ -7,6 +7,147 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.0.3] - 2026-01-30
+
+### Improved
+
+#### Test Coverage - Major Achievement 🎉
+- **Overall coverage**: 67.37% → **94.07%** (+26.7% improvement, +39.6% total increase from v1.0.1)
+- **Functions coverage**: 78.21% → **96.99%** (+18.78%, now at 97%)
+- **Branches coverage**: 81.95% → **93.93%** (+11.98%, exceeds 87% target)
+- **Statements coverage**: 67.37% → **94.07%** (+26.7%, exceeds 83% target)
+- **Total tests**: 312 → **762** (+450 tests, +144% growth)
+
+**All coverage targets exceeded by 7-14 percentage points!**
+
+#### Sprint 1: Foundation Components (New Tests)
+- **Scanner Tests** - Added `scanner.test.ts`: 580 lines, 48 tests
+  - Coverage: 0% → **99.38%** (was completely untested)
+  - Tests all 8 public methods with comprehensive edge cases
+  - Handles malformed files, nested structures, large file sets
+
+- **Propagation Graph Tests** - Added `graph.test.ts`: 480 lines, 34 tests
+  - Coverage: 0% → **100%** (was completely untested)
+  - Tests dependency graph building, transitive dependencies
+  - Edge cases: cycles, empty graphs, overlapping scopes
+
+- **Core Error Classes Tests** - Added `errors.test.ts`: 400 lines
+  - All 11 error classes comprehensively tested
+  - formatError() function validated with edge cases
+  - Error inheritance chain and special character handling
+
+- **Verification Engine** - Extended `engine.test.ts`: +280 lines
+  - Added timeout handling, severity filtering, exception lifecycle
+  - Edge cases: empty sourceRoots, concurrent calls, malformed files
+  - Coverage improved with comprehensive scenario testing
+
+- **Registry** - Extended `registry.test.ts`: +290 lines
+  - Filter combinations (status+tags, constraintType+severity)
+  - Additional methods: has(), getIds(), getByOwner(), getByTag()
+  - Coverage: **100%** (maintained and enhanced)
+
+- **Reporter** - Extended `reporter.test.ts`: +320 lines
+  - formatAsTableGrouped(), formatAsMarkdown() comprehensive tests
+  - checkDegradation() function fully tested
+  - generateComplianceReport() edge cases covered
+
+#### Sprint 2: Partial Coverage Improvements
+- **Agent Context Generator** - Extended `context.generator.test.ts`: +400 lines, 42 total tests
+  - Coverage: 43.52% → **98.96%** (+55.44%, highest improvement)
+  - Standalone functions fully tested: generateContext, formatContextAsMarkdown, formatContextAsJson, formatContextAsMcp
+  - Format conversion validation (markdown/JSON/MCP)
+  - Rationale inclusion/exclusion scenarios
+
+- **Propagation Engine** - Extended `engine.test.ts`: +200 lines, 29 total tests
+  - Coverage: 62.5% → **76.92%** (+14.42%)
+  - Migration step generation and prioritization tested
+  - Effort estimation with various scenarios
+  - Auto-fix detection and affected files handling
+
+- **Registry Loader** - Extended `loader.test.ts`: +200 lines, 11 new tests
+  - Coverage: 67.21% → **100%** (+32.79%)
+  - validateDecisionFile() function completely tested
+  - Schema validation, corrupted file handling
+  - All error scenarios validated
+
+#### Components at Perfect Coverage (100%)
+- ✅ Registry (100%)
+- ✅ Registry Loader (100%)
+- ✅ Propagation Graph (100%)
+- ✅ Analyzers (100%)
+- ✅ Config Schemas (100%)
+- ✅ Utils (100%)
+
+#### Components at Excellent Coverage (95-99%)
+- ✅ Agent Context Generator (98.96%)
+- ✅ Scanner (99.38%)
+- ✅ Verifiers (99.72%)
+- ✅ Functions (96.99%)
+
+#### Quality Metrics
+- ✅ **762 tests passing** (100% pass rate, +450 tests)
+- ✅ **94.07% test coverage** (exceeds all thresholds)
+- ✅ **No type errors**
+- ✅ **Build succeeds**
+- ✅ **Test-to-source ratio**: ~1.7:1
+- ✅ **Production-ready quality**
+
+### Changed
+- Updated coverage thresholds in `vitest.config.ts`:
+  - Lines: 67% → **83%**
+  - Functions: 78% → **83%**
+  - Branches: 78% → **87%**
+  - Statements: 67% → **83%**
+
+### Added
+- Comprehensive test helpers and fixtures for easier test creation
+- Integration test scenarios for multi-command workflows
+- Edge case testing for all critical components
+
+## [1.0.2] - 2026-01-29
+
+### Improved
+
+#### Test Coverage
+- **Overall coverage**: 54.34% → **67.37%** (+24% improvement)
+- **Functions coverage**: 74.43% → **78.21%** (+5.08%)
+- **Branches coverage**: 71.07% → **81.95%** (+15.3%)
+- **Total tests**: 170 → **312** (+142 tests, +83.5% growth)
+
+#### Verification Verifiers (Critical)
+- **Module coverage**: 15.98% → **99.72%** 🎉
+- Added `naming.test.ts` - 27 tests, 0% → 100% coverage
+- Added `imports.test.ts` - 27 tests, 5.95% → 100% coverage
+- Added `errors.test.ts` - 31 tests, 4.8% → 99.03% coverage
+- Added `regex.test.ts` - 27 tests, 36.84% → 100% coverage
+
+#### Inference Analyzers
+- Added `base.test.ts` - 30 tests, 10% → 100% coverage
+- Tests for `createPattern()`, `calculateConfidence()`, `extractSnippet()` helpers
+
+#### Quality Metrics
+- ✅ **312 tests passing** (100% pass rate)
+- ✅ **67.37% test coverage** (exceeds 67% threshold)
+- ✅ **No type errors**
+- ✅ **Build succeeds**
+- ✅ **Pre-commit hooks pass**
+
+### Changed
+- Updated coverage thresholds in `vitest.config.ts`:
+  - Lines: 54% → 67%
+  - Functions: 65% → 78%
+  - Branches: 65% → 78%
+  - Statements: 54% → 67%
+
+## [1.0.1] - 2026-01-29
+
+### Fixed
+- Address 5 critical issues in v1.0.0 codebase
+- Self-dogfooding implementation
+
+### Added
+- Applied SpecBridge to itself for validation
+
 ## [1.0.0] - 2026-01-29
 
 ### 🎉 First Stable Release

package/README.md

@@ -3,7 +3,7 @@
 [![CI](https://github.com/nouatzi/specbridge/workflows/CI/badge.svg)](https://github.com/nouatzi/specbridge/actions)
 [![npm version](https://badge.fury.io/js/%40ipation%2Fspecbridge.svg)](https://www.npmjs.com/package/@ipation/specbridge)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Node.js Version](https://img.shields.io/node/v/%40nouatzi%2Fspecbridge)](https://nodejs.org)
+[![Node.js Version](https://img.shields.io/node/v/%40ipation%2Fspecbridge)](https://nodejs.org)
 
 **Architecture Decision Runtime** - Transform architectural decisions into executable, verifiable constraints.
 
@@ -100,6 +100,18 @@ specbridge context src/api/auth.ts
 
 Generates architectural context in Markdown format for AI code assistants.
 
+## Dogfooding
+
+SpecBridge uses itself to enforce its own architectural decisions! We verify:
+
+- ✅ Error handling patterns (all errors extend SpecBridgeError)
+- ✅ ESM import conventions (.js extensions required)
+- ✅ Naming conventions (PascalCase/camelCase)
+- ✅ TypeScript strict mode settings
+- ✅ Domain-driven module structure
+
+See our [Dogfooding Guide](docs/dogfooding-guide.md) to learn how we use SpecBridge on itself, or explore our decision files in `.specbridge/decisions/` as real-world examples.
+
 ## Decision File Format
 
 Decisions are stored as YAML files in `.specbridge/decisions/`:

package/dist/cli.js

@@ -1005,9 +1005,7 @@ var ErrorsAnalyzer = class {
     );
     if (errorClasses.length < 2) return null;
     const files = scanner.getFiles();
-    let extendsError = 0;
-    let extendsCustomBase = 0;
-    let customBaseName = null;
+    const baseCount = /* @__PURE__ */ new Map();
     for (const errorClass of errorClasses) {
       const file = files.find((f) => f.path === errorClass.file);
       if (!file) continue;
@@ -1016,22 +1014,27 @@ var ErrorsAnalyzer = class {
       const extendClause = classDecl.getExtends();
       if (extendClause) {
         const baseName = extendClause.getText();
-        if (baseName === "Error") {
-          extendsError++;
-        } else if (baseName.endsWith("Error")) {
-          extendsCustomBase++;
-          customBaseName = customBaseName || baseName;
+        if (baseName !== "Error" && baseName.endsWith("Error")) {
+          baseCount.set(baseName, (baseCount.get(baseName) || 0) + 1);
         }
       }
     }
-    if (extendsCustomBase >= 2 && customBaseName) {
-      const confidence = calculateConfidence(extendsCustomBase, errorClasses.length);
+    let customBaseName = null;
+    let maxCount = 0;
+    for (const [baseName, count] of baseCount.entries()) {
+      if (count > maxCount) {
+        maxCount = count;
+        customBaseName = baseName;
+      }
+    }
+    if (maxCount >= 3 && customBaseName) {
+      const confidence = calculateConfidence(maxCount, errorClasses.length);
       return createPattern(this.id, {
         id: "errors-custom-base",
         name: "Custom Error Base Class",
         description: `Custom errors extend a common base class (${customBaseName})`,
         confidence,
-        occurrences: extendsCustomBase,
+        occurrences: maxCount,
         examples: errorClasses.slice(0, 3).map((c) => ({
           file: c.file,
           line: c.line,
@@ -1113,10 +1116,11 @@ var ErrorsAnalyzer = class {
             } else if (text.startsWith("new ") && text.includes("Error")) {
               throwCustom++;
               if (examples.length < 3) {
+                const snippet = text.length > 50 ? text.slice(0, 50) + "..." : text;
                 examples.push({
                   file: path,
                   line: node.getStartLineNumber(),
-                  snippet: `throw ${text.slice(0, 50)}${text.length > 50 ? "..." : ""}`
+                  snippet: `throw ${snippet}`
                 });
               }
             }