strata-cli 0.1.12 → 0.1.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 060e97cfbb307efe69eff087983dc1d28e3e4008bd13f5529a7560e5d7e00f06
-  data.tar.gz: 134dbf05ad0b5870433fcb3c9a90e50853ed0a9f97c3378a97d208b4f6866dae
+  metadata.gz: 7b0fdc6cf6a28080152c9b0237d54e206740477d196178a2e6d5aa5642720135
+  data.tar.gz: d049c71dd05982f8a52b786ae59ffdf590056dc3bdb5cadd7045227dbe9de867
 SHA512:
-  metadata.gz: bf09f28b188e03929870b14515efb76d86f9aab034d048a3e2e5c49751f722718cf6a4d37a8c7d7e2966bd080aac758956df51951758a73b98a885003cbd5bb4
-  data.tar.gz: ab72ddfa33b44cc8da63cb10c2920575030fa53a4216d8d75eb9e2a38f2eebdc3f36afd3264c6dc81c00b440c6df4eb029df86126e600d16455def0cf311efb5
+  metadata.gz: f7c7aa4945d149bff16578ca52f99a005b3c9d4c3b5897b52929bf9bfffb140883457f60d52552fa551faee5ef6d0472069c368125653bf784078378a7065dbe
+  data.tar.gz: 48a81467d16e8b489bdce4f177dd1b158ac09344c07d1944d804a679afc0ed47e52047b6a478781ba245c291a4d9bb8512f8159b1d09ecf41e1f537b5873e52b

data/CHANGELOG.md

@@ -1,5 +1,37 @@
 ## [Unreleased]
 
+## [0.1.14] - 2026-07-17
+
+### Added
+
+- **Tutorial command**: `strata tutorial` walks new users through a guided setup — initializes a project, configures a datasource, and deploys to a local Strata server running on port 8080.
+
+### Changed
+
+- **Tutorial deployment**: Completion message now includes `--skip-audit` flag in the deployment instructions.
+- **Tutorial server config**: Default server port set to 8080 (was 3000).
+
+## [0.1.13] - 2026-06-20
+
+### Changed
+
+- **Documentation**: ClickHouse adapter docs in README, gemspec description, `datasource add` help text, and CHANGELOG notes for the 0.1.12 feature set.
+
+## [0.1.12] - 2026-06-20
+
+### Added
+
+- **ClickHouse adapter**: `strata datasource add clickhouse` with connection prompts and optional password credentials.
+- **Security policy scaffolding**: `strata create policy` to add policies to `security.yml`; new projects include a `security.yml` template.
+
+### Changed
+
+- **dwh dependency**: Require `dwh` `~> 0.5.0` (ClickHouse adapter and dialect keyword/aggregate support).
+
+### Fixed
+
+- **Datasource introspection**: Pass only `catalog` and `schema` qualifiers to DWH for `tables` and `meta` (avoids leaking CLI flags like `--agent` or `--pattern` to adapters).
+
 ## [0.1.11] - 2026-05-22
 
 ### Changed

data/README.md

@@ -375,6 +375,17 @@ my_databricks:
   catalog: main
   schema: default
   auth_mode: oauth_m2m
+
+my_clickhouse:
+  adapter: clickhouse
+  name: ClickHouse
+  protocol: http
+  host: localhost
+  port: 8123
+  database: default
+  username: default
+  tier: warm
+  query_timeout: 3600
 ```
 
 ### Databricks authentication
@@ -403,6 +414,7 @@ Use service principal credentials and run `strata ds auth my_databricks` to save
 - **Druid** - Apache Druid support
 - **Redshift** - Amazon Redshift support
 - **Databricks** - Databricks SQL warehouse support
+- **ClickHouse** - ClickHouse HTTP/native SQL support
 - **SQLite** - SQLite database support
 
 ## Security

data/lib/strata/cli/configuration.rb

@@ -72,6 +72,8 @@ module Strata
 
       def reload!
         @data.clear
+        @config_file_path = nil
+        @project_config_file_path = nil
         load_config
       end
 

data/lib/strata/cli/credentials.rb

@@ -48,6 +48,8 @@ module Strata
           credentials["auth_mode"] = "oauth_m2m"
           credentials["oauth_client_id"] = @prompt.ask("OAuth Client ID:")
           credentials["oauth_client_secret"] = @prompt.ask("OAuth Client Secret:")
+        when "clickhouse"
+          credentials["password"] = @prompt.mask("Enter Password (leave blank if none):")
         else
           if required?
             unless %w[postgres mysql trino sqlserver].include?(adapter)

data/lib/strata/cli/descriptions/datasource/add.txt

@@ -18,4 +18,4 @@ Examples:
 
   strata datasource add snowflake        # Directly add Snowflake datasource
 
-Supported adapters: postgres, mysql, sqlserver, snowflake, athena, trino, duckdb, druid
+Supported adapters: postgres, mysql, sqlserver, snowflake, athena, trino, duckdb, druid, clickhouse, databricks, redshift, sqlite

data/lib/strata/cli/descriptions/tutorial.txt

@@ -0,0 +1,13 @@
+Sets up the Strata tutorial project locally by cloning the tutorial repo,
+wiring it to your Strata instance, and preparing it for `strata deploy`.
+
+The --api-key value is shown on the tutorial setup page
+in your Strata instance. Copy-paste them directly from there.
+
+After running this command, `cd` into the project directory and run
+`strata deploy` to deploy the tutorial to your Strata instance.
+
+Example:
+  strata tutorial -a your_api_key
+  cd tutorial
+  strata deploy

data/lib/strata/cli/generators/tutorial.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+require_relative "group"
+require_relative "../helpers/project_helper"
+require_relative "../output"
+require "yaml"
+require "fileutils"
+
+module Strata
+  module CLI
+    module Generators
+      class Tutorial < Group
+        TUTORIAL_REPO = "https://github.com/stratasite/strata-tutorial-project"
+        DEFAULT_SERVER = "http://localhost:8080"
+        TUTORIAL_PROJECT = "strata-tutorial-project"
+
+        class_option :api_key, aliases: ["a"], type: :string, desc: "Strata API key"
+
+        desc "Sets up the Strata tutorial project locally."
+
+        def validate_options
+          raise Strata::CommandError, "--api-key (-a) is required." unless options[:api_key]
+          @uid = TUTORIAL_PROJECT
+          @project_id = 1
+        end
+
+        def clone_tutorial_repo
+          if File.directory?(@uid)
+            Output.print_status(:skip, "Directory '#{@uid}' already exists — re-using it", type: :info, context: self)
+            return
+          end
+          Output.print_status(:clone, "Cloning tutorial from #{TUTORIAL_REPO}", type: :success, context: self)
+          run "git clone #{TUTORIAL_REPO} #{@uid}", verbose: false, capture: true
+          raise Strata::CommandError, "Failed to clone tutorial repo." unless File.directory?(@uid)
+        end
+
+        def reinitialize_git
+          inside @uid do
+            FileUtils.rm_rf(".git")
+            run "git init -b main", verbose: false, capture: true
+            create_file ".gitignore", ".strata\n.strata_cli/\n", force: true
+          end
+        end
+
+        def write_strata_config
+          strata_path = File.join(@uid, ".strata")
+          File.write(strata_path, "api_key: #{options[:api_key]}\nserver: #{DEFAULT_SERVER}\n")
+          File.chmod(0o600, strata_path)
+        end
+
+        def update_project_yml
+          project_yml = File.join(@uid, "project.yml")
+          return unless File.exist?(project_yml)
+
+          Helpers::ProjectHelper.persist_project_id_to_yml(@project_id, project_yml_path: project_yml)
+        end
+
+        def initial_commit
+          inside @uid do
+            run "git add -A", verbose: false, capture: true
+            run 'git commit -m "Initial tutorial project setup"', verbose: false, capture: true
+          end
+        end
+
+        def completion_message
+          Output.print_success("\n✔ Tutorial project '#{@uid}' is ready!\n", context: self)
+          Output.print_info("  Next: cd #{@uid} && strata deploy --skip-audit\n", context: self)
+        end
+      end
+    end
+  end
+end

data/lib/strata/cli/guard.rb

@@ -8,6 +8,7 @@ module Strata
     module Guard
       ALLOWED_COMMANDS = %w[
         init
+        tutorial
         help
         adapters
         version

data/lib/strata/cli/main.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative "generators/project"
+require_relative "generators/tutorial"
 require_relative "sub_commands/datasource"
 require_relative "sub_commands/deploy"
 require_relative "sub_commands/branch"
@@ -47,6 +48,13 @@ module Strata
         invoke Generators::Project, [project_name], options
       end
 
+      desc "tutorial", "Set up the Strata TPC-DS tutorial project"
+      long_desc_from_file "tutorial"
+      option :api_key, aliases: ["a"], type: :string, desc: "Strata API key"
+      def tutorial
+        invoke Generators::Tutorial, [], options
+      end
+
       desc "adapters", "Lists supported data warehouse adapters"
       def adapters
         out = " SUPPORTED ADAPTERS: \n\t#{DWH.adapters.keys.join("\n\t")}"

data/lib/strata/cli/sub_commands/datasource.rb

@@ -187,7 +187,7 @@ module Strata
           return unless ds_key
 
           adapter = create_adapter(ds_key)
-          tables = adapter.tables(**options)
+          tables = adapter.tables(**adapter_qualifiers)
           tables = tables.select { it =~ /#{options[:pattern]}/ } if options[:pattern]
 
           if agent_mode?
@@ -214,7 +214,7 @@ module Strata
         method_option :schema, aliases: "s", type: :string, desc: "Change the schema from the configured one."
         def meta(ds_key, table_name)
           adapter = create_adapter(ds_key)
-          md = adapter.metadata(table_name, **options.transform_keys(&:to_sym))
+          md = adapter.metadata(table_name, **adapter_qualifiers)
 
           if agent_mode?
             columns = md.columns.map do |column|
@@ -275,6 +275,10 @@ module Strata
           false
         end
 
+        def adapter_qualifiers
+          options.transform_keys(&:to_sym).slice(:catalog, :schema)
+        end
+
         def validate_file_path(file_path, project_path = Dir.pwd)
           expanded = File.expand_path(file_path, project_path)
           project_root = File.expand_path(project_path)
@@ -370,6 +374,14 @@ module Strata
               "schema" => "default",
               "auth_mode" => "oauth_m2m"
             }
+          when "clickhouse"
+            {
+              "protocol" => "http",
+              "host" => "localhost",
+              "port" => 8123,
+              "database" => "test_db",
+              "username" => "default"
+            }
           else
             {}
           end

data/lib/strata/cli/version.rb

@@ -2,6 +2,6 @@
 
 module Strata
   module CLI
-    VERSION = "0.1.12"
+    VERSION = "0.1.14"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: strata-cli
 version: !ruby/object:Gem::Version
-  version: 0.1.12
+  version: 0.1.14
 platform: ruby
 authors:
 - Ajo Abraham
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.4
+        version: 0.5.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.4
+        version: 0.5.0
 - !ruby/object:Gem::Dependency
   name: aws-sdk-athena
   requirement: !ruby/object:Gem::Requirement
@@ -224,7 +224,7 @@ description: |
   Comprehensive CLI tool for managing Strata Semantic Analytics projects. Create and initialize
   projects, manage datasource connections, build semantic table models with AI assistance, run
   audits and validations, and deploy projects to Strata servers. Supports multiple data warehouse
-  adapters including PostgreSQL, MySQL, SQL Server, Snowflake, Athena, Trino, and more.
+  adapters including PostgreSQL, MySQL, SQL Server, Snowflake, Athena, Trino, ClickHouse, and more.
 email:
 - ajo@strata.site
 - allen@strata.site
@@ -264,6 +264,7 @@ files:
 - lib/strata/cli/descriptions/deploy/deploy.txt
 - lib/strata/cli/descriptions/deploy/status.txt
 - lib/strata/cli/descriptions/init.txt
+- lib/strata/cli/descriptions/tutorial.txt
 - lib/strata/cli/error_reporter.rb
 - lib/strata/cli/generators/datasource.rb
 - lib/strata/cli/generators/group.rb
@@ -292,6 +293,7 @@ files:
 - lib/strata/cli/generators/templates/table.table_name.yml
 - lib/strata/cli/generators/templates/test.yml
 - lib/strata/cli/generators/test.rb
+- lib/strata/cli/generators/tutorial.rb
 - lib/strata/cli/guard.rb
 - lib/strata/cli/helpers/command_context.rb
 - lib/strata/cli/helpers/datasource_helper.rb