gdharness 0.4.1 → 0.5.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/LICENSE +1 -0
- package/README.md +33 -87
- package/build/cli.js +34888 -26369
- package/build/godot/addons/gdharness_runtime/runtime_input.gd +11 -3
- package/build/index.js +670 -112
- package/package.json +1 -1
package/LICENSE
CHANGED
package/README.md
CHANGED
|
@@ -7,46 +7,18 @@
|
|
|
7
7
|
[](.github/release-process.md#slsa)
|
|
8
8
|
[](.github/release-process.md#what-a-release-carries)
|
|
9
9
|
[](.github/release-process.md#verifying-a-release)
|
|
10
|
+
[](https://www.npmjs.com/package/gdharness)
|
|
10
11
|
[](https://github.com/Aureliolo/gdharness/releases)
|
|
11
12
|
[](https://modelcontextprotocol.io/introduction)
|
|
12
13
|
[](https://godotengine.org)
|
|
14
|
+
[](https://nodejs.org/)
|
|
13
15
|
[](https://bun.sh/)
|
|
14
16
|
[](LICENSE)
|
|
15
17
|
|
|
16
|
-
|
|
17
|
-
|
|
18
|
+
Drive a Godot 4 project from an agent: the editor that is open, the game that is running, and the
|
|
19
|
+
project on disk.
|
|
18
20
|
|
|
19
|
-
|
|
20
|
-
1.4.0 or newer too.
|
|
21
|
-
|
|
22
|
-
```jsonc
|
|
23
|
-
runtime_inspect { "op": "rect", "nodePath": "/root/Hall/Ledger/BuyButton" }
|
|
24
|
-
|
|
25
|
-
{
|
|
26
|
-
"type": "rect",
|
|
27
|
-
"path": "/root/Hall/Ledger/BuyButton",
|
|
28
|
-
"visible": true,
|
|
29
|
-
"canvas": { "position": { "x": 812, "y": 418 }, "size": { "x": 180, "y": 34 } },
|
|
30
|
-
"window": { "position": { "x": 812, "y": 418 }, "size": { "x": 180, "y": 34 } }
|
|
31
|
-
}
|
|
32
|
-
```
|
|
33
|
-
|
|
34
|
-
**Documentation: [aureliolo.github.io/gdharness](https://aureliolo.github.io/gdharness)**
|
|
35
|
-
|
|
36
|
-
## Install
|
|
37
|
-
|
|
38
|
-
From the project directory:
|
|
39
|
-
|
|
40
|
-
```bash
|
|
41
|
-
npx -y gdharness@0.4.1 setup . --runtime
|
|
42
|
-
```
|
|
43
|
-
|
|
44
|
-
Addons in, editor plugins on, class list rebuilt, and the server written into every agent harness
|
|
45
|
-
found on the machine: Claude Code, Cursor, VS Code, opencode, Codex, Gemini CLI, Windsurf, Hermes
|
|
46
|
-
and the rest. Reconnect the harness, then check `editor_status` answers.
|
|
47
|
-
|
|
48
|
-
[Install](https://aureliolo.github.io/gdharness/install.html) has the rest, including the signed
|
|
49
|
-
archive for a pinned or offline install. To have an agent do it, paste:
|
|
21
|
+
**Hand this to your agent:**
|
|
50
22
|
|
|
51
23
|
```text
|
|
52
24
|
Install gdharness into this project by following
|
|
@@ -54,72 +26,46 @@ https://aureliolo.github.io/gdharness/agent.md, then tell me what it asked you t
|
|
|
54
26
|
recommend back to me.
|
|
55
27
|
```
|
|
56
28
|
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
**Inside Godot.** Addons installed into your project. They make the open editor and the running
|
|
60
|
-
game answerable, and reload the editor's view when files change on disk.
|
|
29
|
+
Or do it yourself, and pick your harness:
|
|
30
|
+
[aureliolo.github.io/gdharness](https://aureliolo.github.io/gdharness)
|
|
61
31
|
|
|
62
|
-
|
|
32
|
+
## What it is for
|
|
63
33
|
|
|
64
|
-
|
|
65
|
-
|
|
34
|
+
An agent cannot see a running game. This makes one answerable: where a control is, what a property
|
|
35
|
+
reads, what the console printed, what broke and on which line.
|
|
66
36
|
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
## Tools
|
|
70
|
-
|
|
71
|
-
Tools are named `domain_verb`. A tool that does several related things takes an `op`. An unknown op
|
|
72
|
-
or argument is refused with the valid set listed. Answers are read from the engine after the
|
|
73
|
-
change, not echoed from the request.
|
|
74
|
-
|
|
75
|
-
[Reference](https://aureliolo.github.io/gdharness/tools.html), generated from the server.
|
|
76
|
-
|
|
77
|
-
## Rules
|
|
37
|
+
```jsonc
|
|
38
|
+
runtime_inspect { "op": "rect", "nodePath": "/root/Hall/Ledger/BuyButton" }
|
|
78
39
|
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
- **Strict projects are the baseline.** Everything shipped, and everything the tools write, parses
|
|
83
|
-
with all GDScript warnings as errors.
|
|
84
|
-
- **Few tools, shaped like tasks.** Around thirty, not a hundred.
|
|
85
|
-
- **Answers are sized.** Detail levels by default, pagination where unbounded.
|
|
40
|
+
{ "canvas": { "position": { "x": 812, "y": 418 }, "size": { "x": 180, "y": 34 } },
|
|
41
|
+
"visible": true }
|
|
42
|
+
```
|
|
86
43
|
|
|
87
|
-
|
|
44
|
+
## At a glance
|
|
88
45
|
|
|
89
|
-
|
|
46
|
+
| | |
|
|
47
|
+
| --------- | ------------------------------------------------------------------------ |
|
|
48
|
+
| Needs | Godot 4.7 or newer, Node 22 or newer. Runs under Bun 1.4 too. |
|
|
49
|
+
| Surface | 30 tools named `domain_verb`, and 4 `godot://` resources |
|
|
50
|
+
| Reaches | The editor that is open, a game it is playing, and the project on disk |
|
|
51
|
+
| Harnesses | 35, written inside the project wherever the harness has a project config |
|
|
52
|
+
| Skill | Written to `.agents/skills`, which every major harness reads |
|
|
53
|
+
| Install | npm, or a Sigstore-signed archive with an SBOM, SLSA Build Level 3 |
|
|
54
|
+
| Proven | Every tool driven against a pinned Godot in CI, on three platforms |
|
|
90
55
|
|
|
91
|
-
|
|
92
|
-
game serves it.
|
|
93
|
-
- Subprocesses are spawned with an argument array, never a shell.
|
|
94
|
-
- Releases carry an SPDX SBOM and a keyless Sigstore build-provenance attestation over the archive,
|
|
95
|
-
its checksum and the SBOM, built by one reusable workflow: [SLSA Build Level
|
|
96
|
-
3](.github/release-process.md#slsa). Published releases are immutable.
|
|
97
|
-
- Every dependency is an exact version and every action is pinned by commit digest. Nothing
|
|
98
|
-
downloaded in CI runs unless it matches a digest in this repository.
|
|
99
|
-
- `main` takes pull requests only, linear history, signed commits, and every CI job is a required
|
|
100
|
-
check. CodeQL, Scorecard, actionlint, zizmor and secret scanning run on every change.
|
|
56
|
+
## Documentation
|
|
101
57
|
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
--signer-workflow Aureliolo/gdharness/.github/workflows/release-build.yml
|
|
105
|
-
```
|
|
58
|
+
[aureliolo.github.io/gdharness](https://aureliolo.github.io/gdharness): installing it, how the
|
|
59
|
+
parts connect, and every tool, op and argument.
|
|
106
60
|
|
|
107
61
|
[SECURITY.md](.github/SECURITY.md) is how to report something.
|
|
108
|
-
|
|
109
|
-
## Development
|
|
110
|
-
|
|
111
|
-
```bash
|
|
112
|
-
bun install
|
|
113
|
-
bun run build
|
|
114
|
-
bun run ci
|
|
115
|
-
bun run docs # the site, into site/
|
|
116
|
-
```
|
|
117
|
-
|
|
118
62
|
[CONTRIBUTING.md](.github/CONTRIBUTING.md) is what a change has to clear.
|
|
119
63
|
|
|
120
64
|
## Project
|
|
121
65
|
|
|
122
|
-
Fork of [GoPeak](https://github.com/HaD0Yun/Doyunha-Gopeak) v2.3.9, September 2026, MIT
|
|
123
|
-
|
|
66
|
+
Fork of [GoPeak](https://github.com/HaD0Yun/Doyunha-Gopeak) v2.3.9, September 2026, MIT: the
|
|
67
|
+
original MCP server [godot-mcp](https://github.com/Coding-Solo/godot-mcp) by
|
|
68
|
+
[Solomon Elias](https://github.com/Coding-Solo), GoPeak by [HaD0Yun](https://github.com/HaD0Yun),
|
|
69
|
+
and completely reworked since to be hardened, condensed and more streamlined.
|
|
124
70
|
|
|
125
|
-
Not affiliated with
|
|
71
|
+
Not affiliated with the Godot Foundation.
|