@myelinbridge/cli 0.11.1 → 0.12.0

package/README.md

@@ -43,6 +43,15 @@ npx @myelinbridge/cli push  ./run_042 --dataset onco1-wes --submit
   every later delivery reconciles against it — a partial delivery (93 of 96) is
   reported as a state, never as a failure.
 
+- **Your client's own fields show up, read-only (0.12.0).** Clients can define
+  their own metadata fields on datasets (a sponsor study code, a work order, a
+  therapeutic area). `contract` prints them under CLIENT FIELDS, and `check`
+  tells you when required ones are not filled in yet — informational only:
+  their team fills them in Myelin, there is nothing to change in your delivery,
+  and metadata never moves the exit code. In `--json`, datasets carry a
+  `metadata` object (`{key: {label, type, value}}`) and preflight carries
+  `metadata.missing_required`.
+
 - **A missing path in `roles set` is refused, not guessed (0.11.1).** Flags are
   not positional arguments: `roles set samplesheet --dataset onco1-wes` (path
   omitted) used to declare the samplesheet at the literal path `--dataset` and

package/bin/myelin.js

@@ -17,6 +17,12 @@
 // cannot validate either without deciding by hand, and hearing "all checks
 // pass" before uploading is the green-before-sending / red-after trap this
 // release exists to close.
+//
+// 0.12.0 — clients can define their own fields on datasets (sprint 22).
+// `contract` shows them read-only, and `check` reports the required ones the
+// client has not filled in yet — informational ONLY: metadata never moves the
+// exit code (the client fills these in Myelin; nothing for a partner to fix,
+// and a pipeline must never halt on it).
 
 import { readdirSync, statSync, createReadStream, readFileSync } from 'node:fs'
 import { resolve, join, relative, sep, basename } from 'node:path'
@@ -102,6 +108,11 @@ const VERDICT_LABEL = {
 const verdictMark = (v) => VERDICT_MARK[v] ?? '?'
 const verdictLabel = (v) => VERDICT_LABEL[v] ?? v
 
+// A client field value in human mode (0.12.0). Arrays joined, booleans said
+// in words, everything else printed as-is — never JSON punctuation.
+const fmtFieldValue = (v) =>
+  Array.isArray(v) ? v.join(', ') : v === true ? 'yes' : v === false ? 'no' : String(v ?? '—')
+
 // Column widths come from the content. padEnd() alone silently ran a long
 // value into the next column — a 28-character dataset slug swallowed the
 // STATUS header's gutter. Pass headers = null for an unheadered list.
@@ -565,6 +576,15 @@ async function cmdContract() {
     for (const c of manual) out(`  · ${c.name}`)
     out('')
   }
+  // 0.12.0 — the client's own fields on this dataset, read-only (their team
+  // writes them in Myelin; the API never accepts them from a partner key).
+  const meta = dataset.metadata ?? {}
+  const metaKeys = Object.keys(meta)
+  if (metaKeys.length > 0) {
+    out('CLIENT FIELDS — how your client describes this dataset (read-only)')
+    for (const k of metaKeys) out(`  · ${meta[k].label}: ${fmtFieldValue(meta[k].value)}`)
+    out('')
+  }
   out(`Run "myelin check <dir> --dataset ${dsRef}" to test ${s.checkable_before_upload} of these locally.`)
 }
 
@@ -662,6 +682,16 @@ async function cmdCheck() {
   if (j.must_acknowledge_failures > 0) {
     out(`${j.must_acknowledge_failures} check(s) your client asked to be told about — nothing to fix; their reviewer records a decision. Not a blocker.`)
   }
+  // 0.12.0 — required client fields not filled in yet. Informational ONLY:
+  // their team fills these in Myelin, nothing changes in the delivery, and
+  // metadata never moves the exit code (warn, never block — by design).
+  const gaps = j.metadata?.missing_required ?? []
+  if (gaps.length > 0) {
+    out(
+      `${gaps.length} field(s) your client asks for on this dataset ${gaps.length === 1 ? 'is' : 'are'} ` +
+        `not filled in yet: ${gaps.map((g) => g.label).join(', ')}. Their team fills these in Myelin — not a blocker.`,
+    )
+  }
 
   const k = j.counts
   // "All checks that run before upload pass" was written when every check

package/package.json

@@ -1,23 +1,23 @@
-{
-  "name": "@myelinbridge/cli",
-  "version": "0.11.1",
-  "description": "Myelin Partner Ingestion CLI — push R&D data deliveries from a pipeline: preflight against the client's quality rules, resumable upload, submit, track review outcomes.",
-  "type": "module",
-  "bin": {
-    "myelin": "bin/myelin.js"
-  },
-  "files": [
-    "bin/",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=20"
-  },
-  "keywords": [
-    "myelin",
-    "pharma",
-    "ingestion",
-    "s3"
-  ],
-  "license": "UNLICENSED"
-}
+{
+  "name": "@myelinbridge/cli",
+  "version": "0.12.0",
+  "description": "Myelin Partner Ingestion CLI — push R&D data deliveries from a pipeline: preflight against the client's quality rules, resumable upload, submit, track review outcomes.",
+  "type": "module",
+  "bin": {
+    "myelin": "bin/myelin.js"
+  },
+  "files": [
+    "bin/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "myelin",
+    "pharma",
+    "ingestion",
+    "s3"
+  ],
+  "license": "UNLICENSED"
+}