@intlayer/engine 9.0.0-canary.12

package/dist/esm/installMCP/installMCP.mjs

@@ -0,0 +1,47 @@
+import { PLATFORMS_METADATA } from "../installSkills/index.mjs";
+import path from "node:path";
+import { promises } from "node:fs";
+import os from "node:os";
+
+//#region src/installMCP/installMCP.ts
+const MCP_CONFIG_FILENAME = "mcp.json";
+const CLAUDE_DESKTOP_CONFIG_PATH = process.platform === "win32" ? path.join(process.env.APPDATA || "", "Claude", "claude_desktop_config.json") : path.join(os.homedir(), "Library", "Application Support", "Claude", "claude_desktop_config.json");
+/**
+* Installs the Intlayer MCP server configuration for a specific platform.
+*/
+const installMCP = async (projectRoot, platform, transport) => {
+	let configPath;
+	let configKey = "mcpServers";
+	if (platform === "Claude") configPath = CLAUDE_DESKTOP_CONFIG_PATH;
+	else {
+		const relativeDir = path.dirname(PLATFORMS_METADATA[platform].dir);
+		configPath = path.join(projectRoot, relativeDir, MCP_CONFIG_FILENAME);
+		if (platform === "VSCode") configKey = "servers";
+	}
+	await promises.mkdir(path.dirname(configPath), { recursive: true });
+	let config = {};
+	try {
+		const content = await promises.readFile(configPath, "utf-8");
+		config = JSON.parse(content);
+	} catch {}
+	if (!config[configKey]) config[configKey] = {};
+	if (transport === "stdio") {
+		const mcpConfig = {
+			command: "npx",
+			args: ["-y", "@intlayer/mcp"]
+		};
+		if (platform === "VSCode") mcpConfig.type = "stdio";
+		config[configKey].intlayer = mcpConfig;
+	} else {
+		const mcpConfig = { url: "https://mcp.intlayer.org" };
+		if (platform === "VSCode") mcpConfig.type = "sse";
+		else mcpConfig.transport = "sse";
+		config[configKey].intlayer = mcpConfig;
+	}
+	await promises.writeFile(configPath, JSON.stringify(config, null, 2), "utf-8");
+	return `MCP server configuration updated in ${configPath}`;
+};
+
+//#endregion
+export { installMCP };
+//# sourceMappingURL=installMCP.mjs.map

package/dist/esm/installMCP/installMCP.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"installMCP.mjs","names":["fs"],"sources":["../../../src/installMCP/installMCP.ts"],"sourcesContent":["import { promises as fs } from 'node:fs';\nimport os from 'node:os';\nimport path from 'node:path';\nimport { PLATFORMS_METADATA, type Platform } from '../installSkills';\n\nexport type MCPTransport = 'stdio' | 'sse';\n\nconst MCP_CONFIG_FILENAME = 'mcp.json';\n\nconst CLAUDE_DESKTOP_CONFIG_PATH =\n  process.platform === 'win32'\n    ? path.join(\n        process.env.APPDATA || '',\n        'Claude',\n        'claude_desktop_config.json'\n      )\n    : path.join(\n        os.homedir(),\n        'Library',\n        'Application Support',\n        'Claude',\n        'claude_desktop_config.json'\n      );\n\n/**\n * Installs the Intlayer MCP server configuration for a specific platform.\n */\nexport const installMCP = async (\n  projectRoot: string,\n  platform: Platform,\n  transport: MCPTransport\n): Promise<string> => {\n  let configPath: string;\n  let configKey = 'mcpServers';\n\n  if (platform === 'Claude') {\n    configPath = CLAUDE_DESKTOP_CONFIG_PATH;\n  } else {\n    const relativeDir = path.dirname(PLATFORMS_METADATA[platform].dir); // e.g. .cursor or .vscode\n    configPath = path.join(projectRoot, relativeDir, MCP_CONFIG_FILENAME);\n\n    if (platform === 'VSCode') {\n      configKey = 'servers';\n    }\n  }\n\n  // Ensure the configuration directory exists\n  await fs.mkdir(path.dirname(configPath), { recursive: true });\n\n  let config: any = {};\n  try {\n    const content = await fs.readFile(configPath, 'utf-8');\n    config = JSON.parse(content);\n  } catch {\n    // File doesn't exist or is invalid JSON, start fresh\n  }\n\n  if (!config[configKey]) {\n    config[configKey] = {};\n  }\n\n  if (transport === 'stdio') {\n    const mcpConfig: any = {\n      command: 'npx',\n      args: ['-y', '@intlayer/mcp'],\n    };\n\n    if (platform === 'VSCode') {\n      mcpConfig.type = 'stdio';\n    }\n\n    config[configKey].intlayer = mcpConfig;\n  } else {\n    const mcpConfig: any = {\n      url: 'https://mcp.intlayer.org',\n    };\n\n    if (platform === 'VSCode') {\n      mcpConfig.type = 'sse';\n    } else {\n      mcpConfig.transport = 'sse';\n    }\n\n    config[configKey].intlayer = mcpConfig;\n  }\n\n  await fs.writeFile(configPath, JSON.stringify(config, null, 2), 'utf-8');\n\n  return `MCP server configuration updated in ${configPath}`;\n};\n"],"mappings":";;;;;;AAOA,MAAM,sBAAsB;AAE5B,MAAM,6BACJ,QAAQ,aAAa,UACjB,KAAK,KACH,QAAQ,IAAI,WAAW,IACvB,UACA,6BACD,GACD,KAAK,KACH,GAAG,SAAS,EACZ,WACA,uBACA,UACA,6BACD;;;;AAKP,MAAa,aAAa,OACxB,aACA,UACA,cACoB;CACpB,IAAI;CACJ,IAAI,YAAY;AAEhB,KAAI,aAAa,SACf,cAAa;MACR;EACL,MAAM,cAAc,KAAK,QAAQ,mBAAmB,UAAU,IAAI;AAClE,eAAa,KAAK,KAAK,aAAa,aAAa,oBAAoB;AAErE,MAAI,aAAa,SACf,aAAY;;AAKhB,OAAMA,SAAG,MAAM,KAAK,QAAQ,WAAW,EAAE,EAAE,WAAW,MAAM,CAAC;CAE7D,IAAI,SAAc,EAAE;AACpB,KAAI;EACF,MAAM,UAAU,MAAMA,SAAG,SAAS,YAAY,QAAQ;AACtD,WAAS,KAAK,MAAM,QAAQ;SACtB;AAIR,KAAI,CAAC,OAAO,WACV,QAAO,aAAa,EAAE;AAGxB,KAAI,cAAc,SAAS;EACzB,MAAM,YAAiB;GACrB,SAAS;GACT,MAAM,CAAC,MAAM,gBAAgB;GAC9B;AAED,MAAI,aAAa,SACf,WAAU,OAAO;AAGnB,SAAO,WAAW,WAAW;QACxB;EACL,MAAM,YAAiB,EACrB,KAAK,4BACN;AAED,MAAI,aAAa,SACf,WAAU,OAAO;MAEjB,WAAU,YAAY;AAGxB,SAAO,WAAW,WAAW;;AAG/B,OAAMA,SAAG,UAAU,YAAY,KAAK,UAAU,QAAQ,MAAM,EAAE,EAAE,QAAQ;AAExE,QAAO,uCAAuC"}

package/dist/esm/installSkills/index.mjs

@@ -0,0 +1,299 @@
+import { readAsset } from "../_virtual/_utils_asset.mjs";
+import path from "node:path";
+import { v } from "@intlayer/config/logger";
+import { promises } from "node:fs";
+import { getMarkdownMetadata } from "@intlayer/core/markdown";
+
+//#region src/installSkills/index.ts
+/**
+* Metadata for each available documentation skill.
+*/
+const SKILLS_METADATA = {
+	Config: "Intlayer configuration documentation",
+	Content: "Reference for all Intlayer content node types (t, enu, etc.)",
+	Usage: "How to use Intlayer in your project",
+	CLI: "Intlayer CLI commands and usage",
+	Compiler: "Intlayer Compiler setup and usage for automatic content extraction without .content files",
+	RemoteContent: "How to use Intlayer with Remote/CMS/Server-side content",
+	NextJS: "Next.js-specific usage (Server & Client components)",
+	React: "React-specific syntax and hooks usage",
+	Vue: "Vue-specific composables and syntax",
+	Svelte: "Svelte-specific stores and syntax",
+	Angular: "Angular-specific syntax and Injectable Function usage",
+	Preact: "Preact-specific syntax and hooks usage",
+	Solid: "Integrates Intlayer internationalization with SolidJS components. Use when the user asks to \"setup SolidJS i18n\", use the \"useIntlayer\" hook in Solid, or manage locales in a SolidJS application.",
+	Astro: "Astro-specific usage and getIntlayer"
+};
+const SKILLS = Object.keys(SKILLS_METADATA);
+const getInitialSkills = (deps) => {
+	const skills = [
+		"Usage",
+		"Content",
+		"Config",
+		"CLI",
+		"Compiler"
+	];
+	if (deps.next) skills.push("NextJS");
+	if (deps.react || !deps.next) skills.push("React");
+	if (deps.preact) skills.push("Preact");
+	if (deps["solid-js"]) skills.push("Solid");
+	if (deps.vue || deps.nuxt) skills.push("Vue");
+	if (deps.svelte || deps["@sveltejs/kit"]) skills.push("Svelte");
+	if (deps.astro) skills.push("Astro");
+	return skills;
+};
+/**
+* Metadata and configuration for each supported platform.
+*/
+const PLATFORMS_METADATA = {
+	Cursor: {
+		label: "Cursor",
+		dir: ".cursor/skills",
+		check: () => process.env.CURSOR === "true" || process.env.TERM_PROGRAM === "cursor"
+	},
+	Windsurf: {
+		label: "Windsurf",
+		dir: ".windsurf/skills",
+		check: () => process.env.WINDSURF === "true" || process.env.TERM_PROGRAM === "windsurf"
+	},
+	Trae: {
+		label: "Trae",
+		dir: ".trae/skills",
+		check: () => process.env.TRAE === "true" || process.env.TERM_PROGRAM === "trae"
+	},
+	TraeCN: {
+		label: "Trae CN",
+		dir: ".trae/skills",
+		check: () => process.env.TRAE_CN === "true"
+	},
+	VSCode: {
+		label: "VS Code",
+		dir: ".vscode/skills",
+		check: () => process.env.VSCODE === "true" || process.env.TERM_PROGRAM === "vscode"
+	},
+	OpenCode: {
+		label: "OpenCode",
+		dir: ".opencode/skills",
+		check: () => process.env.OPENCODE === "true"
+	},
+	Claude: {
+		label: "Claude Code",
+		dir: ".claude/skills",
+		check: () => process.env.CLAUDE === "true"
+	},
+	GitHub: {
+		label: "GitHub Copilot Workspace",
+		dir: ".github/skills",
+		check: () => process.env.GITHUB_ACTIONS === "true" || !!process.env.GITHUB_WORKSPACE
+	},
+	Antigravity: {
+		label: "Antigravity",
+		dir: ".agent/skills"
+	},
+	Augment: {
+		label: "Augment",
+		dir: ".augment/skills"
+	},
+	OpenClaw: {
+		label: "OpenClaw",
+		dir: "skills"
+	},
+	Cline: {
+		label: "Cline",
+		dir: ".cline/skills"
+	},
+	CodeBuddy: {
+		label: "CodeBuddy",
+		dir: ".codebuddy/skills"
+	},
+	CommandCode: {
+		label: "Command Code",
+		dir: ".commandcode/skills"
+	},
+	Continue: {
+		label: "Continue",
+		dir: ".continue/skills"
+	},
+	Crush: {
+		label: "Crush",
+		dir: ".crush/skills"
+	},
+	Droid: {
+		label: "Droid",
+		dir: ".factory/skills"
+	},
+	Goose: {
+		label: "Goose",
+		dir: ".goose/skills"
+	},
+	IFlow: {
+		label: "iFlow CLI",
+		dir: ".iflow/skills"
+	},
+	Junie: {
+		label: "Junie",
+		dir: ".junie/skills"
+	},
+	KiloCode: {
+		label: "Kilo Code",
+		dir: ".kilocode/skills"
+	},
+	Kiro: {
+		label: "Kiro CLI",
+		dir: ".kiro/skills"
+	},
+	Kode: {
+		label: "Kode",
+		dir: ".kode/skills"
+	},
+	MCPJam: {
+		label: "MCPJam",
+		dir: ".mcpjam/skills"
+	},
+	MistralVibe: {
+		label: "Mistral Vibe",
+		dir: ".vibe/skills"
+	},
+	Mux: {
+		label: "Mux",
+		dir: ".mux/skills"
+	},
+	OpenHands: {
+		label: "OpenHands",
+		dir: ".openhands/skills"
+	},
+	Pi: {
+		label: "Pi",
+		dir: ".pi/skills"
+	},
+	Qoder: {
+		label: "Qoder",
+		dir: ".qoder/skills"
+	},
+	Qwen: {
+		label: "Qwen Code",
+		dir: ".qwen/skills"
+	},
+	RooCode: {
+		label: "Roo Code",
+		dir: ".roo/skills"
+	},
+	Zencoder: {
+		label: "Zencoder",
+		dir: ".zencoder/skills"
+	},
+	Neovate: {
+		label: "Neovate",
+		dir: ".neovate/skills"
+	},
+	Pochi: {
+		label: "Pochi",
+		dir: ".pochi/skills"
+	},
+	Other: {
+		label: "Other",
+		dir: "skills"
+	}
+};
+const PLATFORMS = Object.keys(PLATFORMS_METADATA);
+/**
+* Maps specific skill keys to special filenames if they differ from standard snake_case.
+*/
+const SKILL_FILENAME_MAP = {};
+/**
+* Helper to convert CamelCase to kebab-case for directory naming
+*/
+const camelToKebabCase = (str) => str.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
+/**
+* Reads the raw markdown content for a specific skill from the assets folder.
+*/
+const getSkillContent = (skill) => {
+	const fileName = `./skills/${SKILL_FILENAME_MAP[skill] ?? camelToKebabCase(skill)}.md`;
+	try {
+		return readAsset(fileName);
+	} catch {
+		console.warn(`Warning: Could not read asset for skill: ${skill} at ${fileName}`);
+		return "";
+	}
+};
+/**
+* Reads the licence content from the assets folder.
+*/
+const getLicenceContent = () => {
+	try {
+		return readAsset("./LICENCE.md");
+	} catch {
+		console.warn("Warning: Could not read LICENCE.md asset");
+		return "";
+	}
+};
+const ALLOWED_FETCH_HOSTS = new Set(["intlayer.org"]);
+/**
+* Fetches the content of a URL using native fetch.
+*/
+const fetchUrlContent = async (url) => {
+	const parsed = new URL(url);
+	if (parsed.protocol !== "https:" || !ALLOWED_FETCH_HOSTS.has(parsed.hostname)) throw new Error(`Blocked fetch to disallowed host: ${parsed.hostname}`);
+	const response = await fetch(url, { redirect: "error" });
+	if (!response.ok) throw new Error(`Failed to fetch ${url}: ${response.statusText}`);
+	return response.text();
+};
+/**
+* Installs skills using the "Agent Skills" directory standard.
+* Standard: <PROJECT_ROOT>/<CONFIG_DIR>/skills/<SKILL_NAME>/SKILL.md
+*/
+const installSkills = async (projectRoot, platform, skills) => {
+	const relativeDir = PLATFORMS_METADATA[platform].dir ?? "skills";
+	const skillsBaseDir = path.join(projectRoot, relativeDir);
+	await promises.mkdir(skillsBaseDir, { recursive: true });
+	const createdSkills = [];
+	const licenceContent = getLicenceContent();
+	for (const skill of skills) {
+		const skillName = `intlayer-${SKILL_FILENAME_MAP[skill] ?? camelToKebabCase(skill)}`;
+		const skillContent = getSkillContent(skill);
+		if (!skillContent) continue;
+		const urls = Array.from(new Set(skillContent.match(/https:\/\/intlayer\.org\/[^\s)]+\.md/g) || []));
+		const skillDir = path.join(skillsBaseDir, skillName);
+		const referenceDir = path.join(skillDir, "references");
+		await promises.mkdir(referenceDir, { recursive: true });
+		if (licenceContent) await promises.writeFile(path.join(skillDir, "LICENCE.md"), licenceContent, "utf-8");
+		let updatedSkillContent = skillContent;
+		const downloadPromises = urls.map(async (url) => {
+			try {
+				const content = await fetchUrlContent(url);
+				const metadata = getMarkdownMetadata(content);
+				let fileName = "";
+				if (Array.isArray(metadata.slugs)) fileName = metadata.slugs.filter((slug) => slug !== "doc").join("_");
+				else fileName = new URL(url).pathname.split("/").filter((part) => part && part !== "doc").map((part) => part.replace(".md", "")).join("_");
+				fileName = fileName ? `${fileName}.md` : "index.md";
+				return {
+					url,
+					localRefPath: `references/${fileName}`,
+					fileName,
+					content,
+					success: true
+				};
+			} catch (error) {
+				console.warn(`Warning: Failed to download ref ${url} for skill ${skill}`, error);
+				return {
+					url,
+					success: false
+				};
+			}
+		});
+		const results = await Promise.all(downloadPromises);
+		for (const res of results) if (res.success && res.fileName && res.content && res.localRefPath) {
+			await promises.writeFile(path.join(referenceDir, res.fileName), res.content, "utf-8");
+			updatedSkillContent = updatedSkillContent.replaceAll(res.url, res.localRefPath);
+		}
+		const filePath = path.join(skillDir, "SKILL.md");
+		await promises.writeFile(filePath, updatedSkillContent, "utf-8");
+		createdSkills.push(`${skillName}/SKILL.md`);
+	}
+	if (createdSkills.length === 0) return `No skill files were created. Check your asset paths.`;
+	return `${v} Created ${createdSkills.length} skills in ${skillsBaseDir}`;
+};
+
+//#endregion
+export { PLATFORMS, PLATFORMS_METADATA, SKILLS, SKILLS_METADATA, getInitialSkills, installSkills };
+//# sourceMappingURL=index.mjs.map

package/dist/esm/installSkills/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["fs"],"sources":["../../../src/installSkills/index.ts"],"sourcesContent":["import { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { readAsset } from 'utils:asset';\nimport { v } from '@intlayer/config/logger';\nimport { getMarkdownMetadata } from '@intlayer/core/markdown';\n\n/**\n * Metadata for each available documentation skill.\n */\nexport const SKILLS_METADATA = {\n  Config: 'Intlayer configuration documentation',\n  Content: 'Reference for all Intlayer content node types (t, enu, etc.)',\n  Usage: 'How to use Intlayer in your project',\n  CLI: 'Intlayer CLI commands and usage',\n  Compiler:\n    'Intlayer Compiler setup and usage for automatic content extraction without .content files',\n  RemoteContent: 'How to use Intlayer with Remote/CMS/Server-side content',\n  NextJS: 'Next.js-specific usage (Server & Client components)',\n  React: 'React-specific syntax and hooks usage',\n  Vue: 'Vue-specific composables and syntax',\n  Svelte: 'Svelte-specific stores and syntax',\n  Angular: 'Angular-specific syntax and Injectable Function usage',\n  Preact: 'Preact-specific syntax and hooks usage',\n  Solid:\n    'Integrates Intlayer internationalization with SolidJS components. Use when the user asks to \"setup SolidJS i18n\", use the \"useIntlayer\" hook in Solid, or manage locales in a SolidJS application.',\n  Astro: 'Astro-specific usage and getIntlayer',\n} as const;\n\nexport type Skill = keyof typeof SKILLS_METADATA;\n\nexport const SKILLS = Object.keys(SKILLS_METADATA) as Skill[];\n\nexport const getInitialSkills = (\n  deps: Record<string, string>\n): (keyof typeof SKILLS_METADATA)[] => {\n  const skills: (keyof typeof SKILLS_METADATA)[] = [\n    'Usage',\n    'Content',\n    'Config',\n    'CLI',\n    'Compiler',\n  ];\n\n  if (deps.next) skills.push('NextJS');\n  if (deps.react || !deps.next) skills.push('React');\n  if (deps.preact) skills.push('Preact');\n  if (deps['solid-js']) skills.push('Solid');\n  if (deps.vue || deps.nuxt) skills.push('Vue');\n  if (deps.svelte || deps['@sveltejs/kit']) skills.push('Svelte');\n  if (deps.astro) skills.push('Astro');\n\n  return skills;\n};\n\nexport interface PlatformMetadata {\n  label: string;\n  dir: string;\n  check?: () => boolean;\n}\n\n/**\n * Metadata and configuration for each supported platform.\n */\nexport const PLATFORMS_METADATA: Record<string, PlatformMetadata> = {\n  Cursor: {\n    label: 'Cursor',\n    dir: '.cursor/skills',\n    check: () =>\n      process.env.CURSOR === 'true' || process.env.TERM_PROGRAM === 'cursor',\n  },\n  Windsurf: {\n    label: 'Windsurf',\n    dir: '.windsurf/skills',\n    check: () =>\n      process.env.WINDSURF === 'true' ||\n      process.env.TERM_PROGRAM === 'windsurf',\n  },\n  Trae: {\n    label: 'Trae',\n    dir: '.trae/skills',\n    check: () =>\n      process.env.TRAE === 'true' || process.env.TERM_PROGRAM === 'trae',\n  },\n  TraeCN: {\n    label: 'Trae CN',\n    dir: '.trae/skills',\n    check: () => process.env.TRAE_CN === 'true',\n  },\n  VSCode: {\n    label: 'VS Code',\n    dir: '.vscode/skills',\n    check: () =>\n      process.env.VSCODE === 'true' || process.env.TERM_PROGRAM === 'vscode',\n  },\n  OpenCode: {\n    label: 'OpenCode',\n    dir: '.opencode/skills',\n    check: () => process.env.OPENCODE === 'true',\n  },\n  Claude: {\n    label: 'Claude Code',\n    dir: '.claude/skills',\n    check: () => process.env.CLAUDE === 'true',\n  },\n  GitHub: {\n    label: 'GitHub Copilot Workspace',\n    dir: '.github/skills',\n    check: () =>\n      process.env.GITHUB_ACTIONS === 'true' || !!process.env.GITHUB_WORKSPACE,\n  },\n  Antigravity: {\n    label: 'Antigravity',\n    dir: '.agent/skills',\n  },\n  Augment: {\n    label: 'Augment',\n    dir: '.augment/skills',\n  },\n  OpenClaw: {\n    label: 'OpenClaw',\n    dir: 'skills',\n  },\n  Cline: {\n    label: 'Cline',\n    dir: '.cline/skills',\n  },\n  CodeBuddy: {\n    label: 'CodeBuddy',\n    dir: '.codebuddy/skills',\n  },\n  CommandCode: {\n    label: 'Command Code',\n    dir: '.commandcode/skills',\n  },\n  Continue: {\n    label: 'Continue',\n    dir: '.continue/skills',\n  },\n  Crush: {\n    label: 'Crush',\n    dir: '.crush/skills',\n  },\n  Droid: {\n    label: 'Droid',\n    dir: '.factory/skills',\n  },\n  Goose: {\n    label: 'Goose',\n    dir: '.goose/skills',\n  },\n  IFlow: {\n    label: 'iFlow CLI',\n    dir: '.iflow/skills',\n  },\n  Junie: {\n    label: 'Junie',\n    dir: '.junie/skills',\n  },\n  KiloCode: {\n    label: 'Kilo Code',\n    dir: '.kilocode/skills',\n  },\n  Kiro: {\n    label: 'Kiro CLI',\n    dir: '.kiro/skills',\n  },\n  Kode: {\n    label: 'Kode',\n    dir: '.kode/skills',\n  },\n  MCPJam: {\n    label: 'MCPJam',\n    dir: '.mcpjam/skills',\n  },\n  MistralVibe: {\n    label: 'Mistral Vibe',\n    dir: '.vibe/skills',\n  },\n  Mux: {\n    label: 'Mux',\n    dir: '.mux/skills',\n  },\n  OpenHands: {\n    label: 'OpenHands',\n    dir: '.openhands/skills',\n  },\n  Pi: {\n    label: 'Pi',\n    dir: '.pi/skills',\n  },\n  Qoder: {\n    label: 'Qoder',\n    dir: '.qoder/skills',\n  },\n  Qwen: {\n    label: 'Qwen Code',\n    dir: '.qwen/skills',\n  },\n  RooCode: {\n    label: 'Roo Code',\n    dir: '.roo/skills',\n  },\n  Zencoder: {\n    label: 'Zencoder',\n    dir: '.zencoder/skills',\n  },\n  Neovate: {\n    label: 'Neovate',\n    dir: '.neovate/skills',\n  },\n  Pochi: {\n    label: 'Pochi',\n    dir: '.pochi/skills',\n  },\n  Other: {\n    label: 'Other',\n    dir: 'skills',\n  },\n} as const;\n\nexport type Platform = keyof typeof PLATFORMS_METADATA;\n\nexport const PLATFORMS = Object.keys(PLATFORMS_METADATA) as Platform[];\n\n/**\n * Maps specific skill keys to special filenames if they differ from standard snake_case.\n */\nconst SKILL_FILENAME_MAP: Partial<Record<Skill, string>> = {};\n\n/**\n * Helper to convert CamelCase to kebab-case for directory naming\n */\nconst camelToKebabCase = (str: string) =>\n  str.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();\n\n/**\n * Reads the raw markdown content for a specific skill from the assets folder.\n */\nconst getSkillContent = (skill: Skill): string => {\n  const baseName = SKILL_FILENAME_MAP[skill] ?? camelToKebabCase(skill);\n  const fileName = `./skills/${baseName}.md`;\n\n  try {\n    return readAsset(fileName);\n  } catch {\n    console.warn(\n      `Warning: Could not read asset for skill: ${skill} at ${fileName}`\n    );\n    return '';\n  }\n};\n\n/**\n * Reads the licence content from the assets folder.\n */\nconst getLicenceContent = (): string => {\n  try {\n    return readAsset('./LICENCE.md');\n  } catch {\n    console.warn('Warning: Could not read LICENCE.md asset');\n    return '';\n  }\n};\n\nconst ALLOWED_FETCH_HOSTS = new Set(['intlayer.org']);\n\n/**\n * Fetches the content of a URL using native fetch.\n */\nconst fetchUrlContent = async (url: string): Promise<string> => {\n  const parsed = new URL(url);\n  if (\n    parsed.protocol !== 'https:' ||\n    !ALLOWED_FETCH_HOSTS.has(parsed.hostname)\n  ) {\n    throw new Error(`Blocked fetch to disallowed host: ${parsed.hostname}`);\n  }\n  const response = await fetch(url, { redirect: 'error' });\n  if (!response.ok) {\n    throw new Error(`Failed to fetch ${url}: ${response.statusText}`);\n  }\n  return response.text();\n};\n\n/**\n * Installs skills using the \"Agent Skills\" directory standard.\n * Standard: <PROJECT_ROOT>/<CONFIG_DIR>/skills/<SKILL_NAME>/SKILL.md\n */\nexport const installSkills = async (\n  projectRoot: string,\n  platform: Platform,\n  skills: Skill[]\n): Promise<string> => {\n  // Determine destination directory\n  const relativeDir = PLATFORMS_METADATA[platform].dir ?? 'skills';\n  const skillsBaseDir = path.join(projectRoot, relativeDir);\n\n  // Ensure the base directory exists\n  await fs.mkdir(skillsBaseDir, { recursive: true });\n\n  const createdSkills: string[] = [];\n  const licenceContent = getLicenceContent();\n\n  for (const skill of skills) {\n    const baseName = SKILL_FILENAME_MAP[skill] ?? camelToKebabCase(skill);\n    const skillName = `intlayer-${baseName}`;\n    const skillContent = getSkillContent(skill);\n\n    if (!skillContent) continue;\n\n    // Extract unique URLs\n    const urls = Array.from(\n      new Set(skillContent.match(/https:\\/\\/intlayer\\.org\\/[^\\s)]+\\.md/g) || [])\n    );\n\n    // Agent Standard: .../skills/<skill-name>/SKILL.md\n    const skillDir = path.join(skillsBaseDir, skillName);\n    const referenceDir = path.join(skillDir, 'references');\n\n    // Ensure directories exist\n    await fs.mkdir(referenceDir, { recursive: true });\n\n    // Write License\n    if (licenceContent) {\n      await fs.writeFile(\n        path.join(skillDir, 'LICENCE.md'),\n        licenceContent,\n        'utf-8'\n      );\n    }\n\n    let updatedSkillContent = skillContent;\n\n    // Parallel download of references\n    const downloadPromises = urls.map(async (url) => {\n      try {\n        const content = await fetchUrlContent(url);\n        const metadata = getMarkdownMetadata<{ slugs?: string[] }>(content);\n\n        let fileName = '';\n\n        // Determine filename from slugs or URL path\n        if (Array.isArray(metadata.slugs)) {\n          fileName = metadata.slugs.filter((slug) => slug !== 'doc').join('_');\n        } else {\n          const urlPath = new URL(url).pathname;\n          fileName = urlPath\n            .split('/')\n            .filter((part) => part && part !== 'doc')\n            .map((part) => part.replace('.md', '')) // Clean extension for joining\n            .join('_');\n        }\n\n        // Ensure it ends with .md\n        fileName = fileName ? `${fileName}.md` : 'index.md';\n        const localRefPath = `references/${fileName}`;\n\n        return {\n          url,\n          localRefPath,\n          fileName,\n          content,\n          success: true,\n        };\n      } catch (error) {\n        console.warn(\n          `Warning: Failed to download ref ${url} for skill ${skill}`,\n          error\n        );\n        return { url, success: false };\n      }\n    });\n\n    const results = await Promise.all(downloadPromises);\n\n    // Process results: Write files and update content string\n    for (const res of results) {\n      if (res.success && res.fileName && res.content && res.localRefPath) {\n        // Write the reference file\n        await fs.writeFile(\n          path.join(referenceDir, res.fileName),\n          res.content,\n          'utf-8'\n        );\n\n        // Update the main content to point to local file\n        updatedSkillContent = updatedSkillContent.replaceAll(\n          res.url,\n          res.localRefPath\n        );\n      }\n    }\n\n    // Write the main SKILL.md\n    const filePath = path.join(skillDir, 'SKILL.md');\n    await fs.writeFile(filePath, updatedSkillContent, 'utf-8');\n    createdSkills.push(`${skillName}/SKILL.md`);\n  }\n\n  if (createdSkills.length === 0) {\n    return `No skill files were created. Check your asset paths.`;\n  }\n\n  return `${v} Created ${createdSkills.length} skills in ${skillsBaseDir}`;\n};\n"],"mappings":"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"}

package/dist/esm/listDictionariesPath.mjs

@@ -0,0 +1,39 @@
+import { stat } from "node:fs/promises";
+import fg from "fast-glob";
+import { normalizePath } from "@intlayer/config/utils";
+
+//#region src/listDictionariesPath.ts
+/**
+* List all dictionaries absolute paths in the project
+* @param configuration - The configuration object
+* @returns An array of dictionary paths
+*/
+const listDictionaries = async (configuration) => {
+	const { fileExtensions, contentDir, excludedPath } = configuration.content;
+	const filePromises = fileExtensions.flatMap((ext) => contentDir.map((dir) => `${normalizePath(dir)}/**/*${ext}`.replace("//", "/"))).map(async (pattern) => {
+		const magicIndex = pattern.search(/[*?{}(]/);
+		const basePattern = magicIndex > -1 ? pattern.slice(0, magicIndex) : pattern;
+		return fg(pattern, {
+			ignore: excludedPath.filter((excludePattern) => {
+				const cleanName = excludePattern.replace(/\*\*/g, "").replace(/\//g, "");
+				if (cleanName && basePattern.includes(`/${cleanName}/`)) return false;
+				return true;
+			}),
+			absolute: true,
+			dot: true
+		});
+	});
+	const filesArrays = await Promise.all(filePromises);
+	return Array.from(new Set(filesArrays.flat()));
+};
+const listDictionariesWithStats = async (configuration) => {
+	const files = await listDictionaries(configuration);
+	return Promise.all(files.map(async (file) => ({
+		path: file,
+		stats: await stat(file)
+	})));
+};
+
+//#endregion
+export { listDictionaries, listDictionariesWithStats };
+//# sourceMappingURL=listDictionariesPath.mjs.map

package/dist/esm/listDictionariesPath.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"listDictionariesPath.mjs","names":[],"sources":["../../src/listDictionariesPath.ts"],"sourcesContent":["import { stat } from 'node:fs/promises';\nimport { normalizePath } from '@intlayer/config/utils';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport fg from 'fast-glob';\n\n/**\n * List all dictionaries absolute paths in the project\n * @param configuration - The configuration object\n * @returns An array of dictionary paths\n */\nexport const listDictionaries = async (\n  configuration: IntlayerConfig\n): Promise<string[]> => {\n  const { fileExtensions, contentDir, excludedPath } = configuration.content;\n\n  const watchedFilesPatternWithPath = fileExtensions.flatMap((ext) =>\n    contentDir.map((dir) =>\n      `${normalizePath(dir)}/**/*${ext}`.replace('//', '/')\n    )\n  );\n\n  const filePromises = watchedFilesPatternWithPath.map(async (pattern) => {\n    // Identify the static part of the path (before any wildcards like *)\n    //    e.g. \"/Users/.../design-system/dist/esm/**/*.content.ts\" -> \"/Users/.../design-system/dist/esm/\"\n    const magicIndex = pattern.search(/[*?{}(]/);\n    const basePattern =\n      magicIndex > -1 ? pattern.slice(0, magicIndex) : pattern;\n\n    // Filter the global ignored list for this specific pattern\n    const applicableIgnore = excludedPath.filter((excludePattern) => {\n      // Heuristic: Extract the key directory name from the glob\n      // e.g. \"**/dist/**\" -> \"dist\", \"**/node_modules/**\" -> \"node_modules\"\n      const cleanName = excludePattern.replace(/\\*\\*/g, '').replace(/\\//g, '');\n\n      // If the explicit base path contains the excluded directory (e.g. \".../dist/...\"),\n      // we assume you explicitly want it, so we REMOVE it from the ignore list.\n      // We check for `/${cleanName}/` to ensure we match whole folder names.\n      if (cleanName && basePattern.includes(`/${cleanName}/`)) {\n        return false; // Drop this exclude rule\n      }\n\n      return true; // Keep this exclude rule\n    });\n\n    // Run fast-glob with the customized ignore list\n    return fg(pattern, {\n      ignore: applicableIgnore,\n      absolute: true,\n      dot: true,\n    });\n  });\n\n  const filesArrays = await Promise.all(filePromises);\n\n  // Flatten and deduplicate\n  const uniqueFiles = Array.from(new Set(filesArrays.flat()));\n\n  return uniqueFiles;\n};\n\nexport const listDictionariesWithStats = async (\n  configuration: IntlayerConfig\n) => {\n  const files = await listDictionaries(configuration);\n\n  return Promise.all(\n    files.map(async (file) => ({ path: file, stats: await stat(file) }))\n  );\n};\n"],"mappings":";;;;;;;;;;AAUA,MAAa,mBAAmB,OAC9B,kBACsB;CACtB,MAAM,EAAE,gBAAgB,YAAY,iBAAiB,cAAc;CAQnE,MAAM,eAN8B,eAAe,SAAS,QAC1D,WAAW,KAAK,QACd,GAAG,cAAc,IAAI,CAAC,OAAO,MAAM,QAAQ,MAAM,IAAI,CACtD,CAG6C,CAAC,IAAI,OAAO,YAAY;EAGtE,MAAM,aAAa,QAAQ,OAAO,UAAU;EAC5C,MAAM,cACJ,aAAa,KAAK,QAAQ,MAAM,GAAG,WAAW,GAAG;AAmBnD,SAAO,GAAG,SAAS;GACjB,QAjBuB,aAAa,QAAQ,mBAAmB;IAG/D,MAAM,YAAY,eAAe,QAAQ,SAAS,GAAG,CAAC,QAAQ,OAAO,GAAG;AAKxE,QAAI,aAAa,YAAY,SAAS,IAAI,UAAU,GAAG,CACrD,QAAO;AAGT,WAAO;KAKiB;GACxB,UAAU;GACV,KAAK;GACN,CAAC;GACF;CAEF,MAAM,cAAc,MAAM,QAAQ,IAAI,aAAa;AAKnD,QAFoB,MAAM,KAAK,IAAI,IAAI,YAAY,MAAM,CAAC,CAExC;;AAGpB,MAAa,4BAA4B,OACvC,kBACG;CACH,MAAM,QAAQ,MAAM,iBAAiB,cAAc;AAEnD,QAAO,QAAQ,IACb,MAAM,IAAI,OAAO,UAAU;EAAE,MAAM;EAAM,OAAO,MAAM,KAAK,KAAK;EAAE,EAAE,CACrE"}

package/dist/esm/listGitFiles.mjs

@@ -0,0 +1,101 @@
+import { join } from "node:path";
+import { getAppLogger } from "@intlayer/config/logger";
+import { readFileSync } from "node:fs";
+import simpleGit from "simple-git";
+import { log } from "@intlayer/config/built";
+
+//#region src/listGitFiles.ts
+const getGitRootDir = async () => {
+	try {
+		return (await simpleGit().revparse(["--show-toplevel"])).trim();
+	} catch (error) {
+		getAppLogger({ log })(`Error getting git root directory: ${error}`, { level: "error" });
+		return null;
+	}
+};
+const listGitFiles = async ({ mode, baseRef = "origin/main", currentRef = "HEAD", absolute = true }) => {
+	try {
+		const git = simpleGit();
+		const diff = /* @__PURE__ */ new Set();
+		if (mode.includes("untracked")) (await git.status()).not_added.forEach((file) => {
+			diff.add(file);
+		});
+		if (mode.includes("uncommitted")) (await git.diff(["--name-only", "HEAD"])).split("\n").filter(Boolean).forEach((file) => {
+			diff.add(file);
+		});
+		if (mode.includes("unpushed")) (await git.diff(["--name-only", "@{push}...HEAD"])).split("\n").filter(Boolean).forEach((file) => {
+			diff.add(file);
+		});
+		if (mode.includes("gitDiff")) {
+			await git.fetch(baseRef);
+			(await git.diff(["--name-only", `${baseRef}...${currentRef}`])).split("\n").filter(Boolean).forEach((file) => {
+				diff.add(file);
+			});
+		}
+		if (absolute) {
+			const gitRootDir = await getGitRootDir();
+			if (!gitRootDir) return [];
+			return Array.from(diff).map((file) => join(gitRootDir, file));
+		}
+		return Array.from(diff);
+	} catch (error) {
+		console.warn("Failed to get changes list:", error);
+	}
+};
+const listGitLines = async (filePath, { mode, baseRef = "origin/main", currentRef = "HEAD" }) => {
+	const git = simpleGit();
+	const changedLines = /* @__PURE__ */ new Set();
+	/**
+	* Extracts line numbers from a diff generated with `--unified=0`.
+	* Each hunk header looks like: @@ -<oldStart>,<oldCount> +<newStart>,<newCount> @@
+	* We consider both the "+" (new) side for additions and the "-" (old) side for deletions.
+	* For deletions, we add the line before and after the deletion point in the current file.
+	*/
+	const collectLinesFromDiff = (diffOutput) => {
+		const hunkRegex = /@@ -(\d+)(?:,(\d+))? \+(\d+)(?:,(\d+))? @@/g;
+		let match;
+		while ((match = hunkRegex.exec(diffOutput)) !== null) {
+			const oldCount = match[2] ? Number(match[2]) : 1;
+			const newStart = Number(match[3]);
+			const newCount = match[4] ? Number(match[4]) : 1;
+			if (newCount > 0) for (let i = 0; i < newCount; i++) changedLines.add(newStart + i);
+			if (oldCount > 0 && newCount === 0) {
+				if (newStart > 1) changedLines.add(newStart - 1);
+				changedLines.add(newStart);
+			}
+		}
+	};
+	if (mode.includes("untracked")) {
+		if ((await git.status()).not_added.includes(filePath)) try {
+			readFileSync(filePath, "utf-8").split("\n").forEach((_, idx) => {
+				changedLines.add(idx + 1);
+			});
+		} catch {}
+	}
+	if (mode.includes("uncommitted")) collectLinesFromDiff(await git.diff([
+		"--unified=0",
+		"HEAD",
+		"--",
+		filePath
+	]));
+	if (mode.includes("unpushed")) collectLinesFromDiff(await git.diff([
+		"--unified=0",
+		"@{push}...HEAD",
+		"--",
+		filePath
+	]));
+	if (mode.includes("gitDiff")) {
+		await git.fetch(baseRef);
+		collectLinesFromDiff(await git.diff([
+			"--unified=0",
+			`${baseRef}...${currentRef}`,
+			"--",
+			filePath
+		]));
+	}
+	return Array.from(changedLines).sort((a, b) => a - b);
+};
+
+//#endregion
+export { listGitFiles, listGitLines };
+//# sourceMappingURL=listGitFiles.mjs.map

package/dist/esm/listGitFiles.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"listGitFiles.mjs","names":[],"sources":["../../src/listGitFiles.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { log } from '@intlayer/config/built';\nimport { getAppLogger } from '@intlayer/config/logger';\nimport simpleGit from 'simple-git';\n\nexport type DiffMode = 'gitDiff' | 'uncommitted' | 'unpushed' | 'untracked';\n\nconst getGitRootDir = async (): Promise<string | null> => {\n  try {\n    const git = simpleGit();\n    const rootDir = await git.revparse(['--show-toplevel']);\n    return rootDir.trim();\n  } catch (error) {\n    const appLogger = getAppLogger({ log });\n    appLogger(`Error getting git root directory: ${error}`, {\n      level: 'error',\n    });\n    return null;\n  }\n};\n\nexport type ListGitFilesOptions = {\n  mode: DiffMode[];\n  baseRef?: string;\n  currentRef?: string;\n  absolute?: boolean;\n};\n\nexport const listGitFiles = async ({\n  mode,\n  baseRef = 'origin/main',\n  currentRef = 'HEAD', // HEAD points to the current branch's latest commit\n  absolute = true,\n}: ListGitFilesOptions) => {\n  try {\n    const git = simpleGit();\n    const diff: Set<string> = new Set();\n\n    if (mode.includes('untracked')) {\n      const status = await git.status();\n      status.not_added.forEach((file) => {\n        diff.add(file);\n      });\n    }\n\n    if (mode.includes('uncommitted')) {\n      // Get uncommitted changes\n      const uncommittedDiff = await git.diff(['--name-only', 'HEAD']);\n\n      const uncommittedFiles = uncommittedDiff.split('\\n').filter(Boolean);\n\n      uncommittedFiles.forEach((file) => {\n        diff.add(file);\n      });\n    }\n\n    if (mode.includes('unpushed')) {\n      // Get unpushed commits\n      const unpushedDiff = await git.diff(['--name-only', '@{push}...HEAD']);\n\n      const unpushedFiles = unpushedDiff.split('\\n').filter(Boolean);\n\n      unpushedFiles.forEach((file) => {\n        diff.add(file);\n      });\n    }\n\n    if (mode.includes('gitDiff')) {\n      // Get the base branch (usually main/master) from CI environment\n\n      await git.fetch(baseRef);\n\n      const diffBranch = await git.diff([\n        '--name-only',\n        `${baseRef}...${currentRef}`,\n      ]);\n\n      const gitDiffFiles = diffBranch.split('\\n').filter(Boolean);\n\n      gitDiffFiles.forEach((file) => {\n        diff.add(file);\n      });\n    }\n\n    if (absolute) {\n      const gitRootDir = await getGitRootDir();\n      if (!gitRootDir) {\n        return [];\n      }\n      return Array.from(diff).map((file) => join(gitRootDir, file));\n    }\n\n    return Array.from(diff);\n  } catch (error) {\n    console.warn('Failed to get changes list:', error);\n  }\n};\n\nexport type ListGitLinesOptions = {\n  mode: DiffMode[];\n  baseRef?: string;\n  currentRef?: string;\n};\n\nexport const listGitLines = async (\n  filePath: string,\n  {\n    mode,\n    baseRef = 'origin/main',\n    currentRef = 'HEAD', // HEAD points to the current branch's latest commit\n  }: ListGitLinesOptions\n): Promise<number[]> => {\n  const git = simpleGit();\n  // We collect **line numbers** (1-based) that were modified/added by the diff.\n  // Using a Set ensures uniqueness when the same line is reported by several modes.\n  const changedLines: Set<number> = new Set();\n\n  /**\n   * Extracts line numbers from a diff generated with `--unified=0`.\n   * Each hunk header looks like: @@ -<oldStart>,<oldCount> +<newStart>,<newCount> @@\n   * We consider both the \"+\" (new) side for additions and the \"-\" (old) side for deletions.\n   * For deletions, we add the line before and after the deletion point in the current file.\n   */\n  const collectLinesFromDiff = (diffOutput: string) => {\n    const hunkRegex = /@@ -(\\d+)(?:,(\\d+))? \\+(\\d+)(?:,(\\d+))? @@/g;\n    let match: RegExpExecArray | null;\n\n    // biome-ignore lint/suspicious/noAssignInExpressions: Used in while loop condition\n    while ((match = hunkRegex.exec(diffOutput)) !== null) {\n      const oldCount = match[2] ? Number(match[2]) : 1;\n      const newStart = Number(match[3]);\n      const newCount = match[4] ? Number(match[4]) : 1;\n\n      // Handle additions/modifications (+ side)\n      if (newCount > 0) {\n        for (let i = 0; i < newCount; i++) {\n          changedLines.add(newStart + i);\n        }\n      }\n\n      // Handle deletions (- side)\n      if (oldCount > 0 && newCount === 0) {\n        // For deletions, add the line before and after the deletion point\n        // The deletion point in the new file is at newStart\n        if (newStart > 1) {\n          changedLines.add(newStart - 1); // Line before deletion\n        }\n        changedLines.add(newStart); // Line after deletion (if it exists)\n      }\n    }\n  };\n\n  // 1. Handle untracked files – when a file is untracked its entire content is new.\n  if (mode.includes('untracked')) {\n    const status = await git.status();\n    const isUntracked = status.not_added.includes(filePath);\n    if (isUntracked) {\n      try {\n        const content = readFileSync(filePath, 'utf-8');\n        content.split('\\n').forEach((_, idx) => {\n          changedLines.add(idx + 1);\n        });\n      } catch {\n        // ignore read errors – file may have been deleted, etc.\n      }\n    }\n  }\n\n  // 2. Uncommitted changes (working tree vs HEAD)\n  if (mode.includes('uncommitted')) {\n    const diffOutput = await git.diff(['--unified=0', 'HEAD', '--', filePath]);\n    collectLinesFromDiff(diffOutput);\n  }\n\n  // 3. Unpushed commits – compare local branch to its upstream\n  if (mode.includes('unpushed')) {\n    const diffOutput = await git.diff([\n      '--unified=0',\n      '@{push}...HEAD',\n      '--',\n      filePath,\n    ]);\n    collectLinesFromDiff(diffOutput);\n  }\n\n  // 4. Regular git diff between baseRef and currentRef (e.g., CI pull-request diff)\n  if (mode.includes('gitDiff')) {\n    await git.fetch(baseRef);\n    const diffOutput = await git.diff([\n      '--unified=0',\n      `${baseRef}...${currentRef}`,\n      '--',\n      filePath,\n    ]);\n    collectLinesFromDiff(diffOutput);\n  }\n\n  // Return the list sorted for convenience\n  return Array.from(changedLines).sort((a, b) => a - b);\n};\n"],"mappings":"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"}

package/dist/esm/listProjects.mjs

@@ -0,0 +1,44 @@
+import { dirname } from "node:path";
+import fg from "fast-glob";
+import { configurationFilesCandidates } from "@intlayer/config/node";
+import simpleGit from "simple-git";
+
+//#region src/listProjects.ts
+/**
+* Get the git root directory
+*/
+const getGitRootDir = async (cwd) => {
+	try {
+		return (await (cwd ? simpleGit(cwd) : simpleGit()).revparse(["--show-toplevel"])).trim();
+	} catch (_error) {
+		return null;
+	}
+};
+/**
+* List all Intlayer projects by searching for configuration files
+*
+* @param options - Options for listing projects
+* @returns Array of absolute paths to project directories containing Intlayer config
+*/
+const listProjects = async (options) => {
+	let searchDir = options?.baseDir ?? process.cwd();
+	if (options?.gitRoot) {
+		const gitRootDir = await getGitRootDir(searchDir);
+		if (gitRootDir) searchDir = gitRootDir;
+	}
+	const configFiles = await fg(configurationFilesCandidates.map((fileName) => `**/${fileName}`), {
+		cwd: searchDir,
+		absolute: true,
+		ignore: ["**/node_modules/**", "**/.git/**"],
+		dot: true
+	});
+	const projectDirs = [...new Set(configFiles.map((file) => dirname(file)))];
+	return {
+		searchDir,
+		projectsPath: projectDirs.sort()
+	};
+};
+
+//#endregion
+export { listProjects };
+//# sourceMappingURL=listProjects.mjs.map

package/dist/esm/listProjects.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"listProjects.mjs","names":[],"sources":["../../src/listProjects.ts"],"sourcesContent":["import { dirname } from 'node:path';\nimport { configurationFilesCandidates } from '@intlayer/config/node';\nimport fg from 'fast-glob';\nimport simpleGit from 'simple-git';\n\nexport type ListProjectsOptions = {\n  /**\n   * Base directory to search from\n   * @default process.cwd()\n   */\n  baseDir?: string;\n  /**\n   * If true, search from the git root directory instead of baseDir\n   * @default false\n   */\n  gitRoot?: boolean;\n};\n\n/**\n * Get the git root directory\n */\nconst getGitRootDir = async (cwd?: string): Promise<string | null> => {\n  try {\n    const git = cwd ? simpleGit(cwd) : simpleGit();\n    const rootDir = await git.revparse(['--show-toplevel']);\n    return rootDir.trim();\n  } catch (_error) {\n    return null;\n  }\n};\n\n/**\n * List all Intlayer projects by searching for configuration files\n *\n * @param options - Options for listing projects\n * @returns Array of absolute paths to project directories containing Intlayer config\n */\nexport const listProjects = async (\n  options?: ListProjectsOptions\n): Promise<{ searchDir: string; projectsPath: string[] }> => {\n  let searchDir = options?.baseDir ?? process.cwd();\n\n  // If gitRoot option is enabled, try to get the git root directory\n  if (options?.gitRoot) {\n    const gitRootDir = await getGitRootDir(searchDir);\n    if (gitRootDir) {\n      searchDir = gitRootDir;\n    }\n  }\n\n  // Build glob patterns for all config file candidates\n  const configPatterns = configurationFilesCandidates.map(\n    (fileName) => `**/${fileName}`\n  );\n\n  // Search for all config files\n  const configFiles = await fg(configPatterns, {\n    cwd: searchDir,\n    absolute: true,\n    ignore: ['**/node_modules/**', '**/.git/**'],\n    dot: true, // Include dot files like .intlayerrc\n  });\n\n  // Extract unique directory paths from config files\n  const projectDirs = [...new Set(configFiles.map((file) => dirname(file)))];\n\n  // Sort alphabetically for consistent output\n  return { searchDir, projectsPath: projectDirs.sort() };\n};\n"],"mappings":";;;;;;;;;AAqBA,MAAM,gBAAgB,OAAO,QAAyC;AACpE,KAAI;AAGF,UAAO,OAFK,MAAM,UAAU,IAAI,GAAG,WAAW,EACpB,SAAS,CAAC,kBAAkB,CAAC,EACxC,MAAM;UACd,QAAQ;AACf,SAAO;;;;;;;;;AAUX,MAAa,eAAe,OAC1B,YAC2D;CAC3D,IAAI,YAAY,SAAS,WAAW,QAAQ,KAAK;AAGjD,KAAI,SAAS,SAAS;EACpB,MAAM,aAAa,MAAM,cAAc,UAAU;AACjD,MAAI,WACF,aAAY;;CAUhB,MAAM,cAAc,MAAM,GALH,6BAA6B,KACjD,aAAa,MAAM,WAIqB,EAAE;EAC3C,KAAK;EACL,UAAU;EACV,QAAQ,CAAC,sBAAsB,aAAa;EAC5C,KAAK;EACN,CAAC;CAGF,MAAM,cAAc,CAAC,GAAG,IAAI,IAAI,YAAY,KAAK,SAAS,QAAQ,KAAK,CAAC,CAAC,CAAC;AAG1E,QAAO;EAAE;EAAW,cAAc,YAAY,MAAM;EAAE"}