Models-Phi-8B/docs/claims-and-terminology.md

4.6 KiB

Terminology and verified claims

The generator combines medical category values with curated positive and negative contextual patterns. It deterministically shuffles category values, patterns, explicit subjects, and requested tenses, then uses LM Studio to normalize grammar while preserving the protected medical concept and the example's polarity. Patterns without an explicit subject remain subjectless fragments; the normalizer assumes an implied singular member/patient only for grammar and must not add that subject to the text.

The project uses Category as its taxonomy term because the labels are intended to integrate with a Presidio category/entity-type extension or override. This repository contains the category-based generator and model training pipeline, but the Presidio integration itself is maintained elsewhere or has not yet been added here.

Positive and negative contexts teach the model that a medical word alone is insufficient. “Has diabetes” and “he had a reaction to shellfish” are intended positives, while “she wrote a book about diabetes” and “had a reaction to the horrible cover of Van Halen's Jump” are intended negatives.

Review of the original statements

“The Generator uses random subject, verb, etc.”

Mostly correct, with precision needed.

  • It shuffles values, patterns, subjects, and a tense deck with a seeded pseudorandom generator.
  • Subjects are He, She, They, and Member.
  • It does not simply select arbitrary verbs. Patterns supply grammar expressions and sentence structure; local logic and LM Studio resolve/rewrite auxiliaries and verb phrases for subject/tense.
  • [x] starts with the canonical value. Allowed variants are supplied to the normalizer, rather than directly sampled as an independent random deck.
  • Planning is repeatable for unchanged seed/input/configuration; the external LM service is a remaining reproducibility variable.

“It creates context for positive and negative tuning examples.”

Correct.

Every category has explicit positive and negative pattern files. The label is stored on each generated item and carried through export, SFT conversion, training, and evaluation.

“Categories instead of Nodes/Edges because of Presidio.”

Reasonable design intent, not verifiable integration in this repository.

The implementation consistently uses categories/entity types, and that is an appropriate vocabulary for a Presidio recognizer extension. There is no graph model in this code, so “nodes/edges” would be misleading. However, no Presidio package, recognizer, registry, mapping, or runtime call is checked in. Phrase this as intended compatibility/integration, not as a current in-repository dependency.

“Without a subject, or if a sentence fragment, it assumes the member is the subject.”

Correct only when qualified.

The implementation marks patterns without [sub] as fragments and does not insert Member. The normalizer uses an implied singular member/patient for agreement and tense only, and must preserve a subjectless output. Member is also one explicit choice in the subject deck when [sub] is present.

Preferred wording:

Subjectless patterns are treated as fragments. For grammar only, the normalizer assumes an implied singular member/patient but does not add that subject to the generated text.

Context examples

They correctly express the intended distinction.

The medical term or word “reaction” is not enough by itself. Actual patient medical assertions are positive; authored/educational or idiomatic non-medical uses are negative. These exact examples should also become automated golden tests if they are contractual behavior.

Category versus entity type

  • Category is the generator/database taxonomy object.
  • Entity type is the name emitted in model JSON.
  • Both currently use the same 12 MEDICAL_* identifiers.
  • Keyword is a canonical medical value assigned to a category.
  • Variant is an allowed surface/grammatical form of a keyword.
  • Pattern supplies contextual structure and polarity.
  • Training item is the resulting labeled text.

What not to claim

Avoid saying:

  • the model is a keyword matcher;
  • all category variants are randomly selected;
  • Member is inserted whenever a subject is absent;
  • this repository contains a working Presidio integration;
  • the tracked pipeline produces GGUF;
  • the current model extracts exact medical spans;
  • deterministic planning guarantees identical external LM responses;
  • NIH, WHO, or CDC endorse this project.