@feralfile/cli 1.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Feral File
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,96 @@
+# ff-cli
+
+A small Node.js CLI for building DP-1 playlists of digital art.
+
+**Runtime:** Node.js 22 or newer (matches CI and the `dp1-js` dependency). That engine floor is a **breaking** change if you previously used Node 18 or 20—check the **GitHub Release** for the version you move to; release authors follow `docs/RELEASING.md` so the notes stay explicit.
+
+ff-cli turns a simple prompt into a DP-1–conformant playlist you can preview on an Art Computer. The model orchestrates; deterministic tools do the real work (schema validation, indexing, JSON‑LD). If something comes back invalid, validation rejects it and we loop until it’s right.
+
+## Install
+
+```bash
+npm i -g @feralfile/cli
+```
+
+## Install (curl)
+
+```bash
+curl -fsSL https://feralfile.com/ff-cli-install | bash
+```
+
+Installs a prebuilt binary for macOS/Linux (no Node.js required).
+
+## One-off Usage (npx)
+
+```bash
+npx @feralfile/cli setup
+npx @feralfile/cli chat
+```
+
+## Quick Start
+
+**Set your LLM API key first (default Claude):** `export ANTHROPIC_API_KEY='sk-ant-your-api-key-here'`
+
+```bash
+ff-cli setup
+ff-cli chat
+ff-cli play "https://example.com/video.mp4" --skip-verify
+```
+
+If you need manual config actions instead of guided setup:
+
+```bash
+ff-cli config init
+ff-cli config validate
+```
+
+## Dev Quick Start
+
+**Set your LLM API key first (default Claude):** `export ANTHROPIC_API_KEY='sk-ant-your-api-key-here'`
+
+```bash
+npm ci
+npm run dev -- setup
+npm run dev -- chat
+npm run dev -- play "https://example.com/video.mp4" --skip-verify
+```
+
+## Documentation
+
+- Getting started and usage: `./docs/README.md`
+- Configuration: `./docs/CONFIGURATION.md`
+- Function calling architecture: `./docs/FUNCTION_CALLING.md`
+- Examples: `./docs/EXAMPLES.md`
+- SSH access: `ff-cli ssh enable|disable` in `./docs/README.md`
+
+## Verification
+
+GitHub Actions runs `.github/workflows/ci.yml` for pull requests, pushes to `main`/`master`, and reusable `workflow_call` jobs. CI uses Node.js 22, installs dependencies with `npm ci`, sets `ANTHROPIC_API_KEY=dummy`, and runs the repo-wide verification entrypoint:
+
+```bash
+ANTHROPIC_API_KEY=dummy npm run verify
+```
+
+Run the same command locally before opening a PR. It checks formatting, lint, tests, TypeScript build, playlist validation smoke, and config validation smoke without mutating source files.
+
+Other GitHub Actions workflows:
+
+- `.github/workflows/build.yml` builds release assets when called by release automation or manually dispatched.
+- `.github/workflows/release.yml` reuses CI, verifies the release version, publishes npm, uploads assets, and checks the published release.
+- `.github/workflows/dependency-review.yml` reviews dependency changes on pull requests.
+- `.github/workflows/codeql.yml` runs CodeQL analysis on pull requests and pushes to `main`/`master`.
+
+## Scripts
+
+```bash
+npm run dev            # Run CLI in dev (tsx)
+npm run build          # Build TypeScript
+npm run check          # Format check + lint + tests
+npm run smoke          # Build + CLI smoke checks
+npm run verify         # CI-equivalent validation entrypoint
+npm run lint:fix       # Optional mutating lint fix; review changes before committing
+```
+
+## License
+
+MIT

package/config.json.example

@@ -0,0 +1,96 @@
+{
+  "defaultModel": "claude",
+  "models": {
+    "claude": {
+      "apiKey": "YOUR_ANTHROPIC_API_KEY_FROM_CONSOLE_ANTHROPIC_COM",
+      "baseURL": "https://api.anthropic.com/v1/",
+      "model": "claude-sonnet-4-6",
+      "availableModels": [
+        "claude-opus-4-7",
+        "claude-sonnet-4-6",
+        "claude-haiku-4-5-20251001"
+      ],
+      "timeout": 30000,
+      "maxRetries": 3,
+      "temperature": 0.3,
+      "maxTokens": 4000,
+      "supportsFunctionCalling": true
+    },
+    "grok": {
+      "apiKey": "YOUR_GROK_API_KEY_FROM_X_AI_CONSOLE",
+      "baseURL": "https://api.x.ai/v1",
+      "model": "grok-beta",
+      "availableModels": [
+        "grok-beta",
+        "grok-2-1212",
+        "grok-2-vision-1212"
+      ],
+      "timeout": 120000,
+      "maxRetries": 3,
+      "temperature": 0.3,
+      "maxTokens": 4000,
+      "supportsFunctionCalling": true
+    },
+    "gpt": {
+      "apiKey": "YOUR_OPENAI_API_KEY_FROM_PLATFORM_OPENAI_COM",
+      "baseURL": "https://api.openai.com/v1",
+      "model": "gpt-4.1",
+      "availableModels": [
+        "gpt-4.1",
+        "gpt-4.1-mini",
+        "gpt-4o",
+        "gpt-4o-mini",
+        "gpt-4-turbo"
+      ],
+      "timeout": 30000,
+      "maxRetries": 3,
+      "temperature": 1,
+      "maxTokens": 4000,
+      "supportsFunctionCalling": true
+    },
+    "gemini": {
+      "apiKey": "YOUR_GOOGLE_AI_STUDIO_API_KEY_FROM_AISTUDIO_GOOGLE_COM",
+      "baseURL": "https://generativelanguage.googleapis.com/v1beta/openai/",
+      "model": "gemini-2.5-flash",
+      "availableModels": [
+        "gemini-2.5-flash-lite",
+        "gemini-2.5-flash",
+        "gemini-flash-lite-latest"
+      ],
+      "timeout": 30000,
+      "maxRetries": 3,
+      "temperature": 0.3,
+      "maxTokens": 4000,
+      "supportsFunctionCalling": true
+    }
+  },
+  "defaultDuration": 10,
+  "browser": {
+    "timeout": 90000,
+    "sanitizationLevel": "medium"
+  },
+  "feedServers": [
+    {
+      "baseUrl": "https://dp1-feed-operator-api-prod.autonomy-system.workers.dev/api/v1",
+      "apiKey": "YOUR_FEED_SERVER_API_KEY_OPTIONAL"
+    },
+    {
+      "baseUrl": "http://localhost:8787",
+      "apiKey": "YOUR_FEED_SERVER_API_KEY_OPTIONAL"
+    }
+  ],
+  "playlist": {
+    "privateKey": "YOUR_ED25519_PRIVATE_KEY_BASE64_OR_HEX",
+    "role": "agent"
+  },
+  "ff1Devices": {
+    "devices": [
+      {
+        "name": "DISPLAY_NAME_FOR_YOUR_FF1_DEVICE",
+        "host": "http://YOUR_FF1_IP_ADDRESS:1111",
+        "apiKey": "YOUR_FF1_DEVICE_API_KEY_FROM_DEVICE_SETTINGS",
+        "topicID": "YOUR_FF1_DEVICE_TOPIC_ID_FROM_DEVICE_SETTINGS"
+      }
+    ]
+  }
+}

package/dist/index.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// Suppress punycode deprecation warnings from dependencies.
+process.on('warning', (warning) => {
+    if (warning.name === 'DeprecationWarning' && warning.message.includes('punycode')) {
+        return;
+    }
+    console.warn(warning.name + ': ' + warning.message);
+});
+require("dotenv/config");
+const commander_1 = require("commander");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const setup_1 = require("./src/commands/setup");
+const status_1 = require("./src/commands/status");
+const chat_1 = require("./src/commands/chat");
+const validate_1 = require("./src/commands/validate");
+const sign_1 = require("./src/commands/sign");
+const play_1 = require("./src/commands/play");
+const publish_1 = require("./src/commands/publish");
+const build_1 = require("./src/commands/build");
+const config_1 = require("./src/commands/config");
+const ssh_1 = require("./src/commands/ssh");
+const device_1 = require("./src/commands/device");
+// Load version from package.json. Try the built location first
+// (dist/index.js -> ../package.json) and fall back to dev (./package.json).
+let packageJsonPath = (0, path_1.resolve)((0, path_1.dirname)(__filename), '..', 'package.json');
+try {
+    (0, fs_1.readFileSync)(packageJsonPath, 'utf8');
+}
+catch {
+    packageJsonPath = (0, path_1.resolve)((0, path_1.dirname)(__filename), 'package.json');
+}
+const { version: packageVersion } = JSON.parse((0, fs_1.readFileSync)(packageJsonPath, 'utf8'));
+const program = new commander_1.Command();
+program
+    .name('ff-cli')
+    .description('CLI for building DP-1 playlists of digital art using AI (Claude, Grok, ChatGPT, Gemini)')
+    .version(packageVersion)
+    .addHelpText('after', `\nQuick start:\n  1) ff-cli setup\n  2) ff-cli chat\n\nDocs: https://github.com/feral-file/ff-cli\n`);
+program.addCommand(setup_1.setupCommand);
+program.addCommand(status_1.statusCommand);
+program.addCommand(chat_1.chatCommand);
+program.addCommand(validate_1.verifyCommand);
+program.addCommand(validate_1.validateCommand);
+program.addCommand(sign_1.signCommand);
+program.addCommand(play_1.playCommand);
+program.addCommand(publish_1.publishCommand);
+program.addCommand(build_1.buildCommand);
+program.addCommand(config_1.configCommand);
+program.addCommand(ssh_1.sshCommand);
+program.addCommand(device_1.deviceCommand);
+program.parse();