syncpoint-ai 0.1.0

package/dist/server/application/checkpoint-review-service.js

@@ -0,0 +1,195 @@
+/**
+ * CheckpointReview Service — checkpoint-driven approval reviews.
+ *
+ * Use cases:
+ *   stxCreate   — create a checkpoint review + bound SyncGate
+ *   stxSubmit   — move OPEN → WAITING_APPROVAL
+ *   stxApprove  — approver approves
+ *   stxReject   — approver rejects
+ *   stxResolve  — resolve review + release gate
+ *   stxCancel   — cancel review + cancel gate
+ *   stxStatus   — get review status with pending info
+ *   stxList     — list reviews with optional filters
+ *
+ * Public function names keep the `stx*` prefix for transport-layer stability.
+ */
+import { CheckpointReviewStatus, validateCheckpointReviewTransition, allApproved, hasRejection, pendingApprovers, isReviewBlocking } from "../../governance/index.js";
+import { SyncGateReason, EventType, ForbiddenError, InvalidStateTransitionError } from "../../kernel/index.js";
+import * as protocolRepo from "../repositories/_exports/protocol.js";
+import { logEvent } from "../repositories/_shared.js";
+import { sgRequest, sgAck, sgResolve, sgCancel } from "./sync-gate-service.js";
+// ── Use Cases ──────────────────────────────────────────
+/**
+ * Create a sync transaction. Automatically creates a bound SyncGate
+ * with reason=checkpoint_required and moves the transaction to WAITING_APPROVAL.
+ */
+export function stxCreate(input) {
+    // 1. Create bound SyncGate
+    const gateResult = sgRequest({
+        sessionId: input.sessionId,
+        taskId: input.taskId,
+        requestedByAgentId: input.requestingAgentId,
+        requiredAgentIds: input.requiredApproverIds,
+        reason: SyncGateReason.CHECKPOINT_REQUIRED,
+        description: `Sync transaction for checkpoint ${input.checkpointId}`,
+        relatedCheckpointId: input.checkpointId,
+    });
+    // 2. Create the transaction
+    let tx = protocolRepo.createCheckpointReview({
+        sessionId: input.sessionId,
+        taskId: input.taskId,
+        checkpointId: input.checkpointId,
+        requestingAgentId: input.requestingAgentId,
+        requiredApproverIds: input.requiredApproverIds,
+        gateId: gateResult.gate.id,
+    });
+    logEvent(EventType.SYNC_TX_CREATED, "checkpoint_review", tx.id, JSON.stringify({
+        sessionId: input.sessionId,
+        taskId: input.taskId,
+        checkpointId: input.checkpointId,
+        requiredApproverIds: input.requiredApproverIds,
+        gateId: gateResult.gate.id,
+    }));
+    // 3. Auto-advance to WAITING_APPROVAL
+    tx = protocolRepo.updateCheckpointReviewStatus(tx.id, CheckpointReviewStatus.WAITING_APPROVAL);
+    logEvent(EventType.SYNC_TX_SUBMITTED, "checkpoint_review", tx.id, JSON.stringify({ requiredApproverIds: input.requiredApproverIds }));
+    return buildStatusResult(tx);
+}
+/**
+ * Approver approves a sync transaction.
+ */
+export function stxApprove(txId, agentId, summary) {
+    let tx = protocolRepo.getCheckpointReview(txId);
+    // Verify agent is required approver
+    const required = tx.requiredApproverIds;
+    if (!required.includes(agentId)) {
+        throw new ForbiddenError("checkpoint_review", `Agent ${agentId} is not a required approver for transaction ${txId}`);
+    }
+    // Verify transaction is in WAITING_APPROVAL
+    if (tx.status !== CheckpointReviewStatus.WAITING_APPROVAL) {
+        throw new InvalidStateTransitionError("checkpoint_review", tx.status, CheckpointReviewStatus.WAITING_APPROVAL);
+    }
+    // Add to approved list
+    const approved = tx.approvedByIds;
+    if (!approved.includes(agentId)) {
+        tx = protocolRepo.approveCheckpointReviewBy(tx.id, agentId);
+    }
+    logEvent(EventType.SYNC_TX_APPROVED, "checkpoint_review", tx.id, JSON.stringify({ agentId, summary: summary ?? "" }));
+    // Ack the bound gate so it can advance
+    if (tx.gateId) {
+        try {
+            sgAck(tx.gateId, agentId, `Approved: ${summary ?? ""}`);
+        }
+        catch { /* already acked or gate state mismatch */ }
+    }
+    // Auto-advance to APPROVED when all have approved
+    if (allApproved(tx)) {
+        tx = protocolRepo.updateCheckpointReviewStatus(tx.id, CheckpointReviewStatus.APPROVED, summary ?? "");
+    }
+    return buildStatusResult(tx);
+}
+/**
+ * Approver rejects a sync transaction.
+ */
+export function stxReject(txId, agentId, reason) {
+    let tx = protocolRepo.getCheckpointReview(txId);
+    // Verify agent is required approver
+    const required = tx.requiredApproverIds;
+    if (!required.includes(agentId)) {
+        throw new ForbiddenError("checkpoint_review", `Agent ${agentId} is not a required approver for transaction ${txId}`);
+    }
+    // Verify transaction is in WAITING_APPROVAL
+    if (tx.status !== CheckpointReviewStatus.WAITING_APPROVAL) {
+        throw new InvalidStateTransitionError("checkpoint_review", tx.status, CheckpointReviewStatus.WAITING_APPROVAL);
+    }
+    // Add to rejected list
+    const rejected = tx.rejectedByIds;
+    if (!rejected.includes(agentId)) {
+        tx = protocolRepo.rejectCheckpointReviewBy(tx.id, agentId);
+    }
+    logEvent(EventType.SYNC_TX_REJECTED, "checkpoint_review", tx.id, JSON.stringify({ agentId, reason: reason ?? "" }));
+    // Ack the bound gate so it can advance (rejection still means the approver has reviewed)
+    if (tx.gateId) {
+        try {
+            sgAck(tx.gateId, agentId, `Rejected: ${reason ?? ""}`);
+        }
+        catch { /* already acked or gate state mismatch */ }
+    }
+    // Move to REJECTED immediately on first rejection
+    tx = protocolRepo.updateCheckpointReviewStatus(tx.id, CheckpointReviewStatus.REJECTED, reason ?? "");
+    return buildStatusResult(tx);
+}
+/**
+ * Resolve a sync transaction → RESOLVED and release the bound SyncGate.
+ * Can be called after APPROVED (normal flow) or REJECTED (after follow-up).
+ */
+export function stxResolve(txId, decisionSummary) {
+    let tx = protocolRepo.getCheckpointReview(txId);
+    if (!validateCheckpointReviewTransition(tx.status, CheckpointReviewStatus.RESOLVED)) {
+        throw new InvalidStateTransitionError("checkpoint_review", tx.status, CheckpointReviewStatus.RESOLVED);
+    }
+    tx = protocolRepo.updateCheckpointReviewStatus(tx.id, CheckpointReviewStatus.RESOLVED, decisionSummary ?? "");
+    logEvent(EventType.SYNC_TX_RESOLVED, "checkpoint_review", tx.id, JSON.stringify({ decisionSummary: decisionSummary ?? "" }));
+    // Release the bound SyncGate
+    if (tx.gateId) {
+        try {
+            sgResolve(tx.gateId, `Transaction ${tx.id} resolved: ${decisionSummary ?? ""}`);
+        }
+        catch {
+            // Gate may already be resolved/cancelled
+        }
+    }
+    return buildStatusResult(tx);
+}
+/**
+ * Cancel a sync transaction and its bound SyncGate.
+ */
+export function stxCancel(txId, reason) {
+    let tx = protocolRepo.getCheckpointReview(txId);
+    if (!validateCheckpointReviewTransition(tx.status, CheckpointReviewStatus.CANCELLED)) {
+        throw new InvalidStateTransitionError("checkpoint_review", tx.status, CheckpointReviewStatus.CANCELLED);
+    }
+    tx = protocolRepo.updateCheckpointReviewStatus(tx.id, CheckpointReviewStatus.CANCELLED, reason ?? "");
+    logEvent(EventType.SYNC_TX_CANCELLED, "checkpoint_review", tx.id, JSON.stringify({ reason: reason ?? "" }));
+    // Cancel the bound SyncGate
+    if (tx.gateId) {
+        try {
+            sgCancel(tx.gateId, `Transaction ${tx.id} cancelled: ${reason ?? ""}`);
+        }
+        catch {
+            // Gate may already be resolved/cancelled
+        }
+    }
+    return tx;
+}
+/**
+ * Get detailed transaction status.
+ */
+export function stxStatus(txId) {
+    const tx = protocolRepo.getCheckpointReview(txId);
+    return buildStatusResult(tx);
+}
+/**
+ * List sync transactions with optional filters.
+ */
+export function stxList(opts) {
+    return protocolRepo.listCheckpointReviews(opts);
+}
+/**
+ * List active (blocking) sync transactions.
+ */
+export function stxListActive(opts) {
+    return protocolRepo.listActiveCheckpointReviews(opts);
+}
+// ── Internal ───────────────────────────────────────────
+function buildStatusResult(tx) {
+    const status = tx.status;
+    return {
+        tx,
+        pending: pendingApprovers(tx),
+        allApproved: allApproved(tx),
+        hasRejection: hasRejection(tx),
+        isBlocking: isReviewBlocking(status),
+    };
+}
+//# sourceMappingURL=checkpoint-review-service.js.map

package/dist/server/application/checkpoint-review-service.js.map

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

package/dist/server/application/collaboration-coordinator.d.ts

@@ -0,0 +1,257 @@
+import { RealityProjection } from "../../context/index.js";
+import { ConstraintAction, ConstraintDecision } from "../../governance/index.js";
+import { ResourceRef } from "../../kernel/index.js";
+import { getContractForTask, getLatestCheckpointForAgent, getLatestContextSnapshot } from "../repositories/_exports/context-memory.js";
+import { sgCheckAgent } from "./sync-gate-service.js";
+export interface ResumeProjectionContext {
+    latestSnapshot: ReturnType<typeof getLatestContextSnapshot>;
+    latestCheckpoint: ReturnType<typeof getLatestCheckpointForAgent>;
+    contract: ReturnType<typeof getContractForTask>;
+    workingResources: string[];
+    touchedResources?: ResourceRef[];
+    projection: RealityProjection;
+}
+export interface ExecutionReadinessInput {
+    agentId: string;
+    taskId: string;
+    sessionId?: string;
+    action: ConstraintAction;
+    workingResources?: string[];
+    touchedResources?: ResourceRef[];
+    projection?: RealityProjection;
+}
+export interface ExecutionReadiness {
+    blockCheck: ReturnType<typeof sgCheckAgent>;
+    workingResources: string[];
+    touchedResources?: ResourceRef[];
+    projection: RealityProjection;
+    constraintDecision: ConstraintDecision;
+}
+export declare function prepareResumeProjectionContext(taskId: string, agentId: string): ResumeProjectionContext;
+export declare function checkAgentBlock(input: {
+    agentId: string;
+    taskId?: string;
+    sessionId?: string;
+}): import("./sync-gate-service.js").AgentBlockCheck;
+export declare function evaluateExecutionReadiness(input: ExecutionReadinessInput): ExecutionReadiness;
+export declare function collectStatusSnapshotState(input?: {
+    sessionId?: string;
+}): {
+    activeClaims: {
+        status: import("../../kernel/resource.js").ResourceClaimStatus;
+        id: string;
+        actorId: string;
+        taskId: string;
+        sessionId: string;
+        resources: {
+            type: string;
+            locator: string;
+            scope: "function" | "file" | "line_range";
+            metadata: string;
+            id?: string | undefined;
+            functionName?: string | undefined;
+            lineRange?: {
+                start: number;
+                end: number;
+            } | undefined;
+        }[];
+        mode: import("../../kernel/resource.js").ResourceClaimMode;
+        createdAt: string;
+        releasedAt: string;
+    }[];
+    conflicts: import("../../kernel/resource.js").ResourceConflict[];
+    activeGates: {
+        status: import("../../kernel/sync-gate.js").SyncGateStatus;
+        id: string;
+        taskId: string;
+        sessionId: string;
+        createdAt: string;
+        requestedByAgentId: string;
+        requiredAgentIds: string[];
+        ackedAgentIds: string[];
+        reason: import("../../kernel/sync-gate.js").SyncGateReason;
+        description: string;
+        relatedFiles: string[];
+        relatedResources: {
+            type: string;
+            locator: string;
+            scope: "function" | "file" | "line_range";
+            metadata: string;
+            id?: string | undefined;
+            functionName?: string | undefined;
+            lineRange?: {
+                start: number;
+                end: number;
+            } | undefined;
+        }[];
+        relatedCheckpointId: string;
+        relatedClaimIds: string[];
+        escalated: boolean;
+        escalatedAt: string;
+        decisionSummary: string;
+        policy: {
+            kind: import("../../kernel/sync-gate.js").GatePolicyKind;
+            timeoutAction: import("../../kernel/sync-gate.js").GateTimeoutAction;
+            quorum?: number | undefined;
+            deadlineAt?: string | undefined;
+            leaseExpiresAt?: string | undefined;
+            escalationAgentIds?: string[] | undefined;
+            lastLivenessCheckAt?: string | undefined;
+        };
+        updatedAt: string;
+    }[];
+    allGates: {
+        status: import("../../kernel/sync-gate.js").SyncGateStatus;
+        id: string;
+        taskId: string;
+        sessionId: string;
+        createdAt: string;
+        requestedByAgentId: string;
+        requiredAgentIds: string[];
+        ackedAgentIds: string[];
+        reason: import("../../kernel/sync-gate.js").SyncGateReason;
+        description: string;
+        relatedFiles: string[];
+        relatedResources: {
+            type: string;
+            locator: string;
+            scope: "function" | "file" | "line_range";
+            metadata: string;
+            id?: string | undefined;
+            functionName?: string | undefined;
+            lineRange?: {
+                start: number;
+                end: number;
+            } | undefined;
+        }[];
+        relatedCheckpointId: string;
+        relatedClaimIds: string[];
+        escalated: boolean;
+        escalatedAt: string;
+        decisionSummary: string;
+        policy: {
+            kind: import("../../kernel/sync-gate.js").GatePolicyKind;
+            timeoutAction: import("../../kernel/sync-gate.js").GateTimeoutAction;
+            quorum?: number | undefined;
+            deadlineAt?: string | undefined;
+            leaseExpiresAt?: string | undefined;
+            escalationAgentIds?: string[] | undefined;
+            lastLivenessCheckAt?: string | undefined;
+        };
+        updatedAt: string;
+    }[];
+    activeTransactions: {
+        status: import("../../governance/checkpoint-review.js").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[];
+    }[];
+    pendingOps: {
+        type: string;
+        status: import("../../kernel/operation.js").OperationStatus;
+        id: string;
+        actorId: string;
+        taskId: string;
+        sessionId: string;
+        createdAt: string;
+        decisionSummary: string;
+        updatedAt: string;
+        summary: string;
+        targetResources: {
+            type: string;
+            locator: string;
+            scope: "function" | "file" | "line_range";
+            metadata: string;
+            id?: string | undefined;
+            functionName?: string | undefined;
+            lineRange?: {
+                start: number;
+                end: number;
+            } | undefined;
+        }[];
+        title: string;
+        payloadRef: string;
+        checkResult: {
+            allPassed: boolean;
+            items: {
+                check: string;
+                passed: boolean;
+                detail: string;
+            }[];
+            targetResources: {
+                type: string;
+                locator: string;
+                scope: "function" | "file" | "line_range";
+                metadata: string;
+                id?: string | undefined;
+                functionName?: string | undefined;
+                lineRange?: {
+                    start: number;
+                    end: number;
+                } | undefined;
+            }[];
+            uncoveredResources: {
+                type: string;
+                locator: string;
+                scope: "function" | "file" | "line_range";
+                metadata: string;
+                id?: string | undefined;
+                functionName?: string | undefined;
+                lineRange?: {
+                    start: number;
+                    end: number;
+                } | undefined;
+            }[];
+            conflictingClaimIds: string[];
+            constraintViolations?: {
+                message: string;
+                rule: string;
+                sourceMemoryId: string;
+                projectionId: string;
+                evidence?: string[] | undefined;
+            }[] | undefined;
+        } | null;
+    }[];
+    wakeRequests: {
+        status: import("../../governance/wake.js").WakeRequestStatus;
+        id: string;
+        taskId: string | null;
+        sessionId: string;
+        createdAt: string;
+        reason: string;
+        updatedAt: string;
+        targetAgentId: string;
+        targetRole: string;
+        action: string;
+        triggerEventType: string;
+        triggerEntityId: string;
+        reviewRequestId: string | null;
+        promptHint: string;
+        mcpToolHint: string;
+        cliHint: string;
+        runnerMode: "manual" | "mcp";
+        resultSummary: string;
+    }[];
+};
+export declare const collaborationCoordinator: {
+    readonly resume: {
+        readonly prepareProjectionContext: typeof prepareResumeProjectionContext;
+    };
+    readonly execution: {
+        readonly checkAgentBlock: typeof checkAgentBlock;
+        readonly evaluateReadiness: typeof evaluateExecutionReadiness;
+    };
+    readonly status: {
+        readonly collectSnapshotState: typeof collectStatusSnapshotState;
+    };
+};
+//# sourceMappingURL=collaboration-coordinator.d.ts.map

package/dist/server/application/collaboration-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collaboration-coordinator.d.ts","sourceRoot":"","sources":["../../../_build/src/server/application/collaboration-coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EAAuB,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACtG,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EACL,kBAAkB,EAClB,2BAA2B,EAC3B,wBAAwB,EACzB,MAAM,4CAA4C,CAAC;AAKpD,OAAO,EAAE,YAAY,EAAwB,MAAM,wBAAwB,CAAC;AAI5E,MAAM,WAAW,uBAAuB;IACtC,cAAc,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC;IAC5D,gBAAgB,EAAE,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC;IACjE,QAAQ,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;IAChD,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,gBAAgB,CAAC,EAAE,WAAW,EAAE,CAAC;IACjC,UAAU,EAAE,iBAAiB,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,gBAAgB,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,gBAAgB,CAAC,EAAE,WAAW,EAAE,CAAC;IACjC,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;IAC5C,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,gBAAgB,CAAC,EAAE,WAAW,EAAE,CAAC;IACjC,UAAU,EAAE,iBAAiB,CAAC;IAC9B,kBAAkB,EAAE,kBAAkB,CAAC;CACxC;AAYD,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,uBAAuB,CA2CvG;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,oDAE9F;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,uBAAuB,GAAG,kBAAkB,CA6B7F;AAED,wBAAgB,0BAA0B,CAAC,KAAK,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBxE;AAED,eAAO,MAAM,wBAAwB;;;;;;;;;;;CAW3B,CAAC"}

package/dist/server/application/collaboration-coordinator.js

@@ -0,0 +1,110 @@
+import { computeContentHash } from "../../context/index.js";
+import { evaluateConstraints } from "../../governance/index.js";
+import { getContractForTask, getLatestCheckpointForAgent, getLatestContextSnapshot, } from "../repositories/_exports/context-memory.js";
+import { listQueuedWakeRequests } from "../repositories/_exports/orchestration.js";
+import { resolveResourceRefs } from "./_resource-resolve.js";
+import { buildProjection } from "./reality-projection-service.js";
+import { rcDetectConflicts, rcList } from "./resource-claim-service.js";
+import { sgCheckAgent, sgList, sgListActive } from "./sync-gate-service.js";
+import { stxListActive } from "./checkpoint-review-service.js";
+import { opList } from "./operation-service.js";
+function toStringArray(value) {
+    if (Array.isArray(value)) {
+        return value.map(item => item.trim()).filter(Boolean);
+    }
+    if (typeof value === "string") {
+        return value.split(",").map(item => item.trim()).filter(Boolean);
+    }
+    return [];
+}
+export function prepareResumeProjectionContext(taskId, agentId) {
+    const latestSnapshot = getLatestContextSnapshot(taskId, agentId);
+    const latestCheckpoint = getLatestCheckpointForAgent(taskId, agentId);
+    const contract = getContractForTask(taskId);
+    const workingResources = toStringArray(latestSnapshot?.payload?.workingResources);
+    const touchedResources = workingResources.length > 0
+        ? resolveResourceRefs(workingResources, agentId)
+        : undefined;
+    const projection = buildProjection({
+        taskId,
+        workingResources,
+        currentModules: [],
+        snapshotId: latestSnapshot?.id,
+        checkpointId: latestCheckpoint?.id,
+        contractId: contract?.id,
+        snapshotHash: latestSnapshot
+            ? computeContentHash(latestSnapshot.summary, JSON.stringify(latestSnapshot.payload))
+            : undefined,
+        checkpointHash: latestCheckpoint
+            ? computeContentHash(latestCheckpoint.summary, latestCheckpoint.progress)
+            : undefined,
+        contractHash: contract
+            ? computeContentHash(contract.title, contract.scope, toStringArray(contract.responsibilities).join("|"), toStringArray(contract.interfaceSpec).join("|"), toStringArray(contract.resourceBoundaries).join("|"), contract.testPlan, contract.risks, contract.status)
+            : undefined,
+    });
+    return {
+        latestSnapshot,
+        latestCheckpoint,
+        contract,
+        workingResources,
+        touchedResources,
+        projection,
+    };
+}
+export function checkAgentBlock(input) {
+    return sgCheckAgent(input.agentId, { taskId: input.taskId, sessionId: input.sessionId });
+}
+export function evaluateExecutionReadiness(input) {
+    const blockCheck = checkAgentBlock({
+        agentId: input.agentId,
+        taskId: input.taskId,
+        sessionId: input.sessionId,
+    });
+    const workingResources = input.workingResources ?? toStringArray(getLatestContextSnapshot(input.taskId, input.agentId)?.payload?.workingResources);
+    const touchedResources = input.touchedResources ?? (workingResources.length > 0
+        ? resolveResourceRefs(workingResources, input.agentId)
+        : undefined);
+    const projection = input.projection ?? buildProjection({
+        taskId: input.taskId,
+        workingResources,
+    });
+    const constraintDecision = evaluateConstraints({
+        action: input.action,
+        projection,
+        touchedResources,
+    });
+    return {
+        blockCheck,
+        workingResources,
+        touchedResources,
+        projection,
+        constraintDecision,
+    };
+}
+export function collectStatusSnapshotState(input) {
+    const scopeFilter = input?.sessionId ? { sessionId: input.sessionId } : undefined;
+    const activeClaims = rcList(input?.sessionId ? { sessionId: input.sessionId } : undefined)
+        .filter(claim => claim.status === "ACTIVE");
+    return {
+        activeClaims,
+        conflicts: rcDetectConflicts(input?.sessionId ? { sessionId: input.sessionId } : undefined),
+        activeGates: sgListActive(scopeFilter),
+        allGates: sgList(scopeFilter),
+        activeTransactions: stxListActive(scopeFilter),
+        pendingOps: opList(input?.sessionId ? { sessionId: input.sessionId } : undefined).filter(op => op.status === "DRAFT" || op.status === "SUBMITTED" || op.status === "APPROVED"),
+        wakeRequests: listQueuedWakeRequests(input?.sessionId),
+    };
+}
+export const collaborationCoordinator = {
+    resume: {
+        prepareProjectionContext: prepareResumeProjectionContext,
+    },
+    execution: {
+        checkAgentBlock,
+        evaluateReadiness: evaluateExecutionReadiness,
+    },
+    status: {
+        collectSnapshotState: collectStatusSnapshotState,
+    },
+};
+//# sourceMappingURL=collaboration-coordinator.js.map

package/dist/server/application/collaboration-coordinator.js.map

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

package/dist/server/application/constraint-evaluation-service.d.ts

@@ -0,0 +1,78 @@
+/**
+ * P4D — Constraint Runtime Service (read-only visibility layer).
+ *
+ * Provides a unified query interface for constraint runtime decisions.
+ * Does NOT mutate any state — purely read-only.
+ *
+ * Three responsibilities:
+ *   1. Collect action context (resolve workingResources / touchedResources from DB).
+ *   2. Build projection via buildProjection().
+ *   3. Evaluate constraints via evaluateConstraints() and format output.
+ *
+ * Output contains only projected refs (sourceMemoryId, projectionId, rule,
+ * message, evidence). Raw Project Memory content is never exposed.
+ */
+import type { ProjectionValidityStatus, ContextMode } from "../../context/index.js";
+import type { ConstraintManifest } from "../../governance/index.js";
+import "./_scope-matchers.js";
+export type ConstraintCheckAction = "resume" | "start_assignment" | "wake_start" | "operation_submit" | "operation_apply";
+export interface ConstraintRuntimeCheckInput {
+    action: ConstraintCheckAction;
+    taskId?: string;
+    agentId?: string;
+    sessionId?: string;
+    assignmentId?: string;
+    wakeRequestId?: string;
+    operationId?: string;
+    contextMode?: ContextMode;
+    touchedResources?: string[];
+}
+export interface ConstraintViolationView {
+    rule: string;
+    sourceMemoryId: string;
+    projectionId: string;
+    message: string;
+    evidence?: string[];
+}
+export interface ConstraintRuntimeView {
+    action: ConstraintCheckAction;
+    permitted: boolean;
+    blockers: ConstraintViolationView[];
+    warnings: ConstraintViolationView[];
+    projection: {
+        projectionId: string;
+        cacheKey: string;
+        validity: ProjectionValidityStatus;
+        memoryVersion: number;
+        createdFrom: {
+            taskId: string;
+            snapshotId?: string;
+            checkpointId?: string;
+            contractId?: string;
+        };
+    };
+    inputs: {
+        taskId?: string;
+        agentId?: string;
+        sessionId?: string;
+        workingResources: string[];
+        touchedResources: string[];
+        source: "context_snapshot" | "resource_claims" | "operation" | "explicit";
+    };
+    manifest?: ConstraintManifest;
+    runtimeUnavailable?: {
+        message: string;
+    };
+}
+/**
+ * Evaluate constraint runtime for the given action context.
+ * Read-only: never mutates task/wake/patch/assignment state.
+ *
+ * Returns a ConstraintRuntimeView with:
+ *   - permitted: boolean
+ *   - blockers/warnings: projected refs only (no raw PM content)
+ *   - projection metadata
+ *   - resolved input context
+ */
+export declare function constraintCheck(input: ConstraintRuntimeCheckInput): ConstraintRuntimeView;
+//# sourceMappingURL=constraint-evaluation-service.d.ts.map

package/dist/server/application/constraint-evaluation-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraint-evaluation-service.d.ts","sourceRoot":"","sources":["../../../_build/src/server/application/constraint-evaluation-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,OAAO,KAAK,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACpF,OAAO,KAAK,EAAuB,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAKzF,OAAO,sBAAsB,CAAC;AAK9B,MAAM,MAAM,qBAAqB,GAC7B,QAAQ,GACR,kBAAkB,GAClB,YAAY,GACZ,kBAAkB,GAClB,iBAAiB,CAAC;AAEtB,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,qBAAqB,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,uBAAuB,EAAE,CAAC;IACpC,QAAQ,EAAE,uBAAuB,EAAE,CAAC;IACpC,UAAU,EAAE;QACV,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,wBAAwB,CAAC;QACnC,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE;YACX,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,UAAU,CAAC,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,CAAC;IACF,MAAM,EAAE;QACN,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,MAAM,EAAE,kBAAkB,GAAG,iBAAiB,GAAG,WAAW,GAAG,UAAU,CAAC;KAC3E,CAAC;IACF,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,kBAAkB,CAAC,EAAE;QACnB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AA+KD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,2BAA2B,GAAG,qBAAqB,CAiFzF"}