@zhin.js/workroom 0.0.0 → 0.0.2

package/lib/workroom/journal/stored-event-projection.js

@@ -0,0 +1,280 @@
+import { canonicalWorkroomJson, compareCanonicalWorkroomText, deepFreezeWorkroomValue as deepFreeze, digestCanonicalWorkroomValue, } from '../canonical-value.js';
+import { assertExactRecordKeys, isNonEmptyString, isRecord } from './event-validation.js';
+import { isGovernedJournalPayloadReference } from './payload-reference.js';
+export function deriveStoredEventControl(event) {
+    const payload = event.payload;
+    const taskKey = () => opaqueStoredRef('task', event.runId, storedHeaderText(payload, 'taskKey'));
+    const assignmentId = () => opaqueStoredRef('assignment', event.runId, storedHeaderText(payload, 'assignmentId'));
+    switch (event.type) {
+        case 'run.created': return deepFreeze({ projectId: storedHeaderText(payload, 'projectId') });
+        case 'task.planned': return deepFreeze({
+            taskKey: taskKey(),
+            required: payload.required === true,
+            maxAttempts: storedHeaderPositiveInteger(payload, 'maxAttempts'),
+        });
+        case 'task.blocked': return deepFreeze({
+            taskKey: taskKey(),
+            blockerId: opaqueStoredRef('blocker', event.runId, storedHeaderText(payload, 'blockerId')),
+            blockerKind: storedHeaderBlockerKind(payload.kind),
+            blockerDeadline: storedHeaderNonNegativeInteger(payload, 'deadline'),
+            blockerAllowedActions: Object.freeze(['resolve', 'replan', 'cancel']),
+        });
+        case 'task.blocker_resolved': return deepFreeze({
+            taskKey: taskKey(),
+            blockerId: opaqueStoredRef('blocker', event.runId, storedHeaderText(payload, 'blockerId')),
+        });
+        case 'assignment.claimed': return deepFreeze({
+            taskKey: taskKey(),
+            assignmentId: assignmentId(),
+            role: storedHeaderRole(payload.role),
+            attempt: storedHeaderPositiveInteger(payload, 'attempt'),
+            assignmentRevision: storedHeaderPositiveInteger(payload, 'assignmentRevision'),
+            fence: storedHeaderPositiveInteger(payload, 'fence'),
+        });
+        case 'assignment.started':
+        case 'assignment.progress':
+        case 'assignment.heartbeat':
+        case 'assignment.checkpointed':
+        case 'assignment.checkpoint_requested':
+        case 'assignment.preempted':
+        case 'assignment.execution_completed':
+        case 'assignment.cancel_requested':
+        case 'assignment.lease_expired': return deepFreeze({ assignmentId: assignmentId() });
+        case 'assignment.cancelled': return deepFreeze({
+            assignmentId: assignmentId(), outcome: storedHeaderOutcome(payload.outcome),
+        });
+        case 'task.accepted':
+        case 'task.acceptance_pinned':
+        case 'task.acceptance_blocked':
+        case 'task.cancel_requested':
+        case 'task.cancelled':
+        case 'task.failed':
+        case 'task.rework_requested': return deepFreeze({ taskKey: taskKey() });
+        case 'task.revised': return deepFreeze({
+            taskKey: taskKey(), maxAttempts: storedHeaderPositiveInteger(payload, 'maxAttempts'),
+        });
+        case 'task.plan_revised': return deepFreeze({
+            taskKey: taskKey(), required: payload.required === true,
+            maxAttempts: storedHeaderPositiveInteger(payload, 'maxAttempts'),
+            newTaskRevision: storedHeaderPositiveInteger(payload, 'newTaskRevision'),
+        });
+        case 'reviewer.assigned': {
+            const assignment = storedHeaderRecord(payload, 'assignment');
+            return deepFreeze({
+                taskKey: taskKey(),
+                waitId: opaqueStoredRef('reviewer', event.runId, storedHeaderText(assignment, 'id')),
+                waitStatus: storedHeaderText(assignment, 'status'),
+            });
+        }
+        case 'reviewer.claimed':
+        case 'reviewer.verdict_recorded':
+        case 'reviewer.expired': return deepFreeze({
+            taskKey: taskKey(),
+            waitId: opaqueStoredRef('reviewer', event.runId, storedHeaderText(payload, 'assignmentId')),
+            ...(event.type === 'reviewer.verdict_recorded'
+                ? { verdictOutcome: payload.outcome === 'passed' ? 'passed' : 'rework' }
+                : {}),
+        });
+        case 'sponsor_gate.opened': {
+            const gate = storedHeaderRecord(payload, 'gate');
+            return deepFreeze({
+                taskKey: taskKey(),
+                waitId: opaqueStoredRef('sponsor-gate', event.runId, storedHeaderText(gate, 'id')),
+                waitStatus: storedHeaderText(gate, 'status'),
+            });
+        }
+        case 'sponsor_gate.decided': return deepFreeze({
+            taskKey: taskKey(),
+            waitId: opaqueStoredRef('sponsor-gate', event.runId, storedHeaderText(payload, 'gateId')),
+            decision: storedHeaderDecision(payload.decision),
+        });
+        case 'sponsor_gate.expired': return deepFreeze({
+            taskKey: taskKey(),
+            waitId: opaqueStoredRef('sponsor-gate', event.runId, storedHeaderText(payload, 'gateId')),
+        });
+        default: return Object.freeze({});
+    }
+}
+const WORKROOM_EVENT_CONTROL_KEYS = Object.freeze({
+    'run.created': ['projectId'],
+    'task.planned': ['taskKey', 'required', 'maxAttempts'],
+    'task.blocked': [
+        'taskKey', 'blockerId', 'blockerKind', 'blockerDeadline', 'blockerAllowedActions',
+    ],
+    'task.blocker_resolved': ['taskKey', 'blockerId'],
+    'assignment.claimed': [
+        'taskKey', 'assignmentId', 'role', 'attempt', 'assignmentRevision', 'fence',
+    ],
+    'assignment.started': ['assignmentId'],
+    'assignment.progress': ['assignmentId'],
+    'assignment.heartbeat': ['assignmentId'],
+    'assignment.checkpointed': ['assignmentId'],
+    'assignment.checkpoint_requested': ['assignmentId'],
+    'assignment.preempted': ['assignmentId'],
+    'assignment.execution_completed': ['assignmentId'],
+    'assignment.cancel_requested': ['assignmentId'],
+    'assignment.cancelled': ['assignmentId', 'outcome'],
+    'assignment.lease_expired': ['assignmentId'],
+    'task.accepted': ['taskKey'],
+    'task.acceptance_pinned': ['taskKey'],
+    'task.acceptance_blocked': ['taskKey'],
+    'task.cancel_requested': ['taskKey'],
+    'task.cancelled': ['taskKey'],
+    'task.failed': ['taskKey'],
+    'task.rework_requested': ['taskKey'],
+    'task.revised': ['taskKey', 'maxAttempts'],
+    'task.plan_revised': ['taskKey', 'required', 'maxAttempts', 'newTaskRevision'],
+    'reviewer.assigned': ['taskKey', 'waitId', 'waitStatus'],
+    'reviewer.claimed': ['taskKey', 'waitId'],
+    'reviewer.verdict_recorded': ['taskKey', 'waitId', 'verdictOutcome'],
+    'reviewer.expired': ['taskKey', 'waitId'],
+    'sponsor_gate.opened': ['taskKey', 'waitId', 'waitStatus'],
+    'sponsor_gate.decided': ['taskKey', 'waitId', 'decision'],
+    'sponsor_gate.expired': ['taskKey', 'waitId'],
+    'plan.admitted': [],
+    'plan.revision_applied': [],
+    'plan_gate.decided': [],
+    'run.control_decided': [],
+    'run.replan_requested': [],
+    'run.cancel_requested': [],
+    'run.cancelled': [],
+    'scheduler.dispatch_requested': [],
+    'scheduler.priority_changed': [],
+    'scheduler.preemption_requested': [],
+    'scheduler.preemption_checkpoint_acknowledged': [],
+    'scheduler.preemption_timed_out': [],
+    'local_execution.requested': [],
+    'remote_dispatch.requested': [],
+    'clock.advanced': [],
+});
+export function validateStoredEventControl(type, control) {
+    const keys = type === 'task.blocked' && Object.keys(control).length === 2
+        ? ['taskKey', 'blockerId']
+        : WORKROOM_EVENT_CONTROL_KEYS[type];
+    assertExactRecordKeys(control, keys, 'Stored Workroom control');
+    if (control.projectId !== undefined)
+        storedHeaderText(control, 'projectId');
+    for (const key of ['taskKey', 'assignmentId', 'blockerId', 'waitId']) {
+        if (control[key] !== undefined && (typeof control[key] !== 'string'
+            || !/^workroom-[a-z-]+:[a-f0-9]{64}$/u.test(control[key]))) {
+            throw new Error(`Stored Workroom control ${key} is invalid`);
+        }
+    }
+    for (const key of ['maxAttempts', 'attempt', 'assignmentRevision', 'fence', 'newTaskRevision']) {
+        if (control[key] !== undefined)
+            storedHeaderPositiveInteger(control, key);
+    }
+    if (control.required !== undefined && typeof control.required !== 'boolean') {
+        throw new Error('Stored Workroom control required is invalid');
+    }
+    if (control.blockerKind !== undefined)
+        storedHeaderBlockerKind(control.blockerKind);
+    if (control.blockerDeadline !== undefined) {
+        storedHeaderNonNegativeInteger(control, 'blockerDeadline');
+    }
+    if (control.blockerAllowedActions !== undefined) {
+        storedHeaderBlockerActions(control.blockerAllowedActions);
+    }
+    if (control.role !== undefined)
+        storedHeaderRole(control.role);
+    if (control.outcome !== undefined)
+        storedHeaderOutcome(control.outcome);
+    if (control.decision !== undefined)
+        storedHeaderDecision(control.decision);
+    if (control.verdictOutcome !== undefined
+        && control.verdictOutcome !== 'passed' && control.verdictOutcome !== 'rework') {
+        throw new Error('Stored Workroom control verdict outcome is invalid');
+    }
+    if (control.waitStatus !== undefined && ![
+        'open', 'claimed', 'passed', 'rework', 'expired', 'cancelled', 'satisfied', 'stale',
+    ].includes(String(control.waitStatus))) {
+        throw new Error('Stored Workroom control wait status is invalid');
+    }
+}
+export function storedProtectedReceiptHeaders(value) {
+    const headers = [];
+    const visit = (candidate) => {
+        if (isGovernedJournalPayloadReference(candidate)) {
+            headers.push(deepFreeze({
+                fieldPath: candidate.fieldPath,
+                contentHash: candidate.contentHash,
+                descriptorDigest: candidate.receipt.descriptor.descriptorDigest,
+                sourceDigest: candidate.receipt.source.digest,
+                sourceBindingDigest: candidate.receipt.source.bindingDigest,
+            }));
+            return;
+        }
+        if (Array.isArray(candidate)) {
+            for (const item of candidate)
+                visit(item);
+            return;
+        }
+        if (isRecord(candidate))
+            for (const item of Object.values(candidate))
+                visit(item);
+    };
+    visit(value);
+    return deepFreeze(headers.sort((left, right) => compareCanonicalWorkroomText(left.fieldPath, right.fieldPath)));
+}
+function opaqueStoredRef(kind, runId, rawId) {
+    return `workroom-${kind}:${digestCanonicalWorkroomValue({ kind, runId, rawId }).slice('sha256:'.length)}`;
+}
+function storedHeaderText(payload, key) {
+    const value = payload[key];
+    if (!isNonEmptyString(value))
+        throw new Error(`Stored Workroom header ${key} is invalid`);
+    return value;
+}
+function storedHeaderPositiveInteger(payload, key) {
+    const value = payload[key];
+    if (!Number.isSafeInteger(value) || Number(value) < 1) {
+        throw new Error(`Stored Workroom header ${key} is invalid`);
+    }
+    return Number(value);
+}
+function storedHeaderNonNegativeInteger(payload, key) {
+    const value = payload[key];
+    if (!Number.isSafeInteger(value) || Number(value) < 0) {
+        throw new Error(`Stored Workroom header ${key} is invalid`);
+    }
+    return Number(value);
+}
+function storedHeaderBlockerKind(value) {
+    if (value !== 'dependency' && value !== 'approval' && value !== 'capability'
+        && value !== 'external' && value !== 'human_input') {
+        throw new Error('Stored Workroom header Blocker kind is invalid');
+    }
+    return value;
+}
+function storedHeaderBlockerActions(value) {
+    if (!Array.isArray(value)
+        || canonicalWorkroomJson(value) !== canonicalWorkroomJson(['resolve', 'replan', 'cancel'])) {
+        throw new Error('Stored Workroom header Blocker allowedActions are invalid');
+    }
+    return Object.freeze([...value]);
+}
+function storedHeaderRecord(payload, key) {
+    const value = payload[key];
+    if (!isRecord(value))
+        throw new Error(`Stored Workroom header ${key} is invalid`);
+    return value;
+}
+function storedHeaderRole(value) {
+    if (value !== 'executor' && value !== 'reviewer' && value !== 'integration') {
+        throw new Error('Stored Workroom header Assignment role is invalid');
+    }
+    return value;
+}
+function storedHeaderOutcome(value) {
+    if (value !== 'interrupted' && value !== 'committed' && value !== 'outcome_unknown') {
+        throw new Error('Stored Workroom header Assignment outcome is invalid');
+    }
+    return value;
+}
+function storedHeaderDecision(value) {
+    if (value !== 'approve' && value !== 'reject' && value !== 'request_changes' && value !== 'cancel') {
+        throw new Error('Stored Workroom header Sponsor decision is invalid');
+    }
+    return value;
+}
+//# sourceMappingURL=stored-event-projection.js.map

package/lib/workroom/journal/stored-event-projection.js.map

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

package/lib/workroom/journal-model.d.ts

@@ -0,0 +1,40 @@
+export declare const WORKROOM_EVENT_MODEL: {
+    id: {
+        type: "text";
+        primary: boolean;
+        nullable: boolean;
+    };
+    run_id: {
+        type: "text";
+        nullable: boolean;
+    };
+    sequence: {
+        type: "integer";
+        nullable: boolean;
+    };
+    version: {
+        type: "integer";
+        nullable: boolean;
+    };
+    type: {
+        type: "text";
+        nullable: boolean;
+    };
+    payload_json: {
+        type: "text";
+        nullable: boolean;
+    };
+    occurred_at: {
+        type: "bigint";
+        nullable: boolean;
+    };
+    stored_event_digest: {
+        type: "text";
+        nullable: boolean;
+    };
+    row_binding_digest: {
+        type: "text";
+        nullable: boolean;
+    };
+};
+//# sourceMappingURL=journal-model.d.ts.map

package/lib/workroom/journal-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal-model.d.ts","sourceRoot":"","sources":["../../src/workroom/journal-model.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAUhC,CAAC"}

package/lib/workroom/journal-model.js

@@ -0,0 +1,12 @@
+export const WORKROOM_EVENT_MODEL = {
+    id: { type: 'text', primary: true, nullable: false },
+    run_id: { type: 'text', nullable: false },
+    sequence: { type: 'integer', nullable: false },
+    version: { type: 'integer', nullable: false },
+    type: { type: 'text', nullable: false },
+    payload_json: { type: 'text', nullable: false },
+    occurred_at: { type: 'bigint', nullable: false },
+    stored_event_digest: { type: 'text', nullable: false },
+    row_binding_digest: { type: 'text', nullable: false },
+};
+//# sourceMappingURL=journal-model.js.map

package/lib/workroom/journal-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal-model.js","sourceRoot":"","sources":["../../src/workroom/journal-model.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC7D,MAAM,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,QAAQ,EAAE,KAAK,EAAE;IAClD,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE,QAAQ,EAAE,KAAK,EAAE;IACvD,OAAO,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE,QAAQ,EAAE,KAAK,EAAE;IACtD,IAAI,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,QAAQ,EAAE,KAAK,EAAE;IAChD,YAAY,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,QAAQ,EAAE,KAAK,EAAE;IACxD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,QAAQ,EAAE,KAAK,EAAE;IACzD,mBAAmB,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC/D,kBAAkB,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,QAAQ,EAAE,KAAK,EAAE;CAC/D,CAAC"}

package/lib/workroom/kernel-contracts.d.ts

@@ -0,0 +1,168 @@
+import type { WorkroomAcceptanceContract, WorkroomAcceptanceDecision, WorkroomAcceptancePolicySnapshot, WorkroomAcceptanceRecord, WorkroomAcceptanceRoute, WorkroomRiskTier, WorkroomAcceptanceWaitAction } from './acceptance-policy.js';
+export type WorkroomRunStatus = 'active' | 'blocked' | 'needs_replan' | 'cancelling' | 'completed' | 'cancelled';
+export type WorkroomTaskStatus = 'ready' | 'blocked' | 'executing' | 'awaiting_acceptance' | 'cancelling' | 'accepted' | 'failed' | 'cancelled';
+export type WorkroomAssignmentStatus = 'leased' | 'running' | 'cancel_requested' | 'execution_completed' | 'lost' | 'cancelled';
+export type WorkroomExecutionRole = 'executor' | 'reviewer' | 'integration';
+export type WorkroomBlockerKind = 'dependency' | 'approval' | 'capability' | 'external' | 'human_input';
+export interface WorkroomBlocker {
+    readonly id: string;
+    readonly kind: WorkroomBlockerKind;
+    readonly owner: string;
+    readonly reason: string;
+    readonly deadline: number;
+    readonly allowedActions: readonly ('resolve' | 'replan' | 'cancel')[];
+}
+export interface WorkroomTaskState {
+    readonly key: string;
+    readonly title: string;
+    readonly status: WorkroomTaskStatus;
+    readonly revision: number;
+    readonly attempt: number;
+    readonly maxAttempts: number;
+    readonly required: boolean;
+    readonly blockers: readonly WorkroomBlocker[];
+    readonly currentAssignmentId?: string;
+    readonly reportRef?: string;
+    readonly reportDigest?: string;
+    readonly candidateRef?: string;
+    readonly candidateHash?: string;
+    readonly completionReceiptDigest?: string;
+    readonly acceptanceContract?: WorkroomAcceptanceContract;
+    readonly acceptanceRecord?: WorkroomAcceptanceRecord;
+    readonly currentReviewerAssignmentId?: string;
+    readonly currentSponsorGateId?: string;
+    readonly acceptanceBlockReason?: string;
+    readonly terminalReason?: string;
+}
+export type WorkroomAcceptanceWaitStatus = 'open' | 'expired' | 'cancelled' | 'satisfied' | 'stale';
+export interface WorkroomAcceptanceWaitState {
+    readonly id: string;
+    readonly taskKey: string;
+    readonly taskRevision: number;
+    readonly candidateHash: string;
+    readonly riskTier: WorkroomRiskTier;
+    readonly route: Extract<WorkroomAcceptanceRoute, 'reviewer_required' | 'sponsor_required' | 'reviewer_then_sponsor'>;
+    readonly contractId: string;
+    readonly policy: WorkroomAcceptancePolicySnapshot;
+    readonly owner: string;
+    readonly deadline: number;
+    readonly allowedActions: readonly WorkroomAcceptanceWaitAction[];
+    readonly evaluation: WorkroomAcceptanceDecision;
+}
+export interface WorkroomReviewerAssignmentState extends WorkroomAcceptanceWaitState {
+    readonly producerPrincipalId: string;
+    readonly status: WorkroomAcceptanceWaitStatus | 'claimed' | 'passed' | 'rework';
+    readonly reviewerPrincipalId?: string;
+    readonly authorizationRef?: string;
+    readonly verdict?: Readonly<Record<string, unknown>>;
+}
+export interface WorkroomSponsorGateState extends WorkroomAcceptanceWaitState {
+    readonly status: WorkroomAcceptanceWaitStatus | 'approved' | 'rejected' | 'changes_requested';
+    readonly reviewerAssignmentId?: string;
+    readonly sponsorPrincipalId?: string;
+    readonly authorizationRef?: string;
+    readonly decisionReason?: string;
+}
+export interface WorkroomAssignmentState {
+    readonly id: string;
+    readonly taskKey: string;
+    readonly taskRevision: number;
+    readonly revision: number;
+    readonly attempt: number;
+    readonly fence: number;
+    readonly envelopeDigest: string;
+    readonly role: WorkroomExecutionRole;
+    readonly status: WorkroomAssignmentStatus;
+    readonly owner: string;
+    readonly leaseExpiresAt: number;
+    readonly controlDeadline?: number;
+    readonly checkpointRef?: string;
+    readonly checkpointDigest?: string;
+    readonly reportRef?: string;
+    readonly reportDigest?: string;
+    readonly candidateRef?: string;
+    readonly candidateHash?: string;
+    readonly completionReceiptDigest?: string;
+    readonly latestProgress?: Readonly<{
+        summary: string;
+        completedUnits?: number;
+        totalUnits?: number;
+    }>;
+    readonly observationDigests: Readonly<Record<string, string>>;
+    readonly outcome?: 'interrupted' | 'committed' | 'outcome_unknown';
+}
+export interface WorkroomRunState {
+    readonly runId: string;
+    readonly projectId: string;
+    readonly title: string;
+    readonly status: WorkroomRunStatus;
+    readonly sequence: number;
+    readonly now: number;
+    readonly cancelRequested: boolean;
+    readonly replanRequested?: boolean;
+    readonly tasks: Readonly<Record<string, WorkroomTaskState>>;
+    readonly assignments: Readonly<Record<string, WorkroomAssignmentState>>;
+    readonly reviewerAssignments: Readonly<Record<string, WorkroomReviewerAssignmentState>>;
+    readonly sponsorGates: Readonly<Record<string, WorkroomSponsorGateState>>;
+}
+export type WorkroomEventType = 'run.created' | 'plan.admitted' | 'plan.revision_applied' | 'plan_gate.decided' | 'run.control_decided' | 'run.replan_requested' | 'run.cancel_requested' | 'run.cancelled' | 'task.planned' | 'task.blocked' | 'task.blocker_resolved' | 'task.cancel_requested' | 'task.cancelled' | 'task.failed' | 'task.accepted' | 'task.acceptance_pinned' | 'task.acceptance_blocked' | 'reviewer.assigned' | 'reviewer.claimed' | 'reviewer.verdict_recorded' | 'reviewer.expired' | 'sponsor_gate.opened' | 'sponsor_gate.decided' | 'sponsor_gate.expired' | 'task.rework_requested' | 'task.revised' | 'task.plan_revised' | 'assignment.claimed' | 'assignment.started' | 'assignment.progress' | 'assignment.heartbeat' | 'assignment.checkpointed' | 'assignment.checkpoint_requested' | 'assignment.preempted' | 'assignment.execution_completed' | 'assignment.cancel_requested' | 'assignment.cancelled' | 'assignment.lease_expired' | 'scheduler.dispatch_requested' | 'scheduler.priority_changed' | 'scheduler.preemption_requested' | 'scheduler.preemption_checkpoint_acknowledged' | 'scheduler.preemption_timed_out' | 'local_execution.requested' | 'remote_dispatch.requested' | 'clock.advanced';
+export interface WorkroomEvent {
+    readonly version: 1;
+    readonly eventId: string;
+    readonly runId: string;
+    readonly sequence: number;
+    readonly occurredAt: number;
+    readonly type: WorkroomEventType;
+    readonly payload: Readonly<Record<string, unknown>>;
+}
+export type WorkroomEventDraft = Omit<WorkroomEvent, 'version' | 'runId' | 'sequence'>;
+export type WorkroomCommand = Readonly<{
+    type: 'plan_task';
+    taskKey: string;
+    title: string;
+    required: boolean;
+    maxAttempts: number;
+}> | Readonly<{
+    type: 'block_task';
+    taskKey: string;
+    blockerId: string;
+    kind: WorkroomBlockerKind;
+    owner: string;
+    reason: string;
+    deadline: number;
+}> | Readonly<{
+    type: 'resolve_blocker';
+    taskKey: string;
+    blockerId: string;
+}> | Readonly<{
+    type: 'claim_task';
+    taskKey: string;
+    assignmentId: string;
+    assignmentRevision: number;
+    fence: number;
+    envelopeDigest: string;
+    owner: string;
+    role: WorkroomExecutionRole;
+    leaseExpiresAt: number;
+}> | Readonly<{
+    type: 'start_assignment';
+    assignmentId: string;
+}> | Readonly<{
+    type: 'request_rework';
+    taskKey: string;
+    reason: string;
+}> | Readonly<{
+    type: 'revise_task';
+    taskKey: string;
+    title: string;
+    reason: string;
+    maxAttempts: number;
+}> | Readonly<{
+    type: 'cancel_run';
+    reason: string;
+    controlDeadline: number;
+}> | Readonly<{
+    type: 'advance_clock';
+    now: number;
+}>;
+//# sourceMappingURL=kernel-contracts.d.ts.map

package/lib/workroom/kernel-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-contracts.d.ts","sourceRoot":"","sources":["../../src/workroom/kernel-contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,0BAA0B,EAC1B,0BAA0B,EAC1B,gCAAgC,EAChC,wBAAwB,EACxB,uBAAuB,EACvB,gBAAgB,EAChB,4BAA4B,EAC7B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,SAAS,GACT,cAAc,GACd,YAAY,GACZ,WAAW,GACX,WAAW,CAAC;AAEhB,MAAM,MAAM,kBAAkB,GAC1B,OAAO,GACP,SAAS,GACT,WAAW,GACX,qBAAqB,GACrB,YAAY,GACZ,UAAU,GACV,QAAQ,GACR,WAAW,CAAC;AAEhB,MAAM,MAAM,wBAAwB,GAChC,QAAQ,GACR,SAAS,GACT,kBAAkB,GAClB,qBAAqB,GACrB,MAAM,GACN,WAAW,CAAC;AAEhB,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,CAAC;AAC5E,MAAM,MAAM,mBAAmB,GAAG,YAAY,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,GAAG,aAAa,CAAC;AAExG,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,SAAS,CAAC,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC,EAAE,CAAC;CACvE;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;IAC9C,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,0BAA0B,CAAC;IACzD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;IACrD,QAAQ,CAAC,2BAA2B,CAAC,EAAE,MAAM,CAAC;IAC9C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,MAAM,4BAA4B,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,OAAO,CAAC;AAEpG,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,OAAO,CACrB,uBAAuB,EACvB,mBAAmB,GAAG,kBAAkB,GAAG,uBAAuB,CACnE,CAAC;IACF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,gCAAgC,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,SAAS,4BAA4B,EAAE,CAAC;IACjE,QAAQ,CAAC,UAAU,EAAE,0BAA0B,CAAC;CACjD;AAED,MAAM,WAAW,+BAAgC,SAAQ,2BAA2B;IAClF,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,4BAA4B,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAChF,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,wBAAyB,SAAQ,2BAA2B;IAC3E,QAAQ,CAAC,MAAM,EAAE,4BAA4B,GAAG,UAAU,GAAG,UAAU,GAAG,mBAAmB,CAAC;IAC9F,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC;QACjC,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,QAAQ,CAAC,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9D,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,WAAW,GAAG,iBAAiB,CAAC;CACpE;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC,CAAC;IACxE,QAAQ,CAAC,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,+BAA+B,CAAC,CAAC,CAAC;IACxF,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC,CAAC;CAC3E;AAED,MAAM,MAAM,iBAAiB,GACzB,aAAa,GACb,eAAe,GACf,uBAAuB,GACvB,mBAAmB,GACnB,qBAAqB,GACrB,sBAAsB,GACtB,sBAAsB,GACtB,eAAe,GACf,cAAc,GACd,cAAc,GACd,uBAAuB,GACvB,uBAAuB,GACvB,gBAAgB,GAChB,aAAa,GACb,eAAe,GACf,wBAAwB,GACxB,yBAAyB,GACzB,mBAAmB,GACnB,kBAAkB,GAClB,2BAA2B,GAC3B,kBAAkB,GAClB,qBAAqB,GACrB,sBAAsB,GACtB,sBAAsB,GACtB,uBAAuB,GACvB,cAAc,GACd,mBAAmB,GACnB,oBAAoB,GACpB,oBAAoB,GACpB,qBAAqB,GACrB,sBAAsB,GACtB,yBAAyB,GACzB,iCAAiC,GACjC,sBAAsB,GACtB,gCAAgC,GAChC,6BAA6B,GAC7B,sBAAsB,GACtB,0BAA0B,GAC1B,8BAA8B,GAC9B,4BAA4B,GAC5B,gCAAgC,GAChC,8CAA8C,GAC9C,gCAAgC,GAChC,2BAA2B,GAC3B,2BAA2B,GAC3B,gBAAgB,CAAC;AAErB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACrD;AAED,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC,CAAC;AAEvF,MAAM,MAAM,eAAe,GACvB,QAAQ,CAAC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,GACvG,QAAQ,CAAC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,mBAAmB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,GAChJ,QAAQ,CAAC;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,GACzE,QAAQ,CAAC;IACT,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,qBAAqB,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC,GACA,QAAQ,CAAC;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,GAC5D,QAAQ,CAAC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GACrE,QAAQ,CAAC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,GACtG,QAAQ,CAAC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC,GACzE,QAAQ,CAAC;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC"}

package/lib/workroom/kernel-contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=kernel-contracts.js.map

package/lib/workroom/kernel-contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-contracts.js","sourceRoot":"","sources":["../../src/workroom/kernel-contracts.ts"],"names":[],"mappings":""}

package/lib/workroom/kernel-state.d.ts

@@ -0,0 +1,5 @@
+import type { WorkroomCommand, WorkroomEvent, WorkroomEventDraft, WorkroomRunState } from './kernel-contracts.js';
+export declare function replayWorkroom(events: readonly WorkroomEvent[]): WorkroomRunState;
+export declare function decideWorkroom(state: WorkroomRunState, command: WorkroomCommand, event: (type: WorkroomEventDraft['type'], payload: Record<string, unknown>) => WorkroomEventDraft): readonly WorkroomEventDraft[];
+export declare function evolveWorkroom(state: WorkroomRunState, event: WorkroomEvent): WorkroomRunState;
+//# sourceMappingURL=kernel-state.d.ts.map

package/lib/workroom/kernel-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-state.d.ts","sourceRoot":"","sources":["../../src/workroom/kernel-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAIjB,MAAM,uBAAuB,CAAC;AAa/B,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,gBAAgB,CA2BjF;AA0BD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,CAAC,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,kBAAkB,GAChG,SAAS,kBAAkB,EAAE,CA4F/B;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,aAAa,GAAG,gBAAgB,CA2a9F"}