@littlebearapps/create-platform 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * @littlebearapps/create-platform
+ *
+ * Scaffolds a Cloudflare Workers platform with SDK integration,
+ * circuit breakers, and cost protection.
+ *
+ * Usage:
+ *   npx @littlebearapps/create-platform [project-name]
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+/**
+ * @littlebearapps/create-platform
+ *
+ * Scaffolds a Cloudflare Workers platform with SDK integration,
+ * circuit breakers, and cost protection.
+ *
+ * Usage:
+ *   npx @littlebearapps/create-platform [project-name]
+ */
+import { resolve } from 'node:path';
+import pc from 'picocolors';
+import { collectOptions } from './prompts.js';
+import { scaffold } from './scaffold.js';
+const BANNER = `
+  ${pc.bold(pc.cyan('Platform SDK'))} — Cloudflare Cost Protection
+  ${pc.dim('Automatic circuit breakers, budget enforcement, and error collection')}
+`;
+async function main() {
+    console.log(BANNER);
+    const projectName = process.argv[2];
+    const options = await collectOptions(projectName);
+    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-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,15 @@
+/**
+ * Interactive CLI prompts for project scaffolding configuration.
+ *
+ * Falls back to 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;
+}
+export declare function collectOptions(projectNameArg?: string): Promise<ScaffoldOptions>;

package/dist/prompts.js

@@ -0,0 +1,58 @@
+/**
+ * Interactive CLI prompts for project scaffolding configuration.
+ *
+ * Falls back to sensible defaults when running non-interactively.
+ */
+import * as readline from 'node:readline';
+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(projectNameArg) {
+    const projectName = projectNameArg || await prompt('Project name', 'my-platform');
+    const projectSlug = await prompt('Project slug (for resource names)', slugify(projectName));
+    const githubOrg = await prompt('GitHub org (for error issue creation)', '');
+    const tier = await promptSelect('Setup tier:', ['minimal', 'standard', 'full'], 1);
+    const gatusUrl = await prompt('Gatus status page URL (optional)', '');
+    const 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,53 @@
+/**
+ * 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 },
+];
+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 },
+];
+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 },
+];
+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/create-platform",
+  "version": "1.0.0",
+  "description": "Scaffold a Cloudflare Workers platform with SDK integration, circuit breakers, and cost protection",
+  "type": "module",
+  "bin": {
+    "create-platform": "./dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "templates/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "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-sdk.git",
+    "directory": "packages/create-platform"
+  },
+  "keywords": [
+    "cloudflare-workers",
+    "platform-sdk",
+    "scaffold",
+    "cost-protection",
+    "circuit-breaker",
+    "create"
+  ],
+  "author": "Little Bear Apps",
+  "license": "MIT"
+}

package/templates/full/migrations/006_pattern_discovery.sql

@@ -0,0 +1,199 @@
+-- =============================================================================
+-- 006_pattern_discovery.sql — AI pattern discovery (full tier)
+-- =============================================================================
+-- Consolidated from original migrations: 042, 049, 050
+--
+-- Tables:
+--   transient_pattern_suggestions — AI-suggested patterns with approval workflow
+--   pattern_audit_log             — Pattern lifecycle event audit trail
+--   error_clusters                — Groups of similar unclassified errors
+--   pattern_match_evidence        — Detailed match evidence for evaluation
+--
+-- Uses the FINAL schema from migration 049 which expanded the status constraint
+-- to include 'shadow' and 'stale' states, and added protection/source tracking.
+-- Also includes review_context from migration 050.
+-- =============================================================================
+
+
+-- =============================================================================
+-- TRANSIENT PATTERN SUGGESTIONS (final schema from 049, with 050 additions)
+-- =============================================================================
+-- Pattern suggestions from AI analysis with human-in-the-loop approval.
+-- Patterns go through: pending -> shadow -> ready for review -> approved/rejected
+-- Static-imported patterns are protected (is_protected=1, cannot auto-demote).
+
+CREATE TABLE IF NOT EXISTS transient_pattern_suggestions (
+  id TEXT PRIMARY KEY,
+
+  -- Pattern definition (supports DSL types for safety)
+  pattern_type TEXT NOT NULL CHECK (pattern_type IN ('regex', 'contains', 'startsWith', 'statusCode')),
+  pattern_value TEXT NOT NULL,
+  category TEXT NOT NULL,
+  scope TEXT DEFAULT 'global',             -- 'global', 'service:name', 'upstream:name'
+
+  -- AI metadata
+  confidence_score REAL,
+  sample_messages TEXT,                    -- JSON array of sample error messages
+  ai_reasoning TEXT,
+  cluster_id TEXT,                         -- Reference to error cluster
+
+  -- Approval workflow (expanded states from 049)
+  status TEXT DEFAULT 'pending' CHECK (status IN ('pending', 'shadow', 'approved', 'stale', 'rejected', 'disabled')),
+  reviewed_by TEXT,
+  reviewed_at INTEGER,
+  rejection_reason TEXT,
+
+  -- Validation results (backtest against historical errors)
+  backtest_match_count INTEGER,
+  backtest_total_errors INTEGER,
+  backtest_match_rate REAL,
+  backtest_run_at INTEGER,
+
+  -- Shadow mode (run pattern but don't apply)
+  shadow_mode_start INTEGER,
+  shadow_mode_end INTEGER,
+  shadow_mode_matches INTEGER DEFAULT 0,
+
+  -- Shadow evaluation tracking (from 049)
+  shadow_match_days TEXT,                  -- JSON array of unique days with matches
+
+  -- Lifecycle tracking
+  enabled_at INTEGER,
+  disabled_at INTEGER,
+  last_matched_at INTEGER,
+  match_count INTEGER DEFAULT 0,
+
+  -- Protection and source tracking (from 049)
+  is_protected INTEGER DEFAULT 0,          -- 1 = cannot be auto-demoted (for static patterns)
+  source TEXT DEFAULT 'ai-discovered' CHECK (source IN ('ai-discovered', 'static-import', 'manual')),
+  original_regex TEXT,                     -- Original regex if converted from static
+
+  -- Review context (from 050) — JSON with match evidence summary
+  review_context TEXT,
+  -- review_context stores:
+  -- {
+  --   "totalMatches": number,
+  --   "matchesByProject": { "project-a": 5, "project-b": 3 },
+  --   "matchesByScript": { "worker-a": 5, "worker-b": 3 },
+  --   "sampleMessages": ["msg1", "msg2", "msg3"],
+  --   "distinctDays": 5,
+  --   "aiExplainer": "This pattern catches X errors across Y projects...",
+  --   "readyForReviewAt": timestamp
+  -- }
+
+  -- Timestamps
+  created_at INTEGER DEFAULT (unixepoch()),
+  updated_at INTEGER DEFAULT (unixepoch())
+);
+
+CREATE INDEX IF NOT EXISTS idx_suggestions_status ON transient_pattern_suggestions(status);
+CREATE INDEX IF NOT EXISTS idx_suggestions_category ON transient_pattern_suggestions(category);
+CREATE INDEX IF NOT EXISTS idx_suggestions_scope ON transient_pattern_suggestions(scope);
+CREATE INDEX IF NOT EXISTS idx_suggestions_created ON transient_pattern_suggestions(created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_suggestions_source ON transient_pattern_suggestions(source);
+CREATE INDEX IF NOT EXISTS idx_suggestions_protected ON transient_pattern_suggestions(is_protected);
+
+
+-- =============================================================================
+-- PATTERN AUDIT LOG (final schema from 049)
+-- =============================================================================
+-- Audit log for pattern lifecycle events including self-tuning actions.
+
+CREATE TABLE IF NOT EXISTS pattern_audit_log (
+  id TEXT PRIMARY KEY,
+  pattern_id TEXT NOT NULL,
+  action TEXT NOT NULL CHECK (action IN (
+    'created',                             -- AI suggested pattern
+    'approved',                            -- Human approved
+    'rejected',                            -- Human rejected
+    'enabled',                             -- Activated in production
+    'disabled',                            -- Manually disabled
+    'auto-disabled',                       -- System disabled due to anomaly
+    'backtest-passed',                     -- Backtest validation passed
+    'backtest-failed',                     -- Backtest validation failed
+    'shadow-started',                      -- Shadow mode started
+    'shadow-completed',                    -- Shadow mode completed
+    'expired',                             -- Auto-expired due to inactivity
+    'auto-promoted',                       -- Auto-promoted from shadow to approved
+    'auto-demoted',                        -- Auto-demoted from approved to stale
+    'reactivated',                         -- Reactivated from stale to shadow
+    'imported',                            -- Imported from static patterns
+    'ready-for-review'                     -- Pattern ready for human review
+  )),
+  actor TEXT,                              -- 'ai:model', 'human:name', 'system:evaluator'
+  reason TEXT,
+  metadata TEXT,                           -- JSON with additional context
+  created_at INTEGER DEFAULT (unixepoch()),
+
+  FOREIGN KEY (pattern_id) REFERENCES transient_pattern_suggestions(id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_audit_pattern ON pattern_audit_log(pattern_id);
+CREATE INDEX IF NOT EXISTS idx_audit_action ON pattern_audit_log(action);
+CREATE INDEX IF NOT EXISTS idx_audit_created ON pattern_audit_log(created_at DESC);
+
+
+-- =============================================================================
+-- ERROR CLUSTERS (from 042)
+-- =============================================================================
+-- Groups similar unclassified errors for AI pattern discovery.
+
+CREATE TABLE IF NOT EXISTS error_clusters (
+  id TEXT PRIMARY KEY,
+
+  -- Cluster identification
+  cluster_hash TEXT NOT NULL UNIQUE,       -- Hash of normalised message for dedup
+  representative_message TEXT NOT NULL,    -- Sample message for display
+
+  -- Statistics
+  occurrence_count INTEGER DEFAULT 1,
+  unique_fingerprints INTEGER DEFAULT 1,
+  first_seen_at INTEGER NOT NULL,
+  last_seen_at INTEGER NOT NULL,
+
+  -- Scripts affected
+  scripts TEXT,                            -- JSON array of script names
+
+  -- Processing status
+  status TEXT DEFAULT 'pending' CHECK (status IN ('pending', 'processing', 'suggested', 'ignored')),
+  suggestion_id TEXT,                      -- Reference to created suggestion
+
+  created_at INTEGER DEFAULT (unixepoch()),
+  updated_at INTEGER DEFAULT (unixepoch()),
+
+  FOREIGN KEY (suggestion_id) REFERENCES transient_pattern_suggestions(id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_clusters_status ON error_clusters(status);
+CREATE INDEX IF NOT EXISTS idx_clusters_count ON error_clusters(occurrence_count DESC);
+CREATE INDEX IF NOT EXISTS idx_clusters_hash ON error_clusters(cluster_hash);
+
+
+-- =============================================================================
+-- PATTERN MATCH EVIDENCE (from 050)
+-- =============================================================================
+-- Tracks when patterns match errors during shadow evaluation.
+-- Provides rich context for human review decisions.
+
+CREATE TABLE IF NOT EXISTS pattern_match_evidence (
+  id TEXT PRIMARY KEY,
+  pattern_id TEXT NOT NULL,
+
+  -- Match context
+  script_name TEXT NOT NULL,
+  project TEXT,
+  error_fingerprint TEXT,
+  normalized_message TEXT,
+
+  -- Match metadata
+  matched_at INTEGER NOT NULL DEFAULT (unixepoch()),
+  error_type TEXT,                         -- 'exception', 'soft_error', 'warning'
+  priority TEXT,                           -- 'P0' - 'P4'
+
+  FOREIGN KEY (pattern_id) REFERENCES transient_pattern_suggestions(id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_pattern_match_evidence_pattern_id ON pattern_match_evidence(pattern_id);
+CREATE INDEX IF NOT EXISTS idx_pattern_match_evidence_matched_at ON pattern_match_evidence(matched_at);
+CREATE INDEX IF NOT EXISTS idx_pattern_match_evidence_project ON pattern_match_evidence(project);
+CREATE INDEX IF NOT EXISTS idx_pattern_match_evidence_script ON pattern_match_evidence(script_name);

package/templates/full/migrations/007_notifications_search.sql

@@ -0,0 +1,127 @@
+-- =============================================================================
+-- 007_notifications_search.sql — Notifications, search, settings (full tier)
+-- =============================================================================
+-- Consolidated from original migrations: 044, 045, 046
+--
+-- Tables:
+--   notifications       — Cross-project notifications from various sources
+--   platform_settings   — Unified settings with project/category/key namespacing
+--   search_index        — Main search index table
+--   search_fts          — FTS5 virtual table for full-text search
+--
+-- Triggers:
+--   search_fts_ai       — Sync FTS index on INSERT
+--   search_fts_ad       — Sync FTS index on DELETE
+--   search_fts_au       — Sync FTS index on UPDATE
+-- =============================================================================
+
+
+-- =============================================================================
+-- NOTIFICATIONS (from 044)
+-- =============================================================================
+-- Unified notifications from various sources:
+-- - error-collector: P0-P2 errors needing attention
+-- - pattern-discovery: AI-suggested patterns pending approval
+-- - circuit-breaker: Feature budget warnings and pauses
+-- - usage: Cost threshold warnings
+--
+-- Per-user read state is stored in KV for fast access.
+
+CREATE TABLE IF NOT EXISTS notifications (
+  id TEXT PRIMARY KEY,
+  category TEXT NOT NULL CHECK (category IN ('error', 'warning', 'info', 'success')),
+  source TEXT NOT NULL,                    -- 'error-collector', 'pattern-discovery', etc.
+  source_id TEXT,                          -- Reference to source record
+  title TEXT NOT NULL,
+  description TEXT,
+  priority TEXT DEFAULT 'info' CHECK (priority IN ('critical', 'high', 'medium', 'low', 'info')),
+  action_url TEXT,                         -- Deep link to relevant page
+  action_label TEXT,                       -- Button text
+  project TEXT,                            -- Project slug or NULL for global
+  created_at INTEGER DEFAULT (unixepoch()),
+  expires_at INTEGER                       -- Optional expiry for transient notifications
+);
+
+CREATE INDEX IF NOT EXISTS idx_notifications_created ON notifications(created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_notifications_project ON notifications(project);
+CREATE INDEX IF NOT EXISTS idx_notifications_source ON notifications(source);
+CREATE INDEX IF NOT EXISTS idx_notifications_priority ON notifications(priority);
+CREATE INDEX IF NOT EXISTS idx_notifications_project_created ON notifications(project, created_at DESC);
+
+
+-- =============================================================================
+-- PLATFORM SETTINGS (from 045)
+-- =============================================================================
+-- Unified settings with project/category/key namespacing.
+-- Categories: notifications, thresholds, display, api.
+
+CREATE TABLE IF NOT EXISTS platform_settings (
+  id TEXT PRIMARY KEY,
+  project TEXT NOT NULL,                   -- 'global', 'platform', or project slug
+  category TEXT NOT NULL,                  -- 'notifications', 'thresholds', 'display', 'api'
+  key TEXT NOT NULL,
+  value TEXT NOT NULL,                     -- JSON-encoded value
+  description TEXT,
+  updated_at INTEGER DEFAULT (unixepoch()),
+  updated_by TEXT,
+  UNIQUE(project, category, key)
+);
+
+CREATE INDEX IF NOT EXISTS idx_settings_project_category ON platform_settings(project, category);
+CREATE INDEX IF NOT EXISTS idx_settings_project_key ON platform_settings(project, key);
+
+
+-- =============================================================================
+-- SEARCH INDEX (from 046)
+-- =============================================================================
+-- Platform-wide search across errors, patterns, settings, pages, services.
+-- Uses SQLite FTS5 for efficient full-text search with:
+-- - Prefix matching (e.g., "err*")
+-- - Phrase matching (e.g., "circuit breaker")
+-- - Boolean operators (AND, OR, NOT)
+
+-- Main search index table
+CREATE TABLE IF NOT EXISTS search_index (
+  id TEXT PRIMARY KEY,
+  content_type TEXT NOT NULL,              -- 'error', 'pattern', 'setting', 'page', 'service'
+  project TEXT,                            -- Project slug or NULL for global
+  title TEXT NOT NULL,
+  content TEXT NOT NULL,                   -- Searchable content (normalised)
+  url TEXT NOT NULL,                       -- Deep link
+  metadata TEXT,                           -- JSON with type-specific data
+  indexed_at INTEGER DEFAULT (unixepoch()),
+  source_updated_at INTEGER                -- When the source record was last updated
+);
+
+CREATE INDEX IF NOT EXISTS idx_search_content_type ON search_index(content_type, project);
+CREATE INDEX IF NOT EXISTS idx_search_source_updated ON search_index(source_updated_at);
+
+-- FTS5 virtual table for full-text search
+-- content='search_index' makes it a content-less FTS table referencing the main table
+CREATE VIRTUAL TABLE IF NOT EXISTS search_fts USING fts5(
+  title,
+  content,
+  content='search_index',
+  content_rowid='rowid',
+  tokenize='porter unicode61'              -- Porter stemming + Unicode support
+);
+
+-- Trigger to keep FTS index in sync on INSERT
+CREATE TRIGGER IF NOT EXISTS search_fts_ai AFTER INSERT ON search_index BEGIN
+  INSERT INTO search_fts(rowid, title, content)
+  VALUES (new.rowid, new.title, new.content);
+END;
+
+-- Trigger to keep FTS index in sync on DELETE
+CREATE TRIGGER IF NOT EXISTS search_fts_ad AFTER DELETE ON search_index BEGIN
+  INSERT INTO search_fts(search_fts, rowid, title, content)
+  VALUES ('delete', old.rowid, old.title, old.content);
+END;
+
+-- Trigger to keep FTS index in sync on UPDATE
+CREATE TRIGGER IF NOT EXISTS search_fts_au AFTER UPDATE ON search_index BEGIN
+  INSERT INTO search_fts(search_fts, rowid, title, content)
+  VALUES ('delete', old.rowid, old.title, old.content);
+  INSERT INTO search_fts(rowid, title, content)
+  VALUES (new.rowid, new.title, new.content);
+END;