Skip to content

Add Mermaid diagrams, telemetry, trace, and artifact registry refinements to enterprise showcase#70

Merged
ProfRandom92 merged 1 commit into
mainfrom
codex/refine-comptextv7-showcase-for-enterprise-credibility
May 13, 2026
Merged

Add Mermaid diagrams, telemetry, trace, and artifact registry refinements to enterprise showcase#70
ProfRandom92 merged 1 commit into
mainfrom
codex/refine-comptextv7-showcase-for-enterprise-credibility

Conversation

@ProfRandom92

Copy link
Copy Markdown
Owner

Motivation

  • Improve enterprise credibility of the Comptextv7 showcase by adding visible, reviewer-friendly architecture diagrams, denser artifact lineage, realistic telemetry, and an operational reviewer walkthrough while preserving the existing architecture and visual direction.
  • Surface deterministic replay traces and CI/registry evidence so reviewers can inspect provenance, determinism, and validation contracts without redesigning the UI.

Description

  • Added rendered in-page Mermaid diagrams for the Deterministic Replay Pipeline, CI Validation Flow, and Artifact Lineage and a lazy-loading MermaidDiagram renderer that keeps the source visible for reviewer inspection (showcase/app/src/main.tsx).
  • Introduced realistic telemetry KPIs (Input Tokens, Compressed Tokens, Reduction Ratio, Replay Drift Delta, Validation Pass Rate, Replay Determinism, Artifact Count, CI Validation Runs) and adjusted KPI/trace/span data to match an operational replay (showcase/app/src/main.tsx).
  • Converted the trace surface to an OpenTelemetry/Jaeger-style tree plus span tracks, renamed and reshaped spans for operational plausibility, and exposed a trace tree block for quick review (showcase/app/src/main.tsx).
  • Increased artifact registry density (compression, replay, validation, lineage, CI evidence, telemetry rows), updated the artifact table columns, and expanded enterprise use cases and the guided reviewer walkthrough to the ingest→compress→validate→replay→inspect→verify→approve flow (showcase/app/src/main.tsx).
  • Added mermaid runtime dependency and updated styles to include Mermaid panels, responsive grids, trace-tree styles, denser tables, and walkthrough index markers (showcase/app/package.json, showcase/app/package-lock.json, showcase/app/src/styles.css).

Testing

  • Ran npm run validate which passed the showcase copy/content validation.
  • Ran npm run build which completed successfully; Vite emitted a large-chunk advisory because Mermaid’s runtime bundle is sizable (informational only).
  • Attempted an automated headless screenshot of the running dev server but the environment lacked playwright, so browser capture did not run; the dev server itself started successfully during verification.

Codex Task

@vercel

vercel Bot commented May 13, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
comptextv7 Ready Ready Preview, Comment May 13, 2026 10:36am

@netlify

netlify Bot commented May 13, 2026

Copy link
Copy Markdown

Deploy Preview for comptext-v7 ready!

Name Link
🔨 Latest commit 1b32df0
🔍 Latest deploy log https://app.netlify.com/projects/comptext-v7/deploys/6a04540ff824300008fff0ba
😎 Deploy Preview https://deploy-preview-70--comptext-v7.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@ProfRandom92 ProfRandom92 merged commit 6c7bbf3 into main May 13, 2026
10 checks passed

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request integrates the mermaid library into the showcase application to render visual diagrams for the deterministic replay pipeline and CI validation flows. It also expands the dashboard with additional KPIs, detailed artifact registry metadata, and a guided reviewer walkthrough. Feedback was provided regarding the MermaidDiagram component, specifically suggesting that mermaid.initialize be moved outside the useEffect hook or guarded to prevent inefficient re-initialization on every render.

Comment thread showcase/app/src/main.tsx
Comment on lines +196 to +212
import('mermaid').then(({ default: mermaid }) => {
mermaid.initialize({
startOnLoad: false,
securityLevel: 'strict',
theme: 'dark',
themeVariables: {
background: '#080d14',
primaryColor: '#0f1724',
primaryTextColor: '#e5edf7',
primaryBorderColor: '#3b82f6',
lineColor: '#60a5fa',
secondaryColor: '#111827',
tertiaryColor: '#0b1220',
fontFamily: 'Inter, ui-sans-serif, system-ui, sans-serif'
}
});
return mermaid.render(`diagram-${id}`, chart);

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The mermaid.initialize function is called on every render of the MermaidDiagram component when the chart prop changes. This is inefficient and could lead to unexpected behavior if the configuration is reset. Consider moving the initialization outside the useEffect or ensuring it only runs once.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant