strata-cli 0.1.3.beta → 0.1.4.beta

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0dc0377469e1bfb8d12c50f839b1f530d2104b1b894e5623d0f009081e60f1e5
-  data.tar.gz: f4595f187e23891e5b1d64ef384ae48b1d3e73bd34a5ab8afefab9886b95f5ad
+  metadata.gz: 2ea80c6d9e3c9d9db1f592e8fc07470b23fecafe6a31052aecd69b948f1bdec7
+  data.tar.gz: 57af64d1411a970716f5be79db6ac93b9c54b4f76c0f0dd1265a372ff1c28607
 SHA512:
-  metadata.gz: b13368ec18b1d53316d3eb01f42f869ff81e8297b2f5451c337073cf0fed8400694a629136c3bbc8bec9b3bfd1affd786a9b1343a4b9b6f3561089d5aba86e9c
-  data.tar.gz: c47cfbdd8e1d54dda6b9b92b3e6385bf14f8d0e03c608721436dafeb70177fe2f51893003721edd1bebb757bbd8f0eefc3164c6c9287707ffc8ee3f86d2175f1
+  metadata.gz: b4de4eb2ce818ce0fe851b79f3fe0d82b2540257246638052c034506d605256bd98ca3cbe7a61dac0e4b240258f39bd6b4cadfeb3681a59038851d2257e68266
+  data.tar.gz: 9db418cf2a36236856cafda813885684ad3e9a558ab4bd44ce60f52d57a202f77124b69270b044fd940ef58d95db3f6edfdb9ca36efbaa078e073bc20f6cb68a

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 ## [Unreleased]
 
+## [0.1.4.beta] - 2026-02-26
+
+### Added
+
+- **Table generator**: Support synonyms for fields in generated tables.
+
+### Changed
+
+- **Server configuration**: Refactored server config handling and improved `project.yml` persistence.
+- **Datasource helper**: Read-only mode support for file-based databases.
+
 ## [0.1.3.beta] - 2026-01-28
 
 ### Added

data/README.md

@@ -440,8 +440,9 @@ Release a new version:
 
 1. Update version in `lib/strata/cli/version.rb`
 2. Update `CHANGELOG.md` with the new version and changes
-3. Commit the changes: `git add lib/strata/cli/version.rb CHANGELOG.md && git commit -m "Bump version to X.Y.Z"`
-4. Run `bundle exec rake release` (builds gem, creates git tag, and pushes to rubygems.org)
+3. Commit and merge to `master`: `git add lib/strata/cli/version.rb CHANGELOG.md && git commit -m "Bump version to X.Y.Z"` (then open a PR and merge)
+4. **Via GitHub Actions (recommended):** In the repo go to **Actions → Release → Run workflow**, choose the branch (e.g. `master`), optionally enable "Build and test only" for a dry run, then **Run workflow**. Ensure the repo secret `RUBYGEMS_API_KEY` is set (RubyGems API key with push permission).
+5. **Via console:** From a checkout of `master` after the version-bump merge, run `bundle exec rake release` (builds gem, creates git tag, pushes tag and gem to RubyGems).
 
 ## Contributing
 

data/lib/strata/cli/ai/services/table_generator.rb

@@ -20,6 +20,9 @@ module Strata
             - schema_type: "dimension" for categorical/text, "measure" for numeric aggregations
             - data_type: string, integer, bigint, decimal, date, date_time, boolean
             - expression: SQL expression (for measures include aggregation like "sum(amount)")
+            - synonyms: Array of 2-4 alternative names users might use to refer to this field.
+              These help AI search and natural language queries find the right field.
+              Example: "Customer ID" → ["cust id", "client id", "buyer id"]
 
             Output ONLY valid JSON array, no explanations.
           PROMPT
@@ -120,8 +123,8 @@ module Strata
 
               #{column_list}#{context_section}#{user_context_section}
 
-              Return JSON array with objects containing: name, description, schema_type, data_type, expression
-              Example: [{"name": "Order ID", "description": "Primary key", "schema_type": "dimension", "data_type": "bigint", "expression": "id"}]
+              Return JSON array with objects containing: name, description, schema_type, data_type, expression, synonyms
+              Example: [{"name": "Order ID", "description": "Primary key", "schema_type": "dimension", "data_type": "bigint", "expression": "id", "synonyms": ["order number", "order key"]}]
             PROMPT
           end
 
@@ -153,7 +156,7 @@ module Strata
               #{column_list}#{context_section}
 
               Based on the user's request, regenerate or modify the field definitions.
-              Return JSON array with objects containing: name, description, schema_type, data_type, expression
+              Return JSON array with objects containing: name, description, schema_type, data_type, expression, synonyms
             PROMPT
           end
 
@@ -207,7 +210,8 @@ module Strata
                 description: "",
                 schema_type: is_measure ? "measure" : "dimension",
                 data_type: map_data_type(type),
-                expression: is_measure ? "sum(#{name})" : name
+                expression: is_measure ? "sum(#{name})" : name,
+                synonyms: []
               }
             end
           end

data/lib/strata/cli/configuration.rb

@@ -6,10 +6,9 @@ module Strata
       STRATA_CONFIG_FILE = ".strata"
       PROJECT_CONFIG_FILE = "project.yml"
 
-      # Default configuration
       DEFAULT = {
         "api_key" => "",
-        "server" => "http://localhost:3030",
+        "server" => "",
         "log_level" => "info"
       }.freeze
 

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

@@ -108,6 +108,11 @@ module Strata
               "data_type" => normalized[:data_type]
             }
 
+            synonyms = normalized[:synonyms]
+            if synonyms.is_a?(Array) && !synonyms.empty?
+              field_hash["synonyms"] = synonyms
+            end
+
             # Build expression with proper nested format
             expr = normalized[:expression]
             field_hash["expression"] = {

data/lib/strata/cli/generators/templates/table.table_name.yml

@@ -96,6 +96,12 @@ fields:
   #     array: true|false  (optional)
   #     sql: my_field_column (Required)
   #
+  #   # Optional: Alternative names for this field. Helps AI and search
+  #   # find this field when users refer to it by different names.
+  #   synonyms:
+  #     - alt name one
+  #     - alt name two
+  #
   #   # Optional: Exclude certain dimnesions from the group by/filter
   #   exclusion_type: exclude|exclude_all_except|exclude_all
   #   exclusions: # (Required when exclusion type is set and isnt exclude_all)

data/lib/strata/cli/helpers/datasource_helper.rb

@@ -42,9 +42,26 @@ module Strata
         config = ds_config(ds_key).merge(Credentials.fetch(ds_key))
         adapter_sym = config["adapter"].to_sym
         ensure_adapter_driver_gems!(adapter_sym)
+
+        # CLI only performs read operations (test, tables, metadata).
+        # Use read-only mode for file-based databases to avoid lock conflicts.
+        apply_readonly_mode(adapter_sym, config)
+
         DWH.create(adapter_sym, config)
       end
 
+      def apply_readonly_mode(adapter_sym, config)
+        case adapter_sym
+        when :duckdb
+          config["duck_config"] ||= {}
+          config["duck_config"]["access_mode"] = "READ_ONLY"
+        when :sqlite
+          config["readonly"] = true
+        end
+        # Client-server databases (postgres, mysql, snowflake, etc.)
+        # don't need special handling - no file lock issues
+      end
+
       def ensure_adapter_driver_gems!(adapter_sym)
         required = ADAPTER_DRIVER_GEMS.fetch(adapter_sym, [])
         return if required.empty?

data/lib/strata/cli/helpers/project_helper.rb

@@ -46,6 +46,34 @@ module Strata
           end
         end
 
+        # Persists server URL to project.yml (updates existing or appends)
+        def persist_server_to_project_yml(server, project_yml_path: "project.yml")
+          return false unless server && !server.to_s.strip.empty?
+          return false unless File.exist?(project_yml_path)
+
+          project_yml_content = File.read(project_yml_path)
+
+          begin
+            if /^server:\s*.+$/m.match?(project_yml_content)
+              updated_content = project_yml_content.gsub(/^(\s*)server:\s*.+$/, "\\1server: #{server}")
+              File.write(project_yml_path, updated_content)
+            else
+              File.open(project_yml_path, "a") do |f|
+                f.puts "\n" unless project_yml_content.end_with?("\n")
+                f.puts "server: #{server}"
+              end
+            end
+
+            true
+          rescue Errno::EACCES => e
+            raise Strata::CommandError, "Permission denied writing to #{project_yml_path}: #{e.message}"
+          rescue Errno::ENOSPC => e
+            raise Strata::CommandError, "Disk full: #{e.message}"
+          rescue => e
+            raise Strata::CommandError, "Failed to write to #{project_yml_path}: #{e.message}"
+          end
+        end
+
         # Persists git URL to project.yml file if missing
         def persist_git_url_if_missing(project_yml_path: "project.yml")
           return false unless File.exist?(project_yml_path)

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

@@ -1,6 +1,7 @@
 require_relative "../guard"
 require_relative "../credentials"
 require_relative "../terminal"
+require_relative "../utils/git"
 require "tty-prompt"
 require_relative "../helpers/datasource_helper"
 require_relative "../helpers/description_helper"
@@ -369,6 +370,8 @@ module Strata
           strata_file = Configuration::STRATA_CONFIG_FILE
           File.chmod(0o600, strata_file) if File.exist?(strata_file)
 
+          Utils::Git.commit_file(Configuration::STRATA_CONFIG_FILE, "[Strata-CLI] Add AI config to .strata", Dir.pwd) if Utils::Git.git_repo?
+
           say "\n✔ AI configured with #{provider}", :green
           say "  Note: API key is stored securely in .strata (not committed to repo)", :cyan
         end

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

@@ -122,7 +122,7 @@ module Strata
 
         def validate_deployment_configuration(config)
           ensure_api_key(config)
-          validate_server_url(config)
+          ensure_server(config)
           ensure_git_url_populated
           ensure_project_id(config)
         end
@@ -133,14 +133,36 @@ module Strata
           config["api_key"] = collect_api_key_interactively
         end
 
-        def validate_server_url(config)
-          server_url = config["server"]
-          return if server_url && !server_url.to_s.strip.empty?
+        def ensure_server(config)
+          return if config["server"] && !config["server"].to_s.strip.empty?
 
-          env_msg = options[:environment] ? " (or in '#{options[:environment]}' environment section)" : ""
-          say "\nServer URL not configured in project.yml#{env_msg}", :yellow
-          say "Please add or update the 'server' field in project.yml and try again.\n", :white
-          exit(1)
+          config["server"] = collect_server_interactively
+        end
+
+        def collect_server_interactively
+          prompt = TTY::Prompt.new
+
+          say "\nServer URL not found (not in project.yml)", :yellow
+          say "You can add it to project.yml or enter it now here\n", :cyan
+
+          server = prompt.ask("Enter Strata server URL:") do |q|
+            q.required true
+            q.validate(/\S+/, "Server URL cannot be empty")
+          end
+
+          server = server.strip.sub(%r{/\z}, "") # normalize: remove trailing slash
+
+          with_spinner("Saving server URL to project.yml") do
+            save_server_to_project_yml(server)
+          end
+
+          server
+        end
+
+        def save_server_to_project_yml(server)
+          Helpers::ProjectHelper.persist_server_to_project_yml(server, project_yml_path: File.join(project_path, Configuration::PROJECT_CONFIG_FILE))
+          CLI.config.reload!
+          Utils::Git.commit_file(Configuration::PROJECT_CONFIG_FILE, "[Strata-CLI] Add server URL to project.yml", project_path) if Utils::Git.git_repo?
         end
 
         def ensure_git_url_populated
@@ -182,37 +204,43 @@ module Strata
             save_api_key_to_strata(api_key)
           end
 
+          Utils::Git.commit_file(Configuration::STRATA_CONFIG_FILE, "[Strata-CLI] Save API key to .strata", project_path) if Utils::Git.git_repo?
+
           api_key
         end
 
         def save_api_key_to_strata(api_key)
+          save_key_to_strata("api_key", api_key)
+        end
+
+        def save_key_to_strata(key, value)
           strata_file = Configuration::STRATA_CONFIG_FILE
 
           # Read existing content if file exists
           existing_content = File.exist?(strata_file) ? File.read(strata_file) : ""
 
           begin
-            if /^api_key:\s*.+$/m.match?(existing_content)
-              updated_content = existing_content.gsub(/^(\s*)api_key:\s*.+$/, "\\1api_key: #{api_key}")
+            if /^#{Regexp.escape(key)}:\s*.+$/m.match?(existing_content)
+              updated_content = existing_content.gsub(/^(\s*)#{Regexp.escape(key)}:\s*.+$/, "\\1#{key}: #{value}")
               File.write(strata_file, updated_content)
             else
               File.open(strata_file, "a") do |f|
                 f.puts "\n" unless existing_content.empty? || existing_content.end_with?("\n")
-                f.puts "api_key: #{api_key}"
+                f.puts "#{key}: #{value}"
               end
             end
 
             # Set restrictive permissions (read/write for owner only)
             File.chmod(0o600, strata_file) if File.exist?(strata_file)
 
-            # Reload config to pick up the new API key
+            # Reload config to pick up the new value
             CLI.config.reload!
           rescue Errno::EACCES => e
             raise Strata::CommandError, "Permission denied writing to #{strata_file}: #{e.message}"
           rescue Errno::ENOSPC => e
             raise Strata::CommandError, "Disk full: #{e.message}"
           rescue => e
-            raise Strata::CommandError, "Failed to write API key to #{strata_file}: #{e.message}"
+            raise Strata::CommandError, "Failed to write #{key} to #{strata_file}: #{e.message}"
           end
         end
 
@@ -405,6 +433,7 @@ module Strata
           with_spinner("Persisting project ID to project.yml") do
             Helpers::ProjectHelper.persist_project_id_to_yml(project_id)
           end
+          Utils::Git.commit_file(Configuration::PROJECT_CONFIG_FILE, "[Strata-CLI] Persist project ID to project.yml", project_path) if Utils::Git.git_repo?
         end
 
         def refresh_external_imports

data/lib/strata/cli/ui/field_editor.rb

@@ -143,6 +143,10 @@ module Strata
           return if field[:expression] == "back"
 
           field[:schema_type] = prompt.select("  Type:", %w[dimension measure], default: field[:schema_type])
+
+          current_synonyms = (field[:synonyms] || []).join(", ")
+          synonyms_input = prompt.ask("  Synonyms (comma-separated):", default: current_synonyms)
+          field[:synonyms] = synonyms_input.to_s.split(",").map(&:strip).reject(&:empty?)
         rescue TTY::Reader::InputInterrupt
           # User pressed Ctrl+C, go back without saving
           nil

data/lib/strata/cli/utils/deployment_monitor.rb

@@ -127,7 +127,7 @@ module Strata
         rescue Interrupt
           stop_all_spinners
           say "\n\n  Monitoring interrupted. Deployment continues in background.", ColorHelper.warning
-          say "   Check server for deployment status.\n", ColorHelper.info
+          say "  Check server for deployment status with command `strata deploy status`.\n", ColorHelper.info
           nil
         rescue => e
           stop_all_spinners

data/lib/strata/cli/version.rb

@@ -2,6 +2,6 @@
 
 module Strata
   module CLI
-    VERSION = "0.1.3.beta"
+    VERSION = "0.1.4.beta"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: strata-cli
 version: !ruby/object:Gem::Version
-  version: 0.1.3.beta
+  version: 0.1.4.beta
 platform: ruby
 authors:
 - Ajo Abraham
@@ -330,7 +330,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.6.7
 specification_version: 4
 summary: Command-line interface for the Strata Semantic Analytics System
 test_files: []