flock-core 0.3.23__tar.gz → 0.3.31__tar.gz

{flock_core-0.3.23 → flock_core-0.3.31}/.project/SPECS.md

@@ -13,42 +13,42 @@ Flock is a declarative agent framework that focuses on simplifying the creation
 
 ## Core Specifications
 
-1. [**Core Architecture**](.cursor/specs/01_core_architecture.md)
+1. [**Core Architecture**](specs/01_core_architecture.md)
    - Defines the primary components of the framework
    - Outlines the relationships between components
    - Documents the execution flow
 
-2. [**Agent Factory System**](.cursor/specs/02_agent_factory.md)
+2. [**Agent Factory System**](specs/02_agent_factory.md)
    - Specifies the factory pattern for agent creation
    - Defines default configurations and behaviors
    - Outlines extension points for custom factories
 
-3. [**Module System**](.cursor/specs/03_module_system.md)
+3. [**Module System**](specs/03_module_system.md)
    - Defines the module extension architecture
    - Specifies lifecycle hooks and integration points
    - Documents standard modules and their behaviors
 
-4. [**Evaluator System**](.cursor/specs/04_evaluator_system.md)
+4. [**Evaluator System**](specs/04_evaluator_system.md)
    - Outlines the evaluation strategy pattern
    - Defines how agents process inputs and generate outputs
    - Specifies model integration requirements
 
-5. [**Router System**](.cursor/specs/05_router_system.md)
+5. [**Router System**](specs/05_router_system.md)
    - Defines the agent workflow orchestration mechanism
    - Specifies how agents hand off control to other agents
    - Documents routing strategies and decision points
 
-6. [**Tool System**](.cursor/specs/06_tool_system.md)
+6. [**Tool System**](specs/06_tool_system.md)
    - Outlines how agents interact with external functions
    - Defines tool registration and discovery
    - Specifies tool execution flow
 
-7. [**Execution System**](.cursor/specs/07_execution_system.md)
+7. [**Execution System**](specs/07_execution_system.md)
    - Defines local and distributed execution options
    - Specifies serialization requirements
    - Documents error handling and recovery
 
-8. [**Context System**](.cursor/specs/08_context_system.md)
+8. [**Context System**](specs/08_context_system.md)
    - Outlines the shared state mechanism
    - Defines context propagation requirements
    - Specifies context access patterns

flock_core-0.3.31/.project/TASKS.md

@@ -0,0 +1,76 @@
+# Project Tasks
+
+## Open Tasks
+
+### YAML Serialization for Agents and Flock Systems
+
+This feature adds support for serializing and deserializing agents and complete Flock systems to YAML format, providing a more human-readable and flexible alternative to the existing JSON serialization.
+
+#### Implementation Tasks
+
+| ID | Task | Priority | Status | Description |
+|----|------|----------|--------|-------------|
+| US007-T001 | [YAML Serializable Base](tasks/US007-T001-YAML-Serializable-Base.md) | High | Not Started | Extend the Serializable base class to support YAML serialization |
+| US007-T004 | [Callable Reference System](tasks/US007-T004-Callable-Reference-System.md) | High | Not Started | Create a system to represent callable objects in YAML using human-readable references |
+| US007-T002 | [FlockAgent YAML Serialization](tasks/US007-T002-FlockAgent-YAML-Serialization.md) | High | Not Started | Implement YAML serialization for FlockAgent classes |
+| US007-T003 | [Flock YAML Serialization](tasks/US007-T003-Flock-YAML-Serialization.md) | Medium | Not Started | Implement YAML serialization for complete Flock systems |
+| US007-T005 | [YAML Documentation and Examples](tasks/US007-T005-YAML-Documentation-and-Examples.md) | Medium | Not Started | Create comprehensive documentation and examples for YAML serialization |
+| US007-T006 | [YAML Editor CLI](tasks/US007-T006-YAML-Editor-CLI.md) | Medium | Not Started | Add a YAML editor to the CLI application for editing agent and system configurations |
+
+---
+
+## Completed Tasks
+
+### YAML Serialization for Agents and Flock Systems
+
+#### Implementation Tasks
+
+| ID | Task | Priority | Status | Description |
+|----|------|----------|--------|-------------|
+| US007-T007 | [YAML Serialization Tests](tasks/done/US007-T007-YAML-Serialization-Tests.md) | Highest | Completed | Create a comprehensive test suite for YAML serialization following TDD principles |
+
+### Environment Settings Editor
+
+The settings editor is a key feature of the Flock CLI that allows users to view, edit, add, and delete environment variables in the `.env` file.
+
+#### Implementation Tasks
+
+| ID | Task | Priority | Status | Description |
+|----|------|----------|--------|-------------|
+| US001-001 | [Settings Editor Implementation](tasks/done/US001-001-env-settings-editor.md) | High | Completed | Implement the core settings editor functionality |
+| US001-002 | [Settings Editor UI Components](tasks/done/US001-002-env-settings-ui-components.md) | High | Completed | Design and implement UI components for the settings editor |
+| US001-003 | [Environment File Operations](tasks/done/US001-003-env-settings-file-operations.md) | High | Completed | Implement robust file operations for the .env file |
+| US001-004 | [Settings Security Features](tasks/done/US001-004-settings-security-features.md) | High | Completed | Implement security features for protecting sensitive information |
+| US001-005 | [Environment Profile Switching](tasks/done/US001-005-env-profile-switching.md) | High | Completed | Implement feature to switch between multiple environment profiles (.env configurations) |
+
+#### Implementation Approach
+
+The settings editor was implemented in stages:
+
+1. **Core Functionality**: Parse and manipulate .env files, implement the main settings editor menu
+2. **UI Components**: Create a user-friendly interface with proper formatting and navigation
+3. **File Operations**: Ensure robust reading and writing of .env files with proper error handling
+4. **Security Features**: Add protection for sensitive information like API keys and tokens
+5. **Profile Management**: Implement ability to create and switch between different environment profiles
+
+#### Definition of Done
+
+The implementation is considered complete as:
+
+- Users can access the settings editor from the main CLI menu
+- All core functionality (view, edit, add, delete) works correctly
+- Users can switch between different environment profiles (dev, test, prod)
+- The UI is intuitive and provides clear feedback
+- File operations are robust and prevent data loss
+- Sensitive information is properly protected
+- Code is well-documented and follows project conventions
+
+## Next Steps
+
+After completing the settings editor, potential future enhancements could include:
+
+- Settings groups/categories for better organization
+- Import/export functionality for settings
+- Presets for common configurations
+- Integration with cloud-based secrets management
+- Command history and autocomplete features

{flock_core-0.3.23 → flock_core-0.3.31}/.project/USERSTORIES.md

@@ -4,7 +4,9 @@ This document provides an index of all user stories for the Flock project.
 
 ## Current User Stories
 
-No active user stories.
+| ID | Title | Priority | Status | Description |
+|----|-------|----------|--------|-------------|
+| [US007](userstories/US007-YAML-Serialization.md) | YAML Serialization for Agents and Flock Systems | Medium | Not Started | Add support for saving and loading agents and Flock systems in YAML format |
 
 ## Completed User Stories
 

flock_core-0.3.31/.project/analyze_repo_prompt.md

@@ -0,0 +1,5 @@
+pls take a look at @SPECS.md and all the specs file in .project/specs
+
+also take a look at src/flock/core and examples/01... and /02... for the most important code
+
+Please report back if you have a deep understanding of the codebase to talk about the next steps