spine-framework 0.1.61 → 0.2.2

package/dist/cli/commands/claim.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @module cli/commands/claim
+ * @audience installer
+ * @layer cli
+ * @stability stable
+ *
+ * `spine-framework claim` — Claim framework installation via Spine Portal.
+ *
+ * Engagement-based claim system that offers contextual prompts based on
+ * user activity. Tracks engagement signals and triggers claim prompts
+ * at value-realization moments.
+ *
+ * **Usage:**
+ * ```bash
+ * spine-framework claim              # Interactive claim flow
+ * spine-framework claim --status     # Show claim status only
+ * spine-framework claim --token <t>  # Headless claim with token
+ * ```
+ */
+import type { Command } from 'commander';
+import { type EngagementData, type ClaimPrompt, type EngagementSignalType } from '../../config/signals.ts';
+export interface SerialData {
+    serial_number: string;
+    salt: string;
+    created_at: string;
+    framework_version: string;
+    account_id: string | null;
+    machine_fingerprint: string;
+}
+export declare function ensureSerialData(): SerialData;
+export declare function readEngagementData(): EngagementData | null;
+export declare function writeEngagementData(data: EngagementData): void;
+export declare function recordEngagementSignal(signalType: EngagementSignalType): void;
+export declare function shouldOfferClaim(): ClaimPrompt | null;
+export interface FrameworkInstallSignal {
+    signal_type: 'framework_install';
+    install_serial: string;
+    package: string;
+    version: string;
+    anonymous_id: string;
+    machine_fingerprint: string;
+    platform: string;
+    timestamp: string;
+}
+export interface AppInstallSignal {
+    signal_type: 'app_install';
+    package: string;
+    version: string;
+    framework_install_serial: string;
+    app_serial: string;
+    timestamp: string;
+}
+export declare function sendFrameworkInstallSignal(): Promise<void>;
+export declare function sendAppInstallSignal(packageName: string, version: string): Promise<void>;
+export declare function registerClaimCommands(program: Command): void;
+//# sourceMappingURL=claim.d.ts.map

package/dist/cli/commands/claim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim.d.ts","sourceRoot":"","sources":["../../../.framework/cli/commands/claim.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAKxC,OAAO,EAAkD,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,KAAK,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAS1J,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,iBAAiB,EAAE,MAAM,CAAA;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,mBAAmB,EAAE,MAAM,CAAA;CAC5B;AAiBD,wBAAgB,gBAAgB,IAAI,UAAU,CA6B7C;AAeD,wBAAgB,kBAAkB,IAAI,cAAc,GAAG,IAAI,CAO1D;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAK9D;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,oBAAoB,GAAG,IAAI,CAgC7E;AAED,wBAAgB,gBAAgB,IAAI,WAAW,GAAG,IAAI,CA8BrD;AAID,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,mBAAmB,CAAA;IAChC,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,aAAa,CAAA;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,wBAAwB,EAAE,MAAM,CAAA;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC,CAuBhE;AAED,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB9F;AAkLD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAe5D"}

package/dist/cli/commands/install-app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install-app.d.ts","sourceRoot":"","sources":["../../../.framework/cli/commands/install-app.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAugBxC,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,QAgB1D"}
+{"version":3,"file":"install-app.d.ts","sourceRoot":"","sources":["../../../.framework/cli/commands/install-app.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAmkBxC,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,QAgB1D"}

package/dist/cli/commands/migrate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../.framework/cli/commands/migrate.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAuGxC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,QAevD"}
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../.framework/cli/commands/migrate.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAmHxC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,QAevD"}

package/dist/cli/commands/publish.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @module cli/commands/publish
+ * @audience developer
+ * @layer cli
+ * @stability stable
+ *
+ * `spine-framework publish` — Bump version, write changelog, publish to npm, commit.
+ *
+ * Run from the spine-ia coding repo. Handles both the framework package and
+ * individual app packages (cortex, portal, etc.).
+ *
+ * **Usage:**
+ * ```bash
+ * spine-framework publish                          # publish framework (patch bump)
+ * spine-framework publish --app cortex             # publish cortex app (patch bump)
+ * spine-framework publish --app cortex --bump minor
+ * spine-framework publish --app cortex --bump patch --notes "Fix sidebar nav"
+ * spine-framework publish --app cortex --ci --notes "Fix sidebar nav" --bump patch
+ * ```
+ */
+import type { Command } from 'commander';
+export declare function registerPublishCommands(program: Command): void;
+//# sourceMappingURL=publish.d.ts.map

package/dist/cli/commands/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../../.framework/cli/commands/publish.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAsJxC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,QAkBvD"}

package/dist/cli/commands/status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../.framework/cli/commands/status.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AA2JxC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,QAmBtD"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../.framework/cli/commands/status.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAkOxC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,QAmBtD"}

package/dist/cli/commands/update-app.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @module cli/commands/update-app
+ * @audience installer
+ * @layer cli
+ * @stability stable
+ *
+ * `spine-framework update-app <slug>` — Check for and assist with app updates.
+ *
+ * Design principle: the agentic IDE is the merge tool. This command never
+ * writes to custom/apps/. It only:
+ *   1. Gets the new version into node_modules/ (read-only upstream reference)
+ *   2. Gives the agent a complete picture: versions, changelog, file diff summary
+ *   3. Records the new version in DB once the agent signals it is done (--accept)
+ *
+ * **Usage:**
+ * ```bash
+ * spine-framework update-app cortex              # check for updates
+ * spine-framework update-app cortex --dry-run    # full plan: changelog + file diff
+ * spine-framework update-app cortex --accept     # record new version in DB only
+ * ```
+ */
+import type { Command } from 'commander';
+export declare function registerUpdateAppCommands(program: Command): void;
+//# sourceMappingURL=update-app.d.ts.map

package/dist/cli/commands/update-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-app.d.ts","sourceRoot":"","sources":["../../../.framework/cli/commands/update-app.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAsWxC,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,QAezD"}

package/dist/cli/index.d.ts

@@ -20,7 +20,10 @@
  * | migrations  | commands/migrations.ts     |
  * | init        | commands/init.ts           |
  * | install-app | commands/install-app.ts    |
+ * | update-app  | commands/update-app.ts     |
+ * | publish     | commands/publish.ts        |
  * | status      | commands/status.ts         |
+ * | claim       | commands/claim.ts          |
  * | uninstall   | commands/uninstall-app.ts  |
  *
  * **Usage:**

package/dist/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../.framework/cli/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../.framework/cli/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG"}

package/dist/config/signals.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @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 declare const signalConfig: SignalConfig;
+export declare const engagementSignals: {
+    readonly framework_installed: {
+        readonly score: 1;
+        readonly description: "Framework npm install completion";
+    };
+    readonly framework_initialized: {
+        readonly score: 3;
+        readonly description: "First successful startup";
+    };
+    readonly framework_connected_db: {
+        readonly score: 5;
+        readonly description: "Database connection success";
+    };
+    readonly app_install: {
+        readonly score: 4;
+        readonly description: "App installation";
+    };
+    readonly app_initialized: {
+        readonly score: 4;
+        readonly description: "App first load";
+    };
+    readonly app_first_action: {
+        readonly score: 6;
+        readonly description: "First feature usage";
+    };
+    readonly account_created: {
+        readonly score: 8;
+        readonly description: "Anonymous → identified migration";
+    };
+    readonly first_deploy: {
+        readonly score: 10;
+        readonly description: "Production deployment";
+    };
+    readonly team_collaboration: {
+        readonly score: 12;
+        readonly description: "Multi-user usage";
+    };
+};
+export type EngagementSignalType = keyof typeof engagementSignals;
+export declare const claimTriggers: {
+    readonly immediate: 0;
+    readonly gentle_nudge: 3;
+    readonly value_realized: 5;
+    readonly ecosystem_engaged: 8;
+    readonly power_user: 10;
+};
+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;
+}
+//# sourceMappingURL=signals.d.ts.map

package/dist/config/signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../.framework/config/signals.ts"],"names":[],"mappings":"AACA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,eAAO,MAAM,YAAY,EAAE,YAK1B,CAAA;AAGD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAUpB,CAAA;AAEV,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,iBAAiB,CAAA;AAGjE,eAAO,MAAM,aAAa;;;;;;CAMhB,CAAA;AAEV,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,oBAAoB,CAAA;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,wBAAwB,EAAE,MAAM,CAAA;IAChC,gBAAgB,EAAE,MAAM,CAAA;IACxB,OAAO,EAAE,eAAe,EAAE,CAAA;IAC1B,YAAY,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,CAAA;IACjD,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,OAAO,aAAa,CAAA;IAClC,OAAO,EAAE,MAAM,CAAA;CAChB"}

package/package-project.json

@@ -5,12 +5,17 @@
   "scripts": {
     "assemble": "bash node_modules/spine-framework/scripts/assemble.sh",
     "dev": "netlify dev",
-    "build": "npm run assemble && netlify build",
+    "build": "npm run assemble && vite build --config node_modules/spine-framework/config/vite.config.ts",
     "preview": "netlify dev"
   },
   "dependencies": {
-    "spine-framework": "^0.1.0",
+    "spine-framework": "^0.2.0",
     "@tanstack/react-query": "^5.0.0",
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0",
+    "react-router-dom": "^6.28.0",
+    "@netlify/functions": "^2.0.0",
+    "react-is": "^18.3.0",
     "lucide-react": "^0.400.0",
     "clsx": "^2.0.0",
     "tailwind-merge": "^2.0.0",
@@ -54,6 +59,8 @@
     "highlight.js": "^11.11.1"
   },
   "devDependencies": {
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
     "vite": "^6.4.3",
     "@vitejs/plugin-react": "^4.0.0",
     "tailwindcss": "^3.4.0",

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "spine-framework",
-  "version": "0.1.61",
+  "version": "0.2.2",
   "private": false,
   "description": "Spine — enterprise application framework built on Supabase + Netlify + React",
   "type": "module",
-  "license": "MIT",
+  "license": "SEE LICENSE IN LICENSE.md",
   "keywords": [
     "spine",
     "framework",
@@ -14,19 +14,20 @@
     "enterprise",
     "agentic"
   ],
-  "homepage": "https://github.com/art-mojo-admin/spine#readme",
+  "homepage": "https://github.com/spine-framework/spine-framework#readme",
   "bugs": {
-    "url": "https://github.com/art-mojo-admin/spine/issues"
+    "url": "https://github.com/spine-framework/spine-framework/issues"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/art-mojo-admin/spine"
+    "url": "https://github.com/spine-framework/spine-framework"
   },
   "engines": {
     "node": ">=18.0.0"
   },
   "bin": {
-    "spine-framework": "./bin/spine-framework.cjs"
+    "spine-framework": "./bin/spine-framework.js",
+    "spine": "./bin/spine-framework.js"
   },
   "exports": {
     ".": {
@@ -61,7 +62,8 @@
     "index.html",
     "package-project.json",
     "STRUCTURE.md",
-    "README.md"
+    "README.md",
+    "LICENSE.md"
   ],
   "scripts": {
     "spine-framework": "tsx .framework/cli/index.ts",
@@ -85,7 +87,7 @@
     "test:integration": "vitest run .framework/tests/integration",
     "test:boundary": "bash scripts/boundary-check.sh",
     "test:custom": "vitest run custom/tests",
-    "postinstall": "node bin/welcome.cjs || true",
+    "postinstall": "node bin/welcome.js || true",
     "docs": "typedoc --config config/typedoc.json"
   },
   "dependencies": {

package/scripts/assemble-frontend.sh

@@ -61,14 +61,11 @@ if [ -f "$PROJECT_ROOT/.framework/public/_redirects" ]; then
   echo "  ✓ Core: _redirects copied to Vite-served directory for Netlify dev"
 fi
 
-# 6. Overlay custom src (overrides + additions)
+# 6. Copy custom/apps/ → .assembled/custom/apps/ (preserves path for CustomAppLoader glob)
+ASSEMBLED_CUSTOM_DIR="$PROJECT_ROOT/.assembled/custom/apps"
 if [ -d "$CUSTOM_SRC_DIR" ]; then
-  # Copy files and subdirectories
-  cp -r "$CUSTOM_SRC_DIR"/* "$TARGET_SRC_DIR"/ 2>/dev/null || true
-  
-  # Handle subdirectories properly
-  find "$CUSTOM_SRC_DIR" -mindepth 1 -type d -exec sh -c 'dir="$1"; base=$(basename "$dir"); mkdir -p "'"$TARGET_SRC_DIR"'/$base" && cp -r "$dir"/* "'"$TARGET_SRC_DIR"'/$base/"' _ {} \; 2>/dev/null || true
-  
+  mkdir -p "$ASSEMBLED_CUSTOM_DIR"
+  cp -r "$CUSTOM_SRC_DIR"/* "$ASSEMBLED_CUSTOM_DIR"/ 2>/dev/null || true
   CUSTOM_COUNT=$(find "$CUSTOM_SRC_DIR" -name '*.tsx' -o -name '*.ts' -o -name '*.css' 2>/dev/null | wc -l | tr -d ' ')
   echo "  ✓ Custom: $CUSTOM_COUNT files"
 else

package/bin/ws-shim.cjs

@@ -1,8 +0,0 @@
-// Polyfill globalThis.WebSocket with the 'ws' package for Node < 22.
-// Required by supabase-js Realtime client which checks for WebSocket at construction time.
-if (typeof globalThis.WebSocket === 'undefined') {
-  try {
-    const { WebSocket } = require('ws')
-    globalThis.WebSocket = WebSocket
-  } catch {}
-}