@forwardimpact/libsyntheticrender 0.1.1

package/render/validate-links.js

@@ -0,0 +1,329 @@
+/**
+ * Link Validator — validates IRI consistency and link density.
+ *
+ * Checks that generated HTML files contain valid cross-file IRI links
+ * and that every entity meets minimum link density requirements.
+ *
+ * @module libuniverse/render/validate-links
+ */
+
+/**
+ * Validate linked entities for IRI consistency and density.
+ * @param {import('./link-assigner.js').LinkedEntities} linked
+ * @param {string} domain
+ * @returns {{ passed: boolean, checks: object[] }}
+ */
+export function validateLinks(linked, domain) {
+  const checks = [
+    checkIriNamespace(linked, domain),
+    checkProjectLinkDensity(linked),
+    checkCourseLinkDensity(linked),
+    checkEventLinkDensity(linked),
+    checkBlogLinkDensity(linked),
+    checkPlatformDAG(linked),
+    checkDrugDerivatives(linked),
+    checkCoursePrerequisites(linked),
+  ];
+
+  const failures = checks.filter((c) => !c.passed);
+  return {
+    passed: failures.length === 0,
+    total: checks.length,
+    failures: failures.length,
+    checks,
+  };
+}
+
+/**
+ * Check all IRIs use the correct domain namespace.
+ */
+function checkIriNamespace(linked, domain) {
+  const prefix = `https://${domain}/id/`;
+  const errors = [];
+
+  for (const proj of linked.projects) {
+    if (!proj.iri.startsWith(prefix)) {
+      errors.push(`Project ${proj.id}: IRI ${proj.iri} doesn't match domain`);
+    }
+  }
+  for (const drug of linked.drugs) {
+    if (!drug.iri.startsWith(prefix)) {
+      errors.push(`Drug ${drug.id}: IRI ${drug.iri} doesn't match domain`);
+    }
+  }
+  for (const plat of linked.platforms) {
+    if (!plat.iri.startsWith(prefix)) {
+      errors.push(`Platform ${plat.id}: IRI ${plat.iri} doesn't match domain`);
+    }
+  }
+
+  return {
+    name: "iri_namespace",
+    passed: errors.length === 0,
+    message:
+      errors.length === 0
+        ? "All IRIs use consistent namespace"
+        : `${errors.length} IRI namespace violations: ${errors[0]}`,
+  };
+}
+
+/**
+ * Check every project has at least 2 cross-file links.
+ */
+function checkProjectLinkDensity(linked) {
+  const sparse = linked.projects.filter((proj) => {
+    const linkCount =
+      (proj.drugLinks?.length || 0) +
+      (proj.platformLinks?.length || 0) +
+      (proj.members?.length || 0);
+    return linkCount < 2;
+  });
+
+  return {
+    name: "project_link_density",
+    passed: sparse.length === 0,
+    message:
+      sparse.length === 0
+        ? "All projects have ≥2 cross-file links"
+        : `${sparse.length} projects have <2 cross-file links`,
+  };
+}
+
+/**
+ * Check every course has at least 2 cross-file links.
+ */
+function checkCourseLinkDensity(linked) {
+  const sparse = linked.courses.filter((course) => {
+    const linkCount =
+      (course.prerequisiteIris?.length || 0) +
+      (course.platformLink ? 1 : 0) +
+      (course.drugLink ? 1 : 0) +
+      (course.attendees?.length || 0);
+    return linkCount < 2;
+  });
+
+  return {
+    name: "course_link_density",
+    passed: sparse.length === 0,
+    message:
+      sparse.length === 0
+        ? "All courses have ≥2 cross-file links"
+        : `${sparse.length} courses have <2 cross-file links`,
+  };
+}
+
+/**
+ * Check every event has at least 2 cross-file links.
+ */
+function checkEventLinkDensity(linked) {
+  const sparse = linked.events.filter((event) => {
+    const linkCount =
+      1 + // organizer
+      (event.attendees?.length || 0) +
+      (event.aboutProjects?.length || 0) +
+      (event.aboutDrugs?.length || 0) +
+      (event.aboutPlatforms?.length || 0);
+    return linkCount < 2;
+  });
+
+  return {
+    name: "event_link_density",
+    passed: sparse.length === 0,
+    message:
+      sparse.length === 0
+        ? "All events have ≥2 cross-file links"
+        : `${sparse.length} events have <2 cross-file links`,
+  };
+}
+
+/**
+ * Check every blog post has at least 2 cross-file links.
+ */
+function checkBlogLinkDensity(linked) {
+  const sparse = linked.blogPosts.filter((post) => {
+    const linkCount =
+      1 + // author
+      (post.aboutDrugs?.length || 0) +
+      (post.aboutPlatforms?.length || 0) +
+      (post.aboutProjects?.length || 0) +
+      (post.mentionsPeople?.length || 0);
+    return linkCount < 2;
+  });
+
+  return {
+    name: "blog_link_density",
+    passed: sparse.length === 0,
+    message:
+      sparse.length === 0
+        ? "All blog posts have ≥2 cross-file links"
+        : `${sparse.length} blog posts have <2 cross-file links`,
+  };
+}
+
+/**
+ * Check platform dependencies form a DAG (no cycles).
+ */
+function checkPlatformDAG(linked) {
+  const platformMap = new Map(linked.platforms.map((p) => [p.id, p]));
+  const visited = new Set();
+  const stack = new Set();
+  let cycle = null;
+
+  function dfs(id) {
+    if (stack.has(id)) {
+      cycle = id;
+      return true;
+    }
+    if (visited.has(id)) return false;
+    visited.add(id);
+    stack.add(id);
+
+    const plat = platformMap.get(id);
+    if (plat) {
+      const deps = (plat.dependencies || []).map((d) =>
+        typeof d === "string" ? d : d.id,
+      );
+      for (const dep of deps) {
+        if (dfs(dep)) return true;
+      }
+    }
+
+    stack.delete(id);
+    return false;
+  }
+
+  for (const plat of linked.platforms) {
+    if (dfs(plat.id)) break;
+  }
+
+  return {
+    name: "platform_dag",
+    passed: !cycle,
+    message: cycle
+      ? `Platform dependency cycle detected at: ${cycle}`
+      : "Platform dependencies form a valid DAG",
+  };
+}
+
+/**
+ * Check drug derivative references point to valid parent drugs.
+ */
+function checkDrugDerivatives(linked) {
+  const drugIds = new Set(linked.drugs.map((d) => d.id));
+  const errors = linked.drugs
+    .filter((d) => d.parentDrug && !drugIds.has(d.parentDrug))
+    .map((d) => `${d.id} references unknown parent ${d.parentDrug}`);
+
+  return {
+    name: "drug_derivatives",
+    passed: errors.length === 0,
+    message:
+      errors.length === 0
+        ? "All drug derivative references are valid"
+        : `${errors.length} invalid derivative references`,
+  };
+}
+
+/**
+ * Check course prerequisite references point to valid courses.
+ */
+function checkCoursePrerequisites(linked) {
+  const courseIds = new Set(linked.courses.map((c) => c.id));
+  const errors = [];
+  for (const course of linked.courses) {
+    for (const prereq of course.prerequisites || []) {
+      if (!courseIds.has(prereq)) {
+        errors.push(`${course.id} references unknown prerequisite ${prereq}`);
+      }
+    }
+  }
+
+  return {
+    name: "course_prerequisites",
+    passed: errors.length === 0,
+    message:
+      errors.length === 0
+        ? "All course prerequisite references are valid"
+        : `${errors.length} invalid prerequisite references`,
+  };
+}
+
+/**
+ * Validate rendered HTML files for IRI consistency.
+ * @param {Map<string, string>} htmlFiles - filename → HTML content
+ * @param {string} domain
+ * @returns {{ passed: boolean, checks: object[] }}
+ */
+export function validateHTML(htmlFiles, domain) {
+  const checks = [
+    checkEnrichedIriNamespace(htmlFiles, domain),
+    checkOrphanedLinks(htmlFiles),
+  ];
+
+  const failures = checks.filter((c) => !c.passed);
+  return {
+    passed: failures.length === 0,
+    total: checks.length,
+    failures: failures.length,
+    checks,
+  };
+}
+
+/**
+ * Scan all HTML for itemid values outside the universe domain.
+ */
+function checkEnrichedIriNamespace(htmlFiles, domain) {
+  const errors = [];
+  const ITEMID_RE = /itemid="([^"]*)"/g;
+
+  for (const [filename, html] of htmlFiles) {
+    for (const match of html.matchAll(ITEMID_RE)) {
+      const iri = match[1];
+      if (!iri.startsWith(`https://${domain}/`)) {
+        errors.push(`${filename}: off-domain IRI ${iri}`);
+      }
+    }
+  }
+
+  return {
+    name: "enriched_iri_namespace",
+    passed: errors.length === 0,
+    message:
+      errors.length === 0
+        ? "All HTML itemid values use domain namespace"
+        : `${errors.length} off-domain IRIs: ${errors[0]}`,
+  };
+}
+
+/**
+ * Check that link href targets appear as itemid values somewhere in the corpus.
+ */
+function checkOrphanedLinks(htmlFiles) {
+  const allItemIds = new Set();
+  const allHrefs = [];
+  const ITEMID_RE = /itemid="([^"]*)"/g;
+  const LINK_HREF_RE = /<link[^>]+href="([^"]*)"/g;
+
+  for (const [, html] of htmlFiles) {
+    for (const m of html.matchAll(ITEMID_RE)) allItemIds.add(m[1]);
+  }
+  for (const [filename, html] of htmlFiles) {
+    for (const m of html.matchAll(LINK_HREF_RE)) {
+      const href = m[1];
+      // Skip relative URLs — only check IRI references against itemid corpus
+      if (!href.startsWith("https://")) continue;
+      if (!allItemIds.has(href)) {
+        allHrefs.push(`${filename}: link href ${href} not found as any itemid`);
+      }
+    }
+  }
+
+  return {
+    name: "orphaned_links",
+    passed: allHrefs.length === 0,
+    message:
+      allHrefs.length === 0
+        ? "All link hrefs match existing itemid values"
+        : `${allHrefs.length} orphaned link hrefs: ${allHrefs[0]}`,
+  };
+}

package/templates/article.html

@@ -0,0 +1,31 @@
+{{#articles}}
+<article
+  itemscope
+  itemtype="https://schema.org/ScholarlyArticle"
+  itemid="{{{iri}}}"
+>
+  <h2 itemprop="headline">{{title}}</h2>
+  <meta itemprop="identifier" content="{{identifier}}" />
+  <meta itemprop="keywords" content="{{keywords}}" />
+  <time itemprop="datePublished" datetime="{{date}}">{{date}}</time>
+
+  {{#author}}
+  <span
+    itemprop="author"
+    itemscope
+    itemtype="https://schema.org/Person"
+    itemid="{{{iri}}}"
+  >
+    <span itemprop="name">{{name}}</span>
+  </span>
+  {{/author}} {{#drugLinks}}
+  <link itemprop="about" href="{{{iri}}}" />
+  {{/drugLinks}} {{#platformLinks}}
+  <link itemprop="about" href="{{{iri}}}" />
+  {{/platformLinks}} {{#projectLinks}}
+  <link itemprop="about" href="{{{iri}}}" />
+  {{/projectLinks}}
+
+  <div itemprop="articleBody" data-enrich="article_{{topic}}">{{prose}}</div>
+</article>
+{{/articles}}

package/templates/blog-post.html

@@ -0,0 +1,34 @@
+<section itemscope itemtype="https://schema.org/Blog" itemid="{{{blogIri}}}">
+  <span itemprop="name">Engineering Blog</span>
+  <article
+    itemprop="blogPost"
+    itemscope
+    itemtype="https://schema.org/BlogPosting"
+    itemid="{{{iri}}}"
+  >
+    <h2 itemprop="headline">{{headline}}</h2>
+    <meta itemprop="identifier" content="{{identifier}}" />
+    <meta itemprop="keywords" content="{{keywords}}" />
+    <time itemprop="datePublished" datetime="{{date}}">{{date}}</time>
+    <link itemprop="isPartOf" href="{{{blogIri}}}" />
+
+    {{#author}}
+    <span
+      itemprop="author"
+      itemscope
+      itemtype="https://schema.org/Person"
+      itemid="{{{iri}}}"
+    >
+      <span itemprop="name">{{name}}</span>
+    </span>
+    {{/author}} {{#aboutDrugs}}
+    <link itemprop="about" href="{{{iri}}}" />
+    {{/aboutDrugs}} {{#aboutPlatforms}}
+    <link itemprop="about" href="{{{iri}}}" />
+    {{/aboutPlatforms}} {{#aboutProjects}}
+    <link itemprop="about" href="{{{iri}}}" />
+    {{/aboutProjects}}
+
+    <div itemprop="articleBody" data-enrich="blog_{{index}}">{{body}}</div>
+  </article>
+</section>

package/templates/blog.html

@@ -0,0 +1,27 @@
+<section itemscope itemtype="https://schema.org/Blog" itemid="{{{blogIri}}}">
+  <span itemprop="name">Engineering Blog</span>
+  {{#posts}}
+  <div
+    itemprop="blogPost"
+    itemscope
+    itemtype="https://schema.org/BlogPosting"
+    itemid="{{{iri}}}"
+  >
+    <h3 itemprop="headline">{{headline}}</h3>
+    <meta itemprop="identifier" content="{{identifier}}" />
+    <time itemprop="datePublished" datetime="{{date}}">{{date}}</time>
+    {{#author}}
+    <span
+      itemprop="author"
+      itemscope
+      itemtype="https://schema.org/Person"
+      itemid="{{{iri}}}"
+    >
+      <span itemprop="name">{{name}}</span>
+    </span>
+    {{/author}}
+    <link itemprop="isPartOf" href="{{{blogIri}}}" />
+    <link itemprop="url" href="blog-{{index}}.html" />
+  </div>
+  {{/posts}}
+</section>

package/templates/briefing.md

@@ -0,0 +1,20 @@
+---
+type: briefing
+person: {{personId}}
+date: {{date}}
+---
+
+# Daily Briefing — {{personName}}
+
+**Role:** {{discipline}} {{level}} **Team:** {{teamName}} ({{deptName}})
+**Email:** {{email}}
+
+## Today's Focus
+
+{{briefing}}
+
+## Quick Stats
+
+- Team size: {{teamSize}}
+- Level: {{level}}
+- Manager: {{isManager}}

package/templates/comments.html

@@ -0,0 +1,15 @@
+{{#comments}}
+<div itemscope itemtype="https://schema.org/Comment" itemid="{{{iri}}}">
+  <span
+    itemprop="author"
+    itemscope
+    itemtype="https://schema.org/Person"
+    itemid="{{{authorIri}}}"
+  >
+    <span itemprop="name">{{author}}</span>
+  </span>
+  <span itemprop="text">{{body}}</span>
+  <meta itemprop="dateCreated" content="{{date}}" />
+  <link itemprop="about" href="{{{aboutIri}}}" />
+</div>
+{{/comments}}

package/templates/courses.html

@@ -0,0 +1,37 @@
+{{#courses}}
+<div itemscope itemtype="https://schema.org/Course" itemid="{{{iri}}}">
+  <h2 itemprop="name">{{title}}</h2>
+  <meta itemprop="identifier" content="{{id}}" />
+  <time itemprop="startDate">{{date}}</time>
+
+  <div
+    itemprop="provider"
+    itemscope
+    itemtype="https://schema.org/Organization"
+    itemid="{{{orgIri}}}"
+  >
+    <span itemprop="name">{{orgName}}</span>
+  </div>
+
+  {{#prerequisiteIris}}
+  <link itemprop="coursePrerequisites" href="{{{.}}}" />
+  {{/prerequisiteIris}} {{#platformLink}}
+  <link itemprop="isRelatedTo" href="{{{iri}}}" />
+  {{/platformLink}} {{#drugLink}}
+  <link itemprop="isRelatedTo" href="{{{iri}}}" />
+  {{/drugLink}} {{#attendees}}
+  <div
+    itemprop="attendee"
+    itemscope
+    itemtype="https://schema.org/Person"
+    itemid="{{{iri}}}"
+  >
+    <span itemprop="name">{{name}}</span>
+  </div>
+  {{/attendees}}
+
+  <div itemprop="description" data-enrich="course_{{id}}">
+    A course covering {{title}} for pharmaceutical professionals.
+  </div>
+</div>
+{{/courses}}

package/templates/departments.html

@@ -0,0 +1,29 @@
+{{#departments}}
+<div itemscope itemtype="https://schema.org/Organization" itemid="{{{iri}}}">
+  <span itemprop="name">{{name}}</span>
+  <div itemprop="department">
+    {{#teams}}
+    <div
+      itemscope
+      itemtype="https://schema.org/Organization"
+      itemid="{{{iri}}}"
+    >
+      <span itemprop="name">{{name}}</span>
+      <meta itemprop="numberOfEmployees" content="{{size}}" />
+      {{#members}}
+      <div
+        itemprop="member"
+        itemscope
+        itemtype="https://schema.org/Person"
+        itemid="{{{iri}}}"
+      >
+        <span itemprop="name">{{name}}</span>
+        <span itemprop="jobTitle">{{jobTitle}}</span>
+        <link itemprop="worksFor" href="{{{teamIri}}}" />
+      </div>
+      {{/members}}
+    </div>
+    {{/teams}}
+  </div>
+</div>
+{{/departments}}

package/templates/drugs.html

@@ -0,0 +1,23 @@
+{{#drugs}}
+<div itemscope itemtype="https://schema.org/Drug" itemid="{{{iri}}}">
+  <h2 itemprop="name">{{name}}</h2>
+  <meta itemprop="identifier" content="{{id}}" />
+  <span itemprop="drugClass">{{drugClass}}</span>
+  <span itemprop="activeIngredient">{{activeIngredient}}</span>
+  <meta itemprop="legalStatus" content="{{legalStatus}}" />
+
+  {{#parentDrugIri}}
+  <link itemprop="isRelatedTo" href="{{{parentDrugIri}}}" />
+  {{/parentDrugIri}} {{#projectLinks}}
+  <link itemprop="isRelatedTo" href="{{{iri}}}" />
+  {{/projectLinks}} {{#platformLinks}}
+  <link itemprop="isRelatedTo" href="{{{iri}}}" />
+  {{/platformLinks}} {{#eventLinks}}
+  <link itemprop="isRelatedTo" href="{{{iri}}}" />
+  {{/eventLinks}}
+
+  <div itemprop="clinicalPharmacology" data-enrich="drug_{{id}}">
+    {{clinicalPharmacology}}
+  </div>
+</div>
+{{/drugs}}

package/templates/events.html

@@ -0,0 +1,38 @@
+{{#events}}
+<div itemscope itemtype="https://schema.org/Event" itemid="{{{iri}}}">
+  <h2 itemprop="name">{{title}}</h2>
+  <time itemprop="startDate">{{date}}</time>
+  <span itemprop="location">{{location}}</span>
+  <meta itemprop="eventStatus" content="https://schema.org/{{eventStatus}}" />
+
+  {{#organizer}}
+  <div
+    itemprop="organizer"
+    itemscope
+    itemtype="https://schema.org/Person"
+    itemid="{{{iri}}}"
+  >
+    <span itemprop="name">{{name}}</span>
+  </div>
+  {{/organizer}} {{#attendees}}
+  <div
+    itemprop="attendee"
+    itemscope
+    itemtype="https://schema.org/Person"
+    itemid="{{{iri}}}"
+  >
+    <span itemprop="name">{{name}}</span>
+  </div>
+  {{/attendees}} {{#aboutProjects}}
+  <link itemprop="about" href="{{{iri}}}" />
+  {{/aboutProjects}} {{#aboutDrugs}}
+  <link itemprop="about" href="{{{iri}}}" />
+  {{/aboutDrugs}} {{#aboutPlatforms}}
+  <link itemprop="about" href="{{{iri}}}" />
+  {{/aboutPlatforms}}
+
+  <div itemprop="description" data-enrich="event_{{index}}">
+    {{title}} event at {{location}}.
+  </div>
+</div>
+{{/events}}

package/templates/faq.html

@@ -0,0 +1,22 @@
+<section itemscope itemtype="https://schema.org/FAQPage">
+  {{#faqs}}
+  <div
+    itemscope
+    itemtype="https://schema.org/Question"
+    itemid="{{{iri}}}"
+    itemprop="mainEntity"
+  >
+    <span itemprop="name">{{question}}</span>
+    <div
+      itemscope
+      itemtype="https://schema.org/Answer"
+      itemprop="acceptedAnswer"
+    >
+      <span itemprop="text">{{answer}}</span>
+    </div>
+    {{#aboutLinks}}
+    <link itemprop="about" href="{{{iri}}}" />
+    {{/aboutLinks}}
+  </div>
+  {{/faqs}}
+</section>

package/templates/howto.html

@@ -0,0 +1,8 @@
+<div
+  itemscope
+  itemtype="https://schema.org/HowTo"
+  itemid="{{{domain}}}/howto/{{topic}}"
+>
+  <h2 itemprop="name">{{title}}</h2>
+  <div itemprop="text"><p>{{prose}}</p></div>
+</div>

package/templates/leadership.html

@@ -0,0 +1,8 @@
+{{#managers}}
+<div itemscope itemtype="https://schema.org/Person" itemid="{{{iri}}}">
+  <span itemprop="name">{{name}}</span>
+  <span itemprop="jobTitle">Manager, {{teamName}}</span>
+  <span itemprop="email">{{email}}</span>
+  <link itemprop="worksFor" href="{{{departmentIri}}}" />
+</div>
+{{/managers}}

package/templates/ontology.md

@@ -0,0 +1,34 @@
+# Entity Ontology
+
+Domain: `https://{{domain}}`
+
+## Organizations
+
+{{#orgs}}
+
+- [{{{name}}}]({{{iri}}}) {{/orgs}}
+
+## Departments
+
+{{#departments}}
+
+- [{{{name}}}]({{{iri}}}) {{/departments}}
+
+## Teams
+
+{{#teams}}
+
+- [{{{name}}}]({{{iri}}}) {{/teams}}
+
+## People
+
+{{#people}}
+
+- [{{{name}}}]({{{iri}}}) — {{discipline}} {{level}} {{/people}} {{#hasMore}}
+- ... and {{moreCount}} more {{/hasMore}}
+
+## Projects
+
+{{#projects}}
+
+- [{{{name}}}]({{{iri}}}) {{/projects}}

package/templates/page.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <title>{{title}}</title>
+    <base href="{{{domain}}}/" />
+  </head>
+  <body>
+    <h1>{{title}}</h1>
+    {{{body}}}
+  </body>
+</html>