@lorekit/cli 1.59.0 → 1.60.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lorekit/cli",
-  "version": "1.59.0",
+  "version": "1.60.0",
   "description": "Install the LoreKit shared-memory skill and run health checks for the LoreKit MCP server.",
   "license": "MIT",
   "repository": {

package/src/adapters/cursor.mjs

@@ -28,7 +28,7 @@ export const cursor = {
       cwd:
         input.cwd ||
         (Array.isArray(input.workspace_roots) ? input.workspace_roots[0] : null),
-      sessionId: input.generation_id || input.conversation_id || null,
+      sessionId: input.conversation_id || input.generation_id || null,
       toolName: 'command',
       toolResponse: null,
       event: input.hook_event_name || null,

package/src/commands/hook.mjs

@@ -109,6 +109,23 @@ async function run(args, meter) {
   const parsed = adapter.parse(input);
   const event = args.event || parsed.event;
 
+  // Every adapter already normalises the host's own session id off the stdin
+  // payload (Claude's `session_id`, Codex's `thread_id`, Cursor's
+  // `conversation_id`). Publishing it as `LOREKIT_SESSION_ID` — the first name
+  // `deriveSessionContext` looks for — is what lets a hook-driven remote read
+  // carry a `correlation_id`, so the dashboard's Runs view can group a session's
+  // reads and writes. It is the AUTHORITATIVE id: the payload says which session
+  // this fire belongs to, whereas an inherited env var only says which process
+  // tree we happen to be in, and Cursor/Codex export nothing at all.
+  //
+  // `||=`, never an overwrite: an explicit LOREKIT_SESSION_ID (or the
+  // LOREKIT_CORRELATION_ID that outranks all of this) is a deliberate override
+  // and must keep winning. Process-local and short-lived — this CLI invocation
+  // handles exactly one hook fire and exits.
+  if (parsed.sessionId && !process.env.LOREKIT_SESSION_ID) {
+    process.env.LOREKIT_SESSION_ID = parsed.sessionId;
+  }
+
   // Harvest the real payload when recording is enabled (opt-in via env).
   recordFixture(args.adapter, event, raw);
 

package/src/shared/deeplink-pure.mjs

@@ -46,6 +46,9 @@ export const LORE_PARAM_DEFAULTS = {
   // "unfiltered".
   filters: null,
   tags: [], // string[] — legacy label filter (AND across labels); [] means "no filter". Still READ by the app, superseded by `filters`
+  // RetentionConditions | null — the retention-preview trio (min age / unseen-for
+  // / seen-at-most). `null` means no narrowing; absent from the URL when unset.
+  retention: null,
   // 'active' | 'archived' | 'expiring' | null — the Explorer's Status control.
   // `null`, NOT 'active', is the default for `filters`' reason: the app has to
   // tell "absent" from an explicit choice, because an absent `status` falls back
@@ -59,9 +62,21 @@ export const LORE_PARAM_DEFAULTS = {
 
 // A stable, readable param order (also makes URLs deterministic for tests).
 // Mirrors the `useUrlState` call order in `LoreExplorer.tsx` (+ the `lesson`
-// param last), so `filters` and `tags` sit between `owner` and `status`. `scope`
-// precedes `lesson` so a lesson link reads `?scope=…&lesson=…`.
-const PARAM_ORDER = ['scope', 'q', 'range', 'owner', 'filters', 'tags', 'status', 'archived', 'lesson'];
+// param last), so `filters` and `tags` sit between `owner` and `status`, and
+// `retention` sits between `tags` and `status`. `scope` precedes `lesson` so a
+// lesson link reads `?scope=…&lesson=…`.
+const PARAM_ORDER = [
+  'scope',
+  'q',
+  'range',
+  'owner',
+  'filters',
+  'tags',
+  'retention',
+  'status',
+  'archived',
+  'lesson',
+];
 
 // Strip trailing slashes from a base URL, falling back to the default when the
 // input is empty/absent. Pure.

package/src/shared/mcp.mjs

@@ -231,7 +231,19 @@ export function deriveSessionContext(env = process.env) {
   // Well-known agent-host session id env vars. Best-effort: hosts differ and
   // this is not an exhaustive registry, so an unrecognised host still falls
   // through to `unknown` rather than fabricating an id.
-  const sessionId = firstNonEmptyEnv(env, ['LOREKIT_SESSION_ID', 'CLAUDE_SESSION_ID']);
+  //
+  // `CLAUDE_CODE_SESSION_ID` is the name Claude Code actually exports (verified
+  // against a live session's env); `CLAUDE_SESSION_ID` was a guess and is not
+  // set by any Claude Code version, so before it was joined here EVERY local
+  // Claude session fell through to `unknown` with no correlation id — which is
+  // why `GET /memories/usage/runs` returned an empty list on an account with
+  // ~44K usage events. Kept alongside rather than replaced: it costs nothing,
+  // and dropping a name is how the same blind spot comes back.
+  const sessionId = firstNonEmptyEnv(env, [
+    'LOREKIT_SESSION_ID',
+    'CLAUDE_CODE_SESSION_ID',
+    'CLAUDE_SESSION_ID',
+  ]);
   if (sessionId) {
     // A local session IS known even when the specific id fails the
     // correlation-id charset/length check — report the kind either way, and

package/src/surfaces.generated.mjs

@@ -528,6 +528,135 @@ export const MCP_TOOL_DEFS = [
           "minimum": 0,
           "maximum": 100000,
           "description": "Match only lessons that have recurred at most this many times."
+        },
+        "tags": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons carrying these labels — combined by `tags_mode`."
+        },
+        "tags_mode": {
+          "type": "string",
+          "enum": [
+            "any",
+            "all",
+            "none"
+          ],
+          "default": "any",
+          "description": "\"any\" (carries at least one), \"all\" (carries every one), or \"none\" (carries none)."
+        },
+        "source_agent": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons whose writing agent is one of these (or, with mode \"nin\", none of these) — e.g. \"claude\", \"aw\"."
+        },
+        "source_agent_mode": {
+          "type": "string",
+          "enum": [
+            "in",
+            "nin"
+          ],
+          "default": "in",
+          "description": "How the source_agent filter combines."
+        },
+        "trigger": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons whose write trigger is one of these (or, with mode \"nin\", none of these) — e.g. \"stuck-loop\", \"pr-webhook\"."
+        },
+        "trigger_mode": {
+          "type": "string",
+          "enum": [
+            "in",
+            "nin"
+          ],
+          "default": "in",
+          "description": "How the trigger filter combines."
+        },
+        "kind": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons whose kind is one of these (or, with mode \"nin\", none of these) — e.g. \"lesson\", \"bus\", \"signal\"."
+        },
+        "kind_mode": {
+          "type": "string",
+          "enum": [
+            "in",
+            "nin"
+          ],
+          "default": "in",
+          "description": "How the kind filter combines."
+        },
+        "host": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons whose owning host is one of these (or, with mode \"nin\", none of these) — e.g. \"reviewer\", \"aw\"."
+        },
+        "host_mode": {
+          "type": "string",
+          "enum": [
+            "in",
+            "nin"
+          ],
+          "default": "in",
+          "description": "How the host filter combines."
+        },
+        "origin_repo": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons whose origin repository is one of these (or, with mode \"nin\", none of these) — e.g. \"owner/repo\"."
+        },
+        "origin_repo_mode": {
+          "type": "string",
+          "enum": [
+            "in",
+            "nin"
+          ],
+          "default": "in",
+          "description": "How the origin_repo filter combines."
+        },
+        "origin_branch": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons whose origin branch is one of these (or, with mode \"nin\", none of these) — e.g. \"main\", \"feat/x\"."
+        },
+        "origin_branch_mode": {
+          "type": "string",
+          "enum": [
+            "in",
+            "nin"
+          ],
+          "default": "in",
+          "description": "How the origin_branch filter combines."
+        },
+        "origin_pr": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons from one of these pull-request numbers, as digit strings — e.g. \"482\"."
+        },
+        "origin_pr_mode": {
+          "type": "string",
+          "enum": [
+            "in",
+            "nin"
+          ],
+          "default": "in",
+          "description": "How the origin_pr filter combines."
         }
       }
     }
@@ -578,6 +707,135 @@ export const MCP_TOOL_DEFS = [
           "minimum": 0,
           "maximum": 100000,
           "description": "Match only lessons that have recurred at most this many times. Omit to leave unchanged; pass explicit null to clear."
+        },
+        "tags": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons carrying these labels — combined by `tags_mode`. Omit to leave unchanged; pass explicit null to clear."
+        },
+        "tags_mode": {
+          "type": "string",
+          "enum": [
+            "any",
+            "all",
+            "none"
+          ],
+          "default": "any",
+          "description": "\"any\" (carries at least one), \"all\" (carries every one), or \"none\" (carries none). Omit to leave unchanged; pass explicit null to clear."
+        },
+        "source_agent": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons whose writing agent is one of these (or, with mode \"nin\", none of these) — e.g. \"claude\", \"aw\". Omit to leave unchanged; pass explicit null to clear."
+        },
+        "source_agent_mode": {
+          "type": "string",
+          "enum": [
+            "in",
+            "nin"
+          ],
+          "default": "in",
+          "description": "How the source_agent filter combines. Omit to leave unchanged; pass explicit null to clear."
+        },
+        "trigger": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons whose write trigger is one of these (or, with mode \"nin\", none of these) — e.g. \"stuck-loop\", \"pr-webhook\". Omit to leave unchanged; pass explicit null to clear."
+        },
+        "trigger_mode": {
+          "type": "string",
+          "enum": [
+            "in",
+            "nin"
+          ],
+          "default": "in",
+          "description": "How the trigger filter combines. Omit to leave unchanged; pass explicit null to clear."
+        },
+        "kind": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons whose kind is one of these (or, with mode \"nin\", none of these) — e.g. \"lesson\", \"bus\", \"signal\". Omit to leave unchanged; pass explicit null to clear."
+        },
+        "kind_mode": {
+          "type": "string",
+          "enum": [
+            "in",
+            "nin"
+          ],
+          "default": "in",
+          "description": "How the kind filter combines. Omit to leave unchanged; pass explicit null to clear."
+        },
+        "host": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons whose owning host is one of these (or, with mode \"nin\", none of these) — e.g. \"reviewer\", \"aw\". Omit to leave unchanged; pass explicit null to clear."
+        },
+        "host_mode": {
+          "type": "string",
+          "enum": [
+            "in",
+            "nin"
+          ],
+          "default": "in",
+          "description": "How the host filter combines. Omit to leave unchanged; pass explicit null to clear."
+        },
+        "origin_repo": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons whose origin repository is one of these (or, with mode \"nin\", none of these) — e.g. \"owner/repo\". Omit to leave unchanged; pass explicit null to clear."
+        },
+        "origin_repo_mode": {
+          "type": "string",
+          "enum": [
+            "in",
+            "nin"
+          ],
+          "default": "in",
+          "description": "How the origin_repo filter combines. Omit to leave unchanged; pass explicit null to clear."
+        },
+        "origin_branch": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons whose origin branch is one of these (or, with mode \"nin\", none of these) — e.g. \"main\", \"feat/x\". Omit to leave unchanged; pass explicit null to clear."
+        },
+        "origin_branch_mode": {
+          "type": "string",
+          "enum": [
+            "in",
+            "nin"
+          ],
+          "default": "in",
+          "description": "How the origin_branch filter combines. Omit to leave unchanged; pass explicit null to clear."
+        },
+        "origin_pr": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons from one of these pull-request numbers, as digit strings — e.g. \"482\". Omit to leave unchanged; pass explicit null to clear."
+        },
+        "origin_pr_mode": {
+          "type": "string",
+          "enum": [
+            "in",
+            "nin"
+          ],
+          "default": "in",
+          "description": "How the origin_pr filter combines. Omit to leave unchanged; pass explicit null to clear."
         }
       }
     }
@@ -629,6 +887,135 @@ export const MCP_TOOL_DEFS = [
           "minimum": 0,
           "maximum": 100000,
           "description": "Match only lessons that have recurred at most this many times."
+        },
+        "tags": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons carrying these labels — combined by `tags_mode`."
+        },
+        "tags_mode": {
+          "type": "string",
+          "enum": [
+            "any",
+            "all",
+            "none"
+          ],
+          "default": "any",
+          "description": "\"any\" (carries at least one), \"all\" (carries every one), or \"none\" (carries none)."
+        },
+        "source_agent": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons whose writing agent is one of these (or, with mode \"nin\", none of these) — e.g. \"claude\", \"aw\"."
+        },
+        "source_agent_mode": {
+          "type": "string",
+          "enum": [
+            "in",
+            "nin"
+          ],
+          "default": "in",
+          "description": "How the source_agent filter combines."
+        },
+        "trigger": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons whose write trigger is one of these (or, with mode \"nin\", none of these) — e.g. \"stuck-loop\", \"pr-webhook\"."
+        },
+        "trigger_mode": {
+          "type": "string",
+          "enum": [
+            "in",
+            "nin"
+          ],
+          "default": "in",
+          "description": "How the trigger filter combines."
+        },
+        "kind": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons whose kind is one of these (or, with mode \"nin\", none of these) — e.g. \"lesson\", \"bus\", \"signal\"."
+        },
+        "kind_mode": {
+          "type": "string",
+          "enum": [
+            "in",
+            "nin"
+          ],
+          "default": "in",
+          "description": "How the kind filter combines."
+        },
+        "host": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons whose owning host is one of these (or, with mode \"nin\", none of these) — e.g. \"reviewer\", \"aw\"."
+        },
+        "host_mode": {
+          "type": "string",
+          "enum": [
+            "in",
+            "nin"
+          ],
+          "default": "in",
+          "description": "How the host filter combines."
+        },
+        "origin_repo": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons whose origin repository is one of these (or, with mode \"nin\", none of these) — e.g. \"owner/repo\"."
+        },
+        "origin_repo_mode": {
+          "type": "string",
+          "enum": [
+            "in",
+            "nin"
+          ],
+          "default": "in",
+          "description": "How the origin_repo filter combines."
+        },
+        "origin_branch": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons whose origin branch is one of these (or, with mode \"nin\", none of these) — e.g. \"main\", \"feat/x\"."
+        },
+        "origin_branch_mode": {
+          "type": "string",
+          "enum": [
+            "in",
+            "nin"
+          ],
+          "default": "in",
+          "description": "How the origin_branch filter combines."
+        },
+        "origin_pr": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons from one of these pull-request numbers, as digit strings — e.g. \"482\"."
+        },
+        "origin_pr_mode": {
+          "type": "string",
+          "enum": [
+            "in",
+            "nin"
+          ],
+          "default": "in",
+          "description": "How the origin_pr filter combines."
         }
       }
     }
@@ -664,6 +1051,135 @@ export const MCP_TOOL_DEFS = [
           "minimum": 0,
           "maximum": 100000,
           "description": "Match only lessons that have recurred at most this many times."
+        },
+        "tags": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons carrying these labels — combined by `tags_mode`."
+        },
+        "tags_mode": {
+          "type": "string",
+          "enum": [
+            "any",
+            "all",
+            "none"
+          ],
+          "default": "any",
+          "description": "\"any\" (carries at least one), \"all\" (carries every one), or \"none\" (carries none)."
+        },
+        "source_agent": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons whose writing agent is one of these (or, with mode \"nin\", none of these) — e.g. \"claude\", \"aw\"."
+        },
+        "source_agent_mode": {
+          "type": "string",
+          "enum": [
+            "in",
+            "nin"
+          ],
+          "default": "in",
+          "description": "How the source_agent filter combines."
+        },
+        "trigger": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons whose write trigger is one of these (or, with mode \"nin\", none of these) — e.g. \"stuck-loop\", \"pr-webhook\"."
+        },
+        "trigger_mode": {
+          "type": "string",
+          "enum": [
+            "in",
+            "nin"
+          ],
+          "default": "in",
+          "description": "How the trigger filter combines."
+        },
+        "kind": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons whose kind is one of these (or, with mode \"nin\", none of these) — e.g. \"lesson\", \"bus\", \"signal\"."
+        },
+        "kind_mode": {
+          "type": "string",
+          "enum": [
+            "in",
+            "nin"
+          ],
+          "default": "in",
+          "description": "How the kind filter combines."
+        },
+        "host": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons whose owning host is one of these (or, with mode \"nin\", none of these) — e.g. \"reviewer\", \"aw\"."
+        },
+        "host_mode": {
+          "type": "string",
+          "enum": [
+            "in",
+            "nin"
+          ],
+          "default": "in",
+          "description": "How the host filter combines."
+        },
+        "origin_repo": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons whose origin repository is one of these (or, with mode \"nin\", none of these) — e.g. \"owner/repo\"."
+        },
+        "origin_repo_mode": {
+          "type": "string",
+          "enum": [
+            "in",
+            "nin"
+          ],
+          "default": "in",
+          "description": "How the origin_repo filter combines."
+        },
+        "origin_branch": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons whose origin branch is one of these (or, with mode \"nin\", none of these) — e.g. \"main\", \"feat/x\"."
+        },
+        "origin_branch_mode": {
+          "type": "string",
+          "enum": [
+            "in",
+            "nin"
+          ],
+          "default": "in",
+          "description": "How the origin_branch filter combines."
+        },
+        "origin_pr": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Match lessons from one of these pull-request numbers, as digit strings — e.g. \"482\"."
+        },
+        "origin_pr_mode": {
+          "type": "string",
+          "enum": [
+            "in",
+            "nin"
+          ],
+          "default": "in",
+          "description": "How the origin_pr filter combines."
         }
       }
     }