openplanr 1.25.3 → 2.0.0

package/dist/services/operate/assignment-lifecycle-service.js

@@ -0,0 +1,113 @@
+import { sha256Jcs } from 'planr-pipeline/protocol';
+import { retryReplaySafeGenerationConflict, withOperateMutationLane, } from './replay-safe-retry-service.js';
+function records(value) {
+    return Array.isArray(value) ? value : [];
+}
+function record(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : {};
+}
+/**
+ * Own the complete public claim preparation and replay selection. The client facade supplies
+ * only persistence and ID/time capabilities; claimant and retained-custody rules stay here.
+ */
+export function claimRuntimeAssignment(input) {
+    const { composition, request, runtimeState, issue, refuse } = input;
+    if (!request.actor.actorId || !request.actor.runtime || request.actor.kind !== 'agent') {
+        return refuse('CAPABILITY_DENIED', 'An agent identity and runtime are required to claim an Assignment.');
+    }
+    const assignment = records(runtimeState.assignments).find((candidate) => candidate.assignmentId === request.assignmentId);
+    let claimId = issue.id('clm');
+    let submissionId = issue.id('sub');
+    if (assignment?.state === 'running') {
+        const retainedClaim = record(assignment.claim);
+        const issuedSubmissions = records(runtimeState.submissions).filter((submission) => submission.assignmentId === assignment.assignmentId && submission.state === 'issued');
+        if (typeof retainedClaim.claimId !== 'string' ||
+            retainedClaim.claimId.length === 0 ||
+            issuedSubmissions.length !== 1) {
+            return refuse('OPERATE_STORE_CORRUPT', 'The running Assignment lost its exact retained claim or issued Submission.', { assignmentId: request.assignmentId });
+        }
+        claimId = retainedClaim.claimId;
+        submissionId = String(issuedSubmissions[0].submissionId);
+    }
+    const claimed = composition.claimAssignment(request, {
+        claimId,
+        submissionId,
+        eventIds: { claimed: issue.id('evt'), started: issue.id('evt') },
+        timestamp: issue.timestamp(),
+        correlationId: issue.id('corr'),
+    }, runtimeState);
+    return Object.freeze({
+        ...claimed,
+        cycleId: String(record(claimed.response.assignment).cycleId),
+    });
+}
+/**
+ * Own the complete replay-safe claim transaction. The client facade supplies durable runtime
+ * access and commit custody, while this service owns retry identity, mutation serialization,
+ * claimant validation, exact claim replay, and the response's only permitted next action.
+ */
+export async function claimOperateAssignment(input) {
+    const nextIssue = input.issueFactory();
+    return await retryReplaySafeGenerationConflict(`claim:${sha256Jcs(input.request)}`, () => withOperateMutationLane(input.root, async () => {
+        const runtime = await input.requiredRuntime();
+        const composition = await input.composition();
+        const claimed = claimRuntimeAssignment({
+            composition,
+            request: input.request,
+            runtimeState: runtime.state,
+            issue: nextIssue(),
+            refuse: input.refuse,
+        });
+        if (!claimed.replayed) {
+            await input.commit(runtime, claimed.state, claimed.events);
+        }
+        return {
+            ok: true,
+            operation: 'operate.assignment.claim',
+            data: claimed.response,
+            allowedActions: [
+                {
+                    tool: 'operate.cycle.get',
+                    arguments: { cycleId: claimed.cycleId },
+                    label: 'Inspect the current cycle',
+                    effect: 'read-only',
+                },
+            ],
+        };
+    }));
+}
+/**
+ * Resolve the runtime-owned reservation and construct the replay-stable Submission draft before
+ * any bytes are staged. Post-acceptance Chair/verification workflows remain separate consumers.
+ */
+export function stageRuntimeAssignmentSubmission(input) {
+    const { composition, request, runtimeState, artifactBytes, assignmentArtifactIds, issue, refuse, } = input;
+    const assignment = records(runtimeState.assignments).find((candidate) => candidate.assignmentId === request.assignmentId);
+    if (!assignment) {
+        return refuse('ASSIGNMENT_NOT_AVAILABLE', 'The requested assignment does not exist.', {
+            assignmentId: request.assignmentId,
+        });
+    }
+    const artifactId = assignmentArtifactIds[request.assignmentId];
+    if (!artifactId) {
+        return refuse('OPERATE_STORE_CORRUPT', 'The Assignment is missing its runtime-owned Artifact reservation.', { assignmentId: request.assignmentId });
+    }
+    const acceptedAt = typeof assignment.completedAt === 'string' ? assignment.completedAt : issue.timestamp();
+    const accepted = composition.acceptSubmission(request, {
+        artifactId,
+        artifactType: `${String(assignment.roleId)}-result`,
+        inputArtifactIds: assignment.inputArtifactIds,
+        timestamp: acceptedAt,
+        validatorVersion: 'openplanr-operate',
+        correlationId: issue.stableId('corr', request.submissionId),
+        eventIds: {
+            submitted: issue.stableId('evt', `${request.submissionId}:submitted`),
+            artifactCreated: issue.stableId('evt', `${request.submissionId}:artifact-created`),
+            validated: issue.stableId('evt', `${request.submissionId}:validated`),
+        },
+    }, runtimeState, artifactBytes);
+    return Object.freeze({ assignment, accepted });
+}
+//# sourceMappingURL=assignment-lifecycle-service.js.map

package/dist/services/operate/assignment-lifecycle-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assignment-lifecycle-service.js","sourceRoot":"","sources":["../../../src/services/operate/assignment-lifecycle-service.ts"],"names":[],"mappings":"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"}

package/dist/services/operate/assignment-packet-service.d.ts

@@ -0,0 +1,79 @@
+import { type OperateActorV2, type OperateClient } from './client.js';
+type JsonRecord = Record<string, unknown>;
+declare const PACKET_FORMAT = "openplanr-operate-assignment-packet";
+declare const PACKET_VERSION = "1.0.0";
+declare const PROTOCOL_VERSION = "2.0.0";
+type PacketContractKind = 'operating-advisor-result' | 'operating-challenger-review' | 'operating-decision-ledger';
+export type OperateAssignmentPacket = Readonly<{
+    kind: typeof PACKET_FORMAT;
+    schemaVersion: typeof PACKET_VERSION;
+    protocolVersion: typeof PROTOCOL_VERSION;
+    packetId: string;
+    assignmentId: string;
+    cycleId: string;
+    submissionId: string;
+    actor: OperateActorV2;
+    contractKind: PacketContractKind;
+    roleId: string;
+    roleVersion: string;
+    analysisProfile: JsonRecord;
+    intelligencePlanId: string;
+    snapshotId: string;
+    scope: {
+        scopeId: string;
+        domainId: string;
+        domainVersion: string;
+    };
+    inputArtifactIds: string[];
+    inputAbsenceIds: string[];
+    outputContract: JsonRecord;
+    createdAt: string;
+}>;
+export type PacketValidationFailure = Readonly<{
+    pointer: string;
+    rule: string;
+    message: string;
+}>;
+export declare class OperateAssignmentPacketService {
+    private readonly projectDir;
+    private readonly clientFactory;
+    private readonly hooks;
+    constructor(projectDir: string, clientFactory?: (projectDir: string) => OperateClient, hooks?: {
+        afterReceiptBackup?: () => Promise<void>;
+        afterReceiptPromote?: () => Promise<void>;
+    });
+    private assertPacketCustody;
+    private packetsRoot;
+    private recoverInterruptedReceiptSwaps;
+    private packet;
+    private assertSameCustody;
+    prepare(input: {
+        assignmentId: string;
+        actorId: string;
+        runtime: string;
+    }): Promise<{
+        packet: OperateAssignmentPacket;
+        directory: string;
+        resultPath: string;
+        templatePath: string;
+        assignmentPath: string;
+        rubricPath: string;
+        schemaCatalogPath: string;
+        evidenceMatrixPath: string;
+        replayed: boolean;
+    }>;
+    validate(packetId: string, bytes: Uint8Array): Promise<{
+        ok: boolean;
+        packetId: string;
+        contractKind: PacketContractKind;
+        errors: PacketValidationFailure[];
+    }>;
+    submit(packetId: string, bytes: Uint8Array): Promise<JsonRecord>;
+    recoverAbandoned(options: {
+        olderThanMs: number;
+        now?: number;
+    }): Promise<string[]>;
+}
+export declare function createOperateAssignmentPacketService(projectDir: string): OperateAssignmentPacketService;
+export {};
+//# sourceMappingURL=assignment-packet-service.d.ts.map

package/dist/services/operate/assignment-packet-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assignment-packet-service.d.ts","sourceRoot":"","sources":["../../../src/services/operate/assignment-packet-service.ts"],"names":[],"mappings":"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"}