@dashai/cli 0.21.0 → 0.23.0

package/README.md

@@ -427,6 +427,16 @@ Flags:
 - `--exclude <pattern...>` — Extra exclude patterns appended to the defaults.
 - `--dir <path>` — Project root.
 
+### `dashwise module runtime` / `module runtime set` / `module rebuild`
+
+Admin-granted controls for a deployed module (plan: `module-admin-controls-plan.md`). Each needs a grant your Dashwise admin makes per workspace; without it the command prints one sentence such as `Streaming for raise-tracker needs a Dashwise admin. Ask your Dashwise admin to enable it.` and exits **3** (other failures exit 1; exit **4** means it stopped waiting at `--timeout`, and the change or build may still finish).
+
+- `dashwise module runtime [slug] [--install <id>] [--workspace <ws>] [--json]`: streaming (requested vs in effect), memory, eligibility, grant state, last change.
+- `dashwise module runtime set [slug] --streaming on|off [--memory <mb>] [--reason <text>] [--install <id>] [-y] [--no-wait] [--timeout <s>] [--json]`: switch streaming (about a minute; waits by default). `--memory` is operator-only today and is refused with a hint.
+- `dashwise module rebuild [slug] [--platform-defaults manifest|on|off] [--clean] [--bump patch] [--rollout none|installs:<ids>|workspace[:<id>]] [--from-build <id>] [--reason <text>] [--no-wait] [--timeout <s>] [--json]`: a new patch version from the published source with today's platform image; `--bump minor|major` needs a Dashwise admin.
+
+`--json` puts every outcome on stdout as one object. Refusals and failures print `{ "error": { code, message, status, context }, "hint", "needs_grant" }` (`error.code` `USAGE` for a bad invocation), with the failed `build` or `operation` attached when one ran; a timeout adds `"timed_out": true`.
+
 ### `dashwise query`
 
 Run a typed query against the local module's installation via the `@dashai/sdk/query` plane. Three modes:
@@ -797,3 +807,38 @@ The CLI persists state at `$XDG_CONFIG_HOME/dashwise/auth.json` (typically `~/.c
 ## License
 
 MIT
+
+### `dashwise module release [slug]`
+
+Release code already pushed to the module's linked GitHub repository. This uses
+saved `dashwise login` authentication and the same release admission as the
+Builder and MCP. It does not upload local files. The backend must include the
+repository release contract from `Intuize/dashwise-backend#985`.
+
+```bash
+dashwise module release my-module --commit-sha <full-40-character-sha> --yes
+dashwise module release my-module --build 51
+```
+
+The positional slug wins over `module.json` in `--dir` (default current directory).
+For a new release, `--commit-sha` is required and must already exist in the linked
+repository. Branch names, abbreviated SHAs and an inferred latest push are not
+accepted. `--bump patch|minor|major` defaults to `minor`, matching the repository
+API. Release asks for confirmation only when both stdin and stdout are interactive
+and JSON mode is off. Redirected streams and `--json` require explicit `--yes`.
+
+The command waits for the build and prints the build ID, immutable revision and
+released version. `--no-wait` returns once accepted: exit 0 then means queued,
+not released. `--timeout <seconds>` defaults to 360; exit 4 means the wait expired.
+Resume checking with `--build <id>`; this performs only reads and cannot enqueue
+another version. Do not combine it with `--commit-sha`, `--bump` or `--no-wait`.
+An ambiguous enqueue/network failure is not retried automatically; check the
+module's build history in Dashwise before requesting another release.
+
+`--json` emits one result or error on stdout. Success includes `id`, `commit_sha`,
+`version` and `module_version_id`; timeout includes `build_id`, `timed_out` and
+`resume_command`. Refusals and failed builds return nonzero (exit 3 for known
+missing-grant refusals, otherwise 1). Access revoked while waiting stops polling.
+Release creates a version; installing or updating it in Live remains a human
+action. For a module without a linked repository, use the local
+`dashwise module publish` flow instead.