Merge pull request #11 from sameboat-platform/restore-main-fix

Establish v0.1.0 baseline; Restore main: reintroduce lost files.

Author: ArchILLtect

.eslintignore

@@ -0,0 +1,4 @@
+dist
+build
+coverage
+node_modules

.eslintrc.cjs

@@ -0,0 +1,38 @@
+module.exports = {
+    root: true,
+    env: { browser: true, es2021: true, node: true },
+    parser: "@typescript-eslint/parser",
+    parserOptions: {
+        ecmaVersion: "latest",
+        sourceType: "module",
+        project: false, // set to tsconfig.json if you later need type-aware rules
+        ecmaFeatures: { jsx: true },
+    },
+    plugins: ["@typescript-eslint", "react", "react-hooks", "jsx-a11y"],
+    extends: [
+        "eslint:recommended",
+        "plugin:@typescript-eslint/recommended",
+        "plugin:react/recommended",
+        "plugin:react-hooks/recommended",
+        "plugin:jsx-a11y/recommended",
+    ],
+    settings: {
+        react: { version: "detect" },
+    },
+    rules: {
+        // sensible defaults
+        "react/react-in-jsx-scope": "off", // Vite + React 17+ doesn’t need React in scope
+        "react/prop-types": "off", // we use TypeScript for types
+        "@typescript-eslint/explicit-module-boundary-types": "off",
+        // a11y nudges that are helpful in forms/links
+        "jsx-a11y/anchor-is-valid": "warn",
+        "jsx-a11y/no-autofocus": "warn",
+    },
+    ignorePatterns: [
+        "dist",
+        "build",
+        "node_modules",
+        "*.config.*",
+        "**/*.d.ts",
+    ],
+};

.gitattributes

@@ -0,0 +1,3 @@
+# .gitattributes
+.husky/**   text eol=lf
+*.sh        text eol=lf

.github/pull_request_template/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,32 @@
+# Pull Request
+
+## Summary
+
+Describe the change concisely.
+
+## Type of Change
+
+-   [ ] Feature
+-   [ ] Fix
+-   [ ] Refactor
+-   [ ] Documentation
+-   [ ] Chore / Internal
+
+## Changelog
+
+-   [ ] I added an entry under `[Unreleased]` in `CHANGELOG.md` (or this PR does not warrant a changelog line).
+
+## Testing
+
+Describe how you tested this (or include screenshots/logs if UI/behavioral change).
+
+## Checklist
+
+-   [ ] Types pass (`npm run typecheck`)
+-   [ ] Lint passes (`npm run lint`)
+-   [ ] Tests pass (`npm test`)
+-   [ ] No unused exports / dead code introduced
+
+## Follow-Up Tasks (Optional)
+
+List any deferred work.

.github/workflows/frontend-ci.yml

@@ -5,29 +5,7 @@ on:
         branches: [main]
     pull_request:
         branches: [main]
-    workflow_dispatch:
-        inputs:
-            node-version:
-                description: Node version
-                default: "20"
-                required: true
-                type: string
-            run-lint:
-                description: Run ESLint
-                default: true
-                type: boolean
-            run-typecheck:
-                description: Run TypeScript type check
-                default: true
-                type: boolean
-            run-tests:
-                description: Run unit tests (Vitest/Jest) with coverage if available
-                default: false
-                type: boolean
-            run-build:
-                description: Run production build
-                default: true
-                type: boolean
+    workflow_dispatch: {}
 
 permissions:
     contents: read
@@ -51,14 +29,13 @@ jobs:
             - name: Use Node.js
               uses: actions/setup-node@v4
               with:
-                  node-version: ${{ inputs.node-version || '20' }}
+                  node-version: 20
                   cache: npm
 
             - name: Install deps
               run: npm ci
 
             - name: Lint
-              if: ${{ inputs.run-lint != false }}
               run: |
                   if npm run -s | grep -q "^  lint"; then
                     npm run lint -- --format github
@@ -67,29 +44,33 @@ jobs:
                   fi
 
             - name: Typecheck
-              if: ${{ inputs.run-typecheck != false }}
               run: |
                   if npm run -s | grep -q "^  typecheck"; then
                     npm run typecheck
                   else
                     npx tsc --noEmit
                   fi
 
-            - name: Tests (Vitest/Jest)
-              if: ${{ inputs.run-tests }}
+            - name: Tests (Vitest)
               run: |
                   if npm run -s | grep -q "^  test"; then
-                    npx vitest --run --coverage || npm test -- --run
+                    npm run test
                   else
                     echo "No test script – skipping"
                   fi
 
+            - name: Changelog Check
+              run: |
+                  if npm run -s | grep -q "changelog:check"; then
+                    npm run changelog:check || (echo "\nChangelog check failed." && exit 1)
+                  else
+                    echo "No changelog:check script – skipping"
+                  fi
+
             - name: Build
-              if: ${{ inputs.run-build != false }}
               run: npm run build
 
             - name: Upload build artifact (dist/)
-              if: ${{ inputs.run-build != false }}
               uses: actions/upload-artifact@v4
               with:
                   name: web-dist
@@ -98,7 +79,6 @@ jobs:
                   retention-days: 7
 
             - name: Upload coverage (if generated)
-              if: ${{ inputs.run-tests }}
               uses: actions/upload-artifact@v4
               with:
                   name: coverage
@@ -107,39 +87,27 @@ jobs:
                       coverage/**/*
                   if-no-files-found: ignore
                   retention-days: 7
-
-    # netlify-deploy:
-    #   name: Netlify deploy
-    #   needs: build-test
-    #   runs-on: ubuntu-latest
-    #   if: >
-    #     (github.event_name == 'pull_request') ||
-    #     (github.event_name == 'workflow_dispatch' && github.ref == 'refs/heads/main')
-    #   steps:
-    #     - name: Download build artifact
-    #       uses: actions/download-artifact@v4
-    #       with:
-    #         name: web-dist
-    #         path: dist
-    #
-    #     - name: Install Netlify CLI
-    #       run: npm i -g netlify-cli
-    #
-    #     - name: Deploy preview (PR) or prod (manual on main)
-    #       env:
-    #         NETLIFY_AUTH_TOKEN: ${{ secrets.NETLIFY_AUTH_TOKEN }}
-    #         NETLIFY_SITE_ID: ${{ secrets.NETLIFY_SITE_ID }}
-    #       run: |
-    #         if [ "${{ github.event_name }}" = "pull_request" ]; then
-    #           netlify deploy \
-    #             --dir=dist \
-    #             --site="$NETLIFY_SITE_ID" \
-    #             --auth="$NETLIFY_AUTH_TOKEN" \
-    #             --message "PR #${{ github.event.pull_request.number }}" \
-    #             --draft --json
-    #         else
-    #           netlify deploy \
-    #             --dir=dist \
-    #             --site="$NETLIFY_SITE_ID" \
-    #             --auth="$NETLIFY_AUTH_TOKEN" \
-    #             --prod --message "manual main" --json
+        #         name: web-dist
+        #         path: dist
+        #
+        #     - name: Install Netlify CLI
+        #       run: npm i -g netlify-cli
+        #
+        #     - name: Deploy preview (PR) or prod (manual on main)
+        #       env:
+        #         NETLIFY_AUTH_TOKEN: ${{ secrets.NETLIFY_AUTH_TOKEN }}
+        #         NETLIFY_SITE_ID: ${{ secrets.NETLIFY_SITE_ID }}
+        #       run: |
+        #         if [ "${{ github.event_name }}" = "pull_request" ]; then
+        #           netlify deploy \
+        #             --dir=dist \
+        #             --site="$NETLIFY_SITE_ID" \
+        #             --auth="$NETLIFY_AUTH_TOKEN" \
+        #             --message "PR #${{ github.event.pull_request.number }}" \
+        #             --draft --json
+        #         else
+        #           netlify deploy \
+        #             --dir=dist \
+        #             --site="$NETLIFY_SITE_ID" \
+        #             --auth="$NETLIFY_AUTH_TOKEN" \
+        #             --prod --message "manual main" --json

.gitignore

@@ -26,4 +26,7 @@ dist-ssr
 # local env
 .env
 .env.*
-!.env.example
+!.env.example
+
+# Agent Reports
+agent-reports

.husky/commit-msg

@@ -0,0 +1,2 @@
+#!/usr/bin/env sh
+npx --no-install commitlint --edit "$1"

.husky/pre-commit

@@ -0,0 +1 @@
+npm test

CHANGELOG.md

@@ -0,0 +1,87 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+Format loosely follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and (once stabilized) will align with [Semantic Versioning](https://semver.org/) for tagged releases.
+
+## [Unreleased]
+
+### Added
+- Nothing yet.
+
+### Changed
+- Nothing yet.
+
+### Fixed
+- Nothing yet.
+
+### Documentation
+- Nothing yet.
+
+### Internal
+- Nothing yet.
+
+### Notes
+- Nothing yet.
+
+## [0.1.0] - 2025-10-02
+
+> Initial structured milestone capturing Week 3 outcomes (auth + UI/UX + tooling baseline).
+
+### Added
+- Auth pages: Login, Register, Me (protected) with Chakra-based forms.
+- Central `AuthProvider` with single guarded bootstrap (`/api/me`).
+- Error mapping layer (`errors.ts`) with friendly codes (BAD_CREDENTIALS, EMAIL_EXISTS, etc.).
+- User normalization (role→roles[], displayName inference).
+- ProtectedRoute gating + framer-motion route/state transitions.
+- Health check card with interval polling, skeleton debounce, manual refresh.
+- Runtime Debug Panel (collapsible, probe history, copy helpers, error count, reduced-motion respect).
+- Chakra theme (dark mode default), selective component integration (Cards, Alerts, Buttons, Badges).
+- Sticky footer with version + commit hash + feedback link.
+- Environment variable typings (`vite-env.d.ts`).
+- Release automation script (`scripts/release.mjs`).
+- Changelog enforcement script (`scripts/check-changelog.mjs`).
+- Husky integration & commitlint hook enforcement.
+- Conventional commit rules (`commitlint.config.cjs`).
+- Vitest coverage thresholds (50%).
+- Developer Workflow Checklist (`docs/developer-workflow-checklist.md`).
+- Coverage & workflow docs surfaced in README / architecture.
+- CI enhancements (tests default, coverage gate, changelog step, ordered pipeline).
+
+### Changed
+- Layout refactored to full-height flex shell (`AppShell`) with sticky footer.
+- Forms migrated from basic HTML to Chakra primitives with inline validation.
+- Me page enhanced (avatar placeholder, role badges, grouped sections).
+- `README.md`: workflow, coverage threshold, release script, Husky/commitlint details, expanded scripts table.
+- `docs/architecture.md`: CI pipeline order clarity, tooling extension point, release automation details.
+- `TTD.md`: Expanded workflow/tooling backlog (test guard, auto-labeling, feature test heuristics).
+
+### Documentation
+- README: Auth lifecycle, runtime debug panel, planning artifacts.
+- `architecture.md`: Auth lifecycle, transitions, planning references.
+- Week 3 progress checklist (percent metrics & blockers).
+- Week 4 draft plan scaffold.
+- Developer workflow appendix (git hooks, commit message enforcement) & planning/workflow links.
+
+### Internal / Tooling / Dev Experience
+- Structured fetch wrapper (`api.ts`) with typed generics and error cause propagation.
+- Optional verbose auth bootstrap logging via `VITE_DEBUG_AUTH*` flags.
+- ESLint configuration tightened (import sorting / a11y plugins; explicit `lint` / `lint:fix`).
+- Standardized test invocation (`npm run test`) for coverage gating.
+- Added `release`, `changelog:check`, and `lint:fix` scripts to `package.json`.
+- Implemented `prepare` script for automatic Husky hook install.
+
+### Notes
+- Testing breadth still partial (protected route + basic form validation only).
+- Next minor release (`0.2.0`) will focus on auth test gap closure + first resilience enhancement (pause-on-error health polling or reduced-motion toggle).
+- Patch release pathway (`0.1.x`) available if urgent fixes needed.
+
+---
+
+Guidelines:
+
+-   Start new entries under [Unreleased]; move them into a dated version section when cutting a release (and optionally tagging in git).
+-   Group changes under: Added / Changed / Fixed / Removed / Deprecated / Security / Docs / Internal as needed.
+
+[Unreleased]: https://github.com/sameboat-platform/frontend/compare/0.1.0...HEAD
+[0.1.0]: https://github.com/sameboat-platform/frontend/tree/0.1.0