lithermes-ai 0.8.0 → 0.8.2

package/assets/lithermes-plugin/__init__.py

@@ -133,6 +133,9 @@ def register(ctx) -> None:
     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)
+    # Force the LITBURN banner onto a bare-`lit` keyword turn's response (that
+    # path has no deterministic display channel; slash commands print it directly).
+    ctx.register_hook("transform_llm_output", core.transform_llm_output)
 
     # Model-facing litgoal tools (durable criteria/evidence/checkpoint/steering/gate).
     litgoal_tools.register_tools(ctx)

package/assets/lithermes-plugin/core.py

@@ -38,6 +38,12 @@ _SLUG_PATTERN = re.compile(r"[^a-z0-9]+")
 # for the bare-`lit` keyword path (best-effort — that path only reaches the model).
 LITBURN_BANNER = "🔥 LITBURN IGNITED 🔥"
 
+# Session ids whose CURRENT turn triggered the litwork keyword path. The bare
+# `lit` keyword has no deterministic display channel (pre_llm_call only reaches
+# the model), so pre_llm_call flags the turn here and transform_llm_output forces
+# the banner onto that turn's response before the user sees it. Consumed once.
+_PENDING_IGNITE: set[str] = set()
+
 
 LIT_CONTEXT = "\n".join(
     [
@@ -258,6 +264,10 @@ def ignite(result: str | dict[str, str]) -> str | dict[str, str]:
 def pre_llm_call(**kwargs: Any) -> dict[str, str] | None:
     user_message = str(kwargs.get("user_message") or "")
     session_id = str(kwargs.get("session_id") or "")
+    # Clear any stale ignite flag from an interrupted previous turn so it can't
+    # leak the banner onto this turn's response. Re-added below only if THIS turn
+    # is a keyword-lit turn — keeping the flag scoped to the current turn.
+    _PENDING_IGNITE.discard(session_id)
     # /litgoal & /lit-plan declare an objective via the bind-goal marker. Bind it
     # (we have session_id here) and stop — those messages are self-contained.
     bind_obj = _extract_bind_goal(user_message)
@@ -291,9 +301,31 @@ def pre_llm_call(**kwargs: Any) -> dict[str, str] | None:
         session_id=session_id,
         platform=str(kwargs.get("platform") or ""),
     )
+    # Flag this turn so transform_llm_output forces the banner onto the response
+    # (the keyword path has no deterministic display channel like slash commands).
+    if session_id:
+        _PENDING_IGNITE.add(session_id)
     return {"context": LIT_CONTEXT + run_context}
 
 
+def transform_llm_output(**kwargs: Any) -> str | None:
+    """Force the LITBURN banner onto a keyword-`lit` turn's response.
+
+    Hermes replaces the user-visible response with the first non-empty string a
+    transform_llm_output hook returns. Returning None leaves the text unchanged.
+    We only act on turns pre_llm_call flagged, consume the flag once, and dedup so
+    a model that already opened with the banner is not double-bannered.
+    """
+    session_id = str(kwargs.get("session_id") or "")
+    if session_id not in _PENDING_IGNITE:
+        return None
+    _PENDING_IGNITE.discard(session_id)
+    response_text = str(kwargs.get("response_text") or "")
+    if response_text.lstrip().startswith(LITBURN_BANNER):
+        return None  # model already emitted it — leave unchanged
+    return f"{LITBURN_BANNER}\n\n{response_text}"
+
+
 def subagent_stop(**kwargs: Any) -> None:
     """Record each delegate_task child (e.g. a review lane) to the LitHermes ledger.
 

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

@@ -1,7 +1,7 @@
 {
-  "syncedAt": "2026-06-14T03:56:58.019Z",
+  "syncedAt": "2026-06-14T07:32:26.488Z",
   "source": "source-reference",
-  "sourceHash": "23886fd1b52dc30433f8886ba15ccedbc3d134ba8f0b99b7a90a83d07c0351fe",
+  "sourceHash": "4ec00032263690e3fea1b618c961ae32aaa950db46d5320f4fcc79a844652ab6",
   "files": [
     {
       "path": "NOTICE.md",
@@ -13,11 +13,11 @@
     },
     {
       "path": "__init__.py",
-      "sha256": "14951813219a77f7074ff8ca36e26cc46b66b0987f28dbcf1827c9bcfa98d65c"
+      "sha256": "9a0b19060eb12799bf76b15b729fcbab4388d74aac9e888b40369b809fd54669"
     },
     {
       "path": "core.py",
-      "sha256": "da2888e70b560697eaf81fe29d0b92a36e8e0563ab3bcab95c34472533faa937"
+      "sha256": "6b9d8b488d5905232d170f78943d2b5f9b9a4bde564e01a816c4fcc45098a7df"
     },
     {
       "path": "litgoal/__init__.py",
@@ -49,7 +49,7 @@
     },
     {
       "path": "plugin.yaml",
-      "sha256": "4b8a31a093d883cf1714250564955c3d8ca87889887780515a7df15ed317e732"
+      "sha256": "d356b26af023599d32bde33f8c51053fdd4970d8ff710d4d1243d87a438f0f38"
     },
     {
       "path": "skills/ai-slop-remover/SKILL.md",

package/assets/lithermes-plugin/plugin.yaml

@@ -1,5 +1,5 @@
 name: lithermes
-version: 0.8.0
+version: 0.8.2
 description: "Hermes-native workflow toolkit: litgoal durable runtime, 5-lane review orchestrator, Litwork commands, skills, and prompt steering."
 author: "Hermes Agent"
 kind: standalone
@@ -7,3 +7,4 @@ auto_load: true
 hooks:
   - pre_llm_call
   - subagent_stop
+  - transform_llm_output

package/package.json

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

package/src/lib/install.js

@@ -50,6 +50,15 @@ function installedMatchesManifest(hermesHome, manifest) {
   });
 }
 
+// Version-aware install status (NOT a manifest-integrity check): distinguish a
+// fresh install, a same-version reinstall, and a real upgrade so the message
+// never claims "already up to date" while actually replacing an older version.
+function installStatusLine(installedVersion, packageVersion) {
+  if (!installedVersion) return `Installed LitHermes ${packageVersion}`;
+  if (installedVersion === packageVersion) return `LitHermes already up to date (${packageVersion})`;
+  return `Upgraded LitHermes ${installedVersion} → ${packageVersion}`;
+}
+
 function installLitHermes(flags = {}) {
   const { hermesHome, hermesRepo } = ensureHermesHome(flags, { forInstall: true });
   const dest = pluginDest(hermesHome);
@@ -72,7 +81,8 @@ function installLitHermes(flags = {}) {
   return withLock(hermesHome, () => {
     onProgress("Inspecting existing plugin");
     const existingManifest = loadManifest(hermesHome);
-    const wasUpToDate = fs.existsSync(dest) && installedMatchesManifest(hermesHome, existingManifest);
+    const packageVersion = require(path.join(packageRoot, "package.json")).version;
+    const installedVersion = fs.existsSync(dest) && existingManifest ? existingManifest.version : null;
     if (fs.existsSync(dest) && !installedMatchesManifest(hermesHome, existingManifest) && !flags.force) {
       throw new LitHermesError(`Existing LitHermes plugin at ${dest} is not manifest-owned. Use --force after backing it up.`, 5);
     }
@@ -92,7 +102,7 @@ function installLitHermes(flags = {}) {
     }
     onProgress("Recording install manifest");
     const manifest = {
-      version: require(path.join(packageRoot, "package.json")).version,
+      version: packageVersion,
       installedAt: new Date().toISOString(),
       pluginPath: dest,
       configPath: path.join(hermesHome, "config.yaml"),
@@ -114,7 +124,7 @@ function installLitHermes(flags = {}) {
       }
     }
     const lines = [
-      wasUpToDate ? "LitHermes already up to date" : "Installed LitHermes",
+      installStatusLine(installedVersion, packageVersion),
       `plugin: ${dest}`,
     ];
     if (patchResult) lines.push(`patches: ${patchResult.changed.length ? patchResult.changed.join(", ") : "none needed"}`);
@@ -152,6 +162,7 @@ function uninstallLitHermes(flags = {}) {
 module.exports = {
   assetRoot,
   installLitHermes,
+  installStatusLine,
   loadManifest,
   manifestPath,
   pluginDest,