lockin-mcp 1.0.0

package/dist/state.js

@@ -0,0 +1,91 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { STATE_DIR_NAME, STATE_FILE_NAME, AUDIT_LOG_MAX_ENTRIES, normalizeDomain, } from "./types.js";
+const DEFAULT_STATE = {
+    blockedDomains: [],
+    temporaryUnblocks: [],
+    updatedAt: Date.now(),
+};
+export function getStateDir() {
+    return join(homedir(), STATE_DIR_NAME);
+}
+export function getStatePath() {
+    return join(getStateDir(), STATE_FILE_NAME);
+}
+export async function loadState() {
+    try {
+        const raw = await readFile(getStatePath(), "utf8");
+        const parsed = JSON.parse(raw);
+        return {
+            blockedDomains: dedupeDomains(parsed.blockedDomains ?? []),
+            temporaryUnblocks: (parsed.temporaryUnblocks ?? []).map((entry) => ({
+                domain: normalizeDomain(entry.domain),
+                expiresAt: entry.expiresAt,
+            })),
+            auditLog: parsed.auditLog ?? [],
+            updatedAt: parsed.updatedAt ?? Date.now(),
+        };
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            "code" in error &&
+            error.code === "ENOENT") {
+            return { ...DEFAULT_STATE };
+        }
+        throw error;
+    }
+}
+export async function saveState(state) {
+    await mkdir(getStateDir(), { recursive: true });
+    const nextState = {
+        blockedDomains: dedupeDomains(state.blockedDomains),
+        temporaryUnblocks: state.temporaryUnblocks,
+        auditLog: state.auditLog ?? [],
+        updatedAt: Date.now(),
+    };
+    await writeFile(getStatePath(), `${JSON.stringify(nextState, null, 2)}\n`, {
+        mode: 0o600,
+    });
+}
+export function dedupeDomains(domains) {
+    const seen = new Set();
+    const result = [];
+    for (const domain of domains) {
+        const normalized = normalizeDomain(domain);
+        if (!normalized || seen.has(normalized)) {
+            continue;
+        }
+        seen.add(normalized);
+        result.push(normalized);
+    }
+    return result.sort();
+}
+export function pruneExpiredUnblocks(temporaryUnblocks, now = Date.now()) {
+    return temporaryUnblocks.filter((entry) => entry.expiresAt > now);
+}
+export function getActiveTemporaryUnblock(domain, temporaryUnblocks, now = Date.now()) {
+    const normalized = normalizeDomain(domain);
+    return temporaryUnblocks.find((entry) => entry.domain === normalized && entry.expiresAt > now);
+}
+export function isDomainBlocked(domain, state, now = Date.now()) {
+    const normalized = normalizeDomain(domain);
+    if (!state.blockedDomains.includes(normalized)) {
+        return false;
+    }
+    return !getActiveTemporaryUnblock(normalized, state.temporaryUnblocks, now);
+}
+export function appendAuditEntry(state, action, domains) {
+    const entry = {
+        action,
+        domains: dedupeDomains(domains),
+        timestamp: Date.now(),
+    };
+    const auditLog = [...(state.auditLog ?? []), entry].slice(-AUDIT_LOG_MAX_ENTRIES);
+    return { ...state, auditLog };
+}
+export function getDomainsToBlockInHosts(state, now = Date.now()) {
+    const activeUnblocks = new Set(pruneExpiredUnblocks(state.temporaryUnblocks, now).map((entry) => entry.domain));
+    return state.blockedDomains.filter((domain) => !activeUnblocks.has(domain));
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,40 @@
+export declare const MARKER = "# mac-distraction-blocker-mcp";
+export declare const BLOCK_IP = "127.0.0.1";
+export declare const BLOCK_IP_V6 = "::1";
+export declare const STATE_DIR_NAME = ".mac-distraction-blocker";
+export declare const STATE_FILE_NAME = "state.json";
+export declare const AUDIT_LOG_MAX_ENTRIES = 50;
+export declare function getHostsPath(): string;
+/** @deprecated Use getHostsPath() for platform-aware path */
+export declare const HOSTS_PATH = "/etc/hosts";
+export interface AuditLogEntry {
+    action: string;
+    domains: string[];
+    timestamp: number;
+}
+export interface TemporaryUnblock {
+    domain: string;
+    expiresAt: number;
+}
+export interface BlockerState {
+    blockedDomains: string[];
+    temporaryUnblocks: TemporaryUnblock[];
+    updatedAt: number;
+    auditLog?: AuditLogEntry[];
+}
+export interface DomainStatus {
+    domain: string;
+    status: "blocked" | "temporarily_unblocked" | "not_blocked";
+    expiresAt?: number;
+}
+export interface BlockStatusResult {
+    blocked: DomainStatus[];
+    temporarilyUnblocked: DomainStatus[];
+    notBlocked: string[];
+    hostsFileWritable: boolean;
+    lastSyncedAt: number | null;
+}
+export declare function normalizeDomain(domain: string): string;
+export declare function expandDomainVariants(domain: string): string[];
+export declare function isValidDomain(domain: string): boolean;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM,kCAAkC,CAAC;AACtD,eAAO,MAAM,QAAQ,cAAc,CAAC;AACpC,eAAO,MAAM,WAAW,QAAQ,CAAC;AACjC,eAAO,MAAM,cAAc,6BAA6B,CAAC;AACzD,eAAO,MAAM,eAAe,eAAe,CAAC;AAC5C,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,wBAAgB,YAAY,IAAI,MAAM,CAWrC;AAED,6DAA6D;AAC7D,eAAO,MAAM,UAAU,eAAe,CAAC;AAEvC,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,uBAAuB,GAAG,aAAa,CAAC;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,oBAAoB,EAAE,YAAY,EAAE,CAAC;IACrC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOtD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAS7D;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CASrD"}

package/dist/types.js

@@ -0,0 +1,41 @@
+import { join } from "node:path";
+export const MARKER = "# mac-distraction-blocker-mcp";
+export const BLOCK_IP = "127.0.0.1";
+export const BLOCK_IP_V6 = "::1";
+export const STATE_DIR_NAME = ".mac-distraction-blocker";
+export const STATE_FILE_NAME = "state.json";
+export const AUDIT_LOG_MAX_ENTRIES = 50;
+export function getHostsPath() {
+    if (process.platform === "win32") {
+        return join(process.env.SystemRoot ?? "C:\\Windows", "System32", "drivers", "etc", "hosts");
+    }
+    return "/etc/hosts";
+}
+/** @deprecated Use getHostsPath() for platform-aware path */
+export const HOSTS_PATH = "/etc/hosts";
+export function normalizeDomain(domain) {
+    return domain
+        .trim()
+        .toLowerCase()
+        .replace(/^https?:\/\//, "")
+        .replace(/\/.*$/, "")
+        .replace(/^www\./, "");
+}
+export function expandDomainVariants(domain) {
+    const normalized = normalizeDomain(domain);
+    if (!normalized) {
+        return [];
+    }
+    const variants = new Set([normalized]);
+    variants.add(`www.${normalized}`);
+    return [...variants];
+}
+export function isValidDomain(domain) {
+    const normalized = normalizeDomain(domain);
+    if (!normalized || normalized.length > 253) {
+        return false;
+    }
+    const domainPattern = /^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]{2,63}$/i;
+    return domainPattern.test(normalized);
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,MAAM,GAAG,+BAA+B,CAAC;AACtD,MAAM,CAAC,MAAM,QAAQ,GAAG,WAAW,CAAC;AACpC,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAC;AACjC,MAAM,CAAC,MAAM,cAAc,GAAG,0BAA0B,CAAC;AACzD,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,CAAC;AAC5C,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAExC,MAAM,UAAU,YAAY;IAC1B,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,IAAI,CACT,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,aAAa,EACvC,UAAU,EACV,SAAS,EACT,KAAK,EACL,OAAO,CACR,CAAC;IACJ,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,6DAA6D;AAC7D,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAC;AAkCvC,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,MAAM;SACV,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;SAC3B,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;SACpB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAS,CAAC,UAAU,CAAC,CAAC,CAAC;IAC/C,QAAQ,CAAC,GAAG,CAAC,OAAO,UAAU,EAAE,CAAC,CAAC;IAClC,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QAC3C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,aAAa,GACjB,2DAA2D,CAAC;IAC9D,OAAO,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACxC,CAAC"}

package/dist/types.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.test.d.ts.map

package/dist/types.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.test.d.ts","sourceRoot":"","sources":["../src/types.test.ts"],"names":[],"mappings":""}

package/dist/types.test.js

@@ -0,0 +1,13 @@
+import { describe, expect, it } from "vitest";
+import { normalizeDomain, expandDomainVariants, isValidDomain, } from "./types.js";
+describe("domain validation", () => {
+    it("normalizes domains", () => {
+        expect(normalizeDomain("HTTPS://WWW.YouTube.com/watch")).toBe("youtube.com");
+        expect(expandDomainVariants("youtube.com")).toEqual(expect.arrayContaining(["youtube.com", "www.youtube.com"]));
+    });
+    it("validates domains", () => {
+        expect(isValidDomain("youtube.com")).toBe(true);
+        expect(isValidDomain("not a domain")).toBe(false);
+    });
+});
+//# sourceMappingURL=types.test.js.map

package/dist/types.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.test.js","sourceRoot":"","sources":["../src/types.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAC5B,MAAM,CAAC,eAAe,CAAC,+BAA+B,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC7E,MAAM,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CACjD,MAAM,CAAC,eAAe,CAAC,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC,CAC3D,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QAC3B,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/install.ps1

@@ -0,0 +1,41 @@
+# LockIn MCP — Windows one-line installer
+# Usage:
+#   iwr -useb https://raw.githubusercontent.com/Kiog-Aser/mac-distraction-blocker-mcp/main/install.ps1 | iex
+#   & ([ScriptBlock]::Create((iwr -useb https://raw.githubusercontent.com/Kiog-Aser/mac-distraction-blocker-mcp/main/install.ps1))) -BrowserLogin
+
+param(
+  [string]$LicenseKey,
+  [switch]$BrowserLogin,
+  [switch]$Yes,
+  [int]$Port = 3000,
+  [switch]$PokeRecipe
+)
+
+$ErrorActionPreference = "Stop"
+$Package = if ($env:MDB_NPM_PACKAGE) { $env:MDB_NPM_PACKAGE } else { "lockin-mcp" }
+
+function Write-Info($Message) { Write-Host "→ $Message" }
+function Write-Bold($Message) { Write-Host $Message -ForegroundColor Cyan }
+
+function Ensure-Node {
+  if (Get-Command node -ErrorAction SilentlyContinue) {
+    $major = [int](node -p "process.versions.node.split('.')[0]")
+    if ($major -lt 18) { throw "Node.js 18+ required (found $(node -v))" }
+    return
+  }
+  throw "Node.js 18+ is required. Install from https://nodejs.org/ and rerun."
+}
+
+Ensure-Node
+
+$argsList = @()
+if ($Yes) { $argsList += "--yes" }
+if ($LicenseKey) { $argsList += @("--license-key", $LicenseKey) }
+if ($BrowserLogin) { $argsList += "--browser-login" }
+if ($Port) { $argsList += @("--port", "$Port") }
+if ($PokeRecipe) { $argsList += "--poke-recipe" }
+if (-not $LicenseKey -and -not $BrowserLogin) {
+  $argsList += "--browser-login"
+}
+
+& npx -y -p $Package -- mdb-install @argsList

package/install.sh

@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+# LockIn MCP — one-line installer
+# Preferred: npx -y lockin-mcp mdb-install
+# Alternative: curl -fsSL https://your-domain.com/install | bash
+set -euo pipefail
+
+MDB_APP_URL="${MDB_APP_URL:-http://localhost:3001}"
+MDB_LICENSE_API_URL="${MDB_LICENSE_API_URL:-${MDB_APP_URL%/}/api/v1}"
+NPX_PKG="${MDB_NPM_PACKAGE:-lockin-mcp}"
+PACKAGE="${MDB_NPM_PACKAGE:-lockin-mcp}"
+
+die() { printf '✗ %s\n' "$*" >&2; exit 1; }
+
+ensure_node() {
+  if command -v node >/dev/null 2>&1; then
+    local major
+    major="$(node -p "process.versions.node.split('.')[0]")"
+    [ "$major" -ge 18 ] || die "Node.js 18+ required (found $(node -v))"
+    return 0
+  fi
+  die "Node.js 18+ required. Install from https://nodejs.org/"
+}
+
+case "$(uname -s)" in
+  MINGW*|MSYS*|CYGWIN*) die "On Windows: iwr -useb ${MDB_APP_URL}/install.ps1 | iex" ;;
+esac
+
+ensure_node
+
+export MDB_APP_URL
+export MDB_LICENSE_API_URL
+
+NPX=(npx -y -p "${PACKAGE}" mdb-install --browser-login "$@")
+
+if [ ! -t 0 ] && [ -r /dev/tty ]; then
+  exec </dev/tty >/dev/tty 2>&1 "${NPX[@]}"
+else
+  exec "${NPX[@]}"
+fi

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "lockin-mcp",
+  "version": "1.0.0",
+  "description": "LockIn MCP — block distractions at the system level with AI-powered focus tools",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "lockin-mcp": "dist/index.js",
+    "mac-distraction-blocker-mcp": "dist/index.js",
+    "mdb-install": "dist/install.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:icons": "node scripts/generate-icons.mjs",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build && npm run lint",
+    "start": "node dist/index.js",
+    "start:stdio": "node dist/index.js --stdio",
+    "start:http": "node dist/index.js --http",
+    "install:local": "node dist/install.js",
+    "dev": "tsc --watch",
+    "lint": "tsc --noEmit",
+    "test": "node --experimental-vm-modules node_modules/vitest/vitest.mjs run"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "lockin",
+    "macos",
+    "distraction-blocker",
+    "hosts",
+    "focus",
+    "poke"
+  ],
+  "license": "MIT",
+  "files": [
+    "dist",
+    "assets",
+    "install.sh",
+    "install.ps1",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.5.1",
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "express": "^4.21.2",
+    "picocolors": "^1.1.1",
+    "ws": "^8.18.1",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@resvg/resvg-js": "^2.6.2",
+    "@types/express": "^4.17.21",
+    "@types/node": "^22.13.10",
+    "@types/ws": "^8.5.14",
+    "typescript": "^5.8.2",
+    "vitest": "^3.0.9"
+  }
+}