@oxygen-agent/cli 1.750.4 → 1.766.0

package/node_modules/@oxygen/shared/dist/future-signup-events.d.ts

@@ -1,7 +1,15 @@
 export declare const FUTURE_SIGNUP_CONTRACT_VERSION = "future_signup_crm_activation.v1";
 export declare const FUTURE_SIGNUP_ACTIVATION_TAXONOMY_VERSION = "activation_commands.v1";
-export declare const FUTURE_SIGNUP_LIFECYCLE_CONTRACT_VERSION = "future_signup_lifecycle.v1";
-export declare const FUTURE_SIGNUP_LIFECYCLE_PROJECTION_CONTRACT_VERSION = "future_signup_lifecycle_projection.v1";
+/** Legacy Trial-shaped lifecycle contract retained for exact replay. */
+export declare const FUTURE_SIGNUP_LIFECYCLE_CONTRACT_VERSION_V1: "future_signup_lifecycle.v1";
+/** Durable-Free entry-edge contract. Runtime production remains in a later slice. */
+export declare const FUTURE_SIGNUP_LIFECYCLE_CONTRACT_VERSION_V2: "future_signup_lifecycle.v2";
+export declare const FUTURE_SIGNUP_LIFECYCLE_CONTRACT_VERSION: "future_signup_lifecycle.v1";
+/** Exact legacy Trial-shaped projection contract retained for immutable replay. */
+export declare const FUTURE_SIGNUP_LIFECYCLE_PROJECTION_CONTRACT_VERSION_V1: "future_signup_lifecycle_projection.v1";
+/** Durable-Free projection contract. No producer or drain is armed by this constant. */
+export declare const FUTURE_SIGNUP_LIFECYCLE_PROJECTION_CONTRACT_VERSION_V2: "future_signup_lifecycle_projection.v2";
+export declare const FUTURE_SIGNUP_LIFECYCLE_PROJECTION_CONTRACT_VERSION: "future_signup_lifecycle_projection.v1";
 export declare const FUTURE_SIGNUP_CRM_DESTINATION = "oxygen_company_crm";
 export declare const FUTURE_SIGNUP_ACTIVATION_COMMANDS: readonly ["agent create", "crm activity log", "crm assert", "crm object add-attr", "crm object create", "crm relationships define", "crm relationships upsert", "knowledge page upsert", "publishing posts create", "sequences create", "tables create", "tables duplicate", "tables import-csv", "tables import-file", "tables import-staged", "tables import-url", "tables insert", "tables relate", "tables update", "tables upsert", "workflows apply"];
 export declare function isFutureSignupActivationCommand(command: string): boolean;
@@ -10,6 +18,8 @@ export declare function futureSignupFactId(clerkUserId: string): string;
 export declare function futureSignupOperationFactId(operationEventId: string): string;
 export declare function futureSignupActivationFactId(clerkUserId: string): string;
 export declare function futureSignupTrialStartedFactId(stripeSubscriptionId: string): string;
+/** One immutable durable-Free entry edge per exact Clerk organization. */
+export declare function futureSignupFreeStartedFactId(clerkOrgId: string): string;
 export declare function futureSignupPaidFactId(stripeInvoiceId: string): string;
 export declare function futureSignupLostFactId(stripeSubscriptionId: string, lossKind: "paid_churn" | "trial_non_conversion"): string;
 export declare function futureSignupSubscriptionEndedFactId(stripeSubscriptionId: string, terminationKind: "replaced" | "duplicate" | "unqualified"): string;
@@ -17,6 +27,7 @@ export declare function futureSignupWorkspaceDeletedFactId(clerkOrgId: string):
 /** Immutable cause for membership, completeness, or Company-identity projection changes. */
 export declare function futureSignupLifecycleProjectionRefreshFactId(clerkOrgId: string, sourceEventId: string): string;
 export declare function futureSignupLifecycleProjectionFactId(sourceFactId: string): string;
+export declare function futureSignupLifecycleProjectionV2FactId(sourceFactId: string): string;
 export declare function futureSignupLifecycleAggregateId(clerkOrgId: string): string;
 export declare function futureSignupLifecycleEventId(factId: string, factRevision: number): string;
 export declare function isAtOrAfterFutureSignupCutover(input: {

package/node_modules/@oxygen/shared/dist/future-signup-events.js

@@ -1,7 +1,15 @@
 export const FUTURE_SIGNUP_CONTRACT_VERSION = "future_signup_crm_activation.v1";
 export const FUTURE_SIGNUP_ACTIVATION_TAXONOMY_VERSION = "activation_commands.v1";
-export const FUTURE_SIGNUP_LIFECYCLE_CONTRACT_VERSION = "future_signup_lifecycle.v1";
-export const FUTURE_SIGNUP_LIFECYCLE_PROJECTION_CONTRACT_VERSION = "future_signup_lifecycle_projection.v1";
+/** Legacy Trial-shaped lifecycle contract retained for exact replay. */
+export const FUTURE_SIGNUP_LIFECYCLE_CONTRACT_VERSION_V1 = "future_signup_lifecycle.v1";
+/** Durable-Free entry-edge contract. Runtime production remains in a later slice. */
+export const FUTURE_SIGNUP_LIFECYCLE_CONTRACT_VERSION_V2 = "future_signup_lifecycle.v2";
+export const FUTURE_SIGNUP_LIFECYCLE_CONTRACT_VERSION = FUTURE_SIGNUP_LIFECYCLE_CONTRACT_VERSION_V1;
+/** Exact legacy Trial-shaped projection contract retained for immutable replay. */
+export const FUTURE_SIGNUP_LIFECYCLE_PROJECTION_CONTRACT_VERSION_V1 = "future_signup_lifecycle_projection.v1";
+/** Durable-Free projection contract. No producer or drain is armed by this constant. */
+export const FUTURE_SIGNUP_LIFECYCLE_PROJECTION_CONTRACT_VERSION_V2 = "future_signup_lifecycle_projection.v2";
+export const FUTURE_SIGNUP_LIFECYCLE_PROJECTION_CONTRACT_VERSION = FUTURE_SIGNUP_LIFECYCLE_PROJECTION_CONTRACT_VERSION_V1;
 export const FUTURE_SIGNUP_CRM_DESTINATION = "oxygen_company_crm";
 export const FUTURE_SIGNUP_ACTIVATION_COMMANDS = [
     "agent create",
@@ -45,6 +53,10 @@ export function futureSignupActivationFactId(clerkUserId) {
 export function futureSignupTrialStartedFactId(stripeSubscriptionId) {
     return `future_signup_lifecycle:trial_started:v1:${requiredId(stripeSubscriptionId, "stripeSubscriptionId")}`;
 }
+/** One immutable durable-Free entry edge per exact Clerk organization. */
+export function futureSignupFreeStartedFactId(clerkOrgId) {
+    return `future_signup_lifecycle:free_started:v2:${requiredId(clerkOrgId, "clerkOrgId")}`;
+}
 export function futureSignupPaidFactId(stripeInvoiceId) {
     return `future_signup_lifecycle:paid:v1:${requiredId(stripeInvoiceId, "stripeInvoiceId")}`;
 }
@@ -64,6 +76,9 @@ export function futureSignupLifecycleProjectionRefreshFactId(clerkOrgId, sourceE
 export function futureSignupLifecycleProjectionFactId(sourceFactId) {
     return `lifecycle_projection:v1:${requiredId(sourceFactId, "sourceFactId")}`;
 }
+export function futureSignupLifecycleProjectionV2FactId(sourceFactId) {
+    return `lifecycle_projection:v2:${requiredId(sourceFactId, "sourceFactId")}`;
+}
 export function futureSignupLifecycleAggregateId(clerkOrgId) {
     return `lifecycle_aggregate:v1:clerk_org:${requiredId(clerkOrgId, "clerkOrgId")}`;
 }

package/node_modules/@oxygen/shared/dist/future-signup-lifecycle-projection.d.ts

@@ -1,4 +1,4 @@
-import { FUTURE_SIGNUP_LIFECYCLE_CONTRACT_VERSION, FUTURE_SIGNUP_LIFECYCLE_PROJECTION_CONTRACT_VERSION } from "./future-signup-events.js";
+import { FUTURE_SIGNUP_LIFECYCLE_CONTRACT_VERSION, FUTURE_SIGNUP_LIFECYCLE_CONTRACT_VERSION_V2, FUTURE_SIGNUP_LIFECYCLE_PROJECTION_CONTRACT_VERSION, FUTURE_SIGNUP_LIFECYCLE_PROJECTION_CONTRACT_VERSION_V2 } from "./future-signup-events.js";
 /** Fixed destination-head authority. Contract upgrades cannot reset this stream. */
 export declare const FUTURE_SIGNUP_LIFECYCLE_PROJECTION_AUTHORITY: "oxygen_product_lifecycle";
 export declare const FUTURE_SIGNUP_LIFECYCLE_PROJECTION_FACT_TYPES: readonly ["trial_started", "paid", "lost", "subscription_ended", "workspace_deleted", "projection_refreshed"];
@@ -7,12 +7,20 @@ export declare const FUTURE_SIGNUP_LIFECYCLE_PROJECTION_PREBILLING_STAGES: reado
 export declare const FUTURE_SIGNUP_LIFECYCLE_PROJECTION_SEMANTIC_STAGES: readonly ["lead", "interested", "demo_booked", "free_trial", "paid", "lost"];
 export declare const FUTURE_SIGNUP_LIFECYCLE_PROJECTION_ALIAS_TYPES: readonly ["clerk_organization", "clerk_user", "domain", "email", "stripe_customer"];
 export declare const FUTURE_SIGNUP_LIFECYCLE_PROJECTION_ACTIVITY_TYPES: readonly ["trial_started", "plan_paid", "customer_lost", "workspace_deleted"];
+export declare const FUTURE_SIGNUP_LIFECYCLE_PROJECTION_V2_FACT_TYPES: readonly ["trial_started", "paid", "lost", "subscription_ended", "workspace_deleted", "projection_refreshed", "free_started"];
+export declare const FUTURE_SIGNUP_LIFECYCLE_PROJECTION_V2_BILLING_STAGES: readonly ["free", "paid", "lost"];
+export declare const FUTURE_SIGNUP_LIFECYCLE_PROJECTION_V2_SEMANTIC_STAGES: readonly ["lead", "interested", "demo_booked", "free", "paid", "lost"];
+export declare const FUTURE_SIGNUP_LIFECYCLE_PROJECTION_V2_ACTIVITY_TYPES: readonly ["plan_paid", "customer_lost", "workspace_deleted"];
 export type FutureSignupLifecycleProjectionFactType = (typeof FUTURE_SIGNUP_LIFECYCLE_PROJECTION_FACT_TYPES)[number];
 export type FutureSignupLifecycleProjectionBillingStage = (typeof FUTURE_SIGNUP_LIFECYCLE_PROJECTION_BILLING_STAGES)[number];
 export type FutureSignupLifecycleProjectionPrebillingStage = (typeof FUTURE_SIGNUP_LIFECYCLE_PROJECTION_PREBILLING_STAGES)[number];
 export type FutureSignupLifecycleProjectionSemanticStage = (typeof FUTURE_SIGNUP_LIFECYCLE_PROJECTION_SEMANTIC_STAGES)[number];
 export type FutureSignupLifecycleProjectionAliasType = (typeof FUTURE_SIGNUP_LIFECYCLE_PROJECTION_ALIAS_TYPES)[number];
 export type FutureSignupLifecycleProjectionActivityType = (typeof FUTURE_SIGNUP_LIFECYCLE_PROJECTION_ACTIVITY_TYPES)[number];
+export type FutureSignupLifecycleProjectionV2FactType = (typeof FUTURE_SIGNUP_LIFECYCLE_PROJECTION_V2_FACT_TYPES)[number];
+export type FutureSignupLifecycleProjectionV2BillingStage = (typeof FUTURE_SIGNUP_LIFECYCLE_PROJECTION_V2_BILLING_STAGES)[number];
+export type FutureSignupLifecycleProjectionV2SemanticStage = (typeof FUTURE_SIGNUP_LIFECYCLE_PROJECTION_V2_SEMANTIC_STAGES)[number];
+export type FutureSignupLifecycleProjectionV2ActivityType = (typeof FUTURE_SIGNUP_LIFECYCLE_PROJECTION_V2_ACTIVITY_TYPES)[number];
 export type FutureSignupLifecycleProjectionSubjectKind = "company" | "person";
 export type FutureSignupLifecycleProjectionAction = "upsert" | "neutralize";
 export type FutureSignupLifecycleProjectionLossKind = "paid_churn" | "trial_non_conversion";
@@ -173,6 +181,46 @@ export type FutureSignupLifecycleProjectionEnvelope = {
         no_send: true;
     };
 };
+export type FutureSignupLifecycleProjectionV2FreeSourceFact = Omit<FutureSignupLifecycleProjectionSourceFact, "contract_version" | "fact_type" | "source" | "stripe_customer_id" | "stripe_subscription_id" | "stripe_invoice_id" | "stripe_period_start" | "stripe_period_end" | "amount_paid_cents" | "currency" | "loss_kind" | "termination_kind"> & {
+    contract_version: typeof FUTURE_SIGNUP_LIFECYCLE_CONTRACT_VERSION_V2;
+    fact_type: "free_started";
+    source: "clerk";
+    stripe_customer_id: null;
+    stripe_subscription_id: null;
+    stripe_invoice_id: null;
+    stripe_period_start: null;
+    stripe_period_end: null;
+    amount_paid_cents: null;
+    currency: null;
+    loss_kind: null;
+    termination_kind: null;
+};
+/** Projection v2 preserves immutable v1 causes while adding one durable-Free cause. */
+export type FutureSignupLifecycleProjectionV2SourceFact = FutureSignupLifecycleProjectionSourceFact | FutureSignupLifecycleProjectionV2FreeSourceFact;
+export type FutureSignupLifecycleProjectionV2Subject = Omit<FutureSignupLifecycleProjectionSubject, "billing_stage"> & {
+    billing_stage: FutureSignupLifecycleProjectionV2BillingStage | null;
+};
+export type FutureSignupLifecycleProjectionV2OrganizationState = Omit<FutureSignupLifecycleProjectionOrganizationState, "billing_stage" | "loss_kind"> & {
+    billing_stage: FutureSignupLifecycleProjectionV2BillingStage | null;
+    /** Trial non-conversion remains v1 history and can never be current v2 Lost truth. */
+    loss_kind: "paid_churn" | null;
+};
+export type FutureSignupLifecycleProjectionV2Snapshot = Omit<FutureSignupLifecycleProjectionSnapshot, "organization_states" | "subjects"> & {
+    organization_states: FutureSignupLifecycleProjectionV2OrganizationState[];
+    subjects: FutureSignupLifecycleProjectionV2Subject[];
+};
+export type FutureSignupLifecycleProjectionV2Activity = Omit<FutureSignupLifecycleProjectionActivity, "type"> & {
+    type: FutureSignupLifecycleProjectionV2ActivityType | "note";
+};
+export type FutureSignupLifecycleProjectionV2Envelope = Omit<FutureSignupLifecycleProjectionEnvelope, "contract_version" | "upstream" | "source_fact" | "snapshot" | "activity"> & {
+    contract_version: typeof FUTURE_SIGNUP_LIFECYCLE_PROJECTION_CONTRACT_VERSION_V2;
+    upstream: Omit<FutureSignupLifecycleProjectionEnvelope["upstream"], "provider"> & {
+        provider: FutureSignupLifecycleProjectionV2SourceFact["source"];
+    };
+    source_fact: FutureSignupLifecycleProjectionV2SourceFact;
+    snapshot: FutureSignupLifecycleProjectionV2Snapshot;
+    activity: FutureSignupLifecycleProjectionV2Activity;
+};
 export type FutureSignupLifecycleProjectionAlias = {
     type: FutureSignupLifecycleProjectionAliasType;
     value: string;
@@ -213,6 +261,10 @@ export type FutureSignupLifecycleProjectionNormalizedSubject = {
     prebilling_candidate: FutureSignupLifecycleProjectionPrebillingCandidate | null;
     membership_contributors: FutureSignupLifecycleProjectionMembershipContributor[];
 };
+export type FutureSignupLifecycleProjectionV2NormalizedSubject = Omit<FutureSignupLifecycleProjectionNormalizedSubject, "billing_stage" | "loss_kind"> & {
+    billing_stage: FutureSignupLifecycleProjectionV2BillingStage | null;
+    loss_kind: "paid_churn" | null;
+};
 export type FutureSignupLifecycleProjectionParticipant = {
     kind: FutureSignupLifecycleProjectionSubjectKind;
     key: string;
@@ -235,6 +287,23 @@ export type FutureSignupLifecycleProjectionNormalizedActivity = {
     summary: null;
     participants: [];
 };
+export type FutureSignupLifecycleProjectionV2NormalizedActivity = {
+    emit: true;
+    type: FutureSignupLifecycleProjectionV2ActivityType;
+    source_provider: typeof FUTURE_SIGNUP_LIFECYCLE_PROJECTION_AUTHORITY;
+    provider_event_id: string;
+    occurred_at: string;
+    summary: string;
+    participants: FutureSignupLifecycleProjectionParticipant[];
+} | {
+    emit: false;
+    type: null;
+    source_provider: null;
+    provider_event_id: null;
+    occurred_at: null;
+    summary: null;
+    participants: [];
+};
 export type FutureSignupLifecycleProjectionFingerprintSet = {
     source_fact_fingerprint: string;
     subject_set_fingerprint: string;
@@ -275,6 +344,22 @@ export type NormalizedFutureSignupLifecycleProjectionEnvelope = {
     fingerprints: FutureSignupLifecycleProjectionFingerprintSet;
     idempotency_keys: FutureSignupLifecycleProjectionIdempotencyKeys;
 };
+export type FutureSignupLifecycleProjectionV2NormalizedProjection = Omit<FutureSignupLifecycleProjectionNormalizedProjection, "contract_version" | "source_fact" | "snapshot" | "activity"> & {
+    contract_version: typeof FUTURE_SIGNUP_LIFECYCLE_PROJECTION_CONTRACT_VERSION_V2;
+    source_fact: FutureSignupLifecycleProjectionV2SourceFact;
+    snapshot: {
+        complete: true;
+        causal_clerk_org_id: string;
+        subjects: FutureSignupLifecycleProjectionV2NormalizedSubject[];
+    };
+    activity: FutureSignupLifecycleProjectionV2NormalizedActivity;
+};
+export type NormalizedFutureSignupLifecycleProjectionV2Envelope = {
+    envelope: FutureSignupLifecycleProjectionV2Envelope;
+    projection: FutureSignupLifecycleProjectionV2NormalizedProjection;
+    fingerprints: FutureSignupLifecycleProjectionFingerprintSet;
+    idempotency_keys: FutureSignupLifecycleProjectionIdempotencyKeys;
+};
 export type FutureSignupLifecycleProjectionStageMapping = Record<FutureSignupLifecycleProjectionSemanticStage, string>;
 export type FutureSignupLifecycleProjectionDestinationApplyOptions = {
     objects: {
@@ -297,10 +382,21 @@ export type FutureSignupLifecycleProjectionDestinationApplyOptions = {
         idempotency: "event_id";
     };
 };
+export type FutureSignupLifecycleProjectionV2StageMapping = Record<FutureSignupLifecycleProjectionV2SemanticStage, string>;
+export type FutureSignupLifecycleProjectionV2DestinationApplyOptions = Omit<FutureSignupLifecycleProjectionDestinationApplyOptions, "stage_tokens"> & {
+    stage_tokens: {
+        people: FutureSignupLifecycleProjectionV2StageMapping;
+        companies: FutureSignupLifecycleProjectionV2StageMapping;
+    };
+};
 export type NormalizedFutureSignupLifecycleProjectionDestinationApplyOptions = {
     apply_options: FutureSignupLifecycleProjectionDestinationApplyOptions;
     apply_options_fingerprint: string;
 };
+export type NormalizedFutureSignupLifecycleProjectionV2DestinationApplyOptions = {
+    apply_options: FutureSignupLifecycleProjectionV2DestinationApplyOptions;
+    apply_options_fingerprint: string;
+};
 /** Typed, PII-free parse failure. Raw values are intentionally never reflected. */
 export declare class FutureSignupLifecycleProjectionContractError extends TypeError {
     readonly path: string;
@@ -314,7 +410,16 @@ export declare function futureSignupLifecycleProjectionFingerprints(input: {
     sourceFact: FutureSignupLifecycleProjectionSourceFact;
     snapshot: Omit<FutureSignupLifecycleProjectionSnapshot, "subject_set_fingerprint" | "snapshot_fingerprint">;
 }): FutureSignupLifecycleProjectionFingerprintSet;
+export declare function futureSignupLifecycleProjectionV2Fingerprints(input: {
+    eventId: string;
+    sourceFact: FutureSignupLifecycleProjectionV2SourceFact;
+    snapshot: Omit<FutureSignupLifecycleProjectionV2Snapshot, "subject_set_fingerprint" | "snapshot_fingerprint">;
+}): FutureSignupLifecycleProjectionFingerprintSet;
 export declare function parseFutureSignupLifecycleProjectionJson(body: string): NormalizedFutureSignupLifecycleProjectionEnvelope;
+export declare function parseFutureSignupLifecycleProjectionV2Json(body: string): NormalizedFutureSignupLifecycleProjectionV2Envelope;
 /** Validate shipped v1 and derive the closed destination view. No writes or sends. */
 export declare function normalizeFutureSignupLifecycleProjectionEnvelope(value: unknown): NormalizedFutureSignupLifecycleProjectionEnvelope;
+/** Validate the exact durable-Free v2 plaintext and derive its closed destination view. */
+export declare function normalizeFutureSignupLifecycleProjectionV2Envelope(value: unknown): NormalizedFutureSignupLifecycleProjectionV2Envelope;
 export declare function normalizeFutureSignupLifecycleProjectionDestinationApplyOptions(value: unknown): NormalizedFutureSignupLifecycleProjectionDestinationApplyOptions;
+export declare function normalizeFutureSignupLifecycleProjectionV2DestinationApplyOptions(value: unknown): NormalizedFutureSignupLifecycleProjectionV2DestinationApplyOptions;

package/node_modules/@oxygen/shared/dist/future-signup-lifecycle-projection.js

@@ -1,5 +1,5 @@
 import { createHash } from "node:crypto";
-import { FUTURE_SIGNUP_LIFECYCLE_CONTRACT_VERSION, FUTURE_SIGNUP_LIFECYCLE_PROJECTION_CONTRACT_VERSION, futureSignupJourneyId, futureSignupLifecycleEventId, futureSignupLifecycleProjectionFactId, futureSignupLifecycleProjectionRefreshFactId, futureSignupLostFactId, futureSignupPaidFactId, futureSignupSubscriptionEndedFactId, futureSignupTrialStartedFactId, futureSignupWorkspaceDeletedFactId, } from "./future-signup-events.js";
+import { FUTURE_SIGNUP_LIFECYCLE_CONTRACT_VERSION, FUTURE_SIGNUP_LIFECYCLE_CONTRACT_VERSION_V2, FUTURE_SIGNUP_LIFECYCLE_PROJECTION_CONTRACT_VERSION, FUTURE_SIGNUP_LIFECYCLE_PROJECTION_CONTRACT_VERSION_V2, futureSignupFreeStartedFactId, futureSignupJourneyId, futureSignupLifecycleEventId, futureSignupLifecycleProjectionFactId, futureSignupLifecycleProjectionV2FactId, futureSignupLifecycleProjectionRefreshFactId, futureSignupLostFactId, futureSignupPaidFactId, futureSignupSubscriptionEndedFactId, futureSignupTrialStartedFactId, futureSignupWorkspaceDeletedFactId, } from "./future-signup-events.js";
 /** Fixed destination-head authority. Contract upgrades cannot reset this stream. */
 export const FUTURE_SIGNUP_LIFECYCLE_PROJECTION_AUTHORITY = "oxygen_product_lifecycle";
 export const FUTURE_SIGNUP_LIFECYCLE_PROJECTION_FACT_TYPES = [
@@ -37,6 +37,45 @@ export const FUTURE_SIGNUP_LIFECYCLE_PROJECTION_ACTIVITY_TYPES = [
     "customer_lost",
     "workspace_deleted",
 ];
+export const FUTURE_SIGNUP_LIFECYCLE_PROJECTION_V2_FACT_TYPES = [
+    ...FUTURE_SIGNUP_LIFECYCLE_PROJECTION_FACT_TYPES,
+    "free_started",
+];
+export const FUTURE_SIGNUP_LIFECYCLE_PROJECTION_V2_BILLING_STAGES = [
+    "free",
+    "paid",
+    "lost",
+];
+export const FUTURE_SIGNUP_LIFECYCLE_PROJECTION_V2_SEMANTIC_STAGES = [
+    ...FUTURE_SIGNUP_LIFECYCLE_PROJECTION_PREBILLING_STAGES,
+    ...FUTURE_SIGNUP_LIFECYCLE_PROJECTION_V2_BILLING_STAGES,
+];
+export const FUTURE_SIGNUP_LIFECYCLE_PROJECTION_V2_ACTIVITY_TYPES = [
+    "plan_paid",
+    "customer_lost",
+    "workspace_deleted",
+];
+const PROJECTION_V1_SPEC = {
+    contractVersion: FUTURE_SIGNUP_LIFECYCLE_PROJECTION_CONTRACT_VERSION,
+    sourceContractVersions: [FUTURE_SIGNUP_LIFECYCLE_CONTRACT_VERSION],
+    billingStages: FUTURE_SIGNUP_LIFECYCLE_PROJECTION_BILLING_STAGES,
+    lossKinds: ["paid_churn", "trial_non_conversion"],
+    activityTypes: FUTURE_SIGNUP_LIFECYCLE_PROJECTION_ACTIVITY_TYPES,
+    projectionFactId: futureSignupLifecycleProjectionFactId,
+    activityType: legacyProjectionActivityType,
+};
+const PROJECTION_V2_SPEC = {
+    contractVersion: FUTURE_SIGNUP_LIFECYCLE_PROJECTION_CONTRACT_VERSION_V2,
+    sourceContractVersions: [
+        FUTURE_SIGNUP_LIFECYCLE_CONTRACT_VERSION,
+        FUTURE_SIGNUP_LIFECYCLE_CONTRACT_VERSION_V2,
+    ],
+    billingStages: FUTURE_SIGNUP_LIFECYCLE_PROJECTION_V2_BILLING_STAGES,
+    lossKinds: ["paid_churn"],
+    activityTypes: FUTURE_SIGNUP_LIFECYCLE_PROJECTION_V2_ACTIVITY_TYPES,
+    projectionFactId: futureSignupLifecycleProjectionV2FactId,
+    activityType: durableFreeProjectionActivityType,
+};
 /** Typed, PII-free parse failure. Raw values are intentionally never reflected. */
 export class FutureSignupLifecycleProjectionContractError extends TypeError {
     path;
@@ -51,6 +90,12 @@ export class FutureSignupLifecycleProjectionContractError extends TypeError {
 }
 /** Exact fingerprint algorithm used by the shipped v1 control builder. */
 export function futureSignupLifecycleProjectionFingerprints(input) {
+    return futureSignupLifecycleProjectionFingerprintsForContract(input, PROJECTION_V1_SPEC);
+}
+export function futureSignupLifecycleProjectionV2Fingerprints(input) {
+    return futureSignupLifecycleProjectionFingerprintsForContract(input, PROJECTION_V2_SPEC);
+}
+function futureSignupLifecycleProjectionFingerprintsForContract(input, spec) {
     const sourceFactFingerprint = sha256Canonical(input.sourceFact);
     const subjectSetFingerprint = sha256Canonical(input.snapshot.subjects.map((subject) => ({
         kind: subject.kind,
@@ -60,7 +105,7 @@ export function futureSignupLifecycleProjectionFingerprints(input) {
     })));
     const snapshotFingerprint = sha256Canonical(input.snapshot);
     const projectionFingerprint = sha256Canonical({
-        contract_version: FUTURE_SIGNUP_LIFECYCLE_PROJECTION_CONTRACT_VERSION,
+        contract_version: spec.contractVersion,
         event_id: input.eventId,
         source_fact_fingerprint: sourceFactFingerprint,
         snapshot_fingerprint: snapshotFingerprint,
@@ -83,8 +128,25 @@ export function parseFutureSignupLifecycleProjectionJson(body) {
     }
     return normalizeFutureSignupLifecycleProjectionEnvelope(value);
 }
+export function parseFutureSignupLifecycleProjectionV2Json(body) {
+    let value;
+    try {
+        value = JSON.parse(body);
+    }
+    catch {
+        invalid("$", "must be valid JSON");
+    }
+    return normalizeFutureSignupLifecycleProjectionV2Envelope(value);
+}
 /** Validate shipped v1 and derive the closed destination view. No writes or sends. */
 export function normalizeFutureSignupLifecycleProjectionEnvelope(value) {
+    return normalizeFutureSignupLifecycleProjectionEnvelopeForContract(value, PROJECTION_V1_SPEC);
+}
+/** Validate the exact durable-Free v2 plaintext and derive its closed destination view. */
+export function normalizeFutureSignupLifecycleProjectionV2Envelope(value) {
+    return normalizeFutureSignupLifecycleProjectionEnvelopeForContract(value, PROJECTION_V2_SPEC);
+}
+function normalizeFutureSignupLifecycleProjectionEnvelopeForContract(value, spec) {
     const root = exactRecord(value, "$", [
         "contract_version",
         "event_id",
@@ -101,7 +163,7 @@ export function normalizeFutureSignupLifecycleProjectionEnvelope(value) {
         "producer",
         "validation",
     ]);
-    literal(root.contract_version, FUTURE_SIGNUP_LIFECYCLE_PROJECTION_CONTRACT_VERSION, "$.contract_version");
+    literal(root.contract_version, spec.contractVersion, "$.contract_version");
     literal(root.event_type, "lifecycle_projection", "$.event_type");
     literal(root.provider, "oxygen", "$.provider");
     const eventId = canonicalText(root.event_id, "$.event_id");
@@ -119,9 +181,9 @@ export function normalizeFutureSignupLifecycleProjectionEnvelope(value) {
         provider_event_id: canonicalText(upstreamRaw.provider_event_id, "$.upstream.provider_event_id"),
         source_revision: positiveInteger(upstreamRaw.source_revision, "$.upstream.source_revision"),
     };
-    const sourceFact = parseSourceFact(root.source_fact);
-    const snapshot = parseSnapshot(root.snapshot);
-    const activity = parseShippedActivity(root.activity);
+    const sourceFact = parseSourceFact(root.source_fact, spec);
+    const snapshot = parseSnapshot(root.snapshot, spec);
+    const activity = parseShippedActivity(root.activity, spec);
     const producerRaw = exactRecord(root.producer, "$.producer", [
         "environment",
         "version",
@@ -135,7 +197,7 @@ export function normalizeFutureSignupLifecycleProjectionEnvelope(value) {
     const validationRaw = exactRecord(root.validation, "$.validation", ["synthetic", "no_send"]);
     literal(validationRaw.synthetic, false, "$.validation.synthetic");
     literal(validationRaw.no_send, true, "$.validation.no_send");
-    const expectedProjectionFactId = futureSignupLifecycleProjectionFactId(sourceFact.fact_id);
+    const expectedProjectionFactId = spec.projectionFactId(sourceFact.fact_id);
     const expectedEventId = futureSignupLifecycleEventId(expectedProjectionFactId, sourceFact.fact_revision);
     same(factId, expectedProjectionFactId, "$.fact_id", "must match the source fact identity");
     same(factRevision, sourceFact.fact_revision, "$.fact_revision", "must match source_fact.fact_revision");
@@ -147,7 +209,7 @@ export function normalizeFutureSignupLifecycleProjectionEnvelope(value) {
     same(upstream.source_revision, sourceFact.source_revision, "$.upstream.source_revision", "must match source_fact.source_revision");
     same(snapshot.causal_clerk_org_id, sourceFact.clerk_org_id, "$.snapshot.causal_clerk_org_id", "must match source_fact.clerk_org_id");
     assertProjectionClosure(snapshot);
-    assertShippedActivity(activity, sourceFact, snapshot);
+    assertShippedActivity(activity, sourceFact, snapshot, spec);
     const snapshotCore = {
         complete: true,
         causal_clerk_org_id: snapshot.causal_clerk_org_id,
@@ -155,15 +217,15 @@ export function normalizeFutureSignupLifecycleProjectionEnvelope(value) {
         membership_states: snapshot.membership_states,
         subjects: snapshot.subjects,
     };
-    const fingerprints = futureSignupLifecycleProjectionFingerprints({
+    const fingerprints = futureSignupLifecycleProjectionFingerprintsForContract({
         eventId,
         sourceFact,
         snapshot: snapshotCore,
-    });
+    }, spec);
     same(snapshot.subject_set_fingerprint, fingerprints.subject_set_fingerprint, "$.snapshot.subject_set_fingerprint", "does not match the canonical subject set");
-    same(snapshot.snapshot_fingerprint, fingerprints.snapshot_fingerprint, "$.snapshot.snapshot_fingerprint", "does not match the canonical shipped-v1 snapshot");
+    same(snapshot.snapshot_fingerprint, fingerprints.snapshot_fingerprint, "$.snapshot.snapshot_fingerprint", `does not match the canonical shipped-${spec.contractVersion.endsWith(".v1") ? "v1" : "v2"} snapshot`);
     const envelope = {
-        contract_version: FUTURE_SIGNUP_LIFECYCLE_PROJECTION_CONTRACT_VERSION,
+        contract_version: spec.contractVersion,
         event_id: eventId,
         event_type: "lifecycle_projection",
         fact_id: factId,
@@ -183,7 +245,7 @@ export function normalizeFutureSignupLifecycleProjectionEnvelope(value) {
     return {
         envelope,
         projection: {
-            contract_version: FUTURE_SIGNUP_LIFECYCLE_PROJECTION_CONTRACT_VERSION,
+            contract_version: spec.contractVersion,
             authority: FUTURE_SIGNUP_LIFECYCLE_PROJECTION_AUTHORITY,
             event_id: eventId,
             occurred_at: occurredAt,
@@ -209,6 +271,12 @@ export function normalizeFutureSignupLifecycleProjectionEnvelope(value) {
     };
 }
 export function normalizeFutureSignupLifecycleProjectionDestinationApplyOptions(value) {
+    return normalizeFutureSignupLifecycleProjectionDestinationApplyOptionsForStages(value, FUTURE_SIGNUP_LIFECYCLE_PROJECTION_SEMANTIC_STAGES);
+}
+export function normalizeFutureSignupLifecycleProjectionV2DestinationApplyOptions(value) {
+    return normalizeFutureSignupLifecycleProjectionDestinationApplyOptionsForStages(value, FUTURE_SIGNUP_LIFECYCLE_PROJECTION_V2_SEMANTIC_STAGES);
+}
+function normalizeFutureSignupLifecycleProjectionDestinationApplyOptionsForStages(value, semanticStages) {
     const root = exactRecord(value, "$", [
         "objects",
         "stage_tokens",
@@ -219,8 +287,8 @@ export function normalizeFutureSignupLifecycleProjectionDestinationApplyOptions(
     literal(objectsRaw.people, "people", "$.objects.people");
     literal(objectsRaw.companies, "companies", "$.objects.companies");
     const stagesRaw = exactRecord(root.stage_tokens, "$.stage_tokens", ["people", "companies"]);
-    const peopleStages = parseStageMapping(stagesRaw.people, "$.stage_tokens.people");
-    const companyStages = parseStageMapping(stagesRaw.companies, "$.stage_tokens.companies");
+    const peopleStages = parseStageMapping(stagesRaw.people, "$.stage_tokens.people", semanticStages);
+    const companyStages = parseStageMapping(stagesRaw.companies, "$.stage_tokens.companies", semanticStages);
     let owner = null;
     if (root.owner_if_blank !== null) {
         const ownerRaw = exactRecord(root.owner_if_blank, "$.owner_if_blank", ["workspace_user_id"]);
@@ -257,7 +325,7 @@ export function normalizeFutureSignupLifecycleProjectionDestinationApplyOptions(
         apply_options_fingerprint: sha256Canonical(applyOptions),
     };
 }
-function parseSourceFact(value) {
+function parseSourceFact(value, spec) {
     const path = "$.source_fact";
     const row = exactRecord(value, path, [
         "fact_id",
@@ -279,12 +347,25 @@ function parseSourceFact(value) {
         "loss_kind",
         "termination_kind",
     ]);
-    literal(row.contract_version, FUTURE_SIGNUP_LIFECYCLE_CONTRACT_VERSION, `${path}.contract_version`);
+    let contractVersion;
+    if (spec.sourceContractVersions.length === 1) {
+        const exactContractVersion = spec.sourceContractVersions[0];
+        if (!exactContractVersion)
+            invalid(`${path}.contract_version`, "has no configured contract");
+        literal(row.contract_version, exactContractVersion, `${path}.contract_version`);
+        contractVersion = exactContractVersion;
+    }
+    else {
+        contractVersion = enumValue(row.contract_version, spec.sourceContractVersions, `${path}.contract_version`);
+    }
+    const factTypes = contractVersion === FUTURE_SIGNUP_LIFECYCLE_CONTRACT_VERSION_V2
+        ? ["free_started"]
+        : FUTURE_SIGNUP_LIFECYCLE_PROJECTION_FACT_TYPES;
     const fact = {
         fact_id: canonicalText(row.fact_id, `${path}.fact_id`),
         fact_revision: positiveInteger(row.fact_revision, `${path}.fact_revision`),
-        contract_version: FUTURE_SIGNUP_LIFECYCLE_CONTRACT_VERSION,
-        fact_type: enumValue(row.fact_type, FUTURE_SIGNUP_LIFECYCLE_PROJECTION_FACT_TYPES, `${path}.fact_type`),
+        contract_version: contractVersion,
+        fact_type: enumValue(row.fact_type, factTypes, `${path}.fact_type`),
         clerk_org_id: canonicalText(row.clerk_org_id, `${path}.clerk_org_id`),
         occurred_at: timestamp(row.occurred_at, `${path}.occurred_at`),
         source: enumValue(row.source, ["clerk", "clerk_org_deletion", "stripe"], `${path}.source`),
@@ -305,6 +386,23 @@ function parseSourceFact(value) {
 }
 function assertSourceFactShape(fact) {
     const path = "$.source_fact";
+    if (fact.contract_version === FUTURE_SIGNUP_LIFECYCLE_CONTRACT_VERSION_V2) {
+        same(fact.fact_type, "free_started", `${path}.fact_type`, "must be free_started for v2");
+        same(fact.source, "clerk", `${path}.source`, "must be clerk for free_started");
+        allNull(fact, [
+            "stripe_customer_id",
+            "stripe_subscription_id",
+            "stripe_invoice_id",
+            "stripe_period_start",
+            "stripe_period_end",
+            "amount_paid_cents",
+            "currency",
+            "loss_kind",
+            "termination_kind",
+        ], path);
+        same(fact.fact_id, futureSignupFreeStartedFactId(fact.clerk_org_id), `${path}.fact_id`, "must match the immutable durable-Free entry edge");
+        return;
+    }
     if (fact.fact_type === "trial_started") {
         same(fact.source, "stripe", `${path}.source`, "must be stripe for trial_started");
         present(fact.stripe_customer_id, `${path}.stripe_customer_id`);
@@ -390,7 +488,7 @@ function assertSourceFactShape(fact) {
         : futureSignupLifecycleProjectionRefreshFactId(fact.clerk_org_id, fact.source_event_id);
     same(fact.fact_id, expected, `${path}.fact_id`, "must match the immutable Clerk cause");
 }
-function parseSnapshot(value) {
+function parseSnapshot(value, spec) {
     const path = "$.snapshot";
     const row = exactRecord(value, path, [
         "complete",
@@ -408,11 +506,11 @@ function parseSnapshot(value) {
         invalid(`${path}.membership_states`, "must be an array");
     if (!Array.isArray(row.subjects))
         invalid(`${path}.subjects`, "must be an array");
-    const organizations = row.organization_states.map((item, index) => parseOrganizationState(item, `${path}.organization_states[${index}]`));
+    const organizations = row.organization_states.map((item, index) => parseOrganizationState(item, `${path}.organization_states[${index}]`, spec));
     assertSortedUnique(organizations, (item) => item.clerk_org_id, `${path}.organization_states`);
     const memberships = row.membership_states.map((item, index) => parseMembershipState(item, `${path}.membership_states[${index}]`));
     assertSortedUnique(memberships, (item) => `${item.clerk_user_id}\u0000${item.clerk_org_id}\u0000${item.clerk_membership_id}`, `${path}.membership_states`);
-    const subjects = row.subjects.map((item, index) => parseSubject(item, `${path}.subjects[${index}]`));
+    const subjects = row.subjects.map((item, index) => parseSubject(item, `${path}.subjects[${index}]`, spec));
     assertSortedUnique(subjects, (item) => `${item.kind}\u0000${item.key}`, `${path}.subjects`);
     const subjectKeys = subjects.map((subject) => subject.key);
     if (new Set(subjectKeys).size !== subjectKeys.length) {
@@ -428,7 +526,7 @@ function parseSnapshot(value) {
         snapshot_fingerprint: fingerprint(row.snapshot_fingerprint, `${path}.snapshot_fingerprint`),
     };
 }
-function parseOrganizationState(value, path) {
+function parseOrganizationState(value, path, spec) {
     const row = exactRecord(value, path, [
         "clerk_org_id",
         "company_key",
@@ -461,9 +559,9 @@ function parseOrganizationState(value, path) {
         company_key: canonicalText(row.company_key, `${path}.company_key`),
         company_key_history: history,
         normalized_domain: nullableDomain(row.normalized_domain, `${path}.normalized_domain`),
-        billing_stage: nullableEnum(row.billing_stage, FUTURE_SIGNUP_LIFECYCLE_PROJECTION_BILLING_STAGES, `${path}.billing_stage`),
+        billing_stage: nullableEnum(row.billing_stage, spec.billingStages, `${path}.billing_stage`),
         stage_since: nullableTimestamp(row.stage_since, `${path}.stage_since`),
-        loss_kind: nullableEnum(row.loss_kind, ["paid_churn", "trial_non_conversion"], `${path}.loss_kind`),
+        loss_kind: nullableEnum(row.loss_kind, spec.lossKinds, `${path}.loss_kind`),
         winning_fact_id: nullableText(row.winning_fact_id, `${path}.winning_fact_id`),
         winning_fact_revision: nullablePositiveInteger(row.winning_fact_revision, `${path}.winning_fact_revision`),
         organization_revision: positiveInteger(row.organization_revision, `${path}.organization_revision`),
@@ -538,7 +636,7 @@ function parseMembershipState(value, path) {
     }
     return state;
 }
-function parseSubject(value, path) {
+function parseSubject(value, path, spec) {
     const row = exactRecord(value, path, [
         "kind",
         "key",
@@ -625,7 +723,7 @@ function parseSubject(value, path) {
     const subject = {
         kind: enumValue(row.kind, ["company", "person"], `${path}.kind`),
         key: canonicalText(row.key, `${path}.key`),
-        billing_stage: nullableEnum(row.billing_stage, FUTURE_SIGNUP_LIFECYCLE_PROJECTION_BILLING_STAGES, `${path}.billing_stage`),
+        billing_stage: nullableEnum(row.billing_stage, spec.billingStages, `${path}.billing_stage`),
         stage_since: nullableTimestamp(row.stage_since, `${path}.stage_since`),
         aggregate_revision: aggregateRevision,
         aggregate_fingerprint: aggregateFingerprint,
@@ -849,7 +947,28 @@ snapshot) {
         }
     }
 }
-function parseShippedActivity(value) {
+function legacyProjectionActivityType(sourceFact) {
+    if (sourceFact.fact_type === "trial_started")
+        return "trial_started";
+    if (sourceFact.fact_type === "paid")
+        return "plan_paid";
+    if (sourceFact.fact_type === "lost")
+        return "customer_lost";
+    if (sourceFact.fact_type === "workspace_deleted")
+        return "workspace_deleted";
+    return "note";
+}
+function durableFreeProjectionActivityType(sourceFact) {
+    if (sourceFact.fact_type === "paid")
+        return "plan_paid";
+    if (sourceFact.fact_type === "lost" && sourceFact.loss_kind === "paid_churn") {
+        return "customer_lost";
+    }
+    if (sourceFact.fact_type === "workspace_deleted")
+        return "workspace_deleted";
+    return "note";
+}
+function parseShippedActivity(value, spec) {
     const path = "$.activity";
     const row = exactRecord(value, path, [
         "type",
@@ -873,7 +992,7 @@ function parseShippedActivity(value) {
         "termination_kind",
     ]);
     return {
-        type: enumValue(row.type, [...FUTURE_SIGNUP_LIFECYCLE_PROJECTION_ACTIVITY_TYPES, "note"], `${path}.type`),
+        type: enumValue(row.type, [...spec.activityTypes, "note"], `${path}.type`),
         source_provider: FUTURE_SIGNUP_LIFECYCLE_PROJECTION_AUTHORITY,
         provider_event_id: canonicalText(row.provider_event_id, `${path}.provider_event_id`),
         occurred_at: timestamp(row.occurred_at, `${path}.occurred_at`),
@@ -888,18 +1007,10 @@ function parseShippedActivity(value) {
         },
     };
 }
-function assertShippedActivity(activity, sourceFact, snapshot) {
-    const expectedType = sourceFact.fact_type === "trial_started"
-        ? "trial_started"
-        : sourceFact.fact_type === "paid"
-            ? "plan_paid"
-            : sourceFact.fact_type === "lost"
-                ? "customer_lost"
-                : sourceFact.fact_type === "workspace_deleted"
-                    ? "workspace_deleted"
-                    : "note";
+function assertShippedActivity(activity, sourceFact, snapshot, spec) {
+    const expectedType = spec.activityType(sourceFact);
     same(activity.type, expectedType, "$.activity.type", "does not match source_fact.fact_type");
-    same(activity.provider_event_id, futureSignupLifecycleEventId(futureSignupLifecycleProjectionFactId(sourceFact.fact_id), sourceFact.fact_revision), "$.activity.provider_event_id", "must equal the projection event identity");
+    same(activity.provider_event_id, futureSignupLifecycleEventId(spec.projectionFactId(sourceFact.fact_id), sourceFact.fact_revision), "$.activity.provider_event_id", "must equal the projection event identity");
     same(activity.occurred_at, sourceFact.occurred_at, "$.activity.occurred_at", "must match source_fact.occurred_at");
     same(activity.metadata.source_fact_id, sourceFact.fact_id, "$.activity.metadata.source_fact_id", "must match source_fact.fact_id");
     same(activity.metadata.source_fact_revision, sourceFact.fact_revision, "$.activity.metadata.source_fact_revision", "must match source_fact.fact_revision");
@@ -973,7 +1084,7 @@ function normalizeSubjects(snapshot, sourceFact) {
     });
 }
 function normalizeActivity(activity, sourceFact, subjects) {
-    if (sourceFact.fact_type === "projection_refreshed" || sourceFact.fact_type === "subscription_ended") {
+    if (activity.type === "note") {
         return {
             emit: false,
             type: null,
@@ -1033,13 +1144,13 @@ function assertBillingShape(state, path) {
             invalid(`${path}.loss_kind`, "must be null unless billing_stage is lost");
     }
 }
-function parseStageMapping(value, path) {
-    const row = exactRecord(value, path, FUTURE_SIGNUP_LIFECYCLE_PROJECTION_SEMANTIC_STAGES);
-    const mapping = Object.fromEntries(FUTURE_SIGNUP_LIFECYCLE_PROJECTION_SEMANTIC_STAGES.map((stage) => [
+function parseStageMapping(value, path, semanticStages) {
+    const row = exactRecord(value, path, semanticStages);
+    const mapping = Object.fromEntries(semanticStages.map((stage) => [
         stage,
         stageToken(row[stage], `${path}.${stage}`),
     ]));
-    if (new Set(Object.values(mapping)).size !== FUTURE_SIGNUP_LIFECYCLE_PROJECTION_SEMANTIC_STAGES.length) {
+    if (new Set(Object.values(mapping)).size !== semanticStages.length) {
         invalid(path, "must map the six semantic stages to six distinct physical tokens");
     }
     return mapping;