npm - red64-cli - Versions diffs - 0.1.0 → 0.2.0 - Mend

red64-cli 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (103) hide show

package/dist/cli/parseArgs.d.ts.map +1 -1
package/dist/cli/parseArgs.js +5 -0
package/dist/cli/parseArgs.js.map +1 -1
package/dist/components/init/CompleteStep.d.ts.map +1 -1
package/dist/components/init/CompleteStep.js +2 -2
package/dist/components/init/CompleteStep.js.map +1 -1
package/dist/components/init/TestCheckStep.d.ts +16 -0
package/dist/components/init/TestCheckStep.d.ts.map +1 -0
package/dist/components/init/TestCheckStep.js +120 -0
package/dist/components/init/TestCheckStep.js.map +1 -0
package/dist/components/init/index.d.ts +1 -0
package/dist/components/init/index.d.ts.map +1 -1
package/dist/components/init/index.js +1 -0
package/dist/components/init/index.js.map +1 -1
package/dist/components/init/types.d.ts +9 -0
package/dist/components/init/types.d.ts.map +1 -1
package/dist/components/screens/InitScreen.d.ts.map +1 -1
package/dist/components/screens/InitScreen.js +69 -6
package/dist/components/screens/InitScreen.js.map +1 -1
package/dist/components/screens/StartScreen.d.ts.map +1 -1
package/dist/components/screens/StartScreen.js +89 -3
package/dist/components/screens/StartScreen.js.map +1 -1
package/dist/services/ConfigService.d.ts +1 -0
package/dist/services/ConfigService.d.ts.map +1 -1
package/dist/services/ConfigService.js.map +1 -1
package/dist/services/ProjectDetector.d.ts +28 -0
package/dist/services/ProjectDetector.d.ts.map +1 -0
package/dist/services/ProjectDetector.js +236 -0
package/dist/services/ProjectDetector.js.map +1 -0
package/dist/services/TestRunner.d.ts +46 -0
package/dist/services/TestRunner.d.ts.map +1 -0
package/dist/services/TestRunner.js +85 -0
package/dist/services/TestRunner.js.map +1 -0
package/dist/services/index.d.ts +2 -0
package/dist/services/index.d.ts.map +1 -1
package/dist/services/index.js +2 -0
package/dist/services/index.js.map +1 -1
package/dist/types/index.d.ts +1 -0
package/dist/types/index.d.ts.map +1 -1
package/dist/types/index.js.map +1 -1
package/framework/agents/claude/.claude/agents/red64/spec-impl.md +131 -2
package/framework/agents/claude/.claude/commands/red64/spec-impl.md +24 -0
package/framework/agents/codex/.codex/agents/red64/spec-impl.md +131 -2
package/framework/agents/codex/.codex/commands/red64/spec-impl.md +24 -0
package/framework/stacks/generic/feedback.md +80 -0
package/framework/stacks/nextjs/accessibility.md +437 -0
package/framework/stacks/nextjs/api.md +431 -0
package/framework/stacks/nextjs/coding-style.md +282 -0
package/framework/stacks/nextjs/commenting.md +226 -0
package/framework/stacks/nextjs/components.md +411 -0
package/framework/stacks/nextjs/conventions.md +333 -0
package/framework/stacks/nextjs/css.md +310 -0
package/framework/stacks/nextjs/error-handling.md +442 -0
package/framework/stacks/nextjs/feedback.md +124 -0
package/framework/stacks/nextjs/migrations.md +332 -0
package/framework/stacks/nextjs/models.md +362 -0
package/framework/stacks/nextjs/queries.md +410 -0
package/framework/stacks/nextjs/responsive.md +338 -0
package/framework/stacks/nextjs/tech-stack.md +177 -0
package/framework/stacks/nextjs/test-writing.md +475 -0
package/framework/stacks/nextjs/validation.md +467 -0
package/framework/stacks/python/api.md +468 -0
package/framework/stacks/python/authentication.md +342 -0
package/framework/stacks/python/code-quality.md +283 -0
package/framework/stacks/python/code-refactoring.md +315 -0
package/framework/stacks/python/coding-style.md +462 -0
package/framework/stacks/python/conventions.md +399 -0
package/framework/stacks/python/error-handling.md +512 -0
package/framework/stacks/python/feedback.md +92 -0
package/framework/stacks/python/implement-ai-llm.md +468 -0
package/framework/stacks/python/migrations.md +388 -0
package/framework/stacks/python/models.md +399 -0
package/framework/stacks/python/python.md +232 -0
package/framework/stacks/python/queries.md +451 -0
package/framework/stacks/python/structure.md +245 -58
package/framework/stacks/python/tech.md +92 -35
package/framework/stacks/python/testing.md +380 -0
package/framework/stacks/python/validation.md +471 -0
package/framework/stacks/rails/authentication.md +176 -0
package/framework/stacks/rails/code-quality.md +287 -0
package/framework/stacks/rails/code-refactoring.md +299 -0
package/framework/stacks/rails/feedback.md +130 -0
package/framework/stacks/rails/implement-ai-llm-with-rubyllm.md +342 -0
package/framework/stacks/rails/rails.md +301 -0
package/framework/stacks/rails/rails8-best-practices.md +498 -0
package/framework/stacks/rails/rails8-css.md +573 -0
package/framework/stacks/rails/structure.md +140 -0
package/framework/stacks/rails/tech.md +108 -0
package/framework/stacks/react/code-quality.md +521 -0
package/framework/stacks/react/components.md +625 -0
package/framework/stacks/react/data-fetching.md +586 -0
package/framework/stacks/react/feedback.md +110 -0
package/framework/stacks/react/forms.md +694 -0
package/framework/stacks/react/performance.md +640 -0
package/framework/stacks/react/product.md +22 -9
package/framework/stacks/react/state-management.md +472 -0
package/framework/stacks/react/structure.md +351 -44
package/framework/stacks/react/tech.md +219 -30
package/framework/stacks/react/testing.md +690 -0
package/package.json +1 -1
package/framework/stacks/node/product.md +0 -27
package/framework/stacks/node/structure.md +0 -82
package/framework/stacks/node/tech.md +0 -63

package/framework/stacks/nextjs/error-handling.md ADDED Viewed

@@ -0,0 +1,442 @@
+# Error Handling
+Comprehensive error handling patterns for Next.js 15 App Router with error boundaries, server actions, API routes, and monitoring.
+---
+## Philosophy
+- **Fail visibly**: Never swallow errors silently; always surface them to the user or monitoring
+- **Boundaries everywhere**: Every route segment gets an `error.tsx` for graceful degradation
+- **Typed errors**: Use custom error classes to distinguish expected from unexpected failures
+- **User-friendly messages**: Show actionable text to users, log technical details for developers
+---
+## Error Boundary Hierarchy
+### Route-Level Error Boundary
+```typescript
+// app/dashboard/error.tsx
+"use client";
+import { useEffect } from "react";
+import { Button } from "@/components/ui/button";
+interface ErrorProps {
+  error: Error & { digest?: string };
+  reset: () => void;
+}
+export default function DashboardError({ error, reset }: ErrorProps) {
+  useEffect(() => {
+    // Log to error monitoring service
+    console.error("Dashboard error:", error);
+  }, [error]);
+  return (
+    <div className="flex flex-col items-center justify-center gap-4 py-16" role="alert">
+      <h2 className="text-xl font-semibold">Something went wrong</h2>
+      <p className="text-muted-foreground max-w-md text-center">
+        We encountered an error loading the dashboard. This has been reported automatically.
+      </p>
+      <div className="flex gap-2">
+        <Button onClick={reset}>Try again</Button>
+        <Button variant="outline" onClick={() => window.location.reload()}>
+          Reload page
+        </Button>
+      </div>
+      {process.env.NODE_ENV === "development" && (
+        <pre className="mt-4 max-w-lg overflow-auto rounded bg-red-50 p-4 text-sm text-red-900">
+          {error.message}
+          {"\n"}
+          {error.stack}
+        </pre>
+      )}
+    </div>
+  );
+}
+```
+### Global Error Boundary
+```typescript
+// app/global-error.tsx
+"use client";
+export default function GlobalError({
+  error,
+  reset,
+}: {
+  error: Error & { digest?: string };
+  reset: () => void;
+}) {
+  return (
+    <html>
+      <body>
+        <div className="flex min-h-screen items-center justify-center p-4">
+          <div className="text-center">
+            <h1 className="text-2xl font-bold">Application Error</h1>
+            <p className="text-muted-foreground mt-2">
+              Something went wrong. Please try refreshing the page.
+            </p>
+            <button
+              onClick={reset}
+              className="mt-4 rounded-md bg-blue-600 px-4 py-2 text-white hover:bg-blue-700"
+            >
+              Try again
+            </button>
+          </div>
+        </div>
+      </body>
+    </html>
+  );
+}
+```
+### Not Found
+```typescript
+// app/not-found.tsx
+import Link from "next/link";
+export default function NotFound() {
+  return (
+    <div className="flex min-h-[60vh] flex-col items-center justify-center gap-4">
+      <h1 className="text-4xl font-bold">404</h1>
+      <p className="text-muted-foreground text-lg">Page not found</p>
+      <Link href="/" className="text-primary underline underline-offset-4">
+        Go back home
+      </Link>
+    </div>
+  );
+}
+```
+---
+## Custom Error Classes
+### Error Hierarchy
+```typescript
+// lib/errors.ts
+export class AppError extends Error {
+  constructor(
+    message: string,
+    public code: string,
+    public statusCode: number = 500,
+    public details?: Record<string, unknown>
+  ) {
+    super(message);
+    this.name = "AppError";
+  }
+}
+export class NotFoundError extends AppError {
+  constructor(resource: string, id: string | number) {
+    super(`${resource} not found: ${id}`, "NOT_FOUND", 404, { resource, id });
+    this.name = "NotFoundError";
+  }
+}
+export class ValidationError extends AppError {
+  constructor(message: string, public fieldErrors?: Record<string, string[]>) {
+    super(message, "VALIDATION_ERROR", 422, { fieldErrors });
+    this.name = "ValidationError";
+  }
+}
+export class UnauthorizedError extends AppError {
+  constructor(message = "Authentication required") {
+    super(message, "UNAUTHORIZED", 401);
+    this.name = "UnauthorizedError";
+  }
+}
+export class ForbiddenError extends AppError {
+  constructor(message = "Insufficient permissions") {
+    super(message, "FORBIDDEN", 403);
+    this.name = "ForbiddenError";
+  }
+}
+export class ConflictError extends AppError {
+  constructor(message: string) {
+    super(message, "CONFLICT", 409);
+    this.name = "ConflictError";
+  }
+}
+```
+---
+## Server Component Error Handling
+### Try/Catch in Async Components
+```typescript
+// app/users/[id]/page.tsx
+import { notFound } from "next/navigation";
+import { prisma } from "@/lib/prisma";
+export default async function UserPage({ params }: { params: Promise<{ id: string }> }) {
+  const { id } = await params;
+  const user = await prisma.user.findUnique({
+    where: { id },
+    include: { posts: { take: 10, orderBy: { createdAt: "desc" } } },
+  });
+  if (!user) {
+    notFound();
+  }
+  return <UserProfile user={user} />;
+}
+```
+### Service-Level Error Handling
+```typescript
+// lib/services/user-service.ts
+import { NotFoundError, ConflictError } from "@/lib/errors";
+import { prisma } from "@/lib/prisma";
+export async function getUserById(id: string) {
+  const user = await prisma.user.findUnique({ where: { id } });
+  if (!user) {
+    throw new NotFoundError("User", id);
+  }
+  return user;
+}
+export async function createUser(data: { email: string; name: string }) {
+  const existing = await prisma.user.findUnique({ where: { email: data.email } });
+  if (existing) {
+    throw new ConflictError(`User with email ${data.email} already exists`);
+  }
+  return prisma.user.create({ data });
+}
+```
+---
+## Server Action Error Handling
+### Action Result Pattern
+```typescript
+// types/actions.ts
+export type ActionResult<T = void> =
+  | { success: true; data: T }
+  | { success: false; error: string; fieldErrors?: Record<string, string[]> };
+```
+### Safe Action Wrapper
+```typescript
+// lib/safe-action.ts
+import { AppError, ValidationError } from "@/lib/errors";
+import type { ActionResult } from "@/types/actions";
+export async function safeAction<T>(
+  fn: () => Promise<T>
+): Promise<ActionResult<T>> {
+  try {
+    const data = await fn();
+    return { success: true, data };
+  } catch (error) {
+    if (error instanceof ValidationError) {
+      return {
+        success: false,
+        error: error.message,
+        fieldErrors: error.fieldErrors,
+      };
+    }
+    if (error instanceof AppError) {
+      return { success: false, error: error.message };
+    }
+    console.error("Unexpected error in action:", error);
+    return { success: false, error: "An unexpected error occurred" };
+  }
+}
+```
+### Usage in Server Actions
+```typescript
+// actions/users.ts
+"use server";
+import { z } from "zod";
+import { auth } from "@/lib/auth";
+import { safeAction } from "@/lib/safe-action";
+import { createUser } from "@/lib/services/user-service";
+import { revalidatePath } from "next/cache";
+const createUserSchema = z.object({
+  email: z.string().email("Invalid email address"),
+  name: z.string().min(1, "Name is required").max(255),
+});
+export async function createUserAction(formData: FormData) {
+  return safeAction(async () => {
+    const session = await auth();
+    if (!session?.user) throw new UnauthorizedError();
+    const parsed = createUserSchema.safeParse({
+      email: formData.get("email"),
+      name: formData.get("name"),
+    });
+    if (!parsed.success) {
+      throw new ValidationError("Invalid input", parsed.error.flatten().fieldErrors);
+    }
+    const user = await createUser(parsed.data);
+    revalidatePath("/users");
+    return user;
+  });
+}
+```
+---
+## API Route Error Handling
+### Centralized Error Response
+```typescript
+// lib/api-error.ts
+import { NextResponse } from "next/server";
+import { AppError } from "@/lib/errors";
+export function handleApiError(error: unknown) {
+  if (error instanceof AppError) {
+    return NextResponse.json(
+      { error: { code: error.code, message: error.message, details: error.details } },
+      { status: error.statusCode }
+    );
+  }
+  console.error("Unhandled API error:", error);
+  return NextResponse.json(
+    { error: { code: "INTERNAL_ERROR", message: "An internal error occurred" } },
+    { status: 500 }
+  );
+}
+```
+### Usage
+```typescript
+// app/api/users/[id]/route.ts
+import { handleApiError } from "@/lib/api-error";
+import { getUserById } from "@/lib/services/user-service";
+export async function GET(
+  _request: Request,
+  { params }: { params: Promise<{ id: string }> }
+) {
+  try {
+    const { id } = await params;
+    const user = await getUserById(id);
+    return Response.json(user);
+  } catch (error) {
+    return handleApiError(error);
+  }
+}
+```
+---
+## Client-Side Error Handling
+### Toast Notifications
+```typescript
+// components/forms/create-user-form.tsx
+"use client";
+import { useActionState } from "react";
+import { createUserAction } from "@/actions/users";
+import { toast } from "sonner";
+export function CreateUserForm() {
+  const [state, formAction, isPending] = useActionState(
+    async (_prev: unknown, formData: FormData) => {
+      const result = await createUserAction(formData);
+      if (result.success) {
+        toast.success("User created successfully");
+      } else {
+        toast.error(result.error);
+      }
+      return result;
+    },
+    null
+  );
+  return (
+    <form action={formAction}>
+      <input name="email" type="email" required />
+      {state && !state.success && state.fieldErrors?.email && (
+        <p className="text-sm text-destructive">{state.fieldErrors.email[0]}</p>
+      )}
+      <input name="name" required />
+      <button type="submit" disabled={isPending}>
+        {isPending ? "Creating..." : "Create User"}
+      </button>
+    </form>
+  );
+}
+```
+---
+## Error Monitoring
+### Sentry Integration
+```typescript
+// lib/sentry.ts
+import * as Sentry from "@sentry/nextjs";
+export function captureError(error: unknown, context?: Record<string, unknown>) {
+  if (error instanceof AppError && error.statusCode < 500) {
+    // Expected errors (4xx) - don't send to Sentry
+    return;
+  }
+  Sentry.captureException(error, { extra: context });
+}
+```
+```typescript
+// instrumentation.ts (Next.js instrumentation hook)
+export async function register() {
+  if (process.env.NEXT_RUNTIME === "nodejs") {
+    await import("./sentry.server.config");
+  }
+  if (process.env.NEXT_RUNTIME === "edge") {
+    await import("./sentry.edge.config");
+  }
+}
+```
+---
+## Anti-Patterns
+| Anti-Pattern | Problem | Correct Approach |
+|---|---|---|
+| Empty catch blocks | Errors disappear silently | Log and re-throw or return error state |
+| `try/catch` around every line | Unreadable, catch at boundaries | Catch at route/action level, let errors propagate |
+| Showing stack traces to users | Security risk, bad UX | User-friendly message + log details server-side |
+| Using `Error` for expected cases | Cannot distinguish expected vs unexpected | Custom error classes with codes |
+| No `error.tsx` in route segments | White screen on failure | Add error boundaries to all route segments |
+| Catching `redirect()` or `notFound()` | These are thrown intentionally by Next.js | Never catch Next.js navigation functions |
+---
+_Errors are inevitable. Handle them at boundaries, classify them with types, and always tell the user what happened and what they can do about it._

package/framework/stacks/nextjs/feedback.md ADDED Viewed

@@ -0,0 +1,124 @@
+# Feedback Configuration
+Project-specific commands for automated feedback during Next.js implementation.
+---
+## Test Commands
+Commands to run tests during implementation. The agent will use these to verify code changes.
+```yaml
+# Primary test command (REQUIRED)
+test: pnpm test
+# Test with coverage report
+test_coverage: pnpm test -- --coverage
+# Run specific test file (use {file} as placeholder)
+test_file: pnpm test {file}
+# Watch mode (for development)
+test_watch: pnpm test -- --watch
+```
+---
+## Linting Commands
+Commands for code quality checks.
+```yaml
+# Primary lint command (Next.js built-in)
+lint: pnpm lint
+# Lint with auto-fix
+lint_fix: pnpm lint --fix
+# Type checking
+type_check: pnpm tsc --noEmit
+# Format check
+format_check: pnpm prettier --check .
+# Format fix
+format_fix: pnpm prettier --write .
+```
+---
+## Development Server
+Commands for starting the development server (required for UI verification).
+```yaml
+# Start dev server (Next.js)
+dev_server: pnpm dev
+# Dev server port
+dev_port: 3000
+# Dev server base URL
+dev_url: http://localhost:3000
+```
+---
+## Build Commands
+Commands for production builds.
+```yaml
+# Production build
+build: pnpm build
+# Start production server
+start: pnpm start
+```
+---
+## UI Verification
+Settings for agent-browser UI verification.
+```yaml
+# Enable UI verification for this project
+ui_verification_enabled: true
+# Default wait time after navigation (milliseconds)
+navigation_wait: 3000
+# Screenshot directory
+screenshot_dir: /tmp/ui-captures
+# Common routes to verify
+routes:
+  - /
+  - /api/health
+```
+---
+## E2E Testing
+End-to-end testing with Playwright.
+```yaml
+# Run E2E tests
+e2e: pnpm test:e2e
+# Run E2E with UI
+e2e_ui: pnpm test:e2e --ui
+```
+---
+## Notes
+- Uses Jest or Vitest for unit tests (check package.json)
+- Uses Playwright for E2E testing
+- Next.js dev server on port 3000 by default
+- Built-in ESLint configuration via `next lint`
+- UI verification is enabled by default for Next.js projects
+- API routes available at `/api/*`