@googlarz/agents-sync 1.4.0

package/dist/tools/scan-report.d.ts

@@ -0,0 +1,14 @@
+export interface ScanReportOptions {
+    projectPath: string;
+}
+export interface ScanReportResult {
+    report: string;
+    language: string;
+    framework: string | null;
+    dependencyCount: number;
+    mcpCount: number;
+    skillCount: number;
+    gotchaCount: number;
+}
+export declare function runScanReport(options: ScanReportOptions): Promise<ScanReportResult>;
+//# sourceMappingURL=scan-report.d.ts.map

package/dist/tools/scan-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-report.d.ts","sourceRoot":"","sources":["../../src/tools/scan-report.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAkIzF"}

package/dist/tools/scan-report.js

@@ -0,0 +1,136 @@
+/**
+ * agents-sync scan
+ *
+ * Read-only, no Claude API call. Runs the full scanner and prints what it
+ * found — language, framework, dependencies, structure, MCPs, local skills,
+ * gotchas. Lets developers verify the scanner works before committing to init.
+ */
+import path from "node:path";
+import { assertProjectDir } from "../lib/file-utils.js";
+import { scan } from "../scanner/index.js";
+import { scanProjectSkills } from "../scanner/skills.js";
+export async function runScanReport(options) {
+    const { projectPath } = options;
+    await assertProjectDir(projectPath);
+    const [corpus, skillsSummary] = await Promise.all([
+        scan(projectPath),
+        scanProjectSkills(projectPath),
+    ]);
+    const NO_COLOR = process.env.NO_COLOR === "1";
+    const c = (code, t) => (NO_COLOR ? t : `\x1b[${code}m${t}\x1b[0m`);
+    const lines = [];
+    lines.push(c("1", `agents-sync scan — ${path.basename(projectPath)}\n`));
+    // Project identity
+    lines.push(c("1;34", "▸ Project"));
+    lines.push(`  Language:    ${corpus.manifest.language}`);
+    if (corpus.manifest.framework)
+        lines.push(`  Framework:   ${corpus.manifest.framework}`);
+    if (corpus.manifest.runtime)
+        lines.push(`  Runtime:     ${corpus.manifest.runtime}`);
+    if (corpus.manifest.projectName)
+        lines.push(`  Name:        ${corpus.manifest.projectName}`);
+    if (corpus.manifest.packageManager)
+        lines.push(`  Pkg manager: ${corpus.manifest.packageManager}`);
+    lines.push("");
+    // Dependencies
+    const depCount = corpus.manifest.dependencies.length;
+    const devDepCount = corpus.manifest.devDependencies.length;
+    lines.push(c("1;34", "▸ Dependencies"));
+    lines.push(`  ${depCount} production, ${devDepCount} dev`);
+    if (depCount > 0) {
+        lines.push(`  Notable: ${corpus.manifest.dependencies.slice(0, 8).join(", ")}${depCount > 8 ? ` +${depCount - 8} more` : ""}`);
+    }
+    lines.push("");
+    // Structure
+    lines.push(c("1;34", "▸ Structure"));
+    lines.push(`  Top-level dirs: ${corpus.structure.topLevelDirs.join(", ") || "(none)"}`);
+    lines.push(`  Total files:    ~${corpus.structure.totalFileCount}`);
+    if (corpus.structure.entryPoints.length > 0) {
+        lines.push(`  Entry points:   ${corpus.structure.entryPoints.join(", ")}`);
+    }
+    if (corpus.structure.testDirs.length > 0) {
+        lines.push(`  Test dirs:      ${corpus.structure.testDirs.join(", ")}`);
+    }
+    lines.push("");
+    // Scripts
+    const scripts = Object.entries(corpus.manifest.scripts);
+    if (scripts.length > 0) {
+        lines.push(c("1;34", "▸ Scripts"));
+        for (const [name, cmd] of scripts.slice(0, 6)) {
+            lines.push(`  ${name.padEnd(12)} ${cmd}`);
+        }
+        lines.push("");
+    }
+    // MCPs
+    if (corpus.mcp.hasAny) {
+        lines.push(c("1;34", "▸ MCP Servers (.claude/settings.json)"));
+        for (const s of corpus.mcp.servers) {
+            lines.push(`  ${c("32", "✓")} ${s.name} — ${s.description}`);
+        }
+        lines.push("");
+    }
+    // Local skills / commands
+    if (skillsSummary.hasAny) {
+        lines.push(c("1;34", "▸ Local Skills & Commands"));
+        for (const cmd of skillsSummary.commands) {
+            lines.push(`  ${c("32", "✓")} /${cmd.name} — ${cmd.description}`);
+        }
+        for (const skill of skillsSummary.skills) {
+            lines.push(`  ${c("32", "✓")} ${skill.name} — ${skill.description}`);
+        }
+        lines.push("");
+    }
+    // Gotchas
+    if (corpus.gotchas.length > 0) {
+        lines.push(c("1;34", "▸ Gotchas found in source"));
+        for (const g of corpus.gotchas.slice(0, 5)) {
+            lines.push(`  ${c("33", g.type)} ${g.file}:${g.line} — ${g.comment.slice(0, 70)}`);
+        }
+        if (corpus.gotchas.length > 5) {
+            lines.push(`  ... and ${corpus.gotchas.length - 5} more`);
+        }
+        lines.push("");
+    }
+    // codegraph
+    if (corpus.codegraph.available) {
+        lines.push(c("1;34", "▸ codegraph (.codegraph/)"));
+        lines.push(`  ${corpus.codegraph.communities.length} communities, ${corpus.codegraph.hubNodes.length} hub nodes detected`);
+        lines.push("");
+    }
+    // Existing docs
+    const docs = [];
+    if (corpus.docs.existingAgentsMd)
+        docs.push("AGENTS.md");
+    if (corpus.docs.existingClaudeMd)
+        docs.push("CLAUDE.md");
+    if (corpus.docs.existingCursorRules)
+        docs.push(".cursorrules");
+    if (corpus.docs.readme)
+        docs.push("README.md");
+    if (docs.length > 0) {
+        lines.push(c("1;34", "▸ Existing docs"));
+        lines.push(`  ${docs.join(", ")}`);
+        lines.push("");
+    }
+    lines.push(c("2", `Scanned in ${corpus.scanDurationMs}ms · ~${corpus.totalEstimatedTokens.toLocaleString()} tokens of context`));
+    lines.push("");
+    if (!corpus.docs.existingAgentsMd) {
+        lines.push(c("1", "→ Ready to init. Run:"));
+        lines.push(`  ${c("32", "ANTHROPIC_API_KEY=<key> npx @googlarz/agents-sync init .")}`);
+        lines.push(`  ${c("2", "Get a key: https://console.anthropic.com/")}`);
+    }
+    else {
+        lines.push(c("1", "→ AGENTS.md found. Check drift:"));
+        lines.push(`  ${c("32", "npx @googlarz/agents-sync drift .")}`);
+    }
+    return {
+        report: lines.join("\n"),
+        language: corpus.manifest.language,
+        framework: corpus.manifest.framework,
+        dependencyCount: depCount,
+        mcpCount: corpus.mcp.servers.length,
+        skillCount: skillsSummary.commands.length + skillsSummary.skills.length,
+        gotchaCount: corpus.gotchas.length,
+    };
+}
+//# sourceMappingURL=scan-report.js.map

package/dist/tools/scan-report.js.map

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

package/dist/tools/status.d.ts

@@ -0,0 +1,18 @@
+export interface StatusOptions {
+    projectPath: string;
+}
+export interface StatusResult {
+    hasSnapshot: boolean;
+    lastSyncedAt: string | null;
+    daysSinceSync: number | null;
+    filesManaged: {
+        tool: string;
+        path: string;
+    }[];
+    language: string | null;
+    framework: string | null;
+    driftScore: "unknown" | "stale" | "ok";
+    recommendation: string;
+}
+export declare function runStatus(options: StatusOptions): Promise<StatusResult>;
+//# sourceMappingURL=status.d.ts.map

package/dist/tools/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/tools/status.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,SAAS,GAAG,OAAO,GAAG,IAAI,CAAC;IACvC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CA0C7E"}

package/dist/tools/status.js

@@ -0,0 +1,38 @@
+import { assertProjectDir, fileExists } from "../lib/file-utils.js";
+import { loadSnapshot } from "../snapshot/writer.js";
+import path from "node:path";
+export async function runStatus(options) {
+    await assertProjectDir(options.projectPath);
+    const snapshot = await loadSnapshot(options.projectPath);
+    if (!snapshot) {
+        const agentsMdExists = await fileExists(path.join(options.projectPath, "AGENTS.md"));
+        return {
+            hasSnapshot: false,
+            lastSyncedAt: null,
+            daysSinceSync: null,
+            filesManaged: [],
+            language: null,
+            framework: null,
+            driftScore: "unknown",
+            recommendation: agentsMdExists
+                ? "AGENTS.md found but no snapshot. Run /agents-sync init to create a managed sync."
+                : "Not initialized. Run /agents-sync init to get started.",
+        };
+    }
+    const daysSinceSync = Math.floor((Date.now() - new Date(snapshot.syncedAt).getTime()) / (1000 * 60 * 60 * 24));
+    const driftScore = daysSinceSync > 30 ? "stale" : "ok";
+    const recommendation = driftScore === "stale"
+        ? `Last synced ${daysSinceSync} days ago — run /agents-sync drift to check for changes.`
+        : `Synced ${daysSinceSync} day${daysSinceSync === 1 ? "" : "s"} ago. Run /agents-sync drift to check for changes.`;
+    return {
+        hasSnapshot: true,
+        lastSyncedAt: snapshot.syncedAt,
+        daysSinceSync,
+        filesManaged: snapshot.filesManaged.map((f) => ({ tool: f.tool, path: f.path })),
+        language: snapshot.meta.language,
+        framework: snapshot.meta.framework,
+        driftScore,
+        recommendation,
+    };
+}
+//# sourceMappingURL=status.js.map

package/dist/tools/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/tools/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,IAAI,MAAM,WAAW,CAAC;AAiB7B,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAsB;IACpD,MAAM,gBAAgB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAE5C,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAEzD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,cAAc,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;QACrF,OAAO;YACL,WAAW,EAAE,KAAK;YAClB,YAAY,EAAE,IAAI;YAClB,aAAa,EAAE,IAAI;YACnB,YAAY,EAAE,EAAE;YAChB,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,IAAI;YACf,UAAU,EAAE,SAAS;YACrB,cAAc,EAAE,cAAc;gBAC5B,CAAC,CAAC,kFAAkF;gBACpF,CAAC,CAAC,wDAAwD;SAC7D,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAC9B,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAC7E,CAAC;IAEF,MAAM,UAAU,GAAG,aAAa,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAEvD,MAAM,cAAc,GAClB,UAAU,KAAK,OAAO;QACpB,CAAC,CAAC,eAAe,aAAa,0DAA0D;QACxF,CAAC,CAAC,UAAU,aAAa,OAAO,aAAa,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,oDAAoD,CAAC;IAEvH,OAAO;QACL,WAAW,EAAE,IAAI;QACjB,YAAY,EAAE,QAAQ,CAAC,QAAQ;QAC/B,aAAa;QACb,YAAY,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAChF,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ;QAChC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,SAAS;QAClC,UAAU;QACV,cAAc;KACf,CAAC;AACJ,CAAC"}

package/dist/tools/sync.d.ts

@@ -0,0 +1,22 @@
+import { type ToolName } from "../derivers/index.js";
+export interface SyncOptions {
+    projectPath: string;
+    tools?: ToolName[];
+    fast?: boolean;
+    dryRun?: boolean;
+    /** Path to a repomix output file to use as source corpus instead of filesystem sampling. */
+    repomixOutput?: string;
+}
+export interface SyncResult {
+    success: boolean;
+    filesUpdated: {
+        tool: string;
+        path: string;
+    }[];
+    customSectionsPreserved: number;
+    warnings: string[];
+    skippedExtraction: boolean;
+    dryRun: boolean;
+}
+export declare function runSync(options: SyncOptions): Promise<SyncResult>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/tools/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/tools/sync.ts"],"names":[],"mappings":"AAQA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAMhE,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,4FAA4F;IAC5F,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/C,uBAAuB,EAAE,MAAM,CAAC;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAgIvE"}

package/dist/tools/sync.js

@@ -0,0 +1,123 @@
+import path from "node:path";
+import { assertProjectDir, readFileSafe, writeFileAtomic } from "../lib/file-utils.js";
+import { AgentsSyncError } from "../lib/errors.js";
+import { scan } from "../scanner/index.js";
+import { extractMetadata } from "../extractor/extractor.js";
+import { generateAgentsMd, appendMcpSection } from "../generator/agents-md.js";
+import { validateAgentsMd } from "../generator/validator.js";
+import { deriveAll } from "../derivers/index.js";
+import { buildSnapshot, loadSnapshot, saveSnapshot, sha256 } from "../snapshot/writer.js";
+import { detectDrift } from "../snapshot/drift.js";
+import { loadConfig, applyConfig } from "../config/loader.js";
+export async function runSync(options) {
+    const { projectPath, tools, fast = false, dryRun = false, repomixOutput } = options;
+    await assertProjectDir(projectPath);
+    // 1. Load team config (agents-sync.config.json) — non-fatal if missing
+    const config = await loadConfig(projectPath);
+    // 2. Resolve effective tool list: CLI flag > config > default (all)
+    const effectiveTools = tools ?? config?.tools;
+    // 3. Scan always (optionally using repomix output as source corpus)
+    const corpus = await scan(projectPath, { repomixPath: repomixOutput });
+    // 2. Fast mode: check drift, skip extraction if only LOW signals
+    let skipExtraction = false;
+    if (fast) {
+        const snapshot = await loadSnapshot(projectPath);
+        if (snapshot) {
+            const drift = detectDrift(snapshot, corpus);
+            if (drift.maxSeverity === "LOW" || drift.maxSeverity === "NONE") {
+                skipExtraction = true;
+            }
+        }
+    }
+    let agentsMd;
+    if (skipExtraction) {
+        // Use existing AGENTS.md
+        const existing = await readFileSafe(path.join(projectPath, "AGENTS.md"));
+        if (!existing) {
+            throw new AgentsSyncError("NO_SNAPSHOT", "No existing AGENTS.md found. Cannot use --fast on first run.", "Run /agents-sync init first.");
+        }
+        agentsMd = existing;
+    }
+    else {
+        // Full re-extraction
+        const rawMetadata = await extractMetadata(corpus);
+        const metadata = applyConfig(rawMetadata, config);
+        agentsMd = appendMcpSection(await generateAgentsMd(metadata), corpus.mcp);
+        const validation = validateAgentsMd(agentsMd, corpus.structure.topLevelDirs);
+        if (!dryRun) {
+            await writeFileAtomic(path.join(projectPath, "AGENTS.md"), agentsMd);
+        }
+        // Derive all tool files
+        const derivations = await deriveAll({
+            projectPath,
+            agentsMdContent: agentsMd,
+            metadata,
+            tools: effectiveTools,
+            dryRun,
+        });
+        const warnings = [...validation.warnings];
+        for (const d of derivations) {
+            if (d.error)
+                warnings.push(`${d.tool}: ${d.error}`);
+        }
+        if (!dryRun) {
+            const manifestContent = corpus.manifest.dependencies.join("\n");
+            const managed = derivations
+                .filter((d) => d.written)
+                .map((d) => ({ tool: d.tool, path: d.path, sha256: sha256("") }));
+            const snapshot = buildSnapshot({
+                projectPath,
+                manifestContent,
+                structureHash: sha256(corpus.structure.topLevelDirs.join(",")),
+                filesManaged: [
+                    { tool: "agents-md", path: path.join(projectPath, "AGENTS.md"), sha256: sha256(agentsMd) },
+                    ...managed,
+                ],
+                language: metadata.project.language,
+                framework: metadata.project.framework ?? null,
+                topLevelDirs: corpus.structure.topLevelDirs,
+                dependencyCount: corpus.manifest.dependencies.length,
+                totalFiles: corpus.structure.totalFileCount,
+            });
+            await saveSnapshot(snapshot);
+        }
+        return {
+            success: true,
+            filesUpdated: derivations.filter((d) => !d.error).map((d) => ({ tool: d.tool, path: d.path })),
+            customSectionsPreserved: derivations.reduce((s, d) => s + (d.customBlocksPreserved ?? 0), 0),
+            warnings,
+            skippedExtraction: false,
+            dryRun,
+        };
+    }
+    // Fast path: just re-derive from existing AGENTS.md using stub metadata
+    const fastSnapshot = await loadSnapshot(projectPath);
+    if (!fastSnapshot) {
+        throw new AgentsSyncError("NO_SNAPSHOT", "No snapshot found. Run /agents-sync init first.");
+    }
+    const stubMetadata = {
+        project: {
+            name: path.basename(projectPath),
+            description: "",
+            language: fastSnapshot.meta.language,
+            framework: fastSnapshot.meta.framework ?? undefined,
+        },
+        stack: { other: [] },
+        architecture: { keyDirs: {}, entryPoints: [] },
+        conventions: [],
+        gotchas: [],
+        boundaries: { alwaysDo: [], askFirst: [], never: [] },
+        testing: {},
+        deployment: { notes: [] },
+    };
+    const derivations = await deriveAll({ projectPath, agentsMdContent: agentsMd, metadata: stubMetadata, tools: effectiveTools, dryRun });
+    return {
+        success: true,
+        filesUpdated: derivations.filter((d) => !d.error).map((d) => ({ tool: d.tool, path: d.path })),
+        customSectionsPreserved: derivations.reduce((s, d) => s + (d.customBlocksPreserved ?? 0), 0),
+        warnings: ["Fast mode: used cached metadata (no Claude API call)"],
+        skippedExtraction: true,
+        dryRun,
+    };
+}
+//# sourceMappingURL=sync.js.map

package/dist/tools/sync.js.map

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

package/dist/tools/validate.d.ts

@@ -0,0 +1,22 @@
+export interface ValidateOptions {
+    projectPath: string;
+}
+export type FileStatus = "in-sync" | "drifted" | "missing";
+export interface FileValidation {
+    tool: string;
+    path: string;
+    status: FileStatus;
+    details?: string;
+}
+export interface ValidateResult {
+    canonical: {
+        path: string;
+        exists: boolean;
+    };
+    toolFiles: FileValidation[];
+    allInSync: boolean;
+    hasSnapshot: boolean;
+    report: string;
+}
+export declare function runValidate(options: ValidateOptions): Promise<ValidateResult>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/tools/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/tools/validate.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7C,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAqCD,wBAAsB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAkEnF"}

package/dist/tools/validate.js

@@ -0,0 +1,97 @@
+import path from "node:path";
+import crypto from "node:crypto";
+import { assertProjectDir, readFileSafe, fileExists } from "../lib/file-utils.js";
+import { loadSnapshot } from "../snapshot/writer.js";
+function sha256File(content) {
+    return crypto.createHash("sha256").update(content).digest("hex");
+}
+const TOOL_PATHS = {
+    "agents-md": "AGENTS.md",
+    claude: "CLAUDE.md",
+    cursor: ".cursorrules",
+    copilot: ".github/copilot-instructions.md",
+    gemini: "GEMINI.md",
+    windsurf: ".windsurfrules",
+    cline: ".clinerules",
+};
+function buildReport(canonical, toolFiles, hasSnapshot) {
+    const lines = [];
+    lines.push(`AGENTS.md (canonical)  ${canonical.exists ? "✓" : "✗ MISSING"}`);
+    lines.push("");
+    for (const f of toolFiles) {
+        const icon = f.status === "in-sync" ? "✓" : f.status === "drifted" ? "⚠" : "✗";
+        const label = f.status === "in-sync" ? "in sync" : f.status;
+        lines.push(`${icon} ${f.tool.padEnd(10)} ${label.padEnd(10)} ${f.path}`);
+        if (f.details)
+            lines.push(`              ${f.details}`);
+    }
+    if (!hasSnapshot) {
+        lines.push("");
+        lines.push("No snapshot found. Run init to establish a baseline.");
+    }
+    return lines.join("\n");
+}
+export async function runValidate(options) {
+    await assertProjectDir(options.projectPath);
+    const snapshot = await loadSnapshot(options.projectPath);
+    const agentsMdPath = path.join(options.projectPath, "AGENTS.md");
+    const canonicalExists = await fileExists(agentsMdPath);
+    if (!snapshot) {
+        // No snapshot: just check which files exist
+        const toolFiles = [];
+        for (const [tool, relPath] of Object.entries(TOOL_PATHS)) {
+            if (tool === "agents-md")
+                continue;
+            const absPath = path.join(options.projectPath, relPath);
+            const exists = await fileExists(absPath);
+            toolFiles.push({
+                tool,
+                path: absPath,
+                status: exists ? "drifted" : "missing",
+                details: exists ? "No snapshot to compare against" : undefined,
+            });
+        }
+        const result = {
+            canonical: { path: agentsMdPath, exists: canonicalExists },
+            toolFiles,
+            allInSync: false,
+            hasSnapshot: false,
+        };
+        return { ...result, report: buildReport(result.canonical, toolFiles, false) };
+    }
+    // Compare current file hashes against snapshot
+    const toolFiles = [];
+    let allInSync = true;
+    for (const managed of snapshot.filesManaged) {
+        if (managed.tool === "agents-md")
+            continue;
+        const currentContent = await readFileSafe(managed.path);
+        if (!currentContent) {
+            toolFiles.push({ tool: managed.tool, path: managed.path, status: "missing" });
+            allInSync = false;
+            continue;
+        }
+        const currentHash = sha256File(currentContent);
+        if (currentHash !== managed.sha256 && managed.sha256 !== "") {
+            toolFiles.push({
+                tool: managed.tool,
+                path: managed.path,
+                status: "drifted",
+                details: "File was modified after last sync",
+            });
+            allInSync = false;
+        }
+        else {
+            toolFiles.push({ tool: managed.tool, path: managed.path, status: "in-sync" });
+        }
+    }
+    const canonical = { path: agentsMdPath, exists: canonicalExists };
+    return {
+        canonical,
+        toolFiles,
+        allInSync,
+        hasSnapshot: true,
+        report: buildReport(canonical, toolFiles, true),
+    };
+}
+//# sourceMappingURL=validate.js.map

package/dist/tools/validate.js.map

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