@overkill-dev/engine 0.0.77 → 0.0.79

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 (224) hide show
  1. package/assertion-protocol/evaluation.d.ts +32 -0
  2. package/assertion-protocol/evaluation.d.ts.map +1 -0
  3. package/assertion-protocol/source-location.d.ts.map +1 -1
  4. package/assertion-protocol/source-location.js +4 -0
  5. package/assertion-protocol/source-location.js.map +1 -1
  6. package/compare/serialization-context.js +23 -0
  7. package/compare/serialization-context.js.map +1 -0
  8. package/compare/serialized-value-schema.d.ts +11 -0
  9. package/compare/serialized-value-schema.d.ts.map +1 -0
  10. package/compare/serialized-value-schema.js +76 -0
  11. package/compare/serialized-value-schema.js.map +1 -0
  12. package/compare/serialized-value-shape.d.ts +1 -0
  13. package/compare/serialized-value-shape.d.ts.map +1 -1
  14. package/compare/serialized-value.d.ts.map +1 -1
  15. package/compare/serialized-value.js +2 -1
  16. package/compare/serialized-value.js.map +1 -1
  17. package/engine/artifact-schema.d.ts +191 -0
  18. package/engine/artifact-schema.d.ts.map +1 -0
  19. package/engine/artifact-schema.js +34 -0
  20. package/engine/artifact-schema.js.map +1 -0
  21. package/engine/assertion-recorder.d.ts.map +1 -1
  22. package/engine/assertion-recorder.js +5 -0
  23. package/engine/assertion-recorder.js.map +1 -1
  24. package/engine/assertion-result-schema.d.ts +4 -0
  25. package/engine/assertion-result-schema.d.ts.map +1 -0
  26. package/engine/assertion-result-schema.js +71 -0
  27. package/engine/assertion-result-schema.js.map +1 -0
  28. package/engine/benchmark-calibration-plan.d.ts +6 -0
  29. package/engine/benchmark-calibration-plan.d.ts.map +1 -0
  30. package/engine/benchmark-calibration-plan.js +31 -0
  31. package/engine/benchmark-calibration-plan.js.map +1 -0
  32. package/engine/case-attempt-execution.js +18 -5
  33. package/engine/case-attempt-execution.js.map +1 -1
  34. package/engine/case-body-execution.js +12 -0
  35. package/engine/case-body-execution.js.map +1 -1
  36. package/engine/case-interruption.d.ts.map +1 -1
  37. package/engine/case-interruption.js +5 -1
  38. package/engine/case-interruption.js.map +1 -1
  39. package/engine/coverage-artifact.d.ts +2 -1
  40. package/engine/coverage-artifact.d.ts.map +1 -1
  41. package/engine/diff-schema.js +78 -0
  42. package/engine/diff-schema.js.map +1 -0
  43. package/engine/engine.d.ts +13 -3
  44. package/engine/engine.d.ts.map +1 -1
  45. package/engine/engine.js +73 -5
  46. package/engine/engine.js.map +1 -1
  47. package/engine/execution-error-ownership.js.map +1 -1
  48. package/engine/execution-global-error-observer.d.ts +2 -1
  49. package/engine/execution-global-error-observer.d.ts.map +1 -1
  50. package/engine/execution-global-error-observer.js +26 -5
  51. package/engine/execution-global-error-observer.js.map +1 -1
  52. package/engine/execution-observation.d.ts +12 -1
  53. package/engine/execution-observation.d.ts.map +1 -1
  54. package/engine/execution-observation.js +56 -0
  55. package/engine/execution-observation.js.map +1 -1
  56. package/engine/execution-options.d.ts +9 -4
  57. package/engine/execution-options.d.ts.map +1 -1
  58. package/engine/execution-options.js +18 -0
  59. package/engine/execution-options.js.map +1 -1
  60. package/engine/execution-preparation.js +4 -2
  61. package/engine/execution-preparation.js.map +1 -1
  62. package/engine/execution-process-budget-breach.js +18 -0
  63. package/engine/execution-process-budget-breach.js.map +1 -1
  64. package/engine/execution-process-budget-tracking.js.map +1 -1
  65. package/engine/execution-process-tracked-cases.js.map +1 -1
  66. package/engine/execution-result.d.ts.map +1 -1
  67. package/engine/execution-result.js +2 -1
  68. package/engine/execution-result.js.map +1 -1
  69. package/engine/execution-supervision-state.js +46 -1
  70. package/engine/execution-supervision-state.js.map +1 -1
  71. package/engine/execution-supervision.d.ts.map +1 -1
  72. package/engine/execution-supervision.js +38 -46
  73. package/engine/execution-supervision.js.map +1 -1
  74. package/engine/execution-test-plan-cases.js +8 -3
  75. package/engine/execution-test-plan-cases.js.map +1 -1
  76. package/engine/execution-test-plan-process-usage.js +17 -2
  77. package/engine/execution-test-plan-process-usage.js.map +1 -1
  78. package/engine/execution.d.ts +8 -2
  79. package/engine/execution.d.ts.map +1 -1
  80. package/engine/execution.js +77 -11
  81. package/engine/execution.js.map +1 -1
  82. package/engine/failure-artifact-policy.d.ts +42 -0
  83. package/engine/failure-artifact-policy.d.ts.map +1 -0
  84. package/engine/failure-artifact-policy.js +22 -0
  85. package/engine/failure-artifact-policy.js.map +1 -0
  86. package/engine/family-completion.js +11 -0
  87. package/engine/family-completion.js.map +1 -0
  88. package/engine/family-evidence-schema.js +44 -0
  89. package/engine/family-evidence-schema.js.map +1 -0
  90. package/engine/family-evidence-state.js +125 -0
  91. package/engine/family-evidence-state.js.map +1 -0
  92. package/engine/family-evidence.js +179 -0
  93. package/engine/family-evidence.js.map +1 -0
  94. package/engine/family-execution.js +41 -0
  95. package/engine/family-execution.js.map +1 -0
  96. package/engine/family-lifetime.d.ts +11 -0
  97. package/engine/family-lifetime.d.ts.map +1 -0
  98. package/engine/family-lifetime.js +72 -0
  99. package/engine/family-lifetime.js.map +1 -0
  100. package/engine/family-run.d.ts +67 -0
  101. package/engine/family-run.d.ts.map +1 -0
  102. package/engine/family-run.js +265 -0
  103. package/engine/family-run.js.map +1 -0
  104. package/engine/identity-schema.d.ts +73 -2
  105. package/engine/identity-schema.d.ts.map +1 -1
  106. package/engine/identity-schema.js +21 -2
  107. package/engine/identity-schema.js.map +1 -1
  108. package/engine/identity.d.ts +7 -0
  109. package/engine/identity.d.ts.map +1 -1
  110. package/engine/identity.js +13 -0
  111. package/engine/identity.js.map +1 -1
  112. package/engine/plan-collection-policy.d.ts +10 -0
  113. package/engine/plan-collection-policy.d.ts.map +1 -0
  114. package/engine/plan-collection-policy.js +15 -0
  115. package/engine/plan-collection-policy.js.map +1 -0
  116. package/engine/process-usage.d.ts +6 -0
  117. package/engine/process-usage.d.ts.map +1 -1
  118. package/engine/property-failure.d.ts.map +1 -1
  119. package/engine/property-failure.js +1 -0
  120. package/engine/property-failure.js.map +1 -1
  121. package/engine/property-inconclusive.d.ts +6 -0
  122. package/engine/property-inconclusive.d.ts.map +1 -0
  123. package/engine/property-inconclusive.js +20 -0
  124. package/engine/property-inconclusive.js.map +1 -0
  125. package/engine/property-plan.d.ts +8 -0
  126. package/engine/property-plan.d.ts.map +1 -0
  127. package/engine/property-plan.js +62 -0
  128. package/engine/property-plan.js.map +1 -0
  129. package/engine/property-policy.d.ts +45 -0
  130. package/engine/property-policy.d.ts.map +1 -0
  131. package/engine/property-policy.js +54 -0
  132. package/engine/property-policy.js.map +1 -0
  133. package/engine/property-trial.d.ts.map +1 -1
  134. package/engine/property-trial.js +1 -1
  135. package/engine/property-trial.js.map +1 -1
  136. package/engine/reporter-delivery-preparation.d.ts +7 -0
  137. package/engine/reporter-delivery-preparation.d.ts.map +1 -0
  138. package/engine/reporter-delivery-preparation.js +34 -0
  139. package/engine/reporter-delivery-preparation.js.map +1 -0
  140. package/engine/reporter-dispatcher.d.ts +5 -2
  141. package/engine/reporter-dispatcher.d.ts.map +1 -1
  142. package/engine/reporter-dispatcher.js +22 -31
  143. package/engine/reporter-dispatcher.js.map +1 -1
  144. package/engine/reporter.d.ts +5 -1
  145. package/engine/reporter.d.ts.map +1 -1
  146. package/engine/reporter.js.map +1 -1
  147. package/engine/reporting-context.d.ts +12 -1
  148. package/engine/reporting-context.d.ts.map +1 -1
  149. package/engine/reporting-context.js +44 -0
  150. package/engine/reporting-context.js.map +1 -1
  151. package/engine/run-artifact.d.ts +84 -2
  152. package/engine/run-artifact.d.ts.map +1 -1
  153. package/engine/run-artifact.js +88 -0
  154. package/engine/run-artifact.js.map +1 -0
  155. package/engine/run-result.d.ts +7 -3
  156. package/engine/run-result.d.ts.map +1 -1
  157. package/engine/run-result.js +4 -1
  158. package/engine/run-result.js.map +1 -1
  159. package/engine/runner-error-schema.d.ts +4 -0
  160. package/engine/runner-error-schema.d.ts.map +1 -0
  161. package/engine/runner-error-schema.js +29 -0
  162. package/engine/runner-error-schema.js.map +1 -0
  163. package/engine/runtime-attachment.js +7 -0
  164. package/engine/runtime-attachment.js.map +1 -0
  165. package/engine/runtime-matrix-expansion.d.ts +3 -0
  166. package/engine/runtime-matrix-expansion.d.ts.map +1 -0
  167. package/engine/runtime-matrix-expansion.js +150 -0
  168. package/engine/runtime-matrix-expansion.js.map +1 -0
  169. package/engine/standard-engine.js +1 -0
  170. package/engine/standard-engine.js.map +1 -1
  171. package/engine/test-body.d.ts +20 -3
  172. package/engine/test-body.d.ts.map +1 -1
  173. package/engine/test-body.js +50 -3
  174. package/engine/test-body.js.map +1 -1
  175. package/engine/test-control-error.d.ts +2 -0
  176. package/engine/test-control-error.d.ts.map +1 -0
  177. package/engine/test-control-error.js +10 -0
  178. package/engine/test-control-error.js.map +1 -0
  179. package/engine/test-data.d.ts +0 -1
  180. package/engine/test-data.d.ts.map +1 -1
  181. package/engine/test-data.js.map +1 -1
  182. package/engine/test-debug-artifact.js +166 -0
  183. package/engine/test-debug-artifact.js.map +1 -0
  184. package/engine/test-debug-context.js +120 -0
  185. package/engine/test-debug-context.js.map +1 -0
  186. package/engine/test-debug-providers.js +68 -0
  187. package/engine/test-debug-providers.js.map +1 -0
  188. package/engine/test-debug-recording.js +249 -0
  189. package/engine/test-debug-recording.js.map +1 -0
  190. package/engine/test-debug.d.ts +285 -0
  191. package/engine/test-debug.d.ts.map +1 -0
  192. package/engine/test-debug.js +67 -0
  193. package/engine/test-debug.js.map +1 -0
  194. package/engine/test-family.d.ts +112 -0
  195. package/engine/test-family.d.ts.map +1 -0
  196. package/engine/test-family.js +165 -0
  197. package/engine/test-family.js.map +1 -0
  198. package/engine/test-node.d.ts +11 -8
  199. package/engine/test-node.d.ts.map +1 -1
  200. package/engine/test-node.js +7 -2
  201. package/engine/test-node.js.map +1 -1
  202. package/engine/test-plan-locations.js +21 -0
  203. package/engine/test-plan-locations.js.map +1 -0
  204. package/engine/test-plan.d.ts +5 -3
  205. package/engine/test-plan.d.ts.map +1 -1
  206. package/engine/test-plan.js +19 -4
  207. package/engine/test-plan.js.map +1 -1
  208. package/engine/test-scope-lifecycle.js +3 -0
  209. package/engine/test-scope-lifecycle.js.map +1 -1
  210. package/engine/test-scope.d.ts +3 -0
  211. package/engine/test-scope.d.ts.map +1 -1
  212. package/module-loading-scope.d.ts +8 -0
  213. package/module-loading-scope.d.ts.map +1 -0
  214. package/module-loading-scope.js +23 -0
  215. package/module-loading-scope.js.map +1 -0
  216. package/package.json +83 -4
  217. package/packages/engine/engine.entry-point.d.ts +26 -25
  218. package/packages/engine/engine.entry-point.d.ts.map +1 -1
  219. package/packages/engine/engine.entry-point.js +12 -11
  220. package/packages/engine/engine.entry-point.js.map +1 -1
  221. package/readme.md +85 -1
  222. package/software-bill-of-materials.cyclonedx.json +5 -5
  223. package/engine/execution-process-budget-breach.d.ts +0 -8
  224. package/engine/execution-process-budget-breach.d.ts.map +0 -1
@@ -0,0 +1,42 @@
1
+ import { z } from 'zod/v4';
2
+ import { type SerializationBudget } from '../compare/serialized-value-shape.ts';
3
+ export type FailureArtifactPolicy = {
4
+ readonly capturedOutputBytes: number;
5
+ readonly serialization: SerializationBudget;
6
+ readonly rendering: {
7
+ readonly diffLines: number;
8
+ readonly valueBytes: number;
9
+ };
10
+ };
11
+ export declare const defaultFailureArtifactPolicy: FailureArtifactPolicy;
12
+ export declare const resolvedFailureArtifactPolicySchema: z.ZodObject<{
13
+ capturedOutputBytes: z.ZodNumber;
14
+ serialization: z.ZodObject<{
15
+ arrayEntries: z.ZodNumber;
16
+ depth: z.ZodNumber;
17
+ objectEntries: z.ZodNumber;
18
+ operandBytes: z.ZodNumber;
19
+ stringBytes: z.ZodNumber;
20
+ visitedNodes: z.ZodNumber;
21
+ }, z.core.$strict>;
22
+ rendering: z.ZodObject<{
23
+ diffLines: z.ZodNumber;
24
+ valueBytes: z.ZodNumber;
25
+ }, z.core.$strict>;
26
+ }, z.core.$strict>;
27
+ export declare const executionArtifactPolicySchema: z.ZodPrefault<z.ZodObject<{
28
+ capturedOutputBytes: z.ZodNumber;
29
+ serialization: z.ZodObject<{
30
+ arrayEntries: z.ZodNumber;
31
+ depth: z.ZodNumber;
32
+ objectEntries: z.ZodNumber;
33
+ operandBytes: z.ZodNumber;
34
+ stringBytes: z.ZodNumber;
35
+ visitedNodes: z.ZodNumber;
36
+ }, z.core.$strict>;
37
+ rendering: z.ZodObject<{
38
+ diffLines: z.ZodNumber;
39
+ valueBytes: z.ZodNumber;
40
+ }, z.core.$strict>;
41
+ }, z.core.$strict>>;
42
+ //# sourceMappingURL=failure-artifact-policy.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"failure-artifact-policy.d.ts","sourceRoot":"","sources":["../../../../source/engine/failure-artifact-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAA8B,KAAK,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAE5G,MAAM,MAAM,qBAAqB,GAAG;IAChC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE;QAChB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;KAC/B,CAAC;CACL,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,qBAI1C,CAAC;AAGF,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;kBAW9C,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;mBAA6E,CAAC"}
@@ -0,0 +1,22 @@
1
+ import { z } from 'zod/v4';
2
+ import { defaultSerializationBudget } from "../compare/serialized-value-shape.js";
3
+ export const defaultFailureArtifactPolicy = {
4
+ capturedOutputBytes: 1_048_576,
5
+ serialization: defaultSerializationBudget,
6
+ rendering: { diffLines: 100, valueBytes: 8192 }
7
+ };
8
+ const limit = z.number().int().positive().max(Number.MAX_SAFE_INTEGER);
9
+ export const resolvedFailureArtifactPolicySchema = z.strictObject({
10
+ capturedOutputBytes: limit,
11
+ serialization: z.strictObject({
12
+ arrayEntries: limit,
13
+ depth: limit,
14
+ objectEntries: limit,
15
+ operandBytes: limit,
16
+ stringBytes: limit,
17
+ visitedNodes: limit
18
+ }),
19
+ rendering: z.strictObject({ diffLines: limit, valueBytes: limit })
20
+ });
21
+ export const executionArtifactPolicySchema = resolvedFailureArtifactPolicySchema.prefault(defaultFailureArtifactPolicy);
22
+ //# sourceMappingURL=failure-artifact-policy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"failure-artifact-policy.js","sourceRoot":"","sources":["../../../../source/engine/failure-artifact-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,0BAA0B,EAA4B,MAAM,sCAAsC,CAAC;AAW5G,MAAM,CAAC,MAAM,4BAA4B,GAA0B;IAC/D,mBAAmB,EAAE,SAAS;IAC9B,aAAa,EAAE,0BAA0B;IACzC,SAAS,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE;CAClD,CAAC;AAEF,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;AACvE,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAC,YAAY,CAAC;IAC9D,mBAAmB,EAAE,KAAK;IAC1B,aAAa,EAAE,CAAC,CAAC,YAAY,CAAC;QAC1B,YAAY,EAAE,KAAK;QACnB,KAAK,EAAE,KAAK;QACZ,aAAa,EAAE,KAAK;QACpB,YAAY,EAAE,KAAK;QACnB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,KAAK;KACtB,CAAC;IACF,SAAS,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;CACrE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,6BAA6B,GAAG,mCAAmC,CAAC,QAAQ,CAAC,4BAA4B,CAAC,CAAC"}
@@ -0,0 +1,11 @@
1
+ export function familyRunnerError(cause) {
2
+ return {
3
+ attributedTo: null,
4
+ attributedToAttempt: null,
5
+ cause,
6
+ diagnostics: [],
7
+ message: cause instanceof Error ? cause.message : 'Family execution failed.',
8
+ subtype: 'runtime-state'
9
+ };
10
+ }
11
+ //# sourceMappingURL=family-completion.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"family-completion.js","sourceRoot":"","sources":["../../../../source/engine/family-completion.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC5C,OAAO;QACH,YAAY,EAAE,IAAI;QAClB,mBAAmB,EAAE,IAAI;QACzB,KAAK;QACL,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B;QAC5E,OAAO,EAAE,eAAe;KAC3B,CAAC;AACN,CAAC"}
@@ -0,0 +1,44 @@
1
+ import { isDeepStrictEqual } from 'node:util';
2
+ import { z } from 'zod/v4';
3
+ import { adapterArtifactSchema } from "./artifact-schema.js";
4
+ import { testOutcomeSchema } from "./assertion-result-schema.js";
5
+ import { attemptIdSchema, caseIdSchema, workIdSchema } from "./identity-schema.js";
6
+ import { runnerErrorSchema } from "./runner-error-schema.js";
7
+ function analysisOutcome(outcome) {
8
+ return outcome.kind !== 'fail' || outcome.failures.every(function analysisFailure(failure) {
9
+ return failure.kind === 'assertion' || failure.kind === 'test-contract' && failure.code === 'no-assertions';
10
+ });
11
+ }
12
+ const completion = {
13
+ property: z.null(),
14
+ benchmark: z.null(),
15
+ durationMicroseconds: z.number().nonnegative(),
16
+ outcome: testOutcomeSchema,
17
+ verdict: z.enum(['pass', 'fail', 'inconclusive'])
18
+ };
19
+ const analysisResultSchema = z
20
+ .strictObject({
21
+ ...completion,
22
+ attempts: z.tuple([z.strictObject({ ...completion, attempt: attemptIdSchema })]),
23
+ retried: z.null(),
24
+ definitionLocations: z.array(z.unknown()).min(1),
25
+ id: caseIdSchema,
26
+ workId: workIdSchema
27
+ })
28
+ .refine(function consistentResult(result) {
29
+ const [attempt] = result.attempts;
30
+ return result.verdict === result.outcome.kind && attempt.attempt.index === 0 &&
31
+ isDeepStrictEqual([attempt.verdict, attempt.durationMicroseconds, attempt.outcome], [result.verdict, result.durationMicroseconds, result.outcome]) && analysisOutcome(result.outcome);
32
+ }, 'Analysis evidence requires one consistent non-runtime attempt.');
33
+ export const familyEventSchema = z.discriminatedUnion('kind', [
34
+ z.strictObject({ kind: z.literal('case-start'), workId: workIdSchema }),
35
+ z.strictObject({ kind: z.literal('case-progress'), workId: workIdSchema, note: z.string() }),
36
+ z.strictObject({
37
+ kind: z.literal('case-end'),
38
+ result: analysisResultSchema,
39
+ artifacts: z.array(adapterArtifactSchema)
40
+ }),
41
+ z.strictObject({ kind: z.literal('run-error'), error: runnerErrorSchema }),
42
+ z.strictObject({ kind: z.literal('artifact'), artifact: adapterArtifactSchema })
43
+ ]);
44
+ //# sourceMappingURL=family-evidence-schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"family-evidence-schema.js","sourceRoot":"","sources":["../../../../source/engine/family-evidence-schema.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,125 @@
1
+ import { caseIdentityKey, workIdentityKey } from "./identity.js";
2
+ import { artifactReferenceKey, artifactsForAttempt } from "./run-artifact.js";
3
+ import { singleAttemptResult } from "./run-result.js";
4
+ function artifactWorkKey(artifact) {
5
+ const { scope, runtimes, workload, familyVariant } = artifact.id;
6
+ return scope.kind === 'run' ? null : workIdentityKey({ case: scope.case, runtimes, workload, familyVariant });
7
+ }
8
+ function activeArtifact(artifact, states) {
9
+ const workKey = artifactWorkKey(artifact);
10
+ if (workKey !== null && (artifact.id.attempt?.index !== 0 || states.get(workKey) !== 'active')) {
11
+ throw new TypeError('Analysis artifact does not belong to active selected work.');
12
+ }
13
+ return workKey;
14
+ }
15
+ function createArtifactStore(states) {
16
+ const artifacts = new Map();
17
+ const byWork = new Map();
18
+ function add(key, entry) {
19
+ artifacts.set(key, entry.artifact);
20
+ if (entry.workKey !== null) {
21
+ const previous = byWork.get(entry.workKey) ?? [];
22
+ previous.push(entry.artifact);
23
+ byWork.set(entry.workKey, previous);
24
+ }
25
+ }
26
+ return {
27
+ record(incoming) {
28
+ const accepted = new Map();
29
+ for (const artifact of incoming) {
30
+ const workKey = activeArtifact(artifact, states);
31
+ const key = artifactReferenceKey(artifact.id);
32
+ if (artifacts.has(key) || accepted.has(key)) {
33
+ throw new TypeError('Duplicate analysis artifact.');
34
+ }
35
+ accepted.set(key, { artifact, workKey });
36
+ }
37
+ for (const [key, entry] of accepted) {
38
+ add(key, entry);
39
+ }
40
+ },
41
+ forWork(key) {
42
+ return byWork.get(key) ?? [];
43
+ },
44
+ all() {
45
+ return Array.from(artifacts.values());
46
+ }
47
+ };
48
+ }
49
+ function completionResult(testCase, event) {
50
+ const attempt = { index: 0 };
51
+ if (caseIdentityKey(event.result.id) !== caseIdentityKey(testCase.id) ||
52
+ artifactsForAttempt(event.artifacts, testCase.workId, attempt).length !== event.artifacts.length) {
53
+ throw new TypeError('Analysis completion identity does not match the selected work.');
54
+ }
55
+ return singleAttemptResult({
56
+ ...event.result,
57
+ id: testCase.id,
58
+ workId: testCase.workId,
59
+ definitionLocations: testCase.definitionLocations
60
+ }, attempt);
61
+ }
62
+ function eventWork(event) {
63
+ return (event.kind === 'case-end' ? event.result : event).workId;
64
+ }
65
+ export function createFamilyEvidenceState(testPlan) {
66
+ const selected = new Map(testPlan.cases.map(function byIdentity(testCase) {
67
+ return [workIdentityKey(testCase.workId), testCase];
68
+ }));
69
+ const states = new Map();
70
+ const completed = new Map();
71
+ const artifactStore = createArtifactStore(states);
72
+ return {
73
+ caseFor(event) {
74
+ const key = workIdentityKey(eventWork(event));
75
+ const testCase = selected.get(key);
76
+ const expected = event.kind === 'case-start' ? 'pending' : 'active';
77
+ if (testCase?.execution.kind !== 'body' || (states.get(key) ?? 'pending') !== expected) {
78
+ throw new TypeError('Analysis event is out of order or refers to unknown selected work.');
79
+ }
80
+ return testCase;
81
+ },
82
+ start(testCase) {
83
+ states.set(workIdentityKey(testCase.workId), 'active');
84
+ },
85
+ finish(testCase, event) {
86
+ const result = completionResult(testCase, event);
87
+ artifactStore.record(event.artifacts);
88
+ const key = workIdentityKey(testCase.workId);
89
+ states.set(key, 'completed');
90
+ completed.set(key, result);
91
+ return { result, artifacts: artifactStore.forWork(key) };
92
+ },
93
+ recordArtifacts: artifactStore.record,
94
+ artifacts: artifactStore.all,
95
+ results(skipped) {
96
+ return Array.from(selected.keys()).flatMap(function orderedResult(key) {
97
+ const result = completed.get(key) ?? skipped.get(key);
98
+ return result === undefined ? [] : [result];
99
+ });
100
+ }
101
+ };
102
+ }
103
+ export function completeFamilyResults(plan, results) {
104
+ const completed = new Map(results.map(function byWork(result) {
105
+ return [workIdentityKey(result.workId), result];
106
+ }));
107
+ return plan.cases.map(function complete(testCase) {
108
+ const result = completed.get(workIdentityKey(testCase.workId));
109
+ if (result !== undefined) {
110
+ return result;
111
+ }
112
+ const outcome = testCase.execution.kind === 'skip'
113
+ ? { kind: 'skip', reason: testCase.execution.reason }
114
+ : { kind: 'inconclusive', reason: 'Family execution ended without complete evidence.' };
115
+ return singleAttemptResult({
116
+ id: testCase.id,
117
+ workId: testCase.workId,
118
+ definitionLocations: testCase.definitionLocations,
119
+ outcome,
120
+ verdict: outcome.kind,
121
+ durationMicroseconds: 0
122
+ }, { index: 0 });
123
+ });
124
+ }
125
+ //# sourceMappingURL=family-evidence-state.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"family-evidence-state.js","sourceRoot":"","sources":["../../../../source/engine/family-evidence-state.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,179 @@
1
+ import pLimit from 'p-limit';
2
+ import { createFamilyEvidenceState, completeFamilyResults } from "./family-evidence-state.js";
3
+ import { familyEventSchema } from "./family-evidence-schema.js";
4
+ import { workIdentityKey } from "./identity.js";
5
+ import { reportSuiteTransition } from "./reporter-event-queue.js";
6
+ import { reportRunnerErrors } from "./runner-error-reporting.js";
7
+ import { singleAttemptResult } from "./run-result.js";
8
+ function evidenceError(cause) {
9
+ return {
10
+ attributedTo: null,
11
+ attributedToAttempt: null,
12
+ cause,
13
+ diagnostics: [],
14
+ message: cause instanceof Error ? cause.message : 'Analysis family execution failed.',
15
+ subtype: 'runtime-state'
16
+ };
17
+ }
18
+ function createEvidenceDelivery(reporter) {
19
+ const errors = [];
20
+ let suite = [];
21
+ async function transition(next) {
22
+ const previous = suite;
23
+ suite = next;
24
+ errors.push(...await reportSuiteTransition(reporter, previous, next));
25
+ }
26
+ return {
27
+ async start(testCase) {
28
+ await transition(testCase.suitePath);
29
+ errors.push(...await reporter.reportEvent({
30
+ kind: 'test-start',
31
+ attempt: 0,
32
+ case: testCase.id,
33
+ workId: testCase.workId,
34
+ definitionLocations: testCase.definitionLocations,
35
+ suitePath: testCase.suitePath
36
+ }));
37
+ },
38
+ async progress(testCase, note) {
39
+ await transition(testCase.suitePath);
40
+ errors.push(...await reporter.reportEvent({
41
+ kind: 'test-progress',
42
+ attempt: 0,
43
+ case: testCase.id,
44
+ workId: testCase.workId,
45
+ definitionLocations: testCase.definitionLocations,
46
+ suitePath: testCase.suitePath,
47
+ note
48
+ }));
49
+ },
50
+ async end(testCase, result, artifacts) {
51
+ await transition(testCase.suitePath);
52
+ errors.push(...await reporter.reportEvent({
53
+ kind: 'test-end',
54
+ attempt: 0,
55
+ case: testCase.id,
56
+ workId: testCase.workId,
57
+ definitionLocations: testCase.definitionLocations,
58
+ suitePath: testCase.suitePath,
59
+ completion: 'final',
60
+ property: null,
61
+ benchmark: null,
62
+ artifacts,
63
+ outcome: result.outcome,
64
+ verdict: result.verdict,
65
+ durationMicroseconds: result.durationMicroseconds
66
+ }));
67
+ },
68
+ async error(error) {
69
+ errors.push(...await reportRunnerErrors(reporter, [error]));
70
+ },
71
+ async finish() {
72
+ await transition([]);
73
+ return errors;
74
+ }
75
+ };
76
+ }
77
+ async function acceptCase(event, state, delivery) {
78
+ const testCase = state.caseFor(event);
79
+ if (event.kind === 'case-start') {
80
+ state.start(testCase);
81
+ await delivery.start(testCase);
82
+ }
83
+ else if (event.kind === 'case-progress') {
84
+ await delivery.progress(testCase, event.note);
85
+ }
86
+ else {
87
+ const { result, artifacts } = state.finish(testCase, event);
88
+ await delivery.end(testCase, result, artifacts);
89
+ }
90
+ }
91
+ async function accept(event, state, delivery) {
92
+ if (event.kind === 'artifact') {
93
+ state.recordArtifacts([event.artifact]);
94
+ return;
95
+ }
96
+ if (event.kind === 'run-error') {
97
+ await delivery.error(event.error);
98
+ return;
99
+ }
100
+ await acceptCase(event, state, delivery);
101
+ }
102
+ async function completeSkips(plan, delivery) {
103
+ const results = new Map();
104
+ const skips = plan.cases.filter(function authoredSkip(testCase) {
105
+ return testCase.execution.kind === 'skip';
106
+ });
107
+ for (const testCase of skips) {
108
+ const result = singleAttemptResult({
109
+ id: testCase.id,
110
+ workId: testCase.workId,
111
+ definitionLocations: testCase.definitionLocations,
112
+ outcome: { kind: 'skip', reason: testCase.execution.reason },
113
+ verdict: 'skip',
114
+ durationMicroseconds: 0
115
+ }, { index: 0 });
116
+ await delivery.start(testCase);
117
+ await delivery.end(testCase, result, []);
118
+ results.set(workIdentityKey(testCase.workId), result);
119
+ }
120
+ return results;
121
+ }
122
+ export async function executeFamilyAnalysis(testPlan, reporter, execute, signal) {
123
+ const state = createFamilyEvidenceState(testPlan);
124
+ const delivery = createEvidenceDelivery(reporter);
125
+ const serial = pLimit(1);
126
+ let accepting = true;
127
+ async function report(event) {
128
+ try {
129
+ signal.throwIfAborted();
130
+ await accept(familyEventSchema.parse(event), state, delivery);
131
+ }
132
+ catch (error) {
133
+ await delivery.error(evidenceError(error));
134
+ }
135
+ }
136
+ async function runBackend() {
137
+ if (execute !== null) {
138
+ try {
139
+ signal.throwIfAborted();
140
+ await execute({
141
+ signal,
142
+ async report(event) {
143
+ if (!accepting) {
144
+ throw new TypeError('Family execution has already settled.');
145
+ }
146
+ await serial(report, event);
147
+ }
148
+ });
149
+ signal.throwIfAborted();
150
+ }
151
+ catch (error) {
152
+ accepting = false;
153
+ await serial(delivery.error, evidenceError(error));
154
+ }
155
+ finally {
156
+ accepting = false;
157
+ }
158
+ }
159
+ accepting = false;
160
+ await serial(async function drainReports() {
161
+ return undefined;
162
+ });
163
+ }
164
+ await runBackend();
165
+ async function finish() {
166
+ const skipped = await serial(completeSkips, testPlan, delivery);
167
+ const results = state.results(skipped);
168
+ if (results.length !== testPlan.cases.length) {
169
+ await delivery.error(evidenceError(new Error('Family execution ended without complete evidence.')));
170
+ }
171
+ return {
172
+ artifacts: state.artifacts(),
173
+ perTest: completeFamilyResults(testPlan, results),
174
+ reporterErrors: await delivery.finish()
175
+ };
176
+ }
177
+ return await finish();
178
+ }
179
+ //# sourceMappingURL=family-evidence.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"family-evidence.js","sourceRoot":"","sources":["../../../../source/engine/family-evidence.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAA4B,MAAM,4BAA4B,CAAC;AACxH,OAAO,EAAE,iBAAiB,EAAsB,MAAM,6BAA6B,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAA0D,MAAM,iBAAiB,CAAC;AAU9G,SAAS,aAAa,CAAC,KAAc;IACjC,OAAO;QACH,YAAY,EAAE,IAAI;QAClB,mBAAmB,EAAE,IAAI;QACzB,KAAK;QACL,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,mCAAmC;QACrF,OAAO,EAAE,eAAe;KAC3B,CAAC;AACN,CAAC;AAUD,SAAS,sBAAsB,CAAC,QAA0B;IACtD,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,IAAI,KAAK,GAA8B,EAAE,CAAC;IAC1C,KAAK,UAAU,UAAU,CAAC,IAA+B;QACrD,MAAM,QAAQ,GAAG,KAAK,CAAC;QACvB,KAAK,GAAG,IAAI,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO;QACH,KAAK,CAAC,KAAK,CAAC,QAAQ;YAChB,MAAM,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YACrC,MAAM,CAAC,IAAI,CACP,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC;gBAC1B,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,CAAC;gBACV,IAAI,EAAE,QAAQ,CAAC,EAAE;gBACjB,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB;gBACjD,SAAS,EAAE,QAAQ,CAAC,SAAS;aAChC,CAAC,CACL,CAAC;QACN,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI;YACzB,MAAM,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YACrC,MAAM,CAAC,IAAI,CACP,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC;gBAC1B,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,CAAC;gBACV,IAAI,EAAE,QAAQ,CAAC,EAAE;gBACjB,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB;gBACjD,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,IAAI;aACP,CAAC,CACL,CAAC;QACN,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS;YACjC,MAAM,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YACrC,MAAM,CAAC,IAAI,CACP,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC;gBAC1B,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,CAAC;gBACV,IAAI,EAAE,QAAQ,CAAC,EAAE;gBACjB,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB;gBACjD,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,UAAU,EAAE,OAAO;gBACnB,QAAQ,EAAE,IAAI;gBACd,SAAS,EAAE,IAAI;gBACf,SAAS;gBACT,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;aACpD,CAAC,CACL,CAAC;QACN,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,KAAK;YACb,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,kBAAkB,CAAC,QAAQ,EAAE,CAAE,KAAK,CAAE,CAAC,CAAC,CAAC;QAClE,CAAC;QACD,KAAK,CAAC,MAAM;YACR,MAAM,UAAU,CAAC,EAAE,CAAC,CAAC;YACrB,OAAO,MAAM,CAAC;QAClB,CAAC;KACJ,CAAC;AACN,CAAC;AAED,KAAK,UAAU,UAAU,CACrB,KAA2E,EAC3E,KAA0B,EAC1B,QAA0B;IAE1B,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAC9B,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtB,MAAM,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;SAAM,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;QACxC,MAAM,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;SAAM,CAAC;QACJ,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC5D,MAAM,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IACpD,CAAC;AACL,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,KAAoB,EAAE,KAA0B,EAAE,QAA0B;IAC9F,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC5B,KAAK,CAAC,eAAe,CAAC,CAAE,KAAK,CAAC,QAAQ,CAAE,CAAC,CAAC;QAC1C,OAAO;IACX,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAC7B,MAAM,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClC,OAAO;IACX,CAAC;IACD,MAAM,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;AAC7C,CAAC;AAED,KAAK,UAAU,aAAa,CACxB,IAAc,EACd,QAA0B;IAE1B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAyB,CAAC;IACjD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,YAAY,CACjD,QAAQ;QAER,OAAO,QAAQ,CAAC,SAAS,CAAC,IAAI,KAAK,MAAM,CAAC;IAC9C,CAAC,CAAC,CAAC;IACH,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,mBAAmB,CAAC;YAC/B,EAAE,EAAE,QAAQ,CAAC,EAAE;YACf,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB;YACjD,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE;YAC5D,OAAO,EAAE,MAAM;YACf,oBAAoB,EAAE,CAAC;SAC1B,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QACjB,MAAM,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC/B,MAAM,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACvC,QAAkB,EAClB,QAA0B,EAC1B,OAAmE,EACnE,MAAmB;IAEnB,MAAM,KAAK,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,SAAS,GAAG,IAAI,CAAC;IACrB,KAAK,UAAU,MAAM,CAAC,KAAkB;QACpC,IAAI,CAAC;YACD,MAAM,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,MAAM,CAAC,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QAClE,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACtB,MAAM,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/C,CAAC;IACL,CAAC;IACD,KAAK,UAAU,UAAU;QACrB,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACnB,IAAI,CAAC;gBACD,MAAM,CAAC,cAAc,EAAE,CAAC;gBACxB,MAAM,OAAO,CAAC;oBACV,MAAM;oBACN,KAAK,CAAC,MAAM,CAAC,KAAK;wBACd,IAAI,CAAC,SAAS,EAAE,CAAC;4BACb,MAAM,IAAI,SAAS,CAAC,uCAAuC,CAAC,CAAC;wBACjE,CAAC;wBACD,MAAM,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;oBAChC,CAAC;iBACJ,CAAC,CAAC;gBACH,MAAM,CAAC,cAAc,EAAE,CAAC;YAC5B,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACtB,SAAS,GAAG,KAAK,CAAC;gBAClB,MAAM,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;YACvD,CAAC;oBAAS,CAAC;gBACP,SAAS,GAAG,KAAK,CAAC;YACtB,CAAC;QACL,CAAC;QACD,SAAS,GAAG,KAAK,CAAC;QAClB,MAAM,MAAM,CAAC,KAAK,UAAU,YAAY;YACpC,OAAO,SAAS,CAAC;QACrB,CAAC,CAAC,CAAC;IACP,CAAC;IACD,MAAM,UAAU,EAAE,CAAC;IACnB,KAAK,UAAU,MAAM;QACjB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,aAAa,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAC3C,MAAM,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC,CAAC,CAAC;QACxG,CAAC;QACD,OAAO;YACH,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE;YAC5B,OAAO,EAAE,qBAAqB,CAAC,QAAQ,EAAE,OAAO,CAAC;YACjD,cAAc,EAAE,MAAM,QAAQ,CAAC,MAAM,EAAE;SAC1C,CAAC;IACN,CAAC;IACD,OAAO,MAAM,MAAM,EAAE,CAAC;AAC1B,CAAC"}
@@ -0,0 +1,41 @@
1
+ import { completeFamilyResults } from "./family-evidence-state.js";
2
+ import { executeFamilyAnalysis } from "./family-evidence.js";
3
+ import { executeTestPlanCasesAndMeasureProcessUsage } from "./execution-test-plan-process-usage.js";
4
+ async function executeRuntimeWork(input) {
5
+ const { family, testPlan, options, context: { dependencies, reporterDelivery } } = input;
6
+ const runtime = await executeTestPlanCasesAndMeasureProcessUsage(testPlan, options, { dependencies, reporterDelivery, signal: family?.signal ?? null });
7
+ return {
8
+ ...runtime,
9
+ executedTestPlan: {
10
+ ...runtime.executedTestPlan,
11
+ perTest: family === null || runtime.executedTestPlan.stoppedByPolicy && !family.signal.aborted
12
+ ? runtime.executedTestPlan.perTest
13
+ : completeFamilyResults(testPlan, runtime.executedTestPlan.perTest),
14
+ artifacts: []
15
+ }
16
+ };
17
+ }
18
+ async function executeUnobservedWork(input) {
19
+ const { family, testPlan, context: { dependencies, reporterDelivery } } = input;
20
+ if (family?.family.features.execution !== 'analysis') {
21
+ return await executeRuntimeWork(input);
22
+ }
23
+ const analysisStarted = Number(dependencies.wallClock.currentMonotonicMicroseconds);
24
+ const evidence = await executeFamilyAnalysis(testPlan, reporterDelivery, family.collection?.kind === 'analysis' ? family.collection.execute : null, family.signal);
25
+ return {
26
+ executedTestPlan: {
27
+ stoppedByPolicy: false,
28
+ ...evidence,
29
+ testExecutionWallTimeMicroseconds: Number(dependencies.wallClock.currentMonotonicMicroseconds) -
30
+ analysisStarted
31
+ },
32
+ processUsage: null
33
+ };
34
+ }
35
+ export async function executeFamilyWork(input) {
36
+ async function execute() {
37
+ return await executeUnobservedWork(input);
38
+ }
39
+ return input.family === null ? await execute() : await input.family.lifetime.observe(execute);
40
+ }
41
+ //# sourceMappingURL=family-execution.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"family-execution.js","sourceRoot":"","sources":["../../../../source/engine/family-execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAI7D,OAAO,EAAE,0CAA0C,EAAE,MAAM,wCAAwC,CAAC;AAoBpG,KAAK,UAAU,kBAAkB,CAAC,KAAyB;IACvD,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,YAAY,EAAE,gBAAgB,EAAE,EAAE,GAAG,KAAK,CAAC;IACzF,MAAM,OAAO,GAAG,MAAM,0CAA0C,CAC5D,QAAQ,EACR,OAAO,EACP,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,IAAI,EAAE,CACrE,CAAC;IACF,OAAO;QACH,GAAG,OAAO;QACV,gBAAgB,EAAE;YACd,GAAG,OAAO,CAAC,gBAAgB;YAC3B,OAAO,EAAE,MAAM,KAAK,IAAI,IAAI,OAAO,CAAC,gBAAgB,CAAC,eAAe,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO;gBAC1F,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,OAAO;gBAClC,CAAC,CAAC,qBAAqB,CAAC,QAAQ,EAAE,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC;YACvE,SAAS,EAAE,EAAE;SAChB;KACJ,CAAC;AACN,CAAC;AAED,KAAK,UAAU,qBAAqB,CAAC,KAAyB;IAC1D,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,YAAY,EAAE,gBAAgB,EAAE,EAAE,GAAG,KAAK,CAAC;IAChF,IAAI,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QACnD,OAAO,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;IACD,MAAM,eAAe,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,4BAA4B,CAAC,CAAC;IACpF,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CACxC,QAAQ,EACR,gBAAgB,EAChB,MAAM,CAAC,UAAU,EAAE,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EACzE,MAAM,CAAC,MAAM,CAChB,CAAC;IACF,OAAO;QACH,gBAAgB,EAAE;YACd,eAAe,EAAE,KAAK;YACtB,GAAG,QAAQ;YACX,iCAAiC,EAAE,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,4BAA4B,CAAC;gBAC1F,eAAe;SACtB;QACD,YAAY,EAAE,IAAI;KACrB,CAAC;AACN,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAyB;IAC7D,KAAK,UAAU,OAAO;QAClB,OAAO,MAAM,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAClG,CAAC"}
@@ -0,0 +1,11 @@
1
+ type FamilyPhase = 'collected' | 'collecting' | 'disposed' | 'disposing' | 'executing' | 'prepared';
2
+ export type FamilyLifetime = {
3
+ readonly signal: AbortSignal;
4
+ readonly claim: (expected: FamilyPhase, next: FamilyPhase) => void;
5
+ readonly collected: () => void;
6
+ readonly observe: <Value>(operation: () => Promise<Value>) => Promise<Value>;
7
+ readonly abandon: () => Promise<void>;
8
+ readonly disposeOnce: () => Promise<readonly unknown[]>;
9
+ };
10
+ export {};
11
+ //# sourceMappingURL=family-lifetime.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"family-lifetime.d.ts","sourceRoot":"","sources":["../../../../source/engine/family-lifetime.ts"],"names":[],"mappings":"AAEA,KAAK,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,CAAC;AAEpG,MAAM,MAAM,cAAc,GAAG;IACzB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;IACnE,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7E,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;CAC3D,CAAC;AAEF"}
@@ -0,0 +1,72 @@
1
+ import { createStoredValue } from "../stored-value.js";
2
+ export function createFamilyLifetime(dispose) {
3
+ const phase = createStoredValue('prepared');
4
+ const activity = createStoredValue(Promise.resolve());
5
+ const disposal = createStoredValue(null);
6
+ const controller = new AbortController();
7
+ async function cleanup() {
8
+ await activity.read();
9
+ try {
10
+ await dispose();
11
+ return [];
12
+ }
13
+ catch (error) {
14
+ return [error];
15
+ }
16
+ finally {
17
+ phase.write('disposed');
18
+ }
19
+ }
20
+ async function disposeOnce() {
21
+ const existing = disposal.read();
22
+ if (existing !== null) {
23
+ return existing;
24
+ }
25
+ phase.write('disposing');
26
+ const pending = cleanup();
27
+ disposal.write(pending);
28
+ return pending;
29
+ }
30
+ return {
31
+ signal: controller.signal,
32
+ claim(expected, next) {
33
+ if (phase.read() !== expected) {
34
+ throw new TypeError('Family value has already been consumed or disposed.');
35
+ }
36
+ phase.write(next);
37
+ },
38
+ collected() {
39
+ controller.signal.throwIfAborted();
40
+ phase.write('collected');
41
+ },
42
+ async observe(operation) {
43
+ const pending = Promise.withResolvers();
44
+ activity.write(pending.promise);
45
+ try {
46
+ return await operation();
47
+ }
48
+ finally {
49
+ pending.resolve(undefined);
50
+ }
51
+ },
52
+ async abandon() {
53
+ if (phase.read() === 'disposed') {
54
+ return;
55
+ }
56
+ controller.abort();
57
+ const errors = await disposeOnce();
58
+ if (errors.length > 0) {
59
+ throw new AggregateError(errors, 'Family cleanup failed.');
60
+ }
61
+ },
62
+ disposeOnce
63
+ };
64
+ }
65
+ export async function rejectWithFamilyCleanup(error, lifetime) {
66
+ const errors = await lifetime.disposeOnce();
67
+ if (errors.length > 0) {
68
+ throw new AggregateError([error, ...errors], 'Family operation and cleanup failed.', { cause: error });
69
+ }
70
+ throw error;
71
+ }
72
+ //# sourceMappingURL=family-lifetime.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"family-lifetime.js","sourceRoot":"","sources":["../../../../source/engine/family-lifetime.ts"],"names":[],"mappings":"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"}