@grifhinz/logics-manager 2.1.2 → 2.3.0

package/logics_manager/cli.py

@@ -11,11 +11,16 @@ from .bootstrap import bootstrap_payload, render_bootstrap
 from .assist import main as assist_main
 from .audit import audit_payload, build_parser as build_audit_parser
 from .audit import render_audit
+from .cli_output import render_payload
 from .config import ConfigError, find_repo_root, render_config_show
 from .index import index_payload, render_index
+from .insights import followups_payload, health_payload, render_followups, render_health, render_status, status_payload
+from .insights import product_consistency_payload, render_product_consistency
 from .lint import lint_payload, render_lint
+from .sync import search_logics_docs_payload
 from .doctor import render_doctor
 from .termstyle import colorize_help
+from .update_check import get_update_notice
 
 
 DEFAULT_SELF_UPDATE_PY_PACKAGE = "logics-manager"
@@ -28,14 +33,30 @@ ROOT_COMMANDS = (
     "assist",
     "audit",
     "index",
+    "health",
+    "followups",
+    "product-consistency",
+    "status",
     "lint",
+    "view",
     "config",
     "doctor",
     "mcp",
     "self-update",
+    "search",
 )
 
 
+def _expand_json_alias(argv: list[str]) -> list[str]:
+    expanded: list[str] = []
+    for arg in argv:
+        if arg == "--json":
+            expanded.extend(["--format", "json"])
+        else:
+            expanded.append(arg)
+    return expanded
+
+
 def _build_root_help() -> str:
     sections = [
         "Logics Manager CLI",
@@ -52,17 +73,24 @@ def _build_root_help() -> str:
         "Common workflows:",
         '  logics-manager flow new request --title "My request"',
         "  logics-manager audit --group-by-doc",
+        "  logics-manager status",
         "  logics-manager sync refresh-mermaid-signatures",
         "  logics-manager mcp tunnel --repo-root . --port 8765",
         "",
         "Workflow authoring:",
         "  flow       Create, promote, split, close, and finish workflow docs.",
-        "             Subcommands: new, list, companion, promote, split, close, finish",
+        "             Subcommands: new, list, companion, deliver, validate-closeout, repair, closeout, promote, split, close, finish",
         "  sync       Maintain generated workflow state and doc metadata.",
         "             Subcommands: close-eligible-requests, refresh-mermaid-signatures,",
         "                          schema-status, read-doc, list-docs, search-docs,",
         "                          update-indicators, append-note, context-pack, export-graph",
         "  index      Generate logics/INDEX.md from the workflow corpus.",
+        "  health     Show workflow health counts and issue signals.",
+        "  followups  List follow-up areas with request creation commands.",
+        "  product-consistency  Check product brief lineage links.",
+        "  status     Summarize open workflow docs and next actions.",
+        "  search     Search workflow docs directly.",
+        "  view       Start a local read-only browser viewer for the Logics corpus.",
         "",
         "Validation:",
         "  lint       Check filenames, headings, indicators, and changed-doc hygiene.",
@@ -105,6 +133,18 @@ def get_cli_version() -> str:
     return "0.0.0"
 
 
+def _is_json_mode(argv: list[str]) -> bool:
+    return "--json" in argv or any(argv[index] == "--format" and index + 1 < len(argv) and argv[index + 1] == "json" for index in range(len(argv)))
+
+
+def _maybe_print_update_notice(command: str, argv: list[str]) -> None:
+    if command in {"self-update", "mcp", "view"} or _is_json_mode(argv) or not sys.stdout.isatty():
+        return
+    notice = get_update_notice(get_cli_version())
+    if notice:
+        print(notice, file=sys.stderr)
+
+
 def main(argv: list[str] | None = None) -> int:
     if argv is None:
         argv = sys.argv[1:]
@@ -118,9 +158,11 @@ def main(argv: list[str] | None = None) -> int:
         print(f"logics-manager {get_cli_version()}")
         return 0
 
+    argv = _expand_json_alias(argv)
     command = argv[0]
     if command not in ROOT_COMMANDS:
         raise SystemExit(f"Unsupported command: {command}")
+    _maybe_print_update_notice(command, argv)
 
     rest = argv[1:]
     if command == "config":
@@ -129,7 +171,7 @@ def main(argv: list[str] | None = None) -> int:
         config_args = rest[1:]
         parser = argparse.ArgumentParser(prog="logics-manager config show", add_help=False)
         parser.add_argument("--format", choices=("text", "json"), default="text")
-        parsed, _unknown = parser.parse_known_args(config_args)
+        parsed = parser.parse_args(config_args)
         repo_root = find_repo_root(Path.cwd())
         try:
             output = render_config_show(repo_root, output_format=parsed.format)
@@ -141,7 +183,7 @@ def main(argv: list[str] | None = None) -> int:
         doctor_args = rest
         parser = argparse.ArgumentParser(prog="logics-manager doctor", add_help=False)
         parser.add_argument("--format", choices=("text", "json"), default="text")
-        parsed, _unknown = parser.parse_known_args(doctor_args)
+        parsed = parser.parse_args(doctor_args)
         repo_root = find_repo_root(Path.cwd())
         try:
             output = render_doctor(repo_root, output_format=parsed.format)
@@ -153,7 +195,7 @@ def main(argv: list[str] | None = None) -> int:
         parser = argparse.ArgumentParser(prog="logics-manager bootstrap", add_help=False)
         parser.add_argument("--check", action="store_true")
         parser.add_argument("--format", choices=("text", "json"), default="text")
-        parsed, _unknown = parser.parse_known_args(rest)
+        parsed = parser.parse_args(rest)
         try:
             repo_root = find_repo_root(Path.cwd())
         except ConfigError:
@@ -167,7 +209,7 @@ def main(argv: list[str] | None = None) -> int:
         parser.add_argument("--package", default=DEFAULT_SELF_UPDATE_PACKAGE)
         parser.add_argument("--python-package", default=DEFAULT_SELF_UPDATE_PY_PACKAGE)
         parser.add_argument("--dry-run", action="store_true")
-        parsed, _unknown = parser.parse_known_args(rest)
+        parsed = parser.parse_args(rest)
 
         manager = parsed.manager
         if manager == "auto":
@@ -196,7 +238,7 @@ def main(argv: list[str] | None = None) -> int:
             target = parsed.python_package if manager == "pip" else parsed.package
             print(f"Updated {target} via {manager}.")
         return result.returncode
-    if command == "flow" and (rest[:1] in (["new"], ["list"], ["companion"], ["promote"], ["split"], ["close"], ["finish"]) or rest[:1] in HELP_ARGV):
+    if command == "flow" and (rest[:1] in (["new"], ["list"], ["companion"], ["deliver"], ["validate-closeout"], ["repair"], ["closeout"], ["promote"], ["split"], ["close"], ["finish"]) or rest[:1] in HELP_ARGV):
         from .flow import main as flow_main
 
         return flow_main(rest)
@@ -207,16 +249,20 @@ def main(argv: list[str] | None = None) -> int:
 
         return sync_main(rest)
     if command == "assist":
-        if rest[:1] not in (["runtime-status"], ["diff-risk"], ["commit-plan"], ["changed-surface-summary"], ["doc-consistency"], ["review-checklist"], ["validation-checklist"], ["validation-summary"], ["test-impact-summary"], ["roi-report"], ["next-step"], ["claude-bridges"], ["claude-instructions"], ["request-draft"], ["spec-first-pass"], ["backlog-groom"], ["closure-summary"], ["context"]) and rest[:1] not in HELP_ARGV:
+        if rest[:1] not in (["runtime-status"], ["diff-risk"], ["commit-plan"], ["changed-surface-summary"], ["doc-consistency"], ["review-checklist"], ["validation-checklist"], ["validation-summary"], ["test-impact-summary"], ["roi-report"], ["next-step"], ["claude-bridges"], ["claude-instructions"], ["request-draft"], ["spec-first-pass"], ["backlog-groom"], ["closure-summary"], ["handoff"], ["context"]) and rest[:1] not in HELP_ARGV:
             raise SystemExit("Unsupported assist subcommand for the native CLI slice.")
         return assist_main(rest)
     if command == "mcp":
         from .mcp import main as mcp_main
 
         return mcp_main(rest)
+    if command == "view":
+        from .viewer import main as viewer_main
+
+        return viewer_main(rest)
     if command == "audit":
         audit_parser = build_audit_parser()
-        parsed, _unknown = audit_parser.parse_known_args(rest)
+        parsed = audit_parser.parse_args(rest)
         repo_root = find_repo_root(Path.cwd())
         try:
             payload = audit_payload(
@@ -253,25 +299,119 @@ def main(argv: list[str] | None = None) -> int:
         except ConfigError as exc:
             raise SystemExit(str(exc)) from exc
         print(output)
-        return 0 if payload["ok"] else 1
+        return 0
     if command == "index":
         parser = argparse.ArgumentParser(prog="logics-manager index", add_help=False)
         parser.add_argument("--out", default="logics/INDEX.md")
         parser.add_argument("--format", choices=("text", "json"), default="text")
-        parsed, _unknown = parser.parse_known_args(rest)
+        parsed = parser.parse_args(rest)
         repo_root = find_repo_root(Path.cwd())
         try:
             payload = index_payload(repo_root, out=parsed.out)
         except ConfigError as exc:
             raise SystemExit(str(exc)) from exc
-        output = render_index(repo_root, out=parsed.out, output_format=parsed.format) if parsed.format == "json" else f"Wrote {payload['output_path']}"
+        output = render_payload(payload, parsed.format, f"Wrote {payload['output_path']}")
         print(output)
         return 0 if payload["ok"] else 1
+    if command == "status":
+        parser = argparse.ArgumentParser(prog="logics-manager status", add_help=False)
+        parser.add_argument("--limit", type=int, default=10)
+        parser.add_argument("--format", choices=("text", "json"), default="text")
+        parsed = parser.parse_args(rest)
+        repo_root = find_repo_root(Path.cwd())
+        try:
+            payload = status_payload(repo_root, limit=parsed.limit)
+            output = render_status(repo_root, output_format=parsed.format, limit=parsed.limit)
+        except ConfigError as exc:
+            raise SystemExit(str(exc)) from exc
+        print(output)
+        return 0
+    if command == "health":
+        parser = argparse.ArgumentParser(prog="logics-manager health", add_help=False)
+        parser.add_argument("--limit", type=int, default=10)
+        parser.add_argument("--format", choices=("text", "json"), default="text")
+        parsed = parser.parse_args(rest)
+        repo_root = find_repo_root(Path.cwd())
+        try:
+            payload = health_payload(repo_root, limit=parsed.limit)
+            output = render_health(repo_root, output_format=parsed.format, limit=parsed.limit)
+        except ConfigError as exc:
+            raise SystemExit(str(exc)) from exc
+        print(output)
+        return 0
+    if command == "followups":
+        parser = argparse.ArgumentParser(prog="logics-manager followups", add_help=False)
+        parser.add_argument("--limit", type=int, default=50)
+        parser.add_argument("--source-kind", choices=("all", "request", "backlog", "task", "product", "architecture"), default="all")
+        parser.add_argument("--include-closed", action="store_true")
+        parser.add_argument("--closed-only", action="store_true")
+        parser.add_argument("--format", choices=("text", "json"), default="text")
+        parsed = parser.parse_args(rest)
+        if parsed.include_closed and parsed.closed_only:
+            raise SystemExit("--include-closed and --closed-only are mutually exclusive.")
+        repo_root = find_repo_root(Path.cwd())
+        try:
+            payload = followups_payload(
+                repo_root,
+                limit=parsed.limit,
+                source_kind=parsed.source_kind,
+                include_closed=parsed.include_closed,
+                closed_only=parsed.closed_only,
+            )
+            output = render_followups(
+                repo_root,
+                output_format=parsed.format,
+                limit=parsed.limit,
+                source_kind=parsed.source_kind,
+                include_closed=parsed.include_closed,
+                closed_only=parsed.closed_only,
+            )
+        except ConfigError as exc:
+            raise SystemExit(str(exc)) from exc
+        print(output)
+        return 0 if payload["ok"] else 1
+    if command == "search":
+        parser = argparse.ArgumentParser(prog="logics-manager search", add_help=False)
+        parser.add_argument("query")
+        parser.add_argument("--kind", choices=("all", "request", "backlog", "task"), default="all")
+        parser.add_argument("--status")
+        parser.add_argument("--limit", type=int, default=20)
+        parser.add_argument("--max-snippet-chars", type=int, default=240)
+        parser.add_argument("--format", choices=("text", "json"), default="text")
+        parsed = parser.parse_args(rest)
+        repo_root = find_repo_root(Path.cwd())
+        payload = search_logics_docs_payload(
+            repo_root,
+            parsed.query,
+            kind=parsed.kind,
+            status=parsed.status,
+            limit=parsed.limit,
+            max_snippet_chars=parsed.max_snippet_chars,
+        )
+        if parsed.format == "json":
+            output = render_payload(payload, "json")
+        else:
+            lines = [f"Search `{payload['query']}`: {payload['returned_count']} match(es)"]
+            for match in payload["matches"]:
+                lines.append(f"- {match['ref']}:{match['line']} {match['title']}")
+            output = "\n".join(lines)
+        print(output)
+        return 0
+    if command == "product-consistency":
+        parser = argparse.ArgumentParser(prog="logics-manager product-consistency", add_help=False)
+        parser.add_argument("--limit", type=int, default=50)
+        parser.add_argument("--strict", action="store_true")
+        parser.add_argument("--format", choices=("text", "json"), default="text")
+        parsed = parser.parse_args(rest)
+        repo_root = find_repo_root(Path.cwd())
+        payload = product_consistency_payload(repo_root, limit=parsed.limit)
+        print(render_product_consistency(repo_root, output_format=parsed.format, limit=parsed.limit))
+        return 1 if parsed.strict and not payload["ok"] else 0
     if command == "lint":
         parser = argparse.ArgumentParser(prog="logics-manager lint", add_help=False)
         parser.add_argument("--require-status", action="store_true")
         parser.add_argument("--format", choices=("text", "json"), default="text")
-        parsed, _unknown = parser.parse_known_args(rest)
+        parsed = parser.parse_args(rest)
         repo_root = find_repo_root(Path.cwd())
         try:
             payload = lint_payload(repo_root, require_status=parsed.require_status)

package/logics_manager/cli_output.py

@@ -0,0 +1,18 @@
+from __future__ import annotations
+
+import json
+from typing import Callable
+
+
+def render_payload(payload: dict[str, object], output_format: str, text: str | Callable[[], str] | None = None) -> str:
+    if output_format == "json":
+        return json.dumps(payload, indent=2, sort_keys=True)
+    if callable(text):
+        return text()
+    return text or ""
+
+
+def print_payload(payload: dict[str, object], output_format: str, text: str | Callable[[], str] | None = None) -> None:
+    output = render_payload(payload, output_format, text)
+    if output:
+        print(output)