elspais 0.9.3__tar.gz → 0.11.1__tar.gz

{elspais-0.9.3 → elspais-0.11.1}/CHANGELOG.md

@@ -7,6 +7,86 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.11.1] - 2026-01-15
+
+### Changed
+- Improved CLI `--help` output with examples, subcommand hints, and clearer descriptions
+
+## [0.11.0] - 2026-01-15
+
+### Added
+- **Cross-repo hierarchy support** for `reformat-with-claude` command
+  - Resolves parent requirements from associated/sponsor repositories
+  - New `--core-repo` flag to specify core repository path
+  - Builds complete hierarchy graph across repository boundaries
+
+### Changed
+- **Performance optimization** for reformat command: Uses validation to filter requirements before reformatting instead of processing all files
+- Reformat module now uses core modules directly for consistent behavior
+
+### Fixed
+- Hash update robustness improved with better error handling and INFO logging
+- `normalize_req_id()` now uses config-based `PatternValidator` for consistent ID normalization
+- Associated prefix case is now preserved in normalized requirement IDs
+
+## [0.10.0] - 2026-01-10
+
+### Added
+- **trace-view integration**: Enhanced traceability visualization with optional dependencies
+  - Interactive HTML generation with Jinja2 templates (`elspais[trace-view]`)
+  - Collaborative review server with Flask REST API (`elspais[trace-review]`)
+  - New CLI flags: `--view`, `--embed-content`, `--edit-mode`, `--review-mode`, `--server`, `--port`
+- **New `trace_view` package** (`src/elspais/trace_view/`)
+  - `TraceViewRequirement` adapter wrapping core `Requirement` model
+  - Coverage calculation and orphan detection
+  - Implementation file scanning
+  - Generators for HTML, Markdown, and CSV output
+- **Review system** for collaborative requirement feedback
+  - Comment threads with nested replies
+  - Review flags and status change requests
+  - Git branch management for review workflows
+  - JSON-based persistence in `.elspais/reviews/`
+- **AI-assisted requirement reformatting** with `reformat-with-claude` command
+  - Transforms legacy "Acceptance Criteria" format to assertion-based format
+  - Format detection and validation
+  - Line break normalization
+  - Claude CLI integration with structured JSON output
+- **New `reformat` module** (`src/elspais/reformat/`)
+  - `detect_format()`, `needs_reformatting()` - format analysis
+  - `reformat_requirement()`, `assemble_new_format()` - AI transformation
+  - `normalize_line_breaks()`, `fix_requirement_line_breaks()` - cleanup
+  - `RequirementNode`, `build_hierarchy()` - requirement traversal
+- New optional dependency extras in pyproject.toml:
+  - `elspais[trace-view]`: jinja2 for HTML generation
+  - `elspais[trace-review]`: flask, flask-cors for review server
+  - `elspais[all]`: all optional features
+- New documentation: `docs/trace-view.md` user guide
+- 18 new integration tests for trace-view features
+
+### Changed
+- `elspais trace` command now delegates to trace-view when enhanced features requested
+- CLAUDE.md updated with trace-view architecture documentation
+
+## [0.9.4] - 2026-01-08
+
+### Added
+- **Roadmap conflict entries**: When duplicate requirement IDs exist (e.g., same ID in spec/ and spec/roadmap/), both requirements are now visible in output
+  - Duplicate entries stored with `__conflict` suffix key (e.g., `REQ-p00001__conflict`)
+  - New `is_conflict` and `conflict_with` fields on Requirement model
+  - Conflict entries treated as orphaned (`implements=[]`) for clear visibility
+  - Warning generated for each duplicate (surfaced as `id.duplicate` rule)
+- **Sponsor/associated repository spec scanning**: New `--mode` flag and sponsor configuration support
+  - `elspais validate --mode core`: Scan only core spec directories
+  - `elspais validate --mode combined`: Include sponsor specs (default)
+  - New `sponsors` module with zero-dependency YAML parser
+  - Configuration via `.github/config/sponsors.yml` with local override support
+  - `traceability.include_associated` config option (default: true)
+- 29 new tests for conflict entries and sponsor scanning
+
+### Changed
+- Parser now keeps both requirements when duplicates found (instead of ignoring second)
+- JSON output includes conflict metadata for both original and conflict entries
+
 ## [0.9.3] - 2026-01-05
 
 ### Added

{elspais-0.9.3 → elspais-0.11.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: elspais
-Version: 0.9.3
+Version: 0.11.1
 Summary: Requirements validation and traceability tools - L-Space connects all libraries
 Project-URL: Homepage, https://github.com/anspar/elspais
 Project-URL: Documentation, https://github.com/anspar/elspais#readme
@@ -24,6 +24,11 @@ Classifier: Topic :: Software Development :: Documentation
 Classifier: Topic :: Software Development :: Quality Assurance
 Classifier: Typing :: Typed
 Requires-Python: >=3.9
+Provides-Extra: all
+Requires-Dist: flask-cors>=4.0; extra == 'all'
+Requires-Dist: flask>=2.0; extra == 'all'
+Requires-Dist: jinja2>=3.0; extra == 'all'
+Requires-Dist: mcp>=1.0; extra == 'all'
 Provides-Extra: binary
 Requires-Dist: pyinstaller>=6.0; extra == 'binary'
 Provides-Extra: dev
@@ -34,6 +39,12 @@ Requires-Dist: pytest>=7.0; extra == 'dev'
 Requires-Dist: ruff>=0.1.0; extra == 'dev'
 Provides-Extra: mcp
 Requires-Dist: mcp>=1.0; extra == 'mcp'
+Provides-Extra: trace-review
+Requires-Dist: flask-cors>=4.0; extra == 'trace-review'
+Requires-Dist: flask>=2.0; extra == 'trace-review'
+Requires-Dist: jinja2>=3.0; extra == 'trace-review'
+Provides-Extra: trace-view
+Requires-Dist: jinja2>=3.0; extra == 'trace-view'
 Description-Content-Type: text/markdown
 
 # elspais
@@ -59,11 +70,11 @@ Description-Content-Type: text/markdown
 ### For End Users
 
 ```bash
-# Standard installation
-pip install elspais
-
-# Recommended for CLI tools: Isolated installation
+# Recommended: Isolated installation with pipx
 pipx install elspais
+
+# Or standard pip installation
+pip install elspais
 ```
 
 ### For Development
@@ -86,7 +97,7 @@ FROM python:3.11-slim
 COPY --from=ghcr.io/astral-sh/uv:latest /uv /usr/local/bin/uv
 
 # Install elspais (10-100x faster than pip)
-RUN uv pip install --system --no-cache elspais==0.9.1
+RUN uv pip install --system --no-cache elspais==0.9.3
 ```
 
 ```yaml
@@ -95,7 +106,7 @@ RUN uv pip install --system --no-cache elspais==0.9.1
   uses: astral-sh/setup-uv@v2
 
 - name: Install elspais
-  run: uv pip install --system elspais==0.9.1
+  run: uv pip install --system elspais==0.9.3
 ```
 
 **Note:** For regulated/medical software projects, always pin the exact version for reproducibility.
@@ -365,19 +376,23 @@ Options:
   --help           Show help
 
 Commands:
-  validate   Validate requirements format, links, hashes
-  trace      Generate traceability matrix
-  hash       Manage requirement hashes (verify, update)
-  index      Validate or regenerate INDEX.md
-  analyze    Analyze requirement hierarchy
-  edit       Edit requirements in-place (status, implements, move)
-  config     View and modify configuration
-  rules      View and manage content rules
-  mcp        MCP server commands (requires elspais[mcp])
-  version    Show version and check for updates
-  init       Create .elspais.toml configuration
+  validate              Validate requirements format, links, and hashes
+  trace                 Generate traceability matrix
+  hash                  Manage requirement hashes (verify, update)
+  index                 Manage INDEX.md file (validate, regenerate)
+  analyze               Analyze requirement hierarchy (hierarchy, orphans, coverage)
+  changed               Detect git changes to spec files
+  version               Show version and check for updates
+  init                  Create .elspais.toml configuration
+  edit                  Edit requirements in-place (implements, status, move)
+  config                View and modify configuration (show, get, set, ...)
+  rules                 View and manage content rules (list, show)
+  reformat-with-claude  Reformat requirements using AI (Acceptance Criteria -> Assertions)
+  mcp                   MCP server commands (requires elspais[mcp])
 ```
 
+See [docs/commands.md](docs/commands.md) for comprehensive command documentation.
+
 ## Development
 
 ```bash
@@ -386,6 +401,9 @@ git clone https://github.com/anspar/elspais.git
 cd elspais
 pip install -e ".[dev]"
 
+# Enable git hooks (verifies docs stay in sync before push)
+git config core.hooksPath .githooks
+
 # Run tests
 pytest
 

{elspais-0.9.3 → elspais-0.11.1}/README.md

@@ -21,11 +21,11 @@
 ### For End Users
 
 ```bash
-# Standard installation
-pip install elspais
-
-# Recommended for CLI tools: Isolated installation
+# Recommended: Isolated installation with pipx
 pipx install elspais
+
+# Or standard pip installation
+pip install elspais
 ```
 
 ### For Development
@@ -48,7 +48,7 @@ FROM python:3.11-slim
 COPY --from=ghcr.io/astral-sh/uv:latest /uv /usr/local/bin/uv
 
 # Install elspais (10-100x faster than pip)
-RUN uv pip install --system --no-cache elspais==0.9.1
+RUN uv pip install --system --no-cache elspais==0.9.3
 ```
 
 ```yaml
@@ -57,7 +57,7 @@ RUN uv pip install --system --no-cache elspais==0.9.1
   uses: astral-sh/setup-uv@v2
 
 - name: Install elspais
-  run: uv pip install --system elspais==0.9.1
+  run: uv pip install --system elspais==0.9.3
 ```
 
 **Note:** For regulated/medical software projects, always pin the exact version for reproducibility.
@@ -327,19 +327,23 @@ Options:
   --help           Show help
 
 Commands:
-  validate   Validate requirements format, links, hashes
-  trace      Generate traceability matrix
-  hash       Manage requirement hashes (verify, update)
-  index      Validate or regenerate INDEX.md
-  analyze    Analyze requirement hierarchy
-  edit       Edit requirements in-place (status, implements, move)
-  config     View and modify configuration
-  rules      View and manage content rules
-  mcp        MCP server commands (requires elspais[mcp])
-  version    Show version and check for updates
-  init       Create .elspais.toml configuration
+  validate              Validate requirements format, links, and hashes
+  trace                 Generate traceability matrix
+  hash                  Manage requirement hashes (verify, update)
+  index                 Manage INDEX.md file (validate, regenerate)
+  analyze               Analyze requirement hierarchy (hierarchy, orphans, coverage)
+  changed               Detect git changes to spec files
+  version               Show version and check for updates
+  init                  Create .elspais.toml configuration
+  edit                  Edit requirements in-place (implements, status, move)
+  config                View and modify configuration (show, get, set, ...)
+  rules                 View and manage content rules (list, show)
+  reformat-with-claude  Reformat requirements using AI (Acceptance Criteria -> Assertions)
+  mcp                   MCP server commands (requires elspais[mcp])
 ```
 
+See [docs/commands.md](docs/commands.md) for comprehensive command documentation.
+
 ## Development
 
 ```bash
@@ -348,6 +352,9 @@ git clone https://github.com/anspar/elspais.git
 cd elspais
 pip install -e ".[dev]"
 
+# Enable git hooks (verifies docs stay in sync before push)
+git config core.hooksPath .githooks
+
 # Run tests
 pytest