strata-cli 0.1.15 → 0.1.16

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6965d8ee9c44a37f7de1a11c0d2654d05c44aa352f38442456e77814deb411e1
-  data.tar.gz: af24ef90657a2c2d32d6493d00b1b40eab52a290c3f3c2c35fb69bf73cc7c448
+  metadata.gz: b01b5f82ca969d2d8e586722e10a438fefcc97e02107442d66d8de52bad55656
+  data.tar.gz: 8acfb5ff8b4ddd7aacb7de62f1f4f8758cb9b2004660422fcc2f3ee298bd46f6
 SHA512:
-  metadata.gz: b9d03dcd92e8364ef2c5e3558c1f1e049227c394b36f75148f4f08e4d4b62ca9ddd3c11bd9e636c5c7324bba43e9d40f8ba554b7d4436fcb1ad4a07af3c001ee
-  data.tar.gz: 455a627b5dfebd40b48f45ec70ea362438ed0c526db7c69941685987aea3a3fed10cf2c4a3b4fcaba33620e11dbda90540ce1c54de814bc74c10fac2cef36d98
+  metadata.gz: 7ce832a4ccb100cb4835ef212c67ee19ba207f51a33a8d36bc884102379827eb59b93f97cf9028a2dc742071a95006a8e361c840a6066c29dde3d01525240772
+  data.tar.gz: f7ce4fe653e46d6ccaf2b5945a08bcd866a0dc2bb3c43880e3facfca746c4f913750a04de1f7a5b51fe43c7c514f228d38bde62fc79d1013379cddeee194457c

data/CHANGELOG.md

@@ -1,5 +1,25 @@
 ## [Unreleased]
 
+## [0.1.16] - 2026-09-05
+
+### Added
+
+- **Local semantic audit**: `strata audit` now mirrors the server's deploy-time validations locally — SQL expression parsing (dimensions must reference a table column, measures need an aggregation function), cross-file `[Field]@d`/`@m` reference resolution, required field types and enum checks, table snapshot and partition rules, relationship join validation, and datasource adapter checks — so deploys fail fast with named errors instead of failing on the server.
+- **Browser sign-in for deploy**: `strata deploy` now offers the browser-based auth flow when it needs an API key, with manual paste kept as a fallback.
+- **Next steps guidance**: `strata init` and `strata datasource add` now print how to build the model next — manually with `strata create table` or via a coding agent — then audit and deploy.
+- **Initial commit on init**: `strata init` commits the generated files (skipped when the repo already has history).
+
+### Changed
+
+- **Agent mode auto-detection**: non-tty stdin now implies `--agent`, so agents get JSON output without discovering the flag. Prompts in agent mode emit an `interactive_required` JSON error and exit 1 instead of rendering an unanswerable TUI.
+- **Deploy pre-checks**: the uncommitted-changes check now runs before any prompts, server calls, or audit.
+- **AGENTS.md**: now allowlists which files agents may write (`models/**/*.yml`, `migrations/*.yml`, `tests/*.yml`) and points them to `strata datasource meta|exec --agent` instead of scratch scripts. `strata audit all` warns about stray non-YAML files under `models/` and scripts at the project root.
+
+### Fixed
+
+- **Deploy rename detection**: the no-baseline fallback now includes all tracked YAML files (previously diffed only `HEAD~1`, dropping earlier renames), `--find-renames` is passed explicitly so rename records don't depend on local git config, and invalid baselines warn instead of silently degrading to a partial deploy.
+- **Audit cardinality**: `many_to_many` is now rejected locally — the server enum rejects it with a crash.
+
 ## [0.1.15] - 2026-07-27
 
 ### Added

data/lib/strata/cli/agent_mode.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require "tty-prompt"
 require_relative "agent_output"
 
 module Strata
@@ -10,10 +11,31 @@ module Strata
           desc: "Agent mode: structured output, no interactive prompts"
       end
 
+      # Implied when stdin is not a terminal. tty-prompt does not fail there --
+      # it redraws its menu forever on EOF -- so callers that cannot answer a
+      # prompt must be treated as agents whether or not they passed --agent.
       def agent_mode?
         value = options[:agent]
         value = options["agent"] if value.nil?
-        value == true
+        value == true || !interactive?
+      end
+
+      def interactive?
+        $stdin.tty?
+      end
+
+      # Every interactive prompt goes through here so a non-interactive caller
+      # gets a JSON error it can read instead of a TUI it cannot answer.
+      def prompt
+        unless interactive?
+          AgentOutput.emit_error(
+            "This command needs an interactive terminal. Pass the required arguments, " \
+            "use --agent for structured output, or ask the user to run it.",
+            code: "interactive_required"
+          )
+        end
+
+        @prompt ||= TTY::Prompt.new
       end
 
       def reject_agent_mode!(message, code: "agent_mode_unsupported")

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

@@ -1,5 +1,9 @@
 Initialize a new Strata project or clone from an existing repository.
 
+Creates an AGENTS.md in the project so a coding agent (Claude Code, Codex, Cursor)
+can build the semantic model for you:
+https://strata.do/developer-docs/developer-guide/cli/building-your-model
+
 PROJECT_NAME is optional when using --source option. If provided, creates a new project
 with that name. If using --source, clones the existing project from the URL.
 

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

@@ -6,6 +6,8 @@ require_relative "../helpers/project_helper"
 require_relative "../api/connection_error_handler"
 require_relative "../api/response_error_handler"
 require_relative "../output"
+require_relative "../utils/git"
+require_relative "../helpers/prompts"
 require "faraday"
 require "json"
 require "uri"
@@ -126,7 +128,22 @@ module Strata
           # Change into the project directory and run the existing add command
           inside(uid) do
             require_relative "../sub_commands/datasource"
-            SubCommands::Datasource.new.add
+            # from_init: the datasource command skips its own next-steps block,
+            # completion_message prints one for the whole init instead.
+            SubCommands::Datasource.new([], {"from_init" => true}).add
+          end
+        end
+
+        def initial_commit
+          return if cloned_from_git?
+
+          inside uid do
+            case Utils::Git.initial_commit("chore: initialize Strata project")
+            when :committed
+              print_status(:created, "Initial git commit", type: :success)
+            when :failed
+              print_info("\n  Could not create the initial commit — set git user.name and user.email, then commit yourself.")
+            end
           end
         end
 
@@ -134,9 +151,8 @@ module Strata
           Output.print_success("\n✔ Strata project '#{uid}' is ready!", context: self)
           Output.print_warning("\nNext steps:", context: self)
           Output.print_info("  1. cd #{uid}", context: self)
-          Output.print_info("  2. strata datasource add      # To add more datasources", context: self)
-          Output.print_info("  3. strata create table      # Start adding tables", context: self)
-          Output.print_info("\n", context: self)
+          Output.print_info("  2. strata datasource add   # add more datasources", context: self)
+          Output.print_info("\n#{Prompts.build_model_next_steps(uid)}", context: self)
         end
 
         private

data/lib/strata/cli/generators/templates/AGENTS.md

@@ -93,6 +93,10 @@ Follow this sequence. Do not skip steps or reorder deploy before audit.
 
 **Agents must not run:** `strata deploy`, `strata datasource add`, interactive `strata create table` / `strata create relation` / `strata create migration`, or writing secrets into `.strata`.
 
+**Agents may create or edit only:** `models/**/*.yml`, `migrations/*.yml`, `tests/*.yml`.
+
+**Do not create any other file** — no `.rb` / `.py` / `.sh` scripts, notebooks, READMEs, or scratch validators. To inspect the warehouse use `strata datasource tables|meta|exec --agent`; to check your work use `strata audit all --agent`. `strata audit` warns about stray files. If you think a script is genuinely needed, stop and ask the user.
+
 **Branches:** Model on feature branches; deploy to the matching Strata server branch for staging. Production deploys typically use `production_branch` in `project.yml` (default `main`). Renames and swaps that affect production query names should happen on the production branch — see [Renames and swaps](#renames-swaps-and-production-branch).
 
 ## How the semantic layer maps to the warehouse

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

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "json"
+require "securerandom"
+require "rbconfig"
+
+module Strata
+  module CLI
+    module Helpers
+      # Browser-based sign-in: opens the server's CLI auth page and polls
+      # until the server hands back an API key for our one-time state token.
+      module BrowserAuth
+        AUTH_TIMEOUT_SECONDS = 300
+
+        def fetch_api_key_via_browser(server)
+          state = SecureRandom.hex(16)
+          auth_url = "#{server}/cli/auth?state=#{state}"
+          poll_url = "#{server}/api/v1/cli/auth/#{state}"
+
+          say "\nOpening your browser to sign in to Strata...", :cyan
+          open_browser(auth_url)
+          say "Waiting for authentication (you may close the browser tab once done)", :white
+
+          deadline = Time.now + AUTH_TIMEOUT_SECONDS
+          loop do
+            raise Strata::CommandError, "Authentication timed out. Please try again." if Time.now > deadline
+
+            begin
+              response = Net::HTTP.get_response(URI(poll_url))
+              return JSON.parse(response.body)["api_key"] if response.code == "200"
+            rescue Errno::ECONNREFUSED
+              raise Strata::CommandError, "Cannot reach server at #{server}. Is it running?"
+            end
+
+            print "."
+            $stdout.flush
+            sleep 1
+          end
+        end
+
+        def open_browser(url)
+          case RbConfig::CONFIG["host_os"]
+          when /darwin/ then system("open", url)
+          when /linux/ then system("xdg-open", url)
+          when /mswin|mingw/ then system("start", "", url)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -17,12 +17,8 @@ module Strata
           @adapter ||= create_adapter(datasource_key)
         end
 
-        def prompt
-          @prompt ||= TTY::Prompt.new
-        end
-
         def datasource_key
-          @datasource_key ||= resolve_datasource(prompt: prompt)
+          @datasource_key ||= resolve_datasource
         end
 
         def table_fetch_result

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

@@ -16,7 +16,7 @@ module Strata
         duckdb: %w[duckdb]
       }.freeze
 
-      def resolve_datasource(ds_key_arg = nil, prompt: TTY::Prompt.new)
+      def resolve_datasource(ds_key_arg = nil)
         # 1. Use argument if provided
         return validate_datasource(ds_key_arg) if ds_key_arg
 

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

@@ -3,6 +3,27 @@
 module Strata
   module CLI
     module Prompts
+      # Docs. This URL is printed by the CLI and baked into every shipped gem —
+      # strata-docs has no redirects plugin, so renaming that page 404s old binaries.
+      DOCS_BUILD_MODEL_URL = "https://strata.do/developer-docs/developer-guide/cli/building-your-model"
+
+      # Shown after 'strata init' and 'strata datasource add'. %s is the agent hint.
+      MSG_AGENTS_MD_PRESENT = "AGENTS.md in this project tells it Strata's rules."
+      MSG_AGENTS_MD_MISSING = "See the guide below for what to tell it."
+      MSG_BUILD_MODEL_NEXT_STEPS = <<~STEPS
+        Build your semantic model — two ways:
+
+          • One table at a time:  strata create table PATH/TABLE_NAME
+          • All at once:          open this project in a coding agent (Claude Code,
+                                  Codex, Cursor) and ask it to build the semantic
+                                  model. %s
+
+        Then: strata audit all   # validate
+              strata deploy      # publish
+
+        Guide: #{DOCS_BUILD_MODEL_URL}
+      STEPS
+
       # Relation Command Prompts
       MSG_SELECT_LEFT_TABLE = "Select LEFT table (the 'many' side usually):"
       MSG_SELECT_RIGHT_TABLE_ALL = "Select RIGHT table (All):"
@@ -54,6 +75,12 @@ module Strata
       def default_migration_hook(operation)
         (operation == "swap") ? "post (after deployment)" : "pre (before deployment)"
       end
+
+      # dir is the project root — 'strata init --source' clones repos without an AGENTS.md.
+      def build_model_next_steps(dir = ".")
+        hint = File.exist?(File.join(dir, "AGENTS.md")) ? MSG_AGENTS_MD_PRESENT : MSG_AGENTS_MD_MISSING
+        format(MSG_BUILD_MODEL_NEXT_STEPS, hint)
+      end
     end
   end
 end