spine-framework 0.3.3 → 0.3.5

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

@@ -127,8 +127,23 @@ function copyFrameworkFiles(dryRun: boolean): void {
     }
 
     if (existsSync(dest)) {
-      console.log(`  ⏭️  ${item.dest} already exists, skipping`)
-      continue
+      // For package.json: only skip if it already has scripts (i.e. it's a real project package.json)
+      // A bare stub created by `npm install` has no scripts and should be overwritten
+      if (item.template) {
+        try {
+          const existing = JSON.parse(readFileSync(dest, 'utf8'))
+          if (existing.scripts && Object.keys(existing.scripts).length > 0) {
+            console.log(`  ⏭️  ${item.dest} already exists, skipping`)
+            continue
+          }
+          // Fall through — bare stub, overwrite it
+        } catch {
+          // Unparseable — overwrite it
+        }
+      } else {
+        console.log(`  ⏭️  ${item.dest} already exists, skipping`)
+        continue
+      }
     }
 
     if (dryRun) {

package/README.md

@@ -0,0 +1,129 @@
+# Spine Framework
+
+**We're building Spine in the open.** The source is visible, the roadmap is public, and we share what we learn along the way. That said, Spine is not open source — commercial use requires a license. See [LICENSE.md](./LICENSE.md) for details.
+
+---
+
+Spine is an enterprise application framework for agentic IDEs. It gives Windsurf, Cursor, and other AI coding tools a production-ready backend to build on — multi-tenant data model, auth, roles, permissions, Netlify functions, and a CLI for installation and app management.
+
+You bring the use case. Spine brings the infrastructure.
+
+## Requirements
+
+- Node.js 18+
+- A [Supabase](https://supabase.com) project
+- [Netlify CLI](https://docs.netlify.com/cli/get-started/) (`npm install -g netlify-cli`)
+
+## Getting Started
+
+### 1. Install Spine
+
+In a new empty directory:
+
+```bash
+npm install spine-framework@latest
+```
+
+### 2. Initialize the project
+
+```bash
+npx spine-framework init
+```
+
+This scaffolds the project structure, writes a full `package.json`, and creates a `.env` file for your Supabase credentials.
+
+### 3. Add your Supabase credentials
+
+Edit `.env`:
+
+```
+SUPABASE_URL=https://<project>.supabase.co
+SUPABASE_ANON_KEY=<anon-key>
+SUPABASE_SERVICE_ROLE_KEY=<service-role-key>
+SUPABASE_DB_PASSWORD=<db-password>
+```
+
+Get these from **Supabase Dashboard → Your Project → Settings → API**.
+
+### 4. Run migrations
+
+```bash
+npx spine-framework migrate
+```
+
+Applies the foundation schema and seed data to your Supabase project.
+
+### 5. Install apps (optional)
+
+```bash
+npx spine-framework install-app spine-framework-portal@latest
+npx spine-framework install-app spine-framework-cortex@latest
+```
+
+### 6. Start the dev server
+
+```bash
+npm run assemble && netlify dev
+```
+
+## CLI Reference
+
+```
+npx spine-framework <command>
+
+Commands:
+  init              Scaffold a new Spine project
+  migrate           Apply database migrations
+  install-app       Install a Spine app from npm
+  uninstall-app     Remove an installed app
+  update-app        Update an installed app to a newer version
+  status            Show installed apps and framework version
+  migrate           Run pending migrations
+```
+
+Run `npx spine-framework <command> --help` for options on any command.
+
+## Project Structure
+
+After `init`, your project will look like this:
+
+```
+.framework/        # Framework internals (do not edit)
+  cli/             # CLI commands
+  config/          # Framework configuration
+  functions/       # Netlify function handlers
+  migrations/      # SQL migrations
+  src/             # React components and core UI
+bin/               # CLI entry point
+config/            # Vite, Tailwind, TypeScript config
+scripts/           # Assembly scripts
+custom/            # Your code lives here
+  apps/            # Custom or installed apps
+  functions/       # Custom Netlify functions
+  components/      # Custom React components
+  migrations/      # Custom SQL migrations
+  tests/           # Custom tests
+.env               # Supabase credentials (not committed)
+```
+
+## Apps
+
+Spine apps are npm packages. Install them with the CLI:
+
+```bash
+npx spine-framework install-app spine-framework-portal@latest
+```
+
+Each app seeds its own roles, types, and configuration into your database and integrates with the Spine navigation and permission system.
+
+## License
+
+Spine Framework is **source-available, free for internal use**. Commercial use — including SaaS, resale, managed services, and white-labeling — requires a separate commercial license.
+
+See [LICENSE.md](./LICENSE.md) for full terms.
+
+For commercial licensing: [spine-framework.com](https://spine-framework.com) · webmaster@spine-framework.com
+
+---
+
+Copyright © 2026 Dahl Ventures Inc. All rights reserved.

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

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../.framework/cli/commands/init.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAuKxC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAcpD"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../.framework/cli/commands/init.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAsLxC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAcpD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spine-framework",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "private": false,
   "description": "Spine — enterprise application framework built on Supabase + Netlify + React",
   "type": "module",