puaros/packages/ipuaro/CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[0.6.0] - 2025-12-01 - Edit Tools

Added

• EditLinesTool (0.6.1)

  • edit_lines(path, start, end, content): Replace lines in a file
  • Hash conflict detection (prevents editing externally modified files)
  • Confirmation required with diff preview
  • Automatic storage update after edit
  • 35 unit tests

• CreateFileTool (0.6.2)

  • create_file(path, content): Create new file with content
  • Automatic directory creation if needed
  • Path validation (must be within project root)
  • Prevents overwriting existing files
  • Confirmation required before creation
  • 26 unit tests

• DeleteFileTool (0.6.3)

  • delete_file(path): Delete file from filesystem and storage
  • Removes file data, AST, and meta from Redis
  • Confirmation required with file content preview
  • 20 unit tests

Changed

• Total tests: 664 (was 540)
• Coverage: 97.71% lines, 91.89% branches
• Coverage thresholds: 95% lines/functions/statements, 90% branches

---

[0.5.0] - 2025-12-01 - Read Tools

Added

• ToolRegistry (0.5.1)

  • IToolRegistry implementation for managing tool lifecycle
  • Methods: register(), unregister(), get(), getAll(), getByCategory(), has()
  • execute(): Tool execution with validation and confirmation flow
  • getToolDefinitions(): Convert tools to LLM-compatible JSON Schema format
  • Helper methods: getConfirmationTools(), getSafeTools(), getNames(), clear()
  • 34 unit tests

• GetLinesTool (0.5.2)

  • get_lines(path, start?, end?): Read file lines with line numbers
  • Reads from Redis storage or filesystem fallback
  • Line number formatting with proper padding
  • Path validation (must be within project root)
  • 25 unit tests

• GetFunctionTool (0.5.3)

  • get_function(path, name): Get function source by name
  • Uses AST to find exact line range
  • Returns metadata: isAsync, isExported, params, returnType
  • Lists available functions if target not found
  • 20 unit tests

• GetClassTool (0.5.4)

  • get_class(path, name): Get class source by name
  • Uses AST to find exact line range
  • Returns metadata: isAbstract, extends, implements, methods, properties
  • Lists available classes if target not found
  • 19 unit tests

• GetStructureTool (0.5.5)

  • get_structure(path?, depth?): Get directory tree
  • ASCII tree output with 📁/📄 icons
  • Filters: node_modules, .git, dist, coverage, etc.
  • Directories sorted before files
  • Stats: directory and file counts
  • 23 unit tests

Changed

• Total tests: 540 (was 419)
• Coverage: 96%+

---

[0.4.0] - 2025-11-30 - LLM Integration

Added

• OllamaClient (0.4.1)

  • Full ILLMClient implementation for Ollama SDK
  • Chat completion with tool/function calling support
  • Token counting via estimation (Ollama has no tokenizer API)
  • Model management: pullModel(), hasModel(), listModels()
  • Connection status check: isAvailable()
  • Request abortion support: abort()
  • Error handling with IpuaroError for connection and model errors
  • 21 unit tests

• System Prompt & Context Builder (0.4.2)

  • SYSTEM_PROMPT: Comprehensive agent instructions with tool descriptions
  • buildInitialContext(): Generates compact project overview from structure and ASTs
  • buildFileContext(): Detailed file context with imports, exports, functions, classes
  • truncateContext(): Token-aware context truncation
  • Hub/entry point/complexity flags in file summaries
  • 17 unit tests

• Tool Definitions (0.4.3)

  • 18 tool definitions across 6 categories:
    • Read: get_lines, get_function, get_class, get_structure
    • Edit: edit_lines, create_file, delete_file
    • Search: find_references, find_definition
    • Analysis: get_dependencies, get_dependents, get_complexity, get_todos
    • Git: git_status, git_diff, git_commit
    • Run: run_command, run_tests
  • Category groupings: READ_TOOLS, EDIT_TOOLS, etc.
  • CONFIRMATION_TOOLS set for tools requiring user approval
  • Helper functions: requiresConfirmation(), getToolDef(), getToolsByCategory()
  • 39 unit tests

• Response Parser (0.4.4)

  • XML tool call parsing: <tool_call name="...">...</tool_call>
  • Parameter extraction from XML elements
  • Type coercion: boolean, number, null, JSON arrays/objects
  • extractThinking(): Extracts <thinking>...</thinking> blocks
  • hasToolCalls(): Quick check for tool call presence
  • validateToolCallParams(): Parameter validation against required list
  • formatToolCallsAsXml(): Tool calls to XML for prompt injection
  • 21 unit tests

Changed

• Total tests: 419 (was 321)
• Coverage: 96.38%

---

[0.3.1] - 2025-11-30

Added

• VERSION export - Package version is now exported from index.ts, automatically read from package.json via createRequire

Changed

• 🔄 Refactored ASTParser - Reduced complexity and nesting depth:
  • Extracted extractClassHeritage(), parseHeritageClause(), findTypeIdentifier(), collectImplements() helper methods
  • Max nesting depth reduced from 5 to 4
• 🔄 Refactored RedisStorage - Removed unnecessary type parameter from parseJSON() method

Quality

• ✅ Zero lint warnings - All ESLint warnings resolved
• ✅ All 321 tests pass

[0.3.0] - 2025-11-30 - Indexer

Added

• FileScanner (0.3.1)

  • Recursive directory scanning with async generator
  • .gitignore support via globby (replaced ignore package for ESM compatibility)
  • Filters: binary files, node_modules, dist, default ignore patterns
  • Progress callback for UI integration
  • isTextFile() and readFileContent() static utilities
  • 22 unit tests

• ASTParser (0.3.2)

  • Tree-sitter based parsing for TS, TSX, JS, JSX
  • Extracts: imports, exports, functions, classes, interfaces, type aliases
  • Import classification: internal, external, builtin (using node:module builtinModules)
  • Graceful error handling with partial AST on syntax errors
  • 30 unit tests

• MetaAnalyzer (0.3.3)

  • Complexity metrics: LOC (excluding comments), nesting depth, cyclomatic complexity, overall score
  • Dependency resolution: internal imports resolved to absolute file paths
  • Dependents calculation: reverse dependency lookup across all project files
  • File type classification: source, test, config, types, unknown
  • Entry point detection: index files, main/app/cli/server patterns, files with no dependents
  • Hub detection: files with >5 dependents
  • Batch analysis via analyzeAll() method
  • 54 unit tests

• IndexBuilder (0.3.4)

  • SymbolIndex: maps symbol names to locations for quick lookup (functions, classes, interfaces, types, variables)
  • Qualified names for class methods: ClassName.methodName
  • DepsGraph: bidirectional import mapping (imports and importedBy)
  • Import resolution: handles .js → .ts, index.ts, directory imports
  • findSymbol(): exact symbol lookup
  • searchSymbols(): regex-based symbol search
  • findCircularDependencies(): detect import cycles
  • getStats(): comprehensive index statistics (symbols by type, hubs, orphans)
  • 35 unit tests

• Watchdog (0.3.5)

  • File watching with chokidar (native events + polling fallback)
  • Debounced change handling (configurable, default 500ms)
  • Event types: add, change, unlink
  • Extension filtering (default: SUPPORTED_EXTENSIONS)
  • Ignore patterns (default: DEFAULT_IGNORE_PATTERNS)
  • Multiple callback support
  • flushAll() for immediate processing
  • Silent error handling for stability
  • 21 unit tests

• Infrastructure Constants

  • tree-sitter-types.ts: NodeType and FieldName constants for tree-sitter
  • Eliminates magic strings in ASTParser

• Dependencies

  • Added globby for ESM-native file globbing
  • Removed ignore package (CJS incompatibility with nodenext)

Changed

• Refactored ASTParser to use constants instead of magic strings
• Total tests: 321
• Coverage: 96.43%

---

[0.2.0] - 2025-01-30

Added

• Redis Storage (0.2.x milestone)

  • RedisClient: connection wrapper with AOF persistence configuration
  • RedisStorage: full IStorage implementation with Redis hashes
  • Redis key schema: project files, AST, meta, indexes, config
  • Session keys schema: data, undo stack, sessions list
  • generateProjectName() utility for consistent project naming

• Infrastructure Layer

  • src/infrastructure/storage/ module
  • Exports via src/infrastructure/index.ts

• Testing

  • 68 new unit tests for Redis module
  • 159 total tests
  • 99% code coverage maintained

Changed

• Updated ESLint config: @typescript-eslint/no-unnecessary-type-parameters set to warn

Notes

Redis Storage milestone complete. Next: 0.3.0 - Indexer (FileScanner, AST Parser, Watchdog)

[0.1.0] - 2025-01-29

Added

• Project Setup

  • package.json with all dependencies (ink, ioredis, tree-sitter, ollama, etc.)
  • tsconfig.json for ESM + React JSX
  • tsup.config.ts for bundling
  • vitest.config.ts with 80% coverage threshold
  • CLI entry point (bin/ipuaro.js)

• Domain Layer

  • Entities: Session, Project
  • Value Objects: FileData, FileAST, FileMeta, ChatMessage, ToolCall, ToolResult, UndoEntry
  • Service Interfaces: IStorage, ILLMClient, ITool, IIndexer
  • Constants: supported extensions, ignore patterns, context limits

• Application Layer

  • IToolRegistry interface
  • Placeholder structure for use cases and DTOs

• Shared Module

  • Config schema with Zod validation
  • Config loader (default.json + .ipuaro.json)
  • IpuaroError class with typed errors
  • Utility functions: md5 hash, token estimation
  • Result type for error handling

• CLI

  • Basic commands: start, init, index (placeholders)
  • Commander.js integration

• Testing

  • 91 unit tests
  • 100% code coverage

Notes

This is the foundation release. The following features are planned for upcoming versions:

• 0.2.0: Redis Storage
• 0.3.0: Indexer
• 0.4.0: LLM Integration
• 0.5.0+: Tools implementation
• 0.10.0+: TUI and session management