ma-agents 3.12.2 → 3.13.0

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-test-design/steps-c/step-03-risk-and-testability.md

@@ -68,13 +68,27 @@ Using `risk-governance.md` and `probability-impact.md` (if loaded):
 
 ---
 
-## 3. Summarize Risk Findings
+## 3. NFR Planning Assessment
+
+Using `nfr-criteria.md` when loaded:
+
+- Identify NFR categories in scope: security, performance, reliability, scalability, maintainability, compliance, and any project-specific categories
+- Extract measurable thresholds from PRD, architecture, ADRs, epics, or stories
+- Mark missing thresholds as **UNKNOWN** and convert them into clarification items or risks; do not guess values
+- Define planned evidence sources for later validation (tests, scans, metrics, logs, monitoring, CI reports)
+- Convert NFR gaps into the existing risk register using SEC / PERF / OPS / TECH / DATA categories
+
+**Boundary:** This workflow plans NFR validation. It does not assess final PASS/CONCERNS/FAIL from implementation evidence. Use `nfr-assess` after implementation evidence exists.
+
+---
+
+## 4. Summarize Risk Findings
 
 Summarize the highest risks and their mitigation priorities.
 
 ---
 
-### 4. Save Progress
+### 5. Save Progress
 
 **Save this step's accumulated work to `{outputFile}`.**
 

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-test-design/steps-c/step-04-coverage-plan.md

@@ -44,6 +44,7 @@ For each requirement or risk-driven scenario:
 - Select **test level** (E2E / API / Component / Unit) using `test-levels-framework.md`
 - Ensure no duplicate coverage across levels
 - Assign priorities (P0–P3) using `test-priorities-matrix.md`
+- Map NFR-derived risks to planned validation scenarios and evidence sources
 
 **Priority rules:**
 
@@ -54,7 +55,20 @@ For each requirement or risk-driven scenario:
 
 ---
 
-## 2. Execution Strategy (Keep Simple)
+## 2. NFR Coverage and Evidence Plan
+
+For each in-scope NFR category:
+
+- Map the NFR to one or more planned validation scenarios
+- Select the right validation level/tool (for example: API/UI tests for auth and resilience, k6 for load/performance, CI/static analysis for maintainability, monitoring/logs for reliability)
+- Identify the expected evidence artifact that `nfr-assess` should consume later
+- Mark missing thresholds or missing evidence sources as blockers, risks, or assumptions
+
+Keep this concise. Do not include full NFR evidence assessment tables or final PASS/CONCERNS/FAIL decisions in test design.
+
+---
+
+## 3. Execution Strategy (Keep Simple)
 
 Use a **PR / Nightly / Weekly** model:
 
@@ -64,7 +78,7 @@ Use a **PR / Nightly / Weekly** model:
 
 ---
 
-## 3. Resource Estimates (Ranges Only)
+## 4. Resource Estimates (Ranges Only)
 
 Provide intervals (no false precision):
 
@@ -76,7 +90,7 @@ Provide intervals (no false precision):
 
 ---
 
-## 4. Quality Gates
+## 5. Quality Gates
 
 Define thresholds:
 
@@ -84,10 +98,12 @@ Define thresholds:
 - P1 pass rate ≥ 95%
 - High-risk mitigations complete before release
 - Coverage target ≥ 80% (adjust if justified)
+- NFR validation evidence identified for each in-scope NFR category
+- Full NFR PASS/CONCERNS/FAIL status deferred to `nfr-assess` when evidence exists
 
 ---
 
-### 5. Save Progress
+### 6. Save Progress
 
 **Save this step's accumulated work to `{outputFile}`.**
 

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-test-design/steps-c/step-05-generate-output.md

@@ -130,7 +130,9 @@ Epic-level mode remains single-worker by default (one output artifact).
 Ensure the outputs include:
 
 - Risk assessment matrix
+- NFR planning summary (thresholds, missing thresholds, planned evidence, and NFR-derived risks) — when NFRs are in scope
 - Coverage matrix and priorities
+- NFR coverage and planned evidence mapping — when NFRs are in scope
 - Execution strategy
 - Resource estimates (ranges)
 - Quality gate criteria

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-test-design/test-design-architecture-template.md

@@ -121,6 +121,23 @@ inputDocuments: []
 
 ---
 
+### NFR Testability Requirements
+
+**Purpose:** Capture what architecture must provide so NFR validation can be automated later. This is planning guidance, not final evidence assessment.
+
+| NFR Category    | Threshold / Requirement                           | Current Design Support      | Gap / Decision Needed          | Planned Evidence                        |
+| --------------- | ------------------------------------------------- | --------------------------- | ------------------------------ | --------------------------------------- |
+| Security        | {Auth/authz/data protection requirement}          | {Supported/partial/unknown} | {Architecture gap or decision} | {Security tests, scan, audit log}       |
+| Performance     | {Latency/throughput/resource requirement}         | {Supported/partial/unknown} | {Architecture gap or decision} | {k6/APM/load report}                    |
+| Reliability     | {Availability/error-rate/recovery requirement}    | {Supported/partial/unknown} | {Architecture gap or decision} | {Burn-in, monitoring, failover report}  |
+| Maintainability | {Coverage/code quality/observability requirement} | {Supported/partial/unknown} | {Architecture gap or decision} | {Coverage, static analysis, docs audit} |
+
+**Unknown thresholds:** {List any missing NFR thresholds. Unknown thresholds should become risks or clarification items, not guessed values.}
+
+**Assessment boundary:** Final PASS/CONCERNS/FAIL status belongs in `nfr-assess` after implementation evidence exists.
+
+---
+
 ### Testability Concerns and Architectural Gaps
 
 **🚨 ACTIONABLE CONCERNS - Architecture Team Must Address**

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-test-design/test-design-qa-template.md

@@ -123,6 +123,21 @@ test('example test @p0', async ({ apiRequest }) => {
 
 ---
 
+## NFR Test Coverage Plan
+
+**Purpose:** Map NFR requirements to planned validation work. This section defines what evidence QA should create or collect; it does not assign final PASS/CONCERNS/FAIL status.
+
+| NFR Category    | Requirement / Threshold | Planned Validation                         | Tool / Level         | Evidence Artifact             | Priority |
+| --------------- | ----------------------- | ------------------------------------------ | -------------------- | ----------------------------- | -------- |
+| Security        | {Requirement}           | {Auth/authz/security validation}           | {API/E2E/SAST/DAST}  | {Report or test result path}  | {P0-P3}  |
+| Performance     | {Requirement}           | {Load/stress/baseline validation}          | {k6/APM/Lighthouse}  | {Report or dashboard}         | {P0-P3}  |
+| Reliability     | {Requirement}           | {Error/retry/failover validation}          | {API/E2E/monitoring} | {Burn-in/log/metric evidence} | {P0-P3}  |
+| Maintainability | {Requirement}           | {Coverage/static analysis/docs validation} | {CI/static analysis} | {Coverage or quality report}  | {P0-P3}  |
+
+**Missing thresholds or evidence sources:** {List NFRs that need stakeholder clarification or tooling before `nfr-assess`.}
+
+---
+
 ## Entry Criteria
 
 **QA testing cannot begin until ALL of the following are met:**

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-test-design/test-design-template.md

@@ -76,6 +76,21 @@ lastSaved: ''
 
 ---
 
+## NFR Planning
+
+**Purpose:** Capture epic-specific NFR thresholds, planned validation, and evidence expected for later `nfr-assess`. This is not a final evidence audit.
+
+| NFR Category    | Requirement / Threshold | Risk Link | Planned Validation                         | Evidence Needed                  |
+| --------------- | ----------------------- | --------- | ------------------------------------------ | -------------------------------- |
+| Security        | {Requirement}           | {R-ID}    | {API/E2E/SAST/DAST validation}             | {Test report, scan, audit log}   |
+| Performance     | {Requirement}           | {R-ID}    | {Load/stress/baseline validation}          | {k6/APM/Lighthouse report}       |
+| Reliability     | {Requirement}           | {R-ID}    | {Error/retry/failover validation}          | {Burn-in, logs, monitoring data} |
+| Maintainability | {Requirement}           | {R-ID}    | {Coverage/static analysis/docs validation} | {Coverage or quality report}     |
+
+**Unknown thresholds:** {List missing NFR thresholds or mark N/A. Do not invent values.}
+
+---
+
 ## Entry Criteria
 
 - [ ] Requirements and assumptions agreed upon by QA, Dev, PM
@@ -247,6 +262,7 @@ lastSaved: ''
 - [ ] No high-risk (≥6) items unmitigated
 - [ ] Security tests (SEC category) pass 100%
 - [ ] Performance targets met (PERF category)
+- [ ] Planned NFR evidence exists or `nfr-assess` has documented CONCERNS/waivers
 
 ---
 

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-test-review/resources/tea-index.csv

@@ -39,7 +39,7 @@ pactjs-utils-request-filter,Pact.js Utils Request Filter,"createRequestFilter, n
 pact-mcp,Pact MCP Server,"SmartBear MCP for PactFlow: generate tests, review, can-i-deploy, provider states","pact,mcp,pactflow,contract-testing,broker",specialized,knowledge/pact-mcp.md
 pact-consumer-framework-setup,Pact Consumer CDC Framework Setup,"Directory structure, vitest config with fileParallelism:false + pool:forks + singleFork:true (FFI safety), determinism gate (check-pact-determinism.sh), jq-normalized publishing, 1:1 local/CI parity, PactV4 patterns","pactjs-utils,consumer,contract-testing,pact,ci,framework,setup,vitest,shell-scripts,determinism,jq,pactv4,ffi",specialized,knowledge/pact-consumer-framework-setup.md
 pact-broker-webhooks,Pact Broker Webhooks,"PactFlow → GitHub repository_dispatch auth via dedicated machine user + classic PAT (repo scope, no expiration) + PactFlow secret; staleness monitoring and PAT rotation runbook","pact,pactflow,broker,webhooks,github,auth,pat,ci,operations,security",specialized,knowledge/pact-broker-webhooks.md
-adr-quality-readiness-checklist,ADR Quality Readiness Checklist,"8-category 29-criteria framework for ADR testability and NFR assessment","nfr,testability,adr,quality,assessment,checklist",extended,knowledge/adr-quality-readiness-checklist.md
+adr-quality-readiness-checklist,ADR Quality Readiness Checklist,"8-category 29-criteria framework for ADR testability and NFR evidence audit","nfr,testability,adr,quality,assessment,checklist",extended,knowledge/adr-quality-readiness-checklist.md
 playwright-cli,Playwright CLI,"Token-efficient CLI for AI coding agents: element refs, sessions, snapshots, trace analysis, debug=cli autonomous investigation","cli,browser,agent,automation,snapshot,trace,debug",core,knowledge/playwright-cli.md
 pact-consumer-di,Pact Consumer DI Pattern,"Dependency injection pattern for Pact consumer tests — call actual source code instead of raw fetch by injecting mock server URL via optional baseUrl in context type","contract-testing,pact,consumer,dependency-injection,api,backend,architecture",extended,knowledge/pact-consumer-di.md
 webhook-fundamentals,Webhook Testing Fundamentals,"Why webhook delivery is hard: async, parallel pollution, opaque timeouts, cleanup drift. playwright-utils approach with polling, typed matchers, rich errors, startedAt isolation","webhook,async,playwright-utils,event-driven,eventually-consistent",core,knowledge/webhook-testing-fundamentals.md

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-trace/checklist.md

@@ -252,7 +252,7 @@ Knowledge fragments referenced:
 - [ ] Story/epic/release file identified and read
 - [ ] Test design document discovered or explicitly provided (if available)
 - [ ] Traceability matrix discovered or explicitly provided (available from Phase 1)
-- [ ] NFR assessment discovered or explicitly provided (if available)
+- [ ] NFR evidence audit discovered or explicitly provided (if available)
 - [ ] Code coverage report discovered or explicitly provided (if available)
 - [ ] Burn-in results discovered or explicitly provided (if available)
 

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-trace/resources/tea-index.csv

@@ -39,7 +39,7 @@ pactjs-utils-request-filter,Pact.js Utils Request Filter,"createRequestFilter, n
 pact-mcp,Pact MCP Server,"SmartBear MCP for PactFlow: generate tests, review, can-i-deploy, provider states","pact,mcp,pactflow,contract-testing,broker",specialized,knowledge/pact-mcp.md
 pact-consumer-framework-setup,Pact Consumer CDC Framework Setup,"Directory structure, vitest config with fileParallelism:false + pool:forks + singleFork:true (FFI safety), determinism gate (check-pact-determinism.sh), jq-normalized publishing, 1:1 local/CI parity, PactV4 patterns","pactjs-utils,consumer,contract-testing,pact,ci,framework,setup,vitest,shell-scripts,determinism,jq,pactv4,ffi",specialized,knowledge/pact-consumer-framework-setup.md
 pact-broker-webhooks,Pact Broker Webhooks,"PactFlow → GitHub repository_dispatch auth via dedicated machine user + classic PAT (repo scope, no expiration) + PactFlow secret; staleness monitoring and PAT rotation runbook","pact,pactflow,broker,webhooks,github,auth,pat,ci,operations,security",specialized,knowledge/pact-broker-webhooks.md
-adr-quality-readiness-checklist,ADR Quality Readiness Checklist,"8-category 29-criteria framework for ADR testability and NFR assessment","nfr,testability,adr,quality,assessment,checklist",extended,knowledge/adr-quality-readiness-checklist.md
+adr-quality-readiness-checklist,ADR Quality Readiness Checklist,"8-category 29-criteria framework for ADR testability and NFR evidence audit","nfr,testability,adr,quality,assessment,checklist",extended,knowledge/adr-quality-readiness-checklist.md
 playwright-cli,Playwright CLI,"Token-efficient CLI for AI coding agents: element refs, sessions, snapshots, trace analysis, debug=cli autonomous investigation","cli,browser,agent,automation,snapshot,trace,debug",core,knowledge/playwright-cli.md
 pact-consumer-di,Pact Consumer DI Pattern,"Dependency injection pattern for Pact consumer tests — call actual source code instead of raw fetch by injecting mock server URL via optional baseUrl in context type","contract-testing,pact,consumer,dependency-injection,api,backend,architecture",extended,knowledge/pact-consumer-di.md
 webhook-fundamentals,Webhook Testing Fundamentals,"Why webhook delivery is hard: async, parallel pollution, opaque timeouts, cleanup drift. playwright-utils approach with polling, typed matchers, rich errors, startedAt isolation","webhook,async,playwright-utils,event-driven,eventually-consistent",core,knowledge/webhook-testing-fundamentals.md

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-testarch-trace/trace-template.md

@@ -678,7 +678,7 @@ traceability_and_gate:
 - **Test Design:** {TEST_DESIGN_PATH} (if available)
 - **Tech Spec:** {TECH_SPEC_PATH} (if available)
 - **Test Results:** {TEST_RESULTS_PATH}
-- **NFR Assessment:** {NFR_FILE_PATH} (if available)
+- **NFR Evidence Audit:** {NFR_FILE_PATH} (if available)
 - **Test Files:** {TEST_DIR_PATH}
 
 ---

package/lib/bmad-cache/tea/test/test-installation-components.js

@@ -12,6 +12,7 @@
 
 const path = require('node:path');
 const fs = require('node:fs/promises');
+const { parse } = require('csv-parse/sync');
 const yaml = require('js-yaml');
 
 async function pathExists(filePath) {
@@ -23,6 +24,11 @@ async function pathExists(filePath) {
   }
 }
 
+function extractFrontmatter(content) {
+  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/);
+  return match ? match[1] : '';
+}
+
 // ANSI colors
 const colors = {
   reset: '\u001B[0m',
@@ -253,10 +259,12 @@ async function runTests() {
   ];
 
   for (const dirName of workflowDirs) {
+    const workflowDir = path.join(projectRoot, `src/workflows/testarch/${dirName}`);
     const skillMdPath = path.join(projectRoot, `src/workflows/testarch/${dirName}/SKILL.md`);
     const customizeTomlPath = path.join(projectRoot, `src/workflows/testarch/${dirName}/customize.toml`);
     const workflowYamlPath = path.join(projectRoot, `src/workflows/testarch/${dirName}/workflow.yaml`);
     const instructionsMdPath = path.join(projectRoot, `src/workflows/testarch/${dirName}/instructions.md`);
+    let workflowKnowledgeIndexValidated = false;
 
     if (await pathExists(skillMdPath)) {
       try {
@@ -344,6 +352,7 @@ async function runTests() {
         const stepPath = path.join(stepDirPath, fileName);
         try {
           const stepContent = await fs.readFile(stepPath, 'utf8');
+          const frontmatter = extractFrontmatter(stepContent);
           const stepLabel = `${dirName}/${stepDir}/${fileName}`;
 
           assert(!stepContent.includes("nextStepFile: './"), `${stepLabel} has no cwd-sensitive nextStepFile`);
@@ -371,6 +380,46 @@ async function runTests() {
           if (stepContent.includes('workflowPath:')) {
             assert(stepContent.includes("workflowPath: '{skill-root}'"), `${stepLabel} anchors workflowPath to {skill-root}`);
           }
+
+          if (frontmatter.includes('knowledgeIndex:')) {
+            const knowledgeIndexMatch = frontmatter.match(/^knowledgeIndex:\s*['"]([^'"]+)['"]/m);
+            assert(Boolean(knowledgeIndexMatch), `${stepLabel} declares a parseable knowledgeIndex`);
+
+            const knowledgeIndexReference = knowledgeIndexMatch ? knowledgeIndexMatch[1] : '';
+            const knowledgeIndexPath = path.resolve(workflowDir, knowledgeIndexReference);
+            const expectedKnowledgeIndexPath = path.join(workflowDir, 'resources', 'tea-index.csv');
+
+            assert(knowledgeIndexPath === expectedKnowledgeIndexPath, `${stepLabel} uses the workflow-local knowledge index`);
+            assert(await pathExists(knowledgeIndexPath), `${stepLabel} knowledgeIndex target exists`);
+
+            if (!workflowKnowledgeIndexValidated && (await pathExists(knowledgeIndexPath))) {
+              const records = parse(await fs.readFile(knowledgeIndexPath, 'utf8'), { columns: true, skip_empty_lines: true });
+              const workflowKnowledgeDir = path.join(path.dirname(knowledgeIndexPath), 'knowledge');
+              const workflowKnowledgeFiles = (await fs.readdir(workflowKnowledgeDir)).filter((name) => name.endsWith('.md'));
+              const missingFragments = [];
+
+              for (const record of records) {
+                if (!record.fragment_file) {
+                  missingFragments.push(`${record.id || '<missing-id>'}: missing fragment_file`);
+                  continue;
+                }
+
+                const fragmentPath = path.resolve(path.dirname(knowledgeIndexPath), record.fragment_file);
+                if (!(await pathExists(fragmentPath))) {
+                  missingFragments.push(record.fragment_file);
+                }
+              }
+
+              assert(
+                records.length === workflowKnowledgeFiles.length,
+                `${dirName}/resources/tea-index.csv line count matches workflow-local fragments`,
+                `Found ${records.length} records for ${workflowKnowledgeFiles.length} fragments`,
+              );
+              assert(missingFragments.length === 0, `${dirName}/resources/tea-index.csv fragment files exist`, missingFragments.join(', '));
+
+              workflowKnowledgeIndexValidated = true;
+            }
+          }
         } catch (error) {
           assert(false, `${dirName}/${stepDir}/${fileName} validates`, error.message);
         }

package/lib/bmad-cache/tea/website/astro.config.mjs

@@ -100,14 +100,14 @@ export default defineConfig({
               label: 'Workflows',
               items: [
                 { label: 'Teach Me Testing', slug: 'how-to/workflows/teach-me-testing' },
+                { label: 'Test Design', slug: 'how-to/workflows/run-test-design' },
                 { label: 'Set Up Test Framework', slug: 'how-to/workflows/setup-test-framework' },
                 { label: 'Set Up CI Pipeline', slug: 'how-to/workflows/setup-ci' },
-                { label: 'Test Design', slug: 'how-to/workflows/run-test-design' },
                 { label: 'ATDD', slug: 'how-to/workflows/run-atdd' },
                 { label: 'Automate', slug: 'how-to/workflows/run-automate' },
                 { label: 'Test Review', slug: 'how-to/workflows/run-test-review' },
+                { label: 'NFR Evidence Audit', slug: 'how-to/workflows/run-nfr-assess' },
                 { label: 'Trace', slug: 'how-to/workflows/run-trace' },
-                { label: 'NFR Assessment', slug: 'how-to/workflows/run-nfr-assess' },
               ],
             },
             {

package/lib/bmad-cache/wds/README.md

@@ -128,7 +128,7 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
 ## Support BMad
 
-BMad is free for everyone and always will be. Star this repo, [buy me a coffee](https://buymeacoffee.com/bmad), or email contact@bmadcode.com for corporate sponsorship.
+BMad is free for everyone and always will be. Star this repo, [buy me a coffee](https://buymeacoffee.com/bmad), or email <contact@bmadcode.com> for corporate sponsorship.
 
 ## License
 

package/lib/bmad-cache/wds/_git_preserved/hooks/commit-msg.sample

@@ -15,10 +15,60 @@
 # SOB=$(git var GIT_AUTHOR_IDENT | sed -n 's/^\(.*>\).*$/Signed-off-by: \1/p')
 # grep -qs "^$SOB" "$1" || echo "$SOB" >> "$1"
 
-# This example catches duplicate Signed-off-by lines.
+# This example catches duplicate Signed-off-by lines and messages that
+# would confuse 'git am'.
+
+ret=0
 
 test "" = "$(grep '^Signed-off-by: ' "$1" |
 	 sort | uniq -c | sed -e '/^[ 	]*1[ 	]/d')" || {
 	echo >&2 Duplicate Signed-off-by lines.
-	exit 1
+	ret=1
 }
+
+comment_re="$(
+	{
+		git config --get-regexp "^core\.comment(char|string)\$" ||
+			echo '#'
+	} | sed -n -e '
+		${
+			s/^[^ ]* //
+			s|[][*./\]|\\&|g
+			s/^auto$/[#;@!$%^&|:]/
+			p
+		}'
+)"
+scissors_line="^${comment_re} -\{8,\} >8 -\{8,\}\$"
+comment_line="^${comment_re}.*"
+blank_line='^[ 	]*$'
+# Disallow lines starting with "diff -" or "Index: " in the body of the
+# message. Stop looking if we see a scissors line.
+line="$(sed -n -e "
+	# Skip comments and blank lines at the start of the file.
+	/${scissors_line}/q
+	/${comment_line}/d
+	/${blank_line}/d
+	# The first paragraph will become the subject header so
+	# does not need to be checked.
+	: subject
+	n
+	/${scissors_line}/q
+	/${blank_line}/!b subject
+	# Check the body of the message for problematic
+	# prefixes.
+	: body
+	n
+	/${scissors_line}/q
+	/${comment_line}/b body
+	/^diff -/{p;q;}
+	/^Index: /{p;q;}
+	b body
+	" "$1")"
+if test -n "$line"
+then
+	echo >&2 "Message contains a diff that will confuse 'git am'."
+	echo >&2 "To fix this indent the diff."
+	ret=1
+fi
+
+exit $ret

package/lib/bmad-cache/wds/_git_preserved/hooks/fsmonitor-watchman.sample

@@ -29,8 +29,6 @@ if ($version ne 2) {
 
 my $git_work_tree = get_working_dir();
 
-my $retry = 1;
-
 my $json_pkg;
 eval {
 	require JSON::XS;
@@ -123,8 +121,7 @@ sub watchman_query {
 sub is_work_tree_watched {
 	my ($output) = @_;
 	my $error = $output->{error};
-	if ($retry > 0 and $error and $error =~ m/unable to resolve root .* directory (.*) is not watched/) {
-		$retry--;
+	if ($error and $error =~ m/unable to resolve root .* directory (.*) is not watched/) {
 		my $response = qx/watchman watch "$git_work_tree"/;
 		die "Failed to make watchman watch '$git_work_tree'.\n" .
 		    "Falling back to scanning...\n" if $? != 0;
@@ -142,15 +139,12 @@ sub is_work_tree_watched {
 		# Watchman query just to get it over with now so we won't pay
 		# the cost in git to look up each individual file.
 		my $o = watchman_clock();
-		$error = $output->{error};
+		$error = $o->{error};
 
 		die "Watchman: $error.\n" .
 		"Falling back to scanning...\n" if $error;
 
 		output_result($o->{clock}, ("/"));
-		$last_update_token = $o->{clock};
-
-		eval { launch_watchman() };
 		return 0;
 	}
 

package/lib/bmad-cache/wds/_git_preserved/packed-refs

@@ -1,2 +1,2 @@
 # pack-refs with: peeled fully-peeled sorted 
-430c824ffe3845b2211d7a36707c66abe1b20b8c refs/remotes/origin/main
+cc16f09fcfab26d35635af1491f36a38a8431c8d refs/remotes/origin/main

package/lib/bmad-cache/wds/_git_preserved/refs/heads/main

@@ -1 +1 @@
-430c824ffe3845b2211d7a36707c66abe1b20b8c
+cc16f09fcfab26d35635af1491f36a38a8431c8d

package/lib/bmad-cache/wds/_git_preserved/refs/tags/v0.4.3

@@ -0,0 +1 @@
+8ad7e713507b4acebaac632afddec6bbb909a74e

package/lib/bmad-cache/wds/_git_preserved/shallow

@@ -1 +1 @@
-430c824ffe3845b2211d7a36707c66abe1b20b8c
+cc16f09fcfab26d35635af1491f36a38a8431c8d

package/lib/bmad-cache/wds/eslint.config.mjs

@@ -83,7 +83,7 @@ export default [
 
   // CLI scripts under tools/** and test/**
   {
-    files: ['tools/**/*.js', 'tools/**/*.mjs', 'test/**/*.js'],
+    files: ['tools/**/*.js', 'tools/**/*.mjs', 'test/**/*.js', 'src/scripts/**/*.js'],
     rules: {
       // Allow CommonJS patterns for Node CLI scripts
       'unicorn/prefer-module': 'off',

package/lib/bmad-cache/wds/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "bmad-wds",
-  "version": "0.3.1",
+  "version": "0.4.3",
   "private": true,
   "description": "Whiteport Design Studio - BMAD expansion module for strategic design methodology",
   "keywords": [

package/lib/bmad-cache/wds/src/agents/wds-agent-freya-ux/customize.toml

@@ -0,0 +1,80 @@
+# DO NOT EDIT -- overwritten on every update.
+#
+# Freya, the WDS Designer, is the hardcoded identity of this agent.
+# Customize the persona and menu below to shape behavior without
+# changing who the agent is.
+
+[agent]
+# non-configurable skill frontmatter, create a custom agent if you need a new name/title
+name = "Freya"
+title = "WDS Designer"
+
+# --- Configurable below. Overrides merge per BMad structural rules: ---
+#   scalars: override wins • arrays (persistent_facts, principles, activation_steps_*): append
+#   arrays-of-tables with `code`/`id`: replace matching items, append new ones.
+
+icon = "🎨"
+
+activation_steps_prepend = []
+activation_steps_append = []
+
+persistent_facts = [
+  "file:{project-root}/**/project-context.md",
+]
+
+role = "Strategic UX Designer + Design Thinking Partner"
+identity = "Freya, Norse goddess of beauty, magic, and strategy. Thinks WITH you, not FOR you. Starts with WHY before HOW — design without strategy is decoration. Creates artifacts developers can trust: detailed specs, prototypes, and design systems. Core beliefs: Strategy then Design then Specification. Psychology drives design. Content is strategy — every word triggers user psychology."
+communication_style = "Creative collaborator who brings strategic depth. Asks 'WHY?' before 'WHAT?' — connecting design choices to business goals and user psychology. Explores one challenge deeply rather than skimming many. Keeps responses focused and actionable — leads with decisions, follows with rationale. Suggests workshops when strategic thinking is needed."
+
+principles = [
+  "Domain: Phases 3 (UX Scenarios), 4 (UX Design), 5 (Agentic Development), 6 (Asset Generation), 7 (Design System - optional), 8 (Product Evolution). Hand over other domains to specialist agents.",
+  "Replaces BMM Sally (UX Designer) when WDS is installed.",
+  "Load strategic context BEFORE designing — always connect to Trigger Map.",
+  "Specifications must be logical and complete — if you can't explain it, it's not ready.",
+  "Prototypes validate before production — show, don't tell.",
+  "Design systems grow organically from actual usage, not upfront planning.",
+  "AI-assisted design via Stitch when spec + sketch ready; Figma integration for visual refinement.",
+  "Load micro-guides when entering workflows: strategic-design.md, specification-quality.md, agentic-development.md, content-creation.md, design-system.md",
+  "HARM: Producing output that looks complete but doesn't follow the template. The user must then correct what should have been right — wasting time, money, and trust. Plausible-looking wrong output is worse than no output. Custom formats break the pipeline for every phase downstream.",
+  "HELP: Reading the actual template into context before writing. Discussing decisions with the user. Delivering artifacts that the next phase can consume without auditing. The user's time goes to decisions, not corrections.",
+]
+
+[[agent.menu]]
+code = "SC"
+description = "Scenarios: Outline user flows and journeys (Phase 3)"
+skill = "bmad-wds-outline-scenarios"
+
+[[agent.menu]]
+code = "UX"
+description = "UX Design: Create pages and storyboards (Phase 4)"
+skill = "bmad-wds-conceptual-sketching"
+
+[[agent.menu]]
+code = "SP"
+description = "Specifications: Write content, interaction and functionality specs (Phase 4)"
+skill = "bmad-wds-conceptual-specs"
+
+[[agent.menu]]
+code = "SA"
+description = "Audit: Check spec completeness and quality (Phase 4)"
+skill = "bmad-wds-spec-audit"
+
+[[agent.menu]]
+code = "GA"
+description = "Generate Assets: Nano Banana, Stitch and other services (Phase 6)"
+skill = "bmad-wds-visual-design"
+
+[[agent.menu]]
+code = "DS"
+description = "Design System: Build component library with design tokens (Phase 7)"
+skill = "bmad-wds-design-system"
+
+[[agent.menu]]
+code = "DD"
+description = "Design Delivery: Package flows for development handoff (Phase 5)"
+skill = "bmad-wds-design-delivery"
+
+[[agent.menu]]
+code = "PE"
+description = "Product Evolution: Continuous improvement for living products (Phase 8)"
+skill = "bmad-wds-product-evolution"

package/lib/bmad-cache/wds/src/agents/wds-agent-mimir-builder/customize.toml

@@ -0,0 +1,52 @@
+# DO NOT EDIT -- overwritten on every update.
+#
+# Mimir, the WDS Builder, is the hardcoded identity of this agent.
+# Customize the persona and menu below to shape behavior without
+# changing who the agent is.
+
+[agent]
+# non-configurable skill frontmatter, create a custom agent if you need a new name/title
+name = "Mimir"
+title = "WDS Builder"
+
+# --- Configurable below. Overrides merge per BMad structural rules: ---
+#   scalars: override wins • arrays (persistent_facts, principles, activation_steps_*): append
+#   arrays-of-tables with `code`/`id`: replace matching items, append new ones.
+
+icon = "🔨"
+
+activation_steps_prepend = []
+activation_steps_append = []
+
+persistent_facts = [
+  "file:{project-root}/**/project-context.md",
+]
+
+role = "Implementation Agent + Technical Build Partner"
+identity = "Mimir, god of wisdom and deep knowledge — the well beneath the world tree. Methodical, precise, empirical. Not creative — rigorous. Creativity happened upstream. Reads the spec completely before writing a line of code. Plans before acting. Verifies before moving on. Does not embellish."
+communication_style = "Technical and precise. Confirms understanding of requirements before starting. Reports progress in discrete verified steps. Flags ambiguity immediately rather than guessing. Asks one clarifying question at a time."
+
+principles = [
+  "Domain: Phase 5 (Agentic Development). Receives Work Orders from Freya, produces working code.",
+  "Read the full spec before writing a single line of code — no shortcuts.",
+  "One requirement at a time. Implement, commit, verify. Never batch unverified changes.",
+  "The PRD is the contract. If reality diverges from PRD, stop and surface it.",
+  "Browser test every UI change — a sub-agent confirms the requirement passes visually.",
+  "HARM: Writing code without reading the spec. Batching changes without verification. Assuming what the user meant.",
+  "HELP: Starting from the Work Order, writing the PRD, implementing one requirement at a time with verification.",
+]
+
+[[agent.menu]]
+code = "TA"
+description = "Tech Audit: Read codebase and produce living architecture document (first-time entry)"
+skill = "bmad-wds-tech-audit"
+
+[[agent.menu]]
+code = "PR"
+description = "PRD: Write Product Requirements Document from a Freya Work Order"
+skill = "bmad-wds-prd"
+
+[[agent.menu]]
+code = "BU"
+description = "Build: Implement requirements from PRD — one verified task at a time"
+skill = "bmad-wds-build"