@instruments/taxonomy 1.13.0 → 2.0.0

package/README.md

@@ -8,7 +8,7 @@ The package root exports the governed corpus and its release metadata:
 
 - `TAXONOMY_BASE_URI` - the authority used for every canonical concept URI.
 - `KNOWLEDGE_GRAPH` - normalized axis, facet, and concept nodes plus typed, bidirectional edges.
-- `LEXICAL_ENTRIES` - exhaustive declarative `equivalent`, `ambiguous`, and `declined` records for every canonical or observed authored spelling.
+- `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.
 
@@ -22,7 +22,7 @@ https://taxonomy.materialinstruments.com/id/facet/palette/hue
 https://taxonomy.materialinstruments.com/id/material/walnut
 ```
 
-ColorScope remains authoritative for colour concepts. Taxonomy does not mint graph nodes or URIs for ColorScope-governed terms; lexical records reference ColorScope identifiers without merging them into Taxonomy hierarchy. For example, `walnut` has a governed primary material reading and a secondary ColorScope reading. Two more phrases carry an ordered reading between two material concepts: `quartz` (engineered quartz before the mineral) and `melamine` (melamine-faced board before the resin).
+ColorScope remains authoritative for color concepts. Taxonomy does not mint graph nodes or URIs for ColorScope-governed terms; lexical records reference ColorScope identifiers without merging them into Taxonomy hierarchy. For example, `walnut` has a governed primary material meaning and a secondary ColorScope meaning. Two more phrases carry an ordered meaning between two material concepts: `quartz` (engineered quartz before the mineral) and `melamine` (melamine-faced board before the resin).
 
 ## Install and consume
 
@@ -33,7 +33,7 @@ pnpm add @instruments/taxonomy
 ```ts
 import {
   KNOWLEDGE_GRAPH,
-  LEXICAL_ENTRIES,
+  PHRASE_ENTRIES,
   TAXONOMY_CORPUS_METADATA,
 } from "@instruments/taxonomy";
 
@@ -43,7 +43,7 @@ const walnut = KNOWLEDGE_GRAPH.nodes.find(
     node.uri === "https://taxonomy.materialinstruments.com/id/material/walnut"
 );
 
-const walnutReadings = LEXICAL_ENTRIES.find(
+const walnutReadings = PHRASE_ENTRIES.find(
   (entry) => entry.phrase === "walnut"
 );
 ```

package/dist/assessment-policy.d.ts

@@ -0,0 +1,47 @@
+import type { CanonicalConceptUri } from "./v1.js";
+/** Evidence routes are consumer contracts, never new appearance concepts. */
+export type AssessmentEvidenceRoute = "photo-candidate" | "capture-conditional" | "catalogue-only" | "context-required" | "external-authority" | "unreviewed";
+/** A restriction needs an explicit list AND evidence; absence never means prohibited. */
+export type MaterialApplicability = {
+    status: "unreviewed";
+    reason: string;
+} | {
+    status: "cross-category";
+    evidence: readonly string[];
+} | {
+    status: "restricted";
+    categoryUris: readonly CanonicalConceptUri[];
+    evidence: readonly string[];
+};
+export interface ConceptAssessmentPolicy {
+    conceptUri: CanonicalConceptUri;
+    evidenceRoute: AssessmentEvidenceRoute;
+    materialApplicability: MaterialApplicability;
+    requirements: readonly string[];
+    references: readonly string[];
+}
+/**
+ * Total accounting for active concepts. Unreviewed applicability is intentional:
+ * supplier omissions and general word knowledge cannot establish material exclusions.
+ * Definitions, aliases and cardinality continue to come from KNOWLEDGE_GRAPH.
+ */
+export declare const CONCEPT_ASSESSMENT_POLICIES: readonly ConceptAssessmentPolicy[];
+/** These owner references anchor the audit, not a claim of standards compliance. */
+export declare const ASSESSMENT_AUTHORITY_REFERENCES: readonly [{
+    readonly role: "appearance-terminology";
+    readonly url: "https://store.astm.org/e0284-25.html";
+}, {
+    readonly role: "property-measurement";
+    readonly url: "https://store.astm.org/d0523-25.html";
+}, {
+    readonly role: "construction-classification";
+    readonly url: "https://uniclass.thenbs.com/";
+}, {
+    readonly role: "construction-classification";
+    readonly url: "https://www.csiresources.org/standards/overview";
+}, {
+    readonly role: "controlled-vocabulary";
+    readonly url: "https://www.getty.edu/research/tools/vocabularies/aat/about.html";
+}];
+/** Revisioned separately so adding consumer policy cannot silently change concept meanings. */
+export declare const ASSESSMENT_POLICY_REVISION: `sha256:${string}`;

package/dist/authoring.d.ts

@@ -19,7 +19,7 @@ export declare const PROVENANCE: {
     readonly snapshot: "2026-07-08";
     readonly source: "value dictionaries in a materials-retrieval system (src-05)";
 };
-export { KNOWLEDGE_GRAPH, LEXICAL_ENTRIES, TAXONOMY_BASE_URI, type AxisNode, type CanonicalConceptUri, type ColorScopeTarget, type ConceptNode, type ExternalReference, type FacetNode, type GraphPredicate, type KnowledgeGraph, type KnowledgeGraphEdge, type KnowledgeGraphNode, type LexicalEntry, type LexicalContext, type LexicalTarget, type Lifecycle, type Governance, TAXONOMY_SNAPSHOT, type TaxonomyTarget, } from "./v1.js";
+export { KNOWLEDGE_GRAPH, PHRASE_ENTRIES, TAXONOMY_BASE_URI, type AxisNode, type CanonicalConceptUri, type ColorScopeTarget, type ConceptNode, type ExternalReference, type FacetNode, type GraphPredicate, type KnowledgeGraph, type KnowledgeGraphEdge, type KnowledgeGraphNode, type PhraseEntry, type MeaningContext, type PhraseMeaning, type Lifecycle, type Governance, TAXONOMY_SNAPSHOT, type TaxonomyTarget, } from "./v1.js";
 export declare const MATERIAL_FAMILIES: readonly ["paint", "wall-finish", "wallcovering", "textile", "upholstery", "carpet", "wood", "stone", "tile", "terrazzo", "metal", "glass", "resilient-flooring", "composite", "concrete", "leather", "other"];
 export type MaterialFamily = (typeof MATERIAL_FAMILIES)[number];
 export declare const isMaterialFamily: (value: string) => value is MaterialFamily;

package/dist/axes/axis.d.ts

@@ -11,8 +11,8 @@ export type FacetHolds = "one" | "several";
 export interface AxisFacet {
     governance?: AxisGovernance;
     /**
-     * `one` means a thing has a single reading of this facet. `several` means each stated term is a
-     * separate reading, never a span between two of them. Optional: a facet that has not been decided
+     * `one` means a thing has a single meaning of this facet. `several` means each stated term is a
+     * separate meaning, never a span between two of them. Optional: a facet that has not been decided
      * says nothing, and a consumer must not read silence as either answer.
      */
     holds?: FacetHolds;

package/dist/axes/space.d.ts

@@ -47,7 +47,7 @@ export declare const SPACE_TERMS: readonly Term[];
  *
  * THE ACCESSOR EXISTS SO THE INHERITANCE IS NOT REINVENTED. A `serves` edge restricts every
  * descendant - each suite is a hotel room, so each suite serves hospitality - and a consumer
- * reading raw edges would see `suite` carrying none and read it as unrestricted. The walk stops at
+ * meaning raw edges would see `suite` carrying none and read it as unrestricted. The walk stops at
  * the NEAREST edge-bearing ancestor, because a child's own edges are a narrower claim that
  * replaces the inherited one rather than adding to it (`training_room` serves workplace inside a
  * neutral `classroom`).

package/dist/axes/tier.d.ts

@@ -1,6 +1,6 @@
 import type { Term } from "../term.js";
 /**
- * The positioning ladder. Where a maker, a product line or a project sits in the market, as a
+ * The positioning ladder. Where a brand, a product line or a project sits in the market, as a
  * judgement anyone in the trade would recognise.
  *
  * The five values a materials-retrieval system's brand extractor is instructed to choose between, minus

package/dist/canonicalisation.d.ts

@@ -26,7 +26,7 @@ export interface ResolvedCanonicalisation extends CanonicalisationBase {
 export interface AmbiguousCanonicalisation extends CanonicalisationBase {
     status: "ambiguous";
     alternatives: CanonicalAlternatives;
-    /** How strongly each alternative would stand for the source value, were it the right reading. */
+    /** How strongly each alternative would stand for the source value, were it the right meaning. */
     match: MatchStrength;
     note?: string;
 }

package/dist/crossover-sources.d.ts

@@ -1,4 +1,4 @@
-export declare const RETRIEVAL_LEXICON_SOURCE = "colour-material lexicon in a materials-retrieval system (src-05)";
+export declare const RETRIEVAL_LEXICON_SOURCE = "color-material lexicon in a materials-retrieval system (src-05)";
 export declare const COLORSCOPE_CROSSOVER_SOURCE = "materialinstruments/colorscope@5feb29b267a7954c135976ede8039f37121afd27:packages/core/data/reference/v1/taxonomy.json";
 export declare const BRASS_MATERIAL_SOURCE = "https://archive.copper.org/applications/industrial/DesignGuide/terms.php";
 export declare const BRASS_FINISH_SOURCE = "https://nickelinstitute.org/media/lxxh1zwr/2023-nickelplatinghandbooka5_printablepdf.pdf section 5";

package/dist/crosswalks/mapping.d.ts

@@ -23,7 +23,7 @@ export declare const constitutive: (assertion: string) => CrosswalkMapping;
  * required: an approximation nobody had to justify is how a close match ships as an exact one.
  */
 export declare const approximates: (match: Exclude<MatchStrength, "exact">, note: string, ...assertions: readonly string[]) => CrosswalkMapping;
-/** The source is known to mean one of these and never recorded which. `match` grades each reading. */
+/** The source is known to mean one of these and never recorded which. `match` grades each meaning. */
 export declare const ambiguous: (match: MatchStrength, ...assertions: readonly string[]) => CrosswalkMapping;
 /** A curated refusal. Distinct from an absent row, which means nobody has looked. */
 export declare const declined: (reason: string) => CrosswalkMapping;

package/dist/estate/concepts.d.ts

@@ -29,10 +29,10 @@ export interface Concept {
      * on the same axis.
      *
      * NOT the repository count, and the difference started mattering the moment the paint-sample
-     * retailer joined the census. Its vocabulary is colour and nothing else, so it can never reach
+     * retailer joined the census. Its vocabulary is color and nothing else, so it can never reach
      * `style.rustic` and counting it against that row would report a disagreement where there is only
      * a different subject. Six repositories, but only five of them have anything to say about style, and only
-     * three about colour.
+     * three about color.
      */
     couldReach: number;
     cells: readonly ConceptCell[];
@@ -64,7 +64,7 @@ export interface AxisDisagreement {
  * The disagreement matrix, split one table per axis.
  *
  * ONE TABLE MIXING AXES IS SPARSE BY CONSTRUCTION, and the sparseness is not a finding. Each
- * repository speaks about some axes and not others: the paint-sample retailer's vocabulary is colour
+ * repository speaks about some axes and not others: the paint-sample retailer's vocabulary is color
  * and nothing else, so against every style concept it is a column of dashes. Rendered as one table that reads
  * as six repositories disagreeing when it is really six repositories talking about different
  * subjects, and it costs enough width to break the canonical identifiers across three lines.
@@ -104,7 +104,7 @@ export declare const agreementSummary: () => {
  * percentage.
  *
  * A SHARE AND NOT A COUNT, and the distinction is the whole reason this function exists rather than
- * a consumer reading `ROOM_SCHEME_STYLE_COUNTS` directly. The underlying figures are a third
+ * a consumer meaning `ROOM_SCHEME_STYLE_COUNTS` directly. The underlying figures are a third
  * party's catalogue volumes and are not ours to publish. The claim anything downstream actually
  * needs is that `Modern` and `Contemporary` sit at comparable volume and together account for a
  * large slice of the corpus - which a percentage carries exactly as well and a count carries no

package/dist/estate/decomposition.d.ts

@@ -4,7 +4,7 @@ export type Verdict =
 "decomposed"
 /** Decomposes, but the compound carries meaning the parts do not. Needs an anchor as well. */
  | "lossy"
-/** The canon can express both readings; the source cannot be safely mapped to one. Declines. */
+/** The canon can express both meanings; the source cannot be safely mapped to one. Declines. */
  | "ambiguous"
 /** A real term, but answering a question outside the interiors aesthetic axes. */
  | "out-of-axis"

package/dist/estate/residue-report.d.ts

@@ -15,7 +15,7 @@ export interface ResidueReport {
     /** `decomposed` as a share of `aesthetic`. TAX-14's threshold was 80 per cent. */
     cleanRate: number;
     /**
-     * The circularity guard. The axes here were authored after reading these terms, so the headline
+     * The circularity guard. The axes here were authored after meaning these terms, so the headline
      * rate is partly fitted to its own inputs. This is the share that decomposes onto canon that
      * existed BEFORE the test - vendored from the materials-retrieval system, colorscope and the
      * architecture-projects platform, or already published in this package. It is the floor the

package/dist/estate/sources.d.ts

@@ -97,10 +97,10 @@ export declare const PAINT_SAMPLE_COLOUR_COLLECTIONS: EstateVocabulary;
  * A standing fact, visible in this capture rather than asserted.
  *
  * THE PAINT-SAMPLE RETAILER IS A SAMPLING CHANNEL, NOT A PAINT BRAND. It prints peel-and-stick
- * sheets of other manufacturers' colours and manufactures nothing. Its own product index groups by
- * maker, and every maker is somebody else: the largest share of the catalogue sits in a
+ * sheets of other manufacturers' colors and manufactures nothing. Its own product index groups by
+ * brand, and every brand is somebody else: the largest share of the catalogue sits in a
  * `benjamin-moore` collection, then `sherwin-williams`, then `behr`. If a query ever returns the
- * retailer as the maker of a colour, the query is wrong and this is the evidence.
+ * retailer as the brand of a color, the query is wrong and this is the evidence.
  */
-export declare const PAINT_SAMPLE_MAKER_COLLECTIONS: readonly ["benjamin-moore", "sherwin-williams", "behr"];
+export declare const PAINT_SAMPLE_BRAND_COLLECTIONS: readonly ["benjamin-moore", "sherwin-williams", "behr"];
 export declare const ESTATE_VOCABULARIES: readonly EstateVocabulary[];

package/dist/index.d.ts

@@ -4,5 +4,6 @@
  * Identity is always a canonical HTTPS URI. The package exports declarative data and the types
  * needed to consume it; resolution, traversal, ranking, and search policy live in adapters.
  */
-export { type AxisNode, type CanonicalConceptUri, COLOR_SCOPE_REFERENCE_KINDS, type ColorScopeReferenceKind, type ColorScopeTarget, type ConceptNode, type ExternalReference, type FacetHolds, type FacetNode, type Governance, type GraphPredicate, type KnowledgeGraph, type KnowledgeGraphEdge, type KnowledgeGraphNode, KNOWLEDGE_GRAPH, type LexicalEntry, type LexicalContext, LEXICAL_ENTRIES, type Lifecycle, type LifecycleStatus, type LexicalTarget, TAXONOMY_BASE_URI, TAXONOMY_CORPUS_METADATA, TAXONOMY_CORPUS_REVISION, TAXONOMY_SNAPSHOT, TAXONOMY_VERSION, type TaxonomyTarget, } from "./v1.js";
+export { ASSESSMENT_AUTHORITY_REFERENCES, ASSESSMENT_POLICY_REVISION, type AssessmentEvidenceRoute, type ConceptAssessmentPolicy, CONCEPT_ASSESSMENT_POLICIES, type MaterialApplicability, } from "./assessment-policy.js";
+export { type AxisNode, type CanonicalConceptUri, COLOR_SCOPE_REFERENCE_KINDS, type ColorScopeReferenceKind, type ColorScopeTarget, type ConceptNode, type ExternalReference, type FacetHolds, type FacetNode, type Governance, type GraphPredicate, type KnowledgeGraph, type KnowledgeGraphEdge, type KnowledgeGraphNode, KNOWLEDGE_GRAPH, type PhraseEntry, type MeaningContext, type MeaningPriority, PHRASE_ENTRIES, type Lifecycle, type LifecycleStatus, type PhraseMeaning, TAXONOMY_BASE_URI, TAXONOMY_CORPUS_METADATA, TAXONOMY_CORPUS_REVISION, TAXONOMY_SNAPSHOT, TAXONOMY_VERSION, type TaxonomyTarget, } from "./v1.js";
 export type { ElementPlacement, PeriodSpan, SearchedWithout, StyleKind, TermProvenance, TermUsage, UsageWithheld, } from "./term.js";