syncpoint-ai 0.1.0

package/dist/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../_build/src/core/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;EAMzB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;EAKvB,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;EAKtB,CAAC;AAEH,eAAO,MAAM,SAAS;;;;;;;;;;;;EAIpB,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;EAE5B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;EAM3B,CAAC;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;EAKrB,CAAC;AAEH,eAAO,MAAM,SAAS;;;;;;;;;EAGpB,CAAC;AAIH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAShC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAIpE,eAAO,MAAM,cAAc,EAAE,eAAiD,CAAC;AAI/E;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,EAAE,GAAG,eAAe,CAYnF;AAID;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAczE;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,YAAY,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,EACvC,QAAQ,CAAC,EAAE,MAAM,GAChB,eAAe,CAIjB;AAID,+DAA+D;AAC/D,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,qBAAqB,EAAE,CA8BvE;AAID;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC,CAqCxD"}

package/dist/core/config.js

@@ -0,0 +1,207 @@
+/**
+ * Unified SyncPoint configuration schema.
+ *
+ * Single source of truth for all configuration, with:
+ *   - Zod validation
+ *   - Environment variable mapping
+ *   - Sensible defaults
+ */
+import { z } from "zod";
+import fs from "node:fs";
+import path from "node:path";
+import { parse as parseYaml } from "yaml";
+// ── Sub-schemas ──────────────────────────────────────────
+export const DatabaseConfig = z.object({
+    path: z.string().default(".syncpoint/syncpoint.db"),
+    wal: z.boolean().default(true),
+    busyTimeout: z.number().min(1000).max(30000).default(5000),
+    walAutocheckpoint: z.number().min(100).max(10000).default(1000),
+    cacheSize: z.number().min(-128000).max(-1000).default(-64000),
+});
+export const ServerConfig = z.object({
+    port: z.number().min(1024).max(65535).default(8765),
+    host: z.string().default("127.0.0.1"),
+    corsOrigins: z.array(z.string()).default(["http://localhost:*"]),
+    maxBodySize: z.number().min(1024).default(5 * 1024 * 1024), // 5MB
+});
+export const GuardConfig = z.object({
+    mode: z.enum(["off", "L0_audit", "L1_controlled", "L2_editor_guard", "L3_proxy"]).default("L1_controlled"),
+    fileWatcher: z.enum(["@parcel/watcher", "native"]).default("native"),
+    debounceMs: z.number().min(50).max(5000).default(300),
+    maxWatchers: z.number().min(100).max(50000).default(5000),
+});
+export const SseConfig = z.object({
+    heartbeatIntervalMs: z.number().min(5000).max(120000).default(30000),
+    maxConnections: z.number().min(1).max(10000).default(200),
+    eventRetentionHours: z.number().min(1).max(720).default(24),
+});
+export const ConstraintsConfig = z.object({
+    defaultPolicy: z.enum(["allow_all", "deny_all"]).default("allow_all"),
+});
+export const CheckpointConfig = z.object({
+    snapshotMode: z.enum(["full", "incremental"]).default("incremental"),
+    gcStrategy: z.enum(["keep_last_n", "max_age_days", "max_size_mb"]).default("keep_last_n"),
+    gcKeepLast: z.number().min(1).max(1000).default(50),
+    gcMaxAgeDays: z.number().min(1).max(365).default(30),
+    gcMaxSizeMb: z.number().min(10).max(10000).default(500),
+});
+export const AuthConfig = z.object({
+    sharedSecret: z.string().optional(),
+    requireToken: z.boolean().default(false),
+    tokenHeader: z.string().default("x-agent-token"),
+    callerIdHeader: z.string().default("x-caller-id"),
+});
+export const LogConfig = z.object({
+    level: z.enum(["debug", "info", "warn", "error", "fatal"]).default("info"),
+    format: z.enum(["json", "pretty"]).default("json"),
+});
+// ── Root config ──────────────────────────────────────────
+export const SyncPointConfigSchema = z.object({
+    database: DatabaseConfig.default({}),
+    server: ServerConfig.default({}),
+    guard: GuardConfig.default({}),
+    sse: SseConfig.default({}),
+    constraints: ConstraintsConfig.default({}),
+    checkpoint: CheckpointConfig.default({}),
+    auth: AuthConfig.default({}),
+    log: LogConfig.default({}),
+});
+// ── Default config ───────────────────────────────────────
+export const DEFAULT_CONFIG = SyncPointConfigSchema.parse({});
+// ── Config merge ─────────────────────────────────────────
+/**
+ * Deep merge configs, with later sources overriding earlier ones.
+ * Priority: defaults < config file < environment variables
+ */
+export function mergeConfig(...configs) {
+    const merged = {};
+    for (const config of configs) {
+        for (const [key, value] of Object.entries(config)) {
+            if (value && typeof value === "object" && !Array.isArray(value)) {
+                merged[key] = { ...(merged[key] ?? {}), ...value };
+            }
+            else if (value !== undefined) {
+                merged[key] = value;
+            }
+        }
+    }
+    return SyncPointConfigSchema.parse(merged);
+}
+// ── File-based config loading ─────────────────────────────
+/**
+ * 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 function configFromFile(filePath) {
+    try {
+        const absPath = path.resolve(filePath);
+        if (!fs.existsSync(absPath))
+            return {};
+        const raw = fs.readFileSync(absPath, "utf-8");
+        if (absPath.endsWith(".json")) {
+            return JSON.parse(raw);
+        }
+        // Use the fully-featured yaml library (already a dependency)
+        const parsed = parseYaml(raw);
+        return (parsed ?? {});
+    }
+    catch {
+        return {};
+    }
+}
+/**
+/**
+ * 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 function loadConfig(cliOverrides, filePath) {
+    const fileConfig = filePath ? configFromFile(filePath) : {};
+    const envConfig = configFromEnv();
+    return mergeConfig(DEFAULT_CONFIG, fileConfig, envConfig, cliOverrides ?? {});
+}
+/**
+ * Validate a partial config and return a list of issues.
+ * Returns empty array if config is valid.
+ */
+export function validateConfig(config) {
+    const result = SyncPointConfigSchema.safeParse(config);
+    if (result.success)
+        return [];
+    const issues = [];
+    for (const err of result.error.issues) {
+        const path = err.path.join(".");
+        let message = err.message;
+        let suggestion = "Check the configuration reference: docs/CONFIG.md";
+        if (err.code === "invalid_type") {
+            message = `${path}: expected ${err.expected}, got ${err.received}`;
+            suggestion = `Set ${path} to a valid ${err.expected} value.`;
+        }
+        else if (err.code === "invalid_enum_value") {
+            const enumErr = err;
+            message = `${path}: "${enumErr.received}" is not a valid value`;
+            suggestion = `Valid options: ${enumErr.options.join(", ")}.`;
+        }
+        else if (err.code === "too_small") {
+            const tooSmallErr = err;
+            message = `${path}: ${tooSmallErr.message}`;
+            suggestion = `Minimum value is ${tooSmallErr.minimum}.`;
+        }
+        else if (err.code === "too_big") {
+            const tooBigErr = err;
+            message = `${path}: ${tooBigErr.message}`;
+            suggestion = `Maximum value is ${tooBigErr.maximum}.`;
+        }
+        issues.push({ path, message, suggestion });
+    }
+    return issues;
+}
+// ── Environment variable mapping ─────────────────────────
+/**
+ * Build a partial config from environment variables.
+ * All env vars are prefixed with SYNCPOINT_ (e.g., SYNCPOINT_SERVER_PORT=8765).
+ */
+export function configFromEnv() {
+    const config = {};
+    // Server
+    if (process.env.SYNCPOINT_PORT)
+        config.server = { port: parseInt(process.env.SYNCPOINT_PORT, 10) };
+    if (process.env.SYNCPOINT_HOST)
+        config.server = { ...(config.server ?? {}), host: process.env.SYNCPOINT_HOST };
+    if (process.env.SYNCPOINT_CORS_ORIGINS) {
+        const corsOrigins = process.env.SYNCPOINT_CORS_ORIGINS.split(",").map(s => s.trim());
+        config.server = { ...(config.server ?? {}), corsOrigins };
+    }
+    // Database
+    if (process.env.SYNCPOINT_DB_DIR)
+        config.database = { path: process.env.SYNCPOINT_DB_DIR };
+    if (process.env.SYNCPOINT_NO_WAL === "true")
+        config.database = { ...(config.database ?? {}), wal: false };
+    // Guard
+    if (process.env.SYNCPOINT_GUARD_MODE) {
+        const mode = GuardConfig.shape.mode.safeParse(process.env.SYNCPOINT_GUARD_MODE);
+        if (mode.success)
+            config.guard = { mode: mode.data };
+    }
+    // Constraints
+    if (process.env.SYNCPOINT_DEFAULT_POLICY) {
+        const policy = ConstraintsConfig.shape.defaultPolicy.safeParse(process.env.SYNCPOINT_DEFAULT_POLICY);
+        if (policy.success)
+            config.constraints = { defaultPolicy: policy.data };
+    }
+    // Auth
+    if (process.env.SYNCPOINT_SHARED_SECRET)
+        config.auth = { sharedSecret: process.env.SYNCPOINT_SHARED_SECRET };
+    // Log
+    if (process.env.LOG_LEVEL) {
+        const level = LogConfig.shape.level.safeParse(process.env.LOG_LEVEL);
+        if (level.success)
+            config.log = { level: level.data };
+    }
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * SyncPoint Core — public API.
+ */
+export * as KernelApi from "./_exports/kernel.js";
+export * as GovernanceApi from "./_exports/governance.js";
+export * as ContextLayerApi from "./_exports/context.js";
+export * as AdapterApi from "./_exports/adapters.js";
+export * from "../kernel/index.js";
+export * from "../governance/index.js";
+export * from "../context/index.js";
+export * from "../adapters/index.js";
+export { SyncPointConfigSchema, DatabaseConfig, ServerConfig, GuardConfig, SseConfig, ConstraintsConfig, CheckpointConfig, AuthConfig, LogConfig, DEFAULT_CONFIG, mergeConfig, configFromFile, configFromEnv, loadConfig, validateConfig, } from "./config.js";
+export type { SyncPointConfig, ConfigValidationIssue } from "./config.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../_build/src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,aAAa,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,eAAe,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,UAAU,MAAM,wBAAwB,CAAC;AAGrD,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AAGrC,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACV,SAAS,EACT,cAAc,EACd,WAAW,EACX,cAAc,EACd,aAAa,EACb,UAAU,EACV,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,15 @@
+/**
+ * SyncPoint Core — public API.
+ */
+export * as KernelApi from "./_exports/kernel.js";
+export * as GovernanceApi from "./_exports/governance.js";
+export * as ContextLayerApi from "./_exports/context.js";
+export * as AdapterApi from "./_exports/adapters.js";
+// Canonical layered surfaces
+export * from "../kernel/index.js";
+export * from "../governance/index.js";
+export * from "../context/index.js";
+export * from "../adapters/index.js";
+// Unified Config
+export { SyncPointConfigSchema, DatabaseConfig, ServerConfig, GuardConfig, SseConfig, ConstraintsConfig, CheckpointConfig, AuthConfig, LogConfig, DEFAULT_CONFIG, mergeConfig, configFromFile, configFromEnv, loadConfig, validateConfig, } from "./config.js";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../_build/src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,aAAa,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,eAAe,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,UAAU,MAAM,wBAAwB,CAAC;AAErD,6BAA6B;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AAErC,iBAAiB;AACjB,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACV,SAAS,EACT,cAAc,EACd,WAAW,EACX,cAAc,EACd,aAAa,EACb,UAAU,EACV,cAAc,GACf,MAAM,aAAa,CAAC"}

package/dist/governance/checkpoint-review.d.ts

@@ -0,0 +1,125 @@
+/**
+ * CheckpointReview — checkpoint-driven approval flow.
+ *
+ * A CheckpointReview wraps a checkpoint into a formal approval flow:
+ *
+ *   checkpoint --need-sync
+ *     → create CheckpointReview (OPEN)
+ *     → create/bind SyncGate (checkpoint_required)
+ *     → approvers ack & approve (WAITING_APPROVAL → APPROVED)
+ *     → resolve gate (→ READY_TO_CONTINUE)
+ *     → agent can resume
+ *
+ * Rejection keeps the agent blocked and requires a follow-up action.
+ *
+ * Status flow:
+ *   OPEN → WAITING_APPROVAL → APPROVED → RESOLVED
+ *                           → REJECTED → RESOLVED (after follow-up)
+ *   Any non-terminal → CANCELLED
+ */
+import { z } from "zod";
+export declare enum CheckpointReviewStatus {
+    /** Transaction created, not yet submitted for approval */
+    OPEN = "OPEN",
+    /** Waiting for required approvers to decide */
+    WAITING_APPROVAL = "WAITING_APPROVAL",
+    /** All required approvers approved */
+    APPROVED = "APPROVED",
+    /** At least one approver rejected */
+    REJECTED = "REJECTED",
+    /** Transaction resolved — gate released, agent may continue */
+    RESOLVED = "RESOLVED",
+    /** Transaction cancelled */
+    CANCELLED = "CANCELLED"
+}
+export declare const CHECKPOINT_REVIEW_TRANSITIONS: Record<CheckpointReviewStatus, CheckpointReviewStatus[]>;
+export declare function validateCheckpointReviewTransition(from: CheckpointReviewStatus, to: CheckpointReviewStatus): boolean;
+export declare const CheckpointReviewSchema: z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    taskId: z.ZodString;
+    checkpointId: z.ZodString;
+    requestingAgentId: z.ZodString;
+    /** Comma-separated agent IDs that must approve */
+    requiredApproverIds: z.ZodArray<z.ZodString, "many">;
+    /** Comma-separated agent IDs that have approved */
+    approvedByIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Comma-separated agent IDs that have rejected */
+    rejectedByIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Bound SyncGate ID (created automatically) */
+    gateId: z.ZodString;
+    status: z.ZodNativeEnum<typeof CheckpointReviewStatus>;
+    decisionSummary: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: CheckpointReviewStatus;
+    id: string;
+    taskId: string;
+    sessionId: string;
+    createdAt: string;
+    decisionSummary: string;
+    updatedAt: string;
+    gateId: string;
+    checkpointId: string;
+    requestingAgentId: string;
+    requiredApproverIds: string[];
+    approvedByIds: string[];
+    rejectedByIds: string[];
+}, {
+    status: CheckpointReviewStatus;
+    id: string;
+    taskId: string;
+    sessionId: string;
+    createdAt: string;
+    decisionSummary: string;
+    updatedAt: string;
+    gateId: string;
+    checkpointId: string;
+    requestingAgentId: string;
+    requiredApproverIds: string[];
+    approvedByIds?: string[] | undefined;
+    rejectedByIds?: string[] | undefined;
+}>;
+export type CheckpointReview = z.infer<typeof CheckpointReviewSchema>;
+export declare const CheckpointReviewCreateSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    taskId: z.ZodString;
+    checkpointId: z.ZodString;
+    requestingAgentId: z.ZodString;
+    requiredApproverIds: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    taskId: string;
+    sessionId: string;
+    checkpointId: string;
+    requestingAgentId: string;
+    requiredApproverIds: string[];
+}, {
+    taskId: string;
+    sessionId: string;
+    checkpointId: string;
+    requestingAgentId: string;
+    requiredApproverIds: string[];
+}>;
+export type CheckpointReviewCreate = z.infer<typeof CheckpointReviewCreateSchema>;
+/**
+ * Check if all required approvers have approved.
+ */
+export declare function allApproved(review: CheckpointReview): boolean;
+/**
+ * Check if any approver has rejected.
+ */
+export declare function hasRejection(review: CheckpointReview): boolean;
+/**
+ * List approvers who have not yet decided.
+ */
+export declare function pendingApprovers(review: CheckpointReview): string[];
+/**
+ * Whether the review is in a terminal state.
+ */
+export declare function isReviewTerminal(status: CheckpointReviewStatus): boolean;
+/**
+ * Whether the review is blocking (agent cannot resume).
+ */
+export declare function isReviewBlocking(status: CheckpointReviewStatus): boolean;
+//# sourceMappingURL=checkpoint-review.d.ts.map

package/dist/governance/checkpoint-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-review.d.ts","sourceRoot":"","sources":["../../_build/src/governance/checkpoint-review.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,oBAAY,sBAAsB;IAChC,0DAA0D;IAC1D,IAAI,SAAS;IACb,+CAA+C;IAC/C,gBAAgB,qBAAqB;IACrC,sCAAsC;IACtC,QAAQ,aAAa;IACrB,qCAAqC;IACrC,QAAQ,aAAa;IACrB,+DAA+D;IAC/D,QAAQ,aAAa;IACrB,4BAA4B;IAC5B,SAAS,cAAc;CACxB;AAID,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,sBAAsB,EAAE,sBAAsB,EAAE,CAoBlG,CAAC;AAEF,wBAAgB,kCAAkC,CAAC,IAAI,EAAE,sBAAsB,EAAE,EAAE,EAAE,sBAAsB,GAAG,OAAO,CAEpH;AAID,eAAO,MAAM,sBAAsB;;;;;;IAMjC,kDAAkD;;IAElD,mDAAmD;;IAEnD,mDAAmD;;IAEnD,gDAAgD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMhD,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;EAMvC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAIlF;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAG7D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAE9D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAGnE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAExE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAMxE"}

package/dist/governance/checkpoint-review.js

@@ -0,0 +1,124 @@
+/**
+ * CheckpointReview — checkpoint-driven approval flow.
+ *
+ * A CheckpointReview wraps a checkpoint into a formal approval flow:
+ *
+ *   checkpoint --need-sync
+ *     → create CheckpointReview (OPEN)
+ *     → create/bind SyncGate (checkpoint_required)
+ *     → approvers ack & approve (WAITING_APPROVAL → APPROVED)
+ *     → resolve gate (→ READY_TO_CONTINUE)
+ *     → agent can resume
+ *
+ * Rejection keeps the agent blocked and requires a follow-up action.
+ *
+ * Status flow:
+ *   OPEN → WAITING_APPROVAL → APPROVED → RESOLVED
+ *                           → REJECTED → RESOLVED (after follow-up)
+ *   Any non-terminal → CANCELLED
+ */
+import { z } from "zod";
+// ── Status ──────────────────────────────────────────
+export var CheckpointReviewStatus;
+(function (CheckpointReviewStatus) {
+    /** Transaction created, not yet submitted for approval */
+    CheckpointReviewStatus["OPEN"] = "OPEN";
+    /** Waiting for required approvers to decide */
+    CheckpointReviewStatus["WAITING_APPROVAL"] = "WAITING_APPROVAL";
+    /** All required approvers approved */
+    CheckpointReviewStatus["APPROVED"] = "APPROVED";
+    /** At least one approver rejected */
+    CheckpointReviewStatus["REJECTED"] = "REJECTED";
+    /** Transaction resolved — gate released, agent may continue */
+    CheckpointReviewStatus["RESOLVED"] = "RESOLVED";
+    /** Transaction cancelled */
+    CheckpointReviewStatus["CANCELLED"] = "CANCELLED";
+})(CheckpointReviewStatus || (CheckpointReviewStatus = {}));
+// ── Transitions ─────────────────────────────────────
+export const CHECKPOINT_REVIEW_TRANSITIONS = {
+    [CheckpointReviewStatus.OPEN]: [
+        CheckpointReviewStatus.WAITING_APPROVAL,
+        CheckpointReviewStatus.CANCELLED,
+    ],
+    [CheckpointReviewStatus.WAITING_APPROVAL]: [
+        CheckpointReviewStatus.APPROVED,
+        CheckpointReviewStatus.REJECTED,
+        CheckpointReviewStatus.CANCELLED,
+    ],
+    [CheckpointReviewStatus.APPROVED]: [
+        CheckpointReviewStatus.RESOLVED,
+        CheckpointReviewStatus.CANCELLED,
+    ],
+    [CheckpointReviewStatus.REJECTED]: [
+        CheckpointReviewStatus.RESOLVED,
+        CheckpointReviewStatus.CANCELLED,
+    ],
+    [CheckpointReviewStatus.RESOLVED]: [],
+    [CheckpointReviewStatus.CANCELLED]: [],
+};
+export function validateCheckpointReviewTransition(from, to) {
+    return CHECKPOINT_REVIEW_TRANSITIONS[from]?.includes(to) ?? false;
+}
+// ── Schema ──────────────────────────────────────────
+export const CheckpointReviewSchema = z.object({
+    id: z.string(),
+    sessionId: z.string(),
+    taskId: z.string(),
+    checkpointId: z.string(),
+    requestingAgentId: z.string(),
+    /** Comma-separated agent IDs that must approve */
+    requiredApproverIds: z.array(z.string()).min(1),
+    /** Comma-separated agent IDs that have approved */
+    approvedByIds: z.array(z.string()).default([]),
+    /** Comma-separated agent IDs that have rejected */
+    rejectedByIds: z.array(z.string()).default([]),
+    /** Bound SyncGate ID (created automatically) */
+    gateId: z.string(),
+    status: z.nativeEnum(CheckpointReviewStatus),
+    decisionSummary: z.string(),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+});
+export const CheckpointReviewCreateSchema = z.object({
+    sessionId: z.string(),
+    taskId: z.string(),
+    checkpointId: z.string(),
+    requestingAgentId: z.string(),
+    requiredApproverIds: z.array(z.string()).min(1),
+});
+// ── Pure helpers ────────────────────────────────────
+/**
+ * Check if all required approvers have approved.
+ */
+export function allApproved(review) {
+    const approved = new Set(review.approvedByIds);
+    return review.requiredApproverIds.length > 0 && review.requiredApproverIds.every(id => approved.has(id));
+}
+/**
+ * Check if any approver has rejected.
+ */
+export function hasRejection(review) {
+    return review.rejectedByIds.length > 0;
+}
+/**
+ * List approvers who have not yet decided.
+ */
+export function pendingApprovers(review) {
+    const decided = new Set([...review.approvedByIds, ...review.rejectedByIds]);
+    return review.requiredApproverIds.filter(id => !decided.has(id));
+}
+/**
+ * Whether the review is in a terminal state.
+ */
+export function isReviewTerminal(status) {
+    return CHECKPOINT_REVIEW_TRANSITIONS[status].length === 0;
+}
+/**
+ * Whether the review is blocking (agent cannot resume).
+ */
+export function isReviewBlocking(status) {
+    return (status === CheckpointReviewStatus.OPEN ||
+        status === CheckpointReviewStatus.WAITING_APPROVAL ||
+        status === CheckpointReviewStatus.REJECTED);
+}
+//# sourceMappingURL=checkpoint-review.js.map

package/dist/governance/checkpoint-review.js.map

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