tunacode-cli 0.0.54__tar.gz → 0.0.56__tar.gz

tunacode_cli-0.0.56/CLAUDE.md

@@ -0,0 +1,78 @@
+### Documentation
+
+- update the documents @documentation and in .claude after any update.
+
+- use the subagent tech-docs-maintainer to update the documentation you MUST instruct the subagent to keep doc updates short you will be PUNISHED for not telling the documentation agent to keep it to only the most distilled information
+
+- always follow best practices with git commits naming and gh cli workflows
+
+- commit frequently
+
+- always be on the side of safety, if you have any question consult the user
+
+### Python Coding Standards
+
+- always use the venv
+- Use type hints (PEP 484) for all function signatures
+- Prefer f-strings (PEP 498) over %-formatting or .format()
+- Use pathlib.Path instead of os.path for filesystem operations
+- Structure imports: stdlib → third-party → local (PEP 8)
+- Use dataclasses (PEP 557) for simple data containers
+- Prefer context managers (with) for resource handling
+- Use structural pattern matching (PEP 634) for complex
+- run ruff frequently
+
+### Testing
+
+- "make test" command the entire testing suite
+
+- anytime a new feature or refactor is done, we MUST find or make the golden/character test FIRST as a baseline standaard BEFORE starting, under no circumstance are you to not follow this pattern
+
+### Workflow
+
+- before any updates make a git commit rollback point, clearly labeled for future agents
+
+- the clear outline of the objective MUST be established before we begin ANY coding, do not under any circumstance begin any updates untill this is clearly understood, if you have any ambiuguity or quesiton, the user can be brought in or use best practises
+
+- use scratchpad-multi.sh as you work, after the MD file is done being used sort it to the approate directory
+
+- the MD file created by the bash file MUST be used for the duiration of the task you will be PUNISHED if you do not update this file as you work.
+
+- any key logic or file's must be inlcuded here in the following format if this format is not followed you will STOP reasses, and begin again
+
+### Scratchpad Template Example
+
+```
+# Implementing Authentication Module
+_Started: 2025-08-06 10:00:00_
+_Agent: default_
+
+[1] Found auth logic in src/auth/handler.py:45
+[2] Key dependencies: jwt, bcrypt, session_manager
+[3] Modified login function to add rate limiting
+[3~1] Fixed edge case for empty passwords
+```
+
+- General documentation → archive to @documentation/
+- Developer/tunacode-specific → archive to @ .claude
+- Organize archives by category (agent/development/ etc)
+- In general the scratchpad should never go in any other dirs ececpt the two above
+
+- if a task at hand is to big to handle as a one off use the taskmaster MCP but in general this should only be used as needed, usually it will not be needed
+
+- grep documentation and .claude as needed BOTH of these have a README.md that ahs a direcoty map, you MUST read these before any bigger grep or context searches
+
+- in general gather as much context as needed, unless specified by the user
+
+- this is the most important part of this prompt: Synthesis context aggressively and heuristically AS NEEDED ONLY You can deploy the appropriate subagent for complex tasks agents list below
+
+## Available Agents:
+
+1. **bug-context-analyzer** - Investigates precise context around bugs without suggesting fixes
+2. **code-synthesis-analyzer** - Analyzes recent code changes to identify issues needing fixes
+3. **documentation-synthesis-qa** - Creates comprehensive docs via multi-agent orchestration
+4. **expert-debugger** - Debugs issues using strategic logging and root cause analysis
+5. **phased-task-processor** - Breaks down markdown tasks into max 5 actionable phases
+6. **prompt-engineer** - Optimizes prompts using 26 documented engineering principles
+7. **rapid-code-synthesis-qa** - Quick quality assessment with confidence scores (1-5 scale)
+8. **tech-docs-maintainer** - Updates docs in @documentation and .claude directories

{tunacode_cli-0.0.54/src/tunacode_cli.egg-info → tunacode_cli-0.0.56}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tunacode-cli
-Version: 0.0.54
+Version: 0.0.56
 Summary: Your agentic CLI developer.
 Author-email: larock22 <noreply@github.com>
 License: MIT
@@ -39,6 +39,7 @@ Requires-Dist: vulture>=2.7; extra == "dev"
 Requires-Dist: unimport>=1.0.0; extra == "dev"
 Requires-Dist: autoflake>=2.0.0; extra == "dev"
 Requires-Dist: dead>=1.5.0; extra == "dev"
+Requires-Dist: hatch>=1.6.0; extra == "dev"
 Dynamic: license-file
 
 # TunaCode CLI
@@ -106,7 +107,7 @@ tunacode --model "anthropic:claude-3.5-sonnet" --key "sk-ant-your-anthropic-key"
 tunacode --model "openrouter:openai/gpt-4o" --key "sk-or-your-openrouter-key"
 ```
 
-Your config is saved to `~/.config/tunacode.json` (edit directly with `nvim ~/.config/tunacode.json`)
+Your config is saved to `~/.config/tunacode.json`. This file stores your API keys, model preferences, and runtime settings like `max_iterations` (default: 40) and `context_window_size`. You can edit it directly with `nvim ~/.config/tunacode.json` or see [the complete configuration example](documentation/configuration/config-file-example.md) for all available options.
 
 ### Recommended Models
 
@@ -243,7 +244,7 @@ tunacode --model "anthropic:claude-3.5-sonnet" --key "sk-ant-your-anthropic-key"
 tunacode --model "openrouter:openai/gpt-4o" --key "sk-or-your-openrouter-key"
 ```
 
-Your config is saved to `~/.config/tunacode.json` (edit directly with `nvim ~/.config/tunacode.json`)
+Your config is saved to `~/.config/tunacode.json`. This file stores your API keys, model preferences, and runtime settings like `max_iterations` (default: 40) and `context_window_size`. You can edit it directly with `nvim ~/.config/tunacode.json` or see [the complete configuration example](documentation/configuration/config-file-example.md) for all available options.
 
 ### Recommended Models
 

{tunacode_cli-0.0.54 → tunacode_cli-0.0.56}/README.md

@@ -63,7 +63,7 @@ tunacode --model "anthropic:claude-3.5-sonnet" --key "sk-ant-your-anthropic-key"
 tunacode --model "openrouter:openai/gpt-4o" --key "sk-or-your-openrouter-key"
 ```
 
-Your config is saved to `~/.config/tunacode.json` (edit directly with `nvim ~/.config/tunacode.json`)
+Your config is saved to `~/.config/tunacode.json`. This file stores your API keys, model preferences, and runtime settings like `max_iterations` (default: 40) and `context_window_size`. You can edit it directly with `nvim ~/.config/tunacode.json` or see [the complete configuration example](documentation/configuration/config-file-example.md) for all available options.
 
 ### Recommended Models
 
@@ -200,7 +200,7 @@ tunacode --model "anthropic:claude-3.5-sonnet" --key "sk-ant-your-anthropic-key"
 tunacode --model "openrouter:openai/gpt-4o" --key "sk-or-your-openrouter-key"
 ```
 
-Your config is saved to `~/.config/tunacode.json` (edit directly with `nvim ~/.config/tunacode.json`)
+Your config is saved to `~/.config/tunacode.json`. This file stores your API keys, model preferences, and runtime settings like `max_iterations` (default: 40) and `context_window_size`. You can edit it directly with `nvim ~/.config/tunacode.json` or see [the complete configuration example](documentation/configuration/config-file-example.md) for all available options.
 
 ### Recommended Models
 

{tunacode_cli-0.0.54 → tunacode_cli-0.0.56}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "tunacode-cli"
 
-version = "0.0.54"
+version = "0.0.56"
 description = "Your agentic CLI developer."
 keywords = ["cli", "agent", "development", "automation"]
 readme = "README.md"
@@ -50,6 +50,7 @@ dev = [
     "unimport>=1.0.0",
     "autoflake>=2.0.0",
     "dead>=1.5.0",
+    "hatch>=1.6.0",
 ]
 
 [project.urls]
@@ -129,3 +130,76 @@ skips = ["B404", "B603", "B101", "B607", "B110", "B324", "B103", "B604", "B602",
 # B604: shell=True (validated usage in REPL)
 # B602: subprocess with shell=True (security utils)
 # B108: hardcoded tmp paths (test fixtures)
+
+[tool.mypy]
+python_version = "3.10"
+ignore_missing_imports = true
+warn_return_any = false
+warn_unused_configs = true
+disallow_untyped_defs = false
+disallow_incomplete_defs = false
+check_untyped_defs = false
+disallow_untyped_decorators = false
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = false
+warn_no_return = true
+follow_imports = "silent"
+# Allow CLAUDE_ANCHOR comments in docstrings
+disable_error_code = ["annotation-unchecked"]
+
+[tool.hatch.envs.default.scripts]
+# Development
+install = "pip install -e '.[dev]'"
+run = "python -m tunacode"
+test-script = "echo 'Test script works'"
+
+# Cleaning
+clean = "python -c \"import shutil, pathlib; dirs=['build', 'dist']; [shutil.rmtree(d, ignore_errors=True) for d in dirs]; [shutil.rmtree(p, ignore_errors=True) for p in pathlib.Path('.').rglob('*.egg-info') if p.is_dir()]; [shutil.rmtree(p, ignore_errors=True) for p in pathlib.Path('.').rglob('__pycache__') if p.is_dir()]; [p.unlink(missing_ok=True) for p in pathlib.Path('.').rglob('*.pyc')]; print('Cleaned build artifacts, egg-info, __pycache__, and *.pyc files')\""
+
+# Linting & Formatting
+lint = "ruff check . && ruff format ."
+lint-check = [
+    "ruff check .",
+    "ruff format --check .",
+]
+
+# Dead code analysis
+vulture = "python -m vulture --config pyproject.toml"
+vulture-check = "python -m vulture --config pyproject.toml --min-confidence 100"
+
+dead-code-check = [
+    "python -c \"print('Running comprehensive dead code analysis...')\"",
+    "python -c \"print('\\n=== Vulture (unused code) ===')\"",
+    "python -m vulture . --min-confidence 80 --exclude '*/test/*,*/tests/*,venv/*,build/*,dist/*' || true",
+    "python -c \"print('\\n=== Unimport (unused imports) ===')\"",
+    "python -m unimport --check . || true",
+    "python -c \"print('\\n=== Dead (dead code detector) ===')\"",
+    "python -m dead . || true",
+    "python -c \"print('\\n=== Checking test coverage for dead code ===')\"",
+]
+
+dead-code-clean = [
+    "python -c \"print('Removing dead code...')\"",
+    "python -m unimport --remove-all .",
+    "python -m autoflake --remove-all-unused-imports --remove-unused-variables -i -r src/",
+    "python -c \"print('Dead code cleanup complete!')\"",
+]
+
+dead-code-report = [
+    "python -c \"print('Generating dead code reports...'); import pathlib; pathlib.Path('reports').mkdir(exist_ok=True)\"",
+    "python -m vulture . --min-confidence 60 > reports/dead_code_vulture.txt || true",
+    "python -m unimport --check . --diff > reports/unused_imports.txt || true",
+    "python -c \"print('Reports generated in reports/ directory')\"",
+]
+
+# Testing
+test = "python -m pytest -q tests/characterization tests/test_security.py tests/test_agent_output_formatting.py tests/test_prompt_changes_validation.py"
+coverage = "pytest --cov=src/tunacode --cov-report=term"
+
+# Building
+build = "python -m build"
+
+# Playwright utilities
+remove-playwright = "python scripts/playwright_cache.py remove"
+restore-playwright = "python scripts/playwright_cache.py restore"

{tunacode_cli-0.0.54 → tunacode_cli-0.0.56}/src/tunacode/cli/commands/__init__.py

@@ -7,6 +7,8 @@ This package provides a modular command system with:
 
 The main public API provides backward compatibility with the original
 commands.py module while enabling better organization and maintainability.
+
+CLAUDE_ANCHOR[commands-module]: Command registry and dispatch system
 """
 
 # Import base classes and infrastructure

tunacode_cli-0.0.56/src/tunacode/cli/commands/implementations/plan.py

@@ -0,0 +1,50 @@
+"""Plan mode commands for TunaCode."""
+
+from typing import List
+
+from ....types import CommandContext
+from ....ui import console as ui
+from ..base import Command, CommandCategory, CommandSpec, SimpleCommand
+
+
+class PlanCommand(SimpleCommand):
+    """Enter plan mode for read-only research and planning."""
+    
+    spec = CommandSpec(
+        name="plan",
+        aliases=["/plan"],
+        description="Enter Plan Mode - read-only research phase",
+        category=CommandCategory.DEVELOPMENT,
+    )
+    
+    async def execute(self, args: List[str], context: CommandContext) -> None:
+        """Enter plan mode."""
+        context.state_manager.enter_plan_mode()
+        
+        await ui.info("🔍 Entering Plan Mode")
+        await ui.info("• Only read-only operations available")
+        await ui.info("• Use tools to research and analyze the codebase")
+        await ui.info("• Use 'exit_plan_mode' tool to present your plan")
+        await ui.info("• Read-only tools: read_file, grep, list_dir, glob")
+        await ui.success("✅ Plan Mode active - indicator will appear above next input")
+
+
+class ExitPlanCommand(SimpleCommand):
+    """Exit plan mode manually."""
+    
+    spec = CommandSpec(
+        name="exit-plan",
+        aliases=["/exit-plan"],
+        description="Exit Plan Mode and return to normal mode",
+        category=CommandCategory.DEVELOPMENT,
+    )
+    
+    async def execute(self, args: List[str], context: CommandContext) -> None:
+        """Exit plan mode manually."""
+        if not context.state_manager.is_plan_mode():
+            await ui.warning("Not currently in Plan Mode")
+            return
+        
+        context.state_manager.exit_plan_mode()
+        await ui.success("🚪 Exiting Plan Mode - returning to normal mode")
+        await ui.info("✅ All tools are now available - '⏸ PLAN MODE ON' status removed")

{tunacode_cli-0.0.54 → tunacode_cli-0.0.56}/src/tunacode/cli/commands/registry.py

@@ -1,4 +1,7 @@
-"""Command registry and factory for TunaCode CLI commands."""
+"""Command registry and factory for TunaCode CLI commands.
+
+CLAUDE_ANCHOR[command-registry]: Central command registration and execution
+"""
 
 from dataclasses import dataclass
 from typing import Any, Dict, List, Optional, Type
@@ -20,6 +23,7 @@ from .implementations.debug import (
 )
 from .implementations.development import BranchCommand, InitCommand
 from .implementations.model import ModelCommand
+from .implementations.plan import ExitPlanCommand, PlanCommand
 from .implementations.system import (
     ClearCommand,
     HelpCommand,
@@ -126,6 +130,8 @@ class CommandRegistry:
             InitCommand,
             TemplateCommand,
             TodoCommand,
+            PlanCommand,        # Add plan command
+            ExitPlanCommand,    # Add exit plan command
         ]
 
         # Register all discovered commands