@m2015agg/supabase-skill 0.1.0

package/dist/commands/context.js

@@ -0,0 +1,236 @@
+import { Command } from "commander";
+import { join } from "node:path";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { hasDb, openDb, getTableColumns, getRelatedTables, findMatchingFunctions, getAllTableNames, } from "../util/db.js";
+function write(msg) {
+    process.stdout.write(msg);
+}
+function parseTableFile(filePath) {
+    const content = readFileSync(filePath, "utf-8");
+    const columns = [];
+    const notes = [];
+    let inNotes = false;
+    for (const line of content.split("\n")) {
+        if (line.startsWith("## Notes")) {
+            inNotes = true;
+            continue;
+        }
+        if (inNotes && line.startsWith("- ")) {
+            notes.push(line);
+            continue;
+        }
+        if (line.startsWith("|") && !line.startsWith("| Column") && !line.startsWith("|---")) {
+            const cols = line.split("|").slice(1, -1).map((c) => c.trim());
+            if (cols.length >= 5) {
+                columns.push({
+                    name: cols[0].replace(/\s*\*\*PK\*\*/, ""),
+                    type: cols[1], nullable: cols[2], defaultVal: cols[3],
+                    fk: cols[4], isPk: cols[0].includes("**PK**"),
+                });
+            }
+        }
+    }
+    return { columns, notes };
+}
+// ─── SQLite Path ───
+function renderColumnsFromDb(cols) {
+    const pkCount = cols.filter((c) => c.is_pk).length;
+    const fkCount = cols.filter((c) => c.fk_table).length;
+    write(`${cols.length} columns | ${pkCount} PK | ${fkCount} FK\n\n`);
+    write("| Column | Type | Nullable | Default | FK |\n");
+    write("|--------|------|----------|---------|----|");
+    for (const col of cols) {
+        const pk = col.is_pk ? " **PK**" : "";
+        const nullable = col.nullable ? "nullable" : "NOT NULL";
+        const fk = col.fk_table ? `→ ${col.fk_table}.${col.fk_column}` : "";
+        write(`\n| ${col.name}${pk} | ${col.type || "unknown"} | ${nullable} | ${col.default_value || ""} | ${fk} |`);
+    }
+    write("\n\n");
+    const notes = cols.filter((c) => c.description);
+    if (notes.length > 0) {
+        for (const col of notes) {
+            write(`- **${col.name}**: ${col.description}\n`);
+        }
+        write("\n");
+    }
+}
+function runSqlite(schemaDir, query, depth, jsonMode) {
+    const db = openDb(schemaDir);
+    const q = query.toLowerCase();
+    const allTables = getAllTableNames(db);
+    let entryTables = allTables.filter((t) => t === q);
+    if (entryTables.length === 0)
+        entryTables = allTables.filter((t) => t.includes(q));
+    if (entryTables.length === 0) {
+        // Search by column name
+        const colMatches = db.prepare("SELECT DISTINCT table_name FROM columns WHERE name LIKE ?").all(`%${q}%`);
+        entryTables = colMatches.map((r) => r.table_name);
+    }
+    const matchingFuncs = findMatchingFunctions(db, q);
+    if (jsonMode) {
+        const result = entryTables.slice(0, 5).map((table) => ({
+            name: table,
+            columns: getTableColumns(db, table),
+            related: getRelatedTables(db, table, depth),
+        }));
+        db.close();
+        write(JSON.stringify({ entryTables: result, functions: matchingFuncs }, null, 2) + "\n");
+        return;
+    }
+    if (entryTables.length === 0 && matchingFuncs.length === 0) {
+        db.close();
+        write(`No tables or columns match "${query}"\n`);
+        return;
+    }
+    write(`\n# Context for "${query}"\n\n`);
+    for (const table of entryTables.slice(0, 5)) {
+        const cols = getTableColumns(db, table);
+        const related = getRelatedTables(db, table, depth);
+        write(`## ${table}\n`);
+        renderColumnsFromDb(cols);
+        const refs = related.filter((r) => r.direction === "references");
+        const refBy = related.filter((r) => r.direction === "referenced by");
+        if (refs.length > 0 || refBy.length > 0) {
+            write("### Related Tables\n\n");
+            if (refs.length > 0) {
+                write("**References (this table points to):**\n");
+                for (const r of refs)
+                    write(`  → ${r.table_name} via ${r.from_column} → ${r.table_name}.${r.to_column}\n`);
+                write("\n");
+            }
+            if (refBy.length > 0) {
+                write("**Referenced by (points to this table):**\n");
+                for (const r of refBy)
+                    write(`  ← ${r.table_name} via ${r.table_name}.${r.from_column} → ${r.to_column}\n`);
+                write("\n");
+            }
+        }
+        write("---\n\n");
+    }
+    if (entryTables.length > 5)
+        write(`... and ${entryTables.length - 5} more matching tables\n\n`);
+    if (matchingFuncs.length > 0) {
+        write("## Related Functions\n\n");
+        for (const func of matchingFuncs) {
+            const params = JSON.parse(func.params || "[]");
+            const paramStr = params.length > 0 ? `(${params.map((p) => `${p.name}`).join(", ")})` : "()";
+            write(`- \`${func.name}${paramStr}\`\n`);
+        }
+        write("\n");
+    }
+    db.close();
+}
+// ─── Markdown Fallback Path ───
+function runMarkdown(schemaDir, query, depth, jsonMode) {
+    const tablesDir = join(schemaDir, "tables");
+    const allTables = readdirSync(tablesDir).filter((f) => f.endsWith(".md")).map((f) => f.replace(".md", ""));
+    const q = query.toLowerCase();
+    let entryTables = allTables.filter((t) => t === q);
+    if (entryTables.length === 0)
+        entryTables = allTables.filter((t) => t.includes(q));
+    if (entryTables.length === 0) {
+        for (const table of allTables) {
+            const { columns } = parseTableFile(join(tablesDir, `${table}.md`));
+            if (columns.some((c) => c.name.toLowerCase().includes(q)))
+                entryTables.push(table);
+        }
+    }
+    // Load relationships
+    const relsFile = join(schemaDir, "relationships.json");
+    const rels = existsSync(relsFile) ? JSON.parse(readFileSync(relsFile, "utf-8")) : {};
+    // Load functions
+    const funcsFile = join(schemaDir, "functions.md");
+    const matchingFuncs = [];
+    if (existsSync(funcsFile)) {
+        for (const line of readFileSync(funcsFile, "utf-8").split("\n")) {
+            if (line.startsWith("## ") && line.toLowerCase().includes(q)) {
+                matchingFuncs.push(line.replace("## ", ""));
+            }
+        }
+    }
+    if (jsonMode) {
+        const result = entryTables.slice(0, 5).map((table) => {
+            const { columns, notes } = parseTableFile(join(tablesDir, `${table}.md`));
+            return { name: table, columns, notes };
+        });
+        write(JSON.stringify({ entryTables: result, functions: matchingFuncs }, null, 2) + "\n");
+        return;
+    }
+    if (entryTables.length === 0 && matchingFuncs.length === 0) {
+        write(`No tables or columns match "${query}"\n`);
+        return;
+    }
+    write(`\n# Context for "${query}"\n\n`);
+    for (const table of entryTables.slice(0, 5)) {
+        const { columns, notes } = parseTableFile(join(tablesDir, `${table}.md`));
+        write(`## ${table}\n`);
+        write(`${columns.length} columns | ${columns.filter((c) => c.isPk).length} PK | ${columns.filter((c) => c.fk).length} FK\n\n`);
+        write("| Column | Type | Nullable | Default | FK |\n");
+        write("|--------|------|----------|---------|----|");
+        for (const col of columns) {
+            const pk = col.isPk ? " **PK**" : "";
+            write(`\n| ${col.name}${pk} | ${col.type} | ${col.nullable} | ${col.defaultVal} | ${col.fk} |`);
+        }
+        write("\n\n");
+        if (notes.length > 0) {
+            for (const note of notes)
+                write(`${note}\n`);
+            write("\n");
+        }
+        // Find related tables via relationships
+        const outgoing = [];
+        const incoming = [];
+        for (const [from, to] of Object.entries(rels)) {
+            const [fromTable] = from.split(".");
+            const [toTable] = to.split(".");
+            if (fromTable === table)
+                outgoing.push(`  → ${toTable} via ${from.split(".")[1]} → ${to}`);
+            if (toTable === table)
+                incoming.push(`  ← ${fromTable} via ${from}`);
+        }
+        if (outgoing.length > 0 || incoming.length > 0) {
+            write("### Related Tables\n\n");
+            if (outgoing.length > 0) {
+                write("**References (this table points to):**\n");
+                outgoing.forEach((r) => write(r + "\n"));
+                write("\n");
+            }
+            if (incoming.length > 0) {
+                write("**Referenced by (points to this table):**\n");
+                incoming.forEach((r) => write(r + "\n"));
+                write("\n");
+            }
+        }
+        write("---\n\n");
+    }
+    if (matchingFuncs.length > 0) {
+        write("## Related Functions\n\n");
+        for (const func of matchingFuncs)
+            write(`- \`${func}\`\n`);
+        write("\n");
+    }
+}
+export function contextCommand() {
+    return new Command("context")
+        .description("Get comprehensive context for a table or topic — related tables, FKs, functions, column details")
+        .argument("<query>", "Table name or topic (e.g., 'episodes', 'user subscriptions', 'chat')")
+        .option("--dir <dir>", "Schema directory", ".supabase-schema")
+        .option("--depth <n>", "FK traversal depth", "2")
+        .option("--json", "Output as JSON")
+        .action((query, opts) => {
+        const schemaDir = join(process.cwd(), opts.dir);
+        const depth = parseInt(opts.depth, 10);
+        if (!existsSync(schemaDir)) {
+            write(`No schema snapshot found at ${opts.dir}/\n`);
+            write("Run `supabase-skill snapshot` first.\n");
+            process.exit(1);
+        }
+        if (hasDb(schemaDir)) {
+            runSqlite(schemaDir, query, depth, !!opts.json);
+        }
+        else {
+            runMarkdown(schemaDir, query, depth, !!opts.json);
+        }
+    });
+}
+//# sourceMappingURL=context.js.map

package/dist/commands/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"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"}

package/dist/commands/cron.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function cronCommand(): Command;

package/dist/commands/cron.js

@@ -0,0 +1,116 @@
+import { Command } from "commander";
+import { execSync } from "node:child_process";
+import { resolve } from "node:path";
+import { readConfig } from "../util/config.js";
+function write(msg) {
+    process.stdout.write(msg);
+}
+function getSnapshotCommand(projectDir, ref) {
+    const binPath = resolve(process.argv[1]);
+    return `cd "${projectDir}" && "${binPath}" snapshot --project-ref ${ref} --output .supabase-schema 2>&1 >> /tmp/supabase-skill-cron.log`;
+}
+function getCrontab() {
+    try {
+        return execSync("crontab -l 2>/dev/null", { encoding: "utf-8" });
+    }
+    catch {
+        return "";
+    }
+}
+function setCrontab(content) {
+    execSync(`echo '${content.replace(/'/g, "'\\''")}' | crontab -`, { encoding: "utf-8" });
+}
+const MARKER = "# supabase-skill snapshot";
+export function cronCommand() {
+    return new Command("cron")
+        .description("Set up nightly cron job to auto-refresh schema snapshot")
+        .option("--time <HH:MM>", "Time to run (24h format)", "03:00")
+        .option("--remove", "Remove the cron job")
+        .option("--status", "Show current cron status")
+        .action((opts) => {
+        const config = readConfig();
+        const cwd = process.cwd();
+        if (opts.status) {
+            const crontab = getCrontab();
+            const existing = crontab.split("\n").filter((l) => l.includes(MARKER) || (l.trim() && !l.startsWith("#") && l.includes("supabase-skill")));
+            if (existing.length > 0) {
+                write("Active supabase-skill cron jobs:\n");
+                for (const line of existing) {
+                    if (!line.startsWith("#"))
+                        write(`  ${line}\n`);
+                }
+            }
+            else {
+                write("No supabase-skill cron jobs configured.\n");
+                write("Run `supabase-skill cron` to set up nightly snapshot refresh.\n");
+            }
+            return;
+        }
+        if (opts.remove) {
+            const crontab = getCrontab();
+            const lines = crontab.split("\n");
+            const filtered = [];
+            let skipNext = false;
+            for (const line of lines) {
+                if (line.includes(MARKER)) {
+                    skipNext = true;
+                    continue;
+                }
+                if (skipNext && line.includes("supabase-skill")) {
+                    skipNext = false;
+                    continue;
+                }
+                skipNext = false;
+                filtered.push(line);
+            }
+            const newCrontab = filtered.join("\n").replace(/\n{3,}/g, "\n\n").trim();
+            setCrontab(newCrontab);
+            write("Removed supabase-skill cron job.\n");
+            return;
+        }
+        // Set up cron
+        let ref;
+        if (config) {
+            const stageEnv = config.environments["stage"] || config.environments[config.defaultEnv];
+            if (stageEnv)
+                ref = stageEnv.ref;
+        }
+        if (!ref) {
+            write("No environment configured. Run `supabase-skill install` first.\n");
+            process.exit(1);
+        }
+        const [hour, minute] = opts.time.split(":");
+        const cronExpr = `${minute || "0"} ${hour || "3"} * * *`;
+        const cmd = getSnapshotCommand(cwd, ref);
+        // Remove existing entry if present
+        let crontab = getCrontab();
+        const lines = crontab.split("\n");
+        const filtered = [];
+        let skipNext = false;
+        for (const line of lines) {
+            if (line.includes(MARKER)) {
+                skipNext = true;
+                continue;
+            }
+            if (skipNext && line.includes("supabase-skill")) {
+                skipNext = false;
+                continue;
+            }
+            skipNext = false;
+            filtered.push(line);
+        }
+        crontab = filtered.join("\n").replace(/\n{3,}/g, "\n\n").trim();
+        // Add new entry
+        const newEntry = `${MARKER} (${cwd})\n${cronExpr} ${cmd}`;
+        const newCrontab = crontab ? `${crontab}\n\n${newEntry}` : newEntry;
+        setCrontab(newCrontab);
+        write(`\n  Cron job configured:\n`);
+        write(`    Schedule: ${cronExpr} (${opts.time} daily)\n`);
+        write(`    Project: ${cwd}\n`);
+        write(`    Ref: ${ref}\n`);
+        write(`    Log: /tmp/supabase-skill-cron.log\n\n`);
+        write(`  To check status: supabase-skill cron --status\n`);
+        write(`  To remove: supabase-skill cron --remove\n\n`);
+    });
+}
+//# sourceMappingURL=cron.js.map

package/dist/commands/cron.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.js","sourceRoot":"","sources":["../../src/commands/cron.ts"],"names":[],"mappings":"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"}

package/dist/commands/docs.d.ts

@@ -0,0 +1,4 @@
+import { Command } from "commander";
+import { type SkillConfig } from "../util/config.js";
+export declare function getSkillDoc(config?: SkillConfig | null): string;
+export declare function docsCommand(): Command;

package/dist/commands/docs.js

@@ -0,0 +1,182 @@
+import { Command } from "commander";
+import { readConfig } from "../util/config.js";
+function buildEnvSection(config) {
+    if (!config || Object.keys(config.environments).length === 0) {
+        return `### Environments
+- Configure with \`supabase-skill install\` to set project refs
+- Use \`--project-ref <ref>\` with every remote command`;
+    }
+    const lines = ["### Environments"];
+    for (const [env, { ref, name }] of Object.entries(config.environments)) {
+        const warning = env === "prod" ? " — \u26a0\ufe0f NEVER modify without explicit approval" : "";
+        const label = env.toUpperCase();
+        lines.push(`- **${label}**: \`${ref}\` (${name})${warning}`);
+    }
+    // Add safety reminder
+    if (config.environments["prod"]) {
+        lines.push(`- **Default**: Use STAGE for testing. PROD requires explicit approval.`);
+    }
+    return lines.join("\n");
+}
+export function getSkillDoc(config = null) {
+    const envSection = buildEnvSection(config);
+    return `## supabase-cli (Supabase Database & Infrastructure)
+
+Requires: \`supabase\` CLI installed, logged in via \`supabase login\`.
+All commands support \`-o json\` for structured output.
+
+${envSection}
+
+### SQL Execution (daily use)
+- \`supabase db execute --project-ref <ref> --stdin <<< "SELECT 1"\` — run inline SQL
+- \`supabase db execute --project-ref <ref> -f path/to/file.sql\` — run SQL file
+
+### Migrations
+- \`supabase migration new <name>\` — create empty migration file
+- \`supabase migration list --project-ref <ref>\` — compare local vs remote
+- \`supabase migration up --project-ref <ref>\` — apply pending to remote
+- \`supabase migration down --project-ref <ref> -n 1\` — rollback last N migrations
+- \`supabase migration repair --status applied <version> --project-ref <ref>\` — mark version as applied
+- \`supabase migration repair --status reverted <version> --project-ref <ref>\` — mark version as reverted
+- \`supabase migration squash --project-ref <ref>\` — combine into single file
+- \`supabase migration fetch --project-ref <ref>\` — pull history from remote
+
+### Schema Management
+- \`supabase db diff --project-ref <ref>\` — diff local vs remote schema
+- \`supabase db dump --project-ref <ref>\` — dump full schema
+- \`supabase db dump --project-ref <ref> --data-only\` — dump data only
+- \`supabase db dump --project-ref <ref> --schema <name>\` — dump specific schema
+- \`supabase db pull --project-ref <ref>\` — pull remote schema to local migrations
+- \`supabase db push --project-ref <ref>\` — push migrations to remote
+- \`supabase db lint\` — check for typing errors
+
+### Database Inspection (debugging/support)
+- \`supabase inspect db table-stats --project-ref <ref>\` — table sizes + row counts
+- \`supabase inspect db index-stats --project-ref <ref>\` — index usage + scan counts
+- \`supabase inspect db long-running-queries --project-ref <ref>\` — queries > 5min
+- \`supabase inspect db outliers --project-ref <ref>\` — slowest queries by total time
+- \`supabase inspect db bloat --project-ref <ref>\` — dead tuple estimation
+- \`supabase inspect db locks --project-ref <ref>\` — active locks
+- \`supabase inspect db blocking --project-ref <ref>\` — blocking lock chains
+- \`supabase inspect db db-stats --project-ref <ref>\` — cache hit rates, WAL, sizes
+- \`supabase inspect db vacuum-stats --project-ref <ref>\` — vacuum status per table
+- \`supabase inspect db role-stats --project-ref <ref>\` — role information
+- \`supabase inspect db replication-slots --project-ref <ref>\` — replication status
+- \`supabase inspect report --project-ref <ref>\` — CSV of ALL inspect commands
+
+### Storage
+- \`supabase storage ls ss://bucket/path --project-ref <ref>\` — list objects
+- \`supabase storage cp local.file ss://bucket/path --project-ref <ref>\` — upload
+- \`supabase storage cp ss://bucket/path local.file --project-ref <ref>\` — download
+- \`supabase storage rm ss://bucket/path --project-ref <ref>\` — delete
+- \`supabase storage mv ss://old ss://new --project-ref <ref>\` — move/rename
+
+### Edge Functions
+- \`supabase functions list --project-ref <ref>\` — list deployed functions
+- \`supabase functions deploy <name> --project-ref <ref>\` — deploy function
+- \`supabase functions delete <name> --project-ref <ref>\` — delete function
+- \`supabase functions serve\` — serve locally for testing
+
+### Project Management
+- \`supabase projects list -o json\` — list all projects
+- \`supabase projects api-keys --project-ref <ref> -o json\` — get API keys
+- \`supabase secrets list --project-ref <ref>\` — list env secrets
+- \`supabase secrets set KEY=VALUE --project-ref <ref>\` — set secret
+
+### SQL Snippets (from dashboard)
+- \`supabase snippets list --project-ref <ref> -o json\` — list saved snippets
+- \`supabase snippets download <id> --project-ref <ref>\` — download snippet SQL
+
+### Setup
+- \`supabase-skill install\` — global setup (interactive wizard, adds to ~/.claude/CLAUDE.md)
+- \`supabase-skill init\` — per-project setup (CLAUDE.md + .env + .gitignore)
+- \`supabase-skill docs\` — output LLM instruction snippet
+- \`supabase-skill docs --format claude\` — CLAUDE.md format
+- \`supabase-skill envs\` — list configured environments
+
+### Schema Snapshot (local DB map — use INSTEAD of querying information_schema)
+If \`.supabase-schema/\` exists, ALWAYS use these commands instead of running SQL to explore the schema:
+- \`supabase-skill snapshot\` — snapshot schema to .supabase-schema/ (tables, columns, FKs, functions)
+- \`supabase-skill snapshot --project-ref <ref>\` — snapshot a specific environment
+- \`supabase-skill context <table-or-topic>\` — get full context: columns, FKs, related tables (2 levels deep), related functions
+- \`supabase-skill context <topic> --depth 3\` — deeper FK traversal
+- \`supabase-skill table <name>\` — full single-table detail with relationships, functions, related table summaries
+- \`supabase-skill columns --type <type>\` — find all columns of a type (uuid, jsonb, text, timestamp, etc.)
+- \`supabase-skill columns --fk\` — find all foreign key columns
+- \`supabase-skill columns --table <name>\` — filter columns to specific table
+- \`supabase-skill columns <name> --type jsonb\` — combine name + type filters
+- \`supabase-skill search <query>\` — search tables, columns, functions, and relationships
+- \`supabase-skill search <query> --json\` — structured JSON output
+- Read \`.supabase-schema/tables/<name>.md\` — full table schema (columns, types, PKs, FKs, defaults)
+- Read \`.supabase-schema/index.md\` — overview of all tables, views, functions
+- Read \`.supabase-schema/relationships.json\` — all foreign key mappings
+- Read \`.supabase-schema/functions.md\` — all RPC functions with parameters
+
+### Schema Snapshot Auto-Refresh
+- Snapshot refreshes nightly via cron (if configured with \`supabase-skill cron\`)
+- **After applying migrations**: Run \`supabase-skill snapshot\` to update the local schema cache
+- **After creating/altering tables**: Run \`supabase-skill snapshot\` before continuing work
+- **Rule of thumb**: If you ran any DDL (CREATE, ALTER, DROP) or migration commands, refresh the snapshot immediately
+
+### Safety Rules
+- NEVER run mutations on PROD without explicit user approval
+- ALWAYS specify \`--project-ref\` — never rely on linked project for remote ops
+- Use \`-o json\` for structured output the agent can parse
+- Run \`supabase migration list\` BEFORE and AFTER migration operations
+- Test migrations on STAGE before applying to PROD
+
+### Exit codes
+- 0 = success, 1 = error`;
+}
+const FORMATS = {
+    claude: {
+        filename: "CLAUDE.md",
+        wrap: (c) => c,
+    },
+    agents: {
+        filename: "AGENTS.md",
+        wrap: (c) => c,
+    },
+    cursor: {
+        filename: ".cursorrules",
+        wrap: (c) => c,
+    },
+    skill: {
+        filename: "SKILL.md",
+        wrap: (c) => `---
+name: supabase-skill
+description: Manage Supabase databases, migrations, storage, and edge functions via CLI. Multi-environment support (dev/stage/prod).
+metadata:
+  requires:
+    env:
+      - SUPABASE_ACCESS_TOKEN
+    bins:
+      - supabase
+    primaryEnv: SUPABASE_ACCESS_TOKEN
+---
+
+# supabase-skill
+
+${c}`,
+    },
+    raw: {
+        filename: "",
+        wrap: (c) => c,
+    },
+};
+export function docsCommand() {
+    return new Command("docs")
+        .description("Generate LLM instruction snippet for supabase-skill. Outputs to stdout.")
+        .option("--format <type>", "Output format: claude, agents, cursor, skill, raw (default: raw)", "raw")
+        .action((opts) => {
+        const fmt = FORMATS[opts.format];
+        if (!fmt) {
+            process.stderr.write(`Unknown format: ${opts.format}. Use: ${Object.keys(FORMATS).join(", ")}\n`);
+            process.exit(1);
+        }
+        const config = readConfig();
+        const doc = getSkillDoc(config);
+        process.stdout.write(fmt.wrap(doc) + "\n");
+    });
+}
+//# sourceMappingURL=docs.js.map

package/dist/commands/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/commands/docs.ts"],"names":[],"mappings":"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"}

package/dist/commands/envs.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function envsCommand(): Command;

package/dist/commands/envs.js

@@ -0,0 +1,22 @@
+import { Command } from "commander";
+import { readConfig } from "../util/config.js";
+export function envsCommand() {
+    return new Command("envs")
+        .description("List configured Supabase environments")
+        .action(() => {
+        const config = readConfig();
+        if (!config || Object.keys(config.environments).length === 0) {
+            process.stdout.write("No environments configured.\n");
+            process.stdout.write("Run `supabase-skill install` to set up environments.\n");
+            return;
+        }
+        process.stdout.write("\nConfigured environments:\n");
+        for (const [env, { ref, name }] of Object.entries(config.environments)) {
+            const isDefault = env === config.defaultEnv ? " (default)" : "";
+            const isProd = env === "prod" ? " \u26a0\ufe0f" : "";
+            process.stdout.write(`  ${env.toUpperCase()}: ${ref} — ${name}${isDefault}${isProd}\n`);
+        }
+        process.stdout.write("\n");
+    });
+}
+//# sourceMappingURL=envs.js.map

package/dist/commands/envs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envs.js","sourceRoot":"","sources":["../../src/commands/envs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,UAAU,WAAW;IACzB,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;SACvB,WAAW,CAAC,uCAAuC,CAAC;SACpD,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAE5B,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;YACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;YAC/E,OAAO;QACT,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACrD,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;YACvE,MAAM,SAAS,GAAG,GAAG,KAAK,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,MAAM,MAAM,GAAG,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,WAAW,EAAE,KAAK,GAAG,MAAM,IAAI,GAAG,SAAS,GAAG,MAAM,IAAI,CAAC,CAAC;QAC1F,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function initCommand(): Command;