grace-context-manager 4.0.0__tar.gz

grace_context_manager-4.0.0/PKG-INFO

@@ -0,0 +1,170 @@
+Metadata-Version: 2.4
+Name: grace-context-manager
+Version: 4.0.0
+Summary: GRACE Context Manager — Assemble high-quality context for LLM coding assistants
+Author: GRACE Contributors
+License: MIT
+Project-URL: Homepage, https://github.com/VanUST/GRACE
+Project-URL: Source, https://github.com/VanUST/GRACE
+Project-URL: Tracker, https://github.com/VanUST/GRACE/issues
+Keywords: llm,context,prompt,ai,coding,assistant
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: X11 Applications :: Qt
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: PyQt6>=6.5.0
+Provides-Extra: test
+Requires-Dist: pytest>=7.0; extra == "test"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: twine>=4.0; extra == "dev"
+
+# GRACE Context Manager
+
+A modern GUI tool for assembling high-quality context for LLM coding assistants. Built with PyQt6.
+
+## Key Features
+
+- **Context Blocks**: Reusable text snippets organized by category (tech stack, constraints, rules). Toggle on/off as needed.
+- **Smart File Selection**: Tree view with checkboxes, file size display, and quick select/deselect.
+- **Advanced Filtering**: Filter by extension (typed manually or by checkboxes with two-way binding), keyword filename filter, and built-in ignore rules (dot-files, `node_modules`, `__pycache__`, `venv`).
+- **Dynamic Extension Detection**: Auto-detect all file extensions in your project with select/deselect all for quick filtering.
+- **Typed Extension Filter**: Extensions can be typed directly as comma-separated values (`.py, .json, .yaml`) or selected via checkboxes — both stay in sync.
+- **Extension Presets**: Save frequently used extension combinations (e.g., `python_ml`, `web_dev`) and reload them across sessions.
+- **Live Preview**: See assembled context with token count estimation before copying.
+- **Preview Modes**: Full context, structure only, or files only.
+- **Dynamic Context Refresh**: Refresh selected file contents when files change on disk without re-selecting.
+- **Scalable UI**: Adjustable interface scaling (75%-200%) for different screen sizes and devices.
+- **Manual Directory Entry**: Type the project root path directly or use Browse/Recent selectors.
+- **Keyboard Shortcuts**: Ctrl+C copy, Ctrl+N new block, Ctrl+R refresh, Ctrl+O browse, Ctrl+A/D select all/none.
+
+## Quick Install
+
+```bash
+pip install grace-context-manager
+```
+
+Then run:
+
+```bash
+grace
+```
+
+### Upgrading
+
+```bash
+pip install --upgrade grace-context-manager
+```
+
+**Your data is safe.** All settings, context blocks, extension presets, and recent projects are stored in `~/.grace_manager/` — they persist across upgrades and are never overwritten.
+
+### One-Click Installers (no Python required)
+
+For users without Python, download and run the platform installer which bundles everything:
+
+| Platform | Installer |
+|----------|-----------|
+| Windows  | **[install.bat](install.bat)** (right-click → "Run") |
+| Linux / macOS | `./install.sh` |
+
+### Manual Install (from source)
+
+```bash
+git clone https://github.com/vibechat/grace-context-manager.git
+cd grace-context-manager
+pip install -e .
+```
+
+## Workflow
+
+1. **Select Project**: Click **Browse** to choose your project directory, select from **Recent**, or type the path directly.
+2. **Add Context Blocks**: Create reusable blocks for tech stack, coding rules, etc.
+3. **Filter Extensions**: Click **Detect** to auto-discover all file extensions, then:
+   - Click checkboxes to toggle individual extensions
+   - Type extensions directly in the text field (`.py, .json, .yaml`)
+   - Use **All**/**None** for quick toggle
+   - Save/Load **presets** for reuse across projects
+4. **Keyword Filter**: Set a keyword to only show files matching that keyword in their filename.
+5. **Select Files**: Check files/directories to include in context.
+6. **Add Instruction**: Write your task in the instruction box.
+7. **Refresh**: Click **Refresh Context** to reload changed files from disk.
+8. **Copy**: Click **Copy Context** and paste into your LLM.
+
+## Extension Presets
+
+Save and load extension filter combinations:
+
+1. Select your desired extensions (via checkboxes or typing)
+2. Click **Save** to store as a named preset (e.g., `python_ml`)
+3. Click **Load▾** to apply a previously saved preset
+4. Presets persist globally in `~/.grace_manager/extension_presets.json`
+
+Built-in defaults: `python_ml`, `web_dev`, `data_science`, `rust`, `golang`, `python`, `all`.
+
+## Keyboard Shortcuts
+
+| Shortcut | Action |
+|----------|--------|
+| `Ctrl+C` | Copy context to clipboard |
+| `Ctrl+N` | New context block |
+| `Ctrl+R` | Refresh context |
+| `Ctrl+O` | Browse directory |
+| `Ctrl+A` | Select all files |
+| `Ctrl+D` | Deselect all files |
+
+## Running Tests
+
+```bash
+# Install test dependencies
+pip install -e ".[test]"
+
+# Run all tests
+pytest tests/ -v
+
+# Run specific test file
+pytest tests/test_engine.py -v
+pytest tests/test_tree_model.py -v
+pytest tests/test_config.py -v
+
+# Quick smoke test (no pytest required)
+python -m pytest tests/
+```
+
+Tests run headless (virtual display) and cover:
+- **Engine**: Token estimation, file scanning with extension/keyword filters, context assembly across all modes
+- **Tree model**: Check/uncheck propagation, partial uncheck (Bug 1+2 fix), eager loading, extension & keyword filters, nested directory handling, dot-file exclusion
+- **Config**: Built-in constants, ignore rules, extension presets
+
+## Context Blocks
+
+Context blocks are saved in `~/.grace_manager/profiles.json`. They persist across sessions.
+
+Organize blocks by category:
+- `tech` - Technology stack info
+- `constraints` - Coding rules and constraints
+- `context` - Project-specific context
+- Any custom category
+
+## UI Scaling
+
+Use the scale buttons in the sidebar to adjust the UI. Scaling preference is saved in `~/.grace_manager/settings.json` and persists across sessions.
+
+## Configuration Files
+
+| File | Purpose |
+|------|---------|
+| `~/.grace_manager/profiles.json` | Context blocks |
+| `~/.grace_manager/recent_projects.json` | Recently opened projects |
+| `~/.grace_manager/settings.json` | UI preferences (scaling, etc.) |
+| `~/.grace_manager/extension_presets.json` | Saved extension presets |

grace_context_manager-4.0.0/README.md

@@ -0,0 +1,138 @@
+# GRACE Context Manager
+
+A modern GUI tool for assembling high-quality context for LLM coding assistants. Built with PyQt6.
+
+## Key Features
+
+- **Context Blocks**: Reusable text snippets organized by category (tech stack, constraints, rules). Toggle on/off as needed.
+- **Smart File Selection**: Tree view with checkboxes, file size display, and quick select/deselect.
+- **Advanced Filtering**: Filter by extension (typed manually or by checkboxes with two-way binding), keyword filename filter, and built-in ignore rules (dot-files, `node_modules`, `__pycache__`, `venv`).
+- **Dynamic Extension Detection**: Auto-detect all file extensions in your project with select/deselect all for quick filtering.
+- **Typed Extension Filter**: Extensions can be typed directly as comma-separated values (`.py, .json, .yaml`) or selected via checkboxes — both stay in sync.
+- **Extension Presets**: Save frequently used extension combinations (e.g., `python_ml`, `web_dev`) and reload them across sessions.
+- **Live Preview**: See assembled context with token count estimation before copying.
+- **Preview Modes**: Full context, structure only, or files only.
+- **Dynamic Context Refresh**: Refresh selected file contents when files change on disk without re-selecting.
+- **Scalable UI**: Adjustable interface scaling (75%-200%) for different screen sizes and devices.
+- **Manual Directory Entry**: Type the project root path directly or use Browse/Recent selectors.
+- **Keyboard Shortcuts**: Ctrl+C copy, Ctrl+N new block, Ctrl+R refresh, Ctrl+O browse, Ctrl+A/D select all/none.
+
+## Quick Install
+
+```bash
+pip install grace-context-manager
+```
+
+Then run:
+
+```bash
+grace
+```
+
+### Upgrading
+
+```bash
+pip install --upgrade grace-context-manager
+```
+
+**Your data is safe.** All settings, context blocks, extension presets, and recent projects are stored in `~/.grace_manager/` — they persist across upgrades and are never overwritten.
+
+### One-Click Installers (no Python required)
+
+For users without Python, download and run the platform installer which bundles everything:
+
+| Platform | Installer |
+|----------|-----------|
+| Windows  | **[install.bat](install.bat)** (right-click → "Run") |
+| Linux / macOS | `./install.sh` |
+
+### Manual Install (from source)
+
+```bash
+git clone https://github.com/vibechat/grace-context-manager.git
+cd grace-context-manager
+pip install -e .
+```
+
+## Workflow
+
+1. **Select Project**: Click **Browse** to choose your project directory, select from **Recent**, or type the path directly.
+2. **Add Context Blocks**: Create reusable blocks for tech stack, coding rules, etc.
+3. **Filter Extensions**: Click **Detect** to auto-discover all file extensions, then:
+   - Click checkboxes to toggle individual extensions
+   - Type extensions directly in the text field (`.py, .json, .yaml`)
+   - Use **All**/**None** for quick toggle
+   - Save/Load **presets** for reuse across projects
+4. **Keyword Filter**: Set a keyword to only show files matching that keyword in their filename.
+5. **Select Files**: Check files/directories to include in context.
+6. **Add Instruction**: Write your task in the instruction box.
+7. **Refresh**: Click **Refresh Context** to reload changed files from disk.
+8. **Copy**: Click **Copy Context** and paste into your LLM.
+
+## Extension Presets
+
+Save and load extension filter combinations:
+
+1. Select your desired extensions (via checkboxes or typing)
+2. Click **Save** to store as a named preset (e.g., `python_ml`)
+3. Click **Load▾** to apply a previously saved preset
+4. Presets persist globally in `~/.grace_manager/extension_presets.json`
+
+Built-in defaults: `python_ml`, `web_dev`, `data_science`, `rust`, `golang`, `python`, `all`.
+
+## Keyboard Shortcuts
+
+| Shortcut | Action |
+|----------|--------|
+| `Ctrl+C` | Copy context to clipboard |
+| `Ctrl+N` | New context block |
+| `Ctrl+R` | Refresh context |
+| `Ctrl+O` | Browse directory |
+| `Ctrl+A` | Select all files |
+| `Ctrl+D` | Deselect all files |
+
+## Running Tests
+
+```bash
+# Install test dependencies
+pip install -e ".[test]"
+
+# Run all tests
+pytest tests/ -v
+
+# Run specific test file
+pytest tests/test_engine.py -v
+pytest tests/test_tree_model.py -v
+pytest tests/test_config.py -v
+
+# Quick smoke test (no pytest required)
+python -m pytest tests/
+```
+
+Tests run headless (virtual display) and cover:
+- **Engine**: Token estimation, file scanning with extension/keyword filters, context assembly across all modes
+- **Tree model**: Check/uncheck propagation, partial uncheck (Bug 1+2 fix), eager loading, extension & keyword filters, nested directory handling, dot-file exclusion
+- **Config**: Built-in constants, ignore rules, extension presets
+
+## Context Blocks
+
+Context blocks are saved in `~/.grace_manager/profiles.json`. They persist across sessions.
+
+Organize blocks by category:
+- `tech` - Technology stack info
+- `constraints` - Coding rules and constraints
+- `context` - Project-specific context
+- Any custom category
+
+## UI Scaling
+
+Use the scale buttons in the sidebar to adjust the UI. Scaling preference is saved in `~/.grace_manager/settings.json` and persists across sessions.
+
+## Configuration Files
+
+| File | Purpose |
+|------|---------|
+| `~/.grace_manager/profiles.json` | Context blocks |
+| `~/.grace_manager/recent_projects.json` | Recently opened projects |
+| `~/.grace_manager/settings.json` | UI preferences (scaling, etc.) |
+| `~/.grace_manager/extension_presets.json` | Saved extension presets |

grace_context_manager-4.0.0/grace_app/__init__.py

@@ -0,0 +1,3 @@
+"GRACE Context Manager - Smart context assembly for LLM workflows."
+
+__version__ = "4.0.0"

grace_context_manager-4.0.0/grace_app/config.py

@@ -0,0 +1,40 @@
+from pathlib import Path
+
+CONFIG_DIR = Path.home() / ".grace_manager"
+PROFILES_FILE = CONFIG_DIR / "profiles.json"
+RECENT_FILE = CONFIG_DIR / "recent_projects.json"
+SETTINGS_FILE = CONFIG_DIR / "settings.json"
+EXTENSION_PRESETS_FILE = CONFIG_DIR / "extension_presets.json"
+
+DEFAULT_EXTENSIONS = ".py, .md, .txt, .json, .yaml, .toml, .cfg, .ini"
+
+BUILTIN_IGNORE_DIRS = {'__pycache__', 'venv', 'node_modules', 'egg-info'}
+BUILTIN_IGNORE_FILES = {'Thumbs.db'}
+
+SCALE_STEPS = [75, 90, 100, 110, 125, 150, 175, 200]
+
+MAX_FILE_SIZE = 1024 * 1024
+
+DEFAULT_EXTENSION_PRESETS = {
+    "python_ml": [".py", ".json", ".yaml", ".yml", ".toml", ".md", ".cfg"],
+    "web_dev": [".js", ".ts", ".jsx", ".tsx", ".json", ".html", ".css", ".scss", ".md"],
+    "data_science": [".py", ".ipynb", ".json", ".csv", ".sql", ".r", ".md"],
+    "rust": [".rs", ".toml", ".md", ".json"],
+    "golang": [".go", ".mod", ".sum", ".md", ".json", ".yaml"],
+    "python": [".py", ".md", ".txt", ".json", ".yaml", ".toml"],
+    "all": [],
+}
+
+EXT_ICONS = {
+    ".py": "\ue606", ".js": "JS", ".ts": "TS", ".jsx": "JS",
+    ".tsx": "TS", ".md": "MD", ".json": "{}", ".yaml": "Y",
+    ".yml": "Y", ".xml": "X", ".html": "H", ".css": "#",
+    ".toml": "T", ".cfg": "C", ".ini": "I", ".rs": "RS",
+    ".go": "Go", ".java": "Jv", ".c": "C", ".cpp": "C+",
+    ".h": "H", ".rb": "Rb", ".php": "P", ".sql": "SQ",
+    ".sh": "Sh", ".bash": "Sh", ".zsh": "Sh", ".fish": "Fi",
+    ".ps1": "PS", ".bat": "B", ".cmake": "CM", ".make": "Mk",
+    ".dockerfile": "D", ".kt": "Kt", ".swift": "Sw",
+    ".r": "R", ".m": "M", ".scala": "Sc", ".lua": "Lu",
+    ".vim": "Vi", ".tex": "Tx", ".gitignore": "Gi",
+}

grace_context_manager-4.0.0/grace_app/engine.py

@@ -0,0 +1,127 @@
+import os
+from pathlib import Path
+from typing import List, Set, Optional
+from .models import ContextBlock
+from .config import MAX_FILE_SIZE
+
+class TokenEstimator:
+    @staticmethod
+    def estimate(text: str) -> int:
+        return max(1, len(text) // 4)
+
+    @staticmethod
+    def format_count(count: int) -> str:
+        if count < 1000:
+            return f"{count} tokens"
+        return f"{count/1000:.1f}k tokens"
+
+class FileScanner:
+    @staticmethod
+    def scan_extensions(root_path: str, ignore_dirs: Set[str], max_exts: int = 60) -> List[str]:
+        extensions: Set[str] = set()
+        try:
+            for dirpath, dirnames, filenames in os.walk(root_path):
+                dirnames[:] = [d for d in dirnames if d not in ignore_dirs and not d.startswith('.')]
+                for fname in filenames:
+                    if fname.startswith('.'):
+                        continue
+                    ext = os.path.splitext(fname)[1].lower()
+                    if ext:
+                        extensions.add(ext)
+                    if len(extensions) > max_exts:
+                        break
+                if len(extensions) > max_exts:
+                    break
+        except (PermissionError, OSError):
+            pass
+        return sorted(extensions)
+
+    @staticmethod
+    def list_entries(base_path: str, extensions: List[str], ignore_dirs: Set[str],
+                     ignore_files: Set[str], keyword_filter: str = "") -> List[str]:
+        exts = {e.strip().lower() for e in extensions if e.strip()}
+        kw = keyword_filter.strip().lower()
+        valid: List[str] = []
+        try:
+            for dirpath, dirnames, filenames in os.walk(base_path):
+                dirnames[:] = [d for d in dirnames if d not in ignore_dirs and not d.startswith('.')]
+                for fname in filenames:
+                    if fname in ignore_files or fname.startswith('.'):
+                        continue
+                    ext = os.path.splitext(fname)[1].lower()
+                    if exts and ext not in exts:
+                        continue
+                    if kw and kw not in fname.lower():
+                        continue
+                    valid.append(os.path.join(dirpath, fname))
+        except (PermissionError, OSError):
+            pass
+        return valid
+
+class ContextBuilder:
+    @staticmethod
+    def build_tree_string(tree: dict, prefix: str = "") -> List[str]:
+        lines: List[str] = []
+        keys = sorted(tree.keys())
+        for i, key in enumerate(keys):
+            is_last = i == len(keys) - 1
+            connector = "\u2514\u2500\u2500 " if is_last else "\u251c\u2500\u2500 "
+            if tree[key]:
+                lines.append(f"{prefix}{connector}{key}/")
+                ext = "    " if is_last else "\u2502   "
+                lines.extend(ContextBuilder.build_tree_string(tree[key], prefix + ext))
+            else:
+                lines.append(f"{prefix}{connector}{key}")
+        return lines
+
+    @staticmethod
+    def build(blocks: List[ContextBlock], selected_files: List[str],
+              base_dir: str, mode: str, instruction: str,
+              max_file_size: int = MAX_FILE_SIZE) -> str:
+        parts: List[str] = []
+
+        if blocks:
+            parts.append("=== CONTEXT BLOCKS ===\n")
+            for block in sorted(blocks, key=lambda b: b.order):
+                parts.append(f"--- {block.name} ({block.category}) ---")
+                parts.append(block.content)
+                parts.append("")
+
+        if selected_files and mode != "Files Only":
+            tree_dict = {}
+            for fp in sorted(selected_files):
+                rel = os.path.relpath(fp, base_dir)
+                curr = tree_dict
+                for part in rel.split(os.sep):
+                    curr = curr.setdefault(part, {})
+            parts.append("=== PROJECT STRUCTURE ===")
+            parts.append(".")
+            parts.extend(ContextBuilder.build_tree_string(tree_dict))
+            parts.append("")
+
+        if mode != "Structure Only":
+            parts.append("=== FILE CONTENTS ===\n")
+            for fp in sorted(selected_files):
+                rel = os.path.relpath(fp, base_dir)
+                try:
+                    size = os.path.getsize(fp)
+                    if size > max_file_size:
+                        parts.append(f"--- {rel} ---")
+                        parts.append(f"[Omitted: {size/1024/1024:.1f}MB exceeds 1MB limit]\n")
+                        continue
+                    with open(fp, 'r', encoding='utf-8', errors='replace') as fh:
+                        content = fh.read()
+                    ext = os.path.splitext(rel)[1].lstrip('.') or 'text'
+                    parts.append(f"--- {rel} ---")
+                    parts.append(f"```{ext}")
+                    parts.append(content)
+                    parts.append("```\n")
+                except Exception as e:
+                    parts.append(f"--- {rel} ---")
+                    parts.append(f"[Error: {e}]\n")
+
+        if instruction:
+            parts.append("=== YOUR TASK ===")
+            parts.append(instruction)
+
+        return "\n".join(parts)