spine-framework 0.3.17 → 0.3.19

package/STRUCTURE.md

@@ -1,150 +0,0 @@
-# Spine Enterprise Directory Structure
-
-This document explains the directory layout for the Spine framework.
-
-## Overview
-
-```
-my-app/
-├── .framework/          # 🔒 CLI-managed framework code (read-only)
-├── custom/              # ✏️ Developer workspace (your code)
-├── .assembled/          # 🏗️ Build output (gitignored)
-├── config/              # ⚙️ Build tool configuration
-├── scripts/             # 🔧 Build automation
-├── archive/             # 📦 Historical artifacts
-├── docs/                # 📚 Documentation
-├── netlify.toml         # 🌐 Netlify configuration (must be at root)
-├── package.json         # Root package manifest
-└── STRUCTURE.md         # This file
-```
-
-## Directory Details
-
-### `.framework/` — Framework Core (Hidden)
-**Managed by:** Spine CLI (read-only)
-**Contains:**
-- `functions/` — Core Netlify function handlers
-- `src/` — Core React components (Admin shell, app router)
-- `migrations/` — Base database schema
-- `cli/` — Framework CLI tools
-- `tests/` — Core test suites
-
-**You should not edit files here.** The CLI manages updates to this directory.
-
-### `custom/` — Developer Workspace
-**Managed by:** You
-**Contains:**
-- `functions/` — Your custom Netlify function handlers
-- `apps/` — Your applications (one folder per app)
-- `components/` — Shared UI components across your apps
-- `migrations/` — Your database schema changes
-- `tests/` — Your test suites
-
-**This is where you build your product.** Everything here is yours.
-
-### `.assembled/` — Build Output (Hidden, Gitignored)
-**Generated by:** Assembly scripts
-**Contains:**
-- `netlify/functions/` — Merged: `.framework/functions` + `custom/functions`
-- `src/` — Merged: `.framework/src` + `custom/apps/*`
-
-**Never edit files here.** This is rebuilt on every `netlify dev` or deployment.
-
-### `config/` — Build Tool Configuration
-**Contains:**
-- `vite.config.ts` — Vite build configuration
-- `tsconfig.json` — TypeScript configuration
-- `tailwind.config.ts` — Styling configuration
-- `postcss.config.js` — CSS processing
-
-### `netlify.toml` — Netlify Configuration (Root)
-**Must be at project root** (Netlify CLI requirement)
-- Functions path: `.assembled/netlify/functions/`
-- Dev server settings: port 3001 (Vite) → 8888 (Netlify proxy)
-
-### `scripts/` — Build Automation
-**Contains:**
-- Assembly scripts that merge `.framework/` + `custom/` → `.assembled/`
-- Verification scripts for integrity checking
-
-### `archive/` — Historical Artifacts
-**Contains:**
-- Old audit documents
-- Completed project reports
-- Test artifacts
-
-## Assembly Flow
-
-```bash
-Development:
-  .framework/ + custom/  ──►  scripts/assemble.sh  ──►  .assembled/
-                                                      ──►  netlify dev
-
-Production:
-  .framework/ + custom/  ──►  scripts/assemble.sh  ──►  .assembled/
-                                                      ──►  Netlify deploy
-```
-
-## Path Aliases
-
-After assembly, code uses these aliases:
-- `@core` → `.framework/src/`
-- `@custom` → `custom/apps/`
-
-## Adding New Code
-
-### New App
-```bash
-mkdir custom/apps/my-app
-cd custom/apps/my-app
-# Create src/, components/, pages/
-```
-
-### New Function
-```bash
-touch custom/functions/my-handler.ts
-# Edit with your logic
-```
-
-### New Migration
-```bash
-touch custom/migrations/101_my_change.sql
-# Write ALTER TABLE statements
-```
-
-## Updating Framework
-
-```bash
-spine-framework update
-# CLI updates .framework/ to latest version
-# Your custom/ code is untouched
-```
-
-## Important Rules
-
-1. **Never edit `.framework/`** — use `custom/` instead
-2. **Never commit `.assembled/`** — it's in `.gitignore`
-3. **Always use assembly** — don't manually copy to `.assembled/`
-4. **Test after update** — run `netlify dev` after `spine-framework update`
-
-## Troubleshooting
-
-### "Where do I put X?"
-- Framework extension → `.framework/` (via CLI or PR)
-- Custom business logic → `custom/`
-- App-specific code → `custom/apps/{app-name}/`
-
-### "Assembly failed"
-1. Check both `.framework/` and `custom/` exist
-2. Verify no duplicate function names
-3. Run `scripts/assemble.sh` manually for error details
-
-### "Functions not found"
-1. Check `.assembled/netlify/functions/` exists
-2. Verify `netlify.toml` (in project root) points to correct path
-3. Ensure assembly ran without errors
-
-### "Netlify dev can't connect"
-1. Check Vite is running on port 3001
-2. Verify `netlify.toml` is in project root (not config/)
-3. Check `targetPort = 3001` in netlify.toml [dev] section

package/bin/spine-framework.cjs

@@ -1,62 +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 fs = require('fs')
-
-const pkgRoot = resolve(__dirname, '..')
-const projectRoot = resolve(pkgRoot, '../..')
-
-// Handle no-args case here — before spawning tsx or loading db.ts
-if (process.argv.length === 2) {
-  require(resolve(__dirname, 'welcome.cjs'))
-  process.exit(0)
-}
-
-// Pre-parse credential flags and load .env so db.ts sees env vars at module load time.
-// tsx evaluates db.ts before Commander parses args, so we must inject here.
-const args = process.argv.slice(2)
-const childEnv = { ...process.env }
-
-// Load .env from the consumer project root (process.cwd())
-const dotenvPath = resolve(process.cwd(), '.env')
-if (fs.existsSync(dotenvPath)) {
-  const lines = fs.readFileSync(dotenvPath, 'utf8').split('\n')
-  for (const line of lines) {
-    const trimmed = line.trim()
-    if (!trimmed || trimmed.startsWith('#')) continue
-    const eq = trimmed.indexOf('=')
-    if (eq === -1) continue
-    const key = trimmed.slice(0, eq).trim()
-    const val = trimmed.slice(eq + 1).trim()
-    if (key && !(key in childEnv)) childEnv[key] = val
-  }
-}
-
-// CLI flags override .env values
-for (let i = 0; i < args.length; i++) {
-  if (args[i] === '--url' && args[i + 1])               childEnv.SUPABASE_URL = args[++i]
-  if (args[i] === '--anon-key' && args[i + 1])          childEnv.SUPABASE_ANON_KEY = args[++i]
-  if (args[i] === '--service-role-key' && args[i + 1])  childEnv.SUPABASE_SERVICE_ROLE_KEY = args[++i]
-}
-
-const entry = resolve(pkgRoot, 'bin/ws-shim.ts')
-
-// Find tsx: prefer consuming project's copy, fall back to our own
-const tsxPaths = [
-  resolve(projectRoot, 'node_modules/.bin/tsx'),
-  resolve(pkgRoot, 'node_modules/.bin/tsx'),
-]
-const tsx = tsxPaths.find(p => { try { fs.accessSync(p); return true } catch { return false } })
-
-if (!tsx) {
-  console.error('spine-framework: tsx not found. Run: npm install tsx')
-  process.exit(1)
-}
-
-try {
-  execFileSync(tsx, [entry, ...process.argv.slice(2)], { stdio: 'inherit', env: childEnv })
-} catch (e) {
-  process.exit(e.status ?? 1)
-}

package/bin/welcome.cjs

@@ -1,58 +0,0 @@
-#!/usr/bin/env node
-// Postinstall welcome message — runs automatically after npm install spine-framework.
-// Tells the agent (or developer) exactly what to do next.
-// Uses only Node built-ins — no dependencies.
-
-const path = require('path')
-const fs = require('fs')
-
-let version = '0.x'
-try {
-  const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8'))
-  version = pkg.version || version
-} catch { /* ignore */ }
-
-const versionLabel = ('Framework v' + version).padEnd(14)
-
-const lines = [
-  '',
-  '╭──────────────────────────────────────────────────────────────╮',
-  '│                                                              │',
-  '│   ███████╗██████╗ ██╗███╗   ██╗███████╗                    │',
-  '│   ██╔════╝██╔══██╗██║████╗  ██║██╔════╝                    │',
-  '│   ███████╗██████╔╝██║██╔██╗ ██║█████╗                      │',
-  '│   ╚════██║██╔═══╝ ██║██║╚██╗██║██╔══╝                      │',
-  '│   ███████║██║     ██║██║ ╚████║███████╗                    │',
-  `│   ╚══════╝╚═╝     ╚═╝╚═╝  ╚═══╝╚══════╝  ${versionLabel}│`,
-  '│                                                              │',
-  '╰──────────────────────────────────────────────────────────────╯',
-  '',
-  '  Spine Framework installed successfully!',
-  '',
-  '  Next steps:',
-  '  ─────────────────────────────────────────────',
-  '  1. Run init to scaffold the project:',
-  '',
-  '       npx spine-framework init',
-  '',
-  '  2. Fill in your Supabase credentials in .env',
-  '     (get them from Supabase Dashboard → Project → Settings → API)',
-  '',
-  '  3. Apply database migrations:',
-  '',
-  '       npx spine-framework migrate',
-  '',
-  '  4. Install apps (optional):',
-  '',
-  '       npx spine-framework install-app spine-framework-cortex@latest',
-  '       npx spine-framework install-app spine-framework-portal@latest',
-  '',
-  '  5. Start the dev server:',
-  '',
-  '       npm run assemble && netlify dev',
-  '',
-  '  Docs: https://github.com/spine-framework/spine-framework',
-  '',
-]
-
-console.log(lines.join('\n'))

package/bin/ws-shim.ts

@@ -1,10 +0,0 @@
-// Entry point for the CLI on Node < 22.
-// Sets globalThis.WebSocket before any supabase-js module is imported,
-// preventing the "Node.js 20 detected without native WebSocket" crash.
-import { WebSocket } from 'ws'
-if (typeof globalThis.WebSocket === 'undefined') {
-  ;(globalThis as any).WebSocket = WebSocket
-}
-
-// Now import the real CLI — all supabase createClient() calls happen after this point
-await import('../.framework/cli/index.ts')

package/config/components.json

@@ -1,25 +0,0 @@
-{
-  "$schema": "https://ui.shadcn.com/schema.json",
-  "style": "radix-mira",
-  "rsc": false,
-  "tsx": true,
-  "tailwind": {
-    "config": "tailwind.config.ts",
-    "css": "src/v2-assembled/index.css",
-    "baseColor": "zinc",
-    "cssVariables": true,
-    "prefix": ""
-  },
-  "iconLibrary": "lucide",
-  "rtl": false,
-  "aliases": {
-    "components": "@/components",
-    "utils": "@/lib/utils",
-    "ui": "@/components/ui",
-    "lib": "@/lib",
-    "hooks": "@/hooks"
-  },
-  "menuColor": "default",
-  "menuAccent": "subtle",
-  "registries": {}
-}

package/config/deno.lock

@@ -1,108 +0,0 @@
-{
-  "version": "5",
-  "remote": {
-    "https://edge.netlify.com/": "fd941d61d88673d5f28aab283fb86fcc50f08a3bc80ee5470498fcfa88c65cfb",
-    "https://edge.netlify.com/bootstrap/config.ts": "6a2ce0e544e15e8f8883a5c18da5948e37fd0f2619f68cb31f3af53c51817025",
-    "https://edge.netlify.com/bootstrap/context.ts": "e97240232121e2f369f6546ce961490f34d961ea1ea54be3ff09633e3f08373f",
-    "https://edge.netlify.com/bootstrap/cookie.ts": "8b0baae708989ca183c6f3b4ab3d029e6abcbc2e43f93edeb0ff447b3bbc3a05",
-    "https://edge.netlify.com/bootstrap/edge_function.ts": "b8253e86aa83c67341f5cfedeba5049d77fbf84dcab7eceff7566b7728ae9b39",
-    "https://edge.netlify.com/bootstrap/globals/types.ts": "eaa6148ded3121d8dee62dd91c86e7fe76601df0f3ca8d7962243a30f4c8935f"
-  },
-  "workspace": {
-    "packageJson": {
-      "dependencies": [
-        "npm:@base-ui/react@^1.4.1",
-        "npm:@fontsource-variable/inter@^5.2.8",
-        "npm:@heroicons/react@^2.2.0",
-        "npm:@netlify/functions@^2.8.2",
-        "npm:@radix-ui/react-accordion@^1.2.12",
-        "npm:@radix-ui/react-avatar@^1.1.3",
-        "npm:@radix-ui/react-dialog@^1.1.6",
-        "npm:@radix-ui/react-dropdown-menu@^2.1.6",
-        "npm:@radix-ui/react-icons@^1.3.2",
-        "npm:@radix-ui/react-label@^2.1.2",
-        "npm:@radix-ui/react-popover@^1.1.6",
-        "npm:@radix-ui/react-select@^2.1.6",
-        "npm:@radix-ui/react-separator@^1.1.2",
-        "npm:@radix-ui/react-slider@^1.3.6",
-        "npm:@radix-ui/react-slot@^1.1.2",
-        "npm:@radix-ui/react-switch@^1.1.3",
-        "npm:@radix-ui/react-tabs@^1.1.3",
-        "npm:@radix-ui/react-toast@^1.2.6",
-        "npm:@radix-ui/react-tooltip@^1.1.8",
-        "npm:@supabase/supabase-js@^2.49.1",
-        "npm:@tailwindcss/typography@~0.5.19",
-        "npm:@tanstack/react-query@^5.95.2",
-        "npm:@tiptap/extension-code-block-lowlight@^3.20.0",
-        "npm:@tiptap/extension-image@^3.20.0",
-        "npm:@tiptap/extension-link@^3.20.0",
-        "npm:@tiptap/extension-placeholder@^3.20.0",
-        "npm:@tiptap/extension-table-cell@^3.20.0",
-        "npm:@tiptap/extension-table-header@^3.20.0",
-        "npm:@tiptap/extension-table-row@^3.20.0",
-        "npm:@tiptap/extension-table@^3.20.0",
-        "npm:@tiptap/extension-youtube@^3.20.0",
-        "npm:@tiptap/pm@^3.20.0",
-        "npm:@tiptap/react@^3.20.0",
-        "npm:@tiptap/starter-kit@^3.20.0",
-        "npm:@types/node@^22.12.0",
-        "npm:@types/react-dom@^18.3.5",
-        "npm:@types/react-grid-layout@^1.3.6",
-        "npm:@types/react@^18.3.18",
-        "npm:@vitejs/plugin-react@^4.3.4",
-        "npm:@xyflow/react@^12.10.1",
-        "npm:ajv@^8.12.0",
-        "npm:autoprefixer@^10.4.20",
-        "npm:class-variance-authority@~0.7.1",
-        "npm:clsx@^2.1.1",
-        "npm:cmdk@^1.1.1",
-        "npm:commander@12",
-        "npm:dagre@~0.8.5",
-        "npm:date-fns@^4.1.0",
-        "npm:embla-carousel-react@^8.6.0",
-        "npm:framer-motion@^12.34.3",
-        "npm:github-markdown-css@^5.9.0",
-        "npm:highlight.js@^11.11.1",
-        "npm:input-otp@^1.4.2",
-        "npm:js-yaml@^4.1.0",
-        "npm:jsonwebtoken@^9.0.3",
-        "npm:jwt-decode@4",
-        "npm:lowlight@^3.3.0",
-        "npm:lucide-react@^1.14.0",
-        "npm:marked@^17.0.3",
-        "npm:mermaid@^11.12.3",
-        "npm:next-themes@~0.4.6",
-        "npm:postcss@^8.5.1",
-        "npm:radix-ui@^1.4.3",
-        "npm:react-day-picker@10",
-        "npm:react-dom@^18.3.1",
-        "npm:react-grid-layout@^2.2.2",
-        "npm:react-is@^19.2.4",
-        "npm:react-markdown@^10.1.0",
-        "npm:react-refresh@0.14",
-        "npm:react-resizable-panels@^4.11.0",
-        "npm:react-router-dom@^6.28.1",
-        "npm:react@^18.3.1",
-        "npm:recharts@3.8.0",
-        "npm:rehype-autolink-headings@^7.1.0",
-        "npm:rehype-raw@7",
-        "npm:rehype-sanitize@6",
-        "npm:rehype-slug@6",
-        "npm:remark-gfm@^4.0.1",
-        "npm:shadcn@^4.7.0",
-        "npm:sonner@^2.0.7",
-        "npm:tailwind-merge@^3.5.0",
-        "npm:tailwindcss-animate@^1.0.7",
-        "npm:tailwindcss@^3.4.17",
-        "npm:tiptap-markdown@0.9",
-        "npm:tsx@^4.21.0",
-        "npm:tw-animate-css@^1.4.0",
-        "npm:typedoc@0.27",
-        "npm:typescript@~5.6.2",
-        "npm:vaul@^1.1.2",
-        "npm:vite@^6.0.11",
-        "npm:vitest@^2.1.9"
-      ]
-    }
-  }
-}