spine-framework 0.2.9 → 0.3.1

package/.framework/config/signals.ts

@@ -0,0 +1,70 @@
+/// <reference types="node" />
+/**
+ * @module config/signals
+ * @audience installer
+ * @layer cli
+ * @stability stable
+ *
+ * Signal endpoint configuration for framework install tracking and engagement.
+ *
+ * The public framework sends anonymous signals to a configurable endpoint.
+ * Private Cortex instances receive and process these signals.
+ */
+
+export interface SignalConfig {
+  endpoint: string
+  timeout: number
+  retryAttempts: number
+  batchSize: number
+}
+
+export const signalConfig: SignalConfig = {
+  endpoint: process.env.SPINE_SIGNAL_ENDPOINT || 'https://cortex.spine-framework.com',
+  timeout: 5000,
+  retryAttempts: 3,
+  batchSize: 10,
+}
+
+// Engagement signal types with scores
+export const engagementSignals = {
+  framework_installed: { score: 1, description: 'Framework npm install completion' },
+  framework_initialized: { score: 3, description: 'First successful startup' },
+  framework_connected_db: { score: 5, description: 'Database connection success' },
+  app_install: { score: 4, description: 'App installation' },
+  app_initialized: { score: 4, description: 'App first load' },
+  app_first_action: { score: 6, description: 'First feature usage' },
+  account_created: { score: 8, description: 'Anonymous → identified migration' },
+  first_deploy: { score: 10, description: 'Production deployment' },
+  team_collaboration: { score: 12, description: 'Multi-user usage' },
+} as const
+
+export type EngagementSignalType = keyof typeof engagementSignals
+
+// Claim trigger thresholds
+export const claimTriggers = {
+  immediate: 0,        // User explicitly runs `spine-framework claim`
+  gentle_nudge: 3,     // After first successful startup
+  value_realized: 5,   // After database connection
+  ecosystem_engaged: 8, // After app installation
+  power_user: 10,      // After regular usage patterns
+} as const
+
+export interface EngagementEntry {
+  type: EngagementSignalType
+  timestamp: string
+  score: number
+}
+
+export interface EngagementData {
+  framework_install_serial: string
+  engagement_score: number
+  signals: EngagementEntry[]
+  claim_status: 'anonymous' | 'claimed' | 'pending'
+  last_claim_prompt?: string
+  account_id?: string
+}
+
+export interface ClaimPrompt {
+  timing: keyof typeof claimTriggers
+  message: string
+}

package/.framework/migrations/000_foundation.sql

@@ -862,6 +862,15 @@ CREATE UNIQUE INDEX IF NOT EXISTS idx_roles_slug_no_app
 CREATE UNIQUE INDEX IF NOT EXISTS idx_roles_slug_with_app
   ON public.roles (app_id, slug)
   WHERE app_id IS NOT NULL;
+-- Non-partial unique constraint required for PostgREST ON CONFLICT upsert on (app_id, slug)
+DO $$ BEGIN
+  IF NOT EXISTS (
+    SELECT 1 FROM pg_constraint
+    WHERE conname = 'roles_app_id_slug_key' AND conrelid = 'public.roles'::regclass
+  ) THEN
+    ALTER TABLE public.roles ADD CONSTRAINT roles_app_id_slug_key UNIQUE (app_id, slug);
+  END IF;
+END $$;
 
 CREATE INDEX IF NOT EXISTS idx_se_account  ON public.schedule_executions (account_id);
 CREATE INDEX IF NOT EXISTS idx_se_schedule ON public.schedule_executions (schedule_id);
@@ -1279,6 +1288,22 @@ BEGIN
 END;
 $$;
 
+-- ---------------------------------------------------------------------------
+-- App Installations
+-- Tracks which apps have been installed via `spine-framework install-app`
+-- ---------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS public.app_installations (
+  id                uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  app_slug          text NOT NULL,
+  account_id        uuid,
+  is_enabled        boolean DEFAULT true,
+  installed_version text,
+  package_name      text,
+  created_at        timestamptz DEFAULT now(),
+  updated_at        timestamptz DEFAULT now(),
+  UNIQUE (app_slug, account_id)
+);
+
 -- ---------------------------------------------------------------------------
 -- Role Grants
 -- Raw SQL migrations bypass Supabase's automatic grant setup. These grants

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spine-framework",
-  "version": "0.2.9",
+  "version": "0.3.1",
   "private": false,
   "description": "Spine — enterprise application framework built on Supabase + Netlify + React",
   "type": "module",
@@ -51,6 +51,7 @@
     "bin/",
     "dist/",
     ".framework/cli/",
+    ".framework/config/",
     ".framework/functions/",
     ".framework/migrations/",
     ".framework/docs/",