@8gi-foundation/8gent-code 0.6.0

package/dist/skills/vercel-react/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: vercel-react
+description: React and Next.js performance rules for 8gent web tasks. Apply when writing, reviewing, or refactoring React/Next.js code.
+type: skill
+---
+
+# Vercel React Best Practices
+
+Reference when writing Next.js components, data fetching, or reviewing bundles.
+
+## Eliminating Waterfalls (CRITICAL)
+
+- **Parallel fetches**: Use `Promise.all()` for independent async operations. Never chain `await` calls that don't depend on each other.
+- **Start early, await late**: In API routes, kick off promises at the top, await at the point of use.
+- **Suspense boundaries**: Wrap independent data-fetching components so they stream concurrently.
+- **Partial dependencies**: Use `Promise.allSettled()` or structured parallel fetching when some calls depend on others.
+
+```ts
+// Wrong - waterfall
+const user = await getUser(id);
+const posts = await getPosts(id);
+
+// Right - parallel
+const [user, posts] = await Promise.all([getUser(id), getPosts(id)]);
+```
+
+## Bundle Size (CRITICAL)
+
+- **No barrel imports**: Import directly from the module file, not `index.ts` re-exports.
+- **Dynamic imports**: Use `next/dynamic` for heavy components (charts, editors, rich text).
+- **Defer third-party**: Load analytics, logging, chat widgets after hydration (`useEffect` or `next/script` with `afterInteractive`).
+- **Conditional loading**: Load a module only when the feature is activated, not at page load.
+- **Preload on hover**: For critical paths, preload on `onMouseEnter` / `onFocus` for perceived speed.
+
+## Server Components (default)
+
+- **Server by default**: Every component is a Server Component unless it needs interactivity or browser APIs.
+- **Client boundary at the leaf**: Push `'use client'` as deep as possible. Don't make a whole page client just for one button.
+- **Minimize serialized props**: Only pass what the client component needs. Don't forward large objects.
+- **`React.cache()`**: Deduplicate identical fetches within a single request.
+- **`unstable_cache` / ISR**: Cache cross-request data at the Next.js layer. Use `revalidate` to control staleness.
+
+## Re-render Optimization
+
+- **Don't subscribe to state you only use in callbacks**: Read from refs or pass values into handlers instead.
+- **Memoize expensive components**: `React.memo` + stable props. Only when profiling proves it helps.
+- **Primitive deps in effects**: Destructure objects before listing as `useEffect` deps to avoid infinite loops.
+- **Functional `setState`**: Use `setState(prev => ...)` for stable callbacks that don't close over stale state.
+- **`startTransition`**: Wrap non-urgent state updates (search, filter) to keep input responsive.
+- **Lazy state init**: Pass a function to `useState(() => expensiveInit())` — runs once, not on every render.
+
+## Rendering Performance
+
+- **Hoist static JSX**: Define JSX that never changes outside the component function.
+- **`content-visibility`**: Apply to off-screen sections of long pages.
+- **Animate SVG wrapper**: Animate a `<div>` wrapper, not the SVG element directly.
+- **Ternary, not `&&`**: Use `condition ? <A /> : null` not `condition && <A />` to avoid rendering `0`.
+
+## JavaScript Performance
+
+- **`Map` for lookups**: Build a `Map` once for repeated O(1) access instead of repeated `Array.find`.
+- **Early return**: Exit functions as soon as the answer is known.
+- **Combine iterations**: One `reduce` over an array instead of chained `.filter().map()`.
+- **Hoist RegExp**: Define `const RE = /pattern/` outside the function, not inside a loop.
+- **Cache storage reads**: `const val = localStorage.getItem('key')` once, not on every access.
+
+## Image Optimization
+
+- Always use `next/image`. Never raw `<img>` for content images.
+- Provide explicit `width` and `height` to prevent layout shift.
+- Use `priority` on above-the-fold images. Use `loading="lazy"` (default) for everything else.
+- Serve WebP/AVIF via Next.js image config.
+
+## Checklist Before Shipping
+
+- [ ] No sequential awaits for independent fetches
+- [ ] Heavy components use `next/dynamic`
+- [ ] No unnecessary `'use client'` at layout/page level
+- [ ] Images use `next/image` with explicit dimensions
+- [ ] ISR or `React.cache` applied to repeated fetches
+- [ ] No barrel imports from component libraries

package/package.json

@@ -0,0 +1,114 @@
+{
+  "name": "@8gi-foundation/8gent-code",
+  "version": "0.6.0",
+  "private": false,
+  "description": "Autonomous coding agent. Runs locally on Ollama. Zero API cost. Your code stays on your machine. Open source.",
+  "type": "module",
+  "bin": {
+    "8": "./bin/8gent-run.js",
+    "8gent": "./bin/8gent-run.js",
+    "8gent-code": "./bin/8gent-run.js"
+  },
+  "files": [
+    "dist/cli.js",
+    "dist/skills",
+    "bin/8gent-run.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "start": "bun run packages/eight/index.ts",
+    "agent": "bun run packages/eight/index.ts",
+    "tui": "bun run apps/tui/src/index.tsx",
+    "pet": "bash apps/lil-eight/build.sh && open 'apps/lil-eight/build/Lil Eight.app'",
+    "pet:build": "bash apps/lil-eight/build.sh",
+    "pet:open": "open 'apps/lil-eight/build/Lil Eight.app'",
+    "pet:kill": "pkill -f LilEight",
+    "pet:log": "tail -f ~/.8gent/lil-eight.log",
+    "install-wizard": "bun run apps/installer/src/index.tsx",
+    "install:apple-foundation": "bun run scripts/install-apple-foundation.ts",
+    "cli": "bun run bin/8gent.ts",
+    "dev": "next dev",
+    "build": "bun build bin/8gent.ts --outfile dist/cli.js --target bun && node -e \"const fs=require('fs');const f='dist/cli.js';const c=fs.readFileSync(f,'utf-8');if(!c.startsWith('#!'))fs.writeFileSync(f,'#!/usr/bin/env bun\\n'+c);\" && chmod +x dist/cli.js && bash scripts/copy-bundled-skills.sh",
+    "build:tui": "bun build apps/tui/src/index.tsx --outdir dist/tui --target node",
+    "prepublishOnly": "npm run build",
+    "postinstall": "node -e \"console.log('\\n✨ 8gent installed! Just type: 8gent\\n\\n8gent auto-detects LM Studio, Ollama, and local models on first run.\\nIf no model is found, a setup menu will walk you through it.\\n')\" && npx bmad-method init --no-interactive 2>/dev/null || true",
+    "test": "bun test",
+    "lint": "biome check .",
+    "typecheck": "tsc --noEmit",
+    "typecheck:tui": "tsc --noEmit -p apps/tui/tsconfig.json",
+    "check:harness": "tsc --noEmit -p tsconfig.harness.json",
+    "benchmark": "bun run scripts/benchmark.ts",
+    "benchmark:suite": "bun run benchmarks/runner.ts",
+    "benchmark:category": "bun run benchmarks/runner.ts --category",
+    "benchmark:single": "bun run benchmarks/runner.ts --bench",
+    "benchmark:swebench": "bun run benchmarks/swebench/run.ts",
+    "demo": "bun run scripts/demo-savings.ts",
+    "harness": "bun run packages/harness-cli/index.ts",
+    "harness:run": "bun run packages/harness-cli/index.ts run",
+    "harness:sessions": "bun run packages/harness-cli/index.ts sessions",
+    "harness:inspect": "bun run packages/harness-cli/index.ts inspect",
+    "harness:doctor": "bun run packages/harness-cli/index.ts doctor",
+    "demos:studio": "cd apps/demos && bun run studio",
+    "demos:render": "cd apps/demos && bun run render:all",
+    "demos:media": "cd apps/demos && bun run media",
+    "debug": "bun run bin/debug.ts"
+  },
+  "workspaces": [
+    "apps/*",
+    "packages/*"
+  ],
+  "devDependencies": {
+    "@biomejs/biome": "^1.5.0",
+    "@changesets/cli": "^2.30.0",
+    "@napi-rs/canvas": "^0.1.97",
+    "@types/bun": "latest",
+    "@types/jsdom": "^28.0.0",
+    "@types/ws": "^8.18.1",
+    "bmad-method": "^6.1.0",
+    "typescript": "^5.0.0"
+  },
+  "dependencies": {
+    "@ai-sdk/openai-compatible": "^2.0.35",
+    "@mozilla/readability": "^0.6.0",
+    "@types/pdf-parse": "^1.1.5",
+    "@types/react": "^19.2.14",
+    "ai": "^6.0.116",
+    "better-sqlite3": "^12.8.0",
+    "cheerio": "^1.2.0",
+    "glob": "^13.0.6",
+    "ink": "^6.8.0",
+    "ink-big-text": "^2.0.0",
+    "ink-gradient": "^4.0.0",
+    "ink-select-input": "^6.2.0",
+    "ink-spinner": "^5.0.0",
+    "jsdom": "^28.1.0",
+    "miniflare": "^4.20260317.1",
+    "next": "^16.1.6",
+    "next-themes": "^0.4.6",
+    "node-pty": "^1.1.0",
+    "pdf-parse": "^2.4.5",
+    "sharp": "^0.34.5",
+    "stripe": "^17.7.0",
+    "tree-sitter": "^0.21.0",
+    "tree-sitter-go": "^0.21.0",
+    "tree-sitter-javascript": "^0.21.0",
+    "tree-sitter-python": "^0.21.0",
+    "tree-sitter-rust": "^0.21.0",
+    "tree-sitter-typescript": "^0.21.0",
+    "zod": "^4.3.6"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "James Spalding",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/8gi-foundation/8gent-code.git"
+  },
+  "homepage": "https://8gent.dev",
+  "bugs": {
+    "url": "https://github.com/8gi-foundation/8gent-code/issues"
+  }
+}