localforge 0.1.0__tar.gz

localforge-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,62 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  lint:
+    name: Lint (ruff)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run ruff
+        run: ruff check .
+
+  typecheck:
+    name: Type Check (mypy)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run mypy
+        run: mypy localforge/
+
+  test:
+    name: Tests (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run pytest
+        run: pytest -v --tb=short

localforge-0.1.0/.localforge/commands.yml

@@ -0,0 +1,49 @@
+# =============================================================================
+# LocalForge Custom Verification Commands
+# =============================================================================
+# Define additional commands that LocalForge will run during the verification
+# phase. These are run AFTER the auto-detected commands (syntax check, ruff,
+# mypy, pytest).
+#
+# Each command needs:
+#   name    — A short identifier shown in output.
+#   cmd     — The shell command to execute. Use {changed_files} as a placeholder
+#             for the list of files modified by the current patch.
+#   timeout — Maximum seconds before the command is killed (default: 60).
+#
+# LocalForge auto-detects and runs these by default if the tooling is present:
+#   - python -m py_compile (syntax check)
+#   - ruff check .
+#   - mypy --ignore-missing-imports
+#   - pytest --tb=short -q
+#   - npm test (if package.json present)
+#   - go test ./... (if go.mod present)
+#
+# Add your own below:
+# =============================================================================
+
+commands:
+  # Example: Run a custom linter
+  # - name: custom_lint
+  #   cmd: "flake8 --max-line-length 100 ."
+  #   timeout: 60
+
+  # Example: Run a specific test suite
+  # - name: integration_tests
+  #   cmd: "pytest tests/integration/ -v --tb=short"
+  #   timeout: 300
+
+  # Example: Check for security issues
+  # - name: security_scan
+  #   cmd: "bandit -r src/ -ll"
+  #   timeout: 120
+
+  # Example: Validate OpenAPI spec
+  # - name: openapi_validate
+  #   cmd: "openapi-spec-validator api/openapi.yml"
+  #   timeout: 30
+
+  # Example: Run only changed-file checks
+  # - name: changed_lint
+  #   cmd: "ruff check {changed_files}"
+  #   timeout: 60

localforge-0.1.0/.localforge/config.yml

@@ -0,0 +1,75 @@
+# =============================================================================
+# LocalForge Configuration
+# =============================================================================
+# This file controls how LocalForge behaves in this repository.
+# All fields are optional — defaults are shown below.
+#
+# Values can also be set via environment variables with the LOCALFORGE_ prefix:
+#   LOCALFORGE_MODEL_NAME=codellama:13b
+#   LOCALFORGE_MAX_CONTEXT_TOKENS=8192
+#
+# Priority: env vars > this file > built-in defaults
+# =============================================================================
+
+# ---------------------------------------------------------------------------
+# Model Settings
+# ---------------------------------------------------------------------------
+
+# Ollama model tag to use for all LLM calls.
+# Run `ollama list` to see available models on your machine.
+model_name: "qwen2.5-coder:7b"
+
+# Base URL of the Ollama HTTP API.
+# Change this if Ollama is running on a different host or port.
+ollama_base_url: "http://localhost:11434"
+
+# Model size profile. Controls context window, retrieval limits, and chunk size.
+# Options: small, medium, large
+#
+#   small  — 4K context, 5 chunks, fast iteration (7B models)
+#   medium — 8K context, 10 chunks, balanced (13-16B models)
+#   large  — 32K context, 20 chunks, best quality (32B+ models)
+model_profile: "small"
+
+# ---------------------------------------------------------------------------
+# Context & Token Budget
+# ---------------------------------------------------------------------------
+
+# Maximum number of tokens to include in the LLM context window.
+# Set this to match your model's actual context size for best results.
+# The context assembler will truncate and prioritize to fit within this budget.
+max_context_tokens: 4096
+
+# ---------------------------------------------------------------------------
+# Agent Behavior
+# ---------------------------------------------------------------------------
+
+# Maximum number of agent loop iterations before forced stop.
+# This prevents runaway loops. Each plan step + retry counts as an iteration.
+max_iterations: 50
+
+# Automatically approve all proposed patches without user confirmation.
+# Use with caution — recommended only for trusted, well-tested tasks.
+auto_approve: false
+
+# When true, show planned patches as diffs but do not write any files.
+# Useful for previewing what the agent would do.
+dry_run: false
+
+# ---------------------------------------------------------------------------
+# Paths
+# ---------------------------------------------------------------------------
+
+# Path to the repository root. Usually "." (current directory).
+repo_path: "."
+
+# Path to the SQLite index database (relative to repo root).
+# The index stores file chunks, symbols, and metadata for fast retrieval.
+index_db_path: ".localforge/index.db"
+
+# ---------------------------------------------------------------------------
+# Logging
+# ---------------------------------------------------------------------------
+
+# Logging verbosity. Options: DEBUG, INFO, WARNING, ERROR, CRITICAL
+log_level: "INFO"

localforge-0.1.0/.localforge/rules.md

@@ -0,0 +1,44 @@
+# LocalForge Rules
+#
+# This file tells the agent about project-specific conventions and constraints.
+# Everything here is included in the agent's context for every task, so keep it
+# concise and actionable.
+
+## Coding Style
+
+- Follow PEP 8 and use `ruff` for linting.
+- Maximum line length: 100 characters.
+- Use type hints on all public function signatures.
+- Prefer `pathlib.Path` over `os.path`.
+- Use f-strings for string formatting (no `.format()` or `%`).
+
+## Forbidden Patterns
+
+- Do not use `print()` for logging — use the `logging` module.
+- Do not use `import *` anywhere.
+- Do not use mutable default arguments (e.g., `def f(x=[])`).
+- Do not catch bare `except:` — always specify the exception type.
+- Do not use `os.system()` or `subprocess.call()` with `shell=True` for
+  untrusted input.
+
+## Test Requirements
+
+- Every new public function must have at least one corresponding test.
+- Tests live in `tests/` and follow the naming convention `test_<module>.py`.
+- Use `pytest` as the test runner.
+- Use `pytest-asyncio` for async tests (mode: `auto`).
+- Mock external dependencies (Ollama, filesystem) in unit tests.
+- Tests must pass before any PR is merged.
+
+## File Naming
+
+- Python modules: `snake_case.py`
+- Test files: `test_<module_name>.py`
+- Configuration files: lowercase with hyphens or underscores.
+- No spaces or special characters in filenames.
+
+## Documentation
+
+- Add docstrings to all public classes and functions.
+- Use Google-style or NumPy-style docstrings consistently.
+- Update the README when adding new CLI commands or config fields.

localforge-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,123 @@
+# Contributing to LocalForge
+
+Thanks for your interest in contributing! LocalForge is an open-source project
+and we welcome contributions of all kinds.
+
+## Getting Started
+
+1. **Fork & clone** the repository:
+
+   ```bash
+   git clone https://github.com/localforge/localforge.git
+   cd localforge
+   ```
+
+2. **Install in development mode** with dev dependencies:
+
+   ```bash
+   pip install -e ".[dev]"
+   ```
+
+3. **Verify** the setup:
+
+   ```bash
+   pytest
+   ruff check .
+   ```
+
+## Development Workflow
+
+1. Create a feature branch from `main`:
+
+   ```bash
+   git checkout -b feature/my-feature
+   ```
+
+2. Make your changes. Follow the existing code style (PEP 8, 100 char lines,
+   type hints on public APIs).
+
+3. Write or update tests for any changed functionality.
+
+4. Run the full check suite:
+
+   ```bash
+   # Lint
+   ruff check .
+
+   # Type check
+   mypy localforge/
+
+   # Tests
+   pytest -v
+   ```
+
+5. Commit with a clear, descriptive message:
+
+   ```bash
+   git commit -m "feat: add support for custom retrieval strategies"
+   ```
+
+6. Push and open a Pull Request against `main`.
+
+## Code Style
+
+- **Formatter:** Black (line length 100).
+- **Linter:** Ruff with the rule set defined in `pyproject.toml`.
+- **Type checker:** mypy in strict mode.
+- Python 3.11+ features are fine (use `from __future__ import annotations`).
+- Use `pathlib.Path` over `os.path`.
+- Use structured logging, not `print()`.
+
+## Project Structure
+
+```
+localforge/
+  agent/         # Multi-agent system (orchestrator, specialist agents)
+  cli/           # Typer CLI commands and display helpers
+  context_manager/  # Token budget management and context assembly
+  core/          # Config, models, Ollama client, prompt templates
+  index/         # Repository indexing (SQLite) and search
+  patching/      # File patching with backup and validation
+  retrieval/     # Context retrieval and ranking
+  verifier/      # Verification runner (lint, test, type-check)
+tests/           # All tests (pytest)
+```
+
+## Writing Tests
+
+- Place tests in `tests/test_<module>.py`.
+- Use `pytest` fixtures from `tests/conftest.py`.
+- Mock external dependencies (Ollama API, filesystem writes) in unit tests.
+- Use `pytest-asyncio` for async tests — the project uses `asyncio_mode = "auto"`.
+- Aim for tests that run fast and don't require a running Ollama instance.
+
+## Commit Messages
+
+Follow [Conventional Commits](https://www.conventionalcommits.org/):
+
+- `feat:` — new feature
+- `fix:` — bug fix
+- `docs:` — documentation only
+- `test:` — adding or updating tests
+- `refactor:` — code change that neither fixes a bug nor adds a feature
+- `chore:` — build process, CI, dependency updates
+
+## Pull Request Guidelines
+
+- Keep PRs focused — one feature or fix per PR.
+- Include a clear description of **what** changed and **why**.
+- All CI checks (pytest, ruff, mypy) must pass.
+- Add tests for new functionality.
+- Update documentation if you add or change CLI commands or config fields.
+
+## Reporting Issues
+
+- Use GitHub Issues.
+- Include: Python version, OS, Ollama version, model used, and steps to
+  reproduce.
+- Paste the full error traceback if applicable.
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the
+MIT License.

localforge-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 localforge contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.