@aws/nx-plugin 1.0.0-rc.9 → 1.0.0-rc.90

package/src/license/sync/project-file-sync.js.map

@@ -1 +1 @@
-{"version":3,"file":"project-file-sync.js","sourceRoot":"","sources":["../../../../../../packages/nx-plugin/src/license/sync/project-file-sync.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,uCAKoB;AACpB,2CAA8C;AAG9C;;GAEG;AACU,QAAA,qBAAqB,GAAG;IACnC,SAAS;IACT,cAAc;IACd,gBAAgB;CACR,CAAC;AAIX;;GAEG;AACH,MAAM,eAAe,GAGjB;IACF,OAAO,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE;QACrC,IAAA,sBAAa,EACX,IAAI,EACJ,IAAA,0BAAiB,EAAC,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,EAC9D,WAAW,EACX;YACE,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,IAAI,EAAE,MAAM,CAAC,aAAa;SAC3B,EACD,EAAE,CACH,CAAC;IACJ,CAAC;IACD,cAAc,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE;QAC5C,MAAM,eAAe,GAAG,IAAA,0BAAiB,EAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QACvE,IAAI,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC;YACjC,IAAA,mBAAU,EAAC,IAAI,EAAE,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC3C,GAAG,IAAI;gBACP,OAAO,EAAE,MAAM,CAAC,IAAI;aACrB,CAAC,CAAC,CAAC;QACN,CAAC;IACH,CAAC;IACD,gBAAgB,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE;QAC9C,MAAM,aAAa,GAAG,IAAA,0BAAiB,EAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;QACvE,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;YAC/B,IAAA,iBAAU,EAAC,IAAI,EAAE,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACzC,GAAG,IAAI;gBACP,OAAO,EAAE,MAAM,CAAC,IAAI;gBACpB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAA,0BAAiB,EAAC,WAAW,EAAE,SAAS,CAAC,CAAC;oBACxD,CAAC,CAAC;wBACE,eAAe,EAAE,CAAC,SAAS,CAAC;qBAC7B;oBACH,CAAC,CAAC,EAAE,CAAC;aACR,CAAC,CAAC,CAAC;QACN,CAAC;IACH,CAAC;CACF,CAAC;AAEF;;GAEG;AACI,MAAM,eAAe,GAAG,CAC7B,IAAU,EACV,WAAmB,EACnB,WAAmD,EACnD,MAA2B,EAC3B,EAAE;IACF,OAAO,eAAe,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;AACjE,CAAC,CAAC;AAPW,QAAA,eAAe,mBAO1B"}
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/license/sync/project-file-sync.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  generateFiles,\n  joinPathFragments,\n  type Tree,\n  updateJson,\n} from '@nx/devkit';\nimport { updateToml } from '../../utils/toml.js';\nimport type { LicenseSourceConfig } from '../config-types.js';\n\n/**\n * Different project files with licensing information to be synchronised\n */\nexport const PROJECT_FILES_TO_SYNC = [\n  'LICENSE',\n  'package.json',\n  'pyproject.toml',\n] as const;\n\nexport type ProjectFileToSync = (typeof PROJECT_FILES_TO_SYNC)[number];\n\n/**\n * Methods to sync each type of project file\n */\nconst SYNC_STRATEGIES: Record<\n  ProjectFileToSync,\n  (tree: Tree, projectRoot: string, config: LicenseSourceConfig) => void\n> = {\n  LICENSE: (tree, projectRoot, config) => {\n    generateFiles(\n      tree,\n      joinPathFragments(import.meta.dirname, 'files', 'licenses', config.spdx),\n      projectRoot,\n      {\n        copyrightHolder: config.copyrightHolder,\n        year: config.copyrightYear,\n      },\n      {},\n    );\n  },\n  'package.json': (tree, projectRoot, config) => {\n    const packageJsonPath = joinPathFragments(projectRoot, 'package.json');\n    if (tree.exists(packageJsonPath)) {\n      updateJson(tree, packageJsonPath, (prev) => ({\n        ...prev,\n        license: config.spdx,\n      }));\n    }\n  },\n  'pyproject.toml': (tree, projectRoot, config) => {\n    const pyProjectPath = joinPathFragments(projectRoot, 'pyproject.toml');\n    if (tree.exists(pyProjectPath)) {\n      updateToml(tree, pyProjectPath, (prev) => ({\n        ...prev,\n        license: config.spdx,\n        ...(tree.exists(joinPathFragments(projectRoot, 'LICENSE'))\n          ? {\n              'license-files': ['LICENSE'],\n            }\n          : {}),\n      }));\n    }\n  },\n};\n\n/**\n * Synchronise a particular project file\n */\nexport const syncProjectFile = (\n  tree: Tree,\n  projectRoot: string,\n  projectFile: (typeof PROJECT_FILES_TO_SYNC)[number],\n  config: LicenseSourceConfig,\n) => {\n  return SYNC_STRATEGIES[projectFile](tree, projectRoot, config);\n};\n"],"names":["generateFiles","joinPathFragments","updateJson","updateToml","PROJECT_FILES_TO_SYNC","SYNC_STRATEGIES","LICENSE","tree","projectRoot","config","dirname","spdx","copyrightHolder","year","copyrightYear","packageJsonPath","exists","prev","license","pyProjectPath","syncProjectFile","projectFile"],"mappings":"AAAA;;;CAGC,GACD,SACEA,aAAa,EACbC,iBAAiB,EAEjBC,UAAU,QACL,aAAa;AACpB,SAASC,UAAU,QAAQ,sBAAsB;AAGjD;;CAEC,GACD,OAAO,MAAMC,wBAAwB;IACnC;IACA;IACA;CACD,CAAU;AAIX;;CAEC,GACD,MAAMC,kBAGF;IACFC,SAAS,CAACC,MAAMC,aAAaC;QAC3BT,cACEO,MACAN,kBAAkB,YAAYS,OAAO,EAAE,SAAS,YAAYD,OAAOE,IAAI,GACvEH,aACA;YACEI,iBAAiBH,OAAOG,eAAe;YACvCC,MAAMJ,OAAOK,aAAa;QAC5B,GACA,CAAC;IAEL;IACA,gBAAgB,CAACP,MAAMC,aAAaC;QAClC,MAAMM,kBAAkBd,kBAAkBO,aAAa;QACvD,IAAID,KAAKS,MAAM,CAACD,kBAAkB;YAChCb,WAAWK,MAAMQ,iBAAiB,CAACE,OAAU,CAAA;oBAC3C,GAAGA,IAAI;oBACPC,SAAST,OAAOE,IAAI;gBACtB,CAAA;QACF;IACF;IACA,kBAAkB,CAACJ,MAAMC,aAAaC;QACpC,MAAMU,gBAAgBlB,kBAAkBO,aAAa;QACrD,IAAID,KAAKS,MAAM,CAACG,gBAAgB;YAC9BhB,WAAWI,MAAMY,eAAe,CAACF,OAAU,CAAA;oBACzC,GAAGA,IAAI;oBACPC,SAAST,OAAOE,IAAI;oBACpB,GAAIJ,KAAKS,MAAM,CAACf,kBAAkBO,aAAa,cAC3C;wBACE,iBAAiB;4BAAC;yBAAU;oBAC9B,IACA,CAAC,CAAC;gBACR,CAAA;QACF;IACF;AACF;AAEA;;CAEC,GACD,OAAO,MAAMY,kBAAkB,CAC7Bb,MACAC,aACAa,aACAZ;IAEA,OAAOJ,eAAe,CAACgB,YAAY,CAACd,MAAMC,aAAaC;AACzD,EAAE"}

package/src/mcp-server/dev-server.d.ts

@@ -0,0 +1 @@
+export {};

package/src/mcp-server/dev-server.js

@@ -0,0 +1,18 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ import { startMcpServer } from "./index.js";
+/**
+ * Entry point for the `mcp-inspect` target, which runs the server from source
+ * with live reload. The published server is `@aws/nx-plugin-mcp`, whose bundled
+ * entry point resolves `generators.json` relative to itself and so only works
+ * once built.
+ */ void (async ()=>{
+    try {
+        await startMcpServer();
+    } catch (e) {
+        console.error(e);
+    }
+})();
+
+//# sourceMappingURL=dev-server.js.map

package/src/mcp-server/dev-server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/nx-plugin/src/mcp-server/dev-server.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport { startMcpServer } from './index.js';\n\n/**\n * Entry point for the `mcp-inspect` target, which runs the server from source\n * with live reload. The published server is `@aws/nx-plugin-mcp`, whose bundled\n * entry point resolves `generators.json` relative to itself and so only works\n * once built.\n */\nvoid (async () => {\n  try {\n    await startMcpServer();\n  } catch (e) {\n    console.error(e);\n  }\n})();\n"],"names":["startMcpServer","e","console","error"],"mappings":"AAAA;;;CAGC,GACD,SAASA,cAAc,QAAQ,aAAa;AAE5C;;;;;CAKC,GACD,KAAK,AAAC,CAAA;IACJ,IAAI;QACF,MAAMA;IACR,EAAE,OAAOC,GAAG;QACVC,QAAQC,KAAK,CAACF;IAChB;AACF,CAAA"}

package/src/mcp-server/generator-info.d.ts

@@ -2,13 +2,18 @@
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { NxGeneratorInfo } from '../utils/generators';
-export { buildNxCommand } from './guide-render';
+import type { NxGeneratorInfo } from '../utils/generators.js';
+export { buildNxCommand } from './guide-render.js';
+/**
+ * Warn agents that an experimental generator's output may change in a future
+ * release without a migration to carry an existing workspace across.
+ */
+export declare const renderExperimentalWarning: (generatorId: string) => string;
 /**
  * Render summary information about a generator
  */
 export declare const renderGeneratorInfo: (packageManager: string, info: NxGeneratorInfo) => string;
-export type FilterableOption = import('./schema-registry').FilterableOption;
+export type FilterableOption = import('./schema-registry.js').FilterableOption;
 /**
  * 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

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

@@ -1,39 +1,35 @@
-"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.postProcessGuide = exports.fetchSnippet = exports.fetchGuidePages = exports.fetchGuideFrontmatters = exports.fetchGuidePagesForGenerator = exports.renderFilterableOptionsAsync = exports.loadFilterableOptionsFromSchema = exports.renderGeneratorInfo = exports.buildNxCommand = void 0;
-const tslib_1 = require("tslib");
-const fs_1 = tslib_1.__importDefault(require("fs"));
-const path_1 = tslib_1.__importDefault(require("path"));
-const names_1 = require("../utils/names");
-const guide_pipeline_1 = require("./guide-pipeline");
-const guide_render_1 = require("./guide-render");
-const mdx_ast_1 = require("./mdx-ast");
-const option_filter_1 = require("./option-filter");
-const schema_registry_1 = require("./schema-registry");
+ */ import fs from "fs";
+import path from "path";
+import { kebabCase } from "../utils/names.js";
+import { parseMdx, postProcessGuideWithRemark } from "./guide-pipeline.js";
+import { renderGeneratorCommand, renderSchema } from "./guide-render.js";
+import { collectFilterableKeysFromJsx, extractFrontmatter } from "./mdx-ast.js";
+import { evaluatePredicate } from "./option-filter.js";
+import { filterableOptionsFromSchema } from "./schema-registry.js";
 // 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; } });
+export { buildNxCommand } from "./guide-render.js";
+/**
+ * Warn agents that an experimental generator's output may change in a future
+ * release without a migration to carry an existing workspace across.
+ */ export const renderExperimentalWarning = (generatorId)=>`> [!WARNING] Experimental: the \`${generatorId}\` generator's behaviour and generated output may change in a future release without a migration being published to apply the change to an existing workspace.`;
 /**
  * Render summary information about a generator
- */
-const renderGeneratorInfo = (packageManager, info) => {
-    const schema = JSON.parse(fs_1.default.readFileSync(info.resolvedSchemaPath, 'utf-8'));
+ */ export const renderGeneratorInfo = (packageManager, info)=>{
+    const schema = JSON.parse(fs.readFileSync(info.resolvedSchemaPath, 'utf-8'));
     return `${info.id}
 
 Description: ${info.description}
-
+${info.experimental ? `\n${renderExperimentalWarning(info.id)}\n` : ''}
 Available Parameters:
-${(0, guide_render_1.renderSchema)(schema)}
+${renderSchema(schema)}
 
 Command:
-${(0, guide_render_1.renderGeneratorCommand)(info.id, schema, packageManager)}
+${renderGeneratorCommand(info.id, schema, packageManager)}
 `;
 };
-exports.renderGeneratorInfo = renderGeneratorInfo;
 /**
  * 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
@@ -42,42 +38,40 @@ exports.renderGeneratorInfo = renderGeneratorInfo;
  * 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) => {
+ */ export const loadFilterableOptionsFromSchema = (info)=>{
     try {
-        const schema = JSON.parse(fs_1.default.readFileSync(info.resolvedSchemaPath, 'utf-8'));
-        return (0, schema_registry_1.filterableOptionsFromSchema)(schema);
-    }
-    catch {
+        const schema = JSON.parse(fs.readFileSync(info.resolvedSchemaPath, 'utf-8'));
+        return 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 collectFrontmatterFilterableOptions = (fetched, fromSchema)=>{
     const extras = new Map();
-    for (const guide of fetched) {
+    for (const guide of fetched){
         const when = guide.frontmatter.when;
-        if (!when)
-            continue;
-        for (const [key, rawValues] of Object.entries(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);
+            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] });
+    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;
 };
@@ -91,51 +85,39 @@ const collectFrontmatterFilterableOptions = (fetched, fromSchema) => {
  * 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;
+ */ 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;
+    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;
+    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(' | ')}`);
+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');
+    }).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.
-
+${info.experimental ? `\n${renderExperimentalWarning(info.id)}\n` : ''}
 Supported combinations:
 ${supportedList}
 
@@ -154,31 +136,25 @@ Pick a combination from the list above, or choose a different generator.`;
  *     guide pages.
  *   - Per-page `when:` frontmatter blocks (multi-variant generators like
  *     `connection`).
- */
-const renderFilterableOptionsAsync = async (info) => {
-    const fetched = await (0, exports.fetchGuideFrontmatters)(info);
+ */ export const renderFilterableOptionsAsync = async (info)=>{
+    const fetched = await fetchGuideFrontmatters(info);
     const referenced = new Set();
-    for (const g of fetched) {
-        for (const k of g.referencedKeys)
-            referenced.add(k);
+    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 schemaOptions = loadFilterableOptionsFromSchema(info).filter((o)=>referenced.has(o.key));
     const frontmatterOptions = collectFrontmatterFilterableOptions(fetched, schemaOptions);
     return formatFilterableOptions(info, [
         ...schemaOptions,
-        ...frontmatterOptions,
+        ...frontmatterOptions
     ]);
 };
-exports.renderFilterableOptionsAsync = renderFilterableOptionsAsync;
-const formatFilterableOptions = (_info, filterable) => {
-    if (filterable.length === 0)
-        return '';
-    const entries = filterable
-        .map((opt) => {
+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');
+    }).join('\n');
     return `\`generator-guide\` options:\n${entries}`;
 };
 /**
@@ -197,52 +173,60 @@ const formatFilterableOptions = (_info, filterable) => {
  * 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, options) => {
-    const fetched = await (0, exports.fetchGuideFrontmatters)(info);
+ */ export const fetchGuidePagesForGenerator = async (info, generators, packageManager, snippetContentProvider, options)=>{
+    const fetched = await fetchGuideFrontmatters(info);
     const unsupported = describeUnsupportedCombinationFromFetched(info, fetched, options);
     if (unsupported !== undefined) {
-        return { kind: 'unsupported', content: unsupported };
+        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 kept = fetched.filter((g)=>{
+        if (!g.frontmatter.when) return true;
+        if (!options) return true;
+        return 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') };
+    const processed = await Promise.all(kept.map((g)=>postProcessGuide(g.body, generators, packageManager, snippetContentProvider, options)));
+    return {
+        kind: 'ok',
+        content: processed.join('\n\n')
+    };
 };
-exports.fetchGuidePagesForGenerator = fetchGuidePagesForGenerator;
 /**
  * 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) })));
+ */ export const fetchGuideFrontmatters = async (info)=>{
+    const pages = [
+        ...info.guidePages ?? [
+            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);
+    for (const r of results){
+        if (r.status === 'fulfilled' && r.value.raw) fulfilled.push(r.value);
     }
-    return Promise.all(fulfilled.map(async ({ page, raw }) => {
+    return Promise.all(fulfilled.map(async ({ page, raw })=>{
         const parsed = await parseGuide(raw);
-        return { page, raw, ...parsed };
+        return {
+            page,
+            raw,
+            ...parsed
+        };
     }));
 };
-exports.fetchGuideFrontmatters = fetchGuideFrontmatters;
 /**
  * Read a guide's raw MDX from the local filesystem (bundled or monorepo).
- */
-const fetchGuideRaw = async (page) => {
+ */ const fetchGuideRaw = async (page)=>{
     const local = fetchLocalGuide(page);
-    if (local !== undefined)
-        return local;
+    if (local !== undefined) return local;
     return '';
 };
 /**
@@ -250,90 +234,95 @@ const fetchGuideRaw = async (page) => {
  * 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 parseGuide = async (raw)=>{
+    const tree = await parseMdx(raw);
+    const { data, bodyOffset } = extractFrontmatter(tree);
     const body = raw.slice(bodyOffset).replace(/^\r?\n/, '');
     const frontmatter = {};
-    if (typeof data.title === 'string')
-        frontmatter.title = data.title;
+    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)];
+        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),
+        referencedKeys: collectFilterableKeysFromJsx(tree)
     };
 };
 /**
- * Probe paths for finding guide MDX files locally. Checked in order:
+ * Base directories to probe for guide MDX files, relative to this module.
+ * Each is checked in order:
  * 1. Bundled docs in the published @aws/nx-plugin-mcp package
  * 2. Source checkout when running from the monorepo (dev/test)
  * 3. Rolldown-bundled binary in dist/ (monorepo layout)
- */
-const GUIDES_RELATIVE_PROBES = [
-    // Bundled docs inside published @aws/nx-plugin-mcp package (bin/ → ../docs/guides)
-    '../docs/guides',
+ */ const GUIDE_BASE_PROBES = [
+    // Bundled docs inside published @aws/nx-plugin-mcp package (bin/ → ../docs)
+    '../docs',
     // nx-plugin package compiled from source (src/mcp-server/…)
-    '../../../docs/src/content/docs/en/guides',
+    '../../../docs/src/content/docs/en',
     // rolldown-bundled `@aws/nx-plugin-mcp` binary in dist (monorepo layout)
-    '../../../../docs/src/content/docs/en/guides',
+    '../../../../docs/src/content/docs/en'
 ];
-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 {
+/**
+ * Content sub-directories that hold pages a generator may reference via
+ * `guidePages`. Both the per-generator reference guides (`guides/`) and the
+ * getting-started pages (`get_started/`) are fetchable, so a page can live in
+ * whichever section reads best for humans while still being served by the MCP
+ * tools. Bare `guidePages` names may also include a sub-path (e.g.
+ * `connection/react-trpc`).
+ */ const GUIDE_SECTIONS = [
+    'guides',
+    'get_started'
+];
+const fetchLocalGuide = (guide)=>{
+    for (const base of GUIDE_BASE_PROBES){
+        for (const section of GUIDE_SECTIONS){
+            const candidate = path.resolve(import.meta.dirname, base, section, `${guide}.mdx`);
+            try {
+                if (fs.existsSync(candidate)) {
+                    return fs.readFileSync(candidate, 'utf-8');
+                }
+            } catch  {
             // Probe failure → keep looking.
+            }
         }
     }
     return undefined;
 };
 /**
  * Fetch markdown guide pages from the local filesystem (bundled or monorepo).
- */
-const fetchGuidePages = async (guidePages, generators, packageManager, snippetContentProvider, options) => {
-    const guides = guidePages
-        .map((guide) => fetchLocalGuide(guide))
-        .filter((content) => content !== undefined);
-    const processed = await Promise.all(guides.map((content) => (0, exports.postProcessGuide)(content, generators, packageManager, snippetContentProvider, options)));
+ */ export const fetchGuidePages = async (guidePages, generators, packageManager, snippetContentProvider, options)=>{
+    const guides = guidePages.map((guide)=>fetchLocalGuide(guide)).filter((content)=>content !== undefined);
+    const processed = await Promise.all(guides.map((content)=>postProcessGuide(content, generators, packageManager, snippetContentProvider, options)));
     return processed.join('\n\n');
 };
-exports.fetchGuidePages = fetchGuidePages;
 const SNIPPETS_RELATIVE_PROBES = [
     // Bundled docs inside published @aws/nx-plugin-mcp package (bin/ → ../docs/snippets)
     '../docs/snippets',
     '../../../docs/src/content/docs/en/snippets',
-    '../../../../docs/src/content/docs/en/snippets',
+    '../../../../docs/src/content/docs/en/snippets'
 ];
 /**
  * Fetch a snippet's content from the local filesystem (bundled or monorepo).
- */
-const fetchSnippet = async (snippetName) => {
-    for (const rel of SNIPPETS_RELATIVE_PROBES) {
-        const candidate = path_1.default.resolve(__dirname, rel, `${snippetName}.mdx`);
+ */ export const fetchSnippet = async (snippetName)=>{
+    for (const rel of SNIPPETS_RELATIVE_PROBES){
+        const candidate = path.resolve(import.meta.dirname, rel, `${snippetName}.mdx`);
         try {
-            if (fs_1.default.existsSync(candidate)) {
-                return fs_1.default.readFileSync(candidate, 'utf-8');
+            if (fs.existsSync(candidate)) {
+                return fs.readFileSync(candidate, 'utf-8');
             }
-        }
-        catch {
-            // Probe failure — try next path.
+        } catch  {
+        // Probe failure — try next path.
         }
     }
     return '';
 };
-exports.fetchSnippet = fetchSnippet;
 /**
  * Post-process a guide page. Thin wrapper around the unified/remark-mdx
  * pipeline in `guide-pipeline.ts` — the real work (snippet inlining,
@@ -341,14 +330,13 @@ exports.fetchSnippet = fetchSnippet;
  * 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, options) => {
-    return (0, guide_pipeline_1.postProcessGuideWithRemark)(guide, {
+ */ export const postProcessGuide = async (guide, generators, packageManager, snippetContentProvider, options)=>{
+    return postProcessGuideWithRemark(guide, {
         generators,
         packageManager,
-        snippetContentProvider: snippetContentProvider ?? exports.fetchSnippet,
-        options,
+        snippetContentProvider: snippetContentProvider ?? fetchSnippet,
+        options
     });
 };
-exports.postProcessGuide = postProcessGuide;
+
 //# sourceMappingURL=generator-info.js.map