@toist/in 0.7.1 → 0.8.0

package/CHANGELOG.md

@@ -2,6 +2,46 @@
 
 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

package/README.md

@@ -1,46 +1,64 @@
 # `@toist/in`
 
-Interactive setup wizard for Toist.
+The user-facing Toist package. It ships the `toist` CLI and the project scaffolding templates.
 
 ```sh
 bunx @toist/in
 ```
 
-Asks a few questions, writes `toist.yml`, creates your chosen directories.
-Then start the runner with:
+That scaffolds a fresh Toist project in `./toist` by default.
+
+## Install once, use everywhere
 
 ```sh
-bunx @toist/aja
+bun add -g @toist/in
+toist run pipelines/hello.yml --payload '{"name":"world"}'
 ```
 
-## What the wizard asks
+## Commands
 
-```
-Instance name?                [my-project]
-Pipelines dir?                [pipelines]
-Resources dir?                [resources]
-Data dir?                     [data]
-Port?                         [3000]
-Register custom TypeScript kinds? [y/N]
-  Kind file path?             [src/kinds/index.ts]
-  Add another?                [y/N]
+| 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}'
 ```
 
-## What it produces
+For pipes and generated specs:
 
-`toist.yml` in the current directory — that's it. All paths are yours
-to choose. There is no enforced layout.
+```sh
+cat payload.json | toist run pipelines/hello.yml
+echo 'apiVersion: "2121.fi/v1"\nid: hello\n...' | toist run --spec-stdin --payload '{}'
+```
 
-## Upgrade
+For remote execution:
 
 ```sh
-bunx @toist/in upgrade
+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}'
 ```
 
-Finds `package.json` and bumps every `@toist/*` dep to latest.
+## Templates
 
-## See also
+The wizard ships three templates:
 
-- `@toist/aja` — the runner: `bunx @toist/aja --config toist.yml`
-- `context/instance-spec.md`
-- https://toist.in
+- `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.7.1",
+  "version": "0.8.0",
   "type": "module",
   "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",
     "README.md"
-  ]
+  ],
+  "dependencies": {
+    "@toist/aja": "0.8.0",
+    "@toist/core": "0.8.0",
+    "@toist/spec": "0.8.0"
+  }
 }