@littlebearapps/platform-admin-sdk 2.1.0 → 2.3.0

package/README.md

@@ -276,13 +276,10 @@ See [Upgrade Guide](../../docs/admin-sdk/upgrade-guide.md) for detailed instruct
 
 ## What's Not Included
 
-The scaffolder generates core infrastructure only. It does **not** create:
+The scaffolder generates core infrastructure, an Astro SSR dashboard (273 templates), test suites, and CI workflows. It does **not** create:
 
-- Dashboards or admin UIs
-- Email workers or notification templates
+- Email workers or notification email templates
 - Data connectors (Stripe, GA4, Plausible, etc.)
-- Test suites
-- CI/CD workflows (use the [consumer-check.yml](../../docs/admin-sdk/ci-workflow.md) reusable workflow)
 
 These are project-specific — build them as you need them.
 

package/dist/check-upgrade.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Pre-flight check for upgrades — detects potential issues before writing files.
+ *
+ * Checks for:
+ *   - Template naming collisions
+ *   - Placeholder values left in wrangler configs (e.g., "YOUR_DB_ID")
+ *   - Migration number conflicts
+ *   - Excluded files from the manifest
+ */
+import type { Tier } from './prompts.js';
+export interface CheckResult {
+    currentVersion: string;
+    targetVersion: string;
+    currentTier: string;
+    targetTier: string;
+    placeholders: string[];
+    collisions: string[];
+    migrationConflicts: string[];
+    excludedFiles: string[];
+    ok: boolean;
+}
+/**
+ * Run pre-flight checks for an upgrade without modifying any files.
+ *
+ * @param projectDir - Path to the project directory
+ * @param targetTier - Optional tier to upgrade to (defaults to current tier)
+ * @returns CheckResult with all detected issues
+ */
+export declare function checkUpgrade(projectDir: string, targetTier?: Tier): CheckResult;

package/dist/check-upgrade.js

@@ -0,0 +1,97 @@
+/**
+ * Pre-flight check for upgrades — detects potential issues before writing files.
+ *
+ * Checks for:
+ *   - Template naming collisions
+ *   - Placeholder values left in wrangler configs (e.g., "YOUR_DB_ID")
+ *   - Migration number conflicts
+ *   - Excluded files from the manifest
+ */
+import { readFileSync, existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { detectCollisions, SDK_VERSION, getFilesForTier, isMigrationFile } from './templates.js';
+import { readManifest, MANIFEST_FILENAME } from './manifest.js';
+import { findHighestMigration, getMigrationNumber } from './migrations.js';
+/** Patterns that indicate placeholder values left by scaffolding. */
+const PLACEHOLDER_PATTERNS = [
+    /YOUR_DB_ID/,
+    /YOUR_KV_ID/,
+    /YOUR_QUEUE_ID/,
+    /YOUR_R2_BUCKET/,
+    /PLACEHOLDER/,
+    /your-database-id/,
+    /your-kv-namespace-id/,
+    /your-queue-id/,
+];
+/**
+ * Run pre-flight checks for an upgrade without modifying any files.
+ *
+ * @param projectDir - Path to the project directory
+ * @param targetTier - Optional tier to upgrade to (defaults to current tier)
+ * @returns CheckResult with all detected issues
+ */
+export function checkUpgrade(projectDir, targetTier) {
+    const manifest = readManifest(projectDir);
+    if (!manifest) {
+        throw new Error(`No ${MANIFEST_FILENAME} found in ${projectDir}.\n` +
+            `Run \`platform-admin-sdk adopt\` first.`);
+    }
+    const effectiveTier = targetTier ?? manifest.tier;
+    const result = {
+        currentVersion: manifest.sdkVersion,
+        targetVersion: SDK_VERSION,
+        currentTier: manifest.tier,
+        targetTier: effectiveTier,
+        placeholders: [],
+        collisions: [],
+        migrationConflicts: [],
+        excludedFiles: [...(manifest.excludeFromUpgrade ?? [])],
+        ok: true,
+    };
+    // 1. Check for naming collisions
+    result.collisions = detectCollisions(effectiveTier);
+    // 2. Scan wrangler.*.jsonc files for placeholder values
+    if (existsSync(projectDir)) {
+        let dirEntries;
+        try {
+            dirEntries = readdirSync(projectDir);
+        }
+        catch {
+            dirEntries = [];
+        }
+        const wranglerFiles = dirEntries.filter((f) => f.startsWith('wrangler') && (f.endsWith('.jsonc') || f.endsWith('.json')));
+        for (const wf of wranglerFiles) {
+            const filePath = join(projectDir, wf);
+            const content = readFileSync(filePath, 'utf-8');
+            for (const pattern of PLACEHOLDER_PATTERNS) {
+                if (pattern.test(content)) {
+                    result.placeholders.push(`${wf}: contains ${pattern.source}`);
+                }
+            }
+        }
+    }
+    // 3. Check for migration conflicts
+    const migrationsDir = join(projectDir, 'storage/d1/migrations');
+    const userHighest = findHighestMigration(migrationsDir);
+    const files = getFilesForTier(effectiveTier);
+    const migrationFiles = files.filter((f) => isMigrationFile(f));
+    // Find new scaffold migrations that would need to be renumbered
+    const newScaffoldMigrations = migrationFiles.filter((f) => {
+        const num = getMigrationNumber(f.dest);
+        return num !== null && num > manifest.highestScaffoldMigration;
+    });
+    // Check if any new scaffold migration numbers overlap with existing user migrations
+    for (const mf of newScaffoldMigrations) {
+        const num = getMigrationNumber(mf.dest);
+        if (num !== null && num <= userHighest && num > manifest.highestScaffoldMigration) {
+            const filename = mf.dest.split('/').pop() ?? mf.dest;
+            result.migrationConflicts.push(`${filename} (number ${num}) overlaps with existing user migrations (highest: ${userHighest}) — will be renumbered`);
+        }
+    }
+    // 4. Determine overall ok status
+    result.ok =
+        result.collisions.length === 0 &&
+            result.placeholders.length === 0 &&
+            result.migrationConflicts.length === 0;
+    return result;
+}

package/dist/index.js

@@ -24,6 +24,7 @@ import { collectOptions, isValidTier } from './prompts.js';
 import { scaffold } from './scaffold.js';
 import { upgrade } from './upgrade.js';
 import { adopt } from './adopt.js';
+import { checkUpgrade } from './check-upgrade.js';
 import { SDK_VERSION } from './templates.js';
 const BANNER = `
   ${pc.bold(pc.cyan('Platform Admin SDK'))} — Cloudflare Cost Protection
@@ -109,11 +110,15 @@ const upgradeCmd = new Command('upgrade')
     });
     console.log();
     const total = result.created.length + result.updated.length + result.migrations.length;
-    if (total === 0 && result.skipped.length === 0) {
+    if (total === 0 && result.skipped.length === 0 && result.excluded.length === 0) {
         console.log(pc.green('  Already up to date.'));
     }
     else {
-        console.log(`  ${pc.green(`${result.created.length} created`)}, ${pc.cyan(`${result.updated.length} updated`)}, ${pc.yellow(`${result.skipped.length} skipped`)}, ${pc.green(`${result.migrations.length} migrations`)}`);
+        let summary = `  ${pc.green(`${result.created.length} created`)}, ${pc.cyan(`${result.updated.length} updated`)}, ${pc.yellow(`${result.skipped.length} skipped`)}, ${pc.green(`${result.migrations.length} migrations`)}`;
+        if (result.excluded.length > 0) {
+            summary += `, ${pc.dim(`${result.excluded.length} excluded`)}`;
+        }
+        console.log(summary);
     }
     if (result.removed.length > 0) {
         console.log(`  ${pc.yellow(`${result.removed.length} files removed from SDK (kept on disk)`)}`);
@@ -170,6 +175,55 @@ const adoptCmd = new Command('adopt')
     console.log(`  ${pc.dim('You can now run:')} ${pc.cyan('platform-admin-sdk upgrade')}`);
     console.log();
 });
+// --- Check-upgrade command ---
+const checkUpgradeCmd = new Command('check-upgrade')
+    .description('Pre-flight check for upgrades — detect issues without writing files')
+    .argument('[project-dir]', 'Path to the project directory', '.')
+    .option('--tier <tier>', 'Target tier to check against')
+    .action(async (projectDirArg, cmdOpts) => {
+    if (cmdOpts.tier && !isValidTier(cmdOpts.tier)) {
+        console.error(pc.red(`  Error: Invalid tier "${cmdOpts.tier}". Must be one of: minimal, standard, full`));
+        process.exit(1);
+    }
+    const projectDir = resolve(process.cwd(), projectDirArg);
+    console.log(`  ${pc.bold('Checking')}: ${projectDir}`);
+    console.log();
+    const result = checkUpgrade(projectDir, cmdOpts.tier);
+    console.log(`  ${pc.bold('Current')}: v${result.currentVersion} (${result.currentTier})`);
+    console.log(`  ${pc.bold('Target')}:  v${result.targetVersion} (${result.targetTier})`);
+    console.log();
+    if (result.collisions.length > 0) {
+        console.log(pc.red(`  Collisions (${result.collisions.length}):`));
+        for (const c of result.collisions)
+            console.log(`    - ${c}`);
+        console.log();
+    }
+    if (result.placeholders.length > 0) {
+        console.log(pc.yellow(`  Placeholders (${result.placeholders.length}):`));
+        for (const p of result.placeholders)
+            console.log(`    - ${p}`);
+        console.log();
+    }
+    if (result.migrationConflicts.length > 0) {
+        console.log(pc.yellow(`  Migration conflicts (${result.migrationConflicts.length}):`));
+        for (const m of result.migrationConflicts)
+            console.log(`    - ${m}`);
+        console.log();
+    }
+    if (result.excludedFiles.length > 0) {
+        console.log(pc.dim(`  Excluded files (${result.excludedFiles.length}):`));
+        for (const e of result.excludedFiles)
+            console.log(`    - ${e}`);
+        console.log();
+    }
+    if (result.ok) {
+        console.log(pc.green('  All checks passed. Safe to upgrade.'));
+    }
+    else {
+        console.log(pc.yellow('  Issues found. Review before upgrading.'));
+    }
+    console.log();
+});
 // --- Main program ---
 const program = new Command()
     .name('platform-admin-sdk')
@@ -177,12 +231,13 @@ const program = new Command()
     .version(SDK_VERSION)
     .addCommand(scaffoldCmd)
     .addCommand(upgradeCmd)
-    .addCommand(adoptCmd);
+    .addCommand(adoptCmd)
+    .addCommand(checkUpgradeCmd);
 async function main() {
     console.log(BANNER);
     // Backward compat: if first arg isn't a known subcommand, treat it as `scaffold <arg>`
     const args = process.argv.slice(2);
-    const subcommands = ['scaffold', 'upgrade', 'adopt', 'help', '--help', '-h', '--version', '-V'];
+    const subcommands = ['scaffold', 'upgrade', 'adopt', 'check-upgrade', 'help', '--help', '-h', '--version', '-V'];
     if (args.length > 0 && !subcommands.includes(args[0])) {
         // Inject 'scaffold' as the subcommand
         process.argv.splice(2, 0, 'scaffold');

package/dist/manifest.d.ts

@@ -28,6 +28,8 @@ export interface ScaffoldManifest {
     files: Record<string, string>;
     /** Highest migration number owned by the scaffolder (user migrations are higher). */
     highestScaffoldMigration: number;
+    /** Relative file paths to skip during upgrade (user-managed files). */
+    excludeFromUpgrade?: string[];
 }
 /** SHA-256 hash of file content. */
 export declare function hashContent(content: string): string;

package/dist/scaffold.js

@@ -6,7 +6,7 @@ import { resolve, dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import Handlebars from 'handlebars';
 import pc from 'picocolors';
-import { getFilesForTier, SDK_VERSION } from './templates.js';
+import { getFilesForTier, SDK_VERSION, detectCollisions } from './templates.js';
 import { hashContent, buildManifest, writeManifest, MANIFEST_FILENAME } from './manifest.js';
 import { findHighestMigration } from './migrations.js';
 const __filename = fileURLToPath(import.meta.url);
@@ -35,6 +35,10 @@ export async function scaffold(options, outputDir) {
         }
         throw new Error(`Directory already exists: ${outputDir}`);
     }
+    const collisions = detectCollisions(options.tier);
+    if (collisions.length > 0) {
+        throw new Error(`Template naming collisions detected:\n${collisions.map((c) => `  - ${c}`).join('\n')}`);
+    }
     const templatesDir = getTemplatesDir();
     const files = getFilesForTier(options.tier);
     const context = {

package/dist/templates.d.ts

@@ -6,7 +6,7 @@
  */
 import type { Tier } from './prompts.js';
 /** Single source of truth for the SDK version. */
-export declare const SDK_VERSION = "2.1.0";
+export declare const SDK_VERSION = "2.3.0";
 /** Returns true if `to` is the same or higher tier than `from`. */
 export declare function isTierUpgradeOrSame(from: Tier, to: Tier): boolean;
 /** Check if a template file is a numbered migration (not seed.sql). */
@@ -19,4 +19,9 @@ export interface TemplateFile {
     /** Whether this file uses Handlebars templating */
     template: boolean;
 }
+/**
+ * Detect naming collisions where two template files resolve to the same destination path.
+ * Returns an array of collision descriptions (empty = no collisions).
+ */
+export declare function detectCollisions(tier: Tier): string[];
 export declare function getFilesForTier(tier: Tier): TemplateFile[];

package/dist/templates.js

@@ -5,7 +5,7 @@
  * All other files are copied verbatim.
  */
 /** Single source of truth for the SDK version. */
-export const SDK_VERSION = '2.1.0';
+export const SDK_VERSION = '2.3.0';
 /** Tier ordering for upgrade validation. */
 const TIER_ORDER = { minimal: 0, standard: 1, full: 2 };
 /** Returns true if `to` is the same or higher tier than `from`. */
@@ -28,6 +28,10 @@ const SHARED_FILES = [
     { src: 'shared/scripts/ops/reset-budget-state.ts', dest: 'scripts/ops/reset-budget-state.ts', template: false },
     { src: 'shared/scripts/ops/verify-account-completeness.ts', dest: 'scripts/ops/verify-account-completeness.ts', template: false },
     { src: 'shared/scripts/ops/validate-pipeline.ts', dest: 'scripts/ops/validate-pipeline.ts', template: false },
+    { src: 'shared/scripts/test-telemetry-flow.ts', dest: 'scripts/test-telemetry-flow.ts', template: false },
+    // CI/CD Workflows (v2.2.0)
+    { src: 'shared/.github/workflows/validate-controls.yml', dest: '.github/workflows/validate-controls.yml', template: false },
+    { src: 'shared/.github/workflows/dependabot-automerge.yml', dest: '.github/workflows/dependabot-automerge.yml', template: false },
     // Contracts — JSON schemas + TypeScript types
     { src: 'shared/contracts/schemas/envelope.v1.schema.json', dest: 'contracts/schemas/envelope.v1.schema.json', template: false },
     { src: 'shared/contracts/schemas/error_report.v1.schema.json', dest: 'contracts/schemas/error_report.v1.schema.json', template: false },
@@ -143,10 +147,82 @@ const SHARED_FILES = [
     { src: 'shared/dashboard/src/components/resources/CostCentreOverview.tsx', dest: 'dashboard/src/components/resources/CostCentreOverview.tsx', template: false },
     { src: 'shared/dashboard/src/components/resources/AllowanceStatus.tsx', dest: 'dashboard/src/components/resources/AllowanceStatus.tsx', template: false },
     { src: 'shared/dashboard/src/components/resources/index.ts', dest: 'dashboard/src/components/resources/index.ts', template: false },
+    { src: 'shared/dashboard/src/components/resources/CostChart.tsx', dest: 'dashboard/src/components/resources/CostChart.tsx', template: false },
+    { src: 'shared/dashboard/src/components/resources/ProviderCard.tsx', dest: 'dashboard/src/components/resources/ProviderCard.tsx', template: false },
+    { src: 'shared/dashboard/src/components/resources/ProviderDetail.tsx', dest: 'dashboard/src/components/resources/ProviderDetail.tsx', template: false },
     { src: 'shared/dashboard/src/components/settings/SettingsCard.tsx', dest: 'dashboard/src/components/settings/SettingsCard.tsx', template: false },
+    { src: 'shared/dashboard/src/components/settings/SettingsCard.astro', dest: 'dashboard/src/components/settings/SettingsCard.astro', template: false },
     { src: 'shared/dashboard/src/components/settings/index.ts', dest: 'dashboard/src/components/settings/index.ts', template: false },
+    { src: 'shared/dashboard/src/components/overview/AlertBanner.tsx', dest: 'dashboard/src/components/overview/AlertBanner.tsx', template: false },
+    { src: 'shared/dashboard/src/components/overview/index.ts', dest: 'dashboard/src/components/overview/index.ts', template: false },
+    { src: 'shared/dashboard/src/components/costs/index.ts', dest: 'dashboard/src/components/costs/index.ts', template: false },
+    { src: 'shared/dashboard/src/components/costs/ProviderCostsGrid.tsx', dest: 'dashboard/src/components/costs/ProviderCostsGrid.tsx', template: false },
     { src: 'shared/dashboard/src/lib/types.ts', dest: 'dashboard/src/lib/types.ts', template: false },
     { src: 'shared/dashboard/src/lib/fetch.ts', dest: 'dashboard/src/lib/fetch.ts', template: false },
+    // Dashboard — shared tier: Astro shell components (v2.2.0)
+    { src: 'shared/dashboard/src/components/Breadcrumbs.astro', dest: 'dashboard/src/components/Breadcrumbs.astro', template: false },
+    { src: 'shared/dashboard/src/components/EmptyState.astro', dest: 'dashboard/src/components/EmptyState.astro', template: false },
+    { src: 'shared/dashboard/src/components/ErrorBoundary.astro', dest: 'dashboard/src/components/ErrorBoundary.astro', template: false },
+    { src: 'shared/dashboard/src/components/LoadingSkeleton.astro', dest: 'dashboard/src/components/LoadingSkeleton.astro', template: false },
+    { src: 'shared/dashboard/src/components/PageShell.astro', dest: 'dashboard/src/components/PageShell.astro', template: false },
+    { src: 'shared/dashboard/src/components/SkipLinks.astro', dest: 'dashboard/src/components/SkipLinks.astro', template: false },
+    { src: 'shared/dashboard/src/components/Toast.astro', dest: 'dashboard/src/components/Toast.astro', template: false },
+    { src: 'shared/dashboard/src/components/ToastContainer.astro', dest: 'dashboard/src/components/ToastContainer.astro', template: false },
+    // Dashboard — shared tier: usage Astro components (v2.2.0)
+    { src: 'shared/dashboard/src/components/usage/types.ts', dest: 'dashboard/src/components/usage/types.ts', template: false },
+    { src: 'shared/dashboard/src/components/usage/design-tokens.ts', dest: 'dashboard/src/components/usage/design-tokens.ts', template: false },
+    { src: 'shared/dashboard/src/components/usage/usage-colors.ts', dest: 'dashboard/src/components/usage/usage-colors.ts', template: false },
+    { src: 'shared/dashboard/src/components/usage/AllowanceGauge.astro', dest: 'dashboard/src/components/usage/AllowanceGauge.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/AnomalyAlerts.astro', dest: 'dashboard/src/components/usage/AnomalyAlerts.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/BillingCycleCountdown.astro', dest: 'dashboard/src/components/usage/BillingCycleCountdown.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/BurnRateHero.astro', dest: 'dashboard/src/components/usage/BurnRateHero.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/CircuitBreakerEventLog.astro', dest: 'dashboard/src/components/usage/CircuitBreakerEventLog.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/CircuitBreakerPanel.tsx', dest: 'dashboard/src/components/usage/CircuitBreakerPanel.tsx', template: false },
+    { src: 'shared/dashboard/src/components/usage/CircuitBreakerStatus.astro', dest: 'dashboard/src/components/usage/CircuitBreakerStatus.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/CompactThresholdBanner.astro', dest: 'dashboard/src/components/usage/CompactThresholdBanner.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/ComparisonModeSelector.astro', dest: 'dashboard/src/components/usage/ComparisonModeSelector.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/CostBreakdownChart.astro', dest: 'dashboard/src/components/usage/CostBreakdownChart.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/CostBreakdownTable.astro', dest: 'dashboard/src/components/usage/CostBreakdownTable.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/CostDataTable.astro', dest: 'dashboard/src/components/usage/CostDataTable.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/CostDonutChart.astro', dest: 'dashboard/src/components/usage/CostDonutChart.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/DailyCostChart.astro', dest: 'dashboard/src/components/usage/DailyCostChart.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/ExportButton.astro', dest: 'dashboard/src/components/usage/ExportButton.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/FeatureBudgetsTable.astro', dest: 'dashboard/src/components/usage/FeatureBudgetsTable.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/FilterBar.astro', dest: 'dashboard/src/components/usage/FilterBar.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/FilterToggles.astro', dest: 'dashboard/src/components/usage/FilterToggles.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/GitHubUsageCard.astro', dest: 'dashboard/src/components/usage/GitHubUsageCard.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/OverageCostCard.astro', dest: 'dashboard/src/components/usage/OverageCostCard.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/PlanUtilizationCard.astro', dest: 'dashboard/src/components/usage/PlanUtilizationCard.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/ProjectCard.astro', dest: 'dashboard/src/components/usage/ProjectCard.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/ProjectCardsGrid.astro', dest: 'dashboard/src/components/usage/ProjectCardsGrid.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/ResourceSearch.astro', dest: 'dashboard/src/components/usage/ResourceSearch.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/ServiceUtilizationList.astro', dest: 'dashboard/src/components/usage/ServiceUtilizationList.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/SparklineCard.astro', dest: 'dashboard/src/components/usage/SparklineCard.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/StatsHero.astro', dest: 'dashboard/src/components/usage/StatsHero.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/TableFilters.astro', dest: 'dashboard/src/components/usage/TableFilters.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/ThresholdAlert.astro', dest: 'dashboard/src/components/usage/ThresholdAlert.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/ThresholdSettings.astro', dest: 'dashboard/src/components/usage/ThresholdSettings.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/TopSpenderCard.astro', dest: 'dashboard/src/components/usage/TopSpenderCard.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/UnifiedResourceTable.astro', dest: 'dashboard/src/components/usage/UnifiedResourceTable.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/UsageCard.astro', dest: 'dashboard/src/components/usage/UsageCard.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/UsageHealthBanner.astro', dest: 'dashboard/src/components/usage/UsageHealthBanner.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/UtilizationBar.astro', dest: 'dashboard/src/components/usage/UtilizationBar.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/WorkersBreakdownTable.astro', dest: 'dashboard/src/components/usage/WorkersBreakdownTable.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/daily/CostChart.astro', dest: 'dashboard/src/components/usage/daily/CostChart.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/daily/CostTable.astro', dest: 'dashboard/src/components/usage/daily/CostTable.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/daily/DailyOverview.astro', dest: 'dashboard/src/components/usage/daily/DailyOverview.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/filters/InlineDateRange.astro', dest: 'dashboard/src/components/usage/filters/InlineDateRange.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/filters/PeriodButtons.astro', dest: 'dashboard/src/components/usage/filters/PeriodButtons.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/filters/ProjectSelect.astro', dest: 'dashboard/src/components/usage/filters/ProjectSelect.astro', template: false },
+    { src: 'shared/dashboard/src/components/usage/scripts/ai-tab-controller.ts', dest: 'dashboard/src/components/usage/scripts/ai-tab-controller.ts', template: false },
+    { src: 'shared/dashboard/src/components/usage/scripts/constants.ts', dest: 'dashboard/src/components/usage/scripts/constants.ts', template: false },
+    { src: 'shared/dashboard/src/components/usage/scripts/formatters.ts', dest: 'dashboard/src/components/usage/scripts/formatters.ts', template: false },
+    { src: 'shared/dashboard/src/components/usage/scripts/overview-controller.ts', dest: 'dashboard/src/components/usage/scripts/overview-controller.ts', template: false },
+    { src: 'shared/dashboard/src/components/usage/scripts/resource-table-builder.ts', dest: 'dashboard/src/components/usage/scripts/resource-table-builder.ts', template: false },
+    { src: 'shared/dashboard/src/components/usage/scripts/tabs-filters-controller.ts', dest: 'dashboard/src/components/usage/scripts/tabs-filters-controller.ts', template: false },
+    { src: 'shared/dashboard/src/components/usage/state/index.ts', dest: 'dashboard/src/components/usage/state/index.ts', template: false },
+    { src: 'shared/dashboard/src/components/usage/state/usageActions.ts', dest: 'dashboard/src/components/usage/state/usageActions.ts', template: false },
+    { src: 'shared/dashboard/src/components/usage/state/usageStore.ts', dest: 'dashboard/src/components/usage/state/usageStore.ts', template: false },
     // Dashboard — shared tier: UI primitives (v1.6.0)
     { src: 'shared/dashboard/src/components/ui/EmptyState.tsx', dest: 'dashboard/src/components/ui/EmptyState.tsx', template: false },
     { src: 'shared/dashboard/src/components/ui/LoadingSkeleton.tsx', dest: 'dashboard/src/components/ui/LoadingSkeleton.tsx', template: false },
@@ -159,6 +235,8 @@ const SHARED_FILES = [
     { src: 'shared/dashboard/src/pages/api/usage/projects.ts', dest: 'dashboard/src/pages/api/usage/projects.ts', template: false },
     { src: 'shared/dashboard/src/pages/api/usage/allowances.ts', dest: 'dashboard/src/pages/api/usage/allowances.ts', template: false },
     { src: 'shared/dashboard/src/pages/api/usage/anomalies.ts', dest: 'dashboard/src/pages/api/usage/anomalies.ts', template: false },
+    { src: 'shared/dashboard/src/pages/api/usage/ai-models.ts', dest: 'dashboard/src/pages/api/usage/ai-models.ts', template: false },
+    { src: 'shared/dashboard/src/pages/api/usage/billing-context.ts', dest: 'dashboard/src/pages/api/usage/billing-context.ts', template: false },
     // Dashboard — shared tier: costs API routes (v1.6.0)
     { src: 'shared/dashboard/src/pages/api/costs/overview.ts', dest: 'dashboard/src/pages/api/costs/overview.ts', template: false },
     { src: 'shared/dashboard/src/pages/api/costs/providers.ts', dest: 'dashboard/src/pages/api/costs/providers.ts', template: false },
@@ -247,6 +325,8 @@ const SHARED_FILES = [
     { src: 'shared/tests/integration/platform-usage.test.ts', dest: 'tests/integration/platform-usage.test.ts', template: false },
     { src: 'shared/tests/integration/kv-cache.test.ts', dest: 'tests/integration/kv-cache.test.ts', template: false },
     { src: 'shared/tests/e2e/usage-api.test.ts', dest: 'tests/e2e/usage-api.test.ts', template: false },
+    { src: 'shared/tests/e2e/usage-export.test.ts', dest: 'tests/e2e/usage-export.test.ts', template: false },
+    { src: 'shared/tests/e2e/usage-mobile.test.ts', dest: 'tests/e2e/usage-mobile.test.ts', template: false },
     // CI — contract check + security workflows (v2.0.0)
     { src: 'shared/.github/workflows/contract-check.yml.hbs', dest: '.github/workflows/contract-check.yml', template: true },
     { src: 'shared/.github/workflows/security.yml', dest: '.github/workflows/security.yml', template: false },
@@ -284,9 +364,10 @@ const STANDARD_FILES = [
     // SDK test client (telemetry + circuit breaker validation)
     { src: 'standard/wrangler.sdk-test-client.jsonc.hbs', dest: 'wrangler.{{projectSlug}}-sdk-test-client.jsonc', template: true },
     { src: 'standard/workers/platform-sdk-test-client.ts', dest: 'workers/platform-sdk-test-client.ts', template: false },
-    // Dashboard — standard tier (error management, health, DLQ)
+    // Dashboard — standard tier (error management, health, DLQ, analytics)
     { src: 'standard/dashboard/src/pages/health.astro', dest: 'dashboard/src/pages/health.astro', template: false },
     { src: 'standard/dashboard/src/pages/errors.astro', dest: 'dashboard/src/pages/errors.astro', template: false },
+    { src: 'standard/dashboard/src/pages/analytics.astro', dest: 'dashboard/src/pages/analytics.astro', template: false },
     { src: 'standard/dashboard/src/pages/api/errors/index.ts', dest: 'dashboard/src/pages/api/errors/index.ts', template: false },
     { src: 'standard/dashboard/src/pages/api/errors/stats.ts', dest: 'dashboard/src/pages/api/errors/stats.ts', template: false },
     { src: 'standard/dashboard/src/pages/api/health/dlq.ts', dest: 'dashboard/src/pages/api/health/dlq.ts', template: false },
@@ -318,10 +399,21 @@ const STANDARD_FILES = [
     { src: 'standard/tests/unit/error-collector/capture.test.ts', dest: 'tests/unit/error-collector/capture.test.ts', template: false },
     // Dashboard — standard tier: audit history API route (v2.0.0)
     { src: 'standard/dashboard/src/pages/api/health/audit-history.ts', dest: 'dashboard/src/pages/api/health/audit-history.ts', template: false },
+    // Dashboard — standard tier: infrastructure API routes (v2.2.0)
+    { src: 'standard/dashboard/src/pages/api/infrastructure/alerts.ts', dest: 'dashboard/src/pages/api/infrastructure/alerts.ts', template: false },
+    { src: 'standard/dashboard/src/pages/api/infrastructure/healthchecks.ts', dest: 'dashboard/src/pages/api/infrastructure/healthchecks.ts', template: false },
+    { src: 'standard/dashboard/src/pages/api/infrastructure/healthchecks/[id]/flips.ts', dest: 'dashboard/src/pages/api/infrastructure/healthchecks/[id]/flips.ts', template: false },
+    { src: 'standard/dashboard/src/pages/api/infrastructure/uptime.ts', dest: 'dashboard/src/pages/api/infrastructure/uptime.ts', template: false },
+    { src: 'standard/dashboard/src/pages/api/infrastructure/uptime/[id]/response-times.ts', dest: 'dashboard/src/pages/api/infrastructure/uptime/[id]/response-times.ts', template: false },
+    { src: 'standard/dashboard/src/pages/api/test/service-auth.ts', dest: 'dashboard/src/pages/api/test/service-auth.ts', template: false },
     // Dashboard — standard tier: usage components (v2.1.0)
     { src: 'standard/dashboard/src/components/usage/react/UsageTable.tsx', dest: 'dashboard/src/components/usage/react/UsageTable.tsx', template: false },
     { src: 'standard/dashboard/src/components/usage/unified/FeatureBudgets.tsx', dest: 'dashboard/src/components/usage/unified/FeatureBudgets.tsx', template: false },
     { src: 'standard/dashboard/src/components/usage/unified/CircuitBreakerEvents.tsx', dest: 'dashboard/src/components/usage/unified/CircuitBreakerEvents.tsx', template: false },
+    // Dashboard — standard tier: infrastructure components (v2.2.0)
+    { src: 'standard/dashboard/src/components/infrastructure/HealthchecksStatus.tsx', dest: 'dashboard/src/components/infrastructure/HealthchecksStatus.tsx', template: false },
+    { src: 'standard/dashboard/src/components/infrastructure/InfrastructureTabs.tsx', dest: 'dashboard/src/components/infrastructure/InfrastructureTabs.tsx', template: false },
+    { src: 'standard/dashboard/src/components/errors/PriorityBadge.astro', dest: 'dashboard/src/components/errors/PriorityBadge.astro', template: false },
     // Dashboard — standard tier: reports components (v2.1.0)
     { src: 'standard/dashboard/src/components/reports/CircuitBreakerReport.tsx', dest: 'dashboard/src/components/reports/CircuitBreakerReport.tsx', template: false },
     { src: 'standard/dashboard/src/components/reports/ErrorTrendsReport.tsx', dest: 'dashboard/src/components/reports/ErrorTrendsReport.tsx', template: false },
@@ -333,6 +425,9 @@ const STANDARD_FILES = [
     { src: 'standard/tests/unit/error-collector/dedup.test.ts', dest: 'tests/unit/error-collector/dedup.test.ts', template: false },
     { src: 'standard/tests/unit/error-collector/github.test.ts', dest: 'tests/unit/error-collector/github.test.ts', template: false },
     { src: 'standard/tests/integration/platform-sentinel.test.ts', dest: 'tests/integration/platform-sentinel.test.ts', template: false },
+    { src: 'standard/tests/integration/connectors.test.ts', dest: 'tests/integration/connectors.test.ts', template: false },
+    { src: 'standard/tests/integration/github-monitor.test.ts', dest: 'tests/integration/github-monitor.test.ts', template: false },
+    { src: 'standard/tests/integration/ingestion.test.ts', dest: 'tests/integration/ingestion.test.ts', template: false },
 ];
 const FULL_FILES = [
     // Additional migrations
@@ -382,8 +477,15 @@ const FULL_FILES = [
     { src: 'full/scripts/ops/set-kv-pricing.ts', dest: 'scripts/ops/set-kv-pricing.ts', template: false },
     // Universal backfill cascade (v1.8.0)
     { src: 'full/scripts/ops/universal-backfill.ts', dest: 'scripts/ops/universal-backfill.ts', template: false },
-    // Dashboard — full tier (patterns, notifications, search)
+    { src: 'full/scripts/ops/verify-account-total.ts', dest: 'scripts/ops/verify-account-total.ts', template: false },
+    { src: 'full/scripts/ops/audit-cost-anomaly.ts', dest: 'scripts/ops/audit-cost-anomaly.ts', template: false },
+    // Dashboard — full tier (patterns, notifications, search, additional pages)
     { src: 'full/dashboard/src/pages/notifications.astro', dest: 'dashboard/src/pages/notifications.astro', template: false },
+    { src: 'full/dashboard/src/pages/map.astro', dest: 'dashboard/src/pages/map.astro', template: false },
+    { src: 'full/dashboard/src/pages/revenue.astro', dest: 'dashboard/src/pages/revenue.astro', template: false },
+    { src: 'full/dashboard/src/pages/tests.astro', dest: 'dashboard/src/pages/tests.astro', template: false },
+    { src: 'full/dashboard/src/pages/kiosk.astro', dest: 'dashboard/src/pages/kiosk.astro', template: false },
+    { src: 'full/dashboard/src/pages/feedback.astro', dest: 'dashboard/src/pages/feedback.astro', template: false },
     { src: 'full/dashboard/src/pages/api/patterns/index.ts', dest: 'dashboard/src/pages/api/patterns/index.ts', template: false },
     { src: 'full/dashboard/src/pages/api/patterns/approve.ts', dest: 'dashboard/src/pages/api/patterns/approve.ts', template: false },
     { src: 'full/dashboard/src/pages/api/patterns/reject.ts', dest: 'dashboard/src/pages/api/patterns/reject.ts', template: false },
@@ -395,8 +497,12 @@ const FULL_FILES = [
     { src: 'full/dashboard/src/components/patterns/index.ts', dest: 'dashboard/src/components/patterns/index.ts', template: false },
     { src: 'full/dashboard/src/components/notifications/NotificationBell.tsx', dest: 'dashboard/src/components/notifications/NotificationBell.tsx', template: false },
     { src: 'full/dashboard/src/components/notifications/NotificationList.tsx', dest: 'dashboard/src/components/notifications/NotificationList.tsx', template: false },
+    { src: 'full/dashboard/src/components/notifications/NotificationDropdown.tsx', dest: 'dashboard/src/components/notifications/NotificationDropdown.tsx', template: false },
+    { src: 'full/dashboard/src/components/notifications/NotificationItem.tsx', dest: 'dashboard/src/components/notifications/NotificationItem.tsx', template: false },
     { src: 'full/dashboard/src/components/notifications/index.ts', dest: 'dashboard/src/components/notifications/index.ts', template: false },
     { src: 'full/dashboard/src/components/search/SearchModal.tsx', dest: 'dashboard/src/components/search/SearchModal.tsx', template: false },
+    { src: 'full/dashboard/src/components/search/SearchResultGroup.tsx', dest: 'dashboard/src/components/search/SearchResultGroup.tsx', template: false },
+    { src: 'full/dashboard/src/components/search/SearchResultItem.tsx', dest: 'dashboard/src/components/search/SearchResultItem.tsx', template: false },
     // Dashboard — full tier: pattern tabs component (v1.6.0)
     { src: 'full/dashboard/src/components/patterns/PatternTabs.tsx', dest: 'dashboard/src/components/patterns/PatternTabs.tsx', template: false },
     // Dashboard — full tier: additional pattern API routes (v2.0.0)
@@ -417,15 +523,24 @@ const FULL_FILES = [
     // Dashboard — full tier: reports API routes (v2.0.0)
     { src: 'full/dashboard/src/pages/api/reports/audit.ts', dest: 'dashboard/src/pages/api/reports/audit.ts', template: false },
     { src: 'full/dashboard/src/pages/api/reports/usage.ts', dest: 'dashboard/src/pages/api/reports/usage.ts', template: false },
+    { src: 'full/dashboard/src/pages/api/reports/digests.ts', dest: 'dashboard/src/pages/api/reports/digests.ts', template: false },
+    { src: 'full/dashboard/src/pages/api/reports/digests/stats.ts', dest: 'dashboard/src/pages/api/reports/digests/stats.ts', template: false },
     // Dashboard — full tier: topology API route (v2.0.0)
     { src: 'full/dashboard/src/pages/api/topology/index.ts', dest: 'dashboard/src/pages/api/topology/index.ts', template: false },
+    // Dashboard — full tier: test reports + parameterized pattern/search routes (v2.2.0)
+    { src: 'full/dashboard/src/pages/api/test-reports/[id].ts', dest: 'dashboard/src/pages/api/test-reports/[id].ts', template: false },
+    { src: 'full/dashboard/src/pages/api/patterns/[id]/approve.ts', dest: 'dashboard/src/pages/api/patterns/[id]/approve.ts', template: false },
+    { src: 'full/dashboard/src/pages/api/patterns/[id]/reject.ts', dest: 'dashboard/src/pages/api/patterns/[id]/reject.ts', template: false },
+    { src: 'full/dashboard/src/pages/api/search/reindex/[type].ts', dest: 'dashboard/src/pages/api/search/reindex/[type].ts', template: false },
     // Dashboard — full tier: additional pattern components (v2.0.0)
     { src: 'full/dashboard/src/components/patterns/ActivePatterns.tsx', dest: 'dashboard/src/components/patterns/ActivePatterns.tsx', template: false },
     { src: 'full/dashboard/src/components/patterns/SystemPatterns.tsx', dest: 'dashboard/src/components/patterns/SystemPatterns.tsx', template: false },
     // Dashboard — full tier: reports components (v2.0.0)
     { src: 'full/dashboard/src/components/reports/SdkAuditReport.tsx', dest: 'dashboard/src/components/reports/SdkAuditReport.tsx', template: false },
     { src: 'full/dashboard/src/components/reports/GapDetectionReport.tsx', dest: 'dashboard/src/components/reports/GapDetectionReport.tsx', template: false },
+    { src: 'full/dashboard/src/components/reports/FeatureUsageReport.tsx', dest: 'dashboard/src/components/reports/FeatureUsageReport.tsx', template: false },
     { src: 'full/dashboard/src/components/reports/index.ts', dest: 'dashboard/src/components/reports/index.ts', template: false },
+    { src: 'full/dashboard/src/components/patterns/PatternInfoButton.tsx', dest: 'dashboard/src/components/patterns/PatternInfoButton.tsx', template: false },
     // Dashboard — full tier: lib modules (v2.1.0)
     { src: 'full/dashboard/src/lib/cloudflare/graphql.ts', dest: 'dashboard/src/lib/cloudflare/graphql.ts', template: false },
     { src: 'full/dashboard/src/lib/cloudflare/alerting.ts', dest: 'dashboard/src/lib/cloudflare/alerting.ts', template: false },
@@ -447,7 +562,30 @@ const FULL_FILES = [
     // Dashboard — full tier: reports components (v2.1.0)
     { src: 'full/dashboard/src/components/reports/HealthTrendsReport.tsx', dest: 'dashboard/src/components/reports/HealthTrendsReport.tsx', template: false },
     { src: 'full/dashboard/src/components/reports/DigestStats.tsx', dest: 'dashboard/src/components/reports/DigestStats.tsx', template: false },
+    // Tests — full tier (v2.2.0)
+    { src: 'full/tests/integration/r2-archive.test.ts', dest: 'tests/integration/r2-archive.test.ts', template: false },
+    { src: 'full/tests/integration/feedback-schema.test.ts', dest: 'tests/integration/feedback-schema.test.ts', template: false },
 ];
+/**
+ * Detect naming collisions where two template files resolve to the same destination path.
+ * Returns an array of collision descriptions (empty = no collisions).
+ */
+export function detectCollisions(tier) {
+    const files = getFilesForTier(tier);
+    const seen = new Map();
+    const collisions = [];
+    for (const file of files) {
+        const dest = file.dest;
+        const existing = seen.get(dest);
+        if (existing) {
+            collisions.push(`"${existing}" and "${file.src}" both resolve to "${dest}"`);
+        }
+        else {
+            seen.set(dest, file.src);
+        }
+    }
+    return collisions;
+}
 export function getFilesForTier(tier) {
     const files = [...SHARED_FILES];
     if (tier === 'standard' || tier === 'full') {

package/dist/upgrade.d.ts

@@ -20,5 +20,6 @@ export interface UpgradeResult {
     skipped: string[];
     removed: string[];
     migrations: string[];
+    excluded: string[];
 }
 export declare function upgrade(projectDir: string, options?: UpgradeOptions): Promise<UpgradeResult>;