cluxion-agentplugin-preprocessing 0.3.22__tar.gz → 0.3.23__tar.gz

{cluxion_agentplugin_preprocessing-0.3.22 → cluxion_agentplugin_preprocessing-0.3.23}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cluxion-agentplugin-preprocessing
-Version: 0.3.22
+Version: 0.3.23
 Summary: Universal agent plugin for Cluxion preprocessing, honesty contracts, clarification, Rust work queue, and resource-aware harness handoff.
 Project-URL: Homepage, https://github.com/cluxion/cluxion-Agentplugin-preprocessing
 Project-URL: Repository, https://github.com/cluxion/cluxion-Agentplugin-preprocessing

{cluxion_agentplugin_preprocessing-0.3.22 → cluxion_agentplugin_preprocessing-0.3.23}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cluxion-agentplugin-preprocessing"
-version = "0.3.22"
+version = "0.3.23"
 description = "Universal agent plugin for Cluxion preprocessing, honesty contracts, clarification, Rust work queue, and resource-aware harness handoff."
 readme = "README.md"
 requires-python = ">=3.11"

{cluxion_agentplugin_preprocessing-0.3.22 → cluxion_agentplugin_preprocessing-0.3.23}/src/cluxion_agentplugin_preprocessing/plugin.py

@@ -28,6 +28,7 @@ from cluxion_agentplugin_preprocessing.schemas import (
     SERVE_LOCAL_SCHEMA,
     WEB_SEARCH_SCHEMA,
 )
+from cluxion_agentplugin_preprocessing.slash_commands import register_slash_commands
 from cluxion_runtime.core.context_compress import (
     DEFAULT_TRIGGER_RATIO,
     _resolve_context_limit,
@@ -42,6 +43,7 @@ if TYPE_CHECKING:
 
 def register(ctx: object) -> None:
     """Register Cluxion preprocessing tools with the host agent."""
+    register_slash_commands(ctx)
     register_hook = getattr(ctx, "register_hook", None)
     if callable(register_hook):
         register_hook("on_session_start", guard_watch.on_session_start)

{cluxion_agentplugin_preprocessing-0.3.22 → cluxion_agentplugin_preprocessing-0.3.23}/src/cluxion_agentplugin_preprocessing/plugin.yaml

@@ -1,5 +1,5 @@
 name: cluxion-agentplugin-preprocessing
-version: 0.3.22
+version: 0.3.23
 description: "Universal agent preprocessing plugin: honesty contracts, clarification, Rust work queue, resource-aware harness handoff. Connected AI calls cluxion tools; plugin does not own models."
 author: cluxion
 kind: standalone

cluxion_agentplugin_preprocessing-0.3.23/src/cluxion_agentplugin_preprocessing/slash_commands.py

@@ -0,0 +1,121 @@
+"""In-session slash commands for Hermes (/loopauto, /cluxion-doctor)."""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+from cluxion_agentplugin_preprocessing import runner
+from cluxion_agentplugin_preprocessing.doctor import render_text, run_doctor
+from cluxion_agentplugin_preprocessing.doctor.probes import PROBES
+
+LOOPAUTO_HELP = """\
+/loopauto <prompt> — Autonomous queue drain (loopAuto)
+
+Plans the task, stores segment content in the Rust queue, then loops:
+  queue_next → hermes -z → queue_record → … → briefing
+
+Examples:
+  /loopauto implement every REQ line and record evidence
+  /loopauto refactor auth module with tests
+
+Notes:
+  - Equivalent to prefixing a prompt with /loopAuto on cluxion_plan
+  - Disable auto-loop: export CLUXION_LOOP_AUTO=0
+  - Diagnostics only: add loop_auto_dry_run via cluxion_plan tool
+"""
+
+CLUXION_DOCTOR_HELP = "/cluxion-doctor — Run preprocessing plugin health checks (doctor)."
+
+
+def register_slash_commands(ctx: object) -> None:
+    register = getattr(ctx, "register_command", None)
+    if not callable(register):
+        return
+    register(
+        "loopauto",
+        handle_loopauto,
+        description="Autonomous queue drain (loopAuto) — plan + Hermes oneshot segment loop",
+        args_hint="<prompt>",
+    )
+    register(
+        "cluxion-doctor",
+        handle_cluxion_doctor,
+        description="Run cluxion preprocessing plugin doctor checks",
+    )
+
+
+def handle_loopauto(raw_args: str) -> str:
+    prompt = raw_args.strip()
+    if not prompt or prompt.lower() in {"help", "-h", "--help"}:
+        return LOOPAUTO_HELP
+    try:
+        result = runner.plan(
+            {
+                "prompt": f"/loopAuto {prompt}",
+                "cwd": str(Path.cwd()),
+                "clarification_answers": "confirmed via /loopauto slash command",
+            }
+        )
+        return _format_plan_response(result.to_json())
+    except Exception as exc:
+        return f"loopauto error: {exc}"
+
+
+def handle_cluxion_doctor(raw_args: str) -> str:
+    if raw_args.strip().lower() in {"help", "-h", "--help"}:
+        return CLUXION_DOCTOR_HELP
+    import importlib.resources
+
+    from cluxion_agentplugin_preprocessing import __version__
+    from cluxion_agentplugin_preprocessing.doctor.framework import load_catalog
+
+    pkg = "cluxion_agentplugin_preprocessing.doctor"
+    catalog_path = Path(str(importlib.resources.files(pkg).joinpath("catalog.json")))
+    result = run_doctor(
+        cwd=Path.cwd(),
+        hermes_bin="hermes",
+        catalog_path=catalog_path,
+        probes=PROBES,
+        plugin="preprocessing",
+        version=__version__,
+    )
+    return render_text(result, load_catalog(catalog_path))
+
+
+def _format_plan_response(raw_json: str) -> str:
+    payload = json.loads(raw_json)
+    if not payload.get("ok"):
+        return f"loopauto failed: {payload.get('error', 'unknown error')}"
+    body = payload.get("result", payload)
+    if not isinstance(body, dict):
+        return str(body)
+    loop = body.get("loop_auto")
+    if isinstance(loop, dict):
+        lines = [
+            f"[loopauto] ok={loop.get('ok')} status={loop.get('status')}",
+            f"segments_processed={loop.get('segments_processed')} "
+            f"segments_failed={loop.get('segments_failed')} "
+            f"duration_ms={loop.get('duration_ms')}",
+        ]
+        if loop.get("error"):
+            lines.append(f"error: {loop['error']}")
+        briefing = str(loop.get("briefing_answer", "")).strip()
+        if briefing:
+            lines.extend(["", briefing])
+        return "\n".join(lines)
+    host = body.get("host_execution")
+    if isinstance(host, dict) and host.get("queue_required"):
+        return (
+            "Plan queued but loop_auto did not run. "
+            "Check CLUXION_LOOP_AUTO=1 and hermes on PATH (cluxion-preprocess doctor)."
+        )
+    return json.dumps(body, ensure_ascii=False, indent=2)[:8000]
+
+
+__all__ = [
+    "LOOPAUTO_HELP",
+    "handle_cluxion_doctor",
+    "handle_loopauto",
+    "register_slash_commands",
+]

{cluxion_agentplugin_preprocessing-0.3.22 → cluxion_agentplugin_preprocessing-0.3.23}/tests/test_plugin.py

@@ -11,6 +11,20 @@ from cluxion_agentplugin_preprocessing import plugin
 class FakeContext:
     def __init__(self) -> None:
         self.tools: dict[str, dict[str, object]] = {}
+        self.commands: dict[str, dict[str, object]] = {}
+
+    def register_command(
+        self,
+        name: str,
+        handler: object,
+        description: str = "",
+        args_hint: str = "",
+    ) -> None:
+        self.commands[name] = {
+            "handler": handler,
+            "description": description,
+            "args_hint": args_hint,
+        }
 
     def register_tool(
         self,
@@ -56,6 +70,9 @@ def test_register_adds_expected_tools() -> None:
         "cluxion_web_search",
     ]
     assert {tool["toolset"] for tool in ctx.tools.values()} == {"cluxion"}
+    assert "loopauto" in ctx.commands
+    assert "cluxion-doctor" in ctx.commands
+    assert ctx.commands["loopauto"]["args_hint"] == "<prompt>"
 
 
 def test_handler_returns_json_error_for_missing_model() -> None:

cluxion_agentplugin_preprocessing-0.3.23/tests/test_slash_commands.py

@@ -0,0 +1,8 @@
+from __future__ import annotations
+
+from cluxion_agentplugin_preprocessing.slash_commands import LOOPAUTO_HELP, handle_loopauto
+
+
+def test_loopauto_help_without_args() -> None:
+    assert "Autonomous queue drain" in handle_loopauto("")
+    assert handle_loopauto("help") == LOOPAUTO_HELP