spec-up-t 1.6.16 → 1.6.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-up-t",
-  "version": "1.6.16",
+  "version": "1.6.18",
   "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": {

package/src/install-from-boilerplate/add-gitignore-entries.js

@@ -30,10 +30,17 @@ async function updateGitignore(gitignorePath, filesToAdd) {
         // Split the content into lines and remove empty lines
         const gitignoreLines = gitignoreContent.split('\n').filter(line => line.trim() !== '');
 
-        // Add files to .gitignore if they are not already present
+        // Add files to .gitignore if they are not already present.
+        // Strip inline comments from existing lines before comparing, so that
+        // entries like "*.lnk  # some comment" are not duplicated.
         filesToAdd.forEach(file => {
-            if (!gitignoreLines.some(line => line.trim() === file.trim())) {
-                gitignoreLines.push(file.trim());
+            const pattern = file.trim();
+            const alreadyPresent = gitignoreLines.some(line => {
+                const linePattern = line.trim().split('#')[0].trim();
+                return linePattern === pattern;
+            });
+            if (!alreadyPresent) {
+                gitignoreLines.push(pattern);
             }
         });
 

package/src/install-from-boilerplate/config-gitignore-entries.js

@@ -3,19 +3,41 @@ const path = require('path');
 // Configuration
 const gitIgnoreEntries = {
     gitignorePath: path.join(process.cwd(), '.gitignore'),
-    filesToAdd: ['node_modules',
+    filesToAdd: [
+        // Generated by render-and-deploy.yml — do not commit build output
+        'docs/',
+        // Dependencies
+        'node_modules/',
+        // Logs
         '*.log',
-        'dist',
+        // Editor / OS temporaries & backups
         '*.bak',
         '*.tmp',
+        '.idea',
+        '.vscode/',
+        // Environment / secrets
+        '.env*',
+        // Test coverage
+        'coverage/',
+        // Various caches & history
+        '.history/',
+        '.cache/',
+        // macOS
         '.DS_Store',
-        '.env',
-        'coverage',
-        'build',
-        '.history',
-        // Generated by render-and-deploy.yml — do not commit build output
-        'docs'
-],
+        '.AppleDouble',
+        '.LSOverride',
+        // Windows
+        'Thumbs.db',
+        'ehthumbs.db',
+        'Desktop.ini',
+        '$RECYCLE.BIN/',
+        '*.lnk',
+        // Linux / Ubuntu / general Unix-like
+        '*~',
+        '.*.swp',
+        '.*.swo',
+        '.fuse_hidden*',
+    ],
 };
 
 module.exports = { gitIgnoreEntries };

package/src/install-from-boilerplate/migrate-versions-to-snapshots.js

@@ -111,9 +111,27 @@ function migrateVersionsToSnapshots(outputPath) {
     }
 
     if (migratedCount > 0) {
-        Logger.success(
-            `Migrated ${migratedCount} snapshot(s) from ${src} to ${dest}/. ` +
-            `You can now safely run: git rm -r --cached ${outputPath}`
+        Logger.action(
+            `Migrated ${migratedCount} snapshot(s) from ${src} to ${dest}/.`,
+            {
+                hint: `git rm -r --cached ${outputPath}`,
+                context: 'Remove old docs from git tracking'
+            }
+        );
+        Logger.action(
+            'Configure GitHub Pages deployment',
+            {
+                hint: 'Update your repository settings to deploy from gh-pages branch',
+                steps: [
+                    'Go to your repository on GitHub',
+                    'Click Settings',
+                    'In the left sidebar, click Pages',
+                    'Under Build and deployment, set Source to Deploy from a branch',
+                    'Select the gh-pages branch and / (root) folder',
+                    'Click Save'
+                ],
+                context: 'Enable GitHub Pages to serve your snapshots from the gh-pages branch'
+            }
         );
     }
 }

package/src/utils/logger.js

@@ -131,6 +131,66 @@ class Logger {
         console.log(); // Extra newline for readability
     }
 
+    /**
+     * Action required messages - red with pointing hand icon
+     * 
+     * Indicates that the user must take action to proceed.
+     * More urgent than a warning, used when user intervention is required.
+     * 
+     * @param {string} message - The main action required message
+     * @param {...any} args - Additional arguments. Can include:
+     *   - Regular values (strings, numbers, objects) for message formatting
+     *   - An options object (if last arg is object with 'hint', 'context', or 'details' keys):
+     *     - hint: Clear instruction on what action to take
+     *     - context: Additional context about why action is needed
+     *     - details: Technical details or related information
+     * 
+     * @example
+     * Logger.action('Configuration required before proceeding', { 
+     *   context: 'specs.json is incomplete',
+     *   hint: 'Add the "title" and "github_url" fields to specs.json',
+     *   details: 'See https://example.com/docs' 
+     * });
+     */
+    static action(message, ...args) {
+        // Extract options object if present (last arg with special keys)
+        const lastArg = args[args.length - 1];
+        const isOptionsObject = lastArg && typeof lastArg === 'object' &&
+            (lastArg.hint || lastArg.context || lastArg.details);
+
+        const options = isOptionsObject ? args.pop() : {};
+        const regularArgs = args;
+
+        // Display main action required message - red to signal urgency
+        console.log(chalk.red('👉'), chalk.red(message), ...regularArgs);
+
+        // Display context if provided - explains why action is needed
+        if (options.context) {
+            console.log(chalk.red('   Context:'), chalk.gray(options.context));
+        }
+
+        // Display technical details if provided - helps understand the situation
+        if (options.details) {
+            const detailsStr = typeof options.details === 'object'
+                ? JSON.stringify(options.details, null, 2)
+                : String(options.details);
+            console.log(chalk.red('   Details:'), chalk.gray(detailsStr));
+        }
+
+        // Display hint if provided - critical instruction on what to do
+        if (options.hint) {
+            console.log(chalk.red('   👉 Action:'), chalk.red(options.hint));
+        }
+
+        // Collect message with all context for healthcheck/JSON output
+        messageCollector.addMessage('action', message, [...regularArgs, options]);
+
+        console.log(); // Extra newline for readability
+    }
+
+    /**
+     * Information messages - blue
+     */
     static info(message, ...args) {
         console.log(chalk.blue('📋'), chalk.blue(message), ...args);
         messageCollector.addMessage('info', message, args);