Add publication metadata: repository URLs, changelog, contributing guide, CI

- Add repository/homepage/bugs URLs to package.json for npm page
- Add CHANGELOG.md with v1.0.0 release notes
- Add CONTRIBUTING.md with dev setup and guidelines
- Add GitHub Actions CI workflow (typecheck + build on Node 20/22)

Author: zelentsov-dev

.github/workflows/ci.yml

@@ -0,0 +1,40 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: macos-latest
+    strategy:
+      matrix:
+        node-version: [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 }}
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: TypeScript type check
+        run: npx tsc --noEmit
+
+      - name: Build
+        run: npm run build
+
+      - name: Verify dist output
+        run: |
+          test -f dist/index.js || (echo "dist/index.js not found" && exit 1)
+          test -f dist/index.d.ts || (echo "dist/index.d.ts not found" && exit 1)
+          echo "Build output verified"
+
+      - name: Check package contents
+        run: npm pack --dry-run

CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/), and this project adheres to [Semantic Versioning](https://semver.org/).
+
+## [1.0.0] - 2026-03-06
+
+### Added
+
+- MCP server with stdio transport for clipboard image access
+- Swift clipboard watcher daemon polling NSPasteboard every 500ms
+- `paste_recent` tool — returns recent images from clipboard captures, native screenshots dir, and Spotlight
+- `cleanup_images` tool — manual cleanup of temporary session files
+- Multi-source image discovery (watcher + native dir + Spotlight mdfind)
+- Smart image resizing via `sips` (default max 1568px long edge)
+- Password/concealed clipboard detection (1Password, Bitwarden, macOS Keychain)
+- Session isolation with UUID-based temp directories
+- Symlink protection via `lstat`
+- 3-layer auto-cleanup (TTL, max files, max size)
+- Configurable via 9 environment variables
+- macOS-native: zero external dependencies beyond Node.js and Swift
+
+### Security
+
+- ConcealedType/TransientType clipboard checks before reading
+- File permissions: 0600 files, 0700 directories
+- maxBuffer + timeout limits on child processes
+- No content logging, no network calls, zero telemetry
+
+[1.0.0]: https://github.com/zelentsov-dev/clipsnap-mcp/releases/tag/v1.0.0

CONTRIBUTING.md

@@ -0,0 +1,58 @@
+# Contributing to ClipSnap
+
+Thanks for your interest in contributing!
+
+## Getting Started
+
+```bash
+git clone https://github.com/zelentsov-dev/clipsnap-mcp.git
+cd clipsnap-mcp
+npm install
+npm run build
+```
+
+## Development
+
+```bash
+npm run dev    # run with tsx (hot reload)
+npm run build  # compile TypeScript + Swift watcher
+```
+
+## Guidelines
+
+- **Open an issue first** before starting work on large changes
+- Keep PRs focused — one feature or fix per PR
+- Follow existing code style (TypeScript strict mode, 2-space indent)
+- Test your changes manually on macOS with iTerm2 + Claude Code
+- No external runtime dependencies — the project is intentionally dependency-light
+
+## Architecture
+
+```
+src/
+  index.ts        — MCP server entry point, tool definitions
+  config.ts       — environment variable parsing
+  clipboard.ts    — pngpaste + osascript clipboard reading
+  image.ts        — sips-based image processing
+  screenshots.ts  — multi-source screenshot discovery
+  security.ts     — concealed clipboard detection
+  storage.ts      — session file management + cleanup
+  watcher.ts      — Swift watcher process lifecycle
+
+watcher/
+  Sources/        — Swift clipboard watcher daemon
+  Package.swift   — Swift package manifest
+```
+
+## Reporting Bugs
+
+Use the [bug report template](https://github.com/zelentsov-dev/clipsnap-mcp/issues/new?template=bug_report.yml). Include:
+
+- ClipSnap version (`npm list -g clipsnap-mcp`)
+- macOS version
+- Terminal app (iTerm2, Terminal.app, etc.)
+- MCP client (Claude Code, Cursor, etc.)
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the [MIT License](LICENSE).

package.json

@@ -36,6 +36,14 @@
   ],
   "author": "Aleksei Zelentsov",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zelentsov-dev/clipsnap-mcp.git"
+  },
+  "homepage": "https://github.com/zelentsov-dev/clipsnap-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/zelentsov-dev/clipsnap-mcp/issues"
+  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.0"
   },