newo 3.0.0 → 3.2.0

package/CHANGELOG.md

@@ -2,429 +2,526 @@
 
 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/),
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [3.0.0] - 2025-01-30
-
-### 🏗️ MAJOR FEATURE: Complete Entity Management System
-
-**Local-First Development Workflow:**
-- Create entities locally with full metadata
-- Edit in your preferred IDE with proper file extensions
-- Push to platform when ready - automatic detection and creation
-- Full lifecycle management for all NEWO entities
-
-### ✨ New Entity Creation Commands (12 commands)
-
-**Project & Infrastructure:**
-- `newo create-project <idn>` - Create new projects on platform
-- `newo create-persona <name>` - Create agent personas
-- `newo create-attribute <idn>` - Create customer attributes
-
-**Agent Structure:**
-- `newo create-agent <idn> --project <pid>` - Create agents locally with metadata
-- `newo create-flow <idn> --agent <aid>` - Create flows with guidance/NSL runner selection
-- `newo create-skill <idn> --flow <fid>` - Create skills with script content initialization
-
-**NSL Components:**
-- `newo create-event <idn> --flow <fid>` - Create flow events for integrations
-- `newo create-state <idn> --flow <fid>` - Create flow state fields (user/flow/global scope)
-- `newo create-parameter <name> --skill <sid>` - Create skill parameters
-
-### 🗑️ New Entity Deletion Commands (3 commands)
-
-**Safe Deletion with Confirmation:**
-- `newo delete-agent <aid> --confirm` - Delete agent locally (requires --confirm flag)
-- `newo delete-flow <fid> --confirm` - Delete flow locally (requires --confirm flag)
-- `newo delete-skill <sid> --confirm` - Delete skill locally (requires --confirm flag)
-
-**Push-to-Sync:** Run `newo push` after deletion to sync changes to platform
-
-### 🔄 Enhanced Push Operation
-
-**Automatic Local-Only Entity Detection:**
-- Filesystem scanning for entities not yet in project map
-- Automatic detection of new agents, flows, and skills
-- Creates missing entities on platform in correct hierarchical order
-- Publishes flows after creation
-- Maintains proper agent → flow → skill relationships
-- Updates existing skills with changes
-
-### 📊 Enhanced Status Command
-
-**Comprehensive Change Detection:**
-- Scans for local-only entities not yet on platform
-- Reports new agents/flows/skills awaiting sync
-- Shows full entity lifecycle status
-- Hierarchical display of project structure
-
-### 🌐 New API Integrations (19 endpoints)
-
-**Entity Creation:**
-- `POST /api/v2/designer/{projectId}/agents` - Create agent
-- `POST /api/v1/designer/{agentId}/flows/empty` - Create flow
-- `POST /api/v1/designer/flows/{flowId}/skills` - Create skill
-- `POST /api/v1/designer/flows/{flowId}/events` - Create event
-- `POST /api/v1/designer/flows/{flowId}/states` - Create state
-- `POST /api/v1/designer/flows/skills/{skillId}/parameters` - Create parameter
-- `POST /api/v1/customer/attributes` - Create attribute
-- `POST /api/v1/designer/personas` - Create persona
-- `POST /api/v1/designer/projects` - Create project
-- `POST /api/v1/designer/flows/{flowId}/publish` - Publish flow
-
-**Entity Deletion:**
-- `DELETE /api/v1/designer/agents/{agentId}` - Delete agent
-- `DELETE /api/v1/designer/flows/{flowId}` - Delete flow
-- `DELETE /api/v1/designer/flows/skills/{skillId}` - Delete skill
-- `DELETE /api/v1/designer/flows/events/{eventId}` - Delete event
-
-### 📚 Documentation Updates
-
-**README.md (+146 lines):**
-- New "Entity Management Commands" section with comprehensive command reference
-- "Entity Creation Workflows" section with end-to-end examples
-- Complete Weather System example demonstrating full lifecycle
-- Quick Agent Creation patterns
-- Local Development & Testing workflows
-- Entity Deletion procedures
-- Updated Key Features section highlighting entity management
-- Enhanced Quick Start with entity creation steps
-- Expanded API Reference with 19 new endpoints
-
-### 🔧 Technical Improvements
-
-**TypeScript Enhancements:**
-- 19 new type definitions for entity creation/deletion requests and responses
-- Enhanced API client with new endpoint methods
-- Comprehensive error handling for entity operations
-
-**Architecture:**
-- 14 new command files in modular architecture (src/cli/commands/)
-- Enhanced push.ts with local-only entity scanning (~418 lines added)
-- Enhanced status.ts with entity detection (~184 lines added)
-- Type-safe entity creation with full metadata support
-
-### 🎯 Use Cases Enabled
-
-**Complete Project Scaffolding:**
-- Bootstrap entire projects from CLI
-- Create full agent structures locally
-- Test locally before platform deployment
-
-**Rapid Development:**
-- Create agents, flows, and skills in seconds
-- No web UI context switching required
-- Full IDE integration with syntax highlighting
-
-**Safe Entity Management:**
-- Confirmation flags prevent accidental deletions
-- Local-first approach enables version control
-- Push-to-sync provides controlled deployment
-
-### 📊 Statistics
-- **Commands Added**: 15 new commands (12 create, 3 delete)
-- **API Endpoints**: 19 new integrations
-- **Code Changes**: ~1,005 lines added across 7 modified files
-- **Documentation**: +146 lines in README.md
-- **Type Definitions**: 19 new interfaces and types
+## [Unreleased]
+
+## [3.2.0] - 2025-10-17
+
+### Added
+
+- **Integration Management**: Complete integration and connector management system
+  - `newo pull-integrations` - Download all integrations, connectors, and webhooks to local YAML files
+  - `newo push-integrations` - Upload connector changes with full CRUD support (Create, Update, Delete)
+  - Combined integration files: `{integration_idn}.yaml` contains metadata + settings in single file
+  - Nested connector structure: Each connector in own subdirectory `connectors/{connector_idn}/{connector_idn}.yaml`
+  - Automatic webhook synchronization (outgoing + incoming webhooks)
+  - 15 integrations discovered and managed (api, sandbox, twilio, magic_browser, newo_chat, etc.)
+  - Full connector lifecycle: Create via YAML + push → Modify → Delete via YAML removal + push
+- **AKB Knowledge Base Management**: Complete knowledge base synchronization
+  - `newo pull-akb` - Download AKB articles for all personas linked to agents
+  - `newo push-akb` - Upload AKB articles from local YAML files to platform
+  - YAML format matches backup structure exactly for compatibility
+  - Automatic persona-to-agent mapping via agent IDN
+  - Pagination support for large knowledge bases
+  - Articles stored in `akb/{agent_idn}.yaml` format
+- **Project Attributes**: Full project-level attribute management
+  - Enhanced `newo pull-attributes` to pull both customer AND project attributes
+  - Project attributes saved to `projects/{project_idn}/attributes.yaml`
+  - Push integrated into main `newo push` command
+  - Automatic ID mapping for push operations
+  - Same YAML format as customer attributes with !enum tags
+  - Change detection and update mechanism
+- **Developer Tools**: Reference and productivity features
+  - `newo list-actions` - List all 78 available NSL/Jinja script actions with categorization
+  - `newo profile` - Display customer profile information (organization, email, platform links)
+  - Action categorization into 12 groups (Gen, Get, Create, Delete, Update, etc.)
+  - Verbose mode shows complete parameter schemas for each action
+- **API Integrations**: 17 new API endpoints
+  - Integration endpoints: GET integrations, connectors, settings
+  - Connector CRUD: POST, PUT, DELETE for connectors
+  - Webhook endpoints: GET outgoing/incoming webhooks
+  - AKB endpoints: GET personas, topics; POST import
+  - Project attribute endpoints: GET, PUT for project attributes
+  - Script actions endpoint: GET all NSL actions
+  - Customer profile endpoint: GET profile information
+- **TypeScript Types**: 22 new interfaces for complete type safety
+  - Integration types: Integration, Connector, IntegrationSetting, CreateConnectorRequest, UpdateConnectorRequest
+  - Webhook types: OutgoingWebhook, IncomingWebhook
+  - AKB types: Persona, AkbTopic, AkbTopicItem, AkbYamlTopic
+  - Script action types: ScriptAction, ArgumentSchema
+  - Metadata types: IntegrationMetadata, ConnectorMetadata, IntegrationsYamlData
+
+### Changed
+
+- **File Structure**: Enhanced directory hierarchy with new integration and AKB folders
+  - `newo_customers/{customer}/integrations/` - Integration configurations
+  - `newo_customers/{customer}/akb/` - AKB knowledge base articles
+  - `newo_customers/{customer}/projects/{project}/attributes.yaml` - Project attributes
+- **Pull Attributes Command**: Now pulls both customer and project attributes in single command
+- **Push Command**: Enhanced to push project attribute changes alongside skill changes
+- **Help Documentation**: Comprehensive updates with all new commands and file structure
+- **Integration Structure**: Nested connector directories with webhook subdirectories
+  - `integrations/{integration}/{integration}.yaml` - Combined metadata + settings
+  - `integrations/{integration}/connectors/{connector}/{connector}.yaml` - Connector config
+  - `integrations/{integration}/connectors/{connector}/webhooks/` - Webhook files
+
+### Technical Details
+
+- **Modular Architecture**: 8 new modules created
+  - `src/sync/integrations.ts` (340+ lines) - Integration/connector/webhook sync
+  - `src/sync/akb.ts` (205 lines) - AKB knowledge base sync
+  - `src/cli/commands/pull-integrations.ts` - Integration pull handler
+  - `src/cli/commands/push-integrations.ts` - Integration push handler
+  - `src/cli/commands/pull-akb.ts` - AKB pull handler
+  - `src/cli/commands/push-akb.ts` - AKB push handler
+  - `src/cli/commands/list-actions.ts` - Script actions listing
+  - `src/cli/commands/profile.ts` - Profile viewer
+- **Enhanced Modules**: 6 existing modules updated
+  - `src/types.ts` (+160 lines) - New type definitions
+  - `src/api.ts` (+110 lines) - New API functions
+  - `src/sync/attributes.ts` (+126 lines) - Project attribute support
+  - `src/sync/push.ts` (+15 lines) - Project attribute push integration
+  - `src/cli.ts` (+12 lines) - New command routing
+  - `src/cli/commands/help.ts` (+30 lines) - Documentation updates
+- **Webhook Association**: Webhooks grouped by connector_idn and stored in connector subdirectories
+- **Change Detection**: Smart comparison for connectors (title, status, settings)
+- **Error Handling**: Graceful handling of missing settings endpoints (404 errors)
+- **ID Mapping**: Separate JSON files for attribute ID mappings to enable push operations
+- **YAML Parsing**: Custom !enum tag handling for AttributeValueTypes
+
+### Example Usage
+
+```bash
+# Integration management
+newo pull-integrations                    # Download all integrations + webhooks
+newo push-integrations                    # Upload connector changes
+
+# Knowledge base management
+newo pull-akb                             # Download AKB for personas with agents
+newo push-akb                             # Upload AKB articles
+
+# Enhanced attributes
+newo pull-attributes                      # Now pulls customer + project attributes
+newo push                                 # Now pushes project attributes too
+
+# Developer tools
+newo profile                              # View customer information
+newo list-actions                         # Browse 78 NSL actions
+newo list-actions --verbose               # With parameter details
+```
+
+### Files Created
+
+**Integration Structure:**
+```
+newo_customers/{customer}/integrations/
+├── integrations.yaml
+└── {integration_idn}/
+    ├── {integration_idn}.yaml           # Combined metadata + settings
+    └── connectors/
+        └── {connector_idn}/
+            ├── {connector_idn}.yaml
+            └── webhooks/
+                ├── outgoing.yaml
+                └── incoming.yaml
+```
+
+**AKB Structure:**
+```
+newo_customers/{customer}/akb/
+└── {agent_idn}.yaml                     # AKB articles per agent
+```
+
+**Project Attributes:**
+```
+newo_customers/{customer}/projects/{project}/
+└── attributes.yaml                      # Project-specific attributes
+```
+
+### Breaking Changes
+
+None. All changes are additive and backward compatible.
+
+## [3.1.0] - 2025-10-15
+
+### Added
+
+- **Sandbox Chat Testing**: Real-time agent testing with interactive sandbox mode
+  - `newo sandbox "<message>"` - Single-command mode for automated testing workflows
+  - `newo sandbox --actor <id> "message"` - Multi-turn conversation continuation
+  - Automatic persona/actor creation with unique naming (`newo-cli-{guid}`)
+  - Chat History API polling with 1-second intervals, 60-second timeout
+  - Debug information extraction (flow_idn, skill_idn, session_id, runtime_context_id)
+  - Quiet mode (`--quiet`/`-q`) for script-friendly output with minimal logging
+  - Single newest message display to avoid overwhelming output
+- **Sandbox API Integration**: 6 new endpoints for sandbox chat functionality
+  - `GET /api/v1/integrations` - List available integrations
+  - `GET /api/v1/integrations/{id}/connectors` - List integration connectors
+  - `POST /api/v1/customer/personas` - Create user persona for sandbox testing
+  - `POST /api/v1/customer/personas/{id}/actors` - Create actor (chat session)
+  - `POST /api/v1/chat/user/{actorId}` - Send chat message
+  - Reused `GET /api/v1/chat/history` - Poll for agent responses with timestamp filtering
+- **Sandbox Utilities Module** (`src/sandbox/chat.ts`):
+  - `findSandboxConnector()` - Locate running sandbox connectors
+  - `createChatSession()` - Initialize new chat sessions with unique personas
+  - `sendMessage()` - Send messages with timestamp tracking for response filtering
+  - `pollForResponse()` - Intelligent polling with timestamp-based message filtering
+  - `extractAgentMessages()` - Filter and extract agent responses from chat history
+  - `formatDebugInfo()` - Format debug information for developer inspection
+- **TypeScript Types**: Comprehensive type definitions for sandbox functionality
+  - `Integration`, `Connector` - Integration and connector management
+  - `SandboxChatSession` - Session state tracking with persona/actor IDs
+  - `ChatDebugInfo` - Debug information structure for agent development
+  - `CreateSandboxPersonaRequest/Response` - Persona creation types
+  - `CreateActorRequest/Response` - Actor creation types
+  - `SendChatMessageRequest` - Chat message sending types
+- **Enhanced Authentication**: Quiet mode support to suppress logging during automated testing
+- **Documentation**: Comprehensive sandbox testing section with usage examples and automation patterns
+
+### Changed
+
+- **CLI Architecture**: Added sandbox command routing in main CLI module
+- **API Module**: Extended with sandbox-specific endpoint integrations
+- **Help Command**: Updated with sandbox command reference
+- **README**: Added extensive sandbox testing documentation with multi-turn examples (+101 lines)
+
+### Technical Details
+
+- **Message Filtering**: Timestamp-based filtering ensures only new messages shown after user sends message
+- **Session Isolation**: Each sandbox test creates unique persona with GUID to prevent state interference
+- **Polling Strategy**: 1-second intervals with 60-second max wait for agent responses
+- **Error Handling**: Graceful degradation with timeout messages and continuation guidance
+- **Debug Modes**: Standard (condensed) and verbose (detailed) debug information display
+- **Quiet Mode**: Minimal output perfect for shell scripts and CI/CD integration
+
+### Example Usage
+
+```bash
+# Start new conversation
+newo sandbox "Hello, I want to order pizza"
+
+# Continue conversation with actor ID from previous response
+newo sandbox --actor abc123... "I want 2 large pepperoni pizzas"
+
+# Verbose mode for debugging
+newo sandbox "Test message" --verbose
+
+# Quiet mode for automation
+newo sandbox "Test query" --quiet
+```
+
+## [3.0.0] - 2025-09-29
+
+### Added
+
+- **Entity Creation Commands**: 12 new commands for creating NEWO entities locally
+  - `newo create-project <idn>` - Create new projects on platform
+  - `newo create-persona <name>` - Create agent personas
+  - `newo create-attribute <idn>` - Create customer attributes
+  - `newo create-agent <idn> --project <pid>` - Create agents locally with metadata
+  - `newo create-flow <idn> --agent <aid>` - Create flows with guidance/NSL runner selection
+  - `newo create-skill <idn> --flow <fid>` - Create skills with script content initialization
+  - `newo create-event <idn> --flow <fid>` - Create flow events for integrations
+  - `newo create-state <idn> --flow <fid>` - Create flow state fields (user/flow/global scope)
+  - `newo create-parameter <name> --skill <sid>` - Create skill parameters
+- **Entity Deletion Commands**: 3 new commands with confirmation flags
+  - `newo delete-agent <aid> --confirm` - Delete agent locally
+  - `newo delete-flow <fid> --confirm` - Delete flow locally
+  - `newo delete-skill <sid> --confirm` - Delete skill locally
+- **API Integrations**: 19 new endpoints for entity creation, deletion, and publishing
+- **Documentation**: Entity Management Commands section with workflows and examples (+146 lines)
+- **TypeScript Types**: 19 new type definitions for entity operations
+
+### Changed
+
+- **Push Command**: Now automatically detects and creates local-only entities on platform
+  - Filesystem scanning for entities not yet in project map
+  - Creates missing entities in correct hierarchical order (agent → flow → skill)
+  - Publishes flows after creation
+- **Status Command**: Enhanced with comprehensive change detection
+  - Scans for local-only entities not yet on platform
+  - Reports new agents/flows/skills awaiting sync
+  - Hierarchical display of project structure
+- **Architecture**: Added 14 new command modules in src/cli/commands/
+- **Push Module**: Enhanced with local-only entity scanning (~418 lines)
+- **Status Module**: Enhanced with entity detection (~184 lines)
+
+## [2.0.6] - 2025-09-18
+
+### Changed
+
+- Implement proper LCS-based diff algorithm for accurate change detection
+- Clean, accurate differences with proper line matching
+- Improved algorithm eliminates false positives and shows precise modifications
+
+## [2.0.5] - 2025-09-18
+
+### Fixed
+
+- Correct diff algorithm to show clean, accurate differences
+- Improved change detection with proper context preservation
+
+## [2.0.4] - 2025-09-18
+
+### Changed
+
+- Implement exact GitHub diff format with proper context lines
+- GitHub-style diff with background colors and context
+- Enhanced diff display with line numbers and clearer messaging
+
+## [2.0.3] - 2025-09-18
+
+### Changed
+
+- Improve diff display with line numbers and clearer messaging
+- Better visual distinction for changes with colored output
+
+## [2.0.2] - 2025-09-18
+
+### Added
+
+- GitHub-style colored diff display for overwrite prompts
+- Enhanced diff visualization with colors and formatting
+
+## [2.0.1] - 2025-09-18
+
+### Fixed
+
+- Improve overwrite handling with proper 'all' option support
+- Better handling of batch overwrite operations
 
 ## [1.9.3] - 2025-09-17
 
-### 🏗️ Major Architecture Refactoring
+### Changed
 
-**CLI Module Restructuring:**
 - **BREAKING**: Main CLI entry point moved from `dist/cli.js` to `dist/cli/index.js`
-- Split monolithic 500+ line `cli.ts` into focused modules:
+- Split monolithic 500+ line `cli.ts` into focused modules
   - `cli/index.ts` - Main entry point and command routing
-  - `cli/errors.ts` - Centralized error handling with user-friendly messages
-  - `cli/customer-selection.ts` - Customer management and selection logic
-  - `cli/commands/` - Individual command handlers (pull, push, status, conversations, etc.)
-
-**Sync Module Restructuring:**
-- Extracted key functions from 1400+ line `sync.ts` into focused modules:
+  - `cli/errors.ts` - Centralized error handling
+  - `cli/customer-selection.ts` - Customer management logic
+  - `cli/commands/` - Individual command handlers
+- Extracted key functions from 1400+ line `sync.ts` into focused modules
   - `sync/attributes.ts` - Customer attributes synchronization
   - `sync/conversations.ts` - Conversation history management
   - `sync/status.ts` - File status checking and change detection
   - `sync/index.ts` - Unified exports with backward compatibility
-
-**Testing Infrastructure:**
-- Fixed all test imports to use compiled JavaScript from `dist/` directory
-- Converted test utilities from CommonJS to ES modules
-- Improved test isolation and ES module compatibility
-
-### 🔧 Technical Improvements
-- **Maintainability**: Single-responsibility modules with clear interfaces
-- **Testability**: Each module can be tested independently with clear dependencies
-- **Readability**: Focused modules replace hard-to-navigate monolithic files
-- **Extensibility**: Easy to add new commands and sync operations
-- **Type Safety**: Enhanced TypeScript compilation with zero errors
-
-### 📚 Documentation Updates
 - Updated CLAUDE.md with new modular architecture documentation
-- Added comprehensive module descriptions and benefits
-- Updated development patterns for the new structure
-
-## [2.0.0] - 2025-09-17
-
-### 🚀 Major Release: Professional Modular Architecture
-
-**BREAKING CHANGES**
-- **IDN-Based File Naming**: Skills now saved as `{skillIdn}.jinja/.guidance` instead of `skill.jinja/.guidance`
-- **Automatic Migration**: Existing files automatically renamed to IDN format during pull
-- **Enhanced File Validation**: Multiple script files per skill now generate warnings and block push operations
 
-### 🏗️ Complete Architecture Refactoring
+### Fixed
 
-**CLI Module Restructuring:**
-- **Entry Point**: `src/cli.ts` (124 lines) - Clean main entry using modular imports
-- **Error Handling**: `src/cli/errors.ts` - Centralized error management with user-friendly messages
-- **Customer Management**: `src/cli/customer-selection.ts` - Reusable customer selection logic
-- **Command Handlers**: `src/cli/commands/` - Individual handlers for all commands
+- Test imports to use compiled JavaScript from `dist/` directory
+- Test utilities converted from CommonJS to ES modules
+- Improved test isolation and ES module compatibility
 
-**Sync Module Restructuring:**
-- **Entry Point**: `src/sync.ts` (13 lines) - Unified exports with re-exports
-- **Projects**: `src/sync/projects.ts` - Project sync with progress tracking and IDN naming
-- **Push Operations**: `src/sync/push.ts` - File validation and upload with multiple file detection
-- **Status Checking**: `src/sync/status.ts` - Change detection with file validation warnings
-- **Attributes**: `src/sync/attributes.ts` - Customer attributes synchronization
-- **Conversations**: `src/sync/conversations.ts` - Conversation history management
-- **Metadata**: `src/sync/metadata.ts` - flows.yaml generation (clean, no prompt_script)
-- **File Utilities**: `src/sync/skill-files.ts` - IDN-based naming and validation
+## [2.0.0] - 2025-09-17
 
-### 🎯 Enhanced User Experience
+### Added
 
-**Progress Tracking:**
+- IDN-based skill file naming for easy identification
 - Real-time progress display during large operations (966+ skills)
 - Percentage completion with skill counts
-- Clean progress updates every 10 processed skills
-- Clear completion confirmations
+- Multiple file detection with clear warnings
+- Force mode with `--force/-f` flag for silent operations
+- Complete metadata.yaml hierarchy at all levels
+
+### Changed
 
-**IDN-Based File Management:**
-- Skills named after their IDN for easy identification
+- **BREAKING**: Skills now saved as `{skillIdn}.jinja/.guidance` instead of `skill.jinja/.guidance`
+- **BREAKING**: Existing files automatically renamed to IDN format during pull
+- Refactored CLI module structure
+  - `src/cli.ts` (124 lines) - Clean main entry using modular imports
+  - `src/cli/errors.ts` - Centralized error management
+  - `src/cli/customer-selection.ts` - Reusable customer selection logic
+  - `src/cli/commands/` - Individual handlers for all commands
+- Refactored sync module structure
+  - `src/sync.ts` (13 lines) - Unified exports with re-exports
+  - `src/sync/projects.ts` - Project sync with progress tracking
+  - `src/sync/push.ts` - File validation and upload
+  - `src/sync/status.ts` - Change detection with file validation
+  - `src/sync/attributes.ts` - Customer attributes synchronization
+  - `src/sync/conversations.ts` - Conversation history management
+  - `src/sync/metadata.ts` - flows.yaml generation (removed prompt_script)
+  - `src/sync/skill-files.ts` - IDN-based naming and validation
 - Flexible file discovery (any .jinja/.guidance/.nsl file)
 - Smart overwrite detection (content-based, not filename-based)
-- Force mode with `--force/-f` flag for silent operations
+- Complete hash coverage for flows.yaml and attributes.yaml
+- Zero TypeScript compilation errors with strict typing
+- Modular loading with reduced memory footprint
 
-**Enhanced Validation:**
-- Multiple file detection with clear warnings
-- Safe push operations that skip problematic skills
-- Actionable error messages with resolution guidance
-- Clean status display with file-level change detection
+### Fixed
 
-### 🔧 Technical Excellence
+- False positive change detection
+- Status now shows "Clean." immediately after pull operations
+- Safe push operations that skip problematic skills with multiple files
 
-**Hash Consistency:**
-- Complete hash coverage for flows.yaml and attributes.yaml
-- No false positive change detection
-- Status shows "Clean." immediately after pull operations
-- Consistent hash tracking across all generated files
+## [1.9.2] - 2025-09-16
 
-**File Structure Optimization:**
-- flows.yaml cleanup (removed prompt_script content)
-- Automatic attributes.yaml generation during pull
-- Complete metadata.yaml hierarchy at all levels
-- IDN-based skill folder organization
+### Added
 
-**Performance & Quality:**
-- Zero TypeScript compilation errors with strict typing
-- Modular loading with reduced memory footprint
-- Efficient API calls and file operations
-- Professional error handling and user guidance
-
-### 📚 Comprehensive Testing Results
-
-**All Functions Validated:**
-- ✅ Pull: 966/944 skills processed with perfect progress tracking
-- ✅ Status: Accurate change detection and clean state validation
-- ✅ Push: Successful uploads with smart file validation
-- ✅ Multi-customer: Independent customer operations working correctly
-- ✅ Attributes: Automatic 230KB+ attributes.yaml generation
-- ✅ Conversations: Working conversation history extraction
-- ✅ AKB Import: Proper parsing and validation (2 articles parsed)
-- ✅ Error Handling: Clear, actionable messages for all scenarios
-- ✅ File Validation: Multiple file warnings and safe skipping
+- Max pages limit (50 pages = 5000 acts per persona) to prevent infinite pagination
+- Verbose logging for pagination progress
 
-## [1.9.2] - 2025-09-16
+### Changed
+
+- Skip personas without newo_voice actors immediately for better performance
+- Optimized control flow to prevent hanging during large conversation extraction
 
 ### Fixed
-- **Pagination Safety**: Prevent infinite loops and hanging during conversation processing
-  - Added max pages limit (50 pages = 5000 acts per persona) to prevent infinite pagination
-  - Improved persona filtering for voice actors to avoid unnecessary API calls
-  - Better error handling and verbose logging for debugging conversation processing
-  - Graceful handling of personas without voice actors (adds with empty acts array)
 
-### Enhanced
-- **Performance Optimization**: Faster conversation processing with early exits
-  - Skip personas without newo_voice actors immediately
-  - Clear verbose logging for pagination progress
-  - Optimized control flow to prevent hanging during large conversation extraction
+- Infinite loops during conversation processing
+- Improved persona filtering for voice actors
+- Graceful handling of personas without voice actors
 
 ## [1.9.1] - 2025-09-16
 
-### Fixed
-- **Clean Chat History Implementation**: Remove conversations acts API fallback entirely
-  - Eliminates all 403 "Invalid token or account_id field missing" errors
-  - Uses only `/api/v1/chat/history` endpoint which works with current API keys
-  - Removed unused `getConversationActs()` function and related types
-  - Clean implementation without permission-dependent fallbacks
-
 ### Removed
-- **Obsolete Code Cleanup**: Remove unused conversation acts API components
-  - `getConversationActs()` function (unused after chat history integration)
-  - `ConversationActsParams` and `ConversationActsResponse` interfaces
-  - Fallback logic that caused 403 errors for personas without proper permissions
+
+- Conversations acts API fallback (eliminates 403 errors)
+- `getConversationActs()` function (unused after chat history integration)
+- `ConversationActsParams` and `ConversationActsResponse` interfaces
+- Fallback logic that caused 403 errors for personas without proper permissions
+
+### Changed
+
+- Use only `/api/v1/chat/history` endpoint which works with current API keys
 
 ## [1.9.0] - 2025-09-16
 
 ### Added
-- **User Conversations Pull Functionality**: Complete conversation history extraction
-  - New `newo conversations` command to download user conversations and personas
-  - Multi-customer conversation support with `--customer <idn>` flag
-  - Chat History API integration (`/api/v1/chat/history`) with fallback to conversations acts API
-  - Automatic phone number extraction from persona actors
-  - Comprehensive pagination handling for large conversation datasets
-  - Clean YAML output format in `newo_customers/{customerIdn}/conversations.yaml`
 
-### Enhanced
-- **Conversation Data Processing**: Optimized structure and chronological ordering
-  - Acts sorted by datetime ascending (chronological conversation flow)
-  - Personas sorted by most recent activity (descending)
-  - Redundant fields removed (`is_agent`, `session_id: unknown`, etc.)
-  - Clean persona structure: `id` → `name` → `phone` → `act_count` → `acts`
-  - Proper datetime extraction from chat history API responses
-
-### Technical
-- **New API Functions**: Type-safe conversation API integration
+- `newo conversations` command to download user conversations and personas
+- Multi-customer conversation support with `--customer <idn>` flag
+- Chat History API integration (`/api/v1/chat/history`) with fallback support
+- Automatic phone number extraction from persona actors
+- Comprehensive pagination handling for large conversation datasets
+- Clean YAML output format in `newo_customers/{customerIdn}/conversations.yaml`
+- Type-safe conversation API integration
   - `listUserPersonas()` - Get all user personas with pagination
   - `getChatHistory()` - Get conversation history for user actors
   - `getConversationActs()` - Fallback for accounts with proper permissions
   - `pullConversations()` - Complete conversation sync orchestration
-- **NPM Scripts**: Added convenient conversation commands
-  - `npm run conversations` - Build and pull conversations
-  - `npm run conversations:all` - Legacy alias for compatibility
+- NPM scripts: `npm run conversations` and `npm run conversations:all`
+
+### Changed
+
+- Acts sorted by datetime ascending (chronological conversation flow)
+- Personas sorted by most recent activity (descending)
+- Clean persona structure: `id` → `name` → `phone` → `act_count` → `acts`
+- Parallel API calls with concurrency limiting (p-limit)
+- Graceful error handling with persona-level fault tolerance
 
-### Performance
-- **Concurrent Processing**: Efficient conversation data extraction
-  - Parallel API calls with concurrency limiting (p-limit)
-  - Graceful error handling with persona-level fault tolerance
-  - No artificial limits on personas or acts (loads all available data)
-  - Multi-customer support with authentication reuse
+### Removed
+
+- Redundant fields (`is_agent`, `session_id: unknown`, etc.)
 
 ## [1.8.0] - 2025-09-15
 
 ### Added
-- **Complete Metadata Change Tracking**: Comprehensive metadata.yaml file synchronization
-  - All metadata.yaml files now tracked with hash-based change detection
-  - Status command shows detailed metadata changes (title, runner_type, model)
-  - Push command automatically updates skills when metadata changes
-  - flows.yaml automatically regenerated when metadata changes detected
-  - Preserves flows.yaml format consistency with backup/comparison system
 
-### Enhanced
-- **Comprehensive File Synchronization**: All NEWO workspace files fully tracked
-  - Skills: .guidance and .jinja script files with hash tracking ✓
-  - Metadata: metadata.yaml files with skill updates + flows.yaml regeneration ✓
-  - Attributes: attributes.yaml with diff-based sync for 233 customer attributes ✓
-  - Flows: flows.yaml with automatic regeneration and format preservation ✓
-  - Multi-customer: All file types synchronized across multiple customer workspaces ✓
-
-### Technical
-- **flows.yaml Regeneration**: Automatic regeneration pipeline when metadata changes
-  - Creates backup before regeneration for format comparison
-  - Re-fetches project data to ensure accuracy
-  - Updates hash tracking for regenerated flows.yaml
-  - Maintains consistent YAML format structure
+- Complete metadata.yaml file synchronization with hash-based change detection
+- Status command shows detailed metadata changes (title, runner_type, model)
+- Push command automatically updates skills when metadata changes
+- Automatic flows.yaml regeneration when metadata changes detected
+- flows.yaml backup/comparison system for format preservation
+
+### Changed
+
+- All NEWO workspace files fully tracked
+  - Skills: .guidance and .jinja script files with hash tracking
+  - Metadata: metadata.yaml files with skill updates + flows.yaml regeneration
+  - Attributes: attributes.yaml with diff-based sync for 233 customer attributes
+  - Flows: flows.yaml with automatic regeneration and format preservation
+  - Multi-customer: All file types synchronized across multiple customer workspaces
+- Automatic regeneration pipeline creates backup before regeneration
+- Re-fetches project data to ensure accuracy
+- Maintains consistent YAML format structure
 
 ## [1.7.3] - 2025-09-15
 
 ### Added
-- **Complete Attributes Change Tracking**: Full hash-based change detection for customer attributes
-  - Attributes.yaml files now included in hash tracking during pull operations
-  - Status command detects and reports modifications to attributes.yaml files
-  - Push command detects and handles attributes changes with proper synchronization
-  - Comprehensive workflow: modify → status shows change → push applies change → status shows clean
 
-### Enhanced
-- **File Synchronization Scope**: Extended to cover all file types in NEWO workspace
-  - Skills: .guidance and .jinja files with full hash tracking ✓
-  - Attributes: customer attributes.yaml with change detection ✓
-  - Metadata: flows.yaml and metadata.yaml files tracked ✓
-  - Multi-customer: all file types synchronized across multiple customers ✓
+- Full hash-based change detection for customer attributes
+- Attributes.yaml files included in hash tracking during pull operations
+- Status command detects and reports modifications to attributes.yaml files
+- Push command handles attributes changes with proper synchronization
+
+### Changed
+
+- Extended file synchronization scope to all NEWO workspace file types
+  - Skills: .guidance and .jinja files with full hash tracking
+  - Attributes: customer attributes.yaml with change detection
+  - Metadata: flows.yaml and metadata.yaml files tracked
+  - Multi-customer: all file types synchronized across multiple customers
 
 ## [1.7.2] - 2025-09-15
 
+### Added
+
+- `attributes.yaml` file tracking with modification times and sizes
+- `flows.yaml` file tracking and statistics
+- Comprehensive file monitoring across entire project structure
+
 ### Fixed
-- **YAML Enum Parsing**: Fixed attributes push check error with `!enum` format
-  - Changed from YAML parsing to file stats for change detection
-  - Prevents parsing errors with custom enum format in attributes.yaml
-  - Maintains functionality while avoiding format conflicts
 
-### Enhanced
-- **Status Command Scope**: Extended status checking to include all file types
-  - Now tracks `attributes.yaml` files with modification times and sizes
-  - Added `flows.yaml` file tracking and statistics
-  - Comprehensive file monitoring across entire project structure
-  - Better visibility into all managed files
+- Attributes push check error with `!enum` format
+- Changed from YAML parsing to file stats for change detection
+- Prevents parsing errors with custom enum format in attributes.yaml
 
 ## [1.7.1] - 2025-09-15
 
-### Enhanced
-- **Multi-Customer Commands**: Improved user experience for multi-customer operations
-  - `newo status` now automatically checks all customers when no default is specified
-  - `newo push` provides interactive customer selection dialog when multiple customers exist
-  - No more error messages for commands that support multi-customer operations
-  - Better user guidance with clear options for customer selection
+### Changed
+
+- `newo status` now automatically checks all customers when no default is specified
+- `newo push` provides interactive customer selection dialog when multiple customers exist
+- Moved customer selection logic into command-specific handlers
+- Each command now handles customer selection appropriately
 
 ### Fixed
-- **Command Flow**: Moved customer selection logic into command-specific handlers
-  - Prevents early exit errors for multi-customer operations
-  - Each command now handles customer selection appropriately
-  - Maintains backward compatibility with single-customer setups
+
+- Early exit errors for multi-customer operations
+- Maintains backward compatibility with single-customer setups
 
 ## [1.7.0] - 2025-09-15
 
 ### Added
-- **Customer Attributes Synchronization**: Complete pull/push functionality for customer attributes
-  - `GET /api/v1/bff/customer/attributes?include_hidden=true` - Fetches all 233 customer attributes including hidden system attributes
-  - `PUT /api/v1/customer/attributes/{attributeId}` - Updates individual customer attributes
-  - Saves to `newo_customers/{customerIdn}/attributes.yaml` in customer root directory
-  - YAML format matches reference specification exactly with literal blocks, enum types, and proper multi-line formatting
-  - Separate ID mapping stored in `.newo/{customerIdn}/attributes-map.json` for push operations
-  - Integrated into existing `pull` and `push` commands seamlessly
-  - Full TypeScript type safety with `CustomerAttribute` and `CustomerAttributesResponse` interfaces
 
-### Enhanced
-- **YAML Format Compliance**: Perfect format matching with reference files
+- Complete pull/push functionality for customer attributes
+- `GET /api/v1/bff/customer/attributes?include_hidden=true` endpoint integration (fetches 233 attributes)
+- `PUT /api/v1/customer/attributes/{attributeId}` endpoint integration
+- Saves to `newo_customers/{customerIdn}/attributes.yaml` in customer root directory
+- YAML format with literal blocks, enum types, and proper multi-line formatting
+- Separate ID mapping in `.newo/{customerIdn}/attributes-map.json` for push operations
+- Full TypeScript type safety with `CustomerAttribute` and `CustomerAttributesResponse` interfaces
+- API layer functions: `updateCustomerAttribute()` and enhanced `getCustomerAttributes()`
+- File system utilities: `customerAttributesPath()` and `customerAttributesMapPath()`
+
+### Changed
+
+- Integrated attributes handling into existing `pull` and `push` commands
+- YAML format compliance with reference specification
   - Literal block scalars (`|-`) for multi-line strings
   - Proper enum format (`!enum "AttributeValueTypes.string"`)
   - Complex JSON string formatting with proper line breaks
-  - No escaped quotes in output for better readability
-- **Metadata Generation**: Removed legacy JSON metadata files, YAML-only approach
-  - Eliminates redundant `metadata.json` files
-  - Cleaner file structure with single source of truth
-  - Improved performance with fewer file operations
-
-### Technical
-- **API Layer**: Added `updateCustomerAttribute()` and enhanced `getCustomerAttributes()` with `includeHidden` parameter
-- **Sync Engine**: Integrated attributes handling into `pullAll()` and `pushChanged()` functions
-- **File System**: Added `customerAttributesPath()` and `customerAttributesMapPath()` utilities
-- **Type Safety**: Extended type definitions with proper customer attribute interfaces
-- **Error Handling**: Comprehensive error handling for attributes operations with graceful fallbacks
+  - No escaped quotes in output
+
+### Removed
+
+- Legacy JSON metadata files (YAML-only approach)
+- Redundant `metadata.json` files
 
 ## [1.6.1] - 2025-09-13
 
+### Added
+
+- `"type": "module"` to package.json for proper ES module handling
+
 ### Fixed
-- **YAML Enum Formatting**: Fixed enum formatting in `flows.yaml` generation to properly handle NEWO enum types
-  - Corrected enum value serialization from quoted strings to proper YAML enum format
-  - Fixed issue where enum values like `!enum "RunnerType.guidance"` were incorrectly quoted
-  - Ensures generated `flows.yaml` files are properly formatted for NEWO platform consumption
 
-### Enhanced
-- **ES Module Support**: Added `"type": "module"` to package.json for proper ES module handling
-  - Resolves Node.js warnings about module type detection
-  - Improves performance by eliminating module type guessing
-  - Ensures consistent ES module behavior across all environments
+- Enum formatting in `flows.yaml` generation for NEWO enum types
+- Enum value serialization from quoted strings to proper YAML enum format
+- Issue where enum values like `!enum "RunnerType.guidance"` were incorrectly quoted
 
 ## [1.6.0] - 2025-09-13
 
@@ -476,7 +573,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Professional Infrastructure**: Industry-standard publishing pipeline with version management
 - **Quality Gates**: Automated validation before publishing (TypeScript, linting, building, package validation)
 
-## [1.5.2] - 2025-01-15
+## [1.5.2] - 2025-09-04
 
 ### Enhanced
 - **Documentation Overhaul**: Complete README restructuring with professional presentation
@@ -506,7 +603,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Clear Navigation**: Improved documentation structure with proper sectioning and examples
 - **Enhanced Onboarding**: Comprehensive quick-start guide and configuration examples
 
-## [1.5.1] - 2025-01-14
+## [1.5.1] - 2025-09-03
 
 ### Added
 - **Comprehensive Test Coverage**: Added extensive test suites for all major modules
@@ -729,10 +826,41 @@ Another Item: $Price [Modifiers: modifier3]
 ## [1.2.1] - Previous Release
 
 ### Added
+
 - Initial NEWO CLI functionality
 - Two-way sync between NEWO platform and local files
 - Support for .guidance and .jinja file types
 - SHA256-based change detection
 - Project structure export to flows.yaml
 - GitHub Actions CI/CD integration
-- Robust authentication with token refresh
+- Robust authentication with token refresh
+
+[Unreleased]: https://github.com/sabbah13/newo-cli/compare/v3.2.0...HEAD
+[3.2.0]: https://github.com/sabbah13/newo-cli/compare/v3.1.0...v3.2.0
+[3.1.0]: https://github.com/sabbah13/newo-cli/compare/v3.0.0...v3.1.0
+[3.0.0]: https://github.com/sabbah13/newo-cli/compare/v2.0.6...v3.0.0
+[2.0.6]: https://github.com/sabbah13/newo-cli/compare/v2.0.5...v2.0.6
+[2.0.5]: https://github.com/sabbah13/newo-cli/compare/v2.0.4...v2.0.5
+[2.0.4]: https://github.com/sabbah13/newo-cli/compare/v2.0.3...v2.0.4
+[2.0.3]: https://github.com/sabbah13/newo-cli/compare/v2.0.2...v2.0.3
+[2.0.2]: https://github.com/sabbah13/newo-cli/compare/v2.0.1...v2.0.2
+[2.0.1]: https://github.com/sabbah13/newo-cli/compare/v2.0.0...v2.0.1
+[2.0.0]: https://github.com/sabbah13/newo-cli/compare/v1.8.0...v2.0.0
+[1.9.3]: https://github.com/sabbah13/newo-cli/compare/v1.9.2...v1.9.3
+[1.9.2]: https://github.com/sabbah13/newo-cli/compare/v1.9.1...v1.9.2
+[1.9.1]: https://github.com/sabbah13/newo-cli/compare/v1.9.0...v1.9.1
+[1.9.0]: https://github.com/sabbah13/newo-cli/compare/v1.8.0...v1.9.0
+[1.8.0]: https://github.com/sabbah13/newo-cli/compare/v1.7.0...v1.8.0
+[1.7.3]: https://github.com/sabbah13/newo-cli/compare/v1.7.2...v1.7.3
+[1.7.2]: https://github.com/sabbah13/newo-cli/compare/v1.7.1...v1.7.2
+[1.7.1]: https://github.com/sabbah13/newo-cli/compare/v1.7.0...v1.7.1
+[1.7.0]: https://github.com/sabbah13/newo-cli/compare/v1.6.1...v1.7.0
+[1.6.1]: https://github.com/sabbah13/newo-cli/compare/v1.6.0...v1.6.1
+[1.6.0]: https://github.com/sabbah13/newo-cli/compare/v1.5.1...v1.6.0
+[1.5.2]: https://github.com/sabbah13/newo-cli/compare/v1.5.1...v1.5.2
+[1.5.1]: https://github.com/sabbah13/newo-cli/compare/v1.5.0...v1.5.1
+[1.5.0]: https://github.com/sabbah13/newo-cli/compare/v1.4.0...v1.5.0
+[1.4.0]: https://github.com/sabbah13/newo-cli/compare/v1.2.1...v1.4.0
+[1.3.0]: https://github.com/sabbah13/newo-cli/compare/v1.2.1...v1.3.0
+[1.2.2]: https://github.com/sabbah13/newo-cli/compare/v1.2.1...v1.2.2
+[1.2.1]: https://github.com/sabbah13/newo-cli/releases/tag/v1.2.1