elspais 0.11.0__tar.gz → 0.11.2__tar.gz

{elspais-0.11.0 → elspais-0.11.2}/CHANGELOG.md

@@ -1,5 +1,8 @@
 # Changelog
 
+<!-- markdownlint-disable MD022 MD032 -->
+<!-- Compact changelog format: no blank lines around headings/lists -->
+
 All notable changes to elspais will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
@@ -7,6 +10,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.11.2] - 2026-01-21
+
+### Fixed
+
+- Fixed `elspais trace --view` crash caused by missing `is_cycle` and `cycle_path` properties in `TraceViewRequirement`
+
+### Added
+
+- Comprehensive git hooks (pre-commit, pre-push, commit-msg) with branch protection, linting, secret detection, and commit message format validation
+- Commit message format validation requiring `[TICKET-NUMBER]` prefix (e.g., `[CUR-514]`)
+- Markdownlint configuration (`.markdownlint.json`) disabling line length and duplicate heading rules
+
+### Changed
+
+- Applied ruff and black formatting fixes across the codebase
+
+## [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

{elspais-0.11.0 → elspais-0.11.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: elspais
-Version: 0.11.0
+Version: 0.11.2
 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
@@ -376,19 +376,19 @@ Options:
   --help           Show help
 
 Commands:
-  validate              Validate requirements format, links, hashes
+  validate              Validate requirements format, links, and hashes
   trace                 Generate traceability matrix
   hash                  Manage requirement hashes (verify, update)
-  reformat-with-claude  Transform requirements using AI (Acceptance Criteria → Assertions)
+  index                 Manage INDEX.md file (validate, regenerate)
+  analyze               Analyze requirement hierarchy (hierarchy, orphans, coverage)
   changed               Detect git changes to spec files
-  analyze               Analyze requirement hierarchy
-  edit                  Edit requirements in-place (status, implements, move)
-  config                View and modify configuration
-  rules                 View and manage content rules
-  index                 Validate or regenerate INDEX.md
+  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])
-  version               Show version and check for updates
 ```
 
 See [docs/commands.md](docs/commands.md) for comprehensive command documentation.
@@ -401,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.11.0 → elspais-0.11.2}/README.md

@@ -327,19 +327,19 @@ Options:
   --help           Show help
 
 Commands:
-  validate              Validate requirements format, links, hashes
+  validate              Validate requirements format, links, and hashes
   trace                 Generate traceability matrix
   hash                  Manage requirement hashes (verify, update)
-  reformat-with-claude  Transform requirements using AI (Acceptance Criteria → Assertions)
+  index                 Manage INDEX.md file (validate, regenerate)
+  analyze               Analyze requirement hierarchy (hierarchy, orphans, coverage)
   changed               Detect git changes to spec files
-  analyze               Analyze requirement hierarchy
-  edit                  Edit requirements in-place (status, implements, move)
-  config                View and modify configuration
-  rules                 View and manage content rules
-  index                 Validate or regenerate INDEX.md
+  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])
-  version               Show version and check for updates
 ```
 
 See [docs/commands.md](docs/commands.md) for comprehensive command documentation.
@@ -352,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
 

{elspais-0.11.0 → elspais-0.11.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "elspais"
-version = "0.11.0"
+version = "0.11.2"
 description = "Requirements validation and traceability tools - L-Space connects all libraries"
 readme = "README.md"
 requires-python = ">=3.9"

{elspais-0.11.0 → elspais-0.11.2}/src/elspais/__init__.py

@@ -10,7 +10,7 @@ and supports multi-repository requirement management with configurable
 ID patterns and validation rules.
 """
 
-from importlib.metadata import version, PackageNotFoundError
+from importlib.metadata import PackageNotFoundError, version
 
 try:
     __version__ = version("elspais")

{elspais-0.11.0 → elspais-0.11.2}/src/elspais/cli.py

@@ -10,7 +10,19 @@ from pathlib import Path
 from typing import List, Optional
 
 from elspais import __version__
-from elspais.commands import analyze, changed, config_cmd, edit, hash_cmd, index, init, rules_cmd, trace, validate, reformat_cmd
+from elspais.commands import (
+    analyze,
+    changed,
+    config_cmd,
+    edit,
+    hash_cmd,
+    index,
+    init,
+    reformat_cmd,
+    rules_cmd,
+    trace,
+    validate,
+)
 
 
 def create_parser() -> argparse.ArgumentParser:
@@ -22,9 +34,16 @@ def create_parser() -> argparse.ArgumentParser:
         epilog="""
 Examples:
   elspais validate              # Validate all requirements
+  elspais validate --fix        # Auto-fix fixable issues
   elspais trace --format html   # Generate HTML traceability matrix
+  elspais trace --view          # Interactive HTML view
   elspais hash update           # Update all requirement hashes
+  elspais changed               # Show uncommitted spec changes
+  elspais analyze hierarchy     # Show requirement hierarchy tree
+  elspais config show           # View current configuration
   elspais init                  # Create .elspais.toml configuration
+
+For detailed command help: elspais <command> --help
         """,
     )
 
@@ -47,12 +66,14 @@ Examples:
         metavar="PATH",
     )
     parser.add_argument(
-        "-v", "--verbose",
+        "-v",
+        "--verbose",
         action="store_true",
         help="Verbose output",
     )
     parser.add_argument(
-        "-q", "--quiet",
+        "-q",
+        "--quiet",
         action="store_true",
         help="Suppress non-error output",
     )
@@ -64,6 +85,21 @@ Examples:
     validate_parser = subparsers.add_parser(
         "validate",
         help="Validate requirements format, links, and hashes",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  elspais validate                      # Validate all requirements
+  elspais validate --fix                # Auto-fix hashes and formatting
+  elspais validate --skip-rule hash.*   # Skip all hash rules
+  elspais validate -j                   # Output JSON for tooling
+  elspais validate --mode core          # Exclude associated repo specs
+
+Common rules to skip:
+  hash.missing     Hash footer is missing
+  hash.mismatch    Hash doesn't match content
+  hierarchy.*      All hierarchy rules
+  format.*         All format rules
+""",
     )
     validate_parser.add_argument(
         "--fix",
@@ -79,11 +115,12 @@ Examples:
     validate_parser.add_argument(
         "--skip-rule",
         action="append",
-        help="Skip specific validation rules",
+        help="Skip validation rules (can be repeated, e.g., hash.*, format.*)",
         metavar="RULE",
     )
     validate_parser.add_argument(
-        "-j", "--json",
+        "-j",
+        "--json",
         action="store_true",
         help="Output requirements as JSON (hht_diary compatible format)",
     )
@@ -101,7 +138,7 @@ Examples:
         "--mode",
         choices=["core", "combined"],
         default="combined",
-        help="core: skip sponsor repos, combined: include all (default: combined)",
+        help="Scope: core (this repo only), combined (include sponsor repos)",
     )
 
     # trace command
@@ -113,7 +150,7 @@ Examples:
         "--format",
         choices=["markdown", "html", "csv", "both"],
         default="both",
-        help="Output format (default: both)",
+        help="Output format: markdown, html, csv, or both (markdown + csv)",
     )
     trace_parser.add_argument(
         "--output",
@@ -130,17 +167,17 @@ Examples:
     trace_parser.add_argument(
         "--embed-content",
         action="store_true",
-        help="Embed full requirement content in HTML output",
+        help="Embed full requirement markdown in HTML for offline viewing",
     )
     trace_parser.add_argument(
         "--edit-mode",
         action="store_true",
-        help="Include edit mode UI in HTML output",
+        help="Enable in-browser editing of implements and status fields",
     )
     trace_parser.add_argument(
         "--review-mode",
         action="store_true",
-        help="Include review mode UI in HTML output",
+        help="Enable collaborative review with comments and flags",
     )
     trace_parser.add_argument(
         "--server",
@@ -168,7 +205,7 @@ Examples:
     # hash command
     hash_parser = subparsers.add_parser(
         "hash",
-        help="Manage requirement hashes",
+        help="Manage requirement hashes (verify, update)",
     )
     hash_subparsers = hash_parser.add_subparsers(dest="hash_action")
 
@@ -195,7 +232,7 @@ Examples:
     # index command
     index_parser = subparsers.add_parser(
         "index",
-        help="Manage INDEX.md file",
+        help="Manage INDEX.md file (validate, regenerate)",
     )
     index_subparsers = index_parser.add_subparsers(dest="index_action")
 
@@ -211,7 +248,7 @@ Examples:
     # analyze command
     analyze_parser = subparsers.add_parser(
         "analyze",
-        help="Analyze requirement hierarchy",
+        help="Analyze requirement hierarchy (hierarchy, orphans, coverage)",
     )
     analyze_subparsers = analyze_parser.add_subparsers(dest="analyze_action")
 
@@ -221,7 +258,7 @@ Examples:
     )
     analyze_subparsers.add_parser(
         "orphans",
-        help="Find orphaned requirements",
+        help="Find requirements with no parent (missing or invalid Implements)",
     )
     analyze_subparsers.add_parser(
         "coverage",
@@ -240,12 +277,14 @@ Examples:
         metavar="BRANCH",
     )
     changed_parser.add_argument(
-        "-j", "--json",
+        "-j",
+        "--json",
         action="store_true",
         help="Output as JSON",
     )
     changed_parser.add_argument(
-        "-a", "--all",
+        "-a",
+        "--all",
         action="store_true",
         help="Include all changed files (not just spec)",
     )
@@ -258,7 +297,7 @@ Examples:
     version_parser.add_argument(
         "check",
         nargs="?",
-        help="Check for updates",
+        help="Check for updates (not yet implemented)",
     )
 
     # init command
@@ -286,6 +325,17 @@ Examples:
     edit_parser = subparsers.add_parser(
         "edit",
         help="Edit requirements in-place (implements, status, move)",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  elspais edit --req-id REQ-d00001 --status Draft
+  elspais edit --req-id REQ-d00001 --implements REQ-p00001,REQ-p00002
+  elspais edit --req-id REQ-d00001 --move-to roadmap/future.md
+  elspais edit --from-json edits.json
+
+JSON batch format:
+  {"edits": [{"req_id": "...", "status": "...", "implements": [...]}]}
+""",
     )
     edit_parser.add_argument(
         "--req-id",
@@ -326,7 +376,7 @@ Examples:
     # config command
     config_parser = subparsers.add_parser(
         "config",
-        help="View and modify configuration",
+        help="View and modify configuration (show, get, set, ...)",
     )
     config_subparsers = config_parser.add_subparsers(dest="config_action")
 
@@ -341,7 +391,8 @@ Examples:
         metavar="SECTION",
     )
     config_show.add_argument(
-        "-j", "--json",
+        "-j",
+        "--json",
         action="store_true",
         help="Output as JSON",
     )
@@ -356,7 +407,8 @@ Examples:
         help="Configuration key (dot-notation, e.g., 'patterns.prefix')",
     )
     config_get.add_argument(
-        "-j", "--json",
+        "-j",
+        "--json",
         action="store_true",
         help="Output as JSON",
     )
@@ -372,7 +424,7 @@ Examples:
     )
     config_set.add_argument(
         "value",
-        help="Value to set (type auto-detected: true/false, numbers, JSON arrays/objects, or string)",
+        help="Value to set (auto-detected: bool, number, JSON array/object, string)",
     )
 
     # config unset
@@ -422,7 +474,7 @@ Examples:
     # rules command
     rules_parser = subparsers.add_parser(
         "rules",
-        help="View and manage content rules",
+        help="View and manage content rules (list, show)",
     )
     rules_subparsers = rules_parser.add_subparsers(dest="rules_action")
 
@@ -629,7 +681,7 @@ def mcp_command(args: argparse.Namespace) -> int:
         if hasattr(args, "spec_dir") and args.spec_dir:
             working_dir = args.spec_dir.parent
 
-        print(f"Starting elspais MCP server...")
+        print("Starting elspais MCP server...")
         print(f"Working directory: {working_dir}")
         print(f"Transport: {args.transport}")
 

{elspais-0.11.0 → elspais-0.11.2}/src/elspais/commands/analyze.py

@@ -41,16 +41,14 @@ def run_hierarchy(args: argparse.Namespace) -> int:
 
     # Find root requirements (PRD with no implements)
     roots = [
-        req for req in requirements.values()
+        req
+        for req in requirements.values()
         if req.level.upper() in ["PRD", "PRODUCT"] and not req.implements
     ]
 
     if not roots:
         # Fall back to all PRD requirements
-        roots = [
-            req for req in requirements.values()
-            if req.level.upper() in ["PRD", "PRODUCT"]
-        ]
+        roots = [req for req in requirements.values() if req.level.upper() in ["PRD", "PRODUCT"]]
 
     printed = set()
 
@@ -153,7 +151,8 @@ def run_coverage(args: argparse.Namespace) -> int:
 
     # List unimplemented PRD
     unimplemented = [
-        req for req in requirements.values()
+        req
+        for req in requirements.values()
         if req.level.upper() in ["PRD", "PRODUCT"] and req.id not in implemented_prd
     ]
 

{elspais-0.11.0 → elspais-0.11.2}/src/elspais/commands/changed.py

@@ -11,13 +11,11 @@ import argparse
 import json
 import sys
 from pathlib import Path
-from typing import Dict, List, Optional
+from typing import Dict, Optional
 
 from elspais.config.defaults import DEFAULT_CONFIG
 from elspais.config.loader import find_config_file, load_config
 from elspais.core.git import (
-    GitChangeInfo,
-    MovedRequirement,
     detect_moved_requirements,
     filter_spec_files,
     get_current_req_locations,
@@ -76,9 +74,7 @@ def run(args: argparse.Namespace) -> int:
 
     # Detect moved requirements
     current_locations = get_current_req_locations(repo_root, spec_dir)
-    moved = detect_moved_requirements(
-        changes.committed_req_locations, current_locations
-    )
+    moved = detect_moved_requirements(changes.committed_req_locations, current_locations)
 
     # Build result
     result = {

{elspais-0.11.0 → elspais-0.11.2}/src/elspais/commands/config_cmd.py

@@ -8,15 +8,14 @@ import argparse
 import json
 import sys
 from pathlib import Path
-from typing import Any, Dict, List, Optional, Tuple, Union
+from typing import Any, Dict, List, Optional, Tuple
 
+from elspais.config.defaults import DEFAULT_CONFIG
 from elspais.config.loader import (
     find_config_file,
     load_config,
-    merge_configs,
     parse_toml,
 )
-from elspais.config.defaults import DEFAULT_CONFIG
 
 
 def run(args: argparse.Namespace) -> int:
@@ -255,6 +254,7 @@ def cmd_path(args: argparse.Namespace) -> int:
 
 # Helper functions
 
+
 def _get_config_path(args: argparse.Namespace) -> Optional[Path]:
     """Get configuration file path from args or by discovery."""
     if hasattr(args, "config") and args.config:
@@ -363,7 +363,7 @@ def _print_value(value: Any, prefix: str = "") -> None:
         if prefix:
             print(f"{prefix} = {'true' if value else 'false'}")
         else:
-            print('true' if value else 'false')
+            print("true" if value else "false")
     elif isinstance(value, str):
         if prefix:
             print(f'{prefix} = "{value}"')