@@ -13,7 +13,7 @@ Metadata-protocol: narrowed
 
 **BREAKING** for a package source, publish request or listing that still writes `category`.
 
-- **`@objectstack/spec`.** The marketplace taxonomy is defined once, in `@objectstack/spec/marketplace` (`taxonomy.zod.ts`): `businessFunctions` (1-3 distinct values, the primary one first: `sales`, `marketing`, `customer-service`, `finance`, `hr`, `supply-chain`, `administration`, `project`, `legal`, `it`, `collaboration`), `industries` (up to 3, optional; absent means cross-industry), `solutionType` (`app` | `template` | `connector`; absent means `app`) and `maturity` (`beta` | `stable`; absent means `stable`), on `PackageSchema`, `CreatePackageRequestSchema`, `UpdatePackageRequestSchema`, `TemplateManifestSchema` (`objectstack.manifest.json`) and `MarketplaceListingSchema`, where `businessFunctions` is required. A search filters by `businessFunctions` / `industries` / `solutionTypes` / `maturity` and reads one facet count list per facet. `explainSolutionTypeContradiction` is the publish cross-check (a `template` needs the `unmanaged` install mode, a `connector` a declared connector) and `LEGACY_CATEGORY_MAPPING` says what every old category value becomes.
+- **`@objectstack/spec`.** The marketplace taxonomy is defined once, in `@objectstack/spec/marketplace` (`taxonomy.zod.ts`): `businessFunctions` (1-3 distinct values, the primary one first: `sales`, `marketing`, `customer_service`, `finance`, `hr`, `supply_chain`, `administration`, `project`, `legal`, `it`, `collaboration`), `industries` (up to 3, optional; absent means cross-industry), `solutionType` (`app` | `template` | `connector`; absent means `app`) and `maturity` (`beta` | `stable`; absent means `stable`), on `PackageSchema`, `CreatePackageRequestSchema`, `UpdatePackageRequestSchema`, `TemplateManifestSchema` (`objectstack.manifest.json`) and `MarketplaceListingSchema`, where `businessFunctions` is required. A search filters by `businessFunctions` / `industries` / `solutionTypes` / `maturity` and reads one facet count list per facet. `explainSolutionTypeContradiction` is the publish cross-check (a `template` needs the `unmanaged` install mode, a `connector` a declared connector) and `LEGACY_CATEGORY_MAPPING` says what every old category value becomes.
 - **Retired.** `category` on all six schemas, and `MarketplaceSearchResponse.facets.categories`, are `retiredKey()` tombstones: `tsc` refuses them and a parse refuses them with the prescription. `MarketplaceCategorySchema` / `MarketplaceCategory` and `PackageCategorySchema` / `PackageCategory` are removed. `RETIRED_KEYS_BY_MAJOR[18]` lists the six keys, `RETIRED_DEFS_BY_MAJOR[18]` both defs, and the upgrade guide carries the semantic entry `marketplace-category-retired`. No ADR-0087 conversion: none of these shapes is a stack collection member, so `os migrate meta` has nothing to rewrite; a runtime boot never reads them.
 - **`@objectstack/cli`.** `os package publish` refuses a `category` in `objectstack.manifest.json`, or the now-hidden `--category` flag, before any network call, naming the facets for the value it held. It judges each facet with the spec's schema, checks a declared `solutionType` against the built artifact, and sends the facets as `business_functions`, `industries`, `solution_type` and `maturity`; an absent facet is not sent.
 - **`create-objectstack`.** The blank template no longer ships `category: "starter"`, which every project scaffolded from it inherited and which the hosted publish route refused.
 
@@ -0,0 +1,24 @@
+---
+'@objectstack/spec': minor
+---
+
+fix(spec)!: the seven multi-word marketplace taxonomy values are spelled as identifiers (`customer_service`, `supply_chain`, …), so a select field can carry the facets as its options
+
+Clause-②: yes (narrowing) — seven accepted facet values change spelling, inside the marketplace-taxonomy narrowing of the same release; no published version carried the hyphenated spelling
+Metadata-protocol: narrowed
+
+<!-- adr-0087: not-required (already-registered marketplace-category-retired) The respelled values were introduced by the same unreleased change that registered this entry: @objectstack/spec 18.3.0 was published before it merged and its changeset is still pending, so no published spec ever accepted the hyphenated spelling and no stored row or authored source made against a release can hold it. The entry's prescription (category to the facets of marketplace/taxonomy.zod.ts and LEGACY_CATEGORY_MAPPING) names no value and stays the complete upgrade path; a value-rename entry would project a rename no released author can meet. -->
+
+`businessFunctions` and `industries` used to accept seven values with hyphens. A select option's value is a `SystemIdentifierSchema` (lowercase letters, digits, `_` and `.`), so no select field — the cloud catalog's facet columns, a console filter — could carry them. They are now spelled with underscores; order and arity are unchanged, and a guard test refuses any future taxonomy value that is not an identifier.
+
+| Facet | Wrote (unreleased builds only) | Write instead |
+|:--|:--|:--|
+| `businessFunctions` | `customer-service` | `customer_service` |
+| `businessFunctions` | `supply-chain` | `supply_chain` |
+| `industries` | `trade-distribution` | `trade_distribution` |
+| `industries` | `professional-services` | `professional_services` |
+| `industries` | `financial-services` | `financial_services` |
+| `industries` | `public-sector` | `public_sector` |
+| `industries` | `real-estate-construction` | `real_estate_construction` |
+
+`LEGACY_CATEGORY_MAPPING` maps `erp` to `["finance", "supply_chain"]`, and `os package publish` lists the identifier spellings when it refuses a retired `category`.
@@ -57,7 +57,7 @@ that replace its retired `category`):
 {
   "manifestId": "app.objectstack.hotcrm",
   "displayName": "HotCRM",
-  "businessFunctions": ["sales", "customer-service", "marketing"],
+  "businessFunctions": ["sales", "customer_service", "marketing"],
   "license": "Apache-2.0",
   "iconUrl": "https://raw.githubusercontent.com/objectstack-ai/hotcrm/main/assets/icon.svg",
   "homepageUrl": "https://github.com/objectstack-ai/hotcrm",
 
@@ -180,8 +180,8 @@ Public-facing package listing on the marketplace
 | **tagline** | `string` | optional | Short tagline (max 120 chars) |
 | **description** | `string` | optional | Full description (Markdown) |
 | **category** | `never` | optional | [REMOVED] `MarketplaceListing.category` was removed in @objectstack/spec 18 (ADR-0087) — one category had to say both who a package is for and what it is, and the platform and the cloud catalog spelled it from lists that disagreed. Delete the key. Declare `businessFunctions` (1-3 business functions, the primary one first), optionally `industries` (up to 3; absent means cross-industry) and `solutionType` (`app`, `template` or `connector`; absent means `app`). `LEGACY_CATEGORY_MAPPING` in @objectstack/spec/marketplace gives the facets for every old category value. |
-| **businessFunctions** | `Enum<'sales' \| 'marketing' \| 'customer-service' \| 'finance' \| 'hr' \| 'supply-chain' \| 'administration' \| 'project' \| 'legal' \| 'it' \| 'collaboration'>[]` | ✅ | Business functions the package serves: 1-3 distinct values, the first is primary |
-| **industries** | `Enum<'manufacturing' \| 'trade-distribution' \| 'retail' \| 'logistics' \| 'professional-services' \| 'financial-services' \| 'healthcare' \| 'education' \| 'public-sector' \| 'real-estate-construction'>[]` | optional | Industries the package is built for: up to 3 distinct values; absent means cross-industry |
+| **businessFunctions** | `Enum<'sales' \| 'marketing' \| 'customer_service' \| 'finance' \| 'hr' \| 'supply_chain' \| 'administration' \| 'project' \| 'legal' \| 'it' \| 'collaboration'>[]` | ✅ | Business functions the package serves: 1-3 distinct values, the first is primary |
+| **industries** | `Enum<'manufacturing' \| 'trade_distribution' \| 'retail' \| 'logistics' \| 'professional_services' \| 'financial_services' \| 'healthcare' \| 'education' \| 'public_sector' \| 'real_estate_construction'>[]` | optional | Industries the package is built for: up to 3 distinct values; absent means cross-industry |
 | **solutionType** | `Enum<'app' \| 'template' \| 'connector'>` | optional (default: `"app"`) | What a marketplace package is: a managed app, an unmanaged template, or a connector |
 | **maturity** | `Enum<'beta' \| 'stable'>` | optional (default: `"stable"`) | Package maturity: beta shows a badge on the listing; absent means stable |
 | **tags** | `string[]` | optional | Search tags |
@@ -246,8 +246,8 @@ Marketplace search request
 | :--- | :--- | :--- | :--- |
 | **query** | `string` | optional | Full-text search query |
 | **category** | `never` | optional | [REMOVED] `MarketplaceSearchRequest.category` was removed in @objectstack/spec 18 (ADR-0087) — one category had to say both who a package is for and what it is, and the platform and the cloud catalog spelled it from lists that disagreed. Delete the key. Declare `businessFunctions` (1-3 business functions, the primary one first), optionally `industries` (up to 3; absent means cross-industry) and `solutionType` (`app`, `template` or `connector`; absent means `app`). `LEGACY_CATEGORY_MAPPING` in @objectstack/spec/marketplace gives the facets for every old category value. |
-| **businessFunctions** | `Enum<'sales' \| 'marketing' \| 'customer-service' \| 'finance' \| 'hr' \| 'supply-chain' \| 'administration' \| 'project' \| 'legal' \| 'it' \| 'collaboration'>[]` | optional | Filter: any of these business functions |
-| **industries** | `Enum<'manufacturing' \| 'trade-distribution' \| 'retail' \| 'logistics' \| 'professional-services' \| 'financial-services' \| 'healthcare' \| 'education' \| 'public-sector' \| 'real-estate-construction'>[]` | optional | Filter: any of these industries |
+| **businessFunctions** | `Enum<'sales' \| 'marketing' \| 'customer_service' \| 'finance' \| 'hr' \| 'supply_chain' \| 'administration' \| 'project' \| 'legal' \| 'it' \| 'collaboration'>[]` | optional | Filter: any of these business functions |
+| **industries** | `Enum<'manufacturing' \| 'trade_distribution' \| 'retail' \| 'logistics' \| 'professional_services' \| 'financial_services' \| 'healthcare' \| 'education' \| 'public_sector' \| 'real_estate_construction'>[]` | optional | Filter: any of these industries |
 | **solutionTypes** | `Enum<'app' \| 'template' \| 'connector'>[]` | optional | Filter: any of these solution types |
 | **maturity** | `Enum<'beta' \| 'stable'>` | optional | Filter by maturity |
 | **tags** | `string[]` | optional | Filter by tags |
@@ -291,8 +291,8 @@ Public-facing package listing on the marketplace
 | **tagline** | `string` | optional | Short tagline (max 120 chars) |
 | **description** | `string` | optional | Full description (Markdown) |
 | **category** | `never` | optional | [REMOVED] `MarketplaceListing.category` was removed in @objectstack/spec 18 (ADR-0087) — one category had to say both who a package is for and what it is, and the platform and the cloud catalog spelled it from lists that disagreed. Delete the key. Declare `businessFunctions` (1-3 business functions, the primary one first), optionally `industries` (up to 3; absent means cross-industry) and `solutionType` (`app`, `template` or `connector`; absent means `app`). `LEGACY_CATEGORY_MAPPING` in @objectstack/spec/marketplace gives the facets for every old category value. |
-| **businessFunctions** | `Enum<'sales' \| 'marketing' \| 'customer-service' \| 'finance' \| 'hr' \| 'supply-chain' \| …>[]` | ✅ | Business functions the package serves: 1-3 distinct values, the first is primary |
-| **industries** | `Enum<'manufacturing' \| 'trade-distribution' \| 'retail' \| 'logistics' \| …>[]` | optional | Industries the package is built for: up to 3 distinct values; absent means cross-industry |
+| **businessFunctions** | `Enum<'sales' \| 'marketing' \| 'customer_service' \| 'finance' \| 'hr' \| 'supply_chain' \| …>[]` | ✅ | Business functions the package serves: 1-3 distinct values, the first is primary |
+| **industries** | `Enum<'manufacturing' \| 'trade_distribution' \| 'retail' \| 'logistics' \| …>[]` | optional | Industries the package is built for: up to 3 distinct values; absent means cross-industry |
 | **solutionType** | `Enum<'app' \| 'template' \| 'connector'>` | optional (default: `"app"`) | What a marketplace package is: a managed app, an unmanaged template, or a connector |
 | **maturity** | `Enum<'beta' \| 'stable'>` | optional (default: `"stable"`) | Package maturity: beta shows a badge on the listing; absent means stable |
 | **tags** | `string[]` | optional | Search tags |
@@ -316,8 +316,8 @@ Public-facing package listing on the marketplace
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
 | **categories** | `never` | optional | [REMOVED] `MarketplaceSearchResponse.facets.categories` was removed in @objectstack/spec 18 (ADR-0087) — one category had to say both who a package is for and what it is, and the platform and the cloud catalog spelled it from lists that disagreed. Delete the key. Declare `businessFunctions` (1-3 business functions, the primary one first), optionally `industries` (up to 3; absent means cross-industry) and `solutionType` (`app`, `template` or `connector`; absent means `app`). `LEGACY_CATEGORY_MAPPING` in @objectstack/spec/marketplace gives the facets for every old category value. |
-| **businessFunctions** | `{ value: Enum<'sales' \| 'marketing' \| 'customer-service' \| 'finance' \| 'hr' \| 'supply-chain' \| …>; count: integer }[]` | optional |  |
-| **industries** | `{ value: Enum<'manufacturing' \| 'trade-distribution' \| 'retail' \| 'logistics' \| …>; count: integer }[]` | optional |  |
+| **businessFunctions** | `{ value: Enum<'sales' \| 'marketing' \| 'customer_service' \| 'finance' \| 'hr' \| 'supply_chain' \| …>; count: integer }[]` | optional |  |
+| **industries** | `{ value: Enum<'manufacturing' \| 'trade_distribution' \| 'retail' \| 'logistics' \| …>; count: integer }[]` | optional |  |
 | **solutionTypes** | `{ value: Enum<'app' \| 'template' \| 'connector'>; count: integer }[]` | optional |  |
 | **pricing** | `{ model: Enum<'free' \| 'freemium' \| 'paid' \| 'subscription' \| 'usage-based' \| 'contact-sales'>; count: integer }[]` | optional |  |
Original file line number	Diff line number	Diff line change
@@ -57,7 +57,7 @@ that replace its retired `category`):
`57`	`57`	`{`
`58`	`58`	`"manifestId": "app.objectstack.hotcrm",`
`59`	`59`	`"displayName": "HotCRM",`
`60`		`- "businessFunctions": ["sales", "customer-service", "marketing"],`
	`60`	`+ "businessFunctions": ["sales", "customer_service", "marketing"],`
`61`	`61`	`"license": "Apache-2.0",`
`62`	`62`	`"iconUrl": "https://raw.githubusercontent.com/objectstack-ai/hotcrm/main/assets/icon.svg",`
`63`	`63`	`"homepageUrl": "https://github.com/objectstack-ai/hotcrm",`