charlie-agents 0.2.0__tar.gz

charlie_agents-0.2.0/.charlie/commands/commit.md

@@ -0,0 +1,19 @@
+---
+allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
+description: Analyze changes and create a high-quality git commit
+---
+
+## Context
+
+- Current branch: !`git branch --show-current`
+- Working tree status: !`git status --short --branch`
+- Diff (staged + unstaged): !`git diff $(git rev-parse --verify HEAD 2>/dev/null || echo --cached)`
+- Recent history (if available): !`git log --oneline -10 || echo "No commits yet"`
+
+## Your task
+
+Analyze the context above and:
+
+1. Summarize the intent of the changes.
+2. Explain why those changes are important
+3. Commit the changes `git commit -m "<generated message>"`.

charlie_agents-0.2.0/.cursor/commands/commit.md

@@ -0,0 +1,19 @@
+---
+description: Analyze changes and create a high-quality git commit
+allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
+---
+
+## Context
+
+- Current branch: !`git branch --show-current`
+- Working tree status: !`git status --short --branch`
+- Diff (staged + unstaged): !`git diff $(git rev-parse --verify HEAD 2>/dev/null || echo --cached)`
+- Recent history (if available): !`git log --oneline -10 || echo "No commits yet"`
+
+## Your task
+
+Analyze the context above and:
+
+1. Summarize the intent of the changes.
+2. Explain why those changes are important
+3. Commit the changes `git commit -m "<generated message>"`.

charlie_agents-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,81 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  quality:
+    name: Quality Assurance
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.11", "3.12"]
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e ".[dev]"
+
+    - name: Run Ruff linter
+      run: |
+        ruff check src/ tests/
+
+    - name: Run mypy type checker
+      run: |
+        mypy --install-types --non-interactive src/charlie
+
+    - name: Run pytest with coverage
+      run: |
+        pytest
+
+    - name: Upload coverage to Codecov
+      if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.12'
+      uses: codecov/codecov-action@v4
+      with:
+        file: ./coverage.xml
+        fail_ci_if_error: false
+        token: ${{ secrets.CODECOV_TOKEN }}
+      continue-on-error: true
+
+  build:
+    name: Build Package
+    runs-on: ubuntu-latest
+    needs: quality
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.12"
+
+    - name: Install build dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build
+
+    - name: Build package
+      run: |
+        python -m build
+
+    - name: Check package metadata
+      run: |
+        pip install twine
+        twine check dist/*
+

charlie_agents-0.2.0/.github/workflows/publish.yml

@@ -0,0 +1,37 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:  # Allow manual trigger
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    
+    permissions:
+      contents: read
+      id-token: write  # Required for trusted publishing
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      
+      - name: Install build tools
+        run: |
+          python -m pip install --upgrade pip
+          pip install build
+      
+      - name: Build package
+        run: python -m build
+      
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          print-hash: true
+

charlie_agents-0.2.0/.gitignore

@@ -0,0 +1,48 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Testing
+.pytest_cache/
+.coverage
+coverage.xml
+htmlcov/
+.tox/
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Virtual environments
+venv/
+env/
+ENV/
+
+# OS
+.DS_Store
+Thumbs.db
+

charlie_agents-0.2.0/.plans.i/remove-docstrings-plan.plan.md

@@ -0,0 +1,68 @@
+<!-- 07797365-cdc6-497b-888b-8b695b5fff0e 549ae982-b920-4b4b-89bf-0ce2689c1cbe -->
+# Remove Docstrings from Charlie Project
+
+## Overview
+
+This plan outlines the removal of all docstrings that only describe WHAT the code does. Based on analysis of the codebase, all current docstrings fall into this category - none explain WHY the code was created.
+
+## Files to Modify
+
+### Source Files (11 files)
+
+1. **Module-level docstrings** (11 files)
+
+- `src/charlie/__init__.py`
+- `src/charlie/mcp.py`
+- `src/charlie/rules.py`
+- `src/charlie/agents/__init__.py`
+- `src/charlie/agents/claude.py`
+- `src/charlie/agents/copilot.py`
+- `src/charlie/agents/cursor.py`
+- `src/charlie/agents/gemini.py`
+- `src/charlie/agents/qwen.py`
+- `src/charlie/agents/registry.py`
+- `tests/__init__.py`
+
+2. **Class-level docstrings** (5 classes in agent files)
+
+- `ClaudeAdapter` in `claude.py`
+- `CopilotAdapter` in `copilot.py`
+- `CursorAdapter` in `cursor.py`
+- `GeminiAdapter` in `gemini.py`
+- `QwenAdapter` in `qwen.py`
+
+3. **Function-level docstrings** (18 functions)
+
+- `mcp.py`: 3 functions (`_command_to_tool_schema`, `_server_to_mcp_config`, `generate_mcp_config`)
+- `rules.py`: 8 functions (all private helpers and generators)
+- `registry.py`: 2 functions (`get_agent_spec`, `list_supported_agents`)
+- Agent adapters: 5 `generate_command` methods
+
+4. **Test docstrings**
+
+- Check all test files for any docstrings
+
+## Execution Plan
+
+- [ ] Remove module-level docstrings from main source files
+- [ ] Remove module-level docstrings from agent files  
+- [ ] Remove class-level docstrings from all adapter classes
+- [ ] Remove function-level docstrings from `mcp.py`
+- [ ] Remove function-level docstrings from `rules.py`
+- [ ] Remove function-level docstrings from `registry.py`
+- [ ] Remove function-level docstrings from agent adapter methods
+- [ ] Remove test file docstrings
+- [ ] Verify no linter errors were introduced
+- [ ] Run tests to ensure functionality unchanged
+
+## Notes
+
+All docstrings found describe only WHAT the code does (e.g., "MCP server configuration generator", "Convert command to MCP tool schema format"). None explain WHY decisions were made or provide context about the reasoning behind the implementation. Therefore, all should be removed per the criteria.
+
+### To-dos
+
+- [ ] Remove module-level docstrings from all Python files
+- [ ] Remove class-level docstrings from adapter classes
+- [ ] Remove function-level docstrings from all modules
+- [ ] Remove docstrings from test files
+- [ ] Run tests and verify no linter errors

charlie_agents-0.2.0/.zed/extensions/slash-commands-example/Cargo.toml

@@ -0,0 +1,16 @@
+[package]
+name = "slash_commands_example"
+version = "0.1.0"
+edition.workspace = true
+publish.workspace = true
+license = "Apache-2.0"
+
+[lints]
+workspace = true
+
+[lib]
+path = "src/slash_commands_example.rs"
+crate-type = ["cdylib"]
+
+[dependencies]
+zed_extension_api = "0.1.0"

charlie_agents-0.2.0/.zed/extensions/slash-commands-example/LICENSE-APACHE

@@ -0,0 +1 @@
+../../LICENSE-APACHE

charlie_agents-0.2.0/.zed/extensions/slash-commands-example/README.md

@@ -0,0 +1,84 @@
+# Slash Commands Example Extension
+
+This is an example extension showcasing how to write slash commands.
+
+See: [Extensions: Slash Commands](https://zed.dev/docs/extensions/slash-commands) in the Zed Docs.
+
+## Pre-requisites
+
+[Install Rust Toolchain](https://www.rust-lang.org/tools/install):
+
+```sh
+curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
+```
+
+## Setup
+
+```sh
+git clone https://github.com/zed-industries/zed.git
+cp -RL zed/extensions/slash-commands-example .
+
+cd slash-commands-example/
+
+# Update Cargo.toml to make it standalone
+cat > Cargo.toml << EOF
+[package]
+name = "slash_commands_example"
+version = "0.1.0"
+edition = "2021"
+license = "Apache-2.0"
+
+[lib]
+path = "src/slash_commands_example.rs"
+crate-type = ["cdylib"]
+
+[dependencies]
+zed_extension_api = "0.1.0"
+EOF
+
+curl -O https://raw.githubusercontent.com/rust-lang/rust/master/LICENSE-APACHE
+echo "# Zed Slash Commands Example Extension" > README.md
+echo "Cargo.lock" > .gitignore
+echo "target/" >> .gitignore
+echo "*.wasm" >> .gitignore
+
+git init
+git add .
+git commit -m "Initial commit"
+
+cd ..
+mv slash-commands-example MY-SUPER-COOL-ZED-EXTENSION
+zed $_
+```
+
+## Installation
+
+1. Open the command palette (`cmd-shift-p` or `ctrl-shift-p`).
+2. Launch `zed: install dev extension`
+3. Select the extension folder created above
+
+## Test
+
+Open the assistant and type `/echo` and `/pick-one` at the beginning of a line.
+
+## Customization
+
+Open the `extensions.toml` file and set the `id`, `name`, `description`, `authors` and `repository` fields.
+
+Rename `slash-commands-example.rs` you'll also have to update `Cargo.toml`
+
+## Rebuild
+
+Rebuild to see these changes reflected:
+
+1. Open Zed Extensions (`cmd-shift-x` or `ctrl-shift-x`).
+2. Click `Rebuild` next to your Dev Extension (formerly "Slash Command Example")
+
+## Troubleshooting / Logs
+
+- [zed.dev docs: Troubleshooting](https://zed.dev/docs/troubleshooting)
+
+## Documentation
+
+- [zed.dev docs: Extensions: Developing Extensions](https://zed.dev/docs/extensions/developing-extensions)
+- [zed.dev docs: Extensions: Slash Commands](https://zed.dev/docs/extensions/slash-commands)

charlie_agents-0.2.0/.zed/extensions/slash-commands-example/extension.toml

@@ -0,0 +1,15 @@
+id = "slash-commands-example"
+name = "Slash Commands Example"
+description = "An example extension showcasing slash commands."
+version = "0.1.0"
+schema_version = 1
+authors = ["Zed Industries <hi@zed.dev>"]
+repository = "https://github.com/zed-industries/zed"
+
+[slash_commands.echo]
+description = "echoes the provided input"
+requires_argument = true
+
+[slash_commands.pick-one]
+description = "pick one of three options"
+requires_argument = true

charlie_agents-0.2.0/.zed/extensions/slash-commands-example/src/slash_commands_example.rs

@@ -0,0 +1,90 @@
+use zed_extension_api::{
+    self as zed, SlashCommand, SlashCommandArgumentCompletion, SlashCommandOutput,
+    SlashCommandOutputSection, Worktree,
+};
+
+struct SlashCommandsExampleExtension;
+
+impl zed::Extension for SlashCommandsExampleExtension {
+    fn new() -> Self {
+        SlashCommandsExampleExtension
+    }
+
+    fn complete_slash_command_argument(
+        &self,
+        command: SlashCommand,
+        _args: Vec<String>,
+    ) -> Result<Vec<zed_extension_api::SlashCommandArgumentCompletion>, String> {
+        match command.name.as_str() {
+            "echo" => Ok(vec![]),
+            "pick-one" => Ok(vec![
+                SlashCommandArgumentCompletion {
+                    label: "Option One".to_string(),
+                    new_text: "option-1".to_string(),
+                    run_command: true,
+                },
+                SlashCommandArgumentCompletion {
+                    label: "Option Two".to_string(),
+                    new_text: "option-2".to_string(),
+                    run_command: true,
+                },
+                SlashCommandArgumentCompletion {
+                    label: "Option Three".to_string(),
+                    new_text: "option-3".to_string(),
+                    run_command: true,
+                },
+            ]),
+            command => Err(format!("unknown slash command: \"{command}\"")),
+        }
+    }
+
+    fn run_slash_command(
+        &self,
+        command: SlashCommand,
+        args: Vec<String>,
+        _worktree: Option<&Worktree>,
+    ) -> Result<SlashCommandOutput, String> {
+        match command.name.as_str() {
+            "echo" => {
+                if args.is_empty() {
+                    return Err("nothing to echo".to_string());
+                }
+
+                let text = args.join(" ");
+
+                Ok(SlashCommandOutput {
+                    sections: vec![SlashCommandOutputSection {
+                        range: (0..text.len()).into(),
+                        label: "Echo".to_string(),
+                    }],
+                    text,
+                })
+            }
+            "pick-one" => {
+                let Some(selection) = args.first() else {
+                    return Err("no option selected".to_string());
+                };
+
+                match selection.as_str() {
+                    "option-1" | "option-2" | "option-3" => {}
+                    invalid_option => {
+                        return Err(format!("{invalid_option} is not a valid option"));
+                    }
+                }
+
+                let text = format!("You chose {selection}.");
+
+                Ok(SlashCommandOutput {
+                    sections: vec![SlashCommandOutputSection {
+                        range: (0..text.len()).into(),
+                        label: format!("Pick One: {selection}"),
+                    }],
+                    text,
+                })
+            }
+            command => Err(format!("unknown slash command: \"{command}\"")),
+        }
+    }
+}
+
+zed::register_extension!(SlashCommandsExampleExtension);

charlie_agents-0.2.0/AGENTS.md

@@ -0,0 +1,30 @@
+# AGENTS instructions
+
+This document provides guidelines and instructions for using AI agents effectively.
+
+## Commit messages
+
+- Title
+  - Contains 5-116 characters
+  - Start with capital letter (A-Z)
+  - Use imperative mood ("Add feature" not "Added feature")
+  - No ticket numbers (use footer instead)
+  - No trailing whitespace
+- Body
+  - Explain WHY and maybe a bit of HOW
+  - Empty line required between title and body
+  - Max 116 characters per line (except URLs, code blocks, footer annotations)
+  - Minimum 5 characters
+- Footer
+  - Use trailers:
+    - `Ticket: PROJ-1234`
+    - `Reference: https://example.com`
+    - `Assisted-by: Tool/Agent (<Model/Version>)`
+- AI attribution
+  - When an AI agent generates/assists with code or commits, add `Assisted-by: Tool/Agent (<Model/Version>)`, for example `Assisted-by: Claude (Claude Sonnet 4.5)`, `Assisted-by: Cursor (GPT-5)`, `Assisted-by: Zed (GPT-4o)`
+  - If you're not sure which agent or model is being used, ask the user.
+
+## Testing
+
+- Describe behaviour, not implementation.
+- Do not use docstrings to document the test, but instead has very descriptive names.