memkin 0.4.0

package/dist/install/clients/codex.js

@@ -0,0 +1,33 @@
+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",
+    supportsHttp: true,
+    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,YAAY,EAAE,IAAI;IAClB,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,aA2BpB,CAAC"}

package/dist/install/clients/cursor.js

@@ -0,0 +1,37 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { DIRECTIVE_L1, MEMKIN_BLOCK_END, MEMKIN_BLOCK_START } from "../directive.js";
+import { mcpEntry } from "../types.js";
+// Cursor rules use `.mdc` with required frontmatter, so memkin owns the whole
+// file (managed-file) rather than appending a marker block.
+const L1_BODY = DIRECTIVE_L1.replace(MEMKIN_BLOCK_START, "").replace(MEMKIN_BLOCK_END, "").trim();
+const CURSOR_MDC = `---\nalwaysApply: true\n---\n\n${L1_BODY}\n`;
+export const cursor = {
+    id: "cursor",
+    displayName: "Cursor",
+    // TODO(SP4 T6b): verify HTTP support
+    supportsHttp: false,
+    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", "memkin.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,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAsB,QAAQ,EAAgB,MAAM,aAAa,CAAC;AAEzE,8EAA8E;AAC9E,4DAA4D;AAC5D,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAClG,MAAM,UAAU,GAAG,kCAAkC,OAAO,IAAI,CAAC;AAEjE,MAAM,CAAC,MAAM,MAAM,GAAkB;IACnC,EAAE,EAAE,QAAQ;IACZ,WAAW,EAAE,QAAQ;IACrB,qCAAqC;IACrC,YAAY,EAAE,KAAK;IACnB,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,YAAY,CAAC,CAAC;QAC/D,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,aAyBpB,CAAC"}

package/dist/install/clients/hermes.js

@@ -0,0 +1,37 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { MEMKIN_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",
+    // TODO(SP4 T6b): verify HTTP support
+    supportsHttp: false,
+    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", "memkin", "SKILL.md"),
+                kind: "managed-file",
+                action: ctx.action,
+                content: ctx.action === "upsert" ? MEMKIN_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,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,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,qCAAqC;IACrC,YAAY,EAAE,KAAK;IACnB,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,QAAQ,EAAE,UAAU,CAAC;gBAChD,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/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,aA6BtB,CAAC"}

package/dist/install/clients/windsurf.js

@@ -0,0 +1,34 @@
+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",
+    // TODO(SP4 T6b): verify HTTP support
+    supportsHttp: false,
+    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,qCAAqC;IACrC,YAAY,EAAE,KAAK;IACnB,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 Memkin's stdio
+// (or HTTP) server. Prefers a globally-installed `memkin` binary; otherwise
+// falls back to `npx -y memkin`.
+const PACKAGE = "memkin";
+/** 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("memkin")) {
+        return { command: "memkin", 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,2EAA2E;AAC3E,4EAA4E;AAC5E,iCAAiC;AAEjC,MAAM,OAAO,GAAG,QAAQ,CAAC;AAczB,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,QAAQ,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;IAC3D,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 MEMKIN_BLOCK_START = "<!-- memkin:start -->";
+export declare const MEMKIN_BLOCK_END = "<!-- memkin:end -->";
+/** L1: minimal directive block for rules files (CLAUDE.md / AGENTS.md / …). */
+export declare const DIRECTIVE_L1 = "<!-- memkin:start -->\n## Memkin \u2014 \u4F60\u7684\u4E2A\u4EBA\u8BB0\u5FC6\u5E93\n\u4F60\u63A5\u5165\u4E86 Memkin\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 Memkin\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<!-- memkin:end -->";
+/** L2: medium directive used as the MCP server `instructions` field. */
+export declare const DIRECTIVE_L2 = "Memkin 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 Memkin 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 Memkin (decisions/tasks/timeline) WITH repo reality (git/code); do not answer from code alone.\nDo NOT consult Memkin 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,kBAAkB,0BAA0B,CAAC;AAC1D,eAAO,MAAM,gBAAgB,wBAAwB,CAAC;AAEtD,+EAA+E;AAC/E,eAAO,MAAM,YAAY,67CAOL,CAAC;AAErB,wEAAwE;AACxE,eAAO,MAAM,YAAY,grCAU6G,CAAC"}

package/dist/install/directive.js

@@ -0,0 +1,31 @@
+// Single source of truth for Memkin'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 MEMKIN_BLOCK_START = "<!-- memkin:start -->";
+export const MEMKIN_BLOCK_END = "<!-- memkin:end -->";
+/** L1: minimal directive block for rules files (CLAUDE.md / AGENTS.md / …). */
+export const DIRECTIVE_L1 = `${MEMKIN_BLOCK_START}
+## Memkin — 你的个人记忆库
+你接入了 Memkin：用户关于「人 / 项目 / 决策 / 任务 / 过往」的本地持久记忆，是这些事的**事实来源**。
+- **何时查**：问题涉及具体的人、项目进展、过去的决定、待办，或带「上周 / 之前 / 我们当时…」时——先查 Memkin，别只凭代码或猜测。
+- **怎么查（便宜优先）**：先 \`search\`（关键词，零成本）→ 不够再 \`query\` / \`recall\`（语义 + 引用）；会话开始可先 \`get_session_context\` 进入状态。
+- **何时不查**：与用户个人世界无关的通用问题（纯语法 / 通用算法），别打扰记忆库。
+- 更多用法（写回、图谱、人物画像）按需发现：调用工具时看其说明，或 \`get_health\`。
+${MEMKIN_BLOCK_END}`;
+/** L2: medium directive used as the MCP server `instructions` field. */
+export const DIRECTIVE_L2 = `Memkin 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 Memkin 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 Memkin (decisions/tasks/timeline) WITH repo reality (git/code); do not answer from code alone.
+Do NOT consult Memkin 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,sEAAsE;AACtE,EAAE;AACF,oCAAoC;AACpC,2EAA2E;AAC3E,4EAA4E;AAC5E,wEAAwE;AACxE,mFAAmF;AAEnF,MAAM,CAAC,MAAM,kBAAkB,GAAG,uBAAuB,CAAC;AAC1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,qBAAqB,CAAC;AAEtD,+EAA+E;AAC/E,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,kBAAkB;;;;;;;EAO/C,gBAAgB,EAAE,CAAC;AAErB,wEAAwE;AACxE,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;sIAU0G,CAAC"}

package/dist/install/index.d.ts

@@ -0,0 +1,28 @@
+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;
+    url?: string;
+    port?: number;
+    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,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,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;AAmGD,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"}

package/dist/install/index.js

@@ -0,0 +1,122 @@
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname } from "node:path";
+import { ADAPTERS, getAdapter } from "./clients/index.js";
+import { resolveLaunchCmd } from "./command.js";
+import { parseJsonConfig, removeMcpServer, stringifyJsonConfig, upsertMcpServer, } from "./json-config.js";
+import { removeBlock, upsertBlock } from "./marked-block.js";
+import { removeMcpServerToml, upsertMcpServerToml } from "./toml-config.js";
+import { removeMcpServerYaml, upsertMcpServerYaml } from "./yaml-config.js";
+function readFileOr(path, fallback) {
+    return existsSync(path) ? readFileSync(path, "utf8") : fallback;
+}
+function ensureDir(dir) {
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+}
+function applyOp(op) {
+    if (op.kind === "cli") {
+        spawnSync(op.args[0], op.args.slice(1), { stdio: "ignore" });
+        return;
+    }
+    ensureDir(dirname(op.path));
+    switch (op.kind) {
+        case "json-mcp": {
+            const obj = parseJsonConfig(readFileOr(op.path, ""), op.path);
+            const next = op.action === "upsert" && op.entry
+                ? upsertMcpServer(obj, "memkin", op.entry)
+                : removeMcpServer(obj, "memkin");
+            writeFileSync(op.path, stringifyJsonConfig(next));
+            break;
+        }
+        case "toml-mcp": {
+            const text = readFileOr(op.path, "");
+            const next = op.action === "upsert" && op.entry
+                ? upsertMcpServerToml(text, "memkin", op.entry)
+                : removeMcpServerToml(text, "memkin");
+            writeFileSync(op.path, next);
+            break;
+        }
+        case "yaml-mcp": {
+            const text = readFileOr(op.path, "");
+            const next = op.action === "upsert" && op.entry
+                ? upsertMcpServerYaml(text, "memkin", op.entry)
+                : removeMcpServerYaml(text, "memkin");
+            writeFileSync(op.path, next);
+            break;
+        }
+        case "marked-block": {
+            const text = readFileOr(op.path, "");
+            const next = op.action === "upsert" && op.content ? upsertBlock(text, op.content) : removeBlock(text);
+            writeFileSync(op.path, next);
+            break;
+        }
+        case "managed-file": {
+            if (op.action === "upsert" && op.content) {
+                ensureDir(dirname(op.path));
+                writeFileSync(op.path, op.content);
+            }
+            else if (existsSync(op.path)) {
+                rmSync(op.path);
+            }
+            break;
+        }
+    }
+}
+function selectAdapters(opts) {
+    if (opts.agent && opts.agent.length > 0) {
+        return opts.agent.map((id) => {
+            const a = getAdapter(id);
+            if (!a) {
+                throw new Error(`Unknown agent "${id}". Known: ${ADAPTERS.map((x) => x.id).join(", ")}`);
+            }
+            return a;
+        });
+    }
+    const home = opts.home ?? homedir();
+    const platform = opts.platform ?? process.platform;
+    return ADAPTERS.filter((a) => a.detect(home, platform));
+}
+function planFor(adapter, opts, action) {
+    const port = opts.port ?? 3928;
+    const url = opts.url ?? `http://127.0.0.1:${port}/mcp`;
+    const transport = opts.http && adapter.supportsHttp ? "http" : "stdio";
+    const ctx = {
+        home: opts.home ?? homedir(),
+        platform: opts.platform ?? process.platform,
+        scope: opts.scope ?? "global",
+        cwd: opts.cwd ?? process.cwd(),
+        launch: opts.launch ?? resolveLaunchCmd({ http: opts.http }),
+        action,
+        transport,
+        url,
+    };
+    return { id: adapter.id, displayName: adapter.displayName, ops: adapter.plan(ctx) };
+}
+/** Plan without touching disk (for `--dry-run`). */
+export function planInstall(opts, action) {
+    return selectAdapters(opts).map((a) => planFor(a, opts, action));
+}
+function execute(opts, action) {
+    const planned = planInstall(opts, action);
+    if (!opts.dryRun) {
+        for (const client of planned) {
+            for (const op of client.ops)
+                applyOp(op);
+        }
+    }
+    return planned;
+}
+export function runInstall(opts = {}) {
+    return execute(opts, "upsert");
+}
+export function runUninstall(opts = {}) {
+    return execute(opts, "remove");
+}
+/** Ids of clients detected as installed on this machine. */
+export function detectInstalledAgents(home = homedir(), platform = process.platform) {
+    return ADAPTERS.filter((a) => a.detect(home, platform)).map((a) => a.id);
+}
+export { ADAPTERS } from "./clients/index.js";
+//# sourceMappingURL=index.js.map

package/dist/install/index.js.map

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

package/dist/install/json-config.d.ts

@@ -0,0 +1,8 @@
+import type { McpEntry } from "./mcp-entry.js";
+export type { McpEntry };
+type Json = Record<string, unknown>;
+export declare function parseJsonConfig(text: string, path: string): Json;
+export declare function upsertMcpServer(obj: Json, name: string, entry: McpEntry): Json;
+export declare function removeMcpServer(obj: Json, name: string): Json;
+export declare function stringifyJsonConfig(obj: Json): string;
+//# sourceMappingURL=json-config.d.ts.map

package/dist/install/json-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-config.d.ts","sourceRoot":"","sources":["../../src/install/json-config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,YAAY,EAAE,QAAQ,EAAE,CAAC;AAEzB,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpC,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAYhE;AAaD,wBAAgB,eAAe,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAI9E;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAM7D;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM,CAErD"}

package/dist/install/json-config.js

@@ -0,0 +1,44 @@
+// JSON-based MCP config editing (Claude Code ~/.claude.json, Claude Desktop,
+// Cursor ~/.cursor/mcp.json, Windsurf). Operates on parsed objects; the
+// orchestrator handles file IO. Other keys/servers are preserved.
+export function parseJsonConfig(text, path) {
+    const trimmed = text.trim();
+    if (trimmed === "")
+        return {};
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+            throw new Error("expected a top-level JSON object");
+        }
+        return parsed;
+    }
+    catch (e) {
+        throw new Error(`Invalid JSON in ${path}: ${e.message}`);
+    }
+}
+function servers(obj) {
+    const mcp = obj.mcpServers;
+    return mcp && typeof mcp === "object" && !Array.isArray(mcp) ? { ...mcp } : {};
+}
+function toJsonValue(entry) {
+    return entry.kind === "http"
+        ? { type: "http", url: entry.url }
+        : { command: entry.command, args: entry.args };
+}
+export function upsertMcpServer(obj, name, entry) {
+    const next = servers(obj);
+    next[name] = toJsonValue(entry);
+    return { ...obj, mcpServers: next };
+}
+export function removeMcpServer(obj, name) {
+    const mcp = obj.mcpServers;
+    if (!mcp || typeof mcp !== "object" || Array.isArray(mcp))
+        return obj;
+    const next = { ...mcp };
+    delete next[name];
+    return { ...obj, mcpServers: next };
+}
+export function stringifyJsonConfig(obj) {
+    return `${JSON.stringify(obj, null, 2)}\n`;
+}
+//# sourceMappingURL=json-config.js.map

package/dist/install/json-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-config.js","sourceRoot":"","sources":["../../src/install/json-config.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,wEAAwE;AACxE,kEAAkE;AAQlE,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,IAAY;IACxD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAC9B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnC,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3E,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,MAAc,CAAC;IACxB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,KAAM,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,GAAS;IACxB,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC;IAC3B,OAAO,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAI,GAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3F,CAAC;AAED,SAAS,WAAW,CAAC,KAAe;IAClC,OAAO,KAAK,CAAC,IAAI,KAAK,MAAM;QAC1B,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE;QAClC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAS,EAAE,IAAY,EAAE,KAAe;IACtE,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAChC,OAAO,EAAE,GAAG,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAS,EAAE,IAAY;IACrD,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC;IAC3B,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACtE,MAAM,IAAI,GAAG,EAAE,GAAI,GAAY,EAAE,CAAC;IAClC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;IAClB,OAAO,EAAE,GAAG,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAS;IAC3C,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC"}

package/dist/install/marked-block.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Insert or replace the memkin block in `existing`.
+ * `block` must already include the start/end markers (e.g. DIRECTIVE_L1).
+ * Idempotent: re-running with changed content replaces in place, never appends a duplicate.
+ */
+export declare function upsertBlock(existing: string, block: string): string;
+/** Remove the memkin block, tidying surrounding whitespace. No-op if absent. */
+export declare function removeBlock(existing: string): string;
+/** True if `existing` already contains a memkin block. */
+export declare function hasBlock(existing: string): boolean;
+//# sourceMappingURL=marked-block.d.ts.map

package/dist/install/marked-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marked-block.d.ts","sourceRoot":"","sources":["../../src/install/marked-block.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMnE;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOpD;AAED,0DAA0D;AAC1D,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAElD"}

package/dist/install/marked-block.js

@@ -0,0 +1,34 @@
+import { MEMKIN_BLOCK_END, MEMKIN_BLOCK_START } from "./directive.js";
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+// Matches a single memkin-delimited block (non-greedy, spans newlines).
+const blockRegex = new RegExp(`${escapeRegExp(MEMKIN_BLOCK_START)}[\\s\\S]*?${escapeRegExp(MEMKIN_BLOCK_END)}`);
+/**
+ * Insert or replace the memkin block in `existing`.
+ * `block` must already include the start/end markers (e.g. DIRECTIVE_L1).
+ * Idempotent: re-running with changed content replaces in place, never appends a duplicate.
+ */
+export function upsertBlock(existing, block) {
+    if (blockRegex.test(existing)) {
+        return existing.replace(blockRegex, block);
+    }
+    if (existing.trim() === "")
+        return `${block}\n`;
+    return `${existing.replace(/\s*$/, "")}\n\n${block}\n`;
+}
+/** Remove the memkin block, tidying surrounding whitespace. No-op if absent. */
+export function removeBlock(existing) {
+    if (!blockRegex.test(existing))
+        return existing;
+    const tidied = existing
+        .replace(blockRegex, "")
+        .replace(/\n{3,}/g, "\n\n")
+        .replace(/\s*$/, "");
+    return tidied === "" ? "" : `${tidied}\n`;
+}
+/** True if `existing` already contains a memkin block. */
+export function hasBlock(existing) {
+    return blockRegex.test(existing);
+}
+//# sourceMappingURL=marked-block.js.map