Upgrading to 3.0.0

Author: soulripper13

.gitignore

@@ -57,6 +57,11 @@ dmypy.json
 /test/*
 /tests/
 /scripts/*
+!/scripts/audit_frontend_release.mjs
+!/scripts/audit_frontend_ownership.mjs
+!/scripts/audit_frontend_scoped_wiring.mjs
+!/scripts/audit_frontend_pseudo_locale.mjs
+!/scripts/audit_frontend_degraded_states.mjs
 /custom_components/blueprint_studio/www/component-showcase.html
 /custom_components/blueprint_studio/www/modules/component-showcase.js
 /custom_components/blueprint_studio/www/styles/component-showcase.css

pytest.ini

@@ -1,5 +1,6 @@
 [pytest]
 asyncio_mode = auto
+pythonpath = .
 testpaths = tests
 addopts = -ra
 markers =

scripts/audit_frontend_degraded_states.mjs

@@ -0,0 +1,17 @@
+import { readFile } from 'node:fs/promises';
+
+const root = new URL('../custom_components/blueprint_studio/www/modules/', import.meta.url);
+const contracts = [
+  ['global-search.js', 'AbortController', 'stale search cancellation'],
+  ['downloads-uploads.js', 'AbortController', 'transfer cancellation'],
+  ['api.js', 'Session expired. Please login again.', 'expired Home Assistant authentication'],
+  ['github-integration.js', 'GitHub authentication is no longer valid', 'expired provider authentication'],
+  ['activity-rail.js', "'unavailable'", 'unavailable feature state'],
+  ['problems.js', "validation:stale", 'stale validation results'],
+  ['ha-autocomplete.js', "type: 'stale'", 'stale Home Assistant metadata'],
+];
+for (const [file, marker, description] of contracts) {
+  const source = await readFile(new URL(file, root), 'utf8');
+  if (!source.includes(marker)) throw new Error(`${description} contract missing in ${file}`);
+  console.log(`PASS ${description}`);
+}

scripts/audit_frontend_ownership.mjs

@@ -0,0 +1,8 @@
+import { readFile } from 'node:fs/promises';
+
+const app = await readFile(new URL('../custom_components/blueprint_studio/www/modules/app.js', import.meta.url), 'utf8');
+const localDefinitions = app.match(/^(?:export\s+)?(?:async\s+)?function\s+\w+/gm) || [];
+const hasCompatibilityExport = app.includes('export {') && app.includes('initializeEventHandlers');
+console.log(`app.js local feature definitions: ${localDefinitions.length}`);
+console.log(`app.js compatibility export surface: ${hasCompatibilityExport ? 'present' : 'missing'}`);
+if (localDefinitions.length || !hasCompatibilityExport) throw new Error('app.js must remain a compatibility export surface, not a second feature implementation');

scripts/audit_frontend_pseudo_locale.mjs

@@ -0,0 +1,16 @@
+import { readFile } from 'node:fs/promises';
+
+const source = await readFile(new URL('../custom_components/blueprint_studio/www/modules/translations.js', import.meta.url), 'utf8');
+const english = JSON.parse(await readFile(new URL('../custom_components/blueprint_studio/www/locales/en.json', import.meta.url), 'utf8'));
+if (!source.includes("currentLang === 'en-XA'")) throw new Error('en-XA pseudo-locale is not wired into translation initialization');
+if (!source.includes('createPseudoBundle') || !source.includes("[[ ${expanded} ]]")) throw new Error('pseudo-locale expansion contract is missing');
+
+const samples = Object.entries(english).filter(([, value]) => typeof value === 'string' && value.length >= 12).slice(0, 25);
+const expanded = value => `[[ ${String(value).replace(/\{[^}]+\}|[^\s]+/g, part => part.startsWith('{') ? part : `${part}${'~'.repeat(Math.max(1, Math.ceil(part.length * 0.35)))}`)} ]]`;
+for (const [key, value] of samples) {
+  const pseudo = expanded(value);
+  const placeholders = value.match(/\{[^}]+\}/g) || [];
+  if (pseudo.length < value.length * 1.2) throw new Error(`pseudo string is not expanded enough: ${key}`);
+  for (const placeholder of placeholders) if (!pseudo.includes(placeholder)) throw new Error(`placeholder lost for ${key}: ${placeholder}`);
+}
+console.log(`PASS pseudo-locale expansion (${samples.length} representative strings, >=20% growth)`);

scripts/audit_frontend_release.mjs

@@ -0,0 +1,44 @@
+import { spawnSync } from 'node:child_process';
+import { readFile } from 'node:fs/promises';
+
+const live = process.argv.includes('--live');
+const checks = [
+  ['ownership', 'scripts/audit_frontend_ownership.mjs'],
+  ['scoped wiring', 'scripts/audit_frontend_scoped_wiring.mjs'],
+];
+const requiredArtifacts = [
+  'custom_components/blueprint_studio/www/panels/panel_custom.html',
+  'custom_components/blueprint_studio/www/modules/app.js',
+  'custom_components/blueprint_studio/www/modules/translations.js',
+  'custom_components/blueprint_studio/www/locales/en.json',
+  'scripts/audit_frontend_ownership.mjs',
+  'scripts/audit_frontend_scoped_wiring.mjs',
+  'scripts/audit_frontend_pseudo_locale.mjs',
+  'scripts/audit_frontend_degraded_states.mjs',
+];
+
+const run = (label, command, args = []) => {
+  const result = spawnSync(command, args, { stdio: 'inherit', env: process.env });
+  if (result.status !== 0) throw new Error(`${label} failed`);
+};
+
+for (const [label, script] of checks) run(label, 'node', [script]);
+run('pseudo locale', 'node', ['scripts/audit_frontend_pseudo_locale.mjs']);
+run('degraded states', 'node', ['scripts/audit_frontend_degraded_states.mjs']);
+for (const artifact of requiredArtifacts) await readFile(new URL(`../${artifact}`, import.meta.url));
+console.log(`PASS release artifact inventory (${requiredArtifacts.length} files)`);
+
+if (live) {
+  const liveChecks = [
+    ['performance budgets', 'scripts/audit_frontend_performance_budgets.mjs'],
+    ['lazy dependencies', 'scripts/audit_frontend_lazy_dependencies.mjs'],
+    ['large workspace', 'scripts/audit_frontend_large_workspace.mjs'],
+    ['reinitialization', 'scripts/audit_frontend_reinitialization.mjs'],
+    ['viewport screenshots', 'scripts/audit_frontend_screenshots.mjs'],
+    ['shortcut guide', 'scripts/audit_frontend_shortcuts.mjs'],
+    ['Playwright layouts', 'scripts/audit_frontend_playwright.mjs'],
+  ];
+  for (const [label, script] of liveChecks) run(label, 'node', [script]);
+}
+
+console.log(live ? 'Frontend release gate passed (static + live)' : 'Frontend release gate passed (CI static)');

scripts/audit_frontend_scoped_wiring.mjs

@@ -0,0 +1,21 @@
+import { readFile } from 'node:fs/promises';
+
+const root = new URL('../custom_components/blueprint_studio/www/modules/', import.meta.url);
+const checks = [
+  ['ai-ui.js', 'document.querySelectorAll(\'[data-ai-mode]\')', 'AI mode controls are scoped to #ai-sidebar'],
+  ['split-view.js', 'document.querySelectorAll(\'.tab.drop-target', 'Split drag state is scoped to tab containers'],
+  ['translations.js', 'document.querySelectorAll(".search-mode-tab")', 'Search tabs are scoped to #view-search'],
+  ['ui.js', 'document.querySelectorAll(".theme-menu-item")', 'Theme items are scoped to the theme menu'],
+  ['coordinators/UICoordinator.js', 'document.querySelectorAll(".tree-item.active")', 'Tree active state is scoped to #file-tree'],
+  ['git-diff.js', 'document.querySelectorAll(".git-history-item")', 'Git history is scoped to the active modal'],
+];
+const failures = [];
+for (const [file, forbidden, explanation] of checks) {
+  const source = await readFile(new URL(file, root), 'utf8');
+  if (source.includes(forbidden)) failures.push(`${file}: ${explanation}`);
+  else console.log(`PASS ${file}: ${explanation}`);
+}
+if (failures.length) {
+  for (const failure of failures) console.error(`FAIL ${failure}`);
+  process.exitCode = 1;
+}

tests/test_frontend_contract.py

@@ -5025,11 +5025,11 @@ def test_app_ownership_audit_keeps_compatibility_surface_thin(self):
 
     def test_frontend_release_gate_covers_ci_and_live_artifacts(self):
         gate = (ROOT / "scripts" / "audit_frontend_release.mjs").read_text(encoding="utf-8")
-        quality = (ROOT / "FRONTEND_QUALITY_GATES.md").read_text(encoding="utf-8")
         workflow = (ROOT / ".github" / "workflows" / "frontend-quality.yaml").read_text(encoding="utf-8")
         self.assertIn("--live", gate)
-        self.assertIn("FRONTEND_QUALITY_GATES.md", gate)
-        self.assertIn("pytest -q", quality)
+        self.assertIn("custom_components/blueprint_studio/www/panels/panel_custom.html", gate)
+        self.assertIn("scripts/audit_frontend_pseudo_locale.mjs", gate)
+        self.assertNotIn("FRONTEND_QUALITY_GATES.md", gate)
         self.assertIn("audit_frontend_release.mjs", workflow)
 
     def test_frontend_test_matrix_names_primary_workflows_and_limits(self):