Local Development

## After installing mise, this should restore all of the tooling required for local development.
mise install

# Confirm version
dotnet --version # 10.0.302

# Restore all tools
dotnet tool restore

cd src/backend/Zeeq.Runtime.Server

# Non-secret settings are in  appsettings.Development.json

# Initialize the secrets store
dotnet user-secrets init

# Add secrets to the store (see: src/backend/Zeeq.Runtime.Server/appsettings.Development.json)

# (✅  REQUIRED: Needed to generate embeddings for the search)
# The API key to use for generating embeddings (always needed since there is no UI for this)
# The default embedding provider is Fireworks using qwen3-embedding-8b; this can be changed in appsettings.Development.json to use OpenAI or other providers.
dotnet user-secrets set AppSettings:Llm:Embeddings:ApiKey secret-value

# (☑️  OPTIONAL: Required or use in-app managed keys; code reviews will not work without this)
# The API key to use with the default "fast" LLM tier model.
# Not needed if using in-app configured self-managed services.
dotnet user-secrets set AppSettings:Llm:Models:Fast:ApiKey secret-value

# (☑️  OPTIONAL: Only needed for testing signed imports)
# The signing key used for importable Zeeq library export packages
dotnet user-secrets set AppSettings:Documents:LibraryExportSigningKey "$(openssl rand -base64 48 | tr -d '\n')"

# (☑️  OPTIONAL: Only needed for GH integration testing locally)
# The DEV GitHub app webhook secret (other configuration directly in file)
# This is needed to test GitHub webhook flows locally since the GH app only has one webhook URL
# Alternate: configure custom webhooks: https://github.com/zeeq-ai/zeeq-app/settings/hooks
dotnet user-secrets set AppSettings:GitHub:WebhookSecret secret-value

# (☑️  OPTIONAL: Only needed for GH integration testing locally)
# The DEV GitHub app private key PEM for local testing
dotnet user-secrets set AppSettings:GitHub:PrivateKeyPem secret-value

# (☑️  OPTIONAL: Use the mock OAuth provider without need to hook up Google or GH OAuth)
# The client secrets for OAuth providers (e.g. GitHub, Google, etc.) used for user login
# Order matches appsettings.Development.json
dotnet user-secrets set AppSettings:Auth:Providers:0:ClientSecret secret-value # Google
dotnet user-secrets set AppSettings:Auth:Providers:1:ClientSecret secret-value # GitHub

# (☑️  OPTIONAL: Use only for access to the system platform management panel)
# The account identifiers prefixed with the provider that designate system level admins
# The user will need to have an account first locally (or you already know the subject ID)
dotnet user-secrets set AppSettings:Platform:SystemAdminSubjects:0 secret-value

{
  "AppSettings": {
    "Llm": {
      "Embeddings": {
        "Enabled": true,
        "ApiKey": "dotnet user-secrets set --project src/backend/Zeeq.Runtime.Server AppSettings:Llm:Embeddings:ApiKey secret-value",
        "Endpoint": "https://api.fireworks.ai/inference/v1",
        "model": "accounts/fireworks/models/qwen3-embedding-8b"
      }
    }
  }
}

# Smoke test
dotnet --version. # 10.0.302

# Start aspire which will start the stack
aspire run --detach --non-interactive

# To stop the stack since it is detached in the background
aspire stop

127.0.0.1       zeeq-web.localhost
127.0.0.1       zeeq-api.localhost
127.0.0.1       zeeq-docs.localhost
127.0.0.1       zeeq-inspector.localhost

# Rebuild and restart the resource.
aspire resource zeeq-server --rebuild

dotnet build && dotnet test --no-restore --no-build