digital-ai-testing-mcp 1.2.7 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (231) hide show
  1. package/README.md +161 -56
  2. package/dist/api/access-level.d.ts +46 -0
  3. package/dist/api/access-level.d.ts.map +1 -0
  4. package/dist/api/access-level.js +183 -0
  5. package/dist/api/access-level.js.map +1 -0
  6. package/dist/api/agents.js +1 -1
  7. package/dist/api/agents.js.map +1 -1
  8. package/dist/api/browser-inspection.d.ts.map +1 -1
  9. package/dist/api/browser-inspection.js +18 -17
  10. package/dist/api/browser-inspection.js.map +1 -1
  11. package/dist/api/client.d.ts +14 -2
  12. package/dist/api/client.d.ts.map +1 -1
  13. package/dist/api/client.js +60 -43
  14. package/dist/api/client.js.map +1 -1
  15. package/dist/api/device-groups.js +1 -1
  16. package/dist/api/device-groups.js.map +1 -1
  17. package/dist/api/license.js +1 -1
  18. package/dist/api/license.js.map +1 -1
  19. package/dist/api/nv-servers.js +1 -1
  20. package/dist/api/nv-servers.js.map +1 -1
  21. package/dist/api/projects.d.ts +16 -3
  22. package/dist/api/projects.d.ts.map +1 -1
  23. package/dist/api/projects.js +60 -18
  24. package/dist/api/projects.js.map +1 -1
  25. package/dist/api/regions.js +1 -1
  26. package/dist/api/regions.js.map +1 -1
  27. package/dist/api/reporter-projects.d.ts.map +1 -1
  28. package/dist/api/reporter-projects.js +2 -1
  29. package/dist/api/reporter-projects.js.map +1 -1
  30. package/dist/api/reporting.d.ts +91 -0
  31. package/dist/api/reporting.d.ts.map +1 -1
  32. package/dist/api/reporting.js +220 -22
  33. package/dist/api/reporting.js.map +1 -1
  34. package/dist/api/sessions.js +1 -1
  35. package/dist/api/sessions.js.map +1 -1
  36. package/dist/api/test-orchestrator.d.ts +59 -0
  37. package/dist/api/test-orchestrator.d.ts.map +1 -0
  38. package/dist/api/test-orchestrator.js +126 -0
  39. package/dist/api/test-orchestrator.js.map +1 -0
  40. package/dist/api/test-runs.d.ts +80 -0
  41. package/dist/api/test-runs.d.ts.map +1 -0
  42. package/dist/api/test-runs.js +209 -0
  43. package/dist/api/test-runs.js.map +1 -0
  44. package/dist/api/test-views.d.ts.map +1 -1
  45. package/dist/api/test-views.js +5 -1
  46. package/dist/api/test-views.js.map +1 -1
  47. package/dist/api/transactions.d.ts +6 -0
  48. package/dist/api/transactions.d.ts.map +1 -1
  49. package/dist/api/transactions.js +19 -3
  50. package/dist/api/transactions.js.map +1 -1
  51. package/dist/api/usage-reports.d.ts.map +1 -1
  52. package/dist/api/usage-reports.js +3 -3
  53. package/dist/api/usage-reports.js.map +1 -1
  54. package/dist/api/webdriver.d.ts +39 -1
  55. package/dist/api/webdriver.d.ts.map +1 -1
  56. package/dist/api/webdriver.js +177 -71
  57. package/dist/api/webdriver.js.map +1 -1
  58. package/dist/index.js +82 -33
  59. package/dist/index.js.map +1 -1
  60. package/dist/tools/agent-tools.js +2 -2
  61. package/dist/tools/agent-tools.js.map +1 -1
  62. package/dist/tools/application-tools.d.ts.map +1 -1
  63. package/dist/tools/application-tools.js +17 -10
  64. package/dist/tools/application-tools.js.map +1 -1
  65. package/dist/tools/boilerplate-tools.d.ts +3 -0
  66. package/dist/tools/boilerplate-tools.d.ts.map +1 -1
  67. package/dist/tools/boilerplate-tools.js +302 -21
  68. package/dist/tools/boilerplate-tools.js.map +1 -1
  69. package/dist/tools/browser-tools.d.ts.map +1 -1
  70. package/dist/tools/browser-tools.js +8 -5
  71. package/dist/tools/browser-tools.js.map +1 -1
  72. package/dist/tools/debug-tools.d.ts.map +1 -1
  73. package/dist/tools/debug-tools.js +6 -3
  74. package/dist/tools/debug-tools.js.map +1 -1
  75. package/dist/tools/device-group-tools.js +5 -5
  76. package/dist/tools/device-group-tools.js.map +1 -1
  77. package/dist/tools/device-tools.d.ts.map +1 -1
  78. package/dist/tools/device-tools.js +5 -4
  79. package/dist/tools/device-tools.js.map +1 -1
  80. package/dist/tools/health-tools.d.ts.map +1 -1
  81. package/dist/tools/health-tools.js +6 -5
  82. package/dist/tools/health-tools.js.map +1 -1
  83. package/dist/tools/inspection-tools.d.ts.map +1 -1
  84. package/dist/tools/inspection-tools.js +122 -22
  85. package/dist/tools/inspection-tools.js.map +1 -1
  86. package/dist/tools/meta-tools.d.ts +4 -1
  87. package/dist/tools/meta-tools.d.ts.map +1 -1
  88. package/dist/tools/meta-tools.js +87 -58
  89. package/dist/tools/meta-tools.js.map +1 -1
  90. package/dist/tools/performance-tools.d.ts.map +1 -1
  91. package/dist/tools/performance-tools.js +2 -8
  92. package/dist/tools/performance-tools.js.map +1 -1
  93. package/dist/tools/project-tools.d.ts.map +1 -1
  94. package/dist/tools/project-tools.js +38 -19
  95. package/dist/tools/project-tools.js.map +1 -1
  96. package/dist/tools/provisioning-profile-tools.d.ts.map +1 -1
  97. package/dist/tools/provisioning-profile-tools.js +5 -4
  98. package/dist/tools/provisioning-profile-tools.js.map +1 -1
  99. package/dist/tools/remediation-tools.d.ts +7 -0
  100. package/dist/tools/remediation-tools.d.ts.map +1 -0
  101. package/dist/tools/remediation-tools.js +50 -0
  102. package/dist/tools/remediation-tools.js.map +1 -0
  103. package/dist/tools/reporting-tools.d.ts.map +1 -1
  104. package/dist/tools/reporting-tools.js +393 -147
  105. package/dist/tools/reporting-tools.js.map +1 -1
  106. package/dist/tools/repository-tools.d.ts.map +1 -1
  107. package/dist/tools/repository-tools.js +5 -4
  108. package/dist/tools/repository-tools.js.map +1 -1
  109. package/dist/tools/reservation-tools.js +2 -2
  110. package/dist/tools/reservation-tools.js.map +1 -1
  111. package/dist/tools/resources.js +2 -2
  112. package/dist/tools/resources.js.map +1 -1
  113. package/dist/tools/test-run-tools.d.ts +3 -0
  114. package/dist/tools/test-run-tools.d.ts.map +1 -0
  115. package/dist/tools/test-run-tools.js +284 -0
  116. package/dist/tools/test-run-tools.js.map +1 -0
  117. package/dist/tools/test-view-tools.d.ts.map +1 -1
  118. package/dist/tools/test-view-tools.js +11 -11
  119. package/dist/tools/test-view-tools.js.map +1 -1
  120. package/dist/tools/toolset-tools.d.ts +8 -0
  121. package/dist/tools/toolset-tools.d.ts.map +1 -0
  122. package/dist/tools/toolset-tools.js +40 -0
  123. package/dist/tools/toolset-tools.js.map +1 -0
  124. package/dist/tools/transaction-tools.d.ts.map +1 -1
  125. package/dist/tools/transaction-tools.js +17 -7
  126. package/dist/tools/transaction-tools.js.map +1 -1
  127. package/dist/tools/usage-report-tools.d.ts.map +1 -1
  128. package/dist/tools/usage-report-tools.js +43 -15
  129. package/dist/tools/usage-report-tools.js.map +1 -1
  130. package/dist/tools/user-tools.js +2 -2
  131. package/dist/tools/user-tools.js.map +1 -1
  132. package/dist/tools/web-inspection-tools.d.ts.map +1 -1
  133. package/dist/tools/web-inspection-tools.js +45 -33
  134. package/dist/tools/web-inspection-tools.js.map +1 -1
  135. package/dist/tools/workflow-tools.js +1 -1
  136. package/dist/types/digital-ai.d.ts +19 -1
  137. package/dist/types/digital-ai.d.ts.map +1 -1
  138. package/dist/utils/access-level.d.ts +39 -0
  139. package/dist/utils/access-level.d.ts.map +1 -0
  140. package/dist/utils/access-level.js +111 -0
  141. package/dist/utils/access-level.js.map +1 -0
  142. package/dist/utils/browser-name.d.ts +2 -0
  143. package/dist/utils/browser-name.d.ts.map +1 -0
  144. package/dist/utils/browser-name.js +19 -0
  145. package/dist/utils/browser-name.js.map +1 -0
  146. package/dist/utils/command-payload.d.ts +19 -0
  147. package/dist/utils/command-payload.d.ts.map +1 -0
  148. package/dist/utils/command-payload.js +13 -0
  149. package/dist/utils/command-payload.js.map +1 -0
  150. package/dist/utils/csv.d.ts +6 -0
  151. package/dist/utils/csv.d.ts.map +1 -1
  152. package/dist/utils/csv.js +28 -2
  153. package/dist/utils/csv.js.map +1 -1
  154. package/dist/utils/download-command.d.ts.map +1 -1
  155. package/dist/utils/download-command.js +5 -4
  156. package/dist/utils/download-command.js.map +1 -1
  157. package/dist/utils/locality.d.ts +7 -0
  158. package/dist/utils/locality.d.ts.map +1 -1
  159. package/dist/utils/locality.js +19 -0
  160. package/dist/utils/locality.js.map +1 -1
  161. package/dist/utils/maestro-flow.d.ts +38 -0
  162. package/dist/utils/maestro-flow.d.ts.map +1 -0
  163. package/dist/utils/maestro-flow.js +114 -0
  164. package/dist/utils/maestro-flow.js.map +1 -0
  165. package/dist/utils/metric-semantics.d.ts +22 -0
  166. package/dist/utils/metric-semantics.d.ts.map +1 -0
  167. package/dist/utils/metric-semantics.js +24 -0
  168. package/dist/utils/metric-semantics.js.map +1 -0
  169. package/dist/utils/pagination.d.ts +11 -0
  170. package/dist/utils/pagination.d.ts.map +1 -1
  171. package/dist/utils/pagination.js +16 -0
  172. package/dist/utils/pagination.js.map +1 -1
  173. package/dist/utils/path-guard.js +1 -1
  174. package/dist/utils/path-guard.js.map +1 -1
  175. package/dist/utils/profile-loader.d.ts +4 -2
  176. package/dist/utils/profile-loader.d.ts.map +1 -1
  177. package/dist/utils/profile-loader.js +5 -4
  178. package/dist/utils/profile-loader.js.map +1 -1
  179. package/dist/utils/remediation.d.ts +113 -0
  180. package/dist/utils/remediation.d.ts.map +1 -0
  181. package/dist/utils/remediation.js +392 -0
  182. package/dist/utils/remediation.js.map +1 -0
  183. package/dist/utils/report-ref.d.ts +23 -0
  184. package/dist/utils/report-ref.d.ts.map +1 -0
  185. package/dist/utils/report-ref.js +31 -0
  186. package/dist/utils/report-ref.js.map +1 -0
  187. package/dist/utils/response-formatter.d.ts +2 -1
  188. package/dist/utils/response-formatter.d.ts.map +1 -1
  189. package/dist/utils/response-formatter.js +32 -21
  190. package/dist/utils/response-formatter.js.map +1 -1
  191. package/dist/utils/test-orchestrator.d.ts +102 -0
  192. package/dist/utils/test-orchestrator.d.ts.map +1 -0
  193. package/dist/utils/test-orchestrator.js +236 -0
  194. package/dist/utils/test-orchestrator.js.map +1 -0
  195. package/dist/utils/test-status.d.ts +48 -0
  196. package/dist/utils/test-status.d.ts.map +1 -0
  197. package/dist/utils/test-status.js +92 -0
  198. package/dist/utils/test-status.js.map +1 -0
  199. package/dist/utils/tool-catalog.d.ts +6 -0
  200. package/dist/utils/tool-catalog.d.ts.map +1 -0
  201. package/dist/utils/tool-catalog.js +15 -0
  202. package/dist/utils/tool-catalog.js.map +1 -0
  203. package/dist/utils/toolsets.d.ts +79 -0
  204. package/dist/utils/toolsets.d.ts.map +1 -0
  205. package/dist/utils/toolsets.js +156 -0
  206. package/dist/utils/toolsets.js.map +1 -0
  207. package/dist/utils/upload-command.d.ts.map +1 -1
  208. package/dist/utils/upload-command.js +5 -4
  209. package/dist/utils/upload-command.js.map +1 -1
  210. package/dist/utils/usage-report-guard.d.ts +7 -0
  211. package/dist/utils/usage-report-guard.d.ts.map +1 -1
  212. package/dist/utils/usage-report-guard.js +18 -1
  213. package/dist/utils/usage-report-guard.js.map +1 -1
  214. package/dist/utils/usage-report-summary.d.ts +12 -0
  215. package/dist/utils/usage-report-summary.d.ts.map +1 -1
  216. package/dist/utils/usage-report-summary.js +25 -6
  217. package/dist/utils/usage-report-summary.js.map +1 -1
  218. package/package.json +40 -4
  219. package/resources/boilerplate/Android-Native/Java JUnit5/gradle +6 -1
  220. package/resources/boilerplate/Android-Native/Java JUnit5/gradle-oss +6 -1
  221. package/resources/boilerplate/Android-Native/java TestNG/AndroidNative-oss.java +2 -2
  222. package/resources/boilerplate/Android-Native/java TestNG/AndroidNative.java +2 -2
  223. package/resources/boilerplate/Android-Native/java TestNG/gradle +1 -1
  224. package/resources/boilerplate/Android-Native/java TestNG/gradle-oss +1 -1
  225. package/resources/boilerplate/iOS-Native/java-JUnit5/gradle +6 -1
  226. package/resources/boilerplate/iOS-Native/java-JUnit5/gradle-oss +6 -1
  227. package/resources/boilerplate/iOS-Native/java-TestNG/gradle +1 -1
  228. package/resources/boilerplate/iOS-Native/java-TestNG/gradle-oss +1 -1
  229. package/resources/boilerplate/iOS-Native/java-TestNG/iOSNative-oss.java +2 -2
  230. package/resources/boilerplate/iOS-Native/java-TestNG/iOSNative.java +2 -2
  231. package/resources/test-orchestrator/agent.json +19 -0
@@ -0,0 +1,392 @@
1
+ /**
2
+ * Debug mode (MCP_DEBUG_MODE=true) — remediation capture for ongoing improvement of the MCP.
3
+ *
4
+ * Off by default, and off means no behaviour change: nothing is wrapped, logged, nudged or registered.
5
+ * On, three things work together:
6
+ * 1. A server-side EVENT LOG of what the MCP observes itself — every tool call with timing, response size (a token
7
+ * proxy), outcome (ok / error / guard), and "retried after an error or guard" signals. The agent can't under-report
8
+ * these. Written to <project>/remediation/<session>.events.jsonl when the server runs on the user's machine
9
+ * (MCP_DEPLOYMENT_MODE=local); kept in memory under Docker, where the server's filesystem is the container's.
10
+ * 2. record_remediation_note — a structured tool the agent calls for what only it can know (user corrections, giving
11
+ * up, a better path, unclear guidance). Local: appended to <project>/remediation/<session>.md. Docker: the note
12
+ * text is returned for the agent to save in remediation/ of the project it is working in.
13
+ * <project> = the CLIENT's project (the folder the agent works in), so notes sit next to the app/tests they are about:
14
+ * MCP_REMEDIATION_DIR → the client's workspace roots (MCP roots/list) → the folder the server was started in, if it
15
+ * looks like a project → ~/remediation. The folder gets its own ".gitignore" containing "*" so it never ends up in the
16
+ * customer's repo. Files carry the machine and user so batches from several machines can be merged and attributed.
17
+ * 3. NUDGES — one line appended to an error or guard response, prompting a note at the moment it matters.
18
+ * Everything written or returned is redacted (keys, JWTs, emails, signed-URL parameters).
19
+ */
20
+ import { appendFileSync, existsSync, mkdirSync, readdirSync, statSync, writeFileSync } from 'fs';
21
+ import { homedir, hostname, userInfo } from 'os';
22
+ import { join } from 'path';
23
+ import { fileURLToPath } from 'url';
24
+ import { randomBytes } from 'crypto';
25
+ import { getDeploymentMode } from './deployment-mode.js';
26
+ /** Read live (like getDeploymentMode) so tests can flip it; "true"/"1"/"yes", case-insensitive. */
27
+ export function isDebugMode() {
28
+ return /^(true|1|yes)$/i.test((process.env.MCP_DEBUG_MODE ?? '').trim());
29
+ }
30
+ export const REMEDIATION_CATEGORIES = ['error', 'unclear-guidance', 'user-correction', 'gave-up', 'better-path', 'improvement'];
31
+ export const CATEGORY_TITLES = {
32
+ error: 'Error encountered',
33
+ 'unclear-guidance': 'Wasted effort — unclear MCP guidance',
34
+ 'user-correction': 'Corrected or stopped by the user',
35
+ 'gave-up': 'Gave up',
36
+ 'better-path': 'Found a better path than the MCP recommended',
37
+ improvement: 'Improvement opportunity',
38
+ };
39
+ // ── Session ──────────────────────────────────────────────────────────────────
40
+ const pad = (n) => String(n).padStart(2, '0');
41
+ /** yyyymmddhhmmss in local time (the user reads these names in their own directory). */
42
+ export function remediationStamp(d) {
43
+ return `${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}${pad(d.getHours())}${pad(d.getMinutes())}${pad(d.getSeconds())}`;
44
+ }
45
+ let session = null;
46
+ /** Called once at startup when debug mode is on. The short random suffix keeps parallel sessions apart. */
47
+ export function startRemediationSession(opts) {
48
+ const startedAt = opts.now ?? new Date();
49
+ session = { id: `${remediationStamp(startedAt)}-${randomBytes(2).toString('hex')}`, startedAt, mcpVersion: opts.mcpVersion, toolsets: opts.toolsets, client: opts.client, roots: opts.roots };
50
+ events.length = 0;
51
+ lastOutcome.clear();
52
+ nudged.clear();
53
+ notesWritten = 0;
54
+ sessionHeaderWritten = false;
55
+ return session;
56
+ }
57
+ export function getRemediationSession() {
58
+ return session;
59
+ }
60
+ const PROJECT_MARKERS = [
61
+ '.git', 'package.json', 'pom.xml', 'build.gradle', 'build.gradle.kts', 'settings.gradle', 'settings.gradle.kts',
62
+ 'pyproject.toml', 'requirements.txt', 'Package.swift', 'go.mod', '.claude', '.mcp.json', '.vscode',
63
+ ];
64
+ /** A folder counts as a project if it has a typical marker — never the home folder or a filesystem root. */
65
+ export function looksLikeProject(dir) {
66
+ try {
67
+ if (!dir || dir === homedir() || /^([A-Za-z]:)?[\\/]?$/.test(dir) || !statSync(dir).isDirectory())
68
+ return false;
69
+ if (PROJECT_MARKERS.some((m) => existsSync(join(dir, m))))
70
+ return true;
71
+ return readdirSync(dir).some((n) => /\.(xcodeproj|xcworkspace|sln|csproj)$/i.test(n));
72
+ }
73
+ catch {
74
+ return false;
75
+ }
76
+ }
77
+ /** Synchronous best guess — used until (or instead of) the roots-aware resolution. */
78
+ function locateWithoutRoots() {
79
+ if (process.env.MCP_REMEDIATION_DIR)
80
+ return { dir: process.env.MCP_REMEDIATION_DIR, source: 'env' };
81
+ if (looksLikeProject(process.cwd()))
82
+ return { dir: join(process.cwd(), 'remediation'), source: 'start-folder' };
83
+ return { dir: join(homedir(), 'remediation'), source: 'home' };
84
+ }
85
+ /**
86
+ * Where this session's files go, resolved once (the client's roots are only available after it has connected):
87
+ * MCP_REMEDIATION_DIR → first client workspace root → the server's start folder if it is a project → ~/remediation.
88
+ */
89
+ export async function resolveRemediationLocation() {
90
+ if (session?.location)
91
+ return session.location;
92
+ let loc = process.env.MCP_REMEDIATION_DIR ? { dir: process.env.MCP_REMEDIATION_DIR, source: 'env' } : null;
93
+ if (!loc && session?.roots) {
94
+ try {
95
+ for (const uri of await session.roots()) {
96
+ const path = uri.startsWith('file:') ? fileURLToPath(uri) : uri;
97
+ if (existsSync(path) && statSync(path).isDirectory()) {
98
+ loc = { dir: join(path, 'remediation'), source: 'client-roots' };
99
+ break;
100
+ }
101
+ }
102
+ }
103
+ catch {
104
+ // Client without roots support, or it did not answer — fall through.
105
+ }
106
+ }
107
+ loc ??= locateWithoutRoots();
108
+ if (session)
109
+ session.location = loc;
110
+ return loc;
111
+ }
112
+ /** The resolved folder, or the best synchronous guess before resolution. */
113
+ export function remediationDir() {
114
+ return (session?.location ?? locateWithoutRoots()).dir;
115
+ }
116
+ /** Create the folder with a ".gitignore" of "*" so it can never be committed to the project it lives in. */
117
+ export function ensureRemediationDir(dir = remediationDir()) {
118
+ mkdirSync(dir, { recursive: true });
119
+ const ignore = join(dir, '.gitignore');
120
+ if (!existsSync(ignore)) {
121
+ writeFileSync(ignore, '# Debug-mode remediation notes (digital-ai-testing-mcp) — may contain customer data; never commit.\n*\n');
122
+ }
123
+ }
124
+ /** Only when the server's filesystem is the user's machine (npm/local install). */
125
+ export function canWriteLocally() {
126
+ return getDeploymentMode() === 'local';
127
+ }
128
+ // ── Redaction ────────────────────────────────────────────────────────────────
129
+ /** Strip credentials and personal data before anything is written or returned. */
130
+ export function redact(text) {
131
+ let out = text;
132
+ // Exact configured secrets first (any profile), so even an unusual key format is caught.
133
+ for (const [k, v] of Object.entries(process.env)) {
134
+ if (v && v.length >= 12 && /(ACCESS_KEY|_KEY$|TOKEN|SECRET|PASSWORD)/i.test(k))
135
+ out = out.split(v).join('[REDACTED_KEY]');
136
+ }
137
+ return out
138
+ .replace(/eyJ[\w-]{8,}\.[\w-]{8,}\.[\w-]{8,}/g, '[REDACTED_JWT]')
139
+ .replace(/\baut_\d_[\w-]{8,}/g, '[REDACTED_KEY]')
140
+ .replace(/\b(Bearer)\s+[\w.~+/-]{12,}=*/gi, '$1 [REDACTED]')
141
+ .replace(/((?:access_?key|api_?key|token|password|secret|signature|sig)["']?\s*[:=]\s*["']?)[^\s"'&,}]{6,}/gi, '$1[REDACTED]')
142
+ .replace(/([?&](?:token|key|signature|sig|X-Amz-Signature|X-Amz-Credential)=)[^&\s"']+/gi, '$1[REDACTED]')
143
+ .replace(/[\w.+-]+@[\w-]+(?:\.[\w-]+)+/g, '[REDACTED_EMAIL]');
144
+ }
145
+ const MAX_MEMORY_EVENTS = 300;
146
+ const events = [];
147
+ const lastOutcome = new Map();
148
+ const nudged = new Set();
149
+ let notesWritten = 0;
150
+ let sessionHeaderWritten = false;
151
+ /** Guard responses are deliberate stops (selector gate, size guard, confirmDeletion previews) — not failures. */
152
+ export function classifyOutcome(result) {
153
+ const r = result;
154
+ const text = (r?.content ?? []).map((c) => (c.type === 'text' ? c.text ?? '' : '')).join('\n');
155
+ const guard = /"status":\s*"blocked"|⛔|\bBLOCKED\b|guard triggered|confirmDeletion:\s*true|confirmPublicShare:\s*true|confirmLargeExport|Nothing was executed/i.test(text);
156
+ if (guard)
157
+ return { outcome: 'guard', text };
158
+ return { outcome: r?.isError ? 'error' : 'ok', text };
159
+ }
160
+ function summarizeArgs(args) {
161
+ const out = {};
162
+ if (!args || typeof args !== 'object')
163
+ return out;
164
+ for (const [k, v] of Object.entries(args)) {
165
+ // JSON.stringify(undefined) is undefined, not a string — never let the bookkeeping throw on an odd argument.
166
+ const s = typeof v === 'string' ? v : (JSON.stringify(v) ?? String(v));
167
+ out[k] = redact(s.length > 160 ? `${s.slice(0, 160)}…(${s.length} chars)` : s);
168
+ }
169
+ return out;
170
+ }
171
+ function sessionFileBase() {
172
+ return session ? join(remediationDir(), session.id) : null;
173
+ }
174
+ function writeEventLine(obj) {
175
+ const base = sessionFileBase();
176
+ if (!base || !canWriteLocally())
177
+ return;
178
+ try {
179
+ ensureRemediationDir();
180
+ if (!sessionHeaderWritten) {
181
+ sessionHeaderWritten = true;
182
+ appendFileSync(`${base}.events.jsonl`, JSON.stringify({ type: 'session', ...sessionMeta() }) + '\n');
183
+ }
184
+ appendFileSync(`${base}.events.jsonl`, JSON.stringify(obj) + '\n');
185
+ }
186
+ catch (e) {
187
+ console.error(`[debug-mode] could not write the event log: ${e.message}`);
188
+ }
189
+ }
190
+ function currentUser() {
191
+ try {
192
+ return userInfo().username;
193
+ }
194
+ catch {
195
+ return process.env.USERNAME || process.env.USER || 'unknown';
196
+ }
197
+ }
198
+ function sessionMeta() {
199
+ const c = session?.client();
200
+ return {
201
+ machine: hostname(),
202
+ user: currentUser(),
203
+ location: session?.location?.source ?? locateWithoutRoots().source,
204
+ session: session?.id,
205
+ startedAt: session?.startedAt.toISOString(),
206
+ mcpVersion: session?.mcpVersion,
207
+ deploymentMode: getDeploymentMode(),
208
+ toolsets: session?.toolsets,
209
+ client: c ? `${c.name ?? '?'} ${c.version ?? ''}`.trim() : 'unknown',
210
+ };
211
+ }
212
+ export function recordToolEvent(e) {
213
+ const classified = classifyOutcome(e.result);
214
+ // A placeholder's guidance text says "Nothing was executed", which the guard regex matches — but a placeholder is
215
+ // its own signal (the `placeholder` flag), not a guard, and the real call that follows is not a "retry after a guard".
216
+ const outcome = e.placeholder && !e.result?.isError ? 'ok' : classified.outcome;
217
+ const text = classified.text;
218
+ const args = summarizeArgs(e.args);
219
+ const argsKey = JSON.stringify(args);
220
+ const prev = lastOutcome.get(e.tool);
221
+ const ev = {
222
+ type: 'tool',
223
+ at: new Date().toISOString(),
224
+ tool: e.tool,
225
+ ms: e.ms,
226
+ outcome,
227
+ responseChars: text.length,
228
+ args,
229
+ ...(prev && prev.outcome !== 'ok' ? { retryAfter: prev.outcome } : {}),
230
+ ...(prev && prev.argsKey === argsKey ? { repeatedArgs: true } : {}),
231
+ ...(e.placeholder ? { placeholder: true } : {}),
232
+ ...(outcome !== 'ok' ? { detail: redact(text.split('\n').find((l) => l.trim()) ?? '').slice(0, 300) } : {}),
233
+ };
234
+ // Placeholder calls carry no arguments, so they must not make the first real call look like a repeat.
235
+ if (!e.placeholder)
236
+ lastOutcome.set(e.tool, { outcome, argsKey });
237
+ events.push(ev);
238
+ if (events.length > MAX_MEMORY_EVENTS)
239
+ events.shift();
240
+ writeEventLine(ev);
241
+ return ev;
242
+ }
243
+ export function getRecordedEvents() {
244
+ return events;
245
+ }
246
+ /** Compact, objective summary for a note: what the server saw, so the agent's account can be checked against it. */
247
+ export function summarizeEvents(list = events) {
248
+ if (list.length === 0)
249
+ return 'No tool calls recorded yet.';
250
+ const by = (o) => list.filter((e) => e.outcome === o).length;
251
+ const chars = list.reduce((n, e) => n + e.responseChars, 0);
252
+ const retries = list.filter((e) => e.retryAfter).map((e) => e.tool);
253
+ const repeats = list.filter((e) => e.repeatedArgs).map((e) => e.tool);
254
+ const placeholders = list.filter((e) => e.placeholder).map((e) => e.tool);
255
+ const biggest = [...list].sort((a, b) => b.responseChars - a.responseChars).slice(0, 3).map((e) => `${e.tool} (${e.responseChars} chars)`);
256
+ const problems = list.filter((e) => e.outcome !== 'ok').slice(-5).map((e) => `${e.tool} → ${e.outcome}: ${e.detail ?? ''}`);
257
+ return [
258
+ `${list.length} tool calls: ${by('ok')} ok, ${by('error')} error, ${by('guard')} guard; ${chars} response chars in total.`,
259
+ retries.length ? `Retried after an error/guard: ${[...new Set(retries)].join(', ')}.` : null,
260
+ repeats.length ? `Repeated with identical arguments: ${[...new Set(repeats)].join(', ')}.` : null,
261
+ placeholders.length ? `Toolset placeholders fired: ${[...new Set(placeholders)].join(', ')}.` : null,
262
+ `Largest responses: ${biggest.join(', ')}.`,
263
+ problems.length ? `Recent problems:\n${problems.map((p) => ` - ${p}`).join('\n')}` : null,
264
+ ].filter(Boolean).join('\n');
265
+ }
266
+ // ── Nudges ───────────────────────────────────────────────────────────────────
267
+ /** One line, once per tool+outcome per session — enough to prompt a note without nagging. */
268
+ export function nudgeFor(tool, outcome) {
269
+ if (outcome === 'ok' || tool === 'record_remediation_note')
270
+ return null;
271
+ const key = `${tool}:${outcome}`;
272
+ if (nudged.has(key))
273
+ return null;
274
+ nudged.add(key);
275
+ return outcome === 'error'
276
+ ? `[debug mode] Once this error is resolved or abandoned, record it with record_remediation_note (category "error": what you were doing, the error, the workaround). Don't interrupt the user's task to do it.`
277
+ : `[debug mode] If this guard was unclear or cost extra calls, record it with record_remediation_note (category "unclear-guidance").`;
278
+ }
279
+ /** Wrap a tool callback: time it, log the event, append a nudge on error/guard. Never changes the tool's own result. */
280
+ export function instrumentHandler(tool, callback, opts = {}) {
281
+ return async (...a) => {
282
+ // Debug-mode bookkeeping must never turn a working tool into a failing one: every step around the real call is
283
+ // guarded, and a bookkeeping error is logged to stderr instead of propagating to the client.
284
+ const safely = (what, fn) => {
285
+ try {
286
+ return fn();
287
+ }
288
+ catch (e) {
289
+ console.error(`[debug-mode] ${what} failed: ${e.message}`);
290
+ return undefined;
291
+ }
292
+ };
293
+ if (canWriteLocally())
294
+ await resolveRemediationLocation().catch((e) => console.error(`[debug-mode] could not resolve the remediation folder: ${e.message}`));
295
+ const started = Date.now();
296
+ // The note itself is already in the .md file — log only that the call happened.
297
+ const args = opts.placeholder || tool === 'record_remediation_note' ? {} : a[0];
298
+ let result;
299
+ try {
300
+ result = await callback(...a);
301
+ }
302
+ catch (e) {
303
+ safely('event log', () => recordToolEvent({ tool, args, ms: Date.now() - started, result: { isError: true, content: [{ type: 'text', text: `thrown: ${e.message}` }] }, placeholder: opts.placeholder }));
304
+ throw e;
305
+ }
306
+ const ev = safely('event log', () => recordToolEvent({ tool, args, ms: Date.now() - started, result, placeholder: opts.placeholder }));
307
+ const nudge = opts.placeholder || !ev ? null : nudgeFor(tool, ev.outcome);
308
+ const r = result;
309
+ if (nudge && r && Array.isArray(r.content))
310
+ return { ...r, content: [...r.content, { type: 'text', text: nudge }] };
311
+ return result;
312
+ };
313
+ }
314
+ export function noteFileHeader() {
315
+ const m = sessionMeta();
316
+ return [
317
+ '---',
318
+ `session: ${m.session}`,
319
+ `started: ${m.startedAt}`,
320
+ `mcpVersion: ${m.mcpVersion}`,
321
+ `deploymentMode: ${m.deploymentMode}`,
322
+ `toolsets: ${m.toolsets}`,
323
+ `client: ${m.client}`,
324
+ `machine: ${m.machine}`,
325
+ `user: ${m.user}`,
326
+ `location: ${m.location} # env | client-roots | start-folder | home`,
327
+ 'debugMode: true # debug sessions spend extra tokens on notes — exclude them from token baselines',
328
+ canWriteLocally() ? `eventsLog: ${m.session}.events.jsonl` : 'eventsLog: none (server not on this machine) — see "Server-observed events" in each note',
329
+ '---',
330
+ '',
331
+ `# MCP remediation notes — session ${m.session}`,
332
+ '',
333
+ '',
334
+ ].join('\n');
335
+ }
336
+ export function formatNote(note, now = new Date()) {
337
+ const r = (s) => (s ? redact(s.trim()) : '');
338
+ const lines = [
339
+ `## [${note.category}] ${r(note.title)}`,
340
+ '',
341
+ `- **When:** ${now.toISOString()}`,
342
+ `- **Category:** ${CATEGORY_TITLES[note.category]}`,
343
+ ...(note.tools?.length ? [`- **Tools:** ${note.tools.map((t) => `\`${r(t)}\``).join(', ')}`] : []),
344
+ ...(note.wastedCalls != null ? [`- **Calls that did not move the task forward:** ${note.wastedCalls}`] : []),
345
+ `- **Resolved:** ${note.resolved === true ? 'yes' : note.resolved === false ? 'no' : 'unknown'}`,
346
+ '',
347
+ '### What I was trying to do',
348
+ r(note.intent),
349
+ '',
350
+ '### What happened',
351
+ r(note.whatHappened),
352
+ ...(note.userFeedback ? ['', '### What the user said', r(note.userFeedback)] : []),
353
+ ...(note.resolution ? ['', '### Resolution / workaround', r(note.resolution)] : []),
354
+ ...(note.suggestion ? ['', '### Suggested MCP change', r(note.suggestion)] : []),
355
+ ];
356
+ if (!canWriteLocally())
357
+ lines.push('', '### Server-observed events (so far this session)', summarizeEvents());
358
+ return lines.join('\n') + '\n\n';
359
+ }
360
+ /** Local: append to ~/remediation/<session>.md. Otherwise: return the text for the agent to save. */
361
+ export function saveNote(note) {
362
+ const fileName = `${session?.id ?? remediationStamp(new Date())}.md`;
363
+ const entry = formatNote(note);
364
+ const markdown = notesWritten === 0 ? noteFileHeader() + entry : entry;
365
+ if (!canWriteLocally()) {
366
+ notesWritten++;
367
+ return { written: null, markdown, fileName };
368
+ }
369
+ ensureRemediationDir();
370
+ const path = join(remediationDir(), fileName);
371
+ appendFileSync(path, markdown);
372
+ notesWritten++;
373
+ writeEventLine({ type: 'note', at: new Date().toISOString(), category: note.category, title: redact(note.title) });
374
+ return { written: path, markdown, fileName };
375
+ }
376
+ /** Instructions block appended to the server instructions when debug mode is on (kept short — it costs tokens). */
377
+ export function debugInstructions() {
378
+ const where = canWriteLocally()
379
+ ? 'The server saves each note in a remediation/ folder of the project you are working in.'
380
+ : 'The tool returns each note as markdown: if you can write files, append it to remediation/<fileName> in the root of the project you are working in (create the folder, plus remediation/.gitignore containing "*" so it is never committed); if you cannot, skip saving — never paste notes into the conversation unasked.';
381
+ return `
382
+
383
+ DEBUG MODE IS ON (MCP_DEBUG_MODE=true) — help improve this MCP. Call record_remediation_note once per occurrence, when it is resolved or abandoned (never interrupt the user's task for it):
384
+ 1. error — an error you hit: what you were doing, the error, any workaround.
385
+ 2. unclear-guidance — calls wasted because a tool's guidance was unclear: the request, the misunderstanding, the resolution.
386
+ 3. user-correction — the user corrected or stopped you: what you did, what they said, the fix.
387
+ 4. gave-up — you could not complete the request: your understanding of the intent and why it could not be done.
388
+ 5. better-path — you found a better route than the one the MCP recommended.
389
+ 6. improvement — anything that would make the experience cleaner or cheaper in tokens.
390
+ Count calls rather than guessing tokens. Never include credentials. Before you finish a task, make sure each such event has a note. ${where}`;
391
+ }
392
+ //# sourceMappingURL=remediation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"remediation.js","sourceRoot":"","sources":["../../src/utils/remediation.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,23 @@
1
+ /**
2
+ * Resolve a report reference — a UUID, a numeric test_id, or any reporter URL — to the identifier the API needs.
3
+ *
4
+ * Verified live (2026-10-09):
5
+ * - GET /reporter/api/reports/{uuid} returns the full report for every role. UUIDs are global: a project key asking
6
+ * for another project's report gets a clean 403 "no permission", never a different test.
7
+ * - Numeric test_ids are only unique per reporter scope. On the dev tenant test_id 20 is "Digital.ai Sample Login
8
+ * Test" for a project key and "Quick Start iOS Native Demo" for a Cloud Admin (no projectName). A numeric lookup
9
+ * can therefore silently return the WRONG test — prefer the UUID whenever one is available.
10
+ * - Sessions now print `/reporter/video-report/<uuid>`; 26.8 deprecated `html-report/index.html?test_id=N` in favour
11
+ * of `/reporter/html-report/<uuid>`. Older `/reporter/reporter/tests/<id>` links still exist in the wild.
12
+ */
13
+ export declare const UUID_PATTERN: RegExp;
14
+ export type ReportRef = {
15
+ kind: 'uuid';
16
+ uuid: string;
17
+ } | {
18
+ kind: 'testId';
19
+ testId: number;
20
+ };
21
+ /** Parse a UUID, a numeric id, or a report URL. A UUID anywhere in the input wins over a number. null = unrecognised. */
22
+ export declare function parseReportRef(input: string | number | null | undefined): ReportRef | null;
23
+ //# sourceMappingURL=report-ref.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"report-ref.d.ts","sourceRoot":"","sources":["../../src/utils/report-ref.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,YAAY,QAAkE,CAAC;AAE5F,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5F,yHAAyH;AACzH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,GAAG,IAAI,CAU1F"}
@@ -0,0 +1,31 @@
1
+ /**
2
+ * Resolve a report reference — a UUID, a numeric test_id, or any reporter URL — to the identifier the API needs.
3
+ *
4
+ * Verified live (2026-10-09):
5
+ * - GET /reporter/api/reports/{uuid} returns the full report for every role. UUIDs are global: a project key asking
6
+ * for another project's report gets a clean 403 "no permission", never a different test.
7
+ * - Numeric test_ids are only unique per reporter scope. On the dev tenant test_id 20 is "Digital.ai Sample Login
8
+ * Test" for a project key and "Quick Start iOS Native Demo" for a Cloud Admin (no projectName). A numeric lookup
9
+ * can therefore silently return the WRONG test — prefer the UUID whenever one is available.
10
+ * - Sessions now print `/reporter/video-report/<uuid>`; 26.8 deprecated `html-report/index.html?test_id=N` in favour
11
+ * of `/reporter/html-report/<uuid>`. Older `/reporter/reporter/tests/<id>` links still exist in the wild.
12
+ */
13
+ export const UUID_PATTERN = /[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/i;
14
+ /** Parse a UUID, a numeric id, or a report URL. A UUID anywhere in the input wins over a number. null = unrecognised. */
15
+ export function parseReportRef(input) {
16
+ if (input == null)
17
+ return null;
18
+ if (typeof input === 'number')
19
+ return Number.isInteger(input) && input > 0 ? { kind: 'testId', testId: input } : null;
20
+ const s = input.trim();
21
+ if (!s)
22
+ return null;
23
+ const uuid = s.match(UUID_PATTERN)?.[0];
24
+ if (uuid)
25
+ return { kind: 'uuid', uuid: uuid.toLowerCase() };
26
+ if (/^\d+$/.test(s))
27
+ return { kind: 'testId', testId: Number(s) };
28
+ const q = s.match(/[?&]test_id=(\d+)/i) ?? s.match(/\/tests\/(\d+)(?:[/?#]|$)/i) ?? s.match(/\/(\d+)\/?(?:[?#].*)?$/);
29
+ return q ? { kind: 'testId', testId: Number(q[1]) } : null;
30
+ }
31
+ //# sourceMappingURL=report-ref.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"report-ref.js","sourceRoot":"","sources":["../../src/utils/report-ref.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,+DAA+D,CAAC;AAI5F,yHAAyH;AACzH,MAAM,UAAU,cAAc,CAAC,KAAyC;IACtE,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACtH,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACvB,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACxC,IAAI,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;IAC5D,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,4BAA4B,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACtH,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7D,CAAC"}
@@ -1,3 +1,4 @@
1
+ import { type StatusCounts } from './test-status.js';
1
2
  import type { Device, DeviceReservation, Application, Project, User, ProvisioningProfile, RepositoryFile, Browser, TestReport, FailureSummary, TestView, TestViewSummary, Agent, Region, RegionTopology, NvServer, DeviceGroupV2, Transaction } from '../types/digital-ai.js';
2
3
  export declare function getStatusEmoji(status: string): string;
3
4
  export declare function formatDeviceList(devices: Device[]): string;
@@ -13,7 +14,7 @@ export declare function formatFailureSummary(s: FailureSummary): string;
13
14
  export declare function formatTestReportList(reports: TestReport[]): string;
14
15
  export declare function formatTestAttachments(report: TestReport): string;
15
16
  export declare function formatGroupedTestReports(result: unknown): string;
16
- export declare function formatProjectTestSummary(statusCounts: Record<string, number>, total: number, timeWindow: string, topFailures: string[]): string;
17
+ export declare function formatProjectTestSummary(counts: StatusCounts, timeWindow: string, topFailures: string[], topErrors?: string[]): string;
17
18
  export declare function formatTestViewList(views: TestView[]): string;
18
19
  export declare function formatTestViewSummary(summary: TestViewSummary): string;
19
20
  export declare function formatBrowserList(browsers: Browser[]): string;
@@ -1 +1 @@
1
- {"version":3,"file":"response-formatter.d.ts","sourceRoot":"","sources":["../../src/utils/response-formatter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,MAAM,EACN,iBAAiB,EACjB,WAAW,EACX,OAAO,EACP,IAAI,EACJ,mBAAmB,EACnB,cAAc,EACd,OAAO,EACP,UAAU,EACV,cAAc,EACd,QAAQ,EACR,eAAe,EACf,KAAK,EAEL,MAAM,EACN,cAAc,EACd,QAAQ,EACR,aAAa,EACb,WAAW,EACZ,MAAM,wBAAwB,CAAC;AAchC,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CA4B1D;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EAAE,EACjB,uBAAuB,SAAK,GAC3B,MAAM,CA6DR;AAED,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAuBrF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,MAAM,CA0BjE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAY7D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CAepD;AAGD,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,mBAAmB,EAAE,GAAG,MAAM,CAuBrF;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,CAUxE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CA+C3D;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CAiB9D;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAGlE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAiBhE;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CA4BhE;AAED,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EAAE,GACpB,MAAM,CAyBR;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAS5D;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAWtE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAsB7D;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAavD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAS1D;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,CAsBzF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,CAW9D;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAKvE;AAOD,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,MAAM,CAiBzE;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAoBxD"}
1
+ {"version":3,"file":"response-formatter.d.ts","sourceRoot":"","sources":["../../src/utils/response-formatter.ts"],"names":[],"mappings":"AACA,OAAO,EAAoD,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACvG,OAAO,KAAK,EACV,MAAM,EACN,iBAAiB,EACjB,WAAW,EACX,OAAO,EACP,IAAI,EACJ,mBAAmB,EACnB,cAAc,EACd,OAAO,EACP,UAAU,EACV,cAAc,EACd,QAAQ,EACR,eAAe,EACf,KAAK,EAEL,MAAM,EACN,cAAc,EACd,QAAQ,EACR,aAAa,EACb,WAAW,EACZ,MAAM,wBAAwB,CAAC;AAchC,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CA4B1D;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EAAE,EACjB,uBAAuB,SAAK,GAC3B,MAAM,CA6DR;AAED,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAuBrF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,MAAM,CA0BjE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAY7D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CAepD;AAGD,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,mBAAmB,EAAE,GAAG,MAAM,CAuBrF;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,CAUxE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAqD3D;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CAiB9D;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAGlE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAiBhE;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CA4BhE;AAkBD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EAAE,EACrB,SAAS,GAAE,MAAM,EAAO,GACvB,MAAM,CAoBR;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAS5D;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAGtE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAsB7D;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAavD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAS1D;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,CAsBzF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,CAW9D;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAKvE;AAOD,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,MAAM,CAiBzE;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAoBxD"}
@@ -1,4 +1,5 @@
1
1
  import { parseApiDate } from './timestamp.js';
2
+ import { countsFromPivotRow, passRate, unknownStatusCount } from './test-status.js';
2
3
  const STATUS_EMOJI = {
3
4
  available: '🟢',
4
5
  online: '🟢',
@@ -216,6 +217,12 @@ export function formatTestReport(report) {
216
217
  ` UUID: ${report.uuid} | ID: ${report.test_id}`,
217
218
  ` Status: ${report.status} | Duration: ${durationSec}s | Started: ${started}`,
218
219
  ];
220
+ if (report.projectName || report.devicePool) {
221
+ lines.push(` ${[report.projectName && `Project: ${report.projectName}`, report.devicePool && `Device pool: ${report.devicePool}`].filter(Boolean).join(' | ')}`);
222
+ }
223
+ if (report.accessibility_report) {
224
+ lines.push(' Accessibility: Axe report attached (view it in the report UI)');
225
+ }
219
226
  if (report.subTestCount != null && report.subTestCount > 1) {
220
227
  lines.push(` Sub-tests: ${report.subTestCount} (${report.failedSubTestCount ?? 0} failed)`);
221
228
  }
@@ -312,20 +319,27 @@ export function formatGroupedTestReports(result) {
312
319
  const dataRows = rows.map((r) => headers.map((h, i) => ` ${String(r[h] ?? '').padEnd(colWidths[i])} `).join('│'));
313
320
  return totalLine + [headerRow, divider, ...dataRows].join('\n');
314
321
  }
315
- export function formatProjectTestSummary(statusCounts, total, timeWindow, topFailures) {
316
- const passed = statusCounts['Passed'] ?? 0;
317
- const failed = statusCounts['Failed'] ?? 0;
318
- const incomplete = statusCounts['Incomplete'] ?? 0;
319
- const passRate = total > 0 ? ((passed / total) * 100).toFixed(1) : '0.0';
322
+ /** Status-count lines shared by the project and test-view summaries. Zero-count Skipped/Healed lines are omitted. */
323
+ function statusCountLines(c, indent) {
324
+ const rate = passRate(c);
325
+ const other = unknownStatusCount(c);
326
+ return [
327
+ `${indent}✅ Passed: ${c.passed}`,
328
+ ...(c.healed > 0 ? [`${indent}🩹 Healed: ${c.healed}`] : []),
329
+ `${indent}❌ Failed: ${c.failed}`,
330
+ `${indent}💥 Error: ${c.error}`,
331
+ `${indent}⚠️ Incomplete: ${c.incomplete}`,
332
+ ...(c.skipped > 0 ? [`${indent}⏭️ Skipped: ${c.skipped}`] : []),
333
+ ...(other > 0 ? [`${indent}❔ Other: ${other}`] : []),
334
+ `${indent}Pass rate: ${rate == null ? 'n/a' : `${rate}%`} (Passed+Healed vs Failed+Error; Incomplete/Skipped excluded)`,
335
+ ];
336
+ }
337
+ export function formatProjectTestSummary(counts, timeWindow, topFailures, topErrors = []) {
320
338
  const lines = [
321
339
  `📊 Project Test Summary`,
322
340
  ``,
323
- ` All-time counts:`,
324
- ` Total: ${total}`,
325
- ` ✅ Passed: ${passed}`,
326
- ` ❌ Failed: ${failed}`,
327
- ` ⚠️ Incomplete: ${incomplete}`,
328
- ` Pass rate: ${passRate}%`,
341
+ ` All-time counts (${counts.total} total):`,
342
+ ...statusCountLines(counts, ' '),
329
343
  ];
330
344
  if (topFailures.length > 0) {
331
345
  lines.push(``, ` Top failing tests (${timeWindow}):`);
@@ -335,6 +349,11 @@ export function formatProjectTestSummary(statusCounts, total, timeWindow, topFai
335
349
  else {
336
350
  lines.push(``, ` No failures found in window: ${timeWindow}`);
337
351
  }
352
+ if (topErrors.length > 0) {
353
+ lines.push(``, ` Top erroring tests — ended abnormally (${timeWindow}):`);
354
+ for (const name of topErrors)
355
+ lines.push(` • ${name}`);
356
+ }
338
357
  return lines.join('\n');
339
358
  }
340
359
  export function formatTestViewList(views) {
@@ -349,16 +368,8 @@ export function formatTestViewList(views) {
349
368
  .join('\n');
350
369
  }
351
370
  export function formatTestViewSummary(summary) {
352
- const total = summary._count_;
353
- const passRate = total > 0 ? ((summary.passedCount / total) * 100).toFixed(1) : '0.0';
354
- return [
355
- `📊 Test Results Summary (${total} total)`,
356
- ` ✅ Passed: ${summary.passedCount}`,
357
- ` ❌ Failed: ${summary.failedCount}`,
358
- ` ⚠️ Incomplete: ${summary.incompleteCount}`,
359
- ` ⏭️ Skipped: ${summary.skippedCount}`,
360
- ` Pass rate: ${passRate}%`,
361
- ].join('\n');
371
+ const counts = countsFromPivotRow(summary);
372
+ return [`📊 Test Results Summary (${counts.total} total)`, ...statusCountLines(counts, ' ')].join('\n');
362
373
  }
363
374
  export function formatBrowserList(browsers) {
364
375
  if (browsers.length === 0)