@mailwoman/neural-weights-fr-fr 10.2.2 → 10.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/PROVENANCE.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$comment": "Generated by `mwops release write-rights-files` from package.json and model-card.json. Edit the generator or those files, never this one.",
3
3
  "package": "@mailwoman/neural-weights-fr-fr",
4
- "package_version": "10.0.0",
4
+ "package_version": "10.3.0",
5
5
  "license": "AGPL-3.0-only OR LicenseRef-Commercial",
6
6
  "model_card_version": "6.5.0",
7
7
  "version_series": "overlay",
@@ -9,8 +9,8 @@
9
9
  "base_weights": "@mailwoman/neural-weights-en-us",
10
10
  "inherited_lineage": {
11
11
  "package": "@mailwoman/neural-weights-en-us",
12
- "package_version": "10.0.0",
13
- "model_card_version": "9.1.0",
12
+ "package_version": "10.3.0",
13
+ "model_card_version": "10.1.0",
14
14
  "chain": ["@mailwoman/neural-weights-fr-fr", "@mailwoman/neural-weights-en-us"],
15
15
  "note": "These entries are @mailwoman/neural-weights-en-us's record of what its model graph was trained on. This package ships no graph and contributed none of these rows. Read them as the base's lineage rather than as a claim about this package's own artifacts, which are listed under artifacts and attributed under training_attribution.",
16
16
  "attribution": [
package/README.md CHANGED
@@ -37,7 +37,7 @@ model-index:
37
37
  The trained-model bundle (`@mailwoman/neural-weights-fr-fr`) for
38
38
  [Mailwoman](https://mailwoman.ai), a postal-address parser. This
39
39
  package is **data only** — `model.onnx`, `tokenizer.model`, and metadata. It has
40
- no JavaScript; it is loaded at inference time by `@mailwoman/neural`.
40
+ no JavaScript. It is loaded at inference time by `@mailwoman/neural`.
41
41
 
42
42
  > **This locale is served by the shared multi-locale model.** The fr-fr bundle
43
43
  > ships the same encoder as the en-us release at an earlier checkpoint
@@ -50,14 +50,13 @@ Mailwoman is a **calibrated, retrieval-augmented sequence labeler over a
50
50
  microlanguage** — coupled to a gazetteer that resolves its output to
51
51
  coordinates. This bundle is the sequence-labeler half: a small transformer
52
52
  encoder doing BIO token classification over the address schema. It is not an LLM
53
- and none of it is generative; for a closed label set over short strings,
54
- boring NER is a feature.
53
+ and none of it is generative. Plain NER suits a closed label set over short strings.
55
54
 
56
55
  The design splits the problem in two: **the model learns the grammar, the
57
56
  gazetteer knows the atlas.** The model never memorizes place names — postcode
58
57
  and gazetteer knowledge arrive at inference as _soft input features_ (anchors)
59
58
  retrieved from provenance-tracked databases that grow without retraining.
60
- Knowledge informs; it never overrides.
59
+ These features inform the model's prediction and never override it.
61
60
 
62
61
  - **Base model:** none. Trained **from scratch** (no pretrained checkpoint).
63
62
  - **Tokenizer:** SentencePiece unigram, `byte_fallback=true`.
@@ -95,18 +94,18 @@ are the multi-locale model's strong FR tags, **anchor-on, canonical order**. Two
95
94
  known gaps on the FR numbers:
96
95
 
97
96
  - **FR `region` is a known open gap** — F1 is low and tracked as an outstanding
98
- issue; do not expect region-level accuracy on FR comparable to en-us.
97
+ issue. Do not expect region-level accuracy on FR comparable to en-us.
99
98
  - **Reversed-order (postcode-first) FR house numbers are harder.** On a
100
99
  diversified golden that mixes both orders, house_number drops well below the
101
100
  canonical-order figure — the published frontier for reordered house numbers is
102
101
  ~90–91% (neural parsers collapse much further on reorder). The en-us release's
103
- later checkpoint adds a reversed-order training subset that recovers this; this fr-fr
102
+ later checkpoint adds a reversed-order training subset that recovers this. This fr-fr
104
103
  bundle predates that change.
105
104
 
106
105
  Because the older anchor-off / pre-diversified-golden figures in this bundle's
107
106
  `model-card.json` `eval` block were measured before the anchor-on grading
108
- discipline, treat them as historical; the per-tag parity tables under
109
- [`docs/articles/evals/`](https://mailwoman.ai) carry the
107
+ discipline, treat them as historical. The per-tag parity tables under
108
+ [`docs/articles/evals/`](https://mailwoman.ai) hold the
110
109
  config-stated numbers.
111
110
 
112
111
  ## Calibration
@@ -118,10 +117,10 @@ output is byte-stable when calibration is omitted.
118
117
  ## Train
119
118
 
120
119
  From-scratch (no pretrained base) on an NVIDIA A100 (Modal cloud), CE loss only
121
- (the dual CRF loss diverged and was retired; CRF is inference-only Viterbi). The
122
- gazetteer anchor channel is fed during training, which is why it is required at
123
- inference. This bundle is the shared multi-locale model (step 20000); the en-us
124
- card carries the full corpus + recipe provenance.
120
+ (the dual CRF loss diverged and was retired, and CRF is inference-only Viterbi). The
121
+ gazetteer anchor channel is fed during training, so it is required at
122
+ inference. This bundle is the shared multi-locale model (step 20000). The en-us
123
+ card records the full corpus + recipe provenance.
125
124
 
126
125
  ## Limitations
127
126
 
@@ -131,8 +130,8 @@ card carries the full corpus + recipe provenance.
131
130
  _Evaluation_).
132
131
  - **All-caps / shouting input degrades** the admin tags (mixed-case training);
133
132
  `@mailwoman/neural`'s `normalizeCase` opt recovers detected all-caps ASCII.
134
- - **Non-Latin scripts** (CJK, Cyrillic) fall through to byte-fallback tokens;
135
- quality there is unmeasured.
133
+ - **Non-Latin scripts** (CJK, Cyrillic) fall through to byte-fallback tokens,
134
+ and quality there is unmeasured.
136
135
 
137
136
  ## License & links
138
137
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mailwoman/neural-weights-fr-fr",
3
- "version": "10.2.2",
3
+ "version": "10.4.0",
4
4
  "description": "Mailwoman neural-classifier weights for locale 'fr-fr'. Data-only overlay — shares the base model.onnx + tokenizer.model from @mailwoman/neural-weights-en-us (they are byte-identical); ships only the fr-specific data siblings. Loaded by @mailwoman/neural at runtime.",
5
5
  "license": "AGPL-3.0-only OR LicenseRef-Commercial",
6
6
  "repository": {
@@ -42,11 +42,11 @@
42
42
  }
43
43
  },
44
44
  "dependencies": {
45
- "@mailwoman/neural-weights-en-us": "10.2.2"
45
+ "@mailwoman/neural-weights-en-us": "10.4.0"
46
46
  },
47
47
  "devDependencies": {
48
- "@mailwoman/core": "10.2.2",
49
- "@mailwoman/resolver-wof-sqlite": "10.2.2"
48
+ "@mailwoman/core": "10.4.0",
49
+ "@mailwoman/resolver-wof-sqlite": "10.4.0"
50
50
  },
51
51
  "mailwoman": {
52
52
  "baseWeights": "@mailwoman/neural-weights-en-us"