spine-framework 0.2.1 → 0.2.2

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

@@ -1,6 +1,6 @@
 {
   "name": "spine-framework",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "private": false,
   "description": "Spine — enterprise application framework built on Supabase + Netlify + React",
   "type": "module",
@@ -26,7 +26,8 @@
     "node": ">=18.0.0"
   },
   "bin": {
-    "spine-framework": "./bin/spine-framework.cjs"
+    "spine-framework": "./bin/spine-framework.js",
+    "spine": "./bin/spine-framework.js"
   },
   "exports": {
     ".": {
@@ -86,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/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 {}
-}