ma-agents 3.12.0 → 3.12.2

package/lib/bmad-cache/bmb/samples/sample-module-setup/scripts/merge-help-csv.py

@@ -1,218 +1,218 @@
-#!/usr/bin/env python3
-# /// script
-# requires-python = ">=3.9"
-# dependencies = []
-# ///
-"""Merge module help entries into shared _bmad/module-help.csv.
-
-Reads a source CSV with module help entries and merges them into a target CSV.
-Uses an anti-zombie pattern: all existing rows matching the source module code
-are removed before appending fresh rows.
-
-Legacy cleanup: when --legacy-dir and --module-code are provided, deletes old
-per-module module-help.csv files from {legacy-dir}/{module-code}/ and
-{legacy-dir}/core/. Only the current module and core are touched.
-
-Exit codes: 0=success, 1=validation error, 2=runtime error
-"""
-
-import argparse
-import csv
-import json
-import sys
-from io import StringIO
-from pathlib import Path
-
-# CSV header for module-help.csv
-HEADER = [
-    "module",
-    "skill",
-    "display-name",
-    "menu-code",
-    "description",
-    "action",
-    "args",
-    "phase",
-    "after",
-    "before",
-    "required",
-    "output-location",
-    "outputs",
-]
-
-
-def parse_args():
-    parser = argparse.ArgumentParser(
-        description="Merge module help entries into shared _bmad/module-help.csv with anti-zombie pattern."
-    )
-    parser.add_argument(
-        "--target",
-        required=True,
-        help="Path to the target _bmad/module-help.csv file",
-    )
-    parser.add_argument(
-        "--source",
-        required=True,
-        help="Path to the source module-help.csv with entries to merge",
-    )
-    parser.add_argument(
-        "--legacy-dir",
-        help="Path to _bmad/ directory to check for legacy per-module CSV files.",
-    )
-    parser.add_argument(
-        "--module-code",
-        help="Module code (required with --legacy-dir for scoping cleanup).",
-    )
-    parser.add_argument(
-        "--verbose",
-        action="store_true",
-        help="Print detailed progress to stderr",
-    )
-    return parser.parse_args()
-
-
-def read_csv_rows(path: str) -> tuple[list[str], list[list[str]]]:
-    """Read CSV file returning (header, data_rows).
-
-    Returns empty header and rows if file doesn't exist.
-    """
-    file_path = Path(path)
-    if not file_path.exists():
-        return [], []
-
-    with open(file_path, "r", encoding="utf-8", newline="") as f:
-        content = f.read()
-
-    reader = csv.reader(StringIO(content))
-    rows = list(reader)
-
-    if not rows:
-        return [], []
-
-    return rows[0], rows[1:]
-
-
-def extract_module_codes(rows: list[list[str]]) -> set[str]:
-    """Extract unique module codes from data rows."""
-    codes = set()
-    for row in rows:
-        if row and row[0].strip():
-            codes.add(row[0].strip())
-    return codes
-
-
-def filter_rows(rows: list[list[str]], module_code: str) -> list[list[str]]:
-    """Remove all rows matching the given module code."""
-    return [row for row in rows if not row or row[0].strip() != module_code]
-
-
-def write_csv(path: str, header: list[str], rows: list[list[str]], verbose: bool = False) -> None:
-    """Write header + rows to CSV file, creating parent dirs as needed."""
-    file_path = Path(path)
-    file_path.parent.mkdir(parents=True, exist_ok=True)
-
-    if verbose:
-        print(f"Writing {len(rows)} data rows to {path}", file=sys.stderr)
-
-    with open(file_path, "w", encoding="utf-8", newline="") as f:
-        writer = csv.writer(f)
-        writer.writerow(header)
-        for row in rows:
-            writer.writerow(row)
-
-
-def cleanup_legacy_csvs(
-    legacy_dir: str, module_code: str, verbose: bool = False
-) -> list:
-    """Delete legacy per-module module-help.csv files for this module and core only.
-
-    Returns list of deleted file paths.
-    """
-    deleted = []
-    for subdir in (module_code, "core"):
-        legacy_path = Path(legacy_dir) / subdir / "module-help.csv"
-        if legacy_path.exists():
-            if verbose:
-                print(f"Deleting legacy CSV: {legacy_path}", file=sys.stderr)
-            legacy_path.unlink()
-            deleted.append(str(legacy_path))
-    return deleted
-
-
-def main():
-    args = parse_args()
-
-    # Read source entries
-    source_header, source_rows = read_csv_rows(args.source)
-    if not source_rows:
-        print(f"Error: No data rows found in source {args.source}", file=sys.stderr)
-        sys.exit(1)
-
-    # Determine module codes being merged
-    source_codes = extract_module_codes(source_rows)
-    if not source_codes:
-        print("Error: Could not determine module code from source rows", file=sys.stderr)
-        sys.exit(1)
-
-    if args.verbose:
-        print(f"Source module codes: {source_codes}", file=sys.stderr)
-        print(f"Source rows: {len(source_rows)}", file=sys.stderr)
-
-    # Read existing target (may not exist)
-    target_header, target_rows = read_csv_rows(args.target)
-    target_existed = Path(args.target).exists()
-
-    if args.verbose:
-        print(f"Target exists: {target_existed}", file=sys.stderr)
-        if target_existed:
-            print(f"Existing target rows: {len(target_rows)}", file=sys.stderr)
-
-    # Use source header if target doesn't exist or has no header
-    header = target_header if target_header else (source_header if source_header else HEADER)
-
-    # Anti-zombie: remove all rows for each source module code
-    filtered_rows = target_rows
-    removed_count = 0
-    for code in source_codes:
-        before_count = len(filtered_rows)
-        filtered_rows = filter_rows(filtered_rows, code)
-        removed_count += before_count - len(filtered_rows)
-
-    if args.verbose and removed_count > 0:
-        print(f"Removed {removed_count} existing rows (anti-zombie)", file=sys.stderr)
-
-    # Append source rows
-    merged_rows = filtered_rows + source_rows
-
-    # Write result
-    write_csv(args.target, header, merged_rows, args.verbose)
-
-    # Legacy cleanup: delete old per-module CSV files
-    legacy_deleted = []
-    if args.legacy_dir:
-        if not args.module_code:
-            print(
-                "Error: --module-code is required when --legacy-dir is provided",
-                file=sys.stderr,
-            )
-            sys.exit(1)
-        legacy_deleted = cleanup_legacy_csvs(
-            args.legacy_dir, args.module_code, args.verbose
-        )
-
-    # Output result summary as JSON
-    result = {
-        "status": "success",
-        "target_path": str(Path(args.target).resolve()),
-        "target_existed": target_existed,
-        "module_codes": sorted(source_codes),
-        "rows_removed": removed_count,
-        "rows_added": len(source_rows),
-        "total_rows": len(merged_rows),
-        "legacy_csvs_deleted": legacy_deleted,
-    }
-    print(json.dumps(result, indent=2))
-
-
-if __name__ == "__main__":
-    main()
+#!/usr/bin/env python3
+# /// script
+# requires-python = ">=3.9"
+# dependencies = []
+# ///
+"""Merge module help entries into shared _bmad/module-help.csv.
+
+Reads a source CSV with module help entries and merges them into a target CSV.
+Uses an anti-zombie pattern: all existing rows matching the source module code
+are removed before appending fresh rows.
+
+Legacy cleanup: when --legacy-dir and --module-code are provided, deletes old
+per-module module-help.csv files from {legacy-dir}/{module-code}/ and
+{legacy-dir}/core/. Only the current module and core are touched.
+
+Exit codes: 0=success, 1=validation error, 2=runtime error
+"""
+
+import argparse
+import csv
+import json
+import sys
+from io import StringIO
+from pathlib import Path
+
+# CSV header for module-help.csv
+HEADER = [
+    "module",
+    "skill",
+    "display-name",
+    "menu-code",
+    "description",
+    "action",
+    "args",
+    "phase",
+    "after",
+    "before",
+    "required",
+    "output-location",
+    "outputs",
+]
+
+
+def parse_args():
+    parser = argparse.ArgumentParser(
+        description="Merge module help entries into shared _bmad/module-help.csv with anti-zombie pattern."
+    )
+    parser.add_argument(
+        "--target",
+        required=True,
+        help="Path to the target _bmad/module-help.csv file",
+    )
+    parser.add_argument(
+        "--source",
+        required=True,
+        help="Path to the source module-help.csv with entries to merge",
+    )
+    parser.add_argument(
+        "--legacy-dir",
+        help="Path to _bmad/ directory to check for legacy per-module CSV files.",
+    )
+    parser.add_argument(
+        "--module-code",
+        help="Module code (required with --legacy-dir for scoping cleanup).",
+    )
+    parser.add_argument(
+        "--verbose",
+        action="store_true",
+        help="Print detailed progress to stderr",
+    )
+    return parser.parse_args()
+
+
+def read_csv_rows(path: str) -> tuple[list[str], list[list[str]]]:
+    """Read CSV file returning (header, data_rows).
+
+    Returns empty header and rows if file doesn't exist.
+    """
+    file_path = Path(path)
+    if not file_path.exists():
+        return [], []
+
+    with open(file_path, "r", encoding="utf-8", newline="") as f:
+        content = f.read()
+
+    reader = csv.reader(StringIO(content))
+    rows = list(reader)
+
+    if not rows:
+        return [], []
+
+    return rows[0], rows[1:]
+
+
+def extract_module_codes(rows: list[list[str]]) -> set[str]:
+    """Extract unique module codes from data rows."""
+    codes = set()
+    for row in rows:
+        if row and row[0].strip():
+            codes.add(row[0].strip())
+    return codes
+
+
+def filter_rows(rows: list[list[str]], module_code: str) -> list[list[str]]:
+    """Remove all rows matching the given module code."""
+    return [row for row in rows if not row or row[0].strip() != module_code]
+
+
+def write_csv(path: str, header: list[str], rows: list[list[str]], verbose: bool = False) -> None:
+    """Write header + rows to CSV file, creating parent dirs as needed."""
+    file_path = Path(path)
+    file_path.parent.mkdir(parents=True, exist_ok=True)
+
+    if verbose:
+        print(f"Writing {len(rows)} data rows to {path}", file=sys.stderr)
+
+    with open(file_path, "w", encoding="utf-8", newline="") as f:
+        writer = csv.writer(f)
+        writer.writerow(header)
+        for row in rows:
+            writer.writerow(row)
+
+
+def cleanup_legacy_csvs(
+    legacy_dir: str, module_code: str, verbose: bool = False
+) -> list:
+    """Delete legacy per-module module-help.csv files for this module and core only.
+
+    Returns list of deleted file paths.
+    """
+    deleted = []
+    for subdir in (module_code, "core"):
+        legacy_path = Path(legacy_dir) / subdir / "module-help.csv"
+        if legacy_path.exists():
+            if verbose:
+                print(f"Deleting legacy CSV: {legacy_path}", file=sys.stderr)
+            legacy_path.unlink()
+            deleted.append(str(legacy_path))
+    return deleted
+
+
+def main():
+    args = parse_args()
+
+    # Read source entries
+    source_header, source_rows = read_csv_rows(args.source)
+    if not source_rows:
+        print(f"Error: No data rows found in source {args.source}", file=sys.stderr)
+        sys.exit(1)
+
+    # Determine module codes being merged
+    source_codes = extract_module_codes(source_rows)
+    if not source_codes:
+        print("Error: Could not determine module code from source rows", file=sys.stderr)
+        sys.exit(1)
+
+    if args.verbose:
+        print(f"Source module codes: {source_codes}", file=sys.stderr)
+        print(f"Source rows: {len(source_rows)}", file=sys.stderr)
+
+    # Read existing target (may not exist)
+    target_header, target_rows = read_csv_rows(args.target)
+    target_existed = Path(args.target).exists()
+
+    if args.verbose:
+        print(f"Target exists: {target_existed}", file=sys.stderr)
+        if target_existed:
+            print(f"Existing target rows: {len(target_rows)}", file=sys.stderr)
+
+    # Use source header if target doesn't exist or has no header
+    header = target_header if target_header else (source_header if source_header else HEADER)
+
+    # Anti-zombie: remove all rows for each source module code
+    filtered_rows = target_rows
+    removed_count = 0
+    for code in source_codes:
+        before_count = len(filtered_rows)
+        filtered_rows = filter_rows(filtered_rows, code)
+        removed_count += before_count - len(filtered_rows)
+
+    if args.verbose and removed_count > 0:
+        print(f"Removed {removed_count} existing rows (anti-zombie)", file=sys.stderr)
+
+    # Append source rows
+    merged_rows = filtered_rows + source_rows
+
+    # Write result
+    write_csv(args.target, header, merged_rows, args.verbose)
+
+    # Legacy cleanup: delete old per-module CSV files
+    legacy_deleted = []
+    if args.legacy_dir:
+        if not args.module_code:
+            print(
+                "Error: --module-code is required when --legacy-dir is provided",
+                file=sys.stderr,
+            )
+            sys.exit(1)
+        legacy_deleted = cleanup_legacy_csvs(
+            args.legacy_dir, args.module_code, args.verbose
+        )
+
+    # Output result summary as JSON
+    result = {
+        "status": "success",
+        "target_path": str(Path(args.target).resolve()),
+        "target_existed": target_existed,
+        "module_codes": sorted(source_codes),
+        "rows_removed": removed_count,
+        "rows_added": len(source_rows),
+        "total_rows": len(merged_rows),
+        "legacy_csvs_deleted": legacy_deleted,
+    }
+    print(json.dumps(result, indent=2))
+
+
+if __name__ == "__main__":
+    main()

package/lib/bmad-cache/bmb/skills/bmad-agent-builder/assets/customize-template.toml

@@ -1,62 +1,62 @@
-# DO NOT EDIT -- overwritten on every update.
-#
-# Agent customization surface for {skill-name}.
-# Team overrides:     {project-root}/_bmad/custom/{skill-name}.toml
-# Personal overrides: {project-root}/_bmad/custom/{skill-name}.user.toml
-
-[agent]
-
-# --- Metadata (install-time roster contract) ---
-# Consumed by module.yaml:agents[] and `[agents.<code>]` in central config.
-
-code = "{agent-code}"
-name = "{agent-name-or-empty}"
-title = "{agent-title}"
-icon = "{agent-icon}"
-description = "{agent-description}"
-agent_type = "{agent-type}"   # stateless | memory | autonomous
-
-{if-customizable}
-
-# --- Configurable below. Overrides merge per BMad structural rules: ---
-#   scalars: override wins • arrays (persistent_facts, activation_steps_*): append
-#   arrays-of-tables with `code`/`id`: replace matching items, append new ones.
-#
-# For memory/autonomous agents: your sanctum (PERSONA/CREED/BOND/CAPABILITIES)
-# is the primary behavior surface. Prefer editing sanctum files over this block.
-
-# Steps to run before the standard activation (config load, greet).
-# Overrides append. Use for pre-flight loads, compliance checks, etc.
-
-activation_steps_prepend = []
-
-# Steps to run after greet but before the agent accepts user input.
-# Overrides append. Use for context-heavy setup that should happen
-# once the user has been acknowledged.
-
-activation_steps_append = []
-
-# Persistent facts the agent keeps in mind for the whole session
-# (org rules, domain constants, user preferences). Overrides append.
-#
-# Each entry is either:
-#   - a literal sentence, e.g. "Our org is AWS-only -- do not propose GCP or Azure."
-#   - a file reference prefixed with `file:`, e.g. "file:{project-root}/docs/standards.md"
-#     (glob patterns are supported; the file's contents are loaded and treated as facts).
-
-persistent_facts = [
-  "file:{project-root}/**/project-context.md",
-]
-
-# --- Agent-specific configurables (lifted during Configurability Discovery) ---
-#
-# Swappable reference docs, output paths, or hooks the builder surfaced with
-# the author. Bare paths resolve from the skill root; use `{project-root}/...`
-# to point at an org-owned resource elsewhere in the repo. Override wins.
-#
-# Naming conventions:
-#   *_template        -- file paths for templates the agent loads
-#   *_output_path     -- writable destinations
-#   on_<event>        -- hook scalars (prompts/commands)
-
-{/if-customizable}
+# DO NOT EDIT -- overwritten on every update.
+#
+# Agent customization surface for {skill-name}.
+# Team overrides:     {project-root}/_bmad/custom/{skill-name}.toml
+# Personal overrides: {project-root}/_bmad/custom/{skill-name}.user.toml
+
+[agent]
+
+# --- Metadata (install-time roster contract) ---
+# Consumed by module.yaml:agents[] and `[agents.<code>]` in central config.
+
+code = "{agent-code}"
+name = "{agent-name-or-empty}"
+title = "{agent-title}"
+icon = "{agent-icon}"
+description = "{agent-description}"
+agent_type = "{agent-type}"   # stateless | memory | autonomous
+
+{if-customizable}
+
+# --- Configurable below. Overrides merge per BMad structural rules: ---
+#   scalars: override wins • arrays (persistent_facts, activation_steps_*): append
+#   arrays-of-tables with `code`/`id`: replace matching items, append new ones.
+#
+# For memory/autonomous agents: your sanctum (PERSONA/CREED/BOND/CAPABILITIES)
+# is the primary behavior surface. Prefer editing sanctum files over this block.
+
+# Steps to run before the standard activation (config load, greet).
+# Overrides append. Use for pre-flight loads, compliance checks, etc.
+
+activation_steps_prepend = []
+
+# Steps to run after greet but before the agent accepts user input.
+# Overrides append. Use for context-heavy setup that should happen
+# once the user has been acknowledged.
+
+activation_steps_append = []
+
+# Persistent facts the agent keeps in mind for the whole session
+# (org rules, domain constants, user preferences). Overrides append.
+#
+# Each entry is either:
+#   - a literal sentence, e.g. "Our org is AWS-only -- do not propose GCP or Azure."
+#   - a file reference prefixed with `file:`, e.g. "file:{project-root}/docs/standards.md"
+#     (glob patterns are supported; the file's contents are loaded and treated as facts).
+
+persistent_facts = [
+  "file:{project-root}/**/project-context.md",
+]
+
+# --- Agent-specific configurables (lifted during Configurability Discovery) ---
+#
+# Swappable reference docs, output paths, or hooks the builder surfaced with
+# the author. Bare paths resolve from the skill root; use `{project-root}/...`
+# to point at an org-owned resource elsewhere in the repo. Override wins.
+#
+# Naming conventions:
+#   *_template        -- file paths for templates the agent loads
+#   *_output_path     -- writable destinations
+#   on_<event>        -- hook scalars (prompts/commands)
+
+{/if-customizable}