feat: limit number of function sources based on usage tier (#666)

<img width="943" height="201" alt="CleanShot 2025-10-23 at 14 55 21@2x"
src="https://github.com/user-attachments/assets/56f4bdae-6d37-4fbe-a910-daaa2e13f4df"
/>

<img width="2398" height="574" alt="CleanShot 2025-10-24 at 11 38 57@2x"
src="https://github.com/user-attachments/assets/d0e8237b-0250-42b4-b93c-769807e16650"
/>

Author: chase-crumbaugh

.gitignore

@@ -34,4 +34,5 @@ gram.code-workspace
 dist/
 **/.claude/settings.local.json
 .vercel
-cover.*
+cover.*
+*gram.deploy.json

cli/README.md

@@ -0,0 +1,22 @@
+# Gram CLI
+
+## Local Development
+
+1. Setup environment
+   - `export GRAM_API_URL=https://localhost:8080`
+   - `export GRAM_ORG=organization-123`
+   - `export GRAM_PROJECT=default`
+   - `export GRAM_API_KEY=<API-KEY>`
+
+2. Run desired command
+   - `cd cli`
+   - `go run main.go status`
+
+### Testing Gram Functions
+
+1. Stage zip
+   - `go run main.go stage function --slug test-fn --location fixtures/example.zip`
+   - _You never need to do this again as long as you are using the same zip_
+
+2. Push
+   - `go run main.go push`

cli/fixtures/example.zip

@@ -62,7 +62,7 @@ func (c *AssetsClient) UploadOpenAPIv3(
 
 	result, err := c.client.UploadOpenAPIv3(ctx, payload, req.Reader)
 	if err != nil {
-		return nil, fmt.Errorf("failed to upload OpenAPI asset: %w", err)
+		return nil, fmt.Errorf("failed to upload OpenAPI source: %w", err)
 	}
 
 	return result.Asset, nil
@@ -82,7 +82,7 @@ func (c *AssetsClient) UploadFunctions(
 
 	result, err := c.client.UploadFunctions(ctx, payload, req.Reader)
 	if err != nil {
-		return nil, fmt.Errorf("failed to upload OpenAPI asset: %w", err)
+		return nil, fmt.Errorf("failed to upload Functions source: %w", err)
 	}
 
 	return result.Asset, nil

cli/internal/api/assets.go

@@ -38,6 +38,7 @@ func newApp() *cli.App {
 			flags.APIKey(),
 			flags.APIEndpoint(),
 			flags.Project(),
+			flags.Org(),
 			&cli.StringFlag{
 				Name:    "log-level",
 				Value:   "info",

cli/internal/app/app.go

@@ -44,6 +44,7 @@ NOTE: Names and slugs must be unique across all sources.`[1:],
 			flags.APIEndpoint(),
 			flags.APIKey(),
 			flags.Project(),
+			flags.Org(),
 			&cli.PathFlag{
 				Name:     "config",
 				Usage:    "Path to the deployment file",
@@ -142,13 +143,15 @@ NOTE: Names and slugs must be unique across all sources.`[1:],
 			slogID := slog.String("deployment_id", result.Deployment.ID)
 			status := result.Deployment.Status
 
+			deploymentLogsURL := fmt.Sprintf("https://localhost:5173/%s/%s/deployments/%s", workflowParams.OrgSlug, workflowParams.ProjectSlug, result.Deployment.ID)
+
 			switch status {
 			case "completed":
-				logger.InfoContext(ctx, "Deployment succeeded", slogID)
+				logger.InfoContext(ctx, "Deployment succeeded", slogID, slog.String("logs_url", deploymentLogsURL))
 				return nil
 			case "failed":
 				logger.ErrorContext(ctx, "Deployment failed", slogID)
-				return fmt.Errorf("deployment failed")
+				return fmt.Errorf("Deployment failed. Check the deployment logs for more information: %s", deploymentLogsURL)
 			default:
 				logger.InfoContext(
 					ctx,

cli/internal/app/push.go

@@ -27,6 +27,7 @@ If no deployment ID is provided, shows the status of the latest deployment.`,
 			flags.APIEndpoint(),
 			flags.APIKey(),
 			flags.Project(),
+			flags.Org(),
 			&cli.StringFlag{
 				Name:  "id",
 				Usage: "The deployment ID to check status for (if not provided, shows latest deployment)",

cli/internal/app/status.go

@@ -29,6 +29,7 @@ Example:
 			flags.APIEndpoint(),
 			flags.APIKey(),
 			flags.Project(),
+			flags.Org(),
 			&cli.StringFlag{
 				Name:     "type",
 				Usage:    fmt.Sprintf("The type of asset to upload: %+v", deploy.AllowedTypes),

cli/internal/app/upload.go

@@ -21,10 +21,18 @@ func APIEndpoint() *cli.StringFlag {
 	}
 }
 
+func Org() *cli.StringFlag {
+	return &cli.StringFlag{
+		Name:    "org",
+		Usage:   "The target Gram organization (slug)",
+		EnvVars: []string{"GRAM_ORG"},
+	}
+}
+
 func Project() *cli.StringFlag {
 	return &cli.StringFlag{
 		Name:    "project",
-		Usage:   "The target Gram project",
+		Usage:   "The target Gram project (slug)",
 		EnvVars: []string{"GRAM_PROJECT"},
 	}
 }

cli/internal/flags/flags.go

@@ -30,6 +30,11 @@ func ResolveParams(
 		return Params{}, fmt.Errorf("api-key required: not found in --api-key flag, $GRAM_API_KEY environment variable, or profile")
 	}
 
+	orgSlug := ResolveOrgSlug(c, prof)
+	if orgSlug == "" {
+		return Params{}, fmt.Errorf("organization required: not found in --org flag, $GRAM_ORG environment variable, or profile")
+	}
+
 	projectSlug := ResolveProject(c, prof)
 	if projectSlug == "" {
 		return Params{}, fmt.Errorf("project required: not found in --project flag, $GRAM_PROJECT environment variable, or profile")
@@ -43,6 +48,7 @@ func ResolveParams(
 	return Params{
 		APIKey:      apiKey,
 		APIURL:      apiURL,
+		OrgSlug:     orgSlug,
 		ProjectSlug: projectSlug,
 	}, nil
 }
@@ -59,6 +65,18 @@ func ResolveKey(c *cli.Context, prof *profile.Profile) secret.Secret {
 	return secret.Secret("")
 }
 
+func ResolveOrgSlug(c *cli.Context, prof *profile.Profile) string {
+	if c.IsSet("org") {
+		return c.String("org")
+	}
+
+	if prof != nil && prof.Org != nil {
+		return prof.Org.Slug
+	}
+
+	return ""
+}
+
 func ResolveProject(c *cli.Context, prof *profile.Profile) string {
 	if c.IsSet("project") {
 		return c.String("project")