pvx/cli-compatibility.json

{
  "plugin_version": "1.4.1",
  "reviewed_at": "2026-10-24",
  "reviewed_from_cli_version": "1.4.13",
  "reviewed_command_count": 100,
  "reviewed_documents": [
    "skills-shared/pixverse-cli-contract.md",
    "skills-shared/pixverse-cli-models.md",
    "skills-shared/pixverse-cli-cheatsheet.md",
    "skills-shared/model-routing.md",
    "skills-internal/pixverse-agent-gateway/SKILL.md",
    "skills-internal/pixverse-agent-setup/SKILL.md",
    "skills/pixverse-create-video/SKILL.md",
    "skills/pixverse-create-image/SKILL.md",
    "skills/pixverse-audio/SKILL.md",
    "skills/pixverse-music-video/SKILL.md",
    "skills/pixverse-setup/SKILL.md",
    "skills-shared/audio-craft.md",
    "skills-shared/mcp-cli-login.md"
  ],
  "pixverse_cli": {
    "package": "pixverse",
    "minimum_version": "1.4.10",
    "node_requirement": ">=22.12.0",
    "install_spec": "latest",
    "baseline_version": "1.4.13",
    "baseline_capabilities_schema_version": "1.2.0",
    "internal_capabilities_schema_version": "1.2.0",
    "baseline_capabilities_sha256": "0caaa95008503fecc0e8f25a653c3eee366be2baaaf616d6da2753b5d6e8f7b0",
    "baseline_npm_integrity": "sha512-Fdc2YleJFXKqqFmqcZcmaWTsiv6HU+mxNZFK/2YZ2EXetK2R3AqW4+r9XFb561YufFxPp6bDiXL2Fx6m6rG4Ng=="
  },
  "reviewed_changes": [
    "Both managed channels require CLI >=1.4.10 and Node >=22.12.0; online installs npm latest, while local validates its embedded internal ZIP without npm fallback",
    "Capabilities schema 1.2.0 and 100 commands expose offline Create contracts and live authenticated Canvas discovery; active per-model contracts own parameter and media limits",
    "Plugin defaults explicitly select Sunburst 1440p/high and Seedance 2.5 1080p; alternate models remain capability- and entitlement-gated",
    "Template discovery and creation support ordered published-template inputs, fixed output settings, typed image/video receipts and guarded partial recovery",
    "Canvas project aliases normalize before region/binding/paid guards; arrange uses the reviewed non-atomic pre-read/mutation/post-read contract",
    "Downloads never overwrite existing paths; failed delivery recovers the download without regenerating",
    "Exit code 7 means concurrency limit; task status accepts positional and comma-separated IDs; upscale targets 2160p only",
    "Audio uses active capability text limits; fixed music duration is rejected by the service and queue, with local trimming for final timing",
    "CLI 1.4.10 exposes isolated auth pair start/finish/status/cancel/logout for MCP-authorized local device login; older runtimes must upgrade before linked workflows",
    "CLI 1.4.10 to 1.4.13 retains all 100 commands, model catalogs, existing parameter constraints, pairing, exit codes, polling and Canvas discovery contracts; the minimum stays 1.4.10",
    "CLI 1.4.13 adds optional GPT Image 2.5 background and backend-entitlement-gated Relax mode parameters; plugin generation defaults remain unchanged",
    "CLI 1.4.13 forwards Canvas patch base_edit_version unchanged; the plugin retains its own fresh-graph stale-version rejection before patch apply",
    "Published README, offline capability manifests, package engines/dependencies and installed command help were compared; the executable bundle is obfuscated, so source-level behavioral equivalence is not asserted"
  ],
  "internal_reviewed_changes": [
    "capabilities schema 1.2.0 adds explicit bindings metadata",
    "read-only offline capabilities and capabilities create commands expose required fields, model parameters, defaults, enums, ranges, units, and media limits",
    "Seedance 2.5 adds 4-30 second video/reference/two-frame transition routes, expanded references, automatic duration/framing, and no CLI audio, multi-shot, or off-peak controls; missing an audio control does not establish whether output has native sound",
    "MiniApps list/info/create commands were added; list/info are inspectable while paid MiniApps creation remains outside the pvx queue until billing and receipt handling are implemented",
    "Canvas capability discovery moved to the live authenticated capabilities canvas command with raw and filtered views; node schema remains the targeted fallback",
    "create reference now requires a prompt, FLUX 3 adds video generation, and Wan 3.0 adds video, reference, audio-only reference, and two-frame transition support",
    "the global region selector supports global and cn; Canvas bindings and paid plans are region-bound",
    "the runnable Canvas command set and exact reviewed Canvas contracts are unchanged apart from capability discovery migration"
  ],
  "internal_reviewed_from_cli_version": "1.4.0-internal.20260904-151209",
  "internal_reviewed_command_count": 93,
  "internal_capabilities_sha256": "dfa8c5ee63e87c47d0af623262e6099ce2863bce3a9a98fa8e6e0c4cc96d833e"
}