@googlarz/agents-sync 1.4.0

package/dist/cli.js

@@ -0,0 +1,267 @@
+#!/usr/bin/env node
+/**
+ * agents-sync CLI
+ *
+ * Usage:
+ *   npx @googlarz/agents-sync                  Start MCP server (default)
+ *   npx @googlarz/agents-sync init [path]      Generate all context files
+ *   npx @googlarz/agents-sync sync [path]      Re-sync after codebase changes
+ *   npx @googlarz/agents-sync drift [path]     Check what changed
+ *   npx @googlarz/agents-sync validate [path]  Check files are in sync
+ *   npx @googlarz/agents-sync status [path]    Show sync status
+ *   npx @googlarz/agents-sync export <tool> [path]  Re-derive a single file
+ */
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+import fs from "node:fs";
+import process from "node:process";
+import { isAgentsSyncError } from "./lib/errors.js";
+const args = process.argv.slice(2);
+const cwd = process.cwd();
+// ---------------------------------------------------------------------------
+// Flags
+// ---------------------------------------------------------------------------
+function hasFlag(...flags) {
+    return flags.some((f) => args.includes(f));
+}
+function removeFlags(argv) {
+    return argv.filter((a) => !a.startsWith("--") && !a.startsWith("-"));
+}
+// ---------------------------------------------------------------------------
+// --version / --help
+// ---------------------------------------------------------------------------
+if (hasFlag("--version", "-v")) {
+    const pkgPath = path.join(path.dirname(fileURLToPath(import.meta.url)), "..", "package.json");
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+    process.stdout.write(`@googlarz/agents-sync v${pkg.version}\n`);
+    process.exit(0);
+}
+if (hasFlag("--help", "-h")) {
+    process.stdout.write(`
+agents-sync — AI context file generator and syncer
+
+USAGE
+  agents-sync [command] [path] [options]
+
+COMMANDS
+  init [path]               Analyze codebase, generate all context files
+  sync [path]               Re-sync after codebase changes
+  drift [path]              Check what changed since last sync
+  validate [path]           Check if all files match AGENTS.md
+  scan [path]               Show what agents-sync detected (no API key needed)
+  lint [path]               Verify codebase against 'Never' rules in AGENTS.md
+  status [path]             Show sync status and managed files
+  export <tool> [path]      Re-derive a single tool file (no API call)
+                            Tools: claude, cursor, copilot, gemini, windsurf, cline, roo, aider
+
+  (no command)              Start MCP server (stdio transport)
+
+OPTIONS
+  --dry-run                 Preview changes without writing files
+  --fast                    sync only — skip API call if drift is minor
+  --ci                      drift/lint — exit 1 when drift is HIGH or lint has violations
+  --tools <list>            Comma-separated tools to generate (init/sync)
+                            e.g. --tools claude,cursor,roo,aider
+  --repomix-output <file>   Use repomix XML/text output as source corpus
+                            (init/sync) instead of filesystem sampling
+  --version, -v             Print version
+  --help, -h                Show this help
+
+EXAMPLES
+  npx @googlarz/agents-sync scan .
+  npx @googlarz/agents-sync init .
+  npx @googlarz/agents-sync sync . --fast
+  npx @googlarz/agents-sync drift . --ci
+  npx @googlarz/agents-sync export cursor .
+
+SETUP (MCP — Claude Code)
+  Add to ~/.claude/claude_desktop_config.json or .claude/settings.json:
+
+  {
+    "mcpServers": {
+      "agents-sync": {
+        "command": "npx",
+        "args": ["@googlarz/agents-sync"],
+        "env": { "ANTHROPIC_API_KEY": "sk-ant-..." }
+      }
+    }
+  }
+
+ENVIRONMENT
+  ANTHROPIC_API_KEY     Required for init and sync
+  AGENTS_SYNC_DEBUG=1   Verbose debug output to stderr
+  NO_COLOR=1            Disable ANSI color
+
+`);
+    process.exit(0);
+}
+// ---------------------------------------------------------------------------
+// CLI subcommand dispatch
+// ---------------------------------------------------------------------------
+const positional = removeFlags(args);
+const subcommand = positional[0];
+const dryRun = hasFlag("--dry-run");
+const fast = hasFlag("--fast");
+const ci = hasFlag("--ci");
+function resolvePath(pos) {
+    return pos ? path.resolve(pos) : cwd;
+}
+function getTools() {
+    const idx = args.indexOf("--tools");
+    if (idx === -1)
+        return undefined;
+    const val = args[idx + 1];
+    return val ? val.split(",").map((t) => t.trim()) : undefined;
+}
+function getFlag(name) {
+    const idx = args.indexOf(name);
+    if (idx === -1)
+        return undefined;
+    return args[idx + 1];
+}
+function die(msg) {
+    process.stderr.write(`agents-sync error: ${msg}\n`);
+    process.exit(1);
+}
+function printResult(data) {
+    process.stdout.write(JSON.stringify(data, null, 2) + "\n");
+}
+async function runCli() {
+    switch (subcommand) {
+        case "init": {
+            const { runInit } = await import("./tools/init.js");
+            const projectPath = resolvePath(positional[1]);
+            const tools = getTools();
+            const repomixOutput = getFlag("--repomix-output");
+            const result = await runInit({ projectPath, tools, dryRun, repomixOutput });
+            if (result.dryRun) {
+                process.stdout.write(`Dry run — no files written.\n`);
+                process.stdout.write(`Would generate:\n`);
+                process.stdout.write(`  AGENTS.md\n`);
+            }
+            else {
+                process.stdout.write(`✓ AGENTS.md → ${result.agentsMdPath}\n`);
+                for (const f of result.filesWritten) {
+                    process.stdout.write(`✓ ${f.tool} → ${f.path}\n`);
+                }
+                if (result.preservedExistingFiles.length > 0) {
+                    process.stdout.write(`\n⚠ Preserved pre-existing files as custom sections:\n`);
+                    for (const f of result.preservedExistingFiles) {
+                        process.stdout.write(`  ${f}\n`);
+                    }
+                }
+            }
+            for (const w of result.warnings) {
+                process.stdout.write(`  → ${w}\n`);
+            }
+            break;
+        }
+        case "sync": {
+            const { runSync } = await import("./tools/sync.js");
+            const projectPath = resolvePath(positional[1]);
+            const tools = getTools();
+            const repomixOutput = getFlag("--repomix-output");
+            const result = await runSync({ projectPath, tools, fast, dryRun, repomixOutput });
+            for (const f of result.filesUpdated) {
+                process.stdout.write(`✓ ${f.tool} → ${f.path}\n`);
+            }
+            for (const w of result.warnings) {
+                process.stdout.write(`  → ${w}\n`);
+            }
+            break;
+        }
+        case "drift": {
+            const { runDrift } = await import("./tools/drift.js");
+            const projectPath = resolvePath(positional[1]);
+            const result = await runDrift({ projectPath });
+            process.stdout.write(result.report + "\n");
+            if (ci && result.highDrift) {
+                process.exit(1);
+            }
+            break;
+        }
+        case "validate": {
+            const { runValidate } = await import("./tools/validate.js");
+            const projectPath = resolvePath(positional[1]);
+            const result = await runValidate({ projectPath });
+            process.stdout.write(result.report + "\n");
+            if (!result.allInSync)
+                process.exit(1);
+            break;
+        }
+        case "status": {
+            const { runStatus } = await import("./tools/status.js");
+            const projectPath = resolvePath(positional[1]);
+            const result = await runStatus({ projectPath });
+            printResult(result);
+            break;
+        }
+        case "lint": {
+            const { runLint } = await import("./tools/lint.js");
+            const projectPath = resolvePath(positional[1]);
+            const result = await runLint({ projectPath, strict: ci });
+            process.stdout.write(result.report + "\n");
+            if (!result.passed)
+                process.exit(1);
+            break;
+        }
+        case "scan": {
+            const { runScanReport } = await import("./tools/scan-report.js");
+            const projectPath = resolvePath(positional[1]);
+            const result = await runScanReport({ projectPath });
+            process.stdout.write(result.report + "\n");
+            break;
+        }
+        case "export": {
+            const { runExport } = await import("./tools/export.js");
+            const tool = positional[1];
+            const projectPath = resolvePath(positional[2]);
+            if (!tool)
+                die("export requires a tool name: claude, cursor, copilot, gemini, windsurf, cline, roo, aider");
+            const result = await runExport({ projectPath, tool: tool });
+            process.stdout.write(result.report + "\n");
+            break;
+        }
+        case undefined:
+        case "--mcp": {
+            // Default: start MCP server
+            await import("./server.js");
+            break;
+        }
+        default:
+            die(`unknown command: ${subcommand}. Run --help for usage.`);
+    }
+}
+runCli().catch(async (err) => {
+    if (isAgentsSyncError(err) && err.code === "MISSING_API_KEY") {
+        // Show scan output first so the user knows what we found, then explain setup
+        try {
+            const { runScanReport } = await import("./tools/scan-report.js");
+            const projectPath = subcommand === "init" || subcommand === "sync"
+                ? resolvePath(positional[1])
+                : cwd;
+            const result = await runScanReport({ projectPath });
+            process.stdout.write(result.report + "\n");
+        }
+        catch {
+            // scan failed — skip it and show the plain error message
+        }
+        process.stderr.write([
+            "  agents-sync: ANTHROPIC_API_KEY not set",
+            "",
+            "  The init and sync commands call Claude to analyze your codebase.",
+            "  These commands do NOT need an API key:",
+            "    agents-sync scan      agents-sync drift",
+            "    agents-sync validate  agents-sync status   agents-sync export",
+            "",
+            "  Get a key at: https://console.anthropic.com/",
+            "  Then set it:  export ANTHROPIC_API_KEY=sk-ant-...",
+            "",
+        ].join("\n"));
+        process.exit(1);
+    }
+    const msg = isAgentsSyncError(err) ? err.format() : err instanceof Error ? err.message : String(err);
+    process.stderr.write(`agents-sync error: ${msg}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config/loader.d.ts

@@ -0,0 +1,9 @@
+import { type AgentsSyncConfig } from "./schema.js";
+import type { ProjectMetadata } from "../extractor/schema.js";
+export declare function loadConfig(projectPath: string): Promise<AgentsSyncConfig | null>;
+/**
+ * Merge config-defined conventions and boundaries into extracted metadata.
+ * Config items are appended after Claude-extracted ones so they survive re-sync.
+ */
+export declare function applyConfig(metadata: ProjectMetadata, config: AgentsSyncConfig | null): ProjectMetadata;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAGA,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAI9D,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CA0BtF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,eAAe,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,GAAG,eAAe,CAevG"}

package/dist/config/loader.js

@@ -0,0 +1,55 @@
+import path from "node:path";
+import fs from "node:fs/promises";
+import { ZodError } from "zod";
+import { AgentsSyncConfigSchema } from "./schema.js";
+const CONFIG_FILE = "agents-sync.config.json";
+export async function loadConfig(projectPath) {
+    const configPath = path.join(projectPath, CONFIG_FILE);
+    let raw;
+    try {
+        raw = await fs.readFile(configPath, "utf-8");
+    }
+    catch (e) {
+        if (e.code === "ENOENT")
+            return null;
+        throw e;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (e) {
+        throw new Error(`${CONFIG_FILE} is not valid JSON: ${e.message}`);
+    }
+    try {
+        return AgentsSyncConfigSchema.parse(parsed);
+    }
+    catch (e) {
+        if (e instanceof ZodError) {
+            const issues = e.issues.map((i) => `  ${i.path.join(".")}: ${i.message}`).join("\n");
+            throw new Error(`${CONFIG_FILE} has validation errors:\n${issues}`);
+        }
+        throw e;
+    }
+}
+/**
+ * Merge config-defined conventions and boundaries into extracted metadata.
+ * Config items are appended after Claude-extracted ones so they survive re-sync.
+ */
+export function applyConfig(metadata, config) {
+    if (!config)
+        return metadata;
+    return {
+        ...metadata,
+        conventions: [
+            ...metadata.conventions,
+            ...(config.conventions?.inject ?? []),
+        ],
+        boundaries: {
+            alwaysDo: [...metadata.boundaries.alwaysDo, ...(config.boundaries?.alwaysDo ?? [])],
+            askFirst: [...metadata.boundaries.askFirst, ...(config.boundaries?.askFirst ?? [])],
+            never: [...metadata.boundaries.never, ...(config.boundaries?.never ?? [])],
+        },
+    };
+}
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAC/B,OAAO,EAAE,sBAAsB,EAAyB,MAAM,aAAa,CAAC;AAG5E,MAAM,WAAW,GAAG,yBAAyB,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,WAAmB;IAClD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IACvD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAK,CAA2B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAChE,MAAM,CAAC,CAAC;IACV,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,GAAG,WAAW,uBAAwB,CAAiB,CAAC,OAAO,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,IAAI,CAAC;QACH,OAAO,sBAAsB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,QAAQ,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrF,MAAM,IAAI,KAAK,CAAC,GAAG,WAAW,4BAA4B,MAAM,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,QAAyB,EAAE,MAA+B;IACpF,IAAI,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC;IAE7B,OAAO;QACL,GAAG,QAAQ;QACX,WAAW,EAAE;YACX,GAAG,QAAQ,CAAC,WAAW;YACvB,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,IAAI,EAAE,CAAC;SACtC;QACD,UAAU,EAAE;YACV,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC;YACnF,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC;YACnF,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;SAC3E;KACF,CAAC;AACJ,CAAC"}

package/dist/config/schema.d.ts

@@ -0,0 +1,69 @@
+import { z } from "zod";
+export declare const ToolNameSchema: z.ZodEnum<["claude", "cursor", "copilot", "gemini", "windsurf", "cline"]>;
+export declare const AgentsSyncConfigSchema: z.ZodObject<{
+    /** Which tool files to generate. Overridden by --tools flag. */
+    tools: z.ZodOptional<z.ZodArray<z.ZodEnum<["claude", "cursor", "copilot", "gemini", "windsurf", "cline"]>, "many">>;
+    /** Team conventions injected into every generated file. */
+    conventions: z.ZodOptional<z.ZodObject<{
+        inject: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        inject?: string[] | undefined;
+    }, {
+        inject?: string[] | undefined;
+    }>>;
+    /** Team boundaries injected into every generated file. */
+    boundaries: z.ZodOptional<z.ZodObject<{
+        alwaysDo: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        askFirst: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        never: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        never?: string[] | undefined;
+        alwaysDo?: string[] | undefined;
+        askFirst?: string[] | undefined;
+    }, {
+        never?: string[] | undefined;
+        alwaysDo?: string[] | undefined;
+        askFirst?: string[] | undefined;
+    }>>;
+    /** Tune the codebase scanner. */
+    extraction: z.ZodOptional<z.ZodObject<{
+        maxSourceFiles: z.ZodOptional<z.ZodNumber>;
+        maxTokensPerFile: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        maxSourceFiles?: number | undefined;
+        maxTokensPerFile?: number | undefined;
+    }, {
+        maxSourceFiles?: number | undefined;
+        maxTokensPerFile?: number | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    conventions?: {
+        inject?: string[] | undefined;
+    } | undefined;
+    boundaries?: {
+        never?: string[] | undefined;
+        alwaysDo?: string[] | undefined;
+        askFirst?: string[] | undefined;
+    } | undefined;
+    tools?: ("claude" | "cursor" | "copilot" | "gemini" | "windsurf" | "cline")[] | undefined;
+    extraction?: {
+        maxSourceFiles?: number | undefined;
+        maxTokensPerFile?: number | undefined;
+    } | undefined;
+}, {
+    conventions?: {
+        inject?: string[] | undefined;
+    } | undefined;
+    boundaries?: {
+        never?: string[] | undefined;
+        alwaysDo?: string[] | undefined;
+        askFirst?: string[] | undefined;
+    } | undefined;
+    tools?: ("claude" | "cursor" | "copilot" | "gemini" | "windsurf" | "cline")[] | undefined;
+    extraction?: {
+        maxSourceFiles?: number | undefined;
+        maxTokensPerFile?: number | undefined;
+    } | undefined;
+}>;
+export type AgentsSyncConfig = z.infer<typeof AgentsSyncConfigSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,cAAc,2EAAyE,CAAC;AAErG,eAAO,MAAM,sBAAsB;IAE/B,gEAAgE;;IAGhE,2DAA2D;;;;;;;;IAU3D,0DAA0D;;;;;;;;;;;;;;IAS1D,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ1B,CAAC;AAEZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/config/schema.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+export const ToolNameSchema = z.enum(["claude", "cursor", "copilot", "gemini", "windsurf", "cline"]);
+export const AgentsSyncConfigSchema = z
+    .object({
+    /** Which tool files to generate. Overridden by --tools flag. */
+    tools: z.array(ToolNameSchema).optional(),
+    /** Team conventions injected into every generated file. */
+    conventions: z
+        .object({
+        inject: z
+            .array(z.string())
+            .optional()
+            .describe("Conventions appended to Claude-extracted ones"),
+    })
+        .optional(),
+    /** Team boundaries injected into every generated file. */
+    boundaries: z
+        .object({
+        alwaysDo: z.array(z.string()).optional(),
+        askFirst: z.array(z.string()).optional(),
+        never: z.array(z.string()).optional(),
+    })
+        .optional(),
+    /** Tune the codebase scanner. */
+    extraction: z
+        .object({
+        maxSourceFiles: z.number().int().positive().optional(),
+        maxTokensPerFile: z.number().int().positive().optional(),
+    })
+        .optional(),
+})
+    .strict();
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;AAErG,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC;KACpC,MAAM,CAAC;IACN,gEAAgE;IAChE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE;IAEzC,2DAA2D;IAC3D,WAAW,EAAE,CAAC;SACX,MAAM,CAAC;QACN,MAAM,EAAE,CAAC;aACN,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,EAAE;aACV,QAAQ,CAAC,+CAA+C,CAAC;KAC7D,CAAC;SACD,QAAQ,EAAE;IAEb,0DAA0D;IAC1D,UAAU,EAAE,CAAC;SACV,MAAM,CAAC;QACN,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;QACxC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;QACxC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;KACtC,CAAC;SACD,QAAQ,EAAE;IAEb,iCAAiC;IACjC,UAAU,EAAE,CAAC;SACV,MAAM,CAAC;QACN,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QACtD,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;KACzD,CAAC;SACD,QAAQ,EAAE;CACd,CAAC;KACD,MAAM,EAAE,CAAC"}

package/dist/derivers/aider.d.ts

@@ -0,0 +1,19 @@
+import type { ProjectMetadata } from "../extractor/schema.js";
+export interface AiderDerivationOptions {
+    projectPath: string;
+    agentsMdContent: string;
+    metadata: ProjectMetadata;
+    /** @default true */
+    preserveCustom?: boolean;
+}
+/**
+ * Derives `CONVENTIONS.md` for Aider.
+ *
+ * Aider reads CONVENTIONS.md (or .aider.conf.yml) from the project root and
+ * includes it as context in every session. We write conventions + boundaries
+ * in plain markdown — no tool-specific syntax needed.
+ *
+ * Does NOT write the file — the caller is responsible.
+ */
+export declare function deriveAiderConventions(options: AiderDerivationOptions): Promise<string>;
+//# sourceMappingURL=aider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aider.d.ts","sourceRoot":"","sources":["../../src/derivers/aider.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;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsF7F"}

package/dist/derivers/aider.js

@@ -0,0 +1,117 @@
+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 `CONVENTIONS.md` for Aider.
+ *
+ * Aider reads CONVENTIONS.md (or .aider.conf.yml) from the project root and
+ * includes it as context in every session. We write conventions + boundaries
+ * in plain markdown — no tool-specific syntax needed.
+ *
+ * Does NOT write the file — the caller is responsible.
+ */
+export async function deriveAiderConventions(options) {
+    const { projectPath, agentsMdContent, metadata, preserveCustom = true } = options;
+    const { project, conventions: metaConventions, gotchas: metaGotchas, boundaries, testing, stack } = metadata;
+    const conventionsSection = sectionToLines(extractSection(agentsMdContent, "Conventions"));
+    const gotchasSection = sectionToLines(extractSection(agentsMdContent, "Gotchas"));
+    const neverSection = sectionToLines(extractSubSection(agentsMdContent, "Never"));
+    const alwaysSection = sectionToLines(extractSubSection(agentsMdContent, "Always"));
+    const askFirstSection = sectionToLines(extractSubSection(agentsMdContent, "Ask first"));
+    const allConventions = deduplicateLines([...metaConventions, ...conventionsSection]);
+    const allGotchas = deduplicateLines([...metaGotchas, ...gotchasSection]);
+    const allNever = deduplicateLines([...boundaries.never, ...neverSection]);
+    const allAlways = deduplicateLines([...boundaries.alwaysDo, ...alwaysSection]);
+    const allAskFirst = deduplicateLines([...boundaries.askFirst, ...askFirstSection]);
+    const lines = [];
+    lines.push(`# CONVENTIONS.md — managed by agents-sync`);
+    lines.push(`# ${project.name ?? "Project"} · ${project.language}${project.framework ? ` / ${project.framework}` : ""}`);
+    lines.push("");
+    if (stack.database || stack.testing || stack.deploy) {
+        lines.push("## Stack");
+        if (stack.database)
+            lines.push(`- Database: ${stack.database}`);
+        if (stack.testing)
+            lines.push(`- Testing: ${stack.testing}`);
+        if (stack.deploy)
+            lines.push(`- Deploy: ${stack.deploy}`);
+        lines.push("");
+    }
+    if (allConventions.length > 0) {
+        lines.push("## Conventions");
+        for (const rule of allConventions) {
+            lines.push(`- ${rule}`);
+        }
+        lines.push("");
+    }
+    if (allNever.length > 0) {
+        lines.push("## Never");
+        for (const rule of allNever) {
+            lines.push(`- ${rule}`);
+        }
+        lines.push("");
+    }
+    if (allAlways.length > 0) {
+        lines.push("## Always");
+        for (const rule of allAlways) {
+            lines.push(`- ${rule}`);
+        }
+        lines.push("");
+    }
+    if (allAskFirst.length > 0) {
+        lines.push("## Ask first");
+        for (const rule of allAskFirst) {
+            lines.push(`- ${rule}`);
+        }
+        lines.push("");
+    }
+    if (allGotchas.length > 0) {
+        lines.push("## Gotchas");
+        for (const gotcha of allGotchas) {
+            lines.push(`- ${gotcha}`);
+        }
+        lines.push("");
+    }
+    if (testing.command) {
+        lines.push("## Testing");
+        lines.push(`- Run: \`${testing.command}\``);
+        if (testing.location)
+            lines.push(`- Tests in: \`${testing.location}\``);
+        lines.push("");
+    }
+    const generated = lines.join("\n").trimEnd() + "\n";
+    if (!preserveCustom)
+        return generated;
+    const conventionsPath = path.join(projectPath, "CONVENTIONS.md");
+    const existingBlocks = await loadExistingCustomBlocks(conventionsPath);
+    return injectCustomBlocks(generated, existingBlocks);
+}
+//# sourceMappingURL=aider.js.map

package/dist/derivers/aider.js.map

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

package/dist/derivers/claude.d.ts

@@ -0,0 +1,19 @@
+import type { ProjectMetadata } from "../extractor/schema.js";
+export interface ClaudeDerivationOptions {
+    projectPath: string;
+    agentsMdContent: string;
+    metadata: ProjectMetadata;
+    /** @default true */
+    preserveCustom?: boolean;
+}
+/**
+ * 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 declare function deriveClaudeMd(options: ClaudeDerivationOptions): Promise<string>;
+//# sourceMappingURL=claude.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/derivers/claude.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAI9D,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;AAwED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBtF"}