@revos/cli 0.1.2 → 0.1.3

package/README.md

@@ -61,7 +61,7 @@ If the destination already exists and is not empty, you will be prompted to conf
 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.
 
@@ -117,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
@@ -137,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
 ```
 
@@ -147,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-EJgxP-x5.mjs";
-import { t as BaseCommand } from "../../../../base.command-DDSLyx5v.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-EJgxP-x5.mjs";
-import { t as BaseCommand } from "../../../../base.command-DDSLyx5v.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-EJgxP-x5.mjs";
-import { t as BaseCommand } from "../../../../base.command-DDSLyx5v.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.mjs

@@ -1,6 +1,6 @@
-import { P as ApiError, t as InitService, y as getConfig } from "../../../core-EJgxP-x5.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-DDSLyx5v.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";

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-EJgxP-x5.mjs";
-import { t as BaseCommand } from "../../../../base.command-DDSLyx5v.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-EJgxP-x5.mjs";
-import { t as BaseCommand } from "../../../../base.command-DDSLyx5v.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-EJgxP-x5.mjs";
-import { t as BaseCommand } from "../../../../base.command-DDSLyx5v.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-EJgxP-x5.mjs";
-import { t as BaseCommand } from "../../../../base.command-DDSLyx5v.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-EJgxP-x5.mjs";
-import { t as BaseCommand } from "../../../../base.command-DDSLyx5v.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-EJgxP-x5.mjs";
-import { t as BaseCommand } from "../../../../base.command-DDSLyx5v.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-EJgxP-x5.mjs";
-import { t as BaseCommand } from "../../../../base.command-DDSLyx5v.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-DDSLyx5v.mjs → base.command-CaFn9EwG.mjs}

@@ -1,4 +1,4 @@
-import { E as setClerkEnv, P as ApiError } from "./core-EJgxP-x5.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-EJgxP-x5.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);
@@ -806,10 +814,13 @@ var InitService = class InitService {
 		".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/cubes"
+		"semantic"
 	];
 	static PROJECT_FILES = [
 		".devcontainer/devcontainer.json",
@@ -823,10 +834,17 @@ var InitService = class InitService {
 		"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/cubes/.gitkeep"
+		"semantic/.gitkeep"
 	];
 	constructor(templatesDir) {
 		this.templatesDir = templatesDir;
@@ -923,10 +941,17 @@ var InitService = class InitService {
 				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-DH6vy050.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";
 

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-DH6vy050.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-EJgxP-x5.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 };

package/dist/templates/AGENTS.md

@@ -7,7 +7,7 @@ This is a RevOS data engineering project for **<%=orgName%>** organization.
 - `dbt/models/bronze/` — raw ingested data
 - `dbt/models/silver/` — cleaned & conformed
 - `dbt/models/gold/` — business-ready marts
-- `semantic/cubes/` — Cube.dev cube definitions
+- `semantic/` — Cube.dev cube definitions
 
 ## Key Commands
 

package/dist/templates/skills/create-dbt-transformations/SKILL.md

@@ -0,0 +1,214 @@
+---
+name: create-dbt-transformations
+description: Create new dbt transformations (bronze/silver/gold models) in the RevOS dbt project. Use when asked to create a dbt model, build a transformation, add a new layer model, declare a raw source, or register a new Airbyte-ingested table. Covers dbt project conventions, sources, materialization, schema.yml, and validation commands.
+---
+
+# Create dbt Transformations
+
+Use this skill to generate SQL models, declare sources, update `schema.yml`, and validate models with `revos dbt run` / `revos dbt test`.
+
+For BigQuery exploration (listing datasets, inspecting raw tables, previewing rows, null rates), load the `explore-lakehouse` skill. If that skill is not installed, fall back to:
+
+```bash
+bq show --format=prettyjson $REVOS_BQ_DATASET.<table>
+```
+
+Warn the user: "The `explore-lakehouse` skill is not installed — using `bq show` as a fallback. Install it for richer schema exploration."
+
+---
+
+# Part 1: Knowledge Base
+
+## Layer Conventions
+
+- **gold** — business-ready models exposed for reporting or downstream consumption.
+- **silver** — cleaned, deduplicated, type-conformed intermediates.
+- **bronze** — thin views over raw source data. References sources via `{{ source() }}`.
+
+When layer is not obvious from context, ask (see Checkpoint 1).
+
+## Sources (bronze layer)
+
+Raw tables ingested by Airbyte are not dbt models. Declare them as dbt sources so bronze models can reference them with `{{ source() }}`.
+
+Sources are declared in `dbt/models/bronze/schema.yml` under a `sources:` block using `schema` (the BigQuery dataset):
+
+```yaml
+sources:
+  - name: raw
+    schema: "{{ env_var('REVOS_BQ_DATASET') }}"
+    tables:
+      - name: hubspot_contacts
+```
+
+Reference in bronze SQL:
+
+```sql
+SELECT * FROM {{ source('raw', 'hubspot_contacts') }}
+```
+
+See [schema-conventions.md](references/schema-conventions.md) for the full declaration pattern alongside `models:`.
+
+## Materialization
+
+Inherited globally from `dbt_project.yml` — do not add `{{ config(materialized=...) }}` unless the user explicitly asks to override.
+
+## `schema.yml` Convention
+
+One shared file per layer at `dbt/models/<layer>/schema.yml`. Append new models; never create per-model YAML files. See [schema-conventions.md](references/schema-conventions.md) for full examples and composite-PK / dbt-utils patterns.
+
+## Resolving Physical BigQuery Tables
+
+Materialized table lives at: `$REVOS_BQ_DATASET.<model_name>`
+
+**When to use `{{ ref() }}` vs. `{{ source() }}`:**
+
+| Context                             | Use                              |
+| ----------------------------------- | -------------------------------- |
+| dbt SQL → other dbt model           | `{{ ref('<model>') }}`           |
+| dbt SQL → raw source table (bronze) | `{{ source('raw', '<table>') }}` |
+
+Always declare raw tables as sources before referencing them. Do not use bare fully qualified names — that bypasses dbt's dependency graph and source freshness tracking.
+
+## Standard dbt Commands
+
+Always use the `revos` wrapper:
+
+```bash
+revos dbt parse                               # validate syntax (no warehouse)
+revos dbt compile --select <model>            # resolve refs, produce compiled SQL
+revos dbt run --select <model>                # execute against warehouse
+revos dbt test --select <model>               # run tests
+revos dbt build --select <model>              # run + test
+revos dbt build --select path:models/<layer>  # entire layer
+```
+
+---
+
+# Part 2: Workflow — Create a New dbt Transformation
+
+## Execution Order
+
+For each transformation (one at a time — do not batch):
+
+1. Determine the target layer (Checkpoint 1 if unclear).
+2. Determine the model name.
+3. Check if that model already exists (Checkpoint 2 if yes).
+4. Gather source data and transformation logic. For bridge models, apply the bridge template ([sql-templates.md](references/sql-templates.md)).
+5. For bronze models: check if required sources are declared in `dbt/models/bronze/schema.yml`; add them if missing.
+6. Generate `dbt/models/<layer>/<model_name>.sql`.
+7. Detect the primary key (Checkpoint 3 if ambiguous).
+8. Add model entry to `dbt/models/<layer>/schema.yml` with PK and FK tests. See [schema-conventions.md](references/schema-conventions.md).
+9. Run `revos dbt run --select <model_name>` and report result.
+10. Run `revos dbt test --select <model_name>` and report result.
+11. Summarize (see Final Response Format).
+
+For multiple transformations in one request: repeat steps 1–11 per model in order.
+
+---
+
+## Mandatory User Checkpoints
+
+### Checkpoint 1: Layer Selection
+
+Ask if the layer is not obvious:
+
+```text
+Which layer should this transformation live in?
+
+- gold: business-ready, exposed for reporting or downstream consumption
+- silver: cleaned/intermediate, shared across downstream uses
+- bronze: close-to-source view over raw data, references sources
+```
+
+Layer is obvious when the user explicitly names it.
+
+### Checkpoint 2: Existing Model Conflict
+
+If `dbt/models/<layer>/<model_name>.sql` exists:
+
+```text
+A model named <model_name> already exists at dbt/models/<layer>/<model_name>.sql.
+
+Options:
+- overwrite: replace with new transformation
+- edit:      modify existing (describe the change)
+- rename:    use a different name
+```
+
+If found in a different layer, mention it too.
+
+### Checkpoint 3: Ambiguous Primary Key
+
+If PK detection produces no clear result:
+
+```text
+I could not unambiguously detect the primary key. Candidates:
+- <candidate_1>
+- <candidate_2>
+
+Which column(s) should be the primary key?
+```
+
+---
+
+## Primary Key Detection
+
+Apply in order; stop at first clear result:
+
+1. `ROW_NUMBER() OVER (PARTITION BY <cols>) = 1` → partition columns are PK.
+2. `SELECT DISTINCT` over a small column set → all selected columns form composite PK.
+3. `GROUP BY <cols>` at outermost level → grouping columns are PK.
+4. Single column named `id` → PK.
+5. Single column named `<entity>_id` matching the model name stem → PK.
+6. Bridge naming `<entity_a>_<entity_b>` → `(<entity_a>_id, <entity_b>_id)` composite PK.
+
+If none produce a clear answer → Checkpoint 3.
+
+## Foreign Key Detection
+
+A column is a FK candidate if it matches `<entity>_id` where `<entity>` ≠ model's own entity, is not part of the PK, and is not nullable by design. Add `not_null` test only (no `relationships` tests by default).
+
+## SQL File Generation
+
+See [sql-templates.md](references/sql-templates.md) for:
+
+- Bronze model template using `{{ source() }}`
+- Standard silver/gold model template
+- Bridge model (JSON array) template with concrete example
+- Bridge model naming convention and SQL content rules
+
+## schema.yml Update
+
+See [schema-conventions.md](references/schema-conventions.md) for full examples including sources declaration, composite PK, and dbt-utils patterns.
+
+## Edge Cases
+
+See [edge-cases.md](references/edge-cases.md) for: missing SQL details, missing upstream model, undeclared source, run/test failure handling.
+
+---
+
+## Final Response Format
+
+```text
+Created dbt transformation: <model_name>
+
+Layer:           <bronze | silver | gold>
+File:            dbt/models/<layer>/<model_name>.sql
+Materialization: <inherited: table | overridden: <type>>
+Primary key:     <pk_column>  (or composite: <col_1>, <col_2>)
+Foreign keys:    <fk_1>, <fk_2>  (or "none detected")
+schema.yml:      dbt/models/<layer>/schema.yml (entry added)
+
+Tests:
+- not_null on <pk>: added
+- unique on <pk>: added | skipped: dbt-utils unavailable
+- not_null on <fk>: added
+
+Validation:
+- revos dbt run:  passed | failed
+- revos dbt test: passed | failed
+
+Physical table after run:
+`<resolved_dataset>.<model_name>`
+```