mcp-context-card 1.6.0 → 1.7.0

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

@@ -11,7 +11,7 @@
       "data": {
         "$schema": "https://static.modelcontextprotocol.io/schemas/v1/server-card.schema.json",
         "name": "io.github.Wolfe-Jam/mcp-context-card",
-        "version": "1.6.0",
+        "version": "1.7.0",
         "title": "MCP Context Card",
         "description": "MCP server for a project's context (AGENTS.md), memory, and identity — base or drop-in extension.",
         "websiteUrl": "https://github.com/Wolfe-Jam/mcp-context-card",

package/.well-known/fafa

@@ -13,7 +13,7 @@ agent:
   # a deployment for your own project uses your domain.
   id: "urn:air:faf.one:agent:mcp-context-card"
   vendor: "io.github.Wolfe-Jam"
-  version: "1.6.0"
+  version: "1.7.0"
   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
@@ -23,6 +23,8 @@ agent:
   license: "MIT"
 metadata:
   cards:
+    # The card's colour: AAIF orange. Without one, a card is drawn in ink.
+    accent: "#FF702D"
     packages:
       - registryType: "npm"
         identifier: "mcp-context-card"

package/AGENTS.md

@@ -15,7 +15,7 @@ connection.
 npm ci
 ```
 
-Node 20 or newer. No other system dependencies.
+Node 22 or newer. No other system dependencies.
 
 ## Build
 

package/CHANGELOG.md

@@ -2,6 +2,35 @@
 
 All notable changes to this project. Adheres to [Semantic Versioning](https://semver.org).
 
+## 1.7.0
+
+A card's colour is the owner's.
+
+- **No colour declared = ink.** A card is drawn in its own ink, black on a
+  light card and white on a dark one, unless a colour is declared. Nothing
+  is guessed. The monogram's letter takes the card colour, so it stays
+  readable. Before, every card defaulted to the AAIF orange.
+- **The owner declares it in the `.fafa`:** `metadata.cards.accent: "#0066cc"`.
+  A colour passed in (`--accent`, `?accent`, the tools' `accent`) still
+  wins.
+- A bad value, passed or declared, is dropped and the card falls back to
+  ink. `safeAccent` now returns `undefined` for anything that isn't a hex
+  (it used to return the AAIF orange).
+- This project's own `.fafa` declares the AAIF orange, so its card looks
+  the same.
+- Docs: Node 22 or newer (README and AGENTS.md said 20; `engines` has
+  required `>=22`).
+
+## 1.6.1
+
+The logo is the first letter.
+
+- The card's monogram is now the first letter of the name, with a second
+  letter only when it's obvious ("GH" for GitHub, "TS" for TypeScript, or
+  the two capitals of a CamelCase name). Generic words such as "mcp",
+  "server" or "agent" are skipped, so mcp-context-card's logo is **C**,
+  not MC.
+
 ## 1.6.0
 
 The card is a business card.

package/README.md

@@ -119,11 +119,14 @@ remembers. `detail: "full"` lists every fact whole. The server's
 instructions tell the model to show that rather than paste the HTML into
 the chat.
 
-Light, dark, or auto; the accent defaults to the AAIF palette and takes any hex.
+Light, dark, or auto. The colour is the owner's: set it in the project's
+`.fafa` (`metadata.cards.accent: "#0066cc"`), or pass any hex with `--accent`
+or `?accent`. With none, the card is drawn in ink, black or white; no colour
+is guessed.
 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).
+(in the AAIF orange its `.fafa` declares).
 
 ## Add it to your setup
 
@@ -177,7 +180,7 @@ directory it was started in if that has an `AGENTS.md`. `list_context_sources`
 reports which project it picked and how. To pin one project instead, set
 `"env": { "MCP_CONTEXT_CARD_ROOT": "/abs/path/to/your/project" }`; that always
 wins. Identity is optional. Over HTTP instead:
-`PORT=8080 npx mcp-context-card`. Requires Node ≥20.
+`PORT=8080 npx mcp-context-card`. Requires Node ≥22.
 
 HTTP mode is local by default, as the MCP transports spec asks: it binds
 `127.0.0.1`, refuses foreign browser origins with 403, and refuses DNS names
@@ -271,7 +274,7 @@ over both transports:
 4. **Discovery** — `list_context_sources()`, then the same server over stateless
    HTTP with its `.well-known` routes and `GET /card`.
 
-209 tests on Linux, macOS, and Windows, coverage‑gated in CI.
+210 tests on Linux, macOS, and Windows, coverage‑gated in CI.
 `npm run wjttc` runs the WJTTC certification suite (seven tiers, from protocol
 and Server Card conformance to stdio/HTTP parity and the shipped package). Two spawn a real
 child process and check a remembered fact survives the restart — one against

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 1.6.0\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             this dir's context card \u2014 opens it in your browser\n                                    at a terminal; HTML to stdout when piped ( > f.html )\n                                      --theme light|dark   --accent #hex\n                                      --expanded (all sections open)   --portrait   --stdout\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  HOST                    HTTP bind address (default 127.0.0.1, this machine\n                          only); 0.0.0.0 exposes it, e.g. in a container\n  MCP_CONTEXT_CARD_ALLOWED_HOSTS / _ALLOWED_ORIGINS\n                          comma-separated Host names / browser origins to\n                          accept besides this machine's own (reverse proxy, web app)\n  MCP_CONTEXT_CARD_PUBLISH_MEMORY=1\n                          HTTP: serve project.fafm, list it in the AI Catalog,\n                          and show its facts on an exposed /card (off: memory\n                          is session data). HTTP has no auth\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` (opens your context in a browser) or `--http`.\nhttps://github.com/Wolfe-Jam/mcp-context-card\n";
+export declare const HELP = "mcp-context-card 1.7.0\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             this dir's context card \u2014 opens it in your browser\n                                    at a terminal; HTML to stdout when piped ( > f.html )\n                                      --theme light|dark   --accent #hex\n                                      --expanded (all sections open)   --portrait   --stdout\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  HOST                    HTTP bind address (default 127.0.0.1, this machine\n                          only); 0.0.0.0 exposes it, e.g. in a container\n  MCP_CONTEXT_CARD_ALLOWED_HOSTS / _ALLOWED_ORIGINS\n                          comma-separated Host names / browser origins to\n                          accept besides this machine's own (reverse proxy, web app)\n  MCP_CONTEXT_CARD_PUBLISH_MEMORY=1\n                          HTTP: serve project.fafm, list it in the AI Catalog,\n                          and show its facts on an exposed /card (off: memory\n                          is session data). HTTP has no auth\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` (opens your context in a browser) or `--http`.\nhttps://github.com/Wolfe-Jam/mcp-context-card\n";
 /**
  * The address the HTTP server binds: `HOST`, else 127.0.0.1. Local by default,
  * as the MCP transports spec recommends; a hosted deploy sets HOST=0.0.0.0.

package/dist/constants.d.ts

@@ -1,7 +1,7 @@
 /** 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 = "1.6.0";
+export declare const VERSION = "1.7.0";
 export declare const SERVER_CARD_URI = "mcp-context-card://server-card";
 /** The server's registry identity: reverse-DNS, the same as server.json `name`.
  *  It is also `serverInfo.name`, so a Server Card never contradicts the live

package/dist/constants.js

@@ -1,7 +1,7 @@
 /** 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 = "1.6.0";
+export const VERSION = "1.7.0";
 export const SERVER_CARD_URI = "mcp-context-card://server-card";
 /** The server's registry identity: reverse-DNS, the same as server.json `name`.
  *  It is also `serverInfo.name`, so a Server Card never contradicts the live

package/dist/faf/parse-fafa.js

@@ -50,5 +50,6 @@ function extras(doc) {
         ...(endpoints.length ? { endpoints } : {}),
         ...(skills.length ? { skills } : {}),
         ...(packages.length ? { packages } : {}),
+        ...(typeof cards.accent === "string" && cards.accent.trim() ? { accent: cards.accent.trim() } : {}),
     };
 }

package/dist/faf/types.d.ts

@@ -48,4 +48,6 @@ export interface AgentIdentity {
         registryType: string;
         identifier: string;
     }[];
+    /** The owner's card colour (`.fafa` `metadata.cards.accent`), a hex. Validated when drawn. */
+    accent?: string;
 }

package/dist/render-card.d.ts

@@ -2,7 +2,10 @@ import type { AgentIdentity } from "./faf/types.js";
 export type Theme = "light" | "dark" | "auto";
 export interface CardOptions {
     theme?: Theme;
-    /** CSS hex colour for the accent. Validated; invalid falls back to AAIF. */
+    /**
+     * CSS hex colour for the accent. Validated; invalid is ignored. Wins over the
+     * owner's colour; with neither, the card is drawn in ink (black or white).
+     */
     accent?: string;
     /**
      * Render every AGENTS.md section open. Default: sections collapse to their
@@ -18,14 +21,20 @@ export interface CardOptions {
     /** Business-card view. Default `landscape`; the reader can switch it too. */
     layout?: "landscape" | "portrait";
 }
-/** AAIF brand orange (aaif.io). The default accent. */
+/** AAIF brand orange (aaif.io): this project's own card colour, declared in its `.fafa`. */
 export declare const AAIF_ACCENT = "#FF702D";
-export declare function safeAccent(a?: string): string;
+/** A valid hex colour, or undefined. Nothing else ever reaches the stylesheet. */
+export declare function safeAccent(a?: string): string | undefined;
 /** What the front calls this thing, from where it runs: "MCP server", "A2A agent", or both. */
 export declare function cardKind(id: AgentIdentity | null): string[];
 /** The front's title line: what it is, then its version. Empty when nothing is known. */
 export declare function cardTitle(id: AgentIdentity | null): string;
-/** The front's logo: the first letters of the name's first two words ("mcp-context-card" → "MC"). */
+/**
+ * The front's logo: the first letter of the name's first meaningful word
+ * (generic words like "mcp", "server", "sdk" skipped), plus a second letter
+ * only when it's obvious: a known name (github → GH, typescript → TS) or a
+ * word written with two capitals (GitHub, TypeScript). Never more than two.
+ */
 export declare function cardInitials(name: string): string;
 /** The front's one-liner: the first sentence of the description. */
 export declare function cardOneLiner(id: AgentIdentity | null, max?: number): string;
@@ -56,6 +65,8 @@ export interface BusinessCard {
     }[];
     /** The (i) panel, as already-safe markup. */
     about: string;
+    /** The owner's colour, a hex. None = ink (black or white). */
+    accent?: string;
 }
 /** How to draw a card: the owner's colour and accent, the view, and the flat (print) layout. */
 export type RenderOptions = Pick<CardOptions, "theme" | "accent" | "layout" | "expanded">;

package/dist/render-card.js

@@ -16,18 +16,31 @@ import { parseFafm } from "./memory.js";
 import { resolveIdentity, serverCardMeta, META_NS } from "./identity.js";
 import { PUBLISH_MEMORY_ENV, SERVER_CARD_URI } from "./constants.js";
 import { escapeHtml, renderInline, renderMarkdown, slug } from "./md.js";
-/** AAIF brand orange (aaif.io). The default accent. */
+/** AAIF brand orange (aaif.io): this project's own card colour, declared in its `.fafa`. */
 export const AAIF_ACCENT = "#FF702D";
 const ACCENT_OK = /^#[0-9a-fA-F]{3}(?:[0-9a-fA-F]{3}(?:[0-9a-fA-F]{2})?)?$/;
+/** A valid hex colour, or undefined. Nothing else ever reaches the stylesheet. */
 export function safeAccent(a) {
-    return a && ACCENT_OK.test(a) ? a : AAIF_ACCENT;
+    return a && ACCENT_OK.test(a) ? a : undefined;
 }
+/*
+ * No colour = ink. A card's colour is the owner's to declare (or the reader's
+ * to pass); nothing is guessed. Without one the accent is the card's own ink:
+ * black on a light card, white on a dark one, and the monogram's letter takes
+ * the card colour so it stays readable.
+ */
+const INK_CSS = `
+:root{--accent:#0a0a0a}
+@media (prefers-color-scheme:dark){:root{--accent:#fafafa}}
+.bcard{--accent:var(--fg)}
+.logo{color:var(--card)}
+`;
 const CSS = (accent) => `
 /* The page and the card are themed independently. The page follows the
    viewer's OS. The card is the owner's choice: body[data-theme] (light | dark;
    none = follow the OS), and the reader can switch it with the ◐ toggle (#ink). */
 :root{
-  --accent:${accent};
+  ${accent ? `--accent:${accent};` : ""}
   --page-bg:#f4f4f5;--page-muted:#6b6b70;--page-line:rgba(0,0,0,.09);--page-chip:rgba(0,0,0,.05);
 }
 @media (prefers-color-scheme:dark){
@@ -217,12 +230,26 @@ export function cardTitle(id) {
     return [cardKind(id).join(" · "), id?.agentVersion ? `v${id.agentVersion}` : ""].filter(Boolean).join(" · ");
 }
 /** The front's logo: the first letters of the name's first two words ("mcp-context-card" → "MC"). */
+/** Words that say what kind of thing it is, not whose: never the logo ("mcp-context-card" → C, not M). */
+const GENERIC_WORDS = new Set(["mcp", "server", "servers", "sdk", "agent", "agents", "api", "cli", "app", "tool", "tools", "plugin", "core", "the"]);
+/** Names whose two-letter mark is obvious. */
+const OBVIOUS_MARKS = { github: "GH", gitlab: "GL", typescript: "TS", javascript: "JS" };
+/**
+ * The front's logo: the first letter of the name's first meaningful word
+ * (generic words like "mcp", "server", "sdk" skipped), plus a second letter
+ * only when it's obvious: a known name (github → GH, typescript → TS) or a
+ * word written with two capitals (GitHub, TypeScript). Never more than two.
+ */
 export function cardInitials(name) {
     const words = name.split(/[^\p{L}\p{N}]+/u).filter(Boolean);
-    return words
-        .slice(0, 2)
-        .map((w) => Array.from(w)[0].toUpperCase())
-        .join("");
+    const first = words.find((w) => !GENERIC_WORDS.has(w.toLowerCase())) ?? words[0] ?? "";
+    const known = OBVIOUS_MARKS[first.toLowerCase()];
+    if (known)
+        return known;
+    const capitals = first.match(/\p{Lu}/gu) ?? [];
+    if (capitals.length === 2 && /^\p{Lu}/u.test(first) && /\p{Ll}/u.test(first))
+        return capitals.join("");
+    return (Array.from(first)[0] ?? "").toUpperCase();
 }
 /** The front's one-liner: the first sentence of the description. */
 export function cardOneLiner(id, max = 140) {
@@ -354,12 +381,13 @@ export function readCard(root, opts = {}) {
         chips,
         tabs: tabs.map(([key, label, heading, html]) => ({ key, label, heading, html })),
         about: AGENT_ABOUT,
+        ...(id?.accent ? { accent: id.accent } : {}),
     };
 }
 /** Draw any business card as one self-contained HTML page. */
 export function renderBusinessCard(card, opts = {}) {
     const theme = opts.theme ?? "auto";
-    const accent = safeAccent(opts.accent);
+    const accent = safeAccent(opts.accent) ?? safeAccent(card.accent);
     const portrait = opts.layout === "portrait";
     const flat = !!opts.expanded;
     const { name, title, oneLiner, domain } = card;
@@ -391,7 +419,7 @@ export function renderBusinessCard(card, opts = {}) {
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width,initial-scale=1">
 <title>${escapeHtml(name)} — business card</title>
-<style>${CSS(accent)}${tabCss}</style>
+<style>${CSS(accent)}${accent ? "" : INK_CSS}${tabCss}</style>
 </head>
 <body${flat ? ` class="flat"` : ""}${htmlAttr(theme)}>
 <input type="checkbox" id="flip" class="sr" aria-label="Flip the card">

package/dist/server.js

@@ -62,7 +62,7 @@ function cardOptions(args) {
 }
 const CARD_ARGS = {
     theme: { type: "string", enum: ["light", "dark", "auto"], description: "default: auto" },
-    accent: { type: "string", description: "CSS hex colour, e.g. #FF702D (default: the AAIF palette)" },
+    accent: { type: "string", description: "CSS hex colour, e.g. #0066cc (default: the .fafa metadata.cards.accent, else black/white ink)" },
     expanded: { type: "boolean", description: "render every AGENTS.md section open (default: collapsed)" },
     layout: { type: "string", enum: ["landscape", "portrait"], description: "business-card view (default: landscape)" },
 };

package/docs/MECHANISMS.md

@@ -32,7 +32,7 @@ Streamable HTTP endpoint at `<origin>/mcp` and its protocol versions):
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/v1/server-card.schema.json",
   "name": "io.github.Wolfe-Jam/mcp-context-card",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "title": "MCP Context Card",
   "description": "MCP server for a project's context (AGENTS.md), memory, and identity — base or drop-in extension.",
   "websiteUrl": "https://github.com/Wolfe-Jam/mcp-context-card",
@@ -85,7 +85,7 @@ publisher lists artifacts, each entry keyed by its **media type** (`type`).
 GET /.well-known/ai-catalog.json
 ```
 
-Served from `https://ctx.example.com` (1.6.0, this repo's own files):
+Served from `https://ctx.example.com` (1.7.0, this repo's own files):
 
 ```jsonc
 {

package/docs/card-dark.html

@@ -193,7 +193,7 @@ details.ctx-section>.md{padding:0 0 16px}
   <main class="bcard">
     <div class="faces">
       <section class="face front">
-        <div class="logo" aria-hidden="true">MC</div>
+        <div class="logo" aria-hidden="true">C</div>
         <details class="whatis">
           <summary class="corner tr" title="About this card" aria-label="About this card">i</summary>
           <div class="whatis-panel">
@@ -205,7 +205,7 @@ details.ctx-section>.md{padding:0 0 16px}
         </details>
         <div class="id">
           <h1>mcp-context-card</h1>
-          <p class="title">MCP server · v1.6.0</p>
+          <p class="title">MCP server · v1.7.0</p>
           <p class="oneliner">The essential MCP components for a project's context (AGENTS.md), cross-session memory, and identity</p>
         </div>
         <div class="foot-front"><span class="domain">faf.one</span><div class="pills"><span class="pill">io.github.Wolfe-Jam</span><span class="pill accent">published</span><span class="pill">MIT</span></div></div>
@@ -223,11 +223,11 @@ details.ctx-section>.md{padding:0 0 16px}
           </div>
         </details>
         <div class="tabbar"><label for="t-about">About</label><label for="t-context">Context</label><label for="t-memory">Memory</label><label for="t-discovery">Discovery</label></div>
-        <div class="panes"><div class="pane p-about"><p class="label">About</p><p class="lead">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.</p><table class="kv"><tbody><tr><th>Agent ID</th><td><code>urn:air:faf.one:agent:mcp-context-card</code></td></tr><tr><th>Publisher</th><td>io.github.Wolfe-Jam</td></tr><tr><th>Version</th><td>v1.6.0</td></tr><tr><th>Status</th><td>published</td></tr><tr><th>License</th><td>MIT</td></tr><tr><th>Package (npm)</th><td><code>mcp-context-card</code></td></tr></tbody></table></div><div class="pane p-context"><p class="label">Context — AGENTS.md</p><div class="ctx-nav"><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><button type="button" class="xall" hidden>Expand all</button></div>
+        <div class="panes"><div class="pane p-about"><p class="label">About</p><p class="lead">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.</p><table class="kv"><tbody><tr><th>Agent ID</th><td><code>urn:air:faf.one:agent:mcp-context-card</code></td></tr><tr><th>Publisher</th><td>io.github.Wolfe-Jam</td></tr><tr><th>Version</th><td>v1.7.0</td></tr><tr><th>Status</th><td>published</td></tr><tr><th>License</th><td>MIT</td></tr><tr><th>Package (npm)</th><td><code>mcp-context-card</code></td></tr></tbody></table></div><div class="pane p-context"><p class="label">Context — AGENTS.md</p><div class="ctx-nav"><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><button type="button" class="xall" hidden>Expand all</button></div>
     <div class="ctx-preamble 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></div>
     <div class="ctx-body"><details class="ctx-section" id="setup"><summary>Setup</summary><div class="md"><pre><code class="language-bash">npm ci</code></pre>
-<p>Node 20 or newer. No other system dependencies.</p></div></details><details class="ctx-section" id="build"><summary>Build</summary><div class="md"><pre><code class="language-bash">npm run build       # tsc -p tsconfig.build.json  →  dist/
+<p>Node 22 or newer. No other system dependencies.</p></div></details><details class="ctx-section" id="build"><summary>Build</summary><div class="md"><pre><code class="language-bash">npm run build       # tsc -p tsconfig.build.json  →  dist/
 npm run typecheck   # tsc --noEmit over src/ + test/</code></pre></div></details><details class="ctx-section" id="test"><summary>Test</summary><div class="md"><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

package/docs/card-light.html

@@ -193,7 +193,7 @@ details.ctx-section>.md{padding:0 0 16px}
   <main class="bcard">
     <div class="faces">
       <section class="face front">
-        <div class="logo" aria-hidden="true">MC</div>
+        <div class="logo" aria-hidden="true">C</div>
         <details class="whatis">
           <summary class="corner tr" title="About this card" aria-label="About this card">i</summary>
           <div class="whatis-panel">
@@ -205,7 +205,7 @@ details.ctx-section>.md{padding:0 0 16px}
         </details>
         <div class="id">
           <h1>mcp-context-card</h1>
-          <p class="title">MCP server · v1.6.0</p>
+          <p class="title">MCP server · v1.7.0</p>
           <p class="oneliner">The essential MCP components for a project's context (AGENTS.md), cross-session memory, and identity</p>
         </div>
         <div class="foot-front"><span class="domain">faf.one</span><div class="pills"><span class="pill">io.github.Wolfe-Jam</span><span class="pill accent">published</span><span class="pill">MIT</span></div></div>
@@ -223,11 +223,11 @@ details.ctx-section>.md{padding:0 0 16px}
           </div>
         </details>
         <div class="tabbar"><label for="t-about">About</label><label for="t-context">Context</label><label for="t-memory">Memory</label><label for="t-discovery">Discovery</label></div>
-        <div class="panes"><div class="pane p-about"><p class="label">About</p><p class="lead">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.</p><table class="kv"><tbody><tr><th>Agent ID</th><td><code>urn:air:faf.one:agent:mcp-context-card</code></td></tr><tr><th>Publisher</th><td>io.github.Wolfe-Jam</td></tr><tr><th>Version</th><td>v1.6.0</td></tr><tr><th>Status</th><td>published</td></tr><tr><th>License</th><td>MIT</td></tr><tr><th>Package (npm)</th><td><code>mcp-context-card</code></td></tr></tbody></table></div><div class="pane p-context"><p class="label">Context — AGENTS.md</p><div class="ctx-nav"><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><button type="button" class="xall" hidden>Expand all</button></div>
+        <div class="panes"><div class="pane p-about"><p class="label">About</p><p class="lead">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.</p><table class="kv"><tbody><tr><th>Agent ID</th><td><code>urn:air:faf.one:agent:mcp-context-card</code></td></tr><tr><th>Publisher</th><td>io.github.Wolfe-Jam</td></tr><tr><th>Version</th><td>v1.7.0</td></tr><tr><th>Status</th><td>published</td></tr><tr><th>License</th><td>MIT</td></tr><tr><th>Package (npm)</th><td><code>mcp-context-card</code></td></tr></tbody></table></div><div class="pane p-context"><p class="label">Context — AGENTS.md</p><div class="ctx-nav"><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><button type="button" class="xall" hidden>Expand all</button></div>
     <div class="ctx-preamble 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></div>
     <div class="ctx-body"><details class="ctx-section" id="setup"><summary>Setup</summary><div class="md"><pre><code class="language-bash">npm ci</code></pre>
-<p>Node 20 or newer. No other system dependencies.</p></div></details><details class="ctx-section" id="build"><summary>Build</summary><div class="md"><pre><code class="language-bash">npm run build       # tsc -p tsconfig.build.json  →  dist/
+<p>Node 22 or newer. No other system dependencies.</p></div></details><details class="ctx-section" id="build"><summary>Build</summary><div class="md"><pre><code class="language-bash">npm run build       # tsc -p tsconfig.build.json  →  dist/
 npm run typecheck   # tsc --noEmit over src/ + test/</code></pre></div></details><details class="ctx-section" id="test"><summary>Test</summary><div class="md"><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

package/docs/card.html

@@ -193,7 +193,7 @@ details.ctx-section>.md{padding:0 0 16px}
   <main class="bcard">
     <div class="faces">
       <section class="face front">
-        <div class="logo" aria-hidden="true">MC</div>
+        <div class="logo" aria-hidden="true">C</div>
         <details class="whatis">
           <summary class="corner tr" title="About this card" aria-label="About this card">i</summary>
           <div class="whatis-panel">
@@ -205,7 +205,7 @@ details.ctx-section>.md{padding:0 0 16px}
         </details>
         <div class="id">
           <h1>mcp-context-card</h1>
-          <p class="title">MCP server · v1.6.0</p>
+          <p class="title">MCP server · v1.7.0</p>
           <p class="oneliner">The essential MCP components for a project's context (AGENTS.md), cross-session memory, and identity</p>
         </div>
         <div class="foot-front"><span class="domain">faf.one</span><div class="pills"><span class="pill">io.github.Wolfe-Jam</span><span class="pill accent">published</span><span class="pill">MIT</span></div></div>
@@ -223,11 +223,11 @@ details.ctx-section>.md{padding:0 0 16px}
           </div>
         </details>
         <div class="tabbar"><label for="t-about">About</label><label for="t-context">Context</label><label for="t-memory">Memory</label><label for="t-discovery">Discovery</label></div>
-        <div class="panes"><div class="pane p-about"><p class="label">About</p><p class="lead">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.</p><table class="kv"><tbody><tr><th>Agent ID</th><td><code>urn:air:faf.one:agent:mcp-context-card</code></td></tr><tr><th>Publisher</th><td>io.github.Wolfe-Jam</td></tr><tr><th>Version</th><td>v1.6.0</td></tr><tr><th>Status</th><td>published</td></tr><tr><th>License</th><td>MIT</td></tr><tr><th>Package (npm)</th><td><code>mcp-context-card</code></td></tr></tbody></table></div><div class="pane p-context"><p class="label">Context — AGENTS.md</p><div class="ctx-nav"><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><button type="button" class="xall" hidden>Expand all</button></div>
+        <div class="panes"><div class="pane p-about"><p class="label">About</p><p class="lead">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.</p><table class="kv"><tbody><tr><th>Agent ID</th><td><code>urn:air:faf.one:agent:mcp-context-card</code></td></tr><tr><th>Publisher</th><td>io.github.Wolfe-Jam</td></tr><tr><th>Version</th><td>v1.7.0</td></tr><tr><th>Status</th><td>published</td></tr><tr><th>License</th><td>MIT</td></tr><tr><th>Package (npm)</th><td><code>mcp-context-card</code></td></tr></tbody></table></div><div class="pane p-context"><p class="label">Context — AGENTS.md</p><div class="ctx-nav"><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><button type="button" class="xall" hidden>Expand all</button></div>
     <div class="ctx-preamble 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></div>
     <div class="ctx-body"><details class="ctx-section" id="setup"><summary>Setup</summary><div class="md"><pre><code class="language-bash">npm ci</code></pre>
-<p>Node 20 or newer. No other system dependencies.</p></div></details><details class="ctx-section" id="build"><summary>Build</summary><div class="md"><pre><code class="language-bash">npm run build       # tsc -p tsconfig.build.json  →  dist/
+<p>Node 22 or newer. No other system dependencies.</p></div></details><details class="ctx-section" id="build"><summary>Build</summary><div class="md"><pre><code class="language-bash">npm run build       # tsc -p tsconfig.build.json  →  dist/
 npm run typecheck   # tsc --noEmit over src/ + test/</code></pre></div></details><details class="ctx-section" id="test"><summary>Test</summary><div class="md"><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

package/docs/index.html

@@ -193,7 +193,7 @@ details.ctx-section>.md{padding:0 0 16px}
   <main class="bcard">
     <div class="faces">
       <section class="face front">
-        <div class="logo" aria-hidden="true">MC</div>
+        <div class="logo" aria-hidden="true">C</div>
         <details class="whatis">
           <summary class="corner tr" title="About this card" aria-label="About this card">i</summary>
           <div class="whatis-panel">
@@ -205,7 +205,7 @@ details.ctx-section>.md{padding:0 0 16px}
         </details>
         <div class="id">
           <h1>mcp-context-card</h1>
-          <p class="title">MCP server · v1.6.0</p>
+          <p class="title">MCP server · v1.7.0</p>
           <p class="oneliner">The essential MCP components for a project's context (AGENTS.md), cross-session memory, and identity</p>
         </div>
         <div class="foot-front"><span class="domain">faf.one</span><div class="pills"><span class="pill">io.github.Wolfe-Jam</span><span class="pill accent">published</span><span class="pill">MIT</span></div></div>
@@ -223,11 +223,11 @@ details.ctx-section>.md{padding:0 0 16px}
           </div>
         </details>
         <div class="tabbar"><label for="t-about">About</label><label for="t-context">Context</label><label for="t-memory">Memory</label><label for="t-discovery">Discovery</label></div>
-        <div class="panes"><div class="pane p-about"><p class="label">About</p><p class="lead">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.</p><table class="kv"><tbody><tr><th>Agent ID</th><td><code>urn:air:faf.one:agent:mcp-context-card</code></td></tr><tr><th>Publisher</th><td>io.github.Wolfe-Jam</td></tr><tr><th>Version</th><td>v1.6.0</td></tr><tr><th>Status</th><td>published</td></tr><tr><th>License</th><td>MIT</td></tr><tr><th>Package (npm)</th><td><code>mcp-context-card</code></td></tr></tbody></table></div><div class="pane p-context"><p class="label">Context — AGENTS.md</p><div class="ctx-nav"><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><button type="button" class="xall" hidden>Expand all</button></div>
+        <div class="panes"><div class="pane p-about"><p class="label">About</p><p class="lead">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.</p><table class="kv"><tbody><tr><th>Agent ID</th><td><code>urn:air:faf.one:agent:mcp-context-card</code></td></tr><tr><th>Publisher</th><td>io.github.Wolfe-Jam</td></tr><tr><th>Version</th><td>v1.7.0</td></tr><tr><th>Status</th><td>published</td></tr><tr><th>License</th><td>MIT</td></tr><tr><th>Package (npm)</th><td><code>mcp-context-card</code></td></tr></tbody></table></div><div class="pane p-context"><p class="label">Context — AGENTS.md</p><div class="ctx-nav"><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><button type="button" class="xall" hidden>Expand all</button></div>
     <div class="ctx-preamble 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></div>
     <div class="ctx-body"><details class="ctx-section" id="setup"><summary>Setup</summary><div class="md"><pre><code class="language-bash">npm ci</code></pre>
-<p>Node 20 or newer. No other system dependencies.</p></div></details><details class="ctx-section" id="build"><summary>Build</summary><div class="md"><pre><code class="language-bash">npm run build       # tsc -p tsconfig.build.json  →  dist/
+<p>Node 22 or newer. No other system dependencies.</p></div></details><details class="ctx-section" id="build"><summary>Build</summary><div class="md"><pre><code class="language-bash">npm run build       # tsc -p tsconfig.build.json  →  dist/
 npm run typecheck   # tsc --noEmit over src/ + test/</code></pre></div></details><details class="ctx-section" id="test"><summary>Test</summary><div class="md"><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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-context-card",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "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": [

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.Wolfe-Jam/mcp-context-card",
   "title": "MCP Context Card",
   "description": "MCP server for a project's context (AGENTS.md), memory, and identity — base or drop-in extension.",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "repository": {
     "url": "https://github.com/Wolfe-Jam/mcp-context-card",
     "source": "github"
@@ -14,7 +14,7 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "mcp-context-card",
-      "version": "1.6.0",
+      "version": "1.7.0",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"