@googlarz/agents-sync 1.4.0

package/dist/extractor/extractor.js

@@ -0,0 +1,125 @@
+import { callClaude } from "../lib/claude-client.js";
+import { AgentsSyncError } from "../lib/errors.js";
+import { ProjectMetadataSchema } from "./schema.js";
+import { formatCodegraphContext } from "../scanner/codegraph.js";
+const SYSTEM_PROMPT = `You are a code analyst. Your job is to extract factual information about a software project from the files provided.
+
+Rules:
+- Extract ONLY concrete facts you can observe in the provided files
+- NEVER hallucinate framework names, directories, or conventions you cannot see
+- If you are not certain about a field, omit it entirely
+- Conventions must be specific: "kebab-case filenames" not "follow best practices"
+- Gotchas must include the consequence: "Do X or Y will happen"
+- Return ONLY valid JSON matching the schema — no markdown, no explanation
+
+Schema:
+{
+  "project": { "name", "description", "language", "framework?", "version?" },
+  "stack": { "runtime?", "database?", "auth?", "testing?", "deploy?", "other": [] },
+  "architecture": { "style?", "keyDirs": {}, "entryPoints": [] },
+  "conventions": [],
+  "gotchas": [],
+  "boundaries": { "alwaysDo": [], "askFirst": [], "never": [] },
+  "testing": { "framework?", "command?", "location?", "coverageCommand?" },
+  "deployment": { "target?", "command?", "envFile?", "notes": [] }
+}`;
+export async function extractMetadata(corpus) {
+    const userPrompt = buildPrompt(corpus);
+    for (let attempt = 1; attempt <= 2; attempt++) {
+        const { content } = await callClaude(SYSTEM_PROMPT, userPrompt, 2048);
+        try {
+            const raw = extractJson(content);
+            return ProjectMetadataSchema.parse(raw);
+        }
+        catch {
+            if (attempt === 2) {
+                throw new AgentsSyncError("EXTRACTION_FAILED", "Failed to extract valid project metadata after 2 attempts.", "Run with AGENTS_SYNC_DEBUG=1 to see Claude's raw output.");
+            }
+            // Retry with correction hint appended to next call
+            const retryPrompt = `${userPrompt}\n\nYour previous output was not valid JSON. Output ONLY the JSON object, no other text.`;
+            const { content: retryContent } = await callClaude(SYSTEM_PROMPT, retryPrompt, 2048);
+            try {
+                const raw = extractJson(retryContent);
+                return ProjectMetadataSchema.parse(raw);
+            }
+            catch {
+                throw new AgentsSyncError("EXTRACTION_FAILED", "Failed to extract valid project metadata after 2 attempts.", "Run with AGENTS_SYNC_DEBUG=1 to see Claude's raw output.");
+            }
+        }
+    }
+    // TypeScript requires this but it's unreachable
+    throw new AgentsSyncError("EXTRACTION_FAILED", "Unexpected extraction failure.");
+}
+function extractJson(text) {
+    // Strip markdown code fences if present
+    const stripped = text.replace(/^```(?:json)?\n?/m, "").replace(/\n?```$/m, "").trim();
+    return JSON.parse(stripped);
+}
+function buildPrompt(corpus) {
+    const sections = [];
+    sections.push("=== MANIFEST / DEPENDENCIES ===");
+    sections.push(`Language: ${corpus.manifest.language}`);
+    if (corpus.manifest.framework)
+        sections.push(`Detected framework: ${corpus.manifest.framework}`);
+    if (corpus.manifest.runtime)
+        sections.push(`Runtime: ${corpus.manifest.runtime}`);
+    if (corpus.manifest.projectName)
+        sections.push(`Project name: ${corpus.manifest.projectName}`);
+    sections.push(`Dependencies (${corpus.manifest.dependencies.length}): ${corpus.manifest.dependencies.slice(0, 25).join(", ")}`);
+    if (corpus.manifest.devDependencies.length > 0) {
+        sections.push(`Dev deps: ${corpus.manifest.devDependencies.slice(0, 15).join(", ")}`);
+    }
+    if (Object.keys(corpus.manifest.scripts).length > 0) {
+        sections.push(`Scripts: ${JSON.stringify(corpus.manifest.scripts)}`);
+    }
+    sections.push("\n=== PROJECT STRUCTURE ===");
+    sections.push(`Top-level dirs: ${corpus.structure.topLevelDirs.join(", ")}`);
+    sections.push(`Entry points: ${corpus.structure.entryPoints.join(", ") || "none detected"}`);
+    sections.push(`Test dirs: ${corpus.structure.testDirs.join(", ") || "none detected"}`);
+    sections.push(`Naming convention: ${corpus.structure.namingConvention}`);
+    sections.push(`Total files: ~${corpus.structure.totalFileCount}`);
+    sections.push(`\nDirectory tree:\n${corpus.structure.tree}`);
+    if (corpus.source.files.length > 0) {
+        sections.push("\n=== SAMPLED SOURCE FILES ===");
+        sections.push(`Import style: ${corpus.source.importStyle}`);
+        if (corpus.source.detectedPatterns.length > 0) {
+            sections.push(`Detected patterns: ${corpus.source.detectedPatterns.join(", ")}`);
+        }
+        for (const f of corpus.source.files.slice(0, 10)) {
+            sections.push(`\n--- ${f.path} ---`);
+            sections.push(f.content.slice(0, 800));
+        }
+    }
+    if (corpus.docs.readme) {
+        sections.push("\n=== README ===");
+        sections.push(corpus.docs.readme.slice(0, 1500));
+    }
+    if (corpus.docs.contributing) {
+        sections.push("\n=== CONTRIBUTING ===");
+        sections.push(corpus.docs.contributing.slice(0, 800));
+    }
+    if (corpus.docs.existingAgentsMd) {
+        sections.push("\n=== EXISTING AGENTS.MD (use as baseline) ===");
+        sections.push(corpus.docs.existingAgentsMd);
+    }
+    if (corpus.docs.existingClaudeMd) {
+        sections.push("\n=== EXISTING CLAUDE.MD (extract unique conventions) ===");
+        sections.push(corpus.docs.existingClaudeMd.slice(0, 1000));
+    }
+    if (corpus.gotchas.length > 0) {
+        sections.push("\n=== GOTCHAS FOUND IN SOURCE (TODO/FIXME/HACK comments) ===");
+        for (const g of corpus.gotchas) {
+            sections.push(`${g.type} in ${g.file}:${g.line} — ${g.comment}`);
+        }
+    }
+    if (corpus.codegraph?.available) {
+        const cgContext = formatCodegraphContext(corpus.codegraph);
+        if (cgContext) {
+            sections.push("\n=== CODE GRAPH (structural analysis) ===");
+            sections.push(cgContext);
+        }
+    }
+    sections.push("\nNow extract the project metadata as JSON:");
+    return sections.join("\n");
+}
+//# sourceMappingURL=extractor.js.map

package/dist/extractor/extractor.js.map

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

package/dist/extractor/schema.d.ts

@@ -0,0 +1,187 @@
+import { z } from "zod";
+export declare const ProjectMetadataSchema: z.ZodObject<{
+    project: z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        language: z.ZodString;
+        framework: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        language: string;
+        description: string;
+        version?: string | undefined;
+        framework?: string | undefined;
+    }, {
+        name: string;
+        language: string;
+        description: string;
+        version?: string | undefined;
+        framework?: string | undefined;
+    }>;
+    stack: z.ZodObject<{
+        runtime: z.ZodOptional<z.ZodString>;
+        database: z.ZodOptional<z.ZodString>;
+        auth: z.ZodOptional<z.ZodString>;
+        testing: z.ZodOptional<z.ZodString>;
+        deploy: z.ZodOptional<z.ZodString>;
+        other: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        other: string[];
+        runtime?: string | undefined;
+        database?: string | undefined;
+        auth?: string | undefined;
+        testing?: string | undefined;
+        deploy?: string | undefined;
+    }, {
+        other: string[];
+        runtime?: string | undefined;
+        database?: string | undefined;
+        auth?: string | undefined;
+        testing?: string | undefined;
+        deploy?: string | undefined;
+    }>;
+    architecture: z.ZodObject<{
+        style: z.ZodOptional<z.ZodString>;
+        keyDirs: z.ZodRecord<z.ZodString, z.ZodString>;
+        entryPoints: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        entryPoints: string[];
+        keyDirs: Record<string, string>;
+        style?: string | undefined;
+    }, {
+        entryPoints: string[];
+        keyDirs: Record<string, string>;
+        style?: string | undefined;
+    }>;
+    conventions: z.ZodArray<z.ZodString, "many">;
+    gotchas: z.ZodArray<z.ZodString, "many">;
+    boundaries: z.ZodObject<{
+        alwaysDo: z.ZodArray<z.ZodString, "many">;
+        askFirst: z.ZodArray<z.ZodString, "many">;
+        never: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        never: string[];
+        alwaysDo: string[];
+        askFirst: string[];
+    }, {
+        never: string[];
+        alwaysDo: string[];
+        askFirst: string[];
+    }>;
+    testing: z.ZodObject<{
+        framework: z.ZodOptional<z.ZodString>;
+        command: z.ZodOptional<z.ZodString>;
+        location: z.ZodOptional<z.ZodString>;
+        coverageCommand: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        framework?: string | undefined;
+        command?: string | undefined;
+        location?: string | undefined;
+        coverageCommand?: string | undefined;
+    }, {
+        framework?: string | undefined;
+        command?: string | undefined;
+        location?: string | undefined;
+        coverageCommand?: string | undefined;
+    }>;
+    deployment: z.ZodObject<{
+        target: z.ZodOptional<z.ZodString>;
+        command: z.ZodOptional<z.ZodString>;
+        envFile: z.ZodOptional<z.ZodString>;
+        notes: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        notes: string[];
+        command?: string | undefined;
+        target?: string | undefined;
+        envFile?: string | undefined;
+    }, {
+        notes: string[];
+        command?: string | undefined;
+        target?: string | undefined;
+        envFile?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    architecture: {
+        entryPoints: string[];
+        keyDirs: Record<string, string>;
+        style?: string | undefined;
+    };
+    gotchas: string[];
+    project: {
+        name: string;
+        language: string;
+        description: string;
+        version?: string | undefined;
+        framework?: string | undefined;
+    };
+    stack: {
+        other: string[];
+        runtime?: string | undefined;
+        database?: string | undefined;
+        auth?: string | undefined;
+        testing?: string | undefined;
+        deploy?: string | undefined;
+    };
+    testing: {
+        framework?: string | undefined;
+        command?: string | undefined;
+        location?: string | undefined;
+        coverageCommand?: string | undefined;
+    };
+    conventions: string[];
+    boundaries: {
+        never: string[];
+        alwaysDo: string[];
+        askFirst: string[];
+    };
+    deployment: {
+        notes: string[];
+        command?: string | undefined;
+        target?: string | undefined;
+        envFile?: string | undefined;
+    };
+}, {
+    architecture: {
+        entryPoints: string[];
+        keyDirs: Record<string, string>;
+        style?: string | undefined;
+    };
+    gotchas: string[];
+    project: {
+        name: string;
+        language: string;
+        description: string;
+        version?: string | undefined;
+        framework?: string | undefined;
+    };
+    stack: {
+        other: string[];
+        runtime?: string | undefined;
+        database?: string | undefined;
+        auth?: string | undefined;
+        testing?: string | undefined;
+        deploy?: string | undefined;
+    };
+    testing: {
+        framework?: string | undefined;
+        command?: string | undefined;
+        location?: string | undefined;
+        coverageCommand?: string | undefined;
+    };
+    conventions: string[];
+    boundaries: {
+        never: string[];
+        alwaysDo: string[];
+        askFirst: string[];
+    };
+    deployment: {
+        notes: string[];
+        command?: string | undefined;
+        target?: string | undefined;
+        envFile?: string | undefined;
+    };
+}>;
+export type ProjectMetadata = z.infer<typeof ProjectMetadataSchema>;
+export declare const METADATA_VERSION = "1.0";
+//# sourceMappingURL=schema.d.ts.map

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,6 @@
+import type { ProjectMetadata } from "../extractor/schema.js";
+import type { McpScanResult } from "../scanner/mcp.js";
+/** Appends an MCP Servers section to an already-generated AGENTS.md if servers were found. */
+export declare function appendMcpSection(agentsMd: string, mcp: McpScanResult): string;
+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;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAwDvD,8FAA8F;AAC9F,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,MAAM,CAI7E;AAED,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBjF"}

package/dist/generator/agents-md.js

@@ -0,0 +1,135 @@
+import { callClaude } from "../lib/claude-client.js";
+import { AgentsSyncError } from "../lib/errors.js";
+import { formatMcpSection } from "../scanner/mcp.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}`;
+/** Appends an MCP Servers section to an already-generated AGENTS.md if servers were found. */
+export function appendMcpSection(agentsMd, mcp) {
+    if (!mcp.hasAny)
+        return agentsMd;
+    const section = formatMcpSection(mcp);
+    return `${agentsMd.trimEnd()}\n\n${section}`;
+}
+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"}