@feralfile/cli 2.10.0 → 2.10.1

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@feralfile/cli",
-    "version": "2.10.0",
+    "version": "2.10.1",
     "description": "CLI for building, signing, and playing DP-1 playlists of digital art on Feral File devices",
     "repository": {
         "type": "git",
@@ -65,7 +65,7 @@
         "chalk": "^4.1.2",
         "commander": "^11.1.0",
         "dotenv": "^16.3.1",
-        "dp1-js": "2.3.1",
+        "dp1-js": "2.4.1",
         "ff1": "^1.0.0",
         "fuzzysort": "^3.1.0",
         "viem": "^2.56.3"

package/dist/src/commands/find.js

@@ -41,10 +41,11 @@ exports.findCommand = new commander_1.Command('find')
     .option('-o, --output <path>', 'Save the playlist to this file (default: ./<slug>.json)')
     .option('-l, --limit <n>', 'Max tokens to include from the series (default: all)')
     .option('-p, --play', 'Play the playlist on an FF1 device after building')
+    .option('--no-play', 'Never cast to a device; combine with -y to build and save without playing')
     .option('-d, --device <name>', 'Device to play on (used with --play; default: first configured)')
     .option('--publish', 'Publish the playlist to a configured feed server')
     .option('-s, --server <index>', 'Feed server index (used with --publish)')
-    .option('-y, --yes', 'Skip interactive prompts; defaults to Play unless --output or --publish is set')
+    .option('-y, --yes', 'Skip interactive prompts. Without --output or --publish, -y plays the playlist on a device; add --no-play to skip casting')
     .option('--skip-verify', 'Skip signature verification before --play (mirrors `ff-cli play --skip-verify`)')
     .action(async (input, options) => {
     try {
@@ -478,9 +479,16 @@ async function confirmMakePlaylist(count, hasMore) {
  * Precedence: explicit flags (--play / --publish) win and may combine. If no
  * flag is set, fall back to --yes default (Play) or an interactive 3-way
  * prompt. Save is unconditional and already done before this is called.
+ *
+ * `--no-play` (commander sets `play === false`) is an opt-out that removes
+ * casting from every path, including the `--yes` default and the interactive
+ * prompt. It is additive: `--yes` alone keeps its deliberate "max-satisfaction
+ * default for scripted use" of Play, and this must not change that. Because
+ * `--no-play` already states the user's intent, it never opens the prompt.
  */
 async function decideActions(options) {
     const flagActions = [];
+    const noPlay = options.play === false;
     if (options.play) {
         flagActions.push('play');
     }
@@ -491,7 +499,8 @@ async function decideActions(options) {
         return flagActions;
     }
     // --output alone (with or without --yes) means "save mode" — the save was the action.
-    if (options.output) {
+    // --no-play likewise means the save was the action; never prompt or default to Play.
+    if (options.output || noPlay) {
         return [];
     }
     // --yes without --output defaults to Play (max-satisfaction default for scripted use).

package/docs/EXAMPLES.md

@@ -64,6 +64,9 @@ npm run dev -- find https://objkt.com/tokens/hicetnunc/111068 --publish
 
 # Build, play on a named device, and skip interactive prompts
 npm run dev -- find https://objkt.com/tokens/hicetnunc/111068 --play -d "Living Room Display" -y
+
+# -y alone also plays (the scripted default); add --no-play to build and save without casting
+npm run dev -- find https://objkt.com/tokens/hicetnunc/111068 -y --no-play
 ```
 
 OpenSea and Verse accept both item and collection/series URLs:

package/docs/README.md

@@ -122,7 +122,7 @@ Both paths run the same deterministic pipeline: fetch metadata, assemble a DP-1
   - Sources: Art Blocks, Objkt, fxhash, OpenSea, SuperRare, Feral File, Neort, Verse, raw on-chain coordinates, and wallet addresses
   - OpenSea forms: `/assets/ethereum/{contract}/{tokenId}`, `/item/ethereum/{contract}/{tokenId}`, and `/collection/{slug}` (Ethereum collections; the slug is resolved from the public collection page, no API key needed)
   - Verse forms: `/items/ethereum/{contract}/{tokenId}` and `/series/{slug}`
-  - Options: `-o, --output <path>`, `-l, --limit <n>`, `-p, --play`, `-d, --device <name>`, `--publish`, `-s, --server <index>`, `-y, --yes`, `--skip-verify`
+  - Options: `-o, --output <path>`, `-l, --limit <n>`, `-p, --play`, `--no-play` (never cast; combine with `-y` to build and save without playing), `-d, --device <name>`, `--publish`, `-s, --server <index>`, `-y, --yes` (skip prompts; without `-o` or `--publish` it plays the playlist on a device, so add `--no-play` to skip casting), `--skip-verify`
 - `enrich <file>` – Add missing artist, title, and thumbnail metadata to a playlist that already exists. Resolves each item by its `provenance.contract` and writes an inline Ref Manifest; `source`, `duration`, `title`, and `id` are never touched. Drops the signature when it changes anything, so re-sign afterwards
   - DP-1 `evm` names a chain family rather than a network, so those items are skipped unless `--assume-ethereum` asserts which one they are. Getting that wrong attaches another artwork's metadata
   - Options: `-o, --output <file>`, `--force` (replace existing manifests), `--assume-ethereum`, `-v, --verbose`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feralfile/cli",
-  "version": "2.10.0",
+  "version": "2.10.1",
   "description": "CLI for building, signing, and playing DP-1 playlists of digital art on Feral File devices",
   "repository": {
     "type": "git",
@@ -65,7 +65,7 @@
     "chalk": "^4.1.2",
     "commander": "^11.1.0",
     "dotenv": "^16.3.1",
-    "dp1-js": "2.3.1",
+    "dp1-js": "2.4.1",
     "ff1": "^1.0.0",
     "fuzzysort": "^3.1.0",
     "viem": "^2.56.3"