diff --git a/AGENTS.md b/AGENTS.md index 5cc01f4..9c28c63 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -103,36 +103,40 @@ 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`; no +global install is needed. + ```bash -vp install -vp run hooks:install -vp run verify +pnpm install +pnpm exec vp run hooks:install +pnpm exec vp run verify ``` Fast loops: ```bash -vp run check -vp run typecheck -vp run smoke -vp run test +pnpm exec vp run check +pnpm exec vp run typecheck +pnpm exec vp run smoke +pnpm exec vp run test ``` -Live Roku checks when a developer-enabled device exists: +Live Roku checks when a developer-enabled device exists; `node dist/rokit.mjs` +is the CLI that `live:smoke` builds: ```bash -ROKIT_TARGET= vp run live:smoke -ROKIT_TARGET= ROKIT_PASSWORD= vp run live:probe -ROKIT_TARGET= vp exec rokit check -ROKIT_TARGET= vp exec rokit launch dev -ROKIT_TARGET= vp exec rokit press Info Back +ROKIT_TARGET= pnpm exec vp run live:smoke +ROKIT_TARGET= ROKIT_PASSWORD= pnpm exec vp run live:probe +ROKIT_TARGET= node dist/rokit.mjs check +ROKIT_TARGET= node dist/rokit.mjs launch dev +ROKIT_TARGET= node dist/rokit.mjs press Info Back ``` Which proof a change needs: -- Docs only: `vp run check`, plus `vp run skills:lint` for `skills/`; no - device run. -- Source, command, env, output or export changes: `vp run verify`. +- Docs only: `pnpm exec vp run check`, plus `pnpm exec vp run skills:lint` for + `skills/`; no device run. +- 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). diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index af1d50c..c038448 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -3,7 +3,7 @@ ## Setup ```bash -vp install +pnpm install ``` ## Run Locally @@ -11,7 +11,7 @@ vp install Use the built CLI through the package scripts while developing: ```bash -vp run smoke +pnpm exec vp run smoke ``` For live Roku checks, set local environment variables in your shell or @@ -20,7 +20,7 @@ For live Roku checks, set local environment variables in your shell or ## Validation ```bash -vp run verify +pnpm exec vp run verify ``` `verify` runs formatting/lint checks, skill lint, TypeScript, package bundling, @@ -32,8 +32,8 @@ before release. Live checks require a developer-enabled Roku on the same network: ```bash -ROKIT_TARGET= vp run live:smoke -ROKIT_TARGET= vp exec rokit press Info Back +ROKIT_TARGET= pnpm exec vp run live:smoke +ROKIT_TARGET= node dist/rokit.mjs press Info Back ``` Screenshots and installs require `ROKIT_PASSWORD`.