From f9808b5c720956b6ff7590f91dda3c06c2b9c4c4 Mon Sep 17 00:00:00 2001 From: Altay Date: Tue, 27 Oct 2026 12:11:48 +0300 Subject: [PATCH 1/3] docs: link CONTRIBUTING for setup instead of mirroring it --- AGENTS.md | 22 +--------------------- 1 file changed, 1 insertion(+), 21 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 9a65e37..0b5fdf6 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -49,10 +49,6 @@ for humans and agents. cross-platform and test against fake TCP servers. The binary BrightScript debug protocol is out of scope; crash capture needs append-only text. - No sleeps in generic commands; app repos add wait loops around primitives. -- CLI tests call in-process entry points (`mainEffect` from `src/cli.ts` or the - command effects) so V8 coverage counts them. Spawn `dist/rokit.mjs` only to - test the process boundary; `vite.config.ts` does not count - those runs. ## Effect @@ -68,23 +64,7 @@ touches, and search `node_modules/effect/src` for anything it does not cover. ## Checks Vite+ is the pinned `vite-plus` devDependency, so run it as `pnpm exec vp`. -In a new worktree, run the setup commands; `.worktreeinclude` copies local env -files in. - -```bash -pnpm install -pnpm exec vp run hooks:install -pnpm exec vp run verify -``` - -Live checks need a developer-enabled Roku. The CLI reads `.rokit/.env`; -`live:probe` also reads `.env` and `.env.local`. See `.env.example`. - -```bash -ROKIT_TARGET= pnpm exec vp run live:smoke -ROKIT_TARGET= ROKIT_PASSWORD= pnpm exec vp run live:probe -ROKIT_TARGET= node dist/rokit.mjs press Info Back -``` +Setup, validation, and live checks: [CONTRIBUTING](CONTRIBUTING.md). Which proof a change needs: From cc38c57ed31d5c54608745529c18d167b1aef18f Mon Sep 17 00:00:00 2001 From: Altay Date: Tue, 27 Oct 2026 12:13:40 +0300 Subject: [PATCH 2/3] docs: keep the live-check env var names --- AGENTS.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 0b5fdf6..e98f995 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -73,6 +73,8 @@ Which proof a change needs: - Source, command, env, output or export changes: `pnpm exec vp run verify`. - Device-facing behavior: `verify`, then `live:smoke` (read-only) or `live:probe` (installs the generic probe channel). + Both need `ROKIT_TARGET`; `live:probe` also needs `ROKIT_PASSWORD`. Names + in `.env.example`; values may come from `.env` or `.env.local`. ## Delivery From 1e20701cf2686949c7cfc09caa35c6e359fc7933 Mon Sep 17 00:00:00 2001 From: Altay Date: Tue, 27 Oct 2026 12:22:28 +0300 Subject: [PATCH 3/3] docs: cut agent-guide lines that CI and Renovate own --- AGENTS.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index e98f995..0076b12 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -84,8 +84,7 @@ Open a pull request. Release rules no file enforces: workflow [`ci.yml`](https://github.com/putdotio/rokit/blob/main/.github/workflows/ci.yml), and Environment `release`. Renaming any of them breaks publishing until the npm setting matches. - Keep `effect` and every `@effect/*` package in [`package.json`](package.json) - on one exact version. A newer shared runtime can break the pinned Effect. The - shared preset inherited by [`renovate.json`](renovate.json) moves them together. + on one exact version. A newer shared runtime can break the pinned Effect. - The build bundles `jpeg-js` with the patch in [`patches/`](https://github.com/putdotio/rokit/blob/main/patches), because npm consumers do not inherit pnpm patches. Drop it only when a pinned upstream release passes the partial-interval and early-end-marker