Add CSS bundler for slashed-essential.css

[jackgranatowski]

Summary

• Dodaje scripts/bundle.js — bundler konkatenujący pliki z core/ w prawidłowej kolejności cascade layers do dist/slashed-essential.css
• Lista plików i ścieżka outputu konfigurowana przez bundle.config.json — dodanie nowego pliku nie wymaga edycji skryptu
• Pre-commit hook (.githooks/pre-commit) automatycznie przebudowuje bundle przed każdym commitem
• prepare w package.json aktywuje hook automatycznie po npm install — zero ręcznej konfiguracji

Użycie

npm install      # aktywuje git hooks
npm run build    # jednorazowy build
npm run watch    # rebuild przy każdej zmianie w core/

Dodanie nowego pliku core

Wystarczy dopisać go w odpowiednim miejscu w bundle.config.json — przy następnym commicie bundle zaktualizuje się automatycznie.

https://claude.ai/code/session_01BYukqam6ayV3B9K1icXiET

---

Generated by Claude Code

Summary by CodeRabbit

• Chores
  • Added automatic bundling execution before each commit via pre-commit hook
  • Enhanced build system with stricter path validation and improved error reporting
  • Improved error handling in build failures with clearer logging
  • Configured automatic Git hooks initialization during project setup
  • Updated version control configuration to exclude dependencies

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: b7c55359-5b0e-4e49-a79e-ceedeff91255

📥 Commits

Reviewing files that changed from the base of the PR and between 64e9a7a and f505bb9.

⛔ Files ignored due to path filters (2)

• dist/slashed.essential.css is excluded by !**/dist/**
• package-lock.json is excluded by !**/package-lock.json

📒 Files selected for processing (4)

• .githooks/pre-commit
• .gitignore
• package.json
• scripts/bundle.js

💤 Files with no reviewable changes (1)

• .gitignore

✅ Files skipped from review due to trivial changes (1)

• package.json

🚧 Files skipped from review as they are similar to previous changes (2)

• .githooks/pre-commit
• scripts/bundle.js

---

📝 Walkthrough

Walkthrough

This PR hardens the CSS bundler script with path validation and improved error handling, then integrates it into the git workflow via a pre-commit hook and npm automation to automatically build and stage bundles on commit.

Changes

CSS Bundler Hardening and Git Integration

Layer / File(s)	Summary
Bundle script path validation and error handling scripts/bundle.js	Adds resolveInsideRoot() to enforce repository-root path constraints, removes process termination from loadConfig(), refactors bundle() to use resolved paths and simpler headers, hardens watch() to tolerate initial failures and log config reload errors, updates the watcher to handle both change and rename events, and wraps CLI mode in try/catch with exit code 1 on failure.
Git pre-commit hook and npm automation .githooks/pre-commit, package.json, .gitignore	Adds a pre-commit hook that runs the bundler and stages the computed output; adds a prepare npm script to configure core.hooksPath to .githooks on install; and updates .gitignore to exclude node_modules/.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• codeslash-dev/SLASHED#4: This PR directly refactors the bundler logic that PR 4 introduced—hardening path resolution, error handling, and watch behavior.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'Add CSS bundler for slashed-essential.css' accurately describes the main change: introducing a new CSS bundler system. It is concise, clear, and directly relates to the primary objective of the PR.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch claude/create-css-bundler-fbG6K

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 ESLint

If the error stems from missing dependencies, add them to the package.json file. For unrecoverable errors (e.g., due to private dependencies), disable the tool in the CodeRabbit configuration.

ESLint skipped: no ESLint configuration detected in root package.json. To enable, add eslint to devDependencies.

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 5

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.githooks/pre-commit:
- Around line 1-3: The pre-commit hook can succeed even if bundling fails
because it doesn't stop on errors; update the hook so the script exits
immediately on any failure by either adding a shell "set -e" at the top of the
script or chaining the commands with "&&" (e.g., run "node scripts/bundle.js &&
git add dist/slashed-essential.css"); ensure you modify the existing pre-commit
script that runs node scripts/bundle.js and git add dist/slashed-essential.css
so a failing bundle prevents the git add and the hook from succeeding.

In `@package.json`:
- Line 6: The prepare script currently runs "git config core.hooksPath
.githooks" unconditionally which can fail when not in a Git worktree; update the
prepare entry so it first checks for a Git repo (e.g., using git rev-parse
--is-inside-work-tree or testing for a .git directory) and only runs git config
core.hooksPath .githooks when that check succeeds; modify the "prepare" script
in package.json to perform that guarded check before invoking git config.

In `@scripts/bundle.js`:
- Around line 22-24: The bundle currently injects a wall-clock timestamp via the
timestamp const and embeds it into header (and the similar header occurrences
around the other two spots), causing nondeterministic output; remove the
Date().toISOString() call and stop including timestamp in the header strings
(replace with a static, deterministic header message or a reproducible build
id), i.e., remove the timestamp variable and change the const header (and the
other header definitions at the two similar spots) to use only deterministic
content such as `/* ${path.basename(output)} — bundled */\n`.
- Line 21: The code trusts config paths (e.g., output used with path.join to
form outputPath) and can be tricked to read/write outside the repo; fix by
resolving and validating each config-derived path against the repository root
before any file IO: use path.resolve(ROOT, <configPath>) (instead of raw
path.join), then ensure the resolved path is constrained to ROOT (e.g.,
path.relative(ROOT, resolved) does not start with '..' and the resolved path
shares the ROOT prefix) and reject or normalize any paths that escape the root;
apply this validation to outputPath and the other config-derived paths used
around the same area (the variables/functions that build paths from the parsed
bundle.config.json).
- Around line 9-16: loadConfig currently calls process.exit(1) on JSON
read/parse errors which kills watch mode; change loadConfig to catch errors, log
the error (including err.message), and return null/undefined or a safe default
instead of exiting so the process survives transient failures (keep CONFIG_PATH
and loadConfig name to locate the change). Also update the file-watcher handler
that currently reacts only to 'change' (referenced around the code handling
fs.watch events / lines 79-83) to also handle the 'rename' event: on 'rename'
attempt to re-read loadConfig (with retries or a short debounce), trigger a
rebuild/reload when config becomes available, and avoid throwing so watch mode
continues running. Ensure rebuild logic uses the returned config-null check
rather than relying on process exit.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 20c2a6fb-5dff-44fd-8fab-127388551e94

📥 Commits

Reviewing files that changed from the base of the PR and between e4d8d01 and aef93d0.

⛔ Files ignored due to path filters (2)

• dist/slashed-essential.css is excluded by !**/dist/**
• package-lock.json is excluded by !**/package-lock.json

📒 Files selected for processing (5)

• .githooks/pre-commit
• .gitignore
• bundle.config.json
• package.json
• scripts/bundle.js