@seriousgaming/sdk-tools 1.7.0 → 1.8.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.
- package/dist/agent/guidance.md +1 -0
- package/dist/{cli-ZTZ5H55T.js → cli-27M4PX7O.js} +17 -17
- package/dist/{cli-2BH7FX27.js → cli-2FXZZLCL.js} +1 -1
- package/dist/{cli-HHPMAV4F.js → cli-2KDV2DYC.js} +3 -3
- package/dist/{cli-57V4ARER.js → cli-2QM63J3I.js} +1 -1
- package/dist/{cli-TFMNNVJ7.js → cli-32NRB2IT.js} +15 -15
- package/dist/{cli-JPAXKLVT.js → cli-3HBYH4VF.js} +11 -11
- package/dist/{cli-JR5AZLLK.js → cli-3HPAKEJJ.js} +2 -2
- package/dist/{cli-3PIJLSRQ.js → cli-3HZGJRQW.js} +11 -11
- package/dist/{cli-BOXXMDSX.js → cli-3OCKRPXI.js} +18 -18
- package/dist/{cli-4CHKF4DQ.js → cli-3OVXQJEW.js} +2 -2
- package/dist/{cli-4UWFQNGF.js → cli-3VV2JLHX.js} +1 -1
- package/dist/{cli-EJVAQCMQ.js → cli-42ZUP4X3.js} +114 -5
- package/dist/{cli-CV4JGVJR.js → cli-4B5OBHSY.js} +19 -19
- package/dist/{cli-2DQJACAH.js → cli-4EMNCU63.js} +17 -17
- package/dist/cli-5CG6BMCY.js +36 -0
- package/dist/{cli-VYR326C6.js → cli-5FRKWNVP.js} +19 -19
- package/dist/{cli-TDYKRXUA.js → cli-5P66N5G6.js} +17 -17
- package/dist/{cli-ZRPWZOCW.js → cli-5SYPXJCB.js} +20 -16
- package/dist/{cli-TJ3PLRHF.js → cli-66AHBZRZ.js} +15 -15
- package/dist/{cli-M7WEAIRF.js → cli-6AGWTGTO.js} +106 -28
- package/dist/{cli-WG36UJRK.js → cli-6BAZE75K.js} +18 -18
- package/dist/{cli-VPON5HGB.js → cli-6FVHRL3H.js} +19 -19
- package/dist/{cli-QVASWX2A.js → cli-6GDPO5VU.js} +2 -2
- package/dist/{cli-TPNQLYPC.js → cli-6NBER36P.js} +1 -1
- package/dist/{cli-LQ4VSM5R.js → cli-726NJARI.js} +0 -0
- package/dist/{cli-GHLILDH7.js → cli-72DRYVTT.js} +13 -13
- package/dist/{cli-MMN4BPO4.js → cli-7CW2BBJG.js} +1 -1
- package/dist/{cli-FP32D3T6.js → cli-7GJGFILU.js} +15 -15
- package/dist/{cli-HYEU3QS6.js → cli-7NCVUM5U.js} +3 -3
- package/dist/cli-7S4G4EKK.js +110 -0
- package/dist/{cli-J4DKUUTK.js → cli-7V6GUIIS.js} +2 -2
- package/dist/{cli-N6H6T2E2.js → cli-AEAFLZGY.js} +12 -0
- package/dist/{cli-C47GJATR.js → cli-AGYCXRPR.js} +3 -3
- package/dist/{cli-XSVGKI3R.js → cli-BC4KKNLA.js} +1 -1
- package/dist/cli-BQ3FHENQ.js +16 -0
- package/dist/{cli-CXCL7VRK.js → cli-BXCCODYD.js} +20 -20
- package/dist/cli-C2XDL4LD.js +30 -0
- package/dist/{cli-MJUYJIEP.js → cli-C45A5VX6.js} +3 -3
- package/dist/{cli-64AA7367.js → cli-C7YZNPWX.js} +11 -11
- package/dist/{cli-ZKG3OPZ6.js → cli-CAX4CQTC.js} +13 -13
- package/dist/{cli-YOTGR3NB.js → cli-CVOLMK3Z.js} +1 -1
- package/dist/{cli-PKQNOGBO.js → cli-D3CZRXVJ.js} +63 -17
- package/dist/{cli-4YB3ROVR.js → cli-DMKRP33X.js} +1 -1
- package/dist/{cli-FZ7QAZZP.js → cli-DPFN2LIZ.js} +15 -15
- package/dist/{cli-7TOLC62D.js → cli-DT756M3Z.js} +20 -20
- package/dist/{cli-TIDQ4WUE.js → cli-DXHPYN4N.js} +1 -1
- package/dist/{cli-OANH3BTQ.js → cli-E665NKUQ.js} +5 -5
- package/dist/{cli-DEBCP7UH.js → cli-EK7CGMGS.js} +17 -17
- package/dist/{cli-PIO7NWMH.js → cli-ESU3J563.js} +15 -15
- package/dist/{cli-6HB6HTC6.js → cli-F47ELAXM.js} +47 -47
- package/dist/{cli-JIZTQVL2.js → cli-FH4WBZHA.js} +14 -14
- package/dist/{cli-JRMHSMYT.js → cli-FHKRO6OU.js} +19 -19
- package/dist/{cli-ESA6YNPF.js → cli-FSEDPZR5.js} +19 -19
- package/dist/{cli-G5DQGZ2E.js → cli-FV45UZQP.js} +19 -19
- package/dist/{cli-XR2XSWQN.js → cli-G7FX7ZIU.js} +12 -12
- package/dist/{cli-X7E3637I.js → cli-GFONBOJT.js} +50 -26
- package/dist/{cli-C5QOJJWX.js → cli-GHIMH6JU.js} +1 -1
- package/dist/{cli-T4HWGMY4.js → cli-HC7L5DXV.js} +15 -15
- package/dist/{cli-WU43JT4T.js → cli-HJPNNORV.js} +2 -2
- package/dist/{cli-SOMIB4B4.js → cli-HMEZHQBC.js} +17 -17
- package/dist/{cli-TFZ53OA2.js → cli-HQUVSAHY.js} +18 -18
- package/dist/{cli-MYJGMA6U.js → cli-IC5FOT2J.js} +1 -1
- package/dist/{cli-VL2P354N.js → cli-IVZ7AHUJ.js} +3 -3
- package/dist/{cli-B6YHEKIJ.js → cli-J2OTL6JH.js} +5 -5
- package/dist/{cli-NEOLMC2P.js → cli-JA6UFTSX.js} +17 -17
- package/dist/{cli-Z5HWENER.js → cli-JOXCAGM7.js} +19 -19
- package/dist/{cli-NOQBWJQN.js → cli-JQ6I5GGE.js} +3 -3
- package/dist/{cli-TDSQSCX4.js → cli-K6M6YB67.js} +1 -1
- package/dist/{cli-MYJGGLC5.js → cli-KFVA7DT3.js} +3 -3
- package/dist/{cli-DHOWZCXT.js → cli-KH6FKM5A.js} +15 -15
- package/dist/{cli-4VZIJYKU.js → cli-KMT235FV.js} +2 -2
- package/dist/{cli-6ZSMW4HR.js → cli-KU4PG7ZA.js} +15 -15
- package/dist/{cli-ATI6OLJU.js → cli-L4DEEAMK.js} +17 -17
- package/dist/{cli-EDCAH2TC.js → cli-ME3JKMJL.js} +19 -19
- package/dist/{cli-R7RG2VMW.js → cli-MJ65PIYI.js} +15 -15
- package/dist/cli-MM2ROZWO.js +36 -0
- package/dist/{cli-RZITKPJX.js → cli-MN7X4UG2.js} +1 -1
- package/dist/{cli-LE5ICDAF.js → cli-MPU4FLA7.js} +4 -4
- package/dist/{cli-HCRTYQQS.js → cli-MPWTXNF6.js} +2 -2
- package/dist/{cli-NPPY557S.js → cli-N5K2KHPR.js} +15 -15
- package/dist/{cli-PVA52RC2.js → cli-NGOQWOQE.js} +15 -15
- package/dist/{cli-ZTWOE3ZT.js → cli-NU4SCD5D.js} +1 -1
- package/dist/{cli-UTM4QU67.js → cli-O3IMNLN2.js} +282 -96
- package/dist/{cli-MM3A4SPH.js → cli-OUFXSQOW.js} +7265 -4467
- package/dist/{cli-UBQCSUDH.js → cli-PEY6XZDE.js} +16 -16
- package/dist/{cli-HM7CD4VU.js → cli-PLW3TWJ7.js} +19 -19
- package/dist/{cli-LRQDF3ZO.js → cli-PO2ALWHP.js} +13 -13
- package/dist/{cli-IPP5FDCH.js → cli-PPEB3ENS.js} +18 -18
- package/dist/{cli-C3OERMIR.js → cli-PZ7G544B.js} +3 -3
- package/dist/{cli-GPAN6XK2.js → cli-Q5BKFFDL.js} +4 -4
- package/dist/{cli-MULKSLA4.js → cli-QAI6T5FL.js} +15 -15
- package/dist/{cli-JGFJWZFU.js → cli-QAVLRCQ5.js} +3 -3
- package/dist/{cli-OQG3Y4RU.js → cli-QDIH2G2P.js} +15 -15
- package/dist/cli-SN7D7HTX.js +36 -0
- package/dist/{cli-SWZY7L7K.js → cli-SOQJHK4Q.js} +6 -6
- package/dist/{cli-7RYIEKMB.js → cli-SPKPDXWD.js} +15 -15
- package/dist/{cli-WAZD75KE.js → cli-SWUAXVIJ.js} +15 -15
- package/dist/cli-TJNLXQJ5.js +36 -0
- package/dist/{cli-SX3ULO5P.js → cli-U2EWI6H5.js} +11 -11
- package/dist/{cli-FXY3DKPW.js → cli-UADUC4JD.js} +2 -2
- package/dist/{cli-FWFRKQNE.js → cli-UR63LFVK.js} +2 -2
- package/dist/{cli-YSPZZQCP.js → cli-UTHPCZYL.js} +2 -2
- package/dist/{cli-XTANOFQR.js → cli-UYV3BDPA.js} +3 -3
- package/dist/{cli-H3J3ICCQ.js → cli-UZCQL6YP.js} +3 -3
- package/dist/{cli-LQERHJFE.js → cli-V5K3CCYZ.js} +2 -2
- package/dist/cli-V7L3HEL4.js +36 -0
- package/dist/{cli-GEQUJF4L.js → cli-VBSF3R3L.js} +16 -16
- package/dist/{cli-FXWWYBYU.js → cli-VQ4OJ4KE.js} +18 -18
- package/dist/{cli-IUS2YCD3.js → cli-VTLFQHDO.js} +1 -1
- package/dist/{cli-SOFCTQAL.js → cli-W7XCTGQ7.js} +15 -15
- package/dist/{cli-GTWEGYSU.js → cli-W7Y7X3FX.js} +19 -19
- package/dist/cli-WWNTBK37.js +1973 -0
- package/dist/cli-XPJGW375.js +36 -0
- package/dist/{cli-SRHBXZCN.js → cli-Y33ULHYO.js} +1 -1
- package/dist/{cli-ZQ2Y3U7F.js → cli-YLYB4ITF.js} +13 -13
- package/dist/{cli-4XCQUM3E.js → cli-ZFY6TGU7.js} +4 -4
- package/dist/{cli-JRIIAZ33.js → cli-ZSKP2IRP.js} +53 -38
- package/dist/cli.js +52 -52
- package/dist/client.js +17518 -16558
- package/dist/core/save-scenario.d.ts +1 -0
- package/dist/core/session-start-gate.d.ts +25 -0
- package/dist/core/session.d.ts +4 -0
- package/dist/dev/console/assets/{index-CnXlPeLX.js → index-CVNjiRUh.js} +31 -27
- package/dist/dev/console/index.html +1 -1
- package/dist/docs/api/deck.md +1 -1
- package/dist/docs/api/index.md +1 -1
- package/dist/docs/api/sdk-e2e.md +7 -6
- package/dist/docs/api/sdk-projection.md +1 -0
- package/dist/docs/api/sdk-tools-client.md +3 -1
- package/dist/docs/api/sdk-tools-playwright.md +1 -8
- package/dist/docs/api/sdk-ui.md +40 -64
- package/dist/docs/api/sdk.md +10 -1
- package/dist/docs/changelog.md +15 -0
- package/dist/docs/cli-error-codes.md +7 -1
- package/dist/docs/cli-reference.md +3 -0
- package/dist/docs/concepts/index.md +1 -0
- package/dist/docs/guides/engine.md +5 -0
- package/dist/docs/guides/file-handling.md +4 -1
- package/dist/docs/guides/llm-integration.md +3 -2
- package/dist/docs/guides/multi-team-games.md +2 -0
- package/dist/docs/guides/patterns.md +5 -0
- package/dist/docs/guides/session.md +1 -1
- package/dist/docs/guides/settings.md +2 -0
- package/dist/docs/guides/setup.md +23 -2
- package/dist/docs/guides/speech-generation.md +1 -0
- package/dist/docs/guides/testing.md +2 -0
- package/dist/docs/guides/tick-controller.md +2 -0
- package/dist/docs/guides/type-safety.md +2 -1
- package/dist/docs/guides/ui-files-and-llms.md +3 -1
- package/dist/docs/guides/upgrading.md +4 -0
- package/dist/docs/guides/validators.md +27 -4
- package/dist/docs/guides/waiting-room.md +2 -0
- package/dist/docs/page-index.md +8 -6
- package/dist/docs/recipes/call-endpoint-from-ui.md +1 -0
- package/dist/docs/recipes/create-scenario-editor.md +2 -1
- package/dist/docs/recipes/create-setup.md +2 -1
- package/dist/docs/recipes/declare-api-uses.md +1 -0
- package/dist/docs/recipes/describe-setup-with-endpoint.md +69 -0
- package/dist/docs/recipes/index.md +3 -1
- package/dist/docs/recipes/share-logic-between-engine-and-ui.md +2 -2
- package/dist/docs/recipes/test-user-interface.md +1 -1
- package/dist/docs/recipes/validate-scenarios.md +9 -3
- package/dist/docs/recipes/write-setup-notes.md +58 -0
- package/dist/docs/troubleshooting.md +2 -1
- package/dist/execution/executor.d.ts +12 -0
- package/dist/execution/scenario-gates.d.ts +40 -0
- package/dist/host.js +1082 -467
- package/dist/playwright.js +17529 -16569
- package/dist/runtime/manifest-version.d.ts +1 -1
- package/dist/runtime.js +4 -2
- package/dist/setup/setup-notes.d.ts +42 -0
- package/dist/templates/package/package.json.liquid +15 -15
- package/dist/templates/starter-game/package.json +13 -13
- package/dist/utils/error-codes.d.ts +13 -1
- package/dist/validation/package-validation.d.ts +1 -1
- package/package.json +22 -23
- package/dist/cli-57C72YKJ.js +0 -36
- package/dist/cli-5G7TZHD3.js +0 -36
- package/dist/cli-7MBLH4M3.js +0 -36
- package/dist/cli-C6G65H6S.js +0 -256
- package/dist/cli-L5IG7MY2.js +0 -36
- package/dist/cli-SPGUVL6Z.js +0 -36
- package/dist/cli-UY4VDI7W.js +0 -30
- package/dist/cli-WM6SQJ6Q.js +0 -16
- package/dist/cli-ZBTFLZUL.js +0 -36
- package/dist/cli-ZF7IFB54.js +0 -4026
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
# Write setup notes for assistants
|
|
2
|
+
|
|
3
|
+
Tell an AI assistant setting a session up which of your game's settings matter, and what a request such as 'make it a bit harder' means in your game.
|
|
4
|
+
|
|
5
|
+
**Keywords:** setup notes, assistant, agent, AI setup, session setup, make it harder, shorter session, setting paths, setup/notes, MCP
|
|
6
|
+
|
|
7
|
+
## What you'll build
|
|
8
|
+
|
|
9
|
+
A Markdown file at `setup/notes/en.md` that an assistant reads before changing a session's settings for a facilitator. A settings schema describes each setting on its own; the notes say how settings work together to mean what a facilitator asks for. They are for assistants: your setup screen is what a facilitator sees, and a host need not show the notes to anyone.
|
|
10
|
+
|
|
11
|
+
## Prerequisites
|
|
12
|
+
|
|
13
|
+
- A [setup screen](create-setup.md), since the notes sit beside it and describe the settings it `configures`
|
|
14
|
+
- `seriousgaming.sdk.json` in your working directory
|
|
15
|
+
|
|
16
|
+
## Steps
|
|
17
|
+
|
|
18
|
+
1. Create `setup/notes/en.md`. Name every setting as a setting path in a code span, as `engine.BaseDemand`, so an assistant can write it back as it stands:
|
|
19
|
+
|
|
20
|
+
```markdown
|
|
21
|
+
# Setting up a Factory session
|
|
22
|
+
|
|
23
|
+
Most sessions need no changes: start on the scenario the facilitator picked.
|
|
24
|
+
|
|
25
|
+
## Worth asking about
|
|
26
|
+
|
|
27
|
+
- **Length.** `game.maxTicks` is the number of rounds, 10 by default, between 4 and 12
|
|
28
|
+
|
|
29
|
+
## What requests mean
|
|
30
|
+
|
|
31
|
+
- **'Harder'**: lower `engine.BaseDemand` to 7,000 and raise `engine.DemandPriceModifier` to 700
|
|
32
|
+
- **'Shorter'**: set `game.maxTicks` to 6, and `engine.BonusTick` to 4 so the bonus still lands in play
|
|
33
|
+
|
|
34
|
+
## Leave alone
|
|
35
|
+
|
|
36
|
+
- `engine.CostPerUnit` at £0 makes unsold stock free, which only suits a practice round
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
2. Keep it short: the two to five choices worth asking a facilitator about, what common requests mean as settings and values, and what to leave alone. Where a request matches one of your scenarios, say to pick that scenario instead
|
|
40
|
+
|
|
41
|
+
3. Add a file per locale you support, such as `setup/notes/it.md`. An assistant gets the notes in its locale, or `en`, or your first supported locale
|
|
42
|
+
|
|
43
|
+
## Verify
|
|
44
|
+
|
|
45
|
+
- `pnpm run sdk build --validate-only` passes, and `dist/setup/notes/en.md` is there after `pnpm run sdk build`
|
|
46
|
+
- `pnpm run sdk dev`: on the configuration step, **Notes for assistants** shows the file exactly as an assistant receives it
|
|
47
|
+
|
|
48
|
+
## Troubleshooting
|
|
49
|
+
|
|
50
|
+
- _`SETTINGS_UNKNOWN` in `setup/notes/en.md`_: a code span names a setting your package does not declare, often a typo. Any code span starting with one of your settings identifiers is read as a setting path
|
|
51
|
+
- _`SETUP_NOTES_UNCONFIGURED`_: the notes name a setting your setup screen does not `configures`, so a host refuses that change. Add the settings identifier to `configures`, or leave the setting out
|
|
52
|
+
- _A code span that is not a setting_, such as `requires`: fine. Only spans starting with a settings identifier are checked
|
|
53
|
+
|
|
54
|
+
## Related
|
|
55
|
+
|
|
56
|
+
- [Setup guide: notes for assistants](../guides/setup.md#notes-for-assistants)
|
|
57
|
+
- [Describe a setup with an endpoint](describe-setup-with-endpoint.md): let an assistant read back what a setup means
|
|
58
|
+
- [Validate a game's scenarios](validate-scenarios.md): refuse a session whose setup breaks your rules
|
|
@@ -723,8 +723,9 @@ Restart the dev server. The SDK merges this config automatically for both `sdk d
|
|
|
723
723
|
3. Check the type imports:
|
|
724
724
|
|
|
725
725
|
```typescript
|
|
726
|
-
import type { Context, Settings } from '../types';
|
|
727
726
|
import { useUserInterfaceData } from '@seriousgaming/sdk/ui';
|
|
727
|
+
|
|
728
|
+
import type { Context, Settings } from '../types';
|
|
728
729
|
```
|
|
729
730
|
|
|
730
731
|
4. Call the hook inside `UserInterfaceWrapper`:
|
|
@@ -297,6 +297,18 @@ export declare class GameExecutor {
|
|
|
297
297
|
* Get the active scenario (if any)
|
|
298
298
|
*/
|
|
299
299
|
getActiveScenario(): SDKScenario | null;
|
|
300
|
+
/**
|
|
301
|
+
* What `initialize(true, …, scenarioId)` would start a session on, read
|
|
302
|
+
* without changing anything: the package on disk, the scenario it would
|
|
303
|
+
* activate and the session-override layer it would load. So a start can be
|
|
304
|
+
* judged (§15.8) before the running session is torn down, and a refusal
|
|
305
|
+
* leaves it as it was.
|
|
306
|
+
*/
|
|
307
|
+
previewStart(scenarioId?: string | null): Promise<{
|
|
308
|
+
config: ResolvedPackageManifest;
|
|
309
|
+
scenario: SDKScenario | null;
|
|
310
|
+
overrides: SessionSettingsOverrides;
|
|
311
|
+
}>;
|
|
300
312
|
/** The scenario `initialize` would activate for this id, without activating it. */
|
|
301
313
|
findScenario(scenarioId?: string | null): SDKScenario | null;
|
|
302
314
|
/**
|
|
@@ -5,6 +5,8 @@
|
|
|
5
5
|
* Unlike the other two gates it needs no session. It judges settings, not a
|
|
6
6
|
* board, so the build can run it on a package's own scenarios and the dev
|
|
7
7
|
* server on a scenario about to be saved, with only the package and a loader.
|
|
8
|
+
* In a package that lists `session-validation` it also judges a session's own
|
|
9
|
+
* settings as the session starts.
|
|
8
10
|
*/
|
|
9
11
|
import { type ResolvedPackageManifest, type ScenarioProblem } from '@seriousgaming/sdk';
|
|
10
12
|
import { LogicLoader } from './logic-loader';
|
|
@@ -13,6 +15,8 @@ import type { SessionSettingsOverrides } from './types';
|
|
|
13
15
|
export declare const SCENARIO_VALIDATION = "scenario-validation";
|
|
14
16
|
/** The `requires` feature name a package whose `Scenario` gate reads files lists (§15.8). */
|
|
15
17
|
export declare const SCENARIO_FILES = "scenario-files";
|
|
18
|
+
/** The `requires` feature name a package whose `Scenario` gate also judges a starting session lists (§15.8). */
|
|
19
|
+
export declare const SESSION_VALIDATION = "session-validation";
|
|
16
20
|
/**
|
|
17
21
|
* Where the files of the scenario being judged resolve (§15.8): as that
|
|
18
22
|
* scenario resolves them, so a gate finds exactly the files a session started
|
|
@@ -32,7 +36,38 @@ export interface ScenarioFileRoots {
|
|
|
32
36
|
/** A problem one validator found with a scenario. */
|
|
33
37
|
export interface ScenarioGateProblem extends ScenarioProblem {
|
|
34
38
|
validatorIdentifier: string;
|
|
39
|
+
/**
|
|
40
|
+
* Set when the gate itself failed (it threw, overran, or returned
|
|
41
|
+
* something other than an array) rather than finding a problem. A failure
|
|
42
|
+
* blocks like an error, but only a fix to the game clears it, so it is
|
|
43
|
+
* reported apart from the problems a setting change would fix (§15.6).
|
|
44
|
+
*/
|
|
45
|
+
failed?: true;
|
|
46
|
+
/**
|
|
47
|
+
* Set beside `failed` when the gate ran out of time rather than threw.
|
|
48
|
+
* The bound is real time, so a busy host can push a sound gate over it,
|
|
49
|
+
* and a runtime may run it again before refusing a start (§15.8).
|
|
50
|
+
*/
|
|
51
|
+
overran?: true;
|
|
35
52
|
}
|
|
53
|
+
/** Whether a problem refuses: a failed gate, or one that is not a warning. */
|
|
54
|
+
export declare function isBlocking(problem: ScenarioGateProblem): boolean;
|
|
55
|
+
/** How many more times a gate that only overran is run, before a start or a save is refused. */
|
|
56
|
+
export declare const OVERRUN_RETRIES = 1;
|
|
57
|
+
/** Whether the only thing refusing is a gate that ran out of time. */
|
|
58
|
+
export declare function onlyOverran(problems: ScenarioGateProblem[]): boolean;
|
|
59
|
+
/**
|
|
60
|
+
* Run `judge` again while all it refuses on is a gate that ran out of time
|
|
61
|
+
* (§15.8). The bound is real time, so a busy host can push a sound gate over
|
|
62
|
+
* it; a throw gives the same answer every time, so it is never run again. The
|
|
63
|
+
* build does not retry: nothing else competes for its time.
|
|
64
|
+
*/
|
|
65
|
+
export declare function withOverrunRetry(judge: () => Promise<ScenarioGateProblem[]>): Promise<ScenarioGateProblem[]>;
|
|
66
|
+
/** The problems that refuse, and the warnings that never do. */
|
|
67
|
+
export declare function partitionProblems(problems: ScenarioGateProblem[]): {
|
|
68
|
+
blocking: ScenarioGateProblem[];
|
|
69
|
+
warnings: ScenarioGateProblem[];
|
|
70
|
+
};
|
|
36
71
|
/** Whether any validator in the package gates scenarios. */
|
|
37
72
|
export declare function hasScenarioGate(config: Pick<ResolvedPackageManifest, 'validators'>): boolean;
|
|
38
73
|
/**
|
|
@@ -49,6 +84,11 @@ export declare function runScenarioGates(options: {
|
|
|
49
84
|
boundMs?: number;
|
|
50
85
|
/** Where the scenario's files resolve. None at all when absent: the defaults alone. */
|
|
51
86
|
files?: ScenarioFileRoots;
|
|
87
|
+
/**
|
|
88
|
+
* A starting session's own overrides, applied over the scenario
|
|
89
|
+
* (`session-validation`). Absent for a scenario judged alone.
|
|
90
|
+
*/
|
|
91
|
+
sessionOverrides?: SessionSettingsOverrides | null;
|
|
52
92
|
}): Promise<ScenarioGateProblem[]>;
|
|
53
93
|
/** One line per problem, naming the validator and the setting. */
|
|
54
94
|
export declare function describeScenarioProblems(problems: ScenarioGateProblem[]): string[];
|