npm - bmad-method - Versions diffs - 5.1.2 → 6.0.0-Beta.0 - Mend

bmad-method 5.1.2 → 6.0.0-Beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (739) hide show

package/website/public/workflow-map-diagram.html ADDED Viewed

@@ -0,0 +1,361 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>BMad Method Workflow Map</title>
+    <style>
+        :root {
+            --analysis: #0ea5e9;
+            --planning: #22c55e;
+            --solutioning: #eab308;
+            --implementation: #ef4444;
+            --quickflow: #64748b;
+            --bg: #0f172a;
+            --card: #1e293b;
+            --text: #f8fafc;
+            --text-muted: #94a3b8;
+            --border: #334155;
+            --success: #10b981;
+            --arrow: #f59e0b;
+        }
+        * { margin: 0; padding: 0; box-sizing: border-box; }
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+            background: var(--bg);
+            color: var(--text);
+            line-height: 1.4;
+            padding: 12px;
+        }
+        .header { text-align: center; margin-bottom: 16px; }
+        .header-badge {
+            display: inline-flex; align-items: center; gap: 6px;
+            background: linear-gradient(135deg, var(--analysis), var(--planning));
+            padding: 4px 12px; border-radius: 20px;
+            font-size: 0.75rem; font-weight: 600; margin-bottom: 8px;
+        }
+        h1 { font-size: 1.5rem; font-weight: 700; }
+        .subtitle { color: var(--text-muted); font-size: 0.8rem; }
+        .flow-legend {
+            background: rgba(245, 158, 11, 0.1); border: 1px solid rgba(245, 158, 11, 0.3);
+            border-radius: 8px; padding: 8px 12px; margin-bottom: 16px; text-align: center;
+            font-size: 0.7rem; color: var(--arrow);
+        }
+        .flow-grid {
+            display: grid;
+            grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
+            gap: 8px;
+            margin-bottom: 16px;
+        }
+        .phase {
+            background: var(--card);
+            border-radius: 10px;
+            border: 1px solid var(--border);
+            border-top: 3px solid;
+        }
+        .phase.analysis { border-top-color: var(--analysis); }
+        .phase.planning { border-top-color: var(--planning); }
+        .phase.solutioning { border-top-color: var(--solutioning); }
+        .phase.implementation { border-top-color: var(--implementation); }
+        .phase-header { padding: 10px 12px 8px; border-bottom: 1px solid var(--border); display: flex; align-items: center; gap: 8px; }
+        .phase-num { width: 22px; height: 22px; border-radius: 6px; display: flex; align-items: center; justify-content: center; font-size: 0.75rem; font-weight: 700; }
+        .analysis .phase-num { background: var(--analysis); }
+        .planning .phase-num { background: var(--planning); }
+        .solutioning .phase-num { background: var(--solutioning); color: #000; }
+        .implementation .phase-num { background: var(--implementation); }
+        .phase-title { font-size: 0.95rem; font-weight: 700; }
+        .phase-opt { font-size: 0.6rem; padding: 2px 6px; border-radius: 4px; background: rgba(14, 165, 233, 0.2); color: #7dd3fc; }
+        .workflows { padding: 8px 10px; }
+        .workflow {
+            background: rgba(255,255,255,0.03); border-radius: 6px;
+            padding: 8px; margin-bottom: 6px;
+            font-size: 0.7rem;
+        }
+        .workflow-header {
+            display: flex; justify-content: space-between; align-items: center;
+            margin-bottom: 4px;
+        }
+        .workflow-name {
+            font-family: monospace; color: var(--success);
+            background: rgba(16, 185, 129, 0.1); padding: 2px 6px;
+            border-radius: 3px; font-size: 0.65rem;
+        }
+        .workflow-meta { display: flex; justify-content: space-between; align-items: center; }
+        .agent { display: flex; align-items: center; gap: 4px; }
+        .agent-icon { width: 14px; height: 14px; border-radius: 3px; display: flex; align-items: center; justify-content: center; font-size: 0.55rem; font-weight: 700; }
+        .agent-icon.mary { background: linear-gradient(135deg, #f472b6, #ec4899); }
+        .agent-icon.john { background: linear-gradient(135deg, #60a5fa, #3b82f6); }
+        .agent-icon.sally { background: linear-gradient(135deg, #fbbf24, #f59e0b); color: #000; }
+        .agent-icon.winston { background: linear-gradient(135deg, #a78bfa, #8b5cf6); }
+        .agent-icon.bob { background: linear-gradient(135deg, #34d399, #10b981); color: #000; }
+        .agent-icon.amelia { background: linear-gradient(135deg, #fb7185, #ef4444); }
+        .agent-icon.barry { background: linear-gradient(135deg, #94a3b8, #64748b); }
+        .agent-name { font-size: 0.65rem; }
+        .output { color: var(--success); font-family: monospace; font-size: 0.6rem; }
+        .badge { font-size: 0.55rem; padding: 1px 4px; border-radius: 3px; }
+        .badge.opt { background: rgba(251,191,36,0.15); color: #fbbf24; }
+        .badge.iffy { background: rgba(168,85,247,0.15); color: #a855f7; }
+        .badge.adhoc { background: rgba(59,130,246,0.15); color: #3b82f6; }
+        .arrow { display: flex; align-items: center; justify-content: center; color: var(--arrow); font-size: 0.9rem; margin: 6px 0; }
+        .decision { background: linear-gradient(135deg, #a855f7, #9333ea); padding: 4px 8px; border-radius: 4px; text-align: center; font-size: 0.65rem; font-weight: 600; margin: 6px 0; }
+        .quickflow {
+            background: rgba(100, 116, 139, 0.2); border: 2px dashed var(--quickflow);
+            border-radius: 10px; padding: 12px; margin-bottom: 16px;
+        }
+        .quickflow-header { display: flex; align-items: center; gap: 8px; margin-bottom: 8px; }
+        .quickflow-header h2 { font-size: 0.95rem; }
+        .quickflow-header span { font-size: 0.7rem; color: var(--text-muted); }
+        .quickflow-body { display: flex; align-items: center; gap: 12px; }
+        .quickflow-item { flex: 1; background: rgba(255,255,255,0.03); border-radius: 8px; padding: 10px; }
+        .quickflow-item code { font-family: monospace; color: var(--success); background: rgba(16, 185, 129, 0.1); padding: 2px 6px; border-radius: 3px; font-size: 0.7rem; }
+        .context { background: rgba(14, 165, 233, 0.08); border-radius: 10px; padding: 12px; font-size: 0.75rem; }
+        .context-header { display: flex; align-items: center; gap: 8px; margin-bottom: 6px; font-weight: 600; }
+        .context-items { display: flex; flex-wrap: wrap; gap: 6px; }
+        .context-items code { font-family: monospace; color: var(--success); background: rgba(16, 185, 129, 0.1); padding: 2px 5px; border-radius: 3px; font-size: 0.65rem; }
+        .context-items span { color: var(--text-muted); }
+        .legend { display: flex; justify-content: center; gap: 12px; flex-wrap: wrap; font-size: 0.7rem; margin-top: 12px; }
+        .legend-item { display: flex; align-items: center; gap: 4px; }
+        .legend-dot { width: 12px; height: 3px; border-radius: 2px; }
+    </style>
+</head>
+<body>
+    <div class="header">
+        <div class="header-badge">⚡ Workflow Map V6</div>
+        <h1>BMad Method</h1>
+        <p class="subtitle">Context engineering for AI-powered development</p>
+    </div>
+    <div class="flow-legend">→ arrows show artifact flow between workflows</div>
+    <div class="flow-grid">
+        <!-- Phase 1: Analysis -->
+        <div class="phase analysis">
+            <div class="phase-header">
+                <div class="phase-num">1</div>
+                <div class="phase-title">Analysis</div>
+                <span class="phase-opt">Optional</span>
+            </div>
+            <div class="workflows">
+                <div class="workflow">
+                    <div class="workflow-header">
+                        <span class="workflow-name">brainstorm</span>
+                        <span class="badge opt">opt</span>
+                    </div>
+                    <div class="workflow-meta">
+                        <div class="agent"><div class="agent-icon mary">M</div><span class="agent-name">Mary</span></div>
+                        <span class="output">brainstorming-report.md</span>
+                    </div>
+                </div>
+                <div class="workflow">
+                    <div class="workflow-header">
+                        <span class="workflow-name">research</span>
+                        <span class="badge opt">opt</span>
+                    </div>
+                    <div class="workflow-meta">
+                        <div class="agent"><div class="agent-icon mary">M</div><span class="agent-name">Mary</span></div>
+                        <span class="output">findings</span>
+                    </div>
+                </div>
+                <div class="workflow">
+                    <div class="workflow-header">
+                        <span class="workflow-name">create-product-brief</span>
+                    </div>
+                    <div class="workflow-meta">
+                        <div class="agent"><div class="agent-icon mary">M</div><span class="agent-name">Mary</span></div>
+                        <span class="output">product-brief.md →</span>
+                    </div>
+                </div>
+            </div>
+            <div class="arrow">→</div>
+        </div>
+        <!-- Phase 2: Planning -->
+        <div class="phase planning">
+            <div class="phase-header">
+                <div class="phase-num">2</div>
+                <div class="phase-title">Planning</div>
+            </div>
+            <div class="workflows">
+                <div class="workflow">
+                    <div class="workflow-header">
+                        <span class="workflow-name">create-prd</span>
+                    </div>
+                    <div class="workflow-meta">
+                        <div class="agent"><div class="agent-icon john">J</div><span class="agent-name">John</span></div>
+                        <span class="output">PRD.md →</span>
+                    </div>
+                </div>
+                <div class="decision">Has UI?</div>
+                <div class="workflow">
+                    <div class="workflow-header">
+                        <span class="workflow-name">create-ux-design</span>
+                        <span class="badge iffy">if yes</span>
+                    </div>
+                    <div class="workflow-meta">
+                        <div class="agent"><div class="agent-icon sally">S</div><span class="agent-name">Sally</span></div>
+                        <span class="output">ux-spec.md →</span>
+                    </div>
+                </div>
+            </div>
+            <div class="arrow">→</div>
+        </div>
+        <!-- Phase 3: Solutioning -->
+        <div class="phase solutioning">
+            <div class="phase-header">
+                <div class="phase-num">3</div>
+                <div class="phase-title">Solutioning</div>
+            </div>
+            <div class="workflows">
+                <div class="workflow">
+                    <div class="workflow-header">
+                        <span class="workflow-name">create-architecture</span>
+                    </div>
+                    <div class="workflow-meta">
+                        <div class="agent"><div class="agent-icon winston">W</div><span class="agent-name">Winston</span></div>
+                        <span class="output">architecture.md →</span>
+                    </div>
+                </div>
+                <div class="workflow">
+                    <div class="workflow-header">
+                        <span class="workflow-name">create-epics-and-stories</span>
+                    </div>
+                    <div class="workflow-meta">
+                        <div class="agent"><div class="agent-icon john">J</div><span class="agent-name">John</span></div>
+                        <span class="output">epics.md →</span>
+                    </div>
+                </div>
+                <div class="workflow">
+                    <div class="workflow-header">
+                        <span class="workflow-name">check-implementation-readiness</span>
+                    </div>
+                    <div class="workflow-meta">
+                        <div class="agent"><div class="agent-icon john">J</div><span class="agent-name">John</span></div>
+                        <span class="output">gate check</span>
+                    </div>
+                </div>
+            </div>
+            <div class="arrow">→</div>
+        </div>
+        <!-- Phase 4: Implementation -->
+        <div class="phase implementation">
+            <div class="phase-header">
+                <div class="phase-num">4</div>
+                <div class="phase-title">Implementation</div>
+            </div>
+            <div class="workflows">
+                <div class="workflow">
+                    <div class="workflow-header">
+                        <span class="workflow-name">sprint-planning</span>
+                    </div>
+                    <div class="workflow-meta">
+                        <div class="agent"><div class="agent-icon bob">B</div><span class="agent-name">Bob</span></div>
+                        <span class="output">sprint-status.yaml →</span>
+                    </div>
+                </div>
+                <div class="workflow">
+                    <div class="workflow-header">
+                        <span class="workflow-name">create-story</span>
+                    </div>
+                    <div class="workflow-meta">
+                        <div class="agent"><div class="agent-icon bob">B</div><span class="agent-name">Bob</span></div>
+                        <span class="output">story-[slug].md →</span>
+                    </div>
+                </div>
+                <div class="workflow">
+                    <div class="workflow-header">
+                        <span class="workflow-name">dev-story</span>
+                    </div>
+                    <div class="workflow-meta">
+                        <div class="agent"><div class="agent-icon amelia">A</div><span class="agent-name">Amelia</span></div>
+                        <span class="output">code →</span>
+                    </div>
+                </div>
+                <div class="workflow">
+                    <div class="workflow-header">
+                        <span class="workflow-name">code-review</span>
+                    </div>
+                    <div class="workflow-meta">
+                        <div class="agent"><div class="agent-icon amelia">A</div><span class="agent-name">Amelia</span></div>
+                        <span class="output">approve</span>
+                    </div>
+                </div>
+                <div class="workflow">
+                    <div class="workflow-header">
+                        <span class="workflow-name">correct-course</span>
+                        <span class="badge adhoc">ad-hoc</span>
+                    </div>
+                    <div class="workflow-meta">
+                        <div class="agent"><div class="agent-icon john">J</div><span class="agent-name">John</span></div>
+                        <span class="output">updated plan</span>
+                    </div>
+                </div>
+                <div class="workflow">
+                    <div class="workflow-header">
+                        <span class="workflow-name">retrospective</span>
+                        <span class="badge adhoc">per epic</span>
+                    </div>
+                    <div class="workflow-meta">
+                        <div class="agent"><div class="agent-icon bob">B</div><span class="agent-name">Bob</span></div>
+                        <span class="output">lessons</span>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+    <div class="quickflow">
+        <div class="quickflow-header">
+            <span>⚡</span>
+            <div>
+                <h2>Quick Flow (Parallel Track)</h2>
+                <span>For small, well-understood changes — skip phases 1-3</span>
+            </div>
+        </div>
+        <div class="quickflow-body">
+            <div class="quickflow-item">
+                <div class="agent"><div class="agent-icon barry">B</div><span class="agent-name">Barry</span></div>
+                <code>quick-spec</code>
+                <div style="font-size: 0.65rem; color: var(--text-muted); margin-top: 4px;">→ tech-spec.md</div>
+            </div>
+            <span style="color: var(--arrow); font-size: 1.2rem;">→</span>
+            <div class="quickflow-item">
+                <div class="agent"><div class="agent-icon barry">B</div><span class="agent-name">Barry</span></div>
+                <code>quick-dev</code>
+                <div style="font-size: 0.65rem; color: var(--text-muted); margin-top: 4px;">→ working code</div>
+            </div>
+        </div>
+    </div>
+    <div class="context">
+        <div class="context-header">📚 Context Flow</div>
+        <p style="margin-bottom: 8px; color: var(--text-muted);">Each document becomes context for the next phase.</p>
+        <div class="context-items">
+            <span><code>create-story</code> <span>loads epics, PRD, architecture, UX</span></span>
+            <span><code>dev-story</code> <span>loads story file</span></span>
+            <span><code>code-review</code> <span>loads architecture, story</span></span>
+            <span><code>quick-dev</code> <span>loads tech-spec</span></span>
+        </div>
+    </div>
+    <div class="legend">
+        <div class="legend-item"><div class="legend-dot" style="background: var(--analysis);"></div>Analysis</div>
+        <div class="legend-item"><div class="legend-dot" style="background: var(--planning);"></div>Planning</div>
+        <div class="legend-item"><div class="legend-dot" style="background: var(--solutioning);"></div>Solutioning</div>
+        <div class="legend-item"><div class="legend-dot" style="background: var(--implementation);"></div>Implementation</div>
+        <div class="legend-item"><div class="legend-dot" style="background: var(--quickflow);"></div>Quick Flow</div>
+    </div>
+</body>
+</html>

package/website/src/components/Banner.astro ADDED Viewed

@@ -0,0 +1,59 @@
+---
+import { getSiteUrl } from '../lib/site-url.js';
+const SITE_URL = getSiteUrl();
+const fullDocsUrl = `${SITE_URL}/llms-full.txt`;
+---
+<div class="ai-banner">
+  <span>🤖 Consolidated, AI-optimized BMAD docs: <a href={fullDocsUrl}>llms-full.txt</a>. Fetch this plain text file for complete context.</span>
+</div>
+<style>
+  .ai-banner {
+    width: 100vw; /* Full viewport width */
+    margin-left: calc(-50vw + 50%); /* Center and break out of container */
+    height: var(--ai-banner-height, 2.75rem);
+    background: #334155;
+    color: rgb(148, 163, 184);
+    padding: 0.5rem 1rem;
+    font-size: 0.875rem;
+    border-bottom: 1px solid rgba(140, 140, 255, 0.15);
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    box-sizing: border-box;
+    font-family: system-ui, sans-serif;
+  }
+  /* Truncate text on narrow screens */
+  .ai-banner span {
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    max-width: 100%;
+  }
+  .ai-banner a {
+    color: #8C8CFF;
+    text-decoration: none;
+    font-weight: 600;
+  }
+  .ai-banner a:hover {
+    text-decoration: underline;
+  }
+  /* Match navbar padding at breakpoints */
+  @media (min-width: 50rem) {
+    .ai-banner {
+      padding-left: 2.5rem;
+      padding-right: 2.5rem;
+    }
+  }
+  @media (min-width: 72rem) {
+    .ai-banner {
+      padding-left: 3rem;
+      padding-right: 3rem;
+    }
+  }
+</style>

package/website/src/components/Header.astro ADDED Viewed

@@ -0,0 +1,121 @@
+---
+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">
+		<nav class="sl-flex nav-links">
+			<a href={`${import.meta.env.BASE_URL}downloads/`}>Downloads</a>
+		</nav>
+		<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,
+	.nav-links {
+		gap: 1rem;
+		align-items: center;
+	}
+	.nav-links a {
+		color: var(--sl-color-white);
+		text-decoration: none;
+		font-size: 0.875rem;
+		font-weight: 500;
+		padding: 0.25rem 0.5rem;
+		border-radius: 4px;
+		transition: color 0.15s ease, background-color 0.15s ease;
+	}
+	.nav-links a:hover {
+		color: var(--sl-color-accent);
+		background-color: rgba(140, 140, 255, 0.1);
+	}
+	.nav-links::after {
+		content: '';
+		height: 2rem;
+		border-inline-end: 1px solid var(--sl-color-gray-5);
+	}
+	.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/website/src/components/MobileMenuFooter.astro ADDED Viewed

@@ -0,0 +1,53 @@
+---
+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>
+	<nav class="sl-flex nav-links">
+		<a href={`${import.meta.env.BASE_URL}downloads/`}>Downloads</a>
+	</nav>
+	<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;
+	}
+	.nav-links {
+		gap: 1rem;
+		align-items: center;
+	}
+	.nav-links a {
+		color: var(--sl-color-white);
+		text-decoration: none;
+		font-size: 0.875rem;
+		font-weight: 500;
+		padding: 0.5rem 0.75rem;
+		border-radius: 4px;
+		transition: color 0.15s ease, background-color 0.15s ease;
+	}
+	.nav-links a:hover {
+		color: var(--sl-color-accent);
+		background-color: rgba(140, 140, 255, 0.1);
+	}
+</style>

package/website/src/content/config.ts ADDED Viewed

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

package/website/src/lib/site-url.js ADDED Viewed

@@ -0,0 +1,25 @@
+/**
+ * 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/website/src/pages/404.astro ADDED Viewed

@@ -0,0 +1,11 @@
+---
+import StarlightPage from '@astrojs/starlight/components/StarlightPage.astro';
+import { getEntry } from 'astro:content';
+const entry = await getEntry('docs', '404');
+const { Content } = await entry.render();
+---
+<StarlightPage frontmatter={{ title: entry.data.title, template: entry.data.template }}>
+  <Content />
+</StarlightPage>