syncpoint-ai 0.1.0

package/dist/kernel/errors.js

@@ -0,0 +1,194 @@
+/**
+ * SyncPoint structured error hierarchy.
+ *
+ * Every SyncPoint error has a machine-readable code, a user-facing
+ * message, an HTTP status code for API responses, and a retryability
+ * flag for automatic recovery logic.
+ *
+ * Usage:
+ *   throw new ResourceConflictError("src/auth.ts", "agent-3");
+ *
+ * In tRPC error formatter:
+ *   if (err instanceof SyncPointError) {
+ *     return { code: err.code, message: err.userMessage, ... };
+ *   }
+ */
+// ── Base ───────────────────────────────────────────────
+export class SyncPointError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = this.constructor.name;
+    }
+}
+// ── Resource errors (4xx) ──────────────────────────────
+export class ResourceConflictError extends SyncPointError {
+    resourcePath;
+    claimedBy;
+    code = "RESOURCE_CONFLICT";
+    httpStatus = 409;
+    retryable = true;
+    suggestion;
+    constructor(resourcePath, claimedBy) {
+        super(`Resource "${resourcePath}" is already claimed by ${claimedBy}`);
+        this.resourcePath = resourcePath;
+        this.claimedBy = claimedBy;
+        this.suggestion = "Try narrowing your claim scope (e.g., from file to function) or wait for the other agent to release.";
+    }
+    get userMessage() {
+        return `Resource "${this.resourcePath}" is already locked by ${this.claimedBy}`;
+    }
+}
+export class ResourceNotFoundError extends SyncPointError {
+    resourceId;
+    code = "RESOURCE_NOT_FOUND";
+    httpStatus = 404;
+    retryable = false;
+    suggestion = "Check the resource identifier and try again.";
+    constructor(resourceId) {
+        super(`Resource "${resourceId}" not found`);
+        this.resourceId = resourceId;
+    }
+    get userMessage() {
+        return `Resource "${this.resourceId}" was not found`;
+    }
+}
+// ── Constraint errors (4xx) ────────────────────────────
+export class ConstraintViolationError extends SyncPointError {
+    violatedRules;
+    resourcePath;
+    code = "CONSTRAINT_VIOLATION";
+    httpStatus = 403;
+    retryable = false;
+    suggestion;
+    constructor(violatedRules, resourcePath) {
+        const rules = violatedRules.join(", ");
+        super(`Constraint violation: ${rules} for "${resourcePath}"`);
+        this.violatedRules = violatedRules;
+        this.resourcePath = resourcePath;
+        this.suggestion = "Review the constraint rules and adjust your changes, or request a constraint exemption.";
+    }
+    get userMessage() {
+        return `Operation blocked by constraints: ${this.violatedRules.join(", ")}`;
+    }
+}
+// ── Authentication / Authorization errors (4xx) ────────
+export class UnauthorizedError extends SyncPointError {
+    code = "UNAUTHORIZED";
+    httpStatus = 401;
+    retryable = false;
+    suggestion = "Provide a valid x-caller-id header or agent token.";
+    constructor() {
+        super("Authentication required");
+    }
+    get userMessage() {
+        return "Authentication required — please provide your agent identity";
+    }
+}
+export class ForbiddenError extends SyncPointError {
+    operation;
+    reason;
+    code = "FORBIDDEN";
+    httpStatus = 403;
+    retryable = false;
+    suggestion;
+    constructor(operation, reason) {
+        super(`Forbidden: ${operation}${reason ? ` — ${reason}` : ""}`);
+        this.operation = operation;
+        this.reason = reason;
+        this.suggestion = "You do not have permission for this operation. Contact the project admin.";
+    }
+    get userMessage() {
+        return `Operation "${this.operation}" is not allowed for your role`;
+    }
+}
+// ── State errors (4xx) ─────────────────────────────────
+export class InvalidStateTransitionError extends SyncPointError {
+    entity;
+    fromState;
+    toState;
+    code = "INVALID_STATE_TRANSITION";
+    httpStatus = 409;
+    retryable = false;
+    suggestion;
+    constructor(entity, fromState, toState) {
+        super(`Invalid ${entity} transition: ${fromState} → ${toState}`);
+        this.entity = entity;
+        this.fromState = fromState;
+        this.toState = toState;
+        this.suggestion = `Check if the entity has already been transitioned by another operation. Refresh the current state and retry.`;
+    }
+    get userMessage() {
+        return `Cannot change "${this.entity}" from ${this.fromState} to ${this.toState}`;
+    }
+}
+// ── Validation errors (4xx) ────────────────────────────
+export class ValidationError extends SyncPointError {
+    field;
+    issue;
+    code = "VALIDATION_ERROR";
+    httpStatus = 400;
+    retryable = false;
+    suggestion;
+    constructor(field, issue) {
+        super(`Validation error: ${field} — ${issue}`);
+        this.field = field;
+        this.issue = issue;
+        this.suggestion = `Fix the "${this.field}" field and retry.`;
+    }
+    get userMessage() {
+        return `Invalid value for "${this.field}": ${this.issue}`;
+    }
+}
+// ── Database errors (5xx) ──────────────────────────────
+export class DatabaseError extends SyncPointError {
+    operation;
+    cause;
+    code = "DATABASE_ERROR";
+    httpStatus = 500;
+    retryable = true;
+    suggestion = "The operation may succeed if retried. If the problem persists, check the database integrity.";
+    constructor(operation, cause) {
+        const msg = cause instanceof Error ? cause.message : String(cause ?? "unknown error");
+        super(`Database error during ${operation}: ${msg}`);
+        this.operation = operation;
+        this.cause = cause;
+    }
+    get userMessage() {
+        return "An internal database error occurred. The operation may be retried.";
+    }
+}
+// ── Timeout errors (5xx) ───────────────────────────────
+export class OperationTimeoutError extends SyncPointError {
+    operation;
+    timeoutMs;
+    code = "OPERATION_TIMEOUT";
+    httpStatus = 504;
+    retryable = true;
+    suggestion;
+    constructor(operation, timeoutMs) {
+        super(`Operation "${operation}" timed out after ${timeoutMs}ms`);
+        this.operation = operation;
+        this.timeoutMs = timeoutMs;
+        this.suggestion = "Increase the timeout or split the operation into smaller steps.";
+    }
+    get userMessage() {
+        return `Operation "${this.operation}" timed out`;
+    }
+}
+// ── Internal errors (5xx) ──────────────────────────────
+export class InternalError extends SyncPointError {
+    cause;
+    code = "INTERNAL_ERROR";
+    httpStatus = 500;
+    retryable = false;
+    suggestion = "Please report this error to the SyncPoint maintainers.";
+    constructor(cause) {
+        const msg = cause instanceof Error ? cause.message : String(cause ?? "unknown error");
+        super(`Internal error: ${msg}`);
+        this.cause = cause;
+    }
+    get userMessage() {
+        return "An unexpected internal error occurred";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/kernel/errors.js.map

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

package/dist/kernel/events.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Kernel events — EventType enum, Event schema, and Event type.
+ *
+ * These are minimal coordination primitives used by every layer.
+ * Physically hosted in kernel since Phase 3.
+ */
+import { z } from "zod";
+export declare enum EventType {
+    AGENT_REGISTERED = "AGENT_REGISTERED",
+    AGENT_STATUS_CHANGED = "AGENT_STATUS_CHANGED",
+    TASK_CREATED = "TASK_CREATED",
+    TASK_ASSIGNED = "TASK_ASSIGNED",
+    TASK_STATUS_CHANGED = "TASK_STATUS_CHANGED",
+    CHECKPOINT_CREATED = "CHECKPOINT_CREATED",
+    HANDOFF_INITIATED = "HANDOFF_INITIATED",
+    HANDOFF_ACCEPTED = "HANDOFF_ACCEPTED",
+    HANDOFF_REJECTED = "HANDOFF_REJECTED",
+    DIARY_ENTRY_CREATED = "DIARY_ENTRY_CREATED",
+    PEER_KICKOFF = "PEER_KICKOFF",
+    CONTRACT_DRAFTED = "CONTRACT_DRAFTED",
+    CONTRACT_REVIEW_REQUESTED = "CONTRACT_REVIEW_REQUESTED",
+    CONTRACT_APPROVED = "CONTRACT_APPROVED",
+    CONTRACT_REJECTED = "CONTRACT_REJECTED",
+    CONTRACT_UPDATED = "CONTRACT_UPDATED",
+    WORK_STARTED = "WORK_STARTED",
+    CHECKPOINT_SYNC = "CHECKPOINT_SYNC",
+    CONFLICT_DETECTED = "CONFLICT_DETECTED",
+    CONTEXT_SNAPSHOT_CREATED = "CONTEXT_SNAPSHOT_CREATED",
+    PROJECT_MEMORY_CREATED = "PROJECT_MEMORY_CREATED",
+    PROJECT_MEMORY_APPROVED = "PROJECT_MEMORY_APPROVED",
+    PROJECT_MEMORY_DEPRECATED = "PROJECT_MEMORY_DEPRECATED",
+    PROJECT_MEMORY_UPDATED = "PROJECT_MEMORY_UPDATED",
+    SESSION_CREATED = "SESSION_CREATED",
+    SESSION_ADVANCED = "SESSION_ADVANCED",
+    SESSION_CANCELLED = "SESSION_CANCELLED",
+    ROLE_ASSIGNED = "ROLE_ASSIGNED",
+    ASSIGNMENT_CREATED = "ASSIGNMENT_CREATED",
+    ASSIGNMENT_ACCEPTED = "ASSIGNMENT_ACCEPTED",
+    ASSIGNMENT_STARTED = "ASSIGNMENT_STARTED",
+    ASSIGNMENT_COMPLETED = "ASSIGNMENT_COMPLETED",
+    REVIEW_REQUESTED = "REVIEW_REQUESTED",
+    REVIEW_STARTED = "REVIEW_STARTED",
+    REVIEW_DECIDED = "REVIEW_DECIDED",
+    REVIEW_APPROVED = "REVIEW_APPROVED",
+    REVIEW_BLOCKED = "REVIEW_BLOCKED",
+    WAKE_CREATED = "WAKE_CREATED",
+    WAKE_DISPATCHED = "WAKE_DISPATCHED",
+    WAKE_DONE = "WAKE_DONE",
+    WAKE_FAILED = "WAKE_FAILED",
+    RESOURCE_CLAIMED = "RESOURCE_CLAIMED",
+    RESOURCE_RELEASED = "RESOURCE_RELEASED",
+    RESOURCE_CONFLICT_DETECTED = "RESOURCE_CONFLICT_DETECTED",
+    FILE_CHANGED = "FILE_CHANGED",
+    FILE_AUDIT_ALERT = "FILE_AUDIT_ALERT",
+    FILE_POLLUTION_DETECTED = "FILE_POLLUTION_DETECTED",
+    SYNC_GATE_CREATED = "SYNC_GATE_CREATED",
+    SYNC_GATE_REQUESTED = "SYNC_GATE_REQUESTED",
+    SYNC_GATE_ACKED = "SYNC_GATE_ACKED",
+    SYNC_GATE_RESOLVED = "SYNC_GATE_RESOLVED",
+    SYNC_GATE_CANCELLED = "SYNC_GATE_CANCELLED",
+    SYNC_TX_CREATED = "SYNC_TX_CREATED",
+    SYNC_TX_SUBMITTED = "SYNC_TX_SUBMITTED",
+    SYNC_TX_APPROVED = "SYNC_TX_APPROVED",
+    SYNC_TX_REJECTED = "SYNC_TX_REJECTED",
+    SYNC_TX_RESOLVED = "SYNC_TX_RESOLVED",
+    SYNC_TX_CANCELLED = "SYNC_TX_CANCELLED",
+    OPERATION_CREATED = "OPERATION_CREATED",
+    OPERATION_SUBMITTED = "OPERATION_SUBMITTED",
+    OPERATION_CHECKED = "OPERATION_CHECKED",
+    OPERATION_APPROVED = "OPERATION_APPROVED",
+    OPERATION_REJECTED = "OPERATION_REJECTED",
+    OPERATION_APPLIED = "OPERATION_APPLIED",
+    OPERATION_CANCELLED = "OPERATION_CANCELLED",
+    WRITE_PERMIT_REQUESTED = "WRITE_PERMIT_REQUESTED",
+    WRITE_PERMIT_ISSUED = "WRITE_PERMIT_ISSUED",
+    WRITE_PERMIT_DENIED = "WRITE_PERMIT_DENIED",
+    WRITE_PERMIT_CONSUMED = "WRITE_PERMIT_CONSUMED",
+    WRITE_PERMIT_REVOKED = "WRITE_PERMIT_REVOKED",
+    WRITE_BLOCKED = "WRITE_BLOCKED",
+    WRITE_STAGED = "WRITE_STAGED",
+    WRITE_APPLIED = "WRITE_APPLIED",
+    BACKING_STORE_BYPASS_DETECTED = "BACKING_STORE_BYPASS_DETECTED",
+    AGENT_MESSAGE_SENT = "AGENT_MESSAGE_SENT",
+    AGENT_MESSAGE_READ = "AGENT_MESSAGE_READ",
+    AGENT_MESSAGE_REPLIED = "AGENT_MESSAGE_REPLIED",
+    AGENT_MESSAGE_REMINDER = "AGENT_MESSAGE_REMINDER",
+    AGENT_MESSAGE_ESCALATED = "AGENT_MESSAGE_ESCALATED",
+    ARBITRATION_SESSION_STARTED = "ARBITRATION_SESSION_STARTED",
+    ARBITRATION_VOTE_CAST = "ARBITRATION_VOTE_CAST",
+    ARBITRATION_RESOLVED = "ARBITRATION_RESOLVED",
+    GUARD_SESSION_CREATED = "GUARD_SESSION_CREATED",
+    GUARD_ENGAGED = "GUARD_ENGAGED",
+    GUARD_DISENGAGED = "GUARD_DISENGAGED",
+    GUARD_VIOLATION = "GUARD_VIOLATION"
+}
+export declare const EventSchema: z.ZodObject<{
+    id: z.ZodString;
+    eventType: z.ZodNativeEnum<typeof EventType>;
+    entityType: z.ZodEnum<["agent", "task", "checkpoint", "handoff", "contract", "context_snapshot", "diary", "agent_message"]>;
+    entityId: z.ZodString;
+    detail: z.ZodDefault<z.ZodString>;
+    createdAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    createdAt: string;
+    detail: string;
+    eventType: EventType;
+    entityType: "agent" | "task" | "checkpoint" | "handoff" | "contract" | "context_snapshot" | "diary" | "agent_message";
+    entityId: string;
+}, {
+    id: string;
+    createdAt: string;
+    eventType: EventType;
+    entityType: "agent" | "task" | "checkpoint" | "handoff" | "contract" | "context_snapshot" | "diary" | "agent_message";
+    entityId: string;
+    detail?: string | undefined;
+}>;
+export type Event = z.infer<typeof EventSchema>;
+//# sourceMappingURL=events.d.ts.map

package/dist/kernel/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../_build/src/kernel/events.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,oBAAY,SAAS;IAEnB,gBAAgB,qBAAqB;IACrC,oBAAoB,yBAAyB;IAE7C,YAAY,iBAAiB;IAC7B,aAAa,kBAAkB;IAC/B,mBAAmB,wBAAwB;IAE3C,kBAAkB,uBAAuB;IAEzC,iBAAiB,sBAAsB;IACvC,gBAAgB,qBAAqB;IACrC,gBAAgB,qBAAqB;IAErC,mBAAmB,wBAAwB;IAE3C,YAAY,iBAAiB;IAC7B,gBAAgB,qBAAqB;IACrC,yBAAyB,8BAA8B;IACvD,iBAAiB,sBAAsB;IACvC,iBAAiB,sBAAsB;IACvC,gBAAgB,qBAAqB;IACrC,YAAY,iBAAiB;IAC7B,eAAe,oBAAoB;IACnC,iBAAiB,sBAAsB;IAEvC,wBAAwB,6BAA6B;IAErD,sBAAsB,2BAA2B;IACjD,uBAAuB,4BAA4B;IACnD,yBAAyB,8BAA8B;IACvD,sBAAsB,2BAA2B;IAEjD,eAAe,oBAAoB;IACnC,gBAAgB,qBAAqB;IACrC,iBAAiB,sBAAsB;IACvC,aAAa,kBAAkB;IAC/B,kBAAkB,uBAAuB;IACzC,mBAAmB,wBAAwB;IAC3C,kBAAkB,uBAAuB;IACzC,oBAAoB,yBAAyB;IAC7C,gBAAgB,qBAAqB;IACrC,cAAc,mBAAmB;IACjC,cAAc,mBAAmB;IACjC,eAAe,oBAAoB;IACnC,cAAc,mBAAmB;IAEjC,YAAY,iBAAiB;IAC7B,eAAe,oBAAoB;IACnC,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAE3B,gBAAgB,qBAAqB;IACrC,iBAAiB,sBAAsB;IACvC,0BAA0B,+BAA+B;IACzD,YAAY,iBAAiB;IAC7B,gBAAgB,qBAAqB;IACrC,uBAAuB,4BAA4B;IAEnD,iBAAiB,sBAAsB;IACvC,mBAAmB,wBAAwB;IAC3C,eAAe,oBAAoB;IACnC,kBAAkB,uBAAuB;IACzC,mBAAmB,wBAAwB;IAE3C,eAAe,oBAAoB;IACnC,iBAAiB,sBAAsB;IACvC,gBAAgB,qBAAqB;IACrC,gBAAgB,qBAAqB;IACrC,gBAAgB,qBAAqB;IACrC,iBAAiB,sBAAsB;IAEvC,iBAAiB,sBAAsB;IACvC,mBAAmB,wBAAwB;IAC3C,iBAAiB,sBAAsB;IACvC,kBAAkB,uBAAuB;IACzC,kBAAkB,uBAAuB;IACzC,iBAAiB,sBAAsB;IACvC,mBAAmB,wBAAwB;IAC3C,sBAAsB,2BAA2B;IACjD,mBAAmB,wBAAwB;IAC3C,mBAAmB,wBAAwB;IAC3C,qBAAqB,0BAA0B;IAC/C,oBAAoB,yBAAyB;IAC7C,aAAa,kBAAkB;IAC/B,YAAY,iBAAiB;IAC7B,aAAa,kBAAkB;IAC/B,6BAA6B,kCAAkC;IAE/D,kBAAkB,uBAAuB;IACzC,kBAAkB,uBAAuB;IACzC,qBAAqB,0BAA0B;IAC/C,sBAAsB,2BAA2B;IACjD,uBAAuB,4BAA4B;IAEnD,2BAA2B,gCAAgC;IAC3D,qBAAqB,0BAA0B;IAC/C,oBAAoB,yBAAyB;IAE7C,qBAAqB,0BAA0B;IAC/C,aAAa,kBAAkB;IAC/B,gBAAgB,qBAAqB;IACrC,eAAe,oBAAoB;CACpC;AAID,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;EAOtB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/kernel/events.js

@@ -0,0 +1,127 @@
+/**
+ * Kernel events — EventType enum, Event schema, and Event type.
+ *
+ * These are minimal coordination primitives used by every layer.
+ * Physically hosted in kernel since Phase 3.
+ */
+import { z } from "zod";
+// ── Helpers ──────────────────────────────────────────
+const nanoid12 = z.string().min(1).max(24);
+const isoDate = z.string().datetime({ offset: true });
+// ── EventType ────────────────────────────────────────
+export var EventType;
+(function (EventType) {
+    // Agent
+    EventType["AGENT_REGISTERED"] = "AGENT_REGISTERED";
+    EventType["AGENT_STATUS_CHANGED"] = "AGENT_STATUS_CHANGED";
+    // Task
+    EventType["TASK_CREATED"] = "TASK_CREATED";
+    EventType["TASK_ASSIGNED"] = "TASK_ASSIGNED";
+    EventType["TASK_STATUS_CHANGED"] = "TASK_STATUS_CHANGED";
+    // Checkpoint
+    EventType["CHECKPOINT_CREATED"] = "CHECKPOINT_CREATED";
+    // Handoff
+    EventType["HANDOFF_INITIATED"] = "HANDOFF_INITIATED";
+    EventType["HANDOFF_ACCEPTED"] = "HANDOFF_ACCEPTED";
+    EventType["HANDOFF_REJECTED"] = "HANDOFF_REJECTED";
+    // Diary
+    EventType["DIARY_ENTRY_CREATED"] = "DIARY_ENTRY_CREATED";
+    // Contract
+    EventType["PEER_KICKOFF"] = "PEER_KICKOFF";
+    EventType["CONTRACT_DRAFTED"] = "CONTRACT_DRAFTED";
+    EventType["CONTRACT_REVIEW_REQUESTED"] = "CONTRACT_REVIEW_REQUESTED";
+    EventType["CONTRACT_APPROVED"] = "CONTRACT_APPROVED";
+    EventType["CONTRACT_REJECTED"] = "CONTRACT_REJECTED";
+    EventType["CONTRACT_UPDATED"] = "CONTRACT_UPDATED";
+    EventType["WORK_STARTED"] = "WORK_STARTED";
+    EventType["CHECKPOINT_SYNC"] = "CHECKPOINT_SYNC";
+    EventType["CONFLICT_DETECTED"] = "CONFLICT_DETECTED";
+    // Context Snapshot
+    EventType["CONTEXT_SNAPSHOT_CREATED"] = "CONTEXT_SNAPSHOT_CREATED";
+    // Project Memory
+    EventType["PROJECT_MEMORY_CREATED"] = "PROJECT_MEMORY_CREATED";
+    EventType["PROJECT_MEMORY_APPROVED"] = "PROJECT_MEMORY_APPROVED";
+    EventType["PROJECT_MEMORY_DEPRECATED"] = "PROJECT_MEMORY_DEPRECATED";
+    EventType["PROJECT_MEMORY_UPDATED"] = "PROJECT_MEMORY_UPDATED";
+    // Orchestration (used by Wake Engine)
+    EventType["SESSION_CREATED"] = "SESSION_CREATED";
+    EventType["SESSION_ADVANCED"] = "SESSION_ADVANCED";
+    EventType["SESSION_CANCELLED"] = "SESSION_CANCELLED";
+    EventType["ROLE_ASSIGNED"] = "ROLE_ASSIGNED";
+    EventType["ASSIGNMENT_CREATED"] = "ASSIGNMENT_CREATED";
+    EventType["ASSIGNMENT_ACCEPTED"] = "ASSIGNMENT_ACCEPTED";
+    EventType["ASSIGNMENT_STARTED"] = "ASSIGNMENT_STARTED";
+    EventType["ASSIGNMENT_COMPLETED"] = "ASSIGNMENT_COMPLETED";
+    EventType["REVIEW_REQUESTED"] = "REVIEW_REQUESTED";
+    EventType["REVIEW_STARTED"] = "REVIEW_STARTED";
+    EventType["REVIEW_DECIDED"] = "REVIEW_DECIDED";
+    EventType["REVIEW_APPROVED"] = "REVIEW_APPROVED";
+    EventType["REVIEW_BLOCKED"] = "REVIEW_BLOCKED";
+    // Wake
+    EventType["WAKE_CREATED"] = "WAKE_CREATED";
+    EventType["WAKE_DISPATCHED"] = "WAKE_DISPATCHED";
+    EventType["WAKE_DONE"] = "WAKE_DONE";
+    EventType["WAKE_FAILED"] = "WAKE_FAILED";
+    // ResourceClaim (generic)
+    EventType["RESOURCE_CLAIMED"] = "RESOURCE_CLAIMED";
+    EventType["RESOURCE_RELEASED"] = "RESOURCE_RELEASED";
+    EventType["RESOURCE_CONFLICT_DETECTED"] = "RESOURCE_CONFLICT_DETECTED";
+    EventType["FILE_CHANGED"] = "FILE_CHANGED";
+    EventType["FILE_AUDIT_ALERT"] = "FILE_AUDIT_ALERT";
+    EventType["FILE_POLLUTION_DETECTED"] = "FILE_POLLUTION_DETECTED";
+    // SyncGate
+    EventType["SYNC_GATE_CREATED"] = "SYNC_GATE_CREATED";
+    EventType["SYNC_GATE_REQUESTED"] = "SYNC_GATE_REQUESTED";
+    EventType["SYNC_GATE_ACKED"] = "SYNC_GATE_ACKED";
+    EventType["SYNC_GATE_RESOLVED"] = "SYNC_GATE_RESOLVED";
+    EventType["SYNC_GATE_CANCELLED"] = "SYNC_GATE_CANCELLED";
+    // CheckpointReview
+    EventType["SYNC_TX_CREATED"] = "SYNC_TX_CREATED";
+    EventType["SYNC_TX_SUBMITTED"] = "SYNC_TX_SUBMITTED";
+    EventType["SYNC_TX_APPROVED"] = "SYNC_TX_APPROVED";
+    EventType["SYNC_TX_REJECTED"] = "SYNC_TX_REJECTED";
+    EventType["SYNC_TX_RESOLVED"] = "SYNC_TX_RESOLVED";
+    EventType["SYNC_TX_CANCELLED"] = "SYNC_TX_CANCELLED";
+    // Operation (generic)
+    EventType["OPERATION_CREATED"] = "OPERATION_CREATED";
+    EventType["OPERATION_SUBMITTED"] = "OPERATION_SUBMITTED";
+    EventType["OPERATION_CHECKED"] = "OPERATION_CHECKED";
+    EventType["OPERATION_APPROVED"] = "OPERATION_APPROVED";
+    EventType["OPERATION_REJECTED"] = "OPERATION_REJECTED";
+    EventType["OPERATION_APPLIED"] = "OPERATION_APPLIED";
+    EventType["OPERATION_CANCELLED"] = "OPERATION_CANCELLED";
+    EventType["WRITE_PERMIT_REQUESTED"] = "WRITE_PERMIT_REQUESTED";
+    EventType["WRITE_PERMIT_ISSUED"] = "WRITE_PERMIT_ISSUED";
+    EventType["WRITE_PERMIT_DENIED"] = "WRITE_PERMIT_DENIED";
+    EventType["WRITE_PERMIT_CONSUMED"] = "WRITE_PERMIT_CONSUMED";
+    EventType["WRITE_PERMIT_REVOKED"] = "WRITE_PERMIT_REVOKED";
+    EventType["WRITE_BLOCKED"] = "WRITE_BLOCKED";
+    EventType["WRITE_STAGED"] = "WRITE_STAGED";
+    EventType["WRITE_APPLIED"] = "WRITE_APPLIED";
+    EventType["BACKING_STORE_BYPASS_DETECTED"] = "BACKING_STORE_BYPASS_DETECTED";
+    // Agent Message
+    EventType["AGENT_MESSAGE_SENT"] = "AGENT_MESSAGE_SENT";
+    EventType["AGENT_MESSAGE_READ"] = "AGENT_MESSAGE_READ";
+    EventType["AGENT_MESSAGE_REPLIED"] = "AGENT_MESSAGE_REPLIED";
+    EventType["AGENT_MESSAGE_REMINDER"] = "AGENT_MESSAGE_REMINDER";
+    EventType["AGENT_MESSAGE_ESCALATED"] = "AGENT_MESSAGE_ESCALATED";
+    // Arbitration
+    EventType["ARBITRATION_SESSION_STARTED"] = "ARBITRATION_SESSION_STARTED";
+    EventType["ARBITRATION_VOTE_CAST"] = "ARBITRATION_VOTE_CAST";
+    EventType["ARBITRATION_RESOLVED"] = "ARBITRATION_RESOLVED";
+    // Guard
+    EventType["GUARD_SESSION_CREATED"] = "GUARD_SESSION_CREATED";
+    EventType["GUARD_ENGAGED"] = "GUARD_ENGAGED";
+    EventType["GUARD_DISENGAGED"] = "GUARD_DISENGAGED";
+    EventType["GUARD_VIOLATION"] = "GUARD_VIOLATION";
+})(EventType || (EventType = {}));
+// ── Event Schema ─────────────────────────────────────
+export const EventSchema = z.object({
+    id: nanoid12,
+    eventType: z.nativeEnum(EventType),
+    entityType: z.enum(["agent", "task", "checkpoint", "handoff", "contract", "context_snapshot", "diary", "agent_message"]),
+    entityId: nanoid12,
+    detail: z.string().default(""),
+    createdAt: isoDate,
+});
+//# sourceMappingURL=events.js.map

package/dist/kernel/events.js.map

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

package/dist/kernel/file-audit.d.ts

@@ -0,0 +1,31 @@
+import type { ResourceClaim, ResourceRef } from "./resource.js";
+export declare enum FileAuditDecisionKind {
+    FILE_CHANGED = "file_changed",
+    CLAIMED_WRITE = "claimed_write",
+    FILE_POLLUTION_DETECTED = "file_pollution_detected",
+    FILE_AUDIT_ALERT = "file_audit_alert"
+}
+export interface FileAuditGateContext {
+    id: string;
+    relatedFiles?: string[];
+    relatedResources?: ResourceRef[];
+}
+export interface FileAuditInput {
+    actorId: string;
+    changedResource: ResourceRef;
+    activeClaims: ResourceClaim[];
+    blockingGates?: FileAuditGateContext[];
+}
+export interface FileAuditDecision {
+    kind: FileAuditDecisionKind;
+    changedResource: ResourceRef;
+    ownClaims: ResourceClaim[];
+    conflictingClaims: ResourceClaim[];
+    relatedBlockingGateIds: string[];
+    shouldCreateGate: boolean;
+}
+export declare function evaluateFileAuditChange(input: FileAuditInput): FileAuditDecision;
+export declare function findMatchingClaims(claims: ResourceClaim[], resource: ResourceRef): ResourceClaim[];
+export declare function gateMatchesResource(gate: FileAuditGateContext, resource: ResourceRef): boolean;
+export declare function parseRelatedFileLocators(value: string[]): string[];
+//# sourceMappingURL=file-audit.d.ts.map

package/dist/kernel/file-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-audit.d.ts","sourceRoot":"","sources":["../../_build/src/kernel/file-audit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEhE,oBAAY,qBAAqB;IAC/B,YAAY,iBAAiB;IAC7B,aAAa,kBAAkB;IAC/B,uBAAuB,4BAA4B;IACnD,gBAAgB,qBAAqB;CACtC;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,CAAC,EAAE,WAAW,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,WAAW,CAAC;IAC7B,YAAY,EAAE,aAAa,EAAE,CAAC;IAC9B,aAAa,CAAC,EAAE,oBAAoB,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,eAAe,EAAE,WAAW,CAAC;IAC7B,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,iBAAiB,EAAE,aAAa,EAAE,CAAC;IACnC,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,cAAc,GAAG,iBAAiB,CAwChF;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,QAAQ,EAAE,WAAW,GAAG,aAAa,EAAE,CAIlG;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAO9F;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAKlE"}

package/dist/kernel/file-audit.js

@@ -0,0 +1,61 @@
+import { resourceLocatorsOverlap, ResourceClaimMode } from "./resource.js";
+export var FileAuditDecisionKind;
+(function (FileAuditDecisionKind) {
+    FileAuditDecisionKind["FILE_CHANGED"] = "file_changed";
+    FileAuditDecisionKind["CLAIMED_WRITE"] = "claimed_write";
+    FileAuditDecisionKind["FILE_POLLUTION_DETECTED"] = "file_pollution_detected";
+    FileAuditDecisionKind["FILE_AUDIT_ALERT"] = "file_audit_alert";
+})(FileAuditDecisionKind || (FileAuditDecisionKind = {}));
+export function evaluateFileAuditChange(input) {
+    const matchingClaims = findMatchingClaims(input.activeClaims, input.changedResource);
+    const ownClaims = matchingClaims.filter(claim => claim.actorId === input.actorId);
+    const conflictingClaims = matchingClaims.filter(claim => claim.actorId !== input.actorId && claim.mode === ResourceClaimMode.EXCLUSIVE);
+    const relatedBlockingGateIds = (input.blockingGates ?? [])
+        .filter(gate => gateMatchesResource(gate, input.changedResource))
+        .map(gate => gate.id);
+    if (relatedBlockingGateIds.length > 0) {
+        return {
+            kind: FileAuditDecisionKind.FILE_AUDIT_ALERT,
+            changedResource: input.changedResource,
+            ownClaims,
+            conflictingClaims,
+            relatedBlockingGateIds,
+            shouldCreateGate: false,
+        };
+    }
+    if (conflictingClaims.length > 0) {
+        return {
+            kind: FileAuditDecisionKind.FILE_POLLUTION_DETECTED,
+            changedResource: input.changedResource,
+            ownClaims,
+            conflictingClaims,
+            relatedBlockingGateIds,
+            shouldCreateGate: true,
+        };
+    }
+    return {
+        kind: ownClaims.length > 0 ? FileAuditDecisionKind.CLAIMED_WRITE : FileAuditDecisionKind.FILE_CHANGED,
+        changedResource: input.changedResource,
+        ownClaims,
+        conflictingClaims,
+        relatedBlockingGateIds,
+        shouldCreateGate: false,
+    };
+}
+export function findMatchingClaims(claims, resource) {
+    return claims.filter(claim => claim.resources.some(claimed => resourceLocatorsOverlap(claimed, resource)));
+}
+export function gateMatchesResource(gate, resource) {
+    if ((gate.relatedResources ?? []).some(related => resourceLocatorsOverlap(related, resource))) {
+        return true;
+    }
+    return parseRelatedFileLocators(gate.relatedFiles ?? [])
+        .some(locator => resourceLocatorsOverlap({ type: "file", scope: "file", locator, metadata: "" }, resource));
+}
+export function parseRelatedFileLocators(value) {
+    return value
+        .flatMap(part => part.split("↔"))
+        .map(part => part.trim())
+        .filter(Boolean);
+}
+//# sourceMappingURL=file-audit.js.map

package/dist/kernel/file-audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-audit.js","sourceRoot":"","sources":["../../_build/src/kernel/file-audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAG3E,MAAM,CAAN,IAAY,qBAKX;AALD,WAAY,qBAAqB;IAC/B,sDAA6B,CAAA;IAC7B,wDAA+B,CAAA;IAC/B,4EAAmD,CAAA;IACnD,8DAAqC,CAAA;AACvC,CAAC,EALW,qBAAqB,KAArB,qBAAqB,QAKhC;AAwBD,MAAM,UAAU,uBAAuB,CAAC,KAAqB;IAC3D,MAAM,cAAc,GAAG,kBAAkB,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;IACrF,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,CAAC,CAAC;IAClF,MAAM,iBAAiB,GAAG,cAAc,CAAC,MAAM,CAC7C,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,CAAC,SAAS,CACvF,CAAC;IACF,MAAM,sBAAsB,GAAG,CAAC,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC;SACvD,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,mBAAmB,CAAC,IAAI,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;SAChE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAExB,IAAI,sBAAsB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,OAAO;YACL,IAAI,EAAE,qBAAqB,CAAC,gBAAgB;YAC5C,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,SAAS;YACT,iBAAiB;YACjB,sBAAsB;YACtB,gBAAgB,EAAE,KAAK;SACxB,CAAC;IACJ,CAAC;IAED,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,OAAO;YACL,IAAI,EAAE,qBAAqB,CAAC,uBAAuB;YACnD,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,SAAS;YACT,iBAAiB;YACjB,sBAAsB;YACtB,gBAAgB,EAAE,IAAI;SACvB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,aAAa,CAAC,CAAC,CAAC,qBAAqB,CAAC,YAAY;QACrG,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,SAAS;QACT,iBAAiB;QACjB,sBAAsB;QACtB,gBAAgB,EAAE,KAAK;KACxB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAuB,EAAE,QAAqB;IAC/E,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC3B,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,uBAAuB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAC5E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAA0B,EAAE,QAAqB;IACnF,IAAI,CAAC,IAAI,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,uBAAuB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC;QAC9F,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,wBAAwB,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;SACrD,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,uBAAuB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;AAChH,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAe;IACtD,OAAO,KAAK;SACT,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;SAChC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SACxB,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC"}

package/dist/kernel/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * SyncPoint kernel — minimal coordination primitives.
+ *
+ * Phase 3: source files are now physically hosted here.
+ * syncpoint-core retains copies for backward compatibility.
+ */
+export { ResourceScope, LineRangeSchema, ResourceRefSchema, ResourceClaimStatus, ResourceClaimMode, ResourceClaimSchema, ResourceClaimCreateSchema, resourceLocatorsOverlap, detectResourceClaimConflicts, registerResourceMatcher, getResourceMatcher, clearResourceMatcherRegistry, } from "./resource.js";
+export type { LineRange, ResourceRef, ResourceClaim, ResourceClaimCreate, ResourceConflict, ResourceMatcher, } from "./resource.js";
+export { normalizeResourcePath, arePathsEquivalent, toResourceLocatorKey, } from "./path-normalize.js";
+export type { NormalizePathOptions } from "./path-normalize.js";
+export { FileAuditDecisionKind, evaluateFileAuditChange, gateMatchesResource, parseRelatedFileLocators, } from "./file-audit.js";
+export type { FileAuditDecision, FileAuditGateContext, } from "./file-audit.js";
+export { SyncGateStatus, SyncGateReason, SYNC_GATE_TRANSITIONS, validateSyncGateTransition, SyncGateSchema, SyncGateCreateSchema, GatePolicyKind, GateTimeoutAction, GatePolicySchema, DEFAULT_GATE_POLICY, GateAckSchema, GateAckCreateSchema, GateVoteKind, GateVoteSchema, GateVoteCreateSchema, LivenessAction, parseGatePolicy, countVotes, evaluateGateLiveness, isGateBlocking, hasPartialAcks, allAcked, quorumMet, pendingAgents, isAgentBlocked, computeAvailableActions, computeGateDetails, } from "./sync-gate.js";
+export type { SyncGate, SyncGateCreate, SyncGateAck, GatePolicy, GateAck, GateAckCreate, GateVote, GateVoteCreate, LivenessDecision, GateAction, GateDetailedStatus, } from "./sync-gate.js";
+export { OperationStatus, validateOperationTransition, OperationSchema, OperationCreateSchema, } from "./operation.js";
+export type { Operation, OperationCreate, OperationCheckItem, OperationCheckResult, OperationApproval, } from "./operation.js";
+export { registerOperationValidator, getValidatorsForOperation, runOperationValidation, clearValidatorRegistry, } from "./validator.js";
+export type { OperationValidator, OperationValidationContext, } from "./validator.js";
+export { WriteIntent, WritePermitStatus, WriteDecisionReason, WriteResourceHashSchema, WriteDecisionBlockerSchema, WriteDecisionWarningSchema, WriteDecisionSchema, WritePermitSchema, WritePermitCreateSchema, evaluateWriteDecision, } from "./write-permit.js";
+export type { WriteResourceHash, WriteDecisionBlocker, WriteDecisionWarning, WriteDecision, WritePermit, WritePermitCreate, WriteConstraintDecisionInput, WriteDecisionInput, } from "./write-permit.js";
+export { computeLineDrift, remapLineRanges, rangeStillExists, } from "./line-range-drift.js";
+export type { DriftResult, LineMapping, } from "./line-range-drift.js";
+export { SyncPointError, ResourceConflictError, ResourceNotFoundError, ConstraintViolationError, UnauthorizedError, ForbiddenError, InvalidStateTransitionError, ValidationError, DatabaseError, OperationTimeoutError, InternalError, } from "./errors.js";
+export { EventType, EventSchema } from "./events.js";
+export type { Event } from "./events.js";
+export { ApprovalGateStatus, ApprovalGateResultSchema, } from "./approval-gate.js";
+export type { ApprovalGateResult } from "./approval-gate.js";
+export { PlaybookActionKind } from "./playbook-action-kind.js";
+export { RelationshipMode, RelationshipModeSchema, MODE_PHASE_FLOW, MODE_SYNC_RULES, MODE_WAKE_VERBS, REQUIRED_BEFORE_START, RECOMMENDED_ACTIONS, FORBIDDEN_ACTIONS, isValidWakeVerb, getSyncRules, getPhaseFlow, getModeDescription, isModeActionAllowed, getRequiredBeforeStart, getRecommendedActions, getForbiddenActions, } from "./relationship-mode.js";
+export type { ModeSyncRule, ModeActionVerdict } from "./relationship-mode.js";
+//# sourceMappingURL=index.d.ts.map

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

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