cluxion-agentplugin-preprocessing 0.3.24__tar.gz → 0.3.25__tar.gz

{cluxion_agentplugin_preprocessing-0.3.24/adapters/claude → cluxion_agentplugin_preprocessing-0.3.25}/.claude-plugin/plugin.json

@@ -1,8 +1,8 @@
 {
   "name": "cluxion-agentplugin-preprocessing",
-  "version": "0.2.0",
-  "description": "Cluxion preprocessing: honesty, clarification, Rust work queue, resource admission.",
+  "version": "0.3.25",
+  "description": "Cluxion preprocessing: honesty, clarification, durable work queue, loop_auto, doctor, and resource guard contracts.",
   "author": "cluxion",
   "commands": "./commands",
   "skills": "./skills"
-}
+}

cluxion_agentplugin_preprocessing-0.3.25/.codex-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "cluxion-agentplugin-preprocessing",
+  "version": "0.3.25",
+  "description": "Cluxion preprocessing: honesty, clarification, durable work queue, loop_auto, doctor, and resource guard contracts.",
+  "author": "cluxion",
+  "commands": "./commands",
+  "skills": "./skills"
+}

{cluxion_agentplugin_preprocessing-0.3.24 → cluxion_agentplugin_preprocessing-0.3.25}/Docs/README.md

@@ -17,11 +17,11 @@
 
 1. 사용자 요청 수신 → `cluxion_plan` (또는 `cluxion-runtime plan`)
 2. `clarification.required`이면 사용자에게 질문, 작업 보류
-3. `queued` 모드: 수동이면 `cluxion_queue_next` → … → `cluxion_queue_brief`. Hermes 긴 작업은 `/loopauto` 또는 `loop_auto: true`(기본)로 자동 드레인.
+3. `queued` 모드: 수동이면 `cluxion_queue_next` → … → `cluxion_queue_brief`. 자동 드레인은 `/loopauto`, `loop_auto: true`, 또는 전용 `loop-auto` 명령으로만 실행합니다.
 4. `answer_policy.required_checks`를 지키며 응답
 5. (선택) `cluxion_queue_brief` 결과를 ForgetForge에 저장: `forgetforge import-brief --source preprocessing`
 
-Skill: [`adapters/claude/skills/preprocess/SKILL.md`](../adapters/claude/skills/preprocess/SKILL.md)
+Skill: [`skills/preprocess/SKILL.md`](../skills/preprocess/SKILL.md)
 
 ### 사람(개발자)이 할 일
 
@@ -50,4 +50,4 @@ cluxion-preprocess enable   # Hermes
 - 플러그인이 host 대신 LLM completion을 대체하는 것
 - 비공개 인프라·배포 비밀
 
-이슈는 GitHub Issues를 사용해 주세요.
+이슈는 GitHub Issues를 사용해 주세요.

{cluxion_agentplugin_preprocessing-0.3.24 → cluxion_agentplugin_preprocessing-0.3.25}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cluxion-agentplugin-preprocessing
-Version: 0.3.24
+Version: 0.3.25
 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
@@ -90,7 +90,7 @@ Hermes 안에서는 `cluxion_doctor` 도구로도 노출됩니다.
 
 | 슬래시 | 용도 |
 |---|---|
-| `/loopauto <prompt>` | plan + 자동 큐 드레인 (`/loopAuto` 지시어와 동일) |
+| `/loopauto <prompt>` | 명시적 plan + 자동 큐 드레인 |
 | `/cluxion-doctor` | doctor (CLI `cluxion-preprocess doctor`와 동일) |
 
 ```
@@ -98,7 +98,8 @@ Hermes 안에서는 `cluxion_doctor` 도구로도 노출됩니다.
 /cluxion-doctor
 ```
 
-비활성: `export CLUXION_LOOP_AUTO=0` · 상세: `Docs/cluxion-plugins-guide.md` §5-A (통합 가이드)
+`/loopAuto` prompt prefix는 이제 queue 계약만 만들고, blocking drain은 `loop_auto=true` 또는 전용
+`loop-auto` 명령에서만 실행됩니다.
 
 ## 문제 해결
 
@@ -174,7 +175,7 @@ Type `/` to see plugin commands with a 🔌 badge.
 
 | Slash | Purpose |
 |---|---|
-| `/loopauto <prompt>` | Plan + autonomous queue drain (same as `/loopAuto` directive) |
+| `/loopauto <prompt>` | Explicit plan + autonomous queue drain |
 | `/cluxion-doctor` | Run doctor (same as `cluxion-preprocess doctor`) |
 
 ```
@@ -182,7 +183,8 @@ Type `/` to see plugin commands with a 🔌 badge.
 /cluxion-doctor
 ```
 
-Disable auto-loop: `export CLUXION_LOOP_AUTO=0`.
+The `/loopAuto` prompt prefix now only queues work. Blocking drain requires explicit `loop_auto=true`
+or the dedicated `loop-auto` command.
 
 ## Troubleshooting
 

{cluxion_agentplugin_preprocessing-0.3.24 → cluxion_agentplugin_preprocessing-0.3.25}/README.md

@@ -58,7 +58,7 @@ Hermes 안에서는 `cluxion_doctor` 도구로도 노출됩니다.
 
 | 슬래시 | 용도 |
 |---|---|
-| `/loopauto <prompt>` | plan + 자동 큐 드레인 (`/loopAuto` 지시어와 동일) |
+| `/loopauto <prompt>` | 명시적 plan + 자동 큐 드레인 |
 | `/cluxion-doctor` | doctor (CLI `cluxion-preprocess doctor`와 동일) |
 
 ```
@@ -66,7 +66,8 @@ Hermes 안에서는 `cluxion_doctor` 도구로도 노출됩니다.
 /cluxion-doctor
 ```
 
-비활성: `export CLUXION_LOOP_AUTO=0` · 상세: `Docs/cluxion-plugins-guide.md` §5-A (통합 가이드)
+`/loopAuto` prompt prefix는 이제 queue 계약만 만들고, blocking drain은 `loop_auto=true` 또는 전용
+`loop-auto` 명령에서만 실행됩니다.
 
 ## 문제 해결
 
@@ -142,7 +143,7 @@ Type `/` to see plugin commands with a 🔌 badge.
 
 | Slash | Purpose |
 |---|---|
-| `/loopauto <prompt>` | Plan + autonomous queue drain (same as `/loopAuto` directive) |
+| `/loopauto <prompt>` | Explicit plan + autonomous queue drain |
 | `/cluxion-doctor` | Run doctor (same as `cluxion-preprocess doctor`) |
 
 ```
@@ -150,7 +151,8 @@ Type `/` to see plugin commands with a 🔌 badge.
 /cluxion-doctor
 ```
 
-Disable auto-loop: `export CLUXION_LOOP_AUTO=0`.
+The `/loopAuto` prompt prefix now only queues work. Blocking drain requires explicit `loop_auto=true`
+or the dedicated `loop-auto` command.
 
 ## Troubleshooting
 

cluxion_agentplugin_preprocessing-0.3.25/commands/cluxion-doctor.md

@@ -0,0 +1,9 @@
+---
+description: Run Cluxion plugin diagnostics.
+---
+
+Run:
+
+```bash
+cluxion-preprocess doctor
+```

cluxion_agentplugin_preprocessing-0.3.25/commands/cluxion-plan.md

@@ -0,0 +1,18 @@
+---
+description: Run Cluxion preprocessing and return the JSON contract.
+argument-hint: "<prompt>"
+---
+
+Run:
+
+```bash
+cluxion-runtime plan --surface codex --json-stdin
+```
+
+stdin:
+
+```json
+{"prompt":"$ARGUMENTS","cwd":"$PWD"}
+```
+
+Return the JSON contract to the host flow. Do not run `loop-auto` unless `loop_auto=true` is explicitly present.

cluxion_agentplugin_preprocessing-0.3.25/commands/loop-auto.md

@@ -0,0 +1,16 @@
+---
+description: Explicitly drain a queued Cluxion work bundle.
+argument-hint: "<work_id>"
+---
+
+Run:
+
+```bash
+cluxion-runtime loop-auto --work-id "$ARGUMENTS" --json-stdin
+```
+
+stdin:
+
+```json
+{"work_id":"$ARGUMENTS"}
+```

{cluxion_agentplugin_preprocessing-0.3.24 → cluxion_agentplugin_preprocessing-0.3.25}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cluxion-agentplugin-preprocessing"
-version = "0.3.24"
+version = "0.3.25"
 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"
@@ -67,14 +67,20 @@ packages = ["src/cluxion_agentplugin_preprocessing", "src/cluxion_runtime"]
 [tool.hatch.build.targets.wheel.force-include]
 "cluxion-Docs" = "cluxion_agentplugin_docs/cluxion-Docs"
 ".github/profile/README.md" = "cluxion_agentplugin_docs/github-profile/README.md"
-"adapters" = "cluxion_agentplugin_adapters"
+".claude-plugin" = ".claude-plugin"
+".codex-plugin" = ".codex-plugin"
+"commands" = "commands"
+"skills" = "skills"
 
 [tool.hatch.build.targets.sdist]
 include = [
     "src/cluxion_agentplugin_preprocessing",
     "src/cluxion_runtime",
     "rust/cluxion_queue",
-    "adapters",
+    ".claude-plugin",
+    ".codex-plugin",
+    "commands",
+    "skills",
     "tests",
     "cluxion-Docs",
     ".github/profile",
@@ -93,4 +99,4 @@ line-length = 120
 src = ["src", "tests"]
 
 [tool.ruff.lint]
-select = ["F", "I", "UP", "B", "SIM", "RUF"]
+select = ["F", "I", "UP", "B", "SIM", "RUF"]

cluxion_agentplugin_preprocessing-0.3.25/skills/preprocess/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: cluxion-preprocess
+description: Use Cluxion preprocessing before agent work that needs clarification, queueing, loop_auto, doctor checks, or surface-specific JSON contracts.
+---
+
+# Cluxion Preprocess
+
+Call the runtime CLI. The plugin returns JSON contracts; the host agent owns model calls and final answers.
+
+## Plan
+
+```bash
+cluxion-runtime plan --surface codex --json-stdin
+```
+
+Use `--surface claude` in Claude Code. Minimum stdin:
+
+```json
+{"prompt":"<user request>","cwd":"<workspace>"}
+```
+
+Rules:
+
+1. If `clarification.required` is true, ask the user before starting work.
+2. If `host_execution.queue_required` is true, process the queue with `queue-next`, `queue-record`, and `queue-brief`, or call `loop-auto` only when the user or payload explicitly opts in with `loop_auto=true`.
+3. A `/loopAuto` prompt prefix only requests queueing and is stripped by `plan`; it does not start a blocking drain.
+4. Never claim checks were run unless the host actually ran them.
+
+## Queue
+
+```bash
+cluxion-runtime queue-next --work-id <work_id>
+cluxion-runtime queue-record --work-id <work_id> --step-id <step_id> --json-stdin
+cluxion-runtime queue-brief --work-id <work_id>
+```
+
+## Explicit loop_auto
+
+```bash
+cluxion-runtime loop-auto --work-id <work_id> --json-stdin
+```
+
+## Doctor
+
+```bash
+cluxion-preprocess doctor
+```

{cluxion_agentplugin_preprocessing-0.3.24 → cluxion_agentplugin_preprocessing-0.3.25}/src/cluxion_agentplugin_preprocessing/cli.py

@@ -87,12 +87,13 @@ def _parser() -> argparse.ArgumentParser:
     doctor.add_argument("--verbose", action="store_true")
     patch = subparsers.add_parser(
         "hermes-patch",
-        help="Apply or verify Hermes deliver=agent patch (/supercoder routing)",
+        help="Explicitly apply or verify Hermes deliver=agent patch",
     )
+    patch.add_argument("action", nargs="?", choices=("status", "apply"), default="status")
     patch.add_argument(
         "--status",
         action="store_true",
-        help="Only report patch status (default: ensure applied)",
+        help="Deprecated alias for: hermes-patch status",
     )
     patch.add_argument("--dry-run", action="store_true")
     patch.add_argument(
@@ -134,10 +135,9 @@ def _status(args: argparse.Namespace) -> int:
 
 def _enable(args: argparse.Namespace) -> int:
     result = hermes_config.enable_plugin(args.home, dry_run=bool(args.dry_run))
-    patch = _ensure_hermes_patch(dry_run=bool(args.dry_run))
-    payload = {"ok": True, **result.to_dict(), "hermes_patch": patch.to_dict()}
+    payload = {"ok": True, **result.to_dict()}
     print(json.dumps(payload, ensure_ascii=False, sort_keys=True))
-    return 0 if patch.status in {"applied", "no_hermes"} or args.dry_run else 1
+    return 0
 
 
 def _disable(args: argparse.Namespace) -> int:
@@ -166,15 +166,9 @@ def _hermes_root_arg(args: argparse.Namespace) -> Path | None:
     return Path(raw).expanduser() if raw else None
 
 
-def _ensure_hermes_patch(*, dry_run: bool, hermes_root: Path | None = None) -> hermes_deliver_patch.PatchResult:
-    if dry_run:
-        return hermes_deliver_patch.patch_status(hermes_root)
-    return hermes_deliver_patch.ensure_applied(hermes_root=hermes_root)
-
-
 def _hermes_patch(args: argparse.Namespace) -> int:
     root = _hermes_root_arg(args)
-    if args.status:
+    if args.status or args.action == "status":
         result = hermes_deliver_patch.patch_status(root)
     else:
         result = hermes_deliver_patch.ensure_applied(hermes_root=root, dry_run=bool(args.dry_run))

{cluxion_agentplugin_preprocessing-0.3.24 → cluxion_agentplugin_preprocessing-0.3.25}/src/cluxion_agentplugin_preprocessing/doctor/catalog.json

@@ -513,6 +513,39 @@
     "change_robust": "Enforce sort_keys=True in all queue/dispatch serialization; add docstring reminding of determinism requirement",
     "detection_method": "python -c 'import json; d = {\"z\": 1, \"a\": 2}; j1 = json.dumps(d, sort_keys=True); j2 = json.dumps(d, sort_keys=True); assert j1 == j2, f\"{j1} != {j2}\"'"
   },
+  {
+    "check_id": "hermes_deliver_patch_status",
+    "category": "hermes_contract",
+    "severity": "high",
+    "what_it_checks": "Hermes deliver=agent source patch is absent, fully applied, or partially applied",
+    "failure_symptom": "deliver=agent slash behavior silently does not exist or only some Hermes paths support it",
+    "likely_causes": [
+      "Hermes source changed and patch anchors no longer match",
+      "A previous manual patch only touched some files",
+      "HERMES_AGENT_ROOT points at the wrong checkout"
+    ],
+    "fix_steps": [
+      "Run: cluxion-preprocess hermes-patch status",
+      "If needed, run: cluxion-preprocess hermes-patch apply",
+      "If anchors mismatch, restore or update the Hermes checkout before applying"
+    ],
+    "change_robust": "Patch is explicit opt-in and reports applied/partial/no-hermes/anchors-mismatch instead of silently editing on session start"
+  },
+  {
+    "check_id": "version_files_synced",
+    "category": "install",
+    "severity": "high",
+    "what_it_checks": "pyproject, plugin.yaml, package plugin.yaml, and Codex/Claude plugin manifests use the same version",
+    "failure_symptom": "Marketplace plugin metadata, Hermes adapter metadata, and installed Python distribution report different versions",
+    "likely_causes": [
+      "Version bumped in pyproject only",
+      "Root plugin artifact added without updating package metadata"
+    ],
+    "fix_steps": [
+      "Set every plugin manifest version to pyproject.toml project.version"
+    ],
+    "change_robust": "Doctor compares repo metadata files directly and fails on any drift"
+  },
   {
     "check_id": "temp_file_cleanup",
     "category": "resource",

{cluxion_agentplugin_preprocessing-0.3.24 → cluxion_agentplugin_preprocessing-0.3.25}/src/cluxion_agentplugin_preprocessing/doctor/probes.py

@@ -9,7 +9,9 @@ import os
 import shutil
 import sys
 import tempfile
+import tomllib
 from collections.abc import Callable
+from pathlib import Path
 
 from .framework import DoctorContext
 
@@ -306,12 +308,66 @@ def hermes_plugin_enabled(ctx: DoctorContext) -> tuple[str, str]:
             if n in enabled and n not in disabled:
                 return "pass", f"{n} in enabled"
         if any(n in enabled for n in names):
-            return "warn", "present but also disabled?"
-        return "warn", "not in plugins.enabled"
+            return "warn", "present but also disabled; fix: remove it from plugins.disabled"
+        return "fail", "not in plugins.enabled; fix: run cluxion-preprocess enable"
     except Exception as e:
         return "skip", f"uncertainty: {type(e).__name__}"
 
 
+@_register("hermes_deliver_patch_status")
+def hermes_deliver_patch_status(ctx: DoctorContext) -> tuple[str, str]:
+    del ctx
+    try:
+        from cluxion_agentplugin_preprocessing import hermes_deliver_patch
+
+        result = hermes_deliver_patch.patch_status()
+        if result.status == "applied":
+            return "pass", "applied"
+        if result.status == "no_hermes":
+            return "skip", "no Hermes source tree; fix: set HERMES_AGENT_ROOT or skip deliver=agent patch"
+        if result.status == "partial":
+            return "fail", "partial patch; fix: restore Hermes tree then run cluxion-preprocess hermes-patch apply"
+        return "warn", f"{result.status}; fix: run cluxion-preprocess hermes-patch apply"
+    except Exception as e:
+        return "fail", f"patch status error: {e}; fix: run cluxion-preprocess hermes-patch status"
+
+
+@_register("version_files_synced")
+def version_files_synced(ctx: DoctorContext) -> tuple[str, str]:
+    try:
+        pyproject_path = ctx.cwd / "pyproject.toml"
+        if not pyproject_path.exists():
+            return "skip", "repo files not present"
+        version = tomllib.loads(pyproject_path.read_text(encoding="utf-8"))["project"]["version"]
+        paths = {
+            "plugin.yaml": ctx.cwd / "plugin.yaml",
+            "package plugin.yaml": ctx.cwd / "src" / "cluxion_agentplugin_preprocessing" / "plugin.yaml",
+            "claude plugin": ctx.cwd / ".claude-plugin" / "plugin.json",
+            "codex plugin": ctx.cwd / ".codex-plugin" / "plugin.json",
+        }
+        drift: list[str] = []
+        for label, path in paths.items():
+            if not path.exists():
+                drift.append(f"{label}=missing")
+                continue
+            found = _version_from_file(path)
+            if found != version:
+                drift.append(f"{label}={found}")
+        if drift:
+            return "fail", f"pyproject={version} drift={'; '.join(drift)}; fix: sync plugin versions"
+        return "pass", version
+    except Exception as e:
+        return "fail", f"version check error: {e}; fix: inspect pyproject/plugin metadata"
+
+
+def _version_from_file(path: Path) -> str:
+    if path.suffix == ".json":
+        return str(_json.loads(path.read_text(encoding="utf-8")).get("version", ""))
+    import yaml
+
+    return str(yaml.safe_load(path.read_text(encoding="utf-8")).get("version", ""))
+
+
 @_register("env_var_consistency")
 def env_var_consistency(ctx: DoctorContext) -> tuple[str, str]:
     try:

{cluxion_agentplugin_preprocessing-0.3.24 → cluxion_agentplugin_preprocessing-0.3.25}/src/cluxion_agentplugin_preprocessing/guard_watch.py

@@ -38,7 +38,6 @@ def on_session_start(**_: Any) -> None:
     Startup is idempotent: an already-running daemon is success. Hook failures
     are logged as one concise stderr warning and never propagated to the host.
     """
-    _maybe_apply_hermes_deliver_patch()
     if not _autostart_enabled():
         return
     try:
@@ -52,23 +51,6 @@ def on_session_start(**_: Any) -> None:
         _warn(f"cluxion guard autostart failed: {reason}")
 
 
-def _maybe_apply_hermes_deliver_patch() -> None:
-    """Best-effort Hermes deliver=agent patch (``CLUXION_HERMES_PATCH_AUTOFIX``, default on)."""
-    try:
-        from cluxion_agentplugin_preprocessing import hermes_deliver_patch
-
-        if not hermes_deliver_patch.autostart_enabled():
-            return
-        status = hermes_deliver_patch.patch_status()
-        if status.status == "applied":
-            return
-        result = hermes_deliver_patch.ensure_applied()
-        if result.status != "applied" and result.status != "no_hermes":
-            _warn(f"cluxion hermes deliver patch: {result.detail}")
-    except Exception as exc:
-        _warn(f"cluxion hermes deliver patch failed: {exc}")
-
-
 def post_tool_call(**_: Any) -> None:
     """Run a throttled guard watch after tool calls.
 

{cluxion_agentplugin_preprocessing-0.3.24 → cluxion_agentplugin_preprocessing-0.3.25}/src/cluxion_agentplugin_preprocessing/hermes_deliver_patch.py

@@ -15,7 +15,7 @@ from typing import Literal
 PATCH_RESOURCE = "patches/hermes-deliver-agent.patch"
 BRANCH_NAME = "cluxion/plugin-deliver-agent"
 
-Status = Literal["applied", "missing", "partial", "no_hermes"]
+Status = Literal["applied", "missing", "partial", "no_hermes", "anchors-mismatch"]
 
 
 @dataclass(frozen=True)
@@ -129,6 +129,15 @@ def ensure_applied(
                 )
 
     after = patch_status(current.hermes_root)
+    if after.status != "applied":
+        return PatchResult(
+            current.hermes_root,
+            "anchors-mismatch",
+            False,
+            False,
+            "failed",
+            after.detail,
+        )
     return PatchResult(
         current.hermes_root,
         after.status,
@@ -358,16 +367,9 @@ def _patch_tui_gateway(root: Path) -> bool:
         path.write_text(text, encoding="utf-8")
     return changed
 
-
-def autostart_enabled() -> bool:
-    value = os.environ.get("CLUXION_HERMES_PATCH_AUTOFIX", "1").strip().lower()
-    return value not in {"0", "false", "no", "off"}
-
-
 __all__ = [
     "PatchResult",
-    "autostart_enabled",
     "ensure_applied",
     "patch_status",
     "resolve_hermes_agent_root",
-]
+]

{cluxion_agentplugin_preprocessing-0.3.24 → cluxion_agentplugin_preprocessing-0.3.25}/src/cluxion_agentplugin_preprocessing/plugin.py

@@ -222,7 +222,6 @@ def _plan_args_with_loop_auto(args: dict[str, object]) -> dict[str, object]:
     cleaned, had_directive = strip_loop_auto_directive(prompt)
     if had_directive:
         payload["prompt"] = cleaned
-        payload["loop_auto"] = True
     return payload
 
 

{cluxion_agentplugin_preprocessing-0.3.24 → cluxion_agentplugin_preprocessing-0.3.25}/src/cluxion_agentplugin_preprocessing/plugin.yaml

@@ -1,5 +1,5 @@
 name: cluxion-agentplugin-preprocessing
-version: 0.3.23
+version: 0.3.25
 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
@@ -20,4 +20,4 @@ provides_tools:
   - cluxion_browser_extract
   - cluxion_browser_click
   - cluxion_browser_type
-  - cluxion_doctor
+  - cluxion_doctor

{cluxion_agentplugin_preprocessing-0.3.24 → cluxion_agentplugin_preprocessing-0.3.25}/src/cluxion_agentplugin_preprocessing/schemas.py

@@ -171,8 +171,7 @@ LOOP_AUTO_SCHEMA = {
     "name": "cluxion_loop_auto",
     "description": (
         "Autonomously drain the Cluxion dispatch queue via Hermes oneshot calls. "
-        "Equivalent to /loopAuto: next segment -> hermes -z -> record -> ... -> briefing. "
-        "Use after cluxion_plan queued a durable work bundle, or pass loop_auto on plan."
+        "Use after cluxion_plan queued a durable work bundle, or pass explicit loop_auto=true on plan."
     ),
     "parameters": {
         "type": "object",

{cluxion_agentplugin_preprocessing-0.3.24 → cluxion_agentplugin_preprocessing-0.3.25}/src/cluxion_agentplugin_preprocessing/slash_commands.py

@@ -20,8 +20,7 @@ Examples:
   /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
+  - Equivalent to cluxion_plan with loop_auto=true
   - Diagnostics only: add loop_auto_dry_run via cluxion_plan tool
 """
 
@@ -52,9 +51,10 @@ def handle_loopauto(raw_args: str) -> str:
     try:
         result = runner.plan(
             {
-                "prompt": f"/loopAuto {prompt}",
+                "prompt": prompt,
                 "cwd": str(Path.cwd()),
                 "clarification_answers": "confirmed via /loopauto slash command",
+                "loop_auto": True,
             }
         )
         return _format_plan_response(result.to_json())
@@ -108,7 +108,7 @@ def _format_plan_response(raw_json: str) -> str:
     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)."
+            "Call cluxion_loop_auto or pass explicit loop_auto=true; check hermes on PATH."
         )
     return json.dumps(body, ensure_ascii=False, indent=2)[:8000]
 
@@ -118,4 +118,4 @@ __all__ = [
     "handle_cluxion_doctor",
     "handle_loopauto",
     "register_slash_commands",
-]
+]

{cluxion_agentplugin_preprocessing-0.3.24 → cluxion_agentplugin_preprocessing-0.3.25}/src/cluxion_runtime/cli.py

@@ -86,6 +86,7 @@ def _build_parser() -> argparse.ArgumentParser:
     plan.add_argument("--expected-ram-mb", type=int, default=0)
     plan.add_argument("--context-tokens", type=int, default=0)
     plan.add_argument("--cwd", default="")
+    plan.add_argument("--loop-auto", action="store_true")
     plan.add_argument("--json-stdin", action="store_true")
     serve = subparsers.add_parser("serve-local", help="Prepare a vLLM-MLX server endpoint for a local model")
     serve.add_argument("--model", required=True)
@@ -159,6 +160,8 @@ def _run_plan(args: argparse.Namespace) -> int:
     surface = AgentSurface(str(args.surface))
     payload = _payload_from_stdin() if args.json_stdin else _payload_from_args(args)
     payload = _apply_loop_auto_directive(payload)
+    if bool(getattr(args, "loop_auto", False)):
+        payload["loop_auto"] = True
     item = work_item_from_adapter_payload(payload, default_surface=surface)
     plan = build_harness_plan(item)
     persisted = persist_dispatch_bundle(plan)
@@ -441,6 +444,7 @@ def _payload_from_args(args: argparse.Namespace) -> dict[str, object]:
         "expected_ram_mb": int(args.expected_ram_mb),
         "context_tokens": int(args.context_tokens),
         "cwd": str(args.cwd),
+        "loop_auto": bool(args.loop_auto),
     }
 
 
@@ -451,7 +455,6 @@ def _apply_loop_auto_directive(payload: dict[str, object]) -> dict[str, object]:
         return payload
     updated = dict(payload)
     updated["prompt"] = cleaned
-    updated["loop_auto"] = True
     return updated