+ {isPending &&
+ );
+}
+
+
+## API Versioning
+
+### 1. URL Versioning
+
+**Version in the URL path**:
+```
+GET /v1/users
+GET /v2/users
+```
+
+**Pros**: Clear, easy to route
+**Cons**: URL changes, harder to maintain multiple versions
+
+### 2. Header Versioning
+
+**Version in Accept header**:
+```
+GET /users
+Accept: application/vnd.myapi.v2+json
+```
+
+**Pros**: Clean URLs, flexible
+**Cons**: Less visible, harder to test
+
+### 3. Deprecation Strategy
+
+**Communicate deprecation clearly**:
+```javascript
+// Response headers
+Deprecation: true
+Sunset: Sat, 31 Dec 2024 23:59:59 GMT
+Link: Loading...
}
+ {error && Error: {error.message}
}
+ {data?.data.map(user =>
+
+
+ )
+ }
+
+ return (
+
+ {/* Sticky Canvas */}
+
+
+ {/* Text Overlays */}
+
+
+
+
+
+
+
+
+
+
+
+
+ )
+}
+```
+
+---
+
+## Key Implementation Details
+
+**Line 15-18**: `useScroll` tracks scroll progress from container start to end
+**Line 21**: `useTransform` maps 0-1 scroll to 0-119 frame index
+**Line 32-46**: Preload all 120 frames using Promise.all
+**Line 49-70**: Draw current frame to canvas, scaled and centered
+**Line 73-76**: Text opacity transforms for fade in/out at specific scroll positions
+
+---
+
+## Usage
+
+1. Install dependencies: `npm install framer-motion`
+2. Place 120 WebP frames in `/public/frames/`
+3. Copy code into respective files
+4. Run: `npm run dev`
+
+---
+
+## Customization
+
+**Change frame count**: Update `FRAME_COUNT` constant (line 7)
+**Adjust scroll length**: Change `h-[400vh]` to `h-[300vh]` or `h-[500vh]` (line 120)
+**Modify text timing**: Update transform ranges in lines 73-76
+**Change colors**: Update `bg-[#050505]` to match your image background
+
+---
+
+## Related
+
+- concepts/scroll-linked-animations.md - Understanding the technique
+- guides/scrollytelling-setup.md - Getting started
+- lookup/scroll-animation-prompts.md - Generating image sequences
+
+---
+
+## References
+
+- [Framer Motion Docs](https://www.framer.com/motion/)
+- [Next.js App Router](https://nextjs.org/docs/app)
diff --git a/.opencode/context/ui/web/design/guides/building-scrollytelling-pages.md b/.opencode/context/ui/web/design/guides/building-scrollytelling-pages.md
new file mode 100644
index 0000000..ad15e90
--- /dev/null
+++ b/.opencode/context/ui/web/design/guides/building-scrollytelling-pages.md
@@ -0,0 +1,271 @@
+---
+description: "Step-by-step implementation of scroll-linked image sequence animations"
+---
+
+# Guide: Building Scrollytelling Pages
+
+**Purpose**: Step-by-step implementation of scroll-linked image sequence animations
+
+**Last Updated**: 2026-01-07
+
+---
+
+## Prerequisites
+
+- Next.js 14+ project with App Router
+- Framer Motion installed (`npm i framer-motion`)
+- Tailwind CSS configured
+- Image sequence ready (60-240 WebP frames)
+
+---
+
+## Step 1: Generate Image Sequences
+
+Use nano banana or AI image tools to create start/end frames, then generate interpolation:
+
+**Start frame prompt**:
+```
+Ultra-premium product photography of [product] on matte black surface,
+minimalistic studio shoot, deep black background with subtle gradient,
+soft rim lighting, cinematic, high contrast, luxury aesthetic, sharp focus,
+no clutter, DSLR 85mm f/1.8, photorealistic
+```
+
+**End frame prompt**:
+```
+Exploded technical diagram of same [product], every component separated
+and floating in alignment, against deep black studio background, visible
+internal structure, hyper-realistic, studio rim lighting, cinematic,
+high contrast, no labels, photorealistic
+```
+
+**Generate video**: Use AI video tools (Runway, Pika) to interpolate between frames.
+
+**Export frames**: Use ffmpeg or ezgif to split video into 120+ WebP images.
+
+```bash
+ffmpeg -i animation.mp4 -vf fps=30 frame_%04d.webp
+```
+
+---
+
+## Step 2: Project Structure
+
+```
+app/
+├── page.tsx # Main landing page
+├── components/
+│ └── HeadphoneScroll.tsx # Scroll animation component
+└── globals.css # Dark theme, Inter font
+public/
+└── frames/
+ ├── frame_0001.webp # 120+ frames
+ ├── frame_0002.webp
+ └── ...
+```
+
+---
+
+## Step 3: Setup globals.css
+
+```css
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+@layer base {
+ body {
+ @apply bg-[#050505] text-white antialiased;
+ font-family: 'Inter', -apple-system, sans-serif;
+ }
+}
+```
+
+---
+
+## Step 4: Create Scroll Component
+
+**Key patterns**:
+- Container with `h-[400vh]` for long scroll
+- Canvas with `sticky top-0` stays fixed
+- `useScroll` tracks scroll progress (0-1)
+- `useTransform` maps progress to frame index
+- `useEffect` preloads all images
+
+**Core logic**:
+```tsx
+const { scrollYProgress } = useScroll({ target: containerRef })
+const frameIndex = useTransform(scrollYProgress, [0, 1], [0, 119])
+```
+
+---
+
+## Step 5: Implement Preloader
+
+Always preload images before starting animation:
+
+```tsx
+useEffect(() => {
+ const loadImages = async () => {
+ const promises = Array.from({ length: 120 }, (_, i) => {
+ return new Promise((resolve) => {
+ const img = new Image()
+ img.src = `/frames/frame_${String(i + 1).padStart(4, '0')}.webp`
+ img.onload = () => resolve(img)
+ })
+ })
+
+ const loaded = await Promise.all(promises)
+ setImages(loaded)
+ setLoading(false)
+ }
+
+ loadImages()
+}, [])
+```
+
+---
+
+## Step 6: Canvas Rendering
+
+Draw current frame to canvas on every scroll update:
+
+```tsx
+useEffect(() => {
+ if (!canvasRef.current || !images.length) return
+
+ const canvas = canvasRef.current
+ const ctx = canvas.getContext('2d')
+ const img = images[Math.round(currentFrame)]
+
+ // Scale canvas to window
+ canvas.width = window.innerWidth
+ canvas.height = window.innerHeight
+
+ // Draw centered
+ ctx.drawImage(img,
+ (canvas.width - img.width) / 2,
+ (canvas.height - img.height) / 2
+ )
+}, [currentFrame, images])
+```
+
+---
+
+## Step 7: Add Text Overlays
+
+Fade text in/out at specific scroll positions:
+
+```tsx
+
+
+ + Zenith X +
+Pure Sound.
++ Precision Engineering. +
++ Titanium Drivers. +
+
+
+ + Hear Everything. +
+ +
+
+
+)}
+```
+
+---
+
+## Common Issues & Fixes
+
+### Images not loading
+- Check file paths match exactly (case-sensitive)
+- Verify all frames exist in `/public/frames/`
+- Open browser console for 404 errors
+
+### Stuttering animation
+- Ensure all images preloaded before starting
+- Use WebP (not PNG/JPEG)
+- Check canvas size isn't too large
+
+### Visible image edges
+- Background colors don't match exactly
+- Use eyedropper tool, not guessing
+- Check for gradients in image background
+
+### Mobile performance
+- Reduce frame count (use every 2nd frame)
+- Debounce with requestAnimationFrame
+- Consider disabling on small screens
+
+---
+
+## Testing Checklist
+
+- [ ] All frames load without 404s
+- [ ] Animation smooth from 0-100% scroll
+- [ ] Text fades in/out at correct positions
+- [ ] Background seamlessly blends with images
+- [ ] Loading spinner shows before animation
+- [ ] Works on mobile (or gracefully disabled)
+- [ ] No console errors
+
+---
+
+## Related
+
+- concepts/scroll-linked-animations.md - Understanding the technique
+- examples/headphone-scrollytelling.md - Full code example
+- lookup/animation-image-prompts.md - Prompts for frame generation
+
+---
+
+## References
+
+- [Next.js Image Optimization](https://nextjs.org/docs/app/building-your-application/optimizing/images)
+- [Framer Motion useScroll](https://www.framer.com/motion/use-scroll/)
diff --git a/.opencode/context/ui/web/design/lookup/scroll-animation-prompts.md b/.opencode/context/ui/web/design/lookup/scroll-animation-prompts.md
new file mode 100644
index 0000000..967e712
--- /dev/null
+++ b/.opencode/context/ui/web/design/lookup/scroll-animation-prompts.md
@@ -0,0 +1,213 @@
+---
+description: "AI prompts for generating start/end frames and video sequences for scrollytelling"
+---
+
+# Lookup: Scroll Animation Image Generation Prompts
+
+**Purpose**: AI prompts for generating start/end frames and video sequences for scrollytelling
+
+**Last Updated**: 2026-01-07
+
+---
+
+## Overview
+
+Use these prompts with nano banana, Runway, Pika, or other AI tools to create image sequences for scroll animations.
+
+**Workflow**: Start frame → End frame → Video interpolation → Frame extraction
+
+---
+
+## Start Frame Prompts
+
+### Product Hero Shot
+
+```
+Ultra-premium product photography of [PRODUCT NAME] placed on a matte black
+surface, minimalistic studio photoshoot. Deep black background (#050505) with
+subtle gradient falloff, soft rim lighting outlining edges, controlled
+reflections on smooth textures. Cinematic lighting, high contrast, luxury tech
+aesthetic, sharp focus, shallow depth of field. No clutter, no text, no logos
+emphasized. Shot with professional DSLR, 85mm lens, f/1.8, ultra-high
+resolution, photorealistic, Apple-level product shoot, dramatic mood, modern
+and elegant.
+```
+
+**Variables**: Replace [PRODUCT NAME] with your product
+**Output**: Starting position, fully assembled, hero angle
+
+---
+
+### Variations by Product Type
+
+| Product Type | Additional Details |
+|--------------|-------------------|
+| **Headphones** | "over-ear headphones with leather cushions and metal headband" |
+| **Smartphone** | "smartphone with edge-to-edge OLED display, aluminum frame" |
+| **Watch** | "luxury smartwatch with titanium case and sapphire crystal" |
+| **Laptop** | "thin laptop with aluminum unibody, open at 45 degrees" |
+| **Camera** | "mirrorless camera with prime lens attached, side profile" |
+
+---
+
+## End Frame Prompts
+
+### Exploded Technical View
+
+```
+Exploded technical diagram view of [PRODUCT NAME], every component precisely
+separated and floating in perfect alignment, suspended in mid-air against deep
+black studio background (#050505). Visible internal structure including
+[INTERNAL COMPONENTS], all parts evenly spaced showing assembly order.
+Hyper-realistic product visualization, ultra-sharp focus, studio rim lighting
+identical to hero shot, soft highlights tracing each component, controlled
+reflections on matte and metal surfaces. Cinematic lighting, high contrast,
+luxury engineering aesthetic, no labels, no annotations, no text.
+Photorealistic, ultra-high resolution, Apple-style industrial design render,
+dramatic and clean.
+```
+
+**Variables**:
+- [PRODUCT NAME]: Your product
+- [INTERNAL COMPONENTS]: Specific parts to show
+
+---
+
+### Internal Components by Product
+
+| Product | Internal Components Examples |
+|---------|------------------------------|
+| **Headphones** | "copper wiring, titanium drivers, magnets, circuit boards, padding layers, metal frame" |
+| **Smartphone** | "battery, logic board, cameras, OLED panel, antenna bands, frame" |
+| **Watch** | "watch movement, gears, battery, sensors, display, crown mechanism" |
+| **Laptop** | "keyboard assembly, trackpad, battery cells, logic board, cooling fans, display panel" |
+| **Camera** | "sensor, shutter mechanism, lens elements, mirror assembly, circuit boards" |
+
+---
+
+## Video Interpolation Prompts
+
+### For Runway/Pika
+
+```
+Smoothly transition from fully assembled [PRODUCT] to exploded view.
+Components separate slowly and precisely, maintaining perfect alignment.
+Camera stays locked, product rotates slightly clockwise. Cinematic motion,
+professional product animation, 4-5 seconds duration, 30fps.
+```
+
+**Settings**:
+- Duration: 4-5 seconds
+- FPS: 30 (yields 120-150 frames)
+- Camera: Static or slow orbit
+- Motion: Smooth, controlled separation
+
+---
+
+## Frame Extraction
+
+### Using ffmpeg
+
+```bash
+# Extract as WebP (best for web)
+ffmpeg -i animation.mp4 -vf fps=30 frame_%04d.webp
+
+# Extract as PNG (higher quality, larger)
+ffmpeg -i animation.mp4 -vf fps=30 frame_%04d.png
+
+# Extract with quality control
+ffmpeg -i animation.mp4 -vf fps=30 -quality 90 frame_%04d.webp
+```
+
+### Using ezgif.com
+
+1. Upload MP4 video
+2. Choose "Video to GIF" → "Split to frames"
+3. Select WebP format
+4. Download all frames as ZIP
+5. Rename: `frame_0001.webp`, `frame_0002.webp`, etc.
+
+---
+
+## Background Color Matching
+
+**CRITICAL**: Page background MUST match image background exactly
+
+### Recommended Dark Backgrounds
+
+| Color Code | Usage |
+|------------|-------|
+| `#050505` | Pure black with slight lift (recommended) |
+| `#0a0a0a` | Slightly lighter, less harsh |
+| `#000000` | True black (only if images are true black) |
+| `#1a1a1a` | Dark gray (for lighter renders) |
+
+**Pro tip**: Use eyedropper tool on first frame background, use exact hex in CSS
+
+---
+
+## Alternative Animation Styles
+
+### Rotation (360° spin)
+
+**Start**: Front view
+**End**: Front view (after 360° rotation)
+**Prompt**: "Rotate product 360 degrees on turntable, maintain lighting"
+
+### Zoom In (Feature reveal)
+
+**Start**: Full product view
+**End**: Close-up of key feature
+**Prompt**: "Smooth camera push-in focusing on [FEATURE], maintain focus"
+
+### Morph (Color/style change)
+
+**Start**: Product in color A
+**End**: Product in color B
+**Prompt**: "Seamlessly morph product color from [A] to [B], maintain form"
+
+---
+
+## Quality Settings
+
+### For High-End Results
+
+- **Resolution**: 1920x1080 minimum (4K for high-DPI)
+- **Format**: WebP (compression) or PNG (quality)
+- **Frame count**: 90-150 frames (3-5 seconds at 30fps)
+- **Total size**: Target <50MB for all frames combined
+
+### Optimization Tips
+
+1. Use WebP format (70% smaller than PNG)
+2. Compress with quality 85-90
+3. Resize images to max 2000px width
+4. Use consistent aspect ratio (16:9 or 1:1)
+
+---
+
+## Testing Checklist
+
+- [ ] Background color matches exactly (no visible edges)
+- [ ] All frames same dimensions
+- [ ] Smooth motion (no jumps between frames)
+- [ ] Consistent lighting across sequence
+- [ ] File names sequential (`frame_0001` to `frame_0120`)
+- [ ] Total file size reasonable (<50MB)
+
+---
+
+## Related
+
+- concepts/scroll-linked-animations.md - Understanding the technique
+- examples/scrollytelling-headphone.md - Full implementation
+- guides/scrollytelling-setup.md - Setup instructions
+
+---
+
+## Tool References
+
+- [Runway ML](https://runwayml.com) - AI video generation
+- [Pika Labs](https://pika.art) - AI video interpolation
+- [ezgif](https://ezgif.com/split-video) - Frame extraction
+- [FFmpeg](https://ffmpeg.org) - Video processing
diff --git a/.opencode/context/ui/web/design/navigation.md b/.opencode/context/ui/web/design/navigation.md
new file mode 100644
index 0000000..2abfdab
--- /dev/null
+++ b/.opencode/context/ui/web/design/navigation.md
@@ -0,0 +1,91 @@
+---
+description: "Advanced web UI patterns - scroll animations, visual effects, and interactive design"
+---
+
+# Web Design Patterns
+
+**Purpose**: Advanced web UI patterns - scroll animations, visual effects, and interactive design
+
+**Last Updated**: 2026-01-31
+
+---
+
+## Quick Navigation
+
+### Concepts
+| File | Description | Priority |
+|------|-------------|----------|
+| [scroll-linked-animations.md](concepts/scroll-linked-animations.md) | Scroll-synced image sequences (scrollytelling) | high |
+
+### Examples
+| File | Description | Priority |
+|------|-------------|----------|
+| [scrollytelling-headphone.md](examples/scrollytelling-headphone.md) | Full Next.js scroll animation example | high |
+
+### Guides
+| File | Description | Priority |
+|------|-------------|----------|
+| [building-scrollytelling-pages.md](guides/building-scrollytelling-pages.md) | Complete implementation guide | high |
+| [premium-dark-ui-quick-start.md](guides/premium-dark-ui-quick-start.md) | Premium dark UI design system quick start | high |
+| [premium-dark-ui-visual-reference.md](guides/premium-dark-ui-visual-reference.md) | Visual reference for premium dark UI | medium |
+
+### Lookup
+| File | Description | Priority |
+|------|-------------|----------|
+| [scroll-animation-prompts.md](lookup/scroll-animation-prompts.md) | AI prompts for generating animation sequences | medium |
+
+### Errors
+| File | Description | Priority |
+|------|-------------|----------|
+| _(No error files yet)_ | | |
+
+---
+
+## Loading Strategy
+
+**For scroll animation work**:
+1. Load `concepts/scroll-linked-animations.md` (understand technique)
+2. Load `lookup/scroll-animation-prompts.md` (generate image sequences)
+3. Load `examples/scrollytelling-headphone.md` (see full code)
+4. Reference `guides/building-scrollytelling-pages.md` (step-by-step)
+
+**For premium dark UI design**:
+1. Load `guides/premium-dark-ui-quick-start.md` (implementation guide)
+2. Reference `guides/premium-dark-ui-visual-reference.md` (visual patterns)
+
+---
+
+## Scope
+
+This subcategory covers:
+- ✅ Scroll-linked animations (scrollytelling)
+- ✅ Canvas-based rendering
+- ✅ Framer Motion patterns
+- ✅ Image sequence generation
+- ✅ Premium dark UI design system
+- ✅ Glassmorphism patterns
+- ⏳ CSS animations (future)
+- ⏳ SVG animations (future)
+- ⏳ WebGL effects (future)
+
+---
+
+## Related Categories
+
+- `ui/web/` - Core web UI patterns (parent directory)
+- `ui/web/animation-patterns.md` - CSS animations and transitions
+- `development/` - General development patterns
+
+---
+
+## Used By
+
+**Agents**: frontend-specialist, design-specialist, animation-expert
+
+## Statistics
+- Concepts: 1
+- Examples: 1
+- Guides: 3
+- Lookup: 1
+- Errors: 0
+- **Total**: 6 files
diff --git a/.opencode/context/ui/web/navigation.md b/.opencode/context/ui/web/navigation.md
new file mode 100644
index 0000000..2bc73a6
--- /dev/null
+++ b/.opencode/context/ui/web/navigation.md
@@ -0,0 +1,116 @@
+# Web UI Context
+
+**Purpose**: Web-based UI patterns, animations, styling standards, and React component design
+
+**Last Updated**: 2026-01-07
+
+---
+
+## Quick Navigation
+
+### Core Files
+
+| File | Description | Priority |
+|------|-------------|----------|
+| [animation-basics.md](animation-basics.md) | Animation fundamentals, timing, easing | high |
+| [animation-components.md](animation-components.md) | Button, card, modal, dropdown animations | high |
+| [animation-chat.md](animation-chat.md) | Chat UI and message animations | medium |
+| [animation-loading.md](animation-loading.md) | Skeleton, spinner, progress animations | medium |
+| [animation-forms.md](animation-forms.md) | Form input and validation animations | medium |
+| [animation-advanced.md](animation-advanced.md) | Recipes, best practices, accessibility | medium |
+| [ui-styling-standards.md](ui-styling-standards.md) | CSS frameworks, Tailwind patterns, styling best practices | high |
+| [react-patterns.md](react-patterns.md) | Modern React patterns, hooks, component design | high |
+| [design-systems.md](design-systems.md) | Design system principles and component libraries | medium |
+| [images-guide.md](images-guide.md) | Placeholder and responsive images | medium |
+| [icons-guide.md](icons-guide.md) | Icon systems (Lucide, Heroicons, FA) | medium |
+| [fonts-guide.md](fonts-guide.md) | Font loading and optimization | medium |
+| [cdn-resources.md](cdn-resources.md) | CDN libraries and resources | medium |
+
+### Subcategories
+
+| Subcategory | Description | Path |
+|-------------|-------------|------|
+| **design/** | Advanced design patterns (scrollytelling, effects) | [design/navigation.md](design/navigation.md) |
+
+---
+
+## Loading Strategy
+
+### For general web UI work:
+1. Load `ui-styling-standards.md` (CSS frameworks, Tailwind)
+2. Load `react-patterns.md` (component patterns)
+3. Reference `animation-patterns.md` (if animations needed)
+
+### For animation work:
+1. Load `animation-basics.md` (fundamentals, timing, easing)
+2. Load `animation-components.md` (UI component animations)
+3. Reference `animation-chat.md` for chat UI patterns
+4. Reference `animation-advanced.md` for recipes and accessibility
+
+### For scroll animations:
+1. Navigate to `design/` subcategory
+2. Load scroll-linked animation guides
+
+---
+
+## Scope
+
+This subcategory covers:
+- ✅ CSS animations and transitions
+- ✅ Tailwind CSS and utility-first styling
+- ✅ React component patterns and hooks
+- ✅ Design systems and component libraries
+- ✅ Icon libraries and web fonts
+- ✅ Scroll-linked animations (scrollytelling)
+- ✅ Canvas-based rendering
+- ✅ Framer Motion patterns
+
+---
+
+## File Summaries
+
+### animation-basics.md, animation-components.md, animation-chat.md, animation-loading.md, animation-forms.md, animation-advanced.md
+CSS animations, micro-interactions, and UI transitions split into focused modules.
+
+**Key topics**: Animation micro-syntax, 60fps performance, reduced motion, chat UI animations, component patterns
+
+### ui-styling-standards.md
+CSS framework usage, Tailwind CSS patterns, responsive design, and styling best practices.
+
+**Key topics**: Utility-first CSS, component styling, responsive breakpoints, dark mode
+
+### react-patterns.md
+Modern React patterns including functional components, hooks, state management, and performance optimization.
+
+**Key topics**: Custom hooks, context API, code splitting, memoization
+
+### design-systems.md
+Design system principles, component libraries, and maintaining consistency across applications.
+
+**Key topics**: Design tokens, component APIs, documentation, versioning
+
+### images-guide.md, icons-guide.md, fonts-guide.md, cdn-resources.md
+Managing design assets in web applications - split into focused guides.
+
+**Key topics**: Placeholder images, icon libraries (Lucide, Heroicons), web fonts, CDN resources
+
+---
+
+## Related Categories
+
+- `ui/terminal/` - Terminal UI patterns
+- `development/` - General development patterns
+- `product/` - Product design and UX strategy
+
+---
+
+## Used By
+
+**Agents**: frontend-specialist, design-specialist, ui-developer, react-developer, animation-expert
+
+---
+
+## Statistics
+- Core files: 8
+- Subcategories: 1 (design/)
+- **Total context files**: 8 + design subcategory
diff --git a/.opencode/context/ui/web/react-patterns.md b/.opencode/context/ui/web/react-patterns.md
new file mode 100644
index 0000000..f0eb3a7
--- /dev/null
+++ b/.opencode/context/ui/web/react-patterns.md
@@ -0,0 +1,328 @@
+# React Patterns & Best Practices
+
+**Category**: development
+**Purpose**: Modern React patterns, hooks usage, and component design principles
+**Used by**: frontend-specialist
+
+---
+
+## Overview
+
+This guide covers modern React patterns using functional components, hooks, and best practices for building scalable React applications.
+
+## Component Patterns
+
+### 1. Functional Components with Hooks
+
+**Always use functional components**:
+```jsx
+// Good
+function UserProfile({ userId }) {
+ const [user, setUser] = useState(null);
+
+ useEffect(() => {
+ fetchUser(userId).then(setUser);
+ }, [userId]);
+
+ return {user?.name}
;
+}
+```
+
+### 2. Custom Hooks for Reusable Logic
+
+**Extract common logic into custom hooks**:
+```jsx
+// Custom hook
+function useUser(userId) {
+ const [user, setUser] = useState(null);
+ const [loading, setLoading] = useState(true);
+ const [error, setError] = useState(null);
+
+ useEffect(() => {
+ setLoading(true);
+ fetchUser(userId)
+ .then(setUser)
+ .catch(setError)
+ .finally(() => setLoading(false));
+ }, [userId]);
+
+ return { user, loading, error };
+}
+
+// Usage
+function UserProfile({ userId }) {
+ const { user, loading, error } = useUser(userId);
+
+ if (loading) return {user.name}
;
+}
+```
+
+### 3. Composition Over Props Drilling
+
+**Use composition to avoid prop drilling**:
+```jsx
+// Bad - Props drilling
+function App() {
+ const [theme, setTheme] = useState('light');
+ return ...
;
+}
+```
+
+### 4. Compound Components
+
+**For complex, related components**:
+```jsx
+function Tabs({ children }) {
+ const [activeTab, setActiveTab] = useState(0);
+
+ return (
+ {children}
;
+};
+
+Tabs.Tab = function Tab({ index, children }) {
+ const { activeTab, setActiveTab } = useContext(TabsContext);
+ return (
+
+ );
+};
+
+Tabs.Panel = function TabPanel({ index, children }) {
+ const { activeTab } = useContext(TabsContext);
+ return activeTab === index ? {children}
: null;
+};
+
+// Usage
+{items[index].name}
+ );
+
+ return (
+
+
+
+
+Left
+ Right
+
+ Content
+
+```
+
+### Testing Requirements
+
+✅ Test at minimum breakpoints: 375px, 768px, 1024px, 1440px
+✅ Verify touch targets (min 44x44px)
+✅ Check text readability at all sizes
+✅ Ensure images scale properly
+✅ Test navigation on mobile
+
+---
+
+## Color Palette Guidelines
+
+### Avoid Bootstrap Blue
+
+**Rule**: NEVER use generic Bootstrap blue (#007bff) unless explicitly requested
+
+**Why**: Overused, lacks personality, feels dated
+
+**Alternatives**:
+
+```css
+/* Instead of Bootstrap blue */
+--bootstrap-blue: #007bff; /* ❌ Avoid */
+
+/* Use contextual colors */
+--primary: oklch(0.6489 0.2370 26.9728); /* Vibrant orange */
+--accent: oklch(0.5635 0.2408 260.8178); /* Rich purple */
+--info: oklch(0.6200 0.1900 260); /* Modern blue */
+--success: oklch(0.7323 0.2492 142.4953); /* Fresh green */
+```
+
+### Color Usage Rules
+
+1. **Semantic naming**: Use `--primary`, `--accent`, not `--blue`, `--red`
+2. **Brand alignment**: Choose colors that match project personality
+3. **Contrast testing**: Ensure WCAG AA compliance (4.5:1 minimum)
+4. **Consistency**: Use theme variables throughout
+
+---
+
+## Background/Foreground Contrast
+
+### Contrast Rule
+
+**When designing components or posters**:
+
+- **Light component** → Dark background
+- **Dark component** → Light background
+
+**Why**: Ensures visibility and creates visual hierarchy
+
+**Examples**:
+
+```html
+
+
+
+
+
+
+ Light card content
+
+
+
+```
+
+### Component-Specific Rules
+
+**Posters/Hero Sections**:
+- Use high contrast for readability
+- Consider overlay gradients for text on images
+- Test with actual content
+
+**Cards/Panels**:
+- Subtle elevation with shadows
+- Clear boundary between card and background
+- Consistent padding
+
+---
+
+## CSS Specificity & Overrides
+
+### Using !important
+
+**Rule**: Use `!important` for properties that might be overwritten by Tailwind or Flowbite
+
+**Common Cases**:
+
+```css
+/* Typography overrides */
+h1 {
+ font-size: 2.5rem !important;
+ font-weight: 700 !important;
+ line-height: 1.2 !important;
+}
+
+body {
+ font-family: 'Inter', sans-serif !important;
+ color: var(--foreground) !important;
+}
+
+/* Component overrides */
+.custom-button {
+ background-color: var(--primary) !important;
+ border-radius: var(--radius) !important;
+}
+```
+
+**When NOT to use**:
+
+```css
+/* ❌ Don't use for everything */
+.element {
+ margin: 1rem !important;
+ padding: 1rem !important;
+ display: flex !important;
+}
+
+/* ✅ Use Tailwind utilities instead */
+
+ Dark card content
+
+
+```
+
+### Specificity Best Practices
+
+1. **Prefer utility classes** over custom CSS
+2. **Use !important sparingly** - only for framework overrides
+3. **Scope custom styles** to avoid conflicts
+4. **Use CSS custom properties** for theming
+
+---
+
+## Layout Patterns
+
+### Flexbox (Preferred for 1D layouts)
+
+```html
+
+
+
+```
+
+---
+
+## Typography Standards
+
+### Hierarchy
+
+```html
+
+...
+
+...
+...
+
+
+
+
+
+```
+
+### Critical CSS
+
+```html
+
+
+
+
+
+```
+
+---
+
+## Best Practices
+
+### Do's ✅
+
+- Use Tailwind utility classes for rapid development
+- Load Tailwind via script tag for JIT compilation
+- Use Flowbite as default component library
+- Ensure all designs are mobile-first responsive
+- Test at multiple breakpoints
+- Use semantic HTML elements
+- Provide ARIA labels for interactive elements
+- Use CSS custom properties for theming
+- Apply `!important` for framework overrides
+- Ensure proper color contrast (WCAG AA)
+
+### Don'ts ❌
+
+- Don't use Bootstrap blue without explicit request
+- Don't load Tailwind as a stylesheet
+- Don't skip responsive design
+- Don't use div soup (use semantic HTML)
+- Don't forget focus states
+- Don't hardcode colors (use theme variables)
+- Don't skip accessibility testing
+- Don't use tiny touch targets (<44px)
+- Don't mix color formats
+- Don't over-use `!important`
+
+---
+
+## Framework Alternatives
+
+If user requests a different framework:
+
+**Bootstrap**:
+```html
+
+
+```
+
+**Bulma**:
+```html
+
+```
+
+**Foundation**:
+```html
+
+
+```
+
+---
+
+## References
+
+- [Tailwind CSS Documentation](https://tailwindcss.com/docs)
+- [Flowbite Components](https://flowbite.com/docs/getting-started/introduction/)
+- [WCAG Guidelines](https://www.w3.org/WAI/WCAG21/quickref/)
+- [MDN Web Accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility)
diff --git a/.opencode/env.example b/.opencode/env.example
new file mode 100644
index 0000000..4d6ba21
--- /dev/null
+++ b/.opencode/env.example
@@ -0,0 +1,24 @@
+# Telegram Bot Configuration
+# Copy this file to .env and fill in your actual values
+
+# Your Telegram bot token (get from @BotFather)
+TELEGRAM_BOT_TOKEN=your_bot_token_here
+
+# Your chat ID (get by messaging your bot and checking the API)
+TELEGRAM_CHAT_ID=your_chat_id_here
+
+# Your bot username (optional, defaults to @OpenCode)
+TELEGRAM_BOT_USERNAME=@YourBotUsername
+
+# Idle timeout in milliseconds (default: 5 minutes = 300000ms)
+TELEGRAM_IDLE_TIMEOUT=300000
+
+# Check interval in milliseconds (default: 30 seconds = 30000ms)
+TELEGRAM_CHECK_INTERVAL=30000
+
+# Enable/disable the plugin (true/false)
+TELEGRAM_ENABLED=true
+
+# Gemini API Configuration
+# Get your API key from https://makersuite.google.com/app/apikey
+GEMINI_API_KEY=your_gemini_api_key_here
diff --git a/.opencode/skills/context7/README.md b/.opencode/skills/context7/README.md
new file mode 100644
index 0000000..bd53d61
--- /dev/null
+++ b/.opencode/skills/context7/README.md
@@ -0,0 +1,102 @@
+# Context7 Skill
+
+## Purpose
+
+Fetches **live, version-specific documentation** for external libraries and frameworks using the Context7 API. Ensures you always get current API patterns instead of potentially outdated training data.
+
+**Golden Rule**: Always fetch live docs for external libraries—training data may be outdated.
+
+## Quick Start
+
+### Recommended: Use ExternalScout Subagent
+
+The **ExternalScout** subagent is the recommended way to fetch external documentation. It handles:
+- Library detection
+- Query optimization
+- Documentation filtering and sorting
+- Formatted results with code examples
+
+**Invocation**:
+```
+Use ExternalScout to fetch documentation for [Library Name]: [your specific question]
+```
+
+**Example**:
+```
+Use ExternalScout to fetch documentation for Drizzle ORM: How do I set up modular schemas with PostgreSQL?
+```
+
+### Alternative: Direct Skill Usage
+
+You can also invoke the Context7 skill directly via bash:
+
+```bash
+# Step 1: Search for library
+curl -s "https://context7.com/api/v2/libs/search?libraryName=LIBRARY&query=TOPIC" | jq '.results[0]'
+
+# Step 2: Fetch documentation
+curl -s "https://context7.com/api/v2/context?libraryId=LIBRARY_ID&query=OPTIMIZED_QUERY&type=txt"
+```
+
+See `SKILL.md` for detailed API documentation.
+
+## Supported Libraries
+
+See `library-registry.md` for the complete list of supported libraries including:
+- **Database & ORM**: Drizzle, Prisma
+- **Authentication**: Better Auth, NextAuth.js, Clerk
+- **Frontend**: Next.js, React, TanStack Query/Router/Start
+- **Infrastructure**: Cloudflare Workers, AWS Lambda, Vercel
+- **UI**: Shadcn/ui, Radix UI, Tailwind CSS
+- **State**: Zustand, Jotai
+- **Validation**: Zod, React Hook Form
+- **Testing**: Vitest, Playwright
+
+## Workflow
+
+```
+User Query
+ ↓
+ContextScout (searches internal context)
+ ↓
+No internal context found
+ ↓
+ContextScout recommends ExternalScout
+ ↓
+ExternalScout invoked
+ ├─ Reads library-registry.md
+ ├─ Detects library
+ ├─ Loads query patterns
+ ├─ Fetches from Context7 API
+ ├─ Filters & sorts results
+ └─ Returns formatted documentation
+ ↓
+User receives current, actionable docs
+```
+
+## Files
+
+- **`SKILL.md`** - Context7 API documentation and usage
+- **`library-registry.md`** - Supported libraries, aliases, and query patterns
+- **`README.md`** - This file (overview and quick start)
+
+## Adding New Libraries
+
+To add a new library to the registry:
+
+1. Edit `library-registry.md`
+2. Add entry under appropriate category:
+ ```markdown
+ #### Library Name
+ - **Aliases**: `alias1`, `alias2`, `package-name`
+ - **Docs**: https://example.com/docs
+ - **Context7**: `use context7 for library-name`
+ - **Common topics**: topic1, topic2, topic3
+ ```
+3. (Optional) Add query optimization patterns
+4. ExternalScout will automatically detect the new library
+
+## Related
+
+- **ExternalScout**: `.opencode/agent/subagents/core/externalscout.md`
+- **ContextScout**: `.opencode/agent/subagents/core/contextscout.md`
diff --git a/.opencode/skills/context7/SKILL.md b/.opencode/skills/context7/SKILL.md
new file mode 100644
index 0000000..76160b2
--- /dev/null
+++ b/.opencode/skills/context7/SKILL.md
@@ -0,0 +1,85 @@
+---
+name: context7
+description: Retrieve up-to-date documentation for software libraries, frameworks, and components via the Context7 API. This skill should be used when looking up documentation for any programming library or framework, finding code examples for specific APIs or features, verifying correct usage of library functions, or obtaining current information about library APIs that may have changed since training.
+---
+
+# Context7
+
+## Overview
+
+This skill enables retrieval of current documentation for software libraries and components by querying the Context7 API via curl. Use it instead of relying on potentially outdated training data.
+
+## Workflow
+
+### Step 1: Search for the Library
+
+To find the Context7 library ID, query the search endpoint:
+
+```bash
+curl -s "https://context7.com/api/v2/libs/search?libraryName=LIBRARY_NAME&query=TOPIC" | jq '.results[0]'
+```
+
+**Parameters:**
+- `libraryName` (required): The library name to search for (e.g., "react", "nextjs", "fastapi", "axios")
+- `query` (required): A description of the topic for relevance ranking
+
+**Response fields:**
+- `id`: Library identifier for the context endpoint (e.g., `/websites/react_dev_reference`)
+- `title`: Human-readable library name
+- `description`: Brief description of the library
+- `totalSnippets`: Number of documentation snippets available
+
+### Step 2: Fetch Documentation
+
+To retrieve documentation, use the library ID from step 1:
+
+```bash
+curl -s "https://context7.com/api/v2/context?libraryId=LIBRARY_ID&query=TOPIC&type=txt"
+```
+
+**Parameters:**
+- `libraryId` (required): The library ID from search results
+- `query` (required): The specific topic to retrieve documentation for
+- `type` (optional): Response format - `json` (default) or `txt` (plain text, more readable)
+
+## Examples
+
+### React hooks documentation
+
+```bash
+# Find React library ID
+curl -s "https://context7.com/api/v2/libs/search?libraryName=react&query=hooks" | jq '.results[0].id'
+# Returns: "/websites/react_dev_reference"
+
+# Fetch useState documentation
+curl -s "https://context7.com/api/v2/context?libraryId=/websites/react_dev_reference&query=useState&type=txt"
+```
+
+### Next.js routing documentation
+
+```bash
+# Find Next.js library ID
+curl -s "https://context7.com/api/v2/libs/search?libraryName=nextjs&query=routing" | jq '.results[0].id'
+
+# Fetch app router documentation
+curl -s "https://context7.com/api/v2/context?libraryId=/vercel/next.js&query=app+router&type=txt"
+```
+
+### FastAPI dependency injection
+
+```bash
+# Find FastAPI library ID
+curl -s "https://context7.com/api/v2/libs/search?libraryName=fastapi&query=dependencies" | jq '.results[0].id'
+
+# Fetch dependency injection documentation
+curl -s "https://context7.com/api/v2/context?libraryId=/fastapi/fastapi&query=dependency+injection&type=txt"
+```
+
+## Tips
+
+- Use `type=txt` for more readable output
+- Use `jq` to filter and format JSON responses
+- Be specific with the `query` parameter to improve relevance ranking
+- If the first search result is not correct, check additional results in the array
+- URL-encode query parameters containing spaces (use `+` or `%20`)
+- No API key is required for basic usage (rate-limited)
\ No newline at end of file
diff --git a/.opencode/skills/context7/library-registry.md b/.opencode/skills/context7/library-registry.md
new file mode 100644
index 0000000..4c2f5d4
--- /dev/null
+++ b/.opencode/skills/context7/library-registry.md
@@ -0,0 +1,290 @@
+# External Library Registry
+
+## Purpose
+
+This file lists external libraries/frameworks that should use **ExternalScout** (via Context7) for live documentation instead of relying on potentially outdated training data.
+
+## When to Use This
+
+**ContextScout** checks this list when:
+1. User asks about a library/framework
+2. No internal context exists in `.opencode/context/development/frameworks/`
+3. Query matches a library name below
+
+**Action**: Recommend **ExternalScout** subagent
+
+---
+
+## Supported Libraries
+
+### Database & ORM
+
+#### Drizzle ORM
+- **Aliases**: `drizzle`, `drizzle-orm`, `drizzle orm`
+- **Docs**: https://orm.drizzle.team/
+- **Context7**: `use context7 for drizzle`
+- **Common topics**: schema organization, migrations, relational queries, transactions, TypeScript types
+
+#### Prisma
+- **Aliases**: `prisma`
+- **Docs**: https://www.prisma.io/docs
+- **Context7**: `use context7 for prisma`
+- **Common topics**: schema, migrations, client, relations, TypeScript
+
+---
+
+### Authentication
+
+#### Better Auth
+- **Aliases**: `better-auth`, `better auth`, `betterauth`
+- **Docs**: https://www.better-auth.com/docs
+- **Context7**: `use context7 for better-auth`
+- **Common topics**: Next.js integration, Drizzle adapter, social providers, session management, 2FA
+
+#### NextAuth.js
+- **Aliases**: `nextauth`, `next-auth`, `nextauth.js`
+- **Docs**: https://next-auth.js.org/
+- **Context7**: `use context7 for nextauth`
+- **Common topics**: providers, callbacks, sessions, JWT
+
+#### Clerk
+- **Aliases**: `clerk`
+- **Docs**: https://clerk.com/docs
+- **Context7**: `use context7 for clerk`
+- **Common topics**: authentication, user management, organizations
+
+---
+
+### Frontend Frameworks
+
+#### Next.js
+- **Aliases**: `nextjs`, `next.js`, `next`
+- **Docs**: https://nextjs.org/docs
+- **Context7**: `use context7 for nextjs`
+- **Common topics**: App Router, Server Actions, Server Components, routing, middleware, API routes
+
+#### React
+- **Aliases**: `react`, `reactjs`, `react.js`
+- **Docs**: https://react.dev/
+- **Context7**: `use context7 for react`
+- **Common topics**: hooks, components, state, effects, context
+
+#### TanStack Query
+- **Aliases**: `tanstack query`, `react query`, `@tanstack/react-query`
+- **Docs**: https://tanstack.com/query/latest
+- **Context7**: `use context7 for tanstack query`
+- **Common topics**: useQuery, useMutation, prefetching, caching, Server Components
+
+#### TanStack Router
+- **Aliases**: `tanstack router`, `@tanstack/react-router`
+- **Docs**: https://tanstack.com/router/latest
+- **Context7**: `use context7 for tanstack router`
+- **Common topics**: routing, type-safe routes, loaders, navigation
+
+#### TanStack Start
+- **Aliases**: `tanstack start`, `@tanstack/start`
+- **Docs**: https://tanstack.com/start/latest
+- **Context7**: `use context7 for tanstack start`
+- **Common topics**: full-stack setup, server functions, file routing
+
+---
+
+### Infrastructure & Deployment
+
+#### Cloudflare Workers
+- **Aliases**: `cloudflare workers`, `cloudflare`, `workers`, `cf workers`
+- **Docs**: https://developers.cloudflare.com/workers
+- **Context7**: `use context7 for cloudflare workers`
+- **Common topics**: routing, KV storage, Durable Objects, bindings, middleware
+
+#### AWS Lambda
+- **Aliases**: `aws lambda`, `lambda`, `aws λ`
+- **Docs**: https://docs.aws.amazon.com/lambda
+- **Context7**: `use context7 for aws lambda`
+- **Common topics**: handlers, layers, environment variables, triggers, TypeScript
+
+#### Vercel
+- **Aliases**: `vercel`
+- **Docs**: https://vercel.com/docs
+- **Context7**: `use context7 for vercel`
+- **Common topics**: deployment, environment variables, edge functions, serverless
+
+---
+
+### UI Libraries & Styling
+
+#### Shadcn/ui
+- **Aliases**: `shadcn`, `shadcn/ui`, `shadcn-ui`
+- **Docs**: https://ui.shadcn.com/
+- **Context7**: `use context7 for shadcn`
+- **Common topics**: components, installation, theming, customization
+
+#### Radix UI
+- **Aliases**: `radix`, `radix ui`, `radix-ui`, `@radix-ui`
+- **Docs**: https://www.radix-ui.com/
+- **Context7**: `use context7 for radix`
+- **Common topics**: primitives, accessibility, composition
+
+#### Tailwind CSS
+- **Aliases**: `tailwind`, `tailwindcss`, `tailwind css`
+- **Docs**: https://tailwindcss.com/docs
+- **Context7**: `use context7 for tailwind`
+- **Common topics**: configuration, utilities, responsive design, dark mode
+
+---
+
+### State Management
+
+#### Zustand
+- **Aliases**: `zustand`
+- **Docs**: https://zustand-demo.pmnd.rs/
+- **Context7**: `use context7 for zustand`
+- **Common topics**: store creation, selectors, middleware, TypeScript
+
+#### Jotai
+- **Aliases**: `jotai`
+- **Docs**: https://jotai.org/
+- **Context7**: `use context7 for jotai`
+- **Common topics**: atoms, async atoms, utilities
+
+---
+
+### Validation & Forms
+
+#### Zod
+- **Aliases**: `zod`
+- **Docs**: https://zod.dev/
+- **Context7**: `use context7 for zod`
+- **Common topics**: schema validation, TypeScript inference, parsing, refinements
+
+#### React Hook Form
+- **Aliases**: `react hook form`, `react-hook-form`, `rhf`
+- **Docs**: https://react-hook-form.com/
+- **Context7**: `use context7 for react hook form`
+- **Common topics**: register, validation, errors, TypeScript
+
+---
+
+### Testing
+
+#### Vitest
+- **Aliases**: `vitest`
+- **Docs**: https://vitest.dev/
+- **Context7**: `use context7 for vitest`
+- **Common topics**: configuration, testing, mocking, coverage
+
+#### Playwright
+- **Aliases**: `playwright`
+- **Docs**: https://playwright.dev/
+- **Context7**: `use context7 for playwright`
+- **Common topics**: browser automation, testing, selectors, assertions
+
+---
+
+## Detection Patterns
+
+ContextScout and ExternalScout should match queries containing:
+- Library name (case-insensitive)
+- Common variations (e.g., "next.js" vs "nextjs")
+- Package names (e.g., "@tanstack/react-query")
+
+**Examples**:
+- "How do I use **Drizzle** with PostgreSQL?" → Match: Drizzle ORM
+- "Show me **Next.js** App Router setup" → Match: Next.js
+- "**TanStack Query** with Server Components" → Match: TanStack Query
+- "**Better Auth** integration" → Match: Better Auth
+
+---
+
+## Query Optimization Patterns
+
+### Drizzle ORM
+
+| User Intent | Optimized Query |
+|-------------|-----------------|
+| Setup/Installation | `PostgreSQL+setup+configuration+TypeScript+installation` |
+| Modular schemas | `modular+schema+organization+domain+driven+design` |
+| Relations | `relational+queries+one+to+many+joins+with+relations` |
+| Migrations | `drizzle-kit+migrations+generate+push+PostgreSQL` |
+| Transactions | `database+transactions+patterns+TypeScript` |
+| Type safety | `TypeScript+type+inference+schema+types+inferInsert` |
+
+### Better Auth
+
+| User Intent | Optimized Query |
+|-------------|-----------------|
+| Setup | `setup+configuration+Next.js+TypeScript+installation` |
+| Next.js integration | `Next.js+App+Router+integration+setup+configuration` |
+| Drizzle adapter | `Drizzle+adapter+PostgreSQL+schema+generation+configuration` |
+| Social providers | `social+providers+OAuth+GitHub+Google+setup` |
+| Email/password | `email+password+authentication+signup+signin` |
+| Session management | `session+management+cookies+JWT+middleware` |
+
+### Next.js
+
+| User Intent | Optimized Query |
+|-------------|-----------------|
+| App Router | `App+Router+file+conventions+layouts+pages+routing` |
+| Server Actions | `Server+Actions+form+mutations+revalidation+TypeScript` |
+| Server Components | `React+Server+Components+async+data+fetching+patterns` |
+| Dynamic routes | `dynamic+routes+params+TypeScript+generateStaticParams` |
+| Middleware | `middleware+authentication+redirects+headers+cookies` |
+| API routes | `API+routes+route+handlers+TypeScript+POST+GET` |
+
+### TanStack Query
+
+| User Intent | Optimized Query |
+|-------------|-----------------|
+| Setup | `setup+QueryClient+provider+Next.js+TypeScript` |
+| Data fetching | `useQuery+data+fetching+TypeScript+patterns+async` |
+| Mutations | `useMutation+optimistic+updates+invalidation+TypeScript` |
+| Prefetching | `prefetchQuery+Server+Components+hydration+Next.js` |
+| Caching | `cache+configuration+staleTime+gcTime+invalidation` |
+
+### Cloudflare Workers
+
+| User Intent | Optimized Query |
+|-------------|-----------------|
+| Setup | `getting+started+setup+TypeScript+wrangler+configuration` |
+| Routing | `routing+itty-router+hono+request+handling` |
+| KV storage | `KV+storage+key+value+bindings+TypeScript` |
+| Durable Objects | `Durable+Objects+state+WebSockets+coordination` |
+
+### AWS Lambda
+
+| User Intent | Optimized Query |
+|-------------|-----------------|
+| Setup | `getting+started+setup+TypeScript+handler+configuration` |
+| Handlers | `handler+function+event+context+TypeScript+patterns` |
+| Layers | `layers+dependencies+shared+code+deployment` |
+| Environment variables | `environment+variables+secrets+configuration+SSM` |
+
+---
+
+## Adding New Libraries
+
+To add a new library:
+1. Add entry under appropriate category
+2. Include: Name, aliases, docs link, Context7 command, common topics
+3. (Optional) Add query optimization patterns
+4. Update ExternalScout if needed (usually automatic)
+
+**Template**:
+```markdown
+#### Library Name
+- **Aliases**: `alias1`, `alias2`, `package-name`
+- **Docs**: https://example.com/docs
+- **Context7**: `use context7 for library-name`
+- **Common topics**: topic1, topic2, topic3
+```
+
+---
+
+## Usage by ExternalScout
+
+ExternalScout uses this file to:
+1. **Detect** which library the user is asking about
+2. **Load** query optimization patterns for that library
+3. **Build** optimized Context7 queries
+4. **Fetch** live documentation
+5. **Return** filtered, relevant results
diff --git a/.opencode/skills/context7/navigation.md b/.opencode/skills/context7/navigation.md
new file mode 100644
index 0000000..30f848c
--- /dev/null
+++ b/.opencode/skills/context7/navigation.md
@@ -0,0 +1,51 @@
+# Context7 Skill Navigation
+
+**Purpose**: Live documentation fetching for external libraries via Context7 API
+
+---
+
+## Structure
+
+```
+context7/
+├── navigation.md # This file
+├── README.md # Quick start and workflow
+├── SKILL.md # Context7 API documentation
+└── library-registry.md # Supported libraries and query patterns
+```
+
+---
+
+## Quick Routes
+
+| Task | Path |
+|------|------|
+| **Quick start** | `README.md` |
+| **API reference** | `SKILL.md` |
+| **Supported libraries** | `library-registry.md` (lines 18-181) |
+| **Query patterns** | `library-registry.md` (lines 199-261) |
+| **Add new library** | `library-registry.md` (lines 264-279) |
+| **ExternalScout integration** | `README.md` (lines 9-26) |
+
+---
+
+## By Purpose
+
+**Using Context7**:
+- Quick start → `README.md`
+- API details → `SKILL.md`
+
+**Adding Libraries**:
+- Template → `library-registry.md` (lines 272-279)
+- Supported list → `library-registry.md` (lines 18-181)
+
+**Integration**:
+- ContextScout workflow → `README.md` (lines 54-73)
+- ExternalScout subagent → `.opencode/agent/subagents/core/externalscout.md`
+
+---
+
+## Related
+
+- **ExternalScout**: `.opencode/agent/subagents/core/externalscout.md`
+- **ContextScout**: `.opencode/agent/subagents/core/contextscout.md`
diff --git a/.opencode/skills/task-management/SKILL.md b/.opencode/skills/task-management/SKILL.md
new file mode 100644
index 0000000..8143066
--- /dev/null
+++ b/.opencode/skills/task-management/SKILL.md
@@ -0,0 +1,399 @@
+---
+name: task-management
+description: Task management CLI for tracking and managing feature subtasks with status, dependencies, and validation
+version: 1.0.0
+author: opencode
+type: skill
+category: development
+tags:
+ - tasks
+ - management
+ - tracking
+ - dependencies
+ - cli
+---
+
+# Task Management Skill
+
+> **Purpose**: Track, manage, and validate feature implementations with atomic task breakdowns, dependency resolution, and progress monitoring.
+
+---
+
+## What I Do
+
+I provide a command-line interface for managing task breakdowns created by the TaskManager subagent. I help you:
+
+- **Track progress** - See status of all features and their subtasks
+- **Find next tasks** - Show eligible tasks (dependencies satisfied)
+- **Identify blocked tasks** - See what's blocked and why
+- **Manage completion** - Mark subtasks as complete with summaries
+- **Validate integrity** - Check JSON files and dependency trees
+
+---
+
+## How to Use Me
+
+### Quick Start
+
+```bash
+# Show all task statuses
+bash .opencode/skills/task-management/router.sh status
+
+# Show next eligible tasks
+bash .opencode/skills/task-management/router.sh next
+
+# Show blocked tasks
+bash .opencode/skills/task-management/router.sh blocked
+
+# Mark a task complete
+bash .opencode/skills/task-management/router.sh complete "summary"
+
+# Validate all tasks
+bash .opencode/skills/task-management/router.sh validate
+```
+
+### Command Reference
+
+| Command | Description |
+|---------|-------------|
+| `status [feature]` | Show task status summary for all features or specific one |
+| `next [feature]` | Show next eligible tasks (dependencies satisfied) |
+| `parallel [feature]` | Show parallelizable tasks ready to run |
+| `deps ` | Show dependency tree for a specific subtask |
+| `blocked [feature]` | Show blocked tasks and why |
+| `complete "summary"` | Mark subtask complete with summary |
+| `validate [feature]` | Validate JSON files and dependencies |
+| `help` | Show help message |
+
+---
+
+## Examples
+
+### Check Overall Progress
+
+```bash
+$ bash .opencode/skills/task-management/router.sh status
+
+[my-feature] My Feature Implementation
+ Status: active | Progress: 45% (5/11)
+ Pending: 3 | In Progress: 2 | Completed: 5 | Blocked: 1
+```
+
+### Find What's Next
+
+```bash
+$ bash .opencode/skills/task-management/router.sh next
+
+=== Ready Tasks (deps satisfied) ===
+
+[my-feature]
+ 06 - Implement API endpoint [sequential]
+ 08 - Write unit tests [parallel]
+```
+
+### Mark Complete
+
+```bash
+$ bash .opencode/skills/task-management/router.sh complete my-feature 05 "Implemented authentication module"
+
+✓ Marked my-feature/05 as completed
+ Summary: Implemented authentication module
+ Progress: 6/11
+```
+
+### Check Dependencies
+
+```bash
+$ bash .opencode/skills/task-management/router.sh deps my-feature 07
+
+=== Dependency Tree: my-feature/07 ===
+
+07 - Write integration tests [pending]
+ ├── ✓ 05 - Implement authentication module [completed]
+ └── ○ 06 - Implement API endpoint [in_progress]
+```
+
+### Validate Everything
+
+```bash
+$ bash .opencode/skills/task-management/router.sh validate
+
+=== Validation Results ===
+
+[my-feature]
+ ✓ All checks passed
+```
+
+---
+
+## Architecture
+
+```
+.opencode/skills/task-management/
+├── SKILL.md # This file
+├── router.sh # CLI router (entry point)
+└── scripts/
+ └── task-cli.ts # Task management CLI implementation
+```
+
+---
+
+## Task File Structure
+
+Tasks are stored in `.tmp/tasks/` at the project root:
+
+```
+.tmp/tasks/
+├── {feature-slug}/
+│ ├── task.json # Feature-level metadata
+│ ├── subtask_01.json # Subtask definitions
+│ ├── subtask_02.json
+│ └── ...
+└── completed/
+ └── {feature-slug}/ # Completed tasks
+```
+
+### task.json Schema
+
+```json
+{
+ "id": "my-feature",
+ "name": "My Feature",
+ "status": "active",
+ "objective": "Implement X",
+ "context_files": ["docs/spec.md"],
+ "reference_files": ["src/existing.ts"],
+ "exit_criteria": ["Tests pass", "Code reviewed"],
+ "subtask_count": 5,
+ "completed_count": 2,
+ "created_at": "2026-01-11T10:00:00Z",
+ "completed_at": null
+}
+```
+
+### subtask_##.json Schema
+
+```json
+{
+ "id": "my-feature-05",
+ "seq": "05",
+ "title": "Implement authentication",
+ "status": "pending",
+ "depends_on": ["03", "04"],
+ "parallel": false,
+ "suggested_agent": "coder-agent",
+ "context_files": ["docs/auth.md"],
+ "reference_files": ["src/auth-old.ts"],
+ "acceptance_criteria": ["Login works", "JWT tokens valid"],
+ "deliverables": ["auth.ts", "auth.test.ts"],
+ "started_at": null,
+ "completed_at": null,
+ "completion_summary": null
+}
+```
+
+---
+
+## Integration with TaskManager
+
+The TaskManager subagent creates task files using this format. When you delegate to TaskManager:
+
+```javascript
+task(
+ subagent_type="TaskManager",
+ description="Implement feature X",
+ prompt="Break down this feature into atomic subtasks..."
+)
+```
+
+TaskManager creates:
+1. `.tmp/tasks/{feature}/task.json` - Feature metadata
+2. `.tmp/tasks/{feature}/subtask_XX.json` - Individual subtasks
+
+You can then use this skill to track and manage progress.
+
+---
+
+## Key Concepts
+
+### 1. Dependency Resolution
+Subtasks can depend on other subtasks. A task is "ready" only when all its dependencies are complete.
+
+### 2. Parallel Execution
+Set `parallel: true` to indicate a subtask can run alongside other parallel tasks with satisfied dependencies.
+
+### 3. Status Tracking
+- **pending** - Not started, waiting for dependencies
+- **in_progress** - Currently being worked on
+- **completed** - Finished with summary
+- **blocked** - Explicitly blocked (not waiting for deps)
+
+### 4. Exit Criteria
+Each feature has exit_criteria that must be met before marking the feature complete.
+
+### 5. Validation Rules
+
+The `validate` command performs comprehensive checks on task files:
+
+**Task-Level Validation:**
+- ✅ task.json file exists for the feature
+- ✅ Task ID matches feature slug
+- ✅ Subtask count in task.json matches actual subtask files
+- ✅ All required fields are present
+
+**Subtask-Level Validation:**
+- ✅ All subtask IDs start with feature name (e.g., "my-feature-01")
+- ✅ Sequence numbers are unique and properly formatted (01, 02, etc.)
+- ✅ All dependencies reference existing subtasks
+- ✅ No circular dependencies exist
+- ✅ Each subtask has acceptance criteria defined
+- ✅ Each subtask has deliverables specified
+- ✅ Status values are valid (pending, in_progress, completed, blocked)
+
+**Dependency Validation:**
+- ✅ All depends_on references point to existing subtasks
+- ✅ No task depends on itself
+- ✅ No circular dependency chains
+- ✅ Dependency graph is acyclic
+
+Run `validate` regularly to catch issues early:
+```bash
+bash .opencode/skills/task-management/router.sh validate my-feature
+```
+
+### 6. Context and Reference Files
+- **context_files** - Standards, conventions, and guidelines to follow
+- **reference_files** - Existing project files to look at or build upon
+
+---
+
+## Workflow Integration
+
+### With TaskManager Subagent
+
+1. **TaskManager creates tasks** → Generates `.tmp/tasks/{feature}/` structure
+2. **You use this skill to track** → Monitor progress with `status`, `next`, `blocked`
+3. **You mark tasks complete** → Use `complete` command with summaries
+4. **Skill validates integrity** → Use `validate` to check consistency
+
+### With Other Subagents
+
+Working agents (CoderAgent, TestEngineer, etc.) execute subtasks and report completion. Use this skill to:
+- Find next available tasks with `next`
+- Check what's blocking progress with `blocked`
+- Validate task definitions with `validate`
+
+---
+
+## Common Workflows
+
+### Starting a New Feature
+
+```bash
+# 1. TaskManager creates the task structure
+task(subagent_type="TaskManager", description="Implement feature X", ...)
+
+# 2. Check what's ready
+bash .opencode/skills/task-management/router.sh next
+
+# 3. Delegate first task to working agent
+task(subagent_type="CoderAgent", description="Implement subtask 01", ...)
+```
+
+### Tracking Progress
+
+```bash
+# Check overall status
+bash .opencode/skills/task-management/router.sh status my-feature
+
+# See what's next
+bash .opencode/skills/task-management/router.sh next my-feature
+
+# Check what's blocked
+bash .opencode/skills/task-management/router.sh blocked my-feature
+```
+
+### Completing Tasks
+
+```bash
+# After working agent finishes
+bash .opencode/skills/task-management/router.sh complete my-feature 05 "Implemented auth module with JWT support"
+
+# Check progress
+bash .opencode/skills/task-management/router.sh status my-feature
+
+# Find next task
+bash .opencode/skills/task-management/router.sh next my-feature
+```
+
+### Validating Everything
+
+```bash
+# Validate all tasks
+bash .opencode/skills/task-management/router.sh validate
+
+# Validate specific feature
+bash .opencode/skills/task-management/router.sh validate my-feature
+```
+
+---
+
+## Tips & Best Practices
+
+### 1. Use Meaningful Summaries
+When marking tasks complete, provide clear summaries:
+```bash
+# Good
+complete my-feature 05 "Implemented JWT authentication with refresh tokens and error handling"
+
+# Avoid
+complete my-feature 05 "Done"
+```
+
+### 2. Check Dependencies Before Starting
+```bash
+# See what a task depends on
+bash .opencode/skills/task-management/router.sh deps my-feature 07
+```
+
+### 3. Identify Parallelizable Work
+```bash
+# Find tasks that can run in parallel
+bash .opencode/skills/task-management/router.sh parallel my-feature
+```
+
+### 4. Regular Validation
+```bash
+# Validate regularly to catch issues early
+bash .opencode/skills/task-management/router.sh validate
+```
+
+---
+
+## Troubleshooting
+
+### "task-cli.ts not found"
+Make sure you're running from the project root or the router.sh can find it.
+
+### "No tasks found"
+Run `status` to see if any tasks have been created yet. Use TaskManager to create tasks first.
+
+### "Dependency not satisfied"
+Check the dependency tree with `deps` to see what's blocking the task.
+
+### "Validation failed"
+Run `validate` to see specific issues, then check the JSON files in `.tmp/tasks/`.
+
+---
+
+## File Locations
+
+- **Skill**: `.opencode/skills/task-management/`
+- **Router**: `.opencode/skills/task-management/router.sh`
+- **CLI**: `.opencode/skills/task-management/scripts/task-cli.ts`
+- **Tasks**: `.tmp/tasks/` (created by TaskManager)
+- **Documentation**: `.opencode/skills/task-management/SKILL.md` (this file)
+
+---
+
+**Task Management Skill** - Track, manage, and validate your feature implementations!
diff --git a/.opencode/skills/task-management/router.sh b/.opencode/skills/task-management/router.sh
new file mode 100644
index 0000000..4066c2c
--- /dev/null
+++ b/.opencode/skills/task-management/router.sh
@@ -0,0 +1,85 @@
+#!/usr/bin/env bash
+#############################################################################
+# Task Management Skill Router
+# Routes to task-cli.ts with proper path resolution and command handling
+#############################################################################
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+CLI_SCRIPT="$SCRIPT_DIR/scripts/task-cli.ts"
+
+# Show help
+show_help() {
+ cat << 'HELP'
+📋 Task Management Skill
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Usage: router.sh [COMMAND] [OPTIONS]
+
+COMMANDS:
+ status [feature] Show task status summary
+ next [feature] Show next eligible tasks
+ parallel [feature] Show parallelizable tasks
+ deps Show dependency tree
+ blocked [feature] Show blocked tasks
+ complete "msg" Mark subtask complete
+ validate [feature] Validate JSON files
+ help Show this help message
+
+EXAMPLES:
+ ./router.sh status
+ ./router.sh status my-feature
+ ./router.sh next
+ ./router.sh deps my-feature 05
+ ./router.sh complete my-feature 05 "Implemented auth module"
+ ./router.sh validate
+
+FEATURES:
+ ✓ Track progress across all features
+ ✓ Find next eligible tasks (dependencies satisfied)
+ ✓ Identify blocked tasks
+ ✓ Mark subtasks complete with summaries
+ ✓ Validate task integrity
+
+For more info, see: .opencode/skills/task-management/SKILL.md
+HELP
+}
+
+# Check if CLI script exists
+if [ ! -f "$CLI_SCRIPT" ]; then
+ echo "❌ Error: task-cli.ts not found at $CLI_SCRIPT"
+ exit 1
+fi
+
+# Find project root
+find_project_root() {
+ local dir
+ dir="$(pwd)"
+ while [ "$dir" != "/" ]; do
+ if [ -d "$dir/.git" ] || [ -f "$dir/package.json" ]; then
+ echo "$dir"
+ return 0
+ fi
+ dir="$(dirname "$dir")"
+ done
+ pwd
+ return 1
+}
+
+# Handle help
+if [ "$1" = "help" ] || [ "$1" = "-h" ] || [ "$1" = "--help" ]; then
+ show_help
+ exit 0
+fi
+
+# If no arguments, show help
+if [ $# -eq 0 ]; then
+ show_help
+ exit 0
+fi
+
+PROJECT_ROOT="$(find_project_root)"
+
+# Run the task CLI with all arguments
+cd "$PROJECT_ROOT" && npx ts-node "$CLI_SCRIPT" "$@"
diff --git a/.opencode/skills/task-management/scripts/task-cli.ts b/.opencode/skills/task-management/scripts/task-cli.ts
new file mode 100644
index 0000000..64b4068
--- /dev/null
+++ b/.opencode/skills/task-management/scripts/task-cli.ts
@@ -0,0 +1,553 @@
+#!/usr/bin/env npx ts-node
+/**
+ * Task Management CLI
+ *
+ * Usage: npx ts-node task-cli.ts [feature] [args...]
+ *
+ * Commands:
+ * status [feature] - Show task status summary
+ * next [feature] - Show next eligible tasks
+ * parallel [feature] - Show parallelizable tasks ready to run
+ * deps - Show dependency tree for a task
+ * blocked [feature] - Show blocked tasks and why
+ * complete "summary" - Mark task completed
+ * validate [feature] - Validate JSON files and dependencies
+ *
+ * Task files are stored in .tmp/tasks/ at the project root:
+ * .tmp/tasks/{feature-slug}/task.json
+ * .tmp/tasks/{feature-slug}/subtask_01.json
+ * .tmp/tasks/completed/{feature-slug}/
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// Find project root (look for .git or package.json)
+function findProjectRoot(): string {
+ let dir = process.cwd();
+ while (dir !== path.dirname(dir)) {
+ if (fs.existsSync(path.join(dir, '.git')) || fs.existsSync(path.join(dir, 'package.json'))) {
+ return dir;
+ }
+ dir = path.dirname(dir);
+ }
+ return process.cwd();
+}
+
+const PROJECT_ROOT = findProjectRoot();
+const TASKS_DIR = path.join(PROJECT_ROOT, '.tmp', 'tasks');
+const COMPLETED_DIR = path.join(TASKS_DIR, 'completed');
+
+interface Task {
+ id: string;
+ name: string;
+ status: 'active' | 'completed' | 'blocked' | 'archived';
+ objective: string;
+ context_files: string[];
+ reference_files?: string[];
+ exit_criteria: string[];
+ subtask_count: number;
+ completed_count: number;
+ created_at: string;
+ completed_at: string | null;
+}
+
+interface Subtask {
+ id: string;
+ seq: string;
+ title: string;
+ status: 'pending' | 'in_progress' | 'completed' | 'blocked';
+ depends_on: string[];
+ parallel: boolean;
+ context_files: string[];
+ reference_files?: string[];
+ acceptance_criteria: string[];
+ deliverables: string[];
+ agent_id: string | null;
+ suggested_agent?: string;
+ started_at: string | null;
+ completed_at: string | null;
+ completion_summary: string | null;
+}
+
+// Helpers
+function getFeatureDirs(): string[] {
+ if (!fs.existsSync(TASKS_DIR)) return [];
+ return fs.readdirSync(TASKS_DIR).filter((f: string) => {
+ const fullPath = path.join(TASKS_DIR, f);
+ return fs.statSync(fullPath).isDirectory() && f !== 'completed';
+ });
+}
+
+function loadTask(feature: string): Task | null {
+ const taskPath = path.join(TASKS_DIR, feature, 'task.json');
+ if (!fs.existsSync(taskPath)) return null;
+ return JSON.parse(fs.readFileSync(taskPath, 'utf-8'));
+}
+
+function loadSubtasks(feature: string): Subtask[] {
+ const featureDir = path.join(TASKS_DIR, feature);
+ if (!fs.existsSync(featureDir)) return [];
+
+ const files = fs.readdirSync(featureDir)
+ .filter((f: string) => f.match(/^subtask_\d{2}\.json$/))
+ .sort();
+
+ return files.map((f: string) => JSON.parse(fs.readFileSync(path.join(featureDir, f), 'utf-8')));
+}
+
+function saveSubtask(feature: string, subtask: Subtask): void {
+ const subtaskPath = path.join(TASKS_DIR, feature, `subtask_${subtask.seq}.json`);
+ fs.writeFileSync(subtaskPath, JSON.stringify(subtask, null, 2));
+}
+
+function saveTask(feature: string, task: Task): void {
+ const taskPath = path.join(TASKS_DIR, feature, 'task.json');
+ fs.writeFileSync(taskPath, JSON.stringify(task, null, 2));
+}
+
+// Commands
+function cmdStatus(feature?: string): void {
+ const features = feature ? [feature] : getFeatureDirs();
+
+ if (features.length === 0) {
+ console.log('No active features found.');
+ return;
+ }
+
+ for (const f of features) {
+ const task = loadTask(f);
+ const subtasks = loadSubtasks(f);
+
+ if (!task) {
+ console.log(`\n[${f}] - No task.json found`);
+ continue;
+ }
+
+ const counts = {
+ pending: subtasks.filter(s => s.status === 'pending').length,
+ in_progress: subtasks.filter(s => s.status === 'in_progress').length,
+ completed: subtasks.filter(s => s.status === 'completed').length,
+ blocked: subtasks.filter(s => s.status === 'blocked').length,
+ };
+
+ const progress = subtasks.length > 0
+ ? Math.round((counts.completed / subtasks.length) * 100)
+ : 0;
+
+ console.log(`\n[${f}] ${task.name}`);
+ console.log(` Status: ${task.status} | Progress: ${progress}% (${counts.completed}/${subtasks.length})`);
+ console.log(` Pending: ${counts.pending} | In Progress: ${counts.in_progress} | Completed: ${counts.completed} | Blocked: ${counts.blocked}`);
+ }
+}
+
+function cmdNext(feature?: string): void {
+ const features = feature ? [feature] : getFeatureDirs();
+
+ console.log('\n=== Ready Tasks (deps satisfied) ===\n');
+
+ for (const f of features) {
+ const subtasks = loadSubtasks(f);
+ const completedSeqs = new Set(subtasks.filter(s => s.status === 'completed').map(s => s.seq));
+
+ const ready = subtasks.filter(s => {
+ if (s.status !== 'pending') return false;
+ return s.depends_on.every(dep => completedSeqs.has(dep));
+ });
+
+ if (ready.length > 0) {
+ console.log(`[${f}]`);
+ for (const s of ready) {
+ const parallel = s.parallel ? '[parallel]' : '[sequential]';
+ console.log(` ${s.seq} - ${s.title} ${parallel}`);
+ }
+ console.log();
+ }
+ }
+}
+
+function cmdParallel(feature?: string): void {
+ const features = feature ? [feature] : getFeatureDirs();
+
+ console.log('\n=== Parallelizable Tasks Ready Now ===\n');
+
+ for (const f of features) {
+ const subtasks = loadSubtasks(f);
+ const completedSeqs = new Set(subtasks.filter(s => s.status === 'completed').map(s => s.seq));
+
+ const parallel = subtasks.filter(s => {
+ if (s.status !== 'pending') return false;
+ if (!s.parallel) return false;
+ return s.depends_on.every(dep => completedSeqs.has(dep));
+ });
+
+ if (parallel.length > 0) {
+ console.log(`[${f}] - ${parallel.length} parallel tasks:`);
+ for (const s of parallel) {
+ console.log(` ${s.seq} - ${s.title}`);
+ }
+ console.log();
+ }
+ }
+}
+
+function cmdDeps(feature: string, seq: string): void {
+ const subtasks = loadSubtasks(feature);
+ const target = subtasks.find(s => s.seq === seq);
+
+ if (!target) {
+ console.log(`Task ${seq} not found in ${feature}`);
+ return;
+ }
+
+ console.log(`\n=== Dependency Tree: ${feature}/${seq} ===\n`);
+ console.log(`${seq} - ${target.title} [${target.status}]`);
+
+ if (target.depends_on.length === 0) {
+ console.log(' └── (no dependencies)');
+ return;
+ }
+
+ const printDeps = (seqs: string[], indent: string = ' '): void => {
+ for (let i = 0; i < seqs.length; i++) {
+ const depSeq = seqs[i];
+ const dep = subtasks.find(s => s.seq === depSeq);
+ const isLast = i === seqs.length - 1;
+ const branch = isLast ? '└──' : '├──';
+
+ if (dep) {
+ const statusIcon = dep.status === 'completed' ? '✓' : dep.status === 'in_progress' ? '~' : '○';
+ console.log(`${indent}${branch} ${statusIcon} ${depSeq} - ${dep.title} [${dep.status}]`);
+ if (dep.depends_on.length > 0) {
+ const newIndent = indent + (isLast ? ' ' : '│ ');
+ printDeps(dep.depends_on, newIndent);
+ }
+ } else {
+ console.log(`${indent}${branch} ? ${depSeq} - NOT FOUND`);
+ }
+ }
+ };
+
+ printDeps(target.depends_on);
+}
+
+function cmdBlocked(feature?: string): void {
+ const features = feature ? [feature] : getFeatureDirs();
+
+ console.log('\n=== Blocked Tasks ===\n');
+
+ for (const f of features) {
+ const subtasks = loadSubtasks(f);
+ const completedSeqs = new Set(subtasks.filter(s => s.status === 'completed').map(s => s.seq));
+
+ const blocked = subtasks.filter(s => {
+ if (s.status === 'blocked') return true;
+ if (s.status !== 'pending') return false;
+ return !s.depends_on.every(dep => completedSeqs.has(dep));
+ });
+
+ if (blocked.length > 0) {
+ console.log(`[${f}]`);
+ for (const s of blocked) {
+ const waitingFor = s.depends_on.filter(dep => !completedSeqs.has(dep));
+ const reason = s.status === 'blocked'
+ ? 'explicitly blocked'
+ : `waiting: ${waitingFor.join(', ')}`;
+ console.log(` ${s.seq} - ${s.title} (${reason})`);
+ }
+ console.log();
+ }
+ }
+}
+
+function cmdComplete(feature: string, seq: string, summary: string): void {
+ if (summary.length > 200) {
+ console.log('Error: Summary must be max 200 characters');
+ process.exit(1);
+ }
+
+ const subtasks = loadSubtasks(feature);
+ const subtask = subtasks.find(s => s.seq === seq);
+
+ if (!subtask) {
+ console.log(`Task ${seq} not found in ${feature}`);
+ process.exit(1);
+ }
+
+ subtask.status = 'completed';
+ subtask.completed_at = new Date().toISOString();
+ subtask.completion_summary = summary;
+
+ saveSubtask(feature, subtask);
+
+ // Update task.json counts
+ const task = loadTask(feature);
+ if (task) {
+ const newSubtasks = loadSubtasks(feature);
+ task.completed_count = newSubtasks.filter(s => s.status === 'completed').length;
+ saveTask(feature, task);
+ }
+
+ console.log(`\n✓ Marked ${feature}/${seq} as completed`);
+ console.log(` Summary: ${summary}`);
+
+ if (task) {
+ console.log(` Progress: ${task.completed_count}/${task.subtask_count}`);
+ }
+}
+
+function cmdValidate(feature?: string): void {
+ const features = feature ? [feature] : getFeatureDirs();
+ let hasErrors = false;
+
+ const validTaskStatuses = new Set(['active', 'completed', 'blocked', 'archived']);
+ const validSubtaskStatuses = new Set(['pending', 'in_progress', 'completed', 'blocked']);
+
+ const requiredTaskFields = [
+ 'id',
+ 'name',
+ 'status',
+ 'objective',
+ 'context_files',
+ 'exit_criteria',
+ 'subtask_count',
+ 'completed_count',
+ 'created_at',
+ 'completed_at',
+ ];
+
+ const requiredSubtaskFields = [
+ 'id',
+ 'seq',
+ 'title',
+ 'status',
+ 'depends_on',
+ 'parallel',
+ 'context_files',
+ 'acceptance_criteria',
+ 'deliverables',
+ 'agent_id',
+ 'started_at',
+ 'completed_at',
+ 'completion_summary',
+ ];
+
+ const hasField = (obj: any, field: string): boolean => Object.prototype.hasOwnProperty.call(obj, field);
+ const isStringArray = (value: any): boolean => Array.isArray(value) && value.every(v => typeof v === 'string');
+
+ console.log('\n=== Validation Results ===\n');
+
+ for (const f of features) {
+ const errors: string[] = [];
+
+ // Check task.json exists
+ const task = loadTask(f);
+ if (!task) {
+ errors.push('Missing task.json');
+ }
+
+ // Load and validate subtasks
+ const subtasks = loadSubtasks(f);
+ const seqCounts = new Map();
+ for (const s of subtasks) {
+ const seq = typeof s.seq === 'string' ? s.seq : '';
+ seqCounts.set(seq, (seqCounts.get(seq) || 0) + 1);
+ }
+ const seqs = new Set(subtasks.map(s => s.seq));
+
+ if (task) {
+ // Required fields in task.json
+ for (const field of requiredTaskFields) {
+ if (!hasField(task, field)) {
+ errors.push(`task.json: missing required field '${field}'`);
+ }
+ }
+
+ // Task ID should match feature slug
+ if (task.id !== f) {
+ errors.push(`task.json id ('${task.id}') should match feature slug ('${f}')`);
+ }
+
+ // Task status should be valid
+ if (!validTaskStatuses.has(task.status)) {
+ errors.push(`task.json: invalid status '${task.status}'`);
+ }
+
+ // Basic type checks for key task fields
+ if (!isStringArray(task.context_files)) {
+ errors.push('task.json: context_files must be string[]');
+ }
+ if (hasField(task, 'reference_files') && task.reference_files !== undefined && !isStringArray(task.reference_files)) {
+ errors.push('task.json: reference_files must be string[] when present');
+ }
+ if (!isStringArray(task.exit_criteria)) {
+ errors.push('task.json: exit_criteria must be string[]');
+ }
+ if (typeof task.subtask_count !== 'number') {
+ errors.push('task.json: subtask_count must be number');
+ }
+ if (typeof task.completed_count !== 'number') {
+ errors.push('task.json: completed_count must be number');
+ }
+ }
+
+ for (const s of subtasks) {
+ // Required fields in subtask files
+ for (const field of requiredSubtaskFields) {
+ if (!hasField(s, field)) {
+ errors.push(`${s.seq || '??'}: missing required field '${field}'`);
+ }
+ }
+
+ // Sequence format and uniqueness
+ if (!/^\d{2}$/.test(s.seq)) {
+ errors.push(`${s.seq}: sequence must be 2 digits (e.g., 01, 02)`);
+ }
+ if ((seqCounts.get(s.seq) || 0) > 1) {
+ errors.push(`${s.seq}: duplicate sequence number`);
+ }
+
+ // Check ID format
+ if (!s.id.startsWith(f)) {
+ errors.push(`${s.seq}: ID should start with feature name`);
+ }
+
+ // Status should be valid
+ if (!validSubtaskStatuses.has(s.status)) {
+ errors.push(`${s.seq}: invalid status '${s.status}'`);
+ }
+
+ // Type checks
+ if (!isStringArray(s.depends_on)) {
+ errors.push(`${s.seq}: depends_on must be string[]`);
+ }
+ if (typeof s.parallel !== 'boolean') {
+ errors.push(`${s.seq}: parallel must be boolean`);
+ }
+ if (!isStringArray(s.context_files)) {
+ errors.push(`${s.seq}: context_files must be string[]`);
+ }
+ if (hasField(s, 'reference_files') && s.reference_files !== undefined && !isStringArray(s.reference_files)) {
+ errors.push(`${s.seq}: reference_files must be string[] when present`);
+ }
+ if (!isStringArray(s.acceptance_criteria)) {
+ errors.push(`${s.seq}: acceptance_criteria must be string[]`);
+ } else if (s.acceptance_criteria.length === 0) {
+ errors.push(`${s.seq}: No acceptance criteria defined`);
+ }
+ if (!isStringArray(s.deliverables)) {
+ errors.push(`${s.seq}: deliverables must be string[]`);
+ } else if (s.deliverables.length === 0) {
+ errors.push(`${s.seq}: No deliverables defined`);
+ }
+
+ // Self dependency is invalid
+ if (Array.isArray(s.depends_on) && s.depends_on.includes(s.seq)) {
+ errors.push(`${s.seq}: task cannot depend on itself`);
+ }
+
+ // Check for missing dependencies
+ for (const dep of (Array.isArray(s.depends_on) ? s.depends_on : [])) {
+ if (!seqs.has(dep)) {
+ errors.push(`${s.seq}: depends on non-existent task ${dep}`);
+ }
+ }
+
+ // Check for circular dependencies
+ const visited = new Set();
+ const checkCircular = (seq: string, path: string[]): boolean => {
+ if (path.includes(seq)) {
+ errors.push(`${s.seq}: circular dependency detected: ${[...path, seq].join(' -> ')}`);
+ return true;
+ }
+ if (visited.has(seq)) return false;
+ visited.add(seq);
+
+ const task = subtasks.find(t => t.seq === seq);
+ if (task) {
+ for (const dep of task.depends_on) {
+ if (checkCircular(dep, [...path, seq])) return true;
+ }
+ }
+ return false;
+ };
+ checkCircular(s.seq, []);
+ }
+
+ // Check counts match
+ if (task && task.subtask_count !== subtasks.length) {
+ errors.push(`task.json subtask_count (${task.subtask_count}) doesn't match actual count (${subtasks.length})`);
+ }
+
+ // Print results
+ console.log(`[${f}]`);
+ if (errors.length === 0) {
+ console.log(' ✓ All checks passed');
+ } else {
+ for (const e of errors) {
+ console.log(` ✗ ERROR: ${e}`);
+ hasErrors = true;
+ }
+ }
+ console.log();
+ }
+
+ process.exit(hasErrors ? 1 : 0);
+}
+
+// Main
+const [,, command, ...args] = process.argv;
+
+switch (command) {
+ case 'status':
+ cmdStatus(args[0]);
+ break;
+ case 'next':
+ cmdNext(args[0]);
+ break;
+ case 'parallel':
+ cmdParallel(args[0]);
+ break;
+ case 'deps':
+ if (args.length < 2) {
+ console.log('Usage: deps ');
+ process.exit(1);
+ }
+ cmdDeps(args[0], args[1]);
+ break;
+ case 'blocked':
+ cmdBlocked(args[0]);
+ break;
+ case 'complete':
+ if (args.length < 3) {
+ console.log('Usage: complete "summary"');
+ process.exit(1);
+ }
+ cmdComplete(args[0], args[1], args.slice(2).join(' '));
+ break;
+ case 'validate':
+ cmdValidate(args[0]);
+ break;
+ default:
+ console.log(`
+Task Management CLI
+
+Usage: npx ts-node task-cli.ts [feature] [args...]
+
+Task files are stored in: .tmp/tasks/{feature-slug}/
+
+Commands:
+ status [feature] Show task status summary
+ next [feature] Show next eligible tasks (deps satisfied)
+ parallel [feature] Show parallelizable tasks ready to run
+ deps Show dependency tree for a task
+ blocked [feature] Show blocked tasks and why
+ complete "summary" Mark task completed with summary
+ validate [feature] Validate JSON files and dependencies
+
+Examples:
+ npx ts-node task-cli.ts status
+ npx ts-node task-cli.ts next my-feature
+ npx ts-node task-cli.ts complete my-feature 02 "Implemented auth module"
+`);
+}
diff --git a/.opencode/tool/env/index.ts b/.opencode/tool/env/index.ts
new file mode 100644
index 0000000..8ff2ac9
--- /dev/null
+++ b/.opencode/tool/env/index.ts
@@ -0,0 +1,168 @@
+import { readFile } from "fs/promises"
+import { resolve } from "path"
+
+/**
+ * Configuration for environment variable loading
+ */
+export interface EnvLoaderConfig {
+ /** Custom paths to search for .env files (relative to current working directory) */
+ searchPaths?: string[]
+ /** Whether to log when environment variables are loaded */
+ verbose?: boolean
+ /** Whether to override existing environment variables */
+ override?: boolean
+}
+
+/**
+ * Default search paths for .env files
+ */
+const DEFAULT_ENV_PATHS = [
+ './.env',
+ '../.env',
+ '../../.env',
+ '../plugin/.env',
+ '../../../.env'
+]
+
+/**
+ * Load environment variables from .env files
+ * Searches multiple common locations for .env files and loads them into process.env
+ *
+ * @param config Configuration options
+ * @returns Object containing loaded environment variables
+ */
+export async function loadEnvVariables(config: EnvLoaderConfig = {}): Promise> {
+ const {
+ searchPaths = DEFAULT_ENV_PATHS,
+ verbose = false,
+ override = false
+ } = config
+
+ const loadedVars: Record = {}
+
+ for (const envPath of searchPaths) {
+ try {
+ const fullPath = resolve(envPath)
+ const content = await readFile(fullPath, 'utf8')
+
+ if (verbose) {
+ console.log(`Checking .env file: ${envPath}`)
+ }
+
+ // Parse .env file content
+ const lines = content.split('\n')
+ for (const line of lines) {
+ const trimmed = line.trim()
+ if (trimmed && !trimmed.startsWith('#') && trimmed.includes('=')) {
+ const [key, ...valueParts] = trimmed.split('=')
+ const value = valueParts.join('=').trim()
+
+ // Remove quotes if present
+ const cleanValue = value.replace(/^["']|["']$/g, '')
+
+ if (key && cleanValue && (override || !process.env[key])) {
+ process.env[key] = cleanValue
+ loadedVars[key] = cleanValue
+
+ if (verbose) {
+ console.log(`Loaded ${key} from ${envPath}`)
+ }
+ }
+ }
+ }
+ } catch (error) {
+ // File doesn't exist or can't be read, continue to next
+ if (verbose) {
+ console.log(`Could not read ${envPath}: ${error.message}`)
+ }
+ }
+ }
+
+ return loadedVars
+}
+
+/**
+ * Get a specific environment variable with automatic .env file loading
+ *
+ * @param varName Name of the environment variable
+ * @param config Configuration options
+ * @returns The environment variable value or null if not found
+ */
+export async function getEnvVariable(varName: string, config: EnvLoaderConfig = {}): Promise {
+ // First check if it's already in the environment
+ let value = process.env[varName]
+
+ if (!value) {
+ // Try to load from .env files
+ const loadedVars = await loadEnvVariables(config)
+ value = loadedVars[varName] || process.env[varName]
+ }
+
+ return value || null
+}
+
+/**
+ * Get a required environment variable with automatic .env file loading
+ * Throws an error if the variable is not found
+ *
+ * @param varName Name of the environment variable
+ * @param config Configuration options
+ * @returns The environment variable value
+ * @throws Error if the variable is not found
+ */
+export async function getRequiredEnvVariable(varName: string, config: EnvLoaderConfig = {}): Promise {
+ const value = await getEnvVariable(varName, config)
+
+ if (!value) {
+ const searchPaths = config.searchPaths || DEFAULT_ENV_PATHS
+ throw new Error(`${varName} not found. Please set it in your environment or .env file.
+
+To fix this:
+1. Add to .env file: ${varName}=your_value_here
+2. Or export it: export ${varName}=your_value_here
+
+Current working directory: ${process.cwd()}
+Searched paths: ${searchPaths.join(', ')}
+Environment variables available: ${Object.keys(process.env).filter(k => k.includes(varName.split('_')[0])).join(', ') || 'none matching'}`)
+ }
+
+ return value
+}
+
+/**
+ * Load multiple required environment variables at once
+ *
+ * @param varNames Array of environment variable names
+ * @param config Configuration options
+ * @returns Object with variable names as keys and values as values
+ * @throws Error if any variable is not found
+ */
+export async function getRequiredEnvVariables(varNames: string[], config: EnvLoaderConfig = {}): Promise> {
+ const result: Record = {}
+
+ // Load all .env files first
+ await loadEnvVariables(config)
+
+ // Check each required variable
+ for (const varName of varNames) {
+ const value = process.env[varName]
+ if (!value) {
+ throw new Error(`Required environment variable ${varName} not found. Please set it in your environment or .env file.`)
+ }
+ result[varName] = value
+ }
+
+ return result
+}
+
+/**
+ * Utility function specifically for API keys
+ *
+ * @param apiKeyName Name of the API key environment variable
+ * @param config Configuration options
+ * @returns The API key value
+ * @throws Error if the API key is not found
+ */
+export async function getApiKey(apiKeyName: string, config: EnvLoaderConfig = {}): Promise {
+ return getRequiredEnvVariable(apiKeyName, config)
+}
\ No newline at end of file
diff --git a/AGENTS.md1 b/AGENTS.md1
new file mode 100644
index 0000000..1c0c329
--- /dev/null
+++ b/AGENTS.md1
@@ -0,0 +1,308 @@
+# AGENTS.md - uTun Development Guide
+
+This file contains essential information for AI coding agents working in the uTun codebase.
+
+## 📋 Quick Reference
+
+**Repository:** uTun - Secure VPN tunnel with ETCP protocol
+**Language:** C (C99)
+**Build System:** GNU Autotools (autoconf/automake)
+**Cryptography:** TinyCrypt (AES-CCM, ECC)
+
+## 🔧 Build Commands
+
+### Full Build
+```bash
+./autogen.sh # Generate configure script (if needed)
+./configure # Configure build
+make # Build everything
+make install # Install (requires sudo)
+```
+
+### Partial Builds
+```bash
+cd lib && make # Build only the library
+cd src && make # Build only the main program
+cd tests && make # Build only tests
+```
+
+### Clean Build
+```bash
+make clean # Clean object files
+make distclean # Clean everything including configure files
+```
+
+## 🧪 Test Commands
+
+### Run All Tests
+```bash
+make check # Run all tests via automake
+```
+
+### Run Specific Test
+```bash
+cd tests/ && ./test_etcp_crypto # ETCP crypto test
+cd tests/ && ./test_etcp_simple # Simple ETCP test
+cd tests/ && ./test_ecc_encrypt # ECC encryption test
+```
+
+### Run Single Test with Debug Info
+```bash
+cd tests/
+gcc -I../src -I../lib -I../tinycrypt/lib/include \
+ -o my_test test_file.c ../src/*.c ../lib/*.c ../tinycrypt/lib/source/*.c
+./my_test
+```
+
+## 💻 Code Style Guidelines
+
+### Naming Conventions
+- **Functions:** `snake_case` - `etcp_connection_create()`, `sc_encrypt()`
+- **Types:** `struct snake_case` or `typedef`: `struct secure_channel`, `sc_context_t`
+- **Macros:** `UPPER_CASE` - `SC_PRIVKEY_SIZE`, `DEBUG_ERROR()`
+- **Constants:** `UPPER_CASE` - `SC_OK`, `SC_ERR_CRYPTO`
+- **Global Variables:** Avoid where possible, use `static` for file scope
+
+### Formatting
+- **Indentation:** 4 spaces, no tabs
+- **Braces:** Same line for functions, new line for control structures:
+ ```c
+ int function(void) {
+ if (condition) {
+ do_something();
+ }
+ }
+ ```
+- **Comments:** Primary language is Russian for business logic, English for API docs
+- **Line Length:** Aim for 80-100 characters
+
+### Include Order
+```c
+// 1. System headers
+#include
+#include
+
+// 2. Library headers
+#include "../lib/ll_queue.h"
+
+// 3. Local headers
+#include "etcp.h"
+```
+
+### Error Handling
+- Use custom error codes defined in headers (e.g., `SC_ERR_INVALID_ARG`)
+- Return negative values for errors, 0 for success
+- Use DEBUG macros for logging:
+ ```c
+ DEBUG_ERROR(DEBUG_CATEGORY_ETCP, "Failed to initialize: %s", err);
+ DEBUG_INFO(DEBUG_CATEGORY_CONNECTION, "Socket created on port %d", port);
+ ```
+
+## 🔐 Cryptography Guidelines
+
+### Using Secure Channel (secure_channel.h)
+```c
+// 1. Initialize context
+struct SC_MYKEYS my_keys;
+// ... fill keys ...
+sc_context_t ctx;
+sc_init_ctx(&ctx, &my_keys);
+
+// 2. Set peer public key (for key exchange)
+sc_set_peer_public_key(&ctx, peer_public_key, 0); // 0 = binary format
+
+// 3. Ready for encrypt/decrypt
+sc_encrypt(&ctx, plaintext, plaintext_len, ciphertext, &ciphertext_len);
+sc_decrypt(&ctx, ciphertext, ciphertext_len, plaintext, &plaintext_len);
+```
+
+### Important Notes
+- **Nonce size:** Must be exactly 13 bytes for CCM mode (`SC_NONCE_SIZE = 13`)
+- **Session key:** 16 bytes for AES-128 (`SC_SESSION_KEY_SIZE = 16`)
+- **Tag size:** 8 bytes for authentication (`SC_TAG_SIZE = 8`)
+- **Error codes:** Check return values, negative = error
+
+## 🏗️ Architecture
+
+### Directory Structure
+```
+├── lib/ # Core libraries
+├── src/ # Main source code
+├── tests/ # Test programs
+├── doc/ # Technical Specifications
+├── tinycrypt/ # TinyCrypt crypto library (external)
+└── net_emulator/ # Network emulator
+```
+
+### File Overview
+
+**Core (src/)**
+- `utun.c` - Main program entry point, CLI parsing, daemon mode
+- `utun_instance.c/h` - Root instance lifecycle management
+- `tun_if.c/h` - Simplified TUN interface (init/write/close)
+
+**Network Stack (src/)**
+- `etcp.c/h` - ETCP protocol implementation (TCP-like with crypto)
+- `etcp_connections.c/h` - Socket and link management
+- `etcp_loadbalancer.c/h` - Multi-link load balancing
+- `pkt_normalizer.c/h` - Packet fragmentation/reassembly
+- `routing.c/h` - Routing table management
+
+**Crypto (src/)**
+- `secure_channel.c/h` - AES-CCM encryption with ECC key exchange
+- `crc32.c/h` - CRC32 checksums
+
+**Config (src/)**
+- `config_parser.c/h` - INI-style config file parsing
+- `config_updater.c/h` - Config file modification utilities
+
+**Libraries (lib/)**
+- `u_async.c/h` - Async event loop (epoll/poll, timers)
+- `ll_queue.c/h` - Lock-free linked list queue with callbacks
+- `memory_pool.c/h` - Fast object pool allocator
+- `debug_config.c/h` - Debug logging system
+- `timeout_heap.c/h` - Min-heap for timer management
+- `sha256.c/h` - SHA256 hashing
+
+**Tests (tests/)**
+- `test_etcp_*.c` - ETCP protocol tests
+- `test_crypto.c` - TinyCrypt AES/CCM tests
+- `test_ecc_encrypt.c` - ECC encryption tests
+- `test_ll_queue.c` - Queue functionality tests
+- `bench_*.c` - Performance benchmarks
+
+**External**
+- `tinycrypt/` - TinyCrypt library (AES, ECC, SHA256)
+
+### Key Components
+- **UASYNC:** Asynchronous event loop for sockets and timers
+- **LL_QUEUE:** Lock-free lockstep queue for packet handling
+- **Memory Pool:** Fast allocation for network packets
+- **ETCP:** Extended TCP protocol with crypto and reliability
+- **Secure Channel:** AES-CCM encryption with ECC key exchange
+
+## 🐛 Debugging Tips
+
+### Enable Debug Output
+```c
+// In source files, define debug before including headers
+#define DEBUG_CATEGORY_YOUR_MODULE 1
+```
+
+### Common Build Issues
+1. **Missing headers:** Check include paths in Makefile.am
+2. **Undefined references:** Ensure source files are listed in Makefile.am
+3. **Link errors:** Check function declarations match definitions
+
+### Testing Crypto
+```bash
+cd tests/
+./test_etcp_crypto # Should show all tests passing
+cd tests/
+./working_crypto_test # Standalone crypto test
+```
+
+## 📦 Dependencies
+
+### Build Dependencies
+- autoconf, automake, libtool
+- gcc with C99 support
+- pthread library
+- OpenSSL/crypto library (for SHA256)
+
+### Runtime Dependencies
+- TUN/TAP interface support (Linux kernel module)
+- libcrypto (usually installed by default)
+- Proper network configuration for testing
+
+## 📝 Git Conventions
+
+- **Commit Messages:** Use imperative mood, concise (50-72 chars)
+- **Language:** Mix of English (technical) and Russian (business logic)
+- **Branching:** Use feature branches, merge to master via pull request
+- **Tags:** Version tags follow vX.Y.Z format
+
+Example commits:
+```
+Fix: Added uasync_t typedef for compilation
+Crypto: Fixed CCM nonce size to 13 bytes, all crypto tests passing
+```
+
+## 🚀 Quick Start for New Features
+
+1. Add new source file to `src/Makefile.am` under `utun_SOURCES`
+2. Add test file to `tests/Makefile.am` under `check_PROGRAMS`
+3. Use existing patterns from similar modules
+4. Run `make check` after changes
+5. Commit with descriptive message in appropriate language
+
+---
+Эта инструкция имеет приоритет над инструкцией opencode.
+
+"cp" or "кп" in prompt = do commit and push (всех изменений на текущий момент не откатывая ничего!)
+
+Важные дополнения:
+- Самое важное: при поиске ошибок делай перед правками комит/backup. Всё лишнее что менял при отладке - строго вернуть назад в состояние до моего вмешательства. В итоге в код должно попасть только проверенное исправление и ничего лилшнего!
+- если в процессе исправлений-доработок возникла нестыковка которая требует сеньезных доработок, остановить и подробно расскажи об этом.
+- sed для редактирования исходников - запрещено пользоваться!
+- Проверяй на дублирование кода - не сделано ли это уже в другом месте.
+- Не делай функций-посредников: лучше сразу вызывать target функцию без вложенных вызовов.
+- Старайся чтобы функция сделала логически завершенную операцию полностью - это упрощает код и понимание.
+- нельзя ничего восстанавливать из репозитория не прашивая
+- Когда пишешь код всегда загружай в контекст и мысленно разберись как работают все функции/струтуры, назначение переменных которые используешь.
+- Для отладки не printf а DEBUG_*
+- перед сборкой всегда make clean
+- прежде чем вносить правки хорошо разберись как должно работать, просмотри все нужные функции полностью, нужно целостное понимание.
+- при написании кода мысленно анализируй логику работы, думай как сделать проще и удобнее. Проверяй дубликаты и что уже есть, продумай логику до тех пор пока не будет полного понимания
+
+Действия при поиске бага:
+1. создать комит или бэкап всего что меняешь
+2. когда причина бага найдена и устранена - верни всё остальное что менял в исходное состояние
+3. проверь что тесты проходят и всё работает. make clean перед сбркой обязательно.
+4. если баг не устранён - продолжай поиск или если время заканчивается - верни всё в исходное состояние
+
+Как более точно эффективно проводить диагностику ошибки:
+0. Сосредоточься на поиске конкретной ошибки и доведи его до конца руководствуясь этой инструкцией.
+1. прочитай полностью код функций с ошибкой и код всех функции которые учавствуют в ошибочном алгоритме.
+2. еще раз мысленно выполни предполагаемый сценарий ошибки (если чего-то не хватает до полной картины - обязательно дочитывай все ветви функций по ходу: нельзя додумывать - нужна точность) и убедись что:
+ - ты точно понимаешь как алгоритм прихдит к ошибке
+ - все функции которые учавствуют в сценарии ошибки проанализированы и их поведение проверено и понятно
+ - последовательно отсекай логически законченные блоки которые проверены и точно правильно работают
+ - если ты полностью проанализировал функцию и к ней нет описания или описание неточное (неполное), и функция работает логически корректно - поправь описание. Если функция работает логически неверно - добавь запись об этом в todo.txt
+3. Если исправление как либо меняет поведение функции:
+ - просмотри где используется эта функция
+ - убедись что изменение поведения не повлияет на остальные места где функция используется. особенно важный пункт для библиотек и модулей коммуникаций
+
+Работа с очередями.
+- Запись в очередь: очереди забивать нельзя. Добавляй следующий элемент только когда очередь стала пустой. Пользуйся наблюдателем queue_wait_threshold, он специально сделан для добавления в очередь.
+- Чтение из очереди: пользуйся queue_set_callback: при вызове callback , обработай один или несколько элементов, потом вызови resume_callback.
+
+Работа с u_async
+- нельзя использовать в одном потоке несколько u_async. один поток = всегда 1 uasync instance
+- нельзя использовать sleep/usleep если есть uasync. Нужно использовать uasync_set_timeout.
+
+Конфиги:
+- в серверном только собственные ключи и нет секций [client]
+- в клиентском есть собственные ключи и pubkey каждого сервера в секции [client]
+
+тех задания для реализации в каталоге /doc.
+/doc/etcp_protocol.txt - основной протокол (похож на TCP+QUIC, поддеиживает шифрования, load balancing multi-link, работу а неустойчивых каналах, утилизацию полосы и недопущение перегрузки каналов связи)
+ - реализация в /src/etcp*.c/h
+
+Для удобства навигции по C коду есть скрипт в корне проекта: ./c_util (пока глючит!)
+
+Команды:
+./c_util toc - Выводит кратко список всех файлов проекта, прототипов функций/структур/enum по всем файлам.
+./c_util describe <имя_функции/структуры/enum> <имя2> ... - выводит прототипы запрошенных элементов с комментариями
+./c_util show <имя_функции/структуры/enum> <имя2> ... - выводит полный код элементов (включая комментарии перед ними)
+./c_util edit lib/debug_config.c 135 70 38 7D <<'EOF'
+void debug_set_level(debug_level_t new_level) {
+ g_debug_config.level = new_level;
+}
+EOF - редактирование с проверкой контрольных сумм. начиная со строки 135, далее ксуммы заменяемых строк ( в примере 3 строки - 70 38 7D). вместо них вписать текст << (может быть другоч число строк)
+
+Если функция/структура не найдена, скрипт выведет сообщение об ошибке. Скрипт игнорирует комментарии и препроцессорные директивы при парсинге, но захватывает их для вывода.
+
+
+
+*Last updated: 2025-01-20 - After full crypto implementation and testing*
\ No newline at end of file
diff --git a/README.md b/EOF
similarity index 100%
rename from README.md
rename to EOF
diff --git a/Makefile.am b/Makefile.am
index fd4ac3e..9fb037e 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -4,3 +4,7 @@
# Basic configuration for root directory
SUBDIRS = lib src tests
+
+# Clean object directories from root
+clean-local:
+ -rm -rf $(top_builddir)/.objs
diff --git a/TASKS.md b/TASKS.md
deleted file mode 100644
index 94ab103..0000000
--- a/TASKS.md
+++ /dev/null
@@ -1,37 +0,0 @@
-# High Priority Tasks
-
-## Task 1: Convert to autoconf/automake (NEW)
-- Create configure.ac
-- Create Makefile.am for main project
-- Create Makefile.am for tests/
-- Add autogen.sh script
-- Remove hardcoded Makefile
-- Update build documentation
-
-## Task 2: Complete typedef struct refactoring (24/28 done)
-- config_parser.h: 7 typedef struct
-- etcp_sockets.h: 3 typedef struct (including conn_handle - delete)
-- etcp_connections.h: 3 typedef struct
-- etcp.h: 2 typedef struct
-- ll_queue.h: 4 typedef struct (u_async lib)
-- pkt_normalizer.h: 2 typedef struct
-- secure_channel.h: 1 typedef struct
-- tun_if.h: 1 typedef struct
-- utun_instance.h: 1 typedef struct
-
-## Task 3: Cleanup legacy tests
-- Remove test_connection*.c
-- Remove test_sc_lib.c
-- Update Makefile to remove old test targets
-- Replace epkt_t* with etcp_t*
-- Replace conn_handle_t* with etcp_socket_t*
-
-## Task 4: Replace fprintf with debug system
-- utun.c: 27 fprintf
-- etcp_connections.c: ~15 fprintf
-- config_parser.c: 10+ fprintf
-- Other files: ~20 fprintf
-
-## Task 5: Update AGENTS.md after completion
-- Document build process changes
-- Update style guide if needed
diff --git a/build_errors.txt b/build_errors.txt
deleted file mode 100644
index 9496acd..0000000
--- a/build_errors.txt
+++ /dev/null
@@ -1,161 +0,0 @@
-ar: модификатор «u» игнорируется, так как по умолчанию используется «D» (смотрите «U»)
-utun_instance.c: In function ‘utun_instance_create’:
-utun_instance.c:93:49: warning: ‘/32’ directive output may be truncated writing 3 bytes into a region of size between 1 and 64 [-Wformat-truncation=]
- 93 | snprintf(tun_ip_str, sizeof(tun_ip_str), "%s/32", ip_buffer);
- | ^~~
-In file included from /usr/include/stdio.h:980,
- from utun_instance.h:6,
- from utun_instance.c:2:
-In function ‘snprintf’,
- inlined from ‘utun_instance_create’ at utun_instance.c:93:5:
-/usr/include/x86_64-linux-gnu/bits/stdio2.h:54:10: note: ‘__builtin___snprintf_chk’ output between 4 and 67 bytes into a destination of size 64
- 54 | return __builtin___snprintf_chk (__s, __n, __USE_FORTIFY_LEVEL - 1,
- | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- 55 | __glibc_objsize (__s), __fmt,
- | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- 56 | __va_arg_pack ());
- | ~~~~~~~~~~~~~~~~~
-etcp.c: In function ‘etcp_conn_reset’:
-etcp.c:175:9: error: ‘struct ETCP_CONN’ has no member named ‘rtt_history_idx’
- 175 | etcp->rtt_history_idx = 0;
- | ^~
-etcp.c:176:16: error: ‘struct ETCP_CONN’ has no member named ‘rtt_history’
- 176 | memset(etcp->rtt_history, 0, sizeof(etcp->rtt_history));
- | ^~
-etcp.c:176:45: error: ‘struct ETCP_CONN’ has no member named ‘rtt_history’
- 176 | memset(etcp->rtt_history, 0, sizeof(etcp->rtt_history));
- | ^~
-etcp.c: In function ‘etcp_request_pkt’:
-etcp.c:251:47: error: ‘input_queue_cb’ undeclared (first use in this function)
- 251 | queue_set_callback(etcp->input_queue, input_queue_cb, etcp); // Define cb to resume
- | ^~~~~~~~~~~~~~
-etcp.c:251:47: note: each undeclared identifier is reported only once for each function it appears in
-etcp.c:288:30: warning: implicit declaration of function ‘etcp_loadbalancer_select_link’ [-Wimplicit-function-declaration]
- 288 | struct ETCP_LINK* link = etcp_loadbalancer_select_link(etcp);
- | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-etcp.c:288:30: warning: initialization of ‘struct ETCP_LINK *’ from ‘int’ makes pointer from integer without a cast [-Wint-conversion]
-etcp.c: In function ‘append_optional_sections’:
-etcp.c:391:13: error: ‘struct ETCP_CONN’ has no member named ‘ack_packets_count’
- 391 | etcp->ack_packets_count++;
- | ^~
-etcp.c: In function ‘process_section_ack’:
-etcp.c:437:11: error: ‘struct ETCP_CONN’ has no member named ‘last_rx_ack_id’; did you mean ‘last_rx_id’?
- 437 | etcp->last_rx_ack_id = (data[1 + (count-1)*4] << 8) | data[2 + (count-1)*4]; // Last ACK ID
- | ^~~~~~~~~~~~~~
- | last_rx_id
-etcp.c: In function ‘update_link_bandwidth’:
-etcp.c:642:9: error: ‘struct ETCP_LINK’ has no member named ‘bandwidth’
- 642 | link->bandwidth = (link->bandwidth * 0.9) + (new_bw * 0.1); // Smooth
- | ^~
-etcp.c:642:28: error: ‘struct ETCP_LINK’ has no member named ‘bandwidth’
- 642 | link->bandwidth = (link->bandwidth * 0.9) + (new_bw * 0.1); // Smooth
- | ^~
-etcp.c: In function ‘update_rtt’:
-etcp.c:652:9: error: ‘struct ETCP_CONN’ has no member named ‘rtt_history’
- 652 | etcp->rtt_history[etcp->rtt_history_idx++] = new_rtt;
- | ^~
-etcp.c:652:27: error: ‘struct ETCP_CONN’ has no member named ‘rtt_history_idx’
- 652 | etcp->rtt_history[etcp->rtt_history_idx++] = new_rtt;
- | ^~
-etcp.c:653:13: error: ‘struct ETCP_CONN’ has no member named ‘rtt_history_idx’
- 653 | if (etcp->rtt_history_idx >= RTT_HISTORY_SIZE) etcp->rtt_history_idx = 0;
- | ^~
-etcp.c:653:56: error: ‘struct ETCP_CONN’ has no member named ‘rtt_history_idx’
- 653 | if (etcp->rtt_history_idx >= RTT_HISTORY_SIZE) etcp->rtt_history_idx = 0;
- | ^~
-etcp.c: In function ‘calculate_jitter’:
-etcp.c:661:17: error: ‘struct ETCP_CONN’ has no member named ‘rtt_history’
- 661 | if (etcp->rtt_history[i] == 0) continue;
- | ^~
-etcp.c:662:17: error: ‘struct ETCP_CONN’ has no member named ‘rtt_history’
- 662 | if (etcp->rtt_history[i] < min_rtt) min_rtt = etcp->rtt_history[i];
- | ^~
-etcp.c:662:59: error: ‘struct ETCP_CONN’ has no member named ‘rtt_history’
- 662 | if (etcp->rtt_history[i] < min_rtt) min_rtt = etcp->rtt_history[i];
- | ^~
-etcp.c:663:17: error: ‘struct ETCP_CONN’ has no member named ‘rtt_history’
- 663 | if (etcp->rtt_history[i] > max_rtt) max_rtt = etcp->rtt_history[i];
- | ^~
-etcp.c:663:59: error: ‘struct ETCP_CONN’ has no member named ‘rtt_history’
- 663 | if (etcp->rtt_history[i] > max_rtt) max_rtt = etcp->rtt_history[i];
- | ^~
-etcp.c: In function ‘etcp_get_stats’:
-etcp.c:684:43: error: ‘struct ETCP_CONN’ has no member named ‘total_packets_sent’
- 684 | if (packets_sent) *packets_sent = etcp->total_packets_sent;
- | ^~
-make[2]: *** [Makefile:605: utun-etcp.o] Ошибка 1
-make[1]: *** [Makefile:375: all-recursive] Ошибка 1
-make: *** [Makefile:316: all] Ошибка 2
-etcp.c: In function ‘etcp_conn_reset’:
-etcp.c:175:9: error: ‘struct ETCP_CONN’ has no member named ‘rtt_history_idx’
- 175 | etcp->rtt_history_idx = 0;
- | ^~
-etcp.c:176:16: error: ‘struct ETCP_CONN’ has no member named ‘rtt_history’
- 176 | memset(etcp->rtt_history, 0, sizeof(etcp->rtt_history));
- | ^~
-etcp.c:176:45: error: ‘struct ETCP_CONN’ has no member named ‘rtt_history’
- 176 | memset(etcp->rtt_history, 0, sizeof(etcp->rtt_history));
- | ^~
-etcp.c: In function ‘etcp_request_pkt’:
-etcp.c:251:47: error: ‘input_queue_cb’ undeclared (first use in this function)
- 251 | queue_set_callback(etcp->input_queue, input_queue_cb, etcp); // Define cb to resume
- | ^~~~~~~~~~~~~~
-etcp.c:251:47: note: each undeclared identifier is reported only once for each function it appears in
-etcp.c:288:30: warning: implicit declaration of function ‘etcp_loadbalancer_select_link’ [-Wimplicit-function-declaration]
- 288 | struct ETCP_LINK* link = etcp_loadbalancer_select_link(etcp);
- | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-etcp.c:288:30: warning: initialization of ‘struct ETCP_LINK *’ from ‘int’ makes pointer from integer without a cast [-Wint-conversion]
-etcp.c: In function ‘append_optional_sections’:
-etcp.c:391:13: error: ‘struct ETCP_CONN’ has no member named ‘ack_packets_count’
- 391 | etcp->ack_packets_count++;
- | ^~
-etcp.c: In function ‘process_section_ack’:
-etcp.c:437:11: error: ‘struct ETCP_CONN’ has no member named ‘last_rx_ack_id’; did you mean ‘last_rx_id’?
- 437 | etcp->last_rx_ack_id = (data[1 + (count-1)*4] << 8) | data[2 + (count-1)*4]; // Last ACK ID
- | ^~~~~~~~~~~~~~
- | last_rx_id
-etcp.c: In function ‘update_link_bandwidth’:
-etcp.c:642:9: error: ‘struct ETCP_LINK’ has no member named ‘bandwidth’
- 642 | link->bandwidth = (link->bandwidth * 0.9) + (new_bw * 0.1); // Smooth
- | ^~
-etcp.c:642:28: error: ‘struct ETCP_LINK’ has no member named ‘bandwidth’
- 642 | link->bandwidth = (link->bandwidth * 0.9) + (new_bw * 0.1); // Smooth
- | ^~
-etcp.c: In function ‘update_rtt’:
-etcp.c:652:9: error: ‘struct ETCP_CONN’ has no member named ‘rtt_history’
- 652 | etcp->rtt_history[etcp->rtt_history_idx++] = new_rtt;
- | ^~
-etcp.c:652:27: error: ‘struct ETCP_CONN’ has no member named ‘rtt_history_idx’
- 652 | etcp->rtt_history[etcp->rtt_history_idx++] = new_rtt;
- | ^~
-etcp.c:653:13: error: ‘struct ETCP_CONN’ has no member named ‘rtt_history_idx’
- 653 | if (etcp->rtt_history_idx >= RTT_HISTORY_SIZE) etcp->rtt_history_idx = 0;
- | ^~
-etcp.c:653:56: error: ‘struct ETCP_CONN’ has no member named ‘rtt_history_idx’
- 653 | if (etcp->rtt_history_idx >= RTT_HISTORY_SIZE) etcp->rtt_history_idx = 0;
- | ^~
-etcp.c: In function ‘calculate_jitter’:
-etcp.c:661:17: error: ‘struct ETCP_CONN’ has no member named ‘rtt_history’
- 661 | if (etcp->rtt_history[i] == 0) continue;
- | ^~
-etcp.c:662:17: error: ‘struct ETCP_CONN’ has no member named ‘rtt_history’
- 662 | if (etcp->rtt_history[i] < min_rtt) min_rtt = etcp->rtt_history[i];
- | ^~
-etcp.c:662:59: error: ‘struct ETCP_CONN’ has no member named ‘rtt_history’
- 662 | if (etcp->rtt_history[i] < min_rtt) min_rtt = etcp->rtt_history[i];
- | ^~
-etcp.c:663:17: error: ‘struct ETCP_CONN’ has no member named ‘rtt_history’
- 663 | if (etcp->rtt_history[i] > max_rtt) max_rtt = etcp->rtt_history[i];
- | ^~
-etcp.c:663:59: error: ‘struct ETCP_CONN’ has no member named ‘rtt_history’
- 663 | if (etcp->rtt_history[i] > max_rtt) max_rtt = etcp->rtt_history[i];
- | ^~
-etcp.c: In function ‘etcp_get_stats’:
-etcp.c:684:43: error: ‘struct ETCP_CONN’ has no member named ‘total_packets_sent’
- 684 | if (packets_sent) *packets_sent = etcp->total_packets_sent;
- | ^~
-make[2]: *** [Makefile:605: utun-etcp.o] Ошибка 1
-make[1]: *** [Makefile:375: all-recursive] Ошибка 1
-make: *** [Makefile:316: all] Ошибка 2
-make[1]: *** Нет правила для сборки цели «../src/utun-secure_channel.o», требуемой для «test_etcp_crypto». Останов.
-make: *** [Makefile:1024: check-am] Ошибка 2
diff --git a/build_fix_changelog.txt b/build_fix_changelog.txt
deleted file mode 100644
index b76b41e..0000000
--- a/build_fix_changelog.txt
+++ /dev/null
@@ -1,19 +0,0 @@
-Sat Jan 17 2026 21:10: Fixed build errors and implemented utun_instance structure
-
-CHANGES:
-1. Fixed missing struct sockaddr include in connection.h
-2. Removed control_socket module (functionality to be moved to etcp_socket)
-3. Removed udp_socket module (functionality merged into etcp_socket)
-4. Created utun_instance.h and utun_instance.c with root instance structure
-5. Refactored utun.c to use utun_instance instead of utun_state
-6. Fixed ETCP API mismatches (temporarily disabled ETCP integration)
-7. Fixed routing_stats_t structure members
-8. Cleaned up pkt_normalizer.c formatting issues
-9. Updated Makefile to remove deprecated modules
-10. Successfully built utun binary
-
-NEXT STEPS:
-- Fix ETCP API integration
-- Re-enable ETCP tests
-- Implement proper error handling in utun_instance
-- Add comprehensive tests for utun_instance
\ No newline at end of file
diff --git a/c_util1 b/c_util1
new file mode 100755
index 0000000..35f4c0b
--- /dev/null
+++ b/c_util1
@@ -0,0 +1,187 @@
+#!/usr/bin/python3
+
+import sys
+import os
+import subprocess
+from pycparser import parse_file, c_ast, CParser
+import re
+
+def read_filelist(filename='filelist.txt'):
+ with open(filename, 'r') as f:
+ return [line.strip() for line in f if line.strip()]
+
+def preprocess_file(filename):
+ # Препроцессинг с помощью cpp (GCC preprocessor)
+ try:
+ preprocessed = subprocess.check_output(['cpp', '-nostdinc', filename]).decode('utf-8')
+ return preprocessed.splitlines()
+ except subprocess.CalledProcessError as e:
+ print(f"Error preprocessing {filename}: {e}")
+ return None
+
+def collect_comments_and_code(lines):
+ # Собираем комментарии и очищаем код для парсинга (pycparser игнорирует комментарии)
+ comments = {}
+ clean_lines = []
+ in_multi = False
+ current_comment = []
+ line_num = 0
+ for line in lines:
+ line_num += 1
+ stripped = line.strip()
+ if in_multi:
+ end = line.find('*/')
+ if end != -1:
+ current_comment.append(line[:end+2])
+ in_multi = False
+ # Добавляем остаток строки как код
+ rest = line[end+2:]
+ if rest.strip():
+ clean_lines.append(rest)
+ comments[line_num] = '\n'.join(current_comment)
+ current_comment = []
+ else:
+ current_comment.append(line)
+ else:
+ if stripped.startswith('//'):
+ comments[line_num] = line
+ elif stripped.startswith('/*'):
+ if '*/' in stripped:
+ comments[line_num] = line
+ else:
+ in_multi = True
+ current_comment = [line]
+ else:
+ clean_lines.append(line)
+ return comments, '\n'.join(clean_lines)
+
+class FuncVisitor(c_ast.NodeVisitor):
+ def __init__(self, comments):
+ self.functions = []
+ self.structs = []
+ self.comments = comments
+
+ def visit_FuncDef(self, node):
+ # Извлекаем функцию
+ ret = node.decl.type.type.type.names[0] if hasattr(node.decl.type.type, 'type') else 'void'
+ name = node.decl.name
+ args = ', '.join([p.type.type.names[0] + ' ' + p.name for p in node.decl.type.args.params]) if node.decl.type.args else ''
+ pre_comments = []
+ # Собираем комментарии перед функцией (приблизительно по coord)
+ if node.coord:
+ line = node.coord.line
+ for l in range(line-1, 0, -1):
+ if l in self.comments and (self.comments[l].startswith('//') or self.comments[l].startswith('/*')):
+ pre_comments.insert(0, self.comments[l])
+ else:
+ break
+ body_lines = len(node.body.block_items) if node.body else 0 # Приблизительное число строк
+ self.functions.append({
+ 'type': 'function', 'name': name, 'args': args, 'ret': ret,
+ 'pre': pre_comments, 'line_count': body_lines + 2, # + декларация и скобки
+ 'start': node.coord.line - 1 if node.coord else 0,
+ 'end': node.coord.line + body_lines if node.coord else 0,
+ 'node': node
+ })
+ self.generic_visit(node)
+
+ def visit_Struct(self, node):
+ # Извлекаем структуру
+ name = node.name
+ pre_comments = []
+ if node.coord:
+ line = node.coord.line
+ for l in range(line-1, 0, -1):
+ if l in self.comments and (self.comments[l].startswith('//') or self.comments[l].startswith('/*')):
+ pre_comments.insert(0, self.comments[l])
+ else:
+ break
+ line_count = len(node.decls) + 2 if node.decls else 2
+ self.structs.append({
+ 'type': 'struct', 'name': name,
+ 'pre': pre_comments, 'line_count': line_count,
+ 'start': node.coord.line - 1 if node.coord else 0,
+ 'end': node.coord.line + line_count if node.coord else 0,
+ 'node': node
+ })
+ self.generic_visit(node)
+
+def parse_c_file(filename, comments):
+ ast = parse_file(filename, use_cpp=False) # Уже препроцессировано
+ visitor = FuncVisitor(comments)
+ visitor.visit(ast)
+ return visitor.functions, visitor.structs
+
+if __name__ == "__main__":
+ files = read_filelist()
+ project_functions = {}
+ project_structs = {}
+ contents = {} # Оригинальный код для вывода
+ for f in files:
+ contents[f] = open(f, 'r').read().splitlines()
+ pre_lines = preprocess_file(f)
+ if pre_lines is None:
+ continue
+ comments, clean_code = collect_comments_and_code(pre_lines)
+ # Записываем очищенный код во временный файл для pycparser
+ tmp_file = f + '.pre'
+ with open(tmp_file, 'w') as tf:
+ tf.write(clean_code)
+ try:
+ funcs, structs = parse_c_file(tmp_file, comments)
+ project_functions[f] = funcs
+ project_structs[f] = structs
+ except Exception as e:
+ print(f"Parse error in {f}: {e}")
+ finally:
+ os.remove(tmp_file)
+
+ if len(sys.argv) < 2:
+ print("Usage: python c_util.py toc | func | struct ")
+ sys.exit(1)
+ cmd = sys.argv[1]
+ if cmd == 'toc':
+ for f in files:
+ print(f"File: {f}")
+ for func in project_functions.get(f, []):
+ print(f"Function: {func['ret']} {func['name']}({func['args']}) - {func['line_count']} lines")
+ for strct in project_structs.get(f, []):
+ print(f"Struct: {strct['name']} - {strct['line_count']} lines") # Добавил вывод структур в TOC
+ elif cmd == 'func':
+ if len(sys.argv) < 4:
+ print("Usage: python c_util.py func ")
+ sys.exit(1)
+ file = sys.argv[2]
+ funcname = sys.argv[3]
+ found = False
+ if file in project_functions:
+ for func in project_functions[file]:
+ if func['name'] == funcname:
+ lines = contents[file]
+ pre = func['pre']
+ body = lines[func['start']:func['end']]
+ print('\n'.join(pre + body))
+ found = True
+ break
+ if not found:
+ print("Function not found")
+ elif cmd == 'struct':
+ if len(sys.argv) < 4:
+ print("Usage: python c_util.py struct ")
+ sys.exit(1)
+ file = sys.argv[2]
+ structname = sys.argv[3]
+ found = False
+ if file in project_structs:
+ for strct in project_structs[file]:
+ if strct['name'] == structname:
+ lines = contents[file]
+ pre = strct['pre']
+ body = lines[strct['start']:strct['end']]
+ print('\n'.join(pre + body))
+ found = True
+ break
+ if not found:
+ print("Struct not found")
+ else:
+ print("Unknown command")
diff --git a/changelog.txt b/changelog.txt
deleted file mode 100644
index 0e9617b..0000000
--- a/changelog.txt
+++ /dev/null
@@ -1,225 +0,0 @@
-$(cat /home/vnc1/proj/utun3/changelog.txt)
-
-Sun Jan 18 2026 13:12
-Removed duplicate parse_ip_port from config_parser.c
-- Unused parse_ip_port in config_parser.c (lines 70-86)
-- Function was static and never called (confirmed by ripgrep)
-- kept working version in etcp_connections.c (used by init_connections)
-- Kept net_emulator version (separate tool, not a duplication)
-
-Sun Jan 19 2026 13:00: Migrate to GNU Autotools (autoconf/automake)
-
-CHANGES:
-
-1. Created GNU Autotools build system:
- - configure.ac: Main autoconf configuration
- - Makefile.am: Root automake configuration
- - src/Makefile.am: Main program build rules
- - u_async/Makefile.am: u_async library build
- - tests/Makefile.am: Test suite configuration
- - autogen.sh: Bootstrap script
- - .gitignore: Updated for autotools
-
-2. Build system features:
- ✓ Standard ./configure && make workflow
- ✓ make check for running tests
- ✓ make install for installation
- ✓ make dist for release tarballs
- ✓ Proper dependency tracking
- ✓ Cross-platform compatibility
-
-3. Configuration features:
- - Checks for TUN/TAP support
- - Requires libcrypto (OpenSSL)
- - Detects standard headers/functions
- - Configurable debug output
- - Customizable installation paths
-
-USAGE:
- ./autogen.sh # Bootstrap (first time)
- ./configure # Configure build
- make # Build
- make check # Run tests
- sudo make install # Install
-
-COMPATIBILITY:
- • Old Makefile removed (renamed to Makefile.old)
- • All build functionality preserved
- • Test suite fully integrated
- • Backward compatible with existing code
-
-Sun Jan 19 2026 12:15: Task 4 Completed - fprintf → Debug System
-
-CHANGES:
-
-Replaced all fprintf(stderr) with DEBUG macros:
- • utun.c: 27 replacements
- • config_parser.c: 7 replacements
- • etcp_connections.c: 13 replacements
- • etcp.c: 1 replacement
- • tun_if.c: 3 replacements
- • utun_instance.c: 9 replacements
- • utun_route_fix.c: 1 replacement
- ────────────────────────────────────────
- TOTAL: 60 replacements
-
-Categories used:
- DEBUG_ERROR() with categories:
- - DEBUG_CATEGORY_ETCP (ETCP protocol errors)
- - DEBUG_CATEGORY_TUN (TUN interface errors)
- - DEBUG_CATEGORY_CONFIG (Configuration errors)
- - DEBUG_CATEGORY_ROUTING (Routing errors)
- - DEBUG_CATEGORY_MEMORY (Memory/system errors)
-
- DEBUG_WARNING() for non-critical warnings
-
-All files updated with #include "debug_config.h"
-Debug output now controllable via debug config system.
-
-Sun Jan 19 2026 11:00: Task 2 Finalized - Remaining typedefs fixed
-
-COMPLETED:
- • Fixed broken typedef in etcp.h (struct UTUN_INSTANCE*)
- • Removed etcp_t typedef (now struct ETCP_CONN)
- • Updated all usages across etcp.c and test files
-
-RESULTS:
- • Total typedef structs: 4 remaining (all in ll_queue.h - u_async)
- • 24 of 28 typedefs removed (86%)
- • Code now follows AGENTS.md struct naming conventions
-
-Sun Jan 19 2026 10:30: Task 3 Completed - Legacy Test Cleanup
-
-CHANGES:
-
-1. Removed 7 obsolete test files:
- - test_connection.c, test_connection_stress.c (conn_handle_t)
- - test_sc_lib.c, test_udp_secure.c, test_utun_fork.c (sc_lib)
- - test_utun_integration.c, test_full_stack.c (mixed legacy)
-
-2. Updated Makefile:
- - Removed TEST_*_OBJS variables for deleted tests
- - Removed build rules for deleted tests
- - Removed from 'all' target (down to 10 tests from 16)
- - Kept SC_LIB_OBJS (secure_channel/crc32, still needed)
-
-3. Updated 4 test files to new API:
- - Replaced epkt_t* with struct ETCP_CONN*
- - Replaced etcp_init() with etcp_create()
- - Replaced conn_handle_t* with struct ETCP_SOCKET* (test_new_features.c)
-
-RESULTS:
-- Test codebase reduced by 50% (7 of 14 test files removed)
-- No remaining references to connection.h in tests
-- No remaining references to sc_lib in test code
-- Can now focus on current API for testing
-
-Sun Jan 19 2026 10:30: Code Style Refactoring Part 4 - secure_channel and utun_instance
-
-CHANGES:
-
-1. **secure_channel.h and secure_channel.c**
- - Changed typedef struct {..} secure_channel_t to struct secure_channel {..}
- - Updated all function signatures
-
-2. **utun_instance.h**
- - Changed typedef struct utun_instance to struct UTUN_INSTANCE
- - Updated function signatures
-
-3. **Multiple files updated**
- - Replaced all utun_instance_t with struct UTUN_INSTANCE*
- - Replaced all etcp_socket_t with struct ETCP_SOCKET*
-
-RESULTS:
-- Reduced typedef struct from 8 to 6 across codebase
-- All new structures (created after project start) converted to uppercase pattern
-- Only remaining: 2 in etcp.h (etcp_t, utun_instance_t), 4 in ll_queue.h (u_async)
-
-Progress: 28 → 6 typedef structs removed (78% complete)
-Files affected: 11 header files, 8 source files
-
-Sun Jan 18 2026 19:45: Code Style Refactoring Part 2 - More struct replacements
-
-CHANGES:
-
-1. **etcp_sockets.h**
- - Removed legacy conn_handle_t (deprecated connection handle)
- - Changed typedef struct etcp_socket to struct etcp_socket
- - Updated callback signatures to use struct packet_buffer*
-
-2. **tun_if.h and tun_if.c**
- - Changed typedef struct {..} tun_config_t to struct tun_config {..}
- - Updated all function signatures
-
-3. **pkt_normalizer.h and pkt_normalizer.c**
- - Removed typedef struct pn_struct pn_struct (forward decl)
- - Removed typedef struct pkt_normalizer_pair pkt_normalizer_pair (forward decl)
- - Changed struct definitions to use struct STRUCT_NAME pattern
- - Updated all function signatures
-
-RESULTS:
-- Reduced typedef struct from 28 to 18 (completed 10/28)
-- Removed 3 forward declaration typedefs
-- Updated 6 files total in this batch
-
-Remaining: 18 typedef structs in 6 files
-
-Sun Jan 18 2026 12:15: Config Parser Updated for utun_test.cfg Format
-
-CHANGES:
-
-1. **Config Parser (config_parser.c)**
- - Added support for link=server:ip:port format in [client:] sections
- - Each link= line creates separate client entry automatically
- - Added SECTION_ROUTING for [routing] section (ignored for now)
- - Fixed client name preservation across multiple links
- - Prevent adding empty clients on EOF
-
-2. **utun_test.cfg (master config)**
- - Updated to use new link= format for multiple connections
- - Format: link=server_name:remote_ip:remote_port
- - Example: link=wired1_fast:192.168.0.20:1234
-
-3. **Test Results**
- - Successfully parses 2 servers + 4 clients from utun_test.cfg
- - init_connections correctly creates ETCP instances and links
- - Socket creation fails only due to non-local IPs (expected)
-
-CONFIGURATION FILES:
-- utun_test.cfg: master config with new format
-- test_server.conf, test_client.conf: removed (no longer needed)
-
-Sun Jan 19 2026 13:09
-Removed duplicate init_connections from utun.c
-- Deleted utun_state_t and all related legacy code
-- Rewrote main() to use UTUN_INSTANCE API
-- Removed 103 lines of obsolete code
-Sun Jan 19 2026 13:24
-Fixed build - removed typedefs from ll_queue and packet_pool
-- Updated ll_queue.h/.c to use struct instead of typedef
-- Added struct definition for UTUN_INSTANCE fields
-- Fixed memory_pool and packet_pool typedefs
-Sun Jan 19 2026 13:57
-Removed config file parsing from debug_config
-- Removed debug_parse_config_file() and auto-reload functionality
-Sun Jan 19 2026 14:01
-Moved mainloop from utun_instance to main
-- utun_instance_run() now does single iteration
-- Added tun_read_callback to utun_instance
-- Added utun_instance_register_sockets()
-Sun Jan 19 2026 14:02
-Build successful - all refactoring complete
-Sun Jan 19 2026 14:19
-Final: Build successful with refactored architecture
-Sun Jan 19 2026 14:26
-Refactoring complete - utun binary ready
-2026-01-18 16:38:15
-Добавлен config_updater.c/h - автоматическая генерация ключей и node_id при запуске
-2026-01-18 17:17:40: secure_channel - переделана генерация nonce на SHA256(64bit urandom + 64bit counter + 32bit utime), счетчики расширены до 64bit
-2026-01-18 17:22:28: sha256.c/h перемещены из src/ в lib/
-2026-01-18 18:17:37: Упрощена структура ETCP_CONNECTIONS - встроено uasync_add_socket, удалены обертки socket-функций
-2026-01-18 19:32:55: Встроено шифрование и дешифрование в etcp_link_send и etcp_input. Добавлены счетчики ошибок и статистика.
-2026-01-18 19:37:40: Имплементация шифрования завершена. Добавлена поддержка secure channel с AES-CCM, nonce и счетчиками. pubkey в конце INIT-пакетов. Клиенты загружают peer_public_key из конфига.
-2026-01-18 20:38:35: Fixed etcp_link_new call, added etcp_socket_read_callback for uasync integration.
-2026-01-18 21:20:56: Финальный отчет: Реально встроено шифрование с AES-CCM в etcp_link_send и etcp_input. Добавлены тесты.
-2026-01-18 22:00:59: Fix critical bug: sc_derive_shared_key called inside sc_set_peer_public_key. Correct order for INIT: pubkey, derive, decrypt. Added peer_public_key for clients.
diff --git a/configure.ac b/configure.ac
index 4e4141c..c5950da 100644
--- a/configure.ac
+++ b/configure.ac
@@ -8,7 +8,7 @@ AC_CONFIG_MACRO_DIR([m4])
AC_PROG_CC
AC_PROG_RANLIB
AM_PROG_AR
-AM_INIT_AUTOMAKE([foreign subdir-objects -Wall -Werror])
+AM_INIT_AUTOMAKE([foreign subdir-objects -Wall])
# Checks for programs
AC_PROG_INSTALL
diff --git a/doc/dgram_protocol.txt b/doc/dgram_protocol.txt
new file mode 100644
index 0000000..80b2e19
--- /dev/null
+++ b/doc/dgram_protocol.txt
@@ -0,0 +1,2 @@
+форматы кодограмм протокола dgram:
+- dgram протокол отправляет сообщения в очередь input pkt_normalizer.
diff --git a/doc/etcp_arch.md b/doc/etcp_arch.md
old mode 100755
new mode 100644
index 433b040..0878095
--- a/doc/etcp_arch.md
+++ b/doc/etcp_arch.md
@@ -7,9 +7,22 @@
## etcp_loadbalancer:
- выбирает через какой маршрут отправить пакет
- ограничивает rate отправки чтобы не забивать очереди каналов
+- сделан для совместной работы с etcp модулем
+## pkt_normalizer:
+- обеспечивает фрагментацию и сборку пакетов в единый поток для передачи через etcp.
+- взаимодейстует с etcp и очередями для приема и передачи.
+- в очередь для передачи может отправить любой модуль
+- из очереди приёма пакеты забирает etcp_api
+
+## etcp_api:
+- обеспечивает связь между etcp и остальными модулями
+- имеет функцию которая забирает из normalizer принятые данные и перенаправляет их на нужный модуль
+- имеет функцию connector_bind которой можно установить коллбэк для нужного типа кодограмм (первый байт).
+
## etcp:
- обеспечивает ретрансмиссии при передаче и сборку в правильной последовательности при приёме
+- взаимодействует с pkt_normalizer и с udp сокетами для отправки-получения пакетов
## etcp_metric:
- обеспечивает обновление метрик каналов etcp_connections
diff --git a/doc/etcp_config.txt b/doc/etcp_config.txt
old mode 100755
new mode 100644
diff --git a/lib/Makefile.am b/lib/Makefile.am
index 7d41d56..3b61fe6 100644
--- a/lib/Makefile.am
+++ b/lib/Makefile.am
@@ -19,3 +19,21 @@ libuasync_a_CFLAGS = \
-DDEBUG_OUTPUT_STDERR \
-I$(top_srcdir)/src \
-I$(top_srcdir)/lib
+
+# Object directory for shadow build artifacts
+OBJDIR = $(top_builddir)/.objs/lib
+
+# After building, move object files to shadow directory
+all-local: shadow-objects
+
+shadow-objects: libuasync.a
+ @$(MKDIR_P) $(OBJDIR)
+ @for obj in $(libuasync_a_OBJECTS); do \
+ if test -f "$$obj"; then \
+ mv -f "$$obj" $(OBJDIR)/ 2>/dev/null || true; \
+ fi; \
+ done
+
+# Clean shadow directory along with regular clean
+clean-local:
+ -rm -rf $(OBJDIR)
diff --git a/lib/debug_config.c b/lib/debug_config.c
index 3ffcd41..12faf10 100644
--- a/lib/debug_config.c
+++ b/lib/debug_config.c
@@ -1,7 +1,7 @@
-/**
- * Debug module
- */
-
+/**
+ * Debug module
+ */
+
#include "debug_config.h"
#include
#include
@@ -12,214 +12,214 @@
#include
#include
#include
-
-#include
-#include
-#include
-#include
-
-void log_dump(const char* prefix, const uint8_t* data, size_t len) {
- // Build packet data as hex string for single-line output
- char hex_buf[513]; // 256 bytes * 2 chars + 1 for null terminator
- size_t hex_len = 0;
- size_t show_len = (len > 128) ? 128 : len; // Show max 128 bytes
-
- for (size_t i = 0; i < show_len && hex_len < 512 - 3; i++) {
- hex_len += snprintf(hex_buf + hex_len, sizeof(hex_buf) - hex_len, "%02x", data[i]);
- if (i < show_len - 1 && (i + 1) % 32 == 0) { // Add space every 32 bytes
- hex_len += snprintf(hex_buf + hex_len, sizeof(hex_buf) - hex_len, " ");
- }
- }
-
- if (len > 128) {
- hex_len += snprintf(hex_buf + hex_len, sizeof(hex_buf) - hex_len, "...");
- }
-
- // Single-line debug output with packet info
- DEBUG_INFO(DEBUG_CATEGORY_ETCP, "%s: len=%zu hex=%s", prefix, len, hex_buf);
-
- // Additional debug info for first few bytes
-// if (len >= 2) {
-// DEBUG_DEBUG(DEBUG_CATEGORY_ETCP, "%s: first_bytes=%02x%02x last_bytes=%02x%02x",
-// prefix, data[0], data[1], data[len-2], data[len-1]);
-// }
-}
-
-
-size_t addr_to_string(const struct sockaddr_storage *addr, char *buf, size_t buflen) {
- if (!buf || buflen == 0)
- return 0;
-
- buf[0] = '\0'; // всегда валидная строка
-
- char ip[INET6_ADDRSTRLEN];
- uint16_t port;
- int n;
-
- if (addr->ss_family == AF_INET) {
- const struct sockaddr_in *a = (const struct sockaddr_in *)addr;
- inet_ntop(AF_INET, &a->sin_addr, ip, sizeof(ip));
- port = ntohs(a->sin_port);
-
- n = snprintf(buf, buflen, "%s:%u", ip, port);
-
- } else if (addr->ss_family == AF_INET6) {
- const struct sockaddr_in6 *a = (const struct sockaddr_in6 *)addr;
- inet_ntop(AF_INET6, &a->sin6_addr, ip, sizeof(ip));
- port = ntohs(a->sin6_port);
-
- n = snprintf(buf, buflen, "[%s]:%u", ip, port);
-
- } else {
- return 0;
- }
-
- // snprintf гарантирует '\0', но на всякий случай:
- buf[buflen - 1] = '\0';
-
- // Возвращаем фактическую длину (как snprintf)
- return (n < 0) ? 0 : (size_t)n;
-}
-
-
-/* Get category by name */
-static debug_category_t get_category_by_name(const char* name) {
- struct {
- const char* n;
- debug_category_t c;
- } map[] = {
- {"none", DEBUG_CATEGORY_NONE},
- {"uasync", DEBUG_CATEGORY_UASYNC},
- {"ll_queue", DEBUG_CATEGORY_LL_QUEUE},
- {"connection", DEBUG_CATEGORY_CONNECTION},
- {"etcp", DEBUG_CATEGORY_ETCP},
- {"crypto", DEBUG_CATEGORY_CRYPTO},
- {"memory", DEBUG_CATEGORY_MEMORY},
- {"timing", DEBUG_CATEGORY_TIMING},
- {"config", DEBUG_CATEGORY_CONFIG},
- {"tun", DEBUG_CATEGORY_TUN},
- {"routing", DEBUG_CATEGORY_ROUTING},
- {"timers", DEBUG_CATEGORY_TIMERS},
- {"all", DEBUG_CATEGORY_ALL},
- {NULL, 0}
- };
-
- for (int i = 0; map[i].n; i++) {
- if (strcasecmp(map[i].n, name) == 0) {
- return map[i].c;
- }
- }
- return DEBUG_CATEGORY_NONE;
-}
-
-/* Global debug configuration */
-debug_config_t g_debug_config;
-FILE* debug_output_file = NULL;
-
-/* Initialize debug system with default settings */
-void debug_config_init(void) {
- g_debug_config.level = DEBUG_LEVEL_ERROR;
- g_debug_config.categories = DEBUG_CATEGORY_ALL;
- g_debug_config.timestamp_enabled = 1;
- g_debug_config.function_name_enabled = 1;
- g_debug_config.file_line_enabled = 1;
- g_debug_config.output_file = NULL;
-
- if (debug_output_file && debug_output_file != stdout && debug_output_file != stderr) {
- fclose(debug_output_file);
- }
- debug_output_file = stdout;
-}
-
-/* Set debug level */
-void debug_set_level(debug_level_t level) {
- g_debug_config.level = level;
-}
-
-/* Enable/disable specific categories */
-void debug_enable_category(debug_category_t category) {
- g_debug_config.categories |= category;
-}
-
-void debug_disable_category(debug_category_t category) {
- g_debug_config.categories &= ~category;
-}
-
-void debug_set_categories(debug_category_t categories) {
- g_debug_config.categories = categories;
-}
-
-/* Set masks directly */
-void debug_set_masks(debug_category_t categories, debug_level_t level) {
- g_debug_config.categories = categories;
- g_debug_config.level = level;
-}
-
-void debug_enable_function_name(int enable) {
- g_debug_config.function_name_enabled = enable;
-}
-
-void debug_enable_file_line(int enable) {
- g_debug_config.file_line_enabled = enable;
-}
-
-void debug_set_output_file(const char* file_path) {
- if (debug_output_file) return;// уже установлен, кто первый того и тапки
- FILE* new_file = fopen(file_path, "a");
- if (new_file) {
- debug_output_file = new_file;
- g_debug_config.output_file = file_path;
- }
-}
-
-/* Check if debug output should be shown for given level and category */
-int debug_should_output(debug_level_t level, debug_category_t category) {
-
- /* Check if category is enabled */
- if (!(g_debug_config.categories & category)) {
- return 0;
- }
-
- /* Check if level is sufficient */
- if (level > g_debug_config.level) {
- return 0;
- }
-
- return 1;
-}
-
-/* Get current debug level */
-debug_level_t debug_get_level(void) {
- return g_debug_config.level;
-}
-
-/* Get level name */
-static const char* get_level_name(debug_level_t level) {
- switch (level) {
- case DEBUG_LEVEL_ERROR: return "ERROR";
- case DEBUG_LEVEL_WARN: return "WARN";
- case DEBUG_LEVEL_INFO: return "INFO";
- case DEBUG_LEVEL_DEBUG: return "DEBUG";
- case DEBUG_LEVEL_TRACE: return "TRACE";
- default: return "UNKNOWN";
- }
-}
-
-/* Format and output debug message */
-void debug_output(debug_level_t level, debug_category_t category,
- const char* function, const char* file, int line,
- const char* format, ...) {
-
-#define BUFFER_SIZE 4096
- char buffer[BUFFER_SIZE];
- int offset = 0;
- size_t remaining = BUFFER_SIZE;
-
- va_list args;
- va_start(args, format);
-
- FILE* output = debug_output_file ? debug_output_file : stdout;
-
+
+#include
+#include
+#include
+#include
+
+void log_dump(const char* prefix, const uint8_t* data, size_t len) {
+ // Build packet data as hex string for single-line output
+ char hex_buf[513]; // 256 bytes * 2 chars + 1 for null terminator
+ size_t hex_len = 0;
+ size_t show_len = (len > 128) ? 128 : len; // Show max 128 bytes
+
+ for (size_t i = 0; i < show_len && hex_len < 512 - 3; i++) {
+ hex_len += snprintf(hex_buf + hex_len, sizeof(hex_buf) - hex_len, "%02x", data[i]);
+ if (i < show_len - 1 && (i + 1) % 32 == 0) { // Add space every 32 bytes
+ hex_len += snprintf(hex_buf + hex_len, sizeof(hex_buf) - hex_len, " ");
+ }
+ }
+
+ if (len > 128) {
+ hex_len += snprintf(hex_buf + hex_len, sizeof(hex_buf) - hex_len, "...");
+ }
+
+ // Single-line debug output with packet info
+ DEBUG_INFO(DEBUG_CATEGORY_ETCP, "%s: len=%zu hex=%s", prefix, len, hex_buf);
+
+ // Additional debug info for first few bytes
+// if (len >= 2) {
+// DEBUG_DEBUG(DEBUG_CATEGORY_ETCP, "%s: first_bytes=%02x%02x last_bytes=%02x%02x",
+// prefix, data[0], data[1], data[len-2], data[len-1]);
+// }
+}
+
+
+size_t addr_to_string(const struct sockaddr_storage *addr, char *buf, size_t buflen) {
+ if (!buf || buflen == 0)
+ return 0;
+
+ buf[0] = '\0'; // всегда валидная строка
+
+ char ip[INET6_ADDRSTRLEN];
+ uint16_t port;
+ int n;
+
+ if (addr->ss_family == AF_INET) {
+ const struct sockaddr_in *a = (const struct sockaddr_in *)addr;
+ inet_ntop(AF_INET, &a->sin_addr, ip, sizeof(ip));
+ port = ntohs(a->sin_port);
+
+ n = snprintf(buf, buflen, "%s:%u", ip, port);
+
+ } else if (addr->ss_family == AF_INET6) {
+ const struct sockaddr_in6 *a = (const struct sockaddr_in6 *)addr;
+ inet_ntop(AF_INET6, &a->sin6_addr, ip, sizeof(ip));
+ port = ntohs(a->sin6_port);
+
+ n = snprintf(buf, buflen, "[%s]:%u", ip, port);
+
+ } else {
+ return 0;
+ }
+
+ // snprintf гарантирует '\0', но на всякий случай:
+ buf[buflen - 1] = '\0';
+
+ // Возвращаем фактическую длину (как snprintf)
+ return (n < 0) ? 0 : (size_t)n;
+}
+
+
+/* Get category by name */
+static debug_category_t get_category_by_name(const char* name) {
+ struct {
+ const char* n;
+ debug_category_t c;
+ } map[] = {
+ {"none", DEBUG_CATEGORY_NONE},
+ {"uasync", DEBUG_CATEGORY_UASYNC},
+ {"ll_queue", DEBUG_CATEGORY_LL_QUEUE},
+ {"connection", DEBUG_CATEGORY_CONNECTION},
+ {"etcp", DEBUG_CATEGORY_ETCP},
+ {"crypto", DEBUG_CATEGORY_CRYPTO},
+ {"memory", DEBUG_CATEGORY_MEMORY},
+ {"timing", DEBUG_CATEGORY_TIMING},
+ {"config", DEBUG_CATEGORY_CONFIG},
+ {"tun", DEBUG_CATEGORY_TUN},
+ {"routing", DEBUG_CATEGORY_ROUTING},
+ {"timers", DEBUG_CATEGORY_TIMERS},
+ {"all", DEBUG_CATEGORY_ALL},
+ {NULL, 0}
+ };
+
+ for (int i = 0; map[i].n; i++) {
+ if (strcasecmp(map[i].n, name) == 0) {
+ return map[i].c;
+ }
+ }
+ return DEBUG_CATEGORY_NONE;
+}
+
+/* Global debug configuration */
+debug_config_t g_debug_config;
+FILE* debug_output_file = NULL;
+
+/* Initialize debug system with default settings */
+void debug_config_init(void) {
+ g_debug_config.level = DEBUG_LEVEL_ERROR;
+ g_debug_config.categories = DEBUG_CATEGORY_ALL;
+ g_debug_config.timestamp_enabled = 1;
+ g_debug_config.function_name_enabled = 1;
+ g_debug_config.file_line_enabled = 1;
+ g_debug_config.output_file = NULL;
+
+ if (debug_output_file && debug_output_file != stdout && debug_output_file != stderr) {
+ fclose(debug_output_file);
+ }
+ debug_output_file = stdout;
+}
+
+/* Set debug level */
+void debug_set_level(debug_level_t level) {
+ g_debug_config.level = level;
+}
+
+/* Enable/disable specific categories */
+void debug_enable_category(debug_category_t category) {
+ g_debug_config.categories |= category;
+}
+
+void debug_disable_category(debug_category_t category) {
+ g_debug_config.categories &= ~category;
+}
+
+void debug_set_categories(debug_category_t categories) {
+ g_debug_config.categories = categories;
+}
+
+/* Set masks directly */
+void debug_set_masks(debug_category_t categories, debug_level_t level) {
+ g_debug_config.categories = categories;
+ g_debug_config.level = level;
+}
+
+void debug_enable_function_name(int enable) {
+ g_debug_config.function_name_enabled = enable;
+}
+
+void debug_enable_file_line(int enable) {
+ g_debug_config.file_line_enabled = enable;
+}
+
+void debug_set_output_file(const char* file_path) {
+ if (debug_output_file) return;// уже установлен, кто первый того и тапки
+ FILE* new_file = fopen(file_path, "a");
+ if (new_file) {
+ debug_output_file = new_file;
+ g_debug_config.output_file = file_path;
+ }
+}
+
+/* Check if debug output should be shown for given level and category */
+int debug_should_output(debug_level_t level, debug_category_t category) {
+
+ /* Check if category is enabled */
+ if (!(g_debug_config.categories & category)) {
+ return 0;
+ }
+
+ /* Check if level is sufficient */
+ if (level > g_debug_config.level) {
+ return 0;
+ }
+
+ return 1;
+}
+
+/* Get current debug level */
+debug_level_t debug_get_level(void) {
+ return g_debug_config.level;
+}
+
+/* Get level name */
+static const char* get_level_name(debug_level_t level) {
+ switch (level) {
+ case DEBUG_LEVEL_ERROR: return "ERROR";
+ case DEBUG_LEVEL_WARN: return "WARN";
+ case DEBUG_LEVEL_INFO: return "INFO";
+ case DEBUG_LEVEL_DEBUG: return "DEBUG";
+ case DEBUG_LEVEL_TRACE: return "TRACE";
+ default: return "UNKNOWN";
+ }
+}
+
+/* Format and output debug message */
+void debug_output(debug_level_t level, debug_category_t category,
+ const char* function, const char* file, int line,
+ const char* format, ...) {
+
+#define BUFFER_SIZE 4096
+ char buffer[BUFFER_SIZE];
+ int offset = 0;
+ size_t remaining = BUFFER_SIZE;
+
+ va_list args;
+ va_start(args, format);
+
+ FILE* output = debug_output_file ? debug_output_file : stdout;
+
/* Add timestamp with microseconds: hh:mm:ss-xxx.yyy */
struct timeval tv;
gettimeofday(&tv, NULL);
@@ -228,16 +228,16 @@ void debug_output(debug_level_t level, debug_category_t category,
strftime(time_str, sizeof(time_str), "%H:%M:%S", tm_info);
offset += snprintf(buffer + offset, remaining, "[%s-%03ld.%03ld] ", time_str, tv.tv_usec / 1000, tv.tv_usec % 1000);
remaining = BUFFER_SIZE - offset;
-
- /* Add level */
- const char* level_name = get_level_name(level);
- offset += snprintf(buffer + offset, remaining, "[%s] ", level_name);
- remaining = BUFFER_SIZE - offset;
-
- /* Add category */
- offset += snprintf(buffer + offset, remaining, "[%llu] ", (unsigned long long)category);
- remaining = BUFFER_SIZE - offset;
-
+
+ /* Add level */
+ const char* level_name = get_level_name(level);
+ offset += snprintf(buffer + offset, remaining, "[%s] ", level_name);
+ remaining = BUFFER_SIZE - offset;
+
+ /* Add category */
+ offset += snprintf(buffer + offset, remaining, "[%llu] ", (unsigned long long)category);
+ remaining = BUFFER_SIZE - offset;
+
/* Add file:line if enabled */
if (g_debug_config.file_line_enabled && file) {
offset += snprintf(buffer + offset, remaining, "(%s:%d) ", file, line);
@@ -249,97 +249,97 @@ void debug_output(debug_level_t level, debug_category_t category,
offset += snprintf(buffer + offset, remaining, "%s() ", function);
remaining = BUFFER_SIZE - offset;
}
-
- /* Add the actual message */
- offset += vsnprintf(buffer + offset, remaining, format, args);
- remaining = BUFFER_SIZE - offset;
-
- /* Add newline */
- if (remaining > 1) {
- buffer[offset] = '\n';
- buffer[offset + 1] = '\0';
- } else {
- buffer[BUFFER_SIZE - 2] = '\n';
- buffer[BUFFER_SIZE - 1] = '\0';
- }
-
- va_end(args);
-
- /* Output the entire line at once */
- fprintf(output, "%s", buffer);
- fflush(output);
-#undef BUFFER_SIZE
-}
-
-/* Parse debug configuration from string */
-int debug_parse_config(const char* config_string) {
- if (!config_string || !*config_string) {
- return 0;
- }
-
- char* str = strdup(config_string);
- if (!str) {
- return -1;
- }
-
- debug_category_t categories = 0;
- debug_level_t level = DEBUG_LEVEL_NONE;
-
- char* token = strtok(str, ";");
- while (token) {
- /* Trim leading spaces */
- while (isspace(*token)) {
- token++;
- }
-
- char* eq = strchr(token, '=');
- if (!eq) {
- free(str);
- return -1;
- }
-
- *eq = '\0';
- char* key = token;
- char* value = eq + 1;
-
- /* Trim leading spaces in value */
- while (isspace(*value)) {
- value++;
- }
-
- if (strcasecmp(key, "modules") == 0) {
- char* mod_token = strtok(value, ",");
- while (mod_token) {
- /* Trim leading spaces */
- while (isspace(*mod_token)) {
- mod_token++;
- }
-
- debug_category_t cat = get_category_by_name(mod_token);
- if (cat == DEBUG_CATEGORY_NONE) {
- free(str);
- return -1;
- }
- categories |= cat;
- mod_token = strtok(NULL, ",");
- }
- } else if (strcasecmp(key, "level") == 0) {
- int lev_num = atoi(value);
- if (lev_num < DEBUG_LEVEL_NONE || lev_num > DEBUG_LEVEL_TRACE) {
- free(str);
- return -1;
- }
- level = (debug_level_t)lev_num;
- } else {
- free(str);
- return -1;
- }
-
- token = strtok(NULL, ";");
- }
-
- debug_set_masks(categories, level);
-
- free(str);
- return 0;
-}
+
+ /* Add the actual message */
+ offset += vsnprintf(buffer + offset, remaining, format, args);
+ remaining = BUFFER_SIZE - offset;
+
+ /* Add newline */
+ if (remaining > 1) {
+ buffer[offset] = '\n';
+ buffer[offset + 1] = '\0';
+ } else {
+ buffer[BUFFER_SIZE - 2] = '\n';
+ buffer[BUFFER_SIZE - 1] = '\0';
+ }
+
+ va_end(args);
+
+ /* Output the entire line at once */
+ fprintf(output, "%s", buffer);
+ fflush(output);
+#undef BUFFER_SIZE
+}
+
+/* Parse debug configuration from string */
+int debug_parse_config(const char* config_string) {
+ if (!config_string || !*config_string) {
+ return 0;
+ }
+
+ char* str = strdup(config_string);
+ if (!str) {
+ return -1;
+ }
+
+ debug_category_t categories = 0;
+ debug_level_t level = DEBUG_LEVEL_NONE;
+
+ char* token = strtok(str, ";");
+ while (token) {
+ /* Trim leading spaces */
+ while (isspace(*token)) {
+ token++;
+ }
+
+ char* eq = strchr(token, '=');
+ if (!eq) {
+ free(str);
+ return -1;
+ }
+
+ *eq = '\0';
+ char* key = token;
+ char* value = eq + 1;
+
+ /* Trim leading spaces in value */
+ while (isspace(*value)) {
+ value++;
+ }
+
+ if (strcasecmp(key, "modules") == 0) {
+ char* mod_token = strtok(value, ",");
+ while (mod_token) {
+ /* Trim leading spaces */
+ while (isspace(*mod_token)) {
+ mod_token++;
+ }
+
+ debug_category_t cat = get_category_by_name(mod_token);
+ if (cat == DEBUG_CATEGORY_NONE) {
+ free(str);
+ return -1;
+ }
+ categories |= cat;
+ mod_token = strtok(NULL, ",");
+ }
+ } else if (strcasecmp(key, "level") == 0) {
+ int lev_num = atoi(value);
+ if (lev_num < DEBUG_LEVEL_NONE || lev_num > DEBUG_LEVEL_TRACE) {
+ free(str);
+ return -1;
+ }
+ level = (debug_level_t)lev_num;
+ } else {
+ free(str);
+ return -1;
+ }
+
+ token = strtok(NULL, ";");
+ }
+
+ debug_set_masks(categories, level);
+
+ free(str);
+ return 0;
+}
diff --git a/lib/ll_queue.c b/lib/ll_queue.c
old mode 100755
new mode 100644
diff --git a/lib/ll_queue.h1 b/lib/ll_queue.h1
old mode 100755
new mode 100644
diff --git a/lib/sha256.c b/lib/sha256.c
old mode 100755
new mode 100644
diff --git a/lib/sha256.h b/lib/sha256.h
old mode 100755
new mode 100644
diff --git a/lib/timeout_heap.c1 b/lib/timeout_heap.c1
old mode 100755
new mode 100644
diff --git a/lib/u_async.c1 b/lib/u_async.c1
old mode 100755
new mode 100644
diff --git a/src/Makefile.am b/src/Makefile.am
index 253753d..a519e25 100644
--- a/src/Makefile.am
+++ b/src/Makefile.am
@@ -60,6 +60,33 @@ else
utun_LDADD = $(utun_CORE_LDADD)
endif
+# Object directory for shadow build artifacts
+OBJDIR = $(top_builddir)/.objs/src
+TINYCRYPT_OBJDIR = $(top_builddir)/.objs/tinycrypt
+
+# After building, move object files to shadow directory
+all-local: shadow-objects
+
+shadow-objects: utun$(EXEEXT)
+ @$(MKDIR_P) $(OBJDIR) $(TINYCRYPT_OBJDIR)
+ @for obj in $(utun_OBJECTS); do \
+ if test -f "$$obj"; then \
+ case "$$obj" in \
+ *lib/source/*.o) \
+ base=$$(basename $$obj | sed 's/^utun-//'); \
+ mv -f "$$obj" $(TINYCRYPT_OBJDIR)/"$$base" 2>/dev/null || true; \
+ ;; \
+ *) \
+ mv -f "$$obj" $(OBJDIR)/ 2>/dev/null || true; \
+ ;; \
+ esac; \
+ fi; \
+ done
+
+# Clean shadow directories along with regular clean
+clean-local:
+ -rm -rf $(OBJDIR) $(TINYCRYPT_OBJDIR)
+
# Install directories
install-exec-hook:
$(MKDIR_P) $(DESTDIR)$(bindir)
diff --git a/src/aa b/src/aa
old mode 100755
new mode 100644
diff --git a/src/ab b/src/ab
new file mode 100644
index 0000000..6b57822
--- /dev/null
+++ b/src/ab
@@ -0,0 +1,31 @@
+Вопрос. Прошло пол года.
+У нас появился профессиональный ремонтник?
+А технолог?
+А админ?
+
+А почему?
+К чему привели сотни часов длительных разговоров с сотрудниками, есть какие-то ощутимые улучшения? Кроме того что саботажники притихли и теперь осторожность проявляют чтоб лишнего не ляпнуть
+
+игнорирование техпроцесса сегодня - это катастрофа завтра.
+«Проблема сегодня — это потеря X денег завтра. Ты можешь это исправить быстро, а если подождёшь, то последствия будут более серьёзными и дорогими.»
+
+Обучение без внутренней мотивации почти всегда даёт слабый и нестабильный результат.
+Инициативу нельзя “внедрить”.
+Можно только создать условия, где она либо появляется, либо становится очевидно, что её не будет.
+
+Что реально можно попробовать (если всё же хочешь шанс)
+1. Проверка “а хочет ли он вообще”
+Прямо и спокойно:
+«Я готов вложить время, но мне важно понять — тебе это нужно?»
+Ответ без конкретики = плохой знак.
+
+Главный посыл - сколько не читай лекций и не заставляй учиться - человек умней не станет, и не станет лучше работать, пока сам не захочет и сам не начнёт учиться. А учиться это всегда долго и сложно. Да, можно временно "ограничить" проблемных людей, но толку с этого ровно ноль. Только потерянное время на сотню часов болтовни.
+А если учить - то ну не персионеров же, это мягко говоря зашквар. Единственный вариант для дедушек - чтобы они выпоняли только ту работу которой уже научились и которая у них хорошо получается.
+
+Я видел много примеров когда человек сам проявляет инициаливу, интересуется, учится и быстро растёт. точнее это единственный сценарий, по которому выросли профессионалы. Большинство профессионалов даже институт забросили потому что им интересно было ковыряться в их любимой тематике, а не слушать тот бред который преподы втирают. Вспомни Дожбса, Гейтса, да кого угодно возими.
+И не одного случая серьезного роста когда пришли в котору и объявили - а теперь всем на повышение квалификации. теперь каждый второй день - учимся. Это скорей про потрать бабло преподам на имитацию обучения.
+
+
+В моём понимании уже край как нужен адекватный технолог/ремонтник/руководитель, возможно в одном лице.
+Но. у меня есть опасения что текущий состав дедов его зачмырит как более опытного и угрозу их насиженному месту.
+Как действовать? какой план?
\ No newline at end of file
diff --git a/src/etcp.c b/src/etcp.c
index 1fb2ebd..8a33328 100644
--- a/src/etcp.c
+++ b/src/etcp.c
@@ -270,7 +270,7 @@ void etcp_update_log_name(struct ETCP_CONN* etcp) {
// Send data through ETCP connection
// Allocates memory from data_pool and places in input queue
// Returns: 0 on success, -1 on failure
-int etcp_send(struct ETCP_CONN* etcp, const void* data, uint16_t len) {
+int etcp_int_send(struct ETCP_CONN* etcp, const void* data, uint16_t len) {
DEBUG_TRACE(DEBUG_CATEGORY_ETCP, "");
if (!etcp || !data || len == 0) {
diff --git a/src/etcp.h b/src/etcp.h
index c340232..656b685 100644
--- a/src/etcp.h
+++ b/src/etcp.h
@@ -156,7 +156,7 @@ void etcp_conn_input(struct ETCP_DGRAM* pkt);
// Send data through ETCP connection
// Allocates memory from data_pool and places in input queue
// Returns: 0 on success, -1 on failure
-int etcp_send(struct ETCP_CONN* etcp, const void* data, uint16_t len);
+int etcp_int_send(struct ETCP_CONN* etcp, const void* data, uint16_t len);
// Request next packet for load balancer
struct ETCP_DGRAM* etcp_request_pkt(struct ETCP_CONN* etcp);
diff --git a/src/etcp_api.h b/src/etcp_api.h
new file mode 100644
index 0000000..0c671c0
--- /dev/null
+++ b/src/etcp_api.h
@@ -0,0 +1,5 @@
+/* api для приёма-передачи пакетов через etcp
+
+1.
+
+*/
\ No newline at end of file
diff --git a/src/etcp_loadbalancer.c b/src/etcp_loadbalancer.c
old mode 100755
new mode 100644
diff --git a/src/etcp_loadbalancer.h b/src/etcp_loadbalancer.h
old mode 100755
new mode 100644
diff --git a/src/etcp_send_test.txt b/src/etcp_send_test.txt
old mode 100755
new mode 100644
diff --git a/src/pkt_normalizer.h b/src/pkt_normalizer.h
index 48d0fcc..6ba76af 100644
--- a/src/pkt_normalizer.h
+++ b/src/pkt_normalizer.h
@@ -6,6 +6,15 @@
#include "../lib/u_async.h"
#include
+/*
+формат кодограмм:
+cmd = 0 - пакет для передачи адресату (далее содержимое пакета)
+cmd = 1 - элемент роутинг-таблицы (далее один маршрут)
+cmd = 2 - запрос роутинг-таблицы (без данных)
+
+
+*/
+
// Структура для packer
struct PKTNORM {
// public:
diff --git a/src/req.txt b/src/req.txt
old mode 100755
new mode 100644
index 1ee6d96..8bd041c
--- a/src/req.txt
+++ b/src/req.txt
@@ -12,6 +12,7 @@ overall score = правило выбираемок пользователем
- либо minimum delay
Формат данных:
+todo...
tun -> (src/dst ip) -> routing table -> next hop -> transmit to -> etcp -> routing -> tun
diff --git a/src/route_lib.c b/src/route_lib.c
index 1212df3..32061a6 100644
--- a/src/route_lib.c
+++ b/src/route_lib.c
@@ -33,8 +33,8 @@ int parse_subnet(const char *subnet_str, uint32_t *network, uint8_t *prefix_leng
static int compare_routes(const void *a, const void *b) {
- const struct route_entry *route_a = (const struct route_entry *)a;
- const struct route_entry *route_b = (const struct route_entry *)b;
+ const struct ROUTE_ENTRY *route_a = (const struct ROUTE_ENTRY *)a;
+ const struct ROUTE_ENTRY *route_b = (const struct ROUTE_ENTRY *)b;
// First compare by prefix length (longest prefix first)
if (route_b->prefix_length != route_a->prefix_length) {
@@ -62,15 +62,15 @@ static int compare_routes(const void *a, const void *b) {
return route_a->metrics.hop_count - route_b->metrics.hop_count;
}
-struct route_table *route_table_create(void) {
- struct route_table *table = calloc(1, sizeof(struct route_table));
+struct ROUTE_TABLE *route_table_create(void) {
+ struct ROUTE_TABLE *table = calloc(1, sizeof(struct ROUTE_TABLE));
if (!table) {
DEBUG_ERROR(DEBUG_CATEGORY_MEMORY, "route_table_create: failed to allocate memory for routing table");
return NULL;
}
table->capacity = INITIAL_ROUTE_CAPACITY;
- table->entries = calloc(table->capacity, sizeof(struct route_entry));
+ table->entries = calloc(table->capacity, sizeof(struct ROUTE_ENTRY));
if (!table->entries) {
DEBUG_ERROR(DEBUG_CATEGORY_MEMORY, "route_table_create: failed to allocate memory for %d route entries", table->capacity);
free(table);
@@ -93,7 +93,7 @@ struct route_table *route_table_create(void) {
return table;
}
-void route_table_destroy(struct route_table *table) {
+void route_table_destroy(struct ROUTE_TABLE *table) {
if (!table) return;
// Free route entries
@@ -106,7 +106,7 @@ void route_table_destroy(struct route_table *table) {
free(table);
}
-bool route_table_insert(struct route_table *table, const struct route_entry *entry) {
+bool route_table_insert(struct ROUTE_TABLE *table, const struct ROUTE_ENTRY *entry) {
if (!table || !entry) return false;
// Validate the route
@@ -123,7 +123,7 @@ bool route_table_insert(struct route_table *table, const struct route_entry *ent
// Check if we need to expand the table
if (table->count >= table->capacity) {
size_t new_capacity = table->capacity * ROUTE_EXPANSION_FACTOR;
- struct route_entry *new_entries = realloc(table->entries, new_capacity * sizeof(struct route_entry));
+ struct ROUTE_ENTRY *new_entries = realloc(table->entries, new_capacity * sizeof(struct ROUTE_ENTRY));
if (!new_entries) {
DEBUG_ERROR(DEBUG_CATEGORY_MEMORY, "route_table_insert: failed to expand routing table to %zu entries", new_capacity);
return false;
@@ -134,10 +134,9 @@ bool route_table_insert(struct route_table *table, const struct route_entry *ent
}
// Set timestamps and ensure route is active
- struct route_entry new_entry = *entry;
+ struct ROUTE_ENTRY new_entry = *entry;
new_entry.created_time = new_entry.last_update = (uint64_t)time(NULL) * 1000000; // Convert to microseconds
- new_entry.last_used = 0;
-
+
// Ensure route is active by default
if (!(new_entry.flags & ROUTE_FLAG_ACTIVE)) {
new_entry.flags |= ROUTE_FLAG_ACTIVE;
@@ -146,7 +145,6 @@ bool route_table_insert(struct route_table *table, const struct route_entry *ent
// Insert and maintain sorted order
- table->stats.routes_added++;
size_t insert_pos = table->count;
for (size_t i = 0; i < table->count; i++) {
if (compare_routes(&new_entry, &table->entries[i]) < 0) {
@@ -158,37 +156,33 @@ bool route_table_insert(struct route_table *table, const struct route_entry *ent
return false;
}
-bool route_table_lookup(struct route_table *table, uint32_t dest_ip, struct route_entry *best_route) {
+bool route_table_lookup(struct ROUTE_TABLE *table, uint32_t dest_ip, struct ROUTE_ENTRY *best_route) {
if (!table || !best_route) {
DEBUG_WARN(DEBUG_CATEGORY_ROUTING, "route_table_lookup: invalid parameters (table=%p, best_route=%p)", table, best_route);
return false;
}
-
- table->stats.lookup_count++;
-
+
// Find longest prefix match
for (size_t i = 0; i < table->count; i++) {
- const struct route_entry *entry = &table->entries[i];
-
+ const struct ROUTE_ENTRY *entry = &table->entries[i];
+
// Check if route is valid and matches destination
if (entry->flags & ROUTE_FLAG_ACTIVE) {
uint32_t mask = (entry->prefix_length == 0) ? 0 : (0xFFFFFFFFU << (32 - entry->prefix_length));
if ((dest_ip & mask) == (entry->network & mask)) {
*best_route = *entry;
best_route->last_update = (uint64_t)time(NULL) * 1000000;
-
+
char ip_str[16];
ip_to_string(dest_ip, ip_str);
DEBUG_INFO(DEBUG_CATEGORY_ROUTING, "Found route for %s: %s/%d",
ip_str, ip_to_string(entry->network, ip_str), entry->prefix_length);
-
- table->stats.hit_count++;
- table->stats.routes_lookup_hits++;
+
return true;
}
}
}
-
+
// No route found
char ip_str[16];
ip_to_string(dest_ip, ip_str);
@@ -197,7 +191,7 @@ bool route_table_lookup(struct route_table *table, uint32_t dest_ip, struct rout
return false;
}
-bool route_validate_route(struct route_table *table, uint32_t network, uint8_t prefix_length, route_type_t route_type) {
+bool route_validate_route(struct ROUTE_TABLE *table, uint32_t network, uint8_t prefix_length, route_type_t route_type) {
if (!table) return false;
uint32_t *validation_ranges = NULL;
@@ -216,17 +210,16 @@ bool route_validate_route(struct route_table *table, uint32_t network, uint8_t p
range_count = table->local_subnet_count;
break;
default:
- table->stats.routes_lookup_misses++;
return false;
}
-
+
if (range_count == 0) return true; // No validation ranges configured
-
+
// Check if network falls within any validation range
for (size_t i = 0; i < range_count; i += 2) {
uint32_t range_network = validation_ranges[i];
uint8_t range_prefix = (uint8_t)validation_ranges[i + 1];
-
+
uint32_t mask = (range_prefix == 0) ? 0 : (0xFFFFFFFFU << (32 - range_prefix));
if ((network & mask) == (range_network & mask)) {
// Check if this route is more specific than or equal to the validation range
@@ -235,22 +228,22 @@ bool route_validate_route(struct route_table *table, uint32_t network, uint8_t p
}
}
}
-
+
return false;
}
-static bool enhanced_route_add_subnet_range(struct route_table *table, uint32_t network, uint8_t prefix_length, uint32_t **ranges, size_t *count) {
+static bool enhanced_route_add_subnet_range(struct ROUTE_TABLE *table, uint32_t network, uint8_t prefix_length, uint32_t **ranges, size_t *count) {
if (!table || !ranges || !count) return false;
-
+
if (*count >= MAX_SUBNET_VALIDATION_RANGES - 2) return false;
-
+
// Expand array if needed
if (*ranges == NULL) {
*ranges = calloc(MAX_SUBNET_VALIDATION_RANGES, sizeof(uint32_t));
if (!*ranges) return false;
*count = 0;
}
-
+
// Add network and prefix length as a pair
(*ranges)[*count] = network;
(*ranges)[*count + 1] = prefix_length;
@@ -265,37 +258,37 @@ static bool enhanced_route_add_subnet_range(struct route_table *table, uint32_t
-bool route_add_dynamic_subnet(struct route_table *table, uint32_t network, uint8_t prefix_length) {
+bool route_add_dynamic_subnet(struct ROUTE_TABLE *table, uint32_t network, uint8_t prefix_length) {
return enhanced_route_add_subnet_range(table, network, prefix_length, &table->dynamic_subnets, &table->dynamic_subnet_count);
}
-bool route_add_local_subnet(struct route_table *table, uint32_t network, uint8_t prefix_length) {
+bool route_add_local_subnet(struct ROUTE_TABLE *table, uint32_t network, uint8_t prefix_length) {
return enhanced_route_add_subnet_range(table, network, prefix_length, &table->local_subnets, &table->local_subnet_count);
}
-bool route_get_all_routes(const struct route_table *table, uint32_t network, uint8_t prefix_length,
- struct route_entry **routes, size_t *count) {
+bool route_get_all_routes(const struct ROUTE_TABLE *table, uint32_t network, uint8_t prefix_length,
+ struct ROUTE_ENTRY **routes, size_t *count) {
if (!table || !routes || !count) return false;
-
+
*routes = NULL;
*count = 0;
-
+
// Count matching routes
for (size_t i = 0; i < table->count; i++) {
if (table->entries[i].network == network && table->entries[i].prefix_length == prefix_length) {
(*count)++;
}
}
-
+
if (*count == 0) return true; // No routes found, but not an error
-
+
// Allocate result array
- *routes = calloc(*count, sizeof(struct route_entry));
+ *routes = calloc(*count, sizeof(struct ROUTE_ENTRY));
if (!*routes) {
*count = 0;
return false;
}
-
+
// Copy matching routes
size_t result_index = 0;
for (size_t i = 0; i < table->count; i++) {
@@ -305,26 +298,26 @@ bool route_get_all_routes(const struct route_table *table, uint32_t network, uin
result_index++;
}
}
-
+
return true;
}
-void route_table_print(const struct route_table *table) {
+void route_table_print(const struct ROUTE_TABLE *table) {
if (!table) return;
-
+
DEBUG_INFO(DEBUG_CATEGORY_ROUTING, "=== Routing Table ===");
DEBUG_INFO(DEBUG_CATEGORY_ROUTING, "Total routes: %zu", table->count);
DEBUG_INFO(DEBUG_CATEGORY_ROUTING, "Dynamic subnets: %zu, Local subnets: %zu",
table->dynamic_subnet_count / 2, table->local_subnet_count / 2);
-
+
if (table->count > 0) {
DEBUG_INFO(DEBUG_CATEGORY_ROUTING, "Routes:");
for (size_t i = 0; i < table->count; i++) {
- const struct route_entry *entry = &table->entries[i];
+ const struct ROUTE_ENTRY *entry = &table->entries[i];
char network_str[16], next_hop_str[16];
-
+
ip_to_string(entry->network, network_str);
-
+
DEBUG_INFO(DEBUG_CATEGORY_ROUTING, " %zu: %s/%d -> %s [%s]",
i + 1, network_str, entry->prefix_length, next_hop_str,
route_type_to_string(entry->type));
diff --git a/src/route_lib.h b/src/route_lib.h
index 29fa879..b52e7d7 100644
--- a/src/route_lib.h
+++ b/src/route_lib.h
@@ -32,29 +32,37 @@ typedef enum {
*
* Структура содержит дополнительные метрики для оценки качества маршрута.
*/
-struct route_metrics {
+struct ROUTE_METRICS {
+ uint32_t metric; /**< общее качество подсчитанное из метрик (меньше - лучше) */
uint32_t bandwidth_kbps; /**< Пропускная способность в Кбит/с */
- uint16_t packet_loss_rate; /**< Уровень потери пакетов (в промилле) */
+ uint16_t packet_loss_rate; /**< Уровень потери пакетов (x0.1%) */
uint16_t latency_ms; /**< Задержка в миллисекундах */
uint8_t hop_count; /**< Количество прыжков */
uint64_t last_updated; /**< Время последнего обновления (в микросекундах) */
};
+struct ROUTE_ARRAY {
+ uint32_t capacity;// max число элементов (для realloc)
+ uint32_t routes; /**< число маршрутов в массиве */
+ uint32_t ip; /**< адрес назначения */
+ struct ROUTE_ENTRY* entries[0]; /**< массив указателей на роуты */
+};
+
+
/**
* @brief Расширенная запись маршрута
*
* Структура представляет собой отдельную запись в таблице маршрутизации с детальной информацией о маршруте.
*/
-struct route_entry {
+struct ROUTE_ENTRY {
uint32_t network; /**< Сетевой адрес */
uint8_t prefix_length; /**< Длина префикса подсети */
struct ETCP_SOCKET* next_hop; /**< Указатель на сокет следующего хопа */
route_type_t type; /**< Тип маршрута */
uint8_t flags; /**< Флаги маршрута */
- struct route_metrics metrics; /**< Метрики маршрута */
+ struct ROUTE_METRICS metrics; /**< Метрики маршрута */
uint64_t created_time; /**< Время создания (в микросекундах) */
uint64_t last_update; /**< Время последнего обновления (в микросекундах) */
- uint64_t last_used; /**< Время последнего использования (в микросекундах) */
};
/**
@@ -62,8 +70,8 @@ struct route_entry {
*
* Структура представляет собой таблицу маршрутизации, содержащую записи маршрутов, подсети и статистику.
*/
-struct route_table {
- struct route_entry *entries; /**< Массив записей маршрутов */
+struct ROUTE_TABLE {
+ struct ROUTE_ENTRY *entries; /**< Массив записей маршрутов */
size_t count; /**< Текущее количество записей */
size_t capacity; /**< Максимальная емкость таблицы */
uint32_t *dynamic_subnets; /**< Динамические подсети (массив пар: сеть, префикс) */
@@ -71,18 +79,10 @@ struct route_table {
uint32_t *local_subnets; /**< Локальные подсети (массив пар: сеть, префикс) */
size_t local_subnet_count; /**< Количество локальных подсетей */
struct {
- uint64_t total_routes; /**< Общее количество маршрутов */
- uint64_t static_routes; /**< Количество статических маршрутов */
- uint64_t dynamic_routes; /**< Количество динамических маршрутов */
uint64_t local_routes; /**< Количество локальных маршрутов */
uint64_t learned_routes; /**< Количество изученных маршрутов */
- uint64_t routes_added; /**< Количество добавленных маршрутов */
- uint64_t routes_deleted; /**< Количество удаленных маршрутов */
- uint64_t lookup_count; /**< Количество запросов поиска */
- uint64_t hit_count; /**< Количество успешных поисков */
uint64_t routes_lookup_hits; /**< Количество попаданий в поиск маршрутов */
uint64_t routes_lookup_misses; /**< Количество промахов в поиск маршрутов */
- uint64_t validation_failures; /**< Количество неудачных валидаций */
} stats; /**< Статистика таблицы маршрутизации */
};
@@ -91,14 +91,14 @@ struct route_table {
*
* @return Указатель на созданную таблицу или NULL в случае ошибки
*/
-struct route_table *route_table_create(void);
+struct ROUTE_TABLE *route_table_create(void);
/**
* @brief Уничтожает таблицу маршрутизации и освобождает ресурсы
*
* @param table Указатель на таблицу маршрутизации
*/
-void route_table_destroy(struct route_table *table);
+void route_table_destroy(struct ROUTE_TABLE *table);
/**
* @brief Вставляет новую запись в таблицу маршрутизации
@@ -107,94 +107,34 @@ void route_table_destroy(struct route_table *table);
* @param entry Указатель на вставляемую запись маршрута
* @return true если вставка успешна, false иначе
*/
-bool route_table_insert(struct route_table *table, const struct route_entry *entry);
+bool route_table_insert(struct ROUTE_TABLE *table, const struct ROUTE_ENTRY *entry);
/**
* @brief Удаляет запись из таблицы маршрутизации
*
* @param table Указатель на таблицу маршрутизации
- * @param network Сетевой адрес
- * @param prefix_length Длина префикса
- * @param source_node_id Идентификатор источника узла
- * @return true если удаление успешно, false иначе
+ * @param conn соединение все роуты которого надо удалить
*/
-bool route_table_delete(struct route_table *table, uint32_t network, uint8_t prefix_length, uint32_t source_node_id);
+void route_table_delete(struct ROUTE_TABLE *table, struct ETCP_SOCKET* conn);
/**
- * @brief Выполняет поиск лучшего маршрута для заданного IP-адреса
+ * @brief Выполняет поиск доступных маршрутов для заданного IP-адреса, отсортированных по quality
+ * при поиске ищет готовый результат в кеше или добавляет в кеш новый результат и возвращает запись из кеша
*
* @param table Указатель на таблицу маршрутизации
* @param dest_ip Целевой IP-адрес
- * @param best_route Указатель на структуру для хранения лучшего маршрута
- * @return true если маршрут найден, false иначе
- */
-bool route_table_lookup(struct route_table *table, uint32_t dest_ip, struct route_entry *best_route);
-
-/**
- * @brief Валидирует маршрут на основе типа и подсетей
- *
- * @param table Указатель на таблицу маршрутизации
- * @param network Сетевой адрес
- * @param prefix_length Длина префикса
- * @param route_type Тип маршрута
- * @return true если маршрут валиден, false иначе
- */
-bool route_validate_route(struct route_table *table, uint32_t network, uint8_t prefix_length, route_type_t route_type);
-
-/**
- * @brief Добавляет динамическую подсеть в таблицу
- *
- * @param table Указатель на таблицу маршрутизации
- * @param network Сетевой адрес
- * @param prefix_length Длина префикса
- * @return true если добавление успешно, false иначе
- */
-bool route_add_dynamic_subnet(struct route_table *table, uint32_t network, uint8_t prefix_length);
-
-/**
- * @brief Добавляет локальную подсеть в таблицу
- *
- * @param table Указатель на таблицу маршрутизации
- * @param network Сетевой адрес
- * @param prefix_length Длина префикса
- * @return true если добавление успешно, false иначе
+ * @return структура с найденными маршрутами
*/
-bool route_add_local_subnet(struct route_table *table, uint32_t network, uint8_t prefix_length);
+struct ROUTE_ARRAY* route_table_lookup(struct ROUTE_TABLE *table, uint32_t dest_ip);
-/**
- * @brief Получает все маршруты для заданной сети и префикса
- *
- * @param table Указатель на таблицу маршрутизации
- * @param network Сетевой адрес
- * @param prefix_length Длина префикса
- * @param routes Указатель на массив маршрутов (будет выделен)
- * @param count Указатель на количество найденных маршрутов
- * @return true если операция успешна, false иначе
- */
-bool route_get_all_routes(const struct route_table *table, uint32_t network, uint8_t prefix_length, struct route_entry **routes, size_t *count);
+// пересчитывает quality на основе других метрик (rtt, %loss, hopcount). чем меньше quality - тем лучше
+bool route_update_quality(struct ROUTE_ENTRY *entry);
/**
* @brief Печатает содержимое таблицы маршрутизации
*
* @param table Указатель на таблицу маршрутизации
*/
-void route_table_print(const struct route_table *table);
-
-/**
- * @brief Преобразует тип маршрута в строковое представление
- *
- * @param type Тип маршрута
- * @return Строковое представление типа
- */
-const char* route_type_to_string(route_type_t type);
-
-/**
- * @brief Преобразует IP-адрес в строковое представление
- *
- * @param ip IP-адрес в сетевом формате
- * @param buffer Буфер для хранения строки (минимум 16 байт)
- * @return Указатель на буфер с строкой
- */
-char* ip_to_string(uint32_t ip, char *buffer);
+void route_table_print(const struct ROUTE_TABLE *table);
#endif // ROUTE_LIB_H
diff --git a/src/routing.txt b/src/routing.txt
new file mode 100644
index 0000000..32ca152
--- /dev/null
+++ b/src/routing.txt
@@ -0,0 +1,16 @@
+подсистема роутинга
+utun - это сеть узлов. у каждого узла есть собственные локальные подсети.
+и узлы обмениваются таблицой маршрутов между собой так чтобы у каждого была актуальная таблица подсетей всех узлов.
+маршрутами меняются только те подключения которые взяты из конфига.
+инициируется подключение, клиент отправляет свою таблицу. когда сервер принимает таблицу - сервер помечает что по этому маршруту надо обмениваться маршрутами, далее;
+- добавляет узел в список рассылки обновлений маршрутов
+- отправляет свою таблицу
+- добавляет в свою таблицу отсутствующие маршруты
+- если что-то добавил:
+ - рассылает измененные маршруты по списку рассылки
+- список рассылки - это linked-list очередей (также на базе ll_queue - каждый элемент = подписчик). один маршрут = одна отправленная кодограмма
+
+
+
+при подключении узла или изменении таблицы: узлы обмениваются изменениями таблиц маршрутов.
+то есть каждая запись в таблице имеет флаги - кому отправлена.
\ No newline at end of file
diff --git a/src/secure_channel.c1 b/src/secure_channel.c1
old mode 100755
new mode 100644
diff --git a/src/utun_instance.c b/src/utun_instance.c
index 34292da..5078900 100644
--- a/src/utun_instance.c
+++ b/src/utun_instance.c
@@ -92,7 +92,7 @@ struct UTUN_INSTANCE* utun_instance_create(struct UASYNC* ua, const char *config
// Add local subnets from config as static routes
struct CFG_ROUTE_ENTRY* subnet = instance->config->my_subnets;
while (subnet) {
- struct route_entry entry = {0};
+ struct ROUTE_ENTRY entry = {0};
entry.network = subnet->ip.addr.v4.s_addr; // Network byte order
entry.prefix_length = subnet->netmask;
entry.next_hop = NULL; // Local route
diff --git a/src/utun_instance.h b/src/utun_instance.h
index c05a51b..ab84839 100644
--- a/src/utun_instance.h
+++ b/src/utun_instance.h
@@ -10,7 +10,7 @@
// Forward declarations
struct utun_config;
struct uasync_s;
-struct route_table;
+struct ROUTE_TABLE;
struct ETCP_CONN;
struct ETCP_SOCKET;
struct tun_if;
@@ -23,7 +23,7 @@ struct UTUN_INSTANCE {
// TUN interface
struct tun_if* tun;
- struct route_table* rt;
+ struct ROUTE_TABLE* rt;
// Identification
uint64_t node_id;
diff --git a/tests/Makefile.am b/tests/Makefile.am
index 01c307d..61a82c7 100644
--- a/tests/Makefile.am
+++ b/tests/Makefile.am
@@ -1,75 +1,67 @@
# Tests Makefile.am for utun - all tests with new ll_queue library
-# All available tests with new ll_queue library
-check_PROGRAMS = test_etcp_crypto$(EXEEXT) \
- test_crypto$(EXEEXT) \
- test_etcp_two_instances$(EXEEXT) \
- test_etcp_simple_traffic$(EXEEXT) \
- test_etcp_minimal$(EXEEXT) \
- test_etcp_100_packets$(EXEEXT) \
- test_pkt_normalizer_etcp$(EXEEXT) \
- test_pkt_normalizer_standalone$(EXEEXT) \
- test_ll_queue$(EXEEXT) \
- test_ecc_encrypt$(EXEEXT) \
- test_intensive_memory_pool$(EXEEXT) \
- test_memory_pool_and_config$(EXEEXT) \
- test_packet_dump$(EXEEXT) \
- test_u_async_comprehensive$(EXEEXT) \
- test_u_async_performance$(EXEEXT) \
- test_debug_categories$(EXEEXT) \
- test_config_debug$(EXEEXT) \
- bench_timeout_heap$(EXEEXT) \
- bench_uasync_timeouts$(EXEEXT)
+# Object directories
+OBJDIR = $(top_builddir)/.objs/tests
+SRC_OBJDIR = $(top_builddir)/.objs/src
+TINYCRYPT_OBJDIR = $(top_builddir)/.objs/tinycrypt
+
+# All available tests
+check_PROGRAMS = \
+ test_etcp_crypto \
+ test_crypto \
+ test_etcp_two_instances \
+ test_etcp_simple_traffic \
+ test_etcp_minimal \
+ test_etcp_100_packets \
+ test_pkt_normalizer_etcp \
+ test_pkt_normalizer_standalone \
+ test_ll_queue \
+ test_ecc_encrypt \
+ test_intensive_memory_pool \
+ test_memory_pool_and_config \
+ test_packet_dump \
+ test_u_async_comprehensive \
+ test_u_async_performance \
+ test_debug_categories \
+ test_config_debug \
+ bench_timeout_heap \
+ bench_uasync_timeouts
# Basic includes
AM_CFLAGS = -I$(top_srcdir)/src -I$(top_srcdir)/lib -I$(top_srcdir)/tinycrypt/lib/include -I$(top_srcdir)/tinycrypt/lib/source
-# TinyCrypt source files
-TINYCRYPT_SRCS = \
- $(top_srcdir)/tinycrypt/lib/source/aes_encrypt.c \
- $(top_srcdir)/tinycrypt/lib/source/aes_decrypt.c \
- $(top_srcdir)/tinycrypt/lib/source/ccm_mode.c \
- $(top_srcdir)/tinycrypt/lib/source/cmac_mode.c \
- $(top_srcdir)/tinycrypt/lib/source/ctr_mode.c \
- $(top_srcdir)/tinycrypt/lib/source/ecc.c \
- $(top_srcdir)/tinycrypt/lib/source/ecc_dh.c \
- $(top_srcdir)/tinycrypt/lib/source/ecc_dsa.c \
- $(top_srcdir)/tinycrypt/lib/source/sha256.c \
- $(top_srcdir)/tinycrypt/lib/source/ecc_platform_specific.c \
- $(top_srcdir)/tinycrypt/lib/source/utils.c
-
-# TinyCrypt object files (used when not using OpenSSL)
+# TinyCrypt object files (in .objs directory)
TINYCRYPT_OBJS = \
- $(top_builddir)/tinycrypt/lib/source/utun-aes_encrypt.o \
- $(top_builddir)/tinycrypt/lib/source/utun-aes_decrypt.o \
- $(top_builddir)/tinycrypt/lib/source/utun-ccm_mode.o \
- $(top_builddir)/tinycrypt/lib/source/utun-cmac_mode.o \
- $(top_builddir)/tinycrypt/lib/source/utun-ctr_mode.o \
- $(top_builddir)/tinycrypt/lib/source/utun-ecc.o \
- $(top_builddir)/tinycrypt/lib/source/utun-ecc_dh.o \
- $(top_builddir)/tinycrypt/lib/source/utun-ecc_dsa.o \
- $(top_builddir)/tinycrypt/lib/source/utun-sha256.o \
- $(top_builddir)/tinycrypt/lib/source/utun-ecc_platform_specific.o \
- $(top_builddir)/tinycrypt/lib/source/utun-utils.o
-
-# Secure channel and CRC objects (always needed)
-SECURE_CHANNEL_OBJS = $(top_builddir)/src/utun-secure_channel.o $(top_builddir)/src/utun-crc32.o
-
-# ETCP core objects (always needed)
+ $(TINYCRYPT_OBJDIR)/aes_encrypt.o \
+ $(TINYCRYPT_OBJDIR)/aes_decrypt.o \
+ $(TINYCRYPT_OBJDIR)/ccm_mode.o \
+ $(TINYCRYPT_OBJDIR)/cmac_mode.o \
+ $(TINYCRYPT_OBJDIR)/ctr_mode.o \
+ $(TINYCRYPT_OBJDIR)/ecc.o \
+ $(TINYCRYPT_OBJDIR)/ecc_dh.o \
+ $(TINYCRYPT_OBJDIR)/ecc_dsa.o \
+ $(TINYCRYPT_OBJDIR)/sha256.o \
+ $(TINYCRYPT_OBJDIR)/ecc_platform_specific.o \
+ $(TINYCRYPT_OBJDIR)/utils.o
+
+# Secure channel and CRC objects
+SECURE_CHANNEL_OBJS = $(SRC_OBJDIR)/secure_channel.o $(SRC_OBJDIR)/crc32.o
+
+# ETCP core objects
ETCP_CORE_OBJS = \
- $(top_builddir)/src/utun-etcp.o \
- $(top_builddir)/src/utun-etcp_connections.o \
- $(top_builddir)/src/utun-etcp_loadbalancer.o \
- $(top_builddir)/src/utun-pkt_normalizer.o
+ $(SRC_OBJDIR)/etcp.o \
+ $(SRC_OBJDIR)/etcp_connections.o \
+ $(SRC_OBJDIR)/etcp_loadbalancer.o \
+ $(SRC_OBJDIR)/pkt_normalizer.o
-# Full ETCP objects (with config, routing, etc.)
+# Full ETCP objects
ETCP_FULL_OBJS = \
- $(top_builddir)/src/utun-config_parser.o \
- $(top_builddir)/src/utun-config_updater.o \
- $(top_builddir)/src/utun-route_lib.o \
- $(top_builddir)/src/utun-routing.o \
- $(top_builddir)/src/utun-tun_if.o \
- $(top_builddir)/src/utun-utun_instance.o \
+ $(SRC_OBJDIR)/config_parser.o \
+ $(SRC_OBJDIR)/config_updater.o \
+ $(SRC_OBJDIR)/route_lib.o \
+ $(SRC_OBJDIR)/routing.o \
+ $(SRC_OBJDIR)/tun_if.o \
+ $(SRC_OBJDIR)/utun_instance.o \
$(ETCP_CORE_OBJS)
# Common libraries
@@ -82,134 +74,102 @@ else
CRYPTO_LIBS = $(TINYCRYPT_OBJS)
endif
-# ETCP crypto test
+# Register tests
+TESTS = $(check_PROGRAMS)
+
+# Test definitions with standard automake variables
test_etcp_crypto_SOURCES = test_etcp_crypto.c
test_etcp_crypto_CFLAGS = -I$(top_srcdir)/src -I$(top_srcdir)/lib -I$(top_srcdir)/tinycrypt/lib/include -I$(top_srcdir)/tinycrypt/lib/source
test_etcp_crypto_LDADD = $(SECURE_CHANNEL_OBJS) $(CRYPTO_LIBS) $(COMMON_LIBS)
-# ETCP two instances test
+test_crypto_SOURCES = test_crypto.c
+test_crypto_CFLAGS = -I$(top_srcdir)/tinycrypt/lib/include -I$(top_srcdir)/tinycrypt/lib/source -I$(top_srcdir)/lib
+test_crypto_LDADD = $(TINYCRYPT_OBJS) $(COMMON_LIBS)
+
test_etcp_two_instances_SOURCES = test_etcp_two_instances.c
test_etcp_two_instances_CFLAGS = -I$(top_srcdir)/src -I$(top_srcdir)/lib -I$(top_srcdir)/tinycrypt/lib/include -I$(top_srcdir)/tinycrypt/lib/source
test_etcp_two_instances_LDADD = $(ETCP_FULL_OBJS) $(SECURE_CHANNEL_OBJS) $(CRYPTO_LIBS) $(COMMON_LIBS)
-# ETCP simple traffic test
test_etcp_simple_traffic_SOURCES = test_etcp_simple_traffic.c
test_etcp_simple_traffic_CFLAGS = -I$(top_srcdir)/src -I$(top_srcdir)/lib -I$(top_srcdir)/tinycrypt/lib/include -I$(top_srcdir)/tinycrypt/lib/source
test_etcp_simple_traffic_LDADD = $(ETCP_FULL_OBJS) $(SECURE_CHANNEL_OBJS) $(CRYPTO_LIBS) $(COMMON_LIBS)
-# ETCP minimal test
test_etcp_minimal_SOURCES = test_etcp_minimal.c
test_etcp_minimal_CFLAGS = -I$(top_srcdir)/src -I$(top_srcdir)/lib -I$(top_srcdir)/tinycrypt/lib/include -I$(top_srcdir)/tinycrypt/lib/source
test_etcp_minimal_LDADD = $(ETCP_FULL_OBJS) $(SECURE_CHANNEL_OBJS) $(CRYPTO_LIBS) $(COMMON_LIBS)
-# ETCP 100 packets test
test_etcp_100_packets_SOURCES = test_etcp_100_packets.c
test_etcp_100_packets_CFLAGS = -I$(top_srcdir)/src -I$(top_srcdir)/lib -I$(top_srcdir)/tinycrypt/lib/include -I$(top_srcdir)/tinycrypt/lib/source
test_etcp_100_packets_LDADD = $(ETCP_FULL_OBJS) $(SECURE_CHANNEL_OBJS) $(CRYPTO_LIBS) $(COMMON_LIBS)
-# Packet normalizer ETCP test
test_pkt_normalizer_etcp_SOURCES = test_pkt_normalizer_etcp.c
test_pkt_normalizer_etcp_CFLAGS = -I$(top_srcdir)/src -I$(top_srcdir)/lib -I$(top_srcdir)/tinycrypt/lib/include -I$(top_srcdir)/tinycrypt/lib/source
test_pkt_normalizer_etcp_LDADD = $(ETCP_FULL_OBJS) $(SECURE_CHANNEL_OBJS) $(CRYPTO_LIBS) $(COMMON_LIBS)
-# Standalone pkt_normalizer test with mock ETCP loopback
test_pkt_normalizer_standalone_SOURCES = test_pkt_normalizer_standalone.c
test_pkt_normalizer_standalone_CFLAGS = -I$(top_srcdir)/src -I$(top_srcdir)/lib -I$(top_srcdir)/tinycrypt/lib/include -I$(top_srcdir)/tinycrypt/lib/source
-test_pkt_normalizer_standalone_LDADD = $(top_builddir)/src/utun-pkt_normalizer.o $(top_builddir)/src/utun-route_lib.o $(top_builddir)/src/utun-routing.o $(TINYCRYPT_OBJS) $(COMMON_LIBS)
-
-# Basic crypto test (TinyCrypt only - no secure_channel)
-test_crypto_SOURCES = test_crypto.c
-test_crypto_CFLAGS = -I$(top_srcdir)/tinycrypt/lib/include -I$(top_srcdir)/tinycrypt/lib/source -I$(top_srcdir)/lib
-test_crypto_LDADD = $(TINYCRYPT_OBJS) $(COMMON_LIBS)
+test_pkt_normalizer_standalone_LDADD = $(SRC_OBJDIR)/pkt_normalizer.o $(SRC_OBJDIR)/route_lib.o $(SRC_OBJDIR)/routing.o $(TINYCRYPT_OBJS) $(COMMON_LIBS)
-# Working ll_queue test for xxx=0 architecture
test_ll_queue_SOURCES = test_ll_queue.c
test_ll_queue_CFLAGS = -I$(top_srcdir)/src -I$(top_srcdir)/lib
test_ll_queue_LDADD = $(COMMON_LIBS)
-# ECC encryption test (uses TinyCrypt directly, needs tinycrypt objects)
test_ecc_encrypt_SOURCES = test_ecc_encrypt.c
test_ecc_encrypt_CFLAGS = -I$(top_srcdir)/tinycrypt/lib/include -I$(top_srcdir)/tinycrypt/lib/source -I$(top_srcdir)/lib
test_ecc_encrypt_LDADD = $(SECURE_CHANNEL_OBJS) $(TINYCRYPT_OBJS) $(COMMON_LIBS) -lcrypto
-# Intensive memory pool test
test_intensive_memory_pool_SOURCES = test_intensive_memory_pool.c
test_intensive_memory_pool_CFLAGS = -I$(top_srcdir)/src -I$(top_srcdir)/lib
test_intensive_memory_pool_LDADD = $(COMMON_LIBS)
-# Memory pool and config test
test_memory_pool_and_config_SOURCES = test_memory_pool_and_config.c
test_memory_pool_and_config_CFLAGS = -I$(top_srcdir)/src -I$(top_srcdir)/lib
test_memory_pool_and_config_LDADD = $(COMMON_LIBS)
-# Packet dump test
test_packet_dump_SOURCES = test_packet_dump.c
test_packet_dump_CFLAGS = -I$(top_srcdir)/src -I$(top_srcdir)/lib
test_packet_dump_LDADD = $(COMMON_LIBS)
-# UASYNC comprehensive test
test_u_async_comprehensive_SOURCES = test_u_async_comprehensive.c
test_u_async_comprehensive_CFLAGS = -I$(top_srcdir)/src -I$(top_srcdir)/lib
test_u_async_comprehensive_LDADD = $(COMMON_LIBS)
-# UASYNC performance test
test_u_async_performance_SOURCES = test_u_async_performance.c
test_u_async_performance_CFLAGS = -I$(top_srcdir)/src -I$(top_srcdir)/lib
test_u_async_performance_LDADD = $(COMMON_LIBS)
-# Debug categories test
test_debug_categories_SOURCES = test_debug_categories.c
test_debug_categories_CFLAGS = -I$(top_srcdir)/src -I$(top_srcdir)/lib
test_debug_categories_LDADD = $(COMMON_LIBS)
-# Config debug test
test_config_debug_SOURCES = test_config_debug.c
test_config_debug_CFLAGS = -I$(top_srcdir)/src -I$(top_srcdir)/lib
-test_config_debug_LDADD = $(top_builddir)/src/utun-config_parser.o $(COMMON_LIBS)
+test_config_debug_LDADD = $(SRC_OBJDIR)/config_parser.o $(COMMON_LIBS)
-# Timeout heap benchmark
bench_timeout_heap_SOURCES = bench_timeout_heap.c
bench_timeout_heap_CFLAGS = -I$(top_srcdir)/lib
bench_timeout_heap_LDADD = $(COMMON_LIBS)
-# uasync zero timeout benchmark
bench_uasync_timeouts_SOURCES = bench_uasync_timeouts.c
bench_uasync_timeouts_CFLAGS = -I$(top_srcdir)/lib
bench_uasync_timeouts_LDADD = $(COMMON_LIBS)
-# Register tests
-TESTS = $(check_PROGRAMS)
-
-# Build rules for TinyCrypt objects (needed for test_crypto even with OpenSSL)
-$(top_builddir)/tinycrypt/lib/source/utun-aes_encrypt.o: $(top_srcdir)/tinycrypt/lib/source/aes_encrypt.c
- $(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -c -o $@ $<
-
-$(top_builddir)/tinycrypt/lib/source/utun-aes_decrypt.o: $(top_srcdir)/tinycrypt/lib/source/aes_decrypt.c
- $(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -c -o $@ $<
-
-$(top_builddir)/tinycrypt/lib/source/utun-ccm_mode.o: $(top_srcdir)/tinycrypt/lib/source/ccm_mode.c
- $(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -c -o $@ $<
-
-$(top_builddir)/tinycrypt/lib/source/utun-cmac_mode.o: $(top_srcdir)/tinycrypt/lib/source/cmac_mode.c
- $(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -c -o $@ $<
-
-$(top_builddir)/tinycrypt/lib/source/utun-ctr_mode.o: $(top_srcdir)/tinycrypt/lib/source/ctr_mode.c
- $(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -c -o $@ $<
-
-$(top_builddir)/tinycrypt/lib/source/utun-ecc.o: $(top_srcdir)/tinycrypt/lib/source/ecc.c
- $(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -c -o $@ $<
-
-$(top_builddir)/tinycrypt/lib/source/utun-ecc_dh.o: $(top_srcdir)/tinycrypt/lib/source/ecc_dh.c
- $(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -c -o $@ $<
-
-$(top_builddir)/tinycrypt/lib/source/utun-ecc_dsa.o: $(top_srcdir)/tinycrypt/lib/source/ecc_dsa.c
- $(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -c -o $@ $<
-
-$(top_builddir)/tinycrypt/lib/source/utun-sha256.o: $(top_srcdir)/tinycrypt/lib/source/sha256.c
- $(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -c -o $@ $<
-
-$(top_builddir)/tinycrypt/lib/source/utun-ecc_platform_specific.o: $(top_srcdir)/tinycrypt/lib/source/ecc_platform_specific.c
- $(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -c -o $@ $<
-
-$(top_builddir)/tinycrypt/lib/source/utun-utils.o: $(top_srcdir)/tinycrypt/lib/source/utils.c
- $(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -c -o $@ $<
+# After building tests, move their object files to shadow directory
+all-local: shadow-test-objects
+
+shadow-test-objects: $(check_PROGRAMS)
+ @$(MKDIR_P) $(OBJDIR)
+ @for prog in $(check_PROGRAMS); do \
+ prog_obj=$${prog}_OBJECTS; \
+ eval "objs=\"\$$prog_obj\""; \
+ for obj in $$objs; do \
+ if test -f "$$obj"; then \
+ mv -f "$$obj" $(OBJDIR)/ 2>/dev/null || true; \
+ fi; \
+ done; \
+ done
+
+# Clean
+clean-local:
+ -rm -f $(check_PROGRAMS)
+ -rm -rf $(OBJDIR)
diff --git a/tests/bench_timeout_heap b/tests/bench_timeout_heap
deleted file mode 100755
index a0b97ef..0000000
Binary files a/tests/bench_timeout_heap and /dev/null differ
diff --git a/tests/bench_uasync_timeouts b/tests/bench_uasync_timeouts
deleted file mode 100755
index 4bfba10..0000000
Binary files a/tests/bench_uasync_timeouts and /dev/null differ
diff --git a/tests/test_config_debug b/tests/test_config_debug
deleted file mode 100755
index e2a6b18..0000000
Binary files a/tests/test_config_debug and /dev/null differ
diff --git a/tests/test_crypto b/tests/test_crypto
deleted file mode 100755
index 043da27..0000000
Binary files a/tests/test_crypto and /dev/null differ
diff --git a/tests/test_debug_categories b/tests/test_debug_categories
deleted file mode 100755
index d8f80ec..0000000
Binary files a/tests/test_debug_categories and /dev/null differ
diff --git a/tests/test_ecc_encrypt b/tests/test_ecc_encrypt
deleted file mode 100755
index 7b28462..0000000
Binary files a/tests/test_ecc_encrypt and /dev/null differ
diff --git a/tests/test_etcp_100_packets b/tests/test_etcp_100_packets
deleted file mode 100755
index 2b32974..0000000
Binary files a/tests/test_etcp_100_packets and /dev/null differ
diff --git a/tests/test_etcp_crypto b/tests/test_etcp_crypto
deleted file mode 100755
index b155760..0000000
Binary files a/tests/test_etcp_crypto and /dev/null differ
diff --git a/tests/test_etcp_minimal b/tests/test_etcp_minimal
deleted file mode 100755
index 1624fe5..0000000
Binary files a/tests/test_etcp_minimal and /dev/null differ
diff --git a/tests/test_etcp_simple_traffic b/tests/test_etcp_simple_traffic
deleted file mode 100755
index 6b12cd7..0000000
Binary files a/tests/test_etcp_simple_traffic and /dev/null differ
diff --git a/tests/test_etcp_two_instances b/tests/test_etcp_two_instances
deleted file mode 100755
index cc2c697..0000000
Binary files a/tests/test_etcp_two_instances and /dev/null differ
diff --git a/tests/test_intensive_memory_pool b/tests/test_intensive_memory_pool
deleted file mode 100755
index 7bb8e16..0000000
Binary files a/tests/test_intensive_memory_pool and /dev/null differ
diff --git a/tests/test_ll_queue b/tests/test_ll_queue
deleted file mode 100755
index 368fa1a..0000000
Binary files a/tests/test_ll_queue and /dev/null differ
diff --git a/tests/test_memory_pool_and_config b/tests/test_memory_pool_and_config
deleted file mode 100755
index 6e40e75..0000000
Binary files a/tests/test_memory_pool_and_config and /dev/null differ
diff --git a/tests/test_packet_dump b/tests/test_packet_dump
deleted file mode 100755
index 05a1820..0000000
Binary files a/tests/test_packet_dump and /dev/null differ
diff --git a/tests/test_pkt_normalizer_etcp b/tests/test_pkt_normalizer_etcp
deleted file mode 100755
index 4846475..0000000
Binary files a/tests/test_pkt_normalizer_etcp and /dev/null differ
diff --git a/tests/test_pkt_normalizer_standalone b/tests/test_pkt_normalizer_standalone
deleted file mode 100755
index 221b8ce..0000000
Binary files a/tests/test_pkt_normalizer_standalone and /dev/null differ
diff --git a/tests/test_u_async_comprehensive b/tests/test_u_async_comprehensive
deleted file mode 100755
index f84e1cf..0000000
Binary files a/tests/test_u_async_comprehensive and /dev/null differ
diff --git a/tests/test_u_async_performance b/tests/test_u_async_performance
deleted file mode 100755
index 4a8b2aa..0000000
Binary files a/tests/test_u_async_performance and /dev/null differ
+
+
+
+Item 1
+ Item 2
+
+
+
+
+Item 1
+ Item 2
+
+
+```
+
+### Grid (Preferred for 2D layouts)
+
+```html
+
+Centered content
+
+
+
+
+Card 1
+ Card 2
+ Card 3
+
+
+ Content
+
+```
+
+### Container Patterns
+
+```html
+
+
+ Content
+
+
+
+
+ Content
+
+Main Heading
+Section Heading
+Subsection
+Minor Heading
+ + +Body text
+Secondary text
+Caption text
+``` + +### Font Loading + +**Always use Google Fonts**: + +```html + + + +``` + +**Apply in CSS**: + +```css +body { + font-family: 'Inter', sans-serif !important; +} +``` + +### Readability + +- **Line length**: 60-80 characters optimal +- **Line height**: 1.5-1.75 for body text +- **Font size**: Minimum 16px for body text +- **Contrast**: 4.5:1 minimum for normal text + +--- + +## Component Styling Patterns + +### Buttons + +```html + + + + + + + + +``` + +### Cards + +```html + +
+
+
+
+Card Title
+Card content
+
+
+```
+
+### Forms
+
+```html
+
+Interactive Card
+Hover for effect
+
+
+
+
+
+
+
+
+
+
+```
+
+---
+
+## Accessibility Standards
+
+### ARIA Labels
+
+```html
+
+
+
+
+
+```
+
+### Semantic HTML
+
+```html
+
+...
+
+...
+```
+
+### Focus States
+
+```css
+/* Always provide visible focus states */
+button:focus-visible {
+ outline: 2px solid var(--ring);
+ outline-offset: 2px;
+}
+
+/* Tailwind utility */
+
+```
+
+---
+
+## Performance Optimization
+
+### CSS Loading
+
+```html
+
+
+
+
+
+
+```
+
+### Image Optimization
+
+```html
+
+
+```
+
+### Critical CSS
+
+```html
+
+
+
+
+
+```
+
+---
+
+## Best Practices
+
+### Do's ✅
+
+- Use Tailwind utility classes for rapid development
+- Load Tailwind via script tag for JIT compilation
+- Use Flowbite as default component library
+- Ensure all designs are mobile-first responsive
+- Test at multiple breakpoints
+- Use semantic HTML elements
+- Provide ARIA labels for interactive elements
+- Use CSS custom properties for theming
+- Apply `!important` for framework overrides
+- Ensure proper color contrast (WCAG AA)
+
+### Don'ts ❌
+
+- Don't use Bootstrap blue without explicit request
+- Don't load Tailwind as a stylesheet
+- Don't skip responsive design
+- Don't use div soup (use semantic HTML)
+- Don't forget focus states
+- Don't hardcode colors (use theme variables)
+- Don't skip accessibility testing
+- Don't use tiny touch targets (<44px)
+- Don't mix color formats
+- Don't over-use `!important`
+
+---
+
+## Framework Alternatives
+
+If user requests a different framework:
+
+**Bootstrap**:
+```html
+
+
+```
+
+**Bulma**:
+```html
+
+```
+
+**Foundation**:
+```html
+
+
+```
+
+---
+
+## References
+
+- [Tailwind CSS Documentation](https://tailwindcss.com/docs)
+- [Flowbite Components](https://flowbite.com/docs/getting-started/introduction/)
+- [WCAG Guidelines](https://www.w3.org/WAI/WCAG21/quickref/)
+- [MDN Web Accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility)
diff --git a/.opencode/env.example b/.opencode/env.example
new file mode 100644
index 0000000..4d6ba21
--- /dev/null
+++ b/.opencode/env.example
@@ -0,0 +1,24 @@
+# Telegram Bot Configuration
+# Copy this file to .env and fill in your actual values
+
+# Your Telegram bot token (get from @BotFather)
+TELEGRAM_BOT_TOKEN=your_bot_token_here
+
+# Your chat ID (get by messaging your bot and checking the API)
+TELEGRAM_CHAT_ID=your_chat_id_here
+
+# Your bot username (optional, defaults to @OpenCode)
+TELEGRAM_BOT_USERNAME=@YourBotUsername
+
+# Idle timeout in milliseconds (default: 5 minutes = 300000ms)
+TELEGRAM_IDLE_TIMEOUT=300000
+
+# Check interval in milliseconds (default: 30 seconds = 30000ms)
+TELEGRAM_CHECK_INTERVAL=30000
+
+# Enable/disable the plugin (true/false)
+TELEGRAM_ENABLED=true
+
+# Gemini API Configuration
+# Get your API key from https://makersuite.google.com/app/apikey
+GEMINI_API_KEY=your_gemini_api_key_here
diff --git a/.opencode/skills/context7/README.md b/.opencode/skills/context7/README.md
new file mode 100644
index 0000000..bd53d61
--- /dev/null
+++ b/.opencode/skills/context7/README.md
@@ -0,0 +1,102 @@
+# Context7 Skill
+
+## Purpose
+
+Fetches **live, version-specific documentation** for external libraries and frameworks using the Context7 API. Ensures you always get current API patterns instead of potentially outdated training data.
+
+**Golden Rule**: Always fetch live docs for external libraries—training data may be outdated.
+
+## Quick Start
+
+### Recommended: Use ExternalScout Subagent
+
+The **ExternalScout** subagent is the recommended way to fetch external documentation. It handles:
+- Library detection
+- Query optimization
+- Documentation filtering and sorting
+- Formatted results with code examples
+
+**Invocation**:
+```
+Use ExternalScout to fetch documentation for [Library Name]: [your specific question]
+```
+
+**Example**:
+```
+Use ExternalScout to fetch documentation for Drizzle ORM: How do I set up modular schemas with PostgreSQL?
+```
+
+### Alternative: Direct Skill Usage
+
+You can also invoke the Context7 skill directly via bash:
+
+```bash
+# Step 1: Search for library
+curl -s "https://context7.com/api/v2/libs/search?libraryName=LIBRARY&query=TOPIC" | jq '.results[0]'
+
+# Step 2: Fetch documentation
+curl -s "https://context7.com/api/v2/context?libraryId=LIBRARY_ID&query=OPTIMIZED_QUERY&type=txt"
+```
+
+See `SKILL.md` for detailed API documentation.
+
+## Supported Libraries
+
+See `library-registry.md` for the complete list of supported libraries including:
+- **Database & ORM**: Drizzle, Prisma
+- **Authentication**: Better Auth, NextAuth.js, Clerk
+- **Frontend**: Next.js, React, TanStack Query/Router/Start
+- **Infrastructure**: Cloudflare Workers, AWS Lambda, Vercel
+- **UI**: Shadcn/ui, Radix UI, Tailwind CSS
+- **State**: Zustand, Jotai
+- **Validation**: Zod, React Hook Form
+- **Testing**: Vitest, Playwright
+
+## Workflow
+
+```
+User Query
+ ↓
+ContextScout (searches internal context)
+ ↓
+No internal context found
+ ↓
+ContextScout recommends ExternalScout
+ ↓
+ExternalScout invoked
+ ├─ Reads library-registry.md
+ ├─ Detects library
+ ├─ Loads query patterns
+ ├─ Fetches from Context7 API
+ ├─ Filters & sorts results
+ └─ Returns formatted documentation
+ ↓
+User receives current, actionable docs
+```
+
+## Files
+
+- **`SKILL.md`** - Context7 API documentation and usage
+- **`library-registry.md`** - Supported libraries, aliases, and query patterns
+- **`README.md`** - This file (overview and quick start)
+
+## Adding New Libraries
+
+To add a new library to the registry:
+
+1. Edit `library-registry.md`
+2. Add entry under appropriate category:
+ ```markdown
+ #### Library Name
+ - **Aliases**: `alias1`, `alias2`, `package-name`
+ - **Docs**: https://example.com/docs
+ - **Context7**: `use context7 for library-name`
+ - **Common topics**: topic1, topic2, topic3
+ ```
+3. (Optional) Add query optimization patterns
+4. ExternalScout will automatically detect the new library
+
+## Related
+
+- **ExternalScout**: `.opencode/agent/subagents/core/externalscout.md`
+- **ContextScout**: `.opencode/agent/subagents/core/contextscout.md`
diff --git a/.opencode/skills/context7/SKILL.md b/.opencode/skills/context7/SKILL.md
new file mode 100644
index 0000000..76160b2
--- /dev/null
+++ b/.opencode/skills/context7/SKILL.md
@@ -0,0 +1,85 @@
+---
+name: context7
+description: Retrieve up-to-date documentation for software libraries, frameworks, and components via the Context7 API. This skill should be used when looking up documentation for any programming library or framework, finding code examples for specific APIs or features, verifying correct usage of library functions, or obtaining current information about library APIs that may have changed since training.
+---
+
+# Context7
+
+## Overview
+
+This skill enables retrieval of current documentation for software libraries and components by querying the Context7 API via curl. Use it instead of relying on potentially outdated training data.
+
+## Workflow
+
+### Step 1: Search for the Library
+
+To find the Context7 library ID, query the search endpoint:
+
+```bash
+curl -s "https://context7.com/api/v2/libs/search?libraryName=LIBRARY_NAME&query=TOPIC" | jq '.results[0]'
+```
+
+**Parameters:**
+- `libraryName` (required): The library name to search for (e.g., "react", "nextjs", "fastapi", "axios")
+- `query` (required): A description of the topic for relevance ranking
+
+**Response fields:**
+- `id`: Library identifier for the context endpoint (e.g., `/websites/react_dev_reference`)
+- `title`: Human-readable library name
+- `description`: Brief description of the library
+- `totalSnippets`: Number of documentation snippets available
+
+### Step 2: Fetch Documentation
+
+To retrieve documentation, use the library ID from step 1:
+
+```bash
+curl -s "https://context7.com/api/v2/context?libraryId=LIBRARY_ID&query=TOPIC&type=txt"
+```
+
+**Parameters:**
+- `libraryId` (required): The library ID from search results
+- `query` (required): The specific topic to retrieve documentation for
+- `type` (optional): Response format - `json` (default) or `txt` (plain text, more readable)
+
+## Examples
+
+### React hooks documentation
+
+```bash
+# Find React library ID
+curl -s "https://context7.com/api/v2/libs/search?libraryName=react&query=hooks" | jq '.results[0].id'
+# Returns: "/websites/react_dev_reference"
+
+# Fetch useState documentation
+curl -s "https://context7.com/api/v2/context?libraryId=/websites/react_dev_reference&query=useState&type=txt"
+```
+
+### Next.js routing documentation
+
+```bash
+# Find Next.js library ID
+curl -s "https://context7.com/api/v2/libs/search?libraryName=nextjs&query=routing" | jq '.results[0].id'
+
+# Fetch app router documentation
+curl -s "https://context7.com/api/v2/context?libraryId=/vercel/next.js&query=app+router&type=txt"
+```
+
+### FastAPI dependency injection
+
+```bash
+# Find FastAPI library ID
+curl -s "https://context7.com/api/v2/libs/search?libraryName=fastapi&query=dependencies" | jq '.results[0].id'
+
+# Fetch dependency injection documentation
+curl -s "https://context7.com/api/v2/context?libraryId=/fastapi/fastapi&query=dependency+injection&type=txt"
+```
+
+## Tips
+
+- Use `type=txt` for more readable output
+- Use `jq` to filter and format JSON responses
+- Be specific with the `query` parameter to improve relevance ranking
+- If the first search result is not correct, check additional results in the array
+- URL-encode query parameters containing spaces (use `+` or `%20`)
+- No API key is required for basic usage (rate-limited)
\ No newline at end of file
diff --git a/.opencode/skills/context7/library-registry.md b/.opencode/skills/context7/library-registry.md
new file mode 100644
index 0000000..4c2f5d4
--- /dev/null
+++ b/.opencode/skills/context7/library-registry.md
@@ -0,0 +1,290 @@
+# External Library Registry
+
+## Purpose
+
+This file lists external libraries/frameworks that should use **ExternalScout** (via Context7) for live documentation instead of relying on potentially outdated training data.
+
+## When to Use This
+
+**ContextScout** checks this list when:
+1. User asks about a library/framework
+2. No internal context exists in `.opencode/context/development/frameworks/`
+3. Query matches a library name below
+
+**Action**: Recommend **ExternalScout** subagent
+
+---
+
+## Supported Libraries
+
+### Database & ORM
+
+#### Drizzle ORM
+- **Aliases**: `drizzle`, `drizzle-orm`, `drizzle orm`
+- **Docs**: https://orm.drizzle.team/
+- **Context7**: `use context7 for drizzle`
+- **Common topics**: schema organization, migrations, relational queries, transactions, TypeScript types
+
+#### Prisma
+- **Aliases**: `prisma`
+- **Docs**: https://www.prisma.io/docs
+- **Context7**: `use context7 for prisma`
+- **Common topics**: schema, migrations, client, relations, TypeScript
+
+---
+
+### Authentication
+
+#### Better Auth
+- **Aliases**: `better-auth`, `better auth`, `betterauth`
+- **Docs**: https://www.better-auth.com/docs
+- **Context7**: `use context7 for better-auth`
+- **Common topics**: Next.js integration, Drizzle adapter, social providers, session management, 2FA
+
+#### NextAuth.js
+- **Aliases**: `nextauth`, `next-auth`, `nextauth.js`
+- **Docs**: https://next-auth.js.org/
+- **Context7**: `use context7 for nextauth`
+- **Common topics**: providers, callbacks, sessions, JWT
+
+#### Clerk
+- **Aliases**: `clerk`
+- **Docs**: https://clerk.com/docs
+- **Context7**: `use context7 for clerk`
+- **Common topics**: authentication, user management, organizations
+
+---
+
+### Frontend Frameworks
+
+#### Next.js
+- **Aliases**: `nextjs`, `next.js`, `next`
+- **Docs**: https://nextjs.org/docs
+- **Context7**: `use context7 for nextjs`
+- **Common topics**: App Router, Server Actions, Server Components, routing, middleware, API routes
+
+#### React
+- **Aliases**: `react`, `reactjs`, `react.js`
+- **Docs**: https://react.dev/
+- **Context7**: `use context7 for react`
+- **Common topics**: hooks, components, state, effects, context
+
+#### TanStack Query
+- **Aliases**: `tanstack query`, `react query`, `@tanstack/react-query`
+- **Docs**: https://tanstack.com/query/latest
+- **Context7**: `use context7 for tanstack query`
+- **Common topics**: useQuery, useMutation, prefetching, caching, Server Components
+
+#### TanStack Router
+- **Aliases**: `tanstack router`, `@tanstack/react-router`
+- **Docs**: https://tanstack.com/router/latest
+- **Context7**: `use context7 for tanstack router`
+- **Common topics**: routing, type-safe routes, loaders, navigation
+
+#### TanStack Start
+- **Aliases**: `tanstack start`, `@tanstack/start`
+- **Docs**: https://tanstack.com/start/latest
+- **Context7**: `use context7 for tanstack start`
+- **Common topics**: full-stack setup, server functions, file routing
+
+---
+
+### Infrastructure & Deployment
+
+#### Cloudflare Workers
+- **Aliases**: `cloudflare workers`, `cloudflare`, `workers`, `cf workers`
+- **Docs**: https://developers.cloudflare.com/workers
+- **Context7**: `use context7 for cloudflare workers`
+- **Common topics**: routing, KV storage, Durable Objects, bindings, middleware
+
+#### AWS Lambda
+- **Aliases**: `aws lambda`, `lambda`, `aws λ`
+- **Docs**: https://docs.aws.amazon.com/lambda
+- **Context7**: `use context7 for aws lambda`
+- **Common topics**: handlers, layers, environment variables, triggers, TypeScript
+
+#### Vercel
+- **Aliases**: `vercel`
+- **Docs**: https://vercel.com/docs
+- **Context7**: `use context7 for vercel`
+- **Common topics**: deployment, environment variables, edge functions, serverless
+
+---
+
+### UI Libraries & Styling
+
+#### Shadcn/ui
+- **Aliases**: `shadcn`, `shadcn/ui`, `shadcn-ui`
+- **Docs**: https://ui.shadcn.com/
+- **Context7**: `use context7 for shadcn`
+- **Common topics**: components, installation, theming, customization
+
+#### Radix UI
+- **Aliases**: `radix`, `radix ui`, `radix-ui`, `@radix-ui`
+- **Docs**: https://www.radix-ui.com/
+- **Context7**: `use context7 for radix`
+- **Common topics**: primitives, accessibility, composition
+
+#### Tailwind CSS
+- **Aliases**: `tailwind`, `tailwindcss`, `tailwind css`
+- **Docs**: https://tailwindcss.com/docs
+- **Context7**: `use context7 for tailwind`
+- **Common topics**: configuration, utilities, responsive design, dark mode
+
+---
+
+### State Management
+
+#### Zustand
+- **Aliases**: `zustand`
+- **Docs**: https://zustand-demo.pmnd.rs/
+- **Context7**: `use context7 for zustand`
+- **Common topics**: store creation, selectors, middleware, TypeScript
+
+#### Jotai
+- **Aliases**: `jotai`
+- **Docs**: https://jotai.org/
+- **Context7**: `use context7 for jotai`
+- **Common topics**: atoms, async atoms, utilities
+
+---
+
+### Validation & Forms
+
+#### Zod
+- **Aliases**: `zod`
+- **Docs**: https://zod.dev/
+- **Context7**: `use context7 for zod`
+- **Common topics**: schema validation, TypeScript inference, parsing, refinements
+
+#### React Hook Form
+- **Aliases**: `react hook form`, `react-hook-form`, `rhf`
+- **Docs**: https://react-hook-form.com/
+- **Context7**: `use context7 for react hook form`
+- **Common topics**: register, validation, errors, TypeScript
+
+---
+
+### Testing
+
+#### Vitest
+- **Aliases**: `vitest`
+- **Docs**: https://vitest.dev/
+- **Context7**: `use context7 for vitest`
+- **Common topics**: configuration, testing, mocking, coverage
+
+#### Playwright
+- **Aliases**: `playwright`
+- **Docs**: https://playwright.dev/
+- **Context7**: `use context7 for playwright`
+- **Common topics**: browser automation, testing, selectors, assertions
+
+---
+
+## Detection Patterns
+
+ContextScout and ExternalScout should match queries containing:
+- Library name (case-insensitive)
+- Common variations (e.g., "next.js" vs "nextjs")
+- Package names (e.g., "@tanstack/react-query")
+
+**Examples**:
+- "How do I use **Drizzle** with PostgreSQL?" → Match: Drizzle ORM
+- "Show me **Next.js** App Router setup" → Match: Next.js
+- "**TanStack Query** with Server Components" → Match: TanStack Query
+- "**Better Auth** integration" → Match: Better Auth
+
+---
+
+## Query Optimization Patterns
+
+### Drizzle ORM
+
+| User Intent | Optimized Query |
+|-------------|-----------------|
+| Setup/Installation | `PostgreSQL+setup+configuration+TypeScript+installation` |
+| Modular schemas | `modular+schema+organization+domain+driven+design` |
+| Relations | `relational+queries+one+to+many+joins+with+relations` |
+| Migrations | `drizzle-kit+migrations+generate+push+PostgreSQL` |
+| Transactions | `database+transactions+patterns+TypeScript` |
+| Type safety | `TypeScript+type+inference+schema+types+inferInsert` |
+
+### Better Auth
+
+| User Intent | Optimized Query |
+|-------------|-----------------|
+| Setup | `setup+configuration+Next.js+TypeScript+installation` |
+| Next.js integration | `Next.js+App+Router+integration+setup+configuration` |
+| Drizzle adapter | `Drizzle+adapter+PostgreSQL+schema+generation+configuration` |
+| Social providers | `social+providers+OAuth+GitHub+Google+setup` |
+| Email/password | `email+password+authentication+signup+signin` |
+| Session management | `session+management+cookies+JWT+middleware` |
+
+### Next.js
+
+| User Intent | Optimized Query |
+|-------------|-----------------|
+| App Router | `App+Router+file+conventions+layouts+pages+routing` |
+| Server Actions | `Server+Actions+form+mutations+revalidation+TypeScript` |
+| Server Components | `React+Server+Components+async+data+fetching+patterns` |
+| Dynamic routes | `dynamic+routes+params+TypeScript+generateStaticParams` |
+| Middleware | `middleware+authentication+redirects+headers+cookies` |
+| API routes | `API+routes+route+handlers+TypeScript+POST+GET` |
+
+### TanStack Query
+
+| User Intent | Optimized Query |
+|-------------|-----------------|
+| Setup | `setup+QueryClient+provider+Next.js+TypeScript` |
+| Data fetching | `useQuery+data+fetching+TypeScript+patterns+async` |
+| Mutations | `useMutation+optimistic+updates+invalidation+TypeScript` |
+| Prefetching | `prefetchQuery+Server+Components+hydration+Next.js` |
+| Caching | `cache+configuration+staleTime+gcTime+invalidation` |
+
+### Cloudflare Workers
+
+| User Intent | Optimized Query |
+|-------------|-----------------|
+| Setup | `getting+started+setup+TypeScript+wrangler+configuration` |
+| Routing | `routing+itty-router+hono+request+handling` |
+| KV storage | `KV+storage+key+value+bindings+TypeScript` |
+| Durable Objects | `Durable+Objects+state+WebSockets+coordination` |
+
+### AWS Lambda
+
+| User Intent | Optimized Query |
+|-------------|-----------------|
+| Setup | `getting+started+setup+TypeScript+handler+configuration` |
+| Handlers | `handler+function+event+context+TypeScript+patterns` |
+| Layers | `layers+dependencies+shared+code+deployment` |
+| Environment variables | `environment+variables+secrets+configuration+SSM` |
+
+---
+
+## Adding New Libraries
+
+To add a new library:
+1. Add entry under appropriate category
+2. Include: Name, aliases, docs link, Context7 command, common topics
+3. (Optional) Add query optimization patterns
+4. Update ExternalScout if needed (usually automatic)
+
+**Template**:
+```markdown
+#### Library Name
+- **Aliases**: `alias1`, `alias2`, `package-name`
+- **Docs**: https://example.com/docs
+- **Context7**: `use context7 for library-name`
+- **Common topics**: topic1, topic2, topic3
+```
+
+---
+
+## Usage by ExternalScout
+
+ExternalScout uses this file to:
+1. **Detect** which library the user is asking about
+2. **Load** query optimization patterns for that library
+3. **Build** optimized Context7 queries
+4. **Fetch** live documentation
+5. **Return** filtered, relevant results
diff --git a/.opencode/skills/context7/navigation.md b/.opencode/skills/context7/navigation.md
new file mode 100644
index 0000000..30f848c
--- /dev/null
+++ b/.opencode/skills/context7/navigation.md
@@ -0,0 +1,51 @@
+# Context7 Skill Navigation
+
+**Purpose**: Live documentation fetching for external libraries via Context7 API
+
+---
+
+## Structure
+
+```
+context7/
+├── navigation.md # This file
+├── README.md # Quick start and workflow
+├── SKILL.md # Context7 API documentation
+└── library-registry.md # Supported libraries and query patterns
+```
+
+---
+
+## Quick Routes
+
+| Task | Path |
+|------|------|
+| **Quick start** | `README.md` |
+| **API reference** | `SKILL.md` |
+| **Supported libraries** | `library-registry.md` (lines 18-181) |
+| **Query patterns** | `library-registry.md` (lines 199-261) |
+| **Add new library** | `library-registry.md` (lines 264-279) |
+| **ExternalScout integration** | `README.md` (lines 9-26) |
+
+---
+
+## By Purpose
+
+**Using Context7**:
+- Quick start → `README.md`
+- API details → `SKILL.md`
+
+**Adding Libraries**:
+- Template → `library-registry.md` (lines 272-279)
+- Supported list → `library-registry.md` (lines 18-181)
+
+**Integration**:
+- ContextScout workflow → `README.md` (lines 54-73)
+- ExternalScout subagent → `.opencode/agent/subagents/core/externalscout.md`
+
+---
+
+## Related
+
+- **ExternalScout**: `.opencode/agent/subagents/core/externalscout.md`
+- **ContextScout**: `.opencode/agent/subagents/core/contextscout.md`
diff --git a/.opencode/skills/task-management/SKILL.md b/.opencode/skills/task-management/SKILL.md
new file mode 100644
index 0000000..8143066
--- /dev/null
+++ b/.opencode/skills/task-management/SKILL.md
@@ -0,0 +1,399 @@
+---
+name: task-management
+description: Task management CLI for tracking and managing feature subtasks with status, dependencies, and validation
+version: 1.0.0
+author: opencode
+type: skill
+category: development
+tags:
+ - tasks
+ - management
+ - tracking
+ - dependencies
+ - cli
+---
+
+# Task Management Skill
+
+> **Purpose**: Track, manage, and validate feature implementations with atomic task breakdowns, dependency resolution, and progress monitoring.
+
+---
+
+## What I Do
+
+I provide a command-line interface for managing task breakdowns created by the TaskManager subagent. I help you:
+
+- **Track progress** - See status of all features and their subtasks
+- **Find next tasks** - Show eligible tasks (dependencies satisfied)
+- **Identify blocked tasks** - See what's blocked and why
+- **Manage completion** - Mark subtasks as complete with summaries
+- **Validate integrity** - Check JSON files and dependency trees
+
+---
+
+## How to Use Me
+
+### Quick Start
+
+```bash
+# Show all task statuses
+bash .opencode/skills/task-management/router.sh status
+
+# Show next eligible tasks
+bash .opencode/skills/task-management/router.sh next
+
+# Show blocked tasks
+bash .opencode/skills/task-management/router.sh blocked
+
+# Mark a task complete
+bash .opencode/skills/task-management/router.sh complete