ma-agents 3.14.1 → 3.15.0-beta.1

package/lib/bmad-extension-plugin/skills/sqa-audit/SKILL.md

@@ -172,7 +172,7 @@ After running all selected dimensions, compile a full audit report.
 ```
 # SQA Audit Report
 **Date:** {today's date}
-**Auditor:** Gadi (SQA Agent)
+**Auditor:** Gad (SQA Agent)
 **Scope:** {list of audited dimensions}
 **Overall Status:** PASS | WARNING | FAIL
 
@@ -246,7 +246,7 @@ If yes, generate and save a remediation plan to:
 ```
 # SQA Remediation Plan
 **Date:** {today's date}
-**Auditor:** Gadi (SQA Agent)
+**Auditor:** Gad (SQA Agent)
 **Source Report:** sqa-audit-report-{YYYY-MM-DD}.md
 **Scope:** {audited dimensions}
 

package/lib/bmad-extension-plugin/skills/sqa-ieee12207/SKILL.md

@@ -193,7 +193,7 @@ Evaluate each selected process group. For each process area, assign a compliance
 
 ### Group 4 — Organizational Project-Enabling Processes
 
-Note to Gadi: For Group 4 items, briefly assess based on available evidence only. These are primarily organizational-scope and marked accordingly.
+Note to Gad: For Group 4 items, briefly assess based on available evidence only. These are primarily organizational-scope and marked accordingly.
 
 #### 4.1 Life Cycle Model Management (6.2.1)
 - Is a defined software life cycle model being followed?
@@ -216,7 +216,7 @@ Compile the full compliance report.
 ```
 # IEEE/ISO/IEC 12207:2017 Compliance Report
 **Date:** {today's date}
-**Auditor:** Gadi (SQA Agent)
+**Auditor:** Gad (SQA Agent)
 **Standard:** IEEE/ISO/IEC 12207:2017 — Systems and software engineering — Software life cycle processes
 **Scope:** {selected process groups}
 **Overall Compliance Level:** COMPLIANT | PARTIAL | NON-COMPLIANT
@@ -332,7 +332,7 @@ If yes, generate and save a remediation plan to:
 ```
 # IEEE/ISO/IEC 12207 Remediation Plan
 **Date:** {today's date}
-**Auditor:** Gadi (SQA Agent)
+**Auditor:** Gad (SQA Agent)
 **Source Report:** sqa-ieee12207-report-{YYYY-MM-DD}.md
 **Standard:** IEEE/ISO/IEC 12207:2017
 

package/lib/bmad-extension-plugin/skills/sqa-requirements-quality/SKILL.md

@@ -157,7 +157,7 @@ Compile the full report in this structure:
 ```
 # Requirements Quality Audit Report
 **Date:** {today's date}
-**Auditor:** Gadi (SQA Agent)
+**Auditor:** Gad (SQA Agent)
 **Scope:** {selected document sources}
 **Requirements Audited:** {total count}
 **Overall Quality Score:** {X}/{Y} ({P}%)
@@ -216,7 +216,7 @@ If yes, save a remediation plan to:
 ```
 # Requirements Quality Remediation Plan
 **Date:** {today's date}
-**Auditor:** Gadi (SQA Agent)
+**Auditor:** Gad (SQA Agent)
 **Source Report:** sqa-requirements-quality-report-{YYYY-MM-DD}.md
 
 ---

package/lib/bmad.js

@@ -307,6 +307,21 @@ function ensurePluginStageGitignoredForProject(projectRoot) {
             );
         }
     }
+
+    // Story 29.1 — ensure the Knowledge Atlas site output directory is gitignored.
+    // `_bmad-output/knowledge-site/` is transient (regenerated on each skill run)
+    // and must not be committed. `_bmad-output/` itself remains tracked.
+    if (typeof installer.ensureKnowledgeSiteIgnored === 'function') {
+        try {
+            installer.ensureKnowledgeSiteIgnored(projectRoot);
+        } catch (err) {
+            console.warn(
+                chalk.yellow(
+                    `  Warning: could not update ${path.join(projectRoot, '.gitignore')} with knowledge-site/ entry: ${err.message}`
+                )
+            );
+        }
+    }
 }
 
 /**

package/lib/installer.js

@@ -487,6 +487,93 @@ function ensureBmadDirIgnored(projectRoot) {
   );
 }
 
+// Story 29.1 — Knowledge Atlas site output is generated into
+// `_bmad-output/knowledge-site/` on every skill invocation. This directory is
+// transient (regenerated each run) and should never be committed. It is gitignored
+// by the same append-only, idempotent policy as the plugin stage and _bmad/ tree.
+//
+// IMPORTANT: `_bmad-output/` itself is intentionally kept tracked (project knowledge
+// artifacts live there). Only the nested `knowledge-site/` subdirectory is ignored.
+const KNOWLEDGE_SITE_DIR_NAME = '_bmad-output/knowledge-site';
+const KNOWLEDGE_SITE_PATTERNS = [
+  KNOWLEDGE_SITE_DIR_NAME,                  // _bmad-output/knowledge-site
+  `${KNOWLEDGE_SITE_DIR_NAME}/`,            // _bmad-output/knowledge-site/
+  `/${KNOWLEDGE_SITE_DIR_NAME}`,            // /_bmad-output/knowledge-site
+  `/${KNOWLEDGE_SITE_DIR_NAME}/`,           // /_bmad-output/knowledge-site/
+];
+const KNOWLEDGE_SITE_CANONICAL_ENTRY = `${KNOWLEDGE_SITE_DIR_NAME}/`;
+
+/**
+ * Ensure `_bmad-output/knowledge-site/` is present in the target project's
+ * `.gitignore`. Mirrors the append-only, idempotent, EOL-preserving contract
+ * of `ensurePluginStageIgnored` and `ensureBmadDirIgnored`.
+ *
+ *  - If `.gitignore` is absent, create it with the single canonical entry.
+ *  - If any active (non-comment) line already matches any KNOWLEDGE_SITE_PATTERNS
+ *    variant, do nothing (idempotent).
+ *  - Otherwise, append `KNOWLEDGE_SITE_CANONICAL_ENTRY` preserving the file's
+ *    existing EOL style.
+ *
+ * Non-fatal: EACCES / EROFS are swallowed by the caller in lib/bmad.js so an
+ * unwritable .gitignore never aborts the install. This function throws on other
+ * I/O errors so the caller can decide whether to swallow.
+ *
+ * Defensive: no-op on falsy / non-string projectRoot.
+ *
+ * @param {string} projectRoot - Absolute path to the target project root.
+ */
+function ensureKnowledgeSiteIgnored(projectRoot) {
+  if (typeof projectRoot !== 'string' || projectRoot.length === 0) {
+    return;
+  }
+
+  const gitignorePath = path.join(projectRoot, '.gitignore');
+
+  let content = '';
+  let fileExists = true;
+  try {
+    content = fs.readFileSync(gitignorePath, 'utf-8');
+  } catch (err) {
+    if (err.code !== 'ENOENT') throw err;
+    fileExists = false;
+  }
+
+  if (fileExists) {
+    const alreadyPresent = content.split(/\r?\n/).some(rawLine => {
+      const line = rawLine.trim();
+      if (!line || line.startsWith('#')) return false; // skip blanks & comments
+      // Exact match on any canonical variant.
+      if (KNOWLEDGE_SITE_PATTERNS.includes(line)) return true;
+      // Broader coverage: if a parent entry (`_bmad-output` / `_bmad-output/`,
+      // optionally anchored with a leading slash) is already ignored, then the
+      // nested `knowledge-site/` is implicitly covered — appending our entry
+      // would be redundant. Match the directory form precisely so we never
+      // mistake an unrelated entry like `_bmad-output-archive` for a parent.
+      const normalized = line.replace(/^\//, '').replace(/\/$/, '');
+      if (normalized === '_bmad-output') return true;
+      return false;
+    });
+    if (alreadyPresent) return; // idempotent no-op
+  }
+
+  // Preserve the file's existing line-ending style; default to LF for new files.
+  const usesCrlf = fileExists && /\r\n/.test(content);
+  const eol = usesCrlf ? '\r\n' : '\n';
+
+  let next = content;
+  if (next && !next.endsWith('\n') && !next.endsWith('\r\n')) {
+    next += eol; // ensure the append lands on its own line
+  }
+  next += KNOWLEDGE_SITE_CANONICAL_ENTRY + eol;
+
+  fs.writeFileSync(gitignorePath, next, 'utf-8');
+  console.log(
+    chalk.green(
+      `${KNOWLEDGE_SITE_CANONICAL_ENTRY} added to .gitignore (Knowledge Atlas site output — regenerated on each run)`
+    )
+  );
+}
+
 function ensureManifest(installPath, agentId, scope) {
   let manifest = readManifest(installPath);
   if (!manifest) {
@@ -2260,6 +2347,7 @@ module.exports = {
   ensureBmadOutputTracked,
   ensurePluginStageIgnored,
   ensureBmadDirIgnored,
+  ensureKnowledgeSiteIgnored,
   reconcileAgentsSharedSkills,
   getAgentsSharedSkillAgentIds,
   generateSkillsManifest,