@instruments/taxonomy 2.0.0 → 2.1.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(
@@ -12017,7 +12039,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.1.0";
 var PUBLISHED_V1_BASELINE = "2026-08-30";
 var TAX45_REVIEW_SNAPSHOT = "2026-08-31";
 var LIMESTONE_INTRODUCED = "2026-09-01";

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.1.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.1.0";
 };

package/package.json

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