@santi020k/lumen 0.3.0 → 1.0.0

package/README.md

@@ -15,6 +15,18 @@ umbrella package only when you want the framework-neutral CLI or registry APIs:
 pnpm add @santi020k/lumen
 ```
 
+## Typography
+
+Lumen defaults `--ui-font` to the canonical Santi020k Montserrat family stack:
+
+```css
+--ui-font: "Montserrat", "Avenir Next", "Segoe UI", sans-serif;
+```
+
+The package declares the family but does not bundle or load font files. Applications should load
+Montserrat once through their preferred delivery path, or override `--ui-font` when using another
+typeface.
+
 The umbrella package also exposes typed registry metadata and the `lumen` CLI:
 
 ```bash
@@ -26,13 +38,26 @@ lumen add Button --target elements
 lumen add scheduler
 lumen add scheduler --target react
 lumen add scheduler --target elements
+lumen add analytics-dashboard
+lumen add saas-admin --target react
+lumen add commerce-dashboard --target elements
 lumen audit-tokens ./src
+lumen doctor --json
+lumen init --framework astro --tailwind
 ```
 
 Use `lumen add <component>` for a local Astro wrapper, `--target react` for a React wrapper, or
 `--target elements` for a custom-elements starter. Bundled recipes support the same Astro, React,
 and Elements targets.
 
+Complete product recipes are also bundled for `analytics-dashboard`, `saas-admin`,
+`commerce-dashboard`, `project-workspace`, `auth-onboarding`, `docs-shell`, `marketing-shell`,
+`dashboard-shell`, and `validated-form`.
+
+Run `lumen doctor` to check adapter/style agreement, Tailwind layer order, Astro runtime mounts,
+and fragile internal selector dependencies. Use `--json` for CI and rollout automation. `lumen
+init --framework <astro|react|elements> [--tailwind]` prints the canonical non-destructive setup.
+
 Run `lumen audit-tokens [path]` before incremental adoption when an existing stylesheet may already
 declare names such as `--surface`, `--ink`, or `--line`. The audit reports complete CSS colors that
 are incompatible with Lumen's HSL-channel token format and exits non-zero when it finds conflicts.
@@ -46,8 +71,9 @@ lumen rollout 0.2.0 ../site ../dashboard --exclude ../legacy
 ```
 
 The report separates manifest, workspace-catalog, and lockfile references; identifies each
-framework; checks the declared pnpm and Node contracts; and reports the complete resolved Lumen
-package graph. Add `--report ./lumen-rollout.json` for a durable JSON record.
+framework; checks the declared pnpm and Node contracts; includes the same integration diagnostics
+as `lumen doctor`; and reports the complete resolved Lumen package graph. Add
+`--report ./lumen-rollout.json` for a durable JSON record.
 
 After committing an intentional baseline in each consumer, apply the upgrade serially:
 

package/dist/cli.js

@@ -1,6 +1,7 @@
 import { readdir, readFile, stat } from 'node:fs/promises';
 import { resolve } from 'node:path';
 import { consumerRolloutSucceeded, formatConsumerRollout, runConsumerRollout } from './consumer-rollout.js';
+import { createLumenSetup, formatLumenDiagnostics, inspectLumenIntegration } from './integration-diagnostics.js';
 import { addLumenRegistryItem, getLumenRegistryEntries, getLumenRegistryItem, loadLumenRegistry, lumenRegistry } from './registry.js';
 import { auditLumenTokenCss } from './token-audit.js';
 const args = process.argv.slice(2);
@@ -23,6 +24,10 @@ const allowDirty = args.includes('--allow-dirty');
 const noVerify = args.includes('--no-verify');
 const reportIndex = args.indexOf('--report');
 const reportPath = reportIndex >= 0 ? args[reportIndex + 1] : undefined;
+const frameworkIndex = args.indexOf('--framework');
+const frameworkValue = frameworkIndex >= 0 ? args[frameworkIndex + 1] : undefined;
+const json = args.includes('--json');
+const tailwind = args.includes('--tailwind');
 const excludeValues = args.flatMap((value, index) => {
     const nextValue = args[index + 1];
     return value === '--exclude' && nextValue ? [nextValue] : [];
@@ -58,6 +63,11 @@ const getAddTarget = (value, provided = false) => {
         return value;
     throw new Error(`Unknown Lumen add target: ${value}. Use astro, react, or elements.`);
 };
+const getFramework = (value) => {
+    if (value === 'astro' || value === 'elements' || value === 'react')
+        return value;
+    throw new Error('Missing or invalid framework. Use --framework astro, react, or elements.');
+};
 if (failOnConflict) {
     conflict = 'error';
 }
@@ -75,12 +85,12 @@ const getRegistryItemFiles = (item) => {
 };
 const getRegistryItemDescription = (item) => 'description' in item ? item.description : undefined;
 const getRegistryItemCategory = (item) => 'category' in item ? `category: ${item.category}` : undefined;
-const getRegistryItemComponents = (item) => 'components' in item && Array.isArray(item.components) && item.components.length > 0
-    ? `components: ${item.components.join(', ')}`
-    : undefined;
-const getRegistryItemDependencies = (item) => 'dependencies' in item && item.dependencies.length > 0
-    ? `dependencies: ${item.dependencies.join(', ')}`
-    : undefined;
+const getRegistryItemComponents = (item) => 'components' in item && Array.isArray(item.components) && item.components.length > 0 ?
+    `components: ${item.components.join(', ')}` :
+    undefined;
+const getRegistryItemDependencies = (item) => 'dependencies' in item && item.dependencies.length > 0 ?
+    `dependencies: ${item.dependencies.join(', ')}` :
+    undefined;
 const formatItem = (itemName, registry = lumenRegistry) => {
     const item = getLumenRegistryItem(itemName, registry);
     if (!item) {
@@ -153,6 +163,8 @@ const help = [
     '  lumen add <name>       Install a recipe or component into the current project',
     '  lumen install          Print install commands',
     '  lumen audit-tokens     Report incompatible semantic color custom properties',
+    '  lumen doctor           Inspect styles, adapters, runtime mounts, and selector usage',
+    '  lumen init             Print canonical framework setup without changing files',
     '  lumen rollout [version] [repositories...]  Inventory or upgrade pnpm consumers',
     '',
     'Options:',
@@ -164,6 +176,9 @@ const help = [
     '  --registry <source>    Load list/show data from a local or remote registry JSON file',
     '  --registry-token <key> Use a bearer token for private remote registries',
     '  --target <framework>   Generate wrappers or recipe starters for astro, react, or elements',
+    '  --framework <name>     Select astro, react, or elements for lumen init',
+    '  --tailwind             Include the verified Tailwind cascade setup in lumen init',
+    '  --json                 Print lumen doctor output as JSON',
     '  --apply                Apply a rollout (requires a target version)',
     '  --allow-dirty          Allow rollout after recording an uncommitted baseline',
     '  --exclude <path>       Exclude a repository (repeatable)',
@@ -174,9 +189,9 @@ const help = [
 // eslint-disable-next-line complexity -- Command dispatch keeps CLI exit behavior and output in one place.
 const run = async () => {
     let output = help;
-    const registry = registrySource
-        ? await loadLumenRegistry(registrySource, registryToken ? { token: registryToken } : {})
-        : lumenRegistry;
+    const registry = registrySource ?
+        await loadLumenRegistry(registrySource, registryToken ? { token: registryToken } : {}) :
+        lumenRegistry;
     switch (command) {
         case 'audit-tokens': {
             output = await formatTokenAudit(name ?? cwd ?? process.cwd());
@@ -187,6 +202,17 @@ const run = async () => {
                 output = await formatAddResult(name, registry);
             break;
         }
+        case 'doctor': {
+            const report = await inspectLumenIntegration(cwd ?? process.cwd());
+            output = json ? JSON.stringify(report, undefined, 2) : formatLumenDiagnostics(report);
+            if (!report.healthy)
+                process.exitCode = 1;
+            break;
+        }
+        case 'init': {
+            output = createLumenSetup(getFramework(frameworkValue), tailwind);
+            break;
+        }
         case 'install': {
             output = 'pnpm add @santi020k/lumen-astro\nnpm install @santi020k/lumen-astro\nyarn add @santi020k/lumen-astro';
             break;

package/dist/consumer-rollout.d.ts

@@ -1,3 +1,4 @@
+import { type LumenDiagnosticReport } from './integration-diagnostics.js';
 export type LumenFramework = 'astro' | 'elements' | 'react';
 export interface ConsumerReference {
     file: string;
@@ -10,6 +11,7 @@ export interface ConsumerInventory {
     currentCommit: string | undefined;
     dirty: boolean;
     frameworks: LumenFramework[];
+    integration: LumenDiagnosticReport;
     nodeEngine: string | undefined;
     nodeEngineSatisfied: boolean | undefined;
     packageManager: string | undefined;

package/dist/consumer-rollout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consumer-rollout.d.ts","sourceRoot":"","sources":["../src/consumer-rollout.ts"],"names":[],"mappings":"AAmBA,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAA;AAE3D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,CAAA;IAC3C,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,aAAa,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,KAAK,EAAE,OAAO,CAAA;IACd,UAAU,EAAE,cAAc,EAAE,CAAA;IAC5B,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,mBAAmB,EAAE,OAAO,GAAG,SAAS,CAAA;IACxC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,UAAU,EAAE,iBAAiB,EAAE,CAAA;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,OAAO,GAAG,WAAW,CAAA;IAC3B,YAAY,EAAE,CAAC,iBAAiB,GAAG;QACjC,QAAQ,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,OAAO,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAC7D,CAAC,EAAE,CAAA;IACJ,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,eAAO,MAAM,wBAAwB,GAAI,QAAQ,qBAAqB,KAAG,OAGtE,CAAA;AA8DH,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,MAAM,GAAG,SAAS,EAC1B,uBAAsC,KACrC,OAAO,GAAG,SAIZ,CAAA;AA+DD,eAAO,MAAM,oBAAoB,GAC/B,YAAY,MAAM,EAClB,gBAAgB,MAAM,KACrB,OAAO,CAAC,iBAAiB,CAiG3B,CAAA;AAUD,eAAO,MAAM,yBAAyB,GACpC,QAAQ,MAAM,EACd,eAAe,MAAM,KACpB,MAYF,CAAA;AAED,eAAO,MAAM,0BAA0B,GACrC,QAAQ,MAAM,EACd,eAAe,MAAM,KACpB,MAIF,CAAA;AAuFD,eAAO,MAAM,mBAAmB,GAAI,QAAQ,MAAM,EAAE,UAAU,MAAM,EAAE,EAAE,SAAS,MAAM,KAAG,MAoCzF,CAAA;AAqGD,eAAO,MAAM,kBAAkB,GAC7B,SAAS,sBAAsB,KAC9B,OAAO,CAAC,qBAAqB,CAmD/B,CAAA;AAED,eAAO,MAAM,qBAAqB,GAAI,QAAQ,qBAAqB,KAAG,MAyBrE,CAAA"}
+{"version":3,"file":"consumer-rollout.d.ts","sourceRoot":"","sources":["../src/consumer-rollout.ts"],"names":[],"mappings":"AAOA,OAAO,EAA2B,KAAK,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AAQlG,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAA;AAE3D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,CAAA;IAC3C,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,aAAa,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,KAAK,EAAE,OAAO,CAAA;IACd,UAAU,EAAE,cAAc,EAAE,CAAA;IAC5B,WAAW,EAAE,qBAAqB,CAAA;IAClC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,mBAAmB,EAAE,OAAO,GAAG,SAAS,CAAA;IACxC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,UAAU,EAAE,iBAAiB,EAAE,CAAA;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,OAAO,GAAG,WAAW,CAAA;IAC3B,YAAY,EAAE,CAAC,iBAAiB,GAAG;QACjC,QAAQ,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,OAAO,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAC7D,CAAC,EAAE,CAAA;IACJ,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,eAAO,MAAM,wBAAwB,GAAI,QAAQ,qBAAqB,KAAG,OAExE,CAAA;AA6DD,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,MAAM,GAAG,SAAS,EAC1B,uBAAsC,KACrC,OAAO,GAAG,SAIZ,CAAA;AA4DD,eAAO,MAAM,oBAAoB,GAAU,YAAY,MAAM,EAAE,gBAAgB,MAAM,KAAG,OAAO,CAAC,iBAAiB,CAgGhH,CAAA;AAUD,eAAO,MAAM,yBAAyB,GAAI,QAAQ,MAAM,EAAE,eAAe,MAAM,KAAG,MAYjF,CAAA;AAQD,eAAO,MAAM,0BAA0B,GAAI,QAAQ,MAAM,EAAE,eAAe,MAAM,KAAG,MAQlF,CAAA;AAmFD,eAAO,MAAM,mBAAmB,GAAI,QAAQ,MAAM,EAAE,UAAU,MAAM,EAAE,EAAE,SAAS,MAAM,KAAG,MAoCzF,CAAA;AAsGD,eAAO,MAAM,kBAAkB,GAAU,SAAS,sBAAsB,KAAG,OAAO,CAAC,qBAAqB,CAwCvG,CAAA;AAED,eAAO,MAAM,qBAAqB,GAAI,QAAQ,qBAAqB,KAAG,MAqBrE,CAAA"}

package/dist/consumer-rollout.js

@@ -3,15 +3,11 @@ import { readdir, readFile, stat, writeFile } from 'node:fs/promises';
 import { join, relative, resolve } from 'node:path';
 import { promisify } from 'node:util';
 import { satisfies } from 'semver';
+import { inspectLumenIntegration } from './integration-diagnostics.js';
 /* eslint-disable complexity -- Consumer inventory, semver checks, mutation, and verification intentionally evaluate full repository contracts. */
 const execFileAsync = promisify(execFile);
 const lumenPackagePattern = /^@santi020k\/lumen(?:-(?:astro|core|elements|mcp|react))?$/;
-const dependencyFields = [
-    'dependencies',
-    'devDependencies',
-    'optionalDependencies',
-    'peerDependencies'
-];
+const dependencyFields = ['dependencies', 'devDependencies', 'optionalDependencies', 'peerDependencies'];
 export const consumerRolloutSucceeded = (report) => report.repositories.every(repository => repository.valid && repository.commands.every(command => command.ok));
 const isLumenPackage = (name) => lumenPackagePattern.test(name);
 const pathExists = async (path) => {
@@ -101,7 +97,7 @@ const getResolvedVersions = (references) => {
 export const inspectLumenConsumer = async (repository, targetVersion) => {
     const root = resolve(repository);
     const rootManifestPath = join(root, 'package.json');
-    if (!await pathExists(rootManifestPath)) {
+    if (!(await pathExists(rootManifestPath))) {
         throw new Error(`No package.json found at consumer root: ${root}`);
     }
     const manifestPaths = await findPackageManifests(root);
@@ -120,12 +116,13 @@ export const inspectLumenConsumer = async (repository, targetVersion) => {
         references.push(...collectLockReferences(await readFile(lockPath, 'utf8')));
     }
     const resolvedVersions = getResolvedVersions(references);
-    const frameworks = ([
+    const frameworks = [
         references.some(item => item.packageName === '@santi020k/lumen-astro') && 'astro',
         references.some(item => item.packageName === '@santi020k/lumen-elements') && 'elements',
         references.some(item => item.packageName === '@santi020k/lumen-react') && 'react'
-    ].filter(Boolean));
+    ].filter(Boolean);
     const warnings = [];
+    const integration = await inspectLumenIntegration(root);
     const nodeEngineSatisfied = satisfiesNodeEngine(rootManifest.engines?.node);
     const status = await readGitValue(root, ['status', '--porcelain']);
     const dirty = Boolean(status);
@@ -158,6 +155,7 @@ export const inspectLumenConsumer = async (repository, targetVersion) => {
         currentCommit: await readGitValue(root, ['rev-parse', 'HEAD']),
         dirty,
         frameworks,
+        integration,
         nodeEngine: rootManifest.engines?.node,
         nodeEngineSatisfied,
         packageManager: rootManifest.packageManager,
@@ -165,7 +163,7 @@ export const inspectLumenConsumer = async (repository, targetVersion) => {
         repository: root,
         resolvedVersions,
         ...(targetVersion ? { targetVersion } : {}),
-        valid: warnings.length === 0,
+        valid: warnings.length === 0 && integration.healthy,
         warnings
     };
 };
@@ -186,7 +184,12 @@ export const updateLumenManifestSource = (source, targetVersion) => {
     }
     return `${JSON.stringify(manifest, undefined, 2)}\n`;
 };
-export const updateLumenWorkspaceSource = (source, targetVersion) => source.replaceAll(/^(\s*['"]?@santi020k\/lumen(?:-(?:astro|core|elements|mcp|react))?['"]?\s*:\s*['"]?)([~^]?)(\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?)(['"]?\s*(?:#.*)?)$/gm, (_match, before, prefix, _version, after) => `${before}${prefix}${targetVersion}${after}`);
+const lumenWorkspaceVersionPattern = new RegExp([
+    String.raw `^(\s*['"]?@santi020k\/lumen`,
+    String.raw `(?:-(?:astro|core|elements|mcp|react))?['"]?\s*:\s*['"]?)`,
+    String.raw `([~^]?)(\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?)(['"]?\s*(?:#.*)?)$`
+].join(''), 'gm');
+export const updateLumenWorkspaceSource = (source, targetVersion) => source.replaceAll(lumenWorkspaceVersionPattern, (_match, before, prefix, _version, after) => `${before}${prefix}${targetVersion}${after}`);
 const getVerificationScripts = (manifest, frameworks) => {
     const scripts = manifest.scripts ?? {};
     const preferred = [
@@ -229,7 +232,7 @@ const parseFlowSequence = (source) => {
             if (character === quote)
                 quote = undefined;
         }
-        else if (character === '"' || character === "'") {
+        else if (character === '"' || character === '\'') {
             current += character;
             quote = character;
         }
@@ -243,14 +246,15 @@ const parseFlowSequence = (source) => {
     }
     if (current.trim())
         values.push(current);
-    return values.map(value => {
+    return values
+        .map(value => {
         const trimmed = value.trim();
-        if ((trimmed.startsWith('"') && trimmed.endsWith('"')) ||
-            (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+        if ((trimmed.startsWith('"') && trimmed.endsWith('"')) || (trimmed.startsWith('\'') && trimmed.endsWith('\''))) {
             return trimmed.slice(1, -1);
         }
         return trimmed;
-    }).filter(Boolean);
+    })
+        .filter(Boolean);
 };
 export const addReleaseAgeTarget = (source, packages, version) => {
     if (!/^\s*minimumReleaseAgeExclude\s*:/m.test(source))
@@ -282,7 +286,8 @@ export const addReleaseAgeTarget = (source, packages, version) => {
     lines.splice(index + 1, 0, ...additions);
     return lines.join('\n');
 };
-const removeObsoleteReleaseAgeEntries = (source, targetVersion) => source.split(/\r?\n/)
+const removeObsoleteReleaseAgeEntries = (source, targetVersion) => source
+    .split(/\r?\n/)
     .filter(line => {
     const match = /^\s*-\s*['"]?(@santi020k\/lumen(?:-(?:astro|core|elements|mcp|react))?)@([^'"]+)['"]?\s*$/.exec(line);
     return !match || match[2] === targetVersion;
@@ -316,12 +321,14 @@ const upgradeConsumer = async (inventory, targetVersion, allowDirty, verify) =>
             await writeFile(workspacePath, updated);
     }
     const packageNames = [...new Set(inventory.references.map(item => item.packageName))];
-    const commands = [await runCommand(inventory.repository, 'corepack', [
+    const commands = [
+        await runCommand(inventory.repository, 'corepack', [
             'pnpm',
             'update',
             '--recursive',
             ...packageNames.map(packageName => `${packageName}@${targetVersion}`)
-        ])];
+        ])
+    ];
     if (!commands[0]?.ok)
         return commands;
     for (const [path, source] of desiredManifests) {
@@ -354,8 +361,7 @@ export const runConsumerRollout = async (options) => {
         throw new Error('A target version is required when applying a consumer rollout.');
     }
     const excluded = new Set((options.exclude ?? []).map(path => resolve(path)));
-    const repositories = options.repositories.map(path => resolve(path))
-        .filter(path => !excluded.has(path));
+    const repositories = options.repositories.map(path => resolve(path)).filter(path => !excluded.has(path));
     const report = {
         generatedAt: new Date().toISOString(),
         mode: options.apply ? 'apply' : 'inventory',
@@ -364,15 +370,13 @@ export const runConsumerRollout = async (options) => {
     };
     for (const repository of repositories) {
         const before = await inspectLumenConsumer(repository, options.targetVersion);
-        const commands = options.apply
-            ? await upgradeConsumer(before, options.targetVersion ?? '', options.allowDirty ?? false, options.verify ?? true)
-            : [];
-        const after = options.apply
-            ? await inspectLumenConsumer(repository, options.targetVersion)
-            : before;
+        const commands = options.apply ?
+            await upgradeConsumer(before, options.targetVersion ?? '', options.allowDirty ?? false, options.verify ?? true) :
+            [];
+        const after = options.apply ? await inspectLumenConsumer(repository, options.targetVersion) : before;
         if (options.apply) {
             after.warnings = after.warnings.filter(warning => !warning.startsWith('Repository has uncommitted changes'));
-            after.valid = after.warnings.length === 0;
+            after.valid = after.warnings.length === 0 && after.integration.healthy;
         }
         report.repositories.push({ ...after, commands });
         if (commands.some(command => !command.ok))
@@ -391,6 +395,7 @@ export const formatConsumerRollout = (report) => {
     for (const repository of report.repositories) {
         lines.push('', repository.repository, `  package manager: ${repository.packageManager ?? 'missing'}`, `  node engine: ${repository.nodeEngine ?? 'unspecified'}`, `  frameworks: ${repository.frameworks.join(', ') || 'none'}`, `  resolved graph: ${JSON.stringify(repository.resolvedVersions)}`, `  status: ${repository.valid && repository.commands.every(command => command.ok) ? 'ok' : 'attention required'}`);
         lines.push(...repository.warnings.map(warning => `  warning: ${warning}`));
+        lines.push(...repository.integration.findings.map(item => `  ${item.severity}: ${item.file} ${item.rule}: ${item.message}`));
         lines.push(...repository.commands.map(command => `  ${command.ok ? 'pass' : 'fail'}: ${command.command}`));
     }
     return lines.join('\n');

package/dist/index.d.ts

@@ -1,10 +1,11 @@
 export { type ConsumerInventory, type ConsumerReference, type ConsumerRolloutOptions, type ConsumerRolloutReport, formatConsumerRollout, inspectLumenConsumer, type LumenFramework, runConsumerRollout, updateLumenManifestSource, updateLumenWorkspaceSource } from './consumer-rollout.js';
 export { addLumenRegistryItem, getLumenRegistryEntries, getLumenRegistryItem, loadLumenRegistry, type LumenAddOptions, type LumenAddResult, type LumenAddTarget, type LumenMergeConflict, type LumenRegistry, lumenRegistry, type LumenRegistryComponent, type LumenRegistryEntry, type LumenRegistryFile, type LumenRegistryItem, type LumenRegistryLoadOptions } from './registry.js';
-export { applyDataViewState, canPlaceScheduleEvent, coerceThemeBuilderExportFormat, coerceThemeBuilderMode, coerceThemeBuilderScheme, composeClassName, createDataViewRequestUrl, createDataViewSearchParams, createDataViewServerRequest, createDataViewState, createDataViewStorageKey, createScheduleSlots, createScheduleStorageKey, createThemeBuilderTokens, createThemePalette, expandRecurringScheduleEvent, exportThemeBuilderCss, exportThemeBuilderValue, exportThemeCss, filterDataRecords, getContrastRatio, getScheduleConflicts, getVirtualRange, loadDataViewState, loadScheduleEvents, type LumenCodeToken, lumenCodeTokenClassNames, type LumenCodeTokenKind, lumenColors, type LumenColorTokenName, lumenColorTokenNames, type LumenComponentName, lumenComponentNames, type LumenContrastScore, lumenDarkTheme, type LumenDataRecord, type LumenDataViewServerRequest, type LumenDataViewState, lumenGlass, type LumenGlassColorTokenName, lumenGlassColorTokenNames, type LumenGlassEffectTokenName, lumenGlassEffectTokenNames, type LumenGlassTokenName, lumenGlassTokenNames, type LumenKeyValueReader, type LumenKeyValueStorage, type LumenKeyValueWriter, lumenLightTheme, lumenPackages, type LumenPackageTarget, type LumenScheduleConflict, type LumenScheduleEvent, type LumenScheduleKeyValueReader, type LumenScheduleKeyValueStorage, type LumenScheduleKeyValueWriter, type LumenScheduleResizeEdge, type LumenScheduleResizeOptions, type LumenScheduleResource, type LumenScheduleSlot, type LumenSemanticColorTokenName, lumenSemanticColorTokenNames, type LumenSortDirection, lumenThemeAttribute, type LumenThemeBuilderExportFormat, type LumenThemeBuilderMode, type LumenThemeBuilderOptions, type LumenThemeBuilderResult, type LumenThemeBuilderScheme, type LumenThemeContrastSuggestion, type LumenThemeTokens, lumenTokenNames, mergeThemeTokens, moveScheduleEvent, normalizeLumenCode, normalizeThemeBuilderHex, normalizeThemeBuilderHue, paginateDataRecords, parseDataViewState, parseScheduleEvents, parseThemeCss, pinDataViewColumn, renderLumenCodeHtml, resizeScheduleEvent, resizeScheduleEvents, saveDataViewState, saveScheduleEvents, scheduleEventsOverlap, scoreThemeContrast, serializeDataViewState, serializeScheduleEvents, sortDataRecords, suggestReadableInk, themeBuilderHexToHsl, toggleDataViewSelection, tokenizeLumenCode, tuneThemeContrast, unpinDataViewColumn } from '@santi020k/lumen-core';
+export { alignLumenChartSeries, applyDataViewState, canPlaceScheduleEvent, coerceThemeBuilderExportFormat, coerceThemeBuilderMode, coerceThemeBuilderScheme, composeClassName, createDataViewRequestUrl, createDataViewSearchParams, createDataViewServerRequest, createDataViewState, createDataViewStorageKey, createLumenBarGeometry, createLumenFormFailure, createLumenFormSuccess, createLumenLineGeometry, createLumenPieGeometry, createScheduleSlots, createScheduleStorageKey, createThemeBuilderTokens, createThemePalette, expandRecurringScheduleEvent, exportThemeBuilderCss, exportThemeBuilderValue, exportThemeCss, filterDataRecords, getContrastRatio, getLumenChartCategories, getLumenChartDomain, getLumenChartTicks, getLumenChartValueRatio, getLumenFieldErrors, getScheduleConflicts, getVirtualRange, hasLumenPieData, loadDataViewState, loadScheduleEvents, type LumenBarChartLayout, type LumenBarGeometry, type LumenBarGeometryCategory, type LumenBarGeometryMark, type LumenBarGeometryOptions, lumenChart, type LumenChartDatum, type LumenChartDomain, type LumenChartGeometryPoint, type LumenChartOrientation, type LumenChartSeries, type LumenChartTone, lumenChartTones, type LumenCodeToken, lumenCodeTokenClassNames, type LumenCodeTokenKind, lumenColors, type LumenColorTokenName, lumenColorTokenNames, type LumenComponentName, lumenComponentNames, type LumenContrastScore, lumenDarkTheme, type LumenDataRecord, type LumenDataViewServerRequest, type LumenDataViewState, type LumenFieldError, type LumenFormErrorInput, type LumenFormErrors, type LumenFormFailure, type LumenFormResult, type LumenFormStatus, lumenFormStatuses, type LumenFormSuccess, lumenGlass, type LumenGlassColorTokenName, lumenGlassColorTokenNames, type LumenGlassEffectTokenName, lumenGlassEffectTokenNames, type LumenGlassTokenName, lumenGlassTokenNames, type LumenKeyValueReader, type LumenKeyValueStorage, type LumenKeyValueWriter, lumenLightTheme, type LumenLineGeometry, type LumenLineGeometryOptions, lumenPackages, type LumenPackageTarget, type LumenPieChartVariant, type LumenPieGeometry, type LumenPieGeometryOptions, type LumenPieGeometrySlice, type LumenScheduleConflict, type LumenScheduleEvent, type LumenScheduleKeyValueReader, type LumenScheduleKeyValueStorage, type LumenScheduleKeyValueWriter, type LumenScheduleResizeEdge, type LumenScheduleResizeOptions, type LumenScheduleResource, type LumenScheduleSlot, type LumenSemanticColorTokenName, lumenSemanticColorTokenNames, type LumenSortDirection, lumenThemeAttribute, type LumenThemeBuilderExportFormat, type LumenThemeBuilderMode, type LumenThemeBuilderOptions, type LumenThemeBuilderResult, type LumenThemeBuilderScheme, type LumenThemeContrastSuggestion, type LumenThemeTokens, lumenTokenNames, mergeThemeTokens, moveScheduleEvent, normalizeLumenCode, normalizeLumenFormErrors, normalizeThemeBuilderHex, normalizeThemeBuilderHue, paginateDataRecords, parseDataViewState, parseScheduleEvents, parseThemeCss, pinDataViewColumn, renderLumenCodeHtml, resizeScheduleEvent, resizeScheduleEvents, resolveLumenChartTone, saveDataViewState, saveScheduleEvents, scaleLumenChartValue, scheduleEventsOverlap, scoreThemeContrast, serializeDataViewState, serializeScheduleEvents, sortDataRecords, suggestReadableInk, themeBuilderHexToHsl, toggleDataViewSelection, tokenizeLumenCode, tuneThemeContrast, unpinDataViewColumn } from '@santi020k/lumen-core';
 export declare const lumen: {
     readonly name: "Lumen";
     readonly packageName: "@santi020k/lumen";
     readonly scope: "@santi020k";
 };
+export { createLumenSetup, formatLumenDiagnostics, inspectLumenIntegration, type LumenDiagnosticFinding, type LumenDiagnosticReport, type LumenDiagnosticSeverity } from './integration-diagnostics.js';
 export { auditLumenTokenCss, type LumenTokenAuditFinding } from './token-audit.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,cAAc,EACnB,kBAAkB,EAClB,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,aAAa,EACb,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC9B,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,8BAA8B,EAC9B,sBAAsB,EACtB,wBAAwB,EACxB,gBAAgB,EAChB,wBAAwB,EACxB,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,EACxB,kBAAkB,EAClB,4BAA4B,EAC5B,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,cAAc,EACnB,wBAAwB,EACxB,KAAK,kBAAkB,EACvB,WAAW,EACX,KAAK,mBAAmB,EACxB,oBAAoB,EACpB,KAAK,kBAAkB,EACvB,mBAAmB,EACnB,KAAK,kBAAkB,EACvB,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACvB,UAAU,EACV,KAAK,wBAAwB,EAC7B,yBAAyB,EACzB,KAAK,yBAAyB,EAC9B,0BAA0B,EAC1B,KAAK,mBAAmB,EACxB,oBAAoB,EACpB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,eAAe,EACf,aAAa,EACb,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAC/B,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,EAChC,4BAA4B,EAC5B,KAAK,kBAAkB,EACvB,mBAAmB,EACnB,KAAK,6BAA6B,EAClC,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EACjC,KAAK,gBAAgB,EACrB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,uBAAuB,CAAA;AAE9B,eAAO,MAAM,KAAK;;;;CAIR,CAAA;AAEV,OAAO,EACL,kBAAkB,EAClB,KAAK,sBAAsB,EAC5B,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,9 +1,10 @@
 export { formatConsumerRollout, inspectLumenConsumer, runConsumerRollout, updateLumenManifestSource, updateLumenWorkspaceSource } from './consumer-rollout.js';
 export { addLumenRegistryItem, getLumenRegistryEntries, getLumenRegistryItem, loadLumenRegistry, lumenRegistry } from './registry.js';
-export { applyDataViewState, canPlaceScheduleEvent, coerceThemeBuilderExportFormat, coerceThemeBuilderMode, coerceThemeBuilderScheme, composeClassName, createDataViewRequestUrl, createDataViewSearchParams, createDataViewServerRequest, createDataViewState, createDataViewStorageKey, createScheduleSlots, createScheduleStorageKey, createThemeBuilderTokens, createThemePalette, expandRecurringScheduleEvent, exportThemeBuilderCss, exportThemeBuilderValue, exportThemeCss, filterDataRecords, getContrastRatio, getScheduleConflicts, getVirtualRange, loadDataViewState, loadScheduleEvents, lumenCodeTokenClassNames, lumenColors, lumenColorTokenNames, lumenComponentNames, lumenDarkTheme, lumenGlass, lumenGlassColorTokenNames, lumenGlassEffectTokenNames, lumenGlassTokenNames, lumenLightTheme, lumenPackages, lumenSemanticColorTokenNames, lumenThemeAttribute, lumenTokenNames, mergeThemeTokens, moveScheduleEvent, normalizeLumenCode, normalizeThemeBuilderHex, normalizeThemeBuilderHue, paginateDataRecords, parseDataViewState, parseScheduleEvents, parseThemeCss, pinDataViewColumn, renderLumenCodeHtml, resizeScheduleEvent, resizeScheduleEvents, saveDataViewState, saveScheduleEvents, scheduleEventsOverlap, scoreThemeContrast, serializeDataViewState, serializeScheduleEvents, sortDataRecords, suggestReadableInk, themeBuilderHexToHsl, toggleDataViewSelection, tokenizeLumenCode, tuneThemeContrast, unpinDataViewColumn } from '@santi020k/lumen-core';
+export { alignLumenChartSeries, applyDataViewState, canPlaceScheduleEvent, coerceThemeBuilderExportFormat, coerceThemeBuilderMode, coerceThemeBuilderScheme, composeClassName, createDataViewRequestUrl, createDataViewSearchParams, createDataViewServerRequest, createDataViewState, createDataViewStorageKey, createLumenBarGeometry, createLumenFormFailure, createLumenFormSuccess, createLumenLineGeometry, createLumenPieGeometry, createScheduleSlots, createScheduleStorageKey, createThemeBuilderTokens, createThemePalette, expandRecurringScheduleEvent, exportThemeBuilderCss, exportThemeBuilderValue, exportThemeCss, filterDataRecords, getContrastRatio, getLumenChartCategories, getLumenChartDomain, getLumenChartTicks, getLumenChartValueRatio, getLumenFieldErrors, getScheduleConflicts, getVirtualRange, hasLumenPieData, loadDataViewState, loadScheduleEvents, lumenChart, lumenChartTones, lumenCodeTokenClassNames, lumenColors, lumenColorTokenNames, lumenComponentNames, lumenDarkTheme, lumenFormStatuses, lumenGlass, lumenGlassColorTokenNames, lumenGlassEffectTokenNames, lumenGlassTokenNames, lumenLightTheme, lumenPackages, lumenSemanticColorTokenNames, lumenThemeAttribute, lumenTokenNames, mergeThemeTokens, moveScheduleEvent, normalizeLumenCode, normalizeLumenFormErrors, normalizeThemeBuilderHex, normalizeThemeBuilderHue, paginateDataRecords, parseDataViewState, parseScheduleEvents, parseThemeCss, pinDataViewColumn, renderLumenCodeHtml, resizeScheduleEvent, resizeScheduleEvents, resolveLumenChartTone, saveDataViewState, saveScheduleEvents, scaleLumenChartValue, scheduleEventsOverlap, scoreThemeContrast, serializeDataViewState, serializeScheduleEvents, sortDataRecords, suggestReadableInk, themeBuilderHexToHsl, toggleDataViewSelection, tokenizeLumenCode, tuneThemeContrast, unpinDataViewColumn } from '@santi020k/lumen-core';
 export const lumen = {
     name: 'Lumen',
     packageName: '@santi020k/lumen',
     scope: '@santi020k'
 };
+export { createLumenSetup, formatLumenDiagnostics, inspectLumenIntegration } from './integration-diagnostics.js';
 export { auditLumenTokenCss } from './token-audit.js';

package/dist/installer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"AAeA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,kBAAkB,EAExB,MAAM,eAAe,CAAA;AAOtB,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,CAAA;IACnD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,MAAM,CAAA;IAChD,QAAQ,CAAC,EAAE,aAAa,CAAA;IACxB,MAAM,CAAC,EAAE,cAAc,CAAA;CACxB;AAED,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAA;AAE3D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,IAAI,EAAE,kBAAkB,CAAA;IACxB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AA4MD,eAAO,MAAM,oBAAoB,GAC/B,MAAM,MAAM,EACZ,UAAS,eAAoB,KAC5B,OAAO,CAAC,cAAc,CA2CxB,CAAA"}
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,kBAAkB,EAExB,MAAM,eAAe,CAAA;AAOtB,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,CAAA;IACnD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,MAAM,CAAA;IAChD,QAAQ,CAAC,EAAE,aAAa,CAAA;IACxB,MAAM,CAAC,EAAE,cAAc,CAAA;CACxB;AAED,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAA;AAE3D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,IAAI,EAAE,kBAAkB,CAAA;IACxB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAuND,eAAO,MAAM,oBAAoB,GAAU,MAAM,MAAM,EAAE,UAAS,eAAoB,KAAG,OAAO,CAAC,cAAc,CA2C9G,CAAA"}

package/dist/installer.js

@@ -1,18 +1,24 @@
 import { access, mkdir, readdir, readFile, writeFile } from 'node:fs/promises';
 import { dirname, join, relative, sep } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { getLumenRegistryItem, } from './registry.js';
+import { getLumenRegistryItem } from './registry.js';
 const templatesRoot = fileURLToPath(new URL('../templates/', import.meta.url));
-const loadRecipeTemplateFiles = async (itemName, target) => {
-    const templateDir = join(templatesRoot, target, itemName);
+const productTemplateRecipes = new Set([
+    'analytics-dashboard',
+    'auth-onboarding',
+    'commerce-dashboard',
+    'project-workspace',
+    'saas-admin'
+]);
+const loadTemplateDirectory = async (templateDir) => {
     let entries;
     try {
         entries = await readdir(templateDir, { recursive: true, withFileTypes: true });
     }
     catch {
-        return undefined;
+        return [];
     }
-    const files = await Promise.all(entries
+    return Promise.all(entries
         .filter(entry => entry.isFile())
         .map(async (entry) => {
         const absolutePath = join(entry.parentPath, entry.name);
@@ -21,11 +27,23 @@ const loadRecipeTemplateFiles = async (itemName, target) => {
             source: await readFile(absolutePath, 'utf8')
         };
     }));
-    files.sort((first, second) => first.path.localeCompare(second.path));
+};
+const loadRecipeTemplateFiles = async (itemName, target) => {
+    const templateDirectories = [
+        ...(productTemplateRecipes.has(itemName) ? [join(templatesRoot, 'shared', 'common')] : []),
+        join(templatesRoot, 'shared', itemName),
+        join(templatesRoot, target, itemName)
+    ];
+    const templateFiles = await Promise.all(templateDirectories.map(loadTemplateDirectory));
+    const filesByPath = new Map();
+    for (const file of templateFiles.flat()) {
+        filesByPath.set(file.path, file);
+    }
+    const files = [...filesByPath.values()].sort((first, second) => first.path.localeCompare(second.path));
     return files.length > 0 ? files : undefined;
 };
 const toKebabCase = (name) => name.replaceAll(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();
-const toCamelCase = (value) => value.replaceAll(/-([a-z])/g, (_match, character) => character.toUpperCase());
+const toCamelCase = (value) => (value.replaceAll(/-([a-z])/g, (_match, character) => character.toUpperCase()));
 const createAstroComponentFile = (name) => ({
     path: `src/lumen/${toKebabCase(name)}.astro`,
     source: `---
@@ -115,7 +133,7 @@ const mergeFileSource = ({ existing, incoming, path }) => {
         return existing;
     return `${existing.trimEnd()}\n\n/* Lumen merge: ${path} */\n${incoming}`;
 };
-const getConflictMode = (options) => options.force ? 'overwrite' : options.conflict ?? 'skip';
+const getConflictMode = (options) => (options.force ? 'overwrite' : (options.conflict ?? 'skip'));
 const getInstallSource = async (file, target, exists, options, conflict) => {
     if (!exists || conflict !== 'merge')
         return file.source;

package/dist/integration-diagnostics.d.ts

@@ -0,0 +1,21 @@
+export type LumenDiagnosticSeverity = 'advisory' | 'error';
+export interface LumenDiagnosticFinding {
+    file: string;
+    message: string;
+    remediation: string;
+    rule: string;
+    severity: LumenDiagnosticSeverity;
+}
+export interface LumenDiagnosticReport {
+    catalogFingerprint: string;
+    findings: LumenDiagnosticFinding[];
+    frameworks: ('astro' | 'elements' | 'react')[];
+    generatedAt: string;
+    healthy: boolean;
+    repository: string;
+    runtimeComponents: string[];
+}
+export declare const inspectLumenIntegration: (repository: string) => Promise<LumenDiagnosticReport>;
+export declare const formatLumenDiagnostics: (report: LumenDiagnosticReport) => string;
+export declare const createLumenSetup: (framework: "astro" | "elements" | "react", tailwind?: boolean) => string;
+//# sourceMappingURL=integration-diagnostics.d.ts.map

package/dist/integration-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-diagnostics.d.ts","sourceRoot":"","sources":["../src/integration-diagnostics.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,uBAAuB,GAAG,UAAU,GAAG,OAAO,CAAA;AAE1D,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,uBAAuB,CAAA;CAClC;AAED,MAAM,WAAW,qBAAqB;IACpC,kBAAkB,EAAE,MAAM,CAAA;IAC1B,QAAQ,EAAE,sBAAsB,EAAE,CAAA;IAClC,UAAU,EAAE,CAAC,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC,EAAE,CAAA;IAC9C,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,iBAAiB,EAAE,MAAM,EAAE,CAAA;CAC5B;AA8LD,eAAO,MAAM,uBAAuB,GAAU,YAAY,MAAM,KAAG,OAAO,CAAC,qBAAqB,CA+B/F,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,QAAQ,qBAAqB,KAAG,MAWtE,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAI,WAAW,OAAO,GAAG,UAAU,GAAG,OAAO,EAAE,kBAAgB,KAAG,MAsC9F,CAAA"}