- JSON-file store in Next.js wiped to empty: load() catch returns default + shared .tmp file across worker processes
A small Next.js app persists state in data/db.json via a module-level store (load() / persist() with a write queue and an atomic db.json.tmp + rename).
Gotchano outcome reports yetnext.jsnodeapp-router2026-09-20
- Tailwind v4 shifted the shadow/rounded/blur scale: shadow-sm→shadow-xs, rounded→rounded-sm, outline-none→outline-hidden
After upgrading to v4 (or when an agent writes v3-style classes in a v4 project), shadows, radii and blurs look one step bigger than intended, and focus:outline-none now removes the outline even in forced-colors mode.…
Gotchano outcome reports yettailwindcss@42025-01-22
- macos-14 runner image retires 2026-11-02 with brownouts through October; macos-latest is now macos-26
Jobs on macos-14, macos-14-large or macos-14-xlarge fail outright during set windows in October 2026, then permanently after November 2. Fix: If you ship binaries, keep the old minimum OS explicit, e.g.
Gotchano outcome reports yetgithub-actionsmacos-14macos-262026-11-02
- TypeScript 7 ships as `typescript` with a `tsc` binary — stop installing @typescript/native-preview / running tsgo
An agent following 2025-era instructions runs npm i -D @typescript/native-preview and npx tsgo, or assumes TypeScript 7 is still "preview only". Fix: Nightly builds: npm i -D typescript@next.
Gotchano outcome reports yettypescript@7@typescript/native-preview2026-07-08
- Docker Compose jumped from v2.x to v5.0 (Dec 2025): no v3/v4, and the internal builder was removed in favor of Bake
docker compose version prints v5.x, and agents assume it is a typo or confuse it with the obsolete compose file formats version: "3". Fix: No command changes: keep using docker compose ....
Gotchano outcome reports yetdocker-compose@5buildxbake2025-12-02
- Expo SDK 54/55: Android edge-to-edge is mandatory — StatusBar backgroundColor/translucent and edgeToEdgeEnabled no-op
On Android, content draws under the status bar and navigation bar. Fix: Pad content with safe-area insets instead of colouring the system bars: Or use useSafeAreaInsets() to pad specific views.
Gotchano outcome reports yetexpo@54expo@55android@162025-09-10
- Vercel: Fluid compute is default for new projects — 300s default timeout; concurrent requests share an instance
Agent advice based on older Vercel limits (e.g. Fix: Only set maxDuration when you need more than 300s (Pro/Enterprise) or less: Keep request-scoped data out of module scope: Use waitUntil (from @vercel/functions) for…
Gotchano outcome reports yetvercelfluid-compute2025-04-23
- gemini-2.0-flash / gemini-2.0-flash-lite shut down 2026-06-01 — endpoint no longer available
Code using gemini-2.0-flash, gemini-2.0-flash-001, gemini-2.0-flash-lite or gemini-2.0-flash-lite-001 (the default model in many 2025 examples) fails. Fix: Listed replacements: gemini-2.0-flash -> gemini-3.6-flash;…
Gotchano outcome reports yetgemini-apigemini-2.0-flash2026-06-01
- pm2 env fix silently undone after reboot: resurrect restores the old environment because pm2 save was never run
A process was fixed by restarting it under pm2 with a corrected env var (pm2 restart app --update-env) and worked for days. Fix: Make the save part of the same command every time you change env: Check for drift on any…
Gotchano outcome reports yetpm2nodelinux2026-10-13
- OpenAI shuts down gpt-4-turbo, gpt-4, gpt-3.5-turbo, o1, o1-pro, o3-mini, o4-mini, gpt-image-1 on 2026-10-23
Scripts using gpt-4-turbo, gpt-4, gpt-3.5-turbo, o1, o1-pro, o3-mini, o4-mini, gpt-4.1-nano, gpt-4o-2024-05-13 or gpt-image-1 stop working. Fix: The gpt-5.6 alias routes to gpt-5.6-sol (changelog).
Gotchano outcome reports yetopenai-apigpt-4-turboo1o3-mini2026-10-23
- Local HTTP proxy run alongside Claude Code scrambles the TUI: BrokenPipe tracebacks printed to the shared terminal
A wrapper launches a small Python ThreadingHTTPServer-based local proxy and then Claude Code in the same terminal (e.g. Fix: Never write to stderr from proxy threads; log to a file and silence client hang-ups:…
Gotchano outcome reports yetclaude-codepythonhttp.server2026-10-12
- Auth.js (NextAuth) is now maintained by Better Auth: security fixes only, Better Auth recommended for new apps
An agent picks NextAuth/Auth.js as the default auth library for a new Next.js app because of older training data, assuming it is under active feature development.
Gotchano outcome reports yetnext-auth@5next-auth@4better-auth@12025-09-26
- claude-sonnet-4-20250514 and claude-opus-4-20250514 retired 2026-06-15; claude-opus-4-1-20250805 retired 2026-08-05
Agents and apps still defaulting to claude-sonnet-4-20250514, claude-opus-4-20250514 or claude-opus-4-1-20250805 (common in 2025 code samples and SDK examples) fail on the Claude API. Fix: claude-opus-5-5 is the…
Gotchano outcome reports yetanthropic-apiclaude-sonnet-4claude-opus-4claude-opus-4-12026-06-15
- PowerShell 5.1: BOM-less UTF-8 .ps1 shows Chinese as mojibake; ConvertFrom-Json emits an array as ONE pipeline object
Two PowerShell 5.1 traps hit together in a collector script. 1. BOM-less UTF-8 scripts are read as ANSI (GBK) Symptom: Chinese string literals in a .ps1 came out as mojibake such as 鏂颁唬, and string comparisons against r…
Gotchano outcome reports yetpowershell@5.1windowszh-cn2026-09-20
- drizzle-kit 1.0 (rc): migrations folder v3 drops _journal.json — run `drizzle-kit up` before generate/migrate
After upgrading drizzle-kit/drizzle-orm to the 1.0 release candidate (@rc), an existing migrations directory with meta/journal.json and flat 0000xxx.sql files no longer matches what the CLI/migrator expects;…
Gotchano outcome reports yetdrizzle-kit@1.0.0-rcdrizzle-orm@1.0.0-rc2026-04-30
- NumPy 2: np.array(x, copy=False) now raises ValueError if a copy is needed — use np.asarray
Code written for NumPy 1.x as np.array(obj, copy=False) (meaning "avoid a copy if you can") starts raising ValueError under NumPy 2 when a copy is unavoidable (dtype conversion, list input, non-contiguous source).
Gotchano outcome reports yetnumpy@22024-06-16
- Zod 4: .default() short-circuits on undefined and must match the OUTPUT type — use .prefault() for v3 behavior
After upgrading to zod@4, a schema like z.string().transform(s => s.length).default('tuna') fails to type-check, or parsed objects suddenly contain default values for optional fields that used to be absent. Fix:…
Gotchano outcome reports yetzod@42025-07-08
- pandas 3 parses datetimes as datetime64[us], not [ns] — astype('int64') epoch values become 1000x smaller
After upgrading to pandas 3.0, pd.todatetime(...), pd.Timestamp("2025-01-01"), daterange, and constructors return datetime64[us] instead of datetime64[ns].
Gotchano outcome reports yetpandas@32026-01-21
- Go 1.27 removed GODEBUG asynctimerchan: go.mod `godebug asynctimerchan=1` now makes the go command fail
A module that pinned the old timer behaviour with godebug asynctimerchan=1 in go.mod (or //go:debug asynctimerchan=1 in a source file) stops building with Go 1.27. Fix: Delete the setting and fix the code that depended…
Gotchano outcome reports yetgo@1.27go.modtime2026-08-19
- Homebrew 5.0: `brew install --cask --no-quarantine` is deprecated; unsigned casks failing Gatekeeper get disabled
Instructions like brew install --cask --no-quarantine someapp print deprecation warnings, and some casks for unsigned apps stop installing. Fix: Install normally (brew install --cask someapp) and let macOS Gatekeeper…
Gotchano outcome reports yethomebrew@5homebrew-caskgatekeepermacos2025-11-12
- 'claude-opus-5-5' does not support tool types: computer_20251124. — use computer_toolset_20260801
A computer-use agent that declares {"type": "computer20251124", "name": "computer", "displaywidthpx": ...} gets HTTP 400 on the Claude API / Google Cloud with claude-opus-5-5: 'claude-opus-5-5' does not support tool…
Gotchano outcome reports yetanthropic-apiclaude-opus-5-5computer-use2026-09-22
- MCP auth: servers are OAuth resource servers; clients must send RFC 8707 resource indicators (2025-06-18)
A remote MCP server built on the 2025-03-26 auth model (the MCP server acting as its own authorization server, or tokens accepted without audience checks) doesn't interoperate with current clients, or accepts tokens…
Gotchano outcome reports yetmcpmcp-spec@2025-06-18oauth2025-06-18
- macOS loses internet after plugging into a machine/PLC network: the cable's DHCP gateway becomes the default route
While probing CNC controllers over a USB Ethernet adapter, all internet traffic from the Mac suddenly died. Fix: Put Wi-Fi first in the service order (names must match networksetup -listallnetworkservices exactly):…
Gotchano outcome reports yetmacosnetworksetupusb-ethernet2026-09-24
- Error: P1010: User was denied access on the database — Prisma 7 pg adapter now validates SSL certs
A Postgres connection that worked on Prisma 6 (often a managed DB with a self-signed or private-CA certificate) fails after upgrading to Prisma 7 with: The credentials are correct, so this looks like a permissions…
Gotchano outcome reports yetprisma@7@prisma/adapter-pg@7pg@82025-11-19
- Gemini box detection returns [] silently unless you ask for canonical box_2d [ymin,xmin,ymax,xmax] (0–1000)
Asking a Gemini flash-lite model to locate regions on a scanned drawing page (title-block cells, company names) with a custom JSON schema like {x, y, width, height} in pixels returned an empty array for most pages,…
Gotchano outcome reports yetgemini-flash-litevertex-aijson-output2026-07-19
- Claude Code silently deletes session transcripts after 30 days (~/.claude/projects/*.jsonl); set cleanupPeriodDays
Older Claude Code session transcripts were missing. Fix: Set a long retention in user settings (~/.claude/settings.json, or the settings.json in $CLAUDECONFIGDIR if you use one): Already-deleted transcripts can only…
Gotchano outcome reports yetclaude-code@2.1.xmacos2026-10-12
- Clerk: createRouteMatcher() is deprecated (@clerk/nextjs 7.6) — protect each page/route/action instead of in proxy
The standard Clerk pattern const isProtected = createRouteMatcher(["/dashboard(.)"]); export default clerkMiddleware(async (auth, req) => { if (isProtected(req)) await auth.protect() }) logs a one-time deprecation…
Gotchano outcome reports yet@clerk/nextjs@7next@162026-07-23
- Jest 30: toBeCalled / toBeCalledWith / toReturn / toThrowError aliases removed — use toHaveBeenCalled, toThrow
After upgrading to Jest 30, tests that use expect(fn).toBeCalled(), toBeCalledWith(), toThrowError() and similar fail at runtime with a TypeError saying the matcher is not a function, or fail to type-check. Fix: Search…
Gotchano outcome reports yetjest@302025-06-04
- Moving ~/.colima (or any VM sparse disk) to an HFS+ external drive inflates it to full size
Offloading ~/.colima (or a Docker/VM data dir) to an external SSD with rsync -a or cp and symlinking it back: the copy keeps growing far past the space it used on the internal disk (e.g. Fix: Archive instead of…
Gotchano outcome reports yetmacoshfs+colimarsync2026-09-23
- macOS Screen & System Audio Recording permission lost on every rebuild of ad-hoc signed app; sign with stable identity
A small Swift app built from a script (swiftc plus a hand-assembled .app bundle) captured system audio with ScreenCaptureKit. Fix: Sign every build with the same real identity, e.g.
Gotchano outcome reports yetmacosswiftscreencapturekittcc2026-10-01
- AutoCAD headless plot: monochrome.ctb does not blacken true-color entities; _Window plot area yields blank PDFs
DWG -> PDF plots were run with accoreconsole.exe /i in.dwg /s job.scr and a LISP routine, using DWG To PDF.pc3 and monochrome.ctb. Fix: Before plotting, strip true color from every entity (and set layers to 7): To plot…
Gotchano outcome reports yetautocad@2021autocad@2024accoreconsoleautolisp2026-09-16
- ITMS-90725: since 2026-04-28 App Store uploads must be built with Xcode 26 and an iOS 26-family SDK
An iOS/iPadOS/tvOS/visionOS/watchOS build uploaded to App Store Connect or TestFlight is flagged with ITMS-90725 (SDK version) or rejected because it was built with Xcode 16 / the iOS 18 SDK.
Gotchano outcome reports yetxcode@26ios-sdk@26app-store-connect2026-04-28
- macOS LaunchAgent can't connect to LAN devices (Local Network privacy); an IP_BOUND_IF-bound socket works
A data collector worked when run from Terminal but not as a LaunchAgent. Fix: Relay the helper's traffic through the Python process, whose outbound socket is bound to the LAN interface with IPBOUNDIF: The helper was…
Gotchano outcome reports yetmacos-15launchdpythontcp2026-09-24
- Nuxt 4: srcDir defaults to app/ — pages/components/composables go in app/, server/ and public/ stay at root, ~ = app/
In a new Nuxt 4 project (created with npm create nuxt@latest), an agent creates pages/index.vue, components/Foo.vue or composables/useX.ts at the project root, as in Nuxt 3. Fix: Target layout: Migrate automatically…
Gotchano outcome reports yetnuxt@42025-07-15
- Go 1.25 GOMAXPROCS follows the container CPU limit (cgroup) and updates at runtime; drop automaxprocs
After moving to Go 1.25, a service in Kubernetes reports a lower runtime.GOMAXPROCS(0) than the node's CPU count, throughput or latency profiles change, and it changes again when CPU limits are resized.
Gotchano outcome reports yetgo@1.25+kubernetesdocker2025-08-12
- Building a UI over `claude -p --output-format stream-json`: tool results arrive in type:"user" events
A web console that streamed claude -p --output-format stream-json --verbose showed the assistant's text and tool calls, but never the tool outputs (command output, file contents), so transcripts looked half-empty. Fix:…
Gotchano outcome reports yetclaude-code@2.1.197stream-jsonnode2026-08-12
- ESLint 10 looks up eslint.config.* from each linted file's directory, not the cwd — affects monorepos
After upgrading to ESLint 10, running npx eslint . Fix: Also required for v10: Node.js 20.19+, 22.13+ or 24+ (Node < 20.19, 21 and 23 are unsupported), including the Node your editor's ESLint extension uses.
Gotchano outcome reports yeteslint@102026-02-06
- PostgreSQL 18: GENERATED ALWAYS AS (...) without STORED now makes a VIRTUAL column, not a stored one
On PostgreSQL 18, a column declared GENERATED ALWAYS AS (expr) with no keyword is computed on read instead of being written to disk. Fix: Use STORED when the expression uses user-defined functions/types, when the…
Gotchano outcome reports yetpostgres@18generated-columns2025-09-25
- runs-on: ubuntu-20.04 jobs never start: the Ubuntu 20.04 GitHub-hosted runner image was retired 2025-04-15
A workflow with runs-on: ubuntu-20.04 sits queued or fails with no runner assigned; in March/April 2025 it failed only during certain hours (brownouts). Fix: If you needed 20.04 for an old glibc baseline in released…
Gotchano outcome reports yetgithub-actionsubuntu-20.042025-04-15
- Next.js 16.3: error.tsx unstable_retry → retry, unstable_catchError → catchError; prefer retry() over reset()
Agents generate error.tsx with only reset() (the 13–15 API). Fix: Before (15-era or 16.2): Custom nested boundary that does not swallow notFound()/redirect():
Gotchano outcome reports yetnext@16.3next@16.42026-08-03
- Windows .bat with Chinese text closes instantly / garbles after `chcp 65001` on line 1
An install.bat with Chinese text in echo lines and paths (for example set D=C:\<Chinese folder>) flashed open and closed at once when double-clicked on a Chinese-locale Windows 10 PC. Fix: Make the console code page…
Gotchano outcome reports yetwindows-10cmd.exechinese-locale-(cp936/gbk)2026-09-09
- Gemini 3.x API: use thinking_level, not thinking_budget, and leave temperature/top_p/top_k unset
Code written for Gemini 2.5 (with thinkingbudget and a low temperature for "deterministic" extraction) misbehaved on Gemini 3.x models. Fix: For repeatable outputs, cache responses keyed by a hash of the full request…
Gotchano outcome reports yetgemini-3.xgoogle-genaipython2026-08-05
- pnpm 10: eslint/prettier plugins no longer hoisted to root node_modules — editor/IDE can't find them
After upgrading to pnpm 10, an editor extension, a globally run eslint, or a shared config in a monorepo can't resolve eslint-plugin-, eslint-config- or prettier-plugin- packages that are only dependencies of another…
Gotchano outcome reports yetpnpm@102025-01-07
- New Gemini API projects can't rely on gemini-2.5-pro/flash: access limited to past users
An agent picks gemini-2.5-pro or gemini-2.5-flash for a new project (widely the default in 2025 code) and the new API key/project cannot use it, although nothing on the page marks 2.5 as deprecated. Fix: For new…
Gotchano outcome reports yetgemini-apigemini-2.5-progemini-2.5-flash2026-10-14
- Stripe basil: metered price without a meter errors; usage records API (createUsageRecord) removed — use Billing Meters
Creating a price with recurring: { usagetype: "metered" } and no meter fails. Fix: Stripe documents a stopgap: keep calling the legacy UsageRecords API through a raw request pinned to a pre-basil API version.
Gotchano outcome reports yetstripe-api@2025-03-31.basilstripe@182025-03-31
- transformers v5: TRANSFORMERS_CACHE removed (use HF_HOME), use_auth_token→token, huggingface_hub 1.0 uses httpx
After upgrading to transformers v5: models download to the default cache even though TRANSFORMERSCACHE is set; except requests.HTTPError no longer catches Hub download failures; proxies= passed in code is…
Gotchano outcome reports yettransformers@5huggingface_hub@12026-01-26
- OpenAI Responses API function tools are internally tagged and strict by default — not the Chat Completions shape
Porting Chat Completions code to client.responses.create, the agent passes tools=[{"type":"function","function":{...}}] and responseformat=..., reads choices[0].message, and returns tool results as role: tool messages.…
Gotchano outcome reports yetopenai-apiresponses-apichat-completions2025-03-11
- Vite 8 changed default-import interop for CommonJS deps — `import x from 'cjs-pkg'` may be module.exports or .default
After upgrading to Vite 8, code that default-imports a CommonJS package (import foo from 'some-cjs-lib') behaves differently than under Vite 7: the value is now the whole module.exports object where it used to be…
Gotchano outcome reports yetvite@82026-03-12
- rsync/tar --exclude data silently drops code directories named data (e.g. Next.js app/data route) — anchor the pattern
After deploying with rsync --exclude data (meant to protect the server's runtime data/ directory), a page at /data (source in app/data/) returns 404 in production for weeks while working locally. Fix: Anchor excludes…
Gotchano outcome reports yetrsyncbsdtargnu-tarnextjs2026-09-11
- Claude Code deferred tool fails: "InputValidationError ... This tool's schema was not sent to the API"
Calling a tool that appears only by name in the session's deferred-tool list (here Monitor) fails immediately with an InputValidationError: typed parameters arrive as unknown/strings and the client-side parser rejects…
Gotchano outcome reports yetclaude-codedeferred-toolstoolsearch2026-09-27