@opengamehq/cli 0.5.0 → 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.
- package/AGENTS.md +12 -3
- package/CHANGELOG.md +61 -0
- package/README.md +12 -3
- package/dist/cli.mjs +162 -131
- package/dist/preflight-worker.mjs +1 -1
- package/dist/runtime-builder.mjs +1 -1
- package/dist/skills/manifest.json +4 -4
- package/dist/skills/opengame-cli/SKILL.md +76 -2
- package/package.json +1 -1
package/AGENTS.md
CHANGED
|
@@ -202,21 +202,30 @@ Play the private preview before you tell the creator the game works.
|
|
|
202
202
|
<!-- generated:commands -->
|
|
203
203
|
| Command | What it does |
|
|
204
204
|
| --- | --- |
|
|
205
|
-
| `opengame init [dir] [options]` | Create opengame.json for an existing game. |
|
|
205
|
+
| `opengame init [dir] [options]` | Create opengame.json for an existing game. When one is already there, fill in the fields it leaves blank and keep the rest. |
|
|
206
206
|
| `opengame check [dir] [options]` | Find local build and asset problems before uploading. |
|
|
207
207
|
| `opengame dev [dir] [options]` | Serve a local export with game-runtime headers. Under a contract that adds the SDK, pages also get the host runtime and SDK, as they do when hosted. If the contract supports opting out, sdk.inject: false leaves out the SDK. |
|
|
208
208
|
| `opengame login [options]` | Sign in through your browser. |
|
|
209
|
-
| `opengame deploy [dir] [options]` | Build, check and upload a release, then return with the address of its deployment page, where the checks run and the private preview plays once they pass. Add --wait to stay until they finish. Once the preview is ready, the achievements opengame.json declares are saved by deploy --wait or by the next opengame status in this folder. Removing an achievement from opengame.json does not switch it off. To retire one,
|
|
210
|
-
| `opengame status [dir] [options]` | Show the most recent deploy for this folder, with its findings. Finishes saving its declared achievements if the deploy could not. Removing an achievement from opengame.json does not switch it off. To retire one,
|
|
209
|
+
| `opengame deploy [dir] [options]` | Build, check and upload a release, then return with the address of its deployment page, where the checks run and the private preview plays once they pass. Add --wait to stay until they finish. Once the preview is ready, the achievements opengame.json declares are saved by deploy --wait or by the next opengame status in this folder. Removing an achievement from opengame.json does not switch it off. To retire one, run opengame achievements retire <id>. Unlocks are never deleted. |
|
|
210
|
+
| `opengame status [dir] [options]` | Show the most recent deploy for this folder, with its findings. Finishes saving its declared achievements if the deploy could not. Removing an achievement from opengame.json does not switch it off. To retire one, run opengame achievements retire <id>. Unlocks are never deleted. |
|
|
211
211
|
| `opengame deployments [dir] [options]` | List the linked game's deploys, newest first: status, when, size, who started each one, why any stopped, and each one's page or preview. |
|
|
212
212
|
| `opengame open [dir] [options]` | Open the linked game's private page in your browser. |
|
|
213
213
|
| `opengame submit [dir] [options]` | Send one release to review, and enter it in a jam. |
|
|
214
214
|
| `opengame jams [slug] [options]` | List open jams, or show one jam's tracks and flags. |
|
|
215
|
+
| `opengame jam <withdraw\|reenter> [options]` | Withdraw the linked game's jam entry, freeing its place, or put a withdrawn one back while the jam is open, as your jam entries page does. Needs a token with submit; opengame login has it. |
|
|
216
|
+
| `opengame releases [dir] [options]` | List the linked game's releases, newest first, as the Releases tab on its page does: which one is live, which were live before, which are drafts and which were cleaned up, and which can be made live again. |
|
|
217
|
+
| `opengame rollback <release> [options]` | Make a release that was live before live again, as Make live again does on the game's page. The game must be live, and the release must still have its files. Players get it from their next load. Run again on the live release to rewrite its address after a failed one. Needs a token with read or deploy, and submit; opengame login has all three. |
|
|
218
|
+
| `opengame unpublish [dir] [options]` | Take the linked game off the gallery and stop serving it, as Unpublish does on Your games. Your build, uploads and review record are kept, and opengame restore puts it back. Needs a token with read or deploy, and submit; opengame login has all three. |
|
|
219
|
+
| `opengame restore [dir] [options]` | Put a game you unpublished back on the gallery, serving the version it was on, as Put it back does on Your games. Refused for a game we took down, one with an open report or a hold, and one under a copyright notice. Needs a token with read or deploy, and submit; opengame login has all three. |
|
|
220
|
+
| `opengame delete [dir] [options]` | Delete the linked game for good, as Delete for good does on its page: it comes off the gallery, stops being served and cannot be put back. You type its title to confirm. Refused while it is under a legal hold, with a reviewer, or in a jam being scored. Only the opengame login token can do this, not a token made in settings. |
|
|
221
|
+
| `opengame details [dir] [options]` | Print the linked game's title, tagline and description as the website shows them, or change any of them, as the Details tab on its page does. A field you leave out stays as it is. On a published game players see the change at once. Printing needs a token with read or deploy, and saving needs submit too; opengame login has all three. |
|
|
222
|
+
| `opengame achievements [retire <id>] [options]` | List the linked game's achievements, active and retired, or retire one, as the achievements step on the website does. Players keep what they unlocked, and the game can no longer award a retired one. Retiring needs a token with deploy and submit; opengame login has them. |
|
|
215
223
|
| `opengame games [options]` | List your games and their latest deploy. |
|
|
216
224
|
| `opengame link [dir] [options]` | Connect this folder to an existing game. |
|
|
217
225
|
| `opengame pull [dir] [options]` | Bring website metadata into this folder. |
|
|
218
226
|
| `opengame stats [game\|dir] [options]` | Read analytics for a game you own, or this folder's linked game, for one complete ISO week, Monday to Sunday in UTC. Average playtime is total playtime divided by distinct players in the week. |
|
|
219
227
|
| `opengame whoami [options]` | Show the account and permissions for this token. |
|
|
228
|
+
| `opengame handle <name> [options]` | Rename your handle, as Settings does. Your old handle keeps pointing at you and is never given to anybody else, and renames are limited per day. Only the opengame login token can do this, not a token made in settings. |
|
|
220
229
|
| `opengame token create\|list\|revoke [options]` | Create, list or revoke tokens in your browser. |
|
|
221
230
|
| `opengame logout [options]` | Revoke this device's token and remove it locally. |
|
|
222
231
|
| `opengame limits [options]` | Show bundle limits and your remaining account allowance. |
|
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,66 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.8.0
|
|
4
|
+
|
|
5
|
+
- `opengame init` guesses a genre from the title, the description, the page's meta
|
|
6
|
+
description and package.json's keywords, as its help says. When none of those names a
|
|
7
|
+
genre, it asks a person, and an agent or a script gets `puzzle-casual`, with the line to
|
|
8
|
+
change it. It used to leave genre blank, and `opengame check` then refused the file.
|
|
9
|
+
- `opengame init` in a folder whose opengame.json leaves title, description, genre or
|
|
10
|
+
controls blank fills those in and keeps everything the file sets. It used to stop because
|
|
11
|
+
the file existed. A file with nothing blank is still refused, and a flag for a field the
|
|
12
|
+
file already sets is named as unused. If the file is saved while init is asking a
|
|
13
|
+
question, init keeps that edit and writes nothing.
|
|
14
|
+
- `opengame init` sets controls from the keyboard, mouse, touch and gamepad listeners in
|
|
15
|
+
your game's own source. Touch counts as mouse, so a game that only listens for taps or
|
|
16
|
+
clicks gets `mouse`. It used to write keyboard and mouse whatever the game used, and
|
|
17
|
+
still does when it finds no input at all.
|
|
18
|
+
- A genre or controls that init chose without being told are marked provisional when you
|
|
19
|
+
deploy, as Drop and the GitHub tab already do, so the details form after review offers
|
|
20
|
+
what review detected rather than treating the guess as your choice. Change either in
|
|
21
|
+
opengame.json and it is yours.
|
|
22
|
+
- `opengame check` says how to set a blank or unknown genre, naming the genres and the
|
|
23
|
+
init line that fills it, rather than "Correct genre in opengame.json".
|
|
24
|
+
- Ships the skills from `@opengamehq/skills` 1.3.0, as 0.7.0 did.
|
|
25
|
+
|
|
26
|
+
## 0.7.0
|
|
27
|
+
|
|
28
|
+
- `opengame unpublish` takes a game off the gallery and stops serving it, and `opengame
|
|
29
|
+
restore` puts a game you unpublished back, through the same checks and audit as
|
|
30
|
+
Unpublish and Put it back on Your games. A person is asked first; an agent or a script
|
|
31
|
+
passes `--yes`. Both need a token with the `submit` permission, which `opengame login`
|
|
32
|
+
gives.
|
|
33
|
+
- `opengame details` prints a game's title, tagline and description as the website shows
|
|
34
|
+
them, and `--title`, `--tagline` and `--description` change them, through the same
|
|
35
|
+
checks as the Details tab on the game's page. It needs the `submit` permission.
|
|
36
|
+
- `opengame handle <name>` renames your handle, through the same limits and checks as
|
|
37
|
+
Settings. A person is asked first; an agent passes `--yes`. Only the `opengame login`
|
|
38
|
+
token can do it.
|
|
39
|
+
- `opengame jam withdraw` takes the linked game's jam entry out of the jam and frees its
|
|
40
|
+
place, and `opengame jam reenter` puts a withdrawn one back while the jam is open, as
|
|
41
|
+
the jam entries page does. Withdrawing asks first; an agent passes `--yes`.
|
|
42
|
+
- `opengame delete` deletes a game for good, through the same checks as Delete for good
|
|
43
|
+
on its page. You type its title to confirm; an agent passes `--title` and `--yes`. Only
|
|
44
|
+
the `opengame login` token can delete.
|
|
45
|
+
- `opengame achievements` lists a game's achievements, and `opengame achievements retire
|
|
46
|
+
<id>` retires one, as the website's achievements step does. Retiring now needs the
|
|
47
|
+
`submit` permission as well as `deploy`, from the CLI and the API alike; a deploy's own
|
|
48
|
+
save of its declared achievements still needs only `deploy`.
|
|
49
|
+
- `opengame stats --csv <file>` writes the week's figures as the CSV the Stats tab
|
|
50
|
+
downloads, from the same export. It never writes over an existing file.
|
|
51
|
+
- Ships the skills from `@opengamehq/skills` 1.3.0.
|
|
52
|
+
|
|
53
|
+
## 0.6.0
|
|
54
|
+
|
|
55
|
+
- `opengame releases` lists a game's releases, newest first, as the Releases tab on its
|
|
56
|
+
page does: which one is live, which were live before, which are drafts or in review,
|
|
57
|
+
which were cleaned up, and which can be made live again.
|
|
58
|
+
- `opengame rollback <release>` makes a release that was live before live again, through
|
|
59
|
+
the same check and audit as Make live again on the website. A person is asked first; an
|
|
60
|
+
agent or a script passes `--yes`. It needs a token with the `submit` permission, which
|
|
61
|
+
`opengame login` gives.
|
|
62
|
+
- Ships the skills from `@opengamehq/skills` 1.2.0.
|
|
63
|
+
|
|
3
64
|
## 0.5.0
|
|
4
65
|
|
|
5
66
|
- Before OpenGame opens for creators, a refused command names the day it opens ("OpenGame
|
package/README.md
CHANGED
|
@@ -83,21 +83,30 @@ OpenCode, so a coding agent can do all of the above for you.
|
|
|
83
83
|
<!-- generated:commands -->
|
|
84
84
|
| Command | What it does |
|
|
85
85
|
| --- | --- |
|
|
86
|
-
| `opengame init [dir] [options]` | Create opengame.json for an existing game. |
|
|
86
|
+
| `opengame init [dir] [options]` | Create opengame.json for an existing game. When one is already there, fill in the fields it leaves blank and keep the rest. |
|
|
87
87
|
| `opengame check [dir] [options]` | Find local build and asset problems before uploading. |
|
|
88
88
|
| `opengame dev [dir] [options]` | Serve a local export with game-runtime headers. Under a contract that adds the SDK, pages also get the host runtime and SDK, as they do when hosted. If the contract supports opting out, sdk.inject: false leaves out the SDK. |
|
|
89
89
|
| `opengame login [options]` | Sign in through your browser. |
|
|
90
|
-
| `opengame deploy [dir] [options]` | Build, check and upload a release, then return with the address of its deployment page, where the checks run and the private preview plays once they pass. Add --wait to stay until they finish. Once the preview is ready, the achievements opengame.json declares are saved by deploy --wait or by the next opengame status in this folder. Removing an achievement from opengame.json does not switch it off. To retire one,
|
|
91
|
-
| `opengame status [dir] [options]` | Show the most recent deploy for this folder, with its findings. Finishes saving its declared achievements if the deploy could not. Removing an achievement from opengame.json does not switch it off. To retire one,
|
|
90
|
+
| `opengame deploy [dir] [options]` | Build, check and upload a release, then return with the address of its deployment page, where the checks run and the private preview plays once they pass. Add --wait to stay until they finish. Once the preview is ready, the achievements opengame.json declares are saved by deploy --wait or by the next opengame status in this folder. Removing an achievement from opengame.json does not switch it off. To retire one, run opengame achievements retire <id>. Unlocks are never deleted. |
|
|
91
|
+
| `opengame status [dir] [options]` | Show the most recent deploy for this folder, with its findings. Finishes saving its declared achievements if the deploy could not. Removing an achievement from opengame.json does not switch it off. To retire one, run opengame achievements retire <id>. Unlocks are never deleted. |
|
|
92
92
|
| `opengame deployments [dir] [options]` | List the linked game's deploys, newest first: status, when, size, who started each one, why any stopped, and each one's page or preview. |
|
|
93
93
|
| `opengame open [dir] [options]` | Open the linked game's private page in your browser. |
|
|
94
94
|
| `opengame submit [dir] [options]` | Send one release to review, and enter it in a jam. |
|
|
95
95
|
| `opengame jams [slug] [options]` | List open jams, or show one jam's tracks and flags. |
|
|
96
|
+
| `opengame jam <withdraw\|reenter> [options]` | Withdraw the linked game's jam entry, freeing its place, or put a withdrawn one back while the jam is open, as your jam entries page does. Needs a token with submit; opengame login has it. |
|
|
97
|
+
| `opengame releases [dir] [options]` | List the linked game's releases, newest first, as the Releases tab on its page does: which one is live, which were live before, which are drafts and which were cleaned up, and which can be made live again. |
|
|
98
|
+
| `opengame rollback <release> [options]` | Make a release that was live before live again, as Make live again does on the game's page. The game must be live, and the release must still have its files. Players get it from their next load. Run again on the live release to rewrite its address after a failed one. Needs a token with read or deploy, and submit; opengame login has all three. |
|
|
99
|
+
| `opengame unpublish [dir] [options]` | Take the linked game off the gallery and stop serving it, as Unpublish does on Your games. Your build, uploads and review record are kept, and opengame restore puts it back. Needs a token with read or deploy, and submit; opengame login has all three. |
|
|
100
|
+
| `opengame restore [dir] [options]` | Put a game you unpublished back on the gallery, serving the version it was on, as Put it back does on Your games. Refused for a game we took down, one with an open report or a hold, and one under a copyright notice. Needs a token with read or deploy, and submit; opengame login has all three. |
|
|
101
|
+
| `opengame delete [dir] [options]` | Delete the linked game for good, as Delete for good does on its page: it comes off the gallery, stops being served and cannot be put back. You type its title to confirm. Refused while it is under a legal hold, with a reviewer, or in a jam being scored. Only the opengame login token can do this, not a token made in settings. |
|
|
102
|
+
| `opengame details [dir] [options]` | Print the linked game's title, tagline and description as the website shows them, or change any of them, as the Details tab on its page does. A field you leave out stays as it is. On a published game players see the change at once. Printing needs a token with read or deploy, and saving needs submit too; opengame login has all three. |
|
|
103
|
+
| `opengame achievements [retire <id>] [options]` | List the linked game's achievements, active and retired, or retire one, as the achievements step on the website does. Players keep what they unlocked, and the game can no longer award a retired one. Retiring needs a token with deploy and submit; opengame login has them. |
|
|
96
104
|
| `opengame games [options]` | List your games and their latest deploy. |
|
|
97
105
|
| `opengame link [dir] [options]` | Connect this folder to an existing game. |
|
|
98
106
|
| `opengame pull [dir] [options]` | Bring website metadata into this folder. |
|
|
99
107
|
| `opengame stats [game\|dir] [options]` | Read analytics for a game you own, or this folder's linked game, for one complete ISO week, Monday to Sunday in UTC. Average playtime is total playtime divided by distinct players in the week. |
|
|
100
108
|
| `opengame whoami [options]` | Show the account and permissions for this token. |
|
|
109
|
+
| `opengame handle <name> [options]` | Rename your handle, as Settings does. Your old handle keeps pointing at you and is never given to anybody else, and renames are limited per day. Only the opengame login token can do this, not a token made in settings. |
|
|
101
110
|
| `opengame token create\|list\|revoke [options]` | Create, list or revoke tokens in your browser. |
|
|
102
111
|
| `opengame logout [options]` | Revoke this device's token and remove it locally. |
|
|
103
112
|
| `opengame limits [options]` | Show bundle limits and your remaining account allowance. |
|