ros/BMAD-METHOD
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

web build optimization

Browse Source
This commit is contained in:
Brian Madison
2025-07-06 10:32:39 -05:00
parent 4b0a9235ab
commit 5fc69d773a
30 changed files with 1346 additions and 1360 deletions
Download Patch File Download Diff File Expand all files Collapse all files

139
tools/builders/web-builder.js
View File

@@ -21,6 +21,76 @@ class WebBuilder {
return yaml.load(content);
}
convertToWebPath(filePath, bundleRoot = 'bmad-core') {
// Convert absolute paths to web bundle paths with dot prefix
// All resources get installed under the bundle root, so use that path
const relativePath = path.relative(this.rootDir, filePath);
const pathParts = relativePath.split(path.sep);
let resourcePath;
if (pathParts[0] === 'expansion-packs') {
// For expansion packs, remove 'expansion-packs/packname' and use the rest
resourcePath = pathParts.slice(2).join('/');
} else {
// For bmad-core, common, etc., remove the first part
resourcePath = pathParts.slice(1).join('/');
}
return `.${bundleRoot}/${resourcePath}`;
}
generateWebInstructions(bundleType, packName = null) {
// Generate dynamic web instructions based on bundle type
const rootExample = packName ? `.${packName}` : '.bmad-core';
const examplePath = packName ? `.${packName}/folder/filename.md` : '.bmad-core/folder/filename.md';
const personasExample = packName ? `.${packName}/personas/analyst.md` : '.bmad-core/personas/analyst.md';
const tasksExample = packName ? `.${packName}/tasks/create-story.md` : '.bmad-core/tasks/create-story.md';
const utilsExample = packName ? `.${packName}/utils/template-format.md` : '.bmad-core/utils/template-format.md';
const tasksRef = packName ? `.${packName}/tasks/create-story.md` : '.bmad-core/tasks/create-story.md';
return `# Web Agent Bundle Instructions
You are now operating as a specialized AI agent from the BMad-Method framework. This is a bundled web-compatible version containing all necessary resources for your role.
## Important Instructions
1. **Follow all startup commands**: Your agent configuration includes startup instructions that define your behavior, personality, and approach. These MUST be followed exactly.
2. **Resource Navigation**: This bundle contains all resources you need. Resources are marked with tags like:
- \`==================== START: ${examplePath} ====================\`
- \`==================== END: ${examplePath} ====================\`
When you need to reference a resource mentioned in your instructions:
- Look for the corresponding START/END tags
- The format is always the full path with dot prefix (e.g., \`${personasExample}\`, \`${tasksExample}\`)
- If a section is specified (e.g., \`{root}/tasks/create-story.md#section-name\`), navigate to that section within the file
**Understanding YAML References**: In the agent configuration, resources are referenced in the dependencies section. For example:
\`\`\`yaml
dependencies:
utils:
- template-format
tasks:
- create-story
\`\`\`
These references map directly to bundle sections:
- \`utils: template-format\` → Look for \`==================== START: ${utilsExample} ====================\`
- \`tasks: create-story\` → Look for \`==================== START: ${tasksRef} ====================\`
3. **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance.
4. **Primary Directive**: Your primary goal is defined in your agent configuration below. Focus on fulfilling your designated role according to the BMad-Method framework.
---
`;
}
async cleanOutputDirs() {
for (const dir of this.outputDirs) {
try {
@@ -73,16 +143,18 @@ class WebBuilder {
async buildAgentBundle(agentId) {
const dependencies = await this.resolver.resolveAgentDependencies(agentId);
const template = await fs.readFile(this.templatePath, "utf8");
const template = this.generateWebInstructions('agent');
const sections = [template];
// Add agent configuration
sections.push(this.formatSection(dependencies.agent.path, dependencies.agent.content));
const agentPath = this.convertToWebPath(dependencies.agent.path, 'bmad-core');
sections.push(this.formatSection(agentPath, dependencies.agent.content, 'bmad-core'));
// Add all dependencies
for (const resource of dependencies.resources) {
sections.push(this.formatSection(resource.path, resource.content));
const resourcePath = this.convertToWebPath(resource.path, 'bmad-core');
sections.push(this.formatSection(resourcePath, resource.content, 'bmad-core'));
}
return sections.join("\n");
@@ -90,21 +162,24 @@ class WebBuilder {
async buildTeamBundle(teamId) {
const dependencies = await this.resolver.resolveTeamDependencies(teamId);
const template = await fs.readFile(this.templatePath, "utf8");
const template = this.generateWebInstructions('team');
const sections = [template];
// Add team configuration
sections.push(this.formatSection(dependencies.team.path, dependencies.team.content));
const teamPath = this.convertToWebPath(dependencies.team.path, 'bmad-core');
sections.push(this.formatSection(teamPath, dependencies.team.content, 'bmad-core'));
// Add all agents
for (const agent of dependencies.agents) {
sections.push(this.formatSection(agent.path, agent.content));
const agentPath = this.convertToWebPath(agent.path, 'bmad-core');
sections.push(this.formatSection(agentPath, agent.content, 'bmad-core'));
}
// Add all deduplicated resources
for (const resource of dependencies.resources) {
sections.push(this.formatSection(resource.path, resource.content));
const resourcePath = this.convertToWebPath(resource.path, 'bmad-core');
sections.push(this.formatSection(resourcePath, resource.content, 'bmad-core'));
}
return sections.join("\n");
@@ -161,14 +236,17 @@ class WebBuilder {
}
}
formatSection(path, content) {
formatSection(path, content, bundleRoot = 'bmad-core') {
const separator = "====================";
// Process agent content if this is an agent file
if (path.startsWith("agents#")) {
if (path.includes("/agents/")) {
content = this.processAgentContent(content);
}
// Replace {root} references with the actual bundle root
content = this.replaceRootReferences(content, bundleRoot);
return [
`${separator} START: ${path} ${separator}`,
content.trim(),
@@ -177,6 +255,11 @@ class WebBuilder {
].join("\n");
}
replaceRootReferences(content, bundleRoot) {
// Replace {root} with the appropriate bundle root path
return content.replace(/\{root\}/g, `.${bundleRoot}`);
}
async validate() {
console.log("Validating agent configurations...");
const agents = await this.resolver.listAgents();
@@ -288,13 +371,14 @@ class WebBuilder {
}
async buildExpansionAgentBundle(packName, packDir, agentName) {
const template = await fs.readFile(this.templatePath, "utf8");
const template = this.generateWebInstructions('expansion-agent', packName);
const sections = [template];
// Add agent configuration
const agentPath = path.join(packDir, "agents", `${agentName}.md`);
const agentContent = await fs.readFile(agentPath, "utf8");
sections.push(this.formatSection(`agents#${agentName}`, agentContent));
const agentWebPath = this.convertToWebPath(agentPath, packName);
sections.push(this.formatSection(agentWebPath, agentContent, packName));
// Resolve and add agent dependencies
const yamlContent = yamlUtils.extractYamlFromAgent(agentContent);
@@ -316,8 +400,9 @@ class WebBuilder {
const resourcePath = path.join(packDir, resourceType, `${resourceName}${ext}`);
try {
const resourceContent = await fs.readFile(resourcePath, "utf8");
const resourceWebPath = this.convertToWebPath(resourcePath, packName);
sections.push(
this.formatSection(`${resourceType}#${resourceName}`, resourceContent)
this.formatSection(resourceWebPath, resourceContent, packName)
);
found = true;
break;
@@ -337,8 +422,9 @@ class WebBuilder {
);
try {
const coreContent = await fs.readFile(corePath, "utf8");
const coreWebPath = this.convertToWebPath(corePath, packName);
sections.push(
this.formatSection(`${resourceType}#${resourceName}`, coreContent)
this.formatSection(coreWebPath, coreContent, packName)
);
found = true;
break;
@@ -359,8 +445,9 @@ class WebBuilder {
);
try {
const commonContent = await fs.readFile(commonPath, "utf8");
const commonWebPath = this.convertToWebPath(commonPath, packName);
sections.push(
this.formatSection(`${resourceType}#${resourceName}`, commonContent)
this.formatSection(commonWebPath, commonContent, packName)
);
found = true;
break;
@@ -388,7 +475,7 @@ class WebBuilder {
}
async buildExpansionTeamBundle(packName, packDir, teamConfigPath) {
const template = await fs.readFile(this.templatePath, "utf8");
const template = this.generateWebInstructions('expansion-team', packName);
const sections = [template];
@@ -396,7 +483,8 @@ class WebBuilder {
const teamContent = await fs.readFile(teamConfigPath, "utf8");
const teamFileName = path.basename(teamConfigPath, ".yaml");
const teamConfig = this.parseYaml(teamContent);
sections.push(this.formatSection(`agent-teams#${teamFileName}`, teamContent));
const teamWebPath = this.convertToWebPath(teamConfigPath, packName);
sections.push(this.formatSection(teamWebPath, teamContent, packName));
// Get list of expansion pack agents
const expansionAgents = new Set();
@@ -446,7 +534,8 @@ class WebBuilder {
// Use expansion pack version (override)
const agentPath = path.join(agentsDir, `${agentId}.md`);
const agentContent = await fs.readFile(agentPath, "utf8");
sections.push(this.formatSection(`agents#${agentId}`, agentContent));
const expansionAgentWebPath = this.convertToWebPath(agentPath, packName);
sections.push(this.formatSection(expansionAgentWebPath, agentContent, packName));
// Parse and collect dependencies from expansion agent
const agentYaml = agentContent.match(/```yaml\n([\s\S]*?)\n```/);
@@ -474,7 +563,8 @@ class WebBuilder {
try {
const coreAgentPath = path.join(this.rootDir, "bmad-core", "agents", `${agentId}.md`);
const coreAgentContent = await fs.readFile(coreAgentPath, "utf8");
sections.push(this.formatSection(`agents#${agentId}`, coreAgentContent));
const coreAgentWebPath = this.convertToWebPath(coreAgentPath, packName);
sections.push(this.formatSection(coreAgentWebPath, coreAgentContent, packName));
// Parse and collect dependencies from core agent
const yamlContent = yamlUtils.extractYamlFromAgent(coreAgentContent, true);
@@ -516,7 +606,8 @@ class WebBuilder {
const expansionPath = path.join(packDir, dep.type, `${dep.name}${ext}`);
try {
const content = await fs.readFile(expansionPath, "utf8");
sections.push(this.formatSection(key, content));
const expansionWebPath = this.convertToWebPath(expansionPath, packName);
sections.push(this.formatSection(expansionWebPath, content, packName));
console.log(` ✓ Using expansion override for ${key}`);
found = true;
break;
@@ -532,7 +623,8 @@ class WebBuilder {
const corePath = path.join(this.rootDir, "bmad-core", dep.type, `${dep.name}${ext}`);
try {
const content = await fs.readFile(corePath, "utf8");
sections.push(this.formatSection(key, content));
const coreWebPath = this.convertToWebPath(corePath, packName);
sections.push(this.formatSection(coreWebPath, content, packName));
found = true;
break;
} catch (error) {
@@ -547,7 +639,8 @@ class WebBuilder {
const commonPath = path.join(this.rootDir, "common", dep.type, `${dep.name}${ext}`);
try {
const content = await fs.readFile(commonPath, "utf8");
sections.push(this.formatSection(key, content));
const commonWebPath = this.convertToWebPath(commonPath, packName);
sections.push(this.formatSection(commonWebPath, content, packName));
found = true;
break;
} catch (error) {
@@ -576,7 +669,9 @@ class WebBuilder {
// Only add if not already included as a dependency
const resourceKey = `${resourceDir}#${fileName}`;
if (!allDependencies.has(resourceKey)) {
sections.push(this.formatSection(resourceKey, fileContent));
const fullResourcePath = path.join(resourcePath, resourceFile);
const resourceWebPath = this.convertToWebPath(fullResourcePath, packName);
sections.push(this.formatSection(resourceWebPath, fileContent, packName));
}
}
} catch (error) {