lithermes-ai 0.8.4 → 0.8.5

package/assets/lithermes-plugin/__init__.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import argparse
 import functools
 from pathlib import Path
 from typing import Any
@@ -116,16 +117,40 @@ def _pre_llm_call(**kwargs: Any) -> dict[str, str] | None:
 
 
 def _setup_lithermes_cli(parser) -> None:
+    try:
+        parser.formatter_class = argparse.RawDescriptionHelpFormatter
+    except Exception:
+        pass
+    parser.description = "LitHermes — Hermes-native Litwork toolkit (litgoal runtime, skills, hooks)."
+    parser.epilog = (
+        "slash commands: /lit /lit-loop /lit-plan /litgoal /review-work /start-work /deep-interview\n"
+        "skills: 20 lithermes:* skills — `hermes lithermes status` lists them\n"
+        "hooks: pre_llm_call, subagent_stop, transform_llm_output\n"
+        "run `hermes lithermes status` for versions + full surface, or `doctor` for health checks"
+    )
+    parser.add_argument("--version", action="store_true", help="print the LitHermes plugin version")
     sub = parser.add_subparsers(dest="lh_cmd")
+    sub.add_parser("version", help="print the LitHermes plugin version")
+    sub.add_parser("status", help="show LitHermes + Hermes versions, hooks, commands, skills")
+    sub.add_parser("doctor", help="run LitHermes health checks")
     goal_parser = sub.add_parser("goal", help="LitHermes litgoal durable runtime")
     litgoal_cli.setup(goal_parser)
 
 
 def _handle_lithermes_cli(args) -> int:
-    if getattr(args, "lh_cmd", None) == "goal":
+    cmd = getattr(args, "lh_cmd", None)
+    if getattr(args, "version", False) or cmd == "version":
+        print(core.version_line())
+        return 0
+    if cmd == "doctor":
+        lines, code = core.doctor_report()
+        print("\n".join(lines))
+        return code
+    if cmd == "goal":
         return litgoal_cli.handle(args)
-    print("usage: hermes lithermes goal <set|status|criterion|evidence|steer|checkpoint|complete>")
-    return 1
+    # status, or bare `hermes lithermes` → the most useful "who am I" answer
+    print(core.status_report())
+    return 0
 
 
 def _ignited(handler):

package/assets/lithermes-plugin/core.py

@@ -981,3 +981,107 @@ def command_start_work(raw_args: str) -> str | dict[str, str]:
         "display": display,
         "agent_message": build_run_agent_message(load_run_state(run_dir)),
     }
+
+
+# ---------------------------------------------------------------------------
+# Management / diagnostics surface (hermes lithermes version|status|doctor).
+# Hermes plugins otherwise can't answer "who am I and what version" — these
+# helpers back the CLI subcommands wired in __init__.py.
+# ---------------------------------------------------------------------------
+
+PLUGIN_ROOT = Path(__file__).resolve().parent
+# These mirror what register()/register_hook()/litgoal tools wire up in __init__.py.
+# They are hardcoded (not introspected) so `status` works without a live ctx —
+# keep them in sync when adding a hook / slash command / goal tool.
+HOOKS = ("pre_llm_call", "subagent_stop", "transform_llm_output")
+SLASH_COMMANDS = (
+    "lit", "lit-loop", "lit-plan", "litgoal", "review-work",
+    "start-work", "deep-interview", "litwork-loop", "litwork-plan",
+)
+GOAL_TOOLS = (
+    "goal_set", "goal_status", "goal_add_criterion", "goal_evidence",
+    "goal_criterion_status", "goal_steer", "goal_checkpoint", "goal_complete",
+)
+_VERSION_RE = re.compile(r"^version:\s*(.+)$", re.MULTILINE)
+
+
+def plugin_version() -> str:
+    """Read the LitHermes plugin version from the bundled plugin.yaml."""
+    try:
+        m = _VERSION_RE.search((PLUGIN_ROOT / "plugin.yaml").read_text(encoding="utf-8"))
+        return m.group(1).strip().strip("\"'") if m else "unknown"
+    except (OSError, ValueError):
+        return "unknown"
+
+
+def hermes_host_version() -> str:
+    """Best-effort Hermes host runtime version (unknown outside Hermes)."""
+    try:
+        import hermes_cli
+        return str(getattr(hermes_cli, "__version__", "") or "unknown")
+    except Exception:
+        return "unknown"
+
+
+def version_line() -> str:
+    return f"lithermes {plugin_version()}"
+
+
+def _evidence_kinds() -> tuple[str, ...]:
+    try:
+        from .litgoal import model
+        return tuple(model.EVIDENCE_KINDS)
+    except Exception:
+        return ("red", "green", "scenario", "cleanup", "note")
+
+
+def _skill_names() -> list[str]:
+    skills_dir = PLUGIN_ROOT / "skills"
+    if not skills_dir.is_dir():
+        return []
+    return sorted(d.name for d in skills_dir.iterdir() if (d / "SKILL.md").is_file())
+
+
+def status_report() -> str:
+    """One-glance health/identity line for `hermes lithermes status`."""
+    skills = _skill_names()
+    return "\n".join([
+        f"LitHermes plugin {plugin_version()}   (Hermes host {hermes_host_version()})",
+        f"plugin dir: {PLUGIN_ROOT}",
+        f"hooks ({len(HOOKS)}): {', '.join(HOOKS)}",
+        f"slash commands ({len(SLASH_COMMANDS)}): {', '.join('/' + c for c in SLASH_COMMANDS)}",
+        f"skills ({len(skills)}): {', '.join(skills)}",
+        f"goal tools ({len(GOAL_TOOLS)}): {', '.join(GOAL_TOOLS)}",
+        "litgoal state: .hermes/lithermes/litgoal/   (drive via: hermes lithermes goal status)",
+        f"litgoal evidence kinds: {', '.join(_evidence_kinds())}",
+    ])
+
+
+def doctor_report() -> tuple[list[str], int]:
+    """Health checks for `hermes lithermes doctor`. Returns (lines, exit_code)."""
+    lines: list[str] = []
+    ok = True
+    ver = plugin_version()
+    if ver != "unknown":
+        lines.append(f"[OK] plugin.yaml readable (version {ver})")
+    else:
+        lines.append("[WARN] plugin.yaml unreadable or missing a version field")
+        ok = False
+    skills = _skill_names()
+    if skills:
+        lines.append(f"[OK] skills bundled: {len(skills)}")
+    else:
+        lines.append("[WARN] no skills found under skills/")
+        ok = False
+    try:
+        from .litgoal import runtime as _rt  # noqa: F401
+        lines.append("[OK] litgoal durable runtime importable")
+    except Exception as exc:
+        lines.append(f"[WARN] litgoal runtime import failed: {exc}")
+        ok = False
+    hv = hermes_host_version()
+    if hv != "unknown":
+        lines.append(f"[OK] Hermes host detected (v{hv})")
+    else:
+        lines.append("[NOTE] Hermes host version unknown (running outside Hermes?)")
+    return lines, (0 if ok else 1)

package/assets/lithermes-plugin/payload-version.json

@@ -1,7 +1,7 @@
 {
-  "syncedAt": "2026-06-15T16:11:22.931Z",
+  "syncedAt": "2026-06-15T16:35:55.443Z",
   "source": "source-reference",
-  "sourceHash": "f3b078782aebeb3fea0953852a6e0d93060fe99837c752ac8fd953e15d122ad3",
+  "sourceHash": "c93c37881e1f6f5730a1adc6c0e62e4dfab1ca44146eed900b8468448438fe8a",
   "files": [
     {
       "path": "NOTICE.md",
@@ -13,11 +13,11 @@
     },
     {
       "path": "__init__.py",
-      "sha256": "bb9afee42ee939600aa35324475529c397e612de824bca2c4d64f641281f56fa"
+      "sha256": "96b816aee730ea9a5e1fedbc283829240baffddecc37872e4f60bb05f420366c"
     },
     {
       "path": "core.py",
-      "sha256": "6b9d8b488d5905232d170f78943d2b5f9b9a4bde564e01a816c4fcc45098a7df"
+      "sha256": "70ddccfb4cc2fe1a923a5a61244e5cb36ef8ac0f94d34a76703fa6d82dbabf3f"
     },
     {
       "path": "litgoal/__init__.py",
@@ -49,7 +49,7 @@
     },
     {
       "path": "plugin.yaml",
-      "sha256": "defb9a36febe6f1bf8ca2654e0e93eb236420267c9a2abd52e6869fa47f8fc9c"
+      "sha256": "7761c417acfcd614e8d434b3ca11c498f48422a72f5b70f817a59326aca51b60"
     },
     {
       "path": "skills/ai-slop-remover/SKILL.md",

package/assets/lithermes-plugin/plugin.yaml

@@ -1,5 +1,5 @@
 name: lithermes
-version: 0.8.4
+version: 0.8.5
 description: "Hermes-native workflow toolkit: litgoal durable runtime, 5-lane review orchestrator, Litwork commands, skills, and prompt steering."
 author: "Hermes Agent"
 kind: standalone

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lithermes-ai",
-  "version": "0.8.4",
+  "version": "0.8.5",
   "description": "npx/bunx installer for the LitHermes Hermes plugin",
   "license": "MIT",
   "repository": {