strata-cli 0.1.14 → 0.1.16

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7b0fdc6cf6a28080152c9b0237d54e206740477d196178a2e6d5aa5642720135
-  data.tar.gz: d049c71dd05982f8a52b786ae59ffdf590056dc3bdb5cadd7045227dbe9de867
+  metadata.gz: b01b5f82ca969d2d8e586722e10a438fefcc97e02107442d66d8de52bad55656
+  data.tar.gz: 8acfb5ff8b4ddd7aacb7de62f1f4f8758cb9b2004660422fcc2f3ee298bd46f6
 SHA512:
-  metadata.gz: f7c7aa4945d149bff16578ca52f99a005b3c9d4c3b5897b52929bf9bfffb140883457f60d52552fa551faee5ef6d0472069c368125653bf784078378a7065dbe
-  data.tar.gz: 48a81467d16e8b489bdce4f177dd1b158ac09344c07d1944d804a679afc0ed47e52047b6a478781ba245c291a4d9bb8512f8159b1d09ecf41e1f537b5873e52b
+  metadata.gz: 7ce832a4ccb100cb4835ef212c67ee19ba207f51a33a8d36bc884102379827eb59b93f97cf9028a2dc742071a95006a8e361c840a6066c29dde3d01525240772
+  data.tar.gz: f7ce4fe653e46d6ccaf2b5945a08bcd866a0dc2bb3c43880e3facfca746c4f913750a04de1f7a5b51fe43c7c514f228d38bde62fc79d1013379cddeee194457c

data/CHANGELOG.md

@@ -1,5 +1,43 @@
 ## [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
+
+- **Sample project command**: `strata project sample` now uses a browser-based auth flow — opens the Strata sign-in page, waits for authentication, and writes the API key to `.strata` automatically. No flags required.
+- **CLI auth endpoints**: New server endpoints (`/cli/auth` and `/api/v1/cli/auth/:state`) support the browser-based API key retrieval flow.
+
+### Changed
+
+- **Repo rename**: Sample project now clones `tpc-ds-retail-sample` (previously `strata-tutorial-project`).
+- **Sample project setup**: Server URL is prompted interactively with `http://localhost:8080` as default. `--api-key` and `--server` flags retained as optional overrides for scripting.
+- **Audit — tutorial project**: Connection check now silently passes for the `tpc-ds-retail-sample` project (datasource lives in the Strata Docker container, not locally). All other audit checks run normally.
+- **Project template**: `project.yml` no longer assumes `http://localhost:8080` as the default server — prompted at first deploy instead.
+
+### Fixed
+
+- **Deploy — manual commit hash**: Deployments previously triggered via the web UI stored a `manual-<timestamp>` commit reference. The CLI now treats these as non-git baselines and falls back to a full deploy instead of erroring.
+
 ## [0.1.14] - 2026-07-17
 
 ### Added

data/README.md

@@ -308,18 +308,27 @@ project_id: 123  # Auto-populated after first deployment
 
 **Multi-Environment Configuration:**
 
+`project.yml` — server URL per environment (safe to commit):
 ```yaml
-# Default environment
-server: http://localhost:3000
+# Default environment (set on first deploy if omitted)
+server: https://dev.strata.example.com
 
-# Environment-specific configs
 staging:
   server: https://staging.strata.com
-  api_key: staging-key
 
 production:
   server: https://app.strata.com
-  api_key: prod-key
+```
+
+`.strata` — API keys per environment (**never committed**):
+```yaml
+api_key: your-default-api-key
+
+staging:
+  api_key: your-staging-api-key
+
+production:
+  api_key: your-production-api-key
 ```
 
 ### Local Configuration (`.strata`)
@@ -436,7 +445,7 @@ Ensure you have write permissions in the project directory. The `.strata` file p
 
 ### "Server URL not configured"
 
-Add the `server` field to your `project.yml`:
+Run `strata deploy` — you will be prompted to enter the server URL, which is then saved to `project.yml` automatically for future deploys. Or add it manually:
 
 ```yaml
 server: https://your-strata-server.com

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"
@@ -17,8 +19,6 @@ module Strata
         include API::ConnectionErrorHandler
         include API::ResponseErrorHandler
 
-        BASE_SERVER_URL = "http://localhost:3000"
-
         argument :name, type: :string, required: false, desc: "The name of the project. Optional when using --source."
         class_option :datasource, type: :string, repeatable: true
         class_option :source, type: :string
@@ -128,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
 
@@ -136,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
@@ -205,12 +219,6 @@ module Strata
           @name
         end
 
-        def server_url
-          return options[:source] if options.key?(:source)
-
-          BASE_SERVER_URL
-        end
-
         def description
           return @project_info["description"] if options.key?(:source) && @project_info
 

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/generators/templates/project.yml

@@ -10,14 +10,14 @@ uid: <%= uid %>
 description: Your projects description
 
 # Target Strata server (default environment, typically dev)
-server: <%= options[:source] || "http://localhost:3000" %>
+server: <%= options[:source] %>
 
 # Alternatively, you can configure multiple environments (different Strata server instances).
 # Each environment represents a separate Strata cluster (dev, staging, production).
 # Use -e [ENVIRONMENT] flag when deploying to select the environment.
 # Example:
 # dev:
-#   server: http://localhost:3000
+#   server: http://localhost:8080
 # prod:
 #   server: https://app.strata.com
 

data/lib/strata/cli/guard.rb

@@ -14,6 +14,8 @@ module Strata
         version
         deploy
         branch
+        project
+        sample
       ].freeze
 
       def invoke_command(command, *args)

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