feat: add synthetic/simulant origin awareness to plugin

Bissbert · claude · Bissbert · commit 988f5f2dd527 · 2026-02-14T14:05:27.000+07:00
- Re-export list_synthetics, list_simulants, get_counterparts from mineral-database
- CLI: list-presets shows origin badges, --origin/--synthetics/--simulants filters
- CLI: info command displays origin, growth method, diagnostic features
- /crystal-svg: documents synthetic presets, handles null CDL gracefully
- /identify-gem: queries counterparts, checks diagnostic synthetic features
- synthetics-simulants skill: references database preset IDs, expanded coverage
- inclusions-fingerprints skill: added CVD/HPHT diamond inclusion cross-references
- gemmology-expert agent: origin-aware identification and proactive counterpart mentions
- Version bumped to 1.1.0

Co-Authored-By: Claude Opus 4.6 &lt;noreply@anthropic.com&gt;
diff --git a/.claude/agents/gemmology-expert.md b/.claude/agents/gemmology-expert.md
@@ -109,6 +109,61 @@ Before completing any task:
 - [ ] Pleochroism description matches optical character
 - [ ] Data follows FGA curriculum conventions
 
+## Origin Awareness (Synthetics and Simulants)
+
+The mineral database now includes synthetic and simulant presets alongside natural gems. Be aware of the `origin` field and use it proactively:
+
+### Key Principles
+
+- **When asked about a natural gem**: Proactively mention available synthetic and simulant counterparts. For example, if discussing ruby, note that flame fusion, flux, and hydrothermal synthetics exist and can be queried.
+- **When identifying an unknown stone**: Always consider both natural and synthetic matches. A stone matching ruby's RI/SG could be natural or synthetic -- check inclusions and growth features to differentiate.
+- **When adding new presets**: Set the `origin` field appropriately (`natural`, `synthetic`, or `simulant`) and populate synthetic-specific fields when applicable.
+
+### Query Functions
+
+```python
+from mineral_database import list_synthetics, list_simulants, get_counterparts, list_by_origin
+
+# List all synthetic presets
+synthetics = list_synthetics()
+
+# List all simulant presets
+simulants = list_simulants()
+
+# Get all synthetics and simulants for a given natural gem
+counterparts = get_counterparts("ruby")  # Returns synthetic rubies + ruby simulants
+
+# Filter presets by origin
+natural_only = list_by_origin("natural")
+synthetic_only = list_by_origin("synthetic")
+simulant_only = list_by_origin("simulant")
+```
+
+### Synthetic Preset Fields
+
+When working with synthetic or simulant presets, these additional fields may be present:
+
+| Field | Description | Example |
+|-------|-------------|---------|
+| `origin` | `natural`, `synthetic`, or `simulant` | `synthetic` |
+| `growth_method` | Manufacturing process | `Verneuil (flame fusion)` |
+| `natural_counterpart_id` | Preset ID of the natural equivalent | `ruby` |
+| `manufacturer` | Producer name(s) | `Chatham` |
+| `year_first_produced` | First commercial production year | `1902` |
+| `diagnostic_synthetic_features` | List of identification indicators | `["curved striae", "gas bubbles"]` |
+
+### CLI Commands
+
+```bash
+# Filter by origin
+gemmology list-presets --origin synthetic
+gemmology list-presets --origin simulant
+
+# View synthetic/simulant details
+gemmology info synthetic-ruby-verneuil
+gemmology info cubic-zirconia
+```
+
 ## Common Tasks
 
 ### Adding a New Gemstone Preset
diff --git a/commands/crystal-svg.md b/commands/crystal-svg.md
@@ -124,6 +124,28 @@ system[point_group]:{hkl}@distance + {hkl}@distance
 - **Tetragonal**: zircon, rutile
 - **Monoclinic**: kunzite, malachite, jadeite
 
+### Synthetic and Simulant Presets
+
+Synthetic and simulant presets are also available:
+
+```bash
+# Synthetic presets
+gemmology crystal-svg --preset synthetic-ruby-verneuil -o /tmp/synth-ruby.svg
+gemmology crystal-svg --preset synthetic-emerald-flux -o /tmp/synth-emerald.svg
+
+# Simulant presets
+gemmology crystal-svg --preset cubic-zirconia -o /tmp/cz.svg
+gemmology crystal-svg --preset moissanite -o /tmp/moissanite.svg
+
+# List all synthetics or simulants
+gemmology list-presets --origin synthetic
+gemmology list-presets --origin simulant
+```
+
+**Note:** Some synthetic presets (e.g., flame fusion boules) have no CDL expression because the growth form is not a natural crystal habit. In this case, the tool will display an informational message instead of generating a visualization. Use `gemmology info <preset>` to view the preset's properties.
+
+When `--info-fga` is used with a synthetic or simulant preset, the info panel will include the origin (synthetic/simulant) and growth method (e.g., Verneuil, flux, hydrothermal) alongside the standard gemmological properties.
+
 ## Available Twin Laws
 
 spinel, japan, brazil, dauphine, carlsbad, baveno, manebach, albite, trilling, fluorite, iron_cross, staurolite_60, staurolite_90
diff --git a/commands/identify-gem.md b/commands/identify-gem.md
@@ -113,6 +113,17 @@ After each test, update the list of possible identifications:
 3. **Narrow by optical character** - SR or DR?
 4. **Narrow by pleochroism** - Expected for this species?
 5. **Confirm with spectrum/UV** - Matches expected?
+6. **Check for synthetic/simulant counterparts** - After narrowing candidates by RI and SG, query `get_counterparts()` from mineral_database to list which synthetics and simulants share those values. This helps identify look-alikes.
+
+### Could This Be Synthetic?
+
+Once a species match is established, consider whether the stone could be synthetic:
+
+1. **Examine inclusions** - Check for diagnostic synthetic features (curved striae, gas bubbles, flux veils, chevron growth, seed plates). The `diagnostic_synthetic_features` field in the mineral database lists known indicators for each synthetic type.
+2. **Growth pattern analysis** - Straight/angular = natural; curved = flame fusion; chevron = hydrothermal.
+3. **Cleanliness** - Suspiciously clean stones of a species that is typically included (e.g., emerald) warrant further investigation.
+4. **UV fluorescence** - Synthetics may fluoresce more strongly or differently than natural counterparts.
+5. **Query the database** - Use `get_counterparts("<species>")` to see all known synthetic and simulant matches, including their growth methods and diagnostic features.
 
 ## Common Separation Problems
 
diff --git a/pyproject.toml b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "gemmology-plugin"
-version = "1.0.2"
+version = "1.1.0"
 description = "Claude Code plugin for coloured gemstone expertise and crystal visualization"
 readme = "README.md"
 license = { text = "MIT" }
diff --git a/skills/inclusions-fingerprints/SKILL.md b/skills/inclusions-fingerprints/SKILL.md
@@ -243,6 +243,35 @@ Fine needle-like inclusions, often rutile in corundum.
 | Platinum platelets | Flame-fusion |
 | Too clean | Suspect all types |
 
+**Database integration:** Each synthetic preset in the mineral database includes a `diagnostic_synthetic_features` field listing the key inclusion/growth indicators for that specific growth method. Query with `get_preset("<synthetic-id>")` or `mineral-db --info <id>` to retrieve the feature list.
+
+### CVD and HPHT Diamond Inclusions
+
+Lab-grown diamonds produced by Chemical Vapour Deposition (CVD) and High Pressure High Temperature (HPHT) methods have characteristic internal features:
+
+**HPHT Diamonds:**
+| Feature | Description |
+|---------|-------------|
+| Metallic flux inclusions | Iron, nickel, or cobalt alloy remnants from solvent/catalyst |
+| Colour zoning | Sector-dependent (cuboctahedral growth sectors) |
+| Graining | Internal strain patterns |
+| Phosphorescence | Some HPHT diamonds phosphoresce (blue/green) |
+| Magnetic response | Metallic inclusions may make stone weakly magnetic |
+
+**CVD Diamonds:**
+| Feature | Description |
+|---------|-------------|
+| Strain patterns | Banded birefringence under cross-polarised light |
+| Point inclusions | Small dark or metallic points (non-diamond carbon) |
+| Growth striations | Fine parallel lines from layered deposition |
+| Brown tint | Some as-grown CVD stones show brownish hue (removable by HPHT treatment) |
+| Inscriptions | Many have laser-inscribed girdle identification |
+
+**Detection notes:**
+- Standard gemmological testing (RI, SG, thermal) cannot distinguish lab-grown from natural diamond -- both are carbon with identical properties.
+- Advanced techniques required: DiamondView (fluorescence imaging), photoluminescence spectroscopy, FTIR.
+- The `diagnostic_synthetic_features` field in the database lists method-specific indicators for CVD and HPHT presets.
+
 ## Microscopy Techniques
 
 ### Lighting Methods
diff --git a/skills/synthetics-simulants/SKILL.md b/skills/synthetics-simulants/SKILL.md
@@ -11,6 +11,37 @@ description: >-
 
 Guidance on identifying synthetic (laboratory-grown) gemstones and simulants (imitations). Understanding growth methods is key to detection.
 
+## Database Integration
+
+The mineral database contains preset entries for synthetics and simulants with structured data. Use the CLI or Python API to query them:
+
+```bash
+# List all synthetics and simulants
+mineral-db --origin synthetic
+mineral-db --origin simulant
+
+# Show counterparts for a natural gem (all known synthetics/simulants)
+mineral-db --counterparts ruby
+mineral-db --counterparts diamond
+
+# Get detailed info on a specific synthetic/simulant preset
+mineral-db --info synthetic-ruby-verneuil
+mineral-db --info cubic-zirconia
+mineral-db --info luag
+mineral-db --info synthetic-paraiba
+```
+
+Python API:
+```python
+from mineral_database import list_synthetics, list_simulants, get_counterparts, list_by_origin
+
+# Query functions
+list_synthetics()                # All synthetic preset IDs
+list_simulants()                 # All simulant preset IDs
+get_counterparts("ruby")         # Synthetics + simulants for ruby
+list_by_origin("synthetic")      # All presets with origin=synthetic
+```
+
 ## Terminology
 
 | Term | Definition | Example |
@@ -33,9 +64,9 @@ Guidance on identifying synthetic (laboratory-grown) gemstones and simulants (im
 3. Creates pear-shaped "boule"
 
 **Materials produced**:
-- Synthetic ruby
-- Synthetic sapphire (all colours)
-- Synthetic spinel
+- Synthetic ruby (preset: `synthetic-ruby-verneuil`)
+- Synthetic sapphire (all colours, preset: `synthetic-sapphire-verneuil`)
+- Synthetic spinel (preset: `synthetic-spinel-verneuil`)
 - Synthetic rutile
 - Star ruby/sapphire (with additives)
 
@@ -58,10 +89,10 @@ Guidance on identifying synthetic (laboratory-grown) gemstones and simulants (im
 - Produces crystals similar to natural
 
 **Materials produced**:
-- Flux emerald (Chatham, Gilson)
-- Flux ruby (Ramaura, Chatham)
+- Flux emerald (Chatham, Gilson; preset: `synthetic-emerald-flux`)
+- Flux ruby (Ramaura, Chatham; preset: `synthetic-ruby-flux`)
 - Flux sapphire
-- Flux alexandrite
+- Flux alexandrite (preset: `synthetic-alexandrite-flux`)
 - Flux spinel
 
 **Detection features**:
@@ -83,10 +114,10 @@ Guidance on identifying synthetic (laboratory-grown) gemstones and simulants (im
 - Mimics natural geological conditions
 
 **Materials produced**:
-- Hydrothermal emerald (Biron, Regency, Tairus)
-- Hydrothermal ruby
+- Hydrothermal emerald (Biron, Regency, Tairus; preset: `synthetic-emerald-hydrothermal`)
+- Hydrothermal ruby (preset: `synthetic-ruby-hydrothermal`)
 - Hydrothermal sapphire
-- Hydrothermal quartz (amethyst, citrine)
+- Hydrothermal quartz (amethyst, citrine; preset: `synthetic-quartz-hydrothermal`)
 
 **Detection features**:
 
@@ -112,9 +143,10 @@ Guidance on identifying synthetic (laboratory-grown) gemstones and simulants (im
 - Creates cylindrical crystal
 
 **Materials produced**:
-- Synthetic alexandrite
-- YAG (Yttrium Aluminium Garnet)
-- GGG (Gadolinium Gallium Garnet)
+- Synthetic alexandrite (preset: `synthetic-alexandrite-czochralski`)
+- YAG (Yttrium Aluminium Garnet; preset: `yag`)
+- GGG (Gadolinium Gallium Garnet; preset: `ggg`)
+- LuAG (Lutetium Aluminium Garnet; preset: `luag`) -- newer simulant with higher RI than YAG
 - Some laser crystals
 
 **Detection**:
@@ -124,7 +156,7 @@ Guidance on identifying synthetic (laboratory-grown) gemstones and simulants (im
 
 ### Skull Melting
 
-**Used for**: Cubic zirconia (CZ)
+**Used for**: Cubic zirconia (CZ; preset: `cubic-zirconia`)
 - Not relevant for coloured stone imitation
 - Diamond simulant
 
@@ -253,9 +285,10 @@ Not directly relevant for coloured stones but:
 | Sapphire | Glass, synthetic sapphire, synthetic spinel |
 | Emerald | Glass, GTD, triplets, synthetic emerald |
 | Alexandrite | Synthetic colour-change sapphire/spinel |
-| Paraiba | Apatite, glass, coated topaz |
+| Paraiba | Apatite, glass, coated topaz, synthetic Paraiba tourmaline (preset: `synthetic-paraiba`) |
 | Tanzanite | Synthetic forsterite, glass, iolite |
 | Jade | Serpentine, glass, dyed quartzite |
+| Diamond | CZ (preset: `cubic-zirconia`), moissanite (preset: `moissanite`), YAG (preset: `yag`), LuAG (preset: `luag`), GGG (preset: `ggg`) |
 
 ## Testing Protocol
 
diff --git a/skills/synthetics-simulants/references/simulant-properties.md b/skills/synthetics-simulants/references/simulant-properties.md
@@ -2,9 +2,12 @@
 
 Identification data for gemstone simulants.
 
+**Database integration:** All simulants with a database preset ID can be queried for full properties via `mineral-db --info <id>`. Properties shown below are for quick reference; the database is the authoritative source.
+
 ## Diamond Simulants
 
-### Cubic Zirconia (CZ)
+### Cubic Zirconia (CZ) {#cubic-zirconia}
+**Database ID:** `cubic-zirconia`
 
 | Property | Value | vs Diamond |
 |----------|-------|------------|
@@ -23,7 +26,8 @@ Identification data for gemstone simulants.
 - May show orange flash
 - Warm to touch (vs diamond cold)
 
-### Moissanite
+### Moissanite {#moissanite}
+**Database ID:** `moissanite`
 
 | Property | Value | vs Diamond |
 |----------|-------|------------|
@@ -42,7 +46,8 @@ Identification data for gemstone simulants.
 - Specific gravity lower
 - Needle-like inclusions possible
 
-### Synthetic Rutile
+### Synthetic Rutile {#synthetic-rutile}
+**Database ID:** `synthetic-rutile`
 
 | Property | Value | vs Diamond |
 |----------|-------|------------|
@@ -60,7 +65,8 @@ Identification data for gemstone simulants.
 - Yellow tint common
 - Historical simulant (1940s-50s)
 
-### YAG (Yttrium Aluminium Garnet)
+### YAG (Yttrium Aluminium Garnet) {#yag}
+**Database ID:** `yag`
 
 | Property | Value | vs Diamond |
 |----------|-------|------------|
@@ -76,6 +82,24 @@ Identification data for gemstone simulants.
 - Historical simulant (1960s-70s)
 - Largely replaced by CZ
 
+### LuAG (Lutetium Aluminium Garnet) {#luag}
+**Database ID:** `luag`
+
+| Property | Value | vs Diamond |
+|----------|-------|------------|
+| Composition | Lu₃Al₅O₁₂ | C |
+| RI | 1.842 | 2.42 |
+| SG | 6.73 | 3.52 |
+| Hardness | 8-8.5 | 10 |
+| Dispersion | 0.031 | 0.044 |
+
+**Detection**:
+- Higher RI than YAG but still much lower than diamond
+- Very high SG (noticeably heavy)
+- Isotropic
+- Less common than CZ or moissanite
+- Sometimes used as coloured stone simulant
+
 ### Strontium Titanate (Fabulite)
 
 | Property | Value | vs Diamond |
@@ -92,6 +116,11 @@ Identification data for gemstone simulants.
 - Historical simulant
 - Rarely seen today
 
+### GGG (Gadolinium Gallium Garnet) {#ggg}
+**Database ID:** `ggg`
+
+(Properties listed in main simulant tables above.)
+
 ### White Sapphire
 
 | Property | Value | vs Diamond |
@@ -323,12 +352,13 @@ Identification data for gemstone simulants.
 
 ### Common Confusion Pairs
 
-| Genuine | Common Simulant | Key Difference |
-|---------|-----------------|----------------|
-| Diamond | CZ | Thermal conductivity |
-| Diamond | Moissanite | Birefringence |
-| Ruby | Garnet | Optic character |
-| Ruby | Red spinel | RI, optic character |
-| Emerald | Tsavorite | RI (much higher) |
-| Sapphire | Blue spinel | RI, fluorescence |
-| Alexandrite | CC sapphire | RI, SG |
+| Genuine | Common Simulant | Key Difference | DB Query |
+|---------|-----------------|----------------|----------|
+| Diamond | CZ | Thermal conductivity | `mineral-db --info cubic-zirconia` |
+| Diamond | Moissanite | Birefringence | `mineral-db --info moissanite` |
+| Diamond | LuAG | RI, SG (very heavy) | `mineral-db --info luag` |
+| Ruby | Garnet | Optic character | |
+| Ruby | Red spinel | RI, optic character | |
+| Emerald | Tsavorite | RI (much higher) | |
+| Sapphire | Blue spinel | RI, fluorescence | |
+| Alexandrite | CC sapphire | RI, SG | |
diff --git a/src/gemmology_plugin/__init__.py b/src/gemmology_plugin/__init__.py
diff --git a/src/gemmology_plugin/cli.py b/src/gemmology_plugin/cli.py
