learn_bash_from_session_data 1.0.4 → 1.0.6

package/bash-learner-output/run-2026-02-05-155949/summary.json

@@ -0,0 +1,163 @@
+{
+  "metadata": {
+    "generated_at": "2026-02-05T15:59:49.814630",
+    "run_id": "run-2026-02-05-155949",
+    "version": "1.0.5"
+  },
+  "input": {
+    "sessions_processed": 10,
+    "session_files": [
+      {
+        "filename": "081cfcfd-cde6-4304-89ca-6ac61faf8d85.jsonl",
+        "path": "/mnt/c/Users/brand/.claude/projects/C--Users-brand-Development-Project-Workspace-active-development-session-with-chris/081cfcfd-cde6-4304-89ca-6ac61faf8d85.jsonl",
+        "size": "759.1 KB",
+        "modified": "2026-02-05 11:01:08"
+      },
+      {
+        "filename": "2ee58010-e794-48d8-a1b7-0ba14e06e7b7.jsonl",
+        "path": "/mnt/c/Users/brand/.claude/projects/C--Users-brand/2ee58010-e794-48d8-a1b7-0ba14e06e7b7.jsonl",
+        "size": "1.8 KB",
+        "modified": "2026-02-05 10:22:23"
+      },
+      {
+        "filename": "ef6494ae-aca1-43b1-800d-d5586069d42c.jsonl",
+        "path": "/mnt/c/Users/brand/.claude/projects/C--Users-brand/ef6494ae-aca1-43b1-800d-d5586069d42c.jsonl",
+        "size": "1.8 KB",
+        "modified": "2026-01-23 14:32:05"
+      },
+      {
+        "filename": "6b1fb6cd-5865-4a5f-97f9-5e1e46d79f81.jsonl",
+        "path": "/mnt/c/Users/brand/.claude/projects/C--Users-brand/6b1fb6cd-5865-4a5f-97f9-5e1e46d79f81.jsonl",
+        "size": "3.7 KB",
+        "modified": "2026-01-19 22:44:52"
+      },
+      {
+        "filename": "9db5f466-5bc4-4778-94ba-b10d72e8c464.jsonl",
+        "path": "/mnt/c/Users/brand/.claude/projects/C--Users-brand/9db5f466-5bc4-4778-94ba-b10d72e8c464.jsonl",
+        "size": "916.0 B",
+        "modified": "2026-01-19 09:25:47"
+      },
+      {
+        "filename": "dfc82e92-9786-4baf-a5df-44046f21f90a.jsonl",
+        "path": "/mnt/c/Users/brand/.claude/projects/C--Users-brand-Development-Project-Workspace-active-development-en-consulta/dfc82e92-9786-4baf-a5df-44046f21f90a.jsonl",
+        "size": "1.0 KB",
+        "modified": "2026-01-16 06:42:34"
+      },
+      {
+        "filename": "b3c0facc-2728-48a5-a1d0-0fed6b049cf2.jsonl",
+        "path": "/mnt/c/Users/brand/.claude/projects/C--Users-brand/b3c0facc-2728-48a5-a1d0-0fed6b049cf2.jsonl",
+        "size": "116.0 B",
+        "modified": "2026-01-08 21:01:17"
+      },
+      {
+        "filename": "846d1c3c-05e3-4d86-9aae-c8bd266962d4.jsonl",
+        "path": "/mnt/c/Users/brand/.claude/projects/C--Users-brand/846d1c3c-05e3-4d86-9aae-c8bd266962d4.jsonl",
+        "size": "1.8 KB",
+        "modified": "2026-01-08 21:00:57"
+      },
+      {
+        "filename": "agent-a979d7c.jsonl",
+        "path": "/mnt/c/Users/brand/.claude/projects/C--Users-brand/agent-a979d7c.jsonl",
+        "size": "2.0 KB",
+        "modified": "2026-01-06 20:47:47"
+      },
+      {
+        "filename": "agent-a1fb460.jsonl",
+        "path": "/mnt/c/Users/brand/.claude/projects/C--Users-brand/agent-a1fb460.jsonl",
+        "size": "1.9 KB",
+        "modified": "2026-01-06 20:47:44"
+      }
+    ],
+    "total_entries": 438
+  },
+  "analysis": {
+    "raw_commands_found": 37,
+    "unique_commands": 53,
+    "categories": [
+      "Unknown",
+      "Package Management",
+      "Text Processing",
+      "File System",
+      "Shell Builtins",
+      "Development",
+      "Git",
+      "Search & Navigation",
+      "Process & System"
+    ],
+    "category_counts": {
+      "Unknown": 5,
+      "Package Management": 4,
+      "Text Processing": 3,
+      "File System": 7,
+      "Shell Builtins": 3,
+      "Development": 5,
+      "Git": 24,
+      "Search & Navigation": 1,
+      "Process & System": 1
+    },
+    "top_base_commands": [
+      {
+        "command": "cd",
+        "count": 18
+      },
+      {
+        "command": "git",
+        "count": 17
+      },
+      {
+        "command": "gh",
+        "count": 9
+      },
+      {
+        "command": "python",
+        "count": 5
+      },
+      {
+        "command": "mkdir",
+        "count": 3
+      },
+      {
+        "command": "ls",
+        "count": 3
+      },
+      {
+        "command": "echo",
+        "count": 3
+      },
+      {
+        "command": "session-slides",
+        "count": 3
+      },
+      {
+        "command": "pip",
+        "count": 2
+      },
+      {
+        "command": "head",
+        "count": 2
+      }
+    ],
+    "operators_used": {
+      "||": 4,
+      "|": 3,
+      "2>&1": 8,
+      "2>/dev/null": 5,
+      "&&": 29,
+      ">": 5,
+      "<": 13
+    },
+    "complexity_distribution": {
+      "1": 10,
+      "2": 23,
+      "3": 15,
+      "4": 3,
+      "5": 2
+    }
+  },
+  "output": {
+    "quiz_questions": 20,
+    "html_files": [
+      "bash-learner-output/run-2026-02-05-155949/index.html"
+    ]
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "learn_bash_from_session_data",
-  "version": "1.0.4",
-  "description": "Learn bash from your Claude Code sessions - extracts commands and generates interactive HTML lessons",
+  "version": "1.0.6",
+  "description": "Learn bash from your Claude Code sessions - extracts commands and generates interactive HTML lessons with 400+ commands, quizzes, and comprehensive coverage",
   "main": "bin/learn-bash.js",
   "bin": {
     "learn-bash": "bin/learn-bash.js",
@@ -16,7 +16,11 @@
     "claude",
     "cli",
     "terminal",
-    "shell"
+    "shell",
+    "quiz",
+    "commands",
+    "interactive",
+    "education"
   ],
   "author": "",
   "license": "MIT",

package/scripts/html_generator.py

@@ -114,19 +114,52 @@ def _generate_html_impl(analysis_result: dict[str, Any], quizzes: list[dict[str,
 </html>'''
 
 
+def _generate_operators_html(operators_used: dict, operator_descriptions: dict) -> str:
+    """Generate HTML for the operators used section."""
+    if not operators_used:
+        return '<p class="empty-state">No bash operators detected in these commands</p>'
+
+    operators_html = ""
+    # Sort by count descending
+    sorted_ops = sorted(operators_used.items(), key=lambda x: -x[1])
+    max_count = sorted_ops[0][1] if sorted_ops else 1
+
+    for op, count in sorted_ops:
+        name, desc = operator_descriptions.get(op, (op, 'Bash operator'))
+        bar_width = (count / max_count) * 100
+        operators_html += f'''
+                                <div class="operator-item">
+                                    <div class="operator-symbol"><code>{html.escape(op)}</code></div>
+                                    <div class="operator-info">
+                                        <div class="operator-name">{html.escape(name)}</div>
+                                        <div class="operator-desc">{html.escape(desc)}</div>
+                                    </div>
+                                    <div class="operator-bar-container">
+                                        <div class="operator-bar" style="width: {bar_width}%"></div>
+                                    </div>
+                                    <div class="operator-count">{count}</div>
+                                </div>'''
+    return operators_html
+
+
 def render_overview_tab(stats: dict[str, Any], commands: list[dict], categories: dict) -> str:
     """Render the overview/dashboard tab content."""
     total_commands = stats.get("total_commands", 0)
     unique_commands = stats.get("unique_commands", 0)
     unique_utilities = stats.get("unique_utilities", 0)
     date_range = stats.get("date_range", {"start": "N/A", "end": "N/A"})
-    complexity_dist = stats.get("complexity_distribution", {"simple": 0, "intermediate": 0, "advanced": 0})
-
-    # Calculate percentages for complexity bars
-    total_for_pct = sum(complexity_dist.values()) or 1
-    simple_pct = (complexity_dist.get("simple", 0) / total_for_pct) * 100
-    intermediate_pct = (complexity_dist.get("intermediate", 0) / total_for_pct) * 100
-    advanced_pct = (complexity_dist.get("advanced", 0) / total_for_pct) * 100
+    # Get operators data for the "Bash Operators Used" section
+    operators_used = stats.get("operators_used", {})
+    operator_descriptions = {
+        '|': ('Pipe', 'Sends output of one command to input of another'),
+        '||': ('OR operator', 'Run next command if previous failed'),
+        '&&': ('AND operator', 'Run next command if previous succeeded'),
+        '2>&1': ('Redirect stderr', 'Combines error output with standard output'),
+        '2>/dev/null': ('Suppress errors', 'Discards error messages'),
+        '>': ('Redirect output', 'Writes output to a file (overwrites)'),
+        '>>': ('Append output', 'Appends output to a file'),
+        '<': ('Redirect input', 'Reads input from a file'),
+    }
 
     # Top 10 commands by frequency - use pre-computed data if available
     top_commands_data = stats.get("top_commands", [])
@@ -237,29 +270,9 @@ def render_overview_tab(stats: dict[str, Any], commands: list[dict], categories:
 
                     <div class="charts-row">
                         <div class="chart-card">
-                            <h3>Complexity Distribution</h3>
-                            <div class="complexity-bars">
-                                <div class="complexity-row">
-                                    <span class="complexity-label simple">Simple</span>
-                                    <div class="complexity-bar-bg">
-                                        <div class="complexity-bar simple" style="width: {simple_pct}%"></div>
-                                    </div>
-                                    <span class="complexity-count">{complexity_dist.get("simple", 0)}</span>
-                                </div>
-                                <div class="complexity-row">
-                                    <span class="complexity-label intermediate">Intermediate</span>
-                                    <div class="complexity-bar-bg">
-                                        <div class="complexity-bar intermediate" style="width: {intermediate_pct}%"></div>
-                                    </div>
-                                    <span class="complexity-count">{complexity_dist.get("intermediate", 0)}</span>
-                                </div>
-                                <div class="complexity-row">
-                                    <span class="complexity-label advanced">Advanced</span>
-                                    <div class="complexity-bar-bg">
-                                        <div class="complexity-bar advanced" style="width: {advanced_pct}%"></div>
-                                    </div>
-                                    <span class="complexity-count">{complexity_dist.get("advanced", 0)}</span>
-                                </div>
+                            <h3>Bash Operators Used</h3>
+                            <div class="operators-list">
+                                {_generate_operators_html(operators_used, operator_descriptions)}
                             </div>
                         </div>
 
@@ -385,11 +398,10 @@ def render_commands_tab(commands: list[dict]) -> str:
                             </div>'''
 
         commands_html += f'''
-                        <div class="command-card" data-category="{category}" data-complexity="{complexity}" data-frequency="{frequency}" data-name="{base_cmd}">
+                        <div class="command-card" data-category="{category}" data-frequency="{frequency}" data-name="{base_cmd}">
                             <div class="command-header" onclick="toggleCommand('{cmd_id}')">
                                 <div class="command-main">
                                     <code class="cmd">{base_cmd}</code>
-                                    <span class="complexity-badge {complexity}">{complexity}</span>
                                     <span class="category-badge">{category}</span>
                                 </div>
                                 <div class="command-meta">
@@ -504,7 +516,6 @@ def render_lessons_tab(categories: dict, commands: list[dict]) -> str:
                             <div class="lesson-command">
                                 <div class="lesson-command-header">
                                     <code class="cmd">{base_cmd}</code>
-                                    <span class="complexity-badge {complexity}">{complexity}</span>
                                 </div>
                                 <pre class="syntax-highlighted">{highlighted}</pre>
                                 <p class="lesson-description">{description}</p>
@@ -548,20 +559,17 @@ def render_lessons_tab(categories: dict, commands: list[dict]) -> str:
 def _get_category_concept(category: str) -> str:
     """Get concept overview for a category."""
     concepts = {
-        "File Management": "Commands for creating, copying, moving, deleting, and organizing files and directories in the filesystem.",
-        "Text Processing": "Tools for searching, filtering, transforming, and manipulating text content in files and streams.",
-        "System Administration": "Commands for managing system resources, processes, users, and system configuration.",
-        "Network": "Utilities for network communication, file transfer, and connectivity diagnostics.",
-        "Package Management": "Tools for installing, updating, and managing software packages on the system.",
-        "Version Control": "Git and other version control commands for tracking changes and collaborating on code.",
-        "Process Management": "Commands for viewing, controlling, and managing running processes.",
-        "User Management": "Tools for managing user accounts, permissions, and access control.",
-        "Disk Management": "Utilities for managing disk space, partitions, and storage devices.",
-        "Shell Scripting": "Built-in shell commands and constructs for scripting and automation.",
-        "Development": "Programming tools, compilers, interpreters, and development utilities.",
-        "Compression": "Tools for compressing, archiving, and extracting files.",
-        "Search": "Commands for finding files, searching content, and locating resources.",
-        "Permissions": "Tools for managing file permissions, ownership, and access control.",
+        "File System": "Commands for navigating, viewing, creating, and managing files and directories in the filesystem.",
+        "Text Processing": "Tools for viewing, searching, filtering, and transforming text content in files and streams.",
+        "Git": "Version control system commands for tracking changes, managing branches, and collaborating on code.",
+        "Package Management": "Package managers for installing, updating, and managing software dependencies across languages and platforms.",
+        "Process & System": "Commands for monitoring, managing, and controlling running processes and system resources.",
+        "Networking": "Commands for network operations, file transfers, remote access, and connectivity diagnostics.",
+        "Permissions": "Commands for managing file ownership, access permissions, and user/group administration.",
+        "Compression": "Commands for compressing, archiving, and extracting files using various algorithms.",
+        "Search & Navigation": "Commands for finding files, searching content, and navigating the filesystem efficiently.",
+        "Development": "Development tools for building, testing, compiling, and running code across languages.",
+        "Shell Builtins": "Built-in shell commands for scripting, variable management, and interactive shell use.",
     }
     return concepts.get(category, f"Commands related to {category.lower()} operations and utilities.")
 
@@ -569,20 +577,17 @@ def _get_category_concept(category: str) -> str:
 def _get_category_icon(category: str) -> str:
     """Get icon for a category."""
     icons = {
-        "File Management": "&#128193;",
+        "File System": "&#128193;",
         "Text Processing": "&#128196;",
-        "System Administration": "&#9881;",
-        "Network": "&#127760;",
+        "Git": "&#128202;",
         "Package Management": "&#128230;",
-        "Version Control": "&#128202;",
-        "Process Management": "&#9654;",
-        "User Management": "&#128100;",
-        "Disk Management": "&#128191;",
-        "Shell Scripting": "&#10095;",
-        "Development": "&#128187;",
-        "Compression": "&#128230;",
-        "Search": "&#128269;",
+        "Process & System": "&#9881;",
+        "Networking": "&#127760;",
         "Permissions": "&#128274;",
+        "Compression": "&#128230;",
+        "Search & Navigation": "&#128269;",
+        "Development": "&#128187;",
+        "Shell Builtins": "&#10095;",
     }
     return icons.get(category, "&#128204;")
 
@@ -990,6 +995,77 @@ def get_inline_css() -> str:
             color: var(--text-secondary);
         }
 
+        /* Operators List */
+        .operators-list {
+            display: flex;
+            flex-direction: column;
+            gap: 12px;
+        }
+
+        .operator-item {
+            display: grid;
+            grid-template-columns: 80px 1fr 120px 50px;
+            align-items: center;
+            gap: 12px;
+            padding: 8px 0;
+            border-bottom: 1px solid var(--border-color);
+        }
+
+        .operator-item:last-child {
+            border-bottom: none;
+        }
+
+        .operator-symbol {
+            font-family: var(--font-mono);
+            font-size: 1rem;
+            font-weight: 600;
+            color: var(--accent-primary);
+        }
+
+        .operator-symbol code {
+            background: var(--bg-tertiary);
+            padding: 4px 8px;
+            border-radius: var(--radius-sm);
+        }
+
+        .operator-info {
+            display: flex;
+            flex-direction: column;
+            gap: 2px;
+        }
+
+        .operator-name {
+            font-size: 0.9rem;
+            font-weight: 600;
+            color: var(--text-primary);
+        }
+
+        .operator-desc {
+            font-size: 0.8rem;
+            color: var(--text-secondary);
+        }
+
+        .operator-bar-container {
+            height: 20px;
+            background: var(--bg-tertiary);
+            border-radius: var(--radius-sm);
+            overflow: hidden;
+        }
+
+        .operator-bar {
+            height: 100%;
+            background: var(--accent-primary);
+            border-radius: var(--radius-sm);
+            transition: width 0.5s ease;
+        }
+
+        .operator-count {
+            font-size: 0.9rem;
+            font-weight: 600;
+            text-align: right;
+            color: var(--text-secondary);
+        }
+
         /* Pie Chart */
         .pie-container {
             display: flex;
@@ -2081,6 +2157,7 @@ def generate_html_files(
             'complexity_avg': stats.get('average_complexity', 2),
             'complexity_distribution': complexity_distribution,
             'top_commands': top_10_commands,  # Pre-computed top commands with frequencies
+            'operators_used': analysis.get('operators_used', {}),  # Bash operators like ||, &&, |, 2>&1
         },
         'commands': formatted_commands,
         'categories': {cat: [c.get('command', '') for c in cmds] for cat, cmds in categories.items()},