@lorekit/cli 1.13.0 → 1.13.1

package/bin/lorekit.mjs

@@ -59,7 +59,7 @@ ${c.bold('Commands')}
   diff        Compare the offline and remote stores for the applicable scopes and
               report divergence: local-only, remote-only, and conflicting keys
               (grouped by scope). Needs both stores readable. --json, --scope <s>.
-  tree        Show the injected scopes (branch → repo → global) as a precedence
+  tree        Show the injected scopes (project → branch → repo → global) as a precedence
     (resolve) hierarchy and mark, per key, which scope's lesson WINS and which are
               shadowed — the real hook-resolution order. --json, --scope <s>.
   lint        Flag low-quality lessons (empty/short/untrimmed value, empty key,
@@ -315,13 +315,12 @@ ${c.bold('Examples')}
 ${c.bold('Usage')}
   npx @lorekit/cli tree [options]
 
-Shows the scopes the hooks actually inject for the current directory — branch,
-repo, global, in precedence order (most-specific first) — and marks, for any key
+Shows the scopes the hooks actually inject for the current directory — project,
+branch, repo, global, in precedence order (most-specific first) — and marks, for any key
 present at more than one scope, which scope's lesson WINS and which are shadowed.
 This mirrors the SessionStart hook's resolution exactly (a more-specific scope
-overrides a broader scope's same-key lesson). Project-scope lessons are NOT
-injected by the hooks, so they are not shown here — browse them with \`lorekit list\`.
-Resolved independently per store, in the same Offline / Remote split.
+overrides a broader scope's same-key lesson). Resolved independently per store,
+in the same Offline / Remote split.
 
 ${c.bold('Options')}
   -d, --dir <path>        Target project root (default: current directory)

package/package.json

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

package/src/mcp-server.mjs

@@ -337,12 +337,31 @@ function withOverrides(args, env) {
   return out;
 }
 
+// A one-line human-readable readiness banner for `lorekit mcp`. Pure so it can
+// be unit-tested. Printed to STDERR (never stdout — that channel carries only
+// JSON-RPC frames) and only when stdin is a TTY, so a real MCP client that
+// pipes to us gets a pristine, banner-free stdout AND stderr.
+export function startupBanner(mode) {
+  return (
+    `lorekit mcp — local stdio MCP server ready (mode: ${mode}). ` +
+    'Speaking JSON-RPC 2.0 on stdin/stdout; this is machine-facing, so no ' +
+    'further output is normal. Press Ctrl-C to stop.'
+  );
+}
+
 // Entrypoint for `lorekit mcp`. Resolves the store once, then serves stdio
 // until the client closes stdin. Always resolves to exit code 0.
-export async function mcpServer(args = {}, { env = process.env, input = process.stdin, output = process.stdout } = {}) {
+export async function mcpServer(
+  args = {},
+  { env = process.env, input = process.stdin, output = process.stdout, errorOutput = process.stderr } = {},
+) {
   const root = resolveProjectRoot(args.dir);
   const control = loadControl(root, { env: withOverrides(args, env) });
   const handle = createHandler(control);
+  // A human who runs `lorekit mcp` in a terminal would otherwise see a silent
+  // hang with no sign it is alive. Reassure them on stderr — but only when
+  // stdin is a TTY, so a piped MCP client never sees the banner on either channel.
+  if (input && input.isTTY) errorOutput.write(startupBanner(control.mode) + '\n');
   await runStdio(handle, input, output);
   return 0;
 }