bmad-viewer 0.3.2 → 0.3.4

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "bmad-viewer",
-	"version": "0.3.2",
+	"version": "0.3.4",
 	"description": "Visual dashboard for BMAD (Boring Maintainable Agile Development) projects. Wiki browser + sprint status viewer with live reload.",
 	"type": "module",
 	"bin": {
@@ -27,6 +27,7 @@
 		"url": "https://github.com/CamiloValderramaGonzalez/bmad-viewer/issues"
 	},
 	"dependencies": {
+		"bmad-viewer": "^0.3.2",
 		"chokidar": "^4.0.1",
 		"fuse.js": "^7.0.0",
 		"js-yaml": "^4.1.0",

package/public/client.js

@@ -491,7 +491,57 @@
 		// Sidebar
 		initSidebarToggles();
 
+		// Path config panel
+		initPathConfig();
+
 		// WebSocket
 		initWebSocket();
 	});
+
+	/* ── Path Config Panel ── */
+	function initPathConfig() {
+		var btn = document.getElementById('apply-paths-btn');
+		if (!btn) return;
+
+		btn.addEventListener('click', function () {
+			var epicsInput = document.getElementById('custom-epics-path');
+			var outputInput = document.getElementById('custom-output-path');
+			var status = document.getElementById('path-config-status');
+			var payload = {};
+
+			if (outputInput && outputInput.value.trim()) payload.outputPath = outputInput.value.trim();
+			if (epicsInput && epicsInput.value.trim()) payload.epicsPath = epicsInput.value.trim();
+
+			if (!payload.outputPath && !payload.epicsPath) {
+				if (status) { status.textContent = 'Enter at least one path'; status.className = 'path-config-panel__status path-config-panel__status--err'; }
+				return;
+			}
+
+			btn.disabled = true;
+			if (status) { status.textContent = 'Applying...'; status.className = 'path-config-panel__status'; }
+
+			fetch('/api/set-paths', {
+				method: 'POST',
+				headers: { 'Content-Type': 'application/json' },
+				body: JSON.stringify(payload),
+			})
+				.then(function (r) { return r.json(); })
+				.then(function (data) {
+					btn.disabled = false;
+					if (data.ok) {
+						if (status) {
+							status.textContent = 'Found ' + data.epics + ' epics, ' + data.stories + ' stories. Reloading...';
+							status.className = 'path-config-panel__status path-config-panel__status--ok';
+						}
+						setTimeout(function () { location.reload(); }, 800);
+					} else {
+						if (status) { status.textContent = data.error || 'Error applying paths'; status.className = 'path-config-panel__status path-config-panel__status--err'; }
+					}
+				})
+				.catch(function () {
+					btn.disabled = false;
+					if (status) { status.textContent = 'Network error'; status.className = 'path-config-panel__status path-config-panel__status--err'; }
+				});
+		});
+	}
 })();

package/public/styles.css

@@ -149,6 +149,22 @@ mark.search-highlight{background:rgba(245,158,11,.4);color:var(--text);border-ra
 /* Warning Banner */
 .warning-banner{background:rgba(245,158,11,.1);border-bottom:1px solid var(--warning);padding:8px var(--gap)}
 .warning-banner__item{font-size:.85rem;color:var(--text)}
+/* Path config panel */
+.path-config-panel{background:var(--accent-soft);border:1px solid var(--border);border-radius:var(--radius);padding:20px 24px;margin-bottom:20px}
+.path-config-panel__header h3{font-size:1rem;margin-bottom:4px}
+.path-config-panel__header p{font-size:.85rem;color:var(--text-muted);margin-bottom:16px}
+.path-config-panel__fields{display:flex;flex-direction:column;gap:12px}
+.path-config-panel__label{display:flex;flex-direction:column;gap:4px}
+.path-config-panel__label>span:first-child{font-size:.85rem;font-weight:600}
+.path-config-panel__input{font-family:var(--font-mono);font-size:.85rem;padding:8px 12px;border:1px solid var(--border);border-radius:var(--radius);background:var(--bg);color:var(--text);width:100%}
+.path-config-panel__input:focus{outline:none;border-color:var(--primary)}
+.path-config-panel__hint{font-size:.75rem;color:var(--text-muted)}
+.path-config-panel__btn{align-self:flex-start;padding:8px 20px;background:var(--primary);color:#fff;border:none;border-radius:var(--radius);cursor:pointer;font-size:.85rem;font-weight:600;transition:background .15s}
+.path-config-panel__btn:hover{background:var(--primary-hover)}
+.path-config-panel__btn:disabled{opacity:.6;cursor:not-allowed}
+.path-config-panel__status{font-size:.85rem;color:var(--text-muted);align-self:center}
+.path-config-panel__status--ok{color:var(--success)}
+.path-config-panel__status--err{color:var(--warning)}
 /* Responsive */
 @media(max-width:768px){.app-layout{grid-template-columns:1fr}.app-layout__sidebar{max-height:none;position:static;border-right:none;border-bottom:1px solid var(--border)}.kanban{grid-template-columns:1fr}.stats-box{grid-template-columns:repeat(2,1fr)}}
 @media(max-width:440px){.header-bar__shortcut{display:none}.stats-box{grid-template-columns:1fr}.lens-tabs__tab{padding:8px 12px;font-size:.85rem}}

package/src/data/data-model.js

@@ -8,15 +8,16 @@ import { ErrorAggregator } from '../utils/error-aggregator.js';
  * Build the complete in-memory data model from a BMAD project.
  *
  * @param {string} bmadDir - Project root containing _bmad/
+ * @param {{customEpicsPath?: string, customOutputPath?: string}} [options] - Optional overrides
  * @returns {{wiki: object, project: object, config: object, aggregator: ErrorAggregator}}
  */
-export function buildDataModel(bmadDir) {
+export function buildDataModel(bmadDir, options) {
 	const aggregator = new ErrorAggregator();
 	const bmadPath = join(bmadDir, '_bmad');
-	const outputPath = join(bmadDir, '_bmad-output');
+	const outputPath = options?.customOutputPath || join(bmadDir, '_bmad-output');
 
 	const wiki = buildWikiData(bmadPath, aggregator);
-	const project = buildProjectData(outputPath, aggregator);
+	const project = buildProjectData(outputPath, aggregator, options?.customEpicsPath);
 	const config = loadConfig(bmadPath, aggregator);
 
 	return { wiki, project, config, aggregator };
@@ -278,8 +279,11 @@ function readMarkdownSafe(filePath, aggregator) {
 
 /**
  * Build project data from _bmad-output directory.
+ * @param {string} outputPath
+ * @param {ErrorAggregator} aggregator
+ * @param {string} [customEpicsPath] - Optional override path to epics file
  */
-function buildProjectData(outputPath, aggregator) {
+function buildProjectData(outputPath, aggregator, customEpicsPath) {
 	const project = {
 		sprintStatus: null,
 		stories: { total: 0, pending: 0, inProgress: 0, done: 0 },
@@ -288,7 +292,10 @@ function buildProjectData(outputPath, aggregator) {
 		artifacts: [],
 	};
 
-	if (!existsSync(outputPath)) return project;
+	if (!existsSync(outputPath)) {
+		loadCustomEpicsFile(customEpicsPath, project, aggregator);
+		return project;
+	}
 
 	// Parse sprint-status.yaml
 	const sprintStatusPaths = [
@@ -369,8 +376,8 @@ function buildProjectData(outputPath, aggregator) {
 				...content,
 			});
 
-			// Parse stories and epics from epics.md
-			if (name === 'epics' && ext === '.md' && content.raw) {
+			// Parse stories and epics from epics.md or epics-and-stories.md
+			if (name.startsWith('epics') && ext === '.md' && content.raw) {
 				const storyContents = parseStoriesFromEpics(content.raw, aggregator);
 				project.storyContents = storyContents;
 
@@ -388,6 +395,11 @@ function buildProjectData(outputPath, aggregator) {
 		}
 	}
 
+	// Load custom epics file if provided and no epics were found from normal scan
+	if (project.epics.length === 0) {
+		loadCustomEpicsFile(customEpicsPath, project, aggregator);
+	}
+
 	// Scan implementation artifact story files (direct .md files in impl dir + stories/ subdir)
 	const implDir = join(outputPath, 'implementation-artifacts');
 	if (existsSync(implDir)) {
@@ -502,6 +514,32 @@ function buildProjectData(outputPath, aggregator) {
 	return project;
 }
 
+/**
+ * Load a custom epics file and populate project data from it.
+ */
+function loadCustomEpicsFile(customEpicsPath, project, aggregator) {
+	if (!customEpicsPath || !existsSync(customEpicsPath)) return;
+	const content = readMarkdownSafe(customEpicsPath, aggregator);
+	if (!content.raw) return;
+
+	const name = basename(customEpicsPath, extname(customEpicsPath));
+	project.artifacts.push({
+		id: `artifact/${name}`,
+		name: formatName(name),
+		path: customEpicsPath,
+		type: 'planning',
+		...content,
+	});
+	const storyContents = parseStoriesFromEpics(content.raw, aggregator);
+	project.storyContents = storyContents;
+	project.epics = parseEpicsFromMarkdown(content.raw, storyContents);
+	for (const epic of project.epics) {
+		project.stories.total += epic.stories.length;
+		project.stories.pending += epic.stories.length;
+		project.storyList.push(...epic.stories);
+	}
+}
+
 /**
  * Parse individual story sections from epics.md.
  * Stories follow the pattern: ### Story X.Y: Title
@@ -509,8 +547,8 @@ function buildProjectData(outputPath, aggregator) {
  */
 function parseStoriesFromEpics(raw, aggregator) {
 	const storyMap = {};
-	// Split on story headers
-	const storyRegex = /^### Story (\d+)\.(\d+):\s*(.+)$/gm;
+	// Split on story headers (supports ### or #### level)
+	const storyRegex = /^#{3,4} Story (\d+)\.(\d+):\s*(.+)$/gm;
 	let match;
 	const positions = [];
 
@@ -556,7 +594,7 @@ function parseStoriesFromEpics(raw, aggregator) {
  * Stories follow the pattern: ### Story N.M: Title
  */
 function parseEpicsFromMarkdown(raw, storyContents) {
-	const epicRegex = /^## Epic (\d+):\s*(.+)$/gm;
+	const epicRegex = /^#{2,3} Epic (\d+):\s*(.+)$/gm;
 	const epicMap = {};
 	let match;
 
@@ -585,7 +623,7 @@ function parseEpicsFromMarkdown(raw, storyContents) {
  */
 function parseEpicNamesFromComments(rawYaml) {
 	const names = {};
-	const regex = /#\s*Epic\s+(\d+):\s*(.+)/g;
+	const regex = /#\s*Epic\s+(\d+):\s*(.+)/gi;
 	let match;
 	while ((match = regex.exec(rawYaml)) !== null) {
 		names[match[1]] = match[2].trim();

package/src/server/http-server.js

@@ -21,8 +21,11 @@ const PUBLIC_DIR = join(__dirname, '..', '..', 'public');
 export async function startServer({ port, bmadDir, open }) {
 	const actualPort = await findAvailablePort(port);
 
+	// Custom path overrides (can be set via API)
+	const overrides = { customEpicsPath: null, customOutputPath: null };
+
 	// Build initial data model
-	let dataModel = buildDataModel(bmadDir);
+	let dataModel = buildDataModel(bmadDir, overrides);
 
 	// Create HTTP server
 	const server = createServer((req, res) => {
@@ -33,10 +36,37 @@ export async function startServer({ port, bmadDir, open }) {
 		res.setHeader('Content-Security-Policy', "default-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; connect-src 'self' ws://localhost:* ws://127.0.0.1:*");
 		res.setHeader('X-Content-Type-Options', 'nosniff');
 
+		// API endpoint: set custom paths
+		if (pathname === '/api/set-paths' && req.method === 'POST') {
+			let body = '';
+			req.on('data', chunk => { body += chunk; });
+			req.on('end', () => {
+				try {
+					const data = JSON.parse(body);
+					if (data.epicsPath !== undefined) overrides.customEpicsPath = data.epicsPath || null;
+					if (data.outputPath !== undefined) overrides.customOutputPath = data.outputPath || null;
+					dataModel = buildDataModel(bmadDir, overrides);
+					res.writeHead(200, { 'Content-Type': 'application/json' });
+					res.end(JSON.stringify({ ok: true, epics: dataModel.project.epics.length, stories: dataModel.project.stories.total }));
+				} catch {
+					res.writeHead(400, { 'Content-Type': 'application/json' });
+					res.end(JSON.stringify({ ok: false, error: 'Invalid JSON' }));
+				}
+			});
+			return;
+		}
+
+		// API endpoint: get current overrides
+		if (pathname === '/api/get-paths') {
+			res.writeHead(200, { 'Content-Type': 'application/json; charset=utf-8' });
+			res.end(JSON.stringify(overrides));
+			return;
+		}
+
 		// API endpoint: get fresh HTML
 		if (pathname === '/api/dashboard') {
 			res.writeHead(200, { 'Content-Type': 'application/json; charset=utf-8' });
-			dataModel = buildDataModel(bmadDir);
+			dataModel = buildDataModel(bmadDir, overrides);
 			const html = renderDashboard(dataModel);
 			res.end(JSON.stringify({ html }));
 			return;
@@ -72,7 +102,7 @@ export async function startServer({ port, bmadDir, open }) {
 
 		if (debounceTimer) clearTimeout(debounceTimer);
 		debounceTimer = setTimeout(() => {
-			dataModel = buildDataModel(bmadDir);
+			dataModel = buildDataModel(bmadDir, overrides);
 			broadcastChange([...pendingChanges]);
 			pendingChanges.length = 0;
 		}, 150);

package/src/server/renderer.js

@@ -44,8 +44,32 @@ export function renderDashboard(dataModel) {
 	const inProgress = storyList.filter((s) => s.status === 'in-progress');
 	const done = storyList.filter((s) => s.status === 'done' || s.status === 'review');
 
+	const noEpicsNotice = project.epics.length === 0
+		? `<div class="path-config-panel" id="path-config-panel">
+	<div class="path-config-panel__header">
+		<h3>No epics found</h3>
+		<p>Could not auto-detect epics in your project. You can specify custom paths below.</p>
+	</div>
+	<div class="path-config-panel__fields">
+		<label class="path-config-panel__label">
+			<span>Output folder</span>
+			<input type="text" id="custom-output-path" class="path-config-panel__input" placeholder="e.g. C:\\project\\_bmad-output" />
+			<span class="path-config-panel__hint">Folder containing planning-artifacts, implementation-artifacts, etc.</span>
+		</label>
+		<label class="path-config-panel__label">
+			<span>Epics file</span>
+			<input type="text" id="custom-epics-path" class="path-config-panel__input" placeholder="e.g. C:\\project\\docs\\epics.md" />
+			<span class="path-config-panel__hint">Markdown file with epic/story definitions (## Epic N: / ### Story N.M:)</span>
+		</label>
+		<button class="path-config-panel__btn" id="apply-paths-btn">Apply</button>
+		<span class="path-config-panel__status" id="path-config-status"></span>
+	</div>
+</div>`
+		: '';
+
 	const projectContent = `<div id="project-view" hidden>
 	<div id="project-dashboard">
+		${noEpicsNotice}
 		${StatsBox({
 			total: project.stories.total,
 			pending: project.stories.pending,