macp-sdk-typescript 0.10.0 → 0.11.0

package/dist/projections/handoff.d.ts

@@ -1,4 +1,4 @@
-import type { ProjectionAnomaly } from './base';
+import { BaseProjection } from './base';
 import type { Envelope } from '../types';
 import type { ProtoRegistry } from '../proto-registry';
 export interface HandoffRecord {
@@ -18,55 +18,12 @@ export interface HandoffRecord {
      */
     implicit?: boolean;
 }
-export declare class HandoffProjection {
+export declare class HandoffProjection extends BaseProjection {
+    protected readonly mode = "macp.mode.handoff.v1";
     readonly handoffs: Map<string, HandoffRecord>;
-    /**
-     * The session's accepted history, one envelope per unique `message_id`. See
-     * `BaseProjection.transcript` (`src/projections/base.ts`) for the full
-     * redelivery-idempotence contract (RFC-MACP-0006 §3.2); duplicated here
-     * only as a one-line pointer.
-     */
-    readonly transcript: Envelope[];
-    /**
-     * Cardinality anomalies recorded while replaying this projection's accepted
-     * transcript. See `BaseProjection.anomalies` (`src/projections/base.ts`)
-     * for the canonical description; duplicated here only as a one-line
-     * pointer. No built-in detection populates this for Handoff mode.
-     */
-    readonly anomalies: ProjectionAnomaly[];
     phase: 'Pending' | 'OfferPending' | 'ContextSharing' | 'Accepted' | 'Declined' | 'Committed';
-    commitment?: Record<string, unknown>;
-    /**
-     * `message_id`s already applied to this projection. See
-     * `BaseProjection.seenMessageIds` (`src/projections/base.ts`) for the full
-     * redelivery-idempotence rationale (RFC-MACP-0006 §3.2); duplicated here
-     * only as a one-line pointer.
-     */
-    private readonly seenMessageIds;
-    /**
-     * Apply one envelope to this projection's in-process state.
-     *
-     * Input contract: **accepted-only**, caller-maintained (`Envelope` carries
-     * no acceptance marker). Canonical source: `schemas/conformance/README.md`
-     * "Notes:", RFC-MACP-0007 §5.3, RFC-MACP-0011 §5. Full rationale and failure
-     * mode are documented once, on `BaseProjection.applyEnvelope`
-     * (`src/projections/base.ts`), and duplicated here only as a one-line
-     * pointer so six independent copies of the same prose cannot drift.
-     *
-     * Redelivery idempotence: a redelivered envelope (same `message_id`) is a
-     * non-event — not appended to `transcript`, not passed to the `switch`.
-     * See `BaseProjection.applyEnvelope` for the full RFC-MACP-0006 §3.2
-     * citation; duplicated here only as a one-line pointer.
-     */
-    applyEnvelope(envelope: Envelope, protoRegistry: ProtoRegistry): void;
-    /**
-     * True once at least one `ProjectionAnomaly` has been recorded. See
-     * `BaseProjection.hasAnomalies` (`src/projections/base.ts`) for the
-     * canonical description; duplicated here only as a one-line pointer.
-     */
-    get hasAnomalies(): boolean;
-    get isCommitted(): boolean;
-    get isPositiveOutcome(): boolean | undefined;
+    /** Handle a Handoff-mode envelope. See `BaseProjection.applyEnvelope` for the accepted-only input contract and redelivery/rollback semantics shared by all built-in modes. */
+    protected applyMode(envelope: Envelope, protoRegistry: ProtoRegistry): void;
     getHandoff(handoffId: string): HandoffRecord | undefined;
     isAccepted(handoffId: string): boolean;
     isDeclined(handoffId: string): boolean;

package/dist/projections/handoff.js

@@ -2,62 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HandoffProjection = void 0;
 const constants_1 = require("../constants");
-const logging_1 = require("../logging");
-class HandoffProjection {
+const base_1 = require("./base");
+class HandoffProjection extends base_1.BaseProjection {
+    mode = constants_1.MODE_HANDOFF;
     handoffs = new Map();
-    /**
-     * The session's accepted history, one envelope per unique `message_id`. See
-     * `BaseProjection.transcript` (`src/projections/base.ts`) for the full
-     * redelivery-idempotence contract (RFC-MACP-0006 §3.2); duplicated here
-     * only as a one-line pointer.
-     */
-    transcript = [];
-    /**
-     * Cardinality anomalies recorded while replaying this projection's accepted
-     * transcript. See `BaseProjection.anomalies` (`src/projections/base.ts`)
-     * for the canonical description; duplicated here only as a one-line
-     * pointer. No built-in detection populates this for Handoff mode.
-     */
-    anomalies = [];
     phase = 'Pending';
-    commitment;
-    /**
-     * `message_id`s already applied to this projection. See
-     * `BaseProjection.seenMessageIds` (`src/projections/base.ts`) for the full
-     * redelivery-idempotence rationale (RFC-MACP-0006 §3.2); duplicated here
-     * only as a one-line pointer.
-     */
-    seenMessageIds = new Set();
-    /**
-     * Apply one envelope to this projection's in-process state.
-     *
-     * Input contract: **accepted-only**, caller-maintained (`Envelope` carries
-     * no acceptance marker). Canonical source: `schemas/conformance/README.md`
-     * "Notes:", RFC-MACP-0007 §5.3, RFC-MACP-0011 §5. Full rationale and failure
-     * mode are documented once, on `BaseProjection.applyEnvelope`
-     * (`src/projections/base.ts`), and duplicated here only as a one-line
-     * pointer so six independent copies of the same prose cannot drift.
-     *
-     * Redelivery idempotence: a redelivered envelope (same `message_id`) is a
-     * non-event — not appended to `transcript`, not passed to the `switch`.
-     * See `BaseProjection.applyEnvelope` for the full RFC-MACP-0006 §3.2
-     * citation; duplicated here only as a one-line pointer.
-     */
-    applyEnvelope(envelope, protoRegistry) {
-        if (envelope.mode !== constants_1.MODE_HANDOFF)
-            return;
-        if (envelope.messageId) {
-            if (this.seenMessageIds.has(envelope.messageId)) {
-                logging_1.logger.debug('projection redelivery ignored', {
-                    messageId: envelope.messageId,
-                    mode: envelope.mode,
-                    messageType: envelope.messageType,
-                });
-                return;
-            }
-            this.seenMessageIds.add(envelope.messageId);
-        }
-        this.transcript.push(envelope);
+    /** Handle a Handoff-mode envelope. See `BaseProjection.applyEnvelope` for the accepted-only input contract and redelivery/rollback semantics shared by all built-in modes. */
+    applyMode(envelope, protoRegistry) {
         const payload = protoRegistry.decodeKnownPayload(envelope.mode, envelope.messageType, envelope.payload);
         switch (envelope.messageType) {
             case 'HandoffOffer': {
@@ -148,33 +99,10 @@ class HandoffProjection {
                 }
                 break;
             }
-            case 'Commitment': {
-                this.commitment = payload;
-                this.phase = 'Committed';
-                break;
-            }
             default:
                 break;
         }
     }
-    /**
-     * True once at least one `ProjectionAnomaly` has been recorded. See
-     * `BaseProjection.hasAnomalies` (`src/projections/base.ts`) for the
-     * canonical description; duplicated here only as a one-line pointer.
-     */
-    get hasAnomalies() {
-        return this.anomalies.length > 0;
-    }
-    get isCommitted() {
-        return this.commitment !== undefined;
-    }
-    get isPositiveOutcome() {
-        if (!this.commitment)
-            return undefined;
-        const val = this.commitment.outcomePositive ??
-            this.commitment.outcome_positive;
-        return val !== undefined ? Boolean(val) : true;
-    }
     getHandoff(handoffId) {
         return this.handoffs.get(handoffId);
     }

package/dist/projections/proposal.d.ts

@@ -1,4 +1,4 @@
-import type { ProjectionAnomaly } from './base';
+import { BaseProjection } from './base';
 import type { Envelope } from '../types';
 import type { ProtoRegistry } from '../proto-registry';
 export interface ProposalRecord {
@@ -21,7 +21,8 @@ export interface ProposalRejectRecord {
     reason?: string;
     sender: string;
 }
-export declare class ProposalProjection {
+export declare class ProposalProjection extends BaseProjection {
+    protected readonly mode = "macp.mode.proposal.v1";
     readonly proposals: Map<string, ProposalRecord>;
     readonly accepts: ProposalAcceptRecord[];
     readonly rejections: ProposalRejectRecord[];
@@ -39,53 +40,9 @@ export declare class ProposalProjection {
      * acceptance set, and the same commitment eligibility."
      */
     private readonly latestAcceptBySender;
-    /**
-     * The session's accepted history, one envelope per unique `message_id`. See
-     * `BaseProjection.transcript` (`src/projections/base.ts`) for the full
-     * redelivery-idempotence contract (RFC-MACP-0006 §3.2); duplicated here
-     * only as a one-line pointer.
-     */
-    readonly transcript: Envelope[];
-    /**
-     * Cardinality anomalies recorded while replaying this projection's accepted
-     * transcript. See `BaseProjection.anomalies` (`src/projections/base.ts`)
-     * for the canonical description; duplicated here only as a one-line
-     * pointer. No built-in detection populates this for Proposal mode.
-     */
-    readonly anomalies: ProjectionAnomaly[];
     phase: 'Negotiating' | 'TerminalRejected' | 'Committed';
-    commitment?: Record<string, unknown>;
-    /**
-     * `message_id`s already applied to this projection. See
-     * `BaseProjection.seenMessageIds` (`src/projections/base.ts`) for the full
-     * redelivery-idempotence rationale (RFC-MACP-0006 §3.2); duplicated here
-     * only as a one-line pointer.
-     */
-    private readonly seenMessageIds;
-    /**
-     * Apply one envelope to this projection's in-process state.
-     *
-     * Input contract: **accepted-only**, caller-maintained (`Envelope` carries
-     * no acceptance marker). Canonical source: `schemas/conformance/README.md`
-     * "Notes:", RFC-MACP-0007 §5.3, RFC-MACP-0011 §5. Full rationale and failure
-     * mode are documented once, on `BaseProjection.applyEnvelope`
-     * (`src/projections/base.ts`), and duplicated here only as a one-line
-     * pointer so six independent copies of the same prose cannot drift.
-     *
-     * Redelivery idempotence: a redelivered envelope (same `message_id`) is a
-     * non-event — not appended to `transcript`, not passed to the `switch`.
-     * See `BaseProjection.applyEnvelope` for the full RFC-MACP-0006 §3.2
-     * citation; duplicated here only as a one-line pointer.
-     */
-    applyEnvelope(envelope: Envelope, protoRegistry: ProtoRegistry): void;
-    /**
-     * True once at least one `ProjectionAnomaly` has been recorded. See
-     * `BaseProjection.hasAnomalies` (`src/projections/base.ts`) for the
-     * canonical description; duplicated here only as a one-line pointer.
-     */
-    get hasAnomalies(): boolean;
-    get isCommitted(): boolean;
-    get isPositiveOutcome(): boolean | undefined;
+    /** Handle a Proposal-mode envelope. See `BaseProjection.applyEnvelope` for the accepted-only input contract and redelivery/rollback semantics shared by all built-in modes. */
+    protected applyMode(envelope: Envelope, protoRegistry: ProtoRegistry): void;
     activeProposals(): ProposalRecord[];
     latestProposal(): ProposalRecord | undefined;
     /**

package/dist/projections/proposal.js

@@ -2,8 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ProposalProjection = void 0;
 const constants_1 = require("../constants");
-const logging_1 = require("../logging");
-class ProposalProjection {
+const base_1 = require("./base");
+class ProposalProjection extends base_1.BaseProjection {
+    mode = constants_1.MODE_PROPOSAL;
     proposals = new Map();
     accepts = [];
     rejections = [];
@@ -21,59 +22,9 @@ class ProposalProjection {
      * acceptance set, and the same commitment eligibility."
      */
     latestAcceptBySender = new Map();
-    /**
-     * The session's accepted history, one envelope per unique `message_id`. See
-     * `BaseProjection.transcript` (`src/projections/base.ts`) for the full
-     * redelivery-idempotence contract (RFC-MACP-0006 §3.2); duplicated here
-     * only as a one-line pointer.
-     */
-    transcript = [];
-    /**
-     * Cardinality anomalies recorded while replaying this projection's accepted
-     * transcript. See `BaseProjection.anomalies` (`src/projections/base.ts`)
-     * for the canonical description; duplicated here only as a one-line
-     * pointer. No built-in detection populates this for Proposal mode.
-     */
-    anomalies = [];
     phase = 'Negotiating';
-    commitment;
-    /**
-     * `message_id`s already applied to this projection. See
-     * `BaseProjection.seenMessageIds` (`src/projections/base.ts`) for the full
-     * redelivery-idempotence rationale (RFC-MACP-0006 §3.2); duplicated here
-     * only as a one-line pointer.
-     */
-    seenMessageIds = new Set();
-    /**
-     * Apply one envelope to this projection's in-process state.
-     *
-     * Input contract: **accepted-only**, caller-maintained (`Envelope` carries
-     * no acceptance marker). Canonical source: `schemas/conformance/README.md`
-     * "Notes:", RFC-MACP-0007 §5.3, RFC-MACP-0011 §5. Full rationale and failure
-     * mode are documented once, on `BaseProjection.applyEnvelope`
-     * (`src/projections/base.ts`), and duplicated here only as a one-line
-     * pointer so six independent copies of the same prose cannot drift.
-     *
-     * Redelivery idempotence: a redelivered envelope (same `message_id`) is a
-     * non-event — not appended to `transcript`, not passed to the `switch`.
-     * See `BaseProjection.applyEnvelope` for the full RFC-MACP-0006 §3.2
-     * citation; duplicated here only as a one-line pointer.
-     */
-    applyEnvelope(envelope, protoRegistry) {
-        if (envelope.mode !== constants_1.MODE_PROPOSAL)
-            return;
-        if (envelope.messageId) {
-            if (this.seenMessageIds.has(envelope.messageId)) {
-                logging_1.logger.debug('projection redelivery ignored', {
-                    messageId: envelope.messageId,
-                    mode: envelope.mode,
-                    messageType: envelope.messageType,
-                });
-                return;
-            }
-            this.seenMessageIds.add(envelope.messageId);
-        }
-        this.transcript.push(envelope);
+    /** Handle a Proposal-mode envelope. See `BaseProjection.applyEnvelope` for the accepted-only input contract and redelivery/rollback semantics shared by all built-in modes. */
+    applyMode(envelope, protoRegistry) {
         const payload = protoRegistry.decodeKnownPayload(envelope.mode, envelope.messageType, envelope.payload);
         switch (envelope.messageType) {
             case 'Proposal': {
@@ -133,33 +84,10 @@ class ProposalProjection {
                     proposal.status = 'withdrawn';
                 break;
             }
-            case 'Commitment': {
-                this.commitment = payload;
-                this.phase = 'Committed';
-                break;
-            }
             default:
                 break;
         }
     }
-    /**
-     * True once at least one `ProjectionAnomaly` has been recorded. See
-     * `BaseProjection.hasAnomalies` (`src/projections/base.ts`) for the
-     * canonical description; duplicated here only as a one-line pointer.
-     */
-    get hasAnomalies() {
-        return this.anomalies.length > 0;
-    }
-    get isCommitted() {
-        return this.commitment !== undefined;
-    }
-    get isPositiveOutcome() {
-        if (!this.commitment)
-            return undefined;
-        const val = this.commitment.outcomePositive ??
-            this.commitment.outcome_positive;
-        return val !== undefined ? Boolean(val) : true;
-    }
     activeProposals() {
         return [...this.proposals.values()].filter((p) => p.status === 'open');
     }

package/dist/projections/quorum.d.ts

@@ -1,4 +1,4 @@
-import type { ProjectionAnomaly } from './base';
+import { BaseProjection } from './base';
 import type { Envelope } from '../types';
 import type { ProtoRegistry } from '../proto-registry';
 export interface ApprovalRequestRecord {
@@ -14,57 +14,13 @@ export interface BallotRecord {
     reason?: string;
     sender: string;
 }
-export declare class QuorumProjection {
+export declare class QuorumProjection extends BaseProjection {
+    protected readonly mode = "macp.mode.quorum.v1";
     readonly requests: Map<string, ApprovalRequestRecord>;
     readonly ballots: Map<string, Map<string, BallotRecord>>;
-    /**
-     * The session's accepted history, one envelope per unique `message_id`. See
-     * `BaseProjection.transcript` (`src/projections/base.ts`) for the full
-     * redelivery-idempotence contract (RFC-MACP-0006 §3.2); duplicated here
-     * only as a one-line pointer.
-     */
-    readonly transcript: Envelope[];
-    /**
-     * Cardinality anomalies recorded while replaying this projection's accepted
-     * transcript (e.g. a duplicate ballot across `Approve`/`Reject`/`Abstain`
-     * from the same sender for the same `request_id`). See
-     * `BaseProjection.anomalies` (`src/projections/base.ts`) for the canonical
-     * description; duplicated here only as a one-line pointer.
-     */
-    readonly anomalies: ProjectionAnomaly[];
     phase: 'Pending' | 'Voting' | 'Committed';
-    commitment?: Record<string, unknown>;
-    /**
-     * `message_id`s already applied to this projection. See
-     * `BaseProjection.seenMessageIds` (`src/projections/base.ts`) for the full
-     * redelivery-idempotence rationale (RFC-MACP-0006 §3.2); duplicated here
-     * only as a one-line pointer.
-     */
-    private readonly seenMessageIds;
-    /**
-     * Apply one envelope to this projection's in-process state.
-     *
-     * Input contract: **accepted-only**, caller-maintained (`Envelope` carries
-     * no acceptance marker). Canonical source: `schemas/conformance/README.md`
-     * "Notes:", RFC-MACP-0007 §5.3, RFC-MACP-0011 §5. Full rationale and failure
-     * mode are documented once, on `BaseProjection.applyEnvelope`
-     * (`src/projections/base.ts`), and duplicated here only as a one-line
-     * pointer so six independent copies of the same prose cannot drift.
-     *
-     * Redelivery idempotence: a redelivered envelope (same `message_id`) is a
-     * non-event — not appended to `transcript`, not passed to the `switch`.
-     * See `BaseProjection.applyEnvelope` for the full RFC-MACP-0006 §3.2
-     * citation; duplicated here only as a one-line pointer.
-     */
-    applyEnvelope(envelope: Envelope, protoRegistry: ProtoRegistry): void;
-    /**
-     * True once at least one `ProjectionAnomaly` has been recorded. See
-     * `BaseProjection.hasAnomalies` (`src/projections/base.ts`) for the
-     * canonical description; duplicated here only as a one-line pointer.
-     */
-    get hasAnomalies(): boolean;
-    get isCommitted(): boolean;
-    get isPositiveOutcome(): boolean | undefined;
+    /** Handle a Quorum-mode envelope. See `BaseProjection.applyEnvelope` for the accepted-only input contract and redelivery/rollback semantics shared by all built-in modes. */
+    protected applyMode(envelope: Envelope, protoRegistry: ProtoRegistry): void;
     private setBallot;
     approvalCount(requestId: string): number;
     rejectionCount(requestId: string): number;

package/dist/projections/quorum.js

@@ -2,64 +2,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.QuorumProjection = void 0;
 const constants_1 = require("../constants");
-const logging_1 = require("../logging");
-class QuorumProjection {
+const base_1 = require("./base");
+class QuorumProjection extends base_1.BaseProjection {
+    mode = constants_1.MODE_QUORUM;
     requests = new Map();
     ballots = new Map();
-    /**
-     * The session's accepted history, one envelope per unique `message_id`. See
-     * `BaseProjection.transcript` (`src/projections/base.ts`) for the full
-     * redelivery-idempotence contract (RFC-MACP-0006 §3.2); duplicated here
-     * only as a one-line pointer.
-     */
-    transcript = [];
-    /**
-     * Cardinality anomalies recorded while replaying this projection's accepted
-     * transcript (e.g. a duplicate ballot across `Approve`/`Reject`/`Abstain`
-     * from the same sender for the same `request_id`). See
-     * `BaseProjection.anomalies` (`src/projections/base.ts`) for the canonical
-     * description; duplicated here only as a one-line pointer.
-     */
-    anomalies = [];
     phase = 'Pending';
-    commitment;
-    /**
-     * `message_id`s already applied to this projection. See
-     * `BaseProjection.seenMessageIds` (`src/projections/base.ts`) for the full
-     * redelivery-idempotence rationale (RFC-MACP-0006 §3.2); duplicated here
-     * only as a one-line pointer.
-     */
-    seenMessageIds = new Set();
-    /**
-     * Apply one envelope to this projection's in-process state.
-     *
-     * Input contract: **accepted-only**, caller-maintained (`Envelope` carries
-     * no acceptance marker). Canonical source: `schemas/conformance/README.md`
-     * "Notes:", RFC-MACP-0007 §5.3, RFC-MACP-0011 §5. Full rationale and failure
-     * mode are documented once, on `BaseProjection.applyEnvelope`
-     * (`src/projections/base.ts`), and duplicated here only as a one-line
-     * pointer so six independent copies of the same prose cannot drift.
-     *
-     * Redelivery idempotence: a redelivered envelope (same `message_id`) is a
-     * non-event — not appended to `transcript`, not passed to the `switch`.
-     * See `BaseProjection.applyEnvelope` for the full RFC-MACP-0006 §3.2
-     * citation; duplicated here only as a one-line pointer.
-     */
-    applyEnvelope(envelope, protoRegistry) {
-        if (envelope.mode !== constants_1.MODE_QUORUM)
-            return;
-        if (envelope.messageId) {
-            if (this.seenMessageIds.has(envelope.messageId)) {
-                logging_1.logger.debug('projection redelivery ignored', {
-                    messageId: envelope.messageId,
-                    mode: envelope.mode,
-                    messageType: envelope.messageType,
-                });
-                return;
-            }
-            this.seenMessageIds.add(envelope.messageId);
-        }
-        this.transcript.push(envelope);
+    /** Handle a Quorum-mode envelope. See `BaseProjection.applyEnvelope` for the accepted-only input contract and redelivery/rollback semantics shared by all built-in modes. */
+    applyMode(envelope, protoRegistry) {
         const payload = protoRegistry.decodeKnownPayload(envelope.mode, envelope.messageType, envelope.payload);
         switch (envelope.messageType) {
             case 'ApprovalRequest': {
@@ -83,33 +33,10 @@ class QuorumProjection {
                 this.setBallot(envelope, record.requestId, 'abstain', record.reason);
                 break;
             }
-            case 'Commitment': {
-                this.commitment = payload;
-                this.phase = 'Committed';
-                break;
-            }
             default:
                 break;
         }
     }
-    /**
-     * True once at least one `ProjectionAnomaly` has been recorded. See
-     * `BaseProjection.hasAnomalies` (`src/projections/base.ts`) for the
-     * canonical description; duplicated here only as a one-line pointer.
-     */
-    get hasAnomalies() {
-        return this.anomalies.length > 0;
-    }
-    get isCommitted() {
-        return this.commitment !== undefined;
-    }
-    get isPositiveOutcome() {
-        if (!this.commitment)
-            return undefined;
-        const val = this.commitment.outcomePositive ??
-            this.commitment.outcome_positive;
-        return val !== undefined ? Boolean(val) : true;
-    }
     setBallot(envelope, requestId, vote, reason) {
         const senderMap = this.ballots.get(requestId) ?? new Map();
         const kept = senderMap.get(envelope.sender);
@@ -129,7 +56,7 @@ class QuorumProjection {
             // by RFC-0011 either; it is parity with RFC-MACP-0007 §5 item 3's
             // explicit first-stands rule for `Vote`, plus macp-runtime's enforced
             // first-wins behaviour.
-            const anomaly = {
+            this.recordAnomaly({
                 kind: 'duplicate_ballot',
                 mode: envelope.mode,
                 messageType: envelope.messageType,
@@ -137,9 +64,7 @@ class QuorumProjection {
                 sender: envelope.sender,
                 subjectId: requestId,
                 detail: `sender ${envelope.sender} already cast '${kept.vote}' on request ${requestId}; discarded '${vote}'`,
-            };
-            this.anomalies.push(anomaly);
-            logging_1.logger.warn('projection anomaly', anomaly);
+            });
             return;
         }
         senderMap.set(envelope.sender, { requestId, vote, reason, sender: envelope.sender });

package/dist/projections/task.d.ts

@@ -1,4 +1,4 @@
-import type { ProjectionAnomaly } from './base';
+import { BaseProjection } from './base';
 import type { Envelope } from '../types';
 import type { ProtoRegistry } from '../proto-registry';
 export interface TaskRecord {
@@ -33,34 +33,13 @@ export interface TaskFailureRecord {
     retryable: boolean;
     sender: string;
 }
-export declare class TaskProjection {
+export declare class TaskProjection extends BaseProjection {
+    protected readonly mode = "macp.mode.task.v1";
     readonly tasks: Map<string, TaskRecord>;
     readonly updates: TaskUpdateRecord[];
     readonly completions: TaskCompletionRecord[];
     readonly failures: TaskFailureRecord[];
-    /**
-     * The session's accepted history, one envelope per unique `message_id`. See
-     * `BaseProjection.transcript` (`src/projections/base.ts`) for the full
-     * redelivery-idempotence contract (RFC-MACP-0006 §3.2); duplicated here
-     * only as a one-line pointer.
-     */
-    readonly transcript: Envelope[];
-    /**
-     * Cardinality anomalies recorded while replaying this projection's accepted
-     * transcript. See `BaseProjection.anomalies` (`src/projections/base.ts`)
-     * for the canonical description; duplicated here only as a one-line
-     * pointer. No built-in detection populates this for Task mode.
-     */
-    readonly anomalies: ProjectionAnomaly[];
     phase: 'Pending' | 'Requested' | 'InProgress' | 'Completed' | 'Failed' | 'Committed';
-    commitment?: Record<string, unknown>;
-    /**
-     * `message_id`s already applied to this projection. See
-     * `BaseProjection.seenMessageIds` (`src/projections/base.ts`) for the full
-     * redelivery-idempotence rationale (RFC-MACP-0006 §3.2); duplicated here
-     * only as a one-line pointer.
-     */
-    private readonly seenMessageIds;
     /**
      * The **session-level** active assignment: who currently holds the session's
      * single assignee slot, and which `task_id` they took it on.
@@ -81,30 +60,8 @@ export declare class TaskProjection {
      * the right `TaskRecord.assignee` even on a multi-task transcript.
      */
     private activeAssignment?;
-    /**
-     * Apply one envelope to this projection's in-process state.
-     *
-     * Input contract: **accepted-only**, caller-maintained (`Envelope` carries
-     * no acceptance marker). Canonical source: `schemas/conformance/README.md`
-     * "Notes:", RFC-MACP-0007 §5.3, RFC-MACP-0011 §5. Full rationale and failure
-     * mode are documented once, on `BaseProjection.applyEnvelope`
-     * (`src/projections/base.ts`), and duplicated here only as a one-line
-     * pointer so six independent copies of the same prose cannot drift.
-     *
-     * Redelivery idempotence: a redelivered envelope (same `message_id`) is a
-     * non-event — not appended to `transcript`, not passed to the `switch`.
-     * See `BaseProjection.applyEnvelope` for the full RFC-MACP-0006 §3.2
-     * citation; duplicated here only as a one-line pointer.
-     */
-    applyEnvelope(envelope: Envelope, protoRegistry: ProtoRegistry): void;
-    /**
-     * True once at least one `ProjectionAnomaly` has been recorded. See
-     * `BaseProjection.hasAnomalies` (`src/projections/base.ts`) for the
-     * canonical description; duplicated here only as a one-line pointer.
-     */
-    get hasAnomalies(): boolean;
-    get isCommitted(): boolean;
-    get isPositiveOutcome(): boolean | undefined;
+    /** Handle a Task-mode envelope. See `BaseProjection.applyEnvelope` for the accepted-only input contract and redelivery/rollback semantics shared by all built-in modes. */
+    protected applyMode(envelope: Envelope, protoRegistry: ProtoRegistry): void;
     getTask(taskId: string): TaskRecord | undefined;
     isComplete(taskId: string): boolean;
     isFailed(taskId: string): boolean;