create-byan-agent 2.9.4 → 2.9.5

package/install/lib/subagent-generator.js

@@ -0,0 +1,208 @@
+/**
+ * BMAD subagent generator (AW2).
+ *
+ * Reads a BYAN Copilot agent stub (.github/agents/<name>.md — YAML
+ * frontmatter + XML persona block) and emits a Claude Code native
+ * subagent file at .claude/agents/bmad-<slug>.md with :
+ *   - frontmatter : name, description, model, color
+ *   - body : system prompt derived from <persona> + <rules> + <menu>
+ *
+ * The resulting file makes the BMAD agent available as a
+ * subagent_type in Claude Code's Agent tool after a session restart.
+ * Model assignment is driven by ROLE_MODEL_MAP (token-optimal defaults).
+ */
+
+const path = require('path');
+const fs = require('fs');
+
+const ROLE_MODEL_MAP = {
+  // Reasoning-heavy → opus
+  architect: 'opus',
+  'bmm-architect': 'opus',
+  tea: 'opus',
+  'tea-tea': 'opus',
+  quinn: 'opus',
+  'bmm-quinn': 'opus',
+  'bmad-master': 'opus',
+  byan: 'opus',
+  'creative-problem-solver': 'opus',
+  'cis-creative-problem-solver': 'opus',
+
+  // Narrow mechanical → haiku
+  carmack: 'haiku',
+  rachid: 'haiku',
+  marc: 'haiku',
+  patnote: 'haiku',
+  drawio: 'haiku',
+};
+
+const ROLE_COLOR_MAP = {
+  opus: 'purple',
+  sonnet: 'blue',
+  haiku: 'cyan',
+};
+
+function normalizeName(stubFilename) {
+  return stubFilename
+    .replace(/^bmad-agent-/, '')
+    .replace(/\.md$/, '');
+}
+
+function pickModel(name) {
+  return ROLE_MODEL_MAP[name] || 'sonnet';
+}
+
+function parseFrontmatter(raw) {
+  const m = raw.match(/^---\s*\n([\s\S]*?)\n---\s*\n/);
+  if (!m) return {};
+  const out = {};
+  for (const line of m[1].split('\n')) {
+    const kv = line.match(/^(\w[\w-]*)\s*:\s*(.*)$/);
+    if (!kv) continue;
+    let v = kv[2].trim();
+    if ((v.startsWith('"') && v.endsWith('"')) || (v.startsWith("'") && v.endsWith("'"))) {
+      v = v.slice(1, -1);
+    }
+    out[kv[1]] = v;
+  }
+  return out;
+}
+
+function extractXmlBlock(raw) {
+  const m = raw.match(/```xml\s*\n([\s\S]*?)\n```/);
+  return m ? m[1] : '';
+}
+
+function extractSection(xml, tag) {
+  const re = new RegExp(`<${tag}(?:\\s+[^>]*)?>([\\s\\S]*?)<\\/${tag}>`);
+  const m = xml.match(re);
+  return m ? m[1].trim() : null;
+}
+
+function extractListItems(xml, parentTag, itemTag) {
+  const parent = extractSection(xml, parentTag);
+  if (!parent) return [];
+  const re = new RegExp(`<${itemTag}(?:\\s+[^>]*)?>([\\s\\S]*?)<\\/${itemTag}>`, 'g');
+  const items = [];
+  let m;
+  while ((m = re.exec(parent)) !== null) items.push(m[1].trim());
+  return items;
+}
+
+function cleanXmlTags(text) {
+  if (!text) return '';
+  return text
+    .replace(/<\/?[a-zA-Z_][\w-]*(\s+[^>]*)?>/g, '')
+    .replace(/\n{3,}/g, '\n\n')
+    .trim();
+}
+
+function buildBody({ fm, persona, rules, menu, capabilities }) {
+  const lines = [];
+  lines.push(`# ${fm.name}`);
+  lines.push('');
+  if (fm.description) {
+    lines.push(fm.description);
+    lines.push('');
+  }
+
+  if (persona) {
+    lines.push('## Persona');
+    lines.push('');
+    lines.push(cleanXmlTags(persona));
+    lines.push('');
+  }
+
+  if (rules && rules.length) {
+    lines.push('## Operating rules');
+    lines.push('');
+    for (const r of rules) lines.push(`- ${cleanXmlTags(r)}`);
+    lines.push('');
+  }
+
+  if (capabilities && capabilities.length) {
+    lines.push('## Capabilities');
+    lines.push('');
+    for (const c of capabilities) lines.push(`- ${cleanXmlTags(c)}`);
+    lines.push('');
+  }
+
+  if (menu && menu.length) {
+    lines.push('## Menu commands');
+    lines.push('');
+    for (const m of menu) lines.push(`- ${cleanXmlTags(m)}`);
+    lines.push('');
+  }
+
+  lines.push('## Reporting contract');
+  lines.push('');
+  lines.push(
+    'When invoked via the Agent tool, stay in the persona above. Respond with a concise JSON report when the task completes : { status: "ok|partial|failed", summary: "<200 words", files_changed: [paths], next_steps: [] }.'
+  );
+
+  return lines.join('\n');
+}
+
+function generateSubagent(stubPath, options = {}) {
+  const raw = fs.readFileSync(stubPath, 'utf8');
+  const fm = parseFrontmatter(raw);
+  if (!fm.name) throw new Error(`stub missing name frontmatter: ${stubPath}`);
+
+  const baseName = options.name || normalizeName(path.basename(stubPath));
+  const xml = extractXmlBlock(raw);
+
+  const persona = extractSection(xml, 'persona') || '';
+  const rules = extractListItems(xml, 'rules', 'r');
+  const menu = extractListItems(xml, 'menu', 'item');
+  const capabilities = extractListItems(xml, 'capabilities', 'cap');
+
+  const subagentName = options.subagentName || `bmad-${baseName}`;
+  const model = options.model || pickModel(baseName);
+  const color = options.color || ROLE_COLOR_MAP[model] || 'blue';
+
+  const description =
+    options.description ||
+    fm.description ||
+    `BMAD ${baseName} agent — invoke for ${baseName} role tasks`;
+
+  const body = buildBody({
+    fm: { ...fm, name: subagentName },
+    persona,
+    rules,
+    menu,
+    capabilities,
+  });
+
+  const content = `---\nname: ${subagentName}\ndescription: ${escapeYaml(description)}\nmodel: ${model}\ncolor: ${color}\n---\n\n${body}\n`;
+
+  const outPath =
+    options.outPath ||
+    path.join('.claude', 'agents', `${subagentName}.md`);
+
+  if (options.write !== false) {
+    fs.mkdirSync(path.dirname(outPath), { recursive: true });
+    fs.writeFileSync(outPath, content);
+  }
+
+  return { outPath, subagentName, model, color, content };
+}
+
+function escapeYaml(v) {
+  if (typeof v !== 'string') return '';
+  if (/[:#\n]/.test(v)) return JSON.stringify(v);
+  return v;
+}
+
+module.exports = {
+  ROLE_MODEL_MAP,
+  ROLE_COLOR_MAP,
+  normalizeName,
+  pickModel,
+  parseFrontmatter,
+  extractXmlBlock,
+  extractSection,
+  extractListItems,
+  cleanXmlTags,
+  buildBody,
+  generateSubagent,
+};

package/install/lib/token-ledger.js

@@ -0,0 +1,131 @@
+/**
+ * BYAN token ledger.
+ *
+ * Reads _byan-output/tool-log.jsonl produced by the transparency hooks
+ * and aggregates per-session token estimates :
+ *   - total tool calls
+ *   - total est input + output tokens
+ *   - per-tool breakdown (count + tokens)
+ *   - failure summary
+ *
+ * Estimates are based on char/4 heuristic. Real token counts would need
+ * Anthropic's count_tokens API which requires authentication — skipped
+ * for now, good-enough for budget reasoning.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+function readLog(logPath) {
+  if (!fs.existsSync(logPath)) return [];
+  return fs
+    .readFileSync(logPath, 'utf8')
+    .split('\n')
+    .filter(Boolean)
+    .map((line) => {
+      try {
+        return JSON.parse(line);
+      } catch {
+        return null;
+      }
+    })
+    .filter(Boolean);
+}
+
+function summarize(entries, { since } = {}) {
+  const cutoff = since ? Date.parse(since) : 0;
+  const filtered = entries.filter((e) => {
+    const t = Date.parse(e.timestamp);
+    return Number.isFinite(t) && t >= cutoff;
+  });
+
+  const stats = {
+    total_entries: filtered.length,
+    pre_count: 0,
+    post_count: 0,
+    est_input_tokens: 0,
+    est_output_tokens: 0,
+    by_tool: {},
+    failures: [],
+  };
+
+  for (const e of filtered) {
+    if (e.phase === 'pre') {
+      stats.pre_count += 1;
+      stats.est_input_tokens += Number(e.est_input_tokens || 0);
+    } else if (e.phase === 'post') {
+      stats.post_count += 1;
+      stats.est_output_tokens += Number(e.est_output_tokens || 0);
+      if (e.ok === false) {
+        stats.failures.push({
+          timestamp: e.timestamp,
+          tool: e.tool,
+          kind: e.failure_kind,
+        });
+      }
+    }
+
+    const tool = e.tool || 'unknown';
+    if (!stats.by_tool[tool]) {
+      stats.by_tool[tool] = { calls: 0, input: 0, output: 0, failures: 0 };
+    }
+    if (e.phase === 'pre') stats.by_tool[tool].calls += 1;
+    stats.by_tool[tool].input += Number(e.est_input_tokens || 0);
+    stats.by_tool[tool].output += Number(e.est_output_tokens || 0);
+    if (e.ok === false) stats.by_tool[tool].failures += 1;
+  }
+
+  stats.est_total_tokens = stats.est_input_tokens + stats.est_output_tokens;
+  return stats;
+}
+
+function renderReport(stats) {
+  const lines = [];
+  lines.push('BYAN token ledger');
+  lines.push('');
+  lines.push(`  Tool calls         : ${stats.pre_count}`);
+  lines.push(`  Completed          : ${stats.post_count}`);
+  lines.push(`  Est. input tokens  : ${stats.est_input_tokens.toLocaleString()}`);
+  lines.push(`  Est. output tokens : ${stats.est_output_tokens.toLocaleString()}`);
+  lines.push(`  Est. total tokens  : ${stats.est_total_tokens.toLocaleString()}`);
+  lines.push(`  Failures           : ${stats.failures.length}`);
+
+  lines.push('');
+  lines.push('  Per tool :');
+  const rows = Object.entries(stats.by_tool).sort(
+    (a, b) => b[1].input + b[1].output - (a[1].input + a[1].output)
+  );
+  for (const [tool, s] of rows) {
+    const total = s.input + s.output;
+    const failNote = s.failures > 0 ? ` [${s.failures} fail]` : '';
+    lines.push(
+      `    ${tool.padEnd(16)} calls=${String(s.calls).padStart(3)}  in=${s.input
+        .toString()
+        .padStart(6)}  out=${s.output.toString().padStart(6)}  total=${total
+        .toString()
+        .padStart(7)}${failNote}`
+    );
+  }
+
+  if (stats.failures.length > 0) {
+    lines.push('');
+    lines.push('  Recent failures :');
+    for (const f of stats.failures.slice(-5)) {
+      lines.push(`    ${f.timestamp} ${f.tool} (${f.kind})`);
+    }
+  }
+
+  return lines.join('\n');
+}
+
+function defaultLogPath(projectRoot) {
+  const root = projectRoot || process.env.CLAUDE_PROJECT_DIR || process.cwd();
+  return path.join(root, '_byan-output', 'tool-log.jsonl');
+}
+
+module.exports = {
+  readLog,
+  summarize,
+  renderReport,
+  defaultLogPath,
+};

package/install/templates/.claude/agents/bmad-bmad-master.md

@@ -0,0 +1,14 @@
+---
+name: bmad-bmad-master
+description: bmad-master agent
+model: opus
+color: purple
+---
+
+# bmad-bmad-master
+
+bmad-master agent
+
+## Reporting contract
+
+When invoked via the Agent tool, stay in the persona above. Respond with a concise JSON report when the task completes : { status: "ok|partial|failed", summary: "<200 words", files_changed: [paths], next_steps: [] }.

package/install/templates/.claude/agents/bmad-bmb-agent-builder.md

@@ -0,0 +1,14 @@
+---
+name: bmad-bmb-agent-builder
+description: agent-builder agent
+model: sonnet
+color: blue
+---
+
+# bmad-bmb-agent-builder
+
+agent-builder agent
+
+## Reporting contract
+
+When invoked via the Agent tool, stay in the persona above. Respond with a concise JSON report when the task completes : { status: "ok|partial|failed", summary: "<200 words", files_changed: [paths], next_steps: [] }.

package/install/templates/.claude/agents/bmad-bmb-module-builder.md

@@ -0,0 +1,14 @@
+---
+name: bmad-bmb-module-builder
+description: module-builder agent
+model: sonnet
+color: blue
+---
+
+# bmad-bmb-module-builder
+
+module-builder agent
+
+## Reporting contract
+
+When invoked via the Agent tool, stay in the persona above. Respond with a concise JSON report when the task completes : { status: "ok|partial|failed", summary: "<200 words", files_changed: [paths], next_steps: [] }.

package/install/templates/.claude/agents/bmad-bmb-workflow-builder.md

@@ -0,0 +1,14 @@
+---
+name: bmad-bmb-workflow-builder
+description: workflow-builder agent
+model: sonnet
+color: blue
+---
+
+# bmad-bmb-workflow-builder
+
+workflow-builder agent
+
+## Reporting contract
+
+When invoked via the Agent tool, stay in the persona above. Respond with a concise JSON report when the task completes : { status: "ok|partial|failed", summary: "<200 words", files_changed: [paths], next_steps: [] }.

package/install/templates/.claude/agents/bmad-bmm-analyst.md

@@ -0,0 +1,14 @@
+---
+name: bmad-bmm-analyst
+description: analyst agent
+model: sonnet
+color: blue
+---
+
+# bmad-bmm-analyst
+
+analyst agent
+
+## Reporting contract
+
+When invoked via the Agent tool, stay in the persona above. Respond with a concise JSON report when the task completes : { status: "ok|partial|failed", summary: "<200 words", files_changed: [paths], next_steps: [] }.

package/install/templates/.claude/agents/bmad-bmm-architect.md

@@ -0,0 +1,14 @@
+---
+name: bmad-bmm-architect
+description: architect agent
+model: opus
+color: purple
+---
+
+# bmad-bmm-architect
+
+architect agent
+
+## Reporting contract
+
+When invoked via the Agent tool, stay in the persona above. Respond with a concise JSON report when the task completes : { status: "ok|partial|failed", summary: "<200 words", files_changed: [paths], next_steps: [] }.

package/install/templates/.claude/agents/bmad-bmm-dev.md

@@ -0,0 +1,14 @@
+---
+name: bmad-bmm-dev
+description: dev agent
+model: sonnet
+color: blue
+---
+
+# bmad-bmm-dev
+
+dev agent
+
+## Reporting contract
+
+When invoked via the Agent tool, stay in the persona above. Respond with a concise JSON report when the task completes : { status: "ok|partial|failed", summary: "<200 words", files_changed: [paths], next_steps: [] }.

package/install/templates/.claude/agents/bmad-bmm-pm.md

@@ -0,0 +1,14 @@
+---
+name: bmad-bmm-pm
+description: pm agent
+model: sonnet
+color: blue
+---
+
+# bmad-bmm-pm
+
+pm agent
+
+## Reporting contract
+
+When invoked via the Agent tool, stay in the persona above. Respond with a concise JSON report when the task completes : { status: "ok|partial|failed", summary: "<200 words", files_changed: [paths], next_steps: [] }.

package/install/templates/.claude/agents/bmad-bmm-quick-flow-solo-dev.md

@@ -0,0 +1,14 @@
+---
+name: bmad-bmm-quick-flow-solo-dev
+description: quick-flow-solo-dev agent
+model: sonnet
+color: blue
+---
+
+# bmad-bmm-quick-flow-solo-dev
+
+quick-flow-solo-dev agent
+
+## Reporting contract
+
+When invoked via the Agent tool, stay in the persona above. Respond with a concise JSON report when the task completes : { status: "ok|partial|failed", summary: "<200 words", files_changed: [paths], next_steps: [] }.

package/install/templates/.claude/agents/bmad-bmm-quinn.md

@@ -0,0 +1,14 @@
+---
+name: bmad-bmm-quinn
+description: quinn agent
+model: opus
+color: purple
+---
+
+# bmad-bmm-quinn
+
+quinn agent
+
+## Reporting contract
+
+When invoked via the Agent tool, stay in the persona above. Respond with a concise JSON report when the task completes : { status: "ok|partial|failed", summary: "<200 words", files_changed: [paths], next_steps: [] }.

package/install/templates/.claude/agents/bmad-bmm-sm.md

@@ -0,0 +1,14 @@
+---
+name: bmad-bmm-sm
+description: sm agent
+model: sonnet
+color: blue
+---
+
+# bmad-bmm-sm
+
+sm agent
+
+## Reporting contract
+
+When invoked via the Agent tool, stay in the persona above. Respond with a concise JSON report when the task completes : { status: "ok|partial|failed", summary: "<200 words", files_changed: [paths], next_steps: [] }.

package/install/templates/.claude/agents/bmad-bmm-tech-writer.md

@@ -0,0 +1,14 @@
+---
+name: bmad-bmm-tech-writer
+description: tech-writer agent
+model: sonnet
+color: blue
+---
+
+# bmad-bmm-tech-writer
+
+tech-writer agent
+
+## Reporting contract
+
+When invoked via the Agent tool, stay in the persona above. Respond with a concise JSON report when the task completes : { status: "ok|partial|failed", summary: "<200 words", files_changed: [paths], next_steps: [] }.

package/install/templates/.claude/agents/bmad-bmm-ux-designer.md

@@ -0,0 +1,14 @@
+---
+name: bmad-bmm-ux-designer
+description: ux-designer agent
+model: sonnet
+color: blue
+---
+
+# bmad-bmm-ux-designer
+
+ux-designer agent
+
+## Reporting contract
+
+When invoked via the Agent tool, stay in the persona above. Respond with a concise JSON report when the task completes : { status: "ok|partial|failed", summary: "<200 words", files_changed: [paths], next_steps: [] }.

package/install/templates/.claude/agents/bmad-byan-v2.md

@@ -0,0 +1,14 @@
+---
+name: bmad-byan-v2
+description: BYAN v2.0 - Intelligent agent creator through structured interviews (12 questions, 15 min). Powered by Merise Agile + TDD + 64 mantras.
+model: sonnet
+color: blue
+---
+
+# bmad-byan-v2
+
+BYAN v2.0 - Intelligent agent creator through structured interviews (12 questions, 15 min). Powered by Merise Agile + TDD + 64 mantras.
+
+## Reporting contract
+
+When invoked via the Agent tool, stay in the persona above. Respond with a concise JSON report when the task completes : { status: "ok|partial|failed", summary: "<200 words", files_changed: [paths], next_steps: [] }.