Merge pull request #99 from Davidson3556/feat/lint-format-gates

chore: add working lint and format gates aligned with OSS repo standards

Author: jwfing

.gitattributes

@@ -0,0 +1,3 @@
+# Normalize line endings to LF so the Prettier `endOfLine: lf` gate is stable
+# across platforms (Windows checkouts included).
+* text=auto eol=lf

.github/workflows/ci.yml

@@ -7,6 +7,19 @@ on:
     branches: [main]
 
 jobs:
+  lint:
+    name: Lint & Format
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+      - run: npm ci
+      - run: npm run lint
+      - run: npm run format:check
+
   typecheck:
     name: Type Check
     runs-on: ubuntu-latest
@@ -86,7 +99,7 @@ jobs:
           server_port: ${{ secrets.MAIL_SMTP_PORT }}
           username: ${{ secrets.MAIL_USERNAME }}
           password: ${{ secrets.MAIL_PASSWORD }}
-          subject: "[${{ github.repository }}] Coverage Report – ${{ github.sha }}"
+          subject: '[${{ github.repository }}] Coverage Report – ${{ github.sha }}'
           to: ${{ secrets.MAINTAINER_EMAIL }}
           from: ${{ secrets.MAIL_FROM || 'CI Bot <ci@insforge.dev>' }}
           body: |

.prettierignore

@@ -0,0 +1,39 @@
+# Dependencies
+node_modules/
+**/node_modules/
+
+# Build outputs
+dist/
+**/dist/
+build/
+out/
+*.tsbuildinfo
+
+# Coverage
+coverage/
+*.lcov
+.nyc_output/
+
+# Lock files
+package-lock.json
+yarn.lock
+pnpm-lock.yaml
+
+# Generated files
+*.min.js
+*.min.css
+
+# Logs
+*.log
+
+# IDE
+.vscode/
+.idea/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Environment
+.env
+.env.*

.prettierrc

@@ -0,0 +1,9 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "trailingComma": "es5",
+  "printWidth": 100,
+  "endOfLine": "lf",
+  "jsxSingleQuote": false
+}

CLAUDE.md

@@ -11,14 +11,17 @@ alwaysApply: true
 ### For Dev/Testing (Safe - Won't Affect Main Users)
 
 **Option 1: Auto-increment dev version**
+
 ```bash
 npm run publish:dev
 ```
+
 - Auto-bumps version: `0.0.56` → `0.0.56-dev.0` → `0.0.56-dev.1` etc.
 - Publishes with `--tag dev` (not `latest`)
 - Regular users unaffected
 
 **Option 2: Manual dev version (full control)**
+
 ```bash
 # Set exact version you want
 npm version 0.0.60-dev.5 --no-git-tag-version
@@ -27,11 +30,13 @@ npm version 0.0.60-dev.5 --no-git-tag-version
 npm run build
 npm publish --tag dev
 ```
+
 - Choose any version number manually
 - MUST use `npm publish --tag dev` to avoid affecting production users
 - `--no-git-tag-version` prevents auto git commit
 
 ### Installing Dev Versions
+
 ```bash
 # Specific dev version
 npm install @insforge/sdk@0.0.60-dev.5
@@ -44,20 +49,24 @@ npm install @insforge/sdk  # Gets latest stable
 ```
 
 ### For Production Release
+
 ```bash
 npm version patch  # or minor, major
 npm run publish:stable
 ```
+
 - Updates version following semver
 - Publishes with `--tag latest` (default)
 - All users get this version by default
 
 ## Semver Rules
+
 - **Patch** (0.0.X): Bug fixes, no API changes
 - **Minor** (0.X.0): New features, backward compatible
 - **Major** (X.0.0): Breaking changes
 
 ## Pre-Publish Checklist
+
 - [ ] All tests pass: `npm test`
 - [ ] Build succeeds: `npm run build`
 - [ ] Type check passes: `npm run typecheck`