@lore-co/cli 0.2.22 → 0.2.24

package/dist/mcp-config.js

@@ -0,0 +1,196 @@
+import { parse as parseToml, stringify as stringifyToml } from "smol-toml";
+/**
+ * The full Lore MCP server entry that `lore connect` registers next to an
+ * agent's native hooks. Hooks deliver context and capture turns on their own;
+ * the server gives the agent explicit tools for "remember this", "what did we
+ * decide", "share this", and "make this repeatable".
+ */
+export const LORE_MCP_SERVER_NAME = "lore";
+/** Agents whose hooks or plugin are paired with the Lore MCP server. */
+export const MCP_HOST_AGENTS = ["claude", "codex", "cursor", "copilot-cli", "copilot-vscode"];
+const CODEX_MCP_START = "# >>> Lore MCP server >>>";
+const CODEX_MCP_END = "# <<< Lore MCP server <<<";
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function stableJson(value) {
+    if (Array.isArray(value))
+        return `[${value.map(stableJson).join(",")}]`;
+    if (isObject(value)) {
+        return `{${Object.keys(value).sort().map((key) => `${JSON.stringify(key)}:${stableJson(value[key])}`).join(",")}}`;
+    }
+    return JSON.stringify(value);
+}
+/**
+ * Build the server entry. `invocation` is the executable plus any script path
+ * the CLI needs (empty for the standalone binary); the stored home keeps the
+ * server on the same credentials and folder rules as the hooks, and the host
+ * name attributes saves whose caller passes no `agent`.
+ */
+export function loreMcpServerEntry(invocation, home, agent) {
+    const [command, ...prefix] = invocation;
+    if (command === undefined)
+        throw new Error("The Lore MCP server needs an executable");
+    const entry = {
+        type: "stdio",
+        command,
+        args: [...prefix, "mcp", "--owner", "lore"],
+        // Writes stay proposals that owners and admins approve; hooks already
+        // deliver context per prompt, so the server skips its own delivery tool.
+        env: { LORE_HOME: home, LORE_MCP_WRITE_TOOLS: "true", LORE_MCP_HOST_CONTEXT: "hooks", LORE_MCP_AGENT: agent },
+    };
+    // Copilot CLI calls stdio servers "local" and enables tools by name.
+    if (agent === "copilot-cli")
+        return { ...entry, type: "local", tools: ["*"] };
+    return entry;
+}
+export function isLoreMcpServer(value) {
+    return isObject(value) && Array.isArray(value.args) && value.args.includes("mcp")
+        && !value.args.includes("cursor-mcp") && value.args.includes("--owner") && value.args.includes("lore");
+}
+/** Merge the entry into a JSON host config that lists servers under `mcpServers`. */
+export function mergeLoreMcpServers(config, entry, agent) {
+    if (config.mcpServers !== undefined && !isObject(config.mcpServers)) {
+        throw new Error(`${agent} mcpServers must be an object`);
+    }
+    const servers = isObject(config.mcpServers) ? config.mcpServers : {};
+    const existing = servers[LORE_MCP_SERVER_NAME];
+    if (existing !== undefined && !isLoreMcpServer(existing)) {
+        throw new Error(`${agent} MCP name "${LORE_MCP_SERVER_NAME}" is already owned by another server; rename it before connecting.`);
+    }
+    return { ...config, mcpServers: { ...servers, [LORE_MCP_SERVER_NAME]: entry } };
+}
+export function removeLoreMcpServers(config) {
+    if (!isObject(config.mcpServers) || !isLoreMcpServer(config.mcpServers[LORE_MCP_SERVER_NAME]))
+        return config;
+    const { [LORE_MCP_SERVER_NAME]: _lore, ...rest } = config.mcpServers;
+    return { ...config, mcpServers: rest };
+}
+/**
+ * VS Code reads `.vscode/mcp.json` in the repository, with servers under
+ * `servers` in the same stdio shape (type, command, args, env) the shared
+ * entry already has, so the entry is stored as built.
+ */
+export function mergeLoreVsCodeMcp(config, entry) {
+    if (config.servers !== undefined && !isObject(config.servers)) {
+        throw new Error('VS Code configuration field "servers" must be a JSON object');
+    }
+    const servers = isObject(config.servers) ? config.servers : {};
+    const existing = servers[LORE_MCP_SERVER_NAME];
+    if (existing !== undefined && !isLoreMcpServer(existing)) {
+        throw new Error(`VS Code MCP name "${LORE_MCP_SERVER_NAME}" is already owned by another server; rename it before connecting.`);
+    }
+    return { ...config, servers: { ...servers, [LORE_MCP_SERVER_NAME]: entry } };
+}
+export function removeLoreVsCodeMcp(config) {
+    if (!isObject(config.servers) || !isLoreMcpServer(config.servers[LORE_MCP_SERVER_NAME]))
+        return config;
+    const { [LORE_MCP_SERVER_NAME]: _lore, ...rest } = config.servers;
+    return { ...config, servers: rest };
+}
+/** The Lore entry in a VS Code `servers` map, or undefined when the map holds none. */
+export function loreVsCodeMcpServer(config) {
+    return isObject(config) && isObject(config.servers) ? config.servers[LORE_MCP_SERVER_NAME] : undefined;
+}
+/** OpenCode lists servers under `mcp`, with the executable and arguments as one array. */
+export function openCodeMcpEntry(entry) {
+    return {
+        type: "local",
+        command: [entry.command, ...(Array.isArray(entry.args) ? entry.args : [])],
+        environment: entry.env,
+        enabled: true,
+    };
+}
+export function isLoreOpenCodeMcp(value) {
+    return isObject(value) && Array.isArray(value.command) && value.command.includes("mcp")
+        && value.command.includes("--owner") && value.command.includes("lore");
+}
+export function mergeLoreOpenCodeMcp(config, entry) {
+    if (config.mcp !== undefined && !isObject(config.mcp))
+        throw new Error('OpenCode configuration field "mcp" must be a JSON object');
+    const servers = isObject(config.mcp) ? config.mcp : {};
+    const existing = servers[LORE_MCP_SERVER_NAME];
+    if (existing !== undefined && !isLoreOpenCodeMcp(existing)) {
+        throw new Error(`OpenCode MCP name "${LORE_MCP_SERVER_NAME}" is already owned by another server; rename it before connecting.`);
+    }
+    return { ...config, mcp: { ...servers, [LORE_MCP_SERVER_NAME]: openCodeMcpEntry(entry) } };
+}
+export function removeLoreOpenCodeMcp(config) {
+    if (!isObject(config.mcp) || !isLoreOpenCodeMcp(config.mcp[LORE_MCP_SERVER_NAME]))
+        return config;
+    const { [LORE_MCP_SERVER_NAME]: _lore, ...rest } = config.mcp;
+    return Object.keys(rest).length === 0 ? Object.fromEntries(Object.entries(config).filter(([key]) => key !== "mcp")) : { ...config, mcp: rest };
+}
+/** Codex lists servers in TOML; it has no `type` field. */
+function codexMcpTable(entry) {
+    const { type: _type, ...table } = entry;
+    return table;
+}
+function codexMcpBlock(entry) {
+    const body = stringifyToml({ mcp_servers: { [LORE_MCP_SERVER_NAME]: codexMcpTable(entry) } }).trim();
+    return `${CODEX_MCP_START}\n${body}\n${CODEX_MCP_END}\n`;
+}
+function stripCodexMcpBlocks(text) {
+    const lines = text.split("\n");
+    const kept = [];
+    let blocks = 0;
+    let inside = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!inside && trimmed === CODEX_MCP_START) {
+            inside = true;
+            blocks += 1;
+            continue;
+        }
+        if (inside) {
+            if (trimmed === CODEX_MCP_END)
+                inside = false;
+            continue;
+        }
+        kept.push(line);
+    }
+    if (inside)
+        throw new Error("The Lore block in Codex config.toml has no closing marker; repair it before connecting.");
+    return { text: kept.join("\n"), blocks };
+}
+function parseCodexConfig(text) {
+    try {
+        return parseToml(text);
+    }
+    catch {
+        return null;
+    }
+}
+function foreignCodexLoreServer(text, parsed) {
+    if (parsed !== null) {
+        return isObject(parsed.mcp_servers) && parsed.mcp_servers[LORE_MCP_SERVER_NAME] !== undefined;
+    }
+    // Unparsable by this CLI: fall back to a textual check so the user's own
+    // entry is never shadowed by a second table of the same name.
+    return /^\s*\[\s*mcp_servers\.lore\s*[\].]/mu.test(text)
+        || (/^\s*\[\s*mcp_servers\s*\]/mu.test(text) && /^\s*lore\s*[.=]/mu.test(text));
+}
+/** Add or refresh the Lore block without rewriting the rest of the user's file. */
+export function mergeLoreCodexMcp(text, entry) {
+    const stripped = stripCodexMcpBlocks(text).text;
+    if (foreignCodexLoreServer(stripped, parseCodexConfig(stripped))) {
+        throw new Error(`Codex MCP server "${LORE_MCP_SERVER_NAME}" is already defined in config.toml; rename it before connecting.`);
+    }
+    const base = stripped.replace(/\s+$/u, "");
+    return `${base === "" ? "" : `${base}\n\n`}${codexMcpBlock(entry)}`;
+}
+export function removeLoreCodexMcp(text) {
+    const { text: stripped, blocks } = stripCodexMcpBlocks(text);
+    if (blocks === 0)
+        return text;
+    const base = stripped.replace(/\s+$/u, "");
+    return base === "" ? "" : `${base}\n`;
+}
+/** How many Lore blocks the file holds and whether the parsed entry matches. */
+export function inspectCodexMcp(text, entry) {
+    const { blocks } = stripCodexMcpBlocks(text);
+    const parsed = parseCodexConfig(text);
+    const value = parsed !== null && isObject(parsed.mcp_servers) ? parsed.mcp_servers[LORE_MCP_SERVER_NAME] : undefined;
+    return { owned: blocks, exact: blocks === 1 && stableJson(value) === stableJson(codexMcpTable(entry)) };
+}
+//# sourceMappingURL=mcp-config.js.map

package/dist/mcp-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config.js","sourceRoot":"","sources":["../src/mcp-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,WAAW,CAAC;AAE3E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAE3C,wEAAwE;AACxE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,gBAAgB,CAAU,CAAC;AAKvG,MAAM,eAAe,GAAG,2BAA2B,CAAC;AACpD,MAAM,aAAa,GAAG,2BAA2B,CAAC;AAElD,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACxE,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACrH,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAA6B,EAAE,IAAY,EAAE,KAAmB;IACjG,MAAM,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,GAAG,UAAU,CAAC;IACxC,IAAI,OAAO,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACtF,MAAM,KAAK,GAA4B;QACrC,IAAI,EAAE,OAAO;QACb,OAAO;QACP,IAAI,EAAE,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC;QAC3C,sEAAsE;QACtE,yEAAyE;QACzE,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,EAAE,qBAAqB,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE;KAC9G,CAAC;IACF,qEAAqE;IACrE,IAAI,KAAK,KAAK,aAAa;QAAE,OAAO,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;IAC9E,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;WAC5E,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC3G,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,mBAAmB,CACjC,MAA+B,EAC/B,KAA8B,EAC9B,KAAa;IAEb,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,+BAA+B,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IACrE,MAAM,QAAQ,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC/C,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,cAAc,oBAAoB,oEAAoE,CAAC,CAAC;IAClI,CAAC;IACD,OAAO,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,oBAAoB,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAA+B;IAClE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IAC7G,MAAM,EAAE,CAAC,oBAAoB,CAAC,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC;IACrE,OAAO,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA+B,EAAE,KAA8B;IAChG,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IACD,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,MAAM,QAAQ,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC/C,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,qBAAqB,oBAAoB,oEAAoE,CAAC,CAAC;IACjI,CAAC;IACD,OAAO,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,oBAAoB,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAA+B;IACjE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IACvG,MAAM,EAAE,CAAC,oBAAoB,CAAC,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC;IAClE,OAAO,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACtC,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,mBAAmB,CAAC,MAAe;IACjD,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACzG,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,gBAAgB,CAAC,KAA8B;IAC7D,OAAO;QACL,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1E,WAAW,EAAE,KAAK,CAAC,GAAG;QACtB,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;WAClF,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAA+B,EAAE,KAA8B;IAClG,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IACnI,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACvD,MAAM,QAAQ,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC/C,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,sBAAsB,oBAAoB,oEAAoE,CAAC,CAAC;IAClI,CAAC;IACD,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,oBAAoB,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAA+B;IACnE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IACjG,MAAM,EAAE,CAAC,oBAAoB,CAAC,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC;IAC9D,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;AACjJ,CAAC;AAED,2DAA2D;AAC3D,SAAS,aAAa,CAAC,KAA8B;IACnD,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC;IACxC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CAAC,KAA8B;IACnD,MAAM,IAAI,GAAG,aAAa,CAAC,EAAE,WAAW,EAAE,EAAE,CAAC,oBAAoB,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACrG,OAAO,GAAG,eAAe,KAAK,IAAI,KAAK,aAAa,IAAI,CAAC;AAC3D,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,MAAM,IAAI,OAAO,KAAK,eAAe,EAAE,CAAC;YAC3C,MAAM,GAAG,IAAI,CAAC;YACd,MAAM,IAAI,CAAC,CAAC;YACZ,SAAS;QACX,CAAC;QACD,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,OAAO,KAAK,aAAa;gBAAE,MAAM,GAAG,KAAK,CAAC;YAC9C,SAAS;QACX,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,yFAAyF,CAAC,CAAC;IACvH,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAY,EAAE,MAAsC;IAClF,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC,oBAAoB,CAAC,KAAK,SAAS,CAAC;IAChG,CAAC;IACD,yEAAyE;IACzE,8DAA8D;IAC9D,OAAO,sCAAsC,CAAC,IAAI,CAAC,IAAI,CAAC;WACnD,CAAC,6BAA6B,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACpF,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,KAA8B;IAC5E,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;IAChD,IAAI,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,qBAAqB,oBAAoB,mEAAmE,CAAC,CAAC;IAChI,CAAC;IACD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC3C,OAAO,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC7D,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC3C,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC;AACxC,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,KAA8B;IAE9B,MAAM,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,MAAM,KAAK,IAAI,IAAI,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACrH,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,KAAK,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;AAC1G,CAAC"}

package/dist/owned-files.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Files Lore writes into an agent's own directories (skills, agent
+ * definitions) and must later remove without touching the customer's edits.
+ * Ownership is a manifest of file path to content digest; a file is only
+ * rewritten or deleted while its content still matches the recorded digest.
+ */
+export declare const digest: (text: string) => string;
+export type OwnedManifest = Record<string, string>;
+/** True when no component of the path is a symlink. Lore never follows links into other files. */
+export declare function regularPath(path: string): Promise<boolean>;
+export declare function readOwnedManifest(file: string, subject: string): Promise<OwnedManifest>;
+export declare function atomicWrite(file: string, text: string): Promise<void>;
+export declare function readIfPresent(file: string): Promise<string | null>;
+/**
+ * Delete the file when the manifest owns it and its content is unchanged;
+ * then drop an empty parent directory and the manifest entry. Returns false
+ * when the file was left alone.
+ */
+export declare function removeOwnedFile(file: string, manifest: OwnedManifest, removeEmptyDirectory?: boolean): Promise<boolean>;
+export declare function ownedFileHint(subject: string, file: string, error: unknown, consequence: string): string;
+//# sourceMappingURL=owned-files.d.ts.map

package/dist/owned-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owned-files.d.ts","sourceRoot":"","sources":["../src/owned-files.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,KAAG,MAAyD,CAAC;AAEhG,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEnD,kGAAkG;AAClG,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAWhE;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAU7F;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK3E;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAKxE;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,oBAAoB,UAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAe1H;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAIxG"}

package/dist/owned-files.js

@@ -0,0 +1,88 @@
+import { createHash, randomUUID } from "node:crypto";
+import { lstat, mkdir, readFile, rename, rm, rmdir, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+/**
+ * Files Lore writes into an agent's own directories (skills, agent
+ * definitions) and must later remove without touching the customer's edits.
+ * Ownership is a manifest of file path to content digest; a file is only
+ * rewritten or deleted while its content still matches the recorded digest.
+ */
+export const digest = (text) => createHash("sha256").update(text).digest("hex");
+/** True when no component of the path is a symlink. Lore never follows links into other files. */
+export async function regularPath(path) {
+    let current = path;
+    while (dirname(current) !== current) {
+        const stat = await lstat(current).catch((error) => {
+            if (error.code !== "ENOENT")
+                throw error;
+            return null;
+        });
+        if (stat?.isSymbolicLink())
+            return false;
+        current = dirname(current);
+    }
+    return true;
+}
+export async function readOwnedManifest(file, subject) {
+    if (!await regularPath(file))
+        throw new Error(`${subject} ownership file is a symlink.`);
+    try {
+        const value = JSON.parse(await readFile(file, "utf8"));
+        if (!value || typeof value !== "object" || Array.isArray(value))
+            throw new Error(`Invalid ${subject.toLowerCase()} ownership file.`);
+        return Object.fromEntries(Object.entries(value).filter((entry) => typeof entry[1] === "string" && /^[a-f0-9]{64}$/u.test(entry[1])));
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return {};
+        throw error;
+    }
+}
+export async function atomicWrite(file, text) {
+    await mkdir(dirname(file), { recursive: true });
+    const temporary = `${file}.${randomUUID()}.tmp`;
+    try {
+        await writeFile(temporary, text, { flag: "wx", mode: 0o600 });
+        await rename(temporary, file);
+    }
+    finally {
+        await rm(temporary, { force: true });
+    }
+}
+export async function readIfPresent(file) {
+    return readFile(file, "utf8").catch((error) => {
+        if (error.code !== "ENOENT")
+            throw error;
+        return null;
+    });
+}
+/**
+ * Delete the file when the manifest owns it and its content is unchanged;
+ * then drop an empty parent directory and the manifest entry. Returns false
+ * when the file was left alone.
+ */
+export async function removeOwnedFile(file, manifest, removeEmptyDirectory = true) {
+    if (!manifest[file] || !await regularPath(file))
+        return false;
+    const existing = await readIfPresent(file);
+    if (existing !== null && digest(existing) !== manifest[file])
+        return false;
+    if (existing !== null) {
+        await rm(file);
+        // Remove only an empty directory; preserve any customer resources.
+        if (removeEmptyDirectory) {
+            await rmdir(dirname(file)).catch((error) => {
+                if (!["ENOENT", "ENOTEMPTY", "EEXIST"].includes(error.code ?? ""))
+                    throw error;
+            });
+        }
+    }
+    delete manifest[file];
+    return true;
+}
+export function ownedFileHint(subject, file, error, consequence) {
+    const code = error.code;
+    const reason = code === "EACCES" || code === "EPERM" ? "permission denied" : (code ?? error.message);
+    return `${subject} ${file} (${reason}). ${consequence}`;
+}
+//# sourceMappingURL=owned-files.js.map

package/dist/owned-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"owned-files.js","sourceRoot":"","sources":["../src/owned-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACxF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAIhG,kGAAkG;AAClG,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY;IAC5C,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,OAAO,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAA4B,EAAE,EAAE;YACvE,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,KAAK,CAAC;YACzC,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;QACH,IAAI,IAAI,EAAE,cAAc,EAAE;YAAE,OAAO,KAAK,CAAC;QACzC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY,EAAE,OAAe;IACnE,IAAI,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,+BAA+B,CAAC,CAAC;IACzF,IAAI,CAAC;QACH,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAChE,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,WAAW,OAAO,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;QACrI,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAA6B,EAAE,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClK,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QAClE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,IAAY;IAC1D,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,UAAU,EAAE,MAAM,CAAC;IAChD,IAAI,CAAC;QAAC,MAAM,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAAC,MAAM,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAAC,CAAC;YAC7F,CAAC;QAAC,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAAC,CAAC;AACnD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY;IAC9C,OAAO,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,KAA4B,EAAE,EAAE;QACnE,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,KAAK,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,QAAuB,EAAE,oBAAoB,GAAG,IAAI;IACtG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,QAAQ,KAAK,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3E,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;QACf,mEAAmE;QACnE,IAAI,oBAAoB,EAAE,CAAC;YACzB,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAA4B,EAAE,EAAE;gBAChE,IAAI,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;oBAAE,MAAM,KAAK,CAAC;YACjF,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;IACtB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,IAAY,EAAE,KAAc,EAAE,WAAmB;IAC9F,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAC;IACnD,MAAM,MAAM,GAAG,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,IAAI,IAAK,KAAe,CAAC,OAAO,CAAC,CAAC;IAChH,OAAO,GAAG,OAAO,IAAI,IAAI,KAAK,MAAM,MAAM,WAAW,EAAE,CAAC;AAC1D,CAAC"}

package/dist/recovery-cloud.d.ts

@@ -11,9 +11,9 @@ declare const Runner: z.ZodObject<{
     agents: z.ZodArray<z.ZodEnum<{
         claude: "claude";
         "copilot-cli": "copilot-cli";
+        codex: "codex";
         cursor: "cursor";
         devin: "devin";
-        codex: "codex";
         opencode: "opencode";
         polytoken: "polytoken";
     }>>;

package/dist/review.d.ts

@@ -0,0 +1,30 @@
+import type { Memory, ProposalDetailResponse, ReviewProposalResponse } from "@lore-co/core";
+import type { ConnectorConfig } from "./cli.js";
+import { type RepositorySource } from "./learnings.js";
+export type ReviewArguments = {
+    command: "list";
+    repo?: string;
+    allRepositories: boolean;
+    json: boolean;
+} | {
+    command: "show";
+    id: string;
+    json: boolean;
+} | {
+    command: "approve" | "decline";
+    id: string;
+    reason?: string;
+    json: boolean;
+};
+export declare function parseReviewArguments(args: readonly string[]): ReviewArguments | null;
+export declare function formatProposalList(listing: {
+    repo: string | null;
+    proposals: readonly Memory[];
+}, repoSource: RepositorySource): string;
+export declare function formatProposal(proposal: ProposalDetailResponse): string;
+export declare function formatReviewResult(command: "approve" | "decline", result: ReviewProposalResponse): string;
+export declare function runReviewCommand(args: readonly string[], config: ConnectorConfig | null, options?: {
+    cwd?: string;
+    fetcher?: typeof fetch;
+}): Promise<void>;
+//# sourceMappingURL=review.d.ts.map

package/dist/review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../src/review.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,sBAAsB,EAEtB,sBAAsB,EACvB,MAAM,eAAe,CAAC;AAOvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAOL,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AAwCxB,MAAM,MAAM,eAAe,GACvB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC3E;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC9C;IAAE,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAEnF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,eAAe,GAAG,IAAI,CA2DpF;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,EAC9D,UAAU,EAAE,gBAAgB,GAC3B,MAAM,CAmBR;AAWD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,CAoCvE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,EAAE,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAQzG;AAkDD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,MAAM,EAAE,eAAe,GAAG,IAAI,EAC9B,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,KAAK,CAAA;CAAO,GACrD,OAAO,CAAC,IAAI,CAAC,CA+Cf"}

package/dist/review.js

@@ -0,0 +1,276 @@
+import { LoreTransportError, SharedMemoryApiError, SharedMemoryClient, } from "@lore-co/sdk";
+import { ZodError } from "zod";
+import { formatDate, loadAllLearnings, resolveListingRepository, scopeLabel, singleLine, table, } from "./learnings.js";
+const REVIEW_HELP = `lore review
+Review learning proposals from the terminal: list what is waiting, read one,
+and approve or decline it.
+
+Usage:
+  lore review [list] [options]
+  lore review show <id> [--json]
+  lore review approve <id> [--reason <text>] [--json]
+  lore review decline <id> [--reason <text>] [--json]
+
+Options:
+  --repo <repo>         List proposals for this repository: its own plus
+                        workspace-wide ones (default: the Git repository of
+                        the current folder)
+  --all-repositories    List every pending proposal in the workspace
+  --reason <text>       Record why the proposal was approved or declined
+  --json                Print machine-readable JSON
+  --help                Show this command's help
+
+Proposals come from automatic extraction, lore github harvest, agent saves,
+and members' submissions. Approving activates the learning; declining retires
+it. Only a workspace owner or admin can decide, and the connection must
+identify you: connect with lore connect --login. A proposal with an open
+conflict against an existing learning is decided in the dashboard, where the
+current learning can be replaced or kept alongside.
+
+Examples:
+  lore review --repo acme/app
+  lore review show 6f1c2a3e-...
+  lore review approve 6f1c2a3e-... --reason "Matches the deployment runbook."
+  lore review decline 6f1c2a3e-... --reason "Superseded by the new lint rule."
+  lore review --all-repositories --json
+`;
+const REVIEW_COMMANDS = ["list", "show", "approve", "decline"];
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/iu;
+export function parseReviewArguments(args) {
+    if (args.some((argument) => argument === "--help" || argument === "-h")) {
+        process.stdout.write(REVIEW_HELP);
+        return null;
+    }
+    const first = args[0];
+    const named = first !== undefined && REVIEW_COMMANDS.includes(first);
+    if (first !== undefined && !named && !first.startsWith("-")) {
+        throw new Error(`Unknown review command: ${first}\nTry: lore review --help`);
+    }
+    const command = named ? first : "list";
+    const rest = named ? args.slice(1) : args;
+    const options = { allRepositories: false, json: false };
+    const positionals = [];
+    for (let index = 0; index < rest.length; index += 1) {
+        const argument = rest[index];
+        if (argument === "--json") {
+            options.json = true;
+        }
+        else if (argument === "--all-repositories") {
+            options.allRepositories = true;
+        }
+        else if (argument === "--repo" || argument === "--reason") {
+            const value = rest[index + 1]?.trim();
+            if (value === undefined || value === "" || value.startsWith("-")) {
+                throw new Error(`Missing value for ${argument}`);
+            }
+            index += 1;
+            if (argument === "--repo")
+                options.repo = value;
+            else
+                options.reason = value;
+        }
+        else if (argument.startsWith("-")) {
+            throw new Error(`Unknown review option: ${argument}`);
+        }
+        else {
+            positionals.push(argument);
+        }
+    }
+    if (command === "list") {
+        if (positionals.length > 0)
+            throw new Error(`Unexpected argument: ${positionals[0]}`);
+        if (options.reason !== undefined)
+            throw new Error("--reason applies to approve and decline.");
+        if (options.repo !== undefined && options.allRepositories) {
+            throw new Error("Use --repo or --all-repositories, not both.");
+        }
+        return {
+            command,
+            ...(options.repo === undefined ? {} : { repo: options.repo }),
+            allRepositories: options.allRepositories,
+            json: options.json,
+        };
+    }
+    if (options.repo !== undefined || options.allRepositories) {
+        throw new Error(`--repo and --all-repositories apply to lore review list, not ${command}.`);
+    }
+    const id = positionals[0];
+    if (id === undefined)
+        throw new Error(`Usage: lore review ${command} <id>`);
+    if (positionals.length > 1)
+        throw new Error(`Unexpected argument: ${positionals[1]}`);
+    if (!UUID.test(id))
+        throw new Error(`Not a proposal ID: ${id}. Copy the ID from lore review.`);
+    if (command === "show") {
+        if (options.reason !== undefined)
+            throw new Error("--reason applies to approve and decline.");
+        return { command, id, json: options.json };
+    }
+    return { command, id, ...(options.reason === undefined ? {} : { reason: options.reason }), json: options.json };
+}
+export function formatProposalList(listing, repoSource) {
+    const header = repoSource === "all"
+        ? "Repository: all repositories in the workspace\n"
+        : `Repository: ${listing.repo} (${repoSource === "flag" ? "from --repo" : "detected from the current folder"})\n`;
+    const count = listing.proposals.length;
+    const summary = `${count} pending proposal${count === 1 ? "" : "s"}\n`;
+    if (count === 0)
+        return `${header}${summary}`;
+    const showScope = repoSource === "all";
+    const headers = ["ID", "CATEGORY", "PROPOSED", "AGENT", ...(showScope ? ["SCOPE"] : []), "CONTENT"];
+    const rows = listing.proposals.map((memory) => [
+        memory.id,
+        memory.category,
+        formatDate(memory.createdAt),
+        memory.source.agent,
+        ...(showScope ? [singleLine(scopeLabel(memory), 40)] : []),
+        singleLine(memory.content, 100),
+    ]);
+    return `${header}${summary}\n${table(rows, headers)}\n\nNext: lore review show <id>, then lore review approve <id> or lore review decline <id>.\n`;
+}
+function decisionLabel(decision) {
+    switch (decision) {
+        case "approve": return "approved";
+        case "reject": return "declined";
+        case "use_proposal": return "approved, replacing the conflicting learning";
+        case "keep_both": return "approved alongside the conflicting learning";
+    }
+}
+export function formatProposal(proposal) {
+    const { memory, metadata, conflicts, conflictTargets } = proposal;
+    const source = [
+        memory.source.agent,
+        ...(memory.source.sessionId === undefined ? [] : [`session ${memory.source.sessionId}`]),
+    ].join(", ");
+    const decision = metadata.decision === null
+        ? "pending"
+        : `${decisionLabel(metadata.decision)} on ${formatDate(metadata.decidedAt ?? metadata.proposedAt)}${metadata.decisionReason === null ? "" : `: ${metadata.decisionReason}`}`;
+    const lines = [
+        `Proposal ${memory.id}`,
+        `Status:    ${memory.status}`,
+        `Category:  ${memory.category}`,
+        `Scope:     ${scopeLabel(memory)}`,
+        `Source:    ${source}`,
+        `Proposed:  ${formatDate(metadata.proposedAt)} (${metadata.reason})`,
+        `Decision:  ${decision}`,
+        "",
+        memory.content.trim(),
+    ];
+    if (conflicts.length > 0) {
+        const targets = new Map(conflictTargets.map((target) => [target.id, target]));
+        lines.push("", `Conflicts (${conflicts.length}):`);
+        for (const conflict of conflicts) {
+            const state = conflict.resolution === null ? "open" : decisionLabel(conflict.resolution);
+            lines.push(`  ${conflict.severity} ${conflict.detector} conflict with ${conflict.targetMemoryId} (${state})`);
+            lines.push(`    Evidence: ${singleLine(conflict.evidence.summary, 100)}`);
+            const target = targets.get(conflict.targetMemoryId);
+            if (target !== undefined)
+                lines.push(`    Current:  ${singleLine(target.content, 100)}`);
+        }
+        if (conflicts.some((conflict) => conflict.resolution === null)) {
+            lines.push("", "Open conflicts are decided in the dashboard, where the current learning can be replaced or kept alongside.");
+        }
+    }
+    return `${lines.join("\n")}\n`;
+}
+export function formatReviewResult(command, result) {
+    const { proposal } = result;
+    if (command === "approve") {
+        return proposal.status === "active"
+            ? `Approved ${proposal.id}. The learning is now active${proposal.scope.repo === undefined ? " across the workspace" : ` for ${proposal.scope.repo}`}.\n`
+            : `Reviewed ${proposal.id}. Learning status: ${proposal.status}.\n`;
+    }
+    return `Declined ${proposal.id}. The proposal will not become a learning.\n`;
+}
+function detailMessage(error) {
+    const details = error.details;
+    if (typeof details === "object" && details !== null && "message" in details) {
+        const message = details.message;
+        if (typeof message === "string")
+            return message;
+        if (Array.isArray(message))
+            return message.map(String).join("; ");
+    }
+    return typeof details === "string" && details !== "" ? details : undefined;
+}
+function describeFailure(error, id) {
+    if (error instanceof SharedMemoryApiError) {
+        const detail = detailMessage(error);
+        if (error.status === 401) {
+            return new Error("Reviewing proposals needs a connection that identifies you. Reconnect with: lore connect --login");
+        }
+        if (error.status === 403) {
+            return new Error(detail ?? "Only a workspace owner or admin can review proposals.");
+        }
+        if (error.status === 404) {
+            return detail !== undefined && /not found/iu.test(detail)
+                ? new Error(`Proposal ${id ?? ""} was not found in this workspace. It may already be decided; check lore review.`.replace("  ", " "))
+                : new Error("This Lore server does not support reviewing proposals from the CLI. Upgrade the server to use lore review.");
+        }
+        if (error.status === 409) {
+            return new Error(`${detail ?? "Proposal cannot be resolved with this decision"}. Run lore review show ${id ?? "<id>"}: an open conflict or an earlier decision is handled in the dashboard.`);
+        }
+        if (error.status === 400 && detail !== undefined)
+            return new Error(detail);
+        return new Error(`Lore review failed with HTTP ${error.status}.`);
+    }
+    if (error instanceof ZodError ||
+        error instanceof SyntaxError ||
+        (error instanceof LoreTransportError && error.code === "response_too_large")) {
+        return new Error("Lore server returned an incompatible review response. Upgrade the server and CLI.");
+    }
+    return new Error("Lore API is unreachable. Run lore doctor to diagnose connectivity.");
+}
+export async function runReviewCommand(args, config, options = {}) {
+    const parsed = parseReviewArguments(args);
+    if (parsed === null)
+        return;
+    if (config === null) {
+        throw new Error("Lore is not connected. Run: lore connect --login");
+    }
+    const fetcher = options.fetcher ?? fetch;
+    const client = new SharedMemoryClient({
+        baseUrl: config.apiUrl,
+        headers: { authorization: `Bearer ${config.token}` },
+        fetch: fetcher,
+    });
+    if (parsed.command === "list") {
+        const { repo, repoSource } = await resolveListingRepository(parsed, config, { ...options, fetcher });
+        let proposals;
+        try {
+            proposals = await loadAllLearnings(client, { ...(repo === undefined ? {} : { repo }), statuses: ["proposed"] });
+        }
+        catch (error) {
+            throw describeFailure(error);
+        }
+        if (parsed.json) {
+            process.stdout.write(`${JSON.stringify({ repo: repo ?? null, total: proposals.length, proposals }, null, 2)}\n`);
+            return;
+        }
+        process.stdout.write(formatProposalList({ repo: repo ?? null, proposals }, repoSource));
+        return;
+    }
+    if (parsed.command === "show") {
+        let proposal;
+        try {
+            proposal = await client.getProposal(parsed.id);
+        }
+        catch (error) {
+            throw describeFailure(error, parsed.id);
+        }
+        process.stdout.write(parsed.json ? `${JSON.stringify(proposal, null, 2)}\n` : formatProposal(proposal));
+        return;
+    }
+    let result;
+    try {
+        result = await client.reviewProposal(parsed.id, {
+            decision: parsed.command === "approve" ? "approve" : "reject",
+            ...(parsed.reason === undefined ? {} : { reason: parsed.reason }),
+        });
+    }
+    catch (error) {
+        throw describeFailure(error, parsed.id);
+    }
+    process.stdout.write(parsed.json ? `${JSON.stringify(result, null, 2)}\n` : formatReviewResult(parsed.command, result));
+}
+//# sourceMappingURL=review.js.map