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

elspais/reformat/line_breaks.py

@@ -26,7 +26,7 @@ def normalize_line_breaks(content: str, reflow: bool = True) -> str:
     Returns:
         Content with normalized line breaks
     """
-    lines = content.split('\n')
+    lines = content.split("\n")
     result_lines: List[str] = []
 
     i = 0
@@ -34,14 +34,14 @@ def normalize_line_breaks(content: str, reflow: bool = True) -> str:
         line = lines[i]
 
         # Check if this is a section header (## Something)
-        if re.match(r'^##\s+\w', line):
+        if re.match(r"^##\s+\w", line):
             result_lines.append(line)
             # Skip blank lines immediately after section header
             i += 1
-            while i < len(lines) and lines[i].strip() == '':
+            while i < len(lines) and lines[i].strip() == "":
                 i += 1
             # Add single blank line after header for readability
-            result_lines.append('')
+            result_lines.append("")
             continue
 
         # Check if this starts a paragraph that might need reflowing
@@ -52,9 +52,11 @@ def normalize_line_breaks(content: str, reflow: bool = True) -> str:
             while i < len(lines):
                 next_line = lines[i]
                 # Stop at blank lines, structural elements, or next section
-                if (next_line.strip() == '' or
-                    _is_structural_line(next_line) or
-                    re.match(r'^##\s+', next_line)):
+                if (
+                    next_line.strip() == ""
+                    or _is_structural_line(next_line)
+                    or re.match(r"^##\s+", next_line)
+                ):
                     break
                 para_lines.append(next_line.rstrip())
                 i += 1
@@ -69,7 +71,7 @@ def normalize_line_breaks(content: str, reflow: bool = True) -> str:
         i += 1
 
     # Clean up multiple consecutive blank lines
-    return _collapse_blank_lines('\n'.join(result_lines))
+    return _collapse_blank_lines("\n".join(result_lines))
 
 
 def _is_structural_line(line: str) -> bool:
@@ -89,35 +91,35 @@ def _is_structural_line(line: str) -> bool:
         return False
 
     # Headers
-    if stripped.startswith('#'):
+    if stripped.startswith("#"):
         return True
 
     # Lettered assertions (A. B. C. etc)
-    if re.match(r'^[A-Z]\.\s', stripped):
+    if re.match(r"^[A-Z]\.\s", stripped):
         return True
 
     # Numbered lists (1. 2. 3. etc)
-    if re.match(r'^\d+\.\s', stripped):
+    if re.match(r"^\d+\.\s", stripped):
         return True
 
     # Bullet points
-    if stripped.startswith(('- ', '* ', '+ ')):
+    if stripped.startswith(("- ", "* ", "+ ")):
         return True
 
     # Metadata line
-    if stripped.startswith('**Level**:') or stripped.startswith('**Status**:'):
+    if stripped.startswith("**Level**:") or stripped.startswith("**Status**:"):
         return True
 
     # Combined metadata line
-    if re.match(r'\*\*Level\*\*:', stripped):
+    if re.match(r"\*\*Level\*\*:", stripped):
         return True
 
     # End marker
-    if stripped.startswith('*End*'):
+    if stripped.startswith("*End*"):
         return True
 
     # Code fence
-    if stripped.startswith('```'):
+    if stripped.startswith("```"):
         return True
 
     return False
@@ -134,15 +136,15 @@ def _reflow_paragraph(lines: List[str]) -> str:
         Single reflowed line
     """
     if not lines:
-        return ''
+        return ""
 
     if len(lines) == 1:
         return lines[0]
 
     # Join lines with space, collapsing multiple spaces
-    joined = ' '.join(line.strip() for line in lines if line.strip())
+    joined = " ".join(line.strip() for line in lines if line.strip())
     # Collapse multiple spaces
-    return re.sub(r'\s+', ' ', joined)
+    return re.sub(r"\s+", " ", joined)
 
 
 def _collapse_blank_lines(content: str) -> str:
@@ -156,14 +158,10 @@ def _collapse_blank_lines(content: str) -> str:
         Content with at most one blank line between paragraphs
     """
     # Replace 3+ newlines with 2 newlines (one blank line)
-    return re.sub(r'\n{3,}', '\n\n', content)
+    return re.sub(r"\n{3,}", "\n\n", content)
 
 
-def fix_requirement_line_breaks(
-    body: str,
-    rationale: str,
-    reflow: bool = True
-) -> Tuple[str, str]:
+def fix_requirement_line_breaks(body: str, rationale: str, reflow: bool = True) -> Tuple[str, str]:
     """
     Fix line breaks in requirement body and rationale.
 
@@ -175,8 +173,8 @@ def fix_requirement_line_breaks(
     Returns:
         Tuple of (fixed_body, fixed_rationale)
     """
-    fixed_body = normalize_line_breaks(body, reflow=reflow) if body else ''
-    fixed_rationale = normalize_line_breaks(rationale, reflow=reflow) if rationale else ''
+    fixed_body = normalize_line_breaks(body, reflow=reflow) if body else ""
+    fixed_rationale = normalize_line_breaks(rationale, reflow=reflow) if rationale else ""
 
     return fixed_body, fixed_rationale
 
@@ -188,15 +186,15 @@ def detect_line_break_issues(content: str) -> List[str]:
     Returns list of issues found for reporting.
     """
     issues = []
-    lines = content.split('\n')
+    lines = content.split("\n")
 
     for i, line in enumerate(lines):
         # Check for blank line after section header
-        if re.match(r'^##\s+\w', line):
+        if re.match(r"^##\s+\w", line):
             # Look ahead for multiple blank lines
             blank_count = 0
             j = i + 1
-            while j < len(lines) and lines[j].strip() == '':
+            while j < len(lines) and lines[j].strip() == "":
                 blank_count += 1
                 j += 1
             if blank_count > 1:
@@ -206,15 +204,15 @@ def detect_line_break_issues(content: str) -> List[str]:
 
         # Check for mid-sentence line break (line ends without punctuation)
         stripped = line.rstrip()
-        if (stripped and
-            not _is_structural_line(line) and
-            i + 1 < len(lines) and
-            lines[i + 1].strip() and
-            not _is_structural_line(lines[i + 1])):
+        if (
+            stripped
+            and not _is_structural_line(line)
+            and i + 1 < len(lines)
+            and lines[i + 1].strip()
+            and not _is_structural_line(lines[i + 1])
+        ):
             # Line ends with a word (not punctuation), followed by non-empty line
             if stripped and stripped[-1].isalnum():
-                issues.append(
-                    f"Line {i+1}: Possible mid-sentence line break"
-                )
+                issues.append(f"Line {i+1}: Possible mid-sentence line break")
 
     return issues

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"]