openplanr 1.25.3 → 2.0.1

package/dist/services/operate/planning-bridge.js

@@ -0,0 +1,341 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { assertOperatingPlanningProposalV1, buildOperatingPlanningProposalV1, confirmOperatingPlanningProposalV1, createOperatingDeliveryRouteV1, } from 'planr-pipeline/operate/planning-bridge-v2';
+import { deriveOperatingIntelligenceAssignmentIdV2 } from 'planr-pipeline/operate/scheduler-v2';
+import { sha256Jcs } from 'planr-pipeline/protocol';
+import { loadConfig } from '../config-service.js';
+import { assertPlanningFraming } from './planning-handoff-service.js';
+import { createSpecFromOperatingProposal } from './spec-operating-origin-service.js';
+const PROPOSAL_ID = /^oprop_[a-f0-9]{32}$/u;
+const PROPOSAL_DIRECTORY = 'planning-bridge/proposals';
+function fail(code, message) {
+    throw Object.assign(new Error(message), { code });
+}
+function state(runtime) {
+    return runtime.state;
+}
+function list(record, field) {
+    const value = record[field];
+    return Array.isArray(value) ? value : [];
+}
+function exactBy(records, field, identity, subject) {
+    const matches = records.filter((record) => record[field] === identity);
+    if (matches.length !== 1)
+        fail('E_OPERATE_PLANNING_BINDING', `${subject} is missing or ambiguous in the current operating scope.`);
+    return matches[0];
+}
+function canonicalArtifactValue(runtime, artifactId) {
+    const artifact = exactBy(list(state(runtime), 'artifacts'), 'artifactId', artifactId, 'Accepted Artifact');
+    const bytes = runtime.artifacts.get(artifactId);
+    if (!bytes || artifact.mediaType !== 'application/json' || artifact.encoding !== 'utf-8') {
+        fail('E_OPERATE_PLANNING_CUSTODY', 'An accepted role Artifact lacks canonical JSON custody.');
+    }
+    try {
+        const value = JSON.parse(Buffer.from(bytes).toString('utf8'));
+        if (!value || Array.isArray(value) || sha256Jcs(value) !== artifact.canonicalHash) {
+            fail('E_OPERATE_PLANNING_CUSTODY', 'An accepted role Artifact body does not match its canonical hash.');
+        }
+        return value;
+    }
+    catch (cause) {
+        if (cause?.code === 'E_OPERATE_PLANNING_CUSTODY')
+            throw cause;
+        fail('E_OPERATE_PLANNING_CUSTODY', 'An accepted role Artifact is not valid canonical JSON.');
+    }
+}
+function proposalPath(runtimeRoot, proposalId) {
+    if (!PROPOSAL_ID.test(proposalId))
+        fail('E_OPERATE_PLANNING_INVALID', 'The Planning proposal identity is invalid.');
+    return path.join(runtimeRoot, PROPOSAL_DIRECTORY, `${proposalId}.json`);
+}
+function approvedProposalPath(runtimeRoot, proposalId) {
+    return proposalPath(runtimeRoot, proposalId).replace(/\.json$/u, '.approved.json');
+}
+async function persistApprovedProposal(runtimeRoot, proposalId, proposal, confirmDigest) {
+    const target = approvedProposalPath(runtimeRoot, proposalId);
+    try {
+        await writeFile(target, `${JSON.stringify(proposal, null, 2)}\n`, {
+            encoding: 'utf8',
+            flag: 'wx',
+            mode: 0o600,
+        });
+        return proposal;
+    }
+    catch (cause) {
+        if (cause.code !== 'EEXIST')
+            throw cause;
+        const existing = JSON.parse(await readFile(target, 'utf8'));
+        assertOperatingPlanningProposalV1(existing);
+        const confirmation = existing.confirmation;
+        if (existing.state !== 'approved' ||
+            existing.predecessorProposalHash !== proposal.predecessorProposalHash ||
+            confirmation.previewDigest !== confirmDigest) {
+            fail('E_OPERATE_PLANNING_CONFLICT', 'The Planning confirmation is already bound to different reviewed custody.');
+        }
+        return existing;
+    }
+}
+async function persistProposal(runtimeRoot, proposal) {
+    const target = proposalPath(runtimeRoot, String(proposal.proposalId));
+    const existing = await readFile(target, 'utf8').catch((cause) => {
+        if (cause.code === 'ENOENT')
+            return null;
+        throw cause;
+    });
+    if (existing !== null) {
+        const parsed = JSON.parse(existing);
+        assertOperatingPlanningProposalV1(parsed);
+        const stableProjection = (value) => ({
+            proposalId: value.proposalId,
+            correlationId: value.correlationId,
+            scopeId: value.scopeId,
+            domainId: value.domainId,
+            domainVersion: value.domainVersion,
+            cycleId: value.cycleId,
+            eventHead: value.eventHead,
+            decision: value.decision,
+            action: value.action,
+            deliveryRoute: value.deliveryRoute,
+            acceptedPerspectiveSummaries: value.acceptedPerspectiveSummaries,
+            evidence: value.evidence,
+            omissions: value.omissions,
+            framing: value.framing,
+            metric: value.metric,
+            verification: value.verification,
+            actor: value.actor,
+        });
+        if (sha256Jcs(stableProjection(parsed)) !==
+            sha256Jcs(stableProjection(proposal))) {
+            fail('E_OPERATE_PLANNING_CONFLICT', 'The deterministic proposal identity is already bound to a different reviewed projection.');
+        }
+        return parsed;
+    }
+    await mkdir(path.dirname(target), { recursive: true });
+    try {
+        await writeFile(target, `${JSON.stringify(proposal, null, 2)}\n`, {
+            encoding: 'utf8',
+            flag: 'wx',
+            mode: 0o600,
+        });
+    }
+    catch (cause) {
+        if (cause.code !== 'EEXIST')
+            throw cause;
+        return await persistProposal(runtimeRoot, proposal);
+    }
+    return proposal;
+}
+function proposalFraming(decision, action) {
+    const title = String(action.title);
+    const slug = title
+        .normalize('NFKD')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/gu, '-')
+        .replace(/^-+|-+$/gu, '')
+        .slice(0, 96);
+    if (!slug)
+        fail('E_OPERATE_PLANNING_INVALID', 'The accepted Action title cannot produce a canonical SPEC slug.');
+    const dissent = Array.isArray(decision.dissent) ? decision.dissent : [];
+    const reopen = Array.isArray(decision.reopenConditions)
+        ? decision.reopenConditions
+        : [];
+    const revisit = Array.isArray(decision.revisitConditions)
+        ? decision.revisitConditions
+        : [];
+    return {
+        title,
+        slug,
+        problem: `${String(decision.question)} ${String(decision.outcome)}`,
+        objective: String(action.expectedResult),
+        users: ['Operators accountable for the accepted Action'],
+        scope: [title, String(action.expectedResult)],
+        nonScope: ['Automatic decomposition, PLAN, SHIP, deployment, and external effects'],
+        risks: [String(decision.expectedDownside), ...dissent].filter((value) => value.length > 0),
+        constraints: [...new Set([...reopen, ...revisit])].sort(),
+        requirements: [`Implement ${title} as explicit reviewed Planning work.`],
+        acceptanceOutcomes: [
+            `Delivery evidence remains bound to metric ${String(action.metricId)} and verification plan ${String(action.verificationPlanId)}.`,
+            String(action.expectedResult),
+        ],
+    };
+}
+export async function previewOperatingPlanningSpec(input) {
+    const snapshot = state(input.runtime);
+    const action = exactBy(list(snapshot, 'actions'), 'actionId', input.actionId, 'Action');
+    if (action.state !== 'approved')
+        fail('E_OPERATE_PLANNING_STATE', 'Only a current approved Action can enter Planning work.');
+    const cycleId = String(action.sourceCycleId);
+    if (input.runtime.preferences.cycleDeliveryRoutes[cycleId] !== 'planning-work') {
+        fail('E_OPERATE_PLANNING_ROUTE', 'Only the planning-work delivery route can preview or create a SPEC.');
+    }
+    const decision = exactBy(list(snapshot, 'decisions'), 'decisionId', String(action.sourceDecisionId), 'Decision');
+    if (decision.state !== 'approved' || decision.sourceCycleId !== cycleId) {
+        fail('E_OPERATE_PLANNING_BINDING', 'The Planning Action does not bind one current approved Decision.');
+    }
+    const cycle = exactBy(list(snapshot, 'cycles'), 'cycleId', cycleId, 'Cycle');
+    const actorId = input.actor?.actorId ?? '';
+    if (input.actor?.kind !== 'human' || actorId.length === 0 || actorId !== action.ownerActorId) {
+        fail('E_OPERATE_PLANNING_ACCESS', 'Planning preview requires the exact current human Action owner.');
+    }
+    const membership = input.runtime.preferences.actorMemberships[actorId];
+    if (membership?.role !== 'owner' ||
+        membership.scopeId !== cycle.scopeId ||
+        membership.domainId !== cycle.domainId ||
+        membership.domainVersion !== cycle.domainVersion) {
+        fail('E_OPERATE_PLANNING_ACCESS', 'The Planning Action owner lacks the exact current scope membership.');
+    }
+    const planId = input.runtime.preferences.cycleIntelligencePlanIds[cycleId];
+    if (!planId)
+        fail('E_OPERATE_PLANNING_CUSTODY', 'The accepted operating board lacks its intelligence plan identity.');
+    const intelligencePlan = exactBy(list(snapshot, 'intelligencePlans'), 'planId', planId, 'Intelligence plan');
+    const selectedRoles = Array.isArray(intelligencePlan.selectedRoles)
+        ? intelligencePlan.selectedRoles
+        : [];
+    const acceptedAssignments = selectedRoles.map((selectedRole) => {
+        const roleId = String(selectedRole.roleId);
+        const roleVersion = String(selectedRole.roleVersion);
+        const assignmentId = deriveOperatingIntelligenceAssignmentIdV2(planId, roleId, roleVersion);
+        const assignment = exactBy(list(snapshot, 'assignments'), 'assignmentId', assignmentId, 'Selected role Assignment');
+        const outputContract = assignment.outputContract;
+        const selectedContract = selectedRole.outputContract;
+        if (assignment.cycleId !== cycleId ||
+            assignment.state !== 'validated' ||
+            assignment.roleId !== roleId ||
+            outputContract.schemaId !== selectedContract.schemaId ||
+            outputContract.schemaVersion !== selectedContract.schemaVersion) {
+            fail('E_OPERATE_PLANNING_CUSTODY', 'A selected intelligence role lost its exact Assignment and output-contract binding.');
+        }
+        return assignment;
+    });
+    if (acceptedAssignments.filter((assignment) => assignment.assignmentKind === 'advisor').length ===
+        0 ||
+        acceptedAssignments.filter((assignment) => assignment.assignmentKind === 'challenger')
+            .length !== 1 ||
+        acceptedAssignments.filter((assignment) => assignment.assignmentKind === 'chair').length !== 1) {
+        fail('E_OPERATE_PLANNING_CUSTODY', 'The accepted operating board is incomplete or ambiguous.');
+    }
+    const acceptedOutputs = acceptedAssignments.map((assignment) => {
+        const assignmentId = String(assignment.assignmentId);
+        const roleKind = String(assignment.assignmentKind);
+        const acceptedSubmissions = list(snapshot, 'submissions').filter((submission) => submission.assignmentId === assignmentId && submission.state === 'accepted');
+        if (acceptedSubmissions.length !== 1) {
+            fail('E_OPERATE_PLANNING_CUSTODY', 'A role Assignment does not have one exact accepted Submission.');
+        }
+        const artifacts = list(snapshot, 'artifacts').filter((artifact) => artifact.assignmentId === assignmentId &&
+            artifact.artifactId === acceptedSubmissions[0].artifactId);
+        if (artifacts.length !== 1)
+            fail('E_OPERATE_PLANNING_CUSTODY', 'A role Assignment does not have one exact accepted Artifact.');
+        const artifact = artifacts[0];
+        const outputContract = assignment.outputContract;
+        if (artifact.schemaId !== outputContract.schemaId ||
+            artifact.artifactSchemaVersion !== outputContract.schemaVersion ||
+            artifact.mediaType !== outputContract.mediaType ||
+            artifact.encoding !== outputContract.encoding) {
+            fail('E_OPERATE_PLANNING_CUSTODY', 'A selected role Artifact does not equal its exact Assignment output contract.');
+        }
+        const sourceArtifactValue = canonicalArtifactValue(input.runtime, String(artifact.artifactId));
+        const intelligenceContext = assignment.intelligenceContext;
+        const inputBundle = intelligenceContext?.inputBundle;
+        const bundleArtifactId = inputBundle?.bundleArtifactId;
+        if (typeof bundleArtifactId !== 'string' || bundleArtifactId.length === 0) {
+            fail('E_OPERATE_PLANNING_CUSTODY', 'A selected role Assignment lacks its exact intelligence input-bundle custody.');
+        }
+        const inputBundleValue = canonicalArtifactValue(input.runtime, bundleArtifactId);
+        return {
+            assignmentId,
+            artifactId: String(artifact.artifactId),
+            roleId: String(assignment.roleId),
+            roleKind,
+            sourceArtifactValue,
+            inputBundleValue,
+        };
+    });
+    const scope = {
+        scopeId: String(cycle.scopeId),
+        domainId: String(cycle.domainId),
+        domainVersion: String(cycle.domainVersion),
+    };
+    const createdAt = input.now ?? new Date().toISOString();
+    const verificationPlanId = String(action.verificationPlanId);
+    const verificationPlanEvents = input.runtime.events.filter((event) => event.type === 'verification.plan-recorded' && event.entityId === verificationPlanId);
+    if (verificationPlanEvents.length !== 1) {
+        fail('E_OPERATE_PLANNING_CUSTODY', 'The Action verification plan lacks one exact canonical source Event.');
+    }
+    const route = createOperatingDeliveryRouteV1({
+        state: snapshot,
+        action: action,
+        route: 'planning-work',
+        rationale: 'The accepted Action requires reviewed repository Planning work.',
+        createdAt: String(snapshot.generatedAt),
+    });
+    const resolvedFraming = input.framing
+        ? assertPlanningFraming(input.framing)
+        : proposalFraming(decision, action);
+    const proposal = buildOperatingPlanningProposalV1(snapshot, {
+        scope,
+        decision: {
+            decisionId: String(decision.decisionId),
+            revision: Number(decision.revision),
+            decisionHash: sha256Jcs(decision),
+        },
+        action: {
+            actionId: String(action.actionId),
+            revision: Number(action.revision),
+            actionHash: String(action.actionHash),
+        },
+        deliveryRoute: route,
+        acceptedOutputs: acceptedOutputs,
+        sourceVerificationPlanEvent: verificationPlanEvents[0],
+        omissions: [],
+        framing: resolvedFraming,
+        actor: { actorId, kind: 'human', accessLevel: 'internal' },
+        createdAt,
+        previewExpiresAt: new Date(Date.parse(createdAt) + 10 * 60_000).toISOString(),
+    });
+    return await persistProposal(input.runtimeRoot, proposal);
+}
+export async function createSpecForOperatingPlanning(input) {
+    const stored = JSON.parse(await readFile(proposalPath(input.runtimeRoot, input.proposalId), 'utf8'));
+    assertOperatingPlanningProposalV1(stored);
+    if (input.actor?.kind !== 'human' ||
+        !input.actor.actorId ||
+        input.actor.actorId !== stored.actor.actorId) {
+        fail('E_OPERATE_PLANNING_ACCESS', 'Planning confirmation requires the exact human actor bound by the preview.');
+    }
+    const head = state(input.runtime).eventHead;
+    const reviewedHead = stored.eventHead;
+    if (head.sequence !== reviewedHead.sequence || head.hash !== reviewedHead.hash) {
+        fail('E_OPERATE_PLANNING_STALE', 'The operating Event head changed after this Planning preview.');
+    }
+    const existingApproved = await readFile(approvedProposalPath(input.runtimeRoot, input.proposalId), 'utf8')
+        .then((value) => JSON.parse(value))
+        .catch((cause) => {
+        if (cause.code === 'ENOENT')
+            return null;
+        throw cause;
+    });
+    const approved = existingApproved ??
+        (await persistApprovedProposal(input.runtimeRoot, input.proposalId, confirmOperatingPlanningProposalV1(stored, {
+            actorId: input.actor.actorId,
+            proposalRevision: 1,
+            proposalHash: String(stored.proposalHash),
+            eventHead: stored.eventHead,
+            previewDigest: input.confirmDigest,
+            confirmedAt: input.now ?? new Date().toISOString(),
+        }), input.confirmDigest));
+    assertOperatingPlanningProposalV1(approved);
+    const confirmation = approved.confirmation;
+    if (approved.state !== 'approved' ||
+        approved.predecessorProposalHash !== stored.proposalHash ||
+        confirmation.previewDigest !== input.confirmDigest) {
+        fail('E_OPERATE_PLANNING_CONFLICT', 'The Planning confirmation does not match the reviewed proposal and digest.');
+    }
+    const config = await loadConfig(input.projectDir);
+    return (await createSpecFromOperatingProposal({
+        projectDir: input.projectDir,
+        config,
+        proposal: approved,
+        actor: input.actor,
+    }));
+}
+//# sourceMappingURL=planning-bridge.js.map

package/dist/services/operate/planning-bridge.js.map

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

package/dist/services/operate/planning-handoff-gateway.d.ts

@@ -0,0 +1,47 @@
+import type { OperateClient } from './client.js';
+import type { JsonRecord } from './composition.js';
+import type { OperateSessionBindingV2 } from './session-capability.js';
+export declare class OperatePlanningGatewayErrorV2 extends Error {
+    readonly code: string;
+    readonly status: number;
+    constructor(code: string, message: string, status?: number);
+}
+export type OperatePlanningGatewayActorV2 = {
+    actorId: string;
+    kind: 'human';
+    runtime?: string;
+};
+export type OperatePlanningPreviewRequestV2 = {
+    actionId: string;
+    framing?: JsonRecord;
+    actor: OperatePlanningGatewayActorV2;
+    binding: OperateSessionBindingV2;
+};
+export type OperatePlanningCreateSpecRequestV2 = {
+    proposalId: string;
+    confirmDigest: string;
+    actor: OperatePlanningGatewayActorV2;
+    binding: OperateSessionBindingV2;
+};
+export type OperatePlanningTraceRequestV2 = {
+    specId: string;
+    actor: OperatePlanningGatewayActorV2;
+    binding: Pick<OperateSessionBindingV2, 'actorId' | 'scopeId' | 'domainId' | 'domainVersion'>;
+};
+export declare class OperatePlanningGateway {
+    private readonly client;
+    private readonly projectDir;
+    constructor(client: OperateClient, projectDir: string);
+    private currentView;
+    private assertSessionBinding;
+    private failure;
+    private assertBoundActionId;
+    preview(request: OperatePlanningPreviewRequestV2): Promise<JsonRecord>;
+    createSpec(request: OperatePlanningCreateSpecRequestV2): Promise<JsonRecord>;
+    trace(request: OperatePlanningTraceRequestV2): Promise<JsonRecord>;
+}
+export declare function createOperatePlanningGateway(input: {
+    client: OperateClient;
+    projectDir: string;
+}): OperatePlanningGateway;
+//# sourceMappingURL=planning-handoff-gateway.d.ts.map

package/dist/services/operate/planning-handoff-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning-handoff-gateway.d.ts","sourceRoot":"","sources":["../../../src/services/operate/planning-handoff-gateway.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQnD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAMvE,qBAAa,6BAA8B,SAAQ,KAAK;IAEpD,QAAQ,CAAC,IAAI,EAAE,MAAM;IAErB,QAAQ,CAAC,MAAM;gBAFN,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACN,MAAM,SAAM;CAKxB;AAED,MAAM,MAAM,6BAA6B,GAAG;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,KAAK,EAAE,6BAA6B,CAAC;IACrC,OAAO,EAAE,uBAAuB,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,6BAA6B,CAAC;IACrC,OAAO,EAAE,uBAAuB,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,6BAA6B,CAAC;IACrC,OAAO,EAAE,IAAI,CAAC,uBAAuB,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,eAAe,CAAC,CAAC;CAC9F,CAAC;AAqDF,qBAAa,sBAAsB;IAE/B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBADV,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,MAAM;YAGvB,WAAW;IAqBzB,OAAO,CAAC,oBAAoB;IA2B5B,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,mBAAmB;IAUrB,OAAO,CAAC,OAAO,EAAE,+BAA+B,GAAG,OAAO,CAAC,UAAU,CAAC;IA4BtE,UAAU,CAAC,OAAO,EAAE,kCAAkC,GAAG,OAAO,CAAC,UAAU,CAAC;IA8B5E,KAAK,CAAC,OAAO,EAAE,6BAA6B,GAAG,OAAO,CAAC,UAAU,CAAC;CA2BzE;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,sBAAsB,CAEzB"}

package/dist/services/operate/planning-handoff-gateway.js

@@ -0,0 +1,169 @@
+import { readFile } from 'node:fs/promises';
+import { assertOperateExperienceArtifactV2 } from 'planr-pipeline/protocol';
+import { parseMarkdown } from '../../utils/markdown.js';
+import { assertPlanningFraming, buildOperatingSpecPreviewFromProposal, buildPlanningHandoffCreation, readPlanningHandoffSourceAuthority, readPlanningHandoffTrace, } from './planning-handoff-service.js';
+import { readSpecOperatingOrigin } from './spec-operating-origin-service.js';
+export class OperatePlanningGatewayErrorV2 extends Error {
+    code;
+    status;
+    constructor(code, message, status = 409) {
+        super(message);
+        this.code = code;
+        this.status = status;
+        this.name = code;
+    }
+}
+function eventHead(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new OperatePlanningGatewayErrorV2('OPERATE_BINDING_MISMATCH', 'The Planning binding event head is invalid.', 403);
+    }
+    const candidate = value;
+    if (!Number.isSafeInteger(candidate.sequence) ||
+        candidate.sequence < 0 ||
+        (candidate.hash !== null &&
+            (typeof candidate.hash !== 'string' || !/^sha256:[a-f0-9]{64}$/u.test(candidate.hash)))) {
+        throw new OperatePlanningGatewayErrorV2('OPERATE_BINDING_MISMATCH', 'The Planning binding event head is invalid.', 403);
+    }
+    return {
+        sequence: candidate.sequence,
+        hash: candidate.hash,
+    };
+}
+function sameHead(left, right) {
+    return left.sequence === right.sequence && left.hash === right.hash;
+}
+function assertTraceBinding(request, source) {
+    if (request.actor.kind !== 'human' ||
+        request.actor.actorId !== request.binding.actorId ||
+        request.actor.actorId !== source.actorId ||
+        request.binding.scopeId !== source.scopeId ||
+        request.binding.domainId !== source.domainId ||
+        request.binding.domainVersion !== source.domainVersion) {
+        throw new OperatePlanningGatewayErrorV2('E_OPERATE_PLANNING_ACCESS', 'Planning trace requires the exact owner and source operating scope.', 403);
+    }
+}
+export class OperatePlanningGateway {
+    client;
+    projectDir;
+    constructor(client, projectDir) {
+        this.client = client;
+        this.projectDir = projectDir;
+    }
+    async currentView(cycleId, actorId) {
+        const envelope = await this.client.dispatch({
+            operation: 'operate.experience.get',
+            request: {
+                cycleId,
+                actor: { actorId, kind: 'human', runtime: 'openplanr' },
+                actionBinding: { cycleId, actorId },
+            },
+        });
+        if (!envelope.ok) {
+            throw new OperatePlanningGatewayErrorV2(envelope.error.code, envelope.error.message, envelope.error.code === 'CAPABILITY_DENIED' ? 403 : 409);
+        }
+        const view = envelope.data;
+        assertOperateExperienceArtifactV2('operate-experience-view', view);
+        return view;
+    }
+    assertSessionBinding(binding, view) {
+        const cycles = Array.isArray(view.cycles) ? view.cycles : [];
+        if (binding.actorId !== String(view.actorId) ||
+            binding.scopeId !== String(view.scopeId) ||
+            binding.domainId !== String(view.domainId) ||
+            binding.domainVersion !== String(view.domainVersion) ||
+            !cycles.some((cycle) => String(cycle.cycleId) === binding.cycleId)) {
+            throw new OperatePlanningGatewayErrorV2('OPERATE_BINDING_MISMATCH', 'The Planning session does not match the current operating scope.', 403);
+        }
+        if (!sameHead(binding.eventHead, eventHead(view.eventHead)) ||
+            binding.sourceViewHash !== String(view.viewHash)) {
+            throw new OperatePlanningGatewayErrorV2('OPERATE_SESSION_STALE', 'Actor, scope, Cycle, or Event head changed. Refresh before requesting another Planning preview.', 409);
+        }
+    }
+    failure(_operation, envelope) {
+        const status = envelope.error.code === 'E_OPERATE_PLANNING_ACCESS' ||
+            envelope.error.code === 'CAPABILITY_DENIED'
+            ? 403
+            : 409;
+        throw new OperatePlanningGatewayErrorV2(envelope.error.code, envelope.error.message, status);
+    }
+    assertBoundActionId(actionId, binding) {
+        if (actionId !== binding.actionLocator.subjectId) {
+            throw new OperatePlanningGatewayErrorV2('OPERATE_BINDING_MISMATCH', 'The Planning request must target the bound Action identity.', 403);
+        }
+    }
+    async preview(request) {
+        if (request.actor.kind !== 'human' || request.actor.actorId !== request.binding.actorId) {
+            throw new OperatePlanningGatewayErrorV2('E_OPERATE_PLANNING_ACCESS', 'Planning preview requires the exact current human Action owner.', 403);
+        }
+        this.assertBoundActionId(request.actionId, request.binding);
+        const view = await this.currentView(request.binding.cycleId, request.binding.actorId);
+        this.assertSessionBinding(request.binding, view);
+        const envelope = await this.client.dispatch({
+            operation: 'operate.planning.preview',
+            request: {
+                actionId: request.actionId,
+                actor: { actorId: request.actor.actorId, kind: 'human', runtime: 'openplanr' },
+                framing: request.framing ? assertPlanningFraming(request.framing) : undefined,
+            },
+        });
+        if (!envelope.ok)
+            this.failure('operate.planning.preview', envelope);
+        const proposal = envelope.data;
+        const specPreview = await buildOperatingSpecPreviewFromProposal({
+            projectDir: this.projectDir,
+            proposal,
+        });
+        return Object.freeze({ proposal, specPreview });
+    }
+    async createSpec(request) {
+        if (request.actor.kind !== 'human' || request.actor.actorId !== request.binding.actorId) {
+            throw new OperatePlanningGatewayErrorV2('E_OPERATE_PLANNING_ACCESS', 'Planning confirmation requires the exact human actor bound by the preview.', 403);
+        }
+        const view = await this.currentView(request.binding.cycleId, request.binding.actorId);
+        this.assertSessionBinding(request.binding, view);
+        const envelope = await this.client.dispatch({
+            operation: 'operate.planning.create-spec',
+            request: {
+                proposalId: request.proposalId,
+                confirmDigest: request.confirmDigest,
+                actor: { actorId: request.actor.actorId, kind: 'human', runtime: 'openplanr' },
+            },
+        });
+        if (!envelope.ok)
+            this.failure('operate.planning.create-spec', envelope);
+        const receipt = envelope.data;
+        const origin = await readSpecOperatingOrigin(receipt.specDir);
+        const parsed = parseMarkdown(await readFile(receipt.specFile, 'utf8'));
+        const title = String(parsed.data.title ?? receipt.specId);
+        return buildPlanningHandoffCreation({
+            receipt,
+            origin,
+            title,
+        });
+    }
+    async trace(request) {
+        const source = await readPlanningHandoffSourceAuthority({
+            projectDir: this.projectDir,
+            specId: request.specId,
+        });
+        assertTraceBinding(request, source);
+        const view = await this.currentView(source.cycleId, source.actorId);
+        const cycles = Array.isArray(view.cycles) ? view.cycles : [];
+        if (String(view.actorId) !== source.actorId ||
+            String(view.scopeId) !== source.scopeId ||
+            String(view.domainId) !== source.domainId ||
+            String(view.domainVersion) !== source.domainVersion ||
+            !cycles.some((cycle) => String(cycle.cycleId) === source.cycleId)) {
+            throw new OperatePlanningGatewayErrorV2('E_OPERATE_PLANNING_ACCESS', 'Planning trace source membership is no longer authorized.', 403);
+        }
+        return await readPlanningHandoffTrace({
+            projectDir: this.projectDir,
+            specId: request.specId,
+            authority: source,
+        });
+    }
+}
+export function createOperatePlanningGateway(input) {
+    return new OperatePlanningGateway(input.client, input.projectDir);
+}
+//# sourceMappingURL=planning-handoff-gateway.js.map

package/dist/services/operate/planning-handoff-gateway.js.map

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

package/dist/services/operate/planning-handoff-service.d.ts

@@ -0,0 +1,38 @@
+import type { OpenPlanrConfig } from '../../models/types.js';
+import { type OperatingOriginAuthority, type OperatingSpecCreationReceipt } from './spec-operating-origin-service.js';
+type JsonRecord = Record<string, unknown>;
+/** Validate human-owned Planning framing before preview or create. */
+export declare function assertPlanningFraming(value: JsonRecord): JsonRecord;
+/** Render the exact SPEC bytes OpenPlanr will publish for one reviewed proposal. */
+export declare function buildOperatingSpecPreviewFromProposal(input: {
+    projectDir: string;
+    config?: OpenPlanrConfig;
+    proposal: JsonRecord;
+}): Promise<JsonRecord>;
+export declare function buildPlanningDeliveryProgress(origin: JsonRecord): JsonRecord;
+export declare function buildPlanningHandoffCreation(input: {
+    receipt: OperatingSpecCreationReceipt;
+    origin: JsonRecord;
+    title: string;
+}): JsonRecord;
+export declare function readPlanningHandoffSourceAuthority(input: {
+    projectDir: string;
+    config?: OpenPlanrConfig;
+    specId: string;
+}): Promise<Readonly<{
+    actorId: string;
+    cycleId: string;
+    scopeId: string;
+    domainId: string;
+    domainVersion: string;
+    specId: string;
+    originHash: string;
+}>>;
+export declare function readPlanningHandoffTrace(input: {
+    projectDir: string;
+    config?: OpenPlanrConfig;
+    specId: string;
+    authority?: OperatingOriginAuthority;
+}): Promise<JsonRecord>;
+export {};
+//# sourceMappingURL=planning-handoff-service.d.ts.map

package/dist/services/operate/planning-handoff-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning-handoff-service.d.ts","sourceRoot":"","sources":["../../../src/services/operate/planning-handoff-service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG7D,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,4BAA4B,EAGlC,MAAM,oCAAoC,CAAC;AAE5C,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAkC1C,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CA8BnE;AAyDD,oFAAoF;AACpF,wBAAsB,qCAAqC,CAAC,KAAK,EAAE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,QAAQ,EAAE,UAAU,CAAC;CACtB,GAAG,OAAO,CAAC,UAAU,CAAC,CAyCtB;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CA6D5E;AAoBD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,OAAO,EAAE,4BAA4B,CAAC;IACtC,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,UAAU,CAWb;AAED,wBAAsB,kCAAkC,CAAC,KAAK,EAAE;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;;;;;;;;IAWA;AAED,wBAAsB,wBAAwB,CAAC,KAAK,EAAE;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,wBAAwB,CAAC;CACtC,GAAG,OAAO,CAAC,UAAU,CAAC,CAgDtB"}