@cats-inc/cats-platform 0.1.21 → 0.3.4

package/build/server/products/work/state/workGoldenPathPublish.js

@@ -0,0 +1,488 @@
+/**
+ * Gated publication for the golden path (SPEC-114 FR-40..FR-42).
+ *
+ * Execution authorization and publication authorization are different risk
+ * boundaries. Confirming "Start work" said the owner accepted a *scope*; it
+ * never said they accepted a side effect that only became visible once the work
+ * ran. So a gated mode stops at `result_ready` and asks again.
+ *
+ * The publish decision is an ordinary Cats Core approval — a Task in
+ * `pending_approval` bound to the Run by a `release_gate` binding — which means
+ * it appears in the existing approval queue and Desktop surfaces for free, and
+ * no transport ever infers it.
+ */
+import { createHash } from 'node:crypto';
+import { appendCoreActivity, upsertCoreApprovalBinding, upsertCoreTask, writeApprovalDecision, } from '../../../core/model/index.js';
+export const WORK_GOLDEN_PATH_PUBLISH_METADATA_KEY = 'workGoldenPathPublish';
+/**
+ * External actions each mode performs at publish time, in order.
+ *
+ * This mirrors `deliveryActionsForMode` in `core/governance.ts`; that function
+ * declares what a mode *means*, this one is what actually runs.
+ */
+const PUBLISH_ACTIONS = {
+    artifact_only: [],
+    commit_only: [],
+    push_branch: ['push_branch'],
+    pr_with_checks: ['push_branch', 'open_pull_request', 'wait_for_checks'],
+    deploy_preview: ['push_branch', 'publish_preview'],
+};
+/**
+ * Stable over the scope the owner is being asked to publish.
+ *
+ * Excludes the owner event, so a double tap converges on the same publish
+ * rather than performing the side effect twice (FR-42).
+ */
+export function buildWorkGoldenPathPublishKey(input) {
+    return [
+        'wgp-publish',
+        input.bindingId,
+        input.workItemId,
+        String(input.proposalRevision),
+        input.proposalDigest,
+        input.deliveryMode,
+    ].join(':');
+}
+function publishApprovalTaskId(publishKey) {
+    return `task-wgp-publish-${createHash('sha256').update(publishKey).digest('hex').slice(0, 20)}`;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function readPublishEnvelope(metadata) {
+    const envelope = isRecord(metadata)
+        ? metadata[WORK_GOLDEN_PATH_PUBLISH_METADATA_KEY]
+        : null;
+    if (!isRecord(envelope)) {
+        return null;
+    }
+    return {
+        publishKey: typeof envelope.publishKey === 'string' ? envelope.publishKey : null,
+        performedActions: Array.isArray(envelope.performedActions)
+            ? envelope.performedActions
+            : [],
+        reference: typeof envelope.reference === 'string' ? envelope.reference : null,
+        completedAt: typeof envelope.completedAt === 'string' ? envelope.completedAt : null,
+        pendingOperationId: typeof envelope.pendingOperationId === 'string'
+            ? envelope.pendingOperationId
+            : null,
+    };
+}
+/**
+ * Creates (or resolves) the pending publish approval.
+ *
+ * The approval Task carries the effective policy, the exact proposal revision,
+ * and the publish key, so an owner deciding it later is deciding the same thing
+ * they were shown (FR-42).
+ */
+export async function requestWorkGoldenPathPublishApproval(coreStore, input, now = () => new Date()) {
+    const publishKey = buildWorkGoldenPathPublishKey({
+        bindingId: input.bindingId,
+        workItemId: input.workItemId,
+        proposalRevision: input.proposal.revision,
+        proposalDigest: input.proposal.digest,
+        deliveryMode: input.proposal.deliveryMode,
+    });
+    const approvalTaskId = publishApprovalTaskId(publishKey);
+    let created = false;
+    await coreStore.updateCore((core) => {
+        if (core.tasks.some((task) => task.id === approvalTaskId)) {
+            return core;
+        }
+        const taskWrite = upsertCoreTask(core, {
+            id: approvalTaskId,
+            title: `Publish: ${input.proposal.goal}`,
+            status: 'pending_approval',
+            conversationId: input.proposal.projectId === null ? null : null,
+            ownerActorId: input.ownerActorId,
+            orchestratorActorId: input.actorRef,
+            assignedActorIds: [],
+            summary: `Authorize ${input.proposal.deliveryMode} publication for `
+                + `"${input.proposal.goal}".`,
+            metadata: {
+                [WORK_GOLDEN_PATH_PUBLISH_METADATA_KEY]: {
+                    schemaVersion: 1,
+                    publishKey,
+                    bindingId: input.bindingId,
+                    workItemId: input.workItemId,
+                    runId: input.runId,
+                    executionTaskId: input.taskId,
+                    proposalRevision: input.proposal.revision,
+                    proposalDigest: input.proposal.digest,
+                    deliveryMode: input.proposal.deliveryMode,
+                    effectiveGates: [...input.outstandingGates],
+                    requestedActions: PUBLISH_ACTIONS[input.proposal.deliveryMode] ?? null,
+                    workspacePath: input.deliveryWorkspacePath,
+                    sessionId: input.deliverySessionId,
+                },
+            },
+        }, now());
+        const approvalWrite = writeApprovalDecision(taskWrite.core, {
+            taskId: approvalTaskId,
+            status: 'pending',
+            requestedByActorId: input.actorRef,
+            notes: `Publication requires an owner decision: `
+                + `${input.outstandingGates.join(', ')}.`,
+        }, now());
+        const bindingWrite = upsertCoreApprovalBinding(approvalWrite.core, {
+            id: `approval-binding-${approvalTaskId}`,
+            // The gate is about releasing a result, not about starting work.
+            kind: 'release_gate',
+            approvalTaskId,
+            subjectKind: 'run',
+            subjectId: input.runId,
+            projectId: input.proposal.projectId,
+            workItemId: input.workItemId,
+            conversationId: null,
+            requestedByActorId: input.actorRef,
+            requestedForActorId: input.ownerActorId,
+            metadata: {
+                [WORK_GOLDEN_PATH_PUBLISH_METADATA_KEY]: { schemaVersion: 1, publishKey },
+            },
+        }, now());
+        created = true;
+        return appendCoreActivity(bindingWrite.core, {
+            id: `activity-wgp-publish-requested-${approvalTaskId}`,
+            kind: 'approval_requested',
+            actorId: input.actorRef,
+            projectId: input.proposal.projectId,
+            workItemId: input.workItemId,
+            conversationId: null,
+            taskId: approvalTaskId,
+            runId: input.runId,
+            message: `Publication approval requested for "${input.proposal.goal}".`,
+            metadata: {
+                [WORK_GOLDEN_PATH_PUBLISH_METADATA_KEY]: {
+                    schemaVersion: 1,
+                    publishKey,
+                    gates: [...input.outstandingGates],
+                },
+            },
+        }, now()).core;
+    });
+    return { approvalTaskId, publishKey, created };
+}
+function findPendingPublishTask(core, workItemId) {
+    return core.tasks.find((task) => {
+        const envelope = readPublishEnvelope(task.metadata);
+        if (envelope === null) {
+            return false;
+        }
+        const raw = task.metadata[WORK_GOLDEN_PATH_PUBLISH_METADATA_KEY];
+        return isRecord(raw) && raw.workItemId === workItemId;
+    }) ?? null;
+}
+/**
+ * Performs the mode's external actions.
+ *
+ * Any blocked action stops the sequence: a half-published result (pushed but no
+ * pull request) is worse than one the owner can retry deliberately.
+ */
+async function performPublishActions(input) {
+    const performed = [...input.alreadyPerformed];
+    let reference = null;
+    for (const action of input.actions) {
+        // Per-action idempotency. A wait that timed out must not re-push and
+        // re-open the pull request when the owner comes back to it.
+        if (performed.includes(action)) {
+            continue;
+        }
+        let outcome;
+        if (action === 'push_branch') {
+            outcome = await input.deliveryClient.pushBranch({
+                workspacePath: input.workspacePath,
+                sessionId: input.sessionId,
+                approvalRef: input.approvalRef,
+            });
+        }
+        else if (action === 'open_pull_request') {
+            outcome = await input.deliveryClient.openPullRequest({
+                workspacePath: input.workspacePath,
+                sessionId: input.sessionId,
+                approvalRef: input.approvalRef,
+                title: input.goal,
+                body: `Opened by Cats for "${input.goal}".`,
+            });
+        }
+        else if (action === 'wait_for_checks') {
+            outcome = await input.deliveryClient.waitForChecks({
+                workspacePath: input.workspacePath,
+                sessionId: input.sessionId,
+                approvalRef: input.approvalRef,
+                resumeOperationId: input.resumeOperationId,
+            });
+        }
+        else if (action === 'publish_preview') {
+            outcome = await input.deliveryClient.publishPreview({
+                workspacePath: input.workspacePath,
+                sessionId: input.sessionId,
+                approvalRef: input.approvalRef,
+            });
+        }
+        else {
+            return {
+                performed,
+                reference,
+                pendingOperationId: null,
+                blockedReasons: [`unsupported_publish_action:${action}`],
+            };
+        }
+        if (outcome.state === 'pending') {
+            // Nothing was refused and nothing more can be done yet. The actions that
+            // already landed stay landed.
+            return {
+                performed,
+                reference,
+                pendingOperationId: outcome.pendingOperationId,
+                blockedReasons: [],
+            };
+        }
+        if (outcome.state !== 'completed') {
+            return {
+                performed,
+                reference,
+                pendingOperationId: null,
+                blockedReasons: outcome.blockedReasons.length > 0
+                    ? outcome.blockedReasons
+                    : [`${action}_not_completed`],
+            };
+        }
+        performed.push(action);
+        reference = outcome.reference ?? reference;
+    }
+    return { performed, reference, pendingOperationId: null, blockedReasons: [] };
+}
+/**
+ * Applies the owner's publish decision.
+ *
+ * Approving twice returns the recorded result instead of pushing again: the
+ * approval Task's metadata is the idempotency record (FR-42).
+ */
+export async function applyWorkGoldenPathPublishDecision(coreStore, input, now = () => new Date()) {
+    const core = await coreStore.readCore();
+    const approvalTask = findPendingPublishTask(core, input.workItemId);
+    if (approvalTask === null) {
+        return {
+            status: 'not_pending',
+            publishKey: '',
+            approvalTaskId: '',
+            performedActions: [],
+            reference: null,
+            pendingOperationId: null,
+            blockedReasons: ['no_publish_approval_pending'],
+        };
+    }
+    const raw = approvalTask.metadata[WORK_GOLDEN_PATH_PUBLISH_METADATA_KEY];
+    const envelope = isRecord(raw) ? raw : {};
+    const publishKey = typeof envelope.publishKey === 'string' ? envelope.publishKey : '';
+    const recorded = readPublishEnvelope(approvalTask.metadata);
+    if (recorded?.completedAt) {
+        return {
+            status: 'already_published',
+            publishKey,
+            approvalTaskId: approvalTask.id,
+            performedActions: recorded.performedActions,
+            reference: recorded.reference,
+            pendingOperationId: null,
+            blockedReasons: [],
+        };
+    }
+    if (input.decision === 'deny') {
+        await coreStore.updateCore((state) => {
+            const denied = writeApprovalDecision(state, {
+                taskId: approvalTask.id,
+                status: 'rejected',
+                action: 'reject',
+                decidedByActorId: input.ownerActorId,
+                notes: 'Owner declined publication.',
+                taskStatus: 'cancelled',
+            }, now());
+            return appendCoreActivity(denied.core, {
+                id: `activity-wgp-publish-denied-${approvalTask.id}`,
+                kind: 'approval_decided',
+                actorId: input.ownerActorId,
+                workItemId: input.workItemId,
+                taskId: approvalTask.id,
+                runId: typeof envelope.runId === 'string' ? envelope.runId : null,
+                message: 'Owner declined publication; the result stays unpublished.',
+                metadata: {
+                    [WORK_GOLDEN_PATH_PUBLISH_METADATA_KEY]: { schemaVersion: 1, publishKey },
+                },
+            }, now()).core;
+        });
+        return {
+            status: 'denied',
+            publishKey,
+            approvalTaskId: approvalTask.id,
+            performedActions: [],
+            reference: null,
+            pendingOperationId: null,
+            blockedReasons: [],
+        };
+    }
+    const deliveryMode = envelope.deliveryMode;
+    const actions = deliveryMode ? PUBLISH_ACTIONS[deliveryMode] : undefined;
+    const workspacePath = typeof envelope.workspacePath === 'string'
+        ? envelope.workspacePath
+        : null;
+    const sessionId = typeof envelope.sessionId === 'string' ? envelope.sessionId : null;
+    if (actions === undefined) {
+        return {
+            status: 'blocked',
+            publishKey,
+            approvalTaskId: approvalTask.id,
+            performedActions: [],
+            reference: null,
+            pendingOperationId: null,
+            blockedReasons: [`unsupported_delivery_mode:${deliveryMode ?? 'unknown'}`],
+        };
+    }
+    // Actions a previous attempt already landed. A wait that timed out leaves the
+    // push and the pull request behind, and neither may happen twice.
+    let performed = recorded?.performedActions ?? [];
+    let reference = recorded?.reference ?? null;
+    let pendingOperationId = null;
+    let blockedReasons = [];
+    if (actions.length > 0) {
+        if (input.deliveryClient === undefined || (workspacePath === null && sessionId === null)) {
+            blockedReasons = ['publish_transport_unavailable'];
+        }
+        else {
+            try {
+                const outcome = await performPublishActions({
+                    actions,
+                    alreadyPerformed: performed,
+                    deliveryClient: input.deliveryClient,
+                    workspacePath,
+                    sessionId,
+                    // The Core approval id is the authorization the runtime records.
+                    approvalRef: approvalTask.id,
+                    goal: approvalTask.title.replace(/^Publish:\s*/u, ''),
+                    resumeOperationId: recorded?.pendingOperationId ?? null,
+                });
+                performed = outcome.performed;
+                reference = outcome.reference ?? reference;
+                pendingOperationId = outcome.pendingOperationId;
+                blockedReasons = outcome.blockedReasons;
+            }
+            catch (error) {
+                blockedReasons = [error instanceof Error ? error.message : 'publish_failed'];
+            }
+        }
+    }
+    // Whatever landed is persisted before returning, blocked or not, so a later
+    // attempt resumes rather than restarts.
+    if (blockedReasons.length > 0 || pendingOperationId !== null) {
+        await stampPublishProgress(coreStore, {
+            approvalTask,
+            envelope,
+            performed,
+            reference,
+            pendingOperationId,
+        }, now);
+    }
+    if (pendingOperationId !== null) {
+        // The external work is under way and nothing was refused. The approval stays
+        // pending so the owner can come back to it, and nothing is delivered yet.
+        return {
+            status: 'pending_checks',
+            publishKey,
+            approvalTaskId: approvalTask.id,
+            performedActions: performed,
+            reference,
+            pendingOperationId,
+            blockedReasons: [],
+        };
+    }
+    if (blockedReasons.length > 0) {
+        // The approval stays pending so the owner can retry deliberately rather
+        // than having their decision consumed by a transport failure.
+        return {
+            status: 'blocked',
+            publishKey,
+            approvalTaskId: approvalTask.id,
+            performedActions: performed,
+            reference,
+            pendingOperationId: null,
+            blockedReasons,
+        };
+    }
+    const completedAt = now().toISOString();
+    await coreStore.updateCore((state) => {
+        const approved = writeApprovalDecision(state, {
+            taskId: approvalTask.id,
+            status: 'approved',
+            action: 'approve',
+            decidedByActorId: input.ownerActorId,
+            notes: 'Owner authorized publication.',
+            taskStatus: 'completed',
+        }, now());
+        const stamped = upsertCoreTask(approved.core, {
+            id: approvalTask.id,
+            title: approvalTask.title,
+            status: 'completed',
+            ownerActorId: approvalTask.ownerActorId,
+            metadata: {
+                ...approvalTask.metadata,
+                [WORK_GOLDEN_PATH_PUBLISH_METADATA_KEY]: {
+                    ...envelope,
+                    performedActions: performed,
+                    reference,
+                    completedAt,
+                    decidedByActorId: input.ownerActorId,
+                },
+            },
+        }, now());
+        return appendCoreActivity(stamped.core, {
+            id: `activity-wgp-publish-approved-${approvalTask.id}`,
+            kind: 'approval_decided',
+            actorId: input.ownerActorId,
+            workItemId: input.workItemId,
+            taskId: approvalTask.id,
+            runId: typeof envelope.runId === 'string' ? envelope.runId : null,
+            message: performed.length > 0
+                ? `Owner authorized publication; performed ${performed.join(', ')}.`
+                : 'Owner authorized publication; no external action was required.',
+            metadata: {
+                [WORK_GOLDEN_PATH_PUBLISH_METADATA_KEY]: {
+                    schemaVersion: 1,
+                    publishKey,
+                    performedActions: performed,
+                    reference,
+                },
+            },
+        }, now()).core;
+    });
+    return {
+        status: 'published',
+        publishKey,
+        approvalTaskId: approvalTask.id,
+        performedActions: performed,
+        reference,
+        pendingOperationId: null,
+        blockedReasons: [],
+    };
+}
+/**
+ * Persists partial publish progress without deciding the approval.
+ *
+ * The approval stays `pending`: the owner has not been answered yet, and their
+ * decision must not be consumed by an unfinished wait.
+ */
+async function stampPublishProgress(coreStore, input, now) {
+    await coreStore.updateCore((state) => upsertCoreTask(state, {
+        id: input.approvalTask.id,
+        title: input.approvalTask.title,
+        ownerActorId: input.approvalTask.ownerActorId,
+        metadata: {
+            ...input.approvalTask.metadata,
+            [WORK_GOLDEN_PATH_PUBLISH_METADATA_KEY]: {
+                ...input.envelope,
+                performedActions: input.performed,
+                reference: input.reference,
+                pendingOperationId: input.pendingOperationId,
+            },
+        },
+    }, now()).core);
+}
+//# sourceMappingURL=workGoldenPathPublish.js.map

package/build/server/products/work/state/workGoldenPathPublish.js.map

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

package/build/server/products/work/state/workGoldenPathRunner.d.ts

@@ -0,0 +1,121 @@
+/**
+ * The supervised-run driver for the golden path (SPEC-114 FR-28..FR-31,
+ * PLAN-105 Phase 4).
+ *
+ * Before this module the run loop stopped after one provider response: the Run
+ * was marked `running`, a handoff decision was recorded, and nothing consumed
+ * it. That is the seam this closes.
+ *
+ * The controlling rule is FR-30. A provider step returning successfully is
+ * evidence that a *step* returned, never that the goal was met, so the provider
+ * is never allowed to declare completion. After every step Cats re-evaluates
+ * the acceptance criteria itself and either continues with the gaps as the next
+ * instruction, or accepts terminal evidence. That inversion is what stops
+ * "I have finished the task." from ending a run.
+ */
+import type { CoreStore } from '../../../core/store.js';
+import type { CoreDeliveryMode, ExecutionTargetSummary } from '../../../core/types.js';
+import type { SupervisionToolScope } from '../../../platform/supervision/contracts.js';
+import type { TransportWorkStage } from '../../../platform/transports/work-delivery/contracts.js';
+import { type WorkCommitEvidence, type WorkCompletionEvidenceGap, type WorkCompletionEvidenceResult } from './workCompletionEvidence.js';
+import type { WorkGoldenPathService } from './workGoldenPathService.js';
+/** Where a refusal is recorded on the Run, for the Desktop read model. */
+export declare const WORK_GOLDEN_PATH_DENIAL_METADATA_KEY = "workGoldenPathDenial";
+export interface WorkGoldenPathArtifactEvidence {
+    title: string;
+    path: string | null;
+    mimeType: string | null;
+    /** Runtime-owned location from which a later gated publish must resume. */
+    deliveryWorkspacePath?: string | null;
+    /** Runtime session that materialized the artifact. */
+    deliverySessionId?: string | null;
+}
+export interface WorkGoldenPathStepContext {
+    runId: string;
+    taskId: string | null;
+    workItemId: string;
+    /** Zero-based; step 0 opens the session. */
+    stepIndex: number;
+    goal: string;
+    acceptanceCriteria: readonly string[];
+    deliveryMode: CoreDeliveryMode;
+    workspacePath: string | null;
+    executionTarget?: ExecutionTargetSummary | null;
+    toolScope?: SupervisionToolScope;
+    workspaceHeadOid?: string | null;
+    /**
+     * What was still missing after the previous step.
+     *
+     * This is the whole continuation signal: the executor turns it into the next
+     * instruction, so the agent is told what remains rather than asked again.
+     */
+    outstandingGaps: readonly WorkCompletionEvidenceGap[];
+    outstandingCriteria: readonly string[];
+}
+/**
+ * A step refused by the supervision boundary rather than by the provider.
+ *
+ * Kept distinct from a generic failure because the remedy is different: no
+ * amount of retrying helps until the owner widens the permission envelope, so
+ * the owner has to be told *what* to grant, not that "something went wrong".
+ */
+export interface WorkGoldenPathPermissionDenial {
+    /** The supervised tool that was refused. */
+    toolName: string;
+    /** The boundary's rejection code, e.g. `E_TOOL_SCOPE_DENIED`. */
+    code: string;
+}
+export interface WorkGoldenPathStepResult {
+    /**
+     * `continue` and `claims_complete` are both non-terminal from Cats' point of
+     * view; only the evidence check can end a run successfully.
+     */
+    status: 'continue' | 'claims_complete' | 'blocked' | 'permission_denied' | 'failed';
+    summary: string;
+    /** Criteria the step claims to have satisfied. Verified, never trusted. */
+    satisfiedCriteria: readonly string[];
+    artifact: WorkGoldenPathArtifactEvidence | null;
+    commit: WorkCommitEvidence | null;
+    blockedReason: string | null;
+    /** Present only when `status` is `permission_denied`. */
+    denial?: WorkGoldenPathPermissionDenial | null;
+}
+export type WorkGoldenPathStepExecutor = (context: WorkGoldenPathStepContext) => Promise<WorkGoldenPathStepResult>;
+export type WorkGoldenPathRunStatus = 'delivered' | 'result_ready' | 'blocked' | 'permission_denied' | 'timed_out' | 'failed' | 'cancelled' | 'not_runnable';
+export interface WorkGoldenPathRunOutcome {
+    status: WorkGoldenPathRunStatus;
+    steps: number;
+    evidence: WorkCompletionEvidenceResult | null;
+    stage: TransportWorkStage | null;
+    reason: string | null;
+}
+export interface WorkGoldenPathRunnerOptions {
+    coreStore: CoreStore;
+    service: WorkGoldenPathService;
+    executeStep: WorkGoldenPathStepExecutor;
+    maxSteps?: number;
+    /**
+     * Wall-clock ceiling for a single step.
+     *
+     * A provider call cannot be cancelled from here, so a timed-out step is
+     * abandoned rather than killed: the Run is blocked for the owner and the
+     * terminal-state guard makes the late result harmless if it ever arrives.
+     */
+    stepTimeoutMs?: number;
+    now?: () => Date;
+}
+export interface WorkGoldenPathRunner {
+    /**
+     * Drives one Run to a terminal or owner-blocking state.
+     *
+     * Safe to call concurrently for the same Run: a second call joins the first
+     * rather than starting a second execution. Admission, an owner retry, and the
+     * startup sweep can all fire for one Run, and none of them can know about the
+     * others.
+     */
+    drive(input: {
+        runId: string;
+    }): Promise<WorkGoldenPathRunOutcome>;
+}
+export declare function createWorkGoldenPathRunner(options: WorkGoldenPathRunnerOptions): WorkGoldenPathRunner;
+//# sourceMappingURL=workGoldenPathRunner.d.ts.map

package/build/server/products/work/state/workGoldenPathRunner.d.ts.map

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