lithermes-ai 0.5.0

package/assets/lithermes-plugin/__init__.py

@@ -0,0 +1,179 @@
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Any
+
+from . import core
+from .litgoal import cli as litgoal_cli
+from .litgoal import hook as litgoal_hook
+from .litgoal import tools as litgoal_tools
+
+
+PORTED_SKILLS = [
+    (
+        "ai-slop-remover",
+        "Remove AI-generated slop with the LitHermes cleanup discipline.",
+    ),
+    (
+        "comment-checker",
+        "Review comments after edits using the LitHermes comment policy.",
+    ),
+    (
+        "debugging",
+        "Run the LitHermes hypothesis-driven debugging workflow.",
+    ),
+    (
+        "frontend-ui-ux",
+        "Apply the LitHermes frontend UI/UX review discipline.",
+    ),
+    (
+        "lsp",
+        "Use Hermes' native LSP diagnostics with LitHermes LSP guidance.",
+    ),
+    (
+        "programming",
+        "Use LitHermes programming references for Python, TypeScript, Go, and Rust.",
+    ),
+    (
+        "refactor",
+        "Use the LitHermes refactoring workflow and safety checks.",
+    ),
+    (
+        "remove-ai-slops",
+        "Alias-style access to the LitHermes AI slop removal workflow.",
+    ),
+    (
+        "review-work",
+        "Run the LitHermes 5-lane review orchestrator over delegate_task.",
+    ),
+    (
+        "rules",
+        "Read and apply repo-local Hermes guidance files using the LitHermes rules discipline.",
+    ),
+    (
+        "start-work",
+        "Execute a LitHermes plan checkbox-by-checkbox with test + manual-QA + cleanup gates.",
+    ),
+    (
+        "lit-plan",
+        "Run the LitHermes planning process: explore-first, interview, approval gate, gap-analysis + plan review.",
+    ),
+    (
+        "litgoal",
+        "Drive the LitHermes litgoal durable runtime (criteria, evidence, gates).",
+    ),
+    (
+        "litwork",
+        "Hermes-native Litwork execution discipline.",
+    ),
+]
+
+
+def _pre_llm_call(**kwargs: Any) -> dict[str, str] | None:
+    """Compose the Litwork directive and the active-litgoal snapshot.
+
+    Hermes appends a returned ``{"context": ...}`` to the user message. We merge
+    both injections so the model sees the litwork loop discipline and the live
+    goal/criteria/evidence gate in one block.
+    """
+    parts: list[str] = []
+    base = core.pre_llm_call(**kwargs)
+    if isinstance(base, dict) and base.get("context"):
+        parts.append(str(base["context"]))
+    elif isinstance(base, str) and base.strip():
+        parts.append(base)
+    snapshot = litgoal_hook.snapshot_context(**kwargs)
+    if snapshot:
+        parts.append(snapshot)
+    if not parts:
+        return None
+    return {"context": "\n\n".join(parts)}
+
+
+def _setup_lithermes_cli(parser) -> None:
+    sub = parser.add_subparsers(dest="lh_cmd")
+    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":
+        return litgoal_cli.handle(args)
+    print("usage: hermes lithermes goal <set|status|criterion|evidence|steer|checkpoint|complete>")
+    return 1
+
+
+def register(ctx) -> None:
+    base = Path(__file__).resolve().parent
+
+    # Hooks: Litwork directive + litgoal snapshot/gate, both via pre_llm_call.
+    ctx.register_hook("pre_llm_call", _pre_llm_call)
+    # Record each delegate_task child (review lanes, reviewer gate) to the ledger.
+    ctx.register_hook("subagent_stop", core.subagent_stop)
+
+    # Model-facing litgoal tools (durable criteria/evidence/checkpoint/steering/gate).
+    litgoal_tools.register_tools(ctx)
+
+    # `hermes lithermes goal ...` CLI surface.
+    ctx.register_cli_command(
+        "lithermes",
+        "LitHermes workflow runtime (litgoal durable goal CLI)",
+        _setup_lithermes_cli,
+        _handle_lithermes_cli,
+    )
+
+    ctx.register_command(
+        "lit-plan",
+        core.command_lit_plan,
+        description="Create a durable Litwork implementation plan",
+        args_hint='"what to build"',
+    )
+    ctx.register_command(
+        "litwork-plan",
+        core.command_lit_plan,
+        description="Alias for /lit-plan",
+        args_hint='"what to build"',
+    )
+    ctx.register_command(
+        "lit",
+        core.command_lit,
+        description="Start an Litwork run and execute the task immediately",
+        args_hint='"task" [--completion-promise TEXT] [--strategy reset|continue]',
+    )
+    ctx.register_command(
+        "lit-loop",
+        core.command_lit_loop,
+        description="Start an Litwork run and execute the task immediately",
+        args_hint='"task" [--completion-promise TEXT] [--strategy reset|continue]',
+    )
+    ctx.register_command(
+        "litwork-loop",
+        core.command_lit_loop,
+        description="Alias for /lit-loop",
+        args_hint='"task" [--completion-promise TEXT] [--strategy reset|continue]',
+    )
+    ctx.register_command(
+        "litgoal",
+        core.command_litgoal,
+        description="Open or inspect the LitHermes litgoal durable runtime",
+        args_hint='["objective"] [--worktree PATH]',
+    )
+    ctx.register_command(
+        "review-work",
+        core.command_review_work,
+        description="Run the LitHermes 5-lane review orchestrator on the current diff",
+        args_hint="[--base REF]",
+    )
+    ctx.register_command(
+        "start-work",
+        core.command_start_work,
+        description="Open or dry-run a LitHermes plan against a workspace",
+        args_hint="[plan-name] [--worktree PATH] [--dry-run]",
+    )
+
+    for name, description in PORTED_SKILLS:
+        ctx.register_skill(
+            name,
+            base / "skills" / name / "SKILL.md",
+            description,
+        )