syncpoint-ai 0.1.0

package/dist/context/state-snapshot.d.ts

@@ -0,0 +1,177 @@
+/**
+ * StateSnapshot — generic actor state snapshot.
+ *
+ * A point-in-time snapshot of an actor's work state, referencing
+ * the resources they are working with. Generalizes checkpoint +
+ * context snapshot concepts for any resource type.
+ */
+import { z } from "zod";
+export declare const StateSnapshotSchema: z.ZodObject<{
+    id: z.ZodString;
+    actorId: z.ZodString;
+    taskId: z.ZodString;
+    sessionId: z.ZodDefault<z.ZodString>;
+    summary: z.ZodString;
+    resourceRefs: z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        id: z.ZodOptional<z.ZodString>;
+        locator: z.ZodString;
+        scope: z.ZodDefault<z.ZodEnum<["file", "function", "line_range"]>>;
+        functionName: z.ZodOptional<z.ZodString>;
+        lineRange: z.ZodOptional<z.ZodObject<{
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            start: number;
+            end: number;
+        }, {
+            start: number;
+            end: number;
+        }>>;
+        metadata: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        locator: string;
+        scope: "function" | "file" | "line_range";
+        metadata: string;
+        id?: string | undefined;
+        functionName?: string | undefined;
+        lineRange?: {
+            start: number;
+            end: number;
+        } | undefined;
+    }, {
+        type: string;
+        locator: string;
+        id?: string | undefined;
+        scope?: "function" | "file" | "line_range" | undefined;
+        functionName?: string | undefined;
+        lineRange?: {
+            start: number;
+            end: number;
+        } | undefined;
+        metadata?: string | undefined;
+    }>, "many">;
+    createdAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    actorId: string;
+    taskId: string;
+    sessionId: string;
+    createdAt: string;
+    summary: string;
+    resourceRefs: {
+        type: string;
+        locator: string;
+        scope: "function" | "file" | "line_range";
+        metadata: string;
+        id?: string | undefined;
+        functionName?: string | undefined;
+        lineRange?: {
+            start: number;
+            end: number;
+        } | undefined;
+    }[];
+}, {
+    id: string;
+    actorId: string;
+    taskId: string;
+    createdAt: string;
+    summary: string;
+    resourceRefs: {
+        type: string;
+        locator: string;
+        id?: string | undefined;
+        scope?: "function" | "file" | "line_range" | undefined;
+        functionName?: string | undefined;
+        lineRange?: {
+            start: number;
+            end: number;
+        } | undefined;
+        metadata?: string | undefined;
+    }[];
+    sessionId?: string | undefined;
+}>;
+export type StateSnapshot = z.infer<typeof StateSnapshotSchema>;
+export declare const StateSnapshotCreateSchema: z.ZodObject<{
+    actorId: z.ZodString;
+    taskId: z.ZodString;
+    sessionId: z.ZodOptional<z.ZodString>;
+    summary: z.ZodString;
+    resourceRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        id: z.ZodOptional<z.ZodString>;
+        locator: z.ZodString;
+        scope: z.ZodDefault<z.ZodEnum<["file", "function", "line_range"]>>;
+        functionName: z.ZodOptional<z.ZodString>;
+        lineRange: z.ZodOptional<z.ZodObject<{
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            start: number;
+            end: number;
+        }, {
+            start: number;
+            end: number;
+        }>>;
+        metadata: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        locator: string;
+        scope: "function" | "file" | "line_range";
+        metadata: string;
+        id?: string | undefined;
+        functionName?: string | undefined;
+        lineRange?: {
+            start: number;
+            end: number;
+        } | undefined;
+    }, {
+        type: string;
+        locator: string;
+        id?: string | undefined;
+        scope?: "function" | "file" | "line_range" | undefined;
+        functionName?: string | undefined;
+        lineRange?: {
+            start: number;
+            end: number;
+        } | undefined;
+        metadata?: string | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    actorId: string;
+    taskId: string;
+    summary: string;
+    resourceRefs: {
+        type: string;
+        locator: string;
+        scope: "function" | "file" | "line_range";
+        metadata: string;
+        id?: string | undefined;
+        functionName?: string | undefined;
+        lineRange?: {
+            start: number;
+            end: number;
+        } | undefined;
+    }[];
+    sessionId?: string | undefined;
+}, {
+    actorId: string;
+    taskId: string;
+    summary: string;
+    sessionId?: string | undefined;
+    resourceRefs?: {
+        type: string;
+        locator: string;
+        id?: string | undefined;
+        scope?: "function" | "file" | "line_range" | undefined;
+        functionName?: string | undefined;
+        lineRange?: {
+            start: number;
+            end: number;
+        } | undefined;
+        metadata?: string | undefined;
+    }[] | undefined;
+}>;
+export type StateSnapshotCreate = z.infer<typeof StateSnapshotCreateSchema>;
+//# sourceMappingURL=state-snapshot.d.ts.map

package/dist/context/state-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-snapshot.d.ts","sourceRoot":"","sources":["../../_build/src/context/state-snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/context/state-snapshot.js

@@ -0,0 +1,27 @@
+/**
+ * StateSnapshot — generic actor state snapshot.
+ *
+ * A point-in-time snapshot of an actor's work state, referencing
+ * the resources they are working with. Generalizes checkpoint +
+ * context snapshot concepts for any resource type.
+ */
+import { z } from "zod";
+import { ResourceRefSchema } from "../kernel/index.js";
+// ── Schema ──────────────────────────────────────────
+export const StateSnapshotSchema = z.object({
+    id: z.string(),
+    actorId: z.string(),
+    taskId: z.string(),
+    sessionId: z.string().default(""),
+    summary: z.string(),
+    resourceRefs: z.array(ResourceRefSchema),
+    createdAt: z.string(),
+});
+export const StateSnapshotCreateSchema = z.object({
+    actorId: z.string(),
+    taskId: z.string(),
+    sessionId: z.string().optional(),
+    summary: z.string().min(1),
+    resourceRefs: z.array(ResourceRefSchema).default([]),
+});
+//# sourceMappingURL=state-snapshot.js.map

package/dist/context/state-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-snapshot.js","sourceRoot":"","sources":["../../_build/src/context/state-snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,uDAAuD;AAEvD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACjC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;IACxC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACrD,CAAC,CAAC"}

package/dist/core/_exports/adapters.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Adapters layer re-export facade.
+ * syncpoint-core now delegates to syncpoint-adapters as the canonical source.
+ */
+export * from "../../adapters/index.js";
+//# sourceMappingURL=adapters.d.ts.map

package/dist/core/_exports/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../../_build/src/core/_exports/adapters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,yBAAyB,CAAC"}

package/dist/core/_exports/adapters.js

@@ -0,0 +1,6 @@
+/**
+ * Adapters layer re-export facade.
+ * syncpoint-core now delegates to syncpoint-adapters as the canonical source.
+ */
+export * from "../../adapters/index.js";
+//# sourceMappingURL=adapters.js.map

package/dist/core/_exports/adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../../../_build/src/core/_exports/adapters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,yBAAyB,CAAC"}

package/dist/core/_exports/context.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Context layer re-export facade.
+ * syncpoint-core now delegates to syncpoint-context as the canonical source.
+ */
+export * from "../../context/index.js";
+//# sourceMappingURL=context.d.ts.map

package/dist/core/_exports/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../_build/src/core/_exports/context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,wBAAwB,CAAC"}

package/dist/core/_exports/context.js

@@ -0,0 +1,6 @@
+/**
+ * Context layer re-export facade.
+ * syncpoint-core now delegates to syncpoint-context as the canonical source.
+ */
+export * from "../../context/index.js";
+//# sourceMappingURL=context.js.map

package/dist/core/_exports/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../_build/src/core/_exports/context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,wBAAwB,CAAC"}

package/dist/core/_exports/governance.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Governance re-export facade.
+ * syncpoint-core now delegates to syncpoint-governance as the canonical source.
+ */
+export * from "../../governance/index.js";
+//# sourceMappingURL=governance.d.ts.map

package/dist/core/_exports/governance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance.d.ts","sourceRoot":"","sources":["../../../_build/src/core/_exports/governance.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,2BAA2B,CAAC"}

package/dist/core/_exports/governance.js

@@ -0,0 +1,6 @@
+/**
+ * Governance re-export facade.
+ * syncpoint-core now delegates to syncpoint-governance as the canonical source.
+ */
+export * from "../../governance/index.js";
+//# sourceMappingURL=governance.js.map

package/dist/core/_exports/governance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance.js","sourceRoot":"","sources":["../../../_build/src/core/_exports/governance.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,2BAA2B,CAAC"}

package/dist/core/_exports/kernel.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Kernel re-export facade.
+ * syncpoint-core now delegates to syncpoint-kernel as the canonical source.
+ */
+export * from "../../kernel/index.js";
+//# sourceMappingURL=kernel.d.ts.map

package/dist/core/_exports/kernel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../../../_build/src/core/_exports/kernel.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,uBAAuB,CAAC"}

package/dist/core/_exports/kernel.js

@@ -0,0 +1,6 @@
+/**
+ * Kernel re-export facade.
+ * syncpoint-core now delegates to syncpoint-kernel as the canonical source.
+ */
+export * from "../../kernel/index.js";
+//# sourceMappingURL=kernel.js.map

package/dist/core/_exports/kernel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.js","sourceRoot":"","sources":["../../../_build/src/core/_exports/kernel.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,uBAAuB,CAAC"}

package/dist/core/config.d.ts

@@ -0,0 +1,373 @@
+/**
+ * Unified SyncPoint configuration schema.
+ *
+ * Single source of truth for all configuration, with:
+ *   - Zod validation
+ *   - Environment variable mapping
+ *   - Sensible defaults
+ */
+import { z } from "zod";
+export declare const DatabaseConfig: z.ZodObject<{
+    path: z.ZodDefault<z.ZodString>;
+    wal: z.ZodDefault<z.ZodBoolean>;
+    busyTimeout: z.ZodDefault<z.ZodNumber>;
+    walAutocheckpoint: z.ZodDefault<z.ZodNumber>;
+    cacheSize: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    wal: boolean;
+    busyTimeout: number;
+    walAutocheckpoint: number;
+    cacheSize: number;
+}, {
+    path?: string | undefined;
+    wal?: boolean | undefined;
+    busyTimeout?: number | undefined;
+    walAutocheckpoint?: number | undefined;
+    cacheSize?: number | undefined;
+}>;
+export declare const ServerConfig: z.ZodObject<{
+    port: z.ZodDefault<z.ZodNumber>;
+    host: z.ZodDefault<z.ZodString>;
+    corsOrigins: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    maxBodySize: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    host: string;
+    port: number;
+    corsOrigins: string[];
+    maxBodySize: number;
+}, {
+    host?: string | undefined;
+    port?: number | undefined;
+    corsOrigins?: string[] | undefined;
+    maxBodySize?: number | undefined;
+}>;
+export declare const GuardConfig: z.ZodObject<{
+    mode: z.ZodDefault<z.ZodEnum<["off", "L0_audit", "L1_controlled", "L2_editor_guard", "L3_proxy"]>>;
+    fileWatcher: z.ZodDefault<z.ZodEnum<["@parcel/watcher", "native"]>>;
+    debounceMs: z.ZodDefault<z.ZodNumber>;
+    maxWatchers: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    mode: "off" | "L0_audit" | "L1_controlled" | "L2_editor_guard" | "L3_proxy";
+    fileWatcher: "@parcel/watcher" | "native";
+    debounceMs: number;
+    maxWatchers: number;
+}, {
+    mode?: "off" | "L0_audit" | "L1_controlled" | "L2_editor_guard" | "L3_proxy" | undefined;
+    fileWatcher?: "@parcel/watcher" | "native" | undefined;
+    debounceMs?: number | undefined;
+    maxWatchers?: number | undefined;
+}>;
+export declare const SseConfig: z.ZodObject<{
+    heartbeatIntervalMs: z.ZodDefault<z.ZodNumber>;
+    maxConnections: z.ZodDefault<z.ZodNumber>;
+    eventRetentionHours: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    heartbeatIntervalMs: number;
+    maxConnections: number;
+    eventRetentionHours: number;
+}, {
+    heartbeatIntervalMs?: number | undefined;
+    maxConnections?: number | undefined;
+    eventRetentionHours?: number | undefined;
+}>;
+export declare const ConstraintsConfig: z.ZodObject<{
+    defaultPolicy: z.ZodDefault<z.ZodEnum<["allow_all", "deny_all"]>>;
+}, "strip", z.ZodTypeAny, {
+    defaultPolicy: "allow_all" | "deny_all";
+}, {
+    defaultPolicy?: "allow_all" | "deny_all" | undefined;
+}>;
+export declare const CheckpointConfig: z.ZodObject<{
+    snapshotMode: z.ZodDefault<z.ZodEnum<["full", "incremental"]>>;
+    gcStrategy: z.ZodDefault<z.ZodEnum<["keep_last_n", "max_age_days", "max_size_mb"]>>;
+    gcKeepLast: z.ZodDefault<z.ZodNumber>;
+    gcMaxAgeDays: z.ZodDefault<z.ZodNumber>;
+    gcMaxSizeMb: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    snapshotMode: "full" | "incremental";
+    gcStrategy: "keep_last_n" | "max_age_days" | "max_size_mb";
+    gcKeepLast: number;
+    gcMaxAgeDays: number;
+    gcMaxSizeMb: number;
+}, {
+    snapshotMode?: "full" | "incremental" | undefined;
+    gcStrategy?: "keep_last_n" | "max_age_days" | "max_size_mb" | undefined;
+    gcKeepLast?: number | undefined;
+    gcMaxAgeDays?: number | undefined;
+    gcMaxSizeMb?: number | undefined;
+}>;
+export declare const AuthConfig: z.ZodObject<{
+    sharedSecret: z.ZodOptional<z.ZodString>;
+    requireToken: z.ZodDefault<z.ZodBoolean>;
+    tokenHeader: z.ZodDefault<z.ZodString>;
+    callerIdHeader: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    requireToken: boolean;
+    tokenHeader: string;
+    callerIdHeader: string;
+    sharedSecret?: string | undefined;
+}, {
+    sharedSecret?: string | undefined;
+    requireToken?: boolean | undefined;
+    tokenHeader?: string | undefined;
+    callerIdHeader?: string | undefined;
+}>;
+export declare const LogConfig: z.ZodObject<{
+    level: z.ZodDefault<z.ZodEnum<["debug", "info", "warn", "error", "fatal"]>>;
+    format: z.ZodDefault<z.ZodEnum<["json", "pretty"]>>;
+}, "strip", z.ZodTypeAny, {
+    level: "info" | "debug" | "warn" | "error" | "fatal";
+    format: "json" | "pretty";
+}, {
+    level?: "info" | "debug" | "warn" | "error" | "fatal" | undefined;
+    format?: "json" | "pretty" | undefined;
+}>;
+export declare const SyncPointConfigSchema: z.ZodObject<{
+    database: z.ZodDefault<z.ZodObject<{
+        path: z.ZodDefault<z.ZodString>;
+        wal: z.ZodDefault<z.ZodBoolean>;
+        busyTimeout: z.ZodDefault<z.ZodNumber>;
+        walAutocheckpoint: z.ZodDefault<z.ZodNumber>;
+        cacheSize: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        wal: boolean;
+        busyTimeout: number;
+        walAutocheckpoint: number;
+        cacheSize: number;
+    }, {
+        path?: string | undefined;
+        wal?: boolean | undefined;
+        busyTimeout?: number | undefined;
+        walAutocheckpoint?: number | undefined;
+        cacheSize?: number | undefined;
+    }>>;
+    server: z.ZodDefault<z.ZodObject<{
+        port: z.ZodDefault<z.ZodNumber>;
+        host: z.ZodDefault<z.ZodString>;
+        corsOrigins: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        maxBodySize: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        host: string;
+        port: number;
+        corsOrigins: string[];
+        maxBodySize: number;
+    }, {
+        host?: string | undefined;
+        port?: number | undefined;
+        corsOrigins?: string[] | undefined;
+        maxBodySize?: number | undefined;
+    }>>;
+    guard: z.ZodDefault<z.ZodObject<{
+        mode: z.ZodDefault<z.ZodEnum<["off", "L0_audit", "L1_controlled", "L2_editor_guard", "L3_proxy"]>>;
+        fileWatcher: z.ZodDefault<z.ZodEnum<["@parcel/watcher", "native"]>>;
+        debounceMs: z.ZodDefault<z.ZodNumber>;
+        maxWatchers: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "off" | "L0_audit" | "L1_controlled" | "L2_editor_guard" | "L3_proxy";
+        fileWatcher: "@parcel/watcher" | "native";
+        debounceMs: number;
+        maxWatchers: number;
+    }, {
+        mode?: "off" | "L0_audit" | "L1_controlled" | "L2_editor_guard" | "L3_proxy" | undefined;
+        fileWatcher?: "@parcel/watcher" | "native" | undefined;
+        debounceMs?: number | undefined;
+        maxWatchers?: number | undefined;
+    }>>;
+    sse: z.ZodDefault<z.ZodObject<{
+        heartbeatIntervalMs: z.ZodDefault<z.ZodNumber>;
+        maxConnections: z.ZodDefault<z.ZodNumber>;
+        eventRetentionHours: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        heartbeatIntervalMs: number;
+        maxConnections: number;
+        eventRetentionHours: number;
+    }, {
+        heartbeatIntervalMs?: number | undefined;
+        maxConnections?: number | undefined;
+        eventRetentionHours?: number | undefined;
+    }>>;
+    constraints: z.ZodDefault<z.ZodObject<{
+        defaultPolicy: z.ZodDefault<z.ZodEnum<["allow_all", "deny_all"]>>;
+    }, "strip", z.ZodTypeAny, {
+        defaultPolicy: "allow_all" | "deny_all";
+    }, {
+        defaultPolicy?: "allow_all" | "deny_all" | undefined;
+    }>>;
+    checkpoint: z.ZodDefault<z.ZodObject<{
+        snapshotMode: z.ZodDefault<z.ZodEnum<["full", "incremental"]>>;
+        gcStrategy: z.ZodDefault<z.ZodEnum<["keep_last_n", "max_age_days", "max_size_mb"]>>;
+        gcKeepLast: z.ZodDefault<z.ZodNumber>;
+        gcMaxAgeDays: z.ZodDefault<z.ZodNumber>;
+        gcMaxSizeMb: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        snapshotMode: "full" | "incremental";
+        gcStrategy: "keep_last_n" | "max_age_days" | "max_size_mb";
+        gcKeepLast: number;
+        gcMaxAgeDays: number;
+        gcMaxSizeMb: number;
+    }, {
+        snapshotMode?: "full" | "incremental" | undefined;
+        gcStrategy?: "keep_last_n" | "max_age_days" | "max_size_mb" | undefined;
+        gcKeepLast?: number | undefined;
+        gcMaxAgeDays?: number | undefined;
+        gcMaxSizeMb?: number | undefined;
+    }>>;
+    auth: z.ZodDefault<z.ZodObject<{
+        sharedSecret: z.ZodOptional<z.ZodString>;
+        requireToken: z.ZodDefault<z.ZodBoolean>;
+        tokenHeader: z.ZodDefault<z.ZodString>;
+        callerIdHeader: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        requireToken: boolean;
+        tokenHeader: string;
+        callerIdHeader: string;
+        sharedSecret?: string | undefined;
+    }, {
+        sharedSecret?: string | undefined;
+        requireToken?: boolean | undefined;
+        tokenHeader?: string | undefined;
+        callerIdHeader?: string | undefined;
+    }>>;
+    log: z.ZodDefault<z.ZodObject<{
+        level: z.ZodDefault<z.ZodEnum<["debug", "info", "warn", "error", "fatal"]>>;
+        format: z.ZodDefault<z.ZodEnum<["json", "pretty"]>>;
+    }, "strip", z.ZodTypeAny, {
+        level: "info" | "debug" | "warn" | "error" | "fatal";
+        format: "json" | "pretty";
+    }, {
+        level?: "info" | "debug" | "warn" | "error" | "fatal" | undefined;
+        format?: "json" | "pretty" | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    checkpoint: {
+        snapshotMode: "full" | "incremental";
+        gcStrategy: "keep_last_n" | "max_age_days" | "max_size_mb";
+        gcKeepLast: number;
+        gcMaxAgeDays: number;
+        gcMaxSizeMb: number;
+    };
+    log: {
+        level: "info" | "debug" | "warn" | "error" | "fatal";
+        format: "json" | "pretty";
+    };
+    database: {
+        path: string;
+        wal: boolean;
+        busyTimeout: number;
+        walAutocheckpoint: number;
+        cacheSize: number;
+    };
+    server: {
+        host: string;
+        port: number;
+        corsOrigins: string[];
+        maxBodySize: number;
+    };
+    guard: {
+        mode: "off" | "L0_audit" | "L1_controlled" | "L2_editor_guard" | "L3_proxy";
+        fileWatcher: "@parcel/watcher" | "native";
+        debounceMs: number;
+        maxWatchers: number;
+    };
+    sse: {
+        heartbeatIntervalMs: number;
+        maxConnections: number;
+        eventRetentionHours: number;
+    };
+    constraints: {
+        defaultPolicy: "allow_all" | "deny_all";
+    };
+    auth: {
+        requireToken: boolean;
+        tokenHeader: string;
+        callerIdHeader: string;
+        sharedSecret?: string | undefined;
+    };
+}, {
+    checkpoint?: {
+        snapshotMode?: "full" | "incremental" | undefined;
+        gcStrategy?: "keep_last_n" | "max_age_days" | "max_size_mb" | undefined;
+        gcKeepLast?: number | undefined;
+        gcMaxAgeDays?: number | undefined;
+        gcMaxSizeMb?: number | undefined;
+    } | undefined;
+    log?: {
+        level?: "info" | "debug" | "warn" | "error" | "fatal" | undefined;
+        format?: "json" | "pretty" | undefined;
+    } | undefined;
+    database?: {
+        path?: string | undefined;
+        wal?: boolean | undefined;
+        busyTimeout?: number | undefined;
+        walAutocheckpoint?: number | undefined;
+        cacheSize?: number | undefined;
+    } | undefined;
+    server?: {
+        host?: string | undefined;
+        port?: number | undefined;
+        corsOrigins?: string[] | undefined;
+        maxBodySize?: number | undefined;
+    } | undefined;
+    guard?: {
+        mode?: "off" | "L0_audit" | "L1_controlled" | "L2_editor_guard" | "L3_proxy" | undefined;
+        fileWatcher?: "@parcel/watcher" | "native" | undefined;
+        debounceMs?: number | undefined;
+        maxWatchers?: number | undefined;
+    } | undefined;
+    sse?: {
+        heartbeatIntervalMs?: number | undefined;
+        maxConnections?: number | undefined;
+        eventRetentionHours?: number | undefined;
+    } | undefined;
+    constraints?: {
+        defaultPolicy?: "allow_all" | "deny_all" | undefined;
+    } | undefined;
+    auth?: {
+        sharedSecret?: string | undefined;
+        requireToken?: boolean | undefined;
+        tokenHeader?: string | undefined;
+        callerIdHeader?: string | undefined;
+    } | undefined;
+}>;
+export type SyncPointConfig = z.infer<typeof SyncPointConfigSchema>;
+export declare const DEFAULT_CONFIG: SyncPointConfig;
+/**
+ * Deep merge configs, with later sources overriding earlier ones.
+ * Priority: defaults < config file < environment variables
+ */
+export declare function mergeConfig(...configs: Partial<SyncPointConfig>[]): SyncPointConfig;
+/**
+ * Load config from a YAML file path. Returns partial config or empty object
+ * if the file doesn't exist or can't be parsed.
+ *
+ * Priority: defaults < config file < environment < CLI args
+ */
+export declare function configFromFile(filePath: string): Partial<SyncPointConfig>;
+/**
+/**
+ * Full config loading with priority: CLI > env > file > defaults.
+ *
+ * @param cliOverrides - Partial config from CLI arguments (highest priority)
+ * @param filePath - Path to .syncpoint/config.yaml or config.json
+ * @returns Validated SyncPointConfig
+ */
+export declare function loadConfig(cliOverrides?: Partial<SyncPointConfig>, filePath?: string): SyncPointConfig;
+/** Structured validation error with user-friendly messages. */
+export interface ConfigValidationIssue {
+    path: string;
+    message: string;
+    suggestion: string;
+}
+/**
+ * Validate a partial config and return a list of issues.
+ * Returns empty array if config is valid.
+ */
+export declare function validateConfig(config: unknown): ConfigValidationIssue[];
+/**
+ * Build a partial config from environment variables.
+ * All env vars are prefixed with SYNCPOINT_ (e.g., SYNCPOINT_SERVER_PORT=8765).
+ */
+export declare function configFromEnv(): Partial<SyncPointConfig>;
+//# sourceMappingURL=config.d.ts.map