Repository Guidelines (for Codex)

Mission

You are auditing and stabilizing this Next.js 15 + TypeScript project. Goal: get a clean production build + fix known UI bugs (Time Planner / Goals / Projects) with minimal, verified diffs.

Project Structure & Module Organization

• Next.js app lives in src/; main route: src/app/page.tsx.
• UI components: src/components/
• Domain logic (auth/db/audio): src/lib/
• Firebase config: src/config/
• Utilities: src/utils/
• Styles: src/styles/ + src/app/globals.css
• Types: src/types/
• Static assets: public/
• Build output: out/ (do not edit manually)

Working Rules (IMPORTANT)

1. Phase 1 = Audit (Read Only): map the codebase folder-by-folder, identify issues, propose plan.
2. Phase 2 = Fixes: apply ONE fix at a time, then validate (build/lint/tests) before moving on.
3. Prefer minimal diffs. Avoid refactors unless necessary to fix the bug.
4. After each fix: run /review in Codex and rerun the failing command(s).
5. Do not change product behavior unless explicitly required by a bug fix.

Known P0 Build Breaker (must fix first)

• npm run build fails: ./src/components/OKRManager.tsx:906:8 TypeScript error: "Block-scoped variable 'KeyResultEditModal' used before its declaration." JSX uses <KeyResultEditModal /> around that line. Fix requirement: npm run build must pass.

Known Functional Bugs (must reproduce + fix)

Time Planner

• Clicking "Add Block" does not add/show any Time Block.
• Expected: a new block appears immediately and persists (depending on storage layer).

Goals / Projects

• Creating a Goal or a Project does not add it (no visible update / no persistence).

Definition of Done

• npm run build succeeds.
• Time Planner "Add Block" works (UI updates + data persists consistently).
• Goals & Projects creation works (UI updates + data persists consistently).
• No new TypeScript errors introduced; lint passes if available.
• Changes are small and well explained.

Commands (use in this order; stop at first failure and diagnose)

• Install: npm install
• Lint: npm run lint (if available)
• Tests: npm test (if available)
• Build: npm run build
• Dev: npm run dev and reproduce UI bugs (Time Planner / Goals / Projects)

Debugging Approach

• When a UI action does nothing, trace:
  1. UI handler/onClick wiring
  2. state update path (React state/store)
  3. persistence (localStorage/Firebase/IndexedDB/etc.)
  4. rendering conditions (filters, date ranges, selected view)
  5. errors in console/logs and failed network calls (if any)

Coding Style & Naming

• TypeScript + React hooks; follow existing patterns.
• 2-space indentation, single quotes, trailing commas.
• PascalCase for components, camelCase for functions/vars, UPPER_SNAKE_CASE constants.
• Prefer @/ absolute imports.

Security & Configuration

• Firebase config in src/config/firebaseConfig.ts.
• Do not commit secrets; prefer env vars for any new sensitive config.