ma-agents 3.18.0-beta.2 → 3.18.0

package/lib/bmad-cache/gds/src/workflows/2-design/gds-gdd/scripts/render-validation-html.py

@@ -1,290 +0,0 @@
-#!/usr/bin/env python3
-# /// script
-# requires-python = ">=3.10"
-# ///
-"""Render a PRD validation findings JSON into HTML + markdown reports.
-
-Reads structured findings produced by the validator subagent, groups them by
-category (explicit `category` field, else derived from ID prefix), computes a
-pass/warn/fail summary and grade, substitutes into the configured HTML
-template, writes a markdown companion at the same path with `.md` extension,
-and optionally opens the HTML in the default browser.
-"""
-
-import argparse
-import html
-import json
-import string
-import sys
-import webbrowser
-from datetime import datetime
-from pathlib import Path
-
-CATEGORY_FROM_PREFIX = {
-    "Q": "Quality",
-    "D": "Discipline",
-    "S": "Structural integrity",
-    "STK": "Stakes-gated",
-    "M": "Mechanical",
-}
-
-CATEGORY_ORDER = ["Quality", "Discipline", "Structural integrity", "Stakes-gated", "Mechanical"]
-
-
-def category_for(finding: dict) -> str:
-    explicit = finding.get("category")
-    if explicit:
-        return explicit
-    fid = finding.get("id", "")
-    prefix = fid.split("-", 1)[0] if "-" in fid else fid
-    return CATEGORY_FROM_PREFIX.get(prefix, prefix or "Other")
-
-
-def compute_stats(findings: list[dict]) -> dict:
-    total = len(findings)
-    by_status = {"pass": 0, "warn": 0, "fail": 0, "n/a": 0}
-    failed_critical = 0
-    failed_high = 0
-    for f in findings:
-        status = (f.get("status") or "n/a").lower()
-        if status in by_status:
-            by_status[status] += 1
-        if status == "fail":
-            sev = (f.get("severity") or "low").lower()
-            if sev == "critical":
-                failed_critical += 1
-            elif sev == "high":
-                failed_high += 1
-    return {
-        "total": total,
-        "passed": by_status["pass"],
-        "warned": by_status["warn"],
-        "failed": by_status["fail"],
-        "na": by_status["n/a"],
-        "failed_critical": failed_critical,
-        "failed_high": failed_high,
-    }
-
-
-def grade_from(stats: dict) -> tuple[str, str]:
-    if stats["failed_critical"] > 0:
-        return "Poor", "grade-poor"
-    if stats["failed_high"] >= 1 or stats["failed"] >= 4:
-        return "Fair", "grade-fair"
-    if stats["failed"] > 0 or stats["warned"] > 2:
-        return "Good", "grade-good"
-    return "Excellent", "grade-excellent"
-
-
-def render_score_bar(stats: dict, width: int = 480, height: int = 22) -> str:
-    total = max(stats["total"], 1)
-    p = stats["passed"] / total * width
-    w = stats["warned"] / total * width
-    f = stats["failed"] / total * width
-    n = stats["na"] / total * width
-    return (
-        f'<svg width="{width}" height="{height}" viewBox="0 0 {width} {height}" role="img" '
-        f'aria-label="Pass / warn / fail / n-a breakdown">'
-        f'<rect x="0" y="0" width="{p:.1f}" height="{height}" fill="#22c55e"/>'
-        f'<rect x="{p:.1f}" y="0" width="{w:.1f}" height="{height}" fill="#eab308"/>'
-        f'<rect x="{p + w:.1f}" y="0" width="{f:.1f}" height="{height}" fill="#ef4444"/>'
-        f'<rect x="{p + w + f:.1f}" y="0" width="{n:.1f}" height="{height}" fill="#94a3b8"/>'
-        f"</svg>"
-    )
-
-
-def render_finding(f: dict) -> str:
-    status = (f.get("status") or "n/a").lower()
-    severity = (f.get("severity") or "low").lower()
-    fid = html.escape(f.get("id") or "")
-    title = html.escape(f.get("title") or fid)
-    location = html.escape(f.get("location") or "")
-    note = html.escape(f.get("note") or "")
-    fix = html.escape(f.get("suggested_fix") or "")
-
-    status_class = "na" if status == "n/a" else status
-    parts = [
-        f'<article class="finding finding-{status_class}">',
-        '<header>',
-        f'<span class="badge badge-status badge-{status_class}">{status.upper()}</span>',
-        f'<span class="badge badge-severity badge-sev-{severity}">{severity}</span>',
-        f'<span class="finding-id">{fid}</span>',
-        f'<h3 class="finding-title">{title}</h3>',
-        '</header>',
-    ]
-    if location:
-        parts.append(f'<div class="finding-location"><strong>Location:</strong> {location}</div>')
-    if note:
-        parts.append(f'<div class="finding-note">{note}</div>')
-    if fix:
-        parts.append(f'<div class="finding-fix"><strong>Suggested fix:</strong> {fix}</div>')
-    parts.append("</article>")
-    return "\n".join(parts)
-
-
-def render_category(name: str, findings: list[dict]) -> str:
-    items = "\n".join(render_finding(f) for f in findings)
-    name_e = html.escape(name)
-    return (
-        f'<section class="category">'
-        f"<details open>"
-        f'<summary><h2>{name_e} <span class="count">({len(findings)})</span></h2></summary>'
-        f"{items}"
-        f"</details>"
-        f"</section>"
-    )
-
-
-SEVERITY_ORDER = ["critical", "high", "medium", "low"]
-
-
-def render_finding_md(f: dict) -> str:
-    status = (f.get("status") or "n/a").upper()
-    severity = (f.get("severity") or "low").lower()
-    fid = f.get("id") or ""
-    title = f.get("title") or fid
-    location = f.get("location") or ""
-    note = f.get("note") or ""
-    fix = f.get("suggested_fix") or ""
-
-    lines = [f"### [{status}] {fid} — {title} _(severity: {severity})_"]
-    if location:
-        lines.append(f"- **Location:** {location}")
-    if note:
-        lines.append(f"- **Finding:** {note}")
-    if fix:
-        lines.append(f"- **Suggested fix:** {fix}")
-    return "\n".join(lines)
-
-
-def render_markdown_report(data: dict, findings: list[dict], stats: dict, grade: str) -> str:
-    prd_name = data.get("prd_name") or "PRD"
-    prd_path = data.get("prd_path") or ""
-    checklist_path = data.get("checklist_path") or ""
-    timestamp = data.get("timestamp") or datetime.now().isoformat(timespec="seconds")
-    synthesis = data.get("overall_synthesis") or ""
-
-    out = [
-        f"# Validation Report — {prd_name}",
-        "",
-        f"- **PRD:** `{prd_path}`",
-        f"- **Checklist:** `{checklist_path}`",
-        f"- **Run at:** {timestamp}",
-        f"- **Grade:** {grade}",
-        "",
-        f"**Summary:** {stats['passed']} pass · {stats['warned']} warn · {stats['failed']} fail · {stats['na']} n/a "
-        f"(total {stats['total']}; critical fails: {stats['failed_critical']}, high fails: {stats['failed_high']})",
-    ]
-    if synthesis:
-        out += ["", "## Overall synthesis", "", synthesis]
-
-    # Group by severity then status: failed criticals first, then highs, etc.
-    by_sev: dict[str, list[dict]] = {s: [] for s in SEVERITY_ORDER}
-    other: list[dict] = []
-    for f in findings:
-        sev = (f.get("severity") or "low").lower()
-        if sev in by_sev:
-            by_sev[sev].append(f)
-        else:
-            other.append(f)
-
-    out += ["", "## Findings by severity"]
-    any_findings = False
-    for sev in SEVERITY_ORDER:
-        items = by_sev[sev]
-        if not items:
-            continue
-        any_findings = True
-        out += ["", f"### {sev.capitalize()} ({len(items)})", ""]
-        out += [render_finding_md(f) for f in items]
-    if other:
-        any_findings = True
-        out += ["", f"### Other ({len(other)})", ""]
-        out += [render_finding_md(f) for f in other]
-    if not any_findings:
-        out += ["", "_No findings._"]
-
-    return "\n".join(out) + "\n"
-
-
-def main(argv: list[str]) -> int:
-    parser = argparse.ArgumentParser(description="Render PRD validation findings to HTML.")
-    parser.add_argument("--findings", required=True, help="Path to validation-findings.json")
-    parser.add_argument("--template", required=True, help="Path to HTML template")
-    parser.add_argument("--output", required=True, help="Path to write the rendered HTML")
-    parser.add_argument("--open", action="store_true", help="Open the rendered HTML in the default browser")
-    args = parser.parse_args(argv)
-
-    findings_path = Path(args.findings)
-    template_path = Path(args.template)
-    output_path = Path(args.output)
-
-    try:
-        data = json.loads(findings_path.read_text(encoding="utf-8"))
-    except FileNotFoundError:
-        print(f"error: findings file not found: {findings_path}", file=sys.stderr)
-        return 1
-    except json.JSONDecodeError as e:
-        print(f"error: findings file is not valid JSON ({findings_path}): {e}", file=sys.stderr)
-        return 1
-    try:
-        template = template_path.read_text(encoding="utf-8")
-    except FileNotFoundError:
-        print(f"error: template file not found: {template_path}", file=sys.stderr)
-        return 1
-
-    findings = data.get("findings", []) or []
-
-    by_cat: dict[str, list[dict]] = {}
-    for f in findings:
-        by_cat.setdefault(category_for(f), []).append(f)
-
-    sorted_cats = sorted(
-        by_cat.keys(),
-        key=lambda c: (CATEGORY_ORDER.index(c) if c in CATEGORY_ORDER else 99, c),
-    )
-    categories_html = "\n".join(render_category(c, by_cat[c]) for c in sorted_cats)
-
-    stats = compute_stats(findings)
-    grade, grade_class = grade_from(stats)
-    score_svg = render_score_bar(stats)
-
-    timestamp = data.get("timestamp") or datetime.now().isoformat(timespec="seconds")
-    substitutions = {
-        "prd_name": html.escape(str(data.get("prd_name") or "PRD")),
-        "prd_path": html.escape(str(data.get("prd_path") or "")),
-        "checklist_path": html.escape(str(data.get("checklist_path") or "")),
-        "timestamp": html.escape(timestamp),
-        "overall_synthesis": html.escape(str(data.get("overall_synthesis") or "")),
-        "grade": grade,
-        "grade_class": grade_class,
-        "total": str(stats["total"]),
-        "passed": str(stats["passed"]),
-        "failed": str(stats["failed"]),
-        "warned": str(stats["warned"]),
-        "na": str(stats["na"]),
-        "score_svg": score_svg,
-        "categories_html": categories_html,
-    }
-
-    rendered = string.Template(template).safe_substitute(substitutions)
-    output_path.write_text(rendered, encoding="utf-8")
-
-    md_path = output_path.with_suffix(".md")
-    md_path.write_text(render_markdown_report(data, findings, stats, grade), encoding="utf-8")
-
-    print(json.dumps({
-        "output": str(output_path),
-        "markdown": str(md_path),
-        "grade": grade,
-        "stats": stats,
-    }))
-
-    if args.open:
-        webbrowser.open(output_path.resolve().as_uri())
-
-    return 0
-
-
-if __name__ == "__main__":
-    sys.exit(main(sys.argv[1:]))

package/lib/bmad-cache/gds/src/workflows/2-design/gds-prd/assets/validation-report-template.html

@@ -1,190 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="utf-8">
-<title>PRD Validation: $prd_name</title>
-<style>
-  :root {
-    --bg: #fafaf9;
-    --surface: #ffffff;
-    --border: #e7e5e4;
-    --text: #1c1917;
-    --muted: #78716c;
-    --pass: #22c55e;
-    --warn: #eab308;
-    --fail: #ef4444;
-    --na: #94a3b8;
-    --sev-low: #64748b;
-    --sev-medium: #ca8a04;
-    --sev-high: #ea580c;
-    --sev-critical: #dc2626;
-    --grade-exc: #16a34a;
-    --grade-good: #65a30d;
-    --grade-fair: #d97706;
-    --grade-poor: #dc2626;
-  }
-  * { box-sizing: border-box; }
-  html, body { margin: 0; padding: 0; }
-  body {
-    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Inter, system-ui, sans-serif;
-    background: var(--bg);
-    color: var(--text);
-    line-height: 1.55;
-    font-size: 15px;
-  }
-  .container { max-width: 960px; margin: 0 auto; padding: 32px 24px 64px; }
-
-  header.report-header {
-    display: flex;
-    align-items: center;
-    justify-content: space-between;
-    gap: 24px;
-    padding-bottom: 16px;
-    border-bottom: 1px solid var(--border);
-    margin-bottom: 24px;
-  }
-  .title h1 { margin: 0; font-size: 22px; font-weight: 600; letter-spacing: -0.01em; }
-  .title .subtitle { color: var(--muted); font-size: 13px; margin-top: 4px; font-family: ui-monospace, "SF Mono", Menlo, monospace; }
-  .grade {
-    padding: 10px 18px;
-    border-radius: 8px;
-    font-weight: 600;
-    color: white;
-    font-size: 15px;
-    white-space: nowrap;
-  }
-  .grade-excellent { background: var(--grade-exc); }
-  .grade-good { background: var(--grade-good); }
-  .grade-fair { background: var(--grade-fair); }
-  .grade-poor { background: var(--grade-poor); }
-
-  .synthesis {
-    background: var(--surface);
-    border: 1px solid var(--border);
-    border-left: 3px solid var(--muted);
-    border-radius: 8px;
-    padding: 16px 20px;
-    margin-bottom: 24px;
-    color: var(--text);
-    font-size: 15px;
-  }
-  .synthesis:empty { display: none; }
-
-  .scoreboard {
-    background: var(--surface);
-    border: 1px solid var(--border);
-    border-radius: 8px;
-    padding: 18px 20px;
-    margin-bottom: 24px;
-  }
-  .score-bar { margin: 0 0 14px; line-height: 0; }
-  .score-stats { display: flex; gap: 22px; font-size: 14px; flex-wrap: wrap; }
-  .score-stats span { display: inline-flex; align-items: center; gap: 6px; }
-  .score-stats .dot { width: 10px; height: 10px; border-radius: 50%; display: inline-block; }
-  .dot-pass { background: var(--pass); }
-  .dot-warn { background: var(--warn); }
-  .dot-fail { background: var(--fail); }
-  .dot-na { background: var(--na); }
-  .total-count { margin-left: auto; color: var(--muted); }
-
-  section.category { margin-bottom: 16px; }
-  section.category details {
-    background: var(--surface);
-    border: 1px solid var(--border);
-    border-radius: 8px;
-    overflow: hidden;
-  }
-  section.category summary {
-    padding: 14px 20px;
-    cursor: pointer;
-    user-select: none;
-    list-style: none;
-  }
-  section.category summary::-webkit-details-marker { display: none; }
-  section.category summary::before {
-    content: "▸";
-    display: inline-block;
-    margin-right: 10px;
-    color: var(--muted);
-    transition: transform 0.15s ease;
-  }
-  section.category details[open] summary::before { transform: rotate(90deg); }
-  section.category summary h2 { display: inline; margin: 0; font-size: 16px; font-weight: 600; letter-spacing: -0.005em; }
-  section.category .count { color: var(--muted); font-weight: 400; margin-left: 6px; font-size: 14px; }
-
-  article.finding { padding: 16px 20px; border-top: 1px solid var(--border); }
-  article.finding-fail { background: rgba(239, 68, 68, 0.025); }
-  article.finding header {
-    display: flex;
-    align-items: center;
-    gap: 10px;
-    flex-wrap: wrap;
-    margin-bottom: 8px;
-  }
-  .badge {
-    font-size: 10.5px;
-    padding: 3px 8px;
-    border-radius: 4px;
-    font-weight: 600;
-    text-transform: uppercase;
-    letter-spacing: 0.04em;
-    line-height: 1.4;
-  }
-  .badge-pass { background: rgba(34, 197, 94, 0.12); color: #15803d; }
-  .badge-warn { background: rgba(234, 179, 8, 0.14); color: #854d0e; }
-  .badge-fail { background: rgba(239, 68, 68, 0.12); color: #b91c1c; }
-  .badge-na { background: rgba(148, 163, 184, 0.16); color: #475569; }
-  .badge-sev-low { background: rgba(100, 116, 139, 0.12); color: var(--sev-low); }
-  .badge-sev-medium { background: rgba(202, 138, 4, 0.14); color: var(--sev-medium); }
-  .badge-sev-high { background: rgba(234, 88, 12, 0.14); color: var(--sev-high); }
-  .badge-sev-critical { background: rgba(220, 38, 38, 0.14); color: var(--sev-critical); }
-  .finding-id { font-family: ui-monospace, "SF Mono", Menlo, monospace; font-size: 12px; color: var(--muted); }
-  .finding-title { margin: 0; font-size: 15px; font-weight: 500; flex: 1; min-width: 200px; }
-  .finding-location, .finding-note, .finding-fix { margin-top: 6px; font-size: 14px; color: var(--text); }
-  .finding-location strong, .finding-fix strong { color: var(--muted); font-weight: 500; }
-
-  footer.report-footer {
-    margin-top: 40px;
-    padding-top: 16px;
-    border-top: 1px solid var(--border);
-    font-size: 12px;
-    color: var(--muted);
-    font-family: ui-monospace, "SF Mono", Menlo, monospace;
-  }
-  footer .meta { display: flex; gap: 24px; flex-wrap: wrap; }
-</style>
-</head>
-<body>
-  <div class="container">
-    <header class="report-header">
-      <div class="title">
-        <h1>$prd_name — Validation Report</h1>
-        <div class="subtitle">$prd_path</div>
-      </div>
-      <div class="grade $grade_class">$grade</div>
-    </header>
-
-    <div class="synthesis">$overall_synthesis</div>
-
-    <div class="scoreboard">
-      <div class="score-bar">$score_svg</div>
-      <div class="score-stats">
-        <span><span class="dot dot-pass"></span>$passed pass</span>
-        <span><span class="dot dot-warn"></span>$warned warn</span>
-        <span><span class="dot dot-fail"></span>$failed fail</span>
-        <span><span class="dot dot-na"></span>$na n/a</span>
-        <span class="total-count">$total items checked</span>
-      </div>
-    </div>
-
-    $categories_html
-
-    <footer class="report-footer">
-      <div class="meta">
-        <span>Checklist: $checklist_path</span>
-        <span>Generated: $timestamp</span>
-      </div>
-    </footer>
-  </div>
-</body>
-</html>

package/lib/bmad-cache/gds/src/workflows/2-design/gds-prd/customize.toml

@@ -1,84 +0,0 @@
-# DO NOT EDIT -- overwritten on every update.
-#
-# Workflow customization surface for gds-prd.
-#
-# Override files (not edited here):
-#   {project-root}/_bmad/custom/gds-prd.toml         (team)
-#   {project-root}/_bmad/custom/gds-prd.user.toml    (personal)
-
-[workflow]
-
-# --- Configurable below. Overrides merge per BMad structural rules: ---
-#   scalars: override wins • arrays: append
-
-# Steps to run before the standard activation (config load, greet).
-# Use for pre-flight loads, compliance checks, etc.
-activation_steps_prepend = []
-
-# Steps to run after greet but before the workflow begins.
-# Use for context-heavy setup that should happen once the user has been acknowledged.
-activation_steps_append = []
-
-# Persistent facts the workflow keeps in mind for the whole run
-# (standards, compliance constraints, stylistic guardrails).
-# Each entry is either a literal sentence, a skill prefixed with `skill:`, or a `file:`-prefixed
-# path/glob whose contents are loaded as facts.
-#
-# Default loads project-context.md if gds-generate-project-context has produced one — this gives
-# the facilitator persistent awareness of the project's tech, domain, and constraints without
-# re-asking. Common opt-ins (set in team/user override TOML):
-#   "skill:acme-studio:terms-and-conditions"                                  # a skill that contains relevant info
-#   "Every PRD requirement must be testable and traceable to a GDD pillar."   # generic agent instruction
-persistent_facts = [
-  "file:{project-root}/**/project-context.md",
-]
-
-# Executed when the workflow completes (after the user has been told the
-# PRD is ready). Accepts either a string scalar (single instruction)
-# or an array of instructions executed in order. Empty for none.
-on_complete = ""
-
-# Default PRD structure. Treated as a starting point — the LLM adapts it
-# to the product, project type, and domain. Override the path in team/user TOML
-# to enforce a different structure (e.g. regulated-industry, internal-tool).
-prd_template = "assets/prd-template.md"
-
-# Validation checklist used at the Validate intent and at Finalize step 3.
-# A subagent walks the checklist against prd.md and returns structured findings.
-# Override the path in team/user TOML to enforce a studio-specific checklist.
-validation_checklist = "assets/prd-validation-checklist.md"
-
-# HTML skeleton the synthesis pass fills directly when consolidating reviewer
-# outputs into a validation report. No substitution engine — the parent LLM
-# writes the final HTML. Fully overridable to match studio branding.
-# Uses inline CSS, no external dependencies, and native HTML <details> for
-# collapse — no JS.
-validation_report_template = "assets/validation-report-template.html"
-
-# Run folder location. The PRD, optional addendum, decision log, and optional
-# validation report all land inside `{output_dir}/{output_folder_name}/`.
-output_dir = "{planning_artifacts}/prds"
-output_folder_name = "prd-{project_name}-{date}"
-
-# Document standards applied to human-consumed docs at Finalize. Each entry is
-# a `skill:`, `file:`, or plain-text directive; the parent LLM applies the
-# findings before the user sees the draft. Empty by default — Game Dev Studio
-# ships no editorial-review skills. Add your own in team/user override TOML:
-#   "skill:my-studio:editorial-review-prose"
-#   "file:{project-root}/_bmad/style-guides/studio-voice.md"
-#   "Convert all dates to ISO 8601 format."
-doc_standards = []
-
-# External-source registry. Natural-language directives describing knowledge
-# bases, MCP tools, or internal systems the LLM may consult during the workflow
-# when a relevant need surfaces. The LLM does NOT query these preemptively —
-# it consults them on demand. If a named MCP tool is unavailable at runtime,
-# the LLM falls back to standard behavior and notes the gap. Empty by default.
-external_sources = []
-
-# External-handoff routing. Natural-language directives the LLM applies at
-# Finalize to route outputs beyond local files (Confluence, Notion, Google
-# Drive, ticket systems, etc.). Handoffs run after the artifact is polished
-# and before the final user-facing message. URLs or IDs returned by the
-# destination are captured and surfaced to the user. Empty by default.
-external_handoffs = []