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

elspais/cli.py

@@ -10,7 +10,7 @@ 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
+from elspais.commands import analyze, changed, config_cmd, edit, hash_cmd, index, init, rules_cmd, trace, validate, reformat_cmd
 
 
 def create_parser() -> argparse.ArgumentParser:
@@ -97,6 +97,12 @@ Examples:
         action="store_true",
         help="Skip test scanning",
     )
+    validate_parser.add_argument(
+        "--mode",
+        choices=["core", "combined"],
+        default="combined",
+        help="core: skip sponsor repos, combined: include all (default: combined)",
+    )
 
     # trace command
     trace_parser = subparsers.add_parser(
@@ -115,6 +121,49 @@ Examples:
         help="Output file path",
         metavar="PATH",
     )
+    # trace-view enhanced options (requires elspais[trace-view])
+    trace_parser.add_argument(
+        "--view",
+        action="store_true",
+        help="Generate interactive HTML traceability view (requires trace-view extra)",
+    )
+    trace_parser.add_argument(
+        "--embed-content",
+        action="store_true",
+        help="Embed full requirement content in HTML output",
+    )
+    trace_parser.add_argument(
+        "--edit-mode",
+        action="store_true",
+        help="Include edit mode UI in HTML output",
+    )
+    trace_parser.add_argument(
+        "--review-mode",
+        action="store_true",
+        help="Include review mode UI in HTML output",
+    )
+    trace_parser.add_argument(
+        "--server",
+        action="store_true",
+        help="Start review server (requires trace-review extra)",
+    )
+    trace_parser.add_argument(
+        "--port",
+        type=int,
+        default=8080,
+        help="Port for review server (default: 8080)",
+    )
+    trace_parser.add_argument(
+        "--mode",
+        choices=["core", "sponsor", "combined"],
+        default="core",
+        help="Report mode: core, sponsor, or combined (default: core)",
+    )
+    trace_parser.add_argument(
+        "--sponsor",
+        help="Sponsor name for sponsor-specific reports",
+        metavar="NAME",
+    )
 
     # hash command
     hash_parser = subparsers.add_parser(
@@ -393,6 +442,53 @@ Examples:
         help="Content rule file name (e.g., 'AI-AGENT.md')",
     )
 
+    # reformat-with-claude command
+    reformat_parser = subparsers.add_parser(
+        "reformat-with-claude",
+        help="Reformat requirements using AI (Acceptance Criteria -> Assertions)",
+    )
+    reformat_parser.add_argument(
+        "--start-req",
+        help="Starting requirement ID (default: all PRD requirements)",
+        metavar="ID",
+    )
+    reformat_parser.add_argument(
+        "--depth",
+        type=int,
+        help="Maximum traversal depth (default: unlimited)",
+    )
+    reformat_parser.add_argument(
+        "--dry-run",
+        action="store_true",
+        help="Preview changes without applying",
+    )
+    reformat_parser.add_argument(
+        "--backup",
+        action="store_true",
+        help="Create .bak files before editing",
+    )
+    reformat_parser.add_argument(
+        "--force",
+        action="store_true",
+        help="Reformat even if already in new format",
+    )
+    reformat_parser.add_argument(
+        "--fix-line-breaks",
+        action="store_true",
+        help="Normalize line breaks (remove extra blank lines)",
+    )
+    reformat_parser.add_argument(
+        "--line-breaks-only",
+        action="store_true",
+        help="Only fix line breaks, skip AI-based reformatting",
+    )
+    reformat_parser.add_argument(
+        "--mode",
+        choices=["combined", "core-only", "local-only"],
+        default="combined",
+        help="Which repos to include in hierarchy (default: combined)",
+    )
+
     # mcp command
     mcp_parser = subparsers.add_parser(
         "mcp",
@@ -489,6 +585,8 @@ def main(argv: Optional[List[str]] = None) -> int:
             return config_cmd.run(args)
         elif args.command == "rules":
             return rules_cmd.run(args)
+        elif args.command == "reformat-with-claude":
+            return reformat_cmd.run(args)
         elif args.command == "mcp":
             return mcp_command(args)
         else:

elspais/commands/hash_cmd.py

@@ -104,8 +104,16 @@ def run_update(args: argparse.Namespace) -> int:
     else:
         print(f"Updating {len(updates)} hashes...")
         for req_id, req, new_hash in updates:
-            update_hash_in_file(req, new_hash)
-            print(f"  ✓ {req_id}")
+            result = update_hash_in_file(req, new_hash)
+            if result['updated']:
+                print(f"  ✓ {req_id}")
+                old_hash = result['old_hash'] or "(none)"
+                print(f"    [INFO] Hash: {old_hash} -> {result['new_hash']}")
+                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")
 
     return 0
 
@@ -138,37 +146,75 @@ def load_requirements(args: argparse.Namespace) -> tuple:
     return config, requirements
 
 
-def update_hash_in_file(req: Requirement, new_hash: str) -> None:
+def update_hash_in_file(req: Requirement, new_hash: str) -> dict:
     """Update the hash in the requirement's source file.
 
-    The replacement is scoped to the specific requirement's end marker
-    (identified by title) to avoid accidentally updating other requirements
-    in the same file that might have the same hash value.
+    Finds the End marker by the old hash value, then replaces the entire line
+    with the correct title and new hash. This handles cases where the End
+    marker title doesn't match the header title.
+
+    Args:
+        req: Requirement object with file_path, title, and hash
+        new_hash: New hash value to write
+
+    Returns:
+        Dict with change info:
+          - 'updated': bool - whether file was modified
+          - 'old_hash': str - previous hash (or None)
+          - 'new_hash': str - new hash value
+          - 'title_fixed': bool - whether title was corrected
+          - 'old_title': str - previous title (if different)
     """
+    import re
+
+    result = {
+        'updated': False,
+        'old_hash': req.hash,
+        'new_hash': new_hash,
+        'title_fixed': False,
+        'old_title': None,
+    }
+
     if not req.file_path:
-        return
+        return result
 
     content = req.file_path.read_text(encoding="utf-8")
-
-    import re
+    new_end_line = f"*End* *{req.title}* | **Hash**: {new_hash}"
 
     if req.hash:
-        # Replace existing hash - SCOPED to this requirement's end marker
-        # Match: *End* *Title* | **Hash**: oldhash
-        # Replace hash only for THIS requirement (identified by title)
-        content = re.sub(
-            rf"(\*End\*\s+\*{re.escape(req.title)}\*\s*\|\s*)\*\*Hash\*\*:\s*{re.escape(req.hash)}",
-            rf"\1**Hash**: {new_hash}",
-            content,
-        )
+        # Strategy: Try title first (most specific), then hash if title not found
+        # 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*$"
+        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
+        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*$"
+            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
+
+                # 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
     else:
-        # Add hash to end marker
+        # Add hash to end marker (no existing hash)
         # Pattern: *End* *Title* (without hash)
-        # Add: | **Hash**: XXXX
-        content = re.sub(
-            rf"(\*End\*\s+\*{re.escape(req.title)}\*)(?!\s*\|\s*\*\*Hash\*\*)",
-            rf"\1 | **Hash**: {new_hash}",
-            content,
-        )
-
-    req.file_path.write_text(content, encoding="utf-8")
+        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
+
+    if result['updated']:
+        req.file_path.write_text(content, encoding="utf-8")
+
+    return result