ff1-cli 1.0.1 → 1.0.3

package/docs/README.md

@@ -49,7 +49,7 @@ See the full configuration reference here: `./CONFIGURATION.md`.
     "gemini": {
       "apiKey": "your-gemini-key-here",
       "baseURL": "https://generativelanguage.googleapis.com/v1beta/openai/",
-      "model": "gemini-2.0-flash-exp",
+      "model": "gemini-2.5-flash",
       "supportsFunctionCalling": true
     }
   },
@@ -57,7 +57,7 @@ See the full configuration reference here: `./CONFIGURATION.md`.
   "playlist": {
     "privateKey": "your_ed25519_private_key_base64_here"
   },
-  "feed": { "baseURLs": ["https://feed.feralfile.com/api/v1"] },
+  "feed": { "baseURLs": ["https://dp1-feed-operator-api-prod.autonomy-system.workers.dev/api/v1"] },
   "ff1Devices": {
     "devices": [
       {
@@ -128,13 +128,15 @@ Notes:
   - Options: `-o, --output <file>`, `-v, --verbose`
 - `play <url>` – Send a media URL directly to an FF1 device
   - Options: `-d, --device <name>`, `--skip-verify`
-- `validate <file>` / `verify <file>` – Validate a DP1 playlist file
+- `validate <file-or-url>` / `verify <file-or-url>` – Validate a DP1 playlist file
 - `sign <file>` – Sign playlist with Ed25519
   - Options: `-k, --key <base64>`, `-o, --output <file>`
-- `send <file>` – Send playlist to an FF1 device
+- `send <file>` – Send a local or hosted DP-1 playlist to an FF1 device
   - Options: `-d, --device <name>`, `--skip-verify`
 - `publish <file>` – Publish a playlist to a feed server
   - Options: `-s, --server <index>` (server index if multiple configured)
+- `ssh <enable|disable>` – Manage SSH access on an FF1 device
+  - Options: `-d, --device <name>`, `--pubkey <path>`, `--ttl <duration>`
 - `config <init|show|validate>` – Manage configuration
 
 ## Usage Highlights
@@ -205,10 +207,28 @@ npm run dev -- sign playlist.json -o signed.json
 # Send to device (verifies by default)
 npm run dev -- send playlist.json -d "Living Room Display"
 
+# The send path now performs a compatibility preflight check against the target FF1.
+# If the device reports an unsupported FF1 OS version, the command fails with
+# a clear version message before any cast request is sent.
+# Send a hosted DP-1 playlist
+npm run dev -- send "https://cdn.example.com/playlist.json" -d "Living Room Display"
+
 # Play a direct URL
 npm run dev -- play "https://example.com/video.mp4" -d "Living Room Display" --skip-verify
 ```
 
+### SSH access
+
+```bash
+# Enable SSH access for 30 minutes
+ff1 ssh enable --pubkey ~/.ssh/id_ed25519.pub --ttl 30m -d "Living Room Display"
+
+# Disable SSH access
+ff1 ssh disable -d "Living Room Display"
+
+# `ff1 ssh` also performs the same FF1 OS compatibility preflight used by `send`.
+```
+
 ### Publish to feed server
 
 ```bash

package/docs/RELEASING.md

@@ -4,16 +4,45 @@ The curl installer downloads prebuilt binaries from GitHub Releases. Build one a
 
 ## Build a Release Asset (local)
 
+**macOS / Linux:**
+
 ```bash
 ./scripts/release/build-asset.sh
 ```
 
-This produces:
+**Windows (PowerShell):**
+
+```powershell
+.\scripts\release\build-asset-windows.ps1
+```
+
+This produces (names vary by OS/arch):
+
+- `release/ff1-cli-darwin-arm64.tar.gz` (and `.sha256`) on macOS
+- `release/ff1-cli-linux-x64.tar.gz` (and `.sha256`) on Linux
+- `release/ff1-cli-windows-x64.zip` (and `.sha256`) on Windows
+
+Run the appropriate script on each target platform and upload each pair to the GitHub release.
+
+## GitHub Actions
 
-- `release/ff1-cli-darwin-x64.tar.gz`
-- `release/ff1-cli-darwin-x64.tar.gz.sha256`
+- **Build** (`build.yml`): Trigger manually (Actions → Build → Run workflow) or on pull requests. Builds binaries on macOS, Linux, and Windows and uploads them as workflow artifacts for download.
+- **Release** (`release.yml`): Triggered when you **publish a release** (create a release from the repo Releases page, or publish an existing draft). Validates that `package.json` matches the tag, publishes to npm, builds binaries, then uploads them to that release. Pushing a tag alone does not run this; only creating/publishing a release does.
+
+## npm Publish Requirements
+
+- Set `NPM_TOKEN` in GitHub Actions secrets with an npm automation token.
+- Ensure `package.json` version matches the release tag (e.g. tag `1.0.2` → `"version": "1.0.2"`). The release job fails fast when they differ.
+
+## Installer Redirect
+
+`https://feralfile.com/ff1-cli-install` should redirect to:
+
+```
+https://raw.githubusercontent.com/feral-file/ff1-cli/main/scripts/install.sh
+```
 
-The exact filename depends on the OS/arch you build on. Run the script on each target platform (macOS + Linux, x64/arm64) and upload each pair to the GitHub release.
+The installer script then fetches the release assets from GitHub Releases.
 
 ## Environment Overrides
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ff1-cli",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "CLI to fetch NFT information and build DP1 playlists using Grok API",
   "main": "dist/index.js",
   "bin": {
@@ -21,7 +21,7 @@
     "start": "node dist/index.js",
     "dev": "tsx index.ts",
     "prepublishOnly": "npm run build",
-    "test": "echo \"Error: no test specified\" && exit 1",
+    "test": "tsx tests/ff1-compatibility.test.ts",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "format": "prettier --write \"**/*.{js,ts}\"",
@@ -43,24 +43,17 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@lancedb/lancedb": "^0.22.1",
-    "@mozilla/readability": "^0.6.0",
-    "@xenova/transformers": "^2.17.2",
     "axios": "^1.6.2",
+    "bonjour-service": "^1.3.0",
     "chalk": "^4.1.2",
-    "cheerio": "^1.0.0-rc.12",
     "commander": "^11.1.0",
     "dotenv": "^16.3.1",
     "dp1-js": "^1.1.0",
     "fuzzysort": "^3.1.0",
-    "jsdom": "^27.0.0",
     "openai": "^4.58.1",
-    "ora": "^5.4.1",
-    "puppeteer": "^24.22.3",
     "viem": "^2.38.2"
   },
   "devDependencies": {
-    "@types/jsdom": "^27.0.0",
     "@types/node": "^24.7.1",
     "@typescript-eslint/eslint-plugin": "^8.46.0",
     "@typescript-eslint/parser": "^8.46.0",