feat(ipuaro): implement v0.1.0 foundation

- Project setup with tsup, vitest, ESM support - Domain entities: Session, Project - Value objects: FileData, FileAST, FileMeta, ChatMessage, ToolCall, ToolResult, UndoEntry - Service interfaces: IStorage, ILLMClient, ITool, IIndexer, IToolRegistry - Shared: Config (zod), IpuaroError, utils (hash, tokens), Result type - CLI with placeholder commands (start, init, index) - 91 unit tests with 100% coverage - Fix package scope @puaros -> @samiyev in CLAUDE.md
2025-12-27 23:06:54 +05:00 · 2025-11-29 23:08:38 +05:00
parent 7f6180df37
commit 130a8c4f24
62 changed files with 4629 additions and 6 deletions
--- a/packages/ipuaro/CHANGELOG.md
+++ b/packages/ipuaro/CHANGELOG.md
@@ -0,0 +1,51 @@
+# Changelog
+
+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.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
--- a/packages/ipuaro/README.md
+++ b/packages/ipuaro/README.md
@@ -0,0 +1,130 @@
+# @samiyev/ipuaro
+
+Local AI agent for codebase operations with "infinite" context feeling through lazy loading.
+
+## Features
+
+- 18 LLM tools for code operations (read, edit, search, analysis, git, run)
+- Redis persistence with AOF for durability
+- tree-sitter AST parsing (TypeScript, JavaScript)
+- Ollama LLM integration (local, private)
+- File watching for live index updates
+- Session and undo management
+- Security (blacklist/whitelist for shell commands)
+- Terminal UI with Ink/React
+
+## Installation
+
+```bash
+npm install @samiyev/ipuaro
+# or
+pnpm add @samiyev/ipuaro
+```
+
+## Requirements
+
+- Node.js >= 20.0.0
+- Redis server (for persistence)
+- Ollama (for LLM inference)
+
+## Quick Start
+
+```bash
+# Start in current directory
+ipuaro
+
+# Start in specific directory
+ipuaro /path/to/project
+
+# With auto-apply mode
+ipuaro --auto-apply
+
+# With custom model
+ipuaro --model qwen2.5-coder:32b-instruct
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `ipuaro [path]` | Start TUI in directory |
+| `ipuaro init` | Create .ipuaro.json config |
+| `ipuaro index` | Index project without TUI |
+
+## Configuration
+
+Create `.ipuaro.json` in your project root:
+
+```json
+{
+    "redis": {
+        "host": "localhost",
+        "port": 6379
+    },
+    "llm": {
+        "model": "qwen2.5-coder:7b-instruct",
+        "temperature": 0.1
+    },
+    "edit": {
+        "autoApply": false
+    }
+}
+```
+
+## Architecture
+
+Clean Architecture with clear separation:
+
+```
+src/
+├── domain/          # Business logic (entities, value objects, interfaces)
+├── application/     # Use cases, DTOs, orchestration
+├── infrastructure/  # External implementations (Redis, Ollama, tools)
+├── tui/             # Terminal UI (Ink/React components)
+├── cli/             # CLI commands
+└── shared/          # Cross-cutting concerns
+```
+
+## Tools (18 total)
+
+| Category | Tool | Description |
+|----------|------|-------------|
+| **Read** | `get_lines` | Get file lines |
+| | `get_function` | Get function by name |
+| | `get_class` | Get class by name |
+| | `get_structure` | Get project tree |
+| **Edit** | `edit_lines` | Replace lines |
+| | `create_file` | Create new file |
+| | `delete_file` | Delete file |
+| **Search** | `find_references` | Find symbol usages |
+| | `find_definition` | Find symbol definition |
+| **Analysis** | `get_dependencies` | File imports |
+| | `get_dependents` | Files importing this |
+| | `get_complexity` | Complexity metrics |
+| | `get_todos` | Find TODO/FIXME |
+| **Git** | `git_status` | Repository status |
+| | `git_diff` | Uncommitted changes |
+| | `git_commit` | Create commit |
+| **Run** | `run_command` | Execute shell command |
+| | `run_tests` | Run test suite |
+
+## Development Status
+
+Currently at version **0.1.0** (Foundation). See [ROADMAP.md](./ROADMAP.md) for full development plan.
+
+### Completed
+
+- [x] 0.1.1 Project Setup
+- [x] 0.1.2 Domain Value Objects
+- [x] 0.1.3 Domain Services Interfaces
+- [x] 0.1.4 Shared Config
+
+### Next
+
+- [ ] 0.2.0 Redis Storage
+- [ ] 0.3.0 Indexer
+- [ ] 0.4.0 LLM Integration
+
+## License
+
+MIT
--- a/packages/ipuaro/TODO.md
+++ b/packages/ipuaro/TODO.md
@@ -0,0 +1,54 @@
+# ipuaro TODO
+
+## In Progress
+
+### Version 0.2.0 - Redis Storage
+- [ ] RedisClient with AOF config
+- [ ] Redis schema implementation
+- [ ] RedisStorage class
+
+## Planned
+
+### Version 0.3.0 - Indexer
+- [ ] FileScanner with gitignore support
+- [ ] ASTParser with tree-sitter
+- [ ] MetaAnalyzer for complexity
+- [ ] IndexBuilder for symbols
+- [ ] Watchdog for file changes
+
+### Version 0.4.0 - LLM Integration
+- [ ] OllamaClient implementation
+- [ ] System prompt design
+- [ ] Tool definitions (XML format)
+- [ ] Response parser
+
+### Version 0.5.0+ - Tools
+- [ ] Read tools (get_lines, get_function, get_class, get_structure)
+- [ ] Edit tools (edit_lines, create_file, delete_file)
+- [ ] Search tools (find_references, find_definition)
+- [ ] Analysis tools (get_dependencies, get_dependents, get_complexity, get_todos)
+- [ ] Git tools (git_status, git_diff, git_commit)
+- [ ] Run tools (run_command, run_tests)
+
+### Version 0.10.0+ - Session & TUI
+- [ ] Session management
+- [ ] Context compression
+- [ ] TUI components (StatusBar, Chat, Input, DiffView)
+- [ ] Slash commands (/help, /clear, /undo, etc.)
+
+## Technical Debt
+
+_None at this time._
+
+## Ideas for Future
+
+- Plugin system for custom tools
+- Multiple LLM providers (OpenAI, Anthropic)
+- IDE integration (LSP)
+- Web UI option
+- Parallel AST parsing
+- Response caching
+
+---
+
+**Last Updated:** 2025-01-29
--- a/packages/ipuaro/bin/ipuaro.js
+++ b/packages/ipuaro/bin/ipuaro.js
@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import "../dist/cli/index.js"
--- a/packages/ipuaro/package.json
+++ b/packages/ipuaro/package.json
@@ -0,0 +1,80 @@
+{
+    "name": "@samiyev/ipuaro",
+    "version": "0.1.0",
+    "description": "Local AI agent for codebase operations with infinite context feeling",
+    "author": "Fozilbek Samiyev <fozilbek.samiyev@gmail.com>",
+    "license": "MIT",
+    "type": "module",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "bin": {
+        "ipuaro": "./bin/ipuaro.js"
+    },
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
+        }
+    },
+    "files": [
+        "dist",
+        "bin"
+    ],
+    "scripts": {
+        "build": "tsup",
+        "watch": "tsup --watch",
+        "clean": "rm -rf dist",
+        "test": "vitest",
+        "test:run": "vitest run",
+        "test:coverage": "vitest run --coverage",
+        "test:ui": "vitest --ui",
+        "test:watch": "vitest --watch",
+        "lint": "eslint src --fix",
+        "format": "prettier --write src"
+    },
+    "dependencies": {
+        "ink": "^4.4.1",
+        "ink-text-input": "^5.0.1",
+        "react": "^18.2.0",
+        "ioredis": "^5.4.1",
+        "tree-sitter": "^0.21.1",
+        "tree-sitter-typescript": "^0.21.2",
+        "tree-sitter-javascript": "^0.21.0",
+        "ollama": "^0.5.11",
+        "simple-git": "^3.27.0",
+        "chokidar": "^3.6.0",
+        "commander": "^11.1.0",
+        "zod": "^3.23.8",
+        "ignore": "^5.3.2"
+    },
+    "devDependencies": {
+        "@types/node": "^22.10.1",
+        "@types/react": "^18.2.0",
+        "vitest": "^1.6.0",
+        "@vitest/coverage-v8": "^1.6.0",
+        "@vitest/ui": "^1.6.0",
+        "tsup": "^8.3.5",
+        "typescript": "^5.7.2"
+    },
+    "engines": {
+        "node": ">=20.0.0"
+    },
+    "keywords": [
+        "ai",
+        "agent",
+        "codebase",
+        "llm",
+        "ollama",
+        "cli",
+        "terminal"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/samiyev/puaros.git",
+        "directory": "packages/ipuaro"
+    },
+    "bugs": {
+        "url": "https://github.com/samiyev/puaros/issues"
+    },
+    "homepage": "https://github.com/samiyev/puaros/tree/main/packages/ipuaro#readme"
+}
--- a/packages/ipuaro/src/application/dtos/index.ts
+++ b/packages/ipuaro/src/application/dtos/index.ts
@@ -0,0 +1,4 @@
+/*
+ * Application DTOs
+ * Will be implemented in version 0.10.0+
+ */
--- a/packages/ipuaro/src/application/index.ts
+++ b/packages/ipuaro/src/application/index.ts
@@ -0,0 +1,10 @@
+// Application Layer exports
+
+// Use Cases
+export * from "./use-cases/index.js"
+
+// DTOs
+export * from "./dtos/index.js"
+
+// Interfaces
+export * from "./interfaces/index.js"
--- a/packages/ipuaro/src/application/interfaces/IToolRegistry.ts
+++ b/packages/ipuaro/src/application/interfaces/IToolRegistry.ts
@@ -0,0 +1,51 @@
+import type { ITool, ToolContext } from "../../domain/services/ITool.js"
+import type { ToolResult } from "../../domain/value-objects/ToolResult.js"
+
+/**
+ * Tool registry interface.
+ * Manages registration and execution of tools.
+ */
+export interface IToolRegistry {
+    /**
+     * Register a tool.
+     */
+    register(tool: ITool): void
+
+    /**
+     * Get tool by name.
+     */
+    get(name: string): ITool | undefined
+
+    /**
+     * Get all registered tools.
+     */
+    getAll(): ITool[]
+
+    /**
+     * Get tools by category.
+     */
+    getByCategory(category: ITool["category"]): ITool[]
+
+    /**
+     * Check if tool exists.
+     */
+    has(name: string): boolean
+
+    /**
+     * Execute tool by name.
+     */
+    execute(name: string, params: Record<string, unknown>, ctx: ToolContext): Promise<ToolResult>
+
+    /**
+     * Get tool definitions for LLM.
+     */
+    getToolDefinitions(): {
+        name: string
+        description: string
+        parameters: {
+            type: "object"
+            properties: Record<string, { type: string; description: string }>
+            required: string[]
+        }
+    }[]
+}
--- a/packages/ipuaro/src/application/interfaces/index.ts
+++ b/packages/ipuaro/src/application/interfaces/index.ts
@@ -0,0 +1,2 @@
+// Application Interfaces
+export * from "./IToolRegistry.js"
--- a/packages/ipuaro/src/application/use-cases/index.ts
+++ b/packages/ipuaro/src/application/use-cases/index.ts
@@ -0,0 +1,4 @@
+/*
+ * Application Use Cases
+ * Will be implemented in version 0.10.0+
+ */
--- a/packages/ipuaro/src/cli/index.ts
+++ b/packages/ipuaro/src/cli/index.ts
@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+import { Command } from "commander"
+
+const program = new Command()
+
+program
+    .name("ipuaro")
+    .description("Local AI agent for codebase operations with infinite context feeling")
+    .version("0.1.0")
+
+program
+    .command("start")
+    .description("Start ipuaro TUI in the current directory")
+    .argument("[path]", "Project path", ".")
+    .option("--auto-apply", "Enable auto-apply mode for edits")
+    .option("--model <name>", "Override LLM model", "qwen2.5-coder:7b-instruct")
+    .action((path: string, options: { autoApply?: boolean; model?: string }) => {
+        const model = options.model ?? "default"
+        const autoApply = options.autoApply ?? false
+        console.warn(`Starting ipuaro in ${path}...`)
+        console.warn(`Model: ${model}`)
+        console.warn(`Auto-apply: ${autoApply ? "enabled" : "disabled"}`)
+        console.warn("\nNot implemented yet. Coming in version 0.11.0!")
+    })
+
+program
+    .command("init")
+    .description("Create .ipuaro.json config file")
+    .action(() => {
+        console.warn("Creating .ipuaro.json...")
+        console.warn("\nNot implemented yet. Coming in version 0.17.0!")
+    })
+
+program
+    .command("index")
+    .description("Index project without starting TUI")
+    .argument("[path]", "Project path", ".")
+    .action((path: string) => {
+        console.warn(`Indexing ${path}...`)
+        console.warn("\nNot implemented yet. Coming in version 0.3.0!")
+    })
+
+program.parse()
--- a/packages/ipuaro/src/domain/constants/index.ts
+++ b/packages/ipuaro/src/domain/constants/index.ts
@@ -0,0 +1,48 @@
+// Domain Constants
+
+export const MAX_UNDO_STACK_SIZE = 10
+
+export const SUPPORTED_EXTENSIONS = [
+    ".ts",
+    ".tsx",
+    ".js",
+    ".jsx",
+    ".json",
+    ".yaml",
+    ".yml",
+] as const
+
+export const BINARY_EXTENSIONS = [
+    ".png",
+    ".jpg",
+    ".jpeg",
+    ".gif",
+    ".ico",
+    ".svg",
+    ".woff",
+    ".woff2",
+    ".ttf",
+    ".eot",
+    ".mp3",
+    ".mp4",
+    ".webm",
+    ".pdf",
+    ".zip",
+    ".tar",
+    ".gz",
+] as const
+
+export const DEFAULT_IGNORE_PATTERNS = [
+    "node_modules",
+    "dist",
+    "build",
+    ".git",
+    ".next",
+    ".nuxt",
+    "coverage",
+    ".cache",
+] as const
+
+export const CONTEXT_WINDOW_SIZE = 128_000
+
+export const CONTEXT_COMPRESSION_THRESHOLD = 0.8
--- a/packages/ipuaro/src/domain/entities/Project.ts
+++ b/packages/ipuaro/src/domain/entities/Project.ts
@@ -0,0 +1,61 @@
+import { basename, dirname } from "node:path"
+
+/**
+ * Project entity representing an indexed codebase.
+ */
+export class Project {
+    readonly name: string
+    readonly rootPath: string
+    readonly createdAt: number
+    lastIndexedAt: number | null
+    fileCount: number
+    indexingInProgress: boolean
+
+    constructor(rootPath: string, createdAt?: number) {
+        this.rootPath = rootPath
+        this.name = Project.generateProjectName(rootPath)
+        this.createdAt = createdAt ?? Date.now()
+        this.lastIndexedAt = null
+        this.fileCount = 0
+        this.indexingInProgress = false
+    }
+
+    /**
+     * Generate project name from path.
+     * Format: {parent-folder}-{project-folder}
+     */
+    static generateProjectName(rootPath: string): string {
+        const projectFolder = basename(rootPath)
+        const parentFolder = basename(dirname(rootPath))
+
+        if (parentFolder && parentFolder !== ".") {
+            return `${parentFolder}-${projectFolder}`
+        }
+        return projectFolder
+    }
+
+    markIndexingStarted(): void {
+        this.indexingInProgress = true
+    }
+
+    markIndexingCompleted(fileCount: number): void {
+        this.indexingInProgress = false
+        this.lastIndexedAt = Date.now()
+        this.fileCount = fileCount
+    }
+
+    markIndexingFailed(): void {
+        this.indexingInProgress = false
+    }
+
+    isIndexed(): boolean {
+        return this.lastIndexedAt !== null
+    }
+
+    getTimeSinceIndexed(): number | null {
+        if (this.lastIndexedAt === null) {
+            return null
+        }
+        return Date.now() - this.lastIndexedAt
+    }
+}
--- a/packages/ipuaro/src/domain/entities/Session.ts
+++ b/packages/ipuaro/src/domain/entities/Session.ts
@@ -0,0 +1,120 @@
+import type { ChatMessage } from "../value-objects/ChatMessage.js"
+import type { UndoEntry } from "../value-objects/UndoEntry.js"
+import { MAX_UNDO_STACK_SIZE } from "../constants/index.js"
+
+/**
+ * Session statistics.
+ */
+export interface SessionStats {
+    /** Total tokens used */
+    totalTokens: number
+    /** Total time in milliseconds */
+    totalTimeMs: number
+    /** Number of tool calls made */
+    toolCalls: number
+    /** Number of edits applied */
+    editsApplied: number
+    /** Number of edits rejected */
+    editsRejected: number
+}
+
+/**
+ * Context state for the session.
+ */
+export interface ContextState {
+    /** Files currently in context */
+    filesInContext: string[]
+    /** Estimated token usage (0-1) */
+    tokenUsage: number
+    /** Whether compression is needed */
+    needsCompression: boolean
+}
+
+/**
+ * Session entity representing a chat session.
+ */
+export class Session {
+    readonly id: string
+    readonly projectName: string
+    readonly createdAt: number
+    lastActivityAt: number
+    history: ChatMessage[]
+    context: ContextState
+    undoStack: UndoEntry[]
+    stats: SessionStats
+    inputHistory: string[]
+
+    constructor(id: string, projectName: string, createdAt?: number) {
+        this.id = id
+        this.projectName = projectName
+        this.createdAt = createdAt ?? Date.now()
+        this.lastActivityAt = this.createdAt
+        this.history = []
+        this.context = {
+            filesInContext: [],
+            tokenUsage: 0,
+            needsCompression: false,
+        }
+        this.undoStack = []
+        this.stats = {
+            totalTokens: 0,
+            totalTimeMs: 0,
+            toolCalls: 0,
+            editsApplied: 0,
+            editsRejected: 0,
+        }
+        this.inputHistory = []
+    }
+
+    addMessage(message: ChatMessage): void {
+        this.history.push(message)
+        this.lastActivityAt = Date.now()
+
+        if (message.stats) {
+            this.stats.totalTokens += message.stats.tokens
+            this.stats.totalTimeMs += message.stats.timeMs
+            this.stats.toolCalls += message.stats.toolCalls
+        }
+    }
+
+    addUndoEntry(entry: UndoEntry): void {
+        this.undoStack.push(entry)
+        if (this.undoStack.length > MAX_UNDO_STACK_SIZE) {
+            this.undoStack.shift()
+        }
+    }
+
+    popUndoEntry(): UndoEntry | undefined {
+        return this.undoStack.pop()
+    }
+
+    addInputToHistory(input: string): void {
+        if (input.trim() && this.inputHistory[this.inputHistory.length - 1] !== input) {
+            this.inputHistory.push(input)
+        }
+    }
+
+    clearHistory(): void {
+        this.history = []
+        this.context = {
+            filesInContext: [],
+            tokenUsage: 0,
+            needsCompression: false,
+        }
+    }
+
+    getSessionDurationMs(): number {
+        return Date.now() - this.createdAt
+    }
+
+    getSessionDurationFormatted(): string {
+        const totalMinutes = Math.floor(this.getSessionDurationMs() / 60_000)
+        const hours = Math.floor(totalMinutes / 60)
+        const minutes = totalMinutes % 60
+
+        if (hours > 0) {
+            return `${String(hours)}h ${String(minutes)}m`
+        }
+        return `${String(minutes)}m`
+    }
+}
--- a/packages/ipuaro/src/domain/entities/index.ts
+++ b/packages/ipuaro/src/domain/entities/index.ts
@@ -0,0 +1,3 @@
+// Domain Entities
+export * from "./Session.js"
+export * from "./Project.js"
--- a/packages/ipuaro/src/domain/index.ts
+++ b/packages/ipuaro/src/domain/index.ts
@@ -0,0 +1,13 @@
+// Domain Layer exports
+
+// Entities
+export * from "./entities/index.js"
+
+// Value Objects
+export * from "./value-objects/index.js"
+
+// Service Interfaces
+export * from "./services/index.js"
+
+// Constants
+export * from "./constants/index.js"
--- a/packages/ipuaro/src/domain/services/IIndexer.ts
+++ b/packages/ipuaro/src/domain/services/IIndexer.ts
@@ -0,0 +1,83 @@
+import type { FileAST } from "../value-objects/FileAST.js"
+import type { FileData } from "../value-objects/FileData.js"
+import type { FileMeta } from "../value-objects/FileMeta.js"
+import type { DepsGraph, SymbolIndex } from "./IStorage.js"
+
+/**
+ * Progress callback for indexing operations.
+ */
+export interface IndexProgress {
+    current: number
+    total: number
+    currentFile: string
+    phase: "scanning" | "parsing" | "analyzing" | "indexing"
+}
+
+/**
+ * Result of scanning a single file.
+ */
+export interface ScanResult {
+    path: string
+    type: "file" | "directory" | "symlink"
+    size: number
+    lastModified: number
+}
+
+/**
+ * Indexing result statistics.
+ */
+export interface IndexingStats {
+    filesScanned: number
+    filesParsed: number
+    parseErrors: number
+    timeMs: number
+}
+
+/**
+ * Indexer service interface (port).
+ * Handles project scanning, parsing, and indexing.
+ */
+export interface IIndexer {
+    /**
+     * Scan directory and yield file results.
+     */
+    scan(root: string): AsyncGenerator<ScanResult>
+
+    /**
+     * Parse file content into AST.
+     */
+    parseFile(content: string, language: "ts" | "tsx" | "js" | "jsx"): FileAST
+
+    /**
+     * Analyze file and compute metadata.
+     */
+    analyzeFile(path: string, ast: FileAST, allASTs: Map<string, FileAST>): FileMeta
+
+    /**
+     * Build symbol index from all ASTs.
+     */
+    buildSymbolIndex(asts: Map<string, FileAST>): SymbolIndex
+
+    /**
+     * Build dependency graph from all ASTs.
+     */
+    buildDepsGraph(asts: Map<string, FileAST>): DepsGraph
+
+    /**
+     * Full indexing pipeline.
+     */
+    indexProject(
+        root: string,
+        onProgress?: (progress: IndexProgress) => void,
+    ): Promise<IndexingStats>
+
+    /**
+     * Update single file (incremental indexing).
+     */
+    updateFile(path: string, data: FileData): Promise<void>
+
+    /**
+     * Remove file from index.
+     */
+    removeFile(path: string): Promise<void>
+}
--- a/packages/ipuaro/src/domain/services/ILLMClient.ts
+++ b/packages/ipuaro/src/domain/services/ILLMClient.ts
@@ -0,0 +1,81 @@
+import type { ChatMessage } from "../value-objects/ChatMessage.js"
+import type { ToolCall } from "../value-objects/ToolCall.js"
+
+/**
+ * Tool parameter definition for LLM.
+ */
+export interface ToolParameter {
+    name: string
+    type: "string" | "number" | "boolean" | "array" | "object"
+    description: string
+    required: boolean
+    enum?: string[]
+}
+
+/**
+ * Tool definition for LLM function calling.
+ */
+export interface ToolDef {
+    name: string
+    description: string
+    parameters: ToolParameter[]
+}
+
+/**
+ * Response from LLM.
+ */
+export interface LLMResponse {
+    /** Text content of the response */
+    content: string
+    /** Tool calls parsed from response */
+    toolCalls: ToolCall[]
+    /** Token count for this response */
+    tokens: number
+    /** Generation time in milliseconds */
+    timeMs: number
+    /** Whether response was truncated */
+    truncated: boolean
+    /** Stop reason */
+    stopReason: "end" | "length" | "tool_use"
+}
+
+/**
+ * LLM client service interface (port).
+ * Abstracts the LLM provider.
+ */
+export interface ILLMClient {
+    /**
+     * Send messages to LLM and get response.
+     */
+    chat(messages: ChatMessage[], tools?: ToolDef[]): Promise<LLMResponse>
+
+    /**
+     * Count tokens in text.
+     */
+    countTokens(text: string): Promise<number>
+
+    /**
+     * Check if LLM service is available.
+     */
+    isAvailable(): Promise<boolean>
+
+    /**
+     * Get current model name.
+     */
+    getModelName(): string
+
+    /**
+     * Get context window size.
+     */
+    getContextWindowSize(): number
+
+    /**
+     * Pull/download model if not available locally.
+     */
+    pullModel(model: string): Promise<void>
+
+    /**
+     * Abort current generation.
+     */
+    abort(): void
+}
--- a/packages/ipuaro/src/domain/services/IStorage.ts
+++ b/packages/ipuaro/src/domain/services/IStorage.ts
@@ -0,0 +1,65 @@
+import type { FileData } from "../value-objects/FileData.js"
+import type { FileAST } from "../value-objects/FileAST.js"
+import type { FileMeta } from "../value-objects/FileMeta.js"
+
+/**
+ * Symbol index mapping symbol names to their locations.
+ */
+export interface SymbolLocation {
+    path: string
+    line: number
+    type: "function" | "class" | "interface" | "type" | "variable"
+}
+
+export type SymbolIndex = Map<string, SymbolLocation[]>
+
+/**
+ * Dependencies graph for the project.
+ */
+export interface DepsGraph {
+    /** Map from file path to its imports */
+    imports: Map<string, string[]>
+    /** Map from file path to files that import it */
+    importedBy: Map<string, string[]>
+}
+
+/**
+ * Storage service interface (port).
+ * Abstracts the persistence layer for project data.
+ */
+export interface IStorage {
+    // File data operations
+    getFile(path: string): Promise<FileData | null>
+    setFile(path: string, data: FileData): Promise<void>
+    deleteFile(path: string): Promise<void>
+    getAllFiles(): Promise<Map<string, FileData>>
+    getFileCount(): Promise<number>
+
+    // AST operations
+    getAST(path: string): Promise<FileAST | null>
+    setAST(path: string, ast: FileAST): Promise<void>
+    deleteAST(path: string): Promise<void>
+    getAllASTs(): Promise<Map<string, FileAST>>
+
+    // Meta operations
+    getMeta(path: string): Promise<FileMeta | null>
+    setMeta(path: string, meta: FileMeta): Promise<void>
+    deleteMeta(path: string): Promise<void>
+    getAllMetas(): Promise<Map<string, FileMeta>>
+
+    // Index operations
+    getSymbolIndex(): Promise<SymbolIndex>
+    setSymbolIndex(index: SymbolIndex): Promise<void>
+    getDepsGraph(): Promise<DepsGraph>
+    setDepsGraph(graph: DepsGraph): Promise<void>
+
+    // Config operations
+    getProjectConfig(key: string): Promise<unknown>
+    setProjectConfig(key: string, value: unknown): Promise<void>
+
+    // Lifecycle
+    connect(): Promise<void>
+    disconnect(): Promise<void>
+    isConnected(): boolean
+    clear(): Promise<void>
+}
--- a/packages/ipuaro/src/domain/services/ITool.ts
+++ b/packages/ipuaro/src/domain/services/ITool.ts
@@ -0,0 +1,68 @@
+import type { ToolResult } from "../value-objects/ToolResult.js"
+import type { IStorage } from "./IStorage.js"
+
+/**
+ * Tool parameter schema.
+ */
+export interface ToolParameterSchema {
+    name: string
+    type: "string" | "number" | "boolean" | "array" | "object"
+    description: string
+    required: boolean
+    default?: unknown
+}
+
+/**
+ * Context provided to tools during execution.
+ */
+export interface ToolContext {
+    /** Project root path */
+    projectRoot: string
+    /** Storage service */
+    storage: IStorage
+    /** Request user confirmation callback */
+    requestConfirmation: (message: string, diff?: DiffInfo) => Promise<boolean>
+    /** Report progress callback */
+    onProgress?: (message: string) => void
+}
+
+/**
+ * Diff information for confirmation dialogs.
+ */
+export interface DiffInfo {
+    filePath: string
+    oldLines: string[]
+    newLines: string[]
+    startLine: number
+}
+
+/**
+ * Tool interface (port).
+ * All tools must implement this interface.
+ */
+export interface ITool {
+    /** Tool name (used in tool calls) */
+    readonly name: string
+
+    /** Human-readable description */
+    readonly description: string
+
+    /** Tool parameters schema */
+    readonly parameters: ToolParameterSchema[]
+
+    /** Whether tool requires user confirmation before execution */
+    readonly requiresConfirmation: boolean
+
+    /** Tool category */
+    readonly category: "read" | "edit" | "search" | "analysis" | "git" | "run"
+
+    /**
+     * Execute the tool with given parameters.
+     */
+    execute(params: Record<string, unknown>, ctx: ToolContext): Promise<ToolResult>
+
+    /**
+     * Validate parameters before execution.
+     */
+    validateParams(params: Record<string, unknown>): string | null
+}
--- a/packages/ipuaro/src/domain/services/index.ts
+++ b/packages/ipuaro/src/domain/services/index.ts
@@ -0,0 +1,5 @@
+// Domain Service Interfaces (Ports)
+export * from "./IStorage.js"
+export * from "./ILLMClient.js"
+export * from "./ITool.js"
+export * from "./IIndexer.js"
--- a/packages/ipuaro/src/domain/value-objects/ChatMessage.ts
+++ b/packages/ipuaro/src/domain/value-objects/ChatMessage.ts
@@ -0,0 +1,79 @@
+import type { ToolCall } from "./ToolCall.js"
+import type { ToolResult } from "./ToolResult.js"
+
+/**
+ * Represents a message in the chat history.
+ */
+
+export type MessageRole = "user" | "assistant" | "tool" | "system"
+
+export interface MessageStats {
+    /** Token count for this message */
+    tokens: number
+    /** Response generation time in ms (for assistant messages) */
+    timeMs: number
+    /** Number of tool calls in this message */
+    toolCalls: number
+}
+
+export interface ChatMessage {
+    /** Message role */
+    role: MessageRole
+    /** Message content */
+    content: string
+    /** Timestamp when message was created */
+    timestamp: number
+    /** Tool calls made by assistant (if any) */
+    toolCalls?: ToolCall[]
+    /** Tool results (for tool role messages) */
+    toolResults?: ToolResult[]
+    /** Message statistics */
+    stats?: MessageStats
+}
+
+export function createUserMessage(content: string): ChatMessage {
+    return {
+        role: "user",
+        content,
+        timestamp: Date.now(),
+    }
+}
+
+export function createAssistantMessage(
+    content: string,
+    toolCalls?: ToolCall[],
+    stats?: MessageStats,
+): ChatMessage {
+    return {
+        role: "assistant",
+        content,
+        timestamp: Date.now(),
+        toolCalls,
+        stats,
+    }
+}
+
+export function createToolMessage(results: ToolResult[]): ChatMessage {
+    return {
+        role: "tool",
+        content: results.map((r) => formatToolResult(r)).join("\n\n"),
+        timestamp: Date.now(),
+        toolResults: results,
+    }
+}
+
+export function createSystemMessage(content: string): ChatMessage {
+    return {
+        role: "system",
+        content,
+        timestamp: Date.now(),
+    }
+}
+
+function formatToolResult(result: ToolResult): string {
+    if (result.success) {
+        return `[${result.callId}] Success: ${JSON.stringify(result.data)}`
+    }
+    const errorMsg = result.error ?? "Unknown error"
+    return `[${result.callId}] Error: ${errorMsg}`
+}
--- a/packages/ipuaro/src/domain/value-objects/FileAST.ts
+++ b/packages/ipuaro/src/domain/value-objects/FileAST.ts
@@ -0,0 +1,163 @@
+/**
+ * Represents parsed AST information for a file.
+ */
+
+export interface ImportInfo {
+    /** Import name or alias */
+    name: string
+    /** Source module path */
+    from: string
+    /** Line number of import statement */
+    line: number
+    /** Import type classification */
+    type: "internal" | "external" | "builtin"
+    /** Whether it's a default import */
+    isDefault: boolean
+}
+
+export interface ExportInfo {
+    /** Exported name */
+    name: string
+    /** Line number of export */
+    line: number
+    /** Whether it's a default export */
+    isDefault: boolean
+    /** Export type: function, class, variable, type */
+    kind: "function" | "class" | "variable" | "type" | "interface"
+}
+
+export interface ParameterInfo {
+    /** Parameter name */
+    name: string
+    /** Parameter type (if available) */
+    type?: string
+    /** Whether it's optional */
+    optional: boolean
+    /** Whether it has a default value */
+    hasDefault: boolean
+}
+
+export interface FunctionInfo {
+    /** Function name */
+    name: string
+    /** Start line number */
+    lineStart: number
+    /** End line number */
+    lineEnd: number
+    /** Function parameters */
+    params: ParameterInfo[]
+    /** Whether function is async */
+    isAsync: boolean
+    /** Whether function is exported */
+    isExported: boolean
+    /** Return type (if available) */
+    returnType?: string
+}
+
+export interface MethodInfo {
+    /** Method name */
+    name: string
+    /** Start line number */
+    lineStart: number
+    /** End line number */
+    lineEnd: number
+    /** Method parameters */
+    params: ParameterInfo[]
+    /** Whether method is async */
+    isAsync: boolean
+    /** Method visibility */
+    visibility: "public" | "private" | "protected"
+    /** Whether it's static */
+    isStatic: boolean
+}
+
+export interface PropertyInfo {
+    /** Property name */
+    name: string
+    /** Line number */
+    line: number
+    /** Property type (if available) */
+    type?: string
+    /** Property visibility */
+    visibility: "public" | "private" | "protected"
+    /** Whether it's static */
+    isStatic: boolean
+    /** Whether it's readonly */
+    isReadonly: boolean
+}
+
+export interface ClassInfo {
+    /** Class name */
+    name: string
+    /** Start line number */
+    lineStart: number
+    /** End line number */
+    lineEnd: number
+    /** Class methods */
+    methods: MethodInfo[]
+    /** Class properties */
+    properties: PropertyInfo[]
+    /** Extended class name */
+    extends?: string
+    /** Implemented interfaces */
+    implements: string[]
+    /** Whether class is exported */
+    isExported: boolean
+    /** Whether class is abstract */
+    isAbstract: boolean
+}
+
+export interface InterfaceInfo {
+    /** Interface name */
+    name: string
+    /** Start line number */
+    lineStart: number
+    /** End line number */
+    lineEnd: number
+    /** Interface properties */
+    properties: PropertyInfo[]
+    /** Extended interfaces */
+    extends: string[]
+    /** Whether interface is exported */
+    isExported: boolean
+}
+
+export interface TypeAliasInfo {
+    /** Type alias name */
+    name: string
+    /** Line number */
+    line: number
+    /** Whether it's exported */
+    isExported: boolean
+}
+
+export interface FileAST {
+    /** Import statements */
+    imports: ImportInfo[]
+    /** Export statements */
+    exports: ExportInfo[]
+    /** Function declarations */
+    functions: FunctionInfo[]
+    /** Class declarations */
+    classes: ClassInfo[]
+    /** Interface declarations */
+    interfaces: InterfaceInfo[]
+    /** Type alias declarations */
+    typeAliases: TypeAliasInfo[]
+    /** Whether parsing encountered errors */
+    parseError: boolean
+    /** Parse error message if any */
+    parseErrorMessage?: string
+}
+
+export function createEmptyFileAST(): FileAST {
+    return {
+        imports: [],
+        exports: [],
+        functions: [],
+        classes: [],
+        interfaces: [],
+        typeAliases: [],
+        parseError: false,
+    }
+}
--- a/packages/ipuaro/src/domain/value-objects/FileData.ts
+++ b/packages/ipuaro/src/domain/value-objects/FileData.ts
@@ -0,0 +1,26 @@
+/**
+ * Represents file content with metadata for change detection.
+ */
+export interface FileData {
+    /** File content split into lines */
+    lines: string[]
+    /** MD5 hash for change detection */
+    hash: string
+    /** File size in bytes */
+    size: number
+    /** Last modification timestamp (ms) */
+    lastModified: number
+}
+
+export function createFileData(
+    lines: string[],
+    hash: string,
+    size: number,
+    lastModified: number,
+): FileData {
+    return { lines, hash, size, lastModified }
+}
+
+export function isFileDataEqual(a: FileData, b: FileData): boolean {
+    return a.hash === b.hash
+}
--- a/packages/ipuaro/src/domain/value-objects/FileMeta.ts
+++ b/packages/ipuaro/src/domain/value-objects/FileMeta.ts
@@ -0,0 +1,50 @@
+/**
+ * Represents computed metadata about a file.
+ */
+
+export interface ComplexityMetrics {
+    /** Lines of code (excluding empty and comments) */
+    loc: number
+    /** Maximum nesting depth */
+    nesting: number
+    /** Cyclomatic complexity score */
+    cyclomaticComplexity: number
+    /** Overall complexity score (0-100) */
+    score: number
+}
+
+export interface FileMeta {
+    /** Complexity metrics for the file */
+    complexity: ComplexityMetrics
+    /** Files that this file imports (internal paths) */
+    dependencies: string[]
+    /** Files that import this file */
+    dependents: string[]
+    /** Whether file is a dependency hub (>5 dependents) */
+    isHub: boolean
+    /** Whether file is an entry point (index.ts or 0 dependents) */
+    isEntryPoint: boolean
+    /** File type classification */
+    fileType: "source" | "test" | "config" | "types" | "unknown"
+}
+
+export function createFileMeta(partial: Partial<FileMeta> = {}): FileMeta {
+    return {
+        complexity: {
+            loc: 0,
+            nesting: 0,
+            cyclomaticComplexity: 1,
+            score: 0,
+        },
+        dependencies: [],
+        dependents: [],
+        isHub: false,
+        isEntryPoint: false,
+        fileType: "unknown",
+        ...partial,
+    }
+}
+
+export function isHubFile(dependentCount: number): boolean {
+    return dependentCount > 5
+}
--- a/packages/ipuaro/src/domain/value-objects/ToolCall.ts
+++ b/packages/ipuaro/src/domain/value-objects/ToolCall.ts
@@ -0,0 +1,27 @@
+/**
+ * Represents a tool call from the LLM.
+ */
+
+export interface ToolCall {
+    /** Unique identifier for this call */
+    id: string
+    /** Tool name */
+    name: string
+    /** Tool parameters */
+    params: Record<string, unknown>
+    /** Timestamp when call was made */
+    timestamp: number
+}
+
+export function createToolCall(
+    id: string,
+    name: string,
+    params: Record<string, unknown>,
+): ToolCall {
+    return {
+        id,
+        name,
+        params,
+        timestamp: Date.now(),
+    }
+}
--- a/packages/ipuaro/src/domain/value-objects/ToolResult.ts
+++ b/packages/ipuaro/src/domain/value-objects/ToolResult.ts
@@ -0,0 +1,42 @@
+/**
+ * Represents the result of a tool execution.
+ */
+
+export interface ToolResult {
+    /** Tool call ID this result belongs to */
+    callId: string
+    /** Whether execution was successful */
+    success: boolean
+    /** Result data (varies by tool) */
+    data?: unknown
+    /** Error message if failed */
+    error?: string
+    /** Execution time in milliseconds */
+    executionTimeMs: number
+}
+
+export function createSuccessResult(
+    callId: string,
+    data: unknown,
+    executionTimeMs: number,
+): ToolResult {
+    return {
+        callId,
+        success: true,
+        data,
+        executionTimeMs,
+    }
+}
+
+export function createErrorResult(
+    callId: string,
+    error: string,
+    executionTimeMs: number,
+): ToolResult {
+    return {
+        callId,
+        success: false,
+        error,
+        executionTimeMs,
+    }
+}
--- a/packages/ipuaro/src/domain/value-objects/UndoEntry.ts
+++ b/packages/ipuaro/src/domain/value-objects/UndoEntry.ts
@@ -0,0 +1,50 @@
+/**
+ * Represents an undo entry for file changes.
+ */
+
+export interface UndoEntry {
+    /** Unique identifier */
+    id: string
+    /** Timestamp when change was made */
+    timestamp: number
+    /** File path that was modified */
+    filePath: string
+    /** Content before the change */
+    previousContent: string[]
+    /** Content after the change */
+    newContent: string[]
+    /** Human-readable description of the change */
+    description: string
+    /** Tool call ID that made this change */
+    toolCallId?: string
+}
+
+export function createUndoEntry(
+    id: string,
+    filePath: string,
+    previousContent: string[],
+    newContent: string[],
+    description: string,
+    toolCallId?: string,
+): UndoEntry {
+    return {
+        id,
+        timestamp: Date.now(),
+        filePath,
+        previousContent,
+        newContent,
+        description,
+        toolCallId,
+    }
+}
+
+export function canUndo(entry: UndoEntry, currentContent: string[]): boolean {
+    return arraysEqual(entry.newContent, currentContent)
+}
+
+function arraysEqual(a: string[], b: string[]): boolean {
+    if (a.length !== b.length) {
+        return false
+    }
+    return a.every((line, i) => line === b[i])
+}
--- a/packages/ipuaro/src/domain/value-objects/index.ts
+++ b/packages/ipuaro/src/domain/value-objects/index.ts
@@ -0,0 +1,8 @@
+// Domain Value Objects
+export * from "./FileData.js"
+export * from "./FileAST.js"
+export * from "./FileMeta.js"
+export * from "./ChatMessage.js"
+export * from "./ToolCall.js"
+export * from "./ToolResult.js"
+export * from "./UndoEntry.js"
--- a/packages/ipuaro/src/index.ts
+++ b/packages/ipuaro/src/index.ts
@@ -0,0 +1,17 @@
+/**
+ * @puaros/ipuaro - Local AI agent for codebase operations
+ *
+ * Main entry point for the library.
+ */
+
+// Domain exports
+export * from "./domain/index.js"
+
+// Application exports
+export * from "./application/index.js"
+
+// Shared exports
+export * from "./shared/index.js"
+
+// Version
+export const VERSION = "0.1.0"
--- a/packages/ipuaro/src/shared/config/index.ts
+++ b/packages/ipuaro/src/shared/config/index.ts
@@ -0,0 +1,2 @@
+// Config module exports
+export * from "./loader.js"
--- a/packages/ipuaro/src/shared/config/loader.ts
+++ b/packages/ipuaro/src/shared/config/loader.ts
@@ -0,0 +1,89 @@
+import { existsSync, readFileSync } from "node:fs"
+import { join } from "node:path"
+import { Config, ConfigSchema, DEFAULT_CONFIG } from "../constants/config.js"
+
+const CONFIG_FILE_NAME = ".ipuaro.json"
+const DEFAULT_CONFIG_PATH = "config/default.json"
+
+/**
+ * Load configuration from files.
+ * Priority: .ipuaro.json > config/default.json > defaults
+ */
+export function loadConfig(projectRoot: string): Config {
+    const configs: Partial<Config>[] = []
+
+    const defaultConfigPath = join(projectRoot, DEFAULT_CONFIG_PATH)
+    if (existsSync(defaultConfigPath)) {
+        try {
+            const content = readFileSync(defaultConfigPath, "utf-8")
+            configs.push(JSON.parse(content) as Partial<Config>)
+        } catch {
+            // Ignore parse errors for default config
+        }
+    }
+
+    const projectConfigPath = join(projectRoot, CONFIG_FILE_NAME)
+    if (existsSync(projectConfigPath)) {
+        try {
+            const content = readFileSync(projectConfigPath, "utf-8")
+            configs.push(JSON.parse(content) as Partial<Config>)
+        } catch {
+            // Ignore parse errors for project config
+        }
+    }
+
+    if (configs.length === 0) {
+        return DEFAULT_CONFIG
+    }
+
+    const merged = deepMerge(DEFAULT_CONFIG, ...configs)
+    return ConfigSchema.parse(merged)
+}
+
+/**
+ * Deep merge objects.
+ */
+function deepMerge<T extends Record<string, unknown>>(target: T, ...sources: Partial<T>[]): T {
+    const result = { ...target }
+
+    for (const source of sources) {
+        for (const key in source) {
+            const sourceValue = source[key]
+            const targetValue = result[key]
+
+            if (isPlainObject(sourceValue) && isPlainObject(targetValue)) {
+                result[key] = deepMerge(
+                    targetValue as Record<string, unknown>,
+                    sourceValue as Record<string, unknown>,
+                ) as T[Extract<keyof T, string>]
+            } else if (sourceValue !== undefined) {
+                result[key] = sourceValue as T[Extract<keyof T, string>]
+            }
+        }
+    }
+
+    return result
+}
+
+function isPlainObject(value: unknown): value is Record<string, unknown> {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+}
+
+/**
+ * Validate configuration.
+ */
+export function validateConfig(config: unknown): config is Config {
+    const result = ConfigSchema.safeParse(config)
+    return result.success
+}
+
+/**
+ * Get config validation errors.
+ */
+export function getConfigErrors(config: unknown): string[] {
+    const result = ConfigSchema.safeParse(config)
+    if (result.success) {
+        return []
+    }
+    return result.error.errors.map((e) => `${e.path.join(".")}: ${e.message}`)
+}
--- a/packages/ipuaro/src/shared/constants/config.ts
+++ b/packages/ipuaro/src/shared/constants/config.ts
@@ -0,0 +1,107 @@
+import { z } from "zod"
+
+/**
+ * Redis configuration schema.
+ */
+export const RedisConfigSchema = z.object({
+    host: z.string().default("localhost"),
+    port: z.number().int().positive().default(6379),
+    db: z.number().int().min(0).max(15).default(0),
+    password: z.string().optional(),
+    keyPrefix: z.string().default("ipuaro:"),
+})
+
+/**
+ * LLM configuration schema.
+ */
+export const LLMConfigSchema = z.object({
+    model: z.string().default("qwen2.5-coder:7b-instruct"),
+    contextWindow: z.number().int().positive().default(128_000),
+    temperature: z.number().min(0).max(2).default(0.1),
+    host: z.string().default("http://localhost:11434"),
+    timeout: z.number().int().positive().default(120_000),
+})
+
+/**
+ * Project configuration schema.
+ */
+export const ProjectConfigSchema = z.object({
+    ignorePatterns: z
+        .array(z.string())
+        .default(["node_modules", "dist", "build", ".git", ".next", ".nuxt", "coverage", ".cache"]),
+    binaryExtensions: z
+        .array(z.string())
+        .default([
+            ".png",
+            ".jpg",
+            ".jpeg",
+            ".gif",
+            ".ico",
+            ".svg",
+            ".woff",
+            ".woff2",
+            ".ttf",
+            ".eot",
+            ".mp3",
+            ".mp4",
+            ".webm",
+            ".pdf",
+            ".zip",
+            ".tar",
+            ".gz",
+        ]),
+    maxFileSize: z.number().int().positive().default(1_000_000),
+    supportedExtensions: z
+        .array(z.string())
+        .default([".ts", ".tsx", ".js", ".jsx", ".json", ".yaml", ".yml"]),
+})
+
+/**
+ * Watchdog configuration schema.
+ */
+export const WatchdogConfigSchema = z.object({
+    enabled: z.boolean().default(true),
+    debounceMs: z.number().int().positive().default(500),
+})
+
+/**
+ * Undo configuration schema.
+ */
+export const UndoConfigSchema = z.object({
+    stackSize: z.number().int().positive().default(10),
+})
+
+/**
+ * Edit configuration schema.
+ */
+export const EditConfigSchema = z.object({
+    autoApply: z.boolean().default(false),
+})
+
+/**
+ * Full configuration schema.
+ */
+export const ConfigSchema = z.object({
+    redis: RedisConfigSchema.default({}),
+    llm: LLMConfigSchema.default({}),
+    project: ProjectConfigSchema.default({}),
+    watchdog: WatchdogConfigSchema.default({}),
+    undo: UndoConfigSchema.default({}),
+    edit: EditConfigSchema.default({}),
+})
+
+/**
+ * Configuration type inferred from schema.
+ */
+export type Config = z.infer<typeof ConfigSchema>
+export type RedisConfig = z.infer<typeof RedisConfigSchema>
+export type LLMConfig = z.infer<typeof LLMConfigSchema>
+export type ProjectConfig = z.infer<typeof ProjectConfigSchema>
+export type WatchdogConfig = z.infer<typeof WatchdogConfigSchema>
+export type UndoConfig = z.infer<typeof UndoConfigSchema>
+export type EditConfig = z.infer<typeof EditConfigSchema>
+
+/**
+ * Default configuration.
+ */
+export const DEFAULT_CONFIG: Config = ConfigSchema.parse({})
--- a/packages/ipuaro/src/shared/constants/index.ts
+++ b/packages/ipuaro/src/shared/constants/index.ts
@@ -0,0 +1,3 @@
+// Shared constants
+export * from "./config.js"
+export * from "./messages.js"
--- a/packages/ipuaro/src/shared/constants/messages.ts
+++ b/packages/ipuaro/src/shared/constants/messages.ts
@@ -0,0 +1,56 @@
+/**
+ * User-facing messages and labels.
+ */
+
+export const MESSAGES = {
+    // Status messages
+    STATUS_READY: "Ready",
+    STATUS_THINKING: "Thinking...",
+    STATUS_INDEXING: "Indexing...",
+    STATUS_ERROR: "Error",
+
+    // Error messages
+    ERROR_REDIS_UNAVAILABLE: "Redis is not available. Please start Redis server.",
+    ERROR_OLLAMA_UNAVAILABLE: "Ollama is not available. Please start Ollama.",
+    ERROR_MODEL_NOT_FOUND: "Model not found. Would you like to pull it?",
+    ERROR_FILE_NOT_FOUND: "File not found",
+    ERROR_PARSE_FAILED: "Failed to parse file",
+    ERROR_TOOL_FAILED: "Tool execution failed",
+    ERROR_COMMAND_BLACKLISTED: "Command is blacklisted for security reasons",
+    ERROR_PATH_OUTSIDE_PROJECT: "Path is outside project directory",
+
+    // Confirmation messages
+    CONFIRM_APPLY_EDIT: "Apply this edit?",
+    CONFIRM_DELETE_FILE: "Delete this file?",
+    CONFIRM_RUN_COMMAND: "Run this command?",
+    CONFIRM_CREATE_FILE: "Create this file?",
+    CONFIRM_GIT_COMMIT: "Create this commit?",
+
+    // Info messages
+    INFO_SESSION_LOADED: "Session loaded",
+    INFO_SESSION_CREATED: "New session created",
+    INFO_INDEXING_COMPLETE: "Indexing complete",
+    INFO_EDIT_APPLIED: "Edit applied",
+    INFO_EDIT_CANCELLED: "Edit cancelled",
+    INFO_UNDO_SUCCESS: "Change reverted",
+    INFO_UNDO_EMPTY: "Nothing to undo",
+
+    // Help text
+    HELP_COMMANDS: `Available commands:
+  /help       - Show this help
+  /clear      - Clear chat history
+  /undo       - Revert last file change
+  /sessions   - Manage sessions
+  /status     - Show status info
+  /reindex    - Force reindexing
+  /auto-apply - Toggle auto-apply mode`,
+
+    HELP_HOTKEYS: `Hotkeys:
+  Ctrl+C  - Interrupt / Exit
+  Ctrl+D  - Exit with save
+  Ctrl+Z  - Undo last change
+  ↑/↓     - Navigate history
+  Tab     - Autocomplete paths`,
+} as const
+
+export type MessageKey = keyof typeof MESSAGES
--- a/packages/ipuaro/src/shared/errors/IpuaroError.ts
+++ b/packages/ipuaro/src/shared/errors/IpuaroError.ts
@@ -0,0 +1,78 @@
+/**
+ * Error types for ipuaro.
+ */
+export type ErrorType =
+    | "redis"
+    | "parse"
+    | "llm"
+    | "file"
+    | "command"
+    | "conflict"
+    | "validation"
+    | "timeout"
+    | "unknown"
+
+/**
+ * Base error class for ipuaro.
+ */
+export class IpuaroError extends Error {
+    readonly type: ErrorType
+    readonly recoverable: boolean
+    readonly suggestion?: string
+
+    constructor(type: ErrorType, message: string, recoverable = true, suggestion?: string) {
+        super(message)
+        this.name = "IpuaroError"
+        this.type = type
+        this.recoverable = recoverable
+        this.suggestion = suggestion
+    }
+
+    static redis(message: string): IpuaroError {
+        return new IpuaroError(
+            "redis",
+            message,
+            false,
+            "Please ensure Redis is running: redis-server",
+        )
+    }
+
+    static parse(message: string, filePath?: string): IpuaroError {
+        const msg = filePath ? `${message} in ${filePath}` : message
+        return new IpuaroError("parse", msg, true, "File will be skipped")
+    }
+
+    static llm(message: string): IpuaroError {
+        return new IpuaroError(
+            "llm",
+            message,
+            true,
+            "Please ensure Ollama is running and model is available",
+        )
+    }
+
+    static file(message: string): IpuaroError {
+        return new IpuaroError("file", message, true)
+    }
+
+    static command(message: string): IpuaroError {
+        return new IpuaroError("command", message, true)
+    }
+
+    static conflict(message: string): IpuaroError {
+        return new IpuaroError(
+            "conflict",
+            message,
+            true,
+            "File was modified externally. Regenerate or skip.",
+        )
+    }
+
+    static validation(message: string): IpuaroError {
+        return new IpuaroError("validation", message, true)
+    }
+
+    static timeout(message: string): IpuaroError {
+        return new IpuaroError("timeout", message, true, "Try again or increase timeout")
+    }
+}
--- a/packages/ipuaro/src/shared/errors/index.ts
+++ b/packages/ipuaro/src/shared/errors/index.ts
@@ -0,0 +1,2 @@
+// Shared errors
+export * from "./IpuaroError.js"
--- a/packages/ipuaro/src/shared/index.ts
+++ b/packages/ipuaro/src/shared/index.ts
@@ -0,0 +1,6 @@
+// Shared module exports
+export * from "./config/index.js"
+export * from "./constants/index.js"
+export * from "./errors/index.js"
+export * from "./types/index.js"
+export * from "./utils/index.js"
--- a/packages/ipuaro/src/shared/types/index.ts
+++ b/packages/ipuaro/src/shared/types/index.ts
@@ -0,0 +1,66 @@
+/**
+ * Shared types for ipuaro.
+ */
+
+/**
+ * Application status.
+ */
+export type AppStatus = "ready" | "thinking" | "indexing" | "error"
+
+/**
+ * File language type.
+ */
+export type FileLanguage = "ts" | "tsx" | "js" | "jsx" | "json" | "yaml" | "unknown"
+
+/**
+ * User choice for confirmations.
+ */
+export type ConfirmChoice = "apply" | "cancel" | "edit"
+
+/**
+ * User choice for errors.
+ */
+export type ErrorChoice = "retry" | "skip" | "abort"
+
+/**
+ * Project structure node.
+ */
+export interface ProjectNode {
+    name: string
+    type: "file" | "directory"
+    path: string
+    children?: ProjectNode[]
+}
+
+/**
+ * Generic result type.
+ */
+export type Result<T, E = Error> = { success: true; data: T } | { success: false; error: E }
+
+/**
+ * Create success result.
+ */
+export function ok<T>(data: T): Result<T, never> {
+    return { success: true, data }
+}
+
+/**
+ * Create error result.
+ */
+export function err<E>(error: E): Result<never, E> {
+    return { success: false, error }
+}
+
+/**
+ * Check if result is success.
+ */
+export function isOk<T, E>(result: Result<T, E>): result is { success: true; data: T } {
+    return result.success
+}
+
+/**
+ * Check if result is error.
+ */
+export function isErr<T, E>(result: Result<T, E>): result is { success: false; error: E } {
+    return !result.success
+}
--- a/packages/ipuaro/src/shared/utils/hash.ts
+++ b/packages/ipuaro/src/shared/utils/hash.ts
@@ -0,0 +1,22 @@
+import { createHash } from "node:crypto"
+
+/**
+ * Calculate MD5 hash of content.
+ */
+export function md5(content: string): string {
+    return createHash("md5").update(content).digest("hex")
+}
+
+/**
+ * Calculate MD5 hash of file lines.
+ */
+export function hashLines(lines: string[]): string {
+    return md5(lines.join("\n"))
+}
+
+/**
+ * Generate short hash for IDs.
+ */
+export function shortHash(content: string, length = 8): string {
+    return md5(content).slice(0, length)
+}
--- a/packages/ipuaro/src/shared/utils/index.ts
+++ b/packages/ipuaro/src/shared/utils/index.ts
@@ -0,0 +1,3 @@
+// Shared utilities
+export * from "./hash.js"
+export * from "./tokens.js"
--- a/packages/ipuaro/src/shared/utils/tokens.ts
+++ b/packages/ipuaro/src/shared/utils/tokens.ts
@@ -0,0 +1,41 @@
+/**
+ * Simple token estimation utilities.
+ * Uses approximation: ~4 characters per token for English text.
+ */
+
+const CHARS_PER_TOKEN = 4
+
+/**
+ * Estimate token count for text.
+ */
+export function estimateTokens(text: string): number {
+    return Math.ceil(text.length / CHARS_PER_TOKEN)
+}
+
+/**
+ * Estimate token count for array of strings.
+ */
+export function estimateTokensForLines(lines: string[]): number {
+    return estimateTokens(lines.join("\n"))
+}
+
+/**
+ * Truncate text to approximate token limit.
+ */
+export function truncateToTokens(text: string, maxTokens: number): string {
+    const maxChars = maxTokens * CHARS_PER_TOKEN
+    if (text.length <= maxChars) {
+        return text
+    }
+    return `${text.slice(0, maxChars)}...`
+}
+
+/**
+ * Format token count for display.
+ */
+export function formatTokenCount(tokens: number): string {
+    if (tokens >= 1000) {
+        return `${(tokens / 1000).toFixed(1)}k`
+    }
+    return tokens.toString()
+}
--- a/packages/ipuaro/tests/unit/domain/entities/Project.test.ts
+++ b/packages/ipuaro/tests/unit/domain/entities/Project.test.ts
@@ -0,0 +1,106 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest"
+import { Project } from "../../../../src/domain/entities/Project.js"
+
+describe("Project", () => {
+    beforeEach(() => {
+        vi.useFakeTimers()
+        vi.setSystemTime(new Date("2025-01-01T00:00:00Z"))
+    })
+
+    afterEach(() => {
+        vi.useRealTimers()
+    })
+
+    describe("constructor", () => {
+        it("should create project with generated name", () => {
+            const project = new Project("/home/user/projects/myapp")
+
+            expect(project.rootPath).toBe("/home/user/projects/myapp")
+            expect(project.name).toBe("projects-myapp")
+            expect(project.createdAt).toBe(Date.now())
+            expect(project.lastIndexedAt).toBeNull()
+            expect(project.fileCount).toBe(0)
+            expect(project.indexingInProgress).toBe(false)
+        })
+
+        it("should accept custom createdAt", () => {
+            const customTime = 1000000
+            const project = new Project("/path", customTime)
+
+            expect(project.createdAt).toBe(customTime)
+        })
+    })
+
+    describe("generateProjectName", () => {
+        it("should generate name from parent and project folder", () => {
+            expect(Project.generateProjectName("/home/user/projects/myapp")).toBe("projects-myapp")
+        })
+
+        it("should handle root-level project", () => {
+            expect(Project.generateProjectName("/myapp")).toBe("myapp")
+        })
+    })
+
+    describe("indexing lifecycle", () => {
+        it("should mark indexing started", () => {
+            const project = new Project("/path")
+
+            project.markIndexingStarted()
+
+            expect(project.indexingInProgress).toBe(true)
+        })
+
+        it("should mark indexing completed", () => {
+            const project = new Project("/path")
+            project.markIndexingStarted()
+
+            project.markIndexingCompleted(100)
+
+            expect(project.indexingInProgress).toBe(false)
+            expect(project.lastIndexedAt).toBe(Date.now())
+            expect(project.fileCount).toBe(100)
+        })
+
+        it("should mark indexing failed", () => {
+            const project = new Project("/path")
+            project.markIndexingStarted()
+
+            project.markIndexingFailed()
+
+            expect(project.indexingInProgress).toBe(false)
+            expect(project.lastIndexedAt).toBeNull()
+        })
+    })
+
+    describe("isIndexed", () => {
+        it("should return false when not indexed", () => {
+            const project = new Project("/path")
+
+            expect(project.isIndexed()).toBe(false)
+        })
+
+        it("should return true when indexed", () => {
+            const project = new Project("/path")
+            project.markIndexingCompleted(10)
+
+            expect(project.isIndexed()).toBe(true)
+        })
+    })
+
+    describe("getTimeSinceIndexed", () => {
+        it("should return null when not indexed", () => {
+            const project = new Project("/path")
+
+            expect(project.getTimeSinceIndexed()).toBeNull()
+        })
+
+        it("should return time since last indexed", () => {
+            const project = new Project("/path")
+            project.markIndexingCompleted(10)
+
+            vi.advanceTimersByTime(5000)
+
+            expect(project.getTimeSinceIndexed()).toBe(5000)
+        })
+    })
+})
--- a/packages/ipuaro/tests/unit/domain/entities/Session.test.ts
+++ b/packages/ipuaro/tests/unit/domain/entities/Session.test.ts
@@ -0,0 +1,165 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest"
+import { Session } from "../../../../src/domain/entities/Session.js"
+import { createUserMessage } from "../../../../src/domain/value-objects/ChatMessage.js"
+import type { UndoEntry } from "../../../../src/domain/value-objects/UndoEntry.js"
+
+describe("Session", () => {
+    beforeEach(() => {
+        vi.useFakeTimers()
+        vi.setSystemTime(new Date("2025-01-01T00:00:00Z"))
+    })
+
+    afterEach(() => {
+        vi.useRealTimers()
+    })
+
+    it("should create session with defaults", () => {
+        const session = new Session("session-1", "test-project")
+
+        expect(session.id).toBe("session-1")
+        expect(session.projectName).toBe("test-project")
+        expect(session.history).toEqual([])
+        expect(session.undoStack).toEqual([])
+        expect(session.stats.totalTokens).toBe(0)
+    })
+
+    describe("addMessage", () => {
+        it("should add message to history", () => {
+            const session = new Session("1", "proj")
+            const msg = createUserMessage("Hello")
+
+            session.addMessage(msg)
+
+            expect(session.history).toHaveLength(1)
+            expect(session.history[0]).toBe(msg)
+        })
+
+        it("should update stats from message", () => {
+            const session = new Session("1", "proj")
+            const msg = {
+                role: "assistant" as const,
+                content: "Hi",
+                timestamp: Date.now(),
+                stats: { tokens: 50, timeMs: 100, toolCalls: 2 },
+            }
+
+            session.addMessage(msg)
+
+            expect(session.stats.totalTokens).toBe(50)
+            expect(session.stats.totalTimeMs).toBe(100)
+            expect(session.stats.toolCalls).toBe(2)
+        })
+    })
+
+    describe("undoStack", () => {
+        it("should add undo entry", () => {
+            const session = new Session("1", "proj")
+            const entry: UndoEntry = {
+                id: "undo-1",
+                timestamp: Date.now(),
+                filePath: "test.ts",
+                previousContent: ["old"],
+                newContent: ["new"],
+                description: "Edit",
+            }
+
+            session.addUndoEntry(entry)
+
+            expect(session.undoStack).toHaveLength(1)
+        })
+
+        it("should limit undo stack size", () => {
+            const session = new Session("1", "proj")
+
+            for (let i = 0; i < 15; i++) {
+                session.addUndoEntry({
+                    id: `undo-${i}`,
+                    timestamp: Date.now(),
+                    filePath: "test.ts",
+                    previousContent: [],
+                    newContent: [],
+                    description: `Edit ${i}`,
+                })
+            }
+
+            expect(session.undoStack).toHaveLength(10)
+            expect(session.undoStack[0].id).toBe("undo-5")
+        })
+
+        it("should pop undo entry", () => {
+            const session = new Session("1", "proj")
+            const entry: UndoEntry = {
+                id: "undo-1",
+                timestamp: Date.now(),
+                filePath: "test.ts",
+                previousContent: [],
+                newContent: [],
+                description: "Edit",
+            }
+
+            session.addUndoEntry(entry)
+            const popped = session.popUndoEntry()
+
+            expect(popped).toBe(entry)
+            expect(session.undoStack).toHaveLength(0)
+        })
+    })
+
+    describe("inputHistory", () => {
+        it("should add input to history", () => {
+            const session = new Session("1", "proj")
+
+            session.addInputToHistory("command 1")
+            session.addInputToHistory("command 2")
+
+            expect(session.inputHistory).toEqual(["command 1", "command 2"])
+        })
+
+        it("should not add duplicate consecutive inputs", () => {
+            const session = new Session("1", "proj")
+
+            session.addInputToHistory("command")
+            session.addInputToHistory("command")
+
+            expect(session.inputHistory).toHaveLength(1)
+        })
+
+        it("should not add empty inputs", () => {
+            const session = new Session("1", "proj")
+
+            session.addInputToHistory("")
+            session.addInputToHistory("   ")
+
+            expect(session.inputHistory).toHaveLength(0)
+        })
+    })
+
+    describe("clearHistory", () => {
+        it("should clear history and context", () => {
+            const session = new Session("1", "proj")
+            session.addMessage(createUserMessage("Hello"))
+            session.context.filesInContext = ["file1.ts"]
+
+            session.clearHistory()
+
+            expect(session.history).toHaveLength(0)
+            expect(session.context.filesInContext).toHaveLength(0)
+        })
+    })
+
+    describe("getSessionDurationFormatted", () => {
+        it("should format minutes only", () => {
+            const session = new Session("1", "proj")
+            vi.advanceTimersByTime(15 * 60 * 1000)
+
+            expect(session.getSessionDurationFormatted()).toBe("15m")
+        })
+
+        it("should format hours and minutes", () => {
+            const session = new Session("1", "proj")
+            vi.advanceTimersByTime(90 * 60 * 1000)
+
+            expect(session.getSessionDurationFormatted()).toBe("1h 30m")
+        })
+    })
+})
--- a/packages/ipuaro/tests/unit/domain/value-objects/ChatMessage.test.ts
+++ b/packages/ipuaro/tests/unit/domain/value-objects/ChatMessage.test.ts
@@ -0,0 +1,80 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest"
+import {
+    createUserMessage,
+    createAssistantMessage,
+    createToolMessage,
+    createSystemMessage,
+} from "../../../../src/domain/value-objects/ChatMessage.js"
+
+describe("ChatMessage", () => {
+    beforeEach(() => {
+        vi.useFakeTimers()
+        vi.setSystemTime(new Date("2025-01-01T00:00:00Z"))
+    })
+
+    afterEach(() => {
+        vi.useRealTimers()
+    })
+
+    describe("createUserMessage", () => {
+        it("should create user message", () => {
+            const msg = createUserMessage("Hello")
+
+            expect(msg.role).toBe("user")
+            expect(msg.content).toBe("Hello")
+            expect(msg.timestamp).toBe(Date.now())
+        })
+    })
+
+    describe("createAssistantMessage", () => {
+        it("should create assistant message without tool calls", () => {
+            const msg = createAssistantMessage("Response")
+
+            expect(msg.role).toBe("assistant")
+            expect(msg.content).toBe("Response")
+            expect(msg.toolCalls).toBeUndefined()
+        })
+
+        it("should create assistant message with tool calls", () => {
+            const toolCalls = [
+                { id: "1", name: "get_lines", params: {}, timestamp: Date.now() },
+            ]
+            const stats = { tokens: 100, timeMs: 500, toolCalls: 1 }
+            const msg = createAssistantMessage("Response", toolCalls, stats)
+
+            expect(msg.toolCalls).toEqual(toolCalls)
+            expect(msg.stats).toEqual(stats)
+        })
+    })
+
+    describe("createToolMessage", () => {
+        it("should create tool message with results", () => {
+            const results = [
+                { callId: "1", success: true, data: "data", executionTimeMs: 10 },
+            ]
+            const msg = createToolMessage(results)
+
+            expect(msg.role).toBe("tool")
+            expect(msg.toolResults).toEqual(results)
+            expect(msg.content).toContain("[1] Success")
+        })
+
+        it("should format error results", () => {
+            const results = [
+                { callId: "2", success: false, error: "Not found", executionTimeMs: 5 },
+            ]
+            const msg = createToolMessage(results)
+
+            expect(msg.content).toContain("[2] Error: Not found")
+        })
+    })
+
+    describe("createSystemMessage", () => {
+        it("should create system message", () => {
+            const msg = createSystemMessage("System prompt")
+
+            expect(msg.role).toBe("system")
+            expect(msg.content).toBe("System prompt")
+        })
+    })
+})
--- a/packages/ipuaro/tests/unit/domain/value-objects/FileAST.test.ts
+++ b/packages/ipuaro/tests/unit/domain/value-objects/FileAST.test.ts
@@ -0,0 +1,19 @@
+import { describe, it, expect } from "vitest"
+import { createEmptyFileAST } from "../../../../src/domain/value-objects/FileAST.js"
+
+describe("FileAST", () => {
+    describe("createEmptyFileAST", () => {
+        it("should create empty AST with all arrays empty", () => {
+            const ast = createEmptyFileAST()
+
+            expect(ast.imports).toEqual([])
+            expect(ast.exports).toEqual([])
+            expect(ast.functions).toEqual([])
+            expect(ast.classes).toEqual([])
+            expect(ast.interfaces).toEqual([])
+            expect(ast.typeAliases).toEqual([])
+            expect(ast.parseError).toBe(false)
+            expect(ast.parseErrorMessage).toBeUndefined()
+        })
+    })
+})
--- a/packages/ipuaro/tests/unit/domain/value-objects/FileData.test.ts
+++ b/packages/ipuaro/tests/unit/domain/value-objects/FileData.test.ts
@@ -0,0 +1,39 @@
+import { describe, it, expect } from "vitest"
+import {
+    createFileData,
+    isFileDataEqual,
+} from "../../../../src/domain/value-objects/FileData.js"
+
+describe("FileData", () => {
+    describe("createFileData", () => {
+        it("should create FileData with all fields", () => {
+            const lines = ["line1", "line2"]
+            const hash = "abc123"
+            const size = 100
+            const lastModified = Date.now()
+
+            const result = createFileData(lines, hash, size, lastModified)
+
+            expect(result.lines).toEqual(lines)
+            expect(result.hash).toBe(hash)
+            expect(result.size).toBe(size)
+            expect(result.lastModified).toBe(lastModified)
+        })
+    })
+
+    describe("isFileDataEqual", () => {
+        it("should return true for equal hashes", () => {
+            const a = createFileData(["a"], "hash1", 1, 1)
+            const b = createFileData(["b"], "hash1", 2, 2)
+
+            expect(isFileDataEqual(a, b)).toBe(true)
+        })
+
+        it("should return false for different hashes", () => {
+            const a = createFileData(["a"], "hash1", 1, 1)
+            const b = createFileData(["a"], "hash2", 1, 1)
+
+            expect(isFileDataEqual(a, b)).toBe(false)
+        })
+    })
+})
--- a/packages/ipuaro/tests/unit/domain/value-objects/FileMeta.test.ts
+++ b/packages/ipuaro/tests/unit/domain/value-objects/FileMeta.test.ts
@@ -0,0 +1,48 @@
+import { describe, it, expect } from "vitest"
+import {
+    createFileMeta,
+    isHubFile,
+} from "../../../../src/domain/value-objects/FileMeta.js"
+
+describe("FileMeta", () => {
+    describe("createFileMeta", () => {
+        it("should create FileMeta with defaults", () => {
+            const meta = createFileMeta()
+
+            expect(meta.complexity.loc).toBe(0)
+            expect(meta.complexity.nesting).toBe(0)
+            expect(meta.complexity.cyclomaticComplexity).toBe(1)
+            expect(meta.complexity.score).toBe(0)
+            expect(meta.dependencies).toEqual([])
+            expect(meta.dependents).toEqual([])
+            expect(meta.isHub).toBe(false)
+            expect(meta.isEntryPoint).toBe(false)
+            expect(meta.fileType).toBe("unknown")
+        })
+
+        it("should merge partial values", () => {
+            const meta = createFileMeta({
+                isHub: true,
+                fileType: "source",
+                dependencies: ["dep1.ts"],
+            })
+
+            expect(meta.isHub).toBe(true)
+            expect(meta.fileType).toBe("source")
+            expect(meta.dependencies).toEqual(["dep1.ts"])
+            expect(meta.dependents).toEqual([])
+        })
+    })
+
+    describe("isHubFile", () => {
+        it("should return true for >5 dependents", () => {
+            expect(isHubFile(6)).toBe(true)
+            expect(isHubFile(10)).toBe(true)
+        })
+
+        it("should return false for <=5 dependents", () => {
+            expect(isHubFile(5)).toBe(false)
+            expect(isHubFile(0)).toBe(false)
+        })
+    })
+})
--- a/packages/ipuaro/tests/unit/domain/value-objects/ToolCall.test.ts
+++ b/packages/ipuaro/tests/unit/domain/value-objects/ToolCall.test.ts
@@ -0,0 +1,31 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest"
+import { createToolCall } from "../../../../src/domain/value-objects/ToolCall.js"
+
+describe("ToolCall", () => {
+    beforeEach(() => {
+        vi.useFakeTimers()
+        vi.setSystemTime(new Date("2025-01-01T00:00:00Z"))
+    })
+
+    afterEach(() => {
+        vi.useRealTimers()
+    })
+
+    describe("createToolCall", () => {
+        it("should create tool call with all fields", () => {
+            const params = { path: "test.ts", line: 10 }
+            const call = createToolCall("call-1", "get_lines", params)
+
+            expect(call.id).toBe("call-1")
+            expect(call.name).toBe("get_lines")
+            expect(call.params).toEqual(params)
+            expect(call.timestamp).toBe(Date.now())
+        })
+
+        it("should handle empty params", () => {
+            const call = createToolCall("call-2", "git_status", {})
+
+            expect(call.params).toEqual({})
+        })
+    })
+})
--- a/packages/ipuaro/tests/unit/domain/value-objects/ToolResult.test.ts
+++ b/packages/ipuaro/tests/unit/domain/value-objects/ToolResult.test.ts
@@ -0,0 +1,32 @@
+import { describe, it, expect } from "vitest"
+import {
+    createSuccessResult,
+    createErrorResult,
+} from "../../../../src/domain/value-objects/ToolResult.js"
+
+describe("ToolResult", () => {
+    describe("createSuccessResult", () => {
+        it("should create success result", () => {
+            const data = { lines: ["line1", "line2"] }
+            const result = createSuccessResult("call-1", data, 50)
+
+            expect(result.callId).toBe("call-1")
+            expect(result.success).toBe(true)
+            expect(result.data).toEqual(data)
+            expect(result.executionTimeMs).toBe(50)
+            expect(result.error).toBeUndefined()
+        })
+    })
+
+    describe("createErrorResult", () => {
+        it("should create error result", () => {
+            const result = createErrorResult("call-2", "File not found", 10)
+
+            expect(result.callId).toBe("call-2")
+            expect(result.success).toBe(false)
+            expect(result.error).toBe("File not found")
+            expect(result.executionTimeMs).toBe(10)
+            expect(result.data).toBeUndefined()
+        })
+    })
+})
--- a/packages/ipuaro/tests/unit/domain/value-objects/UndoEntry.test.ts
+++ b/packages/ipuaro/tests/unit/domain/value-objects/UndoEntry.test.ts
@@ -0,0 +1,87 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest"
+import {
+    createUndoEntry,
+    canUndo,
+} from "../../../../src/domain/value-objects/UndoEntry.js"
+
+describe("UndoEntry", () => {
+    beforeEach(() => {
+        vi.useFakeTimers()
+        vi.setSystemTime(new Date("2025-01-01T00:00:00Z"))
+    })
+
+    afterEach(() => {
+        vi.useRealTimers()
+    })
+
+    describe("createUndoEntry", () => {
+        it("should create undo entry with all fields", () => {
+            const entry = createUndoEntry(
+                "undo-1",
+                "test.ts",
+                ["old line"],
+                ["new line"],
+                "Edit line 1"
+            )
+
+            expect(entry.id).toBe("undo-1")
+            expect(entry.filePath).toBe("test.ts")
+            expect(entry.previousContent).toEqual(["old line"])
+            expect(entry.newContent).toEqual(["new line"])
+            expect(entry.description).toBe("Edit line 1")
+            expect(entry.timestamp).toBe(Date.now())
+            expect(entry.toolCallId).toBeUndefined()
+        })
+
+        it("should create undo entry with toolCallId", () => {
+            const entry = createUndoEntry(
+                "undo-2",
+                "test.ts",
+                [],
+                [],
+                "Create file",
+                "tool-123"
+            )
+
+            expect(entry.toolCallId).toBe("tool-123")
+        })
+    })
+
+    describe("canUndo", () => {
+        it("should return true when current content matches newContent", () => {
+            const entry = createUndoEntry(
+                "undo-1",
+                "test.ts",
+                ["old"],
+                ["new"],
+                "Edit"
+            )
+
+            expect(canUndo(entry, ["new"])).toBe(true)
+        })
+
+        it("should return false when content differs", () => {
+            const entry = createUndoEntry(
+                "undo-1",
+                "test.ts",
+                ["old"],
+                ["new"],
+                "Edit"
+            )
+
+            expect(canUndo(entry, ["modified"])).toBe(false)
+        })
+
+        it("should return false when length differs", () => {
+            const entry = createUndoEntry(
+                "undo-1",
+                "test.ts",
+                ["old"],
+                ["new"],
+                "Edit"
+            )
+
+            expect(canUndo(entry, ["new", "extra"])).toBe(false)
+        })
+    })
+})
--- a/packages/ipuaro/tests/unit/shared/config/loader.test.ts
+++ b/packages/ipuaro/tests/unit/shared/config/loader.test.ts
@@ -0,0 +1,80 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest"
+import { loadConfig, validateConfig, getConfigErrors } from "../../../../src/shared/config/loader.js"
+import { DEFAULT_CONFIG } from "../../../../src/shared/constants/config.js"
+import * as fs from "node:fs"
+
+vi.mock("node:fs")
+
+describe("config loader", () => {
+    beforeEach(() => {
+        vi.resetAllMocks()
+    })
+
+    afterEach(() => {
+        vi.restoreAllMocks()
+    })
+
+    describe("loadConfig", () => {
+        it("should return default config when no files exist", () => {
+            vi.mocked(fs.existsSync).mockReturnValue(false)
+
+            const config = loadConfig("/project")
+
+            expect(config).toEqual(DEFAULT_CONFIG)
+        })
+
+        it("should merge project config with defaults", () => {
+            vi.mocked(fs.existsSync).mockImplementation((path) => {
+                return path === "/project/.ipuaro.json"
+            })
+            vi.mocked(fs.readFileSync).mockReturnValue(
+                JSON.stringify({ llm: { model: "custom-model" } })
+            )
+
+            const config = loadConfig("/project")
+
+            expect(config.llm.model).toBe("custom-model")
+            expect(config.redis.host).toBe("localhost")
+        })
+
+        it("should handle invalid JSON gracefully", () => {
+            vi.mocked(fs.existsSync).mockReturnValue(true)
+            vi.mocked(fs.readFileSync).mockReturnValue("invalid json")
+
+            const config = loadConfig("/project")
+
+            expect(config).toEqual(DEFAULT_CONFIG)
+        })
+    })
+
+    describe("validateConfig", () => {
+        it("should return true for valid config", () => {
+            expect(validateConfig(DEFAULT_CONFIG)).toBe(true)
+        })
+
+        it("should return true for partial valid config", () => {
+            expect(validateConfig({ redis: { host: "redis.local" } })).toBe(true)
+        })
+
+        it("should return false for invalid config", () => {
+            expect(validateConfig({ redis: { port: "not a number" } })).toBe(false)
+        })
+    })
+
+    describe("getConfigErrors", () => {
+        it("should return empty array for valid config", () => {
+            const errors = getConfigErrors(DEFAULT_CONFIG)
+
+            expect(errors).toHaveLength(0)
+        })
+
+        it("should return errors for invalid config", () => {
+            const errors = getConfigErrors({
+                redis: { port: "invalid" },
+            })
+
+            expect(errors.length).toBeGreaterThan(0)
+            expect(errors[0]).toContain("redis.port")
+        })
+    })
+})
--- a/packages/ipuaro/tests/unit/shared/constants/messages.test.ts
+++ b/packages/ipuaro/tests/unit/shared/constants/messages.test.ts
@@ -0,0 +1,48 @@
+import { describe, it, expect } from "vitest"
+import { MESSAGES } from "../../../../src/shared/constants/messages.js"
+
+describe("MESSAGES", () => {
+    it("should have status messages", () => {
+        expect(MESSAGES.STATUS_READY).toBe("Ready")
+        expect(MESSAGES.STATUS_THINKING).toBe("Thinking...")
+        expect(MESSAGES.STATUS_INDEXING).toBe("Indexing...")
+        expect(MESSAGES.STATUS_ERROR).toBe("Error")
+    })
+
+    it("should have error messages", () => {
+        expect(MESSAGES.ERROR_REDIS_UNAVAILABLE).toContain("Redis")
+        expect(MESSAGES.ERROR_OLLAMA_UNAVAILABLE).toContain("Ollama")
+        expect(MESSAGES.ERROR_MODEL_NOT_FOUND).toContain("Model")
+        expect(MESSAGES.ERROR_FILE_NOT_FOUND).toBe("File not found")
+        expect(MESSAGES.ERROR_PARSE_FAILED).toContain("parse")
+        expect(MESSAGES.ERROR_TOOL_FAILED).toContain("Tool")
+        expect(MESSAGES.ERROR_COMMAND_BLACKLISTED).toContain("blacklisted")
+        expect(MESSAGES.ERROR_PATH_OUTSIDE_PROJECT).toContain("outside")
+    })
+
+    it("should have confirmation messages", () => {
+        expect(MESSAGES.CONFIRM_APPLY_EDIT).toContain("Apply")
+        expect(MESSAGES.CONFIRM_DELETE_FILE).toContain("Delete")
+        expect(MESSAGES.CONFIRM_RUN_COMMAND).toContain("Run")
+        expect(MESSAGES.CONFIRM_CREATE_FILE).toContain("Create")
+        expect(MESSAGES.CONFIRM_GIT_COMMIT).toContain("commit")
+    })
+
+    it("should have info messages", () => {
+        expect(MESSAGES.INFO_SESSION_LOADED).toContain("loaded")
+        expect(MESSAGES.INFO_SESSION_CREATED).toContain("created")
+        expect(MESSAGES.INFO_INDEXING_COMPLETE).toContain("complete")
+        expect(MESSAGES.INFO_EDIT_APPLIED).toContain("applied")
+        expect(MESSAGES.INFO_EDIT_CANCELLED).toContain("cancelled")
+        expect(MESSAGES.INFO_UNDO_SUCCESS).toContain("reverted")
+        expect(MESSAGES.INFO_UNDO_EMPTY).toContain("Nothing")
+    })
+
+    it("should have help text", () => {
+        expect(MESSAGES.HELP_COMMANDS).toContain("/help")
+        expect(MESSAGES.HELP_COMMANDS).toContain("/clear")
+        expect(MESSAGES.HELP_COMMANDS).toContain("/undo")
+        expect(MESSAGES.HELP_HOTKEYS).toContain("Ctrl+C")
+        expect(MESSAGES.HELP_HOTKEYS).toContain("Ctrl+D")
+    })
+})
--- a/packages/ipuaro/tests/unit/shared/errors/IpuaroError.test.ts
+++ b/packages/ipuaro/tests/unit/shared/errors/IpuaroError.test.ts
@@ -0,0 +1,86 @@
+import { describe, it, expect } from "vitest"
+import { IpuaroError } from "../../../../src/shared/errors/IpuaroError.js"
+
+describe("IpuaroError", () => {
+    describe("constructor", () => {
+        it("should create error with all fields", () => {
+            const error = new IpuaroError("file", "Not found", true, "Check path")
+
+            expect(error.name).toBe("IpuaroError")
+            expect(error.type).toBe("file")
+            expect(error.message).toBe("Not found")
+            expect(error.recoverable).toBe(true)
+            expect(error.suggestion).toBe("Check path")
+        })
+
+        it("should default recoverable to true", () => {
+            const error = new IpuaroError("parse", "Parse failed")
+
+            expect(error.recoverable).toBe(true)
+        })
+    })
+
+    describe("static factories", () => {
+        it("should create redis error", () => {
+            const error = IpuaroError.redis("Connection failed")
+
+            expect(error.type).toBe("redis")
+            expect(error.recoverable).toBe(false)
+            expect(error.suggestion).toContain("Redis")
+        })
+
+        it("should create parse error", () => {
+            const error = IpuaroError.parse("Syntax error", "test.ts")
+
+            expect(error.type).toBe("parse")
+            expect(error.message).toContain("test.ts")
+            expect(error.recoverable).toBe(true)
+        })
+
+        it("should create parse error without file", () => {
+            const error = IpuaroError.parse("Syntax error")
+
+            expect(error.message).toBe("Syntax error")
+        })
+
+        it("should create llm error", () => {
+            const error = IpuaroError.llm("Timeout")
+
+            expect(error.type).toBe("llm")
+            expect(error.recoverable).toBe(true)
+            expect(error.suggestion).toContain("Ollama")
+        })
+
+        it("should create file error", () => {
+            const error = IpuaroError.file("Not found")
+
+            expect(error.type).toBe("file")
+        })
+
+        it("should create command error", () => {
+            const error = IpuaroError.command("Blacklisted")
+
+            expect(error.type).toBe("command")
+        })
+
+        it("should create conflict error", () => {
+            const error = IpuaroError.conflict("File changed")
+
+            expect(error.type).toBe("conflict")
+            expect(error.suggestion).toContain("Regenerate")
+        })
+
+        it("should create validation error", () => {
+            const error = IpuaroError.validation("Invalid param")
+
+            expect(error.type).toBe("validation")
+        })
+
+        it("should create timeout error", () => {
+            const error = IpuaroError.timeout("Request timeout")
+
+            expect(error.type).toBe("timeout")
+            expect(error.suggestion).toContain("timeout")
+        })
+    })
+})
--- a/packages/ipuaro/tests/unit/shared/types/index.test.ts
+++ b/packages/ipuaro/tests/unit/shared/types/index.test.ts
@@ -0,0 +1,51 @@
+import { describe, it, expect } from "vitest"
+import { ok, err, isOk, isErr, type Result } from "../../../../src/shared/types/index.js"
+
+describe("Result type", () => {
+    describe("ok", () => {
+        it("should create success result", () => {
+            const result = ok("data")
+
+            expect(result.success).toBe(true)
+            expect(result.data).toBe("data")
+        })
+    })
+
+    describe("err", () => {
+        it("should create error result", () => {
+            const error = new Error("failed")
+            const result = err(error)
+
+            expect(result.success).toBe(false)
+            expect(result.error).toBe(error)
+        })
+    })
+
+    describe("isOk", () => {
+        it("should return true for success", () => {
+            const result: Result<string> = ok("data")
+
+            expect(isOk(result)).toBe(true)
+        })
+
+        it("should return false for error", () => {
+            const result: Result<string> = err(new Error("fail"))
+
+            expect(isOk(result)).toBe(false)
+        })
+    })
+
+    describe("isErr", () => {
+        it("should return true for error", () => {
+            const result: Result<string> = err(new Error("fail"))
+
+            expect(isErr(result)).toBe(true)
+        })
+
+        it("should return false for success", () => {
+            const result: Result<string> = ok("data")
+
+            expect(isErr(result)).toBe(false)
+        })
+    })
+})
--- a/packages/ipuaro/tests/unit/shared/utils/hash.test.ts
+++ b/packages/ipuaro/tests/unit/shared/utils/hash.test.ts
@@ -0,0 +1,56 @@
+import { describe, it, expect } from "vitest"
+import { md5, hashLines, shortHash } from "../../../../src/shared/utils/hash.js"
+
+describe("hash utils", () => {
+    describe("md5", () => {
+        it("should return consistent hash for same input", () => {
+            const hash1 = md5("hello")
+            const hash2 = md5("hello")
+
+            expect(hash1).toBe(hash2)
+        })
+
+        it("should return different hash for different input", () => {
+            const hash1 = md5("hello")
+            const hash2 = md5("world")
+
+            expect(hash1).not.toBe(hash2)
+        })
+
+        it("should return 32 character hex string", () => {
+            const hash = md5("test")
+
+            expect(hash).toHaveLength(32)
+            expect(hash).toMatch(/^[a-f0-9]+$/)
+        })
+    })
+
+    describe("hashLines", () => {
+        it("should hash joined lines", () => {
+            const lines = ["line1", "line2", "line3"]
+            const hash = hashLines(lines)
+
+            expect(hash).toBe(md5("line1\nline2\nline3"))
+        })
+
+        it("should handle empty array", () => {
+            const hash = hashLines([])
+
+            expect(hash).toBe(md5(""))
+        })
+    })
+
+    describe("shortHash", () => {
+        it("should return truncated hash", () => {
+            const hash = shortHash("test")
+
+            expect(hash).toHaveLength(8)
+        })
+
+        it("should accept custom length", () => {
+            const hash = shortHash("test", 12)
+
+            expect(hash).toHaveLength(12)
+        })
+    })
+})
--- a/packages/ipuaro/tests/unit/shared/utils/tokens.test.ts
+++ b/packages/ipuaro/tests/unit/shared/utils/tokens.test.ts
@@ -0,0 +1,61 @@
+import { describe, it, expect } from "vitest"
+import {
+    estimateTokens,
+    estimateTokensForLines,
+    truncateToTokens,
+    formatTokenCount,
+} from "../../../../src/shared/utils/tokens.js"
+
+describe("tokens utils", () => {
+    describe("estimateTokens", () => {
+        it("should estimate ~4 chars per token", () => {
+            expect(estimateTokens("")).toBe(0)
+            expect(estimateTokens("test")).toBe(1)
+            expect(estimateTokens("12345678")).toBe(2)
+        })
+
+        it("should round up", () => {
+            expect(estimateTokens("12345")).toBe(2)
+        })
+    })
+
+    describe("estimateTokensForLines", () => {
+        it("should estimate tokens for array of lines", () => {
+            const lines = ["line1", "line2"]
+            const expected = estimateTokens("line1\nline2")
+
+            expect(estimateTokensForLines(lines)).toBe(expected)
+        })
+
+        it("should handle empty array", () => {
+            expect(estimateTokensForLines([])).toBe(0)
+        })
+    })
+
+    describe("truncateToTokens", () => {
+        it("should not truncate short text", () => {
+            const text = "short"
+            expect(truncateToTokens(text, 10)).toBe(text)
+        })
+
+        it("should truncate long text", () => {
+            const text = "a".repeat(100)
+            const result = truncateToTokens(text, 10)
+
+            expect(result).toBe("a".repeat(40) + "...")
+        })
+    })
+
+    describe("formatTokenCount", () => {
+        it("should format small numbers as-is", () => {
+            expect(formatTokenCount(500)).toBe("500")
+            expect(formatTokenCount(999)).toBe("999")
+        })
+
+        it("should format thousands with k suffix", () => {
+            expect(formatTokenCount(1000)).toBe("1.0k")
+            expect(formatTokenCount(1500)).toBe("1.5k")
+            expect(formatTokenCount(12345)).toBe("12.3k")
+        })
+    })
+})
--- a/packages/ipuaro/tsconfig.json
+++ b/packages/ipuaro/tsconfig.json
@@ -0,0 +1,21 @@
+{
+    "compilerOptions": {
+        "module": "nodenext",
+        "moduleResolution": "nodenext",
+        "target": "ES2023",
+        "outDir": "./dist",
+        "rootDir": "./src",
+        "jsx": "react-jsx",
+        "jsxImportSource": "react",
+        "declaration": true,
+        "declarationMap": true,
+        "sourceMap": true,
+        "strict": true,
+        "skipLibCheck": true,
+        "esModuleInterop": true,
+        "resolvePackageJsonExports": true,
+        "forceConsistentCasingInFileNames": true
+    },
+    "include": ["src/**/*"],
+    "exclude": ["node_modules", "dist", "tests"]
+}
--- a/packages/ipuaro/tsup.config.ts
+++ b/packages/ipuaro/tsup.config.ts
@@ -0,0 +1,19 @@
+import { defineConfig } from "tsup"
+
+export default defineConfig({
+    entry: ["src/index.ts", "src/cli/index.ts"],
+    format: ["esm"],
+    dts: true,
+    clean: true,
+    sourcemap: true,
+    splitting: false,
+    treeshake: true,
+    external: [
+        "tree-sitter",
+        "tree-sitter-typescript",
+        "tree-sitter-javascript",
+    ],
+    esbuildOptions(options) {
+        options.jsx = "automatic"
+    },
+})
--- a/packages/ipuaro/vitest.config.ts
+++ b/packages/ipuaro/vitest.config.ts
@@ -0,0 +1,25 @@
+import { defineConfig } from "vitest/config"
+
+export default defineConfig({
+    test: {
+        globals: true,
+        environment: "node",
+        include: ["tests/**/*.test.ts"],
+        coverage: {
+            provider: "v8",
+            reporter: ["text", "html", "lcov"],
+            include: ["src/**/*.ts", "src/**/*.tsx"],
+            exclude: [
+                "src/**/*.d.ts",
+                "src/**/index.ts",
+                "src/**/*.test.ts",
+            ],
+            thresholds: {
+                lines: 80,
+                functions: 80,
+                branches: 80,
+                statements: 80,
+            },
+        },
+    },
+})