@alashi/cli 0.5.1 → 0.8.1

package/assets/v1/chat.js

@@ -10,8 +10,13 @@
  * inherits the app's theme tokens.
  *
  * Attributes:
- *   app          app name (default: derived from /app/<name>/ in the URL)
- *   placeholder  input placeholder text
+ *   app            app name (default: derived from /app/<name>/ in the URL)
+ *   placeholder    input placeholder text
+ *   conversations  "hidden" for single-conversation mode: no sidebar, no
+ *                  conversations request on connect, no auto-open of the
+ *                  newest conversation. The app drives which transcript is
+ *                  shown via openConversation(id) / adoptSession(...).
+ *                  Any other value (or absence) keeps the default sidebar.
  *
  * Methods:
  *   adoptSession(sessionId, title)  create a conversation resuming an
@@ -112,6 +117,9 @@
       this._initialized = true;
       this.conversationId = null;
       this._render();
+      // Single-conversation mode: the embedding app opens the transcript it
+      // wants, so skip both the listing fetch and the auto-open.
+      if (this._conversationsHidden) return;
       this._loadConversations()
         .then((conversations) => {
           if (conversations.length > 0) this.openConversation(conversations[0].id);
@@ -123,6 +131,10 @@
       return this.getAttribute('app') ?? decodeURIComponent(window.location.pathname.split('/')[2]);
     }
 
+    get _conversationsHidden() {
+      return this.getAttribute('conversations') === 'hidden';
+    }
+
     _hostApi(path) {
       return `/api/apps/${encodeURIComponent(this.app)}${path}`;
     }
@@ -142,12 +154,19 @@
         event.preventDefault();
         this._submit();
       });
+      const main = el('div', { className: 'panel chat-main' }, [this._log, form, this._status]);
+      // In single-conversation mode the sidebar is never appended; `this._list`
+      // stays a detached <ul> so the rest of the component keeps working.
+      if (this._conversationsHidden) {
+        this.append(el('div', { className: 'chat-layout' }, [main]));
+        return;
+      }
       const newChat = el('button', { type: 'button', textContent: '+ New chat' });
       newChat.addEventListener('click', () => this.newChat());
       this.append(
         el('div', { className: 'chat-layout' }, [
           el('div', { className: 'panel conversations-panel' }, [newChat, this._list]),
-          el('div', { className: 'panel chat-main' }, [this._log, form, this._status]),
+          main,
         ]),
       );
     }
@@ -194,6 +213,8 @@
     }
 
     async _loadConversations() {
+      // No sidebar to fill, and no reason to ask the host for a list.
+      if (this._conversationsHidden) return [];
       const res = await fetch(this._hostApi('/chat/conversations'));
       const { conversations } = await res.json();
       this._list.replaceChildren(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alashi/cli",
-  "version": "0.5.1",
+  "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.4.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.1.1"
+    "@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
@@ -59,7 +68,9 @@ them — create DB schema lazily (`CREATE TABLE IF NOT EXISTS` on first open).
   `:root { --accent: ... }` token overrides only) and `/assets/v1/chat.js` —
   the `<alashi-chat>` web component (conversations, SSE streaming, safe
   markdown incl. images, tool status, cost). Attributes: `app`,
-  `placeholder`. Methods: `adoptSession(sessionId, title?)`,
+  `placeholder`, `conversations` (`"hidden"` = single-conversation mode: no
+  sidebar, no conversations fetch on connect; the app picks the transcript
+  with `openConversation`/`adoptSession`). Methods: `adoptSession(sessionId, title?)`,
   `openConversation(id)`, `newChat()`. Bubbling events: `alashi-chat:turn`
   (`{ok, costUsd, error, conversationId}`), `alashi-chat:conversation`.
   Never vendor or fork system UI; breaking changes ship as `/assets/v2/`.

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.4.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.4.0"
+    "@alashi/apps-sdk": "^0.6.0"
   }
 }