@contractspec/example.crm-pipeline 1.44.0

package/dist/presentations/pipeline.presentation.js

@@ -0,0 +1,119 @@
+import { DealModel } from "../deal/deal.schema.js";
+import { StabilityEnum } from "@contractspec/lib.contracts";
+
+//#region src/presentations/pipeline.presentation.ts
+/**
+* Kanban board presentation for the sales pipeline.
+*/
+const PipelineKanbanPresentation = {
+	meta: {
+		key: "crm.pipeline.kanban",
+		version: 1,
+		title: "Pipeline Kanban",
+		description: "Kanban board view of deals organized by stage",
+		domain: "crm-pipeline",
+		owners: ["@crm-team"],
+		tags: [
+			"pipeline",
+			"kanban",
+			"deals"
+		],
+		stability: StabilityEnum.Experimental,
+		goal: "Visualize the sales pipeline status and deal distribution across stages.",
+		context: "Used in the sales dashboard and management reports."
+	},
+	source: {
+		type: "component",
+		framework: "react",
+		componentKey: "PipelineKanbanView",
+		props: DealModel
+	},
+	targets: ["react", "markdown"],
+	policy: { flags: ["crm.pipeline.enabled"] }
+};
+/**
+* List view of deals with filtering.
+*/
+const DealListPresentation = {
+	meta: {
+		key: "crm.deal.list",
+		version: 1,
+		title: "Deal List",
+		description: "List view of deals with value, status, and owner info",
+		domain: "crm-pipeline",
+		owners: ["@crm-team"],
+		tags: ["deal", "list"],
+		stability: StabilityEnum.Experimental,
+		goal: "Search, filter, and review deal lists.",
+		context: "Standard view for deal management and bulk actions."
+	},
+	source: {
+		type: "component",
+		framework: "react",
+		componentKey: "DealListView",
+		props: DealModel
+	},
+	targets: [
+		"react",
+		"markdown",
+		"application/json"
+	],
+	policy: { flags: ["crm.deals.enabled"] }
+};
+/**
+* Deal detail presentation.
+*/
+const DealDetailPresentation = {
+	meta: {
+		key: "crm.deal.detail",
+		version: 1,
+		title: "Deal Details",
+		description: "Detailed view of a deal with activities, contacts, and history",
+		domain: "crm-pipeline",
+		owners: ["@crm-team"],
+		tags: ["deal", "detail"],
+		stability: StabilityEnum.Experimental,
+		goal: "Deep dive into deal details and historical activities.",
+		context: "The main workspace for managing a single deal execution."
+	},
+	source: {
+		type: "component",
+		framework: "react",
+		componentKey: "DealDetailView"
+	},
+	targets: ["react", "markdown"],
+	policy: { flags: ["crm.deals.enabled"] }
+};
+/**
+* Deal card for kanban board.
+*/
+const DealCardPresentation = {
+	meta: {
+		key: "crm.deal.card",
+		version: 1,
+		title: "Deal Card",
+		description: "Compact deal card for kanban board display",
+		domain: "crm-pipeline",
+		owners: ["@crm-team"],
+		tags: [
+			"deal",
+			"card",
+			"kanban"
+		],
+		stability: StabilityEnum.Experimental,
+		goal: "Provide a quick overview of deal status in the pipeline view.",
+		context: "Condensed representation used within the Pipeline Kanban board."
+	},
+	source: {
+		type: "component",
+		framework: "react",
+		componentKey: "DealCard",
+		props: DealModel
+	},
+	targets: ["react"],
+	policy: { flags: ["crm.deals.enabled"] }
+};
+
+//#endregion
+export { DealCardPresentation, DealDetailPresentation, DealListPresentation, PipelineKanbanPresentation };
+//# sourceMappingURL=pipeline.presentation.js.map

package/dist/presentations/pipeline.presentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.presentation.js","names":["PipelineKanbanPresentation: PresentationSpec","DealListPresentation: PresentationSpec","DealDetailPresentation: PresentationSpec","DealCardPresentation: PresentationSpec"],"sources":["../../src/presentations/pipeline.presentation.ts"],"sourcesContent":["/**\n * Pipeline Presentation Descriptors\n */\nimport type { PresentationSpec } from '@contractspec/lib.contracts';\nimport { StabilityEnum } from '@contractspec/lib.contracts';\nimport { DealModel } from '../deal/deal.schema';\n\n/**\n * Kanban board presentation for the sales pipeline.\n */\nexport const PipelineKanbanPresentation: PresentationSpec = {\n  meta: {\n    key: 'crm.pipeline.kanban',\n    version: 1,\n    title: 'Pipeline Kanban',\n    description: 'Kanban board view of deals organized by stage',\n    domain: 'crm-pipeline',\n    owners: ['@crm-team'],\n    tags: ['pipeline', 'kanban', 'deals'],\n    stability: StabilityEnum.Experimental,\n    goal: 'Visualize the sales pipeline status and deal distribution across stages.',\n    context: 'Used in the sales dashboard and management reports.',\n  },\n  source: {\n    type: 'component',\n    framework: 'react',\n    componentKey: 'PipelineKanbanView',\n    props: DealModel,\n  },\n  targets: ['react', 'markdown'],\n  policy: {\n    flags: ['crm.pipeline.enabled'],\n  },\n};\n\n/**\n * List view of deals with filtering.\n */\nexport const DealListPresentation: PresentationSpec = {\n  meta: {\n    key: 'crm.deal.list',\n    version: 1,\n    title: 'Deal List',\n    description: 'List view of deals with value, status, and owner info',\n    domain: 'crm-pipeline',\n    owners: ['@crm-team'],\n    tags: ['deal', 'list'],\n    stability: StabilityEnum.Experimental,\n    goal: 'Search, filter, and review deal lists.',\n    context: 'Standard view for deal management and bulk actions.',\n  },\n  source: {\n    type: 'component',\n    framework: 'react',\n    componentKey: 'DealListView',\n    props: DealModel,\n  },\n  targets: ['react', 'markdown', 'application/json'],\n  policy: {\n    flags: ['crm.deals.enabled'],\n  },\n};\n\n/**\n * Deal detail presentation.\n */\nexport const DealDetailPresentation: PresentationSpec = {\n  meta: {\n    key: 'crm.deal.detail',\n    version: 1,\n    title: 'Deal Details',\n    description:\n      'Detailed view of a deal with activities, contacts, and history',\n    domain: 'crm-pipeline',\n    owners: ['@crm-team'],\n    tags: ['deal', 'detail'],\n    stability: StabilityEnum.Experimental,\n    goal: 'Deep dive into deal details and historical activities.',\n    context: 'The main workspace for managing a single deal execution.',\n  },\n  source: {\n    type: 'component',\n    framework: 'react',\n    componentKey: 'DealDetailView',\n  },\n  targets: ['react', 'markdown'],\n  policy: {\n    flags: ['crm.deals.enabled'],\n  },\n};\n\n/**\n * Deal card for kanban board.\n */\nexport const DealCardPresentation: PresentationSpec = {\n  meta: {\n    key: 'crm.deal.card',\n    version: 1,\n    title: 'Deal Card',\n    description: 'Compact deal card for kanban board display',\n    domain: 'crm-pipeline',\n    owners: ['@crm-team'],\n    tags: ['deal', 'card', 'kanban'],\n    stability: StabilityEnum.Experimental,\n    goal: 'Provide a quick overview of deal status in the pipeline view.',\n    context: 'Condensed representation used within the Pipeline Kanban board.',\n  },\n  source: {\n    type: 'component',\n    framework: 'react',\n    componentKey: 'DealCard',\n    props: DealModel,\n  },\n  targets: ['react'],\n  policy: {\n    flags: ['crm.deals.enabled'],\n  },\n};\n"],"mappings":";;;;;;;AAUA,MAAaA,6BAA+C;CAC1D,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aAAa;EACb,QAAQ;EACR,QAAQ,CAAC,YAAY;EACrB,MAAM;GAAC;GAAY;GAAU;GAAQ;EACrC,WAAW,cAAc;EACzB,MAAM;EACN,SAAS;EACV;CACD,QAAQ;EACN,MAAM;EACN,WAAW;EACX,cAAc;EACd,OAAO;EACR;CACD,SAAS,CAAC,SAAS,WAAW;CAC9B,QAAQ,EACN,OAAO,CAAC,uBAAuB,EAChC;CACF;;;;AAKD,MAAaC,uBAAyC;CACpD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aAAa;EACb,QAAQ;EACR,QAAQ,CAAC,YAAY;EACrB,MAAM,CAAC,QAAQ,OAAO;EACtB,WAAW,cAAc;EACzB,MAAM;EACN,SAAS;EACV;CACD,QAAQ;EACN,MAAM;EACN,WAAW;EACX,cAAc;EACd,OAAO;EACR;CACD,SAAS;EAAC;EAAS;EAAY;EAAmB;CAClD,QAAQ,EACN,OAAO,CAAC,oBAAoB,EAC7B;CACF;;;;AAKD,MAAaC,yBAA2C;CACtD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,YAAY;EACrB,MAAM,CAAC,QAAQ,SAAS;EACxB,WAAW,cAAc;EACzB,MAAM;EACN,SAAS;EACV;CACD,QAAQ;EACN,MAAM;EACN,WAAW;EACX,cAAc;EACf;CACD,SAAS,CAAC,SAAS,WAAW;CAC9B,QAAQ,EACN,OAAO,CAAC,oBAAoB,EAC7B;CACF;;;;AAKD,MAAaC,uBAAyC;CACpD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aAAa;EACb,QAAQ;EACR,QAAQ,CAAC,YAAY;EACrB,MAAM;GAAC;GAAQ;GAAQ;GAAS;EAChC,WAAW,cAAc;EACzB,MAAM;EACN,SAAS;EACV;CACD,QAAQ;EACN,MAAM;EACN,WAAW;EACX,cAAc;EACd,OAAO;EACR;CACD,SAAS,CAAC,QAAQ;CAClB,QAAQ,EACN,OAAO,CAAC,oBAAoB,EAC7B;CACF"}

package/example.ts

@@ -0,0 +1 @@
+export { default } from './src/example';

package/package.json

@@ -0,0 +1,105 @@
+{
+  "name": "@contractspec/example.crm-pipeline",
+  "version": "1.44.0",
+  "description": "CRM Pipeline - Contacts, Companies, Deals, Tasks",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./crm-pipeline.feature": "./dist/crm-pipeline.feature.js",
+    "./deal": "./dist/deal/index.js",
+    "./deal/deal.enum": "./dist/deal/deal.enum.js",
+    "./deal/deal.operation": "./dist/deal/deal.operation.js",
+    "./deal/deal.schema": "./dist/deal/deal.schema.js",
+    "./docs": "./dist/docs/index.js",
+    "./docs/crm-pipeline.docblock": "./dist/docs/crm-pipeline.docblock.js",
+    "./entities": "./dist/entities/index.js",
+    "./entities/company.entity": "./dist/entities/company.entity.js",
+    "./entities/contact.entity": "./dist/entities/contact.entity.js",
+    "./entities/deal.entity": "./dist/entities/deal.entity.js",
+    "./entities/task.entity": "./dist/entities/task.entity.js",
+    "./events": "./dist/events/index.js",
+    "./events/contact.event": "./dist/events/contact.event.js",
+    "./events/deal.event": "./dist/events/deal.event.js",
+    "./events/task.event": "./dist/events/task.event.js",
+    "./example": "./dist/example.js",
+    "./handlers": "./dist/handlers/index.js",
+    "./handlers/deal.handlers": "./dist/handlers/deal.handlers.js",
+    "./handlers/mock-data": "./dist/handlers/mock-data.js",
+    "./operations": "./dist/operations/index.js",
+    "./presentations": "./dist/presentations/index.js",
+    "./presentations/dashboard.presentation": "./dist/presentations/dashboard.presentation.js",
+    "./presentations/pipeline.presentation": "./dist/presentations/pipeline.presentation.js",
+    "./*": "./*"
+  },
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src",
+    "test": "bun run"
+  },
+  "dependencies": {
+    "@contractspec/lib.schema": "1.44.0",
+    "@contractspec/lib.contracts": "1.44.0",
+    "@contractspec/lib.bus": "1.44.0",
+    "@contractspec/lib.identity-rbac": "1.44.0",
+    "@contractspec/lib.jobs": "1.44.0",
+    "@contractspec/module.audit-trail": "1.44.0",
+    "@contractspec/module.notifications": "1.44.0",
+    "zod": "^4.1.13"
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "1.44.0",
+    "@contractspec/tool.typescript": "1.44.0",
+    "tsdown": "^0.18.3",
+    "typescript": "^5.9.3"
+  },
+  "module": "./dist/index.js",
+  "publishConfig": {
+    "exports": {
+      ".": "./dist/index.js",
+      "./contracts": "./dist/contracts/index.js",
+      "./crm-pipeline.feature": "./dist/crm-pipeline.feature.js",
+      "./deal": "./dist/deal/index.js",
+      "./deal/deal.contracts": "./dist/deal/deal.operations.js",
+      "./deal/deal.enum": "./dist/deal/deal.enum.js",
+      "./deal/deal.schema": "./dist/deal/deal.schema.js",
+      "./docs": "./dist/docs/index.js",
+      "./docs/crm-pipeline.docblock": "./dist/docs/crm-pipeline.docblock.js",
+      "./entities": "./dist/entities/index.js",
+      "./entities/company.entity": "./dist/entities/company.entity.js",
+      "./entities/contact.entity": "./dist/entities/contact.entity.js",
+      "./entities/deal.entity": "./dist/entities/deal.entity.js",
+      "./entities/task.entity": "./dist/entities/task.entity.js",
+      "./events": "./dist/events/index.js",
+      "./events/contact.event": "./dist/events/contact.event.js",
+      "./events/deal.event": "./dist/events/deal.event.js",
+      "./events/task.event": "./dist/events/task.event.js",
+      "./example": "./dist/example.js",
+      "./handlers": "./dist/handlers/index.js",
+      "./handlers/deal.handlers": "./dist/handlers/deal.handlers.js",
+      "./handlers/mock-data": "./dist/handlers/mock-data.js",
+      "./presentations": "./dist/presentations/index.js",
+      "./presentations/dashboard.presentation": "./dist/presentations/dashboard.presentation.js",
+      "./presentations/pipeline.presentation": "./dist/presentations/pipeline.presentation.js",
+      "./*": "./*"
+    },
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/examples/crm-pipeline"
+  },
+  "homepage": "https://contractspec.io"
+}

package/src/crm-pipeline.feature.ts

@@ -0,0 +1,96 @@
+/**
+ * CRM Pipeline Feature Module Specification
+ *
+ * Defines the feature module for CRM and sales pipeline capabilities.
+ */
+import type { FeatureModuleSpec } from '@contractspec/lib.contracts';
+
+/**
+ * CRM Pipeline feature module that bundles deal management,
+ * pipeline operations, and contact management into an installable feature.
+ */
+export const CrmPipelineFeature: FeatureModuleSpec = {
+  meta: {
+    key: 'crm-pipeline',
+    title: 'CRM Pipeline',
+    description:
+      'CRM and sales pipeline management with deals, contacts, and companies',
+    domain: 'crm',
+    owners: ['@crm-team'],
+    tags: ['crm', 'sales', 'pipeline', 'deals'],
+    stability: 'experimental',
+    version: 1,
+  },
+
+  // All contract operations included in this feature
+  operations: [
+    // Deal operations
+    { key: 'crm.deal.create', version: 1 },
+    { key: 'crm.deal.move', version: 1 },
+    { key: 'crm.deal.win', version: 1 },
+    { key: 'crm.deal.lose', version: 1 },
+    { key: 'crm.deal.list', version: 1 },
+  ],
+
+  // Events emitted by this feature
+  events: [
+    // Deal events
+    { key: 'deal.created', version: 1 },
+    { key: 'deal.moved', version: 1 },
+    { key: 'deal.won', version: 1 },
+    { key: 'deal.lost', version: 1 },
+
+    // Contact events
+    { key: 'contact.created', version: 1 },
+
+    // Task events
+    { key: 'task.completed', version: 1 },
+  ],
+
+  // Presentations associated with this feature
+  presentations: [
+    { key: 'crm.dashboard', version: 1 },
+    { key: 'crm.pipeline.kanban', version: 1 },
+    { key: 'crm.deal.list', version: 1 },
+    { key: 'crm.deal.detail', version: 1 },
+    { key: 'crm.deal.card', version: 1 },
+    { key: 'crm.pipeline.metrics', version: 1 },
+  ],
+
+  // Link operations to their primary presentations
+  opToPresentation: [
+    {
+      op: { key: 'crm.deal.list', version: 1 },
+      pres: { key: 'crm.pipeline.kanban', version: 1 },
+    },
+    {
+      op: { key: 'crm.deal.move', version: 1 },
+      pres: { key: 'crm.pipeline.kanban', version: 1 },
+    },
+  ],
+
+  // Target requirements for multi-surface rendering
+  presentationsTargets: [
+    { key: 'crm.dashboard', version: 1, targets: ['react', 'markdown'] },
+    { key: 'crm.pipeline.kanban', version: 1, targets: ['react', 'markdown'] },
+    {
+      key: 'crm.deal.list',
+      version: 1,
+      targets: ['react', 'markdown', 'application/json'],
+    },
+    {
+      key: 'crm.pipeline.metrics',
+      version: 1,
+      targets: ['react', 'markdown'],
+    },
+  ],
+
+  // Capability requirements
+  capabilities: {
+    requires: [
+      { key: 'identity', version: 1 },
+      { key: 'audit-trail', version: 1 },
+      { key: 'notifications', version: 1 },
+    ],
+  },
+};

package/src/deal/deal.enum.ts

@@ -0,0 +1,21 @@
+import { defineEnum } from '@contractspec/lib.schema';
+
+/**
+ * Deal status enum.
+ */
+export const DealStatusEnum = defineEnum('DealStatus', [
+  'OPEN',
+  'WON',
+  'LOST',
+  'STALE',
+]);
+
+/**
+ * Deal status filter enum.
+ */
+export const DealStatusFilterEnum = defineEnum('DealStatusFilter', [
+  'OPEN',
+  'WON',
+  'LOST',
+  'all',
+]);

package/src/deal/deal.operation.ts

@@ -0,0 +1,291 @@
+import {
+  defineCommand,
+  defineQuery,
+} from '@contractspec/lib.contracts/operations';
+import {
+  DealModel,
+  CreateDealInputModel,
+  MoveDealInputModel,
+  DealMovedPayloadModel,
+  WinDealInputModel,
+  DealWonPayloadModel,
+  LoseDealInputModel,
+  DealLostPayloadModel,
+  ListDealsInputModel,
+  ListDealsOutputModel,
+} from './deal.schema';
+
+const OWNERS = ['@example.crm-pipeline'] as const;
+
+/**
+ * Create a new deal.
+ */
+export const CreateDealContract = defineCommand({
+  meta: {
+    key: 'crm.deal.create',
+    version: 1,
+    stability: 'stable',
+    owners: [...OWNERS],
+    tags: ['crm', 'deal', 'create'],
+    description: 'Create a new deal in the pipeline.',
+    goal: 'Allow sales reps to create new opportunities.',
+    context: 'Deal creation UI, quick add.',
+  },
+  io: {
+    input: CreateDealInputModel,
+    output: DealModel,
+  },
+  policy: {
+    auth: 'user',
+  },
+  sideEffects: {
+    emits: [
+      {
+        key: 'deal.created',
+        version: 1,
+        when: 'Deal is created',
+        payload: DealModel,
+      },
+    ],
+    audit: ['deal.created'],
+  },
+  acceptance: {
+    scenarios: [
+      {
+        key: 'create-deal-happy-path',
+        given: ['User is authenticated'],
+        when: ['User creates a deal with valid data'],
+        then: ['Deal is created', 'DealCreated event is emitted'],
+      },
+    ],
+    examples: [
+      {
+        key: 'create-basic-deal',
+        input: {
+          title: 'Big Corp Q3 License',
+          stageId: 'stage-lead',
+          value: 50000,
+          companyId: 'comp-123',
+        },
+        output: {
+          id: 'deal-789',
+          title: 'Big Corp Q3 License',
+          status: 'open',
+        },
+      },
+    ],
+  },
+});
+
+/**
+ * Move deal to a different stage.
+ */
+export const MoveDealContract = defineCommand({
+  meta: {
+    key: 'crm.deal.move',
+    version: 1,
+    stability: 'stable',
+    owners: [...OWNERS],
+    tags: ['crm', 'deal', 'move', 'kanban'],
+    description: 'Move a deal to a different stage.',
+    goal: 'Allow drag-and-drop stage movement in Kanban.',
+    context: 'Pipeline Kanban view.',
+  },
+  io: {
+    input: MoveDealInputModel,
+    output: DealModel,
+  },
+  policy: {
+    auth: 'user',
+  },
+  sideEffects: {
+    emits: [
+      {
+        key: 'deal.moved',
+        version: 1,
+        when: 'Deal stage changed',
+        payload: DealMovedPayloadModel,
+      },
+    ],
+    audit: ['deal.moved'],
+  },
+  acceptance: {
+    scenarios: [
+      {
+        key: 'move-deal-happy-path',
+        given: ['Deal exists in stage A'],
+        when: ['User moves deal to stage B'],
+        then: ['Deal stage is updated', 'DealMoved event is emitted'],
+      },
+    ],
+    examples: [
+      {
+        key: 'move-to-negotiation',
+        input: { dealId: 'deal-789', targetStageId: 'stage-negotiation' },
+        output: {
+          id: 'deal-789',
+          stageId: 'stage-negotiation',
+          movedAt: '2025-01-15T10:00:00Z',
+        },
+      },
+    ],
+  },
+});
+
+/**
+ * Mark deal as won.
+ */
+export const WinDealContract = defineCommand({
+  meta: {
+    key: 'crm.deal.win',
+    version: 1,
+    stability: 'stable',
+    owners: [...OWNERS],
+    tags: ['crm', 'deal', 'won'],
+    description: 'Mark a deal as won.',
+    goal: 'Close a deal as successful.',
+    context: 'Deal closing flow.',
+  },
+  io: {
+    input: WinDealInputModel,
+    output: DealModel,
+  },
+  policy: {
+    auth: 'user',
+  },
+  sideEffects: {
+    emits: [
+      {
+        key: 'deal.won',
+        version: 1,
+        when: 'Deal is won',
+        payload: DealWonPayloadModel,
+      },
+    ],
+    audit: ['deal.won'],
+  },
+  acceptance: {
+    scenarios: [
+      {
+        key: 'win-deal-happy-path',
+        given: ['Deal is open'],
+        when: ['User marks deal as won'],
+        then: ['Deal status becomes WON', 'DealWon event is emitted'],
+      },
+    ],
+    examples: [
+      {
+        key: 'mark-won',
+        input: {
+          dealId: 'deal-789',
+          actualValue: 52000,
+          note: 'Signed contract attached',
+        },
+        output: {
+          id: 'deal-789',
+          status: 'won',
+          closedAt: '2025-01-20T14:30:00Z',
+        },
+      },
+    ],
+  },
+});
+
+/**
+ * Mark deal as lost.
+ */
+export const LoseDealContract = defineCommand({
+  meta: {
+    key: 'crm.deal.lose',
+    version: 1,
+    stability: 'stable',
+    owners: [...OWNERS],
+    tags: ['crm', 'deal', 'lost'],
+    description: 'Mark a deal as lost.',
+    goal: 'Close a deal as unsuccessful.',
+    context: 'Deal closing flow.',
+  },
+  io: {
+    input: LoseDealInputModel,
+    output: DealModel,
+  },
+  policy: {
+    auth: 'user',
+  },
+  sideEffects: {
+    emits: [
+      {
+        key: 'deal.lost',
+        version: 1,
+        when: 'Deal is lost',
+        payload: DealLostPayloadModel,
+      },
+    ],
+    audit: ['deal.lost'],
+  },
+  acceptance: {
+    scenarios: [
+      {
+        key: 'lose-deal-happy-path',
+        given: ['Deal is open'],
+        when: ['User marks deal as lost'],
+        then: ['Deal status becomes LOST', 'DealLost event is emitted'],
+      },
+    ],
+    examples: [
+      {
+        key: 'mark-lost',
+        input: {
+          dealId: 'deal-789',
+          reason: 'competitor',
+          note: 'Went with cheaper option',
+        },
+        output: {
+          id: 'deal-789',
+          status: 'lost',
+          closedAt: '2025-01-21T09:00:00Z',
+        },
+      },
+    ],
+  },
+});
+
+/**
+ * List deals in pipeline.
+ */
+export const ListDealsContract = defineQuery({
+  meta: {
+    key: 'crm.deal.list',
+    version: 1,
+    stability: 'stable',
+    owners: [...OWNERS],
+    tags: ['crm', 'deal', 'list'],
+    description: 'List deals with filters.',
+    goal: 'Show pipeline, deal lists, dashboards.',
+    context: 'Pipeline view, deal list.',
+  },
+  io: {
+    input: ListDealsInputModel,
+    output: ListDealsOutputModel,
+  },
+  policy: {
+    auth: 'user',
+  },
+  acceptance: {
+    scenarios: [
+      {
+        key: 'list-deals-happy-path',
+        given: ['User has access to deals'],
+        when: ['User lists deals'],
+        then: ['List of deals is returned'],
+      },
+    ],
+    examples: [
+      {
+        key: 'list-filter-stage',
+        input: { stageId: 'stage-lead', limit: 20 },
+        output: { items: [], total: 5, hasMore: false },
+      },
+    ],
+  },
+});