cluxion-agentplugin-preprocessing 0.3.4__tar.gz → 0.3.7__tar.gz

{cluxion_agentplugin_preprocessing-0.3.4 → cluxion_agentplugin_preprocessing-0.3.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cluxion-agentplugin-preprocessing
-Version: 0.3.4
+Version: 0.3.7
 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
@@ -72,10 +72,23 @@ Hermes를 통해 제공되는 로컬 모델(vLLM/MLX)에서도 동일하게 동
 - **내 Chrome으로 웹 검색** — 본인의 로그인된 브라우저 세션으로 Google / Naver / Perplexity / 사내
   페이지를 검색합니다(위의 `[browser]` extra 필요).
 
+## 점검
+
+설치·Hermes 계약·작업큐·자원가드·네이티브 백엔드 상태를 결정론적으로 자가 진단합니다. 같은 상태면
+항상 같은 결과를 출력하고, 문제가 있으면 증상과 해결 단계를 그대로 알려줍니다.
+
+```bash
+cluxion-preprocess doctor          # 사람용 요약
+cluxion-preprocess doctor --json   # 구조화 출력
+```
+
+Hermes 안에서는 `cluxion_doctor` 도구로도 노출됩니다.
+
 ## 문제 해결
 
 | 증상 | 해결 |
 |---|---|
+| 무엇이든 이상함 | 먼저 `cluxion-preprocess doctor` 실행 — 원인과 해결 단계를 그대로 출력 |
 | `playwright_not_installed` | `pip install 'cluxion-agentplugin-preprocessing[browser]' && playwright install chromium` |
 | Hermes에 도구가 안 보임 | `cluxion-preprocess enable` 실행 후 Hermes 재시작 |
 
@@ -126,10 +139,24 @@ Once enabled, your agent gains these tools and calls them automatically:
 - **Web search via your Chrome** — searches Google / Naver / Perplexity / internal pages
   through your own logged-in browser session (needs the `[browser]` extra above).
 
+## Diagnostics
+
+A deterministic self-check of install, the Hermes contract, the work queue, the resource guard,
+and the native backend. The same state always prints the same result, and on any problem it
+shows the symptom and the exact fix steps.
+
+```bash
+cluxion-preprocess doctor          # human summary
+cluxion-preprocess doctor --json   # structured output
+```
+
+Also exposed inside Hermes as the `cluxion_doctor` tool.
+
 ## Troubleshooting
 
 | Problem | Fix |
 |---|---|
+| Anything looks off | run `cluxion-preprocess doctor` first — it prints the cause and the exact fix steps |
 | `playwright_not_installed` | `pip install 'cluxion-agentplugin-preprocessing[browser]' && playwright install chromium` |
 | Tools don't appear in Hermes | run `cluxion-preprocess enable`, then restart Hermes |
 

{cluxion_agentplugin_preprocessing-0.3.4 → cluxion_agentplugin_preprocessing-0.3.7}/README.md

@@ -40,10 +40,23 @@ Hermes를 통해 제공되는 로컬 모델(vLLM/MLX)에서도 동일하게 동
 - **내 Chrome으로 웹 검색** — 본인의 로그인된 브라우저 세션으로 Google / Naver / Perplexity / 사내
   페이지를 검색합니다(위의 `[browser]` extra 필요).
 
+## 점검
+
+설치·Hermes 계약·작업큐·자원가드·네이티브 백엔드 상태를 결정론적으로 자가 진단합니다. 같은 상태면
+항상 같은 결과를 출력하고, 문제가 있으면 증상과 해결 단계를 그대로 알려줍니다.
+
+```bash
+cluxion-preprocess doctor          # 사람용 요약
+cluxion-preprocess doctor --json   # 구조화 출력
+```
+
+Hermes 안에서는 `cluxion_doctor` 도구로도 노출됩니다.
+
 ## 문제 해결
 
 | 증상 | 해결 |
 |---|---|
+| 무엇이든 이상함 | 먼저 `cluxion-preprocess doctor` 실행 — 원인과 해결 단계를 그대로 출력 |
 | `playwright_not_installed` | `pip install 'cluxion-agentplugin-preprocessing[browser]' && playwright install chromium` |
 | Hermes에 도구가 안 보임 | `cluxion-preprocess enable` 실행 후 Hermes 재시작 |
 
@@ -94,10 +107,24 @@ Once enabled, your agent gains these tools and calls them automatically:
 - **Web search via your Chrome** — searches Google / Naver / Perplexity / internal pages
   through your own logged-in browser session (needs the `[browser]` extra above).
 
+## Diagnostics
+
+A deterministic self-check of install, the Hermes contract, the work queue, the resource guard,
+and the native backend. The same state always prints the same result, and on any problem it
+shows the symptom and the exact fix steps.
+
+```bash
+cluxion-preprocess doctor          # human summary
+cluxion-preprocess doctor --json   # structured output
+```
+
+Also exposed inside Hermes as the `cluxion_doctor` tool.
+
 ## Troubleshooting
 
 | Problem | Fix |
 |---|---|
+| Anything looks off | run `cluxion-preprocess doctor` first — it prints the cause and the exact fix steps |
 | `playwright_not_installed` | `pip install 'cluxion-agentplugin-preprocessing[browser]' && playwright install chromium` |
 | Tools don't appear in Hermes | run `cluxion-preprocess enable`, then restart Hermes |
 

{cluxion_agentplugin_preprocessing-0.3.4 → cluxion_agentplugin_preprocessing-0.3.7}/pyproject.toml

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

@@ -2,6 +2,6 @@
 
 from __future__ import annotations
 
-__version__ = "0.3.4"
+__version__ = "0.3.7"
 
 __all__ = ["__version__"]

{cluxion_agentplugin_preprocessing-0.3.4 → cluxion_agentplugin_preprocessing-0.3.7}/src/cluxion_agentplugin_preprocessing/cli.py

@@ -3,11 +3,18 @@
 from __future__ import annotations
 
 import argparse
+import importlib.resources
 import json
 import sys
+from pathlib import Path
 from typing import TYPE_CHECKING
 
 from cluxion_agentplugin_preprocessing import __version__, hermes_config, runner
+from cluxion_agentplugin_preprocessing.doctor import (
+    render_json,
+    render_text,
+    run_doctor,
+)
 from cluxion_runtime.bootstrap import ensure_local_runtime
 
 if TYPE_CHECKING:
@@ -30,34 +37,52 @@ def main(argv: Sequence[str] | None = None) -> int:
         return _disable(args)
     if args.command == "hermes-config":
         return _hermes_config(args)
+    if args.command == "doctor":
+        return _doctor(args)
     parser.print_help(sys.stderr)
     return 2
 
 
 def _parser() -> argparse.ArgumentParser:
     parser = argparse.ArgumentParser(prog="cluxion-preprocess")
-    parser.add_argument("--version", action="version", version=f"cluxion-agentplugin-preprocessing {__version__}")
+    parser.add_argument(
+        "--version", action="version", version=f"cluxion-agentplugin-preprocessing {__version__}"
+    )
     subparsers = parser.add_subparsers(dest="command")
     subparsers.add_parser("check", help="Check whether cluxion-runtime is visible")
-    bootstrap = subparsers.add_parser("bootstrap", help="Install or upgrade local runtime dependencies")
+    bootstrap = subparsers.add_parser(
+        "bootstrap", help="Install or upgrade local runtime dependencies"
+    )
     bootstrap.add_argument("--upgrade", action="store_true")
     bootstrap.add_argument("--dry-run", action="store_true")
     bootstrap.add_argument("--package", action="append", default=None)
-    status = subparsers.add_parser("status", help="Show whether Hermes config enables this plugin")
+    status = subparsers.add_parser(
+        "status", help="Show whether Hermes config enables this plugin"
+    )
     status.add_argument("--home", default=None)
-    enable = subparsers.add_parser("enable", help="Enable the pip-installed plugin in Hermes config")
+    enable = subparsers.add_parser(
+        "enable", help="Enable the pip-installed plugin in Hermes config"
+    )
     enable.add_argument("--home", default=None)
     enable.add_argument("--dry-run", action="store_true")
-    disable = subparsers.add_parser("disable", help="Disable the pip-installed plugin in Hermes config")
+    disable = subparsers.add_parser(
+        "disable", help="Disable the pip-installed plugin in Hermes config"
+    )
     disable.add_argument("--home", default=None)
     disable.add_argument("--dry-run", action="store_true")
-    config = subparsers.add_parser("hermes-config", help="Render Hermes local endpoint config through cluxion-runtime")
+    config = subparsers.add_parser(
+        "hermes-config",
+        help="Render Hermes local endpoint config through cluxion-runtime",
+    )
     config.add_argument("--model", required=True)
     config.add_argument("--host", default="127.0.0.1")
     config.add_argument("--port", type=int, default=23003)
     config.add_argument("--context-length", type=int, default=131_072)
     config.add_argument("--provider-key", default="cluxion-local")
     config.add_argument("--display-name", default="Cluxion Local")
+    doctor = subparsers.add_parser("doctor", help="Run embedded health checks")
+    doctor.add_argument("--json", action="store_true")
+    doctor.add_argument("--verbose", action="store_true")
     return parser
 
 
@@ -117,6 +142,28 @@ def _hermes_config(args: argparse.Namespace) -> int:
     return 0 if result.ok else 1
 
 
+def _doctor(args: argparse.Namespace) -> int:
+    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=__import__(
+            "cluxion_agentplugin_preprocessing.doctor.probes", fromlist=["PROBES"]
+        ).PROBES,
+        plugin="preprocessing",
+        version=__version__,
+    )
+    text = render_text(result, __import__(
+        "cluxion_agentplugin_preprocessing.doctor.framework", fromlist=["load_catalog"]
+    ).load_catalog(catalog_path), verbose=bool(args.verbose))
+    print(text, file=sys.stderr)
+    if args.json:
+        print(render_json(result))
+    return 0 if result.ok else 1
+
+
 if __name__ == "__main__":
     raise SystemExit(main())
 

cluxion_agentplugin_preprocessing-0.3.7/src/cluxion_agentplugin_preprocessing/doctor/__init__.py

@@ -0,0 +1,5 @@
+"""Embedded doctor for cluxion preprocessing plugin."""
+
+from .framework import DoctorResult, render_json, render_text, run_doctor
+
+__all__ = ["DoctorResult", "render_json", "render_text", "run_doctor"]