spine-framework 0.1.1 → 0.1.3

package/.framework/cli/index.ts

@@ -41,6 +41,21 @@
 
 import './env-loader.ts'
 import { Command } from 'commander'
+import { createRequire } from 'module'
+import { resolve, dirname } from 'path'
+import { fileURLToPath } from 'url'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+function printWelcome() {
+  const require = createRequire(import.meta.url)
+  try {
+    require(resolve(__dirname, '../../bin/welcome.cjs'))
+  } catch {
+    console.log('Spine Framework — run `spine-framework --help` for commands.')
+  }
+}
 
 const program = new Command()
 
@@ -100,6 +115,12 @@ registerInstallAppCommands(program)
 registerStatusCommands(program)
 registerUninstallAppCommands(program)
 
+// Show welcome when run with no arguments
+if (process.argv.length === 2) {
+  printWelcome()
+  process.exit(0)
+}
+
 program.parseAsync(process.argv).catch((err) => {
   console.error('Error:', err.message)
   process.exit(1)

package/bin/spine-framework.cjs

@@ -0,0 +1,14 @@
+#!/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, '../.framework/cli/index.ts')
+
+try {
+  execFileSync(tsx, [entry, ...process.argv.slice(2)], { stdio: 'inherit' })
+} catch (e) {
+  process.exit(e.status ?? 1)
+}

package/bin/welcome.cjs

@@ -0,0 +1,45 @@
+#!/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 lines = [
+  '',
+  '╭──────────────────────────────────────────────────────────────╮',
+  '│                                                              │',
+  '│   ███████╗██████╗ ██╗███╗   ██╗███████╗                    │',
+  '│   ██╔════╝██╔══██╗██║████╗  ██║██╔════╝                    │',
+  '│   ███████╗██████╔╝██║██╔██╗ ██║█████╗                      │',
+  '│   ╚════██║██╔═══╝ ██║██║╚██╗██║██╔══╝                      │',
+  '│   ███████║██║     ██║██║ ╚████║███████╗                    │',
+  '│   ╚══════╝╚═╝     ╚═╝╚═╝  ╚═══╝╚══════╝  Framework v0.1   │',
+  '│                                                              │',
+  '╰──────────────────────────────────────────────────────────────╯',
+  '',
+  '  Spine Framework installed successfully!',
+  '',
+  '  To complete setup you need a Supabase project.',
+  '  ─────────────────────────────────────────────',
+  '  If you have one already, run:',
+  '',
+  '    spine-framework init \\',
+  '      --url       https://<project>.supabase.co \\',
+  '      --anon-key  <anon-key> \\',
+  '      --service-role-key <service-role-key>',
+  '',
+  '  Your credentials are at:',
+  '  Supabase Dashboard → Your Project → Settings → API',
+  '',
+  '  ─────────────────────────────────────────────',
+  '  If you need a Supabase project, create one at:',
+  '  https://supabase.com/dashboard → New project',
+  '',
+  '  After init:',
+  '    spine-framework install-app <app-slug>   # optional apps',
+  '    npm run assemble && netlify dev           # start dev server',
+  '',
+  '  Docs: https://github.com/art-mojo-admin/spine',
+  '',
+]
+
+console.log(lines.join('\n'))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spine-framework",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "private": false,
   "description": "Spine — enterprise application framework built on Supabase + Netlify + React",
   "type": "module",
@@ -26,7 +26,7 @@
     "node": ">=18.0.0"
   },
   "bin": {
-    "spine-framework": "./.framework/cli/bin.cjs"
+    "spine-framework": "./bin/spine-framework.cjs"
   },
   "exports": {
     ".": {
@@ -47,9 +47,8 @@
     }
   },
   "files": [
+    "bin/",
     "dist/",
-    ".framework/cli/bin.cjs",
-    ".framework/cli/welcome.cjs",
     ".framework/cli/",
     ".framework/functions/",
     ".framework/migrations/",
@@ -82,7 +81,7 @@
     "test:integration": "vitest run .framework/tests/integration",
     "test:boundary": "bash scripts/boundary-check.sh",
     "test:custom": "vitest run custom/tests",
-    "postinstall": "node .framework/cli/welcome.cjs || true",
+    "postinstall": "node bin/welcome.cjs || true",
     "docs": "typedoc --config config/typedoc.json"
   },
   "dependencies": {