@kradle/challenges-sdk 0.7.2 → 0.8.1

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 +73 -0
  2. package/package.json +4 -3
package/CHANGELOG.md ADDED
@@ -0,0 +1,73 @@
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
+ This file is published: it ships inside the npm tarball as CHANGELOG.md. Write
11
+ only what a consumer of the published package can see and act on.
12
+
13
+ The entry for each release is drafted by the "Create Release PR" workflow (rules
14
+ in .github/changelog-prompt.md) and reviewed in the PR before merging. You can
15
+ also hand-edit this file or the [Unreleased] section at any time.
16
+ -->
17
+
18
+ ## [Unreleased]
19
+
20
+ ## [0.8.1] - 2026-07-13
21
+
22
+ ### Changed
23
+
24
+ - Internal maintenance release.
25
+
26
+ ## [0.8.0] - 2026-07-10
27
+
28
+ ### Changed
29
+
30
+ - `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.
31
+
32
+ ## [0.7.2] - 2026-07-09
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.1...HEAD
69
+ [0.8.1]: https://github.com/Kradle-ai/challenges-sdk/compare/v0.8.0...v0.8.1
70
+ [0.8.0]: https://github.com/Kradle-ai/challenges-sdk/compare/v0.7.2...v0.8.0
71
+ [0.7.2]: https://github.com/Kradle-ai/challenges-sdk/compare/v0.6.2...v0.7.2
72
+ [0.6.2]: https://github.com/Kradle-ai/challenges-sdk/compare/v0.6.1...v0.6.2
73
+ [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.1",
4
4
  "description": "Kradle's challenges SDK - Create Minecraft datapack-based challenges",
5
5
  "keywords": [
6
6
  "kradle",
@@ -16,14 +16,15 @@
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",
23
24
  "watch": "tsc --watch",
24
25
  "lint": "biome lint --fix --unsafe",
25
26
  "check-docs": "node scripts/check-docs.mjs",
26
- "prepack": "npm run build",
27
+ "prepack": "npm run build && node scripts/stage-user-changelog.mjs",
27
28
  "prepare": "npm run build"
28
29
  },
29
30
  "peerDependencies": {