Added the Scene Manager (Libreflow casting, load, update, assetize)

New Scene Manager panel (WTD tab) talking to a running Libreflow through
its IPC server and the wtdcmds commands: pick the shot context, read the
casting, link the latest available publishes (overrides for chars and
props, collection instances otherwise), flag out-of-date versions in red,
update / roll back / remove loaded assets, and publish local collections
as assets. Requests run in the background. Settings in config.py
(SCENE_MANAGER_*, LIBREFLOW_*).

The Shot Viewer groups rigs loaded by the Scene Manager by asset type.
The manifest declares the network permission.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

README.md

@@ -5,6 +5,7 @@ Blender add-on for the Melvile pipeline (Walking The Dog). It brings together:
 - **[Sanity Check](#sanity-check)**: checks a file against the production specs and fixes what can be fixed.
 - **[Rename](#rename)**: batch renames objects and materials to the naming convention, with consistent numbering.
 - **[Shot Viewer](#shot-viewer)**: switch, create and delete the shots of a sequence (camera markers) from the sidebar, with quick access to the character and prop rigs.
+- **[Scene Manager](#scene-manager)**: loads the assets cast in a shot from Libreflow, keeps them up to date, and publishes scene collections as new assets.
 - **[Get Oid](#get-oid-for-open-scene)**: asks Libreflow for the id of the open file.
 
 Most values the tools rely on (prefixes, shot naming, frame rate…) live in `config.py` and can be overridden per studio without touching the code. See [Configuration](#configuration).
@@ -19,6 +20,7 @@ Most values the tools rely on (prefixes, shot naming, frame rate…) live in `co
 - [Tools panel](#tools-panel)
 - [Rename](#rename)
 - [Shot Viewer](#shot-viewer)
+- [Scene Manager](#scene-manager)
 - [Configuration](#configuration)
 - [Troubleshooting](#troubleshooting)
 - [For developers](#for-developers)
@@ -31,6 +33,8 @@ Tested on **Blender 5.2**.
 
 The Shot Viewer builds its cameras with the **Add Camera Rigs** extension (*Edit > Preferences > Get Extensions*, search "Add Camera Rigs"). Install and enable it next to Melvile Tools.
 
+The Scene Manager talks to a **running Libreflow** with the `wtdcmds` extension, on the same machine.
+
 **As an extension (artists):** build the package, then in Blender go to *Edit > Preferences > Get Extensions > Install from Disk…* and pick the `.zip`.
 
 ```bash
@@ -60,6 +64,7 @@ Open the sidebar of the 3D Viewport (**N**) and click the **WTD** tab.
 | **Tools** (Get Oid) | 3D Viewport |
 | **Rename** | 3D Viewport, Shader Editor |
 | **Shot Viewer** | 3D Viewport |
+| **Scene Manager** (Casting, Loaded, Assetize) | 3D Viewport |
 
 ---
 
@@ -307,7 +312,87 @@ The bottom of the panel lists the armatures of the scene, grouped into **Charact
 - **Shift+click**: adds it to the selection, to pose several rigs at once.
 - The rig(s) currently selected are highlighted.
 
-A rig counts as a character or a prop when its name, one of its collections, or the library file it comes from starts with `chr_` / `prp_` (see `SHOT_VIEWER_RIG_GROUPS` in [Configuration](#configuration)). Hidden rigs cannot be selected. Camera rigs (armatures carrying a camera) are not listed.
+A rig loaded by the [Scene Manager](#scene-manager) is grouped by its Libreflow asset type (`chars` → Characters, `props` → Props, see `SHOT_VIEWER_ASSET_TYPE_GROUPS`). Otherwise, a rig counts as a character or a prop when its name, one of its collections, or the library file it comes from starts with `chr_` / `prp_` (see `SHOT_VIEWER_RIG_GROUPS` in [Configuration](#configuration)). Hidden rigs cannot be selected. Camera rigs (armatures carrying a camera) are not listed.
+
+---
+
+## Scene Manager
+
+Manages the assets of a shot by talking to the running Libreflow: it reads the shot's casting (from Kitsu), links the published files of the cast assets, flags the ones that are out of date, and publishes local collections as new assets.
+
+Everything goes through Libreflow: Blender never touches Kitsu or the Libreflow database. Requests run in the background, so Blender stays usable while Libreflow answers. What is in progress shows at the bottom of the main panel, with the last result (or error) under it.
+
+### Connecting
+
+Start Libreflow, then open *WTD tab > **Scene Manager***. Blender connects on its own when it starts and when a file is opened. Click the refresh icon on the first line to connect again, for example after starting Libreflow.
+
+The first line shows the Libreflow session, the user and the site. When several Libreflow sessions are open, they are listed: click the one to work with.
+
+### The shot (context)
+
+The field under the connection is the **context**: the Libreflow oid of the shot this file belongs to, like `/melvile/films/f01/sequences/s010/shots/p010`. It is saved in the file and does not change when you browse in Libreflow.
+
+- **Libreflow Oid**: takes the oid shown in the Libreflow window.
+- **Pick Shot**: search the shots of the project.
+
+A valid shot is confirmed under the field (`shot: f01 / s010 / p010`). The casting and the versions are then read on their own.
+
+### Casting
+
+Lists the assets cast in the shot, with how many instances are loaded out of how many are cast (`2/2`):
+
+| Icon | Meaning |
+|---|---|
+| ✔ | Loaded. |
+| Import arrow | Not loaded (or fewer instances than cast): click it to load this asset only. |
+| ⚠ red | Cannot be loaded, with the reason from Libreflow: not found in the flow, no published file, or nothing available on this site yet. |
+
+- **Load Missing** links every cast asset that is not loaded yet, and adds the missing instances. Running it again only adds what is missing.
+- **Refresh** reads the casting and the versions again.
+- **Loaded, no longer cast** lists assets loaded earlier that the shot's casting no longer contains.
+
+**What gets loaded:**
+
+- **File:** the latest publish **available on this site** of the asset's first file matching `rigging/*.blend`, then `modeling/*.blend`.
+- **Collection:** from that file, `COL_<asset>`, else `<asset>`, else the file's only top-level collection.
+- **Characters and props** become **library overrides**, so animators can pose them. Other types, like sets, become **collection instances**.
+- **Where they go:** each asset type gets its own collection, `COL_chars`, `COL_props`, `COL_sets`…
+
+All of these can be changed in the [Configuration](#configuration).
+
+### Loaded
+
+Lists everything the Scene Manager loaded, one line per asset, with its version:
+
+- The version is **red** when it is not the latest publish. The line under it says either "v004 available" (click the update icon), or "v004 published, not available on this site yet" (wait for the download).
+- **Arrow**: shows the asset's instances, each with a button to select its objects and one to remove it.
+- **Menu icon**: pick another published version, for example to roll back. Versions not on this site are marked and cannot be picked.
+- **✕**: removes the asset entirely: all its instances and the link to its file.
+- **Update All** / **Update Selected**: switch all the loaded assets (or the ones of the selected objects) to their latest available publish.
+- **Remove Selected**: removes the instances of the selected objects.
+- The magnifier re-checks the versions.
+
+Updating swaps the linked file and reloads it. Overrides keep their posing and animation. **Ctrl+Z** undoes removing and updating.
+
+### Assetize
+
+Publishes a collection of the scene to Libreflow as its own `.blend`: a new asset, or a new version of an existing one.
+
+Click **Assetize Collection...** (in the *Assetize* sub-panel):
+
+| Setting | Use |
+|---|---|
+| **Collection** | Local collections only. Collections holding loaded assets are not offered. The active collection of the Outliner is picked by default. |
+| **Asset Type** | The Libreflow asset type (props, sets...). |
+| **Asset Name** | Letters, digits and underscores. Taken from the collection name, without its prefix (`COL_street_lamp` → `street_lamp`). The dialog says whether this makes a **new asset** or a **new version** of an existing one. |
+| **Asset Library** | Optional: publish under that asset library. |
+| **Task** | The asset task to publish in (default `modeling`). If it does not exist, the error lists the asset's tasks. |
+| **File Name** | Optional, defaults to the asset name. |
+| **Comment** | Saved with the revision. |
+| **Upload** | Also sends the revision to the exchange site. |
+| **Replace with the Publish** | On by default: once published, the local collection is replaced by a link to the published file, so the Scene Manager manages it like any other asset. The local collection stays in the file, unlinked, renamed `<name>_local`. |
+
+---
 
 ---
 
@@ -346,7 +431,8 @@ Name formats use Python's `str.format`: `"sq{:04d}"` turns `10` into `sq0010`. `
 | Sanity Check: layout | `SET_COLLECTION_PATTERN` |
 | Sanity Check: panel | `CATEGORY_ORDER`, `MAX_ISSUES_DRAWN` |
 | Rename | `RENAME_SEPARATOR`, `RENAME_PADDING`, `RENAME_SIDES`, `RENAME_TYPE_SUFFIXES` (plus `OBJECT_PREFIXES` / `DATABLOCK_PREFIXES` for *By Type* prefixes) |
-| Shot Viewer | `SHOT_VIEWER_RIG_GROUPS`, `SHOT_NAME_FORMAT`, `SHOT_NUMBER_STEP`, `SHOT_FRAME_START`, `SHOT_DEFAULT_DURATION`, `SEQUENCE_NAME_FORMAT`, `SHOT_CAMERA_NAME_FORMAT`, `SHOT_CAMERA_RIG_NAME_FORMAT`, `SHOT_CAMERA_RIG_MODES` |
+| Shot Viewer | `SHOT_VIEWER_RIG_GROUPS`, `SHOT_VIEWER_ASSET_TYPE_GROUPS`, `SHOT_NAME_FORMAT`, `SHOT_NUMBER_STEP`, `SHOT_FRAME_START`, `SHOT_DEFAULT_DURATION`, `SEQUENCE_NAME_FORMAT`, `SHOT_CAMERA_NAME_FORMAT`, `SHOT_CAMERA_RIG_NAME_FORMAT`, `SHOT_CAMERA_RIG_MODES` |
+| Scene Manager | `LIBREFLOW_SERVER_FILE`, `LIBREFLOW_TIMEOUT`, `SCENE_MANAGER_FILE_PATTERNS`, `SCENE_MANAGER_COLLECTION_NAMES`, `SCENE_MANAGER_LINK_MODES`, `SCENE_MANAGER_TYPE_COLLECTION`, `SCENE_MANAGER_ASSETIZE_TASK` |
 
 ---
 
@@ -370,6 +456,15 @@ Only armatures in the scene's view layer are listed. A collection instance that
 **Shot Viewer: a shot is missing from the list.**
 Only markers bound to a camera are shots. Select the marker, select its camera, and press **Ctrl+B** in the Timeline.
 
+**Scene Manager: "Libreflow is not running".**
+Start Libreflow (with the `wtdcmds` extension), then click the refresh icon of the Scene Manager. Its IPC server stops 30 seconds after the last Libreflow session closes.
+
+**Scene Manager: an asset cannot be loaded.**
+Its red line says why. "No file matching..." means none of its files matches `SCENE_MANAGER_FILE_PATTERNS`. "No collection named..." means the file has neither `COL_<asset>` nor `<asset>`, and several top-level collections: rename the published collection, or add its name to `SCENE_MANAGER_COLLECTION_NAMES`.
+
+**Scene Manager: the version stays red after Update.**
+The newer version is published but not downloaded on this site yet. Wait for the sync, then update again.
+
 **Shot Viewer: playback only plays one shot.**
 **Loop Shot** is on. Untick it to play the whole sequence.
 
@@ -390,6 +485,7 @@ Only markers bound to a camera are shots. Select the marker, select its camera,
 | `rename.py` | Rename tool (logic, settings, operator) |
 | `shot_viewer.py` | Shot Viewer (logic, settings, operators) |
 | `tools_ops.py` | Libreflow tools (Get Oid) |
+| `scene_manager/` | Scene Manager: `ipc.py` (Libreflow client and background jobs), `library.py` (linking, overrides, updates), `operators.py` |
 
 ### Adding a check