@alashi/cli 0.8.0 → 0.8.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alashi/cli",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "alashi host: install, manage, and run Claude Code-powered apps",
   "type": "module",
   "license": "MIT",
@@ -29,14 +29,14 @@
     "templates"
   ],
   "dependencies": {
-    "@alashi/apps-sdk": "^0.5.0",
+    "@alashi/apps-sdk": "^0.6.0",
     "@hono/node-server": "^2.1.1",
     "commander": "^14.0.0",
     "croner": "^10.0.1",
     "hono": "^4.13.2",
     "semver": "^7.8.5",
     "zod": "^4.4.3",
-    "@alashi/provider-claude": "^0.2.0"
+    "@alashi/provider-claude": "^0.2.1"
   },
   "devDependencies": {
     "@types/node": "^26.2.0",

package/templates/basic-app/AGENTS.md

@@ -29,13 +29,22 @@ Beside the manifest: `routes` (fetch-style `(Request, ctx) => Response`) and
 `jobHandlers` (`{ [name]: (ctx) => Promise<void> }`).
 
 Known gap: `onInstall`/`onUpdate` exist in the SDK but the host never calls
-them — create DB schema lazily (`CREATE TABLE IF NOT EXISTS` on first open).
+them — so nothing runs at install time and the app owns its own schema. Schema
+lives in ordered `.sql` files in `migrations/` (`001-init.sql`,
+`002-add-....sql`), applied by `runMigrations(db, join(import.meta.dirname,
+'migrations'))` every time the DB is opened. It is forward-only and tracked in
+`PRAGMA user_version`: a schema change is **a new numbered file**, never an
+edit to one that has already been applied, and there are no down-migrations.
+Statements that cannot run inside a transaction — notably
+`PRAGMA journal_mode = WAL` — must not live in a migration file; set those on
+the connection before calling `runMigrations`.
 
 ## Runtime surface (`ctx`)
 
 - `ctx.dataDir` — the **only** writable directory. SQLite DB and files go
   here (`node:sqlite` `DatabaseSync`). Treat the repo itself as read-only at
-  runtime.
+  runtime — the DB lives in `ctx.dataDir`, but the `migrations/` files that
+  shape it are code and are read from the app repo (`import.meta.dirname`).
 - `ctx.config` — merged config (readonly).
 - `ctx.state` — small key/value store; `ctx.logger` — log here, not console.
 - `ctx.ai.createSession()` — an agent session, pre-scoped by the host

package/templates/basic-app/README.md

@@ -18,6 +18,7 @@ your changes are live.
 | File | What it is |
 |---|---|
 | `index.mjs` | The app: manifest, API routes, job handlers |
+| `migrations/` | Ordered `.sql` files — the DB schema, applied at DB open |
 | `ui/index.html` | The web UI, served at `/app/__APP_NAME__/` |
 | `AGENTS.md` | The platform contract, written for coding agents working in this repo |
 
@@ -27,7 +28,12 @@ your `routes` handler, so you can also server-render pages.
 ## What the app gets
 
 - **`ctx.dataDir`** — the only writable directory; put your SQLite DB and
-  files here (the template creates `app.db` on first request)
+  files here (the template opens `app.db` there on first request and applies
+  `migrations/` to it)
+- **`migrations/`** — the schema, as ordered `.sql` files applied by
+  `runMigrations` at DB open: forward-only, tracked in `PRAGMA user_version`.
+  To change the schema, add the next numbered file (`002-...sql`) — never edit
+  one that has already run
 - **`ctx.state`** — small key/value store (`state.json`)
 - **`ctx.config`** — `configDefaults` merged with the user's per-app config
 - **`ctx.ai`** — AI sessions through the host; the Chat page uses the host's

package/templates/basic-app/index.mjs

@@ -1,12 +1,12 @@
 import { join } from 'node:path';
 import { DatabaseSync } from 'node:sqlite';
-import { defineApp } from '@alashi/apps-sdk';
+import { defineApp, runMigrations } from '@alashi/apps-sdk';
 
 export default defineApp({
   name: '__APP_NAME__',
   version: '0.1.0',
   description: 'An alashi app',
-  sdkVersion: '^0.5.0',
+  sdkVersion: '^0.6.0',
   ui: 'ui',
   configDefaults: {
     greeting: 'What should we work on?',
@@ -27,11 +27,12 @@ export default defineApp({
   routes: (ctx) => {
     // The app's own SQLite database, living in its data dir.
     const db = new DatabaseSync(join(ctx.dataDir, 'app.db'));
-    db.exec(`CREATE TABLE IF NOT EXISTS notes (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      text TEXT NOT NULL,
-      created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now'))
-    )`);
+    // Schema comes from the ordered .sql files in this repo's migrations/
+    // (not ctx.dataDir), applied forward-only at DB open. A schema change
+    // ships as a new numbered file — never as an edit to an applied one.
+    // Pragmas that cannot run inside a transaction (journal_mode) go here,
+    // before the call, not into a migration file.
+    runMigrations(db, join(import.meta.dirname, 'migrations'), { logger: ctx.logger });
 
     return async (req) => {
       const url = new URL(req.url);

package/templates/basic-app/migrations/001-init.sql

@@ -0,0 +1,7 @@
+-- Applied once, then never touched again. Schema changes ship as a new
+-- numbered file (002-..., 003-...), never as an edit to this one.
+CREATE TABLE notes (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  text TEXT NOT NULL,
+  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now'))
+);

package/templates/basic-app/package.json

@@ -4,6 +4,6 @@
   "type": "module",
   "main": "index.mjs",
   "dependencies": {
-    "@alashi/apps-sdk": "^0.5.0"
+    "@alashi/apps-sdk": "^0.6.0"
   }
 }