@engramprotocol/mcp-server 0.9.0 → 0.10.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dominik Tilman / Epistemic Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,72 +1,122 @@
 # @engramprotocol/mcp-server
 
-MCP-Wrapper für die EML HTTP-API. Macht das Engram Protocol als MCP-Tools für Claude Code (und andere MCP-Clients) verfügbar — Stdio-Transport, Bearer-Token-Auth gegen `api.engramprotocol.io` (Hosted) oder `localhost:3117` (Self-Host).
+MCP wrapper around the EML HTTP API. Exposes the Engram Protocol as MCP tools for Claude Code (and other MCP clients) — stdio transport, Bearer token auth against `api.engramprotocol.io`.
 
-## Install + Run
+Request an API token: **parsley_22bonds@icloud.com**
+
+## Install
 
 ```bash
-npx @engramprotocol/mcp-server --url <api-url> --token <bearer>
+EML_API_TOKEN=eml_<prefix><secret> \
+  npx @engramprotocol/mcp-server setup install
 ```
 
-oder via Env:
+The installer:
+- Verifies the token against `/stats` before storing
+- Writes `~/.eml/config` (chmod 600) with URL + token + client-version
+- Registers the `engramprotocol` MCP server via `claude mcp add` (user scope, stdio transport, semver-range-pinned to `@~0.10`)
+- Adds two hooks to `~/.claude/settings.json` (see [Hooks](#hooks) below):
+  - **SessionStart** → loads your brain at session start (identity, rules, decisions, status, tasks, protocol conventions)
+  - **UserPromptSubmit** → light mid-session reminder on turn 1, every 5 turns, or after >1h pause
+- Adds two permissions: `mcp__engramprotocol__*` (skip per-call prompt for EML tools) and `Bash(npx @engramprotocol/mcp-server setup *)` (let the agent auto-execute `setup update` when prompted)
+- Performs a final `/stats` round-trip as smoke test
+
+A backup of `~/.claude/settings.json` is created first (pattern `.pre-eml-install-YYYY-MM-DD-HH-MM-SS.bak`).
+
+### Update
 
 ```bash
-EML_API_URL=https://api.engramprotocol.io \
-EML_API_TOKEN=eml_<prefix><secret> \
-npx @engramprotocol/mcp-server
+npx @engramprotocol/mcp-server@latest setup update
 ```
 
-## Claude Code Config
-
-In `~/.config/claude-code/mcp_servers.json` (oder dem MCP-Config-Pfad deines Clients):
-
-```json
-{
-  "mcpServers": {
-    "eml": {
-      "command": "npx",
-      "args": [
-        "@engramprotocol/mcp-server",
-        "--url", "https://api.engramprotocol.io",
-        "--token", "eml_<prefix><secret>"
-      ]
-    }
-  }
-}
+Refreshes hook templates (marker-aware — preserves files you customised), bumps `EML_CLIENT_VERSION` in `~/.eml/config`. Idempotent. The `@latest` suffix busts the npx cache so you actually get the new version.
+
+### Uninstall
+
+```bash
+npx @engramprotocol/mcp-server setup uninstall
 ```
 
-Token bekommst du via `eml control bootstrap-user <email>` auf dem VPS (oder vom Self-Host-Server). Token wird einmalig nach stdout gedruckt — sicher abspeichern.
+Removes the MCP registration, the two managed hook entries, the two managed permission entries, and `~/.eml/hooks/`. Your own hooks and permissions are untouched. `~/.eml/config` is kept by default (asks for confirmation before delete — it contains your token).
+
+## Hooks
+
+Two bash hooks land in `~/.eml/hooks/`:
+
+### `session_start_boot.sh` (SessionStart event)
+- Sources `~/.eml/config`, POSTs to `/boot`, prints the returned markdown to stdout
+- Claude Code injects that stdout into model context — **invisible in chat** but reaches the model (verified empirically; behavior decided 2026-05-15)
+- Performs an update-banner check: if `EML_CLIENT_VERSION` from config differs from `/boot.version`, emits a banner pointing to `setup update`
+- Fail-soft: missing config, missing vars, or unreachable server emits a warning and exits 0 — session continues without brain
+
+### `user_prompt_submit_reminder.sh` (UserPromptSubmit event)
+- Local only, no HTTP
+- Triggers a 5-bullet reminder on turn 1, every 5 turns, or after >1h pause
+- Per-session turn counter at `/tmp/eml-turns/<session_id>`
+- Reminder content is a heredoc inside the script — refreshed via `setup update`
+
+Both hooks log to `~/.eml/logs/<event>-YYYY-MM-DD.log` (self-rotating per day) and carry a `# managed-by: engramprotocol-setup` marker line that lets `setup update` / `setup uninstall` identify which files they own.
 
-## Tools
+## Tools (v0.10.0)
+
+All tools have an `eml_` prefix. Total: **17 tools**.
+
+### Boot / Recall
+
+| Tool | HTTP endpoint | Use case |
+|---|---|---|
+| `eml_boot` | `POST /boot` | Manual brain-reload (SessionStart-Hook does this automatically at session start) |
+| `eml_recall` | `POST /recall` | Topic search (FTS5 + recency) |
+
+### Write (typed)
+
+| Tool | HTTP endpoint | Use case |
+|---|---|---|
+| `eml_decide` | `POST /context` (type=decision) | Record a deliberate, documented decision |
+| `eml_set_status` | `POST /context` (type=status) | Set current status for a scope (auto-supersedes old active status) |
+| `eml_track_task` | `POST /context` (type=task) | Plan/track a task with priority + due date |
+| `eml_note` | `POST /context` (kind-discriminated) | Catch-all for rule/profile/event/reference/log |
+
+### Read / Find
+
+| Tool | HTTP endpoint | Use case |
+|---|---|---|
+| `eml_show` | `GET /brain-state?scope=` | Curated snapshot for any scope |
+| `eml_list` | `GET /list` | Filter-based engram list |
+| `eml_get` | `GET /engram/:id` | Single engram + relations |
+| `eml_projects` | `GET /projects` | List projects (filter: status) |
+| `eml_entities` | `GET /entities` | List entities (filter: kind) |
+
+### Self-awareness / Edit
+
+| Tool | HTTP endpoint | Use case |
+|---|---|---|
+| `eml_stats` | `GET /stats` | Brain stats (counts per type/scope, container counts) |
+| `eml_update` | `POST /update` | Patch engram (status/properties/etc.) |
 
-Alle Tools haben den `eml_`-Prefix.
+### Container CRUD
 
-| Tool | HTTP-Endpoint | Use-Case |
+| Tool | HTTP endpoint | Use case |
 |---|---|---|
-| `eml_boot` | `POST /boot` | Identity + Status + Open Tasks bei Session-Start |
-| `eml_recall` | `POST /recall` | Topic-Suche (FTS5 + Recency) |
-| `eml_epistemic_store` | `POST /epistemic` | observation/hypothesis/assessment/prediction/pattern |
-| `eml_context_store` | `POST /context` | decision/rule/profile/status/task/event/log/reference |
-| `eml_list` | `GET /list[/mode]` | Filter-basierte Liste |
-| `eml_get` | `GET /engram/:id` | Einzelnes Engram + Relations |
-| `eml_relate` | `POST /relate` | Typed Relation zwischen 2 Engrams |
-| `eml_update` | `POST /update` | Patch (status/properties/etc.) |
-| `eml_confirm_review` | `POST /engram/:id/confirm-review` | review_due_at-Reset (Brain-Hygiene) |
-| `eml_entity_create` | `POST /entity` | Entity-Registrierung (Pflicht vor `entity.<id>`-scope) |
-| `eml_entity_list` | `GET /entities` | |
-| `eml_entity_get` | `GET /entity/:id` | |
-| `eml_entity_update` | `PUT /entity/:id` | |
+| `eml_project_create` | `POST /project` | Register a project (required before `scope=project.<id>`) |
+| `eml_project_update` | `PUT /project/:id` | Patch project fields |
+| `eml_entity_create` | `POST /entity` | Register an entity (required before `scope=entity.<id>`) |
+| `eml_entity_update` | `PUT /entity/:id` | Patch entity fields |
 
-## Error-Handling
+### Intentionally not exposed (v0.10.0)
 
-Backend-Errors (z.B. 401 invalid token, 400 invalid scope) kommen als `isError: true` mit klarer Message zurück — nicht als MCP-Protocol-Error. Das LLM kann sie selbst korrigieren.
+- `eml_relate` — available via HTTP API directly
+- `eml_confirm_review` — deferred to brain-hygiene cluster
+- Epistemic-mode write tools (observation/hypothesis/assessment/prediction/pattern) — Alpha-state, available via HTTP API
+- Session-Awareness tools — deferred to its own future version
+- `eml_*_delete` — by design not in the agent action space; cleanup is operator-only
 
-Protocol-Errors (malformed JSON-RPC, unbekannter Tool-Name) bleiben dem SDK.
+## Error handling
 
-## Self-Host
+Backend errors (e.g. 401 invalid token, 400 invalid scope) are returned as `isError: true` with a clear message — not as MCP protocol errors. The LLM can self-correct.
 
-Genau gleicher Aufruf, nur `--url http://localhost:3117` (oder der Port deiner Self-Host-Instance).
+Protocol errors (malformed JSON-RPC, unknown tool name) are handled by the SDK.
 
-## Lizenz
+## License
 
-UNLICENSED (v0.9). Public-Self-Host ab v1.0.
+MIT — see [LICENSE](./LICENSE).

package/dist/cli.js

@@ -1,5 +1,38 @@
 #!/usr/bin/env node
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 const server_1 = require("./server");
 function parseArgs(argv) {
@@ -26,25 +59,27 @@ function parseArgs(argv) {
     return out;
 }
 function printHelpAndExit(code) {
-    const msg = `eml-mcp-server — MCP-Wrapper für die EML HTTP-API
+    const msg = `eml-mcp-server — MCP wrapper for the EML HTTP API
 
 Usage:
   eml-mcp-server --url <api-url> --token <bearer> [--name <client-name>]
 
 Args:
-  --url     EML_API_URL      EML-API-URL (z.B. http://localhost:3117)
-  --token   EML_API_TOKEN    Bearer-Token (eml_<prefix><secret>)
-  --name    EML_CLIENT_NAME  Client-Name in Server-Logs (default: eml-mcp-server)
+  --url     EML_API_URL      EML API URL (e.g. http://localhost:3117)
+  --token   EML_API_TOKEN    Bearer token (eml_<prefix><secret>)
+  --name    EML_CLIENT_NAME  Client name in server logs (default: eml-mcp-server)
   --help
 
-Beispiel — Claude Code MCP-Config:
+Example — Claude Code MCP config:
   {
     "mcpServers": {
-      "eml": {
+      "engramprotocol": {
         "command": "npx",
-        "args": ["@engramprotocol/mcp-server",
-                 "--url", "https://api.engramprotocol.io",
-                 "--token", "eml_..."]
+        "args": ["-y", "@engramprotocol/mcp-server"],
+        "env": {
+          "EML_API_URL": "https://api.engramprotocol.io",
+          "EML_API_TOKEN": "eml_..."
+        }
       }
     }
   }
@@ -53,7 +88,15 @@ Beispiel — Claude Code MCP-Config:
     process.exit(code);
 }
 async function main() {
-    const args = parseArgs(process.argv.slice(2));
+    const argv = process.argv.slice(2);
+    // Dispatch: setup-mode vs server-mode
+    if (argv[0] === 'setup') {
+        const { runSetup } = await Promise.resolve().then(() => __importStar(require('./setup/index.js')));
+        await runSetup(argv.slice(1));
+        return;
+    }
+    // Server-mode (default)
+    const args = parseArgs(argv);
     if (args.help)
         printHelpAndExit(0);
     const url = args.url ?? process.env.EML_API_URL;

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AAEA,qCAAyC;AAuBzC,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,GAAG,GAAY,EAAE,CAAA;IACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;YAAC,SAAQ;QAAC,CAAC;QAC/D,IAAI,CAAC,KAAK,OAAO,EAAI,CAAC;YAAC,GAAG,CAAC,GAAG,GAAK,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAAC,SAAQ;QAAC,CAAC;QACxD,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAAC,SAAQ;QAAC,CAAC;QACxD,IAAI,CAAC,KAAK,QAAQ,EAAG,CAAC;YAAC,GAAG,CAAC,IAAI,GAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAAC,SAAQ;QAAC,CAAC;IAC1D,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY;IACpC,MAAM,GAAG,GAAG;;;;;;;;;;;;;;;;;;;;;;CAsBb,CAAA;IACC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACzB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACpB,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7C,IAAI,IAAI,CAAC,IAAI;QAAE,gBAAgB,CAAC,CAAC,CAAC,CAAA;IAElC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAA;IAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAA;IACrD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,gBAAgB,CAAA;IAE/E,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2EAA2E,CAAC,CAAA;QACjG,gBAAgB,CAAC,CAAC,CAAC,CAAA;IACrB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAA,uBAAc,EAAC,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAA;QAChD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sDAAsD,UAAU,MAAM,GAAG,KAAK,CAAC,CAAA;IACtG,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,CAAC,GAAG,GAAY,CAAA;QACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAA;QACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAA"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/http-client.d.ts

@@ -1,13 +1,13 @@
 /**
- * Thin fetch-Wrapper für die EML HTTP-API (v0.9-PROPOSAL §6.2).
+ * Thin fetch wrapper for the EML HTTP API (v0.9-PROPOSAL §6.2).
  *
- * Lebt absichtlich ohne `@engramprotocol/core`-Dependency — der MCP-Server
- * shippet als schlankes npm-Package (`@engramprotocol/mcp-server`), das nur
- * SDK + zod + dieses File braucht.
+ * Deliberately lives without an `@engramprotocol/core` dependency — the MCP
+ * server ships as a small npm package (`@engramprotocol/mcp-server`) that
+ * only needs the SDK + zod + this file.
  *
- * Error-Handling: alle Failures werfen ein `EmlApiError`. Tools fangen das
- * im Handler und mappen auf `isError: true`-Result (siehe v0.9-PROPOSAL §6.4
- * "Error-Handling — zwei Kanäle").
+ * Error handling: all failures throw `EmlApiError`. Tools catch it in the
+ * handler and map to an `isError: true` result (see v0.9-PROPOSAL §6.4
+ * "Error handling — two channels").
  */
 export interface HttpClientOptions {
     url: string;

package/dist/http-client.js

@@ -1,14 +1,14 @@
 "use strict";
 /**
- * Thin fetch-Wrapper für die EML HTTP-API (v0.9-PROPOSAL §6.2).
+ * Thin fetch wrapper for the EML HTTP API (v0.9-PROPOSAL §6.2).
  *
- * Lebt absichtlich ohne `@engramprotocol/core`-Dependency — der MCP-Server
- * shippet als schlankes npm-Package (`@engramprotocol/mcp-server`), das nur
- * SDK + zod + dieses File braucht.
+ * Deliberately lives without an `@engramprotocol/core` dependency — the MCP
+ * server ships as a small npm package (`@engramprotocol/mcp-server`) that
+ * only needs the SDK + zod + this file.
  *
- * Error-Handling: alle Failures werfen ein `EmlApiError`. Tools fangen das
- * im Handler und mappen auf `isError: true`-Result (siehe v0.9-PROPOSAL §6.4
- * "Error-Handling — zwei Kanäle").
+ * Error handling: all failures throw `EmlApiError`. Tools catch it in the
+ * handler and map to an `isError: true` result (see v0.9-PROPOSAL §6.4
+ * "Error handling — two channels").
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HttpClient = exports.EmlApiError = void 0;

package/dist/server.d.ts

@@ -1,12 +1,12 @@
 /**
- * MCP-Server-Setup (v0.9-PROPOSAL §6).
+ * MCP server setup (v0.9-PROPOSAL §6).
  *
- * Single-Mode HTTP-Client (kein eingebettetes SQLite). Self-Host nutzt es
- * genauso, nur mit `--url http://localhost:3117`.
+ * Single-mode HTTP client (no embedded SQLite). Self-host uses the same
+ * invocation, just with `--url http://localhost:3117`.
  *
- * Stdio-Transport: lokaler Process via Claude-Code's MCP-Config gestartet.
- * Capabilities: nur tools (statisch, listChanged=false). Resources/Prompts
- * kommen v0.9.x-Polish.
+ * Stdio transport: local process spawned by Claude Code's MCP config.
+ * Capabilities: tools only (static, listChanged=false). Resources/prompts
+ * are v0.9.x polish.
  */
 export interface McpServerOptions {
     url: string;

package/dist/setup/_helpers.d.ts

@@ -0,0 +1,71 @@
+export declare const HOME_DIR: string;
+export declare const EML_DIR: string;
+export declare const EML_CONFIG: string;
+export declare const EML_HOOKS_DIR: string;
+export declare const CLAUDE_DIR: string;
+export declare const CLAUDE_JSON: string;
+export declare const CLAUDE_SETTINGS: string;
+export declare const MANAGED_BY_MARKER = "engramprotocol-setup";
+export declare const MCP_SERVER_NAME = "engramprotocol";
+/** Resolve the package's own root (where templates/ lives). Works from dist/. */
+export declare function pkgRoot(): string;
+export declare function pkgVersion(): string;
+export declare function templatesDir(): string;
+export declare function promptText(question: string): Promise<string>;
+export declare function promptConfirm(question: string, defaultYes?: boolean): Promise<boolean>;
+export interface EmlConfig {
+    EML_URL?: string;
+    EML_API_TOKEN?: string;
+    EML_CLIENT_VERSION?: string;
+}
+export declare function readConfig(): EmlConfig | null;
+export declare function writeConfig(cfg: EmlConfig): void;
+export type SettingsJson = Record<string, any>;
+export declare function readSettings(): SettingsJson;
+export declare function backupSettings(): string;
+export declare function writeSettings(settings: SettingsJson): void;
+/** Add a permission entry to settings.permissions.allow if not already present. */
+export declare function mergePermission(settings: SettingsJson, entry: string): boolean;
+/** Remove permission entries matching the predicate. Returns count removed. */
+export declare function removePermissions(settings: SettingsJson, predicate: (entry: string) => boolean): number;
+export interface HookEntry {
+    hooks: Array<{
+        type: string;
+        command: string;
+    }>;
+    matcher?: string;
+}
+/** Add a command-hook to settings.hooks.<event>[] if no existing entry references the same command. */
+export declare function mergeHookCommand(settings: SettingsJson, event: string, command: string): boolean;
+/** Remove hook entries whose command starts with the given prefix (e.g. `$HOME/.eml/hooks/`). Returns count removed. */
+export declare function removeHooksByCommandPrefix(settings: SettingsJson, prefix: string): number;
+export declare function claudeCli(args: string[]): {
+    stdout: string;
+    stderr: string;
+    status: number;
+};
+export declare function claudeCliExists(): boolean;
+/** Unauthenticated reachability check — "is the server alive?". */
+export declare function verifyHealth(url: string): Promise<{
+    ok: boolean;
+    status?: number;
+    error?: string;
+}>;
+/** Authenticated round-trip — "does this token work?". Uses GET /stats (lightweight, auth-required). */
+export declare function verifyToken(url: string, token: string): Promise<{
+    ok: boolean;
+    status?: number;
+    error?: string;
+}>;
+export interface HookTemplate {
+    filename: string;
+    event: string;
+}
+export declare const HOOK_TEMPLATES: HookTemplate[];
+export declare function readTemplate(filename: string): string;
+export declare function hasMarker(content: string): boolean;
+export declare function installTemplate(filename: string): {
+    installedPath: string;
+    alreadyExisted: boolean;
+};
+//# sourceMappingURL=_helpers.d.ts.map

package/dist/setup/_helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_helpers.d.ts","sourceRoot":"","sources":["../../src/setup/_helpers.ts"],"names":[],"mappings":"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"}