spine-framework 0.2.9 → 0.3.0

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spine-framework",
-  "version": "0.2.9",
+  "version": "0.3.0",
   "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/",