Commit Graph

83 Commits

Author SHA1 Message Date
iven
a7582cb135 chore: clean up old plan files and update gitignore
- Add build artifacts to .gitignore (binaries/, *.exe, *.pdb)
- Update WORK_SUMMARY with latest progress
- Remove outdated plan files (moved to docs/archive/plans/)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-16 09:59:39 +08:00
iven
f9a3816e54 docs: update work summary with OpenViking installation status
- Python 3.12 installed via winget
- OpenViking v0.2.6 installed successfully
- API key configuration required for server startup
- Updated next steps with configuration instructions

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-16 09:39:28 +08:00
iven
131b9c93ae docs: update OpenViking installation requirements
- Add Python version compatibility notes (3.10-3.12 required)
- Add Windows-specific installation instructions
- Add conda/WSL alternatives for Python 3.13+ users
- Update binaries README with system requirements table
- Clarify that CLI requires server to run

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-16 08:28:27 +08:00
iven
0eb30c0531 docs: reorganize documentation structure
- Create docs/README.md as documentation index
- Add WORK_SUMMARY_2026-03-16.md for today's work
- Move test reports to docs/test-reports/
- Move completed plans to docs/archive/completed-plans/
- Move research reports to docs/archive/research-reports/
- Move technical reference to docs/knowledge-base/
- Move all plans from root plans/ to docs/plans/

New structure:
docs/
├── README.md                         # Documentation index
├── DEVELOPMENT.md                    # Development guide
├── OPENVIKING_INTEGRATION.md         # OpenViking integration
├── USER_MANUAL.md                    # User manual
├── ZCLAW_AGENT_INTELLIGENCE_EVOLUTION.md
├── archive/                          # Archived documents
├── knowledge-base/                   # Technical knowledge
├── plans/                            # Execution plans
└── test-reports/                     # Test reports

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-16 08:21:01 +08:00
iven
c8202d04e0 feat(viking): add local server management for privacy-first deployment
- Add viking_server.rs (Rust) for managing local OpenViking server process
- Add viking-server-manager.ts (TypeScript) for server control from UI
- Update VikingAdapter to support 'local' mode with auto-start capability
- Update documentation for local deployment mode

Key features:
- Auto-start local server when needed
- All data stays in ~/.openviking/ (privacy-first)
- Server listens only on 127.0.0.1
- Graceful fallback to remote/localStorage modes

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-16 08:14:44 +08:00
iven
137f1a32fa feat: implement Phase 4 - Multi-Agent Swarm + Skill Discovery
Phase 4a: Agent Swarm Collaboration Framework (agent-swarm.ts)
- AgentSwarm class with configurable coordinator + specialist agents
- Three collaboration modes: Sequential (chain), Parallel (concurrent), Debate (multi-round)
- Auto task decomposition based on specialist capabilities
- Debate consensus detection with keyword similarity heuristic
- Rule-based result aggregation with structured markdown output
- Specialist management (add/update/remove) and config updates
- History persistence to localStorage (last 25 tasks)
- Memory integration: saves task completion as lesson memories

Phase 4b: Skill Discovery Engine (skill-discovery.ts)
- SkillDiscoveryEngine with 12 built-in skill definitions from skills/ directory
- Multi-signal search: name, description, triggers, capabilities, category matching
- Conversation-based skill recommendation via topic extraction (CN + EN patterns)
- Memory-augmented confidence scoring for suggestions
- Skill registration, install status toggle, category filtering
- localStorage persistence for skill index and suggestion cache

Phase 4c: chatStore Integration
- dispatchSwarmTask(description, style): creates and executes swarm task, adds result as message
- searchSkills(query): exposes skill search to UI layer

Tests: 317 passing across 13 test files (43 new for swarm + skills)
- AgentSwarm: createTask, sequential/parallel/debate execution, history, specialist mgmt
- SkillDiscovery: search, suggest, register, persist, categories

Refs: ZCLAW_AGENT_INTELLIGENCE_EVOLUTION.md updated - all 4 phases complete
2026-03-15 22:44:18 +08:00
iven
04ddf94123 feat: implement ZCLAW Agent Intelligence Evolution Phase 1-3
Phase 1: Persistent Memory + Identity Dynamic Evolution
- agent-memory.ts: MemoryManager with localStorage persistence, keyword search, deduplication, importance scoring, pruning, markdown export
- agent-identity.ts: AgentIdentityManager with per-agent SOUL/AGENTS/USER.md, change proposals with approval workflow, snapshot rollback
- memory-extractor.ts: Rule-based conversation memory extraction (Phase 1), LLM extraction prompt ready for Phase 2
- MemoryPanel.tsx: Memory browsing UI with search, type filter, delete, export (integrated as 4th tab in RightPanel)

Phase 2: Context Governance
- context-compactor.ts: Token estimation, threshold monitoring (soft/hard), memory flush before compaction, rule-based summarization
- chatStore integration: auto-compact when approaching token limits

Phase 3: Proactive Intelligence + Self-Reflection
- heartbeat-engine.ts: Periodic checks (pending tasks, memory health, idle greeting), quiet hours, proactivity levels (silent/light/standard/autonomous)
- reflection-engine.ts: Pattern analysis from memory corpus, improvement suggestions, identity change proposals, meta-memory creation

Chat Flow Integration (chatStore.ts):
- Pre-send: context compaction check -> memory search -> identity system prompt injection
- Post-complete: async memory extraction -> reflection conversation tracking -> auto-trigger reflection

Tests: 274 passing across 12 test files
- agent-memory.test.ts: 42 tests
- context-compactor.test.ts: 23 tests
- heartbeat-reflection.test.ts: 28 tests
- chatStore.test.ts: 11 tests (no regressions)

Refs: ZCLAW_AGENT_INTELLIGENCE_EVOLUTION.md updated with implementation progress
2026-03-15 22:24:57 +08:00
iven
4862e79b2b chore: add react-window and @types/react-window dependencies 2026-03-15 21:08:47 +08:00
iven
c19be048e4 feat(phase-12-13): complete performance optimization and test coverage
Phase 12 - Performance Optimization:
- Add message-virtualization.ts with useVirtualizedMessages hook
- Implement MessageCache<T> LRU cache for rendered content
- Add createMessageBatcher for WebSocket message batching
- Add calculateVisibleRange and debounced scroll handlers
- Support for 10,000+ messages without performance degradation

Phase 13 - Test Coverage:
- Add workflowStore.test.ts (28 tests)
- Add configStore.test.ts (40 tests)
- Update general-settings.test.tsx to match current UI
- Total tests: 148 passing

Code Quality:
- TypeScript compilation passes
- All 148 tests pass

Co-Authored-By: Claude <noreply@anthropic.com>
2026-03-15 20:35:16 +08:00
iven
01737a7ef5 feat(phase-11): add store coordinator layer
- Create store/index.ts as unified entry point
- Add useCompositeStore() hook for multi-slice access
- Add initializeStores() for client injection
- Re-export all individual stores for direct access
- Maintain backward compatibility with useGatewayStore

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-15 20:18:44 +08:00
iven
f22b1a2095 refactor(phase-11): extract specialized stores from gatewayStore
Decompose monolithic gatewayStore.ts (1660 lines) into focused stores:

- connectionStore.ts (444 lines) - WebSocket, auth, local gateway
- agentStore.ts (256 lines) - Clones, usage stats, plugins
- handStore.ts (498 lines) - Hands, triggers, approvals
- workflowStore.ts (255 lines) - Workflows, runs
- configStore.ts (537 lines) - QuickConfig, channels, skills

Each store uses client injection pattern for loose coupling.
Coordinator layer to be added in next commit.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-15 20:17:17 +08:00
iven
6a66ce159d refactor(phase-10): complete type safety enhancement
- Add types/api-responses.ts with ApiResponse<T>, PaginatedResponse<T>
- Add types/errors.ts with comprehensive error type hierarchy
- Replace all any usage (53 → 0, 100% reduction)
- Add RawAPI response interfaces for type-safe mapping
- Update catch blocks to use unknown with type narrowing
- Add getState mock to chatStore tests

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-15 19:52:52 +08:00
iven
a6b1255dc0 security(phase-9): complete security hardening
- Add safeJsonParse utility with schema validation
- Migrate tokens to OS keyring storage
- Add Ed25519 key encryption at rest
- Enable WSS configuration option
- Fix JSON.parse in HandParamsForm, WorkflowEditor, WorkflowList
- Update test mock data to match valid status values

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-15 19:22:51 +08:00
iven
3e81bd3e50 feat(ui): Phase 8 UI/UX optimization and system documentation update
## Sidebar Enhancement
- Change tabs to icon + small label layout for better space utilization
- Add Teams tab with team collaboration entry point

## Settings Page Improvements
- Connect theme toggle to gatewayStore.saveQuickConfig for persistence
- Remove OpenFang backend download section, simplify UI
- Add time range filter to UsageStats (7d/30d/all)
- Add stat cards with icons (sessions, messages, input/output tokens)
- Add token usage overview bar chart
- Add 8 ZCLAW system skill definitions with categories

## Bug Fixes
- Fix ChannelList duplicate content with deduplication logic
- Integrate CreateTriggerModal in TriggersPanel
- Add independent SecurityStatusPanel with 12 default enabled layers
- Change workflow view to use SchedulerPanel as unified entry

## New Components
- CreateTriggerModal: Event trigger creation modal
- HandApprovalModal: Hand approval workflow dialog
- HandParamsForm: Enhanced Hand parameter form
- SecurityLayersPanel: 16-layer security status display

## Architecture
- Add TOML config parsing support (toml-utils.ts, config-parser.ts)
- Add request timeout and retry mechanism (request-helper.ts)
- Add secure token storage (secure-storage.ts, secure_storage.rs)

## Tests
- Add unit tests for config-parser, toml-utils, request-helper
- Add team-client and teamStore tests

## Documentation
- Update SYSTEM_ANALYSIS.md with Phase 8 completion
- UI completion: 100% (30/30 components)
- API coverage: 93% (63/68 endpoints)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-15 14:12:11 +08:00
iven
bf79c06d4a test(team): add comprehensive unit tests for teamStore
- Add 16 test cases covering team CRUD operations
- Add tests for member and task management
- Add tests for Dev↔QA loop workflow
- Add tests for event management with max 100 limit
- Update SYSTEM_ANALYSIS.md with TypeScript fix completion

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-15 09:26:08 +08:00
iven
4802eb7d6a feat(team): add OpenFang Team API client and WebSocket events
API Client (lib/team-client.ts):
- Team CRUD: listTeams, getTeam, createTeam, updateTeam, deleteTeam
- Member management: addTeamMember, removeTeamMember, updateMemberRole
- Task management: addTeamTask, updateTaskStatus, assignTask, submitDeliverable
- Dev↔QA loops: startDevQALoop, submitReview, updateLoopState
- Metrics & Events: getTeamMetrics, getTeamEvents, subscribeToTeamEvents
- TeamAPIError class for error handling

WebSocket Events (lib/useTeamEvents.ts):
- useTeamEvents hook for subscribing to team events
- useTeamEventStream hook for specific team events
- useAllTeamEvents hook for all team events
- Real-time task status updates
- Real-time Dev↔QA loop state changes
- Auto-refresh on team/member updates

Event Types:
- team.created/updated/deleted
- member.added/removed/status_changed
- task.created/assigned/status_changed/completed
- loop.started/state_changed/completed
- review.submitted

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-15 03:38:36 +08:00
iven
46cbe2b50e docs: update Phase 6 progress - team components integrated
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-15 03:35:41 +08:00
iven
c91740c00e feat(team): implement multi-agent team collaboration UI
Phase 6 progress - Multi-Agent Team Collaboration:

Types (types/team.ts):
- Team, TeamMember, TeamTask type definitions
- Dev↔QA Loop state machine types
- CollaborationEvent and TeamMetrics types

Store (store/teamStore.ts):
- Team CRUD operations with localStorage persistence
- Task assignment and status management
- Dev↔QA loop lifecycle management
- Real-time collaboration events

Components:
- TeamOrchestrator.tsx: Team creation, member/task management UI
- DevQALoop.tsx: Developer↔QA review loop visualization
- TeamCollaborationView.tsx: Real-time collaboration dashboard

Features:
- 6 agent roles: orchestrator, developer, reviewer, tester, architect, specialist
- 7 task statuses: pending → assigned → in_progress → review → completed/failed
- Dev↔QA loop with max 3 iterations before escalation
- 4 collaboration patterns: sequential, parallel, pipeline, review_loop
- Live event feed with auto-scroll
- Team metrics: completion rate, pass rate, efficiency score

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-15 03:22:59 +08:00
iven
acdbf20848 docs: update skills count to 68 (Marketing 11)
- Corrected Marketing count: 11 skills (added twitter-engager, instagram-curator)
- Total skills: 68 (was 65)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-15 03:12:11 +08:00
iven
4ffe602591 feat(skills): add Chinese platform marketing specialists
- Add wechat-official-account: WeChat OA content & engagement expert
- Add xiaohongshu-specialist: RED (Xiaohongshu) lifestyle content expert
- Add zhihu-strategist: Zhihu thought leadership & knowledge marketing
- Update SYSTEM_ANALYSIS.md: total skills now 65, Marketing 9

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-15 03:11:18 +08:00
iven
8a515dd1fd feat(skills): add 3 marketing skills and update documentation
- Add app-store-optimizer: ASO expert for app store optimization
- Add reddit-community-builder: Reddit marketing specialist
- Add tiktok-strategist: TikTok viral content expert
- Update ui-designer and workflow-optimizer skill definitions
- Update SYSTEM_ANALYSIS.md: total skills now 63 (was 60)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-15 03:09:44 +08:00
iven
d64903ba21 feat(skills): complete multi-agent collaboration framework
## Skills Ecosystem (60+ Skills)
- Engineering: 7 skills (ai-engineer, backend-architect, etc.)
- Testing: 8 skills (reality-checker, evidence-collector, etc.)
- Support: 6 skills (support-responder, analytics-reporter, etc.)
- Design: 7 skills (ux-architect, brand-guardian, etc.)
- Product: 3 skills (sprint-prioritizer, trend-researcher, etc.)
- Marketing: 4+ skills (growth-hacker, content-creator, etc.)
- PM: 5 skills (studio-producer, project-shepherd, etc.)
- Spatial: 6 skills (visionos-spatial-engineer, etc.)
- Specialized: 6 skills (agents-orchestrator, etc.)

## Collaboration Framework
- Coordination protocols (handoff-templates, agent-activation)
- 7-phase playbooks (Discovery → Operate)
- Standardized skill template for consistency

## Quality Improvements
- Each skill now includes: Identity, Mission, Workflow, Deliverable Format
- Collaboration triggers define when to invoke other agents
- Success metrics provide measurable quality standards

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-15 03:07:31 +08:00
iven
507486befd docs: update SYSTEM_ANALYSIS with Phase 3 completion
- Update Skills coverage to 15% (9/60+)
- Update overall alignment to 100%
- Phase 3 fully completed

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-15 02:00:36 +08:00
iven
2cc1514d1b refactor(phase3): remove OpenClaw compatibility layer
Phase 3 Configuration Migration completed:
- Remove OpenClaw backend type selector from General.tsx
- Update default workspace path from ~/.openclaw to ~/.openfang
- Update default port from 18789 to 50051
- Archive openclaw.default.json to docs/archive/openclaw-legacy/
- Remove OpenClaw migration UI from Workspace settings
- Update About.tsx to reference OpenFang
- Clean up gateway-client.ts comments

All OpenClaw compatibility code removed. ZCLAW now exclusively
targets OpenFang (Rust Agent OS) backend.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-15 02:00:04 +08:00
iven
d60d445cbf feat(phase4-5): add Workflow types and expand Skills ecosystem
Phase 4: Type System Completion (P2)
- Add comprehensive Workflow type definitions:
  - WorkflowStepType: hand, skill, agent, condition, parallel, delay
  - WorkflowStep: individual step configuration
  - Workflow: complete workflow definition
  - WorkflowRunStatus: pending, running, completed, failed, cancelled, paused
  - WorkflowRun: execution instance tracking
  - Request/Response types for API operations
  - Control types for pause/resume/cancel
- Update types/index.ts with workflow exports

Phase 5: Skills Ecosystem Expansion (P2)
- Add 5 new Skills with SKILL.md definitions:
  - git: Git version control operations
  - file-operations: File system operations
  - web-search: Web search capabilities
  - data-analysis: Data analysis and visualization
  - shell-command: Shell command execution
- Skills coverage now at 9/60+ (15%)

Documentation:
- Update SYSTEM_ANALYSIS.md Phase 4 & 5 status
- Mark Phase 4 as completed
- Update Phase 5 progress tracking

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-15 01:51:45 +08:00
iven
9c99ab16d4 feat(phase3-4): add OpenFang config.toml and TypeScript type definitions
Phase 3: Configuration Migration (P1)
- Create config/config.toml with comprehensive OpenFang settings
- Migrate openclaw.default.json content to TOML format
- Add server, agent, skills, hands, llm, security, logging configs
- Add desktop-specific settings for ZClaw client

Phase 4: Type System Enhancement (P2)
- Create types/agent.ts: Agent, AgentConfig, AgentStatus types
- Create types/session.ts: Session, SessionMessage, MessageRole types
- Create types/settings.ts: QuickConfig, MCPService, AppSettings types
- Create types/index.ts: Barrel export for all type definitions

Documentation Updates:
- Mark Phase 3 config migration tasks as completed (2/3)
- Mark Phase 4 type definition tasks as completed (3/4)
- Update technical debt cleanup status
- Update type definition section in SYSTEM_ANALYSIS.md

Files Added:
- config/config.toml (289 lines)
- desktop/src/types/agent.ts (68 lines)
- desktop/src/types/session.ts (75 lines)
- desktop/src/types/settings.ts (89 lines)
- desktop/src/types/index.ts (41 lines)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-15 01:45:25 +08:00
iven
5599c1a4db feat(phase2): complete P1 tasks - Channels, Triggers, Skills CRUD and UI enhancements
Phase 2 P1 Tasks Completed:

API Layer (gateway-client.ts, gatewayStore.ts):
- Add Channels CRUD: getChannel, createChannel, updateChannel, deleteChannel
- Add Triggers CRUD: getTrigger, createTrigger, updateTrigger, deleteTrigger
- Add Skills CRUD: getSkill, createSkill, updateSkill, deleteSkill
- Add Scheduled Tasks API: createScheduledTask, deleteScheduledTask, toggleScheduledTask
- Add loadModels action for dynamic model list

UI Components:
- ModelsAPI.tsx: Dynamic model loading from API with loading/error states
- SchedulerPanel.tsx: Full CreateJobModal with cron/interval/once scheduling
- SecurityStatus.tsx: Loading states, error handling, retry functionality
- WorkflowEditor.tsx: New workflow creation/editing modal (new file)
- WorkflowHistory.tsx: Workflow execution history viewer (new file)
- WorkflowList.tsx: Integrated editor and history access

Configuration:
- Add 4 Hands TOML configs: clip, collector, predictor, twitter

Documentation (SYSTEM_ANALYSIS.md):
- Update API coverage: 65% → 89% (53/62 endpoints)
- Update UI completion: 85% → 92%
- Mark Phase 2 P1 tasks as completed
- Update technical debt cleanup status

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-15 01:38:34 +08:00
iven
1f9b6553fc docs: add next session prompt for continuing development
Create comprehensive onboarding document for new sessions:

- Project overview (OpenFang + Tauri + React)
- Current status (API 60%, UI 80%, Hands 43%)
- Phase 0 tasks with code examples:
  - HandTaskPanel real task history
  - 4 missing Hands TOML configs
  - Workflow editor implementation
  - Session management API
- Key file locations
- API client usage examples
- Common commands
- Acceptance criteria

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-15 00:19:35 +08:00
iven
62f182785f docs: create comprehensive system analysis report
Replace partial alignment analysis with full SYSTEM_ANALYSIS.md containing:

- Complete deviation analysis (API 60%, UI 80%, Hands 43%, Skills 7%)
- Root cause analysis of gaps
- 5-phase evolution roadmap with clear milestones
- Technical debt inventory
- Acceptance criteria per phase

Key findings:
- Session management API completely missing (0%)
- 4/7 Hands missing TOML configurations
- Workflow editor/delete/create using placeholder alerts
- HandTaskPanel using hardcoded mock data

Updates:
- Archive README updated with clear pointer to new report
- deviation-analysis.md marked as deprecated with comparison table
- knowledge-base README updated to reference SYSTEM_ANALYSIS.md
- Removed partial openfang-alignment-analysis.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-15 00:01:39 +08:00
iven
05c67d6532 docs: add OpenFang alignment analysis report
- Create new openfang-alignment-analysis.md based on OpenFang (not OpenClaw)
- Update deviation-analysis.md with deprecation notice
- Update archive README with migration rationale
- Add new report to knowledge-base index

Key insights:
- Project successfully migrated from OpenClaw to OpenFang
- Alignment improved from 25% to 80%
- Core features (Gateway, Hands, Skills, Channels) all integrated
- Remaining gaps mostly due to OpenFang API not yet implemented

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-14 23:47:55 +08:00
iven
07079293f4 feat(hands): restructure Hands UI with Chinese localization
Major changes:
- Add HandList.tsx component for left sidebar
- Add HandTaskPanel.tsx for middle content area
- Restructure Sidebar tabs: 分身/HANDS/Workflow
- Remove Hands tab from RightPanel
- Localize all UI text to Chinese
- Archive legacy OpenClaw documentation
- Add Hands integration lessons document
- Update feature checklist with new components

UI improvements:
- Left sidebar now shows Hands list with status icons
- Middle area shows selected Hand's tasks and results
- Consistent styling with Tailwind CSS
- Chinese status labels and buttons

Documentation:
- Create docs/archive/openclaw-legacy/ for old docs
- Add docs/knowledge-base/hands-integration-lessons.md
- Update docs/knowledge-base/feature-checklist.md
- Update docs/knowledge-base/README.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-14 23:16:32 +08:00
iven
67e1da635d docs: add new session prompt for OpenFang migration
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-13 18:04:53 +08:00
iven
ef849c62ab cc工作前备份 2026-03-12 00:23:42 +08:00