@engram-cli/engram 0.1.0

package/README.md

@@ -0,0 +1,103 @@
+# Engram CLI
+
+`npx @engram-cli/engram` — start, status, init, and MCP entry for the Engram local-first developer context hub.
+
+## Commands
+
+| Command | Purpose |
+| --- | --- |
+| `engram start` | Start **Supermemory Local** (`:6767`) and the **Engram backend** (`:7731`) in the foreground. One terminal, prefixed logs, Ctrl+C stops both. |
+| `engram status` | Check whether the Engram backend is reachable. |
+| `engram mcp` | Run the stdio MCP server for Cursor / Claude Code / other MCP clients. |
+| `engram init` | Install per-repo git hooks (`post-checkout`, `post-commit`) and append the terminal capture hook to `~/.zshrc` and `~/.bashrc`. Idempotent. |
+| `engram emit` | Internal command used by hooks to send events to the backend. |
+
+## Install
+
+From the monorepo:
+
+```bash
+cd cli && npm install && npm run build
+```
+
+For global use once published:
+
+```bash
+npx @engram-cli/engram init
+npx @engram-cli/engram start
+```
+
+## Environment variables
+
+| Variable | Default | Purpose |
+| --- | --- | --- |
+| `ENGRAM_BACKEND_URL` | `http://localhost:7731` | Engram backend base URL |
+| `SUPERMEMORY_BASE_URL` | `http://localhost:6767` | Supermemory Local base URL |
+| `SUPERMEMORY_API_KEY` | from repo `.env` | Required by the backend; the CLI prints a warning if `~/.supermemory/api-key` differs from `.env` |
+| `ENGRAM_PROJECT` | auto from git root | Project slug override for MCP and hooks |
+| `ENGRAM_SESSION_ID` | auto-generated | Session identifier for events |
+
+## MCP setup (Cursor)
+
+Add to `~/.cursor/mcp.json` (or Cursor Settings → MCP):
+
+```json
+{
+  "mcpServers": {
+    "engram": {
+      "command": "npx",
+      "args": ["-y", "@engram-cli/engram", "mcp"],
+      "env": { "ENGRAM_BACKEND_URL": "http://localhost:7731" }
+    }
+  }
+}
+```
+
+Available tools:
+
+- `engram_load_capsule` — load the saved project capsule
+- `engram_context` — assemble live Context from Supermemory
+- `engram_search` — search project memories with a natural-language query
+
+## Development
+
+```bash
+cd cli
+npm run dev    # tsx src/cli.ts start
+npm run build
+npm run typecheck
+```
+
+Smoke test (starts and stops real services):
+
+```bash
+bash scripts/smoke.sh
+```
+
+## Publish (npm org `engram-cli`)
+
+Log in as an org owner (`npm login` as `shubh1305`). Publish **contracts**, then the CLI:
+
+```bash
+# 1) Contracts
+cd packages/contracts
+npm run build
+npm publish --access public
+
+# 2) CLI — switch the local file: dep to the registry version, then publish
+cd ../../cli
+# in package.json: "@engram-cli/contracts": "^0.1.0"
+npm install
+npm run build
+npm publish --access public
+# restore "file:../packages/contracts" for monorepo work after publishing
+```
+
+After publish:
+
+```bash
+npx @engram-cli/engram start
+npx @engram-cli/engram init
+```
+
+Note: `engram start` looks for monorepo `backend/` via path walk. From a published install outside this repo, start the backend from a clone (or keep using the monorepo) until a standalone start path ships.

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { startCommand } from "./start.js";
+import { statusCommand } from "./status.js";
+import { runMcp } from "./mcp.js";
+import { initCommand } from "./init.js";
+import { emitCommand } from "./emit.js";
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+function getVersion() {
+    try {
+        const pkg = JSON.parse(readFileSync(path.join(__dirname, "..", "package.json"), "utf8"));
+        return pkg.version ?? "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+const program = new Command("engram")
+    .version(getVersion())
+    .description("Engram CLI + MCP — local-first developer context hub");
+program
+    .command("start")
+    .description("Start Supermemory Local and the Engram backend in the foreground")
+    .action(async () => {
+    await startCommand();
+});
+program
+    .command("status")
+    .description("Check whether the Engram backend is reachable")
+    .action(async () => {
+    await statusCommand();
+});
+program
+    .command("mcp")
+    .description("Run the stdio MCP server for Cursor / Claude Code")
+    .action(async () => {
+    await runMcp();
+});
+program
+    .command("init")
+    .description("Install git hooks and terminal hook into the current repo")
+    .action(async () => {
+    await initCommand();
+});
+program
+    .command("emit")
+    .description("Emit an event to the Engram backend (used by hooks)")
+    .requiredOption("--source <source>", "event source: terminal | git")
+    .requiredOption("--type <type>", "event type: command | branch_switch | commit")
+    .requiredOption("--content <content>", "event content")
+    .option("--cwd <cwd>", "working directory")
+    .option("--exit-code <n>", "exit code for command events", parseInt)
+    .option("--session-id <id>", "session id")
+    .option("--project <project>", "project slug override")
+    .option("--dry-run", "print event JSON instead of sending")
+    .action(async (opts) => {
+    const result = await emitCommand({
+        source: opts.source,
+        eventType: opts.type,
+        content: opts.content,
+        cwd: opts.cwd,
+        exitCode: opts.exitCode,
+        sessionId: opts.sessionId,
+        project: opts.project,
+        dryRun: opts.dryRun,
+    });
+    if (!result.sent) {
+        process.exitCode = 0;
+    }
+});
+program.parseAsync(process.argv).catch((err) => {
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,39 @@
+import { type MemoryEvent } from "@engram-cli/contracts";
+export interface HealthResponse {
+    ok: boolean;
+    supermemory?: boolean;
+    supabase?: boolean | null;
+}
+export interface EventResponse {
+    accepted: boolean;
+    dropped?: boolean;
+    id?: string;
+    reason?: string;
+}
+export interface SearchResult {
+    id?: string;
+    chunk?: string;
+    memory?: string;
+    similarity?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface SearchResponse {
+    project: string;
+    containerTag: string;
+    total: number;
+    results: SearchResult[];
+}
+export declare class EngramClient {
+    private baseUrl;
+    constructor(baseUrl: string);
+    private url;
+    private request;
+    health(): Promise<HealthResponse>;
+    postEvent(event: MemoryEvent): Promise<EventResponse>;
+    getContext(project: string, ide?: string): Promise<unknown>;
+    loadCapsule(project: string): Promise<unknown>;
+    search(project: string, q: string, limit?: number): Promise<SearchResponse>;
+    /** Fire-and-forget event ingest. Never throws. */
+    postEventSilent(event: MemoryEvent): void;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,qBAAa,YAAY;IACX,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,MAAM;IAEnC,OAAO,CAAC,GAAG;YAIG,OAAO;IA2Bf,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;IAIjC,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;IAOrD,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAM3D,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAO9C,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,cAAc,CAAC;IAO7E,kDAAkD;IAClD,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;CAK1C"}

package/dist/client.js

@@ -0,0 +1,69 @@
+export class EngramClient {
+    baseUrl;
+    constructor(baseUrl) {
+        this.baseUrl = baseUrl;
+    }
+    url(path) {
+        return `${this.baseUrl.replace(/\/$/, "")}${path}`;
+    }
+    async request(path, init) {
+        const res = await fetch(this.url(path), {
+            ...init,
+            headers: {
+                "content-type": "application/json",
+                ...(init?.headers ?? {}),
+            },
+        });
+        const text = await res.text();
+        let body = undefined;
+        if (text) {
+            try {
+                body = JSON.parse(text);
+            }
+            catch {
+                body = text;
+            }
+        }
+        if (!res.ok) {
+            const msg = typeof body === "object" && body && "message" in body
+                ? String(body.message)
+                : text || res.statusText;
+            throw new Error(`${res.status} ${path}: ${msg}`);
+        }
+        return body;
+    }
+    async health() {
+        return this.request("/health");
+    }
+    async postEvent(event) {
+        return this.request("/event", {
+            method: "POST",
+            body: JSON.stringify(event),
+        });
+    }
+    async getContext(project, ide) {
+        const q = new URLSearchParams({ project });
+        if (ide)
+            q.set("ide", ide);
+        return this.request(`/context?${q}`);
+    }
+    async loadCapsule(project) {
+        return this.request("/capsule/load", {
+            method: "POST",
+            body: JSON.stringify({ project }),
+        });
+    }
+    async search(project, q, limit = 10) {
+        return this.request("/search", {
+            method: "POST",
+            body: JSON.stringify({ project, q, limit }),
+        });
+    }
+    /** Fire-and-forget event ingest. Never throws. */
+    postEventSilent(event) {
+        void this.postEvent(event).catch(() => {
+            // silently drop — hooks must never block the shell
+        });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,17 @@
+export declare const DEFAULT_BACKEND_URL = "http://localhost:7731";
+export declare const DEFAULT_SUPERMEMORY_URL = "http://localhost:6767";
+export interface CliConfig {
+    backendUrl: string;
+    supermemoryUrl: string;
+    project?: string;
+    sessionId: string;
+    cwd: string;
+}
+export declare function env(key: string, fallback: string): string;
+export declare function getBackendUrl(): string;
+export declare function getSupermemoryUrl(): string;
+export declare function getProjectOverride(): string | undefined;
+export declare function getSessionId(): string;
+export declare function getRepoRootFromGit(cwd?: string): string | undefined;
+export declare function makeConfig(): CliConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB,0BAA0B,CAAC;AAC3D,eAAO,MAAM,uBAAuB,0BAA0B,CAAC;AAE/D,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAEvD;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,kBAAkB,CAAC,GAAG,SAAgB,GAAG,MAAM,GAAG,SAAS,CAW1E;AAED,wBAAgB,UAAU,IAAI,SAAS,CAQtC"}

package/dist/config.js

@@ -0,0 +1,41 @@
+import { execSync } from "node:child_process";
+export const DEFAULT_BACKEND_URL = "http://localhost:7731";
+export const DEFAULT_SUPERMEMORY_URL = "http://localhost:6767";
+export function env(key, fallback) {
+    return process.env[key] ?? fallback;
+}
+export function getBackendUrl() {
+    return env("ENGRAM_BACKEND_URL", DEFAULT_BACKEND_URL).replace(/\/$/, "");
+}
+export function getSupermemoryUrl() {
+    return env("SUPERMEMORY_BASE_URL", DEFAULT_SUPERMEMORY_URL).replace(/\/$/, "");
+}
+export function getProjectOverride() {
+    return process.env.ENGRAM_PROJECT;
+}
+export function getSessionId() {
+    return process.env.ENGRAM_SESSION_ID ?? `cli-${Date.now()}-${process.pid}`;
+}
+export function getRepoRootFromGit(cwd = process.cwd()) {
+    try {
+        const out = execSync("git rev-parse --show-toplevel", {
+            cwd,
+            encoding: "utf8",
+            stdio: ["pipe", "pipe", "ignore"],
+        });
+        return out.trim() || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function makeConfig() {
+    return {
+        backendUrl: getBackendUrl(),
+        supermemoryUrl: getSupermemoryUrl(),
+        project: getProjectOverride(),
+        sessionId: getSessionId(),
+        cwd: process.cwd(),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,CAAC,MAAM,mBAAmB,GAAG,uBAAuB,CAAC;AAC3D,MAAM,CAAC,MAAM,uBAAuB,GAAG,uBAAuB,CAAC;AAU/D,MAAM,UAAU,GAAG,CAAC,GAAW,EAAE,QAAgB;IAC/C,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,GAAG,CAAC,oBAAoB,EAAE,mBAAmB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,GAAG,CAAC,sBAAsB,EAAE,uBAAuB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IACpD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,QAAQ,CAAC,+BAA+B,EAAE;YACpD,GAAG;YACH,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;SAClC,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,UAAU,EAAE,aAAa,EAAE;QAC3B,cAAc,EAAE,iBAAiB,EAAE;QACnC,OAAO,EAAE,kBAAkB,EAAE;QAC7B,SAAS,EAAE,YAAY,EAAE;QACzB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;KACnB,CAAC;AACJ,CAAC"}

package/dist/emit.d.ts

@@ -0,0 +1,18 @@
+export interface EmitCommandOptions {
+    source: "terminal" | "git";
+    eventType: "command" | "branch_switch" | "commit";
+    content: string;
+    cwd?: string;
+    exitCode?: number;
+    stderr?: string;
+    sessionId?: string;
+    project?: string;
+    dryRun?: boolean;
+}
+export declare function emitCommand(opts: EmitCommandOptions): Promise<{
+    sent: boolean;
+    id?: string;
+}>;
+/** Fire-and-forget. Never blocks the shell or prints to stderr. */
+export declare function emitCommandSilent(opts: EmitCommandOptions): void;
+//# sourceMappingURL=emit.d.ts.map

package/dist/emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../src/emit.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,UAAU,GAAG,KAAK,CAAC;IAC3B,SAAS,EAAE,SAAS,GAAG,eAAe,GAAG,QAAQ,CAAC;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAmCzC;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAIhE"}

package/dist/emit.js

@@ -0,0 +1,42 @@
+import { isSignalCommand } from "@engram-cli/contracts";
+import { EngramClient } from "./client.js";
+import { getBackendUrl, getSessionId } from "./config.js";
+import { resolveProjectSlug } from "./project.js";
+export async function emitCommand(opts) {
+    const project = resolveProjectSlug(opts.cwd, opts.project);
+    const sessionId = opts.sessionId ?? getSessionId();
+    const cwd = opts.cwd ?? process.cwd();
+    const timestamp = new Date().toISOString();
+    if (opts.eventType === "command") {
+        const exitCode = opts.exitCode ?? 0;
+        if (exitCode === 0 && !isSignalCommand(opts.content)) {
+            return { sent: false };
+        }
+    }
+    const event = {
+        source: opts.source,
+        event_type: opts.eventType,
+        content: opts.content,
+        project,
+        cwd,
+        timestamp,
+        session_id: sessionId,
+    };
+    if (opts.eventType === "command") {
+        event.exit_code = opts.exitCode ?? 0;
+    }
+    if (opts.dryRun) {
+        console.log(JSON.stringify(event, null, 2));
+        return { sent: false };
+    }
+    const client = new EngramClient(getBackendUrl());
+    const res = await client.postEvent(event);
+    return { sent: res.accepted && !res.dropped, id: res.id };
+}
+/** Fire-and-forget. Never blocks the shell or prints to stderr. */
+export function emitCommandSilent(opts) {
+    void emitCommand(opts).catch(() => {
+        // swallow — shell hooks must not interrupt the prompt
+    });
+}
+//# sourceMappingURL=emit.js.map

package/dist/emit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.js","sourceRoot":"","sources":["../src/emit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAclD,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAwB;IAExB,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,YAAY,EAAE,CAAC;IACnD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE3C,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;QACpC,IAAI,QAAQ,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACrD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAgB;QACzB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,UAAU,EAAE,IAAI,CAAC,SAAS;QAC1B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,OAAO;QACP,GAAG;QACH,SAAS;QACT,UAAU,EAAE,SAAS;KACtB,CAAC;IAEF,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACjC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5C,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACzB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,aAAa,EAAE,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1C,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;AAC5D,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,iBAAiB,CAAC,IAAwB;IACxD,KAAK,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;QAChC,sDAAsD;IACxD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/init.d.ts

@@ -0,0 +1,2 @@
+export declare function initCommand(): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAiFA,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAyCjD"}

package/dist/init.js

@@ -0,0 +1,99 @@
+import fs from "node:fs";
+import path from "node:path";
+import { execSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { normalizeProjectSlug } from "@engram-cli/contracts";
+import { getBackendUrl } from "./config.js";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const ENGRAM_RC_BLOCK_START = "# >>> engram terminal hook >>>";
+const ENGRAM_RC_BLOCK_END = "# <<< engram terminal hook <<<";
+const ENGRAM_HOOK_MARKER = "# Engram capture hook (managed by npx @engram-cli/engram init)";
+function findMonorepoRoot() {
+    let dir = __dirname;
+    for (let i = 0; i < 4; i++) {
+        dir = path.dirname(dir);
+        if (fs.existsSync(path.join(dir, "cli")) &&
+            fs.existsSync(path.join(dir, "terminal-hook")) &&
+            fs.existsSync(path.join(dir, "git-hooks"))) {
+            return dir;
+        }
+    }
+    return undefined;
+}
+function getRepoRoot() {
+    try {
+        return execSync("git rev-parse --show-toplevel", {
+            encoding: "utf8",
+            stdio: ["pipe", "pipe", "ignore"],
+        }).trim();
+    }
+    catch {
+        throw new Error("Not inside a git repository. Run `git init` first.");
+    }
+}
+function getProjectName(repoRoot) {
+    return normalizeProjectSlug(path.basename(repoRoot));
+}
+function ensureDir(dir) {
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+}
+function installGitHook(name, sourcePath, hooksDir) {
+    const targetPath = path.join(hooksDir, name);
+    const source = fs.readFileSync(sourcePath, "utf8");
+    if (fs.existsSync(targetPath)) {
+        const existing = fs.readFileSync(targetPath, "utf8");
+        if (existing.includes(ENGRAM_HOOK_MARKER)) {
+            console.log(`[engram] ${name} already installed`);
+            return;
+        }
+        // merge by appending our source below the marker
+        const merged = existing.trimEnd() + "\n\n" + ENGRAM_HOOK_MARKER + "\n" + source;
+        fs.writeFileSync(targetPath, merged, { mode: 0o755 });
+        console.log(`[engram] updated ${name}`);
+        return;
+    }
+    fs.writeFileSync(targetPath, ENGRAM_HOOK_MARKER + "\n" + source, { mode: 0o755 });
+    console.log(`[engram] installed ${name}`);
+}
+function installTerminalHook(shellRcPath, hookSourcePath) {
+    const rc = fs.existsSync(shellRcPath) ? fs.readFileSync(shellRcPath, "utf8") : "";
+    if (rc.includes(ENGRAM_RC_BLOCK_START)) {
+        console.log(`[engram] terminal hook already in ${shellRcPath}`);
+        return;
+    }
+    const hook = fs.readFileSync(hookSourcePath, "utf8");
+    const block = `${ENGRAM_RC_BLOCK_START}\n${hook}\n${ENGRAM_RC_BLOCK_END}\n`;
+    fs.writeFileSync(shellRcPath, rc.trimEnd() + "\n\n" + block, { mode: 0o644 });
+    console.log(`[engram] ${rc ? "appended" : "created"} terminal hook in ${shellRcPath}`);
+}
+export async function initCommand() {
+    const repoRoot = getRepoRoot();
+    const project = getProjectName(repoRoot);
+    const hooksDir = path.join(repoRoot, ".git", "hooks");
+    const monorepoRoot = findMonorepoRoot();
+    const bundledTemplates = path.resolve(__dirname, "..", "templates");
+    const terminalHookDir = fs.existsSync(path.join(bundledTemplates, "engram-terminal.zsh"))
+        ? bundledTemplates
+        : monorepoRoot
+            ? path.join(monorepoRoot, "terminal-hook")
+            : undefined;
+    const gitHooksDir = fs.existsSync(path.join(bundledTemplates, "post-checkout"))
+        ? bundledTemplates
+        : monorepoRoot
+            ? path.join(monorepoRoot, "git-hooks")
+            : undefined;
+    if (!terminalHookDir || !gitHooksDir) {
+        throw new Error("Could not locate Engram hook templates. " +
+            "Make sure `engram` is installed from the monorepo or npm, or install hooks manually.");
+    }
+    ensureDir(hooksDir);
+    installGitHook("post-checkout", path.join(gitHooksDir, "post-checkout"), hooksDir);
+    installGitHook("post-commit", path.join(gitHooksDir, "post-commit"), hooksDir);
+    installTerminalHook(path.join(process.env.HOME ?? "~", ".zshrc"), path.join(terminalHookDir, "engram-terminal.zsh"));
+    installTerminalHook(path.join(process.env.HOME ?? "~", ".bashrc"), path.join(terminalHookDir, "engram-terminal.bash"));
+    console.log(`\n[engram] init complete for project "${project}"`);
+    console.log(`[engram] backend: ${getBackendUrl()}`);
+    console.log(`[engram] next: run \\\"engram start\\\" in another terminal, then reload your shell`);
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D,MAAM,qBAAqB,GAAG,gCAAgC,CAAC;AAC/D,MAAM,mBAAmB,GAAG,gCAAgC,CAAC;AAC7D,MAAM,kBAAkB,GAAG,gEAAgE,CAAC;AAE5F,SAAS,gBAAgB;IACvB,IAAI,GAAG,GAAG,SAAS,CAAC;IACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACxB,IACE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACpC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;YAC9C,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,EAC1C,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,WAAW;IAClB,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,+BAA+B,EAAE;YAC/C,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;SAClC,CAAC,CAAC,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB;IACtC,OAAO,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,UAAkB,EAAE,QAAgB;IACxE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAEnD,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACrD,IAAI,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,oBAAoB,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QACD,iDAAiD;QACjD,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,GAAG,MAAM,GAAG,kBAAkB,GAAG,IAAI,GAAG,MAAM,CAAC;QAChF,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;QACxC,OAAO;IACT,CAAC;IAED,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAClF,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,mBAAmB,CAAC,WAAmB,EAAE,cAAsB;IACtE,MAAM,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAClF,IAAI,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,qCAAqC,WAAW,EAAE,CAAC,CAAC;QAChE,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,GAAG,qBAAqB,KAAK,IAAI,KAAK,mBAAmB,IAAI,CAAC;IAC5E,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,EAAE,CAAC,OAAO,EAAE,GAAG,MAAM,GAAG,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9E,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,qBAAqB,WAAW,EAAE,CAAC,CAAC;AACzF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAEtD,MAAM,YAAY,GAAG,gBAAgB,EAAE,CAAC;IACxC,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IACpE,MAAM,eAAe,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,qBAAqB,CAAC,CAAC;QACvF,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,YAAY;YACZ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC;YAC1C,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,WAAW,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;QAC7E,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,YAAY;YACZ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC;YACtC,CAAC,CAAC,SAAS,CAAC;IAEhB,IAAI,CAAC,eAAe,IAAI,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CACb,0CAA0C;YACxC,sFAAsF,CACzF,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,QAAQ,CAAC,CAAC;IACpB,cAAc,CAAC,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC,EAAE,QAAQ,CAAC,CAAC;IACnF,cAAc,CAAC,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,EAAE,QAAQ,CAAC,CAAC;IAE/E,mBAAmB,CACjB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,EAAE,QAAQ,CAAC,EAC5C,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,qBAAqB,CAAC,CAClD,CAAC;IACF,mBAAmB,CACjB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,EAAE,SAAS,CAAC,EAC7C,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,sBAAsB,CAAC,CACnD,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,yCAAyC,OAAO,GAAG,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,CAAC,qBAAqB,aAAa,EAAE,EAAE,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,qFAAqF,CAAC,CAAC;AACrG,CAAC"}

package/dist/mcp.d.ts

@@ -0,0 +1,2 @@
+export declare function runMcp(): Promise<void>;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAiCA,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CA2E5C"}

package/dist/mcp.js

@@ -0,0 +1,75 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, McpError, ErrorCode, } from "@modelcontextprotocol/sdk/types.js";
+import { EngramClient } from "./client.js";
+import { getBackendUrl } from "./config.js";
+import { resolveProjectSlug } from "./project.js";
+function makeTool(name, description, args) {
+    const properties = {};
+    const required = [];
+    for (const arg of args) {
+        properties[arg.name] = { type: arg.type, description: arg.description };
+        if (arg.required)
+            required.push(arg.name);
+    }
+    return {
+        name,
+        description,
+        inputSchema: { type: "object", properties, required },
+    };
+}
+export async function runMcp() {
+    const backendUrl = getBackendUrl();
+    const client = new EngramClient(backendUrl);
+    const server = new Server({ name: "engram", version: "0.1.0" }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: [
+            makeTool("engram_load_capsule", "Load the saved project capsule for a given Engram project. Returns the frozen snapshot including recent files, errors, failed commands, git state, and notes.", [{ name: "project", type: "string", description: "Engram project slug", required: true }]),
+            makeTool("engram_context", "Assemble the current live Context capsule for a project from Supermemory. This is read-only and reflects the latest captured intent.", [{ name: "project", type: "string", description: "Engram project slug", required: true }]),
+            makeTool("engram_search", "Search the Supermemory graph for a project using a natural-language query.", [
+                { name: "project", type: "string", description: "Engram project slug", required: true },
+                { name: "q", type: "string", description: "Natural language query", required: true },
+                { name: "limit", type: "number", description: "Max results (default 10)", required: false },
+            ]),
+        ],
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: rawArgs } = request.params;
+        const args = rawArgs ?? {};
+        if (name === "engram_load_capsule") {
+            const project = resolveProjectSlug(undefined, String(args.project ?? ""));
+            const capsule = await client.loadCapsule(project);
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(capsule, null, 2) },
+                ],
+            };
+        }
+        if (name === "engram_context") {
+            const project = resolveProjectSlug(undefined, String(args.project ?? ""));
+            const context = await client.getContext(project, "cursor");
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(context, null, 2) },
+                ],
+            };
+        }
+        if (name === "engram_search") {
+            const project = resolveProjectSlug(undefined, String(args.project ?? ""));
+            const q = String(args.q ?? "");
+            const limit = typeof args.limit === "number" ? args.limit : 10;
+            if (!q)
+                throw new McpError(ErrorCode.InvalidParams, "Missing query parameter q");
+            const results = await client.search(project, q, limit);
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(results, null, 2) },
+                ],
+            };
+        }
+        throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

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

package/dist/project.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveProjectSlug(cwd?: string, override?: string): string;
+//# sourceMappingURL=project.d.ts.map

package/dist/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAIA,wBAAgB,kBAAkB,CAAC,GAAG,SAAgB,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CASjF"}

package/dist/project.js

@@ -0,0 +1,13 @@
+import path from "node:path";
+import { normalizeProjectSlug } from "@engram-cli/contracts";
+import { getRepoRootFromGit } from "./config.js";
+export function resolveProjectSlug(cwd = process.cwd(), override) {
+    if (override)
+        return normalizeProjectSlug(override);
+    const root = getRepoRootFromGit(cwd);
+    if (!root) {
+        throw new Error("Could not determine Engram project. Run inside a git repo or set ENGRAM_PROJECT.");
+    }
+    return normalizeProjectSlug(path.basename(root));
+}
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,UAAU,kBAAkB,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,QAAiB;IACvE,IAAI,QAAQ;QAAE,OAAO,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,kFAAkF,CACnF,CAAC;IACJ,CAAC;IACD,OAAO,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/start.d.ts

@@ -0,0 +1,2 @@
+export declare function startCommand(): Promise<void>;
+//# sourceMappingURL=start.d.ts.map

package/dist/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"AAgLA,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAmElD"}

package/dist/start.js

@@ -0,0 +1,219 @@
+import { spawn } from "node:child_process";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { getBackendUrl, getSupermemoryUrl } from "./config.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const SM_DATA_DIR = path.join(os.homedir(), ".supermemory");
+const SM_API_KEY_FILE = path.join(SM_DATA_DIR, "api-key");
+const REPO_ENV = path.resolve(__dirname, "..", "..", ".env");
+function findMonorepoRoot() {
+    let dir = __dirname;
+    for (let i = 0; i < 4; i++) {
+        dir = path.dirname(dir);
+        if (fs.existsSync(path.join(dir, "backend")) && fs.existsSync(path.join(dir, "packages"))) {
+            return dir;
+        }
+    }
+    return undefined;
+}
+function findBackendDir() {
+    const root = findMonorepoRoot();
+    if (!root)
+        return undefined;
+    const backend = path.join(root, "backend");
+    return fs.existsSync(backend) ? backend : undefined;
+}
+function findSupermemoryBinary() {
+    const root = findMonorepoRoot();
+    const home = os.homedir();
+    const globalCandidates = [
+        path.join(home, ".local", "bin", "supermemory-server"),
+        "/usr/local/bin/supermemory-server",
+        "/opt/homebrew/bin/supermemory-server",
+    ];
+    const localCandidates = [
+        root && path.join(root, "node_modules", ".bin", "supermemory-server"),
+        root && path.join(root, "backend", "node_modules", ".bin", "supermemory-server"),
+        path.join(__dirname, "..", "node_modules", ".bin", "supermemory-server"),
+        path.join(__dirname, "..", "..", "backend", "node_modules", ".bin", "supermemory-server"),
+    ].filter(Boolean);
+    for (const candidate of [...localCandidates, ...globalCandidates]) {
+        if (fs.existsSync(candidate))
+            return candidate;
+    }
+    return "npx";
+}
+function readApiKeyFile() {
+    try {
+        return fs.readFileSync(SM_API_KEY_FILE, "utf8").trim();
+    }
+    catch {
+        return undefined;
+    }
+}
+function readEnvFile(key) {
+    try {
+        const text = fs.readFileSync(REPO_ENV, "utf8");
+        const match = text.match(new RegExp(`^${key}=([^\r\n]+)`, "m"));
+        return match?.[1]?.trim();
+    }
+    catch {
+        return undefined;
+    }
+}
+function warnIfApiKeyMismatch() {
+    const fileKey = readApiKeyFile();
+    const envKey = readEnvFile("SUPERMEMORY_API_KEY");
+    if (fileKey && envKey && fileKey !== envKey) {
+        console.warn("[engram] warning: ~/.supermemory/api-key differs from repo .env SUPERMEMORY_API_KEY. " +
+            "Copy the new key into .env and restart.");
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function waitForReachable(url, label, opts = {}, timeoutMs = 30000) {
+    const deadline = Date.now() + timeoutMs;
+    const headers = {};
+    if (opts.withAuth) {
+        const apiKey = readEnvFile("SUPERMEMORY_API_KEY") ?? "";
+        headers.Authorization = `Bearer ${apiKey}`;
+    }
+    const probePath = opts.path ?? "/";
+    while (Date.now() < deadline) {
+        try {
+            const res = await fetch(`${url}${probePath}`, {
+                headers,
+                signal: AbortSignal.timeout(3000),
+            });
+            if (!opts.requireOk || res.ok)
+                return;
+        }
+        catch {
+            // not up yet
+        }
+        await sleep(250);
+    }
+    throw new Error(`${label} did not become reachable at ${url}${probePath} within ${timeoutMs}ms`);
+}
+function prefixStream(stream, prefix, out) {
+    if (!stream)
+        return;
+    let buffer = "";
+    stream.on("data", (chunk) => {
+        buffer += chunk.toString("utf8");
+        const lines = buffer.split("\n");
+        buffer = lines.pop() ?? "";
+        for (const line of lines) {
+            if (line)
+                out.write(`${prefix} ${line}\n`);
+            else
+                out.write("\n");
+        }
+    });
+    stream.on("end", () => {
+        if (buffer)
+            out.write(`${prefix} ${buffer}\n`);
+    });
+}
+function stopAll(children) {
+    for (const child of children) {
+        try {
+            child.process.kill("SIGTERM");
+        }
+        catch {
+            // ignore
+        }
+    }
+    setTimeout(() => {
+        for (const child of children) {
+            try {
+                if (!child.process.killed)
+                    child.process.kill("SIGKILL");
+            }
+            catch {
+                // ignore
+            }
+        }
+    }, 4000).unref();
+}
+function waitForChildren(children, timeoutMs) {
+    return new Promise((resolve) => {
+        const deadline = Date.now() + timeoutMs;
+        const check = () => {
+            if (children.every((c) => c.process.exitCode !== null)) {
+                resolve();
+                return;
+            }
+            if (Date.now() >= deadline) {
+                resolve();
+                return;
+            }
+            setTimeout(check, 250);
+        };
+        check();
+    });
+}
+export async function startCommand() {
+    const backendUrl = getBackendUrl();
+    const supermemoryUrl = getSupermemoryUrl();
+    const backendDir = findBackendDir();
+    const smBin = findSupermemoryBinary();
+    if (!backendDir) {
+        throw new Error("Could not locate the Engram backend directory. " +
+            "Make sure engram is installed next to the backend folder, or run from the monorepo.");
+    }
+    const children = [];
+    let shuttingDown = false;
+    const shutdown = () => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        console.log("\n[engram] shutting down...");
+        stopAll(children);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    try {
+        const smArgs = smBin === "npx" ? ["supermemory-server"] : [];
+        const sm = spawn(smBin, smArgs, {
+            cwd: os.homedir(),
+            env: {
+                ...process.env,
+                SUPERMEMORY_DATA_DIR: SM_DATA_DIR,
+            },
+            stdio: ["ignore", "pipe", "pipe"],
+            detached: false,
+        });
+        children.push({ name: "[supermemory]", process: sm });
+        prefixStream(sm.stdout, "[supermemory]", process.stdout);
+        prefixStream(sm.stderr, "[supermemory]", process.stderr);
+        console.log(`[engram] starting Supermemory Local (${supermemoryUrl})...`);
+        await waitForReachable(supermemoryUrl, "Supermemory", { withAuth: true });
+        warnIfApiKeyMismatch();
+        console.log(`[engram] starting Engram backend (${backendUrl})...`);
+        const backend = spawn("npm", ["run", "start"], {
+            cwd: backendDir,
+            env: process.env,
+            stdio: ["ignore", "pipe", "pipe"],
+            detached: false,
+        });
+        children.push({ name: "[engram]", process: backend });
+        prefixStream(backend.stdout, "[engram]", process.stdout);
+        prefixStream(backend.stderr, "[engram]", process.stderr);
+        await waitForReachable(backendUrl, "Engram backend", { path: "/health", requireOk: true });
+        console.log(`[engram] ready — backend ${backendUrl} · supermemory ${supermemoryUrl}`);
+        console.log("[engram] press Ctrl+C to stop both services");
+        // Keep process alive until children exit (or force exit after shutdown timeout)
+        await waitForChildren(children, Number.POSITIVE_INFINITY);
+    }
+    catch (err) {
+        shutdown();
+        await waitForChildren(children, 10000);
+        throw err;
+    }
+}
+//# sourceMappingURL=start.js.map

package/dist/start.js.map

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

package/dist/status.d.ts

@@ -0,0 +1,2 @@
+export declare function statusCommand(): Promise<void>;
+//# sourceMappingURL=status.d.ts.map

package/dist/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAGA,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAiBnD"}

package/dist/status.js

@@ -0,0 +1,20 @@
+import { EngramClient } from "./client.js";
+import { getBackendUrl } from "./config.js";
+export async function statusCommand() {
+    const url = getBackendUrl();
+    const client = new EngramClient(url);
+    try {
+        const health = await client.health();
+        console.log(`backend: ${url} — ok: ${health.ok}`);
+        console.log(`supermemory: ${health.supermemory ? "up" : "down"}`);
+        if (health.supabase !== undefined && health.supabase !== null) {
+            console.log(`supabase: ${health.supabase ? "up" : "down"}`);
+        }
+        process.exit(0);
+    }
+    catch (err) {
+        console.error(`backend unreachable (${url}): ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,UAAU,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAClE,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC9D,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CACX,wBAAwB,GAAG,MAAM,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACpF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@engram-cli/engram",
+  "version": "0.1.0",
+  "description": "CLI + MCP entry for Engram — local-first developer context hub",
+  "type": "module",
+  "main": "./dist/cli.js",
+  "bin": {
+    "engram": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx --env-file=../.env src/cli.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "smoke": "bash scripts/smoke.sh",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@engram-cli/contracts": "^0.1.0",
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "commander": "^13.0.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.32",
+    "tsx": "^4.20.3",
+    "typescript": "^5.8.3"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "engram",
+    "mcp",
+    "developer-context",
+    "supermemory",
+    "cli"
+  ]
+}

package/templates/engram-terminal.bash

@@ -0,0 +1,40 @@
+#!/bin/bash
+# Engram terminal capture hook for bash.
+# Source this from ~/.bashrc or let `npx @engram-cli/engram init` append it.
+
+export ENGRAM_SESSION_ID="${ENGRAM_SESSION_ID:-bash-$$-${SECONDS}}"
+
+_engram_last_command=""
+_engram_in_prompt=0
+
+function _engram_debug_trap() {
+  if [[ "$_engram_in_prompt" -eq 0 ]]; then
+    _engram_last_command="$BASH_COMMAND"
+  fi
+}
+
+function _engram_precmd() {
+  _engram_in_prompt=1
+  local exit_code=$?
+  if [[ -n "$_engram_last_command" ]]; then
+    # avoid re-emitting the prompt command itself
+    case "$_engram_last_command" in
+      _engram_precmd*|PROMPT_COMMAND=*) ;;
+      *)
+        local trimmed="${_engram_last_command#"${_engram_last_command%%[![:space:]]*}"}"
+        if [[ -n "$trimmed" ]]; then
+          engram emit --source terminal --type command \
+            --content "$_engram_last_command" \
+            --cwd "$PWD" \
+            --exit-code "$exit_code" \
+            --session-id "$ENGRAM_SESSION_ID" >/dev/null 2>&1
+        fi
+        ;;
+    esac
+  fi
+  _engram_last_command=""
+  _engram_in_prompt=0
+}
+
+trap '_engram_debug_trap' DEBUG
+PROMPT_COMMAND='_engram_precmd'

package/templates/engram-terminal.zsh

@@ -0,0 +1,30 @@
+#!/bin/zsh
+# Engram terminal capture hook for zsh.
+# Source this from ~/.zshrc or let `npx @engram-cli/engram init` append it.
+
+export ENGRAM_SESSION_ID="${ENGRAM_SESSION_ID:-zsh-${$}-${EPOCHSECONDS}}"
+
+_engram_last_command=""
+
+function _engram_preexec() {
+  _engram_last_command="$1"
+}
+
+function _engram_precmd() {
+  local exit_code=$?
+  if [[ -n "$_engram_last_command" ]]; then
+    # ignore pure whitespace and shell-internal noise
+    local trimmed="${_engram_last_command#"${_engram_last_command%%[![:space:]]*}"}"
+    if [[ -n "$trimmed" ]]; then
+      engram emit --source terminal --type command \
+        --content "$_engram_last_command" \
+        --cwd "$PWD" \
+        --exit-code "$exit_code" \
+        --session-id "$ENGRAM_SESSION_ID" >/dev/null 2>&1
+    fi
+  fi
+  _engram_last_command=""
+}
+
+preexec_functions+=(_engram_preexec)
+precmd_functions+=(_engram_precmd)

package/templates/post-checkout

@@ -0,0 +1,23 @@
+#!/bin/sh
+# Engram git hook: post-checkout
+# Emits a branch_switch event when the checked-out branch actually changes.
+
+PREV_REF=$1
+NEW_REF=$2
+FLAG=$3
+
+if [ "$FLAG" -ne 1 ]; then
+  exit 0
+fi
+
+BRANCH=$(git symbolic-ref --short HEAD 2>/dev/null || git describe --tags --exact-match 2>/dev/null || git rev-parse --short HEAD)
+if [ -z "$BRANCH" ]; then
+  exit 0
+fi
+
+export ENGRAM_SESSION_ID="${ENGRAM_SESSION_ID:-git-$$}"
+
+engram emit --source git --type branch_switch \
+  --content "$BRANCH" \
+  --cwd "$PWD" \
+  --session-id "$ENGRAM_SESSION_ID" >/dev/null 2>&1

package/templates/post-commit

@@ -0,0 +1,15 @@
+#!/bin/sh
+# Engram git hook: post-commit
+# Emits a commit event with the subject line only — no diffs.
+
+SUBJECT=$(git log -1 --pretty=%s)
+if [ -z "$SUBJECT" ]; then
+  exit 0
+fi
+
+export ENGRAM_SESSION_ID="${ENGRAM_SESSION_ID:-git-$$}"
+
+engram emit --source git --type commit \
+  --content "$SUBJECT" \
+  --cwd "$PWD" \
+  --session-id "$ENGRAM_SESSION_ID" >/dev/null 2>&1