@googlarz/agents-sync 1.0.0

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"}

package/dist/derivers/index.d.ts

@@ -0,0 +1,33 @@
+import type { ProjectMetadata } from "../extractor/schema.js";
+export type ToolName = "claude" | "cursor" | "copilot" | "gemini" | "windsurf" | "cline";
+export interface DerivationResult {
+    tool: ToolName | "agents-md";
+    /** Absolute path to the file. */
+    path: string;
+    written: boolean;
+    customBlocksPreserved: number;
+    /** true when dryRun is enabled — file was not written. */
+    skipped?: boolean;
+    error?: string;
+}
+export interface DeriveAllOptions {
+    projectPath: string;
+    agentsMdContent: string;
+    metadata: ProjectMetadata;
+    /** Tools to derive. Defaults to all six. */
+    tools?: ToolName[];
+    dryRun?: boolean;
+    /** @default true */
+    preserveCustom?: boolean;
+}
+export declare const ALL_TOOLS: ToolName[];
+export declare function toolPath(projectPath: string, tool: ToolName): string;
+/**
+ * Runs all (or selected) derivers and writes the results.
+ *
+ * AGENTS.md is always written first as the canonical source file.
+ * Per-tool errors are caught and returned as `{ error }` entries — one
+ * failing tool does not abort the others.
+ */
+export declare function deriveAll(options: DeriveAllOptions): Promise<DerivationResult[]>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/derivers/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAW9D,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AAEzF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC7B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,eAAe,CAAC;IAC1B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oBAAoB;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,eAAO,MAAM,SAAS,EAAE,QAAQ,EAAmE,CAAC;AAMpG,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAepE;AAiCD;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAwEtF"}

package/dist/derivers/index.js

@@ -0,0 +1,124 @@
+import path from "node:path";
+import { writeFileAtomic } from "../lib/file-utils.js";
+import { toMcpError } from "../lib/errors.js";
+import { extractCustomBlocks } from "./merger.js";
+import { deriveClaudeMd } from "./claude.js";
+import { deriveCursorRules } from "./cursor.js";
+import { deriveCopilotInstructions } from "./copilot.js";
+import { deriveGeminiMd } from "./gemini.js";
+import { deriveWindsurfRules } from "./windsurf.js";
+import { deriveClineRules } from "./cline.js";
+export const ALL_TOOLS = ["claude", "cursor", "copilot", "gemini", "windsurf", "cline"];
+// ---------------------------------------------------------------------------
+// Tool → file-path mapping
+// ---------------------------------------------------------------------------
+export function toolPath(projectPath, tool) {
+    switch (tool) {
+        case "claude":
+            return path.join(projectPath, "CLAUDE.md");
+        case "cursor":
+            return path.join(projectPath, ".cursorrules");
+        case "copilot":
+            return path.join(projectPath, ".github", "copilot-instructions.md");
+        case "gemini":
+            return path.join(projectPath, "GEMINI.md");
+        case "windsurf":
+            return path.join(projectPath, ".windsurfrules");
+        case "cline":
+            return path.join(projectPath, ".clinerules");
+    }
+}
+// ---------------------------------------------------------------------------
+// Per-tool content generation
+// ---------------------------------------------------------------------------
+async function deriveContent(tool, options) {
+    const { projectPath, agentsMdContent, metadata, preserveCustom = true } = options;
+    const shared = { projectPath, agentsMdContent, metadata, preserveCustom };
+    switch (tool) {
+        case "claude":
+            return deriveClaudeMd(shared);
+        case "cursor":
+            return deriveCursorRules(shared);
+        case "copilot":
+            return deriveCopilotInstructions(shared);
+        case "gemini":
+            return deriveGeminiMd(shared);
+        case "windsurf":
+            return deriveWindsurfRules(shared);
+        case "cline":
+            return deriveClineRules(shared);
+    }
+}
+// ---------------------------------------------------------------------------
+// Main entry point
+// ---------------------------------------------------------------------------
+/**
+ * Runs all (or selected) derivers and writes the results.
+ *
+ * AGENTS.md is always written first as the canonical source file.
+ * Per-tool errors are caught and returned as `{ error }` entries — one
+ * failing tool does not abort the others.
+ */
+export async function deriveAll(options) {
+    const { projectPath, agentsMdContent, tools = ALL_TOOLS, dryRun = false, } = options;
+    const results = [];
+    // --- Always write AGENTS.md (canonical) --------------------------------
+    const agentsMdPath = path.join(projectPath, "AGENTS.md");
+    try {
+        if (!dryRun) {
+            await writeFileAtomic(agentsMdPath, agentsMdContent);
+        }
+        results.push({
+            tool: "agents-md",
+            path: agentsMdPath,
+            written: !dryRun,
+            customBlocksPreserved: 0,
+            skipped: dryRun || undefined,
+        });
+    }
+    catch (e) {
+        results.push({
+            tool: "agents-md",
+            path: agentsMdPath,
+            written: false,
+            customBlocksPreserved: 0,
+            error: toMcpError(e),
+        });
+    }
+    // --- Derive and write each tool file ------------------------------------
+    for (const tool of tools) {
+        const filePath = toolPath(projectPath, tool);
+        try {
+            const content = await deriveContent(tool, options);
+            const customBlocksPreserved = extractCustomBlocks(content).length;
+            if (dryRun) {
+                results.push({
+                    tool,
+                    path: filePath,
+                    written: false,
+                    customBlocksPreserved,
+                    skipped: true,
+                });
+                continue;
+            }
+            await writeFileAtomic(filePath, content);
+            results.push({
+                tool,
+                path: filePath,
+                written: true,
+                customBlocksPreserved,
+            });
+        }
+        catch (e) {
+            results.push({
+                tool,
+                path: filePath,
+                written: false,
+                customBlocksPreserved: 0,
+                error: toMcpError(e),
+            });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=index.js.map

package/dist/derivers/index.js.map

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

package/dist/derivers/merger.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Returns all text between CUSTOM_START and CUSTOM_END markers.
+ * Multiple blocks are supported; each returned string is the inner content
+ * (exclusive of the marker lines themselves).
+ */
+export declare function extractCustomBlocks(content: string): string[];
+/**
+ * Appends custom blocks at the end of the generated content, each wrapped in
+ * markers and preceded by a divider on the first block.
+ */
+export declare function injectCustomBlocks(generated: string, blocks: string[]): string;
+/**
+ * Reads the file at filePath (if it exists) and extracts its custom blocks.
+ * Returns [] when the file is missing or contains no custom blocks.
+ */
+export declare function loadExistingCustomBlocks(filePath: string): Promise<string[]>;
+/**
+ * Wraps user-provided content in the CUSTOM markers so it can be embedded in a
+ * managed file.
+ */
+export declare function buildCustomSection(userContent: string): string;
+/**
+ * Returns true when the file content was written by agents-sync (has the
+ * generated-by comment at the top).
+ */
+export declare function isManagedByAgentsSync(content: string): boolean;
+/**
+ * If the file at filePath exists and was NOT previously managed by agents-sync,
+ * returns the entire file content wrapped as a single custom block so it
+ * survives the next write. Returns [] when:
+ *   - the file does not exist
+ *   - the file is already managed (has the generated-by marker)
+ *   - the file is empty
+ */
+export declare function loadUnmanagedFileAsCustomBlock(filePath: string): Promise<string[]>;
+//# sourceMappingURL=merger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"merger.d.ts","sourceRoot":"","sources":["../../src/derivers/merger.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAqB7D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAQ9E;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAIlF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE9D;AAID;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;;;;;;GAOG;AACH,wBAAsB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAMxF"}