@@ -0,0 +1,22 @@
+---
+'@object-ui/app-shell': patch
+'@object-ui/i18n': patch
+---
+
+feat(console)!: the marketplace filters by business function, industry and solution type, and badges a beta package
+
+Clause-②: yes (narrowing)
+Metadata-protocol: none
+
+<!-- adr-0087: not-required (runtime-interface-only ui/packages/i18n/src/namespaces/marketplace/index.ts#MarketplaceCatalogue) the console's own translation catalogues, served as this type by the marketplace namespace loader and as `en`/`zh`/… of `@object-ui/i18n/locales`: no Zod schema, no spec declaration and no stored metadata reads a translation key, so `objectstack migrate meta` has nothing to rewrite and the compiler (for typed catalogue access) or the rendered key (for a `t()` string) reaches every caller -->
+
+- **Facet filters.** The marketplace page's single row of category chips is replaced by three facet filters, read from the marketplace taxonomy in `@objectstack/spec/marketplace`: solution type (a segment with All), business function and industry (toggle rows, any number of values). Values inside one facet combine with OR, the facets combine with AND, and both combine with the search box. Each value shows the count of loaded listings that carry it under the other facets' selection. A listing that declares no solution type counts as `app`, the spec's default. A facet no loaded listing carries is not drawn, so a catalog that does not serve the taxonomy yet shows no filter at all. Filtering stays on the client, over the page the catalog read loads.
+- **Badges.** A catalog card shows the listing's primary business function (the first it lists) and a Beta badge when its `maturity` is `beta`. The package Details page shows every business function in the listing's order, the industries, the solution type and the Beta badge. A value outside the spec's vocabulary is drawn nowhere; the old fallback that showed an unknown category's raw value is gone.
+- **Strings.** `@object-ui/i18n`'s marketplace catalogues drop the `marketplace.category.*` labels, a copy of the retired category enum, and gain `marketplace.businessFunction.*`, `marketplace.industry.*`, `marketplace.solutionType.*`, `marketplace.maturity.beta` and three facet headings (`marketplace.facet.*`) in every language. The console keys the labels by the spec enums' own values, and a test fails when a spec value has no label, or a catalogue labels a value the spec does not list.
+- **Wire.** The console reads the catalog row's `business_functions`, `industries`, `solution_type` and `maturity` columns, and no longer reads `category` or sends `?category=`.
+
+**BREAKING** (`@object-ui/i18n`, the marketplace catalogues served by `@object-ui/i18n/namespaces/marketplace` and held by `en`, `zh`, `zhHant`, `ja`, `ko`, `de`, `fr`, `es`, `pt`, `ru`, `ar` of `@object-ui/i18n/locales`): the `marketplace.category` group is removed from every language. It was a copy of the retired category enum, whose values the spec no longer declares.
+
+- FROM: `marketplace.category.crm`, `.erp`, `.hr`, `.finance`, `.project`, `.collaboration`, `.analytics`, `.integration`, `.automation`, `.ai`, `.security`, `.developer-tools`, `.ui-theme`, `.storage`, `.other`.
+- TO: no one-for-one replacement. A listing is now labelled by its facets: `marketplace.businessFunction.<value>`, `marketplace.industry.<value>` and `marketplace.solutionType.<value>`, keyed by the values of `MarketplaceBusinessFunctionSchema`, `MarketplaceIndustrySchema` and `MarketplaceSolutionTypeSchema` in `@objectstack/spec/marketplace`. Which facets an old category value becomes is `LEGACY_CATEGORY_MAPPING` in the same module.
+- Fix: delete a `t('marketplace.category.…')` call or an `en.marketplace.category` read, or label the listing's `businessFunctions` / `industries` / `solutionType` with the facet keys instead. A `t()` call that still names a removed key compiles (its key is a `string`) and renders the key itself.
@@ -0,0 +1,117 @@
+/**
+ * The marketplace catalog's facet filters: solution type as a segment (one
+ * value or All), business function and industry as toggle rows (any number of
+ * values, OR inside the row). The rows combine with AND. Each value carries
+ * the count of loaded listings that hold it under the other facets' selection.
+ *
+ * `facetOptions` (`marketplaceTaxonomy.ts`) decides what is drawn: a facet no
+ * loaded listing carries is empty and its row is not drawn, so a catalog that
+ * does not serve the taxonomy yet draws no filter at all.
+ */
+
+import type { ReactNode } from 'react';
+import { Button } from '@object-ui/components';
+import { useObjectTranslation } from '@object-ui/i18n';
+import type { FacetOptions, FacetSelection } from './marketplaceTaxonomy.js';
+
+function toggled<T>(set: ReadonlySet<T>, value: T): Set<T> {
+  const next = new Set(set);
+  if (next.has(value)) next.delete(value);
+  else next.add(value);
+  return next;
+}
+
+function FacetRow({ label, testId, children }: { label: string; testId: string; children: ReactNode }) {
+  return (
+    <div role="group" aria-label={label} data-testid={testId} className="flex flex-wrap items-center gap-1.5">
+      <span className="mr-1 text-xs font-medium text-muted-foreground" aria-hidden="true">{label}</span>
+      {children}
+    </div>
+  );
+}
+
+function FacetButton({ label, count, pressed, onClick, testId }: {
+  label: string;
+  count?: number;
+  pressed: boolean;
+  onClick: () => void;
+  testId: string;
+}) {
+  return (
+    <Button
+      size="sm"
+      variant={pressed ? 'default' : 'outline'}
+      aria-pressed={pressed}
+      onClick={onClick}
+      data-testid={testId}
+    >
+      {label}
+      {count !== undefined && (
+        <span className="ml-1.5 text-xs tabular-nums opacity-70" data-testid={`${testId}-count`}>{count}</span>
+      )}
+    </Button>
+  );
+}
+
+export function MarketplaceFacetFilters({ options, selection, onChange }: {
+  options: FacetOptions;
+  selection: FacetSelection;
+  onChange: (next: FacetSelection) => void;
+}) {
+  const { t } = useObjectTranslation();
+  if (options.solutionType.length === 0 && options.businessFunctions.length === 0 && options.industries.length === 0) {
+    return null;
+  }
+  return (
+    <div className="flex flex-col gap-2" data-testid="marketplace-facets">
+      {options.solutionType.length > 0 && (
+        <FacetRow label={t('marketplace.facet.solutionType')} testId="marketplace-facet-solutionType">
+          <FacetButton
+            label={t('marketplace.all')}
+            pressed={selection.solutionType === null}
+            onClick={() => onChange({ ...selection, solutionType: null })}
+            testId="marketplace-facet-solutionType-all"
+          />
+          {options.solutionType.map(({ value, count }) => (
+            <FacetButton
+              key={value}
+              label={t(`marketplace.solutionType.${value}`)}
+              count={count}
+              pressed={selection.solutionType === value}
+              onClick={() => onChange({ ...selection, solutionType: value })}
+              testId={`marketplace-facet-solutionType-${value}`}
+            />
+          ))}
+        </FacetRow>
+      )}
+      {options.businessFunctions.length > 0 && (
+        <FacetRow label={t('marketplace.facet.businessFunction')} testId="marketplace-facet-businessFunction">
+          {options.businessFunctions.map(({ value, count }) => (
+            <FacetButton
+              key={value}
+              label={t(`marketplace.businessFunction.${value}`)}
+              count={count}
+              pressed={selection.businessFunctions.has(value)}
+              onClick={() => onChange({ ...selection, businessFunctions: toggled(selection.businessFunctions, value) })}
+              testId={`marketplace-facet-businessFunction-${value}`}
+            />
+          ))}
+        </FacetRow>
+      )}
+      {options.industries.length > 0 && (
+        <FacetRow label={t('marketplace.facet.industry')} testId="marketplace-facet-industry">
+          {options.industries.map(({ value, count }) => (
+            <FacetButton
+              key={value}
+              label={t(`marketplace.industry.${value}`)}
+              count={count}
+              pressed={selection.industries.has(value)}
+              onClick={() => onChange({ ...selection, industries: toggled(selection.industries, value) })}
+              testId={`marketplace-facet-industry-${value}`}
+            />
+          ))}
+        </FacetRow>
+      )}
+    </div>
+  );
+}
@@ -115,6 +115,7 @@ import { ConnectorCredentialsStep } from './ConnectorCredentialsStep.js';
 import type { SuggestedBinding } from '../../services/suggestedBindingsApi.js';
 import { errorCodeIs } from '@object-ui/types';
 import { MarketplaceNamespaceGate } from './MarketplaceNamespaceGate.js';
+import { effectiveSolutionType, readListingTaxonomy } from './marketplaceTaxonomy.js';
 
 /**
  * Whether a cloud install lands in the environment this console renders, read
@@ -1461,9 +1462,29 @@ function MarketplacePackagePageBody() {
     ? data.versions.find((v) => v.version === dialogUpdate.to && !!v.release_notes?.trim())
     : undefined;
 
-  const categoryLabel = pkg.category
-    ? t(`marketplace.category.${pkg.category}` as any, { defaultValue: pkg.category })
-    : null;
+  // The listing's taxonomy (`marketplaceTaxonomy.ts`): every business
+  // function in the listing's order, the industries, the solution type, and
+  // Beta. An undeclared solution type reads as the spec's default, as the
+  // catalog page filters and counts it; the other facets draw nothing when the
+  // listing carries none.
+  const taxonomy = readListingTaxonomy(pkg);
+  const taxonomyGroups = [
+    {
+      key: 'solutionType',
+      label: t('marketplace.facet.solutionType'),
+      values: [t(`marketplace.solutionType.${effectiveSolutionType(taxonomy)}`)],
+    },
+    taxonomy.businessFunctions.length > 0 && {
+      key: 'businessFunction',
+      label: t('marketplace.facet.businessFunction'),
+      values: taxonomy.businessFunctions.map((v) => t(`marketplace.businessFunction.${v}`)),
+    },
+    taxonomy.industries.length > 0 && {
+      key: 'industry',
+      label: t('marketplace.facet.industry'),
+      values: taxonomy.industries.map((v) => t(`marketplace.industry.${v}`)),
+    },
+  ].filter((g): g is { key: string; label: string; values: string[] } => !!g);
 
   // ADR-0131 D6 — the install modes the manifest permits, as the operator's
   // choice: drawn only where it permits more than one. A package that permits
@@ -1578,7 +1599,9 @@ function MarketplacePackagePageBody() {
             {pkg.publisher && pkg.publisher !== 'private' && (
               <Badge variant={pkg.publisher === 'objectstack' ? 'default' : 'secondary'}>{pkg.publisher}</Badge>
             )}
-            {categoryLabel && <Badge variant="outline">{categoryLabel}</Badge>}
+            {taxonomy.beta && (
+              <Badge variant="secondary" data-testid="marketplace-detail-beta">{t('marketplace.maturity.beta')}</Badge>
+            )}
             {pkg.license && <Badge variant="outline" className="font-normal">{pkg.license}</Badge>}
             {localInstalledBadge}
             {!localInstall && cloudInstalledVersion && (
@@ -1594,6 +1617,22 @@ function MarketplacePackagePageBody() {
               </Badge>
             )}
           </div>
+          <div className="mt-2 flex flex-wrap items-center gap-x-4 gap-y-1.5" data-testid="marketplace-detail-taxonomy">
+            {taxonomyGroups.map((group) => (
+              <div
+                key={group.key}
+                role="group"
+                aria-label={group.label}
+                className="flex flex-wrap items-center gap-1.5"
+                data-testid={`marketplace-detail-${group.key}`}
+              >
+                <span className="text-xs text-muted-foreground" aria-hidden="true">{group.label}</span>
+                {group.values.map((value) => (
+                  <Badge key={value} variant="outline" className="font-normal">{value}</Badge>
+                ))}
+              </div>
+            ))}
+          </div>
           {localNotLoadedReason}
           {loc.description && (
             <p className="text-sm sm:text-base text-foreground/80 mt-3 max-w-2xl leading-relaxed">{loc.description}</p>
 
@@ -57,6 +57,14 @@ import { ProtocolCheckSkippedNote } from './ProtocolCheckSkippedNote.js';
 import { ConnectorCredentialsStep } from './ConnectorCredentialsStep.js';
 import { packagesHref } from '../../views/metadata-admin/packageSource.js';
 import { MarketplaceNamespaceGate } from './MarketplaceNamespaceGate.js';
+import { MarketplaceFacetFilters } from './MarketplaceFacetFilters.js';
+import {
+  EMPTY_FACET_SELECTION,
+  facetOptions,
+  matchesFacets,
+  readListingTaxonomy,
+  type FacetSelection,
+} from './marketplaceTaxonomy.js';
 
 /**
  * The card grid's track (objectui#12616): a card is never narrower than 240px,
@@ -360,7 +368,7 @@ function MarketplacePageBody() {
     phaseTimers.current = [];
   };
   const [query, setQuery] = useState('');
-  const [category, setCategory] = useState<string>('');
+  const [facets, setFacets] = useState<FacetSelection>(EMPTY_FACET_SELECTION);
   const [installed, setInstalled] = useState<LocalInstallEntry[]>([]);
   // ADR-0007 step ②: the org's own packages (visibility org/private), shown in
   // a "Your organization" section and installable inline (no public listing).
@@ -549,32 +557,24 @@ function MarketplacePageBody() {
     }
   };
 
-  const categories = useMemo(() => {
-    const s = new Set<string>();
-    for (const it of items) {
-      if (it.category) s.add(it.category);
-    }
-    return Array.from(s).sort();
-  }, [items]);
-
-  // Translate a category enum value via the i18n bundle; fall back to the
-  // raw value (lowercased) so unknown publisher categories still render.
-  const categoryLabel = (cat: string): string => {
-    const key = `marketplace.category.${cat}`;
-    const translated = t(key, { defaultValue: cat });
-    return translated === key ? cat : translated;
-  };
-
-  const filtered = useMemo(() => {
+  // The search box, then the facets (`marketplaceTaxonomy.ts`): OR inside a
+  // facet, AND across facets and with the search. One memo over the loaded
+  // page — the catalog read is `limit: 100`, filtered here on the client.
+  const { filtered, facetChoices } = useMemo(() => {
     const q = query.trim().toLowerCase();
-    return items.filter((it) => {
-      if (category && it.category !== category) return false;
-      if (!q) return true;
-      const loc = localizePackage(it, language);
-      const hay = `${loc.displayName} ${it.manifest_id} ${loc.description ?? ''}`.toLowerCase();
-      return hay.includes(q);
-    });
-  }, [items, query, category, language]);
+    const rows = items.map((it) => ({ it, taxonomy: readListingTaxonomy(it) }));
+    const searched = q
+      ? rows.filter(({ it }) => {
+          const loc = localizePackage(it, language);
+          const hay = `${loc.displayName} ${it.manifest_id} ${loc.description ?? ''}`.toLowerCase();
+          return hay.includes(q);
+        })
+      : rows;
+    return {
+      filtered: searched.filter(({ taxonomy }) => matchesFacets(taxonomy, facets)),
+      facetChoices: facetOptions(rows.map((r) => r.taxonomy), searched.map((r) => r.taxonomy), facets),
+    };
+  }, [items, query, facets, language]);
 
   // Ahead of the `!isAdmin` guard below deliberately (objectui#5557): on a
   // runtime that mounts no marketplace, "there is no marketplace here" is true
@@ -692,7 +692,7 @@ function MarketplacePageBody() {
       />
     <div className="flex flex-col gap-6 p-4 sm:p-6">
 
-      <div className="flex flex-col sm:flex-row gap-3">
+      <div className="flex flex-col gap-3">
         <div className="relative flex-1">
           <Search className="absolute left-3 top-1/2 -translate-y-1/2 h-4 w-4 text-muted-foreground" aria-hidden="true" />
           <Input
@@ -703,27 +703,7 @@ function MarketplacePageBody() {
             aria-label={t('marketplace.searchAria')}
           />
         </div>
-        {categories.length > 0 && (
-          <div className="flex flex-wrap gap-1.5">
-            <Button
-              size="sm"
-              variant={category === '' ? 'default' : 'outline'}
-              onClick={() => setCategory('')}
-            >
-              {t('marketplace.all')}
-            </Button>
-            {categories.map((cat) => (
-              <Button
-                key={cat}
-                size="sm"
-                variant={category === cat ? 'default' : 'outline'}
-                onClick={() => setCategory(cat)}
-              >
-                {categoryLabel(cat)}
-              </Button>
-            ))}
-          </div>
-        )}
+        <MarketplaceFacetFilters options={facetChoices} selection={facets} onChange={setFacets} />
       </div>
 
       {/* objectui#12710 — a catalog read still pending once the skeleton's
@@ -900,7 +880,8 @@ function MarketplacePageBody() {
         </div>
       ) : (
         <div className={CARD_GRID}>
-          {filtered.map((pkg) => {
+          {filtered.map(({ it: pkg, taxonomy }) => {
+            const primaryFunction = taxonomy.businessFunctions[0];
             const localEntry = installedByManifestId.get(pkg.manifest_id);
             const loc = localizePackage(pkg, language);
             return (
@@ -962,8 +943,17 @@ function MarketplacePageBody() {
                         {t('marketplace.versionBadge', { version: pkg.latest_version.version })}
                       </Badge>
                     )}
-                    {pkg.category && (
-                      <Badge variant="outline" className="text-xs">{categoryLabel(pkg.category)}</Badge>
+                    {/* The primary business function — the first the
+                        listing names — and Beta for a beta package. */}
+                    {primaryFunction && (
+                      <Badge variant="outline" className="text-xs" data-testid="marketplace-card-function">
+                        {t(`marketplace.businessFunction.${primaryFunction}`)}
+                      </Badge>
+                    )}
+                    {taxonomy.beta && (
+                      <Badge variant="secondary" className="text-xs" data-testid="marketplace-card-beta">
+                        {t('marketplace.maturity.beta')}
+                      </Badge>
                     )}
                     {pkg.latest_version?.published_at && (
                       <span className="text-xs text-muted-foreground ml-auto">