Feat/history

.github/workflows/ci.yml

@@ -0,0 +1,33 @@
+name: Quality Checks
+
+on:
+  pull_request:
+    branches:
+      - '**'
+
+jobs:
+  quality:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Python 3.11
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install dev dependencies (ruff, pytest)
+        run: pip install ruff pytest pytest-cov pytest-asyncio
+
+      - name: Install code_puppy
+        run: pip install .
+
+      - name: Lint with ruff
+        run: ruff check .
+
+      - name: Check formatting with ruff
+        run: ruff format --check .
+
+      - name: Run pytest
+        run: pytest --cov=code_puppy -s

.gitignore

@@ -10,3 +10,13 @@ wheels/
 .venv
 
 .coverage
+
+# Session memory
+.puppy_session_memory.json
+
+# Pytest cache
+.pytest_cache/
+
+dummy_path
+
+.idea/

.pre-commit-config.yaml

@@ -0,0 +1,25 @@
+fail_fast: true
+repos:
+  - repo: https://github.com/timothycrosley/isort
+    rev: 5.12.0
+    hooks:
+      - id: isort
+        args: [--filter-files, --profile, black]
+        files: \.py$
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.0.1
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-case-conflict
+      - id: check-json
+      - id: mixed-line-ending
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    # Ruff version.
+    rev: v0.11.2
+    hooks:
+      # Run the linter.
+      - id: ruff
+        args: [--fix, --ignore=E501]
+      # Run the formatter.
+      - id: ruff-format

AGENT.md

@@ -0,0 +1,53 @@
+# Code Puppy
+
+Code Puppy is a code gen agent!
+
+## Code Style
+
+- Clean
+- Concise
+- Follow yagni, srp, dry, etc
+- Don't write files longer than 600 lines
+- type hints on everything
+
+## Testing
+
+- `uv run pytest`
+
+## Namespaces Packages
+
+code_puppy
+    - agent.py - declares code generation agent
+    - agent_prompts.py - declares prompt for agent
+    - config.py - global config manager
+    - main.py - CLI loop
+    - message_history_processor.py - message history trimming, summarization logic
+    - __init__.py - package version detection and exposure
+    - model_factory.py - constructs models from configuration mapping
+    - models.json - available models and metadata registry
+    - state_management.py - global message history state helpers
+    - summarization_agent.py - specialized agent for history summarization
+    - version_checker.py - fetches latest PyPI package version
+
+code_puppy.tools
+    - __init__.py - registers all available tool modules
+    - common.py - shared console and ignore helpers
+    - command_runner.py - shell command execution with confirmations
+    - file_modifications.py - robust file editing with diffs
+    - file_operations.py - list read grep filesystem files
+
+code_puppy.command_line
+    - __init__.py - marks command line subpackage init
+    - file_path_completion.py - path completion with @ trigger
+    - meta_command_handler.py - handles meta commands and configuration
+    - model_picker_completion.py - model selection completion and setters
+    - motd.py - message of the day tracking
+    - prompt_toolkit_completion.py - interactive prompt with combined completers
+    - utils.py - directory listing and table utilities
+
+## Git Workflow
+
+- ALWAYS run `pnpm check` before committing
+- Fix linting errors with `ruff check --fix`
+- Run `ruff format .` to auto format
+- NEVER use `git push --force` on the main branch

DEV_CONSOLE.md

@@ -0,0 +1,57 @@
+# Code Puppy Developer Console Commands
+
+Woof! Here’s the scoop on built-in dev-console `~` meta-commands and exactly how you can add your own. This is for the secret society of code hackers (that’s you now).
+
+## Available Console Commands
+
+| Command             | Description                                              |
+|---------------------|----------------------------------------------------------|
+| `~cd [dir]`         | Show directory listing or change working directory       |
+| `~show`             | Show puppy/owner/model status and metadata              |
+| `~m <model>`        | Switch the active code model for the agent              |
+| `~set KEY=VALUE`      | Set a puppy.cfg setting!                                 |
+| `~help` or `~h`     | Show available meta-commands                            |
+| any unknown `~...`  | Warn user about unknown command and (for plain `~`)     |
+|                     | shows current model                                     |
+
+## How to Add a New Meta-Command
+
+All `~meta` commands are handled in **`code_puppy/command_line/meta_command_handler.py`** inside the `handle_meta_command` function. Follow these steps:
+
+### 1. Edit the Command Handler
+- Open `code_puppy/command_line/meta_command_handler.py`.
+- Locate the `handle_meta_command(command: str, console: Console) -> bool` function.
+- Add a new `if command.startswith("~yourcmd"):` block (do this _above_ the "unknown command" fallback).
+    - Use .startswith for prefix commands (e.g., `~foo bar`), or full equality if you want only the bare command to match.
+    - Implement your logic. Use rich’s Console to print stuff back to the terminal.
+    - Return `True` if you handle the command.
+
+### 2. (Optional) Add Autocomplete
+
+### ~set: Update your code puppy’s settings
+
+`~set` lets you instantly update values in your puppy.cfg, like toggling YOLO_MODE or renaming your puppy on the fly!
+
+- Usage:
+  - `~set YOLO_MODE=true`
+  - `~set puppy_name Snoopy`
+  - `~set owner_name="Best Owner"`
+
+As you type `~set`, tab completion pops up with available config keys so you don’t have to remember them like a boring human.
+
+If your new command needs tab completion/prompt support, check these files:
+- `code_puppy/command_line/prompt_toolkit_completion.py` (has completer logic)
+- `code_puppy/command_line/model_picker_completion.py`, `file_path_completion.py` (for model/filename completions)
+
+Update them if your command would benefit from better input support. Usually you just need meta_command_handler.py, though!
+
+### 3. (Optional) Update Help
+- Update the help text inside the `~help` handler to list your new command and a short description.
+
+### 4. (Optional) Add Utilities
+Place any helper logic for your command in an appropriate utils or tools module if it grows big. Don’t go dumping everything in meta_command_handler.py, or the puppy will fetch your slippers in protest!
+
+
+---
+
+Be concise, be fun, don’t make your files long, and remember: if you find yourself writing more than a quick conditional in meta_command_handler.py, break that logic out into another module! Woof woof!

ENVIRONMENT_VARIABLES.md

@@ -10,12 +10,7 @@ This document lists all environment variables that can be used to configure Code
 | `MODELS_JSON_PATH` | Optional path to a custom models.json configuration file. | Package directory models.json | agent.py |
 | `GEMINI_API_KEY` | API key for Google's Gemini models. | None | model_factory.py |
 | `OPENAI_API_KEY` | API key for OpenAI models. | None | model_factory.py |
-
-## Command Execution
-
-| Variable | Description | Default | Used In |
-|----------|-------------|---------|---------|
-| `YOLO_MODE` | When set to "true" (case-insensitive), bypasses the safety confirmation prompt when running shell commands. This allows commands to execute without user intervention. | `false` | tools/command_runner.py |
+| `CEREBRAS_API_KEY` | API key for Cerebras models. | None | model_factory.py |
 
 ## Custom Endpoints
 
@@ -72,5 +67,6 @@ code-puppy --interactive
 # Set API keys for model providers
 export OPENAI_API_KEY=sk-...
 export GEMINI_API_KEY=...
+export CEREBRAS_API_KEY=...
 code-puppy --interactive
 ```

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Mike Pfaffenberger
+
+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.