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

elspais/cli.py

@@ -22,9 +22,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
         """,
     )
 
@@ -64,6 +71,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,7 +101,7 @@ 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(
@@ -101,7 +123,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 +135,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 +152,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 +190,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 +217,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 +233,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 +243,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",
@@ -258,7 +280,7 @@ Examples:
     version_parser.add_argument(
         "check",
         nargs="?",
-        help="Check for updates",
+        help="Check for updates (not yet implemented)",
     )
 
     # init command
@@ -286,6 +308,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 +359,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")
 
@@ -422,7 +455,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")
 

{elspais-0.11.0.dist-info → elspais-0.11.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: elspais
-Version: 0.11.0
+Version: 0.11.1
 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.dist-info → elspais-0.11.1.dist-info}/RECORD

@@ -1,6 +1,6 @@
 elspais/__init__.py,sha256=grQHU0RmRQChHUEb_cH_OuGmxADj5fDSNNayhXEQco4,1014
 elspais/__main__.py,sha256=rCMaObqJeT_6dhyfND7S4dh_lv30j7Ww3Z7992YYwaE,130
-elspais/cli.py,sha256=ZPhYfPednJsLLqIkJOenJ58lEodlsfLVsbmbTz2xdnE,17866
+elspais/cli.py,sha256=v6iFpfLe3_E5m74Hhyudq_qphp6TPSmIEvTI3z5JdmM,19530
 elspais/commands/__init__.py,sha256=jS7ry2ez7xri-fUlYUw9fGKJi5yTHtVN4PU8voHjgLI,155
 elspais/commands/analyze.py,sha256=5hE6YRL8AoAz2ukkR1rj6aiD2TNJi63UHYVJXmKoOUs,7135
 elspais/commands/changed.py,sha256=H0v95I6eXqcYXfqIUHKb3rP_2jMiH52bkXMe0TXM6y8,4872
@@ -94,8 +94,8 @@ elspais/trace_view/specs/tv-d00015-status-modifier.md,sha256=MK7YwLWr0KFZXImJefF
 elspais/trace_view/specs/tv-d00016-js-integration.md,sha256=wofQ4qkCCILpjzFTtAKIwL7FB47KGoPpW9ox2k-BQ7c,1658
 elspais/trace_view/specs/tv-p00001-html-generator.md,sha256=tv4cP0CynaRPxHKTzGN3r9CXqQBbioVX2ESOcOBKnUI,1792
 elspais/trace_view/specs/tv-p00002-review-system.md,sha256=JQJSwNbZ_Hkqk43QQ9JKKhTBsfI0rF1Hp_3RIR6hS-4,1609
-elspais-0.11.0.dist-info/METADATA,sha256=G0pBJOA3mjBhwFEHLxj3kQjpr-Kwgrs7Db_-VkrVrT0,11457
-elspais-0.11.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-elspais-0.11.0.dist-info/entry_points.txt,sha256=yWZZEfn2fBSKSzGoS-fMQ9YoTkyeu6-i7Oht6NsdKpk,45
-elspais-0.11.0.dist-info/licenses/LICENSE,sha256=x_dNMsy_askp2MmKXZFL2bKW_tDiJHcRTyAg0TY1RMI,1063
-elspais-0.11.0.dist-info/RECORD,,
+elspais-0.11.1.dist-info/METADATA,sha256=ysGy8f5kiNLFOeqFbL5EM9Z73OO3-scXK9OqlAQhvoE,11634
+elspais-0.11.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+elspais-0.11.1.dist-info/entry_points.txt,sha256=yWZZEfn2fBSKSzGoS-fMQ9YoTkyeu6-i7Oht6NsdKpk,45
+elspais-0.11.1.dist-info/licenses/LICENSE,sha256=x_dNMsy_askp2MmKXZFL2bKW_tDiJHcRTyAg0TY1RMI,1063
+elspais-0.11.1.dist-info/RECORD,,