tunacode-cli 0.0.76.4__tar.gz → 0.0.76.9__tar.gz

{tunacode_cli-0.0.76.4 → tunacode_cli-0.0.76.9}/.claude/delta_summaries/behavior_changes.json

@@ -123,8 +123,7 @@
         "Routed CLI REPL agent imports through tunacode.core.agents to expose helper mocks",
         "Extended check_task_completion to accept legacy TUNACODE_TASK_COMPLETE marker"
       ]
-    }
-    ,
+    },
     {
       "id": "cli-fuzzy-matching-20250922-120500",
       "time": "2025-09-22T12:05:00",
@@ -137,8 +136,7 @@
         "Zero new dependencies; minimal code change localized to CommandRegistry.find_matching_commands",
         "Added tests to characterize prefix behavior and validate fuzzy suggestions for typos"
       ]
-    }
-    ,
+    },
     {
       "id": "file-ref-completer-dir-browse-20250922-122900",
       "time": "2025-09-22T12:29:00",
@@ -149,6 +147,56 @@
         "FileReferenceCompleter now treats a bare directory prefix without trailing slash as browsing inside that directory (e.g., '@tests' shows files inside tests/).",
         "Behavior and ordering preserved: exact files > fuzzy files > exact dirs > fuzzy dirs; existing case-insensitive exact matching and fuzzy improvements remain."
       ]
+    },
+    {
+      "id": "cli-fuzzy-removal-20250924-150600",
+      "time": "2025-09-24T15:06:00",
+      "branch": "current",
+      "base": "current",
+      "head": "current",
+      "bullets": [
+        "Removed difflib-backed fuzzy fallback from CommandRegistry.find_matching_commands; prefix-only matching restored.",
+        "Deleted shared fuzzy_utils helper module and characterization test covering fuzzy suggestions.",
+        "Simplified FileReferenceCompleter to rely on case-insensitive prefix ordering (files before directories).",
+        "Updated documentation and metadata to reflect removal of fuzzy matching implementation."
+      ]
+    },
+    {
+      "id": "cli-fuzzy-reintegration-20250924-181500",
+      "time": "2025-09-24T18:15:00",
+      "branch": "current",
+      "base": "current",
+      "head": "current",
+      "bullets": [
+        "Wired prompt_toolkit FuzzyWordCompleter into CommandCompleter and FileReferenceCompleter for typo-tolerant suggestions.",
+        "Restored CLI fuzzy characterization tests validating command and @file completions.",
+        "Adjusted test harness to load real prompt_toolkit modules instead of stubs when available.",
+        "Updated changelog, TODO, and research notes to document the prompt toolkit-based fuzzy implementation."
+      ]
+    },
+    {
+      "id": "merge-fuzzy-touchup-20250925-125158",
+      "time": "2025-09-25T12:51:58",
+      "branch": "fuzzy-touchup",
+      "base": "master",
+      "head": "master",
+      "bullets": [
+        "Merged fuzzy-touchup: refined file reference heuristics and fuzzy fixes",
+        "Accepted branch versions for conflicts in registry and completers",
+        "Reintroduced CLI fuzzy characterization test"
+      ]
+    },
+    {
+      "id": "release-0.0.76.5-20250925-125611",
+      "time": "2025-09-25T12:56:11",
+      "branch": "master",
+      "base": "v0.0.76.4",
+      "head": "v0.0.76.5",
+      "bullets": [
+        "Release v0.0.76.5: merged fuzzy-touchup branch",
+        "Bumped versions in pyproject and constants",
+        "Created GitHub release to trigger publish workflow"
+      ]
     }
   ]
-}
+}

{tunacode_cli-0.0.76.4 → tunacode_cli-0.0.76.9}/.claude/memory_anchors/anchors.json

@@ -1,6 +1,6 @@
 {
   "version": 2,
-  "generated": "2025-01-05",
+  "generated": "2025-09-24T16:12:08Z",
   "description": "Memory anchors are now embedded in source files as CLAUDE_ANCHOR[key] comments",
   "session_history": [
     {
@@ -151,14 +151,59 @@
       "kind": "line",
       "description": "Renamed release workflow so GitHub Actions executes the Ruff lint/test pipeline without cached definitions and pins Python 3.12 for Hatch stability",
       "status": "active"
-    }
-    ,{
+    },
+    {
       "anchor_key": "model-command-registry-validation-skip",
       "path": "tests/characterization/test_characterization_commands.py",
       "line": 73,
       "kind": "line",
       "description": "Characterization test bypasses registry.load() to avoid Pydantic validation failures from cached API data (e.g., zero limits). Preserves intent to display current model info.",
       "status": "active"
+    },
+    {
+      "anchor_key": "86cc1a41",
+      "path": "src/tunacode/cli/commands/registry.py",
+      "line": 317,
+      "kind": "line",
+      "description": "Prefix-only command matching after removing fuzzy fallback",
+      "status": "active",
+      "created": "2025-09-24T15:05:39Z"
+    },
+    {
+      "anchor_key": "1f0911c7",
+      "path": "src/tunacode/ui/completers.py",
+      "line": 176,
+      "kind": "line",
+      "description": "Prompt Toolkit fuzzy matching consolidates file and directory suggestions",
+      "status": "active",
+      "created": "2025-09-24T15:29:42Z"
+    },
+    {
+      "key": "0b3f320e",
+      "path": "src/tunacode/ui/path_heuristics.py",
+      "line": 7,
+      "kind": "line",
+      "description": "Cross-ecosystem skip directory defaults for FileReferenceCompleter global roots",
+      "status": "active",
+      "created": "2025-09-24T16:08:12Z"
+    },
+    {
+      "key": "6fd59413",
+      "path": "src/tunacode/ui/path_heuristics.py",
+      "line": 22,
+      "kind": "line",
+      "description": "Skip list includes __pycache__ to avoid noisy Python build artifacts in suggestions",
+      "status": "active",
+      "created": "2025-09-24T16:10:11Z"
+    },
+    {
+      "key": "2bcebd52",
+      "path": "src/tunacode/ui/path_heuristics.py",
+      "line": 31,
+      "kind": "line",
+      "description": "Skip heuristic checks every path component to prune nested junk directories such as __pycache__",
+      "status": "active",
+      "created": "2025-09-24T16:12:08Z"
     }
   ]
-}
+}

{tunacode_cli-0.0.76.4 → tunacode_cli-0.0.76.9}/.claude/metadata/file_classifications.json

@@ -145,16 +145,6 @@
       "type": "test",
       "category": "tools",
       "classification": "test"
-    },
-    "src/tunacode/cli/commands/registry.py": {
-      "type": "source",
-      "category": "commands",
-      "classification": "implementation"
-    },
-    "tests/characterization/test_cli_fuzzy_matching.py": {
-      "type": "test",
-      "category": "commands",
-      "classification": "test"
     }
   }
 }

{tunacode_cli-0.0.76.4 → tunacode_cli-0.0.76.9}/AGENTS.md

@@ -96,8 +96,6 @@ Docs → model-friendly explanations of purposes & relationships.
 Delta Summaries → record API/behavior shifts with reasoning.
 
 Memory Anchors → embed UUID-tagged semantic anchors in code.
-you MUST use this tool to drop anchors: python3 knowledge_base/tools/anchor_drop.py <file> <line> <description> to mark important locations
-   with UUID-based comments stored in .claude/memory_anchors/anchors.json
 ---
 
 ### Example##\#

{tunacode_cli-0.0.76.4 → tunacode_cli-0.0.76.9}/CLAUDE.md

@@ -91,8 +91,6 @@ Rules:
 * Docs → model-friendly explanations of purposes & relationships.
 * Delta Summaries → record API/behavior shifts with reasoning.
 * Memory Anchors → embed UUID-tagged semantic anchors in code.
-you MUST use this tool to drop anchors: python3 knowledge_base/tools/anchor_drop.py <file> <line> <description> to mark important locations
-   with UUID-based comments stored in .claude/memory_anchors/anchors.json
 * Keeep entries nonverbose and distilled to the core implemenation for the next dev. You will be punished for not following these instructions.
 
 

{tunacode_cli-0.0.76.4 → tunacode_cli-0.0.76.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tunacode-cli
-Version: 0.0.76.4
+Version: 0.0.76.9
 Summary: Your agentic CLI developer.
 Project-URL: Homepage, https://tunacode.xyz/
 Project-URL: Repository, https://github.com/alchemiststudiosDOTai/tunacode

{tunacode_cli-0.0.76.4 → tunacode_cli-0.0.76.9}/TODO.md

@@ -1,18 +1,18 @@
-# Current Issue
+# Prompt Toolkit Fuzzy Reintegration
 
-@-mentions only show directories first, then files. Need fuzzy-first file matching for patterns like `testexampl.py`.
+Fuzzy-first matching resumed on 2025-09-24 using prompt_toolkit's native fuzzy completers. Notes below capture the revived implementation plan and historical context for further refinement.
 
 ---
 
-## Architecture Analysis
+## Architecture Analysis (current state)
 
-- `src/tunacode/ui/completers.py:70-128`: Current `FileReferenceCompleter` uses basic `startswith()` matching.
-- `src/tunacode/cli/commands/registry.py:305-327`: Fuzzy matching exists for commands using `difflib.get_close_matches`.
-- `src/tunacode/utils/models_registry.py`: Advanced fuzzy matching using `difflib.SequenceMatcher`.
+- `src/tunacode/ui/completers.py:23-74`: `CommandCompleter` wraps registry commands with `FuzzyWordCompleter` for near-miss suggestions.
+- `src/tunacode/ui/completers.py:80-164`: `FileReferenceCompleter` blends exact prefix ordering with fuzzy scoring for files then directories.
+- `src/tunacode/utils/models_registry.py`: Continues to expose `SequenceMatcher`-based fuzzy similarity for models.
 
 ---
 
-## Minimal Implementation Strategy
+## Minimal Implementation Strategy (archived plan)
 
 1. **Create Shared Fuzzy Utility**
    - File: `src/tunacode/utils/fuzzy_utils.py`

{tunacode_cli-0.0.76.4 → tunacode_cli-0.0.76.9}/documentation/changelog/CHANGELOG.md

@@ -5,6 +5,23 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.0.76.8] - 2025-09-25
+
+### Fixed
+- Ensure PyPI package version matches tag by bumping project metadata to 0.0.76.8
+
+## [0.0.76.6] - 2025-09-25
+
+### Fixed
+- CI Lint: formatted path_heuristics.py to satisfy ruff format
+- Release: re-tag to include formatting fix
+
+## [0.0.76.5] - 2025-09-25
+
+### Changed
+- Merge fuzzy-touchup branch: refined fuzzy matching and file reference heuristics
+- Release process: version bump and CI publish workflow used
+
 ## [0.0.76.4] - 2025-09-25
 
 ### Added
@@ -24,20 +41,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased] - 2025-09-22
 
 ### Added
-- **Enhanced File Reference Completion** - Fuzzy-first matching for @mentions with smart directory browsing
-- **Fuzzy CLI Command Matching** - CLI suggests closest commands when no exact/prefix match
 - **Models Registry Pydantic Conversion** - Complete conversion to Pydantic BaseModel with validation
 - **RAG Tooling** - SQLite FTS5 index for .claude/ knowledge base search and indexing
 - **Comprehensive Validation Tests** - Added golden baseline tests and validation edge cases
+- **Prompt Toolkit Fuzzy Completers** - Wrapped command and @file completers with native fuzzy matching for typo tolerance
 
 ### Changed
-- **File Reference Ordering** - New priority: exact files > fuzzy files > exact dirs > fuzzy dirs
+- **File Reference Ordering** - Re-established fuzzy priority: exact files > fuzzy files > exact dirs > fuzzy dirs
 - **Bare Directory Browsing** - Type `@dir` (without trailing slash) to browse directory contents
 - **Code Style Guidelines** - Updated CLAUDE.md with improved coding patterns and best practices
 - **Models Registry Validation** - Added constraints for non-negative costs and positive limits
 
 ### Fixed
-- **Unused Import Removal** - Removed unused Iterable import from fuzzy_utils.py
 - **Validation Edge Cases** - Enhanced registry validation for model loading scenarios
 
 ## [0.0.76.2] - 2025-09-19

{tunacode_cli-0.0.76.4 → tunacode_cli-0.0.76.9}/documentation/development/hatch-build-system.md

@@ -19,7 +19,6 @@ uv install hatch
 uv venv
 
 # Install development dependencies
-# MEMORY-ANCHOR: dev-setup-2025-09-22-current
 source .venv/bin/activate && uv pip install -e ".[dev]"
 
 # Run the application

tunacode_cli-0.0.76.9/memory-bank/plan/2025-09-24_cli_prompt_toolkit_fuzzy_plan.md

@@ -0,0 +1,89 @@
+# Plan – Prompt Toolkit Fuzzy Completion Reintegration
+**Date:** 2025-09-24
+**Owner:** Claude Coding Agent
+**Status:** Draft
+
+**Progress Snapshot (2025-09-24 18:20 UTC)**
+- Red ✅ – Characterization tests recreated and failing baseline captured.
+- Green ✅ – prompt_toolkit fuzzy completions implemented; targeted tests pass via `uv run`.
+- Blue ▢ – Refactor/documentation cleanup and broader regression testing still pending.
+
+## 1. Objective & Success Criteria
+- Reintroduce fuzzy matching for command names and @file references using `prompt_toolkit`'s native fuzzy completers (`FuzzyCompleter`, `FuzzyWordCompleter`).
+- Deliver behavior that restores typo tolerance and mid-string matching while preserving existing prefix ordering expectations.
+- Avoid introducing new source modules; limit scope to targeted edits with clear fail-fast semantics and explicit typing.
+
+Success is measured by:
+1. A green characterization test capturing fuzzy suggestions for both slash commands and @file references.
+2. Manually verified CLI experience showing fuzzy suggestions ordered ahead of less-relevant results without performance regressions.
+3. Updated documentation and knowledge base entries reflecting the renewed behavior.
+
+## 1.1 Existing Prompt Toolkit Usage (proof)
+- `src/tunacode/ui/completers.py:6-16` already imports `prompt_toolkit.completion` classes and integrates them into the CLI completer pipeline.
+- `src/tunacode/ui/prompt_manager.py:6-12` builds the primary prompt session using `prompt_toolkit` components (`PromptSession`, `KeyBindings`, `Completer`).
+- `src/tunacode/ui/model_selector.py:5-21` constructs a rich TUI with `prompt_toolkit` layout primitives, confirming the library underpins current interactive flows.
+- `src/tunacode/cli/repl.py:11-32` depends on `prompt_toolkit.application.run_in_terminal` to coordinate CLI rendering, demonstrating tight integration today.
+
+## 2. Implementation Surfaces (no new files)
+| Area | File | Change Intent |
+| --- | --- | --- |
+| Command registry completer wiring | `src/tunacode/cli/commands/registry.py` | Inject `FuzzyCompleter` around existing command lists when building the prompt-toolkit completer, while keeping fallback error handling fail-fast. |
+| REPL command completion bootstrap | `src/tunacode/cli/repl.py` & `src/tunacode/ui/completers.py` | Introduce prompt toolkit fuzzy wrappers for both slash-command and file reference completers; ensure ordering logic stays explicit and hidden state removed. |
+| UI completers | `src/tunacode/ui/completers.py` | Refactor `CommandCompleter`/`FileReferenceCompleter` to delegate fuzzy scoring to `prompt_toolkit`, extracting symbolic constants for cutoffs and match limits. |
+| Metadata & anchors | `.claude/memory_anchors/anchors.json`, `.claude/delta_summaries/behavior_changes.json` | Update anchors to capture new fuzzy integration touch-points; document behavior shift.
+| Documentation | `documentation/changelog/CHANGELOG.md`, `TODO.md`, `memory-bank/research/2025-09-24_fuzzy_logic_implementation_analysis.md` | Refresh changelog/TODO to reflect reintroduction; append research updates.
+
+## 3. Test-First Strategy (single failing test)
+- Add characterization test `tests/characterization/test_cli_fuzzy_matching.py::TestPromptToolkitFuzzy::test_fuzzy_suggests_command` that spins up the CLI completer, feeds a typo like `"/hep"`, and asserts the fuzzy candidate list includes `/help` while prefix-only logic would fail.
+- Extend same test module with `test_fuzzy_file_reference_prioritizes_files` to verify `@tst_example.py` suggests `test_example.py` via fuzzy selection, ensuring files precede directories.
+- Run the new test in isolation with `uv run --python .venv/bin/python -m pytest tests/characterization/test_cli_fuzzy_matching.py` expecting RED initially.
+
+## 4. Execution Timeline (TDD Red → Green → Blue)
+1. **Red**
+   - Recreate `tests/characterization/test_cli_fuzzy_matching.py` with updated prompt-toolkit based expectations.
+   - Exercise CLI completer wiring without touching implementation to confirm failure.
+2. **Green**
+   - Layer `FuzzyCompleter` around command and file completers; expose configuration constants.
+   - Verify green by re-running the isolated test, then full suite via `uv run hatch run test` to confirm no regressions.
+3. **Blue**
+   - Refine duplicated logic, extract helper functions where intent is repeated, and update documentation/metadata/anchors.
+
+**Cross-ecosystem follow-ups (deferred):**
+- Auto-prioritise roots by inspecting ecosystem markers (e.g., `package.json`, `CMakeLists.txt`) instead of hard-coding Python paths.
+- Extend ignore lists to cover `node_modules`, `build`, `dist`, `target`, and other non-Python artifacts.
+- Consider optional metadata-driven weighting so language-specific extensions (.js/.ts, .cpp/.hpp) bubble up appropriately.
+
+## 5. Risks & Mitigations
+- **Performance degradation with large command/file sets** → Use `ThreadedCompleter` if latency is observed; document fallback in TODO.
+- **Inconsistent ordering vs. historical expectations** → Maintain explicit post-processing to enforce file-before-dir rules.*
+- **Prompt Toolkit version drift** → Confirm current version supports `FuzzyCompleter` and capture requirement in research note if upgrade needed.
+
+## 6. Open Questions
+1. Should we gate fuzzy behavior behind a user config flag for power users who prefer prefix-only matching?
+2. Do we need to resurrect additional fuzzy tests (e.g., for models registry) or limit surface area to CLI interactions?
+3. Are there accessibility considerations (e.g., highlight styling) that require Rich integration updates?
+
+## 7. Next Immediate Action
+- Implement RED step: restore the characterization test, then execute `uv run --python .venv/bin/python -m pytest tests/characterization/test_cli_fuzzy_matching.py` to capture the failing baseline before touching implementation code.
+
+*Maintain file-before-directory ordering by combining prompt-toolkit fuzzy scoring with deterministic post-sort tied to symbolic constants.
+
+
+ - Clarify Objective: Target a detection + weighting layer that broadens ecosystem coverage while keeping current Python-first flow intact when nothing else matches.
+   okay again this is the issue we dont know whart codin g languae they will use 
+
+- Inventory Current State: Document today’s hardcoded paths/skip lists in src/tunacode/ui/completers.py so we know exactly what must stay as the Python fallback.
+  - Introduce Ecosystem Schema: Define a small EcosystemProfile dataclass or typed dict storing markers, roots, skips, extensions, metadata tags; start with just
+  Python + JS/TS + C++ to keep diff tiny.
+  - Add Detection Utility: Implement _detect_ecosystem() that walks upward a bounded depth, counts marker hits per profile, and returns the best match (ties fall back
+  to Python profile). Cache result on the completer instance.
+  - Refactor Root/Skip Providers: Swap the current module-level constants for a profile = self._detect_or_default() call that feeds priority roots, skip prefixes, and
+  extension sets into the existing traversal logic. Preserve ordering rules from the behavior change log.
+  - Lightweight Metadata Hook: When building Completion, append the profile’s metadata hint if defined for the file extension; no UI overhaul required.
+  - Optional Config Ingestion: Allow a simple TOML override (e.g., .tunacode-completer.toml) that merges into the selected profile. Keep parsing isolated so it can be
+  skipped if file absent.
+  - Testing Strategy: Extend characterization tests with tmpdir fixtures for JS and C++ layouts; ensure Python baseline stays green. Cover config override and no-
+  marker fallback. Run via hatch run test.
+  - Knowledge Base Updates: Plan to record new anchors around detection logic, refresh .claude/semantic_index/function_call_graphs.json, and log behavior/API shifts in
+  delta_summaries/behavior_changes.json once code lands.
+

tunacode_cli-0.0.76.9/memory-bank/research/2025-09-24_fuzzy_logic_implementation_analysis.md

@@ -0,0 +1,96 @@
+# Research – Fuzzy Logic Implementation Analysis
+**Date:** 2025-09-24
+**Owner:** Claude Research Agent
+**Phase:** Research
+
+## Goal
+Summarize all *existing knowledge* about fuzzy logic implementation before making changes to support first-class fuzzy matching with @t syntax.
+
+## Status Update (2025-09-24)
+- CLI fuzzy fallback and @file fuzzy completion were removed on the safe branch to retire accumulated tech debt. This document now serves as a historical reference for any future reintroduction work.
+- Shared helper `src/tunacode/utils/fuzzy_utils.py` and characterization test `tests/characterization/test_cli_fuzzy_matching.py` were deleted; changelog and metadata record the regression to prefix-only behavior.
+- Prompt toolkit-native fuzzy completions were reintroduced on 2025-09-24, wiring `FuzzyWordCompleter` into `CommandCompleter` and `FileReferenceCompleter` with fresh characterization tests capturing the new behavior.
+
+## Additional Search
+- `grep -ri "fuzzy" .claude/` - Found behavior changes and file classifications
+- RAG search revealed CLI fuzzy matching enhancement details
+
+Post-removal verification confirmed updated changelog entry (`documentation/changelog/CHANGELOG.md`) and new delta summary (`.claude/delta_summaries/behavior_changes.json`) documenting the rollback.
+
+## Findings
+
+### Removed CLI/File components (2025-09-24 early session)
+- `src/tunacode/utils/fuzzy_utils.py` → Deleted module that wrapped `difflib.get_close_matches`.
+- `src/tunacode/cli/commands/registry.py` → Fuzzy fallback removed; command matching temporarily reverted to prefix-only with anchor `86cc1a41` marking the change.
+- `src/tunacode/ui/completers.py` → Fuzzy ordering removed; completion relied on case-insensitive prefixes until prompt toolkit reintegration.
+- `tests/characterization/test_cli_fuzzy_matching.py` → Deleted golden coverage for CLI fuzzy suggestions ahead of prompt toolkit rewrite.
+
+### Reintroduced surfaces (2025-09-24 late session)
+- `tests/characterization/test_cli_fuzzy_matching.py` → Recreated characterization tests covering prompt toolkit fuzzy suggestions for slash commands and @file references.
+- `src/tunacode/ui/completers.py` → Adopted `FuzzyWordCompleter` for both command and file completions, maintaining explicit ordering guarantees.
+- `tests/conftest.py` → Adjusted to honor real prompt_toolkit modules when installed, ensuring tests exercise genuine fuzzy completers.
+
+### Remaining fuzzy usage
+- `src/tunacode/utils/models_registry.py:114-132` → Still employs `SequenceMatcher` for model similarity scoring; untouched by the rollback.
+
+## Key Patterns / Solutions Found
+
+### Historical CLI/File architecture (removed 2025-09-24)
+- **Two-tier matching**: Exact/prefix matches first, fuzzy fallback second.
+- **Multiple fuzzy algorithms**: `get_close_matches` (CLI) + `SequenceMatcher` (models).
+- **Priority ordering**: exact files > fuzzy files > exact dirs > fuzzy dirs.
+- **Case-insensitive matching** with original case preservation.
+
+### Algorithm Details (historical CLI behavior)
+- **difflib.get_close_matches**: Previously used Ratcliff/Obershelp pattern matching for CLI fallbacks
+- **Cutoff threshold**: 0.75 similarity ratio (configurable)
+- **Result limits**: 3 for CLI, 10 for file completions
+- **Zero external dependencies**: Uses only Python standard library
+
+### Command System Overview (post-removal)
+- **@file references**: Include file contents (`@filename.ext`)
+- **@dir references**: Directory expansion (`@dirname/` or `@dirname/**`)
+- **Slash commands**: Markdown-based commands in `.claude/commands/`
+- **File completion**: Case-insensitive prefix matching (fuzzy support removed)
+
+## Knowledge Gaps
+
+### Missing Context for First-Class Fuzzy Implementation
+- **@t syntax specification**: How should @t behave differently from current @file?
+- **Priority algorithm details**: What factors determine file priority beyond name matching?
+- **Performance requirements**: Need for caching/indexing vs real-time fuzzy matching
+- **User experience expectations**: Should @t show matches immediately or require confirmation?
+- **Integration points**: How to replace current prefix-first approach with fuzzy-first
+
+### Technical Considerations
+- **Backward compatibility**: Current system preserves prefix behavior - breaking changes needed
+- **File discovery scope**: Current code index vs full filesystem search
+- **Memory/performance tradeoffs**: Caching strategies for frequent @t usage
+- **Configuration options**: User customization of cutoff thresholds and result limits
+
+## References
+
+### Implementation Files
+- `src/tunacode/cli/commands/registry.py` - Historical fuzzy fallback implementation (removed; see anchor `86cc1a41`).
+- `src/tunacode/ui/completers.py` - Historical fuzzy ordering implementation (removed).
+- `src/tunacode/utils/models_registry.py` - Still provides advanced similarity scoring for models.
+
+### Test Files
+- `tests/characterization/test_cli_fuzzy_matching.py` - Historical characterization test (deleted 2025-09-24).
+- `tests/unit/utils/test_models_registry.py` - Model registry fuzzy matching tests (still valid).
+
+### Documentation
+- `memory-bank/research/2025-09-22_12-01-06_cli_fuzzy_logic_analysis.md` - Previous fuzzy logic analysis
+- `.claude/delta_summaries/behavior_changes.json` - Historical enhancement, 2025-09-24 removal entry, and prompt toolkit reintegration log
+- `.claude/memory_anchors/anchors.json` - Memory anchors tracking removal (key `86cc1a41`) and new prompt toolkit fuzzy anchors
+
+### Configuration
+- `.claude/metadata/file_classifications.json` - Historical classification entries updated with restored CLI fuzzy test coverage
+
+## Next Steps Recommendations
+
+1. **Define @t specification** (if reintroducing fuzzy behavior): Clarify exact behavior and user experience expectations.
+2. **Design priority algorithm**: Determine ranking factors for file matches, acknowledging the previous fuzzy-first experiment.
+3. **Plan migration strategy**: Outline how to reintroduce fuzzy logic without regressing current prefix guarantees.
+4. **Performance testing**: Evaluate fuzzy matching performance characteristics before any future rollout.
+5. **User feedback integration**: Capture how users would prefer disambiguation when fuzzy suggestions return.

tunacode_cli-0.0.76.9/plan-models.md

@@ -0,0 +1,60 @@
+# Models Registry Pydantic Conversion Plan
+
+## Phase 1: Characterization Tests (Red)
+
+1. **Create Golden Baseline Tests**
+   - Create `tests/unit/utils/test_models_registry.py`
+   - Test current dataclass behavior and field access patterns
+   - Test the complex `_parse_data()` method with various inputs
+   - Test all method signatures (`format_display()`, `matches_search()`, etc.)
+   - Test fallback data loading and parsing
+
+2. **Integration Characterization**
+   - Document current error handling behavior (silent fallbacks)
+   - Test field access patterns used by dependent components
+   - Verify current serialization/deserialization behavior
+
+## Phase 2: Pydantic Conversion (Green)
+
+3. **Convert Data Classes to Pydantic Models**
+   - Replace `@dataclass` with `BaseModel` for all 5 classes
+   - Add proper validation rules (non-negative costs, positive limits)
+   - Preserve all existing methods and properties
+   - Ensure backward compatibility for field access
+
+4. **Update Parsing Logic**
+   - Simplify `_parse_data()` method using Pydantic validation
+   - Remove manual type checking code
+   - Add proper error handling for validation failures
+   - Validate hardcoded fallback data
+
+5. **Update Dependencies**
+   - Update 4 dependent files (`completers.py`, `input.py`, `model_selector.py`, `model.py`)
+   - Ensure all imports and field access patterns work with Pydantic models
+   - Test integration points still function correctly
+
+## Phase 3: Validation and Testing (Blue)
+
+6. **Create Validation Tests**
+   - Test Pydantic validation scenarios (invalid costs, negative limits)
+   - Test error handling with malformed data
+   - Test type coercion behavior
+   - Test backward compatibility
+
+7. **Manual Confirmation**
+   - Run existing test suite to ensure no regressions
+   - Test CLI model selection functionality manually
+   - Verify UI components still work correctly
+   - Check performance impact on model loading
+
+---
+
+### Success Criteria
+
+- All existing tests pass
+- New validation tests pass
+- Field access patterns preserved
+- Method signatures unchanged
+- Parsing logic simplified from 66 lines to ~20 lines
+- Proper validation errors raised for invalid data
+- Performance impact < 10%

{tunacode_cli-0.0.76.4 → tunacode_cli-0.0.76.9}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "hatchling.build"
 [project]
 name = "tunacode-cli"
 
-version = "0.0.76.4"
+version = "0.0.76.9"
 description = "Your agentic CLI developer."
 keywords = ["cli", "agent", "development", "automation"]
 readme = "README.md"
@@ -170,7 +170,7 @@ typecheck = "mypy src/"
 security = "bandit -r src/ -ll"
 
 # Version management
-version = "0.0.76.4"
+version = "0.0.76.9"
 
 # Release workflow
 release = [

{tunacode_cli-0.0.76.4 → tunacode_cli-0.0.76.9}/src/tunacode/cli/commands/registry.py

@@ -5,7 +5,6 @@ CLAUDE_ANCHOR[command-registry]: Central command registration and execution
 
 import logging
 from dataclasses import dataclass
-from difflib import get_close_matches
 from pathlib import Path
 from typing import Any, Dict, List, Optional, Type
 
@@ -315,16 +314,12 @@ class CommandRegistry:
         self.discover_commands()
         partial = partial_command.lower()
 
-        # 1) Prefer prefix matches (preserves current behavior)
+        # CLAUDE_ANCHOR[key=86cc1a41] Prefix-only command matching after removing fuzzy fallback
         prefix_matches = [cmd for cmd in self._commands.keys() if cmd.startswith(partial)]
         if prefix_matches:
             return prefix_matches
 
-        # 2) Fuzzy fallback for typos and near-misses
-        # CLAUDE_ANCHOR[fuzzy-command-matching]: Fuzzy fallback using difflib
-        # Keep minimal change: reuse built-ins, avoid new deps.
-        fuzzy = get_close_matches(partial, list(self._commands.keys()), n=3, cutoff=0.75)
-        return fuzzy
+        return []
 
     def is_command(self, text: str) -> bool:
         """Check if text starts with a registered command (supports partial matching)."""

{tunacode_cli-0.0.76.4 → tunacode_cli-0.0.76.9}/src/tunacode/cli/main.py

@@ -19,7 +19,7 @@ from tunacode.ui import console as ui
 from tunacode.utils.system import check_for_updates
 
 app_settings = ApplicationSettings()
-app = typer.Typer(help="TunaCode - OS AI-powered CLI Coding Tool")
+app = typer.Typer(help="TunaCode - OS AI-powered development assistant")
 state_manager = StateManager()
 
 

{tunacode_cli-0.0.76.4 → tunacode_cli-0.0.76.9}/src/tunacode/constants.py

@@ -9,7 +9,7 @@ from enum import Enum
 
 # Application info
 APP_NAME = "TunaCode"
-APP_VERSION = "0.0.76.4"
+APP_VERSION = "0.0.76.9"
 
 
 # File patterns