doctracker 0.3.0__tar.gz → 0.3.1__tar.gz

{doctracker-0.3.0 → doctracker-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: doctracker
-Version: 0.3.0
+Version: 0.3.1
 Summary: MCP server that centralizes the documentation of Python projects developed with LLM agents.
 Author: Carlos Filipe de Castro Lemos
 Author-email: Carlos Filipe de Castro Lemos <carlos.lemos.dev@gmail.com>

{doctracker-0.3.0 → doctracker-0.3.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "doctracker"
-version = "0.3.0"
+version = "0.3.1"
 description = "MCP server that centralizes the documentation of Python projects developed with LLM agents."
 readme = "README.md"
 license = "MIT"

{doctracker-0.3.0 → doctracker-0.3.1}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "doctracker"
-version = "0.3.0"
+version = "0.3.1"
 description = "MCP server that centralizes the documentation of Python projects developed with LLM agents."
 readme = "README.md"
 license = "MIT"

{doctracker-0.3.0 → doctracker-0.3.1}/src/doctracker/cli.py

@@ -71,7 +71,8 @@ def start(host: str | None, port: int | None) -> None:
 
 @main.command(hidden=True)
 @click.argument("event")
-def hook(event: str) -> None:
+@click.option("--url", help="Address of the server, as `start` wrote it; by default the one in the configuration.")
+def hook(event: str, url: str | None) -> None:
     """Answer a Claude Code hook: read its event on stdin, print the context of that moment.
 
     \f
@@ -79,6 +80,7 @@ def hook(event: str) -> None:
 
     Args:
         event: The Claude Code event the hook was set for (the event's own name is read from stdin).
+        url: The server, e.g. `http://127.0.0.1:8765`; None reads it from the configuration.
     """
     try:
         received = json.loads(sys.stdin.read() or "{}")
@@ -86,7 +88,7 @@ def hook(event: str) -> None:
         project_root = Path(received.get("cwd") or Path.cwd())
         if not (project_root / CONFIG_PATH).exists():
             return
-        reply = claude_code.answer(received, _base_url(load_config(project_root)))
+        reply = claude_code.answer(received, url or _base_url(load_config(project_root)))
     except (OSError, ValueError):
         return
     if reply:
@@ -119,7 +121,7 @@ def _write_integrations(project_root: Path, config: Config) -> None:
         project_root: Root of the project.
         config: The configuration, for the server's address.
     """
-    settings = claude_code.write_settings(project_root)
+    settings = claude_code.write_settings(project_root, _base_url(config))
     click.echo(f"Claude Code hooks: {settings.relative_to(project_root).as_posix()}")
     if opencode.uses_opencode(project_root):
         plugin = opencode.write_plugin(project_root, _base_url(config))

{doctracker-0.3.0 → doctracker-0.3.1}/src/doctracker/integrations/claude_code.py

@@ -1,9 +1,9 @@
 """Claude Code integration: the hooks that give doctracker's context to the agent, and their settings.
 
 `doctracker init` and `doctracker start` write the hooks into the project's
-`.claude/settings.local.json` (local, never committed). Each hook runs `doctracker hook <event>`,
-which reads the event Claude Code sends, asks the running server for the context of that moment
-(`/hooks/context/...`) and answers it as `additionalContext`.
+`.claude/settings.local.json` (local, never committed). Each hook runs `doctracker hook <event>`
+with the server's address, which reads the event Claude Code sends, asks the running server for the
+context of that moment (`/hooks/context/...`) and answers it as `additionalContext`.
 """
 
 import json
@@ -79,28 +79,30 @@ def _ask(base_url: str, kind: str, session: str, once: bool, path: str = "") ->
         return None
 
 
-def hook_command(event: str) -> str:
-    """The command a hook runs: this environment's doctracker, by its absolute path.
+def hook_command(event: str, base_url: str) -> str:
+    """The command a hook runs: this environment's doctracker, by its absolute path, with the server's address.
 
     Args:
         event: The Claude Code event.
+        base_url: The doctracker server, e.g. `http://127.0.0.1:8765`.
 
     Returns:
         The command line, with the program quoted (paths may have spaces).
     """
     program = shutil.which("doctracker", path=str(Path(sys.executable).parent))
     command = f'"{Path(program).as_posix()}"' if program else f'"{Path(sys.executable).as_posix()}" -m doctracker'
-    return f"{command} hook {event}"
+    return f'{command} hook {event} --url "{base_url}"'
 
 
-def write_settings(project_root: Path) -> Path:
+def write_settings(project_root: Path, base_url: str) -> Path:
     """Write doctracker's hooks into `.claude/settings.local.json` and switch Claude Code's own memory off.
 
     The file's other settings and hooks are kept; doctracker's own hooks (those running
-    `doctracker hook`) are replaced, so writing again only refreshes them.
+    `doctracker hook`) are replaced, so writing again only refreshes them (e.g. after a port change).
 
     Args:
         project_root: Root of the project.
+        base_url: The doctracker server the hooks ask, e.g. `http://127.0.0.1:8765`.
 
     Returns:
         The settings file.
@@ -110,7 +112,7 @@ def write_settings(project_root: Path) -> Path:
     hooks = settings.setdefault("hooks", {})
     for event, matcher in HOOKS.items():
         groups = [group for group in hooks.get(event, []) if not _is_ours(group)]
-        ours = {"hooks": [{"type": "command", "command": hook_command(event), "timeout": HOOK_TIMEOUT}]}
+        ours = {"hooks": [{"type": "command", "command": hook_command(event, base_url), "timeout": HOOK_TIMEOUT}]}
         groups.append({"matcher": matcher, **ours} if matcher else ours)
         hooks[event] = groups
     settings["autoMemoryEnabled"] = False