v3.0.0-beta.2 — New Control Center, Guided Setup, and Read-only Project Review Panels (#114)

* chore: fix formatting and configure linter for v3.0.0b2 release

* docs: replace embedded video elements with direct links for better compatibility

* chore: bump project version to 3.0.0b2

* fix: update knowledge base parameter mapping keywords, action, and rationale to prevent silent corruption

* docs: update documentation links from v3-alpha to beta

Author: thunderdew-dawn

README.md

@@ -1,6 +1,6 @@
 # fls-pilot
 
-![version](https://img.shields.io/badge/version-3.0.0b1-blue)
+![version](https://img.shields.io/badge/version-3.0.0b2-blue)
 ![status](https://img.shields.io/badge/status-beta-yellow)
 [![CI](https://github.com/thunderdew-dawn/fls-pilot/actions/workflows/ci.yml/badge.svg)](https://github.com/thunderdew-dawn/fls-pilot/actions/workflows/ci.yml)
 ![license](https://img.shields.io/badge/license-MIT-green)
@@ -10,7 +10,7 @@
 ![macOS](https://img.shields.io/badge/macOS-12%2B-000000?logo=apple&logoColor=white)
 ![FL Studio](https://img.shields.io/badge/FL%20Studio-2025%2B-orange)
 
-[![Documentation Status](https://readthedocs.org/projects/fl-studio-pilot/badge/?version=v3-alpha)](https://fl-studio-pilot.readthedocs.io/en/v3-alpha/)
+[![Documentation Status](https://readthedocs.org/projects/fl-studio-pilot/badge/?version=beta)](https://fl-studio-pilot.readthedocs.io/en/beta/)
 
 ![fls-pilot](docs/assets/fls-pilot-logo-with-text.png)
 
@@ -39,33 +39,23 @@ export-readiness checks.
 
 ### Mix Review & Gain Staging
 
-<video controls muted playsinline preload="metadata" style="width: 100%; max-width: 960px;">
-  <source src="docs/assets/ai-apply-gain-staging-example.mp4" type="video/mp4">
-</video>
+[▶️ Video: Mix Review & Gain Staging](https://github.com/thunderdew-dawn/fls-pilot/raw/main/docs/assets/ai-apply-gain-staging-example.mp4)
 
 ### Routing Audit
 
-<video controls muted playsinline preload="metadata" style="width: 100%; max-width: 960px;">
-  <source src="docs/assets/ai-based-mixer-routing-example.mp4" type="video/mp4">
-</video>
+[▶️ Video: Routing Audit](https://github.com/thunderdew-dawn/fls-pilot/raw/main/docs/assets/ai-based-mixer-routing-example.mp4)
 
 ### Project Organizer
 
-<video controls muted playsinline preload="metadata" style="width: 100%; max-width: 960px;">
-  <source src="docs/assets/ai-color-my-tracks-example.mp4" type="video/mp4">
-</video>
+[▶️ Video: Project Organizer](https://github.com/thunderdew-dawn/fls-pilot/raw/main/docs/assets/ai-color-my-tracks-example.mp4)
 
 ### Plugin & EQ Workflows
 
-<video controls muted playsinline preload="metadata" style="width: 100%; max-width: 960px;">
-  <source src="docs/assets/ai-set-highpass-on-eq-batch-example.mp4" type="video/mp4">
-</video>
+[▶️ Video: Plugin & EQ Workflows](https://github.com/thunderdew-dawn/fls-pilot/raw/main/docs/assets/ai-set-highpass-on-eq-batch-example.mp4)
 
 ### Composition
 
-<video controls muted playsinline preload="metadata" style="width: 100%; max-width: 960px;">
-  <source src="docs/assets/ai-generate-bassline-example.mp4" type="video/mp4">
-</video>
+[▶️ Video: Composition](https://github.com/thunderdew-dawn/fls-pilot/raw/main/docs/assets/ai-generate-bassline-example.mp4)
 
 ## Requirements
 
@@ -154,7 +144,7 @@ part of the public ReadTheDocs site.
 
 Public documentation:
 
-<https://fl-studio-pilot.readthedocs.io/en/v3-alpha/>
+<https://fl-studio-pilot.readthedocs.io/en/beta/>
 
 Useful local pages:
 

docs/user-guide/workflows.md

@@ -78,9 +78,7 @@ balance, routing, and low-end risks.
 
 ![Mix Review results](../assets/control-center-mix-review-2.png)
 
-<video controls muted playsinline preload="metadata" style="width: 100%; max-width: 960px;">
-  <source src="../../assets/ai-apply-gain-staging-example.mp4" type="video/mp4">
-</video>
+[▶️ Video: Mix Review](https://github.com/thunderdew-dawn/fls-pilot/raw/main/docs/assets/ai-apply-gain-staging-example.mp4)
 
 Use prompts like:
 
@@ -102,9 +100,7 @@ and fragile send/return layouts. Cleanup remains proposal-first.
 
 ![Routing Audit overview](../assets/control-center-routing-audit.png)
 
-<video controls muted playsinline preload="metadata" style="width: 100%; max-width: 960px;">
-  <source src="../../assets/ai-based-mixer-routing-example.mp4" type="video/mp4">
-</video>
+[▶️ Video: Routing Audit](https://github.com/thunderdew-dawn/fls-pilot/raw/main/docs/assets/ai-based-mixer-routing-example.mp4)
 
 ## Project Organizer
 
@@ -113,28 +109,22 @@ candidates. It can propose one reversible cleanup step at a time.
 
 ![Project Organizer scan](../assets/control-center-project-organizer.png)
 
-<video controls muted playsinline preload="metadata" style="width: 100%; max-width: 960px;">
-  <source src="../../assets/ai-color-my-tracks-example.mp4" type="video/mp4">
-</video>
+[▶️ Video: Project Organizer](https://github.com/thunderdew-dawn/fls-pilot/raw/main/docs/assets/ai-color-my-tracks-example.mp4)
 
 ## Plugin and EQ Workflows
 
 fls-pilot can inspect already-loaded plugins and configure supported parameters
 when parameter ranges are known. It cannot load or insert plugins.
 
-<video controls muted playsinline preload="metadata" style="width: 100%; max-width: 960px;">
-  <source src="../../assets/ai-set-highpass-on-eq-batch-example.mp4" type="video/mp4">
-</video>
+[▶️ Video: Plugin and EQ Workflows](https://github.com/thunderdew-dawn/fls-pilot/raw/main/docs/assets/ai-set-highpass-on-eq-batch-example.mp4)
 
 ## Composition
 
 Composition tools can generate scale-aware melodies, chords, and patterns. The
 assistant should preview notes first and wait for approval before writing to
 the Piano Roll.
 
-<video controls muted playsinline preload="metadata" style="width: 100%; max-width: 960px;">
-  <source src="../../assets/ai-generate-bassline-example.mp4" type="video/mp4">
-</video>
+[▶️ Video: Composition](https://github.com/thunderdew-dawn/fls-pilot/raw/main/docs/assets/ai-generate-bassline-example.mp4)
 
 ## Project Health and Preflight
 

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "fls-pilot"
-version = "3.0.0b1"
+version = "3.0.0b2"
 description = "Control FL Studio with any MCP-compatible LLM: mixing, composition, and mix diagnosis through natural language."
 readme = "README.md"
 license = { text = "MIT" }
@@ -139,7 +139,7 @@ select = ["E", "F", "I", "B", "UP", "SIM"]
 
 [tool.ruff.lint.per-file-ignores]
 "scripts/**/*.py" = ["UP031"]
-"tests/**/*.py" = ["UP031"]
+"tests/**/*.py" = ["UP031", "E501"]
 
 [tool.pytest.ini_options]
 addopts = """

scripts/check_github_project_fingerprint.py

@@ -94,11 +94,15 @@ def main() -> int:
 
     missing_from_project = sorted(source_numbers - set(by_number))
     if missing_from_project:
-        errors.append(f"github-source-of-truth issues missing from Project #{PROJECT}: {missing_from_project}")
+        errors.append(
+            f"github-source-of-truth issues missing from Project #{PROJECT}: {missing_from_project}"
+        )
 
     missing_release_items = sorted(REQUIRED_RELEASE_ITEMS - set(by_number))
     if missing_release_items:
-        errors.append(f"required 3.0 release-train issues missing from Project #{PROJECT}: {missing_release_items}")
+        errors.append(
+            f"required 3.0 release-train issues missing from Project #{PROJECT}: {missing_release_items}"
+        )
 
     for issue in source_issues:
         number = int(issue["number"])
@@ -113,14 +117,18 @@ def main() -> int:
 
         if issue.get("state") == "CLOSED":
             if item.get("status") != "Done" or item.get("roadmap Lane") != "Done":
-                errors.append(f"closed issue #{number} is not marked Done/Done in Project #{PROJECT}")
+                errors.append(
+                    f"closed issue #{number} is not marked Done/Done in Project #{PROJECT}"
+                )
 
         if issue.get("state") == "OPEN" and "release-blocker" in labels:
             milestone = issue.get("milestone") or {}
             if not milestone.get("title"):
                 errors.append(f"open release blocker #{number} has no milestone")
             if item.get("priority") != "P0":
-                errors.append(f"open release blocker #{number} is not marked P0 in Project #{PROJECT}")
+                errors.append(
+                    f"open release blocker #{number} is not marked P0 in Project #{PROJECT}"
+                )
 
     summary = {
         "project": PROJECT,

scripts/check_release_tag.py

@@ -6,9 +6,9 @@
 import argparse
 import re
 import sys
-import tomllib
 from pathlib import Path
 
+import tomllib
 
 TAG_RE = re.compile(
     r"^v(?P<base>\d+\.\d+\.\d+)(?:(?P<stable>-stable)|-(?P<phase>alpha|beta|rc)\.(?P<n>\d+))?$"

scripts/normalize_template_dump.py

@@ -260,10 +260,7 @@ def _reserved_ranges(routing_rows: Iterable[Mapping[str, Any]]) -> list[dict[str
     current_signature: tuple[tuple[int, float | None], ...] | None = None
 
     rows = sorted(
-        (
-            (_as_int(row.get("i", row.get("index", row.get("track")))), row)
-            for row in routing_rows
-        ),
+        ((_as_int(row.get("i", row.get("index", row.get("track")))), row) for row in routing_rows),
         key=lambda pair: -1 if pair[0] is None else pair[0],
     )
     for index, row in rows:
@@ -514,7 +511,7 @@ def _plugins(detail: Mapping[str, Any], *, max_params_per_plugin: int) -> list[d
                 "enabled": slot_data.get("enabled") if "enabled" in slot_data else None,
                 "mix": _as_float(slot_data.get("mix")),
                 "parameter_count": len(params),
-                "parameter_signature": params[:max(0, max_params_per_plugin)],
+                "parameter_signature": params[: max(0, max_params_per_plugin)],
             }
         )
     if out:

scripts/render_github_changelog.py

@@ -68,11 +68,7 @@ def _display_url(url: str | None, repo: str, display_repo: str | None) -> str:
 def render(repo: str, token: str, display_repo: str | None = None) -> str:
     generated = dt.datetime.now(dt.timezone.utc).replace(microsecond=0).isoformat()
     releases = _list(f"/repos/{repo}/releases", token)
-    pulls = [
-        pr
-        for pr in _list(f"/repos/{repo}/pulls?state=closed", token)
-        if pr.get("merged_at")
-    ]
+    pulls = [pr for pr in _list(f"/repos/{repo}/pulls?state=closed", token) if pr.get("merged_at")]
     pulls.sort(key=lambda row: str(row.get("merged_at")), reverse=True)
 
     lines = [

scripts/render_github_roadmap.py

@@ -96,7 +96,9 @@ def render(repo: str, token: str, display_repo: str | None = None) -> str:
     for milestone in sorted({_milestone(issue) for issue in open_issues}):
         group = [issue for issue in open_issues if _milestone(issue) == milestone]
         lines.extend([f"### {milestone}", ""])
-        for issue in sorted(group, key=lambda item: (_priority(_labels(item)), int(item["number"]))):
+        for issue in sorted(
+            group, key=lambda item: (_priority(_labels(item)), int(item["number"]))
+        ):
             lines.append(_render_issue(issue, repo, display_repo))
         lines.append("")
 

scripts/sync_github_labels.py

@@ -1,9 +1,9 @@
-import os
-import sys
-import subprocess
 import json
+import subprocess
+import sys
 from pathlib import Path
 
+
 def parse_labels(filepath):
     """
     Parses the simple .github/labels.yml format.
@@ -12,9 +12,9 @@ def parse_labels(filepath):
         color: <color>
         description: <desc>
     """
-    with open(filepath, "r") as f:
+    with open(filepath) as f:
         content = f.read()
-    
+
     labels = []
     # match each block starting with `- name:`
     blocks = content.split("- name:")[1:]
@@ -28,15 +28,12 @@ def parse_labels(filepath):
                 color = line.strip()[6:].strip().strip("'\"")
             elif line.strip().startswith("description:"):
                 desc = line.strip()[12:].strip().strip("'\"")
-        
+
         if name and name != "*":
-            labels.append({
-                "name": name,
-                "color": color,
-                "description": desc
-            })
+            labels.append({"name": name, "color": color, "description": desc})
     return labels
 
+
 def get_existing_labels():
     """
     Uses gh cli to get existing labels.
@@ -46,7 +43,7 @@ def get_existing_labels():
             ["gh", "label", "list", "--json", "name,color,description", "--limit", "500"],
             capture_output=True,
             text=True,
-            check=True
+            check=True,
         )
         return json.loads(result.stdout)
     except subprocess.CalledProcessError as e:
@@ -56,6 +53,7 @@ def get_existing_labels():
         print("Error: GitHub CLI (gh) is not installed or not in PATH.")
         sys.exit(1)
 
+
 def main():
     root_dir = Path(__file__).parent.parent
     labels_file = root_dir / ".github" / "labels.yml"
@@ -66,7 +64,7 @@ def main():
 
     desired_labels = parse_labels(labels_file)
     existing_labels_list = get_existing_labels()
-    
+
     existing_labels_map = {lbl["name"]: lbl for lbl in existing_labels_list}
 
     print(f"Found {len(desired_labels)} desired labels in taxonomy.")
@@ -78,7 +76,7 @@ def main():
         name = desired["name"]
         color = desired.get("color", "ededed")
         desc = desired.get("description", "")
-        
+
         if name in existing_labels_map:
             existing = existing_labels_map[name]
             # Check if color or description needs update
@@ -88,7 +86,7 @@ def main():
                     subprocess.run(
                         ["gh", "label", "edit", name, "--color", color, "--description", desc],
                         check=True,
-                        capture_output=True
+                        capture_output=True,
                     )
                 except subprocess.CalledProcessError as e:
                     print(f"Failed to update label '{name}': {e}")
@@ -101,7 +99,7 @@ def main():
                 subprocess.run(
                     ["gh", "label", "create", name, "--color", color, "--description", desc],
                     check=True,
-                    capture_output=True
+                    capture_output=True,
                 )
             except subprocess.CalledProcessError as e:
                 print(f"Failed to create label '{name}': {e}")
@@ -113,5 +111,6 @@ def main():
 
     print("Label sync complete.")
 
+
 if __name__ == "__main__":
     main()