@pactosigna/records 0.1.7 → 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";
@@ -3212,18 +3212,7 @@ var DocumentSignoffStatusResponseSchema = z33.object({
 var DocumentExportResponseSchema = z33.object({
   message: z33.string()
 });
-var CompiledDocumentPresetSchema = z43.enum([
-  "srs",
-  "prs",
-  "dmr",
-  "risk",
-  "hld",
-  "sdd",
-  "vv",
-  "uef",
-  "csf",
-  "cer"
-]);
+var CompiledDocumentPresetSchema = z43.enum(["srs", "prs", "dmr", "risk"]);
 var CompiledDocumentQuerySchema = z43.object({
   organizationId: z43.string().min(1),
   repositoryId: z43.string().min(1).optional(),
@@ -5524,9 +5513,95 @@ function generateCer(input) {
 
 // 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 {
@@ -5559,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}`);
       }
@@ -5606,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",
@@ -5662,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/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.js

@@ -1355,9 +1355,95 @@ function generateCer(input) {
 
 // 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 {
@@ -1390,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}`);
       }
@@ -1437,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",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pactosigna/records",
-  "version": "0.1.7",
+  "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",