@littlebearapps/platform-admin-sdk 1.1.0 → 1.2.0

package/README.md

@@ -81,25 +81,84 @@ my-platform/
 
 ## Post-Scaffold Steps
 
+### 1. Install dependencies
+
 ```bash
 cd my-platform
 npm install
+```
+
+### 2. Create Cloudflare resources
+
+**All tiers:**
 
-# Create Cloudflare resources
+```bash
 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
+```
+
+**Standard tier** — also create:
+
+```bash
+npx wrangler kv namespace create PLATFORM_ALERTS
+```
+
+**Full tier** — also create:
+
+```bash
+npx wrangler kv namespace create SERVICE_REGISTRY
+```
 
-# Update resource IDs in wrangler.*.jsonc, then:
+Update the resource IDs in each `wrangler.*.jsonc` file.
+
+### 3. Configure secrets
+
+```bash
+# Standard tier — error-collector (GitHub App for auto-issue creation)
+npx wrangler secret put GITHUB_APP_ID -c wrangler.my-platform-error-collector.jsonc
+npx wrangler secret put GITHUB_APP_PRIVATE_KEY -c wrangler.my-platform-error-collector.jsonc
+npx wrangler secret put GITHUB_APP_INSTALLATION_ID -c wrangler.my-platform-error-collector.jsonc
+
+# Standard tier — sentinel (Cloudflare API for cost monitoring)
+npx wrangler secret put CLOUDFLARE_API_TOKEN -c wrangler.my-platform-sentinel.jsonc
+
+# Optional — Slack alerts (any worker with SLACK_WEBHOOK_URL)
+npx wrangler secret put SLACK_WEBHOOK_URL -c wrangler.my-platform-sentinel.jsonc
+
+# Full tier — alert-router (GitHub token for issue creation)
+npx wrangler secret put GITHUB_TOKEN -c wrangler.my-platform-alert-router.jsonc
+npx wrangler secret put SLACK_WEBHOOK_URL -c wrangler.my-platform-alert-router.jsonc
+```
+
+### 4. Apply migrations and deploy
+
+```bash
+# Sync config to D1/KV
 npm run sync:config
+
+# Apply D1 migrations
 npx wrangler d1 migrations apply my-platform-metrics --remote
+
+# Deploy workers (order matters — deploy usage first, then tail consumers)
 npx wrangler deploy -c wrangler.my-platform-usage.jsonc
+
+# Standard tier
+npx wrangler deploy -c wrangler.my-platform-error-collector.jsonc
+npx wrangler deploy -c wrangler.my-platform-sentinel.jsonc
+
+# Full tier
+npx wrangler deploy -c wrangler.my-platform-notifications.jsonc
+npx wrangler deploy -c wrangler.my-platform-search.jsonc
+npx wrangler deploy -c wrangler.my-platform-settings.jsonc
+npx wrangler deploy -c wrangler.my-platform-pattern-discovery.jsonc
+npx wrangler deploy -c wrangler.my-platform-alert-router.jsonc
 ```
 
 ## Updating Your Platform
 
-Starting with v1.1.0, the Admin SDK writes a `.platform-scaffold.json` manifest that tracks what was generated. This enables safe, incremental upgrades.
+Starting with v1.1.0, the Admin SDK writes a `.platform-scaffold.json` manifest that tracks what was generated. This enables safe, incremental upgrades. **Commit this file to git** — it's how the upgrade command knows what to update.
 
 ### Upgrade an existing project
 

package/dist/scaffold.js

@@ -45,6 +45,9 @@ export async function scaffold(options, outputDir) {
         gatusUrl: options.gatusUrl,
         defaultAssignee: options.defaultAssignee,
         sdkVersion: SDK_VERSION,
+        // Computed flags for Handlebars conditionals in templates
+        isStandard: (options.tier === 'standard' || options.tier === 'full') ? 'true' : '',
+        isFull: options.tier === 'full' ? 'true' : '',
     };
     mkdirSync(outputDir, { recursive: true });
     const fileHashes = {};

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 = "1.1.0";
+export declare const SDK_VERSION = "1.2.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). */

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 = '1.1.0';
+export const SDK_VERSION = '1.2.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`. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@littlebearapps/platform-admin-sdk",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Platform Admin SDK — scaffold backend infrastructure with workers, circuit breakers, and cost protection for Cloudflare",
   "type": "module",
   "bin": {

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

@@ -22,13 +22,28 @@
     {
       "binding": "PLATFORM_ALERTS",
       "id": "YOUR_KV_ALERTS_NAMESPACE_ID"
+    },
+    {
+      "binding": "SERVICE_REGISTRY",
+      "id": "YOUR_SERVICE_REGISTRY_KV_ID"
     }
   ],
 
+  "queues": {
+    "producers": [
+      { "binding": "PLATFORM_TELEMETRY", "queue": "{{projectSlug}}-telemetry" }
+    ]
+  },
+
+  "services": [
+    { "binding": "NOTIFICATIONS_API", "service": "{{projectSlug}}-notifications" }
+  ],
+
   "vars": {
     "CLOUDFLARE_ACCOUNT_ID": "YOUR_CLOUDFLARE_ACCOUNT_ID"
   }
 
-  // Secrets needed:
+  // Secrets needed (set via wrangler secret put):
   //   SLACK_WEBHOOK_URL
+  //   GITHUB_TOKEN
 }

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

@@ -27,6 +27,11 @@
 
   "ai": { "binding": "AI" },
 
+  // Dashboard notifications for new patterns and review-ready items
+  "services": [
+    { "binding": "NOTIFICATIONS_API", "service": "{{projectSlug}}-notifications" }
+  ],
+
   "vars": {
     "GATUS_HEARTBEAT_URL": "{{gatusUrl}}"
   }

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

@@ -20,6 +20,50 @@ projects:
           script_name: {{projectSlug}}-usage
           status: active
           schedule: "0 * * * *"
+{{#if isStandard}}
+
+        - id: {{projectSlug}}-error-collector
+          name: "Error Collector"
+          script_name: {{projectSlug}}-error-collector
+          status: active
+          schedule: "*/15 * * * *"
+          metadata:
+            type: tail-worker
+
+        - id: {{projectSlug}}-sentinel
+          name: "Platform Sentinel"
+          script_name: {{projectSlug}}-sentinel
+          status: active
+          schedule: "*/15 * * * *"
+{{/if}}
+{{#if isFull}}
+
+        - id: {{projectSlug}}-pattern-discovery
+          name: "Pattern Discovery"
+          script_name: {{projectSlug}}-pattern-discovery
+          status: active
+          schedule: "0 2 * * *"
+
+        - id: {{projectSlug}}-alert-router
+          name: "Alert Router"
+          script_name: {{projectSlug}}-alert-router
+          status: active
+
+        - id: {{projectSlug}}-notifications
+          name: "Notifications"
+          script_name: {{projectSlug}}-notifications
+          status: active
+
+        - id: {{projectSlug}}-search
+          name: "Search"
+          script_name: {{projectSlug}}-search
+          status: active
+
+        - id: {{projectSlug}}-settings
+          name: "Settings"
+          script_name: {{projectSlug}}-settings
+          status: active
+{{/if}}
       storage:
         d1:
           - database_name: {{projectSlug}}-metrics
@@ -43,3 +87,58 @@ projects:
           feature_id: "{{projectSlug}}:queue:telemetry"
           circuit_breaker: true
           cost_tier: low
+{{#if isStandard}}
+      error-collection:
+        tail-processing:
+          display_name: "Error Tail Processing"
+          feature_id: "{{projectSlug}}:error-collection:tail"
+          circuit_breaker: true
+          cost_tier: medium
+        daily-digest:
+          display_name: "Error Daily Digest"
+          feature_id: "{{projectSlug}}:error-collection:digest"
+          circuit_breaker: true
+          cost_tier: low
+        gap-alerts:
+          display_name: "Gap Alert Processing"
+          feature_id: "{{projectSlug}}:error-collection:gap-alerts"
+          circuit_breaker: false
+          cost_tier: low
+      monitor:
+        sentinel:
+          display_name: "Platform Sentinel"
+          feature_id: "{{projectSlug}}:monitor:sentinel"
+          circuit_breaker: true
+          cost_tier: low
+{{/if}}
+{{#if isFull}}
+      pattern-discovery:
+        ai-discovery:
+          display_name: "AI Pattern Discovery"
+          feature_id: "{{projectSlug}}:pattern-discovery:ai"
+          circuit_breaker: true
+          cost_tier: high
+        shadow-evaluation:
+          display_name: "Shadow Evaluation"
+          feature_id: "{{projectSlug}}:pattern-discovery:shadow"
+          circuit_breaker: true
+          cost_tier: medium
+      notifications:
+        api:
+          display_name: "Notifications API"
+          feature_id: "{{projectSlug}}:notifications:api"
+          circuit_breaker: true
+          cost_tier: low
+      search:
+        api:
+          display_name: "Search API"
+          feature_id: "{{projectSlug}}:search:api"
+          circuit_breaker: true
+          cost_tier: low
+      settings:
+        api:
+          display_name: "Settings API"
+          feature_id: "{{projectSlug}}:settings:api"
+          circuit_breaker: true
+          cost_tier: low
+{{/if}}

package/templates/shared/wrangler.usage.jsonc.hbs

@@ -51,7 +51,7 @@
     "CLOUDFLARE_ACCOUNT_ID": "YOUR_CLOUDFLARE_ACCOUNT_ID"
   }
 
-  // Uncomment when you add error-collector (standard tier):
+  // Uncomment when you add notifications (full tier):
   // "services": [
   //   { "binding": "NOTIFICATIONS_API", "service": "{{projectSlug}}-notifications" }
   // ]

package/templates/standard/wrangler.error-collector.jsonc.hbs

@@ -34,11 +34,18 @@
   "vars": {
     "GITHUB_ORG": "{{githubOrg}}",
     "DEFAULT_ASSIGNEE": "{{defaultAssignee}}",
-    "GATUS_HEARTBEAT_URL": "{{gatusUrl}}"
+    "GATUS_HEARTBEAT_URL_15M": "{{gatusUrl}}",
+    "GATUS_HEARTBEAT_URL_DIGEST": "{{gatusUrl}}"
   }
 
+  // Uncomment when you add notifications (full tier):
+  // "services": [
+  //   { "binding": "NOTIFICATIONS_API", "service": "{{projectSlug}}-notifications" }
+  // ]
+
   // Secrets needed (set via wrangler secret put):
   //   GITHUB_APP_ID
   //   GITHUB_APP_PRIVATE_KEY
   //   GITHUB_APP_INSTALLATION_ID
+  //   GATUS_TOKEN (optional: bearer token for Gatus external endpoints)
 }

package/templates/standard/wrangler.sentinel.jsonc.hbs

@@ -39,6 +39,9 @@
     "GATUS_HEARTBEAT_URL": "{{gatusUrl}}"
   }
 
+  // When you add notifications (full tier), add to the "services" array above:
+  //   { "binding": "NOTIFICATIONS_API", "service": "{{projectSlug}}-notifications" }
+
   // Secrets needed (set via wrangler secret put):
   //   CLOUDFLARE_API_TOKEN
   //   SLACK_WEBHOOK_URL (optional)