Merge pull request #17 from f1shy-dev/implement-server

server: Implement distracted server for Claude Code integration

Author: f1shy-dev

.github/workflows/release-server.yml

@@ -0,0 +1,93 @@
+name: release server
+
+on:
+  push:
+    tags:
+      - '@distracted/server@*'
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to release (e.g., @distracted/server@1.0.0)'
+        required: true
+        type: string
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    environment: Deploy
+    permissions:
+      contents: write
+      id-token: write
+    
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Determine version
+        id: version
+        run: |
+          if [ "${{ github.event_name }}" == "workflow_dispatch" ]; then
+            VERSION="${{ github.event.inputs.version }}"
+          elif [[ "${{ github.ref }}" == refs/tags/@distracted/server@* ]]; then
+            # Extract version from tag format: @distracted/server@X.X.X
+            VERSION="${GITHUB_REF#refs/tags/@distracted/server@}"
+          else
+            echo "Unable to determine version"
+            exit 1
+          fi
+          
+          # Validate version format
+          if [[ ! "$VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            echo "Invalid version format: $VERSION (expected semver, e.g., 1.0.0)"
+            exit 1
+          fi
+          
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+      - name: Update package version
+        if: github.event_name == 'workflow_dispatch'
+        working-directory: packages/server
+        run: |
+          npm version ${{ steps.version.outputs.version }} --no-git-tag-version
+
+      - name: Build server package
+        working-directory: packages/server
+        run: bun run build
+
+      - name: Verify build output
+        working-directory: packages/server
+        run: |
+          if [ ! -f "dist/bin.js" ]; then
+            echo "Build failed: dist/bin.js not found"
+            exit 1
+          fi
+
+      - name: Publish to NPM
+        working-directory: packages/server
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: |
+          npm publish --access public
+
+      - name: Commit version change
+        if: github.event_name == 'workflow_dispatch'
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add packages/server/package.json
+          git commit -m "chore(server): bump version to ${{ steps.version.outputs.version }}" || exit 0
+          git push origin HEAD || true

.github/workflows/release.yml

@@ -1,13 +1,13 @@
-name: release
+name: release extension
 
 on:
   push:
     tags:
-      - "v*"
+      - '@distracted/extension@*'
   workflow_dispatch:
     inputs:
       tag:
-        description: "Tag to build and attach to release (e.g., v0.0.0-beta.1)"
+        description: "Tag to build and attach to release (e.g., @distracted/extension@1.0.0)"
         required: true
         type: string
 

.github/workflows/validate.yml

@@ -37,3 +37,6 @@ jobs:
         run: |
           bun run --cwd packages/extension build
           bun run --cwd packages/extension build:firefox
+
+      - name: build server
+        run: bun run --cwd packages/server build

.gitignore

@@ -31,3 +31,4 @@ web-ext.config.ts
 .env.*
 !.env.example
 .tmp
+dist/

bun.lock

@@ -13,7 +13,8 @@
       "@typescript/native-preview": "^7.0.0-dev",
       "oxfmt": "^0.21.0",
       "oxlint": "^1.36.0",
-      "oxlint-tsgolint": "^0.10.1"
+      "oxlint-tsgolint": "^0.10.1",
+      "knip": "^5.79.0"
     }
   },
   "scripts": {
@@ -26,6 +27,8 @@
     "clean": "rm -rf node_modules && rm -rf packages/*/node_modules && bun run --workspaces --if-present clean"
   },
   "devDependencies": {
+    "@types/node": "^24.10.1",
+    "bun-types": "^1.2.0",
     "oxfmt": "catalog:",
     "oxlint": "catalog:",
     "oxlint-tsgolint": "catalog:",

package.json

@@ -60,7 +60,7 @@
     "@types/react-dom": "^19.2.3",
     "@typescript/native-preview": "catalog:",
     "@wxt-dev/module-react": "^1.1.5",
-    "knip": "^5.79.0",
+    "knip": "catalog:",
     "oxfmt": "catalog:",
     "oxlint": "catalog:",
     "oxlint-tsgolint": "catalog:",

packages/extension/package.json

@@ -12,7 +12,7 @@ export const claudeDefinition = {
       "Keep the server running while you work in Claude Code.",
       "If you change the server port, update the Server URL below.",
     ],
-    commands: ["npx claude-blocker --setup"],
+    commands: ["bunx @distracted/server --setup"],
     note: "If the server is offline or Claude is idle, the site stays locked.",
   },
   options: {

packages/extension/src/lib/challenges/definitions/claude.ts

@@ -0,0 +1,7 @@
+{
+  "env": {
+    "node": true,
+    "browser": false,
+    "es2022": true
+  }
+}

packages/server/.oxlintrc.json

@@ -0,0 +1,43 @@
+![distracted! - "block distracting websites! do mini tasks to get back on them..."](../extension/public/readme-banner.png)
+
+[![Chrome Web Store](https://img.shields.io/chrome-web-store/v/ggimjhcfchbfdhpehdekdiblbfmijngf?label=chrome%20web%20store&style=for-the-badge)](https://chromewebstore.google.com/detail/distracted/ggimjhcfchbfdhpehdekdiblbfmijngf)
+[![Firefox Add-ons](https://img.shields.io/amo/v/distracted?label=firefox%20add-ons&style=for-the-badge)](https://addons.mozilla.org/en-GB/firefox/addon/distracted/)
+[![GitHub stars](https://img.shields.io/github/stars/f1shy-dev/distracted?style=for-the-badge&color=yellow)](https://github.com/f1shy-dev/distracted)
+
+## what is this package?
+
+local server that integrates with claude code hooks to enable real-time distraction blocking. receives hook events from claude code and forwards them to the extension via websocket.
+
+## how to use
+
+### setup
+
+install the extension first! then run the server:
+
+```bash
+bunx @distracted/server
+```
+
+when ran for the first time, the CLI will add hooks to `~/.claude/settings.json` to forward events to the local server.
+
+then the server will start on port 8765 by default (or use `--port <port>` to specify a different port).
+
+in the extension, setup a distraction with Claude Blocker as the unlock method.
+
+to remove the claude code hooks:
+
+```bash
+bunx @distracted/server --remove
+```
+
+## how it works
+
+- claude code sends hook events (UserPromptSubmit, PreToolUse, SessionStart/End, etc.) to the local server via http post
+- the server processes these events and maintains state about claude code activity
+- the extension connects via websocket and receives real-time updates
+- when claude code is inactive, the extension can activate distraction blocking
+
+## credits
+
+- @t3dotgg/[@theo](https://x.com/theo) for the original [claude-blocker](https://github.com/t3dotgg/claude-blocker)
+- [opencode](https://github.com/anomalyco/opencode) for some small bits of CLI code ([`lib/ui.ts`](src/lib/ui.ts), [`lib/error.ts`](src/lib/error.ts))