@cosyte/cli 0.0.1 → 0.0.3

package/dist/index.d.cts

@@ -3,23 +3,30 @@ export { r as readFileBytes, a as readStreamBytes } from './io-B2EobRzC.cjs';
 import 'node:stream';
 
 /**
- * The CLI version string, synced with `package.json#version` on release by the Changesets `version`
- * script. Kept in its own module so both the programmatic entry point and the dispatcher share one
- * source of truth.
+ * The CLI version string, synced with `package.json#version` on release by `scripts/sync-version.mjs`,
+ * which the `version` script runs immediately after `changeset version`. Kept in its own module so
+ * both the programmatic entry point and the dispatcher share one source of truth.
+ *
+ * The declaration below is rewritten by that script and is matched at column 0, annotation included.
+ * Renaming it or reflowing it makes the script exit non-zero rather than silently no-op; the shape is
+ * pinned by `test/sanity.test.ts`, and the value is compared against `package.json` there too.
  *
  * @packageDocumentation
  */
 /**
  * The `@cosyte/cli` version. On the uniform `v0.0.x-until-first-alpha` ladder.
  *
+ * Read by `cosyte --version` and by the MCP server's advertised `SERVER_INFO`, so it is a
+ * user-visible surface on both front doors, not merely an export.
+ *
  * @example
  * ```ts
  * import { VERSION } from "@cosyte/cli";
  *
- * typeof VERSION; // => "string"
+ * console.log(`cosyte ${VERSION}`);
  * ```
  */
-declare const VERSION = "0.0.0";
+declare const VERSION: string;
 
 /**
  * The `cosyte` CLI **exit-code contract**: a designed, documented surface that CI pipelines and
@@ -36,7 +43,7 @@ declare const VERSION = "0.0.0";
  * | `2`  | `USAGE`    | usage error: unknown command, bad flag, missing argument (EX_USAGE) |
  * | `65` | `DATAERR`  | data error: input could not be parsed / format not detected (EX_DATAERR) |
  * | `66` | `NOINPUT`  | no input: the file does not exist or is unreadable (EX_NOINPUT)     |
- * | `69` | `UNAVAILABLE` | a required capability is not yet available: e.g. `redact` before `@cosyte/deid` ships (EX_UNAVAILABLE) |
+ * | `69` | `UNAVAILABLE` | a required capability is not yet available: e.g. `redact` before `@cosyte/deid` is wired (EX_UNAVAILABLE) |
  * | `70` | `SOFTWARE` | internal error: an unexpected exception, i.e. a bug (EX_SOFTWARE)   |
  *
  * The load-bearing `validate` rule: a **parseable-but-invalid** message is exit `1`, never exit `0`.
@@ -70,7 +77,7 @@ declare const EXIT: {
     readonly DATAERR: 65;
     /** No input: the named file does not exist or is unreadable (`EX_NOINPUT`). */
     readonly NOINPUT: 66;
-    /** Unavailable: a required capability is not yet built (e.g. `redact` before `@cosyte/deid`), a
+    /** Unavailable: a required capability is not yet wired (e.g. `redact` before `@cosyte/deid`), a
      * distinct non-zero signal that is never a fake success (`EX_UNAVAILABLE`). */
     readonly UNAVAILABLE: 69;
     /** Internal error: an unexpected exception (a bug), distinct from a handled bad input (`EX_SOFTWARE`). */
@@ -161,8 +168,8 @@ declare const CLI_CODES: {
     /** The BYO ConceptMap supplied to `map-codes` is not valid JSON or not a loadable FHIR ConceptMap.
      * Names the stable terminology-loader code, never the map's bytes. Exit `65`. */
     readonly CLI_MAP_INVALID: "CLI_MAP_INVALID";
-    /** A command whose ground-layer library is not yet built (e.g. `redact` before `@cosyte/deid`
-     * ships). Never a fake success: a distinct, value-free "unavailable" signal. Exit `69`. */
+    /** A command whose ground-layer library is not yet wired (e.g. `redact` before `@cosyte/deid` is
+     * wired). Never a fake success: a distinct, value-free "unavailable" signal. Exit `69`. */
     readonly CLI_NOT_IMPLEMENTED: "CLI_NOT_IMPLEMENTED";
     /** An unexpected internal error (a bug). Exit `70`. */
     readonly CLI_INTERNAL: "CLI_INTERNAL";
@@ -616,6 +623,33 @@ declare function valueFreeLocator(pos: unknown): string;
  * ```
  */
 declare function loadOptional<T>(format: CosyteFormat, load: () => Promise<T>): Promise<T>;
+/**
+ * The same graceful-degradation path as {@link loadOptional}, keyed on a **package name** rather than
+ * a {@link CosyteFormat}, with the diagnostic supplied by the caller.
+ *
+ * Two of the packages the CLI lazy-loads are not wire-format parsers and so cannot go through
+ * {@link loadOptional}: `@cosyte/transform` (a conversion library, not one of the eight formats, so
+ * calling it a "parser" in the diagnostic would be wrong) and `@cosyte/fhir` (a format, but absent for
+ * a reason no reinstall fixes, which the message has to say). Both are reachable from a published
+ * install only if the user already has them, so both must degrade to a value-free
+ * `CLI_PARSER_UNAVAILABLE` (exit `69`) instead of surfacing a raw resolver error and a stack frame.
+ *
+ * @template T - The imported module's type.
+ * @param detail - The value-free diagnostic detail shown when the package is absent.
+ * @param load - A thunk performing the dynamic import.
+ * @returns The imported module.
+ * @throws {CliError} `CLI_PARSER_UNAVAILABLE` (exit `69`) when the package is absent; any other error
+ *   propagates unchanged.
+ * @example
+ * ```ts
+ * import { loadOptionalPackage } from "@cosyte/cli";
+ *
+ * await loadOptionalPackage("the conversion library is not installed", () =>
+ *   import("@cosyte/transform"),
+ * );
+ * ```
+ */
+declare function loadOptionalPackage<T>(detail: string, load: () => Promise<T>): Promise<T>;
 /**
  * Parse one record of `format` into the wrapped library's model + its value-free warnings. The model
  * is emitted verbatim on the data channel; the CLI adds no parsing of its own.
@@ -914,14 +948,14 @@ declare function parseFailureResult(format: CosyteFormat, bytes: Uint8Array, pos
 
 /**
  * The **de-identification seam**: the single, documented plug-in point where the `redact` / `deid`
- * command will delegate to **`@cosyte/deid`** once that library ships and is vetted.
+ * command will delegate to **`@cosyte/deid`** once that integration lands and is vetted.
  *
  * ## Why the CLI ships no built-in redactor (the boundary decision)
  *
- * `@cosyte/deid` is **unpublished**, and the wrapped
+ * The CLI does **not wire `@cosyte/deid` yet**, and the wrapped
  * parsers (`@cosyte/hl7`, `@cosyte/fhir`) expose **no de-identification API**: they redact only
- * their own *diagnostics*, not the parsed model. So there is nothing to delegate to today, and adding
- * `@cosyte/deid` would depend on unbuilt code.
+ * their own *diagnostics*, not the parsed model. So there is nothing for the CLI to delegate to
+ * today.
  *
  * A tempting alternative, a "minimal built-in Safe-Harbor pass over the obvious PHI loci" (e.g. the
  * HL7 `PID` segment, `Patient.name`/`Patient.address` in FHIR), is **deliberately rejected**. Real
@@ -932,7 +966,7 @@ declare function parseFailureResult(format: CosyteFormat, bytes: Uint8Array, pos
  *
  * So `redact` is an **honest, typed `CLI_NOT_IMPLEMENTED`** (never a fake success, never a partial
  * scrub presented as de-identified, never invent a capability the ground layer lacks),
- * gated on `@cosyte/deid`, with this seam as its one drop-in point. When `@cosyte/deid` lands and is
+ * gated on `@cosyte/deid`, with this seam as its one drop-in point. When that integration lands and is
  * conformance-graded, {@link deidStatus} flips to `available` and the command reads the input, calls
  * the delegated de-identifier, and emits the de-identified model: the command surface (`redact`,
  * `deid`, `<file|->`, `--format`) already exists so that change is additive.
@@ -956,7 +990,7 @@ interface DeidAvailability {
  * Report the current de-identification availability. Today it is always unavailable (see the module
  * docs); this is the single line that flips when `@cosyte/deid` is wired.
  *
- * @returns The {@link DeidAvailability}: `{ available: false, reason }` until `@cosyte/deid` ships.
+ * @returns The {@link DeidAvailability}: `{ available: false, reason }` until `@cosyte/deid` is wired.
  * @example
  * ```ts
  * import { deidStatus } from "@cosyte/cli";
@@ -1299,7 +1333,7 @@ declare function mapCodesCommand(args: string[], deps: RunDeps): Promise<RunResu
  * PHI, emitting a de-identified copy of the parsed model.
  *
  * **It is deliberately not implemented yet.** De-identification belongs to **`@cosyte/deid`**, which
- * is unpublished, and the wrapped parsers expose no de-id API to delegate to. A
+ * the CLI does not wire yet, and the wrapped parsers expose no de-id API to delegate to. A
  * built-in "minimal Safe-Harbor" pass over only the obvious PHI loci would leave PHI behind and
  * present a **false-safety impression**: the cardinal hazard `redact` exists to avoid. So this
  * command is an **honest, typed `CLI_NOT_IMPLEMENTED`** (never a fake success, never a partial scrub
@@ -1357,4 +1391,4 @@ declare function redactCommand(args: string[]): RunResult;
  */
 declare function completionCommand(args: string[]): RunResult;
 
-export { CLI_CODES, type CliCode, CliError, type CosyteFormat, DEID_UNAVAILABLE_REASON, DETECTABLE_FORMATS, type DeidAvailability, type DetectResult, EXIT, type ExitCode, type Finding, type FmtResult, type InputResolution, type InspectSummary, KNOWN_FORMATS, OP_SUPPORT, type Op, type ParseResult, type ParseWarning, type PhiPosture, type ResolvedInput, RunDeps, type RunResult, SHOW_VALUES, UNSAFE_EXCERPT_MAX, UNSAFE_SHOW_VALUES_FLAG, VALUE_FREE, VERSION, type Verdict, asCosyteFormat, classifyCandidates, completionCommand, convertCommand, convertOutcome, deframeMllp, deidStatus, detectFormat, detectionError, errorResult, extractPhiPosture, extractStableCode, fmtCommand, fmtFormat, formatDiagnostic, formatHl7Position, formatsSupporting, inspectCommand, inspectFormat, loadOptional, mapCodesCommand, parseCommand, parseFailureResult, parseFormat, redactCommand, resolveInput, run, supportsOp, toCliError, unsafeInputSuffix, validateCommand, validateFormat, valueFreeLocator };
+export { CLI_CODES, type CliCode, CliError, type CosyteFormat, DEID_UNAVAILABLE_REASON, DETECTABLE_FORMATS, type DeidAvailability, type DetectResult, EXIT, type ExitCode, type Finding, type FmtResult, type InputResolution, type InspectSummary, KNOWN_FORMATS, OP_SUPPORT, type Op, type ParseResult, type ParseWarning, type PhiPosture, type ResolvedInput, RunDeps, type RunResult, SHOW_VALUES, UNSAFE_EXCERPT_MAX, UNSAFE_SHOW_VALUES_FLAG, VALUE_FREE, VERSION, type Verdict, asCosyteFormat, classifyCandidates, completionCommand, convertCommand, convertOutcome, deframeMllp, deidStatus, detectFormat, detectionError, errorResult, extractPhiPosture, extractStableCode, fmtCommand, fmtFormat, formatDiagnostic, formatHl7Position, formatsSupporting, inspectCommand, inspectFormat, loadOptional, loadOptionalPackage, mapCodesCommand, parseCommand, parseFailureResult, parseFormat, redactCommand, resolveInput, run, supportsOp, toCliError, unsafeInputSuffix, validateCommand, validateFormat, valueFreeLocator };

package/dist/index.d.ts

@@ -3,23 +3,30 @@ export { r as readFileBytes, a as readStreamBytes } from './io-B2EobRzC.js';
 import 'node:stream';
 
 /**
- * The CLI version string, synced with `package.json#version` on release by the Changesets `version`
- * script. Kept in its own module so both the programmatic entry point and the dispatcher share one
- * source of truth.
+ * The CLI version string, synced with `package.json#version` on release by `scripts/sync-version.mjs`,
+ * which the `version` script runs immediately after `changeset version`. Kept in its own module so
+ * both the programmatic entry point and the dispatcher share one source of truth.
+ *
+ * The declaration below is rewritten by that script and is matched at column 0, annotation included.
+ * Renaming it or reflowing it makes the script exit non-zero rather than silently no-op; the shape is
+ * pinned by `test/sanity.test.ts`, and the value is compared against `package.json` there too.
  *
  * @packageDocumentation
  */
 /**
  * The `@cosyte/cli` version. On the uniform `v0.0.x-until-first-alpha` ladder.
  *
+ * Read by `cosyte --version` and by the MCP server's advertised `SERVER_INFO`, so it is a
+ * user-visible surface on both front doors, not merely an export.
+ *
  * @example
  * ```ts
  * import { VERSION } from "@cosyte/cli";
  *
- * typeof VERSION; // => "string"
+ * console.log(`cosyte ${VERSION}`);
  * ```
  */
-declare const VERSION = "0.0.0";
+declare const VERSION: string;
 
 /**
  * The `cosyte` CLI **exit-code contract**: a designed, documented surface that CI pipelines and
@@ -36,7 +43,7 @@ declare const VERSION = "0.0.0";
  * | `2`  | `USAGE`    | usage error: unknown command, bad flag, missing argument (EX_USAGE) |
  * | `65` | `DATAERR`  | data error: input could not be parsed / format not detected (EX_DATAERR) |
  * | `66` | `NOINPUT`  | no input: the file does not exist or is unreadable (EX_NOINPUT)     |
- * | `69` | `UNAVAILABLE` | a required capability is not yet available: e.g. `redact` before `@cosyte/deid` ships (EX_UNAVAILABLE) |
+ * | `69` | `UNAVAILABLE` | a required capability is not yet available: e.g. `redact` before `@cosyte/deid` is wired (EX_UNAVAILABLE) |
  * | `70` | `SOFTWARE` | internal error: an unexpected exception, i.e. a bug (EX_SOFTWARE)   |
  *
  * The load-bearing `validate` rule: a **parseable-but-invalid** message is exit `1`, never exit `0`.
@@ -70,7 +77,7 @@ declare const EXIT: {
     readonly DATAERR: 65;
     /** No input: the named file does not exist or is unreadable (`EX_NOINPUT`). */
     readonly NOINPUT: 66;
-    /** Unavailable: a required capability is not yet built (e.g. `redact` before `@cosyte/deid`), a
+    /** Unavailable: a required capability is not yet wired (e.g. `redact` before `@cosyte/deid`), a
      * distinct non-zero signal that is never a fake success (`EX_UNAVAILABLE`). */
     readonly UNAVAILABLE: 69;
     /** Internal error: an unexpected exception (a bug), distinct from a handled bad input (`EX_SOFTWARE`). */
@@ -161,8 +168,8 @@ declare const CLI_CODES: {
     /** The BYO ConceptMap supplied to `map-codes` is not valid JSON or not a loadable FHIR ConceptMap.
      * Names the stable terminology-loader code, never the map's bytes. Exit `65`. */
     readonly CLI_MAP_INVALID: "CLI_MAP_INVALID";
-    /** A command whose ground-layer library is not yet built (e.g. `redact` before `@cosyte/deid`
-     * ships). Never a fake success: a distinct, value-free "unavailable" signal. Exit `69`. */
+    /** A command whose ground-layer library is not yet wired (e.g. `redact` before `@cosyte/deid` is
+     * wired). Never a fake success: a distinct, value-free "unavailable" signal. Exit `69`. */
     readonly CLI_NOT_IMPLEMENTED: "CLI_NOT_IMPLEMENTED";
     /** An unexpected internal error (a bug). Exit `70`. */
     readonly CLI_INTERNAL: "CLI_INTERNAL";
@@ -616,6 +623,33 @@ declare function valueFreeLocator(pos: unknown): string;
  * ```
  */
 declare function loadOptional<T>(format: CosyteFormat, load: () => Promise<T>): Promise<T>;
+/**
+ * The same graceful-degradation path as {@link loadOptional}, keyed on a **package name** rather than
+ * a {@link CosyteFormat}, with the diagnostic supplied by the caller.
+ *
+ * Two of the packages the CLI lazy-loads are not wire-format parsers and so cannot go through
+ * {@link loadOptional}: `@cosyte/transform` (a conversion library, not one of the eight formats, so
+ * calling it a "parser" in the diagnostic would be wrong) and `@cosyte/fhir` (a format, but absent for
+ * a reason no reinstall fixes, which the message has to say). Both are reachable from a published
+ * install only if the user already has them, so both must degrade to a value-free
+ * `CLI_PARSER_UNAVAILABLE` (exit `69`) instead of surfacing a raw resolver error and a stack frame.
+ *
+ * @template T - The imported module's type.
+ * @param detail - The value-free diagnostic detail shown when the package is absent.
+ * @param load - A thunk performing the dynamic import.
+ * @returns The imported module.
+ * @throws {CliError} `CLI_PARSER_UNAVAILABLE` (exit `69`) when the package is absent; any other error
+ *   propagates unchanged.
+ * @example
+ * ```ts
+ * import { loadOptionalPackage } from "@cosyte/cli";
+ *
+ * await loadOptionalPackage("the conversion library is not installed", () =>
+ *   import("@cosyte/transform"),
+ * );
+ * ```
+ */
+declare function loadOptionalPackage<T>(detail: string, load: () => Promise<T>): Promise<T>;
 /**
  * Parse one record of `format` into the wrapped library's model + its value-free warnings. The model
  * is emitted verbatim on the data channel; the CLI adds no parsing of its own.
@@ -914,14 +948,14 @@ declare function parseFailureResult(format: CosyteFormat, bytes: Uint8Array, pos
 
 /**
  * The **de-identification seam**: the single, documented plug-in point where the `redact` / `deid`
- * command will delegate to **`@cosyte/deid`** once that library ships and is vetted.
+ * command will delegate to **`@cosyte/deid`** once that integration lands and is vetted.
  *
  * ## Why the CLI ships no built-in redactor (the boundary decision)
  *
- * `@cosyte/deid` is **unpublished**, and the wrapped
+ * The CLI does **not wire `@cosyte/deid` yet**, and the wrapped
  * parsers (`@cosyte/hl7`, `@cosyte/fhir`) expose **no de-identification API**: they redact only
- * their own *diagnostics*, not the parsed model. So there is nothing to delegate to today, and adding
- * `@cosyte/deid` would depend on unbuilt code.
+ * their own *diagnostics*, not the parsed model. So there is nothing for the CLI to delegate to
+ * today.
  *
  * A tempting alternative, a "minimal built-in Safe-Harbor pass over the obvious PHI loci" (e.g. the
  * HL7 `PID` segment, `Patient.name`/`Patient.address` in FHIR), is **deliberately rejected**. Real
@@ -932,7 +966,7 @@ declare function parseFailureResult(format: CosyteFormat, bytes: Uint8Array, pos
  *
  * So `redact` is an **honest, typed `CLI_NOT_IMPLEMENTED`** (never a fake success, never a partial
  * scrub presented as de-identified, never invent a capability the ground layer lacks),
- * gated on `@cosyte/deid`, with this seam as its one drop-in point. When `@cosyte/deid` lands and is
+ * gated on `@cosyte/deid`, with this seam as its one drop-in point. When that integration lands and is
  * conformance-graded, {@link deidStatus} flips to `available` and the command reads the input, calls
  * the delegated de-identifier, and emits the de-identified model: the command surface (`redact`,
  * `deid`, `<file|->`, `--format`) already exists so that change is additive.
@@ -956,7 +990,7 @@ interface DeidAvailability {
  * Report the current de-identification availability. Today it is always unavailable (see the module
  * docs); this is the single line that flips when `@cosyte/deid` is wired.
  *
- * @returns The {@link DeidAvailability}: `{ available: false, reason }` until `@cosyte/deid` ships.
+ * @returns The {@link DeidAvailability}: `{ available: false, reason }` until `@cosyte/deid` is wired.
  * @example
  * ```ts
  * import { deidStatus } from "@cosyte/cli";
@@ -1299,7 +1333,7 @@ declare function mapCodesCommand(args: string[], deps: RunDeps): Promise<RunResu
  * PHI, emitting a de-identified copy of the parsed model.
  *
  * **It is deliberately not implemented yet.** De-identification belongs to **`@cosyte/deid`**, which
- * is unpublished, and the wrapped parsers expose no de-id API to delegate to. A
+ * the CLI does not wire yet, and the wrapped parsers expose no de-id API to delegate to. A
  * built-in "minimal Safe-Harbor" pass over only the obvious PHI loci would leave PHI behind and
  * present a **false-safety impression**: the cardinal hazard `redact` exists to avoid. So this
  * command is an **honest, typed `CLI_NOT_IMPLEMENTED`** (never a fake success, never a partial scrub
@@ -1357,4 +1391,4 @@ declare function redactCommand(args: string[]): RunResult;
  */
 declare function completionCommand(args: string[]): RunResult;
 
-export { CLI_CODES, type CliCode, CliError, type CosyteFormat, DEID_UNAVAILABLE_REASON, DETECTABLE_FORMATS, type DeidAvailability, type DetectResult, EXIT, type ExitCode, type Finding, type FmtResult, type InputResolution, type InspectSummary, KNOWN_FORMATS, OP_SUPPORT, type Op, type ParseResult, type ParseWarning, type PhiPosture, type ResolvedInput, RunDeps, type RunResult, SHOW_VALUES, UNSAFE_EXCERPT_MAX, UNSAFE_SHOW_VALUES_FLAG, VALUE_FREE, VERSION, type Verdict, asCosyteFormat, classifyCandidates, completionCommand, convertCommand, convertOutcome, deframeMllp, deidStatus, detectFormat, detectionError, errorResult, extractPhiPosture, extractStableCode, fmtCommand, fmtFormat, formatDiagnostic, formatHl7Position, formatsSupporting, inspectCommand, inspectFormat, loadOptional, mapCodesCommand, parseCommand, parseFailureResult, parseFormat, redactCommand, resolveInput, run, supportsOp, toCliError, unsafeInputSuffix, validateCommand, validateFormat, valueFreeLocator };
+export { CLI_CODES, type CliCode, CliError, type CosyteFormat, DEID_UNAVAILABLE_REASON, DETECTABLE_FORMATS, type DeidAvailability, type DetectResult, EXIT, type ExitCode, type Finding, type FmtResult, type InputResolution, type InspectSummary, KNOWN_FORMATS, OP_SUPPORT, type Op, type ParseResult, type ParseWarning, type PhiPosture, type ResolvedInput, RunDeps, type RunResult, SHOW_VALUES, UNSAFE_EXCERPT_MAX, UNSAFE_SHOW_VALUES_FLAG, VALUE_FREE, VERSION, type Verdict, asCosyteFormat, classifyCandidates, completionCommand, convertCommand, convertOutcome, deframeMllp, deidStatus, detectFormat, detectionError, errorResult, extractPhiPosture, extractStableCode, fmtCommand, fmtFormat, formatDiagnostic, formatHl7Position, formatsSupporting, inspectCommand, inspectFormat, loadOptional, loadOptionalPackage, mapCodesCommand, parseCommand, parseFailureResult, parseFormat, redactCommand, resolveInput, run, supportsOp, toCliError, unsafeInputSuffix, validateCommand, validateFormat, valueFreeLocator };

package/dist/index.mjs

@@ -2,7 +2,7 @@ import { readFile } from 'fs/promises';
 import { parseArgs } from 'util';
 
 // src/core/version.ts
-var VERSION = "0.0.0";
+var VERSION = "0.0.3";
 
 // src/core/exit-codes.ts
 var EXIT = {
@@ -18,7 +18,7 @@ var EXIT = {
   DATAERR: 65,
   /** No input: the named file does not exist or is unreadable (`EX_NOINPUT`). */
   NOINPUT: 66,
-  /** Unavailable: a required capability is not yet built (e.g. `redact` before `@cosyte/deid`), a
+  /** Unavailable: a required capability is not yet wired (e.g. `redact` before `@cosyte/deid`), a
    * distinct non-zero signal that is never a fake success (`EX_UNAVAILABLE`). */
   UNAVAILABLE: 69,
   /** Internal error: an unexpected exception (a bug), distinct from a handled bad input (`EX_SOFTWARE`). */
@@ -49,8 +49,8 @@ var CLI_CODES = {
   /** The BYO ConceptMap supplied to `map-codes` is not valid JSON or not a loadable FHIR ConceptMap.
    * Names the stable terminology-loader code, never the map's bytes. Exit `65`. */
   CLI_MAP_INVALID: "CLI_MAP_INVALID",
-  /** A command whose ground-layer library is not yet built (e.g. `redact` before `@cosyte/deid`
-   * ships). Never a fake success: a distinct, value-free "unavailable" signal. Exit `69`. */
+  /** A command whose ground-layer library is not yet wired (e.g. `redact` before `@cosyte/deid` is
+   * wired). Never a fake success: a distinct, value-free "unavailable" signal. Exit `69`. */
   CLI_NOT_IMPLEMENTED: "CLI_NOT_IMPLEMENTED",
   /** An unexpected internal error (a bug). Exit `70`. */
   CLI_INTERNAL: "CLI_INTERNAL"
@@ -226,19 +226,25 @@ function anyError(findings) {
   return findings.some((f) => ERROR_SEVERITIES.has(f.severity));
 }
 async function loadOptional(format, load) {
+  return loadOptionalPackage(
+    `the @cosyte/${format} parser is not installed; install it to use this format (it is an optional dependency)`,
+    load
+  );
+}
+async function loadOptionalPackage(detail, load) {
   try {
     return await load();
   } catch (e) {
     if (isModuleNotFound(e)) {
-      throw new CliError(
-        CLI_CODES.CLI_PARSER_UNAVAILABLE,
-        EXIT.UNAVAILABLE,
-        `the @cosyte/${format} parser is not installed; install it to use this format (it is an optional dependency)`
-      );
+      throw new CliError(CLI_CODES.CLI_PARSER_UNAVAILABLE, EXIT.UNAVAILABLE, detail);
     }
     throw e;
   }
 }
+var FHIR_UNAVAILABLE = "the @cosyte/fhir parser is not installed, and it is not currently on the npm registry, so it cannot be installed from there; FHIR support is unavailable in this install";
+async function loadFhir() {
+  return loadOptionalPackage(FHIR_UNAVAILABLE, () => import('@cosyte/fhir'));
+}
 function isModuleNotFound(e) {
   if (typeof e !== "object" || e === null) return false;
   const code = "code" in e ? e.code : void 0;
@@ -257,7 +263,7 @@ async function parseFormat(format, bytes) {
       };
     }
     case "fhir": {
-      const { parseResource, serializeResource } = await import('@cosyte/fhir');
+      const { parseResource, serializeResource } = await loadFhir();
       const text = decode(bytes);
       const { resource, issues } = parseResource(text);
       const model = JSON.parse(serializeResource(resource));
@@ -318,7 +324,7 @@ async function inspectFormat(format, bytes) {
       };
     }
     case "fhir": {
-      const { parseResource, resourceType, readBundle } = await import('@cosyte/fhir');
+      const { parseResource, resourceType, readBundle } = await loadFhir();
       const { resource, issues } = parseResource(decode(bytes));
       const rt = resourceType(resource) ?? null;
       if (rt === "Bundle") {
@@ -428,7 +434,7 @@ async function fmtFormat(format, bytes) {
       return { output: msg.toString(), warningCount: msg.warnings.length };
     }
     case "fhir": {
-      const { parseResource, serializeResource } = await import('@cosyte/fhir');
+      const { parseResource, serializeResource } = await loadFhir();
       const { resource, issues } = parseResource(decode(bytes));
       return { output: serializeResource(resource), warningCount: issues.length };
     }
@@ -466,7 +472,7 @@ async function fmtFormat(format, bytes) {
 async function validateFormat(format, bytes) {
   switch (format) {
     case "fhir": {
-      const { parseResource, validateResource } = await import('@cosyte/fhir');
+      const { parseResource, validateResource } = await loadFhir();
       const { resource, issues } = parseResource(decode(bytes));
       const validation = validateResource(resource);
       const findings = [
@@ -670,7 +676,7 @@ async function readStreamBytes(stream) {
 }
 
 // src/core/deid.ts
-var DEID_UNAVAILABLE_REASON = "redact/deid is not yet available. It delegates to @cosyte/deid, which is unpublished. The CLI ships no built-in redactor: a partial Safe-Harbor scrub over only the obvious PHI loci would leave PHI behind and present a false-safety impression, so nothing is emitted. This command will produce a de-identified copy once @cosyte/deid ships and is vetted.";
+var DEID_UNAVAILABLE_REASON = "redact/deid is not yet available. It delegates to @cosyte/deid, which the CLI does not wire yet. The CLI ships no built-in redactor: a partial Safe-Harbor scrub over only the obvious PHI loci would leave PHI behind and present a false-safety impression, so nothing is emitted. This command will produce a de-identified copy once that integration lands and is vetted.";
 function deidStatus() {
   return { available: false, reason: DEID_UNAVAILABLE_REASON };
 }
@@ -836,11 +842,12 @@ async function convertCommand(args, deps, posture = VALUE_FREE) {
   return { stdout: `${conversion.bundleText}
 `, stderr, exit };
 }
+var TRANSFORM_UNAVAILABLE = "the @cosyte/transform conversion library is not installed, so convert is unavailable; it requires @cosyte/fhir, which is not currently on the npm registry, so npm skips transform as an unresolvable optional dependency and installing it directly fails for the same reason";
 async function runConvert(bytes, posture) {
   const [{ parseHL7 }, { toFhir }, { serializeResource }] = await Promise.all([
     import('@cosyte/hl7'),
-    import('@cosyte/transform'),
-    import('@cosyte/fhir')
+    loadOptionalPackage(TRANSFORM_UNAVAILABLE, () => import('@cosyte/transform')),
+    loadFhir()
   ]);
   let msg;
   try {
@@ -1322,7 +1329,7 @@ Commands:
   fmt <file|->        Canonically re-serialize via the parser's spec-clean serializer
   convert <file|->    Convert HL7 v2 \u2192 FHIR R4 via @cosyte/transform (use --to fhir)
   map-codes <cmap|->  Translate a code through a BYO FHIR ConceptMap via @cosyte/terminology
-  redact <file|->     De-identify a message (alias: deid): gated on @cosyte/deid, not yet available
+  redact <file|->     De-identify a message (alias: deid): gated on @cosyte/deid, not yet wired
   mcp                 Start the stdio MCP server (agent front door; also the cosyte-mcp bin)
   completion <shell>  Print a shell completion script (bash | zsh | fish)
 
@@ -1409,6 +1416,6 @@ function resolve(e) {
 `, exit: e.exit };
 }
 
-export { CLI_CODES, CliError, DEID_UNAVAILABLE_REASON, DETECTABLE_FORMATS, EXIT, KNOWN_FORMATS, OP_SUPPORT, SHOW_VALUES, UNSAFE_EXCERPT_MAX, UNSAFE_SHOW_VALUES_FLAG, VALUE_FREE, VERSION, asCosyteFormat, classifyCandidates, completionCommand, convertCommand, convertOutcome, deframeMllp, deidStatus, detectFormat, detectionError, errorResult, extractPhiPosture, extractStableCode, fmtCommand, fmtFormat, formatDiagnostic, formatHl7Position, formatsSupporting, inspectCommand, inspectFormat, loadOptional, mapCodesCommand, parseCommand, parseFailureResult, parseFormat, readFileBytes, readStreamBytes, redactCommand, resolveInput, run, supportsOp, toCliError, unsafeInputSuffix, validateCommand, validateFormat, valueFreeLocator };
+export { CLI_CODES, CliError, DEID_UNAVAILABLE_REASON, DETECTABLE_FORMATS, EXIT, KNOWN_FORMATS, OP_SUPPORT, SHOW_VALUES, UNSAFE_EXCERPT_MAX, UNSAFE_SHOW_VALUES_FLAG, VALUE_FREE, VERSION, asCosyteFormat, classifyCandidates, completionCommand, convertCommand, convertOutcome, deframeMllp, deidStatus, detectFormat, detectionError, errorResult, extractPhiPosture, extractStableCode, fmtCommand, fmtFormat, formatDiagnostic, formatHl7Position, formatsSupporting, inspectCommand, inspectFormat, loadOptional, loadOptionalPackage, mapCodesCommand, parseCommand, parseFailureResult, parseFormat, readFileBytes, readStreamBytes, redactCommand, resolveInput, run, supportsOp, toCliError, unsafeInputSuffix, validateCommand, validateFormat, valueFreeLocator };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map