spine-framework 0.3.49 → 0.3.51

package/.framework/migrations/003_system_data.sql

@@ -128,7 +128,8 @@ BEGIN
     '{}'::jsonb,
     'pack',
     true
-  );
+  )
+
   ON CONFLICT (app_id, kind, slug) DO NOTHING;
 
   -- 2. MASTER SYSTEM ACCOUNT (inserted here to satisfy FK on type_id)
@@ -189,7 +190,8 @@ BEGIN
     '{}'::jsonb,
     'pack',
     true
-  );
+  )
+
   ON CONFLICT (app_id, kind, slug) DO NOTHING;
 
   -- 5.3 items type
@@ -232,7 +234,8 @@ BEGIN
     '{}'::jsonb,
     'pack',
     true
-  );
+  )
+
   ON CONFLICT (app_id, kind, slug) DO NOTHING;
 
   -- 5.4 threads type
@@ -277,7 +280,8 @@ BEGIN
     '{}'::jsonb,
     'pack',
     true
-  );
+  )
+
   ON CONFLICT (app_id, kind, slug) DO NOTHING;
 
   -- 5.5 messages type
@@ -321,7 +325,8 @@ BEGIN
     '{}'::jsonb,
     'pack',
     true
-  );
+  )
+
   ON CONFLICT (app_id, kind, slug) DO NOTHING;
 
   -- 5.6 links type
@@ -365,7 +370,8 @@ BEGIN
     '{}'::jsonb,
     'pack',
     true
-  );
+  )
+
   ON CONFLICT (app_id, kind, slug) DO NOTHING;
 
   -- 5.7 attachments type
@@ -410,7 +416,8 @@ BEGIN
     '{}'::jsonb,
     'pack',
     true
-  );
+  )
+
   ON CONFLICT (app_id, kind, slug) DO NOTHING;
 
   -- 5.8 watchers type
@@ -455,7 +462,8 @@ BEGIN
     '{}'::jsonb,
     'pack',
     true
-  );
+  )
+
   ON CONFLICT (app_id, kind, slug) DO NOTHING;
 
   -- Update the spine-system account with the actual accounts type_id

package/README.md

@@ -1,254 +1,192 @@
-Spine Framework
-A complete enterprise application framework built on Supabase + Netlify + React for building scalable multi-tenant applications with extensible app ecosystems.
-
-Overview
-Spine Framework is a complete, runnable framework that provides everything you need to build enterprise applications:
-
-Multi-tenant Architecture: Support for tenant hierarchies and isolated deployments
-Role-Based Access Control: Fine-grained permissions and authorization
-App Ecosystem: Install and manage custom applications
-Real-time Features: Built-in support for real-time collaboration and notifications
-AI Integration: Native support for AI agents and intelligent workflows
-Developer Tools: Comprehensive tooling for development, testing, and deployment
-Quick Start
-Prerequisites
-Node.js 18+
-PostgreSQL database (via Supabase recommended)
-Netlify account (for deployment)
-Installation
-# Clone the framework
-git clone https://github.com/spine-framework/spine-framework.git
-cd spine-framework
+# Spine Framework
 
-# Install dependencies
-npm install
+A complete enterprise application platform built on Supabase + Netlify + React for building scalable multi-tenant SaaS applications with an extensible app ecosystem.
 
-# Set up environment
-cp .env.example .env
-# Edit .env with your Supabase and Netlify credentials
+---
 
-# Start development
-npm run dev
-Install Custom Apps
-# Install Cortex (CRM, Support, Community, Knowledge Base)
-npm run app-install cortex
-
-# Install Customer Portal
-npm run app-install customer-portal
-
-# List available apps
-npm run spine-framework list-apps
-Architecture
-Core Components
-Framework Core: Base functionality, authentication, and data models
-App Registry: System for managing and distributing applications
-Multi-tenant Engine: Tenant isolation and hierarchy management
-Authorization Layer: Role-based permissions and access control
-Real-time Infrastructure: WebSocket support and live updates
-AI Agent System: Integration with AI services and workflows
-App Ecosystem
-Spine Framework supports a growing ecosystem of applications:
-
-Cortex: CRM, Support, Community, and Knowledge Base
-Customer Portal: Self-service customer portal
-Custom Apps: Build your own applications using the framework
-Database Schema
-The framework uses a clean, normalized schema with:
-
-Accounts & Tenants: Multi-tenant hierarchy support
-People & Roles: User management and permissions
-Items & Threads: Flexible data modeling system
-Apps & Integrations: Extensible app registry
-AI Agents: Intelligent workflow automation
-Development
-Project Structure
-my-spine-project/
-├── src/
-│   ├── components/         # Reusable UI components
-│   ├── pages/             # Application pages
-│   ├── hooks/             # Custom React hooks
-│   ├── contexts/          # React contexts
-│   └── utils/             # Utility functions
-├── functions/             # Serverless functions
-├── migrations/            # Database migrations
-├── custom/                # Custom app extensions
-└── docs/                  # Documentation
-Building Apps
-Create custom applications using the Spine Framework:
-
-// src/apps/my-app/index.tsx
-import { AppLayout, useCurrentApp } from '@spine-framework/core'
+## Quick Start
+
+### Prerequisites
+
+- Node.js 18+
+- A [Supabase](https://supabase.com) project
+- A [Netlify](https://netlify.com) account
+
+### 1. Create a new project
+
+```bash
+mkdir my-app && cd my-app
+npm install spine-framework
+npx spine-framework init
+```
+
+This scaffolds the full project structure, copies all framework files, and writes a `.env` template.
+
+### 2. Configure your environment
+
+Edit `.env` with your Supabase credentials:
+
+```env
+SUPABASE_URL=https://your-project.supabase.co
+SUPABASE_ANON_KEY=your-anon-key
+SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
+SUPABASE_DB_PASSWORD=your-database-password
+```
+
+Get these from your [Supabase dashboard](https://supabase.com/dashboard/project/_/settings/api).  
+`SUPABASE_DB_PASSWORD` is under **Settings → Database**.
+
+### 3. Apply database migrations
+
+```bash
+npx spine-framework migrate
+```
+
+This creates all tables, RLS policies, functions, and seeds system data. Safe to re-run on an existing project — migrations are idempotent.
+
+### 4. Start the development server
+
+```bash
+npm install && npm run assemble && netlify dev
+```
+
+Your app is now running at `http://localhost:8888`.
+
+---
+
+## CLI Reference
+
+All commands run via `npx spine-framework <command>`.
+
+| Command | Description |
+|---------|-------------|
+| `init` | Scaffold a new project in the current directory |
+| `migrate` | Apply framework SQL migrations to your Supabase project |
+| `migrate --dry-run` | Preview pending migrations without applying |
+| `migrate --db-password <pw>` | Pass DB password directly instead of reading from `.env` |
+| `status` | Show installed apps and framework version |
+
+---
+
+## Project Structure
+
+After `init`, your project looks like this:
+
+```
+my-app/
+├── .env                        # Your credentials (never commit this)
+├── .framework/                 # Framework core (do not edit)
+│   ├── cli/                    # CLI commands
+│   ├── functions/              # Serverless API functions
+│   ├── migrations/             # SQL migrations
+│   ├── src/                    # React frontend core
+│   └── scripts/                # Build scripts
+├── custom/                     # Your custom apps and extensions
+│   └── apps/                   # App packages go here
+├── config/                     # Vite, TypeScript, Tailwind config
+├── scripts/                    # Project-level build scripts
+├── netlify.toml                # Netlify configuration
+└── package.json
+```
 
+---
+
+## Architecture
+
+- **Multi-tenant**: Account hierarchy with inherited access and RLS-enforced isolation
+- **Role-based access control**: Fine-grained permissions via database-enforced policies
+- **App ecosystem**: Install, manage, and build custom applications on the framework
+- **Serverless API**: Netlify Functions handle all backend logic
+- **Real-time**: Supabase Realtime for live updates
+- **AI integration**: Native support for AI agents and pipeline automation
+
+### Database Schema
+
+| Table group | Tables |
+|-------------|--------|
+| Identity | `accounts`, `people`, `roles` |
+| Runtime | `items`, `threads`, `messages`, `links`, `attachments`, `watchers` |
+| Apps | `apps`, `types`, `pipelines`, `triggers` |
+| AI | `ai_agents`, `embeddings`, `prompt_configs` |
+| System | `api_keys`, `logs`, `integrations`, `timers` |
+
+---
+
+## Building Custom Apps
+
+Create your own applications and place them in `custom/apps/`:
+
+```tsx
+// custom/apps/my-app/index.tsx
 export default function MyApp() {
-  const app = useCurrentApp()
-  
-  return (
-    <AppLayout>
-      <h1>{app.name}</h1>
-      {/* Your app content */}
-    </AppLayout>
-  )
+  return <div>Hello from My App</div>
 }
-Database Extensions
-Add custom database schema:
-
--- migrations/001_my_app.sql
-CREATE TABLE my_app_data (
-  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-  account_id UUID REFERENCES accounts(id),
-  title TEXT NOT NULL,
-  created_at TIMESTAMPTZ DEFAULT now()
+```
+
+Add custom database migrations in `custom/migrations/`:
+
+```sql
+-- custom/migrations/001_my_app.sql
+CREATE TABLE IF NOT EXISTS my_app_records (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  account_id uuid NOT NULL REFERENCES public.accounts(id),
+  title text NOT NULL,
+  created_at timestamptz DEFAULT now()
 );
 
--- Enable RLS
-ALTER TABLE my_app_data ENABLE ROW LEVEL SECURITY;
-Configuration
-Environment Variables
-# Database
-DATABASE_URL=postgresql://...
+ALTER TABLE my_app_records ENABLE ROW LEVEL SECURITY;
+```
 
-# Supabase
-SUPABASE_URL=your-project.supabase.co
-SUPABASE_ANON_KEY=your-anon-key
-SUPABASE_SERVICE_ROLE_KEY=your-service-key
-
-# Framework
-SPINE_ENV=development
-SPINE_LOG_LEVEL=info
-Framework Configuration
-// spine.config.ts
-export default {
-  database: {
-    url: process.env.DATABASE_URL,
-    poolSize: 10,
-  },
-  auth: {
-    providers: ['email', 'github', 'google'],
-    sessionTimeout: '24h',
-  },
-  apps: {
-    registry: 'https://registry.spine-framework.com',
-    autoUpdate: true,
-  },
-  ai: {
-    provider: 'openai',
-    model: 'gpt-4',
-  }
-}
-Deployment
-Development
-# Start development server
-npm run dev
+Custom migrations are picked up automatically by `npx spine-framework migrate`.
+
+---
 
-# Run tests
-npm test
+## Environment Variables
 
-# Type checking
-npm run type-check
-Production
-# Build for production
-npm run build
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `SUPABASE_URL` | Yes | Your Supabase project URL |
+| `SUPABASE_ANON_KEY` | Yes | Supabase anon/public key |
+| `SUPABASE_SERVICE_ROLE_KEY` | Yes | Supabase service role key (server-side only) |
+| `SUPABASE_DB_PASSWORD` | Yes (migrate) | Postgres database password |
 
-# Deploy to Netlify
+---
+
+## Deployment
+
+```bash
+# Build and deploy to Netlify
+npm run assemble
 netlify deploy --prod
+```
+
+---
+
+## Contributing
 
-# Or deploy to your preferred platform
-Database Migrations
-# Run migrations
-npx spine migrate up
-
-# Create new migration
-npx spine migrate create add_new_feature
-
-# Rollback migration
-npx spine migrate down
-Available Apps
-Official Apps
-spine-framework-cortex
-
-CRM, Support, Community, Knowledge Base
-npm install spine-framework-cortex
-spine-framework-portal
-
-Customer self-service portal
-npm install spine-framework-portal
-Installing Apps
-# Install an app
-npx spine install-app cortex
-
-# List available apps
-npx spine list-apps
-
-# Update an app
-npx spine update-app cortex
-API Reference
-Core Hooks
-// Authentication
-import { useAuth, useUser } from '@spine-framework/core'
-
-// App Management
-import { useApps, useCurrentApp } from '@spine-framework/core'
-
-// Data Management
-import { useItems, useThreads } from '@spine-framework/core'
-
-// Real-time
-import { useWebSocket } from '@spine-framework/core'
-Database Functions
--- Get account apps
-SELECT * FROM get_account_apps(account_id, true, false);
-
--- Get accessible accounts
-SELECT * FROM get_accessible_accounts(user_id);
-
--- Check permissions
-SELECT * FROM has_permission(user_id, 'action', 'resource');
-Contributing
-Development Setup
-# Clone the repository
+```bash
 git clone https://github.com/spine-framework/spine-framework.git
 cd spine-framework
-
-# Install dependencies
 npm install
-
-# Start development
 npm run dev
-Submitting Changes
-Fork the repository
-Create a feature branch
-Make your changes
-Add tests
-Submit a pull request
-Building Apps for Distribution
-If you want to contribute an app to the ecosystem:
-
-Create your app using the framework
-Follow the app structure guidelines
-Include comprehensive documentation
-Submit for review
-License
-This framework is licensed under the Spine Framework Internal Use License.
-
-✅ Free for internal business use
-❌ Commercial redistribution requires separate license
-📞 Contact: spine-framework.com for commercial licensing
-Support
-Documentation: docs.spine-framework.com
-Issues: GitHub Issues
-Community: Discord Server
-Commercial: Contact Us
-Version History
-v1.0.0
-Initial release
-Multi-tenant architecture
-App registry system
-Role-based access control
-Real-time features
-AI integration
-Roadmap
-v1.1: Enhanced AI capabilities
-v1.2: Advanced analytics and reporting
-v1.3: Mobile app support
-v2.0: Microservices architecture
-Spine Framework - Build enterprise applications with confidence.
+```
+
+See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for internals and [docs/APPS.md](docs/APPS.md) for the app development guide.
+
+---
+
+## License
+
+Licensed under the [Spine Framework Internal Use License](LICENSE.md).
+
+- Free for internal business use
+- Commercial redistribution requires a separate license
+- Contact [spine-framework.com](https://spine-framework.com) for commercial licensing
+
+---
+
+## Support
+
+- Documentation: [docs.spine-framework.com](https://docs.spine-framework.com)
+- Issues: [GitHub Issues](https://github.com/spine-framework/spine-framework/issues)
+- Commercial: [spine-framework.com](https://spine-framework.com)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spine-framework",
-  "version": "0.3.49",
+  "version": "0.3.51",
   "description": "Multi-tenant, modular application platform for modern SaaS systems",
   "type": "module",
   "bin": {