tastytrade 0.2.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b4642b3bfaeb7906f2733b1da34c2bafea177177fb6670f2271b50b720673236
-  data.tar.gz: d65a41b22c7eba317269b454e38188b1e19c504726771d140d72653aa7e7c617
+  metadata.gz: dc1c01296e2566f4fc37858644a653d88592959a377bf2170872e469a7364875
+  data.tar.gz: 1358a0e80d2cb413336edd44b0a38fdeecb21a57c6dafd23358b183f570a426f
 SHA512:
-  metadata.gz: 7dd6ac7a321ed6d7c6b9519f82988029f5e49515acfff9583d22bba99b2da2ab61666e9054ee232a71afdd3179bcc97c1765e071081722160251ef207340f2d2
-  data.tar.gz: 20b1acf6efba69d72bee9448c39825178701a0e4a20be5de813f1607860fa201b5ed68d2269b2d465fa085bc817d7ffa0ff7f7d89dd68849d197f18463841d51
+  metadata.gz: a2f378a230782d89ebaa843c155f6086c2d31bd1c21976179b8da38d7712533e3632a33d2ac5cdb41d88e5d24fa3fba1228e0c748f4efa2f6d41a9ce04af9854
+  data.tar.gz: ddbdcd65ef55e82501617202fdf9f3b6dbeb32f87b439fcbe04a357988c13097041662550450f57e31e608434e63ec4d9148ea09c50b09401298daa218ced886

data/.claude/commands/plan.md

@@ -0,0 +1,13 @@
+We will implement issue $ARGUMENTS. Please review the issues first to understand what we're doing. You will  
+then spawn multiple concurrent subagents in parallel to do the following:                                 
+
+- one will review the codebase to research the integration points for the new code or code to modify. If  
+the feature has already been implemented they will make note of that.                                     
+- one will review the tastytrade python SDK reference to compare the implementation to fully explain      
+what features we are copying.                                                                             
+- one will review the tastytrade python SDK cli tool reference to fully explain what features we are      
+trying to copy.                                                                                           
+                                                                                                             
+You will then take the output from the subagents to compile an implementation plan and update the todos   
+to fully encapsulate the work down to the smallest possible unit of work. You will not continue until I   
+approve the plan.

data/.claude/commands/release-pr.md

@@ -86,6 +86,18 @@ Create a release PR following Ruby gem best practices.
    After merging this PR:
    1. \`git checkout main && git pull\`
    2. \`bundle exec rake release\`
+   3. Create a GitHub Release:
+      \`\`\`bash
+      gh release create v<VERSION> \\
+        --title "v<VERSION>" \\
+        --generate-notes \\
+        --draft
+      \`\`\`
+   4. Edit the draft release to add a summary section at the top with key highlights
+   5. Publish the release:
+      \`\`\`bash
+      gh release edit v<VERSION> --draft=false
+      \`\`\`
    
    Note: The rake release command will automatically create and push the git tag v<VERSION>"
    ```

data/CHANGELOG.md

@@ -25,6 +25,186 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Security
 - Nothing yet
 
+## [0.3.1] - 2025-08-08
+
+### Removed
+- VCR documentation files (vcr_implementation_plan.md, vcr_implementation_research.md) that were inadvertently included in v0.3.0
+- VCR gem dependency from development dependencies
+- VCR configuration and setup code from spec_helper.rb
+- VCR-related test tags from spec files
+
+### Fixed
+- Cleaned up test suite to remove unused VCR references
+
+## [0.3.0] - 2025-08-08
+
+### Added
+- Order time-in-force CLI support (#15)
+  - Added --time-in-force option to `order place` command
+  - Support for DAY and GTC (Good Till Cancelled) order durations
+  - Accepts shorthand aliases: "d" for DAY, "g" or "good_till_cancelled" for GTC
+  - Defaults to DAY order when not specified (backward compatible)
+  - Display time-in-force in order summaries and order history tables
+  - Added TIF column to order list and history displays
+  - Complete test coverage for time-in-force parameter handling
+  - Note: Core Order class already had full DAY/GTC support
+- Comprehensive order validation framework (#14)
+  - OrderValidator class with multi-layer validation checks
+  - Symbol validation via Instruments API
+  - Quantity validation with min/max constraints (1-999,999)
+  - Price validation with tick size rounding
+  - Account permissions validation using TradingStatus
+  - Buying power validation via dry-run API calls
+  - Market hours validation with warnings
+  - Specific error classes (OrderValidationError, InvalidSymbolError, etc.)
+  - Integration into Account#place_order method
+  - Order#validate! and Order#dry_run helper methods
+  - CLI `order place` command with validation support
+  - Dry-run mode for testing orders without submission
+  - Confirmation prompts with buying power impact display
+  - Comprehensive test coverage for all validation scenarios
+- Enhanced order status and history functionality (#13)
+  - Account#get_order_history method for retrieving orders beyond 24 hours
+  - Account#get_order method for fetching individual order details
+  - Date range filtering for order history with from/to parameters
+  - Pagination support for large order history queries
+  - JSON output format for all order CLI commands (--format json)
+  - LiveOrder#to_h method for JSON serialization
+  - `order history` CLI command with comprehensive filtering options
+  - `order get` CLI command for detailed single order information
+  - Enhanced display_order_details method showing fills and timestamps
+  - Complete test coverage for new order history methods
+- Order cancellation and replacement functionality (#12)
+  - LiveOrder model for parsing existing orders from API
+  - OrderStatus module with status constants and validation helpers
+  - Account#get_live_orders method with status/symbol/time filtering
+  - Account#cancel_order method with proper error handling
+  - Account#replace_order method with partial fill support
+  - Custom exceptions for order operations (OrderNotCancellableError, OrderAlreadyFilledError, etc.)
+  - CLI `order` subcommands structure with list/cancel/replace operations
+  - `order list` command with real-time order display and status filtering
+  - `order cancel` command with confirmation prompt and order details
+  - `order replace` command with interactive price/quantity modification
+  - Partial fill tracking with filled/remaining quantity calculations
+  - Order status color coding in CLI output
+  - Comprehensive test coverage for all order management features
+  - Integration tests for complete order lifecycle (place, list, modify, cancel)
+  - Renamed existing `order` command to `place` for clarity
+- Account trading status and permissions (#10)
+  - TradingStatus model with 35+ fields matching Python SDK structure
+  - Complete account state tracking (frozen, closed, margin call, PDT status)
+  - Trading permissions for options, futures, cryptocurrency, and short calls
+  - Options trading level parsing and validation
+  - Pattern Day Trader (PDT) status with reset dates and day trade counts
+  - Portfolio margin and risk-reducing mode indicators
+  - Account restrictions detection and listing
+  - Helper methods for permission checking (can_trade_options?, can_trade_futures?, etc.)
+  - CLI `trading_status` command with color-coded warnings
+  - Visual indicators for account restrictions and margin calls
+  - Display of fee schedule and margin calculation type
+  - Full test coverage for all trading status features
+- Claude command for planning multi-issue implementations
+  - `.claude/commands/plan.md` command for structured issue planning
+  - Spawns concurrent subagents to research codebase, Python SDK, and CLI
+  - Compiles comprehensive implementation plans with detailed todos
+  - Requires user approval before proceeding with implementation
+- Transaction history functionality (#8)
+  - Transaction model with comprehensive field support including fees and metadata
+  - Get all transactions with automatic pagination
+  - Filtering by date range, symbol, instrument type, and transaction types
+  - Manual pagination control with page_offset and per_page parameters
+  - Account#get_transactions convenience method
+  - CLI `history` command with table display and filtering options
+  - Grouping transactions by symbol, type, or date
+  - Transaction totals and summaries (credits, debits, fees, net cash flow)
+  - Interactive history menu with date and symbol filtering
+  - Full test coverage for Transaction model and API integration
+- Buying power calculation and monitoring (#9)
+  - Extended AccountBalance model with buying power calculation methods
+  - Buying power usage percentage for equity, derivative, and day trading
+  - Check if sufficient buying power exists for orders
+  - Calculate buying power impact percentage for proposed orders
+  - BuyingPowerEffect model for dry-run order validation
+  - Dry-run orders now return detailed buying power impact information
+  - CLI `buying_power` command to display buying power status
+  - Buying power warnings when placing orders that use >80% of available BP
+  - Interactive confirmation for high buying power usage orders
+  - Integration with order placement workflow (both CLI and interactive)
+  - Comprehensive test coverage for all buying power calculations
+- Order placement functionality for equities (#11)
+  - Order and OrderLeg classes for building orders programmatically
+  - Support for market and limit order types
+  - All four order actions: BUY_TO_OPEN, SELL_TO_CLOSE, SELL_TO_OPEN, BUY_TO_CLOSE
+  - Time in force options: DAY and GTC
+  - Automatic price-effect calculation (Debit for buys, Credit for sells)
+  - Account#place_order method for order submission
+  - OrderResponse model for parsing placement results
+  - Equity instrument class with build_leg helper method
+  - CLI `order` command with options for type, price, action, and dry-run
+  - Interactive order menu with vim navigation for order type and action
+  - Dry-run simulation capability for testing orders
+  - Improved error handling with helpful messages for common scenarios
+  - Comprehensive test coverage for all order functionality
+- CLI positions command (#7)
+  - `positions` command to display account positions in table format
+  - Position filtering options: --symbol, --underlying-symbol, --include-closed
+  - Account selection with --account option
+  - Color-coded P/L display (green for profit, red for loss)
+  - Summary statistics showing total P/L and winners/losers count
+  - Option-specific display formatting (e.g., "AAPL 150C 1/19")
+  - Support for short positions with negative quantity display
+  - Integration with interactive mode and balance submenu
+- Positions formatter for table display
+  - TTY::Table integration for professional formatting
+  - BigDecimal precision for monetary values
+  - Automatic symbol formatting for options
+  - Summary row with position statistics
+- Environment variable authentication support
+  - Session.from_environment class method for creating sessions from env vars
+  - Support for TASTYTRADE_USERNAME, TASTYTRADE_PASSWORD (or TT_ prefixed)
+  - Optional TASTYTRADE_ENVIRONMENT for sandbox/production selection
+  - Optional TASTYTRADE_REMEMBER for automatic session refresh
+  - CLI automatically attempts env var login before prompting
+  - Fallback to interactive login if env var authentication fails
+  - Complete test coverage for all environment variable scenarios
+- Enhanced CLI documentation
+  - Comprehensive login command help with environment variable examples
+  - README documentation for environment variable configuration
+  - Examples for CI/CD and automation use cases
+- CLI login improvements
+  - Added --no-interactive flag to skip interactive mode after login
+  - Useful for scripting and CI/CD environments
+  - Correctly detects environment (sandbox/production) from env vars
+- GitHub Release creation instructions in release workflow
+  - Added `gh release create` command to release-pr.md
+  - Automated release notes generation with --generate-notes flag
+  - Draft release workflow for review before publishing
+
+### Changed
+- Session storage switched from keyring to secure file-based storage
+  - Sessions now stored in ~/.config/tastytrade/credentials/ with 0600 permissions
+  - More reliable across different systems without keyring dependencies
+  - Credentials directory created with 0700 permissions for security
+  - User data (email, username, external_id) now saved with sessions for validation
+
+### Fixed
+- Session persistence issues between command invocations
+  - Fixed session corruption after first command execution
+  - Sessions now properly persist across multiple CLI commands
+  - Removed problematic session validation on load that was causing failures
+- Removed stray error message "Failed to load current account" from positions/balance commands
+  - Error now only displays when DEBUG_SESSION environment variable is set
+- Fixed all test failures related to file-based storage implementation
+  - Updated FileStore tests to properly mock temporary directories
+  - Fixed CLI auth tests to stub environment variable checks
+  - Added missing user attributes to test mocks
+  - Updated session manager tests for new user data saving/loading
+
+### Removed
+- Keyring gem dependency and KeyringStore implementation
+  - Replaced with more reliable file-based credential storage
+  - Eliminates cross-platform keyring compatibility issues
+
 ## [0.2.0] - 2025-08-01
 
 ### Added