@aws/nx-plugin 0.107.0 → 0.108.0

package/src/mcp-server/generator-info.js

@@ -1,28 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.postProcessGuide = exports.fetchSnippet = exports.fetchGuidePages = exports.fetchGuidePagesForGenerator = exports.renderGeneratorInfo = exports.buildNxCommand = void 0;
+exports.postProcessGuide = exports.fetchSnippet = exports.fetchGuidePages = exports.fetchGuideFrontmatters = exports.fetchGuidePagesForGenerator = exports.renderFilterableOptionsAsync = exports.loadFilterableOptionsFromSchema = exports.renderGeneratorInfo = exports.buildNxCommand = void 0;
 const tslib_1 = require("tslib");
 /**
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 const names_1 = require("../utils/names");
-const commands_1 = require("../utils/commands");
+const option_filter_1 = require("./option-filter");
+const guide_render_1 = require("./guide-render");
+const guide_pipeline_1 = require("./guide-pipeline");
+const mdx_ast_1 = require("./mdx-ast");
+const schema_registry_1 = require("./schema-registry");
 const fs_1 = tslib_1.__importDefault(require("fs"));
-/**
- * Build a command to run nx
- */
-const buildNxCommand = (command, pm) => pm ? (0, commands_1.buildPackageManagerExecCommand)(pm, `nx ${command}`) : `nx ${command}`;
-exports.buildNxCommand = buildNxCommand;
-const renderSchema = (schema) => Object.entries(schema.properties)
-    .map(([parameter, parameterSchema]) => `- ${parameter} [type: ${parameterSchema.type}]${parameterSchema.enum ? ` [options: ${parameterSchema.enum.join(', ')}]` : ''}${(schema.required ?? []).includes(parameter) ? ` (required)` : ''} ${parameterSchema.description}`)
-    .join('\n');
-const renderGeneratorCommand = (generatorId, schema, packageManager) => `\`\`\`bash
-${(0, exports.buildNxCommand)(`g @aws/nx-plugin:${generatorId} --no-interactive ${Object.entries(schema.properties)
-    .filter(([parameter]) => (schema.required ?? []).includes(parameter))
-    .map(([parameter]) => `--${parameter}=<${parameter}>`)
-    .join(' ')}`, packageManager)}
-\`\`\``;
+const path_1 = tslib_1.__importDefault(require("path"));
+// Re-export so existing callers of `generator-info` continue working.
+var guide_render_2 = require("./guide-render");
+Object.defineProperty(exports, "buildNxCommand", { enumerable: true, get: function () { return guide_render_2.buildNxCommand; } });
 /**
  * Render summary information about a generator
  */
@@ -33,37 +27,322 @@ const renderGeneratorInfo = (packageManager, info) => {
 Description: ${info.description}
 
 Available Parameters:
-${renderSchema(schema)}
+${(0, guide_render_1.renderSchema)(schema)}
 
 Command:
-${renderGeneratorCommand(info.id, schema, packageManager)}
+${(0, guide_render_1.renderGeneratorCommand)(info.id, schema, packageManager)}
 `;
 };
 exports.renderGeneratorInfo = renderGeneratorInfo;
 /**
- * Retrieve the markdown guide pages for a generator from github.
- * If the generator has guidePages in generators.json we fetch all of those, otherwise we
- * try to fetch a guide with the generator name kebab-cased.
+ * Enum properties from the generator's JSON schema — the options a user
+ * could pass on the CLI. Agents use this list to pick `options` values
+ * when calling `generator-guide`.
+ *
+ * Multi-variant generators (e.g. `connection`) layer additional keys on
+ * top via each guide page's `when:` frontmatter — merged in by
+ * `collectFrontmatterFilterableOptions` / `renderFilterableOptionsAsync`.
+ */
+const loadFilterableOptionsFromSchema = (info) => {
+    try {
+        const schema = JSON.parse(fs_1.default.readFileSync(info.resolvedSchemaPath, 'utf-8'));
+        return (0, schema_registry_1.filterableOptionsFromSchema)(schema);
+    }
+    catch {
+        return [];
+    }
+};
+exports.loadFilterableOptionsFromSchema = loadFilterableOptionsFromSchema;
+/**
+ * Look at the `when:` frontmatter of every guide page belonging to a
+ * generator and add any keys not already surfaced via the JSON schema.
+ * This lets the `connection` generator advertise `sourceType` /
+ * `targetType` / `protocol` without touching `generators.json`.
+ */
+const collectFrontmatterFilterableOptions = (fetched, fromSchema) => {
+    const extras = new Map();
+    for (const guide of fetched) {
+        const when = guide.frontmatter.when;
+        if (!when)
+            continue;
+        for (const [key, rawValues] of Object.entries(when)) {
+            const bucket = extras.get(key) ?? new Set();
+            for (const v of rawValues)
+                bucket.add(v);
+            extras.set(key, bucket);
+        }
+    }
+    const out = [];
+    const seen = new Set(fromSchema.map((o) => o.key));
+    for (const [key, values] of extras) {
+        if (seen.has(key))
+            continue;
+        out.push({ key, enum: [...values] });
+    }
+    return out;
+};
+/**
+ * Decide whether the agent-supplied `options` describe a combination the
+ * generator actually supports. Returns undefined when the combination is
+ * fine (including when the agent hasn't narrowed enough to decide) and a
+ * human-readable explanation otherwise.
+ *
+ * Supported combinations are inferred from the union of `when:` predicates
+ * across a generator's guide pages. A generator with no `when:` predicates
+ * on any of its pages (the common case — `ts#trpc-api`, `py#fast-api` …)
+ * opts out of the check automatically.
+ */
+const describeUnsupportedCombinationFromFetched = (info, fetched, options) => {
+    if (!options)
+        return undefined;
+    const predicates = fetched
+        .map((g) => g.frontmatter.when)
+        .filter((w) => w !== undefined);
+    if (predicates.length === 0)
+        return undefined;
+    // Consider only the option keys that actually participate in at least
+    // one predicate — other options (e.g. schema enums) are orthogonal.
+    const predicateKeys = new Set();
+    for (const p of predicates)
+        for (const k of Object.keys(p))
+            predicateKeys.add(k);
+    const suppliedPredicateKeys = [...predicateKeys].filter((k) => options[k] !== undefined);
+    if (suppliedPredicateKeys.length === 0)
+        return undefined;
+    // If any predicate is still reachable given the keys the agent has
+    // committed to so far, treat this as a partial (valid) selection and
+    // skip the warning — the agent can keep narrowing.
+    const stillReachable = predicates.some((pred) => suppliedPredicateKeys.every((k) => {
+        const values = pred[k];
+        if (values === undefined)
+            return true; // predicate doesn't care about this key
+        return values.includes(options[k]);
+    }));
+    if (stillReachable)
+        return undefined;
+    return renderUnsupportedMessage(info, options, predicates);
+};
+const renderUnsupportedMessage = (info, requested, predicates) => {
+    const requestedDesc = Object.entries(requested)
+        .map(([k, v]) => `${k} = ${v}`)
+        .join(', ');
+    const supportedList = predicates
+        .map((pred) => {
+        const parts = Object.entries(pred).map(([k, vs]) => `${k} = ${vs.join(' | ')}`);
+        return `- ${parts.join(', ')}`;
+    })
+        .join('\n');
+    return `## ${info.id}
+
+> [!WARNING] Unsupported combination: ${requestedDesc}. The \`${info.id}\` generator has no guide variant matching this combination — running it will likely fail.
+
+Supported combinations:
+${supportedList}
+
+Pick a combination from the list above, or choose a different generator.`;
+};
+/**
+ * Render the "Filterable options" block that list-generators emits for each
+ * generator. Only keys the guide pages actually branch on are included —
+ * enum properties the schema exposes but no guide filters on are omitted
+ * so agents don't waste tokens setting options that won't affect the
+ * returned content.
+ *
+ * Keys come from two sources:
+ *   - Schema enums, intersected with keys referenced by
+ *     `<OptionFilter when>` / `<TabItem _filter>` across the generator's
+ *     guide pages.
+ *   - Per-page `when:` frontmatter blocks (multi-variant generators like
+ *     `connection`).
+ */
+const renderFilterableOptionsAsync = async (info) => {
+    const fetched = await (0, exports.fetchGuideFrontmatters)(info);
+    const referenced = new Set();
+    for (const g of fetched) {
+        for (const k of g.referencedKeys)
+            referenced.add(k);
+    }
+    const schemaOptions = (0, exports.loadFilterableOptionsFromSchema)(info).filter((o) => referenced.has(o.key));
+    const frontmatterOptions = collectFrontmatterFilterableOptions(fetched, schemaOptions);
+    return formatFilterableOptions(info, [
+        ...schemaOptions,
+        ...frontmatterOptions,
+    ]);
+};
+exports.renderFilterableOptionsAsync = renderFilterableOptionsAsync;
+const formatFilterableOptions = (_info, filterable) => {
+    if (filterable.length === 0)
+        return '';
+    const entries = filterable
+        .map((opt) => {
+        const def = opt.default ? ` (default: ${opt.default})` : '';
+        return `- ${opt.key}: ${opt.enum.join(' | ')}${def}`;
+    })
+        .join('\n');
+    return `\`generator-guide\` options:\n${entries}`;
+};
+/**
+ * Retrieve the markdown guide pages for a generator.
+ *
+ * Every page listed in `guidePages` (or the kebab-cased generator id when
+ * that field is absent) is fetched in parallel — local files first, GitHub
+ * fallback — and its YAML frontmatter is parsed to pick up any `when:`
+ * predicate. Pages without a `when:` are always included; pages with a
+ * `when:` are included when either:
+ *   - `options` is absent (agent hasn't narrowed yet — keep every variant),
+ *     or
+ *   - the predicate matches `options` using the same semantics as
+ *     `<OptionFilter when={{…}}>` (AND across keys, OR within a key).
+ *
+ * If the agent has supplied enough options to identify a combination and
+ * no variant page matches, the result is `{ kind: 'unsupported' }` and the
+ * caller surfaces the warning directly.
  */
-const fetchGuidePagesForGenerator = async (info, generators, packageManager, snippetContentProvider) => {
-    return await (0, exports.fetchGuidePages)(info.guidePages ?? [(0, names_1.kebabCase)(info.id)], generators, packageManager, snippetContentProvider);
+const fetchGuidePagesForGenerator = async (info, generators, packageManager, snippetContentProvider, options) => {
+    const fetched = await (0, exports.fetchGuideFrontmatters)(info);
+    const unsupported = describeUnsupportedCombinationFromFetched(info, fetched, options);
+    if (unsupported !== undefined) {
+        return { kind: 'unsupported', content: unsupported };
+    }
+    const kept = fetched.filter((g) => {
+        if (!g.frontmatter.when)
+            return true;
+        if (!options)
+            return true;
+        return (0, option_filter_1.evaluatePredicate)(g.frontmatter.when, false, options);
+    });
+    const processed = await Promise.all(kept.map((g) => (0, exports.postProcessGuide)(g.body, generators, packageManager, snippetContentProvider, options)));
+    return { kind: 'ok', content: processed.join('\n\n') };
 };
 exports.fetchGuidePagesForGenerator = fetchGuidePagesForGenerator;
 /**
- * Fetch markdown guide pages from github
+ * Fetch every guide page referenced by a generator, in parallel, and
+ * return { page, raw, body, frontmatter } for each one. Used by both
+ * `fetchGuidePagesForGenerator` (to filter + render) and
+ * `renderFilterableOptionsAsync` (to build the filterable-options list
+ * from the union of frontmatter `when:` keys).
+ */
+const fetchGuideFrontmatters = async (info) => {
+    const pages = [...(info.guidePages ?? [(0, names_1.kebabCase)(info.id)])];
+    const results = await Promise.allSettled(pages.map(async (page) => ({ page, raw: await fetchGuideRaw(page) })));
+    const fulfilled = [];
+    for (const r of results) {
+        if (r.status === 'fulfilled' && r.value.raw)
+            fulfilled.push(r.value);
+    }
+    return Promise.all(fulfilled.map(async ({ page, raw }) => {
+        const parsed = await parseGuide(raw);
+        return { page, raw, ...parsed };
+    }));
+};
+exports.fetchGuideFrontmatters = fetchGuideFrontmatters;
+/**
+ * Read a guide's raw MDX, local filesystem first, GitHub fallback.
+ */
+const fetchGuideRaw = async (page) => {
+    const local = fetchLocalGuide(page);
+    if (local !== undefined)
+        return local;
+    const response = await fetch(`https://raw.githubusercontent.com/awslabs/nx-plugin-for-aws/refs/heads/main/docs/src/content/docs/en/guides/${page}.mdx`);
+    return await response.text();
+};
+/**
+ * Parse a guide's MDX once and return the body, the frontmatter, and the
+ * set of option keys its `<OptionFilter>` / `<TabItem _filter>` blocks
+ * actually reference. The yaml node's `position.end.offset` gives us the
+ * body slice without re-stringifying the tree.
+ */
+const parseGuide = async (raw) => {
+    const tree = await (0, guide_pipeline_1.parseMdx)(raw);
+    const { data, bodyOffset } = (0, mdx_ast_1.extractFrontmatter)(tree);
+    const body = raw.slice(bodyOffset).replace(/^\r?\n/, '');
+    const frontmatter = {};
+    if (typeof data.title === 'string')
+        frontmatter.title = data.title;
+    if (data.when && typeof data.when === 'object' && !Array.isArray(data.when)) {
+        const when = {};
+        for (const [key, value] of Object.entries(data.when)) {
+            when[key] = Array.isArray(value) ? value.map(String) : [String(value)];
+        }
+        frontmatter.when = when;
+    }
+    return {
+        body,
+        frontmatter,
+        referencedKeys: (0, mdx_ast_1.collectFilterableKeysFromJsx)(tree),
+    };
+};
+/**
+ * Search the monorepo-relative guides directory for a page before falling
+ * back to GitHub. This is the common case during local development
+ * (`pnpm nx mcp-inspect @aws/nx-plugin`), and it also means test workspaces
+ * that link the built plugin read the guides they're actually iterating on
+ * instead of whatever is currently on `main`.
+ *
+ * When running as the published `@aws/nx-plugin-mcp` package, `__dirname`
+ * resolves somewhere inside `node_modules/@aws/nx-plugin-mcp`, the local
+ * probe misses, and we fall back to GitHub.
+ */
+const GUIDES_RELATIVE_PROBES = [
+    // nx-plugin package compiled from source (src/mcp-server/…)
+    '../../../docs/src/content/docs/en/guides',
+    // rolldown-bundled `@aws/nx-plugin-mcp` binary in dist
+    '../../../../docs/src/content/docs/en/guides',
+];
+const fetchLocalGuide = (guide) => {
+    for (const rel of GUIDES_RELATIVE_PROBES) {
+        const candidate = path_1.default.resolve(__dirname, rel, `${guide}.mdx`);
+        try {
+            if (fs_1.default.existsSync(candidate)) {
+                return fs_1.default.readFileSync(candidate, 'utf-8');
+            }
+        }
+        catch {
+            // Probe failure → keep looking.
+        }
+    }
+    return undefined;
+};
+/**
+ * Fetch markdown guide pages. Prefers local files (see `fetchLocalGuide`)
+ * and falls back to fetching from the repo on `main` when no local copy
+ * is available.
  */
-const fetchGuidePages = async (guidePages, generators, packageManager, snippetContentProvider) => {
-    const guides = await Promise.allSettled(guidePages.map(async (guide) => await (await fetch(`https://raw.githubusercontent.com/awslabs/nx-plugin-for-aws/refs/heads/main/docs/src/content/docs/en/guides/${guide}.mdx`)).text()));
+const fetchGuidePages = async (guidePages, generators, packageManager, snippetContentProvider, options) => {
+    const guides = await Promise.allSettled(guidePages.map(async (guide) => {
+        const local = fetchLocalGuide(guide);
+        if (local !== undefined)
+            return local;
+        const response = await fetch(`https://raw.githubusercontent.com/awslabs/nx-plugin-for-aws/refs/heads/main/docs/src/content/docs/en/guides/${guide}.mdx`);
+        return await response.text();
+    }));
     const fulfilled = guides.filter((result) => result.status === 'fulfilled');
-    const processed = await Promise.all(fulfilled.map((result) => (0, exports.postProcessGuide)(result.value, generators, packageManager, snippetContentProvider)));
+    const processed = await Promise.all(fulfilled.map((result) => (0, exports.postProcessGuide)(result.value, generators, packageManager, snippetContentProvider, options)));
     return processed.join('\n\n');
 };
 exports.fetchGuidePages = fetchGuidePages;
+const SNIPPETS_RELATIVE_PROBES = [
+    '../../../docs/src/content/docs/en/snippets',
+    '../../../../docs/src/content/docs/en/snippets',
+];
 const SNIPPET_BASE_URL = 'https://raw.githubusercontent.com/awslabs/nx-plugin-for-aws/refs/heads/main/docs/src/content/docs/en/snippets';
 /**
- * Fetch a snippet's content from github
+ * Fetch a snippet's content. Tries the local repo checkout first (when
+ * running under `mcp-inspect` or a linked test workspace) before falling
+ * back to the copy on `main`.
  */
 const fetchSnippet = async (snippetName) => {
+    for (const rel of SNIPPETS_RELATIVE_PROBES) {
+        const candidate = path_1.default.resolve(__dirname, rel, `${snippetName}.mdx`);
+        try {
+            if (fs_1.default.existsSync(candidate)) {
+                return fs_1.default.readFileSync(candidate, 'utf-8');
+            }
+        }
+        catch {
+            // Probe failure — try next fallback.
+        }
+    }
     try {
         const response = await fetch(`${SNIPPET_BASE_URL}/${snippetName}.mdx`);
         if (!response.ok) {
@@ -76,145 +355,21 @@ const fetchSnippet = async (snippetName) => {
     }
 };
 exports.fetchSnippet = fetchSnippet;
-const findGeneratorAndSchema = (generators, generatorId) => {
-    const generator = generators.find((info) => info.id === generatorId);
-    if (!generator) {
-        return undefined;
-    }
-    try {
-        const schema = JSON.parse(fs_1.default.readFileSync(generator.resolvedSchemaPath, 'utf-8'));
-        return { generator, schema };
-    }
-    catch {
-        return undefined;
-    }
-};
 /**
- * Post-process a guide page to "inline" relevant components
+ * Post-process a guide page. Thin wrapper around the unified/remark-mdx
+ * pipeline in `guide-pipeline.ts` — the real work (snippet inlining,
+ * OptionFilter/Infrastructure/TabItem filtering, command/schema rendering)
+ * happens there. Kept under the same name so other packages
+ * (e.g. the docs site's `markdown-content.astro`) can continue importing
+ * `postProcessGuide` with the same signature.
  */
-const postProcessGuide = async (guide, generators, packageManager, snippetContentProvider) => {
-    const getSnippetContent = snippetContentProvider ?? exports.fetchSnippet;
-    // Replace <Snippet /> with fetched snippet content
-    // Use a regex that matches the full self-closing tag, allowing / in attribute values
-    const snippetRegex = /<Snippet\s+((?:[^/]|\/(?!>))+)\s*\/>/g;
-    const snippetMatches = [...guide.matchAll(snippetRegex)];
-    let processedGuide = guide;
-    if (snippetMatches.length > 0) {
-        // Fetch all snippets in parallel
-        const snippetResults = await Promise.all(snippetMatches.map(async (match) => {
-            const nameMatch = match[1].match(/name=["']([^"']+)["']/);
-            if (!nameMatch) {
-                return { original: match[0], replacement: match[0] };
-            }
-            const snippetName = nameMatch[1];
-            const snippetContent = await getSnippetContent(snippetName);
-            if (!snippetContent) {
-                return { original: match[0], replacement: match[0] };
-            }
-            // Recursively post-process the snippet content
-            const processedContent = await (0, exports.postProcessGuide)(snippetContent.trim(), generators, packageManager, getSnippetContent);
-            return {
-                original: match[0],
-                replacement: `<Snippet name="${snippetName}">\n${processedContent}\n</Snippet>`,
-            };
-        }));
-        for (const { original, replacement } of snippetResults) {
-            processedGuide = processedGuide.replace(original, replacement);
-        }
-    }
-    // Replace <NxCommands /> with markdown code blocks
-    processedGuide = processedGuide.replace(/<NxCommands\s+commands={([^}]+)}\s*\/>/g, (match, commandsMatch) => {
-        try {
-            const commands = JSON.parse(commandsMatch
-                .replaceAll("\\'", '__ESCAPED_SINGLE_QUOTE__')
-                .replaceAll("'", '"')
-                .replaceAll('__ESCAPED_SINGLE_QUOTE__', "\\'"));
-            return `\`\`\`bash\n${commands.map((command) => (0, exports.buildNxCommand)(command, packageManager)).join('\n')}\n\`\`\``;
-        }
-        catch {
-            return match;
-        }
-    });
-    // Replace <RunGenerator /> with renderGeneratorCommand
-    processedGuide = processedGuide.replace(/<RunGenerator\s+((?:[^/]|\/(?!>))+)\s*\/>/g, (match, attributes) => {
-        // Extract generator parameter
-        const generatorMatch = attributes.match(/generator=["']([^"']+)["']/);
-        if (!generatorMatch) {
-            return match; // If no generator parameter, leave as is
-        }
-        const generatorId = generatorMatch[1];
-        const info = findGeneratorAndSchema(generators, generatorId);
-        if (!info) {
-            return match;
-        }
-        return renderGeneratorCommand(generatorId, info.schema, packageManager);
-    });
-    // Replace <GeneratorParameters /> with renderSchema
-    processedGuide = processedGuide.replace(/<GeneratorParameters\s+((?:[^/]|\/(?!>))+)\s*\/>/g, (match, attributes) => {
-        // Extract generator parameter
-        const generatorMatch = attributes.match(/generator=["']([^"']+)["']/);
-        if (!generatorMatch) {
-            return match; // If no generator parameter, leave as is
-        }
-        const generatorId = generatorMatch[1];
-        const info = findGeneratorAndSchema(generators, generatorId);
-        if (!info) {
-            return match;
-        }
-        return renderSchema(info.schema);
-    });
-    // Replace <CreateNxWorkspaceCommand /> with npx create-nx-workspace command
-    processedGuide = processedGuide.replace(/<CreateNxWorkspaceCommand\s+((?:[^/]|\/(?!>))+)\s*\/>/g, (match, attributes) => {
-        const workspaceMatch = attributes.match(/workspace=["']([^"']+)["']/);
-        if (!workspaceMatch)
-            return match;
-        const workspace = workspaceMatch[1];
-        const iacMatch = attributes.match(/iacProvider=["']([^"']+)["']/);
-        const iacProvider = iacMatch
-            ? iacMatch[1]
-            : undefined;
-        const pm = packageManager ?? 'pnpm';
-        return `\`\`\`bash\n${(0, commands_1.buildCreateNxWorkspaceCommand)(pm, workspace, iacProvider)}\n\`\`\``;
-    });
-    // Replace <InstallCommand /> with install command
-    processedGuide = processedGuide.replace(/<InstallCommand\s+((?:[^/]|\/(?!>))+)\s*\/>/g, (match, attributes) => {
-        const pkgMatch = attributes.match(/pkg=(?:["']([^"']+)["']|\{([^}]+)\})/);
-        if (!pkgMatch)
-            return match;
-        const pkg = pkgMatch[1] || pkgMatch[2];
-        const isDev = /dev/.test(attributes);
-        const pm = packageManager ?? 'pnpm';
-        return `\`\`\`bash\n${(0, commands_1.buildInstallCommand)(pm, pkg, isDev)}\n\`\`\``;
-    });
-    // Replace <PackageManagerShortCommand /> with short command
-    processedGuide = processedGuide.replace(/<PackageManagerShortCommand\s+commands={([^}]+)}\s*\/>/g, (match, commandsMatch) => {
-        try {
-            const commands = JSON.parse(commandsMatch
-                .replaceAll("\\'", '__ESCAPED_SINGLE_QUOTE__')
-                .replaceAll("'", '"')
-                .replaceAll('__ESCAPED_SINGLE_QUOTE__', "\\'"));
-            const pm = packageManager ?? 'pnpm';
-            return `\`\`\`bash\n${commands.map((command) => (0, commands_1.buildPackageManagerShortCommand)(pm, command)).join('\n')}\n\`\`\``;
-        }
-        catch {
-            return match;
-        }
-    });
-    // Replace <PackageManagerExecCommand /> with exec command
-    processedGuide = processedGuide.replace(/<PackageManagerExecCommand\s+commands={([^}]+)}\s*\/>/g, (match, commandsMatch) => {
-        try {
-            const commands = JSON.parse(commandsMatch
-                .replaceAll("\\'", '__ESCAPED_SINGLE_QUOTE__')
-                .replaceAll("'", '"')
-                .replaceAll('__ESCAPED_SINGLE_QUOTE__', "\\'"));
-            const pm = packageManager ?? 'pnpm';
-            return `\`\`\`bash\n${commands.map((command) => (0, commands_1.buildPackageManagerExecCommand)(pm, command)).join('\n')}\n\`\`\``;
-        }
-        catch {
-            return match;
-        }
+const postProcessGuide = async (guide, generators, packageManager, snippetContentProvider, options) => {
+    return (0, guide_pipeline_1.postProcessGuideWithRemark)(guide, {
+        generators,
+        packageManager,
+        snippetContentProvider: snippetContentProvider ?? exports.fetchSnippet,
+        options,
     });
-    return processedGuide;
 };
 exports.postProcessGuide = postProcessGuide;
 //# sourceMappingURL=generator-info.js.map

package/src/mcp-server/generator-info.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator-info.js","sourceRoot":"","sources":["../../../../../packages/nx-plugin/src/mcp-server/generator-info.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"generator-info.js","sourceRoot":"","sources":["../../../../../packages/nx-plugin/src/mcp-server/generator-info.ts"],"names":[],"mappings":"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"}

package/src/mcp-server/guide-pipeline.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Unified + remark-mdx pipeline for the MCP `generator-guide` tool.
+ *
+ * Passes (in order, each over the already-transformed tree):
+ *   1. Snippet inlining — `<Snippet name>` → recursive post-process.
+ *   2. Filter transforms — `<OptionFilter>`, `<Infrastructure>` slot
+ *      selection, `<Tabs><TabItem _filter>` pruning.
+ *   3. Component transforms — `<NxCommands>` / `<RunGenerator>` /
+ *      `<GeneratorParameters>` / `<CreateNxWorkspaceCommand>` /
+ *      `<InstallCommand>` / `<PackageManagerShortCommand>` /
+ *      `<PackageManagerExecCommand>` render down to markdown.
+ */
+import type { Root } from 'mdast';
+import { NxGeneratorInfo } from '../utils/generators';
+export interface PipelineOptions {
+    generators: NxGeneratorInfo[];
+    packageManager?: string;
+    snippetContentProvider?: (name: string) => Promise<string> | string;
+    options?: Record<string, string>;
+}
+/** Parse MDX (with frontmatter) into mdast. Exposed so callers like
+ *  `fetchGuideFrontmatters` don't need to re-load remark themselves. */
+export declare const parseMdx: (source: string) => Promise<Root>;
+export declare const postProcessGuideWithRemark: (guide: string, opts: PipelineOptions) => Promise<string>;