showpane 0.4.9 → 0.4.11

package/bundle/toolchain/skills/portal-dev/SKILL.md

@@ -28,7 +28,7 @@ echo "APP_PATH: $APP_PATH"
 
 # Predictive next-skill suggestion
 if [ -f "$HOME/.showpane/timeline.jsonl" ]; then
-  _RECENT=$(grep '"event":"completed"' "$HOME/.showpane/timeline.jsonl" 2>/dev/null | tail -3 | grep -o '"skill":"[^"]*"' | sed 's/"skill":"//;s/"//' | tr '\n' ',' | sed 's/,$//')
+  _RECENT=$(grep '"event":"completed"' "$HOME/.showpane/timeline.jsonl" 2>/dev/null | tail -3 | grep -o '"skill":"[^"]*"' | sed 's/"skill":"//;s/"//' | tr '\n' ',' | sed 's/,$//' || true)
   [ -n "$_RECENT" ] && echo "RECENT_SKILLS: $_RECENT"
 fi
 
@@ -100,7 +100,7 @@ if [ ! -d "$APP_PATH/node_modules" ]; then
   cd "$APP_PATH" && npm install
 elif [ ! -d "$APP_PATH/node_modules/.prisma" ]; then
   echo "Generating Prisma client..."
-  cd "$APP_PATH" && npx prisma generate
+  cd "$APP_PATH" && npm run prisma:generate
 fi
 ```
 
@@ -117,7 +117,7 @@ else
   echo "WARNING: No .env file found at $APP_PATH/.env"
   echo "The dev server may fail without DATABASE_URL and AUTH_SECRET."
   echo "Create $APP_PATH/.env with at minimum:"
-  echo "  DATABASE_URL=postgresql://postgres:postgres@localhost:5432/showpane"
+  echo "  DATABASE_URL=file:./dev.db"
   echo "  AUTH_SECRET=<any-random-string>"
 fi
 ```
@@ -143,15 +143,19 @@ fi
 
 This is a non-blocking check. If the database is down, the dev server still starts — it just won't be able to serve authenticated portal pages. Static pages and the example portal (which uses hardcoded data) will still work.
 
-### Step 5: Check for pending migrations
+### Step 5: Check whether the local schema is ready
 
 ```bash
-cd "$APP_PATH" && npx prisma migrate status 2>&1 | grep -q "pending"
+if [[ "$DATABASE_URL" == file:* ]]; then
+  echo "SQLite detected; local schema uses db push."
+else
+  echo "Unexpected non-SQLite DATABASE_URL detected. Reset .env to file:./dev.db for the supported local workflow."
+fi
 ```
 
-If there are pending migrations, inform the user:
+If the SQLite schema has not been applied yet, inform the user:
 
-> "There are pending database migrations. Run `cd $APP_PATH && npx prisma migrate dev` to apply them, or they will be applied automatically when you next run `/portal deploy`."
+> "The local database schema has not been applied yet. Run `cd $APP_PATH && npm run prisma:db-push` before continuing."
 
 This is informational only — do not block the dev server start.
 
@@ -232,11 +236,9 @@ Common causes:
 ### Database-related page errors
 If the dev server starts but portal pages show errors:
 - Check the terminal output for Prisma errors
-- Verify DATABASE_URL is correct and the database server is running
-- Run `cd $APP_PATH && npx prisma migrate dev` to ensure the schema is up to date
-- Run `cd $APP_PATH && npx prisma generate` to regenerate the Prisma client if the schema changed
-- If using Docker for the database, ensure the database container is running: `docker compose ps`
-- Check that the database user has the correct permissions for the showpane database
+- Verify DATABASE_URL is correct
+- If `DATABASE_URL` starts with `file:`, run `cd $APP_PATH && npm run prisma:db-push`
+- Run `cd $APP_PATH && npm run prisma:generate` to regenerate the Prisma client if the schema changed
 
 ## Working with the Dev Server
 
@@ -248,7 +250,7 @@ The Next.js dev server watches all files under `src/` for changes. When you edit
 - Adding a new tab: reflected instantly
 - Changing PortalShell props: reflected instantly
 - Adding a new portal directory: requires navigating to the new URL manually (hot reload only works on already-loaded pages)
-- Changing `prisma/schema.prisma`: requires restarting the dev server after running `npx prisma generate`
+- Changing files under `prisma/`: requires restarting the dev server after running `npm run prisma:generate`
 
 ### Accessing portals during development
 

package/bundle/toolchain/skills/portal-list/SKILL.md

@@ -17,7 +17,7 @@ if [ ! -f "$CONFIG" ]; then
   exit 1
 fi
 APP_PATH=$(cat "$CONFIG" | python3 -c "import sys,json; print(json.loads(sys.stdin.read()).get('app_path',''))" 2>/dev/null)
-DEPLOY_MODE=$(cat "$CONFIG" | python3 -c "import sys,json; print(json.loads(sys.stdin.read()).get('deploy_mode','docker'))" 2>/dev/null)
+DEPLOY_MODE=$(cat "$CONFIG" | python3 -c "import sys,json; print(json.loads(sys.stdin.read()).get('deploy_mode','local'))" 2>/dev/null)
 ORG_SLUG=$(cat "$CONFIG" | python3 -c "import sys,json; d=json.loads(sys.stdin.read()); print(d.get('orgSlug','') or d.get('org_slug',''))" 2>/dev/null)
 APP_PATH="${SHOWPANE_APP_PATH:-$APP_PATH}"
 if [ -f "$APP_PATH/.env" ]; then set -a && source "$APP_PATH/.env" && set +a; fi
@@ -34,7 +34,7 @@ LEARN_FILE="$HOME/.showpane/learnings.jsonl"
 
 # Predictive next-skill suggestion
 if [ -f "$HOME/.showpane/timeline.jsonl" ]; then
-  _RECENT=$(grep '"event":"completed"' "$HOME/.showpane/timeline.jsonl" 2>/dev/null | tail -3 | grep -o '"skill":"[^"]*"' | sed 's/"skill":"//;s/"//' | tr '\n' ',' | sed 's/,$//')
+  _RECENT=$(grep '"event":"completed"' "$HOME/.showpane/timeline.jsonl" 2>/dev/null | tail -3 | grep -o '"skill":"[^"]*"' | sed 's/"skill":"//;s/"//' | tr '\n' ',' | sed 's/,$//' || true)
   [ -n "$_RECENT" ] && echo "RECENT_SKILLS: $_RECENT"
 fi
 

package/bundle/toolchain/skills/portal-onboard/SKILL.md

@@ -18,7 +18,7 @@ if [ ! -f "$CONFIG" ]; then
   exit 1
 fi
 APP_PATH=$(cat "$CONFIG" | python3 -c "import sys,json; print(json.loads(sys.stdin.read()).get('app_path',''))" 2>/dev/null)
-DEPLOY_MODE=$(cat "$CONFIG" | python3 -c "import sys,json; print(json.loads(sys.stdin.read()).get('deploy_mode','docker'))" 2>/dev/null)
+DEPLOY_MODE=$(cat "$CONFIG" | python3 -c "import sys,json; print(json.loads(sys.stdin.read()).get('deploy_mode','local'))" 2>/dev/null)
 ORG_SLUG=$(cat "$CONFIG" | python3 -c "import sys,json; d=json.loads(sys.stdin.read()); print(d.get('orgSlug','') or d.get('org_slug',''))" 2>/dev/null)
 APP_PATH="${SHOWPANE_APP_PATH:-$APP_PATH}"
 if [ -f "$APP_PATH/.env" ]; then set -a && source "$APP_PATH/.env" && set +a; fi
@@ -35,7 +35,7 @@ LEARN_FILE="$HOME/.showpane/learnings.jsonl"
 
 # Predictive next-skill suggestion
 if [ -f "$HOME/.showpane/timeline.jsonl" ]; then
-  _RECENT=$(grep '"event":"completed"' "$HOME/.showpane/timeline.jsonl" 2>/dev/null | tail -3 | grep -o '"skill":"[^"]*"' | sed 's/"skill":"//;s/"//' | tr '\n' ',' | sed 's/,$//')
+  _RECENT=$(grep '"event":"completed"' "$HOME/.showpane/timeline.jsonl" 2>/dev/null | tail -3 | grep -o '"skill":"[^"]*"' | sed 's/"skill":"//;s/"//' | tr '\n' ',' | sed 's/,$//' || true)
   [ -n "$_RECENT" ] && echo "RECENT_SKILLS: $_RECENT"
 fi
 

package/bundle/toolchain/skills/portal-preview/SKILL.md

@@ -17,7 +17,7 @@ if [ ! -f "$CONFIG" ]; then
   exit 1
 fi
 APP_PATH=$(cat "$CONFIG" | python3 -c "import sys,json; print(json.loads(sys.stdin.read()).get('app_path',''))" 2>/dev/null)
-DEPLOY_MODE=$(cat "$CONFIG" | python3 -c "import sys,json; print(json.loads(sys.stdin.read()).get('deploy_mode','docker'))" 2>/dev/null)
+DEPLOY_MODE=$(cat "$CONFIG" | python3 -c "import sys,json; print(json.loads(sys.stdin.read()).get('deploy_mode','local'))" 2>/dev/null)
 ORG_SLUG=$(cat "$CONFIG" | python3 -c "import sys,json; d=json.loads(sys.stdin.read()); print(d.get('orgSlug','') or d.get('org_slug',''))" 2>/dev/null)
 APP_PATH="${SHOWPANE_APP_PATH:-$APP_PATH}"
 if [ -f "$APP_PATH/.env" ]; then set -a && source "$APP_PATH/.env" && set +a; fi
@@ -34,7 +34,7 @@ LEARN_FILE="$HOME/.showpane/learnings.jsonl"
 
 # Predictive next-skill suggestion
 if [ -f "$HOME/.showpane/timeline.jsonl" ]; then
-  _RECENT=$(grep '"event":"completed"' "$HOME/.showpane/timeline.jsonl" 2>/dev/null | tail -3 | grep -o '"skill":"[^"]*"' | sed 's/"skill":"//;s/"//' | tr '\n' ',' | sed 's/,$//')
+  _RECENT=$(grep '"event":"completed"' "$HOME/.showpane/timeline.jsonl" 2>/dev/null | tail -3 | grep -o '"skill":"[^"]*"' | sed 's/"skill":"//;s/"//' | tr '\n' ',' | sed 's/,$//' || true)
   [ -n "$_RECENT" ] && echo "RECENT_SKILLS: $_RECENT"
 fi
 
@@ -69,7 +69,7 @@ mention them unless they directly affect the current task.
 
 ## Overview
 
-This skill opens a portal in the user's default web browser. It is the fastest way to see what a portal looks like after creating or updating it. The skill determines the correct URL based on the deployment mode and whether a local dev server is running, then opens it using the platform's native command.
+This skill opens a portal in the user's default web browser. It is the fastest way to see what a portal looks like after creating or updating it. The skill determines the correct URL based on whether a local dev server is running and whether a public app URL is configured, then opens it using the platform's native command.
 
 This is a lightweight skill -- it does not start a dev server, build the app, or modify anything. It just opens a URL. If the dev server is not running, it tells the user how to start it.
 
@@ -101,27 +101,14 @@ If a process is listening on port 3000, the URL is:
 http://localhost:3000/client/<slug>
 ```
 
-**Option B: Docker deploy mode (check port 8080)**
-
-If `DEPLOY_MODE` is `docker`, check if the container is running:
-
-```bash
-lsof -i :8080 -sTCP:LISTEN -t >/dev/null 2>&1 && echo "DOCKER_RUNNING=true" || echo "DOCKER_RUNNING=false"
-```
-
-If running, the URL is:
-```
-http://localhost:8080/client/<slug>
-```
-
-**Option C: NEXT_PUBLIC_APP_URL is set**
+**Option B: NEXT_PUBLIC_APP_URL is set**
 
 If the environment variable `NEXT_PUBLIC_APP_URL` is set (sourced from `.env` by the preamble), use it:
 ```
 ${NEXT_PUBLIC_APP_URL}/client/<slug>
 ```
 
-This handles production/staging URLs, custom domains, and any other deployment target.
+This handles deployed URLs, custom domains, and any other public preview target.
 
 **Fallback: Nothing running**
 
@@ -174,9 +161,8 @@ If the portal is the example portal (slug is "example"), no credentials are need
 To be explicit about resolution order:
 
 1. **Dev server on port 3000** -- always preferred for local development, regardless of other settings.
-2. **Docker on port 8080** -- used when deploy_mode is docker and the container is running.
-3. **NEXT_PUBLIC_APP_URL** -- used for production or staging environments, or when no local server is detected.
-4. **Fallback** -- no URL available, prompt the user to start a server.
+2. **NEXT_PUBLIC_APP_URL** -- used for deployed environments or when no local server is detected.
+3. **Fallback** -- no URL available, prompt the user to start a server.
 
 This order ensures that during development, the user always sees the latest local version, even if NEXT_PUBLIC_APP_URL points to production.
 
@@ -213,9 +199,9 @@ If the user is previewing to check content before sharing with a client, suggest
 
 ## Previewing After Changes
 
-A common workflow is: edit portal content with `/portal update`, then preview to verify. If the dev server is running with Next.js hot reload, changes to the client component files will appear immediately without a page refresh. If the user is running a production build (docker mode), they may need to rebuild first.
+A common workflow is: edit portal content with `/portal update`, then preview to verify. If the dev server is running with Next.js hot reload, changes to the client component files will appear immediately without a page refresh.
 
-If the user just ran `/portal update` and then `/portal preview`, mention: "If you don't see your changes, make sure the dev server is running (hot reload) or rebuild with /portal deploy for docker mode."
+If the user just ran `/portal update` and then `/portal preview`, mention: "If you don't see your changes, make sure the dev server is running so hot reload can pick them up."
 
 ## Multiple Portals Preview
 

package/bundle/toolchain/skills/portal-setup/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: portal-setup
 description: |
-  Interactive setup wizard for Showpane. Creates config, installs deps, runs migrations, and creates the organization.
+  Interactive setup wizard for Showpane. Creates config, installs deps, applies the local SQLite schema, and creates the organization.
   Trigger phrases: "portal setup", "configure showpane", "set up showpane", "initialize showpane". (showpane)
 allowed-tools: [Bash, Read, Write, Edit, Glob, Grep]
 hooks:
@@ -40,7 +40,7 @@ echo "SHOWPANE: v$SKILL_VERSION | SETUP MODE"
 
 # Predictive next-skill suggestion
 if [ -f "$HOME/.showpane/timeline.jsonl" ]; then
-  _RECENT=$(grep '"event":"completed"' "$HOME/.showpane/timeline.jsonl" 2>/dev/null | tail -3 | grep -o '"skill":"[^"]*"' | sed 's/"skill":"//;s/"//' | tr '\n' ',' | sed 's/,$//')
+  _RECENT=$(grep '"event":"completed"' "$HOME/.showpane/timeline.jsonl" 2>/dev/null | tail -3 | grep -o '"skill":"[^"]*"' | sed 's/"skill":"//;s/"//' | tr '\n' ',' | sed 's/,$//' || true)
   [ -n "$_RECENT" ] && echo "RECENT_SKILLS: $_RECENT"
 fi
 
@@ -93,7 +93,7 @@ Run the detection:
 
 ```bash
 for candidate in "$(pwd)" "$(pwd)/../app" "$HOME/git/showpane/app" "$HOME/showpane/app"; do
-  if [ -f "$candidate/package.json" ] && [ -f "$candidate/prisma/schema.prisma" ]; then
+  if [ -f "$candidate/package.json" ] && { [ -f "$candidate/prisma/schema.local.prisma" ] || [ -f "$candidate/prisma.config.ts" ]; }; then
     echo "FOUND: $(cd "$candidate" && pwd)"
     break
   fi
@@ -102,7 +102,7 @@ done
 
 If found, confirm with the user: "Found Showpane app at /path/to/app. Use this? (Y/n)"
 
-If not found, ask the user to provide the path. Validate that the path exists and contains both `package.json` and `prisma/schema.prisma`. If either file is missing, the path is not a valid Showpane app directory — explain which file is missing and ask again.
+If not found, ask the user to provide the path. Validate that the path exists and contains `package.json` plus either `prisma/schema.local.prisma` or `prisma.config.ts`. If those markers are missing, the path is not a valid Showpane app directory — explain which file is missing and ask again.
 
 Resolve the path to an absolute path (no `~` or relative components) before storing it. Use `cd "$path" && pwd` to resolve.
 
@@ -117,14 +117,11 @@ When the user is inside a freshly generated Showpane project, the setup should:
 - Still ask for org name, contact details, and website URL
 - Be concise — the user just ran `npx showpane` and wants to get going fast
 
-### Step 3: Ask for deploy mode
+### Step 3: Set the workspace mode
 
-Present the options:
+Use `local` as the setup mode.
 
-- **docker** — Self-hosted with Docker Compose. Best for VPS, dedicated servers, or local development.
-- **vercel** — Deployed via Vercel. Pushes to git trigger automatic deploys.
-
-Default to `docker` if the user doesn't have a preference. Store as `DEPLOY_MODE`.
+Store `DEPLOY_MODE=local` in the config written later in this flow.
 
 ### Step 4: Install dependencies
 
@@ -137,12 +134,12 @@ cd "$APP_PATH" && npm install
 If node_modules exists but `.prisma` client is missing, run:
 
 ```bash
-cd "$APP_PATH" && npx prisma generate
+cd "$APP_PATH" && npm run prisma:generate
 ```
 
 Wait for installation to complete before proceeding.
 
-### Step 5: Run database migrations
+### Step 5: Apply the local database schema
 
 Source the app's `.env` file to get `DATABASE_URL`:
 
@@ -150,24 +147,18 @@ Source the app's `.env` file to get `DATABASE_URL`:
 if [ -f "$APP_PATH/.env" ]; then set -a && source "$APP_PATH/.env" && set +a; fi
 ```
 
-Check if the database has existing tables. For a fresh database:
-
-```bash
-cd "$APP_PATH" && npx prisma migrate dev
-```
-
-For an existing database with pending migrations:
+The supported setup path is SQLite. Apply the local schema:
 
 ```bash
-cd "$APP_PATH" && npx prisma migrate deploy
+cd "$APP_PATH" && npm run prisma:db-push
 ```
 
 If `DATABASE_URL` is not set in `.env`, inform the user they need to configure it. Provide guidance:
-- For local development: `postgresql://postgres:postgres@localhost:5432/showpane`
-- For Docker: the docker-compose.yml should provide it
-- For Vercel: set it in the Vercel dashboard environment variables
+- For local development: `file:./dev.db`
+
+If `DATABASE_URL` is set to anything other than a `file:` URL, explain that the supported setup flow is SQLite-first and suggest resetting `.env` back to `file:./dev.db`.
 
-Do NOT proceed until migrations complete successfully.
+Do NOT proceed until the local schema is applied successfully.
 
 ### Step 6: Create or find Organization record
 
@@ -239,7 +230,7 @@ Write the config file:
 cat > "$HOME/.showpane/config.json" << 'CONFIGEOF'
 {
   "app_path": "<resolved_absolute_path>",
-  "deploy_mode": "<docker|vercel>",
+  "deploy_mode": "local",
   "orgSlug": "<org_slug>",
   "telemetry": "<community|anonymous|off>"
 }
@@ -257,7 +248,7 @@ Display a clear summary:
 Showpane setup complete!
 
   App path:     /path/to/showpane-project
-  Deploy mode:  docker
+  Deploy mode:  local
   Organization: Acme Consulting (acme-consulting)
   Brand color:  #2563eb
   Telemetry:    off
@@ -283,7 +274,7 @@ Each step can fail independently. Handle failures gracefully:
 
 - **App path not found**: Ask the user to run `npx showpane` first or point setup at an existing generated Showpane project
 - **npm install fails**: Check Node.js version (requires 18+), check internet connectivity, suggest clearing `node_modules` and retrying
-- **Prisma migrate fails**: Check DATABASE_URL is correct and the database server is running. For local dev, suggest `docker compose up -d db` if a database service exists in docker-compose.yml
+- **Prisma db push fails**: Check that DATABASE_URL is set to `file:./dev.db` (or another valid SQLite `file:` URL) in `.env`
 - **Organization creation fails**: Check database connectivity. If the Prisma client throws a connection error, verify DATABASE_URL in `.env`
 - **Config write fails**: Check that `$HOME/.showpane/` is writable. On some systems, home directory permissions may block directory creation
 
@@ -306,4 +297,4 @@ echo '{"skill":"portal-setup","event":"completed","ts":"'$(date -u +%Y-%m-%dT%H:
 - If any step fails, provide a clear error message and suggest how to fix it, but do not silently continue
 - The setup wizard is interactive — ask one question at a time, don't dump all questions at once
 - When reconfiguring, show current values as defaults so the user can press enter to keep them
-- The setup wizard should complete in under 5 minutes for a user with all prerequisites (Node.js, Postgres, the repo cloned)
+- The setup wizard should complete in under 5 minutes for a user with Node.js, internet access, and a generated Showpane project

package/bundle/toolchain/skills/portal-share/SKILL.md

@@ -20,7 +20,7 @@ if [ ! -f "$CONFIG" ]; then
   exit 1
 fi
 APP_PATH=$(cat "$CONFIG" | python3 -c "import sys,json; print(json.loads(sys.stdin.read()).get('app_path',''))" 2>/dev/null)
-DEPLOY_MODE=$(cat "$CONFIG" | python3 -c "import sys,json; print(json.loads(sys.stdin.read()).get('deploy_mode','docker'))" 2>/dev/null)
+DEPLOY_MODE=$(cat "$CONFIG" | python3 -c "import sys,json; print(json.loads(sys.stdin.read()).get('deploy_mode','local'))" 2>/dev/null)
 ORG_SLUG=$(cat "$CONFIG" | python3 -c "import sys,json; d=json.loads(sys.stdin.read()); print(d.get('orgSlug','') or d.get('org_slug',''))" 2>/dev/null)
 APP_PATH="${SHOWPANE_APP_PATH:-$APP_PATH}"
 if [ -f "$APP_PATH/.env" ]; then set -a && source "$APP_PATH/.env" && set +a; fi
@@ -37,7 +37,7 @@ LEARN_FILE="$HOME/.showpane/learnings.jsonl"
 
 # Predictive next-skill suggestion
 if [ -f "$HOME/.showpane/timeline.jsonl" ]; then
-  _RECENT=$(grep '"event":"completed"' "$HOME/.showpane/timeline.jsonl" 2>/dev/null | tail -3 | grep -o '"skill":"[^"]*"' | sed 's/"skill":"//;s/"//' | tr '\n' ',' | sed 's/,$//')
+  _RECENT=$(grep '"event":"completed"' "$HOME/.showpane/timeline.jsonl" 2>/dev/null | tail -3 | grep -o '"skill":"[^"]*"' | sed 's/"skill":"//;s/"//' | tr '\n' ',' | sed 's/,$//' || true)
   [ -n "$_RECENT" ] && echo "RECENT_SKILLS: $_RECENT"
 fi
 
@@ -147,8 +147,7 @@ Do NOT log the share URL to learnings or telemetry. The URL contains the signed
 - Always display the full URL, never truncate or abbreviate it. The user needs to copy-paste it.
 - Make it clear that the link does not expire automatically and is revoked by credential rotation or portal deactivation.
 - Use double-line box drawing (`═`) for the border around the link.
-- If NEXT_PUBLIC_APP_URL is `http://localhost:3000`, warn the user: "This is a local development URL. The client won't be able to access it remotely. Deploy the app first with /portal deploy, then generate the share link."
-- If the deploy mode is `docker` and the URL looks like localhost, same warning applies.
+- If NEXT_PUBLIC_APP_URL is `http://localhost:3000`, warn the user: "This is a local development URL. The client won't be able to access it remotely. Deploy the app with /portal deploy, then generate the share link again."
 
 ## Error Handling
 

package/bundle/toolchain/skills/portal-status/SKILL.md

@@ -17,7 +17,7 @@ if [ ! -f "$CONFIG" ]; then
   exit 1
 fi
 APP_PATH=$(cat "$CONFIG" | python3 -c "import sys,json; print(json.loads(sys.stdin.read()).get('app_path',''))" 2>/dev/null)
-DEPLOY_MODE=$(cat "$CONFIG" | python3 -c "import sys,json; print(json.loads(sys.stdin.read()).get('deploy_mode','docker'))" 2>/dev/null)
+DEPLOY_MODE=$(cat "$CONFIG" | python3 -c "import sys,json; print(json.loads(sys.stdin.read()).get('deploy_mode','local'))" 2>/dev/null)
 ORG_SLUG=$(cat "$CONFIG" | python3 -c "import sys,json; d=json.loads(sys.stdin.read()); print(d.get('orgSlug','') or d.get('org_slug',''))" 2>/dev/null)
 APP_PATH="${SHOWPANE_APP_PATH:-$APP_PATH}"
 if [ -f "$APP_PATH/.env" ]; then set -a && source "$APP_PATH/.env" && set +a; fi
@@ -34,7 +34,7 @@ LEARN_FILE="$HOME/.showpane/learnings.jsonl"
 
 # Predictive next-skill suggestion
 if [ -f "$HOME/.showpane/timeline.jsonl" ]; then
-  _RECENT=$(grep '"event":"completed"' "$HOME/.showpane/timeline.jsonl" 2>/dev/null | tail -3 | grep -o '"skill":"[^"]*"' | sed 's/"skill":"//;s/"//' | tr '\n' ',' | sed 's/,$//')
+  _RECENT=$(grep '"event":"completed"' "$HOME/.showpane/timeline.jsonl" 2>/dev/null | tail -3 | grep -o '"skill":"[^"]*"' | sed 's/"skill":"//;s/"//' | tr '\n' ',' | sed 's/,$//' || true)
   [ -n "$_RECENT" ] && echo "RECENT_SKILLS: $_RECENT"
 fi
 

package/bundle/toolchain/skills/portal-update/SKILL.md

@@ -16,7 +16,7 @@ if [ ! -f "$CONFIG" ]; then
   exit 1
 fi
 APP_PATH=$(python3 -c "import json; d=json.load(open('$CONFIG')); print(d.get('app_path',''))" 2>/dev/null)
-DEPLOY_MODE=$(python3 -c "import json; d=json.load(open('$CONFIG')); print(d.get('deploy_mode','docker'))" 2>/dev/null)
+DEPLOY_MODE=$(python3 -c "import json; d=json.load(open('$CONFIG')); print(d.get('deploy_mode','local'))" 2>/dev/null)
 ORG_SLUG=$(python3 -c "import json; d=json.load(open('$CONFIG')); print(d.get('orgSlug','') or d.get('org_slug',''))" 2>/dev/null)
 APP_PATH="${SHOWPANE_APP_PATH:-$APP_PATH}"
 if [ -f "$APP_PATH/.env" ]; then set -a && source "$APP_PATH/.env" && set +a; fi
@@ -33,7 +33,7 @@ LEARN_FILE="$HOME/.showpane/learnings.jsonl"
 
 # Predictive next-skill suggestion
 if [ -f "$HOME/.showpane/timeline.jsonl" ]; then
-  _RECENT=$(grep '"event":"completed"' "$HOME/.showpane/timeline.jsonl" 2>/dev/null | tail -3 | grep -o '"skill":"[^"]*"' | sed 's/"skill":"//;s/"//' | tr '\n' ',' | sed 's/,$//')
+  _RECENT=$(grep '"event":"completed"' "$HOME/.showpane/timeline.jsonl" 2>/dev/null | tail -3 | grep -o '"skill":"[^"]*"' | sed 's/"skill":"//;s/"//' | tr '\n' ',' | sed 's/,$//' || true)
   [ -n "$_RECENT" ] && echo "RECENT_SKILLS: $_RECENT"
 fi
 

package/bundle/toolchain/skills/portal-upgrade/SKILL.md

@@ -17,7 +17,7 @@ if [ ! -f "$CONFIG" ]; then
   exit 1
 fi
 APP_PATH=$(cat "$CONFIG" | python3 -c "import sys,json; print(json.loads(sys.stdin.read()).get('app_path',''))" 2>/dev/null)
-DEPLOY_MODE=$(cat "$CONFIG" | python3 -c "import sys,json; print(json.loads(sys.stdin.read()).get('deploy_mode','docker'))" 2>/dev/null)
+DEPLOY_MODE=$(cat "$CONFIG" | python3 -c "import sys,json; print(json.loads(sys.stdin.read()).get('deploy_mode','local'))" 2>/dev/null)
 ORG_SLUG=$(cat "$CONFIG" | python3 -c "import sys,json; d=json.loads(sys.stdin.read()); print(d.get('orgSlug','') or d.get('org_slug',''))" 2>/dev/null)
 APP_PATH="${SHOWPANE_APP_PATH:-$APP_PATH}"
 if [ -f "$APP_PATH/.env" ]; then set -a && source "$APP_PATH/.env" && set +a; fi
@@ -34,7 +34,7 @@ LEARN_FILE="$HOME/.showpane/learnings.jsonl"
 
 # Predictive next-skill suggestion
 if [ -f "$HOME/.showpane/timeline.jsonl" ]; then
-  _RECENT=$(grep '"event":"completed"' "$HOME/.showpane/timeline.jsonl" 2>/dev/null | tail -3 | grep -o '"skill":"[^"]*"' | sed 's/"skill":"//;s/"//' | tr '\n' ',' | sed 's/,$//')
+  _RECENT=$(grep '"event":"completed"' "$HOME/.showpane/timeline.jsonl" 2>/dev/null | tail -3 | grep -o '"skill":"[^"]*"' | sed 's/"skill":"//;s/"//' | tr '\n' ',' | sed 's/,$//' || true)
   [ -n "$_RECENT" ] && echo "RECENT_SKILLS: $_RECENT"
 fi
 

package/bundle/toolchain/skills/portal-verify/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: portal-verify
 description: |
-  Verify deployed portal health: DNS, SSL, login page, content rendering, engagement tracking.
+  Verify a Showpane Cloud portal after publish: DNS, SSL, login page, content rendering, engagement tracking.
   Trigger phrases: "verify portal", "check deployment", "is my portal working", "portal health". (showpane)
 allowed-tools: [Bash, Read, Glob, Grep]
 ---
@@ -16,7 +16,7 @@ if [ ! -f "$CONFIG" ]; then
   exit 1
 fi
 APP_PATH=$(python3 -c "import json; d=json.load(open('$CONFIG')); print(d.get('app_path',''))" 2>/dev/null)
-DEPLOY_MODE=$(python3 -c "import json; d=json.load(open('$CONFIG')); print(d.get('deploy_mode','docker'))" 2>/dev/null)
+DEPLOY_MODE=$(python3 -c "import json; d=json.load(open('$CONFIG')); print(d.get('deploy_mode','local'))" 2>/dev/null)
 ORG_SLUG=$(python3 -c "import json; d=json.load(open('$CONFIG')); print(d.get('orgSlug','') or d.get('org_slug',''))" 2>/dev/null)
 CLOUD_API_TOKEN=$(python3 -c "import json; d=json.load(open('$CONFIG')); print(d.get('cloud',d).get('api_token', d.get('accessToken','')))" 2>/dev/null)
 CLOUD_ORG_SLUG=$(python3 -c "import json; d=json.load(open('$CONFIG')); print(d.get('cloud',d).get('org_slug', d.get('orgSlug','')))" 2>/dev/null)
@@ -41,38 +41,26 @@ LEARN_FILE="$HOME/.showpane/learnings.jsonl"
 
 ### Step 1: URL Reachability
 
-Determine the portal URL based on deploy mode and check that it responds.
+Determine the portal URL and check that it responds.
 
-**For self-hosted (docker/vercel):**
 ```bash
-PORTAL_URL="${CLOUD_PORTAL_URL:-http://localhost:3000}"
-echo "Checking portal URL: $PORTAL_URL"
-HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" "$PORTAL_URL" 2>/dev/null)
-echo "HTTP status: $HTTP_CODE"
-if [ "$HTTP_CODE" = "200" ]; then
-  URL_STATUS="ok"
-else
-  URL_STATUS="unreachable ($HTTP_CODE)"
+if [ -z "$CLOUD_PORTAL_URL" ] && [ -z "$CLOUD_ORG_SLUG" ]; then
+  echo "No hosted portal URL configured. Run /portal deploy first."
+  exit 1
 fi
-```
+PORTAL_URL="${CLOUD_PORTAL_URL:-https://$CLOUD_ORG_SLUG.showpane.com}"
+echo "Checking app URL: $CLOUD_API_BASE"
+APP_CODE=$(curl -s -o /dev/null -w "%{http_code}" "$CLOUD_API_BASE/api/health" 2>/dev/null)
+echo "App health: $APP_CODE"
 
-**For cloud deploys:**
-```bash
-if [ "$DEPLOY_MODE" = "cloud" ]; then
-  PORTAL_URL="${CLOUD_PORTAL_URL:-https://$CLOUD_ORG_SLUG.showpane.com}"
-  echo "Checking app URL: $CLOUD_API_BASE"
-  APP_CODE=$(curl -s -o /dev/null -w "%{http_code}" "$CLOUD_API_BASE/api/health" 2>/dev/null)
-  echo "App health: $APP_CODE"
-
-  echo "Checking org URL: $PORTAL_URL"
-  ORG_CODE=$(curl -s -o /dev/null -w "%{http_code}" "$PORTAL_URL" 2>/dev/null)
-  echo "Org portal: $ORG_CODE"
-
-  if [ "$ORG_CODE" = "200" ]; then
-    URL_STATUS="ok"
-  else
-    URL_STATUS="unreachable ($ORG_CODE)"
-  fi
+echo "Checking org URL: $PORTAL_URL"
+ORG_CODE=$(curl -s -o /dev/null -w "%{http_code}" "$PORTAL_URL" 2>/dev/null)
+echo "Org portal: $ORG_CODE"
+
+if [ "$ORG_CODE" = "200" ]; then
+  URL_STATUS="ok"
+else
+  URL_STATUS="unreachable ($ORG_CODE)"
 fi
 ```
 
@@ -110,7 +98,7 @@ if [ "$DEPLOY_MODE" = "cloud" ] && [ -n "$CLOUD_ORG_SLUG" ]; then
     echo "HTTP->HTTPS redirect: $REDIRECT_CODE (expected 301 or 308)"
   fi
 else
-  SSL_STATUS="n/a (self-hosted)"
+  SSL_STATUS="n/a (no cloud org configured)"
 fi
 ```
 
@@ -132,7 +120,7 @@ echo "Active portals: $PORTAL_LIST"
 For each portal, verify the login page returns a response and contains auth-related content:
 
 ```bash
-PORTAL_URL="${CLOUD_PORTAL_URL:-http://localhost:3000}"
+PORTAL_URL="${CLOUD_PORTAL_URL:-https://$CLOUD_ORG_SLUG.showpane.com}"
 echo "$PORTAL_LIST" | python3 -c "
 import sys, json
 portals = json.load(sys.stdin)
@@ -261,5 +249,5 @@ After the report, suggest next steps:
 - Cloud checks verify both the control plane (app.showpane.com) and the org portal (orgslug.showpane.com)
 - The PortalFile model may not exist in all schema versions — catch errors gracefully
 - If the database is unreachable, skip DB-dependent checks (Steps 3, 5) and note it in the report
-- SSL checks only apply to cloud deploys — self-hosted SSL is the user's responsibility
+- SSL checks only apply when a cloud portal URL is configured
 - The events endpoint check uses OPTIONS to avoid creating spurious event records

package/bundle/toolchain/skills/shared/bin/check-portal-guard.sh

@@ -24,10 +24,6 @@ if [ -n "$command" ]; then
       echo '{"permissionDecision":"ask","message":"⚠️ This SQL command will destroy portal or organization data."}'
       exit 0
       ;;
-    *"vercel"*"rm"*|*"vercel"*"remove"*|*"vercel"*"delete"*)
-      echo '{"permissionDecision":"ask","message":"⚠️ This will delete a Vercel project. Published portals will go offline."}'
-      exit 0
-      ;;
   esac
 fi
 
@@ -38,7 +34,7 @@ if [ -n "$file_path" ]; then
       echo '{"permissionDecision":"ask","message":"⚠️ Modifying credentials/secrets file. Verify this is intentional."}'
       exit 0
       ;;
-    *"prisma/schema.prisma"*)
+    *"prisma/schema.local.prisma"*|*"prisma.config.ts"*)
       echo '{"permissionDecision":"ask","message":"⚠️ Modifying the database schema. This may require a migration."}'
       exit 0
       ;;

package/bundle/toolchain/skills/shared/preamble.md

@@ -32,7 +32,7 @@ export DATABASE_URL="${DATABASE_URL:-}"
 
 # 3. Verify app installed
 if [ ! -d "$APP_PATH/node_modules/.prisma" ]; then
-  echo "ERROR: Prisma client not generated. Run: cd $APP_PATH && npm install && npx prisma generate" >&2
+  echo "ERROR: Prisma client not generated. Run: cd $APP_PATH && npm install && npm run prisma:generate" >&2
   exit 1
 fi
 
@@ -57,7 +57,7 @@ fi
 
 # 5b. Predictive next-skill suggestion
 if [ -f "$HOME/.showpane/timeline.jsonl" ]; then
-  _RECENT=$(grep '"event":"completed"' "$HOME/.showpane/timeline.jsonl" 2>/dev/null | tail -3 | grep -o '"skill":"[^"]*"' | sed 's/"skill":"//;s/"//' | tr '\n' ',' | sed 's/,$//')
+  _RECENT=$(grep '"event":"completed"' "$HOME/.showpane/timeline.jsonl" 2>/dev/null | tail -3 | grep -o '"skill":"[^"]*"' | sed 's/"skill":"//;s/"//' | tr '\n' ',' | sed 's/,$//' || true)
   [ -n "$_RECENT" ] && echo "RECENT_SKILLS: $_RECENT"
 fi