stackfix 0.2.0

package/README.md

@@ -0,0 +1,111 @@
+# StackFix
+
+> Terminal-first agentic CLI that fixes failing commands using AI
+
+StackFix is a developer productivity tool that brings AI-powered assistance directly to your terminal. Describe what you want in natural language, wrap failing commands to get automated fixes, or use the interactive TUI for complex workflows.
+
+## Features
+
+- 🤖 **Natural language prompts** — Ask questions, get code suggestions
+- 🔧 **Command wrapping** — Automatically diagnose and fix failing commands
+- 🎨 **Syntax-highlighted diffs** — Clear visualization of proposed changes
+- 💬 **Interactive TUI** — Rich terminal interface with slash commands
+- 🔌 **Provider-agnostic** — Works with OpenAI, Nebius, or any compatible API
+- 📝 **Session persistence** — Resume previous conversations
+
+## Installation
+
+### npm (recommended)
+
+```bash
+npm install -g stackfix
+```
+
+### pip
+
+```bash
+pip install stackfix
+```
+
+### From source
+
+```bash
+git clone https://github.com/stackfix/stackfix.git
+cd stackfix
+pip install -e .
+```
+
+## Quick Start
+
+```bash
+# Launch interactive TUI
+stackfix
+
+# Single prompt (non-interactive)
+stackfix --prompt "explain this error: ImportError: No module named 'foo'"
+
+# Wrap a failing command
+stackfix -- pytest -q
+```
+
+## Configuration
+
+Set environment variables for your LLM provider:
+
+```bash
+# OpenAI
+export MODEL_BASE_URL="https://api.openai.com/v1"
+export MODEL_API_KEY="sk-..."
+export MODEL_NAME="gpt-4"
+
+# Nebius
+export MODEL_BASE_URL="https://api.tokenfactory.nebius.com/v1"
+export MODEL_API_KEY="..."
+export MODEL_NAME="openai/gpt-oss-120b"
+
+# Local (Ollama)
+export MODEL_BASE_URL="http://localhost:11434/v1"
+export MODEL_NAME="codellama:13b"
+```
+
+## TUI Commands
+
+| Command | Description |
+|---------|-------------|
+| `/help` | Show all available commands |
+| `/exit` | Exit the TUI |
+| `/model <name>` | View or switch the model |
+| `/approvals <mode>` | Set approval mode (suggest, auto-edit, full-auto) |
+| `/status` | Show current configuration |
+| `/diff` | Show pending git changes |
+| `/history` | Show last run summary |
+| `/new` | Start a new session |
+| `/resume <id>` | Resume a saved session |
+
+Use `!command` to run shell commands directly.
+
+## Project Context
+
+Create an `AGENTS.md` file in your project root to provide persistent context:
+
+```markdown
+# Project Guidelines
+
+- Use pytest for testing
+- Follow PEP 8 style
+- Prefer type hints
+```
+
+## Development
+
+```bash
+# Install with dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest tests/ -v
+```
+
+## License
+
+MIT

package/bin/stackfix

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// Get the package root directory
+const packageRoot = path.resolve(__dirname, '..');
+const venvPath = path.join(packageRoot, '.venv');
+
+// Determine Python executable path
+function getPythonPath() {
+  const isWindows = process.platform === 'win32';
+  
+  // Check for venv first
+  if (fs.existsSync(venvPath)) {
+    const venvPython = isWindows
+      ? path.join(venvPath, 'Scripts', 'python.exe')
+      : path.join(venvPath, 'bin', 'python');
+    if (fs.existsSync(venvPython)) {
+      return venvPython;
+    }
+  }
+  
+  // Fall back to system Python
+  return isWindows ? 'python' : 'python3';
+}
+
+// Run stackfix
+const pythonPath = getPythonPath();
+const args = ['-m', 'stackfix', ...process.argv.slice(2)];
+
+const child = spawn(pythonPath, args, {
+  stdio: 'inherit',
+  cwd: process.cwd(),
+  env: {
+    ...process.env,
+    PYTHONPATH: packageRoot
+  }
+});
+
+child.on('error', (err) => {
+  if (err.code === 'ENOENT') {
+    console.error('Error: Python not found. Please install Python 3.9+');
+    console.error('  Windows: https://www.python.org/downloads/');
+    console.error('  macOS:   brew install python3');
+    console.error('  Linux:   apt install python3 python3-pip');
+    process.exit(1);
+  }
+  console.error('Error:', err.message);
+  process.exit(1);
+});
+
+child.on('exit', (code) => {
+  process.exit(code || 0);
+});

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "stackfix",
+  "version": "0.2.0",
+  "description": "Terminal-first agentic CLI that fixes failing commands using AI",
+  "keywords": [
+    "cli",
+    "ai",
+    "developer-tools",
+    "agent",
+    "llm",
+    "terminal",
+    "debugging"
+  ],
+  "author": "StackFix Contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dyglo/stackfix.git"
+  },
+  "bin": "bin/stackfix",
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "files": [
+    "bin/",
+    "scripts/",
+    "stackfix/",
+    "pyproject.toml",
+    "README.md"
+  ]
+}

package/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "stackfix"
+version = "0.2.0"
+description = "Terminal-first agentic CLI that fixes failing commands using AI"
+readme = "README.md"
+requires-python = ">=3.9"
+dependencies = [
+  "requests>=2.31",
+  "textual>=0.55",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=7.0", "pytest-asyncio>=0.21"]
+
+[project.scripts]
+stackfix = "stackfix.cli:main"
+
+[tool.setuptools.packages.find]
+include = ["stackfix*"]

package/scripts/parse_selftest.py

@@ -0,0 +1,13 @@
+import json
+from stackfix.agent import _parse_agent_response
+
+cases = [
+    '{"summary":"ok","confidence":0.5,"patch_unified_diff":"","rerun_command":["pytest","-q"]}',
+    '{"summary":"ok","confidence":"0.8","patch_unified_diff":null,"rerun_command":"pytest -q"}',
+    '{"summary":"ok"}',
+    'plain text response',
+]
+
+for i, content in enumerate(cases, 1):
+    result = _parse_agent_response(content)
+    print(f"case {i}: summary={result.get('summary')!r} rerun={result.get('rerun_command')} warning={result.get('_warning')}")

package/scripts/postinstall.js

@@ -0,0 +1,130 @@
+#!/usr/bin/env node
+
+/**
+ * StackFix postinstall script
+ * Sets up Python virtual environment and installs dependencies
+ */
+
+const { execSync, spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const packageRoot = path.resolve(__dirname, '..');
+const venvPath = path.join(packageRoot, '.venv');
+const isWindows = process.platform === 'win32';
+
+// ANSI colors
+const GREEN = '\x1b[32m';
+const YELLOW = '\x1b[33m';
+const RED = '\x1b[31m';
+const RESET = '\x1b[0m';
+const BOLD = '\x1b[1m';
+
+function log(msg) {
+    console.log(`${BOLD}[stackfix]${RESET} ${msg}`);
+}
+
+function success(msg) {
+    console.log(`${GREEN}✓${RESET} ${msg}`);
+}
+
+function warn(msg) {
+    console.log(`${YELLOW}⚠${RESET} ${msg}`);
+}
+
+function error(msg) {
+    console.error(`${RED}✗${RESET} ${msg}`);
+}
+
+// Find Python 3.9+
+function findPython() {
+    const candidates = isWindows
+        ? ['python', 'python3', 'py -3']
+        : ['python3', 'python'];
+
+    for (const cmd of candidates) {
+        try {
+            const version = execSync(`${cmd} --version 2>&1`, { encoding: 'utf8' }).trim();
+            const match = version.match(/Python (\d+)\.(\d+)/);
+            if (match) {
+                const major = parseInt(match[1], 10);
+                const minor = parseInt(match[2], 10);
+                if (major === 3 && minor >= 9) {
+                    return { cmd, version };
+                }
+            }
+        } catch {
+            // Try next candidate
+        }
+    }
+    return null;
+}
+
+// Main installation
+async function main() {
+    log('Setting up StackFix...');
+
+    // Find Python
+    const python = findPython();
+    if (!python) {
+        error('Python 3.9+ is required but not found.');
+        console.log('');
+        console.log('Please install Python 3.9 or later:');
+        console.log('  Windows: https://www.python.org/downloads/');
+        console.log('  macOS:   brew install python3');
+        console.log('  Linux:   apt install python3 python3-pip');
+        process.exit(1);
+    }
+
+    success(`Found ${python.version} (${python.cmd})`);
+
+    // Create venv if it doesn't exist
+    if (!fs.existsSync(venvPath)) {
+        log('Creating virtual environment...');
+        try {
+            execSync(`${python.cmd} -m venv "${venvPath}"`, {
+                cwd: packageRoot,
+                stdio: 'inherit'
+            });
+            success('Virtual environment created');
+        } catch (err) {
+            error('Failed to create virtual environment');
+            console.log('Try running: pip install --user stackfix');
+            process.exit(1);
+        }
+    } else {
+        success('Virtual environment exists');
+    }
+
+    // Determine pip path
+    const pipPath = isWindows
+        ? path.join(venvPath, 'Scripts', 'pip.exe')
+        : path.join(venvPath, 'bin', 'pip');
+
+    // Install package in editable mode
+    log('Installing StackFix...');
+    try {
+        execSync(`"${pipPath}" install -e "${packageRoot}" --quiet`, {
+            cwd: packageRoot,
+            stdio: 'inherit'
+        });
+        success('StackFix installed successfully');
+    } catch (err) {
+        error('Failed to install StackFix');
+        process.exit(1);
+    }
+
+    console.log('');
+    log('Setup complete! Run "stackfix" to start.');
+    console.log('');
+    console.log('Quick start:');
+    console.log('  stackfix                    # Launch interactive TUI');
+    console.log('  stackfix --prompt "..."     # Single prompt mode');
+    console.log('  stackfix -- pytest -v       # Wrap and fix a command');
+    console.log('');
+}
+
+main().catch((err) => {
+    error(err.message);
+    process.exit(1);
+});

package/stackfix/__init__.py

@@ -0,0 +1 @@
+__all__ = ["cli"]

package/stackfix/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    main()