cluxion-Agentplugin-AutoClearMemory 0.3.2__tar.gz → 0.3.4__tar.gz

{cluxion_agentplugin_autoclearmemory-0.3.2 → cluxion_agentplugin_autoclearmemory-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cluxion-Agentplugin-AutoClearMemory
-Version: 0.3.2
+Version: 0.3.4
 Summary: Universal agent memory plugin (ForgetForge): recall-centric retention, tiered forgetting, Rust scoring engine for Hermes, Claude Code, and Codex.
 Project-URL: Homepage, https://github.com/cluxion/cluxion-Agentplugin-AutoClearMemory
 Project-URL: Repository, https://github.com/cluxion/cluxion-Agentplugin-AutoClearMemory
@@ -70,6 +70,18 @@ forgetforge status              # 무엇이 기억되어 있는지 확인합니
 Hermes에서는 동일한 동작이 `forgetforge_*` 도구로 제공되며, 가장 관련 있는("hot") 기억이 매 모델
 호출 전에 컨텍스트에 추가됩니다.
 
+## 점검
+
+설치·Hermes 계약·DB·네이티브 백엔드 상태를 결정론적으로 자가 진단합니다. 같은 상태면 항상 같은 결과를
+출력하고, 문제가 있으면 증상과 해결 단계를 그대로 알려줍니다.
+
+```bash
+forgetforge doctor          # 사람용 요약
+forgetforge doctor --json   # 구조화 출력
+```
+
+Hermes 안에서는 `forgetforge_doctor` 도구로도 노출됩니다.
+
 ## 라이선스
 
 Apache-2.0
@@ -115,6 +127,19 @@ forgetforge status              # see what's remembered
 In Hermes the same actions are available as `forgetforge_*` tools, and your most relevant
 ("hot") memories are added to the context before each model call.
 
+## Diagnostics
+
+A deterministic self-check of install, the Hermes contract, the database, 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
+forgetforge doctor          # human summary
+forgetforge doctor --json   # structured output
+```
+
+Also exposed inside Hermes as the `forgetforge_doctor` tool.
+
 ## License
 
 Apache-2.0

{cluxion_agentplugin_autoclearmemory-0.3.2 → cluxion_agentplugin_autoclearmemory-0.3.4}/README.md

@@ -40,6 +40,18 @@ forgetforge status              # 무엇이 기억되어 있는지 확인합니
 Hermes에서는 동일한 동작이 `forgetforge_*` 도구로 제공되며, 가장 관련 있는("hot") 기억이 매 모델
 호출 전에 컨텍스트에 추가됩니다.
 
+## 점검
+
+설치·Hermes 계약·DB·네이티브 백엔드 상태를 결정론적으로 자가 진단합니다. 같은 상태면 항상 같은 결과를
+출력하고, 문제가 있으면 증상과 해결 단계를 그대로 알려줍니다.
+
+```bash
+forgetforge doctor          # 사람용 요약
+forgetforge doctor --json   # 구조화 출력
+```
+
+Hermes 안에서는 `forgetforge_doctor` 도구로도 노출됩니다.
+
 ## 라이선스
 
 Apache-2.0
@@ -85,6 +97,19 @@ forgetforge status              # see what's remembered
 In Hermes the same actions are available as `forgetforge_*` tools, and your most relevant
 ("hot") memories are added to the context before each model call.
 
+## Diagnostics
+
+A deterministic self-check of install, the Hermes contract, the database, 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
+forgetforge doctor          # human summary
+forgetforge doctor --json   # structured output
+```
+
+Also exposed inside Hermes as the `forgetforge_doctor` tool.
+
 ## License
 
 Apache-2.0

{cluxion_agentplugin_autoclearmemory-0.3.2 → cluxion_agentplugin_autoclearmemory-0.3.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cluxion-Agentplugin-AutoClearMemory"
-version = "0.3.2"
+version = "0.3.4"
 description = "Universal agent memory plugin (ForgetForge): recall-centric retention, tiered forgetting, Rust scoring engine for Hermes, Claude Code, and Codex."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -65,6 +65,7 @@ packages = ["src/forgetforge"]
 [tool.hatch.build.targets.wheel.force-include]
 "adapters" = "forgetforge/data/adapters"
 "config.yaml.example" = "forgetforge/data/config.yaml.example"
+"src/forgetforge/doctor/catalog.json" = "forgetforge/doctor/catalog.json"
 
 [tool.hatch.build.targets.sdist]
 include = [
@@ -89,4 +90,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_autoclearmemory-0.3.2 → cluxion_agentplugin_autoclearmemory-0.3.4}/src/forgetforge/__init__.py

@@ -1,5 +1,5 @@
 """ForgetForge — recall-centric memory plugin for universal agent environments."""
 
-__version__ = "0.3.2"
+__version__ = "0.3.4"
 
 __all__ = ["__version__"]

{cluxion_agentplugin_autoclearmemory-0.3.2 → cluxion_agentplugin_autoclearmemory-0.3.4}/src/forgetforge/adapters/hermes.py

@@ -2,10 +2,13 @@ from __future__ import annotations
 
 import json
 from collections.abc import Callable
+from pathlib import Path
 
 from forgetforge import db, hot_inject, import_brief
 from forgetforge import store as store_api
 from forgetforge.config import load_config
+from forgetforge.doctor import render_json, run_doctor
+from forgetforge.doctor.probes import PROBES
 from forgetforge.schemas import (
     FORGET_SCHEMA,
     HOT_CONTEXT_SCHEMA,
@@ -67,6 +70,25 @@ def register(ctx: object) -> None:
         handler=_wrap(_handle_hot_context),
         emoji="🔥",
     )
+    # doctor tool
+    DOCTOR_SCHEMA = {
+        "name": "forgetforge_doctor",
+        "description": "Run the embedded forgetforge doctor checks for installation, Hermes contract, DB health, and runtime integrity.",
+        "parameters": {
+            "type": "object",
+            "properties": {
+                "verbose": {"type": "boolean", "description": "Include verbose details in output"}
+            },
+            "additionalProperties": False,
+        },
+    }
+    ctx.register_tool(
+        name="forgetforge_doctor",
+        toolset="forgetforge",
+        schema=DOCTOR_SCHEMA,
+        handler=_wrap(_handle_doctor),
+        emoji="🩺",
+    )
     register_hook = getattr(ctx, "register_hook", None)
     if callable(register_hook):
         register_hook("pre_llm_call", _pre_llm_hot_inject)
@@ -94,6 +116,24 @@ def _conn():
     return db.connect(cfg.db_path)
 
 
+def _handle_doctor(args: dict[str, object]) -> dict[str, object]:
+    try:
+        pkg = "forgetforge.doctor"
+        import importlib.resources
+        cat_path = Path(str(importlib.resources.files(pkg).joinpath("catalog.json")))
+    except Exception:
+        cat_path = Path(__file__).parent.parent.parent / "doctor" / "catalog.json"
+    result = run_doctor(
+        cwd=Path.cwd(),
+        catalog_path=cat_path,
+        probes=PROBES,
+        plugin="autoclearmemory",
+        version=__import__("forgetforge").__version__,
+    )
+    # return dict so _wrap json.dumps it; include the rendered json too
+    return {"ok": result.ok, "doctor_json": render_json(result), "checks_count": len(result.checks)}
+
+
 def _handle_store(args: dict[str, object]) -> dict[str, object]:
     conn = _conn()
     try:

{cluxion_agentplugin_autoclearmemory-0.3.2 → cluxion_agentplugin_autoclearmemory-0.3.4}/src/forgetforge/cli.py

@@ -1,12 +1,17 @@
 from __future__ import annotations
 
 import argparse
+import importlib.resources
 import json
 import sys
+from pathlib import Path
 from typing import TYPE_CHECKING
 
 from forgetforge import __version__, db, hot_inject, import_brief, init_assets, pruner, rust_bridge, store
 from forgetforge.config import default_home, load_config
+from forgetforge.doctor import render_json, render_text, run_doctor
+from forgetforge.doctor.framework import load_catalog
+from forgetforge.doctor.probes import PROBES
 
 if TYPE_CHECKING:
     from collections.abc import Sequence
@@ -37,6 +42,8 @@ def main(argv: Sequence[str] | None = None) -> int:
         return _import_brief(args)
     if args.command == "hot-context":
         return _hot_context(args)
+    if args.command == "doctor":
+        return _doctor(args)
     parser.print_help(sys.stderr)
     return 2
 
@@ -72,6 +79,9 @@ def _parser() -> argparse.ArgumentParser:
     brief.add_argument("--importance", type=float, default=0.65)
     hot = sub.add_parser("hot-context", help="Print hot-tier context block")
     hot.add_argument("--limit", type=int, default=8)
+    doctor = sub.add_parser("doctor", help="Run embedded doctor checks")
+    doctor.add_argument("--json", action="store_true")
+    doctor.add_argument("--verbose", action="store_true")
     return parser
 
 
@@ -117,7 +127,6 @@ def _init(args: argparse.Namespace) -> int:
 
 def _status() -> int:
     from forgetforge import recall
-
     cfg = load_config()
     conn = db.connect(cfg.db_path)
     stats = db.memory_stats(conn)
@@ -221,6 +230,28 @@ def _prune() -> int:
     return 0
 
 
+def _doctor(args: argparse.Namespace) -> int:
+    try:
+        pkg = "forgetforge.doctor"
+        cat_path = Path(str(importlib.resources.files(pkg).joinpath("catalog.json")))
+    except Exception:
+        cat_path = Path(__file__).parent.parent / "doctor" / "catalog.json"
+    result = run_doctor(
+        cwd=Path.cwd(),
+        catalog_path=cat_path,
+        probes=PROBES,
+        plugin="autoclearmemory",
+        version=__version__,
+    )
+    if getattr(args, "json", False):
+        print(render_json(result))
+    else:
+        cat_entries = load_catalog(cat_path)
+        text = render_text(result, cat_entries, verbose=getattr(args, "verbose", False))
+        print(text, file=sys.stderr)
+    return 0 if result.ok else 1
+
+
 def _parse_agents(raw: str) -> list[str]:
     if raw.strip().lower() == "all":
         return list(init_assets.known_agents())

cluxion_agentplugin_autoclearmemory-0.3.4/src/forgetforge/doctor/__init__.py

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