@totemsdk/mcp-server 0.3.0 → 0.4.0

package/dist/indexer.js

@@ -310,10 +310,24 @@ function collectExports(file, symbols, visited) {
             const braceMatch = block.match(/\{([^}]+)\}/);
             if (braceMatch) {
                 for (const part of braceMatch[1].split(',')) {
-                    const name = part.trim().split(/\s+as\s+/).pop()?.trim() || '';
-                    if (!name)
+                    let clause = part.trim();
+                    if (!clause)
                         continue;
-                    const kind = isType || /^[A-Z]/.test(name) ? 'type' : 'function';
+                    // Inline type modifiers: `export { type Foo }` / `export { type Foo as Bar }`.
+                    // Strip the leading `type` keyword before resolving the exposed name,
+                    // otherwise the symbol is recorded literally as "type Foo".
+                    let inlineType = false;
+                    const typeKw = clause.match(/^type\s+([\s\S]+)$/);
+                    if (typeKw) {
+                        inlineType = true;
+                        clause = typeKw[1].trim();
+                    }
+                    const name = clause.split(/\s+as\s+/).pop()?.trim() || '';
+                    // Reject anything that isn't a plain identifier (guards against
+                    // malformed fragments leaking in as fake symbols).
+                    if (!/^[A-Za-z_$][\w$]*$/.test(name))
+                        continue;
+                    const kind = isType || inlineType || /^[A-Z]/.test(name) ? 'type' : 'function';
                     setSymbol(symbols, name, { kind });
                 }
             }

package/dist/resources.js

@@ -108,7 +108,12 @@ function docMeta(file, fallbackName) {
         description = t.replace(/[*_`]/g, '').trim();
         break;
     }
-    return { name: name || fallbackName, description: description || name || fallbackName };
+    const clean = description || name || fallbackName;
+    // Cap at the first sentence / ~160 chars. Discovery must stay cheap: an
+    // unbounded first paragraph bloats every client's resource list.
+    const firstSentence = clean.split(/(?<=\.)\s/)[0];
+    const bounded = (firstSentence.length <= 160 ? firstSentence : clean.slice(0, 160)).trim();
+    return { name: name || fallbackName, description: bounded.length > 0 ? bounded : name || fallbackName };
 }
 /**
  * RFCs and audits are discovered from disk, so a new `docs/rfc/RFC-*.md` or
@@ -125,7 +130,14 @@ function discoverDocs() {
                 continue;
             const file = path.join('docs', 'rfc', f);
             const meta = docMeta(file, `RFC-${m[1]}`);
-            docs.push({ uri: `totemsdk://rfc/${m[1]}`, ...meta, file });
+            // Amendments share an RFC number with the original; give them a distinct
+            // URI (`totemsdk://rfc/007/amendment-a`) so a reader never retrieves an
+            // amendment when they asked for the base specification.
+            const amend = m[2].match(/^AMENDMENT-([A-Z])/i);
+            const uri = amend
+                ? `totemsdk://rfc/${m[1]}/amendment-${amend[1].toLowerCase()}`
+                : `totemsdk://rfc/${m[1]}`;
+            docs.push({ uri, ...meta, file });
         }
     }
     const auditDir = path.join(REPO_ROOT, 'docs', 'audits');
@@ -140,6 +152,19 @@ function discoverDocs() {
             docs.push({ uri: `totemsdk://audit/${slug}`, ...meta, file });
         }
     }
+    // Worked, runnable end-to-end scenarios (usually backed by a test under
+    // packages/sdk-tests). Discovered from disk like RFCs/audits.
+    const exampleDir = path.join(REPO_ROOT, 'docs', 'examples');
+    if (fs.existsSync(exampleDir)) {
+        for (const f of fs.readdirSync(exampleDir).sort()) {
+            if (!f.endsWith('.md'))
+                continue;
+            const slug = f.replace(/\.md$/, '');
+            const file = path.join('docs', 'examples', f);
+            const meta = docMeta(file, slug);
+            docs.push({ uri: `totemsdk://example/${slug}`, ...meta, file });
+        }
+    }
     return docs;
 }
 const DOCS = discoverDocs();
@@ -202,7 +227,7 @@ function resourceMimeType(uri) {
     const base = uri.split('#')[0];
     if (base === 'totemsdk://conventions' || base === 'totemsdk://templates')
         return 'text/markdown';
-    if (/^totemsdk:\/\/(papers|rfc|audit)\/[^/]+$/.test(base))
+    if (/^totemsdk:\/\/(papers|rfc|audit|example)\/[^/]+(\/[^/]+)?$/.test(base))
         return 'text/markdown';
     if (base === 'totemsdk://packages' || base === 'totemsdk://domain-map' || base === 'totemsdk://rfc')
         return 'application/json';
@@ -367,10 +392,16 @@ function listResources(index) {
             description: `Dependencies of ${name}`,
         });
     }
-    const topSymbols = Object.entries(index.symbolIndex)
-        .filter(([_, v]) => v.length <= 3)
-        .slice(0, 200);
-    for (const [symbol, entries] of topSymbols) {
+    // Symbol lookups are served by the `search-symbol` tool (query-driven), which
+    // is far cheaper than enumerating ~3.7k symbols as resources. Only surface a
+    // small set of the most unambiguous symbols (exported by exactly one package)
+    // so `totemsdk://symbol/{name}` remains discoverable without bloating
+    // discovery to hundreds of entries.
+    const uniqueSymbols = Object.entries(index.symbolIndex)
+        .filter(([_, v]) => v.length === 1)
+        .sort(([a], [b]) => a.localeCompare(b))
+        .slice(0, 50);
+    for (const [symbol, entries] of uniqueSymbols) {
         resources.push({
             uri: `totemsdk://symbol/${symbol}`,
             name: `Symbol: ${symbol}`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@totemsdk/mcp-server",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "MCP server exposing the full Totem SDK package set — metadata, types, exports, dependency graphs, and scaffolding tools",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",