@memoraone/mcp 0.1.20 → 0.1.22

package/dist/cli.cjs

@@ -30,7 +30,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@memoraone/mcp",
-      version: "0.1.20",
+      version: "0.1.22",
       type: "module",
       main: "dist/index.cjs",
       bin: {
@@ -88,6 +88,13 @@ function ensureBaseDir() {
 var fs2 = __toESM(require("fs/promises"), 1);
 var path2 = __toESM(require("path"), 1);
 var uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function normalizeEnvironment(raw) {
+  if (raw === void 0 || raw === null || typeof raw !== "string") {
+    return void 0;
+  }
+  const trimmed = raw.trim();
+  return trimmed === "" ? void 0 : trimmed;
+}
 function parseAndValidateM1(content, markerPath) {
   let parsed;
   try {
@@ -104,7 +111,8 @@ function parseAndValidateM1(content, markerPath) {
   }
   const apiKeyRaw = parsed?.MEMORAONE_API_KEY ?? parsed?.api_key;
   const apiKey = apiKeyRaw !== void 0 && apiKeyRaw !== null && typeof apiKeyRaw === "string" && apiKeyRaw.trim() !== "" ? apiKeyRaw.trim() : null;
-  return { projectId: projectId.trim(), apiKey };
+  const environment = normalizeEnvironment(parsed?.environment);
+  return environment === void 0 ? { projectId: projectId.trim(), apiKey } : { projectId: projectId.trim(), apiKey, environment };
 }
 async function resolveProjectIdFromExplicitM1Path() {
   const raw = process.env.MEMORAONE_M1_PATH;
@@ -114,8 +122,8 @@ async function resolveProjectIdFromExplicitM1Path() {
   const markerPath = path2.resolve(raw);
   try {
     const content = await fs2.readFile(markerPath, "utf8");
-    const { projectId, apiKey } = parseAndValidateM1(content, markerPath);
-    return { projectId, apiKey, foundAt: markerPath };
+    const { projectId, apiKey, environment } = parseAndValidateM1(content, markerPath);
+    return environment === void 0 ? { projectId, apiKey, foundAt: markerPath } : { projectId, apiKey, environment, foundAt: markerPath };
   } catch (err) {
     if (err?.code === "ENOENT") {
       return null;
@@ -129,9 +137,9 @@ async function findM1WalkingUp(workspaceRoot) {
     const markerPath = path2.join(current, "memoraone.m1");
     try {
       const content = await fs2.readFile(markerPath, "utf8");
-      const { projectId, apiKey } = parseAndValidateM1(content, markerPath);
+      const { projectId, apiKey, environment } = parseAndValidateM1(content, markerPath);
       const repoRoot = path2.dirname(markerPath);
-      return { projectId, apiKey, repoRoot, markerPath };
+      return environment === void 0 ? { projectId, apiKey, repoRoot, markerPath } : { projectId, apiKey, environment, repoRoot, markerPath };
     } catch (err) {
       if (err?.code !== "ENOENT") {
         throw err;
@@ -191,6 +199,7 @@ async function resolveAuthoritativeBinding(workspaceRoot) {
       workspaceRoot: path2.dirname(explicitBinding.foundAt),
       m1Path: explicitBinding.foundAt,
       apiKey: resolved.apiKey,
+      ...explicitBinding.environment !== void 0 ? { environment: explicitBinding.environment } : {},
       bindingSource: "explicit-m1-path",
       apiKeySource: resolved.apiKeySource
     };
@@ -208,6 +217,7 @@ async function resolveAuthoritativeBinding(workspaceRoot) {
         workspaceRoot: binding.repoRoot,
         m1Path: binding.markerPath,
         apiKey: resolved.apiKey,
+        ...binding.environment !== void 0 ? { environment: binding.environment } : {},
         bindingSource: "workspace-search",
         apiKeySource: resolved.apiKeySource
       };
@@ -223,6 +233,8 @@ function encodeResolvedBinding(binding) {
 var fs3 = __toESM(require("fs/promises"), 1);
 var path3 = __toESM(require("path"), 1);
 var MANAGED_MARKER = "<!-- MemoraOne managed IDE helper -->";
+var GITIGNORE_MEMORAONE_COMMENT = "# MemoraOne local project binding / API key";
+var GITIGNORE_MEMORAONE_ENTRY = "memoraone.m1";
 var MEMORAONE_MCP_SERVER = {
   command: "npx",
   args: ["-y", "@memoraone/mcp"]
@@ -242,6 +254,40 @@ async function pathExists(filePath) {
     return false;
   }
 }
+function gitignoreAlreadyIgnoresMemoraoneM1(content) {
+  for (const line of content.split(/\r?\n/)) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    if (/^\/?memoraone\.m1\s*$/.test(trimmed)) return true;
+  }
+  return false;
+}
+function memoraoneGitignoreBlock() {
+  return `${GITIGNORE_MEMORAONE_COMMENT}
+${GITIGNORE_MEMORAONE_ENTRY}
+`;
+}
+async function ensureGitignoreMemoraone(repoRoot, opts) {
+  if (opts.noGitignore) return "skipped";
+  const abs = path3.join(repoRoot, ".gitignore");
+  assertUnderRepoRoot(repoRoot, abs);
+  let prior = "";
+  let existed = false;
+  try {
+    prior = await fs3.readFile(abs, "utf8");
+    existed = true;
+  } catch (err) {
+    const code = err && typeof err === "object" && "code" in err ? err.code : void 0;
+    if (code !== "ENOENT") throw err;
+  }
+  if (gitignoreAlreadyIgnoresMemoraoneM1(prior)) return "skipped";
+  const block = memoraoneGitignoreBlock();
+  const separator = existed && prior.length > 0 ? prior.endsWith("\n") ? "\n" : "\n\n" : "";
+  const next = (existed ? prior : "") + separator + block;
+  if (opts.dryRun) return existed ? "updated" : "created";
+  await fs3.writeFile(abs, next, "utf8");
+  return existed ? "updated" : "created";
+}
 async function findRepoRoot(startDir) {
   let current = path3.resolve(startDir);
   const root = path3.parse(current).root;
@@ -270,9 +316,12 @@ This repository uses **MemoraOne** via the MCP server named **user-memoraone** (
 ### Tools
 
 - Before answering questions about **prior decisions**, **remembered facts**, **identity or personal recall**, **preferences**, **repo history**, or **what to do next**, call **\`memora_ask_with_memory\`** so replies stay aligned with MemoraOne memory.
-- After **meaningful repository changes** (decisions, fixes, new endpoints or schema, migrations, meaningful wiring), call **\`memora_post_event\`** to append a concise timeline note.
+- Use **\`memora_post_event\`** for durable project decisions, wiring, migrations, fixes, and meaningful product behavior changes. Prefer kind \`note\`, \`content.title\`, \`content.body\` (one concise, fact-promotable statement), and metadata \`source\` (e.g. \`cursor\`), \`purpose\`: \`dev-log\`, \`schema\`: \`v1\`.
+- Use **\`memora_log_change_summary\`** for concise code or feature deltas after implementation.
+
+Do not spam events for trivial edits, formatting-only changes, or temporary WIP. Prefer concise, fact-promotable statements.
 
-Keep tool usage proportional to the task; do not spam events for trivial edits.
+Example \`content.body\`: "MemoraOne Studio added a live dashboard summary, replacing the static dashboard placeholder with authenticated project and memory activity data."
 `;
 }
 function copilotAndJetBrainsBody(title) {
@@ -285,9 +334,12 @@ This repo is set up to use **MemoraOne** through MCP where your editor exposes i
 ## Behavior
 
 - For questions about **earlier decisions**, **stored facts**, **personal or identity recall**, **preferences**, **project history**, or **recommended next steps**, use MemoraOne memory tools (e.g. **\`memora_ask_with_memory\`**) when available before answering.
-- After **substantive changes** to this codebase (feature work, bugfixes, API/schema changes, migrations, meaningful integration steps), record a short timeline note with **\`memora_post_event\`** when that tool is available.
+- Use **\`memora_post_event\`** for durable project decisions, wiring, migrations, fixes, and meaningful product behavior changes. Prefer kind \`note\`, \`content.title\`, \`content.body\` (one concise, fact-promotable statement), and metadata \`source\` (e.g. your agent name), \`purpose\`: \`dev-log\`, \`schema\`: \`v1\`.
+- Use **\`memora_log_change_summary\`** for concise code or feature deltas after implementation.
 
-Use judgment: skip logging for trivial typo-only edits.
+Do not spam events for trivial edits, formatting-only changes, or temporary WIP. Prefer concise, fact-promotable statements.
+
+Example \`content.body\`: "MemoraOne Studio added a live dashboard summary, replacing the static dashboard placeholder with authenticated project and memory activity data."
 `;
 }
 function mcpJsonHeader() {
@@ -372,6 +424,7 @@ function parseSetupIdeFlags(argv) {
   let all = false;
   let force = false;
   let dryRun = false;
+  let noGitignore = false;
   const unknown = [];
   for (const a of argv) {
     if (a === "--cursor") cursor = true;
@@ -380,6 +433,7 @@ function parseSetupIdeFlags(argv) {
     else if (a === "--all") all = true;
     else if (a === "--force") force = true;
     else if (a === "--dry-run") dryRun = true;
+    else if (a === "--no-gitignore") noGitignore = true;
     else if (a.startsWith("-")) unknown.push(a);
   }
   const specific = cursor || vscode || jetbrains;
@@ -389,7 +443,7 @@ function parseSetupIdeFlags(argv) {
   } else {
     targets = { cursor, vscode, jetbrains };
   }
-  return { targets, force, dryRun, unknown };
+  return { targets, force, dryRun, noGitignore, unknown };
 }
 function summarizeOutcomes(outcomes) {
   const created = [];
@@ -422,6 +476,10 @@ async function runSetupIdeFiles(o) {
       error: "[setup-ide-files] No repo root found (looked for .git or memoraone.m1)."
     };
   }
+  outcomes[".gitignore"] = await ensureGitignoreMemoraone(repoRoot, {
+    dryRun: o.dryRun,
+    noGitignore: o.noGitignore ?? false
+  });
   const cursorContent = `---
 description: MemoraOne MCP \u2014 IDE agent instructions
 ---
@@ -458,7 +516,7 @@ description: MemoraOne MCP \u2014 IDE agent instructions
   return { exitCode: 0, repoRoot, outcomes };
 }
 async function cliSetupIdeFiles(argv) {
-  const { targets, force, dryRun, unknown } = parseSetupIdeFlags(argv);
+  const { targets, force, dryRun, noGitignore, unknown } = parseSetupIdeFlags(argv);
   if (unknown.length) {
     console.error(`[setup-ide-files] Unknown option(s): ${unknown.join(", ")}`);
     return 1;
@@ -467,7 +525,8 @@ async function cliSetupIdeFiles(argv) {
     cwd: process.cwd(),
     targets,
     force,
-    dryRun
+    dryRun,
+    noGitignore
   });
   if (result.error) {
     console.error(result.error);
@@ -492,7 +551,7 @@ if (args.includes("--version") || args.includes("-v")) {
 }
 if (args.includes("--help") || args.includes("-h")) {
   console.log(
-    "Usage: memoraone-mcp [--version] [--help] [--daemon --project-id <uuid>]\n       memoraone-mcp setup-ide-files [--all|--cursor|--vscode|--jetbrains] [--force] [--dry-run]"
+    "Usage: memoraone-mcp [--version] [--help] [--daemon --project-id <uuid>]\n       memoraone-mcp setup-ide-files [--all|--cursor|--vscode|--jetbrains] [--force] [--dry-run] [--no-gitignore]"
   );
   process.exit(0);
 }
@@ -558,8 +617,9 @@ if (args[0] === "setup-ide-files") {
     ensureBaseDir();
     const binding = await resolveBinding();
     const socketPath = getSocketPath(binding.projectId);
+    const environmentLog = binding.environment !== void 0 ? ` environment=${binding.environment}` : "";
     log(
-      `authoritative binding project=${binding.projectId} workspace=${binding.workspaceRoot} m1=${binding.m1Path} source=${binding.bindingSource} apiKeySource=${binding.apiKeySource}`
+      `authoritative binding project=${binding.projectId} workspace=${binding.workspaceRoot} m1=${binding.m1Path} source=${binding.bindingSource} apiKeySource=${binding.apiKeySource}${environmentLog}`
     );
     let socket;
     try {

package/dist/daemon.cjs

@@ -53,6 +53,13 @@ function ensureBaseDir() {
 var fs2 = __toESM(require("fs/promises"), 1);
 var path2 = __toESM(require("path"), 1);
 var uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function normalizeEnvironment(raw) {
+  if (raw === void 0 || raw === null || typeof raw !== "string") {
+    return void 0;
+  }
+  const trimmed = raw.trim();
+  return trimmed === "" ? void 0 : trimmed;
+}
 function parseAndValidateM1(content, markerPath) {
   let parsed2;
   try {
@@ -69,7 +76,8 @@ function parseAndValidateM1(content, markerPath) {
   }
   const apiKeyRaw = parsed2?.MEMORAONE_API_KEY ?? parsed2?.api_key;
   const apiKey = apiKeyRaw !== void 0 && apiKeyRaw !== null && typeof apiKeyRaw === "string" && apiKeyRaw.trim() !== "" ? apiKeyRaw.trim() : null;
-  return { projectId: projectId.trim(), apiKey };
+  const environment = normalizeEnvironment(parsed2?.environment);
+  return environment === void 0 ? { projectId: projectId.trim(), apiKey } : { projectId: projectId.trim(), apiKey, environment };
 }
 async function resolveProjectIdFromExplicitM1Path() {
   const raw = process.env.MEMORAONE_M1_PATH;
@@ -79,8 +87,8 @@ async function resolveProjectIdFromExplicitM1Path() {
   const markerPath = path2.resolve(raw);
   try {
     const content = await fs2.readFile(markerPath, "utf8");
-    const { projectId, apiKey } = parseAndValidateM1(content, markerPath);
-    return { projectId, apiKey, foundAt: markerPath };
+    const { projectId, apiKey, environment } = parseAndValidateM1(content, markerPath);
+    return environment === void 0 ? { projectId, apiKey, foundAt: markerPath } : { projectId, apiKey, environment, foundAt: markerPath };
   } catch (err) {
     if (err?.code === "ENOENT") {
       return null;
@@ -94,9 +102,9 @@ async function findM1WalkingUp(workspaceRoot) {
     const markerPath = path2.join(current, "memoraone.m1");
     try {
       const content = await fs2.readFile(markerPath, "utf8");
-      const { projectId, apiKey } = parseAndValidateM1(content, markerPath);
+      const { projectId, apiKey, environment } = parseAndValidateM1(content, markerPath);
       const repoRoot = path2.dirname(markerPath);
-      return { projectId, apiKey, repoRoot, markerPath };
+      return environment === void 0 ? { projectId, apiKey, repoRoot, markerPath } : { projectId, apiKey, environment, repoRoot, markerPath };
     } catch (err) {
       if (err?.code !== "ENOENT") {
         throw err;
@@ -156,6 +164,7 @@ async function resolveAuthoritativeBinding(workspaceRoot) {
       workspaceRoot: path2.dirname(explicitBinding.foundAt),
       m1Path: explicitBinding.foundAt,
       apiKey: resolved.apiKey,
+      ...explicitBinding.environment !== void 0 ? { environment: explicitBinding.environment } : {},
       bindingSource: "explicit-m1-path",
       apiKeySource: resolved.apiKeySource
     };
@@ -173,6 +182,7 @@ async function resolveAuthoritativeBinding(workspaceRoot) {
         workspaceRoot: binding.repoRoot,
         m1Path: binding.markerPath,
         apiKey: resolved.apiKey,
+        ...binding.environment !== void 0 ? { environment: binding.environment } : {},
         bindingSource: "workspace-search",
         apiKeySource: resolved.apiKeySource
       };
@@ -194,6 +204,7 @@ function decodeResolvedBinding(value) {
   const workspaceRoot = parsed2?.workspaceRoot;
   const m1Path = parsed2?.m1Path;
   const apiKey = parsed2?.apiKey;
+  const environment = normalizeEnvironment(parsed2?.environment);
   const bindingSource = parsed2?.bindingSource;
   const apiKeySource = parsed2?.apiKeySource;
   if (!projectId || typeof projectId !== "string" || !uuidRegex.test(projectId.trim())) {
@@ -219,6 +230,7 @@ function decodeResolvedBinding(value) {
     workspaceRoot,
     m1Path,
     apiKey: typeof apiKey === "string" && apiKey.trim() !== "" ? apiKey.trim() : null,
+    ...environment !== void 0 ? { environment } : {},
     bindingSource,
     apiKeySource
   };
@@ -541,6 +553,7 @@ async function registerRepoSource(client, projectId, repoPath, ideType) {
 
 // src/tools/postEvent.ts
 var import_v42 = require("zod/v4");
+var postEventDescription = 'Append a durable project-change note to the MemoraOne timeline. Use after meaningful repository or project changes: decisions, fixes, new endpoints, schema changes, migrations, important wiring, or durable product behavior changes \u2014 not for trivial edits, formatting-only changes, or temporary WIP. Recommended shape: kind "note"; content.title (concise title); content.body (one durable, fact-promotable project-change statement); metadata.source (agent name, e.g. "cursor"); metadata.purpose "dev-log"; metadata.schema "v1".';
 var postEventShape = {
   kind: import_v42.z.string().min(1),
   actor: import_v42.z.object({
@@ -649,6 +662,9 @@ var setProjectShape = {
   projectId: import_v411.z.string().min(1).optional()
 };
 
+// src/tools/bindingStatus.ts
+var bindingStatusShape = {};
+
 // src/tools/handlers/postEvent.ts
 var import_v412 = require("zod/v4");
 var crypto3 = __toESM(require("crypto"), 1);
@@ -721,6 +737,32 @@ var postEventInputSchema = import_v412.z.object({
   content: import_v412.z.record(import_v412.z.string(), import_v412.z.any()),
   metadata: import_v412.z.record(import_v412.z.string(), import_v412.z.any()).optional()
 });
+function buildPostEventContentFields(content) {
+  if (typeof content.message === "string") {
+    return { message: content.message };
+  }
+  if (typeof content.text === "string") {
+    return { message: content.text };
+  }
+  const title = typeof content.title === "string" ? content.title : void 0;
+  const body = typeof content.body === "string" ? content.body : void 0;
+  if (title !== void 0 || body !== void 0) {
+    const message = body ?? title ?? "";
+    const structuredContent = {};
+    for (const [key, value] of Object.entries(content)) {
+      if (key === "message" || key === "text") continue;
+      structuredContent[key] = value;
+    }
+    const new_value = {
+      message,
+      ...title !== void 0 ? { title } : {},
+      ...body !== void 0 ? { body } : {},
+      content: structuredContent
+    };
+    return { message, new_value };
+  }
+  return { message: JSON.stringify(content) };
+}
 async function handlePostEvent(client, args) {
   const nonce = crypto3.randomBytes(8).toString("hex");
   console.error(
@@ -732,7 +774,7 @@ async function handlePostEvent(client, args) {
     throw new Error("No project selected. Use memora_list_projects and memora_set_project to select a project.");
   }
   const content = parsed2.content ?? {};
-  const message = typeof content.message === "string" ? content.message : typeof content.text === "string" ? content.text : JSON.stringify(content);
+  const { message, new_value } = buildPostEventContentFields(content);
   const body = {
     kind: parsed2.kind,
     message,
@@ -742,6 +784,7 @@ async function handlePostEvent(client, args) {
       identifier: config2.agentName,
       ...parsed2.actor.id ? { id: parsed2.actor.id } : {}
     },
+    ...new_value ? { new_value } : {},
     ...parsed2.metadata ? { metadata: parsed2.metadata } : {}
   };
   try {
@@ -926,7 +969,8 @@ async function handleAskWithMemory(client, args) {
   }
   return {
     answer: res.answer,
-    used: res.used ?? {}
+    used: res.used ?? {},
+    ...res.retrieval !== void 0 ? { retrieval: res.retrieval } : {}
   };
 }
 
@@ -1471,6 +1515,27 @@ async function handleSetProject(args) {
   return { ok: true, projectKey: resolvedProjectKey };
 }
 
+// src/tools/handlers/bindingStatus.ts
+function buildBindingStatus(binding) {
+  const status = {
+    projectId: binding.projectId,
+    workspaceRoot: binding.workspaceRoot,
+    m1Path: binding.m1Path,
+    bindingSource: binding.bindingSource,
+    apiKeySource: binding.apiKeySource
+  };
+  if (binding.environment !== void 0) {
+    status.environment = binding.environment;
+  }
+  return status;
+}
+function handleBindingStatus(binding) {
+  if (!binding) {
+    throw new Error("[memoraone-mcp] Binding status unavailable (not initialized)");
+  }
+  return buildBindingStatus(binding);
+}
+
 // src/index.ts
 var notInitializedResult = {
   content: [
@@ -1654,6 +1719,7 @@ async function main(opts = {}) {
     projectId: null,
     apiKeySource: null,
     apiKeyFingerprint: null,
+    authoritativeBinding: opts.authoritativeBinding ?? null,
     ideType: void 0
   };
   let workspaceRoot;
@@ -1703,7 +1769,7 @@ async function main(opts = {}) {
   const registeredToolNames = [];
   server.tool(
     "memora_post_event",
-    "Forward an event to MemoraOne timeline",
+    postEventDescription,
     postEventShape,
     async (args) => runWithSessionContext(sessionContext, async () => {
       if (!runtime.client || !runtime.projectId) return notInitializedResult;
@@ -1779,6 +1845,19 @@ async function main(opts = {}) {
     })
   );
   registeredToolNames.push("memora_set_project");
+  server.tool(
+    "memora_status",
+    "Return non-secret project binding metadata for this MCP session",
+    bindingStatusShape,
+    async () => runWithSessionContext(sessionContext, async () => {
+      if (!runtime.authoritativeBinding) return notInitializedResult;
+      const result = handleBindingStatus(runtime.authoritativeBinding);
+      return {
+        content: [{ type: "text", text: JSON.stringify(result) }]
+      };
+    })
+  );
+  registeredToolNames.push("memora_status");
   registerToolWithWorklog(
     server,
     runtime,
@@ -1929,10 +2008,12 @@ async function main(opts = {}) {
         runtime.projectId = projectId;
         runtime.apiKeySource = binding.apiKeySource;
         runtime.apiKeyFingerprint = fingerprintApiKey(apiKeyToUse);
+        runtime.authoritativeBinding = binding;
         runtime.client = new memoraClient_default(config2, projectId, apiKeyToUse);
         workspaceRoot = binding.workspaceRoot;
+        const environmentLog = binding.environment !== void 0 ? ` environment=${binding.environment}` : "";
         process.stderr.write(
-          `[memoraone-mcp] registering workspace source bindingSource=${binding.bindingSource} workspaceRoot=${workspaceRoot ?? "(unset)"} m1Path=${binding.m1Path}
+          `[memoraone-mcp] registering workspace source bindingSource=${binding.bindingSource} workspaceRoot=${workspaceRoot ?? "(unset)"} m1Path=${binding.m1Path}${environmentLog}
 `
         );
         await registerRepoSource(
@@ -1946,8 +2027,9 @@ async function main(opts = {}) {
           console.error("[memoraone-mcp][auth] project_id:", projectId);
           console.error("[memoraone-mcp][auth] api_key source:", binding.apiKeySource);
         }
+        const bindingEnvironmentLog = binding.environment !== void 0 ? ` environment=${binding.environment}` : "";
         console.error(
-          `[memoraone-mcp] ${sessionLabel} authoritative binding: project=${binding.projectId} workspace=${binding.workspaceRoot} m1=${binding.m1Path} source=${binding.bindingSource} apiKeySource=${binding.apiKeySource}`
+          `[memoraone-mcp] ${sessionLabel} authoritative binding: project=${binding.projectId} workspace=${binding.workspaceRoot} m1=${binding.m1Path} source=${binding.bindingSource} apiKeySource=${binding.apiKeySource}${bindingEnvironmentLog}`
         );
         bindingReadyResolve?.(runtime.client);
         return server.server._oninitialize(request);

package/dist/index.cjs

@@ -281,6 +281,13 @@ var memoraClient_default = MemoraClient;
 var fs2 = __toESM(require("fs/promises"), 1);
 var path2 = __toESM(require("path"), 1);
 var uuidRegex2 = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function normalizeEnvironment(raw) {
+  if (raw === void 0 || raw === null || typeof raw !== "string") {
+    return void 0;
+  }
+  const trimmed = raw.trim();
+  return trimmed === "" ? void 0 : trimmed;
+}
 function parseAndValidateM1(content, markerPath) {
   let parsed2;
   try {
@@ -297,7 +304,8 @@ function parseAndValidateM1(content, markerPath) {
   }
   const apiKeyRaw = parsed2?.MEMORAONE_API_KEY ?? parsed2?.api_key;
   const apiKey = apiKeyRaw !== void 0 && apiKeyRaw !== null && typeof apiKeyRaw === "string" && apiKeyRaw.trim() !== "" ? apiKeyRaw.trim() : null;
-  return { projectId: projectId.trim(), apiKey };
+  const environment = normalizeEnvironment(parsed2?.environment);
+  return environment === void 0 ? { projectId: projectId.trim(), apiKey } : { projectId: projectId.trim(), apiKey, environment };
 }
 async function resolveProjectIdFromExplicitM1Path() {
   const raw = process.env.MEMORAONE_M1_PATH;
@@ -307,8 +315,8 @@ async function resolveProjectIdFromExplicitM1Path() {
   const markerPath = path2.resolve(raw);
   try {
     const content = await fs2.readFile(markerPath, "utf8");
-    const { projectId, apiKey } = parseAndValidateM1(content, markerPath);
-    return { projectId, apiKey, foundAt: markerPath };
+    const { projectId, apiKey, environment } = parseAndValidateM1(content, markerPath);
+    return environment === void 0 ? { projectId, apiKey, foundAt: markerPath } : { projectId, apiKey, environment, foundAt: markerPath };
   } catch (err) {
     if (err?.code === "ENOENT") {
       return null;
@@ -322,9 +330,9 @@ async function findM1WalkingUp(workspaceRoot) {
     const markerPath = path2.join(current, "memoraone.m1");
     try {
       const content = await fs2.readFile(markerPath, "utf8");
-      const { projectId, apiKey } = parseAndValidateM1(content, markerPath);
+      const { projectId, apiKey, environment } = parseAndValidateM1(content, markerPath);
       const repoRoot = path2.dirname(markerPath);
-      return { projectId, apiKey, repoRoot, markerPath };
+      return environment === void 0 ? { projectId, apiKey, repoRoot, markerPath } : { projectId, apiKey, environment, repoRoot, markerPath };
     } catch (err) {
       if (err?.code !== "ENOENT") {
         throw err;
@@ -384,6 +392,7 @@ async function resolveAuthoritativeBinding(workspaceRoot) {
       workspaceRoot: path2.dirname(explicitBinding.foundAt),
       m1Path: explicitBinding.foundAt,
       apiKey: resolved.apiKey,
+      ...explicitBinding.environment !== void 0 ? { environment: explicitBinding.environment } : {},
       bindingSource: "explicit-m1-path",
       apiKeySource: resolved.apiKeySource
     };
@@ -401,6 +410,7 @@ async function resolveAuthoritativeBinding(workspaceRoot) {
         workspaceRoot: binding.repoRoot,
         m1Path: binding.markerPath,
         apiKey: resolved.apiKey,
+        ...binding.environment !== void 0 ? { environment: binding.environment } : {},
         bindingSource: "workspace-search",
         apiKeySource: resolved.apiKeySource
       };
@@ -481,6 +491,7 @@ async function registerRepoSource(client, projectId, repoPath, ideType) {
 
 // src/tools/postEvent.ts
 var import_v42 = require("zod/v4");
+var postEventDescription = 'Append a durable project-change note to the MemoraOne timeline. Use after meaningful repository or project changes: decisions, fixes, new endpoints, schema changes, migrations, important wiring, or durable product behavior changes \u2014 not for trivial edits, formatting-only changes, or temporary WIP. Recommended shape: kind "note"; content.title (concise title); content.body (one durable, fact-promotable project-change statement); metadata.source (agent name, e.g. "cursor"); metadata.purpose "dev-log"; metadata.schema "v1".';
 var postEventShape = {
   kind: import_v42.z.string().min(1),
   actor: import_v42.z.object({
@@ -589,6 +600,9 @@ var setProjectShape = {
   projectId: import_v411.z.string().min(1).optional()
 };
 
+// src/tools/bindingStatus.ts
+var bindingStatusShape = {};
+
 // src/tools/handlers/postEvent.ts
 var import_v412 = require("zod/v4");
 var crypto3 = __toESM(require("crypto"), 1);
@@ -661,6 +675,32 @@ var postEventInputSchema = import_v412.z.object({
   content: import_v412.z.record(import_v412.z.string(), import_v412.z.any()),
   metadata: import_v412.z.record(import_v412.z.string(), import_v412.z.any()).optional()
 });
+function buildPostEventContentFields(content) {
+  if (typeof content.message === "string") {
+    return { message: content.message };
+  }
+  if (typeof content.text === "string") {
+    return { message: content.text };
+  }
+  const title = typeof content.title === "string" ? content.title : void 0;
+  const body = typeof content.body === "string" ? content.body : void 0;
+  if (title !== void 0 || body !== void 0) {
+    const message = body ?? title ?? "";
+    const structuredContent = {};
+    for (const [key, value] of Object.entries(content)) {
+      if (key === "message" || key === "text") continue;
+      structuredContent[key] = value;
+    }
+    const new_value = {
+      message,
+      ...title !== void 0 ? { title } : {},
+      ...body !== void 0 ? { body } : {},
+      content: structuredContent
+    };
+    return { message, new_value };
+  }
+  return { message: JSON.stringify(content) };
+}
 async function handlePostEvent(client, args) {
   const nonce = crypto3.randomBytes(8).toString("hex");
   console.error(
@@ -672,7 +712,7 @@ async function handlePostEvent(client, args) {
     throw new Error("No project selected. Use memora_list_projects and memora_set_project to select a project.");
   }
   const content = parsed2.content ?? {};
-  const message = typeof content.message === "string" ? content.message : typeof content.text === "string" ? content.text : JSON.stringify(content);
+  const { message, new_value } = buildPostEventContentFields(content);
   const body = {
     kind: parsed2.kind,
     message,
@@ -682,6 +722,7 @@ async function handlePostEvent(client, args) {
       identifier: config2.agentName,
       ...parsed2.actor.id ? { id: parsed2.actor.id } : {}
     },
+    ...new_value ? { new_value } : {},
     ...parsed2.metadata ? { metadata: parsed2.metadata } : {}
   };
   try {
@@ -866,7 +907,8 @@ async function handleAskWithMemory(client, args) {
   }
   return {
     answer: res.answer,
-    used: res.used ?? {}
+    used: res.used ?? {},
+    ...res.retrieval !== void 0 ? { retrieval: res.retrieval } : {}
   };
 }
 
@@ -1411,6 +1453,27 @@ async function handleSetProject(args) {
   return { ok: true, projectKey: resolvedProjectKey };
 }
 
+// src/tools/handlers/bindingStatus.ts
+function buildBindingStatus(binding) {
+  const status = {
+    projectId: binding.projectId,
+    workspaceRoot: binding.workspaceRoot,
+    m1Path: binding.m1Path,
+    bindingSource: binding.bindingSource,
+    apiKeySource: binding.apiKeySource
+  };
+  if (binding.environment !== void 0) {
+    status.environment = binding.environment;
+  }
+  return status;
+}
+function handleBindingStatus(binding) {
+  if (!binding) {
+    throw new Error("[memoraone-mcp] Binding status unavailable (not initialized)");
+  }
+  return buildBindingStatus(binding);
+}
+
 // src/index.ts
 var notInitializedResult = {
   content: [
@@ -1594,6 +1657,7 @@ async function main(opts = {}) {
     projectId: null,
     apiKeySource: null,
     apiKeyFingerprint: null,
+    authoritativeBinding: opts.authoritativeBinding ?? null,
     ideType: void 0
   };
   let workspaceRoot;
@@ -1643,7 +1707,7 @@ async function main(opts = {}) {
   const registeredToolNames = [];
   server.tool(
     "memora_post_event",
-    "Forward an event to MemoraOne timeline",
+    postEventDescription,
     postEventShape,
     async (args) => runWithSessionContext(sessionContext, async () => {
       if (!runtime.client || !runtime.projectId) return notInitializedResult;
@@ -1719,6 +1783,19 @@ async function main(opts = {}) {
     })
   );
   registeredToolNames.push("memora_set_project");
+  server.tool(
+    "memora_status",
+    "Return non-secret project binding metadata for this MCP session",
+    bindingStatusShape,
+    async () => runWithSessionContext(sessionContext, async () => {
+      if (!runtime.authoritativeBinding) return notInitializedResult;
+      const result = handleBindingStatus(runtime.authoritativeBinding);
+      return {
+        content: [{ type: "text", text: JSON.stringify(result) }]
+      };
+    })
+  );
+  registeredToolNames.push("memora_status");
   registerToolWithWorklog(
     server,
     runtime,
@@ -1869,10 +1946,12 @@ async function main(opts = {}) {
         runtime.projectId = projectId;
         runtime.apiKeySource = binding.apiKeySource;
         runtime.apiKeyFingerprint = fingerprintApiKey(apiKeyToUse);
+        runtime.authoritativeBinding = binding;
         runtime.client = new memoraClient_default(config2, projectId, apiKeyToUse);
         workspaceRoot = binding.workspaceRoot;
+        const environmentLog = binding.environment !== void 0 ? ` environment=${binding.environment}` : "";
         process.stderr.write(
-          `[memoraone-mcp] registering workspace source bindingSource=${binding.bindingSource} workspaceRoot=${workspaceRoot ?? "(unset)"} m1Path=${binding.m1Path}
+          `[memoraone-mcp] registering workspace source bindingSource=${binding.bindingSource} workspaceRoot=${workspaceRoot ?? "(unset)"} m1Path=${binding.m1Path}${environmentLog}
 `
         );
         await registerRepoSource(
@@ -1886,8 +1965,9 @@ async function main(opts = {}) {
           console.error("[memoraone-mcp][auth] project_id:", projectId);
           console.error("[memoraone-mcp][auth] api_key source:", binding.apiKeySource);
         }
+        const bindingEnvironmentLog = binding.environment !== void 0 ? ` environment=${binding.environment}` : "";
         console.error(
-          `[memoraone-mcp] ${sessionLabel} authoritative binding: project=${binding.projectId} workspace=${binding.workspaceRoot} m1=${binding.m1Path} source=${binding.bindingSource} apiKeySource=${binding.apiKeySource}`
+          `[memoraone-mcp] ${sessionLabel} authoritative binding: project=${binding.projectId} workspace=${binding.workspaceRoot} m1=${binding.m1Path} source=${binding.bindingSource} apiKeySource=${binding.apiKeySource}${bindingEnvironmentLog}`
         );
         bindingReadyResolve?.(runtime.client);
         return server.server._oninitialize(request);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memoraone/mcp",
-  "version": "0.1.20",
+  "version": "0.1.22",
   "type": "module",
   "main": "dist/index.cjs",
   "bin": {
@@ -13,15 +13,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "build": "tsup && node scripts/writeBinWrapper.cjs",
-    "prepublishOnly": "pnpm run build",
-    "dev": "tsx src/cli.ts",
-    "lint": "eslint .",
-    "lint:contracts": "node scripts/lint-contracts.cjs",
-    "test": "pnpm run lint:contracts && node --import=tsx --test test/*.test.js",
-    "validate:auth": "node --import=tsx --test test/memoraClient.test.js"
-  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.1",
     "dotenv": "^16.4.5",
@@ -31,5 +22,13 @@
     "tsx": "^4.21.0",
     "tsup": "^8.5.1",
     "typescript": "^5.9.2"
+  },
+  "scripts": {
+    "build": "tsup && node scripts/writeBinWrapper.cjs",
+    "dev": "tsx src/cli.ts",
+    "lint": "eslint .",
+    "lint:contracts": "node scripts/lint-contracts.cjs",
+    "test": "pnpm run lint:contracts && node --import=tsx --test test/*.test.js",
+    "validate:auth": "node --import=tsx --test test/memoraClient.test.js"
   }
-}
+}