@pactosigna/records 0.1.1 → 0.1.3

package/dist/cli.js

@@ -76,6 +76,52 @@ function readDocuments(rootDir, folderPath, statusFilter = INCLUDED_STATUSES) {
 // src/pdf/markdown-to-pdfmake.ts
 import MarkdownIt from "markdown-it";
 var md = new MarkdownIt();
+var UNICODE_REPLACEMENTS = {
+  "\u2264": "<=",
+  // ≤
+  "\u2265": ">=",
+  // ≥
+  "\u2260": "!=",
+  // ≠
+  "\u2248": "~=",
+  // ≈
+  "\xB1": "+/-",
+  // ±
+  "\u2014": "--",
+  // —  (em dash)
+  "\u2013": "-",
+  // –  (en dash)
+  "\u2018": "'",
+  // '  (left single quote)
+  "\u2019": "'",
+  // '  (right single quote)
+  "\u201C": '"',
+  // "  (left double quote)
+  "\u201D": '"',
+  // "  (right double quote)
+  "\u2026": "...",
+  // …  (ellipsis)
+  "\u2192": "->",
+  // →
+  "\u2190": "<-",
+  // ←
+  "\xD7": "x",
+  // ×  (multiplication sign)
+  "\xF7": "/",
+  // ÷  (division sign)
+  "\u221E": "Inf",
+  // ∞
+  "\u2211": "Sum",
+  // ∑
+  "\u0394": "Delta",
+  // Δ
+  "\u03BC": "u"
+  // μ  (micro)
+};
+var UNICODE_PATTERN = new RegExp("[" + Object.keys(UNICODE_REPLACEMENTS).join("") + "]", "g");
+function sanitizeUnicode(text) {
+  return text.replace(UNICODE_PATTERN, (match) => UNICODE_REPLACEMENTS[match] ?? match);
+}
 function markdownToPdfmake(markdown) {
   if (!markdown.trim()) return [];
   const tokens = md.parse(markdown, {});
@@ -125,7 +171,7 @@ function markdownToPdfmake(markdown) {
     }
     if (token.type === "fence") {
       result.push({
-        text: token.content,
+        text: sanitizeUnicode(token.content),
         style: "code",
         margin: [0, 4, 0, 4],
         background: "#F5F5F5"
@@ -163,7 +209,7 @@ function parseInlineContent(token) {
         italics = false;
         break;
       case "code_inline":
-        fragments.push({ text: child.content, font: "Courier", fontSize: 9 });
+        fragments.push({ text: sanitizeUnicode(child.content), font: "Courier", fontSize: 9 });
         break;
       case "softbreak":
       case "hardbreak":
@@ -171,17 +217,17 @@ function parseInlineContent(token) {
         break;
       case "text":
         if (bold || italics) {
-          const fragment = { text: child.content };
+          const fragment = { text: sanitizeUnicode(child.content) };
           if (bold) fragment.bold = true;
           if (italics) fragment.italics = true;
           fragments.push(fragment);
         } else {
-          fragments.push(child.content);
+          fragments.push(sanitizeUnicode(child.content));
         }
         break;
       default:
         if (child.content) {
-          fragments.push(child.content);
+          fragments.push(sanitizeUnicode(child.content));
         }
         break;
     }
@@ -275,6 +321,33 @@ function parseTable(tokens, startIndex) {
   };
 }
 
+// src/pdf/logo.ts
+import { readFileSync as readFileSync3, existsSync as existsSync2 } from "fs";
+import { resolve as resolve3 } from "path";
+var DEFAULT_LOGO_SVG = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="86 33 112 132" fill="none">
+  <path d="M 126.660 39.048 C 118.948 40.342, 108.092 43.909, 100.250 47.726 L 93 51.254 93 79.417 C 93 101.290, 93.337 108.873, 94.508 113.369 C 99.124 131.093, 111.353 144.203, 132.521 154.123 L 141.228 158.203 147.482 155.545 C 164.571 148.282, 177.761 137.330, 183.523 125.620 C 185.450 121.704, 187.687 115.350, 188.496 111.500 C 190.017 104.251, 190.622 77.552, 189.250 78.172 C 188.838 78.359, 186.137 79.754, 183.250 81.273 L 178 84.034 177.976 97.767 C 177.955 109.837, 177.670 112.188, 175.617 117.178 C 174.332 120.302, 171.823 124.699, 170.040 126.950 C 166.118 131.901, 156.845 138.641, 147.912 143.031 L 141.324 146.270 133.165 142.025 C 123.422 136.956, 112.066 126.834, 108.987 120.474 C 104.626 111.464, 104.024 106.777, 104.012 81.694 L 104 57.888 108.468 55.911 C 118.291 51.566, 127.969 49.691, 141 49.610 C 154.549 49.525, 161.523 50.879, 172.184 55.663 L 178 58.273 178.015 67.887 C 178.024 73.174, 178.361 78.008, 178.765 78.629 C 179.273 79.409, 181.073 78.866, 184.588 76.874 L 189.677 73.990 189.588 62.811 L 189.500 51.632 182.359 47.990 C 173.984 43.718, 164.090 40.483, 155 39.044 C 147.525 37.861, 133.720 37.863, 126.660 39.048 M 126.500 55.097 C 124.300 55.590, 119.463 56.951, 115.750 58.122 L 109 60.251 109 85.729 L 109 111.207 113.250 117.047 C 115.588 120.259, 117.838 122.912, 118.250 122.943 C 118.662 122.975, 119 116.984, 119 109.630 L 119 96.261 132.250 95.756 C 142.964 95.347, 146.648 94.801, 151.500 92.903 C 167.650 86.582, 173.814 69.996, 163.666 60.161 C 159.792 56.406, 152.831 54, 145.841 54 L 141 54 141 59 L 141 64 145.435 64 C 153.585 64, 158 66.985, 158 72.495 C 158 74.610, 157.079 76.941, 155.504 78.813 C 151.445 83.637, 146.077 85.209, 131.750 85.768 L 119 86.265 119 76.758 L 119 67.250 122.125 66.625 C 123.844 66.281, 125.644 66, 126.125 66 C 126.606 66, 127 69.600, 127 74 L 127 82 132 82 L 137 82 137 68 L 137 54 133.750 54.100 C 131.963 54.156, 128.700 54.604, 126.500 55.097 M 159.103 93.372 C 143.915 101.453, 141 104.415, 141 111.767 C 141 115.024, 141.605 116.696, 143.455 118.545 C 144.805 119.895, 146.717 120.996, 147.705 120.990 C 148.692 120.985, 151.907 119.860, 154.849 118.490 C 160.989 115.632, 162 115.473, 162 117.364 C 162 118.898, 157.383 122.272, 148.500 127.227 C 142.608 130.513, 142.495 130.658, 142.195 135.287 C 142.028 137.879, 142.122 140, 142.406 140 C 142.689 140, 146.800 137.874, 151.541 135.277 C 166.125 127.286, 171 121.968, 171 114.050 C 171 109.325, 168.324 106, 164.522 106 C 163.159 106, 159.572 107.213, 156.550 108.695 C 153.528 110.177, 150.722 111.055, 150.313 110.647 C 148.679 109.012, 152.158 106.229, 162.820 100.641 L 174 94.781 174 90.391 C 174 87.976, 173.662 86.055, 173.250 86.122 C 172.838 86.189, 166.471 89.451, 159.103 93.372 M 127 115.952 L 127 132.904 131.430 135.952 C 133.867 137.628, 136.117 139, 136.430 139 C 136.744 139, 137 130, 137 119 L 137 99 132 99 L 127 99 127 115.952" fill="#0D2D56" fill-rule="evenodd"/>
+  <path d="M 159.103 93.372 C 143.915 101.453, 141 104.415, 141 111.767 C 141 115.024, 141.605 116.696, 143.455 118.545 C 144.805 119.895, 146.717 120.996, 147.705 120.990 C 148.692 120.985, 151.907 119.860, 154.849 118.490 C 160.989 115.632, 162 115.473, 162 117.364 C 162 118.898, 157.383 122.272, 148.500 127.227 C 142.608 130.513, 142.495 130.658, 142.195 135.287 C 142.028 137.879, 142.122 140, 142.406 140 C 142.689 140, 146.800 137.874, 151.541 135.277 C 166.125 127.286, 171 121.968, 171 114.050 C 171 109.325, 168.324 106, 164.522 106 C 163.159 106, 159.572 107.213, 156.550 108.695 C 153.528 110.177, 150.722 111.055, 150.313 110.647 C 148.679 109.012, 152.158 106.229, 162.820 100.641 L 174 94.781 174 90.391 C 174 87.976, 173.662 86.055, 173.250 86.122 C 172.838 86.189, 166.471 89.451, 159.103 93.372 M 127 115.952 L 127 132.904 131.430 135.952 C 133.867 137.628, 136.117 139, 136.430 139 C 136.744 139, 137 130, 137 119 L 137 99 132 99 L 127 99 127 115.952" fill="#73C4B0" fill-rule="evenodd"/>
+</svg>`;
+var HEADER_LOGO_HEIGHT = 30;
+function resolveHeaderLogo(rootDir, customLogoPath) {
+  if (customLogoPath) {
+    const absPath = resolve3(rootDir, customLogoPath);
+    if (existsSync2(absPath)) {
+      const ext = absPath.toLowerCase();
+      if (ext.endsWith(".png") || ext.endsWith(".jpg") || ext.endsWith(".jpeg")) {
+        const data = readFileSync3(absPath);
+        const mime = ext.endsWith(".png") ? "image/png" : "image/jpeg";
+        const base64 = `data:${mime};base64,${data.toString("base64")}`;
+        return { image: base64, height: HEADER_LOGO_HEIGHT };
+      }
+    }
+  }
+  return {
+    svg: DEFAULT_LOGO_SVG,
+    height: HEADER_LOGO_HEIGHT
+  };
+}
+
 // src/pdf/layout.ts
 var HEADER_GRAY = "#F0F0F0";
 var HEADING_COLOR = "#2C3E50";
@@ -331,8 +404,9 @@ function buildCoverPage(options) {
   return cover;
 }
 function buildDocumentDefinition(options) {
-  const { recordTitle, recordId, version, date, content = [] } = options;
+  const { rootDir, config, recordTitle, recordId, version, date, content = [] } = options;
   const coverPage = buildCoverPage(options);
+  const logo = resolveHeaderLogo(rootDir, config.branding.logo);
   return {
     pageSize: "A4",
     pageMargins: [40, 80, 40, 50],
@@ -355,7 +429,7 @@ function buildDocumentDefinition(options) {
           widths: [usableWidth * 0.2, "*", usableWidth * 0.25],
           body: [
             [
-              { text: "[LOGO]", fontSize: 8, color: "#999999" },
+              logo,
               {
                 stack: [
                   { text: recordTitle, bold: true, fontSize: 10, alignment: "center" },
@@ -438,6 +512,7 @@ function generateUrs(input) {
   }
   return buildDocumentDefinition({
     config: input.config,
+    rootDir: input.rootDir,
     recordTitle: "User Requirements Specification",
     recordId: "URS",
     version: input.version,
@@ -474,6 +549,7 @@ function generatePrs(input) {
   }
   return buildDocumentDefinition({
     config: input.config,
+    rootDir: input.rootDir,
     recordTitle: "Product Requirements Specification",
     recordId: "PRS",
     version: input.version,
@@ -510,6 +586,7 @@ function generateSrs(input) {
   }
   return buildDocumentDefinition({
     config: input.config,
+    rootDir: input.rootDir,
     recordTitle: "Software Requirements Specification",
     recordId: "SRS",
     version: input.version,
@@ -727,6 +804,7 @@ function generatePta(input) {
   }
   return buildDocumentDefinition({
     config: input.config,
+    rootDir: input.rootDir,
     recordTitle: "Product Traceability Analysis",
     recordId: "PTA",
     version: input.version,
@@ -2162,7 +2240,9 @@ var ArchitectureFrontmatterSchema = z62.object({
   author: z62.string().min(1),
   reviewers: z62.array(z62.string()).optional(),
   /** Approver list — required for all regulated document types */
-  approvers: z62.array(z62.string()).min(1)
+  approvers: z62.array(z62.string()).min(1),
+  /** SRS requirement IDs this architecture item implements (IEC 62304 §5.3.1) */
+  implements: z62.array(z62.string().min(1)).optional()
 });
 var DetailedDesignFrontmatterSchema = z62.object({
   id: z62.string().min(1),
@@ -2180,7 +2260,9 @@ var DetailedDesignFrontmatterSchema = z62.object({
   author: z62.string().min(1),
   reviewers: z62.array(z62.string()).optional(),
   /** Approver list — required for all regulated document types */
-  approvers: z62.array(z62.string()).min(1)
+  approvers: z62.array(z62.string()).min(1),
+  /** SRS requirement IDs this design item implements (IEC 62304 §5.4.2) */
+  implements: z62.array(z62.string().min(1)).optional()
 });
 var AnomalyCategorySchema = z72.enum([
   "bug",
@@ -2398,7 +2480,11 @@ var SoftwareRequirementFrontmatterSchema = z16.object({
   traces_from: z16.array(z16.string()).min(1),
   /** Downstream traceability — IDs of documents this SRS traces to */
   traces_to: z16.array(z16.string()).optional(),
-  /** HLD/SDD document ID that implements this requirement */
+  /**
+   * @deprecated Use `implements` on HLD/SDD documents instead.
+   * Architecture documents should declare which requirements they implement (IEC 62304 §5.3.1).
+   * Kept for backwards compatibility — the sync engine does not create links from this field.
+   */
   implemented_in: z16.string().optional()
 });
 var TestProtocolFrontmatterSchema = z17.object({
@@ -4912,8 +4998,8 @@ var FrameworkEvidenceResponseSchema = z38.object({
 });
 
 // src/generators/rmr-generator.ts
-import { readFileSync as readFileSync3, existsSync as existsSync2 } from "fs";
-import { resolve as resolve3 } from "path";
+import { readFileSync as readFileSync4, existsSync as existsSync3 } from "fs";
+import { resolve as resolve4 } from "path";
 import { parse as parseYaml2 } from "yaml";
 var HEADER_GRAY3 = "#F0F0F0";
 function isHazard(doc) {
@@ -4924,12 +5010,12 @@ function isRiskEntry(doc) {
 }
 function loadRiskMatrix(rootDir) {
   const candidates = [
-    resolve3(rootDir, "risk-matrix.yaml"),
-    resolve3(rootDir, "docs/risk/risk-matrix.yaml")
+    resolve4(rootDir, "risk-matrix.yaml"),
+    resolve4(rootDir, "docs/risk/risk-matrix.yaml")
   ];
   for (const candidate of candidates) {
-    if (existsSync2(candidate)) {
-      const raw = readFileSync3(candidate, "utf-8");
+    if (existsSync3(candidate)) {
+      const raw = readFileSync4(candidate, "utf-8");
       const parsed = parseYaml2(raw);
       const result = RiskMatrixConfigSchema.safeParse(parsed);
       if (result.success) {
@@ -5145,6 +5231,7 @@ function generateRmr(input) {
   }
   return buildDocumentDefinition({
     config: input.config,
+    rootDir: input.rootDir,
     recordTitle: "Risk Management Report",
     recordId: "RMR",
     version: input.version,
@@ -5156,8 +5243,8 @@ function generateRmr(input) {
 
 // src/github/changelog.ts
 import { execFileSync } from "child_process";
-import { resolve as resolve4 } from "path";
-import { readFileSync as readFileSync4 } from "fs";
+import { resolve as resolve5 } from "path";
+import { readFileSync as readFileSync5 } from "fs";
 import matter3 from "gray-matter";
 function buildChangelog(rootDir, version, date) {
   let previousTag = null;
@@ -5191,7 +5278,7 @@ function buildChangelog(rootDir, version, date) {
   const descriptions = [];
   for (const file of changedFiles.slice(0, 20)) {
     try {
-      const raw = readFileSync4(resolve4(rootDir, file), "utf-8");
+      const raw = readFileSync5(resolve5(rootDir, file), "utf-8");
       const { data } = matter3(raw);
       if (data.id && data.title) {
         descriptions.push(`${data.id}: ${data.title}`);
@@ -5289,10 +5376,10 @@ function getDraftReleaseVersion() {
 // src/github/publish.ts
 import { execFileSync as execFileSync3 } from "child_process";
 import { readdirSync as readdirSync2 } from "fs";
-import { resolve as resolve5 } from "path";
+import { resolve as resolve6 } from "path";
 function publishDraftRelease(version, outputDir) {
   const tag = `v${version}`;
-  const pdfFiles = readdirSync2(outputDir).filter((f) => f.endsWith(".pdf")).map((f) => resolve5(outputDir, f));
+  const pdfFiles = readdirSync2(outputDir).filter((f) => f.endsWith(".pdf")).map((f) => resolve6(outputDir, f));
   if (pdfFiles.length === 0) {
     throw new Error("No PDF files found to upload");
   }

package/dist/generators/prs-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prs-generator.d.ts","sourceRoot":"","sources":["../../src/generators/prs-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAItD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,oBAAoB,GAAG,IAAI,CAuC9E;AAED,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"prs-generator.d.ts","sourceRoot":"","sources":["../../src/generators/prs-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAItD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,oBAAoB,GAAG,IAAI,CAwC9E;AAED,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC"}

package/dist/generators/pta-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pta-generator.d.ts","sourceRoot":"","sources":["../../src/generators/pta-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,GAAG,YAAY,GAAG,YAAY,CAAC;CACjD;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,eAAe,EAAE,CAAC;IACxB,IAAI,EAAE,WAAW,EAAE,CAAC;CACrB;AASD,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,cAAc,EAAE,EACrB,IAAI,EAAE,cAAc,EAAE,EACtB,IAAI,EAAE,cAAc,EAAE,GACrB,kBAAkB,CAgJpB;AASD,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,oBAAoB,GAAG,IAAI,CAkE9E"}
+{"version":3,"file":"pta-generator.d.ts","sourceRoot":"","sources":["../../src/generators/pta-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,GAAG,YAAY,GAAG,YAAY,CAAC;CACjD;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,eAAe,EAAE,CAAC;IACxB,IAAI,EAAE,WAAW,EAAE,CAAC;CACrB;AASD,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,cAAc,EAAE,EACrB,IAAI,EAAE,cAAc,EAAE,EACtB,IAAI,EAAE,cAAc,EAAE,GACrB,kBAAkB,CAgJpB;AASD,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,oBAAoB,GAAG,IAAI,CAmE9E"}

package/dist/generators/rmr-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rmr-generator.d.ts","sourceRoot":"","sources":["../../src/generators/rmr-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAW5D,MAAM,WAAW,SAAS;IACxB,gBAAgB,EAAE,cAAc,EAAE,CAAC;IACnC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,YAAY,EAAE,gBAAgB,CAAC;IAC/B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AA8ED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAmEzD;AAmHD,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,oBAAoB,GAAG,IAAI,CA6D9E"}
+{"version":3,"file":"rmr-generator.d.ts","sourceRoot":"","sources":["../../src/generators/rmr-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAW5D,MAAM,WAAW,SAAS;IACxB,gBAAgB,EAAE,cAAc,EAAE,CAAC;IACnC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,YAAY,EAAE,gBAAgB,CAAC;IAC/B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AA8ED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAmEzD;AAmHD,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,oBAAoB,GAAG,IAAI,CA8D9E"}

package/dist/generators/srs-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"srs-generator.d.ts","sourceRoot":"","sources":["../../src/generators/srs-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAItD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,oBAAoB,GAAG,IAAI,CAuC9E;AAED,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"srs-generator.d.ts","sourceRoot":"","sources":["../../src/generators/srs-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAItD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,oBAAoB,GAAG,IAAI,CAwC9E;AAED,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC"}

package/dist/generators/urs-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"urs-generator.d.ts","sourceRoot":"","sources":["../../src/generators/urs-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKtD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,eAAe,EAAE,aAAa,EAAE,CAAC;CAClC;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,oBAAoB,GAAG,IAAI,CAuC9E"}
+{"version":3,"file":"urs-generator.d.ts","sourceRoot":"","sources":["../../src/generators/urs-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKtD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,eAAe,EAAE,aAAa,EAAE,CAAC;CAClC;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,oBAAoB,GAAG,IAAI,CAwC9E"}

package/dist/index.js

@@ -74,6 +74,52 @@ function readDocuments(rootDir, folderPath, statusFilter = INCLUDED_STATUSES) {
 // src/pdf/markdown-to-pdfmake.ts
 import MarkdownIt from "markdown-it";
 var md = new MarkdownIt();
+var UNICODE_REPLACEMENTS = {
+  "\u2264": "<=",
+  // ≤
+  "\u2265": ">=",
+  // ≥
+  "\u2260": "!=",
+  // ≠
+  "\u2248": "~=",
+  // ≈
+  "\xB1": "+/-",
+  // ±
+  "\u2014": "--",
+  // —  (em dash)
+  "\u2013": "-",
+  // –  (en dash)
+  "\u2018": "'",
+  // '  (left single quote)
+  "\u2019": "'",
+  // '  (right single quote)
+  "\u201C": '"',
+  // "  (left double quote)
+  "\u201D": '"',
+  // "  (right double quote)
+  "\u2026": "...",
+  // …  (ellipsis)
+  "\u2192": "->",
+  // →
+  "\u2190": "<-",
+  // ←
+  "\xD7": "x",
+  // ×  (multiplication sign)
+  "\xF7": "/",
+  // ÷  (division sign)
+  "\u221E": "Inf",
+  // ∞
+  "\u2211": "Sum",
+  // ∑
+  "\u0394": "Delta",
+  // Δ
+  "\u03BC": "u"
+  // μ  (micro)
+};
+var UNICODE_PATTERN = new RegExp("[" + Object.keys(UNICODE_REPLACEMENTS).join("") + "]", "g");
+function sanitizeUnicode(text) {
+  return text.replace(UNICODE_PATTERN, (match) => UNICODE_REPLACEMENTS[match] ?? match);
+}
 function markdownToPdfmake(markdown) {
   if (!markdown.trim()) return [];
   const tokens = md.parse(markdown, {});
@@ -123,7 +169,7 @@ function markdownToPdfmake(markdown) {
     }
     if (token.type === "fence") {
       result.push({
-        text: token.content,
+        text: sanitizeUnicode(token.content),
         style: "code",
         margin: [0, 4, 0, 4],
         background: "#F5F5F5"
@@ -161,7 +207,7 @@ function parseInlineContent(token) {
         italics = false;
         break;
       case "code_inline":
-        fragments.push({ text: child.content, font: "Courier", fontSize: 9 });
+        fragments.push({ text: sanitizeUnicode(child.content), font: "Courier", fontSize: 9 });
         break;
       case "softbreak":
       case "hardbreak":
@@ -169,17 +215,17 @@ function parseInlineContent(token) {
         break;
       case "text":
         if (bold || italics) {
-          const fragment = { text: child.content };
+          const fragment = { text: sanitizeUnicode(child.content) };
           if (bold) fragment.bold = true;
           if (italics) fragment.italics = true;
           fragments.push(fragment);
         } else {
-          fragments.push(child.content);
+          fragments.push(sanitizeUnicode(child.content));
         }
         break;
       default:
         if (child.content) {
-          fragments.push(child.content);
+          fragments.push(sanitizeUnicode(child.content));
         }
         break;
     }
@@ -273,6 +319,33 @@ function parseTable(tokens, startIndex) {
   };
 }
 
+// src/pdf/logo.ts
+import { readFileSync as readFileSync3, existsSync as existsSync2 } from "fs";
+import { resolve as resolve3 } from "path";
+var DEFAULT_LOGO_SVG = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="86 33 112 132" fill="none">
+  <path d="M 126.660 39.048 C 118.948 40.342, 108.092 43.909, 100.250 47.726 L 93 51.254 93 79.417 C 93 101.290, 93.337 108.873, 94.508 113.369 C 99.124 131.093, 111.353 144.203, 132.521 154.123 L 141.228 158.203 147.482 155.545 C 164.571 148.282, 177.761 137.330, 183.523 125.620 C 185.450 121.704, 187.687 115.350, 188.496 111.500 C 190.017 104.251, 190.622 77.552, 189.250 78.172 C 188.838 78.359, 186.137 79.754, 183.250 81.273 L 178 84.034 177.976 97.767 C 177.955 109.837, 177.670 112.188, 175.617 117.178 C 174.332 120.302, 171.823 124.699, 170.040 126.950 C 166.118 131.901, 156.845 138.641, 147.912 143.031 L 141.324 146.270 133.165 142.025 C 123.422 136.956, 112.066 126.834, 108.987 120.474 C 104.626 111.464, 104.024 106.777, 104.012 81.694 L 104 57.888 108.468 55.911 C 118.291 51.566, 127.969 49.691, 141 49.610 C 154.549 49.525, 161.523 50.879, 172.184 55.663 L 178 58.273 178.015 67.887 C 178.024 73.174, 178.361 78.008, 178.765 78.629 C 179.273 79.409, 181.073 78.866, 184.588 76.874 L 189.677 73.990 189.588 62.811 L 189.500 51.632 182.359 47.990 C 173.984 43.718, 164.090 40.483, 155 39.044 C 147.525 37.861, 133.720 37.863, 126.660 39.048 M 126.500 55.097 C 124.300 55.590, 119.463 56.951, 115.750 58.122 L 109 60.251 109 85.729 L 109 111.207 113.250 117.047 C 115.588 120.259, 117.838 122.912, 118.250 122.943 C 118.662 122.975, 119 116.984, 119 109.630 L 119 96.261 132.250 95.756 C 142.964 95.347, 146.648 94.801, 151.500 92.903 C 167.650 86.582, 173.814 69.996, 163.666 60.161 C 159.792 56.406, 152.831 54, 145.841 54 L 141 54 141 59 L 141 64 145.435 64 C 153.585 64, 158 66.985, 158 72.495 C 158 74.610, 157.079 76.941, 155.504 78.813 C 151.445 83.637, 146.077 85.209, 131.750 85.768 L 119 86.265 119 76.758 L 119 67.250 122.125 66.625 C 123.844 66.281, 125.644 66, 126.125 66 C 126.606 66, 127 69.600, 127 74 L 127 82 132 82 L 137 82 137 68 L 137 54 133.750 54.100 C 131.963 54.156, 128.700 54.604, 126.500 55.097 M 159.103 93.372 C 143.915 101.453, 141 104.415, 141 111.767 C 141 115.024, 141.605 116.696, 143.455 118.545 C 144.805 119.895, 146.717 120.996, 147.705 120.990 C 148.692 120.985, 151.907 119.860, 154.849 118.490 C 160.989 115.632, 162 115.473, 162 117.364 C 162 118.898, 157.383 122.272, 148.500 127.227 C 142.608 130.513, 142.495 130.658, 142.195 135.287 C 142.028 137.879, 142.122 140, 142.406 140 C 142.689 140, 146.800 137.874, 151.541 135.277 C 166.125 127.286, 171 121.968, 171 114.050 C 171 109.325, 168.324 106, 164.522 106 C 163.159 106, 159.572 107.213, 156.550 108.695 C 153.528 110.177, 150.722 111.055, 150.313 110.647 C 148.679 109.012, 152.158 106.229, 162.820 100.641 L 174 94.781 174 90.391 C 174 87.976, 173.662 86.055, 173.250 86.122 C 172.838 86.189, 166.471 89.451, 159.103 93.372 M 127 115.952 L 127 132.904 131.430 135.952 C 133.867 137.628, 136.117 139, 136.430 139 C 136.744 139, 137 130, 137 119 L 137 99 132 99 L 127 99 127 115.952" fill="#0D2D56" fill-rule="evenodd"/>
+  <path d="M 159.103 93.372 C 143.915 101.453, 141 104.415, 141 111.767 C 141 115.024, 141.605 116.696, 143.455 118.545 C 144.805 119.895, 146.717 120.996, 147.705 120.990 C 148.692 120.985, 151.907 119.860, 154.849 118.490 C 160.989 115.632, 162 115.473, 162 117.364 C 162 118.898, 157.383 122.272, 148.500 127.227 C 142.608 130.513, 142.495 130.658, 142.195 135.287 C 142.028 137.879, 142.122 140, 142.406 140 C 142.689 140, 146.800 137.874, 151.541 135.277 C 166.125 127.286, 171 121.968, 171 114.050 C 171 109.325, 168.324 106, 164.522 106 C 163.159 106, 159.572 107.213, 156.550 108.695 C 153.528 110.177, 150.722 111.055, 150.313 110.647 C 148.679 109.012, 152.158 106.229, 162.820 100.641 L 174 94.781 174 90.391 C 174 87.976, 173.662 86.055, 173.250 86.122 C 172.838 86.189, 166.471 89.451, 159.103 93.372 M 127 115.952 L 127 132.904 131.430 135.952 C 133.867 137.628, 136.117 139, 136.430 139 C 136.744 139, 137 130, 137 119 L 137 99 132 99 L 127 99 127 115.952" fill="#73C4B0" fill-rule="evenodd"/>
+</svg>`;
+var HEADER_LOGO_HEIGHT = 30;
+function resolveHeaderLogo(rootDir, customLogoPath) {
+  if (customLogoPath) {
+    const absPath = resolve3(rootDir, customLogoPath);
+    if (existsSync2(absPath)) {
+      const ext = absPath.toLowerCase();
+      if (ext.endsWith(".png") || ext.endsWith(".jpg") || ext.endsWith(".jpeg")) {
+        const data = readFileSync3(absPath);
+        const mime = ext.endsWith(".png") ? "image/png" : "image/jpeg";
+        const base64 = `data:${mime};base64,${data.toString("base64")}`;
+        return { image: base64, height: HEADER_LOGO_HEIGHT };
+      }
+    }
+  }
+  return {
+    svg: DEFAULT_LOGO_SVG,
+    height: HEADER_LOGO_HEIGHT
+  };
+}
+
 // src/pdf/layout.ts
 var HEADER_GRAY = "#F0F0F0";
 var HEADING_COLOR = "#2C3E50";
@@ -329,8 +402,9 @@ function buildCoverPage(options) {
   return cover;
 }
 function buildDocumentDefinition(options) {
-  const { recordTitle, recordId, version, date, content = [] } = options;
+  const { rootDir, config, recordTitle, recordId, version, date, content = [] } = options;
   const coverPage = buildCoverPage(options);
+  const logo = resolveHeaderLogo(rootDir, config.branding.logo);
   return {
     pageSize: "A4",
     pageMargins: [40, 80, 40, 50],
@@ -353,7 +427,7 @@ function buildDocumentDefinition(options) {
           widths: [usableWidth * 0.2, "*", usableWidth * 0.25],
           body: [
             [
-              { text: "[LOGO]", fontSize: 8, color: "#999999" },
+              logo,
               {
                 stack: [
                   { text: recordTitle, bold: true, fontSize: 10, alignment: "center" },
@@ -436,6 +510,7 @@ function generateUrs(input) {
   }
   return buildDocumentDefinition({
     config: input.config,
+    rootDir: input.rootDir,
     recordTitle: "User Requirements Specification",
     recordId: "URS",
     version: input.version,
@@ -472,6 +547,7 @@ function generatePrs(input) {
   }
   return buildDocumentDefinition({
     config: input.config,
+    rootDir: input.rootDir,
     recordTitle: "Product Requirements Specification",
     recordId: "PRS",
     version: input.version,
@@ -508,6 +584,7 @@ function generateSrs(input) {
   }
   return buildDocumentDefinition({
     config: input.config,
+    rootDir: input.rootDir,
     recordTitle: "Software Requirements Specification",
     recordId: "SRS",
     version: input.version,
@@ -725,6 +802,7 @@ function generatePta(input) {
   }
   return buildDocumentDefinition({
     config: input.config,
+    rootDir: input.rootDir,
     recordTitle: "Product Traceability Analysis",
     recordId: "PTA",
     version: input.version,
@@ -798,8 +876,8 @@ ${probabilityLabels[labelIndex]}`,
 
 // src/generators/rmr-generator.ts
 import { RiskMatrixConfigSchema } from "@pactosigna/schemas";
-import { readFileSync as readFileSync3, existsSync as existsSync2 } from "fs";
-import { resolve as resolve3 } from "path";
+import { readFileSync as readFileSync4, existsSync as existsSync3 } from "fs";
+import { resolve as resolve4 } from "path";
 import { parse as parseYaml2 } from "yaml";
 var HEADER_GRAY3 = "#F0F0F0";
 function isHazard(doc) {
@@ -810,12 +888,12 @@ function isRiskEntry(doc) {
 }
 function loadRiskMatrix(rootDir) {
   const candidates = [
-    resolve3(rootDir, "risk-matrix.yaml"),
-    resolve3(rootDir, "docs/risk/risk-matrix.yaml")
+    resolve4(rootDir, "risk-matrix.yaml"),
+    resolve4(rootDir, "docs/risk/risk-matrix.yaml")
   ];
   for (const candidate of candidates) {
-    if (existsSync2(candidate)) {
-      const raw = readFileSync3(candidate, "utf-8");
+    if (existsSync3(candidate)) {
+      const raw = readFileSync4(candidate, "utf-8");
       const parsed = parseYaml2(raw);
       const result = RiskMatrixConfigSchema.safeParse(parsed);
       if (result.success) {
@@ -1031,6 +1109,7 @@ function generateRmr(input) {
   }
   return buildDocumentDefinition({
     config: input.config,
+    rootDir: input.rootDir,
     recordTitle: "Risk Management Report",
     recordId: "RMR",
     version: input.version,
@@ -1042,8 +1121,8 @@ function generateRmr(input) {
 
 // src/github/changelog.ts
 import { execFileSync } from "child_process";
-import { resolve as resolve4 } from "path";
-import { readFileSync as readFileSync4 } from "fs";
+import { resolve as resolve5 } from "path";
+import { readFileSync as readFileSync5 } from "fs";
 import matter2 from "gray-matter";
 function buildChangelog(rootDir, version, date) {
   let previousTag = null;
@@ -1077,7 +1156,7 @@ function buildChangelog(rootDir, version, date) {
   const descriptions = [];
   for (const file of changedFiles.slice(0, 20)) {
     try {
-      const raw = readFileSync4(resolve4(rootDir, file), "utf-8");
+      const raw = readFileSync5(resolve5(rootDir, file), "utf-8");
       const { data } = matter2(raw);
       if (data.id && data.title) {
         descriptions.push(`${data.id}: ${data.title}`);

package/dist/pdf/layout.d.ts

@@ -7,6 +7,7 @@ export interface RevisionEntry {
 }
 export interface LayoutOptions {
     config: RecordsConfig;
+    rootDir: string;
     recordTitle: string;
     recordId: string;
     version: string;

package/dist/pdf/layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/pdf/layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,aAAa,EAAE,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;CACrB;AAMD,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,EAAE,CA2DhE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,aAAa,GAAG,oBAAoB,CAsFpF"}
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/pdf/layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,aAAa,EAAE,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;CACrB;AAMD,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,EAAE,CA2DhE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,aAAa,GAAG,oBAAoB,CAuFpF"}

package/dist/pdf/logo.d.ts

@@ -0,0 +1,10 @@
+import type { Content } from 'pdfmake/interfaces';
+/**
+ * Resolves the logo to use in the PDF header.
+ *
+ * Priority:
+ * 1. Custom logo path from `branding.logo` in pactosigna.yaml (PNG only)
+ * 2. Built-in PactoSigna shield icon (SVG, always available)
+ */
+export declare function resolveHeaderLogo(rootDir: string, customLogoPath?: string): Content;
+//# sourceMappingURL=logo.d.ts.map

package/dist/pdf/logo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logo.d.ts","sourceRoot":"","sources":["../../src/pdf/logo.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAiBlD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAkBnF"}

package/dist/pdf/markdown-to-pdfmake.d.ts

@@ -1,4 +1,6 @@
 import type { Content } from 'pdfmake/interfaces';
+/** Replace Unicode characters unsupported by WinAnsiEncoding with ASCII equivalents. */
+export declare function sanitizeUnicode(text: string): string;
 /**
  * Converts a markdown string to an array of pdfmake content nodes.
  *

package/dist/pdf/markdown-to-pdfmake.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown-to-pdfmake.d.ts","sourceRoot":"","sources":["../../src/pdf/markdown-to-pdfmake.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,oBAAoB,CAAC;AAO/D;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE,CA4E7D"}
+{"version":3,"file":"markdown-to-pdfmake.d.ts","sourceRoot":"","sources":["../../src/pdf/markdown-to-pdfmake.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,oBAAoB,CAAC;AAoC/D,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAID;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE,CA4E7D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pactosigna/records",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "type": "module",
   "description": "Generate audit-ready regulatory PDF records from PactoSigna-compliant git repositories",
   "publishConfig": {