feat: add custom service

Author: dinhanhthi

docs/changelog.md

@@ -1,109 +1,80 @@
 # Changelog
 
+## v1.7.0 - Custom service support
+
+- Custom AI service management: add services with name, description, icon, config path, and file patterns
+- DB migration: add `description` and `icon_path` to `service_configs`
+
 ## v1.6.0 - Multi-machine support
 
-- **New:** Multi-machine support — each machine gets a unique ID and name, stored in local config (`~/.ai-sync/config.json`)
-- **New:** Git-tracked `machines.json` in the store repo maps repo/service paths per machine, enabling cross-machine sync with different absolute paths
-- **New:** Auto-link on startup — repos with valid path mappings for the current machine are automatically registered in the local database
-- **New:** Unlinked repos detection — dashboard shows store repos that exist but aren't linked on the current machine, with manual link and auto-link options
-- **New:** Machine name displayed in the footer alongside the data directory
-- **New:** Settings "Machine" tab — edit machine name, view machine ID, see all known machines
+- Multi-machine support with unique machine ID/name per device
+- Git-tracked `machines.json` maps repo/service paths per machine for cross-machine sync
+- Auto-link repos on startup; dashboard shows unlinked repos with link options
 
 ## v1.5.1
 
-- **New:** Right-click "Delete" on file tree — deletes files/folders from both store and target repo, with empty parent directory cleanup
-- **New:** Size labels: normal (<1 MB), amber (1–10 MB), red (>10 MB), violet (>50 MB)
-- **Perf:** code-splitting with manual chunks (React, CodeMirror, Radix, Markdown) and lazy-loaded routes
-- **Perf:** removed Framer Motion (~150 KB) — replaced with CSS transitions
-- **New:** Build a single commit message from a batch of messages
-- **New:** "Apply .gitignore" button in repo settings and global settings — re-applies managed `.gitignore` block and untracks files from git (useful after cloning the data repo)
-- **New:** Search button in pattern lists — filter patterns by keyword
+- Right-click "Delete" on file tree (removes from both store and target)
+- File size labels: normal (<1 MB), amber (1–10 MB), red (>10 MB), violet (>50 MB)
+- Batch commit message builder
+- "Apply .gitignore" button in repo/global settings
+- Search in pattern lists
+- Code-splitting, lazy-loaded routes, removed Framer Motion
 
-## v1.5.0 - Breaking change - Removed desktop apps
+## v1.5.0 - Removed desktop app
 
-- Removed desktop app (Tauri v2) — the project now runs as a web app only (`pnpm build && pnpm start`)
-- Removed sidecar build pipeline, Tauri CORS origins, and all desktop-related code
-- Simplified UI API client and WebSocket client (no more port-based routing for Tauri)
+- Removed Tauri v2 desktop app — web app only (`pnpm build && pnpm start`)
 
 ## v1.4.2
 
-- **Fix:** `FOREIGN KEY constraint failed` error when syncing services — `sync_log.repo_id` had a foreign key referencing `repos(id)` but services write `service_config_id` into that column
+- Fix: `FOREIGN KEY constraint failed` when syncing services
 
 ## v1.4.1
 
-- **Fix:** `.gitignore` managed block now syncs with file pattern settings — adding/removing/disabling patterns updates all active repos' `.gitignore` files automatically
-- **Fix:** false conflicts in service sync (e.g. `~/.claude/`) caused by uncommitted store git changes
-- **Fix:** Adding ignore patterns now takes effect immediately — matching tracked files are untracked and removed from store on save
-- **Fix:** Repo watcher now restarts when ignore patterns change
-- **New:** Search files in file tree
-- **New:** Ignore patterns for services — override global ignore patterns or add custom ones per service (same as repos)
-- **New:** Right-click context menu on file tree — "Ignore this file/folder" adds the pattern to ignore list and immediately untracks matching files
-- **New:** toggle button to show largest files in file tree
-- **Security:** path traversal protection (`safeJoin`) on all file routes — prevents `../` escape from store/repo directories
-- **Security:** command injection fix in open-folder — replaced shell-spawning `exec` with `execFile`
-- **Security:** CORS restricted to `localhost` / `127.0.0.1` only (was `origin: true`)
-- **Security:** default listen host changed from `0.0.0.0` to `127.0.0.1`
-- **Security:** symlink target validation — rejects absolute paths and `..` escaping
-- **Security:** WebSocket `maxPayload` limit (1 MB)
-- **Security:** sync_log auto-cleanup (entries older than 30 days removed on startup)
-- **Perf:** N+1 query fix in repo/service listing — single aggregating SQL instead of per-item queries
-- **Perf:** polling `setInterval` replaced with `setTimeout` chain — prevents overlapping sync cycles
-- **Perf:** `picomatch` compiled matchers cached per pattern set
-- **Perf:** periodic cleanup of file watcher `selfChanges` map (prevents memory leak)
-- **Perf:** added missing `idx_conflicts_tracked_file` database index
+- Fix: `.gitignore` managed block syncs with pattern settings changes
+- Fix: false conflicts from uncommitted store git changes
+- Fix: ignore pattern changes take effect immediately and restart watchers
+- File tree: search, right-click "Ignore", show largest files toggle
+- Per-service ignore pattern overrides
+- Security: path traversal protection, command injection fix, CORS/host lockdown, symlink validation, WebSocket payload limit, sync_log auto-cleanup
+- Perf: N+1 query fix, non-overlapping sync cycles, picomatch caching, DB index
 
 ## v1.4.0
 
-- **New:** AI Service Config sync: sync local AI service settings (e.g., `~/.claude/` for Claude Code)
-- Merged repo and service detail pages into a shared component (reduced code duplication)
-- **New:** Showing size information:
-  - Show total store size per repo/service on dashboard cards and detail pages
-  - Per-file size display in repo/service detail file tree
-  - Aggregated folder sizes in file tree (computed client-side from per-file data)
-  - Size warning indicators: yellow (20-50 MB), red (50-100 MB)
-  - Sync blocked automatically when store size exceeds 100 MB with clear banner
-  - Customizable size thresholds (warning, danger, block) in Settings > General
+- AI Service Config sync (e.g., `~/.claude/` for Claude Code)
+- Store size display on dashboard and detail pages with warning indicators
+- Sync blocked when store size exceeds threshold (configurable in Settings)
 
 ## v1.3.1
 
-- Local patterns now always on top, global below (with divider) in repo settings
+- Local patterns always shown above global patterns in repo settings
 
 ## v1.3.0
 
-- **New:** Per-repository settings with local overrides for general settings, AI file patterns, and ignore patterns
-- **New:** Update notification from GitHub Releases
-- **New:** Clone files/folders across repos with conflict preview
-- **New:** Dashboard filter for repos with unresolved conflicts
+- Per-repository settings with local overrides
+- Update notification from GitHub Releases
+- Clone files/folders across repos with conflict preview
+- Dashboard filter for unresolved conflicts
 
 ## v1.2.1
 
-- **Fix:** "Clean" in settings now also commits in git
-- **Fix:** `__pycache__/` pattern not ignored correctly
-- **Fix:** Conflict warnings not refreshing on repo removal
+- Fix: "Clean" now commits in git, `__pycache__/` ignore, conflict refresh on repo removal
 
 ## v1.2.0
 
-- **New:** Desktop app (Tauri v2) with bundled sidecar server
+- Desktop app (Tauri v2) — later removed in v1.5.0
 - Rebranded from `local-ai-stuffs` to `ai-sync`
 
-## v1.1.1 & v1.1.2
-
-- UI improvements
-
-## v1.1.0
+## v1.1.x
 
-- **New:** Ignore patterns with configurable globs and "Clean" button
-- **New:** Favorite repositories
-- **New:** Symbolic link support
-- **New:** New default patterns: `.agent/**`, `.agents/**`, `.gemini/**`, `.github/skills/**`, `.opencode/**`
-- **Fix:** conflict resolver refresh, editor content updates, symlink sync
+- Ignore patterns with configurable globs and "Clean" button
+- Favorite repositories, symbolic link support
+- Default patterns: `.agent/**`, `.agents/**`, `.gemini/**`, `.github/skills/**`, `.opencode/**`
+- Bug fixes and UI improvements
 
 ## v1.0.0
 
 - Central store as git repo for AI config files
-- Bidirectional sync with chokidar watchers
-- Git-based 3-way merge and auto-merge
-- Web Admin UI (React SPA, CodeMirror 6 editor, conflict resolver)
+- Bidirectional sync with git-based 3-way merge
+- Web Admin UI with CodeMirror editor and conflict resolver
 - Template system, file pattern management, gitignore management
-- Remote publishing, WebSocket events, setup wizard, pause/resume
 - Supported: Claude Code, Cursor, Gemini, GitHub Copilot, Aider, Windsurf

package.json

@@ -1,7 +1,7 @@
 {
   "name": "ai-sync",
   "author": "Anh-Thi Dinh",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "repository": "https://github.com/anhthiding/ai-sync",
   "private": true,
   "license": "MIT",

packages/server/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ai-sync/server",
   "author": "Anh-Thi Dinh",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "repository": "https://github.com/anhthiding/ai-sync",
   "private": true,
   "license": "MIT",
@@ -15,6 +15,7 @@
   },
   "dependencies": {
     "@fastify/cors": "^11.0.0",
+    "@fastify/multipart": "^9.4.0",
     "@fastify/static": "^8.1.0",
     "@fastify/websocket": "^11.0.0",
     "better-sqlite3": "^11.7.0",

packages/server/src/app.ts

@@ -2,6 +2,7 @@ import Fastify from 'fastify';
 import fastifyStatic from '@fastify/static';
 import fastifyCors from '@fastify/cors';
 import fastifyWebsocket from '@fastify/websocket';
+import fastifyMultipart from '@fastify/multipart';
 import fs from 'node:fs';
 import { config } from './config.js';
 import { registerRepoRoutes } from './routes/repos.js';
@@ -25,6 +26,7 @@ export async function buildApp(state: AppState) {
     origin: [/^https?:\/\/localhost(:\d+)?$/, /^https?:\/\/127\.0\.0\.1(:\d+)?$/],
   });
   await app.register(fastifyWebsocket, { options: { maxPayload: 1048576 } });
+  await app.register(fastifyMultipart, { limits: { fileSize: 2 * 1024 * 1024 } });
 
   // All routes are always registered — they check state.db/state.syncEngine internally
   registerSetupRoutes(app, state);

packages/server/src/db/index.ts

@@ -2,6 +2,7 @@ import Database from 'better-sqlite3';
 import fs from 'node:fs';
 import path from 'node:path';
 import { initSchema } from './schema.js';
+import { registerCustomDefinition } from '../services/service-definitions.js';
 
 let db: Database.Database | null = null;
 
@@ -16,6 +17,29 @@ export function initDb(dbPath: string): Database.Database {
   return db;
 }
 
+/**
+ * Load custom service definitions from DB into the runtime registry.
+ * Custom services have service_type starting with "custom-".
+ */
+export function loadCustomServiceDefinitions(database: Database.Database): void {
+  const rows = database
+    .prepare(
+      "SELECT service_type, name, local_path FROM service_configs WHERE service_type LIKE 'custom-%'",
+    )
+    .all() as { service_type: string; name: string; local_path: string }[];
+
+  for (const row of rows) {
+    // Patterns are stored in service_settings, not in the definition.
+    // registerCustomDefinition sets patterns to [] to avoid duplication.
+    registerCustomDefinition({
+      serviceType: row.service_type,
+      name: row.name,
+      defaultPath: row.local_path,
+      patterns: [],
+    });
+  }
+}
+
 export function getDb(): Database.Database {
   if (!db) {
     throw new Error('Database not initialized. Call initDb() first.');

packages/server/src/db/schema.ts

@@ -240,6 +240,13 @@ function runMigrations(db: Database.Database): void {
         CREATE INDEX IF NOT EXISTS idx_sync_log_created ON sync_log(created_at);
       `,
     },
+    {
+      version: 10,
+      sql: `
+        ALTER TABLE service_configs ADD COLUMN description TEXT NOT NULL DEFAULT '';
+        ALTER TABLE service_configs ADD COLUMN icon_path TEXT DEFAULT NULL;
+      `,
+    },
   ];
 
   for (const m of migrations) {

packages/server/src/index.ts

@@ -1,5 +1,5 @@
 import { buildApp } from './app.js';
-import { initDb } from './db/index.js';
+import { initDb, loadCustomServiceDefinitions } from './db/index.js';
 import { config, isConfigured, ensureMachineId } from './config.js';
 import { initStoreRepo, commitStoreChanges } from './services/store-git.js';
 import { SyncEngine } from './services/sync-engine.js';
@@ -15,6 +15,7 @@ async function main() {
     ensureMachineId();
 
     state.db = initDb(config.dbPath);
+    loadCustomServiceDefinitions(state.db);
     console.log(`Database initialized at ${config.dbPath}`);
 
     await initStoreRepo();