spec-up-t 1.2.5 → 1.2.7

package/src/health-check.js

@@ -2,16 +2,15 @@
 
 const fs = require('fs');
 const path = require('path');
-const http = require('http');
 const https = require('https');
-const { execSync } = require('child_process');
+const fileOpener = require('./utils/file-opener');
 
 // Import modules from the health-check directory
 const externalSpecsChecker = require('./health-check/external-specs-checker');
 const termReferencesChecker = require('./health-check/term-references-checker');
 const specsConfigurationChecker = require('./health-check/specs-configuration-checker');
 const termsIntroChecker = require('./health-check/terms-intro-checker');
-const outputGitignoreChecker = require('./health-check/output-gitignore-checker');
+const destinationGitignoreChecker = require('./health-check/destination-gitignore-checker');
 const trefTermChecker = require('./health-check/tref-term-checker');
 
 // Configuration
@@ -23,7 +22,7 @@ if (!fs.existsSync(OUTPUT_DIR)) {
 }
 
 // Helper function to read specs.json file
-function getRepoInfo() {
+async function getRepoInfo() {
     try {
         // Path to the default boilerplate specs.json
         const defaultSpecsPath = path.join(
@@ -90,7 +89,7 @@ function getRepoInfo() {
                 }
                 
                 // If values have changed, verify the repository exists
-                const repoExists = checkRepositoryExists(
+                const repoExists = await checkRepositoryExists(
                     sourceInfo.host,
                     sourceInfo.account,
                     sourceInfo.repo
@@ -135,34 +134,33 @@ function getRepoInfo() {
 
 // Helper function to check if a repository exists
 function checkRepositoryExists(host, account, repo) {
-    try {
-        // For synchronous checking, we'll use a simple HTTP HEAD request
+    return new Promise((resolve) => {
         const url = `https://${host}.com/${account}/${repo}`;
         
-        // Simple synchronous HTTP request using execSync
-        const cmd = process.platform === 'win32' 
-            ? `curl -s -o /nul -w "%{http_code}" -I ${url}`
-            : `curl -s -o /dev/null -w "%{http_code}" -I ${url}`;
+        try {
+            const request = https.request(url, { method: 'HEAD', timeout: 10000 }, (response) => {
+                // 200, 301, 302 status codes indicate the repo exists
+                const exists = [200, 301, 302].includes(response.statusCode);
+                resolve(exists);
+            });
             
-        const statusCode = execSync(cmd).toString().trim();
-        
-        // 200, 301, 302 status codes indicate the repo exists
-        return ['200', '301', '302'].includes(statusCode);
-    } catch (error) {
-        console.error('Error checking repository existence:', error);
-        return false;
-    }
-}
-
-// Helper function to get the appropriate file open command based on platform
-function getOpenCommand() {
-    if (process.platform === 'win32') {
-        return 'start';
-    } else if (process.platform === 'darwin') {
-        return 'open';
-    } else {
-        return 'xdg-open';
-    }
+            request.on('error', (error) => {
+                console.error('Error checking repository existence:', error.message);
+                resolve(false);
+            });
+            
+            request.on('timeout', () => {
+                console.error('Timeout checking repository existence');
+                request.destroy();
+                resolve(false);
+            });
+            
+            request.end();
+        } catch (error) {
+            console.error('Error checking repository existence:', error.message);
+            resolve(false);
+        }
+    });
 }
 
 // Helper function to format current time for the filename
@@ -249,17 +247,17 @@ async function runHealthCheck() {
             results: termsIntroResults
         });
 
-        // Run output directory gitignore check
-        const outputGitignoreResults = await outputGitignoreChecker.checkOutputDirGitIgnore(process.cwd());
+        // Run destination directory gitignore check
+        const destinationGitignoreResults = await destinationGitignoreChecker.checkDestinationGitIgnore(process.cwd());
         results.push({
             title: 'Check <code>.gitignore</code>',
-            results: outputGitignoreResults
+            results: destinationGitignoreResults
         });
 
         // Add more checks here in the future
 
         // Generate and open the report
-        generateReport(results);
+        await generateReport(results);
     } catch (error) {
         console.error('Error running health checks:', error);
         process.exit(1);
@@ -267,10 +265,10 @@ async function runHealthCheck() {
 }
 
 // Generate HTML report
-function generateReport(checkResults) {
+async function generateReport(checkResults) {
     const timestamp = getFormattedTimestamp();
     // Get repository information from specs.json
-    const repoInfo = getRepoInfo();
+    const repoInfo = await getRepoInfo();
     const reportFileName = `health-check-${timestamp}-${repoInfo.account}-${repoInfo.repo}.html`;
     const reportPath = path.join(OUTPUT_DIR, reportFileName);
 
@@ -282,8 +280,10 @@ function generateReport(checkResults) {
 
     // Open the report in the default browser
     try {
-        const openCommand = getOpenCommand();
-        execSync(`${openCommand} "${reportPath}"`);
+        const success = fileOpener.openHtmlFile(reportPath);
+        if (!success) {
+            console.error('Failed to open the report in browser');
+        }
     } catch (error) {
         console.error('Failed to open the report:', error);
     }

package/src/markdown-it-extensions.js

@@ -47,7 +47,7 @@ module.exports = function (md, templates = {}) {
     }
 
     // Add the responsive wrapper div before the table
-    return '<div class="table-responsive">' + originalTableRender(tokens, idx, options, env, self);
+    return '<div class="table-responsive-md">' + originalTableRender(tokens, idx, options, env, self);
   };
 
   // Override table_close to close the wrapper div
@@ -256,7 +256,7 @@ module.exports = function (md, templates = {}) {
    * @return {String} The rendered HTML output
    */
   md.renderer.rules.dl_open = function (tokens, idx, options, env, self) {
-    const targetHtml = 'terminology-section-start-h7vc6omi2hr2880';
+    const targetHtml = 'terminology-section-start';
     let targetIndex = findTargetIndex(tokens, targetHtml);
 
     // Add class to the first <dl> only if it comes after the target HTML

package/src/utils/README.md

@@ -0,0 +1,35 @@
+# Utils Module
+
+This directory contains utility modules that provide cross-platform functionality for the Spec-Up-T health check system.
+
+## file-opener.js
+
+Provides secure, cross-platform file opening functionality with proper command path resolution.
+
+### Features:
+- **Cross-platform support**: Handles Windows (`start`), macOS (`open`), and Linux (`xdg-open`) 
+- **Secure path resolution**: Uses absolute command paths instead of relying on PATH environment variable
+- **Error handling**: Graceful fallback when commands cannot be located
+
+### Functions:
+- `getCommandPath(command)` - Resolves absolute path for a given command
+- `getOpenCommand()` - Returns the platform-specific file opening command path
+- `openFile(filePath)` - Opens any file in its default application
+- `openHtmlFile(htmlFilePath)` - Specifically opens HTML files in the default browser
+
+### Security:
+This module was created to address SonarQube security issues by:
+1. Eliminating shell injection vulnerabilities through proper argument separation
+2. Avoiding PATH hijacking by using absolute command paths
+3. Providing controlled, sanitized command execution
+
+### Usage:
+```javascript
+const fileOpener = require('./utils/file-opener');
+
+// Open an HTML report
+const success = fileOpener.openHtmlFile('/path/to/report.html');
+
+// Get absolute path for a command
+const gitPath = fileOpener.getCommandPath('git');
+```

package/src/utils/file-opener.js

@@ -0,0 +1,89 @@
+const fs = require('fs');
+const { spawnSync } = require('child_process');
+
+/**
+ * Helper function to get the absolute path of a command
+ * @param {string} command - The command to find
+ * @returns {string} - The absolute path to the command or the command name as fallback
+ */
+function getCommandPath(command) {
+    // Define common system paths where commands are typically located
+    const commonPaths = [
+        `/usr/bin/${command}`,
+        `/bin/${command}`,
+        `/usr/local/bin/${command}`,
+        `/opt/homebrew/bin/${command}`, // For Homebrew on Apple Silicon Macs
+        `/opt/local/bin/${command}`,   // For MacPorts
+    ];
+    
+    // For Windows, add common Windows paths
+    if (process.platform === 'win32') {
+        commonPaths.unshift(
+            `C:\\Windows\\System32\\${command}.exe`,
+            `C:\\Windows\\${command}.exe`,
+            `C:\\Program Files\\Git\\bin\\${command}.exe`, // Git for Windows
+            `C:\\Program Files (x86)\\Git\\bin\\${command}.exe`
+        );
+    }
+    
+    // Check each path to see if the command exists
+    for (const cmdPath of commonPaths) {
+        if (fs.existsSync(cmdPath)) {
+            return cmdPath;
+        }
+    }
+    
+    // If we can't find the absolute path, return the command name as fallback
+    // This maintains functionality while logging the issue
+    console.warn(`Warning: Could not find absolute path for command '${command}', using relative path as fallback`);
+    return command;
+}
+
+/**
+ * Get the appropriate file open command based on platform
+ * @returns {string} - The absolute path to the platform-specific open command
+ */
+function getOpenCommand() {
+    let command;
+    if (process.platform === 'win32') {
+        command = 'start';
+    } else if (process.platform === 'darwin') {
+        command = 'open';
+    } else {
+        command = 'xdg-open';
+    }
+    
+    return getCommandPath(command);
+}
+
+/**
+ * Open a file in the default application for the current platform
+ * @param {string} filePath - The path to the file to open
+ * @returns {boolean} - True if the file was opened successfully, false otherwise
+ */
+function openFile(filePath) {
+    try {
+        const openCommand = getOpenCommand();
+        const result = spawnSync(openCommand, [filePath], { stdio: 'ignore' });
+        return result.status === 0;
+    } catch (error) {
+        console.error('Failed to open file:', error);
+        return false;
+    }
+}
+
+/**
+ * Open an HTML file in the default web browser
+ * @param {string} htmlFilePath - The path to the HTML file to open
+ * @returns {boolean} - True if the file was opened successfully, false otherwise
+ */
+function openHtmlFile(htmlFilePath) {
+    return openFile(htmlFilePath);
+}
+
+module.exports = {
+    getCommandPath,
+    getOpenCommand,
+    openFile,
+    openHtmlFile
+};

package/assets/css/pdf-styles.css

@@ -1,170 +0,0 @@
-/* PDF Styling for optimized print layout */
-
-/* Target the pdf-document class that's added during PDF generation */
-
-/* Reset all margins and paddings */
-.pdf-document * {
-  box-sizing: border-box !important;
-}
-
-/* Body and main container styling */
-body.pdf-document {
-  max-width: 100% !important;
-  width: 100% !important;
-  margin: 0 !important;
-  padding: 0 !important;
-  overflow-x: hidden !important;
-}
-
-/* Extremely aggressive content width adjustment */
-.pdf-document .container,
-.pdf-document main,
-.pdf-document section,
-.pdf-document article,
-.pdf-document .content,
-.pdf-document div[class*="container"],
-.pdf-document div[class*="col-"],
-.pdf-document .row {
-  max-width: 95% !important;
-  width: 95% !important;
-  margin-left: auto !important;
-  margin-right: auto !important;
-  padding-left: 0 !important;
-  padding-right: 0 !important;
-}
-
-/* Override any Bootstrap container constraints */
-.pdf-document .container,
-.pdf-document .container-sm,
-.pdf-document .container-md,
-.pdf-document .container-lg,
-.pdf-document .container-xl {
-  max-width: 95% !important;
-}
-
-/* Table adjustments */
-.pdf-document table {
-  width: 100% !important;
-  max-width: 100% !important;
-  margin-bottom: 1rem;
-  table-layout: fixed !important;
-}
-
-/* Header styling */
-.pdf-document .pdf-title {
-  font-size: 24pt !important;
-  margin-bottom: 0.5rem !important;
-}
-
-/* Images in PDF */
-.pdf-document img {
-  max-width: 100% !important;
-  height: auto !important;
-}
-
-/* Code blocks */
-.pdf-document pre,
-.pdf-document code {
-  white-space: pre-wrap !important;
-  word-break: break-word !important;
-  max-width: 100% !important;
-  overflow: visible !important;
-}
-
-/* Ensure proper page breaks */
-.pdf-document h1,
-.pdf-document h2,
-.pdf-document h3,
-.pdf-document h4 {
-  page-break-after: avoid;
-  page-break-inside: avoid;
-}
-
-.pdf-document table,
-.pdf-document figure {
-  page-break-inside: avoid;
-}
-
-/* Force any fixed-position elements to static */
-.pdf-document .fixed-top,
-.pdf-document .fixed-bottom,
-.pdf-document .sticky-top,
-.pdf-document .position-fixed,
-.pdf-document .position-sticky {
-  position: static !important;
-}
-
-/* Aggressively set all columns to take up more space */
-.pdf-document .col,
-.pdf-document [class*="col-"] {
-  flex: 0 0 100% !important;
-  max-width: 100% !important;
-  padding-left: 0 !important;
-  padding-right: 0 !important;
-}
-
-/* ====== DEFINITION LIST STYLING FOR PDF ====== */
-/* Remove background and borders from terms and definitions in PDF */
-.pdf-document dl.terms-and-definitions-list>dt,
-.pdf-document dl.terms-and-definitions-list>dd {
-  background-color: transparent !important;
-  border: none !important;
-  border-radius: 0 !important;
-  padding: 0.5rem 0 !important;
-  color: #000 !important;
-  /* Ensure good page breaks in definition lists */
-  page-break-inside: avoid !important;
-}
-
-/* Fix spacing between terms */
-.pdf-document dl.terms-and-definitions-list>dt {
-  margin-top: 1em !important;
-  font-weight: bold !important;
-  page-break-after: avoid !important;
-}
-
-/* Hide toggle buttons in PDF output */
-.pdf-document .meta-info-toggle-button {
-  display: none !important;
-}
-
-/* Always show meta-info content in PDF */
-.pdf-document dl>dd.meta-info-content-wrapper,
-.pdf-document dl>dd.collapsed.meta-info-content-wrapper {
-  display: block !important;
-  max-height: none !important;
-  height: auto !important;
-  overflow: visible !important;
-  padding: 0.5rem 0 !important;
-  margin: 0 !important;
-  line-height: normal !important;
-}
-
-/* Transclusion styling for PDF */
-.pdf-document dt.transcluded-xref-term,
-.pdf-document dd.transcluded-xref-term {
-  background: transparent !important;
-  background-color: transparent !important;
-}
-
-/* Remove any other visual indicators that aren't needed in PDF */
-.pdf-document dl.terms-and-definitions-list>dt::before,
-.pdf-document dl.terms-and-definitions-list>dd::before {
-  display: none !important;
-}
-
-/* Ensure all definition content is visible in PDF */
-.pdf-document dl.terms-and-definitions-list dd p {
-  padding-left: 0 !important;
-}
-
-/* Improve table display in definitions for PDF */
-.pdf-document dl.terms-and-definitions-list dd table {
-  margin: 0.5em 0 !important;
-  border-collapse: collapse !important;
-}
-
-.pdf-document dl.terms-and-definitions-list dd table th,
-.pdf-document dl.terms-and-definitions-list dd table td {
-  border: 0.5pt solid #888 !important;
-}

package/branches.md

@@ -1,17 +0,0 @@
-# Beschrijving van de branches
-
-## improve/compact-terms
-
-Maak de termen weergave meer compact
-Filters
-
-
-## various
-
-
-## test/xtrefnew
-
-Lokaal Bewaren
-Lijkt goed te werken.
-Met AI gebouwde oplossing waarbij ik probeer iets aan de API limieten te doen. Ik heb twee belangrijke bestanden weggedaan en AI ze opnieuw laten bouwen op basis van een prompt en de bestanden die ik had. Het lijkt te werken, maar ik heb geen idee of het goed is. Het is een beetje een experiment.
-

package/src/README.md

@@ -1,98 +0,0 @@
-<h1>Spec-Up-T External References Collection Workflow</h1>
-<p>This codebase implements a system for collecting and processing cross-specification references from markdown files. Here's a workflow diagram of what happens when <a class="chat-inline-anchor-widget show-file-icons" title="" draggable="true" href="vscode-file://vscode-app/Applications/Visual%20Studio%20Code.app/Contents/Resources/app/out/vs/code/electron-sandbox/workbench/workbench.html" data-href="file:///Users/kor/webdev/Blockchain-Bird/KERI/Spec-Up/active-bcb/spec-up-t/spec-up-t/src/collect-external-references.js#37%2C10" data-keybinding-context="1187"><span class="icon-label">collectExternalReferences()</span></a> is called:</p>
-<h2>Workflow Overview</h2>
-<ol>
-<li>
-<p><strong>Initialization &amp; Configuration</strong></p>
-<ul>
-<li>Loads environment variables using dotenv</li>
-<li>Reads <a class="chat-inline-anchor-widget show-file-icons" title="" draggable="true" href="vscode-file://vscode-app/Applications/Visual%20Studio%20Code.app/Contents/Resources/app/out/vs/code/electron-sandbox/workbench/workbench.html" data-href="file:///Users/kor/webdev/Blockchain-Bird/KERI/Spec-Up/active-bcb/spec-up-t/spec-up-t/src/collect-external-references.js#42%2C39" data-keybinding-context="1188"><span class="icon-label">specs.json</span></a> configuration file</li>
-<li>Obtains GitHub Personal Access Token (PAT) from options or environment variables</li>
-</ul>
-</li>
-<li>
-<p><strong>Validation Checks</strong></p>
-<ul>
-<li>Verifies GitHub PAT is available, stops with instructions if missing</li>
-<li>Confirms external repositories are configured in specs.json</li>
-<li>Validates repository URLs using <a class="chat-inline-anchor-widget show-file-icons" title="" draggable="true" href="vscode-file://vscode-app/Applications/Visual%20Studio%20Code.app/Contents/Resources/app/out/vs/code/electron-sandbox/workbench/workbench.html" data-href="file:///Users/kor/webdev/Blockchain-Bird/KERI/Spec-Up/active-bcb/spec-up-t/spec-up-t/src/utils/doesUrlExist.js#8%2C16" data-keybinding-context="1189"><span class="icon-label">doesUrlExist.js</span></a></li>
-</ul>
-</li>
-<li>
-<p><strong>Content Collection</strong></p>
-<ul>
-<li>Creates necessary output directories</li>
-<li>Reads all markdown files from specified term directories</li>
-<li>Concatenates content into a single string for processing</li>
-</ul>
-</li>
-<li>
-<p><strong>Cross-Reference Extraction</strong></p>
-<ul>
-<li>Uses regex to find <code>[[xref:...]]</code> and <code>[[tref:...]]</code> patterns in markdown</li>
-<li>Processes these patterns into structured objects with <a class="chat-inline-anchor-widget show-file-icons" title="" draggable="true" href="vscode-file://vscode-app/Applications/Visual%20Studio%20Code.app/Contents/Resources/app/out/vs/code/electron-sandbox/workbench/workbench.html" data-href="file:///Users/kor/webdev/Blockchain-Bird/KERI/Spec-Up/active-bcb/spec-up-t/spec-up-t/src/collect-external-references.js#158%2C58" data-keybinding-context="1190"><span class="icon-label">externalSpec</span></a> and <a class="chat-inline-anchor-widget show-file-icons" title="" draggable="true" href="vscode-file://vscode-app/Applications/Visual%20Studio%20Code.app/Contents/Resources/app/out/vs/code/electron-sandbox/workbench/workbench.html" data-href="file:///Users/kor/webdev/Blockchain-Bird/KERI/Spec-Up/active-bcb/spec-up-t/spec-up-t/src/collect-external-references.js#186%2C64" data-keybinding-context="1191"><span class="icon-label">term</span></a> properties</li>
-<li>Filters out duplicates and keeps only references found in current markdown content</li>
-</ul>
-</li>
-<li>
-<p><strong>Metadata Enhancement</strong></p>
-<ul>
-<li>Extends each reference with additional repository information:
-<ul>
-<li>Repository URL</li>
-<li>Owner/repo names</li>
-<li>Terms directory path</li>
-<li>Avatar URL</li>
-</ul>
-</li>
-</ul>
-</li>
-<li>
-<p><strong>GitHub API Interaction</strong></p>
-<ul>
-<li>For each reference, calls <a class="chat-inline-anchor-widget show-file-icons" title="" draggable="true" href="vscode-file://vscode-app/Applications/Visual%20Studio%20Code.app/Contents/Resources/app/out/vs/code/electron-sandbox/workbench/workbench.html" data-href="file:///Users/kor/webdev/Blockchain-Bird/KERI/Spec-Up/active-bcb/spec-up-t/spec-up-t/src/collectExternalReferences/fetchTermsFromGitHubRepository.js#16%2C16" data-keybinding-context="1192"><span class="icon-label">fetchTermsFromGitHubRepository</span></a> which:
-<ul>
-<li>Uses Octokit to interface with GitHub API</li>
-<li>Implements caching to minimize API requests</li>
-<li>Handles rate limiting with throttling and retries</li>
-<li>Searches for terms within specified repositories/directories</li>
-</ul>
-</li>
-</ul>
-</li>
-<li>
-<p><strong>Term Content Processing</strong></p>
-<ul>
-<li>When terms are found, retrieves:
-<ul>
-<li>File content</li>
-<li>Latest commit hash</li>
-<li>Repository metadata</li>
-</ul>
-</li>
-<li>Uses <a class="chat-inline-anchor-widget show-file-icons" title="" draggable="true" href="vscode-file://vscode-app/Applications/Visual%20Studio%20Code.app/Contents/Resources/app/out/vs/code/electron-sandbox/workbench/workbench.html" data-href="file:///Users/kor/webdev/Blockchain-Bird/KERI/Spec-Up/active-bcb/spec-up-t/spec-up-t/src/collectExternalReferences/matchTerm.js#3%2C10" data-keybinding-context="1193"><span class="icon-label">matchTerm.js</span></a> to validate the term within content</li>
-</ul>
-</li>
-<li>
-<p><strong>Output Generation</strong></p>
-<ul>
-<li>Creates three output files:
-<ul>
-<li><code>.cache/xtrefs-data.json</code> - JSON data file</li>
-<li><code>.cache/xtrefs-data.js</code> - JavaScript module file</li>
-<li><code>.cache/xtrefs-history/xtrefs-data-[timestamp].js</code> - Historical record</li>
-</ul>
-</li>
-</ul>
-</li>
-</ol>
-<h2>Key Functions</h2>
-<ul>
-<li><a class="chat-inline-anchor-widget show-file-icons" title="" draggable="true" href="vscode-file://vscode-app/Applications/Visual%20Studio%20Code.app/Contents/Resources/app/out/vs/code/electron-sandbox/workbench/workbench.html" data-href="file:///Users/kor/webdev/Blockchain-Bird/KERI/Spec-Up/active-bcb/spec-up-t/spec-up-t/src/collect-external-references.js#37%2C10" data-keybinding-context="1194"><span class="icon-label">collectExternalReferences()</span></a>: Main orchestration function</li>
-<li><a class="chat-inline-anchor-widget show-file-icons" title="" draggable="true" href="vscode-file://vscode-app/Applications/Visual%20Studio%20Code.app/Contents/Resources/app/out/vs/code/electron-sandbox/workbench/workbench.html" data-href="file:///Users/kor/webdev/Blockchain-Bird/KERI/Spec-Up/active-bcb/spec-up-t/spec-up-t/src/collect-external-references.js#143%2C18" data-keybinding-context="1195"><span class="icon-label">extendXTrefs()</span></a>: Adds repository metadata to references</li>
-<li><a class="chat-inline-anchor-widget show-file-icons" title="" draggable="true" href="vscode-file://vscode-app/Applications/Visual%20Studio%20Code.app/Contents/Resources/app/out/vs/code/electron-sandbox/workbench/workbench.html" data-href="file:///Users/kor/webdev/Blockchain-Bird/KERI/Spec-Up/active-bcb/spec-up-t/spec-up-t/src/collect-external-references.js#192%2C18" data-keybinding-context="1196"><span class="icon-label">processXTref()</span></a>: Parses reference syntax into structured objects</li>
-<li><a class="chat-inline-anchor-widget show-file-icons" title="" draggable="true" href="vscode-file://vscode-app/Applications/Visual%20Studio%20Code.app/Contents/Resources/app/out/vs/code/electron-sandbox/workbench/workbench.html" data-href="file:///Users/kor/webdev/Blockchain-Bird/KERI/Spec-Up/active-bcb/spec-up-t/spec-up-t/src/collect-external-references.js#184%2C18" data-keybinding-context="1197"><span class="icon-label">isXTrefInMarkdown()</span></a>: Validates references against current content</li>
-<li><a class="chat-inline-anchor-widget show-file-icons" title="" draggable="true" href="vscode-file://vscode-app/Applications/Visual%20Studio%20Code.app/Contents/Resources/app/out/vs/code/electron-sandbox/workbench/workbench.html" data-href="file:///Users/kor/webdev/Blockchain-Bird/KERI/Spec-Up/active-bcb/spec-up-t/spec-up-t/src/collectExternalReferences/fetchTermsFromGitHubRepository.js#16%2C16" data-keybinding-context="1198"><span class="icon-label">fetchTermsFromGitHubRepository()</span></a>: Interacts with GitHub API to find terms</li>
-<li><a class="chat-inline-anchor-widget show-file-icons" title="" draggable="true" href="vscode-file://vscode-app/Applications/Visual%20Studio%20Code.app/Contents/Resources/app/out/vs/code/electron-sandbox/workbench/workbench.html" data-href="file:///Users/kor/webdev/Blockchain-Bird/KERI/Spec-Up/active-bcb/spec-up-t/spec-up-t/src/collectExternalReferences/processXTrefsData.js#9%2C16" data-keybinding-context="1199"><span class="icon-label">processXTrefsData()</span></a>: Processes the data and generates output files</li>
-</ul>
-<p>This system enables cross-specification linking by fetching and maintaining references to terms defined in external GitHub repositories, ensuring that documentation can link to canonical definitions maintained elsewhere.</p>