ver 1.0

echo-memory.plugin.src/skills/echo-memory/scripts/echo_doctor.py

@@ -0,0 +1,71 @@
+#!/usr/bin/env python3
+"""echo_doctor.py — M3: one-call readiness check.  [v1.0 SCAFFOLD — run() implemented]
+
+There is no single "is everything OK" command. doctor checks, in order, the things
+that make ECHO usable this session and prints a green/red report. Intended to back an
+`echo.py doctor` subcommand and the start of /echo-load when something looks wrong.
+
+Also tracked here (TODO): complete the `load` fallback — echo.cmd_load reads the
+heartbeat pointer but never lists _agent/sessions/ when it's missing/stale, though
+SKILL.md:122 documents that fallback. See patch_load_fallback() below.
+
+Exit: 0 all green · 1 a check is red.
+"""
+from __future__ import annotations
+
+import os
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+import echo  # noqa: E402
+
+MIN_PY = (3, 9)
+
+
+def run() -> int:
+    reds = 0
+
+    def line(ok: bool, label: str, detail: str = "") -> None:
+        nonlocal reds
+        reds += 0 if ok else 1
+        print(f"  [{'OK ' if ok else 'RED'}] {label}" + (f" — {detail}" if detail else ""))
+
+    print(f"echo doctor — endpoint {echo.BASE}")
+
+    # 1. interpreter
+    line(sys.version_info >= MIN_PY, f"python >= {MIN_PY[0]}.{MIN_PY[1]}",
+         f"running {sys.version_info.major}.{sys.version_info.minor}")
+
+    # 2. reachability + auth + marker, in one GET of the bootstrap marker
+    status, body = echo.request("GET", echo.vault_url("_agent/echo-vault.md"))
+    if status == 0:
+        line(False, "vault reachable", body.decode(errors="replace")[:120])
+        print("\ndoctor: endpoint unreachable — is Obsidian + the Local REST API running?")
+        return 1
+    line(status not in (401, 403), "auth accepted", f"HTTP {status}" if status in (401, 403) else "")
+    if status == 404:
+        line(False, "vault bootstrapped", "marker absent — run bootstrap.py")
+    elif status == 200:
+        text = body.decode(errors="replace")
+        ver = next((ln.split(":", 1)[1].strip() for ln in text.splitlines()
+                    if ln.startswith("schema_version:")), "?")
+        line(True, "vault bootstrapped", f"schema_version={ver}")
+    else:
+        line(status < 400, "marker fetch", f"HTTP {status}")
+
+    # 3. key source (M1) + invariants pointer.
+    import echo_secrets
+    key_src = ("ECHO_KEY env" if os.environ.get("ECHO_KEY")
+               else "credentials file" if (echo_secrets._state_dir() / "credentials").exists()
+               else "baked-in fallback (deprecated — see API-KEY-SETUP.md)")
+    line(os.environ.get("ECHO_KEY") is not None or (echo_secrets._state_dir() / "credentials").exists(),
+         "API key source", key_src)
+    print("  [i] invariants — run `/echo-health` (vault_lint.py) for the full check")
+
+    print(f"\ndoctor: {'all green' if reds == 0 else f'{reds} issue(s) — see RED above'}")
+    return 1 if reds else 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(run())