tunacode-cli 0.0.78.14__tar.gz → 0.1.24__tar.gz

{tunacode_cli-0.0.78.14 → tunacode_cli-0.1.24}/.github/pull_request_template.md

@@ -13,7 +13,7 @@
 
 ## Testing
 <!-- Describe the tests you ran to verify your changes -->
-- [ ] All existing tests pass (`hatch run test`)
+- [ ] All existing tests pass (`uv run pytest`)
 - [ ] New tests have been added to cover the changes
 - [ ] Tests have been run locally
 - [ ] Golden/character tests established for new features

tunacode_cli-0.1.24/.github/workflows/lint.yml

@@ -0,0 +1,20 @@
+name: Lint
+
+on:
+  pull_request:
+  push:
+    branches: [main, master]
+
+jobs:
+  pre-commit:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - uses: astral-sh/setup-uv@v4
+      - name: Install dependencies
+        run: uv sync --extra dev --frozen
+      - name: Run pre-commit
+        run: uv run pre-commit run --all-files

{tunacode_cli-0.0.78.14 → tunacode_cli-0.1.24}/.github/workflows/publish-release.yml

@@ -22,7 +22,7 @@ jobs:
       - name: Install build tooling
         run: |
           python -m pip install --upgrade pip
-          pip install hatch twine uv ruff pytest pytest-cov pytest-asyncio
+          pip install build twine ruff pytest pytest-cov pytest-asyncio
 
       - name: Install project dependencies
         run: pip install -e '.[dev]'
@@ -63,7 +63,7 @@ jobs:
           fi
 
       - name: Build
-        run: hatch build
+        run: python -m build
 
       # Preferred: API token secret
       - name: Publish to PyPI (API token)

{tunacode_cli-0.0.78.14 → tunacode_cli-0.1.24}/.gitignore

@@ -32,7 +32,6 @@ venv/
 ENV/
 .env
 .deploy_venv/
-uv.lock
 
 # IDE files
 .idea/
@@ -79,3 +78,6 @@ node_modules/
 
 # Task files
 vendor/
+.beads/
+.osgrep
+.osgrep*

{tunacode_cli-0.0.78.14 → tunacode_cli-0.1.24}/.pre-commit-config.yaml

@@ -4,7 +4,7 @@ default_language_version:
   python: python3
 
 # Global exclusions to prevent hooks from scanning unnecessary directories
-exclude: ^(venv/|build/|dist/|\.git/|__pycache__/|.*\.egg-info/|\.pytest_cache/|\.mypy_cache/|\.ruff_cache/|htmlcov/|\.coverage|reports/|llm-agent-tools/)
+exclude: ^(venv/|build/|dist/|\.git/|__pycache__/|.*\.egg-info/|\.pytest_cache/|\.mypy_cache/|\.ruff_cache/|\.uv-cache/|\.uv_cache/|htmlcov/|\.coverage|reports/|llm-agent-tools/)
 
 repos:
   # Pre-commit framework hooks
@@ -39,11 +39,11 @@ repos:
 
   # Ruff - Fast Python linter and formatter
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.8.6
+    rev: v0.14.9
     hooks:
       - id: ruff
         args: ['--fix', '--show-fixes']
-      # - id: ruff-format  # Disabled - hatch-lint already handles formatting
+      - id: ruff-format  # Re-enabled - ruff handles linting, ruff-format handles formatting
 
   # Type checking with mypy
   - repo: https://github.com/pre-commit/mirrors-mypy
@@ -59,20 +59,9 @@ repos:
 
 
   # Local hooks for project-specific checks
-  # Strategy: Use 'hatch run' for commands defined in pyproject.toml scripts
-  #          Use 'uv run' for standalone tools not managed by hatch environments
   - repo: local
     hooks:
-      # Hatch-managed commands (use hatch run for consistency)
-      - id: hatch-lint
-        name: Run hatch lint check
-        entry: hatch run lint
-        language: system
-        pass_filenames: false
-        always_run: true
-        stages: [pre-commit]
-
-      # UV-managed standalone tools (not in hatch environments)
+      # UV-managed tools
       - id: dead-imports
         name: Check for unused imports in changed files
         entry: scripts/run-dead-imports.sh
@@ -88,15 +77,6 @@ repos:
         exclude: ^(tests/|test_)
         stages: [pre-commit]
 
-      # Run test suite using hatch for consistency
-      - id: run-tests
-        name: Run test suite
-        entry: .venv/bin/pytest
-        language: system
-        pass_filenames: false
-        always_run: true
-        stages: [pre-commit]
-
       # Check for common security issues
       - id: security-check
         name: Security audit
@@ -153,5 +133,5 @@ ci:
   autoupdate_commit_msg: '[pre-commit.ci] pre-commit autoupdate'
   autoupdate_schedule: weekly
   # Skip hooks that require project-specific environment setup
-  skip: [run-tests, hatch-lint, dead-imports, vulture-changed]
+  skip: [vulture-changed]
   submodules: false

tunacode_cli-0.1.24/AGENTS.md

@@ -0,0 +1,302 @@
+## Tunacode
+
+This project is tunacode, much like you! It's a TUI code agent that can be used to code and debug code or general agentic tasks.
+
+src/tunacode/ui is the TUI interface that is used to interact with the user.
+src/tunacode/core is the core agent that is used to code and debug code or general agentic tasks.
+src/tunacode/tools is the tools that are used to code and debug code or general agentic tasks.
+
+Tests are located in the `tests/` directory covering tool decorators, tool conformance, compaction, and tool retry logic.
+
+## Design Philosophy
+
+The TUI design is heavily inspired by the classic **NeXTSTEP** user interface. This choice reflects a commitment to **"the next step of uniformity"**.
+
+- **Uniformity:** The interface should provide a consistent and predictable experience across all interactions.
+- **User Informed:** A core tenet is to keep the user constantly informed of the agent's state, actions, and reasoning. No "magic" should happen in the background without visual feedback.
+- **Aesthetic:** The look should be professional, clean, and retro-modern, echoing the clarity and object-oriented nature of the NeXTSTEP environment.
+
+**UI Design Rule:** Always call the neXTSTEP-ui skill for any UI changes.
+
+**Skill Location:** `.claude/skills/neXTSTEP-ui/`
+
+- `SKILL.md` - Design philosophy and guidelines
+- `NeXTSTEP_User_Interface_Guidelines_Release_3_Nov93.pdf` - Original 198-page reference
+- `read_pdf.py` - Chunked PDF reader (`uv run python read_pdf.py --help`)
+
+## Workflow Rules
+
+- Never begin coding until the objective is **explicitly defined**. If unclear, ask questions or use best practices.
+- Always use `.venv` and `uv` for package management.
+- Small, focused diffs only. Commit frequently.
+
+## Code Style & Typing
+
+- Enforce `ruff check --fix .` before PRs.
+- Use explicit typing. `cast(...)` and `assert ...` are OK.
+- `# type: ignore` only with strong justification.
+- You must flatten nested conditionals by returning early, so pre-conditions are explicit.
+- If it is never executed, remove it. You MUST make sure what we remove has been committed before in case we need to rollback.
+- Normalize symmetries: you must make identical things look identical and different things look different for faster pattern-spotting.
+- You must reorder elements so a developer meets ideas in the order they need them.
+- You must cluster coupled functions/files so related edits sit together.
+- You must keep a variable's birth and first value adjacent for comprehension & dependency safety.
+- Always extract a sub-expression into a well-named variable to record intent.
+- Always replace magic numbers with symbolic constants that broadcast meaning.
+- Never use magic literals; symbolic constants are preferred.
+- ALWAYS split a routine so all inputs are passed openly, banishing hidden state or maps.
+
+## Error Handling
+
+- Fail fast, fail loud. No silent fallbacks. This is one of the most important rules to follow.
+- Minimize branching: every `if`/`try` must be justified.
+
+## Dependencies
+
+- Avoid new core dependencies. Tiny deps OK if widely reused.
+- Run tests with: `uv run pytest`.
+
+## Scope & Maintenance
+
+- Backward compatibility only if low maintenance cost.
+- Delete dead code (never guard it).
+- Always run `ruff .`.
+- Use `git commit -n` if pre-commit hooks block rollback.
+
+---
+
+## Card Format
+
+Bugs, docs, and module cards all use this unified structure.
+
+### Frontmatter
+
+```yaml
+---
+title: <Short human-readable title>
+link: <stable-slug-for-links>
+type: <delta | doc | module>
+path: <relative path, for modules/docs>
+depth: <nesting level, 0 = root>
+seams: <[A] architecture | [E] entry | [M] module | [S] state | [D] data>
+ontological_relations:
+  - relates_to: [[<primary-system-or-area>]]
+  - affects: [[<component-or-module>]]
+  - fixes: [[<bug-or-failure-mode>]] # for deltas
+tags:
+  - <area>
+  - <symptom>
+  - <tool-or-feature>
+created_at: <ISO-8601 timestamp>
+updated_at: <ISO-8601 timestamp>
+uuid: <generated-uuid>
+---
+```
+
+### Body Sections
+
+- **Summary** - One paragraph, what and why, readable in a year
+- **Context** - Optional, where it lives, how it surfaced
+- **Root Cause** - For bugs: mechanism, not blame
+- **Changes** - Bullet list of concrete changes
+- **Behavioral Impact** - What users notice, what didn't change
+- **Related Cards** - `[[links]]` to other cards
+
+### Bug Rules
+
+- Fix it, we don't care who caused it
+- Document: what? where? when? why?
+- No shims, fix at root
+- Document how we missed it and how to prevent it
+
+---
+
+## Quality Gates
+
+These are another layer to prevent slop, not pre-commit hooks.
+
+### Gate 0: No Shims
+
+Never use shims. It is a mortal sin to allow shims.
+
+Instead, fix the interface. In some cases, it may be better to create a new interface for examples:
+
+- If 19 files use an interface and our new work has a problem with it, the interface is not the problem
+- If only two files use the interface and it's giving us issues, write it correctly
+- The interface must be written in proper idiomatic way
+- 99% of the time we don't need a unique interface; if a unique situation calls for one, it must be strongly justified with anchor comments
+
+### Gate 1: Coupling and Cohesion (Constantine)
+
+**High cohesion** = everything in a module serves one purpose
+**Low coupling** = modules don't need to know each other's internals
+
+Before writing or modifying code, answer:
+
+- **What single responsibility does this module have?** If you can't state it in one sentence, the module is doing too much. Split until each piece has one job.
+- **Can I change this module without changing others?** If no, you have a coupling problem.
+- **Dependencies should flow one direction:** ui → core → tools → utils/types. Never reach backward (core importing from ui).
+- **How many dots?** `state_manager.session.tool_handler._policy.rules[0].name = "allow"` coupling points. Each `.` is a place where changes can break you. More than 2 dots = smell; refactor to hide the chain.
+- **What does this module hide?** "Every module hides a design decision that could change." If a module exposes its internals, it will churn when those internals change. UI hides Textual, core hides agent orchestration, tools hide system access.
+
+**Example:** If a file gets touched more than 5 times in a month, it has a cohesion problem. Stop adding to it. Split it.
+
+**Wrong:**
+
+```
+src/tunacode/ui/main.py  →  Textual UI + agent orchestration + tool execution + persistence
+```
+
+**Right:**
+
+```
+src/tunacode/ui/main.py              →  Textual UI concerns only
+src/tunacode/core/agents/main.py     →  agent orchestration only
+src/tunacode/tools/*.py              →  tool execution only
+src/tunacode/core/state.py           →  persistence and session state only
+```
+
+### Gate 2: Dependency Direction (Martin)
+
+Dependencies flow inward, never backward.
+
+```
+ui → core → tools → utils/types
+  ↓
+infrastructure (filesystem, shell, network)
+```
+
+**Rules:**
+
+- Inner layers know nothing about outer layers
+  - core/ never imports from ui/
+  - tools/ never imports from ui/
+  - utils/ and types/ import from nothing
+- Infrastructure is a plugin
+  - Filesystem, shell, network = details
+  - Core logic doesn't know or care which system provider
+- Depend on abstractions, not concretions
+  - Pass interfaces, not implementations
+  - Makes testing trivial, swapping backends trivial
+
+**Example:** If core needs UI state, you're violating the boundary. Extract what you need and pass it as a plain argument.
+
+**Wrong:**
+
+```python
+from tunacode.ui.app import TunaCodeApp
+
+def run_agent(app: TunaCodeApp):
+    app.notify_status("Running")  # core knows about UI layer
+```
+
+**Right:**
+
+```python
+from collections.abc import Callable
+
+def run_agent(notify_status: Callable[[str], None]):
+    notify_status("Running")  # core only knows about a callable
+```
+
+### Gate 3: Design by Contract (Meyer)
+
+Every function is a contract with three parts:
+
+- **Preconditions** - what must be true before calling
+- **Postconditions** - what will be true after
+- **Invariants** - what's always true
+
+**Rules:**
+
+- Caller guarantees preconditions - don't check inside what should be guaranteed outside
+- Function guarantees postconditions - if it returns, the promise is kept
+- Fail immediately if contract violated - no limping along with bad state
+
+**Example:** If a tool expects a valid directory, don't silently return an empty result. That's a contract violation - raise.
+
+**Wrong:**
+
+```python
+def list_dir(directory: str) -> str | None:
+    if not Path(directory).exists():
+        return None  # silent failure, caller doesn't know why
+    return _render_dir(Path(directory))
+```
+
+**Right:**
+
+```python
+def list_dir(directory: str) -> str:
+    """Precondition: directory exists and is a directory."""
+    path = Path(directory)
+    if not path.exists():
+        raise FileNotFoundError(f"Directory not found: {path}")
+    if not path.is_dir():
+        raise NotADirectoryError(f"Not a directory: {path}")
+    return _render_dir(path)
+```
+
+### Gate 4: Documentation is Code (Knuth)
+
+Docs and code are one system. If they diverge, the docs are lying.
+
+**Rules:**
+
+- **Code changes = doc changes**
+  - If you change a module's behavior, update its codebase-map doc in the same PR
+  - If you add a tool, update docs/codebase-map/modules/tools-overview.md
+  - If you add a UI component, update docs/codebase-map/modules/ui-overview.md
+- **Docs describe the system that exists, not the system you wish existed**
+  - No aspirational docs ("we plan to...")
+  - No stale docs ("this used to...")
+  - Only current truth
+- **The /docs/codebase-map folder mirrors src/tunacode**
+  - Structure matches structure
+  - When code moves, docs move
+  - When code dies, docs die
+
+**Example:** If you delete src/tunacode/tools/grep.py, you must also remove its entry from docs/codebase-map/modules/tools-overview.md in the same commit.
+
+**Wrong:**
+
+```
+PR #263: "chore: remove unused grep tool"
+  - deletes src/tunacode/tools/grep.py
+  - leaves docs/codebase-map/modules/tools-overview.md still referencing it
+```
+
+**Right:**
+
+```
+PR #263: "chore: remove unused grep tool"
+  - deletes src/tunacode/tools/grep.py
+  - updates docs/codebase-map/modules/tools-overview.md to remove grep section
+  - single atomic commit, code and docs together
+```
+
+---
+
+## Memory Bank Directory
+
+Maintain a `.claude/markdown` directory with:
+
+- **metadata/** — dependency graphs, file classifications, error pattern database
+- **code_index/** — function call graphs, type relationships, interface mappings
+- **debug_history/** — error-solution pairs indexed by component/error type
+- **patterns/** — canonical implementation examples for this codebase
+- **cheatsheets/** — quick-reference guides per component with gotchas
+- **qa/** — solved problems database with reasoning
+- **delta/** — semantic changelogs explaining changes
+
+### Continuous Learning
+
+Dump bugs, smells, issues here as you encounter them. Raw is fine. A skill will organize this into proper kb entries later.
+
+Format: `[date] [type] description`
+
+Types: bug, smell, pattern, lesson, antipattern
+
+---
+
+We are currently in the middle of a large rewrite few test exist and documentation and that is okay. We will build the test and documentation as we go

tunacode_cli-0.1.24/CHANGELOG.md

@@ -0,0 +1,155 @@
+## [Unreleased]
+
+## [0.1.20] - 2026-01-02
+
+### Added
+- Lazy-load models registry and guardrail picker for faster startup
+- UI refinements and research documentation (#204)
+- neXTSTEP UI guidelines PDF and reader skill
+- Discord server link to README (#194)
+- Consolidated default prompt document
+
+### Fixed
+- Headless run output extraction (#208)
+- Base URL overrides and CLI baseurl flag (#200)
+- File size handling refactoring (#155, #154)
+- TOOL_VIEWPORT_LINES and DEFAULT_IGNORE_PATTERNS_COUNT (#197)
+
+### Changed
+- Refactor headless output extraction to dedicated module
+- Remove dead code: callbacks.py, 3 unused UI components (#205), 35 unused constants (#206)
+- Refactor types.py to package structure
+- Replace magic numbers with symbolic constants
+- Reduce MIN_VIEWPORT_LINES to 5 for more compact tool panels
+- Uniform tool panel width with fixed TOOL_PANEL_WIDTH
+
+### Contributors
+Thanks to our community contributors:
+- @ryumacodes - issue fixes and standardization
+
+## [0.1.16] - 2025-12-19
+
+### Added
+- Minimum viewport padding to tool panels for better readability (#192) - thanks @larock22
+- Standardized tool panel viewport sizing across all renderers (#190)
+
+### Fixed
+- Eliminate UI freezes during update_file operations
+- LSP diagnostics truncation and hardened diff rendering (#191)
+- Tool return arg hydration issue (#189)
+
+### Changed
+- Remove inline comments from LSP module for cleaner code
+
+### Contributors
+Thanks to our community contributors for this release:
+- @larock22 - viewport padding improvements and subagent loading states
+- @ryumacodes - update command implementation
+
+## [0.1.12] - 2025-12-18
+
+### Fixed
+- Prevent TUI hangs when rendering large tool confirmation diffs (e.g., `write_file` with minified content)
+
+## [0.1.11] - 2025-12-18
+
+### Added
+- `/update` command to check for and install updates from TUI (#182) - thanks @ryumacodes
+- TodoWrite and TodoRead tools for task tracking (#181)
+- LSP status indicator in resource bar showing server name
+- Switched Python LSP from pyright to ruff for better integration
+
+### Fixed
+- Paste buffer flow with improved user input wrapping (#188)
+- LSP diagnostics display with NeXTSTEP 4-zone layout (#186)
+- Escape key now cancels shell command input (#187)
+- Paste indicator shows inline with "..." for continued content
+
+### Changed
+- Simplify concatenated JSON parsing with fail-loud error handling (#175)
+- Reduced streaming throttle for smoother output
+- Refactored app.py under 600 lines
+
+## [0.1.10] - 2025-12-16
+
+### Added
+- Subagent UI loading states with progress feedback (#180)
+- Tool start callback for UI feedback (#177)
+- Headless CLI mode for benchmark execution (#174)
+
+### Fixed
+- Default tunacode to TUI when no subcommand (#178)
+- Pass parent state_manager to research agent for API key access (#170)
+
+### Changed
+- Pin ruff to 0.14.9 (#179)
+- Remove unused GUIDE_FILE_PATTERN constant (#173)
+- Remove unused typing scaffolding from state transition (#171)
+
+## [0.1.9] - 2025-12-12
+
+### Added
+- Multi-line paste support with collapsed display (#168)
+
+### Changed
+- Refactored watch_value editor for better single responsibility (#169)
+- Export screen classes from ui/screens package for external access
+
+## [0.1.7] - 2025-12-11
+
+### Added
+- NeXTSTEP-style tool panel renderers for consistent UI (#165)
+- web_fetch tool for HTTP GET with HTML-to-text conversion
+- list_dir tree connectors for better directory visualization
+- Section-based prompting engine with template composition
+- Slash command autocompletion in TUI (#160) - thanks @coltonsteinbeck
+- Model-specific context window from registry (#158) - thanks @vincitamore
+
+### Changed
+- Tightened XML prompt loading (#164)
+- Removed Python loggers in favor of structured output (#159) - thanks @xan
+
+### Contributors
+Thanks to our community contributors for this release:
+- @coltonsteinbeck - slash command autocompletion
+- @xan - logger cleanup
+- @vincitamore - model context windows
+- @ryu - real pricing and Textual repl improvements
+
+## [0.1.6] - 2025-12-08
+
+### Added
+- Session resume feature (`/resume`) to restore previous conversation sessions
+- Write file preview in confirmation dialog showing file contents before creation
+- CONTRIBUTING.md for open source contributors
+
+### Changed
+- Consolidated ruff config and removed redundant .ruffignore
+- Removed stale documentation and knowledge base files
+- Removed unused command security constants and XML schema loader
+
+## [0.1.5] - 2025-12-07
+
+### Added
+- CHANGELOG.md for tracking version history
+- Enhanced update_file tool with diff preview and result display
+
+### Fixed
+- Additional lint error fixes
+
+## [0.1.4] - 2025-12-06
+
+### Added
+- Tool execution retry mechanism with exponential backoff (max 3 attempts) for improved reliability
+- Clear diff display for edit tool operations showing before/after changes
+- Uniform truncation with NeXTSTEP information hierarchy for better UX
+- Dynamic startup index with progressive loading for faster application launch
+
+### Changed
+- Improved error handling to surface retries to user with visual feedback
+- Removed dead code and consolidated ToolCallback type alias
+- Fixed 40+ ruff lint errors for cleaner codebase
+
+### Fixed
+- Edit tool now provides proper visual feedback showing what changed in files
+- Tool execution failures no longer halt system immediately, allowing retry attempts