@pactosigna/records 0.1.6 → 0.1.8

package/dist/cli.js

@@ -876,7 +876,7 @@ ${probabilityLabels[labelIndex]}`,
   };
 }
 
-// ../schemas/dist/index.js
+// ../../node_modules/.pnpm/@pactosigna+schemas@0.1.19/node_modules/@pactosigna/schemas/dist/index.js
 import { z as z2 } from "zod";
 import { z as z22 } from "zod";
 import { z as z3 } from "zod";
@@ -5351,11 +5351,257 @@ function generateSdd(input) {
   });
 }
 
+// src/generators/vv-generator.ts
+function generateVv(input) {
+  const protocols = readDocuments(input.rootDir, "docs/test/protocols");
+  const reports = readDocuments(input.rootDir, "docs/test/reports");
+  const plans = readDocuments(input.rootDir, "docs/software/plans").filter(
+    (d) => d.frontmatter.id.startsWith("STP-")
+  );
+  const docs = [...plans, ...protocols, ...reports];
+  if (docs.length === 0) {
+    console.warn("VV: no approved/effective V&V documents found \u2014 skipping");
+    return null;
+  }
+  const content = [];
+  content.push({ text: "Table of Contents", style: "h2", margin: [0, 0, 0, 10] });
+  content.push({
+    ol: docs.map((d) => ({
+      text: `${d.frontmatter.id}: ${d.frontmatter.title}`,
+      margin: [0, 2, 0, 2]
+    }))
+  });
+  content.push({ text: "", pageBreak: "after" });
+  for (const doc of docs) {
+    content.push({
+      text: `${doc.frontmatter.id}: ${doc.frontmatter.title}`,
+      style: "h2",
+      margin: [0, 10, 0, 6]
+    });
+    content.push(...markdownToPdfmake(doc.body));
+    content.push({ text: "", margin: [0, 20, 0, 0] });
+  }
+  return buildDocumentDefinition({
+    config: input.config,
+    rootDir: input.rootDir,
+    recordTitle: "Verification & Validation",
+    recordId: "VV",
+    version: input.version,
+    date: input.date,
+    revisionHistory: input.revisionHistory,
+    content
+  });
+}
+
+// src/generators/uef-generator.ts
+function generateUef(input) {
+  const plans = readDocuments(input.rootDir, "docs/usability");
+  const useSpecs = readDocuments(input.rootDir, "docs/usability/use-specifications");
+  const taskAnalyses = readDocuments(input.rootDir, "docs/usability/task-analyses");
+  const evaluations = readDocuments(input.rootDir, "docs/usability/evaluations");
+  const docs = [...plans, ...useSpecs, ...taskAnalyses, ...evaluations];
+  if (docs.length === 0) {
+    console.warn("UEF: no approved/effective usability documents found \u2014 skipping");
+    return null;
+  }
+  const content = [];
+  content.push({ text: "Table of Contents", style: "h2", margin: [0, 0, 0, 10] });
+  content.push({
+    ol: docs.map((d) => ({
+      text: `${d.frontmatter.id}: ${d.frontmatter.title}`,
+      margin: [0, 2, 0, 2]
+    }))
+  });
+  content.push({ text: "", pageBreak: "after" });
+  for (const doc of docs) {
+    content.push({
+      text: `${doc.frontmatter.id}: ${doc.frontmatter.title}`,
+      style: "h2",
+      margin: [0, 10, 0, 6]
+    });
+    content.push(...markdownToPdfmake(doc.body));
+    content.push({ text: "", margin: [0, 20, 0, 0] });
+  }
+  return buildDocumentDefinition({
+    config: input.config,
+    rootDir: input.rootDir,
+    recordTitle: "Usability Engineering File",
+    recordId: "UEF",
+    version: input.version,
+    date: input.date,
+    revisionHistory: input.revisionHistory,
+    content
+  });
+}
+
+// src/generators/csf-generator.ts
+function generateCsf(input) {
+  const plans = readDocuments(input.rootDir, "docs/cybersecurity/plans");
+  const risks = readDocuments(input.rootDir, "docs/cybersecurity/risks");
+  const sboms = readDocuments(input.rootDir, "docs/cybersecurity/sbom");
+  const docs = [...plans, ...risks, ...sboms];
+  if (docs.length === 0) {
+    console.warn("CSF: no approved/effective cybersecurity documents found \u2014 skipping");
+    return null;
+  }
+  const content = [];
+  content.push({ text: "Table of Contents", style: "h2", margin: [0, 0, 0, 10] });
+  content.push({
+    ol: docs.map((d) => ({
+      text: `${d.frontmatter.id}: ${d.frontmatter.title}`,
+      margin: [0, 2, 0, 2]
+    }))
+  });
+  content.push({ text: "", pageBreak: "after" });
+  for (const doc of docs) {
+    content.push({
+      text: `${doc.frontmatter.id}: ${doc.frontmatter.title}`,
+      style: "h2",
+      margin: [0, 10, 0, 6]
+    });
+    content.push(...markdownToPdfmake(doc.body));
+    content.push({ text: "", margin: [0, 20, 0, 0] });
+  }
+  return buildDocumentDefinition({
+    config: input.config,
+    rootDir: input.rootDir,
+    recordTitle: "Cybersecurity File",
+    recordId: "CSF",
+    version: input.version,
+    date: input.date,
+    revisionHistory: input.revisionHistory,
+    content
+  });
+}
+
+// src/generators/cer-generator.ts
+function generateCer(input) {
+  const docs = readDocuments(input.rootDir, "docs/clinical");
+  if (docs.length === 0) {
+    console.warn("CER: no approved/effective clinical documents found \u2014 skipping");
+    return null;
+  }
+  const content = [];
+  content.push({ text: "Table of Contents", style: "h2", margin: [0, 0, 0, 10] });
+  content.push({
+    ol: docs.map((d) => ({
+      text: `${d.frontmatter.id}: ${d.frontmatter.title}`,
+      margin: [0, 2, 0, 2]
+    }))
+  });
+  content.push({ text: "", pageBreak: "after" });
+  for (const doc of docs) {
+    content.push({
+      text: `${doc.frontmatter.id}: ${doc.frontmatter.title}`,
+      style: "h2",
+      margin: [0, 10, 0, 6]
+    });
+    content.push(...markdownToPdfmake(doc.body));
+    content.push({ text: "", margin: [0, 20, 0, 0] });
+  }
+  return buildDocumentDefinition({
+    config: input.config,
+    rootDir: input.rootDir,
+    recordTitle: "Clinical Evaluation Report",
+    recordId: "CER",
+    version: input.version,
+    date: input.date,
+    revisionHistory: input.revisionHistory,
+    content
+  });
+}
+
 // src/github/changelog.ts
 import { execFileSync } from "child_process";
-import { resolve as resolve5 } from "path";
-import { readFileSync as readFileSync5 } from "fs";
+import { resolve as resolve6 } from "path";
+import { readFileSync as readFileSync6 } from "fs";
+import matter4 from "gray-matter";
+
+// src/github/drm-parser.ts
+import { readdirSync as readdirSync2, readFileSync as readFileSync5, existsSync as existsSync4 } from "fs";
+import { resolve as resolve5, join as join2 } from "path";
 import matter3 from "gray-matter";
+function parseDrmDocsTable(body) {
+  const startTag = "<!-- DRM:DOCS_START -->";
+  const endTag = "<!-- DRM:DOCS_END -->";
+  const startIdx = body.indexOf(startTag);
+  const endIdx = body.indexOf(endTag);
+  if (startIdx === -1 || endIdx === -1 || endIdx <= startIdx) return [];
+  const block = body.slice(startIdx + startTag.length, endIdx).trim();
+  const lines = block.split("\n");
+  const entries = [];
+  for (const line of lines) {
+    if (!line.startsWith("|")) continue;
+    const cells = line.split("|").map((c) => c.trim()).filter((c) => c.length > 0);
+    if (cells.length < 2) continue;
+    const action = cells[0].toUpperCase();
+    if (action === "ACTION" || /^-+$/.test(action) || action === "NONE") continue;
+    if (action !== "CREATE" && action !== "UPDATE") continue;
+    const target = cells[1];
+    const reason = cells.length > 2 ? cells[cells.length - 1] : "";
+    entries.push({
+      action,
+      target,
+      reason
+    });
+  }
+  return entries;
+}
+var DRM_FOLDERS = ["docs/change/drm", "docs/design-review"];
+function readDrmFiles(rootDir) {
+  const drms = [];
+  for (const folder of DRM_FOLDERS) {
+    const fullPath = resolve5(rootDir, folder);
+    if (!existsSync4(fullPath)) continue;
+    let files;
+    try {
+      files = readdirSync2(fullPath).filter((f) => f.endsWith(".md"));
+    } catch {
+      continue;
+    }
+    for (const file of files) {
+      const filePath = join2(folder, file);
+      const raw = readFileSync5(resolve5(rootDir, filePath), "utf-8");
+      const { data, content } = matter3(raw);
+      if (!data.id || !data.title) continue;
+      const docEntries = parseDrmDocsTable(content);
+      drms.push({
+        id: data.id,
+        title: data.title,
+        status: data.status ?? "unknown",
+        releasePlan: data.release_plan,
+        docEntries
+      });
+    }
+  }
+  return drms.sort((a, b) => a.id.localeCompare(b.id, void 0, { numeric: true }));
+}
+function extractDocIdFromPath(target) {
+  const filename = target.split("/").pop() ?? target;
+  return filename.replace(/\.md$/, "");
+}
+
+// src/github/changelog.ts
+function buildSmartChangelog(rootDir, version, date) {
+  const drms = readDrmFiles(rootDir);
+  const entries = buildRevisionEntriesFromDrms(drms, version, date);
+  if (entries.length === 0) {
+    return buildChangelog(rootDir, version, date);
+  }
+  return entries;
+}
+function buildRevisionEntriesFromDrms(drms, version, date) {
+  const withDocEntries = drms.filter((drm) => drm.docEntries.length > 0);
+  if (withDocEntries.length === 0) return [];
+  return withDocEntries.map((drm) => {
+    const reasons = drm.docEntries.map((entry) => {
+      const docId = extractDocIdFromPath(entry.target);
+      return entry.reason ? `${docId}: ${entry.reason}` : docId;
+    });
+    const description = `[${drm.id}] ${reasons.join("; ")}`;
+    return { revision: version, date, description };
+  });
+}
 function buildChangelog(rootDir, version, date) {
   let previousTag = null;
   try {
@@ -5388,8 +5634,8 @@ function buildChangelog(rootDir, version, date) {
   const descriptions = [];
   for (const file of changedFiles.slice(0, 20)) {
     try {
-      const raw = readFileSync5(resolve5(rootDir, file), "utf-8");
-      const { data } = matter3(raw);
+      const raw = readFileSync6(resolve6(rootDir, file), "utf-8");
+      const { data } = matter4(raw);
       if (data.id && data.title) {
         descriptions.push(`${data.id}: ${data.title}`);
       }
@@ -5409,7 +5655,11 @@ var RECORD_GENERATORS = [
   { name: "ARC-Software-Architecture-Description", fn: generateArc },
   { name: "SDD-Software-Detailed-Design", fn: generateSdd },
   { name: "PTA-Product-Traceability-Analysis", fn: generatePta },
-  { name: "RMR-Risk-Management-Report", fn: generateRmr }
+  { name: "RMR-Risk-Management-Report", fn: generateRmr },
+  { name: "VV-Verification-And-Validation", fn: generateVv },
+  { name: "UEF-Usability-Engineering-File", fn: generateUef },
+  { name: "CSF-Cybersecurity-File", fn: generateCsf },
+  { name: "CER-Clinical-Evaluation-Report", fn: generateCer }
 ];
 var noopUrlResolver = {
   resolve: () => {
@@ -5431,7 +5681,7 @@ async function generate(options) {
   const outDir = options.outputDir ?? pathResolve(options.rootDir, "out");
   mkdirSync(outDir, { recursive: true });
   const date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-  const revisionHistory = buildChangelog(options.rootDir, options.version, date);
+  const revisionHistory = buildSmartChangelog(options.rootDir, options.version, date);
   const fonts = {
     Helvetica: {
       normal: "Helvetica",
@@ -5487,11 +5737,11 @@ function getDraftReleaseVersion() {
 
 // src/github/publish.ts
 import { execFileSync as execFileSync3 } from "child_process";
-import { readdirSync as readdirSync2 } from "fs";
-import { resolve as resolve6 } from "path";
+import { readdirSync as readdirSync3 } from "fs";
+import { resolve as resolve7 } from "path";
 function publishDraftRelease(version, outputDir) {
   const tag = `v${version}`;
-  const pdfFiles = readdirSync2(outputDir).filter((f) => f.endsWith(".pdf")).map((f) => resolve6(outputDir, f));
+  const pdfFiles = readdirSync3(outputDir).filter((f) => f.endsWith(".pdf")).map((f) => resolve7(outputDir, f));
   if (pdfFiles.length === 0) {
     throw new Error("No PDF files found to upload");
   }

package/dist/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAkCD,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA8C1E"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAyBA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAsCD,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA8C1E"}

package/dist/generators/cer-generator.d.ts

@@ -0,0 +1,10 @@
+import type { TDocumentDefinitions } from 'pdfmake/interfaces.js';
+import type { GeneratorInput } from './urs-generator.js';
+/**
+ * Generate a Clinical Evaluation Report (CER) compiled PDF.
+ *
+ * Reads clinical evaluation plans and reports.
+ * Regulatory basis: MDR Annex XIV
+ */
+export declare function generateCer(input: GeneratorInput): TDocumentDefinitions | null;
+//# sourceMappingURL=cer-generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cer-generator.d.ts","sourceRoot":"","sources":["../../src/generators/cer-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAI3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,oBAAoB,GAAG,IAAI,CAyC9E"}

package/dist/generators/csf-generator.d.ts

@@ -0,0 +1,10 @@
+import type { TDocumentDefinitions } from 'pdfmake/interfaces.js';
+import type { GeneratorInput } from './urs-generator.js';
+/**
+ * Generate a Cybersecurity File (CSF) compiled PDF.
+ *
+ * Reads cybersecurity plans, SBOMs, and security risk documents.
+ * Regulatory basis: IEC 81001-5-1
+ */
+export declare function generateCsf(input: GeneratorInput): TDocumentDefinitions | null;
+//# sourceMappingURL=csf-generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"csf-generator.d.ts","sourceRoot":"","sources":["../../src/generators/csf-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAI3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,oBAAoB,GAAG,IAAI,CA8C9E"}

package/dist/generators/uef-generator.d.ts

@@ -0,0 +1,15 @@
+import type { TDocumentDefinitions } from 'pdfmake/interfaces.js';
+import type { GeneratorInput } from './urs-generator.js';
+/**
+ * Generate a Usability Engineering File (UEF) compiled PDF.
+ *
+ * Reads usability plans, use specifications, task analyses, and evaluations.
+ * Regulatory basis: IEC 62366
+ *
+ * Note: docs/usability/risks (usability_risk type) is intentionally excluded.
+ * Per ISO 14971, usability-related risks belong in the Risk Management File (RMF/RMR),
+ * not the Usability Engineering File. IEC 62366 §5.9 references risk analysis but
+ * delegates the actual risk documentation to ISO 14971.
+ */
+export declare function generateUef(input: GeneratorInput): TDocumentDefinitions | null;
+//# sourceMappingURL=uef-generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uef-generator.d.ts","sourceRoot":"","sources":["../../src/generators/uef-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAI3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,oBAAoB,GAAG,IAAI,CA6C9E"}

package/dist/generators/vv-generator.d.ts

@@ -0,0 +1,10 @@
+import type { TDocumentDefinitions } from 'pdfmake/interfaces.js';
+import type { GeneratorInput } from './urs-generator.js';
+/**
+ * Generate a Verification & Validation (V&V) compiled PDF.
+ *
+ * Reads test protocols, test reports, and software test plans.
+ * Regulatory basis: IEC 62304 Section 5.7
+ */
+export declare function generateVv(input: GeneratorInput): TDocumentDefinitions | null;
+//# sourceMappingURL=vv-generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vv-generator.d.ts","sourceRoot":"","sources":["../../src/generators/vv-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAI3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,oBAAoB,GAAG,IAAI,CA8C7E"}

package/dist/github/changelog.d.ts

@@ -1,3 +1,26 @@
 import type { RevisionEntry } from '../pdf/layout.js';
+import type { ParsedDrm } from './drm-parser.js';
+/**
+ * Build revision entries from DRM (Design Review Meeting) files.
+ *
+ * Reads DRM markdown files from the repository, extracts document-to-reason
+ * mappings from DRM:DOCS tables, and produces meaningful revision descriptions.
+ * Falls back to `buildChangelog()` if no DRM files with doc entries are found.
+ *
+ * @param rootDir - Repository root directory
+ * @param version - Release version string (e.g., "1.2.0")
+ * @param date - Release date in ISO format (e.g., "2026-03-28")
+ * @returns Revision entries with DRM-sourced descriptions
+ */
+export declare function buildSmartChangelog(rootDir: string, version: string, date: string): RevisionEntry[];
+/**
+ * Build revision entries from parsed DRM data.
+ *
+ * Groups DRM doc entries by DRM ID and produces one revision entry per DRM,
+ * with a description summarizing the affected documents and reasons.
+ *
+ * Exported for unit testing without filesystem access.
+ */
+export declare function buildRevisionEntriesFromDrms(drms: ParsedDrm[], version: string, date: string): RevisionEntry[];
 export declare function buildChangelog(rootDir: string, version: string, date: string): RevisionEntry[];
 //# sourceMappingURL=changelog.d.ts.map

package/dist/github/changelog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"changelog.d.ts","sourceRoot":"","sources":["../../src/github/changelog.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAkD9F"}
+{"version":3,"file":"changelog.d.ts","sourceRoot":"","sources":["../../src/github/changelog.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,aAAa,EAAE,CASjB;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,SAAS,EAAE,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,aAAa,EAAE,CAcjB;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAkD9F"}

package/dist/github/drm-parser.d.ts

@@ -0,0 +1,58 @@
+/**
+ * DRM (Design Review Meeting) Parser
+ *
+ * Parses DRM markdown files from git repositories to extract
+ * document-to-reason mappings from DRM:DOCS tables.
+ *
+ * The DRM:DOCS table format uses HTML comment markers:
+ *
+ * ```markdown
+ * <!-- DRM:DOCS_START -->
+ * | Action | Target | Reason |
+ * |--------|--------|--------|
+ * | UPDATE | docs/software/requirements/SRS-001.md | Added validation gate |
+ * <!-- DRM:DOCS_END -->
+ * ```
+ *
+ * This module is a standalone copy of the parsing logic from
+ * scripts/traceability/drm-check.ts, kept independent to avoid
+ * adding cross-package dependencies to the offline records CLI.
+ */
+export interface DrmDocEntry {
+    action: 'CREATE' | 'UPDATE';
+    target: string;
+    reason: string;
+}
+export interface ParsedDrm {
+    id: string;
+    title: string;
+    status: string;
+    releasePlan?: string;
+    docEntries: DrmDocEntry[];
+}
+/**
+ * Parses a DRM:DOCS marker block from a markdown body.
+ *
+ * Extracts rows from the table between `<!-- DRM:DOCS_START -->` and
+ * `<!-- DRM:DOCS_END -->` markers. Each row maps an action (CREATE/UPDATE)
+ * to a target file path and a human-readable reason.
+ */
+export declare function parseDrmDocsTable(body: string): DrmDocEntry[];
+/**
+ * Reads all DRM markdown files from the repository.
+ *
+ * Searches known DRM folders (`docs/change/drm`, `docs/design-review`)
+ * and parses each file's frontmatter and DRM:DOCS table.
+ *
+ * @param rootDir - Repository root directory
+ * @returns Parsed DRM entries, sorted by ID
+ */
+export declare function readDrmFiles(rootDir: string): ParsedDrm[];
+/**
+ * Extracts the document ID from a file path.
+ *
+ * @example
+ * extractDocIdFromPath('docs/software/requirements/SRS-001.md') => 'SRS-001'
+ */
+export declare function extractDocIdFromPath(target: string): string;
+//# sourceMappingURL=drm-parser.d.ts.map

package/dist/github/drm-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drm-parser.d.ts","sourceRoot":"","sources":["../../src/github/drm-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAUH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,WAAW,EAAE,CAAC;CAC3B;AAMD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAyC7D;AASD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAkCzD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAG3D"}

package/dist/index.d.ts

@@ -6,6 +6,10 @@ export { generatePrs } from './generators/prs-generator.js';
 export { generateSrs } from './generators/srs-generator.js';
 export { generatePta, buildTraceabilityMatrix } from './generators/pta-generator.js';
 export { generateRmr, buildRiskGraph } from './generators/rmr-generator.js';
+export { generateVv } from './generators/vv-generator.js';
+export { generateUef } from './generators/uef-generator.js';
+export { generateCsf } from './generators/csf-generator.js';
+export { generateCer } from './generators/cer-generator.js';
 export { loadConfig, RecordsConfigSchema } from './config.js';
 export type { RecordsConfig } from './config.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,YAAY,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACrF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC9D,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,YAAY,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACrF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC9D,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1193,11 +1193,257 @@ function generateSdd(input) {
   });
 }
 
+// src/generators/vv-generator.ts
+function generateVv(input) {
+  const protocols = readDocuments(input.rootDir, "docs/test/protocols");
+  const reports = readDocuments(input.rootDir, "docs/test/reports");
+  const plans = readDocuments(input.rootDir, "docs/software/plans").filter(
+    (d) => d.frontmatter.id.startsWith("STP-")
+  );
+  const docs = [...plans, ...protocols, ...reports];
+  if (docs.length === 0) {
+    console.warn("VV: no approved/effective V&V documents found \u2014 skipping");
+    return null;
+  }
+  const content = [];
+  content.push({ text: "Table of Contents", style: "h2", margin: [0, 0, 0, 10] });
+  content.push({
+    ol: docs.map((d) => ({
+      text: `${d.frontmatter.id}: ${d.frontmatter.title}`,
+      margin: [0, 2, 0, 2]
+    }))
+  });
+  content.push({ text: "", pageBreak: "after" });
+  for (const doc of docs) {
+    content.push({
+      text: `${doc.frontmatter.id}: ${doc.frontmatter.title}`,
+      style: "h2",
+      margin: [0, 10, 0, 6]
+    });
+    content.push(...markdownToPdfmake(doc.body));
+    content.push({ text: "", margin: [0, 20, 0, 0] });
+  }
+  return buildDocumentDefinition({
+    config: input.config,
+    rootDir: input.rootDir,
+    recordTitle: "Verification & Validation",
+    recordId: "VV",
+    version: input.version,
+    date: input.date,
+    revisionHistory: input.revisionHistory,
+    content
+  });
+}
+
+// src/generators/uef-generator.ts
+function generateUef(input) {
+  const plans = readDocuments(input.rootDir, "docs/usability");
+  const useSpecs = readDocuments(input.rootDir, "docs/usability/use-specifications");
+  const taskAnalyses = readDocuments(input.rootDir, "docs/usability/task-analyses");
+  const evaluations = readDocuments(input.rootDir, "docs/usability/evaluations");
+  const docs = [...plans, ...useSpecs, ...taskAnalyses, ...evaluations];
+  if (docs.length === 0) {
+    console.warn("UEF: no approved/effective usability documents found \u2014 skipping");
+    return null;
+  }
+  const content = [];
+  content.push({ text: "Table of Contents", style: "h2", margin: [0, 0, 0, 10] });
+  content.push({
+    ol: docs.map((d) => ({
+      text: `${d.frontmatter.id}: ${d.frontmatter.title}`,
+      margin: [0, 2, 0, 2]
+    }))
+  });
+  content.push({ text: "", pageBreak: "after" });
+  for (const doc of docs) {
+    content.push({
+      text: `${doc.frontmatter.id}: ${doc.frontmatter.title}`,
+      style: "h2",
+      margin: [0, 10, 0, 6]
+    });
+    content.push(...markdownToPdfmake(doc.body));
+    content.push({ text: "", margin: [0, 20, 0, 0] });
+  }
+  return buildDocumentDefinition({
+    config: input.config,
+    rootDir: input.rootDir,
+    recordTitle: "Usability Engineering File",
+    recordId: "UEF",
+    version: input.version,
+    date: input.date,
+    revisionHistory: input.revisionHistory,
+    content
+  });
+}
+
+// src/generators/csf-generator.ts
+function generateCsf(input) {
+  const plans = readDocuments(input.rootDir, "docs/cybersecurity/plans");
+  const risks = readDocuments(input.rootDir, "docs/cybersecurity/risks");
+  const sboms = readDocuments(input.rootDir, "docs/cybersecurity/sbom");
+  const docs = [...plans, ...risks, ...sboms];
+  if (docs.length === 0) {
+    console.warn("CSF: no approved/effective cybersecurity documents found \u2014 skipping");
+    return null;
+  }
+  const content = [];
+  content.push({ text: "Table of Contents", style: "h2", margin: [0, 0, 0, 10] });
+  content.push({
+    ol: docs.map((d) => ({
+      text: `${d.frontmatter.id}: ${d.frontmatter.title}`,
+      margin: [0, 2, 0, 2]
+    }))
+  });
+  content.push({ text: "", pageBreak: "after" });
+  for (const doc of docs) {
+    content.push({
+      text: `${doc.frontmatter.id}: ${doc.frontmatter.title}`,
+      style: "h2",
+      margin: [0, 10, 0, 6]
+    });
+    content.push(...markdownToPdfmake(doc.body));
+    content.push({ text: "", margin: [0, 20, 0, 0] });
+  }
+  return buildDocumentDefinition({
+    config: input.config,
+    rootDir: input.rootDir,
+    recordTitle: "Cybersecurity File",
+    recordId: "CSF",
+    version: input.version,
+    date: input.date,
+    revisionHistory: input.revisionHistory,
+    content
+  });
+}
+
+// src/generators/cer-generator.ts
+function generateCer(input) {
+  const docs = readDocuments(input.rootDir, "docs/clinical");
+  if (docs.length === 0) {
+    console.warn("CER: no approved/effective clinical documents found \u2014 skipping");
+    return null;
+  }
+  const content = [];
+  content.push({ text: "Table of Contents", style: "h2", margin: [0, 0, 0, 10] });
+  content.push({
+    ol: docs.map((d) => ({
+      text: `${d.frontmatter.id}: ${d.frontmatter.title}`,
+      margin: [0, 2, 0, 2]
+    }))
+  });
+  content.push({ text: "", pageBreak: "after" });
+  for (const doc of docs) {
+    content.push({
+      text: `${doc.frontmatter.id}: ${doc.frontmatter.title}`,
+      style: "h2",
+      margin: [0, 10, 0, 6]
+    });
+    content.push(...markdownToPdfmake(doc.body));
+    content.push({ text: "", margin: [0, 20, 0, 0] });
+  }
+  return buildDocumentDefinition({
+    config: input.config,
+    rootDir: input.rootDir,
+    recordTitle: "Clinical Evaluation Report",
+    recordId: "CER",
+    version: input.version,
+    date: input.date,
+    revisionHistory: input.revisionHistory,
+    content
+  });
+}
+
 // src/github/changelog.ts
 import { execFileSync } from "child_process";
-import { resolve as resolve5 } from "path";
-import { readFileSync as readFileSync5 } from "fs";
+import { resolve as resolve6 } from "path";
+import { readFileSync as readFileSync6 } from "fs";
+import matter3 from "gray-matter";
+
+// src/github/drm-parser.ts
+import { readdirSync as readdirSync2, readFileSync as readFileSync5, existsSync as existsSync4 } from "fs";
+import { resolve as resolve5, join as join2 } from "path";
 import matter2 from "gray-matter";
+function parseDrmDocsTable(body) {
+  const startTag = "<!-- DRM:DOCS_START -->";
+  const endTag = "<!-- DRM:DOCS_END -->";
+  const startIdx = body.indexOf(startTag);
+  const endIdx = body.indexOf(endTag);
+  if (startIdx === -1 || endIdx === -1 || endIdx <= startIdx) return [];
+  const block = body.slice(startIdx + startTag.length, endIdx).trim();
+  const lines = block.split("\n");
+  const entries = [];
+  for (const line of lines) {
+    if (!line.startsWith("|")) continue;
+    const cells = line.split("|").map((c) => c.trim()).filter((c) => c.length > 0);
+    if (cells.length < 2) continue;
+    const action = cells[0].toUpperCase();
+    if (action === "ACTION" || /^-+$/.test(action) || action === "NONE") continue;
+    if (action !== "CREATE" && action !== "UPDATE") continue;
+    const target = cells[1];
+    const reason = cells.length > 2 ? cells[cells.length - 1] : "";
+    entries.push({
+      action,
+      target,
+      reason
+    });
+  }
+  return entries;
+}
+var DRM_FOLDERS = ["docs/change/drm", "docs/design-review"];
+function readDrmFiles(rootDir) {
+  const drms = [];
+  for (const folder of DRM_FOLDERS) {
+    const fullPath = resolve5(rootDir, folder);
+    if (!existsSync4(fullPath)) continue;
+    let files;
+    try {
+      files = readdirSync2(fullPath).filter((f) => f.endsWith(".md"));
+    } catch {
+      continue;
+    }
+    for (const file of files) {
+      const filePath = join2(folder, file);
+      const raw = readFileSync5(resolve5(rootDir, filePath), "utf-8");
+      const { data, content } = matter2(raw);
+      if (!data.id || !data.title) continue;
+      const docEntries = parseDrmDocsTable(content);
+      drms.push({
+        id: data.id,
+        title: data.title,
+        status: data.status ?? "unknown",
+        releasePlan: data.release_plan,
+        docEntries
+      });
+    }
+  }
+  return drms.sort((a, b) => a.id.localeCompare(b.id, void 0, { numeric: true }));
+}
+function extractDocIdFromPath(target) {
+  const filename = target.split("/").pop() ?? target;
+  return filename.replace(/\.md$/, "");
+}
+
+// src/github/changelog.ts
+function buildSmartChangelog(rootDir, version, date) {
+  const drms = readDrmFiles(rootDir);
+  const entries = buildRevisionEntriesFromDrms(drms, version, date);
+  if (entries.length === 0) {
+    return buildChangelog(rootDir, version, date);
+  }
+  return entries;
+}
+function buildRevisionEntriesFromDrms(drms, version, date) {
+  const withDocEntries = drms.filter((drm) => drm.docEntries.length > 0);
+  if (withDocEntries.length === 0) return [];
+  return withDocEntries.map((drm) => {
+    const reasons = drm.docEntries.map((entry) => {
+      const docId = extractDocIdFromPath(entry.target);
+      return entry.reason ? `${docId}: ${entry.reason}` : docId;
+    });
+    const description = `[${drm.id}] ${reasons.join("; ")}`;
+    return { revision: version, date, description };
+  });
+}
 function buildChangelog(rootDir, version, date) {
   let previousTag = null;
   try {
@@ -1230,8 +1476,8 @@ function buildChangelog(rootDir, version, date) {
   const descriptions = [];
   for (const file of changedFiles.slice(0, 20)) {
     try {
-      const raw = readFileSync5(resolve5(rootDir, file), "utf-8");
-      const { data } = matter2(raw);
+      const raw = readFileSync6(resolve6(rootDir, file), "utf-8");
+      const { data } = matter3(raw);
       if (data.id && data.title) {
         descriptions.push(`${data.id}: ${data.title}`);
       }
@@ -1251,7 +1497,11 @@ var RECORD_GENERATORS = [
   { name: "ARC-Software-Architecture-Description", fn: generateArc },
   { name: "SDD-Software-Detailed-Design", fn: generateSdd },
   { name: "PTA-Product-Traceability-Analysis", fn: generatePta },
-  { name: "RMR-Risk-Management-Report", fn: generateRmr }
+  { name: "RMR-Risk-Management-Report", fn: generateRmr },
+  { name: "VV-Verification-And-Validation", fn: generateVv },
+  { name: "UEF-Usability-Engineering-File", fn: generateUef },
+  { name: "CSF-Cybersecurity-File", fn: generateCsf },
+  { name: "CER-Clinical-Evaluation-Report", fn: generateCer }
 ];
 var noopUrlResolver = {
   resolve: () => {
@@ -1273,7 +1523,7 @@ async function generate(options) {
   const outDir = options.outputDir ?? pathResolve(options.rootDir, "out");
   mkdirSync(outDir, { recursive: true });
   const date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-  const revisionHistory = buildChangelog(options.rootDir, options.version, date);
+  const revisionHistory = buildSmartChangelog(options.rootDir, options.version, date);
   const fonts = {
     Helvetica: {
       normal: "Helvetica",
@@ -1313,10 +1563,14 @@ export {
   buildRiskGraph,
   buildTraceabilityMatrix,
   generate,
+  generateCer,
+  generateCsf,
   generatePrs,
   generatePta,
   generateRmr,
   generateSrs,
+  generateUef,
   generateUrs,
+  generateVv,
   loadConfig
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pactosigna/records",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "type": "module",
   "description": "Generate audit-ready regulatory PDF records from PactoSigna-compliant git repositories",
   "publishConfig": {
@@ -41,7 +41,7 @@
     "typescript": "^5.7.2",
     "vitest": "^3.0.0",
     "zod": "^3.24.1",
-    "@pactosigna/schemas": "0.1.0"
+    "@pactosigna/schemas": "0.1.19"
   },
   "repository": {
     "type": "git",