@handamade/psi-mcp 0.24.0 → 0.25.0

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import type { PsiIndex } from "./types.js";
 export type { PsiIndex, ComponentEntry, TokenEntry, PropDoc, PatternEntry, PatternNode, PatternParameter, } from "./types.js";
 export { buildIndex, GETTING_STARTED } from "./index-builder.js";
 export { createStore } from "./store.js";
-export type { Store, Brief, Detail } from "./store.js";
+export type { Store, Brief, OverviewPatternBrief, SearchBrief, Detail } from "./store.js";
 export { createPsiServer } from "./server.js";
 /** Loads the index baked next to the compiled module at publish time. */
 export declare function loadIndex(): Promise<PsiIndex>;

package/dist/psi-index.json

@@ -1,5 +1,5 @@
 {
- "version": "0.24.0",
+ "version": "0.25.0",
  "themes": [
   "light",
   "dark",

package/dist/store.d.ts

@@ -5,6 +5,14 @@ export interface Brief {
     title: string;
     summary: string;
 }
+/** A pattern row in the empty-query overview: a `Brief` without `title`,
+ * which for a pattern only repeats the id after `pattern:` (D100). At the
+ * derived intro cap of 0 the title was a quarter of the row, and the row is
+ * all the overview can no longer shorten. */
+export type OverviewPatternBrief = Omit<Brief, "title">;
+/** What `search()` returns: stored briefs for a keyword query; for the empty
+ * query, the overview, where pattern rows are `OverviewPatternBrief`. */
+export type SearchBrief = Brief | OverviewPatternBrief;
 export type Detail = ({
     kind: "component";
 } & ComponentEntry) | ({
@@ -17,7 +25,7 @@ export type Detail = ({
     content: unknown;
 };
 export interface Store {
-    search(query: string): Brief[];
+    search(query: string): SearchBrief[];
     get(id: string): Detail | null;
 }
 export declare function createStore(index: PsiIndex): Store;

package/dist/store.js

@@ -93,24 +93,26 @@ function overviewPatternSummary(p, limit) {
     const intro = truncateAtWord(`${p.intent} — ${p.match.join(", ")}, ${p.parameters.length} parameters`, limit);
     return p.blocked ? `${intro}, blocked (gaps: ${p.gaps.join(", ")})` : intro;
 }
+const PATTERN_PREFIX = "pattern:";
 export function createStore(index) {
     const patternsById = new Map(index.patterns.map((p) => [p.id, p]));
     /** Overview-only projection: returns `b` unchanged for every kind except
      * pattern, where it re-derives the summary from the underlying
      * `PatternEntry` (via `overviewPatternSummary`) rather than slicing the
      * already-assembled, full-length `Brief.summary` — so the `blocked (gaps:
-     * …)` tail always survives the overview's trim. Always a shallow copy for
-     * patterns: the stored brief kept in `briefs` (and used by score()) is
-     * never mutated. `limit` is derived per-call by the empty-query branch
+     * …)` tail always survives the overview's trim. A pattern row is a new
+     * `{id, kind, summary}` object with no `title`, which would only repeat
+     * the id (D100); the stored brief kept in `briefs` (and used by score())
+     * is never mutated. `limit` is derived per-call by the empty-query branch
      * (D61), not a module constant, so a growing catalog shortens summaries
      * instead of evicting items. */
     function overviewBrief(b, limit) {
         if (b.kind !== "pattern")
             return b;
-        const pattern = patternsById.get(b.title);
+        const pattern = patternsById.get(b.id.slice(PATTERN_PREFIX.length));
         if (!pattern)
             return b;
-        return { ...b, summary: overviewPatternSummary(pattern, limit) };
+        return { id: b.id, kind: b.kind, summary: overviewPatternSummary(pattern, limit) };
     }
     const briefs = [
         ...index.components.map((c) => ({
@@ -120,7 +122,7 @@ export function createStore(index) {
             summary: componentSummary(c),
         })),
         ...index.patterns.map((p) => ({
-            id: `pattern:${p.id}`,
+            id: `${PATTERN_PREFIX}${p.id}`,
             kind: "pattern",
             title: p.id,
             summary: patternSummary(p),

package/llms.txt

@@ -1,7 +1,7 @@
 # @handamade/psi-mcp — MCP access to Psi (Ψ)
 
 Two read-only tools over a baked index of the generated artifacts:
-- search(query): briefs {id, kind, title, summary}; empty query = overview
+- search(query): briefs {id, kind, title, summary}; empty query = overview, where pattern rows are {id, kind, summary} (the id names the pattern, D100)
 - get(id): component (props/defaults/a11y doc) | token (formula + OKLCH/hex per theme) | topic (guidance) | pattern (compose tree, clarifying parameters, content, gaps/blocked status, preset JSX)
 Ids: component:<Name>, token:<name>, topic:<key>, pattern:<id>; bare names resolve case-insensitively.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@handamade/psi-mcp",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "license": "MIT",
   "description": "MCP server and agent-context generator for the Psi (Ψ) design system",
   "type": "module",
@@ -33,8 +33,8 @@
     "tsx": "^4.22.4",
     "typescript": "^5.7.0",
     "vitest": "^3.2.6",
-    "@handamade/psi-tokens": "0.24.0",
-    "@handamade/psi-react": "0.24.0"
+    "@handamade/psi-tokens": "0.25.0",
+    "@handamade/psi-react": "0.25.0"
   },
   "scripts": {
     "build": "tsx scripts/build-index.ts && tsc -p tsconfig.build.json"