@aws/nx-plugin 0.107.0 → 0.108.0

package/src/mcp-server/guide-pipeline.js

@@ -0,0 +1,393 @@
+"use strict";
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.postProcessGuideWithRemark = exports.parseMdx = void 0;
+const tslib_1 = require("tslib");
+const option_filter_1 = require("./option-filter");
+const commands_1 = require("../utils/commands");
+const guide_render_1 = require("./guide-render");
+const mdx_ast_1 = require("./mdx-ast");
+const fs_1 = tslib_1.__importDefault(require("fs"));
+let depsPromise;
+const loadRemarkDeps = () => {
+    if (!depsPromise) {
+        depsPromise = (async () => ({
+            unified: (await Promise.resolve().then(() => tslib_1.__importStar(require('unified')))).unified,
+            remarkParse: (await Promise.resolve().then(() => tslib_1.__importStar(require('remark-parse')))).default,
+            remarkMdx: (await Promise.resolve().then(() => tslib_1.__importStar(require('remark-mdx')))).default,
+            remarkStringify: (await Promise.resolve().then(() => tslib_1.__importStar(require('remark-stringify')))).default,
+            remarkFrontmatter: (await Promise.resolve().then(() => tslib_1.__importStar(require('remark-frontmatter')))).default,
+        }))();
+    }
+    return depsPromise;
+};
+const parseMdxWithDeps = (source, deps) => deps
+    .unified()
+    .use(deps.remarkParse)
+    .use(deps.remarkFrontmatter)
+    .use(deps.remarkMdx)
+    .parse(source);
+/** Parse MDX (with frontmatter) into mdast. Exposed so callers like
+ *  `fetchGuideFrontmatters` don't need to re-load remark themselves. */
+const parseMdx = async (source) => {
+    const deps = await loadRemarkDeps();
+    return parseMdxWithDeps(source, deps);
+};
+exports.parseMdx = parseMdx;
+const stringifyMdx = (tree, deps) => String(deps
+    .unified()
+    .use(deps.remarkFrontmatter)
+    .use(deps.remarkMdx)
+    .use(deps.remarkStringify, {
+    bullet: '-',
+    fences: true,
+    listItemIndent: 'one',
+})
+    .stringify(tree));
+const postProcessGuideWithRemark = async (guide, opts) => {
+    const deps = await loadRemarkDeps();
+    const tree = parseMdxWithDeps(guide, deps);
+    await inlineSnippets(tree, opts, deps);
+    applyFilterTransforms(tree, opts.options);
+    applyComponentTransforms(tree, opts, deps);
+    return stringifyMdx(tree, deps);
+};
+exports.postProcessGuideWithRemark = postProcessGuideWithRemark;
+const inlineSnippets = async (tree, opts, deps) => {
+    const provider = opts.snippetContentProvider;
+    if (!provider)
+        return;
+    const pending = [];
+    const walk = (parent) => {
+        const children = parent.children;
+        for (let i = 0; i < children.length; i++) {
+            const child = children[i];
+            if (!(0, mdx_ast_1.isJsxElement)(child))
+                continue;
+            if (child.name === 'Snippet') {
+                const name = (0, mdx_ast_1.readStringAttr)(child, 'name');
+                if (name)
+                    pending.push({ parent, index: i, name, node: child });
+                continue;
+            }
+            walk(child);
+        }
+    };
+    walk(tree);
+    if (pending.length === 0)
+        return;
+    const fetched = await Promise.all(pending.map(async (p) => {
+        let raw = '';
+        try {
+            raw = await provider(p.name);
+        }
+        catch {
+            raw = '';
+        }
+        if (!raw)
+            return { ...p, replacement: undefined };
+        const processed = await (0, exports.postProcessGuideWithRemark)(raw.trim(), opts);
+        return { ...p, replacement: processed };
+    }));
+    // Splice in descending index order per parent so earlier indices stay valid.
+    const byParent = new Map();
+    for (const f of fetched) {
+        const bucket = byParent.get(f.parent) ?? [];
+        bucket.push(f);
+        byParent.set(f.parent, bucket);
+    }
+    for (const [parent, items] of byParent) {
+        items.sort((a, b) => b.index - a.index);
+        for (const { index, name, replacement, node } of items) {
+            if (replacement === undefined)
+                continue;
+            const snippetTree = parseMdxWithDeps(replacement, deps);
+            const wrapper = {
+                type: 'mdxJsxFlowElement',
+                name: 'Snippet',
+                attributes: [{ type: 'mdxJsxAttribute', name: 'name', value: name }],
+                children: snippetTree.children,
+            };
+            if ('position' in node && node.position) {
+                wrapper.position = node.position;
+            }
+            parent.children.splice(index, 1, wrapper);
+        }
+    }
+};
+const applyFilterTransforms = (tree, options) => {
+    const iacProvider = options?.iacProvider;
+    const transform = (parent) => {
+        const children = parent.children;
+        for (let i = 0; i < children.length; i++) {
+            const child = children[i];
+            if (!(0, mdx_ast_1.isJsxElement)(child))
+                continue;
+            if (child.name === 'OptionFilter') {
+                const when = parseWhenAttr(child);
+                if (!when)
+                    continue; // malformed — leave alone
+                // Recurse first so nested filters collapse before we replace this wrapper.
+                transform(child);
+                const not = (0, mdx_ast_1.hasBareAttr)(child, 'not');
+                if (options) {
+                    const replacement = (0, option_filter_1.evaluatePredicate)(when, not, options)
+                        ? child.children
+                        : [];
+                    children.splice(i, 1, ...replacement);
+                    i += replacement.length - 1;
+                }
+                else {
+                    children.splice(i, 1, buildNoteQuote(child, when, not));
+                }
+                continue;
+            }
+            if (child.name === 'Infrastructure') {
+                if (iacProvider === 'CDK' || iacProvider === 'Terraform') {
+                    const body = selectInfrastructureSlot(child, iacProvider);
+                    const pseudo = {
+                        type: 'mdxJsxFlowElement',
+                        name: 'tmp',
+                        attributes: [],
+                        children: body,
+                    };
+                    transform(pseudo);
+                    children.splice(i, 1, ...pseudo.children);
+                    i--;
+                    continue;
+                }
+                // No iacProvider → keep both slots so readers / agents see both variants.
+                transform(child);
+                continue;
+            }
+            if (child.name === 'Tabs' && child.type === 'mdxJsxFlowElement') {
+                transform(child);
+                const dropped = applyTabsFilter(child, options);
+                if (dropped === 'empty') {
+                    children.splice(i, 1);
+                    i--;
+                    continue;
+                }
+                if (dropped === 'inline') {
+                    const survivor = child.children.find((c) => (0, mdx_ast_1.isJsxElement)(c) && c.name === 'TabItem');
+                    const body = survivor.children;
+                    children.splice(i, 1, ...body);
+                    i += body.length - 1;
+                    continue;
+                }
+                continue;
+            }
+            transform(child);
+        }
+    };
+    transform(tree);
+};
+const selectInfrastructureSlot = (node, iacProvider) => {
+    const slotName = iacProvider.toLowerCase();
+    const frag = node.children.find((c) => (0, mdx_ast_1.isJsxElement)(c) &&
+        c.name === 'Fragment' &&
+        (0, mdx_ast_1.readStringAttr)(c, 'slot') === slotName);
+    return frag?.children ?? [];
+};
+/**
+ * Prune TabItems whose `_filter` doesn't match `options`. Returns:
+ *   - `'empty'` if the <Tabs> now has no <TabItem>s — caller drops it.
+ *   - `'inline'` if exactly one filtered <TabItem> survived — caller
+ *     inlines the body so agents see just the picked variant.
+ *   - `'keep'` otherwise.
+ */
+const applyTabsFilter = (tabs, options) => {
+    const children = tabs.children;
+    const surviving = [];
+    let anyFiltered = false;
+    for (const child of children) {
+        if (!(0, mdx_ast_1.isJsxElement)(child) || child.name !== 'TabItem') {
+            surviving.push(child);
+            continue;
+        }
+        const filterEstree = (0, mdx_ast_1.readEstreeAttr)(child, '_filter');
+        if (!filterEstree) {
+            surviving.push(child);
+            continue;
+        }
+        anyFiltered = true;
+        let predicate;
+        try {
+            predicate = (0, option_filter_1.parseWhenExpression)(filterEstree);
+        }
+        catch {
+            stripFilterAttr(child);
+            surviving.push(child);
+            continue;
+        }
+        if (!options || (0, option_filter_1.evaluatePredicate)(predicate, false, options)) {
+            stripFilterAttr(child);
+            surviving.push(child);
+        }
+    }
+    if (anyFiltered) {
+        tabs.children = surviving;
+    }
+    const tabItems = surviving.filter((c) => (0, mdx_ast_1.isJsxElement)(c) && c.name === 'TabItem');
+    if (tabItems.length === 0 && surviving.length === 0)
+        return 'empty';
+    if (anyFiltered && tabItems.length === 1)
+        return 'inline';
+    return 'keep';
+};
+const stripFilterAttr = (el) => {
+    el.attributes = el.attributes.filter((a) => !(a.type === 'mdxJsxAttribute' && a.name === '_filter'));
+};
+/**
+ * `> [!NOTE] Only when …` blockquote. The alert header goes through as an
+ * `html` node so remark-stringify doesn't escape the `[`/`]` brackets —
+ * downstream agents match on the literal GitHub alert syntax.
+ */
+const buildNoteQuote = (source, predicate, not) => {
+    const marker = (0, option_filter_1.describePredicate)(predicate, not);
+    const description = (0, mdx_ast_1.readStringAttr)(source, 'description');
+    const headerLines = description
+        ? [`[!NOTE] ${marker}`, description]
+        : [`[!NOTE] ${marker}`];
+    const headerNodes = headerLines.map((line) => ({ type: 'html', value: line }));
+    return {
+        type: 'blockquote',
+        children: [...headerNodes, ...source.children],
+    };
+};
+const parseWhenAttr = (node) => {
+    const estree = (0, mdx_ast_1.readEstreeAttr)(node, 'when');
+    if (!estree)
+        return undefined;
+    try {
+        return (0, option_filter_1.parseWhenExpression)(estree);
+    }
+    catch {
+        return undefined;
+    }
+};
+const applyComponentTransforms = (tree, opts, deps) => {
+    const pm = opts.packageManager ?? 'pnpm';
+    const transform = (parent) => {
+        const children = parent.children;
+        for (let i = 0; i < children.length; i++) {
+            const child = children[i];
+            if (!(0, mdx_ast_1.isJsxElement)(child))
+                continue;
+            const replacement = renderComponent(child, opts, pm, deps);
+            if (replacement !== undefined) {
+                children.splice(i, 1, ...replacement);
+                i += replacement.length - 1;
+                continue;
+            }
+            transform(child);
+        }
+    };
+    transform(tree);
+};
+const renderComponent = (node, opts, pm, deps) => {
+    switch (node.name) {
+        case 'NxCommands': {
+            const commands = readCommandsAttr(node);
+            if (!commands)
+                return undefined;
+            return [
+                codeBlock(commands
+                    .map((c) => (0, guide_render_1.buildNxCommand)(c, opts.packageManager))
+                    .join('\n')),
+            ];
+        }
+        case 'RunGenerator': {
+            const generatorId = (0, mdx_ast_1.readStringAttr)(node, 'generator');
+            if (!generatorId)
+                return undefined;
+            const schema = findSchema(opts.generators, generatorId);
+            if (!schema)
+                return undefined;
+            return parseMarkdownFragment((0, guide_render_1.renderGeneratorCommand)(generatorId, schema, opts.packageManager), deps);
+        }
+        case 'GeneratorParameters': {
+            const generatorId = (0, mdx_ast_1.readStringAttr)(node, 'generator');
+            if (!generatorId)
+                return undefined;
+            const schema = findSchema(opts.generators, generatorId);
+            if (!schema)
+                return undefined;
+            return parseMarkdownFragment((0, guide_render_1.renderSchema)(schema), deps);
+        }
+        case 'CreateNxWorkspaceCommand': {
+            const workspace = (0, mdx_ast_1.readStringAttr)(node, 'workspace');
+            if (!workspace)
+                return undefined;
+            const iacProvider = (0, mdx_ast_1.readStringAttr)(node, 'iacProvider');
+            return [
+                codeBlock((0, commands_1.buildCreateNxWorkspaceCommand)(pm, workspace, iacProvider)),
+            ];
+        }
+        case 'InstallCommand': {
+            const pkg = (0, mdx_ast_1.readStringAttr)(node, 'pkg') ?? (0, mdx_ast_1.readExpressionAttr)(node, 'pkg');
+            if (!pkg)
+                return undefined;
+            return [
+                codeBlock((0, commands_1.buildInstallCommand)(pm, pkg, (0, mdx_ast_1.hasBareAttr)(node, 'dev'))),
+            ];
+        }
+        case 'PackageManagerShortCommand': {
+            const commands = readCommandsAttr(node);
+            if (!commands)
+                return undefined;
+            return [
+                codeBlock(commands
+                    .map((c) => (0, commands_1.buildPackageManagerShortCommand)(pm, c))
+                    .join('\n')),
+            ];
+        }
+        case 'PackageManagerExecCommand': {
+            const commands = readCommandsAttr(node);
+            if (!commands)
+                return undefined;
+            return [
+                codeBlock(commands.map((c) => (0, commands_1.buildPackageManagerExecCommand)(pm, c)).join('\n')),
+            ];
+        }
+        default:
+            return undefined;
+    }
+};
+const codeBlock = (body) => ({
+    type: 'code',
+    lang: 'bash',
+    value: body,
+});
+const parseMarkdownFragment = (markdown, deps) => {
+    const fragTree = deps.unified().use(deps.remarkParse).parse(markdown);
+    return fragTree.children;
+};
+const findSchema = (generators, generatorId) => {
+    const info = generators.find((g) => g.id === generatorId);
+    if (!info)
+        return undefined;
+    try {
+        return JSON.parse(fs_1.default.readFileSync(info.resolvedSchemaPath, 'utf-8'));
+    }
+    catch {
+        return undefined;
+    }
+};
+/** Parse the `commands={[…]}` attribute from the estree that remark-mdx
+ *  attaches to the JSX attribute value. */
+const readCommandsAttr = (node) => {
+    const estree = (0, mdx_ast_1.readEstreeAttr)(node, 'commands');
+    if (!estree)
+        return undefined;
+    try {
+        return (0, option_filter_1.extractStringArrayExpression)(estree);
+    }
+    catch {
+        return undefined;
+    }
+};
+//# sourceMappingURL=guide-pipeline.js.map

package/src/mcp-server/guide-pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide-pipeline.js","sourceRoot":"","sources":["../../../../../packages/nx-plugin/src/mcp-server/guide-pipeline.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;AAiBH,mDAMyB;AACzB,gDAK2B;AAC3B,iDAIwB;AACxB,uCAQmB;AACnB,oDAAoB;AAmBpB,IAAI,WAA4C,CAAC;AACjD,MAAM,cAAc,GAAG,GAAwB,EAAE;IAC/C,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,WAAW,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YAC1B,OAAO,EAAE,CAAC,gEAAa,SAAS,GAAC,CAAC,CAAC,OAAO;YAC1C,WAAW,EAAE,CAAC,gEAAa,cAAc,GAAC,CAAC,CAAC,OAAO;YACnD,SAAS,EAAE,CAAC,gEAAa,YAAY,GAAC,CAAC,CAAC,OAAO;YAC/C,eAAe,EAAE,CAAC,gEAAa,kBAAkB,GAAC,CAAC,CAAC,OAAO;YAC3D,iBAAiB,EAAE,CAAC,gEAAa,oBAAoB,GAAC,CAAC,CAAC,OAAO;SAChE,CAAC,CAAC,EAAE,CAAC;IACR,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,MAAc,EAAE,IAAgB,EAAQ,EAAE,CAClE,IAAI;KACD,OAAO,EAAE;KACT,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC;KACrB,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC;KAC3B,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;KACnB,KAAK,CAAC,MAAM,CAAS,CAAC;AAE3B;wEACwE;AACjE,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAc,EAAiB,EAAE;IAC9D,MAAM,IAAI,GAAG,MAAM,cAAc,EAAE,CAAC;IACpC,OAAO,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACxC,CAAC,CAAC;AAHW,QAAA,QAAQ,YAGnB;AAEF,MAAM,YAAY,GAAG,CAAC,IAAU,EAAE,IAAgB,EAAU,EAAE,CAC5D,MAAM,CACJ,IAAI;KACD,OAAO,EAAE;KACT,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC;KAC3B,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;KACnB,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE;IACzB,MAAM,EAAE,GAAG;IACX,MAAM,EAAE,IAAI;IACZ,cAAc,EAAE,KAAK;CACtB,CAAC;KACD,SAAS,CAAC,IAAI,CAAC,CACnB,CAAC;AAEG,MAAM,0BAA0B,GAAG,KAAK,EAC7C,KAAa,EACb,IAAqB,EACJ,EAAE;IACnB,MAAM,IAAI,GAAG,MAAM,cAAc,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAE3C,MAAM,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACvC,qBAAqB,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1C,wBAAwB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAE3C,OAAO,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAClC,CAAC,CAAC;AAZW,QAAA,0BAA0B,8BAYrC;AAEF,MAAM,cAAc,GAAG,KAAK,EAC1B,IAAU,EACV,IAAqB,EACrB,IAAgB,EACD,EAAE;IACjB,MAAM,QAAQ,GAAG,IAAI,CAAC,sBAAsB,CAAC;IAC7C,IAAI,CAAC,QAAQ;QAAE,OAAO;IAStB,MAAM,OAAO,GAAqB,EAAE,CAAC;IACrC,MAAM,IAAI,GAAG,CAAC,MAAiB,EAAQ,EAAE;QACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAyB,CAAC;QAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,CAAC,IAAA,sBAAY,EAAC,KAAK,CAAC;gBAAE,SAAS;YACnC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,IAAI,GAAG,IAAA,wBAAc,EAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBAC3C,IAAI,IAAI;oBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;gBAChE,SAAS;YACX,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,CAAC;QACd,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,IAAI,CAAC,CAAC;IACX,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEjC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QACtB,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,GAAG,GAAG,EAAE,CAAC;QACX,CAAC;QACD,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,GAAG,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;QAClD,MAAM,SAAS,GAAG,MAAM,IAAA,kCAA0B,EAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;QACrE,OAAO,EAAE,GAAG,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;IAC1C,CAAC,CAAC,CACH,CAAC;IAEF,6EAA6E;IAC7E,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyC,CAAC;IAClE,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACf,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,CAAC;IACD,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,QAAQ,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QACxC,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC;YACvD,IAAI,WAAW,KAAK,SAAS;gBAAE,SAAS;YACxC,MAAM,WAAW,GAAG,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YACxD,MAAM,OAAO,GAAsB;gBACjC,IAAI,EAAE,mBAAmB;gBACzB,IAAI,EAAE,SAAS;gBACf,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;gBACpE,QAAQ,EAAE,WAAW,CAAC,QAAyC;aAChE,CAAC;YACF,IAAI,UAAU,IAAI,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACvC,OAAkC,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC/D,CAAC;YACA,MAAM,CAAC,QAA0B,CAAC,MAAM,CACvC,KAAK,EACL,CAAC,EACD,OAAsB,CACvB,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAC5B,IAAU,EACV,OAA2C,EACrC,EAAE;IACR,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,CAAC;IAEzC,MAAM,SAAS,GAAG,CAAC,MAAiB,EAAQ,EAAE;QAC5C,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAyB,CAAC;QAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,CAAC,IAAA,sBAAY,EAAC,KAAK,CAAC;gBAAE,SAAS;YAEnC,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;gBAClC,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;gBAClC,IAAI,CAAC,IAAI;oBAAE,SAAS,CAAC,0BAA0B;gBAC/C,2EAA2E;gBAC3E,SAAS,CAAC,KAAK,CAAC,CAAC;gBACjB,MAAM,GAAG,GAAG,IAAA,qBAAW,EAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBACtC,IAAI,OAAO,EAAE,CAAC;oBACZ,MAAM,WAAW,GAAG,IAAA,iCAAiB,EAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC;wBACvD,CAAC,CAAE,KAAK,CAAC,QAA0B;wBACnC,CAAC,CAAC,EAAE,CAAC;oBACP,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC;oBACtC,CAAC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;gBAC9B,CAAC;qBAAM,CAAC;oBACN,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;gBAC1D,CAAC;gBACD,SAAS;YACX,CAAC;YAED,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;gBACpC,IAAI,WAAW,KAAK,KAAK,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;oBACzD,MAAM,IAAI,GAAG,wBAAwB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;oBAC1D,MAAM,MAAM,GAAsB;wBAChC,IAAI,EAAE,mBAAmB;wBACzB,IAAI,EAAE,KAAK;wBACX,UAAU,EAAE,EAAE;wBACd,QAAQ,EAAE,IAAqC;qBAChD,CAAC;oBACF,SAAS,CAAC,MAAM,CAAC,CAAC;oBAClB,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,GAAI,MAAM,CAAC,QAA0B,CAAC,CAAC;oBAC7D,CAAC,EAAE,CAAC;oBACJ,SAAS;gBACX,CAAC;gBACD,0EAA0E;gBAC1E,SAAS,CAAC,KAAK,CAAC,CAAC;gBACjB,SAAS;YACX,CAAC;YAED,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;gBAChE,SAAS,CAAC,KAAK,CAAC,CAAC;gBACjB,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBAChD,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;oBACxB,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBACtB,CAAC,EAAE,CAAC;oBACJ,SAAS;gBACX,CAAC;gBACD,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;oBACzB,MAAM,QAAQ,GAAI,KAAK,CAAC,QAA0B,CAAC,IAAI,CACrD,CAAC,CAAC,EAA0B,EAAE,CAC5B,IAAA,sBAAY,EAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,CACzC,CAAC;oBACH,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAyB,CAAC;oBAChD,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;oBAC/B,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;oBACrB,SAAS;gBACX,CAAC;gBACD,SAAS;YACX,CAAC;YAED,SAAS,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;IACF,SAAS,CAAC,IAAI,CAAC,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,wBAAwB,GAAG,CAC/B,IAAgB,EAChB,WAAgC,EACjB,EAAE;IACjB,MAAM,QAAQ,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAI,IAAI,CAAC,QAA0B,CAAC,IAAI,CAChD,CAAC,CAAC,EAA0B,EAAE,CAC5B,IAAA,sBAAY,EAAC,CAAC,CAAC;QACf,CAAC,CAAC,IAAI,KAAK,UAAU;QACrB,IAAA,wBAAc,EAAC,CAAC,EAAE,MAAM,CAAC,KAAK,QAAQ,CACzC,CAAC;IACF,OAAQ,IAAI,EAAE,QAA0B,IAAI,EAAE,CAAC;AACjD,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,eAAe,GAAG,CACtB,IAAuB,EACvB,OAA2C,EACd,EAAE;IAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAyB,CAAC;IAChD,MAAM,SAAS,GAAkB,EAAE,CAAC;IACpC,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAA,sBAAY,EAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACrD,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtB,SAAS;QACX,CAAC;QACD,MAAM,YAAY,GAAG,IAAA,wBAAc,EAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACtD,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtB,SAAS;QACX,CAAC;QACD,WAAW,GAAG,IAAI,CAAC;QACnB,IAAI,SAAoB,CAAC;QACzB,IAAI,CAAC;YACH,SAAS,GAAG,IAAA,mCAAmB,EAAC,YAAqB,CAAC,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,eAAe,CAAC,KAAK,CAAC,CAAC;YACvB,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtB,SAAS;QACX,CAAC;QACD,IAAI,CAAC,OAAO,IAAI,IAAA,iCAAiB,EAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;YAC7D,eAAe,CAAC,KAAK,CAAC,CAAC;YACvB,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IACD,IAAI,WAAW,EAAE,CAAC;QAChB,IAAI,CAAC,QAAQ,GAAG,SAA0C,CAAC;IAC7D,CAAC;IACD,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAC/B,CAAC,CAAC,EAAE,EAAE,CAAC,IAAA,sBAAY,EAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,CAC/C,CAAC;IACF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACpE,IAAI,WAAW,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC1D,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,EAAc,EAAQ,EAAE;IAC/C,EAAE,CAAC,UAAU,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,CAClC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,iBAAiB,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAC/D,CAAC;AACJ,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,cAAc,GAAG,CACrB,MAAkB,EAClB,SAAoB,EACpB,GAAY,EACC,EAAE;IACf,MAAM,MAAM,GAAG,IAAA,iCAAiB,EAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,IAAA,wBAAc,EAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,WAAW;QAC7B,CAAC,CAAC,CAAC,WAAW,MAAM,EAAE,EAAE,WAAW,CAAC;QACpC,CAAC,CAAC,CAAC,WAAW,MAAM,EAAE,CAAC,CAAC;IAC1B,MAAM,WAAW,GAAkB,WAAW,CAAC,GAAG,CAChD,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAgB,CACzD,CAAC;IACF,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,CAAC,GAAG,WAAW,EAAE,GAAI,MAAM,CAAC,QAA0B,CAAU;KAC5D,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,IAAgB,EAAyB,EAAE;IAChE,MAAM,MAAM,GAAG,IAAA,wBAAc,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,IAAI,CAAC;QACH,OAAO,IAAA,mCAAmB,EAAC,MAAe,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,wBAAwB,GAAG,CAC/B,IAAU,EACV,IAAqB,EACrB,IAAgB,EACV,EAAE;IACR,MAAM,EAAE,GAAG,IAAI,CAAC,cAAc,IAAI,MAAM,CAAC;IACzC,MAAM,SAAS,GAAG,CAAC,MAAiB,EAAQ,EAAE;QAC5C,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAyB,CAAC;QAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,CAAC,IAAA,sBAAY,EAAC,KAAK,CAAC;gBAAE,SAAS;YACnC,MAAM,WAAW,GAAG,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;YAC3D,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;gBAC9B,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC;gBACtC,CAAC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;gBAC5B,SAAS;YACX,CAAC;YACD,SAAS,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;IACF,SAAS,CAAC,IAAI,CAAC,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CACtB,IAAgB,EAChB,IAAqB,EACrB,EAAU,EACV,IAAgB,EACW,EAAE;IAC7B,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,CAAC,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAChC,OAAO;gBACL,SAAS,CACP,QAAQ;qBACL,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAA,6BAAc,EAAC,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;qBAClD,IAAI,CAAC,IAAI,CAAC,CACd;aACF,CAAC;QACJ,CAAC;QACD,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,WAAW,GAAG,IAAA,wBAAc,EAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YACtD,IAAI,CAAC,WAAW;gBAAE,OAAO,SAAS,CAAC;YACnC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;YACxD,IAAI,CAAC,MAAM;gBAAE,OAAO,SAAS,CAAC;YAC9B,OAAO,qBAAqB,CAC1B,IAAA,qCAAsB,EAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,EAChE,IAAI,CACL,CAAC;QACJ,CAAC;QACD,KAAK,qBAAqB,CAAC,CAAC,CAAC;YAC3B,MAAM,WAAW,GAAG,IAAA,wBAAc,EAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YACtD,IAAI,CAAC,WAAW;gBAAE,OAAO,SAAS,CAAC;YACnC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;YACxD,IAAI,CAAC,MAAM;gBAAE,OAAO,SAAS,CAAC;YAC9B,OAAO,qBAAqB,CAAC,IAAA,2BAAY,EAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;QAC3D,CAAC;QACD,KAAK,0BAA0B,CAAC,CAAC,CAAC;YAChC,MAAM,SAAS,GAAG,IAAA,wBAAc,EAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YACpD,IAAI,CAAC,SAAS;gBAAE,OAAO,SAAS,CAAC;YACjC,MAAM,WAAW,GAAG,IAAA,wBAAc,EAAC,IAAI,EAAE,aAAa,CAGzC,CAAC;YACd,OAAO;gBACL,SAAS,CAAC,IAAA,wCAA6B,EAAC,EAAE,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;aACrE,CAAC;QACJ,CAAC;QACD,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,MAAM,GAAG,GACP,IAAA,wBAAc,EAAC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAA,4BAAkB,EAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACjE,IAAI,CAAC,GAAG;gBAAE,OAAO,SAAS,CAAC;YAC3B,OAAO;gBACL,SAAS,CAAC,IAAA,8BAAmB,EAAC,EAAE,EAAE,GAAG,EAAE,IAAA,qBAAW,EAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;aAClE,CAAC;QACJ,CAAC;QACD,KAAK,4BAA4B,CAAC,CAAC,CAAC;YAClC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,CAAC,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAChC,OAAO;gBACL,SAAS,CACP,QAAQ;qBACL,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAA,0CAA+B,EAAC,EAAE,EAAE,CAAC,CAAC,CAAC;qBAClD,IAAI,CAAC,IAAI,CAAC,CACd;aACF,CAAC;QACJ,CAAC;QACD,KAAK,2BAA2B,CAAC,CAAC,CAAC;YACjC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,CAAC,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAChC,OAAO;gBACL,SAAS,CACP,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAA,yCAA8B,EAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CACtE;aACF,CAAC;QACJ,CAAC;QACD;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,IAAY,EAAe,EAAE,CAAC,CAAC;IAChD,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,IAAI;CACZ,CAAC,CAAC;AAEH,MAAM,qBAAqB,GAAG,CAC5B,QAAgB,EAChB,IAAgB,EACD,EAAE;IACjB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAS,CAAC;IAC9E,OAAO,QAAQ,CAAC,QAAyB,CAAC;AAC5C,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CACjB,UAA6B,EAC7B,WAAmB,EAGP,EAAE;IACd,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,WAAW,CAAC,CAAC;IAC1D,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAE,CAAC,YAAY,CAAC,IAAI,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC,CAAC;AAEF;2CAC2C;AAC3C,MAAM,gBAAgB,GAAG,CAAC,IAAgB,EAAwB,EAAE;IAClE,MAAM,MAAM,GAAG,IAAA,wBAAc,EAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,IAAI,CAAC;QACH,OAAO,IAAA,4CAA4B,EAAC,MAAe,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC,CAAC"}

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

@@ -0,0 +1,25 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Build an nx command, optionally prefixed by the package manager's exec
+ * wrapper. A bare `nx <command>` is returned when no package manager is
+ * passed, matching the legacy regex-based post-processor's behaviour.
+ */
+export declare const buildNxCommand: (command: string, pm?: string) => string;
+/**
+ * Serialise a generator schema's `properties` map to the bullet list
+ * `<GeneratorParameters>` expands to.
+ */
+export declare const renderSchema: (schema: {
+    properties?: Record<string, unknown>;
+    required?: string[];
+}) => string;
+/**
+ * Build the fenced-code invocation that `<RunGenerator>` expands to.
+ */
+export declare const renderGeneratorCommand: (generatorId: string, schema: {
+    properties?: Record<string, unknown>;
+    required?: string[];
+}, packageManager?: string) => string;

package/src/mcp-server/guide-render.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderGeneratorCommand = exports.renderSchema = exports.buildNxCommand = void 0;
+/**
+ * Shared rendering helpers used by the unified/remark-mdx guide pipeline.
+ * Kept in their own module so `generator-info.ts` (which still exports
+ * `renderGeneratorInfo` for list-generators) and the pipeline both render
+ * identical command strings without either re-implementing the other.
+ */
+const commands_1 = require("../utils/commands");
+/**
+ * Build an nx command, optionally prefixed by the package manager's exec
+ * wrapper. A bare `nx <command>` is returned when no package manager is
+ * passed, matching the legacy regex-based post-processor's behaviour.
+ */
+const buildNxCommand = (command, pm) => pm ? (0, commands_1.buildPackageManagerExecCommand)(pm, `nx ${command}`) : `nx ${command}`;
+exports.buildNxCommand = buildNxCommand;
+/**
+ * Serialise a generator schema's `properties` map to the bullet list
+ * `<GeneratorParameters>` expands to.
+ */
+const renderSchema = (schema) => {
+    const required = new Set(schema.required ?? []);
+    return Object.entries(schema.properties ?? {})
+        .map(([parameter, raw]) => {
+        const p = raw;
+        const enumPart = p.enum ? ` [options: ${p.enum.join(', ')}]` : '';
+        const requiredPart = required.has(parameter) ? ` (required)` : '';
+        return `- ${parameter} [type: ${p.type}]${enumPart}${requiredPart} ${p.description}`;
+    })
+        .join('\n');
+};
+exports.renderSchema = renderSchema;
+/**
+ * Build the fenced-code invocation that `<RunGenerator>` expands to.
+ */
+const renderGeneratorCommand = (generatorId, schema, packageManager) => {
+    const required = new Set(schema.required ?? []);
+    const args = Object.keys(schema.properties ?? {})
+        .filter((k) => required.has(k))
+        .map((k) => `--${k}=<${k}>`)
+        .join(' ');
+    return `\`\`\`bash\n${(0, exports.buildNxCommand)(`g @aws/nx-plugin:${generatorId} --no-interactive ${args}`, packageManager)}\n\`\`\``;
+};
+exports.renderGeneratorCommand = renderGeneratorCommand;
+//# sourceMappingURL=guide-render.js.map

package/src/mcp-server/guide-render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide-render.js","sourceRoot":"","sources":["../../../../../packages/nx-plugin/src/mcp-server/guide-render.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH;;;;;GAKG;AACH,gDAAmE;AAEnE;;;;GAIG;AACI,MAAM,cAAc,GAAG,CAAC,OAAe,EAAE,EAAW,EAAE,EAAE,CAC7D,EAAE,CAAC,CAAC,CAAC,IAAA,yCAA8B,EAAC,EAAE,EAAE,MAAM,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,OAAO,EAAE,CAAC;AADhE,QAAA,cAAc,kBACkD;AAE7E;;;GAGG;AACI,MAAM,YAAY,GAAG,CAAC,MAG5B,EAAU,EAAE;IACX,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAChD,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;SAC3C,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,EAAE;QACxB,MAAM,CAAC,GAAG,GAIT,CAAC;QACF,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,OAAO,KAAK,SAAS,WAAW,CAAC,CAAC,IAAI,IAAI,QAAQ,GAAG,YAAY,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IACvF,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC,CAAC;AAjBW,QAAA,YAAY,gBAiBvB;AAEF;;GAEG;AACI,MAAM,sBAAsB,GAAG,CACpC,WAAmB,EACnB,MAAqE,EACrE,cAAuB,EACf,EAAE;IACV,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;SAC9C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC;SAC3B,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,OAAO,eAAe,IAAA,sBAAc,EAClC,oBAAoB,WAAW,qBAAqB,IAAI,EAAE,EAC1D,cAAc,CACf,UAAU,CAAC;AACd,CAAC,CAAC;AAdW,QAAA,sBAAsB,0BAcjC"}

package/src/mcp-server/mdx-ast.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Root, RootContent } from 'mdast';
+import type { MdxJsxFlowElement, MdxJsxTextElement } from 'mdast-util-mdx-jsx';
+export type JsxParent = Root | MdxJsxFlowElement | MdxJsxTextElement;
+export type JsxElement = MdxJsxFlowElement | MdxJsxTextElement;
+export declare const isJsxElement: (node: RootContent) => node is JsxElement;
+export declare const readStringAttr: (node: JsxElement, name: string) => string | undefined;
+export declare const readExpressionAttr: (node: JsxElement, name: string) => string | undefined;
+export declare const readEstreeAttr: (node: JsxElement, name: string) => unknown | undefined;
+export declare const hasBareAttr: (node: JsxElement, name: string) => boolean;
+/** Walk every JSX element in the subtree, pre-order. */
+export declare const walkJsx: (parent: JsxParent, visit: (node: JsxElement, parent: JsxParent) => void) => void;
+/**
+ * Every option key referenced by `<OptionFilter when>` or
+ * `<TabItem _filter>` in the subtree. Malformed predicates are skipped.
+ */
+export declare const collectFilterableKeysFromJsx: (tree: Root) => Set<string>;
+/**
+ * Parse the leading `---…---` YAML frontmatter from an mdast Root produced
+ * with `remark-frontmatter`. Returns `{ data, bodyOffset }` where
+ * `bodyOffset` is the character index after the closing `---` — slice the
+ * original source from it to get the body without re-stringifying the tree.
+ */
+export declare const extractFrontmatter: (tree: Root) => {
+    data: Record<string, unknown>;
+    bodyOffset: number;
+};

package/src/mcp-server/mdx-ast.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractFrontmatter = exports.collectFilterableKeysFromJsx = exports.walkJsx = exports.hasBareAttr = exports.readEstreeAttr = exports.readExpressionAttr = exports.readStringAttr = exports.isJsxElement = void 0;
+const tslib_1 = require("tslib");
+const js_yaml_1 = tslib_1.__importDefault(require("js-yaml"));
+const option_filter_1 = require("./option-filter");
+const isJsxElement = (node) => node.type === 'mdxJsxFlowElement' || node.type === 'mdxJsxTextElement';
+exports.isJsxElement = isJsxElement;
+const findAttr = (node, name) => node.attributes.find((a) => a.type === 'mdxJsxAttribute' && a.name === name);
+const readStringAttr = (node, name) => {
+    const attr = findAttr(node, name);
+    return typeof attr?.value === 'string' ? attr.value : undefined;
+};
+exports.readStringAttr = readStringAttr;
+const readExpressionAttr = (node, name) => {
+    const attr = findAttr(node, name);
+    if (attr && typeof attr.value === 'object' && attr.value !== null) {
+        return attr.value.value;
+    }
+    return undefined;
+};
+exports.readExpressionAttr = readExpressionAttr;
+const readEstreeAttr = (node, name) => {
+    const attr = findAttr(node, name);
+    if (attr && typeof attr.value === 'object' && attr.value !== null) {
+        return attr.value.data?.estree;
+    }
+    return undefined;
+};
+exports.readEstreeAttr = readEstreeAttr;
+const hasBareAttr = (node, name) => node.attributes.some((a) => a.type === 'mdxJsxAttribute' && a.name === name);
+exports.hasBareAttr = hasBareAttr;
+/** Walk every JSX element in the subtree, pre-order. */
+const walkJsx = (parent, visit) => {
+    const children = parent.children;
+    for (const child of children) {
+        if (!(0, exports.isJsxElement)(child))
+            continue;
+        visit(child, parent);
+        (0, exports.walkJsx)(child, visit);
+    }
+};
+exports.walkJsx = walkJsx;
+/**
+ * Every option key referenced by `<OptionFilter when>` or
+ * `<TabItem _filter>` in the subtree. Malformed predicates are skipped.
+ */
+const collectFilterableKeysFromJsx = (tree) => {
+    const keys = new Set();
+    (0, exports.walkJsx)(tree, (node) => {
+        const attrName = node.name === 'OptionFilter'
+            ? 'when'
+            : node.name === 'TabItem'
+                ? '_filter'
+                : undefined;
+        if (!attrName)
+            return;
+        const estree = (0, exports.readEstreeAttr)(node, attrName);
+        if (!estree)
+            return;
+        try {
+            for (const key of Object.keys((0, option_filter_1.parseWhenExpression)(estree))) {
+                keys.add(key);
+            }
+        }
+        catch {
+            // Malformed / partially-typed — skip.
+        }
+    });
+    return keys;
+};
+exports.collectFilterableKeysFromJsx = collectFilterableKeysFromJsx;
+/**
+ * Parse the leading `---…---` YAML frontmatter from an mdast Root produced
+ * with `remark-frontmatter`. Returns `{ data, bodyOffset }` where
+ * `bodyOffset` is the character index after the closing `---` — slice the
+ * original source from it to get the body without re-stringifying the tree.
+ */
+const extractFrontmatter = (tree) => {
+    const node = tree.children.find((c) => c.type === 'yaml');
+    if (!node)
+        return { data: {}, bodyOffset: 0 };
+    let parsed;
+    try {
+        parsed = js_yaml_1.default.load(node.value);
+    }
+    catch {
+        return { data: {}, bodyOffset: node.position?.end.offset ?? 0 };
+    }
+    const data = parsed && typeof parsed === 'object' && !Array.isArray(parsed)
+        ? parsed
+        : {};
+    return { data, bodyOffset: node.position?.end.offset ?? 0 };
+};
+exports.extractFrontmatter = extractFrontmatter;
+//# sourceMappingURL=mdx-ast.js.map

package/src/mcp-server/mdx-ast.js.map

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

package/src/mcp-server/option-filter.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Predicate helpers for `<OptionFilter when>` / `<TabItem _filter>`.
+ * Parses the estree AST that remark-mdx attaches to each attribute value
+ * — we never evaluate arbitrary JS; only string/number/boolean literals and
+ * arrays of them are allowed so the same helpers can run in the browser
+ * and in the user's shell.
+ */
+import type { Node as EstreeNode } from 'estree';
+export type Predicate = Record<string, string[]>;
+/**
+ * Turn the `data.estree` of an `MdxJsxAttributeValueExpression` into a
+ * `Predicate`. The estree is a Program wrapping a single ObjectExpression.
+ */
+export declare const parseWhenExpression: (estree: EstreeNode) => Predicate;
+/**
+ * AND across keys, OR within a key's values, `not` negates. A key not
+ * present in `options` is "no opinion". A predicate whose keys have no
+ * intersection with `options` short-circuits to true.
+ */
+export declare const evaluatePredicate: (predicate: Predicate, not: boolean, options: Record<string, string>) => boolean;
+/** Short human label used on the docs pill and in the `> [!NOTE] Only when …` marker. */
+export declare const describePredicate: (predicate: Predicate, not: boolean) => string;
+/**
+ * Extract a `string[]` from the estree of an attribute-value expression
+ * like `{['a', 'b']}`. Used by JSX attribute readers (e.g. the
+ * `commands={[...]}` prop on <NxCommands>). Throws if anything other than
+ * string / number / boolean literal array elements are encountered.
+ */
+export declare const extractStringArrayExpression: (estree: EstreeNode) => string[];