forget-connect 0.5.0 → 0.5.2

package/assets/commands/forget-settings.md

@@ -0,0 +1,25 @@
+---
+description: forget settings — status, doctor, weekly report, cloud usage
+argument-hint: "[doctor|weekly|usage]"
+allowed-tools: Bash(~/.forget/venv/bin/forget-server recall:*), Bash(~/.forget/venv/bin/forget-server status:*), Bash(~/.forget/venv/bin/forget-server doctor:*), Bash(~/.forget/venv/bin/forget-server weekly:*), Bash(npx forget-connect doctor:*)
+---
+<!-- forget-connect:command v1 — delete this line to keep your edits across upgrades -->
+
+Recall dial:
+!`~/.forget/venv/bin/forget-server recall status 2>/dev/null`
+
+Argument: "$ARGUMENTS"
+
+- `doctor`: run `~/.forget/venv/bin/forget-server doctor`. If every line is ✓,
+  say "healthy" in one line; if any ✗, explain only that line's prescription (→)
+  and ask before running it.
+- `weekly`: run `~/.forget/venv/bin/forget-server weekly`; summarize the numbers only.
+- `usage`: run `~/.forget/venv/bin/forget-server recall cloud-usage` and show the
+  output as is.
+- No argument: combine the dial output above with
+  `~/.forget/venv/bin/forget-server status` into a settings screen of at most
+  4 lines: dial / server + memory count / LLM / anything unusual (only when
+  present). End with a short pointer: gear changes are /forget.
+  If deep recall is off: a running local LLM (Ollama · LM Studio) attaches
+  automatically; forget cloud (forget.sh/cloud) is the no-GPU alternative —
+  never install anything on the user's behalf.

package/assets/commands/forget.md

@@ -0,0 +1,24 @@
+---
+description: Recall dial — pick a gear (low·medium·high·extra)
+argument-hint: "[low|medium|high|extra]"
+allowed-tools: Bash(~/.forget/venv/bin/forget-server recall:*)
+---
+<!-- forget-connect:command v1 — delete this line to keep your edits across upgrades -->
+
+Current dial:
+!`~/.forget/venv/bin/forget-server recall status 2>/dev/null | head -1`
+
+Argument: "$ARGUMENTS"
+
+- If the argument is a gear name (low|medium|high|extra), immediately run
+  `~/.forget/venv/bin/forget-server recall use <gear>` and print only the
+  dial line from its output — no commentary.
+- If there is no argument, use AskUserQuestion to let the user pick a gear
+  (arrow keys). Question: "Recall gear" / header: "recall" / 4 options,
+  appending "(current)" to the label of the current gear:
+  · low — instant search (~0.2s, no LLM)
+  · medium — currently shares low's engine
+  · high — an LLM reads 40 candidates (~3s)
+  · extra — reads 100 candidates in full (~5s)
+  Apply the selection with `recall use` and print only the dial line.
+- Any other argument: answer with one line — "Settings live in /forget-settings".

package/assets/hooks/forget_sessionstart.py

@@ -24,6 +24,42 @@ FORGET_URL = os.environ.get("FORGET_MCP_URL", "http://127.0.0.1:8000/mcp")
 STATE_DIR = os.path.expanduser("~/.forget/hooks/state")
 CAPSULE_CHAR_BUDGET = 1_600  # ~400 tokens
 HANDOFF_MAX_AGE_SECONDS = 48 * 3600  # a stale shift-note is worse than none
+# The server capability these hooks are built against. The capsule response
+# carries server_version from 0.3.9 on; older servers silently drop arguments
+# these hooks send (project layering) — that mismatch must never be silent.
+REQUIRED_SERVER_VERSION = "0.3.9"
+
+
+def _version_tuple(value: str) -> tuple:
+    parts = []
+    for chunk in str(value or "").split("."):
+        digits = "".join(ch for ch in chunk if ch.isdigit())
+        parts.append(int(digits) if digits else 0)
+    return tuple(parts or [0])
+
+
+def _version_notice(server_version: str) -> str:
+    """One warning line for the capsule header area, or ''.
+
+    Two signals, no network: the server's self-reported version (mismatch =
+    features silently lost), and the update-check cache that doctor/status
+    maintain (a local file — hooks never call out).
+    """
+    if not server_version:
+        return "⚠ 서버가 버전을 안 밝힘(≤0.3.8) — 훅 기능 일부가 조용히 무시될 수 있음. 처방: forget-server upgrade"
+    if _version_tuple(server_version) < _version_tuple(REQUIRED_SERVER_VERSION):
+        return (
+            f"⚠ 서버 {server_version} < 훅 요구 {REQUIRED_SERVER_VERSION} — "
+            "프로젝트 층 등이 조용히 무시됨. 처방: forget-server upgrade"
+        )
+    try:
+        with open(os.path.expanduser("~/.forget/update-check.json"), encoding="utf-8") as fh:
+            latest = str(json.load(fh).get("latest") or "")
+        if latest and _version_tuple(server_version) < _version_tuple(latest):
+            return f"새 버전 {latest} 나옴 (현재 {server_version}) — forget-server upgrade"
+    except Exception:
+        pass
+    return ""
 
 
 def _consume_handoff() -> str:
@@ -97,10 +133,13 @@ def main() -> None:
         if isinstance(items, list) and items:
             capsule = "\n".join(f"- {item}" for item in items[:6] if isinstance(item, str))
     handoff = _consume_handoff()
+    notice = _version_notice(str(result.get("server_version") or ""))
     if not capsule and not handoff:
-        return  # low confidence → silence
+        return  # low confidence → silence (version nags don't earn a lone injection)
     shown = capsule[:CAPSULE_CHAR_BUDGET]
     parts = []
+    if notice:
+        parts.append(f"[forget 버전] {notice}")
     if handoff:
         parts.append(handoff)
     if shown:

package/assets/hooks/forget_turnrecall.py

@@ -118,7 +118,9 @@ def main() -> None:
     # possible, but only when the user asks for it — and it says so when it does.
     project = None if scope_disabled() else project_key_for_path(hook_input.get("cwd") or os.getcwd())
     crossed = bool(project) and wants_cross_project(prompt)
-    search_args: dict = {"query": prompt[:300], "top_k": MAX_RECALLS + 2}
+    # Per-turn ambient recall stays on the instant path — the recall dial is
+    # the user's explicit choice, not a tax on every keystroke.
+    search_args: dict = {"query": prompt[:300], "top_k": MAX_RECALLS + 2, "recall": "low"}
     if project and not crossed:
         search_args["filters"] = layered_filter(project)
     result = _rpc("search_memories", search_args)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forget-connect",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Safely connect Claude Code, Codex, and Claude Desktop to Forget memory.",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -22,11 +22,14 @@ import {
 } from "./core.js";
 import { doctorRemote } from "./doctor.js";
 import {
+  commandsDirFor,
   connectHooksSettings,
   disconnectHooksSettings,
   hooksDirFor,
   inspectHooks,
+  installCommandAssets,
   installHookScripts,
+  removeCommandAssets,
   removeHookScripts,
   settingsPathFor,
 } from "./hooks.js";
@@ -643,9 +646,11 @@ export async function run(argv = process.argv.slice(2), env = process.env) {
     }
     if (manageHooks && options.action === "connect") {
       stdout.write(`Would install hook scripts into ${hooksDir}\n`);
+      stdout.write(`Would install slash commands (/forget, /forget-settings) into ${commandsDirFor({ env })}\n`);
     }
     if (manageHooks && options.action === "disconnect") {
       stdout.write(`Would remove hook scripts from ${hooksDir}\n`);
+      stdout.write(`Would remove our slash commands from ${commandsDirFor({ env })} (user-edited files are kept)\n`);
     }
     return;
   }
@@ -656,6 +661,11 @@ export async function run(argv = process.argv.slice(2), env = process.env) {
     hookScriptPaths = options.action === "connect"
       ? await installHookScripts(hooksDir)
       : await removeHookScripts(hooksDir);
+    const commandsDir = commandsDirFor({ env });
+    const commandPaths = options.action === "connect"
+      ? await installCommandAssets(commandsDir)
+      : await removeCommandAssets(commandsDir);
+    hookScriptPaths = hookScriptPaths.concat(commandPaths);
   }
   const verb = options.action === "connect" ? "Connected" : "Disconnected";
   if (!result.changed.length && !hookScriptPaths.length) {
@@ -677,6 +687,7 @@ export async function run(argv = process.argv.slice(2), env = process.env) {
     }
     if (manageHooks) {
       stdout.write("  hooks: session capsule, per-turn recall, conflict alerts, session capture (needs python3 on PATH)\n");
+      stdout.write("  commands: /forget (the recall dial) · /forget-settings (status, doctor, cloud usage)\n");
     }
     if (options.hosted && !options.scope) {
       stdout.write(

package/src/hooks.js

@@ -258,3 +258,57 @@ export async function removeHookScripts(hooksDir) {
   }
   return removed;
 }
+
+// --- slash commands (/forget, /forget-settings) — the dial in the editor ---
+//
+// Same file-ownership rule as settings.json: a command file without our
+// marker is the user's (hand-written or edited with the marker removed) and
+// is never touched — not on connect, not on disconnect.
+
+export const COMMAND_ASSETS = ["forget.md", "forget-settings.md"];
+export const COMMAND_MARKER = "forget-connect:command";
+
+export function commandsDirFor(options = {}) {
+  const env = options.env ?? process.env;
+  const home = options.home ?? env.HOME ?? env.USERPROFILE ?? os.homedir();
+  return path.join(home, ".claude", "commands");
+}
+
+function commandAssetsDir() {
+  return fileURLToPath(new URL("../assets/commands/", import.meta.url));
+}
+
+export async function installCommandAssets(commandsDir) {
+  const written = [];
+  for (const name of COMMAND_ASSETS) {
+    const target = path.join(commandsDir, name);
+    let existing = null;
+    try {
+      existing = await readFile(target, "utf8");
+    } catch (error) {
+      if (!error || error.code !== "ENOENT") throw error;
+    }
+    if (existing !== null && !existing.includes(COMMAND_MARKER)) continue;
+    const content = await readFile(path.join(commandAssetsDir(), name), "utf8");
+    if (existing === content) continue;
+    await atomicWrite(target, content, 0o644);
+    written.push(target);
+  }
+  return written;
+}
+
+export async function removeCommandAssets(commandsDir) {
+  const removed = [];
+  for (const name of COMMAND_ASSETS) {
+    const target = path.join(commandsDir, name);
+    try {
+      const existing = await readFile(target, "utf8");
+      if (!existing.includes(COMMAND_MARKER)) continue;
+      await unlink(target);
+      removed.push(target);
+    } catch (error) {
+      if (!error || error.code !== "ENOENT") throw error;
+    }
+  }
+  return removed;
+}