@kradle/challenges-sdk 0.7.2 → 0.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.
Files changed (2) hide show
  1. package/CHANGELOG.md +72 -0
  2. package/package.json +3 -2
package/CHANGELOG.md ADDED
@@ -0,0 +1,72 @@
1
+ # Changelog
2
+
3
+ All notable changes to the Kradle challenges SDK (`@kradle/challenges-sdk`) are
4
+ documented in this file.
5
+
6
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
7
+ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
8
+
9
+ <!--
10
+ The entry for each release is drafted by the "Create Release PR" workflow:
11
+ Claude writes the section for the new version from the commits since the last
12
+ release, and you review/edit it in the PR before merging. You can also hand-edit
13
+ this file or the [Unreleased] section at any time.
14
+
15
+ Keep entries human-readable — describe the user-facing change, not the commit.
16
+ Group them under Added / Changed / Deprecated / Removed / Fixed / Security,
17
+ latest version first.
18
+ -->
19
+
20
+ ## [Unreleased]
21
+
22
+ ## [0.8.0] - 2026-07-10
23
+
24
+ ### Changed
25
+
26
+ - `CHANGELOG.md` is now included in the npm package so `kradle update-sdk` can fetch it per version and show the migration delta before bumping. Breaking entries use a `**Breaking:**` prefix that the CLI highlights automatically.
27
+
28
+ ## [0.7.2] - 2026-07-09
29
+
30
+ ### Added
31
+
32
+ - `npm run check-docs` validates that `LLM_README.md` stays in sync with the `Actions` API surface; also runs in PR checks to prevent future drift.
33
+
34
+ ### Changed
35
+
36
+ - The datapack output path is now resolved from the `KRADLE_CHALLENGES_PATH` environment variable (falling back to a default for standalone use) instead of from the `kradle_challenge_path` config field. Previously a hardcoded config value could silently redirect the build away from where the CLI packages it, shipping a stale datapack.
37
+
38
+ ### Deprecated
39
+
40
+ - `kradle_challenge_path` config field. The value is now ignored; passing it emits a `console.warn` advising removal.
41
+
42
+ ### Fixed
43
+
44
+ - `LLM_README.md` corrected the `Actions.setTime` signature (was documented as accepting a tick number when the source only accepts `"day"` or `"night"`).
45
+ - `LLM_README.md` now documents twelve previously undocumented Actions: `assignRandomTag`, `custom`, `setGamemode`, `eliminate`, `isStandingOn`, `giveAll`, `randomInt`, `maxPlayerScore`, `detectBlockMissing`, `summonEntityWithStats`, `countEntities`, and `flatArena`.
46
+
47
+ ## [0.6.2] - 2026-06-23
48
+
49
+ ### Added
50
+
51
+ - `Actions.forceMoveTo` forces target player(s) to interrupt their running code and walk to absolute coordinates. Accepts `"self"` when called from a per-player context (e.g. inside `forEveryPlayer`); a contextless `forceMoveTo("self")` is caught by the CLI's context-safety check.
52
+
53
+ ### Changed
54
+
55
+ - `mapTarget` now throws on any raw `@...` selector string (e.g. `"@s"`, `"@a"`). Use `"self"`, a role name, or a `Selector` object instead. Previously `"@s"` silently produced a selector matching nobody.
56
+
57
+ ### Fixed
58
+
59
+ - Individual custom-event handlers (per-player score and advancement events) now run `at @s` as well as `as @s`. Previously relative coordinates (`~ ~ ~`) and `distance=` selectors inside the handler resolved from world spawn instead of the triggering player.
60
+
61
+ ## [0.6.1] - 2026-06-09
62
+
63
+ ### Added
64
+
65
+ - Voting primitives (`votedFor`, `promptVote`, `allVotesIn`, `assignDefaultVotes`) for challenges that use discuss-then-vote-then-act phases as an alternative to pad-based voting.
66
+ - Build-time validation of vote IDs and options against `KRADLE_CHALLENGE_VOTING_OPTIONS` (when set), matching the existing `getLocation`/`setEndState` pattern. `promptVote` also validates each announced option against the declared `votingOptions`.
67
+
68
+ [Unreleased]: https://github.com/Kradle-ai/challenges-sdk/compare/v0.8.0...HEAD
69
+ [0.8.0]: https://github.com/Kradle-ai/challenges-sdk/compare/v0.7.2...v0.8.0
70
+ [0.7.2]: https://github.com/Kradle-ai/challenges-sdk/compare/v0.6.2...v0.7.2
71
+ [0.6.2]: https://github.com/Kradle-ai/challenges-sdk/compare/v0.6.1...v0.6.2
72
+ [0.6.1]: https://github.com/Kradle-ai/challenges-sdk/compare/v0.6.0...v0.6.1
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kradle/challenges-sdk",
3
- "version": "0.7.2",
3
+ "version": "0.8.0",
4
4
  "description": "Kradle's challenges SDK - Create Minecraft datapack-based challenges",
5
5
  "keywords": [
6
6
  "kradle",
@@ -16,7 +16,8 @@
16
16
  "files": [
17
17
  "dist",
18
18
  "LLM_README.md",
19
- "README.md"
19
+ "README.md",
20
+ "CHANGELOG.md"
20
21
  ],
21
22
  "scripts": {
22
23
  "build": "rm -rf dist && tsc",