# Session Handoff: Nuxt Repo Replacement & CI Fixes
**Date:** 2026-03-20
**Session Focus:** Replace Quasar source with Nuxt in bab-app repo; fix CI pipeline
**Context at Handoff:** Medium — migration complete, CI pipeline passing, app deploying

## What Was Accomplished

### 1. Quasar → Nuxt repo replacement (nuxt_test branch)
Lifted `bab-app-nuxt/` (sibling dir) into `bab-app/` root, replacing all Quasar artifacts.

**Deleted from root:**
- `src/`, `src-pwa/`, `.quasar/`, `dist/`, `node_modules/`
- `quasar.config.ts`, `quasar.extensions.json`, `index.html`, `postcss.config.cjs`, `eslint.config.js`, `tsconfig.vue-tsc.json`, `.npmrc`, `nohup.out`

**Added to root:**
- `app/`, `tests/`, `public/` (nuxt versions)
- `nuxt.config.ts`, `vitest.config.ts`, `tsconfig.json` (nuxt versions)
- `package.json`, `yarn.lock` (nuxt versions)

**Updated:**
- `generate-version.cjs` — removed `src/version.ts` write; path changed from `bab-app-nuxt/app/utils/version.ts` → `app/utils/version.ts`
- `.releaserc.json` — removed `cd bab-app-nuxt &&`; fixed `.output/public` path; changed `npm run generate-version` → `node generate-version.cjs`; fixed `::set-output::` → `$GITHUB_OUTPUT`
- `.gitea/workflows/build.yaml` — `bab-app-nuxt/.env` → `.env`
- `.gitignore` — replaced with Nuxt version (kept `VERSION`, `release-*.gz`, `CHANGELOG.md`)

### 2. Pre-commit hook (husky)
- Added `husky`, `vue-tsc` to devDependencies
- Added `prepare: husky` and `typecheck: nuxt typecheck` scripts
- `.husky/pre-commit` runs `yarn typecheck`
- Note: `yarn test` excluded — only test file is live Appwrite integration test, not suitable for pre-commit

### 3. Semantic-release plugins
- Added all plugins to devDependencies (were missing from nuxt package.json): `semantic-release`, `@semantic-release/changelog`, `@semantic-release/commit-analyzer`, `@semantic-release/release-notes-generator`, `@semantic-release/exec`, `@saithodev/semantic-release-gitea`
- Changed `npx semantic-release` → `yarn semantic-release` in build.yaml

### 4. CI pipeline fixes (iterative)
- Removed `cache: 'yarn'` from setup-node (yarn not available yet at that step)
- Added `node_modules` cache via `actions/cache@v4`, keyed on `yarn.lock` hash; install skips on cache hit
- Replaced `workflow-webhook` action with direct `curl` — action was sending `X-Hub-Signature`/`X-GitHub-Event` headers that caused AAP EDA 403
- Fixed `Authorization: Bearer Token:***` → `Authorization: Bearer ***` (removed redundant `Token:` prefix)
- Added `if: steps.build.outputs.VERSION != ''` to webhook step
- Replaced `--fail-with-body` (curl too old on runner) with `-w "\n%{http_code}"` pattern that prints body + status and fails on non-2xx
- Added `$GITHUB_OUTPUT` for VERSION output (replaced deprecated `::set-output::`)

### 5. nuxt.config.ts
- Added `vite.optimizeDeps.include` for `@vue/devtools-core`, `@vue/devtools-kit`, `appwrite`, `@quasar/quasar-ui-qcalendar` to prevent dev server page reloads

## Current State

- `nuxt_test` branch: Nuxt app is the only source in the repo root
- CI pipeline: passes on push to `alpha`/`devel`/`main`
- `node_modules` cache: working (Gitea cache confirmed operational)
- Webhook: working — direct curl to AAP EDA event stream
- App deploying but showing runtime error (see open questions)

## Open Questions

- [ ] **OPEN**: `ENV_FILE` Gitea variable likely has old Quasar env var names. Nuxt expects `NUXT_PUBLIC_APPWRITE_ENDPOINT` and `NUXT_PUBLIC_APPWRITE_PROJECT_ID`. Update in Gitea → Repo Settings → Actions → Variables.
- [ ] **OPEN**: `.env.local` at repo root should be renamed to `.env` for local Nuxt 4 dev (Nuxt 4 loads `.env`, not `.env.local`).
- [ ] **OPEN**: `nuxt_test` branch ready to merge to `main` once ENV_FILE is fixed and smoke test passes.
- [ ] **OPEN**: Appwrite SDK deprecated API calls (TS6387) — migrate to v14+ signatures.
- [ ] **OPEN**: `task`/`taskTags`/`skillTags` collections — not yet created in `bab_prod`.

## Key File Paths

- `.gitea/workflows/build.yaml` — CI pipeline
- `.releaserc.json` — semantic-release config
- `generate-version.cjs` — writes VERSION to `VERSION` and `app/utils/version.ts`
- `.husky/pre-commit` — runs `yarn typecheck`
- `nuxt.config.ts` — Nuxt config with optimizeDeps
- `app/plugins/appwrite.client.ts` — throws console.error (not exception) when env vars missing

## Next Session

1. Update `ENV_FILE` in Gitea to use Nuxt var names
2. Trigger a build and smoke test the deployed app
3. Merge `nuxt_test` → `main`