spec-up-t 1.2.6 → 1.2.8

package/src/health-check.js

@@ -1,20 +1,64 @@
 #!/usr/bin/env node
 
+/**
+ * @fileoverview Spec-Up-T Health Check Tool
+ * 
+ * This script performs comprehensive health checks on Spec-Up-T projects,
+ * validating configuration, external references, term definitions, and more.
+ * Generates an HTML report with detailed results and actionable feedback.
+ * 
+ * @author Spec-Up-T Team
+ * @version 1.0.0
+ * @since 2025-06-06
+ */
+
+/**
+ * @typedef {Object} HealthCheckResult
+ * @property {string} name - Name of the specific check
+ * @property {boolean|string} success - Success status (true, false, or 'partial')
+ * @property {string} [status] - Status override ('warning', 'pass', 'fail')
+ * @property {string} [details] - Additional details about the check result
+ */
+
+/**
+ * @typedef {Object} HealthCheckSection
+ * @property {string} title - Title of the check section
+ * @property {HealthCheckResult[]} results - Array of individual check results
+ */
+
+/**
+ * @typedef {Object} RepositoryInfo
+ * @property {string} host - Git hosting service (e.g., 'github')
+ * @property {string} account - Account/organization name
+ * @property {string} repo - Repository name
+ * @property {string} [branch] - Branch name
+ * @property {boolean} [verified] - Whether repository existence was verified
+ */
+
+/**
+ * @typedef {Object} StatusDisplay
+ * @property {string} statusClass - CSS class for styling
+ * @property {string} statusIcon - HTML icon element
+ * @property {string} statusText - Display text for status
+ */
+
 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
+/**
+ * Directory where health check reports are generated
+ * @constant {string}
+ */
 const OUTPUT_DIR = path.join(process.cwd(), '.cache');
 
 // Create output directory if it doesn't exist
@@ -22,8 +66,22 @@ if (!fs.existsSync(OUTPUT_DIR)) {
     fs.mkdirSync(OUTPUT_DIR, { recursive: true });
 }
 
-// Helper function to read specs.json file
-function getRepoInfo() {
+/**
+ * Retrieves repository information from specs.json file
+ * 
+ * Reads the specs.json file to extract repository configuration including
+ * host, account, repo name, and branch. Falls back to default values if
+ * the file doesn't exist or is missing required fields.
+ * 
+ * @async
+ * @function getRepoInfo
+ * @returns {Promise<RepositoryInfo>} Repository information object
+ * 
+ * @example
+ * const repoInfo = await getRepoInfo();
+ * console.log(repoInfo.account); // 'blockchain-bird'
+ */
+async function getRepoInfo() {
     try {
         // Path to the default boilerplate specs.json
         const defaultSpecsPath = path.join(
@@ -90,7 +148,7 @@ function getRepoInfo() {
                 }
                 
                 // If values have changed, verify the repository exists
-                const repoExists = checkRepositoryExists(
+                const repoExists = await checkRepositoryExists(
                     sourceInfo.host,
                     sourceInfo.account,
                     sourceInfo.repo
@@ -133,39 +191,67 @@ function getRepoInfo() {
     };
 }
 
-// Helper function to check if a repository exists
+/**
+ * Checks if a Git repository exists and is accessible
+ * 
+ * Makes an HTTP HEAD request to verify repository existence without
+ * downloading the full repository content. Handles timeouts and errors gracefully.
+ * 
+ * @function checkRepositoryExists
+ * @param {string} host - Git hosting service (e.g., 'github')
+ * @param {string} account - Account or organization name
+ * @param {string} repo - Repository name
+ * @returns {Promise<boolean>} True if repository exists and is accessible
+ * 
+ * @example
+ * const exists = await checkRepositoryExists('github', 'blockchain-bird', 'spec-up-t');
+ * if (exists) {
+ *   console.log('Repository is accessible');
+ * }
+ */
 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
+/**
+ * Formats current timestamp for use in filenames
+ * 
+ * Generates a timestamp string that is safe to use in filenames by
+ * replacing special characters with hyphens. Format: YYYY-MM-DD-HH-mm-ssZ
+ * 
+ * @function getFormattedTimestamp
+ * @returns {string} Formatted timestamp string suitable for filenames
+ * 
+ * @example
+ * const timestamp = getFormattedTimestamp();
+ * console.log(timestamp); // "2025-06-06-14-30-25Z"
+ */
 function getFormattedTimestamp() {
     const now = new Date();
     return now.toISOString()
@@ -174,12 +260,37 @@ function getFormattedTimestamp() {
         .replace(/Z/g, 'Z');
 }
 
-// Helper function to generate a human-readable timestamp for display
+/**
+ * Generates a human-readable timestamp for display in reports
+ * 
+ * Creates a localized timestamp string for display purposes,
+ * using the system's default locale and timezone.
+ * 
+ * @function getHumanReadableTimestamp
+ * @returns {string} Human-readable timestamp string
+ * 
+ * @example
+ * const readable = getHumanReadableTimestamp();
+ * console.log(readable); // "6/6/2025, 2:30:25 PM"
+ */
 function getHumanReadableTimestamp() {
     return new Date().toLocaleString();
 }
 
-// Helper function to determine status display parameters based on result
+/**
+ * Determines status display parameters based on check result
+ * 
+ * Analyzes check results to determine appropriate CSS classes,
+ * icons, and text for visual status representation in the HTML report.
+ * 
+ * @function getStatusDisplay
+ * @param {HealthCheckResult} result - Check result object
+ * @returns {StatusDisplay} Status display configuration
+ * 
+ * @example
+ * const display = getStatusDisplay({ success: true });
+ * console.log(display.statusText); // "Pass"
+ */
 function getStatusDisplay(result) {
     if (result.status === 'warning' || result.success === 'partial') {
         // Warning status
@@ -205,7 +316,34 @@ function getStatusDisplay(result) {
     }
 }
 
-// Main function to run all checks and generate the report
+/**
+ * Main function to run all health checks and generate the report
+ * 
+ * Orchestrates the execution of all available health check modules,
+ * collects results, and generates a comprehensive HTML report.
+ * Handles errors gracefully and ensures proper cleanup.
+ * 
+ * @async
+ * @function runHealthCheck
+ * @throws {Error} When health check execution fails
+ * 
+ * @description
+ * The function performs the following checks:
+ * - Term reference checks in external specs
+ * - External specs URL validation
+ * - Term references validation
+ * - specs.json configuration validation
+ * - Terms introduction file validation
+ * - .gitignore destination directory check
+ * 
+ * @example
+ * try {
+ *   await runHealthCheck();
+ *   console.log('Health check completed successfully');
+ * } catch (error) {
+ *   console.error('Health check failed:', error);
+ * }
+ */
 async function runHealthCheck() {
     console.log('Running health checks...');
 
@@ -249,28 +387,48 @@ 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);
     }
 }
 
-// Generate HTML report
-function generateReport(checkResults) {
+/**
+ * Generates and opens an HTML health check report
+ * 
+ * Creates a comprehensive HTML report with all health check results,
+ * saves it to the cache directory, and opens it in the default browser.
+ * The report includes interactive features like filtering and status indicators.
+ * 
+ * @async
+ * @function generateReport
+ * @param {HealthCheckSection[]} checkResults - Array of health check result objects
+ * @throws {Error} When report generation or file operations fail
+ * 
+ * @example
+ * const results = [
+ *   {
+ *     title: 'Configuration Check',
+ *     results: [{ name: 'specs.json', success: true, details: 'Valid' }]
+ *   }
+ * ];
+ * await generateReport(results);
+ */
+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,14 +440,35 @@ 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);
     }
 }
 
-// Generate HTML content
+/**
+ * Generates HTML content for the health check report
+ * 
+ * Creates a complete HTML document with Bootstrap styling, interactive features,
+ * and comprehensive health check results. Includes repository verification,
+ * status filtering, and detailed result tables.
+ * 
+ * @function generateHtmlReport
+ * @param {HealthCheckSection[]} checkResults - Array of health check result sections
+ * @param {string} timestamp - Human-readable timestamp for the report
+ * @param {RepositoryInfo} repoInfo - Repository information object
+ * @returns {string} Complete HTML document as string
+ * 
+ * @example
+ * const html = generateHtmlReport(results, '6/6/2025, 2:30:25 PM', {
+ *   host: 'github',
+ *   account: 'blockchain-bird',
+ *   repo: 'spec-up-t'
+ * });
+ */
 function generateHtmlReport(checkResults, timestamp, repoInfo) {
     let resultsHtml = '';
 
@@ -457,5 +636,15 @@ function generateHtmlReport(checkResults, timestamp, repoInfo) {
   `;
 }
 
-// Run the health check
+/**
+ * Script execution entry point
+ * 
+ * Immediately executes the health check when this script is run directly.
+ * This allows the script to be used as a standalone command-line tool.
+ * 
+ * @example
+ * // Run from command line:
+ * // node src/health-check.js
+ * // npm run healthCheck
+ */
 runHealthCheck();

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/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>