@googlarz/agents-sync 1.0.0

package/dist/snapshot/schema.js

@@ -0,0 +1,24 @@
+import { z } from "zod";
+export const ManagedFileSchema = z.object({
+    path: z.string(),
+    sha256: z.string(),
+    tool: z.enum(["agents-md", "claude", "cursor", "copilot", "gemini", "windsurf", "cline"]),
+});
+export const SnapshotSchema = z.object({
+    version: z.literal("1.0"),
+    syncedAt: z.string().describe("ISO 8601 timestamp"),
+    projectPath: z.string(),
+    codebaseHash: z.string().describe("SHA-256 of manifest content + structure"),
+    manifestHash: z.string().describe("SHA-256 of primary manifest file"),
+    filesManaged: z.array(ManagedFileSchema),
+    meta: z.object({
+        dependencyCount: z.number(),
+        topLevelDirs: z.array(z.string()),
+        language: z.string(),
+        framework: z.string().nullable(),
+        totalFiles: z.number(),
+    }),
+});
+export const SNAPSHOT_DIR = ".agents-sync";
+export const SNAPSHOT_FILE = "snapshot.json";
+//# sourceMappingURL=schema.js.map

package/dist/snapshot/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/snapshot/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;CAC1F,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACzB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IACnD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IAC5E,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IACrE,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACb,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;QAC3B,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACjC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;KACvB,CAAC;CACH,CAAC,CAAC;AAKH,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC;AAC3C,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC"}

package/dist/snapshot/writer.d.ts

@@ -0,0 +1,17 @@
+import { type Snapshot, type ManagedFile } from "./schema.js";
+export declare function sha256(content: string): string;
+export declare function snapshotPath(projectPath: string): string;
+export declare function loadSnapshot(projectPath: string): Promise<Snapshot | null>;
+export declare function saveSnapshot(snapshot: Snapshot): Promise<void>;
+export declare function buildSnapshot(params: {
+    projectPath: string;
+    manifestContent: string;
+    structureHash: string;
+    filesManaged: ManagedFile[];
+    language: string;
+    framework: string | null;
+    topLevelDirs: string[];
+    dependencyCount: number;
+    totalFiles: number;
+}): Snapshot;
+//# sourceMappingURL=writer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/snapshot/writer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,WAAW,EAA+C,MAAM,aAAa,CAAC;AAE3G,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAQhF;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAKpE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,QAAQ,CAmBX"}

package/dist/snapshot/writer.js

@@ -0,0 +1,44 @@
+import crypto from "node:crypto";
+import path from "node:path";
+import { writeFileAtomic, readFileSafe } from "../lib/file-utils.js";
+import { SnapshotSchema, SNAPSHOT_DIR, SNAPSHOT_FILE } from "./schema.js";
+export function sha256(content) {
+    return crypto.createHash("sha256").update(content).digest("hex");
+}
+export function snapshotPath(projectPath) {
+    return path.join(projectPath, SNAPSHOT_DIR, SNAPSHOT_FILE);
+}
+export async function loadSnapshot(projectPath) {
+    const raw = await readFileSafe(snapshotPath(projectPath));
+    if (!raw)
+        return null;
+    try {
+        return SnapshotSchema.parse(JSON.parse(raw));
+    }
+    catch {
+        return null;
+    }
+}
+export async function saveSnapshot(snapshot) {
+    await writeFileAtomic(snapshotPath(snapshot.projectPath), JSON.stringify(snapshot, null, 2));
+}
+export function buildSnapshot(params) {
+    const manifestHash = sha256(params.manifestContent);
+    const codebaseHash = sha256(params.manifestContent + params.structureHash);
+    return {
+        version: "1.0",
+        syncedAt: new Date().toISOString(),
+        projectPath: params.projectPath,
+        codebaseHash,
+        manifestHash,
+        filesManaged: params.filesManaged,
+        meta: {
+            dependencyCount: params.dependencyCount,
+            topLevelDirs: params.topLevelDirs,
+            language: params.language,
+            framework: params.framework,
+            totalFiles: params.totalFiles,
+        },
+    };
+}
+//# sourceMappingURL=writer.js.map

package/dist/snapshot/writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.js","sourceRoot":"","sources":["../../src/snapshot/writer.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAmC,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE3G,MAAM,UAAU,MAAM,CAAC,OAAe;IACpC,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,WAAmB;IAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,WAAmB;IACpD,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC;IAC1D,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAkB;IACnD,MAAM,eAAe,CACnB,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,EAClC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAU7B;IACC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IACpD,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,eAAe,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;IAE3E,OAAO;QACL,OAAO,EAAE,KAAK;QACd,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAClC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,YAAY;QACZ,YAAY;QACZ,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,IAAI,EAAE;YACJ,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/drift.d.ts

@@ -0,0 +1,15 @@
+export interface DriftOptions {
+    projectPath: string;
+}
+export interface DriftToolResult {
+    hasSnapshot: boolean;
+    report: string;
+    maxSeverity?: string;
+    signalCount?: number;
+    daysSinceSync?: number;
+    recommendation?: string;
+    /** true when maxSeverity is HIGH — use to set CI exit code */
+    highDrift: boolean;
+}
+export declare function runDrift(options: DriftOptions): Promise<DriftToolResult>;
+//# sourceMappingURL=drift.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"drift.d.ts","sourceRoot":"","sources":["../../src/tools/drift.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAsB,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CA8B9E"}

package/dist/tools/drift.js

@@ -0,0 +1,31 @@
+import { assertProjectDir } from "../lib/file-utils.js";
+import { scan } from "../scanner/index.js";
+import { loadSnapshot } from "../snapshot/writer.js";
+import { detectDrift, formatDriftReport } from "../snapshot/drift.js";
+export async function runDrift(options) {
+    await assertProjectDir(options.projectPath);
+    const snapshot = await loadSnapshot(options.projectPath);
+    if (!snapshot) {
+        return {
+            hasSnapshot: false,
+            report: "No snapshot found. Run init first.",
+            highDrift: false,
+        };
+    }
+    const corpus = await scan(options.projectPath);
+    const result = detectDrift(snapshot, corpus);
+    if (!result.hasSnapshot) {
+        return { hasSnapshot: false, report: "No snapshot found. Run init first.", highDrift: false };
+    }
+    const report = formatDriftReport(result);
+    return {
+        hasSnapshot: true,
+        report,
+        maxSeverity: result.maxSeverity,
+        signalCount: result.signals.length,
+        daysSinceSync: result.daysSinceSync,
+        recommendation: result.recommendation,
+        highDrift: result.maxSeverity === "HIGH",
+    };
+}
+//# sourceMappingURL=drift.js.map

package/dist/tools/drift.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift.js","sourceRoot":"","sources":["../../src/tools/drift.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAoB,MAAM,sBAAsB,CAAC;AAiBxF,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAqB;IAClD,MAAM,gBAAgB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAE5C,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACzD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,WAAW,EAAE,KAAK;YAClB,MAAM,EAAE,oCAAoC;YAC5C,SAAS,EAAE,KAAK;SACjB,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAE1D,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QACxB,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,oCAAoC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAChG,CAAC;IAED,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAEzC,OAAO;QACL,WAAW,EAAE,IAAI;QACjB,MAAM;QACN,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;QAClC,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,SAAS,EAAE,MAAM,CAAC,WAAW,KAAK,MAAM;KACzC,CAAC;AACJ,CAAC"}

package/dist/tools/export.d.ts

@@ -0,0 +1,14 @@
+import { type ToolName } from "../derivers/index.js";
+export interface ExportOptions {
+    projectPath: string;
+    tool: ToolName;
+}
+export interface ExportResult {
+    tool: ToolName;
+    path: string;
+    written: boolean;
+    report: string;
+    error?: string;
+}
+export declare function runExport(options: ExportOptions): Promise<ExportResult>;
+//# sourceMappingURL=export.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/tools/export.ts"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhE,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CA6D7E"}

package/dist/tools/export.js

@@ -0,0 +1,53 @@
+import path from "node:path";
+import { assertProjectDir, readFileSafe } from "../lib/file-utils.js";
+import { AgentsSyncError } from "../lib/errors.js";
+import { loadSnapshot } from "../snapshot/writer.js";
+import { deriveAll } from "../derivers/index.js";
+export async function runExport(options) {
+    await assertProjectDir(options.projectPath);
+    const snapshot = await loadSnapshot(options.projectPath);
+    if (!snapshot) {
+        throw new AgentsSyncError("NO_SNAPSHOT", "No snapshot found. Cannot export without a prior sync.", "Run /agents-sync init first.");
+    }
+    const agentsMd = await readFileSafe(path.join(options.projectPath, "AGENTS.md"));
+    if (!agentsMd) {
+        throw new AgentsSyncError("NO_SNAPSHOT", "AGENTS.md not found. Cannot derive tool file without canonical source.", "Run /agents-sync init first.");
+    }
+    // Build minimal metadata from snapshot for re-derivation (no Claude API call)
+    const minimalMetadata = {
+        project: {
+            name: path.basename(options.projectPath),
+            description: "",
+            language: snapshot.meta.language,
+            framework: snapshot.meta.framework ?? undefined,
+        },
+        stack: { other: [] },
+        architecture: { keyDirs: {}, entryPoints: [] },
+        conventions: [],
+        gotchas: [],
+        boundaries: { alwaysDo: [], askFirst: [], never: [] },
+        testing: {},
+        deployment: { notes: [] },
+    };
+    const results = await deriveAll({
+        projectPath: options.projectPath,
+        agentsMdContent: agentsMd,
+        metadata: minimalMetadata,
+        tools: [options.tool],
+    });
+    const result = results.find((r) => r.tool === options.tool);
+    if (!result) {
+        return { tool: options.tool, path: "", written: false, report: `✗ ${options.tool}: No result from deriver`, error: "No result from deriver" };
+    }
+    const report = result.error
+        ? `✗ ${options.tool}: ${result.error}`
+        : `✓ ${options.tool} → ${result.path}`;
+    return {
+        tool: options.tool,
+        path: result.path,
+        written: result.written,
+        report,
+        error: result.error,
+    };
+}
+//# sourceMappingURL=export.js.map

package/dist/tools/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/tools/export.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAiB,MAAM,sBAAsB,CAAC;AAgBhE,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;IACzD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,eAAe,CACvB,aAAa,EACb,wDAAwD,EACxD,8BAA8B,CAC/B,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;IACjF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,eAAe,CACvB,aAAa,EACb,wEAAwE,EACxE,8BAA8B,CAC/B,CAAC;IACJ,CAAC;IAED,8EAA8E;IAC9E,MAAM,eAAe,GAAoB;QACvC,OAAO,EAAE;YACP,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC;YACxC,WAAW,EAAE,EAAE;YACf,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ;YAChC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,IAAI,SAAS;SAChD;QACD,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QACpB,YAAY,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;QAC9C,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,EAAE;QACX,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QACrD,OAAO,EAAE,EAAE;QACX,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;KAC1B,CAAC;IAEF,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC;QAC9B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,eAAe,EAAE,QAAQ;QACzB,QAAQ,EAAE,eAAe;QACzB,KAAK,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;KACtB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,0BAA0B,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC;IAChJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK;QACzB,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,EAAE;QACtC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IAEzC,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM;QACN,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC;AACJ,CAAC"}

package/dist/tools/init.d.ts

@@ -0,0 +1,28 @@
+import { type ToolName } from "../derivers/index.js";
+export interface InitOptions {
+    projectPath: string;
+    tools?: ToolName[];
+    dryRun?: boolean;
+    /** Path to a repomix output file to use as source corpus instead of filesystem sampling. */
+    repomixOutput?: string;
+}
+export interface InitResult {
+    success: boolean;
+    agentsMdPath: string;
+    filesWritten: {
+        tool: string;
+        path: string;
+    }[];
+    customSectionsPreserved: number;
+    /** Files that existed before init and whose content was preserved as a custom block. */
+    preservedExistingFiles: string[];
+    tokenUsage: {
+        input: number;
+        output: number;
+        cacheHit: number;
+    };
+    warnings: string[];
+    dryRun: boolean;
+}
+export declare function runInit(options: InitOptions): Promise<InitResult>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/tools/init.ts"],"names":[],"mappings":"AAMA,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,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,MAAM,CAAC;IACrB,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/C,uBAAuB,EAAE,MAAM,CAAC;IAChC,wFAAwF;IACxF,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAkHvE"}

package/dist/tools/init.js

@@ -0,0 +1,103 @@
+import path from "node:path";
+import { assertProjectDir, readFileSafe, writeFileAtomic } from "../lib/file-utils.js";
+import { scan } from "../scanner/index.js";
+import { extractMetadata } from "../extractor/extractor.js";
+import { generateAgentsMd } from "../generator/agents-md.js";
+import { validateAgentsMd } from "../generator/validator.js";
+import { deriveAll } from "../derivers/index.js";
+import { buildSnapshot, saveSnapshot, sha256 } from "../snapshot/writer.js";
+import { isManagedByAgentsSync, injectCustomBlocks } from "../derivers/merger.js";
+import { loadConfig, applyConfig } from "../config/loader.js";
+export async function runInit(options) {
+    const { projectPath, tools, dryRun = false, repomixOutput } = options;
+    await assertProjectDir(projectPath);
+    // 1. Scan (optionally using repomix output as source corpus)
+    const corpus = await scan(projectPath, { repomixPath: repomixOutput });
+    // 2. Load team config (agents-sync.config.json) — non-fatal if missing
+    const config = await loadConfig(projectPath);
+    // 3. Extract metadata and merge config overrides
+    const rawMetadata = await extractMetadata(corpus);
+    const metadata = applyConfig(rawMetadata, config);
+    // 4. Resolve effective tool list: CLI flag > config > default (all)
+    const effectiveTools = tools ?? config?.tools;
+    // 5. Generate AGENTS.md
+    const agentsMd = await generateAgentsMd(metadata);
+    // 6. Validate
+    const validation = validateAgentsMd(agentsMd, corpus.structure.topLevelDirs);
+    const warnings = [...validation.warnings];
+    if (!validation.passed) {
+        warnings.push(...validation.failures.map((f) => `Quality check: ${f}`));
+    }
+    // 7. Write AGENTS.md — preserve existing unmanaged content as custom block
+    const agentsMdPath = path.join(projectPath, "AGENTS.md");
+    const preservedExistingFiles = [];
+    let agentsMdToWrite = agentsMd;
+    const existingAgentsMd = await readFileSafe(agentsMdPath);
+    if (existingAgentsMd && !isManagedByAgentsSync(existingAgentsMd)) {
+        const block = `\n<!-- Pre-existing AGENTS.md content preserved by agents-sync -->\n${existingAgentsMd}\n`;
+        agentsMdToWrite = injectCustomBlocks(agentsMd, [block]);
+        preservedExistingFiles.push("AGENTS.md");
+        warnings.push("AGENTS.md existed before init and was not managed — previous content preserved as a custom section.");
+    }
+    if (!dryRun) {
+        await writeFileAtomic(agentsMdPath, agentsMdToWrite);
+    }
+    // 8. Derive tool files (each deriver handles its own overwrite protection)
+    const derivations = await deriveAll({
+        projectPath,
+        agentsMdContent: agentsMdToWrite,
+        metadata,
+        tools: effectiveTools,
+        dryRun,
+    });
+    const filesWritten = derivations
+        .filter((d) => !d.error)
+        .map((d) => ({ tool: d.tool, path: d.path }));
+    const customSectionsPreserved = derivations.reduce((sum, d) => sum + (d.customBlocksPreserved ?? 0), 0);
+    for (const d of derivations) {
+        if (d.error)
+            warnings.push(`${d.tool}: ${d.error}`);
+        if (d.customBlocksPreserved > 0 && d.tool !== "agents-md") {
+            // Count preserved unmanaged files from derivers
+            // (loadUnmanagedFileAsCustomBlock wraps the whole file as 1 block)
+            preservedExistingFiles.push(d.path);
+        }
+    }
+    // 9. Save snapshot
+    if (!dryRun) {
+        const manifestContent = corpus.manifest.dependencies.join("\n") +
+            corpus.manifest.devDependencies.join("\n");
+        const managedFiles = [
+            { tool: "agents-md", path: agentsMdPath, sha256: sha256(agentsMdToWrite) },
+            ...derivations
+                .filter((d) => d.written && d.tool !== "agents-md")
+                .map((d) => ({ tool: d.tool, path: d.path, sha256: sha256("") })),
+        ];
+        const snapshot = buildSnapshot({
+            projectPath,
+            manifestContent,
+            structureHash: sha256(corpus.structure.topLevelDirs.join(",")),
+            filesManaged: managedFiles,
+            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);
+    }
+    if (!dryRun) {
+        warnings.push("Tip: add .agents-sync/ to your .gitignore");
+    }
+    return {
+        success: true,
+        agentsMdPath,
+        filesWritten,
+        customSectionsPreserved,
+        preservedExistingFiles,
+        tokenUsage: { input: 0, output: 0, cacheHit: 0 },
+        warnings,
+        dryRun,
+    };
+}
+//# sourceMappingURL=init.js.map

package/dist/tools/init.js.map

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

package/dist/tools/install-hook.d.ts

@@ -0,0 +1,15 @@
+export type HookManager = "husky" | "lefthook" | "git";
+export interface InstallHookOptions {
+    projectPath: string;
+    manager?: HookManager;
+    dryRun?: boolean;
+}
+export interface InstallHookResult {
+    manager: HookManager;
+    filesWritten: string[];
+    alreadyInstalled: boolean;
+    dryRun: boolean;
+    report: string;
+}
+export declare function runInstallHook(options: InstallHookOptions): Promise<InstallHookResult>;
+//# sourceMappingURL=install-hook.d.ts.map

package/dist/tools/install-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-hook.d.ts","sourceRoot":"","sources":["../../src/tools/install-hook.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,UAAU,GAAG,KAAK,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,WAAW,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AA6HD,wBAAsB,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAgD5F"}

package/dist/tools/install-hook.js

@@ -0,0 +1,169 @@
+/**
+ * agents-sync install-hook
+ *
+ * Detects the project's git hook manager (husky, lefthook, or plain git hooks)
+ * and installs a pre-commit hook that runs `agents-sync drift . --ci`.
+ * Blocks commits when AI context files have drifted from AGENTS.md.
+ */
+import path from "node:path";
+import fs from "node:fs/promises";
+import { assertProjectDir, fileExists } from "../lib/file-utils.js";
+const DRIFT_COMMAND = "npx @googlarz/agents-sync drift . --ci";
+const FAIL_MESSAGE = "AI context files are out of sync. Run: npx @googlarz/agents-sync sync .";
+async function detectManager(projectPath) {
+    // Check for husky
+    const huskyDir = path.join(projectPath, ".husky");
+    if (await fileExists(huskyDir))
+        return "husky";
+    // Check package.json for husky or lefthook
+    const pkgPath = path.join(projectPath, "package.json");
+    if (await fileExists(pkgPath)) {
+        try {
+            const pkg = JSON.parse(await fs.readFile(pkgPath, "utf8"));
+            const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
+            if (allDeps["husky"])
+                return "husky";
+            if (allDeps["lefthook"] || allDeps["@arkweid/lefthook"])
+                return "lefthook";
+        }
+        catch {
+            // ignore parse errors
+        }
+    }
+    // Check for lefthook config
+    const lefthookFiles = [".lefthook.yml", "lefthook.yml", ".lefthook.yaml", "lefthook.yaml"];
+    for (const f of lefthookFiles) {
+        if (await fileExists(path.join(projectPath, f)))
+            return "lefthook";
+    }
+    return "git";
+}
+async function installHusky(projectPath, dryRun) {
+    const huskyDir = path.join(projectPath, ".husky");
+    const hookFile = path.join(huskyDir, "pre-commit");
+    const hookContent = `${DRIFT_COMMAND}\n`;
+    if (await fileExists(hookFile)) {
+        const existing = await fs.readFile(hookFile, "utf8");
+        if (existing.includes("agents-sync")) {
+            return { files: [], alreadyInstalled: true };
+        }
+        // Append to existing hook
+        if (!dryRun) {
+            await fs.appendFile(hookFile, `\n${hookContent}`);
+        }
+        return { files: [hookFile], alreadyInstalled: false };
+    }
+    if (!dryRun) {
+        await fs.mkdir(huskyDir, { recursive: true });
+        await fs.writeFile(hookFile, `#!/usr/bin/env sh\n. "$(dirname -- "$0")/_/husky.sh"\n\n${hookContent}`);
+        await fs.chmod(hookFile, 0o755);
+    }
+    return { files: [hookFile], alreadyInstalled: false };
+}
+async function installLefthook(projectPath, dryRun) {
+    const configFile = path.join(projectPath, ".lefthook.yml");
+    const newBlock = [
+        "pre-commit:",
+        "  commands:",
+        "    agents-sync:",
+        `      run: ${DRIFT_COMMAND}`,
+        `      fail_text: "${FAIL_MESSAGE}"`,
+        "",
+    ].join("\n");
+    if (await fileExists(configFile)) {
+        const existing = await fs.readFile(configFile, "utf8");
+        if (existing.includes("agents-sync")) {
+            return { files: [], alreadyInstalled: true };
+        }
+        if (!dryRun) {
+            await fs.appendFile(configFile, `\n${newBlock}`);
+        }
+        return { files: [configFile], alreadyInstalled: false };
+    }
+    if (!dryRun) {
+        await fs.writeFile(configFile, newBlock);
+    }
+    return { files: [configFile], alreadyInstalled: false };
+}
+async function installGitHook(projectPath, dryRun) {
+    const gitDir = path.join(projectPath, ".git");
+    if (!(await fileExists(gitDir))) {
+        throw new Error("No .git directory found. Run this command from a git repository root.");
+    }
+    const hooksDir = path.join(gitDir, "hooks");
+    const hookFile = path.join(hooksDir, "pre-commit");
+    const hookContent = [
+        "#!/usr/bin/env sh",
+        `${DRIFT_COMMAND}`,
+        `if [ $? -ne 0 ]; then`,
+        `  echo "${FAIL_MESSAGE}"`,
+        `  exit 1`,
+        `fi`,
+        "",
+    ].join("\n");
+    if (await fileExists(hookFile)) {
+        const existing = await fs.readFile(hookFile, "utf8");
+        if (existing.includes("agents-sync")) {
+            return { files: [], alreadyInstalled: true };
+        }
+        if (!dryRun) {
+            await fs.appendFile(hookFile, `\n${DRIFT_COMMAND}\n`);
+        }
+        return { files: [hookFile], alreadyInstalled: false };
+    }
+    if (!dryRun) {
+        await fs.mkdir(hooksDir, { recursive: true });
+        await fs.writeFile(hookFile, hookContent);
+        await fs.chmod(hookFile, 0o755);
+    }
+    return { files: [hookFile], alreadyInstalled: false };
+}
+export async function runInstallHook(options) {
+    const { projectPath, dryRun = false } = options;
+    await assertProjectDir(projectPath);
+    const manager = options.manager ?? (await detectManager(projectPath));
+    let files;
+    let alreadyInstalled;
+    if (manager === "husky") {
+        ({ files, alreadyInstalled } = await installHusky(projectPath, dryRun));
+    }
+    else if (manager === "lefthook") {
+        ({ files, alreadyInstalled } = await installLefthook(projectPath, dryRun));
+    }
+    else {
+        ({ files, alreadyInstalled } = await installGitHook(projectPath, dryRun));
+    }
+    const lines = [];
+    if (alreadyInstalled) {
+        lines.push("✓ agents-sync hook already installed — nothing to do.");
+    }
+    else if (dryRun) {
+        lines.push(`DRY RUN — detected manager: ${manager}`);
+        for (const f of files)
+            lines.push(`→ Would write: ${f}`);
+    }
+    else {
+        lines.push(`✓ Installed pre-commit hook (${manager})`);
+        for (const f of files)
+            lines.push(`  → ${f}`);
+        lines.push("");
+        if (manager === "git") {
+            lines.push("  ⚠ Git hook is local only — teammates need to run install-hook too.");
+            lines.push("  → For shared hooks, add husky or lefthook to your project.");
+        }
+        else {
+            lines.push("  Commit .lefthook.yml (or .husky/pre-commit) so teammates get the hook too.");
+        }
+        lines.push("");
+        lines.push("Every commit now checks: agents-sync drift . --ci");
+        lines.push("If drift is HIGH, the commit is blocked with instructions to sync.");
+    }
+    return {
+        manager,
+        filesWritten: files,
+        alreadyInstalled,
+        dryRun,
+        report: lines.join("\n"),
+    };
+}
+//# sourceMappingURL=install-hook.js.map

package/dist/tools/install-hook.js.map

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

package/dist/tools/lint.d.ts

@@ -0,0 +1,24 @@
+export interface LintOptions {
+    projectPath: string;
+    /** Exit non-zero on any violation (CI mode). */
+    strict?: boolean;
+}
+export interface LintViolation {
+    file: string;
+    line: number;
+    text: string;
+}
+export interface LintCheck {
+    rule: string;
+    checkable: boolean;
+    violations: LintViolation[];
+    skippedReason?: string;
+}
+export interface LintResult {
+    checks: LintCheck[];
+    totalViolations: number;
+    report: string;
+    passed: boolean;
+}
+export declare function runLint(options: LintOptions): Promise<LintResult>;
+//# sourceMappingURL=lint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/tools/lint.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAwLD,wBAAsB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAmDvE"}