shellmate-cli 3.0.0__py3-none-any.whl → 3.0.2__py3-none-any.whl

shellmate/adapters/ble_adapter.sh

@@ -107,6 +107,8 @@ print(json.dumps({
     suggested_fix=$(python3 -c "import sys,json; d=json.loads(sys.argv[1]); print(d.get('suggested_fix',''))" "$raw" 2>/dev/null)
     severity=$(python3 -c "import sys,json; d=json.loads(sys.argv[1]); print(d.get('severity','MEDIUM'))" "$raw" 2>/dev/null)
 
+    # Color scheme mirrors shellmate/ui/colors.py: caution=91 red, warning=93
+    # yellow, suggestion/safe=92 green.
     local color="\e[93m"
     [[ "$severity" == "HIGH" || "$severity" == "CRITICAL" || "$severity" == "blocking" ]] && color="\e[91m"
     [[ "$severity" == "SAFE" || "$severity" == "LOW" ]] && color="\e[92m"
@@ -114,7 +116,8 @@ print(json.dumps({
     local line1 line2 line3=""
     line1="${color}  → ${what_happens}\e[m"
     line2="${color}  → Reversible: ${reversible}  |  ${scope}\e[m"
-    [[ -n "$suggested_fix" ]] && line3="\e[90m  → Safe alt: ${suggested_fix}\e[m"
+    # A suggested fix is a suggestion -> green (92), not dim.
+    [[ -n "$suggested_fix" ]] && line3="\e[92m  → Safe alt: ${suggested_fix}\e[m"
 
     # Gate HIGH/CRITICAL on second Enter
     if [[ "$severity" == "HIGH" || "$severity" == "CRITICAL" || "$severity" == "blocking" ]]; then
@@ -328,10 +331,11 @@ print('\n'.join(get_completions(sys.argv[1])))
       _SHELLMATE_TAB_CMD="$first"
       _SHELLMATE_TAB_STATE="suggested"
       local suffix="${first#$line}"
+      # Autocomplete ghost-text is a suggestion -> green (92), per shellmate/ui/colors.py.
       if [[ -n "$suffix" ]] && type ble/canvas/put.draw &>/dev/null; then
-        ble/canvas/put.draw "\e[90m${suffix}\e[m"
+        ble/canvas/put.draw "\e[92m${suffix}\e[m"
       elif [[ -n "$suffix" ]]; then
-        printf '\e[90m%s\e[m' "$suffix" >/dev/tty
+        printf '\e[92m%s\e[m' "$suffix" >/dev/tty
         printf '\e[%dD' "${#suffix}" >/dev/tty
       fi
     fi

shellmate/adapters/powershell_adapter.ps1

@@ -70,11 +70,13 @@ function Show-ShellMateConsequence {
              elseif ($Severity -in @("SAFE","LOW")) { "${ESC}[92m" } `
              else { "${ESC}[93m" }
     $reset = "${ESC}[0m"
-    $dim   = "${ESC}[90m"
+    # Color scheme mirrors shellmate/ui/colors.py: caution=91 red, warning=93
+    # yellow, suggestion/safe=92 green. A suggested fix is a suggestion -> green.
+    $green = "${ESC}[92m"
 
     $line1 = "${color}  -> ${WhatHappens}${reset}"
     $line2 = "${color}  -> Reversible: ${Reversible}  |  ${Scope}${reset}"
-    $line3 = if ($SuggestedFix) { "${dim}  -> Safe alt: ${SuggestedFix}${reset}" } else { "" }
+    $line3 = if ($SuggestedFix) { "${green}  -> Safe alt: ${SuggestedFix}${reset}" } else { "" }
 
     # Save cursor, write 3 lines below prompt, restore
     [Console]::Write("${ESC}[s")
@@ -368,7 +370,9 @@ if (-not $script:ShellMatePredictorRegistered) {
                     $ESC = [char]27
                     $suffix = ([string]$suggestion).Substring([Math]::Min($prefix.Length, ([string]$suggestion).Length))
                     if ($suffix) {
-                        [Console]::Write("${ESC}[90m${suffix}${ESC}[0m")
+                        # Autocomplete ghost-text is a suggestion -> green (92),
+                        # matching shellmate/ui/colors.py.
+                        [Console]::Write("${ESC}[92m${suffix}${ESC}[0m")
                         [Console]::Write("${ESC}[$($suffix.Length)D")
                     }
                     return

shellmate/adapters/powershell_predictor.ps1

@@ -89,6 +89,9 @@ if ($py -and (Test-Path $client)) {
             $predictor
         )
         Set-PSReadLineOption -PredictionSource Plugin -PredictionViewStyle InlineView -ErrorAction SilentlyContinue
+        # Render predictions green — they are suggestions (mirrors shellmate/ui/colors.py).
+        $smEsc = [char]27
+        Set-PSReadLineOption -Colors @{ InlinePrediction = "${smEsc}[92m" } -ErrorAction SilentlyContinue
         $script:ShellMatePredictorRegistered = $true
     } catch {
         Write-Verbose "ShellMate: predictor registration failed: $_"

shellmate/cli/version.py

@@ -1 +1 @@
-VERSION = "3.0.0"
+VERSION = "3.0.2"

shellmate/ui/annotations.py

@@ -4,6 +4,8 @@ from __future__ import annotations
 
 from typing import Any, Dict, Optional
 
+from shellmate.ui import colors
+
 # Emoji mappings for risk levels (short inline / Unix terminals)
 RISK_ICONS = {
     "SAFE": "✅",
@@ -105,6 +107,7 @@ def format_consequence_annotation(
     risk: str = "MEDIUM",
     *,
     ascii_safe: bool = False,
+    color: bool = False,
 ) -> str:
     """Format annotation using structured consequence preview + badges."""
     env_context = env_context or {}
@@ -137,7 +140,12 @@ def format_consequence_annotation(
     if not consequence.get("reversible", True):
         parts.append("[IRREVERSIBLE]")
 
-    return " ".join(parts) if len(parts) > 1 else ""
+    if len(parts) <= 1:
+        return ""
+    text = " ".join(parts)
+    # Consequence severity ("blocking"/"warning"/"info") or risk level both map
+    # through SEVERITY_ROLE -> caution=red / warning=yellow / safe=green.
+    return colors.by_severity(text, severity if severity in colors.SEVERITY_ROLE else risk) if color else text
 
 
 def format_legacy_pipeline_annotation(
@@ -146,6 +154,7 @@ def format_legacy_pipeline_annotation(
     chain_patterns: Optional[Dict[str, Any]] = None,
     *,
     ascii_safe: bool = False,
+    color: bool = False,
 ) -> str:
     """Format annotation from pipeline result without consequence_preview."""
     env_context = env_context or {}
@@ -186,7 +195,10 @@ def format_legacy_pipeline_annotation(
             msg = msg[:37] + "..."
         parts.append(msg)
 
-    return " ".join(parts) if len(parts) > 1 else ""
+    if len(parts) <= 1:
+        return ""
+    text = " ".join(parts)
+    return colors.by_severity(text, risk) if color else text
 
 
 def format_pipeline_annotation(
@@ -195,6 +207,7 @@ def format_pipeline_annotation(
     chain_patterns: Optional[Dict[str, Any]] = None,
     *,
     ascii_safe: bool = False,
+    color: bool = False,
 ) -> str:
     """Prefer consequence_preview; fall back to legacy pipeline formatting."""
     consequence = risk_result.get("consequence_preview") or {}
@@ -205,13 +218,16 @@ def format_pipeline_annotation(
             chain_patterns,
             risk_result.get("risk", "MEDIUM"),
             ascii_safe=ascii_safe,
+            color=color,
         )
     return format_legacy_pipeline_annotation(
-        risk_result, env_context, chain_patterns, ascii_safe=ascii_safe
+        risk_result, env_context, chain_patterns, ascii_safe=ascii_safe, color=color
     )
 
 
-def format_cached_annotation(cached_result: Dict[str, Any], *, ascii_safe: bool = False) -> str:
+def format_cached_annotation(
+    cached_result: Dict[str, Any], *, ascii_safe: bool = False, color: bool = False
+) -> str:
     """Format a simple annotation from a cache hit payload."""
     msg = cached_result.get("explanation", "") or ""
     risk = cached_result.get("risk", "MEDIUM")
@@ -229,4 +245,7 @@ def format_cached_annotation(cached_result: Dict[str, Any], *, ascii_safe: bool
 
     if len(msg) > 50:
         msg = msg[:47] + "..."
-    return f"{icon} {msg}" if msg else ""
+    if not msg:
+        return ""
+    text = f"{icon} {msg}"
+    return colors.by_severity(text, risk) if color else text

shellmate/ui/colors.py

@@ -0,0 +1,109 @@
+"""Semantic terminal colors for suggestions and cautions.
+
+Single source of truth for ShellMate's inline color scheme so every surface
+agrees on what red / yellow / green mean:
+
+    caution     -> red     (dangerous: HIGH / CRITICAL / blocking)
+    warning     -> yellow  (proceed with care: MEDIUM)
+    suggestion  -> green    (a safer alternative / "Safe alt")
+    safe        -> green    (SAFE / LOW — nothing to worry about)
+    info        -> cyan     (neutral information)
+    dim         -> grey     (de-emphasized)
+
+The shell adapters (``powershell_adapter.ps1`` / ``ble_adapter.sh``) mirror these
+SGR codes directly since they render ANSI themselves; keep them in sync with
+``ROLE_SGR`` below. Python-side rendering should use this module.
+
+Honors the https://no-color.org convention: if the ``NO_COLOR`` environment
+variable is set (to anything), colorizing becomes a no-op.
+"""
+
+from __future__ import annotations
+
+import os
+from typing import Optional
+
+ESC = "\033"
+RESET = f"{ESC}[0m"
+
+# Role -> SGR (Select Graphic Rendition) code. Bright variants read well on both
+# dark and light terminals. Mirror these in the shell adapters.
+ROLE_SGR = {
+    "caution": 91,     # bright red
+    "warning": 93,     # bright yellow
+    "suggestion": 92,  # bright green
+    "safe": 92,        # bright green
+    "info": 96,        # bright cyan
+    "dim": 90,         # grey
+}
+
+# Role -> rich style name, for Console/Text rendering in the CLI scenes.
+ROLE_RICH = {
+    "caution": "bold red",
+    "warning": "yellow",
+    "suggestion": "green",
+    "safe": "green",
+    "info": "cyan",
+    "dim": "bright_black",
+}
+
+# Risk/severity label -> semantic role.
+SEVERITY_ROLE = {
+    "CRITICAL": "caution",
+    "HIGH": "caution",
+    "blocking": "caution",
+    "MEDIUM": "warning",
+    "warning": "warning",
+    "LOW": "safe",
+    "SAFE": "safe",
+    "info": "info",
+}
+
+
+def color_enabled(no_color: Optional[bool] = None) -> bool:
+    """Whether color should be emitted.
+
+    Explicit ``no_color`` wins; otherwise honor the ``NO_COLOR`` env var.
+    """
+    if no_color is not None:
+        return not no_color
+    return os.environ.get("NO_COLOR") is None
+
+
+def role_for_severity(severity: Optional[str]) -> str:
+    """Map a risk/severity label to a semantic role (defaults to ``warning``)."""
+    return SEVERITY_ROLE.get(severity or "", "warning")
+
+
+def colorize(text: str, role: str, *, no_color: Optional[bool] = None) -> str:
+    """Wrap ``text`` in the ANSI color for ``role``.
+
+    Returns ``text`` unchanged when color is disabled, the text is empty, or the
+    role is unknown — so it is always safe to call.
+    """
+    if not text or not color_enabled(no_color):
+        return text
+    sgr = ROLE_SGR.get(role)
+    if sgr is None:
+        return text
+    return f"{ESC}[{sgr}m{text}{RESET}"
+
+
+def caution(text: str, *, no_color: Optional[bool] = None) -> str:
+    """Red — a dangerous command or consequence."""
+    return colorize(text, "caution", no_color=no_color)
+
+
+def warning(text: str, *, no_color: Optional[bool] = None) -> str:
+    """Yellow — proceed with care."""
+    return colorize(text, "warning", no_color=no_color)
+
+
+def suggestion(text: str, *, no_color: Optional[bool] = None) -> str:
+    """Green — a safer alternative to offer."""
+    return colorize(text, "suggestion", no_color=no_color)
+
+
+def by_severity(text: str, severity: Optional[str], *, no_color: Optional[bool] = None) -> str:
+    """Colorize ``text`` using the role implied by a risk/severity label."""
+    return colorize(text, role_for_severity(severity), no_color=no_color)

shellmate_cli-3.0.2.dist-info/METADATA

@@ -0,0 +1,326 @@
+Metadata-Version: 2.4
+Name: shellmate-cli
+Version: 3.0.2
+Summary: Intelligent shell autocomplete with consequence preview
+Author: ShellMate Contributors
+License: MIT
+Project-URL: Homepage, https://github.com/sayan-does/shellmate
+Project-URL: Repository, https://github.com/sayan-does/shellmate
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Environment :: Console
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: groq>=0.4.0
+Requires-Dist: openai>=1.0.0
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: langgraph>=1.2.0
+Requires-Dist: langchain-core>=1.4.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: psutil>=5.9.0
+Requires-Dist: watchdog>=4.0.0
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Provides-Extra: windows-test
+Requires-Dist: pywinpty>=2.0.0; sys_platform == "win32" and extra == "windows-test"
+Requires-Dist: pyte>=0.8.1; extra == "windows-test"
+Dynamic: license-file
+
+# ShellMate
+
+**A friendly safety net for your terminal.**
+
+[![PyPI](https://img.shields.io/pypi/v/shellmate-cli)](https://pypi.org/project/shellmate-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/shellmate-cli)](https://pypi.org/project/shellmate-cli/)
+[![License: MIT](https://img.shields.io/pypi/l/shellmate-cli)](LICENSE)
+
+The terminal is powerful — and a little scary when you're starting out. One wrong
+command can delete files, wipe a branch, or break something you didn't mean to touch.
+
+ShellMate is like having an experienced friend looking over your shoulder. As you
+type, it quietly checks your command and, **before you press Enter**, tells you in
+plain English what it will do, whether it's risky, and if there's a safer way. It
+never runs anything for you — **you're always the one in control.**
+
+```text
+$ rm -rf /
+[!!] BLOCKING — this would erase everything. Press Enter again only if you're sure.
+
+$ git push --force
+→ This rewrites history on the remote branch (others may lose work).
+→ Reversible: No   |   target: origin/main
+→ Safer option:   git push --force-with-lease
+```
+
+---
+
+## Why you'll like it
+
+- **Stops the scary stuff.** Genuinely dangerous commands (like `rm -rf /`) are
+  caught instantly and ask you to confirm before they run.
+- **Explains commands in plain English.** No more guessing what a command does —
+  ShellMate tells you what will happen and whether you can undo it.
+- **Suggests safer alternatives.** When there's a gentler way to do the same thing,
+  it offers it.
+- **Autocomplete that helps you learn.** Press Tab for suggestions as you type.
+- **Stays out of your way.** Safe commands run normally — no pop-ups, no nagging.
+- **You stay in control.** ShellMate only *shows* you things. It never executes
+  commands on its own.
+
+---
+
+## Get started in 3 steps
+
+### 1. Install it
+
+```bash
+pip install shellmate-cli
+```
+
+### 2. Give it a brain (a free API key)
+
+ShellMate uses an AI service to explain commands. The easiest free option is **Groq**:
+
+1. Grab a free key at **[console.groq.com](https://console.groq.com)** (takes a minute).
+2. Tell ShellMate about it:
+
+   ```bash
+   sm config
+   ```
+
+   It'll ask you to pick a provider and paste your key. That's it — the key is
+   stored privately on your computer, not in your command history.
+
+### 3. Turn it on
+
+```bash
+sm install    # connects ShellMate to your shell (one time)
+sm enable     # starts the helper in the background
+```
+
+Now just **use your terminal normally.** Little notes will appear under your
+commands as you type.
+
+> **What you need:** Python 3.10+, and either **Windows PowerShell** or, on
+> **Linux/WSL**, [ble.sh](https://github.com/akinomyoga/ble.sh). ShellMate sets up
+> the rest for you.
+
+---
+
+## What it feels like to use
+
+As you type, ShellMate shows a tiny note under your command:
+
+| You type | You see | What it means |
+|----------|---------|---------------|
+| `ls` | *(nothing)* | Totally safe — ShellMate stays quiet. |
+| `git push --force` | `[!] rewrites history [PROD]` | Heads up: this is risky and you're on production. |
+| `rm -rf /` | `[!!] BLOCKING — Enter again to confirm` | Dangerous. It won't run until you really mean it. |
+
+**Dangerous commands don't run on the first Enter.** You'll get a clear warning, and
+only a *second* Enter actually runs them — a gentle "are you sure?" that has saved
+many people from a bad day.
+
+**Want to understand a command?** Press **Tab** for a suggestion, and a short
+"here's what this will do" preview appears before you commit to it.
+
+---
+
+## Everyday commands
+
+These are the only commands you need day to day:
+
+| Command | What it does |
+|---------|--------------|
+| `sm enable` | Turn ShellMate on. |
+| `sm disable` | Turn it off. |
+| `sm status` | Check if it's running and healthy. |
+| `sm config` | Set or update your API key. |
+| `sm uninstall` | Remove ShellMate from your shell (keeps your settings). |
+| `sm --help` | See everything. |
+
+---
+
+## A note on your privacy
+
+Being honest about how it works:
+
+- The **instant danger checks** (like catching `rm -rf /`) run **entirely on your
+  computer** — no internet needed.
+- When ShellMate needs AI help to explain a trickier command, the **command text you
+  typed** is sent to the AI provider you chose (e.g. Groq) so it can analyze it.
+- Your API key is stored locally in a private config file, never in your shell history.
+- As with any tool that talks to a cloud service, **avoid typing passwords or secret
+  keys directly on the command line.**
+
+---
+
+## Troubleshooting
+
+- **"I don't see any notes."** Run `sm status` to confirm the daemon is running, and
+  make sure you ran `sm enable`. On a brand-new install, open a fresh terminal so the
+  shell hook loads.
+- **"It says my AI model isn't available."** Some free accounts can't use every model.
+  ShellMate will warn you at startup and `sm status` lists the models your key *can*
+  use — set one with `sm config`.
+- **"Is it slowing me down?"** Safe commands get an instant local check (under 10ms).
+  Only genuinely unclear commands ever wait on the AI.
+
+---
+
+<details>
+<summary><b>Under the hood</b> (for the curious / power users)</summary>
+
+### How it works
+
+```
+You type in the shell
+    → ble.sh (Linux/WSL) or PSReadLine (Windows) adapter
+    → IPC to a background daemon (TCP 127.0.0.1:9823)
+    → LangGraph analysis pipeline
+    → Inline annotation / confirmation gate
+```
+
+Three tiers, fastest first:
+
+1. **Instant catastrophic check** — local YAML rules (`shellmate/rules/catastrophic.yaml`), no API, <10ms.
+2. **Debounced partial analysis** — ~300ms after you pause typing (`/analyze-partial`).
+3. **Full analysis** — rules → exact-match cache → AI + context agents when risk is unclear.
+
+### Install from source
+
+```bash
+git clone https://github.com/sayan-does/shellmate.git
+cd shellmate
+pip install -e ".[dev]"
+python -m build
+```
+
+### Annotation badges
+
+| Kind | Examples |
+|------|----------|
+| Risk | `[OK]` `[i]` `[!]` `[!!]` `[X]` |
+| Environment | `[PROD]` `[STAGE]` `[DEV]` `[CI]` |
+| Time | `BH` (business hours) · `AH` (after hours) |
+| Chain / consequence | `[BROKEN]` `[ESCALATION]` `[IRREVERSIBLE]` |
+
+### Bracket syntax (typed inline; adapters strip and honor them)
+
+| Syntax | Purpose | Example |
+|--------|---------|---------|
+| `[?…]` | Ask a question about the command | `docker rm $(docker ps -aq) [?why dangerous]` |
+| `[!…]` | Directive to the analyzer | `rm -rf /tmp [!force]` |
+| `[@key=value]` | Override context | `git reset --hard [@env=production]` |
+
+### Full CLI
+
+| Command | Description |
+|---------|-------------|
+| `sm install` | Install shell hooks (bash/zsh → ble adapter, PowerShell → PS adapter) |
+| `sm uninstall` | Remove shell hooks (keeps config) |
+| `sm config` | Configure API keys and settings |
+| `sm enable` | Start daemon (autocomplete mode) |
+| `sm disable` | Stop daemon and clean session |
+| `sm status` | Daemon, agents, providers, credentials |
+| `sm --help` / `sm --version` | Help / version |
+| `sm --no-color <cmd>` | Plain-text output |
+
+```bash
+sm install --dry-run             # preview changes without touching files
+sm config --show                 # masked credentials
+sm config provider risk_analysis xai grok-3-mini   # set a provider role
+sm config cache.max_entries 200  # YAML override (dotted key)
+```
+
+Exit codes: `0` success · `2` usage error · `3` temporary error · `4` internal error.
+
+### Analysis pipeline
+
+Defined in `shellmate/orchestration/analysis_graph.py` (LangGraph `StateGraph`):
+
+```mermaid
+flowchart TD
+    START([start]) --> sanitize --> parse --> command_chain --> rules --> cache
+    cache -->|early exit| format
+    cache -->|needs AI| supervisor
+    supervisor -->|gather context| context_worker
+    supervisor -->|env only| env_context
+    context_worker --> risk_analyzer
+    env_context --> risk_analyzer
+    risk_analyzer --> consequence_builder --> remediation --> command_guide --> format
+    format --> query
+    query --> END([end])
+```
+
+**Early exits** (skip AI): sanitizer correction, high-confidence rule match, cache hit.
+
+### Daemon agents (started by `sm enable`)
+
+| Agent | Purpose |
+|-------|---------|
+| Watcher | OS, shell, git, tech-stack snapshot |
+| Librarian | Project file index + search |
+| Environment | Environment / staging signals |
+| CommandChain | Chain-pattern analysis |
+| Query | Answers `[?…]` queries |
+
+### Providers
+
+| Stage | Default | Fallback |
+|-------|---------|----------|
+| Supervisor / risk / guide | Groq | Grok (xAI) / heuristic |
+| Remediation | OpenRouter | Grok (xAI) / Groq guide / generic text |
+
+Configure **at least one** of Groq, OpenRouter, or Grok (xAI). Instant catastrophic
+gating always uses local rules, with or without a key.
+
+### Where things live
+
+| Purpose | Linux / macOS | Windows |
+|---------|---------------|---------|
+| Config + `.env` | `~/.config/shellmate` | `%APPDATA%\ShellMate` |
+| State / sessions / logs | `~/.local/state/shellmate` | `%LOCALAPPDATA%\ShellMate` |
+| Cache | `~/.cache/shellmate` | `%LOCALAPPDATA%\ShellMate\cache` |
+| Installed adapters | `~/.shellmate/adapters/` | `%USERPROFILE%\.shellmate\adapters\` |
+
+### Environment variables
+
+| Variable | Required | Purpose |
+|----------|----------|---------|
+| `GROQ_API_KEY` | one of the three | Risk analysis, supervisor, command guide |
+| `OPENROUTER_API_KEY` | one of the three | Remediation alternatives |
+| `XAI_API_KEY` | one of the three | Risk + remediation via Grok |
+| `CONTEXT7_API_KEY` | no | Optional docs lookup |
+| `GROQ_SUPERVISOR_MODEL` | no | Override supervisor model (default `qwen/qwen3.8-27b`) |
+| `XAI_MODEL` | no | Override Grok model (default `grok-3-mini`) |
+
+Optional YAML overrides live in `<config_dir>/config.yaml`.
+
+### Dependencies (authoritative: `pyproject.toml`)
+
+`click`, `rich`, `pyyaml` (CLI/UI) · `langgraph`, `langchain-core` (orchestration) ·
+`groq`, `openai`, `aiohttp` (providers) · `psutil`, `watchdog` (runtime) · `numpy`.
+
+CI builds and smoke-tests the wheel on Python 3.10–3.12. Publishing runs on `v*` tags
+via Trusted Publishing (`.github/workflows/publish.yml`).
+
+</details>
+
+---
+
+Made to make the terminal a little less scary. **MIT licensed** — contributions welcome at
+[github.com/sayan-does/shellmate](https://github.com/sayan-does/shellmate).

{shellmate_cli-3.0.0.dist-info → shellmate_cli-3.0.2.dist-info}/RECORD

@@ -1,9 +1,9 @@
 shellmate/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 shellmate/adapters/__init__.py,sha256=4gnk5hxRGFfKS9NM0oHVFPczZe7wK-4pu7pVHDlhqWc,2292
 shellmate/adapters/bash_adapter.sh,sha256=8n7DeBS_vy1_dwTmulY3wvsqhUEMYNy8Huz4gUh771M,312
-shellmate/adapters/ble_adapter.sh,sha256=tBgsJmVDbFfIKtxwB8bx32W0lh1ybWEPxySTr09TLjk,11268
-shellmate/adapters/powershell_adapter.ps1,sha256=4ngc0fFWfa46b5sOB5CPYzX5iPmMoAiect5KtPPmkzE,15782
-shellmate/adapters/powershell_predictor.ps1,sha256=W3NAsqYI0gOQ-qyMAgplfgTz0VxpsWBf4MTNTHh1zWU,4136
+shellmate/adapters/ble_adapter.sh,sha256=yAVdAYOV3e7HNiqXtmRCg3nJCt2TkrrHsddPAQY3eDo,11539
+shellmate/adapters/powershell_adapter.ps1,sha256=XfLWswjYOFbSY86rXHKtWLFIn1NM8cTiMxEIbZVWJ9U,16084
+shellmate/adapters/powershell_predictor.ps1,sha256=C52Ds-2seMGd_jWjazOaaoHO6YdhnH3Qk1OzTVKPDHI,4362
 shellmate/adapters/zsh_adapter.zsh,sha256=NBqP4d0JxkjlyAbRt95JqNe99o3YSHcT18R_nX2qeVg,342
 shellmate/agents/__init__.py,sha256=L1p1AT5XqnijplQv23G4OrzyAGlGTGfVX4StsNj_6Cc,515
 shellmate/agents/base.py,sha256=vfwvln6P2_qk054udxf0jGE921mMOxZJh0OjBYCH4JA,8140
@@ -20,7 +20,7 @@ shellmate/cache/semantic_cache.py,sha256=d9Je0gRFW1ASau8xemGBbbJfxk08C3QkIl_HtCI
 shellmate/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 shellmate/cli/main.py,sha256=_gljAQLkDgYgukkyYNVjjow7d-FIOtWbFufnFhsNr7A,3815
 shellmate/cli/parser.py,sha256=Lh3mo6aHwn6ISmXoFKMfROF--tSe7Rpig_3rpjTGgi0,5747
-shellmate/cli/version.py,sha256=qckxTKowVHHdLYuDeVRWcIaYVKeKZEw0YwwUIm6QtNY,18
+shellmate/cli/version.py,sha256=obmd3VOGkno3g89HIX3XZWI2xsdprkRqSyf-ntBilNg,18
 shellmate/cli/commands/__init__.py,sha256=MFJrPc6Yrhe6eFxTAJI8dnOnqUdILoh3JnBRCevVOwU,1032
 shellmate/cli/commands/analyze.py,sha256=t5BxxGBrPizJvgsbrvOpsF327DxgunoN7QefaBXIc3k,270
 shellmate/cli/commands/config.py,sha256=DI22jVKEwaFLqQIA3ps-ZFRz6lNML_DYBWBtyh70ISA,10168
@@ -84,8 +84,9 @@ shellmate/sanitizer/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSu
 shellmate/sanitizer/typo_detector.py,sha256=ZBhOzB7ZSv4hctbu60tu_iBMjcBIP4TLjQ20aoCLVVQ,2957
 shellmate/ui/__init__.py,sha256=i8MvY7xFXCg9WRXFJcny3iiNBUnHoNW8U82t4tjqSrs,252
 shellmate/ui/analysis.py,sha256=U5WrGXSrBfR2Q_xOZ_nxi6frouTU6CrmHu-t7afLpmc,5905
-shellmate/ui/annotations.py,sha256=ztf3PlPcCeainX4Hi7qQW30pJ9T1zY5aaxC6IlyHwoI,6914
+shellmate/ui/annotations.py,sha256=1qp2zhD6bmRKG2TtSVvS7KaG5U0ZZ9TMOLvWYoCwAy8,7525
 shellmate/ui/banner.py,sha256=gOT8hYnO6pRqPW_tWx5KPInw9TOcByLthdmKz8uneaI,1752
+shellmate/ui/colors.py,sha256=1qzvODW1rpAlkH_02HgCbh5WY_hGOycJsMQydeQXzx4,3576
 shellmate/ui/progress.py,sha256=5rLtBR4VM9CUs7phTz6VJqVSIou0hGTk9YDRE-E0nvc,4020
 shellmate/ui/status.py,sha256=EmsWCd5R_h-rQ9nApBBUFPhhZurfKoXY3_te4h7LIJo,134
 shellmate/ui/runtime/__init__.py,sha256=G2tRJWagzRJSUYRVmyb0cBVxPr5XKwoXibVmSdXkA4Y,448
@@ -98,9 +99,9 @@ shellmate/ui/scenes/enable.py,sha256=wrKSyGg_aSU3anvCAMPQOBq9E13KDCtQT3GRDbCSalA
 shellmate/ui/scenes/help.py,sha256=ozg_JosfzpA4cNCSWHazETiRuU9gPO_-Y04arYmgUUU,1904
 shellmate/ui/scenes/stages.py,sha256=pK396uMatWxJm_XbWCJTWsvx7W6Sx0s7G95S3ec1ffQ,4048
 shellmate/ui/scenes/status.py,sha256=nC-wAC8cdE3UC2QXeK9zD8fOAMpdLogHK67h74a9Nek,6427
-shellmate_cli-3.0.0.dist-info/licenses/LICENSE,sha256=_eDrSi0nYhgVjipoIJoiUEdbARagURo6nVbTGBzqvD4,1079
-shellmate_cli-3.0.0.dist-info/METADATA,sha256=MjD_jybwTY6cc6eqjxQAgk-x0Qp4Ocdi0QiK-D72pDg,12187
-shellmate_cli-3.0.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
-shellmate_cli-3.0.0.dist-info/entry_points.txt,sha256=lBMog9g17_P4iSXr6Akfg_QTVzswLWXUeGnuq66Wwhw,83
-shellmate_cli-3.0.0.dist-info/top_level.txt,sha256=0htuoy1ZSdVSt_0l2mO-mPPvSp2veo6dbr3h0K_AmIw,10
-shellmate_cli-3.0.0.dist-info/RECORD,,
+shellmate_cli-3.0.2.dist-info/licenses/LICENSE,sha256=_eDrSi0nYhgVjipoIJoiUEdbARagURo6nVbTGBzqvD4,1079
+shellmate_cli-3.0.2.dist-info/METADATA,sha256=AXJSeTRRhxe3wCX6cqNS5uc7fJAQl8PKi5Pr86w9BRA,11788
+shellmate_cli-3.0.2.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+shellmate_cli-3.0.2.dist-info/entry_points.txt,sha256=lBMog9g17_P4iSXr6Akfg_QTVzswLWXUeGnuq66Wwhw,83
+shellmate_cli-3.0.2.dist-info/top_level.txt,sha256=0htuoy1ZSdVSt_0l2mO-mPPvSp2veo6dbr3h0K_AmIw,10
+shellmate_cli-3.0.2.dist-info/RECORD,,

shellmate_cli-3.0.0.dist-info/METADATA

@@ -1,352 +0,0 @@
-Metadata-Version: 2.4
-Name: shellmate-cli
-Version: 3.0.0
-Summary: Intelligent shell autocomplete with consequence preview
-Author: ShellMate Contributors
-License: MIT
-Project-URL: Homepage, https://github.com/sayan-does/shellmate
-Project-URL: Repository, https://github.com/sayan-does/shellmate
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Environment :: Console
-Classifier: Topic :: Utilities
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: click>=8.0
-Requires-Dist: pyyaml>=6.0
-Requires-Dist: aiohttp>=3.9.0
-Requires-Dist: groq>=0.4.0
-Requires-Dist: openai>=1.0.0
-Requires-Dist: numpy>=1.24.0
-Requires-Dist: langgraph>=1.2.0
-Requires-Dist: langchain-core>=1.4.0
-Requires-Dist: rich>=13.0.0
-Requires-Dist: psutil>=5.9.0
-Requires-Dist: watchdog>=4.0.0
-Provides-Extra: dev
-Requires-Dist: build; extra == "dev"
-Requires-Dist: twine; extra == "dev"
-Requires-Dist: pytest; extra == "dev"
-Requires-Dist: pytest-asyncio; extra == "dev"
-Provides-Extra: windows-test
-Requires-Dist: pywinpty>=2.0.0; sys_platform == "win32" and extra == "windows-test"
-Requires-Dist: pyte>=0.8.1; extra == "windows-test"
-Dynamic: license-file
-
-# ShellMate
-
-Intelligent shell autocomplete with consequence preview.
-
-**Version:** 3.0.0  
-**Package:** [`shellmate-cli`](https://pypi.org/project/shellmate-cli/)  
-**License:** MIT  
-**Python:** 3.10+
-
-ShellMate watches what you type and shows **inline risk annotations** before you press Enter. A background daemon analyzes commands with deterministic rules, an exact-match cache, and a LangGraph pipeline that pulls project context plus Groq / OpenRouter / Grok (xAI) for AI risk and remediation.
-
-## How it works
-
-```
-You type in the shell
-    → ble.sh (Linux/WSL) or PSReadLine (Windows) adapter
-    → IPC to daemon (TCP 127.0.0.1:9823)
-    → LangGraph analysis pipeline
-    → Inline annotation / confirmation gate
-```
-
-1. **Instant catastrophic check** — local YAML rules (`rules/catastrophic.yaml`), no API.
-2. **Debounced partial analysis** — after a short pause while typing.
-3. **Full analysis** — rules → cache → AI + context agents when risk is unclear.
-
-## Installation
-
-### From PyPI
-
-```bash
-pip install shellmate-cli
-```
-
-### From source
-
-```bash
-git clone https://github.com/sayan-does/shellmate.git
-cd shellmate
-pip install -e .
-```
-
-## Quick start
-
-### 1. Prerequisites
-
-| Platform | Required |
-|----------|----------|
-| Linux / WSL | [ble.sh](https://github.com/akinomyoga/ble.sh) (e.g. under `~/.local/share/blesh/ble.sh`) |
-| Windows | PowerShell with PSReadLine |
-| All | At least one of `GROQ_API_KEY`, `OPENROUTER_API_KEY`, or `XAI_API_KEY` |
-
-### 2. Install hooks and configure keys
-
-```bash
-sm install          # copy adapter → ~/.shellmate/adapters/ and append RC/profile hook
-sm config           # select provider (Groq / OpenRouter / Grok xAI), paste API key
-```
-
-Dry-run without changing files:
-
-```bash
-sm install --dry-run
-```
-
-### 3. Start the daemon
-
-```bash
-sm enable
-```
-
-Starts the daemon for the current directory (Watcher, Librarian, and other agents). Check with `sm status`.
-
-### 4. Type normally
-
-Inline annotations appear under the line as you type. Catastrophic commands require a second Enter to confirm.
-
-### 5. Stop / remove
-
-```bash
-sm disable          # stop daemon
-sm uninstall        # remove shell hooks (keeps config)
-```
-
-## Autocomplete features
-
-ShellMate’s main UX is **in-shell autocomplete annotations** (not a separate `sm -a` command). Adapters hook ble.sh or PSReadLine and talk to the daemon over IPC.
-
-### Two-phase typing feedback
-
-| Phase | Latency | What happens |
-|-------|---------|--------------|
-| **1 — Instant** | <10ms, no API | `/instant-check` against `rules/catastrophic.yaml`. Blocking commands get an immediate annotation. |
-| **2 — Debounced** | ~300ms after you pause | `/analyze-partial` runs the analysis pipeline and **replaces** the annotation in place with risk + badges. |
-
-```bash
-$ git push --force
-[!] rewrites history [PROD] BH
-
-$ rm -rf /
-[!] BLOCKING - Type again to confirm
-```
-
-### Consequence preview (Tab × 2)
-
-1. **First Tab** — completion / ghost-text suggestion  
-2. **Second Tab** — accept suggestion and show a **consequence preview** below the prompt:
-
-```text
-  → Force-pushes and rewrites remote history
-  → Reversible: No  |  remote: origin/main
-  → Safe alt: git push --force-with-lease
-```
-
-On HIGH / CRITICAL / blocking severity, Enter is gated until you confirm again.
-
-| Platform | Completion surface |
-|----------|-------------------|
-| Linux / WSL (ble.sh) | Tab bound to ShellMate complete widget |
-| PowerShell 7.2+ | PSReadLine predictor (`powershell_predictor.ps1`) when available |
-| PowerShell 5.1 | Tab handler ghost-text fallback |
-
-### Double-Enter confirmation
-
-Dangerous commands do not run on the first Enter:
-
-1. First Enter → blocked; annotation asks you to confirm  
-2. Second Enter (same command) → allowed  
-
-Applies to catastrophic instant matches and to HIGH/CRITICAL consequence previews.
-
-### Annotation badges
-
-Short inline text under the command (ASCII-safe on all platforms):
-
-| Kind | Examples |
-|------|----------|
-| Risk | `[OK]` `[i]` `[!]` `[!!]` `[X]` |
-| Environment | `[PROD]` `[STAGE]` `[DEV]` `[CI]` |
-| Time | `BH` (business hours) · `AH` (after hours) |
-| Chain / consequence | `[BROKEN]` `[ESCALATION]` `[IRREVERSIBLE]` |
-
-### Bracket syntax
-
-Typed as part of the command line; adapters/daemon strip and honor them:
-
-| Syntax | Purpose | Example |
-|--------|---------|---------|
-| `[?…]` | Ask a question about the command | `docker rm $(docker ps -aq) [?why dangerous]` |
-| `[!…]` | Directive to the analyzer | `rm -rf /tmp [!force]` |
-| `[@key=value]` | Override context (e.g. environment) | `git reset --hard [@env=production]` |
-
-### Surfaces
-
-| Adapter | Shell | Role |
-|---------|-------|------|
-| `ble_adapter.sh` | bash/zsh + ble.sh | Primary Linux/WSL autocomplete |
-| `powershell_adapter.ps1` | PowerShell + PSReadLine | Primary Windows autocomplete |
-| `powershell_predictor.ps1` | PowerShell 7.2+ | Optional ghost-text predictor |
-| `bash_adapter.sh` / `zsh_adapter.zsh` | — | Deprecated stubs |
-
-Requires at least one of `GROQ_API_KEY`, `OPENROUTER_API_KEY`, or `XAI_API_KEY` for AI annotations and consequence previews. Instant catastrophic checks still use local rules.
-
-## CLI
-
-| Command | Description |
-|---------|-------------|
-| `sm install` | Install shell hooks (bash/zsh → ble adapter, PowerShell → PS adapter) |
-| `sm uninstall` | Remove shell hooks |
-| `sm config` | Configure API keys and settings |
-| `sm enable` | Start daemon (autocomplete mode) |
-| `sm disable` | Stop daemon and clean session |
-| `sm status` | Daemon, agents, providers, credentials |
-| `sm --help` | Help |
-| `sm --version` | Version |
-| `sm --no-color <cmd>` | Plain text output |
-
-### `sm config` usages
-
-```bash
-sm config                        # validate existing keys; select provider → paste key
-sm config --show                 # masked credentials
-sm config provider risk_analysis xai grok-3-mini   # set provider role
-sm config cache.max_entries 200  # YAML override (dotted key)
-```
-
-Interactive setup asks you to pick Groq, OpenRouter, or Grok (xAI), then paste the key. Existing keys are checked against the provider API.
-### Exit codes
-
-| Code | Meaning |
-|------|---------|
-| 0 | Success |
-| 2 | Usage error |
-| 3 | Temporary error (e.g. interrupt) |
-| 4 | Internal error |
-
-## Shell adapters
-
-See [Autocomplete features](#autocomplete-features) for behavior. `sm install` copies the ble or PowerShell adapter into `~/.shellmate/adapters/` and appends a source line to your RC / profile.
-
-## Architecture
-
-### Analysis pipeline
-
-Defined in `shellmate/orchestration/analysis_graph.py` (LangGraph `StateGraph`):
-
-```mermaid
-flowchart TD
-    START([start]) --> sanitize --> parse --> command_chain --> rules --> cache
-    cache -->|early exit| format
-    cache -->|needs AI| supervisor
-    supervisor -->|gather context| context_worker
-    supervisor -->|env only| env_context
-    context_worker --> risk_analyzer
-    env_context --> risk_analyzer
-    risk_analyzer --> consequence_builder --> remediation --> command_guide --> format
-    format --> query
-    query --> END([end])
-```
-
-| Node | Role |
-|------|------|
-| `sanitize` / `parse` | Typo / syntax checks; tokenize |
-| `command_chain` | Multi-step / chain pattern detection |
-| `rules` | YAML rules under `shellmate/rules/definitions/` |
-| `cache` | Exact-match in-memory cache (no FAISS) |
-| `supervisor` | Groq (or heuristic) decides context needs |
-| `context_worker` / `env_context` | Parallel agent queries or env-only path |
-| `risk_analyzer` | Groq risk assessment |
-| `consequence_builder` | Structured consequence preview |
-| `remediation` | OpenRouter safer alternatives |
-| `command_guide` | Groq “what you meant” guide |
-| `format` / `query` | Final payload; optional `[?…]` query handling |
-
-**Early exits** (skip AI): sanitizer correction, high-confidence rule match, cache hit.
-
-### Agents (daemon)
-
-Started with `sm enable`:
-
-| Agent | Purpose |
-|-------|---------|
-| Watcher | OS, shell, git, tech-stack snapshot |
-| Librarian | Project file index + search |
-| Environment | Environment / staging signals |
-| CommandChain | Chain-pattern analysis |
-| Query | Answers `[?…]` queries |
-
-Repomix-style pack search runs alongside Librarian in the context worker when needed.
-
-### Providers
-
-| Stage | Default | Fallback |
-|-------|---------|----------|
-| Supervisor / risk / guide | Groq | Grok (xAI) / heuristic |
-| Remediation | OpenRouter | Grok (xAI) / Groq guide / generic text |
-
-Configure **at least one** of Groq, OpenRouter, or Grok (xAI). Groq covers risk analysis, supervisor routing, and command guide; OpenRouter covers remediation; xAI can cover both risk and remediation. Instant catastrophic gating still uses local rules either way.
-## Configuration
-
-### Directories
-
-| Purpose | Linux / macOS | Windows |
-|---------|---------------|---------|
-| Config + `.env` | `~/.config/shellmate` | `%APPDATA%\ShellMate` |
-| State / sessions / logs | `~/.local/state/shellmate` | `%LOCALAPPDATA%\ShellMate` |
-| Cache dir | `~/.cache/shellmate` | `%LOCALAPPDATA%\ShellMate\cache` |
-| Installed adapters | `~/.shellmate/adapters/` | `%USERPROFILE%\.shellmate\adapters\` |
-
-Credentials file: `<config_dir>/.env` (permissions restricted on Unix).
-
-### Environment variables
-
-| Variable | Required | Purpose |
-|----------|----------|---------|
-| `GROQ_API_KEY` | At least one of Groq / OpenRouter / xAI | Risk analysis, supervisor, command guide |
-| `OPENROUTER_API_KEY` | At least one of Groq / OpenRouter / xAI | Remediation alternatives |
-| `XAI_API_KEY` | At least one of Groq / OpenRouter / xAI | Risk analysis and remediation via Grok |
-| `CONTEXT7_API_KEY` | No | Optional docs lookup |
-| `GROQ_SUPERVISOR_MODEL` | No | Override supervisor model (default `qwen/qwen3.8-27b`) |
-| `XAI_MODEL` | No | Override Grok model (default `grok-3-mini`) |
-
-Optional YAML overrides live in `<config_dir>/config.yaml`.
-
-## Requirements
-
-- Python 3.10+
-- ble.sh (Linux/WSL) or PowerShell + PSReadLine (Windows)
-- At least one of `GROQ_API_KEY`, `OPENROUTER_API_KEY`, or `XAI_API_KEY` (Groq + OpenRouter recommended for full risk + remediation)
-
-### Dependencies (authoritative: `pyproject.toml`)
-
-- `click`, `rich`, `pyyaml` — CLI / UI
-- `langgraph`, `langchain-core` — orchestration
-- `groq`, `openai`, `aiohttp` — providers
-- `psutil`, `watchdog` — runtime monitoring
-- `numpy` — declared runtime dependency
-
-## Development
-
-```bash
-git clone https://github.com/sayan-does/shellmate.git
-cd shellmate
-pip install -e ".[dev]"
-python -m build
-```
-
-CI builds and smoke-tests the wheel on Python 3.10–3.12. Publishing runs on `v*` tags via Trusted Publishing (`.github/workflows/publish.yml`).
-
-## License
-
-MIT