create-fullstack-scaffold 0.1.0

package/package.json

@@ -0,0 +1,171 @@
+{
+  "name": "create-fullstack-scaffold",
+  "version": "0.1.0",
+  "type": "module",
+  "bin": {
+    "create-fullstack-scaffold": "dist/cli/index.js"
+  },
+  "files": [
+    "dist/cli",
+    "template"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dyyz1993/fullstack-scaffold"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "npm run build:client && npm run build:server",
+    "build:client": "vite build",
+    "build:server": "tsup",
+    "build:cli": "tsup --config tsup.cli.config.ts",
+    "build:cloudflare": "npm run build:client && tsup --config tsup.config.ts",
+    "build:all": "npm run build:client && npm run build:server && npm run build:cli",
+    "cli": "node dist/cli/index.js",
+    "preview": "vite preview",
+    "start": "NODE_ENV=production node dist/server/node.js",
+    "start:dev": "NODE_ENV=development node --import tsx src/server/entries/node.ts",
+    "dev:cf": "wrangler dev",
+    "deploy:cf": "npm run build:cloudflare && wrangler deploy",
+    "typecheck": "tsc --noEmit && eslint . --max-warnings=0",
+    "typecheck:template": "cd template && npx tsc --noEmit",
+    "test": "vitest",
+    "test:smart": "node --import tsx/esm lint-scripts/smart-test.ts",
+    "test:smart:staged": "node --import tsx/esm lint-scripts/smart-test.ts --staged",
+    "test:infrastructure": "node --import tsx/esm lint-scripts/smart-test.ts --infrastructure",
+    "test:all": "node --import tsx/esm lint-scripts/smart-test.ts --all",
+    "test:coverage": "vitest run --coverage",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "test:ui": "vitest run --ui",
+    "test:e2e": "playwright test",
+    "test:e2e:ui": "playwright test --ui",
+    "test:e2e:debug": "playwright test --debug",
+    "test:track": "node --import tsx/esm lint-scripts/test-tracker.ts",
+    "test:history": "node --import tsx/esm lint-scripts/test-history.ts",
+    "test:history:list": "node --import tsx/esm lint-scripts/test-history.ts list",
+    "test:history:show": "node --import tsx/esm lint-scripts/test-history.ts show",
+    "test:history:compare": "node --import tsx/esm lint-scripts/test-history.ts compare",
+    "test:history:failed": "node --import tsx/esm lint-scripts/test-history.ts failed",
+    "test:full": "npm run test:all && npm run test:integration && npm run test:e2e",
+    "coverage": "vitest --coverage",
+    "lint": "eslint .",
+    "lint:template": "cd template && npx eslint src/ --max-warnings=0",
+    "format": "prettier --write .",
+    "validate:all": "node --import tsx/esm lint-scripts/validate-all.ts",
+    "validate:watch": "node --import tsx/esm lint-scripts/watch-validator.ts",
+    "validate:vite-routes": "node --import tsx/esm lint-scripts/validate-vite-routes.ts",
+    "validate:modules": "npx tsx src/server/core/module-loader.ts",
+    "check:refs": "node --import tsx/esm lint-scripts/check-refs.ts",
+    "create:module": "node --import tsx/esm scripts/create-template.ts",
+    "postinstall": "patch-package",
+    "prepare": "husky",
+    "db:generate": "drizzle-kit generate",
+    "db:migrate": "drizzle-kit migrate",
+    "db:push": "drizzle-kit push",
+    "db:studio": "drizzle-kit studio",
+    "framework:init": "node --import tsx/esm lint-scripts/framework/init-baseline.ts",
+    "framework:update": "node --import tsx/esm lint-scripts/framework/update-baseline.ts",
+    "framework:check": "node --import tsx/esm lint-scripts/framework/check-modify.ts",
+    "dev:context": "node --import tsx/esm lint-scripts/dev-context-analyzer.ts",
+    "dev:guide": "node --import tsx/esm lint-scripts/dev-guide-generator.ts",
+    "ai:context": "node --import tsx/esm lint-scripts/ai-context-generator.ts",
+    "validate:template": "npm run typecheck:template && npm run lint:template",
+    "test:template": "cd template && npx vitest run"
+  },
+  "dependencies": {
+    "@hono/node-server": "^1.14.4",
+    "@hono/zod-openapi": "1.2.2",
+    "@hono/zod-validator": "0.7.6",
+    "@inquirer/prompts": "^8.4.2",
+    "@libsql/client": "^0.17.0",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "dotenv": "^16.5.0",
+    "drizzle-orm": "^0.45.1",
+    "fs-extra": "^11.3.5",
+    "hono": "^4.12.16",
+    "jsonwebtoken": "^9.0.3",
+    "lucide-react": "^0.576.0",
+    "ora": "^9.4.0",
+    "pino": "^9.7.0",
+    "pino-pretty": "^13.0.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-router-dom": "^7.13.1",
+    "ws": "^8.18.3",
+    "zod": "^4.4.3",
+    "zustand": "^5.0.2"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "^4.20260503.1",
+    "@commitlint/cli": "^20.4.3",
+    "@commitlint/config-conventional": "^20.4.3",
+    "@eslint/js": "^9.39.4",
+    "@hono/vite-dev-server": "^0.23.0",
+    "@playwright/test": "^1.50.0",
+    "@tailwindcss/postcss": "^4.2.1",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/jest-dom": "^6.8.0",
+    "@testing-library/react": "^16.3.2",
+    "@types/fs-extra": "^11.0.4",
+    "@types/jsonwebtoken": "^9.0.10",
+    "@types/node": "^22.13.10",
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "@types/ws": "^8.18.0",
+    "@vitejs/plugin-react": "^5.1.4",
+    "@vitest/coverage-v8": "^4.0.16",
+    "@vitest/ui": "^4.0.16",
+    "autoprefixer": "^10.4.27",
+    "bun-types": "^1.3.10",
+    "drizzle-kit": "^0.31.9",
+    "eslint": "^9.21.0",
+    "eslint-plugin-react-hooks": "^5.2.0",
+    "eslint-plugin-react-refresh": "^0.4.19",
+    "eventsource": "^4.1.0",
+    "glob": "^13.0.6",
+    "globals": "^16.0.0",
+    "husky": "^9.1.7",
+    "jsdom": "^26.0.3",
+    "lint-staged": "^15.5.0",
+    "minimatch": "^10.2.4",
+    "patch-package": "^8.0.1",
+    "playwright": "^1.50.0",
+    "postcss": "^8.5.6",
+    "prettier": "^3.5.3",
+    "tailwindcss": "^4.2.1",
+    "ts-import": "^5.0.0-beta.1",
+    "tsup": "^8.5.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.25.0",
+    "vite": "^6.2.3",
+    "vitest": "^4.0.16",
+    "wrangler": "^4.75.0"
+  },
+  "lint-staged": {
+    "*.{ts,tsx,js,jsx}": [
+      "prettier --write",
+      "eslint --fix",
+      "eslint --max-warnings=0 --no-warn-ignored"
+    ],
+    "*.{json,md,css}": [
+      "prettier --write"
+    ],
+    "src/server/**/*routes*.ts": [
+      "npm run validate:all"
+    ],
+    "src/client/**/*.{ts,tsx}": [
+      "npm run validate:all"
+    ]
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "overrides": {
+    "esbuild": "^0.25.0"
+  }
+}

package/template/.agents/skills/writing-hookify-rules/SKILL.md

@@ -0,0 +1,408 @@
+---
+name: Writing Hookify Rules
+description: This skill should be used when the user asks to "create a hookify rule", "write a hook rule", "configure hookify", "add a hookify rule", or needs guidance on hookify rule syntax and patterns.
+version: 0.1.0
+---
+
+# Writing Hookify Rules
+
+## Overview
+
+Hookify rules are markdown files with YAML frontmatter that define patterns to watch for and messages to show when those patterns match. Rules are stored in `.claude/hookify.{rule-name}.local.md` files.
+
+## Rule File Format
+
+### Basic Structure
+
+```markdown
+---
+name: rule-identifier
+enabled: true
+event: bash|file|stop|prompt|all
+pattern: regex-pattern-here
+---
+
+Message to show Claude when this rule triggers.
+Can include markdown formatting, warnings, suggestions, etc.
+```
+
+### Frontmatter Fields
+
+**name** (required): Unique identifier for the rule
+
+- Use kebab-case: `warn-dangerous-rm`, `block-console-log`
+- Be descriptive and action-oriented
+- Start with verb: warn, prevent, block, require, check
+
+**enabled** (required): Boolean to activate/deactivate
+
+- `true`: Rule is active
+- `false`: Rule is disabled (won't trigger)
+- Can toggle without deleting rule
+
+**event** (required): Which hook event to trigger on
+
+- `bash`: Bash tool commands
+- `file`: Edit, Write, MultiEdit tools
+- `stop`: When agent wants to stop
+- `prompt`: When user submits a prompt
+- `all`: All events
+
+**action** (optional): What to do when rule matches
+
+- `warn`: Show message but allow operation (default)
+- `block`: Prevent operation (PreToolUse) or stop session (Stop events)
+- If omitted, defaults to `warn`
+
+**pattern** (simple format): Regex pattern to match
+
+- Used for simple single-condition rules
+- Matches against command (bash) or new_text (file)
+- Python regex syntax
+
+**Example:**
+
+```yaml
+event: bash
+pattern: rm\s+-rf
+```
+
+### Advanced Format (Multiple Conditions)
+
+For complex rules with multiple conditions:
+
+```markdown
+---
+name: warn-env-file-edits
+enabled: true
+event: file
+conditions:
+  - field: file_path
+    operator: regex_match
+    pattern: \.env$
+  - field: new_text
+    operator: contains
+    pattern: API_KEY
+---
+
+You're adding an API key to a .env file. Ensure this file is in .gitignore!
+```
+
+**Condition fields:**
+
+- `field`: Which field to check
+  - For bash: `command`
+  - For file: `file_path`, `new_text`, `old_text`, `content`
+- `operator`: How to match
+  - `regex_match`: Regex pattern matching
+  - `contains`: Substring check
+  - `equals`: Exact match
+  - `not_contains`: Substring must NOT be present
+  - `starts_with`: Prefix check
+  - `ends_with`: Suffix check
+- `pattern`: Pattern or string to match
+
+**All conditions must match for rule to trigger.**
+
+## Message Body
+
+The markdown content after frontmatter is shown to Claude when the rule triggers.
+
+**Good messages:**
+
+- Explain what was detected
+- Explain why it's problematic
+- Suggest alternatives or best practices
+- Use formatting for clarity (bold, lists, etc.)
+
+**Example:**
+
+```markdown
+⚠️ **Console.log detected!**
+
+You're adding console.log to production code.
+
+**Why this matters:**
+
+- Debug logs shouldn't ship to production
+- Console.log can expose sensitive data
+- Impacts browser performance
+
+**Alternatives:**
+
+- Use a proper logging library
+- Remove before committing
+- Use conditional debug builds
+```
+
+## Event Type Guide
+
+### bash Events
+
+Match Bash command patterns:
+
+```markdown
+---
+event: bash
+pattern: sudo\s+|rm\s+-rf|chmod\s+777
+---
+
+Dangerous command detected!
+```
+
+**Common patterns:**
+
+- Dangerous commands: `rm\s+-rf`, `dd\s+if=`, `mkfs`
+- Privilege escalation: `sudo\s+`, `su\s+`
+- Permission issues: `chmod\s+777`, `chown\s+root`
+
+### file Events
+
+Match Edit/Write/MultiEdit operations:
+
+```markdown
+---
+event: file
+pattern: console\.log\(|eval\(|innerHTML\s*=
+---
+
+Potentially problematic code pattern detected!
+```
+
+**Match on different fields:**
+
+```markdown
+---
+event: file
+conditions:
+  - field: file_path
+    operator: regex_match
+    pattern: \.tsx?$
+  - field: new_text
+    operator: regex_match
+    pattern: console\.log\(
+---
+
+Console.log in TypeScript file!
+```
+
+**Common patterns:**
+
+- Debug code: `console\.log\(`, `debugger`, `print\(`
+- Security risks: `eval\(`, `innerHTML\s*=`, `dangerouslySetInnerHTML`
+- Sensitive files: `\.env$`, `credentials`, `\.pem$`
+- Generated files: `node_modules/`, `dist/`, `build/`
+
+### stop Events
+
+Match when agent wants to stop (completion checks):
+
+```markdown
+---
+event: stop
+pattern: .*
+---
+
+Before stopping, verify:
+
+- [ ] Tests were run
+- [ ] Build succeeded
+- [ ] Documentation updated
+```
+
+**Use for:**
+
+- Reminders about required steps
+- Completion checklists
+- Process enforcement
+
+### prompt Events
+
+Match user prompt content (advanced):
+
+```markdown
+---
+event: prompt
+conditions:
+  - field: user_prompt
+    operator: contains
+    pattern: deploy to production
+---
+
+Production deployment checklist:
+
+- [ ] Tests passing?
+- [ ] Reviewed by team?
+- [ ] Monitoring ready?
+```
+
+## Pattern Writing Tips
+
+### Regex Basics
+
+**Literal characters:** Most characters match themselves
+
+- `rm` matches "rm"
+- `console.log` matches "console.log"
+
+**Special characters need escaping:**
+
+- `.` (any char) → `\.` (literal dot)
+- `(` `)` → `\(` `\)` (literal parens)
+- `[` `]` → `\[` `\]` (literal brackets)
+
+**Common metacharacters:**
+
+- `\s` - whitespace (space, tab, newline)
+- `\d` - digit (0-9)
+- `\w` - word character (a-z, A-Z, 0-9, \_)
+- `.` - any character
+- `+` - one or more
+- `*` - zero or more
+- `?` - zero or one
+- `|` - OR
+
+**Examples:**
+
+```
+rm\s+-rf         Matches: rm -rf, rm  -rf
+console\.log\(   Matches: console.log(
+(eval|exec)\(    Matches: eval( or exec(
+chmod\s+777      Matches: chmod 777, chmod  777
+API_KEY\s*=      Matches: API_KEY=, API_KEY =
+```
+
+### Testing Patterns
+
+Test regex patterns before using:
+
+```bash
+python3 -c "import re; print(re.search(r'your_pattern', 'test text'))"
+```
+
+Or use online regex testers (regex101.com with Python flavor).
+
+### Common Pitfalls
+
+**Too broad:**
+
+```yaml
+pattern: log # Matches "log", "login", "dialog", "catalog"
+```
+
+Better: `console\.log\(|logger\.`
+
+**Too specific:**
+
+```yaml
+pattern: rm -rf /tmp # Only matches exact path
+```
+
+Better: `rm\s+-rf`
+
+**Escaping issues:**
+
+- YAML quoted strings: `"pattern"` requires double backslashes `\\s`
+- YAML unquoted: `pattern: \s` works as-is
+- **Recommendation**: Use unquoted patterns in YAML
+
+## File Organization
+
+**Location:** All rules in `.claude/` directory
+**Naming:** `.claude/hookify.{descriptive-name}.local.md`
+**Gitignore:** Add `.claude/*.local.md` to `.gitignore`
+
+**Good names:**
+
+- `hookify.dangerous-rm.local.md`
+- `hookify.console-log.local.md`
+- `hookify.require-tests.local.md`
+- `hookify.sensitive-files.local.md`
+
+**Bad names:**
+
+- `hookify.rule1.local.md` (not descriptive)
+- `hookify.md` (missing .local)
+- `danger.local.md` (missing hookify prefix)
+
+## Workflow
+
+### Creating a Rule
+
+1. Identify unwanted behavior
+2. Determine which tool is involved (Bash, Edit, etc.)
+3. Choose event type (bash, file, stop, etc.)
+4. Write regex pattern
+5. Create `.claude/hookify.{name}.local.md` file in project root
+6. Test immediately - rules are read dynamically on next tool use
+
+### Refining a Rule
+
+1. Edit the `.local.md` file
+2. Adjust pattern or message
+3. Test immediately - changes take effect on next tool use
+
+### Disabling a Rule
+
+**Temporary:** Set `enabled: false` in frontmatter
+**Permanent:** Delete the `.local.md` file
+
+## Examples
+
+See `${CLAUDE_PLUGIN_ROOT}/examples/` for complete examples:
+
+- `dangerous-rm.local.md` - Block dangerous rm commands
+- `console-log-warning.local.md` - Warn about console.log
+- `sensitive-files-warning.local.md` - Warn about editing .env files
+
+## Quick Reference
+
+**Minimum viable rule:**
+
+```markdown
+---
+name: my-rule
+enabled: true
+event: bash
+pattern: dangerous_command
+---
+
+Warning message here
+```
+
+**Rule with conditions:**
+
+```markdown
+---
+name: my-rule
+enabled: true
+event: file
+conditions:
+  - field: file_path
+    operator: regex_match
+    pattern: \.ts$
+  - field: new_text
+    operator: contains
+    pattern: any
+---
+
+Warning message
+```
+
+**Event types:**
+
+- `bash` - Bash commands
+- `file` - File edits
+- `stop` - Completion checks
+- `prompt` - User input
+- `all` - All events
+
+**Field options:**
+
+- Bash: `command`
+- File: `file_path`, `new_text`, `old_text`, `content`
+- Prompt: `user_prompt`
+
+**Operators:**
+
+- `regex_match`, `contains`, `equals`, `not_contains`, `starts_with`, `ends_with`