@agents-dev/cli 0.8.0 → 0.8.2

package/dist/core/updateCheck.js

@@ -0,0 +1,227 @@
+import os from 'node:os';
+import path from 'node:path';
+import { pathExists, readJson, writeJsonAtomic } from './fs.js';
+import { getProjectPaths } from './paths.js';
+import * as ui from './ui.js';
+const NPM_LATEST_URL = 'https://registry.npmjs.org/@agents-dev/cli/latest';
+const DEFAULT_TIMEOUT_MS = 1500;
+const STARTUP_RECHECK_MS = 6 * 60 * 60 * 1000;
+export const UPGRADE_COMMAND = 'npm install -g @agents-dev/cli@latest';
+export async function checkForUpdates(options) {
+    const now = new Date();
+    const nowIso = now.toISOString();
+    const timeoutMs = normalizeTimeout(options.timeoutMs);
+    const storage = await loadStorageState(options.projectRoot);
+    const metadata = readUpdateMetadata(storage.document);
+    const channel = resolveUpdateChannel();
+    if (!channel.ok) {
+        metadata.lastSeenVersion = options.currentVersion;
+        writeUpdateMetadata(storage.document, storage.kind, metadata);
+        await writeJsonAtomic(storage.filePath, storage.document);
+        return {
+            currentVersion: options.currentVersion,
+            latestVersion: normalizeVersion(metadata.latestVersion),
+            isOutdated: false,
+            upgradeCommand: UPGRADE_COMMAND,
+            checkedAt: metadata.lastCheckedAt ?? nowIso,
+            source: 'unavailable',
+            error: channel.error
+        };
+    }
+    let source = 'cache';
+    let latestVersion = normalizeVersion(metadata.latestVersion);
+    let errorMessage;
+    const shouldRefresh = options.forceRefresh === true || !isRecent(metadata.lastCheckedAt, STARTUP_RECHECK_MS);
+    if (!latestVersion || shouldRefresh) {
+        const fetched = await fetchLatestVersion(timeoutMs);
+        if (fetched.version) {
+            latestVersion = fetched.version;
+            metadata.latestVersion = fetched.version;
+            metadata.lastCheckedAt = nowIso;
+            source = 'network';
+        }
+        else if (latestVersion) {
+            source = 'cache-stale';
+            errorMessage = fetched.error;
+        }
+        else {
+            source = 'unavailable';
+            errorMessage = fetched.error;
+        }
+    }
+    metadata.lastSeenVersion = options.currentVersion;
+    const isOutdated = compareVersions(options.currentVersion, latestVersion) < 0;
+    if (isOutdated && options.markNotifiedIfOutdated) {
+        metadata.lastNotifiedAt = nowIso;
+    }
+    writeUpdateMetadata(storage.document, storage.kind, metadata);
+    await writeJsonAtomic(storage.filePath, storage.document);
+    return {
+        currentVersion: options.currentVersion,
+        latestVersion,
+        isOutdated,
+        upgradeCommand: UPGRADE_COMMAND,
+        checkedAt: metadata.lastCheckedAt ?? nowIso,
+        source,
+        error: errorMessage
+    };
+}
+export async function maybeNotifyAboutUpdate(args) {
+    try {
+        const status = await checkForUpdates({
+            currentVersion: args.currentVersion,
+            projectRoot: args.projectRoot,
+            markNotifiedIfOutdated: true
+        });
+        if (!status.isOutdated || !status.latestVersion)
+            return;
+        ui.blank();
+        ui.warning(`Update available: ${status.currentVersion} -> ${status.latestVersion}`);
+        ui.hint(`Run "${status.upgradeCommand}"`);
+    }
+    catch {
+        // Update checks should never block command execution.
+    }
+}
+async function loadStorageState(projectRoot) {
+    const projectLocalPath = projectRoot ? getProjectPaths(projectRoot).agentsLocal : undefined;
+    if (projectLocalPath && (await pathExists(projectLocalPath))) {
+        return {
+            kind: 'project-local',
+            filePath: projectLocalPath,
+            document: await readDocument(projectLocalPath)
+        };
+    }
+    const globalPath = path.join(os.homedir(), '.agents-dev', 'update-check.json');
+    return {
+        kind: 'global',
+        filePath: globalPath,
+        document: await readDocument(globalPath)
+    };
+}
+async function readDocument(filePath) {
+    if (!(await pathExists(filePath)))
+        return {};
+    try {
+        const parsed = await readJson(filePath);
+        return typeof parsed === 'object' && parsed !== null ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+function readUpdateMetadata(document) {
+    const meta = asObject(document.meta);
+    const updateCheck = asObject(meta?.updateCheck);
+    return {
+        lastCheckedAt: asString(updateCheck?.lastCheckedAt),
+        lastSeenVersion: asString(updateCheck?.lastSeenVersion),
+        lastNotifiedAt: asString(updateCheck?.lastNotifiedAt),
+        latestVersion: asString(updateCheck?.latestVersion)
+    };
+}
+function writeUpdateMetadata(document, kind, metadata) {
+    if (kind === 'project-local' && !asObject(document.mcpServers)) {
+        document.mcpServers = {};
+    }
+    const meta = asObject(document.meta) ?? {};
+    meta.updateCheck = {
+        ...(asObject(meta.updateCheck) ?? {}),
+        ...metadata
+    };
+    document.meta = meta;
+}
+async function fetchLatestVersion(timeoutMs) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(NPM_LATEST_URL, {
+            headers: { Accept: 'application/json' },
+            signal: controller.signal
+        });
+        if (!response.ok) {
+            return { version: null, error: `registry request failed (${response.status})` };
+        }
+        const payload = await response.json();
+        const version = normalizeVersion(typeof payload.version === 'string' ? payload.version : null);
+        if (!version) {
+            return { version: null, error: 'invalid registry response' };
+        }
+        return { version };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { version: null, error: message };
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+function normalizeTimeout(input) {
+    if (!Number.isFinite(input))
+        return DEFAULT_TIMEOUT_MS;
+    if (!input || input <= 0)
+        return DEFAULT_TIMEOUT_MS;
+    return Math.floor(input);
+}
+function isRecent(value, thresholdMs) {
+    if (!value)
+        return false;
+    const parsed = Date.parse(value);
+    if (!Number.isFinite(parsed))
+        return false;
+    return Date.now() - parsed <= thresholdMs;
+}
+function normalizeVersion(value) {
+    if (!value)
+        return null;
+    const trimmed = value.trim();
+    if (!trimmed)
+        return null;
+    return trimmed.startsWith('v') ? trimmed.slice(1) : trimmed;
+}
+function compareVersions(current, latest) {
+    if (!latest)
+        return 0;
+    const a = parseSemver(current);
+    const b = parseSemver(latest);
+    if (!a || !b)
+        return 0;
+    for (let i = 0; i < 3; i += 1) {
+        if (a[i] === b[i])
+            continue;
+        return a[i] < b[i] ? -1 : 1;
+    }
+    return 0;
+}
+function parseSemver(value) {
+    const match = value.trim().match(/^v?(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/);
+    if (!match)
+        return null;
+    const major = Number.parseInt(match[1], 10);
+    const minor = Number.parseInt(match[2], 10);
+    const patch = Number.parseInt(match[3], 10);
+    if (![major, minor, patch].every((part) => Number.isInteger(part))) {
+        return null;
+    }
+    return [major, minor, patch];
+}
+function asObject(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return undefined;
+    return value;
+}
+function asString(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+function resolveUpdateChannel() {
+    const raw = (process.env.AGENTS_UPDATE_CHANNEL ?? 'stable').trim().toLowerCase();
+    if (!raw || raw === 'stable') {
+        return { ok: true, value: 'stable' };
+    }
+    return {
+        ok: false,
+        error: `unsupported update channel "${raw}" (only "stable" is currently supported)`
+    };
+}
+//# sourceMappingURL=updateCheck.js.map

package/dist/core/updateCheck.js.map

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

package/dist/core/version.d.ts

@@ -0,0 +1 @@
+export declare const CLI_VERSION = "0.8.2";

package/dist/core/version.js

@@ -0,0 +1,2 @@
+export const CLI_VERSION = '0.8.2';
+//# sourceMappingURL=version.js.map

package/dist/core/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/core/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAA"}

package/dist/core/windsurfPaths.d.ts

@@ -0,0 +1,8 @@
+export interface WindsurfMcpPathResolution {
+    configPath: string;
+    source: 'env' | 'existing-modern' | 'existing-legacy' | 'default-modern';
+    modernPath: string;
+    legacyPath: string;
+}
+export declare function resolveWindsurfMcpConfigPath(): Promise<WindsurfMcpPathResolution>;
+export declare function getWindsurfMcpLockPath(configPath: string): string;

package/dist/core/windsurfPaths.js

@@ -0,0 +1,43 @@
+import os from 'node:os';
+import path from 'node:path';
+import { pathExists } from './fs.js';
+const ENV_OVERRIDE = 'AGENTS_WINDSURF_MCP_CONFIG_PATH';
+export async function resolveWindsurfMcpConfigPath() {
+    const modernPath = path.join(os.homedir(), '.codeium', 'windsurf', 'mcp_config.json');
+    const legacyPath = path.join(os.homedir(), '.codeium', 'mcp_config.json');
+    const override = process.env[ENV_OVERRIDE]?.trim();
+    if (override) {
+        return {
+            configPath: path.resolve(override),
+            source: 'env',
+            modernPath,
+            legacyPath
+        };
+    }
+    if (await pathExists(modernPath)) {
+        return {
+            configPath: modernPath,
+            source: 'existing-modern',
+            modernPath,
+            legacyPath
+        };
+    }
+    if (await pathExists(legacyPath)) {
+        return {
+            configPath: legacyPath,
+            source: 'existing-legacy',
+            modernPath,
+            legacyPath
+        };
+    }
+    return {
+        configPath: modernPath,
+        source: 'default-modern',
+        modernPath,
+        legacyPath
+    };
+}
+export function getWindsurfMcpLockPath(configPath) {
+    return path.join(path.dirname(configPath), `${path.basename(configPath)}.agents.lock`);
+}
+//# sourceMappingURL=windsurfPaths.js.map

package/dist/core/windsurfPaths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windsurfPaths.js","sourceRoot":"","sources":["../../src/core/windsurfPaths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEpC,MAAM,YAAY,GAAG,iCAAiC,CAAA;AAStD,MAAM,CAAC,KAAK,UAAU,4BAA4B;IAChD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAA;IACrF,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAA;IACzE,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAA;IAElD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;YAClC,MAAM,EAAE,KAAK;YACb,UAAU;YACV,UAAU;SACX,CAAA;IACH,CAAC;IAED,IAAI,MAAM,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACjC,OAAO;YACL,UAAU,EAAE,UAAU;YACtB,MAAM,EAAE,iBAAiB;YACzB,UAAU;YACV,UAAU;SACX,CAAA;IACH,CAAC;IAED,IAAI,MAAM,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACjC,OAAO;YACL,UAAU,EAAE,UAAU;YACtB,MAAM,EAAE,iBAAiB;YACzB,UAAU;YACV,UAAU;SACX,CAAA;IACH,CAAC;IAED,OAAO;QACL,UAAU,EAAE,UAAU;QACtB,MAAM,EAAE,gBAAgB;QACxB,UAAU;QACV,UAAU;KACX,CAAA;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,UAAkB;IACvD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,cAAc,CAAC,CAAA;AACxF,CAAC"}

package/dist/integrations/windsurf.d.ts

@@ -0,0 +1,9 @@
+import type { ResolvedMcpServer } from '../types.js';
+export declare function buildWindsurfPayload(servers: ResolvedMcpServer[]): {
+    payload: {
+        mcpServers: Record<string, unknown>;
+    };
+    warnings: string[];
+};
+export declare function toManagedWindsurfName(projectHash: string, serverName: string): string;
+export declare function deriveWindsurfProjectHash(projectRoot: string): string;

package/dist/integrations/windsurf.js

@@ -0,0 +1,17 @@
+import { createHash } from 'node:crypto';
+import path from 'node:path';
+import { renderWindsurfMcp } from '../core/renderers.js';
+export function buildWindsurfPayload(servers) {
+    const rendered = renderWindsurfMcp(servers);
+    return {
+        payload: { mcpServers: rendered.servers },
+        warnings: rendered.warnings
+    };
+}
+export function toManagedWindsurfName(projectHash, serverName) {
+    return `agents__${projectHash}__${serverName}`;
+}
+export function deriveWindsurfProjectHash(projectRoot) {
+    return createHash('sha256').update(path.resolve(projectRoot)).digest('hex').slice(0, 12);
+}
+//# sourceMappingURL=windsurf.js.map

package/dist/integrations/windsurf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windsurf.js","sourceRoot":"","sources":["../../src/integrations/windsurf.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAGxD,MAAM,UAAU,oBAAoB,CAAC,OAA4B;IAI/D,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAA;IAC3C,OAAO;QACL,OAAO,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,OAAO,EAAE;QACzC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;KAC5B,CAAA;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,WAAmB,EAAE,UAAkB;IAC3E,OAAO,WAAW,WAAW,KAAK,UAAU,EAAE,CAAA;AAChD,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,WAAmB;IAC3D,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;AAC1F,CAAC"}

package/dist/types.d.ts

@@ -40,8 +40,17 @@ export interface McpServerDefinition {
     targets?: IntegrationName[];
     enabled?: boolean;
 }
+export interface UpdateCheckMetadata {
+    lastCheckedAt?: string;
+    lastSeenVersion?: string;
+    lastNotifiedAt?: string;
+    latestVersion?: string;
+}
 export interface LocalOverridesFile {
     mcpServers: Record<string, Partial<McpServerDefinition>>;
+    meta?: {
+        updateCheck?: UpdateCheckMetadata;
+    };
 }
 export interface VscodeSettingsState {
     managedPaths: string[];

package/docs/EXAMPLES.md

@@ -77,33 +77,6 @@ Each project has its own `.agents/` config. No conflicts.
 
 ---
 
-## CI/CD Integration
-
-**.github/workflows/validate-agents.yml:**
-```yaml
-name: Validate Agents Config
-
-on:
-  pull_request:
-    paths:
-      - '.agents/**'
-
-jobs:
-  validate:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-      - run: npm install -g @agents-dev/cli
-      - run: agents doctor
-      - run: agents mcp test --json
-      - run: agents sync --check
-```
-
----
-
 ## Monorepo
 
 **Root (company-wide servers):**
@@ -196,8 +169,8 @@ Add to `.bashrc`:
 ```bash
 agents_prompt() {
   if [ -d ".agents" ]; then
-    STATUS=$(agents status --fast --json 2>/dev/null | jq -r '.status')
-    [ "$STATUS" = "synced" ] && echo " 🟢" || echo " 🟡"
+    MCP_COUNT=$(agents status --fast --json 2>/dev/null | jq -r '.mcp.configured')
+    [ "${MCP_COUNT:-0}" -gt 0 ] && echo " 🟢" || echo " 🟡"
   fi
 }
 

package/docs/agents-system.md

@@ -68,7 +68,7 @@ project/
 | **Gemini** | `.gemini/settings.json` |
 | **Cursor** | `.cursor/mcp.json` + CLI enable |
 | **Copilot** | `.vscode/mcp.json` |
-| **Antigravity** | `.antigravity/mcp.json` |
+| **Antigravity** | Global user profile `mcp.json` (not project-local) |
 
 ## VS Code Integration
 
@@ -97,6 +97,7 @@ project/
 | **Claude** | Symlink to `.claude/skills/` |
 | **Cursor** | Symlink to `.cursor/skills/` |
 | **Gemini** | Symlink to `.gemini/skills/` |
+| **Antigravity** | Reuses `.gemini/skills/` bridge |
 
 **Validation:** `agents doctor` checks frontmatter (`name`, `description`)
 
@@ -171,7 +172,8 @@ project/
 **Gitignored:**
 - ❌ `.agents/local.json`
 - ❌ `.agents/generated/`
-- ❌ `.codex/`, `.claude/`, `.cursor/`, `.gemini/`, `.antigravity/`
+- ❌ `.codex/`, `.claude/`, `.cursor/`, `.gemini/`
+- ❌ legacy `.antigravity/` (if present from older versions)
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agents-dev/cli",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "description": "One config to rule them all — Practical standard layer for multi-LLM development. Sync MCP servers, skills, and AGENTS.md across Codex, Claude Code, Gemini CLI, Cursor, Copilot, and Antigravity.",
   "main": "dist/cli.js",
   "scripts": {
@@ -8,6 +8,8 @@
     "dev": "tsx src/cli.ts",
     "lint": "eslint .",
     "test": "vitest run",
+    "test:fast": "vitest run --exclude \"tests/**/*.integration.test.ts\"",
+    "test:integration": "vitest run integration.test.ts",
     "prepack": "npm run build"
   },
   "bin": {