@terra-symposium/standards-quality 0.8.0 → 0.9.0

package/dist/ui-recommendations.js

@@ -0,0 +1,182 @@
+/**
+ * packages/quality/src/ui-recommendations.ts
+ * On-demand recommendations for native JSX controls with shared component equivalents.
+ */
+/*//////////////////////////////////////////////////
+IMPORTS
+//////////////////////////////////////////////////*/
+// API
+import ts from 'typescript';
+import { readFileSync } from 'node:fs';
+import { displayPath, srcFiles } from './files.js';
+const DEFAULT_RULES = [
+    {
+        element: 'button',
+        component: 'Button',
+        import: '@/components/ui/button',
+        reason: 'Use the shared button primitive to keep action variants and interaction states consistent.',
+    },
+    {
+        element: 'input',
+        component: 'Input',
+        import: '@/components/ui/input',
+        types: ['date', 'datetime-local', 'email', 'file', 'month', 'number', 'password', 'search', 'tel', 'text', 'time', 'url', 'week'],
+        reason: 'Use the shared input primitive to keep control sizing, focus, and validation states consistent.',
+    },
+    {
+        element: 'input',
+        component: 'Button',
+        import: '@/components/ui/button',
+        types: ['button', 'reset', 'submit'],
+        reason: 'Use the shared button primitive for this input-based action while preserving its type.',
+    },
+    {
+        element: 'a',
+        component: 'ButtonLink',
+        import: '@/components/ui/button',
+        when: 'button-like',
+        reason: 'This action-styled link can use ButtonLink while retaining anchor navigation semantics.',
+    },
+];
+const DEFAULT_EXTENSIONS = ['.jsx', '.tsx'];
+/*//////////////////////////////////////////////////
+HELPERS
+//////////////////////////////////////////////////*/
+/**
+ * Reads a literal JSX attribute value without evaluating runtime expressions.
+ *
+ * @param attribute JSX attribute to inspect.
+ *
+ * @return Static string value, or undefined when the value is dynamic or absent.
+ */
+function staticAttributeValue(attribute) {
+    const initializer = attribute?.initializer;
+    if (!initializer)
+        return attribute ? '' : undefined;
+    if (ts.isStringLiteral(initializer) || ts.isNoSubstitutionTemplateLiteral(initializer))
+        return initializer.text;
+    if (!ts.isJsxExpression(initializer) || !initializer.expression)
+        return undefined;
+    let expression = initializer.expression;
+    while (ts.isParenthesizedExpression(expression))
+        expression = expression.expression;
+    return ts.isStringLiteral(expression) || ts.isNoSubstitutionTemplateLiteral(expression) ? expression.text : undefined;
+}
+/**
+ * Returns one JSX attribute by its exact lower-case name.
+ *
+ * @param element JSX opening element to inspect.
+ * @param name Attribute name to find.
+ *
+ * @return Matching attribute when present.
+ */
+function jsxAttribute(element, name) {
+    return element.attributes.properties.find((property) => ts.isJsxAttribute(property) && ts.isIdentifier(property.name) && property.name.text === name);
+}
+/**
+ * Checks whether static anchor classes resemble an action control.
+ *
+ * @param value Static class attribute value.
+ *
+ * @return `true` when the link has button-like spacing and shape.
+ */
+function isButtonLike(value) {
+    const classes = new Set((value ?? '').split(/\s+/u).filter(Boolean));
+    const hasHorizontalPadding = [...classes].some((className) => /^px-/u.test(className));
+    const hasVerticalPadding = [...classes].some((className) => /^py-/u.test(className));
+    const hasShape = [...classes].some((className) => className === 'border' || className === 'inline-flex' || className === 'flex' || className.startsWith('rounded'));
+    const hasActionStyle = [...classes].some((className) => className === 'font-medium' || className === 'no-underline' || className.startsWith('bg-'));
+    return hasHorizontalPadding && hasVerticalPadding && hasShape && hasActionStyle;
+}
+/**
+ * Checks whether a recommendation rule applies to one intrinsic JSX element.
+ *
+ * @param rule Configured replacement and conditions.
+ * @param element JSX opening element to inspect.
+ *
+ * @return `true` when the rule's element, input type, and style conditions match.
+ */
+function ruleMatches(rule, element) {
+    const type = jsxAttribute(element, 'type');
+    if (rule.types) {
+        const typeValue = type ? staticAttributeValue(type) : 'text';
+        if (typeValue === undefined || !rule.types.includes(typeValue.toLowerCase()))
+            return false;
+    }
+    if (rule.when === 'button-like') {
+        const classes = staticAttributeValue(jsxAttribute(element, 'className')) ?? staticAttributeValue(jsxAttribute(element, 'class'));
+        return isButtonLike(classes);
+    }
+    return true;
+}
+/**
+ * Checks whether a source file belongs to a UI primitive implementation directory.
+ *
+ * @param file Repository-relative source path.
+ * @param ignoredDirectories Explicit repository-relative directories to skip.
+ *
+ * @return `true` when the file is an implementation or an explicitly skipped path.
+ */
+function isIgnoredFile(file, ignoredDirectories, ignoredFiles) {
+    const normalized = file.replaceAll('\\', '/');
+    const segments = normalized.split('/');
+    const primitiveDirectory = segments.some((segment, index) => segment === 'components' && segments[index + 1] === 'ui');
+    return (primitiveDirectory ||
+        ignoredFiles.has(normalized) ||
+        ignoredDirectories.some((directory) => {
+            const prefix = directory.replaceAll('\\', '/').replace(/^\/+|\/+$/gu, '');
+            return prefix && (normalized === prefix || normalized.startsWith(`${prefix}/`));
+        }));
+}
+/*//////////////////////////////////////////////////
+RECOMMENDATIONS
+//////////////////////////////////////////////////*/
+/**
+ * Finds JSX controls that have a configured or conventional shared-component equivalent.
+ *
+ * The scan is advisory and does not alter files or participate in normal quality/test runs.
+ * JSX and TSX are parsed so comments, text, and already-shared components are not reported.
+ *
+ * @param cfg Repository quality configuration and optional UI recommendation policy.
+ *
+ * @return Sorted native-element recommendations with source positions and import guidance.
+ */
+export function uiComponentRecommendations(cfg) {
+    const settings = cfg.uiRecommendations;
+    const rules = settings?.rules ?? DEFAULT_RULES;
+    const extensions = settings?.extensions ?? DEFAULT_EXTENSIONS;
+    const ignoredFiles = new Set((settings?.ignoredFiles ?? []).map((file) => file.replaceAll('\\', '/')));
+    const findings = [];
+    for (const file of srcFiles({ ...cfg, extensions })) {
+        const relativeFile = displayPath(cfg, file).replaceAll('\\', '/');
+        if (isIgnoredFile(relativeFile, settings?.ignoredDirectories ?? [], ignoredFiles))
+            continue;
+        const source = readFileSync(file, 'utf8');
+        const scriptKind = file.endsWith('.jsx') ? ts.ScriptKind.JSX : ts.ScriptKind.TSX;
+        const parsed = ts.createSourceFile(file, source, ts.ScriptTarget.Latest, true, scriptKind);
+        const visit = (node) => {
+            if ((ts.isJsxOpeningElement(node) || ts.isJsxSelfClosingElement(node)) && ts.isIdentifier(node.tagName)) {
+                const element = node.tagName.text;
+                if (element === element.toLowerCase()) {
+                    const rule = rules.find((candidate) => candidate.element === element && ruleMatches(candidate, node));
+                    if (rule) {
+                        const { line, character } = parsed.getLineAndCharacterOfPosition(node.getStart(parsed));
+                        findings.push({
+                            file: relativeFile,
+                            line: line + 1,
+                            column: character + 1,
+                            element,
+                            component: rule.component,
+                            import: rule.import,
+                            reason: rule.reason ?? `Review whether this native <${element}> should use the shared ${rule.component} component.`,
+                        });
+                    }
+                }
+            }
+            ts.forEachChild(node, visit);
+        };
+        visit(parsed);
+    }
+    return findings.sort((a, b) => a.file.localeCompare(b.file) || a.line - b.line || a.column - b.column);
+}
+//# sourceMappingURL=ui-recommendations.js.map

package/dist/ui-recommendations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-recommendations.js","sourceRoot":"","sources":["../src/ui-recommendations.ts"],"names":[],"mappings":"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"}

package/dist/workspace-test-runner.d.ts

@@ -0,0 +1,6 @@
+/**
+ * packages/quality/src/workspace-test-runner.ts
+ * Runs the Standards workspace test matrix once with shared progress reporting.
+ */
+export {};
+//# sourceMappingURL=workspace-test-runner.d.ts.map

package/dist/workspace-test-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-test-runner.d.ts","sourceRoot":"","sources":["../src/workspace-test-runner.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/workspace-test-runner.js

@@ -0,0 +1,48 @@
+/**
+ * packages/quality/src/workspace-test-runner.ts
+ * Runs the Standards workspace test matrix once with shared progress reporting.
+ */
+/*//////////////////////////////////////////////////
+IMPORTS
+//////////////////////////////////////////////////*/
+// API
+import { spawnSync } from 'node:child_process';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { qualityNodeReporterOptions } from './node-reporter.js';
+import { qualityProgress } from './progress.js';
+/*//////////////////////////////////////////////////
+RUNNER
+//////////////////////////////////////////////////*/
+/**
+ * Runs the three publishable package suites selected by the Standards workspace.
+ *
+ * @return Nothing; the recursive test command's status becomes this process status.
+ */
+function runWorkspaceTests() {
+    const root = resolve(dirname(fileURLToPath(import.meta.url)), '../../..');
+    const reporter = new URL('./node-reporter.js', import.meta.url).href;
+    const env = { ...process.env };
+    env.NODE_OPTIONS = qualityNodeReporterOptions(env.NODE_OPTIONS, reporter);
+    env.TERRA_QUALITY_NODE_REPORTER_OWNER = '1';
+    const suites = ['@terra-symposium/standards-error-boundaries', '@terra-symposium/standards-quality', '@terra-symposium/standards-reporting'];
+    let failed = false;
+    console.error('\nTESTS\n  Unit / Contract · Standards workspace');
+    qualityProgress('Test suites', 0, suites.length);
+    for (const [idx, name] of suites.entries()) {
+        const result = spawnSync('pnpm', ['--filter', name, 'test'], { cwd: root, stdio: 'inherit', env });
+        if (result.error) {
+            console.error(`  ${name} failed to start: ${result.error.message}`);
+            failed = true;
+        }
+        else if (result.status !== 0) {
+            failed = true;
+        }
+        qualityProgress('Test suites', idx + 1, suites.length);
+    }
+    console.error(`  ${failed ? '✗ failed' : '✓ passed'}`);
+    if (failed)
+        process.exitCode = 1;
+}
+runWorkspaceTests();
+//# sourceMappingURL=workspace-test-runner.js.map

package/dist/workspace-test-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-test-runner.js","sourceRoot":"","sources":["../src/workspace-test-runner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;oDAEoD;AAEpD,MAAM;AACN,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD;;oDAEoD;AAEpD;;;;GAIG;AACH,SAAS,iBAAiB;IACzB,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;IACrE,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC/B,GAAG,CAAC,YAAY,GAAG,0BAA0B,CAAC,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC1E,GAAG,CAAC,iCAAiC,GAAG,GAAG,CAAC;IAC5C,MAAM,MAAM,GAAG,CAAC,6CAA6C,EAAE,oCAAoC,EAAE,sCAAsC,CAAC,CAAC;IAC7I,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,OAAO,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;IAClE,eAAe,CAAC,aAAa,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACjD,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QACnG,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAClB,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,qBAAqB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACpE,MAAM,GAAG,IAAI,CAAC;QACf,CAAC;aAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,GAAG,IAAI,CAAC;QACf,CAAC;QACD,eAAe,CAAC,aAAa,EAAE,GAAG,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;IACvD,IAAI,MAAM;QAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AAClC,CAAC;AAED,iBAAiB,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@terra-symposium/standards-quality",
-	"version": "0.8.0",
+	"version": "0.9.0",
 	"description": "Configurable quality checks and maintenance tooling for Terra Symposium repositories",
 	"homepage": "https://standards-docs.netlify.app/",
 	"type": "module",
@@ -35,7 +35,7 @@
 	"scripts": {
 		"build": "tsc -p tsconfig.json",
 		"prepare": "npm run build",
-		"test": "node --test test/*.test.mjs"
+		"test": "node --test"
 	},
 	"dependencies": {
 		"typescript": "^5.0.0"

package/quality.schema.json

@@ -1,132 +1,197 @@
 {
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "title": "Terra quality configuration",
-  "type": "object",
-  "additionalProperties": false,
-  "required": ["sourceRoots", "extensions"],
-  "properties": {
-    "$schema": { "type": "string" },
-    "root": { "type": "string" },
-    "sourceRoots": { "type": "array", "items": { "type": "string" } },
-    "includeRoots": { "type": "array", "items": { "type": "string" } },
-    "extensions": { "type": "array", "items": { "type": "string", "pattern": "^\\." } },
-    "aliases": { "type": "object", "additionalProperties": { "type": "string" } },
-    "frameworkEntryExports": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "string" } } },
-    "externalPrefixes": { "type": "array", "items": { "type": "string" } },
-    "skippedDirectories": { "type": "array", "items": { "type": "string" } },
-    "skippedFiles": { "type": "array", "items": { "type": "string" } },
-    "excludeTests": { "type": "boolean", "description": "Exclude files ending in .test.* and .spec.* from configured quality source scans." },
-    "singleUse": {
-      "type": "object",
-      "properties": { "skippedDirectories": { "type": "array", "items": { "type": "string" } } },
-      "additionalProperties": false
-    },
-    "renameExports": { "type": "boolean" },
-    "protectedIdentifiers": { "type": "array", "items": { "type": "string" } },
-    "enabledChecks": { "$ref": "#/$defs/toggles" },
-    "autofix": { "$ref": "#/$defs/toggles" },
-    "documentation": {
-      "type": "object",
-      "properties": {
-        "required": {
-          "type": "object",
-          "properties": {
-            "types": { "type": "boolean" },
-            "functions": { "type": "boolean", "description": "Require TSDoc for named functions, including substantive descriptions for every parameter." },
-            "exportedFunctions": { "type": "boolean", "description": "Require TSDoc for exported named functions, including substantive descriptions for every parameter." },
-            "noInlineFunctions": { "type": "boolean" }
-          },
-          "additionalProperties": false
-        }
-      },
-      "additionalProperties": false
-    },
-    "tailwindCanonical": {
-      "type": "object",
-      "required": ["stylesheet"],
-      "properties": {
-        "stylesheet": { "type": "string" },
-        "sourceRoots": { "type": "array", "items": { "type": "string" } }
-      },
-      "additionalProperties": false
-    },
-    "security": {
-      "type": "object",
-      "properties": {
-        "forbiddenTerms": { "type": "array", "items": { "type": "string" } },
-        "forbiddenImports": { "type": "array", "items": { "type": "string" } },
-        "clientRoots": { "type": "array", "items": { "type": "string" } },
-        "allowProcessEnvRoots": { "type": "array", "items": { "type": "string" } }
-      },
-      "additionalProperties": false
-    },
-    "repeatedClasses": { "type": "object", "properties": { "minimumCount": { "type": "number" }, "extensions": { "type": "array", "items": { "type": "string" } }, "ignoredDirectories": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": false },
-    "regexDedup": { "type": "object", "properties": { "minimumCount": { "type": "number" }, "extensions": { "type": "array", "items": { "type": "string" } }, "ignoredFiles": { "type": "array", "items": { "type": "string" } }, "sharedModule": { "type": "string", "minLength": 1 } }, "additionalProperties": false },
-    "uiPatterns": { "type": "object", "properties": { "forbidden": { "type": "array", "items": { "type": "string" } }, "ignoredFiles": { "type": "array", "items": { "type": "string" } }, "extensions": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": false },
-    "github": {
-      "type": "object",
-      "properties": {
-        "repositories": { "type": "array", "uniqueItems": true, "items": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$" } },
-        "requiredFeatures": { "type": "array", "uniqueItems": true, "items": { "enum": ["dependencyGraph", "dependabotAlerts", "malwareAlerts", "securityUpdates", "versionUpdates", "groupedUpdates", "secretScanning", "pushProtection", "codeScanning"] } },
-        "featureExemptions": { "type": "object", "propertyNames": { "pattern": "^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$" }, "additionalProperties": { "type": "array", "uniqueItems": true, "items": { "enum": ["dependencyGraph", "dependabotAlerts", "malwareAlerts", "securityUpdates", "versionUpdates", "groupedUpdates", "secretScanning", "pushProtection", "codeScanning"] } } }
-      },
-      "additionalProperties": false
-    },
-    "enabledCommands": { "type": "object", "additionalProperties": { "type": "boolean" } },
-    "enabledRecommendations": { "type": "object", "additionalProperties": { "type": "boolean" } },
-    "qualityCommands": { "$ref": "#/$defs/commands" },
-    "recommendationCommands": { "$ref": "#/$defs/commands" },
-    "manualWarnings": { "enum": ["error", "warning"], "default": "error", "description": "Whether dead-code findings that require manual review block quality. Defaults to error." },
-    "tsconfig": { "type": "string" },
-    "oneLineImports": { "type": "boolean" },
-    "prettierPrintWidth": { "type": "number" },
-    "lintRoots": { "type": "array", "items": { "type": "string" } },
-    "typecheckRoots": { "type": "array", "items": { "type": "string" } },
-    "typecheckExtensions": { "type": "array", "items": { "type": "string" } },
-    "typecheckCommand": {
-      "type": "object",
-      "required": ["command"],
-      "properties": {
-        "command": { "type": "string" },
-        "args": { "type": "array", "items": { "type": "string" } }
-      },
-      "additionalProperties": false
-    },
-    "loadTesting": {
-      "type": "object",
-      "properties": {
-        "enabled": { "type": "boolean" },
-        "defaultBudget": { "$ref": "#/$defs/loadBudget" },
-        "testBudgets": { "type": "object", "additionalProperties": { "$ref": "#/$defs/loadBudget" } },
-        "operationBudgets": { "type": "object", "additionalProperties": { "$ref": "#/$defs/loadBudget" } }
-      },
-      "additionalProperties": false
-    },
-    "tools": { "type": "object", "additionalProperties": { "type": "string" } }
-  },
-  "$defs": {
-    "toggles": { "type": "object", "additionalProperties": { "type": "boolean" } },
-    "loadBudget": {
-      "type": "object",
-      "properties": {
-        "warnMs": { "type": "number", "minimum": 0 },
-        "failMs": { "type": "number", "minimum": 0 }
-      },
-      "additionalProperties": false,
-      "anyOf": [{ "required": ["warnMs"] }, { "required": ["failMs"] }]
-    },
-    "commands": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["name", "command"],
-        "properties": {
-          "name": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
-          "command": { "type": "string" },
-          "args": { "type": "array", "items": { "type": "string" } }
-        },
-        "additionalProperties": false
-      }
-    }
-  }
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"title": "Terra quality configuration",
+	"type": "object",
+	"additionalProperties": false,
+	"required": ["sourceRoots", "extensions"],
+	"properties": {
+		"$schema": { "type": "string" },
+		"root": { "type": "string" },
+		"sourceRoots": { "type": "array", "items": { "type": "string" } },
+		"includeRoots": { "type": "array", "items": { "type": "string" } },
+		"extensions": { "type": "array", "items": { "type": "string", "pattern": "^\\." } },
+		"aliases": { "type": "object", "additionalProperties": { "type": "string" } },
+		"frameworkEntryExports": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "string" } } },
+		"externalPrefixes": { "type": "array", "items": { "type": "string" } },
+		"skippedDirectories": { "type": "array", "items": { "type": "string" } },
+		"skippedFiles": { "type": "array", "items": { "type": "string" } },
+		"excludeTests": { "type": "boolean", "description": "Exclude files ending in .test.* and .spec.* from configured quality source scans." },
+		"singleUse": {
+			"type": "object",
+			"properties": { "skippedDirectories": { "type": "array", "items": { "type": "string" } } },
+			"additionalProperties": false
+		},
+		"renameExports": { "type": "boolean" },
+		"protectedIdentifiers": { "type": "array", "items": { "type": "string" } },
+		"enabledChecks": { "$ref": "#/$defs/toggles" },
+		"autofix": { "$ref": "#/$defs/toggles" },
+		"documentation": {
+			"type": "object",
+			"properties": {
+				"required": {
+					"type": "object",
+					"properties": {
+						"types": { "type": "boolean" },
+						"functions": { "type": "boolean", "description": "Require TSDoc for named functions, including substantive descriptions for every parameter." },
+						"exportedFunctions": { "type": "boolean", "description": "Require TSDoc for exported named functions, including substantive descriptions for every parameter." },
+						"noInlineFunctions": { "type": "boolean" }
+					},
+					"additionalProperties": false
+				}
+			},
+			"additionalProperties": false
+		},
+		"tailwindCanonical": {
+			"type": "object",
+			"required": ["stylesheet"],
+			"properties": {
+				"stylesheet": { "type": "string" },
+				"sourceRoots": { "type": "array", "items": { "type": "string" } }
+			},
+			"additionalProperties": false
+		},
+		"security": {
+			"type": "object",
+			"properties": {
+				"forbiddenTerms": { "type": "array", "items": { "type": "string" } },
+				"forbiddenImports": { "type": "array", "items": { "type": "string" } },
+				"clientRoots": { "type": "array", "items": { "type": "string" } },
+				"allowProcessEnvRoots": { "type": "array", "items": { "type": "string" } }
+			},
+			"additionalProperties": false
+		},
+		"repeatedClasses": {
+			"type": "object",
+			"properties": {
+				"minimumCount": { "type": "number" },
+				"extensions": { "type": "array", "items": { "type": "string" } },
+				"ignoredDirectories": { "type": "array", "items": { "type": "string" } }
+			},
+			"additionalProperties": false
+		},
+		"regexDedup": {
+			"type": "object",
+			"properties": {
+				"minimumCount": { "type": "number" },
+				"extensions": { "type": "array", "items": { "type": "string" } },
+				"ignoredFiles": { "type": "array", "items": { "type": "string" } },
+				"sharedModule": { "type": "string", "minLength": 1 }
+			},
+			"additionalProperties": false
+		},
+		"uiPatterns": {
+			"type": "object",
+			"properties": {
+				"forbidden": { "type": "array", "items": { "type": "string" } },
+				"ignoredFiles": { "type": "array", "items": { "type": "string" } },
+				"extensions": { "type": "array", "items": { "type": "string" } }
+			},
+			"additionalProperties": false
+		},
+		"uiRecommendations": {
+			"type": "object",
+			"properties": {
+				"rules": {
+					"type": "array",
+					"items": {
+						"type": "object",
+						"required": ["element", "component", "import"],
+						"properties": {
+							"element": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+							"component": { "type": "string", "minLength": 1 },
+							"import": { "type": "string", "minLength": 1 },
+							"types": { "type": "array", "items": { "type": "string" } },
+							"when": { "enum": ["always", "button-like"] },
+							"reason": { "type": "string" }
+						},
+						"additionalProperties": false
+					}
+				},
+				"extensions": { "type": "array", "items": { "enum": [".jsx", ".tsx"] } },
+				"ignoredFiles": { "type": "array", "items": { "type": "string" } },
+				"ignoredDirectories": { "type": "array", "items": { "type": "string" } }
+			},
+			"additionalProperties": false
+		},
+		"github": {
+			"type": "object",
+			"properties": {
+				"repositories": { "type": "array", "uniqueItems": true, "items": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$" } },
+				"requiredFeatures": {
+					"type": "array",
+					"uniqueItems": true,
+					"items": { "enum": ["dependencyGraph", "dependabotAlerts", "malwareAlerts", "securityUpdates", "versionUpdates", "groupedUpdates", "secretScanning", "pushProtection", "codeScanning"] }
+				},
+				"featureExemptions": {
+					"type": "object",
+					"propertyNames": { "pattern": "^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$" },
+					"additionalProperties": {
+						"type": "array",
+						"uniqueItems": true,
+						"items": { "enum": ["dependencyGraph", "dependabotAlerts", "malwareAlerts", "securityUpdates", "versionUpdates", "groupedUpdates", "secretScanning", "pushProtection", "codeScanning"] }
+					}
+				}
+			},
+			"additionalProperties": false
+		},
+		"enabledCommands": { "type": "object", "additionalProperties": { "type": "boolean" } },
+		"enabledRecommendations": { "type": "object", "additionalProperties": { "type": "boolean" } },
+		"qualityCommands": {
+			"$ref": "#/$defs/commands",
+			"description": "Commands selected for the quality run. Terra Quality owns phase order and test grouping; array order is preserved within ordinary phases and within each test group."
+		},
+		"recommendationCommands": { "$ref": "#/$defs/commands" },
+		"manualWarnings": { "enum": ["error", "warning"], "default": "error", "description": "Whether dead-code findings that require manual review block quality. Defaults to error." },
+		"tsconfig": { "type": "string" },
+		"oneLineImports": { "type": "boolean" },
+		"prettierPrintWidth": { "type": "number" },
+		"lintRoots": { "type": "array", "items": { "type": "string" } },
+		"typecheckRoots": { "type": "array", "items": { "type": "string" } },
+		"typecheckExtensions": { "type": "array", "items": { "type": "string" } },
+		"typecheckCommand": {
+			"type": "object",
+			"required": ["command"],
+			"properties": {
+				"command": { "type": "string" },
+				"args": { "type": "array", "items": { "type": "string" } }
+			},
+			"additionalProperties": false
+		},
+		"loadTesting": {
+			"type": "object",
+			"properties": {
+				"enabled": { "type": "boolean" },
+				"defaultBudget": { "$ref": "#/$defs/loadBudget" },
+				"testBudgets": { "type": "object", "additionalProperties": { "$ref": "#/$defs/loadBudget" } },
+				"operationBudgets": { "type": "object", "additionalProperties": { "$ref": "#/$defs/loadBudget" } }
+			},
+			"additionalProperties": false
+		},
+		"tools": { "type": "object", "additionalProperties": { "type": "string" } }
+	},
+	"$defs": {
+		"toggles": { "type": "object", "additionalProperties": { "type": "boolean" } },
+		"loadBudget": {
+			"type": "object",
+			"properties": {
+				"warnMs": { "type": "number", "minimum": 0 },
+				"failMs": { "type": "number", "minimum": 0 }
+			},
+			"additionalProperties": false,
+			"anyOf": [{ "required": ["warnMs"] }, { "required": ["failMs"] }]
+		},
+		"commands": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"required": ["name", "command"],
+				"properties": {
+					"name": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+					"command": { "type": "string" },
+					"args": { "type": "array", "items": { "type": "string" } }
+				},
+				"additionalProperties": false
+			}
+		}
+	}
 }