tunacode-cli 0.0.55__tar.gz → 0.0.57__tar.gz

{tunacode_cli-0.0.55 → tunacode_cli-0.0.57}/CLAUDE.md

@@ -1,46 +1,22 @@
-### 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
-
-- 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
 
+- **CRITICAL: WORKTREE REQUIREMENT** - When user requests a worktree, you MUST:
+  1. Create the worktree with `git worktree add -b branch-name ../dirname`
+  2. If access is blocked, immediately ask: "I cannot access the worktree directory. Should I: a) Work in a subdirectory instead, b) Use a branch in the main directory, or c) Another solution?"
+  3. NEVER proceed without a worktree if user specifically requested one
+
 - 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
+- To use `llm-agent-tools/scratchpad-multi.sh`, start a task with `./llm-agent-tools/scratchpad-multi.sh --agent <name> start "Task Title"` and record updates using `step`, `revise <N>`, and `branch <N>`. When complete, run `finish` to interactively archive the scratchpad to `documentation/` and/or `.claude/` (a backup is stored under `.claude/scratchpad/shared/done_tasks/`).
 
 - 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
+- pre-commit hooks can NOT be skipped, you will be punished for skipping the,
 
 ```
 # Implementing Authentication Module
@@ -66,6 +42,38 @@ _Agent: default_
 
 - 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
 
+### 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
+
+- "hatch run 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
+
+
+
 ## Available Agents:
 
 1. **bug-context-analyzer** - Investigates precise context around bugs without suggesting fixes

{tunacode_cli-0.0.55/src/tunacode_cli.egg-info → tunacode_cli-0.0.57}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tunacode-cli
-Version: 0.0.55
+Version: 0.0.57
 Summary: Your agentic CLI developer.
 Author-email: larock22 <noreply@github.com>
 License: MIT
@@ -29,6 +29,7 @@ Requires-Dist: rich==14.0.0
 Requires-Dist: tiktoken>=0.5.2
 Provides-Extra: dev
 Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
 Requires-Dist: ruff; extra == "dev"
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
@@ -39,6 +40,10 @@ 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"
+Requires-Dist: defusedxml; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: bandit; extra == "dev"
 Dynamic: license-file
 
 # TunaCode CLI
@@ -106,7 +111,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 +248,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.55 → tunacode_cli-0.0.57}/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.55 → tunacode_cli-0.0.57}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "tunacode-cli"
 
-version = "0.0.55"
+version = "0.0.57"
 description = "Your agentic CLI developer."
 keywords = ["cli", "agent", "development", "automation"]
 readme = "README.md"
@@ -40,6 +40,7 @@ tunacode = "tunacode.cli.main:app"
 [project.optional-dependencies]
 dev = [
     "build",
+    "twine",
     "ruff",
     "pytest",
     "pytest-cov",
@@ -50,6 +51,10 @@ dev = [
     "unimport>=1.0.0",
     "autoflake>=2.0.0",
     "dead>=1.5.0",
+    "hatch>=1.6.0",
+    "defusedxml",
+    "mypy",
+    "bandit",
 ]
 
 [project.urls]
@@ -146,3 +151,121 @@ warn_no_return = true
 follow_imports = "silent"
 # Allow CLAUDE_ANCHOR comments in docstrings
 disable_error_code = ["annotation-unchecked"]
+
+[tool.hatch.envs.default]
+installer = "uv"
+features = ["dev"]
+
+[tool.hatch.envs.default.scripts]
+# Development
+install = "pip install -e '.[dev]'"
+run = "python -m tunacode"
+dev = "python -m tunacode"
+test = "pytest -q tests/characterization tests/test_security.py tests/test_agent_output_formatting.py tests/test_prompt_changes_validation.py"
+test-script = "echo 'Test script works'"
+
+# Type checking and security
+typecheck = "mypy src/"
+security = "bandit -r src/ -ll"
+
+# Version management
+version = "0.0.57"
+
+# Release workflow
+release = [
+    "hatch run test",
+    "hatch run lint-check",
+    "hatch build",
+    "echo 'Ready to publish with: hatch publish'"
+]
+
+# 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
+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"
+
+# Hatch Environment Configurations
+
+[tool.hatch.envs.test]
+dependencies = [
+    "pytest",
+    "pytest-cov",
+    "pytest-asyncio",
+]
+
+[tool.hatch.envs.test.scripts]
+run = "pytest -q tests/characterization tests/test_security.py tests/test_agent_output_formatting.py tests/test_prompt_changes_validation.py"
+all = "pytest tests/"
+coverage = "pytest --cov=src/tunacode --cov-report=term"
+
+[tool.hatch.envs.lint]
+dependencies = [
+    "ruff",
+    "mypy",
+    "bandit",
+    "vulture",
+]
+
+[tool.hatch.envs.lint.scripts]
+check = [
+    "ruff check .",
+    "ruff format --check .",
+    "mypy src/",
+    "bandit -r src/ -ll",
+]
+
+[tool.hatch.envs.py310]
+python = "3.10"
+
+[tool.hatch.envs.py311]
+python = "3.11"
+
+[tool.hatch.envs.py312]
+python = "3.12"
+
+[tool.hatch.envs.py313]
+python = "3.13"

tunacode_cli-0.0.57/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 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.55 → tunacode_cli-0.0.57}/src/tunacode/cli/commands/registry.py

@@ -23,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,
@@ -129,6 +130,8 @@ class CommandRegistry:
             InitCommand,
             TemplateCommand,
             TodoCommand,
+            PlanCommand,  # Add plan command
+            ExitPlanCommand,  # Add exit plan command
         ]
 
         # Register all discovered commands