@googlarz/agents-sync 1.4.0

package/dist/derivers/claude.js

@@ -0,0 +1,93 @@
+import path from "node:path";
+import { injectCustomBlocks, loadExistingCustomBlocks, loadUnmanagedFileAsCustomBlock } from "./merger.js";
+import { scanProjectSkills, formatSkillsSection } from "../scanner/skills.js";
+const CLAUDE_CODE_SECTION = `---
+
+## Claude Code Notes
+
+> This file is managed by agents-sync. Edit \`AGENTS.md\` and run \`/agents-sync sync\`.
+
+### Tool Files
+- Canonical: \`AGENTS.md\`
+- Cursor: \`.cursorrules\`
+- Copilot: \`.github/copilot-instructions.md\`
+
+### Re-sync
+Run \`/agents-sync sync\` after major refactors, new dependencies, or architecture changes.
+Run \`/agents-sync drift\` to check what's changed since last sync.
+`;
+function recommendSkills(metadata) {
+    const recs = [];
+    const { project, stack, testing } = metadata;
+    const lang = project.language.toLowerCase();
+    const fw = (project.framework ?? "").toLowerCase();
+    const testFw = (testing.framework ?? stack.testing ?? "").toLowerCase();
+    const db = (stack.database ?? "").toLowerCase();
+    const auth = (stack.auth ?? "").toLowerCase();
+    const deploy = (stack.deploy ?? stack.deploy ?? "").toLowerCase();
+    // Universal
+    recs.push({ slug: "agent-skills:spec-driven-development", reason: "requirements before code" });
+    // Testing
+    if (testFw || testing.command) {
+        recs.push({ slug: "agent-skills:test-driven-development", reason: `${testFw || "tests"} workflow` });
+    }
+    // Frontend
+    if (/next|react|vue|svelte|solid|nuxt|remix|astro/.test(fw)) {
+        recs.push({ slug: "agent-skills:frontend-ui-engineering", reason: `${fw} UI work` });
+    }
+    // API / backend
+    if (/express|fastify|hono|django|fastapi|flask|axum|gin|echo/.test(fw) || /api|server|backend/.test(project.description?.toLowerCase() ?? "")) {
+        recs.push({ slug: "agent-skills:api-and-interface-design", reason: "API design" });
+    }
+    // Security-sensitive
+    if (auth || /payment|stripe|billing|oauth|jwt|session/.test([db, stack.other.join(" ")].join(" ").toLowerCase())) {
+        recs.push({ slug: "agent-skills:security-and-hardening", reason: "auth/payments in stack" });
+    }
+    // Observability — deploy target present
+    if (deploy) {
+        recs.push({ slug: "agent-skills:observability-and-monitoring", reason: `${deploy} deployment` });
+    }
+    // TypeScript-specific
+    if (lang === "typescript") {
+        recs.push({ slug: "agent-skills:code-review-and-quality", reason: "TypeScript quality gates" });
+    }
+    // Deduplicate by slug
+    const seen = new Set();
+    return recs.filter((r) => {
+        if (seen.has(r.slug))
+            return false;
+        seen.add(r.slug);
+        return true;
+    });
+}
+/**
+ * Derives the full content for CLAUDE.md.
+ *
+ * Content = canonical AGENTS.md + Claude Code-specific section.
+ * If preserveCustom is true (default) any existing custom blocks from the
+ * current CLAUDE.md are appended after the generated body.
+ *
+ * Does NOT write the file — the caller is responsible for writing.
+ */
+export async function deriveClaudeMd(options) {
+    const { projectPath, agentsMdContent, metadata, preserveCustom = true } = options;
+    const skillsSummary = await scanProjectSkills(projectPath);
+    const skillsSection = formatSkillsSection(skillsSummary);
+    const skillsBlock = skillsSection ? `\n${skillsSection}\n` : "";
+    const recs = recommendSkills(metadata);
+    const recsBlock = recs.length > 0
+        ? `\n## Recommended Skills\n\n${recs.map((r) => `- \`/${r.slug}\` — ${r.reason}`).join("\n")}\n`
+        : "";
+    const generated = `${agentsMdContent.trimEnd()}${skillsBlock}${recsBlock}\n${CLAUDE_CODE_SECTION}`;
+    if (!preserveCustom)
+        return generated;
+    const claudeMdPath = path.join(projectPath, "CLAUDE.md");
+    // Preserve managed custom blocks first; fall back to wrapping the whole
+    // file if it exists but was never managed by agents-sync.
+    const existingBlocks = await loadExistingCustomBlocks(claudeMdPath);
+    const blocks = existingBlocks.length > 0
+        ? existingBlocks
+        : await loadUnmanagedFileAsCustomBlock(claudeMdPath);
+    return injectCustomBlocks(generated, blocks);
+}
+//# sourceMappingURL=claude.js.map

package/dist/derivers/claude.js.map

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

package/dist/derivers/cline.d.ts

@@ -0,0 +1,17 @@
+import type { ProjectMetadata } from "../extractor/schema.js";
+export interface ClineDerivationOptions {
+    projectPath: string;
+    agentsMdContent: string;
+    metadata: ProjectMetadata;
+    /** @default true */
+    preserveCustom?: boolean;
+}
+/**
+ * Derives `.clinerules` content from AGENTS.md + metadata.
+ * Cline reads this file for project-specific AI instructions.
+ * Target < 400 words.
+ *
+ * Does NOT write the file — the caller is responsible for writing.
+ */
+export declare function deriveClineRules(options: ClineDerivationOptions): Promise<string>;
+//# sourceMappingURL=cline.d.ts.map

package/dist/derivers/cline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cline.d.ts","sourceRoot":"","sources":["../../src/derivers/cline.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,eAAe,CAAC;IAC1B,oBAAoB;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAyCD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiEvF"}

package/dist/derivers/cline.js

@@ -0,0 +1,92 @@
+import path from "node:path";
+import { injectCustomBlocks, loadExistingCustomBlocks } from "./merger.js";
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function extractSection(content, heading) {
+    const re = new RegExp(`^##\\s+${escapeRegExp(heading)}\\s*$([\\s\\S]*?)(?=^##\\s|$)`, "mi");
+    const match = re.exec(content);
+    return match ? match[1].trim() : "";
+}
+function extractSubSection(content, heading) {
+    const re = new RegExp(`^###\\s+${escapeRegExp(heading)}\\s*$([\\s\\S]*?)(?=^###\\s|^##\\s|$)`, "mi");
+    const match = re.exec(content);
+    return match ? match[1].trim() : "";
+}
+function sectionToLines(text) {
+    return text
+        .split("\n")
+        .map((l) => l.replace(/^[\s\-*>]+/, "").trim())
+        .filter((l) => l.length > 0);
+}
+function deduplicateLines(items) {
+    const seen = new Set();
+    return items.filter((item) => {
+        const key = item.toLowerCase().trim();
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+/**
+ * Derives `.clinerules` content from AGENTS.md + metadata.
+ * Cline reads this file for project-specific AI instructions.
+ * Target < 400 words.
+ *
+ * Does NOT write the file — the caller is responsible for writing.
+ */
+export async function deriveClineRules(options) {
+    const { projectPath, agentsMdContent, metadata, preserveCustom = true } = options;
+    const { project, conventions: metaConventions, gotchas: metaGotchas, boundaries, testing } = metadata;
+    const conventionsSection = sectionToLines(extractSection(agentsMdContent, "Conventions"));
+    const gotchasSection = sectionToLines(extractSection(agentsMdContent, "Gotchas"));
+    const neverSection = sectionToLines(extractSubSection(agentsMdContent, "Never"));
+    const allConventions = deduplicateLines([...metaConventions, ...conventionsSection]);
+    const allGotchas = deduplicateLines([...metaGotchas, ...gotchasSection]);
+    const allNever = deduplicateLines([...boundaries.never, ...neverSection]);
+    const lines = [];
+    const fwPart = project.framework ? ` / ${project.framework}` : "";
+    lines.push(`# .clinerules — managed by agents-sync`);
+    lines.push(`# Language: ${project.language}${fwPart}`);
+    lines.push("");
+    if (allConventions.length > 0) {
+        lines.push("## Conventions");
+        for (const rule of allConventions) {
+            lines.push(`- ${rule}`);
+        }
+        lines.push("");
+    }
+    if (allGotchas.length > 0) {
+        lines.push("## Gotchas");
+        for (const gotcha of allGotchas) {
+            lines.push(`- ${gotcha}`);
+        }
+        lines.push("");
+    }
+    if (allNever.length > 0) {
+        lines.push("## Never");
+        for (const rule of allNever) {
+            lines.push(`- ${rule}`);
+        }
+        lines.push("");
+    }
+    if (boundaries.alwaysDo.length > 0) {
+        lines.push("## Always");
+        for (const rule of boundaries.alwaysDo) {
+            lines.push(`- ${rule}`);
+        }
+        lines.push("");
+    }
+    if (testing.command) {
+        lines.push(`**Tests:** \`${testing.command}\``);
+        lines.push("");
+    }
+    const generated = lines.join("\n").trimEnd() + "\n";
+    if (!preserveCustom)
+        return generated;
+    const clinePath = path.join(projectPath, ".clinerules");
+    const existingBlocks = await loadExistingCustomBlocks(clinePath);
+    return injectCustomBlocks(generated, existingBlocks);
+}
+//# sourceMappingURL=cline.js.map

package/dist/derivers/cline.js.map

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

package/dist/derivers/copilot.d.ts

@@ -0,0 +1,16 @@
+import type { ProjectMetadata } from "../extractor/schema.js";
+export interface CopilotDerivationOptions {
+    projectPath: string;
+    agentsMdContent: string;
+    metadata: ProjectMetadata;
+    /** @default true */
+    preserveCustom?: boolean;
+}
+/**
+ * Derives `.github/copilot-instructions.md` content from AGENTS.md + metadata.
+ * Focuses strictly on inline code-generation context — target < 300 words.
+ *
+ * Does NOT write the file — the caller is responsible for writing.
+ */
+export declare function deriveCopilotInstructions(options: CopilotDerivationOptions): Promise<string>;
+//# sourceMappingURL=copilot.d.ts.map

package/dist/derivers/copilot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot.d.ts","sourceRoot":"","sources":["../../src/derivers/copilot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,eAAe,CAAC;IAC1B,oBAAoB;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAyGD;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,MAAM,CAAC,CA4EjB"}

package/dist/derivers/copilot.js

@@ -0,0 +1,162 @@
+import path from "node:path";
+import { injectCustomBlocks, loadExistingCustomBlocks } from "./merger.js";
+// ---------------------------------------------------------------------------
+// Framework-specific hints
+// ---------------------------------------------------------------------------
+/**
+ * Maps known framework names to inline code-generation hints.
+ * Keeps it short — only things that meaningfully affect completion quality.
+ */
+const FRAMEWORK_HINTS = {
+    nextjs: "prefer Server Components; use `'use client'` only when necessary",
+    "next.js": "prefer Server Components; use `'use client'` only when necessary",
+    react: "functional components only; hooks over class components",
+    django: "use async views where possible; prefer class-based views for CRUD",
+    fastapi: "async endpoints; pydantic models for all request/response shapes",
+    express: "async route handlers; centralise error handling via middleware",
+    axum: "use `#[axum::debug_handler]` during development; prefer extractors",
+    flask: "use blueprints; prefer `current_app` over global state",
+    nuxt: "use `<script setup lang='ts'>`; prefer composables over options API",
+    vue: "use Composition API with `<script setup>`; TypeScript by default",
+    angular: "standalone components preferred; inject via `inject()` function",
+    svelte: "prefer `$state` runes (Svelte 5); avoid legacy reactive statements",
+    remix: "loaders and actions for all data; avoid client-side fetching",
+    nestjs: "dependency injection everywhere; DTOs with class-validator decorators",
+};
+function frameworkHint(framework) {
+    if (!framework)
+        return null;
+    const key = framework.toLowerCase();
+    return FRAMEWORK_HINTS[key] ?? null;
+}
+// ---------------------------------------------------------------------------
+// Parsing helpers (minimal — only what copilot needs)
+// ---------------------------------------------------------------------------
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function extractSubSection(content, heading) {
+    const re = new RegExp(`^###\\s+${escapeRegExp(heading)}\\s*$([\\s\\S]*?)(?=^###\\s|^##\\s|$)`, "mi");
+    const match = re.exec(content);
+    return match ? match[1].trim() : "";
+}
+function sectionToLines(text) {
+    return text
+        .split("\n")
+        .map((l) => l.replace(/^[\s\-*>]+/, "").trim())
+        .filter((l) => l.length > 0);
+}
+// ---------------------------------------------------------------------------
+// Convention filters — keep only lines relevant to code-level suggestions
+// ---------------------------------------------------------------------------
+const CODE_LEVEL_KEYWORDS = [
+    "import",
+    "export",
+    "naming",
+    "filename",
+    "file name",
+    "type",
+    "interface",
+    "async",
+    "await",
+    "module",
+    "esm",
+    "cjs",
+    "require",
+    "class",
+    "function",
+    "const ",
+    "let ",
+    "var ",
+    "enum",
+    "generic",
+    "zod",
+    "schema",
+    "validation",
+    "null",
+    "undefined",
+    "error",
+    "throw",
+    "return",
+    "comment",
+    "doc",
+    "format",
+    "lint",
+];
+function isCodeLevel(rule) {
+    const lower = rule.toLowerCase();
+    return CODE_LEVEL_KEYWORDS.some((kw) => lower.includes(kw));
+}
+// ---------------------------------------------------------------------------
+// Deriver
+// ---------------------------------------------------------------------------
+/**
+ * Derives `.github/copilot-instructions.md` content from AGENTS.md + metadata.
+ * Focuses strictly on inline code-generation context — target < 300 words.
+ *
+ * Does NOT write the file — the caller is responsible for writing.
+ */
+export async function deriveCopilotInstructions(options) {
+    const { projectPath, agentsMdContent, metadata, preserveCustom = true } = options;
+    const { project, stack, conventions: metaConventions, boundaries, testing } = metadata;
+    // Code-level conventions only
+    const codeLevelConventions = metaConventions.filter(isCodeLevel);
+    // "Never" rules that directly affect code generation (short enough to fit)
+    const neverLines = sectionToLines(extractSubSection(agentsMdContent, "Never"));
+    const codeNever = [...boundaries.never, ...neverLines]
+        .filter(isCodeLevel)
+        .slice(0, 6); // hard cap to stay under word budget
+    const lines = [];
+    // Header
+    lines.push("# GitHub Copilot Instructions — managed by agents-sync");
+    lines.push("");
+    // Language + framework
+    const fwPart = project.framework ? ` / ${project.framework}` : "";
+    lines.push(`**Stack:** ${project.language}${fwPart}${stack.runtime ? ` (${stack.runtime})` : ""}`);
+    lines.push("");
+    // Framework-specific hint
+    const hint = frameworkHint(project.framework);
+    if (hint) {
+        lines.push(`**Framework:** ${hint}`);
+        lines.push("");
+    }
+    // Import style — derive from conventions or fall back to language default
+    const importConvention = metaConventions.find((c) => c.toLowerCase().includes("import") || c.toLowerCase().includes("esm") || c.toLowerCase().includes("require"));
+    if (importConvention) {
+        lines.push(`**Imports:** ${importConvention}`);
+        lines.push("");
+    }
+    // Test location / naming
+    if (testing.location || testing.command) {
+        const testParts = [];
+        if (testing.location)
+            testParts.push(`location: ${testing.location}`);
+        if (testing.command)
+            testParts.push(`run: \`${testing.command}\``);
+        lines.push(`**Tests:** ${testParts.join(" · ")}`);
+        lines.push("");
+    }
+    // Code-level conventions
+    if (codeLevelConventions.length > 0) {
+        lines.push("## Conventions");
+        for (const rule of codeLevelConventions) {
+            lines.push(`- ${rule}`);
+        }
+        lines.push("");
+    }
+    // Hard never rules (code-affecting)
+    if (codeNever.length > 0) {
+        lines.push("## Never");
+        for (const rule of codeNever) {
+            lines.push(`- ${rule}`);
+        }
+        lines.push("");
+    }
+    const generated = lines.join("\n").trimEnd() + "\n";
+    if (!preserveCustom)
+        return generated;
+    const copilotPath = path.join(projectPath, ".github", "copilot-instructions.md");
+    const existingBlocks = await loadExistingCustomBlocks(copilotPath);
+    return injectCustomBlocks(generated, existingBlocks);
+}
+//# sourceMappingURL=copilot.js.map

package/dist/derivers/copilot.js.map

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

package/dist/derivers/cursor.d.ts

@@ -0,0 +1,16 @@
+import type { ProjectMetadata } from "../extractor/schema.js";
+export interface CursorDerivationOptions {
+    projectPath: string;
+    agentsMdContent: string;
+    metadata: ProjectMetadata;
+    /** @default true */
+    preserveCustom?: boolean;
+}
+/**
+ * Derives directive-style `.cursorrules` content from AGENTS.md + metadata.
+ * Keeps output terse and scannable — target < 400 words.
+ *
+ * Does NOT write the file — the caller is responsible for writing.
+ */
+export declare function deriveCursorRules(options: CursorDerivationOptions): Promise<string>;
+//# sourceMappingURL=cursor.d.ts.map

package/dist/derivers/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/derivers/cursor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,eAAe,CAAC;IAC1B,oBAAoB;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAkDD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6EzF"}

package/dist/derivers/cursor.js

@@ -0,0 +1,121 @@
+import path from "node:path";
+import { injectCustomBlocks, loadExistingCustomBlocks } from "./merger.js";
+// ---------------------------------------------------------------------------
+// Parsing helpers
+// ---------------------------------------------------------------------------
+/**
+ * Extracts the text body of the first `## Heading` section that matches the
+ * given heading name (case-insensitive). Returns an empty string when not found.
+ */
+function extractSection(content, heading) {
+    const re = new RegExp(`^##\\s+${escapeRegExp(heading)}\\s*$([\\s\\S]*?)(?=^##\\s|$)`, "mi");
+    const match = re.exec(content);
+    return match ? match[1].trim() : "";
+}
+/**
+ * Extracts the text body of the first `### Heading` subsection that matches.
+ */
+function extractSubSection(content, heading) {
+    const re = new RegExp(`^###\\s+${escapeRegExp(heading)}\\s*$([\\s\\S]*?)(?=^###\\s|^##\\s|$)`, "mi");
+    const match = re.exec(content);
+    return match ? match[1].trim() : "";
+}
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Parses a markdown section into a list of individual rule strings, stripping
+ * leading list markers and blank lines.
+ */
+function sectionToLines(text) {
+    return text
+        .split("\n")
+        .map((l) => l.replace(/^[\s\-*>]+/, "").trim())
+        .filter((l) => l.length > 0);
+}
+// ---------------------------------------------------------------------------
+// Deriver
+// ---------------------------------------------------------------------------
+/**
+ * Derives directive-style `.cursorrules` content from AGENTS.md + metadata.
+ * Keeps output terse and scannable — target < 400 words.
+ *
+ * Does NOT write the file — the caller is responsible for writing.
+ */
+export async function deriveCursorRules(options) {
+    const { projectPath, agentsMdContent, metadata, preserveCustom = true } = options;
+    const { project, conventions: metaConventions, gotchas: metaGotchas, boundaries, testing } = metadata;
+    // Pull extra rules from AGENTS.md prose
+    const conventionsSection = sectionToLines(extractSection(agentsMdContent, "Conventions"));
+    const gotchasSection = sectionToLines(extractSection(agentsMdContent, "Gotchas"));
+    const neverSection = sectionToLines(extractSubSection(agentsMdContent, "Never"));
+    // Merge with metadata, preferring metadata as it's structured
+    const allConventions = deduplicateLines([...metaConventions, ...conventionsSection]);
+    const allGotchas = deduplicateLines([...metaGotchas, ...gotchasSection]);
+    const allNever = deduplicateLines([...boundaries.never, ...neverSection]);
+    const lines = [];
+    // Header
+    lines.push("# .cursorrules — managed by agents-sync");
+    lines.push("");
+    // Project identity
+    const frameworkPart = project.framework ? ` · ${project.framework}` : "";
+    lines.push(`${project.name} — ${project.language}${frameworkPart}`);
+    lines.push("");
+    // Test command
+    if (testing.command) {
+        lines.push(`**Test command:** \`${testing.command}\``);
+        lines.push("");
+    }
+    // Conventions
+    if (allConventions.length > 0) {
+        lines.push("## Conventions");
+        for (const rule of allConventions) {
+            lines.push(`- Always: ${rule}`);
+        }
+        lines.push("");
+    }
+    // Gotchas
+    if (allGotchas.length > 0) {
+        lines.push("## Gotchas");
+        for (const gotcha of allGotchas) {
+            // Gotchas already include consequence phrasing; surface as "Never" hints
+            lines.push(`- Never: ${gotcha}`);
+        }
+        lines.push("");
+    }
+    // Hard never rules (boundaries)
+    if (allNever.length > 0) {
+        lines.push("## Hard boundaries");
+        for (const rule of allNever) {
+            lines.push(`- Never: ${rule}`);
+        }
+        lines.push("");
+    }
+    // Always-do boundaries
+    if (boundaries.alwaysDo.length > 0) {
+        lines.push("## Always do");
+        for (const rule of boundaries.alwaysDo) {
+            lines.push(`- ${rule}`);
+        }
+        lines.push("");
+    }
+    const generated = lines.join("\n").trimEnd() + "\n";
+    if (!preserveCustom)
+        return generated;
+    const cursorPath = path.join(projectPath, ".cursorrules");
+    const existingBlocks = await loadExistingCustomBlocks(cursorPath);
+    return injectCustomBlocks(generated, existingBlocks);
+}
+function deduplicateLines(items) {
+    const seen = new Set();
+    const result = [];
+    for (const item of items) {
+        const key = item.toLowerCase().trim();
+        if (!seen.has(key)) {
+            seen.add(key);
+            result.push(item);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=cursor.js.map

package/dist/derivers/cursor.js.map

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

package/dist/derivers/gemini.d.ts

@@ -0,0 +1,19 @@
+import type { ProjectMetadata } from "../extractor/schema.js";
+export interface GeminiDerivationOptions {
+    projectPath: string;
+    agentsMdContent: string;
+    metadata: ProjectMetadata;
+    /** @default true */
+    preserveCustom?: boolean;
+}
+/**
+ * Derives the full content for GEMINI.md.
+ *
+ * Content = canonical AGENTS.md + Gemini CLI-specific section.
+ * If preserveCustom is true (default) any existing custom blocks from the
+ * current GEMINI.md are appended after the generated body.
+ *
+ * Does NOT write the file — the caller is responsible for writing.
+ */
+export declare function deriveGeminiMd(options: GeminiDerivationOptions): Promise<string>;
+//# sourceMappingURL=gemini.d.ts.map

package/dist/derivers/gemini.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../src/derivers/gemini.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,eAAe,CAAC;IAC1B,oBAAoB;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAYD;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CActF"}

package/dist/derivers/gemini.js

@@ -0,0 +1,33 @@
+import path from "node:path";
+import { injectCustomBlocks, loadExistingCustomBlocks, loadUnmanagedFileAsCustomBlock } from "./merger.js";
+const GEMINI_SECTION = `---
+
+## Gemini CLI Notes
+
+> This file is managed by agents-sync. Edit \`AGENTS.md\` and run \`/agents-sync sync\`.
+
+### Re-sync
+Run \`agents-sync sync\` after major refactors, new dependencies, or architecture changes.
+`;
+/**
+ * Derives the full content for GEMINI.md.
+ *
+ * Content = canonical AGENTS.md + Gemini CLI-specific section.
+ * If preserveCustom is true (default) any existing custom blocks from the
+ * current GEMINI.md are appended after the generated body.
+ *
+ * Does NOT write the file — the caller is responsible for writing.
+ */
+export async function deriveGeminiMd(options) {
+    const { projectPath, agentsMdContent, preserveCustom = true } = options;
+    const generated = `${agentsMdContent.trimEnd()}\n\n${GEMINI_SECTION}`;
+    if (!preserveCustom)
+        return generated;
+    const geminiPath = path.join(projectPath, "GEMINI.md");
+    const existingBlocks = await loadExistingCustomBlocks(geminiPath);
+    const blocks = existingBlocks.length > 0
+        ? existingBlocks
+        : await loadUnmanagedFileAsCustomBlock(geminiPath);
+    return injectCustomBlocks(generated, blocks);
+}
+//# sourceMappingURL=gemini.js.map

package/dist/derivers/gemini.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.js","sourceRoot":"","sources":["../../src/derivers/gemini.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAU3G,MAAM,cAAc,GAAG;;;;;;;;CAQtB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAgC;IACnE,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAExE,MAAM,SAAS,GAAG,GAAG,eAAe,CAAC,OAAO,EAAE,OAAO,cAAc,EAAE,CAAC;IAEtE,IAAI,CAAC,cAAc;QAAE,OAAO,SAAS,CAAC;IAEtC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IACvD,MAAM,cAAc,GAAG,MAAM,wBAAwB,CAAC,UAAU,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,GAAG,CAAC;QACtC,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,MAAM,8BAA8B,CAAC,UAAU,CAAC,CAAC;IAErD,OAAO,kBAAkB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAC/C,CAAC"}