@malloy-publisher/app 0.0.195 → 0.0.196

package/dist/api-doc.yaml

@@ -8,7 +8,7 @@ info:
 
     ## Key Features
 
-    - **Project Management**: Create and manage projects with their associated packages and connections
+    - **Environment Management**: Create and manage environments with their associated packages and connections
     - **Package Lifecycle**: Full CRUD operations for Malloy packages and their versions
     - **Model & Notebook Access**: Retrieve and execute Malloy models and notebooks
     - **Connection Management**: Secure database connection configuration and testing
@@ -19,7 +19,7 @@ info:
 
     The API follows a hierarchical resource structure:
     ```
-    Projects
+    Environments
     ├── Connections
     └── Packages
         ├── Models
@@ -37,9 +37,9 @@ servers:
 tags:
   - name: publisher
     description: Publisher status and health check operations
-  - name: projects
-    description: Project lifecycle management including creation, configuration, and
-      deletion of data modeling projects
+  - name: environments
+    description: Environment lifecycle management including creation, configuration,
+      and deletion of data modeling environments
   - name: connections
     description: Database connection management for secure data source configuration
       and access
@@ -68,7 +68,7 @@ paths:
       summary: Get server status and health information
       description: |
         Returns the current status of the Malloy Publisher server, including initialization state,
-        available projects, and server timestamp. This endpoint is useful for health checks and
+        available environments, and server timestamp. This endpoint is useful for health checks and
         monitoring server availability.
       responses:
         "200":
@@ -79,26 +79,25 @@ paths:
                 $ref: "#/components/schemas/ServerStatus"
         "503":
           $ref: "#/components/responses/ServiceUnavailable"
-
-  /projects:
+  /environments:
     get:
       tags:
-        - projects
-      operationId: list-projects
-      summary: List all available projects
+        - environments
+      operationId: list-environments
+      summary: List all available environments
       description: |
-        Retrieves a list of all projects currently hosted on this Malloy Publisher server.
-        Each project contains metadata about its packages, connections, and configuration.
-        This endpoint is typically used to discover available projects and their basic information.
+        Retrieves a list of all environments currently hosted on this Malloy Publisher server.
+        Each environment contains metadata about its packages, connections, and configuration.
+        This endpoint is typically used to discover available environments and their basic information.
       responses:
         "200":
-          description: A list of all available projects
+          description: A list of all available environments
           content:
             application/json:
               schema:
                 type: array
                 items:
-                  $ref: "#/components/schemas/Project"
+                  $ref: "#/components/schemas/Environment"
         "401":
           $ref: "#/components/responses/Unauthorized"
         "500":
@@ -107,26 +106,26 @@ paths:
           $ref: "#/components/responses/ServiceUnavailable"
     post:
       tags:
-        - projects
-      operationId: create-project
-      summary: Create a new project
+        - environments
+      operationId: create-environment
+      summary: Create a new environment
       description: |
-        Creates a new Malloy project with the specified configuration. A project serves as a
-        container for packages, connections, and other resources. The project will be initialized
+        Creates a new Malloy environment with the specified configuration. An environment serves as a
+        container for packages, connections, and other resources. The environment will be initialized
         with the provided metadata and can immediately accept packages and connections.
       requestBody:
         required: true
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/Project"
+              $ref: "#/components/schemas/Environment"
       responses:
         "200":
-          description: Returns the project created
+          description: Returns the environment created
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/Project"
+                $ref: "#/components/schemas/Environment"
         "401":
           $ref: "#/components/responses/Unauthorized"
         "500":
@@ -134,36 +133,36 @@ paths:
         "503":
           $ref: "#/components/responses/ServiceUnavailable"
 
-  /projects/{projectName}:
+  /environments/{environmentName}:
     get:
       tags:
-        - projects
-      operationId: get-project
-      summary: Get project details and metadata
+        - environments
+      operationId: get-environment
+      summary: Get environment details and metadata
       description: |
-        Retrieves detailed information about a specific project, including its packages,
+        Retrieves detailed information about a specific environment, including its packages,
         connections, configuration, and metadata. The reload parameter can be used to
-        refresh the project state from disk before returning the information.
+        refresh the environment state from disk before returning the information.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
         - name: reload
           in: query
-          description: Load / reload the project before returning result
+          description: Load / reload the environment before returning result
           required: false
           schema:
             type: boolean
       responses:
         "200":
-          description: Project details and metadata
+          description: Environment details and metadata
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/Project"
+                $ref: "#/components/schemas/Environment"
         "401":
           $ref: "#/components/responses/Unauthorized"
         "404":
@@ -174,17 +173,17 @@ paths:
           $ref: "#/components/responses/ServiceUnavailable"
     patch:
       tags:
-        - projects
-      operationId: update-project
-      summary: Update project configuration
+        - environments
+      operationId: update-environment
+      summary: Update environment configuration
       description: |
-        Updates the configuration and metadata of an existing project. This allows you to
-        modify project settings, update the README, change the location, or update other
-        project-level properties. The project must exist and be accessible.
+        Updates the configuration and metadata of an existing environment. This allows you to
+        modify environment settings, update the README, change the location, or update other
+        environment-level properties. The environment must exist and be accessible.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -193,14 +192,14 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/Project"
+              $ref: "#/components/schemas/Environment"
       responses:
         "200":
-          description: Returns the project updated
+          description: Returns the environment updated
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/Project"
+                $ref: "#/components/schemas/Environment"
         "401":
           $ref: "#/components/responses/Unauthorized"
         "500":
@@ -209,27 +208,27 @@ paths:
           $ref: "#/components/responses/ServiceUnavailable"
     delete:
       tags:
-        - projects
-      operationId: delete-project
-      summary: Delete a project
+        - environments
+      operationId: delete-environment
+      summary: Delete an environment
       description: |
-        Permanently deletes a project and all its associated resources including packages,
+        Permanently deletes an environment and all its associated resources including packages,
         connections, and metadata. This operation cannot be undone, so use with caution.
-        The project must exist and be accessible for deletion.
+        The environment must exist and be accessible for deletion.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
       responses:
         "200":
-          description: Returns the project deleted
+          description: Returns the environment deleted
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/Project"
+                $ref: "#/components/schemas/Environment"
         "401":
           $ref: "#/components/responses/Unauthorized"
         "404":
@@ -239,26 +238,26 @@ paths:
         "503":
           $ref: "#/components/responses/ServiceUnavailable"
 
-  /projects/{projectName}/connections:
+  /environments/{environmentName}/connections:
     get:
       tags:
         - connections
       operationId: list-connections
-      summary: List project database connections
+      summary: List environment database connections
       description: |
-        Retrieves a list of all database connections configured for the specified project.
+        Retrieves a list of all database connections configured for the specified environment.
         Each connection includes its configuration, type, and status information. This endpoint
-        is useful for discovering available data sources within a project.
+        is useful for discovering available data sources within an environment.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
       responses:
         "200":
-          description: A list of database connections in the project
+          description: A list of database connections in the environment
           content:
             application/json:
               schema:
@@ -272,20 +271,20 @@ paths:
         "503":
           $ref: "#/components/responses/ServiceUnavailable"
 
-  /projects/{projectName}/connections/{connectionName}:
+  /environments/{environmentName}/connections/{connectionName}:
     get:
       tags:
         - connections
       operationId: get-connection
       summary: Get connection details
       description: |
-        Retrieves detailed information about a specific database connection within a project.
+        Retrieves detailed information about a specific database connection within an environment.
         This includes connection configuration, credentials (if accessible), and metadata.
         Useful for inspecting connection settings and troubleshooting connectivity issues.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -316,11 +315,11 @@ paths:
       operationId: create-connection
       summary: Create a new database connection
       description: |
-        Creates a new database connection in the specified project.
+        Creates a new database connection in the specified environment.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -373,9 +372,9 @@ paths:
       description: |
         Updates the configuration of an existing database connection.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -436,11 +435,11 @@ paths:
       operationId: delete-connection
       summary: Delete a database connection
       description: |
-        Permanently deletes a database connection from the project.
+        Permanently deletes a database connection from the environment.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -469,7 +468,7 @@ paths:
         "503":
           $ref: "#/components/responses/ServiceUnavailable"
 
-  /projects/{projectName}/connections/{connectionName}/schemas:
+  /environments/{environmentName}/connections/{connectionName}/schemas:
     get:
       tags:
         - connections
@@ -480,9 +479,9 @@ paths:
         Each schema includes metadata such as name, description, and whether it's the default schema.
         This endpoint is useful for exploring the database structure and discovering available data sources.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -510,7 +509,7 @@ paths:
         "503":
           $ref: "#/components/responses/ServiceUnavailable"
 
-  /projects/{projectName}/connections/{connectionName}/schemas/{schemaName}/tables:
+  /environments/{environmentName}/connections/{connectionName}/schemas/{schemaName}/tables:
     get:
       tags:
         - connections
@@ -521,9 +520,9 @@ paths:
         This endpoint is useful for discovering available data sources and exploring the database
         structure. The schema must exist in the connection for this operation to succeed.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -567,7 +566,7 @@ paths:
         "503":
           $ref: "#/components/responses/ServiceUnavailable"
 
-  /projects/{projectName}/connections/{connectionName}/schemas/{schemaName}/tables/{tablePath}:
+  /environments/{environmentName}/connections/{connectionName}/schemas/{schemaName}/tables/{tablePath}:
     get:
       tags:
         - connections
@@ -579,9 +578,9 @@ paths:
         structure. The schema must exist in the connection for this operation to succeed.
         The tablePath is the full path to the table, including the schema name.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -620,7 +619,7 @@ paths:
           $ref: "#/components/responses/ServiceUnavailable"
 
   # TODO: Remove this endpoint.
-  /projects/{projectName}/connections/{connectionName}/sqlSource:
+  /environments/{environmentName}/connections/{connectionName}/sqlSource:
     get:
       tags:
         - connections
@@ -634,9 +633,9 @@ paths:
         Creates a Malloy source from a SQL statement using the specified connection.
         The SQL statement is executed to generate a source definition that can be used in Malloy models.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -677,9 +676,9 @@ paths:
         Creates a Malloy source from a SQL statement using the specified database connection.
         The SQL statement is executed to generate a source definition that can be used in Malloy models.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -715,7 +714,7 @@ paths:
         "503":
           $ref: "#/components/responses/ServiceUnavailable"
 
-  /projects/{projectName}/connections/{connectionName}/sqlQuery:
+  /environments/{environmentName}/connections/{connectionName}/sqlQuery:
     post:
       tags:
         - connections
@@ -725,9 +724,9 @@ paths:
         Executes a SQL statement against the specified database connection and returns the results.
         The results include data, metadata, and execution information.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -773,7 +772,7 @@ paths:
         "503":
           $ref: "#/components/responses/ServiceUnavailable"
 
-  /projects/{projectName}/connections/{connectionName}/sqlTemporaryTable:
+  /environments/{environmentName}/connections/{connectionName}/sqlTemporaryTable:
     post:
       tags:
         - connections
@@ -783,9 +782,9 @@ paths:
         Creates a temporary table from a SQL statement using the specified database connection.
         Temporary tables are useful for storing intermediate results during complex queries and data processing workflows.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -822,7 +821,7 @@ paths:
           $ref: "#/components/responses/ServiceUnavailable"
 
   # TODO: Remove this endpoint.
-  /projects/{projectName}/connections/{connectionName}/temporaryTable:
+  /environments/{environmentName}/connections/{connectionName}/temporaryTable:
     get:
       tags:
         - connections
@@ -836,9 +835,9 @@ paths:
         Creates a temporary table from a SQL statement using the specified connection.
         Temporary tables are useful for storing intermediate results during complex queries.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -871,7 +870,7 @@ paths:
           $ref: "#/components/responses/ServiceUnavailable"
 
   # TODO: Remove this endpoint.
-  /projects/{projectName}/connections/{connectionName}/queryData:
+  /environments/{environmentName}/connections/{connectionName}/queryData:
     get:
       tags:
         - connections
@@ -885,9 +884,9 @@ paths:
         Executes a SQL statement against the specified database connection and returns the results.
         The query results include data, metadata, and execution information.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -930,12 +929,12 @@ paths:
   # `:memory:` DuckDB rooted at the package's path), so any data-plane
   # call against `connectionName="duckdb"` needs a package context.
   # Non-`duckdb` names resolve through the package's MalloyConfig
-  # wrapper, which delegates to the project's connection registry, so
-  # the same routes also work for project-level connections looked up
+  # wrapper, which delegates to the environment's connection registry, so
+  # the same routes also work for environment-level connections looked up
   # in a package context.
   # ──────────────────────────────────────────────────────────────────
 
-  /projects/{projectName}/packages/{packageName}/connections/{connectionName}/schemas:
+  /environments/{environmentName}/packages/{packageName}/connections/{connectionName}/schemas:
     get:
       tags:
         - connections
@@ -945,11 +944,11 @@ paths:
         Retrieves a list of all schemas (databases) available in the specified
         connection, resolved in the context of the named package. Required for
         `connectionName="duckdb"`, which is per-package; works for any other
-        connection name as well (resolution falls through to the project).
+        connection name as well (resolution falls through to the environment).
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -983,7 +982,7 @@ paths:
         "503":
           $ref: "#/components/responses/ServiceUnavailable"
 
-  /projects/{projectName}/packages/{packageName}/connections/{connectionName}/schemas/{schemaName}/tables:
+  /environments/{environmentName}/packages/{packageName}/connections/{connectionName}/schemas/{schemaName}/tables:
     get:
       tags:
         - connections
@@ -993,9 +992,9 @@ paths:
         Retrieves a list of all tables and views available in the specified
         database schema, resolved in the context of the named package.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -1045,7 +1044,7 @@ paths:
         "503":
           $ref: "#/components/responses/ServiceUnavailable"
 
-  /projects/{projectName}/packages/{packageName}/connections/{connectionName}/schemas/{schemaName}/tables/{tablePath}:
+  /environments/{environmentName}/packages/{packageName}/connections/{connectionName}/schemas/{schemaName}/tables/{tablePath}:
     get:
       tags:
         - connections
@@ -1055,9 +1054,9 @@ paths:
         Retrieves a table from the specified database schema, resolved in
         the context of the named package.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -1102,7 +1101,7 @@ paths:
           $ref: "#/components/responses/ServiceUnavailable"
 
   # TODO: Remove the GET (deprecated) form once clients migrate.
-  /projects/{projectName}/packages/{packageName}/connections/{connectionName}/sqlSource:
+  /environments/{environmentName}/packages/{packageName}/connections/{connectionName}/sqlSource:
     get:
       tags:
         - connections
@@ -1115,9 +1114,9 @@ paths:
         Creates a Malloy source from a SQL statement using the specified
         connection, resolved in the context of the named package.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -1164,9 +1163,9 @@ paths:
         Creates a Malloy source from a SQL statement using the specified
         connection, resolved in the context of the named package.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -1208,7 +1207,7 @@ paths:
         "503":
           $ref: "#/components/responses/ServiceUnavailable"
 
-  /projects/{projectName}/packages/{packageName}/connections/{connectionName}/sqlQuery:
+  /environments/{environmentName}/packages/{packageName}/connections/{connectionName}/sqlQuery:
     post:
       tags:
         - connections
@@ -1218,9 +1217,9 @@ paths:
         Executes a SQL statement against the specified database connection,
         resolved in the context of the named package, and returns the results.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -1272,7 +1271,7 @@ paths:
         "503":
           $ref: "#/components/responses/ServiceUnavailable"
 
-  /projects/{projectName}/packages/{packageName}/connections/{connectionName}/sqlTemporaryTable:
+  /environments/{environmentName}/packages/{packageName}/connections/{connectionName}/sqlTemporaryTable:
     post:
       tags:
         - connections
@@ -1282,9 +1281,9 @@ paths:
         Creates a temporary table from a SQL statement using the specified
         database connection, resolved in the context of the named package.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -1327,7 +1326,7 @@ paths:
           $ref: "#/components/responses/ServiceUnavailable"
 
   # TODO: Remove this endpoint.
-  /projects/{projectName}/packages/{packageName}/connections/{connectionName}/temporaryTable:
+  /environments/{environmentName}/packages/{packageName}/connections/{connectionName}/temporaryTable:
     get:
       tags:
         - connections
@@ -1340,9 +1339,9 @@ paths:
         Creates a temporary table from a SQL statement using the specified
         connection, resolved in the context of the named package.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -1381,7 +1380,7 @@ paths:
           $ref: "#/components/responses/ServiceUnavailable"
 
   # TODO: Remove this endpoint.
-  /projects/{projectName}/packages/{packageName}/connections/{connectionName}/queryData:
+  /environments/{environmentName}/packages/{packageName}/connections/{connectionName}/queryData:
     get:
       tags:
         - connections
@@ -1394,9 +1393,9 @@ paths:
         Executes a SQL statement against the specified database connection,
         resolved in the context of the named package, and returns the results.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -1438,26 +1437,26 @@ paths:
         "500":
           $ref: "#/components/responses/InternalServerError"
 
-  /projects/{projectName}/packages:
+  /environments/{environmentName}/packages:
     get:
       tags:
         - packages
       operationId: list-packages
-      summary: List project packages
+      summary: List environment packages
       description: |
-        Retrieves a list of all Malloy packages within the specified project. Each package
+        Retrieves a list of all Malloy packages within the specified environment. Each package
         contains models, notebooks, databases, and other resources. This endpoint is useful
         for discovering available packages and their basic metadata.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
       responses:
         "200":
-          description: A list of all packages in the project
+          description: A list of all packages in the environment
           content:
             application/json:
               schema:
@@ -1478,13 +1477,13 @@ paths:
       operationId: create-package
       summary: Create a new package
       description: |
-        Creates a new Malloy package within the specified project. A package serves as a
+        Creates a new Malloy package within the specified environment. A package serves as a
         container for models, notebooks, embedded databases, and other resources. The package
         will be initialized with the provided metadata and can immediately accept content.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -1520,7 +1519,7 @@ paths:
         "503":
           $ref: "#/components/responses/ServiceUnavailable"
 
-  /projects/{projectName}/packages/{packageName}:
+  /environments/{environmentName}/packages/{packageName}:
     get:
       tags:
         - packages
@@ -1532,9 +1531,9 @@ paths:
         from disk before returning the information. The versionId parameter allows access to
         specific package versions.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -1583,9 +1582,9 @@ paths:
         modify package settings, update the description, change the location, or update other
         package-level properties. The package must exist and be accessible.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -1628,9 +1627,9 @@ paths:
         notebooks, databases, and metadata. This operation cannot be undone, so use with caution.
         The package must exist and be accessible for deletion.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -1658,7 +1657,7 @@ paths:
         "503":
           $ref: "#/components/responses/ServiceUnavailable"
 
-  /projects/{projectName}/packages/{packageName}/models:
+  /environments/{environmentName}/packages/{packageName}/models:
     get:
       tags:
         - models
@@ -1669,9 +1668,9 @@ paths:
         includes the relative path, package name, and any compilation errors. This endpoint
         is useful for discovering available models and checking their status.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -1707,7 +1706,7 @@ paths:
         "503":
           $ref: "#/components/responses/ServiceUnavailable"
 
-  /projects/{projectName}/packages/{packageName}/models/{path}:
+  /environments/{environmentName}/packages/{packageName}/models/{path}:
     get:
       tags:
         - models
@@ -1718,9 +1717,9 @@ paths:
         The model is compiled using the specified version of the Malloy compiler. This endpoint
         provides access to the model's structure, sources, and named queries for use in applications.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -1760,7 +1759,7 @@ paths:
         "501":
           $ref: "#/components/responses/NotImplemented"
 
-  /projects/{projectName}/packages/{packageName}/models/{path}/query:
+  /environments/{environmentName}/packages/{packageName}/models/{path}/query:
     post:
       tags:
         - models
@@ -1772,9 +1771,9 @@ paths:
         supports both ad-hoc queries and predefined model queries, making it flexible for various
         use cases including data exploration, reporting, and application integration.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -1816,7 +1815,7 @@ paths:
         "503":
           $ref: "#/components/responses/ServiceUnavailable"
 
-  /projects/{projectName}/packages/{packageName}/models/{path}/compile:
+  /environments/{environmentName}/packages/{packageName}/models/{path}/compile:
     post:
       tags:
         - models
@@ -1829,9 +1828,9 @@ paths:
         Relative imports resolve correctly against sibling model files.
         Returns compilation status and any problems (errors or warnings) found.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -1870,7 +1869,7 @@ paths:
         "503":
           $ref: "#/components/responses/ServiceUnavailable"
 
-  /projects/{projectName}/packages/{packageName}/notebooks:
+  /environments/{environmentName}/packages/{packageName}/notebooks:
     get:
       tags:
         - notebooks
@@ -1881,9 +1880,9 @@ paths:
         includes the relative path, package name, and any compilation errors. This endpoint
         is useful for discovering available notebooks and checking their status.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -1919,7 +1918,7 @@ paths:
         "503":
           $ref: "#/components/responses/ServiceUnavailable"
 
-  /projects/{projectName}/packages/{packageName}/notebooks/{path}:
+  /environments/{environmentName}/packages/{packageName}/notebooks/{path}:
     get:
       tags:
         - notebooks
@@ -1929,9 +1928,9 @@ paths:
         Retrieves a Malloy notebook with its raw cell contents (markdown and code).
         Cell execution should be done separately via the execute-notebook-cell endpoint.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -1969,7 +1968,7 @@ paths:
         "501":
           $ref: "#/components/responses/NotImplemented"
 
-  /projects/{projectName}/packages/{packageName}/notebooks/{path}/cells/{cellIndex}:
+  /environments/{environmentName}/packages/{packageName}/notebooks/{path}/cells/{cellIndex}:
     get:
       tags:
         - notebooks
@@ -1980,9 +1979,9 @@ paths:
         and runs the Malloy code, returning query results and any new sources defined.
         For markdown cells, this simply returns the cell content.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -2045,7 +2044,7 @@ paths:
         "503":
           $ref: "#/components/responses/ServiceUnavailable"
 
-  /projects/{projectName}/packages/{packageName}/databases:
+  /environments/{environmentName}/packages/{packageName}/databases:
     get:
       tags:
         - databases
@@ -2056,9 +2055,9 @@ paths:
         DuckDB databases stored as .parquet files that provide local data storage for the package.
         Each database entry includes metadata about the database structure and content.
       parameters:
-        - name: projectName
+        - name: environmentName
           in: path
-          description: Name of the project
+          description: Name of the environment
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
@@ -2101,9 +2100,9 @@ paths:
       operationId: test-connection-configuration
       summary: Test database connection configuration
       description: |
-        Validates a database connection configuration without adding it to any project.
+        Validates a database connection configuration without adding it to any environment.
         This endpoint allows you to test connection parameters, credentials, and network
-        connectivity before committing the connection to a project. Useful for troubleshooting
+        connectivity before committing the connection to an environment. Useful for troubleshooting
         connection issues and validating configurations during setup.
       requestBody:
         required: true
@@ -2137,7 +2136,7 @@ paths:
       summary: Get watch mode status
       description: |
         Retrieves the current status of the file watching system. This includes whether watch mode
-        is enabled, which project is being watched, and the path being monitored. Useful for
+        is enabled, which environment is being watched, and the path being monitored. Useful for
         monitoring the development workflow and ensuring file changes are being detected.
       responses:
         "200":
@@ -2160,9 +2159,9 @@ paths:
       operationId: start-watching
       summary: Start file watching
       description: |
-        Initiates file watching for the specified project. This enables real-time monitoring of
-        file changes within the project directory, allowing for automatic reloading and updates
-        during development. Only one project can be watched at a time.
+        Initiates file watching for the specified environment. This enables real-time monitoring of
+        file changes within the environment directory, allowing for automatic reloading and updates
+        during development. Only one environment can be watched at a time.
       requestBody:
         required: true
         content:
@@ -2188,7 +2187,7 @@ paths:
       description: |
         Stops the current file watching session. This disables real-time monitoring of file changes
         and releases system resources. Use this when development is complete or when switching
-        to a different project.
+        to a different environment.
       responses:
         "200":
           description: Watch mode stopped successfully.
@@ -2199,7 +2198,7 @@ paths:
         "503":
           $ref: "#/components/responses/ServiceUnavailable"
 
-  /projects/{projectName}/packages/{packageName}/materializations:
+  /environments/{environmentName}/packages/{packageName}/materializations:
     post:
       tags:
         - materializations
@@ -2209,7 +2208,7 @@ paths:
         Creates a new materialization in PENDING state for all persist sources across all
         models in the package. Use POST .../materializations/{materializationId}?action=start to begin execution.
       parameters:
-        - $ref: "#/components/parameters/projectName"
+        - $ref: "#/components/parameters/environmentName"
         - $ref: "#/components/parameters/packageName"
       requestBody:
         content:
@@ -2239,7 +2238,7 @@ paths:
       description: Returns the materialization history for the package, ordered by
         most recent first.
       parameters:
-        - $ref: "#/components/parameters/projectName"
+        - $ref: "#/components/parameters/environmentName"
         - $ref: "#/components/parameters/packageName"
         - name: limit
           in: query
@@ -2267,14 +2266,14 @@ paths:
         "404":
           $ref: "#/components/responses/NotFound"
 
-  /projects/{projectName}/packages/{packageName}/materializations/{materializationId}:
+  /environments/{environmentName}/packages/{packageName}/materializations/{materializationId}:
     get:
       tags:
         - materializations
       operationId: get-materialization
       summary: Get a specific materialization
       parameters:
-        - $ref: "#/components/parameters/projectName"
+        - $ref: "#/components/parameters/environmentName"
         - $ref: "#/components/parameters/packageName"
         - $ref: "#/components/parameters/materializationId"
       responses:
@@ -2297,7 +2296,7 @@ paths:
           * `start` - Transitions a PENDING materialization to RUNNING and begins execution in the background. Returns 202.
           * `stop` - Cancels a PENDING or RUNNING materialization. Returns 200.
       parameters:
-        - $ref: "#/components/parameters/projectName"
+        - $ref: "#/components/parameters/environmentName"
         - $ref: "#/components/parameters/packageName"
         - $ref: "#/components/parameters/materializationId"
         - name: action
@@ -2340,7 +2339,7 @@ paths:
       description: Deletes a terminal (SUCCESS, FAILED, or CANCELLED) materialization
         record.
       parameters:
-        - $ref: "#/components/parameters/projectName"
+        - $ref: "#/components/parameters/environmentName"
         - $ref: "#/components/parameters/packageName"
         - $ref: "#/components/parameters/materializationId"
       responses:
@@ -2355,7 +2354,7 @@ paths:
               schema:
                 $ref: "#/components/schemas/Error"
 
-  /projects/{projectName}/packages/{packageName}/manifest:
+  /environments/{environmentName}/packages/{packageName}/manifest:
     get:
       tags:
         - manifests
@@ -2365,7 +2364,7 @@ paths:
         Returns the current build manifest containing buildId-to-tableName mappings
         for all materialized sources in the package.
       parameters:
-        - $ref: "#/components/parameters/projectName"
+        - $ref: "#/components/parameters/environmentName"
         - $ref: "#/components/parameters/packageName"
       responses:
         "200":
@@ -2391,7 +2390,7 @@ paths:
             workers that did not themselves run the build; the endpoint does
             not write anything *into* storage.
       parameters:
-        - $ref: "#/components/parameters/projectName"
+        - $ref: "#/components/parameters/environmentName"
         - $ref: "#/components/parameters/packageName"
         - name: action
           in: query
@@ -2489,11 +2488,11 @@ components:
         timestamp:
           type: number
           description: Unix timestamp of the status check
-        projects:
+        environments:
           type: array
-          description: List of available projects
+          description: List of available environments
           items:
-            $ref: "#/components/schemas/Project"
+            $ref: "#/components/schemas/Environment"
         initialized:
           type: boolean
           description: Whether the server is fully initialized and ready to serve requests
@@ -2501,7 +2500,7 @@ components:
           type: string
           enum: [ "initializing", "serving", "draining" ]
           description: Status of the server; initializing when the server is loading
-            projects, packages and connections, serving when the server is
+            environments, packages and connections, serving when the server is
             initialized and ready to serve requests, and draining when the
             server is going to shut down
         frozenConfig:
@@ -2509,32 +2508,32 @@ components:
           description: Whether the server configuration is frozen (read-only mode). When
             true, all mutation operations are disabled.
 
-    Project:
+    Environment:
       type: object
-      description: Represents a Malloy project containing packages, connections, and
-        other resources
+      description: Represents a Malloy environment containing packages, connections,
+        and other resources
       properties:
         resource:
           type: string
-          description: Resource path to the project
+          description: Resource path to the environment
         name:
           type: string
-          description: Project name
+          description: Environment name
         readme:
           type: string
-          description: Project README content
+          description: Environment README content
         location:
           type: string
-          description: Project location, can be an absolute path or URI (e.g. github, s3,
-            gcs, etc.)
+          description: Environment location, can be an absolute path or URI (e.g. github,
+            s3, gcs, etc.)
         connections:
           type: array
-          description: List of database connections configured for this project
+          description: List of database connections configured for this environment
           items:
             $ref: "#/components/schemas/Connection"
         packages:
           type: array
-          description: List of Malloy packages in this project
+          description: List of Malloy packages in this environment
           items:
             $ref: "#/components/schemas/Package"
         materializationStorage:
@@ -3267,9 +3266,9 @@ components:
         DuckDB database connection configuration. Publisher intentionally
         exposes only data-source intent here. Database files, working
         directories, filesystem/network policy, extension loading, setup SQL,
-        temp directories, and resource knobs are owned by Publisher so project
-        configs cannot widen deployment policy through low-level DuckDB
-        settings.
+        temp directories, and resource knobs are owned by Publisher so
+        environment configs cannot widen deployment policy through low-level
+        DuckDB settings.
       properties:
         attachedDatabases:
           type: array
@@ -3413,27 +3412,27 @@ components:
         enabled:
           type: boolean
           description: Whether file watching is currently active
-        projectName:
+        environmentName:
           type: string
-          description: Name of the project being watched for file changes
+          description: Name of the environment being watched for file changes
         watchingPath:
           type: string
           description: The file system path being monitored for changes, null if not
             watching
       required:
         - enabled
-        - projectName
+        - environmentName
         - watchingPath
 
     StartWatchRequest:
       type: object
-      description: Request to start file watching for a project
+      description: Request to start file watching for an environment
       properties:
-        projectName:
+        environmentName:
           type: string
-          description: Name of the project to start watching for file changes
+          description: Name of the environment to start watching for file changes
       required:
-        - projectName
+        - environmentName
 
     ConnectionStatus:
       type: object
@@ -3528,7 +3527,7 @@ components:
       properties:
         id:
           type: string
-        projectId:
+        environmentId:
           type: string
         packageName:
           type: string
@@ -3577,11 +3576,11 @@ components:
           description: Name of the materialized table
 
   parameters:
-    projectName:
-      name: projectName
+    environmentName:
+      name: environmentName
       in: path
       required: true
-      description: Name of the project
+      description: Name of the environment
       schema:
         type: string
     packageName: