docs(06-03): complete CLI args and cookie wiring plan

This commit is contained in:
2026-02-16 10:21:52 +01:00
parent 1cda24bf4f
commit 0d68e348b0

View File

@@ -0,0 +1,108 @@
---
phase: 06-auth-cli
plan: '03'
subsystem: cli
tags: [cookies, input-file, cli, authentication, extractors]
# Dependency graph
requires:
- phase: 06-auth-cli
provides: Cookie parsing and browser extraction from plans 01-02
provides:
- --input-file URL reading from file
- --cookies CLI argument wired to extractors
- --cookies-from-browser wired to extractors
- Cookie support in Twitter and Instagram extractors
affects: [extraction, CLI]
# Tech tracking
tech-stack:
added: []
patterns: [cookie injection via Extractor trait]
key-files:
created: []
modified: [src/lib.rs, src/main.rs, src/extractor/base.rs, src/extractor/extractors/twitter.rs, src/extractor/extractors/instagram.rs]
key-decisions:
- "Added set_cookies() method to Extractor trait for dynamic cookie injection"
- "Extractors that need auth (Twitter, Instagram) override set_cookies()"
patterns-established:
- "Extractor trait now supports optional cookie injection"
- "main.rs loads cookies early and passes to extractors during extraction"
# Metrics
duration: 5 min
completed: 2026-02-16T09:21:01Z
---
# Phase 6 Plan 3: Wire CLI Args & Cookie Support Summary
**CLI args and cookies wired to extraction pipeline**
## Performance
- **Duration:** 5 min
- **Started:** 2026-02-16T09:15:59Z
- **Completed:** 2026-02-16T09:21:01Z
- **Tasks:** 3
- **Files modified:** 5
## Accomplishments
- Added --input-file URL reading (loads URLs from file, ignores # comments)
- Wired --cookies and --cookies-from-browser to extractors
- Added set_cookies() method to Extractor trait
- Twitter and Instagram extractors receive cookies during initialization
- All 145 library tests pass
## Task Commits
Each task was committed atomically:
1. **Task 1: Export auth module in lib.rs** - `3bae7656` (feat)
2. **Task 2: Add input-file URL reading** - `1e73893a` (feat)
3. **Task 3: Wire cookies to extractors** - `1cda24bf` (feat)
**Plan metadata:** (to be committed)
## Files Created/Modified
- `src/lib.rs` - Added extract_browser_cookies export
- `src/main.rs` - Added input-file loading and cookie wiring
- `src/extractor/base.rs` - Added set_cookies() method to trait
- `src/extractor/extractors/twitter.rs` - Implemented set_cookies()
- `src/extractor/extractors/instagram.rs` - Implemented set_cookies()
## Decisions Made
- Added set_cookies() method to Extractor trait (default no-op) for dynamic cookie injection
- Extractors that need authentication override set_cookies() to receive cookies at runtime
## Deviations from Plan
None - plan executed exactly as written.
## Issues Encountered
None
## User Setup Required
None - no external service configuration required.
## Next Phase Readiness
- CLI cookie support fully wired
- Ready for remaining Phase 6 plans (OAuth, simulate, destination)
---
*Phase: 06-auth-cli*
*Completed: 2026-02-16*
## Self-Check: PASSED
- [x] src/lib.rs modified (1 line added)
- [x] src/main.rs modified (input-file and cookie wiring)
- [x] src/extractor/base.rs modified (set_cookies method)
- [x] Twitter and Instagram extractors implement set_cookies
- [x] Commits present: 3bae7656, 1e73893a, 1cda24bf
- [x] All 145 library tests pass