multiFK2

common/proto/table_definition.proto

@@ -53,16 +53,18 @@ message PostTableDefinitionRequest {
   // Table name to create inside the target profile.
   // Must be lowercase, alphanumeric with underscores,
   // start with a letter, and be <= 63 chars.
-  // Forbidden names: "id", "deleted", "created_at", "row_revision", or ending in "_id".
+  // Forbidden names: "id", "deleted", "created_at", "row_revision" -- the
+  // system columns, which share one namespace with table names wherever the
+  // two are named side by side. The "_id" suffix is allowed.
   string table_name = 1;
 
-  // List of user-defined columns (adds to system/id/fk columns).
+  // The table's columns, including its links. System columns are added on top.
   repeated ColumnDefinition columns = 3;
 
-  // List of column names to be indexed (must match existing user-defined columns).
-  // Indexes can target only user-defined columns; system columns ("id", "deleted",
-  // "created_at", "row_revision") and automatically generated foreign key ("*_id") columns already
-  // have indexes. Requests trying to index those columns are rejected.
+  // Column names to index, matching names declared above. System columns
+  // ("id", "deleted", "created_at", "row_revision") already have indexes, and
+  // a LINK column is indexed when it is created. Requests naming either are
+  // rejected.
   repeated string indexes = 4;
 
   // Name of profile (Postgres schema) where the table will be created.
@@ -142,9 +144,13 @@ enum MoneyRounding {
 
 // Describes one user-defined column for a table.
 message ColumnDefinition {
-  // Column name that follows the same validation rules as table_name.
-  // Must be lowercase, start with a letter, no uppercase characters,
-  // and cannot be "id", "deleted", "created_at", "row_revision", or end with "_id".
+  // Must be lowercase, start with a letter, and use only lowercase letters,
+  // digits and underscores.
+  //
+  // Cannot be "id", "deleted", "created_at" or "row_revision": those are
+  // system columns, and a data request names system and user columns in one
+  // namespace. Any other name is free, including one ending in "_id" -- no
+  // column name is derived from a table name, so nothing collides.
   string name = 1;
 
   // Logical column type. Supported values (case-insensitive):

common/proto/table_script.proto

@@ -181,6 +181,16 @@ message ScriptDependency {
   string operation = 4;
   // Relationship table used to match the owner row to the related collection.
   string via_table = 5;
+  // Column of the current row holding the referenced row's id: the link this
+  // dependency travels, resolved when the script was saved. Empty when no link
+  // is travelled -- a self-reference, or an aggregate, which follows a path
+  // instead. A table may link to one target several times, so this is the only
+  // thing that says which link was meant; never derive it from target_table.
+  string link_column = 6;
+  // The first argument exactly as the script wrote it: a link alias, or the
+  // target table's name where one link makes that unambiguous. The Steel
+  // runtime looks its inputs up by this text.
+  string name_in_script = 7;
 }
 
 // Identifies the active form row whose external Steel inputs must be hydrated.

common/proto/table_structure.proto

@@ -46,7 +46,7 @@ message GetTableStructureResponse {
 message TableStructureResponse {
   // Columns of the physical table, including system columns (id, deleted,
   // created_at, row_revision), user-defined columns, and any foreign-key columns such as
-  // "<linked_table>_id", plus the dedicated "account_id" column on
+  // named by whoever declared each link, plus the dedicated "account_id" on
   // ACCOUNTING-enabled tables. May be empty if the physical table is missing.
   repeated TableColumn columns = 1;
 }

common/proto/tables_data.proto

@@ -62,7 +62,7 @@ service TablesData {
   // - Validates profile and table definition
   // - Returns all columns as strings (COALESCE(col::TEXT, '') AS col)
   //   including: id, deleted, row_revision, all user-defined columns, and FK columns
-  //   named "<linked_table>_id" for each table link, plus "account_id" on
+  //   named by whoever declared each link, plus "account_id" on
   //   ACCOUNTING-enabled tables
   // - Fails with NOT_FOUND if record does not exist or is soft-deleted
   // - If the physical table is missing but the definition exists, returns INTERNAL
@@ -101,7 +101,7 @@ message PostTableDataRequest {
   // - User-defined columns from the table definition
   // - System/FK columns:
   //    • "deleted" (BOOLEAN), optional; default FALSE if not provided
-  //    • "<linked_table>_id" (BIGINT) for each table link
+  //    • one BIGINT per link, named by whoever declared it
   //    • "account_id" (BIGINT) on ACCOUNTING-enabled tables
   //
   // Type expectations by SQL type:
@@ -250,7 +250,7 @@ message GetTableDataResponse {
   // Map of column_name → stringified value for:
   // - id, deleted
   // - all user-defined columns from the table definition
-  // - FK columns named "<linked_table>_id" for each table link
+  // - one column per link, named by whoever declared it
   // - account_id for ACCOUNTING-enabled tables
   //
   // All values are returned as TEXT via col::TEXT and COALESCEed to empty string