elspais 0.11.1__tar.gz → 0.11.2__tar.gz

{elspais-0.11.1 → 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,22 @@ 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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: elspais
-Version: 0.11.1
+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

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

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "elspais"
-version = "0.11.1"
+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.1 → 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.1 → 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:
@@ -54,12 +66,14 @@ For detailed command help: elspais <command> --help
         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",
     )
@@ -105,7 +119,8 @@ Common rules to skip:
         metavar="RULE",
     )
     validate_parser.add_argument(
-        "-j", "--json",
+        "-j",
+        "--json",
         action="store_true",
         help="Output requirements as JSON (hht_diary compatible format)",
     )
@@ -262,12 +277,14 @@ Common rules to skip:
         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)",
     )
@@ -374,7 +391,8 @@ JSON batch format:
         metavar="SECTION",
     )
     config_show.add_argument(
-        "-j", "--json",
+        "-j",
+        "--json",
         action="store_true",
         help="Output as JSON",
     )
@@ -389,7 +407,8 @@ JSON batch format:
         help="Configuration key (dot-notation, e.g., 'patterns.prefix')",
     )
     config_get.add_argument(
-        "-j", "--json",
+        "-j",
+        "--json",
         action="store_true",
         help="Output as JSON",
     )
@@ -405,7 +424,7 @@ JSON batch format:
     )
     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
@@ -662,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.1 → 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.1 → 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.1 → 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}"')

{elspais-0.11.1 → elspais-0.11.2}/src/elspais/commands/edit.py

@@ -22,7 +22,7 @@ def run(args: argparse.Namespace) -> int:
     from elspais.config.loader import find_config_file, get_spec_directories, load_config
 
     # Load configuration
-    config_path = args.config if hasattr(args, 'config') else None
+    config_path = args.config if hasattr(args, "config") else None
     if config_path is None:
         config_path = find_config_file(Path.cwd())
     if config_path and config_path.exists():
@@ -31,7 +31,7 @@ def run(args: argparse.Namespace) -> int:
         config = DEFAULT_CONFIG
 
     # Get spec directories
-    spec_dir = args.spec_dir if hasattr(args, 'spec_dir') and args.spec_dir else None
+    spec_dir = args.spec_dir if hasattr(args, "spec_dir") and args.spec_dir else None
     spec_dirs = get_spec_directories(spec_dir, config)
     if not spec_dirs:
         print("Error: No spec directories found", file=sys.stderr)
@@ -40,16 +40,16 @@ def run(args: argparse.Namespace) -> int:
     # Use first spec dir as base
     base_spec_dir = spec_dirs[0]
 
-    dry_run = getattr(args, 'dry_run', False)
+    dry_run = getattr(args, "dry_run", False)
 
-    validate_refs = getattr(args, 'validate_refs', False)
+    validate_refs = getattr(args, "validate_refs", False)
 
     # Handle batch mode
-    if hasattr(args, 'from_json') and args.from_json:
+    if hasattr(args, "from_json") and args.from_json:
         return run_batch_edit(args.from_json, base_spec_dir, dry_run, validate_refs)
 
     # Handle single edit mode
-    if hasattr(args, 'req_id') and args.req_id:
+    if hasattr(args, "req_id") and args.req_id:
         return run_single_edit(args, base_spec_dir, dry_run)
 
     print("Error: Must specify --req-id or --from-json", file=sys.stderr)
@@ -109,18 +109,18 @@ def run_single_edit(args: argparse.Namespace, spec_dir: Path, dry_run: bool) ->
     results = []
 
     # Apply implements change
-    if hasattr(args, 'implements') and args.implements is not None:
+    if hasattr(args, "implements") and args.implements is not None:
         impl_list = [i.strip() for i in args.implements.split(",")]
         result = modify_implements(file_path, req_id, impl_list, dry_run=dry_run)
         results.append(("implements", result))
 
     # Apply status change
-    if hasattr(args, 'status') and args.status:
+    if hasattr(args, "status") and args.status:
         result = modify_status(file_path, req_id, args.status, dry_run=dry_run)
         results.append(("status", result))
 
     # Apply move
-    if hasattr(args, 'move_to') and args.move_to:
+    if hasattr(args, "move_to") and args.move_to:
         dest_path = spec_dir / args.move_to
         result = move_requirement(file_path, dest_path, req_id, dry_run=dry_run)
         results.append(("move", result))
@@ -157,14 +157,14 @@ def find_requirement_in_files(
         Dict with file_path, req_id, line_number, or None if not found
     """
     # Pattern to match requirement header
-    pattern = re.compile(rf'^#\s*{re.escape(req_id)}:', re.MULTILINE)
+    pattern = re.compile(rf"^#\s*{re.escape(req_id)}:", re.MULTILINE)
 
     for md_file in spec_dir.rglob("*.md"):
         content = md_file.read_text()
         match = pattern.search(content)
         if match:
             # Count line number
-            line_number = content[:match.start()].count('\n') + 1
+            line_number = content[: match.start()].count("\n") + 1
             return {
                 "file_path": md_file,
                 "req_id": req_id,
@@ -195,7 +195,7 @@ def modify_implements(
     content = file_path.read_text()
 
     # Find the requirement header
-    req_pattern = re.compile(rf'^(#\s*{re.escape(req_id)}:[^\n]*\n)', re.MULTILINE)
+    req_pattern = re.compile(rf"^(#\s*{re.escape(req_id)}:[^\n]*\n)", re.MULTILINE)
     req_match = req_pattern.search(content)
 
     if not req_match:
@@ -203,9 +203,9 @@ def modify_implements(
 
     # Find the **Implements**: field after the header
     start_pos = req_match.end()
-    search_region = content[start_pos:start_pos + 500]
+    search_region = content[start_pos : start_pos + 500]
 
-    impl_pattern = re.compile(r'(\*\*Implements\*\*:\s*)([^|\n]+)')
+    impl_pattern = re.compile(r"(\*\*Implements\*\*:\s*)([^|\n]+)")
     impl_match = impl_pattern.search(search_region)
 
     if not impl_match:
@@ -272,7 +272,7 @@ def modify_status(
     content = file_path.read_text()
 
     # Find the requirement header
-    req_pattern = re.compile(rf'^(#\s*{re.escape(req_id)}:[^\n]*\n)', re.MULTILINE)
+    req_pattern = re.compile(rf"^(#\s*{re.escape(req_id)}:[^\n]*\n)", re.MULTILINE)
     req_match = req_pattern.search(content)
 
     if not req_match:
@@ -280,9 +280,9 @@ def modify_status(
 
     # Find the **Status**: field after the header
     start_pos = req_match.end()
-    search_region = content[start_pos:start_pos + 500]
+    search_region = content[start_pos : start_pos + 500]
 
-    status_pattern = re.compile(r'(\*\*Status\*\*:\s*)(\w+)')
+    status_pattern = re.compile(r"(\*\*Status\*\*:\s*)(\w+)")
     status_match = status_pattern.search(search_region)
 
     if not status_match:
@@ -342,11 +342,8 @@ def move_requirement(
     # Find the requirement block
     # Pattern: # REQ-xxx: title ... *End* *title* | **Hash**: xxx\n---
     req_pattern = re.compile(
-        rf'(^#\s*{re.escape(req_id)}:[^\n]*\n'
-        rf'.*?'
-        rf'\*End\*[^\n]*\n'
-        rf'(?:---\n)?)',
-        re.MULTILINE | re.DOTALL
+        rf"(^#\s*{re.escape(req_id)}:[^\n]*\n" rf".*?" rf"\*End\*[^\n]*\n" rf"(?:---\n)?)",
+        re.MULTILINE | re.DOTALL,
     )
 
     req_match = req_pattern.search(source_content)
@@ -361,9 +358,9 @@ def move_requirement(
         req_block = req_block.rstrip() + "\n---\n"
 
     # Remove from source
-    new_source_content = source_content[:req_match.start()] + source_content[req_match.end():]
+    new_source_content = source_content[: req_match.start()] + source_content[req_match.end() :]
     # Clean up extra blank lines
-    new_source_content = re.sub(r'\n{3,}', '\n\n', new_source_content)
+    new_source_content = re.sub(r"\n{3,}", "\n\n", new_source_content)
 
     # Add to destination
     dest_content = dest_file.read_text() if dest_file.exists() else ""
@@ -400,8 +397,9 @@ def collect_all_req_ids(spec_dir: Path) -> set:
         Set of requirement IDs found (short form, e.g., "p00001")
     """
     import re
+
     req_ids = set()
-    pattern = re.compile(r'^#\s*(REQ-[A-Za-z0-9-]+):', re.MULTILINE)
+    pattern = re.compile(r"^#\s*(REQ-[A-Za-z0-9-]+):", re.MULTILINE)
 
     for md_file in spec_dir.rglob("*.md"):
         content = md_file.read_text()
@@ -453,11 +451,13 @@ def batch_edit(
         # Find the requirement
         location = find_requirement_in_files(spec_dir, req_id)
         if not location:
-            results.append({
-                "success": False,
-                "req_id": req_id,
-                "error": f"Requirement {req_id} not found",
-            })
+            results.append(
+                {
+                    "success": False,
+                    "req_id": req_id,
+                    "error": f"Requirement {req_id} not found",
+                }
+            )
             continue
 
         file_path = location["file_path"]
@@ -493,9 +493,7 @@ def batch_edit(
 
         # Apply status change
         if "status" in change:
-            status_result = modify_status(
-                file_path, req_id, change["status"], dry_run=dry_run
-            )
+            status_result = modify_status(file_path, req_id, change["status"], dry_run=dry_run)
             if not status_result["success"]:
                 result = status_result
                 result["req_id"] = req_id
@@ -506,9 +504,7 @@ def batch_edit(
         # Apply move (must be last since it changes file location)
         if "move_to" in change:
             dest_path = spec_dir / change["move_to"]
-            move_result = move_requirement(
-                file_path, dest_path, req_id, dry_run=dry_run
-            )
+            move_result = move_requirement(file_path, dest_path, req_id, dry_run=dry_run)
             if not move_result["success"]:
                 result = move_result
                 result["req_id"] = req_id

{elspais-0.11.1 → elspais-0.11.2}/src/elspais/commands/hash_cmd.py

@@ -105,15 +105,15 @@ def run_update(args: argparse.Namespace) -> int:
         print(f"Updating {len(updates)} hashes...")
         for req_id, req, new_hash in updates:
             result = update_hash_in_file(req, new_hash)
-            if result['updated']:
+            if result["updated"]:
                 print(f"  ✓ {req_id}")
-                old_hash = result['old_hash'] or "(none)"
+                old_hash = result["old_hash"] or "(none)"
                 print(f"    [INFO] Hash: {old_hash} -> {result['new_hash']}")
-                if result['title_fixed']:
+                if result["title_fixed"]:
                     print(f"    [INFO] Title fixed: \"{result['old_title']}\" -> \"{req.title}\"")
             else:
                 print(f"  ✗ {req_id}")
-                print(f"    [WARN] Could not find End marker to update")
+                print("    [WARN] Could not find End marker to update")
 
     return 0
 
@@ -168,11 +168,11 @@ def update_hash_in_file(req: Requirement, new_hash: str) -> dict:
     import re
 
     result = {
-        'updated': False,
-        'old_hash': req.hash,
-        'new_hash': new_hash,
-        'title_fixed': False,
-        'old_title': None,
+        "updated": False,
+        "old_hash": req.hash,
+        "new_hash": new_hash,
+        "title_fixed": False,
+        "old_title": None,
     }
 
     if not req.file_path:
@@ -186,35 +186,41 @@ def update_hash_in_file(req: Requirement, new_hash: str) -> dict:
         # This handles both: (1) normal case, (2) mismatched title case
 
         # First try: match by correct title (handles case where titles match)
-        pattern_by_title = rf"^\*End\*\s+\*{re.escape(req.title)}\*\s*\|\s*\*\*Hash\*\*:\s*[a-fA-F0-9]+\s*$"
+        pattern_by_title = (
+            rf"^\*End\*\s+\*{re.escape(req.title)}\*\s*\|\s*\*\*Hash\*\*:\s*[a-fA-F0-9]+\s*$"
+        )
         if re.search(pattern_by_title, content, re.MULTILINE):
             content, count = re.subn(pattern_by_title, new_end_line, content, flags=re.MULTILINE)
             if count > 0:
-                result['updated'] = True
+                result["updated"] = True
         else:
             # Second try: find by hash value (handles mismatched title)
             # Pattern: *End* *AnyTitle* | **Hash**: oldhash
-            pattern_by_hash = rf"^\*End\*\s+\*([^*]+)\*\s*\|\s*\*\*Hash\*\*:\s*{re.escape(req.hash)}\s*$"
+            pattern_by_hash = (
+                rf"^\*End\*\s+\*([^*]+)\*\s*\|\s*\*\*Hash\*\*:\s*{re.escape(req.hash)}\s*$"
+            )
             match = re.search(pattern_by_hash, content, re.MULTILINE)
 
             if match:
                 old_title = match.group(1)
                 if old_title != req.title:
-                    result['title_fixed'] = True
-                    result['old_title'] = old_title
+                    result["title_fixed"] = True
+                    result["old_title"] = old_title
 
                 # Replace entire line (only first match to avoid affecting other reqs)
-                content = re.sub(pattern_by_hash, new_end_line, content, count=1, flags=re.MULTILINE)
-                result['updated'] = True
+                content = re.sub(
+                    pattern_by_hash, new_end_line, content, count=1, flags=re.MULTILINE
+                )
+                result["updated"] = True
     else:
         # Add hash to end marker (no existing hash)
         # Pattern: *End* *Title* (without hash)
         pattern = rf"^(\*End\*\s+\*{re.escape(req.title)}\*)(?!\s*\|\s*\*\*Hash\*\*)\s*$"
         content, count = re.subn(pattern, new_end_line, content, flags=re.MULTILINE)
         if count > 0:
-            result['updated'] = True
+            result["updated"] = True
 
-    if result['updated']:
+    if result["updated"]:
         req.file_path.write_text(content, encoding="utf-8")
 
     return result

{elspais-0.11.1 → elspais-0.11.2}/src/elspais/commands/index.py

@@ -58,6 +58,7 @@ def run_validate(args: argparse.Namespace) -> int:
     indexed_ids = set()
 
     import re
+
     for match in re.finditer(r"\|\s*([A-Z]+-(?:[A-Z]+-)?[a-zA-Z]?\d+)\s*\|", index_content):
         indexed_ids.add(match.group(1))
 
@@ -155,12 +156,12 @@ def generate_index(requirements: dict, config: dict) -> str:
 
         lines.append("")
 
-    lines.extend([
-        "---",
-        "",
-        "*Generated by elspais*",
-    ])
+    lines.extend(
+        [
+            "---",
+            "",
+            "*Generated by elspais*",
+        ]
+    )
 
     return "\n".join(lines)
-
-

{elspais-0.11.1 → elspais-0.11.2}/src/elspais/commands/init.py

@@ -50,7 +50,7 @@ def generate_config(project_type: str, associated_prefix: Optional[str] = None)
     if project_type == "associated":
         if associated_prefix is None:
             associated_prefix = "XXX"  # Placeholder if not provided
-        return f'''# elspais configuration - Associated Repository
+        return f"""# elspais configuration - Associated Repository
 # Generated by: elspais init --type associated
 
 [project]
@@ -102,10 +102,10 @@ allow_orphans = true  # More permissive for associated development
 [rules.format]
 require_hash = true
 require_assertions = true
-'''
+"""
 
     else:  # core
-        return '''# elspais configuration - Core Repository
+        return """# elspais configuration - Core Repository
 # Generated by: elspais init
 
 [project]
@@ -174,4 +174,4 @@ scan_patterns = [
     "src/**/*.py",
     "apps/**/*.dart",
 ]
-'''
+"""