Update ai-album-finder branch

.git-ftp-include

@@ -0,0 +1,2 @@
+!plugins/bifrost-music/vendor/
+!themes/bifrost-noise/vendor/

.github/workflows/deploy-vendors.yml

@@ -0,0 +1,71 @@
+name: Deploy Vendor Folders
+
+on:
+  workflow_run:
+    workflows:
+      - "Publish Website"
+    branches:
+      - trunk
+      - staging
+    types:
+      - completed
+  workflow_dispatch:
+    inputs:
+      dry_run:
+        description: 'Dry run — runs composer install but skips all uploads'
+        type: boolean
+        default: false
+
+jobs:
+  deploy-vendors:
+    name: Build and Deploy Vendor Folders
+    runs-on: ubuntu-latest
+    # For workflow_run events, only proceed if the upstream workflow succeeded.
+    if: ${{ github.event_name == 'workflow_dispatch' || github.event.workflow_run.conclusion == 'success' }}
+    # workflow_run executes in the context of the default branch, so use
+    # head_branch from the event payload to select the right environment.
+    environment: ${{ (github.event.workflow_run.head_branch || github.ref_name) == 'trunk' && 'production' || 'staging' }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.2'
+          tools: composer
+
+      # ── Plugin ─────────────────────────────────────────────────────────────
+
+      - name: Install plugin dependencies (bifrost-music)
+        working-directory: plugins/bifrost-music
+        run: composer install --no-dev --optimize-autoloader --no-interaction
+
+      - name: Upload plugin vendor folder
+        if: ${{ inputs.dry_run != true && hashFiles('plugins/bifrost-music/vendor/**') != '' }}
+        uses: Automattic/FTP-Deploy-Action@3.1.2
+        with:
+          ftp-server: sftp://sftp.wp.com/htdocs/wp-content/plugins/bifrost-music/vendor/
+          ftp-username: ${{ secrets.SFTP_USER }}
+          ftp-password: ${{ secrets.SFTP_PASSWORD }}
+          local-dir: plugins/bifrost-music/vendor/
+          git-ftp-args: --all
+          known-hosts: ${{ secrets.SFTP_KNOWN_HOSTS }}
+
+      # ── Theme ───────────────────────────────────────────────────────────────
+
+      - name: Install theme dependencies (bifrost-noise)
+        working-directory: themes/bifrost-noise
+        run: composer install --no-dev --optimize-autoloader --no-interaction
+
+      - name: Upload theme vendor folder
+        if: ${{ inputs.dry_run != true && hashFiles('themes/bifrost-noise/vendor/**') != '' }}
+        uses: Automattic/FTP-Deploy-Action@3.1.2
+        with:
+          ftp-server: sftp://sftp.wp.com/htdocs/wp-content/themes/bifrost-noise/vendor/
+          ftp-username: ${{ secrets.SFTP_USER }}
+          ftp-password: ${{ secrets.SFTP_PASSWORD }}
+          local-dir: themes/bifrost-noise/vendor/
+          git-ftp-args: --all
+          known-hosts: ${{ secrets.SFTP_KNOWN_HOSTS }}

.gitignore

@@ -5,10 +5,17 @@
 /themes/twenty*
 /uploads
 /db.php
+/plugins/akismet
+/plugins/gutenberg
+/plugins/icon-block
+/plugins/wp-term-images
 
 # Dependencies
 node_modules/
-vendor/
+plugins/**/vendor/*
+!plugins/**/vendor/.gitkeep
+themes/**/vendor/*
+!themes/**/vendor/.gitkeep
 composer.lock
 
 # Environment
@@ -35,3 +42,6 @@ Thumbs.db
 # Build artifacts
 dist/
 build/
+
+# AI
+.mcp.json

.mcp-example.json

@@ -0,0 +1,11 @@
+{
+	"mcpServers": {
+		"github": {
+			"command": "npx",
+			"args": ["-y", "@modelcontextprotocol/server-github"],
+			"env": {
+				"GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_TOKEN_HERE"
+			}
+		}
+	}
+}

plugins/bifrost-music/composer.json

@@ -0,0 +1,50 @@
+{
+	"name": "bifrost/music",
+	"type": "wordpress-plugin",
+	"license": "GPL-3.0-or-later",
+	"scripts": {
+		"build": [
+			"composer update --no-dev",
+			"composer dump-autoload -o --no-dev"
+		],
+		"dev": [
+			"composer update",
+			"composer dump-autoload"
+		],
+		"lint:php": "./vendor/bin/phpcs -d error_reporting=E_ALL^E_DEPRECATED -s --colors .",
+		"zip": "composer archive --file=noise"
+	},
+	"autoload": {
+		"psr-4": {
+			"Bifrost\\Music\\": "inc/"
+		},
+		"files" : [
+			"inc/functions-helpers.php"
+		]
+	},
+	"require": {
+                "php": ">=8.1"
+	},
+	"require-dev": {
+		"wp-coding-standards/wpcs": "^3.0",
+		"phpcompatibility/phpcompatibility-wp": "*",
+		"symfony/var-dumper": "^6.4",
+		"dealerdirect/phpcodesniffer-composer-installer": "^1.0"
+	},
+	"minimum-stability": "stable",
+	"prefer-stable": true,
+	"config": {
+		"allow-plugins": {
+			"dealerdirect/phpcodesniffer-composer-installer": true
+		},
+		"archive-dir": "./",
+		"archive-format": "zip"
+	},
+	"archive": {
+		"exclude": [
+			"/vendor",
+			"!/vendor/autoload.php",
+			"!/vendor/composer/"
+		]
+	}
+}

plugins/bifrost-music/inc/Container/Container.php

@@ -0,0 +1,52 @@
+<?php
+
+/**
+ * Container interface.
+ *
+ * @author    Bifrost
+ * @copyright Copyright (c) 2026, WordPress
+ * @license   https://www.gnu.org/licenses/gpl-3.0.html GPL-3.0-or-later
+ * @link      https://github.com/wptrainingteam/developer-showcase
+ */
+
+declare(strict_types=1);
+
+namespace Bifrost\Music\Container;
+
+/**
+ * Defines the dependency injection container interface, which allows for
+ * binding concrete implementations to abstracts. The container supports the
+ * registration of transients, singletons, and instances.
+ */
+interface Container
+{
+	/**
+	 * Register a transient service (new instance each time).
+	 */
+	public function transient(string $abstract, mixed $concrete = null): void;
+
+	/**
+	 * Register a singleton service (cached instance).
+	 */
+	public function singleton(string $abstract, mixed $concrete = null): void;
+
+	/**
+	 * Register an existing instance as a singleton.
+	 */
+	public function instance(string $abstract, object $instance): void;
+
+	/**
+	 * Resolve a service from the container.
+	 */
+	public function get(string $abstract): mixed;
+
+	/**
+	 * Resolves a service from the container with parameters.
+	 */
+	public function make(string $abstract, array $parameters = []): object;
+
+	/**
+	 * Check if a service is registered with the container.
+	 */
+	public function has(string $abstract): bool;
+}