@littlebearapps/platform-admin-sdk 1.0.0

package/README.md

@@ -0,0 +1,112 @@
+# Platform Admin SDK
+
+**`@littlebearapps/platform-admin-sdk`** — Scaffold backend infrastructure for Cloudflare Workers cost protection.
+
+Generates workers, D1 migrations, and config files. Run once, then you own the code.
+
+## Usage
+
+```bash
+npx @littlebearapps/platform-admin-sdk my-platform
+```
+
+The CLI prompts for:
+- **Project name** and slug
+- **GitHub organisation** (for error collection GitHub issues)
+- **Tier** — how much infrastructure to generate
+- **Gatus URL** (optional) — for heartbeat monitoring
+- **Default assignee** — GitHub username for error issues
+
+### CLI Flags (non-interactive)
+
+```bash
+npx @littlebearapps/platform-admin-sdk my-platform --tier full --github-org myorg --skip-prompts
+```
+
+| Flag | Description |
+|------|------------|
+| `--tier <tier>` | Infrastructure tier (`minimal`, `standard`, `full`) |
+| `--github-org <org>` | GitHub organisation for error issues |
+| `--gatus-url <url>` | Gatus status page URL |
+| `--default-assignee <user>` | Default GitHub issue assignee |
+| `--skip-prompts` | Fail if required flags missing (for CI/automation) |
+
+## Tiers
+
+| Tier | Workers | What You Get | Est. Cost |
+|------|---------|-------------|-----------|
+| **Minimal** | 1 | Budget enforcement, circuit breakers, usage telemetry | ~$0/mo |
+| **Standard** | 3 | + Error collector (auto GitHub issues), gap detection sentinel | ~$0/mo |
+| **Full** | 8 | + AI pattern discovery, alert router, notifications, search, settings | ~$5/mo |
+
+## What Gets Generated
+
+### All tiers
+
+```
+my-platform/
++-- platform/config/
+|   +-- services.yaml          # Project registry, feature definitions
+|   +-- budgets.yaml           # Daily limits, circuit breaker thresholds
++-- storage/d1/migrations/     # D1 schema (4 core migrations + seed)
++-- workers/
+|   +-- platform-usage.ts      # Data warehouse worker (cron + queue consumer)
+|   +-- lib/                   # Shared libraries (billing, analytics, budgets)
++-- scripts/
+|   +-- sync-config.ts         # Sync YAML config to D1/KV
++-- wrangler.*.jsonc           # Worker configs with binding placeholders
++-- package.json
++-- tsconfig.json
++-- README.md
+```
+
+### Standard tier adds
+
+- `workers/error-collector.ts` — Tail worker that creates GitHub issues from errors
+- `workers/platform-sentinel.ts` — Gap detection, cost monitoring, alerts
+- `workers/lib/error-collector/` — Fingerprinting, deduplication, digest
+- `workers/lib/sentinel/` — Project gap detection
+- `storage/d1/migrations/005_error_collection.sql`
+
+### Full tier adds
+
+- `workers/pattern-discovery.ts` — AI-assisted transient error pattern discovery
+- `workers/platform-alert-router.ts` — Unified alert normalisation and routing
+- `workers/platform-notifications.ts` — In-app notification API
+- `workers/platform-search.ts` — Full-text search (FTS5)
+- `workers/platform-settings.ts` — Settings management API
+- `workers/lib/pattern-discovery/` — Clustering, AI prompts, validation, shadow eval
+- `storage/d1/migrations/006_pattern_discovery.sql`
+- `storage/d1/migrations/007_notifications_search.sql`
+
+## Post-Scaffold Steps
+
+```bash
+cd my-platform
+npm install
+
+# Create Cloudflare resources
+npx wrangler d1 create my-platform-metrics
+npx wrangler kv namespace create PLATFORM_CACHE
+npx wrangler queues create my-platform-telemetry
+npx wrangler queues create my-platform-telemetry-dlq
+
+# Update resource IDs in wrangler.*.jsonc, then:
+npm run sync:config
+npx wrangler d1 migrations apply my-platform-metrics --remote
+npx wrangler deploy -c wrangler.my-platform-usage.jsonc
+```
+
+## Consumer SDK
+
+The generated workers use `@littlebearapps/platform-consumer-sdk` — the Consumer SDK. Install it in your application workers:
+
+```bash
+npm install @littlebearapps/platform-consumer-sdk
+```
+
+See the [Consumer SDK README](../consumer-sdk/README.md) for integration details.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * @littlebearapps/platform-admin-sdk
+ *
+ * Scaffolds a Cloudflare Workers platform with SDK integration,
+ * circuit breakers, and cost protection.
+ *
+ * Usage:
+ *   npx @littlebearapps/platform-admin-sdk [project-name] [options]
+ *
+ * Examples:
+ *   npx @littlebearapps/platform-admin-sdk my-project
+ *   npx @littlebearapps/platform-admin-sdk my-project --tier full --github-org myorg
+ *   npx @littlebearapps/platform-admin-sdk my-project --tier minimal --skip-prompts
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+/**
+ * @littlebearapps/platform-admin-sdk
+ *
+ * Scaffolds a Cloudflare Workers platform with SDK integration,
+ * circuit breakers, and cost protection.
+ *
+ * Usage:
+ *   npx @littlebearapps/platform-admin-sdk [project-name] [options]
+ *
+ * Examples:
+ *   npx @littlebearapps/platform-admin-sdk my-project
+ *   npx @littlebearapps/platform-admin-sdk my-project --tier full --github-org myorg
+ *   npx @littlebearapps/platform-admin-sdk my-project --tier minimal --skip-prompts
+ */
+import { resolve } from 'node:path';
+import { Command } from 'commander';
+import pc from 'picocolors';
+import { collectOptions, isValidTier } from './prompts.js';
+import { scaffold } from './scaffold.js';
+const BANNER = `
+  ${pc.bold(pc.cyan('Platform Admin SDK'))} — Cloudflare Cost Protection
+  ${pc.dim('Scaffold backend infrastructure: circuit breakers, budget enforcement, error collection')}
+`;
+const program = new Command()
+    .name('platform-admin-sdk')
+    .description('Scaffold a Cloudflare Workers platform with SDK integration')
+    .version('1.0.0')
+    .argument('[project-name]', 'Name of the project to create')
+    .option('--tier <tier>', 'Infrastructure tier (minimal, standard, full)')
+    .option('--github-org <org>', 'GitHub organisation for error issue creation')
+    .option('--gatus-url <url>', 'Gatus status page URL for heartbeat monitoring')
+    .option('--default-assignee <user>', 'Default GitHub assignee for error issues')
+    .option('--skip-prompts', 'Non-interactive mode — fail if required flags are missing');
+async function main() {
+    console.log(BANNER);
+    program.parse();
+    const opts = program.opts();
+    const [projectNameArg] = program.args;
+    // Validate tier if provided
+    if (opts.tier && !isValidTier(opts.tier)) {
+        console.error(pc.red(`  Error: Invalid tier "${opts.tier}". Must be one of: minimal, standard, full`));
+        process.exit(1);
+    }
+    const options = await collectOptions({
+        projectName: projectNameArg,
+        tier: opts.tier,
+        githubOrg: opts.githubOrg,
+        gatusUrl: opts.gatusUrl,
+        defaultAssignee: opts.defaultAssignee,
+        skipPrompts: opts.skipPrompts,
+    });
+    const outputDir = resolve(process.cwd(), options.projectName);
+    console.log();
+    console.log(`  ${pc.bold('Project')}: ${options.projectName}`);
+    console.log(`  ${pc.bold('Tier')}: ${options.tier}`);
+    console.log(`  ${pc.bold('Output')}: ${outputDir}`);
+    console.log();
+    await scaffold(options, outputDir);
+    console.log();
+    console.log(pc.green(pc.bold('  Done!')));
+    console.log();
+    console.log(`  ${pc.bold('Next steps:')}`);
+    console.log();
+    console.log(`  ${pc.cyan('cd')} ${options.projectName}`);
+    console.log(`  ${pc.cyan('npm install')}`);
+    console.log();
+    console.log(`  ${pc.dim('# Create Cloudflare resources:')}`);
+    console.log(`  ${pc.cyan('npx wrangler d1 create')} ${options.projectSlug}-metrics`);
+    console.log(`  ${pc.cyan('npx wrangler kv namespace create')} PLATFORM_CACHE`);
+    if (options.tier !== 'minimal') {
+        console.log(`  ${pc.cyan('npx wrangler kv namespace create')} PLATFORM_ALERTS`);
+    }
+    console.log(`  ${pc.cyan('npx wrangler queues create')} ${options.projectSlug}-telemetry`);
+    console.log(`  ${pc.cyan('npx wrangler queues create')} ${options.projectSlug}-telemetry-dlq`);
+    console.log();
+    console.log(`  ${pc.dim('# Update resource IDs in wrangler.*.jsonc, then:')}`);
+    console.log(`  ${pc.cyan('npm run sync:config')}`);
+    console.log(`  ${pc.cyan('npx wrangler d1 migrations apply')} ${options.projectSlug}-metrics --remote`);
+    console.log(`  ${pc.cyan('npx wrangler deploy')} -c wrangler.${options.projectSlug}-usage.jsonc`);
+    console.log();
+    console.log(`  ${pc.dim('# In your consumer projects:')}`);
+    console.log(`  ${pc.cyan('npm install @littlebearapps/platform-consumer-sdk')}`);
+    console.log();
+}
+main().catch((error) => {
+    console.error(pc.red('Error:'), error instanceof Error ? error.message : String(error));
+    process.exit(1);
+});

package/dist/prompts.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Interactive CLI prompts for project scaffolding configuration.
+ *
+ * When flags are provided via CLI, those values are used without prompting.
+ * Falls back to interactive prompts for missing values, or sensible defaults
+ * when running non-interactively.
+ */
+export type Tier = 'minimal' | 'standard' | 'full';
+export interface ScaffoldOptions {
+    projectName: string;
+    projectSlug: string;
+    githubOrg: string;
+    tier: Tier;
+    gatusUrl: string;
+    defaultAssignee: string;
+}
+/** Pre-filled values from CLI flags. */
+export interface CLIFlags {
+    projectName?: string;
+    tier?: Tier;
+    githubOrg?: string;
+    gatusUrl?: string;
+    defaultAssignee?: string;
+    skipPrompts?: boolean;
+}
+export declare function isValidTier(value: string): value is Tier;
+export declare function collectOptions(flags?: CLIFlags): Promise<ScaffoldOptions>;

package/dist/prompts.js

@@ -0,0 +1,80 @@
+/**
+ * Interactive CLI prompts for project scaffolding configuration.
+ *
+ * When flags are provided via CLI, those values are used without prompting.
+ * Falls back to interactive prompts for missing values, or sensible defaults
+ * when running non-interactively.
+ */
+import * as readline from 'node:readline';
+const VALID_TIERS = ['minimal', 'standard', 'full'];
+export function isValidTier(value) {
+    return VALID_TIERS.includes(value);
+}
+function slugify(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+async function prompt(question, defaultValue) {
+    // Non-interactive: use defaults
+    if (!process.stdin.isTTY) {
+        return defaultValue;
+    }
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        const display = defaultValue ? `${question} (${defaultValue}): ` : `${question}: `;
+        rl.question(`  ${display}`, (answer) => {
+            rl.close();
+            resolve(answer.trim() || defaultValue);
+        });
+    });
+}
+async function promptSelect(question, options, defaultIndex = 0) {
+    if (!process.stdin.isTTY) {
+        return options[defaultIndex];
+    }
+    console.log(`  ${question}`);
+    options.forEach((opt, i) => {
+        const marker = i === defaultIndex ? '>' : ' ';
+        console.log(`    ${marker} ${i + 1}. ${opt}`);
+    });
+    const answer = await prompt('Choose', String(defaultIndex + 1));
+    const idx = parseInt(answer, 10) - 1;
+    return options[idx] ?? options[defaultIndex];
+}
+export async function collectOptions(flags = {}) {
+    if (flags.skipPrompts) {
+        if (!flags.projectName) {
+            throw new Error('--skip-prompts requires a project name argument');
+        }
+        if (!flags.tier) {
+            throw new Error('--skip-prompts requires --tier');
+        }
+        return {
+            projectName: flags.projectName,
+            projectSlug: slugify(flags.projectName),
+            githubOrg: flags.githubOrg ?? '',
+            tier: flags.tier,
+            gatusUrl: flags.gatusUrl ?? '',
+            defaultAssignee: flags.defaultAssignee ?? '',
+        };
+    }
+    const projectName = flags.projectName || await prompt('Project name', 'my-platform');
+    const projectSlug = await prompt('Project slug (for resource names)', slugify(projectName));
+    const tier = flags.tier || await promptSelect('Setup tier:', VALID_TIERS, 1);
+    const githubOrg = flags.githubOrg ?? await prompt('GitHub org (for error issue creation)', '');
+    const gatusUrl = flags.gatusUrl ?? await prompt('Gatus status page URL (optional)', '');
+    const defaultAssignee = flags.defaultAssignee ?? await prompt('Default GitHub assignee (optional)', '');
+    return {
+        projectName,
+        projectSlug,
+        githubOrg,
+        tier,
+        gatusUrl,
+        defaultAssignee,
+    };
+}

package/dist/scaffold.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Scaffolding orchestrator — copies and renders templates into the output directory.
+ */
+import type { ScaffoldOptions } from './prompts.js';
+export declare function scaffold(options: ScaffoldOptions, outputDir: string): Promise<void>;

package/dist/scaffold.js

@@ -0,0 +1,65 @@
+/**
+ * Scaffolding orchestrator — copies and renders templates into the output directory.
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { resolve, dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import Handlebars from 'handlebars';
+import pc from 'picocolors';
+import { getFilesForTier } from './templates.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+function getTemplatesDir() {
+    // In development: ../templates/
+    // In published package: ../templates/ (relative to dist/)
+    const devPath = resolve(__dirname, '..', 'templates');
+    if (existsSync(devPath))
+        return devPath;
+    return resolve(__dirname, '..', '..', 'templates');
+}
+function renderString(template, context) {
+    // Simple {{var}} replacement for file paths (not Handlebars — just string replace)
+    let result = template;
+    for (const [key, value] of Object.entries(context)) {
+        result = result.replace(new RegExp(`\\{\\{${key}\\}\\}`, 'g'), value);
+    }
+    return result;
+}
+export async function scaffold(options, outputDir) {
+    if (existsSync(outputDir)) {
+        throw new Error(`Directory already exists: ${outputDir}`);
+    }
+    const templatesDir = getTemplatesDir();
+    const files = getFilesForTier(options.tier);
+    const context = {
+        projectName: options.projectName,
+        projectSlug: options.projectSlug,
+        githubOrg: options.githubOrg,
+        tier: options.tier,
+        gatusUrl: options.gatusUrl,
+        defaultAssignee: options.defaultAssignee,
+        sdkVersion: '0.2.0',
+    };
+    mkdirSync(outputDir, { recursive: true });
+    for (const file of files) {
+        const srcPath = join(templatesDir, file.src);
+        const destPath = join(outputDir, renderString(file.dest, context));
+        // Ensure destination directory exists
+        mkdirSync(dirname(destPath), { recursive: true });
+        if (!existsSync(srcPath)) {
+            console.log(`  ${pc.yellow('skip')} ${file.src} ${pc.dim('(template not found)')}`);
+            continue;
+        }
+        const raw = readFileSync(srcPath, 'utf-8');
+        if (file.template) {
+            const compiled = Handlebars.compile(raw, { noEscape: true });
+            const rendered = compiled(context);
+            writeFileSync(destPath, rendered);
+        }
+        else {
+            writeFileSync(destPath, raw);
+        }
+        const relDest = destPath.replace(outputDir + '/', '');
+        console.log(`  ${pc.green('create')} ${relDest}`);
+    }
+}

package/dist/templates.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Template manifest — maps tiers to files that should be scaffolded.
+ *
+ * Files ending in .hbs are rendered through Handlebars.
+ * All other files are copied verbatim.
+ */
+import type { Tier } from './prompts.js';
+export interface TemplateFile {
+    /** Path relative to the templates/ directory */
+    src: string;
+    /** Path relative to the output directory */
+    dest: string;
+    /** Whether this file uses Handlebars templating */
+    template: boolean;
+}
+export declare function getFilesForTier(tier: Tier): TemplateFile[];

package/dist/templates.js

@@ -0,0 +1,131 @@
+/**
+ * Template manifest — maps tiers to files that should be scaffolded.
+ *
+ * Files ending in .hbs are rendered through Handlebars.
+ * All other files are copied verbatim.
+ */
+const SHARED_FILES = [
+    // Config
+    { src: 'shared/config/services.yaml.hbs', dest: 'platform/config/services.yaml', template: true },
+    { src: 'shared/config/budgets.yaml.hbs', dest: 'platform/config/budgets.yaml', template: true },
+    // Scripts
+    { src: 'shared/scripts/sync-config.ts', dest: 'scripts/sync-config.ts', template: false },
+    // Migrations (minimal tier)
+    { src: 'shared/migrations/001_core_tables.sql', dest: 'storage/d1/migrations/001_core_tables.sql', template: false },
+    { src: 'shared/migrations/002_usage_warehouse.sql', dest: 'storage/d1/migrations/002_usage_warehouse.sql', template: false },
+    { src: 'shared/migrations/003_feature_tracking.sql', dest: 'storage/d1/migrations/003_feature_tracking.sql', template: false },
+    { src: 'shared/migrations/004_settings_alerts.sql', dest: 'storage/d1/migrations/004_settings_alerts.sql', template: false },
+    { src: 'shared/migrations/seed.sql.hbs', dest: 'storage/d1/migrations/seed.sql', template: true },
+    // Wrangler config (minimal)
+    { src: 'shared/wrangler.usage.jsonc.hbs', dest: 'wrangler.{{projectSlug}}-usage.jsonc', template: true },
+    // Project files
+    { src: 'shared/package.json.hbs', dest: 'package.json', template: true },
+    { src: 'shared/tsconfig.json', dest: 'tsconfig.json', template: false },
+    { src: 'shared/README.md.hbs', dest: 'README.md', template: true },
+    // Workers — platform-usage (data warehouse, cron + queue consumer)
+    { src: 'shared/workers/platform-usage.ts', dest: 'workers/platform-usage.ts', template: false },
+    // Workers — root lib (shared utilities)
+    { src: 'shared/workers/lib/billing.ts', dest: 'workers/lib/billing.ts', template: false },
+    { src: 'shared/workers/lib/economics.ts', dest: 'workers/lib/economics.ts', template: false },
+    { src: 'shared/workers/lib/analytics-engine.ts', dest: 'workers/lib/analytics-engine.ts', template: false },
+    { src: 'shared/workers/lib/platform-settings.ts', dest: 'workers/lib/platform-settings.ts', template: false },
+    { src: 'shared/workers/lib/circuit-breaker-middleware.ts', dest: 'workers/lib/circuit-breaker-middleware.ts', template: false },
+    { src: 'shared/workers/lib/metrics.ts', dest: 'workers/lib/metrics.ts', template: false },
+    { src: 'shared/workers/lib/telemetry-sampling.ts', dest: 'workers/lib/telemetry-sampling.ts', template: false },
+    { src: 'shared/workers/lib/control.ts', dest: 'workers/lib/control.ts', template: false },
+    // Workers — lib/shared (cross-boundary types and utilities)
+    { src: 'shared/workers/lib/shared/types.ts', dest: 'workers/lib/shared/types.ts', template: false },
+    { src: 'shared/workers/lib/shared/allowances.ts', dest: 'workers/lib/shared/allowances.ts', template: false },
+    { src: 'shared/workers/lib/shared/cloudflare.ts', dest: 'workers/lib/shared/cloudflare.ts', template: false },
+    // Workers — lib/usage/shared
+    { src: 'shared/workers/lib/usage/shared/types.ts', dest: 'workers/lib/usage/shared/types.ts', template: false },
+    { src: 'shared/workers/lib/usage/shared/constants.ts', dest: 'workers/lib/usage/shared/constants.ts', template: false },
+    { src: 'shared/workers/lib/usage/shared/utils.ts', dest: 'workers/lib/usage/shared/utils.ts', template: false },
+    { src: 'shared/workers/lib/usage/shared/index.ts', dest: 'workers/lib/usage/shared/index.ts', template: false },
+    // Workers — lib/usage/handlers
+    { src: 'shared/workers/lib/usage/handlers/index.ts', dest: 'workers/lib/usage/handlers/index.ts', template: false },
+    { src: 'shared/workers/lib/usage/handlers/data-queries.ts', dest: 'workers/lib/usage/handlers/data-queries.ts', template: false },
+    { src: 'shared/workers/lib/usage/handlers/usage-metrics.ts', dest: 'workers/lib/usage/handlers/usage-metrics.ts', template: false },
+    { src: 'shared/workers/lib/usage/handlers/usage-features.ts', dest: 'workers/lib/usage/handlers/usage-features.ts', template: false },
+    { src: 'shared/workers/lib/usage/handlers/usage-settings.ts', dest: 'workers/lib/usage/handlers/usage-settings.ts', template: false },
+    { src: 'shared/workers/lib/usage/handlers/usage-admin.ts', dest: 'workers/lib/usage/handlers/usage-admin.ts', template: false },
+    { src: 'shared/workers/lib/usage/handlers/dlq-admin.ts', dest: 'workers/lib/usage/handlers/dlq-admin.ts', template: false },
+    { src: 'shared/workers/lib/usage/handlers/health-trends.ts', dest: 'workers/lib/usage/handlers/health-trends.ts', template: false },
+    { src: 'shared/workers/lib/usage/handlers/backfill.ts', dest: 'workers/lib/usage/handlers/backfill.ts', template: false },
+    { src: 'shared/workers/lib/usage/handlers/audit.ts', dest: 'workers/lib/usage/handlers/audit.ts', template: false },
+    { src: 'shared/workers/lib/usage/handlers/behavioral.ts', dest: 'workers/lib/usage/handlers/behavioral.ts', template: false },
+    // Workers — lib/usage/queue
+    { src: 'shared/workers/lib/usage/queue/index.ts', dest: 'workers/lib/usage/queue/index.ts', template: false },
+    { src: 'shared/workers/lib/usage/queue/telemetry-processor.ts', dest: 'workers/lib/usage/queue/telemetry-processor.ts', template: false },
+    { src: 'shared/workers/lib/usage/queue/dlq-handler.ts', dest: 'workers/lib/usage/queue/dlq-handler.ts', template: false },
+    { src: 'shared/workers/lib/usage/queue/budget-enforcement.ts', dest: 'workers/lib/usage/queue/budget-enforcement.ts', template: false },
+    { src: 'shared/workers/lib/usage/queue/cost-calculator.ts', dest: 'workers/lib/usage/queue/cost-calculator.ts', template: false },
+    { src: 'shared/workers/lib/usage/queue/cost-budget-enforcement.ts', dest: 'workers/lib/usage/queue/cost-budget-enforcement.ts', template: false },
+    // Workers — lib/usage/scheduled
+    { src: 'shared/workers/lib/usage/scheduled/index.ts', dest: 'workers/lib/usage/scheduled/index.ts', template: false },
+    { src: 'shared/workers/lib/usage/scheduled/data-collection.ts', dest: 'workers/lib/usage/scheduled/data-collection.ts', template: false },
+    { src: 'shared/workers/lib/usage/scheduled/anomaly-detection.ts', dest: 'workers/lib/usage/scheduled/anomaly-detection.ts', template: false },
+    { src: 'shared/workers/lib/usage/scheduled/rollups.ts', dest: 'workers/lib/usage/scheduled/rollups.ts', template: false },
+    { src: 'shared/workers/lib/usage/scheduled/error-digest.ts', dest: 'workers/lib/usage/scheduled/error-digest.ts', template: false },
+    // Workers — lib/usage/collectors (pluggable interface + example)
+    { src: 'shared/workers/lib/usage/collectors/index.ts', dest: 'workers/lib/usage/collectors/index.ts', template: false },
+    { src: 'shared/workers/lib/usage/collectors/example.ts', dest: 'workers/lib/usage/collectors/example.ts', template: false },
+];
+const STANDARD_FILES = [
+    // Additional migrations
+    { src: 'standard/migrations/005_error_collection.sql', dest: 'storage/d1/migrations/005_error_collection.sql', template: false },
+    // Wrangler configs
+    { src: 'standard/wrangler.error-collector.jsonc.hbs', dest: 'wrangler.{{projectSlug}}-error-collector.jsonc', template: true },
+    { src: 'standard/wrangler.sentinel.jsonc.hbs', dest: 'wrangler.{{projectSlug}}-sentinel.jsonc', template: true },
+    // Workers — error-collector (tail worker → GitHub issues)
+    { src: 'standard/workers/error-collector.ts', dest: 'workers/error-collector.ts', template: false },
+    { src: 'standard/workers/lib/error-collector/capture.ts', dest: 'workers/lib/error-collector/capture.ts', template: false },
+    { src: 'standard/workers/lib/error-collector/fingerprint.ts', dest: 'workers/lib/error-collector/fingerprint.ts', template: false },
+    { src: 'standard/workers/lib/error-collector/types.ts', dest: 'workers/lib/error-collector/types.ts', template: false },
+    { src: 'standard/workers/lib/error-collector/github.ts', dest: 'workers/lib/error-collector/github.ts', template: false },
+    { src: 'standard/workers/lib/error-collector/digest.ts', dest: 'workers/lib/error-collector/digest.ts', template: false },
+    { src: 'standard/workers/lib/error-collector/gap-alerts.ts', dest: 'workers/lib/error-collector/gap-alerts.ts', template: false },
+    { src: 'standard/workers/lib/error-collector/email-health-alerts.ts', dest: 'workers/lib/error-collector/email-health-alerts.ts', template: false },
+    // Workers — platform-sentinel (gap detection, cost monitoring)
+    { src: 'standard/workers/platform-sentinel.ts', dest: 'workers/platform-sentinel.ts', template: false },
+    { src: 'standard/workers/lib/sentinel/gap-detection.ts', dest: 'workers/lib/sentinel/gap-detection.ts', template: false },
+    // Workers — shared lib (used by standard-tier workers)
+    { src: 'standard/workers/lib/shared/slack-alerts.ts', dest: 'workers/lib/shared/slack-alerts.ts', template: false },
+];
+const FULL_FILES = [
+    // Additional migrations
+    { src: 'full/migrations/006_pattern_discovery.sql', dest: 'storage/d1/migrations/006_pattern_discovery.sql', template: false },
+    { src: 'full/migrations/007_notifications_search.sql', dest: 'storage/d1/migrations/007_notifications_search.sql', template: false },
+    // Wrangler configs
+    { src: 'full/wrangler.pattern-discovery.jsonc.hbs', dest: 'wrangler.{{projectSlug}}-pattern-discovery.jsonc', template: true },
+    { src: 'full/wrangler.alert-router.jsonc.hbs', dest: 'wrangler.{{projectSlug}}-alert-router.jsonc', template: true },
+    { src: 'full/wrangler.notifications.jsonc.hbs', dest: 'wrangler.{{projectSlug}}-notifications.jsonc', template: true },
+    { src: 'full/wrangler.search.jsonc.hbs', dest: 'wrangler.{{projectSlug}}-search.jsonc', template: true },
+    { src: 'full/wrangler.settings.jsonc.hbs', dest: 'wrangler.{{projectSlug}}-settings.jsonc', template: true },
+    // Workers — pattern-discovery (AI-assisted transient error patterns)
+    { src: 'full/workers/pattern-discovery.ts', dest: 'workers/pattern-discovery.ts', template: false },
+    { src: 'full/workers/lib/pattern-discovery/types.ts', dest: 'workers/lib/pattern-discovery/types.ts', template: false },
+    { src: 'full/workers/lib/pattern-discovery/clustering.ts', dest: 'workers/lib/pattern-discovery/clustering.ts', template: false },
+    { src: 'full/workers/lib/pattern-discovery/ai-prompt.ts', dest: 'workers/lib/pattern-discovery/ai-prompt.ts', template: false },
+    { src: 'full/workers/lib/pattern-discovery/storage.ts', dest: 'workers/lib/pattern-discovery/storage.ts', template: false },
+    { src: 'full/workers/lib/pattern-discovery/validation.ts', dest: 'workers/lib/pattern-discovery/validation.ts', template: false },
+    { src: 'full/workers/lib/pattern-discovery/shadow-evaluation.ts', dest: 'workers/lib/pattern-discovery/shadow-evaluation.ts', template: false },
+    // Workers — platform-alert-router (unified alert normalisation)
+    { src: 'full/workers/platform-alert-router.ts', dest: 'workers/platform-alert-router.ts', template: false },
+    // Workers — platform-notifications (in-app notification API)
+    { src: 'full/workers/platform-notifications.ts', dest: 'workers/platform-notifications.ts', template: false },
+    // Workers — platform-search (full-text search FTS5)
+    { src: 'full/workers/platform-search.ts', dest: 'workers/platform-search.ts', template: false },
+    // Workers — platform-settings (settings management API)
+    { src: 'full/workers/platform-settings.ts', dest: 'workers/platform-settings.ts', template: false },
+];
+export function getFilesForTier(tier) {
+    const files = [...SHARED_FILES];
+    if (tier === 'standard' || tier === 'full') {
+        files.push(...STANDARD_FILES);
+    }
+    if (tier === 'full') {
+        files.push(...FULL_FILES);
+    }
+    return files;
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@littlebearapps/platform-admin-sdk",
+  "version": "1.0.0",
+  "description": "Platform Admin SDK — scaffold backend infrastructure with workers, circuit breakers, and cost protection for Cloudflare",
+  "type": "module",
+  "bin": {
+    "platform-admin-sdk": "./dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "templates/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "commander": "^14.0.3",
+    "handlebars": "^4.7.8",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.5"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/littlebearapps/platform-sdks.git",
+    "directory": "packages/admin-sdk"
+  },
+  "keywords": [
+    "cloudflare-workers",
+    "platform-admin-sdk",
+    "scaffold",
+    "cost-protection",
+    "circuit-breaker"
+  ],
+  "author": "Little Bear Apps",
+  "license": "MIT"
+}