spine-framework 0.1.60 → 0.2.0

package/package.json

@@ -1,68 +1,56 @@
 {
   "name": "spine-framework",
-  "version": "0.1.60",
-  "private": false,
-  "description": "Spine — enterprise application framework built on Supabase + Netlify + React",
+  "version": "0.2.0",
+  "description": "Multi-tenant, modular application platform for modern SaaS systems",
   "type": "module",
-  "license": "MIT",
+  "bin": {
+    "spine-framework": "./.framework/cli/index.ts"
+  },
+  "files": [
+    ".framework/cli/",
+    ".framework/docs/",
+    ".framework/functions/",
+    ".framework/migrations/001_schema.sql",
+    ".framework/migrations/002_rls_and_functions.sql",
+    ".framework/migrations/003_system_data.sql",
+    ".framework/migrations/004_enhancements.sql",
+    ".framework/public/",
+    ".framework/scripts/",
+    ".framework/seeds/",
+    ".framework/src/",
+    ".framework/index.html",
+    ".framework/README.md",
+    "custom/.devin/",
+    "custom/README.md",
+    "docs/APPS.md",
+    "docs/ARCHITECTURE.md",
+    "docs/INSTALL.md",
+    "docs/README.md",
+    "docs/spine-core--api-reference.md",
+    "docs/design-schema-spec.md",
+    "docs/dev-guides/",
+    "docs/npm-packages-plan.md",
+    "README.md",
+    "LICENSE.md"
+  ],
   "keywords": [
     "spine",
     "framework",
+    "multi-tenant",
+    "saas",
     "supabase",
-    "netlify",
     "react",
-    "enterprise",
-    "agentic"
+    "typescript"
   ],
-  "homepage": "https://github.com/art-mojo-admin/spine#readme",
-  "bugs": {
-    "url": "https://github.com/art-mojo-admin/spine/issues"
-  },
+  "license": "SEE LICENSE IN LICENSE.md",
   "repository": {
     "type": "git",
-    "url": "https://github.com/art-mojo-admin/spine"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "bin": {
-    "spine-framework": "./bin/spine-framework.cjs"
+    "url": "https://github.com/spine-framework/spine-framework.git"
   },
-  "exports": {
-    ".": {
-      "types": "./dist/functions/_shared/index.d.ts",
-      "import": "./.framework/functions/_shared/index.ts"
-    },
-    "./_shared": {
-      "types": "./dist/functions/_shared/index.d.ts",
-      "import": "./.framework/functions/_shared/index.ts"
-    },
-    "./_shared/*": {
-      "types": "./dist/functions/_shared/*.d.ts",
-      "import": "./.framework/functions/_shared/*.ts"
-    },
-    "./cli": {
-      "types": "./dist/cli/index.d.ts",
-      "import": "./.framework/cli/index.ts"
-    }
+  "homepage": "https://spine-framework.com",
+  "bugs": {
+    "url": "https://github.com/spine-framework/spine-framework/issues"
   },
-  "files": [
-    "bin/",
-    "dist/",
-    ".framework/cli/",
-    ".framework/functions/",
-    ".framework/migrations/",
-    ".framework/docs/",
-    ".framework/src/",
-    "scripts/",
-    "config/",
-    "netlify.toml",
-    "vitest.config.ts",
-    "index.html",
-    "package-project.json",
-    "STRUCTURE.md",
-    "README.md"
-  ],
   "scripts": {
     "spine-framework": "tsx .framework/cli/index.ts",
     "dev": "vite --config config/vite.config.ts",
@@ -73,8 +61,6 @@
     "verify": "bash scripts/verify-integrity.sh",
     "prebuild": "npm run assemble && npm run verify",
     "build": "tsc -b config/tsconfig.json && vite build --config config/vite.config.ts",
-    "build:lib": "tsc -p config/tsconfig.build.json",
-    "prepublishOnly": "npm run build:lib && npm run test:boundary && npm run test:unit",
     "preview": "vite preview --config config/vite.config.ts",
     "lint": "eslint .",
     "app-install": "tsx scripts/app-install-cli.ts",
@@ -84,72 +70,12 @@
     "test:core": "vitest run .framework/tests/unit/core-isolation.test.ts",
     "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",
-    "docs": "typedoc --config config/typedoc.json"
+    "docs": "typedoc --entryPoints .framework/functions/_shared/index.ts --out docs/generated"
   },
   "dependencies": {
-    "@supabase/supabase-js": "^2.49.1",
-    "commander": "^12.0.0",
-    "jsonwebtoken": "^9.0.3",
-    "jwt-decode": "^4.0.0",
-    "pg": "^8.13.0",
-    "tsx": "^4.21.0",
-    "ws": "^8.21.0"
-  },
-  "peerDependencies": {
-    "@netlify/functions": "^2.0.0",
-    "react": "^18.0.0 || ^19.0.0",
-    "react-dom": "^18.0.0 || ^19.0.0",
-    "react-router-dom": "^6.0.0",
-    "vite": "^5.0.0 || ^6.0.0",
-    "@tiptap/react": "^3.24.0",
-    "@tiptap/starter-kit": "^3.24.0",
-    "@tiptap/extension-code-block-lowlight": "^3.24.0",
-    "@tiptap/extension-placeholder": "^3.24.0",
-    "lowlight": "^3.3.0",
-    "highlight.js": "^11.11.1"
-  },
-  "peerDependenciesMeta": {
-    "@netlify/functions": {
-      "optional": false
-    },
-    "react": {
-      "optional": false
-    },
-    "react-dom": {
-      "optional": false
-    },
-    "react-router-dom": {
-      "optional": false
-    },
-    "vite": {
-      "optional": true
-    },
-    "@tiptap/react": {
-      "optional": true
-    },
-    "@tiptap/starter-kit": {
-      "optional": true
-    },
-    "@tiptap/extension-code-block-lowlight": {
-      "optional": true
-    },
-    "@tiptap/extension-placeholder": {
-      "optional": true
-    },
-    "lowlight": {
-      "optional": true
-    },
-    "highlight.js": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
     "@base-ui/react": "^1.4.1",
     "@fontsource-variable/inter": "^5.2.8",
     "@heroicons/react": "^2.2.0",
-    "@netlify/functions": "^2.8.2",
     "@radix-ui/react-accordion": "^1.2.12",
     "@radix-ui/react-avatar": "^1.1.3",
     "@radix-ui/react-dialog": "^1.1.6",
@@ -166,29 +92,21 @@
     "@radix-ui/react-toast": "^1.2.6",
     "@radix-ui/react-tooltip": "^1.1.8",
     "@supabase/supabase-js": "^2.49.1",
-    "@tailwindcss/typography": "^0.5.19",
     "@tanstack/react-query": "^5.95.2",
-    "@tiptap/extension-code-block-lowlight": "^3.24.0",
-    "@tiptap/extension-image": "^3.24.0",
-    "@tiptap/extension-link": "^3.24.0",
-    "@tiptap/extension-placeholder": "^3.24.0",
-    "@tiptap/extension-table": "^3.24.0",
-    "@tiptap/extension-table-cell": "^3.24.0",
-    "@tiptap/extension-table-header": "^3.24.0",
-    "@tiptap/extension-table-row": "^3.24.0",
-    "@tiptap/extension-youtube": "^3.24.0",
-    "@tiptap/pm": "^3.24.0",
-    "@tiptap/react": "^3.24.0",
-    "@tiptap/starter-kit": "^3.24.0",
-    "@types/js-yaml": "^4.0.9",
-    "@types/node": "^22.12.0",
-    "@types/react": "^18.3.18",
-    "@types/react-dom": "^18.3.5",
+    "@tiptap/extension-code-block-lowlight": "^3.20.0",
+    "@tiptap/extension-image": "^3.20.0",
+    "@tiptap/extension-link": "^3.20.0",
+    "@tiptap/extension-placeholder": "^3.20.0",
+    "@tiptap/extension-table": "^3.20.0",
+    "@tiptap/extension-table-cell": "^3.20.0",
+    "@tiptap/extension-table-header": "^3.20.0",
+    "@tiptap/extension-table-row": "^3.20.0",
+    "@tiptap/extension-youtube": "^3.20.0",
+    "@tiptap/pm": "^3.20.0",
+    "@tiptap/react": "^3.20.0",
+    "@tiptap/starter-kit": "^3.20.0",
     "@types/react-grid-layout": "^1.3.6",
-    "@vitejs/plugin-react": "^4.3.4",
     "@xyflow/react": "^12.10.1",
-    "ajv": "^8.12.0",
-    "autoprefixer": "^10.4.20",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "cmdk": "^1.1.1",
@@ -199,13 +117,13 @@
     "github-markdown-css": "^5.9.0",
     "highlight.js": "^11.11.1",
     "input-otp": "^1.4.2",
-    "js-yaml": "^4.1.0",
+    "jsonwebtoken": "^9.0.3",
+    "jwt-decode": "^4.0.0",
     "lowlight": "^3.3.0",
     "lucide-react": "^1.14.0",
     "marked": "^17.0.3",
-    "mermaid": "^11.15.0",
+    "mermaid": "^11.12.3",
     "next-themes": "^0.4.6",
-    "postcss": "^8.5.15",
     "radix-ui": "^1.4.3",
     "react": "^18.3.1",
     "react-day-picker": "^10.0.0",
@@ -213,10 +131,9 @@
     "react-grid-layout": "^2.2.2",
     "react-is": "^19.2.4",
     "react-markdown": "^10.1.0",
-    "react-refresh": "^0.14.0",
     "react-resizable-panels": "^4.11.0",
     "react-router-dom": "^6.28.1",
-    "recharts": "^3.8.1",
+    "recharts": "3.8.0",
     "rehype-autolink-headings": "^7.1.0",
     "rehype-raw": "^7.0.0",
     "rehype-sanitize": "^6.0.0",
@@ -225,15 +142,32 @@
     "shadcn": "^4.7.0",
     "sonner": "^2.0.7",
     "tailwind-merge": "^3.5.0",
-    "tailwindcss": "^3.4.17",
     "tailwindcss-animate": "^1.0.7",
     "tiptap-markdown": "^0.9.0",
     "tw-animate-css": "^1.4.0",
+    "vaul": "^1.1.2"
+  },
+  "devDependencies": {
+    "@netlify/functions": "^2.8.2",
+    "@supabase/supabase-js": "^2.49.1",
+    "@tailwindcss/typography": "^0.5.19",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.12.0",
+    "@types/react": "^18.3.18",
+    "@types/react-dom": "^18.3.5",
+    "@vitejs/plugin-react": "^4.3.4",
+    "ajv": "^8.12.0",
+    "autoprefixer": "^10.4.20",
+    "commander": "^12.0.0",
+    "js-yaml": "^4.1.0",
+    "postcss": "^8.5.1",
+    "react-refresh": "^0.14.0",
+    "tailwindcss": "^3.4.17",
+    "tsx": "^4.21.0",
     "typedoc": "^0.27.0",
     "typescript": "~5.6.2",
-    "vaul": "^1.1.2",
-    "vite": "^6.4.3",
-    "vitest": "^4.1.8"
+    "vite": "^6.0.11",
+    "vitest": "^2.1.9"
   },
   "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"
 }

package/.framework/cli/bin.cjs

@@ -1,14 +0,0 @@
-#!/usr/bin/env node
-// Thin shebang wrapper — invokes the TypeScript CLI via tsx.
-// This file is the npm bin entry point for spine-framework.
-const { execFileSync } = require('child_process')
-const { resolve } = require('path')
-
-const tsx = resolve(__dirname, '../../node_modules/.bin/tsx')
-const entry = resolve(__dirname, 'index.ts')
-
-try {
-  execFileSync(tsx, [entry, ...process.argv.slice(2)], { stdio: 'inherit' })
-} catch (e) {
-  process.exit(e.status ?? 1)
-}

package/.framework/cli/commands/init.ts

@@ -1,186 +0,0 @@
-/// <reference types="node" />
-/**
- * @module cli/commands/init
- * @audience installer
- * @layer cli
- * @stability stable
- *
- * `spine-framework init` — Write .env and scaffold the custom/ workspace.
- *
- * Intentionally does NOT touch the database — run `spine-framework migrate`
- * after init to apply SQL migrations via a direct Postgres connection.
- *
- * **Usage:**
- * ```bash
- * spine-framework init --url https://xyz.supabase.co --anon-key eyJ... --service-role-key eyJ...
- * spine-framework migrate --db-password <password>
- * ```
- */
-
-import type { Command } from 'commander'
-import { existsSync, mkdirSync, writeFileSync, cpSync } from 'fs'
-import { resolve, dirname } from 'path'
-import { fileURLToPath } from 'url'
-import { execSync } from 'child_process'
-
-const __filename = fileURLToPath(import.meta.url)
-const __dirname = dirname(__filename)
-const PROJECT_ROOT = process.cwd()
-// Package root: node_modules/spine-framework/ — 3 levels up from .framework/cli/commands/
-const PACKAGE_ROOT = resolve(__dirname, '../../..')
-
-interface InitOptions {
-  dryRun: boolean
-}
-
-function scaffoldCustomWorkspace(dryRun: boolean): void {
-  const dirs = [
-    'custom/apps',
-    'custom/functions',
-    'custom/components',
-    'custom/migrations',
-    'custom/tests',
-  ]
-
-  for (const dir of dirs) {
-    const fullPath = resolve(PROJECT_ROOT, dir)
-    if (existsSync(fullPath)) {
-      console.log(`  ⏭️  ${dir}/ already exists`)
-    } else if (dryRun) {
-      console.log(`  [dry-run] Would create: ${dir}/`)
-    } else {
-      mkdirSync(fullPath, { recursive: true })
-      writeFileSync(resolve(fullPath, '.gitkeep'), '')
-      console.log(`  ✓ Created ${dir}/`)
-    }
-  }
-}
-
-function writeEnvFile(dryRun: boolean): void {
-  const envPath = resolve(PROJECT_ROOT, '.env')
-
-  if (existsSync(envPath)) {
-    console.log('  ⏭️  .env already exists, skipping')
-    return
-  }
-
-  const envContent = [
-    '# ─── Supabase ────────────────────────────────────────────────────────────────',
-    '# Get these from: https://supabase.com/dashboard/project/_/settings/api',
-    'SUPABASE_URL=https://your-project.supabase.co',
-    'SUPABASE_ANON_KEY=your-anon-key',
-    'SUPABASE_SERVICE_ROLE_KEY=your-service-role-key',
-    '',
-    '# DB password for running migrations (direct Postgres connection)',
-    '# Get from: https://supabase.com/dashboard/project/_/settings/database',
-    'SUPABASE_DB_PASSWORD=your-db-password',
-    '',
-    '# ─── Vite / Frontend ─────────────────────────────────────────────────────────',
-    'VITE_SUPABASE_URL=https://your-project.supabase.co',
-    'VITE_SUPABASE_ANON_KEY=your-anon-key',
-    'VITE_APP_NAME=Spine',
-    '',
-    '# ─── OpenAI ──────────────────────────────────────────────────────────────────',
-    'OPENAI_API_KEY=your-openai-api-key',
-    '',
-    '# ─── App config ──────────────────────────────────────────────────────────────',
-    'DB_SCHEMA=public',
-  ].join('\n') + '\n'
-
-  if (dryRun) {
-    console.log('  [dry-run] Would write .env with placeholder values')
-    return
-  }
-
-  writeFileSync(envPath, envContent, 'utf8')
-  console.log('  ✓ Created .env')
-}
-
-function copyFrameworkFiles(dryRun: boolean): void {
-  // Directories and files to copy from the package root into the consumer project root
-  const items = [
-    { src: '.framework',     dest: '.framework'     },
-    { src: 'bin',            dest: 'bin'            },
-    { src: 'config',         dest: 'config'         },
-    { src: 'scripts',        dest: 'scripts'        },
-    { src: 'netlify.toml',   dest: 'netlify.toml'   },
-    { src: 'vitest.config.ts', dest: 'vitest.config.ts' },
-    { src: 'index.html',     dest: 'index.html'     },
-    { src: 'package-project.json', dest: 'package.json' },
-    { src: 'STRUCTURE.md',   dest: 'STRUCTURE.md'   },
-  ]
-
-  for (const item of items) {
-    const src  = resolve(PACKAGE_ROOT, item.src)
-    const dest = resolve(PROJECT_ROOT, item.dest)
-
-    if (!existsSync(src)) {
-      console.log(`  ⏭️  ${item.src} not found in package, skipping`)
-      continue
-    }
-
-    // Always overwrite package.json (npm creates a minimal one during install)
-    if (existsSync(dest) && item.dest !== 'package.json') {
-      console.log(`  ⏭️  ${item.dest} already exists, skipping`)
-      continue
-    }
-
-    if (dryRun) {
-      console.log(`  [dry-run] Would copy: ${item.src} → ./${item.dest}`)
-      continue
-    }
-
-    cpSync(src, dest, { recursive: true })
-    console.log(`  ✓ Copied ${item.dest}`)
-  }
-}
-
-async function initCommand(options: InitOptions): Promise<void> {
-  console.log('\n🚀 Spine Framework — Init\n')
-
-  // Step 1: Copy framework files to project root
-  console.log('📦 Step 1: Installing framework files...')
-  copyFrameworkFiles(options.dryRun)
-
-  // Step 2: Install dev dependencies (vite, netlify-cli)
-  if (!options.dryRun) {
-    console.log('\n📦 Step 2: Installing dev dependencies...')
-    try {
-      execSync('npm install', { stdio: 'inherit', cwd: PROJECT_ROOT })
-      console.log('  ✓ Dev dependencies installed')
-    } catch (err) {
-      console.log('  ⚠️  npm install failed — run manually: npm install')
-    }
-  }
-
-  // Step 3: Scaffold custom workspace
-  console.log('\n📁 Step 3: Scaffolding custom workspace...')
-  scaffoldCustomWorkspace(options.dryRun)
-
-  // Step 4: Write .env with placeholders
-  console.log('\n🔑 Step 4: Writing environment configuration...')
-  writeEnvFile(options.dryRun)
-
-  console.log('\n✅ Project initialized!')
-  console.log('\n   Next steps:')
-  console.log('   1. Fill in your Supabase credentials in .env')
-  console.log('      (get them from https://supabase.com/dashboard/project/_/settings/api)')
-  console.log('   2. Run: npx spine-framework migrate')
-  console.log('      (ensure SUPABASE_DB_PASSWORD is set in .env)')
-}
-
-export function registerInitCommands(program: Command) {
-  program
-    .command('init')
-    .description('Install framework files, scaffold custom/ workspace, and write .env template')
-    .option('--dry-run', 'Show what would happen without making changes', false)
-    .action(async (opts) => {
-      try {
-        await initCommand(opts)
-      } catch (err: any) {
-        console.error('Error:', err.message)
-        if (process.env.SPINE_CLI_DEBUG) console.error(err.stack)
-        process.exit(1)
-      }
-    })
-}