@dvmkit/dvmctl 0.0.0 → 0.2.0-rc.2

package/README.md

@@ -1,5 +1,42 @@
-# @dvmkit/dvmctl
+# dvmctl
 
-This one-purpose bootstrap version establishes the package name before trusted release automation publishes under it. It contains no executable.
+Standalone builder CLI for creating, validating, serving, and deploying Digital Vending Machines.
 
-`dvmctl` is the builder tool for Digital Vending Machines: it scaffolds a DVM, runs it locally, deploys it and operates it. Install a release candidate with `npm install --global @dvmkit/dvmctl@next` once one is on the `next` dist-tag. Documentation is at https://dvmkit.ai.
+Install this exact release:
+
+<!-- x-release-please-start-version -->
+```bash
+npm install -g @dvmkit/dvmctl@0.2.0-rc.2
+```
+<!-- x-release-please-end -->
+
+Install the complete bundled skill directory so its references remain available:
+
+<!-- x-release-please-start-version -->
+```bash
+npm install --ignore-scripts --prefix "$HOME/.dvmkit" @dvmkit/dvmctl@0.2.0-rc.2
+skill_dir="$(dirname "$(NODE_PATH="$HOME/.dvmkit/node_modules" node -p "require.resolve('@dvmkit/dvmctl/skill')")")"
+```
+<!-- x-release-please-end -->
+
+For Claude Code:
+
+```bash
+mkdir -p "$HOME/.claude/skills/build-dvm"
+cp -R "$skill_dir"/. "$HOME/.claude/skills/build-dvm/"
+```
+
+For Codex in the current project:
+
+```bash
+mkdir -p .agents/skills/build-dvm
+cp -R "$skill_dir"/. .agents/skills/build-dvm/
+```
+
+For another agent harness, copy the complete directory to its project-skill location. Add `Read .agents/skills/build-dvm/SKILL.md before building or changing a DVM.` to the project's `AGENTS.md` when that harness uses it.
+
+Create a project with `dvmctl create my-dvm`, then run `cd my-dvm && npm install`. Use `dvmctl validate` before deployment. Run `dvmctl dev handler.ts` for local development or `dvmctl serve handler.ts` for the production server. Serving requires a configured handler and any database or payment environment variables that handler uses.
+
+The repository field exists only for npm trusted-publishing identity. The source repository is private and currently unavailable to package users; it is not a public source-provenance link.
+
+For private-beta security reports while the source is private, email [security@dvmkit.com](mailto:security@dvmkit.com).