feat(cassandra): add llm_config column to nvcf_api schema

migrations/cassandra/README.md

@@ -154,7 +154,7 @@ For a brand-new keyspace, the conventional sequence is:
 2. `02_init_roles.up.sql` - creates the application role and grants, with the login password supplied by `${SERVICE_ROLE_PASSWORD}`.
 3. `03_init_tables.up.sql` - the canonical schema (UDTs, tables, indexes) for the keyspace.
 
-Subsequent files (`04_*`, `05_*`, `06_*`) are incremental DDL deltas applied as the schema evolves.
+Subsequent files (`04_*` and later) are incremental migrations applied as the schema evolves. Most are DDL; `ess_api/04_*` is a data seed.
 
 The `03_init_tables.up.sql` follows a clean-slate model: it is updated in place when the canonical schema changes rather than accumulating `ALTER TABLE` history. Existing clusters apply only the deltas that postdate their last applied migration.
 

migrations/cassandra/keyspaces/README.md

@@ -25,7 +25,7 @@ pinned version reference is bumped accordingly.
 | `ess_api`         | [ess_api/03_init_tables.up.sql](ess_api/03_init_tables.up.sql)                 | `v0.48.26`     | `200fd74d` |
 | `event_ledger`    | [event_ledger/03_init_tables.up.sql](event_ledger/03_init_tables.up.sql)       | `0.10.0`       | `adc2ff44` |
 | `nvcf_autoscaler` | [nvcf_autoscaler/03_init_tables.up.sql](nvcf_autoscaler/03_init_tables.up.sql) | `v1.15.0`      | `bff903c`  |
-| `nvcf_api`        | [nvcf_api/03_init_tables.up.sql](nvcf_api/03_init_tables.up.sql)               | `v1.5.1`       | `7a422ff1` |
+| `nvcf_api`        | [nvcf_api/03_init_tables.up.sql](nvcf_api/03_init_tables.up.sql)               | `v1.10.0`      | `fcaea0c1` |
 | `nvct_api`        | [nvct_api/03_init_tables.up.sql](nvct_api/03_init_tables.up.sql)               | `v1.5.2`       | `a0247478` |
 | `sis_api`         | [sis_api/03_init_tables.up.sql](sis_api/03_init_tables.up.sql)                 | `v1.531.2`     | `8a492a2e` |
 
@@ -43,7 +43,7 @@ pinned version reference is bumped accordingly.
 | `01_init_keyspace.up.sql` | Creates the keyspace with `NetworkTopologyStrategy` replication. Uses `${REPLICA_COUNT}`, which the entrypoint substitutes before migration.                                                                    |
 | `02_init_roles.up.sql`    | Creates the application role, grants privileges, and sets the service login password via `${SERVICE_ROLE_PASSWORD}`.                                                                                               |
 | `03_init_tables.up.sql`   | Complete canonical schema with all UDTs, tables, and indexes at the pinned upstream version.                                                                                                                       |
-| `04_*`, `05_*`, `06_*`    | Incremental deltas for rolling upgrades. These add tables/columns that are not in `03_init_tables.up.sql` at the version that was applied on existing clusters. `ess_api/04_*` is a data seed (deployment-specific values). `sis_api/04_*`-`06_*` and `nvcf_api/04_*`-`05_*` are DDL deltas. |
+| `04_*` and later          | Incremental deltas for rolling upgrades. These add tables/columns that are not in `03_init_tables.up.sql` at the version that was applied on existing clusters. `ess_api/04_*` is a data seed (deployment-specific values). The `sis_api` and `nvcf_api` deltas are DDL. |
 
 ---
 

migrations/cassandra/keyspaces/nvcf_api/03_init_tables.up.sql

@@ -82,6 +82,7 @@ CREATE TABLE IF NOT EXISTS nvcf_api.functions_v3 (
     container_image               TEXT,
     utils_container_image         TEXT,
     model_specs                   MAP<TEXT, TEXT>,
+    llm_config                    TEXT,
     container_args                TEXT,
     container_environment         TEXT,
     helm_chart                    TEXT,

migrations/cassandra/keyspaces/nvcf_api/08_add_llm_config.up.sql

@@ -0,0 +1,6 @@
+-- Add llm_config column to functions_v3, matching the pinned schema version in
+-- keyspaces/README.md.
+-- Function-level LLM configuration, stored as JSON. Distinct from the per-model
+-- configuration embedded in model_specs.
+
+ALTER TABLE nvcf_api.functions_v3 ADD IF NOT EXISTS llm_config TEXT;