Merge pull request #12 from zenchantlive/feature/assign-archetypes-to-tasks-ui
Feature/assign archetypes to tasks UI
This commit is contained in:
zenchantlive
GitHub
commit
23bb125d81
552 changed files with 115365 additions and 1115 deletions
1930
.agent/skills/shadcn-ui/SKILL.md
Normal file
1930
.agent/skills/shadcn-ui/SKILL.md
Normal file
File diff suppressed because it is too large
Load diff
306
.agent/skills/shadcn-ui/references/chart.md
Normal file
306
.agent/skills/shadcn-ui/references/chart.md
Normal file
|
|
@ -0,0 +1,306 @@
|
|||
### shadcn/ui Chart Component - Installation
|
||||
|
||||
Source: https://ui.shadcn.com/docs/components/chart
|
||||
|
||||
The chart component in shadcn/ui is built on Recharts, providing direct access to all Recharts capabilities with consistent theming.
|
||||
|
||||
```bash
|
||||
npx shadcn@latest add chart
|
||||
```
|
||||
|
||||
--------------------------------
|
||||
|
||||
### shadcn/ui Chart Component - Basic Usage
|
||||
|
||||
Source: https://ui.shadcn.com/docs/components/chart
|
||||
|
||||
The ChartContainer wraps your Recharts component and accepts a config prop for theming. Requires `min-h-[value]` for responsiveness.
|
||||
|
||||
```tsx
|
||||
import { Bar, BarChart, CartesianGrid, XAxis, YAxis } from "recharts"
|
||||
import { ChartContainer, ChartTooltipContent } from "@/components/ui/chart"
|
||||
|
||||
const chartConfig = {
|
||||
desktop: {
|
||||
label: "Desktop",
|
||||
color: "var(--chart-1)",
|
||||
},
|
||||
mobile: {
|
||||
label: "Mobile",
|
||||
color: "var(--chart-2)",
|
||||
},
|
||||
} satisfies import("@/components/ui/chart").ChartConfig
|
||||
|
||||
const chartData = [
|
||||
{ month: "January", desktop: 186, mobile: 80 },
|
||||
{ month: "February", desktop: 305, mobile: 200 },
|
||||
{ month: "March", desktop: 237, mobile: 120 },
|
||||
]
|
||||
|
||||
export function BarChartDemo() {
|
||||
return (
|
||||
<ChartContainer config={chartConfig} className="min-h-[200px] w-full">
|
||||
<BarChart data={chartData}>
|
||||
<CartesianGrid vertical={false} />
|
||||
<XAxis dataKey="month" tickLine={false} axisLine={false} />
|
||||
<Bar dataKey="desktop" fill="var(--color-desktop)" radius={4} />
|
||||
<Bar dataKey="mobile" fill="var(--color-mobile)" radius={4} />
|
||||
<ChartTooltip content={<ChartTooltipContent />} />
|
||||
</BarChart>
|
||||
</ChartContainer>
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
--------------------------------
|
||||
|
||||
### shadcn/ui Chart Component - ChartConfig with Custom Colors
|
||||
|
||||
Source: https://ui.shadcn.com/docs/components/chart
|
||||
|
||||
You can define custom colors directly in the configuration using hex values or CSS variables.
|
||||
|
||||
```tsx
|
||||
const chartConfig = {
|
||||
desktop: {
|
||||
label: "Desktop",
|
||||
color: "#2563eb",
|
||||
theme: {
|
||||
light: "#2563eb",
|
||||
dark: "#60a5fa",
|
||||
},
|
||||
},
|
||||
mobile: {
|
||||
label: "Mobile",
|
||||
color: "var(--chart-2)",
|
||||
},
|
||||
} satisfies import("@/components/ui/chart").ChartConfig
|
||||
```
|
||||
|
||||
--------------------------------
|
||||
|
||||
### shadcn/ui Chart Component - CSS Variables
|
||||
|
||||
Source: https://ui.shadcn.com/docs/components/chart
|
||||
|
||||
Add chart color variables to your globals.css for consistent theming.
|
||||
|
||||
```css
|
||||
:root {
|
||||
/* Chart colors */
|
||||
--chart-1: oklch(0.646 0.222 41.116);
|
||||
--chart-2: oklch(0.6 0.118 184.704);
|
||||
--chart-3: oklch(0.546 0.198 38.228);
|
||||
--chart-4: oklch(0.596 0.151 343.253);
|
||||
--chart-5: oklch(0.546 0.158 49.157);
|
||||
}
|
||||
|
||||
.dark {
|
||||
--chart-1: oklch(0.488 0.243 264.376);
|
||||
--chart-2: oklch(0.696 0.17 162.48);
|
||||
--chart-3: oklch(0.698 0.141 24.311);
|
||||
--chart-4: oklch(0.676 0.172 171.196);
|
||||
--chart-5: oklch(0.578 0.192 302.85);
|
||||
}
|
||||
```
|
||||
|
||||
--------------------------------
|
||||
|
||||
### shadcn/ui Chart Component - Line Chart Example
|
||||
|
||||
Source: https://ui.shadcn.com/docs/components/chart
|
||||
|
||||
Creating a line chart with shadcn/ui charts component.
|
||||
|
||||
```tsx
|
||||
import { Line, LineChart, CartesianGrid, XAxis, YAxis } from "recharts"
|
||||
import { ChartContainer, ChartTooltipContent } from "@/components/ui/chart"
|
||||
|
||||
const chartConfig = {
|
||||
price: {
|
||||
label: "Price",
|
||||
color: "var(--chart-1)",
|
||||
},
|
||||
} satisfies import("@/components/ui/chart").ChartConfig
|
||||
|
||||
const chartData = [
|
||||
{ month: "January", price: 186 },
|
||||
{ month: "February", price: 305 },
|
||||
{ month: "March", price: 237 },
|
||||
{ month: "April", price: 203 },
|
||||
{ month: "May", price: 276 },
|
||||
]
|
||||
|
||||
export function LineChartDemo() {
|
||||
return (
|
||||
<ChartContainer config={chartConfig} className="min-h-[200px]">
|
||||
<LineChart data={chartData}>
|
||||
<CartesianGrid vertical={false} />
|
||||
<XAxis dataKey="month" tickLine={false} axisLine={false} />
|
||||
<YAxis tickLine={false} axisLine={false} tickFormatter={(value) => `$${value}`} />
|
||||
<Line
|
||||
dataKey="price"
|
||||
stroke="var(--color-price)"
|
||||
strokeWidth={2}
|
||||
dot={false}
|
||||
/>
|
||||
<ChartTooltip content={<ChartTooltipContent />} />
|
||||
</LineChart>
|
||||
</ChartContainer>
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
--------------------------------
|
||||
|
||||
### shadcn/ui Chart Component - Area Chart Example
|
||||
|
||||
Source: https://ui.shadcn.com/docs/components/chart
|
||||
|
||||
Creating an area chart with gradient fill and legend.
|
||||
|
||||
```tsx
|
||||
import { Area, AreaChart, XAxis, YAxis } from "recharts"
|
||||
import {
|
||||
ChartContainer,
|
||||
ChartLegend,
|
||||
ChartLegendContent,
|
||||
ChartTooltipContent,
|
||||
} from "@/components/ui/chart"
|
||||
|
||||
const chartConfig = {
|
||||
desktop: { label: "Desktop", color: "var(--chart-1)" },
|
||||
mobile: { label: "Mobile", color: "var(--chart-2)" },
|
||||
} satisfies import("@/components/ui/chart").ChartConfig
|
||||
|
||||
export function AreaChartDemo() {
|
||||
return (
|
||||
<ChartContainer config={chartConfig} className="min-h-[200px]">
|
||||
<AreaChart data={chartData}>
|
||||
<XAxis dataKey="month" tickLine={false} axisLine={false} />
|
||||
<YAxis tickLine={false} axisLine={false} />
|
||||
<Area
|
||||
dataKey="desktop"
|
||||
fill="var(--color-desktop)"
|
||||
stroke="var(--color-desktop)"
|
||||
fillOpacity={0.3}
|
||||
/>
|
||||
<Area
|
||||
dataKey="mobile"
|
||||
fill="var(--color-mobile)"
|
||||
stroke="var(--color-mobile)"
|
||||
fillOpacity={0.3}
|
||||
/>
|
||||
<ChartTooltip content={<ChartTooltipContent />} />
|
||||
<ChartLegend content={<ChartLegendContent />} />
|
||||
</AreaChart>
|
||||
</ChartContainer>
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
--------------------------------
|
||||
|
||||
### shadcn/ui Chart Component - Pie Chart Example
|
||||
|
||||
Source: https://ui.shadcn.com/docs/components/chart
|
||||
|
||||
Creating a pie/donut chart with shadcn/ui.
|
||||
|
||||
```tsx
|
||||
import { Pie, PieChart } from "recharts"
|
||||
import {
|
||||
ChartContainer,
|
||||
ChartLegend,
|
||||
ChartLegendContent,
|
||||
ChartTooltipContent,
|
||||
} from "@/components/ui/chart"
|
||||
|
||||
const chartConfig = {
|
||||
chrome: { label: "Chrome", color: "var(--chart-1)" },
|
||||
safari: { label: "Safari", color: "var(--chart-2)" },
|
||||
firefox: { label: "Firefox", color: "var(--chart-3)" },
|
||||
} satisfies import("@/components/ui/chart").ChartConfig
|
||||
|
||||
const pieData = [
|
||||
{ browser: "Chrome", visitors: 275, fill: "var(--color-chrome)" },
|
||||
{ browser: "Safari", visitors: 200, fill: "var(--color-safari)" },
|
||||
{ browser: "Firefox", visitors: 187, fill: "var(--color-firefox)" },
|
||||
]
|
||||
|
||||
export function PieChartDemo() {
|
||||
return (
|
||||
<ChartContainer config={chartConfig} className="min-h-[200px]">
|
||||
<PieChart>
|
||||
<Pie
|
||||
data={pieData}
|
||||
dataKey="visitors"
|
||||
nameKey="browser"
|
||||
cx="50%"
|
||||
cy="50%"
|
||||
outerRadius={80}
|
||||
/>
|
||||
<ChartTooltip content={<ChartTooltipContent />} />
|
||||
<ChartLegend content={<ChartLegendContent />} />
|
||||
</PieChart>
|
||||
</ChartContainer>
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
--------------------------------
|
||||
|
||||
### shadcn/ui ChartTooltipContent Props
|
||||
|
||||
Source: https://ui.shadcn.com/docs/components/chart
|
||||
|
||||
The ChartTooltipContent component accepts these props for customizing tooltip behavior.
|
||||
|
||||
| Prop | Type | Default | Description |
|
||||
|------|------|---------|-------------|
|
||||
| `labelKey` | string | "label" | Key for tooltip label |
|
||||
| `nameKey` | string | "name" | Key for tooltip name |
|
||||
| `indicator` | "dot" \| "line" \| "dashed" | "dot" | Indicator style |
|
||||
| `hideLabel` | boolean | false | Hide label |
|
||||
| `hideIndicator` | boolean | false | Hide indicator |
|
||||
|
||||
--------------------------------
|
||||
|
||||
### shadcn/ui Chart Component - Accessibility
|
||||
|
||||
Source: https://ui.shadcn.com/docs/components/chart
|
||||
|
||||
Enable keyboard navigation and screen reader support by adding the accessibilityLayer prop.
|
||||
|
||||
```tsx
|
||||
<BarChart accessibilityLayer data={chartData}>
|
||||
<CartesianGrid vertical={false} />
|
||||
<XAxis dataKey="month" />
|
||||
<Bar dataKey="desktop" fill="var(--color-desktop)" />
|
||||
<ChartTooltip content={<ChartTooltipContent />} />
|
||||
</BarChart>
|
||||
```
|
||||
|
||||
This adds:
|
||||
- Keyboard arrow key navigation
|
||||
- ARIA labels for chart elements
|
||||
- Screen reader announcements for data values
|
||||
|
||||
--------------------------------
|
||||
|
||||
### shadcn/ui Chart Component - Recharts Dependencies
|
||||
|
||||
Source: https://ui.shadcn.com/docs/components/chart
|
||||
|
||||
The chart component requires the following Recharts dependencies to be installed.
|
||||
|
||||
```bash
|
||||
pnpm add recharts
|
||||
npm install recharts
|
||||
yarn add recharts
|
||||
```
|
||||
|
||||
Recharts provides the following chart types:
|
||||
- Area, Bar, Line, Pie, Composed
|
||||
- Radar, RadialBar, Scatter
|
||||
- Funnel, Treemap
|
||||
145
.agent/skills/shadcn-ui/references/learn.md
Normal file
145
.agent/skills/shadcn-ui/references/learn.md
Normal file
|
|
@ -0,0 +1,145 @@
|
|||
# shadcn/ui Learning Guide
|
||||
|
||||
This guide helps you learn shadcn/ui from basics to advanced patterns.
|
||||
|
||||
## Learning Path
|
||||
|
||||
### 1. Understanding the Philosophy
|
||||
|
||||
shadcn/ui is different from traditional component libraries:
|
||||
|
||||
- **Copy-paste components**: Components are copied into your project, not installed as packages
|
||||
- **Full customization**: You own the code and can modify it freely
|
||||
- **Built on Radix UI**: Provides accessibility primitives
|
||||
- **Styled with Tailwind**: Uses utility classes for consistent styling
|
||||
|
||||
### 2. Core Concepts to Master
|
||||
|
||||
#### Class Variance Authority (CVA)
|
||||
Most components use CVA for variant management:
|
||||
|
||||
```tsx
|
||||
const buttonVariants = cva(
|
||||
"base-classes",
|
||||
{
|
||||
variants: {
|
||||
variant: {
|
||||
default: "variant-classes",
|
||||
destructive: "destructive-classes",
|
||||
},
|
||||
size: {
|
||||
default: "size-classes",
|
||||
sm: "small-classes",
|
||||
},
|
||||
},
|
||||
defaultVariants: {
|
||||
variant: "default",
|
||||
size: "default",
|
||||
},
|
||||
}
|
||||
)
|
||||
```
|
||||
|
||||
#### cn Utility Function
|
||||
The `cn` function combines classes and resolves conflicts:
|
||||
|
||||
```tsx
|
||||
import { clsx, type ClassValue } from "clsx"
|
||||
import { twMerge } from "tailwind-merge"
|
||||
|
||||
export function cn(...inputs: ClassValue[]) {
|
||||
return twMerge(clsx(inputs))
|
||||
}
|
||||
```
|
||||
|
||||
### 3. Installation Checklist
|
||||
|
||||
- [ ] Initialize a new project (Next.js, Vite, or Remix)
|
||||
- [ ] Install Tailwind CSS
|
||||
- [ ] Run `npx shadcn@latest init`
|
||||
- [ ] Configure CSS variables
|
||||
- [ ] Install first component: `npx shadcn@latest add button`
|
||||
|
||||
### 4. Essential Components to Learn First
|
||||
|
||||
1. **Button** - Learn variants and sizes
|
||||
2. **Input** - Form inputs with labels
|
||||
3. **Card** - Container components
|
||||
4. **Form** - Form handling with React Hook Form
|
||||
5. **Dialog** - Modal windows
|
||||
6. **Select** - Dropdown selections
|
||||
7. **Toast** - Notifications
|
||||
|
||||
### 5. Common Patterns
|
||||
|
||||
#### Form Pattern
|
||||
Every form follows this structure:
|
||||
|
||||
```tsx
|
||||
1. Define Zod schema
|
||||
2. Create form with useForm
|
||||
3. Wrap with Form component
|
||||
4. Add FormField for each input
|
||||
5. Handle submission
|
||||
```
|
||||
|
||||
#### Component Customization Pattern
|
||||
To customize a component:
|
||||
|
||||
1. Copy component to your project
|
||||
2. Modify the variants
|
||||
3. Add new props if needed
|
||||
4. Update types
|
||||
|
||||
### 6. Best Practices
|
||||
|
||||
- Always use TypeScript
|
||||
- Follow the existing component structure
|
||||
- Use semantic HTML when possible
|
||||
- Test with screen readers for accessibility
|
||||
- Keep components small and focused
|
||||
|
||||
### 7. Advanced Topics
|
||||
|
||||
- Creating custom components from scratch
|
||||
- Building complex forms with validation
|
||||
- Implementing dark mode
|
||||
- Optimizing for performance
|
||||
- Testing components
|
||||
|
||||
## Practice Exercises
|
||||
|
||||
### Exercise 1: Basic Setup
|
||||
1. Create a new Next.js project
|
||||
2. Set up shadcn/ui
|
||||
3. Install and customize a Button component
|
||||
4. Add a new variant "gradient"
|
||||
|
||||
### Exercise 2: Form Building
|
||||
1. Create a contact form with:
|
||||
- Name input (required)
|
||||
- Email input (email validation)
|
||||
- Message textarea (min length)
|
||||
- Submit button with loading state
|
||||
|
||||
### Exercise 3: Component Combination
|
||||
1. Build a settings page using:
|
||||
- Card for layout
|
||||
- Sheet for mobile menu
|
||||
- Select for dropdowns
|
||||
- Switch for toggles
|
||||
- Toast for notifications
|
||||
|
||||
### Exercise 4: Custom Component
|
||||
1. Create a custom Badge component
|
||||
2. Support variants: default, secondary, destructive, outline
|
||||
3. Support sizes: sm, default, lg
|
||||
4. Add icon support
|
||||
|
||||
## Resources
|
||||
|
||||
- [Official Documentation](https://ui.shadcn.com)
|
||||
- [GitHub Repository](https://github.com/shadcn/ui)
|
||||
- [Examples Gallery](https://ui.shadcn.com/examples)
|
||||
- [Radix UI Primitives](https://www.radix-ui.com/primitives)
|
||||
- [Tailwind CSS Documentation](https://tailwindcss.com/docs)
|
||||
1725
.agent/skills/shadcn-ui/references/official-ui-reference.md
Normal file
1725
.agent/skills/shadcn-ui/references/official-ui-reference.md
Normal file
File diff suppressed because it is too large
Load diff
586
.agent/skills/shadcn-ui/references/reference.md
Normal file
586
.agent/skills/shadcn-ui/references/reference.md
Normal file
|
|
@ -0,0 +1,586 @@
|
|||
# shadcn.io Component Library
|
||||
|
||||
shadcn.io is a comprehensive React UI component library built on shadcn/ui principles, providing developers with production-ready, composable components for modern web applications. The library serves as a centralized resource for React developers who need high-quality UI components with TypeScript support, ranging from basic interactive elements to advanced AI-powered integrations. Unlike traditional component libraries that require package installations, shadcn.io components are designed to be copied directly into your project, giving you full control and customization capabilities.
|
||||
|
||||
The library encompasses four major categories: composable UI components (terminal, dock, credit cards, QR codes, color pickers), chart components built with Recharts, animation components with Tailwind CSS integration, and custom React hooks for state management and lifecycle operations. Each component follows best practices for accessibility, performance, and developer experience, with comprehensive TypeScript definitions and Next.js compatibility. The platform emphasizes flexibility and customization, allowing developers to modify components at the source level rather than being constrained by package APIs.
|
||||
|
||||
## Core Components
|
||||
|
||||
### Terminal Component
|
||||
Interactive terminal emulator with typing animations and command execution simulation for developer-focused interfaces.
|
||||
|
||||
```tsx
|
||||
import { Terminal } from "@/components/ui/terminal"
|
||||
|
||||
export default function DemoTerminal() {
|
||||
return (
|
||||
npm install @repo/terminalInstalling dependencies...npm start
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
### Dock Component
|
||||
macOS-style application dock with smooth magnification effects on hover, perfect for navigation menus.
|
||||
|
||||
```tsx
|
||||
import { Dock, DockIcon } from "@/components/ui/dock"
|
||||
import { Home, Settings, User, Mail } from "lucide-react"
|
||||
|
||||
export default function AppDock() {
|
||||
return (
|
||||
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
### Credit Card Component
|
||||
Interactive 3D credit card component with flip animations for payment forms and card displays.
|
||||
|
||||
```tsx
|
||||
import { CreditCard } from "@/components/ui/credit-card"
|
||||
import { useState } from "react"
|
||||
|
||||
export default function PaymentForm() {
|
||||
const [cardData, setCardData] = useState({
|
||||
number: "4532 1234 5678 9010",
|
||||
holder: "JOHN DOE",
|
||||
expiry: "12/28",
|
||||
cvv: "123"
|
||||
})
|
||||
|
||||
return (
|
||||
console.log("Card flipped:", flipped)}
|
||||
/>
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
### Image Zoom Component
|
||||
Zoomable image component with smooth modal transitions for image galleries and product displays.
|
||||
|
||||
```tsx
|
||||
import { ImageZoom } from "@/components/ui/image-zoom"
|
||||
|
||||
export default function ProductGallery() {
|
||||
return (
|
||||
|
||||
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
### QR Code Component
|
||||
Generate and display customizable QR codes with styling options for links, contact information, and authentication.
|
||||
|
||||
```tsx
|
||||
import { QRCode } from "@/components/ui/qr-code"
|
||||
|
||||
export default function ShareDialog() {
|
||||
const shareUrl = "https://shadcn.io"
|
||||
|
||||
return (
|
||||
|
||||
|
||||
Scan to visit shadcn.io
|
||||
|
||||
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
### Color Picker Component
|
||||
Advanced color selection component supporting multiple color formats (HEX, RGB, HSL) with preview.
|
||||
|
||||
```tsx
|
||||
import { ColorPicker } from "@/components/ui/color-picker"
|
||||
import { useState } from "react"
|
||||
|
||||
export default function ThemeCustomizer() {
|
||||
const [color, setColor] = useState("#3b82f6")
|
||||
|
||||
return (
|
||||
|
||||
|
||||
Selected: {color}
|
||||
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
## Chart Components
|
||||
|
||||
### Bar Chart Component
|
||||
Clean bar chart component for data comparison and categorical analysis using Recharts.
|
||||
|
||||
```tsx
|
||||
import { BarChart } from "@/components/ui/bar-chart"
|
||||
|
||||
export default function SalesChart() {
|
||||
const data = [
|
||||
{ month: "Jan", sales: 4000, revenue: 2400 },
|
||||
{ month: "Feb", sales: 3000, revenue: 1398 },
|
||||
{ month: "Mar", sales: 2000, revenue: 9800 },
|
||||
{ month: "Apr", sales: 2780, revenue: 3908 },
|
||||
{ month: "May", sales: 1890, revenue: 4800 },
|
||||
{ month: "Jun", sales: 2390, revenue: 3800 }
|
||||
]
|
||||
|
||||
return (
|
||||
`$${value.toLocaleString()}`}
|
||||
yAxisWidth={60}
|
||||
/>
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
### Line Chart Component
|
||||
Smooth line chart for visualizing trends and time-series data with multiple data series support.
|
||||
|
||||
```tsx
|
||||
import { LineChart } from "@/components/ui/line-chart"
|
||||
|
||||
export default function MetricsChart() {
|
||||
const data = [
|
||||
{ date: "2024-01", users: 1200, sessions: 3400 },
|
||||
{ date: "2024-02", users: 1800, sessions: 4200 },
|
||||
{ date: "2024-03", users: 2400, sessions: 5800 },
|
||||
{ date: "2024-04", users: 3100, sessions: 7200 },
|
||||
{ date: "2024-05", users: 3800, sessions: 8900 }
|
||||
]
|
||||
|
||||
return (
|
||||
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
### Pie Chart Component
|
||||
Donut chart component for displaying proportional data and percentage distributions.
|
||||
|
||||
```tsx
|
||||
import { PieChart } from "@/components/ui/pie-chart"
|
||||
|
||||
export default function MarketShareChart() {
|
||||
const data = [
|
||||
{ name: "Product A", value: 400, fill: "#3b82f6" },
|
||||
{ name: "Product B", value: 300, fill: "#10b981" },
|
||||
{ name: "Product C", value: 300, fill: "#f59e0b" },
|
||||
{ name: "Product D", value: 200, fill: "#ef4444" }
|
||||
]
|
||||
|
||||
return (
|
||||
`${entry.name}: ${entry.value}`}
|
||||
/>
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
### Area Chart Component
|
||||
Stacked area chart for visualizing volume changes over time with multiple data series.
|
||||
|
||||
```tsx
|
||||
import { AreaChart } from "@/components/ui/area-chart"
|
||||
|
||||
export default function TrafficChart() {
|
||||
const data = [
|
||||
{ month: "Jan", mobile: 2000, desktop: 3000, tablet: 1000 },
|
||||
{ month: "Feb", mobile: 2200, desktop: 3200, tablet: 1100 },
|
||||
{ month: "Mar", mobile: 2800, desktop: 3800, tablet: 1300 },
|
||||
{ month: "Apr", mobile: 3200, desktop: 4200, tablet: 1500 },
|
||||
{ month: "May", mobile: 3800, desktop: 4800, tablet: 1800 }
|
||||
]
|
||||
|
||||
return (
|
||||
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
### Radar Chart Component
|
||||
Multi-axis chart for comparing multiple variables across different categories simultaneously.
|
||||
|
||||
```tsx
|
||||
import { RadarChart } from "@/components/ui/radar-chart"
|
||||
|
||||
export default function SkillsChart() {
|
||||
const data = [
|
||||
{ skill: "JavaScript", score: 85, industry: 75 },
|
||||
{ skill: "TypeScript", score: 80, industry: 70 },
|
||||
{ skill: "React", score: 90, industry: 80 },
|
||||
{ skill: "Node.js", score: 75, industry: 72 },
|
||||
{ skill: "CSS", score: 88, industry: 78 }
|
||||
]
|
||||
|
||||
return (
|
||||
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
### Mixed Chart Component
|
||||
Combined bar and line chart for displaying multiple data types with different visualization methods.
|
||||
|
||||
```tsx
|
||||
import { MixedChart } from "@/components/ui/mixed-chart"
|
||||
|
||||
export default function PerformanceChart() {
|
||||
const data = [
|
||||
{ month: "Jan", revenue: 4000, growth: 5.2 },
|
||||
{ month: "Feb", revenue: 4200, growth: 5.0 },
|
||||
{ month: "Mar", revenue: 4800, growth: 14.3 },
|
||||
{ month: "Apr", revenue: 5200, growth: 8.3 },
|
||||
{ month: "May", revenue: 5800, growth: 11.5 }
|
||||
]
|
||||
|
||||
return (
|
||||
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
## Animation Components
|
||||
|
||||
### Magnetic Effect Component
|
||||
Magnetic hover effect that smoothly follows cursor movement for interactive buttons and cards.
|
||||
|
||||
```tsx
|
||||
import { Magnetic } from "@/components/ui/magnetic"
|
||||
|
||||
export default function InteractiveButton() {
|
||||
return (
|
||||
|
||||
Hover me
|
||||
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
### Animated Cursor Component
|
||||
Custom animated cursor with interactive effects and particle trails for immersive experiences.
|
||||
|
||||
```tsx
|
||||
import { AnimatedCursor } from "@/components/ui/animated-cursor"
|
||||
|
||||
export default function Layout({ children }) {
|
||||
return (
|
||||
<>
|
||||
|
||||
{children}
|
||||
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
### Apple Hello Effect Component
|
||||
Recreation of Apple's iconic "hello" animation with multi-language text transitions.
|
||||
|
||||
```tsx
|
||||
import { AppleHello } from "@/components/ui/apple-hello"
|
||||
|
||||
export default function WelcomeScreen() {
|
||||
const greetings = [
|
||||
{ text: "Hello", lang: "en" },
|
||||
{ text: "Bonjour", lang: "fr" },
|
||||
{ text: "こんにちは", lang: "ja" },
|
||||
{ text: "Hola", lang: "es" },
|
||||
{ text: "你好", lang: "zh" }
|
||||
]
|
||||
|
||||
return (
|
||||
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
### Liquid Button Component
|
||||
Button with fluid liquid animation effect on hover for engaging call-to-action elements.
|
||||
|
||||
```tsx
|
||||
import { LiquidButton } from "@/components/ui/liquid-button"
|
||||
|
||||
export default function CTASection() {
|
||||
return (
|
||||
console.log("CTA clicked")}
|
||||
>
|
||||
Get Started
|
||||
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
### Rolling Text Component
|
||||
Text animation that creates a rolling effect with smooth character transitions.
|
||||
|
||||
```tsx
|
||||
import { RollingText } from "@/components/ui/rolling-text"
|
||||
|
||||
export default function AnimatedHeading() {
|
||||
return (
|
||||
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
### Shimmering Text Component
|
||||
Text with animated shimmer effect for attention-grabbing headings and highlights.
|
||||
|
||||
```tsx
|
||||
import { ShimmeringText } from "@/components/ui/shimmering-text"
|
||||
|
||||
export default function Hero() {
|
||||
return (
|
||||
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
## React Hooks
|
||||
|
||||
### useBoolean Hook
|
||||
Enhanced boolean state management with toggle, enable, and disable methods for cleaner component logic.
|
||||
|
||||
```tsx
|
||||
import { useBoolean } from "@/hooks/use-boolean"
|
||||
|
||||
export default function TogglePanel() {
|
||||
const modal = useBoolean(false)
|
||||
const loading = useBoolean(false)
|
||||
|
||||
const handleSubmit = async () => {
|
||||
loading.setTrue()
|
||||
try {
|
||||
await submitForm()
|
||||
modal.setFalse()
|
||||
} finally {
|
||||
loading.setFalse()
|
||||
}
|
||||
}
|
||||
|
||||
return (
|
||||
<>
|
||||
Toggle Modal
|
||||
{modal.value && (
|
||||
|
||||
|
||||
Status: {loading.value ? "Saving..." : "Ready"}
|
||||
|
||||
Submit
|
||||
|
||||
|
||||
)}
|
||||
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
### useCounter Hook
|
||||
Counter hook with increment, decrement, reset, and set functionality for numeric state management.
|
||||
|
||||
```tsx
|
||||
import { useCounter } from "@/hooks/use-counter"
|
||||
|
||||
export default function CartCounter() {
|
||||
const quantity = useCounter(0, { min: 0, max: 99 })
|
||||
|
||||
return (
|
||||
|
||||
|
||||
-
|
||||
{quantity.value}
|
||||
+
|
||||
|
||||
Reset
|
||||
|
||||
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
### useLocalStorage Hook
|
||||
Persist state in browser localStorage with automatic serialization and deserialization.
|
||||
|
||||
```tsx
|
||||
import { useLocalStorage } from "@/hooks/use-local-storage"
|
||||
|
||||
export default function UserPreferences() {
|
||||
const [theme, setTheme] = useLocalStorage("theme", "light")
|
||||
const [settings, setSettings] = useLocalStorage("settings", {
|
||||
notifications: true,
|
||||
emailUpdates: false
|
||||
})
|
||||
|
||||
return (
|
||||
|
||||
|
||||
setTheme(e.target.value)}>
|
||||
LightDark setSettings({
|
||||
...settings,
|
||||
notifications: e.target.checked
|
||||
})}
|
||||
/>
|
||||
Enable Notifications
|
||||
|
||||
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
### useDebounceValue Hook
|
||||
Debounce values to prevent excessive updates and API calls during rapid user input.
|
||||
|
||||
```tsx
|
||||
import { useDebounceValue } from "@/hooks/use-debounce-value"
|
||||
import { useState, useEffect } from "react"
|
||||
|
||||
export default function SearchBox() {
|
||||
const [search, setSearch] = useState("")
|
||||
const debouncedSearch = useDebounceValue(search, 500)
|
||||
const [results, setResults] = useState([])
|
||||
const [apiCalls, setApiCalls] = useState(0)
|
||||
|
||||
useEffect(() => {
|
||||
if (debouncedSearch) {
|
||||
setApiCalls(prev => prev + 1)
|
||||
fetch(`/api/search?q=${debouncedSearch}`)
|
||||
.then(res => res.json())
|
||||
.then(setResults)
|
||||
}
|
||||
}, [debouncedSearch])
|
||||
|
||||
return (
|
||||
|
||||
|
||||
setSearch(e.target.value)}
|
||||
placeholder="Search..."
|
||||
/>
|
||||
|
||||
|
||||
API calls: {apiCalls}
|
||||
|
||||
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
### useHover Hook
|
||||
Track hover state on elements with customizable enter and leave delays for tooltip and preview functionality.
|
||||
|
||||
```tsx
|
||||
import { useHover } from "@/hooks/use-hover"
|
||||
import { useRef } from "react"
|
||||
|
||||
export default function ImagePreview() {
|
||||
const hoverRef = useRef(null)
|
||||
const isHovering = useHover(hoverRef, {
|
||||
enterDelay: 200,
|
||||
leaveDelay: 100
|
||||
})
|
||||
|
||||
return (
|
||||
|
||||
|
||||
|
||||
{isHovering && (
|
||||
|
||||
|
||||
|
||||
|
||||
)}
|
||||
|
||||
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
### useCountdown Hook
|
||||
Countdown timer with play, pause, reset controls and completion callbacks for time-limited features.
|
||||
|
||||
```tsx
|
||||
import { useCountdown } from "@/hooks/use-countdown"
|
||||
|
||||
export default function OTPTimer() {
|
||||
const countdown = useCountdown({
|
||||
initialSeconds: 60,
|
||||
onComplete: () => alert("OTP expired! Request a new code.")
|
||||
})
|
||||
|
||||
return (
|
||||
|
||||
|
||||
{countdown.seconds}s
|
||||
|
||||
{!countdown.isRunning ? (
|
||||
Start
|
||||
) : (
|
||||
Pause
|
||||
)}
|
||||
Reset
|
||||
|
||||
Status: {countdown.isComplete ? "Expired" : countdown.isRunning ? "Active" : "Paused"}
|
||||
|
||||
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
## Installation and Usage
|
||||
|
||||
### CLI Installation
|
||||
Install components directly into your project using the shadcn CLI for instant integration.
|
||||
|
||||
```bash
|
||||
# Initialize shadcn in your project
|
||||
npx shadcn@latest init
|
||||
|
||||
# Add individual components
|
||||
npx shadcn@latest add terminal
|
||||
npx shadcn@latest add dock
|
||||
npx shadcn@latest add credit-card
|
||||
|
||||
# Add multiple components at once
|
||||
npx shadcn@latest add bar-chart line-chart pie-chart
|
||||
|
||||
# Add hooks
|
||||
npx shadcn@latest add use-boolean use-counter use-local-storage
|
||||
```
|
||||
|
||||
### Project Configuration
|
||||
Configure your project to work with shadcn.io components using TypeScript and Tailwind CSS.
|
||||
|
||||
```typescript
|
||||
// tailwind.config.ts
|
||||
import type { Config } from "tailwindcss"
|
||||
|
||||
const config: Config = {
|
||||
darkMode: ["class"],
|
||||
content: [
|
||||
"./pages/**/*.{ts,tsx}",
|
||||
"./components/**/*.{ts,tsx}",
|
||||
"./app/**/*.{ts,tsx}",
|
||||
],
|
||||
theme: {
|
||||
extend: {
|
||||
colors: {
|
||||
border: "hsl(var(--border))",
|
||||
input: "hsl(var(--input))",
|
||||
ring: "hsl(var(--ring))",
|
||||
background: "hsl(var(--background))",
|
||||
foreground: "hsl(var(--foreground))",
|
||||
primary: {
|
||||
DEFAULT: "hsl(var(--primary))",
|
||||
foreground: "hsl(var(--primary-foreground))",
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
plugins: [require("tailwindcss-animate")],
|
||||
}
|
||||
|
||||
export default config
|
||||
```
|
||||
|
||||
## Summary
|
||||
|
||||
The shadcn.io component library serves as a comprehensive toolkit for React developers building modern web applications with Next.js and TypeScript. The library's primary use cases include rapid prototyping of user interfaces, building data-rich dashboards with interactive charts, creating engaging user experiences with animations and effects, and implementing common UI patterns without writing boilerplate code. The copy-paste approach gives developers complete ownership of their components, allowing for deep customization while maintaining consistency with shadcn/ui design principles. Components are particularly well-suited for SaaS applications, admin panels, marketing websites, and e-commerce platforms that require professional, accessible UI elements.
|
||||
|
||||
Integration patterns center around composability and customization rather than rigid package dependencies. Developers can cherry-pick individual components using the CLI, modify them at the source level to match their design system, and combine them with existing shadcn/ui components for a cohesive interface. The library supports both light and dark themes through CSS variables, integrates seamlessly with Tailwind CSS utility classes, and follows React best practices for performance and accessibility. Custom hooks provide reusable logic patterns that complement the visual components, creating a complete ecosystem for building feature-rich applications. The TypeScript-first approach ensures type safety throughout the development process, while the Recharts integration for data visualization provides powerful charting capabilities without additional configuration overhead.
|
||||
1578
.agent/skills/shadcn-ui/references/ui-reference.md
Normal file
1578
.agent/skills/shadcn-ui/references/ui-reference.md
Normal file
File diff suppressed because it is too large
Load diff
288
.agents/skills/agent-browser/SKILL.md
Normal file
288
.agents/skills/agent-browser/SKILL.md
Normal file
|
|
@ -0,0 +1,288 @@
|
|||
---
|
||||
name: agent-browser
|
||||
description: |
|
||||
Browser automation for AI agents via inference.sh.
|
||||
Navigate web pages, interact with elements using @e refs, take screenshots, record video.
|
||||
Capabilities: web scraping, form filling, clicking, typing, drag-drop, file upload, JavaScript execution.
|
||||
Use for: web automation, data extraction, testing, agent browsing, research.
|
||||
Triggers: browser, web automation, scrape, navigate, click, fill form, screenshot,
|
||||
browse web, playwright, headless browser, web agent, surf internet, record video
|
||||
allowed-tools: Bash(infsh *)
|
||||
---
|
||||
|
||||
# Agentic Browser
|
||||
|
||||
|
||||
|
||||
Browser automation for AI agents via [inference.sh](https://inference.sh). Uses Playwright under the hood with a simple `@e` ref system for element interaction.
|
||||
|
||||
## Quick Start
|
||||
|
||||
```bash
|
||||
# Install CLI
|
||||
curl -fsSL https://cli.inference.sh | sh && infsh login
|
||||
|
||||
# Open a page and get interactive elements
|
||||
infsh app run agent-browser --function open --input '{"url": "https://example.com"}' --session new
|
||||
```
|
||||
|
||||
## Core Workflow
|
||||
|
||||
Every browser automation follows this pattern:
|
||||
|
||||
1. **Open** - Navigate to URL, get `@e` refs for elements
|
||||
2. **Interact** - Use refs to click, fill, drag, etc.
|
||||
3. **Re-snapshot** - After navigation/changes, get fresh refs
|
||||
4. **Close** - End session (returns video if recording)
|
||||
|
||||
```bash
|
||||
# 1. Start session
|
||||
RESULT=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "https://example.com/login"
|
||||
}')
|
||||
SESSION_ID=$(echo $RESULT | jq -r '.session_id')
|
||||
# Elements: @e1 [input] "Email", @e2 [input] "Password", @e3 [button] "Sign In"
|
||||
|
||||
# 2. Fill and submit
|
||||
infsh app run agent-browser --function interact --session $SESSION_ID --input '{
|
||||
"action": "fill", "ref": "@e1", "text": "user@example.com"
|
||||
}'
|
||||
infsh app run agent-browser --function interact --session $SESSION_ID --input '{
|
||||
"action": "fill", "ref": "@e2", "text": "password123"
|
||||
}'
|
||||
infsh app run agent-browser --function interact --session $SESSION_ID --input '{
|
||||
"action": "click", "ref": "@e3"
|
||||
}'
|
||||
|
||||
# 3. Re-snapshot after navigation
|
||||
infsh app run agent-browser --function snapshot --session $SESSION_ID --input '{}'
|
||||
|
||||
# 4. Close when done
|
||||
infsh app run agent-browser --function close --session $SESSION_ID --input '{}'
|
||||
```
|
||||
|
||||
## Functions
|
||||
|
||||
| Function | Description |
|
||||
|----------|-------------|
|
||||
| `open` | Navigate to URL, configure browser (viewport, proxy, video recording) |
|
||||
| `snapshot` | Re-fetch page state with `@e` refs after DOM changes |
|
||||
| `interact` | Perform actions using `@e` refs (click, fill, drag, upload, etc.) |
|
||||
| `screenshot` | Take page screenshot (viewport or full page) |
|
||||
| `execute` | Run JavaScript code on the page |
|
||||
| `close` | Close session, returns video if recording was enabled |
|
||||
|
||||
## Interact Actions
|
||||
|
||||
| Action | Description | Required Fields |
|
||||
|--------|-------------|-----------------|
|
||||
| `click` | Click element | `ref` |
|
||||
| `dblclick` | Double-click element | `ref` |
|
||||
| `fill` | Clear and type text | `ref`, `text` |
|
||||
| `type` | Type text (no clear) | `text` |
|
||||
| `press` | Press key (Enter, Tab, etc.) | `text` |
|
||||
| `select` | Select dropdown option | `ref`, `text` |
|
||||
| `hover` | Hover over element | `ref` |
|
||||
| `check` | Check checkbox | `ref` |
|
||||
| `uncheck` | Uncheck checkbox | `ref` |
|
||||
| `drag` | Drag and drop | `ref`, `target_ref` |
|
||||
| `upload` | Upload file(s) | `ref`, `file_paths` |
|
||||
| `scroll` | Scroll page | `direction` (up/down/left/right), `scroll_amount` |
|
||||
| `back` | Go back in history | - |
|
||||
| `wait` | Wait milliseconds | `wait_ms` |
|
||||
| `goto` | Navigate to URL | `url` |
|
||||
|
||||
## Element Refs
|
||||
|
||||
Elements are returned with `@e` refs:
|
||||
|
||||
```
|
||||
@e1 [a] "Home" href="/"
|
||||
@e2 [input type="text"] placeholder="Search"
|
||||
@e3 [button] "Submit"
|
||||
@e4 [select] "Choose option"
|
||||
@e5 [input type="checkbox"] name="agree"
|
||||
```
|
||||
|
||||
**Important:** Refs are invalidated after navigation. Always re-snapshot after:
|
||||
- Clicking links/buttons that navigate
|
||||
- Form submissions
|
||||
- Dynamic content loading
|
||||
|
||||
## Features
|
||||
|
||||
### Video Recording
|
||||
|
||||
Record browser sessions for debugging or documentation:
|
||||
|
||||
```bash
|
||||
# Start with recording enabled (optionally show cursor indicator)
|
||||
SESSION=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "https://example.com",
|
||||
"record_video": true,
|
||||
"show_cursor": true
|
||||
}' | jq -r '.session_id')
|
||||
|
||||
# ... perform actions ...
|
||||
|
||||
# Close to get the video file
|
||||
infsh app run agent-browser --function close --session $SESSION --input '{}'
|
||||
# Returns: {"success": true, "video": <File>}
|
||||
```
|
||||
|
||||
### Cursor Indicator
|
||||
|
||||
Show a visible cursor in screenshots and video (useful for demos):
|
||||
|
||||
```bash
|
||||
infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "https://example.com",
|
||||
"show_cursor": true,
|
||||
"record_video": true
|
||||
}'
|
||||
```
|
||||
|
||||
The cursor appears as a red dot that follows mouse movements and shows click feedback.
|
||||
|
||||
### Proxy Support
|
||||
|
||||
Route traffic through a proxy server:
|
||||
|
||||
```bash
|
||||
infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "https://example.com",
|
||||
"proxy_url": "http://proxy.example.com:8080",
|
||||
"proxy_username": "user",
|
||||
"proxy_password": "pass"
|
||||
}'
|
||||
```
|
||||
|
||||
### File Upload
|
||||
|
||||
Upload files to file inputs:
|
||||
|
||||
```bash
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "upload",
|
||||
"ref": "@e5",
|
||||
"file_paths": ["/path/to/file.pdf"]
|
||||
}'
|
||||
```
|
||||
|
||||
### Drag and Drop
|
||||
|
||||
Drag elements to targets:
|
||||
|
||||
```bash
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "drag",
|
||||
"ref": "@e1",
|
||||
"target_ref": "@e2"
|
||||
}'
|
||||
```
|
||||
|
||||
### JavaScript Execution
|
||||
|
||||
Run custom JavaScript:
|
||||
|
||||
```bash
|
||||
infsh app run agent-browser --function execute --session $SESSION --input '{
|
||||
"code": "document.querySelectorAll(\"h2\").length"
|
||||
}'
|
||||
# Returns: {"result": "5", "screenshot": <File>}
|
||||
```
|
||||
|
||||
## Deep-Dive Documentation
|
||||
|
||||
| Reference | Description |
|
||||
|-----------|-------------|
|
||||
| [references/commands.md](references/commands.md) | Full function reference with all options |
|
||||
| [references/snapshot-refs.md](references/snapshot-refs.md) | Ref lifecycle, invalidation rules, troubleshooting |
|
||||
| [references/session-management.md](references/session-management.md) | Session persistence, parallel sessions |
|
||||
| [references/authentication.md](references/authentication.md) | Login flows, OAuth, 2FA handling |
|
||||
| [references/video-recording.md](references/video-recording.md) | Recording workflows for debugging |
|
||||
| [references/proxy-support.md](references/proxy-support.md) | Proxy configuration, geo-testing |
|
||||
|
||||
## Ready-to-Use Templates
|
||||
|
||||
| Template | Description |
|
||||
|----------|-------------|
|
||||
| [templates/form-automation.sh](templates/form-automation.sh) | Form filling with validation |
|
||||
| [templates/authenticated-session.sh](templates/authenticated-session.sh) | Login once, reuse session |
|
||||
| [templates/capture-workflow.sh](templates/capture-workflow.sh) | Content extraction with screenshots |
|
||||
|
||||
## Examples
|
||||
|
||||
### Form Submission
|
||||
|
||||
```bash
|
||||
SESSION=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "https://example.com/contact"
|
||||
}' | jq -r '.session_id')
|
||||
|
||||
# Get elements: @e1 [input] "Name", @e2 [input] "Email", @e3 [textarea], @e4 [button] "Send"
|
||||
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{"action": "fill", "ref": "@e1", "text": "John Doe"}'
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{"action": "fill", "ref": "@e2", "text": "john@example.com"}'
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{"action": "fill", "ref": "@e3", "text": "Hello!"}'
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{"action": "click", "ref": "@e4"}'
|
||||
|
||||
infsh app run agent-browser --function snapshot --session $SESSION --input '{}'
|
||||
infsh app run agent-browser --function close --session $SESSION --input '{}'
|
||||
```
|
||||
|
||||
### Search and Extract
|
||||
|
||||
```bash
|
||||
SESSION=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "https://google.com"
|
||||
}' | jq -r '.session_id')
|
||||
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{"action": "fill", "ref": "@e1", "text": "weather today"}'
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{"action": "press", "text": "Enter"}'
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{"action": "wait", "wait_ms": 2000}'
|
||||
|
||||
infsh app run agent-browser --function snapshot --session $SESSION --input '{}'
|
||||
infsh app run agent-browser --function close --session $SESSION --input '{}'
|
||||
```
|
||||
|
||||
### Screenshot with Video
|
||||
|
||||
```bash
|
||||
SESSION=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "https://example.com",
|
||||
"record_video": true
|
||||
}' | jq -r '.session_id')
|
||||
|
||||
# Take full page screenshot
|
||||
infsh app run agent-browser --function screenshot --session $SESSION --input '{
|
||||
"full_page": true
|
||||
}'
|
||||
|
||||
# Close and get video
|
||||
RESULT=$(infsh app run agent-browser --function close --session $SESSION --input '{}')
|
||||
echo $RESULT | jq '.video'
|
||||
```
|
||||
|
||||
## Sessions
|
||||
|
||||
Browser state persists within a session. Always:
|
||||
|
||||
1. Start with `--session new` on first call
|
||||
2. Use returned `session_id` for subsequent calls
|
||||
3. Close session when done
|
||||
|
||||
## Related Skills
|
||||
|
||||
```bash
|
||||
# Web search (for research + browse)
|
||||
npx skills add inferencesh/skills@web-search
|
||||
|
||||
# LLM models (analyze extracted content)
|
||||
npx skills add inferencesh/skills@llm-models
|
||||
```
|
||||
|
||||
## Documentation
|
||||
|
||||
- [inference.sh Sessions](https://inference.sh/docs/extend/sessions) - Session management
|
||||
- [Multi-function Apps](https://inference.sh/docs/extend/multi-function-apps) - How functions work
|
||||
297
.agents/skills/agent-browser/references/authentication.md
Normal file
297
.agents/skills/agent-browser/references/authentication.md
Normal file
|
|
@ -0,0 +1,297 @@
|
|||
# Authentication Patterns
|
||||
|
||||
Login flows, OAuth, 2FA, and authenticated browsing.
|
||||
|
||||
**Related**: [session-management.md](session-management.md) for session details, [SKILL.md](../SKILL.md) for quick start.
|
||||
|
||||
## Contents
|
||||
|
||||
- [Basic Login Flow](#basic-login-flow)
|
||||
- [OAuth / SSO Flows](#oauth--sso-flows)
|
||||
- [Two-Factor Authentication](#two-factor-authentication)
|
||||
- [Session Reuse Patterns](#session-reuse-patterns)
|
||||
- [Cookie Extraction](#cookie-extraction)
|
||||
- [Security Best Practices](#security-best-practices)
|
||||
|
||||
## Basic Login Flow
|
||||
|
||||
Standard username/password login:
|
||||
|
||||
```bash
|
||||
#!/bin/bash
|
||||
|
||||
# Start session
|
||||
SESSION=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "https://app.example.com/login"
|
||||
}' | jq -r '.session_id')
|
||||
|
||||
# Get form elements
|
||||
# Expected: @e1 [input type="email"], @e2 [input type="password"], @e3 [button] "Sign In"
|
||||
|
||||
# Fill credentials
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "fill", "ref": "@e1", "text": "user@example.com"
|
||||
}'
|
||||
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "fill", "ref": "@e2", "text": "'"$PASSWORD"'"
|
||||
}'
|
||||
|
||||
# Submit
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "click", "ref": "@e3"
|
||||
}'
|
||||
|
||||
# Wait for redirect
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "wait", "wait_ms": 2000
|
||||
}'
|
||||
|
||||
# Verify login succeeded
|
||||
RESULT=$(infsh app run agent-browser --function snapshot --session $SESSION --input '{}')
|
||||
URL=$(echo $RESULT | jq -r '.url')
|
||||
|
||||
if [[ "$URL" == *"/login"* ]]; then
|
||||
echo "Login failed - still on login page"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
echo "Login successful"
|
||||
# Continue with authenticated actions...
|
||||
```
|
||||
|
||||
## OAuth / SSO Flows
|
||||
|
||||
For OAuth redirects (Google, GitHub, etc.):
|
||||
|
||||
```bash
|
||||
#!/bin/bash
|
||||
|
||||
SESSION=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "https://app.example.com/auth/google"
|
||||
}' | jq -r '.session_id')
|
||||
|
||||
# Wait for redirect to Google
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "wait", "wait_ms": 3000
|
||||
}'
|
||||
|
||||
# Snapshot to see Google login form
|
||||
RESULT=$(infsh app run agent-browser --function snapshot --session $SESSION --input '{}')
|
||||
echo $RESULT | jq '.elements_text'
|
||||
|
||||
# Fill Google email
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "fill", "ref": "@e1", "text": "user@gmail.com"
|
||||
}'
|
||||
|
||||
# Click Next
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "click", "ref": "@e2"
|
||||
}'
|
||||
|
||||
# Wait and snapshot for password field
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "wait", "wait_ms": 2000
|
||||
}'
|
||||
RESULT=$(infsh app run agent-browser --function snapshot --session $SESSION --input '{}')
|
||||
|
||||
# Fill password
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "fill", "ref": "@e1", "text": "'"$GOOGLE_PASSWORD"'"
|
||||
}'
|
||||
|
||||
# Click Sign in
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "click", "ref": "@e2"
|
||||
}'
|
||||
|
||||
# Wait for redirect back to app
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "wait", "wait_ms": 5000
|
||||
}'
|
||||
|
||||
# Verify we're back on the app
|
||||
RESULT=$(infsh app run agent-browser --function snapshot --session $SESSION --input '{}')
|
||||
URL=$(echo $RESULT | jq -r '.url')
|
||||
echo "Final URL: $URL"
|
||||
```
|
||||
|
||||
## Two-Factor Authentication
|
||||
|
||||
For 2FA, you may need human intervention or TOTP generation:
|
||||
|
||||
### With TOTP Code
|
||||
|
||||
```bash
|
||||
# After password, check for 2FA prompt
|
||||
RESULT=$(infsh app run agent-browser --function snapshot --session $SESSION --input '{}')
|
||||
ELEMENTS=$(echo $RESULT | jq -r '.elements_text')
|
||||
|
||||
if echo "$ELEMENTS" | grep -qi "verification\|2fa\|authenticator"; then
|
||||
# Generate TOTP code (requires oathtool)
|
||||
TOTP_CODE=$(oathtool --totp -b "$TOTP_SECRET")
|
||||
|
||||
# Fill 2FA code
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "fill", "ref": "@e1", "text": "'"$TOTP_CODE"'"
|
||||
}'
|
||||
|
||||
# Submit
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "click", "ref": "@e2"
|
||||
}'
|
||||
fi
|
||||
```
|
||||
|
||||
### With Manual Intervention
|
||||
|
||||
For SMS or hardware token 2FA:
|
||||
|
||||
```bash
|
||||
# Record video so user can see the 2FA prompt
|
||||
SESSION=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "https://app.example.com/login",
|
||||
"record_video": true
|
||||
}' | jq -r '.session_id')
|
||||
|
||||
# ... login flow ...
|
||||
|
||||
# At 2FA step, prompt user
|
||||
echo "2FA code sent. Enter the code:"
|
||||
read -r CODE
|
||||
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "fill", "ref": "@e1", "text": "'"$CODE"'"
|
||||
}'
|
||||
```
|
||||
|
||||
## Session Reuse Patterns
|
||||
|
||||
Since sessions maintain cookies, you can reuse authenticated sessions:
|
||||
|
||||
```bash
|
||||
#!/bin/bash
|
||||
# login-and-work.sh
|
||||
|
||||
# Login once
|
||||
login() {
|
||||
SESSION=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "https://app.example.com/login"
|
||||
}' | jq -r '.session_id')
|
||||
|
||||
# ... login steps ...
|
||||
|
||||
echo $SESSION
|
||||
}
|
||||
|
||||
# Do work with authenticated session
|
||||
do_work() {
|
||||
local SESSION=$1
|
||||
|
||||
# Navigate to protected page
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "goto", "url": "https://app.example.com/dashboard"
|
||||
}'
|
||||
|
||||
# Extract data
|
||||
infsh app run agent-browser --function snapshot --session $SESSION --input '{}'
|
||||
}
|
||||
|
||||
# Main
|
||||
SESSION=$(login)
|
||||
do_work $SESSION
|
||||
|
||||
# Don't close if you want to reuse!
|
||||
# infsh app run agent-browser --function close --session $SESSION --input '{}'
|
||||
```
|
||||
|
||||
## Cookie Extraction
|
||||
|
||||
Extract cookies for use in other tools:
|
||||
|
||||
```bash
|
||||
# Get cookies via JavaScript
|
||||
RESULT=$(infsh app run agent-browser --function execute --session $SESSION --input '{
|
||||
"code": "document.cookie"
|
||||
}')
|
||||
COOKIES=$(echo $RESULT | jq -r '.result')
|
||||
echo "Cookies: $COOKIES"
|
||||
|
||||
# Get all cookies including httpOnly (more complete)
|
||||
RESULT=$(infsh app run agent-browser --function execute --session $SESSION --input '{
|
||||
"code": "JSON.stringify(performance.getEntriesByType(\"resource\").map(r => r.name))"
|
||||
}')
|
||||
```
|
||||
|
||||
## Security Best Practices
|
||||
|
||||
### 1. Never Hardcode Credentials
|
||||
|
||||
```bash
|
||||
# Good: Use environment variables
|
||||
'{"action": "fill", "ref": "@e2", "text": "'"$PASSWORD"'"}'
|
||||
|
||||
# Bad: Hardcoded
|
||||
'{"action": "fill", "ref": "@e2", "text": "mypassword123"}'
|
||||
```
|
||||
|
||||
### 2. Use Secure Environment Variables
|
||||
|
||||
```bash
|
||||
# Set securely
|
||||
export PASSWORD=$(cat /path/to/secure/password)
|
||||
|
||||
# Or use a secrets manager
|
||||
export PASSWORD=$(vault read -field=password secret/app)
|
||||
```
|
||||
|
||||
### 3. Don't Log Sensitive Data
|
||||
|
||||
```bash
|
||||
# Good: Redact sensitive info
|
||||
echo "Logging in as $USERNAME"
|
||||
|
||||
# Bad: Logging passwords
|
||||
echo "Password: $PASSWORD" # Never do this!
|
||||
```
|
||||
|
||||
### 4. Close Sessions After Use
|
||||
|
||||
```bash
|
||||
# Always clean up
|
||||
trap 'infsh app run agent-browser --function close --session $SESSION --input "{}" 2>/dev/null' EXIT
|
||||
```
|
||||
|
||||
### 5. Use Video Recording for Debugging Only
|
||||
|
||||
Video may capture sensitive information:
|
||||
|
||||
```bash
|
||||
# Only enable when debugging
|
||||
if [ "$DEBUG" = "true" ]; then
|
||||
RECORD_VIDEO="true"
|
||||
else
|
||||
RECORD_VIDEO="false"
|
||||
fi
|
||||
```
|
||||
|
||||
### 6. Verify Login Success
|
||||
|
||||
Always confirm authentication worked:
|
||||
|
||||
```bash
|
||||
# Check URL changed from login page
|
||||
URL=$(echo $RESULT | jq -r '.url')
|
||||
if [[ "$URL" == *"/login"* ]] || [[ "$URL" == *"/signin"* ]]; then
|
||||
echo "ERROR: Login failed"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# Or check for specific element on authenticated page
|
||||
ELEMENTS=$(echo $RESULT | jq -r '.elements_text')
|
||||
if ! echo "$ELEMENTS" | grep -q "Logout\|Dashboard\|Welcome"; then
|
||||
echo "ERROR: Not authenticated"
|
||||
exit 1
|
||||
fi
|
||||
```
|
||||
272
.agents/skills/agent-browser/references/commands.md
Normal file
272
.agents/skills/agent-browser/references/commands.md
Normal file
|
|
@ -0,0 +1,272 @@
|
|||
# Command Reference
|
||||
|
||||
Complete reference for all agent-browser functions. For quick start, see [SKILL.md](../SKILL.md).
|
||||
|
||||
## Base Command
|
||||
|
||||
All commands follow this pattern:
|
||||
|
||||
```bash
|
||||
infsh app run agent-browser --function <function> --session <session_id|new> --input '<json>'
|
||||
```
|
||||
|
||||
- `--function`: Function to call (open, snapshot, interact, screenshot, execute, close)
|
||||
- `--session`: Session ID from previous call, or `new` to start fresh
|
||||
- `--input`: JSON input for the function
|
||||
|
||||
## Functions
|
||||
|
||||
### open
|
||||
|
||||
Navigate to URL and configure browser. This is the entry point for all sessions.
|
||||
|
||||
```bash
|
||||
infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "https://example.com",
|
||||
"width": 1280,
|
||||
"height": 720,
|
||||
"user_agent": "Mozilla/5.0...",
|
||||
"record_video": false,
|
||||
"show_cursor": false,
|
||||
"proxy_url": null,
|
||||
"proxy_username": null,
|
||||
"proxy_password": null
|
||||
}'
|
||||
```
|
||||
|
||||
**Input Fields:**
|
||||
|
||||
| Field | Type | Default | Description |
|
||||
|-------|------|---------|-------------|
|
||||
| `url` | string | required | URL to navigate to |
|
||||
| `width` | int | 1280 | Viewport width in pixels |
|
||||
| `height` | int | 720 | Viewport height in pixels |
|
||||
| `user_agent` | string | null | Custom user agent string |
|
||||
| `record_video` | bool | false | Record video (returned on close) |
|
||||
| `show_cursor` | bool | false | Show cursor indicator in screenshots/video |
|
||||
| `proxy_url` | string | null | Proxy server URL |
|
||||
| `proxy_username` | string | null | Proxy auth username |
|
||||
| `proxy_password` | string | null | Proxy auth password |
|
||||
|
||||
**Output:**
|
||||
|
||||
```json
|
||||
{
|
||||
"session_id": "abc123",
|
||||
"url": "https://example.com",
|
||||
"title": "Example Domain",
|
||||
"elements": [...],
|
||||
"elements_text": "@e1 [a] \"More information...\" href=\"...\"\n...",
|
||||
"screenshot": "<File>"
|
||||
}
|
||||
```
|
||||
|
||||
### snapshot
|
||||
|
||||
Re-fetch page state with `@e` refs. Call after navigation or DOM changes.
|
||||
|
||||
```bash
|
||||
infsh app run agent-browser --function snapshot --session $SESSION_ID --input '{}'
|
||||
```
|
||||
|
||||
**Output:** Same as `open` (url, title, elements, elements_text, screenshot)
|
||||
|
||||
### interact
|
||||
|
||||
Perform actions on the page using `@e` refs.
|
||||
|
||||
```bash
|
||||
infsh app run agent-browser --function interact --session $SESSION_ID --input '{
|
||||
"action": "click",
|
||||
"ref": "@e1"
|
||||
}'
|
||||
```
|
||||
|
||||
**Input Fields:**
|
||||
|
||||
| Field | Type | Description |
|
||||
|-------|------|-------------|
|
||||
| `action` | string | Action to perform (see Actions table) |
|
||||
| `ref` | string | Element ref (e.g., `@e1`) |
|
||||
| `text` | string | Text for fill/type/press/select |
|
||||
| `direction` | string | Scroll direction: up, down, left, right |
|
||||
| `scroll_amount` | int | Scroll pixels (default 400) |
|
||||
| `wait_ms` | int | Wait duration in milliseconds |
|
||||
| `url` | string | URL for goto action |
|
||||
| `target_ref` | string | Target ref for drag action |
|
||||
| `file_paths` | array | File paths for upload action |
|
||||
|
||||
**Actions:**
|
||||
|
||||
| Action | Required Fields | Description |
|
||||
|--------|-----------------|-------------|
|
||||
| `click` | `ref` | Single click |
|
||||
| `dblclick` | `ref` | Double click |
|
||||
| `fill` | `ref`, `text` | Clear input and type text |
|
||||
| `type` | `text` | Type text without clearing |
|
||||
| `press` | `text` | Press key (Enter, Tab, Escape, etc.) |
|
||||
| `select` | `ref`, `text` | Select dropdown option by label |
|
||||
| `hover` | `ref` | Hover over element |
|
||||
| `check` | `ref` | Check checkbox |
|
||||
| `uncheck` | `ref` | Uncheck checkbox |
|
||||
| `drag` | `ref`, `target_ref` | Drag from ref to target_ref |
|
||||
| `upload` | `ref`, `file_paths` | Upload files to file input |
|
||||
| `scroll` | `direction` | Scroll page (optional: `scroll_amount`) |
|
||||
| `back` | - | Go back in browser history |
|
||||
| `wait` | `wait_ms` | Wait for specified milliseconds |
|
||||
| `goto` | `url` | Navigate to different URL |
|
||||
|
||||
**Output:**
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"action": "click",
|
||||
"message": null,
|
||||
"screenshot": "<File>",
|
||||
"snapshot": {
|
||||
"url": "...",
|
||||
"title": "...",
|
||||
"elements": [...],
|
||||
"elements_text": "..."
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### screenshot
|
||||
|
||||
Take a screenshot of the current page.
|
||||
|
||||
```bash
|
||||
infsh app run agent-browser --function screenshot --session $SESSION_ID --input '{
|
||||
"full_page": true
|
||||
}'
|
||||
```
|
||||
|
||||
**Input Fields:**
|
||||
|
||||
| Field | Type | Default | Description |
|
||||
|-------|------|---------|-------------|
|
||||
| `full_page` | bool | false | Capture full scrollable page |
|
||||
|
||||
**Output:**
|
||||
|
||||
```json
|
||||
{
|
||||
"screenshot": "<File>",
|
||||
"width": 1280,
|
||||
"height": 720
|
||||
}
|
||||
```
|
||||
|
||||
### execute
|
||||
|
||||
Run JavaScript code on the page.
|
||||
|
||||
```bash
|
||||
infsh app run agent-browser --function execute --session $SESSION_ID --input '{
|
||||
"code": "document.title"
|
||||
}'
|
||||
```
|
||||
|
||||
**Input Fields:**
|
||||
|
||||
| Field | Type | Description |
|
||||
|-------|------|-------------|
|
||||
| `code` | string | JavaScript code to execute |
|
||||
|
||||
**Output:**
|
||||
|
||||
```json
|
||||
{
|
||||
"result": "Example Domain",
|
||||
"error": null,
|
||||
"screenshot": "<File>"
|
||||
}
|
||||
```
|
||||
|
||||
**Examples:**
|
||||
|
||||
```bash
|
||||
# Get page title
|
||||
'{"code": "document.title"}'
|
||||
|
||||
# Count elements
|
||||
'{"code": "document.querySelectorAll(\"a\").length"}'
|
||||
|
||||
# Extract text
|
||||
'{"code": "document.querySelector(\"h1\").textContent"}'
|
||||
|
||||
# Get all links
|
||||
'{"code": "Array.from(document.querySelectorAll(\"a\")).map(a => a.href)"}'
|
||||
|
||||
# Scroll to bottom
|
||||
'{"code": "window.scrollTo(0, document.body.scrollHeight)"}'
|
||||
|
||||
# Get computed style
|
||||
'{"code": "getComputedStyle(document.body).backgroundColor"}'
|
||||
```
|
||||
|
||||
### close
|
||||
|
||||
Close the browser session. Returns video if recording was enabled.
|
||||
|
||||
```bash
|
||||
infsh app run agent-browser --function close --session $SESSION_ID --input '{}'
|
||||
```
|
||||
|
||||
**Output:**
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"video": "<File or null>"
|
||||
}
|
||||
```
|
||||
|
||||
## Key Combinations
|
||||
|
||||
For the `press` action, use these key names:
|
||||
|
||||
| Key | Name |
|
||||
|-----|------|
|
||||
| Enter | `Enter` |
|
||||
| Tab | `Tab` |
|
||||
| Escape | `Escape` |
|
||||
| Backspace | `Backspace` |
|
||||
| Delete | `Delete` |
|
||||
| Arrow keys | `ArrowUp`, `ArrowDown`, `ArrowLeft`, `ArrowRight` |
|
||||
| Modifiers | `Control`, `Shift`, `Alt`, `Meta` |
|
||||
|
||||
**Key combinations:**
|
||||
|
||||
```bash
|
||||
# Ctrl+A (select all)
|
||||
'{"action": "press", "text": "Control+a"}'
|
||||
|
||||
# Ctrl+C (copy)
|
||||
'{"action": "press", "text": "Control+c"}'
|
||||
|
||||
# Shift+Tab (focus previous)
|
||||
'{"action": "press", "text": "Shift+Tab"}'
|
||||
```
|
||||
|
||||
## Error Handling
|
||||
|
||||
When an action fails, `success` is `false` and `message` contains the error:
|
||||
|
||||
```json
|
||||
{
|
||||
"success": false,
|
||||
"action": "click",
|
||||
"message": "Unknown ref: @e99. Run 'snapshot' to get current elements.",
|
||||
"screenshot": "<File>",
|
||||
"snapshot": {...}
|
||||
}
|
||||
```
|
||||
|
||||
Common errors:
|
||||
- `Unknown ref: @eN` - Ref doesn't exist, re-snapshot needed
|
||||
- `'text' required for fill action` - Missing required field
|
||||
- `'target_ref' required for drag action` - Missing drag target
|
||||
- `Timeout 5000ms exceeded` - Element not found or not clickable
|
||||
295
.agents/skills/agent-browser/references/proxy-support.md
Normal file
295
.agents/skills/agent-browser/references/proxy-support.md
Normal file
|
|
@ -0,0 +1,295 @@
|
|||
# Proxy Support
|
||||
|
||||
Proxy configuration for geo-testing, privacy, and corporate environments.
|
||||
|
||||
**Related**: [commands.md](commands.md) for full function reference, [SKILL.md](../SKILL.md) for quick start.
|
||||
|
||||
## Contents
|
||||
|
||||
- [Basic Proxy Configuration](#basic-proxy-configuration)
|
||||
- [Authenticated Proxy](#authenticated-proxy)
|
||||
- [Common Use Cases](#common-use-cases)
|
||||
- [Proxy Types](#proxy-types)
|
||||
- [Verifying Proxy Connection](#verifying-proxy-connection)
|
||||
- [Troubleshooting](#troubleshooting)
|
||||
- [Best Practices](#best-practices)
|
||||
|
||||
## Basic Proxy Configuration
|
||||
|
||||
Set proxy when opening a session:
|
||||
|
||||
```bash
|
||||
SESSION=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "https://example.com",
|
||||
"proxy_url": "http://proxy.example.com:8080"
|
||||
}' | jq -r '.session_id')
|
||||
```
|
||||
|
||||
All traffic for this session routes through the proxy.
|
||||
|
||||
## Authenticated Proxy
|
||||
|
||||
For proxies requiring username/password:
|
||||
|
||||
```bash
|
||||
SESSION=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "https://example.com",
|
||||
"proxy_url": "http://proxy.example.com:8080",
|
||||
"proxy_username": "myuser",
|
||||
"proxy_password": "mypassword"
|
||||
}' | jq -r '.session_id')
|
||||
```
|
||||
|
||||
## Common Use Cases
|
||||
|
||||
### Geo-Location Testing
|
||||
|
||||
Test how your site appears from different regions:
|
||||
|
||||
```bash
|
||||
#!/bin/bash
|
||||
# Test from multiple regions
|
||||
|
||||
PROXIES=(
|
||||
"us|http://us-proxy.example.com:8080"
|
||||
"eu|http://eu-proxy.example.com:8080"
|
||||
"asia|http://asia-proxy.example.com:8080"
|
||||
)
|
||||
|
||||
for entry in "${PROXIES[@]}"; do
|
||||
REGION="${entry%%|*}"
|
||||
PROXY="${entry##*|}"
|
||||
|
||||
echo "Testing from: $REGION"
|
||||
|
||||
SESSION=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "https://mysite.com",
|
||||
"proxy_url": "'"$PROXY"'"
|
||||
}' | jq -r '.session_id')
|
||||
|
||||
# Take screenshot
|
||||
infsh app run agent-browser --function screenshot --session $SESSION --input '{
|
||||
"full_page": true
|
||||
}' > "${REGION}-screenshot.json"
|
||||
|
||||
# Get page content
|
||||
RESULT=$(infsh app run agent-browser --function snapshot --session $SESSION --input '{}')
|
||||
echo $RESULT | jq '.elements_text' > "${REGION}-elements.txt"
|
||||
|
||||
infsh app run agent-browser --function close --session $SESSION --input '{}'
|
||||
done
|
||||
|
||||
echo "Geo-testing complete"
|
||||
```
|
||||
|
||||
### Rate Limit Avoidance
|
||||
|
||||
Rotate proxies for web scraping:
|
||||
|
||||
```bash
|
||||
#!/bin/bash
|
||||
# Rotate through proxy list
|
||||
|
||||
PROXIES=(
|
||||
"http://proxy1.example.com:8080"
|
||||
"http://proxy2.example.com:8080"
|
||||
"http://proxy3.example.com:8080"
|
||||
)
|
||||
|
||||
URLS=(
|
||||
"https://site.com/page1"
|
||||
"https://site.com/page2"
|
||||
"https://site.com/page3"
|
||||
)
|
||||
|
||||
for i in "${!URLS[@]}"; do
|
||||
# Rotate proxy
|
||||
PROXY_INDEX=$((i % ${#PROXIES[@]}))
|
||||
PROXY="${PROXIES[$PROXY_INDEX]}"
|
||||
URL="${URLS[$i]}"
|
||||
|
||||
echo "Fetching $URL via proxy $((PROXY_INDEX + 1))"
|
||||
|
||||
SESSION=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "'"$URL"'",
|
||||
"proxy_url": "'"$PROXY"'"
|
||||
}' | jq -r '.session_id')
|
||||
|
||||
# Extract data
|
||||
RESULT=$(infsh app run agent-browser --function execute --session $SESSION --input '{
|
||||
"code": "document.body.innerText"
|
||||
}')
|
||||
echo $RESULT | jq -r '.result' > "page-$i.txt"
|
||||
|
||||
infsh app run agent-browser --function close --session $SESSION --input '{}'
|
||||
|
||||
# Polite delay
|
||||
sleep 1
|
||||
done
|
||||
```
|
||||
|
||||
### Corporate Network Access
|
||||
|
||||
Access sites through corporate proxy:
|
||||
|
||||
```bash
|
||||
# Use corporate proxy for external sites
|
||||
SESSION=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "https://external-vendor.com",
|
||||
"proxy_url": "http://corpproxy.company.com:8080",
|
||||
"proxy_username": "'"$CORP_USER"'",
|
||||
"proxy_password": "'"$CORP_PASS"'"
|
||||
}' | jq -r '.session_id')
|
||||
```
|
||||
|
||||
### Privacy and Anonymity
|
||||
|
||||
Route through privacy-focused proxy:
|
||||
|
||||
```bash
|
||||
SESSION=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "https://whatismyip.com",
|
||||
"proxy_url": "socks5://privacy-proxy.example.com:1080"
|
||||
}' | jq -r '.session_id')
|
||||
```
|
||||
|
||||
## Proxy Types
|
||||
|
||||
### HTTP/HTTPS Proxy
|
||||
|
||||
```json
|
||||
{"proxy_url": "http://proxy.example.com:8080"}
|
||||
{"proxy_url": "https://proxy.example.com:8080"}
|
||||
```
|
||||
|
||||
### SOCKS5 Proxy
|
||||
|
||||
```json
|
||||
{"proxy_url": "socks5://proxy.example.com:1080"}
|
||||
```
|
||||
|
||||
### With Authentication
|
||||
|
||||
```json
|
||||
{
|
||||
"proxy_url": "http://proxy.example.com:8080",
|
||||
"proxy_username": "user",
|
||||
"proxy_password": "pass"
|
||||
}
|
||||
```
|
||||
|
||||
## Verifying Proxy Connection
|
||||
|
||||
Check that traffic routes through proxy:
|
||||
|
||||
```bash
|
||||
SESSION=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "https://httpbin.org/ip",
|
||||
"proxy_url": "http://proxy.example.com:8080"
|
||||
}' | jq -r '.session_id')
|
||||
|
||||
# Get the IP shown
|
||||
RESULT=$(infsh app run agent-browser --function execute --session $SESSION --input '{
|
||||
"code": "document.body.innerText"
|
||||
}')
|
||||
echo "IP via proxy: $(echo $RESULT | jq -r '.result')"
|
||||
|
||||
infsh app run agent-browser --function close --session $SESSION --input '{}'
|
||||
```
|
||||
|
||||
The IP should be the proxy's IP, not your real IP.
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Connection Failed
|
||||
|
||||
```
|
||||
Error: Failed to open URL: net::ERR_PROXY_CONNECTION_FAILED
|
||||
```
|
||||
|
||||
**Solutions:**
|
||||
1. Verify proxy URL is correct
|
||||
2. Check proxy is running and accessible
|
||||
3. Confirm port is correct
|
||||
4. Test proxy with curl: `curl -x http://proxy:8080 https://example.com`
|
||||
|
||||
### Authentication Failed
|
||||
|
||||
```
|
||||
Error: 407 Proxy Authentication Required
|
||||
```
|
||||
|
||||
**Solutions:**
|
||||
1. Verify username/password are correct
|
||||
2. Check if proxy requires different auth method
|
||||
3. Ensure credentials don't contain special characters that need escaping
|
||||
|
||||
### SSL Errors
|
||||
|
||||
Some proxies perform SSL inspection. If you see certificate errors:
|
||||
|
||||
```bash
|
||||
# The browser should handle most SSL proxies automatically
|
||||
# If issues persist, verify proxy SSL certificate is valid
|
||||
```
|
||||
|
||||
### Slow Performance
|
||||
|
||||
**Solutions:**
|
||||
1. Choose proxy closer to target site
|
||||
2. Use faster proxy provider
|
||||
3. Reduce number of requests per session
|
||||
|
||||
## Best Practices
|
||||
|
||||
### 1. Use Environment Variables
|
||||
|
||||
```bash
|
||||
# Good: Credentials in env vars
|
||||
'{"proxy_url": "'"$PROXY_URL"'", "proxy_username": "'"$PROXY_USER"'"}'
|
||||
|
||||
# Bad: Hardcoded
|
||||
'{"proxy_url": "http://user:pass@proxy.com:8080"}'
|
||||
```
|
||||
|
||||
### 2. Test Proxy Before Automation
|
||||
|
||||
```bash
|
||||
# Verify proxy works
|
||||
curl -x "$PROXY_URL" https://httpbin.org/ip
|
||||
```
|
||||
|
||||
### 3. Handle Proxy Failures
|
||||
|
||||
```bash
|
||||
# Retry with different proxy on failure
|
||||
for PROXY in "${PROXIES[@]}"; do
|
||||
SESSION=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "'"$URL"'",
|
||||
"proxy_url": "'"$PROXY"'"
|
||||
}' 2>&1)
|
||||
|
||||
if echo "$SESSION" | jq -e '.session_id' > /dev/null 2>&1; then
|
||||
SESSION_ID=$(echo $SESSION | jq -r '.session_id')
|
||||
break
|
||||
fi
|
||||
echo "Proxy $PROXY failed, trying next..."
|
||||
done
|
||||
```
|
||||
|
||||
### 4. Respect Rate Limits
|
||||
|
||||
Even with proxies, be a good citizen:
|
||||
|
||||
```bash
|
||||
# Add delays between requests
|
||||
'{"action": "wait", "wait_ms": 1000}'
|
||||
```
|
||||
|
||||
### 5. Log Proxy Usage
|
||||
|
||||
For debugging, log which proxy was used:
|
||||
|
||||
```bash
|
||||
echo "$(date): Using proxy $PROXY for $URL" >> proxy.log
|
||||
```
|
||||
204
.agents/skills/agent-browser/references/session-management.md
Normal file
204
.agents/skills/agent-browser/references/session-management.md
Normal file
|
|
@ -0,0 +1,204 @@
|
|||
# Session Management
|
||||
|
||||
Browser sessions for state persistence and parallel browsing.
|
||||
|
||||
**Related**: [authentication.md](authentication.md) for login patterns, [SKILL.md](../SKILL.md) for quick start.
|
||||
|
||||
## Contents
|
||||
|
||||
- [How Sessions Work](#how-sessions-work)
|
||||
- [Starting a Session](#starting-a-session)
|
||||
- [Using Session IDs](#using-session-ids)
|
||||
- [Session State](#session-state)
|
||||
- [Parallel Sessions](#parallel-sessions)
|
||||
- [Session Cleanup](#session-cleanup)
|
||||
- [Best Practices](#best-practices)
|
||||
|
||||
## How Sessions Work
|
||||
|
||||
Each session maintains an isolated browser context with:
|
||||
- Cookies
|
||||
- LocalStorage / SessionStorage
|
||||
- Browser history
|
||||
- Page state
|
||||
- Video recording (if enabled)
|
||||
|
||||
Sessions persist across function calls, allowing multi-step workflows.
|
||||
|
||||
## Starting a Session
|
||||
|
||||
Use `--session new` to create a fresh session:
|
||||
|
||||
```bash
|
||||
RESULT=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "https://example.com"
|
||||
}')
|
||||
SESSION_ID=$(echo $RESULT | jq -r '.session_id')
|
||||
echo "Session: $SESSION_ID"
|
||||
```
|
||||
|
||||
## Using Session IDs
|
||||
|
||||
All subsequent calls use the session ID:
|
||||
|
||||
```bash
|
||||
# Navigate
|
||||
infsh app run agent-browser --function open --session $SESSION_ID --input '{
|
||||
"url": "https://example.com/page2"
|
||||
}'
|
||||
|
||||
# Interact
|
||||
infsh app run agent-browser --function interact --session $SESSION_ID --input '{
|
||||
"action": "click", "ref": "@e1"
|
||||
}'
|
||||
|
||||
# Screenshot
|
||||
infsh app run agent-browser --function screenshot --session $SESSION_ID --input '{}'
|
||||
|
||||
# Close
|
||||
infsh app run agent-browser --function close --session $SESSION_ID --input '{}'
|
||||
```
|
||||
|
||||
## Session State
|
||||
|
||||
### What Persists
|
||||
|
||||
Within a session, these persist across calls:
|
||||
- Cookies (login state, preferences)
|
||||
- LocalStorage and SessionStorage
|
||||
- IndexedDB data
|
||||
- Browser history (for back/forward)
|
||||
- Current page and DOM state
|
||||
- Video recording buffer
|
||||
|
||||
### What Doesn't Persist
|
||||
|
||||
- Sessions don't persist across server restarts
|
||||
- No automatic session recovery
|
||||
- Video is only available until close is called
|
||||
|
||||
## Parallel Sessions
|
||||
|
||||
Run multiple independent sessions simultaneously:
|
||||
|
||||
```bash
|
||||
#!/bin/bash
|
||||
# Scrape multiple sites in parallel
|
||||
|
||||
# Start sessions
|
||||
RESULT1=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "https://site1.com"
|
||||
}')
|
||||
SESSION1=$(echo $RESULT1 | jq -r '.session_id')
|
||||
|
||||
RESULT2=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "https://site2.com"
|
||||
}')
|
||||
SESSION2=$(echo $RESULT2 | jq -r '.session_id')
|
||||
|
||||
# Work with each session independently
|
||||
infsh app run agent-browser --function screenshot --session $SESSION1 --input '{}' &
|
||||
infsh app run agent-browser --function screenshot --session $SESSION2 --input '{}' &
|
||||
wait
|
||||
|
||||
# Clean up both
|
||||
infsh app run agent-browser --function close --session $SESSION1 --input '{}'
|
||||
infsh app run agent-browser --function close --session $SESSION2 --input '{}'
|
||||
```
|
||||
|
||||
### Use Cases for Parallel Sessions
|
||||
|
||||
1. **A/B Testing** - Compare different pages or user experiences
|
||||
2. **Multi-site scraping** - Gather data from multiple sources
|
||||
3. **Load testing** - Simulate multiple users
|
||||
4. **Cross-region testing** - Use different proxies per session
|
||||
|
||||
## Session Cleanup
|
||||
|
||||
Always close sessions when done:
|
||||
|
||||
```bash
|
||||
infsh app run agent-browser --function close --session $SESSION_ID --input '{}'
|
||||
```
|
||||
|
||||
**Why close matters:**
|
||||
- Releases server resources
|
||||
- Returns video recording (if enabled)
|
||||
- Prevents resource leaks
|
||||
|
||||
### Error Handling
|
||||
|
||||
```bash
|
||||
#!/bin/bash
|
||||
set -e
|
||||
|
||||
cleanup() {
|
||||
infsh app run agent-browser --function close --session $SESSION_ID --input '{}' 2>/dev/null || true
|
||||
}
|
||||
trap cleanup EXIT
|
||||
|
||||
SESSION_ID=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "https://example.com"
|
||||
}' | jq -r '.session_id')
|
||||
|
||||
# ... your automation ...
|
||||
# cleanup runs automatically on exit
|
||||
```
|
||||
|
||||
## Best Practices
|
||||
|
||||
### 1. Store Session IDs
|
||||
|
||||
```bash
|
||||
# Good: Store for reuse
|
||||
SESSION_ID=$(... | jq -r '.session_id')
|
||||
infsh ... --session $SESSION_ID ...
|
||||
|
||||
# Bad: Parse every time
|
||||
infsh ... --session $(... | jq -r '.session_id') ...
|
||||
```
|
||||
|
||||
### 2. Close Sessions Promptly
|
||||
|
||||
Don't leave sessions open longer than needed. Server resources are limited.
|
||||
|
||||
### 3. Use Meaningful Variable Names
|
||||
|
||||
```bash
|
||||
# Good: Clear purpose
|
||||
LOGIN_SESSION=$(...)
|
||||
SCRAPE_SESSION=$(...)
|
||||
|
||||
# Bad: Generic names
|
||||
S1=$(...)
|
||||
S2=$(...)
|
||||
```
|
||||
|
||||
### 4. Handle Session Expiry
|
||||
|
||||
Sessions may expire after extended inactivity:
|
||||
|
||||
```bash
|
||||
# Check if session is still valid
|
||||
RESULT=$(infsh app run agent-browser --function snapshot --session $SESSION_ID --input '{}' 2>&1)
|
||||
if echo "$RESULT" | grep -q "session not found"; then
|
||||
echo "Session expired, starting new one"
|
||||
SESSION_ID=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "https://example.com"
|
||||
}' | jq -r '.session_id')
|
||||
fi
|
||||
```
|
||||
|
||||
### 5. One Task Per Session
|
||||
|
||||
For clarity, use one session per logical task:
|
||||
|
||||
```bash
|
||||
# Good: Separate sessions for separate tasks
|
||||
LOGIN_SESSION=$(...) # Handle login
|
||||
SCRAPE_SESSION=$(...) # Handle scraping
|
||||
|
||||
# Okay for related tasks: One session for a workflow
|
||||
SESSION=$(...)
|
||||
# login -> navigate -> extract -> close
|
||||
```
|
||||
251
.agents/skills/agent-browser/references/snapshot-refs.md
Normal file
251
.agents/skills/agent-browser/references/snapshot-refs.md
Normal file
|
|
@ -0,0 +1,251 @@
|
|||
# Snapshot and Refs
|
||||
|
||||
Compact element references that reduce context usage for AI agents.
|
||||
|
||||
**Related**: [commands.md](commands.md) for full function reference, [SKILL.md](../SKILL.md) for quick start.
|
||||
|
||||
## Contents
|
||||
|
||||
- [How Refs Work](#how-refs-work)
|
||||
- [Snapshot Output Format](#snapshot-output-format)
|
||||
- [Using Refs](#using-refs)
|
||||
- [Ref Lifecycle](#ref-lifecycle)
|
||||
- [Best Practices](#best-practices)
|
||||
- [Ref Notation Details](#ref-notation-details)
|
||||
- [Troubleshooting](#troubleshooting)
|
||||
|
||||
## How Refs Work
|
||||
|
||||
Traditional approach:
|
||||
```
|
||||
Full DOM/HTML -> AI parses -> CSS selector -> Action (~3000-5000 tokens)
|
||||
```
|
||||
|
||||
agent-browser approach:
|
||||
```
|
||||
Compact snapshot -> @refs assigned -> Direct interaction (~200-400 tokens)
|
||||
```
|
||||
|
||||
The snapshot extracts interactive elements and assigns short `@e` refs, reducing token usage significantly.
|
||||
|
||||
## Snapshot Output Format
|
||||
|
||||
```bash
|
||||
infsh app run agent-browser --function snapshot --session $SESSION --input '{}'
|
||||
```
|
||||
|
||||
**Response `elements_text`:**
|
||||
|
||||
```
|
||||
@e1 [a] "Home" href="/"
|
||||
@e2 [a] "Products" href="/products"
|
||||
@e3 [a] "About" href="/about"
|
||||
@e4 [button] "Sign In"
|
||||
@e5 [input type="email"] placeholder="Email"
|
||||
@e6 [input type="password"] placeholder="Password"
|
||||
@e7 [button type="submit"] "Log In"
|
||||
@e8 [input type="checkbox"] name="remember"
|
||||
```
|
||||
|
||||
**Response `elements` (structured):**
|
||||
|
||||
```json
|
||||
[
|
||||
{
|
||||
"ref": "@e1",
|
||||
"desc": "@e1 [a] \"Home\" href=\"/\"",
|
||||
"tag": "a",
|
||||
"text": "Home",
|
||||
"role": null,
|
||||
"name": null,
|
||||
"href": "/",
|
||||
"input_type": null
|
||||
},
|
||||
...
|
||||
]
|
||||
```
|
||||
|
||||
## Using Refs
|
||||
|
||||
Once you have refs, interact directly:
|
||||
|
||||
```bash
|
||||
# Click the "Sign In" button
|
||||
'{"action": "click", "ref": "@e4"}'
|
||||
|
||||
# Fill email input
|
||||
'{"action": "fill", "ref": "@e5", "text": "user@example.com"}'
|
||||
|
||||
# Fill password
|
||||
'{"action": "fill", "ref": "@e6", "text": "password123"}'
|
||||
|
||||
# Submit the form
|
||||
'{"action": "click", "ref": "@e7"}'
|
||||
|
||||
# Check the "remember me" checkbox
|
||||
'{"action": "check", "ref": "@e8"}'
|
||||
```
|
||||
|
||||
## Ref Lifecycle
|
||||
|
||||
**IMPORTANT**: Refs are invalidated when the page changes!
|
||||
|
||||
```bash
|
||||
# Get initial snapshot
|
||||
infsh app run agent-browser --function snapshot --session $SESSION --input '{}'
|
||||
# @e1 [button] "Next"
|
||||
|
||||
# Click triggers page change
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "click", "ref": "@e1"
|
||||
}'
|
||||
|
||||
# MUST re-snapshot to get new refs!
|
||||
infsh app run agent-browser --function snapshot --session $SESSION --input '{}'
|
||||
# @e1 [h1] "Page 2" <- Different element now!
|
||||
```
|
||||
|
||||
### When to Re-snapshot
|
||||
|
||||
Always re-snapshot after:
|
||||
|
||||
1. **Navigation** - Clicking links, form submissions, `goto` action
|
||||
2. **Dynamic content** - AJAX loads, modals opening, tabs switching
|
||||
3. **Page mutations** - JavaScript modifying the DOM
|
||||
|
||||
The `interact` function returns a fresh snapshot in its response, so you can often use that instead of a separate snapshot call.
|
||||
|
||||
## Best Practices
|
||||
|
||||
### 1. Always Use the Latest Snapshot
|
||||
|
||||
```bash
|
||||
# CORRECT: Use snapshot from previous response
|
||||
RESULT=$(infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "click", "ref": "@e1"
|
||||
}')
|
||||
# Use elements from $RESULT.snapshot for next action
|
||||
|
||||
# WRONG: Using stale refs
|
||||
# After navigation, @e1 may point to a completely different element
|
||||
```
|
||||
|
||||
### 2. Check Success Before Continuing
|
||||
|
||||
```bash
|
||||
RESULT=$(infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "click", "ref": "@e5"
|
||||
}')
|
||||
|
||||
SUCCESS=$(echo $RESULT | jq -r '.success')
|
||||
if [ "$SUCCESS" != "true" ]; then
|
||||
echo "Click failed: $(echo $RESULT | jq -r '.message')"
|
||||
# Re-snapshot and retry
|
||||
fi
|
||||
```
|
||||
|
||||
### 3. Use elements_text for Quick Decisions
|
||||
|
||||
For AI agents, `elements_text` provides a compact text representation:
|
||||
|
||||
```
|
||||
@e1 [input type="email"] placeholder="Email"
|
||||
@e2 [input type="password"] placeholder="Password"
|
||||
@e3 [button] "Submit"
|
||||
```
|
||||
|
||||
This is often enough to decide which element to interact with without parsing the full `elements` array.
|
||||
|
||||
## Ref Notation Details
|
||||
|
||||
```
|
||||
@e1 [tag type="value"] "text content" name="attr"
|
||||
| | | | |
|
||||
| | | | +- Additional attributes
|
||||
| | | +- Visible text
|
||||
| | +- Key attributes shown
|
||||
| +- HTML tag name
|
||||
+- Unique ref ID
|
||||
```
|
||||
|
||||
### Common Patterns
|
||||
|
||||
```
|
||||
@e1 [button] "Submit" # Button with text
|
||||
@e2 [input type="email"] # Email input
|
||||
@e3 [input type="password"] # Password input
|
||||
@e4 [a] "Link Text" href="/page" # Anchor link
|
||||
@e5 [select] # Dropdown
|
||||
@e6 [textarea] placeholder="Message" # Text area
|
||||
@e7 [input type="file"] # File upload
|
||||
@e8 [input type="checkbox"] checked # Checked checkbox
|
||||
@e9 [input type="radio"] selected # Selected radio
|
||||
@e10 [button type="submit"] "Send" # Submit button
|
||||
```
|
||||
|
||||
### Elements Captured
|
||||
|
||||
The snapshot captures these interactive elements:
|
||||
|
||||
- Links (`<a href>`)
|
||||
- Buttons (`<button>`, `[role="button"]`)
|
||||
- Inputs (`<input>`, `<textarea>`, `<select>`)
|
||||
- Clickable elements (`[onclick]`, `[tabindex]`)
|
||||
- ARIA roles (`[role="link"]`, `[role="checkbox"]`, etc.)
|
||||
|
||||
Non-interactive or hidden elements are filtered out.
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### "Unknown ref" Error
|
||||
|
||||
```json
|
||||
{
|
||||
"success": false,
|
||||
"message": "Unknown ref: @e15. Run 'snapshot' to get current elements."
|
||||
}
|
||||
```
|
||||
|
||||
**Solution**: Re-snapshot. The page changed and refs are stale.
|
||||
|
||||
```bash
|
||||
infsh app run agent-browser --function snapshot --session $SESSION --input '{}'
|
||||
# Now use the new refs
|
||||
```
|
||||
|
||||
### Element Not in Snapshot
|
||||
|
||||
The element you need might not appear because:
|
||||
|
||||
1. **Not visible** - Scroll to reveal it
|
||||
```bash
|
||||
'{"action": "scroll", "direction": "down", "scroll_amount": 500}'
|
||||
```
|
||||
|
||||
2. **Not interactive** - Use JavaScript to interact
|
||||
```bash
|
||||
'{"code": "document.querySelector(\".hidden-btn\").click()"}'
|
||||
```
|
||||
|
||||
3. **In iframe** - Currently not supported (use `execute` with JS)
|
||||
|
||||
4. **Dynamic** - Wait for it to load
|
||||
```bash
|
||||
'{"action": "wait", "wait_ms": 2000}'
|
||||
```
|
||||
|
||||
### Too Many Elements
|
||||
|
||||
Snapshots are limited to 50 elements. If the page has more:
|
||||
|
||||
1. **Scroll** to bring relevant elements into view
|
||||
2. **Use JavaScript** to target specific elements
|
||||
3. **Navigate** to a more specific page
|
||||
|
||||
### Ref Points to Wrong Element
|
||||
|
||||
If a ref seems to interact with the wrong element:
|
||||
|
||||
1. Re-snapshot to get fresh refs
|
||||
2. Check if the page structure changed
|
||||
3. Verify with screenshot that the right element is targeted
|
||||
286
.agents/skills/agent-browser/references/video-recording.md
Normal file
286
.agents/skills/agent-browser/references/video-recording.md
Normal file
|
|
@ -0,0 +1,286 @@
|
|||
# Video Recording
|
||||
|
||||
Capture browser automation as video for debugging, documentation, or verification.
|
||||
|
||||
**Related**: [commands.md](commands.md) for full function reference, [SKILL.md](../SKILL.md) for quick start.
|
||||
|
||||
## Contents
|
||||
|
||||
- [Basic Recording](#basic-recording)
|
||||
- [Cursor Indicator](#cursor-indicator)
|
||||
- [How Recording Works](#how-recording-works)
|
||||
- [Use Cases](#use-cases)
|
||||
- [Best Practices](#best-practices)
|
||||
- [Output Format](#output-format)
|
||||
- [Limitations](#limitations)
|
||||
|
||||
## Basic Recording
|
||||
|
||||
Enable video recording when opening a session:
|
||||
|
||||
```bash
|
||||
# Start with recording enabled
|
||||
SESSION=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "https://example.com",
|
||||
"record_video": true
|
||||
}' | jq -r '.session_id')
|
||||
|
||||
# Perform actions
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "click", "ref": "@e1"
|
||||
}'
|
||||
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "fill", "ref": "@e2", "text": "test input"
|
||||
}'
|
||||
|
||||
# Close to get the video
|
||||
RESULT=$(infsh app run agent-browser --function close --session $SESSION --input '{}')
|
||||
VIDEO=$(echo $RESULT | jq -r '.video')
|
||||
echo "Video file: $VIDEO"
|
||||
```
|
||||
|
||||
## Cursor Indicator
|
||||
|
||||
For demos and documentation, show a visible cursor that follows mouse movements:
|
||||
|
||||
```bash
|
||||
SESSION=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "https://example.com",
|
||||
"record_video": true,
|
||||
"show_cursor": true
|
||||
}' | jq -r '.session_id')
|
||||
```
|
||||
|
||||
The cursor appears as a red dot that:
|
||||
- Follows mouse movements in real-time
|
||||
- Shows click feedback (shrinks on mousedown)
|
||||
- Persists across page navigations
|
||||
- Appears in both screenshots and video
|
||||
|
||||
This is especially useful for:
|
||||
- Tutorial/documentation videos
|
||||
- Debugging interaction issues
|
||||
- Sharing recordings with non-technical stakeholders
|
||||
|
||||
## How Recording Works
|
||||
|
||||
1. **Start**: Pass `"record_video": true` in the `open` function
|
||||
2. **Record**: All browser activity is captured throughout the session
|
||||
3. **Stop**: Video is finalized when `close` is called
|
||||
4. **Retrieve**: Video file is returned in the `close` response
|
||||
|
||||
The video captures:
|
||||
- Page loads and navigations
|
||||
- Element interactions (clicks, typing)
|
||||
- Scrolling and animations
|
||||
- Dynamic content changes
|
||||
|
||||
## Use Cases
|
||||
|
||||
### Debugging Failed Automation
|
||||
|
||||
```bash
|
||||
#!/bin/bash
|
||||
# Record automation for debugging
|
||||
|
||||
SESSION=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "https://app.example.com",
|
||||
"record_video": true
|
||||
}' | jq -r '.session_id')
|
||||
|
||||
# Run automation
|
||||
RESULT=$(infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "click", "ref": "@e1"
|
||||
}')
|
||||
|
||||
SUCCESS=$(echo $RESULT | jq -r '.success')
|
||||
if [ "$SUCCESS" != "true" ]; then
|
||||
echo "Action failed!"
|
||||
echo "Message: $(echo $RESULT | jq -r '.message')"
|
||||
|
||||
# Get video for debugging
|
||||
CLOSE_RESULT=$(infsh app run agent-browser --function close --session $SESSION --input '{}')
|
||||
echo "Debug video: $(echo $CLOSE_RESULT | jq -r '.video')"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
infsh app run agent-browser --function close --session $SESSION --input '{}'
|
||||
```
|
||||
|
||||
### Documentation Generation
|
||||
|
||||
Record workflows for user documentation:
|
||||
|
||||
```bash
|
||||
#!/bin/bash
|
||||
# Record how-to video
|
||||
|
||||
SESSION=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "https://app.example.com/settings",
|
||||
"record_video": true,
|
||||
"width": 1920,
|
||||
"height": 1080
|
||||
}' | jq -r '.session_id')
|
||||
|
||||
# Add pauses for clarity
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "wait", "wait_ms": 1000
|
||||
}'
|
||||
|
||||
# Step 1: Click settings
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "click", "ref": "@e5"
|
||||
}'
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "wait", "wait_ms": 500
|
||||
}'
|
||||
|
||||
# Step 2: Change setting
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "click", "ref": "@e10"
|
||||
}'
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "wait", "wait_ms": 500
|
||||
}'
|
||||
|
||||
# Step 3: Save
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "click", "ref": "@e15"
|
||||
}'
|
||||
infsh app run agent-browser --function interact --session $SESSION --input '{
|
||||
"action": "wait", "wait_ms": 1000
|
||||
}'
|
||||
|
||||
# Get the video
|
||||
RESULT=$(infsh app run agent-browser --function close --session $SESSION --input '{}')
|
||||
echo "Documentation video: $(echo $RESULT | jq -r '.video')"
|
||||
```
|
||||
|
||||
### Test Evidence for CI/CD
|
||||
|
||||
```bash
|
||||
#!/bin/bash
|
||||
# Record E2E test for CI artifacts
|
||||
|
||||
TEST_NAME="${1:-e2e-test}"
|
||||
|
||||
SESSION=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "'"$TEST_URL"'",
|
||||
"record_video": true
|
||||
}' | jq -r '.session_id')
|
||||
|
||||
# Run test steps
|
||||
run_test_steps $SESSION
|
||||
TEST_RESULT=$?
|
||||
|
||||
# Always get video
|
||||
CLOSE_RESULT=$(infsh app run agent-browser --function close --session $SESSION --input '{}')
|
||||
VIDEO=$(echo $CLOSE_RESULT | jq -r '.video')
|
||||
|
||||
# Save to artifacts
|
||||
if [ -n "$CI_ARTIFACTS_DIR" ]; then
|
||||
cp "$VIDEO" "$CI_ARTIFACTS_DIR/${TEST_NAME}.webm"
|
||||
fi
|
||||
|
||||
exit $TEST_RESULT
|
||||
```
|
||||
|
||||
### Monitoring and Auditing
|
||||
|
||||
```bash
|
||||
#!/bin/bash
|
||||
# Record automated task for audit trail
|
||||
|
||||
TASK_ID=$(date +%Y%m%d-%H%M%S)
|
||||
|
||||
SESSION=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "https://admin.example.com",
|
||||
"record_video": true
|
||||
}' | jq -r '.session_id')
|
||||
|
||||
# Perform admin task
|
||||
# ... automation steps ...
|
||||
|
||||
# Save recording
|
||||
RESULT=$(infsh app run agent-browser --function close --session $SESSION --input '{}')
|
||||
VIDEO=$(echo $RESULT | jq -r '.video')
|
||||
|
||||
# Archive for audit
|
||||
mv "$VIDEO" "/audit/recordings/${TASK_ID}.webm"
|
||||
echo "Audit recording saved: ${TASK_ID}.webm"
|
||||
```
|
||||
|
||||
## Best Practices
|
||||
|
||||
### 1. Add Strategic Pauses
|
||||
|
||||
Pauses make videos easier to follow:
|
||||
|
||||
```bash
|
||||
# After significant actions, add a pause
|
||||
'{"action": "click", "ref": "@e1"}'
|
||||
'{"action": "wait", "wait_ms": 500}' # Let viewer see result
|
||||
```
|
||||
|
||||
### 2. Use Larger Viewport for Documentation
|
||||
|
||||
```bash
|
||||
'{"url": "...", "record_video": true, "width": 1920, "height": 1080}'
|
||||
```
|
||||
|
||||
### 3. Handle Errors Gracefully
|
||||
|
||||
Always retrieve video even on failure:
|
||||
|
||||
```bash
|
||||
cleanup() {
|
||||
if [ -n "$SESSION" ]; then
|
||||
infsh app run agent-browser --function close --session $SESSION --input '{}' 2>/dev/null
|
||||
fi
|
||||
}
|
||||
trap cleanup EXIT
|
||||
```
|
||||
|
||||
### 4. Combine with Screenshots
|
||||
|
||||
Use screenshots for key frames, video for flow:
|
||||
|
||||
```bash
|
||||
# Record overall flow
|
||||
'{"record_video": true}'
|
||||
|
||||
# Capture key states
|
||||
infsh app run agent-browser --function screenshot --session $SESSION --input '{
|
||||
"full_page": true
|
||||
}'
|
||||
```
|
||||
|
||||
### 5. Don't Record Sensitive Sessions
|
||||
|
||||
Avoid recording when handling credentials:
|
||||
|
||||
```bash
|
||||
if [ "$CONTAINS_SENSITIVE_DATA" = "true" ]; then
|
||||
RECORD="false"
|
||||
else
|
||||
RECORD="true"
|
||||
fi
|
||||
|
||||
'{"url": "...", "record_video": '$RECORD'}'
|
||||
```
|
||||
|
||||
## Output Format
|
||||
|
||||
- **Format**: WebM (VP8/VP9 codec)
|
||||
- **Compatibility**: All modern browsers and video players
|
||||
- **Quality**: Matches viewport size
|
||||
- **Compression**: Efficient for screen content
|
||||
|
||||
## Limitations
|
||||
|
||||
1. **Session-level only** - Can't start/stop mid-session
|
||||
2. **Memory usage** - Long sessions consume more memory
|
||||
3. **File size** - Complex pages with animations produce larger files
|
||||
4. **No audio** - Browser audio is not captured
|
||||
5. **Returned on close** - Video only available after session ends
|
||||
138
.agents/skills/agent-browser/templates/authenticated-session.sh
Normal file
138
.agents/skills/agent-browser/templates/authenticated-session.sh
Normal file
|
|
@ -0,0 +1,138 @@
|
|||
#!/bin/bash
|
||||
# Template: Authenticated Session Workflow
|
||||
# Purpose: Login once, perform actions, clean up
|
||||
# Usage: ./authenticated-session.sh <login-url>
|
||||
#
|
||||
# Environment variables:
|
||||
# APP_USERNAME - Login username/email
|
||||
# APP_PASSWORD - Login password
|
||||
#
|
||||
# Two modes:
|
||||
# 1. Discovery mode (default): Shows login form structure
|
||||
# 2. Login mode: Performs actual login after you update refs
|
||||
#
|
||||
# Setup steps:
|
||||
# 1. Run once to see form structure (discovery mode)
|
||||
# 2. Update refs in LOGIN FLOW section below
|
||||
# 3. Set APP_USERNAME and APP_PASSWORD
|
||||
# 4. Comment out the DISCOVERY section
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
LOGIN_URL="${1:?Usage: $0 <login-url>}"
|
||||
|
||||
echo "Authentication workflow: $LOGIN_URL"
|
||||
|
||||
# Cleanup handler
|
||||
cleanup() {
|
||||
if [ -n "${SESSION_ID:-}" ]; then
|
||||
echo "Closing session..."
|
||||
infsh app run agent-browser --function close --session $SESSION_ID --input '{}' 2>/dev/null || true
|
||||
fi
|
||||
}
|
||||
trap cleanup EXIT
|
||||
|
||||
# ================================================================
|
||||
# DISCOVERY MODE: Shows login form structure
|
||||
# Delete this section after setup
|
||||
# ================================================================
|
||||
echo "Opening login page..."
|
||||
RESULT=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "'"$LOGIN_URL"'"
|
||||
}')
|
||||
SESSION_ID=$(echo $RESULT | jq -r '.session_id')
|
||||
|
||||
echo ""
|
||||
echo "Login form structure:"
|
||||
echo "---"
|
||||
echo $RESULT | jq -r '.elements_text'
|
||||
echo "---"
|
||||
echo ""
|
||||
echo "Discovery mode complete."
|
||||
echo ""
|
||||
echo "Next steps:"
|
||||
echo " 1. Identify the refs: username=@e?, password=@e?, submit=@e?"
|
||||
echo " 2. Update the LOGIN FLOW section below with your refs"
|
||||
echo " 3. Set environment variables:"
|
||||
echo " export APP_USERNAME='your-username'"
|
||||
echo " export APP_PASSWORD='your-password'"
|
||||
echo " 4. Comment out this DISCOVERY MODE section"
|
||||
echo ""
|
||||
exit 0
|
||||
|
||||
# ================================================================
|
||||
# LOGIN FLOW: Uncomment and customize after discovery
|
||||
# ================================================================
|
||||
# : "${APP_USERNAME:?Set APP_USERNAME environment variable}"
|
||||
# : "${APP_PASSWORD:?Set APP_PASSWORD environment variable}"
|
||||
#
|
||||
# echo "Opening login page..."
|
||||
# RESULT=$(infsh app run agent-browser --function open --session new --input '{
|
||||
# "url": "'"$LOGIN_URL"'",
|
||||
# "record_video": false
|
||||
# }')
|
||||
# SESSION_ID=$(echo $RESULT | jq -r '.session_id')
|
||||
#
|
||||
# echo "Filling credentials..."
|
||||
# # Update @e1, @e2, @e3 to match your form
|
||||
# infsh app run agent-browser --function interact --session $SESSION_ID --input '{
|
||||
# "action": "fill", "ref": "@e1", "text": "'"$APP_USERNAME"'"
|
||||
# }'
|
||||
#
|
||||
# infsh app run agent-browser --function interact --session $SESSION_ID --input '{
|
||||
# "action": "fill", "ref": "@e2", "text": "'"$APP_PASSWORD"'"
|
||||
# }'
|
||||
#
|
||||
# echo "Submitting..."
|
||||
# infsh app run agent-browser --function interact --session $SESSION_ID --input '{
|
||||
# "action": "click", "ref": "@e3"
|
||||
# }'
|
||||
#
|
||||
# # Wait for redirect
|
||||
# infsh app run agent-browser --function interact --session $SESSION_ID --input '{
|
||||
# "action": "wait", "wait_ms": 3000
|
||||
# }'
|
||||
#
|
||||
# # Verify login succeeded
|
||||
# RESULT=$(infsh app run agent-browser --function snapshot --session $SESSION_ID --input '{}')
|
||||
# URL=$(echo $RESULT | jq -r '.url')
|
||||
#
|
||||
# if [[ "$URL" == *"/login"* ]] || [[ "$URL" == *"/signin"* ]]; then
|
||||
# echo "ERROR: Login failed - still on login page"
|
||||
# echo "URL: $URL"
|
||||
# infsh app run agent-browser --function screenshot --session $SESSION_ID --input '{}' > login-failed.json
|
||||
# exit 1
|
||||
# fi
|
||||
#
|
||||
# echo "Login successful!"
|
||||
# echo "Current URL: $URL"
|
||||
# echo ""
|
||||
#
|
||||
# # ================================================================
|
||||
# # AUTHENTICATED ACTIONS: Add your post-login automation here
|
||||
# # ================================================================
|
||||
# echo "Performing authenticated actions..."
|
||||
#
|
||||
# # Example: Navigate to dashboard
|
||||
# # infsh app run agent-browser --function interact --session $SESSION_ID --input '{
|
||||
# # "action": "goto", "url": "https://app.example.com/dashboard"
|
||||
# # }'
|
||||
#
|
||||
# # Example: Click a menu item
|
||||
# # infsh app run agent-browser --function interact --session $SESSION_ID --input '{
|
||||
# # "action": "click", "ref": "@e5"
|
||||
# # }'
|
||||
#
|
||||
# # Example: Extract data
|
||||
# # RESULT=$(infsh app run agent-browser --function execute --session $SESSION_ID --input '{
|
||||
# # "code": "document.querySelector(\".user-data\").textContent"
|
||||
# # }')
|
||||
# # echo "Data: $(echo $RESULT | jq -r '.result')"
|
||||
#
|
||||
# # Example: Take screenshot of authenticated page
|
||||
# # infsh app run agent-browser --function screenshot --session $SESSION_ID --input '{
|
||||
# # "full_page": true
|
||||
# # }' > authenticated-page.json
|
||||
#
|
||||
# echo ""
|
||||
# echo "Authenticated session complete"
|
||||
149
.agents/skills/agent-browser/templates/capture-workflow.sh
Normal file
149
.agents/skills/agent-browser/templates/capture-workflow.sh
Normal file
|
|
@ -0,0 +1,149 @@
|
|||
#!/bin/bash
|
||||
# Template: Content Capture Workflow
|
||||
# Purpose: Extract content from web pages (text, screenshots, video)
|
||||
# Usage: ./capture-workflow.sh <url> [output-dir]
|
||||
#
|
||||
# Outputs:
|
||||
# - page-screenshot.json: Page screenshot data
|
||||
# - page-full-screenshot.json: Full page screenshot data
|
||||
# - page-elements.txt: Interactive elements with refs
|
||||
# - page-text.txt: All text content
|
||||
# - page-links.txt: All links on the page
|
||||
# - session-video.json: Video recording (if enabled)
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
TARGET_URL="${1:?Usage: $0 <url> [output-dir]}"
|
||||
OUTPUT_DIR="${2:-.}"
|
||||
|
||||
echo "Content capture: $TARGET_URL"
|
||||
echo "Output directory: $OUTPUT_DIR"
|
||||
|
||||
mkdir -p "$OUTPUT_DIR"
|
||||
|
||||
# Cleanup handler
|
||||
cleanup() {
|
||||
if [ -n "${SESSION_ID:-}" ]; then
|
||||
echo "Closing session..."
|
||||
CLOSE_RESULT=$(infsh app run agent-browser --function close --session $SESSION_ID --input '{}' 2>/dev/null || echo '{}')
|
||||
|
||||
# Save video if available
|
||||
VIDEO=$(echo $CLOSE_RESULT | jq -r '.video // empty')
|
||||
if [ -n "$VIDEO" ]; then
|
||||
echo "$CLOSE_RESULT" > "$OUTPUT_DIR/session-video.json"
|
||||
echo "Video saved to: $OUTPUT_DIR/session-video.json"
|
||||
fi
|
||||
fi
|
||||
}
|
||||
trap cleanup EXIT
|
||||
|
||||
# ================================================================
|
||||
# CONFIGURATION
|
||||
# ================================================================
|
||||
RECORD_VIDEO=false # Set to true to record video
|
||||
FULL_PAGE=true # Set to true for full page screenshots
|
||||
EXTRACT_LINKS=true # Set to true to extract all links
|
||||
SCROLL_PAGES=0 # Number of scroll actions for infinite scroll pages
|
||||
|
||||
# ================================================================
|
||||
# CAPTURE WORKFLOW
|
||||
# ================================================================
|
||||
|
||||
# Start session
|
||||
echo "Opening page..."
|
||||
RESULT=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "'"$TARGET_URL"'",
|
||||
"record_video": '$RECORD_VIDEO',
|
||||
"width": 1920,
|
||||
"height": 1080
|
||||
}')
|
||||
SESSION_ID=$(echo $RESULT | jq -r '.session_id')
|
||||
|
||||
# Get metadata
|
||||
URL=$(echo $RESULT | jq -r '.url')
|
||||
TITLE=$(echo $RESULT | jq -r '.title')
|
||||
echo "Title: $TITLE"
|
||||
echo "URL: $URL"
|
||||
|
||||
# Save elements
|
||||
echo $RESULT | jq -r '.elements_text' > "$OUTPUT_DIR/page-elements.txt"
|
||||
echo "Elements saved to: $OUTPUT_DIR/page-elements.txt"
|
||||
|
||||
# Handle infinite scroll (if configured)
|
||||
if [ $SCROLL_PAGES -gt 0 ]; then
|
||||
echo "Scrolling through $SCROLL_PAGES pages..."
|
||||
for ((i=1; i<=SCROLL_PAGES; i++)); do
|
||||
infsh app run agent-browser --function interact --session $SESSION_ID --input '{
|
||||
"action": "scroll", "direction": "down", "scroll_amount": 800
|
||||
}' > /dev/null
|
||||
infsh app run agent-browser --function interact --session $SESSION_ID --input '{
|
||||
"action": "wait", "wait_ms": 1000
|
||||
}' > /dev/null
|
||||
echo " Scrolled page $i/$SCROLL_PAGES"
|
||||
done
|
||||
|
||||
# Re-snapshot after scrolling
|
||||
RESULT=$(infsh app run agent-browser --function snapshot --session $SESSION_ID --input '{}')
|
||||
fi
|
||||
|
||||
# Take viewport screenshot
|
||||
echo "Taking viewport screenshot..."
|
||||
infsh app run agent-browser --function screenshot --session $SESSION_ID --input '{}' > "$OUTPUT_DIR/page-screenshot.json"
|
||||
echo "Screenshot saved to: $OUTPUT_DIR/page-screenshot.json"
|
||||
|
||||
# Take full page screenshot (if configured)
|
||||
if [ "$FULL_PAGE" = true ]; then
|
||||
echo "Taking full page screenshot..."
|
||||
infsh app run agent-browser --function screenshot --session $SESSION_ID --input '{
|
||||
"full_page": true
|
||||
}' > "$OUTPUT_DIR/page-full-screenshot.json"
|
||||
echo "Full screenshot saved to: $OUTPUT_DIR/page-full-screenshot.json"
|
||||
fi
|
||||
|
||||
# Extract all text content
|
||||
echo "Extracting text content..."
|
||||
RESULT=$(infsh app run agent-browser --function execute --session $SESSION_ID --input '{
|
||||
"code": "document.body.innerText"
|
||||
}')
|
||||
echo $RESULT | jq -r '.result' > "$OUTPUT_DIR/page-text.txt"
|
||||
echo "Text saved to: $OUTPUT_DIR/page-text.txt"
|
||||
|
||||
# Extract all links (if configured)
|
||||
if [ "$EXTRACT_LINKS" = true ]; then
|
||||
echo "Extracting links..."
|
||||
RESULT=$(infsh app run agent-browser --function execute --session $SESSION_ID --input '{
|
||||
"code": "Array.from(document.querySelectorAll(\"a[href]\")).map(a => a.href + \" | \" + (a.textContent || \"\").trim().slice(0,50)).join(\"\\n\")"
|
||||
}')
|
||||
echo $RESULT | jq -r '.result' > "$OUTPUT_DIR/page-links.txt"
|
||||
echo "Links saved to: $OUTPUT_DIR/page-links.txt"
|
||||
fi
|
||||
|
||||
# ================================================================
|
||||
# CUSTOM EXTRACTION: Add your specific extraction logic here
|
||||
# ================================================================
|
||||
|
||||
# Example: Extract specific elements by selector
|
||||
# RESULT=$(infsh app run agent-browser --function execute --session $SESSION_ID --input '{
|
||||
# "code": "Array.from(document.querySelectorAll(\"h2\")).map(h => h.textContent).join(\"\\n\")"
|
||||
# }')
|
||||
# echo $RESULT | jq -r '.result' > "$OUTPUT_DIR/headings.txt"
|
||||
|
||||
# Example: Extract JSON data from script tag
|
||||
# RESULT=$(infsh app run agent-browser --function execute --session $SESSION_ID --input '{
|
||||
# "code": "JSON.parse(document.querySelector(\"script[type=application/json]\").textContent)"
|
||||
# }')
|
||||
# echo $RESULT | jq '.result' > "$OUTPUT_DIR/json-data.json"
|
||||
|
||||
# Example: Extract table data
|
||||
# RESULT=$(infsh app run agent-browser --function execute --session $SESSION_ID --input '{
|
||||
# "code": "Array.from(document.querySelectorAll(\"table tr\")).map(tr => Array.from(tr.cells).map(td => td.textContent.trim()).join(\",\")).join(\"\\n\")"
|
||||
# }')
|
||||
# echo $RESULT | jq -r '.result' > "$OUTPUT_DIR/table-data.csv"
|
||||
|
||||
# ================================================================
|
||||
# SUMMARY
|
||||
# ================================================================
|
||||
echo ""
|
||||
echo "Capture complete!"
|
||||
echo "Files created:"
|
||||
ls -la "$OUTPUT_DIR"/*.txt "$OUTPUT_DIR"/*.json 2>/dev/null || true
|
||||
126
.agents/skills/agent-browser/templates/form-automation.sh
Normal file
126
.agents/skills/agent-browser/templates/form-automation.sh
Normal file
|
|
@ -0,0 +1,126 @@
|
|||
#!/bin/bash
|
||||
# Template: Form Automation Workflow
|
||||
# Purpose: Fill and submit web forms with validation
|
||||
# Usage: ./form-automation.sh <form-url>
|
||||
#
|
||||
# This template demonstrates the snapshot-interact-verify pattern:
|
||||
# 1. Navigate to form
|
||||
# 2. Snapshot to get element refs
|
||||
# 3. Fill fields using refs
|
||||
# 4. Submit and verify result
|
||||
#
|
||||
# Customize: Update the refs (@e1, @e2, etc.) based on your form's snapshot output
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
FORM_URL="${1:?Usage: $0 <form-url>}"
|
||||
|
||||
echo "Form automation: $FORM_URL"
|
||||
|
||||
# Cleanup handler
|
||||
cleanup() {
|
||||
if [ -n "${SESSION_ID:-}" ]; then
|
||||
infsh app run agent-browser --function close --session $SESSION_ID --input '{}' 2>/dev/null || true
|
||||
fi
|
||||
}
|
||||
trap cleanup EXIT
|
||||
|
||||
# Step 1: Navigate to form
|
||||
echo "Opening form..."
|
||||
RESULT=$(infsh app run agent-browser --function open --session new --input '{
|
||||
"url": "'"$FORM_URL"'"
|
||||
}')
|
||||
SESSION_ID=$(echo $RESULT | jq -r '.session_id')
|
||||
|
||||
# Step 2: Display form structure
|
||||
echo ""
|
||||
echo "Form elements:"
|
||||
echo "---"
|
||||
echo $RESULT | jq -r '.elements_text'
|
||||
echo "---"
|
||||
echo ""
|
||||
|
||||
# ================================================================
|
||||
# DISCOVERY MODE: Shows form structure
|
||||
# After running once, update the FORM FILL section below with your refs
|
||||
# then delete or comment out this section
|
||||
# ================================================================
|
||||
echo "Discovery mode: Form structure shown above"
|
||||
echo ""
|
||||
echo "Next steps:"
|
||||
echo " 1. Note the refs for your form fields (e.g., @e1 for name, @e2 for email)"
|
||||
echo " 2. Update the FORM FILL section below"
|
||||
echo " 3. Set environment variables for form data"
|
||||
echo " 4. Comment out this discovery section"
|
||||
echo ""
|
||||
exit 0
|
||||
|
||||
# ================================================================
|
||||
# FORM FILL: Uncomment and customize after discovery
|
||||
# ================================================================
|
||||
# echo "Filling form..."
|
||||
#
|
||||
# # Text input
|
||||
# infsh app run agent-browser --function interact --session $SESSION_ID --input '{
|
||||
# "action": "fill", "ref": "@e1", "text": "'"${FORM_NAME:-John Doe}"'"
|
||||
# }'
|
||||
#
|
||||
# # Email input
|
||||
# infsh app run agent-browser --function interact --session $SESSION_ID --input '{
|
||||
# "action": "fill", "ref": "@e2", "text": "'"${FORM_EMAIL:-john@example.com}"'"
|
||||
# }'
|
||||
#
|
||||
# # Dropdown/select
|
||||
# infsh app run agent-browser --function interact --session $SESSION_ID --input '{
|
||||
# "action": "select", "ref": "@e3", "text": "Option 1"
|
||||
# }'
|
||||
#
|
||||
# # Checkbox
|
||||
# infsh app run agent-browser --function interact --session $SESSION_ID --input '{
|
||||
# "action": "check", "ref": "@e4"
|
||||
# }'
|
||||
#
|
||||
# # Textarea
|
||||
# infsh app run agent-browser --function interact --session $SESSION_ID --input '{
|
||||
# "action": "fill", "ref": "@e5", "text": "'"${FORM_MESSAGE:-Hello, this is a test message.}"'"
|
||||
# }'
|
||||
#
|
||||
# # Submit button
|
||||
# echo "Submitting form..."
|
||||
# infsh app run agent-browser --function interact --session $SESSION_ID --input '{
|
||||
# "action": "click", "ref": "@e6"
|
||||
# }'
|
||||
#
|
||||
# # Wait for submission
|
||||
# infsh app run agent-browser --function interact --session $SESSION_ID --input '{
|
||||
# "action": "wait", "wait_ms": 2000
|
||||
# }'
|
||||
#
|
||||
# # Step 3: Verify result
|
||||
# echo ""
|
||||
# echo "Verifying submission..."
|
||||
# RESULT=$(infsh app run agent-browser --function snapshot --session $SESSION_ID --input '{}')
|
||||
#
|
||||
# URL=$(echo $RESULT | jq -r '.url')
|
||||
# TITLE=$(echo $RESULT | jq -r '.title')
|
||||
# echo "Final URL: $URL"
|
||||
# echo "Page title: $TITLE"
|
||||
#
|
||||
# # Check for success indicators
|
||||
# ELEMENTS=$(echo $RESULT | jq -r '.elements_text')
|
||||
# if echo "$ELEMENTS" | grep -qi "thank you\|success\|submitted"; then
|
||||
# echo "SUCCESS: Form submitted successfully"
|
||||
# elif echo "$URL" | grep -qi "error\|fail"; then
|
||||
# echo "ERROR: Form submission may have failed"
|
||||
# exit 1
|
||||
# else
|
||||
# echo "UNKNOWN: Check the result manually"
|
||||
# fi
|
||||
#
|
||||
# # Optional: Capture evidence
|
||||
# infsh app run agent-browser --function screenshot --session $SESSION_ID --input '{
|
||||
# "full_page": true
|
||||
# }' > form-result-screenshot.json
|
||||
# echo "Screenshot saved to form-result-screenshot.json"
|
||||
|
||||
echo "Done"
|
||||
663
.agents/skills/backtesting-frameworks/SKILL.md
Normal file
663
.agents/skills/backtesting-frameworks/SKILL.md
Normal file
|
|
@ -0,0 +1,663 @@
|
|||
---
|
||||
name: backtesting-frameworks
|
||||
description: Build robust backtesting systems for trading strategies with proper handling of look-ahead bias, survivorship bias, and transaction costs. Use when developing trading algorithms, validating strategies, or building backtesting infrastructure.
|
||||
---
|
||||
|
||||
# Backtesting Frameworks
|
||||
|
||||
Build robust, production-grade backtesting systems that avoid common pitfalls and produce reliable strategy performance estimates.
|
||||
|
||||
## When to Use This Skill
|
||||
|
||||
- Developing trading strategy backtests
|
||||
- Building backtesting infrastructure
|
||||
- Validating strategy performance
|
||||
- Avoiding common backtesting biases
|
||||
- Implementing walk-forward analysis
|
||||
- Comparing strategy alternatives
|
||||
|
||||
## Core Concepts
|
||||
|
||||
### 1. Backtesting Biases
|
||||
|
||||
| Bias | Description | Mitigation |
|
||||
| ---------------- | ------------------------- | ----------------------- |
|
||||
| **Look-ahead** | Using future information | Point-in-time data |
|
||||
| **Survivorship** | Only testing on survivors | Use delisted securities |
|
||||
| **Overfitting** | Curve-fitting to history | Out-of-sample testing |
|
||||
| **Selection** | Cherry-picking strategies | Pre-registration |
|
||||
| **Transaction** | Ignoring trading costs | Realistic cost models |
|
||||
|
||||
### 2. Proper Backtest Structure
|
||||
|
||||
```
|
||||
Historical Data
|
||||
│
|
||||
▼
|
||||
┌─────────────────────────────────────────┐
|
||||
│ Training Set │
|
||||
│ (Strategy Development & Optimization) │
|
||||
└─────────────────────────────────────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────────────────────────────────┐
|
||||
│ Validation Set │
|
||||
│ (Parameter Selection, No Peeking) │
|
||||
└─────────────────────────────────────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────────────────────────────────┐
|
||||
│ Test Set │
|
||||
│ (Final Performance Evaluation) │
|
||||
└─────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 3. Walk-Forward Analysis
|
||||
|
||||
```
|
||||
Window 1: [Train──────][Test]
|
||||
Window 2: [Train──────][Test]
|
||||
Window 3: [Train──────][Test]
|
||||
Window 4: [Train──────][Test]
|
||||
─────▶ Time
|
||||
```
|
||||
|
||||
## Implementation Patterns
|
||||
|
||||
### Pattern 1: Event-Driven Backtester
|
||||
|
||||
```python
|
||||
from abc import ABC, abstractmethod
|
||||
from dataclasses import dataclass, field
|
||||
from datetime import datetime
|
||||
from decimal import Decimal
|
||||
from enum import Enum
|
||||
from typing import Dict, List, Optional
|
||||
import pandas as pd
|
||||
import numpy as np
|
||||
|
||||
class OrderSide(Enum):
|
||||
BUY = "buy"
|
||||
SELL = "sell"
|
||||
|
||||
class OrderType(Enum):
|
||||
MARKET = "market"
|
||||
LIMIT = "limit"
|
||||
STOP = "stop"
|
||||
|
||||
@dataclass
|
||||
class Order:
|
||||
symbol: str
|
||||
side: OrderSide
|
||||
quantity: Decimal
|
||||
order_type: OrderType
|
||||
limit_price: Optional[Decimal] = None
|
||||
stop_price: Optional[Decimal] = None
|
||||
timestamp: Optional[datetime] = None
|
||||
|
||||
@dataclass
|
||||
class Fill:
|
||||
order: Order
|
||||
fill_price: Decimal
|
||||
fill_quantity: Decimal
|
||||
commission: Decimal
|
||||
slippage: Decimal
|
||||
timestamp: datetime
|
||||
|
||||
@dataclass
|
||||
class Position:
|
||||
symbol: str
|
||||
quantity: Decimal = Decimal("0")
|
||||
avg_cost: Decimal = Decimal("0")
|
||||
realized_pnl: Decimal = Decimal("0")
|
||||
|
||||
def update(self, fill: Fill) -> None:
|
||||
if fill.order.side == OrderSide.BUY:
|
||||
new_quantity = self.quantity + fill.fill_quantity
|
||||
if new_quantity != 0:
|
||||
self.avg_cost = (
|
||||
(self.quantity * self.avg_cost + fill.fill_quantity * fill.fill_price)
|
||||
/ new_quantity
|
||||
)
|
||||
self.quantity = new_quantity
|
||||
else:
|
||||
self.realized_pnl += fill.fill_quantity * (fill.fill_price - self.avg_cost)
|
||||
self.quantity -= fill.fill_quantity
|
||||
|
||||
@dataclass
|
||||
class Portfolio:
|
||||
cash: Decimal
|
||||
positions: Dict[str, Position] = field(default_factory=dict)
|
||||
|
||||
def get_position(self, symbol: str) -> Position:
|
||||
if symbol not in self.positions:
|
||||
self.positions[symbol] = Position(symbol=symbol)
|
||||
return self.positions[symbol]
|
||||
|
||||
def process_fill(self, fill: Fill) -> None:
|
||||
position = self.get_position(fill.order.symbol)
|
||||
position.update(fill)
|
||||
|
||||
if fill.order.side == OrderSide.BUY:
|
||||
self.cash -= fill.fill_price * fill.fill_quantity + fill.commission
|
||||
else:
|
||||
self.cash += fill.fill_price * fill.fill_quantity - fill.commission
|
||||
|
||||
def get_equity(self, prices: Dict[str, Decimal]) -> Decimal:
|
||||
equity = self.cash
|
||||
for symbol, position in self.positions.items():
|
||||
if position.quantity != 0 and symbol in prices:
|
||||
equity += position.quantity * prices[symbol]
|
||||
return equity
|
||||
|
||||
class Strategy(ABC):
|
||||
@abstractmethod
|
||||
def on_bar(self, timestamp: datetime, data: pd.DataFrame) -> List[Order]:
|
||||
pass
|
||||
|
||||
@abstractmethod
|
||||
def on_fill(self, fill: Fill) -> None:
|
||||
pass
|
||||
|
||||
class ExecutionModel(ABC):
|
||||
@abstractmethod
|
||||
def execute(self, order: Order, bar: pd.Series) -> Optional[Fill]:
|
||||
pass
|
||||
|
||||
class SimpleExecutionModel(ExecutionModel):
|
||||
def __init__(self, slippage_bps: float = 10, commission_per_share: float = 0.01):
|
||||
self.slippage_bps = slippage_bps
|
||||
self.commission_per_share = commission_per_share
|
||||
|
||||
def execute(self, order: Order, bar: pd.Series) -> Optional[Fill]:
|
||||
if order.order_type == OrderType.MARKET:
|
||||
base_price = Decimal(str(bar["open"]))
|
||||
|
||||
# Apply slippage
|
||||
slippage_mult = 1 + (self.slippage_bps / 10000)
|
||||
if order.side == OrderSide.BUY:
|
||||
fill_price = base_price * Decimal(str(slippage_mult))
|
||||
else:
|
||||
fill_price = base_price / Decimal(str(slippage_mult))
|
||||
|
||||
commission = order.quantity * Decimal(str(self.commission_per_share))
|
||||
slippage = abs(fill_price - base_price) * order.quantity
|
||||
|
||||
return Fill(
|
||||
order=order,
|
||||
fill_price=fill_price,
|
||||
fill_quantity=order.quantity,
|
||||
commission=commission,
|
||||
slippage=slippage,
|
||||
timestamp=bar.name
|
||||
)
|
||||
return None
|
||||
|
||||
class Backtester:
|
||||
def __init__(
|
||||
self,
|
||||
strategy: Strategy,
|
||||
execution_model: ExecutionModel,
|
||||
initial_capital: Decimal = Decimal("100000")
|
||||
):
|
||||
self.strategy = strategy
|
||||
self.execution_model = execution_model
|
||||
self.portfolio = Portfolio(cash=initial_capital)
|
||||
self.equity_curve: List[tuple] = []
|
||||
self.trades: List[Fill] = []
|
||||
|
||||
def run(self, data: pd.DataFrame) -> pd.DataFrame:
|
||||
"""Run backtest on OHLCV data with DatetimeIndex."""
|
||||
pending_orders: List[Order] = []
|
||||
|
||||
for timestamp, bar in data.iterrows():
|
||||
# Execute pending orders at today's prices
|
||||
for order in pending_orders:
|
||||
fill = self.execution_model.execute(order, bar)
|
||||
if fill:
|
||||
self.portfolio.process_fill(fill)
|
||||
self.strategy.on_fill(fill)
|
||||
self.trades.append(fill)
|
||||
|
||||
pending_orders.clear()
|
||||
|
||||
# Get current prices for equity calculation
|
||||
prices = {data.index.name or "default": Decimal(str(bar["close"]))}
|
||||
equity = self.portfolio.get_equity(prices)
|
||||
self.equity_curve.append((timestamp, float(equity)))
|
||||
|
||||
# Generate new orders for next bar
|
||||
new_orders = self.strategy.on_bar(timestamp, data.loc[:timestamp])
|
||||
pending_orders.extend(new_orders)
|
||||
|
||||
return self._create_results()
|
||||
|
||||
def _create_results(self) -> pd.DataFrame:
|
||||
equity_df = pd.DataFrame(self.equity_curve, columns=["timestamp", "equity"])
|
||||
equity_df.set_index("timestamp", inplace=True)
|
||||
equity_df["returns"] = equity_df["equity"].pct_change()
|
||||
return equity_df
|
||||
```
|
||||
|
||||
### Pattern 2: Vectorized Backtester (Fast)
|
||||
|
||||
```python
|
||||
import pandas as pd
|
||||
import numpy as np
|
||||
from typing import Callable, Dict, Any
|
||||
|
||||
class VectorizedBacktester:
|
||||
"""Fast vectorized backtester for simple strategies."""
|
||||
|
||||
def __init__(
|
||||
self,
|
||||
initial_capital: float = 100000,
|
||||
commission: float = 0.001, # 0.1%
|
||||
slippage: float = 0.0005 # 0.05%
|
||||
):
|
||||
self.initial_capital = initial_capital
|
||||
self.commission = commission
|
||||
self.slippage = slippage
|
||||
|
||||
def run(
|
||||
self,
|
||||
prices: pd.DataFrame,
|
||||
signal_func: Callable[[pd.DataFrame], pd.Series]
|
||||
) -> Dict[str, Any]:
|
||||
"""
|
||||
Run backtest with signal function.
|
||||
|
||||
Args:
|
||||
prices: DataFrame with 'close' column
|
||||
signal_func: Function that returns position signals (-1, 0, 1)
|
||||
|
||||
Returns:
|
||||
Dictionary with results
|
||||
"""
|
||||
# Generate signals (shifted to avoid look-ahead)
|
||||
signals = signal_func(prices).shift(1).fillna(0)
|
||||
|
||||
# Calculate returns
|
||||
returns = prices["close"].pct_change()
|
||||
|
||||
# Calculate strategy returns with costs
|
||||
position_changes = signals.diff().abs()
|
||||
trading_costs = position_changes * (self.commission + self.slippage)
|
||||
|
||||
strategy_returns = signals * returns - trading_costs
|
||||
|
||||
# Build equity curve
|
||||
equity = (1 + strategy_returns).cumprod() * self.initial_capital
|
||||
|
||||
# Calculate metrics
|
||||
results = {
|
||||
"equity": equity,
|
||||
"returns": strategy_returns,
|
||||
"signals": signals,
|
||||
"metrics": self._calculate_metrics(strategy_returns, equity)
|
||||
}
|
||||
|
||||
return results
|
||||
|
||||
def _calculate_metrics(
|
||||
self,
|
||||
returns: pd.Series,
|
||||
equity: pd.Series
|
||||
) -> Dict[str, float]:
|
||||
"""Calculate performance metrics."""
|
||||
total_return = (equity.iloc[-1] / self.initial_capital) - 1
|
||||
annual_return = (1 + total_return) ** (252 / len(returns)) - 1
|
||||
annual_vol = returns.std() * np.sqrt(252)
|
||||
sharpe = annual_return / annual_vol if annual_vol > 0 else 0
|
||||
|
||||
# Drawdown
|
||||
rolling_max = equity.cummax()
|
||||
drawdown = (equity - rolling_max) / rolling_max
|
||||
max_drawdown = drawdown.min()
|
||||
|
||||
# Win rate
|
||||
winning_days = (returns > 0).sum()
|
||||
total_days = (returns != 0).sum()
|
||||
win_rate = winning_days / total_days if total_days > 0 else 0
|
||||
|
||||
return {
|
||||
"total_return": total_return,
|
||||
"annual_return": annual_return,
|
||||
"annual_volatility": annual_vol,
|
||||
"sharpe_ratio": sharpe,
|
||||
"max_drawdown": max_drawdown,
|
||||
"win_rate": win_rate,
|
||||
"num_trades": int((returns != 0).sum())
|
||||
}
|
||||
|
||||
# Example usage
|
||||
def momentum_signal(prices: pd.DataFrame, lookback: int = 20) -> pd.Series:
|
||||
"""Simple momentum strategy: long when price > SMA, else flat."""
|
||||
sma = prices["close"].rolling(lookback).mean()
|
||||
return (prices["close"] > sma).astype(int)
|
||||
|
||||
# Run backtest
|
||||
# backtester = VectorizedBacktester()
|
||||
# results = backtester.run(price_data, lambda p: momentum_signal(p, 50))
|
||||
```
|
||||
|
||||
### Pattern 3: Walk-Forward Optimization
|
||||
|
||||
```python
|
||||
from typing import Callable, Dict, List, Tuple, Any
|
||||
import pandas as pd
|
||||
import numpy as np
|
||||
from itertools import product
|
||||
|
||||
class WalkForwardOptimizer:
|
||||
"""Walk-forward analysis with anchored or rolling windows."""
|
||||
|
||||
def __init__(
|
||||
self,
|
||||
train_period: int,
|
||||
test_period: int,
|
||||
anchored: bool = False,
|
||||
n_splits: int = None
|
||||
):
|
||||
"""
|
||||
Args:
|
||||
train_period: Number of bars in training window
|
||||
test_period: Number of bars in test window
|
||||
anchored: If True, training always starts from beginning
|
||||
n_splits: Number of train/test splits (auto-calculated if None)
|
||||
"""
|
||||
self.train_period = train_period
|
||||
self.test_period = test_period
|
||||
self.anchored = anchored
|
||||
self.n_splits = n_splits
|
||||
|
||||
def generate_splits(
|
||||
self,
|
||||
data: pd.DataFrame
|
||||
) -> List[Tuple[pd.DataFrame, pd.DataFrame]]:
|
||||
"""Generate train/test splits."""
|
||||
splits = []
|
||||
n = len(data)
|
||||
|
||||
if self.n_splits:
|
||||
step = (n - self.train_period) // self.n_splits
|
||||
else:
|
||||
step = self.test_period
|
||||
|
||||
start = 0
|
||||
while start + self.train_period + self.test_period <= n:
|
||||
if self.anchored:
|
||||
train_start = 0
|
||||
else:
|
||||
train_start = start
|
||||
|
||||
train_end = start + self.train_period
|
||||
test_end = min(train_end + self.test_period, n)
|
||||
|
||||
train_data = data.iloc[train_start:train_end]
|
||||
test_data = data.iloc[train_end:test_end]
|
||||
|
||||
splits.append((train_data, test_data))
|
||||
start += step
|
||||
|
||||
return splits
|
||||
|
||||
def optimize(
|
||||
self,
|
||||
data: pd.DataFrame,
|
||||
strategy_func: Callable,
|
||||
param_grid: Dict[str, List],
|
||||
metric: str = "sharpe_ratio"
|
||||
) -> Dict[str, Any]:
|
||||
"""
|
||||
Run walk-forward optimization.
|
||||
|
||||
Args:
|
||||
data: Full dataset
|
||||
strategy_func: Function(data, **params) -> results dict
|
||||
param_grid: Parameter combinations to test
|
||||
metric: Metric to optimize
|
||||
|
||||
Returns:
|
||||
Combined results from all test periods
|
||||
"""
|
||||
splits = self.generate_splits(data)
|
||||
all_results = []
|
||||
optimal_params_history = []
|
||||
|
||||
for i, (train_data, test_data) in enumerate(splits):
|
||||
# Optimize on training data
|
||||
best_params, best_metric = self._grid_search(
|
||||
train_data, strategy_func, param_grid, metric
|
||||
)
|
||||
optimal_params_history.append(best_params)
|
||||
|
||||
# Test with optimal params
|
||||
test_results = strategy_func(test_data, **best_params)
|
||||
test_results["split"] = i
|
||||
test_results["params"] = best_params
|
||||
all_results.append(test_results)
|
||||
|
||||
print(f"Split {i+1}/{len(splits)}: "
|
||||
f"Best {metric}={best_metric:.4f}, params={best_params}")
|
||||
|
||||
return {
|
||||
"split_results": all_results,
|
||||
"param_history": optimal_params_history,
|
||||
"combined_equity": self._combine_equity_curves(all_results)
|
||||
}
|
||||
|
||||
def _grid_search(
|
||||
self,
|
||||
data: pd.DataFrame,
|
||||
strategy_func: Callable,
|
||||
param_grid: Dict[str, List],
|
||||
metric: str
|
||||
) -> Tuple[Dict, float]:
|
||||
"""Grid search for best parameters."""
|
||||
best_params = None
|
||||
best_metric = -np.inf
|
||||
|
||||
# Generate all parameter combinations
|
||||
param_names = list(param_grid.keys())
|
||||
param_values = list(param_grid.values())
|
||||
|
||||
for values in product(*param_values):
|
||||
params = dict(zip(param_names, values))
|
||||
results = strategy_func(data, **params)
|
||||
|
||||
if results["metrics"][metric] > best_metric:
|
||||
best_metric = results["metrics"][metric]
|
||||
best_params = params
|
||||
|
||||
return best_params, best_metric
|
||||
|
||||
def _combine_equity_curves(
|
||||
self,
|
||||
results: List[Dict]
|
||||
) -> pd.Series:
|
||||
"""Combine equity curves from all test periods."""
|
||||
combined = pd.concat([r["equity"] for r in results])
|
||||
return combined
|
||||
```
|
||||
|
||||
### Pattern 4: Monte Carlo Analysis
|
||||
|
||||
```python
|
||||
import numpy as np
|
||||
import pandas as pd
|
||||
from typing import Dict, List
|
||||
|
||||
class MonteCarloAnalyzer:
|
||||
"""Monte Carlo simulation for strategy robustness."""
|
||||
|
||||
def __init__(self, n_simulations: int = 1000, confidence: float = 0.95):
|
||||
self.n_simulations = n_simulations
|
||||
self.confidence = confidence
|
||||
|
||||
def bootstrap_returns(
|
||||
self,
|
||||
returns: pd.Series,
|
||||
n_periods: int = None
|
||||
) -> np.ndarray:
|
||||
"""
|
||||
Bootstrap simulation by resampling returns.
|
||||
|
||||
Args:
|
||||
returns: Historical returns series
|
||||
n_periods: Length of each simulation (default: same as input)
|
||||
|
||||
Returns:
|
||||
Array of shape (n_simulations, n_periods)
|
||||
"""
|
||||
if n_periods is None:
|
||||
n_periods = len(returns)
|
||||
|
||||
simulations = np.zeros((self.n_simulations, n_periods))
|
||||
|
||||
for i in range(self.n_simulations):
|
||||
# Resample with replacement
|
||||
simulated_returns = np.random.choice(
|
||||
returns.values,
|
||||
size=n_periods,
|
||||
replace=True
|
||||
)
|
||||
simulations[i] = simulated_returns
|
||||
|
||||
return simulations
|
||||
|
||||
def analyze_drawdowns(
|
||||
self,
|
||||
returns: pd.Series
|
||||
) -> Dict[str, float]:
|
||||
"""Analyze drawdown distribution via simulation."""
|
||||
simulations = self.bootstrap_returns(returns)
|
||||
|
||||
max_drawdowns = []
|
||||
for sim_returns in simulations:
|
||||
equity = (1 + sim_returns).cumprod()
|
||||
rolling_max = np.maximum.accumulate(equity)
|
||||
drawdowns = (equity - rolling_max) / rolling_max
|
||||
max_drawdowns.append(drawdowns.min())
|
||||
|
||||
max_drawdowns = np.array(max_drawdowns)
|
||||
|
||||
return {
|
||||
"expected_max_dd": np.mean(max_drawdowns),
|
||||
"median_max_dd": np.median(max_drawdowns),
|
||||
f"worst_{int(self.confidence*100)}pct": np.percentile(
|
||||
max_drawdowns, (1 - self.confidence) * 100
|
||||
),
|
||||
"worst_case": max_drawdowns.min()
|
||||
}
|
||||
|
||||
def probability_of_loss(
|
||||
self,
|
||||
returns: pd.Series,
|
||||
holding_periods: List[int] = [21, 63, 126, 252]
|
||||
) -> Dict[int, float]:
|
||||
"""Calculate probability of loss over various holding periods."""
|
||||
results = {}
|
||||
|
||||
for period in holding_periods:
|
||||
if period > len(returns):
|
||||
continue
|
||||
|
||||
simulations = self.bootstrap_returns(returns, period)
|
||||
total_returns = (1 + simulations).prod(axis=1) - 1
|
||||
prob_loss = (total_returns < 0).mean()
|
||||
results[period] = prob_loss
|
||||
|
||||
return results
|
||||
|
||||
def confidence_interval(
|
||||
self,
|
||||
returns: pd.Series,
|
||||
periods: int = 252
|
||||
) -> Dict[str, float]:
|
||||
"""Calculate confidence interval for future returns."""
|
||||
simulations = self.bootstrap_returns(returns, periods)
|
||||
total_returns = (1 + simulations).prod(axis=1) - 1
|
||||
|
||||
lower = (1 - self.confidence) / 2
|
||||
upper = 1 - lower
|
||||
|
||||
return {
|
||||
"expected": total_returns.mean(),
|
||||
"lower_bound": np.percentile(total_returns, lower * 100),
|
||||
"upper_bound": np.percentile(total_returns, upper * 100),
|
||||
"std": total_returns.std()
|
||||
}
|
||||
```
|
||||
|
||||
## Performance Metrics
|
||||
|
||||
```python
|
||||
def calculate_metrics(returns: pd.Series, rf_rate: float = 0.02) -> Dict[str, float]:
|
||||
"""Calculate comprehensive performance metrics."""
|
||||
# Annualization factor (assuming daily returns)
|
||||
ann_factor = 252
|
||||
|
||||
# Basic metrics
|
||||
total_return = (1 + returns).prod() - 1
|
||||
annual_return = (1 + total_return) ** (ann_factor / len(returns)) - 1
|
||||
annual_vol = returns.std() * np.sqrt(ann_factor)
|
||||
|
||||
# Risk-adjusted returns
|
||||
sharpe = (annual_return - rf_rate) / annual_vol if annual_vol > 0 else 0
|
||||
|
||||
# Sortino (downside deviation)
|
||||
downside_returns = returns[returns < 0]
|
||||
downside_vol = downside_returns.std() * np.sqrt(ann_factor)
|
||||
sortino = (annual_return - rf_rate) / downside_vol if downside_vol > 0 else 0
|
||||
|
||||
# Calmar ratio
|
||||
equity = (1 + returns).cumprod()
|
||||
rolling_max = equity.cummax()
|
||||
drawdowns = (equity - rolling_max) / rolling_max
|
||||
max_drawdown = drawdowns.min()
|
||||
calmar = annual_return / abs(max_drawdown) if max_drawdown != 0 else 0
|
||||
|
||||
# Win rate and profit factor
|
||||
wins = returns[returns > 0]
|
||||
losses = returns[returns < 0]
|
||||
win_rate = len(wins) / len(returns[returns != 0]) if len(returns[returns != 0]) > 0 else 0
|
||||
profit_factor = wins.sum() / abs(losses.sum()) if losses.sum() != 0 else np.inf
|
||||
|
||||
return {
|
||||
"total_return": total_return,
|
||||
"annual_return": annual_return,
|
||||
"annual_volatility": annual_vol,
|
||||
"sharpe_ratio": sharpe,
|
||||
"sortino_ratio": sortino,
|
||||
"calmar_ratio": calmar,
|
||||
"max_drawdown": max_drawdown,
|
||||
"win_rate": win_rate,
|
||||
"profit_factor": profit_factor,
|
||||
"num_trades": int((returns != 0).sum())
|
||||
}
|
||||
```
|
||||
|
||||
## Best Practices
|
||||
|
||||
### Do's
|
||||
|
||||
- **Use point-in-time data** - Avoid look-ahead bias
|
||||
- **Include transaction costs** - Realistic estimates
|
||||
- **Test out-of-sample** - Always reserve data
|
||||
- **Use walk-forward** - Not just train/test
|
||||
- **Monte Carlo analysis** - Understand uncertainty
|
||||
|
||||
### Don'ts
|
||||
|
||||
- **Don't overfit** - Limit parameters
|
||||
- **Don't ignore survivorship** - Include delisted
|
||||
- **Don't use adjusted data carelessly** - Understand adjustments
|
||||
- **Don't optimize on full history** - Reserve test set
|
||||
- **Don't ignore capacity** - Market impact matters
|
||||
|
||||
## Resources
|
||||
|
||||
- [Advances in Financial Machine Learning (Marcos López de Prado)](https://www.amazon.com/Advances-Financial-Machine-Learning-Marcos/dp/1119482089)
|
||||
- [Quantitative Trading (Ernest Chan)](https://www.amazon.com/Quantitative-Trading-Build-Algorithmic-Business/dp/1119800064)
|
||||
- [Backtrader Documentation](https://www.backtrader.com/docu/)
|
||||
78
.agents/skills/beadboard-driver/SKILL.md
Normal file
78
.agents/skills/beadboard-driver/SKILL.md
Normal file
|
|
@ -0,0 +1,78 @@
|
|||
---
|
||||
name: beadboard-driver
|
||||
description: Drive BeadBoard agent workflows with strict Operative Protocol v1 compliance. Use when handling bead lifecycle work that combines bd status commands with bb agent coordination (register/adopt, activity-lease, reserve/release, send/ack), especially in multi-agent sessions requiring silent observability and collision avoidance.
|
||||
---
|
||||
|
||||
# Beadboard Driver (Operative Protocol v1)
|
||||
|
||||
## Overview
|
||||
|
||||
Use this skill to run repeatable `bd` + `bb` workflows under the **Activity Lease** (Parking Permit) model. Resolve `bb` safely, bootstrap via `bb-init`, coordinate via traceable incursions, and maintain liveness through real work.
|
||||
|
||||
## Core Workflow
|
||||
|
||||
1. **Bootstrap & Handshake**:
|
||||
Run `bb-init` to resolve paths and identify yourself. Use `--adopt` if resuming a task with uncommitted changes.
|
||||
```bash
|
||||
node scripts/bb-init.mjs --register <agent-name> --role <role> --json
|
||||
# OR
|
||||
node scripts/bb-init.mjs --adopt <prior-agent-id> --non-interactive --json
|
||||
```
|
||||
|
||||
2. **Claim Territory**:
|
||||
Reserve your work surface before making edits to prevent silent collisions.
|
||||
```bash
|
||||
& "$env:BB_REPO\bb.ps1" agent reserve --agent <agent-id> --scope "src/lib/*" --bead <bead-id>
|
||||
bd update <bead-id> --status in_progress --claim
|
||||
```
|
||||
|
||||
3. **Physical Change -> Contextual Lookup**:
|
||||
If you encounter uncommitted changes in a file you didn't personally edit: **STOP and Query**.
|
||||
```bash
|
||||
& "$env:BB_REPO\bb.ps1" agent status --agent <agent-id>
|
||||
& "$env:BB_REPO\bb.ps1" agent inbox --agent <agent-id> --state unread
|
||||
```
|
||||
|
||||
4. **Explain Deltas**:
|
||||
Send high-fidelity signals when you hit milestones or incursions.
|
||||
```bash
|
||||
& "$env:BB_REPO\bb.ps1" agent send --from <agent-id> --to <peer> --bead <bead-id> --category INFO --subject "Patched parser.ts for UI sync" --body "..."
|
||||
```
|
||||
|
||||
5. **Liveness Maintenance**:
|
||||
Liveness is **Passive**. Any `bb agent` command extends your lease. Use `activity-lease` if you haven't run a command in > 10 minutes.
|
||||
```bash
|
||||
& "$env:BB_REPO\bb.ps1" agent activity-lease --agent <agent-id> --json
|
||||
```
|
||||
|
||||
6. **Closeout Evidence**:
|
||||
```bash
|
||||
node skills/beadboard-driver/scripts/readiness-report.mjs --checks '[{"name":"typecheck","ok":true}]' --artifacts '[{"path":"artifacts/final.png","required":true}]'
|
||||
bd close <bead-id> --reason "..."
|
||||
```
|
||||
|
||||
## Identity & Adoption Policy
|
||||
|
||||
- **Uniqueness**: Create one unique `adjective-noun` identity per session unless adopting.
|
||||
- **Adoption Guardrails**: Adoption is ONLY allowed if uncommitted changes exist in the scope OR you own an `in_progress` bead.
|
||||
- **Audit**: Every adoption triggers a `RESUME` event in the audit feed.
|
||||
|
||||
## Activity Lease (Parking Permit)
|
||||
|
||||
- **Active (0-15m)**: Lease is valid. You are protected from takeover.
|
||||
- **Stale (15-30m)**: Lease expired. Others can takeover with `--takeover-stale`.
|
||||
- **Evicted (30m+)**: Lease dead. Others should takeover and archive your reservation.
|
||||
- **Idle (60m+)**: Ghost state. You are considered gone.
|
||||
|
||||
## Red Flags - STOP and Start Over
|
||||
|
||||
- **Silent Incursion**: Editing a reserved file without sending an `INFO` message.
|
||||
- **Identity Reuse**: Reusing an agent ID from a previous session without an adoption handshake.
|
||||
- **Mocking**: Implementing mocks instead of coordinating with the domain owner.
|
||||
- **Terminal Pop-ups**: Spawning background workers that disrupt the user's desktop.
|
||||
|
||||
## References
|
||||
|
||||
- Command and argument contracts: `references/command-matrix.md`
|
||||
- End-to-end session choreography: `references/session-lifecycle.md`
|
||||
- Protocol Specification: `docs/protocols/operative-protocol-v1.md`
|
||||
4
.agents/skills/beadboard-driver/agents/openai.yaml
Normal file
4
.agents/skills/beadboard-driver/agents/openai.yaml
Normal file
|
|
@ -0,0 +1,4 @@
|
|||
interface:
|
||||
display_name: "Beadboard Driver"
|
||||
short_description: "Safe bd+bb agent workflow orchestration"
|
||||
default_prompt: "Use Beadboard Driver to resolve bb path, register a unique session agent, coordinate via bb agent commands, and produce verification-backed closeout notes."
|
||||
38
.agents/skills/beadboard-driver/references/command-matrix.md
Normal file
38
.agents/skills/beadboard-driver/references/command-matrix.md
Normal file
|
|
@ -0,0 +1,38 @@
|
|||
# Command Matrix
|
||||
|
||||
## Bootstrapping and Handshake
|
||||
|
||||
- `node scripts/bb-init.mjs --register <name> --role <role> --json`
|
||||
- Output: `{ ok, agent_id, mode, lease, timestamp }`
|
||||
- `node scripts/bb-init.mjs --adopt <id> [--non-interactive] --json`
|
||||
- Output: `{ ok, agent_id, mode, lease, timestamp }` or `{ ok:false, error }`
|
||||
|
||||
## Coordination Commands (`bb`)
|
||||
|
||||
- `bb agent register --name <agent> --role <role>`
|
||||
- `bb agent activity-lease --agent <agent> [--json]`
|
||||
- Output: `{ ok, command, data: AgentRecord }`
|
||||
- `bb agent list [--role <role>] [--status <status>]`
|
||||
- `bb agent show --agent <agent>`
|
||||
- `bb agent send --from <agent> --to <agent> --bead <id> --category <HANDOFF|BLOCKED|DECISION|INFO> --subject <text> --body <text>`
|
||||
- `bb agent inbox --agent <agent> [--state unread|read|acked] [--bead <id>]`
|
||||
- `bb agent read --agent <agent> --message <message-id>`
|
||||
- `bb agent ack --agent <agent> --message <message-id>`
|
||||
- `bb agent reserve --agent <agent> --scope <path> --bead <id> [--ttl <minutes>] [--takeover-stale]`
|
||||
- `bb agent release --agent <agent> --scope <path>`
|
||||
- `bb agent status [--bead <id>] [--agent <agent>]`
|
||||
|
||||
## Lifecycle Commands (`bd`)
|
||||
|
||||
- `bd ready`
|
||||
- `bd show <bead-id>`
|
||||
- `bd update <bead-id> --status in_progress --claim`
|
||||
- `bd update <bead-id> --notes "<evidence>"`
|
||||
- `bd close <bead-id> --reason "<summary>"`
|
||||
|
||||
## Legacy/Internal Scripts
|
||||
|
||||
- `node skills/beadboard-driver/scripts/resolve-bb.mjs`
|
||||
- `node skills/beadboard-driver/scripts/session-preflight.mjs`
|
||||
- `node skills/beadboard-driver/scripts/generate-agent-name.mjs`
|
||||
- `node skills/beadboard-driver/scripts/readiness-report.mjs --checks <json> --artifacts <json>`
|
||||
40
.agents/skills/beadboard-driver/references/failure-modes.md
Normal file
40
.agents/skills/beadboard-driver/references/failure-modes.md
Normal file
|
|
@ -0,0 +1,40 @@
|
|||
# Failure Modes
|
||||
|
||||
## `BD_NOT_FOUND`
|
||||
|
||||
- Cause: `bd` missing from PATH.
|
||||
- Recovery: install beads CLI or add `bd` executable directory to PATH.
|
||||
|
||||
## `BB_NOT_FOUND`
|
||||
|
||||
- Cause: `BB_REPO` invalid or no `bb` command / cache / discovery hit.
|
||||
- Recovery:
|
||||
- Set `BB_REPO` to BeadBoard repo root.
|
||||
- Verify `bb.ps1` exists under `BB_REPO`.
|
||||
- Retry preflight.
|
||||
|
||||
## `NAME_GENERATION_EXHAUSTED`
|
||||
|
||||
- Cause: all generated names collided with existing registry entries.
|
||||
- Recovery:
|
||||
- increase retry count (`BB_NAME_MAX_RETRIES`),
|
||||
- expand adjective/noun pools,
|
||||
- retry generation.
|
||||
|
||||
## Reservation Conflicts
|
||||
|
||||
- `RESERVATION_CONFLICT`: active owner exists.
|
||||
- `RESERVATION_STALE_FOUND`: stale reservation exists; use takeover only when safe.
|
||||
- `RELEASE_FORBIDDEN`: non-owner attempted release.
|
||||
|
||||
## Mail Lifecycle Errors
|
||||
|
||||
- `UNKNOWN_SENDER` / `UNKNOWN_RECIPIENT`: register agents before send.
|
||||
- `ACK_FORBIDDEN`: only recipient may ack.
|
||||
- `MESSAGE_NOT_FOUND`: stale id or wrong message reference.
|
||||
|
||||
## Policy Guardrails
|
||||
|
||||
- Do not write `.beads/issues.jsonl` directly.
|
||||
- Do not close beads without verification evidence.
|
||||
- Do not bypass `BB_REPO` when it is set but invalid; fix it explicitly.
|
||||
|
|
@ -0,0 +1,33 @@
|
|||
# Session Lifecycle
|
||||
|
||||
## 1) Start Session
|
||||
|
||||
1. Run preflight.
|
||||
2. Resolve bb path and confirm `bd` availability.
|
||||
3. Generate unique session agent name.
|
||||
4. Register agent identity.
|
||||
|
||||
## 2) Pick and Claim Work
|
||||
|
||||
1. `bd ready`
|
||||
2. `bd show <id>`
|
||||
3. `bd update <id> --status in_progress --claim`
|
||||
|
||||
## 3) Coordinate During Work
|
||||
|
||||
1. Reserve sensitive scopes before edits.
|
||||
2. Send structured mail for blockers and handoffs.
|
||||
3. Read and acknowledge required messages.
|
||||
|
||||
## 4) Verify and Close
|
||||
|
||||
1. Run required gates (typecheck/test/lint).
|
||||
2. Build readiness report with checks + artifacts.
|
||||
3. Post notes to bead.
|
||||
4. Close bead with explicit reason.
|
||||
|
||||
## 5) Session End Hygiene
|
||||
|
||||
1. Release reservations.
|
||||
2. Ensure no unresolved blocker mail is pending for your bead.
|
||||
3. Hand off context if stopping before close.
|
||||
142
.agents/skills/beadboard-driver/scripts/generate-agent-name.mjs
Normal file
142
.agents/skills/beadboard-driver/scripts/generate-agent-name.mjs
Normal file
|
|
@ -0,0 +1,142 @@
|
|||
#!/usr/bin/env node
|
||||
|
||||
import fs from 'node:fs/promises';
|
||||
import path from 'node:path';
|
||||
import os from 'node:os';
|
||||
|
||||
function normalizeList(raw, fallback) {
|
||||
const value = (raw || '').trim();
|
||||
if (!value) {
|
||||
return fallback;
|
||||
}
|
||||
return value
|
||||
.split(',')
|
||||
.map((item) => item.trim().toLowerCase())
|
||||
.filter(Boolean);
|
||||
}
|
||||
|
||||
function sanitizeName(value) {
|
||||
return value
|
||||
.toLowerCase()
|
||||
.replace(/[^a-z0-9]+/g, '-')
|
||||
.replace(/^-+|-+$/g, '');
|
||||
}
|
||||
|
||||
function buildRandomSource() {
|
||||
const sequenceRaw = (process.env.BB_NAME_SEED_SEQUENCE || '').trim();
|
||||
if (!sequenceRaw) {
|
||||
return () => Math.random();
|
||||
}
|
||||
const sequence = sequenceRaw
|
||||
.split(',')
|
||||
.map((value) => Number.parseFloat(value.trim()))
|
||||
.filter((value) => Number.isFinite(value));
|
||||
let index = 0;
|
||||
return () => {
|
||||
if (sequence.length === 0) {
|
||||
return Math.random();
|
||||
}
|
||||
const value = sequence[index % sequence.length];
|
||||
index += 1;
|
||||
return Math.min(Math.max(value, 0), 0.999999);
|
||||
};
|
||||
}
|
||||
|
||||
function pickIndex(length, randomFn) {
|
||||
if (length <= 1) {
|
||||
return 0;
|
||||
}
|
||||
return Math.floor(randomFn() * length);
|
||||
}
|
||||
|
||||
async function nameExists(registryDir, agentName) {
|
||||
const filePath = path.join(registryDir, `${agentName}.json`);
|
||||
try {
|
||||
await fs.access(filePath);
|
||||
return true;
|
||||
} catch {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
function registryRoot() {
|
||||
if (process.env.BB_AGENT_REGISTRY_DIR) {
|
||||
return process.env.BB_AGENT_REGISTRY_DIR;
|
||||
}
|
||||
return path.join(process.env.USERPROFILE || os.homedir(), '.beadboard', 'agent', 'agents');
|
||||
}
|
||||
|
||||
async function main() {
|
||||
try {
|
||||
const adjectives = normalizeList(process.env.BB_NAME_ADJECTIVES, [
|
||||
'green',
|
||||
'silver',
|
||||
'swift',
|
||||
'steady',
|
||||
]);
|
||||
const nouns = normalizeList(process.env.BB_NAME_NOUNS, ['castle', 'harbor', 'falcon', 'orchard']);
|
||||
const maxRetriesRaw = Number.parseInt(process.env.BB_NAME_MAX_RETRIES || '12', 10);
|
||||
const maxRetries = Number.isInteger(maxRetriesRaw) && maxRetriesRaw > 0 ? maxRetriesRaw : 12;
|
||||
const random = buildRandomSource();
|
||||
const registryDir = registryRoot();
|
||||
|
||||
let collisions = 0;
|
||||
let attempts = 0;
|
||||
for (let index = 0; index < maxRetries; index += 1) {
|
||||
attempts += 1;
|
||||
const adjective = adjectives[pickIndex(adjectives.length, random)];
|
||||
const noun = nouns[pickIndex(nouns.length, random)];
|
||||
const candidate = sanitizeName(`${adjective}-${noun}`);
|
||||
if (!candidate) {
|
||||
continue;
|
||||
}
|
||||
const exists = await nameExists(registryDir, candidate);
|
||||
if (!exists) {
|
||||
process.stdout.write(
|
||||
`${JSON.stringify(
|
||||
{
|
||||
ok: true,
|
||||
agent_name: candidate,
|
||||
attempts,
|
||||
collisions,
|
||||
registry_dir: registryDir,
|
||||
},
|
||||
null,
|
||||
2,
|
||||
)}\n`,
|
||||
);
|
||||
return;
|
||||
}
|
||||
collisions += 1;
|
||||
}
|
||||
|
||||
process.stdout.write(
|
||||
`${JSON.stringify(
|
||||
{
|
||||
ok: false,
|
||||
error_code: 'NAME_GENERATION_EXHAUSTED',
|
||||
reason: 'Unable to generate a unique agent name in allotted retries.',
|
||||
attempts,
|
||||
collisions,
|
||||
registry_dir: registryDir,
|
||||
},
|
||||
null,
|
||||
2,
|
||||
)}\n`,
|
||||
);
|
||||
} catch (error) {
|
||||
process.stdout.write(
|
||||
`${JSON.stringify(
|
||||
{
|
||||
ok: false,
|
||||
error_code: 'NAME_GENERATION_INTERNAL_ERROR',
|
||||
reason: error instanceof Error ? error.message : String(error),
|
||||
},
|
||||
null,
|
||||
2,
|
||||
)}\n`,
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
void main();
|
||||
185
.agents/skills/beadboard-driver/scripts/lib/driver-lib.mjs
Normal file
185
.agents/skills/beadboard-driver/scripts/lib/driver-lib.mjs
Normal file
|
|
@ -0,0 +1,185 @@
|
|||
import fs from 'node:fs/promises';
|
||||
import path from 'node:path';
|
||||
import os from 'node:os';
|
||||
|
||||
function homeRoot() {
|
||||
return process.env.BB_SKILL_HOME || os.homedir();
|
||||
}
|
||||
|
||||
function cacheFilePath() {
|
||||
return path.join(homeRoot(), '.beadboard', 'skill-config.json');
|
||||
}
|
||||
|
||||
async function pathExists(filePath) {
|
||||
try {
|
||||
await fs.access(filePath);
|
||||
return true;
|
||||
} catch {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
async function readCache() {
|
||||
const filePath = cacheFilePath();
|
||||
try {
|
||||
const raw = await fs.readFile(filePath, 'utf8');
|
||||
return JSON.parse(raw);
|
||||
} catch {
|
||||
return {};
|
||||
}
|
||||
}
|
||||
|
||||
async function writeCache(payload) {
|
||||
const filePath = cacheFilePath();
|
||||
await fs.mkdir(path.dirname(filePath), { recursive: true });
|
||||
await fs.writeFile(
|
||||
filePath,
|
||||
`${JSON.stringify({ ...payload, updated_at: new Date().toISOString() }, null, 2)}\n`,
|
||||
'utf8',
|
||||
);
|
||||
}
|
||||
|
||||
function splitPathVariable(value) {
|
||||
if (!value) {
|
||||
return [];
|
||||
}
|
||||
return value.split(path.delimiter).map((entry) => entry.trim()).filter(Boolean);
|
||||
}
|
||||
|
||||
async function findCommandInPath(commandName) {
|
||||
const pathEntries = splitPathVariable(process.env.PATH || '');
|
||||
const candidateNames =
|
||||
process.platform === 'win32'
|
||||
? [`${commandName}.cmd`, `${commandName}.exe`, `${commandName}.ps1`, `${commandName}.bat`, commandName]
|
||||
: [commandName];
|
||||
|
||||
for (const entry of pathEntries) {
|
||||
for (const candidate of candidateNames) {
|
||||
const fullPath = path.join(entry, candidate);
|
||||
if (await pathExists(fullPath)) {
|
||||
return fullPath;
|
||||
}
|
||||
}
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
async function validateRepoPath(repoPath) {
|
||||
if (!repoPath || !(await pathExists(repoPath))) {
|
||||
return { ok: false, reason: 'BB_REPO does not exist.' };
|
||||
}
|
||||
|
||||
const bbPath = path.join(repoPath, 'bb.ps1');
|
||||
if (!(await pathExists(bbPath))) {
|
||||
return { ok: false, reason: 'BB_REPO is set, but bb.ps1 was not found at BB_REPO\\bb.ps1.' };
|
||||
}
|
||||
|
||||
return { ok: true, bbPath };
|
||||
}
|
||||
|
||||
async function discoverBbPath() {
|
||||
const configuredRoots = splitPathVariable(process.env.BB_SEARCH_ROOTS || '');
|
||||
const roots = configuredRoots.length > 0 ? configuredRoots : [process.cwd(), path.join(homeRoot(), 'codex'), homeRoot()];
|
||||
const maxDepth = 4;
|
||||
|
||||
for (const root of roots) {
|
||||
if (!(await pathExists(root))) {
|
||||
continue;
|
||||
}
|
||||
|
||||
const queue = [{ dir: root, depth: 0 }];
|
||||
while (queue.length > 0) {
|
||||
const current = queue.shift();
|
||||
const candidate = path.join(current.dir, 'bb.ps1');
|
||||
if (await pathExists(candidate)) {
|
||||
return candidate;
|
||||
}
|
||||
if (current.depth >= maxDepth) {
|
||||
continue;
|
||||
}
|
||||
let entries = [];
|
||||
try {
|
||||
entries = await fs.readdir(current.dir, { withFileTypes: true });
|
||||
} catch {
|
||||
continue;
|
||||
}
|
||||
for (const entry of entries) {
|
||||
if (entry.isDirectory()) {
|
||||
queue.push({ dir: path.join(current.dir, entry.name), depth: current.depth + 1 });
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
async function resolveBbPath() {
|
||||
const cache = await readCache();
|
||||
const envRepo = (process.env.BB_REPO || '').trim();
|
||||
|
||||
if (envRepo) {
|
||||
const validated = await validateRepoPath(envRepo);
|
||||
if (!validated.ok) {
|
||||
return {
|
||||
ok: false,
|
||||
source: 'env',
|
||||
resolved_path: null,
|
||||
reason: validated.reason,
|
||||
remediation: 'Set BB_REPO to your BeadBoard repo root, e.g. `$env:BB_REPO="C:\\path\\to\\beadboard"`.',
|
||||
};
|
||||
}
|
||||
|
||||
let reason = 'Resolved from BB_REPO.';
|
||||
if (cache.bb_path && cache.bb_path !== validated.bbPath) {
|
||||
reason = 'Resolved from BB_REPO; cache mismatch detected and cache updated.';
|
||||
}
|
||||
await writeCache({ bb_path: validated.bbPath, source: 'env' });
|
||||
return { ok: true, source: 'env', resolved_path: validated.bbPath, reason, remediation: null };
|
||||
}
|
||||
|
||||
const globalBb = await findCommandInPath('bb');
|
||||
if (globalBb) {
|
||||
await writeCache({ bb_path: globalBb, source: 'global' });
|
||||
return {
|
||||
ok: true,
|
||||
source: 'global',
|
||||
resolved_path: globalBb,
|
||||
reason: 'Resolved from PATH.',
|
||||
remediation: null,
|
||||
};
|
||||
}
|
||||
|
||||
if (cache.bb_path && (await pathExists(cache.bb_path))) {
|
||||
return {
|
||||
ok: true,
|
||||
source: 'cache',
|
||||
resolved_path: cache.bb_path,
|
||||
reason: 'Resolved from cached bb path.',
|
||||
remediation: null,
|
||||
};
|
||||
}
|
||||
|
||||
const discovered = await discoverBbPath();
|
||||
if (discovered) {
|
||||
await writeCache({ bb_path: discovered, source: 'discovery' });
|
||||
return {
|
||||
ok: true,
|
||||
source: 'discovery',
|
||||
resolved_path: discovered,
|
||||
reason: 'Resolved by filesystem discovery and cached.',
|
||||
remediation: null,
|
||||
};
|
||||
}
|
||||
|
||||
return {
|
||||
ok: false,
|
||||
source: 'none',
|
||||
resolved_path: null,
|
||||
reason: 'Unable to find bb command or bb.ps1.',
|
||||
remediation:
|
||||
'Set BB_REPO to your BeadBoard repo root, or install a global bb command, then retry.',
|
||||
};
|
||||
}
|
||||
|
||||
export { cacheFilePath, findCommandInPath, resolveBbPath };
|
||||
112
.agents/skills/beadboard-driver/scripts/readiness-report.mjs
Normal file
112
.agents/skills/beadboard-driver/scripts/readiness-report.mjs
Normal file
|
|
@ -0,0 +1,112 @@
|
|||
#!/usr/bin/env node
|
||||
|
||||
import fs from 'node:fs/promises';
|
||||
|
||||
function parseArgs(argv) {
|
||||
const output = {};
|
||||
for (let index = 0; index < argv.length; index += 1) {
|
||||
const token = argv[index];
|
||||
if (!token.startsWith('--')) {
|
||||
continue;
|
||||
}
|
||||
const key = token.slice(2);
|
||||
const value = argv[index + 1];
|
||||
if (!value || value.startsWith('--')) {
|
||||
output[key] = 'true';
|
||||
continue;
|
||||
}
|
||||
output[key] = value;
|
||||
index += 1;
|
||||
}
|
||||
return output;
|
||||
}
|
||||
|
||||
function parseJsonArray(raw, fallback) {
|
||||
if (!raw) {
|
||||
return fallback;
|
||||
}
|
||||
try {
|
||||
const parsed = JSON.parse(raw);
|
||||
return Array.isArray(parsed) ? parsed : fallback;
|
||||
} catch {
|
||||
return fallback;
|
||||
}
|
||||
}
|
||||
|
||||
async function withArtifactExistence(artifacts) {
|
||||
const output = [];
|
||||
for (const artifact of artifacts) {
|
||||
const item = {
|
||||
path: artifact.path,
|
||||
required: Boolean(artifact.required),
|
||||
exists: false,
|
||||
};
|
||||
if (typeof artifact.path === 'string' && artifact.path.trim()) {
|
||||
try {
|
||||
await fs.access(artifact.path);
|
||||
item.exists = true;
|
||||
} catch {
|
||||
item.exists = false;
|
||||
}
|
||||
}
|
||||
output.push(item);
|
||||
}
|
||||
return output;
|
||||
}
|
||||
|
||||
async function main() {
|
||||
try {
|
||||
const args = parseArgs(process.argv.slice(2));
|
||||
const checks = parseJsonArray(args.checks, []);
|
||||
const artifacts = parseJsonArray(args.artifacts, []);
|
||||
const dependencySanity = args['dependency-note'] || '';
|
||||
|
||||
const normalizedChecks = checks.map((check) => ({
|
||||
name: check.name || 'unnamed-check',
|
||||
ok: Boolean(check.ok),
|
||||
details: check.details || '',
|
||||
}));
|
||||
const normalizedArtifacts = await withArtifactExistence(artifacts);
|
||||
|
||||
const allChecksPass = normalizedChecks.every((check) => check.ok);
|
||||
const requiredArtifactsPresent = normalizedArtifacts.every((artifact) => !artifact.required || artifact.exists);
|
||||
const ready = allChecksPass && requiredArtifactsPresent;
|
||||
|
||||
process.stdout.write(
|
||||
`${JSON.stringify(
|
||||
{
|
||||
ok: true,
|
||||
generated_at: new Date().toISOString(),
|
||||
checks: normalizedChecks,
|
||||
artifacts: normalizedArtifacts,
|
||||
dependency_sanity: dependencySanity,
|
||||
summary: {
|
||||
checks_passed: allChecksPass,
|
||||
required_artifacts_present: requiredArtifactsPresent,
|
||||
ready,
|
||||
},
|
||||
},
|
||||
null,
|
||||
2,
|
||||
)}\n`,
|
||||
);
|
||||
} catch (error) {
|
||||
process.stdout.write(
|
||||
`${JSON.stringify(
|
||||
{
|
||||
ok: false,
|
||||
reason: error instanceof Error ? error.message : String(error),
|
||||
summary: {
|
||||
checks_passed: false,
|
||||
required_artifacts_present: false,
|
||||
ready: false,
|
||||
},
|
||||
},
|
||||
null,
|
||||
2,
|
||||
)}\n`,
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
void main();
|
||||
26
.agents/skills/beadboard-driver/scripts/resolve-bb.mjs
Normal file
26
.agents/skills/beadboard-driver/scripts/resolve-bb.mjs
Normal file
|
|
@ -0,0 +1,26 @@
|
|||
#!/usr/bin/env node
|
||||
|
||||
import { resolveBbPath } from './lib/driver-lib.mjs';
|
||||
|
||||
async function main() {
|
||||
try {
|
||||
const resolved = await resolveBbPath();
|
||||
process.stdout.write(`${JSON.stringify(resolved, null, 2)}\n`);
|
||||
} catch (error) {
|
||||
process.stdout.write(
|
||||
`${JSON.stringify(
|
||||
{
|
||||
ok: false,
|
||||
source: 'internal',
|
||||
resolved_path: null,
|
||||
reason: error instanceof Error ? error.message : String(error),
|
||||
remediation: 'Inspect resolve-bb.js runtime environment and retry.',
|
||||
},
|
||||
null,
|
||||
2,
|
||||
)}\n`,
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
void main();
|
||||
|
|
@ -0,0 +1,83 @@
|
|||
#!/usr/bin/env node
|
||||
|
||||
import { findCommandInPath, resolveBbPath } from './lib/driver-lib.mjs';
|
||||
|
||||
async function main() {
|
||||
try {
|
||||
const bdPath = await findCommandInPath('bd');
|
||||
if (!bdPath) {
|
||||
process.stdout.write(
|
||||
`${JSON.stringify(
|
||||
{
|
||||
ok: false,
|
||||
error_code: 'BD_NOT_FOUND',
|
||||
reason: 'Could not find bd in PATH.',
|
||||
remediation: 'Install beads CLI or add bd executable to PATH.',
|
||||
tools: {
|
||||
bd: { available: false, path: null },
|
||||
},
|
||||
bb: null,
|
||||
},
|
||||
null,
|
||||
2,
|
||||
)}\n`,
|
||||
);
|
||||
return;
|
||||
}
|
||||
|
||||
const bb = await resolveBbPath();
|
||||
if (!bb.ok) {
|
||||
process.stdout.write(
|
||||
`${JSON.stringify(
|
||||
{
|
||||
ok: false,
|
||||
error_code: 'BB_NOT_FOUND',
|
||||
reason: bb.reason,
|
||||
remediation: bb.remediation,
|
||||
tools: {
|
||||
bd: { available: true, path: bdPath },
|
||||
},
|
||||
bb,
|
||||
},
|
||||
null,
|
||||
2,
|
||||
)}\n`,
|
||||
);
|
||||
return;
|
||||
}
|
||||
|
||||
process.stdout.write(
|
||||
`${JSON.stringify(
|
||||
{
|
||||
ok: true,
|
||||
timestamp: new Date().toISOString(),
|
||||
tools: {
|
||||
bd: { available: true, path: bdPath },
|
||||
},
|
||||
bb,
|
||||
},
|
||||
null,
|
||||
2,
|
||||
)}\n`,
|
||||
);
|
||||
} catch (error) {
|
||||
process.stdout.write(
|
||||
`${JSON.stringify(
|
||||
{
|
||||
ok: false,
|
||||
error_code: 'PREFLIGHT_INTERNAL_ERROR',
|
||||
reason: error instanceof Error ? error.message : String(error),
|
||||
remediation: 'Inspect session-preflight.js and retry.',
|
||||
tools: {
|
||||
bd: { available: false, path: null },
|
||||
},
|
||||
bb: null,
|
||||
},
|
||||
null,
|
||||
2,
|
||||
)}\n`,
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
void main();
|
||||
|
|
@ -0,0 +1,26 @@
|
|||
import test from 'node:test';
|
||||
import assert from 'node:assert/strict';
|
||||
import path from 'node:path';
|
||||
import { execFile } from 'node:child_process';
|
||||
import { promisify } from 'node:util';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
|
||||
const execFileAsync = promisify(execFile);
|
||||
const __filename = fileURLToPath(import.meta.url);
|
||||
const __dirname = path.dirname(__filename);
|
||||
const scriptPath = path.resolve(__dirname, '..', 'scripts', 'generate-agent-name.mjs');
|
||||
|
||||
test('generate-agent-name contract: returns structured success', async () => {
|
||||
const { stdout } = await execFileAsync(process.execPath, [scriptPath], {
|
||||
env: {
|
||||
...process.env,
|
||||
BB_NAME_ADJECTIVES: 'green',
|
||||
BB_NAME_NOUNS: 'castle',
|
||||
BB_NAME_MAX_RETRIES: '1',
|
||||
},
|
||||
});
|
||||
const result = JSON.parse(stdout);
|
||||
assert.equal(result.ok, true);
|
||||
assert.equal(result.agent_name, 'green-castle');
|
||||
assert.equal(typeof result.attempts, 'number');
|
||||
});
|
||||
|
|
@ -0,0 +1,32 @@
|
|||
import test from 'node:test';
|
||||
import assert from 'node:assert/strict';
|
||||
import fs from 'node:fs/promises';
|
||||
import os from 'node:os';
|
||||
import path from 'node:path';
|
||||
import { execFile } from 'node:child_process';
|
||||
import { promisify } from 'node:util';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
|
||||
const execFileAsync = promisify(execFile);
|
||||
const __filename = fileURLToPath(import.meta.url);
|
||||
const __dirname = path.dirname(__filename);
|
||||
const scriptPath = path.resolve(__dirname, '..', 'scripts', 'resolve-bb.mjs');
|
||||
|
||||
test('resolve-bb contract: BB_REPO source', async () => {
|
||||
const root = await fs.mkdtemp(path.join(os.tmpdir(), 'bb-skill-contract-resolve-'));
|
||||
try {
|
||||
const repo = path.join(root, 'beadboard');
|
||||
await fs.mkdir(path.join(repo, 'tools'), { recursive: true });
|
||||
await fs.writeFile(path.join(repo, 'bb.ps1'), 'echo ok', 'utf8');
|
||||
|
||||
const { stdout } = await execFileAsync(process.execPath, [scriptPath], {
|
||||
env: { ...process.env, BB_REPO: repo, BB_SKILL_HOME: path.join(root, 'home'), PATH: '' },
|
||||
});
|
||||
const result = JSON.parse(stdout);
|
||||
|
||||
assert.equal(result.ok, true);
|
||||
assert.equal(result.source, 'env');
|
||||
} finally {
|
||||
await fs.rm(root, { recursive: true, force: true });
|
||||
}
|
||||
});
|
||||
23
.agents/skills/beadboard-driver/tests/run-tests.mjs
Normal file
23
.agents/skills/beadboard-driver/tests/run-tests.mjs
Normal file
|
|
@ -0,0 +1,23 @@
|
|||
#!/usr/bin/env node
|
||||
|
||||
import path from 'node:path';
|
||||
import { spawn } from 'node:child_process';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
|
||||
const __filename = fileURLToPath(import.meta.url);
|
||||
const __dirname = path.dirname(__filename);
|
||||
|
||||
const tests = [
|
||||
path.join(__dirname, 'resolve-bb.contract.test.mjs'),
|
||||
path.join(__dirname, 'generate-agent-name.contract.test.mjs'),
|
||||
path.join(__dirname, 'session-preflight.contract.test.mjs'),
|
||||
];
|
||||
|
||||
const child = spawn(process.execPath, ['--test', ...tests], {
|
||||
stdio: 'inherit',
|
||||
env: process.env,
|
||||
});
|
||||
|
||||
child.on('exit', (code) => {
|
||||
process.exit(code ?? 1);
|
||||
});
|
||||
|
|
@ -0,0 +1,43 @@
|
|||
import test from 'node:test';
|
||||
import assert from 'node:assert/strict';
|
||||
import fs from 'node:fs/promises';
|
||||
import os from 'node:os';
|
||||
import path from 'node:path';
|
||||
import { execFile } from 'node:child_process';
|
||||
import { promisify } from 'node:util';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
|
||||
const execFileAsync = promisify(execFile);
|
||||
const __filename = fileURLToPath(import.meta.url);
|
||||
const __dirname = path.dirname(__filename);
|
||||
const scriptPath = path.resolve(__dirname, '..', 'scripts', 'session-preflight.mjs');
|
||||
|
||||
test('session-preflight contract: surfaces BD_NOT_FOUND when missing', async () => {
|
||||
const { stdout } = await execFileAsync(process.execPath, [scriptPath], {
|
||||
env: { ...process.env, PATH: '' },
|
||||
});
|
||||
const result = JSON.parse(stdout);
|
||||
assert.equal(result.ok, false);
|
||||
assert.equal(result.error_code, 'BD_NOT_FOUND');
|
||||
});
|
||||
|
||||
test('session-preflight contract: succeeds with bd + BB_REPO', async () => {
|
||||
const root = await fs.mkdtemp(path.join(os.tmpdir(), 'bb-skill-contract-preflight-'));
|
||||
try {
|
||||
const repo = path.join(root, 'beadboard');
|
||||
const toolsDir = path.join(root, 'tools');
|
||||
await fs.mkdir(path.join(repo, 'tools'), { recursive: true });
|
||||
await fs.mkdir(toolsDir, { recursive: true });
|
||||
await fs.writeFile(path.join(repo, 'bb.ps1'), 'echo ok', 'utf8');
|
||||
await fs.writeFile(path.join(toolsDir, 'bd.cmd'), '@echo off\r\necho beads\r\n', 'utf8');
|
||||
|
||||
const { stdout } = await execFileAsync(process.execPath, [scriptPath], {
|
||||
env: { ...process.env, PATH: toolsDir, BB_REPO: repo, BB_SKILL_HOME: path.join(root, 'home') },
|
||||
});
|
||||
const result = JSON.parse(stdout);
|
||||
assert.equal(result.ok, true);
|
||||
assert.equal(result.bb.ok, true);
|
||||
} finally {
|
||||
await fs.rm(root, { recursive: true, force: true });
|
||||
}
|
||||
});
|
||||
53
.agents/skills/brainstorming/SKILL.md
Normal file
53
.agents/skills/brainstorming/SKILL.md
Normal file
|
|
@ -0,0 +1,53 @@
|
|||
---
|
||||
name: brainstorming
|
||||
description: "You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation."
|
||||
---
|
||||
|
||||
# Brainstorming Ideas Into Designs
|
||||
|
||||
## Overview
|
||||
|
||||
Help turn ideas into fully formed designs and specs through natural collaborative dialogue.
|
||||
|
||||
Start by understanding the current project context, then ask questions one at a time to refine the idea. Once you understand what you're building, present the design in small sections (200-300 words), checking after each section whether it looks right so far.
|
||||
|
||||
## The Process
|
||||
|
||||
**Understanding the idea:**
|
||||
- Check out the current project state first (files, docs, recent commits)
|
||||
- Ask questions one at a time to refine the idea
|
||||
- Prefer multiple choice questions when possible, but open-ended is fine too
|
||||
- Only one question per message - if a topic needs more exploration, break it into multiple questions
|
||||
- Focus on understanding: purpose, constraints, success criteria
|
||||
|
||||
**Exploring approaches:**
|
||||
- Propose 2-3 different approaches with trade-offs
|
||||
- Present options conversationally with your recommendation and reasoning
|
||||
- Lead with your recommended option and explain why
|
||||
|
||||
**Presenting the design:**
|
||||
- Once you believe you understand what you're building, present the design
|
||||
- Break it into sections of 200-300 words
|
||||
- Ask after each section whether it looks right so far
|
||||
- Cover: architecture, components, data flow, error handling, testing
|
||||
- Be ready to go back and clarify if something doesn't make sense
|
||||
|
||||
## After the Design
|
||||
|
||||
**Documentation:**
|
||||
- Write the validated design to `docs/plans/YYYY-MM-DD-<topic>-design.md`
|
||||
- Commit the design document to git
|
||||
|
||||
**Implementation (if continuing):**
|
||||
- Ask: "Ready to set up for implementation?"
|
||||
- Use superpowers:using-git-worktrees to create isolated workspace
|
||||
- Use superpowers:writing-plans to create detailed implementation plan
|
||||
|
||||
## Key Principles
|
||||
|
||||
- **One question at a time** - Don't overwhelm with multiple questions
|
||||
- **Multiple choice preferred** - Easier to answer than open-ended when possible
|
||||
- **YAGNI ruthlessly** - Remove unnecessary features from all designs
|
||||
- **Explore alternatives** - Always propose 2-3 approaches before settling
|
||||
- **Incremental validation** - Present design in sections, validate each
|
||||
- **Be flexible** - Go back and clarify when something doesn't make sense
|
||||
375
.agents/skills/code-review-linus/skill.md
Normal file
375
.agents/skills/code-review-linus/skill.md
Normal file
|
|
@ -0,0 +1,375 @@
|
|||
```markdown
|
||||
# Expert Technical Code Review
|
||||
|
||||
<reasoning_effort>high</reasoning_effort>
|
||||
<verbosity>high</verbosity>
|
||||
<agent_mode>persistent</agent_mode>
|
||||
|
||||
## Your Role
|
||||
|
||||
You are a senior systems engineer conducting a rigorous technical code review. Your analysis prioritizes technical correctness, performance, maintainability, and simplicity. Be direct about problems and constructive with solutions.
|
||||
|
||||
## Review Process
|
||||
|
||||
### Phase 1: Initial Scan (30 seconds)
|
||||
- Identify code purpose and critical paths
|
||||
- Flag immediate concerns (security, correctness, data loss)
|
||||
- Assess appropriate review depth based on scope
|
||||
|
||||
### Phase 2: Systematic Analysis
|
||||
Work through each quality dimension:
|
||||
|
||||
**Correctness & Safety**
|
||||
- Concurrency issues (race conditions, deadlocks)
|
||||
- Boundary conditions and edge cases
|
||||
- Error handling gaps or silent failures
|
||||
- Memory safety (leaks, use-after-free, buffer overflows)
|
||||
|
||||
**Performance**
|
||||
- Algorithmic complexity (unnecessary O(n²) operations)
|
||||
- Wasteful allocations or copies
|
||||
- Cache-unfriendly patterns
|
||||
- Lock contention or I/O bottlenecks
|
||||
|
||||
**Design**
|
||||
- Broken abstractions or leaky interfaces
|
||||
- Over-engineering or inappropriate patterns
|
||||
- Tight coupling or unclear responsibilities
|
||||
- Inconsistent or surprising APIs
|
||||
|
||||
**Maintainability**
|
||||
- Readability and naming clarity
|
||||
- Unnecessary complexity or "cleverness"
|
||||
- Missing tests for critical paths
|
||||
- Poor error messages or debugging aids
|
||||
|
||||
**Test Quality & Coverage**
|
||||
- **Tests must find bugs, not just pass**
|
||||
- Missing tests for error conditions and edge cases
|
||||
- Tests that verify implementation details instead of behavior
|
||||
- No negative test cases (invalid inputs, boundary violations)
|
||||
- Assertions too weak or generic (`expect(result).toBeTruthy()`)
|
||||
- Tests that would pass even if the code is broken
|
||||
- Missing integration tests for critical workflows
|
||||
- No tests for concurrency or race conditions
|
||||
- Mocked dependencies hiding real interaction bugs
|
||||
|
||||
### Phase 3: Self-Review Protocol
|
||||
|
||||
<self_review>
|
||||
Before presenting your review, internally score it:
|
||||
1. **Specificity**: Every issue cites line numbers or code snippets (score 0-10)
|
||||
2. **Actionability**: Every criticism includes concrete fix or alternative (score 0-10)
|
||||
3. **Prioritization**: Most impactful issues surfaced first (score 0-10)
|
||||
4. **Balance**: Acknowledged strengths and weaknesses fairly (score 0-10)
|
||||
5. **Test Rigor**: Called out weak tests that give false confidence (score 0-10)
|
||||
|
||||
If any dimension scores <7, revise that section. Do NOT show scores to user.
|
||||
Only proceed when all dimensions ≥7.
|
||||
</self_review>
|
||||
|
||||
## Output Format
|
||||
|
||||
```markdown
|
||||
# Code Review
|
||||
|
||||
## Summary
|
||||
[2-3 sentences: overall quality, primary concerns, notable strengths]
|
||||
|
||||
---
|
||||
|
||||
## 🔴 Critical Issues
|
||||
**[Must fix - correctness, security, data integrity risks]**
|
||||
|
||||
### Issue: [Specific problem with line numbers]
|
||||
**Impact:** [Technical consequence - crash, data loss, security hole]
|
||||
**Fix:**
|
||||
```[language]
|
||||
// Show the problematic code
|
||||
// Show the corrected version
|
||||
```
|
||||
**Why:** [Explain the technical reasoning]
|
||||
|
||||
---
|
||||
|
||||
## 🟠 High Priority
|
||||
**[Significant problems - performance, design flaws, maintainability]**
|
||||
|
||||
[Same structure as Critical]
|
||||
|
||||
---
|
||||
|
||||
## 🟡 Medium Priority
|
||||
**[Quality improvements - readability, testing, minor inefficiencies]**
|
||||
|
||||
[Same structure as Critical]
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ Test Quality Issues
|
||||
**[Tests that provide false confidence or miss critical scenarios]**
|
||||
|
||||
### Weak Test: [Test name and location]
|
||||
**Problem:** [Why this test doesn't actually verify correctness]
|
||||
**Missing Coverage:** [What bugs would slip through]
|
||||
**Better Approach:**
|
||||
```[language]
|
||||
// Show improved test that would catch real bugs
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🟢 Strengths
|
||||
**[Acknowledge good patterns to maintain]**
|
||||
|
||||
- [Specific example of good code/design]
|
||||
- [Pattern worth replicating elsewhere]
|
||||
|
||||
---
|
||||
|
||||
## Next Steps
|
||||
1. [Most important action]
|
||||
2. [Second priority]
|
||||
3. [Third priority]
|
||||
```
|
||||
|
||||
## Review Principles
|
||||
|
||||
**Technical Truth Over Diplomacy**
|
||||
- Focus on code, not person
|
||||
- Explain WHY something is problematic
|
||||
- "This algorithm is O(n²) scanning the array twice" not "This is slow"
|
||||
|
||||
**Simplicity First**
|
||||
- Boring, obvious solutions beat clever ones
|
||||
- Complexity requires strong justification
|
||||
- Clear code > comments explaining unclear code
|
||||
|
||||
**Performance Consciousness**
|
||||
- Understand hardware realities (cache, memory hierarchy)
|
||||
- Know common performance anti-patterns
|
||||
- Measure, but recognize obvious inefficiencies
|
||||
|
||||
**Actionable Feedback**
|
||||
- Provide specific fixes with code examples
|
||||
- Suggest concrete alternatives, not just "this is wrong"
|
||||
- If code is fundamentally flawed, explain the right approach
|
||||
|
||||
**Test Skepticism**
|
||||
- Tests must be designed to fail when code breaks
|
||||
- Passing tests mean nothing if they don't test failure modes
|
||||
- Good tests are adversarial to the implementation
|
||||
|
||||
## Test Quality Evaluation Framework
|
||||
|
||||
<test_quality_checks>
|
||||
**For every test file, verify:**
|
||||
|
||||
1. **Negative Cases Exist**
|
||||
- Tests for invalid inputs, boundary violations, error states
|
||||
- Tests that expect failures (exceptions, error codes)
|
||||
- Tests for resource exhaustion, timeouts, cancellation
|
||||
|
||||
2. **Assertions Are Specific**
|
||||
- Exact values, not just "truthy" or "exists"
|
||||
- Multiple assertions per test where appropriate
|
||||
- Verify side effects, not just return values
|
||||
|
||||
3. **Tests Are Independent**
|
||||
- No shared mutable state between tests
|
||||
- Each test sets up its own fixtures
|
||||
- Tests pass in any order
|
||||
|
||||
4. **Edge Cases Covered**
|
||||
- Empty inputs, null values, zero-length arrays
|
||||
- Maximum values, overflow conditions
|
||||
- Concurrent access if applicable
|
||||
|
||||
5. **Integration Points Tested**
|
||||
- Database failures, network errors
|
||||
- Third-party API failures
|
||||
- File system errors (permissions, disk full)
|
||||
|
||||
6. **Tests Would Catch Regressions**
|
||||
- If you deleted a key line of implementation code, would a test fail?
|
||||
- If you changed error handling, would a test fail?
|
||||
- If you introduced a race condition, would a test fail?
|
||||
</test_quality_checks>
|
||||
|
||||
## Test Review Examples
|
||||
|
||||
### ❌ Weak Test (Always Passes)
|
||||
```javascript
|
||||
test('user service works', async () => {
|
||||
const service = new UserService();
|
||||
const result = await service.createUser({ name: 'Test' });
|
||||
expect(result).toBeTruthy(); // Too vague
|
||||
});
|
||||
```
|
||||
|
||||
**Problems:**
|
||||
- No validation that user was actually created correctly
|
||||
- Doesn't test what happens with invalid input
|
||||
- Would pass even if `createUser` always returns `{}`
|
||||
- No database check, no duplicate handling, no error cases
|
||||
|
||||
### ✅ Strong Test (Finds Bugs)
|
||||
```javascript
|
||||
test('createUser rejects duplicate emails', async () => {
|
||||
const service = new UserService();
|
||||
const userData = { name: 'Test', email: 'test@example.com' };
|
||||
|
||||
// First creation should succeed
|
||||
const user1 = await service.createUser(userData);
|
||||
expect(user1.id).toBeDefined();
|
||||
expect(user1.email).toBe('test@example.com');
|
||||
|
||||
// Duplicate should fail
|
||||
await expect(service.createUser(userData))
|
||||
.rejects
|
||||
.toThrow(/email already exists/i);
|
||||
|
||||
// Verify database state
|
||||
const users = await db.query('SELECT * FROM users WHERE email = ?',
|
||||
[userData.email]);
|
||||
expect(users.length).toBe(1); // Only one user created
|
||||
});
|
||||
|
||||
test('createUser validates email format', async () => {
|
||||
const service = new UserService();
|
||||
|
||||
await expect(service.createUser({ name: 'Test', email: 'invalid' }))
|
||||
.rejects
|
||||
.toThrow(/invalid email/i);
|
||||
|
||||
await expect(service.createUser({ name: 'Test', email: '' }))
|
||||
.rejects
|
||||
.toThrow(/email required/i);
|
||||
|
||||
await expect(service.createUser({ name: 'Test' }))
|
||||
.rejects
|
||||
.toThrow(/email required/i);
|
||||
});
|
||||
```
|
||||
|
||||
**Why This Is Better:**
|
||||
- Tests specific failure modes (duplicates, validation)
|
||||
- Verifies exact error messages and database state
|
||||
- Would fail if error handling is removed
|
||||
- Tests edge cases (empty string, missing field)
|
||||
- Multiple related scenarios in focused tests
|
||||
|
||||
### ❌ Weak Test (Mocks Hide Bugs)
|
||||
```javascript
|
||||
test('payment processes successfully', async () => {
|
||||
const mockGateway = { charge: jest.fn().mockResolvedValue({ id: '123' }) };
|
||||
const service = new PaymentService(mockGateway);
|
||||
|
||||
const result = await service.processPayment(100);
|
||||
expect(mockGateway.charge).toHaveBeenCalled();
|
||||
expect(result.success).toBe(true);
|
||||
});
|
||||
```
|
||||
|
||||
**Problems:**
|
||||
- Mock always succeeds - never tests failure paths
|
||||
- Doesn't verify amount, currency, or customer details passed to gateway
|
||||
- No test for network failures, declined cards, timeout
|
||||
- Would pass even if real integration is completely broken
|
||||
|
||||
### ✅ Strong Test (Tests Real Scenarios)
|
||||
```javascript
|
||||
test('payment handles gateway decline', async () => {
|
||||
const mockGateway = {
|
||||
charge: jest.fn().mockRejectedValue(
|
||||
new PaymentDeclinedError('Insufficient funds')
|
||||
)
|
||||
};
|
||||
const service = new PaymentService(mockGateway);
|
||||
|
||||
await expect(service.processPayment(100))
|
||||
.rejects
|
||||
.toThrow(PaymentDeclinedError);
|
||||
|
||||
expect(mockGateway.charge).toHaveBeenCalledWith(
|
||||
expect.objectContaining({
|
||||
amount: 100,
|
||||
currency: 'USD'
|
||||
})
|
||||
);
|
||||
});
|
||||
|
||||
test('payment retries on network error', async () => {
|
||||
const mockGateway = {
|
||||
charge: jest.fn()
|
||||
.mockRejectedValueOnce(new NetworkError('Timeout'))
|
||||
.mockRejectedValueOnce(new NetworkError('Timeout'))
|
||||
.mockResolvedValue({ id: '123' })
|
||||
};
|
||||
const service = new PaymentService(mockGateway);
|
||||
|
||||
const result = await service.processPayment(100);
|
||||
expect(mockGateway.charge).toHaveBeenCalledTimes(3);
|
||||
expect(result.id).toBe('123');
|
||||
});
|
||||
```
|
||||
|
||||
**Why This Is Better:**
|
||||
- Tests failure modes (declined, network errors)
|
||||
- Verifies retry logic with specific mock sequences
|
||||
- Validates parameters passed to gateway
|
||||
- Tests error propagation and recovery
|
||||
|
||||
## Tone Examples
|
||||
|
||||
✅ **Good - Specific and Constructive**
|
||||
> "Lines 23-27: This nested loop creates O(n²) complexity. Use a Set for O(n):
|
||||
> ```javascript
|
||||
> const seen = new Set();
|
||||
> for (const item of items) {
|
||||
> if (!seen.has(item)) {
|
||||
> seen.add(item);
|
||||
> process(item);
|
||||
> }
|
||||
> }
|
||||
> ```"
|
||||
|
||||
❌ **Bad - Vague and Harsh**
|
||||
> "This code is terrible and inefficient."
|
||||
|
||||
✅ **Good - Direct About Test Quality**
|
||||
> "Test `should create user` (line 45) only checks `result.toBeTruthy()`. This would pass even if the function returns an empty object. Test specific fields and verify the user exists in the database:
|
||||
> ```javascript
|
||||
> expect(result.id).toBeDefined();
|
||||
> expect(result.email).toBe('test@example.com');
|
||||
> const dbUser = await db.findById(result.id);
|
||||
> expect(dbUser).toBeDefined();
|
||||
> ```"
|
||||
|
||||
❌ **Bad - Vague Criticism**
|
||||
> "Tests are weak."
|
||||
|
||||
✅ **Good - Identifies Missing Coverage**
|
||||
> "No tests cover what happens when the database connection fails. Add a test that mocks a connection error and verifies the service throws the appropriate exception and doesn't leave partial data."
|
||||
|
||||
## Scope & Stopping Conditions
|
||||
|
||||
<completion_criteria>
|
||||
**Review is complete when:**
|
||||
- All files in the changeset have been analyzed
|
||||
- Issues are categorized by severity (Critical → Medium)
|
||||
- Each issue includes line numbers, impact, and fix
|
||||
- Test quality has been evaluated using the framework
|
||||
- Strengths are acknowledged where applicable
|
||||
- Next steps are prioritized by impact
|
||||
|
||||
**Early stop if:**
|
||||
- Critical security issue found requiring immediate attention
|
||||
- Fundamental architectural problem makes detailed review premature
|
||||
- Code is auto-generated or vendored (note this and skip detailed review)
|
||||
</completion_criteria>
|
||||
|
||||
---
|
||||
|
||||
**Ready for code.** Paste the code to review, or specify files/commits if you have them.
|
||||
```
|
||||
|
|
@ -0,0 +1,2 @@
|
|||
{"id":"beads-orchestration-2po","title":"TEST-002","description":"Create Badge component","status":"open","priority":2,"issue_type":"task","owner":"AvivK5498@users.noreply.github.com","created_at":"2026-01-18T11:46:47.242829+02:00","created_by":"Aviv Kaplan","updated_at":"2026-01-18T11:46:47.242829+02:00","comments":[{"id":5,"issue_id":"beads-orchestration-2po","author":"Aviv Kaplan","text":"RAMS: 85/100, WIG: passed with minor observations","created_at":"2026-01-18T09:46:49Z"}]}
|
||||
{"id":"beads-orchestration-d9i","title":"Create Card component","description":"Simple Card component for UI with accessibility features","status":"open","priority":2,"issue_type":"task","owner":"AvivK5498@users.noreply.github.com","created_at":"2026-01-18T11:43:16.808241+02:00","created_by":"Aviv Kaplan","updated_at":"2026-01-18T11:43:16.808241+02:00","comments":[{"id":1,"issue_id":"beads-orchestration-d9i","author":"Aviv Kaplan","text":"Reviews completed: RAMS 85/100, WIG 3 issues. Serious: missing focus-visible state (needs focus-visible:ring-* classes). Moderate: interactive div should use button element. WIG issues: needs focus-visible ring, prefers-reduced-motion support for transitions, consider semantic button element for interactive variant.","created_at":"2026-01-18T09:43:43Z"},{"id":2,"issue_id":"beads-orchestration-d9i","author":"Aviv Kaplan","text":"Reviews: RAMS 85/100, WIG 3 issues found. Serious: missing focus-visible state. Component functional but needs focus indicator, motion preferences, and semantic improvements.","created_at":"2026-01-18T09:43:59Z"},{"id":3,"issue_id":"beads-orchestration-d9i","author":"Aviv Kaplan","text":"Reviews: RAMS 85/100, WIG 3 issues. 1 serious issue (missing focus-visible state), 1 moderate issue.","created_at":"2026-01-18T09:44:04Z"},{"id":4,"issue_id":"beads-orchestration-d9i","author":"Aviv Kaplan","text":"Reviews: RAMS 85/100, WIG 3 issues. 1 serious issue (missing focus-visible state).","created_at":"2026-01-18T09:44:10Z"}]}
|
||||
|
|
@ -0,0 +1,68 @@
|
|||
#!/bin/bash
|
||||
#
|
||||
# PreToolUse:Bash - Block branch creation for epic children
|
||||
#
|
||||
# Epic children MUST work on the shared EPIC_BRANCH (bd-{EPIC_ID}).
|
||||
# This hook blocks any `git checkout -b` command when working on an epic child.
|
||||
#
|
||||
# Detection: BEAD_ID contains a dot (e.g., BD-001.2 = child of BD-001)
|
||||
#
|
||||
|
||||
INPUT=$(cat)
|
||||
TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
|
||||
|
||||
# Only check Bash commands
|
||||
[[ "$TOOL_NAME" != "Bash" ]] && exit 0
|
||||
|
||||
COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty')
|
||||
|
||||
# Only care about git checkout -b (branch creation)
|
||||
if ! echo "$COMMAND" | grep -qE 'git\s+checkout\s+-b|git\s+switch\s+-c|git\s+branch\s+[^-]'; then
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# Check if we're in an epic child context by looking at recent bead context
|
||||
# Strategy: Look for BEAD_ID pattern in the prompt/context that contains a dot
|
||||
CONVERSATION_CONTEXT=$(echo "$INPUT" | jq -r '.conversation_context // empty')
|
||||
|
||||
# Extract BEAD_ID from various patterns
|
||||
BEAD_ID=""
|
||||
|
||||
# Try to find BEAD_ID in conversation context
|
||||
if [[ -n "$CONVERSATION_CONTEXT" ]]; then
|
||||
BEAD_ID=$(echo "$CONVERSATION_CONTEXT" | grep -oE "BEAD_ID:?\s*[A-Za-z0-9._-]+" | head -1 | sed 's/BEAD_ID:*\s*//')
|
||||
fi
|
||||
|
||||
# If no context, try to infer from current branch name
|
||||
if [[ -z "$BEAD_ID" ]]; then
|
||||
CURRENT_BRANCH=$(git branch --show-current 2>/dev/null)
|
||||
if [[ "$CURRENT_BRANCH" =~ ^bd-([A-Za-z0-9._-]+) ]]; then
|
||||
BEAD_ID="${BASH_REMATCH[1]}"
|
||||
fi
|
||||
fi
|
||||
|
||||
# If still no BEAD_ID, allow the command
|
||||
[[ -z "$BEAD_ID" ]] && exit 0
|
||||
|
||||
# Check if this is an epic child (contains a dot like BD-001.2)
|
||||
if [[ "$BEAD_ID" == *"."* ]]; then
|
||||
# Extract the parent epic ID
|
||||
EPIC_ID=$(echo "$BEAD_ID" | sed 's/\.[0-9]*$//')
|
||||
|
||||
cat << EOF
|
||||
{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"<epic-branch-enforcement>
|
||||
BLOCKED: Cannot create new branch for epic child ${BEAD_ID}
|
||||
|
||||
Epic children MUST work on the shared epic branch: bd-${EPIC_ID}
|
||||
|
||||
Instead of creating a new branch, use:
|
||||
git checkout bd-${EPIC_ID}
|
||||
|
||||
This ensures all epic children's work stays on the same branch for atomic merging.
|
||||
</epic-branch-enforcement>"}}
|
||||
EOF
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# Not an epic child, allow branch creation
|
||||
exit 0
|
||||
|
|
@ -0,0 +1,25 @@
|
|||
{
|
||||
"hooks": {
|
||||
"PreToolUse": [
|
||||
{
|
||||
"matcher": "Bash",
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": ".claude/hooks/block-branch-for-epic-child.sh"
|
||||
}
|
||||
]
|
||||
}
|
||||
],
|
||||
"UserPromptSubmit": [
|
||||
{
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": ".claude/hooks/clarify-vague-request.sh"
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,208 @@
|
|||
---
|
||||
name: create-beads-orchestration
|
||||
description: Bootstrap lean multi-agent orchestration with beads task tracking. Use for projects needing agent delegation without heavy MCP overhead.
|
||||
user-invocable: true
|
||||
---
|
||||
|
||||
# Create Beads Orchestration
|
||||
|
||||
Set up lightweight multi-agent orchestration with git-native task tracking and mandatory code review gates.
|
||||
|
||||
---
|
||||
|
||||
## CRITICAL: Mandatory 4-Step Workflow
|
||||
|
||||
<mandatory-workflow>
|
||||
You MUST follow ALL 4 steps below in exact order. Missing ANY step is a CATASTROPHIC FAILURE.
|
||||
|
||||
| Step | Action | Checkpoint |
|
||||
|------|--------|------------|
|
||||
| 1 | Get project info from user | Have project name, directory, AND provider choice |
|
||||
| 2 | Clone repo and run bootstrap | Bootstrap completes successfully |
|
||||
| 3 | **STOP** - Instruct user to restart Claude Code | User confirms they will restart |
|
||||
| 4 | After restart: Run discovery agent | Supervisors created in .claude/agents/ |
|
||||
|
||||
**DO NOT:**
|
||||
- Skip asking for project info
|
||||
- **Skip asking about provider delegation (Claude-only vs External providers)**
|
||||
- Continue after bootstrap without telling user to restart
|
||||
- Forget to run discovery after restart
|
||||
- Consider setup complete until discovery has run
|
||||
|
||||
**The setup is NOT complete until Step 4 (discovery) has run.**
|
||||
</mandatory-workflow>
|
||||
|
||||
---
|
||||
|
||||
## Step 1: Get Project Info
|
||||
|
||||
<critical-step1>
|
||||
**YOU MUST ASK ALL THREE QUESTIONS BEFORE PROCEEDING TO STEP 2 using AskUserQuestion.**
|
||||
|
||||
1. **Project directory**: Where to install (default: current working directory)
|
||||
2. **Project name**: For agent templates (will auto-infer from package.json/pyproject.toml if not provided)
|
||||
3. **Provider delegation**: MANDATORY - You MUST use AskUserQuestion for this choice
|
||||
</critical-step1>
|
||||
|
||||
### 1.1 Get Project Directory and Name
|
||||
|
||||
Ask the user or auto-detect from package.json/pyproject.toml.
|
||||
|
||||
### 1.2 MANDATORY: Ask Provider Delegation Choice
|
||||
|
||||
<mandatory-question>
|
||||
**YOU MUST CALL AskUserQuestion WITH THIS EXACT QUESTION BEFORE RUNNING BOOTSTRAP.**
|
||||
|
||||
Do NOT skip this. Do NOT assume a default. Do NOT proceed without the user's explicit choice.
|
||||
|
||||
```
|
||||
AskUserQuestion(
|
||||
questions=[{
|
||||
"question": "How should read-only agents (scout, detective, architect, scribe, code-reviewer) be executed?",
|
||||
"header": "Providers",
|
||||
"options": [
|
||||
{"label": "Claude only (Recommended)", "description": "All agents run via Claude Task(). Simpler setup, no external dependencies."},
|
||||
{"label": "External providers", "description": "Delegate to Codex CLI (with Gemini fallback). Requires codex login and optional gemini CLI."}
|
||||
],
|
||||
"multiSelect": false
|
||||
}]
|
||||
)
|
||||
```
|
||||
|
||||
**After user answers:**
|
||||
- If "Claude only" → use `--claude-only` flag in bootstrap
|
||||
- If "External providers" → do NOT use `--claude-only` flag
|
||||
</mandatory-question>
|
||||
|
||||
**DO NOT proceed to Step 2 until you have the provider choice from the user.**
|
||||
|
||||
---
|
||||
|
||||
## Step 2: Clone and Run Bootstrap
|
||||
|
||||
```bash
|
||||
git clone --depth=1 https://github.com/AvivK5498/The-Claude-Protocol "${TMPDIR:-/tmp}/beads-orchestration-setup"
|
||||
```
|
||||
|
||||
```bash
|
||||
# If user selected "Claude only":
|
||||
python3 "${TMPDIR:-/tmp}/beads-orchestration-setup/bootstrap.py" \
|
||||
--project-name "{{PROJECT_NAME}}" \
|
||||
--project-dir "{{PROJECT_DIR}}" \
|
||||
--claude-only
|
||||
|
||||
# If user selected "External providers":
|
||||
python3 "${TMPDIR:-/tmp}/beads-orchestration-setup/bootstrap.py" \
|
||||
--project-name "{{PROJECT_NAME}}" \
|
||||
--project-dir "{{PROJECT_DIR}}"
|
||||
```
|
||||
|
||||
The bootstrap script will:
|
||||
1. Install beads CLI (via brew, npm, or go)
|
||||
2. Initialize `.beads/` directory
|
||||
3. Copy agent templates to `.claude/agents/`
|
||||
4. Copy hooks to `.claude/hooks/`
|
||||
5. Configure `.claude/settings.json`
|
||||
6. Set up `.mcp.json` for provider_delegator
|
||||
7. Create `CLAUDE.md` with orchestrator instructions
|
||||
8. Update `.gitignore`
|
||||
|
||||
**Verify bootstrap completed successfully before proceeding.**
|
||||
|
||||
---
|
||||
|
||||
## Step 3: STOP - User Must Restart
|
||||
|
||||
<critical>
|
||||
**YOU MUST STOP HERE AND INSTRUCT THE USER TO RESTART CLAUDE CODE.**
|
||||
|
||||
Tell the user:
|
||||
|
||||
> **Setup phase complete. You MUST restart Claude Code now.**
|
||||
>
|
||||
> The new hooks and MCP configuration will only load after restart.
|
||||
>
|
||||
> After restarting:
|
||||
> 1. Open this same project directory
|
||||
> 2. Tell me "Continue orchestration setup" or run `/create-beads-orchestration` again
|
||||
> 3. I will run the discovery agent to complete setup
|
||||
>
|
||||
> **Do not skip this restart - the orchestration will not work without it.**
|
||||
|
||||
**DO NOT proceed to Step 4 in this session. The restart is mandatory.**
|
||||
</critical>
|
||||
|
||||
---
|
||||
|
||||
## Step 4: Run Discovery (After Restart)
|
||||
|
||||
<post-restart>
|
||||
If the user returns after restart and says "continue setup" or similar:
|
||||
|
||||
1. Verify bootstrap completed (check for `.claude/agents/scout.md`)
|
||||
2. Run the discovery agent:
|
||||
|
||||
```python
|
||||
Task(
|
||||
subagent_type="discovery",
|
||||
prompt="Detect tech stack and create supervisors for this project"
|
||||
)
|
||||
```
|
||||
|
||||
Discovery will:
|
||||
- Scan package.json, requirements.txt, Dockerfile, etc.
|
||||
- Fetch specialist agents from external directory
|
||||
- Inject beads workflow into each supervisor
|
||||
- Write supervisors to `.claude/agents/`
|
||||
|
||||
3. After discovery completes, tell the user:
|
||||
|
||||
> **Orchestration setup complete!**
|
||||
>
|
||||
> Created supervisors: [list what discovery created]
|
||||
>
|
||||
> You can now use the orchestration workflow:
|
||||
> - Create tasks with `bd create "Task name" -d "Description"`
|
||||
> - The orchestrator will delegate to appropriate supervisors
|
||||
> - All work requires code review before completion
|
||||
</post-restart>
|
||||
|
||||
---
|
||||
|
||||
## Cleanup (Optional)
|
||||
|
||||
```bash
|
||||
rm -rf "${TMPDIR:-/tmp}/beads-orchestration-setup"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## What This Creates
|
||||
|
||||
- **Beads CLI** for git-native task tracking (one bead = one branch = one task)
|
||||
- **Core agents**: scout, detective, architect, scribe, code-reviewer
|
||||
- **Discovery agent**: Auto-detects tech stack and creates specialized supervisors
|
||||
- **Hooks**: Enforce orchestrator discipline, code review gates, concise responses
|
||||
- **Branch-per-task workflow**: Parallel development with automated merge conflict handling
|
||||
|
||||
**With `--claude-only` (default):**
|
||||
- All agents run via Claude Task() - no external dependencies
|
||||
|
||||
**With external providers:**
|
||||
- MCP Provider Delegator enables Codex→Gemini→Claude fallback chain
|
||||
- Additional enforcement hooks for provider delegation
|
||||
|
||||
## Requirements
|
||||
|
||||
**Claude only mode (default):**
|
||||
- **beads CLI**: Installed automatically (or manually via brew/npm/go)
|
||||
- **uv**: Python package manager (only if using external providers)
|
||||
|
||||
**External providers mode:**
|
||||
- **Codex CLI**: `codex login` for authentication (primary provider)
|
||||
- **Gemini CLI**: Optional fallback when Codex hits rate limits
|
||||
- **uv**: Python package manager for MCP server
|
||||
|
||||
## More Information
|
||||
|
||||
See the full documentation: https://github.com/AvivK5498/The-Claude-Protocol
|
||||
54
.agents/skills/create-beads-orchestration/.github/workflows/release.yml
vendored
Normal file
54
.agents/skills/create-beads-orchestration/.github/workflows/release.yml
vendored
Normal file
|
|
@ -0,0 +1,54 @@
|
|||
name: Release
|
||||
|
||||
on:
|
||||
push:
|
||||
tags:
|
||||
- 'v*'
|
||||
workflow_dispatch:
|
||||
inputs:
|
||||
version:
|
||||
description: 'Version to release (e.g., v2.0.0)'
|
||||
required: true
|
||||
type: string
|
||||
|
||||
jobs:
|
||||
release:
|
||||
runs-on: ubuntu-latest
|
||||
permissions:
|
||||
contents: write
|
||||
|
||||
steps:
|
||||
- name: Checkout
|
||||
uses: actions/checkout@v4
|
||||
|
||||
- name: Create GitHub Release
|
||||
uses: softprops/action-gh-release@v1
|
||||
with:
|
||||
name: ${{ github.ref_name || inputs.version }}
|
||||
tag_name: ${{ github.ref_name || inputs.version }}
|
||||
generate_release_notes: true
|
||||
|
||||
publish-npm:
|
||||
needs: release
|
||||
runs-on: ubuntu-latest
|
||||
|
||||
steps:
|
||||
- name: Checkout
|
||||
uses: actions/checkout@v4
|
||||
|
||||
- name: Setup Node.js
|
||||
uses: actions/setup-node@v4
|
||||
with:
|
||||
node-version: '20'
|
||||
registry-url: 'https://registry.npmjs.org'
|
||||
|
||||
- name: Update package version
|
||||
run: |
|
||||
VERSION="${{ github.ref_name || inputs.version }}"
|
||||
VERSION="${VERSION#v}"
|
||||
npm version $VERSION --no-git-tag-version --allow-same-version
|
||||
|
||||
- name: Publish to npm
|
||||
run: npm publish
|
||||
env:
|
||||
NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
|
||||
23
.agents/skills/create-beads-orchestration/.gitignore
vendored
Normal file
23
.agents/skills/create-beads-orchestration/.gitignore
vendored
Normal file
|
|
@ -0,0 +1,23 @@
|
|||
# Python
|
||||
__pycache__/
|
||||
*.py[cod]
|
||||
*.egg-info/
|
||||
.eggs/
|
||||
dist/
|
||||
build/
|
||||
.venv/
|
||||
.pytest_cache/
|
||||
|
||||
# IDE
|
||||
.idea/
|
||||
.vscode/
|
||||
*.swp
|
||||
*.swo
|
||||
|
||||
# OS
|
||||
.DS_Store
|
||||
Thumbs.db
|
||||
|
||||
# Test outputs
|
||||
/tmp/
|
||||
.history/
|
||||
21
.agents/skills/create-beads-orchestration/LICENSE
Normal file
21
.agents/skills/create-beads-orchestration/LICENSE
Normal file
|
|
@ -0,0 +1,21 @@
|
|||
MIT License
|
||||
|
||||
Copyright (c) 2026 Aviv Kaplan
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
in the Software without restriction, including without limitation the rights
|
||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in all
|
||||
copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||
SOFTWARE.
|
||||
263
.agents/skills/create-beads-orchestration/SKILL.md
Normal file
263
.agents/skills/create-beads-orchestration/SKILL.md
Normal file
|
|
@ -0,0 +1,263 @@
|
|||
---
|
||||
name: create-beads-orchestration
|
||||
description: Bootstrap lean multi-agent orchestration with beads task tracking. Use for projects needing agent delegation without heavy MCP overhead.
|
||||
user-invocable: true
|
||||
---
|
||||
|
||||
# Create Beads Orchestration
|
||||
|
||||
Set up lightweight multi-agent orchestration with git-native task tracking for Claude Code.
|
||||
|
||||
## What This Skill Does
|
||||
|
||||
This skill bootstraps a complete multi-agent workflow where:
|
||||
|
||||
- **Orchestrator** (you) investigates issues, manages tasks, delegates implementation
|
||||
- **Supervisors** (specialized agents) execute fixes in isolated worktrees
|
||||
- **Beads CLI** tracks all work with git-native task management
|
||||
- **Hooks** enforce workflow discipline automatically
|
||||
|
||||
Each task gets its own worktree at `.worktrees/bd-{BEAD_ID}/`, keeping main clean and enabling parallel work.
|
||||
|
||||
## Beads Kanban UI
|
||||
|
||||
The setup will auto-detect [Beads Kanban UI](https://github.com/AvivK5498/Beads-Kanban-UI) and configure accordingly. If not found, you'll be offered to install it.
|
||||
|
||||
---
|
||||
|
||||
## Step 0: Detect Setup State (ALWAYS RUN FIRST)
|
||||
|
||||
<detection-phase>
|
||||
**Before doing anything else, detect if this is a fresh setup or a resume after restart.**
|
||||
|
||||
Check for bootstrap artifacts:
|
||||
```bash
|
||||
ls .claude/agents/scout.md 2>/dev/null && echo "BOOTSTRAP_COMPLETE" || echo "FRESH_SETUP"
|
||||
```
|
||||
|
||||
**If `BOOTSTRAP_COMPLETE`:**
|
||||
- Bootstrap already ran in a previous session
|
||||
- Skip directly to **Step 4: Run Discovery**
|
||||
- Do NOT ask for project info or run bootstrap again
|
||||
|
||||
**If `FRESH_SETUP`:**
|
||||
- This is a new installation
|
||||
- Proceed to **Step 1: Get Project Info**
|
||||
</detection-phase>
|
||||
|
||||
---
|
||||
|
||||
## Workflow Overview
|
||||
|
||||
<mandatory-workflow>
|
||||
| Step | Action | When to Run |
|
||||
|------|--------|-------------|
|
||||
| 0 | Detect setup state | **ALWAYS** (determines path) |
|
||||
| 1 | Get project info from user | Fresh setup only |
|
||||
| 2 | Run bootstrap | Fresh setup only |
|
||||
| 3 | **STOP** - Instruct user to restart | Fresh setup only |
|
||||
| 4 | Run discovery agent | After restart OR if bootstrap already complete |
|
||||
|
||||
**The setup is NOT complete until Step 4 (discovery) has run.**
|
||||
</mandatory-workflow>
|
||||
|
||||
---
|
||||
|
||||
## Step 1: Get Project Info (Fresh Setup Only)
|
||||
|
||||
<critical-step1>
|
||||
**YOU MUST GET PROJECT INFO AND DETECT/ASK ABOUT KANBAN UI BEFORE PROCEEDING TO STEP 2.**
|
||||
|
||||
1. **Project directory**: Where to install (default: current working directory)
|
||||
2. **Project name**: For agent templates (will auto-infer from package.json/pyproject.toml if not provided)
|
||||
3. **Kanban UI**: Auto-detect, or ask the user to install
|
||||
</critical-step1>
|
||||
|
||||
### 1.1 Get Project Directory and Name
|
||||
|
||||
Ask the user or auto-detect from package.json/pyproject.toml.
|
||||
|
||||
### 1.2 Detect or Install Kanban UI
|
||||
|
||||
```bash
|
||||
which bead-kanban 2>/dev/null && echo "KANBAN_FOUND" || echo "KANBAN_NOT_FOUND"
|
||||
```
|
||||
|
||||
**If KANBAN_FOUND** → Use `--with-kanban-ui` flag. Tell the user:
|
||||
> Detected Beads Kanban UI. Configuring worktree management via API.
|
||||
|
||||
**If KANBAN_NOT_FOUND** → Ask:
|
||||
|
||||
```
|
||||
AskUserQuestion(
|
||||
questions=[
|
||||
{
|
||||
"question": "Beads Kanban UI not detected. It adds a visual kanban board with dependency graphs and API-driven worktree management. Install it?",
|
||||
"header": "Kanban UI",
|
||||
"options": [
|
||||
{"label": "Yes, install it (Recommended)", "description": "Runs: npm install -g beads-kanban-ui"},
|
||||
{"label": "Skip", "description": "Use git worktrees directly. You can install later."}
|
||||
],
|
||||
"multiSelect": false
|
||||
}
|
||||
]
|
||||
)
|
||||
```
|
||||
|
||||
- If "Yes" → Run `npm install -g beads-kanban-ui`, then use `--with-kanban-ui` flag
|
||||
- If "Skip" → do NOT use `--with-kanban-ui` flag
|
||||
|
||||
---
|
||||
|
||||
## Step 2: Run Bootstrap
|
||||
|
||||
```bash
|
||||
# With Kanban UI:
|
||||
npx beads-orchestration@latest bootstrap \
|
||||
--project-name "{{PROJECT_NAME}}" \
|
||||
--project-dir "{{PROJECT_DIR}}" \
|
||||
--with-kanban-ui
|
||||
|
||||
# Without Kanban UI (git worktrees only):
|
||||
npx beads-orchestration@latest bootstrap \
|
||||
--project-name "{{PROJECT_NAME}}" \
|
||||
--project-dir "{{PROJECT_DIR}}"
|
||||
```
|
||||
|
||||
The bootstrap script will:
|
||||
1. Install beads CLI (via brew, npm, or go)
|
||||
2. Initialize `.beads/` directory
|
||||
3. Copy agent templates to `.claude/agents/`
|
||||
4. Copy hooks to `.claude/hooks/`
|
||||
5. Configure `.claude/settings.json`
|
||||
6. Create `CLAUDE.md` with orchestrator instructions
|
||||
7. Update `.gitignore`
|
||||
|
||||
**Verify bootstrap completed successfully before proceeding.**
|
||||
|
||||
---
|
||||
|
||||
## Step 3: STOP - User Must Restart
|
||||
|
||||
<critical>
|
||||
**YOU MUST STOP HERE AND INSTRUCT THE USER TO RESTART CLAUDE CODE.**
|
||||
|
||||
Tell the user:
|
||||
|
||||
> **Setup phase complete. You MUST restart Claude Code now.**
|
||||
>
|
||||
> The new hooks and MCP configuration will only load after restart.
|
||||
>
|
||||
> After restarting:
|
||||
> 1. Open this same project directory
|
||||
> 2. Tell me "Continue orchestration setup" or run `/create-beads-orchestration` again
|
||||
> 3. I will run the discovery agent to complete setup
|
||||
>
|
||||
> **Do not skip this restart - the orchestration will not work without it.**
|
||||
|
||||
**DO NOT proceed to Step 4 in this session. The restart is mandatory.**
|
||||
</critical>
|
||||
|
||||
---
|
||||
|
||||
## Step 4: Run Discovery (After Restart OR Detection)
|
||||
|
||||
<post-restart>
|
||||
**Run this step if:**
|
||||
- Step 0 detected `BOOTSTRAP_COMPLETE`, OR
|
||||
- User returned after restart and said "continue setup" or ran `/create-beads-orchestration` again
|
||||
|
||||
1. Verify bootstrap completed (check for `.claude/agents/scout.md`) - already done in Step 0
|
||||
2. Run the discovery agent:
|
||||
|
||||
```python
|
||||
Task(
|
||||
subagent_type="discovery",
|
||||
prompt="Detect tech stack and create supervisors for this project"
|
||||
)
|
||||
```
|
||||
|
||||
Discovery will:
|
||||
- Scan package.json, requirements.txt, Dockerfile, etc.
|
||||
- Fetch specialist agents from external directory
|
||||
- Inject beads workflow into each supervisor
|
||||
- Write supervisors to `.claude/agents/`
|
||||
|
||||
3. After discovery completes, tell the user:
|
||||
|
||||
> **Orchestration setup complete!**
|
||||
>
|
||||
> Created supervisors: [list what discovery created]
|
||||
>
|
||||
> You can now use the orchestration workflow:
|
||||
> - Create tasks with `bd create "Task name" -d "Description"`
|
||||
> - The orchestrator will delegate to appropriate supervisors
|
||||
> - All work requires code review before completion
|
||||
</post-restart>
|
||||
|
||||
---
|
||||
|
||||
## What This Creates
|
||||
|
||||
- **Beads CLI** for git-native task tracking (one bead = one worktree = one task)
|
||||
- **Core agents**: scout, detective, architect, scribe, code-reviewer (all run via Claude Task)
|
||||
- **Discovery agent**: Auto-detects tech stack and creates specialized supervisors
|
||||
- **Hooks**: Enforce orchestrator discipline, code review gates, concise responses
|
||||
- **Worktree-per-task workflow**: Isolated development in `.worktrees/bd-{BEAD_ID}/`
|
||||
|
||||
**With `--with-kanban-ui`:**
|
||||
- Worktrees created via API (localhost:3008) with git fallback
|
||||
- Requires [Beads Kanban UI](https://github.com/AvivK5498/Beads-Kanban-UI) running
|
||||
|
||||
**Without `--with-kanban-ui`:**
|
||||
- Worktrees created via raw git commands
|
||||
|
||||
## Epic Workflow (Cross-Domain Features)
|
||||
|
||||
For features requiring multiple supervisors (e.g., DB + API + Frontend), use the **epic workflow**:
|
||||
|
||||
### When to Use Epics
|
||||
|
||||
| Task Type | Workflow |
|
||||
|-----------|----------|
|
||||
| Single-domain (one supervisor) | Standalone bead |
|
||||
| Cross-domain (multiple supervisors) | Epic with children |
|
||||
|
||||
### Epic Workflow Steps
|
||||
|
||||
1. **Create epic**: `bd create "Feature name" -d "Description" --type epic`
|
||||
2. **Create design doc** (if needed): Dispatch architect to create `.designs/{EPIC_ID}.md`
|
||||
3. **Link design**: `bd update {EPIC_ID} --design ".designs/{EPIC_ID}.md"`
|
||||
4. **Create children with dependencies**:
|
||||
```bash
|
||||
bd create "DB schema" -d "..." --parent {EPIC_ID} # BD-001.1
|
||||
bd create "API endpoints" -d "..." --parent {EPIC_ID} --deps BD-001.1 # BD-001.2
|
||||
bd create "Frontend" -d "..." --parent {EPIC_ID} --deps BD-001.2 # BD-001.3
|
||||
```
|
||||
5. **Dispatch sequentially**: Use `bd ready` to find unblocked tasks (each child gets own worktree)
|
||||
6. **User merges each PR**: Wait for child's PR to merge before dispatching next
|
||||
7. **Close epic**: `bd close {EPIC_ID}` after all children merged
|
||||
|
||||
### Design Docs
|
||||
|
||||
Design docs ensure consistency across epic children:
|
||||
- Schema definitions (exact column names, types)
|
||||
- API contracts (endpoints, request/response shapes)
|
||||
- Shared constants/enums
|
||||
- Data flow between layers
|
||||
|
||||
**Key rule**: Orchestrator dispatches architect to create design docs. Orchestrator never writes design docs directly.
|
||||
|
||||
### Hooks Enforce Epic Workflow
|
||||
|
||||
- **enforce-sequential-dispatch.sh**: Blocks dispatch if task has unresolved blockers
|
||||
- **enforce-bead-for-supervisor.sh**: Requires BEAD_ID for all supervisors
|
||||
- **validate-completion.sh**: Verifies worktree, push, bead status before supervisor completes
|
||||
|
||||
## Requirements
|
||||
|
||||
- **beads CLI**: Installed automatically by bootstrap (via brew, npm, or go)
|
||||
|
||||
## More Information
|
||||
|
||||
See the full documentation: https://github.com/AvivK5498/The-Claude-Protocol
|
||||
928
.agents/skills/create-beads-orchestration/bootstrap.py
Normal file
928
.agents/skills/create-beads-orchestration/bootstrap.py
Normal file
|
|
@ -0,0 +1,928 @@
|
|||
#!/usr/bin/env python3
|
||||
"""
|
||||
Bootstrap script for beads-based orchestration.
|
||||
|
||||
Creates:
|
||||
- .beads/ directory with beads CLI
|
||||
- .claude/agents/ with agent templates (copied, not generated)
|
||||
- .claude/hooks/ with hook scripts
|
||||
- .claude/settings.json with hook configuration
|
||||
- .mcp.json with provider-delegator configuration (only with --external-providers)
|
||||
|
||||
Usage:
|
||||
python bootstrap.py [--project-name NAME] [--project-dir DIR] [--with-kanban-ui]
|
||||
|
||||
Modes:
|
||||
Default: All agents use Claude Task() directly (claude-only)
|
||||
--external-providers: Sets up provider_delegator MCP for Codex/Gemini delegation
|
||||
"""
|
||||
|
||||
import os
|
||||
import sys
|
||||
import json
|
||||
import shutil
|
||||
import stat
|
||||
import subprocess
|
||||
try:
|
||||
import tomllib
|
||||
except ImportError:
|
||||
tomllib = None
|
||||
from pathlib import Path
|
||||
from datetime import datetime
|
||||
import random
|
||||
|
||||
# Get the directory where this script lives (lean-orchestration repo)
|
||||
SCRIPT_DIR = Path(__file__).parent.resolve()
|
||||
TEMPLATES_DIR = SCRIPT_DIR / "templates"
|
||||
|
||||
# ============================================================================
|
||||
# CONFIGURATION
|
||||
# ============================================================================
|
||||
|
||||
CORE_AGENTS = ["scout", "detective", "architect", "scribe", "discovery", "merge-supervisor", "code-reviewer"]
|
||||
|
||||
# NOTE: Supervisors are NOT bootstrapped - they are created dynamically by the
|
||||
# discovery agent which fetches specialists from the external agents directory
|
||||
# and injects the beads workflow.
|
||||
|
||||
|
||||
# ============================================================================
|
||||
# PROJECT NAME INFERENCE
|
||||
# ============================================================================
|
||||
|
||||
def infer_project_name(project_dir: Path) -> str:
|
||||
"""Auto-infer project name from package files or directory name."""
|
||||
|
||||
# Try package.json (Node.js)
|
||||
package_json = project_dir / "package.json"
|
||||
if package_json.exists():
|
||||
try:
|
||||
data = json.loads(package_json.read_text())
|
||||
if name := data.get("name"):
|
||||
return name.replace("-", " ").replace("_", " ").title()
|
||||
except (json.JSONDecodeError, KeyError):
|
||||
pass
|
||||
|
||||
# Try pyproject.toml (Python)
|
||||
if tomllib:
|
||||
pyproject = project_dir / "pyproject.toml"
|
||||
if pyproject.exists():
|
||||
try:
|
||||
data = tomllib.loads(pyproject.read_text())
|
||||
if name := data.get("project", {}).get("name"):
|
||||
return name.replace("-", " ").replace("_", " ").title()
|
||||
if name := data.get("tool", {}).get("poetry", {}).get("name"):
|
||||
return name.replace("-", " ").replace("_", " ").title()
|
||||
except Exception:
|
||||
pass
|
||||
|
||||
# Try Cargo.toml (Rust)
|
||||
cargo = project_dir / "Cargo.toml"
|
||||
if cargo.exists():
|
||||
try:
|
||||
data = tomllib.loads(cargo.read_text())
|
||||
if name := data.get("package", {}).get("name"):
|
||||
return name.replace("-", " ").replace("_", " ").title()
|
||||
except Exception:
|
||||
pass
|
||||
|
||||
# Try go.mod (Go)
|
||||
go_mod = project_dir / "go.mod"
|
||||
if go_mod.exists():
|
||||
try:
|
||||
content = go_mod.read_text()
|
||||
for line in content.splitlines():
|
||||
if line.startswith("module "):
|
||||
module_path = line.split()[1]
|
||||
name = module_path.split("/")[-1]
|
||||
return name.replace("-", " ").replace("_", " ").title()
|
||||
except Exception:
|
||||
pass
|
||||
|
||||
# Fallback to directory name
|
||||
return project_dir.name.replace("-", " ").replace("_", " ").title()
|
||||
|
||||
|
||||
# ============================================================================
|
||||
# PLACEHOLDER REPLACEMENT
|
||||
# ============================================================================
|
||||
|
||||
def replace_placeholders(content: str, replacements: dict) -> str:
|
||||
"""Replace all placeholders in content."""
|
||||
for placeholder, value in replacements.items():
|
||||
content = content.replace(placeholder, value)
|
||||
return content
|
||||
|
||||
|
||||
def copy_and_replace(source: Path, dest: Path, replacements: dict) -> None:
|
||||
"""Copy file and replace placeholders."""
|
||||
content = source.read_text()
|
||||
updated = replace_placeholders(content, replacements)
|
||||
dest.parent.mkdir(parents=True, exist_ok=True)
|
||||
dest.write_text(updated)
|
||||
|
||||
# Preserve executable permissions for shell scripts
|
||||
if source.suffix == '.sh':
|
||||
dest.chmod(dest.stat().st_mode | stat.S_IEXEC | stat.S_IXGRP | stat.S_IXOTH)
|
||||
|
||||
|
||||
# ============================================================================
|
||||
# CODEX DELEGATOR SETUP (SHARED LOCATION)
|
||||
# ============================================================================
|
||||
|
||||
# Shared location for provider-delegator (installed once, used by all projects)
|
||||
SHARED_MCP_DIR = Path.home() / ".claude" / "mcp-servers" / "provider-delegator"
|
||||
|
||||
|
||||
def setup_provider_delegator() -> Path:
|
||||
"""Set up provider-delegator in shared location (~/.claude/mcp-servers/provider-delegator/).
|
||||
|
||||
This installs once and is reused by all projects.
|
||||
Returns path to venv python.
|
||||
"""
|
||||
print("\n[0/8] Setting up provider-delegator (shared)...")
|
||||
|
||||
source_dir = SCRIPT_DIR / "mcp-provider-delegator"
|
||||
venv_dir = SHARED_MCP_DIR / ".venv"
|
||||
venv_python = venv_dir / "bin" / "python"
|
||||
|
||||
# Check if already installed in shared location
|
||||
if venv_python.exists():
|
||||
print(f" - Already installed at {SHARED_MCP_DIR}")
|
||||
return venv_python
|
||||
|
||||
# Verify source exists
|
||||
if not source_dir.exists():
|
||||
print(f" ERROR: mcp-provider-delegator not found at {source_dir}")
|
||||
print(" Make sure you cloned the full lean-orchestration repo")
|
||||
return None
|
||||
|
||||
# Check if uv is available
|
||||
if not shutil.which("uv"):
|
||||
print(" ERROR: 'uv' not found. Install with: curl -LsSf https://astral.sh/uv/install.sh | sh")
|
||||
return None
|
||||
|
||||
# Create shared directory
|
||||
print(f" - Installing to {SHARED_MCP_DIR}")
|
||||
SHARED_MCP_DIR.mkdir(parents=True, exist_ok=True)
|
||||
|
||||
# Copy source to shared location
|
||||
print(" - Copying source files...")
|
||||
for item in source_dir.iterdir():
|
||||
if item.name == ".venv":
|
||||
continue # Skip any existing venv in source
|
||||
dest = SHARED_MCP_DIR / item.name
|
||||
if item.is_dir():
|
||||
if dest.exists():
|
||||
shutil.rmtree(dest)
|
||||
shutil.copytree(item, dest)
|
||||
else:
|
||||
shutil.copy2(item, dest)
|
||||
|
||||
# Create venv using uv
|
||||
print(" - Creating venv with uv...")
|
||||
result = subprocess.run(
|
||||
["uv", "venv", str(venv_dir)],
|
||||
cwd=SHARED_MCP_DIR,
|
||||
capture_output=True,
|
||||
text=True
|
||||
)
|
||||
if result.returncode != 0:
|
||||
print(f" ERROR: Failed to create venv: {result.stderr}")
|
||||
return None
|
||||
|
||||
# Install dependencies
|
||||
print(" - Installing dependencies...")
|
||||
result = subprocess.run(
|
||||
["uv", "pip", "install", "-e", "."],
|
||||
cwd=SHARED_MCP_DIR,
|
||||
capture_output=True,
|
||||
text=True,
|
||||
env={**os.environ, "VIRTUAL_ENV": str(venv_dir)}
|
||||
)
|
||||
if result.returncode != 0:
|
||||
print(f" ERROR: Failed to install dependencies: {result.stderr}")
|
||||
return None
|
||||
|
||||
print(f" DONE: provider-delegator installed at {SHARED_MCP_DIR}")
|
||||
return venv_python
|
||||
|
||||
|
||||
# ============================================================================
|
||||
# BEADS INSTALLATION
|
||||
# ============================================================================
|
||||
|
||||
def install_beads(project_dir: Path, claude_only: bool = False) -> bool:
|
||||
"""Install beads CLI and initialize .beads directory."""
|
||||
step = "[1/7]" if claude_only else "[1/8]"
|
||||
print(f"\n{step} Installing beads...")
|
||||
|
||||
beads_dir = project_dir / ".beads"
|
||||
|
||||
# Check if beads is already installed globally
|
||||
beads_installed = shutil.which("bd") is not None
|
||||
|
||||
if not beads_installed:
|
||||
print(" - beads CLI (bd) not found, installing...")
|
||||
|
||||
# Try installation methods in order of preference
|
||||
installed = False
|
||||
|
||||
# Method 1: Homebrew (macOS)
|
||||
if shutil.which("brew") and sys.platform == "darwin":
|
||||
print(" - Trying Homebrew...")
|
||||
result = subprocess.run(
|
||||
["brew", "install", "steveyegge/beads/bd"],
|
||||
capture_output=True,
|
||||
text=True
|
||||
)
|
||||
if result.returncode == 0:
|
||||
installed = True
|
||||
print(" - Installed via Homebrew")
|
||||
|
||||
# Method 2: npm (cross-platform)
|
||||
if not installed and shutil.which("npm"):
|
||||
print(" - Trying npm...")
|
||||
result = subprocess.run(
|
||||
["npm", "install", "-g", "@beads/bd"],
|
||||
capture_output=True,
|
||||
text=True
|
||||
)
|
||||
if result.returncode == 0:
|
||||
installed = True
|
||||
print(" - Installed via npm")
|
||||
|
||||
# Method 3: curl install script (Linux/macOS/FreeBSD)
|
||||
if not installed and sys.platform != "win32":
|
||||
print(" - Trying curl install script...")
|
||||
result = subprocess.run(
|
||||
["bash", "-c", "curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash"],
|
||||
capture_output=True,
|
||||
text=True
|
||||
)
|
||||
if result.returncode == 0:
|
||||
installed = True
|
||||
print(" - Installed via curl script")
|
||||
|
||||
# Method 4: Go install (if Go is available)
|
||||
if not installed and shutil.which("go"):
|
||||
print(" - Trying go install...")
|
||||
result = subprocess.run(
|
||||
["go", "install", "github.com/steveyegge/beads/cmd/bd@latest"],
|
||||
capture_output=True,
|
||||
text=True
|
||||
)
|
||||
if result.returncode == 0:
|
||||
installed = True
|
||||
print(" - Installed via go install")
|
||||
|
||||
if not installed:
|
||||
print("\n ERROR: Could not install beads CLI (bd)")
|
||||
print(" The beads workflow requires the bd command.")
|
||||
print(" Please install manually: https://github.com/steveyegge/beads#-installation")
|
||||
print("\n Installation options:")
|
||||
print(" macOS: brew install steveyegge/beads/bd")
|
||||
print(" npm: npm install -g @beads/bd")
|
||||
print(" Go: go install github.com/steveyegge/beads/cmd/bd@latest")
|
||||
return False
|
||||
else:
|
||||
print(" - beads CLI already installed")
|
||||
|
||||
beads_installed = True
|
||||
|
||||
# Initialize .beads in project
|
||||
if not beads_dir.exists():
|
||||
print(" - Initializing .beads directory...")
|
||||
|
||||
# Try bd init first
|
||||
if shutil.which("bd"):
|
||||
result = subprocess.run(
|
||||
["bd", "init"],
|
||||
cwd=project_dir,
|
||||
capture_output=True,
|
||||
text=True
|
||||
)
|
||||
if result.returncode == 0:
|
||||
print(" - Initialized via 'bd init'")
|
||||
else:
|
||||
# Manual init as fallback
|
||||
_manual_beads_init(beads_dir)
|
||||
else:
|
||||
_manual_beads_init(beads_dir)
|
||||
else:
|
||||
print(" - .beads already exists")
|
||||
|
||||
# Configure custom 'inreview' status for parallel work workflow
|
||||
if shutil.which("bd"):
|
||||
print(" - Configuring custom 'inreview' status...")
|
||||
result = subprocess.run(
|
||||
["bd", "config", "set", "status.custom", "inreview"],
|
||||
cwd=project_dir,
|
||||
capture_output=True,
|
||||
text=True
|
||||
)
|
||||
if result.returncode == 0:
|
||||
print(" - Added 'inreview' custom status")
|
||||
else:
|
||||
print(f" - Warning: Could not add custom status: {result.stderr}")
|
||||
|
||||
print(" DONE: beads setup complete")
|
||||
return True
|
||||
|
||||
|
||||
def _manual_beads_init(beads_dir: Path):
|
||||
"""Manually create .beads directory structure."""
|
||||
beads_dir.mkdir(exist_ok=True)
|
||||
(beads_dir / "issues.jsonl").touch()
|
||||
# Create minimal config
|
||||
config = {
|
||||
"version": "1",
|
||||
"mode": "normal"
|
||||
}
|
||||
(beads_dir / "config.json").write_text(json.dumps(config, indent=2))
|
||||
print(" - Created .beads manually")
|
||||
|
||||
|
||||
def setup_memory(project_dir: Path) -> None:
|
||||
"""Create .beads/memory/ directory with knowledge store and recall script."""
|
||||
memory_dir = project_dir / ".beads" / "memory"
|
||||
memory_dir.mkdir(parents=True, exist_ok=True)
|
||||
|
||||
# Create empty knowledge store
|
||||
knowledge_file = memory_dir / "knowledge.jsonl"
|
||||
if not knowledge_file.exists():
|
||||
knowledge_file.touch()
|
||||
print(" - Created .beads/memory/knowledge.jsonl")
|
||||
|
||||
# Copy recall script
|
||||
recall_src = TEMPLATES_DIR / "memory" / "recall.sh"
|
||||
recall_dest = memory_dir / "recall.sh"
|
||||
if recall_src.exists():
|
||||
shutil.copy2(recall_src, recall_dest)
|
||||
recall_dest.chmod(recall_dest.stat().st_mode | stat.S_IEXEC | stat.S_IXGRP | stat.S_IXOTH)
|
||||
print(" - Copied .beads/memory/recall.sh")
|
||||
else:
|
||||
print(" - WARNING: recall.sh template not found")
|
||||
|
||||
|
||||
# ============================================================================
|
||||
# RAMS INSTALLATION (Accessibility Review)
|
||||
# ============================================================================
|
||||
|
||||
def install_rams() -> bool:
|
||||
"""Install RAMS accessibility review tool if not already installed."""
|
||||
print("\n Checking RAMS (accessibility review tool)...")
|
||||
|
||||
# Check if rams is already installed
|
||||
if shutil.which("rams"):
|
||||
print(" - RAMS already installed")
|
||||
return True
|
||||
|
||||
print(" - RAMS not found, installing...")
|
||||
|
||||
# Install via curl
|
||||
if sys.platform != "win32":
|
||||
result = subprocess.run(
|
||||
["bash", "-c", "curl -fsSL https://rams.ai/install | bash"],
|
||||
capture_output=True,
|
||||
text=True
|
||||
)
|
||||
if result.returncode == 0:
|
||||
print(" - RAMS installed successfully")
|
||||
return True
|
||||
else:
|
||||
print(f" - Warning: Could not install RAMS: {result.stderr}")
|
||||
print(" - Frontend supervisors will still work but RAMS review enforcement may fail")
|
||||
print(" - Install manually: curl -fsSL https://rams.ai/install | bash")
|
||||
return False
|
||||
|
||||
print(" - Warning: RAMS installation not supported on Windows")
|
||||
return False
|
||||
|
||||
|
||||
# ============================================================================
|
||||
# WEB INTERFACE GUIDELINES INSTALLATION
|
||||
# ============================================================================
|
||||
|
||||
def install_web_interface_guidelines() -> bool:
|
||||
"""Install Web Interface Guidelines review tool if not already installed."""
|
||||
print("\n Checking Web Interface Guidelines (design review tool)...")
|
||||
|
||||
# Check if wig is already installed
|
||||
if shutil.which("wig"):
|
||||
print(" - Web Interface Guidelines already installed")
|
||||
return True
|
||||
|
||||
print(" - Web Interface Guidelines not found, installing...")
|
||||
|
||||
# Install via curl
|
||||
if sys.platform != "win32":
|
||||
result = subprocess.run(
|
||||
["bash", "-c", "curl -fsSL https://vercel.com/design/guidelines/install | bash"],
|
||||
capture_output=True,
|
||||
text=True
|
||||
)
|
||||
if result.returncode == 0:
|
||||
print(" - Web Interface Guidelines installed successfully")
|
||||
return True
|
||||
else:
|
||||
print(f" - Warning: Could not install Web Interface Guidelines: {result.stderr}")
|
||||
print(" - Frontend supervisors will still work but WIG review enforcement may fail")
|
||||
print(" - Install manually: curl -fsSL https://vercel.com/design/guidelines/install | bash")
|
||||
return False
|
||||
|
||||
print(" - Warning: Web Interface Guidelines installation not supported on Windows")
|
||||
return False
|
||||
|
||||
|
||||
# ============================================================================
|
||||
# AGENTS (TEMPLATE COPYING)
|
||||
# ============================================================================
|
||||
|
||||
def copy_agents(project_dir: Path, project_name: str, claude_only: bool = False, with_kanban_ui: bool = False) -> list:
|
||||
"""Copy core agent templates from templates/ directory.
|
||||
|
||||
NOTE: Supervisors are NOT copied here - they are created dynamically
|
||||
by the discovery agent based on detected tech stack.
|
||||
"""
|
||||
step = "[2/7]" if claude_only else "[2/8]"
|
||||
print(f"\n{step} Copying core agent templates...")
|
||||
|
||||
agents_dir = project_dir / ".claude" / "agents"
|
||||
agents_dir.mkdir(parents=True, exist_ok=True)
|
||||
|
||||
agents_template_dir = TEMPLATES_DIR / "agents"
|
||||
|
||||
copied = []
|
||||
|
||||
# Replacements for templates
|
||||
replacements = {
|
||||
"[Project]": project_name,
|
||||
}
|
||||
|
||||
# Copy core agents ONLY (not supervisors)
|
||||
for agent_file in agents_template_dir.glob("*.md"):
|
||||
dest = agents_dir / agent_file.name
|
||||
copy_and_replace(agent_file, dest, replacements)
|
||||
copied.append(agent_file.name)
|
||||
print(f" - Copied {agent_file.name}")
|
||||
|
||||
# Copy beads workflow injection snippet (used by discovery agent)
|
||||
# Select API version (with git fallback) or git-only version based on flag
|
||||
if with_kanban_ui:
|
||||
beads_workflow_src = TEMPLATES_DIR / "beads-workflow-injection-api.md"
|
||||
workflow_type = "API + git fallback"
|
||||
else:
|
||||
beads_workflow_src = TEMPLATES_DIR / "beads-workflow-injection-git.md"
|
||||
workflow_type = "git only"
|
||||
beads_workflow_dest = project_dir / ".claude" / "beads-workflow-injection.md"
|
||||
if beads_workflow_src.exists():
|
||||
shutil.copy2(beads_workflow_src, beads_workflow_dest)
|
||||
print(f" - Copied beads-workflow-injection.md ({workflow_type})")
|
||||
|
||||
# Copy UI constraints (used by discovery agent for frontend supervisors)
|
||||
ui_constraints_src = TEMPLATES_DIR / "ui-constraints.md"
|
||||
ui_constraints_dest = project_dir / ".claude" / "ui-constraints.md"
|
||||
if ui_constraints_src.exists():
|
||||
shutil.copy2(ui_constraints_src, ui_constraints_dest)
|
||||
print(" - Copied ui-constraints.md")
|
||||
|
||||
# Copy frontend reviews requirement (RAMS + Web Interface Guidelines)
|
||||
frontend_reviews_src = TEMPLATES_DIR / "frontend-reviews-requirement.md"
|
||||
frontend_reviews_dest = project_dir / ".claude" / "frontend-reviews-requirement.md"
|
||||
if frontend_reviews_src.exists():
|
||||
shutil.copy2(frontend_reviews_src, frontend_reviews_dest)
|
||||
print(" - Copied frontend-reviews-requirement.md")
|
||||
|
||||
print(f" DONE: {len(copied)} core agents copied")
|
||||
print(" NOTE: Supervisors will be created by discovery agent based on tech stack")
|
||||
return copied
|
||||
|
||||
|
||||
# ============================================================================
|
||||
# SKILLS (TEMPLATE COPYING)
|
||||
# ============================================================================
|
||||
|
||||
def copy_skills(project_dir: Path, claude_only: bool = False) -> list:
|
||||
"""Copy skill templates from templates/ directory.
|
||||
|
||||
Skills are copied so discovery agent can install them when tech stack is detected.
|
||||
"""
|
||||
step = "[3/7]" if claude_only else "[3/8]"
|
||||
print(f"\n{step} Copying skill templates...")
|
||||
|
||||
skills_template_dir = TEMPLATES_DIR / "skills"
|
||||
if not skills_template_dir.exists():
|
||||
print(" - No skill templates found, skipping")
|
||||
return []
|
||||
|
||||
skills_dir = project_dir / ".claude" / "skills"
|
||||
skills_dir.mkdir(parents=True, exist_ok=True)
|
||||
|
||||
copied = []
|
||||
|
||||
for skill_dir in skills_template_dir.iterdir():
|
||||
if skill_dir.is_dir():
|
||||
dest_dir = skills_dir / skill_dir.name
|
||||
if dest_dir.exists():
|
||||
shutil.rmtree(dest_dir)
|
||||
shutil.copytree(skill_dir, dest_dir)
|
||||
copied.append(skill_dir.name)
|
||||
print(f" - Copied {skill_dir.name}/ skill")
|
||||
|
||||
print(f" DONE: {len(copied)} skill templates copied")
|
||||
return copied
|
||||
|
||||
|
||||
# ============================================================================
|
||||
# HOOKS (TEMPLATE COPYING)
|
||||
# ============================================================================
|
||||
|
||||
def copy_hooks(project_dir: Path, claude_only: bool = False) -> list:
|
||||
"""Copy hook templates from templates/ directory.
|
||||
|
||||
Args:
|
||||
project_dir: Target project directory
|
||||
claude_only: If True, skip provider delegation enforcement hooks
|
||||
"""
|
||||
step = "[4/7]" if claude_only else "[4/8]"
|
||||
print(f"\n{step} Copying hook templates...")
|
||||
|
||||
hooks_dir = project_dir / ".claude" / "hooks"
|
||||
hooks_dir.mkdir(parents=True, exist_ok=True)
|
||||
|
||||
hooks_template_dir = TEMPLATES_DIR / "hooks"
|
||||
copied = []
|
||||
|
||||
# Hooks to skip in claude-only mode (none currently - all hooks apply to both modes)
|
||||
skip_in_claude_only = set()
|
||||
|
||||
for hook_file in hooks_template_dir.glob("*.sh"):
|
||||
# Skip provider enforcement hooks in claude-only mode
|
||||
if claude_only and hook_file.name in skip_in_claude_only:
|
||||
print(f" - Skipped {hook_file.name} (claude-only mode)")
|
||||
continue
|
||||
|
||||
dest = hooks_dir / hook_file.name
|
||||
shutil.copy2(hook_file, dest)
|
||||
dest.chmod(dest.stat().st_mode | stat.S_IEXEC | stat.S_IXGRP | stat.S_IXOTH)
|
||||
copied.append(hook_file.name)
|
||||
print(f" - Copied {hook_file.name}")
|
||||
|
||||
print(f" DONE: {len(copied)} hooks copied")
|
||||
return copied
|
||||
|
||||
|
||||
# ============================================================================
|
||||
# SETTINGS
|
||||
# ============================================================================
|
||||
|
||||
def copy_settings(project_dir: Path, claude_only: bool = False) -> None:
|
||||
"""Copy settings.json template, optionally removing provider enforcement hooks.
|
||||
|
||||
Args:
|
||||
project_dir: Target project directory
|
||||
claude_only: If True, remove provider delegation enforcement from settings
|
||||
"""
|
||||
step = "[5/7]" if claude_only else "[5/8]"
|
||||
print(f"\n{step} Copying settings...")
|
||||
|
||||
settings_template = TEMPLATES_DIR / "settings.json"
|
||||
settings_dest = project_dir / ".claude" / "settings.json"
|
||||
|
||||
# Settings are the same for both modes now (no provider-specific hooks)
|
||||
shutil.copy2(settings_template, settings_dest)
|
||||
if claude_only:
|
||||
print(" - Copied settings.json (claude-only mode)")
|
||||
else:
|
||||
print(" - Copied settings.json")
|
||||
|
||||
print(" DONE: settings configured")
|
||||
|
||||
|
||||
# ============================================================================
|
||||
# CLAUDE.MD
|
||||
# ============================================================================
|
||||
|
||||
def copy_claude_md(project_dir: Path, project_name: str, claude_only: bool = False) -> None:
|
||||
"""Copy CLAUDE.md template with project name replacement."""
|
||||
step = "[6/7]" if claude_only else "[6/8]"
|
||||
print(f"\n{step} Copying CLAUDE.md...")
|
||||
|
||||
claude_template = TEMPLATES_DIR / "CLAUDE.md"
|
||||
claude_dest = project_dir / "CLAUDE.md"
|
||||
|
||||
replacements = {"[Project]": project_name}
|
||||
copy_and_replace(claude_template, claude_dest, replacements)
|
||||
|
||||
print(" - Copied CLAUDE.md")
|
||||
print(" DONE: CLAUDE.md copied")
|
||||
|
||||
|
||||
# ============================================================================
|
||||
# GITIGNORE
|
||||
# ============================================================================
|
||||
|
||||
def setup_gitignore(project_dir: Path, claude_only: bool = False) -> None:
|
||||
"""Ensure .beads is in .gitignore. .claude/ is tracked (not ignored)."""
|
||||
step = "[7/7]" if claude_only else "[7/8]"
|
||||
print(f"\n{step} Setting up .gitignore...")
|
||||
|
||||
gitignore_path = project_dir / ".gitignore"
|
||||
# Only ignore .beads/ (ephemeral task data) and .mcp.json (user-specific paths)
|
||||
# .claude/ is tracked so it survives git operations
|
||||
entries_to_add = [".beads/", ".mcp.json"]
|
||||
|
||||
if gitignore_path.exists():
|
||||
content = gitignore_path.read_text()
|
||||
lines = content.splitlines()
|
||||
|
||||
# Check which entries are missing
|
||||
missing = []
|
||||
for entry in entries_to_add:
|
||||
# Check for exact match or without trailing slash
|
||||
entry_no_slash = entry.rstrip("/")
|
||||
if entry not in lines and entry_no_slash not in lines:
|
||||
missing.append(entry)
|
||||
|
||||
if missing:
|
||||
# Append missing entries
|
||||
with open(gitignore_path, "a") as f:
|
||||
# Add newline if file doesn't end with one
|
||||
if content and not content.endswith("\n"):
|
||||
f.write("\n")
|
||||
f.write("\n# Beads task tracking (ephemeral)\n")
|
||||
for entry in missing:
|
||||
f.write(f"{entry}\n")
|
||||
print(f" - Added {entry} to .gitignore")
|
||||
else:
|
||||
print(" - .beads/ and .mcp.json already in .gitignore")
|
||||
else:
|
||||
# Create new .gitignore
|
||||
content = """# Beads task tracking (ephemeral)
|
||||
.beads/
|
||||
|
||||
# MCP config (user-specific paths)
|
||||
.mcp.json
|
||||
"""
|
||||
gitignore_path.write_text(content)
|
||||
print(" - Created .gitignore with .beads/ and .mcp.json")
|
||||
|
||||
print(" DONE: .gitignore configured")
|
||||
print(" NOTE: .claude/ is tracked (not ignored) to prevent accidental loss")
|
||||
|
||||
|
||||
# ============================================================================
|
||||
# MCP CONFIG
|
||||
# ============================================================================
|
||||
|
||||
def create_mcp_config(project_dir: Path, venv_python: Path) -> None:
|
||||
"""Add provider-delegator to .mcp.json, preserving existing servers."""
|
||||
print("\n[8/8] Configuring MCP...")
|
||||
|
||||
mcp_dest = project_dir / ".mcp.json"
|
||||
|
||||
# Load existing config or start fresh
|
||||
if mcp_dest.exists():
|
||||
try:
|
||||
existing = json.loads(mcp_dest.read_text())
|
||||
print(" - Found existing .mcp.json, merging...")
|
||||
except json.JSONDecodeError:
|
||||
print(" - Warning: Invalid .mcp.json, creating new one")
|
||||
existing = {}
|
||||
else:
|
||||
existing = {}
|
||||
|
||||
# Ensure mcpServers key exists
|
||||
if "mcpServers" not in existing:
|
||||
existing["mcpServers"] = {}
|
||||
|
||||
# Add/update provider_delegator
|
||||
existing["mcpServers"]["provider_delegator"] = {
|
||||
"type": "stdio",
|
||||
"command": str(venv_python),
|
||||
"args": ["-m", "mcp_provider_delegator.server"],
|
||||
"env": {
|
||||
"AGENT_TEMPLATES_PATH": ".claude/agents"
|
||||
}
|
||||
}
|
||||
|
||||
mcp_dest.write_text(json.dumps(existing, indent=2))
|
||||
|
||||
server_count = len(existing["mcpServers"])
|
||||
print(f" - Added provider-delegator to .mcp.json ({server_count} total servers)")
|
||||
print(f" Command: {venv_python}")
|
||||
print(f" Agents: .claude/agents (relative)")
|
||||
print(" DONE: MCP config updated")
|
||||
|
||||
|
||||
# ============================================================================
|
||||
# VERIFICATION
|
||||
# ============================================================================
|
||||
|
||||
def verify_installation(project_dir: Path, claude_only: bool = False) -> bool:
|
||||
"""Verify all components were installed correctly."""
|
||||
checks = {
|
||||
".claude/hooks": "Hooks directory",
|
||||
".claude/agents": "Agents directory",
|
||||
".claude/settings.json": "Settings file",
|
||||
".beads": "Beads directory",
|
||||
"CLAUDE.md": "CLAUDE.md",
|
||||
".gitignore": ".gitignore",
|
||||
}
|
||||
|
||||
# Only check for .mcp.json in external providers mode
|
||||
if not claude_only:
|
||||
checks[".mcp.json"] = "MCP config"
|
||||
|
||||
print("\n=== Verification ===")
|
||||
all_good = True
|
||||
|
||||
for path, description in checks.items():
|
||||
full_path = project_dir / path
|
||||
if full_path.exists():
|
||||
print(f" - {description}")
|
||||
else:
|
||||
print(f" X {description} MISSING")
|
||||
all_good = False
|
||||
|
||||
# Count files
|
||||
hooks_dir = project_dir / ".claude/hooks"
|
||||
if hooks_dir.exists():
|
||||
hook_count = len(list(hooks_dir.glob("*.sh")))
|
||||
print(f" - Hooks: {hook_count}")
|
||||
|
||||
agents_dir = project_dir / ".claude/agents"
|
||||
if agents_dir.exists():
|
||||
agent_count = len(list(agents_dir.glob("*.md")))
|
||||
print(f" - Agents: {agent_count}")
|
||||
|
||||
skills_dir = project_dir / ".claude/skills"
|
||||
if skills_dir.exists():
|
||||
skill_count = len(list(skills_dir.iterdir()))
|
||||
if skill_count > 0:
|
||||
print(f" - Skills: {skill_count}")
|
||||
|
||||
return all_good
|
||||
|
||||
|
||||
# ============================================================================
|
||||
# MAIN
|
||||
# ============================================================================
|
||||
|
||||
def main():
|
||||
import argparse
|
||||
|
||||
parser = argparse.ArgumentParser(description="Bootstrap beads-based orchestration")
|
||||
parser.add_argument("--project-name", default=None, help="Project name (auto-inferred if not provided)")
|
||||
parser.add_argument("--project-dir", default=".", help="Project directory")
|
||||
parser.add_argument("--external-providers", action="store_true",
|
||||
help="Use Codex/Gemini for delegation (default: Claude-only)")
|
||||
parser.add_argument("--with-kanban-ui", action="store_true",
|
||||
help="Use Beads Kanban UI API for worktree creation (with git fallback)")
|
||||
args = parser.parse_args()
|
||||
|
||||
project_dir = Path(args.project_dir).resolve()
|
||||
claude_only = not args.external_providers # Default is now claude-only
|
||||
with_kanban_ui = args.with_kanban_ui
|
||||
|
||||
# Ensure project directory exists
|
||||
project_dir.mkdir(parents=True, exist_ok=True)
|
||||
|
||||
# Auto-infer project name if not provided
|
||||
if args.project_name:
|
||||
project_name = args.project_name
|
||||
else:
|
||||
project_name = infer_project_name(project_dir)
|
||||
print(f"Auto-inferred project name: {project_name}")
|
||||
|
||||
mode_str = "CLAUDE-ONLY" if claude_only else "EXTERNAL PROVIDERS"
|
||||
worktree_str = "API + git fallback" if with_kanban_ui else "git only"
|
||||
print(f"\nBootstrapping beads orchestration for: {project_name}")
|
||||
print(f"Directory: {project_dir}")
|
||||
print(f"Mode: {mode_str}")
|
||||
print(f"Worktrees: {worktree_str}")
|
||||
print("=" * 60)
|
||||
|
||||
# Verify templates exist
|
||||
if not TEMPLATES_DIR.exists():
|
||||
print(f"\nERROR: Templates directory not found: {TEMPLATES_DIR}")
|
||||
print("Make sure you cloned the full lean-orchestration repo")
|
||||
sys.exit(1)
|
||||
|
||||
venv_python = None
|
||||
|
||||
# Step 0: Setup bundled provider-delegator (skip in claude-only mode)
|
||||
if not claude_only:
|
||||
venv_python = setup_provider_delegator()
|
||||
if not venv_python:
|
||||
print("\nERROR: Failed to setup provider-delegator. Aborting.")
|
||||
sys.exit(1)
|
||||
|
||||
# Run remaining steps with provider support
|
||||
if not install_beads(project_dir, claude_only=False):
|
||||
print("\nERROR: Beads CLI is required. Aborting bootstrap.")
|
||||
sys.exit(1)
|
||||
|
||||
# Install frontend review tools (optional, won't block)
|
||||
install_rams()
|
||||
install_web_interface_guidelines()
|
||||
|
||||
copy_agents(project_dir, project_name, claude_only=False, with_kanban_ui=with_kanban_ui)
|
||||
copy_skills(project_dir, claude_only=False)
|
||||
copy_hooks(project_dir, claude_only=False)
|
||||
copy_settings(project_dir, claude_only=False)
|
||||
copy_claude_md(project_dir, project_name, claude_only=False)
|
||||
setup_memory(project_dir)
|
||||
setup_gitignore(project_dir, claude_only=False)
|
||||
create_mcp_config(project_dir, venv_python)
|
||||
else:
|
||||
# Claude-only mode: skip provider setup
|
||||
print("\n[0/7] Skipping provider-delegator setup (claude-only mode)")
|
||||
|
||||
if not install_beads(project_dir, claude_only=True):
|
||||
print("\nERROR: Beads CLI is required. Aborting bootstrap.")
|
||||
sys.exit(1)
|
||||
|
||||
# Install frontend review tools (optional, won't block)
|
||||
install_rams()
|
||||
install_web_interface_guidelines()
|
||||
|
||||
copy_agents(project_dir, project_name, claude_only=True, with_kanban_ui=with_kanban_ui)
|
||||
copy_skills(project_dir, claude_only=True)
|
||||
copy_hooks(project_dir, claude_only=True)
|
||||
copy_settings(project_dir, claude_only=True)
|
||||
copy_claude_md(project_dir, project_name, claude_only=True)
|
||||
setup_memory(project_dir)
|
||||
setup_gitignore(project_dir, claude_only=True)
|
||||
|
||||
# Verify
|
||||
if not verify_installation(project_dir, claude_only):
|
||||
print("\nWARNING: Installation incomplete - check errors above")
|
||||
|
||||
print("\n" + "=" * 60)
|
||||
print("BOOTSTRAP COMPLETE")
|
||||
print("=" * 60)
|
||||
|
||||
if claude_only:
|
||||
print(f"""
|
||||
Mode: CLAUDE-ONLY (all agents use Claude Task)
|
||||
|
||||
Next steps:
|
||||
|
||||
1. Restart Claude Code to load new hooks and agents
|
||||
|
||||
2. **REQUIRED: Run discovery to create supervisors**
|
||||
Discovery will scan your codebase and fetch specialist agents:
|
||||
|
||||
Task(
|
||||
subagent_type="discovery",
|
||||
prompt="Detect tech stack and create supervisors for {project_name}"
|
||||
)
|
||||
|
||||
3. Create your first bead:
|
||||
bd create "First task"
|
||||
|
||||
4. Dispatch work to supervisors:
|
||||
Task(subagent_type="<supervisor-name>", prompt="BEAD_ID: BD-001\\n\\nImplement...")
|
||||
|
||||
NOTE: All agents (scout, detective, architect, etc.) run via Claude Task().
|
||||
No external providers (Codex/Gemini) are configured.
|
||||
""")
|
||||
else:
|
||||
print(f"""
|
||||
Mode: EXTERNAL PROVIDERS (Codex → Gemini → Claude fallback)
|
||||
|
||||
Next steps:
|
||||
|
||||
1. Restart Claude Code to load new hooks and agents
|
||||
|
||||
2. **REQUIRED: Run discovery to create supervisors**
|
||||
Discovery will scan your codebase and fetch specialist agents:
|
||||
|
||||
Task(
|
||||
subagent_type="discovery",
|
||||
prompt="Detect tech stack and create supervisors for {project_name}"
|
||||
)
|
||||
|
||||
This will:
|
||||
- Scan package.json, requirements.txt, Dockerfile, etc.
|
||||
- Fetch matching specialists from external agents directory
|
||||
- Inject beads workflow at the beginning of each agent
|
||||
- Write supervisors to .claude/agents/
|
||||
|
||||
3. Create your first bead:
|
||||
bd create "First task"
|
||||
|
||||
4. Dispatch work to supervisors:
|
||||
Task(subagent_type="<supervisor-name>", prompt="BEAD_ID: BD-001\\n\\nImplement...")
|
||||
|
||||
NOTE: Read-only agents (scout, detective, architect, scribe, code-reviewer)
|
||||
are delegated via provider_delegator MCP (Codex → Gemini fallback).
|
||||
Supervisors are sourced from https://github.com/ayush-that/sub-agents.directory
|
||||
with beads workflow injected.
|
||||
""")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
|
|
@ -0,0 +1,114 @@
|
|||
# Memory Architecture
|
||||
|
||||
## Overview
|
||||
|
||||
Beads orchestration includes a passive knowledge capture system. As agents work, their insights can be voluntarily recorded into a persistent knowledge base that grows across sessions.
|
||||
|
||||
## How It Works
|
||||
|
||||
```
|
||||
Agent runs bd comment BD-001 "LEARNED: ..."
|
||||
|
|
||||
v
|
||||
PostToolUse hook (memory-capture.sh) detects LEARNED: prefix
|
||||
|
|
||||
v
|
||||
Extracts structured entry into .beads/memory/knowledge.jsonl
|
||||
|
|
||||
v
|
||||
Next session: session-start.sh surfaces recent knowledge
|
||||
Agents search when investigating unfamiliar code
|
||||
```
|
||||
|
||||
## Write Path
|
||||
|
||||
Agents write knowledge through the existing `bd comment` interface:
|
||||
|
||||
| Prefix | Who writes | Purpose |
|
||||
|--------|-----------|---------|
|
||||
| `LEARNED:` | Any agent (voluntary) | Conventions, gotchas, patterns discovered during implementation |
|
||||
|
||||
Example:
|
||||
```bash
|
||||
bd comment BD-001 "LEARNED: TaskGroup requires @Sendable closures in strict concurrency mode."
|
||||
```
|
||||
|
||||
An async `PostToolUse` hook on the Bash tool intercepts these commands and extracts a structured JSONL entry. No changes to the beads CLI are required.
|
||||
|
||||
## Storage Format
|
||||
|
||||
`.beads/memory/knowledge.jsonl` -- one JSON object per line:
|
||||
|
||||
```json
|
||||
{"key":"learned-taskgroup-requires-sendable-closures","type":"learned","content":"TaskGroup requires @Sendable closures in strict concurrency mode.","source":"supervisor","tags":["learned","async","concurrency"],"ts":1706360000,"bead":"BD-001"}
|
||||
```
|
||||
|
||||
| Field | Description |
|
||||
|-------|-------------|
|
||||
| `key` | Auto-generated slug from type + first 60 chars of content |
|
||||
| `type` | `learned` |
|
||||
| `content` | The raw insight text |
|
||||
| `source` | `orchestrator` or `supervisor` (detected from CWD) |
|
||||
| `tags` | Auto-detected from content via keyword scan |
|
||||
| `ts` | Unix timestamp |
|
||||
| `bead` | The bead ID that produced this knowledge |
|
||||
|
||||
Same key = latest entry wins (deduplication on read).
|
||||
|
||||
## Read Path
|
||||
|
||||
### Automatic (session start)
|
||||
|
||||
`session-start.sh` displays the 5 most recent deduplicated entries when a new session begins:
|
||||
|
||||
```
|
||||
## Recent Knowledge (12 entries)
|
||||
|
||||
[LEARN] MenuBarExtra popup closes on NSWindow activate. Use activates:false. (supervisor)
|
||||
|
||||
Search: .beads/memory/recall.sh "keyword"
|
||||
```
|
||||
|
||||
### On-demand (recall script)
|
||||
|
||||
```bash
|
||||
.beads/memory/recall.sh "keyword" # Search by keyword
|
||||
.beads/memory/recall.sh "keyword" --type learned # Filter by type
|
||||
.beads/memory/recall.sh --recent 10 # Show latest entries
|
||||
.beads/memory/recall.sh --stats # Entry counts
|
||||
.beads/memory/recall.sh "keyword" --all # Include archived entries
|
||||
```
|
||||
|
||||
## Voluntary Contribution
|
||||
|
||||
Knowledge capture is opt-in. Agents are encouraged to log insights when they discover something worth remembering, but it is not enforced. The `SubagentStop` hook verifies worktree state, push status, and bead status — not knowledge contributions.
|
||||
|
||||
Exempt: `worker-supervisor` (low-level tasks that don't produce architectural insight).
|
||||
|
||||
## Rotation
|
||||
|
||||
When `knowledge.jsonl` exceeds 1,000 lines, the oldest 500 are moved to `knowledge.archive.jsonl`. The archive is searchable via `recall.sh --all`.
|
||||
|
||||
## File Layout
|
||||
|
||||
```
|
||||
.beads/
|
||||
memory/
|
||||
knowledge.jsonl # Active knowledge store
|
||||
knowledge.archive.jsonl # Rotated older entries
|
||||
recall.sh # On-demand search script
|
||||
.claude/
|
||||
hooks/
|
||||
memory-capture.sh # PostToolUse async hook (captures entries)
|
||||
validate-completion.sh # SubagentStop hook (verifies work completion)
|
||||
log-dispatch-prompt.sh # PostToolUse async hook (logs dispatch prompts)
|
||||
session-start.sh # SessionStart hook (surfaces knowledge)
|
||||
```
|
||||
|
||||
## Design Decisions
|
||||
|
||||
- **JSONL over SQLite**: Simpler, append-only, human-readable, git-trackable
|
||||
- **grep + jq over embeddings**: Sufficient for project-scoped knowledge; no external dependencies
|
||||
- **Passive capture via hooks**: Zero friction -- agents use `bd comment` as they already do
|
||||
- **Voluntary contribution**: Knowledge base grows organically from genuine insights, not forced boilerplate
|
||||
- **Same key = latest wins**: No explicit update/close lifecycle; knowledge self-corrects over time
|
||||
|
|
@ -0,0 +1,7 @@
|
|||
<claude-mem-context>
|
||||
# Recent Activity
|
||||
|
||||
<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
|
||||
|
||||
*No recent activity*
|
||||
</claude-mem-context>
|
||||
|
|
@ -0,0 +1,25 @@
|
|||
[build-system]
|
||||
requires = ["hatchling"]
|
||||
build-backend = "hatchling.build"
|
||||
|
||||
[project]
|
||||
name = "mcp-provider-delegator"
|
||||
version = "0.1.0"
|
||||
description = "MCP server for delegating agents to AI providers (Codex, Gemini) with fallback support"
|
||||
requires-python = ">=3.11"
|
||||
dependencies = [
|
||||
"mcp>=1.0.0",
|
||||
"pyyaml>=6.0.1",
|
||||
]
|
||||
|
||||
[project.scripts]
|
||||
mcp-provider-delegator = "mcp_provider_delegator.server:run"
|
||||
|
||||
[project.optional-dependencies]
|
||||
dev = [
|
||||
"pytest>=8.0.0",
|
||||
"pytest-asyncio>=0.23.0",
|
||||
]
|
||||
|
||||
[tool.hatch.build.targets.wheel]
|
||||
packages = ["src/mcp_provider_delegator"]
|
||||
|
|
@ -0,0 +1,7 @@
|
|||
<claude-mem-context>
|
||||
# Recent Activity
|
||||
|
||||
<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
|
||||
|
||||
*No recent activity*
|
||||
</claude-mem-context>
|
||||
|
|
@ -0,0 +1,79 @@
|
|||
"""Agent template loader for reading .md files."""
|
||||
|
||||
import os
|
||||
import re
|
||||
from dataclasses import dataclass
|
||||
from pathlib import Path
|
||||
from typing import Optional
|
||||
|
||||
import yaml
|
||||
|
||||
|
||||
@dataclass
|
||||
class AgentTemplate:
|
||||
"""Represents a loaded agent template."""
|
||||
name: str
|
||||
model: str
|
||||
description: str
|
||||
tools: list[str]
|
||||
system_prompt: str
|
||||
skills: Optional[list[str]] = None
|
||||
|
||||
|
||||
class AgentLoader:
|
||||
"""Loads agent templates from .md files."""
|
||||
|
||||
def __init__(self, templates_path: str):
|
||||
"""
|
||||
Initialize loader.
|
||||
|
||||
Args:
|
||||
templates_path: Path to directory containing agent .md files
|
||||
"""
|
||||
self.templates_path = Path(templates_path)
|
||||
if not self.templates_path.exists():
|
||||
raise FileNotFoundError(f"Templates path not found: {templates_path}")
|
||||
|
||||
def load_agent(self, agent_name: str) -> AgentTemplate:
|
||||
"""
|
||||
Load agent template from .md file.
|
||||
|
||||
Args:
|
||||
agent_name: Name of agent (e.g., "scout", "detective")
|
||||
|
||||
Returns:
|
||||
AgentTemplate with parsed frontmatter and system prompt
|
||||
|
||||
Raises:
|
||||
FileNotFoundError: If agent .md file doesn't exist
|
||||
ValueError: If frontmatter is invalid
|
||||
"""
|
||||
agent_file = self.templates_path / f"{agent_name}.md"
|
||||
|
||||
if not agent_file.exists():
|
||||
raise FileNotFoundError(f"Agent template not found: {agent_file}")
|
||||
|
||||
content = agent_file.read_text()
|
||||
|
||||
# Parse frontmatter (YAML between --- markers)
|
||||
frontmatter_match = re.match(r'^---\n(.*?)\n---\n(.*)$', content, re.DOTALL)
|
||||
|
||||
if not frontmatter_match:
|
||||
raise ValueError(f"Invalid agent template (missing frontmatter): {agent_file}")
|
||||
|
||||
frontmatter_yaml = frontmatter_match.group(1)
|
||||
system_prompt = frontmatter_match.group(2).strip()
|
||||
|
||||
try:
|
||||
frontmatter = yaml.safe_load(frontmatter_yaml)
|
||||
except yaml.YAMLError as e:
|
||||
raise ValueError(f"Invalid YAML frontmatter in {agent_file}: {e}")
|
||||
|
||||
return AgentTemplate(
|
||||
name=frontmatter["name"],
|
||||
model=frontmatter["model"],
|
||||
description=frontmatter["description"],
|
||||
tools=frontmatter.get("tools", []),
|
||||
skills=frontmatter.get("skills"),
|
||||
system_prompt=system_prompt,
|
||||
)
|
||||
|
|
@ -0,0 +1,322 @@
|
|||
"""Provider clients for invoking agents via Codex, Gemini, etc."""
|
||||
|
||||
import asyncio
|
||||
import logging
|
||||
import os
|
||||
from abc import ABC, abstractmethod
|
||||
from dataclasses import dataclass
|
||||
from typing import Optional
|
||||
|
||||
logger = logging.getLogger(__name__)
|
||||
|
||||
|
||||
class RateLimitError(Exception):
|
||||
"""Raised when a provider hits rate limits."""
|
||||
pass
|
||||
|
||||
|
||||
@dataclass
|
||||
class FallbackHint:
|
||||
"""Hint for falling back to Claude Task tool."""
|
||||
subagent_type: str
|
||||
model: str
|
||||
prompt: str
|
||||
|
||||
def to_string(self) -> str:
|
||||
"""Generate Task() call suggestion."""
|
||||
# Escape the prompt for display
|
||||
# Include PROVIDER_FALLBACK marker so hooks allow bypass
|
||||
escaped_prompt = self.prompt.replace('"', '\\"')[:500]
|
||||
if len(self.prompt) > 500:
|
||||
escaped_prompt += "..."
|
||||
return f'''Task(
|
||||
subagent_type="{self.subagent_type}",
|
||||
model="{self.model}",
|
||||
prompt="PROVIDER_FALLBACK: {escaped_prompt}"
|
||||
)'''
|
||||
|
||||
|
||||
@dataclass
|
||||
class InvokeResult:
|
||||
"""Result of a provider invocation."""
|
||||
success: bool
|
||||
response: str
|
||||
provider: str
|
||||
error: Optional[str] = None
|
||||
fallback_hint: Optional[FallbackHint] = None
|
||||
|
||||
|
||||
class ProviderClient(ABC):
|
||||
"""Abstract base class for AI provider clients."""
|
||||
|
||||
name: str = "base"
|
||||
|
||||
@abstractmethod
|
||||
async def invoke(self, prompt: str) -> str:
|
||||
"""Invoke the provider with a prompt."""
|
||||
pass
|
||||
|
||||
def is_rate_limit_error(self, error_msg: str) -> bool:
|
||||
"""Check if error message indicates rate limiting."""
|
||||
rate_limit_indicators = [
|
||||
"rate limit",
|
||||
"429",
|
||||
"too many requests",
|
||||
"usage limit",
|
||||
"quota exceeded",
|
||||
]
|
||||
error_lower = error_msg.lower()
|
||||
return any(indicator in error_lower for indicator in rate_limit_indicators)
|
||||
|
||||
|
||||
class CodexClient(ProviderClient):
|
||||
"""Client for OpenAI Codex."""
|
||||
|
||||
name = "codex"
|
||||
|
||||
# Map agent model preferences to Codex models
|
||||
MODEL_MAPPING = {
|
||||
"haiku": "gpt-5.1-codex-mini",
|
||||
"sonnet": "gpt-5.2-codex",
|
||||
"opus": "gpt-5.1-codex-max",
|
||||
}
|
||||
|
||||
def __init__(self, model: str = "gpt-5.2-codex"):
|
||||
self.model = model
|
||||
|
||||
@classmethod
|
||||
def map_model(cls, agent_model: str) -> str:
|
||||
"""Map agent's preferred model to Codex model."""
|
||||
return cls.MODEL_MAPPING.get(agent_model, "gpt-5.2-codex")
|
||||
|
||||
async def invoke(self, prompt: str) -> str:
|
||||
"""Invoke Codex with prompt."""
|
||||
cmd = [
|
||||
"codex",
|
||||
"exec",
|
||||
"-m", self.model,
|
||||
"--sandbox", "workspace-write",
|
||||
prompt,
|
||||
]
|
||||
|
||||
logger.info(f"[Codex] Invoking with model: {self.model}")
|
||||
|
||||
try:
|
||||
cwd = os.getcwd()
|
||||
env = os.environ.copy()
|
||||
|
||||
process = await asyncio.create_subprocess_exec(
|
||||
*cmd,
|
||||
stdout=asyncio.subprocess.PIPE,
|
||||
stderr=asyncio.subprocess.PIPE,
|
||||
env=env,
|
||||
cwd=cwd,
|
||||
)
|
||||
|
||||
stdout, stderr = await process.communicate()
|
||||
|
||||
if process.returncode != 0:
|
||||
error_msg = stderr.decode() if stderr else "Unknown error"
|
||||
if self.is_rate_limit_error(error_msg):
|
||||
raise RateLimitError(f"Codex rate limit: {error_msg}")
|
||||
raise RuntimeError(f"Codex failed: {error_msg}")
|
||||
|
||||
response = stdout.decode().strip()
|
||||
logger.info(f"[Codex] Response length: {len(response)} chars")
|
||||
return response
|
||||
|
||||
except FileNotFoundError:
|
||||
raise RuntimeError("Codex CLI not found. Install with: codex login")
|
||||
|
||||
|
||||
class GeminiClient(ProviderClient):
|
||||
"""Client for Google Gemini."""
|
||||
|
||||
name = "gemini"
|
||||
model = "gemini-3-flash-preview"
|
||||
|
||||
async def invoke(self, prompt: str) -> str:
|
||||
"""Invoke Gemini with prompt."""
|
||||
cmd = [
|
||||
"gemini",
|
||||
"-p", prompt,
|
||||
"-m", self.model,
|
||||
"-y", # Auto-approve tool calls for agentic execution
|
||||
]
|
||||
|
||||
logger.info(f"[Gemini] Invoking with model: {self.model}")
|
||||
|
||||
try:
|
||||
cwd = os.getcwd()
|
||||
env = os.environ.copy()
|
||||
|
||||
process = await asyncio.create_subprocess_exec(
|
||||
*cmd,
|
||||
stdout=asyncio.subprocess.PIPE,
|
||||
stderr=asyncio.subprocess.PIPE,
|
||||
env=env,
|
||||
cwd=cwd,
|
||||
)
|
||||
|
||||
stdout, stderr = await process.communicate()
|
||||
|
||||
if process.returncode != 0:
|
||||
error_msg = stderr.decode() if stderr else "Unknown error"
|
||||
if self.is_rate_limit_error(error_msg):
|
||||
raise RateLimitError(f"Gemini rate limit: {error_msg}")
|
||||
raise RuntimeError(f"Gemini failed: {error_msg}")
|
||||
|
||||
response = stdout.decode().strip()
|
||||
logger.info(f"[Gemini] Response length: {len(response)} chars")
|
||||
return response
|
||||
|
||||
except FileNotFoundError:
|
||||
raise RuntimeError("Gemini CLI not found. Install with: pip install gemini-cli")
|
||||
|
||||
|
||||
# Map agent names to Claude Task subagent_types for fallback
|
||||
# These match the subagent_type values available in Claude Code's Task tool
|
||||
AGENT_TO_SUBAGENT = {
|
||||
"scout": "scout",
|
||||
"detective": "scout", # detective uses scout for investigation
|
||||
"architect": "Plan",
|
||||
"scribe": "scout", # scribe reads codebase to document
|
||||
"code-reviewer": "superpowers:code-reviewer",
|
||||
}
|
||||
|
||||
# Map agent model preferences to Claude Task models
|
||||
AGENT_MODEL_TO_TASK_MODEL = {
|
||||
"haiku": "haiku",
|
||||
"sonnet": "sonnet",
|
||||
"opus": "opus",
|
||||
}
|
||||
|
||||
|
||||
class ProviderChain:
|
||||
"""Chain of providers with fallback support."""
|
||||
|
||||
def __init__(
|
||||
self,
|
||||
providers: list[ProviderClient],
|
||||
allow_skip: bool = False,
|
||||
agent_name: str = "",
|
||||
agent_model: str = "sonnet",
|
||||
):
|
||||
"""
|
||||
Initialize provider chain.
|
||||
|
||||
Args:
|
||||
providers: List of providers to try in order
|
||||
allow_skip: If True, return skip message when all providers fail
|
||||
agent_name: Name of the agent (for fallback hints)
|
||||
agent_model: Agent's preferred model (for fallback hints)
|
||||
"""
|
||||
self.providers = providers
|
||||
self.allow_skip = allow_skip
|
||||
self.agent_name = agent_name
|
||||
self.agent_model = agent_model
|
||||
|
||||
def _create_fallback_hint(self, user_prompt: str) -> FallbackHint:
|
||||
"""Create a fallback hint for Claude Task tool."""
|
||||
subagent_type = AGENT_TO_SUBAGENT.get(self.agent_name, "general-purpose")
|
||||
task_model = AGENT_MODEL_TO_TASK_MODEL.get(self.agent_model, "sonnet")
|
||||
return FallbackHint(
|
||||
subagent_type=subagent_type,
|
||||
model=task_model,
|
||||
prompt=user_prompt,
|
||||
)
|
||||
|
||||
async def invoke(
|
||||
self,
|
||||
system_prompt: str,
|
||||
user_prompt: str,
|
||||
task_id: Optional[str] = None,
|
||||
) -> InvokeResult:
|
||||
"""
|
||||
Invoke providers in chain until one succeeds.
|
||||
|
||||
Returns:
|
||||
InvokeResult with success status, response, and provider used
|
||||
"""
|
||||
combined_prompt = f"{system_prompt}\n\n---\n\n{user_prompt}"
|
||||
if task_id:
|
||||
combined_prompt = f"TASK_ID: {task_id}\n\n{combined_prompt}"
|
||||
|
||||
errors = []
|
||||
|
||||
for provider in self.providers:
|
||||
try:
|
||||
logger.info(f"Trying provider: {provider.name}")
|
||||
response = await provider.invoke(combined_prompt)
|
||||
return InvokeResult(
|
||||
success=True,
|
||||
response=response,
|
||||
provider=provider.name,
|
||||
)
|
||||
except RateLimitError as e:
|
||||
logger.warning(f"{provider.name} rate limited: {e}")
|
||||
errors.append(f"{provider.name}: rate limited")
|
||||
continue
|
||||
except RuntimeError as e:
|
||||
logger.error(f"{provider.name} failed: {e}")
|
||||
errors.append(f"{provider.name}: {e}")
|
||||
continue
|
||||
|
||||
# All providers failed
|
||||
if self.allow_skip:
|
||||
return InvokeResult(
|
||||
success=True, # Skip is a valid outcome
|
||||
response="SKIPPED: All providers rate limited. Task skipped.",
|
||||
provider="skip",
|
||||
error="; ".join(errors),
|
||||
)
|
||||
|
||||
# Create fallback hint for non-skippable agents
|
||||
fallback_hint = self._create_fallback_hint(user_prompt)
|
||||
fallback_response = f"""PROVIDER_FALLBACK_REQUIRED
|
||||
|
||||
All external providers (Codex, Gemini) failed for agent '{self.agent_name}'.
|
||||
Errors: {'; '.join(errors)}
|
||||
|
||||
To complete this task, use Claude Task tool instead:
|
||||
|
||||
{fallback_hint.to_string()}
|
||||
|
||||
Note: The Task tool runs locally and doesn't have the same rate limits."""
|
||||
|
||||
return InvokeResult(
|
||||
success=False,
|
||||
response=fallback_response,
|
||||
provider="none",
|
||||
error=f"All providers failed: {'; '.join(errors)}",
|
||||
fallback_hint=fallback_hint,
|
||||
)
|
||||
|
||||
|
||||
def create_provider_chain(agent_model: str, agent_name: str) -> ProviderChain:
|
||||
"""
|
||||
Create a provider chain for an agent.
|
||||
|
||||
Args:
|
||||
agent_model: Agent's preferred model (haiku, sonnet, opus)
|
||||
agent_name: Name of the agent (for skip logic and fallback hints)
|
||||
|
||||
Returns:
|
||||
ProviderChain configured for the agent
|
||||
"""
|
||||
codex_model = CodexClient.map_model(agent_model)
|
||||
|
||||
providers = [
|
||||
CodexClient(model=codex_model),
|
||||
GeminiClient(),
|
||||
]
|
||||
|
||||
# Code reviewer can be skipped if all providers fail
|
||||
allow_skip = agent_name == "code-reviewer"
|
||||
|
||||
return ProviderChain(
|
||||
providers=providers,
|
||||
allow_skip=allow_skip,
|
||||
agent_name=agent_name,
|
||||
agent_model=agent_model,
|
||||
)
|
||||
|
|
@ -0,0 +1,133 @@
|
|||
"""MCP server for delegating agents to AI providers with fallback support."""
|
||||
|
||||
import asyncio
|
||||
import logging
|
||||
import os
|
||||
from typing import Any
|
||||
|
||||
from mcp.server import Server
|
||||
from mcp.server.stdio import stdio_server
|
||||
from mcp.types import Tool, TextContent
|
||||
|
||||
from .agent_loader import AgentLoader
|
||||
from .provider_client import create_provider_chain
|
||||
|
||||
logging.basicConfig(level=logging.INFO)
|
||||
logger = logging.getLogger(__name__)
|
||||
|
||||
# Initialize components
|
||||
# AGENT_TEMPLATES_PATH should be set via .mcp.json env config
|
||||
AGENT_TEMPLATES_PATH = os.getenv("AGENT_TEMPLATES_PATH", ".claude/agents")
|
||||
|
||||
agent_loader = AgentLoader(templates_path=AGENT_TEMPLATES_PATH)
|
||||
|
||||
# Initialize MCP server
|
||||
app = Server("provider-delegator")
|
||||
|
||||
@app.list_tools()
|
||||
async def list_tools() -> list[Tool]:
|
||||
"""List available tools."""
|
||||
return [
|
||||
Tool(
|
||||
name="invoke_agent",
|
||||
description=(
|
||||
"Delegate a task to a specialized agent. "
|
||||
"Tries Codex first, falls back to Gemini if rate limited. "
|
||||
"Available agents: scout, detective, architect, scribe, code-reviewer. "
|
||||
"Agents have full MCP tool access (context7, vibe_kanban, playwright, github)."
|
||||
),
|
||||
inputSchema={
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"agent": {
|
||||
"type": "string",
|
||||
"enum": ["scout", "detective", "architect", "scribe", "code-reviewer"],
|
||||
"description": "Which agent to invoke",
|
||||
},
|
||||
"task_prompt": {
|
||||
"type": "string",
|
||||
"description": "The task prompt/instructions for the agent",
|
||||
},
|
||||
"task_id": {
|
||||
"type": "string",
|
||||
"description": "Optional Kanban task ID (e.g., RCH-123) for tracking",
|
||||
},
|
||||
},
|
||||
"required": ["agent", "task_prompt"],
|
||||
},
|
||||
)
|
||||
]
|
||||
|
||||
@app.call_tool()
|
||||
async def call_tool(name: str, arguments: Any) -> list[TextContent]:
|
||||
"""Handle tool calls."""
|
||||
if name != "invoke_agent":
|
||||
raise ValueError(f"Unknown tool: {name}")
|
||||
|
||||
agent_name = arguments["agent"]
|
||||
task_prompt = arguments["task_prompt"]
|
||||
task_id = arguments.get("task_id")
|
||||
|
||||
logger.info(f"Invoking agent: {agent_name} (task_id: {task_id})")
|
||||
|
||||
try:
|
||||
# Load agent template
|
||||
template = agent_loader.load_agent(agent_name)
|
||||
logger.info(f"Loaded template for {agent_name} (model: {template.model})")
|
||||
|
||||
# Create provider chain with fallback support
|
||||
chain = create_provider_chain(
|
||||
agent_model=template.model,
|
||||
agent_name=agent_name,
|
||||
)
|
||||
|
||||
# Invoke with fallback chain: Codex -> Gemini -> Skip (for code-reviewer)
|
||||
result = await chain.invoke(
|
||||
system_prompt=template.system_prompt,
|
||||
user_prompt=task_prompt,
|
||||
task_id=task_id,
|
||||
)
|
||||
|
||||
if result.success:
|
||||
logger.info(f"Agent {agent_name} completed via {result.provider}")
|
||||
return [TextContent(
|
||||
type="text",
|
||||
text=result.response
|
||||
)]
|
||||
else:
|
||||
# Return fallback hint response (includes Task() suggestion)
|
||||
logger.warning(f"Agent {agent_name} failed, returning fallback hint")
|
||||
return [TextContent(
|
||||
type="text",
|
||||
text=result.response # Contains PROVIDER_FALLBACK_REQUIRED with Task() hint
|
||||
)]
|
||||
|
||||
except FileNotFoundError as e:
|
||||
error_msg = f"Agent template not found: {agent_name}. Error: {e}"
|
||||
logger.error(error_msg)
|
||||
return [TextContent(type="text", text=f"ERROR: {error_msg}")]
|
||||
|
||||
except Exception as e:
|
||||
error_msg = f"Unexpected error invoking {agent_name}: {e}"
|
||||
logger.exception(error_msg)
|
||||
return [TextContent(type="text", text=f"ERROR: {error_msg}")]
|
||||
|
||||
async def main():
|
||||
"""Run the MCP server."""
|
||||
logger.info("Starting MCP Provider Delegator")
|
||||
logger.info(f"Agent templates path: {AGENT_TEMPLATES_PATH}")
|
||||
logger.info("Fallback chain: Codex -> Gemini -> Skip (code-reviewer only)")
|
||||
|
||||
async with stdio_server() as (read_stream, write_stream):
|
||||
await app.run(
|
||||
read_stream,
|
||||
write_stream,
|
||||
app.create_initialization_options()
|
||||
)
|
||||
|
||||
def run():
|
||||
"""Entry point for CLI."""
|
||||
asyncio.run(main())
|
||||
|
||||
if __name__ == "__main__":
|
||||
run()
|
||||
|
|
@ -0,0 +1,7 @@
|
|||
<claude-mem-context>
|
||||
# Recent Activity
|
||||
|
||||
<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
|
||||
|
||||
*No recent activity*
|
||||
</claude-mem-context>
|
||||
7
.agents/skills/create-beads-orchestration/mcp-provider-delegator/tests/fixtures/CLAUDE.md
vendored
Normal file
7
.agents/skills/create-beads-orchestration/mcp-provider-delegator/tests/fixtures/CLAUDE.md
vendored
Normal file
|
|
@ -0,0 +1,7 @@
|
|||
<claude-mem-context>
|
||||
# Recent Activity
|
||||
|
||||
<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
|
||||
|
||||
*No recent activity*
|
||||
</claude-mem-context>
|
||||
16
.agents/skills/create-beads-orchestration/mcp-provider-delegator/tests/fixtures/scout.md
vendored
Normal file
16
.agents/skills/create-beads-orchestration/mcp-provider-delegator/tests/fixtures/scout.md
vendored
Normal file
|
|
@ -0,0 +1,16 @@
|
|||
---
|
||||
name: scout
|
||||
description: Scout agent for codebase exploration
|
||||
model: haiku
|
||||
tools:
|
||||
- Read
|
||||
- Glob
|
||||
- Grep
|
||||
---
|
||||
|
||||
# Scout: "Ivy"
|
||||
|
||||
You are **Ivy**, the Scout.
|
||||
|
||||
## Your Purpose
|
||||
Explore the codebase to find files and structure.
|
||||
|
|
@ -0,0 +1,26 @@
|
|||
"""Tests for agent template loader."""
|
||||
|
||||
import os
|
||||
import pytest
|
||||
from pathlib import Path
|
||||
from mcp_provider_delegator.agent_loader import AgentLoader, AgentTemplate
|
||||
|
||||
FIXTURES_DIR = Path(__file__).parent / "fixtures"
|
||||
|
||||
def test_load_agent_template():
|
||||
"""Test loading agent template from .md file."""
|
||||
loader = AgentLoader(templates_path=str(FIXTURES_DIR))
|
||||
template = loader.load_agent("scout")
|
||||
|
||||
assert template.name == "scout"
|
||||
assert template.model == "haiku"
|
||||
assert template.description == "Scout agent for codebase exploration"
|
||||
assert "Read" in template.tools
|
||||
assert "Ivy" in template.system_prompt
|
||||
assert "Your Purpose" in template.system_prompt
|
||||
|
||||
def test_load_nonexistent_agent():
|
||||
"""Test loading non-existent agent raises error."""
|
||||
loader = AgentLoader(templates_path=str(FIXTURES_DIR))
|
||||
with pytest.raises(FileNotFoundError):
|
||||
loader.load_agent("nonexistent")
|
||||
|
|
@ -0,0 +1,38 @@
|
|||
"""Integration tests for full agent delegation flow."""
|
||||
|
||||
import pytest
|
||||
from mcp_provider_delegator.server import app
|
||||
|
||||
@pytest.mark.integration
|
||||
@pytest.mark.asyncio
|
||||
async def test_invoke_scout_end_to_end():
|
||||
"""Test full scout agent invocation. Requires Codex CLI and agent templates."""
|
||||
result = await app.call_tool(
|
||||
"invoke_agent",
|
||||
{
|
||||
"agent": "scout",
|
||||
"task_prompt": "Find all Python files in the src/ directory",
|
||||
}
|
||||
)
|
||||
|
||||
assert len(result) == 1
|
||||
# Scout should report findings or indicate agent was invoked
|
||||
assert result[0].text
|
||||
assert not result[0].text.startswith("ERROR")
|
||||
|
||||
@pytest.mark.integration
|
||||
@pytest.mark.asyncio
|
||||
async def test_invoke_detective_with_task_id():
|
||||
"""Test detective agent with Kanban task tracking."""
|
||||
result = await app.call_tool(
|
||||
"invoke_agent",
|
||||
{
|
||||
"agent": "detective",
|
||||
"task_prompt": "Investigate why tests are failing",
|
||||
"task_id": "RCH-999",
|
||||
}
|
||||
)
|
||||
|
||||
assert len(result) == 1
|
||||
assert result[0].text
|
||||
assert not result[0].text.startswith("ERROR")
|
||||
|
|
@ -0,0 +1,58 @@
|
|||
"""Tests for Provider API clients."""
|
||||
|
||||
import pytest
|
||||
from mcp_provider_delegator.provider_client import (
|
||||
CodexClient,
|
||||
GeminiClient,
|
||||
ProviderChain,
|
||||
RateLimitError,
|
||||
create_provider_chain,
|
||||
)
|
||||
|
||||
|
||||
def test_codex_model_mapping():
|
||||
"""Test model mapping from agent models to Codex models."""
|
||||
assert CodexClient.map_model("haiku") == "gpt-5.1-codex-mini"
|
||||
assert CodexClient.map_model("sonnet") == "gpt-5.2-codex"
|
||||
assert CodexClient.map_model("opus") == "gpt-5.1-codex-max"
|
||||
assert CodexClient.map_model("unknown") == "gpt-5.2-codex"
|
||||
|
||||
|
||||
def test_create_provider_chain_code_reviewer():
|
||||
"""Test that code-reviewer allows skip on failure."""
|
||||
chain = create_provider_chain("haiku", "code-reviewer")
|
||||
assert chain.allow_skip is True
|
||||
assert len(chain.providers) == 2 # Codex + Gemini
|
||||
|
||||
|
||||
def test_create_provider_chain_other_agents():
|
||||
"""Test that other agents don't allow skip."""
|
||||
chain = create_provider_chain("opus", "detective")
|
||||
assert chain.allow_skip is False
|
||||
assert len(chain.providers) == 2
|
||||
|
||||
|
||||
@pytest.mark.integration
|
||||
@pytest.mark.asyncio
|
||||
async def test_invoke_codex_simple():
|
||||
"""Test invoking Codex with simple prompt. Requires Codex CLI."""
|
||||
client = CodexClient(model="gpt-5.2-codex")
|
||||
|
||||
result = await client.invoke(
|
||||
prompt="You are a helpful assistant. Say hello."
|
||||
)
|
||||
|
||||
assert "hello" in result.lower()
|
||||
|
||||
|
||||
@pytest.mark.integration
|
||||
@pytest.mark.asyncio
|
||||
async def test_invoke_gemini_simple():
|
||||
"""Test invoking Gemini with simple prompt. Requires Gemini CLI."""
|
||||
client = GeminiClient()
|
||||
|
||||
result = await client.invoke(
|
||||
prompt="You are a helpful assistant. Say hello."
|
||||
)
|
||||
|
||||
assert "hello" in result.lower()
|
||||
|
|
@ -0,0 +1,28 @@
|
|||
"""Tests for MCP server."""
|
||||
|
||||
import pytest
|
||||
from mcp_provider_delegator import server
|
||||
|
||||
@pytest.mark.asyncio
|
||||
async def test_list_tools():
|
||||
"""Test that invoke_agent tool is registered."""
|
||||
tools = await server.list_tools()
|
||||
assert len(tools) == 1
|
||||
assert tools[0].name == "invoke_agent"
|
||||
assert "scout" in str(tools[0].inputSchema)
|
||||
|
||||
@pytest.mark.asyncio
|
||||
async def test_invoke_agent_error_handling():
|
||||
"""Test invoke_agent handles errors gracefully (providers not available in test env)."""
|
||||
result = await server.call_tool(
|
||||
"invoke_agent",
|
||||
{
|
||||
"agent": "scout",
|
||||
"task_prompt": "Find authentication files"
|
||||
}
|
||||
)
|
||||
assert len(result) == 1
|
||||
# In test environment without providers, should get error response
|
||||
assert result[0].text
|
||||
# Either succeeds (if providers configured) or returns error
|
||||
assert isinstance(result[0].text, str)
|
||||
815
.agents/skills/create-beads-orchestration/mcp-provider-delegator/uv.lock
generated
Normal file
815
.agents/skills/create-beads-orchestration/mcp-provider-delegator/uv.lock
generated
Normal file
|
|
@ -0,0 +1,815 @@
|
|||
version = 1
|
||||
revision = 3
|
||||
requires-python = ">=3.11"
|
||||
|
||||
[[package]]
|
||||
name = "annotated-types"
|
||||
version = "0.7.0"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/ee/67/531ea369ba64dcff5ec9c3402f9f51bf748cec26dde048a2f973a4eea7f5/annotated_types-0.7.0.tar.gz", hash = "sha256:aff07c09a53a08bc8cfccb9c85b05f1aa9a2a6f23728d790723543408344ce89", size = 16081, upload-time = "2024-05-20T21:33:25.928Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/78/b6/6307fbef88d9b5ee7421e68d78a9f162e0da4900bc5f5793f6d3d0e34fb8/annotated_types-0.7.0-py3-none-any.whl", hash = "sha256:1f02e8b43a8fbbc3f3e0d4f0f4bfc8131bcb4eebe8849b8e5c773f3a1c582a53", size = 13643, upload-time = "2024-05-20T21:33:24.1Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "anyio"
|
||||
version = "4.12.1"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
dependencies = [
|
||||
{ name = "idna" },
|
||||
{ name = "typing-extensions", marker = "python_full_version < '3.13'" },
|
||||
]
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/96/f0/5eb65b2bb0d09ac6776f2eb54adee6abe8228ea05b20a5ad0e4945de8aac/anyio-4.12.1.tar.gz", hash = "sha256:41cfcc3a4c85d3f05c932da7c26d0201ac36f72abd4435ba90d0464a3ffed703", size = 228685, upload-time = "2026-01-06T11:45:21.246Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/38/0e/27be9fdef66e72d64c0cdc3cc2823101b80585f8119b5c112c2e8f5f7dab/anyio-4.12.1-py3-none-any.whl", hash = "sha256:d405828884fc140aa80a3c667b8beed277f1dfedec42ba031bd6ac3db606ab6c", size = 113592, upload-time = "2026-01-06T11:45:19.497Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "attrs"
|
||||
version = "25.4.0"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/6b/5c/685e6633917e101e5dcb62b9dd76946cbb57c26e133bae9e0cd36033c0a9/attrs-25.4.0.tar.gz", hash = "sha256:16d5969b87f0859ef33a48b35d55ac1be6e42ae49d5e853b597db70c35c57e11", size = 934251, upload-time = "2025-10-06T13:54:44.725Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/3a/2a/7cc015f5b9f5db42b7d48157e23356022889fc354a2813c15934b7cb5c0e/attrs-25.4.0-py3-none-any.whl", hash = "sha256:adcf7e2a1fb3b36ac48d97835bb6d8ade15b8dcce26aba8bf1d14847b57a3373", size = 67615, upload-time = "2025-10-06T13:54:43.17Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "certifi"
|
||||
version = "2026.1.4"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/e0/2d/a891ca51311197f6ad14a7ef42e2399f36cf2f9bd44752b3dc4eab60fdc5/certifi-2026.1.4.tar.gz", hash = "sha256:ac726dd470482006e014ad384921ed6438c457018f4b3d204aea4281258b2120", size = 154268, upload-time = "2026-01-04T02:42:41.825Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/e6/ad/3cc14f097111b4de0040c83a525973216457bbeeb63739ef1ed275c1c021/certifi-2026.1.4-py3-none-any.whl", hash = "sha256:9943707519e4add1115f44c2bc244f782c0249876bf51b6599fee1ffbedd685c", size = 152900, upload-time = "2026-01-04T02:42:40.15Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "cffi"
|
||||
version = "2.0.0"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
dependencies = [
|
||||
{ name = "pycparser", marker = "implementation_name != 'PyPy'" },
|
||||
]
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/eb/56/b1ba7935a17738ae8453301356628e8147c79dbb825bcbc73dc7401f9846/cffi-2.0.0.tar.gz", hash = "sha256:44d1b5909021139fe36001ae048dbdde8214afa20200eda0f64c068cac5d5529", size = 523588, upload-time = "2025-09-08T23:24:04.541Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/12/4a/3dfd5f7850cbf0d06dc84ba9aa00db766b52ca38d8b86e3a38314d52498c/cffi-2.0.0-cp311-cp311-macosx_10_13_x86_64.whl", hash = "sha256:b4c854ef3adc177950a8dfc81a86f5115d2abd545751a304c5bcf2c2c7283cfe", size = 184344, upload-time = "2025-09-08T23:22:26.456Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/4f/8b/f0e4c441227ba756aafbe78f117485b25bb26b1c059d01f137fa6d14896b/cffi-2.0.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:2de9a304e27f7596cd03d16f1b7c72219bd944e99cc52b84d0145aefb07cbd3c", size = 180560, upload-time = "2025-09-08T23:22:28.197Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/b1/b7/1200d354378ef52ec227395d95c2576330fd22a869f7a70e88e1447eb234/cffi-2.0.0-cp311-cp311-manylinux1_i686.manylinux2014_i686.manylinux_2_17_i686.manylinux_2_5_i686.whl", hash = "sha256:baf5215e0ab74c16e2dd324e8ec067ef59e41125d3eade2b863d294fd5035c92", size = 209613, upload-time = "2025-09-08T23:22:29.475Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/b8/56/6033f5e86e8cc9bb629f0077ba71679508bdf54a9a5e112a3c0b91870332/cffi-2.0.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:730cacb21e1bdff3ce90babf007d0a0917cc3e6492f336c2f0134101e0944f93", size = 216476, upload-time = "2025-09-08T23:22:31.063Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/dc/7f/55fecd70f7ece178db2f26128ec41430d8720f2d12ca97bf8f0a628207d5/cffi-2.0.0-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:6824f87845e3396029f3820c206e459ccc91760e8fa24422f8b0c3d1731cbec5", size = 203374, upload-time = "2025-09-08T23:22:32.507Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/84/ef/a7b77c8bdc0f77adc3b46888f1ad54be8f3b7821697a7b89126e829e676a/cffi-2.0.0-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:9de40a7b0323d889cf8d23d1ef214f565ab154443c42737dfe52ff82cf857664", size = 202597, upload-time = "2025-09-08T23:22:34.132Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/d7/91/500d892b2bf36529a75b77958edfcd5ad8e2ce4064ce2ecfeab2125d72d1/cffi-2.0.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:8941aaadaf67246224cee8c3803777eed332a19d909b47e29c9842ef1e79ac26", size = 215574, upload-time = "2025-09-08T23:22:35.443Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/44/64/58f6255b62b101093d5df22dcb752596066c7e89dd725e0afaed242a61be/cffi-2.0.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:a05d0c237b3349096d3981b727493e22147f934b20f6f125a3eba8f994bec4a9", size = 218971, upload-time = "2025-09-08T23:22:36.805Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/ab/49/fa72cebe2fd8a55fbe14956f9970fe8eb1ac59e5df042f603ef7c8ba0adc/cffi-2.0.0-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:94698a9c5f91f9d138526b48fe26a199609544591f859c870d477351dc7b2414", size = 211972, upload-time = "2025-09-08T23:22:38.436Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/0b/28/dd0967a76aab36731b6ebfe64dec4e981aff7e0608f60c2d46b46982607d/cffi-2.0.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:5fed36fccc0612a53f1d4d9a816b50a36702c28a2aa880cb8a122b3466638743", size = 217078, upload-time = "2025-09-08T23:22:39.776Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/2b/c0/015b25184413d7ab0a410775fdb4a50fca20f5589b5dab1dbbfa3baad8ce/cffi-2.0.0-cp311-cp311-win32.whl", hash = "sha256:c649e3a33450ec82378822b3dad03cc228b8f5963c0c12fc3b1e0ab940f768a5", size = 172076, upload-time = "2025-09-08T23:22:40.95Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/ae/8f/dc5531155e7070361eb1b7e4c1a9d896d0cb21c49f807a6c03fd63fc877e/cffi-2.0.0-cp311-cp311-win_amd64.whl", hash = "sha256:66f011380d0e49ed280c789fbd08ff0d40968ee7b665575489afa95c98196ab5", size = 182820, upload-time = "2025-09-08T23:22:42.463Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/95/5c/1b493356429f9aecfd56bc171285a4c4ac8697f76e9bbbbb105e537853a1/cffi-2.0.0-cp311-cp311-win_arm64.whl", hash = "sha256:c6638687455baf640e37344fe26d37c404db8b80d037c3d29f58fe8d1c3b194d", size = 177635, upload-time = "2025-09-08T23:22:43.623Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/ea/47/4f61023ea636104d4f16ab488e268b93008c3d0bb76893b1b31db1f96802/cffi-2.0.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:6d02d6655b0e54f54c4ef0b94eb6be0607b70853c45ce98bd278dc7de718be5d", size = 185271, upload-time = "2025-09-08T23:22:44.795Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/df/a2/781b623f57358e360d62cdd7a8c681f074a71d445418a776eef0aadb4ab4/cffi-2.0.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:8eca2a813c1cb7ad4fb74d368c2ffbbb4789d377ee5bb8df98373c2cc0dee76c", size = 181048, upload-time = "2025-09-08T23:22:45.938Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/ff/df/a4f0fbd47331ceeba3d37c2e51e9dfc9722498becbeec2bd8bc856c9538a/cffi-2.0.0-cp312-cp312-manylinux1_i686.manylinux2014_i686.manylinux_2_17_i686.manylinux_2_5_i686.whl", hash = "sha256:21d1152871b019407d8ac3985f6775c079416c282e431a4da6afe7aefd2bccbe", size = 212529, upload-time = "2025-09-08T23:22:47.349Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/d5/72/12b5f8d3865bf0f87cf1404d8c374e7487dcf097a1c91c436e72e6badd83/cffi-2.0.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:b21e08af67b8a103c71a250401c78d5e0893beff75e28c53c98f4de42f774062", size = 220097, upload-time = "2025-09-08T23:22:48.677Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/c2/95/7a135d52a50dfa7c882ab0ac17e8dc11cec9d55d2c18dda414c051c5e69e/cffi-2.0.0-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:1e3a615586f05fc4065a8b22b8152f0c1b00cdbc60596d187c2a74f9e3036e4e", size = 207983, upload-time = "2025-09-08T23:22:50.06Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/3a/c8/15cb9ada8895957ea171c62dc78ff3e99159ee7adb13c0123c001a2546c1/cffi-2.0.0-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:81afed14892743bbe14dacb9e36d9e0e504cd204e0b165062c488942b9718037", size = 206519, upload-time = "2025-09-08T23:22:51.364Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/78/2d/7fa73dfa841b5ac06c7b8855cfc18622132e365f5b81d02230333ff26e9e/cffi-2.0.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:3e17ed538242334bf70832644a32a7aae3d83b57567f9fd60a26257e992b79ba", size = 219572, upload-time = "2025-09-08T23:22:52.902Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/07/e0/267e57e387b4ca276b90f0434ff88b2c2241ad72b16d31836adddfd6031b/cffi-2.0.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:3925dd22fa2b7699ed2617149842d2e6adde22b262fcbfada50e3d195e4b3a94", size = 222963, upload-time = "2025-09-08T23:22:54.518Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/b6/75/1f2747525e06f53efbd878f4d03bac5b859cbc11c633d0fb81432d98a795/cffi-2.0.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:2c8f814d84194c9ea681642fd164267891702542f028a15fc97d4674b6206187", size = 221361, upload-time = "2025-09-08T23:22:55.867Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/7b/2b/2b6435f76bfeb6bbf055596976da087377ede68df465419d192acf00c437/cffi-2.0.0-cp312-cp312-win32.whl", hash = "sha256:da902562c3e9c550df360bfa53c035b2f241fed6d9aef119048073680ace4a18", size = 172932, upload-time = "2025-09-08T23:22:57.188Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/f8/ed/13bd4418627013bec4ed6e54283b1959cf6db888048c7cf4b4c3b5b36002/cffi-2.0.0-cp312-cp312-win_amd64.whl", hash = "sha256:da68248800ad6320861f129cd9c1bf96ca849a2771a59e0344e88681905916f5", size = 183557, upload-time = "2025-09-08T23:22:58.351Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/95/31/9f7f93ad2f8eff1dbc1c3656d7ca5bfd8fb52c9d786b4dcf19b2d02217fa/cffi-2.0.0-cp312-cp312-win_arm64.whl", hash = "sha256:4671d9dd5ec934cb9a73e7ee9676f9362aba54f7f34910956b84d727b0d73fb6", size = 177762, upload-time = "2025-09-08T23:22:59.668Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/4b/8d/a0a47a0c9e413a658623d014e91e74a50cdd2c423f7ccfd44086ef767f90/cffi-2.0.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:00bdf7acc5f795150faa6957054fbbca2439db2f775ce831222b66f192f03beb", size = 185230, upload-time = "2025-09-08T23:23:00.879Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/4a/d2/a6c0296814556c68ee32009d9c2ad4f85f2707cdecfd7727951ec228005d/cffi-2.0.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:45d5e886156860dc35862657e1494b9bae8dfa63bf56796f2fb56e1679fc0bca", size = 181043, upload-time = "2025-09-08T23:23:02.231Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/b0/1e/d22cc63332bd59b06481ceaac49d6c507598642e2230f201649058a7e704/cffi-2.0.0-cp313-cp313-manylinux1_i686.manylinux2014_i686.manylinux_2_17_i686.manylinux_2_5_i686.whl", hash = "sha256:07b271772c100085dd28b74fa0cd81c8fb1a3ba18b21e03d7c27f3436a10606b", size = 212446, upload-time = "2025-09-08T23:23:03.472Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/a9/f5/a2c23eb03b61a0b8747f211eb716446c826ad66818ddc7810cc2cc19b3f2/cffi-2.0.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:d48a880098c96020b02d5a1f7d9251308510ce8858940e6fa99ece33f610838b", size = 220101, upload-time = "2025-09-08T23:23:04.792Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/f2/7f/e6647792fc5850d634695bc0e6ab4111ae88e89981d35ac269956605feba/cffi-2.0.0-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:f93fd8e5c8c0a4aa1f424d6173f14a892044054871c771f8566e4008eaa359d2", size = 207948, upload-time = "2025-09-08T23:23:06.127Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/cb/1e/a5a1bd6f1fb30f22573f76533de12a00bf274abcdc55c8edab639078abb6/cffi-2.0.0-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:dd4f05f54a52fb558f1ba9f528228066954fee3ebe629fc1660d874d040ae5a3", size = 206422, upload-time = "2025-09-08T23:23:07.753Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/98/df/0a1755e750013a2081e863e7cd37e0cdd02664372c754e5560099eb7aa44/cffi-2.0.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:c8d3b5532fc71b7a77c09192b4a5a200ea992702734a2e9279a37f2478236f26", size = 219499, upload-time = "2025-09-08T23:23:09.648Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/50/e1/a969e687fcf9ea58e6e2a928ad5e2dd88cc12f6f0ab477e9971f2309b57c/cffi-2.0.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:d9b29c1f0ae438d5ee9acb31cadee00a58c46cc9c0b2f9038c6b0b3470877a8c", size = 222928, upload-time = "2025-09-08T23:23:10.928Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/36/54/0362578dd2c9e557a28ac77698ed67323ed5b9775ca9d3fe73fe191bb5d8/cffi-2.0.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:6d50360be4546678fc1b79ffe7a66265e28667840010348dd69a314145807a1b", size = 221302, upload-time = "2025-09-08T23:23:12.42Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/eb/6d/bf9bda840d5f1dfdbf0feca87fbdb64a918a69bca42cfa0ba7b137c48cb8/cffi-2.0.0-cp313-cp313-win32.whl", hash = "sha256:74a03b9698e198d47562765773b4a8309919089150a0bb17d829ad7b44b60d27", size = 172909, upload-time = "2025-09-08T23:23:14.32Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/37/18/6519e1ee6f5a1e579e04b9ddb6f1676c17368a7aba48299c3759bbc3c8b3/cffi-2.0.0-cp313-cp313-win_amd64.whl", hash = "sha256:19f705ada2530c1167abacb171925dd886168931e0a7b78f5bffcae5c6b5be75", size = 183402, upload-time = "2025-09-08T23:23:15.535Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/cb/0e/02ceeec9a7d6ee63bb596121c2c8e9b3a9e150936f4fbef6ca1943e6137c/cffi-2.0.0-cp313-cp313-win_arm64.whl", hash = "sha256:256f80b80ca3853f90c21b23ee78cd008713787b1b1e93eae9f3d6a7134abd91", size = 177780, upload-time = "2025-09-08T23:23:16.761Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/92/c4/3ce07396253a83250ee98564f8d7e9789fab8e58858f35d07a9a2c78de9f/cffi-2.0.0-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:fc33c5141b55ed366cfaad382df24fe7dcbc686de5be719b207bb248e3053dc5", size = 185320, upload-time = "2025-09-08T23:23:18.087Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/59/dd/27e9fa567a23931c838c6b02d0764611c62290062a6d4e8ff7863daf9730/cffi-2.0.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:c654de545946e0db659b3400168c9ad31b5d29593291482c43e3564effbcee13", size = 181487, upload-time = "2025-09-08T23:23:19.622Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/d6/43/0e822876f87ea8a4ef95442c3d766a06a51fc5298823f884ef87aaad168c/cffi-2.0.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:24b6f81f1983e6df8db3adc38562c83f7d4a0c36162885ec7f7b77c7dcbec97b", size = 220049, upload-time = "2025-09-08T23:23:20.853Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/b4/89/76799151d9c2d2d1ead63c2429da9ea9d7aac304603de0c6e8764e6e8e70/cffi-2.0.0-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:12873ca6cb9b0f0d3a0da705d6086fe911591737a59f28b7936bdfed27c0d47c", size = 207793, upload-time = "2025-09-08T23:23:22.08Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/bb/dd/3465b14bb9e24ee24cb88c9e3730f6de63111fffe513492bf8c808a3547e/cffi-2.0.0-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:d9b97165e8aed9272a6bb17c01e3cc5871a594a446ebedc996e2397a1c1ea8ef", size = 206300, upload-time = "2025-09-08T23:23:23.314Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/47/d9/d83e293854571c877a92da46fdec39158f8d7e68da75bf73581225d28e90/cffi-2.0.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:afb8db5439b81cf9c9d0c80404b60c3cc9c3add93e114dcae767f1477cb53775", size = 219244, upload-time = "2025-09-08T23:23:24.541Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/2b/0f/1f177e3683aead2bb00f7679a16451d302c436b5cbf2505f0ea8146ef59e/cffi-2.0.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:737fe7d37e1a1bffe70bd5754ea763a62a066dc5913ca57e957824b72a85e205", size = 222828, upload-time = "2025-09-08T23:23:26.143Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/c6/0f/cafacebd4b040e3119dcb32fed8bdef8dfe94da653155f9d0b9dc660166e/cffi-2.0.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:38100abb9d1b1435bc4cc340bb4489635dc2f0da7456590877030c9b3d40b0c1", size = 220926, upload-time = "2025-09-08T23:23:27.873Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/3e/aa/df335faa45b395396fcbc03de2dfcab242cd61a9900e914fe682a59170b1/cffi-2.0.0-cp314-cp314-win32.whl", hash = "sha256:087067fa8953339c723661eda6b54bc98c5625757ea62e95eb4898ad5e776e9f", size = 175328, upload-time = "2025-09-08T23:23:44.61Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/bb/92/882c2d30831744296ce713f0feb4c1cd30f346ef747b530b5318715cc367/cffi-2.0.0-cp314-cp314-win_amd64.whl", hash = "sha256:203a48d1fb583fc7d78a4c6655692963b860a417c0528492a6bc21f1aaefab25", size = 185650, upload-time = "2025-09-08T23:23:45.848Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/9f/2c/98ece204b9d35a7366b5b2c6539c350313ca13932143e79dc133ba757104/cffi-2.0.0-cp314-cp314-win_arm64.whl", hash = "sha256:dbd5c7a25a7cb98f5ca55d258b103a2054f859a46ae11aaf23134f9cc0d356ad", size = 180687, upload-time = "2025-09-08T23:23:47.105Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/3e/61/c768e4d548bfa607abcda77423448df8c471f25dbe64fb2ef6d555eae006/cffi-2.0.0-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:9a67fc9e8eb39039280526379fb3a70023d77caec1852002b4da7e8b270c4dd9", size = 188773, upload-time = "2025-09-08T23:23:29.347Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/2c/ea/5f76bce7cf6fcd0ab1a1058b5af899bfbef198bea4d5686da88471ea0336/cffi-2.0.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:7a66c7204d8869299919db4d5069a82f1561581af12b11b3c9f48c584eb8743d", size = 185013, upload-time = "2025-09-08T23:23:30.63Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/be/b4/c56878d0d1755cf9caa54ba71e5d049479c52f9e4afc230f06822162ab2f/cffi-2.0.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:7cc09976e8b56f8cebd752f7113ad07752461f48a58cbba644139015ac24954c", size = 221593, upload-time = "2025-09-08T23:23:31.91Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/e0/0d/eb704606dfe8033e7128df5e90fee946bbcb64a04fcdaa97321309004000/cffi-2.0.0-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:92b68146a71df78564e4ef48af17551a5ddd142e5190cdf2c5624d0c3ff5b2e8", size = 209354, upload-time = "2025-09-08T23:23:33.214Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/d8/19/3c435d727b368ca475fb8742ab97c9cb13a0de600ce86f62eab7fa3eea60/cffi-2.0.0-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:b1e74d11748e7e98e2f426ab176d4ed720a64412b6a15054378afdb71e0f37dc", size = 208480, upload-time = "2025-09-08T23:23:34.495Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/d0/44/681604464ed9541673e486521497406fadcc15b5217c3e326b061696899a/cffi-2.0.0-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:28a3a209b96630bca57cce802da70c266eb08c6e97e5afd61a75611ee6c64592", size = 221584, upload-time = "2025-09-08T23:23:36.096Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/25/8e/342a504ff018a2825d395d44d63a767dd8ebc927ebda557fecdaca3ac33a/cffi-2.0.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:7553fb2090d71822f02c629afe6042c299edf91ba1bf94951165613553984512", size = 224443, upload-time = "2025-09-08T23:23:37.328Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/e1/5e/b666bacbbc60fbf415ba9988324a132c9a7a0448a9a8f125074671c0f2c3/cffi-2.0.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:6c6c373cfc5c83a975506110d17457138c8c63016b563cc9ed6e056a82f13ce4", size = 223437, upload-time = "2025-09-08T23:23:38.945Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/a0/1d/ec1a60bd1a10daa292d3cd6bb0b359a81607154fb8165f3ec95fe003b85c/cffi-2.0.0-cp314-cp314t-win32.whl", hash = "sha256:1fc9ea04857caf665289b7a75923f2c6ed559b8298a1b8c49e59f7dd95c8481e", size = 180487, upload-time = "2025-09-08T23:23:40.423Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/bf/41/4c1168c74fac325c0c8156f04b6749c8b6a8f405bbf91413ba088359f60d/cffi-2.0.0-cp314-cp314t-win_amd64.whl", hash = "sha256:d68b6cef7827e8641e8ef16f4494edda8b36104d79773a334beaa1e3521430f6", size = 191726, upload-time = "2025-09-08T23:23:41.742Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/ae/3a/dbeec9d1ee0844c679f6bb5d6ad4e9f198b1224f4e7a32825f47f6192b0c/cffi-2.0.0-cp314-cp314t-win_arm64.whl", hash = "sha256:0a1527a803f0a659de1af2e1fd700213caba79377e27e4693648c2923da066f9", size = 184195, upload-time = "2025-09-08T23:23:43.004Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "click"
|
||||
version = "8.3.1"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
dependencies = [
|
||||
{ name = "colorama", marker = "sys_platform == 'win32'" },
|
||||
]
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/3d/fa/656b739db8587d7b5dfa22e22ed02566950fbfbcdc20311993483657a5c0/click-8.3.1.tar.gz", hash = "sha256:12ff4785d337a1bb490bb7e9c2b1ee5da3112e94a8622f26a6c77f5d2fc6842a", size = 295065, upload-time = "2025-11-15T20:45:42.706Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/98/78/01c019cdb5d6498122777c1a43056ebb3ebfeef2076d9d026bfe15583b2b/click-8.3.1-py3-none-any.whl", hash = "sha256:981153a64e25f12d547d3426c367a4857371575ee7ad18df2a6183ab0545b2a6", size = 108274, upload-time = "2025-11-15T20:45:41.139Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "colorama"
|
||||
version = "0.4.6"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "cryptography"
|
||||
version = "46.0.3"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
dependencies = [
|
||||
{ name = "cffi", marker = "platform_python_implementation != 'PyPy'" },
|
||||
]
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/9f/33/c00162f49c0e2fe8064a62cb92b93e50c74a72bc370ab92f86112b33ff62/cryptography-46.0.3.tar.gz", hash = "sha256:a8b17438104fed022ce745b362294d9ce35b4c2e45c1d958ad4a4b019285f4a1", size = 749258, upload-time = "2025-10-15T23:18:31.74Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/1d/42/9c391dd801d6cf0d561b5890549d4b27bafcc53b39c31a817e69d87c625b/cryptography-46.0.3-cp311-abi3-macosx_10_9_universal2.whl", hash = "sha256:109d4ddfadf17e8e7779c39f9b18111a09efb969a301a31e987416a0191ed93a", size = 7225004, upload-time = "2025-10-15T23:16:52.239Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/1c/67/38769ca6b65f07461eb200e85fc1639b438bdc667be02cf7f2cd6a64601c/cryptography-46.0.3-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:09859af8466b69bc3c27bdf4f5d84a665e0f7ab5088412e9e2ec49758eca5cbc", size = 4296667, upload-time = "2025-10-15T23:16:54.369Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/5c/49/498c86566a1d80e978b42f0d702795f69887005548c041636df6ae1ca64c/cryptography-46.0.3-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:01ca9ff2885f3acc98c29f1860552e37f6d7c7d013d7334ff2a9de43a449315d", size = 4450807, upload-time = "2025-10-15T23:16:56.414Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/4b/0a/863a3604112174c8624a2ac3c038662d9e59970c7f926acdcfaed8d61142/cryptography-46.0.3-cp311-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:6eae65d4c3d33da080cff9c4ab1f711b15c1d9760809dad6ea763f3812d254cb", size = 4299615, upload-time = "2025-10-15T23:16:58.442Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/64/02/b73a533f6b64a69f3cd3872acb6ebc12aef924d8d103133bb3ea750dc703/cryptography-46.0.3-cp311-abi3-manylinux_2_28_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:e5bf0ed4490068a2e72ac03d786693adeb909981cc596425d09032d372bcc849", size = 4016800, upload-time = "2025-10-15T23:17:00.378Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/25/d5/16e41afbfa450cde85a3b7ec599bebefaef16b5c6ba4ec49a3532336ed72/cryptography-46.0.3-cp311-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:5ecfccd2329e37e9b7112a888e76d9feca2347f12f37918facbb893d7bb88ee8", size = 4984707, upload-time = "2025-10-15T23:17:01.98Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/c9/56/e7e69b427c3878352c2fb9b450bd0e19ed552753491d39d7d0a2f5226d41/cryptography-46.0.3-cp311-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:a2c0cd47381a3229c403062f764160d57d4d175e022c1df84e168c6251a22eec", size = 4482541, upload-time = "2025-10-15T23:17:04.078Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/78/f6/50736d40d97e8483172f1bb6e698895b92a223dba513b0ca6f06b2365339/cryptography-46.0.3-cp311-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:549e234ff32571b1f4076ac269fcce7a808d3bf98b76c8dd560e42dbc66d7d91", size = 4299464, upload-time = "2025-10-15T23:17:05.483Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/00/de/d8e26b1a855f19d9994a19c702fa2e93b0456beccbcfe437eda00e0701f2/cryptography-46.0.3-cp311-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:c0a7bb1a68a5d3471880e264621346c48665b3bf1c3759d682fc0864c540bd9e", size = 4950838, upload-time = "2025-10-15T23:17:07.425Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/8f/29/798fc4ec461a1c9e9f735f2fc58741b0daae30688f41b2497dcbc9ed1355/cryptography-46.0.3-cp311-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:10b01676fc208c3e6feeb25a8b83d81767e8059e1fe86e1dc62d10a3018fa926", size = 4481596, upload-time = "2025-10-15T23:17:09.343Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/15/8d/03cd48b20a573adfff7652b76271078e3045b9f49387920e7f1f631d125e/cryptography-46.0.3-cp311-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:0abf1ffd6e57c67e92af68330d05760b7b7efb243aab8377e583284dbab72c71", size = 4426782, upload-time = "2025-10-15T23:17:11.22Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/fa/b1/ebacbfe53317d55cf33165bda24c86523497a6881f339f9aae5c2e13e57b/cryptography-46.0.3-cp311-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:a04bee9ab6a4da801eb9b51f1b708a1b5b5c9eb48c03f74198464c66f0d344ac", size = 4698381, upload-time = "2025-10-15T23:17:12.829Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/96/92/8a6a9525893325fc057a01f654d7efc2c64b9de90413adcf605a85744ff4/cryptography-46.0.3-cp311-abi3-win32.whl", hash = "sha256:f260d0d41e9b4da1ed1e0f1ce571f97fe370b152ab18778e9e8f67d6af432018", size = 3055988, upload-time = "2025-10-15T23:17:14.65Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/7e/bf/80fbf45253ea585a1e492a6a17efcb93467701fa79e71550a430c5e60df0/cryptography-46.0.3-cp311-abi3-win_amd64.whl", hash = "sha256:a9a3008438615669153eb86b26b61e09993921ebdd75385ddd748702c5adfddb", size = 3514451, upload-time = "2025-10-15T23:17:16.142Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/2e/af/9b302da4c87b0beb9db4e756386a7c6c5b8003cd0e742277888d352ae91d/cryptography-46.0.3-cp311-abi3-win_arm64.whl", hash = "sha256:5d7f93296ee28f68447397bf5198428c9aeeab45705a55d53a6343455dcb2c3c", size = 2928007, upload-time = "2025-10-15T23:17:18.04Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/f5/e2/a510aa736755bffa9d2f75029c229111a1d02f8ecd5de03078f4c18d91a3/cryptography-46.0.3-cp314-cp314t-macosx_10_9_universal2.whl", hash = "sha256:00a5e7e87938e5ff9ff5447ab086a5706a957137e6e433841e9d24f38a065217", size = 7158012, upload-time = "2025-10-15T23:17:19.982Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/73/dc/9aa866fbdbb95b02e7f9d086f1fccfeebf8953509b87e3f28fff927ff8a0/cryptography-46.0.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:c8daeb2d2174beb4575b77482320303f3d39b8e81153da4f0fb08eb5fe86a6c5", size = 4288728, upload-time = "2025-10-15T23:17:21.527Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/c5/fd/bc1daf8230eaa075184cbbf5f8cd00ba9db4fd32d63fb83da4671b72ed8a/cryptography-46.0.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:39b6755623145ad5eff1dab323f4eae2a32a77a7abef2c5089a04a3d04366715", size = 4435078, upload-time = "2025-10-15T23:17:23.042Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/82/98/d3bd5407ce4c60017f8ff9e63ffee4200ab3e23fe05b765cab805a7db008/cryptography-46.0.3-cp314-cp314t-manylinux_2_28_aarch64.whl", hash = "sha256:db391fa7c66df6762ee3f00c95a89e6d428f4d60e7abc8328f4fe155b5ac6e54", size = 4293460, upload-time = "2025-10-15T23:17:24.885Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/26/e9/e23e7900983c2b8af7a08098db406cf989d7f09caea7897e347598d4cd5b/cryptography-46.0.3-cp314-cp314t-manylinux_2_28_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:78a97cf6a8839a48c49271cdcbd5cf37ca2c1d6b7fdd86cc864f302b5e9bf459", size = 3995237, upload-time = "2025-10-15T23:17:26.449Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/91/15/af68c509d4a138cfe299d0d7ddb14afba15233223ebd933b4bbdbc7155d3/cryptography-46.0.3-cp314-cp314t-manylinux_2_28_ppc64le.whl", hash = "sha256:dfb781ff7eaa91a6f7fd41776ec37c5853c795d3b358d4896fdbb5df168af422", size = 4967344, upload-time = "2025-10-15T23:17:28.06Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/ca/e3/8643d077c53868b681af077edf6b3cb58288b5423610f21c62aadcbe99f4/cryptography-46.0.3-cp314-cp314t-manylinux_2_28_x86_64.whl", hash = "sha256:6f61efb26e76c45c4a227835ddeae96d83624fb0d29eb5df5b96e14ed1a0afb7", size = 4466564, upload-time = "2025-10-15T23:17:29.665Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/0e/43/c1e8726fa59c236ff477ff2b5dc071e54b21e5a1e51aa2cee1676f1c986f/cryptography-46.0.3-cp314-cp314t-manylinux_2_34_aarch64.whl", hash = "sha256:23b1a8f26e43f47ceb6d6a43115f33a5a37d57df4ea0ca295b780ae8546e8044", size = 4292415, upload-time = "2025-10-15T23:17:31.686Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/42/f9/2f8fefdb1aee8a8e3256a0568cffc4e6d517b256a2fe97a029b3f1b9fe7e/cryptography-46.0.3-cp314-cp314t-manylinux_2_34_ppc64le.whl", hash = "sha256:b419ae593c86b87014b9be7396b385491ad7f320bde96826d0dd174459e54665", size = 4931457, upload-time = "2025-10-15T23:17:33.478Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/79/30/9b54127a9a778ccd6d27c3da7563e9f2d341826075ceab89ae3b41bf5be2/cryptography-46.0.3-cp314-cp314t-manylinux_2_34_x86_64.whl", hash = "sha256:50fc3343ac490c6b08c0cf0d704e881d0d660be923fd3076db3e932007e726e3", size = 4466074, upload-time = "2025-10-15T23:17:35.158Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/ac/68/b4f4a10928e26c941b1b6a179143af9f4d27d88fe84a6a3c53592d2e76bf/cryptography-46.0.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:22d7e97932f511d6b0b04f2bfd818d73dcd5928db509460aaf48384778eb6d20", size = 4420569, upload-time = "2025-10-15T23:17:37.188Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/a3/49/3746dab4c0d1979888f125226357d3262a6dd40e114ac29e3d2abdf1ec55/cryptography-46.0.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:d55f3dffadd674514ad19451161118fd010988540cee43d8bc20675e775925de", size = 4681941, upload-time = "2025-10-15T23:17:39.236Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/fd/30/27654c1dbaf7e4a3531fa1fc77986d04aefa4d6d78259a62c9dc13d7ad36/cryptography-46.0.3-cp314-cp314t-win32.whl", hash = "sha256:8a6e050cb6164d3f830453754094c086ff2d0b2f3a897a1d9820f6139a1f0914", size = 3022339, upload-time = "2025-10-15T23:17:40.888Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/f6/30/640f34ccd4d2a1bc88367b54b926b781b5a018d65f404d409aba76a84b1c/cryptography-46.0.3-cp314-cp314t-win_amd64.whl", hash = "sha256:760f83faa07f8b64e9c33fc963d790a2edb24efb479e3520c14a45741cd9b2db", size = 3494315, upload-time = "2025-10-15T23:17:42.769Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/ba/8b/88cc7e3bd0a8e7b861f26981f7b820e1f46aa9d26cc482d0feba0ecb4919/cryptography-46.0.3-cp314-cp314t-win_arm64.whl", hash = "sha256:516ea134e703e9fe26bcd1277a4b59ad30586ea90c365a87781d7887a646fe21", size = 2919331, upload-time = "2025-10-15T23:17:44.468Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/fd/23/45fe7f376a7df8daf6da3556603b36f53475a99ce4faacb6ba2cf3d82021/cryptography-46.0.3-cp38-abi3-macosx_10_9_universal2.whl", hash = "sha256:cb3d760a6117f621261d662bccc8ef5bc32ca673e037c83fbe565324f5c46936", size = 7218248, upload-time = "2025-10-15T23:17:46.294Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/27/32/b68d27471372737054cbd34c84981f9edbc24fe67ca225d389799614e27f/cryptography-46.0.3-cp38-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:4b7387121ac7d15e550f5cb4a43aef2559ed759c35df7336c402bb8275ac9683", size = 4294089, upload-time = "2025-10-15T23:17:48.269Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/26/42/fa8389d4478368743e24e61eea78846a0006caffaf72ea24a15159215a14/cryptography-46.0.3-cp38-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:15ab9b093e8f09daab0f2159bb7e47532596075139dd74365da52ecc9cb46c5d", size = 4440029, upload-time = "2025-10-15T23:17:49.837Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/5f/eb/f483db0ec5ac040824f269e93dd2bd8a21ecd1027e77ad7bdf6914f2fd80/cryptography-46.0.3-cp38-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:46acf53b40ea38f9c6c229599a4a13f0d46a6c3fa9ef19fc1a124d62e338dfa0", size = 4297222, upload-time = "2025-10-15T23:17:51.357Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/fd/cf/da9502c4e1912cb1da3807ea3618a6829bee8207456fbbeebc361ec38ba3/cryptography-46.0.3-cp38-abi3-manylinux_2_28_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:10ca84c4668d066a9878890047f03546f3ae0a6b8b39b697457b7757aaf18dbc", size = 4012280, upload-time = "2025-10-15T23:17:52.964Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/6b/8f/9adb86b93330e0df8b3dcf03eae67c33ba89958fc2e03862ef1ac2b42465/cryptography-46.0.3-cp38-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:36e627112085bb3b81b19fed209c05ce2a52ee8b15d161b7c643a7d5a88491f3", size = 4978958, upload-time = "2025-10-15T23:17:54.965Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/d1/a0/5fa77988289c34bdb9f913f5606ecc9ada1adb5ae870bd0d1054a7021cc4/cryptography-46.0.3-cp38-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:1000713389b75c449a6e979ffc7dcc8ac90b437048766cef052d4d30b8220971", size = 4473714, upload-time = "2025-10-15T23:17:56.754Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/14/e5/fc82d72a58d41c393697aa18c9abe5ae1214ff6f2a5c18ac470f92777895/cryptography-46.0.3-cp38-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:b02cf04496f6576afffef5ddd04a0cb7d49cf6be16a9059d793a30b035f6b6ac", size = 4296970, upload-time = "2025-10-15T23:17:58.588Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/78/06/5663ed35438d0b09056973994f1aec467492b33bd31da36e468b01ec1097/cryptography-46.0.3-cp38-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:71e842ec9bc7abf543b47cf86b9a743baa95f4677d22baa4c7d5c69e49e9bc04", size = 4940236, upload-time = "2025-10-15T23:18:00.897Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/fc/59/873633f3f2dcd8a053b8dd1d38f783043b5fce589c0f6988bf55ef57e43e/cryptography-46.0.3-cp38-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:402b58fc32614f00980b66d6e56a5b4118e6cb362ae8f3fda141ba4689bd4506", size = 4472642, upload-time = "2025-10-15T23:18:02.749Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/3d/39/8e71f3930e40f6877737d6f69248cf74d4e34b886a3967d32f919cc50d3b/cryptography-46.0.3-cp38-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:ef639cb3372f69ec44915fafcd6698b6cc78fbe0c2ea41be867f6ed612811963", size = 4423126, upload-time = "2025-10-15T23:18:04.85Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/cd/c7/f65027c2810e14c3e7268353b1681932b87e5a48e65505d8cc17c99e36ae/cryptography-46.0.3-cp38-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:3b51b8ca4f1c6453d8829e1eb7299499ca7f313900dd4d89a24b8b87c0a780d4", size = 4686573, upload-time = "2025-10-15T23:18:06.908Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/0a/6e/1c8331ddf91ca4730ab3086a0f1be19c65510a33b5a441cb334e7a2d2560/cryptography-46.0.3-cp38-abi3-win32.whl", hash = "sha256:6276eb85ef938dc035d59b87c8a7dc559a232f954962520137529d77b18ff1df", size = 3036695, upload-time = "2025-10-15T23:18:08.672Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/90/45/b0d691df20633eff80955a0fc7695ff9051ffce8b69741444bd9ed7bd0db/cryptography-46.0.3-cp38-abi3-win_amd64.whl", hash = "sha256:416260257577718c05135c55958b674000baef9a1c7d9e8f306ec60d71db850f", size = 3501720, upload-time = "2025-10-15T23:18:10.632Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/e8/cb/2da4cc83f5edb9c3257d09e1e7ab7b23f049c7962cae8d842bbef0a9cec9/cryptography-46.0.3-cp38-abi3-win_arm64.whl", hash = "sha256:d89c3468de4cdc4f08a57e214384d0471911a3830fcdaf7a8cc587e42a866372", size = 2918740, upload-time = "2025-10-15T23:18:12.277Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/06/8a/e60e46adab4362a682cf142c7dcb5bf79b782ab2199b0dcb81f55970807f/cryptography-46.0.3-pp311-pypy311_pp73-macosx_10_9_x86_64.whl", hash = "sha256:7ce938a99998ed3c8aa7e7272dca1a610401ede816d36d0693907d863b10d9ea", size = 3698132, upload-time = "2025-10-15T23:18:17.056Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/da/38/f59940ec4ee91e93d3311f7532671a5cef5570eb04a144bf203b58552d11/cryptography-46.0.3-pp311-pypy311_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:191bb60a7be5e6f54e30ba16fdfae78ad3a342a0599eb4193ba88e3f3d6e185b", size = 4243992, upload-time = "2025-10-15T23:18:18.695Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/b0/0c/35b3d92ddebfdfda76bb485738306545817253d0a3ded0bfe80ef8e67aa5/cryptography-46.0.3-pp311-pypy311_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:c70cc23f12726be8f8bc72e41d5065d77e4515efae3690326764ea1b07845cfb", size = 4409944, upload-time = "2025-10-15T23:18:20.597Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/99/55/181022996c4063fc0e7666a47049a1ca705abb9c8a13830f074edb347495/cryptography-46.0.3-pp311-pypy311_pp73-manylinux_2_34_aarch64.whl", hash = "sha256:9394673a9f4de09e28b5356e7fff97d778f8abad85c9d5ac4a4b7e25a0de7717", size = 4242957, upload-time = "2025-10-15T23:18:22.18Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/ba/af/72cd6ef29f9c5f731251acadaeb821559fe25f10852f44a63374c9ca08c1/cryptography-46.0.3-pp311-pypy311_pp73-manylinux_2_34_x86_64.whl", hash = "sha256:94cd0549accc38d1494e1f8de71eca837d0509d0d44bf11d158524b0e12cebf9", size = 4409447, upload-time = "2025-10-15T23:18:24.209Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/0d/c3/e90f4a4feae6410f914f8ebac129b9ae7a8c92eb60a638012dde42030a9d/cryptography-46.0.3-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:6b5063083824e5509fdba180721d55909ffacccc8adbec85268b48439423d78c", size = 3438528, upload-time = "2025-10-15T23:18:26.227Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "h11"
|
||||
version = "0.16.0"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/01/ee/02a2c011bdab74c6fb3c75474d40b3052059d95df7e73351460c8588d963/h11-0.16.0.tar.gz", hash = "sha256:4e35b956cf45792e4caa5885e69fba00bdbc6ffafbfa020300e549b208ee5ff1", size = 101250, upload-time = "2025-04-24T03:35:25.427Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/04/4b/29cac41a4d98d144bf5f6d33995617b185d14b22401f75ca86f384e87ff1/h11-0.16.0-py3-none-any.whl", hash = "sha256:63cf8bbe7522de3bf65932fda1d9c2772064ffb3dae62d55932da54b31cb6c86", size = 37515, upload-time = "2025-04-24T03:35:24.344Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "httpcore"
|
||||
version = "1.0.9"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
dependencies = [
|
||||
{ name = "certifi" },
|
||||
{ name = "h11" },
|
||||
]
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/06/94/82699a10bca87a5556c9c59b5963f2d039dbd239f25bc2a63907a05a14cb/httpcore-1.0.9.tar.gz", hash = "sha256:6e34463af53fd2ab5d807f399a9b45ea31c3dfa2276f15a2c3f00afff6e176e8", size = 85484, upload-time = "2025-04-24T22:06:22.219Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/7e/f5/f66802a942d491edb555dd61e3a9961140fd64c90bce1eafd741609d334d/httpcore-1.0.9-py3-none-any.whl", hash = "sha256:2d400746a40668fc9dec9810239072b40b4484b640a8c38fd654a024c7a1bf55", size = 78784, upload-time = "2025-04-24T22:06:20.566Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "httpx"
|
||||
version = "0.28.1"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
dependencies = [
|
||||
{ name = "anyio" },
|
||||
{ name = "certifi" },
|
||||
{ name = "httpcore" },
|
||||
{ name = "idna" },
|
||||
]
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/b1/df/48c586a5fe32a0f01324ee087459e112ebb7224f646c0b5023f5e79e9956/httpx-0.28.1.tar.gz", hash = "sha256:75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc", size = 141406, upload-time = "2024-12-06T15:37:23.222Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/2a/39/e50c7c3a983047577ee07d2a9e53faf5a69493943ec3f6a384bdc792deb2/httpx-0.28.1-py3-none-any.whl", hash = "sha256:d909fcccc110f8c7faf814ca82a9a4d816bc5a6dbfea25d6591d6985b8ba59ad", size = 73517, upload-time = "2024-12-06T15:37:21.509Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "httpx-sse"
|
||||
version = "0.4.3"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/0f/4c/751061ffa58615a32c31b2d82e8482be8dd4a89154f003147acee90f2be9/httpx_sse-0.4.3.tar.gz", hash = "sha256:9b1ed0127459a66014aec3c56bebd93da3c1bc8bb6618c8082039a44889a755d", size = 15943, upload-time = "2025-10-10T21:48:22.271Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/d2/fd/6668e5aec43ab844de6fc74927e155a3b37bf40d7c3790e49fc0406b6578/httpx_sse-0.4.3-py3-none-any.whl", hash = "sha256:0ac1c9fe3c0afad2e0ebb25a934a59f4c7823b60792691f779fad2c5568830fc", size = 8960, upload-time = "2025-10-10T21:48:21.158Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "idna"
|
||||
version = "3.11"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/6f/6d/0703ccc57f3a7233505399edb88de3cbd678da106337b9fcde432b65ed60/idna-3.11.tar.gz", hash = "sha256:795dafcc9c04ed0c1fb032c2aa73654d8e8c5023a7df64a53f39190ada629902", size = 194582, upload-time = "2025-10-12T14:55:20.501Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/0e/61/66938bbb5fc52dbdf84594873d5b51fb1f7c7794e9c0f5bd885f30bc507b/idna-3.11-py3-none-any.whl", hash = "sha256:771a87f49d9defaf64091e6e6fe9c18d4833f140bd19464795bc32d966ca37ea", size = 71008, upload-time = "2025-10-12T14:55:18.883Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "iniconfig"
|
||||
version = "2.3.0"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/72/34/14ca021ce8e5dfedc35312d08ba8bf51fdd999c576889fc2c24cb97f4f10/iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730", size = 20503, upload-time = "2025-10-18T21:55:43.219Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41.639Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "jsonschema"
|
||||
version = "4.26.0"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
dependencies = [
|
||||
{ name = "attrs" },
|
||||
{ name = "jsonschema-specifications" },
|
||||
{ name = "referencing" },
|
||||
{ name = "rpds-py" },
|
||||
]
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/b3/fc/e067678238fa451312d4c62bf6e6cf5ec56375422aee02f9cb5f909b3047/jsonschema-4.26.0.tar.gz", hash = "sha256:0c26707e2efad8aa1bfc5b7ce170f3fccc2e4918ff85989ba9ffa9facb2be326", size = 366583, upload-time = "2026-01-07T13:41:07.246Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/69/90/f63fb5873511e014207a475e2bb4e8b2e570d655b00ac19a9a0ca0a385ee/jsonschema-4.26.0-py3-none-any.whl", hash = "sha256:d489f15263b8d200f8387e64b4c3a75f06629559fb73deb8fdfb525f2dab50ce", size = 90630, upload-time = "2026-01-07T13:41:05.306Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "jsonschema-specifications"
|
||||
version = "2025.9.1"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
dependencies = [
|
||||
{ name = "referencing" },
|
||||
]
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/19/74/a633ee74eb36c44aa6d1095e7cc5569bebf04342ee146178e2d36600708b/jsonschema_specifications-2025.9.1.tar.gz", hash = "sha256:b540987f239e745613c7a9176f3edb72b832a4ac465cf02712288397832b5e8d", size = 32855, upload-time = "2025-09-08T01:34:59.186Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/41/45/1a4ed80516f02155c51f51e8cedb3c1902296743db0bbc66608a0db2814f/jsonschema_specifications-2025.9.1-py3-none-any.whl", hash = "sha256:98802fee3a11ee76ecaca44429fda8a41bff98b00a0f2838151b113f210cc6fe", size = 18437, upload-time = "2025-09-08T01:34:57.871Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "mcp"
|
||||
version = "1.25.0"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
dependencies = [
|
||||
{ name = "anyio" },
|
||||
{ name = "httpx" },
|
||||
{ name = "httpx-sse" },
|
||||
{ name = "jsonschema" },
|
||||
{ name = "pydantic" },
|
||||
{ name = "pydantic-settings" },
|
||||
{ name = "pyjwt", extra = ["crypto"] },
|
||||
{ name = "python-multipart" },
|
||||
{ name = "pywin32", marker = "sys_platform == 'win32'" },
|
||||
{ name = "sse-starlette" },
|
||||
{ name = "starlette" },
|
||||
{ name = "typing-extensions" },
|
||||
{ name = "typing-inspection" },
|
||||
{ name = "uvicorn", marker = "sys_platform != 'emscripten'" },
|
||||
]
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/d5/2d/649d80a0ecf6a1f82632ca44bec21c0461a9d9fc8934d38cb5b319f2db5e/mcp-1.25.0.tar.gz", hash = "sha256:56310361ebf0364e2d438e5b45f7668cbb124e158bb358333cd06e49e83a6802", size = 605387, upload-time = "2025-12-19T10:19:56.985Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/e2/fc/6dc7659c2ae5ddf280477011f4213a74f806862856b796ef08f028e664bf/mcp-1.25.0-py3-none-any.whl", hash = "sha256:b37c38144a666add0862614cc79ec276e97d72aa8ca26d622818d4e278b9721a", size = 233076, upload-time = "2025-12-19T10:19:55.416Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "mcp-codex-delegator"
|
||||
version = "0.1.0"
|
||||
source = { editable = "." }
|
||||
dependencies = [
|
||||
{ name = "mcp" },
|
||||
{ name = "pyyaml" },
|
||||
]
|
||||
|
||||
[package.optional-dependencies]
|
||||
dev = [
|
||||
{ name = "pytest" },
|
||||
{ name = "pytest-asyncio" },
|
||||
]
|
||||
|
||||
[package.metadata]
|
||||
requires-dist = [
|
||||
{ name = "mcp", specifier = ">=1.0.0" },
|
||||
{ name = "pytest", marker = "extra == 'dev'", specifier = ">=8.0.0" },
|
||||
{ name = "pytest-asyncio", marker = "extra == 'dev'", specifier = ">=0.23.0" },
|
||||
{ name = "pyyaml", specifier = ">=6.0.1" },
|
||||
]
|
||||
provides-extras = ["dev"]
|
||||
|
||||
[[package]]
|
||||
name = "packaging"
|
||||
version = "25.0"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/a1/d4/1fc4078c65507b51b96ca8f8c3ba19e6a61c8253c72794544580a7b6c24d/packaging-25.0.tar.gz", hash = "sha256:d443872c98d677bf60f6a1f2f8c1cb748e8fe762d2bf9d3148b5599295b0fc4f", size = 165727, upload-time = "2025-04-19T11:48:59.673Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/20/12/38679034af332785aac8774540895e234f4d07f7545804097de4b666afd8/packaging-25.0-py3-none-any.whl", hash = "sha256:29572ef2b1f17581046b3a2227d5c611fb25ec70ca1ba8554b24b0e69331a484", size = 66469, upload-time = "2025-04-19T11:48:57.875Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "pluggy"
|
||||
version = "1.6.0"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/f9/e2/3e91f31a7d2b083fe6ef3fa267035b518369d9511ffab804f839851d2779/pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3", size = 69412, upload-time = "2025-05-15T12:30:07.975Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "pycparser"
|
||||
version = "2.23"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/fe/cf/d2d3b9f5699fb1e4615c8e32ff220203e43b248e1dfcc6736ad9057731ca/pycparser-2.23.tar.gz", hash = "sha256:78816d4f24add8f10a06d6f05b4d424ad9e96cfebf68a4ddc99c65c0720d00c2", size = 173734, upload-time = "2025-09-09T13:23:47.91Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/a0/e3/59cd50310fc9b59512193629e1984c1f95e5c8ae6e5d8c69532ccc65a7fe/pycparser-2.23-py3-none-any.whl", hash = "sha256:e5c6e8d3fbad53479cab09ac03729e0a9faf2bee3db8208a550daf5af81a5934", size = 118140, upload-time = "2025-09-09T13:23:46.651Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "pydantic"
|
||||
version = "2.12.5"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
dependencies = [
|
||||
{ name = "annotated-types" },
|
||||
{ name = "pydantic-core" },
|
||||
{ name = "typing-extensions" },
|
||||
{ name = "typing-inspection" },
|
||||
]
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/69/44/36f1a6e523abc58ae5f928898e4aca2e0ea509b5aa6f6f392a5d882be928/pydantic-2.12.5.tar.gz", hash = "sha256:4d351024c75c0f085a9febbb665ce8c0c6ec5d30e903bdb6394b7ede26aebb49", size = 821591, upload-time = "2025-11-26T15:11:46.471Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/5a/87/b70ad306ebb6f9b585f114d0ac2137d792b48be34d732d60e597c2f8465a/pydantic-2.12.5-py3-none-any.whl", hash = "sha256:e561593fccf61e8a20fc46dfc2dfe075b8be7d0188df33f221ad1f0139180f9d", size = 463580, upload-time = "2025-11-26T15:11:44.605Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "pydantic-core"
|
||||
version = "2.41.5"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
dependencies = [
|
||||
{ name = "typing-extensions" },
|
||||
]
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/71/70/23b021c950c2addd24ec408e9ab05d59b035b39d97cdc1130e1bce647bb6/pydantic_core-2.41.5.tar.gz", hash = "sha256:08daa51ea16ad373ffd5e7606252cc32f07bc72b28284b6bc9c6df804816476e", size = 460952, upload-time = "2025-11-04T13:43:49.098Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/e8/72/74a989dd9f2084b3d9530b0915fdda64ac48831c30dbf7c72a41a5232db8/pydantic_core-2.41.5-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:a3a52f6156e73e7ccb0f8cced536adccb7042be67cb45f9562e12b319c119da6", size = 2105873, upload-time = "2025-11-04T13:39:31.373Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/12/44/37e403fd9455708b3b942949e1d7febc02167662bf1a7da5b78ee1ea2842/pydantic_core-2.41.5-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:7f3bf998340c6d4b0c9a2f02d6a400e51f123b59565d74dc60d252ce888c260b", size = 1899826, upload-time = "2025-11-04T13:39:32.897Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/33/7f/1d5cab3ccf44c1935a359d51a8a2a9e1a654b744b5e7f80d41b88d501eec/pydantic_core-2.41.5-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:378bec5c66998815d224c9ca994f1e14c0c21cb95d2f52b6021cc0b2a58f2a5a", size = 1917869, upload-time = "2025-11-04T13:39:34.469Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/6e/6a/30d94a9674a7fe4f4744052ed6c5e083424510be1e93da5bc47569d11810/pydantic_core-2.41.5-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:e7b576130c69225432866fe2f4a469a85a54ade141d96fd396dffcf607b558f8", size = 2063890, upload-time = "2025-11-04T13:39:36.053Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/50/be/76e5d46203fcb2750e542f32e6c371ffa9b8ad17364cf94bb0818dbfb50c/pydantic_core-2.41.5-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:6cb58b9c66f7e4179a2d5e0f849c48eff5c1fca560994d6eb6543abf955a149e", size = 2229740, upload-time = "2025-11-04T13:39:37.753Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/d3/ee/fed784df0144793489f87db310a6bbf8118d7b630ed07aa180d6067e653a/pydantic_core-2.41.5-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:88942d3a3dff3afc8288c21e565e476fc278902ae4d6d134f1eeda118cc830b1", size = 2350021, upload-time = "2025-11-04T13:39:40.94Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/c8/be/8fed28dd0a180dca19e72c233cbf58efa36df055e5b9d90d64fd1740b828/pydantic_core-2.41.5-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f31d95a179f8d64d90f6831d71fa93290893a33148d890ba15de25642c5d075b", size = 2066378, upload-time = "2025-11-04T13:39:42.523Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/b0/3b/698cf8ae1d536a010e05121b4958b1257f0b5522085e335360e53a6b1c8b/pydantic_core-2.41.5-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:c1df3d34aced70add6f867a8cf413e299177e0c22660cc767218373d0779487b", size = 2175761, upload-time = "2025-11-04T13:39:44.553Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/b8/ba/15d537423939553116dea94ce02f9c31be0fa9d0b806d427e0308ec17145/pydantic_core-2.41.5-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:4009935984bd36bd2c774e13f9a09563ce8de4abaa7226f5108262fa3e637284", size = 2146303, upload-time = "2025-11-04T13:39:46.238Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/58/7f/0de669bf37d206723795f9c90c82966726a2ab06c336deba4735b55af431/pydantic_core-2.41.5-cp311-cp311-musllinux_1_1_armv7l.whl", hash = "sha256:34a64bc3441dc1213096a20fe27e8e128bd3ff89921706e83c0b1ac971276594", size = 2340355, upload-time = "2025-11-04T13:39:48.002Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/e5/de/e7482c435b83d7e3c3ee5ee4451f6e8973cff0eb6007d2872ce6383f6398/pydantic_core-2.41.5-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:c9e19dd6e28fdcaa5a1de679aec4141f691023916427ef9bae8584f9c2fb3b0e", size = 2319875, upload-time = "2025-11-04T13:39:49.705Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/fe/e6/8c9e81bb6dd7560e33b9053351c29f30c8194b72f2d6932888581f503482/pydantic_core-2.41.5-cp311-cp311-win32.whl", hash = "sha256:2c010c6ded393148374c0f6f0bf89d206bf3217f201faa0635dcd56bd1520f6b", size = 1987549, upload-time = "2025-11-04T13:39:51.842Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/11/66/f14d1d978ea94d1bc21fc98fcf570f9542fe55bfcc40269d4e1a21c19bf7/pydantic_core-2.41.5-cp311-cp311-win_amd64.whl", hash = "sha256:76ee27c6e9c7f16f47db7a94157112a2f3a00e958bc626e2f4ee8bec5c328fbe", size = 2011305, upload-time = "2025-11-04T13:39:53.485Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/56/d8/0e271434e8efd03186c5386671328154ee349ff0354d83c74f5caaf096ed/pydantic_core-2.41.5-cp311-cp311-win_arm64.whl", hash = "sha256:4bc36bbc0b7584de96561184ad7f012478987882ebf9f9c389b23f432ea3d90f", size = 1972902, upload-time = "2025-11-04T13:39:56.488Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/5f/5d/5f6c63eebb5afee93bcaae4ce9a898f3373ca23df3ccaef086d0233a35a7/pydantic_core-2.41.5-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:f41a7489d32336dbf2199c8c0a215390a751c5b014c2c1c5366e817202e9cdf7", size = 2110990, upload-time = "2025-11-04T13:39:58.079Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/aa/32/9c2e8ccb57c01111e0fd091f236c7b371c1bccea0fa85247ac55b1e2b6b6/pydantic_core-2.41.5-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:070259a8818988b9a84a449a2a7337c7f430a22acc0859c6b110aa7212a6d9c0", size = 1896003, upload-time = "2025-11-04T13:39:59.956Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/68/b8/a01b53cb0e59139fbc9e4fda3e9724ede8de279097179be4ff31f1abb65a/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e96cea19e34778f8d59fe40775a7a574d95816eb150850a85a7a4c8f4b94ac69", size = 1919200, upload-time = "2025-11-04T13:40:02.241Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/38/de/8c36b5198a29bdaade07b5985e80a233a5ac27137846f3bc2d3b40a47360/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:ed2e99c456e3fadd05c991f8f437ef902e00eedf34320ba2b0842bd1c3ca3a75", size = 2052578, upload-time = "2025-11-04T13:40:04.401Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/00/b5/0e8e4b5b081eac6cb3dbb7e60a65907549a1ce035a724368c330112adfdd/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:65840751b72fbfd82c3c640cff9284545342a4f1eb1586ad0636955b261b0b05", size = 2208504, upload-time = "2025-11-04T13:40:06.072Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/77/56/87a61aad59c7c5b9dc8caad5a41a5545cba3810c3e828708b3d7404f6cef/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e536c98a7626a98feb2d3eaf75944ef6f3dbee447e1f841eae16f2f0a72d8ddc", size = 2335816, upload-time = "2025-11-04T13:40:07.835Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/0d/76/941cc9f73529988688a665a5c0ecff1112b3d95ab48f81db5f7606f522d3/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:eceb81a8d74f9267ef4081e246ffd6d129da5d87e37a77c9bde550cb04870c1c", size = 2075366, upload-time = "2025-11-04T13:40:09.804Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/d3/43/ebef01f69baa07a482844faaa0a591bad1ef129253ffd0cdaa9d8a7f72d3/pydantic_core-2.41.5-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d38548150c39b74aeeb0ce8ee1d8e82696f4a4e16ddc6de7b1d8823f7de4b9b5", size = 2171698, upload-time = "2025-11-04T13:40:12.004Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/b1/87/41f3202e4193e3bacfc2c065fab7706ebe81af46a83d3e27605029c1f5a6/pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:c23e27686783f60290e36827f9c626e63154b82b116d7fe9adba1fda36da706c", size = 2132603, upload-time = "2025-11-04T13:40:13.868Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/49/7d/4c00df99cb12070b6bccdef4a195255e6020a550d572768d92cc54dba91a/pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_armv7l.whl", hash = "sha256:482c982f814460eabe1d3bb0adfdc583387bd4691ef00b90575ca0d2b6fe2294", size = 2329591, upload-time = "2025-11-04T13:40:15.672Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/cc/6a/ebf4b1d65d458f3cda6a7335d141305dfa19bdc61140a884d165a8a1bbc7/pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:bfea2a5f0b4d8d43adf9d7b8bf019fb46fdd10a2e5cde477fbcb9d1fa08c68e1", size = 2319068, upload-time = "2025-11-04T13:40:17.532Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/49/3b/774f2b5cd4192d5ab75870ce4381fd89cf218af999515baf07e7206753f0/pydantic_core-2.41.5-cp312-cp312-win32.whl", hash = "sha256:b74557b16e390ec12dca509bce9264c3bbd128f8a2c376eaa68003d7f327276d", size = 1985908, upload-time = "2025-11-04T13:40:19.309Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/86/45/00173a033c801cacf67c190fef088789394feaf88a98a7035b0e40d53dc9/pydantic_core-2.41.5-cp312-cp312-win_amd64.whl", hash = "sha256:1962293292865bca8e54702b08a4f26da73adc83dd1fcf26fbc875b35d81c815", size = 2020145, upload-time = "2025-11-04T13:40:21.548Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/f9/22/91fbc821fa6d261b376a3f73809f907cec5ca6025642c463d3488aad22fb/pydantic_core-2.41.5-cp312-cp312-win_arm64.whl", hash = "sha256:1746d4a3d9a794cacae06a5eaaccb4b8643a131d45fbc9af23e353dc0a5ba5c3", size = 1976179, upload-time = "2025-11-04T13:40:23.393Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/87/06/8806241ff1f70d9939f9af039c6c35f2360cf16e93c2ca76f184e76b1564/pydantic_core-2.41.5-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:941103c9be18ac8daf7b7adca8228f8ed6bb7a1849020f643b3a14d15b1924d9", size = 2120403, upload-time = "2025-11-04T13:40:25.248Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/94/02/abfa0e0bda67faa65fef1c84971c7e45928e108fe24333c81f3bfe35d5f5/pydantic_core-2.41.5-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:112e305c3314f40c93998e567879e887a3160bb8689ef3d2c04b6cc62c33ac34", size = 1896206, upload-time = "2025-11-04T13:40:27.099Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/15/df/a4c740c0943e93e6500f9eb23f4ca7ec9bf71b19e608ae5b579678c8d02f/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0cbaad15cb0c90aa221d43c00e77bb33c93e8d36e0bf74760cd00e732d10a6a0", size = 1919307, upload-time = "2025-11-04T13:40:29.806Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/9a/e3/6324802931ae1d123528988e0e86587c2072ac2e5394b4bc2bc34b61ff6e/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:03ca43e12fab6023fc79d28ca6b39b05f794ad08ec2feccc59a339b02f2b3d33", size = 2063258, upload-time = "2025-11-04T13:40:33.544Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/c9/d4/2230d7151d4957dd79c3044ea26346c148c98fbf0ee6ebd41056f2d62ab5/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:dc799088c08fa04e43144b164feb0c13f9a0bc40503f8df3e9fde58a3c0c101e", size = 2214917, upload-time = "2025-11-04T13:40:35.479Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/e6/9f/eaac5df17a3672fef0081b6c1bb0b82b33ee89aa5cec0d7b05f52fd4a1fa/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:97aeba56665b4c3235a0e52b2c2f5ae9cd071b8a8310ad27bddb3f7fb30e9aa2", size = 2332186, upload-time = "2025-11-04T13:40:37.436Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/cf/4e/35a80cae583a37cf15604b44240e45c05e04e86f9cfd766623149297e971/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:406bf18d345822d6c21366031003612b9c77b3e29ffdb0f612367352aab7d586", size = 2073164, upload-time = "2025-11-04T13:40:40.289Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/bf/e3/f6e262673c6140dd3305d144d032f7bd5f7497d3871c1428521f19f9efa2/pydantic_core-2.41.5-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:b93590ae81f7010dbe380cdeab6f515902ebcbefe0b9327cc4804d74e93ae69d", size = 2179146, upload-time = "2025-11-04T13:40:42.809Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/75/c7/20bd7fc05f0c6ea2056a4565c6f36f8968c0924f19b7d97bbfea55780e73/pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:01a3d0ab748ee531f4ea6c3e48ad9dac84ddba4b0d82291f87248f2f9de8d740", size = 2137788, upload-time = "2025-11-04T13:40:44.752Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/3a/8d/34318ef985c45196e004bc46c6eab2eda437e744c124ef0dbe1ff2c9d06b/pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_armv7l.whl", hash = "sha256:6561e94ba9dacc9c61bce40e2d6bdc3bfaa0259d3ff36ace3b1e6901936d2e3e", size = 2340133, upload-time = "2025-11-04T13:40:46.66Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/9c/59/013626bf8c78a5a5d9350d12e7697d3d4de951a75565496abd40ccd46bee/pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:915c3d10f81bec3a74fbd4faebe8391013ba61e5a1a8d48c4455b923bdda7858", size = 2324852, upload-time = "2025-11-04T13:40:48.575Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/1a/d9/c248c103856f807ef70c18a4f986693a46a8ffe1602e5d361485da502d20/pydantic_core-2.41.5-cp313-cp313-win32.whl", hash = "sha256:650ae77860b45cfa6e2cdafc42618ceafab3a2d9a3811fcfbd3bbf8ac3c40d36", size = 1994679, upload-time = "2025-11-04T13:40:50.619Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/9e/8b/341991b158ddab181cff136acd2552c9f35bd30380422a639c0671e99a91/pydantic_core-2.41.5-cp313-cp313-win_amd64.whl", hash = "sha256:79ec52ec461e99e13791ec6508c722742ad745571f234ea6255bed38c6480f11", size = 2019766, upload-time = "2025-11-04T13:40:52.631Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/73/7d/f2f9db34af103bea3e09735bb40b021788a5e834c81eedb541991badf8f5/pydantic_core-2.41.5-cp313-cp313-win_arm64.whl", hash = "sha256:3f84d5c1b4ab906093bdc1ff10484838aca54ef08de4afa9de0f5f14d69639cd", size = 1981005, upload-time = "2025-11-04T13:40:54.734Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/ea/28/46b7c5c9635ae96ea0fbb779e271a38129df2550f763937659ee6c5dbc65/pydantic_core-2.41.5-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:3f37a19d7ebcdd20b96485056ba9e8b304e27d9904d233d7b1015db320e51f0a", size = 2119622, upload-time = "2025-11-04T13:40:56.68Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/74/1a/145646e5687e8d9a1e8d09acb278c8535ebe9e972e1f162ed338a622f193/pydantic_core-2.41.5-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:1d1d9764366c73f996edd17abb6d9d7649a7eb690006ab6adbda117717099b14", size = 1891725, upload-time = "2025-11-04T13:40:58.807Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/23/04/e89c29e267b8060b40dca97bfc64a19b2a3cf99018167ea1677d96368273/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:25e1c2af0fce638d5f1988b686f3b3ea8cd7de5f244ca147c777769e798a9cd1", size = 1915040, upload-time = "2025-11-04T13:41:00.853Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/84/a3/15a82ac7bd97992a82257f777b3583d3e84bdb06ba6858f745daa2ec8a85/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:506d766a8727beef16b7adaeb8ee6217c64fc813646b424d0804d67c16eddb66", size = 2063691, upload-time = "2025-11-04T13:41:03.504Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/74/9b/0046701313c6ef08c0c1cf0e028c67c770a4e1275ca73131563c5f2a310a/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:4819fa52133c9aa3c387b3328f25c1facc356491e6135b459f1de698ff64d869", size = 2213897, upload-time = "2025-11-04T13:41:05.804Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/8a/cd/6bac76ecd1b27e75a95ca3a9a559c643b3afcd2dd62086d4b7a32a18b169/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:2b761d210c9ea91feda40d25b4efe82a1707da2ef62901466a42492c028553a2", size = 2333302, upload-time = "2025-11-04T13:41:07.809Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/4c/d2/ef2074dc020dd6e109611a8be4449b98cd25e1b9b8a303c2f0fca2f2bcf7/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:22f0fb8c1c583a3b6f24df2470833b40207e907b90c928cc8d3594b76f874375", size = 2064877, upload-time = "2025-11-04T13:41:09.827Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/18/66/e9db17a9a763d72f03de903883c057b2592c09509ccfe468187f2a2eef29/pydantic_core-2.41.5-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:2782c870e99878c634505236d81e5443092fba820f0373997ff75f90f68cd553", size = 2180680, upload-time = "2025-11-04T13:41:12.379Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/d3/9e/3ce66cebb929f3ced22be85d4c2399b8e85b622db77dad36b73c5387f8f8/pydantic_core-2.41.5-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:0177272f88ab8312479336e1d777f6b124537d47f2123f89cb37e0accea97f90", size = 2138960, upload-time = "2025-11-04T13:41:14.627Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/a6/62/205a998f4327d2079326b01abee48e502ea739d174f0a89295c481a2272e/pydantic_core-2.41.5-cp314-cp314-musllinux_1_1_armv7l.whl", hash = "sha256:63510af5e38f8955b8ee5687740d6ebf7c2a0886d15a6d65c32814613681bc07", size = 2339102, upload-time = "2025-11-04T13:41:16.868Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/3c/0d/f05e79471e889d74d3d88f5bd20d0ed189ad94c2423d81ff8d0000aab4ff/pydantic_core-2.41.5-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:e56ba91f47764cc14f1daacd723e3e82d1a89d783f0f5afe9c364b8bb491ccdb", size = 2326039, upload-time = "2025-11-04T13:41:18.934Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/ec/e1/e08a6208bb100da7e0c4b288eed624a703f4d129bde2da475721a80cab32/pydantic_core-2.41.5-cp314-cp314-win32.whl", hash = "sha256:aec5cf2fd867b4ff45b9959f8b20ea3993fc93e63c7363fe6851424c8a7e7c23", size = 1995126, upload-time = "2025-11-04T13:41:21.418Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/48/5d/56ba7b24e9557f99c9237e29f5c09913c81eeb2f3217e40e922353668092/pydantic_core-2.41.5-cp314-cp314-win_amd64.whl", hash = "sha256:8e7c86f27c585ef37c35e56a96363ab8de4e549a95512445b85c96d3e2f7c1bf", size = 2015489, upload-time = "2025-11-04T13:41:24.076Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/4e/bb/f7a190991ec9e3e0ba22e4993d8755bbc4a32925c0b5b42775c03e8148f9/pydantic_core-2.41.5-cp314-cp314-win_arm64.whl", hash = "sha256:e672ba74fbc2dc8eea59fb6d4aed6845e6905fc2a8afe93175d94a83ba2a01a0", size = 1977288, upload-time = "2025-11-04T13:41:26.33Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/92/ed/77542d0c51538e32e15afe7899d79efce4b81eee631d99850edc2f5e9349/pydantic_core-2.41.5-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:8566def80554c3faa0e65ac30ab0932b9e3a5cd7f8323764303d468e5c37595a", size = 2120255, upload-time = "2025-11-04T13:41:28.569Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/bb/3d/6913dde84d5be21e284439676168b28d8bbba5600d838b9dca99de0fad71/pydantic_core-2.41.5-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:b80aa5095cd3109962a298ce14110ae16b8c1aece8b72f9dafe81cf597ad80b3", size = 1863760, upload-time = "2025-11-04T13:41:31.055Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/5a/f0/e5e6b99d4191da102f2b0eb9687aaa7f5bea5d9964071a84effc3e40f997/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3006c3dd9ba34b0c094c544c6006cc79e87d8612999f1a5d43b769b89181f23c", size = 1878092, upload-time = "2025-11-04T13:41:33.21Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/71/48/36fb760642d568925953bcc8116455513d6e34c4beaa37544118c36aba6d/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:72f6c8b11857a856bcfa48c86f5368439f74453563f951e473514579d44aa612", size = 2053385, upload-time = "2025-11-04T13:41:35.508Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/20/25/92dc684dd8eb75a234bc1c764b4210cf2646479d54b47bf46061657292a8/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5cb1b2f9742240e4bb26b652a5aeb840aa4b417c7748b6f8387927bc6e45e40d", size = 2218832, upload-time = "2025-11-04T13:41:37.732Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/e2/09/f53e0b05023d3e30357d82eb35835d0f6340ca344720a4599cd663dca599/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:bd3d54f38609ff308209bd43acea66061494157703364ae40c951f83ba99a1a9", size = 2327585, upload-time = "2025-11-04T13:41:40Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/aa/4e/2ae1aa85d6af35a39b236b1b1641de73f5a6ac4d5a7509f77b814885760c/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:2ff4321e56e879ee8d2a879501c8e469414d948f4aba74a2d4593184eb326660", size = 2041078, upload-time = "2025-11-04T13:41:42.323Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/cd/13/2e215f17f0ef326fc72afe94776edb77525142c693767fc347ed6288728d/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d0d2568a8c11bf8225044aa94409e21da0cb09dcdafe9ecd10250b2baad531a9", size = 2173914, upload-time = "2025-11-04T13:41:45.221Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/02/7a/f999a6dcbcd0e5660bc348a3991c8915ce6599f4f2c6ac22f01d7a10816c/pydantic_core-2.41.5-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:a39455728aabd58ceabb03c90e12f71fd30fa69615760a075b9fec596456ccc3", size = 2129560, upload-time = "2025-11-04T13:41:47.474Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/3a/b1/6c990ac65e3b4c079a4fb9f5b05f5b013afa0f4ed6780a3dd236d2cbdc64/pydantic_core-2.41.5-cp314-cp314t-musllinux_1_1_armv7l.whl", hash = "sha256:239edca560d05757817c13dc17c50766136d21f7cd0fac50295499ae24f90fdf", size = 2329244, upload-time = "2025-11-04T13:41:49.992Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/d9/02/3c562f3a51afd4d88fff8dffb1771b30cfdfd79befd9883ee094f5b6c0d8/pydantic_core-2.41.5-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:2a5e06546e19f24c6a96a129142a75cee553cc018ffee48a460059b1185f4470", size = 2331955, upload-time = "2025-11-04T13:41:54.079Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/5c/96/5fb7d8c3c17bc8c62fdb031c47d77a1af698f1d7a406b0f79aaa1338f9ad/pydantic_core-2.41.5-cp314-cp314t-win32.whl", hash = "sha256:b4ececa40ac28afa90871c2cc2b9ffd2ff0bf749380fbdf57d165fd23da353aa", size = 1988906, upload-time = "2025-11-04T13:41:56.606Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/22/ed/182129d83032702912c2e2d8bbe33c036f342cc735737064668585dac28f/pydantic_core-2.41.5-cp314-cp314t-win_amd64.whl", hash = "sha256:80aa89cad80b32a912a65332f64a4450ed00966111b6615ca6816153d3585a8c", size = 1981607, upload-time = "2025-11-04T13:41:58.889Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/9f/ed/068e41660b832bb0b1aa5b58011dea2a3fe0ba7861ff38c4d4904c1c1a99/pydantic_core-2.41.5-cp314-cp314t-win_arm64.whl", hash = "sha256:35b44f37a3199f771c3eaa53051bc8a70cd7b54f333531c59e29fd4db5d15008", size = 1974769, upload-time = "2025-11-04T13:42:01.186Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/11/72/90fda5ee3b97e51c494938a4a44c3a35a9c96c19bba12372fb9c634d6f57/pydantic_core-2.41.5-graalpy311-graalpy242_311_native-macosx_10_12_x86_64.whl", hash = "sha256:b96d5f26b05d03cc60f11a7761a5ded1741da411e7fe0909e27a5e6a0cb7b034", size = 2115441, upload-time = "2025-11-04T13:42:39.557Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/1f/53/8942f884fa33f50794f119012dc6a1a02ac43a56407adaac20463df8e98f/pydantic_core-2.41.5-graalpy311-graalpy242_311_native-macosx_11_0_arm64.whl", hash = "sha256:634e8609e89ceecea15e2d61bc9ac3718caaaa71963717bf3c8f38bfde64242c", size = 1930291, upload-time = "2025-11-04T13:42:42.169Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/79/c8/ecb9ed9cd942bce09fc888ee960b52654fbdbede4ba6c2d6e0d3b1d8b49c/pydantic_core-2.41.5-graalpy311-graalpy242_311_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:93e8740d7503eb008aa2df04d3b9735f845d43ae845e6dcd2be0b55a2da43cd2", size = 1948632, upload-time = "2025-11-04T13:42:44.564Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/2e/1b/687711069de7efa6af934e74f601e2a4307365e8fdc404703afc453eab26/pydantic_core-2.41.5-graalpy311-graalpy242_311_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f15489ba13d61f670dcc96772e733aad1a6f9c429cc27574c6cdaed82d0146ad", size = 2138905, upload-time = "2025-11-04T13:42:47.156Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/09/32/59b0c7e63e277fa7911c2fc70ccfb45ce4b98991e7ef37110663437005af/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-macosx_10_12_x86_64.whl", hash = "sha256:7da7087d756b19037bc2c06edc6c170eeef3c3bafcb8f532ff17d64dc427adfd", size = 2110495, upload-time = "2025-11-04T13:42:49.689Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/aa/81/05e400037eaf55ad400bcd318c05bb345b57e708887f07ddb2d20e3f0e98/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-macosx_11_0_arm64.whl", hash = "sha256:aabf5777b5c8ca26f7824cb4a120a740c9588ed58df9b2d196ce92fba42ff8dc", size = 1915388, upload-time = "2025-11-04T13:42:52.215Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/6e/0d/e3549b2399f71d56476b77dbf3cf8937cec5cd70536bdc0e374a421d0599/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c007fe8a43d43b3969e8469004e9845944f1a80e6acd47c150856bb87f230c56", size = 1942879, upload-time = "2025-11-04T13:42:56.483Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/f7/07/34573da085946b6a313d7c42f82f16e8920bfd730665de2d11c0c37a74b5/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:76d0819de158cd855d1cbb8fcafdf6f5cf1eb8e470abe056d5d161106e38062b", size = 2139017, upload-time = "2025-11-04T13:42:59.471Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/5f/9b/1b3f0e9f9305839d7e84912f9e8bfbd191ed1b1ef48083609f0dabde978c/pydantic_core-2.41.5-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:b2379fa7ed44ddecb5bfe4e48577d752db9fc10be00a6b7446e9663ba143de26", size = 2101980, upload-time = "2025-11-04T13:43:25.97Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/a4/ed/d71fefcb4263df0da6a85b5d8a7508360f2f2e9b3bf5814be9c8bccdccc1/pydantic_core-2.41.5-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:266fb4cbf5e3cbd0b53669a6d1b039c45e3ce651fd5442eff4d07c2cc8d66808", size = 1923865, upload-time = "2025-11-04T13:43:28.763Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/ce/3a/626b38db460d675f873e4444b4bb030453bbe7b4ba55df821d026a0493c4/pydantic_core-2.41.5-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:58133647260ea01e4d0500089a8c4f07bd7aa6ce109682b1426394988d8aaacc", size = 2134256, upload-time = "2025-11-04T13:43:31.71Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/83/d9/8412d7f06f616bbc053d30cb4e5f76786af3221462ad5eee1f202021eb4e/pydantic_core-2.41.5-pp311-pypy311_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:287dad91cfb551c363dc62899a80e9e14da1f0e2b6ebde82c806612ca2a13ef1", size = 2174762, upload-time = "2025-11-04T13:43:34.744Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/55/4c/162d906b8e3ba3a99354e20faa1b49a85206c47de97a639510a0e673f5da/pydantic_core-2.41.5-pp311-pypy311_pp73-musllinux_1_1_aarch64.whl", hash = "sha256:03b77d184b9eb40240ae9fd676ca364ce1085f203e1b1256f8ab9984dca80a84", size = 2143141, upload-time = "2025-11-04T13:43:37.701Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/1f/f2/f11dd73284122713f5f89fc940f370d035fa8e1e078d446b3313955157fe/pydantic_core-2.41.5-pp311-pypy311_pp73-musllinux_1_1_armv7l.whl", hash = "sha256:a668ce24de96165bb239160b3d854943128f4334822900534f2fe947930e5770", size = 2330317, upload-time = "2025-11-04T13:43:40.406Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/88/9d/b06ca6acfe4abb296110fb1273a4d848a0bfb2ff65f3ee92127b3244e16b/pydantic_core-2.41.5-pp311-pypy311_pp73-musllinux_1_1_x86_64.whl", hash = "sha256:f14f8f046c14563f8eb3f45f499cc658ab8d10072961e07225e507adb700e93f", size = 2316992, upload-time = "2025-11-04T13:43:43.602Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/36/c7/cfc8e811f061c841d7990b0201912c3556bfeb99cdcb7ed24adc8d6f8704/pydantic_core-2.41.5-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:56121965f7a4dc965bff783d70b907ddf3d57f6eba29b6d2e5dabfaf07799c51", size = 2145302, upload-time = "2025-11-04T13:43:46.64Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "pydantic-settings"
|
||||
version = "2.12.0"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
dependencies = [
|
||||
{ name = "pydantic" },
|
||||
{ name = "python-dotenv" },
|
||||
{ name = "typing-inspection" },
|
||||
]
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/43/4b/ac7e0aae12027748076d72a8764ff1c9d82ca75a7a52622e67ed3f765c54/pydantic_settings-2.12.0.tar.gz", hash = "sha256:005538ef951e3c2a68e1c08b292b5f2e71490def8589d4221b95dab00dafcfd0", size = 194184, upload-time = "2025-11-10T14:25:47.013Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/c1/60/5d4751ba3f4a40a6891f24eec885f51afd78d208498268c734e256fb13c4/pydantic_settings-2.12.0-py3-none-any.whl", hash = "sha256:fddb9fd99a5b18da837b29710391e945b1e30c135477f484084ee513adb93809", size = 51880, upload-time = "2025-11-10T14:25:45.546Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "pygments"
|
||||
version = "2.19.2"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/b0/77/a5b8c569bf593b0140bde72ea885a803b82086995367bf2037de0159d924/pygments-2.19.2.tar.gz", hash = "sha256:636cb2477cec7f8952536970bc533bc43743542f70392ae026374600add5b887", size = 4968631, upload-time = "2025-06-21T13:39:12.283Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/c7/21/705964c7812476f378728bdf590ca4b771ec72385c533964653c68e86bdc/pygments-2.19.2-py3-none-any.whl", hash = "sha256:86540386c03d588bb81d44bc3928634ff26449851e99741617ecb9037ee5ec0b", size = 1225217, upload-time = "2025-06-21T13:39:07.939Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "pyjwt"
|
||||
version = "2.10.1"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/e7/46/bd74733ff231675599650d3e47f361794b22ef3e3770998dda30d3b63726/pyjwt-2.10.1.tar.gz", hash = "sha256:3cc5772eb20009233caf06e9d8a0577824723b44e6648ee0a2aedb6cf9381953", size = 87785, upload-time = "2024-11-28T03:43:29.933Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/61/ad/689f02752eeec26aed679477e80e632ef1b682313be70793d798c1d5fc8f/PyJWT-2.10.1-py3-none-any.whl", hash = "sha256:dcdd193e30abefd5debf142f9adfcdd2b58004e644f25406ffaebd50bd98dacb", size = 22997, upload-time = "2024-11-28T03:43:27.893Z" },
|
||||
]
|
||||
|
||||
[package.optional-dependencies]
|
||||
crypto = [
|
||||
{ name = "cryptography" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "pytest"
|
||||
version = "9.0.2"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
dependencies = [
|
||||
{ name = "colorama", marker = "sys_platform == 'win32'" },
|
||||
{ name = "iniconfig" },
|
||||
{ name = "packaging" },
|
||||
{ name = "pluggy" },
|
||||
{ name = "pygments" },
|
||||
]
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/d1/db/7ef3487e0fb0049ddb5ce41d3a49c235bf9ad299b6a25d5780a89f19230f/pytest-9.0.2.tar.gz", hash = "sha256:75186651a92bd89611d1d9fc20f0b4345fd827c41ccd5c299a868a05d70edf11", size = 1568901, upload-time = "2025-12-06T21:30:51.014Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/3b/ab/b3226f0bd7cdcf710fbede2b3548584366da3b19b5021e74f5bde2a8fa3f/pytest-9.0.2-py3-none-any.whl", hash = "sha256:711ffd45bf766d5264d487b917733b453d917afd2b0ad65223959f59089f875b", size = 374801, upload-time = "2025-12-06T21:30:49.154Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "pytest-asyncio"
|
||||
version = "1.3.0"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
dependencies = [
|
||||
{ name = "pytest" },
|
||||
{ name = "typing-extensions", marker = "python_full_version < '3.13'" },
|
||||
]
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/90/2c/8af215c0f776415f3590cac4f9086ccefd6fd463befeae41cd4d3f193e5a/pytest_asyncio-1.3.0.tar.gz", hash = "sha256:d7f52f36d231b80ee124cd216ffb19369aa168fc10095013c6b014a34d3ee9e5", size = 50087, upload-time = "2025-11-10T16:07:47.256Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/e5/35/f8b19922b6a25bc0880171a2f1a003eaeb93657475193ab516fd87cac9da/pytest_asyncio-1.3.0-py3-none-any.whl", hash = "sha256:611e26147c7f77640e6d0a92a38ed17c3e9848063698d5c93d5aa7aa11cebff5", size = 15075, upload-time = "2025-11-10T16:07:45.537Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "python-dotenv"
|
||||
version = "1.2.1"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/f0/26/19cadc79a718c5edbec86fd4919a6b6d3f681039a2f6d66d14be94e75fb9/python_dotenv-1.2.1.tar.gz", hash = "sha256:42667e897e16ab0d66954af0e60a9caa94f0fd4ecf3aaf6d2d260eec1aa36ad6", size = 44221, upload-time = "2025-10-26T15:12:10.434Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/14/1b/a298b06749107c305e1fe0f814c6c74aea7b2f1e10989cb30f544a1b3253/python_dotenv-1.2.1-py3-none-any.whl", hash = "sha256:b81ee9561e9ca4004139c6cbba3a238c32b03e4894671e181b671e8cb8425d61", size = 21230, upload-time = "2025-10-26T15:12:09.109Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "python-multipart"
|
||||
version = "0.0.21"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/78/96/804520d0850c7db98e5ccb70282e29208723f0964e88ffd9d0da2f52ea09/python_multipart-0.0.21.tar.gz", hash = "sha256:7137ebd4d3bbf70ea1622998f902b97a29434a9e8dc40eb203bbcf7c2a2cba92", size = 37196, upload-time = "2025-12-17T09:24:22.446Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/aa/76/03af049af4dcee5d27442f71b6924f01f3efb5d2bd34f23fcd563f2cc5f5/python_multipart-0.0.21-py3-none-any.whl", hash = "sha256:cf7a6713e01c87aa35387f4774e812c4361150938d20d232800f75ffcf266090", size = 24541, upload-time = "2025-12-17T09:24:21.153Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "pywin32"
|
||||
version = "311"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/7c/af/449a6a91e5d6db51420875c54f6aff7c97a86a3b13a0b4f1a5c13b988de3/pywin32-311-cp311-cp311-win32.whl", hash = "sha256:184eb5e436dea364dcd3d2316d577d625c0351bf237c4e9a5fabbcfa5a58b151", size = 8697031, upload-time = "2025-07-14T20:13:13.266Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/51/8f/9bb81dd5bb77d22243d33c8397f09377056d5c687aa6d4042bea7fbf8364/pywin32-311-cp311-cp311-win_amd64.whl", hash = "sha256:3ce80b34b22b17ccbd937a6e78e7225d80c52f5ab9940fe0506a1a16f3dab503", size = 9508308, upload-time = "2025-07-14T20:13:15.147Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/44/7b/9c2ab54f74a138c491aba1b1cd0795ba61f144c711daea84a88b63dc0f6c/pywin32-311-cp311-cp311-win_arm64.whl", hash = "sha256:a733f1388e1a842abb67ffa8e7aad0e70ac519e09b0f6a784e65a136ec7cefd2", size = 8703930, upload-time = "2025-07-14T20:13:16.945Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/e7/ab/01ea1943d4eba0f850c3c61e78e8dd59757ff815ff3ccd0a84de5f541f42/pywin32-311-cp312-cp312-win32.whl", hash = "sha256:750ec6e621af2b948540032557b10a2d43b0cee2ae9758c54154d711cc852d31", size = 8706543, upload-time = "2025-07-14T20:13:20.765Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/d1/a8/a0e8d07d4d051ec7502cd58b291ec98dcc0c3fff027caad0470b72cfcc2f/pywin32-311-cp312-cp312-win_amd64.whl", hash = "sha256:b8c095edad5c211ff31c05223658e71bf7116daa0ecf3ad85f3201ea3190d067", size = 9495040, upload-time = "2025-07-14T20:13:22.543Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/ba/3a/2ae996277b4b50f17d61f0603efd8253cb2d79cc7ae159468007b586396d/pywin32-311-cp312-cp312-win_arm64.whl", hash = "sha256:e286f46a9a39c4a18b319c28f59b61de793654af2f395c102b4f819e584b5852", size = 8710102, upload-time = "2025-07-14T20:13:24.682Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/a5/be/3fd5de0979fcb3994bfee0d65ed8ca9506a8a1260651b86174f6a86f52b3/pywin32-311-cp313-cp313-win32.whl", hash = "sha256:f95ba5a847cba10dd8c4d8fefa9f2a6cf283b8b88ed6178fa8a6c1ab16054d0d", size = 8705700, upload-time = "2025-07-14T20:13:26.471Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/e3/28/e0a1909523c6890208295a29e05c2adb2126364e289826c0a8bc7297bd5c/pywin32-311-cp313-cp313-win_amd64.whl", hash = "sha256:718a38f7e5b058e76aee1c56ddd06908116d35147e133427e59a3983f703a20d", size = 9494700, upload-time = "2025-07-14T20:13:28.243Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/04/bf/90339ac0f55726dce7d794e6d79a18a91265bdf3aa70b6b9ca52f35e022a/pywin32-311-cp313-cp313-win_arm64.whl", hash = "sha256:7b4075d959648406202d92a2310cb990fea19b535c7f4a78d3f5e10b926eeb8a", size = 8709318, upload-time = "2025-07-14T20:13:30.348Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/c9/31/097f2e132c4f16d99a22bfb777e0fd88bd8e1c634304e102f313af69ace5/pywin32-311-cp314-cp314-win32.whl", hash = "sha256:b7a2c10b93f8986666d0c803ee19b5990885872a7de910fc460f9b0c2fbf92ee", size = 8840714, upload-time = "2025-07-14T20:13:32.449Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/90/4b/07c77d8ba0e01349358082713400435347df8426208171ce297da32c313d/pywin32-311-cp314-cp314-win_amd64.whl", hash = "sha256:3aca44c046bd2ed8c90de9cb8427f581c479e594e99b5c0bb19b29c10fd6cb87", size = 9656800, upload-time = "2025-07-14T20:13:34.312Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/c0/d2/21af5c535501a7233e734b8af901574572da66fcc254cb35d0609c9080dd/pywin32-311-cp314-cp314-win_arm64.whl", hash = "sha256:a508e2d9025764a8270f93111a970e1d0fbfc33f4153b388bb649b7eec4f9b42", size = 8932540, upload-time = "2025-07-14T20:13:36.379Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "pyyaml"
|
||||
version = "6.0.3"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/05/8e/961c0007c59b8dd7729d542c61a4d537767a59645b82a0b521206e1e25c2/pyyaml-6.0.3.tar.gz", hash = "sha256:d76623373421df22fb4cf8817020cbb7ef15c725b9d5e45f17e189bfc384190f", size = 130960, upload-time = "2025-09-25T21:33:16.546Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/6d/16/a95b6757765b7b031c9374925bb718d55e0a9ba8a1b6a12d25962ea44347/pyyaml-6.0.3-cp311-cp311-macosx_10_13_x86_64.whl", hash = "sha256:44edc647873928551a01e7a563d7452ccdebee747728c1080d881d68af7b997e", size = 185826, upload-time = "2025-09-25T21:31:58.655Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/16/19/13de8e4377ed53079ee996e1ab0a9c33ec2faf808a4647b7b4c0d46dd239/pyyaml-6.0.3-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:652cb6edd41e718550aad172851962662ff2681490a8a711af6a4d288dd96824", size = 175577, upload-time = "2025-09-25T21:32:00.088Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/0c/62/d2eb46264d4b157dae1275b573017abec435397aa59cbcdab6fc978a8af4/pyyaml-6.0.3-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:10892704fc220243f5305762e276552a0395f7beb4dbf9b14ec8fd43b57f126c", size = 775556, upload-time = "2025-09-25T21:32:01.31Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/10/cb/16c3f2cf3266edd25aaa00d6c4350381c8b012ed6f5276675b9eba8d9ff4/pyyaml-6.0.3-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:850774a7879607d3a6f50d36d04f00ee69e7fc816450e5f7e58d7f17f1ae5c00", size = 882114, upload-time = "2025-09-25T21:32:03.376Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/71/60/917329f640924b18ff085ab889a11c763e0b573da888e8404ff486657602/pyyaml-6.0.3-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b8bb0864c5a28024fac8a632c443c87c5aa6f215c0b126c449ae1a150412f31d", size = 806638, upload-time = "2025-09-25T21:32:04.553Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/dd/6f/529b0f316a9fd167281a6c3826b5583e6192dba792dd55e3203d3f8e655a/pyyaml-6.0.3-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:1d37d57ad971609cf3c53ba6a7e365e40660e3be0e5175fa9f2365a379d6095a", size = 767463, upload-time = "2025-09-25T21:32:06.152Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/f2/6a/b627b4e0c1dd03718543519ffb2f1deea4a1e6d42fbab8021936a4d22589/pyyaml-6.0.3-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:37503bfbfc9d2c40b344d06b2199cf0e96e97957ab1c1b546fd4f87e53e5d3e4", size = 794986, upload-time = "2025-09-25T21:32:07.367Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/45/91/47a6e1c42d9ee337c4839208f30d9f09caa9f720ec7582917b264defc875/pyyaml-6.0.3-cp311-cp311-win32.whl", hash = "sha256:8098f252adfa6c80ab48096053f512f2321f0b998f98150cea9bd23d83e1467b", size = 142543, upload-time = "2025-09-25T21:32:08.95Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/da/e3/ea007450a105ae919a72393cb06f122f288ef60bba2dc64b26e2646fa315/pyyaml-6.0.3-cp311-cp311-win_amd64.whl", hash = "sha256:9f3bfb4965eb874431221a3ff3fdcddc7e74e3b07799e0e84ca4a0f867d449bf", size = 158763, upload-time = "2025-09-25T21:32:09.96Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/d1/33/422b98d2195232ca1826284a76852ad5a86fe23e31b009c9886b2d0fb8b2/pyyaml-6.0.3-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:7f047e29dcae44602496db43be01ad42fc6f1cc0d8cd6c83d342306c32270196", size = 182063, upload-time = "2025-09-25T21:32:11.445Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/89/a0/6cf41a19a1f2f3feab0e9c0b74134aa2ce6849093d5517a0c550fe37a648/pyyaml-6.0.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:fc09d0aa354569bc501d4e787133afc08552722d3ab34836a80547331bb5d4a0", size = 173973, upload-time = "2025-09-25T21:32:12.492Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/ed/23/7a778b6bd0b9a8039df8b1b1d80e2e2ad78aa04171592c8a5c43a56a6af4/pyyaml-6.0.3-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9149cad251584d5fb4981be1ecde53a1ca46c891a79788c0df828d2f166bda28", size = 775116, upload-time = "2025-09-25T21:32:13.652Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/65/30/d7353c338e12baef4ecc1b09e877c1970bd3382789c159b4f89d6a70dc09/pyyaml-6.0.3-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5fdec68f91a0c6739b380c83b951e2c72ac0197ace422360e6d5a959d8d97b2c", size = 844011, upload-time = "2025-09-25T21:32:15.21Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/8b/9d/b3589d3877982d4f2329302ef98a8026e7f4443c765c46cfecc8858c6b4b/pyyaml-6.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ba1cc08a7ccde2d2ec775841541641e4548226580ab850948cbfda66a1befcdc", size = 807870, upload-time = "2025-09-25T21:32:16.431Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/05/c0/b3be26a015601b822b97d9149ff8cb5ead58c66f981e04fedf4e762f4bd4/pyyaml-6.0.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:8dc52c23056b9ddd46818a57b78404882310fb473d63f17b07d5c40421e47f8e", size = 761089, upload-time = "2025-09-25T21:32:17.56Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/be/8e/98435a21d1d4b46590d5459a22d88128103f8da4c2d4cb8f14f2a96504e1/pyyaml-6.0.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:41715c910c881bc081f1e8872880d3c650acf13dfa8214bad49ed4cede7c34ea", size = 790181, upload-time = "2025-09-25T21:32:18.834Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/74/93/7baea19427dcfbe1e5a372d81473250b379f04b1bd3c4c5ff825e2327202/pyyaml-6.0.3-cp312-cp312-win32.whl", hash = "sha256:96b533f0e99f6579b3d4d4995707cf36df9100d67e0c8303a0c55b27b5f99bc5", size = 137658, upload-time = "2025-09-25T21:32:20.209Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/86/bf/899e81e4cce32febab4fb42bb97dcdf66bc135272882d1987881a4b519e9/pyyaml-6.0.3-cp312-cp312-win_amd64.whl", hash = "sha256:5fcd34e47f6e0b794d17de1b4ff496c00986e1c83f7ab2fb8fcfe9616ff7477b", size = 154003, upload-time = "2025-09-25T21:32:21.167Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/1a/08/67bd04656199bbb51dbed1439b7f27601dfb576fb864099c7ef0c3e55531/pyyaml-6.0.3-cp312-cp312-win_arm64.whl", hash = "sha256:64386e5e707d03a7e172c0701abfb7e10f0fb753ee1d773128192742712a98fd", size = 140344, upload-time = "2025-09-25T21:32:22.617Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/d1/11/0fd08f8192109f7169db964b5707a2f1e8b745d4e239b784a5a1dd80d1db/pyyaml-6.0.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:8da9669d359f02c0b91ccc01cac4a67f16afec0dac22c2ad09f46bee0697eba8", size = 181669, upload-time = "2025-09-25T21:32:23.673Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/b1/16/95309993f1d3748cd644e02e38b75d50cbc0d9561d21f390a76242ce073f/pyyaml-6.0.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:2283a07e2c21a2aa78d9c4442724ec1eb15f5e42a723b99cb3d822d48f5f7ad1", size = 173252, upload-time = "2025-09-25T21:32:25.149Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/50/31/b20f376d3f810b9b2371e72ef5adb33879b25edb7a6d072cb7ca0c486398/pyyaml-6.0.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ee2922902c45ae8ccada2c5b501ab86c36525b883eff4255313a253a3160861c", size = 767081, upload-time = "2025-09-25T21:32:26.575Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/49/1e/a55ca81e949270d5d4432fbbd19dfea5321eda7c41a849d443dc92fd1ff7/pyyaml-6.0.3-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a33284e20b78bd4a18c8c2282d549d10bc8408a2a7ff57653c0cf0b9be0afce5", size = 841159, upload-time = "2025-09-25T21:32:27.727Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/74/27/e5b8f34d02d9995b80abcef563ea1f8b56d20134d8f4e5e81733b1feceb2/pyyaml-6.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0f29edc409a6392443abf94b9cf89ce99889a1dd5376d94316ae5145dfedd5d6", size = 801626, upload-time = "2025-09-25T21:32:28.878Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/f9/11/ba845c23988798f40e52ba45f34849aa8a1f2d4af4b798588010792ebad6/pyyaml-6.0.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f7057c9a337546edc7973c0d3ba84ddcdf0daa14533c2065749c9075001090e6", size = 753613, upload-time = "2025-09-25T21:32:30.178Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/3d/e0/7966e1a7bfc0a45bf0a7fb6b98ea03fc9b8d84fa7f2229e9659680b69ee3/pyyaml-6.0.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:eda16858a3cab07b80edaf74336ece1f986ba330fdb8ee0d6c0d68fe82bc96be", size = 794115, upload-time = "2025-09-25T21:32:31.353Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/de/94/980b50a6531b3019e45ddeada0626d45fa85cbe22300844a7983285bed3b/pyyaml-6.0.3-cp313-cp313-win32.whl", hash = "sha256:d0eae10f8159e8fdad514efdc92d74fd8d682c933a6dd088030f3834bc8e6b26", size = 137427, upload-time = "2025-09-25T21:32:32.58Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/97/c9/39d5b874e8b28845e4ec2202b5da735d0199dbe5b8fb85f91398814a9a46/pyyaml-6.0.3-cp313-cp313-win_amd64.whl", hash = "sha256:79005a0d97d5ddabfeeea4cf676af11e647e41d81c9a7722a193022accdb6b7c", size = 154090, upload-time = "2025-09-25T21:32:33.659Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/73/e8/2bdf3ca2090f68bb3d75b44da7bbc71843b19c9f2b9cb9b0f4ab7a5a4329/pyyaml-6.0.3-cp313-cp313-win_arm64.whl", hash = "sha256:5498cd1645aa724a7c71c8f378eb29ebe23da2fc0d7a08071d89469bf1d2defb", size = 140246, upload-time = "2025-09-25T21:32:34.663Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/9d/8c/f4bd7f6465179953d3ac9bc44ac1a8a3e6122cf8ada906b4f96c60172d43/pyyaml-6.0.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:8d1fab6bb153a416f9aeb4b8763bc0f22a5586065f86f7664fc23339fc1c1fac", size = 181814, upload-time = "2025-09-25T21:32:35.712Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/bd/9c/4d95bb87eb2063d20db7b60faa3840c1b18025517ae857371c4dd55a6b3a/pyyaml-6.0.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:34d5fcd24b8445fadc33f9cf348c1047101756fd760b4dacb5c3e99755703310", size = 173809, upload-time = "2025-09-25T21:32:36.789Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/92/b5/47e807c2623074914e29dabd16cbbdd4bf5e9b2db9f8090fa64411fc5382/pyyaml-6.0.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:501a031947e3a9025ed4405a168e6ef5ae3126c59f90ce0cd6f2bfc477be31b7", size = 766454, upload-time = "2025-09-25T21:32:37.966Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/02/9e/e5e9b168be58564121efb3de6859c452fccde0ab093d8438905899a3a483/pyyaml-6.0.3-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:b3bc83488de33889877a0f2543ade9f70c67d66d9ebb4ac959502e12de895788", size = 836355, upload-time = "2025-09-25T21:32:39.178Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/88/f9/16491d7ed2a919954993e48aa941b200f38040928474c9e85ea9e64222c3/pyyaml-6.0.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c458b6d084f9b935061bc36216e8a69a7e293a2f1e68bf956dcd9e6cbcd143f5", size = 794175, upload-time = "2025-09-25T21:32:40.865Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/dd/3f/5989debef34dc6397317802b527dbbafb2b4760878a53d4166579111411e/pyyaml-6.0.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7c6610def4f163542a622a73fb39f534f8c101d690126992300bf3207eab9764", size = 755228, upload-time = "2025-09-25T21:32:42.084Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/d7/ce/af88a49043cd2e265be63d083fc75b27b6ed062f5f9fd6cdc223ad62f03e/pyyaml-6.0.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:5190d403f121660ce8d1d2c1bb2ef1bd05b5f68533fc5c2ea899bd15f4399b35", size = 789194, upload-time = "2025-09-25T21:32:43.362Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/23/20/bb6982b26a40bb43951265ba29d4c246ef0ff59c9fdcdf0ed04e0687de4d/pyyaml-6.0.3-cp314-cp314-win_amd64.whl", hash = "sha256:4a2e8cebe2ff6ab7d1050ecd59c25d4c8bd7e6f400f5f82b96557ac0abafd0ac", size = 156429, upload-time = "2025-09-25T21:32:57.844Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/f4/f4/a4541072bb9422c8a883ab55255f918fa378ecf083f5b85e87fc2b4eda1b/pyyaml-6.0.3-cp314-cp314-win_arm64.whl", hash = "sha256:93dda82c9c22deb0a405ea4dc5f2d0cda384168e466364dec6255b293923b2f3", size = 143912, upload-time = "2025-09-25T21:32:59.247Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/7c/f9/07dd09ae774e4616edf6cda684ee78f97777bdd15847253637a6f052a62f/pyyaml-6.0.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:02893d100e99e03eda1c8fd5c441d8c60103fd175728e23e431db1b589cf5ab3", size = 189108, upload-time = "2025-09-25T21:32:44.377Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/4e/78/8d08c9fb7ce09ad8c38ad533c1191cf27f7ae1effe5bb9400a46d9437fcf/pyyaml-6.0.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:c1ff362665ae507275af2853520967820d9124984e0f7466736aea23d8611fba", size = 183641, upload-time = "2025-09-25T21:32:45.407Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/7b/5b/3babb19104a46945cf816d047db2788bcaf8c94527a805610b0289a01c6b/pyyaml-6.0.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6adc77889b628398debc7b65c073bcb99c4a0237b248cacaf3fe8a557563ef6c", size = 831901, upload-time = "2025-09-25T21:32:48.83Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/8b/cc/dff0684d8dc44da4d22a13f35f073d558c268780ce3c6ba1b87055bb0b87/pyyaml-6.0.3-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a80cb027f6b349846a3bf6d73b5e95e782175e52f22108cfa17876aaeff93702", size = 861132, upload-time = "2025-09-25T21:32:50.149Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/b1/5e/f77dc6b9036943e285ba76b49e118d9ea929885becb0a29ba8a7c75e29fe/pyyaml-6.0.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:00c4bdeba853cc34e7dd471f16b4114f4162dc03e6b7afcc2128711f0eca823c", size = 839261, upload-time = "2025-09-25T21:32:51.808Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/ce/88/a9db1376aa2a228197c58b37302f284b5617f56a5d959fd1763fb1675ce6/pyyaml-6.0.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:66e1674c3ef6f541c35191caae2d429b967b99e02040f5ba928632d9a7f0f065", size = 805272, upload-time = "2025-09-25T21:32:52.941Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/da/92/1446574745d74df0c92e6aa4a7b0b3130706a4142b2d1a5869f2eaa423c6/pyyaml-6.0.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:16249ee61e95f858e83976573de0f5b2893b3677ba71c9dd36b9cf8be9ac6d65", size = 829923, upload-time = "2025-09-25T21:32:54.537Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/f0/7a/1c7270340330e575b92f397352af856a8c06f230aa3e76f86b39d01b416a/pyyaml-6.0.3-cp314-cp314t-win_amd64.whl", hash = "sha256:4ad1906908f2f5ae4e5a8ddfce73c320c2a1429ec52eafd27138b7f1cbe341c9", size = 174062, upload-time = "2025-09-25T21:32:55.767Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/f1/12/de94a39c2ef588c7e6455cfbe7343d3b2dc9d6b6b2f40c4c6565744c873d/pyyaml-6.0.3-cp314-cp314t-win_arm64.whl", hash = "sha256:ebc55a14a21cb14062aa4162f906cd962b28e2e9ea38f9b4391244cd8de4ae0b", size = 149341, upload-time = "2025-09-25T21:32:56.828Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "referencing"
|
||||
version = "0.37.0"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
dependencies = [
|
||||
{ name = "attrs" },
|
||||
{ name = "rpds-py" },
|
||||
{ name = "typing-extensions", marker = "python_full_version < '3.13'" },
|
||||
]
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/22/f5/df4e9027acead3ecc63e50fe1e36aca1523e1719559c499951bb4b53188f/referencing-0.37.0.tar.gz", hash = "sha256:44aefc3142c5b842538163acb373e24cce6632bd54bdb01b21ad5863489f50d8", size = 78036, upload-time = "2025-10-13T15:30:48.871Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/2c/58/ca301544e1fa93ed4f80d724bf5b194f6e4b945841c5bfd555878eea9fcb/referencing-0.37.0-py3-none-any.whl", hash = "sha256:381329a9f99628c9069361716891d34ad94af76e461dcb0335825aecc7692231", size = 26766, upload-time = "2025-10-13T15:30:47.625Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "rpds-py"
|
||||
version = "0.30.0"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/20/af/3f2f423103f1113b36230496629986e0ef7e199d2aa8392452b484b38ced/rpds_py-0.30.0.tar.gz", hash = "sha256:dd8ff7cf90014af0c0f787eea34794ebf6415242ee1d6fa91eaba725cc441e84", size = 69469, upload-time = "2025-11-30T20:24:38.837Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/4d/6e/f964e88b3d2abee2a82c1ac8366da848fce1c6d834dc2132c3fda3970290/rpds_py-0.30.0-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:a2bffea6a4ca9f01b3f8e548302470306689684e61602aa3d141e34da06cf425", size = 370157, upload-time = "2025-11-30T20:21:53.789Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/94/ba/24e5ebb7c1c82e74c4e4f33b2112a5573ddc703915b13a073737b59b86e0/rpds_py-0.30.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:dc4f992dfe1e2bc3ebc7444f6c7051b4bc13cd8e33e43511e8ffd13bf407010d", size = 359676, upload-time = "2025-11-30T20:21:55.475Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/84/86/04dbba1b087227747d64d80c3b74df946b986c57af0a9f0c98726d4d7a3b/rpds_py-0.30.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:422c3cb9856d80b09d30d2eb255d0754b23e090034e1deb4083f8004bd0761e4", size = 389938, upload-time = "2025-11-30T20:21:57.079Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/42/bb/1463f0b1722b7f45431bdd468301991d1328b16cffe0b1c2918eba2c4eee/rpds_py-0.30.0-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:07ae8a593e1c3c6b82ca3292efbe73c30b61332fd612e05abee07c79359f292f", size = 402932, upload-time = "2025-11-30T20:21:58.47Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/99/ee/2520700a5c1f2d76631f948b0736cdf9b0acb25abd0ca8e889b5c62ac2e3/rpds_py-0.30.0-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:12f90dd7557b6bd57f40abe7747e81e0c0b119bef015ea7726e69fe550e394a4", size = 525830, upload-time = "2025-11-30T20:21:59.699Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/e0/ad/bd0331f740f5705cc555a5e17fdf334671262160270962e69a2bdef3bf76/rpds_py-0.30.0-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:99b47d6ad9a6da00bec6aabe5a6279ecd3c06a329d4aa4771034a21e335c3a97", size = 412033, upload-time = "2025-11-30T20:22:00.991Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/f8/1e/372195d326549bb51f0ba0f2ecb9874579906b97e08880e7a65c3bef1a99/rpds_py-0.30.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:33f559f3104504506a44bb666b93a33f5d33133765b0c216a5bf2f1e1503af89", size = 390828, upload-time = "2025-11-30T20:22:02.723Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/ab/2b/d88bb33294e3e0c76bc8f351a3721212713629ffca1700fa94979cb3eae8/rpds_py-0.30.0-cp311-cp311-manylinux_2_31_riscv64.whl", hash = "sha256:946fe926af6e44f3697abbc305ea168c2c31d3e3ef1058cf68f379bf0335a78d", size = 404683, upload-time = "2025-11-30T20:22:04.367Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/50/32/c759a8d42bcb5289c1fac697cd92f6fe01a018dd937e62ae77e0e7f15702/rpds_py-0.30.0-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:495aeca4b93d465efde585977365187149e75383ad2684f81519f504f5c13038", size = 421583, upload-time = "2025-11-30T20:22:05.814Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/2b/81/e729761dbd55ddf5d84ec4ff1f47857f4374b0f19bdabfcf929164da3e24/rpds_py-0.30.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:d9a0ca5da0386dee0655b4ccdf46119df60e0f10da268d04fe7cc87886872ba7", size = 572496, upload-time = "2025-11-30T20:22:07.713Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/14/f6/69066a924c3557c9c30baa6ec3a0aa07526305684c6f86c696b08860726c/rpds_py-0.30.0-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:8d6d1cc13664ec13c1b84241204ff3b12f9bb82464b8ad6e7a5d3486975c2eed", size = 598669, upload-time = "2025-11-30T20:22:09.312Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/5f/48/905896b1eb8a05630d20333d1d8ffd162394127b74ce0b0784ae04498d32/rpds_py-0.30.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:3896fa1be39912cf0757753826bc8bdc8ca331a28a7c4ae46b7a21280b06bb85", size = 561011, upload-time = "2025-11-30T20:22:11.309Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/22/16/cd3027c7e279d22e5eb431dd3c0fbc677bed58797fe7581e148f3f68818b/rpds_py-0.30.0-cp311-cp311-win32.whl", hash = "sha256:55f66022632205940f1827effeff17c4fa7ae1953d2b74a8581baaefb7d16f8c", size = 221406, upload-time = "2025-11-30T20:22:13.101Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/fa/5b/e7b7aa136f28462b344e652ee010d4de26ee9fd16f1bfd5811f5153ccf89/rpds_py-0.30.0-cp311-cp311-win_amd64.whl", hash = "sha256:a51033ff701fca756439d641c0ad09a41d9242fa69121c7d8769604a0a629825", size = 236024, upload-time = "2025-11-30T20:22:14.853Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/14/a6/364bba985e4c13658edb156640608f2c9e1d3ea3c81b27aa9d889fff0e31/rpds_py-0.30.0-cp311-cp311-win_arm64.whl", hash = "sha256:47b0ef6231c58f506ef0b74d44e330405caa8428e770fec25329ed2cb971a229", size = 229069, upload-time = "2025-11-30T20:22:16.577Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/03/e7/98a2f4ac921d82f33e03f3835f5bf3a4a40aa1bfdc57975e74a97b2b4bdd/rpds_py-0.30.0-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:a161f20d9a43006833cd7068375a94d035714d73a172b681d8881820600abfad", size = 375086, upload-time = "2025-11-30T20:22:17.93Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/4d/a1/bca7fd3d452b272e13335db8d6b0b3ecde0f90ad6f16f3328c6fb150c889/rpds_py-0.30.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:6abc8880d9d036ecaafe709079969f56e876fcf107f7a8e9920ba6d5a3878d05", size = 359053, upload-time = "2025-11-30T20:22:19.297Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/65/1c/ae157e83a6357eceff62ba7e52113e3ec4834a84cfe07fa4b0757a7d105f/rpds_py-0.30.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ca28829ae5f5d569bb62a79512c842a03a12576375d5ece7d2cadf8abe96ec28", size = 390763, upload-time = "2025-11-30T20:22:21.661Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/d4/36/eb2eb8515e2ad24c0bd43c3ee9cd74c33f7ca6430755ccdb240fd3144c44/rpds_py-0.30.0-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:a1010ed9524c73b94d15919ca4d41d8780980e1765babf85f9a2f90d247153dd", size = 408951, upload-time = "2025-11-30T20:22:23.408Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/d6/65/ad8dc1784a331fabbd740ef6f71ce2198c7ed0890dab595adb9ea2d775a1/rpds_py-0.30.0-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f8d1736cfb49381ba528cd5baa46f82fdc65c06e843dab24dd70b63d09121b3f", size = 514622, upload-time = "2025-11-30T20:22:25.16Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/63/8e/0cfa7ae158e15e143fe03993b5bcd743a59f541f5952e1546b1ac1b5fd45/rpds_py-0.30.0-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:d948b135c4693daff7bc2dcfc4ec57237a29bd37e60c2fabf5aff2bbacf3e2f1", size = 414492, upload-time = "2025-11-30T20:22:26.505Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/60/1b/6f8f29f3f995c7ffdde46a626ddccd7c63aefc0efae881dc13b6e5d5bb16/rpds_py-0.30.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:47f236970bccb2233267d89173d3ad2703cd36a0e2a6e92d0560d333871a3d23", size = 394080, upload-time = "2025-11-30T20:22:27.934Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/6d/d5/a266341051a7a3ca2f4b750a3aa4abc986378431fc2da508c5034d081b70/rpds_py-0.30.0-cp312-cp312-manylinux_2_31_riscv64.whl", hash = "sha256:2e6ecb5a5bcacf59c3f912155044479af1d0b6681280048b338b28e364aca1f6", size = 408680, upload-time = "2025-11-30T20:22:29.341Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/10/3b/71b725851df9ab7a7a4e33cf36d241933da66040d195a84781f49c50490c/rpds_py-0.30.0-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:a8fa71a2e078c527c3e9dc9fc5a98c9db40bcc8a92b4e8858e36d329f8684b51", size = 423589, upload-time = "2025-11-30T20:22:31.469Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/00/2b/e59e58c544dc9bd8bd8384ecdb8ea91f6727f0e37a7131baeff8d6f51661/rpds_py-0.30.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:73c67f2db7bc334e518d097c6d1e6fed021bbc9b7d678d6cc433478365d1d5f5", size = 573289, upload-time = "2025-11-30T20:22:32.997Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/da/3e/a18e6f5b460893172a7d6a680e86d3b6bc87a54c1f0b03446a3c8c7b588f/rpds_py-0.30.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:5ba103fb455be00f3b1c2076c9d4264bfcb037c976167a6047ed82f23153f02e", size = 599737, upload-time = "2025-11-30T20:22:34.419Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/5c/e2/714694e4b87b85a18e2c243614974413c60aa107fd815b8cbc42b873d1d7/rpds_py-0.30.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:7cee9c752c0364588353e627da8a7e808a66873672bcb5f52890c33fd965b394", size = 563120, upload-time = "2025-11-30T20:22:35.903Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/6f/ab/d5d5e3bcedb0a77f4f613706b750e50a5a3ba1c15ccd3665ecc636c968fd/rpds_py-0.30.0-cp312-cp312-win32.whl", hash = "sha256:1ab5b83dbcf55acc8b08fc62b796ef672c457b17dbd7820a11d6c52c06839bdf", size = 223782, upload-time = "2025-11-30T20:22:37.271Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/39/3b/f786af9957306fdc38a74cef405b7b93180f481fb48453a114bb6465744a/rpds_py-0.30.0-cp312-cp312-win_amd64.whl", hash = "sha256:a090322ca841abd453d43456ac34db46e8b05fd9b3b4ac0c78bcde8b089f959b", size = 240463, upload-time = "2025-11-30T20:22:39.021Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/f3/d2/b91dc748126c1559042cfe41990deb92c4ee3e2b415f6b5234969ffaf0cc/rpds_py-0.30.0-cp312-cp312-win_arm64.whl", hash = "sha256:669b1805bd639dd2989b281be2cfd951c6121b65e729d9b843e9639ef1fd555e", size = 230868, upload-time = "2025-11-30T20:22:40.493Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/ed/dc/d61221eb88ff410de3c49143407f6f3147acf2538c86f2ab7ce65ae7d5f9/rpds_py-0.30.0-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:f83424d738204d9770830d35290ff3273fbb02b41f919870479fab14b9d303b2", size = 374887, upload-time = "2025-11-30T20:22:41.812Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/fd/32/55fb50ae104061dbc564ef15cc43c013dc4a9f4527a1f4d99baddf56fe5f/rpds_py-0.30.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:e7536cd91353c5273434b4e003cbda89034d67e7710eab8761fd918ec6c69cf8", size = 358904, upload-time = "2025-11-30T20:22:43.479Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/58/70/faed8186300e3b9bdd138d0273109784eea2396c68458ed580f885dfe7ad/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2771c6c15973347f50fece41fc447c054b7ac2ae0502388ce3b6738cd366e3d4", size = 389945, upload-time = "2025-11-30T20:22:44.819Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/bd/a8/073cac3ed2c6387df38f71296d002ab43496a96b92c823e76f46b8af0543/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:0a59119fc6e3f460315fe9d08149f8102aa322299deaa5cab5b40092345c2136", size = 407783, upload-time = "2025-11-30T20:22:46.103Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/77/57/5999eb8c58671f1c11eba084115e77a8899d6e694d2a18f69f0ba471ec8b/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:76fec018282b4ead0364022e3c54b60bf368b9d926877957a8624b58419169b7", size = 515021, upload-time = "2025-11-30T20:22:47.458Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/e0/af/5ab4833eadc36c0a8ed2bc5c0de0493c04f6c06de223170bd0798ff98ced/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:692bef75a5525db97318e8cd061542b5a79812d711ea03dbc1f6f8dbb0c5f0d2", size = 414589, upload-time = "2025-11-30T20:22:48.872Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/b7/de/f7192e12b21b9e9a68a6d0f249b4af3fdcdff8418be0767a627564afa1f1/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9027da1ce107104c50c81383cae773ef5c24d296dd11c99e2629dbd7967a20c6", size = 394025, upload-time = "2025-11-30T20:22:50.196Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/91/c4/fc70cd0249496493500e7cc2de87504f5aa6509de1e88623431fec76d4b6/rpds_py-0.30.0-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:9cf69cdda1f5968a30a359aba2f7f9aa648a9ce4b580d6826437f2b291cfc86e", size = 408895, upload-time = "2025-11-30T20:22:51.87Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/58/95/d9275b05ab96556fefff73a385813eb66032e4c99f411d0795372d9abcea/rpds_py-0.30.0-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:a4796a717bf12b9da9d3ad002519a86063dcac8988b030e405704ef7d74d2d9d", size = 422799, upload-time = "2025-11-30T20:22:53.341Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/06/c1/3088fc04b6624eb12a57eb814f0d4997a44b0d208d6cace713033ff1a6ba/rpds_py-0.30.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:5d4c2aa7c50ad4728a094ebd5eb46c452e9cb7edbfdb18f9e1221f597a73e1e7", size = 572731, upload-time = "2025-11-30T20:22:54.778Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/d8/42/c612a833183b39774e8ac8fecae81263a68b9583ee343db33ab571a7ce55/rpds_py-0.30.0-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:ba81a9203d07805435eb06f536d95a266c21e5b2dfbf6517748ca40c98d19e31", size = 599027, upload-time = "2025-11-30T20:22:56.212Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/5f/60/525a50f45b01d70005403ae0e25f43c0384369ad24ffe46e8d9068b50086/rpds_py-0.30.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:945dccface01af02675628334f7cf49c2af4c1c904748efc5cf7bbdf0b579f95", size = 563020, upload-time = "2025-11-30T20:22:58.2Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/0b/5d/47c4655e9bcd5ca907148535c10e7d489044243cc9941c16ed7cd53be91d/rpds_py-0.30.0-cp313-cp313-win32.whl", hash = "sha256:b40fb160a2db369a194cb27943582b38f79fc4887291417685f3ad693c5a1d5d", size = 223139, upload-time = "2025-11-30T20:23:00.209Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/f2/e1/485132437d20aa4d3e1d8b3fb5a5e65aa8139f1e097080c2a8443201742c/rpds_py-0.30.0-cp313-cp313-win_amd64.whl", hash = "sha256:806f36b1b605e2d6a72716f321f20036b9489d29c51c91f4dd29a3e3afb73b15", size = 240224, upload-time = "2025-11-30T20:23:02.008Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/24/95/ffd128ed1146a153d928617b0ef673960130be0009c77d8fbf0abe306713/rpds_py-0.30.0-cp313-cp313-win_arm64.whl", hash = "sha256:d96c2086587c7c30d44f31f42eae4eac89b60dabbac18c7669be3700f13c3ce1", size = 230645, upload-time = "2025-11-30T20:23:03.43Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/ff/1b/b10de890a0def2a319a2626334a7f0ae388215eb60914dbac8a3bae54435/rpds_py-0.30.0-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:eb0b93f2e5c2189ee831ee43f156ed34e2a89a78a66b98cadad955972548be5a", size = 364443, upload-time = "2025-11-30T20:23:04.878Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/0d/bf/27e39f5971dc4f305a4fb9c672ca06f290f7c4e261c568f3dea16a410d47/rpds_py-0.30.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:922e10f31f303c7c920da8981051ff6d8c1a56207dbdf330d9047f6d30b70e5e", size = 353375, upload-time = "2025-11-30T20:23:06.342Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/40/58/442ada3bba6e8e6615fc00483135c14a7538d2ffac30e2d933ccf6852232/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:cdc62c8286ba9bf7f47befdcea13ea0e26bf294bda99758fd90535cbaf408000", size = 383850, upload-time = "2025-11-30T20:23:07.825Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/14/14/f59b0127409a33c6ef6f5c1ebd5ad8e32d7861c9c7adfa9a624fc3889f6c/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:47f9a91efc418b54fb8190a6b4aa7813a23fb79c51f4bb84e418f5476c38b8db", size = 392812, upload-time = "2025-11-30T20:23:09.228Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/b3/66/e0be3e162ac299b3a22527e8913767d869e6cc75c46bd844aa43fb81ab62/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:1f3587eb9b17f3789ad50824084fa6f81921bbf9a795826570bda82cb3ed91f2", size = 517841, upload-time = "2025-11-30T20:23:11.186Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/3d/55/fa3b9cf31d0c963ecf1ba777f7cf4b2a2c976795ac430d24a1f43d25a6ba/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:39c02563fc592411c2c61d26b6c5fe1e51eaa44a75aa2c8735ca88b0d9599daa", size = 408149, upload-time = "2025-11-30T20:23:12.864Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/60/ca/780cf3b1a32b18c0f05c441958d3758f02544f1d613abf9488cd78876378/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:51a1234d8febafdfd33a42d97da7a43f5dcb120c1060e352a3fbc0c6d36e2083", size = 383843, upload-time = "2025-11-30T20:23:14.638Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/82/86/d5f2e04f2aa6247c613da0c1dd87fcd08fa17107e858193566048a1e2f0a/rpds_py-0.30.0-cp313-cp313t-manylinux_2_31_riscv64.whl", hash = "sha256:eb2c4071ab598733724c08221091e8d80e89064cd472819285a9ab0f24bcedb9", size = 396507, upload-time = "2025-11-30T20:23:16.105Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/4b/9a/453255d2f769fe44e07ea9785c8347edaf867f7026872e76c1ad9f7bed92/rpds_py-0.30.0-cp313-cp313t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:6bdfdb946967d816e6adf9a3d8201bfad269c67efe6cefd7093ef959683c8de0", size = 414949, upload-time = "2025-11-30T20:23:17.539Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/a3/31/622a86cdc0c45d6df0e9ccb6becdba5074735e7033c20e401a6d9d0e2ca0/rpds_py-0.30.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:c77afbd5f5250bf27bf516c7c4a016813eb2d3e116139aed0096940c5982da94", size = 565790, upload-time = "2025-11-30T20:23:19.029Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/1c/5d/15bbf0fb4a3f58a3b1c67855ec1efcc4ceaef4e86644665fff03e1b66d8d/rpds_py-0.30.0-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:61046904275472a76c8c90c9ccee9013d70a6d0f73eecefd38c1ae7c39045a08", size = 590217, upload-time = "2025-11-30T20:23:20.885Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/6d/61/21b8c41f68e60c8cc3b2e25644f0e3681926020f11d06ab0b78e3c6bbff1/rpds_py-0.30.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:4c5f36a861bc4b7da6516dbdf302c55313afa09b81931e8280361a4f6c9a2d27", size = 555806, upload-time = "2025-11-30T20:23:22.488Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/f9/39/7e067bb06c31de48de3eb200f9fc7c58982a4d3db44b07e73963e10d3be9/rpds_py-0.30.0-cp313-cp313t-win32.whl", hash = "sha256:3d4a69de7a3e50ffc214ae16d79d8fbb0922972da0356dcf4d0fdca2878559c6", size = 211341, upload-time = "2025-11-30T20:23:24.449Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/0a/4d/222ef0b46443cf4cf46764d9c630f3fe4abaa7245be9417e56e9f52b8f65/rpds_py-0.30.0-cp313-cp313t-win_amd64.whl", hash = "sha256:f14fc5df50a716f7ece6a80b6c78bb35ea2ca47c499e422aa4463455dd96d56d", size = 225768, upload-time = "2025-11-30T20:23:25.908Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/86/81/dad16382ebbd3d0e0328776d8fd7ca94220e4fa0798d1dc5e7da48cb3201/rpds_py-0.30.0-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:68f19c879420aa08f61203801423f6cd5ac5f0ac4ac82a2368a9fcd6a9a075e0", size = 362099, upload-time = "2025-11-30T20:23:27.316Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/2b/60/19f7884db5d5603edf3c6bce35408f45ad3e97e10007df0e17dd57af18f8/rpds_py-0.30.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:ec7c4490c672c1a0389d319b3a9cfcd098dcdc4783991553c332a15acf7249be", size = 353192, upload-time = "2025-11-30T20:23:29.151Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/bf/c4/76eb0e1e72d1a9c4703c69607cec123c29028bff28ce41588792417098ac/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f251c812357a3fed308d684a5079ddfb9d933860fc6de89f2b7ab00da481e65f", size = 384080, upload-time = "2025-11-30T20:23:30.785Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/72/87/87ea665e92f3298d1b26d78814721dc39ed8d2c74b86e83348d6b48a6f31/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:ac98b175585ecf4c0348fd7b29c3864bda53b805c773cbf7bfdaffc8070c976f", size = 394841, upload-time = "2025-11-30T20:23:32.209Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/77/ad/7783a89ca0587c15dcbf139b4a8364a872a25f861bdb88ed99f9b0dec985/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:3e62880792319dbeb7eb866547f2e35973289e7d5696c6e295476448f5b63c87", size = 516670, upload-time = "2025-11-30T20:23:33.742Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/5b/3c/2882bdac942bd2172f3da574eab16f309ae10a3925644e969536553cb4ee/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:4e7fc54e0900ab35d041b0601431b0a0eb495f0851a0639b6ef90f7741b39a18", size = 408005, upload-time = "2025-11-30T20:23:35.253Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/ce/81/9a91c0111ce1758c92516a3e44776920b579d9a7c09b2b06b642d4de3f0f/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:47e77dc9822d3ad616c3d5759ea5631a75e5809d5a28707744ef79d7a1bcfcad", size = 382112, upload-time = "2025-11-30T20:23:36.842Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/cf/8e/1da49d4a107027e5fbc64daeab96a0706361a2918da10cb41769244b805d/rpds_py-0.30.0-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:b4dc1a6ff022ff85ecafef7979a2c6eb423430e05f1165d6688234e62ba99a07", size = 399049, upload-time = "2025-11-30T20:23:38.343Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/df/5a/7ee239b1aa48a127570ec03becbb29c9d5a9eb092febbd1699d567cae859/rpds_py-0.30.0-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:4559c972db3a360808309e06a74628b95eaccbf961c335c8fe0d590cf587456f", size = 415661, upload-time = "2025-11-30T20:23:40.263Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/70/ea/caa143cf6b772f823bc7929a45da1fa83569ee49b11d18d0ada7f5ee6fd6/rpds_py-0.30.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:0ed177ed9bded28f8deb6ab40c183cd1192aa0de40c12f38be4d59cd33cb5c65", size = 565606, upload-time = "2025-11-30T20:23:42.186Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/64/91/ac20ba2d69303f961ad8cf55bf7dbdb4763f627291ba3d0d7d67333cced9/rpds_py-0.30.0-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:ad1fa8db769b76ea911cb4e10f049d80bf518c104f15b3edb2371cc65375c46f", size = 591126, upload-time = "2025-11-30T20:23:44.086Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/21/20/7ff5f3c8b00c8a95f75985128c26ba44503fb35b8e0259d812766ea966c7/rpds_py-0.30.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:46e83c697b1f1c72b50e5ee5adb4353eef7406fb3f2043d64c33f20ad1c2fc53", size = 553371, upload-time = "2025-11-30T20:23:46.004Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/72/c7/81dadd7b27c8ee391c132a6b192111ca58d866577ce2d9b0ca157552cce0/rpds_py-0.30.0-cp314-cp314-win32.whl", hash = "sha256:ee454b2a007d57363c2dfd5b6ca4a5d7e2c518938f8ed3b706e37e5d470801ed", size = 215298, upload-time = "2025-11-30T20:23:47.696Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/3e/d2/1aaac33287e8cfb07aab2e6b8ac1deca62f6f65411344f1433c55e6f3eb8/rpds_py-0.30.0-cp314-cp314-win_amd64.whl", hash = "sha256:95f0802447ac2d10bcc69f6dc28fe95fdf17940367b21d34e34c737870758950", size = 228604, upload-time = "2025-11-30T20:23:49.501Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/e8/95/ab005315818cc519ad074cb7784dae60d939163108bd2b394e60dc7b5461/rpds_py-0.30.0-cp314-cp314-win_arm64.whl", hash = "sha256:613aa4771c99f03346e54c3f038e4cc574ac09a3ddfb0e8878487335e96dead6", size = 222391, upload-time = "2025-11-30T20:23:50.96Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/9e/68/154fe0194d83b973cdedcdcc88947a2752411165930182ae41d983dcefa6/rpds_py-0.30.0-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:7e6ecfcb62edfd632e56983964e6884851786443739dbfe3582947e87274f7cb", size = 364868, upload-time = "2025-11-30T20:23:52.494Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/83/69/8bbc8b07ec854d92a8b75668c24d2abcb1719ebf890f5604c61c9369a16f/rpds_py-0.30.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:a1d0bc22a7cdc173fedebb73ef81e07faef93692b8c1ad3733b67e31e1b6e1b8", size = 353747, upload-time = "2025-11-30T20:23:54.036Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/ab/00/ba2e50183dbd9abcce9497fa5149c62b4ff3e22d338a30d690f9af970561/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0d08f00679177226c4cb8c5265012eea897c8ca3b93f429e546600c971bcbae7", size = 383795, upload-time = "2025-11-30T20:23:55.556Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/05/6f/86f0272b84926bcb0e4c972262f54223e8ecc556b3224d281e6598fc9268/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:5965af57d5848192c13534f90f9dd16464f3c37aaf166cc1da1cae1fd5a34898", size = 393330, upload-time = "2025-11-30T20:23:57.033Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/cb/e9/0e02bb2e6dc63d212641da45df2b0bf29699d01715913e0d0f017ee29438/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9a4e86e34e9ab6b667c27f3211ca48f73dba7cd3d90f8d5b11be56e5dbc3fb4e", size = 518194, upload-time = "2025-11-30T20:23:58.637Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/ee/ca/be7bca14cf21513bdf9c0606aba17d1f389ea2b6987035eb4f62bd923f25/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e5d3e6b26f2c785d65cc25ef1e5267ccbe1b069c5c21b8cc724efee290554419", size = 408340, upload-time = "2025-11-30T20:24:00.2Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/c2/c7/736e00ebf39ed81d75544c0da6ef7b0998f8201b369acf842f9a90dc8fce/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:626a7433c34566535b6e56a1b39a7b17ba961e97ce3b80ec62e6f1312c025551", size = 383765, upload-time = "2025-11-30T20:24:01.759Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/4a/3f/da50dfde9956aaf365c4adc9533b100008ed31aea635f2b8d7b627e25b49/rpds_py-0.30.0-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:acd7eb3f4471577b9b5a41baf02a978e8bdeb08b4b355273994f8b87032000a8", size = 396834, upload-time = "2025-11-30T20:24:03.687Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/4e/00/34bcc2565b6020eab2623349efbdec810676ad571995911f1abdae62a3a0/rpds_py-0.30.0-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:fe5fa731a1fa8a0a56b0977413f8cacac1768dad38d16b3a296712709476fbd5", size = 415470, upload-time = "2025-11-30T20:24:05.232Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/8c/28/882e72b5b3e6f718d5453bd4d0d9cf8df36fddeb4ddbbab17869d5868616/rpds_py-0.30.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:74a3243a411126362712ee1524dfc90c650a503502f135d54d1b352bd01f2404", size = 565630, upload-time = "2025-11-30T20:24:06.878Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/3b/97/04a65539c17692de5b85c6e293520fd01317fd878ea1995f0367d4532fb1/rpds_py-0.30.0-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:3e8eeb0544f2eb0d2581774be4c3410356eba189529a6b3e36bbbf9696175856", size = 591148, upload-time = "2025-11-30T20:24:08.445Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/85/70/92482ccffb96f5441aab93e26c4d66489eb599efdcf96fad90c14bbfb976/rpds_py-0.30.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:dbd936cde57abfee19ab3213cf9c26be06d60750e60a8e4dd85d1ab12c8b1f40", size = 556030, upload-time = "2025-11-30T20:24:10.956Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/20/53/7c7e784abfa500a2b6b583b147ee4bb5a2b3747a9166bab52fec4b5b5e7d/rpds_py-0.30.0-cp314-cp314t-win32.whl", hash = "sha256:dc824125c72246d924f7f796b4f63c1e9dc810c7d9e2355864b3c3a73d59ade0", size = 211570, upload-time = "2025-11-30T20:24:12.735Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/d0/02/fa464cdfbe6b26e0600b62c528b72d8608f5cc49f96b8d6e38c95d60c676/rpds_py-0.30.0-cp314-cp314t-win_amd64.whl", hash = "sha256:27f4b0e92de5bfbc6f86e43959e6edd1425c33b5e69aab0984a72047f2bcf1e3", size = 226532, upload-time = "2025-11-30T20:24:14.634Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/69/71/3f34339ee70521864411f8b6992e7ab13ac30d8e4e3309e07c7361767d91/rpds_py-0.30.0-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:c2262bdba0ad4fc6fb5545660673925c2d2a5d9e2e0fb603aad545427be0fc58", size = 372292, upload-time = "2025-11-30T20:24:16.537Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/57/09/f183df9b8f2d66720d2ef71075c59f7e1b336bec7ee4c48f0a2b06857653/rpds_py-0.30.0-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:ee6af14263f25eedc3bb918a3c04245106a42dfd4f5c2285ea6f997b1fc3f89a", size = 362128, upload-time = "2025-11-30T20:24:18.086Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/7a/68/5c2594e937253457342e078f0cc1ded3dd7b2ad59afdbf2d354869110a02/rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3adbb8179ce342d235c31ab8ec511e66c73faa27a47e076ccc92421add53e2bb", size = 391542, upload-time = "2025-11-30T20:24:20.092Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/49/5c/31ef1afd70b4b4fbdb2800249f34c57c64beb687495b10aec0365f53dfc4/rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:250fa00e9543ac9b97ac258bd37367ff5256666122c2d0f2bc97577c60a1818c", size = 404004, upload-time = "2025-11-30T20:24:22.231Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/e3/63/0cfbea38d05756f3440ce6534d51a491d26176ac045e2707adc99bb6e60a/rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9854cf4f488b3d57b9aaeb105f06d78e5529d3145b1e4a41750167e8c213c6d3", size = 527063, upload-time = "2025-11-30T20:24:24.302Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/42/e6/01e1f72a2456678b0f618fc9a1a13f882061690893c192fcad9f2926553a/rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:993914b8e560023bc0a8bf742c5f303551992dcb85e247b1e5c7f4a7d145bda5", size = 413099, upload-time = "2025-11-30T20:24:25.916Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/b8/25/8df56677f209003dcbb180765520c544525e3ef21ea72279c98b9aa7c7fb/rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:58edca431fb9b29950807e301826586e5bbf24163677732429770a697ffe6738", size = 392177, upload-time = "2025-11-30T20:24:27.834Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/4a/b4/0a771378c5f16f8115f796d1f437950158679bcd2a7c68cf251cfb00ed5b/rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_31_riscv64.whl", hash = "sha256:dea5b552272a944763b34394d04577cf0f9bd013207bc32323b5a89a53cf9c2f", size = 406015, upload-time = "2025-11-30T20:24:29.457Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/36/d8/456dbba0af75049dc6f63ff295a2f92766b9d521fa00de67a2bd6427d57a/rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:ba3af48635eb83d03f6c9735dfb21785303e73d22ad03d489e88adae6eab8877", size = 423736, upload-time = "2025-11-30T20:24:31.22Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/13/64/b4d76f227d5c45a7e0b796c674fd81b0a6c4fbd48dc29271857d8219571c/rpds_py-0.30.0-pp311-pypy311_pp73-musllinux_1_2_aarch64.whl", hash = "sha256:dff13836529b921e22f15cb099751209a60009731a68519630a24d61f0b1b30a", size = 573981, upload-time = "2025-11-30T20:24:32.934Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/20/91/092bacadeda3edf92bf743cc96a7be133e13a39cdbfd7b5082e7ab638406/rpds_py-0.30.0-pp311-pypy311_pp73-musllinux_1_2_i686.whl", hash = "sha256:1b151685b23929ab7beec71080a8889d4d6d9fa9a983d213f07121205d48e2c4", size = 599782, upload-time = "2025-11-30T20:24:35.169Z" },
|
||||
{ url = "https://files.pythonhosted.org/packages/d1/b7/b95708304cd49b7b6f82fdd039f1748b66ec2b21d6a45180910802f1abf1/rpds_py-0.30.0-pp311-pypy311_pp73-musllinux_1_2_x86_64.whl", hash = "sha256:ac37f9f516c51e5753f27dfdef11a88330f04de2d564be3991384b2f3535d02e", size = 562191, upload-time = "2025-11-30T20:24:36.853Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "sse-starlette"
|
||||
version = "3.1.2"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
dependencies = [
|
||||
{ name = "anyio" },
|
||||
{ name = "starlette" },
|
||||
]
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/da/34/f5df66cb383efdbf4f2db23cabb27f51b1dcb737efaf8a558f6f1d195134/sse_starlette-3.1.2.tar.gz", hash = "sha256:55eff034207a83a0eb86de9a68099bd0157838f0b8b999a1b742005c71e33618", size = 26303, upload-time = "2025-12-31T08:02:20.023Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/b7/95/8c4b76eec9ae574474e5d2997557cebf764bcd3586458956c30631ae08f4/sse_starlette-3.1.2-py3-none-any.whl", hash = "sha256:cd800dd349f4521b317b9391d3796fa97b71748a4da9b9e00aafab32dda375c8", size = 12484, upload-time = "2025-12-31T08:02:18.894Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "starlette"
|
||||
version = "0.51.0"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
dependencies = [
|
||||
{ name = "anyio" },
|
||||
{ name = "typing-extensions", marker = "python_full_version < '3.13'" },
|
||||
]
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/e7/65/5a1fadcc40c5fdc7df421a7506b79633af8f5d5e3a95c3e72acacec644b9/starlette-0.51.0.tar.gz", hash = "sha256:4c4fda9b1bc67f84037d3d14a5112e523509c369d9d47b111b2f984b0cc5ba6c", size = 2647658, upload-time = "2026-01-10T20:23:15.043Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/18/c4/09985a03dba389d4fe16a9014147a7b02fa76ef3519bf5846462a485876d/starlette-0.51.0-py3-none-any.whl", hash = "sha256:fb460a3d6fd3c958d729fdd96aee297f89a51b0181f16401fe8fd4cb6129165d", size = 74133, upload-time = "2026-01-10T20:23:13.445Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "typing-extensions"
|
||||
version = "4.15.0"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/72/94/1a15dd82efb362ac84269196e94cf00f187f7ed21c242792a923cdb1c61f/typing_extensions-4.15.0.tar.gz", hash = "sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466", size = 109391, upload-time = "2025-08-25T13:49:26.313Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548", size = 44614, upload-time = "2025-08-25T13:49:24.86Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "typing-inspection"
|
||||
version = "0.4.2"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
dependencies = [
|
||||
{ name = "typing-extensions" },
|
||||
]
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/55/e3/70399cb7dd41c10ac53367ae42139cf4b1ca5f36bb3dc6c9d33acdb43655/typing_inspection-0.4.2.tar.gz", hash = "sha256:ba561c48a67c5958007083d386c3295464928b01faa735ab8547c5692e87f464", size = 75949, upload-time = "2025-10-01T02:14:41.687Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/dc/9b/47798a6c91d8bdb567fe2698fe81e0c6b7cb7ef4d13da4114b41d239f65d/typing_inspection-0.4.2-py3-none-any.whl", hash = "sha256:4ed1cacbdc298c220f1bd249ed5287caa16f34d44ef4e9c3d0cbad5b521545e7", size = 14611, upload-time = "2025-10-01T02:14:40.154Z" },
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "uvicorn"
|
||||
version = "0.40.0"
|
||||
source = { registry = "https://pypi.org/simple" }
|
||||
dependencies = [
|
||||
{ name = "click" },
|
||||
{ name = "h11" },
|
||||
]
|
||||
sdist = { url = "https://files.pythonhosted.org/packages/c3/d1/8f3c683c9561a4e6689dd3b1d345c815f10f86acd044ee1fb9a4dcd0b8c5/uvicorn-0.40.0.tar.gz", hash = "sha256:839676675e87e73694518b5574fd0f24c9d97b46bea16df7b8c05ea1a51071ea", size = 81761, upload-time = "2025-12-21T14:16:22.45Z" }
|
||||
wheels = [
|
||||
{ url = "https://files.pythonhosted.org/packages/3d/d8/2083a1daa7439a66f3a48589a57d576aa117726762618f6bb09fe3798796/uvicorn-0.40.0-py3-none-any.whl", hash = "sha256:c6c8f55bc8bf13eb6fa9ff87ad62308bbbc33d0b67f84293151efe87e0d5f2ee", size = 68502, upload-time = "2025-12-21T14:16:21.041Z" },
|
||||
]
|
||||
37
.agents/skills/create-beads-orchestration/package.json
Normal file
37
.agents/skills/create-beads-orchestration/package.json
Normal file
|
|
@ -0,0 +1,37 @@
|
|||
{
|
||||
"name": "beads-orchestration",
|
||||
"version": "2.2.0",
|
||||
"description": "Multi-agent orchestration for Claude Code with automatic task management",
|
||||
"author": "Aviv Kaplan",
|
||||
"license": "MIT",
|
||||
"repository": {
|
||||
"type": "git",
|
||||
"url": "https://github.com/AvivK5498/The-Claude-Protocol"
|
||||
},
|
||||
"keywords": [
|
||||
"claude",
|
||||
"claude-code",
|
||||
"orchestration",
|
||||
"ai-agents",
|
||||
"task-management",
|
||||
"beads"
|
||||
],
|
||||
"os": [
|
||||
"darwin",
|
||||
"linux"
|
||||
],
|
||||
"scripts": {
|
||||
"postinstall": "node scripts/postinstall.js"
|
||||
},
|
||||
"files": [
|
||||
"scripts/",
|
||||
"skills/",
|
||||
"templates/",
|
||||
"bootstrap.py",
|
||||
"SKILL.md",
|
||||
"README.md"
|
||||
],
|
||||
"bin": {
|
||||
"beads-orchestration": "./scripts/cli.js"
|
||||
}
|
||||
}
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 514 KiB |
64
.agents/skills/create-beads-orchestration/scripts/cli.js
Normal file
64
.agents/skills/create-beads-orchestration/scripts/cli.js
Normal file
|
|
@ -0,0 +1,64 @@
|
|||
#!/usr/bin/env node
|
||||
|
||||
const { execSync } = require('child_process');
|
||||
const path = require('path');
|
||||
const fs = require('fs');
|
||||
|
||||
const args = process.argv.slice(2);
|
||||
const command = args[0];
|
||||
|
||||
const packageDir = path.dirname(__dirname);
|
||||
const bootstrapScript = path.join(packageDir, 'bootstrap.py');
|
||||
|
||||
function showHelp() {
|
||||
console.log(`
|
||||
beads-orchestration - Multi-agent orchestration for Claude Code
|
||||
|
||||
Usage:
|
||||
beads-orchestration <command> [options]
|
||||
|
||||
Commands:
|
||||
install Run postinstall to copy skill to ~/.claude/
|
||||
bootstrap Run bootstrap.py directly (advanced)
|
||||
help Show this help message
|
||||
|
||||
Examples:
|
||||
beads-orchestration install
|
||||
beads-orchestration bootstrap --project-dir /path/to/project --claude-only
|
||||
|
||||
After installing, use /create-beads-orchestration in Claude Code.
|
||||
`);
|
||||
}
|
||||
|
||||
function runInstall() {
|
||||
const postinstall = path.join(__dirname, 'postinstall.js');
|
||||
require(postinstall);
|
||||
}
|
||||
|
||||
function runBootstrap() {
|
||||
const bootstrapArgs = args.slice(1).join(' ');
|
||||
try {
|
||||
execSync(`python3 "${bootstrapScript}" ${bootstrapArgs}`, { stdio: 'inherit' });
|
||||
} catch (err) {
|
||||
process.exit(err.status || 1);
|
||||
}
|
||||
}
|
||||
|
||||
switch (command) {
|
||||
case 'install':
|
||||
runInstall();
|
||||
break;
|
||||
case 'bootstrap':
|
||||
runBootstrap();
|
||||
break;
|
||||
case 'help':
|
||||
case '--help':
|
||||
case '-h':
|
||||
case undefined:
|
||||
showHelp();
|
||||
break;
|
||||
default:
|
||||
console.error(`Unknown command: ${command}`);
|
||||
showHelp();
|
||||
process.exit(1);
|
||||
}
|
||||
|
|
@ -0,0 +1,71 @@
|
|||
#!/usr/bin/env node
|
||||
|
||||
const fs = require('fs');
|
||||
const path = require('path');
|
||||
const os = require('os');
|
||||
|
||||
const SKILL_NAME = 'create-beads-orchestration';
|
||||
|
||||
// Get paths
|
||||
const homeDir = os.homedir();
|
||||
const claudeDir = path.join(homeDir, '.claude');
|
||||
const claudeSkillsDir = path.join(claudeDir, 'skills', SKILL_NAME);
|
||||
const packageDir = path.dirname(__dirname);
|
||||
const sourceSkillDir = path.join(packageDir, 'skills', SKILL_NAME);
|
||||
|
||||
console.log('\n📦 Installing beads-orchestration skill...\n');
|
||||
|
||||
// Check OS
|
||||
if (process.platform === 'win32') {
|
||||
console.log('⚠️ Windows is not supported. Use WSL or macOS/Linux.');
|
||||
process.exit(0);
|
||||
}
|
||||
|
||||
// Create ~/.claude/skills/create-beads-orchestration/
|
||||
try {
|
||||
fs.mkdirSync(claudeSkillsDir, { recursive: true });
|
||||
} catch (err) {
|
||||
console.error(`❌ Failed to create directory: ${claudeSkillsDir}`);
|
||||
console.error(err.message);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
// Copy SKILL.md
|
||||
const sourceFile = path.join(sourceSkillDir, 'SKILL.md');
|
||||
const destFile = path.join(claudeSkillsDir, 'SKILL.md');
|
||||
|
||||
try {
|
||||
if (!fs.existsSync(sourceFile)) {
|
||||
console.error(`❌ Source skill not found: ${sourceFile}`);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
fs.copyFileSync(sourceFile, destFile);
|
||||
console.log(`✅ Installed skill to: ${claudeSkillsDir}`);
|
||||
} catch (err) {
|
||||
console.error(`❌ Failed to copy skill: ${err.message}`);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
// Save package location for bootstrap.py
|
||||
const configFile = path.join(claudeDir, 'beads-orchestration-path.txt');
|
||||
try {
|
||||
fs.writeFileSync(configFile, packageDir);
|
||||
console.log(`✅ Saved package path to: ${configFile}`);
|
||||
} catch (err) {
|
||||
console.error(`⚠️ Could not save package path: ${err.message}`);
|
||||
}
|
||||
|
||||
console.log(`
|
||||
🎉 Installation complete!
|
||||
|
||||
Package location: ${packageDir}
|
||||
|
||||
Usage:
|
||||
In any Claude Code session, run:
|
||||
|
||||
/create-beads-orchestration
|
||||
|
||||
The skill will guide you through setting up orchestration for your project.
|
||||
|
||||
`);
|
||||
|
|
@ -0,0 +1,263 @@
|
|||
---
|
||||
name: create-beads-orchestration
|
||||
description: Bootstrap lean multi-agent orchestration with beads task tracking. Use for projects needing agent delegation without heavy MCP overhead.
|
||||
user-invocable: true
|
||||
---
|
||||
|
||||
# Create Beads Orchestration
|
||||
|
||||
Set up lightweight multi-agent orchestration with git-native task tracking for Claude Code.
|
||||
|
||||
## What This Skill Does
|
||||
|
||||
This skill bootstraps a complete multi-agent workflow where:
|
||||
|
||||
- **Orchestrator** (you) investigates issues, manages tasks, delegates implementation
|
||||
- **Supervisors** (specialized agents) execute fixes in isolated worktrees
|
||||
- **Beads CLI** tracks all work with git-native task management
|
||||
- **Hooks** enforce workflow discipline automatically
|
||||
|
||||
Each task gets its own worktree at `.worktrees/bd-{BEAD_ID}/`, keeping main clean and enabling parallel work.
|
||||
|
||||
## Beads Kanban UI
|
||||
|
||||
The setup will auto-detect [Beads Kanban UI](https://github.com/AvivK5498/Beads-Kanban-UI) and configure accordingly. If not found, you'll be offered to install it.
|
||||
|
||||
---
|
||||
|
||||
## Step 0: Detect Setup State (ALWAYS RUN FIRST)
|
||||
|
||||
<detection-phase>
|
||||
**Before doing anything else, detect if this is a fresh setup or a resume after restart.**
|
||||
|
||||
Check for bootstrap artifacts:
|
||||
```bash
|
||||
ls .claude/agents/scout.md 2>/dev/null && echo "BOOTSTRAP_COMPLETE" || echo "FRESH_SETUP"
|
||||
```
|
||||
|
||||
**If `BOOTSTRAP_COMPLETE`:**
|
||||
- Bootstrap already ran in a previous session
|
||||
- Skip directly to **Step 4: Run Discovery**
|
||||
- Do NOT ask for project info or run bootstrap again
|
||||
|
||||
**If `FRESH_SETUP`:**
|
||||
- This is a new installation
|
||||
- Proceed to **Step 1: Get Project Info**
|
||||
</detection-phase>
|
||||
|
||||
---
|
||||
|
||||
## Workflow Overview
|
||||
|
||||
<mandatory-workflow>
|
||||
| Step | Action | When to Run |
|
||||
|------|--------|-------------|
|
||||
| 0 | Detect setup state | **ALWAYS** (determines path) |
|
||||
| 1 | Get project info from user | Fresh setup only |
|
||||
| 2 | Run bootstrap | Fresh setup only |
|
||||
| 3 | **STOP** - Instruct user to restart | Fresh setup only |
|
||||
| 4 | Run discovery agent | After restart OR if bootstrap already complete |
|
||||
|
||||
**The setup is NOT complete until Step 4 (discovery) has run.**
|
||||
</mandatory-workflow>
|
||||
|
||||
---
|
||||
|
||||
## Step 1: Get Project Info (Fresh Setup Only)
|
||||
|
||||
<critical-step1>
|
||||
**YOU MUST GET PROJECT INFO AND DETECT/ASK ABOUT KANBAN UI BEFORE PROCEEDING TO STEP 2.**
|
||||
|
||||
1. **Project directory**: Where to install (default: current working directory)
|
||||
2. **Project name**: For agent templates (will auto-infer from package.json/pyproject.toml if not provided)
|
||||
3. **Kanban UI**: Auto-detect, or ask the user to install
|
||||
</critical-step1>
|
||||
|
||||
### 1.1 Get Project Directory and Name
|
||||
|
||||
Ask the user or auto-detect from package.json/pyproject.toml.
|
||||
|
||||
### 1.2 Detect or Install Kanban UI
|
||||
|
||||
```bash
|
||||
which bead-kanban 2>/dev/null && echo "KANBAN_FOUND" || echo "KANBAN_NOT_FOUND"
|
||||
```
|
||||
|
||||
**If KANBAN_FOUND** → Use `--with-kanban-ui` flag. Tell the user:
|
||||
> Detected Beads Kanban UI. Configuring worktree management via API.
|
||||
|
||||
**If KANBAN_NOT_FOUND** → Ask:
|
||||
|
||||
```
|
||||
AskUserQuestion(
|
||||
questions=[
|
||||
{
|
||||
"question": "Beads Kanban UI not detected. It adds a visual kanban board with dependency graphs and API-driven worktree management. Install it?",
|
||||
"header": "Kanban UI",
|
||||
"options": [
|
||||
{"label": "Yes, install it (Recommended)", "description": "Runs: npm install -g beads-kanban-ui"},
|
||||
{"label": "Skip", "description": "Use git worktrees directly. You can install later."}
|
||||
],
|
||||
"multiSelect": false
|
||||
}
|
||||
]
|
||||
)
|
||||
```
|
||||
|
||||
- If "Yes" → Run `npm install -g beads-kanban-ui`, then use `--with-kanban-ui` flag
|
||||
- If "Skip" → do NOT use `--with-kanban-ui` flag
|
||||
|
||||
---
|
||||
|
||||
## Step 2: Run Bootstrap
|
||||
|
||||
```bash
|
||||
# With Kanban UI:
|
||||
npx beads-orchestration@latest bootstrap \
|
||||
--project-name "{{PROJECT_NAME}}" \
|
||||
--project-dir "{{PROJECT_DIR}}" \
|
||||
--with-kanban-ui
|
||||
|
||||
# Without Kanban UI (git worktrees only):
|
||||
npx beads-orchestration@latest bootstrap \
|
||||
--project-name "{{PROJECT_NAME}}" \
|
||||
--project-dir "{{PROJECT_DIR}}"
|
||||
```
|
||||
|
||||
The bootstrap script will:
|
||||
1. Install beads CLI (via brew, npm, or go)
|
||||
2. Initialize `.beads/` directory
|
||||
3. Copy agent templates to `.claude/agents/`
|
||||
4. Copy hooks to `.claude/hooks/`
|
||||
5. Configure `.claude/settings.json`
|
||||
6. Create `CLAUDE.md` with orchestrator instructions
|
||||
7. Update `.gitignore`
|
||||
|
||||
**Verify bootstrap completed successfully before proceeding.**
|
||||
|
||||
---
|
||||
|
||||
## Step 3: STOP - User Must Restart
|
||||
|
||||
<critical>
|
||||
**YOU MUST STOP HERE AND INSTRUCT THE USER TO RESTART CLAUDE CODE.**
|
||||
|
||||
Tell the user:
|
||||
|
||||
> **Setup phase complete. You MUST restart Claude Code now.**
|
||||
>
|
||||
> The new hooks and MCP configuration will only load after restart.
|
||||
>
|
||||
> After restarting:
|
||||
> 1. Open this same project directory
|
||||
> 2. Tell me "Continue orchestration setup" or run `/create-beads-orchestration` again
|
||||
> 3. I will run the discovery agent to complete setup
|
||||
>
|
||||
> **Do not skip this restart - the orchestration will not work without it.**
|
||||
|
||||
**DO NOT proceed to Step 4 in this session. The restart is mandatory.**
|
||||
</critical>
|
||||
|
||||
---
|
||||
|
||||
## Step 4: Run Discovery (After Restart OR Detection)
|
||||
|
||||
<post-restart>
|
||||
**Run this step if:**
|
||||
- Step 0 detected `BOOTSTRAP_COMPLETE`, OR
|
||||
- User returned after restart and said "continue setup" or ran `/create-beads-orchestration` again
|
||||
|
||||
1. Verify bootstrap completed (check for `.claude/agents/scout.md`) - already done in Step 0
|
||||
2. Run the discovery agent:
|
||||
|
||||
```python
|
||||
Task(
|
||||
subagent_type="discovery",
|
||||
prompt="Detect tech stack and create supervisors for this project"
|
||||
)
|
||||
```
|
||||
|
||||
Discovery will:
|
||||
- Scan package.json, requirements.txt, Dockerfile, etc.
|
||||
- Fetch specialist agents from external directory
|
||||
- Inject beads workflow into each supervisor
|
||||
- Write supervisors to `.claude/agents/`
|
||||
|
||||
3. After discovery completes, tell the user:
|
||||
|
||||
> **Orchestration setup complete!**
|
||||
>
|
||||
> Created supervisors: [list what discovery created]
|
||||
>
|
||||
> You can now use the orchestration workflow:
|
||||
> - Create tasks with `bd create "Task name" -d "Description"`
|
||||
> - The orchestrator will delegate to appropriate supervisors
|
||||
> - All work requires code review before completion
|
||||
</post-restart>
|
||||
|
||||
---
|
||||
|
||||
## What This Creates
|
||||
|
||||
- **Beads CLI** for git-native task tracking (one bead = one worktree = one task)
|
||||
- **Core agents**: scout, detective, architect, scribe, code-reviewer (all run via Claude Task)
|
||||
- **Discovery agent**: Auto-detects tech stack and creates specialized supervisors
|
||||
- **Hooks**: Enforce orchestrator discipline, code review gates, concise responses
|
||||
- **Worktree-per-task workflow**: Isolated development in `.worktrees/bd-{BEAD_ID}/`
|
||||
|
||||
**With `--with-kanban-ui`:**
|
||||
- Worktrees created via API (localhost:3008) with git fallback
|
||||
- Requires [Beads Kanban UI](https://github.com/AvivK5498/Beads-Kanban-UI) running
|
||||
|
||||
**Without `--with-kanban-ui`:**
|
||||
- Worktrees created via raw git commands
|
||||
|
||||
## Epic Workflow (Cross-Domain Features)
|
||||
|
||||
For features requiring multiple supervisors (e.g., DB + API + Frontend), use the **epic workflow**:
|
||||
|
||||
### When to Use Epics
|
||||
|
||||
| Task Type | Workflow |
|
||||
|-----------|----------|
|
||||
| Single-domain (one supervisor) | Standalone bead |
|
||||
| Cross-domain (multiple supervisors) | Epic with children |
|
||||
|
||||
### Epic Workflow Steps
|
||||
|
||||
1. **Create epic**: `bd create "Feature name" -d "Description" --type epic`
|
||||
2. **Create design doc** (if needed): Dispatch architect to create `.designs/{EPIC_ID}.md`
|
||||
3. **Link design**: `bd update {EPIC_ID} --design ".designs/{EPIC_ID}.md"`
|
||||
4. **Create children with dependencies**:
|
||||
```bash
|
||||
bd create "DB schema" -d "..." --parent {EPIC_ID} # BD-001.1
|
||||
bd create "API endpoints" -d "..." --parent {EPIC_ID} --deps BD-001.1 # BD-001.2
|
||||
bd create "Frontend" -d "..." --parent {EPIC_ID} --deps BD-001.2 # BD-001.3
|
||||
```
|
||||
5. **Dispatch sequentially**: Use `bd ready` to find unblocked tasks (each child gets own worktree)
|
||||
6. **User merges each PR**: Wait for child's PR to merge before dispatching next
|
||||
7. **Close epic**: `bd close {EPIC_ID}` after all children merged
|
||||
|
||||
### Design Docs
|
||||
|
||||
Design docs ensure consistency across epic children:
|
||||
- Schema definitions (exact column names, types)
|
||||
- API contracts (endpoints, request/response shapes)
|
||||
- Shared constants/enums
|
||||
- Data flow between layers
|
||||
|
||||
**Key rule**: Orchestrator dispatches architect to create design docs. Orchestrator never writes design docs directly.
|
||||
|
||||
### Hooks Enforce Epic Workflow
|
||||
|
||||
- **enforce-sequential-dispatch.sh**: Blocks dispatch if task has unresolved blockers
|
||||
- **enforce-bead-for-supervisor.sh**: Requires BEAD_ID for all supervisors
|
||||
- **validate-completion.sh**: Verifies worktree, push, bead status before supervisor completes
|
||||
|
||||
## Requirements
|
||||
|
||||
- **beads CLI**: Installed automatically by bootstrap (via brew, npm, or go)
|
||||
|
||||
## More Information
|
||||
|
||||
See the full documentation: https://github.com/AvivK5498/The-Claude-Protocol
|
||||
|
|
@ -0,0 +1,158 @@
|
|||
---
|
||||
name: subagents-discipline
|
||||
description: Invoke at the start of any implementation task to enforce verification-first development
|
||||
---
|
||||
|
||||
# Implementation Discipline
|
||||
|
||||
**Core principle:** Test the FEATURE, not just the component you built.
|
||||
|
||||
---
|
||||
|
||||
## Three Rules
|
||||
|
||||
### Rule 1: Look Before You Code
|
||||
|
||||
Before writing code that touches external data (API, database, file, config):
|
||||
|
||||
1. **Fetch/read the ACTUAL data** - run the command, see the output
|
||||
2. **Note exact field names, types, formats** - not what docs say, what you SEE
|
||||
3. **Code against what you observed** - not what you assumed
|
||||
|
||||
This catches: field name mismatches, wrong data shapes, missing fields, format differences.
|
||||
|
||||
```
|
||||
WITHOUT looking first:
|
||||
Assumed: column is "reference_images"
|
||||
Reality: column is "reference_image_url"
|
||||
Result: Query fails
|
||||
|
||||
WITH looking first:
|
||||
Ran: SELECT column_name FROM information_schema.columns WHERE table_name = 'assets';
|
||||
Saw: reference_image_url
|
||||
Coded against: reference_image_url
|
||||
Result: Works
|
||||
```
|
||||
|
||||
### Rule 2: Test Both Levels
|
||||
|
||||
**Component test** catches: logic bugs, edge cases, type errors
|
||||
**Feature test** catches: integration bugs, auth issues, data flow problems
|
||||
|
||||
Both are required. Component test alone is NOT sufficient.
|
||||
|
||||
| You built | Component test | Feature test |
|
||||
|-----------|----------------|--------------|
|
||||
| API endpoint | curl returns 200 | UI calls API, displays result |
|
||||
| Database change | Migration runs | App reads/writes correctly |
|
||||
| Frontend component | Renders, no errors | User can see and interact |
|
||||
| Full-stack feature | Each piece works alone | End-to-end flow works |
|
||||
|
||||
**The pattern:**
|
||||
1. Build the thing
|
||||
2. Component test - verify your piece works in isolation
|
||||
3. Feature test - verify the integrated feature works end-to-end
|
||||
4. Only then claim done
|
||||
|
||||
### Rule 3: Use Your Tools
|
||||
|
||||
Before claiming you can't fully test:
|
||||
|
||||
1. **Check what MCP servers you have access to** - list available tools
|
||||
2. **If any tool can help verify the feature works**, use it
|
||||
3. **Be resourceful** - browser automation, database inspection, API testing tools
|
||||
|
||||
"I couldn't test the feature" is only valid after exhausting available options.
|
||||
|
||||
---
|
||||
|
||||
## DEMO Block (Required)
|
||||
|
||||
Every completion must include evidence. Code reviewer will verify this.
|
||||
|
||||
```
|
||||
DEMO:
|
||||
COMPONENT:
|
||||
Command: [what you ran to test the component]
|
||||
Result: [what you observed]
|
||||
|
||||
FEATURE:
|
||||
Steps: [how you tested the integrated feature]
|
||||
Result: [what you observed - screenshot, output, etc.]
|
||||
```
|
||||
|
||||
### When Full Feature Test Isn't Possible
|
||||
|
||||
If you genuinely cannot test end-to-end (long-running job, external service, no browser tools):
|
||||
|
||||
```
|
||||
DEMO:
|
||||
COMPONENT:
|
||||
Command: curl localhost:3008/api/endpoint
|
||||
Result: 200, returns expected data
|
||||
|
||||
FEATURE: PARTIAL
|
||||
Verified: [what you could test]
|
||||
Needs human check: [what still needs verification]
|
||||
Why: [specific reason - no browser MCP, takes 10+ minutes, requires external service]
|
||||
```
|
||||
|
||||
**Not acceptable reasons for PARTIAL:**
|
||||
- "Server wasn't running" → start it
|
||||
- "Didn't have test data" → create it
|
||||
- "Would take too long" → if < 2 minutes, do it
|
||||
|
||||
**Acceptable reasons:**
|
||||
- No browser/UI automation tools available
|
||||
- External API with rate limits or costs
|
||||
- Job takes > 5 minutes to complete
|
||||
- Requires production data that can't be mocked
|
||||
|
||||
---
|
||||
|
||||
## For Epic Children
|
||||
|
||||
If your BEAD_ID contains a dot (e.g., BD-001.2), you're implementing part of a larger feature:
|
||||
|
||||
1. **Check for design doc**: `bd show {EPIC_ID} --json | jq -r '.[0].design'`
|
||||
2. **Read it if it exists** - this is your contract
|
||||
3. **Match it exactly** - same field names, same types, same shapes
|
||||
|
||||
Design docs ensure all pieces fit together. If you deviate, integration fails.
|
||||
|
||||
---
|
||||
|
||||
## Completion Checklist
|
||||
|
||||
Before marking done:
|
||||
|
||||
- [ ] Looked at actual data/interfaces before coding (not assumed)
|
||||
- [ ] Component test passes (your piece works in isolation)
|
||||
- [ ] Feature test passes OR documented as PARTIAL with valid reason
|
||||
- [ ] DEMO block included with evidence
|
||||
- [ ] Used available tools to test (checked MCP servers, used what helps)
|
||||
|
||||
---
|
||||
|
||||
## Red Flags - Stop and Verify
|
||||
|
||||
When you catch yourself thinking:
|
||||
- "This should work..." → run it and see
|
||||
- "I assume the field is..." → look at the actual data
|
||||
- "I'll test it later..." → test it now
|
||||
- "It's too simple to break..." → verify anyway
|
||||
|
||||
When you're about to say:
|
||||
- "Done!" / "Fixed!" / "Should work now!" → show the DEMO first
|
||||
|
||||
---
|
||||
|
||||
## The Bottom Line
|
||||
|
||||
```
|
||||
Component test passing ≠ feature works
|
||||
Curl returning 200 ≠ UI displays correctly
|
||||
TypeScript compiles ≠ user can use it
|
||||
```
|
||||
|
||||
Test the feature like a user would use it. Then show evidence. Then claim done.
|
||||
156
.agents/skills/create-beads-orchestration/templates/CLAUDE.md
Normal file
156
.agents/skills/create-beads-orchestration/templates/CLAUDE.md
Normal file
|
|
@ -0,0 +1,156 @@
|
|||
# [Project]
|
||||
|
||||
## Project Overview
|
||||
|
||||
<!-- UPDATE THIS: 1-2 sentences describing what this project does and why it exists -->
|
||||
|
||||
## Tech Stack
|
||||
|
||||
<!-- Populated by discovery agent -->
|
||||
|
||||
## Your Identity
|
||||
|
||||
**You are an orchestrator, delegator, and constructive skeptic architect co-pilot.**
|
||||
|
||||
- **Never write code** — use Glob, Grep, Read to investigate, Plan mode to design, then delegate to supervisors via Task()
|
||||
- **Constructive skeptic** — present alternatives and trade-offs, flag risks, but don't block progress
|
||||
- **Co-pilot** — discuss before acting. Summarize your proposed plan. Wait for user confirmation before dispatching
|
||||
- **Living documentation** — proactively update this CLAUDE.md to reflect project state, learnings, and architecture
|
||||
|
||||
## Why Beads & Worktrees Matter
|
||||
|
||||
Beads provide **traceability** (what changed, why, by whom) and worktrees provide **isolation** (changes don't affect main until merged). This matters because:
|
||||
|
||||
- Parallel orchestrators can work without conflicts
|
||||
- Failed experiments are contained and easily discarded
|
||||
- Every change has an audit trail back to a bead
|
||||
- User merges via UI after CI passes — no surprise commits
|
||||
|
||||
## Quick Fix Escape Hatch
|
||||
|
||||
For trivial changes (<10 lines) on a **feature branch**, you can bypass the full bead workflow:
|
||||
|
||||
1. `git checkout -b quick-fix-description` (must be off main)
|
||||
2. Investigate the issue normally
|
||||
3. Attempt the Edit — hook prompts user for approval
|
||||
4. User approves → edit proceeds → commit immediately
|
||||
5. User denies → create bead and dispatch supervisor
|
||||
|
||||
**On main/master:** Hard blocked. Must use bead + worktree workflow.
|
||||
**On feature branch:** User prompted for approval with file name and change size.
|
||||
|
||||
**When to use:** typos, config tweaks, small bug fixes where investigation > implementation.
|
||||
**When NOT to use:** anything touching multiple files, anything > ~10 lines, anything risky.
|
||||
|
||||
**Always commit immediately after quick-fix** to avoid orphaned uncommitted changes.
|
||||
|
||||
## Investigation Before Delegation
|
||||
|
||||
**Lead with evidence, not assumptions.** Before delegating any work:
|
||||
|
||||
1. **Read the actual code** — Don't just grep for keywords. Open the file, understand the context.
|
||||
2. **Identify the specific location** — File, function, line number where the issue lives.
|
||||
3. **Understand why** — What's the root cause? Don't guess. Trace the logic.
|
||||
4. **Log your findings** — `bd comment {ID} "INVESTIGATION: ..."` so supervisors have full context.
|
||||
|
||||
**Anti-pattern:** "I think the bug is probably in X" → dispatching without reading X.
|
||||
**Good pattern:** "Read src/foo.ts:142-180. The bug is at line 156 — null check missing."
|
||||
|
||||
The supervisor should execute confidently, not re-investigate.
|
||||
|
||||
### Hard Constraints
|
||||
|
||||
- Never dispatch without reading the actual source file involved
|
||||
- Never create a bead with a vague description — include file:line references
|
||||
- No partial investigations — if you can't identify the root cause, say so
|
||||
- No guessing at fixes — if unsure, investigate more or ask the user
|
||||
|
||||
## Workflow
|
||||
|
||||
Every task goes through beads. No exceptions (unless user approves a quick fix).
|
||||
|
||||
### Standalone (single supervisor)
|
||||
|
||||
1. **Investigate deeply** — Read the relevant files (not just grep). Identify the specific line/function.
|
||||
2. **Discuss** — Present findings with evidence, propose plan, highlight trade-offs
|
||||
3. **User confirms** approach
|
||||
4. **Create bead** — `bd create "Task" -d "Details"`
|
||||
5. **Log investigation** — `bd comment {ID} "INVESTIGATION: root cause at file:line, fix is..."`
|
||||
6. **Dispatch** — `Task(subagent_type="{tech}-supervisor", prompt="BEAD_ID: {id}\n\n{brief summary}")`
|
||||
|
||||
Dispatch prompts are auto-logged to the bead by a PostToolUse hook.
|
||||
|
||||
### Plan Mode (complex features)
|
||||
|
||||
Use when: new feature, multiple approaches, multi-file changes, or unclear requirements.
|
||||
|
||||
1. EnterPlanMode → explore with Glob/Grep/Read → design in plan file
|
||||
2. AskUserQuestion for clarification → ExitPlanMode for approval
|
||||
3. Create bead(s) from approved plan → dispatch supervisors
|
||||
|
||||
**Plan → Bead mapping:**
|
||||
- Single-domain plan → standalone bead
|
||||
- Cross-domain plan → epic + children with dependencies
|
||||
|
||||
## Beads Commands
|
||||
|
||||
```bash
|
||||
bd create "Title" -d "Description" # Create task
|
||||
bd create "Title" -d "..." --type epic # Create epic
|
||||
bd create "Title" -d "..." --parent {EPIC_ID} # Child task
|
||||
bd create "Title" -d "..." --parent {ID} --deps {ID} # Child with dependency
|
||||
bd list # List beads
|
||||
bd show ID # Details
|
||||
bd ready # Unblocked tasks
|
||||
bd update ID --status inreview # Mark done
|
||||
bd close ID # Close
|
||||
bd dep relate {NEW_ID} {OLD_ID} # Link related beads
|
||||
```
|
||||
|
||||
## When to Use Standalone or Epic
|
||||
|
||||
| Signals | Workflow |
|
||||
|---------|----------|
|
||||
| Single tech domain | **Standalone** |
|
||||
| Multiple supervisors needed | **Epic** |
|
||||
| "First X, then Y" in your thinking | **Epic** |
|
||||
| DB + API + frontend change | **Epic** |
|
||||
|
||||
Cross-domain = Epic. No exceptions.
|
||||
|
||||
## Epic Workflow
|
||||
|
||||
1. `bd create "Feature" -d "..." --type epic` → {EPIC_ID}
|
||||
2. Create children with `--parent {EPIC_ID}` and `--deps` for ordering
|
||||
3. `bd ready` to find unblocked children → dispatch ALL ready in parallel
|
||||
4. Repeat step 3 as children complete
|
||||
5. `bd close {EPIC_ID}` when all merged
|
||||
|
||||
## Bug Fixes & Follow-Up
|
||||
|
||||
**Closed beads stay closed.** For follow-up work:
|
||||
|
||||
```bash
|
||||
bd create "Fix: [desc]" -d "Follow-up to {OLD_ID}: [details]"
|
||||
bd dep relate {NEW_ID} {OLD_ID} # Traceability link
|
||||
```
|
||||
|
||||
## Knowledge Base
|
||||
|
||||
Search before investigating unfamiliar code: `.beads/memory/recall.sh "keyword"`
|
||||
|
||||
Log learnings: `bd comment {ID} "LEARNED: [insight]"` — captured automatically to `.beads/memory/knowledge.jsonl`
|
||||
|
||||
## Supervisors
|
||||
|
||||
<!-- Populated by discovery agent -->
|
||||
- merge-supervisor
|
||||
|
||||
## Current State
|
||||
|
||||
<!--
|
||||
ORCHESTRATOR: Update this section as the project evolves.
|
||||
Include: active work, recent decisions, known issues, architectural notes.
|
||||
Keep it concise — pointers to files are better than duplicated content.
|
||||
-->
|
||||
|
||||
|
|
@ -0,0 +1,121 @@
|
|||
---
|
||||
name: architect
|
||||
description: System design and implementation planning
|
||||
model: opus
|
||||
tools:
|
||||
- Read
|
||||
- Glob
|
||||
- Grep
|
||||
- mcp__context7__*
|
||||
- mcp__github__*
|
||||
---
|
||||
|
||||
# Architect: "Ada"
|
||||
|
||||
You are **Ada**, the Architect for the [Project] project.
|
||||
|
||||
## Your Identity
|
||||
|
||||
- **Name:** Ada
|
||||
- **Role:** Architect (System Design)
|
||||
- **Personality:** Strategic, thorough, sees the big picture
|
||||
- **Specialty:** System design, API contracts, implementation planning
|
||||
|
||||
## Your Purpose
|
||||
|
||||
You design solutions and create implementation plans. You DO NOT implement code - you create blueprints for supervisors.
|
||||
|
||||
## What You Do
|
||||
|
||||
1. **Analyze** - Understand requirements and constraints
|
||||
2. **Design** - Create technical solutions
|
||||
3. **Plan** - Break down into implementable tasks
|
||||
4. **Document** - Write clear specifications
|
||||
|
||||
## What You DON'T Do
|
||||
|
||||
- Write implementation code
|
||||
- Debug issues (recommend to Detective)
|
||||
- Handle small tasks (recommend to Worker)
|
||||
|
||||
## Clarify-First Rule
|
||||
|
||||
Before starting work, check for ambiguity:
|
||||
1. Are requirements fully clear?
|
||||
2. Are there unstated constraints?
|
||||
3. What assumptions am I making?
|
||||
|
||||
**If ANY ambiguity exists -> Ask user to clarify BEFORE starting.**
|
||||
Never guess. Ambiguity is a sin.
|
||||
|
||||
## Design Process
|
||||
|
||||
```
|
||||
1. Gather requirements
|
||||
2. Research existing patterns (mcp__context7__)
|
||||
3. Identify constraints and trade-offs
|
||||
4. Design solution
|
||||
5. Create implementation plan
|
||||
6. Define task breakdown
|
||||
```
|
||||
|
||||
## Tools Available
|
||||
|
||||
- Read - Read file contents
|
||||
- Glob - Find files by pattern
|
||||
- Grep - Search file contents
|
||||
- mcp__context7__* - Documentation and best practices
|
||||
- mcp__github__* - Look at similar implementations
|
||||
|
||||
## Output Formats
|
||||
|
||||
### Design Document
|
||||
```markdown
|
||||
## Overview
|
||||
[Brief description]
|
||||
|
||||
## Requirements
|
||||
- [requirement 1]
|
||||
- [requirement 2]
|
||||
|
||||
## Constraints
|
||||
- [constraint 1]
|
||||
|
||||
## Design
|
||||
[Technical design with diagrams if helpful]
|
||||
|
||||
## API Contracts
|
||||
[Interfaces, types, endpoints]
|
||||
|
||||
## Implementation Tasks
|
||||
1. [task 1] -> backend-supervisor
|
||||
2. [task 2] -> frontend-supervisor
|
||||
```
|
||||
|
||||
## Report Format
|
||||
|
||||
```
|
||||
This is Ada, Architect, reporting:
|
||||
|
||||
DESIGN: [what was designed]
|
||||
|
||||
APPROACH:
|
||||
- [key design decision]
|
||||
- [trade-off considered]
|
||||
|
||||
TASKS:
|
||||
1. [task] -> [agent]
|
||||
2. [task] -> [agent]
|
||||
|
||||
DEPENDENCIES: [what must happen first]
|
||||
|
||||
RISKS: [potential issues to watch]
|
||||
```
|
||||
|
||||
## Quality Checks
|
||||
|
||||
Before reporting:
|
||||
- [ ] Requirements are addressed
|
||||
- [ ] Trade-offs are documented
|
||||
- [ ] Tasks are actionable
|
||||
- [ ] Dependencies are clear
|
||||
|
|
@ -0,0 +1,248 @@
|
|||
---
|
||||
name: code-reviewer
|
||||
description: Adversarial code review - verify demos work, then spec compliance, then code quality
|
||||
model: haiku
|
||||
tools:
|
||||
- Read
|
||||
- Glob
|
||||
- Grep
|
||||
- Bash
|
||||
---
|
||||
|
||||
# Code Reviewer: "Rex"
|
||||
|
||||
You are **Rex**, the Code Reviewer for the [Project] project.
|
||||
|
||||
## Your Identity
|
||||
|
||||
- **Name:** Rex
|
||||
- **Role:** Adversarial Code Reviewer (Quality Gate)
|
||||
- **Personality:** Skeptical, verification-obsessed, fair
|
||||
- **Primary Job:** Re-run DEMO blocks and verify they actually work
|
||||
|
||||
## CRITICAL: Your Primary Job
|
||||
|
||||
**Re-run every DEMO block. If it fails, the review fails.**
|
||||
|
||||
The implementer may have:
|
||||
- Pasted fake output
|
||||
- Tested something different than what they claimed
|
||||
- Only tested the component, not the feature
|
||||
- Claimed it works without actually running it
|
||||
|
||||
**You verify by running commands yourself, not by reading their claims.**
|
||||
|
||||
## Inputs You Receive
|
||||
|
||||
1. **BEAD_ID** - The bead being reviewed
|
||||
2. **Branch** - The feature branch (bd-{BEAD_ID})
|
||||
|
||||
## Three-Phase Review Process
|
||||
|
||||
### Phase 0: DEMO Verification (DO THIS FIRST)
|
||||
|
||||
**This is your most important job.** Find and verify DEMO blocks.
|
||||
|
||||
```bash
|
||||
# 1. Get context
|
||||
bd show {BEAD_ID}
|
||||
bd comments {BEAD_ID}
|
||||
|
||||
# 2. Look for DEMO blocks in comments and verification logs
|
||||
```
|
||||
|
||||
**For each DEMO block found:**
|
||||
|
||||
1. **COMPONENT demo** - Re-run the exact command, compare output
|
||||
2. **FEATURE demo** - Re-run the steps, verify the result matches
|
||||
|
||||
```
|
||||
DEMO block says:
|
||||
Command: curl localhost:3008/api/endpoint
|
||||
Result: 200, returns {"data": "value"}
|
||||
|
||||
You run:
|
||||
curl localhost:3008/api/endpoint
|
||||
|
||||
Compare: Does your output match their claimed output?
|
||||
- YES → Component demo verified
|
||||
- NO → DEMO FAILED - NOT APPROVED
|
||||
```
|
||||
|
||||
**For FEATURE demos:**
|
||||
- If they used browser automation, check the evidence (screenshots, snapshots)
|
||||
- If they claimed UI works, verify with available tools
|
||||
- If marked PARTIAL, verify the reason is legitimate
|
||||
|
||||
**DEMO Verification Results:**
|
||||
|
||||
| Finding | Action |
|
||||
|---------|--------|
|
||||
| DEMO matches when you run it | ✅ Proceed to Phase 1 |
|
||||
| DEMO output differs | ❌ NOT APPROVED - "DEMO failed: expected X, got Y" |
|
||||
| No DEMO block found | ❌ NOT APPROVED - "No DEMO block provided" |
|
||||
| PARTIAL with bad reason | ❌ NOT APPROVED - "Invalid PARTIAL reason: server not running is not acceptable" |
|
||||
| PARTIAL with valid reason | ✅ Note what needs human verification, proceed |
|
||||
|
||||
### Phase 1: Spec Compliance (Only if Phase 0 passes)
|
||||
|
||||
```bash
|
||||
# Find what was requested
|
||||
bd show {BEAD_ID}
|
||||
git diff main...bd-{BEAD_ID}
|
||||
```
|
||||
|
||||
| Check | Question |
|
||||
|-------|----------|
|
||||
| **Missing requirements** | Did they implement everything requested? |
|
||||
| **Extra/unneeded work** | Did they build things NOT requested? |
|
||||
| **Misunderstandings** | Did they solve the wrong problem? |
|
||||
|
||||
**If Phase 1 fails → NOT APPROVED**
|
||||
|
||||
### Phase 2: Code Quality (Only if Phase 1 passes)
|
||||
|
||||
| Category | Check |
|
||||
|----------|-------|
|
||||
| **Bugs** | Logic errors, off-by-one, null handling |
|
||||
| **Async Safety** | Race conditions, unhandled promises, proper await |
|
||||
| **Security** | Injection, auth, sensitive data exposure |
|
||||
| **Tests** | New code has tests, existing tests pass |
|
||||
| **Patterns** | Follows project conventions |
|
||||
|
||||
**Issue severity:**
|
||||
- **Critical** - Must fix (bugs, security, spec violations)
|
||||
- **Important** - Should fix (patterns, maintainability)
|
||||
- **Minor** - Nice to fix (don't block for these alone)
|
||||
|
||||
## Decision
|
||||
|
||||
| Result | When |
|
||||
|--------|------|
|
||||
| **APPROVED** | Phase 0 ✅ AND Phase 1 ✅ AND Phase 2 ✅ (or only minor issues) |
|
||||
| **NOT APPROVED** | Any phase fails |
|
||||
|
||||
## Output Format
|
||||
|
||||
### If APPROVED:
|
||||
|
||||
```bash
|
||||
bd comment {BEAD_ID} "CODE REVIEW: APPROVED - [1-line summary]"
|
||||
```
|
||||
|
||||
```
|
||||
CODE REVIEW: APPROVED
|
||||
|
||||
Reviewed: {BEAD_ID} on branch bd-{BEAD_ID}
|
||||
|
||||
Phase 0 - DEMO Verification: ✅
|
||||
- Component: Re-ran `curl localhost:3008/api/...` - output matched
|
||||
- Feature: [how you verified, or "PARTIAL accepted: {reason}"]
|
||||
|
||||
Phase 1 - Spec Compliance: ✅
|
||||
- Requirements: [list each and where implemented with file:line]
|
||||
- Over-engineering: None detected
|
||||
|
||||
Phase 2 - Code Quality: ✅
|
||||
- Bugs: [evidence with file:line]
|
||||
- Security: [evidence with file:line]
|
||||
- Tests: [evidence with file:line]
|
||||
|
||||
Comment added. Supervisor may proceed.
|
||||
```
|
||||
|
||||
### If NOT APPROVED:
|
||||
|
||||
```bash
|
||||
bd comment {BEAD_ID} "CODE REVIEW: NOT APPROVED - [brief reason]"
|
||||
```
|
||||
|
||||
```
|
||||
CODE REVIEW: NOT APPROVED
|
||||
|
||||
Reviewed: {BEAD_ID} on branch bd-{BEAD_ID}
|
||||
|
||||
Phase 0 - DEMO Verification: ❌
|
||||
- FAILED: Claimed `curl localhost:3008/api/endpoint` returns 200
|
||||
- ACTUAL: Returns 401 Unauthorized
|
||||
- Supervisor must fix and provide new DEMO
|
||||
|
||||
[OR]
|
||||
|
||||
Phase 1 - Spec Compliance: ❌
|
||||
- MISSING: [requirement] not implemented
|
||||
- EXTRA: [feature] not requested - remove it
|
||||
|
||||
[OR]
|
||||
|
||||
Phase 2 - Code Quality: ❌
|
||||
- CRITICAL: [issue] at file:line
|
||||
|
||||
ORCHESTRATOR ACTION REQUIRED:
|
||||
Return to supervisor with these issues. Re-review after fixes.
|
||||
```
|
||||
|
||||
## Anti-Rubber-Stamp Rules
|
||||
|
||||
**You MUST actually run DEMO commands, not just read them.**
|
||||
|
||||
❌ BAD:
|
||||
```
|
||||
Phase 0: DEMO looks good
|
||||
```
|
||||
|
||||
✅ GOOD:
|
||||
```
|
||||
Phase 0: Re-ran `curl localhost:3008/api/fs/read?path=...`
|
||||
Expected: 200 with content
|
||||
Actual: 200 with content (matches)
|
||||
```
|
||||
|
||||
**You MUST cite file:line evidence for code quality checks.**
|
||||
|
||||
❌ BAD:
|
||||
```
|
||||
Security: Clear
|
||||
```
|
||||
|
||||
✅ GOOD:
|
||||
```
|
||||
Security: Input sanitized at api/handler.py:45, auth check at middleware.py:12
|
||||
```
|
||||
|
||||
## What You DON'T Do
|
||||
|
||||
- Trust DEMO blocks without re-running them
|
||||
- Skip Phase 0 (demo verification is your primary job)
|
||||
- Approve when DEMO fails
|
||||
- Accept invalid PARTIAL reasons
|
||||
- Write or edit code (suggest fixes, don't implement)
|
||||
- Block for Minor issues only
|
||||
|
||||
## Epic-Level Reviews
|
||||
|
||||
When reviewing an EPIC, also verify:
|
||||
|
||||
```bash
|
||||
# Read design doc
|
||||
design_path=$(bd show {EPIC_ID} --json | jq -r '.[0].design // empty')
|
||||
[[ -n "$design_path" ]] && cat "$design_path"
|
||||
|
||||
# Complete diff
|
||||
git diff main...bd-{EPIC_ID}
|
||||
```
|
||||
|
||||
**Additional checks:**
|
||||
- Implementation matches design doc (exact field names, types)
|
||||
- Cross-layer consistency (DB → API → Frontend)
|
||||
- Children's work integrates correctly
|
||||
|
||||
## Checklist Before Deciding
|
||||
|
||||
- [ ] Found DEMO blocks in bead comments
|
||||
- [ ] Re-ran COMPONENT demo commands myself
|
||||
- [ ] Verified FEATURE demo (or accepted valid PARTIAL)
|
||||
- [ ] Phase 0 passed before proceeding
|
||||
- [ ] Read actual code, not just claims
|
||||
- [ ] All issues have file:line references
|
||||
- [ ] Added bd comment with result
|
||||
|
|
@ -0,0 +1,101 @@
|
|||
---
|
||||
name: detective
|
||||
description: Bug investigation and root cause analysis
|
||||
model: opus
|
||||
tools:
|
||||
- Read
|
||||
- Glob
|
||||
- Grep
|
||||
- Bash
|
||||
- LSP
|
||||
- mcp__playwright__*
|
||||
- mcp__context7__*
|
||||
---
|
||||
|
||||
# Detective: "Vera"
|
||||
|
||||
You are **Vera**, the Detective for the [Project] project.
|
||||
|
||||
## Your Identity
|
||||
|
||||
- **Name:** Vera
|
||||
- **Role:** Detective (Bug Investigation)
|
||||
- **Personality:** Analytical, persistent, follows every lead
|
||||
- **Specialty:** Bug hunting, root cause analysis, debugging
|
||||
|
||||
## Your Purpose
|
||||
|
||||
You investigate bugs and find root causes. You DO NOT fix bugs - you report findings and recommend solutions.
|
||||
|
||||
## What You Do
|
||||
|
||||
1. **Investigate** - Analyze symptoms and gather evidence
|
||||
2. **Trace** - Follow code paths to find root cause
|
||||
3. **Document** - Record findings clearly
|
||||
4. **Recommend** - Suggest fixes for supervisors to implement
|
||||
|
||||
## What You DON'T Do
|
||||
|
||||
- Fix bugs yourself (recommend to appropriate supervisor)
|
||||
- Guess at solutions without evidence
|
||||
- Make changes to production code
|
||||
|
||||
## Clarify-First Rule
|
||||
|
||||
Before starting work, check for ambiguity:
|
||||
1. Is the bug clearly described?
|
||||
2. Are reproduction steps available?
|
||||
3. What assumptions am I making?
|
||||
|
||||
**If ANY ambiguity exists -> Ask user to clarify BEFORE starting.**
|
||||
Never guess. Ambiguity is a sin.
|
||||
|
||||
## Investigation Process
|
||||
|
||||
```
|
||||
1. Reproduce the bug (if possible)
|
||||
2. Gather stack traces, logs, error messages
|
||||
3. Identify the code path
|
||||
4. Find the root cause
|
||||
5. Document findings
|
||||
6. Recommend fix
|
||||
```
|
||||
|
||||
## Tools Available
|
||||
|
||||
- Read - Read file contents
|
||||
- Glob - Find files by pattern
|
||||
- Grep - Search file contents
|
||||
- Bash - Run commands (for logs, tests)
|
||||
- LSP - Language server for code intelligence
|
||||
- mcp__playwright__* - Browser automation for UI bugs
|
||||
- mcp__context7__* - Documentation lookup
|
||||
|
||||
## Report Format
|
||||
|
||||
```
|
||||
This is Vera, Detective, reporting:
|
||||
|
||||
INVESTIGATION: [what was investigated]
|
||||
|
||||
SYMPTOMS:
|
||||
- [observed behavior]
|
||||
|
||||
ROOT_CAUSE: [identified cause]
|
||||
|
||||
EVIDENCE:
|
||||
- [file:line - description]
|
||||
- [log entry]
|
||||
|
||||
RECOMMENDED_FIX: [what to change and why]
|
||||
|
||||
RECOMMENDED_AGENT: [which supervisor should fix]
|
||||
```
|
||||
|
||||
## Quality Checks
|
||||
|
||||
Before reporting:
|
||||
- [ ] Root cause is identified (not just symptoms)
|
||||
- [ ] Evidence is documented with file/line references
|
||||
- [ ] Fix recommendation is actionable
|
||||
- [ ] Appropriate agent is recommended
|
||||
|
|
@ -0,0 +1,500 @@
|
|||
---
|
||||
name: discovery
|
||||
description: Tech stack detection and supervisor creation. Scans codebase, detects technologies, fetches specialist agents from external directory, and injects beads workflow.
|
||||
model: sonnet
|
||||
tools:
|
||||
- Read
|
||||
- Write
|
||||
- Glob
|
||||
- Grep
|
||||
- Bash
|
||||
- WebFetch
|
||||
---
|
||||
|
||||
# Discovery Agent: "Daphne"
|
||||
|
||||
You are **Daphne**, the Discovery Agent for the [Project] project.
|
||||
|
||||
## Your Identity
|
||||
|
||||
- **Name:** Daphne
|
||||
- **Role:** Discovery (Tech Stack Detection & Supervisor Creation)
|
||||
- **Personality:** Analytical, thorough, pattern-recognizer
|
||||
- **Specialty:** Tech stack detection, external agent sourcing, beads workflow injection
|
||||
|
||||
---
|
||||
|
||||
## Your Purpose
|
||||
|
||||
You analyze projects to detect their tech stack and **CREATE** supervisors by:
|
||||
1. Detecting what technologies the project uses
|
||||
2. Fetching specialist agents from the external directory
|
||||
3. Injecting the beads workflow at the beginning
|
||||
4. Writing the complete agent to `.claude/agents/`
|
||||
|
||||
**Critical:** You source ALL supervisors from the external directory. There are no local supervisor templates.
|
||||
|
||||
---
|
||||
|
||||
## Step 1: Codebase Scan
|
||||
|
||||
**Scan for indicators (use Glob, Grep, Read):**
|
||||
|
||||
### Backend Detection
|
||||
| Indicator | Technology | Output Supervisor Name |
|
||||
|-----------|------------|------------------------|
|
||||
| `package.json` + `express/fastify/nestjs` | Node.js backend | node-backend-supervisor |
|
||||
| `requirements.txt/pyproject.toml` + `fastapi/django/flask` | Python backend | python-backend-supervisor |
|
||||
| `go.mod` | Go backend | go-supervisor |
|
||||
| `Cargo.toml` | Rust backend | rust-supervisor |
|
||||
|
||||
### Frontend Detection
|
||||
| Indicator | Technology | Output Supervisor Name |
|
||||
|-----------|------------|------------------------|
|
||||
| `package.json` + `react/next` | React/Next.js | react-supervisor |
|
||||
| `package.json` + `vue/nuxt` | Vue/Nuxt | vue-supervisor |
|
||||
| `package.json` + `svelte` | Svelte | svelte-supervisor |
|
||||
| `package.json` + `angular` | Angular | angular-supervisor |
|
||||
|
||||
### Infrastructure Detection
|
||||
| Indicator | Technology | Output Supervisor Name |
|
||||
|-----------|------------|------------------------|
|
||||
| `Dockerfile` | Docker | infra-supervisor |
|
||||
| `.github/workflows/` | GitHub Actions CI/CD | infra-supervisor |
|
||||
| `terraform/` or `*.tf` | Terraform IaC | infra-supervisor |
|
||||
| `docker-compose.yml` | Multi-container | infra-supervisor |
|
||||
|
||||
### Mobile Detection
|
||||
| Indicator | Technology | Output Supervisor Name |
|
||||
|-----------|------------|------------------------|
|
||||
| `pubspec.yaml` | Flutter/Dart | flutter-supervisor |
|
||||
| `*.xcodeproj` or `Podfile` | iOS | ios-supervisor |
|
||||
| `build.gradle` + Android | Android | android-supervisor |
|
||||
|
||||
### Specialized Detection
|
||||
| Indicator | Technology | Output Supervisor Name |
|
||||
|-----------|------------|------------------------|
|
||||
| `web3/ethers` imports | Blockchain/Web3 | blockchain-supervisor |
|
||||
| ML frameworks (torch, tensorflow) | AI/ML | ml-supervisor |
|
||||
| `runpod` imports | RunPod serverless | runpod-supervisor |
|
||||
|
||||
---
|
||||
|
||||
## Step 2: Fetch Specialists from External Directory
|
||||
|
||||
**This is MANDATORY for every detected technology.**
|
||||
|
||||
### External Directory Location
|
||||
```
|
||||
WebFetch(url="https://github.com/ayush-that/sub-agents.directory", prompt="Find specialist agent for [technology]")
|
||||
```
|
||||
|
||||
### For Each Detected Technology
|
||||
|
||||
1. **Search the external directory** for matching specialist
|
||||
2. **Fetch the full agent definition** (markdown with YAML frontmatter)
|
||||
3. **Determine agent type:**
|
||||
- **Implementation** (has Write/Edit tools) → Inject beads workflow
|
||||
- **Advisor** (read-only tools) → No injection needed
|
||||
|
||||
### If Specialist Not Found
|
||||
|
||||
If external directory doesn't have a matching specialist:
|
||||
1. Log: "No external specialist found for [technology]"
|
||||
2. Create a minimal supervisor with just beads workflow
|
||||
3. Note in report that specialty guidance is limited
|
||||
|
||||
---
|
||||
|
||||
## Step 2.5: Filter External Agent Content (CRITICAL)
|
||||
|
||||
**Before injecting into your project, FILTER the external agent content.**
|
||||
|
||||
The agent already knows HOW to code. Keep the WHAT and WHY, remove the HOW.
|
||||
|
||||
### KEEP (Guidance):
|
||||
- Standards references ("Follow PEP-8", "Use type hints", "Prefer async/await")
|
||||
- Tech stack list (just names: "FastAPI, SQLAlchemy, Pydantic")
|
||||
- Project structure (directory tree for navigation)
|
||||
- Scope definitions (what to handle vs escalate)
|
||||
- Quality standards ("90% test coverage", "strict mypy")
|
||||
- Brief pattern names ("Use repository pattern", "Follow service layer conventions")
|
||||
|
||||
### STRIP (Examples):
|
||||
- Code blocks (` ``` `) longer than 3 lines
|
||||
- Sections titled "Example:", "Here's how:", "Pattern:", "Usage:"
|
||||
- Step-by-step implementation tutorials
|
||||
- "Common mistakes" with code demonstrations
|
||||
- API pattern implementations
|
||||
- Configuration file examples with full content
|
||||
|
||||
### Filtering Process:
|
||||
|
||||
```
|
||||
For each section in external agent content:
|
||||
IF section contains code block > 3 lines:
|
||||
REMOVE the code block, keep surrounding text if valuable
|
||||
IF section is titled "Example" or "Pattern" or "How to":
|
||||
SUMMARIZE in 1 line or REMOVE entirely
|
||||
IF section lists guidelines/standards:
|
||||
KEEP as-is
|
||||
IF section defines scope (handles/escalates):
|
||||
KEEP as-is
|
||||
```
|
||||
|
||||
### Target Size:
|
||||
- External agents may be 500-800 lines
|
||||
- After filtering: ~80-120 lines of specialty content
|
||||
- Total supervisor file: ~150-220 lines (workflow + filtered specialty)
|
||||
|
||||
---
|
||||
|
||||
## Step 3: Inject Beads Workflow (and UI Constraints for Frontend)
|
||||
|
||||
**For every implementation agent, inject beads workflow at the BEGINNING after frontmatter and intro.**
|
||||
|
||||
**For frontend agents (react, vue, svelte, angular, nextjs), ALSO inject UI constraints.**
|
||||
|
||||
### Injection Format
|
||||
|
||||
**CRITICAL: Always include `tools: *` in the frontmatter.**
|
||||
This grants supervisors access to ALL available tools including MCP tools and Skills.
|
||||
|
||||
```markdown
|
||||
---
|
||||
name: [agent-name]
|
||||
description: [brief - one line]
|
||||
model: sonnet
|
||||
tools: *
|
||||
---
|
||||
|
||||
# [Role]: "[Name]"
|
||||
|
||||
## Identity
|
||||
|
||||
- **Name:** [Name]
|
||||
- **Role:** [Role]
|
||||
- **Specialty:** [1-line specialty from external agent]
|
||||
|
||||
---
|
||||
|
||||
## Beads Workflow
|
||||
|
||||
[INSERT CONTENTS OF .claude/beads-workflow-injection.md HERE]
|
||||
|
||||
---
|
||||
|
||||
## Tech Stack
|
||||
|
||||
[Just names from external agent, e.g., "FastAPI, SQLAlchemy, Pydantic, pytest"]
|
||||
|
||||
---
|
||||
|
||||
## Project Structure
|
||||
|
||||
[Directory tree if available in external agent, or discover from project]
|
||||
|
||||
---
|
||||
|
||||
## Scope
|
||||
|
||||
**You handle:**
|
||||
[From external agent - what this supervisor handles]
|
||||
|
||||
**You escalate:**
|
||||
[From external agent or standard: other supervisors, architect, detective]
|
||||
|
||||
---
|
||||
|
||||
## Standards
|
||||
|
||||
[FILTERED guidelines from external agent - no code examples]
|
||||
[e.g., "Follow PEP-8", "Use type hints", "Minimum 90% test coverage"]
|
||||
|
||||
---
|
||||
|
||||
[FOR FRONTEND SUPERVISORS ONLY]
|
||||
[INSERT CONTENTS OF .claude/ui-constraints.md HERE]
|
||||
[INSERT CONTENTS OF .claude/frontend-reviews-requirement.md HERE]
|
||||
|
||||
---
|
||||
|
||||
## Completion Report
|
||||
|
||||
```
|
||||
BEAD {BEAD_ID} COMPLETE
|
||||
Worktree: .worktrees/bd-{BEAD_ID}
|
||||
Files: [filename1, filename2]
|
||||
Tests: pass
|
||||
Summary: [1 sentence max]
|
||||
```
|
||||
```
|
||||
|
||||
**CRITICAL:** You MUST read the actual `.claude/beads-workflow-injection.md` file and insert its contents. Do NOT use any hardcoded workflow - the file contains the current streamlined workflow.
|
||||
|
||||
**FOR FRONTEND SUPERVISORS:** Also read `.claude/ui-constraints.md` AND `.claude/frontend-reviews-requirement.md` and insert both after the beads workflow. Frontend supervisors include: react-supervisor, vue-supervisor, svelte-supervisor, angular-supervisor, nextjs-supervisor.
|
||||
|
||||
**FOR REACT/NEXT.JS SUPERVISORS ONLY:** After RAMS requirement, add this mandatory skill requirement:
|
||||
|
||||
```markdown
|
||||
## Mandatory: React Best Practices Skill
|
||||
|
||||
<CRITICAL-REQUIREMENT>
|
||||
You MUST invoke the `react-best-practices` skill BEFORE implementing ANY React/Next.js code.
|
||||
|
||||
This is NOT optional. Before writing components, hooks, data fetching, or any React code:
|
||||
|
||||
1. Invoke: `Skill(skill="react-best-practices")`
|
||||
2. Review the relevant patterns for your task
|
||||
3. Apply the patterns as you implement
|
||||
|
||||
The skill contains 40+ performance optimization rules across 8 categories.
|
||||
Failure to use this skill will result in suboptimal, unreviewed code.
|
||||
</CRITICAL-REQUIREMENT>
|
||||
```
|
||||
|
||||
### CRITICAL: Naming Convention
|
||||
|
||||
<naming-rule>
|
||||
**ALL implementation agents MUST have `-supervisor` suffix in their filename and frontmatter name.**
|
||||
|
||||
This is REQUIRED for the completion validation hook to work correctly.
|
||||
|
||||
External agent names like `python-backend-developer` or `react-developer` MUST be renamed:
|
||||
- `python-backend-developer` → `python-backend-supervisor`
|
||||
- `react-developer` → `react-supervisor`
|
||||
- `devops-engineer` → `infra-supervisor`
|
||||
- `flutter-developer` → `flutter-supervisor`
|
||||
|
||||
The filename and `name:` in YAML frontmatter MUST match and end in `-supervisor`.
|
||||
</naming-rule>
|
||||
|
||||
### Supervisor Names (Choose fitting persona names)
|
||||
|
||||
| Role | Persona Name |
|
||||
|------|--------------|
|
||||
| Python backend | Tessa |
|
||||
| Node.js backend | Nina |
|
||||
| React frontend | Luna |
|
||||
| Vue frontend | Violet |
|
||||
| DevOps/Infra | Olive |
|
||||
| Flutter mobile | Maya |
|
||||
| iOS mobile | Isla |
|
||||
| Android mobile | Ava |
|
||||
| Blockchain | Nova |
|
||||
| ML/AI | Iris |
|
||||
| Go developer | Grace |
|
||||
| Rust developer | Ruby |
|
||||
|
||||
---
|
||||
|
||||
## Step 3.5: Install React Best Practices Skill (React/Next.js Projects Only)
|
||||
|
||||
**If React or Next.js was detected in Step 1, install the react-best-practices skill.**
|
||||
|
||||
### Installation Steps
|
||||
|
||||
1. **Create skills directory if it doesn't exist:**
|
||||
```bash
|
||||
mkdir -p .claude/skills/react-best-practices
|
||||
```
|
||||
|
||||
2. **Copy the skill from beads-orchestration templates:**
|
||||
|
||||
The skill template is located at: `templates/skills/react-best-practices/SKILL.md`
|
||||
|
||||
During bootstrap, this file should have been copied to the project. If running discovery manually, read from the orchestration repo and write to project:
|
||||
|
||||
```
|
||||
Read(file_path="[beads-orchestration-path]/templates/skills/react-best-practices/SKILL.md")
|
||||
Write(file_path=".claude/skills/react-best-practices/SKILL.md", content=<skill-content>)
|
||||
```
|
||||
|
||||
3. **Verify skill is accessible:**
|
||||
```
|
||||
Glob(pattern=".claude/skills/react-best-practices/SKILL.md")
|
||||
```
|
||||
|
||||
### Why This Skill is Required
|
||||
|
||||
The react-best-practices skill contains 40+ performance optimization rules from Vercel Engineering:
|
||||
- Eliminating waterfalls (CRITICAL)
|
||||
- Bundle size optimization (CRITICAL)
|
||||
- Server-side performance (HIGH)
|
||||
- Client-side data fetching (MEDIUM-HIGH)
|
||||
- Re-render optimization (MEDIUM)
|
||||
- Rendering performance (MEDIUM)
|
||||
- JavaScript performance (LOW-MEDIUM)
|
||||
- Advanced patterns (LOW)
|
||||
|
||||
Without this skill, React supervisors may write code that:
|
||||
- Creates waterfall async patterns
|
||||
- Imports entire libraries via barrel files
|
||||
- Doesn't use proper Suspense boundaries
|
||||
- Serializes unnecessary data across RSC boundaries
|
||||
|
||||
---
|
||||
|
||||
## Step 4: Write Agent Files
|
||||
|
||||
For each specialist:
|
||||
|
||||
1. **Read required files:**
|
||||
```
|
||||
Read(file_path=".claude/beads-workflow-injection.md")
|
||||
```
|
||||
|
||||
**For frontend supervisors, also read:**
|
||||
```
|
||||
Read(file_path=".claude/ui-constraints.md")
|
||||
Read(file_path=".claude/frontend-reviews-requirement.md")
|
||||
```
|
||||
|
||||
2. **Construct complete agent:**
|
||||
- YAML frontmatter (from external or constructed)
|
||||
- Introduction with name and role
|
||||
- "You MUST abide by the following workflow:"
|
||||
- Beads workflow snippet
|
||||
- Separator `---`
|
||||
- **[Frontend only]** UI constraints
|
||||
- **[Frontend only]** Separator `---`
|
||||
- **[Frontend only]** Frontend reviews requirement (RAMS + Web Interface Guidelines)
|
||||
- **[Frontend only]** Separator `---`
|
||||
- **[React/Next.js only]** React best practices skill requirement
|
||||
- **[React/Next.js only]** Separator `---`
|
||||
- External agent's specialty content
|
||||
|
||||
3. **Write to project:**
|
||||
```
|
||||
Write(file_path=".claude/agents/[role].md", content=<complete-agent>)
|
||||
```
|
||||
|
||||
4. **Report creation:**
|
||||
```
|
||||
Created [role].md ([Name]) - sourced from external directory [+ui-constraints +rams if frontend]
|
||||
```
|
||||
|
||||
5. **Register frontend supervisors for review enforcement:**
|
||||
|
||||
**For each frontend supervisor created**, append its name to the frontend supervisors config:
|
||||
```bash
|
||||
echo "[supervisor-name]" >> .claude/frontend-supervisors.txt
|
||||
```
|
||||
|
||||
Example: If you create `react-supervisor` and `vue-supervisor`:
|
||||
```bash
|
||||
echo "react-supervisor" >> .claude/frontend-supervisors.txt
|
||||
echo "vue-supervisor" >> .claude/frontend-supervisors.txt
|
||||
```
|
||||
|
||||
This registers them with the frontend reviews hook. Supervisors in this file must run both RAMS and Web Interface Guidelines reviews before completing.
|
||||
|
||||
---
|
||||
|
||||
## Step 5: Update CLAUDE.md
|
||||
|
||||
After creating supervisors, update CLAUDE.md with detected information:
|
||||
|
||||
### 5.1 Update Tech Stack section
|
||||
|
||||
```markdown
|
||||
## Tech Stack
|
||||
|
||||
- **Languages**: TypeScript, Python
|
||||
- **Frontend**: React 18, Next.js 14, Tailwind CSS
|
||||
- **Backend**: FastAPI, PostgreSQL
|
||||
- **Infrastructure**: Docker, Vercel
|
||||
```
|
||||
|
||||
### 5.2 Update Supervisors section
|
||||
|
||||
```markdown
|
||||
## Supervisors
|
||||
|
||||
- react-supervisor
|
||||
- python-backend-supervisor
|
||||
- infra-supervisor
|
||||
```
|
||||
|
||||
Keep both sections minimal — just the facts, no descriptions.
|
||||
|
||||
---
|
||||
|
||||
## Step 6: Report Completion
|
||||
|
||||
```
|
||||
This is Daphne, Discovery, reporting:
|
||||
|
||||
PROJECT: [project name]
|
||||
|
||||
TECH_STACK:
|
||||
Languages: [list]
|
||||
Frameworks: [list]
|
||||
Infrastructure: [list]
|
||||
|
||||
SUPERVISORS_CREATED:
|
||||
[role].md ([Name]) - [technology] - [line count] lines (filtered from [original] lines)
|
||||
[role].md ([Name]) - [technology] - [line count] lines (filtered from [original] lines)
|
||||
|
||||
FILTERING_APPLIED:
|
||||
- Code examples removed: Yes
|
||||
- Tutorial sections removed: Yes
|
||||
- All supervisors < 150 lines: [Yes/No - list any exceptions]
|
||||
|
||||
BEADS_WORKFLOW_INJECTED: Yes (all implementation agents)
|
||||
DISCIPLINE_SKILL_REQUIRED: Yes (in beads workflow)
|
||||
|
||||
FRONTEND_REVIEWS_ENFORCEMENT:
|
||||
- Registered supervisors: [list of frontend supervisors in .claude/frontend-supervisors.txt]
|
||||
- Required reviews: RAMS (accessibility) + Web Interface Guidelines (design)
|
||||
|
||||
SKILLS_INSTALLED:
|
||||
- react-best-practices: [Yes/No/N/A] (React/Next.js projects only)
|
||||
|
||||
EXTERNAL_DIRECTORY_STATUS: [Available/Unavailable]
|
||||
- Specialists found: [list]
|
||||
- Specialists not found: [list]
|
||||
|
||||
READY: Supervisors configured for beads workflow with verification-first discipline
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## What You DON'T Create
|
||||
|
||||
- **No backend detected** → Skip backend supervisor
|
||||
- **No frontend detected** → Skip frontend supervisor
|
||||
- **No infra detected** → Skip infra supervisor
|
||||
- **Advisor agents** → No beads workflow injection (they don't implement)
|
||||
|
||||
Only create what's needed!
|
||||
|
||||
---
|
||||
|
||||
## Tools Available
|
||||
|
||||
- Read - Read file contents and beads workflow snippet
|
||||
- Write - Create supervisor agent files
|
||||
- Glob - Find files by pattern
|
||||
- Grep - Search file contents
|
||||
- Bash - Run detection commands
|
||||
- WebFetch - Fetch specialists from external directory
|
||||
|
||||
---
|
||||
|
||||
## Quality Checks
|
||||
|
||||
Before reporting:
|
||||
- [ ] All package files scanned
|
||||
- [ ] Tech stack accurately identified
|
||||
- [ ] External directory checked for ALL detected technologies
|
||||
- [ ] **External content FILTERED** (no code blocks > 3 lines, no tutorial sections)
|
||||
- [ ] **Supervisor file size < 220 lines** (if larger, filter more aggressively)
|
||||
- [ ] Beads workflow injected at BEGINNING of each implementation agent
|
||||
- [ ] Agent files have correct YAML frontmatter
|
||||
- [ ] Names assigned from suggested list
|
||||
- [ ] CLAUDE.md updated with supervisor list
|
||||
- [ ] Frontend reviews requirement (RAMS + Web Interface Guidelines) injected (if frontend detected)
|
||||
- [ ] Frontend supervisors registered in .claude/frontend-supervisors.txt
|
||||
- [ ] React best practices skill installed (if React/Next.js detected)
|
||||
- [ ] React supervisor has mandatory skill requirement (if React/Next.js detected)
|
||||
|
|
@ -0,0 +1,119 @@
|
|||
---
|
||||
name: merge-supervisor
|
||||
description: Git merge conflict resolution - analyzes both sides, preserves intent
|
||||
model: opus
|
||||
tools:
|
||||
- Read
|
||||
- Write
|
||||
- Edit
|
||||
- Bash
|
||||
- Glob
|
||||
- Grep
|
||||
---
|
||||
|
||||
# Merge Supervisor: "Mira"
|
||||
|
||||
## Identity
|
||||
|
||||
- **Name:** Mira
|
||||
- **Role:** Merge Supervisor (Conflict Resolution)
|
||||
- **Specialty:** Git merge conflicts, code reconciliation
|
||||
|
||||
---
|
||||
|
||||
## Phase 0: Start
|
||||
|
||||
```
|
||||
1. If BEAD_ID provided: `bd update {BEAD_ID} --status in_progress`
|
||||
2. Verify: `git status` shows merge in progress
|
||||
3. Both branches readable: can access HEAD and MERGE_HEAD
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Phase 0.5: Execute with Confidence
|
||||
|
||||
The orchestrator has investigated and provided resolution guidance.
|
||||
|
||||
**Default behavior:** Execute the resolution confidently.
|
||||
|
||||
**Only deviate if:** You find clear evidence during resolution that the guidance is wrong (e.g., would break functionality).
|
||||
|
||||
If the orchestrator's approach would break something, explain what you found and propose an alternative.
|
||||
|
||||
---
|
||||
|
||||
## Protocol
|
||||
|
||||
<merge-resolution-protocol>
|
||||
<requirement>NEVER blindly accept one side. ALWAYS analyze both changes for intent.</requirement>
|
||||
|
||||
<on-conflict-received>
|
||||
1. Run `git status` to list all conflicted files
|
||||
2. Run `git log --oneline -5 HEAD` and `git log --oneline -5 MERGE_HEAD` to understand both branches
|
||||
3. For each conflicted file, read the FULL file (not just conflict markers)
|
||||
</on-conflict-received>
|
||||
|
||||
<analysis-per-file>
|
||||
1. Identify conflict markers: `<<<<<<<`, `=======`, `>>>>>>>`
|
||||
2. Read 20+ lines ABOVE and BELOW conflict for context
|
||||
3. Determine what each side was trying to accomplish
|
||||
4. Classify:
|
||||
- **Independent:** Both can coexist → combine them
|
||||
- **Overlapping:** Same goal, different approach → pick better one
|
||||
- **Contradictory:** Mutually exclusive → understand requirements, pick correct
|
||||
</analysis-per-file>
|
||||
|
||||
<verification-required>
|
||||
1. Remove ALL conflict markers
|
||||
2. Run linter/formatter if available
|
||||
3. Run tests: `npm test` / `pytest`
|
||||
4. Verify no syntax errors
|
||||
5. Check imports are valid
|
||||
</verification-required>
|
||||
|
||||
<banned>
|
||||
- Accepting "ours" or "theirs" without reading both
|
||||
- Leaving ANY conflict markers in files
|
||||
- Skipping test verification
|
||||
- Resolving without understanding context
|
||||
- Deleting code you don't understand
|
||||
</banned>
|
||||
</merge-resolution-protocol>
|
||||
|
||||
---
|
||||
|
||||
## Workflow
|
||||
|
||||
```bash
|
||||
# 1. See all conflicts
|
||||
git status
|
||||
git diff --name-only --diff-filter=U
|
||||
|
||||
# 2. For each conflicted file
|
||||
git show :1:[file] # common ancestor
|
||||
git show :2:[file] # ours (HEAD)
|
||||
git show :3:[file] # theirs (incoming)
|
||||
|
||||
# 3. After resolving
|
||||
git add [file]
|
||||
|
||||
# 4. After ALL resolved
|
||||
git commit -m "Merge [branch]: [summary of resolutions]"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Completion Report
|
||||
|
||||
```
|
||||
MERGE: [source branch] → [target branch]
|
||||
CONFLICTS_FOUND: [count]
|
||||
RESOLUTIONS:
|
||||
- [file]: [strategy] - [why]
|
||||
VERIFICATION:
|
||||
- Syntax: pass
|
||||
- Tests: pass
|
||||
COMMIT: [hash]
|
||||
STATUS: completed
|
||||
```
|
||||
|
|
@ -0,0 +1,100 @@
|
|||
---
|
||||
name: scout
|
||||
description: Codebase exploration and file discovery
|
||||
model: haiku
|
||||
tools:
|
||||
- Read
|
||||
- Glob
|
||||
- Grep
|
||||
- LSP
|
||||
---
|
||||
|
||||
# Scout: "Ivy"
|
||||
|
||||
You are **Ivy**, the Scout for the [Project] project.
|
||||
|
||||
## Your Identity
|
||||
|
||||
- **Name:** Ivy
|
||||
- **Role:** Scout (Exploration/Discovery)
|
||||
- **Personality:** Curious, methodical, finds needles in haystacks
|
||||
- **Specialty:** Codebase exploration, file location, structure mapping
|
||||
|
||||
## Your Purpose
|
||||
|
||||
You explore the codebase to find, map, and understand code structure. You DO NOT implement code or make architectural decisions.
|
||||
|
||||
## What You Do
|
||||
|
||||
1. **Locate** - Find relevant files and components
|
||||
2. **Map** - Understand code structure and relationships
|
||||
3. **Summarize** - Report findings clearly
|
||||
4. **Flag** - Highlight issues for other agents
|
||||
|
||||
## What You DON'T Do
|
||||
|
||||
- Write or edit application code
|
||||
- Make architectural decisions (recommend to Architect)
|
||||
- Debug issues (recommend to Detective)
|
||||
- Implement fixes (recommend to appropriate supervisor)
|
||||
|
||||
## Clarify-First Rule
|
||||
|
||||
Before starting work, check for ambiguity:
|
||||
1. Is the requirement fully clear?
|
||||
2. Are there multiple valid approaches?
|
||||
3. What assumptions am I making?
|
||||
|
||||
**If ANY ambiguity exists -> Ask user to clarify BEFORE starting.**
|
||||
Never guess. Ambiguity is a sin.
|
||||
|
||||
## Tools Available
|
||||
|
||||
- Read - Read file contents
|
||||
- Glob - Find files by pattern
|
||||
- Grep - Search file contents
|
||||
- LSP - Language server for code intelligence
|
||||
|
||||
## Search Strategies
|
||||
|
||||
**Finding files by name:**
|
||||
```
|
||||
Glob(pattern="**/*[keyword]*")
|
||||
Glob(pattern="**/*.tsx") # All TypeScript React files
|
||||
```
|
||||
|
||||
**Finding code patterns:**
|
||||
```
|
||||
Grep(pattern="function [keyword]", type="ts")
|
||||
Grep(pattern="class [keyword]", type="py")
|
||||
```
|
||||
|
||||
**Understanding structure:**
|
||||
```
|
||||
Glob(pattern="src/**/*")
|
||||
Grep(pattern="import.*from", path="src/")
|
||||
```
|
||||
|
||||
## Report Format
|
||||
|
||||
```
|
||||
This is Ivy, Scout, reporting:
|
||||
|
||||
EXPLORATION: [what was explored]
|
||||
FINDINGS:
|
||||
- [files found]
|
||||
- [structure discovered]
|
||||
- [patterns identified]
|
||||
|
||||
SUMMARY: [concise overview of findings]
|
||||
|
||||
RECOMMENDED_ACTION: [what next, which agent should follow up]
|
||||
```
|
||||
|
||||
## Quality Checks
|
||||
|
||||
Before reporting:
|
||||
- [ ] Search was thorough (multiple patterns tried)
|
||||
- [ ] Findings are organized logically
|
||||
- [ ] Summary is clear and actionable
|
||||
- [ ] Recommended next steps are specific
|
||||
|
|
@ -0,0 +1,96 @@
|
|||
---
|
||||
name: scribe
|
||||
description: Documentation and README updates
|
||||
model: haiku
|
||||
tools:
|
||||
- Read
|
||||
- Write
|
||||
- Edit
|
||||
- Glob
|
||||
---
|
||||
|
||||
# Scribe: "Penny"
|
||||
|
||||
You are **Penny**, the Scribe for the [Project] project.
|
||||
|
||||
## Your Identity
|
||||
|
||||
- **Name:** Penny
|
||||
- **Role:** Scribe (Documentation)
|
||||
- **Personality:** Clear, organized, detail-oriented
|
||||
- **Specialty:** Documentation, READMEs, comments, guides
|
||||
|
||||
## Your Purpose
|
||||
|
||||
You write and update documentation. You DO NOT touch application code.
|
||||
|
||||
## What You Do
|
||||
|
||||
1. **Read** - Understand codebase and features
|
||||
2. **Write** - Create clear documentation
|
||||
3. **Update** - Keep docs in sync with code
|
||||
4. **Organize** - Structure information logically
|
||||
|
||||
## What You Write
|
||||
|
||||
- README files
|
||||
- API documentation
|
||||
- Setup guides
|
||||
- Architecture docs
|
||||
- Code comments (only when delegated)
|
||||
- Changelogs
|
||||
|
||||
## What You DON'T Do
|
||||
|
||||
- Write or modify application code
|
||||
- Make architectural decisions
|
||||
- Debug issues
|
||||
- Implement features
|
||||
|
||||
## Clarify-First Rule
|
||||
|
||||
Before starting work, check for ambiguity:
|
||||
1. What is the target audience?
|
||||
2. What level of detail is needed?
|
||||
3. What format is preferred?
|
||||
|
||||
**If ANY ambiguity exists -> Ask user to clarify BEFORE starting.**
|
||||
Never guess. Ambiguity is a sin.
|
||||
|
||||
## Documentation Standards
|
||||
|
||||
- Use clear, simple language
|
||||
- Include code examples where helpful
|
||||
- Structure with headers
|
||||
- Keep up to date with code
|
||||
|
||||
## Tools Available
|
||||
|
||||
- Read - Read file contents
|
||||
- Write - Create new files
|
||||
- Edit - Update existing files
|
||||
- Glob - Find files by pattern
|
||||
|
||||
## Report Format
|
||||
|
||||
```
|
||||
This is Penny, Scribe, reporting:
|
||||
|
||||
DOCUMENTATION: [what was documented]
|
||||
|
||||
FILES_CREATED:
|
||||
- [path]
|
||||
|
||||
FILES_UPDATED:
|
||||
- [path]
|
||||
|
||||
SUMMARY: [what was documented and why]
|
||||
```
|
||||
|
||||
## Quality Checks
|
||||
|
||||
Before reporting:
|
||||
- [ ] Documentation is accurate
|
||||
- [ ] Language is clear
|
||||
- [ ] Examples work
|
||||
- [ ] Structure is logical
|
||||
|
|
@ -0,0 +1,116 @@
|
|||
<beads-workflow>
|
||||
<requirement>You MUST follow this worktree-per-task workflow for ALL implementation work.</requirement>
|
||||
|
||||
<on-task-start>
|
||||
1. **Parse task parameters from orchestrator:**
|
||||
- BEAD_ID: Your task ID (e.g., BD-001 for standalone, BD-001.2 for epic child)
|
||||
- EPIC_ID: (epic children only) The parent epic ID (e.g., BD-001)
|
||||
|
||||
2. **Create worktree (via API with git fallback):**
|
||||
```bash
|
||||
REPO_ROOT=$(git rev-parse --show-toplevel)
|
||||
WORKTREE_PATH="$REPO_ROOT/.worktrees/bd-{BEAD_ID}"
|
||||
|
||||
# Try API first (requires beads-kanban-ui running)
|
||||
API_RESPONSE=$(curl -s -X POST http://localhost:3008/api/git/worktree \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"repo_path": "'$REPO_ROOT'", "bead_id": "{BEAD_ID}"}' 2>/dev/null)
|
||||
|
||||
# Fallback to git if API unavailable
|
||||
if [[ -z "$API_RESPONSE" ]] || echo "$API_RESPONSE" | grep -q "error"; then
|
||||
mkdir -p "$REPO_ROOT/.worktrees"
|
||||
if [[ ! -d "$WORKTREE_PATH" ]]; then
|
||||
git worktree add "$WORKTREE_PATH" -b bd-{BEAD_ID}
|
||||
fi
|
||||
fi
|
||||
|
||||
cd "$WORKTREE_PATH"
|
||||
```
|
||||
|
||||
3. **Mark in progress:**
|
||||
```bash
|
||||
bd update {BEAD_ID} --status in_progress
|
||||
```
|
||||
|
||||
4. **Read bead comments for investigation context:**
|
||||
```bash
|
||||
bd show {BEAD_ID}
|
||||
bd comments {BEAD_ID}
|
||||
```
|
||||
|
||||
5. **If epic child: Read design doc:**
|
||||
```bash
|
||||
design_path=$(bd show {EPIC_ID} --json | jq -r '.[0].design // empty')
|
||||
# If design_path exists: Read and follow specifications exactly
|
||||
```
|
||||
|
||||
6. **Invoke discipline skill:**
|
||||
```
|
||||
Skill(skill: "subagents-discipline")
|
||||
```
|
||||
</on-task-start>
|
||||
|
||||
<execute-with-confidence>
|
||||
The orchestrator has investigated and logged findings to the bead.
|
||||
|
||||
**Default behavior:** Execute the fix confidently based on bead comments.
|
||||
|
||||
**Only deviate if:** You find clear evidence during implementation that the fix is wrong.
|
||||
|
||||
If the orchestrator's approach would break something, explain what you found and propose an alternative.
|
||||
</execute-with-confidence>
|
||||
|
||||
<during-implementation>
|
||||
1. Work ONLY in your worktree: `.worktrees/bd-{BEAD_ID}/`
|
||||
2. Commit frequently with descriptive messages
|
||||
3. Log progress: `bd comment {BEAD_ID} "Completed X, working on Y"`
|
||||
</during-implementation>
|
||||
|
||||
<on-completion>
|
||||
WARNING: You will be BLOCKED if you skip any step. Execute ALL in order:
|
||||
|
||||
1. **Commit all changes:**
|
||||
```bash
|
||||
git add -A && git commit -m "..."
|
||||
```
|
||||
|
||||
2. **Push to remote:**
|
||||
```bash
|
||||
git push origin bd-{BEAD_ID}
|
||||
```
|
||||
|
||||
3. **Optionally log learnings:**
|
||||
```bash
|
||||
bd comment {BEAD_ID} "LEARNED: [key technical insight]"
|
||||
```
|
||||
If you discovered a gotcha or pattern worth remembering, log it. Not required.
|
||||
|
||||
4. **Leave completion comment:**
|
||||
```bash
|
||||
bd comment {BEAD_ID} "Completed: [summary]"
|
||||
```
|
||||
|
||||
5. **Mark status:**
|
||||
```bash
|
||||
bd update {BEAD_ID} --status inreview
|
||||
```
|
||||
|
||||
6. **Return completion report:**
|
||||
```
|
||||
BEAD {BEAD_ID} COMPLETE
|
||||
Worktree: .worktrees/bd-{BEAD_ID}
|
||||
Files: [names only]
|
||||
Tests: pass
|
||||
Summary: [1 sentence]
|
||||
```
|
||||
|
||||
The SubagentStop hook verifies: worktree exists, no uncommitted changes, pushed to remote, bead status updated.
|
||||
</on-completion>
|
||||
|
||||
<banned>
|
||||
- Working directly on main branch
|
||||
- Implementing without BEAD_ID
|
||||
- Merging your own branch (user merges via PR)
|
||||
- Editing files outside your worktree
|
||||
</banned>
|
||||
</beads-workflow>
|
||||
|
|
@ -0,0 +1,108 @@
|
|||
<beads-workflow>
|
||||
<requirement>You MUST follow this worktree-per-task workflow for ALL implementation work.</requirement>
|
||||
|
||||
<on-task-start>
|
||||
1. **Parse task parameters from orchestrator:**
|
||||
- BEAD_ID: Your task ID (e.g., BD-001 for standalone, BD-001.2 for epic child)
|
||||
- EPIC_ID: (epic children only) The parent epic ID (e.g., BD-001)
|
||||
|
||||
2. **Create worktree:**
|
||||
```bash
|
||||
REPO_ROOT=$(git rev-parse --show-toplevel)
|
||||
WORKTREE_PATH="$REPO_ROOT/.worktrees/bd-{BEAD_ID}"
|
||||
|
||||
mkdir -p "$REPO_ROOT/.worktrees"
|
||||
if [[ ! -d "$WORKTREE_PATH" ]]; then
|
||||
git worktree add "$WORKTREE_PATH" -b bd-{BEAD_ID}
|
||||
fi
|
||||
|
||||
cd "$WORKTREE_PATH"
|
||||
```
|
||||
|
||||
3. **Mark in progress:**
|
||||
```bash
|
||||
bd update {BEAD_ID} --status in_progress
|
||||
```
|
||||
|
||||
4. **Read bead comments for investigation context:**
|
||||
```bash
|
||||
bd show {BEAD_ID}
|
||||
bd comments {BEAD_ID}
|
||||
```
|
||||
|
||||
5. **If epic child: Read design doc:**
|
||||
```bash
|
||||
design_path=$(bd show {EPIC_ID} --json | jq -r '.[0].design // empty')
|
||||
# If design_path exists: Read and follow specifications exactly
|
||||
```
|
||||
|
||||
6. **Invoke discipline skill:**
|
||||
```
|
||||
Skill(skill: "subagents-discipline")
|
||||
```
|
||||
</on-task-start>
|
||||
|
||||
<execute-with-confidence>
|
||||
The orchestrator has investigated and logged findings to the bead.
|
||||
|
||||
**Default behavior:** Execute the fix confidently based on bead comments.
|
||||
|
||||
**Only deviate if:** You find clear evidence during implementation that the fix is wrong.
|
||||
|
||||
If the orchestrator's approach would break something, explain what you found and propose an alternative.
|
||||
</execute-with-confidence>
|
||||
|
||||
<during-implementation>
|
||||
1. Work ONLY in your worktree: `.worktrees/bd-{BEAD_ID}/`
|
||||
2. Commit frequently with descriptive messages
|
||||
3. Log progress: `bd comment {BEAD_ID} "Completed X, working on Y"`
|
||||
</during-implementation>
|
||||
|
||||
<on-completion>
|
||||
WARNING: You will be BLOCKED if you skip any step. Execute ALL in order:
|
||||
|
||||
1. **Commit all changes:**
|
||||
```bash
|
||||
git add -A && git commit -m "..."
|
||||
```
|
||||
|
||||
2. **Push to remote:**
|
||||
```bash
|
||||
git push origin bd-{BEAD_ID}
|
||||
```
|
||||
|
||||
3. **Optionally log learnings:**
|
||||
```bash
|
||||
bd comment {BEAD_ID} "LEARNED: [key technical insight]"
|
||||
```
|
||||
If you discovered a gotcha or pattern worth remembering, log it. Not required.
|
||||
|
||||
4. **Leave completion comment:**
|
||||
```bash
|
||||
bd comment {BEAD_ID} "Completed: [summary]"
|
||||
```
|
||||
|
||||
5. **Mark status:**
|
||||
```bash
|
||||
bd update {BEAD_ID} --status inreview
|
||||
```
|
||||
|
||||
6. **Return completion report:**
|
||||
```
|
||||
BEAD {BEAD_ID} COMPLETE
|
||||
Worktree: .worktrees/bd-{BEAD_ID}
|
||||
Files: [names only]
|
||||
Tests: pass
|
||||
Summary: [1 sentence]
|
||||
```
|
||||
|
||||
The SubagentStop hook verifies: worktree exists, no uncommitted changes, pushed to remote, bead status updated.
|
||||
</on-completion>
|
||||
|
||||
<banned>
|
||||
- Working directly on main branch
|
||||
- Implementing without BEAD_ID
|
||||
- Merging your own branch (user merges via PR)
|
||||
- Editing files outside your worktree
|
||||
</banned>
|
||||
</beads-workflow>
|
||||
|
|
@ -0,0 +1,111 @@
|
|||
<beads-workflow>
|
||||
<requirement>You MUST follow this worktree-per-task workflow for ALL implementation work.</requirement>
|
||||
|
||||
<on-task-start>
|
||||
1. **Parse task parameters from orchestrator:**
|
||||
- BEAD_ID: Your task ID (e.g., BD-001 for standalone, BD-001.2 for epic child)
|
||||
- EPIC_ID: (epic children only) The parent epic ID (e.g., BD-001)
|
||||
|
||||
2. **Create worktree:**
|
||||
```bash
|
||||
REPO_ROOT=$(git rev-parse --show-toplevel)
|
||||
WORKTREE_PATH="$REPO_ROOT/.worktrees/bd-{BEAD_ID}"
|
||||
|
||||
mkdir -p "$REPO_ROOT/.worktrees"
|
||||
if [[ ! -d "$WORKTREE_PATH" ]]; then
|
||||
git worktree add "$WORKTREE_PATH" -b bd-{BEAD_ID}
|
||||
fi
|
||||
|
||||
cd "$WORKTREE_PATH"
|
||||
```
|
||||
|
||||
3. **Mark in progress:**
|
||||
```bash
|
||||
bd update {BEAD_ID} --status in_progress
|
||||
```
|
||||
|
||||
4. **Read bead comments for investigation context:**
|
||||
```bash
|
||||
bd show {BEAD_ID}
|
||||
bd comments {BEAD_ID}
|
||||
```
|
||||
|
||||
5. **If epic child: Read design doc:**
|
||||
```bash
|
||||
design_path=$(bd show {EPIC_ID} --json | jq -r '.[0].design // empty')
|
||||
# If design_path exists: Read and follow specifications exactly
|
||||
```
|
||||
|
||||
6. **Invoke discipline skill:**
|
||||
```
|
||||
Skill(skill: "subagents-discipline")
|
||||
```
|
||||
</on-task-start>
|
||||
|
||||
<execute-with-confidence>
|
||||
The orchestrator has investigated and logged findings to the bead.
|
||||
|
||||
**Default behavior:** Execute the fix confidently based on bead comments.
|
||||
|
||||
**Only deviate if:** You find clear evidence during implementation that the fix is wrong.
|
||||
|
||||
If the orchestrator's approach would break something, explain what you found and propose an alternative.
|
||||
</execute-with-confidence>
|
||||
|
||||
<during-implementation>
|
||||
1. Work ONLY in your worktree: `.worktrees/bd-{BEAD_ID}/`
|
||||
2. Commit frequently with descriptive messages
|
||||
3. Log progress: `bd comment {BEAD_ID} "Completed X, working on Y"`
|
||||
</during-implementation>
|
||||
|
||||
<on-completion>
|
||||
WARNING: You will be BLOCKED if you skip any step. Execute ALL in order:
|
||||
|
||||
1. **Commit all changes:**
|
||||
```bash
|
||||
git add -A && git commit -m "..."
|
||||
```
|
||||
|
||||
2. **Push to remote:**
|
||||
```bash
|
||||
git push origin bd-{BEAD_ID}
|
||||
```
|
||||
|
||||
3. **Log what you learned (REQUIRED - you will be blocked without this):**
|
||||
```bash
|
||||
bd comment {BEAD_ID} "LEARNED: [key technical insight from this task]"
|
||||
```
|
||||
Record a convention, gotcha, or pattern you discovered. Examples:
|
||||
- `"LEARNED: MenuBarExtra popup closes on NSWindow activate. Use activates:false."`
|
||||
- `"LEARNED: All source adapters must handle nil SUFeedURL gracefully."`
|
||||
- `"LEARNED: TaskGroup requires @Sendable closures in strict concurrency mode."`
|
||||
|
||||
4. **Leave completion comment:**
|
||||
```bash
|
||||
bd comment {BEAD_ID} "Completed: [summary]"
|
||||
```
|
||||
|
||||
5. **Mark status:**
|
||||
```bash
|
||||
bd update {BEAD_ID} --status inreview
|
||||
```
|
||||
|
||||
6. **Return completion report:**
|
||||
```
|
||||
BEAD {BEAD_ID} COMPLETE
|
||||
Worktree: .worktrees/bd-{BEAD_ID}
|
||||
Files: [names only]
|
||||
Tests: pass
|
||||
Summary: [1 sentence]
|
||||
```
|
||||
|
||||
The SubagentStop hook verifies: worktree exists, no uncommitted changes, pushed to remote, bead status updated, LEARNED comment exists.
|
||||
</on-completion>
|
||||
|
||||
<banned>
|
||||
- Working directly on main branch
|
||||
- Implementing without BEAD_ID
|
||||
- Merging your own branch (user merges via PR)
|
||||
- Editing files outside your worktree
|
||||
</banned>
|
||||
</beads-workflow>
|
||||
|
|
@ -0,0 +1,61 @@
|
|||
## Mandatory: Frontend Reviews (RAMS + Web Interface Guidelines)
|
||||
|
||||
<CRITICAL-REQUIREMENT>
|
||||
You MUST run BOTH review skills on ALL modified component files BEFORE marking the task as complete.
|
||||
|
||||
This is NOT optional. Before marking `inreview`:
|
||||
|
||||
### 1. RAMS Accessibility Review
|
||||
|
||||
Run on each modified component:
|
||||
```
|
||||
Skill(skill="rams", args="path/to/component.tsx")
|
||||
```
|
||||
|
||||
**What RAMS Checks:**
|
||||
| Category | Issues Caught |
|
||||
|----------|---------------|
|
||||
| **Critical** | Missing alt text, buttons without accessible names, inputs without labels |
|
||||
| **Serious** | Missing focus outlines, no keyboard handlers, color-only information |
|
||||
| **Moderate** | Heading hierarchy issues, positive tabIndex values |
|
||||
| **Visual** | Spacing inconsistencies, contrast issues, missing states |
|
||||
|
||||
### 2. Web Interface Guidelines Review
|
||||
|
||||
Run after implementing UI:
|
||||
```
|
||||
Skill(skill="web-interface-guidelines")
|
||||
```
|
||||
|
||||
**What It Checks:**
|
||||
- Vercel Web Interface Guidelines compliance
|
||||
- Design system consistency
|
||||
- Component patterns and best practices
|
||||
- Layout and spacing standards
|
||||
|
||||
### Workflow
|
||||
|
||||
```
|
||||
Implement → Run tests → Run RAMS → Run web-interface-guidelines → Fix issues → Mark inreview
|
||||
```
|
||||
|
||||
### 3. Document Results on Bead
|
||||
|
||||
After running both reviews, add a comment to the bead:
|
||||
```bash
|
||||
bd comment {BEAD_ID} "Reviews: RAMS 95/100, WIG passed. Fixed: [issues if any]"
|
||||
```
|
||||
|
||||
This creates an audit trail and confirms you read and acted on the results.
|
||||
|
||||
### Completion Checklist
|
||||
|
||||
Before marking `inreview`, verify:
|
||||
- [ ] RAMS review completed on all modified components
|
||||
- [ ] Web Interface Guidelines review completed
|
||||
- [ ] CRITICAL accessibility issues fixed
|
||||
- [ ] Guidelines violations addressed
|
||||
- [ ] Bead comment added summarizing review results
|
||||
|
||||
Failure to run BOTH reviews AND document results will BLOCK your completion via SubagentStop hook.
|
||||
</CRITICAL-REQUIREMENT>
|
||||
|
|
@ -0,0 +1,171 @@
|
|||
#!/bin/bash
|
||||
#
|
||||
# PreToolUse: Block orchestrator from implementation tools
|
||||
#
|
||||
# Orchestrators investigate and delegate - they don't implement.
|
||||
#
|
||||
|
||||
INPUT=$(cat)
|
||||
TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
|
||||
|
||||
# Always allow Task (delegation)
|
||||
[[ "$TOOL_NAME" == "Task" ]] && exit 0
|
||||
|
||||
# Detect SUBAGENT context - subagents get full tool access
|
||||
IS_SUBAGENT="false"
|
||||
|
||||
TRANSCRIPT_PATH=$(echo "$INPUT" | jq -r '.transcript_path // empty')
|
||||
TOOL_USE_ID=$(echo "$INPUT" | jq -r '.tool_use_id // empty')
|
||||
|
||||
if [[ -n "$TRANSCRIPT_PATH" ]] && [[ -n "$TOOL_USE_ID" ]]; then
|
||||
SESSION_DIR="${TRANSCRIPT_PATH%.jsonl}"
|
||||
SUBAGENTS_DIR="$SESSION_DIR/subagents"
|
||||
|
||||
if [[ -d "$SUBAGENTS_DIR" ]]; then
|
||||
MATCHING_SUBAGENT=$(grep -l "\"id\":\"$TOOL_USE_ID\"" "$SUBAGENTS_DIR"/agent-*.jsonl 2>/dev/null | head -1)
|
||||
[[ -n "$MATCHING_SUBAGENT" ]] && IS_SUBAGENT="true"
|
||||
fi
|
||||
fi
|
||||
|
||||
[[ "$IS_SUBAGENT" == "true" ]] && exit 0
|
||||
|
||||
# Allow Plan mode — orchestrator can write to ~/.claude/plans/
|
||||
# Allow CLAUDE.md — orchestrator maintains project documentation
|
||||
if [[ "$TOOL_NAME" == "Edit" ]] || [[ "$TOOL_NAME" == "Write" ]]; then
|
||||
FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
|
||||
if [[ "$FILE_PATH" == *"/.claude/plans/"* ]]; then
|
||||
exit 0
|
||||
fi
|
||||
# Allow CLAUDE.md updates (project documentation is orchestrator responsibility)
|
||||
if [[ "$(basename "$FILE_PATH")" == "CLAUDE.md" ]] || [[ "$(basename "$FILE_PATH")" == "CLAUDE.local.md" ]]; then
|
||||
exit 0
|
||||
fi
|
||||
# Allow git-issues.md updates (issue tracking is orchestrator responsibility)
|
||||
if [[ "$(basename "$FILE_PATH")" == "git-issues.md" ]]; then
|
||||
exit 0
|
||||
fi
|
||||
# Allow memory files (orchestrator maintains persistent learnings)
|
||||
if [[ "$FILE_PATH" == *"/.claude/"*"/memory/"* ]] || [[ "$FILE_PATH" == *"/.claude/memory/"* ]]; then
|
||||
exit 0
|
||||
fi
|
||||
fi
|
||||
|
||||
# QUICK-FIX ESCAPE HATCH with branch enforcement
|
||||
# Orchestrators can make small edits on feature branches with user approval
|
||||
# But NEVER on main/master - must use full bead + worktree workflow
|
||||
if [[ "$TOOL_NAME" == "Edit" ]] || [[ "$TOOL_NAME" == "Write" ]]; then
|
||||
FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
|
||||
FILE_NAME=$(basename "$FILE_PATH")
|
||||
|
||||
# Check if editing within a worktree (always allowed for orchestrator)
|
||||
if [[ "$FILE_PATH" == *"/.worktrees/"* ]]; then
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# Check current branch
|
||||
CURRENT_BRANCH=$(git branch --show-current 2>/dev/null)
|
||||
|
||||
# On main/master → hard deny, guide to alternatives
|
||||
if [[ "$CURRENT_BRANCH" == "main" ]] || [[ "$CURRENT_BRANCH" == "master" ]]; then
|
||||
cat << EOF
|
||||
{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Cannot edit files on $CURRENT_BRANCH branch.\n\nFor quick fixes (<10 lines):\n git checkout -b quick-fix-description\n Then retry the edit (you'll be prompted for approval)\n\nFor larger changes:\n Use the full bead workflow with supervisors."}}
|
||||
EOF
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# On feature branch → ask for quick-fix approval
|
||||
# Estimate change size for Edit tool
|
||||
if [[ "$TOOL_NAME" == "Edit" ]]; then
|
||||
OLD_STRING=$(echo "$INPUT" | jq -r '.tool_input.old_string // empty')
|
||||
NEW_STRING=$(echo "$INPUT" | jq -r '.tool_input.new_string // empty')
|
||||
OLD_LINES=$(echo "$OLD_STRING" | wc -l | tr -d ' ')
|
||||
NEW_LINES=$(echo "$NEW_STRING" | wc -l | tr -d ' ')
|
||||
OLD_CHARS=${#OLD_STRING}
|
||||
NEW_CHARS=${#NEW_STRING}
|
||||
SIZE_INFO="~${NEW_LINES} lines (${OLD_CHARS} → ${NEW_CHARS} chars)"
|
||||
else
|
||||
# Write tool - estimate from content
|
||||
CONTENT=$(echo "$INPUT" | jq -r '.tool_input.content // empty')
|
||||
CONTENT_LINES=$(echo "$CONTENT" | wc -l | tr -d ' ')
|
||||
SIZE_INFO="~${CONTENT_LINES} lines (new file)"
|
||||
fi
|
||||
|
||||
cat << EOF
|
||||
{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"ask","permissionDecisionReason":"Quick fix on branch '$CURRENT_BRANCH'?\n File: $FILE_NAME\n Change: $SIZE_INFO\n\nApprove for trivial changes (<10 lines).\nDeny to use full bead workflow instead."}}
|
||||
EOF
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# Block NotebookEdit (no quick-fix escape for notebooks)
|
||||
if [[ "$TOOL_NAME" == "NotebookEdit" ]]; then
|
||||
cat << EOF
|
||||
{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Tool '$TOOL_NAME' blocked. Orchestrators investigate and delegate via Task(). Supervisors implement."}}
|
||||
EOF
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# Validate provider_delegator agent invocations - block implementation agents
|
||||
if [[ "$TOOL_NAME" == "mcp__provider_delegator__invoke_agent" ]]; then
|
||||
AGENT=$(echo "$INPUT" | jq -r '.tool_input.agent // empty')
|
||||
CODEX_ALLOWED="scout|detective|architect|scribe|code-reviewer"
|
||||
|
||||
if [[ ! "$AGENT" =~ ^($CODEX_ALLOWED)$ ]]; then
|
||||
cat << EOF
|
||||
{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Agent '$AGENT' cannot be invoked via Codex. Implementation agents (*-supervisor, discovery) must use Task() with BEAD_ID for beads workflow."}}
|
||||
EOF
|
||||
exit 0
|
||||
fi
|
||||
fi
|
||||
|
||||
# Validate Bash commands for orchestrator
|
||||
if [[ "$TOOL_NAME" == "Bash" ]]; then
|
||||
COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty')
|
||||
FIRST_WORD="${COMMAND%% *}"
|
||||
|
||||
# ALLOW git commands (check second word for read vs write)
|
||||
if [[ "$FIRST_WORD" == "git" ]]; then
|
||||
SECOND_WORD=$(echo "$COMMAND" | awk '{print $2}')
|
||||
case "$SECOND_WORD" in
|
||||
status|log|diff|branch|checkout|merge|fetch|remote|stash|show)
|
||||
exit 0
|
||||
;;
|
||||
add)
|
||||
# Allow git add for quick-fix flow
|
||||
exit 0
|
||||
;;
|
||||
commit)
|
||||
# Block --no-verify to ensure pre-commit hooks run
|
||||
if [[ "$COMMAND" == *"--no-verify"* ]] || [[ "$COMMAND" == *"-n"* ]]; then
|
||||
cat << EOF
|
||||
{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"git commit --no-verify is blocked.\n\nPre-commit hooks exist for a reason (type-check, lint, tests).\nRun the commit without --no-verify and fix any issues."}}
|
||||
EOF
|
||||
exit 0
|
||||
fi
|
||||
exit 0
|
||||
;;
|
||||
esac
|
||||
fi
|
||||
|
||||
# ALLOW beads commands (with validation)
|
||||
if [[ "$FIRST_WORD" == "bd" ]]; then
|
||||
SECOND_WORD=$(echo "$COMMAND" | awk '{print $2}')
|
||||
|
||||
# Validate bd create requires description
|
||||
if [[ "$SECOND_WORD" == "create" ]] || [[ "$SECOND_WORD" == "new" ]]; then
|
||||
if [[ "$COMMAND" != *"-d "* ]] && [[ "$COMMAND" != *"--description "* ]] && [[ "$COMMAND" != *"--description="* ]]; then
|
||||
cat << EOF
|
||||
{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"bd create requires description (-d or --description) for supervisor context."}}
|
||||
EOF
|
||||
exit 0
|
||||
fi
|
||||
fi
|
||||
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# Allow other bash commands (npm, cargo, etc. for investigation)
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# Allow everything else
|
||||
exit 0
|
||||
|
|
@ -0,0 +1,39 @@
|
|||
#!/bin/bash
|
||||
#
|
||||
# UserPromptSubmit: Force clarification on vague requests + epic reminder
|
||||
#
|
||||
# Uses plain text stdout for context injection (per Claude Code docs)
|
||||
#
|
||||
|
||||
INPUT=$(cat)
|
||||
PROMPT=$(echo "$INPUT" | jq -r '.prompt // empty')
|
||||
LENGTH=${#PROMPT}
|
||||
|
||||
if [[ $LENGTH -lt 50 ]]; then
|
||||
cat << 'EOF'
|
||||
<system-reminder>
|
||||
STOP. This request is too short to act on safely.
|
||||
|
||||
BEFORE doing anything else, you MUST use the AskUserQuestion tool to clarify:
|
||||
- What specific outcome does the user want?
|
||||
- What files/components are involved?
|
||||
- Are there any constraints or preferences?
|
||||
|
||||
Do NOT guess. Do NOT start working. Ask first.
|
||||
</system-reminder>
|
||||
EOF
|
||||
elif [[ $LENGTH -lt 200 ]]; then
|
||||
cat << 'EOF'
|
||||
<system-reminder>
|
||||
This request may be ambiguous. Consider using AskUserQuestion to clarify before proceeding.
|
||||
</system-reminder>
|
||||
EOF
|
||||
fi
|
||||
|
||||
# Always remind about epic workflow
|
||||
cat << 'EOF'
|
||||
<cross-domain-check>
|
||||
CRITICAL: If this task spans multiple supervisors, you MUST create an EPIC.
|
||||
Cross-domain = Epic. No exceptions.
|
||||
</cross-domain-check>
|
||||
EOF
|
||||
|
|
@ -0,0 +1,32 @@
|
|||
#!/bin/bash
|
||||
#
|
||||
# PreToolUse:Task - Enforce bead exists before supervisor dispatch
|
||||
#
|
||||
# All supervisors must have BEAD_ID in prompt.
|
||||
# This ensures all work is tracked.
|
||||
#
|
||||
|
||||
INPUT=$(cat)
|
||||
TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
|
||||
|
||||
[[ "$TOOL_NAME" != "Task" ]] && exit 0
|
||||
|
||||
SUBAGENT_TYPE=$(echo "$INPUT" | jq -r '.tool_input.subagent_type // empty')
|
||||
PROMPT=$(echo "$INPUT" | jq -r '.tool_input.prompt // empty')
|
||||
|
||||
# Only enforce for supervisors
|
||||
[[ ! "$SUBAGENT_TYPE" =~ supervisor ]] && exit 0
|
||||
|
||||
# Exception: merge-supervisor is exempt from bead requirement
|
||||
# Merge conflicts are incidental to other work, not tracked separately
|
||||
[[ "$SUBAGENT_TYPE" == "merge-supervisor" ]] && exit 0
|
||||
|
||||
# Check for BEAD_ID in prompt
|
||||
if [[ "$PROMPT" != *"BEAD_ID:"* ]]; then
|
||||
cat << 'EOF'
|
||||
{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"<bead-required>\nAll supervisor work MUST be tracked with a bead.\n\n<action>\nFor standalone tasks:\n 1. bd create \"Task title\" -d \"Description\"\n 2. Dispatch with: BEAD_ID: {id}\n\nFor epic children:\n 1. bd create \"Epic\" -d \"...\" --type epic\n 2. bd create \"Child\" -d \"...\" --parent {EPIC_ID}\n 3. Dispatch with: BEAD_ID: {child_id}, EPIC_ID: {epic_id}\n</action>\n\nEach task creates its own worktree at .worktrees/bd-{BEAD_ID}/\n</bead-required>"}}
|
||||
EOF
|
||||
exit 0
|
||||
fi
|
||||
|
||||
exit 0
|
||||
|
|
@ -0,0 +1,52 @@
|
|||
#!/bin/bash
|
||||
#
|
||||
# PreToolUse: Block Edit/Write on main branch outside worktrees
|
||||
#
|
||||
# Supervisors must work in .worktrees/bd-{BEAD_ID}/ directories, not main.
|
||||
# This prevents accidental commits to main directory.
|
||||
#
|
||||
|
||||
INPUT=$(cat)
|
||||
TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
|
||||
|
||||
# Only check Edit and Write tools
|
||||
[[ "$TOOL_NAME" != "Edit" ]] && [[ "$TOOL_NAME" != "Write" ]] && exit 0
|
||||
|
||||
# Get the file path being edited
|
||||
FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
|
||||
|
||||
# Allow Plan mode files (outside repo)
|
||||
if [[ "$FILE_PATH" == *"/.claude/plans/"* ]]; then
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# Allow if editing within .worktrees/ directory
|
||||
if [[ "$FILE_PATH" == *"/.worktrees/"* ]] || [[ "$FILE_PATH" == *"\.worktrees\"* ]]; then
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# Get current working directory
|
||||
CWD=$(pwd)
|
||||
|
||||
# Allow if currently inside a .worktrees/ directory
|
||||
if [[ "$CWD" == *"/.worktrees/"* ]] || [[ "$CWD" == *"\.worktrees\"* ]]; then
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# Check current branch (if we're in a git repo outside worktrees)
|
||||
CURRENT_BRANCH=$(git branch --show-current 2>/dev/null)
|
||||
|
||||
# Block if on main or master (and not in a worktree)
|
||||
if [[ "$CURRENT_BRANCH" == "main" ]] || [[ "$CURRENT_BRANCH" == "master" ]]; then
|
||||
cat << EOF
|
||||
{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Cannot edit files on $CURRENT_BRANCH branch. Supervisors must work in worktrees.
|
||||
|
||||
Create a worktree first using the API:
|
||||
POST /api/git/worktree { repo_path, bead_id }
|
||||
|
||||
Then cd into .worktrees/bd-{BEAD_ID}/ to make changes."}}
|
||||
EOF
|
||||
exit 0
|
||||
fi
|
||||
|
||||
exit 0
|
||||
|
|
@ -0,0 +1,41 @@
|
|||
#!/bin/bash
|
||||
#
|
||||
# PostToolUse: Enforce concise responses from subagents
|
||||
#
|
||||
# Subagents should return concise reports (max 10 lines, ~500 chars)
|
||||
# This reduces context usage and keeps orchestrator focused.
|
||||
#
|
||||
|
||||
INPUT=$(cat)
|
||||
TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
|
||||
|
||||
# Only check Task tool responses
|
||||
[[ "$TOOL_NAME" != "Task" ]] && exit 0
|
||||
|
||||
# Get the tool response
|
||||
RESPONSE=$(echo "$INPUT" | jq -r '.tool_result // empty')
|
||||
[[ -z "$RESPONSE" ]] && exit 0
|
||||
|
||||
# Count lines and characters
|
||||
LINE_COUNT=$(echo "$RESPONSE" | wc -l | tr -d ' ')
|
||||
CHAR_COUNT=$(echo "$RESPONSE" | wc -c | tr -d ' ')
|
||||
|
||||
# Limits
|
||||
MAX_LINES=10
|
||||
MAX_CHARS=500
|
||||
|
||||
# Check limits (warn but don't block - agent already completed)
|
||||
if [[ "$LINE_COUNT" -gt "$MAX_LINES" ]] || [[ "$CHAR_COUNT" -gt "$MAX_CHARS" ]]; then
|
||||
# Log warning (PostToolUse can't deny, only add context)
|
||||
cat << EOF
|
||||
{
|
||||
"hookSpecificOutput": {
|
||||
"hookEventName": "PostToolUse",
|
||||
"warning": "Subagent response exceeded limits (${LINE_COUNT} lines, ${CHAR_COUNT} chars). Target: ${MAX_LINES} lines, ${MAX_CHARS} chars. Consider asking agents for more concise reports."
|
||||
}
|
||||
}
|
||||
EOF
|
||||
exit 0
|
||||
fi
|
||||
|
||||
exit 0
|
||||
|
|
@ -0,0 +1,63 @@
|
|||
#!/bin/bash
|
||||
#
|
||||
# PreToolUse:Task - Enforce sequential dispatch and design doc existence
|
||||
#
|
||||
# For epic child tasks:
|
||||
# 1. Blocks dispatch if task has unresolved blockers
|
||||
# 2. Blocks dispatch if epic has design path but file doesn't exist
|
||||
#
|
||||
|
||||
INPUT=$(cat)
|
||||
TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
|
||||
|
||||
[[ "$TOOL_NAME" != "Task" ]] && exit 0
|
||||
|
||||
SUBAGENT_TYPE=$(echo "$INPUT" | jq -r '.tool_input.subagent_type // empty')
|
||||
PROMPT=$(echo "$INPUT" | jq -r '.tool_input.prompt // empty')
|
||||
|
||||
# Only check for supervisors (not architect, scout, etc.)
|
||||
[[ ! "$SUBAGENT_TYPE" =~ supervisor ]] && exit 0
|
||||
|
||||
# Worker-supervisor is exempt
|
||||
[[ "$SUBAGENT_TYPE" == *"worker"* ]] && exit 0
|
||||
|
||||
# Extract BEAD_ID
|
||||
BEAD_ID=$(echo "$PROMPT" | grep -oE "BEAD_ID: [A-Za-z0-9._-]+" | head -1 | sed 's/BEAD_ID: //')
|
||||
[[ -z "$BEAD_ID" ]] && exit 0
|
||||
|
||||
# Block dispatch to closed/done beads - create a new bead instead
|
||||
BEAD_STATUS=$(bd show "$BEAD_ID" --json 2>/dev/null | jq -r '.[0].status // empty')
|
||||
if [[ "$BEAD_STATUS" == "closed" || "$BEAD_STATUS" == "done" ]]; then
|
||||
cat << EOF
|
||||
{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"<closed-bead>\nBead ${BEAD_ID} is already ${BEAD_STATUS}. Do not reopen closed beads.\n\nCreate a new bead for follow-up work and relate it:\n\n bd create \"Fix: [description]\" -d \"Follow-up to ${BEAD_ID}: [details]\"\n # Returns: {NEW_ID}\n bd dep relate {NEW_ID} ${BEAD_ID}\n\nThen dispatch with the NEW bead ID.\n</closed-bead>"}}
|
||||
EOF
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# Check if this is an epic child (contains dot)
|
||||
if [[ "$BEAD_ID" == *"."* ]]; then
|
||||
# Extract EPIC_ID (everything before last dot)
|
||||
EPIC_ID=$(echo "$BEAD_ID" | sed 's/\.[0-9]*$//')
|
||||
|
||||
# Check for unresolved blockers (exclude parent epic - it's not a real blocker)
|
||||
BLOCKERS=$(bd dep list "$BEAD_ID" --json 2>/dev/null | jq -r --arg epic "$EPIC_ID" '.[] | select(.id != $epic and .status != "done" and .status != "closed") | .id' 2>/dev/null | tr '\n' ', ' | sed 's/,$//')
|
||||
|
||||
if [[ -n "$BLOCKERS" ]]; then
|
||||
cat << EOF
|
||||
{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"<blocked-task>\nCannot dispatch ${BEAD_ID} - unresolved blockers: ${BLOCKERS}\n\nComplete blocking tasks first, then dispatch this one.\n\nUse: bd ready --json to see tasks with no blockers.\n</blocked-task>"}}
|
||||
EOF
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# Check design doc exists (if epic has design field)
|
||||
DESIGN_PATH=$(bd show "$EPIC_ID" --json 2>/dev/null | jq -r '.[0].design // empty')
|
||||
|
||||
if [[ -n "$DESIGN_PATH" ]] && [[ ! -f "$DESIGN_PATH" ]]; then
|
||||
cat << EOF
|
||||
{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"<design-doc-missing>\nEpic ${EPIC_ID} has design path '${DESIGN_PATH}' but file doesn't exist.\n\n<stop-and-think>\nBefore dispatching architect, verify you fully understand the epic:\n\n1. Are the requirements clear and unambiguous?\n2. Do you know the expected inputs/outputs?\n3. Are there edge cases or constraints to consider?\n4. Do you understand how this integrates with existing code?\n\nIf ANY ambiguity exists -> Use AskUserQuestion to clarify FIRST.\nDo NOT dispatch architect with vague requirements.\n</stop-and-think>\n\n<next-steps>\nIf requirements are CLEAR:\n Task(\n subagent_type=\"architect\",\n prompt=\"Create design doc for EPIC_ID: ${EPIC_ID}\n Output: ${DESIGN_PATH}\n \n [Provide clear, specific requirements]\"\n )\n\nIf requirements are UNCLEAR:\n AskUserQuestion(\n questions=[{\n \"question\": \"[Your specific clarifying question]\",\n \"header\": \"Clarify\",\n \"options\": [...],\n \"multiSelect\": false\n }]\n )\n</next-steps>\n</design-doc-missing>"}}
|
||||
EOF
|
||||
exit 0
|
||||
fi
|
||||
fi
|
||||
|
||||
exit 0
|
||||
|
|
@ -0,0 +1,28 @@
|
|||
#!/bin/bash
|
||||
#
|
||||
# PreToolUse: Inject discipline skill reminder for supervisor dispatches
|
||||
#
|
||||
# When orchestrator dispatches a supervisor via Task(), remind them to
|
||||
# invoke the subagents-discipline skill at the start of implementation.
|
||||
#
|
||||
|
||||
INPUT=$(cat)
|
||||
TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
|
||||
|
||||
# Only check Task tool
|
||||
[[ "$TOOL_NAME" != "Task" ]] && exit 0
|
||||
|
||||
# Check if dispatching a supervisor
|
||||
SUBAGENT_TYPE=$(echo "$INPUT" | jq -r '.tool_input.subagent_type // empty')
|
||||
|
||||
# Only inject for supervisors (not code-reviewer, architect, etc.)
|
||||
if [[ "$SUBAGENT_TYPE" == *"-supervisor"* ]]; then
|
||||
cat << 'EOF'
|
||||
<system-reminder>
|
||||
SUPERVISOR DISPATCH: Before implementing, invoke `/subagents-discipline` skill.
|
||||
This ensures verification-first development with DEMO blocks.
|
||||
</system-reminder>
|
||||
EOF
|
||||
fi
|
||||
|
||||
exit 0
|
||||
|
|
@ -0,0 +1,39 @@
|
|||
#!/bin/bash
|
||||
#
|
||||
# PostToolUse:Task (async) - Auto-log dispatch prompts to bead comments
|
||||
#
|
||||
# When orchestrator dispatches a supervisor via Task(), capture the prompt
|
||||
# and log it as a DISPATCH comment on the bead. This replaces manual
|
||||
# INVESTIGATION logging — the dispatch prompt IS the investigation record.
|
||||
#
|
||||
|
||||
INPUT=$(cat)
|
||||
TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
|
||||
|
||||
# Only process Task tool
|
||||
[[ "$TOOL_NAME" != "Task" ]] && exit 0
|
||||
|
||||
# Extract subagent_type
|
||||
SUBAGENT_TYPE=$(echo "$INPUT" | jq -r '.tool_input.subagent_type // empty')
|
||||
|
||||
# Only log supervisor dispatches
|
||||
[[ "$SUBAGENT_TYPE" != *"supervisor"* ]] && exit 0
|
||||
|
||||
# Extract prompt
|
||||
PROMPT=$(echo "$INPUT" | jq -r '.tool_input.prompt // empty')
|
||||
[[ -z "$PROMPT" ]] && exit 0
|
||||
|
||||
# Extract BEAD_ID from prompt
|
||||
BEAD_ID=$(echo "$PROMPT" | grep -oE 'BEAD_ID: [A-Za-z0-9._-]+' | head -1 | sed 's/BEAD_ID: //')
|
||||
[[ -z "$BEAD_ID" ]] && exit 0
|
||||
|
||||
# Truncate prompt at 2048 chars
|
||||
TRUNCATED_PROMPT=$(echo "$PROMPT" | head -c 2048)
|
||||
|
||||
# Log dispatch to bead (fail silently)
|
||||
# Prefix: DISPATCH_PROMPT — UI renders as collapsible "Prompt Used" entry
|
||||
bd comment "$BEAD_ID" "DISPATCH_PROMPT [$SUBAGENT_TYPE]:
|
||||
|
||||
$TRUNCATED_PROMPT" 2>/dev/null || true
|
||||
|
||||
exit 0
|
||||
|
|
@ -0,0 +1,104 @@
|
|||
#!/bin/bash
|
||||
#
|
||||
# PostToolUse:Bash (async) - Capture knowledge from bd comment commands
|
||||
#
|
||||
# Detects: bd comment {BEAD_ID} "LEARNED: ..."
|
||||
# Extracts knowledge entries into .beads/memory/knowledge.jsonl
|
||||
#
|
||||
|
||||
INPUT=$(cat)
|
||||
TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
|
||||
|
||||
# Only process Bash tool
|
||||
[[ "$TOOL_NAME" != "Bash" ]] && exit 0
|
||||
|
||||
# Extract the command that was executed
|
||||
COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty')
|
||||
[[ -z "$COMMAND" ]] && exit 0
|
||||
|
||||
# Only process bd comment commands containing knowledge markers
|
||||
echo "$COMMAND" | grep -qE 'bd\s+comment\s+' || exit 0
|
||||
echo "$COMMAND" | grep -qE 'LEARNED:' || exit 0
|
||||
|
||||
# Extract BEAD_ID (argument after "bd comment")
|
||||
BEAD_ID=$(echo "$COMMAND" | sed -E 's/.*bd[[:space:]]+comment[[:space:]]+([A-Za-z0-9._-]+)[[:space:]]+.*/\1/')
|
||||
[[ -z "$BEAD_ID" || "$BEAD_ID" == "$COMMAND" ]] && exit 0
|
||||
|
||||
# Extract the comment body (content inside quotes after bead ID)
|
||||
COMMENT_BODY=$(echo "$COMMAND" | sed -E 's/.*bd[[:space:]]+comment[[:space:]]+[A-Za-z0-9._-]+[[:space:]]+["'\'']//' | sed -E 's/["'\''][[:space:]]*$//' | head -c 4096)
|
||||
[[ -z "$COMMENT_BODY" ]] && exit 0
|
||||
|
||||
# Determine type and extract content (voluntary LEARNED only)
|
||||
TYPE=""
|
||||
CONTENT=""
|
||||
if echo "$COMMENT_BODY" | grep -q "LEARNED:"; then
|
||||
TYPE="learned"
|
||||
CONTENT=$(echo "$COMMENT_BODY" | sed 's/.*LEARNED:[[:space:]]*//' | head -c 2048)
|
||||
fi
|
||||
|
||||
[[ -z "$TYPE" || -z "$CONTENT" ]] && exit 0
|
||||
|
||||
# Generate key from content (type + slugified first 60 chars)
|
||||
SLUG=$(echo "$CONTENT" | head -c 60 | tr '[:upper:]' '[:lower:]' | tr -cs 'a-z0-9' '-' | sed 's/^-//;s/-$//')
|
||||
KEY="${TYPE}-${SLUG}"
|
||||
|
||||
# Detect source agent from CWD or transcript context
|
||||
SOURCE="orchestrator"
|
||||
CWD=$(echo "$INPUT" | jq -r '.cwd // empty')
|
||||
if echo "$CWD" | grep -q '\.worktrees/'; then
|
||||
# Inside a worktree = supervisor is running
|
||||
SOURCE="supervisor"
|
||||
fi
|
||||
|
||||
# Build tags array - start with type tag
|
||||
TAGS_ARRAY=("$TYPE")
|
||||
|
||||
# Scan content for known tech keywords and add matching tags
|
||||
for tag in swift swiftui appkit menubar api security test database \
|
||||
networking ui layout performance crash bug fix workaround \
|
||||
gotcha pattern convention architecture auth middleware \
|
||||
async concurrency model protocol adapter scanner engine; do
|
||||
if echo "$CONTENT" | grep -qi "$tag"; then
|
||||
TAGS_ARRAY+=("$tag")
|
||||
fi
|
||||
done
|
||||
|
||||
# Convert tags array to JSON
|
||||
TAGS_JSON=$(printf '%s\n' "${TAGS_ARRAY[@]}" | jq -R . | jq -s .)
|
||||
|
||||
# Get timestamp
|
||||
TS=$(date +%s)
|
||||
|
||||
# Build JSON entry with proper escaping
|
||||
ENTRY=$(jq -cn \
|
||||
--arg key "$KEY" \
|
||||
--arg type "$TYPE" \
|
||||
--arg content "$CONTENT" \
|
||||
--arg source "$SOURCE" \
|
||||
--argjson tags "$TAGS_JSON" \
|
||||
--argjson ts "$TS" \
|
||||
--arg bead "$BEAD_ID" \
|
||||
'{key: $key, type: $type, content: $content, source: $source, tags: $tags, ts: $ts, bead: $bead}')
|
||||
|
||||
# Validate JSON
|
||||
[[ -z "$ENTRY" ]] && exit 0
|
||||
echo "$ENTRY" | jq . >/dev/null 2>&1 || exit 0
|
||||
|
||||
# Resolve memory directory
|
||||
MEMORY_DIR="${CLAUDE_PROJECT_DIR:-.}/.beads/memory"
|
||||
mkdir -p "$MEMORY_DIR"
|
||||
KNOWLEDGE_FILE="$MEMORY_DIR/knowledge.jsonl"
|
||||
|
||||
# Append entry
|
||||
echo "$ENTRY" >> "$KNOWLEDGE_FILE"
|
||||
|
||||
# Rotation: archive oldest 500 when file exceeds 1000 lines
|
||||
LINE_COUNT=$(wc -l < "$KNOWLEDGE_FILE" 2>/dev/null | tr -d ' ')
|
||||
if [[ "$LINE_COUNT" -gt 1000 ]]; then
|
||||
ARCHIVE_FILE="$MEMORY_DIR/knowledge.archive.jsonl"
|
||||
head -500 "$KNOWLEDGE_FILE" >> "$ARCHIVE_FILE"
|
||||
tail -n +501 "$KNOWLEDGE_FILE" > "$KNOWLEDGE_FILE.tmp"
|
||||
mv "$KNOWLEDGE_FILE.tmp" "$KNOWLEDGE_FILE"
|
||||
fi
|
||||
|
||||
exit 0
|
||||
|
|
@ -0,0 +1,44 @@
|
|||
#!/bin/bash
|
||||
#
|
||||
# Compact: Nudge orchestrator to update CLAUDE.md
|
||||
#
|
||||
# When context is compacted, remind the orchestrator to capture important
|
||||
# project state in CLAUDE.md so it survives across sessions.
|
||||
#
|
||||
|
||||
# Check if CLAUDE.md exists in project root
|
||||
REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null)
|
||||
[[ -z "$REPO_ROOT" ]] && exit 0
|
||||
|
||||
CLAUDE_MD="$REPO_ROOT/CLAUDE.md"
|
||||
[[ ! -f "$CLAUDE_MD" ]] && exit 0
|
||||
|
||||
# Check if Current State section exists and has content
|
||||
CURRENT_STATE=$(sed -n '/^## Current State/,/^## /p' "$CLAUDE_MD" | grep -v '^## ' | grep -v '^<!--' | grep -v '^-->' | grep -v '^$' | head -5)
|
||||
|
||||
if [[ -z "$CURRENT_STATE" ]]; then
|
||||
# Current State is empty — strong nudge
|
||||
cat << 'EOF'
|
||||
CLAUDE.md MAINTENANCE REMINDER:
|
||||
|
||||
The "## Current State" section in CLAUDE.md is empty. Before this context is compacted, consider updating it with:
|
||||
- Active work in progress (bead IDs, what's being built)
|
||||
- Recent architectural decisions or trade-offs made
|
||||
- Known issues or blockers discovered
|
||||
- Key files or patterns identified during investigation
|
||||
|
||||
This information will persist across sessions and help future investigations.
|
||||
|
||||
Update with: Edit CLAUDE.md → add content under "## Current State"
|
||||
EOF
|
||||
else
|
||||
# Current State has content — gentle reminder
|
||||
cat << 'EOF'
|
||||
Context is being compacted. If significant progress was made this session, consider updating CLAUDE.md:
|
||||
- "## Current State" for active work and decisions
|
||||
- "## Project Overview" if project scope became clearer
|
||||
- "## Tech Stack" if new technologies were discovered
|
||||
EOF
|
||||
fi
|
||||
|
||||
exit 0
|
||||
|
|
@ -0,0 +1,14 @@
|
|||
#!/bin/bash
|
||||
#
|
||||
# PreToolUse:Task - Soft reminder to set bead status before dispatch
|
||||
#
|
||||
|
||||
INPUT=$(cat)
|
||||
PROMPT=$(echo "$INPUT" | jq -r '.tool_input.prompt // empty')
|
||||
|
||||
# Only remind if dispatching a bead task (prompt contains BEAD_ID)
|
||||
if [[ "$PROMPT" == *"BEAD_ID:"* ]]; then
|
||||
echo "IMPORTANT: Before dispatching, ensure bead is in_progress: bd update {BEAD_ID} --status in_progress"
|
||||
fi
|
||||
|
||||
exit 0
|
||||
|
|
@ -0,0 +1,121 @@
|
|||
#!/bin/bash
|
||||
#
|
||||
# SessionStart: Show full task context for orchestrator
|
||||
#
|
||||
|
||||
BEADS_DIR="$CLAUDE_PROJECT_DIR/.beads"
|
||||
|
||||
if [[ ! -d "$BEADS_DIR" ]]; then
|
||||
echo "No .beads directory found. Run 'bd init' to initialize."
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# Check if bd is available
|
||||
if ! command -v bd &>/dev/null; then
|
||||
echo "beads CLI (bd) not found. Install from: https://github.com/steveyegge/beads"
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# ============================================================
|
||||
# Dirty Parent Check - Warn if main directory has uncommitted changes
|
||||
# ============================================================
|
||||
REPO_ROOT=$(git -C "$CLAUDE_PROJECT_DIR" rev-parse --show-toplevel 2>/dev/null)
|
||||
if [[ -n "$REPO_ROOT" ]]; then
|
||||
DIRTY=$(git -C "$REPO_ROOT" status --porcelain 2>/dev/null)
|
||||
if [[ -n "$DIRTY" ]]; then
|
||||
echo "⚠️ WARNING: Main directory has uncommitted changes."
|
||||
echo " Agents should only work in .worktrees/"
|
||||
echo ""
|
||||
fi
|
||||
fi
|
||||
|
||||
# ============================================================
|
||||
# Auto-cleanup: Detect merged PRs and cleanup worktrees
|
||||
# ============================================================
|
||||
WORKTREES_DIR="$CLAUDE_PROJECT_DIR/.worktrees"
|
||||
if [[ -d "$WORKTREES_DIR" ]]; then
|
||||
for worktree in $(git -C "$REPO_ROOT" worktree list --porcelain 2>/dev/null | grep "^worktree.*\.worktrees/bd-" | awk '{print $2}'); do
|
||||
BEAD_ID=$(basename "$worktree" | sed 's/bd-//')
|
||||
BRANCH=$(basename "$worktree")
|
||||
|
||||
# Check if branch was merged to main
|
||||
if git -C "$REPO_ROOT" branch --merged main 2>/dev/null | grep -q "$BRANCH"; then
|
||||
echo "✓ $BRANCH was merged - consider cleaning up"
|
||||
echo " Run: git worktree remove \"$worktree\" && bd close \"$BEAD_ID\""
|
||||
echo ""
|
||||
fi
|
||||
done
|
||||
fi
|
||||
|
||||
# ============================================================
|
||||
# Open PR Reminder
|
||||
# ============================================================
|
||||
if command -v gh &>/dev/null; then
|
||||
OPEN_PRS=$(gh pr list --author "@me" --state open --json number,title,headRefName 2>/dev/null)
|
||||
if [[ -n "$OPEN_PRS" && "$OPEN_PRS" != "[]" ]]; then
|
||||
echo "📋 You have open PRs:"
|
||||
echo "$OPEN_PRS" | jq -r '.[] | " #\(.number) \(.title) (\(.headRefName))"' 2>/dev/null
|
||||
echo ""
|
||||
fi
|
||||
fi
|
||||
|
||||
echo ""
|
||||
echo "## Task Status"
|
||||
echo ""
|
||||
|
||||
# Show in-progress beads first (highest priority)
|
||||
IN_PROGRESS=$(bd list --status in_progress 2>/dev/null | head -5)
|
||||
if [[ -n "$IN_PROGRESS" ]]; then
|
||||
echo "### In Progress (resume these):"
|
||||
echo "$IN_PROGRESS"
|
||||
echo ""
|
||||
fi
|
||||
|
||||
# Show ready (unblocked) beads
|
||||
READY=$(bd ready 2>/dev/null | head -5)
|
||||
if [[ -n "$READY" ]]; then
|
||||
echo "### Ready (no blockers):"
|
||||
echo "$READY"
|
||||
echo ""
|
||||
fi
|
||||
|
||||
# Show blocked beads
|
||||
BLOCKED=$(bd blocked 2>/dev/null | head -3)
|
||||
if [[ -n "$BLOCKED" ]]; then
|
||||
echo "### Blocked:"
|
||||
echo "$BLOCKED"
|
||||
echo ""
|
||||
fi
|
||||
|
||||
# Show stale beads (no activity in 3 days)
|
||||
STALE=$(bd stale --days 3 2>/dev/null | head -3)
|
||||
if [[ -n "$STALE" ]]; then
|
||||
echo "### Stale (no activity in 3 days):"
|
||||
echo "$STALE"
|
||||
echo ""
|
||||
fi
|
||||
|
||||
# If nothing found
|
||||
if [[ -z "$IN_PROGRESS" && -z "$READY" && -z "$BLOCKED" && -z "$STALE" ]]; then
|
||||
echo "No active beads. Create one with: bd create \"Task title\" -d \"Description\""
|
||||
fi
|
||||
|
||||
# ============================================================
|
||||
# Knowledge Base - Surface recent learnings
|
||||
# ============================================================
|
||||
KNOWLEDGE_FILE="$BEADS_DIR/memory/knowledge.jsonl"
|
||||
if [[ -f "$KNOWLEDGE_FILE" && -s "$KNOWLEDGE_FILE" ]]; then
|
||||
TOTAL_ENTRIES=$(wc -l < "$KNOWLEDGE_FILE" | tr -d ' ')
|
||||
echo ""
|
||||
echo "## Recent Knowledge ($TOTAL_ENTRIES entries)"
|
||||
echo ""
|
||||
# Show 5 most recent, deduplicated by key (latest wins)
|
||||
tail -20 "$KNOWLEDGE_FILE" | jq -s '
|
||||
group_by(.key) | map(max_by(.ts)) | sort_by(-.ts) | .[0:5] | .[] |
|
||||
" [\(.type | ascii_upcase | .[0:5])] \(.content | .[0:100]) (\(.source))"
|
||||
' -r 2>/dev/null
|
||||
echo ""
|
||||
echo " Search: .beads/memory/recall.sh \"keyword\""
|
||||
fi
|
||||
|
||||
echo ""
|
||||
|
|
@ -0,0 +1,131 @@
|
|||
#!/bin/bash
|
||||
#
|
||||
# SubagentStop: Enforce bead lifecycle - work verification
|
||||
#
|
||||
|
||||
INPUT=$(cat)
|
||||
AGENT_TRANSCRIPT=$(echo "$INPUT" | jq -r '.agent_transcript_path // empty')
|
||||
MAIN_TRANSCRIPT=$(echo "$INPUT" | jq -r '.transcript_path // empty')
|
||||
AGENT_ID=$(echo "$INPUT" | jq -r '.agent_id // empty')
|
||||
|
||||
[[ -z "$AGENT_TRANSCRIPT" || ! -f "$AGENT_TRANSCRIPT" ]] && echo '{"decision":"approve"}' && exit 0
|
||||
|
||||
# Extract last assistant text response
|
||||
LAST_RESPONSE=$(tail -200 "$AGENT_TRANSCRIPT" | jq -rs '
|
||||
[.[] | select(.message?.role == "assistant" and .message?.content != null)
|
||||
| .message.content[] | select(.text != null) | .text] | last // ""
|
||||
' 2>/dev/null || echo "")
|
||||
|
||||
# === LAYER 1: Extract subagent_type from transcript (fail open) ===
|
||||
SUBAGENT_TYPE=""
|
||||
if [[ -n "$AGENT_ID" && -n "$MAIN_TRANSCRIPT" && -f "$MAIN_TRANSCRIPT" ]]; then
|
||||
PARENT_TOOL_USE_ID=$(grep "\"agentId\":\"$AGENT_ID\"" "$MAIN_TRANSCRIPT" 2>/dev/null | head -1 | jq -r '.parentToolUseID // empty' 2>/dev/null)
|
||||
if [[ -n "$PARENT_TOOL_USE_ID" ]]; then
|
||||
SUBAGENT_TYPE=$(grep "\"id\":\"$PARENT_TOOL_USE_ID\"" "$MAIN_TRANSCRIPT" 2>/dev/null | \
|
||||
grep '"name":"Task"' | \
|
||||
jq -r '.message.content[]? | select(.type == "tool_use" and .id == "'"$PARENT_TOOL_USE_ID"'") | .input.subagent_type // empty' 2>/dev/null | \
|
||||
head -1)
|
||||
fi
|
||||
fi
|
||||
|
||||
# === LAYER 2: Check completion format (backup detection) ===
|
||||
HAS_BEAD_COMPLETE=$(echo "$LAST_RESPONSE" | grep -cE "BEAD.*COMPLETE" 2>/dev/null || true)
|
||||
HAS_WORKTREE_OR_BRANCH=$(echo "$LAST_RESPONSE" | grep -cE "(Worktree:|Branch:).*bd-" 2>/dev/null || true)
|
||||
[[ -z "$HAS_BEAD_COMPLETE" ]] && HAS_BEAD_COMPLETE=0
|
||||
[[ -z "$HAS_WORKTREE_OR_BRANCH" ]] && HAS_WORKTREE_OR_BRANCH=0
|
||||
|
||||
# Determine if this is a supervisor (Layer 1) or has completion format (Layer 2)
|
||||
IS_SUPERVISOR="false"
|
||||
[[ "$SUBAGENT_TYPE" == *"supervisor"* ]] && IS_SUPERVISOR="true"
|
||||
|
||||
NEEDS_VERIFICATION="false"
|
||||
[[ "$IS_SUPERVISOR" == "true" ]] && NEEDS_VERIFICATION="true"
|
||||
[[ "$HAS_BEAD_COMPLETE" -ge 1 && "$HAS_WORKTREE_OR_BRANCH" -ge 1 ]] && NEEDS_VERIFICATION="true"
|
||||
|
||||
# Skip verification if not needed
|
||||
[[ "$NEEDS_VERIFICATION" == "false" ]] && echo '{"decision":"approve"}' && exit 0
|
||||
|
||||
# Worker supervisor is exempt
|
||||
[[ "$SUBAGENT_TYPE" == *"worker"* ]] && echo '{"decision":"approve"}' && exit 0
|
||||
|
||||
# === VERIFICATION CHECKS ===
|
||||
|
||||
# Check 1: Completion format required for supervisors
|
||||
if [[ "$IS_SUPERVISOR" == "true" ]] && [[ "$HAS_BEAD_COMPLETE" -lt 1 || "$HAS_WORKTREE_OR_BRANCH" -lt 1 ]]; then
|
||||
cat << 'EOF'
|
||||
{"decision":"block","reason":"Work verification failed: completion report missing.\n\nRequired format:\nBEAD {BEAD_ID} COMPLETE\nWorktree: .worktrees/bd-{BEAD_ID}\nFiles: [list]\nTests: pass\nSummary: [1 sentence]"}
|
||||
EOF
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# Extract BEAD_ID from response
|
||||
BEAD_ID_FROM_RESPONSE=$(echo "$LAST_RESPONSE" | grep -oE "BEAD [A-Za-z0-9._-]+" | head -1 | awk '{print $2}')
|
||||
IS_EPIC_CHILD="false"
|
||||
[[ "$BEAD_ID_FROM_RESPONSE" == *"."* ]] && IS_EPIC_CHILD="true"
|
||||
|
||||
# Check 2: Comment required
|
||||
HAS_COMMENT=$(grep -c '"bd comment\|"command":"bd comment' "$AGENT_TRANSCRIPT" 2>/dev/null) || HAS_COMMENT=0
|
||||
if [[ "$HAS_COMMENT" -lt 1 ]]; then
|
||||
cat << 'EOF'
|
||||
{"decision":"block","reason":"Work verification failed: no comment on bead.\n\nRun: bd comment {BEAD_ID} \"Completed: [summary]\""}
|
||||
EOF
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# Check 3: Worktree verification
|
||||
REPO_ROOT=$(cd "$(git rev-parse --git-common-dir)/.." 2>/dev/null && pwd)
|
||||
WORKTREE_PATH="$REPO_ROOT/.worktrees/bd-${BEAD_ID_FROM_RESPONSE}"
|
||||
|
||||
if [[ ! -d "$WORKTREE_PATH" ]]; then
|
||||
cat << 'EOF'
|
||||
{"decision":"block","reason":"Work verification failed: worktree not found.\n\nCreate worktree first via API."}
|
||||
EOF
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# Check 4: Uncommitted changes
|
||||
UNCOMMITTED=$(git -C "$WORKTREE_PATH" status --porcelain 2>/dev/null)
|
||||
if [[ -n "$UNCOMMITTED" ]]; then
|
||||
cat << 'EOF'
|
||||
{"decision":"block","reason":"Work verification failed: uncommitted changes.\n\nRun in worktree:\n git add -A && git commit -m \"...\""}
|
||||
EOF
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# Check 5: Remote push
|
||||
HAS_REMOTE=$(git -C "$WORKTREE_PATH" remote get-url origin 2>/dev/null)
|
||||
if [[ -n "$HAS_REMOTE" ]]; then
|
||||
BRANCH="bd-${BEAD_ID_FROM_RESPONSE}"
|
||||
REMOTE_EXISTS=$(git -C "$WORKTREE_PATH" ls-remote --heads origin "$BRANCH" 2>/dev/null)
|
||||
if [[ -z "$REMOTE_EXISTS" ]]; then
|
||||
cat << 'EOF'
|
||||
{"decision":"block","reason":"Work verification failed: branch not pushed.\n\nRun: git push -u origin bd-{BEAD_ID}"}
|
||||
EOF
|
||||
exit 0
|
||||
fi
|
||||
fi
|
||||
|
||||
# Check 6: Bead status
|
||||
BEAD_STATUS=$(bd show "$BEAD_ID_FROM_RESPONSE" --json 2>/dev/null | jq -r '.[0].status // "unknown"')
|
||||
EXPECTED_STATUS="inreview"
|
||||
# Epic children also use inreview (done status not supported in bd)
|
||||
if [[ "$BEAD_STATUS" != "$EXPECTED_STATUS" ]]; then
|
||||
cat << EOF
|
||||
{"decision":"block","reason":"Work verification failed: bead status is '${BEAD_STATUS}'.\n\nRun: bd update ${BEAD_ID_FROM_RESPONSE} --status ${EXPECTED_STATUS}"}
|
||||
EOF
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# Check 7: Verbosity limit
|
||||
DECODED_RESPONSE=$(printf '%b' "$LAST_RESPONSE")
|
||||
LINE_COUNT=$(echo "$DECODED_RESPONSE" | wc -l | tr -d ' ')
|
||||
CHAR_COUNT=${#DECODED_RESPONSE}
|
||||
|
||||
if [[ "$LINE_COUNT" -gt 15 ]] || [[ "$CHAR_COUNT" -gt 800 ]]; then
|
||||
cat << EOF
|
||||
{"decision":"block","reason":"Work verification failed: response too verbose (${LINE_COUNT} lines, ${CHAR_COUNT} chars). Max: 15 lines, 800 chars."}
|
||||
EOF
|
||||
exit 0
|
||||
fi
|
||||
|
||||
echo '{"decision":"approve"}'
|
||||
|
|
@ -0,0 +1,84 @@
|
|||
#!/bin/bash
|
||||
# Hook: Validate bead close — PR must be merged, epic children must be complete
|
||||
# Prevents closing a bead whose branch has no merged PR
|
||||
# Prevents closing an epic when children are still open
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
TOOL_INPUT="${CLAUDE_TOOL_INPUT:-}"
|
||||
|
||||
# Only check Bash commands containing "bd close"
|
||||
if ! echo "$TOOL_INPUT" | jq -e '.command' >/dev/null 2>&1; then
|
||||
exit 0
|
||||
fi
|
||||
|
||||
COMMAND=$(echo "$TOOL_INPUT" | jq -r '.command // ""')
|
||||
|
||||
# Check if this is a bd close command
|
||||
if ! echo "$COMMAND" | grep -qE 'bd\s+close'; then
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# Allow --force override
|
||||
if echo "$COMMAND" | grep -qE '\-\-force'; then
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# Extract the ID being closed (handles: bd close ID, bd close ID && ..., etc.)
|
||||
CLOSE_ID=$(echo "$COMMAND" | sed -E 's/.*bd[[:space:]]+close[[:space:]]+([A-Za-z0-9._-]+).*/\1/')
|
||||
|
||||
if [ -z "$CLOSE_ID" ]; then
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# === CHECK 1: PR merge validation ===
|
||||
# Only applies if repo has a remote and branch exists
|
||||
BRANCH="bd-${CLOSE_ID}"
|
||||
|
||||
HAS_REMOTE=$(git remote get-url origin 2>/dev/null || echo "")
|
||||
if [ -n "$HAS_REMOTE" ]; then
|
||||
REMOTE_BRANCH=$(git ls-remote --heads origin "$BRANCH" 2>/dev/null || echo "")
|
||||
|
||||
if [ -n "$REMOTE_BRANCH" ]; then
|
||||
# Branch exists on remote — check for merged PR
|
||||
if command -v gh >/dev/null 2>&1; then
|
||||
MERGED_PR=$(gh pr list --head "$BRANCH" --state merged --json number --jq '.[0].number' 2>/dev/null || echo "")
|
||||
|
||||
if [ -z "$MERGED_PR" ]; then
|
||||
cat << EOF
|
||||
{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Cannot close bead '$CLOSE_ID' — branch '$BRANCH' has no merged PR. Create and merge a PR first, or use 'bd close $CLOSE_ID --force' to override."}}
|
||||
EOF
|
||||
exit 0
|
||||
fi
|
||||
fi
|
||||
fi
|
||||
fi
|
||||
|
||||
# === CHECK 2: Epic children validation ===
|
||||
# Check if this is an epic by looking at issue_type
|
||||
ISSUE_TYPE=$(bd show "$CLOSE_ID" --json 2>/dev/null | jq -r '.[0].issue_type // ""' 2>/dev/null || echo "")
|
||||
|
||||
if [ "$ISSUE_TYPE" != "epic" ]; then
|
||||
# Not an epic, allow close
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# This is an epic - check if all children are complete
|
||||
INCOMPLETE=$(bd list --json 2>/dev/null | jq -r --arg epic "$CLOSE_ID" '
|
||||
[.[] | select((.id | startswith($epic + ".")) and .status != "done" and .status != "closed")] | length
|
||||
' 2>/dev/null || echo "0")
|
||||
|
||||
if [ "$INCOMPLETE" != "0" ] && [ "$INCOMPLETE" != "" ]; then
|
||||
# Get list of incomplete children for the error message
|
||||
INCOMPLETE_LIST=$(bd list --json 2>/dev/null | jq -r --arg epic "$CLOSE_ID" '
|
||||
[.[] | select((.id | startswith($epic + ".")) and .status != "done" and .status != "closed")] | .[] | "\(.id) (\(.status))"
|
||||
' 2>/dev/null | tr '\n' ', ' | sed 's/,$//')
|
||||
|
||||
cat << EOF
|
||||
{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Cannot close epic '$CLOSE_ID' - has $INCOMPLETE incomplete children: $INCOMPLETE_LIST. Mark all children as done first."}}
|
||||
EOF
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# All checks passed, allow close
|
||||
exit 0
|
||||
|
|
@ -0,0 +1,12 @@
|
|||
{
|
||||
"mcpServers": {
|
||||
"provider_delegator": {
|
||||
"type": "stdio",
|
||||
"command": "{{PROVIDER_DELEGATOR_PATH}}",
|
||||
"args": ["-m", "mcp_provider_delegator.server"],
|
||||
"env": {
|
||||
"AGENT_TEMPLATES_PATH": "{{AGENT_TEMPLATES_PATH}}"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,121 @@
|
|||
#!/bin/bash
|
||||
#
|
||||
# recall.sh - Search the project knowledge base
|
||||
#
|
||||
# Usage:
|
||||
# .beads/memory/recall.sh "keyword" # Search by keyword
|
||||
# .beads/memory/recall.sh "keyword" --type learned # Filter by type
|
||||
# .beads/memory/recall.sh --recent 10 # Show N most recent
|
||||
# .beads/memory/recall.sh --stats # Knowledge base stats
|
||||
# .beads/memory/recall.sh "keyword" --all # Include archive
|
||||
#
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
|
||||
KNOWLEDGE_FILE="$SCRIPT_DIR/knowledge.jsonl"
|
||||
ARCHIVE_FILE="$SCRIPT_DIR/knowledge.archive.jsonl"
|
||||
|
||||
if [[ ! -f "$KNOWLEDGE_FILE" ]] || [[ ! -s "$KNOWLEDGE_FILE" ]]; then
|
||||
echo "No knowledge entries yet."
|
||||
echo "Entries are created automatically from bd comment commands with INVESTIGATION: or LEARNED: prefixes."
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# Parse arguments
|
||||
QUERY=""
|
||||
TYPE_FILTER=""
|
||||
INCLUDE_ARCHIVE=false
|
||||
SHOW_RECENT=0
|
||||
SHOW_STATS=false
|
||||
|
||||
while [[ $# -gt 0 ]]; do
|
||||
case "$1" in
|
||||
--type)
|
||||
TYPE_FILTER="${2:-}"
|
||||
shift 2
|
||||
;;
|
||||
--all)
|
||||
INCLUDE_ARCHIVE=true
|
||||
shift
|
||||
;;
|
||||
--recent)
|
||||
SHOW_RECENT="${2:-10}"
|
||||
shift 2
|
||||
;;
|
||||
--stats)
|
||||
SHOW_STATS=true
|
||||
shift
|
||||
;;
|
||||
--help|-h)
|
||||
echo "Usage: recall.sh [query] [--type learned|investigation] [--all] [--recent N] [--stats]"
|
||||
exit 0
|
||||
;;
|
||||
*)
|
||||
QUERY="$1"
|
||||
shift
|
||||
;;
|
||||
esac
|
||||
done
|
||||
|
||||
# Stats mode
|
||||
if [[ "$SHOW_STATS" == "true" ]]; then
|
||||
TOTAL=$(wc -l < "$KNOWLEDGE_FILE" | tr -d ' ')
|
||||
LEARNED=$(grep -c '"type":"learned"' "$KNOWLEDGE_FILE" 2>/dev/null) || LEARNED=0
|
||||
INVESTIGATION=$(grep -c '"type":"investigation"' "$KNOWLEDGE_FILE" 2>/dev/null) || INVESTIGATION=0
|
||||
UNIQUE_KEYS=$(jq -r '.key' "$KNOWLEDGE_FILE" 2>/dev/null | sort -u | wc -l | tr -d ' ')
|
||||
ARCHIVE_COUNT=0
|
||||
[[ -f "$ARCHIVE_FILE" ]] && ARCHIVE_COUNT=$(wc -l < "$ARCHIVE_FILE" | tr -d ' ')
|
||||
|
||||
echo "## Knowledge Base Stats"
|
||||
echo " Active entries: $TOTAL"
|
||||
echo " Unique keys: $UNIQUE_KEYS"
|
||||
echo " Learned: $LEARNED"
|
||||
echo " Investigation: $INVESTIGATION"
|
||||
echo " Archived: $ARCHIVE_COUNT"
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# Recent mode
|
||||
if [[ "$SHOW_RECENT" -gt 0 ]]; then
|
||||
echo "## Recent Knowledge ($SHOW_RECENT entries)"
|
||||
echo ""
|
||||
tail -"$SHOW_RECENT" "$KNOWLEDGE_FILE" | jq -r '
|
||||
"[\(.type | ascii_upcase | .[0:5])] \(.key)\n \(.content | .[0:120])\n source=\(.source) bead=\(.bead)\n"
|
||||
' 2>/dev/null
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# Search mode (default)
|
||||
if [[ -z "$QUERY" ]]; then
|
||||
echo "Usage: recall.sh <keyword> [--type learned|investigation] [--all]"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# Build file list
|
||||
FILES="$KNOWLEDGE_FILE"
|
||||
if [[ "$INCLUDE_ARCHIVE" == "true" && -f "$ARCHIVE_FILE" ]]; then
|
||||
FILES="$ARCHIVE_FILE $KNOWLEDGE_FILE"
|
||||
fi
|
||||
|
||||
# Search and deduplicate (latest entry for each key wins)
|
||||
RESULTS=$(cat $FILES | grep -i "$QUERY" 2>/dev/null || true)
|
||||
|
||||
# Apply type filter
|
||||
if [[ -n "$TYPE_FILTER" ]]; then
|
||||
RESULTS=$(echo "$RESULTS" | grep "\"type\":\"$TYPE_FILTER\"" 2>/dev/null || true)
|
||||
fi
|
||||
|
||||
if [[ -z "$RESULTS" ]]; then
|
||||
echo "No knowledge entries matching '$QUERY'"
|
||||
[[ -n "$TYPE_FILTER" ]] && echo " (filtered by type: $TYPE_FILTER)"
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# Deduplicate by key (latest wins) and format output
|
||||
echo "$RESULTS" | jq -s '
|
||||
group_by(.key) | map(max_by(.ts)) | sort_by(-.ts) | .[] |
|
||||
"[\(.type | ascii_upcase | .[0:5])] \(.key)\n \(.content | .[0:200])\n source=\(.source) bead=\(.bead) tags=\(.tags | join(","))\n"
|
||||
' -r 2>/dev/null
|
||||
|
||||
exit 0
|
||||
|
|
@ -0,0 +1,81 @@
|
|||
{
|
||||
"hooks": {
|
||||
"PreToolUse": [
|
||||
{
|
||||
"hooks": [
|
||||
{"type": "command", "command": ".claude/hooks/block-orchestrator-tools.sh"}
|
||||
]
|
||||
},
|
||||
{
|
||||
"matcher": "Task",
|
||||
"hooks": [
|
||||
{"type": "command", "command": ".claude/hooks/enforce-bead-for-supervisor.sh"},
|
||||
{"type": "command", "command": ".claude/hooks/enforce-sequential-dispatch.sh"},
|
||||
{"type": "command", "command": ".claude/hooks/remind-inprogress.sh"},
|
||||
{"type": "command", "command": ".claude/hooks/inject-discipline-reminder.sh"}
|
||||
]
|
||||
},
|
||||
{
|
||||
"matcher": "Edit",
|
||||
"hooks": [
|
||||
{"type": "command", "command": ".claude/hooks/enforce-branch-before-edit.sh"}
|
||||
]
|
||||
},
|
||||
{
|
||||
"matcher": "Write",
|
||||
"hooks": [
|
||||
{"type": "command", "command": ".claude/hooks/enforce-branch-before-edit.sh"}
|
||||
]
|
||||
},
|
||||
{
|
||||
"matcher": "Bash",
|
||||
"hooks": [
|
||||
{"type": "command", "command": ".claude/hooks/validate-epic-close.sh"}
|
||||
]
|
||||
}
|
||||
],
|
||||
"PostToolUse": [
|
||||
{
|
||||
"matcher": "Task",
|
||||
"hooks": [
|
||||
{"type": "command", "command": ".claude/hooks/enforce-concise-response.sh"},
|
||||
{"type": "command", "command": ".claude/hooks/log-dispatch-prompt.sh", "timeout": 10}
|
||||
]
|
||||
},
|
||||
{
|
||||
"matcher": "Bash",
|
||||
"hooks": [
|
||||
{"type": "command", "command": ".claude/hooks/memory-capture.sh", "timeout": 10}
|
||||
]
|
||||
}
|
||||
],
|
||||
"SubagentStop": [
|
||||
{
|
||||
"hooks": [
|
||||
{"type": "command", "command": ".claude/hooks/validate-completion.sh"}
|
||||
]
|
||||
}
|
||||
],
|
||||
"SessionStart": [
|
||||
{
|
||||
"hooks": [
|
||||
{"type": "command", "command": ".claude/hooks/session-start.sh"}
|
||||
]
|
||||
}
|
||||
],
|
||||
"UserPromptSubmit": [
|
||||
{
|
||||
"hooks": [
|
||||
{"type": "command", "command": ".claude/hooks/clarify-vague-request.sh"}
|
||||
]
|
||||
}
|
||||
],
|
||||
"PreCompact": [
|
||||
{
|
||||
"hooks": [
|
||||
{"type": "command", "command": ".claude/hooks/nudge-claude-md-update.sh"}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,487 @@
|
|||
---
|
||||
name: react-best-practices
|
||||
description: React and Next.js performance optimization patterns. Use BEFORE implementing any React code to ensure best practices are followed.
|
||||
---
|
||||
|
||||
# React Best Practices
|
||||
|
||||
**Version 1.0.0**
|
||||
Source: Vercel Engineering (vercel-labs/agent-skills)
|
||||
|
||||
> **Note:**
|
||||
> This document is for agents and LLMs to follow when maintaining,
|
||||
> generating, or refactoring React and Next.js codebases. Contains 40+ rules across 8 categories, prioritized by impact.
|
||||
|
||||
---
|
||||
|
||||
## How to Use This Skill
|
||||
|
||||
**Before implementing ANY React/Next.js code:**
|
||||
|
||||
1. Review the relevant sections based on what you're building
|
||||
2. Apply the patterns as you write code
|
||||
3. Use the "Incorrect" vs "Correct" examples as templates
|
||||
|
||||
**Priority order:** Eliminating Waterfalls > Bundle Size > Server-Side > Client-Side > Re-renders > Rendering > JS Perf > Advanced
|
||||
|
||||
---
|
||||
|
||||
## Quick Reference: Critical Rules
|
||||
|
||||
### Top 5 Rules (Always Apply)
|
||||
|
||||
1. **Promise.all() for independent operations** - Never sequential awaits for independent data
|
||||
2. **Avoid barrel file imports** - Import directly from source files
|
||||
3. **Dynamic imports for heavy components** - Lazy-load Monaco, charts, etc.
|
||||
4. **Parallel data fetching with component composition** - Structure RSC for parallelism
|
||||
5. **Minimize serialization at RSC boundaries** - Only pass needed fields to client
|
||||
|
||||
---
|
||||
|
||||
## 1. Eliminating Waterfalls
|
||||
|
||||
**Impact: CRITICAL** - Waterfalls are the #1 performance killer.
|
||||
|
||||
### 1.1 Defer Await Until Needed
|
||||
|
||||
Move `await` into branches where actually used.
|
||||
|
||||
```typescript
|
||||
// BAD: blocks both branches
|
||||
async function handleRequest(userId: string, skipProcessing: boolean) {
|
||||
const userData = await fetchUserData(userId)
|
||||
if (skipProcessing) return { skipped: true }
|
||||
return processUserData(userData)
|
||||
}
|
||||
|
||||
// GOOD: only blocks when needed
|
||||
async function handleRequest(userId: string, skipProcessing: boolean) {
|
||||
if (skipProcessing) return { skipped: true }
|
||||
const userData = await fetchUserData(userId)
|
||||
return processUserData(userData)
|
||||
}
|
||||
```
|
||||
|
||||
### 1.2 Promise.all() for Independent Operations
|
||||
|
||||
```typescript
|
||||
// BAD: 3 round trips
|
||||
const user = await fetchUser()
|
||||
const posts = await fetchPosts()
|
||||
const comments = await fetchComments()
|
||||
|
||||
// GOOD: 1 round trip
|
||||
const [user, posts, comments] = await Promise.all([
|
||||
fetchUser(),
|
||||
fetchPosts(),
|
||||
fetchComments()
|
||||
])
|
||||
```
|
||||
|
||||
### 1.3 Strategic Suspense Boundaries
|
||||
|
||||
```tsx
|
||||
// BAD: wrapper blocked by data
|
||||
async function Page() {
|
||||
const data = await fetchData()
|
||||
return (
|
||||
<div>
|
||||
<Sidebar />
|
||||
<DataDisplay data={data} />
|
||||
<Footer />
|
||||
</div>
|
||||
)
|
||||
}
|
||||
|
||||
// GOOD: wrapper shows immediately
|
||||
function Page() {
|
||||
return (
|
||||
<div>
|
||||
<Sidebar />
|
||||
<Suspense fallback={<Skeleton />}>
|
||||
<DataDisplay />
|
||||
</Suspense>
|
||||
<Footer />
|
||||
</div>
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. Bundle Size Optimization
|
||||
|
||||
**Impact: CRITICAL** - Reduces TTI and LCP.
|
||||
|
||||
### 2.1 Avoid Barrel File Imports
|
||||
|
||||
```tsx
|
||||
// BAD: loads 1,583 modules
|
||||
import { Check, X, Menu } from 'lucide-react'
|
||||
|
||||
// GOOD: loads only 3 modules
|
||||
import Check from 'lucide-react/dist/esm/icons/check'
|
||||
import X from 'lucide-react/dist/esm/icons/x'
|
||||
import Menu from 'lucide-react/dist/esm/icons/menu'
|
||||
|
||||
// ALTERNATIVE: Next.js 13.5+ config
|
||||
// next.config.js
|
||||
module.exports = {
|
||||
experimental: {
|
||||
optimizePackageImports: ['lucide-react', '@mui/material']
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 2.2 Dynamic Imports for Heavy Components
|
||||
|
||||
```tsx
|
||||
// BAD: Monaco bundles with main chunk (~300KB)
|
||||
import { MonacoEditor } from './monaco-editor'
|
||||
|
||||
// GOOD: Monaco loads on demand
|
||||
import dynamic from 'next/dynamic'
|
||||
const MonacoEditor = dynamic(
|
||||
() => import('./monaco-editor').then(m => m.MonacoEditor),
|
||||
{ ssr: false }
|
||||
)
|
||||
```
|
||||
|
||||
### 2.3 Defer Non-Critical Libraries
|
||||
|
||||
```tsx
|
||||
// BAD: blocks initial bundle
|
||||
import { Analytics } from '@vercel/analytics/react'
|
||||
|
||||
// GOOD: loads after hydration
|
||||
import dynamic from 'next/dynamic'
|
||||
const Analytics = dynamic(
|
||||
() => import('@vercel/analytics/react').then(m => m.Analytics),
|
||||
{ ssr: false }
|
||||
)
|
||||
```
|
||||
|
||||
### 2.4 Preload on User Intent
|
||||
|
||||
```tsx
|
||||
function EditorButton({ onClick }: { onClick: () => void }) {
|
||||
const preload = () => {
|
||||
if (typeof window !== 'undefined') {
|
||||
void import('./monaco-editor')
|
||||
}
|
||||
}
|
||||
return (
|
||||
<button onMouseEnter={preload} onFocus={preload} onClick={onClick}>
|
||||
Open Editor
|
||||
</button>
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. Server-Side Performance
|
||||
|
||||
**Impact: HIGH**
|
||||
|
||||
### 3.1 Minimize Serialization at RSC Boundaries
|
||||
|
||||
```tsx
|
||||
// BAD: serializes all 50 fields
|
||||
async function Page() {
|
||||
const user = await fetchUser() // 50 fields
|
||||
return <Profile user={user} />
|
||||
}
|
||||
|
||||
// GOOD: serializes only needed fields
|
||||
async function Page() {
|
||||
const user = await fetchUser()
|
||||
return <Profile name={user.name} avatar={user.avatar} />
|
||||
}
|
||||
```
|
||||
|
||||
### 3.2 Parallel Data Fetching with Component Composition
|
||||
|
||||
```tsx
|
||||
// BAD: Sidebar waits for Header's fetch
|
||||
export default async function Page() {
|
||||
const header = await fetchHeader()
|
||||
return (
|
||||
<div>
|
||||
<div>{header}</div>
|
||||
<Sidebar />
|
||||
</div>
|
||||
)
|
||||
}
|
||||
|
||||
// GOOD: both fetch simultaneously
|
||||
async function Header() {
|
||||
const data = await fetchHeader()
|
||||
return <div>{data}</div>
|
||||
}
|
||||
|
||||
async function Sidebar() {
|
||||
const items = await fetchSidebarItems()
|
||||
return <nav>{items.map(renderItem)}</nav>
|
||||
}
|
||||
|
||||
export default function Page() {
|
||||
return (
|
||||
<div>
|
||||
<Header />
|
||||
<Sidebar />
|
||||
</div>
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
### 3.3 Per-Request Deduplication with React.cache()
|
||||
|
||||
```typescript
|
||||
import { cache } from 'react'
|
||||
|
||||
export const getCurrentUser = cache(async () => {
|
||||
const session = await auth()
|
||||
if (!session?.user?.id) return null
|
||||
return await db.user.findUnique({ where: { id: session.user.id } })
|
||||
})
|
||||
```
|
||||
|
||||
### 3.4 Use after() for Non-Blocking Operations
|
||||
|
||||
```tsx
|
||||
import { after } from 'next/server'
|
||||
|
||||
export async function POST(request: Request) {
|
||||
await updateDatabase(request)
|
||||
|
||||
// Log after response is sent
|
||||
after(async () => {
|
||||
const userAgent = (await headers()).get('user-agent')
|
||||
logUserAction({ userAgent })
|
||||
})
|
||||
|
||||
return Response.json({ status: 'success' })
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. Client-Side Data Fetching
|
||||
|
||||
**Impact: MEDIUM-HIGH**
|
||||
|
||||
### 4.1 Use SWR for Automatic Deduplication
|
||||
|
||||
```tsx
|
||||
// BAD: no deduplication
|
||||
function UserList() {
|
||||
const [users, setUsers] = useState([])
|
||||
useEffect(() => {
|
||||
fetch('/api/users').then(r => r.json()).then(setUsers)
|
||||
}, [])
|
||||
}
|
||||
|
||||
// GOOD: multiple instances share one request
|
||||
import useSWR from 'swr'
|
||||
function UserList() {
|
||||
const { data: users } = useSWR('/api/users', fetcher)
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. Re-render Optimization
|
||||
|
||||
**Impact: MEDIUM**
|
||||
|
||||
### 5.1 Use Functional setState Updates
|
||||
|
||||
```tsx
|
||||
// BAD: requires state as dependency, risk of stale closure
|
||||
const addItems = useCallback((newItems: Item[]) => {
|
||||
setItems([...items, ...newItems])
|
||||
}, [items])
|
||||
|
||||
// GOOD: stable callback, no stale closures
|
||||
const addItems = useCallback((newItems: Item[]) => {
|
||||
setItems(curr => [...curr, ...newItems])
|
||||
}, [])
|
||||
```
|
||||
|
||||
### 5.2 Use Lazy State Initialization
|
||||
|
||||
```tsx
|
||||
// BAD: runs on every render
|
||||
const [settings] = useState(JSON.parse(localStorage.getItem('settings') || '{}'))
|
||||
|
||||
// GOOD: runs only once
|
||||
const [settings] = useState(() => {
|
||||
const stored = localStorage.getItem('settings')
|
||||
return stored ? JSON.parse(stored) : {}
|
||||
})
|
||||
```
|
||||
|
||||
### 5.3 Use Transitions for Non-Urgent Updates
|
||||
|
||||
```tsx
|
||||
import { startTransition } from 'react'
|
||||
|
||||
function ScrollTracker() {
|
||||
const [scrollY, setScrollY] = useState(0)
|
||||
useEffect(() => {
|
||||
const handler = () => {
|
||||
startTransition(() => setScrollY(window.scrollY))
|
||||
}
|
||||
window.addEventListener('scroll', handler, { passive: true })
|
||||
return () => window.removeEventListener('scroll', handler)
|
||||
}, [])
|
||||
}
|
||||
```
|
||||
|
||||
### 5.4 Narrow Effect Dependencies
|
||||
|
||||
```tsx
|
||||
// BAD: re-runs on any user field change
|
||||
useEffect(() => {
|
||||
console.log(user.id)
|
||||
}, [user])
|
||||
|
||||
// GOOD: re-runs only when id changes
|
||||
useEffect(() => {
|
||||
console.log(user.id)
|
||||
}, [user.id])
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. Rendering Performance
|
||||
|
||||
**Impact: MEDIUM**
|
||||
|
||||
### 6.1 CSS content-visibility for Long Lists
|
||||
|
||||
```css
|
||||
.message-item {
|
||||
content-visibility: auto;
|
||||
contain-intrinsic-size: 0 80px;
|
||||
}
|
||||
```
|
||||
|
||||
### 6.2 Hoist Static JSX Elements
|
||||
|
||||
```tsx
|
||||
// BAD: recreates element every render
|
||||
function Container() {
|
||||
return loading && <div className="animate-pulse h-20 bg-gray-200" />
|
||||
}
|
||||
|
||||
// GOOD: reuses same element
|
||||
const loadingSkeleton = <div className="animate-pulse h-20 bg-gray-200" />
|
||||
function Container() {
|
||||
return loading && loadingSkeleton
|
||||
}
|
||||
```
|
||||
|
||||
### 6.3 Animate SVG Wrapper, Not SVG Element
|
||||
|
||||
```tsx
|
||||
// BAD: no hardware acceleration
|
||||
<svg className="animate-spin">...</svg>
|
||||
|
||||
// GOOD: hardware accelerated
|
||||
<div className="animate-spin">
|
||||
<svg>...</svg>
|
||||
</div>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 7. JavaScript Performance
|
||||
|
||||
**Impact: LOW-MEDIUM**
|
||||
|
||||
### 7.1 Build Index Maps for Repeated Lookups
|
||||
|
||||
```typescript
|
||||
// BAD: O(n) per lookup
|
||||
items.filter(item => allowedIds.includes(item.id))
|
||||
|
||||
// GOOD: O(1) per lookup
|
||||
const allowedSet = new Set(allowedIds)
|
||||
items.filter(item => allowedSet.has(item.id))
|
||||
```
|
||||
|
||||
### 7.2 Use toSorted() Instead of sort()
|
||||
|
||||
```typescript
|
||||
// BAD: mutates original array
|
||||
const sorted = users.sort((a, b) => a.name.localeCompare(b.name))
|
||||
|
||||
// GOOD: creates new array
|
||||
const sorted = users.toSorted((a, b) => a.name.localeCompare(b.name))
|
||||
```
|
||||
|
||||
### 7.3 Early Return from Functions
|
||||
|
||||
```typescript
|
||||
// BAD: processes all items after finding error
|
||||
function validateUsers(users: User[]) {
|
||||
let hasError = false
|
||||
for (const user of users) {
|
||||
if (!user.email) hasError = true
|
||||
}
|
||||
return hasError ? { valid: false } : { valid: true }
|
||||
}
|
||||
|
||||
// GOOD: returns immediately on first error
|
||||
function validateUsers(users: User[]) {
|
||||
for (const user of users) {
|
||||
if (!user.email) return { valid: false, error: 'Email required' }
|
||||
}
|
||||
return { valid: true }
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 8. Advanced Patterns
|
||||
|
||||
**Impact: LOW**
|
||||
|
||||
### 8.1 useEffectEvent for Stable Callbacks
|
||||
|
||||
```tsx
|
||||
import { useEffectEvent } from 'react'
|
||||
|
||||
function useWindowEvent(event: string, handler: () => void) {
|
||||
const onEvent = useEffectEvent(handler)
|
||||
useEffect(() => {
|
||||
window.addEventListener(event, onEvent)
|
||||
return () => window.removeEventListener(event, onEvent)
|
||||
}, [event])
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Checklist Before Implementation
|
||||
|
||||
- [ ] Independent async operations use Promise.all()
|
||||
- [ ] Heavy components use dynamic imports
|
||||
- [ ] RSC boundaries pass only needed fields
|
||||
- [ ] Suspense boundaries isolate data fetching
|
||||
- [ ] No barrel file imports for large libraries
|
||||
- [ ] State updates use functional form when depending on current state
|
||||
- [ ] Effects have narrow dependencies
|
||||
- [ ] Repeated lookups use Set/Map
|
||||
|
||||
---
|
||||
|
||||
## References
|
||||
|
||||
- [React Documentation](https://react.dev)
|
||||
- [Next.js Documentation](https://nextjs.org)
|
||||
- [SWR Documentation](https://swr.vercel.app)
|
||||
- [Vercel Blog: Package Import Optimization](https://vercel.com/blog/how-we-optimized-package-imports-in-next-js)
|
||||
- [Vercel Blog: Dashboard Performance](https://vercel.com/blog/how-we-made-the-vercel-dashboard-twice-as-fast)
|
||||
|
|
@ -0,0 +1,127 @@
|
|||
---
|
||||
name: subagents-discipline
|
||||
description: Core engineering principles for implementation tasks
|
||||
---
|
||||
|
||||
# Implementation Principles
|
||||
|
||||
## Rule 0: Read the Bead First
|
||||
|
||||
Before implementing anything, **read the bead comments** for context:
|
||||
|
||||
```bash
|
||||
bd show {BEAD_ID}
|
||||
bd comments {BEAD_ID}
|
||||
```
|
||||
|
||||
The orchestrator's dispatch prompt is automatically logged as a DISPATCH comment on the bead. This contains:
|
||||
- The investigation findings
|
||||
- Root cause analysis (file, function, line)
|
||||
- Related files that may need changes
|
||||
- Gotchas and edge cases
|
||||
|
||||
**Use this context.** Don't re-investigate. The comments contain everything you need to implement confidently.
|
||||
|
||||
If no dispatch or context comments exist, ask the orchestrator to provide context before proceeding.
|
||||
|
||||
---
|
||||
|
||||
## Rule 1: Look Before You Code
|
||||
|
||||
Before writing code that touches external data (API, database, file, config):
|
||||
|
||||
1. **Fetch/read the ACTUAL data** - run the command, see the output
|
||||
2. **Note exact field names, types, formats** - not what docs say, what you SEE
|
||||
3. **Code against what you observed** - not what you assumed
|
||||
|
||||
```
|
||||
WITHOUT looking first:
|
||||
Assumed: column is "reference_images"
|
||||
Reality: column is "reference_image_url"
|
||||
Result: Query fails
|
||||
|
||||
WITH looking first:
|
||||
Ran: SELECT column_name FROM information_schema.columns WHERE table_name = 'assets';
|
||||
Saw: reference_image_url
|
||||
Coded against: reference_image_url
|
||||
Result: Works
|
||||
```
|
||||
|
||||
## Rule 2: Test Functionally (Close the Loop)
|
||||
|
||||
**Principle: Optimize for the fastest way to verify your work actually works.**
|
||||
|
||||
| You built | Fast verification | Slower alternative |
|
||||
|-----------|------------------|--------------------|
|
||||
| API endpoint | `curl` the endpoint, check response | Write integration test |
|
||||
| Database change | Run migration, query the result | Write migration test |
|
||||
| Frontend component | Load in browser, interact with it | Write component test |
|
||||
| CLI tool | Run the command, check output | Write unit test |
|
||||
| Config change | Restart service, verify behavior | N/A — just verify |
|
||||
|
||||
**Two strategies:**
|
||||
|
||||
1. **User Journey Tests** — Test actual behavior as a user experiences it:
|
||||
```bash
|
||||
# API: curl with real data
|
||||
curl -X POST localhost:3000/api/users -d '{"name":"test"}' -H "Content-Type: application/json"
|
||||
|
||||
# CLI: run the command
|
||||
bd create "Test" -d "Testing" && bd list
|
||||
|
||||
# Error case: curl with invalid auth
|
||||
curl -X POST localhost:3000/api/users -H "Authorization: Bearer invalid"
|
||||
```
|
||||
|
||||
2. **Component Tests** — Supplement for regression prevention when fast verification isn't possible:
|
||||
- Complex logic with many edge cases
|
||||
- Code that runs in environments you can't easily replicate
|
||||
- Shared libraries used by multiple consumers
|
||||
|
||||
**"Close the Loop" principle:** Run the actual thing. Verify it works. Check error cases.
|
||||
|
||||
Good: "Curled endpoint with invalid auth, got 401 as expected"
|
||||
Bad: "Wrote tests, they compile"
|
||||
|
||||
## Rule 3: Use Your Tools
|
||||
|
||||
Before claiming you can't fully test:
|
||||
|
||||
1. **Check what MCP servers you have access to** - list available tools
|
||||
2. **If any tool can help verify the feature works**, use it
|
||||
3. **Be resourceful** - browser automation, database inspection, API testing tools
|
||||
|
||||
## Rule 4: Log Your Approach (Optional)
|
||||
|
||||
If you deviated from the orchestrator's suggestion, found a better path, or made a choice future maintainers might question:
|
||||
|
||||
```bash
|
||||
bd comment {BEAD_ID} "APPROACH: Used X instead of Y because Z"
|
||||
```
|
||||
|
||||
When to log:
|
||||
- Deviated from the suggested fix
|
||||
- Multiple valid solutions, chose one for a specific reason
|
||||
- Future maintainers might question the approach
|
||||
|
||||
Skip if the code is self-explanatory. This is not enforced.
|
||||
|
||||
---
|
||||
|
||||
## For Epic Children
|
||||
|
||||
If your BEAD_ID contains a dot (e.g., BD-001.2), you're implementing part of a larger feature:
|
||||
|
||||
1. **Check for design doc**: `bd show {EPIC_ID} --json | jq -r '.[0].design'`
|
||||
2. **Read it if it exists** - this is your contract
|
||||
3. **Match it exactly** - same field names, same types, same shapes
|
||||
|
||||
---
|
||||
|
||||
## Red Flags - Stop and Verify
|
||||
|
||||
When you catch yourself thinking:
|
||||
- "This should work..." → run it and see
|
||||
- "I assume the field is..." → look at the actual data
|
||||
- "I'll test it later..." → test it now
|
||||
- "It's too simple to break..." → verify anyway
|
||||
|
|
@ -0,0 +1,76 @@
|
|||
# UI Constraints
|
||||
|
||||
Apply these opinionated constraints when building interfaces.
|
||||
|
||||
## Stack
|
||||
|
||||
- MUST use Tailwind CSS defaults unless custom values already exist or are explicitly requested
|
||||
- MUST use `motion/react` (formerly `framer-motion`) when JavaScript animation is required
|
||||
- SHOULD use `tw-animate-css` for entrance and micro-animations in Tailwind CSS
|
||||
- MUST use `cn` utility (`clsx` + `tailwind-merge`) for class logic
|
||||
|
||||
## Components
|
||||
|
||||
- MUST use accessible component primitives for anything with keyboard or focus behavior (`Base UI`, `React Aria`, `Radix`)
|
||||
- MUST use the project's existing component primitives first
|
||||
- NEVER mix primitive systems within the same interaction surface
|
||||
- SHOULD prefer [`Base UI`](https://base-ui.com/react/components) for new primitives if compatible with the stack
|
||||
- MUST add an `aria-label` to icon-only buttons
|
||||
- NEVER rebuild keyboard or focus behavior by hand unless explicitly requested
|
||||
|
||||
## Interaction
|
||||
|
||||
- MUST use an `AlertDialog` for destructive or irreversible actions
|
||||
- SHOULD use structural skeletons for loading states
|
||||
- NEVER use `h-screen`, use `h-dvh`
|
||||
- MUST respect `safe-area-inset` for fixed elements
|
||||
- MUST show errors next to where the action happens
|
||||
- NEVER block paste in `input` or `textarea` elements
|
||||
|
||||
## Animation
|
||||
|
||||
- NEVER add animation unless it is explicitly requested
|
||||
- MUST animate only compositor props (`transform`, `opacity`)
|
||||
- NEVER animate layout properties (`width`, `height`, `top`, `left`, `margin`, `padding`)
|
||||
- SHOULD avoid animating paint properties (`background`, `color`) except for small, local UI (text, icons)
|
||||
- SHOULD use `ease-out` on entrance
|
||||
- NEVER exceed `200ms` for interaction feedback
|
||||
- MUST pause looping animations when off-screen
|
||||
- SHOULD respect `prefers-reduced-motion`
|
||||
- NEVER introduce custom easing curves unless explicitly requested
|
||||
- SHOULD avoid animating large images or full-screen surfaces
|
||||
|
||||
## Typography
|
||||
|
||||
- MUST use `text-balance` for headings and `text-pretty` for body/paragraphs
|
||||
- MUST use `tabular-nums` for data
|
||||
- SHOULD use `truncate` or `line-clamp` for dense UI
|
||||
- NEVER modify `letter-spacing` (`tracking-*`) unless explicitly requested
|
||||
|
||||
## Layout
|
||||
|
||||
- MUST use a fixed `z-index` scale (no arbitrary `z-*`)
|
||||
- SHOULD use `size-*` for square elements instead of `w-*` + `h-*`
|
||||
|
||||
## Performance
|
||||
|
||||
- NEVER animate large `blur()` or `backdrop-filter` surfaces
|
||||
- NEVER apply `will-change` outside an active animation
|
||||
- NEVER use `useEffect` for anything that can be expressed as render logic
|
||||
|
||||
## Design
|
||||
|
||||
- NEVER use gradients unless explicitly requested
|
||||
- NEVER use purple or multicolor gradients
|
||||
- NEVER use glow effects as primary affordances
|
||||
- SHOULD use Tailwind CSS default shadow scale unless explicitly requested
|
||||
- MUST give empty states one clear next action
|
||||
- SHOULD limit accent color usage to one per view
|
||||
- SHOULD use existing theme or Tailwind CSS color tokens before introducing new ones
|
||||
|
||||
## Accessibility
|
||||
|
||||
- MUST meet WCAG AA color contrast (4.5:1 for text, 3:1 for large text/UI)
|
||||
- MUST ensure all interactive elements are keyboard accessible
|
||||
- SHOULD provide visible focus indicators
|
||||
- MUST use semantic HTML elements where appropriate
|
||||
|
|
@ -0,0 +1,192 @@
|
|||
#!/bin/bash
|
||||
# Tests for templates/hooks/validate-epic-close.sh
|
||||
# Focuses on the epic children validation (CHECK 2)
|
||||
# Mocks bd, git, and gh to isolate the hook logic
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
HOOK="$(cd "$(dirname "$0")/.." && pwd)/templates/hooks/validate-epic-close.sh"
|
||||
PASS=0
|
||||
FAIL=0
|
||||
MOCK_DIR=""
|
||||
|
||||
setup_mock_dir() {
|
||||
MOCK_DIR=$(mktemp -d)
|
||||
# Mock git to skip CHECK 1 (return empty for remote URL)
|
||||
cat > "$MOCK_DIR/git" << 'MOCKGIT'
|
||||
#!/bin/bash
|
||||
echo ""
|
||||
MOCKGIT
|
||||
chmod +x "$MOCK_DIR/git"
|
||||
|
||||
# Mock gh (should never be reached, but just in case)
|
||||
cat > "$MOCK_DIR/gh" << 'MOCKGH'
|
||||
#!/bin/bash
|
||||
echo ""
|
||||
MOCKGH
|
||||
chmod +x "$MOCK_DIR/gh"
|
||||
}
|
||||
|
||||
cleanup() {
|
||||
[ -n "$MOCK_DIR" ] && rm -rf "$MOCK_DIR"
|
||||
}
|
||||
trap cleanup EXIT
|
||||
|
||||
run_hook() {
|
||||
local tool_input="$1"
|
||||
CLAUDE_TOOL_INPUT="$tool_input" PATH="$MOCK_DIR:$PATH" bash "$HOOK" 2>/dev/null
|
||||
}
|
||||
|
||||
assert_allowed() {
|
||||
local test_name="$1"
|
||||
local tool_input="$2"
|
||||
local output
|
||||
local exit_code
|
||||
|
||||
output=$(run_hook "$tool_input") && exit_code=0 || exit_code=$?
|
||||
|
||||
if [ "$exit_code" -eq 0 ] && ! echo "$output" | grep -q '"deny"'; then
|
||||
echo "PASS: $test_name"
|
||||
PASS=$((PASS + 1))
|
||||
else
|
||||
echo "FAIL: $test_name (expected: allowed, got exit=$exit_code, output=$output)"
|
||||
FAIL=$((FAIL + 1))
|
||||
fi
|
||||
}
|
||||
|
||||
assert_denied() {
|
||||
local test_name="$1"
|
||||
local tool_input="$2"
|
||||
local expected_fragment="${3:-}"
|
||||
local output
|
||||
local exit_code
|
||||
|
||||
output=$(run_hook "$tool_input") && exit_code=0 || exit_code=$?
|
||||
|
||||
if echo "$output" | grep -q '"deny"'; then
|
||||
if [ -n "$expected_fragment" ] && ! echo "$output" | grep -q "$expected_fragment"; then
|
||||
echo "FAIL: $test_name (denied but missing expected text: $expected_fragment)"
|
||||
FAIL=$((FAIL + 1))
|
||||
else
|
||||
echo "PASS: $test_name"
|
||||
PASS=$((PASS + 1))
|
||||
fi
|
||||
else
|
||||
echo "FAIL: $test_name (expected: denied, got exit=$exit_code, output=$output)"
|
||||
FAIL=$((FAIL + 1))
|
||||
fi
|
||||
}
|
||||
|
||||
# ---- Test 1: Non-bd-close command ----
|
||||
test_non_bd_close() {
|
||||
setup_mock_dir
|
||||
assert_allowed "Non-bd-close command is allowed" '{"command":"echo hello"}'
|
||||
}
|
||||
|
||||
# ---- Test 2: bd close with --force ----
|
||||
test_force_override() {
|
||||
setup_mock_dir
|
||||
# bd mock not needed — hook exits before calling bd
|
||||
assert_allowed "bd close --force is allowed" '{"command":"bd close BD-001 --force"}'
|
||||
}
|
||||
|
||||
# ---- Test 3: Standalone bead (issue_type=task) ----
|
||||
test_standalone_task() {
|
||||
setup_mock_dir
|
||||
cat > "$MOCK_DIR/bd" << 'MOCKBD'
|
||||
#!/bin/bash
|
||||
if [ "$1" = "show" ] && [ "$3" = "--json" ]; then
|
||||
echo '[{"id":"BD-001","issue_type":"task","status":"in_progress"}]'
|
||||
elif [ "$1" = "list" ] && [ "$2" = "--json" ]; then
|
||||
echo '[{"id":"BD-001","issue_type":"task","status":"in_progress"}]'
|
||||
fi
|
||||
MOCKBD
|
||||
chmod +x "$MOCK_DIR/bd"
|
||||
|
||||
assert_allowed "Standalone task is allowed to close" '{"command":"bd close BD-001"}'
|
||||
}
|
||||
|
||||
# ---- Test 4: Epic with all children done ----
|
||||
test_epic_all_done() {
|
||||
setup_mock_dir
|
||||
cat > "$MOCK_DIR/bd" << 'MOCKBD'
|
||||
#!/bin/bash
|
||||
if [ "$1" = "show" ] && [ "$3" = "--json" ]; then
|
||||
echo '[{"id":"BD-010","issue_type":"epic","status":"in_progress"}]'
|
||||
elif [ "$1" = "list" ] && [ "$2" = "--json" ]; then
|
||||
echo '[
|
||||
{"id":"BD-010","issue_type":"epic","status":"in_progress"},
|
||||
{"id":"BD-010.1","issue_type":"task","status":"done"},
|
||||
{"id":"BD-010.2","issue_type":"task","status":"done"},
|
||||
{"id":"BD-010.3","issue_type":"task","status":"closed"}
|
||||
]'
|
||||
fi
|
||||
MOCKBD
|
||||
chmod +x "$MOCK_DIR/bd"
|
||||
|
||||
assert_allowed "Epic with all children done/closed is allowed" '{"command":"bd close BD-010"}'
|
||||
}
|
||||
|
||||
# ---- Test 5: Epic with children in inreview ----
|
||||
test_epic_children_inreview() {
|
||||
setup_mock_dir
|
||||
cat > "$MOCK_DIR/bd" << 'MOCKBD'
|
||||
#!/bin/bash
|
||||
if [ "$1" = "show" ] && [ "$3" = "--json" ]; then
|
||||
echo '[{"id":"BD-020","issue_type":"epic","status":"in_progress"}]'
|
||||
elif [ "$1" = "list" ] && [ "$2" = "--json" ]; then
|
||||
echo '[
|
||||
{"id":"BD-020","issue_type":"epic","status":"in_progress"},
|
||||
{"id":"BD-020.1","issue_type":"task","status":"done"},
|
||||
{"id":"BD-020.2","issue_type":"task","status":"inreview"},
|
||||
{"id":"BD-020.3","issue_type":"task","status":"inreview"}
|
||||
]'
|
||||
fi
|
||||
MOCKBD
|
||||
chmod +x "$MOCK_DIR/bd"
|
||||
|
||||
assert_denied "Epic with inreview children is denied" \
|
||||
'{"command":"bd close BD-020"}' \
|
||||
"incomplete children"
|
||||
}
|
||||
|
||||
# ---- Test 6: Epic with mixed statuses ----
|
||||
test_epic_mixed_statuses() {
|
||||
setup_mock_dir
|
||||
cat > "$MOCK_DIR/bd" << 'MOCKBD'
|
||||
#!/bin/bash
|
||||
if [ "$1" = "show" ] && [ "$3" = "--json" ]; then
|
||||
echo '[{"id":"BD-030","issue_type":"epic","status":"in_progress"}]'
|
||||
elif [ "$1" = "list" ] && [ "$2" = "--json" ]; then
|
||||
echo '[
|
||||
{"id":"BD-030","issue_type":"epic","status":"in_progress"},
|
||||
{"id":"BD-030.1","issue_type":"task","status":"done"},
|
||||
{"id":"BD-030.2","issue_type":"task","status":"inreview"},
|
||||
{"id":"BD-030.3","issue_type":"task","status":"in_progress"}
|
||||
]'
|
||||
fi
|
||||
MOCKBD
|
||||
chmod +x "$MOCK_DIR/bd"
|
||||
|
||||
assert_denied "Epic with mixed statuses is denied" \
|
||||
'{"command":"bd close BD-030"}' \
|
||||
"incomplete children"
|
||||
}
|
||||
|
||||
# ---- Run all tests ----
|
||||
echo "=== validate-epic-close.sh tests ==="
|
||||
echo ""
|
||||
|
||||
test_non_bd_close
|
||||
test_force_override
|
||||
test_standalone_task
|
||||
test_epic_all_done
|
||||
test_epic_children_inreview
|
||||
test_epic_mixed_statuses
|
||||
|
||||
echo ""
|
||||
echo "=== Results: $PASS passed, $FAIL failed ==="
|
||||
|
||||
if [ "$FAIL" -gt 0 ]; then
|
||||
exit 1
|
||||
fi
|
||||
180
.agents/skills/dispatching-parallel-agents/SKILL.md
Normal file
180
.agents/skills/dispatching-parallel-agents/SKILL.md
Normal file
|
|
@ -0,0 +1,180 @@
|
|||
---
|
||||
name: dispatching-parallel-agents
|
||||
description: Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies
|
||||
---
|
||||
|
||||
# Dispatching Parallel Agents
|
||||
|
||||
## Overview
|
||||
|
||||
When you have multiple unrelated failures (different test files, different subsystems, different bugs), investigating them sequentially wastes time. Each investigation is independent and can happen in parallel.
|
||||
|
||||
**Core principle:** Dispatch one agent per independent problem domain. Let them work concurrently.
|
||||
|
||||
## When to Use
|
||||
|
||||
```dot
|
||||
digraph when_to_use {
|
||||
"Multiple failures?" [shape=diamond];
|
||||
"Are they independent?" [shape=diamond];
|
||||
"Single agent investigates all" [shape=box];
|
||||
"One agent per problem domain" [shape=box];
|
||||
"Can they work in parallel?" [shape=diamond];
|
||||
"Sequential agents" [shape=box];
|
||||
"Parallel dispatch" [shape=box];
|
||||
|
||||
"Multiple failures?" -> "Are they independent?" [label="yes"];
|
||||
"Are they independent?" -> "Single agent investigates all" [label="no - related"];
|
||||
"Are they independent?" -> "Can they work in parallel?" [label="yes"];
|
||||
"Can they work in parallel?" -> "Parallel dispatch" [label="yes"];
|
||||
"Can they work in parallel?" -> "Sequential agents" [label="no - shared state"];
|
||||
}
|
||||
```
|
||||
|
||||
**Use when:**
|
||||
- 3+ test files failing with different root causes
|
||||
- Multiple subsystems broken independently
|
||||
- Each problem can be understood without context from others
|
||||
- No shared state between investigations
|
||||
|
||||
**Don't use when:**
|
||||
- Failures are related (fix one might fix others)
|
||||
- Need to understand full system state
|
||||
- Agents would interfere with each other
|
||||
|
||||
## The Pattern
|
||||
|
||||
### 1. Identify Independent Domains
|
||||
|
||||
Group failures by what's broken:
|
||||
- File A tests: Tool approval flow
|
||||
- File B tests: Batch completion behavior
|
||||
- File C tests: Abort functionality
|
||||
|
||||
Each domain is independent - fixing tool approval doesn't affect abort tests.
|
||||
|
||||
### 2. Create Focused Agent Tasks
|
||||
|
||||
Each agent gets:
|
||||
- **Specific scope:** One test file or subsystem
|
||||
- **Clear goal:** Make these tests pass
|
||||
- **Constraints:** Don't change other code
|
||||
- **Expected output:** Summary of what you found and fixed
|
||||
|
||||
### 3. Dispatch in Parallel
|
||||
|
||||
```typescript
|
||||
// In Claude Code / AI environment
|
||||
Task("Fix agent-tool-abort.test.ts failures")
|
||||
Task("Fix batch-completion-behavior.test.ts failures")
|
||||
Task("Fix tool-approval-race-conditions.test.ts failures")
|
||||
// All three run concurrently
|
||||
```
|
||||
|
||||
### 4. Review and Integrate
|
||||
|
||||
When agents return:
|
||||
- Read each summary
|
||||
- Verify fixes don't conflict
|
||||
- Run full test suite
|
||||
- Integrate all changes
|
||||
|
||||
## Agent Prompt Structure
|
||||
|
||||
Good agent prompts are:
|
||||
1. **Focused** - One clear problem domain
|
||||
2. **Self-contained** - All context needed to understand the problem
|
||||
3. **Specific about output** - What should the agent return?
|
||||
|
||||
```markdown
|
||||
Fix the 3 failing tests in src/agents/agent-tool-abort.test.ts:
|
||||
|
||||
1. "should abort tool with partial output capture" - expects 'interrupted at' in message
|
||||
2. "should handle mixed completed and aborted tools" - fast tool aborted instead of completed
|
||||
3. "should properly track pendingToolCount" - expects 3 results but gets 0
|
||||
|
||||
These are timing/race condition issues. Your task:
|
||||
|
||||
1. Read the test file and understand what each test verifies
|
||||
2. Identify root cause - timing issues or actual bugs?
|
||||
3. Fix by:
|
||||
- Replacing arbitrary timeouts with event-based waiting
|
||||
- Fixing bugs in abort implementation if found
|
||||
- Adjusting test expectations if testing changed behavior
|
||||
|
||||
Do NOT just increase timeouts - find the real issue.
|
||||
|
||||
Return: Summary of what you found and what you fixed.
|
||||
```
|
||||
|
||||
## Common Mistakes
|
||||
|
||||
**❌ Too broad:** "Fix all the tests" - agent gets lost
|
||||
**✅ Specific:** "Fix agent-tool-abort.test.ts" - focused scope
|
||||
|
||||
**❌ No context:** "Fix the race condition" - agent doesn't know where
|
||||
**✅ Context:** Paste the error messages and test names
|
||||
|
||||
**❌ No constraints:** Agent might refactor everything
|
||||
**✅ Constraints:** "Do NOT change production code" or "Fix tests only"
|
||||
|
||||
**❌ Vague output:** "Fix it" - you don't know what changed
|
||||
**✅ Specific:** "Return summary of root cause and changes"
|
||||
|
||||
## When NOT to Use
|
||||
|
||||
**Related failures:** Fixing one might fix others - investigate together first
|
||||
**Need full context:** Understanding requires seeing entire system
|
||||
**Exploratory debugging:** You don't know what's broken yet
|
||||
**Shared state:** Agents would interfere (editing same files, using same resources)
|
||||
|
||||
## Real Example from Session
|
||||
|
||||
**Scenario:** 6 test failures across 3 files after major refactoring
|
||||
|
||||
**Failures:**
|
||||
- agent-tool-abort.test.ts: 3 failures (timing issues)
|
||||
- batch-completion-behavior.test.ts: 2 failures (tools not executing)
|
||||
- tool-approval-race-conditions.test.ts: 1 failure (execution count = 0)
|
||||
|
||||
**Decision:** Independent domains - abort logic separate from batch completion separate from race conditions
|
||||
|
||||
**Dispatch:**
|
||||
```
|
||||
Agent 1 → Fix agent-tool-abort.test.ts
|
||||
Agent 2 → Fix batch-completion-behavior.test.ts
|
||||
Agent 3 → Fix tool-approval-race-conditions.test.ts
|
||||
```
|
||||
|
||||
**Results:**
|
||||
- Agent 1: Replaced timeouts with event-based waiting
|
||||
- Agent 2: Fixed event structure bug (threadId in wrong place)
|
||||
- Agent 3: Added wait for async tool execution to complete
|
||||
|
||||
**Integration:** All fixes independent, no conflicts, full suite green
|
||||
|
||||
**Time saved:** 3 problems solved in parallel vs sequentially
|
||||
|
||||
## Key Benefits
|
||||
|
||||
1. **Parallelization** - Multiple investigations happen simultaneously
|
||||
2. **Focus** - Each agent has narrow scope, less context to track
|
||||
3. **Independence** - Agents don't interfere with each other
|
||||
4. **Speed** - 3 problems solved in time of 1
|
||||
|
||||
## Verification
|
||||
|
||||
After agents return:
|
||||
1. **Review each summary** - Understand what changed
|
||||
2. **Check for conflicts** - Did agents edit same code?
|
||||
3. **Run full suite** - Verify all fixes work together
|
||||
4. **Spot check** - Agents can make systematic errors
|
||||
|
||||
## Real-World Impact
|
||||
|
||||
From debugging session (2025-10-03):
|
||||
- 6 failures across 3 files
|
||||
- 3 agents dispatched in parallel
|
||||
- All investigations completed concurrently
|
||||
- All fixes integrated successfully
|
||||
- Zero conflicts between agent changes
|
||||
452
.agents/skills/entry-signals/.pattern_history.json
Normal file
452
.agents/skills/entry-signals/.pattern_history.json
Normal file
|
|
@ -0,0 +1,452 @@
|
|||
{
|
||||
"a7a65824ae5c": {
|
||||
"pattern_id": "a7a65824ae5c",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "Multi-timeframe bullish alignment (15m, 1h, 4h) as entry signal produces losses in flat markets - signal is designed for trending conditions",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.18146258503401358,
|
||||
"sample_size": 294,
|
||||
"confidence": 0.74,
|
||||
"first_seen": "2026-01-13T11:23:59.258068",
|
||||
"last_confirmed": "2026-01-13T17:50:18.247809",
|
||||
"times_seen": 2,
|
||||
"is_active": true
|
||||
},
|
||||
"6b723bed1691": {
|
||||
"pattern_id": "6b723bed1691",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "Positive funding rate interpreted as bullish momentum is a losing signal - actually indicates crowded longs vulnerable to liquidation",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.3,
|
||||
"sample_size": 208,
|
||||
"confidence": 0.6,
|
||||
"first_seen": "2026-01-13T11:23:59.258068",
|
||||
"last_confirmed": "2026-01-13T11:23:59.258068",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
},
|
||||
"fcdc3d83a3de": {
|
||||
"pattern_id": "fcdc3d83a3de",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "Relative strength divergence (one asset up while others down) as entry signal shows mixed results",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.45,
|
||||
"sample_size": 79,
|
||||
"confidence": 0.6,
|
||||
"first_seen": "2026-01-13T11:23:59.258068",
|
||||
"last_confirmed": "2026-01-13T11:23:59.258068",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
},
|
||||
"262a71a21cba": {
|
||||
"pattern_id": "262a71a21cba",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "SMA and MACD bearish signals for shorting fail when market is essentially flat (-0.02%)",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.35,
|
||||
"sample_size": 50,
|
||||
"confidence": 0.6,
|
||||
"first_seen": "2026-01-13T11:23:59.258068",
|
||||
"last_confirmed": "2026-01-13T11:23:59.258068",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
},
|
||||
"e27d335aa54f": {
|
||||
"pattern_id": "e27d335aa54f",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "Positive funding rate interpreted as bullish momentum is a losing signal - elevated funding indicates crowded longs vulnerable to liquidation, not strength",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.15,
|
||||
"sample_size": 225,
|
||||
"confidence": 0.7,
|
||||
"first_seen": "2026-01-13T17:50:18.247809",
|
||||
"last_confirmed": "2026-01-13T17:50:18.247809",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
},
|
||||
"4aec9a1fc980": {
|
||||
"pattern_id": "4aec9a1fc980",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "Relative strength divergence (one asset up while others down) as entry signal shows poor results in low-volatility environment",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.2,
|
||||
"sample_size": 72,
|
||||
"confidence": 0.7,
|
||||
"first_seen": "2026-01-13T17:50:18.247809",
|
||||
"last_confirmed": "2026-01-13T17:50:18.247809",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
},
|
||||
"617151567977": {
|
||||
"pattern_id": "617151567977",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "SMA and MACD bearish signals for shorting fail when market is essentially flat (-0.02% BTC) - technical indicators need volatility to be meaningful",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.18,
|
||||
"sample_size": 50,
|
||||
"confidence": 0.7,
|
||||
"first_seen": "2026-01-13T17:50:18.247809",
|
||||
"last_confirmed": "2026-01-13T17:50:18.247809",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
},
|
||||
"0e2bd85d7e70": {
|
||||
"pattern_id": "0e2bd85d7e70",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "Multi-timeframe bullish alignment (15m, 1h, 4h) combined with explicit risk validation produces profits in trending markets. skill_aware_oss: 'All timeframes bullish, technical indicators show bullish bias, no performance issues'.",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.85,
|
||||
"sample_size": 157,
|
||||
"confidence": 0.7499999999999999,
|
||||
"first_seen": "2026-01-14T13:41:05.811368",
|
||||
"last_confirmed": "2026-01-14T13:41:05.811368",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
},
|
||||
"aa22af21d3b5": {
|
||||
"pattern_id": "aa22af21d3b5",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "High funding rate alone as bullish signal remains unreliable. llama4_scout repeatedly cited 'high funding rate indicating bullish momentum' but lost money.",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.35,
|
||||
"sample_size": 248,
|
||||
"confidence": 0.7499999999999999,
|
||||
"first_seen": "2026-01-14T13:41:05.811368",
|
||||
"last_confirmed": "2026-01-14T13:41:05.811368",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
},
|
||||
"353e6b3db59e": {
|
||||
"pattern_id": "353e6b3db59e",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "Scaling into existing winning positions ('scaling into existing long positions') during confirmed trends captures additional alpha.",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.8,
|
||||
"sample_size": 157,
|
||||
"confidence": 0.7499999999999999,
|
||||
"first_seen": "2026-01-14T13:41:05.811368",
|
||||
"last_confirmed": "2026-01-14T13:41:05.811368",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
},
|
||||
"714f9ec4bcaa": {
|
||||
"pattern_id": "714f9ec4bcaa",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "Multi-timeframe bullish alignment (15m, 1h, 4h) WITH explicit risk validation produces profitable entries. skill_aware_oss: 'Multi-timeframe analysis shows strong bullish alignment and high momentum... validation passes'. Success requires both trend confirmation AND risk checks.",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.85,
|
||||
"sample_size": 164,
|
||||
"confidence": 0.7999999999999999,
|
||||
"first_seen": "2026-01-14T16:35:29.363431",
|
||||
"last_confirmed": "2026-01-14T16:35:29.363431",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
},
|
||||
"60b9a483be87": {
|
||||
"pattern_id": "60b9a483be87",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "SMA crossover + bullish MACD + neutral Bollinger as entry confirmation. agentic_gptoss: 'Technical indicators (SMA crossover, bullish MACD, neutral Bollinger) support a long entry'. Combined with risk calculator validation.",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.82,
|
||||
"sample_size": 184,
|
||||
"confidence": 0.7999999999999999,
|
||||
"first_seen": "2026-01-14T16:35:29.363431",
|
||||
"last_confirmed": "2026-01-14T16:35:29.363431",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
},
|
||||
"391c0cae07e8": {
|
||||
"pattern_id": "391c0cae07e8",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "High funding rate alone as bullish signal is UNRELIABLE. llama4_scout repeatedly uses 'high funding rate, indicating potential for further growth' but loses money. Funding rate indicates crowding, not momentum.",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.35,
|
||||
"sample_size": 248,
|
||||
"confidence": 0.7999999999999999,
|
||||
"first_seen": "2026-01-14T16:35:29.363431",
|
||||
"last_confirmed": "2026-01-14T16:35:29.363431",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
},
|
||||
"4018e6a96e2b": {
|
||||
"pattern_id": "4018e6a96e2b",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "Scaling into existing winning positions during confirmed uptrends. skill_aware_oss references 'scaled-up' positions when 'overall bias remains bullish' despite short-term overbought conditions.",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.78,
|
||||
"sample_size": 164,
|
||||
"confidence": 0.7999999999999999,
|
||||
"first_seen": "2026-01-14T16:35:29.363431",
|
||||
"last_confirmed": "2026-01-14T16:35:29.363431",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
},
|
||||
"87a1247f05d4": {
|
||||
"pattern_id": "87a1247f05d4",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "Multi-timeframe bullish alignment (15m, 1h, 4h) WITH explicit risk validation and trade validation passed - produces strong returns in trending markets",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.85,
|
||||
"sample_size": 164,
|
||||
"confidence": 0.8499999999999999,
|
||||
"first_seen": "2026-01-14T16:48:38.215945",
|
||||
"last_confirmed": "2026-01-14T16:48:38.215945",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
},
|
||||
"e94fa78e5942": {
|
||||
"pattern_id": "e94fa78e5942",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "SMA crossover + bullish MACD + neutral Bollinger bands as entry confirmation with trend alignment - agentic_gptoss used this for +$697.86",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.82,
|
||||
"sample_size": 184,
|
||||
"confidence": 0.8499999999999999,
|
||||
"first_seen": "2026-01-14T16:48:38.215945",
|
||||
"last_confirmed": "2026-01-14T16:48:38.215945",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
},
|
||||
"375675fb87eb": {
|
||||
"pattern_id": "375675fb87eb",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "High funding rate alone as bullish signal is UNRELIABLE - llama4_scout repeatedly used this and lost money in a bull market",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.35,
|
||||
"sample_size": 247,
|
||||
"confidence": 0.8499999999999999,
|
||||
"first_seen": "2026-01-14T16:48:38.215945",
|
||||
"last_confirmed": "2026-01-14T16:48:38.215945",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
},
|
||||
"2851e46d6e74": {
|
||||
"pattern_id": "2851e46d6e74",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "Multi-timeframe bullish alignment (15m, 1h, 4h) WITH explicit risk validation and trade validation checks - skill_aware_oss uses this consistently with strong results (+$1236.81)",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.88,
|
||||
"sample_size": 164,
|
||||
"confidence": 0.8499999999999999,
|
||||
"first_seen": "2026-01-14T16:49:32.288170",
|
||||
"last_confirmed": "2026-01-14T16:49:32.288170",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
},
|
||||
"b26b0a203852": {
|
||||
"pattern_id": "b26b0a203852",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "SMA crossover + bullish MACD + neutral Bollinger bands as entry confirmation with validation checks - agentic_gptoss reasoning shows this pattern with +$697.86",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.82,
|
||||
"sample_size": 184,
|
||||
"confidence": 0.8499999999999999,
|
||||
"first_seen": "2026-01-14T16:49:32.288170",
|
||||
"last_confirmed": "2026-01-14T16:49:32.288170",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
},
|
||||
"3973a0e3580c": {
|
||||
"pattern_id": "3973a0e3580c",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "High funding rate alone as bullish signal is UNRELIABLE - llama4_scout repeatedly used 'high funding rate indicating bullish sentiment' but lost -$18.95 despite correct market direction",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.35,
|
||||
"sample_size": 247,
|
||||
"confidence": 0.8499999999999999,
|
||||
"first_seen": "2026-01-14T16:49:32.288170",
|
||||
"last_confirmed": "2026-01-14T16:49:32.288170",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
},
|
||||
"9ab965269a03": {
|
||||
"pattern_id": "9ab965269a03",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "Multi-timeframe bullish alignment (15m, 1h, 4h) as long entry signal FAILS in bearish markets. skill_only_oss used this for ETHUSDT longs while ETH declined -1.29%.",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.25,
|
||||
"sample_size": 88,
|
||||
"confidence": 0.95,
|
||||
"first_seen": "2026-01-16T15:51:30.868993",
|
||||
"last_confirmed": "2026-01-16T15:51:30.868993",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
},
|
||||
"7bc35a56c778": {
|
||||
"pattern_id": "7bc35a56c778",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "Positive momentum on small timeframe (+0.33% to +0.44%) as long entry signal is UNRELIABLE. llama4_scout repeatedly cited 'positive momentum' for ETHUSDT longs, lost $151.",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.2,
|
||||
"sample_size": 76,
|
||||
"confidence": 0.95,
|
||||
"first_seen": "2026-01-16T15:51:30.868993",
|
||||
"last_confirmed": "2026-01-16T15:51:30.868993",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
},
|
||||
"cc116c3b4307": {
|
||||
"pattern_id": "cc116c3b4307",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "Multi-timeframe bearish alignment for short entry. skill_aware_oss: 'multi-timeframe analysis shows strong bearish alignment' for SOLUSDT short - directionally correct as SOL fell -1.15%.",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.65,
|
||||
"sample_size": 103,
|
||||
"confidence": 0.95,
|
||||
"first_seen": "2026-01-16T15:51:30.868993",
|
||||
"last_confirmed": "2026-01-16T15:51:30.868993",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
},
|
||||
"3d42415ca106": {
|
||||
"pattern_id": "3d42415ca106",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "Multi-timeframe bullish alignment (15m, 1h, 4h) as long entry signal FAILS in mixed/choppy markets. skill_only_oss repeatedly entered longs on ETH with 0.85-0.9 confidence citing bullish alignment, but ETH was -0.03%.",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.3,
|
||||
"sample_size": 160,
|
||||
"confidence": 0.95,
|
||||
"first_seen": "2026-01-17T05:09:21.363096",
|
||||
"last_confirmed": "2026-01-17T05:09:21.363096",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
},
|
||||
"f7ab65b9c505": {
|
||||
"pattern_id": "f7ab65b9c505",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "Multi-timeframe bearish alignment for short entry FAILS in mixed markets. agentic_gptoss: 'All timeframes align on a bearish trend' for DOGE short, skill_aware_oss: 'bearish bias' for SOL short - both lost money.",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.35,
|
||||
"sample_size": 201,
|
||||
"confidence": 0.95,
|
||||
"first_seen": "2026-01-17T05:09:21.363096",
|
||||
"last_confirmed": "2026-01-17T05:09:21.363096",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
},
|
||||
"60c46481c7dc": {
|
||||
"pattern_id": "60c46481c7dc",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "Negative funding rate as long opportunity signal is UNRELIABLE. llama4_scout: 'funding rate is slightly negative which could indicate a potential long opportunity' - resulted in losses.",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.25,
|
||||
"sample_size": 180,
|
||||
"confidence": 0.95,
|
||||
"first_seen": "2026-01-17T05:09:21.363096",
|
||||
"last_confirmed": "2026-01-17T05:09:21.363096",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
},
|
||||
"5a37d7b71509": {
|
||||
"pattern_id": "5a37d7b71509",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "Contrarian 'bounce back' reasoning on downtrending assets is a LOSING signal. llama4_scout: 'shows a clear downtrend but might be due for a bounce back'.",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.2,
|
||||
"sample_size": 180,
|
||||
"confidence": 0.95,
|
||||
"first_seen": "2026-01-17T05:09:21.363096",
|
||||
"last_confirmed": "2026-01-17T05:09:21.363096",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
},
|
||||
"39c0c7e83ecb": {
|
||||
"pattern_id": "39c0c7e83ecb",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "Multi-timeframe bullish alignment (15m, 1h, 4h) as long entry signal WORKS in moderate bull markets. skill_only_oss: 'Current regime likely trending up; active multi-timeframe bullish alignment with 2% equity risk' - only profitable active trader.",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.75,
|
||||
"sample_size": 89,
|
||||
"confidence": 0.95,
|
||||
"first_seen": "2026-01-17T16:36:23.118892",
|
||||
"last_confirmed": "2026-01-17T16:36:23.118892",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
},
|
||||
"253b6514bfcf": {
|
||||
"pattern_id": "253b6514bfcf",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "Multi-timeframe bearish alignment for short entry FAILS in moderate bull markets. skill_aware_oss: 'Technical indicators show bearish bias (RSI overbought, MACD bearish)' led to -$173 loss.",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.25,
|
||||
"sample_size": 173,
|
||||
"confidence": 0.95,
|
||||
"first_seen": "2026-01-17T16:36:23.118892",
|
||||
"last_confirmed": "2026-01-17T16:36:23.118892",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
},
|
||||
"d32d6adeba37": {
|
||||
"pattern_id": "d32d6adeba37",
|
||||
"pattern_type": "entry_signal",
|
||||
"description": "RSI overbought + MACD bearish as short entry signal is UNRELIABLE in moderate bull markets. These signals triggered shorts that lost money as market continued higher.",
|
||||
"conditions": {
|
||||
"type": "entry"
|
||||
},
|
||||
"success_rate": 0.3,
|
||||
"sample_size": 355,
|
||||
"confidence": 0.95,
|
||||
"first_seen": "2026-01-17T16:36:23.118892",
|
||||
"last_confirmed": "2026-01-17T16:36:23.118892",
|
||||
"times_seen": 1,
|
||||
"is_active": true
|
||||
}
|
||||
}
|
||||
9
.agents/skills/entry-signals/.skill_meta.json
Normal file
9
.agents/skills/entry-signals/.skill_meta.json
Normal file
|
|
@ -0,0 +1,9 @@
|
|||
{
|
||||
"name": "entry-signals",
|
||||
"version": "1.0",
|
||||
"last_updated": "2026-01-17T16:36:23.119841",
|
||||
"total_patterns": 30,
|
||||
"active_patterns": 30,
|
||||
"inactive_patterns": 0,
|
||||
"confidence_threshold": 0.6
|
||||
}
|
||||
103
.agents/skills/entry-signals/SKILL.md
Normal file
103
.agents/skills/entry-signals/SKILL.md
Normal file
|
|
@ -0,0 +1,103 @@
|
|||
---
|
||||
name: entry-signals
|
||||
description: Entry signal patterns with historical success rates. Use when deciding whether to open a position.
|
||||
---
|
||||
|
||||
# Entry Signals
|
||||
|
||||
> Last updated: 2026-01-17 16:36 UTC
|
||||
> Active patterns: 30
|
||||
> Total samples: 5095
|
||||
> Confidence threshold: 60%
|
||||
|
||||
## Entry Signals
|
||||
|
||||
These entry signals have been learned from competition data:
|
||||
|
||||
| Signal | Success Rate | Samples | Confidence | Seen |
|
||||
|--------|-------------|---------|------------|------|
|
||||
| Multi-timeframe bullish alignment (... | 88% | 164 | 85% | 1x |
|
||||
| Multi-timeframe bullish alignment (... | 85% | 157 | 75% | 1x |
|
||||
| Multi-timeframe bullish alignment (... | 85% | 164 | 80% | 1x |
|
||||
| Multi-timeframe bullish alignment (... | 85% | 164 | 85% | 1x |
|
||||
| SMA crossover + bullish MACD + neut... | 82% | 184 | 80% | 1x |
|
||||
| SMA crossover + bullish MACD + neut... | 82% | 184 | 85% | 1x |
|
||||
| SMA crossover + bullish MACD + neut... | 82% | 184 | 85% | 1x |
|
||||
| Scaling into existing winning posit... | 80% | 157 | 75% | 1x |
|
||||
| Scaling into existing winning posit... | 78% | 164 | 80% | 1x |
|
||||
| Multi-timeframe bullish alignment (... | 75% | 89 | 95% | 1x |
|
||||
| Multi-timeframe bearish alignment f... | 65% | 103 | 95% | 1x |
|
||||
| Relative strength divergence (one a... | 45% | 79 | 60% | 1x |
|
||||
| SMA and MACD bearish signals for sh... | 35% | 50 | 60% | 1x |
|
||||
| High funding rate alone as bullish ... | 35% | 248 | 75% | 1x |
|
||||
| High funding rate alone as bullish ... | 35% | 248 | 80% | 1x |
|
||||
| High funding rate alone as bullish ... | 35% | 247 | 85% | 1x |
|
||||
| High funding rate alone as bullish ... | 35% | 247 | 85% | 1x |
|
||||
| Multi-timeframe bearish alignment f... | 35% | 201 | 95% | 1x |
|
||||
| Positive funding rate interpreted a... | 30% | 208 | 60% | 1x |
|
||||
| Multi-timeframe bullish alignment (... | 30% | 160 | 95% | 1x |
|
||||
| RSI overbought + MACD bearish as sh... | 30% | 355 | 95% | 1x |
|
||||
| Multi-timeframe bullish alignment (... | 25% | 88 | 95% | 1x |
|
||||
| Negative funding rate as long oppor... | 25% | 180 | 95% | 1x |
|
||||
| Multi-timeframe bearish alignment f... | 25% | 173 | 95% | 1x |
|
||||
| Relative strength divergence (one a... | 20% | 72 | 70% | 1x |
|
||||
| Positive momentum on small timefram... | 20% | 76 | 95% | 1x |
|
||||
| Contrarian 'bounce back' reasoning ... | 20% | 180 | 95% | 1x |
|
||||
| Multi-timeframe bullish alignment (... | 18% | 294 | 74% | 2x |
|
||||
| SMA and MACD bearish signals for sh... | 18% | 50 | 70% | 1x |
|
||||
| Positive funding rate interpreted a... | 15% | 225 | 70% | 1x |
|
||||
|
||||
## Signal Details
|
||||
|
||||
### Multi-timeframe bullish alignment (15m, ...
|
||||
**Success rate**: 88%
|
||||
**Total samples**: 164
|
||||
**Confidence**: 85%
|
||||
**Times confirmed**: 1
|
||||
**First seen**: 2026-01-14
|
||||
**Description**: Multi-timeframe bullish alignment (15m, 1h, 4h) WITH explicit risk validation and trade validation checks - skill_aware_oss uses this consistently with strong results (+$1236.81)
|
||||
|
||||
### Multi-timeframe bullish alignment (15m, ...
|
||||
**Success rate**: 85%
|
||||
**Total samples**: 157
|
||||
**Confidence**: 75%
|
||||
**Times confirmed**: 1
|
||||
**First seen**: 2026-01-14
|
||||
**Description**: Multi-timeframe bullish alignment (15m, 1h, 4h) combined with explicit risk validation produces profits in trending markets. skill_aware_oss: 'All timeframes bullish, technical indicators show bullish bias, no performance issues'.
|
||||
|
||||
### Multi-timeframe bullish alignment (15m, ...
|
||||
**Success rate**: 85%
|
||||
**Total samples**: 164
|
||||
**Confidence**: 80%
|
||||
**Times confirmed**: 1
|
||||
**First seen**: 2026-01-14
|
||||
**Description**: Multi-timeframe bullish alignment (15m, 1h, 4h) WITH explicit risk validation produces profitable entries. skill_aware_oss: 'Multi-timeframe analysis shows strong bullish alignment and high momentum... validation passes'. Success requires both trend confirmation AND risk checks.
|
||||
|
||||
### Multi-timeframe bullish alignment (15m, ...
|
||||
**Success rate**: 85%
|
||||
**Total samples**: 164
|
||||
**Confidence**: 85%
|
||||
**Times confirmed**: 1
|
||||
**First seen**: 2026-01-14
|
||||
**Description**: Multi-timeframe bullish alignment (15m, 1h, 4h) WITH explicit risk validation and trade validation passed - produces strong returns in trending markets
|
||||
|
||||
### SMA crossover + bullish MACD + neutral B...
|
||||
**Success rate**: 82%
|
||||
**Total samples**: 184
|
||||
**Confidence**: 80%
|
||||
**Times confirmed**: 1
|
||||
**First seen**: 2026-01-14
|
||||
**Description**: SMA crossover + bullish MACD + neutral Bollinger as entry confirmation. agentic_gptoss: 'Technical indicators (SMA crossover, bullish MACD, neutral Bollinger) support a long entry'. Combined with risk calculator validation.
|
||||
|
||||
---
|
||||
|
||||
## Confidence Guide
|
||||
|
||||
| Confidence | Interpretation |
|
||||
|------------|----------------|
|
||||
| 90%+ | High confidence - strong historical support |
|
||||
| 70-90% | Moderate confidence - use with other signals |
|
||||
| 60-70% | Low confidence - consider as one input |
|
||||
| <60% | Experimental - needs more data |
|
||||
|
||||
*This skill is automatically generated and updated by the Observer Agent.*
|
||||
Some files were not shown because too many files have changed in this diff Show more
Loading…
Add table
Add a link
Reference in a new issue