agentson
7725e7a8de
docs: update documentation for Smart Volatility Scanner
...
CI / test (pull_request) Has been cancelled
Update project documentation to reflect new Smart Volatility Scanner feature:
## CLAUDE.md
- Add Smart Volatility Scanner section with configuration guide
- Update project structure to include analysis/ module
- Update test count (273→343 tests)
## docs/architecture.md
- Add Analysis component (VolatilityAnalyzer + SmartVolatilityScanner)
- Add new KIS API methods (fetch_market_rankings, get_daily_prices)
- Update data flow diagram to show Python-first filtering pipeline
- Add selection_context to database schema documentation
- Add Smart Scanner configuration section
- Renumber components (Brain 2→3, Risk Manager 3→4, etc.)
## docs/requirements-log.md
- Document 2026-02-06 requirement for Smart Volatility Scanner
- Explain Python-First, AI-Last pipeline rationale
- Record implementation details and benefits
- Reference issue #76 and PR #77
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-02-06 07:35:25 +09:00
agentson
0057de4d12
feat: implement daily trading mode with batch decisions (issue #57 )
...
CI / test (pull_request) Has been cancelled
Add API-efficient daily trading mode for Gemini Free tier compatibility:
## Features
- **Batch Decisions**: GeminiClient.decide_batch() analyzes multiple stocks
in a single API call using compressed JSON format
- **Daily Trading Mode**: run_daily_session() executes N sessions per day
at configurable intervals (default: 4 sessions, 6 hours apart)
- **Mode Selection**: TRADE_MODE env var switches between daily (batch)
and realtime (per-stock) modes
- **Requirements Log**: docs/requirements-log.md tracks user feedback
chronologically for project evolution
## Configuration
- TRADE_MODE: "daily" (default) | "realtime"
- DAILY_SESSIONS: 1-10 (default: 4)
- SESSION_INTERVAL_HOURS: 1-24 (default: 6)
## API Efficiency
- 2 markets × 4 sessions = 8 API calls/day (within Free tier 20 calls)
- 3 markets × 4 sessions = 12 API calls/day (within Free tier 20 calls)
## Testing
- 9 new batch decision tests (all passing)
- All existing tests maintained (298 passed)
## Documentation
- docs/architecture.md: Trading Modes section with daily vs realtime
- CLAUDE.md: Requirements Management section
- docs/requirements-log.md: Initial entries for API efficiency needs
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-02-05 09:28:10 +09:00
agentson
881bbb4240
docs: add Telegram notifications documentation (issue #35 )
...
CI / test (pull_request) Has been cancelled
Update project documentation to include Telegram notification feature
that was added in issues #31-34.
Changes:
- CLAUDE.md: Add Telegram quick setup section with examples
- README.md (Korean): Add 텔레그램 알림 section with setup guide
- docs/architecture.md: Add Notifications component documentation
- New section explaining TelegramClient architecture
- Add notification step to data flow diagram
- Add Telegram config to environment variables
- Document error handling for notification failures
Documentation covers:
- Quick setup instructions (bot creation, chat ID, env config)
- Notification types (trades, circuit breaker, fat-finger, etc.)
- Fail-safe behavior (notifications never crash trading)
- Links to detailed guide in src/notifications/README.md
Project structure updated to reflect notifications/ directory and
updated test count (273 tests).
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-02-04 23:48:01 +09:00
agentson
254b543c89
Merge main into feature/issue-15-context-tree
...
CI / test (pull_request) Has been cancelled
Resolved conflicts in CLAUDE.md by:
- Keeping main's refactored structure (docs split into separate files)
- Added Context Tree documentation link to docs section
- Preserved all constraints and guidelines from main
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-02-04 15:25:13 +09:00
agentson
917b68eb81
feat: implement L1-L7 context tree for multi-layered memory management
...
CI / test (pull_request) Has been cancelled
Implements Pillar 2 (Multi-layered Context Management) with a 7-tier
hierarchical memory system from real-time market data to generational
trading wisdom.
## New Modules
- `src/context/layer.py`: ContextLayer enum and metadata config
- `src/context/store.py`: ContextStore for CRUD operations
- `src/context/aggregator.py`: Bottom-up aggregation (L7→L6→...→L1)
## Database Changes
- Added `contexts` table for hierarchical data storage
- Added `context_metadata` table for layer configuration
- Indexed by layer, timeframe, and updated_at for fast queries
## Context Layers
- L1 (Legacy): Cumulative wisdom (kept forever)
- L2 (Annual): Yearly metrics (10 years retention)
- L3 (Quarterly): Strategy pivots (3 years)
- L4 (Monthly): Portfolio rebalancing (2 years)
- L5 (Weekly): Stock selection (1 year)
- L6 (Daily): Trade logs (90 days)
- L7 (Real-time): Live market data (7 days)
## Tests
- 18 new tests in `tests/test_context.py`
- 100% coverage on context modules
- All 72 tests passing (54 existing + 18 new)
## Documentation
- Added `docs/context-tree.md` with comprehensive guide
- Updated `CLAUDE.md` architecture section
- Includes usage examples and best practices
Closes #15
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-02-04 14:12:29 +09:00
agentson
05e8986ff5
refactor: split CLAUDE.md into focused documentation structure
...
CI / test (pull_request) Has been cancelled
- Restructure docs into topic-specific files to minimize context
- Create docs/workflow.md (Git + Agent workflow)
- Create docs/commands.md (Common failures + build commands)
- Create docs/architecture.md (System design + data flow)
- Create docs/testing.md (Test structure + guidelines)
- Rewrite CLAUDE.md as concise hub with links to detailed docs
- Update .gitignore to exclude data/ directory
Benefits:
- Reduced context size for AI assistants
- Faster reference lookups
- Better maintainability
- Topic-focused documentation
Closes #13
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-02-04 10:13:48 +09:00
agentson
3dd222bd3b
docs: add common command failures and solutions
...
CI / test (pull_request) Has been cancelled
- Document tea CLI TTY errors and YES="" workaround
- Record wrong parameter names (--body vs --description)
- Add Gitea API hostname corrections
- Include Git configuration errors
- Document Python/pytest common issues
Each failure includes:
- ❌ Failing command
- 💡 Failure reason
- ✅ Working solution
- 📝 Additional notes
Closes #11
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-02-04 10:02:41 +09:00
agentson
9c5bd254b5
docs: add agent workflow and parallel execution strategy
...
CI / test (pull_request) Has been cancelled
- Document modern AI development workflow using specialized agents
- Add guidelines for when to use git worktree/subagents vs main conversation
- Define agent roles: ticket mgmt, design, code, test, docs, review
- Include implementation examples with Task tool
- Update test count (35 → 54) with new market_schedule tests
Closes #9
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-02-04 09:47:14 +09:00
agentson
1d46cb31fb
docs: add Git workflow policy to CLAUDE.md
...
CI / test (pull_request) Has been cancelled
Add comprehensive Git workflow policy section to ensure all code
changes follow proper process: issue creation, feature branch,
PR, and merge. Explicitly prohibit direct pushes to main branch.
Resolves #4
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-02-04 08:50:46 +09:00
9bb7e3ec85
docs: add CLAUDE.md for AI assistant context
...
CI / test (pull_request) Has been cancelled
- Add build & test commands reference
- Document architecture and component interactions
- Include key constraints from docs/agents.md
- Provide configuration and test structure overview
Closes #2
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com >
2026-02-04 03:23:43 +09:00
