@jasonbelmonti/markdown-engine 3.1.0 → 3.1.1

package/CHANGELOG.md

@@ -4,6 +4,15 @@
 
 No unreleased changes.
 
+## 3.1.1 - 2026-07-03
+
+### Fixed
+
+- Corrected the constrained-harness installer pin to use the 3.1.1 bundled CLI
+  package version and artifact hash.
+- Corrected declarative validation evidence so `engineVersion` records the
+  package version that produced the JSON.
+
 ## 3.1.0 - 2026-07-03
 
 ### Added

package/README.md

@@ -6,13 +6,15 @@ profile and runtime work.
 Package release state:
 
 - package name: `@jasonbelmonti/markdown-engine`
-- package metadata version: `3.0.0`
-- published npm versions before this release: `0.1.0`, `1.0.0`, `2.0.0`
-- npm release target: `3.0.0` on `latest`
+- package metadata version: `3.1.1`
+- published npm versions before this release: `0.1.0`, `1.0.0`, `2.0.0`,
+  `3.0.0`, `3.1.0`
+- npm release target: `3.1.1` on `latest`
 - website: <https://jasonbelmonti.github.io/markdown-engine/>
-- release focus: Conditional V2 explicit validation-profile syntax while
-  retaining the existing `documentVersion: "1.0.0"` rich IR contract as the
-  default API and CLI document shape
+- release focus: document-set validation, V2 `frontmatterShape` and
+  `textFormat: isoDate` support, and OKF profile examples while retaining the
+  existing `documentVersion: "1.0.0"` rich IR contract as the default API and
+  CLI document shape
 - maintainer documentation map: [docs/README.md](docs/README.md)
 - design reference:
   [Markdown Engine 1.0 Rich IR design](docs/design/markdown-engine-1.0-rich-ir-operational-design-spec.md)
@@ -84,7 +86,7 @@ console.log(validationResult.valid);
 console.log(serialize(validationResult, { pretty: true }));
 ```
 
-Package 3.0 keeps the serialized document contract at
+Package 3.1 retains the serialized document contract at
 `documentVersion: "1.0.0"` and makes that rich IR path the default for
 `normalize(parsed)`. Callers may still pass
 `normalize(parsed, { documentVersion: "1.0.0" })` explicitly. That path adds
@@ -253,13 +255,13 @@ By default, the installer places the CLI under
 and writes the wrapper to
 `${MARKDOWN_ENGINE_BIN_DIR:-$HOME/.local/bin}/markdown-engine`. The installer
 uses a local bundled artifact only when it matches the pinned artifact hash.
-Otherwise it downloads `@jasonbelmonti/markdown-engine@3.0.0` with `npm pack
+Otherwise it downloads `@jasonbelmonti/markdown-engine@3.1.1` with `npm pack
 --ignore-scripts` and extracts only
 `package/dist-bundled/markdown-engine-cli.mjs` from the tarball. It verifies the
 pinned artifact hash before installing:
 
 ```text
-f61ab59e28eb92cccf4fd8073c090102e67a9397a7f0d208661ded14b879053d
+8c7ff572765cbdc6c38b94de52d69709f583ee7b4d2b7e25ba6be8c92125addf
 ```
 
 The installed wrapper is:
@@ -268,7 +270,7 @@ The installed wrapper is:
 "${MARKDOWN_ENGINE_BIN_DIR:-$HOME/.local/bin}/markdown-engine" validate --file <file.md> --profile <profile.yaml> --format json
 ```
 
-Package 3.0 keeps the 2.0 API normalization default: callers that invoke
+Package 3.1 keeps the 2.0 API normalization default: callers that invoke
 `normalize(parsed)` receive the rich IR `1.0.0` document shape. Consumers that
 still need the legacy `0.0.0` shape should consume the rich IR fields
 (`target`, `sections`, `textSpans`, `tables`, `lists`, and `links`) or pin

package/dist/declarative-validation/evidence/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/declarative-validation/evidence/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAGlE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,MAAM,WAAW,6BAA6B,CAC5C,UAAU,SAAS,oBAAoB,GAAG,oBAAoB;IAE9D,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IACnC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAC5C;AAED,wBAAgB,mCAAmC,CACjD,UAAU,SAAS,oBAAoB,EAEvC,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,iBAAiB,EAC1B,WAAW,EAAE,SAAS,UAAU,EAAE,EAClC,WAAW,EAAE,SAAS,kBAAkB,EAAE,GACzC,6BAA6B,CAAC,UAAU,CAAC,CAS3C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/declarative-validation/evidence/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAIlE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,MAAM,WAAW,6BAA6B,CAC5C,UAAU,SAAS,oBAAoB,GAAG,oBAAoB;IAE9D,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IACnC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAC5C;AAED,wBAAgB,mCAAmC,CACjD,UAAU,SAAS,oBAAoB,EAEvC,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,iBAAiB,EAC1B,WAAW,EAAE,SAAS,UAAU,EAAE,EAClC,WAAW,EAAE,SAAS,kBAAkB,EAAE,GACzC,6BAA6B,CAAC,UAAU,CAAC,CAS3C"}

package/dist/declarative-validation/evidence/index.js

@@ -1,12 +1,13 @@
 import { createHash } from "node:crypto";
 import { cloneDiagnostics } from "../../diagnostics/index.js";
+import { MARKDOWN_ENGINE_PACKAGE_VERSION } from "../../internal/package-version.js";
 import { stringifyStableJson } from "../../internal/stable-json.js";
 import { cloneValidationRuleResult } from "../results/clone-rule-result.js";
 export function createDeclarativeValidationEvidence(document, profile, ruleResults, diagnostics) {
     return {
         inputHash: sha256(stringifyStableJson(documentWithoutPath(document))),
         profileHash: sha256(stringifyStableJson(resolvedProfile(profile, document))),
-        engineVersion: "3.0.0",
+        engineVersion: MARKDOWN_ENGINE_PACKAGE_VERSION,
         runtimeVersion: process.version,
         ruleResults: cloneRuleResults(ruleResults),
         diagnostics: cloneDiagnostics(diagnostics),

package/dist/declarative-validation/evidence/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/declarative-validation/evidence/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAKzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAa5E,MAAM,UAAU,mCAAmC,CAGjD,QAAwB,EACxB,OAA0B,EAC1B,WAAkC,EAClC,WAA0C;IAE1C,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,mBAAmB,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC;QACrE,WAAW,EAAE,MAAM,CAAC,mBAAmB,CAAC,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC5E,aAAa,EAAE,OAAO;QACtB,cAAc,EAAE,OAAO,CAAC,OAAO;QAC/B,WAAW,EAAE,gBAAgB,CAAC,WAAW,CAAC;QAC1C,WAAW,EAAE,gBAAgB,CAAC,WAAW,CAAC;KAC3C,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACtB,OAA0B,EAC1B,QAAwB;IAExB,OAAO;QACL,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,QAAQ,CAAC,OAAO;QAC5D,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAClC,GAAG,IAAI;YACP,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,OAAO;SACnC,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,QAAwB;IACnD,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,WAAW,EAAE,GAAG,QAAQ,CAAC;IAEjD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,gBAAgB,CACvB,WAAkC;IAElC,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,eAAe,CACtB,MAAkB;IAElB,OAAO,yBAAyB,CAAC,MAAM,CAAe,CAAC;AACzD,CAAC;AAED,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/declarative-validation/evidence/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAKzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAa5E,MAAM,UAAU,mCAAmC,CAGjD,QAAwB,EACxB,OAA0B,EAC1B,WAAkC,EAClC,WAA0C;IAE1C,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,mBAAmB,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC;QACrE,WAAW,EAAE,MAAM,CAAC,mBAAmB,CAAC,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC5E,aAAa,EAAE,+BAA+B;QAC9C,cAAc,EAAE,OAAO,CAAC,OAAO;QAC/B,WAAW,EAAE,gBAAgB,CAAC,WAAW,CAAC;QAC1C,WAAW,EAAE,gBAAgB,CAAC,WAAW,CAAC;KAC3C,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACtB,OAA0B,EAC1B,QAAwB;IAExB,OAAO;QACL,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,QAAQ,CAAC,OAAO;QAC5D,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAClC,GAAG,IAAI;YACP,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,OAAO;SACnC,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,QAAwB;IACnD,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,WAAW,EAAE,GAAG,QAAQ,CAAC;IAEjD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,gBAAgB,CACvB,WAAkC;IAElC,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,eAAe,CACtB,MAAkB;IAElB,OAAO,yBAAyB,CAAC,MAAM,CAAe,CAAC;AACzD,CAAC;AAED,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC"}

package/dist/internal/package-version.d.ts

@@ -0,0 +1,2 @@
+export declare const MARKDOWN_ENGINE_PACKAGE_VERSION = "3.1.1";
+//# sourceMappingURL=package-version.d.ts.map

package/dist/internal/package-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-version.d.ts","sourceRoot":"","sources":["../../src/internal/package-version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,+BAA+B,UAAU,CAAC"}

package/dist/internal/package-version.js

@@ -0,0 +1,2 @@
+export const MARKDOWN_ENGINE_PACKAGE_VERSION = "3.1.1";
+//# sourceMappingURL=package-version.js.map

package/dist/internal/package-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-version.js","sourceRoot":"","sources":["../../src/internal/package-version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,+BAA+B,GAAG,OAAO,CAAC"}

package/dist-bundled/markdown-engine-cli.mjs

@@ -13418,6 +13418,9 @@ function cloneSourceRange2(sourceRange) {
 // src/declarative-validation/evidence/index.ts
 import { createHash } from "node:crypto";
 
+// src/internal/package-version.ts
+var MARKDOWN_ENGINE_PACKAGE_VERSION = "3.1.1";
+
 // src/internal/stable-json.ts
 function normalizeStableJsonValue(value) {
   if (Array.isArray(value)) {
@@ -13556,7 +13559,7 @@ function createDeclarativeValidationEvidence(document3, profile, ruleResults, di
   return {
     inputHash: sha256(stringifyStableJson(documentWithoutPath(document3))),
     profileHash: sha256(stringifyStableJson(resolvedProfile(profile, document3))),
-    engineVersion: "3.0.0",
+    engineVersion: MARKDOWN_ENGINE_PACKAGE_VERSION,
     runtimeVersion: process.version,
     ruleResults: cloneRuleResults(ruleResults),
     diagnostics: cloneDiagnostics(diagnostics)

package/docs/contracts/declarative-validation.md

@@ -624,8 +624,8 @@ serialization of the resolved `ValidationProfile` after applying the resolved
 `documentVersion` and an explicit matching `documentVersion` therefore produce
 the same profile hash for the same document version and rules.
 
-`engineVersion` records the package version that produced the evidence. In the
-3.0 release line this is `"3.0.0"` even though `documentVersion` remains
+`engineVersion` records the package version that produced the evidence. This
+matches the package metadata version even though `documentVersion` remains
 `"1.0.0"`.
 
 Raw Markdown bytes, raw YAML bytes, YAML comments, caller file paths, and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jasonbelmonti/markdown-engine",
-  "version": "3.1.0",
+  "version": "3.1.1",
   "description": "Deterministic Markdown parsing and validation engine package.",
   "license": "MIT",
   "type": "module",

package/scripts/install-markdown-engine-cli.sh

@@ -1,9 +1,9 @@
 #!/usr/bin/env sh
 set -eu
 
-VERSION="3.0.0"
+VERSION="3.1.1"
 PACKAGE="@jasonbelmonti/markdown-engine"
-EXPECTED_SHA256="f61ab59e28eb92cccf4fd8073c090102e67a9397a7f0d208661ded14b879053d"
+EXPECTED_SHA256="8c7ff572765cbdc6c38b94de52d69709f583ee7b4d2b7e25ba6be8c92125addf"
 DEFAULT_DATA_HOME="${XDG_DATA_HOME:-$HOME/.local/share}"
 MARKDOWN_ENGINE_HOME="${MARKDOWN_ENGINE_HOME:-$DEFAULT_DATA_HOME/markdown-engine}"
 MARKDOWN_ENGINE_BIN_DIR="${MARKDOWN_ENGINE_BIN_DIR:-$HOME/.local/bin}"