stylegallery 0.1.11 → 0.1.12

package/scripts/compiler/README.md

@@ -8,11 +8,11 @@ description: Run a separately installed website compiler through the SG CLI and
 
 Primary role: compiler setup and execution reference.
 
-Use `sg compile`, `sg timeline`, and the other commands below directly. The `stylegallery-mcp` server exposes the same names alongside `discover`, `resolve`, `claims`, `context`, `ops`, and `retrieve`. Compiler operations can write files, open websites, and invoke a model; each tool declares those effects. The original [v1 knowledge interface](../../consumer-reference/agent-native/README.md) remains available separately.
+Use `stylegallery compile`, `stylegallery timeline`, and the other commands below directly. The `stylegallery-mcp` server exposes the same names alongside `discover`, `resolve`, `claims`, `context`, `ops`, and `retrieve`. Compiler operations can write files, open websites, and invoke a model; each tool declares those effects. The original [v1 knowledge interface](../../consumer-reference/agent-native/README.md) remains available separately.
 
 ## Setup
 
-Install StyleGallery with Node.js 22 or newer using `npm install --global stylegallery`. For an unreleased StyleGallery checkout, run commands from that checkout as `bun run sg -- <command>` instead. If another program already owns the `sg` command, use the equivalent `stylegallery` executable or the npm script. The compiler is a [separate private repository](https://github.com/changeroa/site-compiler); an account with access must install it once:
+Install StyleGallery with Node.js 22 or newer using `npm install --global stylegallery`. For an unreleased StyleGallery checkout, run commands from that checkout as `bun run stylegallery -- <command>` instead. The compiler is a [separate private repository](https://github.com/changeroa/site-compiler); an account with access must install it once:
 
 ```sh
 gh repo clone changeroa/site-compiler /absolute/path/to/site-compiler
@@ -20,32 +20,32 @@ cd /absolute/path/to/site-compiler
 bun install --frozen-lockfile --ignore-scripts
 bunx playwright install chromium
 export SG_COMPILER_ROOT=/absolute/path/to/site-compiler
-sg discover --format json
+stylegallery discover --format json
 ```
 
 Set `SG_COMPILER_ROOT` in your shell profile for CLI use and in your MCP server environment for MCP use. A CLI invocation can override it with `--compiler-root /absolute/path/to/site-compiler`. `discover` preserves the knowledge response and adds a top-level `compiler` object containing installation status, the actual Git revision, tracked changes, and available operations. Missing compiler setup leaves knowledge queries usable.
 
-The verified upstream revision is declared in [scripts/compiler/operations.mjs](operations.mjs). `matches_verified_revision` is true only for that revision without tracked modifications; a mismatch is reported but does not block execution. Use that revision when reproducing the verified workflow. To use a newer upstream version, update your compiler checkout with `git pull --ff-only` and `npm ci`, then inspect `sg discover` and `sg workflow`; SG does not fetch or upgrade code during a tool call. The compiler source, browser binaries, captured frames, and private pack data are not included in the StyleGallery npm package.
+The verified upstream revision is declared in [scripts/compiler/operations.mjs](operations.mjs). `matches_verified_revision` is true only for that revision without tracked modifications; a mismatch is reported but does not block execution. Use that revision when reproducing the verified workflow. To use a newer upstream version, update your compiler checkout with `git pull --ff-only` and `npm ci`, then inspect `stylegallery discover` and `stylegallery workflow`; SG does not fetch or upgrade code during a tool call. The compiler source, browser binaries, captured frames, and private pack data are not included in the StyleGallery npm package.
 
 ## CLI
 
 Run these from the consumer project's working directory:
 
 ```sh
-sg workflow
-sg workflow --document readme
-sg compile --url https://example.com --out ./captures/example
-sg timeline --url https://example.com --out ./captures/example --step 500 --grow
-sg transcribe --in ./captures --only example
-sg sale --in ./captures/example --out ./captures/example/sale
-sg gate --in ./captures/example --sale ./captures/example/sale --json ./captures/example/qa-report.json
-sg build --packs ./captures --out ./builds --only example
-sg shots --builds ./builds --slug example
+stylegallery workflow
+stylegallery workflow --document readme
+stylegallery compile --url https://example.com --out ./captures/example
+stylegallery timeline --url https://example.com --out ./captures/example --step 500 --grow
+stylegallery transcribe --in ./captures --only example
+stylegallery sale --in ./captures/example --out ./captures/example/sale
+stylegallery gate --in ./captures/example --sale ./captures/example/sale --json ./captures/example/qa-report.json
+stylegallery build --packs ./captures --out ./builds --only example
+stylegallery shots --builds ./builds --slug example
 ```
 
 `compile` captures scenes and frames; it does not produce a SceneBook by itself. A SceneBook describes scene geometry and content; its Timeline companion describes observed scroll behavior. `transcribe` produces these documents. Transcription and the optional sale-preview builder require an installed, authenticated `claude` CLI and can incur model usage. Their input roots contain one subdirectory per pack. Supply `--stylegallery` only when a different SG corpus should be used; the installed StyleGallery package is the default.
 
-Read `sg workflow` before selecting stages. Its installed compiler document owns the task policy: faithful reconstruction, adaptation for a new design, or sale-package production. These are task purposes, not CLI flags. Reconstruction uses available source media and direct observation to fill document gaps; the current implementation agent remains the builder. A media record carries source URLs, responsive variants, reuse or replacement decisions, and playback checks separately from the observation document.
+Read `stylegallery workflow` before selecting stages. Its installed compiler document owns the task policy: faithful reconstruction, adaptation for a new design, or sale-package production. These are task purposes, not CLI flags. Reconstruction uses available source media and direct observation to fill document gaps; the current implementation agent remains the builder. A media record carries source URLs, responsive variants, reuse or replacement decisions, and playback checks separately from the observation document.
 
 `sale` replaces observed copy with structural descriptors. `build` consumes only those sale editions and intentionally restricts original-page and external-media access. It is a package preview, not the faithful-reconstruction route. Use sale, build, and release operations when that package purpose is requested. A document-only evaluation is an explicit experiment, not the default website workflow. The SG skill only retrieves this workflow; it does not duplicate these policies.
 
@@ -70,7 +70,7 @@ By default, `sale` writes its private audit to `copy-audit.private.json` in the
 
 All CLI results are one JSON envelope on stdout, including failures. Child logs are returned in `result.stdout` and `result.stderr`, with a 64 KiB tail per stream and truncation flags. Relative path options resolve from the caller's working directory; upstream scripts execute from the compiler checkout. `pack-release` is the upstream exception with fixed checkout-relative directories, and produces local archives without publishing them.
 
-Use `sg discover` or `sg ops` for the full input schemas. CLI options use hyphens (`--max-height`); MCP inputs use underscores (`max_height`). Unknown options, repeated CLI options, missing required paths, and invalid numeric values fail before execution. `--format json` is optional. `--runner-timeout-ms` bounds the entire process tree, defaults to 30 minutes, and accepts up to six hours; `--timeout-ms` on model operations instead controls upstream per-job timeouts. Interrupting the CLI or cancelling an MCP request terminates its running process tree.
+Use `stylegallery discover` or `stylegallery ops` for the full input schemas. CLI options use hyphens (`--max-height`); MCP inputs use underscores (`max_height`). Unknown options, repeated CLI options, missing required paths, and invalid numeric values fail before execution. `--format json` is optional. `--runner-timeout-ms` bounds the entire process tree, defaults to 30 minutes, and accepts up to six hours; `--timeout-ms` on model operations instead controls upstream per-job timeouts. Interrupting the CLI or cancelling an MCP request terminates its running process tree.
 
 `ok` reports process success. Batch scripts can exit zero with failed individual jobs: use the returned ledger path to inspect each pack. A gate pass is an upstream consistency check, not SG conformance, accessibility proof, or rights clearance. Each result records the compiler revision, tracked-change status, executed script hash, and normalized arguments. Captures and generated documents remain consumer-owned outputs and are not admitted to the governed material registry.
 
@@ -90,7 +90,7 @@ Use `sg discover` or `sg ops` for the full input schemas. CLI options use hyphen
 
 Call `compile` with `{"url":"https://example.com","out":"/absolute/path/to/captures/example"}` or `gate` with `{"in":"/absolute/path/to/captures/example"}`. Prefer absolute paths because the MCP client's launch directory may differ from your terminal. Long captures require a client request timeout longer than the capture; the runner's timeout does not change client settings. `workflow` and the knowledge tools are read-only; execution tools are marked as potentially destructive and non-idempotent because existing artifacts may be replaced.
 
-From the StyleGallery checkout, use `bun run sg -- compile ...` and `bun run sg:mcp` for local development. To connect an MCP client to that unreleased checkout, use `"command": "node"` and `"args": ["/absolute/path/to/StyleGallery/scripts/sg-server.mjs"]` with the same environment settings. The frozen six-tool v1 server is `bun run sg:mcp:v1`, and its CLI is `bun run sg:v1 -- ...`.
+From the StyleGallery checkout, use `bun run stylegallery -- compile ...` and `bun run sg:mcp` for local development. To connect an MCP client to that unreleased checkout, use `"command": "node"` and `"args": ["/absolute/path/to/StyleGallery/scripts/sg-server.mjs"]` with the same environment settings. The frozen six-tool v1 server is `bun run sg:mcp:v1`, and its CLI is `bun run sg:v1 -- ...`.
 
 ## Contracts And Verification
 

package/scripts/compiler/mcp.mjs

@@ -6,6 +6,40 @@ import { agentNativeRegistry } from "../agent-native/registry.mjs";
 import { compilerOperations, compilerToolDefinitions } from "./operations.mjs";
 import { withCompilerDiscovery } from "./cli.mjs";
 import { executeCompiler, failure } from "./runtime.mjs";
+import { materialRuntimeOptions } from "../agent-native/v2/material-cli-adapter.mjs";
+import { invokeSearchOperation } from "../agent-native/v2/material-search-v3.mjs";
+
+const readOnly = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
+export const searchToolDefinitions = Object.freeze([
+  {
+    name: "search",
+    description: "Search the StyleGallery Markdown corpus (layout patterns, recipes, motion, design engineering, platform guides, terminology, expression). Offline BM25F ranking. Returns light results: id, path, title, description, a verbatim snippet, and the next read command. When the question is not in English, also pass query_en with an English rewrite; Korean-only queries match only documents with Korean aliases.",
+    inputSchema: {
+      type: "object", additionalProperties: false, required: ["query"],
+      properties: {
+        query: { type: "string", description: "The question or keywords, in any language." },
+        query_en: { type: "string", description: "English rewrite of query. Strongly recommended when query is not English." },
+        limit: { type: "integer", minimum: 1, maximum: 50, default: 5 },
+        paths_only: { type: "boolean", description: "Return repository-relative paths only." },
+        response_format: { type: "string", enum: ["concise", "detailed"], default: "concise", description: "detailed adds scores, hash identities, and ranking terms." },
+      },
+    },
+    annotations: readOnly,
+  },
+  {
+    name: "read",
+    description: "Read one StyleGallery document by id (for example sg:layout/sticky-header), repository path, or StableRef. Use outline to list section slugs, then section to read only that part.",
+    inputSchema: {
+      type: "object", additionalProperties: false, required: ["reference"],
+      properties: {
+        reference: { type: "string" },
+        outline: { type: "boolean" },
+        section: { type: "string", description: "Heading slug from outline." },
+      },
+    },
+    annotations: readOnly,
+  },
+]);
 
 // Compose at the transport boundary. The byte-frozen v1 server, registry,
 // conformance receipts, and resources remain independently usable.
@@ -28,7 +62,7 @@ export function createSgMcpServer(config = {}) {
     };
   });
   server.server.setRequestHandler(ListToolsRequestSchema, async () => ({
-    tools: [...legacyTools, ...compilerToolDefinitions()].sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0),
+    tools: [...legacyTools, ...compilerToolDefinitions(), ...searchToolDefinitions].sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0),
   }));
   const callSchema = CallToolRequestSchema.extend({
     params: CallToolRequestSchema.shape.params.extend({ arguments: z.unknown().optional() }),
@@ -37,7 +71,9 @@ export function createSgMcpServer(config = {}) {
     const operation = request.params.name;
     let input = request.params.arguments ?? {};
     let report;
-    if (Object.hasOwn(compilerOperations, operation) || operation === "workflow") {
+    if (operation === "search" || operation === "read") {
+      report = invokeSearchOperation(operation, input, materialRuntimeOptions());
+    } else if (Object.hasOwn(compilerOperations, operation) || operation === "workflow") {
       const signals = [lifetime.signal, extra.signal, config.signal].filter(Boolean);
       report = await executeCompiler(operation, input, { ...config, signal: AbortSignal.any(signals) });
     } else if (legacyByName.has(operation)) {

package/scripts/legacy-sg-material-mcp.mjs

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+// Old bin name `stylegallery-material-mcp`: notice on stderr, then serve unchanged for 0.1.12 only.
+import { main } from "./sg-material-mcp.mjs";
+
+process.stderr.write("stylegallery-material-mcp is renamed: use stylegallery-mcp (tools: search, read). This old name will be removed in the next release.\n");
+await main().catch((error) => {
+  process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+  process.exitCode = 1;
+});

package/scripts/legacy-sg-material.mjs

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+// Old bin names `sg-material` and `stylegallery-material`: notice, then delegate for 0.1.12 only.
+process.stderr.write("sg-material is renamed to `stylegallery` (stylegallery search, stylegallery read, stylegallery context --query). This old name will be removed in the next release.\n");
+await import("./sg-material.mjs");

package/scripts/pattern-data.mjs

@@ -323,3 +323,412 @@ export const patterns = [
   ["masonry-approx", "Grid / Repetition", "Approximate staggered content with columns when exact row alignment is not needed.", "block", "fluid", sources.mdnCookbook, [[".masonry_approx", { "column-gap": "1rem", "column-width": "14rem" }]]],
   ["main-with-rail", "Split / Sidebar", "Keep primary content dominant with a narrow secondary rail.", "inline", "reflow", sources.govukLayout, [[".main_with_rail", { display: "grid", gap: "1rem", "grid-template-columns": "repeat(auto-fit, minmax(min(18rem, 100%), 1fr))" }], [".main_with_rail_main", { "min-inline-size": "0" }], [".main_with_rail_side", { "min-inline-size": "0" }]]],
 ];
+
+// Search-only metadata: English and Korean names an agent may use for each pattern,
+// and questions the pattern's sections answer. Emitted as frontmatter aliases/questions.
+export const searchMetadata = {
+  "sticky-header": {
+    "aliases": [
+            "pinned top bar",
+      "sticky top navigation",
+      "헤더 고정",
+      "고정 헤더",
+      "상단 고정 메뉴"
+    ],
+    "questions": [
+      "How do I keep the header visible while the page scrolls?"
+    ]
+  },
+  "sticky-footer": {
+    "aliases": [
+      "footer at bottom",
+      "push footer down",
+      "푸터 고정",
+      "하단 푸터",
+      "푸터를 화면 아래에 붙이기"
+    ],
+    "questions": [
+      "How do I keep the footer at the bottom when content is short?"
+    ]
+  },
+  "scroll-body-shell": {
+    "aliases": [
+      "fixed header and footer with scrolling body",
+      "app shell",
+      "스크롤 영역",
+      "본문만 스크롤"
+    ],
+    "questions": [
+      "How do I make only the body scroll between a fixed header and footer?"
+    ]
+  },
+  "fixed-sidenav-shell": {
+    "aliases": [
+      "fixed side navigation",
+      "sidenav shell",
+      "고정 사이드 내비게이션",
+      "사이드바 레이아웃",
+      "고정 사이드바"
+    ],
+    "questions": [
+      "How do I keep side navigation fixed while the main content scrolls?"
+    ]
+  },
+  "holy-grail": {
+    "aliases": [
+      "header footer two sidebars",
+      "three column page layout",
+      "홀리 그레일 레이아웃",
+      "3단 레이아웃"
+    ],
+    "questions": [
+      "How do I lay out a header, footer, two sidebars, and main content?"
+    ]
+  },
+  "cover": {
+    "aliases": [
+      "full height hero",
+      "vertically centered hero",
+      "커버 레이아웃",
+      "전체 높이 히어로"
+    ]
+  },
+  "panel-layout": {
+    "aliases": [
+      "main and utility panels",
+      "패널 레이아웃"
+    ]
+  },
+  "sidebar": {
+    "aliases": [
+      "wrapping sidebar",
+      "intrinsic sidebar",
+      "사이드바",
+      "사이드바 레이아웃"
+    ],
+    "questions": [
+      "How do I make a sidebar wrap under the content when space is tight?"
+    ]
+  },
+  "sticky-aside": {
+    "aliases": [
+      "sticky sidebar",
+      "sticky table of contents",
+      "고정 사이드 영역",
+      "스티키 사이드바"
+    ],
+    "questions": [
+      "How do I keep an aside visible during long reads?"
+    ]
+  },
+  "switcher": {
+    "aliases": [
+      "row to stack without media query",
+      "flex switcher",
+      "가로 세로 전환"
+    ],
+    "questions": [
+      "How do I switch equal regions from a row to a stack without a breakpoint?"
+    ]
+  },
+  "list-detail": {
+    "aliases": [
+      "master detail",
+      "list and detail panes",
+      "목록 상세",
+      "리스트 디테일"
+    ]
+  },
+  "split-screen": {
+    "aliases": [
+      "two column split",
+      "50/50 split",
+      "화면 분할",
+      "2단 분할"
+    ]
+  },
+  "main-with-rail": {
+    "aliases": [
+      "content with right rail",
+      "secondary rail",
+      "메인과 보조 레일"
+    ]
+  },
+  "media-object": {
+    "aliases": [
+      "image beside text",
+      "avatar with text",
+      "미디어 오브젝트",
+      "이미지와 텍스트 나란히"
+    ]
+  },
+  "supporting-pane": {
+    "aliases": [
+      "supporting panel",
+      "보조 패널"
+    ]
+  },
+  "ram-grid": {
+    "aliases": [
+      "repeat auto-fit minmax",
+      "responsive grid without media queries",
+      "auto-fit grid",
+      "반응형 그리드",
+      "반응형 카드 그리드"
+    ],
+    "questions": [
+      "How do I make a grid that fits as many columns as space allows without media queries?"
+    ]
+  },
+  "card-grid": {
+    "aliases": [
+      "responsive card grid",
+      "cards in rows and columns",
+      "카드 그리드",
+      "반응형 카드 그리드",
+      "카드 목록"
+    ],
+    "questions": [
+      "How do I align repeating cards into a responsive grid?"
+    ]
+  },
+  "dense-grid": {
+    "aliases": [
+      "compact grid",
+      "grid-auto-flow dense",
+      "촘촘한 그리드"
+    ]
+  },
+  "twelve-span-grid": {
+    "aliases": [
+      "12 column grid",
+      "twelve column layout",
+      "12단 그리드"
+    ]
+  },
+  "page-grid": {
+    "aliases": [
+      "page margins and gutters",
+      "central content track",
+      "페이지 그리드"
+    ]
+  },
+  "grid-wrapper": {
+    "aliases": [
+      "full bleed breakout",
+      "full-width breakout",
+      "풀 블리드",
+      "전체 폭 확장"
+    ]
+  },
+  "columns": {
+    "aliases": [
+      "multi-column text",
+      "css columns",
+      "다단 텍스트"
+    ]
+  },
+  "masonry-approx": {
+    "aliases": [
+      "masonry",
+      "pinterest style",
+      "staggered layout",
+      "메이슨리",
+      "핀터레스트 스타일"
+    ]
+  },
+  "reel": {
+    "aliases": [
+      "horizontal scroll row",
+      "carousel row",
+      "scrollable row",
+      "가로 스크롤",
+      "가로 스크롤 목록"
+    ],
+    "questions": [
+      "How do I make a row scroll horizontally instead of wrapping?"
+    ]
+  },
+  "cluster": {
+    "aliases": [
+      "inline group that wraps",
+      "tag group",
+      "항목 묶음",
+      "줄바꿈 그룹"
+    ]
+  },
+  "breadcrumb": {
+    "aliases": [
+      "breadcrumbs",
+      "hierarchy links",
+      "브레드크럼",
+      "경로 표시"
+    ]
+  },
+  "pagination": {
+    "aliases": [
+      "page numbers",
+      "page controls",
+      "페이지네이션",
+      "페이지 번호"
+    ]
+  },
+  "tab-strip": {
+    "aliases": [
+      "tabs row",
+      "tab bar",
+      "탭 바",
+      "탭 메뉴"
+    ]
+  },
+  "split-nav": {
+    "aliases": [
+      "navbar with left and right items",
+      "primary and secondary nav",
+      "내비게이션 바",
+      "좌우 분리 내비게이션"
+    ]
+  },
+  "wrap-row": {
+    "aliases": [
+      "wrapping toolbar",
+      "button row that wraps",
+      "버튼 줄바꿈"
+    ]
+  },
+  "badge-list": {
+    "aliases": [
+      "tags with counts",
+      "labels with trailing counts",
+      "배지 목록",
+      "개수 표시 목록"
+    ]
+  },
+  "deconstructed-pancake": {
+    "aliases": [
+      "cards stretch then stack",
+      "flex wrap cards",
+      "카드 가로 배치 후 세로 쌓기"
+    ]
+  },
+  "stack": {
+    "aliases": [
+      "vertical rhythm",
+      "vertical spacing between children",
+      "스택",
+      "세로 간격"
+    ]
+  },
+  "feed": {
+    "aliases": [
+      "content feed",
+      "activity feed",
+      "피드"
+    ]
+  },
+  "line-up": {
+    "aliases": [
+      "equal height cards",
+      "buttons aligned at bottom",
+      "card footer alignment",
+      "카드 버튼 하단 정렬"
+    ],
+    "questions": [
+      "How do I align card footer actions at the bottom?"
+    ]
+  },
+  "step-nav": {
+    "aliases": [
+      "stepper",
+      "steps list",
+      "단계 표시",
+      "스텝 내비게이션"
+    ]
+  },
+  "center": {
+    "aliases": [
+      "center horizontally",
+      "max width centered",
+      "가운데 정렬",
+      "수평 가운데 정렬"
+    ]
+  },
+  "super-center": {
+    "aliases": [
+      "center horizontally and vertically",
+      "center a div",
+      "place-items center",
+      "가운데 정렬",
+      "정중앙 정렬"
+    ],
+    "questions": [
+      "How do I center an element both horizontally and vertically?"
+    ]
+  },
+  "box": {
+    "aliases": [
+      "padded box",
+      "내부 여백 박스"
+    ]
+  },
+  "clamped-card": {
+    "aliases": [
+      "card max width clamp",
+      "카드 폭 제한"
+    ]
+  },
+  "content-limiter": {
+    "aliases": [
+      "readable line length",
+      "max measure",
+      "prose width",
+      "읽기 좋은 줄 길이",
+      "본문 폭 제한"
+    ],
+    "questions": [
+      "How do I keep prose at a readable line length?"
+    ]
+  },
+  "fluid-styles": {
+    "aliases": [
+      "fluid width with max",
+      "유동 폭"
+    ]
+  },
+  "frame": {
+    "aliases": [
+      "aspect ratio box",
+      "responsive image slot",
+      "object-fit",
+      "이미지 비율 유지",
+      "종횡비"
+    ],
+    "questions": [
+      "How do I keep media at a fixed aspect ratio?"
+    ]
+  },
+  "icon-frame": {
+    "aliases": [
+      "icon slot",
+      "square icon box",
+      "아이콘 정렬"
+    ]
+  },
+  "imposter": {
+    "aliases": [
+      "overlay over parent",
+      "positioned overlay",
+      "modal over card",
+      "오버레이",
+      "겹쳐 띄우기"
+    ]
+  },
+  "overlay-stack": {
+    "aliases": [
+      "stack in one grid cell",
+      "text over image",
+      "겹치는 레이어",
+      "이미지 위 텍스트"
+    ]
+  }
+};

package/scripts/sg-entry.mjs

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 
 try {
-  const { runSgCli } = await import("./compiler/cli.mjs");
+  const { runStylegalleryCli } = await import("./stylegallery-cli.mjs");
   const controller = new AbortController();
   const cancel = () => controller.abort();
   process.once("SIGINT", cancel);
   process.once("SIGTERM", cancel);
   try {
-    const result = await runSgCli(process.argv.slice(2), { signal: controller.signal });
+    const result = await runStylegalleryCli(process.argv.slice(2), { signal: controller.signal });
     process.stdout.write(result.output);
     process.exitCode = result.exitCode;
   } finally {

package/scripts/sg-material-mcp.mjs

@@ -54,7 +54,7 @@ export class MaterialMcpStdin extends Transform {
   }
 }
 
-async function main() {
+export async function main() {
   const server = createMaterialMcpServer();
   const input = new MaterialMcpStdin();
   const transport = new StdioServerTransport(input);