@grifhinz/logics-manager 2.0.4 → 2.0.5

package/logics_manager/sync.py

@@ -10,6 +10,7 @@ from pathlib import Path
 
 from .config import find_repo_root
 from .lint import expected_workflow_mermaid_signature
+from .termstyle import colorize_help
 
 
 @dataclass(frozen=True)
@@ -499,6 +500,137 @@ def build_parser() -> argparse.ArgumentParser:
     return parser
 
 
+def _build_help() -> str:
+    return "\n".join(
+        [
+            "Logics Sync CLI",
+            "Manage workflow transitions and exports.",
+            "",
+            "Usage:",
+            "  logics-manager sync <command> [args...]",
+            "",
+            "Commands:",
+            "  close-eligible-requests",
+            "    Auto-close requests when all linked backlog items are done.",
+            "    Flags: --format {text,json}, --dry-run",
+            "",
+            "  refresh-mermaid-signatures",
+            "    Refresh stale Mermaid signatures without rewriting diagram bodies.",
+            "    Flags: --format {text,json}, --dry-run",
+            "",
+            "  schema-status [sources...]",
+            "    Report schema-version coverage for selected workflow docs.",
+            "    Flags: --format {text,json}",
+            "",
+            "  context-pack <ref>",
+            "    Build a compact JSON context pack from workflow docs.",
+            "    Flags: --mode {summary-only,diff-first,full}, --profile {tiny,normal,deep}, --out, --format {text,json}, --dry-run",
+            "",
+            "  export-graph",
+            "    Export workflow relationships as a machine-readable graph.",
+            "    Flags: --out, --format {text,json}, --dry-run",
+            "",
+            "Examples:",
+            "  logics-manager sync schema-status",
+            "  logics-manager sync context-pack req_001_my_request --out logics/context-pack.json",
+            "  logics-manager sync export-graph --format json",
+        ]
+    )
+
+
+def _build_subcommand_help(command: str) -> str:
+    if command == "close-eligible-requests":
+        return "\n".join(
+            [
+                "Logics Sync Close Eligible Requests",
+                "Auto-close requests when all linked backlog items are done.",
+                "",
+                "Usage:",
+                "  logics-manager sync close-eligible-requests [args...]",
+                "",
+                "Flags:",
+                "  --format {text,json}",
+                "  --dry-run",
+                "",
+                "Example:",
+                "  logics-manager sync close-eligible-requests --dry-run",
+            ]
+        )
+    if command == "refresh-mermaid-signatures":
+        return "\n".join(
+            [
+                "Logics Sync Refresh Mermaid Signatures",
+                "Refresh stale workflow Mermaid signatures without rewriting diagram bodies.",
+                "",
+                "Usage:",
+                "  logics-manager sync refresh-mermaid-signatures [args...]",
+                "",
+                "Flags:",
+                "  --format {text,json}",
+                "  --dry-run",
+            ]
+        )
+    if command == "schema-status":
+        return "\n".join(
+            [
+                "Logics Sync Schema Status",
+                "Report schema-version coverage for workflow docs.",
+                "",
+                "Usage:",
+                "  logics-manager sync schema-status [sources...]",
+                "",
+                "Flags:",
+                "  --format {text,json}",
+                "",
+                "Example:",
+                "  logics-manager sync schema-status logics/request",
+            ]
+        )
+    if command == "context-pack":
+        return "\n".join(
+            [
+                "Logics Sync Context Pack",
+                "Build a compact JSON context pack from workflow docs.",
+                "",
+                "Usage:",
+                "  logics-manager sync context-pack <ref> [args...]",
+                "",
+                "Flags:",
+                "  --mode {summary-only,diff-first,full}",
+                "  --profile {tiny,normal,deep}",
+                "  --out",
+                "  --format {text,json}",
+                "  --dry-run",
+                "",
+                "Example:",
+                "  logics-manager sync context-pack req_001_my_request --out logics/context-pack.json",
+            ]
+        )
+    if command == "export-graph":
+        return "\n".join(
+            [
+                "Logics Sync Export Graph",
+                "Export workflow relationships as a machine-readable graph.",
+                "",
+                "Usage:",
+                "  logics-manager sync export-graph [args...]",
+                "",
+                "Flags:",
+                "  --out",
+                "  --format {text,json}",
+                "  --dry-run",
+                "",
+                "Example:",
+                "  logics-manager sync export-graph --format json",
+            ]
+        )
+    return _build_help()
+
+
+def _print_help(text: str) -> None:
+    print(colorize_help(text))
+
+
 def cmd_close_eligible_requests(args: argparse.Namespace) -> dict[str, object]:
     repo_root = _find_repo_root(Path.cwd())
     scanned, closed = _close_eligible_requests(repo_root, args.dry_run)
@@ -598,6 +730,12 @@ def cmd_export_graph(args: argparse.Namespace) -> dict[str, object]:
 
 
 def main(argv: list[str]) -> int:
+    if not argv or argv[0] in ("-h", "--help"):
+        _print_help(_build_help())
+        return 0
+    if argv[0] in {"close-eligible-requests", "refresh-mermaid-signatures", "schema-status", "context-pack", "export-graph"} and len(argv) > 1 and argv[1] in ("-h", "--help"):
+        _print_help(_build_subcommand_help(argv[0]))
+        return 0
     parser = build_parser()
     args = parser.parse_args(argv)
     payload = args.func(args)

package/logics_manager/termstyle.py

@@ -0,0 +1,75 @@
+from __future__ import annotations
+
+import os
+import re
+import sys
+
+
+RESET = "\033[0m"
+BOLD = "\033[1m"
+CYAN = "\033[36m"
+GREEN = "\033[32m"
+YELLOW = "\033[33m"
+MAGENTA = "\033[35m"
+BLUE = "\033[34m"
+RED = "\033[31m"
+
+
+def _color_mode() -> str:
+    value = os.environ.get("LOGICS_MANAGER_COLOR", "auto").strip().lower()
+    if value in {"always", "auto", "never"}:
+        return value
+    return "auto"
+
+
+def supports_color(stream=None) -> bool:
+    if stream is None:
+        stream = sys.stdout
+    mode = _color_mode()
+    if mode == "always":
+        return True
+    if mode == "never" or os.environ.get("NO_COLOR") is not None:
+        return False
+    return bool(getattr(stream, "isatty", lambda: False)())
+
+
+def wrap(text: str, *codes: str) -> str:
+    if not codes:
+        return text
+    return f"{''.join(codes)}{text}{RESET}"
+
+
+_TITLE_RE = re.compile(r"^Logics .* CLI$")
+_SECTION_RE = re.compile(r"^(Usage|Commands|Kinds|Top-level options|Runtime and diagnostics|Review and governance|Context and prompts|Examples|Flags):$")
+_COMMAND_RE = re.compile(r"^\s{2,}[a-z][a-z0-9-]*(?:\s|$)")
+_FLAG_LINE_RE = re.compile(r"^\s{4,}--")
+_EXAMPLE_RE = re.compile(r"^\s{2,}logics-manager\b")
+
+
+def colorize_help(text: str) -> str:
+    if not supports_color():
+        return text
+
+    lines: list[str] = []
+    for line in text.splitlines():
+        stripped = line.strip()
+        if not stripped:
+            lines.append(line)
+            continue
+        if _TITLE_RE.match(stripped):
+            lines.append(wrap(line, BOLD, CYAN))
+            continue
+        if _SECTION_RE.match(stripped):
+            lines.append(wrap(line, BOLD, MAGENTA))
+            continue
+        if _EXAMPLE_RE.match(line):
+            lines.append(wrap(line, GREEN))
+            continue
+        if _FLAG_LINE_RE.match(line):
+            lines.append(wrap(line, YELLOW))
+            continue
+        if _COMMAND_RE.match(line):
+            lines.append(wrap(line, BLUE))
+            continue
+        lines.append(line)
+    return "\n".join(lines)

package/package.json

@@ -2,7 +2,7 @@
   "name": "@grifhinz/logics-manager",
   "displayName": "Logics Orchestrator",
   "description": "Visual orchestration for Logics workflows inside VS Code.",
-  "version": "2.0.4",
+  "version": "2.0.5",
   "publisher": "cdx-logics",
   "icon": "media/icon.png",
   "repository": {
@@ -149,6 +149,7 @@
     "@types/vscode": "^1.86.0",
     "@typescript-eslint/eslint-plugin": "^8.58.1",
     "@typescript-eslint/parser": "^8.58.1",
+    "@vscode/vsce": "^3.9.1",
     "@vitest/coverage-v8": "^4.1.2",
     "esbuild": "^0.25.10",
     "eslint": "^10.2.0",

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "logics-manager"
-version = "2.0.4"
+version = "2.0.5"
 description = "Canonical Logics CLI"
 requires-python = ">=3.10"