affect-cli 0.0.0-stage → 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ludicrous
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,42 @@
-# Temporary Holding Version
+# affect-cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Shared environment and deployment commands for [Affect](https://github.com/ludicroushq/affect). Requires Bun 1.4.2 or later and a project-local Convex CLI.
+
+```sh
+bun add --dev --exact affect-cli
+bunx --no-install affect --help
+```
+
+Run commands from the application repository root:
+
+- `affect env` prints shell exports from `env/{development,preview,production,ci}/.env`. It requires the matching `DOTENV_PRIVATE_KEY` when that file exists. Treat its output as secrets.
+- `affect dotenvx -- …` forwards arguments to the bundled native dotenvx CLI, for example `affect dotenvx -- encrypt -f env/development/.env --no-armor --no-native`.
+- `affect setup` initializes an anonymous local Convex backend only for a fresh project, or retries its environment import. It preserves existing linked deployments and credentials.
+- `affect deploy` uses Convex's native deploy/build sequence, imports the selected backend environment, and builds the frontend. It requires `VERCEL_ENV=preview|production`, a matching deploy key in the encrypted file, and a branch name for previews. `--build` is its internal Convex callback.
+
+Selection uses `VERCEL_ENV`, then `ci` for GitHub Actions/CI, otherwise `development`. Files stay in the application; cryptography stays in dotenvx. Deployment follows Affect's `apps/web` layout.
+
+For Mise, install dependencies once, then use:
+
+```toml
+[env]
+_.source = { path = "node_modules/affect-cli/scripts/activate.sh", tools = true, redact = true }
+_.file = { path = ".env.local", tools = true }
+
+[tasks.setup]
+run = "bun install --frozen-lockfile && bunx --no-install affect setup"
+```
+
+The Bash bridge only exports the CLI's output into the parent shell. It does not change backend state.
+
+## Development and releases
+
+```sh
+bun install --frozen-lockfile
+bun run check
+bun run changeset
+bun run changeset version
+bun run release
+```
+
+Version `0.0.1` is prepared for the first publication; do not bump it before publishing. Future changes use Changesets. `release` publishes to npm and creates a Git tag, so run it only when ready to publish.