@andre.li/memoark 0.3.1 → 0.3.2

package/dist/hooks/writeback.js

@@ -0,0 +1,48 @@
+import { spawn } from "node:child_process";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+// Opt-in, debounced, non-blocking auto write-back for the SessionEnd hook.
+// When enabled, triggers a detached `memoark extract --source claude-code`
+// (incremental + deduped + L1/L2 noise-filtered) at most once per debounce window.
+const DEFAULT_DEBOUNCE_MS = 10 * 60 * 1000; // 10 minutes
+function stampPath(home) {
+    return join(home, ".memoark", ".last-writeback");
+}
+function defaultReadStamp(home) {
+    const p = stampPath(home);
+    if (!existsSync(p))
+        return null;
+    const n = Number(readFileSync(p, "utf8").trim());
+    return Number.isFinite(n) ? n : null;
+}
+function defaultWriteStamp(home, t) {
+    try {
+        writeFileSync(stampPath(home), String(t));
+    }
+    catch {
+        // best-effort; a missing ~/.memoark just means no debounce persistence
+    }
+}
+function defaultSpawn() {
+    const child = spawn("memoark", ["extract", "--source", "claude-code"], {
+        detached: true,
+        stdio: "ignore",
+    });
+    child.unref();
+}
+/** Returns true if a write-back was triggered. Never blocks (extract is detached). */
+export function runWriteback(deps) {
+    if (!deps.enabled)
+        return false;
+    const home = deps.home ?? homedir();
+    const now = deps.now ?? Date.now();
+    const debounce = deps.debounceMs ?? DEFAULT_DEBOUNCE_MS;
+    const last = (deps.readStamp ?? (() => defaultReadStamp(home)))();
+    if (last !== null && now - last < debounce)
+        return false;
+    (deps.writeStamp ?? ((t) => defaultWriteStamp(home, t)))(now);
+    (deps.spawnExtract ?? defaultSpawn)();
+    return true;
+}
+//# sourceMappingURL=writeback.js.map

package/dist/hooks/writeback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeback.js","sourceRoot":"","sources":["../../src/hooks/writeback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,2EAA2E;AAC3E,2EAA2E;AAC3E,mFAAmF;AAEnF,MAAM,mBAAmB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa;AAEzD,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY;IACpC,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACjD,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACvC,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY,EAAE,CAAS;IAChD,IAAI,CAAC;QACH,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;IACzE,CAAC;AACH,CAAC;AAED,SAAS,YAAY;IACnB,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,aAAa,CAAC,EAAE;QACrE,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,QAAQ;KAChB,CAAC,CAAC;IACH,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC;AAYD,sFAAsF;AACtF,MAAM,UAAU,YAAY,CAAC,IAAmB;IAC9C,IAAI,CAAC,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,IAAI,mBAAmB,CAAC;IACxD,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,IAAI,IAAI,KAAK,IAAI,IAAI,GAAG,GAAG,IAAI,GAAG,QAAQ;QAAE,OAAO,KAAK,CAAC;IACzD,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC9D,CAAC,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,EAAE,CAAC;IACtC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/install/clients/claude-code.d.ts

@@ -0,0 +1,3 @@
+import { type ClientAdapter } from "../types.js";
+export declare const claudeCode: ClientAdapter;
+//# sourceMappingURL=claude-code.d.ts.map

package/dist/install/clients/claude-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../../src/install/clients/claude-code.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,aAAa,EAA0B,MAAM,aAAa,CAAC;AAEzE,eAAO,MAAM,UAAU,EAAE,aA0BxB,CAAC"}

package/dist/install/clients/claude-code.js

@@ -0,0 +1,30 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { DIRECTIVE_L1 } from "../directive.js";
+import { mcpEntry } from "../types.js";
+export const claudeCode = {
+    id: "claude-code",
+    displayName: "Claude Code",
+    detect(home) {
+        return existsSync(join(home, ".claude")) || existsSync(join(home, ".claude.json"));
+    },
+    plan(ctx) {
+        const mcpPath = ctx.scope === "project" ? join(ctx.cwd, ".mcp.json") : join(ctx.home, ".claude.json");
+        const rulesPath = ctx.scope === "project" ? join(ctx.cwd, "CLAUDE.md") : join(ctx.home, ".claude", "CLAUDE.md");
+        return [
+            {
+                path: mcpPath,
+                kind: "json-mcp",
+                action: ctx.action,
+                entry: ctx.action === "upsert" ? mcpEntry(ctx) : undefined,
+            },
+            {
+                path: rulesPath,
+                kind: "marked-block",
+                action: ctx.action,
+                content: ctx.action === "upsert" ? DIRECTIVE_L1 : undefined,
+            },
+        ];
+    },
+};
+//# sourceMappingURL=claude-code.js.map

package/dist/install/clients/claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../../src/install/clients/claude-code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAsB,QAAQ,EAAgB,MAAM,aAAa,CAAC;AAEzE,MAAM,CAAC,MAAM,UAAU,GAAkB;IACvC,EAAE,EAAE,aAAa;IACjB,WAAW,EAAE,aAAa;IAC1B,MAAM,CAAC,IAAI;QACT,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,CAAC,GAAY;QACf,MAAM,OAAO,GACX,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QACxF,MAAM,SAAS,GACb,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QAChG,OAAO;YACL;gBACE,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,KAAK,EAAE,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;aAC3D;YACD;gBACE,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,cAAc;gBACpB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,OAAO,EAAE,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;aAC5D;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/install/clients/claude-desktop.d.ts

@@ -0,0 +1,3 @@
+import { type ClientAdapter } from "../types.js";
+export declare const claudeDesktop: ClientAdapter;
+//# sourceMappingURL=claude-desktop.d.ts.map

package/dist/install/clients/claude-desktop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-desktop.d.ts","sourceRoot":"","sources":["../../../src/install/clients/claude-desktop.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAA0B,MAAM,aAAa,CAAC;AAUzE,eAAO,MAAM,aAAa,EAAE,aAiB3B,CAAC"}

package/dist/install/clients/claude-desktop.js

@@ -0,0 +1,31 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { mcpEntry } from "../types.js";
+// Claude Desktop has no rules-file mechanism; it relies on the L2 MCP
+// `instructions` field. Install only registers the MCP server.
+function configDir(home, platform) {
+    if (platform === "darwin")
+        return join(home, "Library", "Application Support", "Claude");
+    if (platform === "win32")
+        return join(home, "AppData", "Roaming", "Claude");
+    return join(home, ".config", "Claude");
+}
+export const claudeDesktop = {
+    id: "claude-desktop",
+    displayName: "Claude Desktop",
+    detect(home, platform) {
+        return existsSync(configDir(home, platform));
+    },
+    plan(ctx) {
+        const path = join(configDir(ctx.home, ctx.platform), "claude_desktop_config.json");
+        return [
+            {
+                path,
+                kind: "json-mcp",
+                action: ctx.action,
+                entry: ctx.action === "upsert" ? mcpEntry(ctx) : undefined,
+            },
+        ];
+    },
+};
+//# sourceMappingURL=claude-desktop.js.map

package/dist/install/clients/claude-desktop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-desktop.js","sourceRoot":"","sources":["../../../src/install/clients/claude-desktop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAsB,QAAQ,EAAgB,MAAM,aAAa,CAAC;AAEzE,sEAAsE;AACtE,+DAA+D;AAC/D,SAAS,SAAS,CAAC,IAAY,EAAE,QAAyB;IACxD,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,qBAAqB,EAAE,QAAQ,CAAC,CAAC;IACzF,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC5E,OAAO,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,EAAE,EAAE,gBAAgB;IACpB,WAAW,EAAE,gBAAgB;IAC7B,MAAM,CAAC,IAAI,EAAE,QAAQ;QACnB,OAAO,UAAU,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,CAAC,GAAY;QACf,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,4BAA4B,CAAC,CAAC;QACnF,OAAO;YACL;gBACE,IAAI;gBACJ,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,KAAK,EAAE,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;aAC3D;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/install/clients/codex.d.ts

@@ -0,0 +1,3 @@
+import { type ClientAdapter } from "../types.js";
+export declare const codex: ClientAdapter;
+//# sourceMappingURL=codex.d.ts.map

package/dist/install/clients/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../../src/install/clients/codex.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,aAAa,EAA0B,MAAM,aAAa,CAAC;AAIzE,eAAO,MAAM,KAAK,EAAE,aAyBnB,CAAC"}

package/dist/install/clients/codex.js

@@ -0,0 +1,32 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { DIRECTIVE_L1 } from "../directive.js";
+import { mcpEntry } from "../types.js";
+// Codex MCP config is global-only (~/.codex/config.toml); rules go to AGENTS.md
+// (global ~/.codex/AGENTS.md or project ./AGENTS.md).
+export const codex = {
+    id: "codex",
+    displayName: "Codex",
+    detect(home) {
+        return existsSync(join(home, ".codex"));
+    },
+    plan(ctx) {
+        const mcpPath = join(ctx.home, ".codex", "config.toml");
+        const rulesPath = ctx.scope === "project" ? join(ctx.cwd, "AGENTS.md") : join(ctx.home, ".codex", "AGENTS.md");
+        return [
+            {
+                path: mcpPath,
+                kind: "toml-mcp",
+                action: ctx.action,
+                entry: ctx.action === "upsert" ? mcpEntry(ctx) : undefined,
+            },
+            {
+                path: rulesPath,
+                kind: "marked-block",
+                action: ctx.action,
+                content: ctx.action === "upsert" ? DIRECTIVE_L1 : undefined,
+            },
+        ];
+    },
+};
+//# sourceMappingURL=codex.js.map

package/dist/install/clients/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../../src/install/clients/codex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAsB,QAAQ,EAAgB,MAAM,aAAa,CAAC;AAEzE,gFAAgF;AAChF,sDAAsD;AACtD,MAAM,CAAC,MAAM,KAAK,GAAkB;IAClC,EAAE,EAAE,OAAO;IACX,WAAW,EAAE,OAAO;IACpB,MAAM,CAAC,IAAI;QACT,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,CAAC,GAAY;QACf,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QACxD,MAAM,SAAS,GACb,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC/F,OAAO;YACL;gBACE,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,KAAK,EAAE,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;aAC3D;YACD;gBACE,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,cAAc;gBACpB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,OAAO,EAAE,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;aAC5D;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/install/clients/cursor.d.ts

@@ -0,0 +1,3 @@
+import { type ClientAdapter } from "../types.js";
+export declare const cursor: ClientAdapter;
+//# sourceMappingURL=cursor.d.ts.map

package/dist/install/clients/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../../src/install/clients/cursor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,aAAa,EAA0B,MAAM,aAAa,CAAC;AAOzE,eAAO,MAAM,MAAM,EAAE,aAyBpB,CAAC"}

package/dist/install/clients/cursor.js

@@ -0,0 +1,35 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { DIRECTIVE_L1, MEMOARK_BLOCK_END, MEMOARK_BLOCK_START } from "../directive.js";
+import { mcpEntry } from "../types.js";
+// Cursor rules use `.mdc` with required frontmatter, so memoark owns the whole
+// file (managed-file) rather than appending a marker block.
+const L1_BODY = DIRECTIVE_L1.replace(MEMOARK_BLOCK_START, "").replace(MEMOARK_BLOCK_END, "").trim();
+const CURSOR_MDC = `---\nalwaysApply: true\n---\n\n${L1_BODY}\n`;
+export const cursor = {
+    id: "cursor",
+    displayName: "Cursor",
+    detect(home) {
+        return existsSync(join(home, ".cursor"));
+    },
+    plan(ctx) {
+        const base = ctx.scope === "project" ? ctx.cwd : ctx.home;
+        const mcpPath = join(base, ".cursor", "mcp.json");
+        const rulesPath = join(base, ".cursor", "rules", "memoark.mdc");
+        return [
+            {
+                path: mcpPath,
+                kind: "json-mcp",
+                action: ctx.action,
+                entry: ctx.action === "upsert" ? mcpEntry(ctx) : undefined,
+            },
+            {
+                path: rulesPath,
+                kind: "managed-file",
+                action: ctx.action,
+                content: ctx.action === "upsert" ? CURSOR_MDC : undefined,
+            },
+        ];
+    },
+};
+//# sourceMappingURL=cursor.js.map

package/dist/install/clients/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../../src/install/clients/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvF,OAAO,EAAsB,QAAQ,EAAgB,MAAM,aAAa,CAAC;AAEzE,+EAA+E;AAC/E,4DAA4D;AAC5D,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACpG,MAAM,UAAU,GAAG,kCAAkC,OAAO,IAAI,CAAC;AAEjE,MAAM,CAAC,MAAM,MAAM,GAAkB;IACnC,EAAE,EAAE,QAAQ;IACZ,WAAW,EAAE,QAAQ;IACrB,MAAM,CAAC,IAAI;QACT,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,CAAC,GAAY;QACf,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;QAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;QAChE,OAAO;YACL;gBACE,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,KAAK,EAAE,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;aAC3D;YACD;gBACE,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,cAAc;gBACpB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,OAAO,EAAE,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;aAC1D;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/install/clients/hermes.d.ts

@@ -0,0 +1,3 @@
+import { type ClientAdapter } from "../types.js";
+export declare const hermes: ClientAdapter;
+//# sourceMappingURL=hermes.d.ts.map

package/dist/install/clients/hermes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes.d.ts","sourceRoot":"","sources":["../../../src/install/clients/hermes.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,aAAa,EAA0B,MAAM,aAAa,CAAC;AASzE,eAAO,MAAM,MAAM,EAAE,aAuBpB,CAAC"}

package/dist/install/clients/hermes.js

@@ -0,0 +1,35 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { MEMOARK_SKILL } from "../skill.js";
+import { mcpEntry } from "../types.js";
+// OpenClaw / Hermes. MCP lives in config.yaml `mcp_servers`; the skill drops
+// into the skills dir. Newer Hermes uses ~/.hermes; older OpenClaw layout uses
+// ~/.openclaw — detect either and pin the root accordingly.
+function hermesRoot(home) {
+    return existsSync(join(home, ".hermes")) ? join(home, ".hermes") : join(home, ".openclaw");
+}
+export const hermes = {
+    id: "hermes",
+    displayName: "OpenClaw / Hermes",
+    detect(home) {
+        return existsSync(join(home, ".hermes")) || existsSync(join(home, ".openclaw"));
+    },
+    plan(ctx) {
+        const root = hermesRoot(ctx.home);
+        return [
+            {
+                path: join(root, "config.yaml"),
+                kind: "yaml-mcp",
+                action: ctx.action,
+                entry: ctx.action === "upsert" ? mcpEntry(ctx) : undefined,
+            },
+            {
+                path: join(root, "skills", "memoark", "SKILL.md"),
+                kind: "managed-file",
+                action: ctx.action,
+                content: ctx.action === "upsert" ? MEMOARK_SKILL : undefined,
+            },
+        ];
+    },
+};
+//# sourceMappingURL=hermes.js.map

package/dist/install/clients/hermes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes.js","sourceRoot":"","sources":["../../../src/install/clients/hermes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAsB,QAAQ,EAAgB,MAAM,aAAa,CAAC;AAEzE,6EAA6E;AAC7E,+EAA+E;AAC/E,4DAA4D;AAC5D,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;AAC7F,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAkB;IACnC,EAAE,EAAE,QAAQ;IACZ,WAAW,EAAE,mBAAmB;IAChC,MAAM,CAAC,IAAI;QACT,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,CAAC,GAAY;QACf,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO;YACL;gBACE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC;gBAC/B,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,KAAK,EAAE,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;aAC3D;YACD;gBACE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC;gBACjD,IAAI,EAAE,cAAc;gBACpB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,OAAO,EAAE,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;aAC7D;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/install/clients/index.d.ts

@@ -0,0 +1,4 @@
+import type { ClientAdapter } from "../types.js";
+export declare const ADAPTERS: ClientAdapter[];
+export declare function getAdapter(id: string): ClientAdapter | undefined;
+//# sourceMappingURL=index.d.ts.map

package/dist/install/clients/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/install/clients/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAQjD,eAAO,MAAM,QAAQ,EAAE,aAAa,EAOnC,CAAC;AAEF,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEhE"}

package/dist/install/clients/index.js

@@ -0,0 +1,18 @@
+import { claudeCode } from "./claude-code.js";
+import { claudeDesktop } from "./claude-desktop.js";
+import { codex } from "./codex.js";
+import { cursor } from "./cursor.js";
+import { hermes } from "./hermes.js";
+import { windsurf } from "./windsurf.js";
+export const ADAPTERS = [
+    claudeCode,
+    claudeDesktop,
+    cursor,
+    codex,
+    windsurf,
+    hermes,
+];
+export function getAdapter(id) {
+    return ADAPTERS.find((a) => a.id === id);
+}
+//# sourceMappingURL=index.js.map

package/dist/install/clients/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/install/clients/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,MAAM,CAAC,MAAM,QAAQ,GAAoB;IACvC,UAAU;IACV,aAAa;IACb,MAAM;IACN,KAAK;IACL,QAAQ;IACR,MAAM;CACP,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC3C,CAAC"}

package/dist/install/clients/windsurf.d.ts

@@ -0,0 +1,3 @@
+import { type ClientAdapter } from "../types.js";
+export declare const windsurf: ClientAdapter;
+//# sourceMappingURL=windsurf.d.ts.map

package/dist/install/clients/windsurf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windsurf.d.ts","sourceRoot":"","sources":["../../../src/install/clients/windsurf.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,aAAa,EAA0B,MAAM,aAAa,CAAC;AAEzE,eAAO,MAAM,QAAQ,EAAE,aA2BtB,CAAC"}

package/dist/install/clients/windsurf.js

@@ -0,0 +1,32 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { DIRECTIVE_L1 } from "../directive.js";
+import { mcpEntry } from "../types.js";
+export const windsurf = {
+    id: "windsurf",
+    displayName: "Windsurf",
+    detect(home) {
+        return existsSync(join(home, ".codeium", "windsurf"));
+    },
+    plan(ctx) {
+        const mcpPath = join(ctx.home, ".codeium", "windsurf", "mcp_config.json");
+        const rulesPath = ctx.scope === "project"
+            ? join(ctx.cwd, ".windsurfrules")
+            : join(ctx.home, ".codeium", "windsurf", "memories", "global_rules.md");
+        return [
+            {
+                path: mcpPath,
+                kind: "json-mcp",
+                action: ctx.action,
+                entry: ctx.action === "upsert" ? mcpEntry(ctx) : undefined,
+            },
+            {
+                path: rulesPath,
+                kind: "marked-block",
+                action: ctx.action,
+                content: ctx.action === "upsert" ? DIRECTIVE_L1 : undefined,
+            },
+        ];
+    },
+};
+//# sourceMappingURL=windsurf.js.map

package/dist/install/clients/windsurf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windsurf.js","sourceRoot":"","sources":["../../../src/install/clients/windsurf.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAsB,QAAQ,EAAgB,MAAM,aAAa,CAAC;AAEzE,MAAM,CAAC,MAAM,QAAQ,GAAkB;IACrC,EAAE,EAAE,UAAU;IACd,WAAW,EAAE,UAAU;IACvB,MAAM,CAAC,IAAI;QACT,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,CAAC,GAAY;QACf,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAC;QAC1E,MAAM,SAAS,GACb,GAAG,CAAC,KAAK,KAAK,SAAS;YACrB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,gBAAgB,CAAC;YACjC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAC;QAC5E,OAAO;YACL;gBACE,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,KAAK,EAAE,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;aAC3D;YACD;gBACE,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,cAAc;gBACpB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,OAAO,EAAE,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;aAC5D;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/install/command.d.ts

@@ -0,0 +1,14 @@
+export interface LaunchCmd {
+    command: string;
+    args: string[];
+}
+export interface ResolveOpts {
+    /** Use the Streamable HTTP transport instead of stdio. */
+    http?: boolean;
+    /** Injectable PATH lookup for tests. */
+    onPath?: (bin: string) => boolean;
+}
+/** Default check: is `bin` an executable on PATH? */
+export declare function isOnPath(bin: string, env?: NodeJS.ProcessEnv): boolean;
+export declare function resolveLaunchCmd(opts?: ResolveOpts): LaunchCmd;
+//# sourceMappingURL=command.d.ts.map

package/dist/install/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/install/command.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,wCAAwC;IACxC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;CACnC;AAED,qDAAqD;AACrD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAenF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,WAAgB,GAAG,SAAS,CAOlE"}

package/dist/install/command.js

@@ -0,0 +1,34 @@
+import { accessSync, constants } from "node:fs";
+import { delimiter, join } from "node:path";
+// Resolves the command an MCP client should spawn to launch Memoark's stdio
+// (or HTTP) server. Prefers a globally-installed `memoark` binary; otherwise
+// falls back to `npx -y @andre.li/memoark`.
+const PACKAGE = "@andre.li/memoark";
+/** Default check: is `bin` an executable on PATH? */
+export function isOnPath(bin, env = process.env) {
+    const path = env.PATH ?? "";
+    const exts = process.platform === "win32" ? ["", ".cmd", ".exe", ".bat"] : [""];
+    for (const dir of path.split(delimiter)) {
+        if (!dir)
+            continue;
+        for (const ext of exts) {
+            try {
+                accessSync(join(dir, bin + ext), constants.X_OK);
+                return true;
+            }
+            catch {
+                // not here; keep looking
+            }
+        }
+    }
+    return false;
+}
+export function resolveLaunchCmd(opts = {}) {
+    const transport = opts.http ? "--mcp-http" : "--mcp";
+    const onPath = opts.onPath ?? isOnPath;
+    if (onPath("memoark")) {
+        return { command: "memoark", args: ["serve", transport] };
+    }
+    return { command: "npx", args: ["-y", PACKAGE, "serve", transport] };
+}
+//# sourceMappingURL=command.js.map

package/dist/install/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/install/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE5C,4EAA4E;AAC5E,6EAA6E;AAC7E,4CAA4C;AAE5C,MAAM,OAAO,GAAG,mBAAmB,CAAC;AAcpC,qDAAqD;AACrD,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,MAAyB,OAAO,CAAC,GAAG;IACxE,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAChF,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QACxC,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;gBACjD,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,yBAAyB;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAoB,EAAE;IACrD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC;IACrD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC;IACvC,IAAI,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;IAC5D,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;AACvE,CAAC"}

package/dist/install/directive.d.ts

@@ -0,0 +1,7 @@
+export declare const MEMOARK_BLOCK_START = "<!-- memoark:start -->";
+export declare const MEMOARK_BLOCK_END = "<!-- memoark:end -->";
+/** L1: minimal directive block for rules files (CLAUDE.md / AGENTS.md / …). */
+export declare const DIRECTIVE_L1 = "<!-- memoark:start -->\n## Memoark \u2014 \u4F60\u7684\u4E2A\u4EBA\u8BB0\u5FC6\u5E93\n\u4F60\u63A5\u5165\u4E86 Memoark\uFF1A\u7528\u6237\u5173\u4E8E\u300C\u4EBA / \u9879\u76EE / \u51B3\u7B56 / \u4EFB\u52A1 / \u8FC7\u5F80\u300D\u7684\u672C\u5730\u6301\u4E45\u8BB0\u5FC6\uFF0C\u662F\u8FD9\u4E9B\u4E8B\u7684**\u4E8B\u5B9E\u6765\u6E90**\u3002\n- **\u4F55\u65F6\u67E5**\uFF1A\u95EE\u9898\u6D89\u53CA\u5177\u4F53\u7684\u4EBA\u3001\u9879\u76EE\u8FDB\u5C55\u3001\u8FC7\u53BB\u7684\u51B3\u5B9A\u3001\u5F85\u529E\uFF0C\u6216\u5E26\u300C\u4E0A\u5468 / \u4E4B\u524D / \u6211\u4EEC\u5F53\u65F6\u2026\u300D\u65F6\u2014\u2014\u5148\u67E5 Memoark\uFF0C\u522B\u53EA\u51ED\u4EE3\u7801\u6216\u731C\u6D4B\u3002\n- **\u600E\u4E48\u67E5\uFF08\u4FBF\u5B9C\u4F18\u5148\uFF09**\uFF1A\u5148 `search`\uFF08\u5173\u952E\u8BCD\uFF0C\u96F6\u6210\u672C\uFF09\u2192 \u4E0D\u591F\u518D `query` / `recall`\uFF08\u8BED\u4E49 + \u5F15\u7528\uFF09\uFF1B\u4F1A\u8BDD\u5F00\u59CB\u53EF\u5148 `get_session_context` \u8FDB\u5165\u72B6\u6001\u3002\n- **\u4F55\u65F6\u4E0D\u67E5**\uFF1A\u4E0E\u7528\u6237\u4E2A\u4EBA\u4E16\u754C\u65E0\u5173\u7684\u901A\u7528\u95EE\u9898\uFF08\u7EAF\u8BED\u6CD5 / \u901A\u7528\u7B97\u6CD5\uFF09\uFF0C\u522B\u6253\u6270\u8BB0\u5FC6\u5E93\u3002\n- \u66F4\u591A\u7528\u6CD5\uFF08\u5199\u56DE\u3001\u56FE\u8C31\u3001\u4EBA\u7269\u753B\u50CF\uFF09\u6309\u9700\u53D1\u73B0\uFF1A\u8C03\u7528\u5DE5\u5177\u65F6\u770B\u5176\u8BF4\u660E\uFF0C\u6216 `get_health`\u3002\n<!-- memoark:end -->";
+/** L2: medium directive used as the MCP server `instructions` field. */
+export declare const DIRECTIVE_L2 = "Memoark is the user's local-first personal memory \u2014 the source of truth about the user's people, projects, decisions, tasks, and history.\n\nBrain-first, cheap-first. When a request concerns a specific person, a project's status/history, a past decision, a todo, or contains \"last week / earlier / what did we\u2026\", consult Memoark BEFORE answering from code or assumptions:\n  1) search  (keyword, zero-cost)\n  2) query / recall  (semantic + cited) \u2014 only if search is thin\n  Accept good results; do not over-escalate.\nSession start: call get_session_context for a compact digest of active projects, recent decisions, open tasks, and key people.\nProject-status questions: combine Memoark (decisions/tasks/timeline) WITH repo reality (git/code); do not answer from code alone.\nDo NOT consult Memoark for generic questions unrelated to the user's world (pure syntax, general algorithms).\nWrite-back (conservative): on a clear decision/discovery, or when the user says \"remember this\", persist via put_page / add_timeline_entry; if unsure, ask.\nMore tools (graph traversal, person profile, daily report, troubleshoot) are discoverable via their tool descriptions and get_health.";
+//# sourceMappingURL=directive.d.ts.map

package/dist/install/directive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directive.d.ts","sourceRoot":"","sources":["../../src/install/directive.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,mBAAmB,2BAA2B,CAAC;AAC5D,eAAO,MAAM,iBAAiB,yBAAyB,CAAC;AAExD,+EAA+E;AAC/E,eAAO,MAAM,YAAY,k8CAOJ,CAAC;AAEtB,wEAAwE;AACxE,eAAO,MAAM,YAAY,orCAU6G,CAAC"}

package/dist/install/directive.js

@@ -0,0 +1,31 @@
+// Single source of truth for Memoark's agent-facing memory directives.
+//
+// Progressive disclosure (Spec 12):
+//   L1 — minimal, written into each client's rules file (always resident).
+//   L2 — medium, passed as the MCP server `instructions` field (injected by
+//        clients that support it; covers clients without a rules file).
+//   L3 — full detail, lives in tool descriptions / the optional skill (on demand).
+export const MEMOARK_BLOCK_START = "<!-- memoark:start -->";
+export const MEMOARK_BLOCK_END = "<!-- memoark:end -->";
+/** L1: minimal directive block for rules files (CLAUDE.md / AGENTS.md / …). */
+export const DIRECTIVE_L1 = `${MEMOARK_BLOCK_START}
+## Memoark — 你的个人记忆库
+你接入了 Memoark：用户关于「人 / 项目 / 决策 / 任务 / 过往」的本地持久记忆，是这些事的**事实来源**。
+- **何时查**：问题涉及具体的人、项目进展、过去的决定、待办，或带「上周 / 之前 / 我们当时…」时——先查 Memoark，别只凭代码或猜测。
+- **怎么查（便宜优先）**：先 \`search\`（关键词，零成本）→ 不够再 \`query\` / \`recall\`（语义 + 引用）；会话开始可先 \`get_session_context\` 进入状态。
+- **何时不查**：与用户个人世界无关的通用问题（纯语法 / 通用算法），别打扰记忆库。
+- 更多用法（写回、图谱、人物画像）按需发现：调用工具时看其说明，或 \`get_health\`。
+${MEMOARK_BLOCK_END}`;
+/** L2: medium directive used as the MCP server `instructions` field. */
+export const DIRECTIVE_L2 = `Memoark is the user's local-first personal memory — the source of truth about the user's people, projects, decisions, tasks, and history.
+
+Brain-first, cheap-first. When a request concerns a specific person, a project's status/history, a past decision, a todo, or contains "last week / earlier / what did we…", consult Memoark BEFORE answering from code or assumptions:
+  1) search  (keyword, zero-cost)
+  2) query / recall  (semantic + cited) — only if search is thin
+  Accept good results; do not over-escalate.
+Session start: call get_session_context for a compact digest of active projects, recent decisions, open tasks, and key people.
+Project-status questions: combine Memoark (decisions/tasks/timeline) WITH repo reality (git/code); do not answer from code alone.
+Do NOT consult Memoark for generic questions unrelated to the user's world (pure syntax, general algorithms).
+Write-back (conservative): on a clear decision/discovery, or when the user says "remember this", persist via put_page / add_timeline_entry; if unsure, ask.
+More tools (graph traversal, person profile, daily report, troubleshoot) are discoverable via their tool descriptions and get_health.`;
+//# sourceMappingURL=directive.js.map

package/dist/install/directive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directive.js","sourceRoot":"","sources":["../../src/install/directive.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,EAAE;AACF,oCAAoC;AACpC,2EAA2E;AAC3E,4EAA4E;AAC5E,wEAAwE;AACxE,mFAAmF;AAEnF,MAAM,CAAC,MAAM,mBAAmB,GAAG,wBAAwB,CAAC;AAC5D,MAAM,CAAC,MAAM,iBAAiB,GAAG,sBAAsB,CAAC;AAExD,+EAA+E;AAC/E,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,mBAAmB;;;;;;;EAOhD,iBAAiB,EAAE,CAAC;AAEtB,wEAAwE;AACxE,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;sIAU0G,CAAC"}

package/dist/install/index.d.ts

@@ -0,0 +1,26 @@
+import { type LaunchCmd } from "./command.js";
+import type { InstallAction, InstallOp, Scope } from "./types.js";
+export interface InstallOptions {
+    /** Explicit client ids; empty/undefined → install to all detected. */
+    agent?: string[];
+    scope?: Scope;
+    http?: boolean;
+    dryRun?: boolean;
+    home?: string;
+    cwd?: string;
+    platform?: NodeJS.Platform;
+    launch?: LaunchCmd;
+}
+export interface PlannedClient {
+    id: string;
+    displayName: string;
+    ops: InstallOp[];
+}
+/** Plan without touching disk (for `--dry-run`). */
+export declare function planInstall(opts: InstallOptions, action: InstallAction): PlannedClient[];
+export declare function runInstall(opts?: InstallOptions): PlannedClient[];
+export declare function runUninstall(opts?: InstallOptions): PlannedClient[];
+/** Ids of clients detected as installed on this machine. */
+export declare function detectInstalledAgents(home?: string, platform?: NodeJS.Platform): string[];
+export { ADAPTERS } from "./clients/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/install/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/install/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,cAAc,CAAC;AAShE,OAAO,KAAK,EAAiB,aAAa,EAAE,SAAS,EAAW,KAAK,EAAE,MAAM,YAAY,CAAC;AAG1F,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,SAAS,EAAE,CAAC;CAClB;AA8FD,oDAAoD;AACpD,wBAAgB,WAAW,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,GAAG,aAAa,EAAE,CAExF;AAYD,wBAAgB,UAAU,CAAC,IAAI,GAAE,cAAmB,GAAG,aAAa,EAAE,CAErE;AAED,wBAAgB,YAAY,CAAC,IAAI,GAAE,cAAmB,GAAG,aAAa,EAAE,CAEvE;AAED,4DAA4D;AAC5D,wBAAgB,qBAAqB,CAAC,IAAI,SAAY,EAAE,QAAQ,kBAAmB,GAAG,MAAM,EAAE,CAE7F;AAED,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC"}