@toist/in 0.6.1 → 0.8.0

package/CHANGELOG.md

@@ -2,6 +2,75 @@
 
 All notable changes to `@toist/in` are recorded here.
 
+## 0.8.0 — 2026-05-08
+
+`@toist/in` is now the user-facing package: ships the `toist` CLI binary
+plus the scaffolding wizard. `bun add -g @toist/in` followed by
+`toist <subcommand>` is the daily-use shape; `bunx @toist/in` runs the
+wizard for first-touch scaffolding.
+
+**`toist` CLI subcommands:**
+
+- `toist init [dir]` — wizard scaffolds default / embedded / embedded-memory
+  template
+- `toist run <file>` — execute a pipeline locally; durable storage at
+  `XDG_STATE_HOME/toist` (or `~/.toist/`) by default
+  - `--remote <url>` — execute against a remote runner
+  - `--spec-stdin` — read spec YAML from stdin
+  - `--payload '<json>' | @file.json | -stdin` — payload sources
+  - `--suspend-as-json` — emit `{runId,suspendedAt}` on suspension (no
+    interactive prompt)
+  - `--ephemeral` — in-memory only; no persistence
+- `toist resume <runId>` — resume a suspended local run
+- `toist serve` — start the durable runner (via `@toist/aja`'s `startRunner`)
+- `toist tasks list/answer` — task queue inspection + answer+resume
+  one-shot, local or `--remote`
+- `toist validate <file...>` — validate one or many specs
+- `toist plan <file> [--format ascii|dot]` — render the DAG
+- `toist upgrade` — bump local `@toist/*` deps
+
+**Inline HITL prompt:** when a `human.input` task fires during `toist
+run`, the CLI sniffs the schema (boolean / string / single-property
+object / json / value) and prompts on stderr. Stdout stays pure JSON.
+
+**Templates:** wizard offers three options — `default` (durable
+runner), `embedded` (`.toist/` adoption inside an existing repo),
+`embedded-memory` (library-only, no HTTP runner).
+
+**New dependencies:** `@toist/aja@0.8.0`, `@toist/core@0.8.0`,
+`@toist/spec@0.8.0`.
+
+Scaffold template pins `@toist/aja` and `@toist/spec` to `^0.8.0`.
+
+## 0.7.1 — 2026-05-06
+
+Fix @toist/aja cross-package dependency versions not being bumped by release script
+
+Scaffold template pins `@toist/aja` and `@toist/spec` to `^0.7.1`.
+
+## 0.7.0 — 2026-05-06
+
+Add @toist/aja CLI (bunx @toist/aja --config toist.yml) and @toist/in interactive setup wizard (bunx @toist/in). Establishes aja=runner, in=adoption tool split. No forced directory layout — user chooses paths via wizard, config drives the runner.
+
+Scaffold template pins `@toist/aja` and `@toist/spec` to `^0.7.0`.
+
+## Unreleased
+
+Clarify `@toist/in` as the Toist adoption tool, not only a scaffold CLI.
+
+- `bunx @toist/in` scaffolds `.toist/` in the current repo — one clear
+  action, no silent branching.
+- `bunx @toist/in upgrade` is now the explicit upgrade subcommand.
+- `bunx @toist/in <path>` scaffolds a dedicated Toist home at `<path>`.
+- Added a dedicated embedded template for repo-owned `.toist/` layout
+  (no nested `package.json`, kinds import examples pointing to host
+  source tree, `instance.json` stub, `TOIST_PORT` env var).
+- `bunx @toist/in upgrade` from inside `.toist/` resolves the host
+  repo's `package.json` automatically.
+- Template/docs language now distinguishes dedicated instance
+  directories from embedded existing-project mode.
+- Added package README documenting the two adoption modes.
+
 ## 0.6.1 — 2026-05-05
 
 Fix published @toist/aja dependency resolution for embedded runners and include the typed runner client/smoke-test surface.

package/README.md

@@ -0,0 +1,64 @@
+# `@toist/in`
+
+The user-facing Toist package. It ships the `toist` CLI and the project scaffolding templates.
+
+```sh
+bunx @toist/in
+```
+
+That scaffolds a fresh Toist project in `./toist` by default.
+
+## Install once, use everywhere
+
+```sh
+bun add -g @toist/in
+toist run pipelines/hello.yml --payload '{"name":"world"}'
+```
+
+## Commands
+
+| Command | Purpose |
+|---|---|
+| `toist init [dir]` | scaffold a project or embedded `.toist/` home |
+| `toist run <file>` | run a spec locally |
+| `toist run <file> --remote <url>` | run a spec against a runner |
+| `toist resume <runId>` | resume a suspended local run |
+| `toist serve` | start the durable runner |
+| `toist tasks list` | list open local tasks |
+| `toist tasks answer <id>` | answer a task and resume its run |
+| `toist validate <file...>` | validate specs |
+| `toist plan <file>` | render the DAG as ASCII or DOT |
+| `toist upgrade` | bump local `@toist/*` dependencies |
+
+## Run modes
+
+Local `toist run` defaults to durable CLI storage under `XDG_STATE_HOME/toist` or `~/.toist/`.
+
+```sh
+toist run approval.yml --payload '{"amount":50}'
+toist resume 1 --response '{"approved":true}'
+```
+
+For pipes and generated specs:
+
+```sh
+cat payload.json | toist run pipelines/hello.yml
+echo 'apiVersion: "2121.fi/v1"\nid: hello\n...' | toist run --spec-stdin --payload '{}'
+```
+
+For remote execution:
+
+```sh
+toist serve
+toist run pipelines/hello.yml --remote :5172 --payload '{"name":"world"}'
+toist tasks list --remote :5172
+toist tasks answer 1 --remote :5172 --response '{"approved":true}'
+```
+
+## Templates
+
+The wizard ships three templates:
+
+- `default` — durable runner
+- `embedded` — repo-owned `.toist/` runner
+- `embedded-memory` — library-only `runSpec()` example

package/package.json

@@ -1,16 +1,23 @@
 {
   "name": "@toist/in",
-  "version": "0.6.1",
+  "version": "0.8.0",
   "type": "module",
-  "description": "Scaffold a new toist instance: bunx @toist/in <path>",
+  "description": "Adopt Toist into a repo: scaffold a Toist home or embedded .toist layout",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
   "bin": {
-    "toist-in": "./src/index.ts"
+    "toist": "./src/cli.ts",
+    "toist-in": "./src/cli.ts"
   },
   "files": [
     "src/",
     "templates/",
-    "CHANGELOG.md"
-  ]
+    "CHANGELOG.md",
+    "README.md"
+  ],
+  "dependencies": {
+    "@toist/aja": "0.8.0",
+    "@toist/core": "0.8.0",
+    "@toist/spec": "0.8.0"
+  }
 }