@repomem/memory 0.1.6 → 0.1.8

package/README.md

@@ -6,7 +6,7 @@
 > CLI command: `repomem-memory`.
 
 `@repomem/memory` is a local [Model Context Protocol](https://modelcontextprotocol.io)
-(MCP) server that turns a `memory/` folder in your repository into searchable,
+(MCP) server that turns a `.repomem/memory/` folder in your repository into searchable,
 shared context for AI assistants. Decisions, conventions, limitations,
 learnings and project context live as reviewable markdown files with structured
 frontmatter, versioned with git and shared through normal pull requests. AI
@@ -32,7 +32,7 @@ Design principles:
 
 ## Quick start
 
-Scaffold a `memory/` folder in your repo (no install needed, `npx` fetches it):
+Scaffold the `.repomem/memory/` folder in your repo (no install needed, `npx` fetches it):
 
 ```bash
 npx --package @repomem/memory repomem-memory init
@@ -53,9 +53,28 @@ npx --package @repomem/memory repomem-memory validate
 
 `validate` exits non-zero on any problem, so it fits in a pre-commit hook or CI.
 
+## Getting agents to actually use it
+
+An agent only benefits from memory if it consults it. repomem reinforces the
+protocol at three levels, so it also works with a generic agent that never
+loaded the repomem agent config:
+
+1. **MCP `instructions`** — on `initialize` the server sends a short protocol
+   to the client: call `memory_for_path` for each file and `search_memory` per
+   concept *before* editing, then `propose_memory` (drafts only) and validate
+   when done. Clients that surface server instructions put this in the model's
+   context. Not every client does; check yours.
+2. **Tool descriptions** — each tool says *when* to call it ("call this BEFORE
+   you modify a file"), because descriptions are shown to the model by every
+   MCP client.
+3. **Skills** (`repomem setup`) — the longer `repomem-memory` and
+   `repomem-distill` playbooks, installed under `.kiro/skills/`.
+
+This is guidance, not enforcement: nothing forces a model to call a tool.
+
 ## Entry format
 
-Entries live at `memory/<type>s/<slug>.md`. The `id` of an entry is its file
+Entries live at `.repomem/memory/<type>s/<slug>.md`. The `id` of an entry is its file
 slug. Each file starts with YAML frontmatter:
 
 ```markdown
@@ -181,7 +200,7 @@ runs in. To point at a specific folder, add `"--root", "/path/to/memory"` to
 
 ```bash
 repomem-memory serve [--root <dir>]      # start the MCP server over stdio (what agents invoke)
-repomem-memory init [--root <dir>]       # scaffold memory/ with templates and a README
+repomem-memory init [--root <dir>]       # scaffold .repomem/memory/ with templates and a README
 repomem-memory validate [--root <dir>]   # validate frontmatter, supersedes refs, and scan for secrets
 repomem-memory setup --agent kiro        # install skills, hooks and MCP config for an agent
 ```

package/assets/kiro/skills/repomem-distill/SKILL.md

@@ -1,56 +1,64 @@
 ---
 name: repomem-distill
-description: How to distill a finished piece of work into durable repomem entries. Use as the FINAL STEP after executing a plan or completing a substantial task — review what the session produced and propose the decisions, learnings, limitations, and context worth keeping for next time.
+description: Final step after executing a plan or completing a substantial task. Review what the session produced and propose the decisions, learnings, limitations and context worth keeping, then validate them. Do not skip it because the task "felt small": decide explicitly whether anything durable came out of it.
 ---
 
 # repomem — distilling a session into memory
 
-When you finish executing a plan or a substantial task, the valuable knowledge
-lives only in this session: why you chose an approach, what surprised you, what
-constraints you hit. Once the session ends, it is gone unless you write it down.
-This skill is the final step of a plan: turn that knowledge into a small number
-of durable `repomem` entries.
+When you finish a plan or a substantial task, the valuable knowledge lives only
+in this session: why you chose an approach, what surprised you, what
+constraints you hit. Once the session ends it is gone unless you write it down.
 
-This is NOT about saving the plan. Do not persist the step-by-step plan, task
-lists, progress logs, or any other ephemeral session state — that noise does not
-belong in memory and the agent's own session already holds it. Distill only
+This is NOT about saving the plan. Do not persist step-by-step plans, task
+lists, progress logs or any other ephemeral session state. Distill only
 knowledge that will still matter weeks from now.
 
-## When to run it
+## Checklist (run in this order)
 
-- As the explicit final step after completing a plan or a non-trivial task.
-- When the user asks you to "record" or "distill" what was done.
+1. **Recall what already exists.** Call `search_memory` for each topic you are
+   about to write, and `memory_for_path` on the main files you changed. You are
+   looking for duplicates to extend and entries your work made false.
+2. **Decide what is durable.** For each candidate ask: would a teammate who was
+   not here make a worse decision without it?
+   - **decision** — a non-obvious choice and the reasoning, including the
+     alternative you rejected.
+   - **learning** — something that surprised you or cost time.
+   - **limitation** — a constraint or gotcha, including things you could NOT
+     verify (for example "only tested on SQLite").
+   - **context** — newly worth-writing-down understanding of what a thing is
+     and how it fits.
+   - **convention** — a rule future changes must follow (for example "every use
+     case that mutates X must call Y"), ideally with the test that enforces it.
 
-## What to distill
+   If nothing qualifies, propose nothing. A clean "no entries needed" is a
+   valid outcome; do not invent memory.
+3. **Propose.** One `propose_memory` call per item, with a conclusion-style
+   `title`, the right `type`, `tags`, and `related_paths` globs that a later
+   `memory_for_path` would hit (the main source file AND the test or doc a
+   maintainer would be editing). There is no `scope` parameter: module scope is
+   expressed through `related_paths` and `tags`.
+4. **Supersede, don't contradict.** If your work replaces an earlier decision,
+   pass `supersedes` on the new entry. Call `deprecate_memory` when no
+   replacement is needed.
+5. **Refresh the map.** If the `repomem-map-structure` skill is available,
+   follow "Keeping summaries fresh" there for the files you created or changed.
+6. **Validate.** Run `npx --package @repomem/memory repomem-memory validate` and
+   fix what it reports. If you cannot run it, say so explicitly.
+7. **Report.** In the final message list the entries you proposed (ids), say
+   they are drafts for human review, and mention validation status. Never mark
+   an entry `accepted` yourself.
 
-Review the session and identify, if any:
+## Tools used
 
-- **decisions** — non-obvious choices and the reasoning behind them.
-- **learnings** — things that surprised you or cost time, worth remembering.
-- **limitations** — new constraints or gotchas you discovered.
-- **context** — project or module-level understanding that changed or is newly
-  worth writing down (what a thing is, why it exists, how it fits together).
-
-If nothing durable came out of the work, propose nothing. A clean "no entries
-needed" is a valid outcome — do not invent memory.
-
-## How to do it
-
-1. Reflect on what the session actually accomplished and changed.
-2. For each durable item, call `propose_memory` once, with:
-   - a clear, specific `title`,
-   - the right `type` (decision / convention / limitation / learning / context),
-   - meaningful `related_paths` so `memory_for_path` can surface it later,
-   - a `scope`: `project` for repo-wide knowledge, or a module name
-     (e.g. `db`, `auth`, `frontend`) for module-specific knowledge.
-3. Keep each entry focused: one decision/learning/limitation/context per file.
-4. **Never** mark an entry `accepted` yourself. Every entry is a `draft` for a
-   human to review and accept in the same pull request as the code.
-5. Remind the user to run `npx --package @repomem/memory repomem-memory validate` before committing.
+- `search_memory(query, type?, tags?)`, `memory_for_path(path)` — recall.
+- `propose_memory(type, title, body, tags?, related_paths?, supersedes?)` —
+  always creates a draft.
+- `deprecate_memory(id, reason, superseded_by?)` — retire an entry without a
+  replacement.
 
 ## Guidelines
 
 - Prefer a few high-signal entries over many shallow ones.
-- Write for a teammate (human or AI) who was not in this session.
-- Reuse existing entries by proposing a `supersedes` reference when a decision
-  replaces an earlier one, rather than silently contradicting it.
+- Write for someone who was not in this session; no "as discussed above".
+- Record unverified assumptions as limitations rather than leaving them only in
+  the chat summary.

package/assets/kiro/skills/repomem-memory/SKILL.md

@@ -1,41 +1,73 @@
 ---
 name: repomem-memory
-description: How to use the repomem MCP server to record and recall a repository's shared memory — decisions, conventions, limitations, and learnings. Use when you make a non-obvious choice worth remembering, when you need prior context before changing code, or when the user asks what the team already decided.
+description: Mandatory protocol for the repository's shared memory (decisions, conventions, limitations, learnings, context). Use at the START of every task that will modify files, however familiar the code feels, and again before finishing. Also use when the user asks "why is it this way?" or what the team already decided.
 ---
 
 # repomem — the repository's shared memory
 
-repomem turns a `memory/` folder into searchable, git-versioned context served
+repomem turns `.repomem/memory/` into searchable, git-versioned context served
 over MCP. Entries are markdown files with structured frontmatter, grouped by
-type: `decisions/`, `conventions/`, `limitations/`, `learnings/`.
+type: `decisions/`, `conventions/`, `limitations/`, `learnings/`, `contexts/`.
 
-## When to use it
+Project docs tell you what the project is meant to be; memory tells you what the
+team decided and what bit them. Having read the docs is NOT a reason to skip
+this protocol.
 
-- **Before changing unfamiliar code**: search memory for related decisions and
-  limitations so you don't contradict an earlier choice.
-- **After making a non-obvious decision**: propose a new entry so the rationale
-  survives beyond the current conversation.
-- **When the user asks "why is it this way?"**: look it up instead of guessing.
+## Protocol
+
+**Before editing** (any task that changes files, however familiar the code feels):
+
+1. Call `memory_for_path` once for each file you are about to modify (or its
+   directory's main file). It matches entries by their `related_paths` globs.
+2. Call `search_memory` with the one to three main concepts of the task. One
+   search per concept, not one search for the whole task.
+3. Call `get_memory` for anything relevant. If an entry contradicts your plan,
+   surface it to the user before coding; do not silently override it.
+
+An empty result is a valid answer: say so in one line and move on. Do not treat
+it as "memory does not apply to this repo"; the repo may simply be young.
+
+**While working**: when you make a non-obvious choice (you picked A over B for a
+reason a teammate could not guess), note it for the end-of-task distill.
+
+**After finishing**: follow `repomem-distill` (propose entries, then validate).
 
 ## The propose-then-review workflow
 
 AI tools **propose** entries as drafts (`status: draft`). A human reviews and
 **accepts** them in the same pull request as the related change. Never mark an
-entry `accepted` yourself — leave it as a draft for review.
+entry `accepted` yourself.
 
 ## Tools
 
-- `search_memory` — full-text search across all entries. Start here.
-- `get_memory` — fetch a specific entry by slug.
-- `memory_for_path` — find entries whose `related_paths` match a file you are
-  about to touch.
-- Write tools propose new draft entries; prefer small, specific entries with a
-  clear title and `related_paths`.
+- `search_memory(query, type?, tags?)` — full-text search. Deprecated entries
+  are excluded by default.
+- `get_memory(id)` — full entry by slug (the `id` returned by search).
+- `memory_for_path(path)` — entries whose `related_paths` match a
+  repository-relative file path; accepted entries rank above drafts.
+- `propose_memory(type, title, body, tags?, related_paths?, supersedes?)` —
+  creates a DRAFT. Rejects a title whose id already exists for that type and
+  never overwrites. There is no `scope` parameter: express module scope with
+  `related_paths` and `tags`.
+- `deprecate_memory(id, reason, superseded_by?)` — mark an entry obsolete. Use
+  it (or `supersedes` on the replacement) when your work makes an earlier entry
+  false; do not leave contradicting entries live.
+
+## Writing good entries
+
+- One decision, convention, limitation, learning or context per entry.
+- The title states the conclusion ("X is recorded at write time, not
+  reconstructed"), not the topic ("About X").
+- Always set `related_paths` with globs that a future `memory_for_path` call
+  would actually hit: include the main source file AND the test or doc a
+  maintainer would be editing when they need this entry.
+- Body: what, why (the rejected alternative and why), and what to do when you
+  touch it. Write for someone who was not in this session.
+- Before proposing, `search_memory` for the same topic; extend or supersede an
+  existing entry instead of adding a near-duplicate.
 
-## Guidelines
+## Before committing
 
-- Keep entries focused: one decision/convention/limitation/learning per file.
-- Always set meaningful `related_paths` so `memory_for_path` can surface the
-  entry later.
-- Run `npx --package @repomem/memory repomem-memory validate` before committing — it checks frontmatter, supersedes
-  references, and scans for secrets.
+Run `npx --package @repomem/memory repomem-memory validate`. It checks
+frontmatter and `supersedes` references, and scans for secrets. Tell the user if
+you could not run it.

package/dist/index.js

@@ -9,7 +9,7 @@ import { realpathSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { resolveMemoryRoot } from "./store.js";
 import { MemoryIndex } from "./search.js";
-import { registerAllTools, SERVER_INFO } from "./server.js";
+import { registerAllTools, SERVER_INFO, SERVER_OPTIONS } from "./server.js";
 function log(message) {
     process.stderr.write(`[repomem-memory] ${message}\n`);
 }
@@ -24,7 +24,7 @@ export async function main(argv = process.argv.slice(2)) {
     const root = resolveMemoryRoot({ rootFlag: parseRootFlag(argv) });
     log(`memory root: ${root}`);
     const index = new MemoryIndex(root);
-    const server = new McpServer(SERVER_INFO);
+    const server = new McpServer(SERVER_INFO, SERVER_OPTIONS);
     registerAllTools(server, root, index);
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE5D,SAAS,GAAG,CAAC,OAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,OAAO,IAAI,CAAC,CAAC;AACxD,CAAC;AAED,kDAAkD;AAClD,SAAS,aAAa,CAAC,IAAc;IACnC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACxD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,OAAiB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,iBAAiB,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClE,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC;IAE5B,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,WAAW,CAAC,CAAC;IAC1C,gBAAgB,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAEtC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,GAAG,CAAC,uBAAuB,CAAC,CAAC;AAC/B,CAAC;AAED,4EAA4E;AAC5E,yEAAyE;AACzE,0EAA0E;AAC1E,SAAS,iBAAiB;IACxB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAChD,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACxF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,IAAI,iBAAiB,EAAE,EAAE,CAAC;IACxB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QAC5B,GAAG,CAAC,UAAW,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE5E,SAAS,GAAG,CAAC,OAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,OAAO,IAAI,CAAC,CAAC;AACxD,CAAC;AAED,kDAAkD;AAClD,SAAS,aAAa,CAAC,IAAc;IACnC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACxD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,OAAiB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,iBAAiB,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClE,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC;IAE5B,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAC1D,gBAAgB,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAEtC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,GAAG,CAAC,uBAAuB,CAAC,CAAC;AAC/B,CAAC;AAED,4EAA4E;AAC5E,yEAAyE;AACzE,0EAA0E;AAC1E,SAAS,iBAAiB;IACxB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAChD,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACxF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,IAAI,iBAAiB,EAAE,EAAE,CAAC;IACxB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QAC5B,GAAG,CAAC,UAAW,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/instructions.d.ts

@@ -0,0 +1,16 @@
+/**
+ * instructions.ts — the protocol text sent to every MCP client on `initialize`.
+ *
+ * Clients that surface server `instructions` put this in the model's context,
+ * so even a generic agent (one that never loaded the repomem skills, hooks or
+ * agent config) is told when to call the memory tools. It is deliberately short
+ * and imperative; the longer rationale lives in the `repomem-memory` and
+ * `repomem-distill` skills, which must stay consistent with this text.
+ *
+ * Every tool name mentioned here is checked against the registered tools in
+ * test/instructions.test.ts, so the text cannot drift from the real API.
+ */
+/** The exact command to validate entries. Always scoped: never an unscoped `npx repomem`. */
+export declare const VALIDATE_COMMAND = "npx --package @repomem/memory repomem-memory validate";
+export declare const MEMORY_INSTRUCTIONS = "repomem-memory is this repository's shared memory (decisions, conventions, limitations, learnings, context), stored as git-versioned markdown in .repomem/memory/. Follow this protocol on every task that changes files.\n\nBEFORE editing:\n1. Call memory_for_path once for each file you are about to modify.\n2. Call search_memory once per main concept of the task (not one search for the whole task).\n3. Call get_memory for anything relevant. If an entry contradicts your plan, tell the user before coding; do not silently override it.\nAn empty result is a valid answer: say so in one line and continue. It does not mean memory is irrelevant to this repo.\n\nWHILE working: note any non-obvious choice (you picked A over B for a reason a teammate could not guess).\n\nAFTER finishing:\n1. Decide explicitly whether anything durable came out of the work (a decision with its rejected alternative, a surprise, a constraint, something you could not verify). If nothing, propose nothing.\n2. Call propose_memory once per item. Entries are always created as drafts for human review; never mark one accepted. Set related_paths to globs that include the main source file AND its test or doc. There is no scope parameter: express module scope with related_paths and tags.\n3. If your work makes an earlier entry false, pass supersedes on the new entry, or call deprecate_memory. Do not leave contradicting entries live.\n4. Run `npx --package @repomem/memory repomem-memory validate` and fix what it reports. If you cannot run it, say so.\n";
+//# sourceMappingURL=instructions.d.ts.map

package/dist/instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../src/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,6FAA6F;AAC7F,eAAO,MAAM,gBAAgB,0DAA0D,CAAC;AAExF,eAAO,MAAM,mBAAmB,kgDAgB/B,CAAC"}

package/dist/instructions.js

@@ -0,0 +1,32 @@
+/**
+ * instructions.ts — the protocol text sent to every MCP client on `initialize`.
+ *
+ * Clients that surface server `instructions` put this in the model's context,
+ * so even a generic agent (one that never loaded the repomem skills, hooks or
+ * agent config) is told when to call the memory tools. It is deliberately short
+ * and imperative; the longer rationale lives in the `repomem-memory` and
+ * `repomem-distill` skills, which must stay consistent with this text.
+ *
+ * Every tool name mentioned here is checked against the registered tools in
+ * test/instructions.test.ts, so the text cannot drift from the real API.
+ */
+/** The exact command to validate entries. Always scoped: never an unscoped `npx repomem`. */
+export const VALIDATE_COMMAND = "npx --package @repomem/memory repomem-memory validate";
+export const MEMORY_INSTRUCTIONS = `\
+repomem-memory is this repository's shared memory (decisions, conventions, limitations, learnings, context), stored as git-versioned markdown in .repomem/memory/. Follow this protocol on every task that changes files.
+
+BEFORE editing:
+1. Call memory_for_path once for each file you are about to modify.
+2. Call search_memory once per main concept of the task (not one search for the whole task).
+3. Call get_memory for anything relevant. If an entry contradicts your plan, tell the user before coding; do not silently override it.
+An empty result is a valid answer: say so in one line and continue. It does not mean memory is irrelevant to this repo.
+
+WHILE working: note any non-obvious choice (you picked A over B for a reason a teammate could not guess).
+
+AFTER finishing:
+1. Decide explicitly whether anything durable came out of the work (a decision with its rejected alternative, a surprise, a constraint, something you could not verify). If nothing, propose nothing.
+2. Call propose_memory once per item. Entries are always created as drafts for human review; never mark one accepted. Set related_paths to globs that include the main source file AND its test or doc. There is no scope parameter: express module scope with related_paths and tags.
+3. If your work makes an earlier entry false, pass supersedes on the new entry, or call deprecate_memory. Do not leave contradicting entries live.
+4. Run \`${VALIDATE_COMMAND}\` and fix what it reports. If you cannot run it, say so.
+`;
+//# sourceMappingURL=instructions.js.map

package/dist/instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../src/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,6FAA6F;AAC7F,MAAM,CAAC,MAAM,gBAAgB,GAAG,uDAAuD,CAAC;AAExF,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;WAexB,gBAAgB;CAC1B,CAAC"}

package/dist/server.d.ts

@@ -12,7 +12,15 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { MemoryIndex } from "./search.js";
 export declare const SERVER_INFO: {
     readonly name: "repomem-memory";
-    readonly version: "0.1.0";
+    readonly version: string;
+};
+/**
+ * Options for `new McpServer(SERVER_INFO, SERVER_OPTIONS)`. `instructions` is
+ * delivered on `initialize` so any MCP client can put the protocol in the
+ * model's context without loading skills, hooks or a custom agent.
+ */
+export declare const SERVER_OPTIONS: {
+    readonly instructions: "repomem-memory is this repository's shared memory (decisions, conventions, limitations, learnings, context), stored as git-versioned markdown in .repomem/memory/. Follow this protocol on every task that changes files.\n\nBEFORE editing:\n1. Call memory_for_path once for each file you are about to modify.\n2. Call search_memory once per main concept of the task (not one search for the whole task).\n3. Call get_memory for anything relevant. If an entry contradicts your plan, tell the user before coding; do not silently override it.\nAn empty result is a valid answer: say so in one line and continue. It does not mean memory is irrelevant to this repo.\n\nWHILE working: note any non-obvious choice (you picked A over B for a reason a teammate could not guess).\n\nAFTER finishing:\n1. Decide explicitly whether anything durable came out of the work (a decision with its rejected alternative, a surprise, a constraint, something you could not verify). If nothing, propose nothing.\n2. Call propose_memory once per item. Entries are always created as drafts for human review; never mark one accepted. Set related_paths to globs that include the main source file AND its test or doc. There is no scope parameter: express module scope with related_paths and tags.\n3. If your work makes an earlier entry false, pass supersedes on the new entry, or call deprecate_memory. Do not leave contradicting entries live.\n4. Run `npx --package @repomem/memory repomem-memory validate` and fix what it reports. If you cannot run it, say so.\n";
 };
 /** Register the read-only memory tools, backed by `index`. */
 export declare function registerReadTools(server: McpServer, index: MemoryIndex): void;

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AA8B/C,eAAO,MAAM,WAAW;;;CAGd,CAAC;AAEX,8DAA8D;AAC9D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAgD7E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,WAAW,GACjB,IAAI,CAoGN;AAED,yCAAyC;AACzC,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,WAAW,GACjB,IAAI,CAGN"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AA+C/C,eAAO,MAAM,WAAW;;;CAGd,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,cAAc;;CAEjB,CAAC;AAEX,8DAA8D;AAC9D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAmD7E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,WAAW,GACjB,IAAI,CA6GN;AAED,yCAAyC;AACzC,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,WAAW,GACjB,IAAI,CAGN"}

package/dist/server.js

@@ -9,8 +9,10 @@
  * Never writes to stdout — diagnostics go to stderr only.
  */
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { readFileSync } from "node:fs";
 import * as z from "zod";
 import { entryTypeSchema } from "./schema.js";
+import { MEMORY_INSTRUCTIONS } from "./instructions.js";
 import { proposeEntry, deprecateEntry, entriesForPath, } from "./store.js";
 function jsonResult(payload) {
     return {
@@ -32,15 +34,42 @@ function summarize(entry) {
         status: entry.frontmatter.status,
     };
 }
+/**
+ * Version of this package, read from its `package.json` so the version a client
+ * sees on `initialize` is the one actually running. `src/` and `dist/` both sit
+ * one level below the package root. Falls back to "unknown" rather than failing
+ * the server if the file cannot be read.
+ */
+function packageVersion() {
+    try {
+        const raw = readFileSync(new URL("../package.json", import.meta.url), "utf8");
+        const { version } = JSON.parse(raw);
+        return typeof version === "string" ? version : "unknown";
+    }
+    catch {
+        return "unknown";
+    }
+}
 export const SERVER_INFO = {
     name: "repomem-memory",
-    version: "0.1.0",
+    version: packageVersion(),
+};
+/**
+ * Options for `new McpServer(SERVER_INFO, SERVER_OPTIONS)`. `instructions` is
+ * delivered on `initialize` so any MCP client can put the protocol in the
+ * model's context without loading skills, hooks or a custom agent.
+ */
+export const SERVER_OPTIONS = {
+    instructions: MEMORY_INSTRUCTIONS,
 };
 /** Register the read-only memory tools, backed by `index`. */
 export function registerReadTools(server, index) {
     server.registerTool("search_memory", {
         title: "Search memory",
         description: "Search the repository's memory for decisions, conventions, limitations, learnings and context. " +
+            "Call this BEFORE starting any task that changes files: once per main concept of the task " +
+            "(e.g. one search for \"retry policy\", another for \"auth\"), not one search for the whole task. " +
+            "An empty result is a valid answer, not a reason to skip memory. " +
             "Returns short summaries (id, type, title, status, snippet). Deprecated entries are " +
             "excluded by default. Use get_memory with an id to read the full entry.",
         inputSchema: {
@@ -86,6 +115,9 @@ export function registerWriteTools(server, root, index) {
     server.registerTool("memory_for_path", {
         title: "Memory for a path",
         description: "Return memory entries whose related_paths globs match the given file path. " +
+            "Call this BEFORE you modify a file, once for each file you are about to change, " +
+            "even if the code feels familiar: it surfaces decisions and limitations that bind that file. " +
+            "If an entry contradicts your plan, tell the user before coding. " +
             "Accepted entries are prioritized over drafts; deprecated entries are excluded.",
         inputSchema: {
             path: z
@@ -109,9 +141,13 @@ export function registerWriteTools(server, root, index) {
     });
     server.registerTool("propose_memory", {
         title: "Propose a memory entry",
-        description: "Propose a new memory entry. It is ALWAYS created as a draft for a human to review " +
-            "and accept in a pull request. Rejects duplicates (a title whose id already exists " +
-            "for that type). Never overwrites existing entries.",
+        description: "Propose a new memory entry. Call this AFTER you finish a task, once per durable item " +
+            "(a non-obvious decision and the alternative you rejected, a surprise, a constraint, " +
+            "something you could not verify); propose nothing if nothing durable came out of the work. " +
+            "Do not store plans or progress logs. It is ALWAYS created as a draft for a human to review " +
+            "and accept in a pull request; never mark an entry accepted yourself. Set related_paths to " +
+            "globs covering the source file and its test or doc. Rejects duplicates (a title whose id " +
+            "already exists for that type). Never overwrites existing entries.",
         inputSchema: {
             type: entryTypeSchema.describe("decision | convention | limitation | learning | context"),
             title: z.string().min(1).describe("A concise, human-readable title"),
@@ -144,7 +180,9 @@ export function registerWriteTools(server, root, index) {
     server.registerTool("deprecate_memory", {
         title: "Deprecate a memory entry",
         description: "Mark an existing memory entry as deprecated, recording the reason (and optionally " +
-            "the id of the entry that supersedes it).",
+            "the id of the entry that supersedes it). Use it when your work makes an earlier entry " +
+            "false or obsolete and no replacement is needed; when you are writing a replacement, " +
+            "pass supersedes to propose_memory instead. Do not leave contradicting entries live.",
         inputSchema: {
             id: z.string().min(1).describe("The id of the entry to deprecate"),
             reason: z.string().min(1).describe("Why the entry is being deprecated"),

package/dist/server.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@repomem/memory",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Your repo's memory, available to every AI tool your team uses. A local MCP server that turns a memory/ folder into searchable shared context.",
   "license": "MIT",
   "author": "Nicolás Rickert",