spec-up-t 1.2.6 → 1.2.7

package/assets/js/collapse-definitions.js

@@ -57,7 +57,8 @@ function collapseDefinitions() {
             "See more about",
             "See more on",
             "See more at",
-            "More:"
+            "More:",
+            "Supporting definitions:"
         ];
         return definitionHidePrefixes.some(prefix => content.startsWith(prefix));
     }

package/jest.config.js

@@ -0,0 +1,20 @@
+module.exports = {
+  collectCoverageFrom: [
+    'src/**/*.{js,jsx}',
+    '!src/**/*.test.{js,jsx}',
+    '!src/**/__tests__/**',
+    '!src/**/__mocks__/**',
+  ],
+  coverageDirectory: 'coverage',
+  coverageReporters: ['text', 'lcov', 'html'],
+  coverageThreshold: {
+    global: {
+      branches: 80,
+      functions: 80,
+      lines: 80,
+      statements: 80,
+    },
+  },
+  testEnvironment: 'node',
+  verbose: true,
+}; 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-up-t",
-  "version": "1.2.6",
+  "version": "1.2.7",
   "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": {
@@ -70,6 +70,7 @@
     "jest": "^29.7.0"
   },
   "scripts": {
-    "test": "NODE_OPTIONS=--experimental-vm-modules jest"
+    "test": "jest",
+    "test:coverage": "jest --coverage"
   }
 }

package/src/health-check/{output-gitignore-checker.js → destination-gitignore-checker.js}

@@ -1,6 +1,17 @@
+/**
+ * @file destination-gitignore-checker.js
+ * @description Checks if the final destination directory (from output_path in specs.json) 
+ * is being ignored by Git. This is the directory where index.html is generated, 
+ * NOT the temporary .cache directory (formerly called "output").
+ * 
+ * Important: This file deals with concept #1 (output_path from specs.json),
+ * not concept #2 (the temporary .cache directory for build artifacts).
+ */
+
 const fs = require('fs');
 const path = require('path');
-const { execSync } = require('child_process');
+const { spawnSync } = require('child_process');
+const fileOpener = require('../utils/file-opener');
 
 /**
  * Checks if a path is gitignored
@@ -13,8 +24,11 @@ function isPathGitIgnored(projectRoot, targetPath) {
     // Use git check-ignore to determine if the path is ignored
     // If command exits with status 0, path is ignored
     // If command exits with status 1, path is not ignored
-    execSync(`git -C "${projectRoot}" check-ignore -q "${targetPath}"`, { stdio: 'ignore' });
-    return true; // Path is ignored (command exited with status 0)
+    const gitPath = fileOpener.getCommandPath('git');
+    const result = spawnSync(gitPath, ['-C', projectRoot, 'check-ignore', '-q', targetPath], { 
+      stdio: 'ignore' 
+    });
+    return result.status === 0; // Path is ignored (command exited with status 0)
   } catch (error) {
     console.log(`Error checking if path is gitignored: ${error.message}`);
     return false; // Path is not ignored (command exited with non-zero status)
@@ -87,11 +101,11 @@ function extractOutputPath(specsPath) {
 }
 
 /**
- * Check if the output directory exists
+ * Check if the final destination directory (from output_path) exists
  * @param {string} projectRoot - Root directory of the project
  * @param {string} outputPath - Output path from specs.json
  * @param {string} normalizedPath - Normalized output path
- * @returns {Object} - Result with output directory check
+ * @returns {Object} - Result with final destination directory check
  */
 function checkOutputDirExists(projectRoot, outputPath, normalizedPath) {
   // Check if the path exists
@@ -100,17 +114,17 @@ function checkOutputDirExists(projectRoot, outputPath, normalizedPath) {
   
   if (!outputPathExists) {
     return {
-      name: 'Output directory existence',
+      name: 'Final destination directory existence',
       status: 'warning',
       success: true, // Still considered a "success" for backward compatibility
-      details: `Output directory "${outputPath}" does not exist yet. This is OK if you haven't rendered the specs yet.`
+      details: `Final destination directory "${outputPath}" does not exist yet. This is OK if you haven't rendered the specs yet.`
     };
   } 
   
   return {
-    name: 'Output directory existence',
+    name: 'Final destination directory existence',
     success: true,
-    details: `Output directory "${outputPath}" exists`
+    details: `Final destination directory "${outputPath}" exists`
   };
 }
 
@@ -245,7 +259,7 @@ function findComplexHtmlPatterns(lines) {
 }
 
 /**
- * Check if HTML files in the output directory are being ignored by Git
+ * Check if HTML files in the final destination directory are being ignored by Git
  * @param {string} projectRoot - Root directory of the project
  * @param {string} normalizedPath - Normalized output path
  * @param {string} outputPath - Original output path
@@ -273,8 +287,8 @@ function checkHtmlFilesGitignore(projectRoot, normalizedPath, outputPath, releva
     name: 'Check if index.html files are gitignored',
     success: !isIndexHtmlIgnored,
     details: isIndexHtmlIgnored 
-      ? `index.html files in the output directory would be ignored by Git. This is problematic as they're crucial output files.`
-      : `index.html files in the output directory are properly tracked by Git.`
+      ? `index.html files in the final destination directory would be ignored by Git. This is problematic as they're crucial output files.`
+      : `index.html files in the final destination directory are properly tracked by Git.`
   });
   
   // If index.html is ignored but we couldn't find an explicit pattern, look for more complex patterns
@@ -295,22 +309,22 @@ function checkHtmlFilesGitignore(projectRoot, normalizedPath, outputPath, releva
 }
 
 /**
- * Check if output directory is being ignored by Git
+ * Check if final destination directory (from output_path) is being ignored by Git
  * @param {string} projectRoot - Root directory of the project
  * @param {string} normalizedPath - Normalized output path
  * @param {string} outputPath - Original output path
  * @param {string} dirName - Directory name from path
  * @param {Array} relevantLines - Relevant lines from .gitignore
- * @returns {Array} - Results for output directory gitignore check
+ * @returns {Array} - Results for final destination directory gitignore check
  */
 function checkOutputDirIgnorePatterns(projectRoot, normalizedPath, outputPath, dirName, relevantLines) {
   const dirIgnorePatterns = findOutputDirIgnorePatterns(relevantLines, normalizedPath, dirName);
   
   if (dirIgnorePatterns.length > 0) {
     return [{
-      name: 'Check if output directory is gitignored',
+      name: 'Check if final destination directory is gitignored',
       success: false,
-      details: `Found patterns in .gitignore that would ignore the output directory: ${dirIgnorePatterns.join(', ')}. Remove these entries to ensure generated content is tracked.`
+      details: `Found patterns in .gitignore that would ignore the final destination directory: ${dirIgnorePatterns.join(', ')}. Remove these entries to ensure generated content is tracked.`
     }];
   }
   
@@ -318,20 +332,21 @@ function checkOutputDirIgnorePatterns(projectRoot, normalizedPath, outputPath, d
   const isIgnored = isPathGitIgnored(projectRoot, normalizedPath);
   
   return [{
-    name: 'Check if output directory is gitignored',
+    name: 'Check if final destination directory is gitignored',
     success: !isIgnored,
     details: isIgnored 
-      ? `Output directory "${outputPath}" is being ignored by Git. This could be due to a complex pattern in .gitignore. Remove any entries that might affect this directory.`
-      : `Output directory "${outputPath}" is not being ignored by Git, which is good.`
+      ? `Final destination directory "${outputPath}" is being ignored by Git. This could be due to a complex pattern in .gitignore. Remove any entries that might affect this directory.`
+      : `Final destination directory "${outputPath}" is not being ignored by Git, which is good.`
   }];
 }
 
 /**
- * Check if the output directory is being ignored by Git
+ * Check if the final destination directory (from output_path in specs.json) is being ignored by Git
+ * This checks the directory where index.html is generated, NOT the temporary .cache directory
  * @param {string} projectRoot - Root directory of the project
  * @returns {Promise<Array>} - Array of check results
  */
-async function checkOutputDirGitIgnore(projectRoot) {
+async function checkDestinationGitIgnore(projectRoot) {
   const results = [];
   
   try {
@@ -369,7 +384,7 @@ async function checkOutputDirGitIgnore(projectRoot) {
     const relevantLines = getRelevantGitignoreLines(gitignoreContent);
     const dirName = path.basename(normalizedPath);
     
-    // Check output directory ignore patterns
+    // Check final destination directory ignore patterns
     const dirResults = checkOutputDirIgnorePatterns(
       projectRoot, normalizedPath, outputPath, dirName, relevantLines
     );
@@ -383,9 +398,9 @@ async function checkOutputDirGitIgnore(projectRoot) {
     
     return results;
   } catch (error) {
-    console.error('Error checking output directory gitignore status:', error);
+    console.error('Error checking final destination directory gitignore status:', error);
     return [{
-      name: 'Output directory gitignore check',
+      name: 'Final destination directory gitignore check',
       success: false,
       details: `Error: ${error.message}`
     }];
@@ -393,5 +408,5 @@ async function checkOutputDirGitIgnore(projectRoot) {
 }
 
 module.exports = {
-  checkOutputDirGitIgnore
+  checkDestinationGitIgnore
 };

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