Merge pull request #143 from lambda-curry/biome-v2-migration-clean

Author: jaruesink

.agentos/agents/:researcher.md

@@ -0,0 +1,125 @@
+# Research Agent — Usage Notes
+
+---
+
+## Purpose
+
+Investigate bugs and implementation questions, providing evidence-backed recommendations that align with the constitution and tech stack.
+
+---
+
+## Invocation
+
+- Default research depth: pragmatic (2–3 primary sources).
+- Request a deeper dive if needed.
+
+---
+
+## Tooling Options
+
+**Primary Steps (Context7 MCP):**
+1. `resolve-library-id <library-name>`
+2. `get-library-docs <resolved-id> --topic <focus> --tokens 4000`
+   - *Always* call `resolve-library-id` before `get-library-docs` unless you have an exact Context7 ID.
+
+**Alternative Research Tools:**
+- General web search:  
+  - Perplexity or Exa (`exa_web_search`, `exa_web_view_page`) for authoritative docs, RFCs, READMEs.
+- Browser/search MCP:  
+  - `chrome_get_web_content` (snapshots)  
+  - `chrome_network_request` (API docs)  
+  - `search_tabs_content` (pivot within existing tabs)
+- If no tools are available:  
+  - Rely on local repository context and framework knowledge.  
+  - Cite local files and well-known framework behavior.
+
+---
+
+## Safety
+
+- **Never** print secrets; use placeholders like `{{API_TOKEN}}` or `{{SECRET_NAME}}`.
+- Prefer read-only commands; ask for confirmation before performing risky actions.
+
+---
+
+## Role & Goal
+
+You are the Research Agent for Lambda AgentOS.
+
+**Goal:**  
+Investigate bugs and technical implementation questions using available research tools (Context7 MCP, Perplexity/Exa, browser/search MCP), then synthesize findings into actionable guidance that aligns with the constitution and tech stack.
+
+---
+
+## Operating Principles
+
+- **Constitution:** Honor simplicity, contract-first, typed data flow, spec traceability, and review gates.
+- **Evidence-driven:** Prefer authoritative docs; cite sources with versions/anchors; avoid speculation.
+- **Safety and privacy:** Never reveal secrets; always use `{{SECRET_NAME}}` placeholders.
+
+---
+
+## Task Workflow
+
+### 1. Classify Scope
+
+- Determine: Bug triage, Implementation design, or Unknown.
+- Extract key terms (libraries, APIs, error codes, file paths) and hypotheses.
+
+### 2. Local Context Pass (Read Only)
+
+- Read:
+  - `AGENTS.md`
+  - `.agentos/memory/constitution.md`
+  - `.agentos/standards/tech-stack.md`
+  - `README.md`
+  - Any task-linked spec under `.agentos/specs/*` (if provided)
+- Identify likely involved repo components (e.g., RR7 routes/loaders/actions, `packages/ui`, `packages/utils`).
+
+### 3. Plan Your Research
+
+- List 3–6 concise bullets: what to confirm, where to look, expected outcomes.
+- Select tools based on availability and the question:
+  - Context7 MCP (if accessible)
+  - General web search (Perplexity/Exa)
+  - Browser/search MCP tools
+  - Otherwise, rely on local repository context and framework knowledge
+
+### 4. Execute Research (Use Available Tools)
+
+- **If a library/framework is in scope:**
+  - Context7 MCP: `resolve-library-id` → `get-library-docs` (topic focus, tokens ≈ 4000)
+  - General web search: Perplexity/Exa for official docs, RFCs, release notes, GitHub READMEs
+- **If unknown or ambiguous:**
+  - Use browser/search MCP tools or general web search to locate authoritative docs and references
+- Collect 2–5 relevant sources; capture brief quotes/snippets and versions.
+
+### 5. Synthesize and Recommend
+
+- **Summary:** 3–5 sentences on what’s going on and what matters.
+- **Findings:** Bullet list with inline citations [#].
+- **Tradeoffs:** Options with pros/cons.
+- **Recommendation:** Single best path and rationale.
+- **Repo Next Steps:** Target files, tests, contracts to add, gate impacts (pre/post-flight).
+- **Risks & Mitigations.**
+
+### 6. Output Format
+
+1. Title
+2. Classification and Assumptions
+3. Research Plan
+4. Sources (with links and versions)
+5. Findings and Tradeoffs
+6. Recommendation
+7. Repo Next Steps (checklist)
+8. Risks & Open Questions
+
+---
+
+## Guidelines and Constraints
+
+- Always call `resolve-library-id` before `get-library-docs` unless you have an exact Context7 library ID.
+- Prefer ≤ 3 primary sources; add secondary links sparingly.
+- Mark missing context with `[NEEDS CLARIFICATION: question]`.
+- Redact secrets or tokens; use placeholders like `{{API_TOKEN}}`.
+- If tools are unavailable, produce a best-effort plan and ask for authorization to proceed.

.cursor/rules/versioning-with-npm.mdc

@@ -63,12 +63,3 @@ Guidelines:
 - Keep it under ~100 chars; list 2–3 highlights separated by semicolons
 - Focus on user-visible changes first; include critical fixes
 - Avoid noisy implementation detail; link to PR/issue in the PR body
-
-## Coordination With Changesets
-- Use this npm CLI flow for quick, low-risk patches.
-- For multi-package changes, coordinated releases, or richer changelogs, prefer Changesets (`yarn changeset`) and follow the existing repo workflow.
-
-
-## Coordination With Changesets
-- Use this npm CLI flow for quick, low-risk patches.
-- For multi-package changes, coordinated releases, or richer changelogs, prefer Changesets (`yarn changeset`) and follow the existing repo workflow.

AGENTS.md

@@ -12,7 +12,7 @@
 - `yarn build`: Build all packages/apps.
 - `yarn serve`: Serve built Storybook (`apps/docs`).
 - `yarn test`: Run workspace tests (Storybook test-runner in `apps/docs`).
-- `yarn format-and-lint` | `:fix`: Check/auto-fix with Biome.
+- `yarn lint` | `:fix`: Check/auto-fix with Biome.
 - Per workspace (examples):
   - `yarn workspace @lambdacurry/forms build`
   - `yarn workspace @lambdacurry/forms-docs dev`
@@ -34,7 +34,7 @@
 - Commits: short imperative subject, optional scope, concise body explaining rationale.
   - Example: `Fix: remove deprecated dropdown select`.
 - PRs: clear description, linked issues, screenshots or Storybook links, notes on testing.
-- Required checks: `yarn format-and-lint` passes; build succeeds; tests updated/added.
+- Required checks: `yarn lint` passes; build succeeds; tests updated/added.
 - Versioning: when changing published package(s), add a Changeset (`yarn changeset`) before merge.
 
 ## Security & Configuration
@@ -50,6 +50,9 @@
 - `.cursor/rules/monorepo-organization.mdc`: Imports/exports, package boundaries, Turbo/Vite/TS paths.
 - `.cursor/rules/versioning-with-npm.mdc`: npm CLI version bumps (patch-first), CI publishes on merge.
 
+## AI Agent Workflows
+- `:researcher` - Investigate bugs/implementation questions and produce evidence-backed recommendations aligned with the constitution and tech stack.
+
 When to review before starting work
 - Building/refactoring UI components: react-typescript-patterns + ui-component-patterns.
 - Form-aware components or validation: form-component-patterns.

apps/docs/src/examples/middleware-example.tsx

@@ -1,8 +1,8 @@
 import { zodResolver } from '@hookform/resolvers/zod';
 import { TextField } from '@lambdacurry/forms/remix-hook-form';
+import type { ActionFunctionArgs } from 'react-router';
 // Example of using the new middleware feature in remix-hook-form v7.0.0
 import { Form } from 'react-router';
-import type { ActionFunctionArgs } from 'react-router';
 import { RemixFormProvider, useRemixForm } from 'remix-hook-form';
 import { getValidatedFormData } from 'remix-hook-form/middleware';
 import * as zod from 'zod';

apps/docs/src/lib/storybook/react-router-stub.tsx

@@ -2,10 +2,10 @@ import type { Decorator } from '@storybook/react-vite';
 import type { ComponentType } from 'react';
 import {
   type ActionFunction,
+  createRoutesStub,
   type LinksFunction,
   type LoaderFunction,
   type MetaFunction,
-  createRoutesStub,
 } from 'react-router';
 
 export interface StubRouteObject {

apps/docs/src/remix-hook-form/calendar-with-month-year-select.stories.tsx

@@ -7,7 +7,7 @@ import type { Meta, StoryObj } from '@storybook/react-vite';
 import { expect, userEvent, within } from '@storybook/test';
 import * as React from 'react';
 import { type ActionFunctionArgs, Form, useFetcher } from 'react-router';
-import { RemixFormProvider, createFormData, getValidatedFormData, useRemixForm } from 'remix-hook-form';
+import { createFormData, getValidatedFormData, RemixFormProvider, useRemixForm } from 'remix-hook-form';
 import { z } from 'zod';
 import { withReactRouterStubDecorator } from '../lib/storybook/react-router-stub';
 

apps/docs/src/remix-hook-form/checkbox-custom.stories.tsx

@@ -8,7 +8,7 @@ import { expect, userEvent, within } from '@storybook/test';
 import type * as React from 'react';
 import type { ActionFunctionArgs } from 'react-router';
 import { useFetcher } from 'react-router';
-import { RemixFormProvider, getValidatedFormData, useRemixForm } from 'remix-hook-form';
+import { getValidatedFormData, RemixFormProvider, useRemixForm } from 'remix-hook-form';
 import { z } from 'zod';
 import { withReactRouterStubDecorator } from '../lib/storybook/react-router-stub';
 

apps/docs/src/remix-hook-form/checkbox-list.stories.tsx

@@ -5,7 +5,7 @@ import { Button } from '@lambdacurry/forms/ui/button';
 import type { Meta, StoryObj } from '@storybook/react-vite';
 import { expect, userEvent, type within } from '@storybook/test';
 import { type ActionFunctionArgs, Form, useFetcher } from 'react-router';
-import { RemixFormProvider, createFormData, getValidatedFormData, useRemixForm } from 'remix-hook-form';
+import { createFormData, getValidatedFormData, RemixFormProvider, useRemixForm } from 'remix-hook-form';
 import { z } from 'zod';
 import { withReactRouterStubDecorator } from '../lib/storybook/react-router-stub';
 

apps/docs/src/remix-hook-form/checkbox.stories.tsx

@@ -4,7 +4,7 @@ import { Button } from '@lambdacurry/forms/ui/button';
 import type { Meta, StoryObj } from '@storybook/react-vite';
 import { expect, userEvent, within } from '@storybook/test';
 import { type ActionFunctionArgs, useFetcher } from 'react-router';
-import { RemixFormProvider, getValidatedFormData, useRemixForm } from 'remix-hook-form';
+import { getValidatedFormData, RemixFormProvider, useRemixForm } from 'remix-hook-form';
 import { z } from 'zod';
 import { withReactRouterStubDecorator } from '../lib/storybook/react-router-stub';
 

apps/docs/src/remix-hook-form/data-table/data-table-client-side.stories.tsx

@@ -4,14 +4,14 @@ import { columnConfigs, columns } from './data-table-stories.components';
 import {
   DataTable,
   DataTableFilter,
-  type MockIssue,
-  type OnChangeFn,
-  type PaginationState,
-  type SortingState,
   getCoreRowModel,
   getPaginationRowModel,
   getSortedRowModel,
+  type MockIssue,
   mockDatabase,
+  type OnChangeFn,
+  type PaginationState,
+  type SortingState,
   useDataTableFilters,
   useFilterSync,
   useReactTable,