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

{cluxion_agentplugin_preprocessing-0.3.23/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.23 → 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` → segment 처리 → `cluxion_queue_record` → `cluxion_queue_brief`
+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)
 
 ### 사람(개발자)이 할 일
 
@@ -37,7 +37,9 @@ cluxion-preprocess enable   # Hermes
 |------|------|
 | [architecture.md](architecture.md) | 패키지 구조, 데이터 흐름, host 경계 |
 | [design.md](design.md) | 정직함, 명확화, 성능 |
-| [installation.md](installation.md) | 설치, Hermes 활성화, Rust 큐 |
+| [installation.md](installation.md) | 설치, Hermes 활성화, 슬래시, Rust 큐 |
+| [tools.md](tools.md) | 도구·슬래시·loopAuto·queued workflow |
+| 통합 가이드 | MacBot `Docs/cluxion-plugins-guide.md` §2-A (5종 슬래시 전체) |
 | [tools.md](tools.md) | 도구, preprocessing mode, queue |
 | [agent-surfaces.md](agent-surfaces.md) | Hermes / Claude / Codex / Grok |
 | [rust-architecture.md](rust-architecture.md) | Rust 메인 · Python adapter |
@@ -48,4 +50,4 @@ cluxion-preprocess enable   # Hermes
 - 플러그인이 host 대신 LLM completion을 대체하는 것
 - 비공개 인프라·배포 비밀
 
-이슈는 GitHub Issues를 사용해 주세요.
+이슈는 GitHub Issues를 사용해 주세요.

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cluxion-agentplugin-preprocessing
-Version: 0.3.23
+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
@@ -84,6 +84,23 @@ cluxion-preprocess doctor --json   # 구조화 출력
 
 Hermes 안에서는 `cluxion_doctor` 도구로도 노출됩니다.
 
+## Hermes 슬래시 커맨드 (0.3.23+)
+
+`/` 입력 시 🔌로 자동완성됩니다.
+
+| 슬래시 | 용도 |
+|---|---|
+| `/loopauto <prompt>` | 명시적 plan + 자동 큐 드레인 |
+| `/cluxion-doctor` | doctor (CLI `cluxion-preprocess doctor`와 동일) |
+
+```
+/loopauto 4000줄 요구사항을 순서대로 구현하고 각 항목 증거를 남겨줘
+/cluxion-doctor
+```
+
+`/loopAuto` prompt prefix는 이제 queue 계약만 만들고, blocking drain은 `loop_auto=true` 또는 전용
+`loop-auto` 명령에서만 실행됩니다.
+
 ## 문제 해결
 
 | 증상 | 해결 |
@@ -152,6 +169,23 @@ cluxion-preprocess doctor --json   # structured output
 
 Also exposed inside Hermes as the `cluxion_doctor` tool.
 
+## Hermes slash commands (0.3.23+)
+
+Type `/` to see plugin commands with a 🔌 badge.
+
+| Slash | Purpose |
+|---|---|
+| `/loopauto <prompt>` | Explicit plan + autonomous queue drain |
+| `/cluxion-doctor` | Run doctor (same as `cluxion-preprocess doctor`) |
+
+```
+/loopauto implement every REQ line and record evidence
+/cluxion-doctor
+```
+
+The `/loopAuto` prompt prefix now only queues work. Blocking drain requires explicit `loop_auto=true`
+or the dedicated `loop-auto` command.
+
 ## Troubleshooting
 
 | Problem | Fix |

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

@@ -52,6 +52,23 @@ cluxion-preprocess doctor --json   # 구조화 출력
 
 Hermes 안에서는 `cluxion_doctor` 도구로도 노출됩니다.
 
+## Hermes 슬래시 커맨드 (0.3.23+)
+
+`/` 입력 시 🔌로 자동완성됩니다.
+
+| 슬래시 | 용도 |
+|---|---|
+| `/loopauto <prompt>` | 명시적 plan + 자동 큐 드레인 |
+| `/cluxion-doctor` | doctor (CLI `cluxion-preprocess doctor`와 동일) |
+
+```
+/loopauto 4000줄 요구사항을 순서대로 구현하고 각 항목 증거를 남겨줘
+/cluxion-doctor
+```
+
+`/loopAuto` prompt prefix는 이제 queue 계약만 만들고, blocking drain은 `loop_auto=true` 또는 전용
+`loop-auto` 명령에서만 실행됩니다.
+
 ## 문제 해결
 
 | 증상 | 해결 |
@@ -120,6 +137,23 @@ cluxion-preprocess doctor --json   # structured output
 
 Also exposed inside Hermes as the `cluxion_doctor` tool.
 
+## Hermes slash commands (0.3.23+)
+
+Type `/` to see plugin commands with a 🔌 badge.
+
+| Slash | Purpose |
+|---|---|
+| `/loopauto <prompt>` | Explicit plan + autonomous queue drain |
+| `/cluxion-doctor` | Run doctor (same as `cluxion-preprocess doctor`) |
+
+```
+/loopauto implement every REQ line and record evidence
+/cluxion-doctor
+```
+
+The `/loopAuto` prompt prefix now only queues work. Blocking drain requires explicit `loop_auto=true`
+or the dedicated `loop-auto` command.
+
 ## Troubleshooting
 
 | Problem | Fix |

{cluxion_agentplugin_preprocessing-0.3.23 → cluxion_agentplugin_preprocessing-0.3.25}/cluxion-Docs/install-and-operations.md

@@ -13,6 +13,7 @@ cluxion-preprocess enable    # Hermes
 ## 연결된 AI 연동
 
 - Hermes: `cluxion_*` 도구 (plugin enable 후)
+- Hermes 슬래시 (0.3.23+): `/loopauto`, `/cluxion-doctor` — `/` 자동완성
 - Claude: `adapters/claude/skills/preprocess/SKILL.md`
 - Codex: `adapters/codex/config-snippet.toml`
 - 공통: `cluxion-runtime plan --surface <hermes|claude|codex|grok_build>`

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.23 → cluxion_agentplugin_preprocessing-0.3.25}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cluxion-agentplugin-preprocessing"
-version = "0.3.23"
+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.23 → cluxion_agentplugin_preprocessing-0.3.25}/src/cluxion_agentplugin_preprocessing/cli.py

@@ -9,7 +9,7 @@ import sys
 from pathlib import Path
 from typing import TYPE_CHECKING
 
-from cluxion_agentplugin_preprocessing import __version__, hermes_config, runner
+from cluxion_agentplugin_preprocessing import __version__, hermes_config, hermes_deliver_patch, runner
 from cluxion_agentplugin_preprocessing.doctor import (
     render_json,
     render_text,
@@ -39,6 +39,8 @@ def main(argv: Sequence[str] | None = None) -> int:
         return _hermes_config(args)
     if args.command == "doctor":
         return _doctor(args)
+    if args.command == "hermes-patch":
+        return _hermes_patch(args)
     parser.print_help(sys.stderr)
     return 2
 
@@ -83,6 +85,22 @@ def _parser() -> argparse.ArgumentParser:
     doctor = subparsers.add_parser("doctor", help="Run embedded health checks")
     doctor.add_argument("--json", action="store_true")
     doctor.add_argument("--verbose", action="store_true")
+    patch = subparsers.add_parser(
+        "hermes-patch",
+        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="Deprecated alias for: hermes-patch status",
+    )
+    patch.add_argument("--dry-run", action="store_true")
+    patch.add_argument(
+        "--hermes-root",
+        default=None,
+        help="Hermes agent source root (default: auto-detect ~/.hermes/hermes-agent)",
+    )
     return parser
 
 
@@ -117,7 +135,8 @@ 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))
-    print(json.dumps({"ok": True, **result.to_dict()}, ensure_ascii=False, sort_keys=True))
+    payload = {"ok": True, **result.to_dict()}
+    print(json.dumps(payload, ensure_ascii=False, sort_keys=True))
     return 0
 
 
@@ -142,6 +161,21 @@ def _hermes_config(args: argparse.Namespace) -> int:
     return 0 if result.ok else 1
 
 
+def _hermes_root_arg(args: argparse.Namespace) -> Path | None:
+    raw = getattr(args, "hermes_root", None)
+    return Path(raw).expanduser() if raw else None
+
+
+def _hermes_patch(args: argparse.Namespace) -> int:
+    root = _hermes_root_arg(args)
+    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))
+    print(json.dumps({"ok": result.status == "applied", **result.to_dict()}, ensure_ascii=False, sort_keys=True))
+    return 0 if result.status == "applied" else 1
+
+
 def _doctor(args: argparse.Namespace) -> int:
     pkg = "cluxion_agentplugin_preprocessing.doctor"
     catalog_path = Path(str(importlib.resources.files(pkg).joinpath("catalog.json")))

{cluxion_agentplugin_preprocessing-0.3.23 → 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.23 → 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: