takomi 2.0.4

package/assets/.agent/skills/building-native-ui/references/zoom-transitions.md

@@ -0,0 +1,158 @@
+# Apple Zoom Transitions
+
+Fluid zoom transitions for navigating between screens. iOS 18+, Expo SDK 55+, Stack navigator only.
+
+```tsx
+import { Link } from "expo-router";
+```
+
+## Basic Zoom
+
+Use `withAppleZoom` on `Link.Trigger` to zoom the entire trigger element into the destination screen:
+
+```tsx
+<Link href="/photo" asChild>
+  <Link.Trigger withAppleZoom>
+    <Pressable>
+      <Image
+        source={{ uri: "https://example.com/thumb.jpg" }}
+        style={{ width: 120, height: 120, borderRadius: 12 }}
+      />
+    </Pressable>
+  </Link.Trigger>
+</Link>
+```
+
+## Targeted Zoom with `Link.AppleZoom`
+
+Wrap only the element that should animate. Siblings outside `Link.AppleZoom` are not part of the transition:
+
+```tsx
+<Link href="/photo" asChild>
+  <Link.Trigger>
+    <Pressable style={{ alignItems: "center" }}>
+      <Link.AppleZoom>
+        <Image
+          source={{ uri: "https://example.com/thumb.jpg" }}
+          style={{ width: 200, aspectRatio: 4 / 3 }}
+        />
+      </Link.AppleZoom>
+      <Text>Caption text (not zoomed)</Text>
+    </Pressable>
+  </Link.Trigger>
+</Link>
+```
+
+`Link.AppleZoom` accepts only a single child element.
+
+## Destination Target
+
+Use `Link.AppleZoomTarget` on the destination screen to align the zoom animation to a specific element:
+
+```tsx
+// Destination screen (e.g., app/photo.tsx)
+import { Link } from "expo-router";
+
+export default function PhotoScreen() {
+  return (
+    <View style={{ flex: 1 }}>
+      <Link.AppleZoomTarget>
+        <Image
+          source={{ uri: "https://example.com/full.jpg" }}
+          style={{ width: "100%", aspectRatio: 4 / 3 }}
+        />
+      </Link.AppleZoomTarget>
+      <Text>Photo details below</Text>
+    </View>
+  );
+}
+```
+
+Without a target, the zoom animates to fill the entire destination screen.
+
+## Custom Alignment Rectangle
+
+For manual control over where the zoom lands on the destination, use `alignmentRect` instead of `Link.AppleZoomTarget`:
+
+```tsx
+<Link.AppleZoom alignmentRect={{ x: 0, y: 0, width: 200, height: 300 }}>
+  <Image source={{ uri: "https://example.com/thumb.jpg" }} />
+</Link.AppleZoom>
+```
+
+Coordinates are in the destination screen's coordinate space. Prefer `Link.AppleZoomTarget` when possible — use `alignmentRect` only when the target element isn't available as a React component.
+
+## Controlling Dismissal
+
+Zoom screens support interactive dismissal gestures by default (pinch, swipe down when scrolled to top, swipe from leading edge). Use `usePreventZoomTransitionDismissal` on the destination screen to control this.
+
+### Disable all dismissal gestures
+
+```tsx
+import { usePreventZoomTransitionDismissal } from "expo-router";
+
+export default function PhotoScreen() {
+  usePreventZoomTransitionDismissal();
+  return <Image source={{ uri: "https://example.com/full.jpg" }} />;
+}
+```
+
+### Restrict dismissal to a specific area
+
+Use `unstable_dismissalBoundsRect` to prevent conflicts with scrollable content:
+
+```tsx
+usePreventZoomTransitionDismissal({
+  unstable_dismissalBoundsRect: {
+    minX: 0,
+    minY: 0,
+    maxX: 300,
+    maxY: 300,
+  },
+});
+```
+
+This is useful when the destination contains a zoomable scroll view — the system gives that scroll view precedence over the dismiss gesture.
+
+## Combining with Link.Preview
+
+Zoom transitions work alongside long-press previews:
+
+```tsx
+<Link href="/photo" asChild>
+  <Link.Trigger withAppleZoom>
+    <Pressable>
+      <Image
+        source={{ uri: "https://example.com/thumb.jpg" }}
+        style={{ width: 120, height: 120 }}
+      />
+    </Pressable>
+  </Link.Trigger>
+  <Link.Preview />
+</Link>
+```
+
+## Best Practices
+
+**Good use cases:**
+- Thumbnail → full image (gallery, profile photos)
+- Card → detail screen with similar visual content
+- Source and destination with similar aspect ratios
+
+**Avoid:**
+- Skinny full-width list rows as zoom sources — the transition looks unnatural
+- Mismatched aspect ratios between source and destination without `alignmentRect`
+- Using zoom with sheets or popovers — only works in Stack navigator
+- Hiding the navigation bar — known issues with header visibility during transitions
+
+**Tips:**
+- Always provide a close or back button — dismissal gestures are not discoverable
+- If the destination has a zoomable scroll view, use `unstable_dismissalBoundsRect` to avoid gesture conflicts
+- Source view doesn't need to match the tap target — only the `Link.AppleZoom` wrapped element animates
+- When source is unavailable (e.g., scrolled off screen), the transition zooms from the center of the screen
+
+## References
+
+- Expo Router Zoom Transitions: https://docs.expo.dev/router/advanced/zoom-transition/
+- Link.AppleZoom API: https://docs.expo.dev/versions/v55.0.0/sdk/router/#linkapplezoom
+- Apple UIKit Fluid Transitions: https://developer.apple.com/documentation/uikit/enhancing-your-app-with-fluid-transitions

package/assets/.agent/skills/code-review/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: code-review
+description: Run J-Star code review on staged changes. Analyze, fix P0/P1 issues, and iterate until clean.
+---
+
+# Code Review Skill
+
+Run the J-Star Reviewer on staged changes, allowing iterative fixing of issues.
+
+## When to Use
+- Before committing code changes
+- When code quality issues are mentioned
+- As a quality gate before merging
+- When user asks to "review this code"
+
+## Quick Start
+
+### 1. Build the Brain (First Time Only)
+```bash
+jstar init
+```
+
+### 2. Stage Changes
+```bash
+git add .
+```
+
+### 3. Run Review
+```bash
+# Standard review (staged changes)
+jstar review
+
+# Retroactive (already committed)
+jstar review --last
+
+# Branch/PR review (against main)
+jstar review --pr
+```
+
+## Fix Loop Protocol
+
+1. **Read Output**: Check `.jstar/last-review.md` or console
+2. **Prioritize**: Focus on **P0_CRITICAL** and **P1_HIGH** only
+3. **Loop Strategy**:
+   - If P0/P1 found → Fix → Stage → Re-review
+   - If only P2_MEDIUM → Consider "Good Enough"
+   - **MAX LOOPS: 3** — If issues persist, stop and ask user
+
+## Handling False Positives (Headless Mode)
+
+```bash
+# Start headless session
+jstar chat --headless
+
+# List issues
+echo '{"action": "list"}' | jstar chat --headless
+
+# Debate an issue
+echo '{"action": "debate", "issueId": 0, "argument": "This is correct because..."}' | jstar chat --headless
+
+# Exit
+echo '{"action": "exit"}' | jstar chat --headless
+```
+
+## AI Fix Cycle
+```
+1. jstar review --json  →  Parse findings
+2. Apply code fixes
+3. git add .            →  Stage changes
+4. jstar init           →  Update brain (if new files added)
+5. jstar review --json  →  Verify fixes
+6. Repeat until P0/P1 = 0
+```
+
+## Headless Commands
+| Action | Parameters | Description |
+|--------|------------|-------------|
+| `list` | — | List all current issues |
+| `debate` | `issueId`, `argument` | Challenge an issue |
+| `ignore` | `issueId` | Mark issue as ignored |
+| `exit` | — | End session, get final report |

package/assets/.agent/skills/component-analysis/SKILL.md

@@ -0,0 +1,103 @@
+---
+name: component-analysis
+description: Analyze a React/TypeScript component for compliance with coding guidelines and suggest improvements.
+---
+
+# Component Analysis Skill
+
+Analyze components for coding standards compliance and provide actionable improvements.
+
+## When to Use
+- Refactoring discussions
+- Before major component changes
+- When asked to "analyze" or "audit" a component
+- Code review of specific files
+
+## Analysis Process
+
+### 1. Identify Component
+Get from user or extract:
+- **Component Path**: Full file path
+- **Component Name**: The component name
+
+### 2. Initial Examination
+Read file and check:
+- Code structure and organization
+- Purpose and functionality
+- Immediate issues
+- **Total lines** (check 200-line rule)
+
+### 3. Coding Guidelines Check
+
+| Check | What to Look For |
+|-------|------------------|
+| **Size** | < 200 lines (refactor if exceeded) |
+| **Single Responsibility** | Does one thing well |
+| **TypeScript** | Proper types, interfaces for props |
+| **Naming** | PascalCase components, camelCase functions, handle* events |
+| **Hooks** | Proper use of React hooks and effects |
+| **Documentation** | TSDoc/JSDoc comments |
+| **Imports** | Organized, no unused imports |
+
+### 4. Styling Check
+
+| Check | What to Look For |
+|-------|------------------|
+| **Tailwind v4** | Using @theme integration |
+| **Color Tokens** | Using primary, accent, semantic tokens |
+| **Responsive** | Mobile-first (sm:, md:, lg:) |
+| **Dark Mode** | dark: variants |
+| **Performance** | Avoiding expensive backdrop-filter |
+
+### 5. Mobile-First Check
+- Mobile-first breakpoints
+- Touch-friendly interactions
+- Responsive typography
+- Container responsiveness
+
+### 6. Generate Report
+
+```markdown
+# Component Analysis: [Name]
+
+**File:** `[path]`
+**Lines:** [X] / 200 max
+**Score:** [X]/10
+
+## ✅ Compliant
+- [Things done well]
+
+## ⚠️ Warnings
+- [Minor issues]
+
+## ❌ Violations
+- [Critical issues]
+
+## 📋 Recommendations
+
+### High Priority
+1. [Critical fix]
+
+### Medium Priority
+1. [Improvement]
+
+## 🔧 Suggested Fixes
+[Before/After code examples]
+```
+
+### 7. Offer Next Steps
+- **A)** Implement high-priority fixes
+- **B)** Create feature documentation
+- **C)** Refactor if > 200 lines
+
+## Severity Levels
+- 🔴 **Critical**: Breaking functionality, security issues
+- 🟡 **Major**: Performance, accessibility violations
+- 🟢 **Minor**: Code style, documentation
+
+## Common Violations
+1. No TypeScript interface for props → Define `interface ComponentProps`
+2. useEffect missing dependencies → Add to dependency array
+3. Hardcoded colors → Use Tailwind tokens
+4. No dark mode → Add `dark:` variants
+5. Missing alt text → Add descriptive alt attributes

package/assets/.agent/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)

package/assets/.agent/skills/convex/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: convex
+displayName: Convex Development
+description: Umbrella skill for all Convex development patterns. Routes to specific skills like convex-functions, convex-realtime, convex-agents, etc.
+version: 1.0.0
+author: Convex
+tags: [convex, backend, database, realtime]
+---
+
+# Convex Development Skills
+
+This is an index skill for Convex development. Use specific skills for detailed guidance:
+
+## Core Development
+
+| Skill | Command | Use When |
+|-------|---------|----------|
+| Functions | `/convex-functions` | Writing queries, mutations, actions |
+| Schema | `/convex-schema-validator` | Defining database schemas and validators |
+| Realtime | `/convex-realtime` | Building reactive subscriptions |
+| HTTP Actions | `/convex-http-actions` | Webhooks and HTTP endpoints |
+
+## Data & Storage
+
+| Skill | Command | Use When |
+|-------|---------|----------|
+| File Storage | `/convex-file-storage` | File uploads, serving, storage |
+| Migrations | `/convex-migrations` | Schema evolution, data backfills |
+
+## Advanced Patterns
+
+| Skill | Command | Use When |
+|-------|---------|----------|
+| Agents | `/convex-agents` | Building AI agents with tools |
+| Cron Jobs | `/convex-cron-jobs` | Scheduled background tasks |
+| Components | `/convex-component-authoring` | Reusable Convex packages |
+
+## Security
+
+| Skill | Command | Use When |
+|-------|---------|----------|
+| Security Check | `/convex-security-check` | Quick security audit checklist |
+| Security Audit | `/convex-security-audit` | Deep security review |
+
+## Guidelines
+
+| Skill | Command | Use When |
+|-------|---------|----------|
+| Best Practices | `/convex-best-practices` | General patterns and guidelines |
+
+## Quick Start
+
+For most tasks:
+1. Start with `/convex-best-practices` for general patterns
+2. Use `/convex-functions` for writing backend logic
+3. Use `/convex-schema-validator` for data modeling
+4. Use specific skills as needed for your use case
+
+## Documentation
+
+- Primary: https://docs.convex.dev
+- LLM-optimized: https://docs.convex.dev/llms.txt

package/assets/.agent/skills/convex/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  icon_small: "./assets/small-logo.svg"
+  icon_large: "./assets/large-logo.png"

package/assets/.agent/skills/convex/assets/small-logo.svg

@@ -0,0 +1,17 @@
+<svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_3_23)">
+<g clip-path="url(#clip1_3_23)">
+<path d="M10.0643 12.5735C12.3769 12.3166 14.5572 11.0843 15.7577 9.02756C15.1892 14.1148 9.62646 17.3302 5.08583 15.356C4.66743 15.1746 4.30728 14.8728 4.06013 14.4848C3.03973 12.8825 2.7043 10.8437 3.18626 8.99344C4.56327 11.37 7.3632 12.8267 10.0643 12.5735Z" fill="#F3B01C"/>
+<path d="M3.1018 7.50072C2.16436 9.66714 2.12376 12.2034 3.27303 14.2907C-0.771507 11.2479 -0.72737 4.7362 3.2236 1.72378C3.58904 1.44535 4.02333 1.2801 4.47881 1.25494C6.3519 1.15614 8.25501 1.88006 9.58963 3.22909C6.87799 3.25604 4.23695 4.99308 3.1018 7.50072Z" fill="#8D2676"/>
+<path d="M10.8974 3.89562C9.52924 1.98794 7.38779 0.68921 5.04156 0.649695C9.57686 -1.40888 15.1555 1.92867 15.7629 6.86314C15.8194 7.32119 15.7452 7.78824 15.5421 8.20138C14.6948 9.92223 13.1236 11.2569 11.2876 11.7508C12.6328 9.25579 12.4668 6.20748 10.8974 3.89562Z" fill="#EE342F"/>
+</g>
+</g>
+<defs>
+<clipPath id="clip0_3_23">
+<rect width="16" height="16" fill="white"/>
+</clipPath>
+<clipPath id="clip1_3_23">
+<rect width="16" height="16" fill="white"/>
+</clipPath>
+</defs>
+</svg>