spec-up-t 1.4.1 → 1.5.0

package/assets/compiled/head.css

@@ -1,5 +1,5 @@
 :root{--card-bg:#fff;--card-bg-dt:#fcfcfc;--toc-bg:#fff;--toc-text:#212529;--header-navbar-bg:#f8f9fa;--header-navbar-text:#212529;--card-text:#212529;--card-border:rgba(0, 0, 0, 0.125);--card-shadow:rgba(0, 0, 0, 0.075);--card-hover-bg:#f8f9fa}[data-bs-theme=dark]{--card-bg:#212529;--card-bg-dt:#24282d;--toc-bg:#212529;--toc-text:#f8f9fa;--header-navbar-bg:#343a40;--header-navbar-text:#f8f9fa;--card-text:#f8f9fa;--card-border:rgba(255, 255, 255, 0.125);--card-shadow:rgba(0, 0, 0, 0.2);--card-hover-bg:#343a40}
-@charset "UTF-8";/*!
+/*!
  * Bootstrap  v5.3.3 (https://getbootstrap.com/)
  * Copyright 2011-2024 The Bootstrap Authors
  * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)
@@ -7,7 +7,7 @@
 slide-panels{position:fixed;top:0;left:0;height:100%;width:100%;pointer-events:none;z-index:100;contain:paint}slide-panels:before{content:" ";display:block;position:fixed;top:0;left:0;width:100%;height:100%;background:rgba(0,0,0,.3);transition:opacity .35s ease;opacity:0;cursor:pointer;pointer-events:none}slide-panels[open]:before{opacity:1;pointer-events:all}slide-panel{display:flex;flex-direction:column;box-sizing:border-box;position:absolute;top:0;left:0;bottom:0;background:#fff;box-shadow:0 0 5px 1px rgba(0,0,0,.15);transform:translate3d(-100%,0,0);transition:transform .35s ease;z-index:1;pointer-events:all}slide-panel[options~=right]{left:auto;right:0;transform:translate3d(100%,0,0)}slide-panel[open]{transform:translate3d(0,0,0)}detail-box{display:block}detail-box>header [detail-box-toggle]{width:2em;height:2em;text-align:center;cursor:pointer}detail-box>header [detail-box-toggle]:before{content:" ";display:inline-block;width:0;height:0;border-left:.55em solid transparent;border-right:.55em solid transparent;border-top:.8em solid;vertical-align:sub;cursor:pointer}detail-box[open] header [detail-box-toggle]:before{border-top:none;border-bottom:.8em solid}detail-box>section{height:0;opacity:0;min-width:100%;transition:height .3s ease,opacity .3s;overflow:hidden}detail-box[open]>section{opacity:1}tab-panels>nav{display:flex}tab-panels>nav>*{margin-left:-2px;padding:.5em 1em;background:#e0e0e0;border:1px solid #aaa;border-radius:0;cursor:pointer}tab-panels>nav>:focus{outline:0;background:#ccc}tab-panels>nav>:first-child{border-top-left-radius:5px;border-bottom-left-radius:5px}tab-panels>nav>:last-child{border-top-right-radius:5px;border-bottom-right-radius:5px}tab-panels>nav>[selected]{color:var(--themed-element-text);background:var(--themed-element-bk);border:var(--themed-element-border);opacity:.9999}tab-panels>section{display:none}tab-panels>section[selected]{display:block}
 code[class*=language-],pre[class*=language-]{color:#000;background:0 0;text-shadow:0 1px #fff;font-family:Consolas,Monaco,'Andale Mono','Ubuntu Mono',monospace;font-size:1em;text-align:left;white-space:pre;word-spacing:normal;word-break:normal;word-wrap:normal;line-height:1.5;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-hyphens:none;-moz-hyphens:none;-ms-hyphens:none;hyphens:none}code[class*=language-] ::-moz-selection,code[class*=language-]::-moz-selection,pre[class*=language-] ::-moz-selection,pre[class*=language-]::-moz-selection{text-shadow:none;background:#b3d4fc}code[class*=language-] ::selection,code[class*=language-]::selection,pre[class*=language-] ::selection,pre[class*=language-]::selection{text-shadow:none;background:#b3d4fc}@media print{code[class*=language-],pre[class*=language-]{text-shadow:none}}pre[class*=language-]{padding:1em;margin:.5em 0;overflow:auto}:not(pre)>code[class*=language-],pre[class*=language-]{background:#f5f2f0}:not(pre)>code[class*=language-]{padding:.1em;border-radius:.3em;white-space:normal}.token.cdata,.token.comment,.token.doctype,.token.prolog{color:#708090}.token.punctuation{color:#999}.token.namespace{opacity:.7}.token.boolean,.token.constant,.token.deleted,.token.number,.token.property,.token.symbol,.token.tag{color:#905}.token.attr-name,.token.builtin,.token.char,.token.inserted,.token.selector,.token.string{color:#690}.language-css .token.string,.style .token.string,.token.entity,.token.operator,.token.url{color:#9a6e3a;background:hsla(0,0%,100%,.5)}.token.atrule,.token.attr-value,.token.keyword{color:#07a}.token.class-name,.token.function{color:#dd4a68}.token.important,.token.regex,.token.variable{color:#e90}.token.bold,.token.important{font-weight:700}.token.italic{font-style:italic}.token.entity{cursor:help}pre[class*=language-].line-numbers{position:relative;padding-left:3.8em;counter-reset:linenumber}pre[class*=language-].line-numbers>code{position:relative;white-space:inherit}.line-numbers .line-numbers-rows{position:absolute;pointer-events:none;top:0;font-size:100%;left:-3.8em;width:3em;letter-spacing:-1px;border-right:1px solid #999;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none}.line-numbers-rows>span{display:block;counter-increment:linenumber}.line-numbers-rows>span:before{content:counter(linenumber);color:#999;display:block;padding-right:.8em;text-align:right}
 @keyframes chartjs-render-animation{from{opacity:.99}to{opacity:1}}.chartjs-render-monitor{animation:chartjs-render-animation 1ms}.chartjs-size-monitor,.chartjs-size-monitor-expand,.chartjs-size-monitor-shrink{position:absolute;direction:ltr;left:0;top:0;right:0;bottom:0;overflow:hidden;pointer-events:none;visibility:hidden;z-index:-1}.chartjs-size-monitor-expand>div{position:absolute;width:1000000px;height:1000000px;left:0;top:0}.chartjs-size-monitor-shrink>div{position:absolute;width:200%;height:200%;left:0;top:0}
-#logo img{width:100px}.bi{display:inline-block;width:1.2rem;height:1.2rem}#header,#header *{background-color:var(--header-navbar-bg);color:var(--header-navbar-text)}[issue-count]:after{content:"(" attr(issue-count) ")";margin:0 0 0 .3em;padding:.1em 0 0}[issue-count=""][animate]{display:none;opacity:0}[issue-count][animate]:not([issue-count=""]){animation:display-show 1s}#header a:not(#logo),#header a:not(#logo) *,#header button,#header button *{background:#a9dde0}
+#logo img{width:100px}.bi{display:inline-block;width:1.2rem;height:1.2rem}#header,#header *{background-color:var(--header-navbar-bg);color:var(--header-navbar-text)}[data-issue-count]:after{content:"(" attr(data-issue-count) ")";margin:0 0 0 .3em;padding:.1em 0 0}[data-issue-count=""][data-animate]{display:none;opacity:0}[data-issue-count][data-animate]:not([data-issue-count=""]){animation:display-show 1s}#header a:not(#logo),#header a:not(#logo) *,#header button,#header button *{background:#a9dde0}
 .container{min-height:100vh}@media (min-width:768px){.sidebar{position:sticky;top:0;height:100vh;overflow-y:auto;z-index:100}}ul.toc{padding:1em 0 1.75em;font-size:.85em}ul.toc,ul.toc ul{margin:0;padding:0;list-style:none}ul.toc li a{display:block;padding:.4em .8em;text-decoration:none;color:var(--toc-text);transition:background .2s ease,padding-left .2s ease,border-left .2s ease;padding-left:.8em;border-left:3px solid transparent;border-bottom:1px solid rgba(0,0,0,.03)}ul.toc ul{margin-left:1.2em!important;margin-top:.3em}ul.toc a:hover{background:#f9f9f9;padding-left:1em;border-left:3px solid #007bff}ul.toc>li>ul>li>a{padding-left:1.5em}ul.toc>li>ul>li>ul>li>a{padding-left:2em}ul.toc a:focus{outline:2px solid #007bff;outline-offset:-2px;box-shadow:0 0 0 3px rgba(0,123,255,.25);position:relative;z-index:1}.spec-footer{font-size:.7em;text-align:center}ul.toc li a.active,ul.toc li a[aria-current=page]{border-left:3px solid #007bff;font-weight:500;background:#f0f0f0}ul.toc li:last-child a{border-bottom:none}#toc ul li{position:relative}#toc ul li.has-children{position:relative}.collapse-toggle{position:absolute;top:.35em;right:0;width:28px;height:28px;background:0 0;border:1px solid transparent;border-radius:3px;padding:0;display:flex;align-items:center;justify-content:center;cursor:pointer;transition:background-color .2s,border-color .2s;z-index:2}.collapse-toggle:hover{background-color:rgba(0,0,0,.05)}.collapse-toggle:focus{outline:2px solid #007bff;outline-offset:1px;border-color:#007bff;box-shadow:0 0 0 3px rgba(0,123,255,.25)}.collapse-toggle::after{content:"";border-style:solid;border-width:.15em .15em 0 0;display:inline-block;height:.5em;width:.5em;position:relative;transform:rotate(135deg);transition:transform .2s ease}.collapse-toggle.collapsed::after{transform:rotate(45deg)}#toc ul li.has-children>ul{max-height:1000px;overflow:hidden;transition:max-height .3s ease-in-out,opacity .3s ease-in-out;opacity:1}#toc ul li.has-children.collapsed>ul{max-height:0;overflow:hidden;opacity:.6}.screen-reader-text{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0}.screen-reader-text:focus{width:auto;height:auto;clip:auto;display:block;padding:15px 23px 14px;background-color:#fff;color:#007bff;z-index:100000;font-size:1em;font-weight:700;text-decoration:none;line-height:normal;box-shadow:0 0 2px 2px rgba(0,0,0,.2)}
 h2,h3,h4,h5,h6{margin-top:1.5em!important}#terminology-section-utility-container{margin:1em auto;width:100%}@media (min-width:576px){#terminology-section-utility-container{position:sticky;top:3.5em;z-index:10}}.toc-anchor{font-size:.875em;color:#73c2df;text-decoration:none;transition:opacity .3s ease}.toc-anchor:hover{opacity:1}dl.terms-and-definitions-list{margin:0;padding:0;position:relative;z-index:1}dl.terms-and-definitions-list>dt{font-weight:700;margin:0;background-color:var(--card-bg-dt);border:1px solid var(--card-border);padding:.5rem 1.25rem;border-radius:.375rem .375rem 0 0;color:var(--card-text);position:relative;line-height:1.5;font-size:1.05em;display:flex;flex-wrap:wrap;align-items:center;gap:.5rem;min-height:2.5rem}dl.terms-and-definitions-list>dt>span{flex:1 1 auto;min-width:0;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;transition:all .2s ease-in-out}dl.terms-and-definitions-list>dt:focus>span,dl.terms-and-definitions-list>dt:hover>span,dl.terms-and-definitions-list>dt>span:focus,dl.terms-and-definitions-list>dt>span:hover{white-space:normal;overflow:visible;text-overflow:initial;word-wrap:break-word;line-height:1.4}dl.terms-and-definitions-list>dt:active>span,dl.terms-and-definitions-list>dt>span:active{white-space:normal;overflow:visible;text-overflow:initial;word-wrap:break-word;line-height:1.4}dl.terms-and-definitions-list>dt .btn{font-size:1.2em!important}dl.terms-and-definitions-list>dt:hover{background-color:var(--card-hover-bg);transition:background-color .2s ease-in-out}dl.terms-and-definitions-list>dd{margin:0;background-color:var(--card-bg);border:1px solid var(--card-border);border-top:none;padding:.5rem 2rem;color:var(--card-text);width:100%;position:relative}dl.terms-and-definitions-list dd p{margin:0;color:var(--card-text);padding-left:.5rem}dl.terms-and-definitions-list>dd::before{display:none}dl.terms-and-definitions-list dd table{margin:.5em 0;width:100%;border-collapse:collapse}dl.terms-and-definitions-list dd table td,dl.terms-and-definitions-list dd table th{padding:.5em;border:1px solid #ddd}dl.terms-and-definitions-list dd table th{background-color:#f5f5f5}dl>dd:has(table).meta-info-content-wrapper{display:block;font-size:.7em;position:relative;max-height:none;height:auto;overflow:visible;transition:all .3s ease-out}dl>dd:has(table).meta-info-content-wrapper td,dl>dd:has(table).meta-info-content-wrapper th{padding:.3em}dl>dd:has(table).collapsed.meta-info-content-wrapper{max-height:0;height:0;padding-top:0;padding-bottom:0;margin-top:0;margin-bottom:0;overflow:hidden;transition:all .3s ease-out;line-height:0}dl>dd:has(table).meta-info-content-wrapper>div{display:block;padding:inherit}.meta-info-toggle-button{position:relative;cursor:pointer}dl.terms-and-definitions-list dt+dd{border-bottom:none}dl.terms-and-definitions-list dd+dd{border-top:none;border-bottom:none}dl.terms-and-definitions-list dd+dt{margin-top:1rem}dl.terms-and-definitions-list dd.last-dd{border-radius:0 0 .375rem .375rem;border-bottom:1px solid var(--card-border)}html.dense-info dl.terms-and-definitions-list>dt{padding:.1rem 1.25rem;line-height:inherit;font-size:inherit;min-height:auto}html.dense-info dl.terms-and-definitions-list dd+dt{margin-top:.3rem}html.dense-info dl.terms-and-definitions-list>dt::before{display:none}html.dense-info dl.terms-and-definitions-list>dt>span{flex:1 1 auto;min-width:0}.term-external{position:relative}dl.terms-and-definitions-list>dd.term-external,dl.terms-and-definitions-list>dt.term-external{background:#a9dde03b}.term-local{position:relative}dl.terms-and-definitions-list>dd.term-local,dl.terms-and-definitions-list>dt.term-local{background:#f0f8ff}dl.terms-and-definitions-list .term-original-term{font-style:italic}dl.terms-and-definitions-list .term-external-parenthetical-terms{font-weight:400}dl.terms-and-definitions-list .term-local-original-term{font-style:italic}dl.terms-and-definitions-list .term-local-parenthetical-terms{font-weight:400}.btn{font-variant:small-caps;text-transform:uppercase;position:relative;z-index:5}.transclusion-heading{font-size:1.3em;font-weight:700;margin:.2em 0 .2em}dl.terms-and-definitions-list>dd.term-external-embedded{position:relative;padding-left:2.5rem;padding-top:.3rem;padding-bottom:.3rem}dl.terms-and-definitions-list span.term-external::after{content:"";position:absolute;top:50%;transform:translateY(-50%);background-image:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='16' height='16' class='bi bi-box-arrow-right' viewBox='0 0 16 16' fill='currentColor'%3E%3Cpath fill-rule='evenodd' d='M10 12.5a.5.5 0 0 1-.5.5h-8a.5.5 0 0 1-.5-.5v-9a.5.5 0 0 1 .5-.5h8a.5.5 0 0 1 .5.5v2a.5.5 0 0 0 1 0v-2A1.5 1.5 0 0 0 9.5 2h-8A1.5 1.5 0 0 0 0 3.5v9A1.5 1.5 0 0 0 1.5 14h8a1.5 1.5 0 0 0 1.5-1.5v-2a.5.5 0 0 0-1 0v2z'/%3E%3Cpath fill-rule='evenodd' d='M15.854 8.354a.5.5 0 0 0 0-.708l-3-3a.5.5 0 0 0-.708.708L14.293 7.5H5.5a.5.5 0 0 0 0 1h8.793l-2.147 2.146a.5.5 0 0 0 .708.708l3-3z'/%3E%3C/svg%3E");background-size:contain;background-repeat:no-repeat;background-position:center;width:.8rem;height:.8rem;left:.2rem}dl.terms-and-definitions-list span.term-external{padding-left:1.5rem;display:inline-block}.placeholder-tref{display:none}.no-xref-found-message{background:#f8c481;color:#03365f;margin:0 .5em;padding:0 .8em;border-radius:.25rem;font-size:.8rem;font-variant:small-caps;text-transform:uppercase}
 .btn{font-size:.7em!important;margin:0 0 0 .5em!important}

package/assets/css/embedded-libraries/bootstrap.min.css

@@ -1,4 +1,4 @@
-@charset "UTF-8";/*!
+/*!
  * Bootstrap  v5.3.3 (https://getbootstrap.com/)
  * Copyright 2011-2024 The Bootstrap Authors
  * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)

package/assets/css/header-navbar.css

@@ -13,18 +13,18 @@
     color: var(--header-navbar-text);
 }
 
-[issue-count]:after {
-    content: "(" attr(issue-count) ")";
+[data-issue-count]:after {
+    content: "(" attr(data-issue-count) ")";
     margin: 0 0 0 0.3em;
     padding: 0.1em 0 0;
 }
 
-[issue-count=""][animate] {
+[data-issue-count=""][data-animate] {
     display: none;
     opacity: 0;
 }
 
-[issue-count][animate]:not([issue-count=""]) {
+[data-issue-count][data-animate]:not([data-issue-count=""]) {
     animation: display-show 1s;
 }
 

package/assets/js/github-issues.js

@@ -10,13 +10,13 @@
         .then(response => response.json())
         .then(issues => {
           let count = issues.length;
-          document.querySelectorAll('[issue-count]').forEach(node => {
-            node.setAttribute('issue-count', count)
+          document.querySelectorAll('[data-issue-count]').forEach(node => {
+            node.setAttribute('data-issue-count', count)
           });
           repo_issue_list.innerHTML = issues.map(issue => {
             return `<li class="repo-issue">
               <detail-box>
-                <section>${md.render(issue.body || '')}</section>
+                <div>${md.render(issue.body || '')}</div>
                 <header class="repo-issue-title">
                   <span class="repo-issue-number">${issue.number}</span>
                   <span class="repo-issue-link">

package/examples/read-console-messages.js

@@ -0,0 +1,102 @@
+/**
+ * @file Example demonstrating message collector usage
+ * 
+ * This example shows how to read and analyze the console messages
+ * captured during menu operations [1] and [4].
+ * 
+ * Usage:
+ *   node examples/read-console-messages.js
+ */
+
+const fs = require('fs-extra');
+const path = require('path');
+
+async function analyzeConsoleMessages() {
+    const messagePath = path.join(process.cwd(), '.cache', 'console-messages.json');
+
+    // Check if the file exists
+    if (!await fs.pathExists(messagePath)) {
+        console.log('❌ No console messages found.');
+        console.log('   Run "npm run render" or "npm run collectExternalReferences" first.');
+        process.exit(1);
+    }
+
+    // Read the messages
+    const output = await fs.readJson(messagePath);
+
+    // Display metadata
+    console.log('\n📊 Console Message Analysis');
+    console.log('═'.repeat(60));
+    console.log(`Generated at: ${output.metadata.generatedAt}`);
+    console.log(`Total messages: ${output.metadata.totalMessages}`);
+    console.log(`Operations: ${output.metadata.operations.join(', ')}`);
+    console.log('\nMessages by type:');
+    Object.entries(output.metadata.messagesByType).forEach(([type, count]) => {
+        console.log(`  ${type}: ${count}`);
+    });
+
+    // Analyze errors
+    const errors = output.messages.filter(m => m.type === 'error');
+    if (errors.length > 0) {
+        console.log('\n❌ Errors detected:');
+        errors.forEach(error => {
+            console.log(`  [${error.timestamp}] ${error.message}`);
+            if (error.additionalData && error.additionalData.length > 0) {
+                console.log(`    Details: ${error.additionalData.join(', ')}`);
+            }
+        });
+    } else {
+        console.log('\n✅ No errors detected');
+    }
+
+    // Analyze warnings
+    const warnings = output.messages.filter(m => m.type === 'warn');
+    if (warnings.length > 0) {
+        console.log('\n🟡 Warnings detected:');
+        warnings.forEach(warning => {
+            console.log(`  [${warning.timestamp}] ${warning.message}`);
+        });
+    } else {
+        console.log('✅ No warnings detected');
+    }
+
+    // Show successful operations
+    const successes = output.messages.filter(m => m.type === 'success');
+    console.log(`\n✅ Successful operations: ${successes.length}`);
+    if (successes.length > 0 && successes.length <= 5) {
+        successes.forEach(success => {
+            console.log(`  - ${success.message}`);
+        });
+    }
+
+    // Operation breakdown
+    const messagesByOp = output.messages.reduce((acc, msg) => {
+        if (msg.operation) {
+            acc[msg.operation] = (acc[msg.operation] || 0) + 1;
+        }
+        return acc;
+    }, {});
+
+    console.log('\n📋 Messages by operation:');
+    Object.entries(messagesByOp).forEach(([op, count]) => {
+        console.log(`  ${op}: ${count} messages`);
+    });
+
+    // Health summary
+    console.log('\n🏥 Health Summary:');
+    if (errors.length > 0) {
+        console.log('  Status: ❌ ERROR - Issues detected during operation');
+    } else if (warnings.length > 0) {
+        console.log('  Status: 🟡 WARNING - Operation completed with warnings');
+    } else {
+        console.log('  Status: ✅ SUCCESS - Operation completed successfully');
+    }
+
+    console.log('═'.repeat(60) + '\n');
+}
+
+// Run the analysis
+analyzeConsoleMessages().catch(error => {
+    console.error('❌ Failed to analyze messages:', error.message);
+    process.exit(1);
+});

package/gulpfile.js

@@ -32,6 +32,40 @@ async function fetchSpecRefs() {
   }).catch(e => console.log(e));
 }
 
+/**
+ * Removes forbidden control characters from compiled JavaScript files
+ * to ensure W3C HTML validation compliance.
+ * 
+ * Specifically removes:
+ * - U+0001 (SOH - Start of Heading) 
+ * - U+001B (ESC - Escape, used in ANSI color codes)
+ * 
+ * These characters appear in third-party libraries (mermaid.js, dagre-d3)
+ * and cause W3C validation errors when embedded in HTML.
+ * 
+ * @param {string} filePath - Absolute path to the JavaScript file to clean
+ * @returns {Promise<void>}
+ */
+async function removeForbiddenControlCharacters(filePath) {
+  try {
+    let content = await fs.readFile(filePath, 'utf8');
+    
+    // Remove U+0001 (SOH - Start of Heading)
+    // This appears in dagre-d3 library as a null character separator
+    content = content.replace(/\x01/g, '');
+    
+    // Remove U+001B (ESC - Escape) 
+    // This appears in ANSI color codes like [35m, [31m, etc.
+    content = content.replace(/\x1b/g, '');
+    
+    await fs.writeFile(filePath, content, 'utf8');
+    console.log(`✓ Cleaned forbidden characters from ${filePath}`);
+  } catch (error) {
+    console.error(`✗ Error cleaning ${filePath}:`, error.message);
+    throw error;
+  }
+}
+
 async function compileAssets() {
   await fs.ensureDir(compileLocation);
   return new Promise(resolve => {
@@ -48,7 +82,14 @@ async function compileAssets() {
         .pipe(terser())
         .pipe(concat('body.js'))
         .pipe(gulp.dest(compileLocation))
-    ).on('finish', function () {
+    ).on('finish', async function () {
+      // Post-process compiled JavaScript files to remove forbidden control characters
+      try {
+        await removeForbiddenControlCharacters(`${compileLocation}/head.js`);
+        await removeForbiddenControlCharacters(`${compileLocation}/body.js`);
+      } catch (error) {
+        console.error('Failed to clean compiled files:', error);
+      }
       resolve();
     })
   });

package/index.js

@@ -1,7 +1,20 @@
 const { initialize } = require('./src/init');
 const Logger = require('./src/utils/logger');
+const messageCollector = require('./src/utils/message-collector');
 
 module.exports = async function (options = {}) {
+  // Start collecting messages if requested
+  const shouldCollectMessages = options.collectMessages !== false; // Collect by default
+  
+  if (shouldCollectMessages) {
+    // Only clear messages if not called from another operation (like collectExternalReferences)
+    // If skipClear is true, we're continuing from a previous operation
+    if (!options.skipClear) {
+      messageCollector.clearMessages();
+    }
+    messageCollector.startCollecting('render');
+  }
+
   try {
   const { initializeConfig } = require('./src/pipeline/configuration/prepare-spec-configuration.js');
     let toc = '';
@@ -137,8 +150,16 @@ module.exports = async function (options = {}) {
 
         // Run render and wait for it
         render(spec, assetTags, { externalReferences, references, definitions, specGroups, noticeTitles }, config, template, assets, Logger, md, externalSpecsList)
-          .then(() => {
+          .then(async () => {
             Logger.info('Render completed for:', spec.destination);
+            
+            // Save collected messages
+            if (shouldCollectMessages) {
+              messageCollector.stopCollecting();
+              const messagePath = await messageCollector.saveMessages();
+              Logger.success(`Console messages saved to: ${messagePath}`);
+            }
+            
             if (options.nowatch) {
               Logger.info('Exiting with nowatch');
               process.exit(0);
@@ -146,6 +167,15 @@ module.exports = async function (options = {}) {
           })
           .catch((e) => {
             Logger.error('Render failed:', e.message);
+            
+            // Save messages even on failure
+            if (shouldCollectMessages) {
+              messageCollector.stopCollecting();
+              messageCollector.saveMessages().catch(() => {
+                // Silent fail on save error
+              });
+            }
+            
             process.exit(1);
           });
 
@@ -159,10 +189,28 @@ module.exports = async function (options = {}) {
       });
     } catch (error) {
       Logger.error(`Error during initialization or module execution: ${error.message}`);
+      
+      // Save messages even on error
+      if (shouldCollectMessages) {
+        messageCollector.stopCollecting();
+        await messageCollector.saveMessages().catch(() => {
+          // Silent fail on save error
+        });
+      }
+      
       throw error; // Re-throw to let the caller handle the error
     }
   } catch (error) {
     Logger.error(`Error during initialization: ${error.message}`);
+    
+    // Save messages even on error
+    if (shouldCollectMessages) {
+      messageCollector.stopCollecting();
+      await messageCollector.saveMessages().catch(() => {
+        // Silent fail on save error
+      });
+    }
+    
     throw error; // Re-throw to let the caller handle the error
   }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-up-t",
-  "version": "1.4.1",
+  "version": "1.5.0",
   "description": "Technical specification drafting tool that generates rich specification documents from markdown. Forked from https://github.com/decentralized-identity/spec-up by Daniel Buchner (https://github.com/csuwildcat)",
   "main": "./index",
   "repository": {
@@ -64,6 +64,7 @@
     "prismjs": "^1.24.0",
     "puppeteer": "^23.2.1",
     "readline-sync": "^1.4.10",
+    "spec-up-t-healthcheck": "^1.0.0",
     "yargs": "^17.7.2"
   },
   "overrides": {