@cosyte/script-utils 0.1.4 → 0.1.5

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.1.5
+
+### Patch Changes
+
+- f5e1a1f: The internal-refs phase rule lets two kinds of ordinary prose through. `phase` as the second half of a compound word is no longer a hit (`connect-phase socket`, `two-phase state`, `read-phase timeout`), and neither is `phase` or `phases` followed by `where`, `are`, `was`, `were`, `during` or `at` (`All 5 phases are defined`, `Connection lifecycle phase where the error occurred`). A phase named beside those words is still a hit (`shipped in phase 2`, `Phase 3 was where it failed`, `Phase-L`), and both guards' passages are in the rule's self-test floor, so every run proves them. The catalog is regenerated from each library's current package.json: the terminology, deid and synth descriptions take the serial comma, the cli record carries cli's current description, and cli's engines are `>=22.0.0`.
+
 ## 0.1.4
 
 ### Patch Changes

package/catalog.json

@@ -116,7 +116,7 @@
     {
       "name": "@cosyte/terminology",
       "slug": "terminology",
-      "description": "Terminology engine for US healthcare code systems in Node.js and TypeScript: FHIR $translate, $lookup, $validate-code and $expand over code systems, value sets and maps you supply.",
+      "description": "Terminology engine for US healthcare code systems in Node.js and TypeScript: FHIR $translate, $lookup, $validate-code, and $expand over code systems, value sets, and maps you supply.",
       "line": "0.1",
       "engines": {
         "node": ">=22.0.0"
@@ -142,7 +142,7 @@
     {
       "name": "@cosyte/deid",
       "slug": "deid",
-      "description": "Healthcare de-identification for Node.js and TypeScript: applies a HIPAA Safe Harbor policy to HL7 v2, C-CDA, FHIR R4, X12, NCPDP Telecom and DICOM, fails closed, and emits a value-free manifest.",
+      "description": "Healthcare de-identification for Node.js and TypeScript: applies a HIPAA Safe Harbor policy to HL7 v2, C-CDA, FHIR R4, X12, NCPDP Telecom, and DICOM, fails closed, and emits a value-free manifest.",
       "line": "0.1",
       "engines": {
         "node": ">=22.0.0"
@@ -155,7 +155,7 @@
     {
       "name": "@cosyte/synth",
       "slug": "synth",
-      "description": "Deterministic, seedable synthetic healthcare test fixtures for Node.js and TypeScript: HL7 v2, FHIR R4 and US Core, C-CDA, X12, NCPDP and ASTM, spec-clean by construction and never real PHI.",
+      "description": "Deterministic, seedable synthetic healthcare test fixtures for Node.js and TypeScript: HL7 v2, FHIR R4 and US Core, C-CDA, X12, NCPDP, and ASTM, spec-clean by construction and never real PHI.",
       "line": "0.1",
       "engines": {
         "node": ">=22.0.0"
@@ -181,10 +181,10 @@
     {
       "name": "@cosyte/cli",
       "slug": "cli",
-      "description": "The cosyte CLI: a PHI-safe developer front door over the @cosyte/* healthcare parsers. Parse HL7 v2 / FHIR from a file or stdin to typed JSON, with a documented exit-code contract.",
+      "description": "The Cosyte command line for Node.js and TypeScript: one command over HL7 v2, FHIR R4, X12, ASTM, NCPDP, C-CDA, DICOM, and MLLP, with HL7 v2 to FHIR conversion from transform, code mapping from terminology, and the cosyte-mcp MCP server for agents. Value-free diagnostics and a documented exit-code contract.",
       "line": "0.1",
       "engines": {
-        "node": ">=22.0.0 <26.0.0"
+        "node": ">=22.0.0"
       },
       "repository": "https://github.com/cosyte/cli",
       "docs": "https://docs.cosyte.com/cli",

package/internal-refs.js

@@ -230,10 +230,28 @@ const PHASE_NOT_CLINICAL =
   "(?<!study )(?<!clinical )(?<!trial )(?<!acute )(?<!chronic )(?<!luteal )(?<!follicular )" +
   "(?<!liquid )(?<!gas )";
 
-/** Lookahead that drops the clinical-study field-name tails and the trial roman numerals. */
+/**
+ * Lookbehind that drops `phase` as the second half of a compound word.
+ *
+ * `connect-phase socket`, `two-phase state` and `read-phase timeout` describe a protocol, not a
+ * roadmap: a letter and a hyphen in front of `phase` make it part of an adjective. Only the
+ * characters BEFORE the word are read, so `Phase-L` (the hyphen after it) is still a hit, and so is
+ * a phase after a digit and a hyphen.
+ */
+const PHASE_NOT_COMPOUND = "(?<![A-Za-z]-)";
+
+/**
+ * Lookahead that drops the clinical-study field-name tails, the trial roman numerals, and the
+ * words that make `phase` a noun in a sentence rather than the name of one.
+ *
+ * `All 5 phases are defined`, `the lifecycle phase where the error occurred`, `the phase was`, `the
+ * phases were`, `the phase during which` and `the phase at which` say what a phase is. A roadmap
+ * phase is named by what follows the word, and none of these words names one.
+ */
 const PHASE_NOT_FIELD =
   "(?!of\\b|with\\b|in\\b|out\\b|the\\b|and\\b|is\\b|for\\b|to\\b|identifier\\b|start\\b|end\\b|" +
-  "evaluability\\b|number\\b|(?:I{1,3}|IV)\\s+(?:trial|stud|clinical|oncolog))";
+  "evaluability\\b|number\\b|where\\b|are\\b|was\\b|were\\b|during\\b|at\\b|" +
+  "(?:I{1,3}|IV)\\s+(?:trial|stud|clinical|oncolog))";
 
 /**
  * Imaging vocabulary that follows `slice` in reference material rather than in our jargon.
@@ -340,7 +358,8 @@ export function compileCanonicalRules(resolved) {
       name: "phase or wave language",
       patterns: [
         new RegExp(
-          `\\b(?:roadmap phases?\\b[ ]?[A-Za-z0-9]*|${PHASE_NOT_CLINICAL}phases?[ -]${PHASE_NOT_FIELD}` +
+          `\\b(?:roadmap phases?\\b[ ]?[A-Za-z0-9]*|${PHASE_NOT_CLINICAL}${PHASE_NOT_COMPOUND}phases?[ -]` +
+            `${PHASE_NOT_FIELD}` +
             `[A-Za-z0-9]+[a-z]?\\b|wave \\d+\\b|the \\w+ and final phase\\b|` +
             `documentation residual\\b|${ORDINAL} (?:slice|wave)\\b)`,
           "gi",
@@ -350,12 +369,22 @@ export function compileCanonicalRules(resolved) {
         "Phase 5b closes it (Phase W, Phase-L and the thirteenth slice landed earlier, in wave 2)",
         // The plural, which ten of the eleven per-repository copies matched (`phases?[ -]`).
         "Phases 1 to 6 shipped together",
+        // What the two guards must still catch: a phase named next to a compound word, and a
+        // phase named before the words that make a bare `phase` a noun.
+        "The connect-phase socket shipped in phase 2",
+        "Phase 3 was where the error occurred",
       ],
       negatives: [
         "CSP-1 Study Phase Identifier, CSP-2 Study Phase Start Date/Time, CSP-3 Study Phase End " +
           "Date/Time, CSP-4 Study Phase Evaluability; a Phase III oncology trial and a Phase II " +
           "study; the acute phase reactant; the adapter stays in phase with the source system " +
           "and is out of phase",
+        // The compound-word guard: `phase` as the second half of an adjective.
+        "The connect-phase socket, the two-phase state and the read-phase timeout",
+        // The sentence guard: `phase` as a noun followed by what it is, not by its name.
+        "All 5 phases are defined; Connection lifecycle phase where the error occurred; the " +
+          "phase was open, the phases were closed, and a phase during which and a phase at which " +
+          "the socket failed",
       ],
     },
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosyte/script-utils",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Zero-dependency helpers for the repo-local gate scripts in @cosyte/* repos.",
   "keywords": [
     "cli",
@@ -98,7 +98,7 @@
     "access": "public"
   },
   "devDependencies": {
-    "vitest": "4.1.4"
+    "vitest": "4.1.12"
   },
   "scripts": {
     "build": "node ../../scripts/pack-emdash-gate.mjs",