Update the documentation to accurately reflect the current behavior of the codebase.
- Expand `npm run lint` description in `README.md` and `CONTRIBUTING.md` to include file size, innerHTML, assets, and SW compat checks.
- Add `test:visual`, `test:visual:update`, `test:dm:unit`, and `test:dm:integration` to the "Testing" section in `README.md`.
- Clarify `npm start` behavior in `README.md` regarding port selection.
- Reformat "Testing" section in `README.md` for better readability.
Co-authored-by: PR0M3TH3AN <[email protected]>
Audited the onboarding process and confirmed all steps pass.
Added .npmrc with engine-strict=true to enforce Node.js >=22 requirement.
Updated CONTRIBUTING.md and README.md to explicitly mention the Node version requirement and its enforcement.
Added artifacts/ONBOARDING_REPORT.md with the audit report.
Co-authored-by: PR0M3TH3AN <[email protected]>
- Added `engines` field to `package.json` to enforce Node.js >=22.
- Updated `CONTRIBUTING.md` to specify prerequisites and clarify build commands.
- Created `ONBOARDING_REPORT.md` with audit findings.
Co-authored-by: PR0M3TH3AN <[email protected]>
Updates README.md and CONTRIBUTING.md to accurately reflect:
- `npm run build` performs a full production build (cleans dist/, copies assets).
- `npm run format` targets CSS, HTML, and MD, but excludes JS.
- `npm run lint` includes token and Tailwind checks.
- `npm start` runs the production build and serves it.
- Default port (3000) behavior.
Fixes ambiguous and incomplete documentation regarding build scripts and developer commands.
Co-authored-by: PR0M3TH3AN <[email protected]>
Updates `README.md` and `CONTRIBUTING.md` to explicitly mention the availability of `test:unit:shard1`, `shard2`, and `shard3`, ensuring the documentation accurately reflects the sharding configuration defined in `package.json`. This provides developers with clear options for running subsets of unit tests.
Co-authored-by: PR0M3TH3AN <[email protected]>
Updates CONTRIBUTING.md and README.md to accurately reflect that:
- `npm start` builds to and serves the `dist/` directory.
- `npm run format` targets CSS, HTML, MD, and config (not JS logic).
- `npm run lint` targets styles, tokens, and hex codes (no ESLint).
- Manual build steps should serve `dist` via `npx serve dist`.
Co-authored-by: PR0M3TH3AN <[email protected]>
- Update `README.md` example to clarify 's' tag auto-generation.
- Update `CONTRIBUTING.md` with explicit `npm run lint` details and new "Event Schema Validation" section.
- Verified all documentation against codebase.
Co-authored-by: PR0M3TH3AN <[email protected]>
- Update `README.md`:
- Change `npm install` to `npm ci` for consistent setup.
- Add "Quick Reference" section for common commands.
- Explicitly label the video post example as "Quickstart: Send your first video post" and refine intro text.
- Correct `npm run format` description.
- Update `CONTRIBUTING.md`:
- Clarify `npm run format` targets.
- Minor refinements to "Submitting a Pull Request" and "Agent PR Conventions" sections.
- Verified all documentation matches current codebase state.
Co-authored-by: PR0M3TH3AN <[email protected]>
- Fix Tailwind build warning by using pixel units for screens in `tailwind.config.cjs`.
- Update `CONTRIBUTING.md` to recommend sharded unit tests to avoid timeouts.
- Add `docs/onboarding-audit-20260128.md` with full audit report.
Co-authored-by: PR0M3TH3AN <[email protected]>
- Update CONTRIBUTING.md and README.md to clarify npm run format scope and recommend test shards
- Fix broken unit tests in sessionActor and tagPreferenceMenu to unblock shards
- Fix `npm run lint` failure by replacing inline style with CSS class in `js/ui/components/SearchFilterModal.js`.
- Fix `npm run lint:tokens` failure by defining `--size-40rem` in `css/tokens.css` and using it in `css/tailwind.source.css`.
- Update `CONTRIBUTING.md` with troubleshooting tips for unit test hangs and linting failures.
- Attempt to update `caniuse-lite` to silence build warning (may persist due to environment/cache).
- Add `scripts/setup-pre-commit.sh` to install a git pre-commit hook.
- The hook runs `npm run lint` and `npm run build:css` to enforce quality and build consistency.
- Update `CONTRIBUTING.md` to document the new hook setup under Development Setup.
- Add `css/tailwind.generated.css` to `.gitignore`.
- Remove the tracked `css/tailwind.generated.css` file from the repository.
- Update `CONTRIBUTING.md` to discourage committing the generated file.
- Update `README.md` to clarify that `npm run build` generates the gitignored CSS.
This ensures the generated artifact is not tracked, reducing merge conflicts and repository bloat, while maintaining clear instructions for local development.
- Format `css/tailwind.source.css` with Prettier.
- Add allowlist entry for `VideoCard.js` media query pixel value in `scripts/check-design-tokens.mjs`.
- Remove accidental artifact `js/ui/dm/jules_session_4520373547615093905.zip`.
- Fix bug in `js/app.js` and `js/services/moderationActionController.js` where blocked users' videos were not correctly hidden in the UI immediately after blocking.
- Fix bug in `tests/app/moderation-overrides.test.mjs` where `userBlocks` mocks were insufficient to reflect state changes.
- Fix `scripts/check-design-tokens.mjs` to allow a mobile breakpoint.
- Add Dev Container documentation to `CONTRIBUTING.md`.
- Fix missing dependency injection in `tests/helpers/moderation-test-helpers.mjs` to resolve some unit test failures in a fresh environment.
- Update README.md to recommend `npm ci` and include test steps.
- Update CONTRIBUTING.md with explicit development setup instructions.
- Add `.devcontainer/devcontainer.json` for reproducible Node 20 environment.
- Add audit report in `ai/reports/onboarding-20260118.md`.
