Add CI/CD, changelog, contributing guide, and package metadata

- GitHub Actions CI: lint, test, build on Node 18/20/22 for push + PR
- GitHub Actions Release: publish to npm with provenance on tag push (v*)
- CHANGELOG.md with initial 0.1.0 release notes
- CONTRIBUTING.md with dev setup, scripts, custom adapter guide
- package.json: added keywords, author field

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: Royal-lobster

.github/workflows/ci.yml

@@ -0,0 +1,35 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [18, 20, 22]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Type check
+        run: npm run lint
+
+      - name: Run tests
+        run: npm test
+
+      - name: Build
+        run: npm run build

.github/workflows/release.yml

@@ -0,0 +1,37 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Use Node.js 22
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+          registry-url: https://registry.npmjs.org
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: npm test
+
+      - name: Build
+        run: npm run build
+
+      - name: Publish to npm
+        run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog
+
+## 0.1.0
+
+Initial release.
+
+### Features
+
+- **Core engine**: unified alert API with `info`, `warn`, `error`, `critical` methods
+- **Error fingerprinting**: automatic deduplication via MD5 hash of normalized error message + stack frames
+- **Smart aggregation**: exponential suppression (onset -> ramp -> sustained -> resolution)
+- **Multi-channel routing**: route alerts by severity level or custom tags to different webhook URLs
+- **Per-environment config**: different thresholds, levels, and ping rules for prod/staging/dev
+- **Environment badges**: `[PROD]`, `[STG]`, `[DEV]` prefix on every alert
+
+### Adapters
+
+- **DiscordAdapter**: color-coded embeds, mention sanitization, 429 retry with Retry-After
+- **ConsoleAdapter**: TTY-aware pretty/JSON output
+
+### Reliability
+
+- **RetryQueue**: ring buffer with configurable max size, FIFO drain
+- **HealthManager**: per-adapter health tracking, graceful degradation, recovery detection
+- **Disk persistence**: atomic JSON save/load for crash recovery
+
+### Framework Integrations
+
+- **NestJS** (`@iqai/alert-logger/nestjs`): global module, injectable service, exception filter, request context via AsyncLocalStorage
+- **Next.js** (`@iqai/alert-logger/nextjs`): instrumentation.ts handler, onRequestError hook, getAlertLogger for manual use

CONTRIBUTING.md

@@ -0,0 +1,60 @@
+# Contributing to @iqai/alert-logger
+
+Thanks for your interest in contributing!
+
+## Development Setup
+
+```bash
+git clone https://github.com/IQAIcom/alert-logger.git
+cd alert-logger
+npm install
+```
+
+## Scripts
+
+```bash
+npm test          # Run tests
+npm run test:watch # Run tests in watch mode
+npm run lint      # Type check
+npm run build     # Build with tsup
+```
+
+## Making Changes
+
+1. Fork the repo and create a branch from `main`
+2. Write your changes
+3. Add tests for new functionality
+4. Ensure all tests pass: `npm test`
+5. Ensure types check: `npm run lint`
+6. Submit a pull request
+
+## Writing Adapters
+
+To create a custom adapter, implement the `AlertAdapter` interface:
+
+```ts
+import type { AlertAdapter, FormattedAlert, AlertLevel } from '@iqai/alert-logger'
+
+class MyAdapter implements AlertAdapter {
+  readonly name = 'my-adapter'
+  levels: AlertLevel[] = ['info', 'warning', 'critical']
+
+  rateLimits() {
+    return { maxPerWindow: 60, windowMs: 60_000 }
+  }
+
+  async send(alert: FormattedAlert): Promise<void> {
+    // Your sending logic here
+  }
+}
+```
+
+## Code Style
+
+- TypeScript strict mode
+- ESM with `.js` extensions in imports
+- No external runtime dependencies in core
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the MIT License.

PHASE6-PLAN.md

@@ -0,0 +1,25 @@
+# Phase 6: Publish — Implementation Plan
+
+## Tasks
+
+### 6.1 GitHub Actions CI
+- Lint (tsc --noEmit), test (vitest), build (tsup) on push/PR
+- Matrix: Node 18, 20, 22
+- Use pnpm or npm
+
+### 6.2 GitHub Actions Release
+- Publish to npm on tag push (v*)
+- Use NPM_TOKEN secret
+- Semantic versioning
+
+### 6.3 Package polish
+- Add keywords, author, license fields to package.json
+- Ensure package.json files field is correct
+- Add CONTRIBUTING.md
+
+### 6.4 Changelog
+- CHANGELOG.md with initial release notes
+
+### 6.5 Verification
+- CI workflow valid YAML
+- Build + test passes locally

package.json

@@ -4,6 +4,19 @@
   "description": "Smart alert aggregation for any destination — Discord, Sentry, Slack, console, or your own adapter",
   "type": "module",
   "license": "MIT",
+  "author": "IQ AI <https://github.com/IQAIcom>",
+  "keywords": [
+    "alert",
+    "logger",
+    "discord",
+    "webhook",
+    "error-tracking",
+    "aggregation",
+    "deduplication",
+    "nestjs",
+    "nextjs",
+    "monitoring"
+  ],
   "repository": {
     "type": "git",
     "url": "https://github.com/IQAIcom/alert-logger"