ma-agents 3.18.0-beta.2 → 3.18.0

package/lib/bmad-cache/gds/website/astro.config.mjs

@@ -1,142 +0,0 @@
-// @ts-check
-import { defineConfig } from 'astro/config';
-import starlight from '@astrojs/starlight';
-import sitemap from '@astrojs/sitemap';
-import rehypeMarkdownLinks from './src/rehype-markdown-links.js';
-import rehypeBasePaths from './src/rehype-base-paths.js';
-import { getSiteUrl } from './src/lib/site-url.mjs';
-
-const siteUrl = getSiteUrl();
-const urlParts = new URL(siteUrl);
-// Normalize basePath: ensure trailing slash so links can use `${BASE_URL}path`
-const basePath = urlParts.pathname === '/' ? '/' : urlParts.pathname.endsWith('/') ? urlParts.pathname : urlParts.pathname + '/';
-
-export default defineConfig({
-  site: `${urlParts.origin}${basePath}`,
-  base: basePath,
-  outDir: '../build/site',
-
-  // Disable aggressive caching in dev mode
-  vite: {
-    optimizeDeps: {
-      force: true, // Always re-bundle dependencies
-    },
-    server: {
-      watch: {
-        usePolling: false, // Set to true if file changes aren't detected
-      },
-    },
-  },
-
-  markdown: {
-    rehypePlugins: [
-      [rehypeMarkdownLinks, { base: basePath }],
-      [rehypeBasePaths, { base: basePath }],
-    ],
-  },
-
-  integrations: [
-    sitemap(),
-    starlight({
-      title: 'BMad Game Dev Studio',
-      tagline: 'Game development (Unity, Unreal, Godot) module for the BMad Method.',
-
-      favicon: '/favicon.ico',
-
-      // Social links
-      social: [
-        { icon: 'discord', label: 'Discord', href: 'https://discord.gg/gk8jAdXWmj' },
-        { icon: 'github', label: 'GitHub', href: 'https://github.com/bmad-code-org/bmad-module-game-dev-studio' },
-        { icon: 'youtube', label: 'YouTube', href: 'https://www.youtube.com/@BMadCode' },
-      ],
-
-      // Show last updated timestamps
-      lastUpdated: true,
-
-      // Custom head tags for LLM discovery
-      head: [
-        {
-          tag: 'meta',
-          attrs: {
-            name: 'ai-terms',
-            content: `AI-optimized documentation: ${siteUrl}/llms-full.txt (plain text). Index: ${siteUrl}/llms.txt`,
-          },
-        },
-        {
-          tag: 'meta',
-          attrs: {
-            name: 'llms-full',
-            content: `${siteUrl}/llms-full.txt`,
-          },
-        },
-        {
-          tag: 'meta',
-          attrs: {
-            name: 'llms',
-            content: `${siteUrl}/llms.txt`,
-          },
-        },
-      ],
-
-      // Custom CSS
-      customCss: ['./src/styles/custom.css'],
-
-      // Sidebar configuration (Diataxis structure)
-      sidebar: [
-        { label: 'Welcome', slug: 'index' },
-        {
-          label: 'Tutorials',
-          collapsed: false,
-          autogenerate: { directory: 'tutorials' },
-        },
-        {
-          label: 'How-To Guides',
-          collapsed: true,
-          autogenerate: { directory: 'how-to' },
-        },
-        {
-          label: 'Explanation',
-          collapsed: true,
-          autogenerate: { directory: 'explanation' },
-        },
-        {
-          label: 'Reference',
-          collapsed: true,
-          autogenerate: { directory: 'reference' },
-        },
-        {
-          label: 'BMad Ecosystem',
-          collapsed: false,
-          items: [
-            { label: 'BMad Method', link: 'https://docs.bmad-method.org/', attrs: { target: '_blank' } },
-            { label: 'BMad Builder', link: 'https://bmad-builder-docs.bmad-method.org/', attrs: { target: '_blank' } },
-            { label: 'Creative Intelligence Suite', link: 'https://cis-docs.bmad-method.org/', attrs: { target: '_blank' } },
-            {
-              label: 'Test Architect (TEA)',
-              link: 'https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/',
-              attrs: { target: '_blank' },
-            },
-          ],
-        },
-      ],
-
-      // Credits in footer
-      credits: false,
-
-      // Pagination
-      pagination: false,
-
-      // Use our docs/404.md instead of Starlight's built-in 404
-      disable404Route: true,
-
-      // Custom components
-      components: {
-        Header: './src/components/Header.astro',
-        MobileMenuFooter: './src/components/MobileMenuFooter.astro',
-      },
-
-      // Table of contents
-      tableOfContents: { minHeadingLevel: 2, maxHeadingLevel: 3 },
-    }),
-  ],
-});

package/lib/bmad-cache/gds/website/src/components/Banner.astro

@@ -1,71 +0,0 @@
----
-import { getSiteUrl } from '../lib/site-url.mjs';
-
-const llmsFullUrl = `${getSiteUrl()}/llms-full.txt`;
----
-
-<div class="ai-banner">
-  <span>🤖 AI-optimized docs: <a href={llmsFullUrl}>llms-full.txt</a></span>
-</div>
-<div class="announce-banner">
-  <span>🚀 Build your own BMad modules and share them with the community! <a href="https://bmad-builder-docs.bmad-method.org/tutorials/build-your-first-module/">Get started</a> or <a href="https://bmad-builder-docs.bmad-method.org/how-to/distribute-your-module/">submit to the marketplace</a>.</span>
-</div>
-
-<style>
-  .ai-banner,
-  .announce-banner {
-    width: 100vw;
-    margin-left: calc(-50vw + 50%);
-    height: var(--ai-banner-height, 2.75rem);
-    background: #1a1a1a;
-    color: #a1a1a1;
-    padding: 0.5rem 1rem;
-    font-size: 0.875rem;
-    border-bottom: 1px solid #262626;
-    display: flex;
-    align-items: center;
-    justify-content: center;
-    box-sizing: border-box;
-    font-family: 'Inter', system-ui, sans-serif;
-  }
-
-  .ai-banner span,
-  .announce-banner span {
-    white-space: nowrap;
-    overflow: hidden;
-    text-overflow: ellipsis;
-    max-width: 100%;
-  }
-  .ai-banner a,
-  .announce-banner a {
-    color: #3b82f6;
-    text-decoration: none;
-    font-weight: 600;
-  }
-  .ai-banner a:hover,
-  .announce-banner a:hover {
-    color: #fafafa;
-    text-decoration: underline;
-  }
-
-  .announce-banner {
-    background: #1a2332;
-    border-bottom: 1px solid #1e3a5f;
-  }
-
-  @media (min-width: 50rem) {
-    .ai-banner,
-    .announce-banner {
-      padding-left: 2.5rem;
-      padding-right: 2.5rem;
-    }
-  }
-
-  @media (min-width: 72rem) {
-    .ai-banner,
-    .announce-banner {
-      padding-left: 3rem;
-      padding-right: 3rem;
-    }
-  }
-</style>

package/lib/bmad-cache/gds/website/src/components/Header.astro

@@ -1,94 +0,0 @@
----
-import config from 'virtual:starlight/user-config';
-import type { Props } from '@astrojs/starlight/props';
-
-import LanguageSelect from 'virtual:starlight/components/LanguageSelect';
-import Search from 'virtual:starlight/components/Search';
-import SiteTitle from 'virtual:starlight/components/SiteTitle';
-import SocialIcons from 'virtual:starlight/components/SocialIcons';
-import ThemeSelect from 'virtual:starlight/components/ThemeSelect';
-import Banner from './Banner.astro';
-/**
- * Render the `Search` component if Pagefind is enabled or the default search component has been overridden.
- */
-const shouldRenderSearch =
-	config.pagefind || config.components.Search !== '@astrojs/starlight/components/Search.astro';
----
-
-<Banner />
-<div class="header sl-flex">
-	<div class="title-wrapper sl-flex">
-		<SiteTitle {...Astro.props} />
-	</div>
-	<div class="sl-flex print:hidden">
-		{shouldRenderSearch && <Search {...Astro.props} />}
-	</div>
-	<div class="sl-hidden md:sl-flex print:hidden right-group">
-		<div class="sl-flex social-icons">
-			<SocialIcons {...Astro.props} />
-		</div>
-		<ThemeSelect {...Astro.props} />
-		<LanguageSelect {...Astro.props} />
-	</div>
-</div>
-
-<style>
-	.header {
-		gap: var(--sl-nav-gap);
-		justify-content: space-between;
-		align-items: center;
-		height: 100%;
-	}
-
-	.title-wrapper {
-		/* Prevent long titles overflowing and covering the search and menu buttons on narrow viewports. */
-		overflow: clip;
-		/* Avoid clipping focus ring around link inside title wrapper. */
-		padding: 0.25rem;
-		margin: -0.25rem;
-		min-width: 0;
-	}
-
-	.right-group,
-	.social-icons {
-		gap: 1rem;
-		align-items: center;
-	}
-
-	.social-icons::after {
-		content: '';
-		height: 2rem;
-		border-inline-end: 1px solid var(--sl-color-gray-5);
-	}
-
-	@media (min-width: 50rem) {
-		:global(:root[data-has-sidebar]) {
-			--__sidebar-pad: calc(2 * var(--sl-nav-pad-x));
-		}
-		:global(:root:not([data-has-toc])) {
-			--__toc-width: 0rem;
-		}
-		.header {
-			--__sidebar-width: max(0rem, var(--sl-content-inline-start, 0rem) - var(--sl-nav-pad-x));
-			--__main-column-fr: calc(
-				(
-						100% + var(--__sidebar-pad, 0rem) - var(--__toc-width, var(--sl-sidebar-width)) -
-							(2 * var(--__toc-width, var(--sl-nav-pad-x))) - var(--sl-content-inline-start, 0rem) -
-							var(--sl-content-width)
-					) / 2
-			);
-			display: grid;
-			grid-template-columns:
-        /* 1 (site title): runs up until the main content column's left edge or the width of the title, whichever is the largest  */
-				minmax(
-					calc(var(--__sidebar-width) + max(0rem, var(--__main-column-fr) - var(--sl-nav-gap))),
-					auto
-				)
-				/* 2 (search box): all free space that is available. */
-				1fr
-				/* 3 (right items): use the space that these need. */
-				auto;
-			align-content: center;
-		}
-	}
-</style>

package/lib/bmad-cache/gds/website/src/components/MobileMenuFooter.astro

@@ -1,33 +0,0 @@
----
-import LanguageSelect from 'virtual:starlight/components/LanguageSelect';
-import SocialIcons from 'virtual:starlight/components/SocialIcons';
-import ThemeSelect from 'virtual:starlight/components/ThemeSelect';
-import type { Props } from '@astrojs/starlight/props';
----
-
-<div class="mobile-preferences sl-flex">
-	<div class="sl-flex social-icons">
-		<SocialIcons {...Astro.props} />
-	</div>
-	<ThemeSelect {...Astro.props} />
-	<LanguageSelect {...Astro.props} />
-</div>
-
-<style>
-	.social-icons {
-		gap: 1rem;
-		align-items: center;
-		padding-block: 1rem;
-	}
-	.social-icons:empty {
-		display: none;
-	}
-	.mobile-preferences {
-		justify-content: space-between;
-		flex-wrap: wrap;
-		border-top: 1px solid var(--sl-color-gray-6);
-		column-gap: 1rem;
-		padding: 0.5rem 0;
-		align-items: center;
-	}
-</style>

package/lib/bmad-cache/gds/website/src/content/config.ts

@@ -1,6 +0,0 @@
-import { defineCollection } from 'astro:content';
-import { docsSchema } from '@astrojs/starlight/schema';
-
-export const collections = {
-  docs: defineCollection({ schema: docsSchema() }),
-};

package/lib/bmad-cache/gds/website/src/content/docs

@@ -1 +0,0 @@
-../../../docs

package/lib/bmad-cache/gds/website/src/lib/site-url.mjs

@@ -1,25 +0,0 @@
-/**
- * Resolve the site's base URL using cascading environment defaults.
- *
- * Preference order: use SITE_URL if set; otherwise derive a GitHub Pages URL from GITHUB_REPOSITORY; otherwise use the local development URL.
- * @returns {string} The resolved site URL (SITE_URL override, or `https://{owner}.github.io/{repo}`, or `http://localhost:3000`).
- */
-export function getSiteUrl() {
-  // Explicit override (works in both local and GitHub Actions)
-  if (process.env.SITE_URL) {
-    return process.env.SITE_URL;
-  }
-
-  // GitHub Actions: compute from repository context
-  if (process.env.GITHUB_REPOSITORY) {
-    const parts = process.env.GITHUB_REPOSITORY.split('/');
-    if (parts.length !== 2 || !parts[0] || !parts[1]) {
-      throw new Error(`Invalid GITHUB_REPOSITORY format: "${process.env.GITHUB_REPOSITORY}". Expected "owner/repo".`);
-    }
-    const [owner, repo] = parts;
-    return `https://${owner}.github.io/${repo}`;
-  }
-
-  // Local development: use dev server
-  return 'http://localhost:3000';
-}

package/lib/bmad-cache/gds/website/src/rehype-base-paths.js

@@ -1,88 +0,0 @@
-/**
- * Rehype plugin to prepend base path to absolute URLs
- *
- * Transforms:
- *   /img/foo.png → /bmad-module-game-dev-studio/img/foo.png (when base is /bmad-module-game-dev-studio/)
- *   /llms.txt → /bmad-module-game-dev-studio/llms.txt
- *
- * Only affects absolute paths (/) - relative paths and external URLs are unchanged.
- * Does NOT process .md links (those are handled by rehype-markdown-links).
- */
-
-import { visit } from 'unist-util-visit';
-
-/**
- * Create a rehype plugin that prepends the base path to absolute URLs.
- *
- * @param {Object} options - Plugin options
- * @param {string} options.base - The base path to prepend (e.g., '/bmad-module-game-dev-studio/')
- * @returns {function} A HAST tree transformer
- */
-export default function rehypeBasePaths(options = {}) {
-  const base = options.base || '/';
-
-  // Normalize base: ensure it ends with / and doesn't have double slashes
-  const normalizedBase = base === '/' ? '/' : base.endsWith('/') ? base : base + '/';
-
-  return (tree) => {
-    visit(tree, 'element', (node) => {
-      // Process img tags with src attribute
-      if (node.tagName === 'img' && node.properties?.src) {
-        const src = node.properties.src;
-
-        if (typeof src === 'string' && src.startsWith('/') && !src.startsWith('//')) {
-          // Don't transform if already has the base path
-          if (normalizedBase !== '/' && !src.startsWith(normalizedBase)) {
-            node.properties.src = normalizedBase + src.slice(1);
-          }
-        }
-      }
-
-      // Process iframe tags with src attribute
-      if (node.tagName === 'iframe' && node.properties?.src) {
-        const src = node.properties.src;
-
-        if (typeof src === 'string' && src.startsWith('/') && !src.startsWith('//')) {
-          // Don't transform if already has the base path
-          if (normalizedBase !== '/' && !src.startsWith(normalizedBase)) {
-            node.properties.src = normalizedBase + src.slice(1);
-          }
-        }
-      }
-
-      // Process anchor tags with href attribute
-      if (node.tagName === 'a' && node.properties?.href) {
-        const href = node.properties.href;
-
-        if (typeof href !== 'string') {
-          return;
-        }
-
-        // Only transform absolute paths starting with / (but not //)
-        if (!href.startsWith('/') || href.startsWith('//')) {
-          return;
-        }
-
-        // Skip if already has the base path
-        if (normalizedBase !== '/' && href.startsWith(normalizedBase)) {
-          return;
-        }
-
-        // Skip .md links - those are handled by rehype-markdown-links
-        // Extract path portion (before ? and #)
-        const firstDelimiter = Math.min(
-          href.indexOf('?') === -1 ? Infinity : href.indexOf('?'),
-          href.indexOf('#') === -1 ? Infinity : href.indexOf('#'),
-        );
-        const pathPortion = firstDelimiter === Infinity ? href : href.substring(0, firstDelimiter);
-
-        if (pathPortion.endsWith('.md')) {
-          return; // Let rehype-markdown-links handle this
-        }
-
-        // Prepend base path
-        node.properties.href = normalizedBase + href.slice(1);
-      }
-    });
-  };
-}

package/lib/bmad-cache/gds/website/src/rehype-markdown-links.js

@@ -1,117 +0,0 @@
-/**
- * Rehype plugin to transform markdown file links (.md) to page routes
- *
- * Transforms:
- *   ./path/to/file.md → ./path/to/file/
- *   ./path/index.md → ./path/ (index.md becomes directory root)
- *   ../path/file.md#anchor → ../path/file/#anchor
- *   ./file.md?query=param → ./file/?query=param
- *   /docs/absolute/path/file.md → {base}/absolute/path/file/
- *
- * For absolute paths starting with /docs/, the /docs prefix is stripped
- * since the Astro site serves content from the docs directory as the root.
- * The base path is prepended to absolute paths for subdirectory deployments.
- *
- * Affects relative links (./, ../) and absolute paths (/) - external links are unchanged
- */
-
-import { visit } from 'unist-util-visit';
-
-/**
- * Convert Markdown file links (.md) into equivalent page route-style links.
- *
- * The returned transformer walks the HTML tree and rewrites anchor `href` values that are relative paths (./, ../) or absolute paths (/) pointing to `.md` files. It preserves query strings and hash anchors, rewrites `.../index.md` to the directory root path (`.../`), and rewrites other `.md` file paths by removing the `.md` extension and ensuring a trailing slash. External links (http://, https://) and non-.md links are left unchanged.
- *
- * @param {Object} options - Plugin options
- * @param {string} options.base - The base path to prepend to absolute URLs (e.g., '/bmad-module-game-dev-studio/')
- * @returns {function} A HAST tree transformer that mutates `a` element `href` properties as described.
- */
-export default function rehypeMarkdownLinks(options = {}) {
-  const base = options.base || '/';
-  // Normalize base: ensure it ends with / and doesn't have double slashes
-  const normalizedBase = base === '/' ? '' : base.endsWith('/') ? base.slice(0, -1) : base;
-
-  return (tree) => {
-    visit(tree, 'element', (node) => {
-      // Only process anchor tags with href
-      if (node.tagName !== 'a' || !node.properties?.href) {
-        return;
-      }
-
-      const href = node.properties.href;
-
-      // Skip if not a string (shouldn't happen, but be safe)
-      if (typeof href !== 'string') {
-        return;
-      }
-
-      // Skip external links (http://, https://, mailto:, etc.)
-      if (href.includes('://') || href.startsWith('mailto:') || href.startsWith('tel:')) {
-        return;
-      }
-
-      // Only transform paths starting with ./, ../, or / (absolute)
-      if (!href.startsWith('./') && !href.startsWith('../') && !href.startsWith('/')) {
-        return;
-      }
-
-      // Extract path portion (before ? and #) to check if it's a .md file
-      const firstDelimiter = Math.min(
-        href.indexOf('?') === -1 ? Infinity : href.indexOf('?'),
-        href.indexOf('#') === -1 ? Infinity : href.indexOf('#'),
-      );
-      const pathPortion = firstDelimiter === Infinity ? href : href.substring(0, firstDelimiter);
-
-      // Don't transform if path doesn't end with .md
-      if (!pathPortion.endsWith('.md')) {
-        return;
-      }
-
-      // Split the URL into parts: path, anchor, and query
-      let urlPath = pathPortion;
-      let anchor = '';
-      let query = '';
-
-      // Extract query string and anchor from original href
-      if (firstDelimiter !== Infinity) {
-        const suffix = href.substring(firstDelimiter);
-        const anchorInSuffix = suffix.indexOf('#');
-        if (suffix.startsWith('?')) {
-          if (anchorInSuffix !== -1) {
-            query = suffix.substring(0, anchorInSuffix);
-            anchor = suffix.substring(anchorInSuffix);
-          } else {
-            query = suffix;
-          }
-        } else {
-          // starts with #
-          anchor = suffix;
-        }
-      }
-
-      // Track if this was an absolute path (for base path prepending)
-      const isAbsolute = urlPath.startsWith('/');
-
-      // Strip /docs/ prefix from absolute paths (repo-relative → site-relative)
-      if (urlPath.startsWith('/docs/')) {
-        urlPath = urlPath.slice(5); // Remove '/docs' prefix, keeping the leading /
-      }
-
-      // Transform .md to /
-      // Special case: index.md → directory root (e.g., ./tutorials/index.md → ./tutorials/)
-      if (urlPath.endsWith('/index.md')) {
-        urlPath = urlPath.replace(/\/index\.md$/, '/');
-      } else {
-        urlPath = urlPath.replace(/\.md$/, '/');
-      }
-
-      // Prepend base path to absolute URLs for subdirectory deployments
-      if (isAbsolute && normalizedBase) {
-        urlPath = normalizedBase + urlPath;
-      }
-
-      // Reconstruct the href
-      node.properties.href = urlPath + query + anchor;
-    });
-  };
-}