feat(catalog): index image collections, JS actions, data transformers (schema v4)

These document types had no catalog table, so they were absent from the objects
index (and from describe auto-detect / catalog search). Add tables + views for
javascript_actions, image_collections, data_transformers and union them into
objects (JAVASCRIPT_ACTION / IMAGE_COLLECTION / DATA_TRANSFORMER).

A single generic builder (buildSimpleNamedDocs) populates them from the raw-unit
surface (ListRawUnitsByType + Name-only decode), so adding these types needed no
change to the CatalogReader interface or its backend implementation — keeping
clear of the in-flight backend rewrite on the modelsdk branch. Schema bumped to
v4 (caches rebuild on next refresh).

describe auto-detect now resolves image collections and data transformers by
bare name (JS actions are cataloged but have no describe CLI form, so they're
left out of auto-detect). Verified on a real project (17 image collections, 72
JS actions in objects; describe of a bare image-collection name works).

Agent-editor docs (agent/model/knowledge base/consumed MCP service) remain
uncataloged — they are CustomBlobDocuments with the name in a JSON blob, a
separate follow-up. (#658)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: ako

CHANGELOG.md

@@ -14,7 +14,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ### Changed
 
-- **Catalog `objects` index includes associations** — the unified `objects` view now unions the `associations` table (`ObjectType = ASSOCIATION`), so it is a complete index for the cataloged document types and consumers no longer need a separate associations query. Catalog schema bumped to v3; cached `.mxcli/catalog.db` files rebuild automatically on the next `refresh catalog`. (Image collections, JavaScript actions, data transformers, and agent-editor docs are not yet cataloged at all, so they remain out of the index — tracked in #658.)
+- **Catalog `objects` index includes associations** — the unified `objects` view now unions the `associations` table (`ObjectType = ASSOCIATION`), so it is a complete index for the cataloged document types and consumers no longer need a separate associations query. Catalog schema bumped to v3; cached `.mxcli/catalog.db` files rebuild automatically on the next `refresh catalog`.
+- **Catalog indexes image collections, JavaScript actions, and data transformers** — these document types had no catalog table at all; they are now built (via the raw-unit surface, so no `CatalogReader`/backend change) into their own tables and unioned into `objects` (`IMAGE_COLLECTION`, `JAVASCRIPT_ACTION`, `DATA_TRANSFORMER`). `describe` auto-detect resolves image collections and data transformers by bare name. Catalog schema bumped to v4. (Agent-editor docs — agent/model/knowledge base/consumed MCP service — remain uncataloged: they are `CustomBlobDocument`s with the name inside a JSON blob; tracked in #658.)
 
 ### Fixed
 

cmd/mxcli/cmd_describe.go

@@ -305,6 +305,10 @@ var objectTypeToDescribe = map[string]string{
 	"REST_CLIENT":            "restclient",
 	"BUSINESS_EVENT_SERVICE": "businesseventservice",
 	"DATABASE_CONNECTION":    "databaseconnection",
+	"IMAGE_COLLECTION":       "imagecollection",
+	"DATA_TRANSFORMER":       "datatransformer",
+	// JAVASCRIPT_ACTION is cataloged but has no `describe` CLI form, so it is
+	// intentionally omitted from auto-detect.
 }
 
 // unitTypeToDescribe maps a top-level unit's BSON $Type to the `describe`

mdl/catalog/builder.go

@@ -377,6 +377,18 @@ func (b *Builder) Build(progress ProgressFunc) error {
 		return fmt.Errorf("failed to build java actions: %w", err)
 	}
 
+	if err := b.buildSimpleNamedDocs("JavaScriptActions$JavaScriptAction", "javascript_actions", "JavaScript Actions"); err != nil {
+		return fmt.Errorf("failed to build javascript actions: %w", err)
+	}
+
+	if err := b.buildSimpleNamedDocs("Images$ImageCollection", "image_collections", "Image Collections"); err != nil {
+		return fmt.Errorf("failed to build image collections: %w", err)
+	}
+
+	if err := b.buildSimpleNamedDocs("DataTransformers$DataTransformer", "data_transformers", "Data Transformers"); err != nil {
+		return fmt.Errorf("failed to build data transformers: %w", err)
+	}
+
 	if err := b.buildMicroflows(); err != nil {
 		return fmt.Errorf("failed to build microflows: %w", err)
 	}

mdl/catalog/builder_simpledocs.go

@@ -0,0 +1,59 @@
+// SPDX-License-Identifier: Apache-2.0
+
+package catalog
+
+import "go.mongodb.org/mongo-driver/bson"
+
+// buildSimpleNamedDocs catalogs documents that are plain named units (a top-level
+// BSON `Name`, optionally `Documentation`) into a `<table>_data` table with the
+// standard Id/Name/QualifiedName/ModuleName/Folder/Description columns.
+//
+// It reads through the raw-unit surface (ListRawUnitsByType) rather than a typed
+// reader method, so adding a new document type to the catalog needs no change to
+// the CatalogReader interface or its backend implementation — only a table, this
+// call, and an objects-view union. Used for image collections, JavaScript
+// actions, and data transformers, which had no catalog table before.
+func (b *Builder) buildSimpleNamedDocs(typePrefix, table, reportLabel string) error {
+	units, err := b.reader.ListRawUnitsByType(typePrefix)
+	if err != nil {
+		return err
+	}
+
+	stmt, err := b.tx.Prepare(
+		"INSERT INTO " + table + "_data " +
+			"(Id, Name, QualifiedName, ModuleName, Folder, Description, ProjectId, SnapshotId) " +
+			"VALUES (?, ?, ?, ?, ?, ?, ?, ?)",
+	)
+	if err != nil {
+		return err
+	}
+	defer stmt.Close()
+
+	projectID, snapshotID := b.snapshotMeta()
+
+	count := 0
+	for _, u := range units {
+		var doc struct {
+			Name          string `bson:"Name"`
+			Documentation string `bson:"Documentation"`
+		}
+		if err := bson.Unmarshal(u.Contents, &doc); err != nil || doc.Name == "" {
+			continue
+		}
+		moduleID := b.hierarchy.findModuleID(u.ContainerID)
+		moduleName := b.hierarchy.getModuleName(moduleID)
+		qualifiedName := moduleName + "." + doc.Name
+		folderPath := b.hierarchy.buildFolderPath(u.ContainerID)
+
+		if _, err := stmt.Exec(
+			string(u.ID), doc.Name, qualifiedName, moduleName, folderPath,
+			doc.Documentation, projectID, snapshotID,
+		); err != nil {
+			return err
+		}
+		count++
+	}
+
+	b.report(reportLabel, count)
+	return nil
+}

mdl/catalog/catalog_test.go

@@ -178,6 +178,48 @@ func TestObjectsView_IncludesAssociations(t *testing.T) {
 	}
 }
 
+// TestObjectsView_IncludesNewDocumentTypes verifies the document types added to
+// the catalog in schema v4 (image collections, JavaScript actions, data
+// transformers) surface in the unified objects index.
+func TestObjectsView_IncludesNewDocumentTypes(t *testing.T) {
+	cases := []struct {
+		table      string
+		objectType string
+	}{
+		{"javascript_actions", "JAVASCRIPT_ACTION"},
+		{"image_collections", "IMAGE_COLLECTION"},
+		{"data_transformers", "DATA_TRANSFORMER"},
+	}
+	for _, tc := range cases {
+		t.Run(tc.objectType, func(t *testing.T) {
+			cat, err := New()
+			if err != nil {
+				t.Fatalf("Failed to create catalog: %v", err)
+			}
+			defer cat.Close()
+
+			qn := "Mod." + tc.table
+			if _, err := cat.CatalogDB().Exec(
+				"INSERT INTO "+tc.table+"_data (Id, Name, QualifiedName, ModuleName) VALUES (?, ?, ?, ?)",
+				"id-1", tc.table, qn, "Mod",
+			); err != nil {
+				t.Fatalf("insert: %v", err)
+			}
+
+			result, err := cat.Query("SELECT ObjectType FROM objects WHERE QualifiedName = '" + qn + "'")
+			if err != nil {
+				t.Fatalf("query: %v", err)
+			}
+			if result.Count != 1 {
+				t.Fatalf("expected 1 row in objects view, got %d", result.Count)
+			}
+			if got := result.Rows[0][0]; got != tc.objectType {
+				t.Errorf("ObjectType = %v, want %s", got, tc.objectType)
+			}
+		})
+	}
+}
+
 func TestQueryError(t *testing.T) {
 	cat, err := New()
 	if err != nil {

mdl/catalog/tables.go

@@ -12,7 +12,7 @@ package catalog
 //	    SnapshotSource / SourceId / SourceBranch / SourceRevision columns
 //	    from every row (issue #576).
 //	1 — initial flat schema with denormalized snapshot columns on every row.
-const CatalogSchemaVersion = "3"
+const CatalogSchemaVersion = "4"
 
 // MetaSchemaVersion is the catalog_meta key that records the schema version
 // the cache was built against.
@@ -245,6 +245,45 @@ func (c *Catalog) createTables() error {
 		)`,
 		viewWithFullSnapshot("java_actions"),
 
+		// javascript_actions
+		`CREATE TABLE IF NOT EXISTS javascript_actions_data (
+			Id TEXT PRIMARY KEY,
+			Name TEXT,
+			QualifiedName TEXT,
+			ModuleName TEXT,
+			Folder TEXT,
+			Description TEXT,
+			ProjectId TEXT,
+			SnapshotId TEXT
+		)`,
+		viewWithFullSnapshot("javascript_actions"),
+
+		// image_collections
+		`CREATE TABLE IF NOT EXISTS image_collections_data (
+			Id TEXT PRIMARY KEY,
+			Name TEXT,
+			QualifiedName TEXT,
+			ModuleName TEXT,
+			Folder TEXT,
+			Description TEXT,
+			ProjectId TEXT,
+			SnapshotId TEXT
+		)`,
+		viewWithFullSnapshot("image_collections"),
+
+		// data_transformers
+		`CREATE TABLE IF NOT EXISTS data_transformers_data (
+			Id TEXT PRIMARY KEY,
+			Name TEXT,
+			QualifiedName TEXT,
+			ModuleName TEXT,
+			Folder TEXT,
+			Description TEXT,
+			ProjectId TEXT,
+			SnapshotId TEXT
+		)`,
+		viewWithFullSnapshot("data_transformers"),
+
 		// activities
 		`CREATE TABLE IF NOT EXISTS activities_data (
 			Id TEXT PRIMARY KEY,
@@ -807,6 +846,18 @@ func (c *Catalog) createTables() error {
 				ProjectId, ProjectName, SnapshotId, SnapshotDate, SnapshotSource
 			FROM java_actions
 			UNION ALL
+			SELECT Id, 'JAVASCRIPT_ACTION' as ObjectType, Name, QualifiedName, ModuleName, Folder, Description,
+				ProjectId, ProjectName, SnapshotId, SnapshotDate, SnapshotSource
+			FROM javascript_actions
+			UNION ALL
+			SELECT Id, 'IMAGE_COLLECTION' as ObjectType, Name, QualifiedName, ModuleName, Folder, Description,
+				ProjectId, ProjectName, SnapshotId, SnapshotDate, SnapshotSource
+			FROM image_collections
+			UNION ALL
+			SELECT Id, 'DATA_TRANSFORMER' as ObjectType, Name, QualifiedName, ModuleName, Folder, Description,
+				ProjectId, ProjectName, SnapshotId, SnapshotDate, SnapshotSource
+			FROM data_transformers
+			UNION ALL
 			SELECT Id, 'ODATA_CLIENT' as ObjectType, Name, QualifiedName, ModuleName, '' as Folder, '' as Description,
 				ProjectId, ProjectName, SnapshotId, SnapshotDate, SnapshotSource
 			FROM odata_clients