mcp-context-card 0.5.2 → 0.6.1

package/.well-known/ai-catalog.json

@@ -21,7 +21,7 @@
       "description": "Cross-session memory — 4 fact(s), profile \"knowledge\". Recall survives a process restart. No de-facto standard for this concern yet.",
       "url": "./project.fafm",
       "_meta": {
-        "io.github.wolfe-jam.mcp-context-card/iana": "https://www.iana.org/assignments/media-types/application/vnd.fafm+yaml"
+        "io.github.Wolfe-Jam.mcp-context-card/iana": "https://www.iana.org/assignments/media-types/application/vnd.fafm+yaml"
       }
     },
     {
@@ -32,7 +32,7 @@
       "description": "The essential MCP components for a project's context (AGENTS.md), cross-session memory, and identity — a base MCP on its own, or a drop-in extension for any existing MCP server, discoverable through the Server Card _meta block and a self-published ai-catalog.json.",
       "url": "./.well-known/fafa",
       "_meta": {
-        "io.github.wolfe-jam.mcp-context-card/iana": "https://www.iana.org/assignments/media-types/application/vnd.fafa+yaml"
+        "io.github.Wolfe-Jam.mcp-context-card/iana": "https://www.iana.org/assignments/media-types/application/vnd.fafa+yaml"
       }
     }
   ]

package/.well-known/fafa

@@ -8,8 +8,8 @@ version: "1.0"
 agent:
   name: "mcp-context-card"
   displayName: "mcp-context-card"
-  vendor: "io.github.wolfe-jam"
-  version: "0.5.2"
+  vendor: "io.github.Wolfe-Jam"
+  version: "0.6.1"
   description: >-
     The essential MCP components for a project's context (AGENTS.md),
     cross-session memory, and identity — a base MCP on its own, or a

package/CHANGELOG.md

@@ -2,6 +2,85 @@
 
 All notable changes to this project. Adheres to [Semantic Versioning](https://semver.org).
 
+## 0.6.1
+
+Two real bugs, both caught by the actual `/pubaaif` publish run against
+0.6.0 — not a dry-run this time, the live registry rejected the first
+attempt and the live npm publish shipped the second one wrong.
+
+- **Fix: the publisher namespace was wrong-cased everywhere.** Every
+  `_meta` key, `server.json.name`, `package.json.mcpName`, and
+  `.well-known/fafa`'s `vendor` field used `io.github.wolfe-jam` —
+  lowercase. The MCP Registry checks this against the authenticated
+  GitHub identity byte-for-byte and rejected the publish: `403`, *"You
+  have permission to publish: `io.github.Wolfe-Jam/*`. Attempting to
+  publish: `io.github.wolfe-jam/mcp-context-card`."* The real GitHub
+  login is `Wolfe-Jam` (capital W, capital J) — an assumption baked in
+  since the original `mcp-trinity` rename that the registry lowercases
+  GitHub logins for namespace purposes was simply wrong. Fixed at the
+  source (`src/identity.ts`'s `META_NS` constant) and everywhere it was
+  hand-duplicated (`server.json`, `package.json`, `.well-known/fafa`,
+  tests, docs) — the 0.6.0 tarball actually shipped this wrong; anyone
+  who installed it got the incorrect namespace in the live `_meta` block.
+- **Fix: `server.json`'s description exceeded the MCP Registry's
+  100-character cap.** `mcp-publisher publish` rejected it: `422`,
+  `"expected length <= 100"` — ours was 263 characters. Trimmed to 97,
+  same claim. `package.json`'s longer description is unaffected — the
+  two are allowed to differ.
+- The 3 version-pill card images (`card-dark.png`, `card-light.png`,
+  `card-identity.png`) re-shot again — they render the vendor pill text,
+  which changed with the casing fix.
+
+No functional/behavioral change beyond the corrected namespace. 102/102
+tests, `card:check` + `catalog:check` green.
+
+## 0.6.0
+
+The README as a hero, not just a description. Everything visual this repo
+claims is now backed by a real screenshot from the actual rendered card —
+nothing hand-drawn, nothing mocked up.
+
+- **The card leads the README** — a side-by-side "Light | Dark" table right
+  at the top, instead of one fixed screenshot. Shows the real range to
+  every viewer regardless of their own GitHub theme.
+- **Each of the three concerns gets its own proof** — context, memory, and
+  identity are each followed by a real crop from the card: the `AGENTS.md`
+  section + the `read_agents_md` line, an actual tagged and verified
+  memory fact, and the title + pills.
+- **"Pick one"** — a table right after the hero: add an `AGENTS.md`,
+  improve one to BEST, get a new MCP server base, or extend an MCP you
+  already run. Replaces the old "Who it's for" table.
+- The dark card no longer blends into GitHub's own dark mode — added a
+  visible ring plus a soft accent-tinted glow so it reads as a distinct
+  card regardless of backdrop.
+- **GitHub Pages, live** — `wolfe-jam.github.io/mcp-context-card/` serves
+  the card in auto/light/dark. The GitHub repo's own "Website" field links
+  there. `package.json`'s `homepage` is a different field and stays on the
+  repo itself — that's where install steps and the tools table live, not a
+  bare rendered card.
+- "Vendor-free," not "Not tied to FAF" — dropped a defensive clause nobody
+  needed, and reworded the vendor-boundary line to state the property
+  without naming a vendor to disclaim against.
+- An external README review caught four real gaps, fixed before publish:
+  the identity line said "agent card" — reworded to **Server Card**, the
+  term this repo already documents and owns (SEP‑2127), so it can't be read
+  as A2A's own, distinctly-specified AgentCard; the "Wire it into a host"
+  example now states the Node ≥22 requirement and cross-references the
+  documented `npx` `ENOENT` fix (Cursor) instead of leaving it undiscoverable
+  until WIRING; `docs/WIRING.md`'s `list_agents_md_sections` example showed
+  `sections: 9` — the real, parser-verified count is 10 (it includes the
+  `AGENTS.md` H1, not just its nine `##` headings).
+- `docs/MECHANISMS.md` states the A2A position: Server Card is what this
+  server has. A2A's AgentCard is a different thing — a live agent, an
+  endpoint, skills, auth. We're ready for A2A: the same `.fafa` source
+  publishes a real AgentCard alongside it the day a project here is
+  reachable over one, not a reshape of `.fafa` itself.
+- Bumped straight to 0.6.0 — 0.5.3 was committed but never published;
+  no reason to leave a changelog entry for a version nobody received.
+
+No functional change — README, docs, and card assets only. 102 tests,
+typecheck/build/demo clean, `card:check` + `catalog:check` green.
+
 ## 0.5.2
 
 The soak, closed out. Two Cursor host checks — a real bug found and fixed, a
@@ -56,7 +135,7 @@ First-hour ergonomics and wording, from the 0.5.0 soak.
   context, memory, and identity discoverable…"). Same in `.well-known/fafa`;
   the three `project.fafm` facts are `type: fact`. `package.json` `author` set
   to the LICENSE holder.
-- `.well-known/fafa` — `vendor: io.github.wolfe-jam`, `status: published`
+- `.well-known/fafa` — `vendor: io.github.Wolfe-Jam`, `status: published`
   (were both `reference`). Shows in `whoami` and as the card's pills.
 
 ## 0.5.0
@@ -88,7 +167,7 @@ tested server.
 ### Exposure
 
 - Server Card `_meta` block — publisher-namespaced keys
-  (`io.github.wolfe-jam.mcp-context-card/{context,memory,identity}`), one per
+  (`io.github.Wolfe-Jam.mcp-context-card/{context,memory,identity}`), one per
   concern. `context` points at `AGENTS.md` / `text/markdown`.
 - `mcp-context-card://server-card` MCP resource (in-band) +
   `GET /.well-known/mcp/server-card` (out-of-band, HTTP transport).

package/README.md

@@ -3,16 +3,38 @@
 [![CI](https://github.com/Wolfe-Jam/mcp-context-card/actions/workflows/ci.yml/badge.svg)](https://github.com/Wolfe-Jam/mcp-context-card/actions/workflows/ci.yml)
 [![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
 
-The essential MCP server for a project's context, memory, and identity —
-discoverable to any MCP client, and rendered as one card you can read.
+**Get one. Or add it to yours.** The essential MCP server for a project's
+context, memory, and identity — discoverable to any MCP client, and
+rendered as one card you can read.
 
-- **context** — the project's `AGENTS.md`, served whole or one section at a time
-- **memory** — facts that persist across sessions, in a file
-- **identity** — what this server is, from its own agent card
+| Light | Dark |
+|---|---|
+| ![the context card, light theme](./docs/img/card-light.png) | ![the context card, dark theme](./docs/img/card-dark.png) |
+
+**context** — the project's `AGENTS.md`, served whole or one section at a time.
+
+![the card's context section — AGENTS.md, section nav, read_agents_md](./docs/img/card-context.png)
+
+**memory** — facts that persist across sessions, in a file.
+
+![the card's memory section — a real, tagged, verified fact](./docs/img/card-memory.png)
+
+**identity** — what this server is, from its own Server Card.
+
+![the card's identity — name and pills](./docs/img/card-identity.png)
 
 Discovery goes through two surfaces already in the ecosystem: the Server Card
 `_meta` block and `ai-catalog.json` sibling entries.
 
+## Pick one
+
+| You want to… | |
+|---|---|
+| **Add an `AGENTS.md`** — you don't have one | `author_agents_md` drafts one from your repo's real facts |
+| **Improve an `AGENTS.md`** — you have one, make it the best it can be | the same tool, automatically — drop in a `project.faf` and it upgrades to BEST: goal, who it's for, why |
+| **Get a new MCP server base** — context, memory, identity, wired | stand this up as-is; a host has all three before you write a tool of your own |
+| **Improve your MCP with context, memory, ID** — you already run one | run it alongside your existing server; nothing to migrate, it composes |
+
 ## A base MCP — or an extension for any other
 
 Context, memory, and identity are essential — every MCP host needs an agent
@@ -37,18 +59,17 @@ It composes:
 - **author BETTER, keep true** — [`agents-md-facts`](https://github.com/Wolfe-Jam/agents-md-facts) (`author_agents_md` wraps it for the facts layer; adds a BEST layer of its own from `project.faf` when one exists)
 - **files · shell · git** — [`server-filesystem`](https://github.com/modelcontextprotocol/servers), [`server-git`](https://github.com/modelcontextprotocol/servers) / github‑mcp‑server, your test runner's MCP
 
-Not a framework or a platform — three concerns, nothing more. Not a file,
-shell, or search tool — it never touches your files or runs commands. Not
-tied to FAF — context is plain Markdown (`AGENTS.md`); the memory and identity
-formats are swappable examples.
+Vendor-free — context is plain Markdown (`AGENTS.md`); the memory and
+identity formats are swappable examples. It reads and writes only its own
+three files (`AGENTS.md`, `project.fafm`, `.well-known/fafa`) — no general
+file access, no shell, no search.
 
 ## The card
 
-![the context card](./docs/img/card.png)
-
-The same three sources render as one self‑contained HTML page — identity,
-`AGENTS.md`, memory, and how a machine fetches it. The view for people:
-screenshot it, drop it in a PR, put it on a status page.
+The screenshot at the top of this page is exactly this — the same three
+sources rendered as one self‑contained HTML page: identity, `AGENTS.md`,
+memory, and how a machine fetches it. The view for people: screenshot it,
+drop it in a PR, put it on a status page.
 
 ```
 GET /card                      # live, on the HTTP transport
@@ -57,17 +78,10 @@ npx mcp-context-card card       # or:  npm run card  →  docs/card.html
 ```
 
 Light, dark, or auto; the accent defaults to the AAIF palette and takes any hex.
-[docs/card.html](./docs/card.html) is this repo's, rendered.
-
-## Who it's for
-
-| You want… | Reach for |
-|---|---|
-| an `AGENTS.md` and you don't have one | `author_agents_md` — BEST with a `project.faf`, BETTER without |
-| your agent to pull *one* `AGENTS.md` section on demand, not the whole file | `read_agents_md` · `list_agents_md_sections` |
-| a persistent notepad for your agent — survives restarts, no setup | `remember` · `recall` · `forget` |
-| a shareable view of what your MCP server exposes to agents | `GET /card` · `npx mcp-context-card card` |
-| the two‑surface discovery pattern to copy into your own server | read `src/` |
+This repo's own card, live: [auto](https://wolfe-jam.github.io/mcp-context-card/) ·
+[light](https://wolfe-jam.github.io/mcp-context-card/card-light.html) ·
+[dark](https://wolfe-jam.github.io/mcp-context-card/card-dark.html)
+(all in the AAIF accent shown here — pass any hex to change it).
 
 ## Add it to your setup
 
@@ -114,9 +128,13 @@ Claude Desktop, Cursor, or any stdio host:
 
 `MCP_CONTEXT_CARD_ROOT` points at the directory with your `AGENTS.md`. The
 memory tools work with or without it; identity is optional. Over HTTP instead:
-`PORT=8080 npx mcp-context-card`. Full wiring is in
-[docs/WIRING.md](./docs/WIRING.md); transport choice in
-[docs/TRANSPORT.md](./docs/TRANSPORT.md).
+`PORT=8080 npx mcp-context-card`. Requires Node ≥22.
+
+If `command: "npx"` fails to spawn (`spawn npx ENOENT` — seen on Cursor, whose
+host process doesn't inherit a shell `PATH`), point `command` at `node` and
+the installed `dist/bin.js` instead — see
+[docs/WIRING.md](./docs/WIRING.md#1-running-it-in-a-host). Transport choice is
+in [docs/TRANSPORT.md](./docs/TRANSPORT.md).
 
 Extending an MCP you already run: most hosts accept more than one
 `mcpServers` entry — add `context-card` alongside `server-filesystem`,
@@ -173,7 +191,7 @@ The wire‑level detail is in [docs/MECHANISMS.md](./docs/MECHANISMS.md).
 4. **Discovery** — `list_context_sources()`, then the same server over stateless
    HTTP with its `.well-known` routes and `GET /card`.
 
-99 tests on Linux, macOS, and Windows, coverage‑gated in CI. Two spawn a real
+102 tests on Linux, macOS, and Windows, coverage‑gated in CI. Two spawn a real
 child process and check a remembered fact survives the restart — one against
 an existing `project.fafm`, one starting from a project that has never had
 one; another checks the stdio and HTTP tool surfaces match.

package/dist/bin.d.ts

@@ -8,7 +8,7 @@ export interface Launch {
     root: string;
 }
 /** what a bare `--help` / `help` prints. */
-export declare const HELP = "mcp-context-card 0.5.2\nServe a project's context (AGENTS.md), memory, and identity over MCP.\n\nUSAGE\n  mcp-context-card                  stdio MCP server \u2014 what an MCP host spawns (default)\n  mcp-context-card --http           stateless Streamable HTTP on PORT (default 3000)\n  mcp-context-card --stdio          force stdio even when PORT is set\n  mcp-context-card card [> f.html]  render this directory's context card to stdout\n                                      --theme light|dark    --accent #hex\n  mcp-context-card --help           this text\n  mcp-context-card --version        print version\n\nENV\n  MCP_CONTEXT_CARD_ROOT   read AGENTS.md / project.fafm / .well-known/ from here\n  PORT                    if set, run HTTP instead of stdio\n\nA bare run is an stdio server: it waits for a host to speak JSON-RPC on stdin,\nso it looks idle at a terminal. Try `card` or `--http` to see output directly.\nhttps://github.com/Wolfe-Jam/mcp-context-card\n";
+export declare const HELP = "mcp-context-card 0.6.1\nServe a project's context (AGENTS.md), memory, and identity over MCP.\n\nUSAGE\n  mcp-context-card                  stdio MCP server \u2014 what an MCP host spawns (default)\n  mcp-context-card --http           stateless Streamable HTTP on PORT (default 3000)\n  mcp-context-card --stdio          force stdio even when PORT is set\n  mcp-context-card card [> f.html]  render this directory's context card to stdout\n                                      --theme light|dark    --accent #hex\n  mcp-context-card --help           this text\n  mcp-context-card --version        print version\n\nENV\n  MCP_CONTEXT_CARD_ROOT   read AGENTS.md / project.fafm / .well-known/ from here\n  PORT                    if set, run HTTP instead of stdio\n\nA bare run is an stdio server: it waits for a host to speak JSON-RPC on stdin,\nso it looks idle at a terminal. Try `card` or `--http` to see output directly.\nhttps://github.com/Wolfe-Jam/mcp-context-card\n";
 /**
  * Decide how to launch, from argv + env. Pure — so the mode matrix is unit
  * tested without spawning a process.

package/dist/card-gen.js

@@ -2,6 +2,15 @@
  * card-gen - write docs/card.html from the three sources, so the card is
  * browsable on GitHub and screenshot-able for the README. Same renderer as
  * GET /card and the render_context_card tool.
+ *
+ * Also writes two theme-pinned siblings (docs/card-light.html,
+ * docs/card-dark.html) — docs/card.html stays "auto" (follows the viewer's
+ * OS preference); the two siblings are for linking a forced theme from the
+ * README, since a static host can't answer a `?theme=` query param.
+ *
+ * GitHub Pages serves this repo from main /docs (wolfe-jam.github.io/
+ * mcp-context-card/) — docs/index.html (a copy of the auto card) is what
+ * answers the bare root, so it isn't a 404.
  */
 import { writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
@@ -9,6 +18,10 @@ import { fileURLToPath, pathToFileURL } from "node:url";
 import { renderCard } from "./render-card.js";
 if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
     const root = join(dirname(fileURLToPath(import.meta.url)), "..");
-    writeFileSync(join(root, "docs/card.html"), renderCard(root));
-    console.log("wrote docs/card.html — the context card, rendered from AGENTS.md / project.fafm / .well-known/fafa");
+    const auto = renderCard(root);
+    writeFileSync(join(root, "docs/card.html"), auto);
+    writeFileSync(join(root, "docs/index.html"), auto);
+    writeFileSync(join(root, "docs/card-light.html"), renderCard(root, { theme: "light" }));
+    writeFileSync(join(root, "docs/card-dark.html"), renderCard(root, { theme: "dark" }));
+    console.log("wrote docs/card.html + docs/index.html (auto) + card-light.html + card-dark.html — the context card, rendered from AGENTS.md / project.fafm / .well-known/fafa");
 }

package/dist/catalog-gen.d.ts

@@ -20,7 +20,7 @@ export declare function buildCatalog(root: string): {
         description: string;
         url: string;
         _meta: {
-            "io.github.wolfe-jam.mcp-context-card/iana": string;
+            "io.github.Wolfe-Jam.mcp-context-card/iana": string;
         };
     })[];
 };

package/dist/constants.d.ts

@@ -1,5 +1,5 @@
 /** Server identity constants, in their own module so any file can import
  *  them without pulling in the whole server. */
 export declare const NAME = "mcp-context-card";
-export declare const VERSION = "0.5.2";
+export declare const VERSION = "0.6.1";
 export declare const SERVER_CARD_URI = "mcp-context-card://server-card";

package/dist/constants.js

@@ -1,5 +1,5 @@
 /** Server identity constants, in their own module so any file can import
  *  them without pulling in the whole server. */
 export const NAME = "mcp-context-card";
-export const VERSION = "0.5.2";
+export const VERSION = "0.6.1";
 export const SERVER_CARD_URI = "mcp-context-card://server-card";

package/dist/identity.d.ts

@@ -1,6 +1,6 @@
 import type { AgentIdentity } from "./faf/types.js";
 /** The `_meta` key namespace — the publisher's, reverse-DNS. */
-export declare const META_NS = "io.github.wolfe-jam.mcp-context-card";
+export declare const META_NS = "io.github.Wolfe-Jam.mcp-context-card";
 export declare function identity(root: string): AgentIdentity | null;
 /**
  * The identity to show: the `.well-known/fafa` card if present — richer and
@@ -17,17 +17,17 @@ export declare function whoami(root: string): string;
  * because there is no de-facto standard for it yet.
  */
 export declare function serverCardMeta(): {
-    readonly "io.github.wolfe-jam.mcp-context-card/context": {
+    readonly "io.github.Wolfe-Jam.mcp-context-card/context": {
         readonly source: "AGENTS.md";
         readonly mediaType: "text/markdown";
     };
-    readonly "io.github.wolfe-jam.mcp-context-card/memory": {
+    readonly "io.github.Wolfe-Jam.mcp-context-card/memory": {
         readonly source: "project.fafm";
         readonly mediaType: "application/vnd.fafm+yaml";
         readonly iana: string;
         readonly note: "no de-facto standard for agent memory yet — this is one instantiation";
     };
-    readonly "io.github.wolfe-jam.mcp-context-card/identity": {
+    readonly "io.github.Wolfe-Jam.mcp-context-card/identity": {
         readonly source: ".well-known/fafa";
         readonly mediaType: "application/vnd.fafa+yaml";
         readonly iana: string;

package/dist/identity.js

@@ -11,7 +11,7 @@ import { readFileSync } from "node:fs";
 import { join } from "node:path";
 import { parseFafa } from "./faf/parse-fafa.js";
 /** The `_meta` key namespace — the publisher's, reverse-DNS. */
-export const META_NS = "io.github.wolfe-jam.mcp-context-card";
+export const META_NS = "io.github.Wolfe-Jam.mcp-context-card";
 const iana = (t) => `https://www.iana.org/assignments/media-types/${t}`;
 export function identity(root) {
     return parseFafa(join(root, ".well-known/fafa"));

package/dist/render-card.js

@@ -26,15 +26,20 @@ const CSS = (accent) => `
   --accent:${accent};
   --bg:#f4f4f5; --card:#fff; --fg:#0a0a0a; --muted:#6b6b70;
   --line:rgba(0,0,0,.09); --chip:rgba(0,0,0,.05);
+  --card-shadow:0 1px 3px rgba(0,0,0,.06), 0 12px 32px rgba(0,0,0,.10);
 }
 :root[data-theme="dark"]{
   --bg:#000; --card:#0d0d0d; --fg:#fafafa; --muted:#9a9aa0;
   --line:rgba(255,255,255,.13); --chip:rgba(255,255,255,.07);
+  --card-shadow:0 0 0 1px rgba(255,255,255,.16),
+    0 8px 40px color-mix(in srgb, var(--accent) 20%, transparent);
 }
 @media (prefers-color-scheme:dark){
   :root:not([data-theme="light"]){
     --bg:#000; --card:#0d0d0d; --fg:#fafafa; --muted:#9a9aa0;
     --line:rgba(255,255,255,.13); --chip:rgba(255,255,255,.07);
+    --card-shadow:0 0 0 1px rgba(255,255,255,.16),
+      0 8px 40px color-mix(in srgb, var(--accent) 20%, transparent);
   }
 }
 *{box-sizing:border-box}
@@ -42,7 +47,7 @@ body{margin:0;background:var(--bg);color:var(--fg);
   font:15px/1.6 -apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,Helvetica,Arial,sans-serif;
   padding:40px 18px}
 .card{max-width:760px;margin:0 auto;background:var(--card);border:1px solid var(--line);
-  border-radius:14px;overflow:hidden}
+  border-radius:14px;overflow:hidden;box-shadow:var(--card-shadow)}
 .card>*{padding:26px 30px}
 .top{border-top:4px solid var(--accent);border-bottom:1px solid var(--line)}
 h1{margin:0 0 10px;font-size:1.7rem;letter-spacing:-.02em}

package/dist/server.d.ts

@@ -29,17 +29,17 @@ export declare function serverCard(): {
     name: string;
     version: string;
     _meta: {
-        readonly "io.github.wolfe-jam.mcp-context-card/context": {
+        readonly "io.github.Wolfe-Jam.mcp-context-card/context": {
             readonly source: "AGENTS.md";
             readonly mediaType: "text/markdown";
         };
-        readonly "io.github.wolfe-jam.mcp-context-card/memory": {
+        readonly "io.github.Wolfe-Jam.mcp-context-card/memory": {
             readonly source: "project.fafm";
             readonly mediaType: "application/vnd.fafm+yaml";
             readonly iana: string;
             readonly note: "no de-facto standard for agent memory yet — this is one instantiation";
         };
-        readonly "io.github.wolfe-jam.mcp-context-card/identity": {
+        readonly "io.github.Wolfe-Jam.mcp-context-card/identity": {
             readonly source: ".well-known/fafa";
             readonly mediaType: "application/vnd.fafa+yaml";
             readonly iana: string;

package/docs/MECHANISMS.md

@@ -29,19 +29,19 @@ Both return:
 ```jsonc
 {
   "name": "mcp-context-card",
-  "version": "0.5.2",
+  "version": "0.6.1",
   "_meta": {
-    "io.github.wolfe-jam.mcp-context-card/context": {
+    "io.github.Wolfe-Jam.mcp-context-card/context": {
       "source": "AGENTS.md",
       "mediaType": "text/markdown"
     },
-    "io.github.wolfe-jam.mcp-context-card/memory": {
+    "io.github.Wolfe-Jam.mcp-context-card/memory": {
       "source": "project.fafm",
       "mediaType": "application/vnd.fafm+yaml",
       "iana": "https://www.iana.org/assignments/media-types/application/vnd.fafm+yaml",
       "note": "no de-facto standard for agent memory yet — this is one instantiation"
     },
-    "io.github.wolfe-jam.mcp-context-card/identity": {
+    "io.github.Wolfe-Jam.mcp-context-card/identity": {
       "source": ".well-known/fafa",
       "mediaType": "application/vnd.fafa+yaml",
       "iana": "https://www.iana.org/assignments/media-types/application/vnd.fafa+yaml"
@@ -55,7 +55,7 @@ Both return:
 - **`_meta` is the extension point.** SEP‑2127 defines it as
   `additionalProperties: {}`. A consumer that doesn't know a key ignores it.
 - **Keys are reverse‑DNS‑namespaced to the publisher**
-  (`io.github.wolfe-jam.mcp-context-card/context`, not `context`). No collisions, and
+  (`io.github.Wolfe-Jam.mcp-context-card/context`, not `context`). No collisions, and
   the key's owner is unambiguous. Use a domain or GitHub identity you control.
 - **One key per concern**, each self‑describing: the source file, its media
   type, and — where the media type is IANA‑registered — the anchor. `context`
@@ -135,3 +135,20 @@ change a source, both surfaces move together.
 
 **Describe the artifacts once; expose them through whatever mechanism the
 consumer speaks.**
+
+---
+
+## Server Card, and A2A
+
+**Server Card** is what this server has: `AGENTS.md`, a memory file, an
+identity block — read in-band as an MCP resource, or out-of-band at
+`GET /.well-known/mcp/server-card`.
+
+**A2A's [AgentCard](https://a2a-protocol.org/latest/specification/)** is
+different: a live agent you can hand a task to — an endpoint, `capabilities`,
+`skills`, authentication.
+
+`.fafa` is the identity source behind the Server Card. We're ready for A2A:
+the day a project here is reachable over A2A, the same source publishes a
+real AgentCard alongside it — one more mechanism, same invariant, a real
+endpoint and real skills, not a reshape of `.fafa`.

package/docs/WIRING.md

@@ -77,7 +77,7 @@ And to discover what a server offers before committing to it:
 
 ```ts
 await client.callTool({ name: "list_context_sources", arguments: {} });
-// → { context: { source: "AGENTS.md", mediaType: "text/markdown", present: true, sections: 9 },
+// → { context: { source: "AGENTS.md", mediaType: "text/markdown", present: true, sections: 10 },
 //     memory:  { … }, identity: { … },
 //     surfaces: { mcp: { serverCard: "resource mcp-context-card://server-card" },
 //                 http: { serverCard: "GET /.well-known/mcp/server-card",
@@ -95,7 +95,7 @@ To serve *your* artifacts:
    — with your own, or point `MCP_CONTEXT_CARD_ROOT` at a directory that has them.
    `AGENTS.md` is the one with a real standard; the other two are swappable.
 2. **Rename the namespace.** `serverCardMeta()` in `src/identity.ts` uses
-   `io.github.wolfe-jam.mcp-context-card/*` keys, and `buildCatalog()` in
+   `io.github.Wolfe-Jam.mcp-context-card/*` keys, and `buildCatalog()` in
    `src/catalog-gen.ts` uses `urn:air:mcp-context-card:*` identifiers. Change both to
    a domain or GitHub identity you control ([MECHANISMS.md](./MECHANISMS.md)).
 3. **Swap the media types** in `serverCardMeta()` if your memory / identity

package/docs/card-dark.html

@@ -0,0 +1,126 @@
+<!doctype html>
+<html lang="en" data-theme="dark">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>mcp-context-card — context card</title>
+<style>
+:root{
+  --accent:#FF702D;
+  --bg:#f4f4f5; --card:#fff; --fg:#0a0a0a; --muted:#6b6b70;
+  --line:rgba(0,0,0,.09); --chip:rgba(0,0,0,.05);
+  --card-shadow:0 1px 3px rgba(0,0,0,.06), 0 12px 32px rgba(0,0,0,.10);
+}
+:root[data-theme="dark"]{
+  --bg:#000; --card:#0d0d0d; --fg:#fafafa; --muted:#9a9aa0;
+  --line:rgba(255,255,255,.13); --chip:rgba(255,255,255,.07);
+  --card-shadow:0 0 0 1px rgba(255,255,255,.16),
+    0 8px 40px color-mix(in srgb, var(--accent) 20%, transparent);
+}
+@media (prefers-color-scheme:dark){
+  :root:not([data-theme="light"]){
+    --bg:#000; --card:#0d0d0d; --fg:#fafafa; --muted:#9a9aa0;
+    --line:rgba(255,255,255,.13); --chip:rgba(255,255,255,.07);
+    --card-shadow:0 0 0 1px rgba(255,255,255,.16),
+      0 8px 40px color-mix(in srgb, var(--accent) 20%, transparent);
+  }
+}
+*{box-sizing:border-box}
+body{margin:0;background:var(--bg);color:var(--fg);
+  font:15px/1.6 -apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,Helvetica,Arial,sans-serif;
+  padding:40px 18px}
+.card{max-width:760px;margin:0 auto;background:var(--card);border:1px solid var(--line);
+  border-radius:14px;overflow:hidden;box-shadow:var(--card-shadow)}
+.card>*{padding:26px 30px}
+.top{border-top:4px solid var(--accent);border-bottom:1px solid var(--line)}
+h1{margin:0 0 10px;font-size:1.7rem;letter-spacing:-.02em}
+.pills{display:flex;flex-wrap:wrap;gap:6px}
+.pill{font-size:.74rem;font-weight:600;padding:3px 9px;border-radius:20px;background:var(--chip);color:var(--muted)}
+.pill.accent{background:color-mix(in srgb,var(--accent) 16%,transparent);color:var(--accent)}
+section{border-bottom:1px solid var(--line)}
+section:last-child{border-bottom:0}
+.label{font-size:.7rem;font-weight:700;letter-spacing:.16em;text-transform:uppercase;
+  color:var(--accent);margin:0 0 14px}
+.toc{display:flex;flex-wrap:wrap;gap:6px 14px;margin:0 0 20px;padding:0;list-style:none}
+.toc a{font-size:.82rem;color:var(--muted);text-decoration:none}
+.toc a:hover{color:var(--accent)}
+.md h1,.md h2,.md h3,.md h4{margin:22px 0 8px;font-size:1rem;letter-spacing:-.01em}
+.md h1{font-size:1.15rem}
+.md p{margin:8px 0}
+.md ul,.md ol{margin:8px 0;padding-left:22px}
+.md li{margin:3px 0}
+.md code{background:var(--chip);padding:1px 5px;border-radius:5px;
+  font:.86em ui-monospace,SFMono-Regular,Menlo,monospace}
+.md pre{background:var(--chip);padding:14px 16px;border-radius:9px;overflow:auto}
+.md pre code{background:none;padding:0}
+.md table{border-collapse:collapse;width:100%;margin:12px 0;font-size:.88rem;display:block;overflow:auto}
+.md th,.md td{border:1px solid var(--line);padding:6px 10px;text-align:left}
+.md blockquote{margin:10px 0;padding-left:14px;border-left:3px solid var(--line);color:var(--muted)}
+.md a{color:var(--accent)}
+.fact{padding:12px 0;border-bottom:1px solid var(--line)}
+.fact:last-child{border-bottom:0}
+.fact p{margin:0 0 7px}
+.meta{display:flex;flex-wrap:wrap;gap:6px;align-items:center}
+.tag{font-size:.72rem;padding:2px 8px;border-radius:5px;background:var(--chip);color:var(--muted)}
+.dot{width:7px;height:7px;border-radius:50%;background:var(--accent);display:inline-block}
+.dot.pending{background:var(--muted)}
+.disc{width:100%;border-collapse:collapse;font-size:.84rem}
+.disc th,.disc td{text-align:left;padding:6px 10px;border-bottom:1px solid var(--line)}
+.disc th{color:var(--muted);font-weight:600}
+.disc code{font:.86em ui-monospace,SFMono-Regular,Menlo,monospace;color:var(--muted)}
+.fetch{margin:14px 0 0;font-size:.82rem;color:var(--muted)}
+.fetch code{background:var(--chip);padding:1px 5px;border-radius:5px}
+.foot{color:var(--muted);font-size:.78rem;text-align:center;border-top:1px solid var(--line)}
+.none{color:var(--muted);font-style:italic}
+</style>
+</head>
+<body>
+<main class="card">
+  <div class="top">
+    <h1>mcp-context-card</h1>
+    <div class="pills"><span class="pill">io.github.Wolfe-Jam</span><span class="pill">v0.6.1</span><span class="pill accent">published</span><span class="pill">MIT</span></div>
+  </div>
+  <section>
+    <p class="label">Context — AGENTS.md</p>
+    <ul class="toc"><li><a href="#setup">Setup</a></li><li><a href="#build">Build</a></li><li><a href="#test">Test</a></li><li><a href="#layout">Layout</a></li><li><a href="#conventions">Conventions</a></li><li><a href="#the-invariant">The invariant</a></li><li><a href="#safety">Safety</a></li><li><a href="#definition-of-done">Definition of done</a></li><li><a href="#authoring-this-file">Authoring this file</a></li></ul><div class="md"><p><code>mcp-context-card</code> is the essential MCP server for a project's <strong>context</strong> (this file), <strong>memory</strong>, and <strong>identity</strong> — usable as your base MCP, or dropped into any existing MCP server as an extension. Discoverable to any MCP client through the two surfaces already in the ecosystem: the Server Card <code>_meta</code> block and <code>ai-catalog.json</code> sibling entries.</p>
+<p><code>read_agents_md</code> serves this file, section by section, over the same MCP connection.</p>
+<h2 id="setup">Setup</h2>
+<pre><code class="language-bash">npm ci</code></pre>
+<p>Node 22 or newer. No other system dependencies.</p>
+<h2 id="build">Build</h2>
+<pre><code class="language-bash">npm run build       # tsc -p tsconfig.build.json  →  dist/
+npm run typecheck   # tsc --noEmit over src/ + test/</code></pre>
+<h2 id="test">Test</h2>
+<pre><code class="language-bash">npm test              # node:test — every test/*.test.ts
+npm run test:coverage # + the coverage gate (lines 90 / funcs 85 / branches 80, src/ only)
+npm run demo          # end to end: all tools over stdio, then over stateless HTTP</code></pre>
+<p>CI runs <code>typecheck → build → test:coverage → demo</code> on Linux, macOS, and Windows for every push and PR to <code>main</code> (<code>.github/workflows/ci.yml</code>).</p>
+<h2 id="layout">Layout</h2>
+<table><thead><tr><th>Path</th><th>What</th></tr></thead><tbody><tr><td><code>src/server.ts</code></td><td>the MCP server — the nine tools + the Server Card resource</td></tr><tr><td><code>src/agents-md.ts</code></td><td>reads and section-splits this file</td></tr><tr><td><code>src/author.ts</code></td><td><code>author_agents_md</code> — BETTER via <code>agents-md-facts</code>, BEST when <code>project.faf</code> exists</td></tr><tr><td><code>src/md.ts</code></td><td>a minimal dependency-free Markdown → HTML renderer</td></tr><tr><td><code>src/render-card.ts</code></td><td>the card — identity + this file + memory + discovery, as one HTML page</td></tr><tr><td><code>src/memory.ts</code> → <code>src/faf/parse-fafm.ts</code></td><td>file-backed <code>remember</code> / <code>recall</code> / <code>forget</code></td></tr><tr><td><code>src/identity.ts</code></td><td><code>whoami</code> (<code>.fafa</code> → <code>package.json</code> fallback) + the <code>_meta</code> context block</td></tr><tr><td><code>src/catalog-gen.ts</code></td><td>writes <code>.well-known/ai-catalog.json</code> from the same three sources</td></tr><tr><td><code>src/transport/http.ts</code></td><td>the stateless Streamable HTTP app (Hono)</td></tr><tr><td><code>src/bin.ts</code></td><td>the entry point (<code>resolveLaunch</code>) — <code>stdio</code> · <code>--http</code> · <code>card</code> · <code>--help</code> · <code>--version</code></td></tr><tr><td><code>src/faf/parse-fafm.ts</code> · <code>parse-fafa.ts</code></td><td>the <code>.fafm</code> / <code>.fafa</code> parsers</td></tr></tbody></table>
+<h2 id="conventions">Conventions</h2>
+<ul><li>TypeScript strict, ESM only (<code>&quot;type&quot;: &quot;module&quot;</code>, <code>.js</code> import specifiers).</li><li>Tests use <code>node:test</code> + <code>node:assert/strict</code> — no test framework.</li><li>Every source file opens with a comment stating what it is and why.</li><li>Conventional Commit messages (<code>feat:</code>, <code>fix:</code>, <code>chore:</code>, <code>test:</code>, <code>docs:</code>).</li></ul>
+<h2 id="the-invariant">The invariant</h2>
+<p><code>src/identity.ts</code>, <code>src/catalog-gen.ts</code>, and <code>src/render-card.ts</code> all describe the <strong>same three sources</strong>: this file, <code>project.fafm</code>, <code>.well-known/fafa</code>. Change what one exposes and you must change the others. <code>npm run catalog:check</code> and <code>npm run card:check</code> enforce it in CI — each regenerates its surface and fails on any diff.</p>
+<h2 id="safety">Safety</h2>
+<ul><li>Branch off <code>main</code>; CI must be green before merge.</li><li><code>npm run demo</code> writes a fact to <code>project.fafm</code> and restores the file on exit — don't kill it mid-run.</li><li>No secrets live in this repo; never add any.</li></ul>
+<h2 id="definition-of-done">Definition of done</h2>
+<p><code>npm run typecheck &amp;&amp; npm run build &amp;&amp; npm test &amp;&amp; npm run demo</code> all green, plus <code>npm run catalog:check</code> and <code>npm run card:check</code> clean if you touched <code>AGENTS.md</code>, <code>project.fafm</code>, or <code>.well-known/fafa</code>.</p>
+<h2 id="authoring-this-file">Authoring this file</h2>
+<p><code>AGENTS.md</code> here is maintained by hand. The <code>author_agents_md</code> tool (or <code>faf export --agents</code>) would draft a BEST version straight from this repo's own <code>project.faf</code> plus its detected facts — the server doesn't care how the file was authored, only that it's valid Markdown.</p></div>
+  </section>
+  <section>
+    <p class="label">Memory — 4 facts</p>
+    <div class="fact"><p>The context concern points at AGENTS.md — the de-facto standard for agent instructions. read_agents_md serves it whole or one section at a time, so a client pulls '## Test' without spending its context window on the whole file. Memory and identity have no de-facto standard, so this server uses .fafm and .fafa as one instantiation each.</p><div class="meta"><span class="tag">scope</span><span class="tag">agents-md</span><span class="dot" title="verified"></span></div></div><div class="fact"><p>Both exposure mechanisms — the Server Card _meta block and a self-published ai-catalog.json — already exist in the MCP ecosystem. This server wires all three concerns through them, from one set of source files, with a CI check (catalog:check) that fails if the two surfaces drift apart.</p><div class="meta"><span class="tag">mcp</span><span class="tag">server-card</span><span class="tag">ai-catalog</span><span class="dot" title="verified"></span></div></div><div class="fact"><p>Distribution: a published npm package (bin <code>mcp-context-card</code>, dual transport). The three source files (AGENTS.md, project.fafm, .well-known/fafa) ship with the package so it is a working discovery target on install. MCP_CONTEXT_CARD_ROOT points it at a real project.</p><div class="meta"><span class="tag">distribution</span><span class="tag">mit</span><span class="tag">npm</span><span class="dot" title="verified"></span></div></div><div class="fact"><p>author_agents_md authors the best AGENTS.md the project has the material for, not a fixed floor. BETTER is the facts-only draft (via agents-md-facts: build/test commands, entry points, conventions — nothing invented). BEST is that plus a '## Project' section ahead of it, read straight from project.faf when one exists — goal, who it's for, why, and a start-here file list. The rule is concrete: project.faf present means BEST, absent means BETTER.</p><div class="meta"><span class="tag">agents-md</span><span class="tag">author_agents_md</span><span class="tag">faf</span><span class="dot" title="verified"></span></div></div>
+  </section>
+  <section>
+    <p class="label">Discovery</p>
+    <table class="disc"><thead><tr><th>concern</th><th>source</th><th>media type</th></tr></thead><tbody><tr><td>context</td><td><code>AGENTS.md</code></td><td><code>text/markdown</code></td></tr><tr><td>memory</td><td><code>project.fafm</code></td><td><code>application/vnd.fafm+yaml</code></td></tr><tr><td>identity</td><td><code>.well-known/fafa</code></td><td><code>application/vnd.fafa+yaml</code></td></tr></tbody></table>
+    <p class="fetch">A machine reads this over <b>MCP</b> from the
+      <code>mcp-context-card://server-card</code> resource; over <b>HTTP</b> also
+      from <code>GET /.well-known/mcp/server-card</code> and
+      <code>GET /.well-known/ai-catalog.json</code>.</p>
+  </section>
+  <div class="foot">mcp-context-card · context card</div>
+</main>
+</body>
+</html>

package/docs/card-light.html

@@ -0,0 +1,126 @@
+<!doctype html>
+<html lang="en" data-theme="light">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>mcp-context-card — context card</title>
+<style>
+:root{
+  --accent:#FF702D;
+  --bg:#f4f4f5; --card:#fff; --fg:#0a0a0a; --muted:#6b6b70;
+  --line:rgba(0,0,0,.09); --chip:rgba(0,0,0,.05);
+  --card-shadow:0 1px 3px rgba(0,0,0,.06), 0 12px 32px rgba(0,0,0,.10);
+}
+:root[data-theme="dark"]{
+  --bg:#000; --card:#0d0d0d; --fg:#fafafa; --muted:#9a9aa0;
+  --line:rgba(255,255,255,.13); --chip:rgba(255,255,255,.07);
+  --card-shadow:0 0 0 1px rgba(255,255,255,.16),
+    0 8px 40px color-mix(in srgb, var(--accent) 20%, transparent);
+}
+@media (prefers-color-scheme:dark){
+  :root:not([data-theme="light"]){
+    --bg:#000; --card:#0d0d0d; --fg:#fafafa; --muted:#9a9aa0;
+    --line:rgba(255,255,255,.13); --chip:rgba(255,255,255,.07);
+    --card-shadow:0 0 0 1px rgba(255,255,255,.16),
+      0 8px 40px color-mix(in srgb, var(--accent) 20%, transparent);
+  }
+}
+*{box-sizing:border-box}
+body{margin:0;background:var(--bg);color:var(--fg);
+  font:15px/1.6 -apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,Helvetica,Arial,sans-serif;
+  padding:40px 18px}
+.card{max-width:760px;margin:0 auto;background:var(--card);border:1px solid var(--line);
+  border-radius:14px;overflow:hidden;box-shadow:var(--card-shadow)}
+.card>*{padding:26px 30px}
+.top{border-top:4px solid var(--accent);border-bottom:1px solid var(--line)}
+h1{margin:0 0 10px;font-size:1.7rem;letter-spacing:-.02em}
+.pills{display:flex;flex-wrap:wrap;gap:6px}
+.pill{font-size:.74rem;font-weight:600;padding:3px 9px;border-radius:20px;background:var(--chip);color:var(--muted)}
+.pill.accent{background:color-mix(in srgb,var(--accent) 16%,transparent);color:var(--accent)}
+section{border-bottom:1px solid var(--line)}
+section:last-child{border-bottom:0}
+.label{font-size:.7rem;font-weight:700;letter-spacing:.16em;text-transform:uppercase;
+  color:var(--accent);margin:0 0 14px}
+.toc{display:flex;flex-wrap:wrap;gap:6px 14px;margin:0 0 20px;padding:0;list-style:none}
+.toc a{font-size:.82rem;color:var(--muted);text-decoration:none}
+.toc a:hover{color:var(--accent)}
+.md h1,.md h2,.md h3,.md h4{margin:22px 0 8px;font-size:1rem;letter-spacing:-.01em}
+.md h1{font-size:1.15rem}
+.md p{margin:8px 0}
+.md ul,.md ol{margin:8px 0;padding-left:22px}
+.md li{margin:3px 0}
+.md code{background:var(--chip);padding:1px 5px;border-radius:5px;
+  font:.86em ui-monospace,SFMono-Regular,Menlo,monospace}
+.md pre{background:var(--chip);padding:14px 16px;border-radius:9px;overflow:auto}
+.md pre code{background:none;padding:0}
+.md table{border-collapse:collapse;width:100%;margin:12px 0;font-size:.88rem;display:block;overflow:auto}
+.md th,.md td{border:1px solid var(--line);padding:6px 10px;text-align:left}
+.md blockquote{margin:10px 0;padding-left:14px;border-left:3px solid var(--line);color:var(--muted)}
+.md a{color:var(--accent)}
+.fact{padding:12px 0;border-bottom:1px solid var(--line)}
+.fact:last-child{border-bottom:0}
+.fact p{margin:0 0 7px}
+.meta{display:flex;flex-wrap:wrap;gap:6px;align-items:center}
+.tag{font-size:.72rem;padding:2px 8px;border-radius:5px;background:var(--chip);color:var(--muted)}
+.dot{width:7px;height:7px;border-radius:50%;background:var(--accent);display:inline-block}
+.dot.pending{background:var(--muted)}
+.disc{width:100%;border-collapse:collapse;font-size:.84rem}
+.disc th,.disc td{text-align:left;padding:6px 10px;border-bottom:1px solid var(--line)}
+.disc th{color:var(--muted);font-weight:600}
+.disc code{font:.86em ui-monospace,SFMono-Regular,Menlo,monospace;color:var(--muted)}
+.fetch{margin:14px 0 0;font-size:.82rem;color:var(--muted)}
+.fetch code{background:var(--chip);padding:1px 5px;border-radius:5px}
+.foot{color:var(--muted);font-size:.78rem;text-align:center;border-top:1px solid var(--line)}
+.none{color:var(--muted);font-style:italic}
+</style>
+</head>
+<body>
+<main class="card">
+  <div class="top">
+    <h1>mcp-context-card</h1>
+    <div class="pills"><span class="pill">io.github.Wolfe-Jam</span><span class="pill">v0.6.1</span><span class="pill accent">published</span><span class="pill">MIT</span></div>
+  </div>
+  <section>
+    <p class="label">Context — AGENTS.md</p>
+    <ul class="toc"><li><a href="#setup">Setup</a></li><li><a href="#build">Build</a></li><li><a href="#test">Test</a></li><li><a href="#layout">Layout</a></li><li><a href="#conventions">Conventions</a></li><li><a href="#the-invariant">The invariant</a></li><li><a href="#safety">Safety</a></li><li><a href="#definition-of-done">Definition of done</a></li><li><a href="#authoring-this-file">Authoring this file</a></li></ul><div class="md"><p><code>mcp-context-card</code> is the essential MCP server for a project's <strong>context</strong> (this file), <strong>memory</strong>, and <strong>identity</strong> — usable as your base MCP, or dropped into any existing MCP server as an extension. Discoverable to any MCP client through the two surfaces already in the ecosystem: the Server Card <code>_meta</code> block and <code>ai-catalog.json</code> sibling entries.</p>
+<p><code>read_agents_md</code> serves this file, section by section, over the same MCP connection.</p>
+<h2 id="setup">Setup</h2>
+<pre><code class="language-bash">npm ci</code></pre>
+<p>Node 22 or newer. No other system dependencies.</p>
+<h2 id="build">Build</h2>
+<pre><code class="language-bash">npm run build       # tsc -p tsconfig.build.json  →  dist/
+npm run typecheck   # tsc --noEmit over src/ + test/</code></pre>
+<h2 id="test">Test</h2>
+<pre><code class="language-bash">npm test              # node:test — every test/*.test.ts
+npm run test:coverage # + the coverage gate (lines 90 / funcs 85 / branches 80, src/ only)
+npm run demo          # end to end: all tools over stdio, then over stateless HTTP</code></pre>
+<p>CI runs <code>typecheck → build → test:coverage → demo</code> on Linux, macOS, and Windows for every push and PR to <code>main</code> (<code>.github/workflows/ci.yml</code>).</p>
+<h2 id="layout">Layout</h2>
+<table><thead><tr><th>Path</th><th>What</th></tr></thead><tbody><tr><td><code>src/server.ts</code></td><td>the MCP server — the nine tools + the Server Card resource</td></tr><tr><td><code>src/agents-md.ts</code></td><td>reads and section-splits this file</td></tr><tr><td><code>src/author.ts</code></td><td><code>author_agents_md</code> — BETTER via <code>agents-md-facts</code>, BEST when <code>project.faf</code> exists</td></tr><tr><td><code>src/md.ts</code></td><td>a minimal dependency-free Markdown → HTML renderer</td></tr><tr><td><code>src/render-card.ts</code></td><td>the card — identity + this file + memory + discovery, as one HTML page</td></tr><tr><td><code>src/memory.ts</code> → <code>src/faf/parse-fafm.ts</code></td><td>file-backed <code>remember</code> / <code>recall</code> / <code>forget</code></td></tr><tr><td><code>src/identity.ts</code></td><td><code>whoami</code> (<code>.fafa</code> → <code>package.json</code> fallback) + the <code>_meta</code> context block</td></tr><tr><td><code>src/catalog-gen.ts</code></td><td>writes <code>.well-known/ai-catalog.json</code> from the same three sources</td></tr><tr><td><code>src/transport/http.ts</code></td><td>the stateless Streamable HTTP app (Hono)</td></tr><tr><td><code>src/bin.ts</code></td><td>the entry point (<code>resolveLaunch</code>) — <code>stdio</code> · <code>--http</code> · <code>card</code> · <code>--help</code> · <code>--version</code></td></tr><tr><td><code>src/faf/parse-fafm.ts</code> · <code>parse-fafa.ts</code></td><td>the <code>.fafm</code> / <code>.fafa</code> parsers</td></tr></tbody></table>
+<h2 id="conventions">Conventions</h2>
+<ul><li>TypeScript strict, ESM only (<code>&quot;type&quot;: &quot;module&quot;</code>, <code>.js</code> import specifiers).</li><li>Tests use <code>node:test</code> + <code>node:assert/strict</code> — no test framework.</li><li>Every source file opens with a comment stating what it is and why.</li><li>Conventional Commit messages (<code>feat:</code>, <code>fix:</code>, <code>chore:</code>, <code>test:</code>, <code>docs:</code>).</li></ul>
+<h2 id="the-invariant">The invariant</h2>
+<p><code>src/identity.ts</code>, <code>src/catalog-gen.ts</code>, and <code>src/render-card.ts</code> all describe the <strong>same three sources</strong>: this file, <code>project.fafm</code>, <code>.well-known/fafa</code>. Change what one exposes and you must change the others. <code>npm run catalog:check</code> and <code>npm run card:check</code> enforce it in CI — each regenerates its surface and fails on any diff.</p>
+<h2 id="safety">Safety</h2>
+<ul><li>Branch off <code>main</code>; CI must be green before merge.</li><li><code>npm run demo</code> writes a fact to <code>project.fafm</code> and restores the file on exit — don't kill it mid-run.</li><li>No secrets live in this repo; never add any.</li></ul>
+<h2 id="definition-of-done">Definition of done</h2>
+<p><code>npm run typecheck &amp;&amp; npm run build &amp;&amp; npm test &amp;&amp; npm run demo</code> all green, plus <code>npm run catalog:check</code> and <code>npm run card:check</code> clean if you touched <code>AGENTS.md</code>, <code>project.fafm</code>, or <code>.well-known/fafa</code>.</p>
+<h2 id="authoring-this-file">Authoring this file</h2>
+<p><code>AGENTS.md</code> here is maintained by hand. The <code>author_agents_md</code> tool (or <code>faf export --agents</code>) would draft a BEST version straight from this repo's own <code>project.faf</code> plus its detected facts — the server doesn't care how the file was authored, only that it's valid Markdown.</p></div>
+  </section>
+  <section>
+    <p class="label">Memory — 4 facts</p>
+    <div class="fact"><p>The context concern points at AGENTS.md — the de-facto standard for agent instructions. read_agents_md serves it whole or one section at a time, so a client pulls '## Test' without spending its context window on the whole file. Memory and identity have no de-facto standard, so this server uses .fafm and .fafa as one instantiation each.</p><div class="meta"><span class="tag">scope</span><span class="tag">agents-md</span><span class="dot" title="verified"></span></div></div><div class="fact"><p>Both exposure mechanisms — the Server Card _meta block and a self-published ai-catalog.json — already exist in the MCP ecosystem. This server wires all three concerns through them, from one set of source files, with a CI check (catalog:check) that fails if the two surfaces drift apart.</p><div class="meta"><span class="tag">mcp</span><span class="tag">server-card</span><span class="tag">ai-catalog</span><span class="dot" title="verified"></span></div></div><div class="fact"><p>Distribution: a published npm package (bin <code>mcp-context-card</code>, dual transport). The three source files (AGENTS.md, project.fafm, .well-known/fafa) ship with the package so it is a working discovery target on install. MCP_CONTEXT_CARD_ROOT points it at a real project.</p><div class="meta"><span class="tag">distribution</span><span class="tag">mit</span><span class="tag">npm</span><span class="dot" title="verified"></span></div></div><div class="fact"><p>author_agents_md authors the best AGENTS.md the project has the material for, not a fixed floor. BETTER is the facts-only draft (via agents-md-facts: build/test commands, entry points, conventions — nothing invented). BEST is that plus a '## Project' section ahead of it, read straight from project.faf when one exists — goal, who it's for, why, and a start-here file list. The rule is concrete: project.faf present means BEST, absent means BETTER.</p><div class="meta"><span class="tag">agents-md</span><span class="tag">author_agents_md</span><span class="tag">faf</span><span class="dot" title="verified"></span></div></div>
+  </section>
+  <section>
+    <p class="label">Discovery</p>
+    <table class="disc"><thead><tr><th>concern</th><th>source</th><th>media type</th></tr></thead><tbody><tr><td>context</td><td><code>AGENTS.md</code></td><td><code>text/markdown</code></td></tr><tr><td>memory</td><td><code>project.fafm</code></td><td><code>application/vnd.fafm+yaml</code></td></tr><tr><td>identity</td><td><code>.well-known/fafa</code></td><td><code>application/vnd.fafa+yaml</code></td></tr></tbody></table>
+    <p class="fetch">A machine reads this over <b>MCP</b> from the
+      <code>mcp-context-card://server-card</code> resource; over <b>HTTP</b> also
+      from <code>GET /.well-known/mcp/server-card</code> and
+      <code>GET /.well-known/ai-catalog.json</code>.</p>
+  </section>
+  <div class="foot">mcp-context-card · context card</div>
+</main>
+</body>
+</html>

package/docs/card.html

@@ -9,15 +9,20 @@
   --accent:#FF702D;
   --bg:#f4f4f5; --card:#fff; --fg:#0a0a0a; --muted:#6b6b70;
   --line:rgba(0,0,0,.09); --chip:rgba(0,0,0,.05);
+  --card-shadow:0 1px 3px rgba(0,0,0,.06), 0 12px 32px rgba(0,0,0,.10);
 }
 :root[data-theme="dark"]{
   --bg:#000; --card:#0d0d0d; --fg:#fafafa; --muted:#9a9aa0;
   --line:rgba(255,255,255,.13); --chip:rgba(255,255,255,.07);
+  --card-shadow:0 0 0 1px rgba(255,255,255,.16),
+    0 8px 40px color-mix(in srgb, var(--accent) 20%, transparent);
 }
 @media (prefers-color-scheme:dark){
   :root:not([data-theme="light"]){
     --bg:#000; --card:#0d0d0d; --fg:#fafafa; --muted:#9a9aa0;
     --line:rgba(255,255,255,.13); --chip:rgba(255,255,255,.07);
+    --card-shadow:0 0 0 1px rgba(255,255,255,.16),
+      0 8px 40px color-mix(in srgb, var(--accent) 20%, transparent);
   }
 }
 *{box-sizing:border-box}
@@ -25,7 +30,7 @@ body{margin:0;background:var(--bg);color:var(--fg);
   font:15px/1.6 -apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,Helvetica,Arial,sans-serif;
   padding:40px 18px}
 .card{max-width:760px;margin:0 auto;background:var(--card);border:1px solid var(--line);
-  border-radius:14px;overflow:hidden}
+  border-radius:14px;overflow:hidden;box-shadow:var(--card-shadow)}
 .card>*{padding:26px 30px}
 .top{border-top:4px solid var(--accent);border-bottom:1px solid var(--line)}
 h1{margin:0 0 10px;font-size:1.7rem;letter-spacing:-.02em}
@@ -73,7 +78,7 @@ section:last-child{border-bottom:0}
 <main class="card">
   <div class="top">
     <h1>mcp-context-card</h1>
-    <div class="pills"><span class="pill">io.github.wolfe-jam</span><span class="pill">v0.5.2</span><span class="pill accent">published</span><span class="pill">MIT</span></div>
+    <div class="pills"><span class="pill">io.github.Wolfe-Jam</span><span class="pill">v0.6.1</span><span class="pill accent">published</span><span class="pill">MIT</span></div>
   </div>
   <section>
     <p class="label">Context — AGENTS.md</p>

package/docs/index.html

@@ -0,0 +1,126 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>mcp-context-card — context card</title>
+<style>
+:root{
+  --accent:#FF702D;
+  --bg:#f4f4f5; --card:#fff; --fg:#0a0a0a; --muted:#6b6b70;
+  --line:rgba(0,0,0,.09); --chip:rgba(0,0,0,.05);
+  --card-shadow:0 1px 3px rgba(0,0,0,.06), 0 12px 32px rgba(0,0,0,.10);
+}
+:root[data-theme="dark"]{
+  --bg:#000; --card:#0d0d0d; --fg:#fafafa; --muted:#9a9aa0;
+  --line:rgba(255,255,255,.13); --chip:rgba(255,255,255,.07);
+  --card-shadow:0 0 0 1px rgba(255,255,255,.16),
+    0 8px 40px color-mix(in srgb, var(--accent) 20%, transparent);
+}
+@media (prefers-color-scheme:dark){
+  :root:not([data-theme="light"]){
+    --bg:#000; --card:#0d0d0d; --fg:#fafafa; --muted:#9a9aa0;
+    --line:rgba(255,255,255,.13); --chip:rgba(255,255,255,.07);
+    --card-shadow:0 0 0 1px rgba(255,255,255,.16),
+      0 8px 40px color-mix(in srgb, var(--accent) 20%, transparent);
+  }
+}
+*{box-sizing:border-box}
+body{margin:0;background:var(--bg);color:var(--fg);
+  font:15px/1.6 -apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,Helvetica,Arial,sans-serif;
+  padding:40px 18px}
+.card{max-width:760px;margin:0 auto;background:var(--card);border:1px solid var(--line);
+  border-radius:14px;overflow:hidden;box-shadow:var(--card-shadow)}
+.card>*{padding:26px 30px}
+.top{border-top:4px solid var(--accent);border-bottom:1px solid var(--line)}
+h1{margin:0 0 10px;font-size:1.7rem;letter-spacing:-.02em}
+.pills{display:flex;flex-wrap:wrap;gap:6px}
+.pill{font-size:.74rem;font-weight:600;padding:3px 9px;border-radius:20px;background:var(--chip);color:var(--muted)}
+.pill.accent{background:color-mix(in srgb,var(--accent) 16%,transparent);color:var(--accent)}
+section{border-bottom:1px solid var(--line)}
+section:last-child{border-bottom:0}
+.label{font-size:.7rem;font-weight:700;letter-spacing:.16em;text-transform:uppercase;
+  color:var(--accent);margin:0 0 14px}
+.toc{display:flex;flex-wrap:wrap;gap:6px 14px;margin:0 0 20px;padding:0;list-style:none}
+.toc a{font-size:.82rem;color:var(--muted);text-decoration:none}
+.toc a:hover{color:var(--accent)}
+.md h1,.md h2,.md h3,.md h4{margin:22px 0 8px;font-size:1rem;letter-spacing:-.01em}
+.md h1{font-size:1.15rem}
+.md p{margin:8px 0}
+.md ul,.md ol{margin:8px 0;padding-left:22px}
+.md li{margin:3px 0}
+.md code{background:var(--chip);padding:1px 5px;border-radius:5px;
+  font:.86em ui-monospace,SFMono-Regular,Menlo,monospace}
+.md pre{background:var(--chip);padding:14px 16px;border-radius:9px;overflow:auto}
+.md pre code{background:none;padding:0}
+.md table{border-collapse:collapse;width:100%;margin:12px 0;font-size:.88rem;display:block;overflow:auto}
+.md th,.md td{border:1px solid var(--line);padding:6px 10px;text-align:left}
+.md blockquote{margin:10px 0;padding-left:14px;border-left:3px solid var(--line);color:var(--muted)}
+.md a{color:var(--accent)}
+.fact{padding:12px 0;border-bottom:1px solid var(--line)}
+.fact:last-child{border-bottom:0}
+.fact p{margin:0 0 7px}
+.meta{display:flex;flex-wrap:wrap;gap:6px;align-items:center}
+.tag{font-size:.72rem;padding:2px 8px;border-radius:5px;background:var(--chip);color:var(--muted)}
+.dot{width:7px;height:7px;border-radius:50%;background:var(--accent);display:inline-block}
+.dot.pending{background:var(--muted)}
+.disc{width:100%;border-collapse:collapse;font-size:.84rem}
+.disc th,.disc td{text-align:left;padding:6px 10px;border-bottom:1px solid var(--line)}
+.disc th{color:var(--muted);font-weight:600}
+.disc code{font:.86em ui-monospace,SFMono-Regular,Menlo,monospace;color:var(--muted)}
+.fetch{margin:14px 0 0;font-size:.82rem;color:var(--muted)}
+.fetch code{background:var(--chip);padding:1px 5px;border-radius:5px}
+.foot{color:var(--muted);font-size:.78rem;text-align:center;border-top:1px solid var(--line)}
+.none{color:var(--muted);font-style:italic}
+</style>
+</head>
+<body>
+<main class="card">
+  <div class="top">
+    <h1>mcp-context-card</h1>
+    <div class="pills"><span class="pill">io.github.Wolfe-Jam</span><span class="pill">v0.6.1</span><span class="pill accent">published</span><span class="pill">MIT</span></div>
+  </div>
+  <section>
+    <p class="label">Context — AGENTS.md</p>
+    <ul class="toc"><li><a href="#setup">Setup</a></li><li><a href="#build">Build</a></li><li><a href="#test">Test</a></li><li><a href="#layout">Layout</a></li><li><a href="#conventions">Conventions</a></li><li><a href="#the-invariant">The invariant</a></li><li><a href="#safety">Safety</a></li><li><a href="#definition-of-done">Definition of done</a></li><li><a href="#authoring-this-file">Authoring this file</a></li></ul><div class="md"><p><code>mcp-context-card</code> is the essential MCP server for a project's <strong>context</strong> (this file), <strong>memory</strong>, and <strong>identity</strong> — usable as your base MCP, or dropped into any existing MCP server as an extension. Discoverable to any MCP client through the two surfaces already in the ecosystem: the Server Card <code>_meta</code> block and <code>ai-catalog.json</code> sibling entries.</p>
+<p><code>read_agents_md</code> serves this file, section by section, over the same MCP connection.</p>
+<h2 id="setup">Setup</h2>
+<pre><code class="language-bash">npm ci</code></pre>
+<p>Node 22 or newer. No other system dependencies.</p>
+<h2 id="build">Build</h2>
+<pre><code class="language-bash">npm run build       # tsc -p tsconfig.build.json  →  dist/
+npm run typecheck   # tsc --noEmit over src/ + test/</code></pre>
+<h2 id="test">Test</h2>
+<pre><code class="language-bash">npm test              # node:test — every test/*.test.ts
+npm run test:coverage # + the coverage gate (lines 90 / funcs 85 / branches 80, src/ only)
+npm run demo          # end to end: all tools over stdio, then over stateless HTTP</code></pre>
+<p>CI runs <code>typecheck → build → test:coverage → demo</code> on Linux, macOS, and Windows for every push and PR to <code>main</code> (<code>.github/workflows/ci.yml</code>).</p>
+<h2 id="layout">Layout</h2>
+<table><thead><tr><th>Path</th><th>What</th></tr></thead><tbody><tr><td><code>src/server.ts</code></td><td>the MCP server — the nine tools + the Server Card resource</td></tr><tr><td><code>src/agents-md.ts</code></td><td>reads and section-splits this file</td></tr><tr><td><code>src/author.ts</code></td><td><code>author_agents_md</code> — BETTER via <code>agents-md-facts</code>, BEST when <code>project.faf</code> exists</td></tr><tr><td><code>src/md.ts</code></td><td>a minimal dependency-free Markdown → HTML renderer</td></tr><tr><td><code>src/render-card.ts</code></td><td>the card — identity + this file + memory + discovery, as one HTML page</td></tr><tr><td><code>src/memory.ts</code> → <code>src/faf/parse-fafm.ts</code></td><td>file-backed <code>remember</code> / <code>recall</code> / <code>forget</code></td></tr><tr><td><code>src/identity.ts</code></td><td><code>whoami</code> (<code>.fafa</code> → <code>package.json</code> fallback) + the <code>_meta</code> context block</td></tr><tr><td><code>src/catalog-gen.ts</code></td><td>writes <code>.well-known/ai-catalog.json</code> from the same three sources</td></tr><tr><td><code>src/transport/http.ts</code></td><td>the stateless Streamable HTTP app (Hono)</td></tr><tr><td><code>src/bin.ts</code></td><td>the entry point (<code>resolveLaunch</code>) — <code>stdio</code> · <code>--http</code> · <code>card</code> · <code>--help</code> · <code>--version</code></td></tr><tr><td><code>src/faf/parse-fafm.ts</code> · <code>parse-fafa.ts</code></td><td>the <code>.fafm</code> / <code>.fafa</code> parsers</td></tr></tbody></table>
+<h2 id="conventions">Conventions</h2>
+<ul><li>TypeScript strict, ESM only (<code>&quot;type&quot;: &quot;module&quot;</code>, <code>.js</code> import specifiers).</li><li>Tests use <code>node:test</code> + <code>node:assert/strict</code> — no test framework.</li><li>Every source file opens with a comment stating what it is and why.</li><li>Conventional Commit messages (<code>feat:</code>, <code>fix:</code>, <code>chore:</code>, <code>test:</code>, <code>docs:</code>).</li></ul>
+<h2 id="the-invariant">The invariant</h2>
+<p><code>src/identity.ts</code>, <code>src/catalog-gen.ts</code>, and <code>src/render-card.ts</code> all describe the <strong>same three sources</strong>: this file, <code>project.fafm</code>, <code>.well-known/fafa</code>. Change what one exposes and you must change the others. <code>npm run catalog:check</code> and <code>npm run card:check</code> enforce it in CI — each regenerates its surface and fails on any diff.</p>
+<h2 id="safety">Safety</h2>
+<ul><li>Branch off <code>main</code>; CI must be green before merge.</li><li><code>npm run demo</code> writes a fact to <code>project.fafm</code> and restores the file on exit — don't kill it mid-run.</li><li>No secrets live in this repo; never add any.</li></ul>
+<h2 id="definition-of-done">Definition of done</h2>
+<p><code>npm run typecheck &amp;&amp; npm run build &amp;&amp; npm test &amp;&amp; npm run demo</code> all green, plus <code>npm run catalog:check</code> and <code>npm run card:check</code> clean if you touched <code>AGENTS.md</code>, <code>project.fafm</code>, or <code>.well-known/fafa</code>.</p>
+<h2 id="authoring-this-file">Authoring this file</h2>
+<p><code>AGENTS.md</code> here is maintained by hand. The <code>author_agents_md</code> tool (or <code>faf export --agents</code>) would draft a BEST version straight from this repo's own <code>project.faf</code> plus its detected facts — the server doesn't care how the file was authored, only that it's valid Markdown.</p></div>
+  </section>
+  <section>
+    <p class="label">Memory — 4 facts</p>
+    <div class="fact"><p>The context concern points at AGENTS.md — the de-facto standard for agent instructions. read_agents_md serves it whole or one section at a time, so a client pulls '## Test' without spending its context window on the whole file. Memory and identity have no de-facto standard, so this server uses .fafm and .fafa as one instantiation each.</p><div class="meta"><span class="tag">scope</span><span class="tag">agents-md</span><span class="dot" title="verified"></span></div></div><div class="fact"><p>Both exposure mechanisms — the Server Card _meta block and a self-published ai-catalog.json — already exist in the MCP ecosystem. This server wires all three concerns through them, from one set of source files, with a CI check (catalog:check) that fails if the two surfaces drift apart.</p><div class="meta"><span class="tag">mcp</span><span class="tag">server-card</span><span class="tag">ai-catalog</span><span class="dot" title="verified"></span></div></div><div class="fact"><p>Distribution: a published npm package (bin <code>mcp-context-card</code>, dual transport). The three source files (AGENTS.md, project.fafm, .well-known/fafa) ship with the package so it is a working discovery target on install. MCP_CONTEXT_CARD_ROOT points it at a real project.</p><div class="meta"><span class="tag">distribution</span><span class="tag">mit</span><span class="tag">npm</span><span class="dot" title="verified"></span></div></div><div class="fact"><p>author_agents_md authors the best AGENTS.md the project has the material for, not a fixed floor. BETTER is the facts-only draft (via agents-md-facts: build/test commands, entry points, conventions — nothing invented). BEST is that plus a '## Project' section ahead of it, read straight from project.faf when one exists — goal, who it's for, why, and a start-here file list. The rule is concrete: project.faf present means BEST, absent means BETTER.</p><div class="meta"><span class="tag">agents-md</span><span class="tag">author_agents_md</span><span class="tag">faf</span><span class="dot" title="verified"></span></div></div>
+  </section>
+  <section>
+    <p class="label">Discovery</p>
+    <table class="disc"><thead><tr><th>concern</th><th>source</th><th>media type</th></tr></thead><tbody><tr><td>context</td><td><code>AGENTS.md</code></td><td><code>text/markdown</code></td></tr><tr><td>memory</td><td><code>project.fafm</code></td><td><code>application/vnd.fafm+yaml</code></td></tr><tr><td>identity</td><td><code>.well-known/fafa</code></td><td><code>application/vnd.fafa+yaml</code></td></tr></tbody></table>
+    <p class="fetch">A machine reads this over <b>MCP</b> from the
+      <code>mcp-context-card://server-card</code> resource; over <b>HTTP</b> also
+      from <code>GET /.well-known/mcp/server-card</code> and
+      <code>GET /.well-known/ai-catalog.json</code>.</p>
+  </section>
+  <div class="foot">mcp-context-card · context card</div>
+</main>
+</body>
+</html>

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcp-context-card",
-  "version": "0.5.2",
-  "mcpName": "io.github.wolfe-jam/mcp-context-card",
+  "version": "0.6.1",
+  "mcpName": "io.github.Wolfe-Jam/mcp-context-card",
   "description": "The essential MCP components for a project's context (AGENTS.md), cross-session memory, and identity — a base MCP on its own, or a drop-in extension for any existing MCP server. Discoverable through the Server Card _meta block and ai-catalog.json sibling entries.",
   "keywords": [
     "mcp",
@@ -53,7 +53,7 @@
     "catalog": "tsx src/catalog-gen.ts",
     "catalog:check": "tsx src/catalog-gen.ts && git diff --exit-code -- .well-known/ai-catalog.json",
     "card": "tsx src/card-gen.ts",
-    "card:check": "tsx src/card-gen.ts && git diff --exit-code -- docs/card.html",
+    "card:check": "tsx src/card-gen.ts && git diff --exit-code -- docs/card.html docs/index.html docs/card-light.html docs/card-dark.html",
     "test": "node --import tsx --test \"test/*.test.ts\"",
     "test:coverage": "node --import tsx --test --experimental-test-coverage --test-coverage-exclude=\"test/**\" --test-coverage-exclude=\"demo.ts\" --test-coverage-lines=90 --test-coverage-functions=85 --test-coverage-branches=80 \"test/*.test.ts\"",
     "typecheck": "tsc --noEmit"

package/server.json

@@ -1,9 +1,9 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
-  "name": "io.github.wolfe-jam/mcp-context-card",
+  "name": "io.github.Wolfe-Jam/mcp-context-card",
   "title": "mcp-context-card",
-  "description": "The essential MCP components for a project's context (AGENTS.md), cross-session memory, and identity — a base MCP on its own, or a drop-in extension for any existing MCP server. Discoverable through the Server Card _meta block and ai-catalog.json sibling entries.",
-  "version": "0.5.2",
+  "description": "MCP server for a project's context (AGENTS.md), memory, and identity — base or drop-in extension.",
+  "version": "0.6.1",
   "repository": {
     "url": "https://github.com/Wolfe-Jam/mcp-context-card",
     "source": "github"
@@ -13,7 +13,7 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "mcp-context-card",
-      "version": "0.5.2",
+      "version": "0.6.1",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"
@@ -29,17 +29,17 @@
   ],
   "_meta": {
     "io.modelcontextprotocol.registry/publisher-provided": {
-      "io.github.wolfe-jam.mcp-context-card/context": {
+      "io.github.Wolfe-Jam.mcp-context-card/context": {
         "source": "./AGENTS.md",
         "mediaType": "text/markdown"
       },
-      "io.github.wolfe-jam.mcp-context-card/memory": {
+      "io.github.Wolfe-Jam.mcp-context-card/memory": {
         "source": "./project.fafm",
         "mediaType": "application/vnd.fafm+yaml",
         "iana": "https://www.iana.org/assignments/media-types/application/vnd.fafm+yaml",
         "note": "no de-facto standard for agent memory yet — this is one instantiation"
       },
-      "io.github.wolfe-jam.mcp-context-card/identity": {
+      "io.github.Wolfe-Jam.mcp-context-card/identity": {
         "source": "./.well-known/fafa",
         "mediaType": "application/vnd.fafa+yaml",
         "iana": "https://www.iana.org/assignments/media-types/application/vnd.fafa+yaml"