metabase-iac 0.1.0 → 0.2.0

package/dist/cli.js

@@ -4,12 +4,26 @@ import chalk from 'chalk';
 import { createClient } from './auth.js';
 import { apply } from './commands/apply.js';
 import { pull } from './commands/pull.js';
+import { init } from './commands/init.js';
+import { diff } from './commands/diff.js';
 import { saveState } from './state.js';
 const program = new Command();
 program
     .name('metabase-iac')
     .description('Infrastructure as Code for Metabase')
     .version('0.1.0');
+program
+    .command('init [directory]')
+    .description('Scaffold a new metabase-iac project')
+    .action(async (directory) => {
+    try {
+        await init(directory);
+    }
+    catch (err) {
+        console.error(chalk.red(`Error: ${err.message}`));
+        process.exit(1);
+    }
+});
 program
     .command('pull')
     .description('Import all collections, questions, dashboards from Metabase into local files')
@@ -28,6 +42,20 @@ program
         process.exit(1);
     }
 });
+program
+    .command('diff')
+    .description('Compare local resources against the current Metabase state')
+    .option('-d, --dir <dir>', 'Resources directory', '.')
+    .action(async (opts) => {
+    try {
+        const client = await createClient();
+        await diff(client, opts.dir);
+    }
+    catch (err) {
+        console.error(chalk.red(`Error: ${err.message}`));
+        process.exit(1);
+    }
+});
 program
     .command('plan')
     .description('Show what changes would be applied (dry run)')

package/dist/cli.js.map

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

package/dist/commands/diff.d.ts

@@ -0,0 +1,3 @@
+import type { MetabaseClient } from '../client.js';
+export declare function diff(client: MetabaseClient, resourceDir?: string): Promise<void>;
+//# sourceMappingURL=diff.d.ts.map

package/dist/commands/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/commands/diff.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAelD,wBAAsB,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,WAAW,GAAE,MAAY,iBAgH3E"}

package/dist/commands/diff.js

@@ -0,0 +1,216 @@
+import chalk from 'chalk';
+import { Resolver } from '../resolver.js';
+export async function diff(client, resourceDir = '.') {
+    const { loadResources } = await import('../loader.js');
+    console.log('Loading local resources...');
+    const localResources = await loadResources(resourceDir);
+    console.log('Fetching remote state from Metabase...\n');
+    const resolver = new Resolver();
+    await resolver.init(client);
+    const remoteCollections = await client.getCollections();
+    const remoteCards = await client.getCards();
+    const remoteDashboardsList = await client.getDashboards();
+    const activeCollections = remoteCollections.filter((c) => !c.archived && c.id !== 0);
+    const activeCards = remoteCards.filter((c) => !c.archived);
+    const activeDashboards = remoteDashboardsList.filter((d) => !d.archived);
+    const entries = [];
+    // Diff collections
+    const remoteCollectionsByName = new Map();
+    for (const c of activeCollections)
+        remoteCollectionsByName.set(c.name, c);
+    const localCollections = localResources.filter((r) => r.kind === 'collection');
+    const seenCollections = new Set();
+    for (const local of localCollections) {
+        seenCollections.add(local.name);
+        const remote = remoteCollectionsByName.get(local.name);
+        if (!remote) {
+            entries.push({ kind: 'collection', name: local.name, status: 'added' });
+        }
+        else {
+            const changes = diffCollection(local, remote);
+            entries.push({
+                kind: 'collection',
+                name: local.name,
+                status: changes.length > 0 ? 'changed' : 'unchanged',
+                changes,
+            });
+        }
+    }
+    for (const remote of activeCollections) {
+        if (!seenCollections.has(remote.name) && remote.name !== 'Our analytics') {
+            entries.push({ kind: 'collection', name: remote.name, status: 'removed' });
+        }
+    }
+    // Diff questions
+    const remoteCardsByName = new Map();
+    for (const c of activeCards)
+        remoteCardsByName.set(c.name, c);
+    const localQuestions = localResources.filter((r) => r.kind === 'question');
+    const seenQuestions = new Set();
+    for (const local of localQuestions) {
+        seenQuestions.add(local.name);
+        const remote = remoteCardsByName.get(local.name);
+        if (!remote) {
+            entries.push({ kind: 'question', name: local.name, status: 'added' });
+        }
+        else {
+            const changes = diffQuestion(local, remote, resolver);
+            entries.push({
+                kind: 'question',
+                name: local.name,
+                status: changes.length > 0 ? 'changed' : 'unchanged',
+                changes,
+            });
+        }
+    }
+    for (const remote of activeCards) {
+        if (!seenQuestions.has(remote.name)) {
+            entries.push({ kind: 'question', name: remote.name, status: 'removed' });
+        }
+    }
+    // Diff dashboards
+    const remoteDashboardsByName = new Map();
+    for (const d of activeDashboards) {
+        const full = await client.getDashboard(d.id);
+        remoteDashboardsByName.set(full.name, full);
+    }
+    const localDashboards = localResources.filter((r) => r.kind === 'dashboard');
+    const seenDashboards = new Set();
+    for (const local of localDashboards) {
+        seenDashboards.add(local.name);
+        const remote = remoteDashboardsByName.get(local.name);
+        if (!remote) {
+            entries.push({ kind: 'dashboard', name: local.name, status: 'added' });
+        }
+        else {
+            const changes = diffDashboard(local, remote, activeCards, resolver);
+            entries.push({
+                kind: 'dashboard',
+                name: local.name,
+                status: changes.length > 0 ? 'changed' : 'unchanged',
+                changes,
+            });
+        }
+    }
+    for (const [name] of remoteDashboardsByName) {
+        if (!seenDashboards.has(name)) {
+            entries.push({ kind: 'dashboard', name, status: 'removed' });
+        }
+    }
+    // Print results
+    printDiff(entries);
+}
+function diffCollection(local, remote) {
+    const changes = [];
+    if (local.description && local.description !== (remote.description ?? '')) {
+        changes.push(`description: "${remote.description ?? ''}" → "${local.description}"`);
+    }
+    return changes;
+}
+function diffQuestion(local, remote, resolver) {
+    const changes = [];
+    const remoteCollection = resolver.getCollectionName(remote.collection_id);
+    if (local.collection && local.collection !== remoteCollection) {
+        changes.push(`collection: "${remoteCollection}" → "${local.collection}"`);
+    }
+    if (local.display && local.display !== remote.display) {
+        changes.push(`display: "${remote.display}" → "${local.display}"`);
+    }
+    const remoteDb = resolver.getDatabaseName(remote.database_id);
+    if (local.database && local.database !== remoteDb) {
+        changes.push(`database: "${remoteDb}" → "${local.database}"`);
+    }
+    // Compare native query text
+    if (local.type === 'native' && remote.dataset_query?.native) {
+        const localQuery = local.query.trim();
+        const remoteQuery = (remote.dataset_query.native.query ?? '').trim();
+        if (localQuery !== remoteQuery) {
+            changes.push('query: content changed');
+        }
+    }
+    return changes;
+}
+function diffDashboard(local, remote, allCards, resolver) {
+    const changes = [];
+    const remoteCollection = resolver.getCollectionName(remote.collection_id);
+    if (local.collection && local.collection !== remoteCollection) {
+        changes.push(`collection: "${remoteCollection}" → "${local.collection}"`);
+    }
+    if (local.description !== undefined && local.description !== (remote.description ?? null)) {
+        changes.push(`description changed`);
+    }
+    // Compare card count
+    const localCardCount = (local.cards ?? []).length;
+    const remoteCardCount = (remote.dashcards ?? []).length;
+    if (localCardCount !== remoteCardCount) {
+        changes.push(`cards: ${remoteCardCount} → ${localCardCount}`);
+    }
+    // Compare card positions and sizes
+    const cardsById = new Map();
+    for (const c of allCards)
+        cardsById.set(c.id, c);
+    const localCards = local.cards ?? [];
+    const remoteCards = remote.dashcards ?? [];
+    const minLen = Math.min(localCards.length, remoteCards.length);
+    for (let i = 0; i < minLen; i++) {
+        const lc = localCards[i];
+        const rc = remoteCards[i];
+        if ('question' in lc && rc.card_id) {
+            const remoteCard = cardsById.get(rc.card_id);
+            const remoteName = remoteCard?.name ?? `card-${rc.card_id}`;
+            if (lc.question !== remoteName) {
+                changes.push(`card[${i}]: question "${remoteName}" → "${lc.question}"`);
+            }
+            if (lc.width !== rc.size_x || lc.height !== rc.size_y) {
+                changes.push(`card[${i}] "${lc.question}": size ${rc.size_x}x${rc.size_y} → ${lc.width}x${lc.height}`);
+            }
+            if (lc.row !== rc.row || lc.col !== rc.col) {
+                changes.push(`card[${i}] "${lc.question}": position [${rc.row},${rc.col}] → [${lc.row},${lc.col}]`);
+            }
+        }
+    }
+    // Compare parameters
+    const localParams = (local.parameters ?? []).length;
+    const remoteParams = (remote.parameters ?? []).length;
+    if (localParams !== remoteParams) {
+        changes.push(`parameters: ${remoteParams} → ${localParams}`);
+    }
+    return changes;
+}
+function printDiff(entries) {
+    const added = entries.filter((e) => e.status === 'added');
+    const removed = entries.filter((e) => e.status === 'removed');
+    const changed = entries.filter((e) => e.status === 'changed');
+    const unchanged = entries.filter((e) => e.status === 'unchanged');
+    if (added.length === 0 && removed.length === 0 && changed.length === 0) {
+        console.log(chalk.green('No differences. Local state matches Metabase.'));
+        return;
+    }
+    // Added (local only)
+    if (added.length > 0) {
+        console.log(chalk.green.bold(`\n+ Added locally (${added.length}):\n`));
+        for (const e of added) {
+            console.log(`  ${chalk.green('+')} ${e.kind}: ${chalk.bold(e.name)}`);
+        }
+    }
+    // Removed (remote only)
+    if (removed.length > 0) {
+        console.log(chalk.red.bold(`\n- Only in Metabase (${removed.length}):\n`));
+        for (const e of removed) {
+            console.log(`  ${chalk.red('-')} ${e.kind}: ${chalk.bold(e.name)}`);
+        }
+    }
+    // Changed
+    if (changed.length > 0) {
+        console.log(chalk.yellow.bold(`\n~ Changed (${changed.length}):\n`));
+        for (const e of changed) {
+            console.log(`  ${chalk.yellow('~')} ${e.kind}: ${chalk.bold(e.name)}`);
+            for (const c of e.changes ?? []) {
+                console.log(`      ${chalk.gray(c)}`);
+            }
+        }
+    }
+    // Summary
+    console.log(chalk.bold(`\nSummary: ${chalk.green(`+${added.length}`)} added, ${chalk.yellow(`~${changed.length}`)} changed, ${chalk.red(`-${removed.length}`)} remote only, ${unchanged.length} unchanged`));
+}
+//# sourceMappingURL=diff.js.map

package/dist/commands/diff.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,2 @@
+export declare function init(targetDir?: string): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AA0BA,wBAAsB,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,iBAiL5C"}

package/dist/commands/init.js

@@ -0,0 +1,183 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join, resolve, basename } from 'node:path';
+import chalk from 'chalk';
+import { createInterface } from 'node:readline';
+function prompt(rl, question, defaultValue) {
+    const suffix = defaultValue ? ` (${defaultValue})` : '';
+    return new Promise((resolve) => {
+        rl.question(`${question}${suffix}: `, (answer) => {
+            resolve(answer.trim() || defaultValue || '');
+        });
+    });
+}
+function promptChoice(rl, question, choices) {
+    return new Promise((resolve) => {
+        console.log(`\n${question}`);
+        choices.forEach((c, i) => console.log(`  ${chalk.cyan(String(i + 1))}. ${c}`));
+        rl.question(`Choice (1-${choices.length}): `, (answer) => {
+            const idx = parseInt(answer.trim(), 10) - 1;
+            resolve(choices[idx] ?? choices[0]);
+        });
+    });
+}
+export async function init(targetDir) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        console.log(chalk.bold('\n🏗  metabase-iac init\n'));
+        console.log('This will scaffold a new project to manage your Metabase instance as code.\n');
+        // Project name / directory
+        const dirName = targetDir || await prompt(rl, 'Project directory name', 'my-metabase');
+        const projectDir = resolve(dirName);
+        const projectName = basename(projectDir);
+        if (existsSync(projectDir) && existsSync(join(projectDir, 'package.json'))) {
+            console.log(chalk.yellow(`\n${projectDir} already has a package.json. Aborting.`));
+            return;
+        }
+        // Metabase URL
+        const metabaseUrl = await prompt(rl, 'Metabase URL', 'https://metabase.example.com');
+        // Auth method
+        const authMethod = await promptChoice(rl, 'How do you want to authenticate?', [
+            'Username + Password',
+            'Session Token',
+            'API Key',
+        ]);
+        let envLines = `METABASE_URL=${metabaseUrl}\n`;
+        let envExampleLines = `METABASE_URL=${metabaseUrl}\n`;
+        if (authMethod === 'Username + Password') {
+            const username = await prompt(rl, 'Metabase admin email');
+            envLines += `METABASE_USERNAME=${username}\nMETABASE_PASSWORD=\n`;
+            envExampleLines += `METABASE_USERNAME=${username}\nMETABASE_PASSWORD=your-password\n`;
+        }
+        else if (authMethod === 'Session Token') {
+            envLines += `METABASE_SESSION_TOKEN=\n`;
+            envExampleLines += `METABASE_SESSION_TOKEN=your-session-token\n`;
+        }
+        else {
+            envLines += `METABASE_API_KEY=\n`;
+            envExampleLines += `METABASE_API_KEY=mb_xxxx\n`;
+        }
+        // Package manager
+        const pkgManager = await promptChoice(rl, 'Package manager?', ['pnpm', 'npm', 'yarn']);
+        // Pull now?
+        const pullNow = await prompt(rl, 'Pull resources from Metabase after setup? (y/n)', 'y');
+        console.log(chalk.bold('\nCreating project...\n'));
+        // Create directories
+        await mkdir(join(projectDir, 'collections'), { recursive: true });
+        await mkdir(join(projectDir, 'questions'), { recursive: true });
+        await mkdir(join(projectDir, 'dashboards'), { recursive: true });
+        // package.json
+        const packageJson = {
+            name: projectName,
+            version: '0.1.0',
+            private: true,
+            description: `Metabase IaC resources for ${metabaseUrl}`,
+            type: 'module',
+            scripts: {
+                pull: 'metabase-iac pull',
+                diff: 'metabase-iac diff',
+                plan: 'metabase-iac plan',
+                apply: 'metabase-iac apply',
+                databases: 'metabase-iac databases',
+                collections: 'metabase-iac collections',
+            },
+            dependencies: {
+                'metabase-iac': '^0.1.0',
+            },
+            devDependencies: {
+                typescript: '^5.9.0',
+            },
+        };
+        await writeFile(join(projectDir, 'package.json'), JSON.stringify(packageJson, null, 2) + '\n');
+        console.log(`  ${chalk.green('+')} package.json`);
+        // tsconfig.json
+        const tsconfig = {
+            compilerOptions: {
+                target: 'ES2022',
+                module: 'ES2022',
+                moduleResolution: 'bundler',
+                esModuleInterop: true,
+                strict: true,
+                skipLibCheck: true,
+                noEmit: true,
+            },
+            include: ['collections/**/*', 'questions/**/*', 'dashboards/**/*'],
+        };
+        await writeFile(join(projectDir, 'tsconfig.json'), JSON.stringify(tsconfig, null, 2) + '\n');
+        console.log(`  ${chalk.green('+')} tsconfig.json`);
+        // .env
+        await writeFile(join(projectDir, '.env'), envLines);
+        console.log(`  ${chalk.green('+')} .env`);
+        // .env.example
+        await writeFile(join(projectDir, '.env.example'), envExampleLines);
+        console.log(`  ${chalk.green('+')} .env.example`);
+        // .gitignore
+        await writeFile(join(projectDir, '.gitignore'), 'node_modules/\n.env\n.metabase-state.json\n');
+        console.log(`  ${chalk.green('+')} .gitignore`);
+        // README.md
+        const readme = `# ${projectName}
+
+Metabase IaC resources for [${metabaseUrl}](${metabaseUrl}).
+
+Managed with [metabase-iac](https://www.npmjs.com/package/metabase-iac).
+
+## Setup
+
+\`\`\`bash
+${pkgManager} install
+cp .env.example .env
+# Edit .env with your credentials
+\`\`\`
+
+## Commands
+
+\`\`\`bash
+${pkgManager} run pull         # Import from Metabase
+${pkgManager} run plan         # Preview changes (dry run)
+${pkgManager} run apply        # Push changes to Metabase
+${pkgManager} run databases    # List databases
+${pkgManager} run collections  # List collections
+\`\`\`
+
+## Structure
+
+\`\`\`
+collections/     # Metabase collections
+questions/       # Saved questions (SQL, MongoDB, structured)
+dashboards/      # Dashboards with card layouts
+\`\`\`
+`;
+        await writeFile(join(projectDir, 'README.md'), readme);
+        console.log(`  ${chalk.green('+')} README.md`);
+        // Git init
+        console.log(`\n${chalk.bold('Initializing git repository...')}`);
+        const { execSync } = await import('node:child_process');
+        execSync('git init', { cwd: projectDir, stdio: 'inherit' });
+        console.log(`  ${chalk.green('+')} .git`);
+        // Install dependencies
+        console.log(`\n${chalk.bold('Installing dependencies...')}\n`);
+        execSync(`${pkgManager} install`, { cwd: projectDir, stdio: 'inherit' });
+        console.log(chalk.green('\nProject created!\n'));
+        // Pull
+        if (pullNow.toLowerCase() === 'y') {
+            console.log(chalk.bold('Pulling resources from Metabase...\n'));
+            try {
+                execSync('npx metabase-iac pull', { cwd: projectDir, stdio: 'inherit' });
+            }
+            catch {
+                console.log(chalk.yellow('\nPull failed — check your .env credentials and try again with:'));
+                console.log(chalk.cyan(`  cd ${dirName} && ${pkgManager} run pull\n`));
+            }
+        }
+        else {
+            console.log(chalk.bold('Next steps:\n'));
+            console.log(`  ${chalk.cyan('cd')} ${dirName}`);
+            console.log(`  ${chalk.cyan('# Edit .env with your credentials')}`);
+            console.log(`  ${chalk.cyan(`${pkgManager} run pull`)}\n`);
+        }
+    }
+    finally {
+        rl.close();
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "metabase-iac",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Infrastructure as Code for Metabase — manage collections, questions, dashboards as code",
   "type": "module",
   "main": "./dist/types.js",
@@ -26,17 +26,14 @@
     "src",
     "README.md"
   ],
-  "scripts": {
-    "build": "tsc",
-    "prepublishOnly": "pnpm build",
-    "dev": "tsx src/cli.ts",
-    "pull": "tsx src/cli.ts pull",
-    "plan": "tsx src/cli.ts plan",
-    "apply": "tsx src/cli.ts apply",
-    "databases": "tsx src/cli.ts databases",
-    "collections": "tsx src/cli.ts collections"
-  },
-  "keywords": ["metabase", "iac", "infrastructure-as-code", "dashboards", "mongodb", "sql"],
+  "keywords": [
+    "metabase",
+    "iac",
+    "infrastructure-as-code",
+    "dashboards",
+    "mongodb",
+    "sql"
+  ],
   "license": "MIT",
   "dependencies": {
     "chalk": "^5.6.2",
@@ -49,5 +46,17 @@
   "devDependencies": {
     "@types/node": "^25.5.0",
     "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli.ts",
+    "pull": "tsx src/cli.ts pull",
+    "plan": "tsx src/cli.ts plan",
+    "apply": "tsx src/cli.ts apply",
+    "databases": "tsx src/cli.ts databases",
+    "collections": "tsx src/cli.ts collections",
+    "release:patch": "pnpm version patch && pnpm publish",
+    "release:minor": "pnpm version minor && pnpm publish",
+    "release:major": "pnpm version major && pnpm publish"
   }
-}
+}

package/src/cli.ts

@@ -4,6 +4,8 @@ import chalk from 'chalk'
 import { createClient } from './auth.js'
 import { apply } from './commands/apply.js'
 import { pull } from './commands/pull.js'
+import { init } from './commands/init.js'
+import { diff } from './commands/diff.js'
 import { saveState } from './state.js'
 
 const program = new Command()
@@ -13,6 +15,18 @@ program
   .description('Infrastructure as Code for Metabase')
   .version('0.1.0')
 
+program
+  .command('init [directory]')
+  .description('Scaffold a new metabase-iac project')
+  .action(async (directory) => {
+    try {
+      await init(directory)
+    } catch (err: any) {
+      console.error(chalk.red(`Error: ${err.message}`))
+      process.exit(1)
+    }
+  })
+
 program
   .command('pull')
   .description('Import all collections, questions, dashboards from Metabase into local files')
@@ -31,6 +45,20 @@ program
     }
   })
 
+program
+  .command('diff')
+  .description('Compare local resources against the current Metabase state')
+  .option('-d, --dir <dir>', 'Resources directory', '.')
+  .action(async (opts) => {
+    try {
+      const client = await createClient()
+      await diff(client, opts.dir)
+    } catch (err: any) {
+      console.error(chalk.red(`Error: ${err.message}`))
+      process.exit(1)
+    }
+  })
+
 program
   .command('plan')
   .description('Show what changes would be applied (dry run)')

package/src/commands/diff.ts

@@ -0,0 +1,274 @@
+import chalk from 'chalk'
+import type { MetabaseClient } from '../client.js'
+import { Resolver } from '../resolver.js'
+import type {
+  MetabaseCard,
+  MetabaseCollection,
+  MetabaseDashboard,
+} from '../types.js'
+
+interface DiffEntry {
+  kind: 'collection' | 'question' | 'dashboard'
+  name: string
+  status: 'added' | 'removed' | 'changed' | 'unchanged'
+  changes?: string[]
+}
+
+export async function diff(client: MetabaseClient, resourceDir: string = '.') {
+  const { loadResources } = await import('../loader.js')
+
+  console.log('Loading local resources...')
+  const localResources = await loadResources(resourceDir)
+
+  console.log('Fetching remote state from Metabase...\n')
+  const resolver = new Resolver()
+  await resolver.init(client)
+
+  const remoteCollections = await client.getCollections()
+  const remoteCards = await client.getCards()
+  const remoteDashboardsList = await client.getDashboards()
+
+  const activeCollections = remoteCollections.filter((c) => !c.archived && c.id !== 0)
+  const activeCards = remoteCards.filter((c) => !c.archived)
+  const activeDashboards = remoteDashboardsList.filter((d) => !d.archived)
+
+  const entries: DiffEntry[] = []
+
+  // Diff collections
+  const remoteCollectionsByName = new Map<string, MetabaseCollection>()
+  for (const c of activeCollections) remoteCollectionsByName.set(c.name, c)
+
+  const localCollections = localResources.filter((r) => r.kind === 'collection')
+  const seenCollections = new Set<string>()
+
+  for (const local of localCollections) {
+    seenCollections.add(local.name)
+    const remote = remoteCollectionsByName.get(local.name)
+    if (!remote) {
+      entries.push({ kind: 'collection', name: local.name, status: 'added' })
+    } else {
+      const changes = diffCollection(local, remote)
+      entries.push({
+        kind: 'collection',
+        name: local.name,
+        status: changes.length > 0 ? 'changed' : 'unchanged',
+        changes,
+      })
+    }
+  }
+
+  for (const remote of activeCollections) {
+    if (!seenCollections.has(remote.name) && remote.name !== 'Our analytics') {
+      entries.push({ kind: 'collection', name: remote.name, status: 'removed' })
+    }
+  }
+
+  // Diff questions
+  const remoteCardsByName = new Map<string, MetabaseCard>()
+  for (const c of activeCards) remoteCardsByName.set(c.name, c)
+
+  const localQuestions = localResources.filter((r) => r.kind === 'question')
+  const seenQuestions = new Set<string>()
+
+  for (const local of localQuestions) {
+    seenQuestions.add(local.name)
+    const remote = remoteCardsByName.get(local.name)
+    if (!remote) {
+      entries.push({ kind: 'question', name: local.name, status: 'added' })
+    } else {
+      const changes = diffQuestion(local, remote, resolver)
+      entries.push({
+        kind: 'question',
+        name: local.name,
+        status: changes.length > 0 ? 'changed' : 'unchanged',
+        changes,
+      })
+    }
+  }
+
+  for (const remote of activeCards) {
+    if (!seenQuestions.has(remote.name)) {
+      entries.push({ kind: 'question', name: remote.name, status: 'removed' })
+    }
+  }
+
+  // Diff dashboards
+  const remoteDashboardsByName = new Map<string, MetabaseDashboard>()
+  for (const d of activeDashboards) {
+    const full = await client.getDashboard(d.id)
+    remoteDashboardsByName.set(full.name, full)
+  }
+
+  const localDashboards = localResources.filter((r) => r.kind === 'dashboard')
+  const seenDashboards = new Set<string>()
+
+  for (const local of localDashboards) {
+    seenDashboards.add(local.name)
+    const remote = remoteDashboardsByName.get(local.name)
+    if (!remote) {
+      entries.push({ kind: 'dashboard', name: local.name, status: 'added' })
+    } else {
+      const changes = diffDashboard(local, remote, activeCards, resolver)
+      entries.push({
+        kind: 'dashboard',
+        name: local.name,
+        status: changes.length > 0 ? 'changed' : 'unchanged',
+        changes,
+      })
+    }
+  }
+
+  for (const [name] of remoteDashboardsByName) {
+    if (!seenDashboards.has(name)) {
+      entries.push({ kind: 'dashboard', name, status: 'removed' })
+    }
+  }
+
+  // Print results
+  printDiff(entries)
+}
+
+function diffCollection(local: any, remote: MetabaseCollection): string[] {
+  const changes: string[] = []
+  if (local.description && local.description !== (remote.description ?? '')) {
+    changes.push(`description: "${remote.description ?? ''}" → "${local.description}"`)
+  }
+  return changes
+}
+
+function diffQuestion(local: any, remote: MetabaseCard, resolver: Resolver): string[] {
+  const changes: string[] = []
+
+  const remoteCollection = resolver.getCollectionName(remote.collection_id)
+  if (local.collection && local.collection !== remoteCollection) {
+    changes.push(`collection: "${remoteCollection}" → "${local.collection}"`)
+  }
+
+  if (local.display && local.display !== remote.display) {
+    changes.push(`display: "${remote.display}" → "${local.display}"`)
+  }
+
+  const remoteDb = resolver.getDatabaseName(remote.database_id)
+  if (local.database && local.database !== remoteDb) {
+    changes.push(`database: "${remoteDb}" → "${local.database}"`)
+  }
+
+  // Compare native query text
+  if (local.type === 'native' && remote.dataset_query?.native) {
+    const localQuery = local.query.trim()
+    const remoteQuery = (remote.dataset_query.native.query ?? '').trim()
+    if (localQuery !== remoteQuery) {
+      changes.push('query: content changed')
+    }
+  }
+
+  return changes
+}
+
+function diffDashboard(
+  local: any,
+  remote: MetabaseDashboard,
+  allCards: MetabaseCard[],
+  resolver: Resolver,
+): string[] {
+  const changes: string[] = []
+
+  const remoteCollection = resolver.getCollectionName(remote.collection_id)
+  if (local.collection && local.collection !== remoteCollection) {
+    changes.push(`collection: "${remoteCollection}" → "${local.collection}"`)
+  }
+
+  if (local.description !== undefined && local.description !== (remote.description ?? null)) {
+    changes.push(`description changed`)
+  }
+
+  // Compare card count
+  const localCardCount = (local.cards ?? []).length
+  const remoteCardCount = (remote.dashcards ?? []).length
+  if (localCardCount !== remoteCardCount) {
+    changes.push(`cards: ${remoteCardCount} → ${localCardCount}`)
+  }
+
+  // Compare card positions and sizes
+  const cardsById = new Map<number, MetabaseCard>()
+  for (const c of allCards) cardsById.set(c.id, c)
+
+  const localCards = local.cards ?? []
+  const remoteCards = remote.dashcards ?? []
+  const minLen = Math.min(localCards.length, remoteCards.length)
+
+  for (let i = 0; i < minLen; i++) {
+    const lc = localCards[i]
+    const rc = remoteCards[i]
+
+    if ('question' in lc && rc.card_id) {
+      const remoteCard = cardsById.get(rc.card_id)
+      const remoteName = remoteCard?.name ?? `card-${rc.card_id}`
+
+      if (lc.question !== remoteName) {
+        changes.push(`card[${i}]: question "${remoteName}" → "${lc.question}"`)
+      }
+      if (lc.width !== rc.size_x || lc.height !== rc.size_y) {
+        changes.push(`card[${i}] "${lc.question}": size ${rc.size_x}x${rc.size_y} → ${lc.width}x${lc.height}`)
+      }
+      if (lc.row !== rc.row || lc.col !== rc.col) {
+        changes.push(`card[${i}] "${lc.question}": position [${rc.row},${rc.col}] → [${lc.row},${lc.col}]`)
+      }
+    }
+  }
+
+  // Compare parameters
+  const localParams = (local.parameters ?? []).length
+  const remoteParams = (remote.parameters ?? []).length
+  if (localParams !== remoteParams) {
+    changes.push(`parameters: ${remoteParams} → ${localParams}`)
+  }
+
+  return changes
+}
+
+function printDiff(entries: DiffEntry[]) {
+  const added = entries.filter((e) => e.status === 'added')
+  const removed = entries.filter((e) => e.status === 'removed')
+  const changed = entries.filter((e) => e.status === 'changed')
+  const unchanged = entries.filter((e) => e.status === 'unchanged')
+
+  if (added.length === 0 && removed.length === 0 && changed.length === 0) {
+    console.log(chalk.green('No differences. Local state matches Metabase.'))
+    return
+  }
+
+  // Added (local only)
+  if (added.length > 0) {
+    console.log(chalk.green.bold(`\n+ Added locally (${added.length}):\n`))
+    for (const e of added) {
+      console.log(`  ${chalk.green('+')} ${e.kind}: ${chalk.bold(e.name)}`)
+    }
+  }
+
+  // Removed (remote only)
+  if (removed.length > 0) {
+    console.log(chalk.red.bold(`\n- Only in Metabase (${removed.length}):\n`))
+    for (const e of removed) {
+      console.log(`  ${chalk.red('-')} ${e.kind}: ${chalk.bold(e.name)}`)
+    }
+  }
+
+  // Changed
+  if (changed.length > 0) {
+    console.log(chalk.yellow.bold(`\n~ Changed (${changed.length}):\n`))
+    for (const e of changed) {
+      console.log(`  ${chalk.yellow('~')} ${e.kind}: ${chalk.bold(e.name)}`)
+      for (const c of e.changes ?? []) {
+        console.log(`      ${chalk.gray(c)}`)
+      }
+    }
+  }
+
+  // Summary
+  console.log(
+    chalk.bold(
+      `\nSummary: ${chalk.green(`+${added.length}`)} added, ${chalk.yellow(`~${changed.length}`)} changed, ${chalk.red(`-${removed.length}`)} remote only, ${unchanged.length} unchanged`,
+    ),
+  )
+}

package/src/commands/init.ts

@@ -0,0 +1,204 @@
+import { mkdir, writeFile } from 'node:fs/promises'
+import { existsSync } from 'node:fs'
+import { join, resolve, basename } from 'node:path'
+import chalk from 'chalk'
+import { createInterface } from 'node:readline'
+
+function prompt(rl: ReturnType<typeof createInterface>, question: string, defaultValue?: string): Promise<string> {
+  const suffix = defaultValue ? ` (${defaultValue})` : ''
+  return new Promise((resolve) => {
+    rl.question(`${question}${suffix}: `, (answer) => {
+      resolve(answer.trim() || defaultValue || '')
+    })
+  })
+}
+
+function promptChoice(rl: ReturnType<typeof createInterface>, question: string, choices: string[]): Promise<string> {
+  return new Promise((resolve) => {
+    console.log(`\n${question}`)
+    choices.forEach((c, i) => console.log(`  ${chalk.cyan(String(i + 1))}. ${c}`))
+    rl.question(`Choice (1-${choices.length}): `, (answer) => {
+      const idx = parseInt(answer.trim(), 10) - 1
+      resolve(choices[idx] ?? choices[0])
+    })
+  })
+}
+
+export async function init(targetDir?: string) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout })
+
+  try {
+    console.log(chalk.bold('\n🏗  metabase-iac init\n'))
+    console.log('This will scaffold a new project to manage your Metabase instance as code.\n')
+
+    // Project name / directory
+    const dirName = targetDir || await prompt(rl, 'Project directory name', 'my-metabase')
+    const projectDir = resolve(dirName)
+    const projectName = basename(projectDir)
+
+    if (existsSync(projectDir) && existsSync(join(projectDir, 'package.json'))) {
+      console.log(chalk.yellow(`\n${projectDir} already has a package.json. Aborting.`))
+      return
+    }
+
+    // Metabase URL
+    const metabaseUrl = await prompt(rl, 'Metabase URL', 'https://metabase.example.com')
+
+    // Auth method
+    const authMethod = await promptChoice(rl, 'How do you want to authenticate?', [
+      'Username + Password',
+      'Session Token',
+      'API Key',
+    ])
+
+    let envLines = `METABASE_URL=${metabaseUrl}\n`
+    let envExampleLines = `METABASE_URL=${metabaseUrl}\n`
+
+    if (authMethod === 'Username + Password') {
+      const username = await prompt(rl, 'Metabase admin email')
+      envLines += `METABASE_USERNAME=${username}\nMETABASE_PASSWORD=\n`
+      envExampleLines += `METABASE_USERNAME=${username}\nMETABASE_PASSWORD=your-password\n`
+    } else if (authMethod === 'Session Token') {
+      envLines += `METABASE_SESSION_TOKEN=\n`
+      envExampleLines += `METABASE_SESSION_TOKEN=your-session-token\n`
+    } else {
+      envLines += `METABASE_API_KEY=\n`
+      envExampleLines += `METABASE_API_KEY=mb_xxxx\n`
+    }
+
+    // Package manager
+    const pkgManager = await promptChoice(rl, 'Package manager?', ['pnpm', 'npm', 'yarn'])
+
+    // Pull now?
+    const pullNow = await prompt(rl, 'Pull resources from Metabase after setup? (y/n)', 'y')
+
+    console.log(chalk.bold('\nCreating project...\n'))
+
+    // Create directories
+    await mkdir(join(projectDir, 'collections'), { recursive: true })
+    await mkdir(join(projectDir, 'questions'), { recursive: true })
+    await mkdir(join(projectDir, 'dashboards'), { recursive: true })
+
+    // package.json
+    const packageJson = {
+      name: projectName,
+      version: '0.1.0',
+      private: true,
+      description: `Metabase IaC resources for ${metabaseUrl}`,
+      type: 'module',
+      scripts: {
+        pull: 'metabase-iac pull',
+        diff: 'metabase-iac diff',
+        plan: 'metabase-iac plan',
+        apply: 'metabase-iac apply',
+        databases: 'metabase-iac databases',
+        collections: 'metabase-iac collections',
+      },
+      dependencies: {
+        'metabase-iac': '^0.1.0',
+      },
+      devDependencies: {
+        typescript: '^5.9.0',
+      },
+    }
+    await writeFile(join(projectDir, 'package.json'), JSON.stringify(packageJson, null, 2) + '\n')
+    console.log(`  ${chalk.green('+')} package.json`)
+
+    // tsconfig.json
+    const tsconfig = {
+      compilerOptions: {
+        target: 'ES2022',
+        module: 'ES2022',
+        moduleResolution: 'bundler',
+        esModuleInterop: true,
+        strict: true,
+        skipLibCheck: true,
+        noEmit: true,
+      },
+      include: ['collections/**/*', 'questions/**/*', 'dashboards/**/*'],
+    }
+    await writeFile(join(projectDir, 'tsconfig.json'), JSON.stringify(tsconfig, null, 2) + '\n')
+    console.log(`  ${chalk.green('+')} tsconfig.json`)
+
+    // .env
+    await writeFile(join(projectDir, '.env'), envLines)
+    console.log(`  ${chalk.green('+')} .env`)
+
+    // .env.example
+    await writeFile(join(projectDir, '.env.example'), envExampleLines)
+    console.log(`  ${chalk.green('+')} .env.example`)
+
+    // .gitignore
+    await writeFile(
+      join(projectDir, '.gitignore'),
+      'node_modules/\n.env\n.metabase-state.json\n',
+    )
+    console.log(`  ${chalk.green('+')} .gitignore`)
+
+    // README.md
+    const readme = `# ${projectName}
+
+Metabase IaC resources for [${metabaseUrl}](${metabaseUrl}).
+
+Managed with [metabase-iac](https://www.npmjs.com/package/metabase-iac).
+
+## Setup
+
+\`\`\`bash
+${pkgManager} install
+cp .env.example .env
+# Edit .env with your credentials
+\`\`\`
+
+## Commands
+
+\`\`\`bash
+${pkgManager} run pull         # Import from Metabase
+${pkgManager} run plan         # Preview changes (dry run)
+${pkgManager} run apply        # Push changes to Metabase
+${pkgManager} run databases    # List databases
+${pkgManager} run collections  # List collections
+\`\`\`
+
+## Structure
+
+\`\`\`
+collections/     # Metabase collections
+questions/       # Saved questions (SQL, MongoDB, structured)
+dashboards/      # Dashboards with card layouts
+\`\`\`
+`
+    await writeFile(join(projectDir, 'README.md'), readme)
+    console.log(`  ${chalk.green('+')} README.md`)
+
+    // Git init
+    console.log(`\n${chalk.bold('Initializing git repository...')}`)
+    const { execSync } = await import('node:child_process')
+    execSync('git init', { cwd: projectDir, stdio: 'inherit' })
+    console.log(`  ${chalk.green('+')} .git`)
+
+    // Install dependencies
+    console.log(`\n${chalk.bold('Installing dependencies...')}\n`)
+    execSync(`${pkgManager} install`, { cwd: projectDir, stdio: 'inherit' })
+
+    console.log(chalk.green('\nProject created!\n'))
+
+    // Pull
+    if (pullNow.toLowerCase() === 'y') {
+      console.log(chalk.bold('Pulling resources from Metabase...\n'))
+      try {
+        execSync('npx metabase-iac pull', { cwd: projectDir, stdio: 'inherit' })
+      } catch {
+        console.log(chalk.yellow('\nPull failed — check your .env credentials and try again with:'))
+        console.log(chalk.cyan(`  cd ${dirName} && ${pkgManager} run pull\n`))
+      }
+    } else {
+      console.log(chalk.bold('Next steps:\n'))
+      console.log(`  ${chalk.cyan('cd')} ${dirName}`)
+      console.log(`  ${chalk.cyan('# Edit .env with your credentials')}`)
+      console.log(`  ${chalk.cyan(`${pkgManager} run pull`)}\n`)
+    }
+  } finally {
+    rl.close()
+  }
+}