feat(catalog): include associations in the objects index (schema v3)

The unified `objects` view unioned every cataloged document type except
associations, which lived only in the standalone associations table — so
consumers treating `objects` as a complete index silently missed them. Union the
associations table into `objects` (ObjectType ASSOCIATION) and bump the catalog
schema to v3 so existing caches rebuild.

describe auto-detect now resolves associations through the single objects lookup
(fast path) instead of a separate query — a cross-module association resolves in
~3.7s via the catalog vs ~8.5s via the live-scan fallback. Adds a catalog test
that associations surface in the objects view.

Image collections, JavaScript actions, data transformers, and agent-editor docs
have no catalog tables yet, so they remain out of the index (tracked in #658).

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

Author: ako

CHANGELOG.md

@@ -12,6 +12,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 - **Marketplace search caching** — the first `mxcli marketplace search` fetches the full catalog listing once and caches it under `~/.mxcli/marketplace-catalog-<profile>.json` (24h TTL, mode 0600); subsequent searches (any keyword) are served from the cache instantly. `--refresh` bypasses the cache and re-fetches. An interactive progress line ("Searching marketplace… N items scanned") shows during a fresh scan
 - **`describe` auto-detects the document type** — the type is now optional for a qualified name: `mxcli describe MyModule.Customer` resolves the type itself (entity, microflow, page, snippet, enumeration, constant, java action, nanoflow, workflow, association incl. cross-module, …). Resolution prefers the catalog cache (O(1) lookup, no overhead vs. the explicit form) and falls back to a live project scan when the catalog is absent. An ambiguous name (e.g. an entity and a microflow sharing a name) is reported with its candidates. The explicit `describe <type> <name>` form is unchanged, and is still required for the forms that have no single qualified name (module, settings, navigation, module role)
 
+### 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.)
+
 ### Fixed
 
 - **Marketplace search now scans the whole catalog** — the Content API has no server-side search and caps `limit` at 100 per page, so `marketplace search` previously only filtered the first 100 items and silently missed matches further in (e.g. External Database Connector `219862`, Mendix Business Events `202649`). It now paginates via `offset`, fetching pages **concurrently** (first page alone so a common early match stays a single request; then bounded-parallel batches), and stops at `--limit` matches or end-of-catalog. Measured ~3m45s → ~44s on a slow link for a deep match; combined with the new cache, repeat searches are instant

cmd/mxcli/cmd_describe.go

@@ -287,6 +287,7 @@ var objectTypeToDescribe = map[string]string{
 	"MODULE":                 "module",
 	"ENTITY":                 "entity",
 	"EXTERNAL_ENTITY":        "entity",
+	"ASSOCIATION":            "association",
 	"MICROFLOW":              "microflow",
 	"NANOFLOW":               "nanoflow",
 	"PAGE":                   "page",
@@ -389,18 +390,15 @@ func resolveViaCatalog(projectPath, name string) []string {
 
 	q := "'" + strings.ReplaceAll(name, "'", "''") + "'"
 	var out []string
-	// Documents (the objects union view).
+	// The objects view is a complete index (associations included as of catalog
+	// schema v3), so a single query covers every auto-detectable type.
 	if res, err := cat.Query("SELECT DISTINCT ObjectType FROM objects WHERE QualifiedName = " + q); err == nil {
 		for _, row := range res.Rows {
 			if len(row) > 0 {
 				out = append(out, objectTypeToDescribe[fmt.Sprintf("%v", row[0])])
 			}
 		}
 	}
-	// Associations are not in the objects view; check their table directly.
-	if res, err := cat.Query("SELECT 1 FROM associations WHERE QualifiedName = " + q + " LIMIT 1"); err == nil && res.Count > 0 {
-		out = append(out, "association")
-	}
 	return out
 }
 

mdl/catalog/catalog_test.go

@@ -148,6 +148,36 @@ func TestQueryWithData(t *testing.T) {
 	}
 }
 
+// TestObjectsView_IncludesAssociations verifies that associations are part of
+// the unified objects index (catalog schema v3). They were previously only in
+// the standalone associations table, forcing consumers to query it separately.
+func TestObjectsView_IncludesAssociations(t *testing.T) {
+	cat, err := New()
+	if err != nil {
+		t.Fatalf("Failed to create catalog: %v", err)
+	}
+	defer cat.Close()
+
+	_, err = cat.CatalogDB().Exec(
+		"INSERT INTO associations_data (Id, Name, QualifiedName, ModuleName) VALUES (?, ?, ?, ?)",
+		"assoc-1", "Order_Customer", "Sales.Order_Customer", "Sales",
+	)
+	if err != nil {
+		t.Fatalf("Failed to insert association: %v", err)
+	}
+
+	result, err := cat.Query("SELECT ObjectType FROM objects WHERE QualifiedName = 'Sales.Order_Customer'")
+	if err != nil {
+		t.Fatalf("Query failed: %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 != "ASSOCIATION" {
+		t.Errorf("ObjectType = %v, want ASSOCIATION", got)
+	}
+}
+
 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 = "2"
+const CatalogSchemaVersion = "3"
 
 // MetaSchemaVersion is the catalog_meta key that records the schema version
 // the cache was built against.
@@ -771,6 +771,10 @@ func (c *Catalog) createTables() error {
 				ProjectId, ProjectName, SnapshotId, SnapshotDate, SnapshotSource
 			FROM entities
 			UNION ALL
+			SELECT Id, 'ASSOCIATION' as ObjectType, Name, QualifiedName, ModuleName, '' as Folder, Description,
+				ProjectId, ProjectName, SnapshotId, SnapshotDate, SnapshotSource
+			FROM associations
+			UNION ALL
 			SELECT Id, 'MICROFLOW' as ObjectType, Name, QualifiedName, ModuleName, Folder, Description,
 				ProjectId, ProjectName, SnapshotId, SnapshotDate, SnapshotSource
 			FROM microflows WHERE MicroflowType = 'MICROFLOW'