@putdotio/rokit 2.2.0 → 2.3.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 CHANGED
@@ -28,6 +28,8 @@ Keep it platform-focused, typed, and useful for both humans and agents.
28
28
  - Treat `process.cwd()` as the consumer app root.
29
29
  - Keep `.rokit/` consumer-local; it can hold env, generated artifacts, and
30
30
  transient device state.
31
+ - Keep `skills/rokit/SKILL.md` aligned with agent-facing command and safety
32
+ guardrails.
31
33
  - Keep `examples/live-probe-channel` generic. It exists only to prove package,
32
34
  install, launch, input, SceneGraph, screenshot, and proof mechanics.
33
35
  - Wrap `roku-deploy` for package publish, screenshots, and device metadata when
@@ -53,7 +55,8 @@ Keep it platform-focused, typed, and useful for both humans and agents.
53
55
  - Avoid sleeps in generic commands. App repos can add meaningful wait/assert
54
56
  loops around `rokit` primitives.
55
57
  - Release details live in `docs/DISTRIBUTION.md`; debugging details live in
56
- `docs/DEBUGGING.md`; readiness details live in `docs/READINESS.md`.
58
+ `docs/DEBUGGING.md`; readiness details live in `docs/READINESS.md`;
59
+ consumer skill guidance lives in `skills/rokit/SKILL.md`.
57
60
 
58
61
  ## When Contracts Change
59
62
 
package/README.md CHANGED
@@ -160,6 +160,7 @@ artifacts.
160
160
  - [Roku debugging](./docs/DEBUGGING.md)
161
161
  - [Distribution](./docs/DISTRIBUTION.md)
162
162
  - [Agent readiness](./docs/READINESS.md)
163
+ - [rokit skill](./skills/rokit/SKILL.md)
163
164
  - [Security](./SECURITY.md)
164
165
 
165
166
  ## Repo Internals
@@ -38,11 +38,11 @@ Release writes use the `putio-release-bot` installation token. The default `GITH
38
38
 
39
39
  ## Package Contents
40
40
 
41
- The npm package includes `dist`, `README.md`, `docs`, `examples`, `AGENTS.md`,
42
- `CONTRIBUTING.md`, and `SECURITY.md`. The docs and generic live probe are
43
- included so agents consuming the package can inspect readiness, distribution,
44
- security, and generic Roku proof mechanics without cloning extra private
45
- context.
41
+ The npm package includes `dist`, `README.md`, `docs`, `examples`, `skills`,
42
+ `AGENTS.md`, `CONTRIBUTING.md`, and `SECURITY.md`. The docs, consumer skill, and
43
+ generic live probe are included so agents consuming the package can inspect
44
+ readiness, distribution, security, and generic Roku proof mechanics without
45
+ cloning extra private context.
46
46
 
47
47
  ## Release Smoke
48
48
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@putdotio/rokit",
3
- "version": "2.2.0",
3
+ "version": "2.3.0",
4
4
  "description": "A tiny CLI companion for Roku device harness work.",
5
5
  "keywords": [
6
6
  "cli",
@@ -28,7 +28,8 @@
28
28
  "docs",
29
29
  "examples",
30
30
  "README.md",
31
- "SECURITY.md"
31
+ "SECURITY.md",
32
+ "skills"
32
33
  ],
33
34
  "type": "module",
34
35
  "sideEffects": false,
@@ -57,19 +58,19 @@
57
58
  "verify": "vp check . && tsc --noEmit && vp run test && npm pack --dry-run"
58
59
  },
59
60
  "dependencies": {
60
- "@effect/platform-node": "4.0.0-beta.66",
61
- "effect": "4.0.0-beta.66",
62
- "roku-deploy": "3.17.3"
61
+ "@effect/platform-node": "4.0.0-beta.69",
62
+ "effect": "4.0.0-beta.69",
63
+ "roku-deploy": "3.17.4"
63
64
  },
64
65
  "devDependencies": {
65
- "@effect/vitest": "4.0.0-beta.66",
66
+ "@effect/vitest": "4.0.0-beta.69",
66
67
  "@types/node": "^25.8.0",
67
68
  "typescript": "^6.0.2",
68
- "vite-plus": "^0.1.20",
69
+ "vite-plus": "^0.1.22",
69
70
  "vitest": "^4.1.6"
70
71
  },
71
72
  "engines": {
72
73
  "node": ">=24.14.0"
73
74
  },
74
- "packageManager": "pnpm@11.0.0"
75
+ "packageManager": "pnpm@11.2.2"
75
76
  }
@@ -1,9 +1,9 @@
1
1
  ---
2
- name: rokit-harness
3
- description: Use rokit as a generic Roku harness adapter for packaging, installing, launching, key input, ECP/SceneGraph/media-player observation, readiness waits, debug console capture, screenshots, and proof bundles.
2
+ name: rokit
3
+ description: Use when testing, sideloading, deploying, or debugging Roku apps with rokit, including package/install/launch flows, remote key input, BrightScript console capture, ECP/SceneGraph/media-player observation, screenshots, readiness waits, and proof bundles.
4
4
  ---
5
5
 
6
- # rokit Harness
6
+ # rokit
7
7
 
8
8
  Use this skill when a repo consumes `@putdotio/rokit` for Roku device harness
9
9
  work. Keep `rokit` generic and put app journeys, product selectors, fixture
@@ -33,6 +33,18 @@ repo.
33
33
  9. Use `rokit press --until-node ...` for bounded navigation loops instead of
34
34
  arbitrary sleeps.
35
35
 
36
+ ## Common Commands
37
+
38
+ ```bash
39
+ rokit describe
40
+ rokit --json snapshot --fields command,status,data.activeApp,data.mediaPlayer
41
+ rokit --dry-run package --out artifacts/live/channel.zip
42
+ rokit --dry-run launch dev
43
+ rokit --json proof artifacts/live/proof --screenshot
44
+ rokit --input-json '{"command":"press","keys":["Down","Select"]}'
45
+ rokit console artifacts/live/console.log --duration-ms 30000
46
+ ```
47
+
36
48
  ## Boundaries
37
49
 
38
50
  - Device IPs, developer passwords, screenshots, packages, and proof bundles stay