Revert "refactor(describer): structure-driven prose (port from earlier branch)"

removing the describer functionality from the main branch, as it is not yet ready for production use.
This reverts commit fc7ada9.

Author: r-fedorov

README.md

@@ -87,26 +87,18 @@ for step in analysis.decisions:
 
 ### Natural-language description (`describe`)
 
-`bluenamer.describe(smiles)` emits structure-driven, reconstructable
-prose about the molecule: the parent skeleton, heteroatoms, unsaturation,
-stereochemistry, substituents, and connectivity for atom-by-atom
-rebuilding. Useful for explainability views and for generating
-(SMILES, name, description) training tuples:
+`bluenamer.describe(smiles)` walks the same trace and renders a
+deterministic, multi-paragraph explanation of how the name is built.
+Useful for explainability views and for generating (SMILES, name,
+description) training tuples:
 
 ```python
 from bluenamer import describe
 
-d = describe("CCO")
-print(d)
-# The molecule is built around a 2-atom carbon chain. Within that parent
-# framework, all parent-chain bonds are single. Attached to the parent is
-# a hydroxy group at position 1. For reconstruction, number the parent
-# as follows: 1-2 single.
-
-d.facts[0].parent_summary       # 'a 2-atom carbon chain'
-d.facts[0].substituents         # ('a hydroxy group at position 1',)
-d.facts[0].connectivity         # ('1-2 single',)
-d.name                          # 'ethanol'  (handy, from the namer)
+d = describe("CC(=O)Nc1ccccc1")
+print(d)            # multi-paragraph prose
+d.rules_hit         # ('P-44', 'P-45', 'P-41', 'P-61', 'P-67')
+d.components[0]     # DescribedComponent(phase='parse', text='RDKit parsed ...')
 ```
 
 Same input → same output. No LLM in the loop.

src/bluenamer/__init__.py

@@ -2,7 +2,7 @@
 
 from collections.abc import Iterable
 
-from .describer import Description, DescriptionFacts, describe
+from .describer import DescribedComponent, Description, describe
 from .engine import DEFAULT_NAMING_ENGINE, NamingEngine, NamingRequest, NamingResult
 from .functional_groups import register_group_detector
 from .molecule import (
@@ -69,8 +69,8 @@ def name_many(
     "AtomBinding",
     "BondBinding",
     "DecisionTrace",
+    "DescribedComponent",
     "Description",
-    "DescriptionFacts",
     "FunctionalGroupMetadata",
     "NameAnalysis",
     "NamingEngine",

src/bluenamer/cli.py

@@ -92,7 +92,7 @@ def _cmd_describe(args: argparse.Namespace) -> int:
         sys.stdout.write("\n")
     else:
         sys.stdout.write(str(description) + "\n")
-    return 0 if description.text else 1
+    return 0 if description.name else 1
 
 
 def _build_parser() -> argparse.ArgumentParser: