@instruments/taxonomy 2.0.0 → 2.2.0

package/README.md

@@ -11,6 +11,7 @@ The package root exports the governed corpus and its release metadata:
 - `PHRASE_ENTRIES` - exhaustive declarative `equivalent`, `ambiguous`, and `declined` records for every canonical or observed authored spelling.
 - `TAXONOMY_CORPUS_METADATA` - deterministic node, edge, and lexical counts with the corpus revision, snapshot, and package version.
 - `TAXONOMY_CORPUS_REVISION`, `TAXONOMY_SNAPSHOT`, and `TAXONOMY_VERSION` - the exact content fingerprint, source snapshot, and package release identifiers.
+- `CONCEPT_ASSESSMENT_POLICIES`, `ASSESSMENT_POLICY_REVISION`, and `ASSESSMENT_AUTHORITY_REFERENCES` - evidence requirements and explicit applicability-review status for every active concept. These are not measured consumer accuracy or a claim of standards compliance.
 
 It also exports the TypeScript types for those values. It does not export a resolver, matcher, ranker, search route, local IDs, semantic IDs, or legacy aliases. Consumers build policy on top of the same data; the repository's private HTTP adapter is one such consumer.
 
@@ -51,3 +52,5 @@ const walnutReadings = PHRASE_ENTRIES.find(
 Changes to canonical meaning or identity are governed corpus changes. There is deliberately no backward-compatibility layer in V1; consumers migrate to the canonical URI.
 
 Pin the exact package version and compare `TAXONOMY_CORPUS_REVISION` when a deployment needs to detect content drift. The revision is computed from the normalized graph and lexical entries, so it changes when governed corpus content changes even if the V1 API shape does not.
+
+In ordered facets, `rank` describes a grade. Broad parents such as `finish/sheen/glossy` have no rank and add no rung to the scale. Glossy is broader than Semi-gloss and High gloss; Satin remains separate. Retain all concepts in vocabulary listings, and count only ranked concepts when displaying scale length. A source stating only gloss or glossy does not establish a narrower grade, a measured gloss value, or a polishing process. Consumers retain source-field context and qualified spellings when interpreting finish words.

package/dist/axes/finish.d.ts

@@ -1,7 +1,7 @@
 import type { Term } from "../term.js";
 /** How the exposed surface was produced. Unordered. */
 export declare const FINISH_TREATMENT_TERMS: readonly Term[];
-/** How much the surface reflects, least to most. Ordered; see the header. */
+/** Ordered sheen grades plus unranked broader descriptions; see the header. */
 export declare const FINISH_SHEEN_TERMS: readonly Term[];
 /** What the surface feels like, or reads as under a raking light. Unordered. */
 export declare const FINISH_TEXTURE_TERMS: readonly Term[];

package/dist/index.js

@@ -1512,6 +1512,8 @@ var TAX57_DATE2 = "2026-09-26";
 var TAX57_SOURCE = "Linear TAX-57 visual-vocabulary review";
 var MG2435_DATE = "2026-10-02";
 var MG2435_SOURCE = "Linear MG-2435 feed-loss review";
+var GLOSSY = "glossy";
+var GLOSSY_DATE = "2026-10-10";
 var wikidata2 = (id, label) => `Wikidata ${id} ${label}, https://www.wikidata.org/wiki/${id}`;
 var reviewed2 = (slug, label, definition, source, extra = {}) => ({
   definition,
@@ -1772,20 +1774,40 @@ var FINISH_SHEEN_TERMS = [
     "An even mid sheen, softer than semi-gloss and clearly not matte.",
     5
   ),
-  vendored(
-    RETRIEVAL_SHEEN,
-    "semi-gloss",
-    "Semi-gloss",
-    "Strongly reflective while still scattering the highlight.",
-    6
-  ),
-  vendored(
-    RETRIEVAL_SHEEN,
-    "high-gloss",
-    "High gloss",
-    "Returns a sharp, mirror-like specular reflection.",
-    7
-  )
+  {
+    ...vendored(
+      RETRIEVAL_SHEEN,
+      "semi-gloss",
+      "Semi-gloss",
+      "Strongly reflective while still scattering the highlight.",
+      6
+    ),
+    broaderSlug: GLOSSY
+  },
+  {
+    ...vendored(
+      RETRIEVAL_SHEEN,
+      "high-gloss",
+      "High gloss",
+      "Returns a sharp, mirror-like specular reflection.",
+      7
+    ),
+    broaderSlug: GLOSSY
+  },
+  {
+    altLabels: ["gloss"],
+    definition: "A visibly shiny surface with pronounced specular reflection. This broad description does not specify a gloss grade or measured gloss value.",
+    introducedAt: GLOSSY_DATE,
+    label: "Glossy",
+    note: "Use a narrower sheen grade when the source supplies one. Semi-gloss and High gloss are narrower meanings; Satin has no universal broader relation here because suppliers both describe it as a glossy look and contrast it with glossy finishes. This term is not a rung on the ordered sheen scale and does not establish a polishing process.",
+    provenance: {
+      basis: "referenced",
+      snapshot: GLOSSY_DATE,
+      source: "MG-2620 Glossy review; Sherwin-Williams gloss and sheen guide, https://www.sherwin-williams.com/architects-specifiers-designers/inspiration/styles-and-techniques/sw-art-gloss-sheen-differences; Formica glossy versus matte finishes, https://formica.com/en-ca/articles/home-design/2025/glossy-vs-matte-kitchen-cabinets; Tikkurila satin counterexamples, https://tikkurila.com/how-choose-right-paint-your-interior-walls-and-ceilings and https://tikkurila.com/7-tips-painting-fence-old-or-new"
+    },
+    reviewedAt: GLOSSY_DATE,
+    slug: GLOSSY
+  }
 ];
 var FINISH_TEXTURE_TERMS = [
   vendored(
@@ -2731,8 +2753,8 @@ var MATERIAL_EVERYDAY_TERMS = [
       "A transparent, impact-resistant thermoplastic polymer family supplied as sheet or moulding.",
       wikidata3("Q62246", "polycarbonate")
     ),
-    broaderSlug: "polymer",
-    reviewedAt: COMPOSITION_REVIEW_DATE
+    broaderSlug: "plastic",
+    reviewedAt: "2026-10-14"
   },
   {
     ...reviewed3(
@@ -4249,6 +4271,8 @@ var fibreNames2 = (name, extra = []) => [
   ...extra
 ];
 var POLYMER_SLUG2 = "polymer";
+var PLASTIC_SLUG = "plastic";
+var PLASTIC_DATE = "2026-10-14";
 var MATERIAL_POLYMERS_TERMS = [
   compositionTerm(
     POLYMER_SLUG2,
@@ -4257,6 +4281,45 @@ var MATERIAL_POLYMERS_TERMS = [
     STANDARD_ISO_472
   ),
   // Families.
+  //
+  // PLASTIC IS A BROAD TERM FOR A SOURCE THAT SAYS "PLASTIC" AND NO MORE (TAX-60). Material Bank's
+  // material tag Plastic sits on 5,467 catalogue rows and descriptions say "plastic bottles".
+  // ISO 472:2013 defines a plastic as a material with a high polymer as an essential ingredient
+  // that can be shaped by flow at some stage of processing, and notes that elastomers are not
+  // plastics. A polymer is the wider class, so `plastic` sits beneath `polymer`.
+  //
+  // WHICH CHILDREN OF `polymer` MOVE BENEATH IT. A term moves only when every instance of it is a
+  // plastic, because a parent must hold every instance of its children (ADR 0001). Four move:
+  // `abs`, `polycarbonate`, `polyvinyl-chloride` and `polystyrene` are each defined as a
+  // thermoplastic polymer. Every other direct child of `polymer` stays where it is:
+  //   - `rubber` (and `latex`, `natural-rubber`) are elastomers, which ISO 472 excludes.
+  //   - `acrylic`, `polyolefin`, `polyamide`, `polyester` and `polyurethane` are families that
+  //     also cover fibres (acrylic, olefin, nylon, polyester and elastane fibre; ISO 2076), and a
+  //     term has one broader edge, so they cannot sit beneath both. Their moulding and sheet
+  //     members (PMMA, polyethylene, polypropylene, PET, PBT, TPU) stay beneath the family.
+  //   - `resin` is defined against bulk engineering plastic: it is a binder, coating or cast solid.
+  //   - `eva` ranges from a flexible thermoplastic to a rubber-like material, `ptfe` is also a
+  //     fibre (fluorofibre) and `silicone` covers elastomers and fluids, so none is only plastic.
+  //   - The man-made cellulosics are fibres, films and plastics alike.
+  // A search for `plastic` therefore reaches ABS, polycarbonate, PVC and polystyrene, and a source
+  // that names a family or grade keeps the narrower term. This is not a claim that the stayers are
+  // not plastics in some products; it records that the term would be false for some of its
+  // instances.
+  {
+    altLabels: ["plastics"],
+    broaderSlug: POLYMER_SLUG2,
+    definition: "A material that contains a high polymer as an essential ingredient and that can be shaped by flow at some stage of its processing into finished products.",
+    introducedAt: PLASTIC_DATE,
+    label: "Plastic",
+    note: "Use when a source says plastic without naming which; use a narrower term when it names one. Added on 2026-10-14 beneath Polymer. Elastomers are polymers that ISO 472 does not count as plastics, and fibres and coatings are polymers named by their own terms, so Rubber, Resin and the fibre families are not beneath it. A source saying only plastic does not establish a polymer family, a grade, a thermoplastic or thermosetting behaviour, or recycled content.",
+    provenance: {
+      basis: "referenced",
+      snapshot: PLASTIC_DATE,
+      source: "ISO 472:2013 Plastics: Vocabulary; the same wording in the Bureau de normalisation du Qu\xE9bec entry, https://vitrinelinguistique.oqlf.gouv.qc.ca/fiche-gdt/fiche/8355296/plastique; TAX-60 review of Material Bank's Plastic tag"
+    },
+    reviewedAt: PLASTIC_DATE,
+    slug: PLASTIC_SLUG
+  },
   compositionTerm(
     "polyamide",
     "Polyamide",
@@ -4322,14 +4385,15 @@ var MATERIAL_POLYMERS_TERMS = [
     STANDARD_ISO_1043_1,
     {
       altLabels: ["Acrylonitrile butadiene styrene"],
-      broaderSlug: POLYMER_SLUG2,
+      broaderSlug: PLASTIC_SLUG,
       external: [
         externalMapping(
           ISO_1043_12,
           "ABS",
           "acrylonitrile-butadiene-styrene plastic"
         )
-      ]
+      ],
+      reviewedAt: PLASTIC_DATE
     }
   ),
   compositionTerm(
@@ -4617,11 +4681,12 @@ var MATERIAL_POLYMERS_TERMS = [
     STANDARD_ISO_1043_1,
     {
       altLabels: ["PVC", "poly(vinyl chloride)"],
-      broaderSlug: POLYMER_SLUG2,
+      broaderSlug: PLASTIC_SLUG,
       external: [
         externalMapping(ISO_1043_12, "PVC", "poly(vinyl chloride)"),
         externalMapping("cas", "9002-86-2", "Poly(vinyl chloride)")
-      ]
+      ],
+      reviewedAt: PLASTIC_DATE
     }
   ),
   compositionTerm(
@@ -4630,8 +4695,9 @@ var MATERIAL_POLYMERS_TERMS = [
     "A thermoplastic polymer of styrene monomer.",
     STANDARD_ISO_1043_1,
     {
-      broaderSlug: POLYMER_SLUG2,
+      broaderSlug: PLASTIC_SLUG,
       external: [externalMapping(ISO_1043_12, "PS", "polystyrene")],
+      reviewedAt: PLASTIC_DATE,
       seenAs: ["Poly Styrene"]
     }
   ),
@@ -5433,8 +5499,10 @@ var MATERIAL_TERMS = [
       "Natural fibre",
       "A fibre obtained directly from a plant or animal without chemical regeneration."
     ),
+    altLabels: ["natural fiber"],
     broaderSlug: NATURAL_ORGANIC_SLUG2,
-    reviewedAt: COMPOSITION_REVIEW_DATE
+    note: "Use when a source says natural fibre without naming which; use Plant fibre, Animal fibre or the named fibre when it does. Gained the American spelling on 2026-10-14 (TAX-60).",
+    reviewedAt: "2026-10-14"
   },
   reparented(
     crossoverTerm(
@@ -5805,15 +5873,17 @@ var MATERIAL_TERMS = [
       "mineral"
     )
   ),
-  reparented(
-    crossoverTerm(
+  {
+    ...crossoverTerm(
       "terracotta",
       "Terracotta",
       "A coarse porous earthenware of fired clay.",
       `${CROSSOVER_DEFINITION_SOURCES.terracotta}; ${ASTM_C2422}`,
       "earthenware"
-    )
-  ),
+    ),
+    altLabels: ["terra cotta"],
+    reviewedAt: "2026-10-14"
+  },
   crossoverTerm(
     "denim",
     "Denim",
@@ -12017,7 +12087,7 @@ var resolveReference = (reference) => INDEX.byKey.get(canonicalKey(reference));
 // src/v1.ts
 var TAXONOMY_BASE_URI = "https://taxonomy.materialinstruments.com";
 var TAXONOMY_SNAPSHOT = "2026-10-02";
-var TAXONOMY_VERSION = "2.0.0";
+var TAXONOMY_VERSION = "2.2.0";
 var PUBLISHED_V1_BASELINE = "2026-08-30";
 var TAX45_REVIEW_SNAPSHOT = "2026-08-31";
 var LIMESTONE_INTRODUCED = "2026-09-01";
@@ -12349,6 +12419,12 @@ var REVIEW_LIFECYCLE = {
   status: "active"
 };
 var REVIEW_SOURCE9 = "everyday-interiors vocabulary review";
+var TERRA_COTTA_DATE = "2026-10-14";
+var TERRA_COTTA_LIFECYCLE = {
+  introducedAt: TERRA_COTTA_DATE,
+  reviewedAt: TERRA_COTTA_DATE,
+  status: "active"
+};
 var COLORSCOPE_INSTALLED = "@instruments/colorscope 9.4.0 data/reference/v1/taxonomy.json";
 var reviewedTaxonomy = (path) => ({
   authority: "taxonomy",
@@ -12731,6 +12807,29 @@ var AUTHORED_PHRASE_ENTRIES = [
     "Terracotta can name a fired-clay material or a ColorScope named color; firing and composition do not establish orange appearance.",
     crossoverSource("terracotta")
   ),
+  // TAX-60: Material Bank writes the material tag Terra Cotta (1,600 catalogue rows). It is the same
+  // word as terracotta, so it keeps both readings and no default, as the one-word spelling does.
+  {
+    explanation: "Terra cotta, written as two words, is a spelling of terracotta: it can name a fired-clay material or a ColorScope named color, and firing and composition do not establish orange appearance.",
+    governance: lexicalGovernance(
+      AMBIGUITY_GOVERNANCE,
+      {
+        basis: "evidenced",
+        snapshot: TERRA_COTTA_DATE,
+        source: `${crossoverSource("terracotta")}; TAX-60 review of Material Bank's Terra Cotta tag`
+      },
+      TERRA_COTTA_LIFECYCLE
+    ),
+    meanings: [
+      {
+        authority: "taxonomy",
+        uri: `${TAXONOMY_BASE_URI}/id/material/terracotta`
+      },
+      colorScope("terracotta", NAMED_COLOR_REFERENCE_KIND)
+    ],
+    outcome: "ambiguous",
+    phrase: "terra cotta"
+  },
   {
     explanation: "Brick can name fired clay masonry material or a ColorScope named color; the material need not be red and the color is not a substance.",
     governance: lexicalGovernance(

package/dist/term.d.ts

@@ -273,8 +273,9 @@ export interface Term {
      * both sit at 3 on their own ladders and are not the same claim about the world; the ladders
      * have different lengths and different subjects. Compare within a facet or not at all.
      *
-     * Dense from 1 within a facet, and either present on every term there or on none - both checked
-     * in `axes.test.ts`, because a half-ranked facet silently drops its unranked half from any sort.
+     * Dense from 1 across the grades within a facet. Every grade on an ordered scale is ranked;
+     * broad parents spanning several grades are unranked. Count ranked terms for the scale's
+     * length, and retain unranked parents when listing the vocabulary. Checked in `axes.test.ts`.
      */
     rank?: number;
     /** Present on PERIOD terms only. */

package/dist/v1.d.ts

@@ -3,7 +3,7 @@ import type { ElementPlacement, ExternalMapping, ExternalScheme, PeriodSpan, Rel
 export type { FacetHolds } from "./axes/index.js";
 export declare const TAXONOMY_BASE_URI: "https://taxonomy.materialinstruments.com";
 export declare const TAXONOMY_SNAPSHOT: "2026-10-02";
-export declare const TAXONOMY_VERSION: "2.0.0";
+export declare const TAXONOMY_VERSION: "2.2.0";
 export type CanonicalConceptUri = `${typeof TAXONOMY_BASE_URI}/id/${string}`;
 export type LifecycleStatus = "active" | "deprecated";
 export interface Lifecycle {
@@ -142,5 +142,5 @@ export declare const TAXONOMY_CORPUS_METADATA: {
     readonly phraseEntryCount: number;
     readonly revision: string;
     readonly snapshot: "2026-10-02";
-    readonly version: "2.0.0";
+    readonly version: "2.2.0";
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@instruments/taxonomy",
-  "version": "2.0.0",
+  "version": "2.2.0",
   "description": "Canonical data-only interiors and architecture knowledge graph and lexical corpus.",
   "license": "SEE LICENSE IN LICENSE",
   "repository": {