@lore-co/cli 0.1.19 → 0.1.21

package/README.md

@@ -104,6 +104,28 @@ excerpts. `--repo` and
 response. Requires a connected workspace (`lore connect`) and a server that
 exposes `POST /v1/ask`.
 
+## Save knowledge manually
+
+```sh
+lore remember "Use pnpm for this repository." --repo acme/app --category convention
+lore remember "Payment retries must use exponential backoff." --project billing
+lore remember "The legacy endpoint is deprecated." --agent codex --json
+```
+
+`remember` saves an explicit learning using your existing `lore connect`
+credentials. Supply the statement as a quoted argument; multiline statements
+are supported inside that argument. Use `--repo`, `--project`, `--path`, or
+`--component` to limit where it applies. With no scope flags, it is available
+workspace-wide; the current repository is not inferred. The connected workspace
+determines the organization.
+
+`--category` defaults to `other`; run `lore remember --help` for the supported
+categories. `--agent` identifies the source and defaults to `human`. The command
+prints the saved learning's ID, content, scope, category, and status, and reports
+an existing learning when the server deduplicates it. `--json` returns the full
+`{ memory, inserted }` response for scripts. Use `--` before statement text that
+begins with a dash. Manual saves do not require agent hooks or MCP write tools.
+
 ## Context Guard
 
 ```sh
@@ -131,7 +153,7 @@ content-free `guard_check` audit event.
 
 ```sh
 lore update
-lore update --version v0.1.19
+lore update --version v0.1.21
 ```
 
 `update` resolves the latest release to an exact tag, or uses the exact
@@ -248,6 +270,16 @@ command has subcommand-specific `--help`, and `up`, `down`, and `status` support
 
 ## Runtime behavior
 
+Cursor installs five hooks and a `lore-native` MCP server. Its `sessionStart`
+hook instructs the agent to call `lore_context` before each request and
+`lore_complete` after its response. The bridge retrieves scoped context, captures
+teachings, and stages prior attempts even in CLI print mode. Repository identity
+comes from the native session; MCP input cannot override it. Credentials remain
+in Lore's protected config. Keep the server enabled, reconnect with the updated
+CLI (`lore connect --agent cursor`), and start a new conversation to activate it.
+`lore status` checks all five hooks plus the MCP server. Other MCP entries are
+preserved during connect and disconnect.
+
 The Claude/Codex/Cursor/Polytoken command-hook handler:
 
 - reads native hook JSON from standard input and normalizes Cursor and
@@ -384,7 +416,7 @@ same-repository, non-draft pull requests bearing the corresponding
 `lore:codex-review` or `lore:devin-review` label.
 
 Generated jobs require a published standalone binary release and default to
-`treadiehq/lore-releases` at `v0.1.19`. Set `LORE_CLI_REPOSITORY` to the publicly
+`treadiehq/lore-releases` at `v0.1.21`. Set `LORE_CLI_REPOSITORY` to the publicly
 readable `owner/repository` and `LORE_CLI_VERSION` to an existing release tag
 when using another release source.
 

package/dist/cli.d.ts

@@ -27,6 +27,7 @@ export interface LorePaths {
     copilotVscodeHooks: string;
     claudeSettings: string;
     cursorHooks: string;
+    cursorMcp: string;
     cursorUserData: string;
     openCodeConfig: string;
     polytokenHooks: string;
@@ -43,10 +44,12 @@ export interface ConnectorConfig {
     connectedAt: string;
     timeoutMs: number;
 }
-export declare function getLorePaths(home?: string, environment?: NodeJS.ProcessEnv): LorePaths;
+export declare function getLorePaths(home?: string, environment?: NodeJS.ProcessEnv, cwd?: string): LorePaths;
 export declare function mergeLoreHooks(input: Record<string, unknown>, agent: CommandHookAgentName, paths: LorePaths): Record<string, unknown>;
 export declare function removeLoreHooks(input: Record<string, unknown>): Record<string, unknown>;
 export declare function countLoreHooks(input: Record<string, unknown>): number;
+export declare function mergeLoreCursorMcp(input: unknown, paths: LorePaths): Record<string, unknown>;
+export declare function removeLoreCursorMcp(input: unknown): Record<string, unknown>;
 export declare function mergeLoreCursorHooks(input: Record<string, unknown>, paths: LorePaths): Record<string, unknown>;
 export declare function removeLoreCursorHooks(input: Record<string, unknown>): Record<string, unknown>;
 export declare function countLoreCursorHooks(input: Record<string, unknown>): number;
@@ -75,6 +78,10 @@ export interface AgentInstallation {
 }
 export declare function t3CodeProviderInstallations(settings: unknown, paths: LorePaths): AgentInstallation[];
 export interface ConnectWithCredentialOptions {
+    /** Explicit installation root for embedded callers and isolated acceptance tests. */
+    home?: string;
+    /** Repository root for project-local integrations such as VS Code. */
+    cwd?: string;
     apiUrl: string;
     dashboardUrl?: string;
     token: string;

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -11,6 +11,7 @@ import { CLAUDE_RELIABILITY_INTEGRATION, CODEX_RELIABILITY_INTEGRATION, COPILOT_
 import { runHook, } from "./runtime.js";
 import { readInvocationHealthWriteInput, runInvocationHealthWrite, } from "./invocation-health-writer.js";
 import { runAskCommand } from "./ask.js";
+import { runRememberCommand } from "./remember.js";
 import { runGuardCommand } from "./guard.js";
 import { runContinueCommand, runResumeCommand } from "./handoff.js";
 import { runAttachCommand, runLiveHostCommand, runLiveRunCommand, } from "./live.js";
@@ -35,8 +36,9 @@ const HOOK_EVENTS = [
     "SessionEnd",
 ];
 /** Tools the Context Guard PreToolUse hook cares about (regex matcher). */
-const GUARD_TOOL_MATCHER = "Edit|Write|MultiEdit|NotebookEdit|ApplyPatch|apply_patch|Bash";
+const GUARD_TOOL_MATCHER = "Edit|Write|MultiEdit|NotebookEdit|ApplyPatch|apply_patch|edit|write|patch|str_replace_editor|Bash|bash|Shell|shell|exec_command|shell_command|run_terminal_cmd";
 const CURSOR_HOOK_EVENTS = [
+    "sessionStart",
     "beforeSubmitPrompt",
     "beforeShellExecution",
     "afterAgentResponse",
@@ -45,6 +47,7 @@ const CURSOR_HOOK_EVENTS = [
 const POLYTOKEN_HOOK_EVENTS = [
     "pre_user_prompt",
     "post_model_turn",
+    "pre_tool_use",
 ];
 const COPILOT_CLI_HOOK_EVENTS = [
     "userPromptTransformed",
@@ -79,6 +82,7 @@ Usage:
 Commands:
   connect      Configure Lore and install native agent integrations
   ask          Query shared knowledge and prior session context
+  remember     Save a durable fact, convention, correction, or decision
   guard        Control Context Guard (off, assist, enforce)
   resume       Continue previous work with saved Lore context
   continue     Hand the current work to a different agent (--on <agent>)
@@ -98,6 +102,7 @@ Commands:
 Discover:
   lore connect --help
   lore ask --help
+  lore remember --help
   lore guard --help
   lore resume --help
   lore continue --help
@@ -111,6 +116,7 @@ Discover:
 Examples:
   lore connect --token "$LORE_WORKSPACE_TOKEN"
   lore ask "How should payment retries work?"
+  lore remember "Use pnpm for this repository." --repo acme/app
   lore resume
   lore continue --on codex
   lore connect github --repo owner/repository
@@ -183,7 +189,7 @@ function isObject(value) {
 function cloneObject(value) {
     return structuredClone(value);
 }
-export function getLorePaths(home, environment = process.env) {
+export function getLorePaths(home, environment = process.env, cwd = process.cwd()) {
     const resolvedHome = resolve(home ?? environment.HOME ?? homedir());
     const loreDirectory = resolve(resolvedHome, ".lore");
     const xdgConfigHome = environment.XDG_CONFIG_HOME?.trim() === undefined ||
@@ -210,9 +216,10 @@ export function getLorePaths(home, environment = process.env) {
         codexHooks: resolve(resolvedHome, ".codex", "hooks.json"),
         copilotCliHooks: resolve(copilotHome, "hooks", "lore.json"),
         copilotVscodeHooks: resolve(environment.LORE_COPILOT_VSCODE_HOOKS?.trim() ||
-            resolve(process.cwd(), ".github", "hooks", "lore-vscode.json")),
+            resolve(cwd, ".github", "hooks", "lore-vscode.json")),
         claudeSettings: resolve(resolvedHome, ".claude", "settings.json"),
         cursorHooks: resolve(resolvedHome, ".cursor", "hooks.json"),
+        cursorMcp: resolve(resolvedHome, ".cursor", "mcp.json"),
         cursorUserData: platform() === "darwin"
             ? resolve(resolvedHome, "Library", "Application Support", "Cursor")
             : resolve(resolvedHome, ".config", "Cursor"),
@@ -365,6 +372,35 @@ function cursorEventHandler(event, paths) {
                     : 25,
     };
 }
+const CURSOR_MCP_NAME = "lore-native";
+function cursorMcpServer(paths) {
+    return {
+        type: "stdio", command: process.execPath,
+        args: [...(IS_STANDALONE_BINARY ? [] : [fileURLToPath(import.meta.url)]), "cursor-mcp", "--owner", "lore"],
+        env: { LORE_HOME: paths.home },
+    };
+}
+function isLoreCursorMcp(value) {
+    return isObject(value) && Array.isArray(value.args) && value.args.includes("cursor-mcp")
+        && value.args.includes("--owner") && value.args.includes("lore");
+}
+export function mergeLoreCursorMcp(input, paths) {
+    const config = objectConfiguration(input, "cursor");
+    if (config.mcpServers !== undefined && !isObject(config.mcpServers))
+        throw new Error("Cursor mcpServers must be an object");
+    const servers = isObject(config.mcpServers) ? config.mcpServers : {};
+    if (servers[CURSOR_MCP_NAME] !== undefined && !isLoreCursorMcp(servers[CURSOR_MCP_NAME])) {
+        throw new Error('Cursor MCP name "lore-native" is already owned by another server; rename it before connecting.');
+    }
+    return { ...config, mcpServers: { ...servers, [CURSOR_MCP_NAME]: cursorMcpServer(paths) } };
+}
+export function removeLoreCursorMcp(input) {
+    const config = objectConfiguration(input, "cursor");
+    if (!isObject(config.mcpServers) || !isLoreCursorMcp(config.mcpServers[CURSOR_MCP_NAME]))
+        return config;
+    const { [CURSOR_MCP_NAME]: _lore, ...rest } = config.mcpServers;
+    return { ...config, mcpServers: rest };
+}
 function stripLoreFromCursorEvent(value) {
     return Array.isArray(value) ? value.filter((hook) => !isLoreHook(hook)) : [];
 }
@@ -1156,7 +1192,7 @@ const AGENT_TARGETS = {
     },
     cursor: {
         integration: "hooks",
-        expected: CURSOR_HOOK_EVENTS.length,
+        expected: CURSOR_HOOK_EVENTS.length + 1,
         runtimeRequired: true,
         emptyValue: () => ({}),
         configPath: (paths) => paths.cursorHooks,
@@ -1398,6 +1434,7 @@ async function installRuntime(paths) {
             rm(paths.runtimeReliabilityStore, { force: true }),
             rm(paths.runtimeSignedSnapshot, { force: true }),
             rm(paths.runtimeCanonicalJson, { force: true }),
+            rm(resolve(dirname(paths.runtime), "guard-evaluation.js"), { force: true }),
             rm(paths.runtimeContextFallback, { force: true }),
             rm(paths.runtimeInvocationHealthWriter, { force: true }),
             rm(paths.runtimeVersion, { force: true }),
@@ -1407,6 +1444,7 @@ async function installRuntime(paths) {
     }
     const sourceDirectory = dirname(fileURLToPath(import.meta.url));
     const canonicalJsonModule = fileURLToPath(import.meta.resolve("@lore-co/core/canonical-json"));
+    const guardEvaluation = await readFile(fileURLToPath(import.meta.resolve("@lore-co/core/guard-evaluation")), "utf8");
     const [runtime, repository, reliabilityStore, signedSnapshot, canonicalJson, contextFallback, invocationHealthWriter,] = await Promise.all([
         readFile(resolve(sourceDirectory, "runtime.js"), "utf8"),
         readFile(resolve(sourceDirectory, "repository.js"), "utf8"),
@@ -1422,7 +1460,8 @@ async function installRuntime(paths) {
     }
     const runtimeVersion = `export const RUNTIME_VERSION = ${JSON.stringify(LORE_VERSION)};\n`;
     const runtimeFiles = {
-        "lore-hook.mjs": runtime,
+        "lore-hook.mjs": runtime.replaceAll("@lore-co/core/guard-evaluation", "./guard-evaluation.js"),
+        "guard-evaluation.js": guardEvaluation,
         "repository.js": repository,
         "reliability-store.js": reliabilityStore,
         "signed-snapshot.js": standaloneSignedSnapshot,
@@ -1442,6 +1481,7 @@ async function installRuntime(paths) {
         },
     };
     await Promise.all([
+        atomicWrite(resolve(dirname(paths.runtime), "guard-evaluation.js"), guardEvaluation, 0o600),
         atomicWrite(paths.runtimeRepository, repository, 0o600),
         atomicWrite(paths.runtimeReliabilityStore, reliabilityStore, 0o600),
         atomicWrite(paths.runtimeSignedSnapshot, standaloneSignedSnapshot, 0o600),
@@ -1453,7 +1493,7 @@ async function installRuntime(paths) {
     ]);
     // The hook entrypoint is the generation activation marker. Updating it last
     // prevents a new runtime from loading before all of its local modules exist.
-    await atomicWrite(paths.runtime, runtime, 0o700);
+    await atomicWrite(paths.runtime, runtimeFiles["lore-hook.mjs"], 0o700);
 }
 function agentConfigPath(agent, paths) {
     return targetFor(agent).configPath(paths);
@@ -1572,7 +1612,7 @@ export async function connectWithCredential(options) {
     if (platform() !== "darwin" && platform() !== "linux") {
         throw new Error("Lore agent integrations currently support macOS and Linux");
     }
-    const paths = getLorePaths();
+    const paths = getLorePaths(options.home, options.home === undefined ? process.env : {}, options.cwd);
     const existing = await readConnectorConfig(paths);
     const apiUrl = normalizeApiUrl(options.apiUrl);
     const dashboardUrl = options.dashboardUrl === undefined
@@ -1603,17 +1643,30 @@ export async function connectWithCredential(options) {
     const now = new Date();
     const documents = new Map();
     const mergedDocuments = new Map();
+    const cursorMcpDocuments = new Map();
     for (const installation of installations) {
         const key = installationKey(installation);
         const document = await readJsonDocument(installation.configPath);
         documents.set(key, document);
         mergedDocuments.set(key, mergeAgentConfig(document.value, installation.agent, paths));
+        if (installation.agent === "cursor") {
+            const mcpPath = resolve(dirname(installation.configPath), "mcp.json");
+            const mcp = await readJsonDocument(mcpPath);
+            cursorMcpDocuments.set(mcpPath, { document: mcp, merged: mergeLoreCursorMcp(mcp.exists ? mcp.value : {}, paths) });
+        }
     }
     if (installations.some((installation) => targetFor(installation.agent).runtimeRequired)) {
         await installRuntime(paths);
     }
     const changedHookFiles = [];
     const backups = [];
+    for (const [path, { document, merged }] of cursorMcpDocuments) {
+        const result = await writeMergedJson(path, document, merged, now);
+        if (result.changed)
+            changedHookFiles.push(path);
+        if (result.backup)
+            backups.push(result.backup);
+    }
     for (const installation of installations) {
         const key = installationKey(installation);
         const document = documents.get(key);
@@ -1890,6 +1943,7 @@ async function inspectRuntimeInstallation(required, paths) {
     }
     const runtimeFiles = {
         "lore-hook.mjs": paths.runtime,
+        "guard-evaluation.js": resolve(dirname(paths.runtime), "guard-evaluation.js"),
         "repository.js": paths.runtimeRepository,
         "reliability-store.js": paths.runtimeReliabilityStore,
         "signed-snapshot.js": paths.runtimeSignedSnapshot,
@@ -2003,6 +2057,14 @@ async function getAgentStatus(agent, config, paths, runtime) {
             units.push(...inspectInstallationUnits(document.value === undefined
                 ? target.emptyValue()
                 : document.value, agent, paths, index, configPaths.length));
+            if (agent === "cursor") {
+                const mcp = await readJsonDocument(resolve(dirname(path), "mcp.json"));
+                const value = isObject(mcp.value) && isObject(mcp.value.mcpServers) ? mcp.value.mcpServers[CURSOR_MCP_NAME] : undefined;
+                const owned = Number(isLoreCursorMcp(value));
+                installed += owned;
+                units.push({ id: installationUnitId("mcp", index, configPaths.length),
+                    state: installationUnitState(owned, Number(exactConfiguration(value, cursorMcpServer(paths)))) });
+            }
         }
         catch {
             invalidConfiguration = true;
@@ -2129,6 +2191,17 @@ async function disconnectCommand(args) {
     ]);
     for (const installation of installations) {
         const path = installation.configPath;
+        if (installation.agent === "cursor") {
+            const mcpPath = resolve(dirname(path), "mcp.json");
+            const mcp = await readJsonDocument(mcpPath);
+            if (mcp.exists) {
+                const result = await writeMergedJson(mcpPath, mcp, removeLoreCursorMcp(mcp.value), now);
+                if (result.changed)
+                    changedHookFiles.push(mcpPath);
+                if (result.backup)
+                    backups.push(result.backup);
+            }
+        }
         const document = await readJsonDocument(path);
         if (!document.exists) {
             continue;
@@ -2149,6 +2222,7 @@ async function disconnectCommand(args) {
         rm(paths.runtimeSignedSnapshot, { force: true }),
         rm(paths.runtimeCanonicalJson, { force: true }),
         rm(paths.runtimeContextFallback, { force: true }),
+        rm(resolve(dirname(paths.runtime), "guard-evaluation.js"), { force: true }),
         rm(paths.runtimeInvocationHealthWriter, { force: true }),
         rm(paths.runtimeVersion, { force: true }),
         rm(paths.runtimePackage, { force: true }),
@@ -2431,6 +2505,9 @@ export async function runCli(args = process.argv.slice(2)) {
         case "ask":
             await runAskCommand(commandArgs, await readConnectorConfig(getLorePaths()));
             return;
+        case "remember":
+            await runRememberCommand(commandArgs, await readConnectorConfig(getLorePaths()));
+            return;
         case "guard":
             await runGuardCommand(commandArgs, await readConnectorConfig(getLorePaths()));
             return;
@@ -2494,6 +2571,9 @@ export async function runCli(args = process.argv.slice(2)) {
         case "hook":
             await runHook(commandArgs);
             return;
+        case "cursor-mcp":
+            await (await import("./cursor-mcp.js")).runCursorMcpServer();
+            return;
         case "internal-health-write": {
             const encoded = commandArgs[0] ?? (await readInvocationHealthWriteInput());
             await runInvocationHealthWrite(encoded);