elspais 0.11.1__py3-none-any.whl → 0.11.2__py3-none-any.whl

elspais/reformat/prompts.py

@@ -14,23 +14,31 @@ JSON_SCHEMA = {
     "properties": {
         "rationale": {
             "type": "string",
-            "description": "Non-normative context explaining why this requirement exists. No SHALL/MUST language."
+            "description": (
+                "Non-normative context explaining why this requirement exists. "
+                "No SHALL/MUST language."
+            ),
         },
         "assertions": {
             "type": "array",
             "items": {"type": "string"},
-            "description": "List of assertions, each starting with 'The system SHALL...' or similar prescriptive language."
-        }
+            "description": (
+                "List of assertions, each starting with 'The system SHALL...' "
+                "or similar prescriptive language."
+            ),
+        },
     },
-    "required": ["rationale", "assertions"]
+    "required": ["rationale", "assertions"],
 }
 
-JSON_SCHEMA_STR = json.dumps(JSON_SCHEMA, separators=(',', ':'))
+JSON_SCHEMA_STR = json.dumps(JSON_SCHEMA, separators=(",", ":"))
 
 # System prompt for requirement reformatting
-REFORMAT_SYSTEM_PROMPT = """You are a requirements engineering expert specializing in FDA 21 CFR Part 11 compliant clinical trial systems.
+REFORMAT_SYSTEM_PROMPT = """You are a requirements engineering expert specializing in \
+FDA 21 CFR Part 11 compliant clinical trial systems.
 
-Your task is to reformat requirements from an old descriptive format to a new prescriptive assertion-based format.
+Your task is to reformat requirements from an old descriptive format to a new \
+prescriptive assertion-based format.
 
 EXTRACTION RULES:
 1. Extract ALL obligations from the old format (body text, bullet points, acceptance criteria)
@@ -47,7 +55,7 @@ RATIONALE RULES:
 1. The rationale provides context for WHY this requirement exists
 2. Rationale MUST NOT introduce new obligations
 3. Rationale MUST NOT use SHALL/MUST language
-4. Rationale can explain regulatory context, design decisions, or relationships to other requirements
+4. Rationale can explain regulatory context, design decisions, or relationships
 
 LANGUAGE GUIDELINES:
 - Use "The system SHALL..." for system behaviors
@@ -59,11 +67,12 @@ LANGUAGE GUIDELINES:
 OUTPUT FORMAT:
 Return a JSON object with:
 - "rationale": A paragraph explaining the requirement's purpose (no SHALL language)
-- "assertions": An array of strings, each being a complete assertion starting with the subject and SHALL
+- "assertions": An array of strings, each a complete assertion with subject and SHALL
 
 Example output:
 {
-  "rationale": "This requirement ensures complete audit trails for regulatory compliance. FDA 21 CFR Part 11 mandates that electronic records maintain tamper-evident histories of all modifications.",
+  "rationale": "This requirement ensures complete audit trails for regulatory compliance. \
+FDA 21 CFR Part 11 mandates tamper-evident histories of all modifications.",
   "assertions": [
     "The system SHALL store all data changes as immutable events.",
     "The system SHALL preserve the complete history of all modifications.",
@@ -80,7 +89,7 @@ def build_user_prompt(
     status: str,
     implements: list,
     body: str,
-    rationale: str = ""
+    rationale: str = "",
 ) -> str:
     """
     Build the user prompt for reformatting a requirement.
@@ -118,6 +127,7 @@ CURRENT RATIONALE:
 """
 
     prompt += """
-Extract all obligations and convert them to labeled assertions. Return ONLY the JSON object with "rationale" and "assertions" fields."""
+Extract all obligations and convert them to labeled assertions. \
+Return ONLY the JSON object with "rationale" and "assertions" fields."""
 
     return prompt

elspais/reformat/transformer.py

@@ -12,13 +12,11 @@ import sys
 from typing import List, Optional, Tuple
 
 from elspais.reformat.hierarchy import RequirementNode
-from elspais.reformat.prompts import REFORMAT_SYSTEM_PROMPT, JSON_SCHEMA_STR, build_user_prompt
+from elspais.reformat.prompts import JSON_SCHEMA_STR, REFORMAT_SYSTEM_PROMPT, build_user_prompt
 
 
 def reformat_requirement(
-    node: RequirementNode,
-    model: str = "sonnet",
-    verbose: bool = False
+    node: RequirementNode, model: str = "sonnet", verbose: bool = False
 ) -> Tuple[Optional[dict], bool, str]:
     """
     Use Claude CLI to reformat a requirement.
@@ -40,30 +38,32 @@ def reformat_requirement(
         status=node.status,
         implements=node.implements,
         body=node.body,
-        rationale=node.rationale
+        rationale=node.rationale,
     )
 
     # Build the claude command
     cmd = [
-        'claude',
-        '-p',  # Print mode (non-interactive)
-        '--output-format', 'json',
-        '--json-schema', JSON_SCHEMA_STR,
-        '--system-prompt', REFORMAT_SYSTEM_PROMPT,
-        '--tools', '',  # Disable all tools
-        '--model', model,
-        user_prompt
+        "claude",
+        "-p",  # Print mode (non-interactive)
+        "--output-format",
+        "json",
+        "--json-schema",
+        JSON_SCHEMA_STR,
+        "--system-prompt",
+        REFORMAT_SYSTEM_PROMPT,
+        "--tools",
+        "",  # Disable all tools
+        "--model",
+        model,
+        user_prompt,
     ]
 
     if verbose:
-        print(f"  Running: claude -p --output-format json ...", file=sys.stderr)
+        print("  Running: claude -p --output-format json ...", file=sys.stderr)
 
     try:
         result = subprocess.run(
-            cmd,
-            capture_output=True,
-            text=True,
-            timeout=120  # 2 minute timeout
+            cmd, capture_output=True, text=True, timeout=120  # 2 minute timeout
         )
 
         if result.returncode != 0:
@@ -105,29 +105,33 @@ def parse_claude_response(response: str) -> Optional[dict]:
         data = json.loads(response)
 
         # Check for error
-        if data.get('is_error') or data.get('subtype') == 'error':
+        if data.get("is_error") or data.get("subtype") == "error":
             return None
 
         # The structured output is in 'structured_output' field
-        if 'structured_output' in data:
-            structured = data['structured_output']
-            if isinstance(structured, dict) and 'rationale' in structured and 'assertions' in structured:
+        if "structured_output" in data:
+            structured = data["structured_output"]
+            if (
+                isinstance(structured, dict)
+                and "rationale" in structured
+                and "assertions" in structured
+            ):
                 return structured
 
         # Fallback: Direct result (if schema not used)
-        if 'rationale' in data and 'assertions' in data:
+        if "rationale" in data and "assertions" in data:
             return data
 
         # Fallback: Wrapped in result field
-        if 'result' in data:
-            result = data['result']
-            if isinstance(result, dict) and 'rationale' in result:
+        if "result" in data:
+            result = data["result"]
+            if isinstance(result, dict) and "rationale" in result:
                 return result
             # Result might be a JSON string
             if isinstance(result, str) and result.strip():
                 try:
                     parsed = json.loads(result)
-                    if 'rationale' in parsed:
+                    if "rationale" in parsed:
                         return parsed
                 except json.JSONDecodeError:
                     pass
@@ -137,13 +141,13 @@ def parse_claude_response(response: str) -> Optional[dict]:
     except json.JSONDecodeError:
         # Try to extract JSON from the response
         try:
-            json_start = response.find('{')
-            json_end = response.rfind('}') + 1
+            json_start = response.find("{")
+            json_end = response.rfind("}") + 1
             if json_start >= 0 and json_end > json_start:
                 parsed = json.loads(response[json_start:json_end])
-                if 'structured_output' in parsed:
-                    return parsed['structured_output']
-                if 'rationale' in parsed and 'assertions' in parsed:
+                if "structured_output" in parsed:
+                    return parsed["structured_output"]
+                if "rationale" in parsed and "assertions" in parsed:
                     return parsed
         except json.JSONDecodeError:
             pass
@@ -157,7 +161,7 @@ def assemble_new_format(
     status: str,
     implements: List[str],
     rationale: str,
-    assertions: List[str]
+    assertions: List[str],
 ) -> str:
     """
     Assemble the new format requirement markdown.
@@ -200,11 +204,11 @@ def assemble_new_format(
 
     # Label assertions A, B, C, etc.
     for i, assertion in enumerate(assertions):
-        label = chr(ord('A') + i)
+        label = chr(ord("A") + i)
         # Clean up assertion text
         assertion_text = assertion.strip()
         # Remove any existing label if present
-        if len(assertion_text) > 2 and assertion_text[1] == '.' and assertion_text[0].isupper():
+        if len(assertion_text) > 2 and assertion_text[1] == "." and assertion_text[0].isupper():
             assertion_text = assertion_text[2:].strip()
         lines.append(f"{label}. {assertion_text}")
 
@@ -219,9 +223,7 @@ def assemble_new_format(
 
 
 def validate_reformatted_content(
-    original: RequirementNode,
-    rationale: str,
-    assertions: List[str]
+    original: RequirementNode, rationale: str, assertions: List[str]
 ) -> Tuple[bool, List[str]]:
     """
     Validate that reformatted content is well-formed.
@@ -243,12 +245,12 @@ def validate_reformatted_content(
 
     # Check each assertion uses SHALL
     for i, assertion in enumerate(assertions):
-        label = chr(ord('A') + i)
-        if 'SHALL' not in assertion.upper():
+        label = chr(ord("A") + i)
+        if "SHALL" not in assertion.upper():
             warnings.append(f"Assertion {label} missing SHALL keyword")
 
     # Check rationale doesn't use SHALL
-    if 'SHALL' in rationale.upper():
+    if "SHALL" in rationale.upper():
         warnings.append("Rationale contains SHALL (should be non-normative)")
 
     # Check assertion count

elspais/sponsors/__init__.py

@@ -69,8 +69,6 @@ def parse_yaml(content: str) -> Dict[str, Any]:
     current_key: Optional[str] = None
     current_list: Optional[List[Dict]] = None
     current_dict: Optional[Dict[str, Any]] = None
-    list_key: Optional[str] = None
-    indent_stack: List[tuple] = []  # (indent_level, container)
 
     lines = content.split("\n")
 

elspais/testing/__init__.py

@@ -11,7 +11,7 @@ This package provides test-to-requirement mapping and coverage analysis:
 from elspais.testing.config import TestingConfig
 from elspais.testing.mapper import RequirementTestData, TestMapper, TestMappingResult
 from elspais.testing.result_parser import ResultParser, TestResult, TestStatus
-from elspais.testing.scanner import TestReference, TestScanResult, TestScanner
+from elspais.testing.scanner import TestReference, TestScanner, TestScanResult
 
 __all__ = [
     "TestingConfig",

elspais/testing/result_parser.py

@@ -10,7 +10,7 @@ import xml.etree.ElementTree as ET
 from dataclasses import dataclass, field
 from enum import Enum
 from pathlib import Path
-from typing import Any, Dict, List, Optional, Set
+from typing import List, Optional, Set
 
 
 class TestStatus(Enum):
@@ -143,7 +143,7 @@ class ResultParser:
             tree = ET.parse(file_path)
             root = tree.getroot()
         except ET.ParseError as e:
-            raise ValueError(f"Invalid XML: {e}")
+            raise ValueError(f"Invalid XML: {e}") from e
 
         # Handle both <testsuites> and <testsuite> as root
         if root.tag == "testsuites":
@@ -181,15 +181,17 @@ class ResultParser:
                 # Extract requirement IDs from test name
                 req_ids = self._extract_requirement_ids(test_name, classname)
 
-                results.append(TestResult(
-                    test_name=test_name,
-                    classname=classname,
-                    status=status,
-                    requirement_ids=req_ids,
-                    result_file=file_path,
-                    duration=duration,
-                    message=message,
-                ))
+                results.append(
+                    TestResult(
+                        test_name=test_name,
+                        classname=classname,
+                        status=status,
+                        requirement_ids=req_ids,
+                        result_file=file_path,
+                        duration=duration,
+                        message=message,
+                    )
+                )
 
         return results
 
@@ -209,7 +211,7 @@ class ResultParser:
             with open(file_path, encoding="utf-8") as f:
                 data = json.load(f)
         except json.JSONDecodeError as e:
-            raise ValueError(f"Invalid JSON: {e}")
+            raise ValueError(f"Invalid JSON: {e}") from e
 
         # Handle pytest-json-report format
         tests = data.get("tests", [])
@@ -241,15 +243,17 @@ class ResultParser:
             # Extract requirement IDs
             req_ids = self._extract_requirement_ids(test_name, classname)
 
-            results.append(TestResult(
-                test_name=test_name,
-                classname=classname,
-                status=status,
-                requirement_ids=req_ids,
-                result_file=file_path,
-                duration=duration,
-                message=message,
-            ))
+            results.append(
+                TestResult(
+                    test_name=test_name,
+                    classname=classname,
+                    status=status,
+                    requirement_ids=req_ids,
+                    result_file=file_path,
+                    duration=duration,
+                    message=message,
+                )
+            )
 
         return results
 

elspais/trace_view/__init__.py

@@ -13,8 +13,8 @@ Optional dependencies:
 - pip install elspais[trace-review] for review server (requires flask)
 """
 
-from elspais.trace_view.models import TraceViewRequirement, TestInfo, GitChangeInfo
 from elspais.trace_view.generators.base import TraceViewGenerator
+from elspais.trace_view.models import GitChangeInfo, TestInfo, TraceViewRequirement
 
 __all__ = [
     "TraceViewRequirement",
@@ -30,12 +30,14 @@ __all__ = [
 def generate_markdown(requirements, **kwargs):
     """Generate Markdown traceability matrix."""
     from elspais.trace_view.generators.markdown import generate_markdown as _gen
+
     return _gen(requirements, **kwargs)
 
 
 def generate_csv(requirements, **kwargs):
     """Generate CSV traceability matrix."""
     from elspais.trace_view.generators.csv import generate_csv as _gen
+
     return _gen(requirements, **kwargs)
 
 
@@ -48,7 +50,6 @@ def generate_html(requirements, **kwargs):
         from elspais.trace_view.html import HTMLGenerator
     except ImportError as e:
         raise ImportError(
-            "HTML generation requires Jinja2. "
-            "Install with: pip install elspais[trace-view]"
+            "HTML generation requires Jinja2. " "Install with: pip install elspais[trace-view]"
         ) from e
     return HTMLGenerator(requirements, **kwargs).generate()

elspais/trace_view/coverage.py

@@ -5,7 +5,7 @@ Provides functions to calculate implementation coverage and status
 for requirements.
 """
 
-from typing import Dict, List, Union
+from typing import Dict, List
 
 from elspais.trace_view.models import TraceViewRequirement
 
@@ -124,9 +124,7 @@ def get_implementation_status(requirements: ReqDict, req_id: str) -> str:
         return "Partial"
 
 
-def generate_coverage_report(
-    requirements: ReqDict, get_status_fn=None
-) -> str:
+def generate_coverage_report(requirements: ReqDict, get_status_fn=None) -> str:
     """Generate text-based coverage report with summary statistics.
 
     Args:
@@ -141,7 +139,9 @@ def generate_coverage_report(
         - Breakdown by implementation status (Full/Partial/Unimplemented)
     """
     if get_status_fn is None:
-        get_status_fn = lambda req_id: get_implementation_status(requirements, req_id)
+
+        def get_status_fn(req_id):
+            return get_implementation_status(requirements, req_id)
 
     lines = []
     lines.append("=== Coverage Report ===")

elspais/trace_view/generators/__init__.py

@@ -6,7 +6,7 @@ Provides Markdown and CSV generators (no dependencies).
 HTML generator is in the html/ subpackage (requires jinja2).
 """
 
-from elspais.trace_view.generators.markdown import generate_markdown
 from elspais.trace_view.generators.csv import generate_csv
+from elspais.trace_view.generators.markdown import generate_markdown
 
 __all__ = ["generate_markdown", "generate_csv"]

elspais/trace_view/generators/base.py

@@ -9,14 +9,11 @@ requirement parsing, implementation scanning, and output generation.
 from pathlib import Path
 from typing import Dict, List, Optional
 
-from elspais.config.loader import find_config_file, load_config, get_spec_directories
 from elspais.config.defaults import DEFAULT_CONFIG
+from elspais.config.loader import find_config_file, get_spec_directories, load_config
+from elspais.core.git import get_git_changes
 from elspais.core.parser import RequirementParser
 from elspais.core.patterns import PatternConfig
-from elspais.core.git import get_git_changes, GitChangeInfo
-
-from elspais.trace_view.models import TraceViewRequirement, GitChangeInfo as TVGitChangeInfo
-from elspais.trace_view.scanning import scan_implementation_files
 from elspais.trace_view.coverage import (
     calculate_coverage,
     generate_coverage_report,
@@ -24,6 +21,9 @@ from elspais.trace_view.coverage import (
 )
 from elspais.trace_view.generators.csv import generate_csv, generate_planning_csv
 from elspais.trace_view.generators.markdown import generate_markdown
+from elspais.trace_view.models import GitChangeInfo as TVGitChangeInfo
+from elspais.trace_view.models import TraceViewRequirement
+from elspais.trace_view.scanning import scan_implementation_files
 
 
 class TraceViewGenerator:
@@ -93,7 +93,7 @@ class TraceViewGenerator:
 
         # Parse requirements
         if not quiet:
-            print(f"Scanning for requirements...")
+            print("Scanning for requirements...")
         self._parse_requirements(quiet)
 
         if not self.requirements:
@@ -187,9 +187,7 @@ class TraceViewGenerator:
 
             # Report branch changes vs main
             if not quiet and git_changes.branch_changed_files:
-                spec_branch = [
-                    f for f in git_changes.branch_changed_files if f.startswith("spec/")
-                ]
+                spec_branch = [f for f in git_changes.branch_changed_files if f.startswith("spec/")]
                 if spec_branch:
                     print(f"Spec files changed vs main: {len(spec_branch)}")
 
@@ -298,7 +296,9 @@ class TraceViewGenerator:
                     cycle_count += 1
 
         if not quiet and cycle_count > 0:
-            print(f"   Warning: {cycle_count} requirements marked as cyclic (shown as orphaned items)")
+            print(
+                f"   Warning: {cycle_count} requirements marked as cyclic (shown as orphaned items)"
+            )
 
     def _calculate_base_path(self, output_file: Path):
         """Calculate relative path from output file location to repo root."""
@@ -320,8 +320,13 @@ class TraceViewGenerator:
 
     def generate_planning_csv(self) -> str:
         """Generate planning CSV with actionable requirements."""
-        get_status = lambda req_id: get_implementation_status(self.requirements, req_id)
-        calc_coverage = lambda req_id: calculate_coverage(self.requirements, req_id)
+
+        def get_status(req_id):
+            return get_implementation_status(self.requirements, req_id)
+
+        def calc_coverage(req_id):
+            return calculate_coverage(self.requirements, req_id)
+
         return generate_planning_csv(self.requirements, get_status, calc_coverage)
 
     def generate_coverage_report(self) -> str:

elspais/trace_view/generators/csv.py

@@ -90,14 +90,10 @@ def generate_planning_csv(
     writer = csv.writer(output)
 
     # Header
-    writer.writerow(
-        ["REQ ID", "Title", "Level", "Status", "Impl Status", "Coverage", "Code Refs"]
-    )
+    writer.writerow(["REQ ID", "Title", "Level", "Status", "Impl Status", "Coverage", "Code Refs"])
 
     # Filter to actionable requirements (Active or Draft status)
-    actionable_reqs = [
-        req for req in requirements.values() if req.status in ["Active", "Draft"]
-    ]
+    actionable_reqs = [req for req in requirements.values() if req.status in ["Active", "Draft"]]
 
     # Sort by ID
     actionable_reqs.sort(key=lambda r: r.id)

elspais/trace_view/generators/markdown.py

@@ -8,8 +8,8 @@ import sys
 from datetime import datetime
 from typing import Dict, List, Optional
 
-from elspais.trace_view.models import TraceViewRequirement
 from elspais.trace_view.coverage import count_by_level, find_orphaned_requirements
+from elspais.trace_view.models import TraceViewRequirement
 
 
 def generate_legend_markdown() -> str:
@@ -83,9 +83,7 @@ def generate_markdown(
         lines.append("\n## Orphaned Requirements\n")
         lines.append("*(Requirements not linked from any parent)*\n")
         for req in orphaned:
-            lines.append(
-                f"- **REQ-{req.id}**: {req.title} ({req.level}) - {req.display_filename}"
-            )
+            lines.append(f"- **REQ-{req.id}**: {req.title} ({req.level}) - {req.display_filename}")
 
     return "\n".join(lines)
 
@@ -117,10 +115,7 @@ def format_req_tree_md(
         cycle_path = ancestor_path + [req.id]
         cycle_str = " -> ".join([f"REQ-{rid}" for rid in cycle_path])
         print(f"Warning: CYCLE DETECTED: {cycle_str}", file=sys.stderr)
-        return (
-            "  " * indent
-            + f"- **CYCLE DETECTED**: REQ-{req.id} (path: {cycle_str})"
-        )
+        return "  " * indent + f"- **CYCLE DETECTED**: REQ-{req.id} (path: {cycle_str})"
 
     # Safety depth limit
     MAX_DEPTH = 50

elspais/trace_view/html/__init__.py

@@ -5,9 +5,11 @@ elspais.trace_view.html - Interactive HTML generation.
 Requires: pip install elspais[trace-view]
 """
 
+
 def _check_jinja2():
     try:
         import jinja2  # noqa: F401
+
         return True
     except ImportError:
         return False
@@ -17,6 +19,7 @@ JINJA2_AVAILABLE = _check_jinja2()
 
 if JINJA2_AVAILABLE:
     from elspais.trace_view.html.generator import HTMLGenerator
+
     __all__ = ["HTMLGenerator", "JINJA2_AVAILABLE"]
 else:
     __all__ = ["JINJA2_AVAILABLE"]
@@ -26,6 +29,5 @@ else:
 
         def __init__(self, *args, **kwargs):
             raise ImportError(
-                "HTMLGenerator requires Jinja2. "
-                "Install with: pip install elspais[trace-view]"
+                "HTMLGenerator requires Jinja2. " "Install with: pip install elspais[trace-view]"
             )