quiver-cli 1.3.1 → 2.0.0

package/template/.agents/skills/data/prisma-client-api/references/relations.md

@@ -1,308 +0,0 @@
-# Relation Queries
-
-Query and modify related records.
-
-## Include Relations
-
-Load related records:
-
-```typescript
-const user = await prisma.user.findUnique({
-  where: { id: 1 },
-  include: {
-    posts: true,
-    profile: true
-  }
-})
-```
-
-### Filtered include
-
-```typescript
-const user = await prisma.user.findUnique({
-  where: { id: 1 },
-  include: {
-    posts: {
-      where: { published: true },
-      orderBy: { createdAt: 'desc' },
-      take: 5,
-      select: { id: true, title: true }
-    }
-  }
-})
-```
-
-### Nested include
-
-```typescript
-const user = await prisma.user.findUnique({
-  where: { id: 1 },
-  include: {
-    posts: {
-      include: {
-        comments: {
-          include: { author: true }
-        }
-      }
-    }
-  }
-})
-```
-
-## Select Relations
-
-```typescript
-const user = await prisma.user.findUnique({
-  where: { id: 1 },
-  select: {
-    name: true,
-    posts: {
-      select: { title: true }
-    }
-  }
-})
-```
-
-## Nested Writes
-
-### Create with relations
-
-```typescript
-const user = await prisma.user.create({
-  data: {
-    email: 'alice@prisma.io',
-    posts: {
-      create: [
-        { title: 'Post 1' },
-        { title: 'Post 2' }
-      ]
-    },
-    profile: {
-      create: { bio: 'Hello!' }
-    }
-  }
-})
-```
-
-### Create or connect
-
-```typescript
-const post = await prisma.post.create({
-  data: {
-    title: 'New Post',
-    author: {
-      connectOrCreate: {
-        where: { email: 'alice@prisma.io' },
-        create: { email: 'alice@prisma.io', name: 'Alice' }
-      }
-    }
-  }
-})
-```
-
-### Connect existing
-
-```typescript
-const post = await prisma.post.create({
-  data: {
-    title: 'New Post',
-    author: {
-      connect: { id: 1 }
-    }
-  }
-})
-
-// Shorthand for foreign key
-const post = await prisma.post.create({
-  data: {
-    title: 'New Post',
-    authorId: 1
-  }
-})
-```
-
-## Update Relations
-
-### Update related records
-
-```typescript
-const user = await prisma.user.update({
-  where: { id: 1 },
-  data: {
-    posts: {
-      update: {
-        where: { id: 1 },
-        data: { title: 'Updated Title' }
-      }
-    }
-  }
-})
-```
-
-### Update many related
-
-```typescript
-const user = await prisma.user.update({
-  where: { id: 1 },
-  data: {
-    posts: {
-      updateMany: {
-        where: { published: false },
-        data: { published: true }
-      }
-    }
-  }
-})
-```
-
-### Upsert related
-
-```typescript
-const user = await prisma.user.update({
-  where: { id: 1 },
-  data: {
-    profile: {
-      upsert: {
-        create: { bio: 'New bio' },
-        update: { bio: 'Updated bio' }
-      }
-    }
-  }
-})
-```
-
-### Disconnect
-
-```typescript
-// 1-to-1 optional
-const user = await prisma.user.update({
-  where: { id: 1 },
-  data: {
-    profile: { disconnect: true }
-  }
-})
-
-// Many-to-many
-const post = await prisma.post.update({
-  where: { id: 1 },
-  data: {
-    tags: {
-      disconnect: [{ id: 1 }, { id: 2 }]
-    }
-  }
-})
-```
-
-### Delete related
-
-```typescript
-const user = await prisma.user.update({
-  where: { id: 1 },
-  data: {
-    posts: {
-      delete: { id: 1 }
-    }
-  }
-})
-
-// Delete many
-const user = await prisma.user.update({
-  where: { id: 1 },
-  data: {
-    posts: {
-      deleteMany: { published: false }
-    }
-  }
-})
-```
-
-### Set (replace all)
-
-```typescript
-// Replace all related records
-const post = await prisma.post.update({
-  where: { id: 1 },
-  data: {
-    tags: {
-      set: [{ id: 1 }, { id: 2 }]
-    }
-  }
-})
-```
-
-## Relation Filters
-
-### some
-
-At least one matches:
-
-```typescript
-const users = await prisma.user.findMany({
-  where: {
-    posts: { some: { published: true } }
-  }
-})
-```
-
-### every
-
-All match:
-
-```typescript
-const users = await prisma.user.findMany({
-  where: {
-    posts: { every: { published: true } }
-  }
-})
-```
-
-### none
-
-None match:
-
-```typescript
-const users = await prisma.user.findMany({
-  where: {
-    posts: { none: { published: true } }
-  }
-})
-```
-
-### is / isNot (1-to-1)
-
-```typescript
-const users = await prisma.user.findMany({
-  where: {
-    profile: { is: { country: 'USA' } }
-  }
-})
-```
-
-## Count Relations
-
-```typescript
-const users = await prisma.user.findMany({
-  select: {
-    name: true,
-    _count: {
-      select: { posts: true, followers: true }
-    }
-  }
-})
-// { name: 'Alice', _count: { posts: 5, followers: 100 } }
-```
-
-### Filter counted relations
-
-```typescript
-const users = await prisma.user.findMany({
-  select: {
-    name: true,
-    _count: {
-      select: {
-        posts: { where: { published: true } }
-      }
-    }
-  }
-})
-```

package/template/.agents/skills/data/prisma-client-api/references/transactions.md

@@ -1,184 +0,0 @@
-# Transactions
-
-Execute multiple operations atomically.
-
-## Sequential Transactions
-
-Array of operations executed in order:
-
-```typescript
-const [user, post] = await prisma.$transaction([
-  prisma.user.create({ data: { email: 'alice@prisma.io' } }),
-  prisma.post.create({ data: { title: 'Hello', authorId: 1 } })
-])
-```
-
-### All or nothing
-
-If any operation fails, all are rolled back:
-
-```typescript
-try {
-  await prisma.$transaction([
-    prisma.user.create({ data: { email: 'alice@prisma.io' } }),
-    prisma.user.create({ data: { email: 'alice@prisma.io' } }) // Duplicate!
-  ])
-} catch (e) {
-  // Both operations rolled back
-}
-```
-
-## Interactive Transactions
-
-For complex logic and dependent operations:
-
-```typescript
-await prisma.$transaction(async (tx) => {
-  // Decrement sender balance
-  const sender = await tx.account.update({
-    where: { id: senderId },
-    data: { balance: { decrement: amount } }
-  })
-  
-  // Check balance
-  if (sender.balance < 0) {
-    throw new Error('Insufficient funds')
-  }
-  
-  // Increment recipient balance
-  await tx.account.update({
-    where: { id: recipientId },
-    data: { balance: { increment: amount } }
-  })
-})
-```
-
-### Transaction options
-
-```typescript
-await prisma.$transaction(
-  async (tx) => {
-    // operations
-  },
-  {
-    maxWait: 5000,    // Max wait to acquire lock (ms)
-    timeout: 10000,   // Max transaction duration (ms)
-    isolationLevel: 'Serializable'  // Isolation level
-  }
-)
-```
-
-### Isolation levels
-
-| Level | Description |
-|-------|-------------|
-| `ReadUncommitted` | Lowest isolation, can read uncommitted changes |
-| `ReadCommitted` | Only read committed changes |
-| `RepeatableRead` | Consistent reads within transaction |
-| `Serializable` | Highest isolation, serialized execution |
-
-## Nested Writes
-
-Automatic transactions for nested operations:
-
-```typescript
-// This is automatically a transaction
-const user = await prisma.user.create({
-  data: {
-    email: 'alice@prisma.io',
-    posts: {
-      create: [
-        { title: 'Post 1' },
-        { title: 'Post 2' }
-      ]
-    },
-    profile: {
-      create: { bio: 'Hello!' }
-    }
-  }
-})
-```
-
-## Transaction Client
-
-The `tx` parameter is a Prisma Client scoped to the transaction:
-
-```typescript
-await prisma.$transaction(async (tx) => {
-  // Use tx instead of prisma
-  await tx.user.create({ ... })
-  await tx.post.create({ ... })
-  
-  // Can call methods
-  const count = await tx.user.count()
-})
-```
-
-## OrThrow in Transactions
-
-Use with interactive transactions:
-
-```typescript
-await prisma.$transaction(async (tx) => {
-  // If not found, throws and rolls back entire transaction
-  const user = await tx.user.findUniqueOrThrow({
-    where: { id: 1 }
-  })
-  
-  await tx.post.create({
-    data: { title: 'New Post', authorId: user.id }
-  })
-})
-```
-
-## Best Practices
-
-### Keep transactions short
-
-```typescript
-// Good - only DB operations in transaction
-const data = prepareData() // Outside transaction
-await prisma.$transaction(async (tx) => {
-  await tx.user.create({ data })
-})
-```
-
-### Handle errors
-
-```typescript
-try {
-  await prisma.$transaction(async (tx) => {
-    // operations
-  })
-} catch (e) {
-  if (e.code === 'P2002') {
-    // Handle unique constraint violation
-  }
-  throw e
-}
-```
-
-### Use appropriate isolation
-
-```typescript
-// Default is fine for most cases
-await prisma.$transaction(async (tx) => {
-  // operations
-})
-
-// Use Serializable for strict consistency
-await prisma.$transaction(
-  async (tx) => { /* operations */ },
-  { isolationLevel: 'Serializable' }
-)
-```
-
-## Sequential vs Interactive
-
-| Feature | Sequential | Interactive |
-|---------|------------|-------------|
-| Syntax | Array | Async function |
-| Dependent ops | No | Yes |
-| Conditional logic | No | Yes |
-| Performance | Better | More flexible |
-| Use case | Simple batch | Complex logic |

package/template/.agents/skills/design/impeccable/SKILL.md

@@ -1,84 +0,0 @@
----
-name: impeccable
-description: Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks.
-version: 4.1.2
-license: Apache 2.0
-allowed-tools:
-  - Bash(npx impeccable *)
-  - Bash(node .pi/skills/impeccable/scripts/*)
----
-
-This skill gives you the tools and permission to create design that earns to be called out-of-distribution craft: Whereas before, your design work would have been safe, timid and measured, you now approach every design task as an award-winning design director with impeccable understanding for what makes exceptional design work: production-grade code, peak creativity, a clear POV, deep understanding of the needs of the client and users, and exceptional craft.
-
-Core principles:
-- Go all out. No hedging, no shortcuts. The deliverable must be complete (except assets the user must provide).
-- Dream big and bold. Distinct, beautiful, outstanding and highly inspiring work.
-- Verify in bounded passes, not a loop, and the ceiling covers the whole cycle: screenshots, defect scans, micro-edits, and rebuilds alike. Build fully, inspect once with a batched round (desktop and mobile together on the web; the shipped device classes on a native platform), fix everything it shows in one batch, confirm with at most one more round, and stop polishing. Open-ended self-QA burns the user's money doing worse what the finish handoffs do better.
-
-## Setup
-
-1. Run `node <skill-base-dir>/scripts/context.mjs` once per session, where `<skill-base-dir>` is the loaded base directory the runtime reports for this skill; keep cwd at the user's project. That base directory resolves every `node .pi/skills/impeccable/scripts/...` command in this skill and its references, and `.pi/skills/impeccable/scripts` is the fallback only when the runtime reports no base directory. Pass a named source file or route as `--target <path>`. It loads PRODUCT.md, DESIGN.md, the matching surface brief, and native-platform guidance when applicable; follow its directives and do not rerun it.
-2. Load the request's playbook: its Commands-table reference for an explicit/implied sub-command, or [reference/new-work.md](reference/new-work.md) for a new surface or replacement visual world. Inspect target and incumbent visual truth before editing. When the app cannot run, start with committed visual-regression goldens or screenshot fixtures; verify target and freshness against current tokens, CSS, components, or assets, resolve conflicts, and compare theme/variant captures.
-3. After analysis and direction are resolved, load [reference/craft-floor.md](reference/craft-floor.md) immediately before editing UI. It carries the quality floor, the absolute bans, and the reflexes no detector catches. Do not load it for planning-only work.
-
-## How to design
-
-- **The brief wins.** Honor pinned aesthetics, eras, materials, fonts, and palettes even when they conflict with a saturated-pattern warning. Redirecting a clear brief toward your taste is failure.
-- **Refinement preserves; redesign replaces.** Refinement keeps the incumbent identity, behavior, copy, and everything outside scope. Ask before replacing factual copy or adding claims. Redesign keeps product truth, content, function, native affordances, and constraints, but treats the old look as evidence and anti-reference; choose a replacement world in new-work and replace DESIGN.md. Never split the difference into polish on the discarded look.
-- **Visual authority is evidence, not a filename.** Missing DESIGN.md alone does not make a project greenfield; new-work decides whether to preserve, expand, or replace the incumbent world.
-
-## Modes
-
-The mode names what the visitor's success looks like on this surface.
-
-- **Persuade:** the visitor decides and acts; design is the product. Landing pages, marketing, campaigns, pricing. Earn attention and action. Ship real imagery when the brief needs it; follow the committed world, not category habit.
-- **Operate:** the visitor completes a task. App UI, dashboards, editors, admin, settings, tools. Scanability, consistency, native expectations, and the real usage scene outrank expression. Brand lives in precise details.
-- **Read:** the visitor understands something. Docs, articles, guides, help, changelogs. Structure for comprehension, then make the reading experience worth staying in.
-- **Experience:** the visitor is inside the work itself. Portfolios, galleries, showcases. Let the artifact lead from the first viewport; the interface recedes.
-
-Choose the mode from the requested surface, not the product, and persist it only in that surface brief. A tool's landing page is still Persuade; a fashion house's documentation is still Read; a docs index is Read, not Persuade. See [new-work.md](reference/new-work.md) for new surfaces and [operate.md](reference/operate.md) for deeper Operate/Read guidance.
-
-## Commands
-
-| Command | Category | Description | Reference |
-|---|---|---|---|
-| `craft [feature]` | Build | Deprecated alias for an ordinary new-work request | [reference/craft.md](reference/craft.md) |
-| `shape [feature]` | Build | Plan UX/UI before writing code | [reference/shape.md](reference/shape.md) |
-| `init` | Build | Capture durable product context in PRODUCT.md | [reference/init.md](reference/init.md) |
-| `document` | Build | Generate DESIGN.md from existing project code | [reference/document.md](reference/document.md) |
-| `extract [target]` | Build | Pull reusable tokens and components into design system | [reference/extract.md](reference/extract.md) |
-| `critique [target]` | Evaluate | UX design review with heuristic scoring | [reference/critique.md](reference/critique.md) |
-| `audit [target]` | Evaluate | Technical quality checks (a11y, perf, responsive) | [reference/audit.md](reference/audit.md) · native: [reference/audit.native.md](reference/audit.native.md) |
-| `polish [target]` | Refine | Final quality pass before shipping | [reference/polish.md](reference/polish.md) |
-| `bolder [target]` | Refine | Amplify safe or bland designs | [reference/bolder.md](reference/bolder.md) |
-| `quieter [target]` | Refine | Tone down aggressive or overstimulating designs | [reference/quieter.md](reference/quieter.md) |
-| `distill [target]` | Refine | Strip to essence, remove complexity | [reference/distill.md](reference/distill.md) |
-| `harden [target]` | Refine | Production-ready: errors, i18n, edge cases | [reference/harden.md](reference/harden.md) |
-| `onboard [target]` | Refine | Design first-run flows, empty states, activation | [reference/onboard.md](reference/onboard.md) |
-| `animate [target]` | Enhance | Add purposeful animations and motion | [reference/animate.md](reference/animate.md) |
-| `colorize [target]` | Enhance | Add strategic color to monochromatic UIs | [reference/colorize.md](reference/colorize.md) |
-| `typeset [target]` | Enhance | Improve typography hierarchy and fonts | [reference/typeset.md](reference/typeset.md) |
-| `layout [target]` | Enhance | Fix spacing, rhythm, and visual hierarchy | [reference/layout.md](reference/layout.md) |
-| `delight [target]` | Enhance | Add personality and memorable touches | [reference/delight.md](reference/delight.md) |
-| `overdrive [target]` | Enhance | Push past conventional limits | [reference/overdrive.md](reference/overdrive.md) |
-| `clarify [target]` | Fix | Improve UX copy, labels, and error messages | [reference/clarify.md](reference/clarify.md) |
-| `adapt [target]` | Fix | Adapt for different devices and screen sizes | [reference/adapt.md](reference/adapt.md) · native: [reference/adapt.native.md](reference/adapt.native.md) |
-| `optimize [target]` | Fix | Diagnose and fix UI performance | [reference/optimize.md](reference/optimize.md) |
-| `live` | Iterate | Visual variant mode: pick elements in the browser, generate alternatives | [reference/live.md](reference/live.md) |
-
-Routing:
-
-- **No argument:** read [routing.md](reference/routing.md) and present its context-aware menu; never auto-run a command.
-- **Explicit or clearly implied command:** load its reference (native variant on native platforms) and follow it. Ask once if two commands fit.
-- **Otherwise:** treat the request as general design work. Missing PRODUCT.md routes a new surface or replacement world through init, then new-work; a narrow refinement of existing code proceeds on the incumbent implementation as context.mjs directs, offering init afterward rather than blocking on it.
-- `teach` aliases `init`. `craft` is a deprecated alias for ordinary new-work and adds nothing. `shape` owns task discovery, then enters new-work only for visual-world and surface-concept decisions.
-
-After init writes PRODUCT.md, resume without rerunning `context.mjs`; init loads the native platform reference itself when the platform it recorded is `ios`, `android`, or `adaptive`.
-
-**Pin / Unpin:** `node .pi/skills/impeccable/scripts/pin.mjs <pin|unpin> <command>` creates or removes a standalone `/<command>` shortcut. Report the script's result concisely; relay stderr verbatim on error.
-
-**Hooks:** `/impeccable hooks <on|off|status|ignore-rule|ignore-file|ignore-value|reset>` manages the design detector hook for this project (auto-runs the detector after UI file edits and surfaces findings). Load [reference/hooks.md](reference/hooks.md) when the user invokes it with any argument.
-
-**Doctor:** `/impeccable doctor` reports and repairs drift between this project's Impeccable artifacts (PRODUCT.md, DESIGN.md and its sidecar, config, surface briefs, the hook) and what this version reads. Load [reference/doctor.md](reference/doctor.md) when the user invokes it, or when they ask what is out of date, stale, or needs refreshing. A `CONTEXT_STALE` directive in Setup's output is the cheap subset of the same report; act on it there per its own instructions rather than running doctor unasked.
-
-**Never repair drift as a side effect of a design task.** A `CONTEXT_STALE` finding is reported, not acted on, unless the user asks. The one exception is a finding marked `auto`, which the next write to that file performs anyway.