@riddledc/riddle-proof 0.7.7 → 0.7.9

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 (21) hide show
  1. package/README.md +16 -4
  2. package/dist/basic-gameplay.cjs +4 -0
  3. package/dist/basic-gameplay.d.cts +1 -1
  4. package/dist/basic-gameplay.d.ts +1 -1
  5. package/dist/basic-gameplay.js +1 -1
  6. package/dist/{chunk-AHW7SL3W.js → chunk-5A4SL6CX.js} +4 -0
  7. package/dist/{chunk-7NMAU4DP.js → chunk-NUSUGO2P.js} +221 -2
  8. package/dist/cli.cjs +220 -2
  9. package/dist/cli.js +1 -1
  10. package/dist/index.cjs +226 -2
  11. package/dist/index.d.cts +1 -1
  12. package/dist/index.d.ts +1 -1
  13. package/dist/index.js +4 -2
  14. package/dist/profile.cjs +222 -2
  15. package/dist/profile.d.cts +17 -1
  16. package/dist/profile.d.ts +17 -1
  17. package/dist/profile.js +3 -1
  18. package/dist/proof-run-engine.d.cts +3 -3
  19. package/dist/proof-run-engine.d.ts +3 -3
  20. package/examples/profiles/page-content-basic.json +4 -1
  21. package/package.json +1 -1
package/dist/profile.d.cts CHANGED
@@ -5,8 +5,10 @@ declare const RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION: "riddle-proof.profile-evide
5
5
  declare const RIDDLE_PROOF_PROFILE_RESULT_VERSION: "riddle-proof.profile-result.v1";
6
6
  declare const RIDDLE_PROOF_PROFILE_STATUSES: readonly ["passed", "product_regression", "proof_insufficient", "environment_blocked", "configuration_error", "needs_human_review"];
7
7
  declare const RIDDLE_PROOF_PROFILE_CHECK_TYPES: readonly ["route_loaded", "selector_visible", "selector_count_at_least", "text_visible", "text_absent", "no_horizontal_overflow", "no_mobile_horizontal_overflow", "no_fatal_console_errors"];
8
+ declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "wait", "wait_for_selector", "wait_for_text"];
8
9
  type RiddleProofProfileStatus = typeof RIDDLE_PROOF_PROFILE_STATUSES[number];
9
10
  type RiddleProofProfileCheckType = typeof RIDDLE_PROOF_PROFILE_CHECK_TYPES[number];
11
+ type RiddleProofProfileSetupActionType = typeof RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES[number];
10
12
  type RiddleProofProfileRunner = "riddle" | "local-playwright" | "browserless" | "github-actions" | (string & {});
11
13
  type RiddleProofProfileFailureAction = "fail" | "neutral" | "review";
12
14
  type RiddleProofProfileBaselinePolicy = "invariant_only" | "production_comparison" | "last_accepted_artifact" | "golden_reference_artifact" | (string & {});
@@ -15,6 +17,18 @@ interface RiddleProofProfileViewport {
15
17
  width: number;
16
18
  height: number;
17
19
  }
20
+ interface RiddleProofProfileSetupAction {
21
+ type: RiddleProofProfileSetupActionType;
22
+ selector?: string;
23
+ text?: string;
24
+ pattern?: string;
25
+ flags?: string;
26
+ index?: number;
27
+ ms?: number;
28
+ timeout_ms?: number;
29
+ after_ms?: number;
30
+ continue_on_failure?: boolean;
31
+ }
18
32
  interface RiddleProofProfileTarget {
19
33
  url?: string;
20
34
  route?: string;
@@ -22,6 +36,7 @@ interface RiddleProofProfileTarget {
22
36
  auth?: "none" | (string & {});
23
37
  wait_for_selector?: string;
24
38
  wait_ms?: number;
39
+ setup_actions?: RiddleProofProfileSetupAction[];
25
40
  }
26
41
  interface RiddleProofProfileCheck {
27
42
  type: RiddleProofProfileCheckType;
@@ -69,6 +84,7 @@ interface RiddleProofProfileViewportEvidence {
69
84
  visible_count: number;
70
85
  }>;
71
86
  text_matches?: Record<string, boolean>;
87
+ setup_action_results?: Array<Record<string, JsonValue>>;
72
88
  screenshot_label?: string;
73
89
  navigation_error?: string;
74
90
  wait_error?: string;
@@ -172,4 +188,4 @@ declare function buildRiddleProofProfileScript(profile: RiddleProofProfile): str
172
188
  declare function collectRiddleProfileArtifactRefs(input: unknown): RiddleProofProfileArtifactRef[];
173
189
  declare function extractRiddleProofProfileResult(input: unknown): RiddleProofProfileResult | undefined;
174
190
 
175
- export { type NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, type RiddleProofProfile, type RiddleProofProfileArtifactRef, type RiddleProofProfileBaselinePolicy, type RiddleProofProfileCheck, type RiddleProofProfileCheckResult, type RiddleProofProfileCheckType, type RiddleProofProfileEvidence, type RiddleProofProfileFailureAction, type RiddleProofProfileResult, type RiddleProofProfileRouteEvidence, type RiddleProofProfileRunner, type RiddleProofProfileStatus, type RiddleProofProfileTarget, type RiddleProofProfileViewport, type RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, extractRiddleProofProfileResult, normalizeRiddleProofProfile, profileStatusExitCode, resolveRiddleProofProfileTargetUrl, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult };
191
+ export { type NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, type RiddleProofProfile, type RiddleProofProfileArtifactRef, type RiddleProofProfileBaselinePolicy, type RiddleProofProfileCheck, type RiddleProofProfileCheckResult, type RiddleProofProfileCheckType, type RiddleProofProfileEvidence, type RiddleProofProfileFailureAction, type RiddleProofProfileResult, type RiddleProofProfileRouteEvidence, type RiddleProofProfileRunner, type RiddleProofProfileSetupAction, type RiddleProofProfileSetupActionType, type RiddleProofProfileStatus, type RiddleProofProfileTarget, type RiddleProofProfileViewport, type RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, extractRiddleProofProfileResult, normalizeRiddleProofProfile, profileStatusExitCode, resolveRiddleProofProfileTargetUrl, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult };
package/dist/profile.d.ts CHANGED
@@ -5,8 +5,10 @@ declare const RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION: "riddle-proof.profile-evide
5
5
  declare const RIDDLE_PROOF_PROFILE_RESULT_VERSION: "riddle-proof.profile-result.v1";
6
6
  declare const RIDDLE_PROOF_PROFILE_STATUSES: readonly ["passed", "product_regression", "proof_insufficient", "environment_blocked", "configuration_error", "needs_human_review"];
7
7
  declare const RIDDLE_PROOF_PROFILE_CHECK_TYPES: readonly ["route_loaded", "selector_visible", "selector_count_at_least", "text_visible", "text_absent", "no_horizontal_overflow", "no_mobile_horizontal_overflow", "no_fatal_console_errors"];
8
+ declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "wait", "wait_for_selector", "wait_for_text"];
8
9
  type RiddleProofProfileStatus = typeof RIDDLE_PROOF_PROFILE_STATUSES[number];
9
10
  type RiddleProofProfileCheckType = typeof RIDDLE_PROOF_PROFILE_CHECK_TYPES[number];
11
+ type RiddleProofProfileSetupActionType = typeof RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES[number];
10
12
  type RiddleProofProfileRunner = "riddle" | "local-playwright" | "browserless" | "github-actions" | (string & {});
11
13
  type RiddleProofProfileFailureAction = "fail" | "neutral" | "review";
12
14
  type RiddleProofProfileBaselinePolicy = "invariant_only" | "production_comparison" | "last_accepted_artifact" | "golden_reference_artifact" | (string & {});
@@ -15,6 +17,18 @@ interface RiddleProofProfileViewport {
15
17
  width: number;
16
18
  height: number;
17
19
  }
20
+ interface RiddleProofProfileSetupAction {
21
+ type: RiddleProofProfileSetupActionType;
22
+ selector?: string;
23
+ text?: string;
24
+ pattern?: string;
25
+ flags?: string;
26
+ index?: number;
27
+ ms?: number;
28
+ timeout_ms?: number;
29
+ after_ms?: number;
30
+ continue_on_failure?: boolean;
31
+ }
18
32
  interface RiddleProofProfileTarget {
19
33
  url?: string;
20
34
  route?: string;
@@ -22,6 +36,7 @@ interface RiddleProofProfileTarget {
22
36
  auth?: "none" | (string & {});
23
37
  wait_for_selector?: string;
24
38
  wait_ms?: number;
39
+ setup_actions?: RiddleProofProfileSetupAction[];
25
40
  }
26
41
  interface RiddleProofProfileCheck {
27
42
  type: RiddleProofProfileCheckType;
@@ -69,6 +84,7 @@ interface RiddleProofProfileViewportEvidence {
69
84
  visible_count: number;
70
85
  }>;
71
86
  text_matches?: Record<string, boolean>;
87
+ setup_action_results?: Array<Record<string, JsonValue>>;
72
88
  screenshot_label?: string;
73
89
  navigation_error?: string;
74
90
  wait_error?: string;
@@ -172,4 +188,4 @@ declare function buildRiddleProofProfileScript(profile: RiddleProofProfile): str
172
188
  declare function collectRiddleProfileArtifactRefs(input: unknown): RiddleProofProfileArtifactRef[];
173
189
  declare function extractRiddleProofProfileResult(input: unknown): RiddleProofProfileResult | undefined;
174
190
 
175
- export { type NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, type RiddleProofProfile, type RiddleProofProfileArtifactRef, type RiddleProofProfileBaselinePolicy, type RiddleProofProfileCheck, type RiddleProofProfileCheckResult, type RiddleProofProfileCheckType, type RiddleProofProfileEvidence, type RiddleProofProfileFailureAction, type RiddleProofProfileResult, type RiddleProofProfileRouteEvidence, type RiddleProofProfileRunner, type RiddleProofProfileStatus, type RiddleProofProfileTarget, type RiddleProofProfileViewport, type RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, extractRiddleProofProfileResult, normalizeRiddleProofProfile, profileStatusExitCode, resolveRiddleProofProfileTargetUrl, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult };
191
+ export { type NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, type RiddleProofProfile, type RiddleProofProfileArtifactRef, type RiddleProofProfileBaselinePolicy, type RiddleProofProfileCheck, type RiddleProofProfileCheckResult, type RiddleProofProfileCheckType, type RiddleProofProfileEvidence, type RiddleProofProfileFailureAction, type RiddleProofProfileResult, type RiddleProofProfileRouteEvidence, type RiddleProofProfileRunner, type RiddleProofProfileSetupAction, type RiddleProofProfileSetupActionType, type RiddleProofProfileStatus, type RiddleProofProfileTarget, type RiddleProofProfileViewport, type RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, extractRiddleProofProfileResult, normalizeRiddleProofProfile, profileStatusExitCode, resolveRiddleProofProfileTargetUrl, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult };
package/dist/profile.js CHANGED
@@ -2,6 +2,7 @@ import {
2
2
  RIDDLE_PROOF_PROFILE_CHECK_TYPES,
3
3
  RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,
4
4
  RIDDLE_PROOF_PROFILE_RESULT_VERSION,
5
+ RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES,
5
6
  RIDDLE_PROOF_PROFILE_STATUSES,
6
7
  RIDDLE_PROOF_PROFILE_VERSION,
7
8
  assessRiddleProofProfileEvidence,
@@ -16,11 +17,12 @@ import {
16
17
  resolveRiddleProofProfileTargetUrl,
17
18
  slugifyRiddleProofProfileName,
18
19
  summarizeRiddleProofProfileResult
19
- } from "./chunk-7NMAU4DP.js";
20
+ } from "./chunk-NUSUGO2P.js";
20
21
  export {
21
22
  RIDDLE_PROOF_PROFILE_CHECK_TYPES,
22
23
  RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,
23
24
  RIDDLE_PROOF_PROFILE_RESULT_VERSION,
25
+ RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES,
24
26
  RIDDLE_PROOF_PROFILE_STATUSES,
25
27
  RIDDLE_PROOF_PROFILE_VERSION,
26
28
  assessRiddleProofProfileEvidence,
package/dist/proof-run-engine.d.cts CHANGED
@@ -292,7 +292,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
292
292
  blocking?: boolean;
293
293
  details?: Record<string, unknown>;
294
294
  ok: boolean;
295
- action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
295
+ action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
296
296
  state_path: string;
297
297
  stage: any;
298
298
  summary: string;
@@ -382,7 +382,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
382
382
  continueWithStage?: WorkflowStage | null;
383
383
  blocking?: boolean;
384
384
  details?: Record<string, unknown>;
385
- action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
385
+ action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
386
386
  state_path: string;
387
387
  stage: any;
388
388
  checkpoint: string;
@@ -659,7 +659,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
659
659
  error?: undefined;
660
660
  } | {
661
661
  ok: boolean;
662
- action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
662
+ action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
663
663
  state_path: string;
664
664
  stage: any;
665
665
  summary: string;
package/dist/proof-run-engine.d.ts CHANGED
@@ -292,7 +292,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
292
292
  blocking?: boolean;
293
293
  details?: Record<string, unknown>;
294
294
  ok: boolean;
295
- action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
295
+ action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
296
296
  state_path: string;
297
297
  stage: any;
298
298
  summary: string;
@@ -382,7 +382,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
382
382
  continueWithStage?: WorkflowStage | null;
383
383
  blocking?: boolean;
384
384
  details?: Record<string, unknown>;
385
- action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
385
+ action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
386
386
  state_path: string;
387
387
  stage: any;
388
388
  checkpoint: string;
@@ -659,7 +659,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
659
659
  error?: undefined;
660
660
  } | {
661
661
  ok: boolean;
662
- action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
662
+ action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
663
663
  state_path: string;
664
664
  stage: any;
665
665
  summary: string;
package/examples/profiles/page-content-basic.json CHANGED
@@ -8,7 +8,10 @@
8
8
  { "name": "desktop", "width": 1440, "height": 1000 }
9
9
  ],
10
10
  "auth": "none",
11
- "wait_for_selector": "body"
11
+ "wait_for_selector": "body",
12
+ "setup_actions": [
13
+ { "type": "wait", "ms": 250 }
14
+ ]
12
15
  },
13
16
  "checks": [
14
17
  { "type": "route_loaded", "expected_path": "/" },
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@riddledc/riddle-proof",
3
- "version": "0.7.7",
3
+ "version": "0.7.9",
4
4
  "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
5
5
  "license": "MIT",
6
6
  "author": "RiddleDC",