@polymorphism-tech/morph-spec 9.0.0 → 9.2.0

package/src/core/templates/template-registry.js

@@ -1,15 +1,3 @@
-/**
- * Template Registry - Discovery and metadata API for all framework templates.
- *
- * Provides programmatic access to REGISTRY.json for:
- * - Template discovery by category, phase, stack
- * - Template metadata lookup
- * - Path resolution with fallback logic
- * - Validation of template existence
- *
- * @module template-registry
- */
-
 import { readFileSync, existsSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
@@ -17,21 +5,10 @@ import { fileURLToPath } from 'url';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
-// Parsed registries cached by resolved REGISTRY.json path. Keyed on the path —
-// NOT a single global slot — so a process that loads the framework registry
-// and a project's registry gets each one correctly, instead of whichever
-// loaded first.
+// Keyed by REGISTRY.json path, so the framework and a project registry never shadow each other.
 const _registryCache = new Map();
 
-/**
- * Load the template registry from REGISTRY.json.
- *
- * @param {string} [projectPath] - Optional project path (defaults to framework root)
- * @returns {Object} Parsed registry object
- * @throws {Error} If registry file not found or invalid JSON
- */
 export function loadTemplateRegistry(projectPath = null) {
-  // Resolve the path first — it is the cache key.
   const registryPath = projectPath
     ? join(projectPath, 'framework/templates/REGISTRY.json')
     : join(__dirname, '../../../framework/templates/REGISTRY.json');
@@ -55,92 +32,39 @@ export function loadTemplateRegistry(projectPath = null) {
   }
 }
 
-/**
- * Clear all cached registries (useful for testing).
- */
 export function clearRegistryCache() {
   _registryCache.clear();
 }
 
-/**
- * Get all templates from registry.
- *
- * @param {string} [projectPath] - Optional project path
- * @returns {Array} Array of template objects
- */
 export function getAllTemplates(projectPath = null) {
   const registry = loadTemplateRegistry(projectPath);
   return registry.templates || [];
 }
 
-/**
- * Get template by ID.
- *
- * @param {string} templateId - Template identifier (e.g., 'plan')
- * @param {string} [projectPath] - Optional project path
- * @returns {Object|null} Template object or null if not found
- */
 export function getTemplateById(templateId, projectPath = null) {
   const templates = getAllTemplates(projectPath);
   return templates.find(t => t.id === templateId) || null;
 }
 
-/**
- * Get templates by category.
- *
- * @param {string} category - Category ('documentation', 'code', 'infrastructure', 'context', 'examples')
- * @param {string} [projectPath] - Optional project path
- * @returns {Array} Filtered template array
- */
 export function getTemplatesByCategory(category, projectPath = null) {
   const templates = getAllTemplates(projectPath);
   return templates.filter(t => t.category === category);
 }
 
-/**
- * Get templates by phase.
- *
- * @param {string} phase - Phase name (e.g., 'plan', 'uiux', 'implement')
- * @param {string} [projectPath] - Optional project path
- * @returns {Array} Filtered template array
- */
-export function getTemplatesByPhase(phase, projectPath = null) {
-  const templates = getAllTemplates(projectPath);
-  return templates.filter(t => t.phase === phase);
-}
-
-/**
- * Get templates by stack.
- *
- * @param {string} stackId - Stack identifier ('blazor-azure', 'nextjs-neon')
- * @param {string} [projectPath] - Optional project path
- * @returns {Array} Filtered template array (includes universal + stack-specific)
- */
 export function getTemplatesByStack(stackId, projectPath = null) {
   const templates = getAllTemplates(projectPath);
   return templates.filter(t => {
-    // Include universal templates (stackSpecific: false)
     if (!t.stackSpecific) return true;
 
-    // Include stack-specific if matches
     return t.stacks && t.stacks.includes(stackId);
   });
 }
 
-/**
- * Get required templates only.
- *
- * @param {string} [stackId] - Optional stack filter
- * @param {string} [projectPath] - Optional project path
- * @returns {Array} Filtered template array
- */
 export function getRequiredTemplates(stackId = null, projectPath = null) {
   let templates = getAllTemplates(projectPath);
 
-  // Filter by required flag
   templates = templates.filter(t => t.required === true);
 
-  // Optional: filter by stack
   if (stackId) {
     templates = templates.filter(t => {
       if (!t.stackSpecific) return true;
@@ -151,13 +75,6 @@ export function getRequiredTemplates(stackId = null, projectPath = null) {
   return templates;
 }
 
-/**
- * Search templates by keyword (searches id, name, description).
- *
- * @param {string} keyword - Search term
- * @param {string} [projectPath] - Optional project path
- * @returns {Array} Matching templates
- */
 export function searchTemplates(keyword, projectPath = null) {
   const templates = getAllTemplates(projectPath);
   const lowerKeyword = keyword.toLowerCase();
@@ -171,21 +88,9 @@ export function searchTemplates(keyword, projectPath = null) {
   });
 }
 
-/** Absolute path of this repo's own framework/templates/ directory. */
 const FRAMEWORK_TEMPLATES_DIR = join(__dirname, '../../../framework/templates');
 
-/**
- * Resolve a template id to its absolute path inside THIS framework repo's
- * `framework/templates/` directory — for generators running against the
- * framework itself (scaffold-generator, context-generator), not against an
- * installed `.morph/`. Use architecture-scanner.js's `resolveTemplatePath()`
- * when a project root and its project-local overrides are in play.
- *
- * @param {string} templateId - Template identifier (REGISTRY.json `id`)
- * @returns {string} Absolute path to the template file
- * @throws {Error} If the id is not in REGISTRY.json or the file is missing —
- *   a missing template is a framework bug, not a recoverable condition.
- */
+/** Path inside this package's `framework/templates/`, not a project's `.morph/`; throws when missing. */
 export function resolveFrameworkTemplatePath(templateId) {
   const template = getTemplateById(templateId);
   if (!template) {

package/src/core/templates/template-renderer.js

@@ -1,22 +1,7 @@
-/**
- * Template Renderer - Shared Handlebars-based template engine.
- *
- * Provides unified template rendering with custom helpers for:
- * - Case transformations (pascalCase, camelCase, snakeCase, etc.)
- * - Conditional logic (eq, ne, and, or, not)
- * - Loops (each, unless)
- *
- * @module template-renderer
- */
-
 import Handlebars from 'handlebars';
 import { readFileSync, existsSync } from 'fs';
 
-/**
- * Register all custom Handlebars helpers
- */
 function registerHelpers() {
-  // Case transformation helpers
   Handlebars.registerHelper('pascalCase', function (str) {
     if (typeof str !== 'string') return '';
     return str
@@ -60,7 +45,6 @@ function registerHelpers() {
     return str.toLowerCase().replace(/_/g, '-');
   });
 
-  // Comparison helpers
   Handlebars.registerHelper('eq', function (a, b) {
     return a === b;
   });
@@ -85,14 +69,14 @@ function registerHelpers() {
     return a >= b;
   });
 
-  // Logical helpers
   Handlebars.registerHelper('and', function (...args) {
-    // Remove Handlebars options object (last argument)
+    // Handlebars passes its options object as the last argument.
     const values = args.slice(0, -1);
     return values.every(Boolean);
   });
 
   Handlebars.registerHelper('or', function (...args) {
+    // Handlebars passes its options object as the last argument.
     const values = args.slice(0, -1);
     return values.some(Boolean);
   });
@@ -101,7 +85,6 @@ function registerHelpers() {
     return !value;
   });
 
-  // String helpers
   Handlebars.registerHelper('uppercase', function (str) {
     return typeof str === 'string' ? str.toUpperCase() : '';
   });
@@ -115,7 +98,6 @@ function registerHelpers() {
     return str.charAt(0).toUpperCase() + str.slice(1);
   });
 
-  // Utility helpers
   Handlebars.registerHelper('default', function (value, defaultValue) {
     return value != null && value !== '' ? value : defaultValue;
   });
@@ -133,31 +115,30 @@ function registerHelpers() {
     } else if (format === 'time') {
       return date.toTimeString().split(' ')[0];
     }
-    return date.toISOString().split('T')[0]; // Default: YYYY-MM-DD
+    return date.toISOString().split('T')[0];
   });
 
   Handlebars.registerHelper('year', function () {
     return new Date().getFullYear();
   });
 
-  // Date formatting helpers
   Handlebars.registerHelper('formatDate', function (date, format) {
     if (!date) return '';
 
     const d = new Date(date);
-    if (isNaN(d.getTime())) return date; // Return original if invalid
+    if (isNaN(d.getTime())) return date;
 
     switch (format) {
       case 'iso':
         return d.toISOString();
       case 'date':
-        return d.toISOString().split('T')[0]; // YYYY-MM-DD
+        return d.toISOString().split('T')[0];
       case 'time':
-        return d.toTimeString().split(' ')[0]; // HH:MM:SS
+        return d.toTimeString().split(' ')[0];
       case 'datetime':
-        return d.toISOString().replace('T', ' ').split('.')[0]; // YYYY-MM-DD HH:MM:SS
+        return d.toISOString().replace('T', ' ').split('.')[0];
       case 'short':
-        return d.toLocaleDateString(); // Locale-specific short date
+        return d.toLocaleDateString();
       case 'long':
         return d.toLocaleDateString('en-US', {
           weekday: 'long',
@@ -166,15 +147,13 @@ function registerHelpers() {
           day: 'numeric'
         });
       default:
-        return d.toISOString().split('T')[0]; // Default: YYYY-MM-DD
+        return d.toISOString().split('T')[0];
     }
   });
 
-  // Pluralization helpers (basic English rules)
   Handlebars.registerHelper('pluralize', function (str) {
     if (typeof str !== 'string') return '';
 
-    // Common irregular plurals
     const irregulars = {
       'person': 'people',
       'child': 'children',
@@ -191,7 +170,6 @@ function registerHelpers() {
         : irregulars[lower];
     }
 
-    // Regular pluralization rules
     if (str.endsWith('s') || str.endsWith('x') || str.endsWith('z') ||
         str.endsWith('ch') || str.endsWith('sh')) {
       return str + 'es';
@@ -209,7 +187,6 @@ function registerHelpers() {
   Handlebars.registerHelper('singularize', function (str) {
     if (typeof str !== 'string') return '';
 
-    // Common irregular singulars
     const irregulars = {
       'people': 'person',
       'children': 'child',
@@ -226,7 +203,6 @@ function registerHelpers() {
         : irregulars[lower];
     }
 
-    // Regular singularization rules
     if (str.endsWith('ies')) {
       return str.slice(0, -3) + 'y';
     } else if (str.endsWith('ves')) {
@@ -240,7 +216,6 @@ function registerHelpers() {
     }
   });
 
-  // String manipulation helpers
   Handlebars.registerHelper('trim', function (str) {
     return typeof str === 'string' ? str.trim() : '';
   });
@@ -251,7 +226,7 @@ function registerHelpers() {
   });
 
   Handlebars.registerHelper('concat', function (...args) {
-    // Remove Handlebars options object (last argument)
+    // Handlebars passes its options object as the last argument.
     const strings = args.slice(0, -1);
     return strings.join('');
   });
@@ -283,7 +258,6 @@ function registerHelpers() {
     return 0;
   });
 
-  // Math helpers
   Handlebars.registerHelper('add', function (a, b) {
     return Number(a) + Number(b);
   });
@@ -309,7 +283,6 @@ function registerHelpers() {
     return Math.round(Number(num) * multiplier) / multiplier;
   });
 
-  // Array helpers
   Handlebars.registerHelper('join', function (array, separator = ', ') {
     if (!Array.isArray(array)) return '';
     return array.join(separator);
@@ -331,19 +304,8 @@ function registerHelpers() {
   });
 }
 
-// Auto-register helpers on module load
 registerHelpers();
 
-/**
- * Render a template file with Handlebars.
- *
- * @param {string} templatePath - Absolute path to template file
- * @param {Object} variables - Variables to pass to template context
- * @param {Object} [options] - Rendering options
- * @param {boolean} [options.noEscape] - Disable HTML escaping (default: true for markdown)
- * @returns {string} Rendered template content
- * @throws {Error} If template file doesn't exist or compilation fails
- */
 export function renderTemplate(templatePath, variables, options = {}) {
   if (!existsSync(templatePath)) {
     throw new Error(`Template file not found: ${templatePath}`);
@@ -352,28 +314,18 @@ export function renderTemplate(templatePath, variables, options = {}) {
   try {
     const templateContent = readFileSync(templatePath, 'utf-8');
 
-    // Compile template
     const template = Handlebars.compile(templateContent, {
-      noEscape: options.noEscape !== undefined ? options.noEscape : true, // Don't escape by default
-      strict: false, // Allow undefined variables
-      preventIndent: true, // Preserve indentation
+      noEscape: options.noEscape !== undefined ? options.noEscape : true,
+      strict: false,
+      preventIndent: true,
     });
 
-    // Render with variables
     return template(variables);
   } catch (error) {
     throw new Error(`Failed to render template ${templatePath}: ${error.message}`);
   }
 }
 
-/**
- * Render a template string (not from file) with Handlebars.
- *
- * @param {string} templateString - Template content as string
- * @param {Object} variables - Variables to pass to template context
- * @param {Object} [options] - Rendering options
- * @returns {string} Rendered content
- */
 export function renderTemplateString(templateString, variables, options = {}) {
   try {
     const template = Handlebars.compile(templateString, {
@@ -388,12 +340,6 @@ export function renderTemplateString(templateString, variables, options = {}) {
   }
 }
 
-/**
- * Get list of placeholders used in a template file.
- *
- * @param {string} templatePath - Absolute path to template file
- * @returns {string[]} Array of placeholder names found
- */
 export function getTemplatePlaceholders(templatePath) {
   if (!existsSync(templatePath)) {
     throw new Error(`Template file not found: ${templatePath}`);
@@ -403,44 +349,26 @@ export function getTemplatePlaceholders(templatePath) {
   return getTemplatePlaceholdersFromString(templateContent);
 }
 
-/**
- * Get list of placeholders from a template string.
- *
- * @param {string} templateString - Template content
- * @returns {string[]} Array of placeholder names found
- */
 export function getTemplatePlaceholdersFromString(templateString) {
   const placeholders = new Set();
 
-  // Match {{PLACEHOLDER}} and {{helper PLACEHOLDER}}
   const regex = /\{\{(?:#|\/)?\s*([A-Za-z_][A-Za-z0-9_]*)/g;
   let match;
 
   while ((match = regex.exec(templateString)) !== null) {
     const placeholder = match[1];
 
-    // Skip Handlebars built-in helpers and custom helpers
     const skipHelpers = [
-      // Built-in Handlebars
       'if', 'unless', 'each', 'with', 'lookup', 'log', 'else',
-      // Comparison
       'eq', 'ne', 'lt', 'gt', 'lte', 'gte',
-      // Logical
       'and', 'or', 'not',
-      // Case transformations
       'pascalCase', 'camelCase', 'titleCase', 'upperSnakeCase', 'snakeCase', 'kebabCase',
-      // String manipulation
       'uppercase', 'lowercase', 'capitalize', 'trim', 'replace', 'concat', 'substr',
       'startsWith', 'endsWith', 'contains', 'length',
-      // Date/Time
       'formatDate', 'now', 'year',
-      // Pluralization
       'pluralize', 'singularize',
-      // Math
       'add', 'subtract', 'multiply', 'divide', 'mod', 'round',
-      // Array
       'join', 'first', 'last', 'slice',
-      // Utility
       'default', 'json'
     ];
 
@@ -452,14 +380,6 @@ export function getTemplatePlaceholdersFromString(templateString) {
   return Array.from(placeholders).sort();
 }
 
-/**
- * Validate that all required placeholders are provided in variables.
- *
- * @param {string} templatePath - Absolute path to template file
- * @param {Object} variables - Variables object
- * @param {string[]} [optionalPlaceholders] - Placeholders that are optional
- * @returns {{ valid: boolean, missing: string[] }} Validation result
- */
 export function validateTemplatePlaceholders(templatePath, variables, optionalPlaceholders = []) {
   const placeholders = getTemplatePlaceholders(templatePath);
   const providedKeys = Object.keys(variables);

package/src/core/templates/template-seed.js

@@ -9,7 +9,6 @@ export function templateSourcePath(templateId, cwd = process.cwd()) {
   return local && existsSync(local) ? local : resolveFrameworkTemplatePath(templateId);
 }
 
-/** @returns {{ path: string, written: boolean }} `written: false` when the file already existed. */
 export function writeIfAbsent(path, content) {
   mkdirSync(dirname(path), { recursive: true });
   try {

package/src/core/work-types.js

@@ -1,26 +1,3 @@
-/**
- * Work Types — Single Source of Truth (v8)
- *
- * Routes work by TYPE (feature/bug/chore/hotfix), each with a dimensioned
- * pipeline. `derivePhase` is already skip-tolerant via approved gates
- * (`gateImpliedPhase`), so "skipping phases" means stamping gates by policy
- * at birth (`approvedBy: "policy:{type}"` — see POLICY_APPROVER_PREFIX).
- *
- * Edit ONLY this file to add, rename, or retune a work type. Consumed by
- * `create`/`retype`/`risk-detector` in later tasks — this module is pure
- * and has no filesystem/CLI side effects.
- *
- * Fields per type:
- *   label            - Human-readable name
- *   scaffold         - Phase folders created at feature birth (subset of
- *                       2-plan/1-design/3-implement/4-review)
- *   skippedGates     - Gates stamped `policy:{type}`-approved at birth
- *                       instead of waiting for human approval
- *   forcedPauseGates - Gates that ALWAYS pause for a human, regardless of
- *                       trust mode or skippedGates (e.g. hotfix.review)
- *   entrySkill       - The skill that kicks off work of this type
- */
-
 export const DEFAULT_WORK_TYPE = 'feature';
 export const POLICY_APPROVER_PREFIX = 'policy:';
 
@@ -55,24 +32,12 @@ export const WORK_TYPES = {
   },
 };
 
-/**
- * @param {string} t - candidate work type key
- * @returns {boolean} true iff `t` is a known key of WORK_TYPES
- */
 export function isValidWorkType(t) {
   return Object.prototype.hasOwnProperty.call(WORK_TYPES, t);
 }
 
-/**
- * Resolve a feature's work-type config, defaulting to `feature` when the
- * feature has no `workType` or an unrecognized one.
- *
- * @param {object} feature - feature.json contents (uses `workType`)
- * @returns {object} the matching WORK_TYPES entry
- */
 export function getWorkType(feature) {
-  // Guard against inherited property names (e.g. workType: "toString") — a bare
-  // WORK_TYPES[key] lookup would resolve those to Object.prototype members.
+  // A bare WORK_TYPES[key] would resolve inherited names like "toString".
   return isValidWorkType(feature?.workType)
     ? WORK_TYPES[feature.workType]
     : WORK_TYPES[DEFAULT_WORK_TYPE];

package/src/dashboard/app/App.jsx

@@ -17,11 +17,6 @@ import Guide from './pages/Guide.jsx';
 import { useNow } from './hooks/usePref.js';
 import { useProjects, useCurrentProject, projectHref } from './lib/project.js';
 
-/**
- * What the sidebar and the tab title say at a glance, from the portfolio:
- * per project, how many features are active, waiting on you and being worked
- * on right now.
- */
 function usePulse(portfolio) {
   const now = useNow();
   const byProject = {};
@@ -49,7 +44,6 @@ export default function App() {
   const current = useCurrentProject(portfolio);
   const pulse = usePulse(portfolio);
   const [palette, setPalette] = useState(false);
-  // Ctrl+K / Cmd+K opens the search from anywhere.
   useEffect(() => {
     const onKey = (e) => {
       if ((e.ctrlKey || e.metaKey) && e.key.toLowerCase() === 'k') { e.preventDefault(); setPalette((o) => !o); }
@@ -65,8 +59,7 @@ export default function App() {
       <CommandPalette open={palette} onClose={() => setPalette(false)} portfolio={portfolio} project={current.id} />
       <main className="relative z-10 flex-1 overflow-auto">
         <MobileNav {...nav} />
-        {/* Inside <main>, keyed by route: a page that throws leaves the
-            sidebar alive, and navigating away remounts a clean boundary. */}
+        {/* Keyed by route: a boundary that caught an error stays in fallback until it remounts. */}
         <ErrorBoundary key={pathname} page={pathname}>
           <Routes>
             <Route path="/" element={<Portfolio />} />

package/src/dashboard/app/components/ActivityFeed.jsx

@@ -65,7 +65,6 @@ function Line({ item, showFeature, project }) {
   );
 }
 
-/** Group consecutive items by calendar day, newest day first. */
 function byDay(items) {
   const groups = [];
   for (const it of items) {
@@ -128,10 +127,6 @@ export function FeedView({ items, kinds, onToggleKind, showFeature, onMore, hasM
   );
 }
 
-/**
- * Live activity feed. The first page follows the server's `morph:changed`
- * pushes; older pages are fetched on demand and appended.
- */
 export default function ActivityFeed({ project, feature, showFeature = false }) {
   const [kinds, setKinds] = useState(DEFAULT);
   const [older, setOlder] = useState([]);

package/src/dashboard/app/components/CommandPalette.jsx

@@ -17,7 +17,6 @@ const PAGES = [
   ['Personas', '/agents'], ['Standards', '/standards'], ['Rules', '/rules'], ['Hooks', '/hooks'],
 ];
 
-/** Everything the framework knows that has a page — built once. */
 function knowledgeIndex() {
   const out = PAGES.map(([title, to]) => ({ kind: 'page', title, to, hay: title }));
   for (const s of morphData.skills || []) out.push({ kind: 'skill', title: s.id, hint: s.description, to: entityHref('skill', s.id), hay: `${s.id} ${s.description}` });
@@ -42,10 +41,6 @@ function projectIndex(portfolio) {
   return (portfolio?.projects || []).map((p) => ({ kind: 'project', title: p.name, hint: p.dir, to: projectHref(p.id), hay: `${p.name} ${p.dir}` }));
 }
 
-/**
- * Features and their slices. `projectName` is set for another project's
- * features, so a hit says where it lives.
- */
 function featureIndex(project, features, projectName = null) {
   const out = [];
   const where = (text) => (projectName ? (text ? `${projectName}: ${text}` : projectName) : text);
@@ -58,14 +53,12 @@ function featureIndex(project, features, projectName = null) {
   return out;
 }
 
-/** The active features of the other projects, from the portfolio's summaries. */
 function otherProjectsIndex(portfolio, project) {
   return (portfolio?.projects || [])
     .filter((p) => p.id !== project && p.summary)
     .flatMap((p) => featureIndex(p.id, p.summary.activeFeatures, p.name));
 }
 
-/** Every query word must appear; a title that starts with the query ranks first. */
 export function searchIndex(index, query, limit = 40) {
   const words = query.toLowerCase().split(/\s+/).filter(Boolean);
   if (!words.length) return [];

package/src/dashboard/app/components/DetailPanel.jsx

@@ -1,11 +1,7 @@
 import { useEffect } from 'react';
 import { X } from '@phosphor-icons/react';
 
-/**
- * The reading drawer of the knowledge pages. Wide enough for rendered markdown,
- * closes on Escape, and sits over the graph without a backdrop so the graph
- * stays visible beside it.
- */
+/** No backdrop: the graph stays visible beside the drawer. */
 export default function DetailPanel({ open, title, subtitle, onClose, children }) {
   useEffect(() => {
     if (!open) return undefined;

package/src/dashboard/app/components/EntityLink.jsx

@@ -1,11 +1,6 @@
 import { Link, useSearchParams } from 'react-router-dom';
 import { useCallback } from 'react';
 
-/**
- * Where each kind of thing lives in the app. The ONE map of entity → URL, so a
- * persona, standard or skill reads as a link everywhere it is mentioned.
- * A feature belongs to a project: its links come from `featureHref` (lib/project.js).
- */
 export function entityHref(kind, id) {
   const q = (page) => `/${page}?sel=${encodeURIComponent(id)}`;
   switch (kind) {
@@ -20,7 +15,6 @@ export function entityHref(kind, id) {
   }
 }
 
-// `standards/backend/dotnet/testing.md` (as a plan may cite it) → the registry `path`.
 export function standardKey(ref) {
   return String(ref).replace(/^\.?\/?(\.morph\/framework\/)?standards\//, '');
 }
@@ -34,12 +28,6 @@ export default function EntityLink({ kind, id, children, className = '', chip =
   return <Link to={entityHref(kind, id)} className={cls} title={title}>{children ?? id}</Link>;
 }
 
-/**
- * The selected item of a knowledge page, kept in `?sel=` so a panel can be
- * linked, bookmarked and reached from anywhere with EntityLink.
- *
- * @returns {[string|null, (id: string|null) => void]}
- */
 export function useSelection() {
   const [params, setParams] = useSearchParams();
   const sel = params.get('sel');

package/src/dashboard/app/components/ErrorBoundary.jsx

@@ -1,15 +1,8 @@
 import { Component } from 'react';
 
 /**
- * Catches a page that throws while rendering and shows the error in place of
- * the page, so the rest of the layout (the sidebar) keeps working.
- *
- * Without it one broken page unmounts the whole tree: 8.38.0 opened on
- * /agents, which threw a ReferenceError, and the dashboard was a black screen.
- *
  * Mount it with `key={location.pathname}`: a boundary that already caught an
- * error stays in fallback until it remounts, and the key remounts it when the
- * sidebar navigates to another page.
+ * error stays in fallback until it remounts.
  */
 export default class ErrorBoundary extends Component {
   constructor(props) {