@googlarz/agents-sync 1.0.0

package/dist/scanner/structure.js

@@ -0,0 +1,168 @@
+import path from "node:path";
+import fg from "fast-glob";
+const IGNORE_PATTERNS = [
+    "**/node_modules/**",
+    "**/.git/**",
+    "**/dist/**",
+    "**/build/**",
+    "**/__pycache__/**",
+    "**/.venv/**",
+    "**/target/**",
+    "**/.next/**",
+    "**/coverage/**",
+    "**/.cache/**",
+];
+const ENTRY_POINT_PATTERNS = [
+    /^src\/index\./,
+    /^index\./,
+    /^main\./,
+    /^app\./,
+    /^server\./,
+    /^cmd\/main\./,
+    /^manage\.py$/,
+    /^wsgi\.py$/,
+];
+function detectNamingConvention(names) {
+    const counts = { kebab: 0, camel: 0, snake: 0, pascal: 0 };
+    for (const name of names) {
+        if (/^[A-Z][a-zA-Z0-9]*$/.test(name))
+            counts.pascal++;
+        else if (/^[a-z][a-zA-Z0-9]*[A-Z]/.test(name))
+            counts.camel++;
+        else if (name.includes("-"))
+            counts.kebab++;
+        else if (name.includes("_"))
+            counts.snake++;
+    }
+    const total = names.length;
+    if (total === 0)
+        return "mixed";
+    const threshold = 0.5;
+    if (counts.kebab / total >= threshold)
+        return "kebab-case";
+    if (counts.camel / total >= threshold)
+        return "camelCase";
+    if (counts.snake / total >= threshold)
+        return "snake_case";
+    if (counts.pascal / total >= threshold)
+        return "PascalCase";
+    return "mixed";
+}
+function buildTree(files, maxLines = 60) {
+    // Build a nested structure from paths
+    const tree = {};
+    for (const file of files) {
+        const parts = file.split("/");
+        let node = tree;
+        for (const part of parts) {
+            if (!(part in node)) {
+                node[part] = {};
+            }
+            node = node[part];
+        }
+    }
+    const lines = ["."];
+    function renderNode(node, prefix, depth) {
+        if (depth > 3)
+            return;
+        if (lines.length >= maxLines)
+            return;
+        const entries = Object.entries(node);
+        entries.sort(([a], [b]) => a.localeCompare(b));
+        for (let i = 0; i < entries.length; i++) {
+            if (lines.length >= maxLines)
+                return;
+            const [key, child] = entries[i];
+            const isLast = i === entries.length - 1;
+            const connector = isLast ? "└── " : "├── ";
+            const childPrefix = isLast ? "    " : "│   ";
+            lines.push(`${prefix}${connector}${key}`);
+            const childNode = child;
+            if (Object.keys(childNode).length > 0) {
+                renderNode(childNode, prefix + childPrefix, depth + 1);
+            }
+        }
+    }
+    renderNode(tree, "", 1);
+    if (lines.length >= maxLines) {
+        lines.push("... (truncated)");
+    }
+    return lines.join("\n");
+}
+export async function scanStructure(projectPath) {
+    try {
+        // List files up to depth 3
+        const files = await fg("**/*", {
+            cwd: projectPath,
+            onlyFiles: true,
+            deep: 3,
+            ignore: IGNORE_PATTERNS,
+            dot: false,
+        });
+        // Total file count (no depth limit, capped at 9999)
+        let totalFileCount;
+        try {
+            const allFiles = await fg("**/*", {
+                cwd: projectPath,
+                onlyFiles: true,
+                ignore: IGNORE_PATTERNS,
+                dot: false,
+            });
+            totalFileCount = Math.min(allFiles.length, 9999);
+        }
+        catch {
+            totalFileCount = Math.min(files.length, 9999);
+        }
+        // Top-level dirs
+        const topLevelDirSet = new Set();
+        for (const file of files) {
+            const firstSegment = file.split("/")[0];
+            if (firstSegment && firstSegment !== file) {
+                topLevelDirSet.add(firstSegment);
+            }
+        }
+        const topLevelDirs = Array.from(topLevelDirSet).sort();
+        // Entry points
+        const entryPoints = files.filter((f) => ENTRY_POINT_PATTERNS.some((pattern) => pattern.test(f)));
+        // Test dirs
+        const testDirSet = new Set();
+        for (const file of files) {
+            const parts = file.split("/");
+            for (let i = 0; i < parts.length - 1; i++) {
+                const dir = parts[i];
+                if (dir.toLowerCase().includes("test") ||
+                    dir.toLowerCase().includes("spec") ||
+                    dir === "__tests__") {
+                    testDirSet.add(parts.slice(0, i + 1).join("/"));
+                }
+            }
+        }
+        const testDirs = Array.from(testDirSet).sort();
+        // Naming convention: sample first 20 filenames without extension
+        const sampleNames = files
+            .slice(0, 20)
+            .map((f) => path.basename(f, path.extname(f)));
+        const namingConvention = detectNamingConvention(sampleNames);
+        // Tree
+        const tree = buildTree(files);
+        return {
+            topLevelDirs,
+            entryPoints,
+            testDirs,
+            totalFileCount,
+            namingConvention,
+            tree,
+        };
+    }
+    catch {
+        return {
+            topLevelDirs: [],
+            entryPoints: [],
+            testDirs: [],
+            totalFileCount: 0,
+            namingConvention: "mixed",
+            tree: ".",
+        };
+    }
+}
+//# sourceMappingURL=structure.js.map

package/dist/scanner/structure.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":""}

package/dist/server.js

@@ -0,0 +1,212 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { toMcpError } from "./lib/errors.js";
+import { runInit } from "./tools/init.js";
+import { runSync } from "./tools/sync.js";
+import { runDrift } from "./tools/drift.js";
+import { runExport } from "./tools/export.js";
+import { runValidate } from "./tools/validate.js";
+import { runStatus } from "./tools/status.js";
+const VERSION = "1.0.0";
+const server = new McpServer({
+    name: "agents-sync",
+    version: VERSION,
+});
+// ─── agents_sync_init ────────────────────────────────────────────────────────
+server.tool("agents_sync_init", "Analyze a codebase and generate AGENTS.md + all tool-specific context files (CLAUDE.md, .cursorrules, copilot-instructions.md, GEMINI.md, .windsurfrules, .clinerules). Run this once per project.", {
+    projectPath: z.string().describe("Absolute path to the project root directory"),
+    tools: z
+        .array(z.enum(["claude", "cursor", "copilot", "gemini", "windsurf", "cline"]))
+        .optional()
+        .describe("Which tool files to generate. Default: all six."),
+    dryRun: z
+        .boolean()
+        .optional()
+        .describe("Preview what would be generated without writing any files."),
+}, async ({ projectPath, tools, dryRun }) => {
+    try {
+        const result = await runInit({ projectPath, tools, dryRun });
+        const lines = [];
+        if (result.dryRun) {
+            lines.push("DRY RUN — no files written\n");
+            lines.push(`→ Would write: ${result.agentsMdPath}`);
+            for (const f of result.filesWritten) {
+                lines.push(`→ Would write: ${f.path}`);
+            }
+        }
+        else {
+            lines.push(`✓ AGENTS.md → ${result.agentsMdPath}`);
+            for (const f of result.filesWritten) {
+                lines.push(`✓ ${f.tool} → ${f.path}`);
+            }
+        }
+        if (result.customSectionsPreserved > 0) {
+            lines.push(`\n  ${result.customSectionsPreserved} custom section(s) preserved from existing files`);
+        }
+        if (result.warnings.length > 0) {
+            lines.push("\nWarnings:");
+            for (const w of result.warnings)
+                lines.push(`  ⚠ ${w}`);
+        }
+        if (!result.dryRun) {
+            lines.push("\n✓ Snapshot saved to .agents-sync/");
+            lines.push("  → Add AGENTS.md to git. Add .agents-sync/ to .gitignore.");
+        }
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${toMcpError(e)}` }], isError: true };
+    }
+});
+// ─── agents_sync_sync ────────────────────────────────────────────────────────
+server.tool("agents_sync_sync", "Re-analyze the codebase and update all tool context files from current state. Preserves manual custom sections.", {
+    projectPath: z.string().describe("Absolute path to the project root directory"),
+    tools: z
+        .array(z.enum(["claude", "cursor", "copilot", "gemini", "windsurf", "cline"]))
+        .optional()
+        .describe("Which tool files to update. Default: all."),
+    fast: z
+        .boolean()
+        .optional()
+        .describe("Skip re-extraction if only minor drift detected. No Claude API call."),
+    dryRun: z.boolean().optional().describe("Preview changes without writing."),
+}, async ({ projectPath, tools, fast, dryRun }) => {
+    try {
+        const result = await runSync({ projectPath, tools, fast, dryRun });
+        const lines = [];
+        if (result.dryRun)
+            lines.push("DRY RUN — no files written\n");
+        if (result.skippedExtraction)
+            lines.push("⚡ Fast mode: skipped re-extraction\n");
+        for (const f of result.filesUpdated) {
+            lines.push(result.dryRun ? `→ Would write: ${f.path}` : `✓ ${f.tool} → ${f.path}`);
+        }
+        if (result.customSectionsPreserved > 0) {
+            lines.push(`\n  ${result.customSectionsPreserved} custom section(s) preserved`);
+        }
+        if (result.warnings.length > 0) {
+            lines.push("\nWarnings:");
+            for (const w of result.warnings)
+                lines.push(`  ⚠ ${w}`);
+        }
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${toMcpError(e)}` }], isError: true };
+    }
+});
+// ─── agents_sync_drift ───────────────────────────────────────────────────────
+server.tool("agents_sync_drift", "Check what has changed in the codebase since the last sync. Read-only — makes no changes.", {
+    projectPath: z.string().describe("Absolute path to the project root directory"),
+}, async ({ projectPath }) => {
+    try {
+        const result = await runDrift({ projectPath });
+        if (!result.hasSnapshot) {
+            return {
+                content: [{
+                        type: "text",
+                        text: "No snapshot found. Run /agents-sync init first to start tracking drift.",
+                    }],
+            };
+        }
+        return { content: [{ type: "text", text: result.report ?? "No report available." }] };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${toMcpError(e)}` }], isError: true };
+    }
+});
+// ─── agents_sync_export ──────────────────────────────────────────────────────
+server.tool("agents_sync_export", "Regenerate a single tool file from the existing AGENTS.md without re-running analysis.", {
+    projectPath: z.string().describe("Absolute path to the project root directory"),
+    tool: z
+        .enum(["claude", "cursor", "copilot", "gemini", "windsurf", "cline"])
+        .describe("Which tool file to regenerate"),
+}, async ({ projectPath, tool }) => {
+    try {
+        const result = await runExport({ projectPath, tool });
+        if (result.error) {
+            return { content: [{ type: "text", text: `Error: ${result.error}` }], isError: true };
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: `✓ ${result.tool} → ${result.path}`,
+                }],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${toMcpError(e)}` }], isError: true };
+    }
+});
+// ─── agents_sync_validate ────────────────────────────────────────────────────
+server.tool("agents_sync_validate", "Check whether all tool files are in sync with the canonical AGENTS.md.", {
+    projectPath: z.string().describe("Absolute path to the project root directory"),
+}, async ({ projectPath }) => {
+    try {
+        const result = await runValidate({ projectPath });
+        const lines = [];
+        const canonicalStatus = result.canonical.exists ? "✓" : "✗ MISSING";
+        lines.push(`AGENTS.md (canonical)  ${canonicalStatus}`);
+        lines.push("");
+        for (const f of result.toolFiles) {
+            const icon = f.status === "in-sync" ? "✓" : f.status === "missing" ? "✗" : "⚠";
+            const label = f.status === "in-sync" ? "in sync" : f.status === "missing" ? "MISSING" : "DRIFTED";
+            lines.push(`${icon} ${f.tool.padEnd(10)} ${label}  ${f.path}`);
+            if (f.details)
+                lines.push(`           ${f.details}`);
+        }
+        lines.push("");
+        if (result.allInSync) {
+            lines.push("✓ All files are in sync.");
+        }
+        else {
+            lines.push("Some files are out of sync. Run /agents-sync sync to fix.");
+        }
+        if (!result.hasSnapshot) {
+            lines.push("\nNote: No snapshot found — run /agents-sync init for full tracking.");
+        }
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${toMcpError(e)}` }], isError: true };
+    }
+});
+// ─── agents_sync_status ──────────────────────────────────────────────────────
+server.tool("agents_sync_status", "Show sync status: last sync time, managed files, drift score.", {
+    projectPath: z.string().describe("Absolute path to the project root directory"),
+}, async ({ projectPath }) => {
+    try {
+        const result = await runStatus({ projectPath });
+        const lines = ["agents-sync status\n"];
+        if (!result.hasSnapshot) {
+            lines.push("Not initialized.");
+            lines.push(`\n→ ${result.recommendation}`);
+        }
+        else {
+            lines.push(`Last synced:  ${result.lastSyncedAt ?? "unknown"} (${result.daysSinceSync} day${result.daysSinceSync === 1 ? "" : "s"} ago)`);
+            lines.push(`Language:     ${result.language ?? "unknown"}${result.framework ? ` / ${result.framework}` : ""}`);
+            lines.push(`Drift score:  ${result.driftScore}`);
+            lines.push(`\nManaged files (${result.filesManaged.length}):`);
+            for (const f of result.filesManaged) {
+                lines.push(`  ${f.tool.padEnd(12)} ${f.path}`);
+            }
+            lines.push(`\n→ ${result.recommendation}`);
+        }
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${toMcpError(e)}` }], isError: true };
+    }
+});
+// ─── Start ───────────────────────────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write(`agents-sync MCP server v${VERSION} ready\n`);
+}
+main().catch((e) => {
+    process.stderr.write(`Fatal: ${e}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,aAAa;IACnB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,gFAAgF;AAEhF,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,oMAAoM,EACpM;IACE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IAC/E,KAAK,EAAE,CAAC;SACL,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;SAC7E,QAAQ,EAAE;SACV,QAAQ,CAAC,iDAAiD,CAAC;IAC9D,MAAM,EAAE,CAAC;SACN,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,4DAA4D,CAAC;CAC1E,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7D,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;YAC3C,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;YACpD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;gBACpC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;YACnD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;gBACpC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QACD,IAAI,MAAM,CAAC,uBAAuB,GAAG,CAAC,EAAE,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,uBAAuB,kDAAkD,CAAC,CAAC;QACtG,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC1B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ;gBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;QAC3E,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IAC1E,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAClG,CAAC;AACH,CAAC,CACF,CAAC;AAEF,gFAAgF;AAEhF,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,iHAAiH,EACjH;IACE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IAC/E,KAAK,EAAE,CAAC;SACL,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;SAC7E,QAAQ,EAAE;SACV,QAAQ,CAAC,2CAA2C,CAAC;IACxD,IAAI,EAAE,CAAC;SACJ,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,sEAAsE,CAAC;IACnF,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;CAC5E,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE;IAC7C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACnE,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,IAAI,MAAM,CAAC,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC9D,IAAI,MAAM,CAAC,iBAAiB;YAAE,KAAK,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QAEjF,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACrF,CAAC;QAED,IAAI,MAAM,CAAC,uBAAuB,GAAG,CAAC,EAAE,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,uBAAuB,8BAA8B,CAAC,CAAC;QAClF,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC1B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ;gBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IAC1E,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAClG,CAAC;AACH,CAAC,CACF,CAAC;AAEF,gFAAgF;AAEhF,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,2FAA2F,EAC3F;IACE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;CAChF,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;IACxB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;QAE/C,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YACxB,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,yEAAyE;qBAChF,CAAC;aACH,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,IAAI,sBAAsB,EAAE,CAAC,EAAE,CAAC;IACjG,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAClG,CAAC;AACH,CAAC,CACF,CAAC;AAEF,gFAAgF;AAEhF,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,wFAAwF,EACxF;IACE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IAC/E,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;SACpE,QAAQ,CAAC,+BAA+B,CAAC;CAC7C,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,EAAE;IAC9B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QAEtD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACjG,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,KAAK,MAAM,CAAC,IAAI,MAAM,MAAM,CAAC,IAAI,EAAE;iBAC1C,CAAC;SACH,CAAC;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAClG,CAAC;AACH,CAAC,CACF,CAAC;AAEF,gFAAgF;AAEhF,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB,wEAAwE,EACxE;IACE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;CAChF,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;IACxB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;QAClD,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,MAAM,eAAe,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC;QACpE,KAAK,CAAC,IAAI,CAAC,0BAA0B,eAAe,EAAE,CAAC,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YAC/E,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;YAClG,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC/D,IAAI,CAAC,CAAC,OAAO;gBAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACvD,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;QAC1E,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAC;QACrF,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IAC1E,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAClG,CAAC;AACH,CAAC,CACF,CAAC;AAEF,gFAAgF;AAEhF,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,+DAA+D,EAC/D;IACE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;CAChF,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;IACxB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;QAChD,MAAM,KAAK,GAAa,CAAC,sBAAsB,CAAC,CAAC;QAEjD,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,YAAY,IAAI,SAAS,KAAK,MAAM,CAAC,aAAa,OAAO,MAAM,CAAC,aAAa,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC;YAC1I,KAAK,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,QAAQ,IAAI,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/G,KAAK,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;YACjD,KAAK,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,YAAY,CAAC,MAAM,IAAI,CAAC,CAAC;YAC/D,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;gBACpC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACjD,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IAC1E,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAClG,CAAC;AACH,CAAC,CACF,CAAC;AAEF,gFAAgF;AAEhF,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,OAAO,UAAU,CAAC,CAAC;AACrE,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;IACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/snapshot/drift.d.ts

@@ -0,0 +1,22 @@
+import type { Snapshot } from "./schema.js";
+import type { RawCorpus } from "../scanner/index.js";
+export type DriftSeverity = "HIGH" | "MEDIUM" | "LOW";
+export interface DriftSignal {
+    severity: DriftSeverity;
+    message: string;
+    detail?: string;
+}
+export interface DriftReport {
+    hasSnapshot: true;
+    signals: DriftSignal[];
+    daysSinceSync: number;
+    recommendation: string;
+    maxSeverity: DriftSeverity | "NONE";
+}
+export interface NoDrift {
+    hasSnapshot: false;
+}
+export type DriftResult = DriftReport | NoDrift;
+export declare function detectDrift(snapshot: Snapshot, corpus: RawCorpus): DriftReport;
+export declare function formatDriftReport(report: DriftReport): string;
+//# sourceMappingURL=drift.d.ts.map

package/dist/snapshot/drift.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift.d.ts","sourceRoot":"","sources":["../../src/snapshot/drift.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGrD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEtD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,IAAI,CAAC;IAClB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,aAAa,GAAG,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,OAAO;IACtB,WAAW,EAAE,KAAK,CAAC;CACpB;AAED,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,OAAO,CAAC;AAEhD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAG,WAAW,CAiF9E;AASD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CA6B7D"}

package/dist/snapshot/drift.js

@@ -0,0 +1,105 @@
+import { sha256 } from "./writer.js";
+export function detectDrift(snapshot, corpus) {
+    const signals = [];
+    // Manifest hash change
+    const manifestContent = corpus.manifest.dependencies.join("\n") +
+        corpus.manifest.devDependencies.join("\n");
+    const currentManifestHash = sha256(manifestContent);
+    if (currentManifestHash !== snapshot.manifestHash) {
+        const prevCount = snapshot.meta.dependencyCount;
+        const currCount = corpus.manifest.dependencies.length;
+        const diff = currCount - prevCount;
+        if (Math.abs(diff) >= 3) {
+            signals.push({
+                severity: "HIGH",
+                message: `Dependency count changed significantly (${prevCount} → ${currCount})`,
+                detail: diff > 0
+                    ? `${diff} new dependencies added`
+                    : `${Math.abs(diff)} dependencies removed`,
+            });
+        }
+        else if (currentManifestHash !== snapshot.manifestHash) {
+            signals.push({
+                severity: "MEDIUM",
+                message: "Manifest changed (dependencies or scripts updated)",
+            });
+        }
+    }
+    // New top-level dirs
+    const prevDirs = new Set(snapshot.meta.topLevelDirs);
+    const newDirs = corpus.structure.topLevelDirs.filter((d) => !prevDirs.has(d));
+    for (const dir of newDirs) {
+        signals.push({
+            severity: "HIGH",
+            message: `New top-level directory: ${dir}`,
+        });
+    }
+    // Significant file count change
+    const fileDiff = corpus.structure.totalFileCount - snapshot.meta.totalFiles;
+    if (fileDiff > 50) {
+        signals.push({
+            severity: "MEDIUM",
+            message: `${fileDiff} new files added since last sync`,
+        });
+    }
+    // New gotchas found
+    if (corpus.gotchas.length > 3) {
+        signals.push({
+            severity: "LOW",
+            message: `${corpus.gotchas.length} FIXME/HACK/WARNING comments found in codebase`,
+            detail: "Some may be new gotchas worth capturing",
+        });
+    }
+    const daysSinceSync = Math.floor((Date.now() - new Date(snapshot.syncedAt).getTime()) / (1000 * 60 * 60 * 24));
+    if (daysSinceSync > 14) {
+        signals.push({
+            severity: "LOW",
+            message: `Last synced ${daysSinceSync} days ago`,
+            detail: "Regular re-sync keeps AI tools accurate",
+        });
+    }
+    const maxSeverity = computeMaxSeverity(signals);
+    const recommendation = maxSeverity === "HIGH"
+        ? "Re-sync strongly recommended. Run: /agents-sync sync"
+        : maxSeverity === "MEDIUM"
+            ? "Re-sync recommended. Run: /agents-sync sync"
+            : maxSeverity === "LOW"
+                ? "Minor drift detected. Re-sync when convenient."
+                : `Up to date. Last synced ${daysSinceSync} day${daysSinceSync === 1 ? "" : "s"} ago.`;
+    return { hasSnapshot: true, signals, daysSinceSync, recommendation, maxSeverity };
+}
+function computeMaxSeverity(signals) {
+    if (signals.some((s) => s.severity === "HIGH"))
+        return "HIGH";
+    if (signals.some((s) => s.severity === "MEDIUM"))
+        return "MEDIUM";
+    if (signals.some((s) => s.severity === "LOW"))
+        return "LOW";
+    return "NONE";
+}
+export function formatDriftReport(report) {
+    const NO_COLOR = process.env.NO_COLOR === "1";
+    const color = (code, text) => NO_COLOR ? text : `\x1b[${code}m${text}\x1b[0m`;
+    const lines = [];
+    lines.push(color("1", `agents-sync drift report (${new Date().toISOString().slice(0, 10)})`));
+    lines.push(color("2", `Last sync: ${report.daysSinceSync} day${report.daysSinceSync === 1 ? "" : "s"} ago\n`));
+    if (report.signals.length === 0) {
+        lines.push(color("32", "✓  No drift detected — everything is in sync."));
+    }
+    else {
+        for (const s of report.signals) {
+            const badge = s.severity === "HIGH"
+                ? color("31;1", "HIGH  ")
+                : s.severity === "MEDIUM"
+                    ? color("33;1", "MED   ")
+                    : color("34;1", "LOW   ");
+            lines.push(`${badge} ${s.message}`);
+            if (s.detail)
+                lines.push(`       ${color("2", s.detail)}`);
+        }
+    }
+    lines.push("");
+    lines.push(color("1", report.recommendation));
+    return lines.join("\n");
+}
+//# sourceMappingURL=drift.js.map

package/dist/snapshot/drift.js.map

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

package/dist/snapshot/schema.d.ts

@@ -0,0 +1,94 @@
+import { z } from "zod";
+export declare const ManagedFileSchema: z.ZodObject<{
+    path: z.ZodString;
+    sha256: z.ZodString;
+    tool: z.ZodEnum<["agents-md", "claude", "cursor", "copilot", "gemini", "windsurf", "cline"]>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    sha256: string;
+    tool: "claude" | "cursor" | "copilot" | "gemini" | "windsurf" | "cline" | "agents-md";
+}, {
+    path: string;
+    sha256: string;
+    tool: "claude" | "cursor" | "copilot" | "gemini" | "windsurf" | "cline" | "agents-md";
+}>;
+export declare const SnapshotSchema: z.ZodObject<{
+    version: z.ZodLiteral<"1.0">;
+    syncedAt: z.ZodString;
+    projectPath: z.ZodString;
+    codebaseHash: z.ZodString;
+    manifestHash: z.ZodString;
+    filesManaged: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        sha256: z.ZodString;
+        tool: z.ZodEnum<["agents-md", "claude", "cursor", "copilot", "gemini", "windsurf", "cline"]>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        sha256: string;
+        tool: "claude" | "cursor" | "copilot" | "gemini" | "windsurf" | "cline" | "agents-md";
+    }, {
+        path: string;
+        sha256: string;
+        tool: "claude" | "cursor" | "copilot" | "gemini" | "windsurf" | "cline" | "agents-md";
+    }>, "many">;
+    meta: z.ZodObject<{
+        dependencyCount: z.ZodNumber;
+        topLevelDirs: z.ZodArray<z.ZodString, "many">;
+        language: z.ZodString;
+        framework: z.ZodNullable<z.ZodString>;
+        totalFiles: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        language: string;
+        framework: string | null;
+        topLevelDirs: string[];
+        dependencyCount: number;
+        totalFiles: number;
+    }, {
+        language: string;
+        framework: string | null;
+        topLevelDirs: string[];
+        dependencyCount: number;
+        totalFiles: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    version: "1.0";
+    projectPath: string;
+    syncedAt: string;
+    codebaseHash: string;
+    manifestHash: string;
+    filesManaged: {
+        path: string;
+        sha256: string;
+        tool: "claude" | "cursor" | "copilot" | "gemini" | "windsurf" | "cline" | "agents-md";
+    }[];
+    meta: {
+        language: string;
+        framework: string | null;
+        topLevelDirs: string[];
+        dependencyCount: number;
+        totalFiles: number;
+    };
+}, {
+    version: "1.0";
+    projectPath: string;
+    syncedAt: string;
+    codebaseHash: string;
+    manifestHash: string;
+    filesManaged: {
+        path: string;
+        sha256: string;
+        tool: "claude" | "cursor" | "copilot" | "gemini" | "windsurf" | "cline" | "agents-md";
+    }[];
+    meta: {
+        language: string;
+        framework: string | null;
+        topLevelDirs: string[];
+        dependencyCount: number;
+        totalFiles: number;
+    };
+}>;
+export type Snapshot = z.infer<typeof SnapshotSchema>;
+export type ManagedFile = z.infer<typeof ManagedFileSchema>;
+export declare const SNAPSHOT_DIR = ".agents-sync";
+export declare const SNAPSHOT_FILE = "snapshot.json";
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/snapshot/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;EAI5B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAczB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAC3C,eAAO,MAAM,aAAa,kBAAkB,CAAC"}