@googlarz/agents-sync 1.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/extractor/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4ChC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,gBAAgB,QAAQ,CAAC"}

package/dist/extractor/schema.js

@@ -0,0 +1,44 @@
+import { z } from "zod";
+export const ProjectMetadataSchema = z.object({
+    project: z.object({
+        name: z.string().describe("Project name from manifest"),
+        description: z.string().describe("What this project does, 1-2 sentences"),
+        language: z.string().describe("Primary language: typescript, javascript, python, rust, go, etc"),
+        framework: z.string().optional().describe("Primary framework: nextjs, django, express, axum, etc"),
+        version: z.string().optional().describe("Project version from manifest"),
+    }),
+    stack: z.object({
+        runtime: z.string().optional().describe("Runtime and version: node 20, python 3.11, etc"),
+        database: z.string().optional().describe("Database + ORM: postgres via prisma, sqlite via drizzle, etc"),
+        auth: z.string().optional().describe("Auth solution: next-auth, jwt, supabase auth, etc"),
+        testing: z.string().optional().describe("Test framework and runner: vitest, pytest, cargo test, etc"),
+        deploy: z.string().optional().describe("Deployment target: vercel, railway, fly.io, docker, etc"),
+        other: z.array(z.string()).describe("Other notable stack items: redis, stripe, openai, etc"),
+    }),
+    architecture: z.object({
+        style: z.string().optional().describe("feature-first, layered, monorepo, flat, etc"),
+        keyDirs: z.record(z.string()).describe("Map of important dirs to their purpose: { 'src/features': 'domain modules' }"),
+        entryPoints: z.array(z.string()).describe("Main entry point files relative to project root"),
+    }),
+    conventions: z.array(z.string()).describe("Specific coding conventions Claude must follow. Be concrete: 'kebab-case filenames', 'named exports only', 'zod for all external input'. No generic advice."),
+    gotchas: z.array(z.string()).describe("Things that will break if ignored. Include consequence: 'Do not import PrismaClient directly — causes connection pool exhaustion. Use lib/db.ts singleton instead.'"),
+    boundaries: z.object({
+        alwaysDo: z.array(z.string()).describe("Things AI must always do"),
+        askFirst: z.array(z.string()).describe("Things requiring human approval before doing"),
+        never: z.array(z.string()).describe("Hard constraints — never violate these"),
+    }),
+    testing: z.object({
+        framework: z.string().optional().describe("Test framework name"),
+        command: z.string().optional().describe("Exact command to run tests: npm test, pytest, cargo test"),
+        location: z.string().optional().describe("Where tests live: colocated, tests/, __tests__/"),
+        coverageCommand: z.string().optional().describe("Command to run with coverage"),
+    }),
+    deployment: z.object({
+        target: z.string().optional().describe("Where it deploys: vercel, fly.io, etc"),
+        command: z.string().optional().describe("Deploy command if any"),
+        envFile: z.string().optional().describe(".env file name if non-standard"),
+        notes: z.array(z.string()).describe("Important deployment notes"),
+    }),
+});
+export const METADATA_VERSION = "1.0";
+//# sourceMappingURL=schema.js.map

package/dist/extractor/schema.js.map

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

package/dist/generator/agents-md.d.ts

@@ -0,0 +1,3 @@
+import type { ProjectMetadata } from "../extractor/schema.js";
+export declare function generateAgentsMd(metadata: ProjectMetadata): Promise<string>;
+//# sourceMappingURL=agents-md.d.ts.map

package/dist/generator/agents-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-md.d.ts","sourceRoot":"","sources":["../../src/generator/agents-md.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAuD9D,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBjF"}

package/dist/generator/agents-md.js

@@ -0,0 +1,127 @@
+import { callClaude } from "../lib/claude-client.js";
+import { AgentsSyncError } from "../lib/errors.js";
+const SYSTEM_PROMPT = `You are writing an AGENTS.md file — the canonical AI context file for a software project.
+
+This file will be read by AI coding assistants (Claude, Cursor, Copilot, Codex) to understand the project.
+A session starting with ONLY this file must be able to:
+1. Identify the correct directory for a new feature
+2. Know the naming convention for new files
+3. Know the exact test command to run
+4. Avoid the project's top gotchas
+
+Quality rules:
+- Every convention must be SPECIFIC: "kebab-case filenames" not "follow conventions"
+- Every gotcha must include CONSEQUENCE: "Do not import PrismaClient directly — causes pool exhaustion"
+- Architecture section must name REAL directories (from the data provided)
+- No section may be generic advice that applies to any project
+- No empty sections — omit a section entirely if you have no real data for it
+- Length: 400–900 words
+
+Format the output as valid markdown starting with "# AGENTS.md".`;
+const TEMPLATE = `# AGENTS.md
+
+<!-- Generated by agents-sync v1.0.0 on {DATE} -->
+<!-- Edit this file, then run /agents-sync sync to propagate changes to all tool files -->
+
+## Project Overview
+{OVERVIEW}
+
+## Tech Stack
+{STACK}
+
+## Architecture
+{ARCHITECTURE}
+
+## Conventions
+{CONVENTIONS}
+
+## Gotchas
+{GOTCHAS}
+
+## Testing
+{TESTING}
+
+## Boundaries
+
+### Always
+{ALWAYS}
+
+### Ask First
+{ASK_FIRST}
+
+### Never
+{NEVER}`;
+export async function generateAgentsMd(metadata) {
+    const userPrompt = buildPrompt(metadata);
+    const { content } = await callClaude(SYSTEM_PROMPT, userPrompt, 2048);
+    // Ensure it starts with the header
+    if (!content.trim().startsWith("# AGENTS.md") && !content.trim().startsWith("# agents-sync")) {
+        throw new AgentsSyncError("GENERATION_FAILED", "Generated output did not produce a valid AGENTS.md header.", "Run with AGENTS_SYNC_DEBUG=1 to inspect output.");
+    }
+    // Inject generated timestamp if Claude didn't include a comment
+    const dated = content.includes("Generated by agents-sync")
+        ? content
+        : content.replace("# AGENTS.md", `# AGENTS.md\n\n<!-- Generated by agents-sync v1.0.0 on ${new Date().toISOString().slice(0, 10)} -->\n<!-- Edit this file, then run /agents-sync sync to propagate changes to all tool files -->`);
+    return dated.trim();
+}
+function buildPrompt(m) {
+    const lines = ["Here is the extracted project metadata. Generate the AGENTS.md:\n"];
+    lines.push(`PROJECT: ${m.project.name} — ${m.project.description}`);
+    lines.push(`Language: ${m.project.language}${m.project.framework ? `, Framework: ${m.project.framework}` : ""}${m.project.version ? `, v${m.project.version}` : ""}`);
+    lines.push("\nSTACK:");
+    if (m.stack.runtime)
+        lines.push(`  Runtime: ${m.stack.runtime}`);
+    if (m.stack.database)
+        lines.push(`  Database: ${m.stack.database}`);
+    if (m.stack.auth)
+        lines.push(`  Auth: ${m.stack.auth}`);
+    if (m.stack.testing)
+        lines.push(`  Testing: ${m.stack.testing}`);
+    if (m.stack.deploy)
+        lines.push(`  Deploy: ${m.stack.deploy}`);
+    if (m.stack.other.length > 0)
+        lines.push(`  Other: ${m.stack.other.join(", ")}`);
+    lines.push("\nARCHITECTURE:");
+    if (m.architecture.style)
+        lines.push(`  Style: ${m.architecture.style}`);
+    lines.push(`  Entry points: ${m.architecture.entryPoints.join(", ") || "unknown"}`);
+    for (const [dir, desc] of Object.entries(m.architecture.keyDirs)) {
+        lines.push(`  ${dir}: ${desc}`);
+    }
+    if (m.conventions.length > 0) {
+        lines.push("\nCONVENTIONS:");
+        m.conventions.forEach((c, i) => lines.push(`  ${i + 1}. ${c}`));
+    }
+    if (m.gotchas.length > 0) {
+        lines.push("\nGOTCHAS:");
+        m.gotchas.forEach((g, i) => lines.push(`  ${i + 1}. ${g}`));
+    }
+    lines.push("\nBOUNDARIES:");
+    if (m.boundaries.alwaysDo.length > 0)
+        lines.push(`  Always: ${m.boundaries.alwaysDo.join("; ")}`);
+    if (m.boundaries.askFirst.length > 0)
+        lines.push(`  Ask first: ${m.boundaries.askFirst.join("; ")}`);
+    if (m.boundaries.never.length > 0)
+        lines.push(`  Never: ${m.boundaries.never.join("; ")}`);
+    lines.push("\nTESTING:");
+    if (m.testing.framework)
+        lines.push(`  Framework: ${m.testing.framework}`);
+    if (m.testing.command)
+        lines.push(`  Command: ${m.testing.command}`);
+    if (m.testing.location)
+        lines.push(`  Location: ${m.testing.location}`);
+    if (m.testing.coverageCommand)
+        lines.push(`  Coverage: ${m.testing.coverageCommand}`);
+    if (m.deployment.target || m.deployment.notes.length > 0) {
+        lines.push("\nDEPLOYMENT:");
+        if (m.deployment.target)
+            lines.push(`  Target: ${m.deployment.target}`);
+        if (m.deployment.command)
+            lines.push(`  Command: ${m.deployment.command}`);
+        m.deployment.notes.forEach((n) => lines.push(`  Note: ${n}`));
+    }
+    lines.push(`\nUse this template structure:\n${TEMPLATE.replace("{DATE}", new Date().toISOString().slice(0, 10))}`);
+    lines.push("\nGenerate the complete AGENTS.md now:");
+    return lines.join("\n");
+}
+//# sourceMappingURL=agents-md.js.map

package/dist/generator/agents-md.js.map

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

package/dist/generator/validator.d.ts

@@ -0,0 +1,7 @@
+export interface ValidationResult {
+    passed: boolean;
+    failures: string[];
+    warnings: string[];
+}
+export declare function validateAgentsMd(content: string, knownDirs?: string[]): ValidationResult;
+//# sourceMappingURL=validator.d.ts.map

package/dist/generator/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/generator/validator.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAMD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,EAAO,GAAG,gBAAgB,CAsE5F"}

package/dist/generator/validator.js

@@ -0,0 +1,67 @@
+const MIN_CONVENTIONS = 2;
+const MIN_WORDS = 300;
+const MAX_WORDS = 1200;
+export function validateAgentsMd(content, knownDirs = []) {
+    const failures = [];
+    const warnings = [];
+    // Must have the header
+    if (!content.includes("# AGENTS.md")) {
+        failures.push("Missing '# AGENTS.md' header");
+    }
+    // Word count
+    const words = content.split(/\s+/).filter(Boolean).length;
+    if (words < MIN_WORDS) {
+        failures.push(`Too short: ${words} words (minimum ${MIN_WORDS}). Output is too generic.`);
+    }
+    if (words > MAX_WORDS) {
+        warnings.push(`Long: ${words} words. Consider trimming for readability.`);
+    }
+    // Must have conventions section with specific rules
+    const conventionsMatch = content.match(/## Conventions\n([\s\S]*?)(?=\n## |\n# |$)/);
+    if (!conventionsMatch) {
+        failures.push("Missing '## Conventions' section");
+    }
+    else {
+        const convText = conventionsMatch[1];
+        const bulletCount = (convText.match(/^[-*\d]/gm) ?? []).length;
+        if (bulletCount < MIN_CONVENTIONS) {
+            failures.push(`Conventions section has ${bulletCount} items (minimum ${MIN_CONVENTIONS})`);
+        }
+        // Detect generic advice
+        const genericPhrases = ["best practices", "follow conventions", "write clean code", "use good names"];
+        for (const phrase of genericPhrases) {
+            if (convText.toLowerCase().includes(phrase)) {
+                warnings.push(`Generic phrase detected in Conventions: "${phrase}" — should be specific`);
+            }
+        }
+    }
+    // Must have boundaries section
+    if (!content.includes("### Never")) {
+        failures.push("Missing '### Never' section under Boundaries");
+    }
+    // Architecture dirs should reference real directories
+    if (knownDirs.length > 0) {
+        const archMatch = content.match(/## Architecture\n([\s\S]*?)(?=\n## |\n# |$)/);
+        if (archMatch) {
+            const archText = archMatch[1];
+            const referencedDirs = archText.match(/`([^`]+)`|`([^`]+)`|\b(src\/\w+|tests?\/|\w+\/)/g) ?? [];
+            const hasRealDir = referencedDirs.some((d) => knownDirs.some((kd) => d.includes(kd.split("/")[0])));
+            if (!hasRealDir && knownDirs.length > 2) {
+                warnings.push("Architecture section may not reference actual project directories");
+            }
+        }
+    }
+    // Testing section should have a command
+    if (content.includes("## Testing")) {
+        const testMatch = content.match(/## Testing\n([\s\S]*?)(?=\n## |\n# |$)/);
+        if (testMatch && !testMatch[1].match(/`[^`]+`/)) {
+            warnings.push("Testing section has no code-formatted command (e.g. `npm test`)");
+        }
+    }
+    return {
+        passed: failures.length === 0,
+        failures,
+        warnings,
+    };
+}
+//# sourceMappingURL=validator.js.map

package/dist/generator/validator.js.map

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

package/dist/lib/claude-client.d.ts

@@ -0,0 +1,11 @@
+export interface ClaudeResponse {
+    content: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        cacheWriteTokens: number;
+    };
+}
+export declare function callClaude(systemPrompt: string, userPrompt: string, maxTokens?: number): Promise<ClaudeResponse>;
+//# sourceMappingURL=claude-client.d.ts.map

package/dist/lib/claude-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-client.d.ts","sourceRoot":"","sources":["../../src/lib/claude-client.ts"],"names":[],"mappings":"AA8BA,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC;CACzG;AAED,wBAAsB,UAAU,CAC9B,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,SAAS,SAAO,GACf,OAAO,CAAC,cAAc,CAAC,CA+DzB"}

package/dist/lib/claude-client.js

@@ -0,0 +1,74 @@
+import Anthropic from "@anthropic-ai/sdk";
+import { AgentsSyncError } from "./errors.js";
+const MODEL = "claude-sonnet-4-6";
+const MAX_RETRIES = 3;
+const RETRY_DELAY_MS = 2000;
+let _client = null;
+function getClient() {
+    if (!_client) {
+        const apiKey = process.env.ANTHROPIC_API_KEY;
+        if (!apiKey) {
+            throw new AgentsSyncError("MISSING_API_KEY", "ANTHROPIC_API_KEY environment variable is not set.", "Export it: export ANTHROPIC_API_KEY=sk-ant-...");
+        }
+        _client = new Anthropic({ apiKey });
+    }
+    return _client;
+}
+function debug(msg) {
+    if (process.env.AGENTS_SYNC_DEBUG === "1") {
+        process.stderr.write(`[agents-sync:debug] ${msg}\n`);
+    }
+}
+export async function callClaude(systemPrompt, userPrompt, maxTokens = 4096) {
+    const client = getClient();
+    for (let attempt = 1; attempt <= MAX_RETRIES; attempt++) {
+        try {
+            debug(`Claude call attempt ${attempt}, maxTokens=${maxTokens}`);
+            const response = await client.messages.create({
+                model: MODEL,
+                max_tokens: maxTokens,
+                system: [
+                    {
+                        type: "text",
+                        text: systemPrompt,
+                        cache_control: { type: "ephemeral" },
+                    },
+                ],
+                messages: [{ role: "user", content: userPrompt }],
+            });
+            const content = response.content
+                .filter((b) => b.type === "text")
+                .map((b) => b.text)
+                .join("");
+            const usage = {
+                inputTokens: response.usage.input_tokens,
+                outputTokens: response.usage.output_tokens,
+                cacheReadTokens: response.usage.cache_read_input_tokens ?? 0,
+                cacheWriteTokens: response.usage.cache_creation_input_tokens ?? 0,
+            };
+            debug(`Response: ${usage.outputTokens} out, ${usage.cacheReadTokens} cache_read, ${usage.cacheWriteTokens} cache_write`);
+            return { content, usage };
+        }
+        catch (e) {
+            const err = e;
+            if (err.status === 429 && attempt < MAX_RETRIES) {
+                debug(`Rate limited, retrying in ${RETRY_DELAY_MS * attempt}ms...`);
+                await sleep(RETRY_DELAY_MS * attempt);
+                continue;
+            }
+            if (err.status === 529 && attempt < MAX_RETRIES) {
+                debug(`Overloaded, retrying in ${RETRY_DELAY_MS}ms...`);
+                await sleep(RETRY_DELAY_MS);
+                continue;
+            }
+            throw new AgentsSyncError(err.status === 429 ? "RATE_LIMIT" : "API_ERROR", `Claude API error: ${err.message ?? String(e)}`, err.status === 429
+                ? "Rate limited. Try again in ~60 seconds. Use --fast flag to skip re-extraction."
+                : "Run with AGENTS_SYNC_DEBUG=1 to see full error.");
+        }
+    }
+    throw new AgentsSyncError("RATE_LIMIT", "Rate limited after 3 retries.", "Wait ~60 seconds and try again.");
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=claude-client.js.map

package/dist/lib/claude-client.js.map

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

package/dist/lib/errors.d.ts

@@ -0,0 +1,10 @@
+export type ErrorCode = "MISSING_API_KEY" | "INVALID_PROJECT_PATH" | "NO_SNAPSHOT" | "RATE_LIMIT" | "API_ERROR" | "EXTRACTION_FAILED" | "GENERATION_FAILED" | "WRITE_ERROR" | "PARSE_ERROR" | "TIMEOUT";
+export declare class AgentsSyncError extends Error {
+    readonly code: ErrorCode;
+    readonly hint?: string | undefined;
+    constructor(code: ErrorCode, message: string, hint?: string | undefined);
+    format(): string;
+}
+export declare function isAgentsSyncError(e: unknown): e is AgentsSyncError;
+export declare function toMcpError(e: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,iBAAiB,GACjB,sBAAsB,GACtB,aAAa,GACb,YAAY,GACZ,WAAW,GACX,mBAAmB,GACnB,mBAAmB,GACnB,aAAa,GACb,aAAa,GACb,SAAS,CAAC;AAEd,qBAAa,eAAgB,SAAQ,KAAK;aAEtB,IAAI,EAAE,SAAS;aAEf,IAAI,CAAC,EAAE,MAAM;gBAFb,IAAI,EAAE,SAAS,EAC/B,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA;IAM/B,MAAM,IAAI,MAAM;CAKjB;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,eAAe,CAElE;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAI7C"}

package/dist/lib/errors.js

@@ -0,0 +1,27 @@
+export class AgentsSyncError extends Error {
+    code;
+    hint;
+    constructor(code, message, hint) {
+        super(message);
+        this.code = code;
+        this.hint = hint;
+        this.name = "AgentsSyncError";
+    }
+    format() {
+        const lines = [`[${this.code}] ${this.message}`];
+        if (this.hint)
+            lines.push(`  → ${this.hint}`);
+        return lines.join("\n");
+    }
+}
+export function isAgentsSyncError(e) {
+    return e instanceof AgentsSyncError;
+}
+export function toMcpError(e) {
+    if (e instanceof AgentsSyncError)
+        return e.format();
+    if (e instanceof Error)
+        return e.message;
+    return String(e);
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAEtB;IAEA;IAHlB,YACkB,IAAe,EAC/B,OAAe,EACC,IAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAW;QAEf,SAAI,GAAJ,IAAI,CAAS;QAG7B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;IAED,MAAM;QACJ,MAAM,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACjD,IAAI,IAAI,CAAC,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,UAAU,iBAAiB,CAAC,CAAU;IAC1C,OAAO,CAAC,YAAY,eAAe,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,CAAU;IACnC,IAAI,CAAC,YAAY,eAAe;QAAE,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC;IACpD,IAAI,CAAC,YAAY,KAAK;QAAE,OAAO,CAAC,CAAC,OAAO,CAAC;IACzC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC"}

package/dist/lib/file-utils.d.ts

@@ -0,0 +1,7 @@
+export declare function readFileSafe(filePath: string): Promise<string | null>;
+export declare function writeFileAtomic(filePath: string, content: string): Promise<void>;
+export declare function dirExists(p: string): Promise<boolean>;
+export declare function fileExists(p: string): Promise<boolean>;
+export declare function assertAbsolutePath(p: string): void;
+export declare function assertProjectDir(p: string): Promise<void>;
+//# sourceMappingURL=file-utils.d.ts.map

package/dist/lib/file-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-utils.d.ts","sourceRoot":"","sources":["../../src/lib/file-utils.ts"],"names":[],"mappings":"AAIA,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAM3E;AAED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CActF;AAED,wBAAsB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO3D;AAED,wBAAsB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO5D;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAQlD;AAED,wBAAsB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS/D"}

package/dist/lib/file-utils.js

@@ -0,0 +1,56 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { AgentsSyncError } from "./errors.js";
+export async function readFileSafe(filePath) {
+    try {
+        return await fs.readFile(filePath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+export async function writeFileAtomic(filePath, content) {
+    const tmp = filePath + ".agents-sync.tmp";
+    try {
+        await fs.mkdir(path.dirname(filePath), { recursive: true });
+        await fs.writeFile(tmp, content, "utf-8");
+        await fs.rename(tmp, filePath);
+    }
+    catch (e) {
+        try {
+            await fs.unlink(tmp);
+        }
+        catch { /* ignore */ }
+        throw new AgentsSyncError("WRITE_ERROR", `Cannot write to ${filePath}: ${e.message}`, "Check file permissions and disk space.");
+    }
+}
+export async function dirExists(p) {
+    try {
+        const stat = await fs.stat(p);
+        return stat.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+export async function fileExists(p) {
+    try {
+        await fs.stat(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function assertAbsolutePath(p) {
+    if (!path.isAbsolute(p)) {
+        throw new AgentsSyncError("INVALID_PROJECT_PATH", `Path must be absolute: ${p}`, "Pass the full path, e.g. /Users/you/my-project");
+    }
+}
+export async function assertProjectDir(p) {
+    assertAbsolutePath(p);
+    if (!(await dirExists(p))) {
+        throw new AgentsSyncError("INVALID_PROJECT_PATH", `Project path not found: ${p}`, "Make sure the directory exists and the path is correct.");
+    }
+}
+//# sourceMappingURL=file-utils.js.map

package/dist/lib/file-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-utils.js","sourceRoot":"","sources":["../../src/lib/file-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB,EAAE,OAAe;IACrE,MAAM,GAAG,GAAG,QAAQ,GAAG,kBAAkB,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC1C,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC;YAAC,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QACpD,MAAM,IAAI,eAAe,CACvB,aAAa,EACb,mBAAmB,QAAQ,KAAM,CAAW,CAAC,OAAO,EAAE,EACtD,wCAAwC,CACzC,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,CAAS;IACvC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,CAAS;IACxC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,CAAS;IAC1C,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,eAAe,CACvB,sBAAsB,EACtB,0BAA0B,CAAC,EAAE,EAC7B,gDAAgD,CACjD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,CAAS;IAC9C,kBAAkB,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,CAAC,CAAC,MAAM,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,eAAe,CACvB,sBAAsB,EACtB,2BAA2B,CAAC,EAAE,EAC9B,yDAAyD,CAC1D,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/lib/token-estimate.d.ts

@@ -0,0 +1,7 @@
+/** Rough token estimate: ~4 chars per token for code */
+export declare function estimateTokens(text: string): number;
+export declare function truncateToTokenBudget(text: string, maxTokens: number): {
+    text: string;
+    truncated: boolean;
+};
+//# sourceMappingURL=token-estimate.d.ts.map

package/dist/lib/token-estimate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimate.d.ts","sourceRoot":"","sources":["../../src/lib/token-estimate.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAStC"}

package/dist/lib/token-estimate.js

@@ -0,0 +1,15 @@
+/** Rough token estimate: ~4 chars per token for code */
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+export function truncateToTokenBudget(text, maxTokens) {
+    const estimated = estimateTokens(text);
+    if (estimated <= maxTokens)
+        return { text, truncated: false };
+    const maxChars = maxTokens * 4;
+    return {
+        text: text.slice(0, maxChars) + `\n\n[... truncated at ~${maxTokens} tokens]`,
+        truncated: true,
+    };
+}
+//# sourceMappingURL=token-estimate.js.map

package/dist/lib/token-estimate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimate.js","sourceRoot":"","sources":["../../src/lib/token-estimate.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,IAAY,EACZ,SAAiB;IAEjB,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,SAAS,IAAI,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAE9D,MAAM,QAAQ,GAAG,SAAS,GAAG,CAAC,CAAC;IAC/B,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,0BAA0B,SAAS,UAAU;QAC7E,SAAS,EAAE,IAAI;KAChB,CAAC;AACJ,CAAC"}

package/dist/scanner/codegraph.d.ts

@@ -0,0 +1,13 @@
+export interface CodegraphSummary {
+    available: boolean;
+    communities: CodegraphCommunity[];
+    hubNodes: string[];
+    entryPoints: string[];
+}
+export interface CodegraphCommunity {
+    name: string;
+    files: string[];
+}
+export declare function readCodegraphIndex(projectPath: string): Promise<CodegraphSummary>;
+export declare function formatCodegraphContext(summary: CodegraphSummary): string;
+//# sourceMappingURL=codegraph.d.ts.map

package/dist/scanner/codegraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegraph.d.ts","sourceRoot":"","sources":["../../src/scanner/codegraph.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAcD,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAqCvF;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAuBxE"}

package/dist/scanner/codegraph.js

@@ -0,0 +1,65 @@
+/**
+ * codegraph scanner
+ *
+ * Reads .codegraph/index.json (if present) and returns a lightweight summary
+ * of community clusters + hub nodes that can be injected into the corpus.
+ * This enriches AGENTS.md with evidence-backed architecture notes.
+ *
+ * Gracefully no-ops when .codegraph/ is absent — works without codegraph.
+ */
+import path from "node:path";
+import fs from "node:fs/promises";
+export async function readCodegraphIndex(projectPath) {
+    const candidates = [
+        path.join(projectPath, ".codegraph", "index.json"),
+        path.join(projectPath, ".codegraph", "graph.json"),
+        path.join(projectPath, "codegraph.json"),
+    ];
+    for (const candidate of candidates) {
+        const raw = await fs.readFile(candidate, "utf-8").catch(() => null);
+        if (!raw)
+            continue;
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            continue;
+        }
+        const communities = (parsed.communities ?? []).slice(0, 8).map((c) => ({
+            name: c.label ?? c.name ?? "unnamed",
+            files: (c.files ?? c.nodes?.map((n) => n.file ?? n.path ?? "").filter(Boolean) ?? []).slice(0, 5),
+        }));
+        const hubNodes = (parsed.hubNodes ?? parsed.nodes?.filter((n) => (n.hubScore ?? 0) > 0.5) ?? [])
+            .slice(0, 10)
+            .map((n) => n.file ?? n.path ?? n.name ?? "")
+            .filter(Boolean);
+        const entryPoints = (parsed.entryPoints ?? parsed.nodes?.filter((n) => n.isEntry) ?? [])
+            .slice(0, 8)
+            .map((n) => n.file ?? n.path ?? "")
+            .filter(Boolean);
+        return { available: true, communities, hubNodes, entryPoints };
+    }
+    return { available: false, communities: [], hubNodes: [], entryPoints: [] };
+}
+export function formatCodegraphContext(summary) {
+    if (!summary.available)
+        return "";
+    const lines = ["## Code Graph (from .codegraph/)"];
+    if (summary.communities.length > 0) {
+        lines.push("\n### Architecture clusters");
+        for (const c of summary.communities) {
+            lines.push(`- **${c.name}**: ${c.files.join(", ")}`);
+        }
+    }
+    if (summary.hubNodes.length > 0) {
+        lines.push("\n### High-connectivity files (call hubs)");
+        lines.push(summary.hubNodes.map((n) => `- ${n}`).join("\n"));
+    }
+    if (summary.entryPoints.length > 0) {
+        lines.push("\n### Entry points");
+        lines.push(summary.entryPoints.map((n) => `- ${n}`).join("\n"));
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=codegraph.js.map