@m2015agg/supabase-skill 0.7.0 → 0.7.2

package/README.md

@@ -1,6 +1,9 @@
 # @m2015agg/supabase-skill
 
-**The Supabase MCP replacement.** One npm package that teaches AI agents (Claude Code, Codex, Cursor) how to use the Supabase CLI, caches your entire database schema locally, and pre-approves read-only commands so your agent stops asking permission for every lookup.
+[![npm version](https://img.shields.io/npm/v/@m2015agg/supabase-skill)](https://www.npmjs.com/package/@m2015agg/supabase-skill)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+**The Supabase MCP replacement.** One npm package that teaches AI agents (Claude Code, Codex, Cursor) how to use the Supabase CLI, caches your entire database schema locally with row counts and table sizes, and pre-approves read-only commands so your agent stops asking permission for every lookup.
 
 No MCP server. No context window bloat. No running processes. No permission prompts for reads.
 
@@ -18,22 +21,12 @@ If you're using Claude Code (or any AI agent) with Supabase, you're burning toke
 
 **Replace the MCP with CLI instructions.** The Supabase CLI already does everything the MCP does. Your agent just doesn't know about it.
 
-**Cache the schema locally.** One API call snapshots your entire database into a local SQLite + markdown cache. Your agent reads local files (~80 tokens) instead of running SQL queries (~1,247 tokens average).
+**Cache the schema locally.** One API call snapshots your entire database into a local SQLite + FTS5 + markdown cache — with row counts and table sizes. Your agent reads local files (~80 tokens) instead of running SQL queries (~1,247 tokens average).
 
 **Pre-approve read commands.** 23 read-only commands (schema lookups, migration list, inspect, etc.) are auto-approved in Claude Code. Write commands (migration up, deploy, delete) still require your approval.
 
 **Result: ~95% token reduction on schema exploration, zero permission prompts for reads, multi-environment support (dev/stage/prod) in one session.**
 
-This package:
-- **Guided install wizard** — checks/installs Supabase CLI, logs you in, discovers projects + branches, fetches API keys, configures environments
-- **Schema snapshot** — caches your entire database schema locally (SQLite + FTS5 + markdown) so your agent never runs SQL to explore tables again
-- **Full DB admin skill doc** — teaches your agent every Supabase command: CRUD via REST API, migrations, DDL, inspect, storage, edge functions, branches, backups
-- **Security model** — API keys in `.env` only (never in CLAUDE.md), gitignored, mode 600
-- **Pre-approved permissions** — 23 read-only commands auto-approved in Claude Code, write commands still require approval
-- **Nightly auto-refresh** — cron job keeps schema snapshot current
-
-Two commands. Zero prompts after install.
-
 ## Install
 
 ```bash
@@ -48,7 +41,7 @@ npm install -g @m2015agg/supabase-skill
 supabase-skill install
 ```
 
-Interactive wizard (8 steps):
+Interactive wizard:
 1. Check/install Supabase CLI (minimum v2.67.0)
 2. Check/trigger login (opens browser if needed)
 3. Discover projects + branches (auto-detects preview branches)
@@ -82,143 +75,112 @@ $ supabase-skill install
     Database schema name (default: public) → my_schema
 
   Step 4/5: Fetching API keys
-    PROD (abcdefghijklmnopqrst)... ✓ anon + service_role keys saved
-    STAGE (tsrqponmlkjihgfedcba)... ✓ anon + service_role keys saved
+    PROD ... ✓ anon + service_role keys saved
+    STAGE ... ✓ anon + service_role keys saved
 
-  Step 5/5: Writing configuration
-    ✓ Config, CLAUDE.md, shell profile
-
-  Next: cd into your project and run `supabase-skill init`
+  Step 5/5: Writing configuration ✓
 ```
 
-### 2. Per-Project Setup (per project directory)
+### 2. Per-Project Setup
 
 ```bash
 cd your-project
 supabase-skill init
 ```
 
-Runs 5 steps automatically — no prompts:
+Runs 5 steps automatically — zero prompts:
 1. **CLAUDE.md** — skill doc with environment routing (no secrets)
 2. **.env** — API keys per environment (gitignored, mode 600)
-3. **Schema snapshot** — SQLite + markdown cache of all tables, columns, FKs, functions
-4. **Claude permissions** — 23 read-only commands pre-approved (no more prompts)
+3. **Schema snapshot** — SQLite + markdown cache with row counts + table sizes
+4. **Claude permissions** — 23 read-only commands pre-approved
 5. **Nightly cron** — auto-refresh schema at 3am
+6. **`/supabase` walkthrough** — Claude Code skill for guided database tour
 
-Or do both in one shot from your project directory:
+Or do both in one shot:
 
 ```bash
 supabase-skill install --init
 ```
 
-### 3. Done
+### 3. First Session
+
+Type `/supabase` in Claude Code for a guided walkthrough of your database. Claude will show your environments, schema overview, explore tables, and teach you what commands are available.
+
+### 4. Validate Setup
 
-Claude now knows every Supabase command, which ref is prod vs stage, reads your schema from local files instead of running SQL, and doesn't prompt for read-only operations.
+```bash
+supabase-skill doctor
+```
+
+```
+  ✓ Supabase CLI — v2.78.1
+  ✓ Logged in
+  ✓ Config — 2 environment(s): prod, stage
+  ✓ API keys [prod] — anon + service_role present
+  ✓ API keys [stage] — anon + service_role present
+  ✓ Schema — my_schema
+  ✓ Project linked — tsrqponmlkjihgfedcba
+  ✓ CLAUDE.md — skill doc installed
+  ✓ .env — has Supabase keys
+  ✓ Snapshot — 0h ago
+  ✓ Permissions — 23 commands approved
+  ✓ Cron — nightly at 03:00
+
+  12 passed, 0 failed, 0 warnings
+```
 
 ## Commands
 
 ### User Commands (you run these)
 
-| Command | When |
-|---------|------|
-| `supabase-skill install` | One time — global wizard (CLI, login, envs, keys) |
-| `supabase-skill install --init` | One time from project dir — global + project setup |
-| `supabase-skill init` | Per project — full auto-setup (CLAUDE.md + .env + snapshot + approve + cron) |
-| `supabase-skill envs` | Check configured environments |
-| `supabase-skill cron --status` | Check nightly refresh status |
+| Command | What it does |
+|---------|-------------|
+| `supabase-skill install` | Global wizard: CLI, login, envs, keys, CLAUDE.md |
+| `supabase-skill install --init` | Global + project setup in one shot |
+| `supabase-skill init` | Per-project: .env + CLAUDE.md + snapshot + approve + cron + walkthrough |
+| `supabase-skill doctor` | Health check: 12-point validation of entire setup |
+| `supabase-skill update` | Self-update to latest npm version |
+| `supabase-skill update --check` | Check for updates without installing |
+| `supabase-skill envs` | Show configured environments |
+| `supabase-skill diff` | Compare live schema vs local snapshot (find drift) |
+| `supabase-skill graph` | Mermaid ER diagram of all table relationships |
+| `supabase-skill cron --status` | Check nightly refresh |
 | `supabase-skill uninstall` | Remove from current project |
 | `supabase-skill uninstall --global` | Remove from global CLAUDE.md |
+| `supabase-skill approve --remove` | Remove Claude permissions |
 
 ### Agent Commands (Claude uses these — pre-approved, no prompts)
 
 | Command | What it does |
 |---------|-------------|
-| `supabase-skill context <query>` | Full context: columns, FKs, related tables (2 levels), functions |
-| `supabase-skill table <name>` | Single table deep dive with relationships + related summaries |
-| `supabase-skill columns [name]` | Search columns by name, `--type`, `--fk`, `--pk`, `--table` |
+| `supabase-skill context <query>` | Full context: columns, FKs, related tables (2 levels), functions, row counts, sizes |
+| `supabase-skill table <name>` | Single table deep dive with relationships, sizes, related summaries |
+| `supabase-skill columns [name]` | Search columns: `--type`, `--fk`, `--pk`, `--nullable`, `--table` |
 | `supabase-skill search <query>` | FTS5-powered search across tables, columns, functions, FKs |
 | `supabase-skill snapshot` | Refresh schema cache (auto-runs after DDL changes) |
 | `supabase inspect db *` | 12 database inspection commands (table-stats, locks, etc.) |
 | `supabase migration list` | Compare local vs remote migrations |
 
-## What It Writes to CLAUDE.md
-
-The skill doc is injected between `<!-- supabase-skill:start -->` and `<!-- supabase-skill:end -->` markers. This means:
-
-- **Idempotent**: Run `install` or `init` multiple times — it updates in place, never duplicates
-- **Clean removal**: `uninstall` removes exactly the marked section, nothing else
-- **Non-destructive**: Your existing CLAUDE.md content is preserved
-
-### The Skill Doc
-
-Here's exactly what gets written (with your project refs filled in):
-
-```markdown
-## supabase-cli (Supabase Database & Infrastructure)
-
-Requires: `supabase` CLI installed, logged in via `supabase login`.
-All commands support `-o json` for structured output.
-
-### Environments
-- **PROD**: `abcdefghijklmnopqrst` (My App Production) — ⚠️ NEVER modify without explicit approval
-- **STAGE**: `tsrqponmlkjihgfedcba` (My App Staging)
-- **Default**: Use STAGE for testing. PROD requires explicit approval.
-```
-
-It covers **20 sections** — every Supabase CLI capability plus REST API operations:
-
-| Section | What it teaches the agent |
-|---------|-------------------------|
-| **CLI Flag Reference** | Which commands use `--linked` vs `--project-ref` (agents get this wrong constantly) |
-| **Environment Routing** | "stage" → correct ref, "prod" → correct ref + approval required |
-| **Data Operations (REST API)** | Full CRUD: SELECT with 12 filter operators, INSERT, UPDATE, UPSERT, DELETE, COUNT |
-| **Migrations** | `new`, `list`, `up`, `down`, `repair`, `squash`, `fetch` |
-| **DDL via Migrations** | CREATE/ALTER/DROP TABLE, VIEW, INDEX, FUNCTION, RLS policies, triggers, enums |
-| **Schema Management** | `db diff`, `dump`, `pull`, `push`, `lint` |
-| **Database Inspection** | All 12 `inspect db` commands + `inspect report` |
-| **Storage** | `ls`, `cp`, `rm`, `mv` (with `--experimental` flag) |
-| **Edge Functions** | `list`, `deploy`, `delete`, `new`, `download`, `serve` |
-| **Branches** | `list`, `create`, `delete`, `get`, `pause`, `unpause` |
-| **Backups** | `list`, `restore` (PITR) |
-| **Project Management** | `projects list/api-keys`, `secrets list/set`, `postgres-config` |
-| **Code Generation** | `gen types` (TypeScript from schema) |
-| **Schema Snapshot** | All `supabase-skill` query commands for local schema exploration |
-| **Safety Rules** | Never mutate prod without approval, always specify ref, test on stage first |
-
-### Security Model
-
-| What | Where | Visible to agent? |
-|------|-------|-------------------|
-| Project refs (not secrets) | CLAUDE.md | Yes — agent needs these for `--project-ref` |
-| Environment routing | CLAUDE.md | Yes — agent needs to know "stage" → which ref |
-| API keys (anon + service_role) | `.env` only | Only when agent runs `source .env` |
-| Config with keys | `~/.config/supabase-skill/config.json` | No — mode 600, only used by `init` |
-| Schema snapshot | `.supabase-schema/` | Yes — that's the whole point |
-
-**Rule**: Secrets never go in CLAUDE.md. Agent reads `.env` when it needs direct API access.
-
 ## Schema Snapshot (CodeGraph for Your Database)
 
-The killer feature. Instead of your agent running SQL against `information_schema` every time it needs to understand your database (burning context and API calls), `snapshot` creates a local file cache that Claude can grep and read instantly.
-
-### Create a Snapshot
+Instead of your agent running SQL against `information_schema` every time (burning ~1,247 tokens per query), `snapshot` caches everything locally.
 
 ```bash
 supabase-skill snapshot
 ```
 
-One API call fetches the full OpenAPI spec from PostgREST, then splits it into small, searchable markdown files:
+One API call + one inspect command → full local cache:
 
 ```
 .supabase-schema/
-├── index.md              # All tables, views, functions at a glance
+├── schema.db             # SQLite + FTS5 (fast structured queries)
+├── index.md              # All tables with row counts + sizes
 ├── tables/
 │   ├── episodes.md       # Columns, types, PKs, FKs, defaults, notes
 │   ├── subscriptions.md
-│   ├── users.md
 │   └── ... (one file per table + view)
-├── relationships.json    # Every FK mapping: "episodes.subscription_id" → "subscriptions.id"
-└── functions.md          # All RPC functions with parameter signatures
+├── relationships.json    # Every FK mapping
+└── functions.md          # All RPC functions with parameters
 ```
 
 ### What a Table File Looks Like
@@ -226,202 +188,121 @@ One API call fetches the full OpenAPI spec from PostgREST, then splits it into s
 ```markdown
 # episodes
 
-15 columns | 1 PK | 2 FK
+15 columns | 1 PK | 2 FK | ~397 rows | 4216 kB
 
 | Column | Type | Nullable | Default | FK |
 |--------|------|----------|---------|-----|
 | id **PK** | uuid | NOT NULL | gen_random_uuid() |  |
 | subscription_id | uuid | NOT NULL |  | → subscriptions.id |
 | status | text | nullable | new |  |
-| audio_url | text | nullable |  |  |
 | metadata_id | uuid | nullable |  | → episode_metadata.id |
 ...
-
-## Notes
-- **processing_metadata**: Stores additional processing information and AI analysis results
 ```
 
-### Search the Snapshot
+### Context — Smart Query (Like CodeGraph)
 
 ```bash
-# Find everything related to "episode"
-supabase-skill search episode
-
-# Output:
-#   TABLES: episodes, episode_chunks, episode_metadata, ...
-#   COLUMNS: ai_sections.episode_id (uuid), segments.episode_id (uuid), ...
-#   FUNCTIONS: browse_episodes, episode_semantic_search, ...
-#   FKS: episodes.subscription_id → subscriptions.id, ...
-
-# JSON output for programmatic use
-supabase-skill search subscription --json
-```
-
-### Context — The Smart Query (Like CodeGraph's `codegraph_context`)
-
-```bash
-# "What's the full picture for episodes?"
 supabase-skill context episodes
 ```
 
-Returns everything in one shot:
-- Full column listing with types, PKs, FKs, defaults
-- All related tables (2 levels deep via FK chains)
-- Which direction: "references" vs "referenced by"
-- Related RPC functions
-- Column notes/descriptions
+Returns columns, FKs, related tables 2 levels deep, RPC functions, row counts, and sizes — all from local cache.
 
-```bash
-# Deeper FK traversal
-supabase-skill context episodes --depth 3
-
-# Topic-based (matches any table/column containing the term)
-supabase-skill context subscription
-supabase-skill context chat
-```
-
-### Table — Single Table Deep Dive
+### Columns — Cross-Database Search
 
 ```bash
-supabase-skill table subscriptions
+supabase-skill columns --type jsonb          # all jsonb columns
+supabase-skill columns --fk --table episode  # FK columns in episode tables
+supabase-skill columns --pk                  # all primary keys
+supabase-skill columns status                # find "status" columns
 ```
 
-Returns the full table file plus:
-- Outgoing FKs ("this table references")
-- Incoming FKs ("referenced by")
-- Related RPC functions (name-matched)
-- Related table summaries (column counts for each FK target)
-
-### Columns — Cross-Database Column Search
-
-Stop running `SELECT column_name FROM information_schema.columns WHERE...` every time.
+### Diff — Detect Schema Drift
 
 ```bash
-# Find all jsonb columns across the entire database
-supabase-skill columns --type jsonb
-
-# All foreign key columns in episode-related tables
-supabase-skill columns --fk --table episode
-
-# All primary keys
-supabase-skill columns --pk
-
-# All NOT NULL columns with defaults
-supabase-skill columns --not-null --has-default
-
-# Find all "status" columns and their types
-supabase-skill columns status
-
-# Combine: all uuid columns that are foreign keys
-supabase-skill columns --type uuid --fk
-```
-
-### How Agents Use It
-
-Instead of:
-```
-Agent: "Let me query the database to understand the schema..."
-→ runs SQL against information_schema (3-5 seconds, eats context)
-→ parses results
-→ stores in conversation memory
+supabase-skill diff
 ```
 
-Now:
-```
-Agent: reads .supabase-schema/tables/episodes.md (instant, 20 lines)
-Agent: reads .supabase-schema/relationships.json (instant, FK map)
-```
-
-The snapshot is **markdown** (not JSON) so Claude reads it naturally with zero parsing overhead. Add `.supabase-schema/` to your `.gitignore` and refresh with `supabase-skill snapshot` whenever your schema changes.
+Compares live database against local snapshot. Shows tables/columns/functions added or removed since last snapshot.
 
-## Multi-Format Output
-
-Generate the skill doc for different AI agent platforms:
+### Graph — Mermaid ER Diagram
 
 ```bash
-# Claude Code (CLAUDE.md)
-supabase-skill docs --format claude
-
-# OpenAI Codex (AGENTS.md)
-supabase-skill docs --format agents
-
-# Cursor (.cursorrules)
-supabase-skill docs --format cursor
+supabase-skill graph
+```
 
-# OpenClaw / ClawHub (SKILL.md with frontmatter)
-supabase-skill docs --format skill
+Outputs a mermaid erDiagram of all table relationships. Paste into docs, Notion, or let Claude read it.
 
-# Raw (no wrapping)
-supabase-skill docs
+```mermaid
+erDiagram
+  episodes }o--|| subscriptions : "subscription_id -> id"
+  episodes }o--|| episode_metadata : "metadata_id -> id"
+  segments }o--|| episodes : "episode_id -> id"
+  episode_chunks }o--|| episodes : "episode_id -> id"
 ```
 
-## Config File
-
-Stored at `~/.config/supabase-skill/config.json`:
-
-```json
-{
-  "environments": {
-    "prod": { "ref": "abcdefghijklmnopqrst", "name": "My App Production" },
-    "stage": { "ref": "tsrqponmlkjihgfedcba", "name": "My App Staging" }
-  },
-  "defaultEnv": "stage",
-  "safetyRules": {
-    "prodRequiresApproval": true,
-    "alwaysSpecifyRef": true
-  }
-}
-```
+## The Skill Doc (20 Sections)
 
-## Real-World Token Savings — Hard Numbers
+What gets written to CLAUDE.md — every Supabase CLI capability:
 
-We analyzed 14 Claude Code conversations on a production Supabase project (80 tables, 48 RPCs, 86 foreign keys) to measure how many tokens schema exploration actually consumes.
+| Section | What it teaches the agent |
+|---------|-------------------------|
+| **CLI Flag Reference** | Which commands use `--linked` vs `--project-ref` |
+| **Environment Routing** | "stage" → correct ref, "prod" → approval required |
+| **Data Operations (REST API)** | Full CRUD: SELECT with 12 filter operators, INSERT, UPDATE, UPSERT, DELETE, COUNT |
+| **Migrations** | `new`, `list`, `up`, `down`, `repair`, `squash`, `fetch` |
+| **DDL via Migrations** | CREATE/ALTER/DROP TABLE, VIEW, INDEX, FUNCTION, RLS, triggers, enums |
+| **Schema Management** | `db diff`, `dump`, `pull`, `push`, `lint` |
+| **Database Inspection** | All 12 `inspect db` commands + `inspect report` |
+| **Storage** | `ls`, `cp`, `rm`, `mv` (with `--experimental`) |
+| **Edge Functions** | `list`, `deploy`, `delete`, `new`, `download`, `serve` |
+| **Branches** | `list`, `create`, `delete`, `get`, `pause`, `unpause` |
+| **Backups** | `list`, `restore` (PITR) |
+| **Project Management** | `projects list/api-keys`, `secrets`, `postgres-config` |
+| **Code Generation** | `gen types` (TypeScript from schema) |
+| **Schema Snapshot** | All local query commands |
+| **Auto-Refresh** | Freshness check + nightly cron |
+| **Safety Rules** | Never mutate prod without approval, test on stage first |
 
-### Before supabase-skill (SQL queries every time)
+## Security Model
 
-| Metric | Value |
-|--------|-------|
-| Conversations doing schema exploration | **14** |
-| Total schema query + result dumps | **265 calls** |
-| Total tokens consumed by schema results | **~330,000** |
-| Cost at Opus rates ($15/M input) | **$4.96** |
-| Average tokens per schema call | **~1,247** |
-| Heaviest single query result | **~22,282 tokens** |
+| What | Where | Visible to agent? |
+|------|-------|-------------------|
+| Project refs | CLAUDE.md | Yes — needed for `--project-ref` |
+| Environment routing | CLAUDE.md | Yes — "stage" → which ref |
+| API keys (anon + service_role) | `.env` only | Only via `source .env` |
+| Config with keys | `~/.config/supabase-skill/config.json` | No — mode 600 |
+| Schema snapshot | `.supabase-schema/` | Yes — the whole point |
 
-#### Heaviest Conversations
+**Secrets never go in CLAUDE.md.** Agent reads `.env` when it needs direct API access.
 
-| Session | Calls | Tokens | Task |
-|---------|-------|--------|------|
-| Support AI Console planning | 56 | ~81,000 | Exploring tables for agent access |
-| Study Mode migration design | 41 | ~74,000 | Designing new tables + FKs |
-| Schema exploration | 43 | ~53,000 | General schema discovery |
-| Building supabase-skill | 24 | ~33,000 | This tool, ironically |
+## Real-World Token Savings
 
-### After supabase-skill (local snapshot)
+Measured across 14 Claude Code conversations on a production Supabase project (80 tables, 48 RPCs, 86 FKs):
 
-| Operation | Before (SQL query) | After (local file) | Savings |
-|-----------|-------------------|---------------------|---------|
+| Metric | Before | After | Savings |
+|--------|--------|-------|---------|
 | "What columns does episodes have?" | ~1,200 tokens | ~80 tokens | **93%** |
 | "Find all jsonb columns" | ~3,000 tokens | ~200 tokens | **93%** |
 | "What references episodes?" | ~2,000 tokens | ~150 tokens | **92%** |
 | "Show me the full schema" | ~22,000 tokens | ~500 tokens | **98%** |
+| **Total across 14 conversations** | **~330,000 tokens** | **~15,000 tokens** | **~95%** |
 
-**Conservative estimate**: Those 330,000 tokens across 14 conversations drop to roughly **15,000-20,000 tokens** with the local snapshot. That's a **~95% reduction** — or about **$4.70 saved** at Opus rates just from the conversations we measured.
-
-And that's just one project. The savings compound across every conversation, every day, for every developer on the team.
+At Opus rates ($15/M): **$4.70 saved** just from the conversations we measured.
 
 ## Why CLIs Beat MCP for Agents
 
-| | MCP Server | CLI Skill Doc |
+| | MCP Server | supabase-skill |
 |---|---|---|
-| **Context overhead** | 30-40% of context window consumed by schema | Zero — agent reads a concise doc |
-| **Schema exploration** | ~1,247 tokens per query (measured) | ~80-200 tokens per file read |
-| **Multi-environment** | One database per server instance | `--project-ref` switches instantly |
-| **Runtime** | Server process running in background | No process — just `exec` calls |
-| **Dependencies** | Protocol handshake, WebSocket, auth | `supabase` binary + a text file |
-| **Structured output** | Custom serialization | `-o json` flag built into every command |
-| **Composability** | None | Pipe output: `supabase ... -o json \| jq '...'` |
-| **Testing** | Spin up server, connect, send request | `supabase --help` in terminal |
+| **Context overhead** | 30-40% consumed by schema | Zero |
+| **Schema exploration** | ~1,247 tokens per query | ~80-200 tokens per file read |
+| **Multi-environment** | One database per server | `--project-ref` switches instantly |
+| **Runtime** | Server process in background | No process — `exec` calls |
+| **Permission prompts** | Every command | 23 read commands pre-approved |
+| **Schema freshness** | Always live (expensive) | Cached + nightly cron |
+| **Composability** | None | Pipe with `jq`, `grep`, etc. |
+| **Health check** | None | `doctor` validates 12 checks |
+| **Schema drift** | None | `diff` detects changes |
+| **ER diagrams** | None | `graph` outputs mermaid |
 
 ## Requirements
 

package/dist/commands/update.js

@@ -52,7 +52,12 @@ export function updateCommand() {
                 timeout: 60000,
                 stdio: "inherit",
             });
-            write(`\n  ✓ Updated to v${latest}\n\n`);
+            write(`\n  ✓ Updated to v${latest}\n`);
+            write("\n  Run `supabase-skill init` in your project directories to update:\n");
+            write("    - CLAUDE.md skill doc\n");
+            write("    - /supabase walkthrough skill\n");
+            write("    - Claude Code permissions\n");
+            write("    - Schema snapshot\n\n");
         }
         catch {
             write("  ✗ Update failed. Try: npm install -g @m2015agg/supabase-skill@latest\n\n");

package/dist/commands/update.js.map

@@ -1 +1 @@
-{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,SAAS,KAAK,CAAC,GAAW;IACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,iBAAiB;IACxB,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QACrF,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC;SACzB,WAAW,CAAC,6CAA6C,CAAC;SAC1D,MAAM,CAAC,SAAS,EAAE,sCAAsC,CAAC;SACzD,MAAM,CAAC,CAAC,IAAyB,EAAE,EAAE;QACpC,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;QAEpC,sBAAsB;QACtB,KAAK,CAAC,uBAAuB,OAAO,IAAI,CAAC,CAAC;QAC1C,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAExC,IAAI,MAAc,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,GAAG,QAAQ,CAAC,uDAAuD,EAAE;gBACzE,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,KAAK;aACf,CAAC,CAAC,IAAI,EAAE,CAAC;QACZ,CAAC;QAAC,MAAM,CAAC;YACP,KAAK,CAAC,wCAAwC,CAAC,CAAC;YAChD,OAAO;QACT,CAAC;QAED,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,KAAK,CAAC,yBAAyB,OAAO,OAAO,CAAC,CAAC;YAC/C,OAAO;QACT,CAAC;QAED,KAAK,CAAC,IAAI,MAAM,cAAc,CAAC,CAAC;QAEhC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,KAAK,CAAC,iDAAiD,MAAM,MAAM,CAAC,CAAC;YACrE,OAAO;QACT,CAAC;QAED,KAAK,CAAC,eAAe,OAAO,OAAO,MAAM,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC;YACH,QAAQ,CAAC,qDAAqD,EAAE;gBAC9D,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,SAAS;aACjB,CAAC,CAAC;YACH,KAAK,CAAC,qBAAqB,MAAM,MAAM,CAAC,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,KAAK,CAAC,4EAA4E,CAAC,CAAC;QACtF,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,SAAS,KAAK,CAAC,GAAW;IACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,iBAAiB;IACxB,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QACrF,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC;SACzB,WAAW,CAAC,6CAA6C,CAAC;SAC1D,MAAM,CAAC,SAAS,EAAE,sCAAsC,CAAC;SACzD,MAAM,CAAC,CAAC,IAAyB,EAAE,EAAE;QACpC,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;QAEpC,sBAAsB;QACtB,KAAK,CAAC,uBAAuB,OAAO,IAAI,CAAC,CAAC;QAC1C,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAExC,IAAI,MAAc,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,GAAG,QAAQ,CAAC,uDAAuD,EAAE;gBACzE,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,KAAK;aACf,CAAC,CAAC,IAAI,EAAE,CAAC;QACZ,CAAC;QAAC,MAAM,CAAC;YACP,KAAK,CAAC,wCAAwC,CAAC,CAAC;YAChD,OAAO;QACT,CAAC;QAED,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,KAAK,CAAC,yBAAyB,OAAO,OAAO,CAAC,CAAC;YAC/C,OAAO;QACT,CAAC;QAED,KAAK,CAAC,IAAI,MAAM,cAAc,CAAC,CAAC;QAEhC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,KAAK,CAAC,iDAAiD,MAAM,MAAM,CAAC,CAAC;YACrE,OAAO;QACT,CAAC;QAED,KAAK,CAAC,eAAe,OAAO,OAAO,MAAM,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC;YACH,QAAQ,CAAC,qDAAqD,EAAE;gBAC9D,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,SAAS;aACjB,CAAC,CAAC;YACH,KAAK,CAAC,qBAAqB,MAAM,IAAI,CAAC,CAAC;YACvC,KAAK,CAAC,wEAAwE,CAAC,CAAC;YAChF,KAAK,CAAC,6BAA6B,CAAC,CAAC;YACrC,KAAK,CAAC,qCAAqC,CAAC,CAAC;YAC7C,KAAK,CAAC,iCAAiC,CAAC,CAAC;YACzC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,KAAK,CAAC,4EAA4E,CAAC,CAAC;QACtF,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/index.js

@@ -20,7 +20,7 @@ const program = new Command();
 program
     .name("supabase-skill")
     .description("Supabase CLI skill for AI agents. Installs comprehensive CLI instructions into CLAUDE.md with multi-environment support.")
-    .version("0.7.0");
+    .version("0.7.2");
 program.addCommand(installCommand());
 program.addCommand(initCommand());
 program.addCommand(docsCommand());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m2015agg/supabase-skill",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "Supabase CLI skill for AI agents. Installs comprehensive CLI instructions into CLAUDE.md, AGENTS.md, or .cursorrules with multi-environment support.",
   "type": "module",
   "main": "./dist/index.js",