omnish 1.2.2 → 1.2.3

package/CHANGELOG.md

@@ -7,15 +7,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.3] - 2026-05-08
+
 ### Added
 
 - **`/run` queue shorthand `-q`**: same as `--queue` for FIFO recipe runs per chat (see `/run help`).
 - **Documentation**: [Run queue](docs/features/run-queue.md) — `-q` / `--queue`, pending vs active, `/run queue` / `resume`, pause rules, and resource model.
+- **Multi-target `/sendto`**: destination targeting now supports `wa`, `tg`, `*`, explicit `+E164`, comma-separated `+E164,+E164`, and compatibility aliases (`wa:all`, `tg:all`, etc.).
+- **Multi-file selectors for `/send` and `/sendto`**: `file1,file2`, `*.ext`, and recursive `**/*.ext` resolved from session cwd.
 
 ### Changed
 
 - **`/run queue` status**: shows the active session’s recipe, a numbered list of waiting recipe labels, and clarifies that **Pending** counts only jobs not yet started; clearer enqueue replies when items line up behind an active run.
 - **`/run help`**: documents `-q`, pending vs active semantics, and queue resume behavior.
+- **File send help semantics**: `/send`, `/files`, and `/sendto` usage text now uses the canonical grammar `/send <selectors> [-- caption]` and `/sendto <destination> <selectors> [-- caption]`.
+
+### Documentation
+
+- Updated [docs/files-send-receive.md](docs/files-send-receive.md) with selector grammar, destination matrix, result model (`recipients x files`), and failure expectations.
+- Updated [docs/guides/interactive-cli.md](docs/guides/interactive-cli.md) with `/sendto` syntax, quick recipes, and troubleshooting notes.
+- Updated [README.md](README.md) quick examples and docs index labels for multi-target `/sendto` and selector-based `/send`.
+
+[1.2.3]: https://github.com/eligapris/omnish/compare/v1.2.2...v1.2.3
 
 ## [1.2.1] - 2026-05-05
 

package/README.md

@@ -31,7 +31,7 @@
 
 - `omnish link` — QR login (WhatsApp → Linked devices), or **`omnish link --tg <bot_token>`** to save a Telegram bot token and set `gatewayMode` (`telegram`, or `both` if WhatsApp is already linked). See `omnish link --help`.
 - `omnish run` — Listen for DMs; execute commands; reply with output.
-- **`omnish i`** — Interactive terminal with the same commands as chat (local full trust; the inbox allowlist is **not** applied). Run from any directory; session cwd starts at the current directory. Use **`/sendto wa:+E164 <file>`** or **`/sendto tg:<chat_id> <file>`** to push a file through a running gateway (see `omnish i --help`). Background jobs from `/bg` in the REPL are **only** that process (not the gateway’s job list).
+- **`omnish i`** — Interactive terminal with the same commands as chat (local full trust; the inbox allowlist is **not** applied). Run from any directory; session cwd starts at the current directory. Use **`/sendto <destination> <selectors> [-- caption]`** (for example `wa`, `tg`, `*`, `+E164,+E164`) to push files through a running gateway (see `omnish i --help`). Background jobs from `/bg` in the REPL are **only** that process (not the gateway’s job list).
 - **Sync:** send `!ls` or `! ls` (prefix configurable; default `!`). Each chat has its **own working directory**; use `!cd /path` or `! cd /path` to change it (saved under the data dir, e.g. `~/.omnish/sessions.json`).
 - **Background:** `/bg long-running-command` runs in that chat’s cwd, then `/jobs`, `/log <id>`, `/tail <id>`, `/kill <id>`.
 - **Cowork:** `/cowork` / `/cw` — scheduled or on-demand saved shell tasks, logs under `~/Cowork/…` by default. See [docs/features/cowork.md](docs/features/cowork.md).
@@ -178,8 +178,8 @@ To send a literal `!`, `/`, or `>` to the attached program, use **`/apps send <n
 
 | Command | Description |
 |--------|-------------|
-| `omnish link` / `link --force` | Print QR; save session under `<data-dir>/auth/` (`--force` deletes old auth first) |
-| `omnish run` | Start gateway (foreground) |
+| `omnish link` / `link --force` | Print QR; save session under `<data-dir>/auth/` (`--force` deletes old auth first). Telegram token mode: `omnish link --tg <token>` (alias: `--telegram`). |
+| `omnish run` | Start gateway (foreground). Background: `omnish run -d [--log-file <path>]`. |
 | `omnish stop` | Stop a background gateway (`omnish run -d`; uses `<data-dir>/gateway.pid`) |
 | `omnish i` / `interactive` | Chat-equivalent REPL on your terminal; **`omnish i --help`** · [interactive-cli.md](docs/guides/interactive-cli.md) |
 | `omnish service …` | Service status, logs, install/uninstall (same trust gate as **`/service`** in chat) |
@@ -187,12 +187,46 @@ To send a literal `!`, `/`, or `>` to the attached program, use **`/apps send <n
 | `omnish allow +1555...` | Add WhatsApp number to allowlist |
 | `omnish allow tg:<id>` | Add Telegram user id |
 | `omnish deny …` | Remove allowlist entry |
-| `omnish status` | Data dir, auth, allowlists, jobs, cluster (if enabled) |
+| `omnish status [--check-updates]` | Data dir, auth, allowlists, jobs, cluster (if enabled); optional live npm/update check |
+| `omnish commands` | Print chat command help on the host terminal (`/help` equivalent) + `/config`-editable keys |
+| `omnish security [--json]` | Local security posture report (`--json` for scripts; non-zero exit on error findings) |
 | `omnish cluster [status \| use <sender> <label-or-id>]` | Show cluster state or seed a sender → machine binding |
 
 Config: `<data-dir>/config.json` (see [config.example.json](config.example.json)). Use `omnish status` for the resolved path.
 
-Chat (allowlisted): **`/config`** (view/set many keys), **`/c`** · **`/pcs`** · **`/computers`** (chat-driven cluster — `/c here` to take over, `/c help`), **`/reload`** — see [docs/features/cluster-and-chat-config.md](docs/features/cluster-and-chat-config.md).
+Chat (allowlisted): **`/config`** (view/set many keys), **`/c`** · **`/pcs`** · **`/computers`** (chat-driven cluster — `/c here` to take over, `/c help`), **`/reload`**, **`/updates`** (`/updates cached`), **`/security`** (`summary`, `tips`), **`/service`** (`status`, `instructions`, `logs`, optional `install/uninstall`) — see [docs/features/cluster-and-chat-config.md](docs/features/cluster-and-chat-config.md).
+
+### Quick file-send examples
+
+```text
+/send ./photo.png
+/send ./file1.mp4,./file2.mp4 -- Files for today
+/send **/*.mp4
+/sendto wa ./promo.mp4
+/sendto * intro.mp4,notes.pdf -- Shared files
+/sendto +15550000001,+15550000002 file1.png,file2.png
+```
+
+Quick meaning:
+
+- `/send` sends to the current chat.
+- `/sendto` lets you pick recipients directly.
+- Selectors can be exact files (`a,b`) or patterns (`*.mp4`, `**/*.mp4`).
+
+### First `/sendto` in 5 commands
+
+```bash
+omnish run
+omnish i
+!cd ~/Downloads
+/sendto wa ./photo.png
+/sendto * *.mp4 -- Video batch
+```
+
+What to expect:
+
+- Command 4 sends one file to all allowlisted WhatsApp numbers.
+- Command 5 sends matching videos to allowlisted WhatsApp + Telegram recipients.
 
 ## Documentation
 
@@ -201,7 +235,7 @@ Index and curated paths: **[docs/README.md](docs/README.md)**.
 | Topic | Doc |
 |-------|-----|
 | Vision — local first, product direction | [docs/vision.md](docs/vision.md) |
-| Interactive terminal (`omnish i`, `/sendto`) | [docs/guides/interactive-cli.md](docs/guides/interactive-cli.md) |
+| Interactive terminal (`omnish i`, `/sendto` multi-target) | [docs/guides/interactive-cli.md](docs/guides/interactive-cli.md) |
 | Configuration (`config.json`) | [docs/guides/configuration.md](docs/guides/configuration.md) |
 | Browser setup UI (`omnish ui`) | [docs/guides/ui.md](docs/guides/ui.md) |
 | Cluster roster + `/config` from chat | [docs/features/cluster-and-chat-config.md](docs/features/cluster-and-chat-config.md) |
@@ -213,7 +247,7 @@ Index and curated paths: **[docs/README.md](docs/README.md)**.
 | System agents + `/run` | [docs/guides/system-agents-and-run.md](docs/guides/system-agents-and-run.md) |
 | MCP IDE spike (experimental) | [contrib/mcp-spike/README.md](contrib/mcp-spike/README.md) |
 | Telegram | [docs/telegram-integration-notes.md](docs/telegram-integration-notes.md) |
-| Send/receive files | [docs/files-send-receive.md](docs/files-send-receive.md) |
+| Send/receive files (`/send` selectors, `/sendto` destinations) | [docs/files-send-receive.md](docs/files-send-receive.md) |
 | Troubleshooting | [docs/advanced/troubleshooting.md](docs/advanced/troubleshooting.md) |
 | Implementation / contributors | [docs/advanced/implementation.md](docs/advanced/implementation.md) |
 | Architecture (legacy) | [docs/architecture-and-implementation.md](docs/architecture-and-implementation.md) |