@littlebearapps/create-platform 1.0.0

package/templates/full/wrangler.alert-router.jsonc.hbs

@@ -0,0 +1,34 @@
+{
+  "$schema": "./node_modules/wrangler/config-schema.json",
+  "name": "{{projectSlug}}-alert-router",
+  "main": "workers/platform-alert-router.ts",
+  "compatibility_date": "2026-01-01",
+  "compatibility_flags": ["nodejs_compat_v2"],
+  "observability": { "enabled": true },
+
+  "d1_databases": [
+    {
+      "binding": "PLATFORM_DB",
+      "database_name": "{{projectSlug}}-metrics",
+      "database_id": "YOUR_D1_DATABASE_ID"
+    }
+  ],
+
+  "kv_namespaces": [
+    {
+      "binding": "PLATFORM_CACHE",
+      "id": "YOUR_KV_NAMESPACE_ID"
+    },
+    {
+      "binding": "PLATFORM_ALERTS",
+      "id": "YOUR_KV_ALERTS_NAMESPACE_ID"
+    }
+  ],
+
+  "vars": {
+    "CLOUDFLARE_ACCOUNT_ID": "YOUR_CLOUDFLARE_ACCOUNT_ID"
+  }
+
+  // Secrets needed:
+  //   SLACK_WEBHOOK_URL
+}

package/templates/full/wrangler.notifications.jsonc.hbs

@@ -0,0 +1,23 @@
+{
+  "$schema": "./node_modules/wrangler/config-schema.json",
+  "name": "{{projectSlug}}-notifications",
+  "main": "workers/platform-notifications.ts",
+  "compatibility_date": "2026-01-01",
+  "compatibility_flags": ["nodejs_compat_v2"],
+  "observability": { "enabled": true },
+
+  "d1_databases": [
+    {
+      "binding": "PLATFORM_DB",
+      "database_name": "{{projectSlug}}-metrics",
+      "database_id": "YOUR_D1_DATABASE_ID"
+    }
+  ],
+
+  "kv_namespaces": [
+    {
+      "binding": "PLATFORM_CACHE",
+      "id": "YOUR_KV_NAMESPACE_ID"
+    }
+  ]
+}

package/templates/full/wrangler.pattern-discovery.jsonc.hbs

@@ -0,0 +1,33 @@
+{
+  "$schema": "./node_modules/wrangler/config-schema.json",
+  "name": "{{projectSlug}}-pattern-discovery",
+  "main": "workers/pattern-discovery.ts",
+  "compatibility_date": "2026-01-01",
+  "compatibility_flags": ["nodejs_compat_v2"],
+  "observability": { "enabled": true },
+
+  "triggers": {
+    "crons": ["0 2 * * *", "0 3 * * *"]
+  },
+
+  "d1_databases": [
+    {
+      "binding": "PLATFORM_DB",
+      "database_name": "{{projectSlug}}-metrics",
+      "database_id": "YOUR_D1_DATABASE_ID"
+    }
+  ],
+
+  "kv_namespaces": [
+    {
+      "binding": "PLATFORM_CACHE",
+      "id": "YOUR_KV_NAMESPACE_ID"
+    }
+  ],
+
+  "ai": { "binding": "AI" },
+
+  "vars": {
+    "GATUS_HEARTBEAT_URL": "{{gatusUrl}}"
+  }
+}

package/templates/full/wrangler.search.jsonc.hbs

@@ -0,0 +1,16 @@
+{
+  "$schema": "./node_modules/wrangler/config-schema.json",
+  "name": "{{projectSlug}}-search",
+  "main": "workers/platform-search.ts",
+  "compatibility_date": "2026-01-01",
+  "compatibility_flags": ["nodejs_compat_v2"],
+  "observability": { "enabled": true },
+
+  "d1_databases": [
+    {
+      "binding": "PLATFORM_DB",
+      "database_name": "{{projectSlug}}-metrics",
+      "database_id": "YOUR_D1_DATABASE_ID"
+    }
+  ]
+}

package/templates/full/wrangler.settings.jsonc.hbs

@@ -0,0 +1,23 @@
+{
+  "$schema": "./node_modules/wrangler/config-schema.json",
+  "name": "{{projectSlug}}-settings",
+  "main": "workers/platform-settings.ts",
+  "compatibility_date": "2026-01-01",
+  "compatibility_flags": ["nodejs_compat_v2"],
+  "observability": { "enabled": true },
+
+  "d1_databases": [
+    {
+      "binding": "PLATFORM_DB",
+      "database_name": "{{projectSlug}}-metrics",
+      "database_id": "YOUR_D1_DATABASE_ID"
+    }
+  ],
+
+  "kv_namespaces": [
+    {
+      "binding": "PLATFORM_CACHE",
+      "id": "YOUR_KV_NAMESPACE_ID"
+    }
+  ]
+}

package/templates/shared/README.md.hbs

@@ -0,0 +1,69 @@
+# {{projectName}} Platform
+
+Cost protection and monitoring infrastructure powered by [Platform SDK](https://github.com/littlebearapps/platform-sdk).
+
+## Setup
+
+**Tier**: {{tier}}
+
+### 1. Create Cloudflare Resources
+
+```bash
+npx wrangler d1 create {{projectSlug}}-metrics
+npx wrangler kv namespace create PLATFORM_CACHE
+npx wrangler queues create {{projectSlug}}-telemetry
+npx wrangler queues create {{projectSlug}}-telemetry-dlq
+```
+
+### 2. Update Wrangler Configs
+
+Replace `YOUR_*_ID` placeholders in `wrangler.*.jsonc` with the IDs from step 1.
+
+### 3. Run Migrations
+
+```bash
+npx wrangler d1 migrations apply {{projectSlug}}-metrics --remote
+```
+
+### 4. Sync Config
+
+```bash
+npm run sync:config
+```
+
+### 5. Deploy
+
+```bash
+npx wrangler deploy -c wrangler.{{projectSlug}}-usage.jsonc
+```
+
+### 6. Install SDK in Consumer Projects
+
+```bash
+npm install @littlebearapps/platform-sdk
+```
+
+## Architecture
+
+```
+Consumer Projects
+    |
+    | SDK telemetry (via queue)
+    v
+{{projectSlug}}-usage (cron + queue consumer)
+    |
+    v
+D1 Warehouse + KV Cache + Analytics Engine
+```
+
+## Configuration
+
+- `platform/config/services.yaml` — Project and feature registry
+- `platform/config/budgets.yaml` — Limits, thresholds, circuit breakers
+
+After editing config, run `npm run sync:config` to sync to D1/KV.
+
+## Resources
+
+- [Platform SDK Documentation](https://github.com/littlebearapps/platform-sdk)
+- [Cloudflare Workers Pricing](https://developers.cloudflare.com/workers/platform/pricing/)

package/templates/shared/config/budgets.yaml.hbs

@@ -0,0 +1,72 @@
+# Budget Configuration — Limits, Thresholds, Circuit Breakers
+# Sync to D1/KV: npm run sync:config
+
+# Cloudflare Workers Paid Plan limits (as of Jan 2026)
+account_limits:
+  workers:
+    requests: 10_000_000    # 10M requests/month included
+    cpu_ms: 30_000          # 30s CPU time per invocation
+  d1:
+    reads: 25_000_000_000   # 25B reads/month
+    writes: 50_000_000      # 50M writes/month
+    storage_gb: 5           # 5GB included
+  kv:
+    reads: 10_000_000       # 10M reads/month
+    writes: 1_000_000       # 1M writes/month
+    storage_gb: 1           # 1GB included
+  queues:
+    messages: 1_000_000     # 1M messages/month
+  r2:
+    class_a: 1_000_000      # 1M Class A ops/month
+    class_b: 10_000_000     # 10M Class B ops/month
+    storage_gb: 10          # 10GB included
+
+# Default limits (applied when no feature-specific override exists)
+defaults:
+  global_limits:
+    d1_write_limit: 100_000  # Daily D1 write limit per feature
+  daily:
+    d1_reads: 1_000_000
+    d1_writes: 100_000
+    kv_reads: 100_000
+    kv_writes: 10_000
+    worker_requests: 500_000
+    queue_messages: 50_000
+  circuit_breaker:
+    auto_reset_seconds: 3600   # 1 hour
+    cooldown_seconds: 300      # 5 minutes
+  error_budget:
+    error_rate_threshold: 5    # 5% error rate triggers warning
+    window_minutes: 60
+  thresholds:
+    warning: 70    # 70% of budget
+    critical: 90   # 90% of budget
+
+# Cost tiers for feature categorisation
+cost_tiers:
+  low:
+    d1_writes: 10_000
+    kv_writes: 1_000
+  medium:
+    d1_writes: 50_000
+    kv_writes: 5_000
+  high:
+    d1_writes: 200_000
+    kv_writes: 20_000
+  critical:
+    d1_writes: 500_000
+    kv_writes: 50_000
+
+# Per-project budgets
+project_budgets:
+  {{projectSlug}}:
+    daily:
+      d1_writes: 500_000
+      kv_writes: 50_000
+      worker_requests: 1_000_000
+
+# Feature-specific overrides (feature_id: limits)
+feature_overrides:
+  "{{projectSlug}}:cron:hourly":
+    d1_writes: 200_000
+    d1_reads: 500_000

package/templates/shared/config/services.yaml.hbs

@@ -0,0 +1,45 @@
+# Service Registry — Source of Truth
+# Sync to D1/KV: npm run sync:config
+
+metadata:
+  version: "1.0.0"
+  autoDiscovery: true
+  kvNamespace: PLATFORM_CACHE
+  d1Database: {{projectSlug}}-metrics
+
+projects:
+  {{projectSlug}}:
+    display_name: "{{projectName}}"
+    status: active
+    tier: paid
+    repository: "{{githubOrg}}/{{projectSlug}}"
+    infrastructure:
+      workers:
+        - id: {{projectSlug}}-usage
+          name: "Usage Collector"
+          script_name: {{projectSlug}}-usage
+          status: active
+          schedule: "0 * * * *"
+      storage:
+        d1:
+          - database_name: {{projectSlug}}-metrics
+            binding: PLATFORM_DB
+    features:
+      api:
+        main-api:
+          display_name: "Main API"
+          feature_id: "{{projectSlug}}:api:main"
+          circuit_breaker: true
+          cost_tier: medium
+      cron:
+        hourly-collection:
+          display_name: "Hourly Collection"
+          feature_id: "{{projectSlug}}:cron:hourly"
+          circuit_breaker: true
+          cost_tier: low
+      queue:
+        telemetry-processing:
+          display_name: "Telemetry Processing"
+          feature_id: "{{projectSlug}}:queue:telemetry"
+          circuit_breaker: true
+          cost_tier: low

package/templates/shared/migrations/001_core_tables.sql

@@ -0,0 +1,117 @@
+-- =============================================================================
+-- 001_core_tables.sql — Core platform tables
+-- =============================================================================
+-- Consolidated from original migrations: 001, 002, 007, 009, 016
+--
+-- Tables:
+--   alerts             — Platform alerts with severity and resolution tracking
+--   project_registry   — Logical project definitions for resource grouping
+--   resource_project_mapping — Maps CF resources to owning projects
+--   resource_types      — Valid resource types and their CF API endpoints
+-- =============================================================================
+
+
+-- =============================================================================
+-- ALERTS
+-- =============================================================================
+-- Platform-wide alert tracking with severity tiers and resolution status.
+
+CREATE TABLE IF NOT EXISTS alerts (
+  id TEXT PRIMARY KEY,
+  category TEXT NOT NULL,
+  severity TEXT NOT NULL,
+  title TEXT NOT NULL,
+  description TEXT NOT NULL,
+  source TEXT NOT NULL,
+  timestamp INTEGER NOT NULL,
+  resolved INTEGER DEFAULT 0,
+  resolved_at INTEGER,
+  created_at INTEGER DEFAULT (unixepoch())
+);
+
+CREATE INDEX IF NOT EXISTS idx_alerts_category ON alerts(category, severity, timestamp);
+CREATE INDEX IF NOT EXISTS idx_alerts_resolved ON alerts(resolved, timestamp);
+
+
+-- =============================================================================
+-- PROJECT REGISTRY
+-- =============================================================================
+-- Defines logical projects within a Cloudflare account.
+-- Cloudflare has no native resource grouping — this table provides it.
+-- Columns from migrations 007, 009, 016 merged into one CREATE TABLE.
+
+CREATE TABLE IF NOT EXISTS project_registry (
+  project_id TEXT PRIMARY KEY,              -- 'my-project', 'my-other-project'
+  display_name TEXT NOT NULL,               -- Human-readable name
+  description TEXT,                         -- Brief description
+  color TEXT,                               -- Hex colour for dashboard (#FF5733)
+  icon TEXT,                                -- Icon identifier for UI
+  owner TEXT,                               -- Team or person responsible
+  repo_path TEXT,                           -- Git repo path (e.g., 'org/repo')
+  repo_url TEXT,                            -- Full GitHub URL
+  github_repo_id TEXT,                      -- For GitHub API integration
+  status TEXT DEFAULT 'active',             -- 'active', 'archived', 'development'
+  primary_resource TEXT,                    -- Main CF resource type for utilisation tracking
+  custom_limit INTEGER,                     -- Optional custom limit override
+  created_at INTEGER DEFAULT (unixepoch()),
+  updated_at INTEGER DEFAULT (unixepoch())
+);
+
+CREATE INDEX IF NOT EXISTS idx_project_status ON project_registry(status);
+CREATE INDEX IF NOT EXISTS idx_project_github_repo ON project_registry(github_repo_id);
+
+
+-- =============================================================================
+-- RESOURCE PROJECT MAPPING
+-- =============================================================================
+-- Maps individual Cloudflare resources to their owning project.
+-- Used by the usage worker to aggregate metrics by project.
+
+CREATE TABLE IF NOT EXISTS resource_project_mapping (
+  resource_type TEXT NOT NULL,              -- 'worker', 'd1', 'kv', 'r2', etc.
+  resource_id TEXT NOT NULL,                -- CF resource ID (UUID or name)
+  resource_name TEXT NOT NULL,              -- Human-readable name
+  project_id TEXT NOT NULL,                 -- FK to project_registry
+  environment TEXT DEFAULT 'production',    -- 'production', 'staging', 'preview', 'development'
+  notes TEXT,
+  created_at INTEGER DEFAULT (unixepoch()),
+  updated_at INTEGER DEFAULT (unixepoch()),
+
+  PRIMARY KEY (resource_type, resource_id),
+  FOREIGN KEY (project_id) REFERENCES project_registry(project_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_resource_project ON resource_project_mapping(project_id);
+CREATE INDEX IF NOT EXISTS idx_resource_type ON resource_project_mapping(resource_type);
+CREATE INDEX IF NOT EXISTS idx_resource_name ON resource_project_mapping(resource_name);
+CREATE INDEX IF NOT EXISTS idx_resource_env ON resource_project_mapping(environment);
+
+
+-- =============================================================================
+-- RESOURCE TYPES (reference table)
+-- =============================================================================
+-- Defines valid resource types and their Cloudflare API endpoints.
+
+CREATE TABLE IF NOT EXISTS resource_types (
+  type_id TEXT PRIMARY KEY,                 -- 'worker', 'd1', 'kv', etc.
+  display_name TEXT NOT NULL,               -- 'Workers', 'D1 Database', etc.
+  api_endpoint TEXT,                        -- GraphQL node or REST endpoint
+  billing_dimension TEXT,                   -- Primary billing metric
+  icon TEXT,                                -- Icon for UI
+  sort_order INTEGER DEFAULT 0              -- Display order in UI
+);
+
+-- Seed resource types
+INSERT OR IGNORE INTO resource_types (type_id, display_name, api_endpoint, billing_dimension, icon, sort_order) VALUES
+  ('worker', 'Workers', 'workersInvocationsAdaptive', 'requests + CPU ms', 'zap', 1),
+  ('d1', 'D1 Database', 'd1AnalyticsAdaptiveGroups', 'rows read/written', 'database', 2),
+  ('kv', 'KV Namespace', 'kvStorageAdaptiveGroups', 'reads/writes/storage', 'key', 3),
+  ('r2', 'R2 Bucket', 'r2StorageAdaptiveGroups', 'Class A/B ops + storage', 'hard-drive', 4),
+  ('vectorize', 'Vectorize Index', 'REST /vectorize', 'dimensions stored/queried', 'search', 5),
+  ('queue', 'Queue', 'REST /queues', 'messages produced/consumed', 'list', 6),
+  ('workflow', 'Workflow', 'workersWorkflowsAdaptiveGroups', 'executions', 'git-branch', 7),
+  ('ai_gateway', 'AI Gateway', 'REST /ai-gateway', 'requests + tokens', 'cpu', 8),
+  ('workers_ai', 'Workers AI', 'workersAiAdaptiveGroups', 'neurons', 'brain', 9),
+  ('durable_object', 'Durable Object', 'durableObjectsPeriodicGroups', 'requests + GB-seconds', 'box', 10),
+  ('pages', 'Pages', 'pagesProjectsAdaptiveGroups', 'requests + bandwidth', 'globe', 11),
+  ('analytics_engine', 'Analytics Engine', 'aeDatasets', 'data points', 'bar-chart', 12);