availsync 0.1.0

package/frontend/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "availsync-frontend",
+  "version": "0.1.0",
+  "private": true,
+  "engines": {
+    "node": "22.x"
+  },
+  "scripts": {
+    "dev": "next dev -p 3001",
+    "build": "next build",
+    "start": "node scripts/start-next.mjs",
+    "lint": "next lint",
+    "test:e2e": "playwright test"
+  },
+  "dependencies": {
+    "@lobehub/icons": "^5.8.0",
+    "@tanstack/react-query": "^5.90.0",
+    "clsx": "^2.1.1",
+    "framer-motion": "^11.18.2",
+    "geist": "^1.7.0",
+    "lucide-react": "^0.468.0",
+    "next": "^15.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "react-hook-form": "^7.53.0",
+    "tailwind-merge": "^2.5.4",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.49.0",
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "autoprefixer": "^10.4.20",
+    "eslint": "^9.0.0",
+    "eslint-config-next": "^15.0.0",
+    "postcss": "^8.4.49",
+    "tailwindcss": "^3.4.17",
+    "typescript": "^5.9.3"
+  }
+}

package/frontend/playwright.config.ts

@@ -0,0 +1,20 @@
+import { defineConfig, devices } from '@playwright/test';
+
+export default defineConfig({
+  testDir: './tests',
+  timeout: 30_000,
+  webServer: {
+    command: 'npm run dev',
+    url: 'http://localhost:3001',
+    reuseExistingServer: true,
+    timeout: 120_000,
+  },
+  use: {
+    baseURL: 'http://localhost:3001',
+    trace: 'on-first-retry',
+  },
+  projects: [
+    { name: 'chromium', use: { ...devices['Desktop Chrome'] } },
+    { name: 'mobile', use: { ...devices['Pixel 5'] } },
+  ],
+});

package/frontend/postcss.config.mjs

@@ -0,0 +1,8 @@
+const config = {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+};
+
+export default config;

package/frontend/tailwind.config.ts

@@ -0,0 +1,53 @@
+import type { Config } from 'tailwindcss';
+
+const config: Config = {
+  content: ['./app/**/*.{ts,tsx}', './components/**/*.{ts,tsx}', './lib/**/*.{ts,tsx}'],
+  theme: {
+    extend: {
+      colors: {
+        // Linear-style dark palette
+        bg: '#0F0F0F',
+        surface: '#161616',
+        'surface-raised': '#1C1C1C',
+        border: '#2A2A2A',
+        'border-focus': '#3D3D3D',
+        'text-primary': '#F2F2F2',
+        'text-secondary': '#A0A0A0',
+        'text-tertiary': '#5C5C5C',
+        accent: '#5E6AD2',
+        'accent-hover': '#6B75DB',
+        success: '#4CAF50',
+        warning: '#E8B84B',
+        error: '#E55353',
+        // Keep old colors for marketing pages
+        ink: '#101418',
+        paper: '#f7f5ef',
+        line: '#d8d2c4',
+        moss: '#556b4e',
+        rust: '#b75c2b',
+        blue: '#315f8a',
+      },
+      fontFamily: {
+        sans: ['var(--font-geist-sans)', 'system-ui', 'sans-serif'],
+        mono: ['var(--font-geist-mono)', 'Menlo', 'monospace'],
+      },
+      fontSize: {
+        'label': ['11px', { lineHeight: '16px', letterSpacing: '0.04em' }],
+        'body': ['13px', { lineHeight: '20px' }],
+        'heading': ['15px', { lineHeight: '22px', letterSpacing: '0' }],
+        'title': ['20px', { lineHeight: '28px', letterSpacing: '0' }],
+      },
+      boxShadow: {
+        panel: '0 16px 48px rgba(16, 20, 24, 0.10)',
+      },
+      spacing: {
+        '4.5': '18px',
+        '7.5': '30px',
+        '9': '36px',
+      },
+    },
+  },
+  plugins: [],
+};
+
+export default config;

package/frontend/tests/smoke.spec.ts

@@ -0,0 +1,89 @@
+import { expect, test } from '@playwright/test';
+
+test('buyer can understand product and start onboarding', async ({ page }) => {
+  await page.goto('/');
+  await expect(
+    page.getByRole('heading', { name: /one scheduling source of truth/i }),
+  ).toBeVisible();
+  await page.getByRole('link', { name: /start free/i }).first().click();
+  await expect(
+    page.getByRole('heading', { name: /create your availsync workspace/i }),
+  ).toBeVisible();
+});
+
+test('pricing shows all plans', async ({ page }) => {
+  await page.goto('/pricing');
+  await expect(page.getByText('Free', { exact: true })).toBeVisible();
+  await expect(page.getByText('Individual', { exact: true })).toBeVisible();
+  await expect(page.getByText('Team', { exact: true })).toBeVisible();
+});
+
+test('docs quickstart includes API commands', async ({ page }) => {
+  await page.goto('/docs/quickstart');
+  await expect(page.getByRole('heading', { name: 'Create org' })).toBeVisible();
+  await expect(page.getByRole('heading', { name: 'Check availability' })).toBeVisible();
+  await expect(page.getByRole('heading', { name: 'Book hold' })).toBeVisible();
+});
+
+test('buyer can create workspace, check availability, and manage a hold', async ({ page }) => {
+  const localInputValue = (date: Date) => {
+    const offsetDate = new Date(date.getTime() - date.getTimezoneOffset() * 60_000);
+    return offsetDate.toISOString().slice(0, 16);
+  };
+
+  const windowStart = new Date(Date.now() + 24 * 60 * 60 * 1000);
+  windowStart.setHours(9, 0, 0, 0);
+  const availabilityEnd = new Date(windowStart);
+  availabilityEnd.setHours(11, 0, 0, 0);
+  const holdEnd = new Date(windowStart);
+  holdEnd.setMinutes(holdEnd.getMinutes() + 30);
+
+  await page.goto('/signup');
+  await page.getByLabel('Organization name').fill(`AvailSync E2E ${Date.now()}`);
+  await page.getByRole('button', { name: 'Create organization' }).click();
+
+  await expect(page.getByRole('heading', { name: /create your first ai agent/i })).toBeVisible();
+  await page.getByRole('button', { name: 'Create agent and window' }).click();
+  await expect(page.getByText('Copy this API key now')).toBeVisible();
+
+  const session = await page.evaluate(() => {
+    const session = window.localStorage.getItem('availsync_session');
+    return session ? JSON.parse(session) : null;
+  });
+  expect(session?.orgId).toBeTruthy();
+  expect(session?.apiKey).toBeTruthy();
+  const orgId = session.orgId;
+
+  await page.evaluate(() => window.localStorage.removeItem('availsync_session'));
+  await page.goto('/login');
+  await page.getByLabel('Agent API key').fill(session.apiKey);
+  await page.getByRole('button', { name: 'Sign in' }).click();
+  await expect(page.getByText('Connected')).toBeVisible();
+
+  await page.goto('/app');
+  await page.getByRole('link', { name: 'Upgrade', exact: true }).click();
+  await expect(page.getByRole('heading', { name: /simple pricing/i })).toBeVisible();
+  await page.goto('/app');
+  await expect(page.getByText('Connected')).toBeVisible();
+  await page.getByRole('link', { name: 'Upgrade plan' }).click();
+  await expect(page.getByRole('heading', { name: /checkout for individual/i })).toBeVisible();
+  await expect(page.getByLabel('Organization ID')).toHaveValue(orgId);
+
+  await page.goto('/app');
+  await page.getByRole('link', { name: 'Check availability' }).click();
+  await expect(page.getByRole('heading', { name: 'Availability' })).toBeVisible();
+  await page.getByLabel('From', { exact: true }).fill(localInputValue(windowStart));
+  await page.getByLabel('To', { exact: true }).fill(localInputValue(availabilityEnd));
+  await page.getByLabel('Duration minutes', { exact: true }).fill('30');
+  await page.getByRole('button', { name: 'Check availability' }).click();
+  await expect(page.getByText(/Confidence/).first()).toBeVisible();
+
+  await page.getByRole('link', { name: 'Holds' }).click();
+  await expect(page.getByRole('heading', { name: 'Holds' })).toBeVisible();
+  await page.getByLabel('Start', { exact: true }).fill(localInputValue(windowStart));
+  await page.getByLabel('End', { exact: true }).fill(localInputValue(holdEnd));
+  await page.getByRole('button', { name: 'Create hold' }).click();
+  await expect(page.getByRole('button', { name: 'Release' }).first()).toBeVisible();
+  await page.getByRole('button', { name: 'Release' }).first().click();
+  await expect(page.getByRole('button', { name: 'Release' })).toHaveCount(0);
+});

package/frontend/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["dom", "dom.iterable", "ES2022"],
+    "allowJs": false,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [{ "name": "next" }],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

package/jest.config.js

@@ -0,0 +1,7 @@
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  testMatch: ['**/tests/**/*.test.ts'],
+  modulePathIgnorePatterns: ['<rootDir>/frontend/.next', '<rootDir>/frontend/node_modules'],
+  setupFiles: ['<rootDir>/tests/setup.ts']
+};

package/nixpacks.toml

@@ -0,0 +1,11 @@
+[variables]
+NIXPACKS_NODE_VERSION = "22"
+
+[phases.install]
+cmds = ["npm ci --include=dev", "npm ci --prefix frontend --include=dev"]
+
+[phases.build]
+cmds = ["npm run build", "npm prune --omit=dev", "npm prune --prefix frontend --omit=dev"]
+
+[start]
+cmd = "npm run start"

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "availsync",
+  "version": "0.1.0",
+  "engines": {
+    "node": "22.x"
+  },
+  "scripts": {
+    "build": "tsc && npm run build --prefix frontend",
+    "build:api": "tsc",
+    "build:frontend": "npm run build --prefix frontend",
+    "build:sdk": "npm run build --prefix packages/node",
+    "build:mcp": "npm run build --prefix packages/mcp",
+    "start": "node dist/server.js",
+    "dev": "ts-node-dev --respawn src/index.ts",
+    "test": "jest --runInBand",
+    "test:sdk": "npm run test --prefix packages/node",
+    "test:mcp": "npm run test --prefix packages/mcp",
+    "typecheck:sdk": "npm run typecheck --prefix packages/node",
+    "migrate": "ts-node src/db/run-migrations.ts",
+    "lint": "eslint src --ext .ts",
+    "mcp": "ts-node src/mcp/server.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "bcrypt": "^6.0.0",
+    "cors": "^2.8.6",
+    "date-fns": "^4.1.0",
+    "express": "^4.22.1",
+    "express-rate-limit": "^8.5.1",
+    "helmet": "^8.1.0",
+    "pg": "^8.20.0",
+    "stripe": "^22.1.1",
+    "uuid": "^14.0.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/bcrypt": "^6.0.0",
+    "@types/cors": "^2.8.19",
+    "@types/express": "^4.17.25",
+    "@types/jest": "^30.0.0",
+    "@types/pg": "^8.20.0",
+    "@types/supertest": "^7.2.0",
+    "@types/uuid": "^10.0.0",
+    "eslint": "^10.3.0",
+    "jest": "^30.4.2",
+    "prettier": "^3.8.3",
+    "supertest": "^7.2.2",
+    "ts-jest": "^29.4.9",
+    "ts-node": "^10.9.2",
+    "ts-node-dev": "^2.0.0",
+    "typescript": "^5.9.3"
+  }
+}

package/packages/mcp/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Availsync
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/packages/mcp/README.md

@@ -0,0 +1,60 @@
+# @availsync/mcp
+
+MCP server for Availsync. Use it with Claude Desktop, Cursor, or another stdio MCP client so an agent can check availability, preview conflicts, claim a repo/project, extend a live claim, and release it when finished.
+
+## Install
+
+Use the explicit alpha tag during the pilot:
+
+```bash
+npx -y @availsync/mcp@alpha --help
+```
+
+## Claude or Cursor config
+
+```json
+{
+  "mcpServers": {
+    "availsync": {
+      "command": "npx",
+      "args": ["-y", "@availsync/mcp@alpha"],
+      "env": {
+        "AVAILSYNC_API_URL": "https://availsync.dev",
+        "AVAILSYNC_AGENT_ID": "AGENT_ID",
+        "AVAILSYNC_API_KEY": "API_KEY"
+      }
+    }
+  }
+}
+```
+
+## Environment
+
+```bash
+AVAILSYNC_API_URL=https://availsync.dev
+AVAILSYNC_AGENT_ID=AGENT_ID
+AVAILSYNC_API_KEY=API_KEY
+```
+
+`AVAILSYNC_API_KEY` is a runtime secret. Keep it in your MCP/client secret store or environment, not in prompts, repos, or browser-visible code.
+
+`AVAILSYNC_AGENT_ID` is used as the default agent for tools. You may still pass `agent_id` in a tool call to override it. If neither is present, the MCP tool returns a clear configuration error without exposing secrets.
+
+## Tools
+
+- `check_work_slot`
+- `claim_work_slot` uses `/v1/work/run/start` and returns `proceed` or `skip_run`.
+- `extend_work_slot` uses `/v1/work/run/extend`.
+- `release_work_slot` uses `/v1/work/run/finish`.
+- `check_availability`
+- `preview_conflict`
+- `book_slot`
+- `release_slot`
+
+Recommended pilot and production-like flow for coding agents:
+
+```text
+heartbeat -> check_work_slot -> claim_work_slot -> extend_work_slot while working -> release_work_slot
+```
+
+If Availsync is unavailable in enforce mode, stop the agent run instead of editing files unguarded. In observe mode, `claim_work_slot` can proceed without creating a lease and include shadow metadata about what would have been blocked.

package/packages/mcp/jest.config.cjs

@@ -0,0 +1,8 @@
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  testMatch: ['<rootDir>/src/**/*.test.ts'],
+  transform: {
+    '^.+\\.ts$': ['ts-jest', { tsconfig: '<rootDir>/tsconfig.test.json' }],
+  },
+};

package/packages/mcp/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@availsync/mcp",
+  "version": "0.1.0-alpha.3",
+  "description": "MCP server for Availsync coding-agent and scheduling guardrails.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "bin": {
+    "mcp": "dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "homepage": "https://availsync.dev/docs/quickstart",
+  "keywords": [
+    "availsync",
+    "mcp",
+    "claude",
+    "cursor",
+    "ai-agents",
+    "coding-agents",
+    "guardrails",
+    "repo-locks"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "tag": "alpha"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepack": "npm run build",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "start": "node dist/index.js",
+    "test": "jest --config jest.config.cjs --runInBand",
+    "test:help": "npm run build && node dist/index.js --help"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.4.3"
+  }
+}

package/packages/mcp/src/helpers.ts

@@ -0,0 +1,38 @@
+export function configuredAgentId(): string | null {
+  return process.env.AVAILSYNC_AGENT_ID?.trim() || null;
+}
+
+export function requireAgentId(inputAgentId?: string): string {
+  const agentId = inputAgentId ?? configuredAgentId();
+  if (!agentId) {
+    throw new Error(
+      'agent_id is required. Pass agent_id in the tool call or set AVAILSYNC_AGENT_ID in the MCP server environment.',
+    );
+  }
+  return agentId;
+}
+
+export function idempotencyHeaders(idempotencyKey?: string): Record<string, string> {
+  return idempotencyKey ? { 'Idempotency-Key': idempotencyKey } : {};
+}
+
+export function parseResponseBody(text: string, response: Response): unknown {
+  if (!text) return {};
+  const contentType = response.headers.get('content-type') ?? '';
+  if (!contentType.includes('application/json')) {
+    return {
+      error: 'non_json_response',
+      status: response.status,
+      body_preview: text.slice(0, 300),
+    };
+  }
+  try {
+    return JSON.parse(text) as unknown;
+  } catch {
+    return {
+      error: 'invalid_json_response',
+      status: response.status,
+      body_preview: text.slice(0, 300),
+    };
+  }
+}

package/packages/mcp/src/index.test.ts

@@ -0,0 +1,60 @@
+import { idempotencyHeaders, parseResponseBody, requireAgentId } from './helpers';
+
+describe('MCP configuration helpers', () => {
+  const previousAgentId = process.env.AVAILSYNC_AGENT_ID;
+
+  afterEach(() => {
+    if (previousAgentId == null) {
+      delete process.env.AVAILSYNC_AGENT_ID;
+    } else {
+      process.env.AVAILSYNC_AGENT_ID = previousAgentId;
+    }
+  });
+
+  test('defaults agent id from AVAILSYNC_AGENT_ID', () => {
+    process.env.AVAILSYNC_AGENT_ID = '11111111-1111-4111-8111-111111111111';
+
+    expect(requireAgentId()).toBe('11111111-1111-4111-8111-111111111111');
+  });
+
+  test('tool input agent id overrides env default', () => {
+    process.env.AVAILSYNC_AGENT_ID = '11111111-1111-4111-8111-111111111111';
+
+    expect(requireAgentId('22222222-2222-4222-8222-222222222222')).toBe('22222222-2222-4222-8222-222222222222');
+  });
+
+  test('missing agent id produces a clear setup error', () => {
+    delete process.env.AVAILSYNC_AGENT_ID;
+
+    expect(() => requireAgentId()).toThrow('agent_id is required');
+  });
+
+  test('idempotency header is omitted unless explicitly supplied', () => {
+    expect(idempotencyHeaders()).toEqual({});
+    expect(idempotencyHeaders('run-123')).toEqual({ 'Idempotency-Key': 'run-123' });
+  });
+});
+
+describe('MCP upstream response parsing', () => {
+  test('returns non_json_response with safe preview', () => {
+    const response = new Response('<html>bad gateway with secretless body</html>', {
+      status: 502,
+      headers: { 'content-type': 'text/html' },
+    });
+
+    expect(parseResponseBody('<html>bad gateway with secretless body</html>', response)).toEqual({
+      error: 'non_json_response',
+      status: 502,
+      body_preview: '<html>bad gateway with secretless body</html>',
+    });
+  });
+
+  test('parses JSON responses', () => {
+    const response = new Response('{"ok":true}', {
+      status: 200,
+      headers: { 'content-type': 'application/json' },
+    });
+
+    expect(parseResponseBody('{"ok":true}', response)).toEqual({ ok: true });
+  });
+});