@revos/cli 0.1.1 → 0.1.3

package/README.md

@@ -26,10 +26,32 @@ revos [command] [options]
 ### Project Initialization
 
 ```bash
-revos init [project-name]
+revos init [destination] [--yes] [--dry-run]
 ```
 
-Scaffolds a new RevOS data engineering project. If `project-name` is omitted, uses the current directory name.
+Scaffolds a new RevOS data engineering project. If `destination` is omitted, initializes in the current directory.
+
+**Arguments:**
+
+```
+destination   Path or project name (default: current directory)
+              Examples:
+                my-project             → creates ./my-project/
+                ./my-project           → same as above
+                ../my-project          → one level up
+                /home/user/my-project  → absolute path
+```
+
+**Flags:**
+
+```
+-y, --yes    Skip confirmation prompts, use defaults
+    --dry-run  Show what would be created without creating files or GCP resources
+```
+
+**Non-empty directory behavior:**
+
+If the destination already exists and is not empty, you will be prompted to confirm before proceeding. Use `--yes` to skip this prompt.
 
 **What it does:**
 
@@ -39,7 +61,7 @@ Scaffolds a new RevOS data engineering project. If `project-name` is omitted, us
 4. Generates `.devcontainer/devcontainer.json` with Python 3.11, Node.js, Google Cloud SDK (`bq`), and dbt pre-installed. The Dev Container mounts `~/.revos/{project-name}-gsa-creds.json` automatically.
 5. Generates `dbt/profiles.yml` pre-configured for BigQuery.
 6. Generates `.gitignore` and `README.md`.
-7. Scaffolds AI companion files: `CLAUDE.md`, `AGENTS.md`, and `.claude/skills/`.
+7. Scaffolds AI companion files: `CLAUDE.md`, `AGENTS.md`, and `.claude/skills/` with three pre-installed skills: `explore-lakehouse`, `create-semantic-model`, and `create-dbt-transformations`.
 
 **Requires:** `revos auth login` first.
 
@@ -95,18 +117,22 @@ revos org switch <org-id>
 
 ### Overlays Management
 
-Overlay files contain only Cube definition data (dimensions, measures, joins, etc.). The overlay name is derived from the filename (without `.json`). A `description` field in the file is synced with the overlay's description on push.
+Overlay files are Cube.dev semantic model definitions stored as YAML in `semantic/`. The overlay name is taken from the `name` field inside the file (or derived from the filename as a fallback). A `description` field is synced with the overlay's description on push.
 
-Example `my-overlay.json`:
+Example `semantic/my_table.yml`:
 
-```json
-{
-  "description": "My custom overlay",
-  "sql_table": "my_table",
-  "dimensions": {
-    "id": { "sql": "id", "type": "number", "primary_key": true }
-  }
-}
+```yaml
+name: my_table
+description: My custom overlay
+sql_table: my_table
+dimensions:
+  id:
+    sql: "${CUBE}.id"
+    type: number
+    primary_key: true
+measures:
+  count:
+    type: count
 ```
 
 #### Push overlays to API
@@ -115,7 +141,7 @@ Example `my-overlay.json`:
 revos overlays push [files...] [-d <dir>] [-f] [--json]
 
 Options:
-  -d, --dir <path>  Directory containing overlay files (default: "./overlays")
+  -d, --dir <path>  Directory containing overlay files (default: "./semantic")
   -f, --force       Force push even if remote is newer
 ```
 
@@ -125,7 +151,7 @@ Options:
 revos overlays pull [-d <dir>] [-n <name>...] [--json]
 
 Options:
-  -d, --dir <path>       Directory to save overlay files (default: "./overlays")
+  -d, --dir <path>       Directory to save overlay files (default: "./semantic")
   -n, --name <name>      Specific overlay names to pull (repeatable)
 ```
 

package/dist/adapters/oclif/commands/auth/login.mjs

@@ -1,5 +1,5 @@
-import { A as getCredentialsPath, C as getUserInfo, D as tokenResponseToCredentials, N as saveCredentials, O as startOAuthServer, S as generatePKCEChallenge, T as setClerkConfig, b as buildAuthorizationUrl, m as unwrap, n as selectOrganization, p as createApiClient, x as exchangeCodeForTokens } from "../../../../core-Dq15hO6f.mjs";
-import { t as BaseCommand } from "../../../../base.command-DlYMawJ6.mjs";
+import { A as getCredentialsPath, C as getUserInfo, D as tokenResponseToCredentials, N as saveCredentials, O as startOAuthServer, S as generatePKCEChallenge, T as setClerkConfig, b as buildAuthorizationUrl, m as unwrap, n as selectOrganization, p as createApiClient, x as exchangeCodeForTokens } from "../../../../core-BSLZ9hQU.mjs";
+import { t as BaseCommand } from "../../../../base.command-CaFn9EwG.mjs";
 import chalk from "chalk";
 import { Flags } from "@oclif/core";
 import open from "open";

package/dist/adapters/oclif/commands/auth/logout.mjs

@@ -1,5 +1,5 @@
-import { k as deleteCredentials } from "../../../../core-Dq15hO6f.mjs";
-import { t as BaseCommand } from "../../../../base.command-DlYMawJ6.mjs";
+import { k as deleteCredentials } from "../../../../core-BSLZ9hQU.mjs";
+import { t as BaseCommand } from "../../../../base.command-CaFn9EwG.mjs";
 //#region src/adapters/oclif/commands/auth/logout.ts
 var AuthLogout = class extends BaseCommand {
 	static description = "Remove stored authentication credentials";

package/dist/adapters/oclif/commands/auth/status.mjs

@@ -1,5 +1,5 @@
-import { A as getCredentialsPath, M as loadCredentials, j as isTokenExpired } from "../../../../core-Dq15hO6f.mjs";
-import { t as BaseCommand } from "../../../../base.command-DlYMawJ6.mjs";
+import { A as getCredentialsPath, M as loadCredentials, j as isTokenExpired } from "../../../../core-BSLZ9hQU.mjs";
+import { t as BaseCommand } from "../../../../base.command-CaFn9EwG.mjs";
 import chalk from "chalk";
 //#region src/adapters/oclif/commands/auth/status.ts
 var AuthStatus = class extends BaseCommand {

package/dist/adapters/oclif/commands/init.d.mts

@@ -5,7 +5,11 @@ import * as _$_oclif_core_interfaces0 from "@oclif/core/interfaces";
 declare class Init extends BaseCommand<typeof Init> {
   static description: string;
   static args: {
-    name: _$_oclif_core_interfaces0.Arg<string | undefined, Record<string, unknown>>;
+    destination: _$_oclif_core_interfaces0.Arg<string | undefined, Record<string, unknown>>;
+  };
+  static flags: {
+    yes: _$_oclif_core_interfaces0.BooleanFlag<boolean>;
+    "dry-run": _$_oclif_core_interfaces0.BooleanFlag<boolean>;
   };
   run(): Promise<void>;
 }

package/dist/adapters/oclif/commands/init.mjs

@@ -1,27 +1,88 @@
-import { P as ApiError, t as InitService, y as getConfig } from "../../../core-Dq15hO6f.mjs";
+import { P as ApiError, t as InitService, y as getConfig } from "../../../core-BSLZ9hQU.mjs";
 import { TEMPLATES_DIR } from "../../../templates/index.mjs";
-import { t as BaseCommand } from "../../../base.command-DlYMawJ6.mjs";
+import { t as BaseCommand } from "../../../base.command-CaFn9EwG.mjs";
+import * as fs from "fs";
 import * as path from "path";
+import select from "@inquirer/select";
 import chalk from "chalk";
-import { Args } from "@oclif/core";
+import { Args, Flags } from "@oclif/core";
 //#region src/adapters/oclif/commands/init.ts
+function isDirEmpty(dirPath) {
+	return fs.readdirSync(dirPath).length === 0;
+}
 var Init = class extends BaseCommand {
 	static description = "Scaffold a new RevOS data engineering project";
-	static args = { name: Args.string({
-		description: "Project name (used as directory name)",
+	static args = { destination: Args.string({
+		description: "Path or project name (default: current directory name). Supports relative and absolute paths.",
 		required: false
 	}) };
+	static flags = {
+		yes: Flags.boolean({
+			char: "y",
+			description: "Non-interactive mode, use defaults",
+			default: false
+		}),
+		"dry-run": Flags.boolean({
+			description: "Show what would be created without making any changes",
+			default: false
+		})
+	};
 	async run() {
 		const { apiUrl, token, organizationId } = await getConfig();
-		const projectName = this.args.name ?? path.basename(process.cwd());
-		if (!projectName || projectName.includes("/") || projectName.includes("\\") || projectName === "..") this.error(`Invalid project name: "${projectName}"`, { exit: 1 });
-		this.log(`\nInitializing project ${chalk.bold(projectName)}...\n`);
-		const result = await new InitService(TEMPLATES_DIR).run({
+		let projectName;
+		let targetDir;
+		if (this.args.destination) {
+			const resolved = path.resolve(this.args.destination);
+			projectName = path.basename(resolved);
+			targetDir = path.dirname(resolved);
+		} else {
+			const cwd = process.cwd();
+			projectName = path.basename(cwd);
+			targetDir = path.dirname(cwd);
+		}
+		if (!projectName) this.error("Could not determine project name from path", { exit: 1 });
+		const projectDir = path.join(targetDir, projectName);
+		if (fs.existsSync(projectDir) && !isDirEmpty(projectDir) && !this.flags.yes) {
+			if (await select({
+				message: `Directory "${projectName}" already exists and is not empty. What would you like to do?`,
+				choices: [{
+					name: "Initialize in this directory",
+					value: "init"
+				}, {
+					name: "Cancel",
+					value: "cancel"
+				}]
+			}) === "cancel") {
+				this.log("Cancelled.");
+				return;
+			}
+		}
+		const service = new InitService(TEMPLATES_DIR);
+		const org = await service.resolveOrganization(apiUrl, token, organizationId).catch((err) => {
+			const message = err instanceof Error ? err.message : String(err);
+			this.error(message, { exit: 1 });
+		});
+		if (this.flags["dry-run"]) {
+			const preview = service.dryRun(projectName, targetDir);
+			this.log(`\nWould create project ${chalk.bold(projectName)} for organization ${chalk.bold(org.name)}`);
+			this.log(`  Path: ${chalk.dim(preview.projectDir)}\n`);
+			this.log("Directories:");
+			for (const dir of preview.dirs) this.log(`  ${dir}/`);
+			this.log("\nFiles:");
+			for (const file of preview.files) this.log(`  ${file}`);
+			this.log(chalk.dim("\nNo files created, no GCP resources provisioned."));
+			return;
+		}
+		this.log(`\nCreating project ${chalk.bold(projectName)} for organization ${chalk.bold(org.name)}`);
+		this.log(`  Path: ${chalk.dim(projectDir)}\n`);
+		const result = await service.run({
 			projectName,
-			targetDir: process.cwd(),
+			targetDir,
 			apiUrl,
 			token,
-			organizationId
+			organizationId,
+			organization: org,
+			allowExistingDir: true
 		}).catch((err) => {
 			if (err instanceof ApiError) {
 				this.log(chalk.red(`\nAPI error: ${err.status} ${err.statusText}`));
@@ -31,7 +92,6 @@ var Init = class extends BaseCommand {
 			const message = err instanceof Error ? err.message : String(err);
 			this.error(message, { exit: 1 });
 		});
-		this.log(chalk.green(`\nOrganization: ${result.organization.name}`));
 		this.log(chalk.green(`\nProject created at ${result.projectDir}`));
 		this.log("\nGenerated files:");
 		for (const f of result.createdFiles) this.log(`  ${f}`);

package/dist/adapters/oclif/commands/org/current.mjs

@@ -1,5 +1,5 @@
-import { M as loadCredentials, m as unwrap, p as createApiClient, y as getConfig } from "../../../../core-Dq15hO6f.mjs";
-import { t as BaseCommand } from "../../../../base.command-DlYMawJ6.mjs";
+import { M as loadCredentials, m as unwrap, p as createApiClient, y as getConfig } from "../../../../core-BSLZ9hQU.mjs";
+import { t as BaseCommand } from "../../../../base.command-CaFn9EwG.mjs";
 //#region src/adapters/oclif/commands/org/current.ts
 var OrgCurrent = class extends BaseCommand {
 	static description = "Show currently selected organization";

package/dist/adapters/oclif/commands/org/list.mjs

@@ -1,5 +1,5 @@
-import { m as unwrap, p as createApiClient, y as getConfig } from "../../../../core-Dq15hO6f.mjs";
-import { t as BaseCommand } from "../../../../base.command-DlYMawJ6.mjs";
+import { m as unwrap, p as createApiClient, y as getConfig } from "../../../../core-BSLZ9hQU.mjs";
+import { t as BaseCommand } from "../../../../base.command-CaFn9EwG.mjs";
 import chalk from "chalk";
 import { Flags } from "@oclif/core";
 //#region src/adapters/oclif/commands/org/list.ts

package/dist/adapters/oclif/commands/org/switch.mjs

@@ -1,5 +1,5 @@
-import { M as loadCredentials, N as saveCredentials, m as unwrap, n as selectOrganization, p as createApiClient, y as getConfig } from "../../../../core-Dq15hO6f.mjs";
-import { t as BaseCommand } from "../../../../base.command-DlYMawJ6.mjs";
+import { M as loadCredentials, N as saveCredentials, m as unwrap, n as selectOrganization, p as createApiClient, y as getConfig } from "../../../../core-BSLZ9hQU.mjs";
+import { t as BaseCommand } from "../../../../base.command-CaFn9EwG.mjs";
 import chalk from "chalk";
 import { Args } from "@oclif/core";
 //#region src/adapters/oclif/commands/org/switch.ts

package/dist/adapters/oclif/commands/overlays/diff.d.mts

@@ -1,4 +1,4 @@
-import { o as DiffResult } from "../../../../types-DZssnweO.mjs";
+import { o as DiffResult } from "../../../../types-DmuJzN0Z.mjs";
 import { t as BaseCommand } from "../../../../base.command-BjFWMIzL.mjs";
 import * as _$_oclif_core_interfaces0 from "@oclif/core/interfaces";
 

package/dist/adapters/oclif/commands/overlays/diff.mjs

@@ -1,5 +1,5 @@
-import { p as createApiClient, r as DiffService, y as getConfig } from "../../../../core-Dq15hO6f.mjs";
-import { t as BaseCommand } from "../../../../base.command-DlYMawJ6.mjs";
+import { p as createApiClient, r as DiffService, y as getConfig } from "../../../../core-BSLZ9hQU.mjs";
+import { t as BaseCommand } from "../../../../base.command-CaFn9EwG.mjs";
 import chalk from "chalk";
 import { Args, Flags } from "@oclif/core";
 //#region src/adapters/oclif/commands/overlays/diff.ts
@@ -8,7 +8,7 @@ var OverlaysDiff = class extends BaseCommand {
 	static flags = { dir: Flags.string({
 		char: "d",
 		description: "Directory containing overlay files",
-		default: "./overlays"
+		default: "./semantic"
 	}) };
 	static args = { files: Args.string({
 		description: "Specific files to diff (optional)",

package/dist/adapters/oclif/commands/overlays/pull.d.mts

@@ -1,4 +1,4 @@
-import { l as PullResult } from "../../../../types-DZssnweO.mjs";
+import { u as PullResult } from "../../../../types-DmuJzN0Z.mjs";
 import { t as BaseCommand } from "../../../../base.command-BjFWMIzL.mjs";
 import * as _$_oclif_core_interfaces0 from "@oclif/core/interfaces";
 

package/dist/adapters/oclif/commands/overlays/pull.mjs

@@ -1,5 +1,5 @@
-import { a as PullService, p as createApiClient, y as getConfig } from "../../../../core-Dq15hO6f.mjs";
-import { t as BaseCommand } from "../../../../base.command-DlYMawJ6.mjs";
+import { a as PullService, p as createApiClient, y as getConfig } from "../../../../core-BSLZ9hQU.mjs";
+import { t as BaseCommand } from "../../../../base.command-CaFn9EwG.mjs";
 import chalk from "chalk";
 import { Flags } from "@oclif/core";
 //#region src/adapters/oclif/commands/overlays/pull.ts
@@ -9,7 +9,7 @@ var OverlaysPull = class extends BaseCommand {
 		dir: Flags.string({
 			char: "d",
 			description: "Directory to save overlay files",
-			default: "./overlays"
+			default: "./semantic"
 		}),
 		name: Flags.string({
 			char: "n",

package/dist/adapters/oclif/commands/overlays/push.d.mts

@@ -1,4 +1,4 @@
-import { u as PushResult } from "../../../../types-DZssnweO.mjs";
+import { d as PushResult } from "../../../../types-DmuJzN0Z.mjs";
 import { t as BaseCommand } from "../../../../base.command-BjFWMIzL.mjs";
 import * as _$_oclif_core_interfaces0 from "@oclif/core/interfaces";
 

package/dist/adapters/oclif/commands/overlays/push.mjs

@@ -1,5 +1,5 @@
-import { o as PushService, p as createApiClient, y as getConfig } from "../../../../core-Dq15hO6f.mjs";
-import { t as BaseCommand } from "../../../../base.command-DlYMawJ6.mjs";
+import { o as PushService, p as createApiClient, y as getConfig } from "../../../../core-BSLZ9hQU.mjs";
+import { t as BaseCommand } from "../../../../base.command-CaFn9EwG.mjs";
 import chalk from "chalk";
 import { Args, Flags } from "@oclif/core";
 //#region src/adapters/oclif/commands/overlays/push.ts
@@ -9,7 +9,7 @@ var OverlaysPush = class extends BaseCommand {
 		dir: Flags.string({
 			char: "d",
 			description: "Directory containing overlay files",
-			default: "./overlays"
+			default: "./semantic"
 		}),
 		force: Flags.boolean({
 			char: "f",

package/dist/adapters/oclif/commands/overlays/status.d.mts

@@ -1,4 +1,4 @@
-import { d as StatusResult } from "../../../../types-DZssnweO.mjs";
+import { f as StatusResult } from "../../../../types-DmuJzN0Z.mjs";
 import { t as BaseCommand } from "../../../../base.command-BjFWMIzL.mjs";
 import * as _$_oclif_core_interfaces0 from "@oclif/core/interfaces";
 

package/dist/adapters/oclif/commands/overlays/status.mjs

@@ -1,5 +1,5 @@
-import { i as StatusService, p as createApiClient, y as getConfig } from "../../../../core-Dq15hO6f.mjs";
-import { t as BaseCommand } from "../../../../base.command-DlYMawJ6.mjs";
+import { i as StatusService, p as createApiClient, y as getConfig } from "../../../../core-BSLZ9hQU.mjs";
+import { t as BaseCommand } from "../../../../base.command-CaFn9EwG.mjs";
 import chalk from "chalk";
 import { Args, Flags } from "@oclif/core";
 //#region src/adapters/oclif/commands/overlays/status.ts
@@ -17,7 +17,7 @@ var OverlaysStatus = class extends BaseCommand {
 		dir: Flags.string({
 			char: "d",
 			description: "Directory containing overlay files",
-			default: "./overlays"
+			default: "./semantic"
 		}),
 		columns: Flags.string({
 			description: `Columns to display (comma-separated). Available: ${ALL_COLUMNS.join(", ")}`,

package/dist/{base.command-DlYMawJ6.mjs → base.command-CaFn9EwG.mjs}

@@ -1,4 +1,4 @@
-import { E as setClerkEnv, P as ApiError } from "./core-Dq15hO6f.mjs";
+import { E as setClerkEnv, P as ApiError } from "./core-BSLZ9hQU.mjs";
 import { Command, Flags } from "@oclif/core";
 import { makeTable } from "@oclif/table";
 //#region src/adapters/oclif/base.command.ts

package/dist/{core-Dq15hO6f.mjs → core-BSLZ9hQU.mjs}

@@ -4,6 +4,7 @@ import * as os from "os";
 import { createServer } from "node:http";
 import * as crypto from "crypto";
 import { Client, client } from "@revos/api-client";
+import { parse, stringify } from "yaml";
 import search from "@inquirer/search";
 //#region src/core/errors.ts
 var ApiError = class extends Error {
@@ -423,20 +424,20 @@ function loadOverlayFile(filePath) {
 	const absolutePath = path.resolve(filePath);
 	const stats = fs.statSync(absolutePath);
 	const content = fs.readFileSync(absolutePath, "utf-8");
-	let data;
+	let parsed;
 	try {
-		data = JSON.parse(content);
+		parsed = parse(content) ?? {};
 	} catch (e) {
-		throw new Error(`Invalid JSON in ${filePath}: ${e instanceof Error ? e.message : String(e)}`, { cause: e });
+		throw new Error(`Invalid YAML in ${filePath}: ${e instanceof Error ? e.message : String(e)}`, { cause: e });
 	}
 	const fileName = path.basename(filePath);
 	return {
 		filePath: absolutePath,
 		fileName,
 		overlay: {
-			name: fileName.replace(/\.json$/, ""),
-			description: data.description || "",
-			data
+			name: parsed.name || fileName.replace(/\.yml$/, "").replace(/\.yaml$/, ""),
+			description: parsed.description || "",
+			data: parsed
 		},
 		mtime: stats.mtime
 	};
@@ -447,7 +448,7 @@ function loadOverlaysFromDir(dirPath) {
 	const files = fs.readdirSync(absoluteDir);
 	const overlays = [];
 	for (const file of files) {
-		if (!file.endsWith(".json")) continue;
+		if (!file.endsWith(".yml") && !file.endsWith(".yaml")) continue;
 		const filePath = path.join(absoluteDir, file);
 		if (!fs.statSync(filePath).isFile()) continue;
 		try {
@@ -464,7 +465,13 @@ function loadOverlaysByNames(dirPath, names) {
 	const overlays = [];
 	for (const name of names) {
 		let filePath = path.join(absoluteDir, name);
-		if (!fs.existsSync(filePath) && !name.endsWith(".json")) filePath = path.join(absoluteDir, `${name}.json`);
+		if (!fs.existsSync(filePath)) {
+			if (!name.endsWith(".yml") && !name.endsWith(".yaml")) {
+				const withYml = path.join(absoluteDir, `${name}.yml`);
+				if (fs.existsSync(withYml)) filePath = withYml;
+				else filePath = path.join(absoluteDir, `${name}.yaml`);
+			}
+		}
 		if (!fs.existsSync(filePath)) throw new Error(`Overlay file not found: ${name}`);
 		overlays.push(loadOverlayFile(filePath));
 	}
@@ -476,13 +483,14 @@ function loadOverlays(dir, files) {
 function saveOverlayToFile(dirPath, overlay) {
 	const absoluteDir = path.resolve(dirPath);
 	if (!fs.existsSync(absoluteDir)) fs.mkdirSync(absoluteDir, { recursive: true });
-	const fileName = `${sanitizeFileName(overlay.name)}.json`;
+	const fileName = `${sanitizeFileName(overlay.name)}.yml`;
 	const filePath = path.join(absoluteDir, fileName);
-	const dataToSave = {
+	const content = stringify({
 		...overlay.data,
-		description: overlay.description || overlay.data.description
-	};
-	fs.writeFileSync(filePath, JSON.stringify(dataToSave, null, 2) + "\n");
+		name: overlay.name,
+		description: overlay.description
+	});
+	fs.writeFileSync(filePath, content);
 	const updatedAt = new Date(overlay.updatedAt);
 	fs.utimesSync(filePath, updatedAt, updatedAt);
 	return filePath;
@@ -493,7 +501,7 @@ function getLocalOverlayNames(dirPath) {
 	const files = fs.readdirSync(absoluteDir);
 	const names = [];
 	for (const file of files) {
-		if (!file.endsWith(".json")) continue;
+		if (!file.endsWith(".yml") && !file.endsWith(".yaml")) continue;
 		const filePath = path.join(absoluteDir, file);
 		try {
 			const loaded = loadOverlayFile(filePath);
@@ -801,7 +809,43 @@ async function selectOrganization(organizations) {
 }
 //#endregion
 //#region src/core/services/init.service.ts
-var InitService = class {
+var InitService = class InitService {
+	static PROJECT_DIRS = [
+		".devcontainer",
+		".claude/skills/explore-lakehouse",
+		".claude/skills/create-semantic-model",
+		".claude/skills/create-semantic-model/references",
+		".claude/skills/create-dbt-transformations",
+		".claude/skills/create-dbt-transformations/references",
+		"dbt/models/bronze",
+		"dbt/models/silver",
+		"dbt/models/gold",
+		"semantic"
+	];
+	static PROJECT_FILES = [
+		".devcontainer/devcontainer.json",
+		".devcontainer/Dockerfile",
+		".devcontainer/setup.sh",
+		".gitignore",
+		"README.md",
+		"dbt/profiles.yml",
+		"dbt/dbt_project.yml",
+		"CLAUDE.md",
+		"AGENTS.md",
+		".claude/skills/explore-lakehouse/SKILL.md",
+		".claude/skills/create-semantic-model/SKILL.md",
+		".claude/skills/create-semantic-model/references/cube-examples.md",
+		".claude/skills/create-semantic-model/references/key-patterns.md",
+		".claude/skills/create-semantic-model/references/validation-queries.md",
+		".claude/skills/create-dbt-transformations/SKILL.md",
+		".claude/skills/create-dbt-transformations/references/sql-templates.md",
+		".claude/skills/create-dbt-transformations/references/schema-conventions.md",
+		".claude/skills/create-dbt-transformations/references/edge-cases.md",
+		"dbt/models/bronze/.gitkeep",
+		"dbt/models/silver/.gitkeep",
+		"dbt/models/gold/.gitkeep",
+		"semantic/.gitkeep"
+	];
 	constructor(templatesDir) {
 		this.templatesDir = templatesDir;
 	}
@@ -809,7 +853,7 @@ var InitService = class {
 		const { projectName, targetDir, apiUrl, token, organizationId } = options;
 		const projectDir = path.join(targetDir, projectName);
 		const projectSlug = projectName.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
-		const org = await this.resolveOrganization(apiUrl, token, organizationId);
+		const org = options.organization ?? await this.resolveOrganization(apiUrl, token, organizationId);
 		const gcpProjectId = await this.downloadGcpKey(apiUrl, token, org, projectSlug);
 		const resolvedOrg = {
 			...org,
@@ -819,7 +863,7 @@ var InitService = class {
 		return {
 			projectDir,
 			organization: resolvedOrg,
-			createdFiles: this.scaffold(projectDir, projectName, projectSlug, resolvedOrg)
+			createdFiles: this.scaffold(projectDir, projectName, projectSlug, resolvedOrg, options.allowExistingDir)
 		};
 	}
 	async resolveOrganization(apiUrl, token, organizationId) {
@@ -857,18 +901,18 @@ var InitService = class {
 		});
 		return JSON.parse(keyJson).project_id ?? "";
 	}
-	scaffold(projectDir, projectName, projectSlug, org) {
-		if (fs.existsSync(projectDir)) throw new Error(`Directory "${projectName}" already exists. Remove it or choose a different name.`);
+	dryRun(projectName, targetDir) {
+		return {
+			projectDir: path.join(targetDir, projectName),
+			dirs: InitService.PROJECT_DIRS,
+			files: InitService.PROJECT_FILES
+		};
+	}
+	scaffold(projectDir, projectName, projectSlug, org, allowExistingDir) {
+		if (fs.existsSync(projectDir) && !allowExistingDir) throw new Error(`Directory "${projectName}" already exists. Remove it or choose a different name.`);
 		const created = [];
-		for (const dir of [
-			".devcontainer",
-			".claude/skills/explore-lakehouse",
-			".claude/skills/create-semantic-model",
-			"dbt/models/bronze",
-			"dbt/models/silver",
-			"dbt/models/gold",
-			"semantic/cubes"
-		]) fs.mkdirSync(path.join(projectDir, dir), { recursive: true });
+		const dirs = InitService.PROJECT_DIRS;
+		for (const dir of dirs) fs.mkdirSync(path.join(projectDir, dir), { recursive: true });
 		const dbtName = projectName.replace(/[^a-zA-Z0-9_]/g, "_");
 		const files = {
 			".devcontainer/devcontainer.json": this.renderTemplate(".devcontainer/devcontainer.json", {
@@ -897,10 +941,17 @@ var InitService = class {
 				bqDataset: org.bqDataset
 			}),
 			".claude/skills/create-semantic-model/SKILL.md": this.renderTemplate("skills/create-semantic-model/SKILL.md", {}),
+			".claude/skills/create-semantic-model/references/cube-examples.md": this.renderTemplate("skills/create-semantic-model/references/cube-examples.md", {}),
+			".claude/skills/create-semantic-model/references/key-patterns.md": this.renderTemplate("skills/create-semantic-model/references/key-patterns.md", {}),
+			".claude/skills/create-semantic-model/references/validation-queries.md": this.renderTemplate("skills/create-semantic-model/references/validation-queries.md", {}),
+			".claude/skills/create-dbt-transformations/SKILL.md": this.renderTemplate("skills/create-dbt-transformations/SKILL.md", {}),
+			".claude/skills/create-dbt-transformations/references/sql-templates.md": this.renderTemplate("skills/create-dbt-transformations/references/sql-templates.md", {}),
+			".claude/skills/create-dbt-transformations/references/schema-conventions.md": this.renderTemplate("skills/create-dbt-transformations/references/schema-conventions.md", {}),
+			".claude/skills/create-dbt-transformations/references/edge-cases.md": this.renderTemplate("skills/create-dbt-transformations/references/edge-cases.md", {}),
 			"dbt/models/bronze/.gitkeep": "",
 			"dbt/models/silver/.gitkeep": "",
 			"dbt/models/gold/.gitkeep": "",
-			"semantic/cubes/.gitkeep": ""
+			"semantic/.gitkeep": ""
 		};
 		for (const [rel, content] of Object.entries(files)) {
 			const full = path.join(projectDir, rel);

package/dist/{index-DuqD2b_7.d.mts → index-B8n2GxTc.d.mts}

@@ -1,4 +1,4 @@
-import { d as StatusResult, l as PullResult, o as DiffResult, r as CubeOverlay, s as OverlayFile, t as Config, u as PushResult } from "./types-DZssnweO.mjs";
+import { d as PushResult, f as StatusResult, o as DiffResult, r as CubeOverlay, s as OverlayFile, t as Config, u as PullResult } from "./types-DmuJzN0Z.mjs";
 import { c as StoredCredentials, i as OAuthCallbackResult, l as TokenResponse, r as ClerkUserInfo, s as OrganizationInfo } from "./types-DsQtGF-c.mjs";
 import { Client } from "@revos/api-client";
 
@@ -162,6 +162,8 @@ interface InitOptions {
   apiUrl: string;
   token: string;
   organizationId?: string;
+  organization?: OrganizationInfo;
+  allowExistingDir?: boolean;
 }
 interface InitResult {
   projectDir: string;
@@ -170,10 +172,17 @@ interface InitResult {
 }
 declare class InitService {
   private readonly templatesDir;
+  private static readonly PROJECT_DIRS;
+  private static readonly PROJECT_FILES;
   constructor(templatesDir: string);
   run(options: InitOptions): Promise<InitResult>;
-  private resolveOrganization;
+  resolveOrganization(apiUrl: string, token: string, organizationId?: string): Promise<OrganizationInfo>;
   private downloadGcpKey;
+  dryRun(projectName: string, targetDir: string): {
+    projectDir: string;
+    dirs: readonly string[];
+    files: readonly string[];
+  };
   private scaffold;
   private renderTemplate;
 }

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { a as DiffEntry, c as OverlayStatusInfo, d as StatusResult, f as SyncStatus, i as DiffChange, l as PullResult, n as CubeDefinition, o as DiffResult, r as CubeOverlay, s as OverlayFile, t as Config, u as PushResult } from "./types-DZssnweO.mjs";
-import { A as ClerkEnv, B as tokenResponseToCredentials, C as LoadedOverlay, D as loadOverlaysByNames, E as loadOverlays, F as generatePKCEChallenge, G as isTokenExpired, H as startOAuthServer, I as getUserInfo, J as getConfig, K as loadCredentials, L as refreshAccessToken, M as PKCEChallenge, N as buildAuthorizationUrl, O as loadOverlaysFromDir, P as exchangeCodeForTokens, R as setClerkConfig, S as sanitizeFileName, T as loadOverlayFile, U as deleteCredentials, V as OAuthServerResult, W as getCredentialsPath, Y as ApiError, _ as createApiClient, a as DiffOptions, b as formatError, c as StatusOptions, d as PullOptions, f as PullService, g as ApiClient, h as PushService, i as DiffContext, j as ClerkOAuthConfig, k as saveOverlayToFile, l as StatusService, m as PushOptions, n as InitResult, o as DiffService, p as PushContext, q as saveCredentials, r as InitService, s as StatusContext, t as InitOptions, u as PullContext, v as unwrap, w as getLocalOverlayNames, x as isContentEqual, y as findRemoteOnlyOverlays, z as setClerkEnv } from "./index-DuqD2b_7.mjs";
+import { a as DiffEntry, c as OverlayFileData, d as PushResult, f as StatusResult, i as DiffChange, l as OverlayStatusInfo, n as CubeDefinition, o as DiffResult, p as SyncStatus, r as CubeOverlay, s as OverlayFile, t as Config, u as PullResult } from "./types-DmuJzN0Z.mjs";
+import { A as ClerkEnv, B as tokenResponseToCredentials, C as LoadedOverlay, D as loadOverlaysByNames, E as loadOverlays, F as generatePKCEChallenge, G as isTokenExpired, H as startOAuthServer, I as getUserInfo, J as getConfig, K as loadCredentials, L as refreshAccessToken, M as PKCEChallenge, N as buildAuthorizationUrl, O as loadOverlaysFromDir, P as exchangeCodeForTokens, R as setClerkConfig, S as sanitizeFileName, T as loadOverlayFile, U as deleteCredentials, V as OAuthServerResult, W as getCredentialsPath, Y as ApiError, _ as createApiClient, a as DiffOptions, b as formatError, c as StatusOptions, d as PullOptions, f as PullService, g as ApiClient, h as PushService, i as DiffContext, j as ClerkOAuthConfig, k as saveOverlayToFile, l as StatusService, m as PushOptions, n as InitResult, o as DiffService, p as PushContext, q as saveCredentials, r as InitService, s as StatusContext, t as InitOptions, u as PullContext, v as unwrap, w as getLocalOverlayNames, x as isContentEqual, y as findRemoteOnlyOverlays, z as setClerkEnv } from "./index-B8n2GxTc.mjs";
 import { a as OrgListResult, c as StoredCredentials, i as OAuthCallbackResult, l as TokenResponse, n as AuthStatusInfo, o as OrgSwitchResult, r as ClerkUserInfo, s as OrganizationInfo, t as AuthResult } from "./types-DsQtGF-c.mjs";
-export { ApiClient, ApiError, AuthResult, AuthStatusInfo, ClerkEnv, ClerkOAuthConfig, ClerkUserInfo, Config, CubeDefinition, CubeOverlay, DiffChange, DiffContext, DiffEntry, DiffOptions, DiffResult, DiffService, InitOptions, InitResult, InitService, LoadedOverlay, OAuthCallbackResult, OAuthServerResult, OrgListResult, OrgSwitchResult, OrganizationInfo, OverlayFile, OverlayStatusInfo, PKCEChallenge, PullContext, PullOptions, PullResult, PullService, PushContext, PushOptions, PushResult, PushService, StatusContext, StatusOptions, StatusResult, StatusService, StoredCredentials, SyncStatus, TokenResponse, buildAuthorizationUrl, createApiClient, deleteCredentials, exchangeCodeForTokens, findRemoteOnlyOverlays, formatError, generatePKCEChallenge, getConfig, getCredentialsPath, getLocalOverlayNames, getUserInfo, isContentEqual, isTokenExpired, loadCredentials, loadOverlayFile, loadOverlays, loadOverlaysByNames, loadOverlaysFromDir, refreshAccessToken, sanitizeFileName, saveCredentials, saveOverlayToFile, setClerkConfig, setClerkEnv, startOAuthServer, tokenResponseToCredentials, unwrap };
+export { ApiClient, ApiError, AuthResult, AuthStatusInfo, ClerkEnv, ClerkOAuthConfig, ClerkUserInfo, Config, CubeDefinition, CubeOverlay, DiffChange, DiffContext, DiffEntry, DiffOptions, DiffResult, DiffService, InitOptions, InitResult, InitService, LoadedOverlay, OAuthCallbackResult, OAuthServerResult, OrgListResult, OrgSwitchResult, OrganizationInfo, OverlayFile, OverlayFileData, OverlayStatusInfo, PKCEChallenge, PullContext, PullOptions, PullResult, PullService, PushContext, PushOptions, PushResult, PushService, StatusContext, StatusOptions, StatusResult, StatusService, StoredCredentials, SyncStatus, TokenResponse, buildAuthorizationUrl, createApiClient, deleteCredentials, exchangeCodeForTokens, findRemoteOnlyOverlays, formatError, generatePKCEChallenge, getConfig, getCredentialsPath, getLocalOverlayNames, getUserInfo, isContentEqual, isTokenExpired, loadCredentials, loadOverlayFile, loadOverlays, loadOverlaysByNames, loadOverlaysFromDir, refreshAccessToken, sanitizeFileName, saveCredentials, saveOverlayToFile, setClerkConfig, setClerkEnv, startOAuthServer, tokenResponseToCredentials, unwrap };

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { A as getCredentialsPath, C as getUserInfo, D as tokenResponseToCredentials, E as setClerkEnv, M as loadCredentials, N as saveCredentials, O as startOAuthServer, P as ApiError, S as generatePKCEChallenge, T as setClerkConfig, _ as isContentEqual, a as PullService, b as buildAuthorizationUrl, c as loadOverlayFile, d as loadOverlaysFromDir, f as saveOverlayToFile, g as formatError, h as findRemoteOnlyOverlays, i as StatusService, j as isTokenExpired, k as deleteCredentials, l as loadOverlays, m as unwrap, o as PushService, p as createApiClient, r as DiffService, s as getLocalOverlayNames, t as InitService, u as loadOverlaysByNames, v as sanitizeFileName, w as refreshAccessToken, x as exchangeCodeForTokens, y as getConfig } from "./core-Dq15hO6f.mjs";
+import { A as getCredentialsPath, C as getUserInfo, D as tokenResponseToCredentials, E as setClerkEnv, M as loadCredentials, N as saveCredentials, O as startOAuthServer, P as ApiError, S as generatePKCEChallenge, T as setClerkConfig, _ as isContentEqual, a as PullService, b as buildAuthorizationUrl, c as loadOverlayFile, d as loadOverlaysFromDir, f as saveOverlayToFile, g as formatError, h as findRemoteOnlyOverlays, i as StatusService, j as isTokenExpired, k as deleteCredentials, l as loadOverlays, m as unwrap, o as PushService, p as createApiClient, r as DiffService, s as getLocalOverlayNames, t as InitService, u as loadOverlaysByNames, v as sanitizeFileName, w as refreshAccessToken, x as exchangeCodeForTokens, y as getConfig } from "./core-BSLZ9hQU.mjs";
 export { ApiError, DiffService, InitService, PullService, PushService, StatusService, buildAuthorizationUrl, createApiClient, deleteCredentials, exchangeCodeForTokens, findRemoteOnlyOverlays, formatError, generatePKCEChallenge, getConfig, getCredentialsPath, getLocalOverlayNames, getUserInfo, isContentEqual, isTokenExpired, loadCredentials, loadOverlayFile, loadOverlays, loadOverlaysByNames, loadOverlaysFromDir, refreshAccessToken, sanitizeFileName, saveCredentials, saveOverlayToFile, setClerkConfig, setClerkEnv, startOAuthServer, tokenResponseToCredentials, unwrap };