@lnai/core 0.3.0 → 0.4.1

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 
 declare const UNIFIED_DIR = ".ai";
-declare const TOOL_IDS: readonly ["claudeCode", "opencode", "cursor", "copilot"];
+declare const TOOL_IDS: readonly ["claudeCode", "opencode", "cursor", "copilot", "windsurf"];
 type ToolId = (typeof TOOL_IDS)[number];
 declare const CONFIG_FILES: {
     readonly config: "config.json";
@@ -67,6 +67,7 @@ declare const toolIdSchema: z.ZodEnum<{
     opencode: "opencode";
     cursor: "cursor";
     copilot: "copilot";
+    windsurf: "windsurf";
 }>;
 /** Settings configuration (Claude format as source of truth) */
 declare const settingsSchema: z.ZodObject<{
@@ -106,6 +107,10 @@ declare const configSchema: z.ZodObject<{
             enabled: z.ZodBoolean;
             versionControl: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         }, z.core.$strip>>;
+        windsurf: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodBoolean;
+            versionControl: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 /** Skill frontmatter (name and description required) */
@@ -243,7 +248,7 @@ declare const claudeCodePlugin: Plugin;
  * OpenCode plugin for exporting to opencode.json format
  *
  * Output structure:
- * - .opencode/AGENTS.md (symlink -> ../.ai/AGENTS.md)
+ * - AGENTS.md (symlink -> .ai/AGENTS.md) [at project root]
  * - .opencode/rules/ (symlink -> ../.ai/rules)
  * - .opencode/skills/<name>/ (symlink -> ../../.ai/skills/<name>)
  * - opencode.json (generated config merged with .ai/.opencode/opencode.json)
@@ -301,12 +306,13 @@ interface InitOptions {
     tools?: ToolId[];
     minimal?: boolean;
     force?: boolean;
+    versionControl?: Record<ToolId, boolean>;
 }
 interface InitResult {
     created: string[];
 }
 declare function initUnifiedConfig(options: InitOptions): Promise<InitResult>;
 declare function hasUnifiedConfig(rootDir: string): Promise<boolean>;
-declare function generateDefaultConfig(tools?: ToolId[]): Config;
+declare function generateDefaultConfig(tools?: ToolId[], versionControl?: Record<ToolId, boolean>): Config;
 
 export { CONFIG_DIRS, CONFIG_FILES, type ChangeResult, type Config, FileNotFoundError, type InitOptions, type InitResult, LnaiError, type MarkdownFile, type MarkdownFrontmatter, type McpServer, type OutputFile, ParseError, type PermissionLevel, type Permissions, type Plugin, PluginError, type RuleFrontmatter, type Settings, type SkillFrontmatter, type SkippedFeatureDetail, type SyncOptions, type SyncResult, TOOL_IDS, TOOL_OUTPUT_DIRS, type ToolConfig, type ToolId, UNIFIED_DIR, type UnifiedState, ValidationError, type ValidationErrorDetail, type ValidationResult, type ValidationWarningDetail, WriteError, type WriterOptions, claudeCodePlugin, computeHash, configSchema, generateDefaultConfig, hasUnifiedConfig, initUnifiedConfig, mcpServerSchema, opencodePlugin, parseFrontmatter, parseUnifiedConfig, permissionsSchema, pluginRegistry, ruleFrontmatterSchema, runSyncPipeline, settingsSchema, skillFrontmatterSchema, toolConfigSchema, toolIdSchema, updateGitignore, validateConfig, validateSettings, validateUnifiedState, writeFiles };

package/dist/index.js

@@ -6,7 +6,13 @@ import * as crypto from 'crypto';
 
 // src/constants.ts
 var UNIFIED_DIR = ".ai";
-var TOOL_IDS = ["claudeCode", "opencode", "cursor", "copilot"];
+var TOOL_IDS = [
+  "claudeCode",
+  "opencode",
+  "cursor",
+  "copilot",
+  "windsurf"
+];
 var CONFIG_FILES = {
   config: "config.json",
   settings: "settings.json",
@@ -21,13 +27,15 @@ var TOOL_OUTPUT_DIRS = {
   claudeCode: ".claude",
   opencode: ".opencode",
   cursor: ".cursor",
-  copilot: ".github"
+  copilot: ".github",
+  windsurf: ".windsurf"
 };
 var OVERRIDE_DIRS = {
   claudeCode: ".claude",
   opencode: ".opencode",
   cursor: ".cursor",
-  copilot: ".copilot"
+  copilot: ".copilot",
+  windsurf: ".windsurf"
 };
 
 // src/errors.ts
@@ -107,7 +115,13 @@ var toolConfigSchema = z.object({
   enabled: z.boolean(),
   versionControl: z.boolean().optional().default(false)
 });
-var toolIdSchema = z.enum(["claudeCode", "opencode", "cursor", "copilot"]);
+var toolIdSchema = z.enum([
+  "claudeCode",
+  "opencode",
+  "cursor",
+  "copilot",
+  "windsurf"
+]);
 var settingsSchema = z.object({
   permissions: permissionsSchema.optional(),
   mcpServers: z.record(z.string(), mcpServerSchema).optional()
@@ -117,7 +131,8 @@ var configSchema = z.object({
     claudeCode: toolConfigSchema,
     opencode: toolConfigSchema,
     cursor: toolConfigSchema,
-    copilot: toolConfigSchema
+    copilot: toolConfigSchema,
+    windsurf: toolConfigSchema
   }).partial().optional()
 });
 var skillFrontmatterSchema = z.object({
@@ -974,9 +989,9 @@ var opencodePlugin = {
     const outputDir = TOOL_OUTPUT_DIRS.opencode;
     if (state.agents) {
       files.push({
-        path: `${outputDir}/AGENTS.md`,
+        path: "AGENTS.md",
         type: "symlink",
-        target: `../${UNIFIED_DIR}/AGENTS.md`
+        target: `${UNIFIED_DIR}/AGENTS.md`
       });
     }
     if (state.rules.length > 0) {
@@ -1021,7 +1036,7 @@ var opencodePlugin = {
     if (!state.agents) {
       warnings.push({
         path: ["AGENTS.md"],
-        message: "No AGENTS.md found - .opencode/AGENTS.md will not be created"
+        message: "No AGENTS.md found - root AGENTS.md will not be created"
       });
     }
     return { valid: true, errors: [], warnings, skipped: [] };
@@ -1049,11 +1064,116 @@ var PluginRegistry = class {
 };
 var pluginRegistry = new PluginRegistry();
 
+// src/plugins/windsurf/transforms.ts
+function transformRuleToWindsurf(rule) {
+  const frontmatter = {
+    trigger: "manual"
+  };
+  return {
+    frontmatter,
+    content: rule.content
+  };
+}
+function serializeWindsurfRule(frontmatter, content) {
+  const lines = ["---"];
+  lines.push(`trigger: ${frontmatter.trigger}`);
+  if (frontmatter.globs && frontmatter.globs.length > 0) {
+    lines.push("globs:");
+    for (const glob of frontmatter.globs) {
+      lines.push(`  - ${glob}`);
+    }
+  }
+  if (frontmatter.description) {
+    const escaped = frontmatter.description.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+    lines.push(`description: "${escaped}"`);
+  }
+  lines.push("---");
+  lines.push("");
+  lines.push(content);
+  return lines.join("\n");
+}
+
+// src/plugins/windsurf/index.ts
+var windsurfPlugin = {
+  id: "windsurf",
+  name: "Windsurf",
+  async detect(_rootDir) {
+    return false;
+  },
+  async import(_rootDir) {
+    return null;
+  },
+  async export(state, rootDir) {
+    const files = [];
+    const outputDir = TOOL_OUTPUT_DIRS.windsurf;
+    if (state.agents) {
+      files.push({
+        path: "AGENTS.md",
+        type: "symlink",
+        target: `${UNIFIED_DIR}/AGENTS.md`
+      });
+    }
+    for (const rule of state.rules) {
+      const transformed = transformRuleToWindsurf(rule);
+      const ruleContent = serializeWindsurfRule(
+        transformed.frontmatter,
+        transformed.content
+      );
+      files.push({
+        path: `${outputDir}/rules/${rule.path}`,
+        type: "text",
+        content: ruleContent
+      });
+    }
+    for (const skill of state.skills) {
+      files.push({
+        path: `${outputDir}/skills/${skill.path}`,
+        type: "symlink",
+        target: `../../${UNIFIED_DIR}/skills/${skill.path}`
+      });
+    }
+    return applyFileOverrides(files, rootDir, "windsurf");
+  },
+  validate(state) {
+    const warnings = [];
+    const skipped = [];
+    if (!state.agents) {
+      warnings.push({
+        path: ["AGENTS.md"],
+        message: "No AGENTS.md found - root AGENTS.md will not be created"
+      });
+    }
+    if (state.rules.length > 0) {
+      warnings.push({
+        path: [".windsurf/rules"],
+        message: "Rules are exported with 'trigger: manual' and require explicit @mention to invoke"
+      });
+    }
+    if (state.settings?.mcpServers && Object.keys(state.settings.mcpServers).length > 0) {
+      skipped.push({
+        feature: "mcpServers",
+        reason: "Windsurf uses global MCP config at ~/.codeium/windsurf/mcp_config.json - project-level MCP servers are not exported"
+      });
+    }
+    if (state.settings?.permissions) {
+      const hasPermissions = (state.settings.permissions.allow?.length ?? 0) > 0 || (state.settings.permissions.ask?.length ?? 0) > 0 || (state.settings.permissions.deny?.length ?? 0) > 0;
+      if (hasPermissions) {
+        skipped.push({
+          feature: "permissions",
+          reason: "Windsurf does not support declarative permissions"
+        });
+      }
+    }
+    return { valid: true, errors: [], warnings, skipped };
+  }
+};
+
 // src/plugins/index.ts
 pluginRegistry.register(claudeCodePlugin);
 pluginRegistry.register(copilotPlugin);
 pluginRegistry.register(cursorPlugin);
 pluginRegistry.register(opencodePlugin);
+pluginRegistry.register(windsurfPlugin);
 function computeHash(content) {
   return crypto.createHash("sha256").update(content, "utf-8").digest("hex");
 }
@@ -1166,9 +1286,8 @@ async function updateGitignore(rootDir, paths) {
   const markerRegex = new RegExp(`${marker}[\\s\\S]*?${endMarker}\\n?`, "g");
   content = content.replace(markerRegex, "");
   content = content.trimEnd();
-  const newSection = ["", marker, ...paths.map((p) => p), endMarker, ""].join(
-    "\n"
-  );
+  const uniquePaths = [...new Set(paths)];
+  const newSection = ["", marker, ...uniquePaths, endMarker, ""].join("\n");
   content = content + newSection;
   await fs3.writeFile(gitignorePath, content, "utf-8");
 }
@@ -1244,10 +1363,16 @@ async function runSyncPipeline(options) {
   return results;
 }
 async function initUnifiedConfig(options) {
-  const { rootDir, tools, minimal = false, force = false } = options;
+  const {
+    rootDir,
+    tools,
+    minimal = false,
+    force = false,
+    versionControl
+  } = options;
   const aiDir = path.join(rootDir, UNIFIED_DIR);
   const created = [];
-  const config = generateDefaultConfig(tools);
+  const config = generateDefaultConfig(tools, versionControl);
   const exists = await hasUnifiedConfig(rootDir);
   if (exists && !force) {
     throw new ValidationError(
@@ -1289,7 +1414,7 @@ async function hasUnifiedConfig(rootDir) {
     return false;
   }
 }
-function generateDefaultConfig(tools) {
+function generateDefaultConfig(tools, versionControl) {
   if (tools) {
     const validation = validateToolIds(tools);
     if (!validation.valid) {
@@ -1306,7 +1431,7 @@ function generateDefaultConfig(tools) {
   for (const toolId of TOOL_IDS) {
     toolsConfig[toolId] = {
       enabled: enabledTools.includes(toolId),
-      versionControl: false
+      versionControl: versionControl?.[toolId] ?? false
     };
   }
   return { tools: toolsConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lnai/core",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "Core library for LNAI - unified AI config management",
   "type": "module",
   "license": "MIT",
@@ -23,6 +23,7 @@
     "opencode",
     "copilot",
     "github-copilot",
+    "windsurf",
     "cli",
     "ai-tools"
   ],