@vennyx/solicrm-mcp 0.1.0

package/dist/bin.js

@@ -0,0 +1,4097 @@
+#!/usr/bin/env node
+import { z } from "zod";
+import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+//#region packages/contracts/src/fields.ts
+/**
+* Alan kataloğu — `field_key` → kolon/tip/yetenek eşlemesi.
+*
+* NEDEN VAR: kaydedilmiş görünümler, filtreler, sıralama, CSV içe/dışa aktarma
+* ve MCP/SDK tip üretimi HEPSİ bu katalogdan okur. Hiçbir yerde kullanıcıdan
+* gelen bir değer doğrudan kolon adına dönüşmez — `resolveField()` bilinmeyen
+* anahtar için `undefined` döner ve çağıran 400 verir. Bu, SQL enjeksiyonu ve
+* bilgi sızdırmanın sınırıdır.
+*
+* İLERİYE DÖNÜK: özel alanlar (custom fields) eklendiğinde katalog runtime'da
+* tenant'ın tanımlarıyla genişletilir; tüketici kod değişmez (bkz. spec §6.7).
+*/
+const CRM_RESOURCES = [
+	"contacts",
+	"companies",
+	"deals",
+	"tasks"
+];
+const FIELD_CATALOG = {
+	contacts: {
+		first_name: {
+			column: "first_name",
+			type: "text",
+			filterable: true,
+			sortable: true
+		},
+		last_name: {
+			column: "last_name",
+			type: "text",
+			filterable: true,
+			sortable: true
+		},
+		email: {
+			column: "email",
+			type: "text",
+			filterable: true,
+			sortable: true
+		},
+		phone: {
+			column: "phone",
+			type: "text",
+			filterable: true,
+			sortable: false
+		},
+		job_title: {
+			column: "job_title",
+			type: "text",
+			filterable: true,
+			sortable: true
+		},
+		city: {
+			column: "city",
+			type: "text",
+			filterable: true,
+			sortable: true
+		},
+		country: {
+			column: "country",
+			type: "text",
+			filterable: true,
+			sortable: true
+		},
+		status: {
+			column: "status",
+			type: "enum",
+			filterable: true,
+			sortable: true,
+			values: [
+				"lead",
+				"active",
+				"inactive"
+			]
+		},
+		company_id: {
+			column: "company_id",
+			type: "uuid",
+			filterable: true,
+			sortable: false
+		},
+		owner_user_id: {
+			column: "owner_user_id",
+			type: "uuid",
+			filterable: true,
+			sortable: false
+		},
+		created_at: {
+			column: "created_at",
+			type: "date",
+			filterable: true,
+			sortable: true
+		}
+	},
+	companies: {
+		name: {
+			column: "name",
+			type: "text",
+			filterable: true,
+			sortable: true
+		},
+		domain: {
+			column: "domain",
+			type: "text",
+			filterable: true,
+			sortable: true
+		},
+		industry: {
+			column: "industry",
+			type: "text",
+			filterable: true,
+			sortable: true
+		},
+		city: {
+			column: "city",
+			type: "text",
+			filterable: true,
+			sortable: true
+		},
+		country: {
+			column: "country",
+			type: "text",
+			filterable: true,
+			sortable: true
+		},
+		annual_revenue: {
+			column: "annual_revenue",
+			type: "money",
+			filterable: true,
+			sortable: true
+		},
+		owner_user_id: {
+			column: "owner_user_id",
+			type: "uuid",
+			filterable: true,
+			sortable: false
+		},
+		created_at: {
+			column: "created_at",
+			type: "date",
+			filterable: true,
+			sortable: true
+		}
+	},
+	deals: {
+		title: {
+			column: "title",
+			type: "text",
+			filterable: true,
+			sortable: true
+		},
+		amount: {
+			column: "amount",
+			type: "money",
+			filterable: true,
+			sortable: true
+		},
+		currency_code: {
+			column: "currency_code",
+			type: "text",
+			filterable: true,
+			sortable: false
+		},
+		stage_id: {
+			column: "stage_id",
+			type: "uuid",
+			filterable: true,
+			sortable: false
+		},
+		pipeline_id: {
+			column: "pipeline_id",
+			type: "uuid",
+			filterable: true,
+			sortable: false
+		},
+		company_id: {
+			column: "company_id",
+			type: "uuid",
+			filterable: true,
+			sortable: false
+		},
+		outcome: {
+			column: "outcome",
+			type: "enum",
+			filterable: true,
+			sortable: true,
+			values: [
+				"open",
+				"won",
+				"lost"
+			]
+		},
+		expected_close_date: {
+			column: "expected_close_date",
+			type: "date",
+			filterable: true,
+			sortable: true
+		},
+		owner_user_id: {
+			column: "owner_user_id",
+			type: "uuid",
+			filterable: true,
+			sortable: false
+		},
+		created_at: {
+			column: "created_at",
+			type: "date",
+			filterable: true,
+			sortable: true
+		}
+	},
+	tasks: {
+		title: {
+			column: "title",
+			type: "text",
+			filterable: true,
+			sortable: true
+		},
+		due_at: {
+			column: "due_at",
+			type: "date",
+			filterable: true,
+			sortable: true
+		},
+		completed_at: {
+			column: "completed_at",
+			type: "date",
+			filterable: true,
+			sortable: true
+		},
+		priority: {
+			column: "priority",
+			type: "enum",
+			filterable: true,
+			sortable: true,
+			values: [
+				"low",
+				"normal",
+				"high",
+				"urgent"
+			]
+		},
+		assignee_user_id: {
+			column: "assignee_user_id",
+			type: "uuid",
+			filterable: true,
+			sortable: false
+		},
+		created_at: {
+			column: "created_at",
+			type: "date",
+			filterable: true,
+			sortable: true
+		}
+	}
+};
+/**
+* Bir `field_key`'i katalogdan çözer. Bilinmeyen anahtar → `undefined`
+* (çağıran 400 döner). ASLA anahtarı kolon adı olarak varsaymaz.
+*/
+function resolveField(resource, key) {
+	const catalog = FIELD_CATALOG[resource];
+	return Object.hasOwn(catalog, key) ? catalog[key] : void 0;
+}
+//#endregion
+//#region packages/contracts/src/crm.ts
+/**
+* CRM domain genelinde paylaşılan zod katalogları (spec §6.2/§6.3).
+*
+* NOT — Task 3 (deals) genişletmesi: `targetTypeSchema` artık `'deal'`
+* içeriyor (tek satırlık, geriye uyumlu genişleme; hiçbir tüketici tipi
+* DARALTILMADI, yalnız genişledi — bkz. `apps/api/src/lib/polymorphic-target.ts`,
+* `packages/db/drizzle/0028_deals_guard.sql`'daki `CREATE OR REPLACE FUNCTION`).
+*
+* NOT — spec'in tam liste vermediği katalog değerleri (bu dosyanın kararı):
+* `contactSourceSchema` ve `companySizeSchema` spec §6.2'de yalnız "text+katalog"
+* / kendine özgü alan olarak anılıyor, değer kümesi verilmiyor — makul bir
+* başlangıç kümesi seçildi (bkz. plan "Yeni ortak altyapı kararları / D").
+*/
+const targetTypeSchema = z.enum([
+	"contact",
+	"company",
+	"deal"
+], "geçerli bir hedef türü olmalı (contact, company, deal)");
+/** Fırsat sonucu (spec §6.2) — DB'de `deals_outcome_check` CHECK kısıtıyla eşleşir */
+const dealOutcomeSchema = z.enum([
+	"open",
+	"won",
+	"lost"
+], "geçerli bir sonuç olmalı (open, won, lost)");
+const contactStatusSchema = z.enum([
+	"lead",
+	"active",
+	"inactive"
+], "geçerli bir durum olmalı (lead, active, inactive)");
+/** Spec'te tam liste verilmemiş — makul bir başlangıç kümesi (bkz. dosya başı NOT) */
+const contactSourceSchema = z.enum([
+	"website",
+	"referral",
+	"cold_outreach",
+	"event",
+	"social_media",
+	"other"
+], "geçerli bir kaynak olmalı");
+/** Spec'te tam liste verilmemiş — makul bir başlangıç kümesi (bkz. dosya başı NOT) */
+const companySizeSchema = z.enum([
+	"1-10",
+	"11-50",
+	"51-200",
+	"201-500",
+	"500+"
+], "geçerli bir şirket büyüklüğü olmalı");
+const sortDirectionSchema = z.enum(["asc", "desc"], "yön asc veya desc olmalı");
+const filterOperandSchema = z.enum([
+	"eq",
+	"neq",
+	"contains",
+	"starts_with",
+	"gt",
+	"gte",
+	"lt",
+	"lte",
+	"in",
+	"is_null",
+	"is_not_null"
+], "geçerli bir karşılaştırma operatörü olmalı");
+/**
+* Aktivite türü (spec §6.2) — `stage_change` Faz 5 Task 3'ün `/move` ucunun
+* ürettiği otomatik aktiviteyle eşleşir (bkz. `apps/api/src/routes/deals.ts`).
+*/
+const activityKindSchema = z.enum([
+	"call",
+	"meeting",
+	"email",
+	"note",
+	"task",
+	"stage_change"
+], "geçerli bir aktivite türü olmalı (call, meeting, email, note, task, stage_change)");
+/** Spec'te tam liste verilmemiş — makul bir başlangıç kümesi (bkz. plan "Yeni ortak altyapı kararları / D") */
+const taskStatusSchema = z.enum([
+	"todo",
+	"in_progress",
+	"done",
+	"cancelled"
+], "geçerli bir durum olmalı (todo, in_progress, done, cancelled)");
+/** Spec'in verdiği tam liste (§6.2) */
+const taskPrioritySchema = z.enum([
+	"low",
+	"normal",
+	"high",
+	"urgent"
+], "geçerli bir öncelik olmalı (low, normal, high, urgent)");
+z.object({
+	targetType: targetTypeSchema,
+	targetId: z.uuid("geçerli bir hedef kimliği olmalı")
+});
+/**
+* Kaydedilmiş görünüm katalogları (spec §6.5, Faz 5 Task 5).
+* `savedViewResourceSchema` = `CRM_RESOURCES`'ın zod karşılığı — `fields.ts`
+* DEĞİŞTİRİLMEDEN (`CRM_RESOURCES` sabiti oradan İÇE AKTARILIR, yeniden
+* TANIMLANMAZ, tek gerçek kaynak korunur).
+*/
+const savedViewResourceSchema = z.enum(CRM_RESOURCES, "geçerli bir CRM kaynağı olmalı (contacts, companies, deals, tasks)");
+const savedViewLayoutSchema = z.enum(["table", "kanban"], "geçerli bir düzen olmalı (table, kanban)");
+const savedViewVisibilitySchema = z.enum(["private", "tenant"], "geçerli bir görünürlük olmalı (private, tenant)");
+const filterLogicalOperatorSchema = z.enum([
+	"and",
+	"or",
+	"not"
+], "geçerli bir mantıksal operatör olmalı (and, or, not)");
+/**
+* `numeric(18,2)` DB kolonuna eşlenen PARA alanları için ORTAK biçim
+* doğrulaması (spec §6.1 — para asla native `number`/aritmetikle hesaplanmaz,
+* yalnız string olarak taşınır, `bignumber.js` dışında ASLA işlenmez).
+*
+* [Fix round 2 — doğruluk reviewer'ının bulduğu, Task 3'ün `deals.amount`
+* fix'iyle BİREBİR aynı sınıf hata]: `companies.annual_revenue` DB'de `text`
+* kolondu ama `FIELD_CATALOG.companies.annual_revenue` `type:'money'`,
+* `sortable:true`, `filterable:true` ilan ediyordu — `text` kolonda `ORDER
+* BY`/`>`/`<` LEXICOGRAPHIC karşılaştırma yapar (`"100" < "20" < "9"`), bu
+* SESSİZ bir doğruluk hatasıdır. Bu şema, Task 3'ün önceden yalnız
+* `deals.ts` içinde TANIMLADIĞI `dealAmountSchema`'nın (aynı kısıtlar: en
+* fazla 2 ondalık basamak, en fazla 18 anlamlı basamak — `numeric(18,2)`
+* sınırı) buraya TAŞINMIŞ/PAYLAŞILAN hâlidir — İKİ ayrı DB kolonu (deals.amount,
+* companies.annual_revenue) TEK doğrulama mantığından geçer (drift riski
+* olmasın diye, DRY).
+*/
+const numericMoneySchema = z.string().trim().max(40, "en fazla 40 karakter olabilir").regex(/^-?\d+(\.\d{1,2})?$/, "geçerli bir ondalık tutar olmalı, en fazla 2 ondalık basamak (örn. 1234.56)").refine((v) => v.replace(/[-.]/g, "").length <= 18, "en fazla 18 anlamlı basamak olabilir (numeric(18,2) sınırı)");
+const pageQuerySchema = z.object({
+	cursor: z.string().max(2e3, "geçersiz sayfalama imleci").optional(),
+	limit: z.coerce.number("sayı olmalı").int("tam sayı olmalı").min(1, "en az 1 olmalı").max(100, `en fazla 100 olabilir`).optional()
+});
+function pagedResponseSchema(itemSchema) {
+	return z.object({
+		items: z.array(itemSchema),
+		nextCursor: z.string().nullable(),
+		hasMore: z.boolean()
+	});
+}
+//#endregion
+//#region packages/contracts/src/notes.ts
+/**
+* Not (note) sözleşmeleri (spec §6.2/§6.3) — `tasks.ts`'in BİREBİR aynı kalıbı,
+* `assigneeUserId` yerine `authorUserId`, `status`/`priority` YOK.
+*/
+const noteBodySchema = z.record(z.string(), z.unknown());
+const createNoteRequestSchema = z.object({
+	title: z.string().trim().max(200, "en fazla 200 karakter olabilir").optional(),
+	body: noteBodySchema.optional(),
+	bodyFormat: z.string().trim().max(40, "en fazla 40 karakter olabilir").optional(),
+	authorUserId: z.uuid("geçerli bir kullanıcı kimliği olmalı").optional()
+});
+z.object({
+	title: z.string().trim().max(200, "en fazla 200 karakter olabilir").nullable().optional(),
+	body: noteBodySchema.optional(),
+	bodyFormat: z.string().trim().max(40, "en fazla 40 karakter olabilir").optional(),
+	authorUserId: z.uuid("geçerli bir kullanıcı kimliği olmalı").nullable().optional()
+});
+const noteLinkResponseSchema = z.object({
+	id: z.uuid(),
+	targetType: targetTypeSchema,
+	targetId: z.uuid(),
+	targetCachedName: z.string(),
+	createdAt: z.iso.datetime()
+});
+const noteResponseSchema = z.object({
+	id: z.uuid(),
+	title: z.string().nullable(),
+	body: noteBodySchema.nullable(),
+	bodyFormat: z.string().nullable(),
+	authorUserId: z.uuid().nullable(),
+	createdAt: z.iso.datetime(),
+	updatedAt: z.iso.datetime()
+});
+noteResponseSchema.extend({ links: z.array(noteLinkResponseSchema) });
+pagedResponseSchema(noteResponseSchema);
+//#endregion
+//#region packages/contracts/src/tasks.ts
+/**
+* Görev (task) sözleşmeleri (spec §6.2/§6.3).
+*
+* KRİTİK KURAL: `dueAt`/`completedAt` kullanıcının Date/Time Handling
+* Guideline'ına uygun olarak `apps/api/src/routes/tasks.ts`'te luxon
+* (`DateTime`) ile dönüştürülür — burada yalnız ISO 8601 biçim doğrulaması
+* yapılır (zod), gerçek dönüşüm route katmanının işidir.
+*
+* `assigneeUserId` PATCH'te `null` gönderilerek atamanın KALDIRILMASI
+* desteklenir (`nullable().optional()`) — `undefined` "değiştirme", `null`
+* "kaldır" anlamına gelir (companies/contacts/deals'ın PARTIAL şemalarından
+* FARKLI bir kalıp, çünkü onlarda "atamayı kaldır" ihtiyacı yoktu).
+*/
+const taskBodySchema = z.record(z.string(), z.unknown());
+const createTaskRequestSchema = z.object({
+	title: z.string().trim().min(1, "başlık gerekli").max(200, "en fazla 200 karakter olabilir"),
+	body: taskBodySchema.optional(),
+	bodyFormat: z.string().trim().max(40, "en fazla 40 karakter olabilir").optional(),
+	dueAt: z.iso.datetime("geçerli bir tarih olmalı").optional(),
+	status: taskStatusSchema.default("todo"),
+	priority: taskPrioritySchema.default("normal"),
+	assigneeUserId: z.uuid("geçerli bir kullanıcı kimliği olmalı").optional()
+});
+z.object({
+	title: z.string().trim().min(1, "başlık gerekli").max(200, "en fazla 200 karakter olabilir").optional(),
+	body: taskBodySchema.optional(),
+	bodyFormat: z.string().trim().max(40, "en fazla 40 karakter olabilir").optional(),
+	dueAt: z.iso.datetime("geçerli bir tarih olmalı").nullable().optional(),
+	status: taskStatusSchema.optional(),
+	priority: taskPrioritySchema.optional(),
+	assigneeUserId: z.uuid("geçerli bir kullanıcı kimliği olmalı").nullable().optional()
+});
+const taskLinkResponseSchema = z.object({
+	id: z.uuid(),
+	targetType: targetTypeSchema,
+	targetId: z.uuid(),
+	targetCachedName: z.string(),
+	createdAt: z.iso.datetime()
+});
+const taskResponseSchema = z.object({
+	id: z.uuid(),
+	title: z.string(),
+	body: taskBodySchema.nullable(),
+	bodyFormat: z.string().nullable(),
+	dueAt: z.iso.datetime().nullable(),
+	completedAt: z.iso.datetime().nullable(),
+	status: taskStatusSchema,
+	priority: taskPrioritySchema,
+	assigneeUserId: z.uuid().nullable(),
+	createdAt: z.iso.datetime(),
+	updatedAt: z.iso.datetime()
+});
+taskResponseSchema.extend({ links: z.array(taskLinkResponseSchema) });
+pagedResponseSchema(taskResponseSchema);
+//#endregion
+//#region packages/contracts/src/activities.ts
+/**
+* Aktivite (activity) sözleşmeleri (spec §6.2/§6.3).
+*
+* KRİTİK KURAL: `updateActivityRequestSchema` `.strict()`'tir ve `kind`/
+* `targetType`/`targetId`'yi hiç TANIMLAMAZ — bir aktivitenin hedefi/türü
+* OLUŞTURULDUKTAN SONRA değiştirilemez (bkz. `packages/db/src/schema/activities.ts`
+* dosya başı yorumu, `apps/api/src/routes/activities.ts`). `deals.ts`'teki
+* `updateDealRequestSchema`'nın AYNI kalıbı (bkz. o dosyanın dosya başı yorumu).
+*
+* TEKNİK BORÇ KAPANIŞI (Faz 6 Task 7): `GET /v1/tenants/:id/targets/
+* :targetType/:targetId/timeline` ucu Faz 5 Task 4'ün plan dışı eklediği bir
+* uçtu ve YANIT ZARFI için bir sözleşme şeması export ETMEMİŞTİ — SPA
+* (`apps/dashboard/src/lib/timeline-one-shot.ts`) bu yüzden kendi elle yazılmış
+* bir tipe (`.array()` bileşimi) doğrulama yapıyordu. `targetTimelineResponseSchema`
+* artık TEK gerçek kaynak; iki taraf da (`apps/api/src/routes/activities.ts`
+* VE SPA) buradan okur. `TIMELINE_LIMIT_PER_RESOURCE` de AYNI nedenle burada:
+* backend'in `activities.ts`'teki elle kopyalanmış `= 50` sabiti ile SPA'nın
+* `timeline-panel.tsx`'teki `TIMELINE_ONE_SHOT_CAP = 50` sabiti birbirinden
+* BAĞIMSIZ, elle senkron tutuluyordu (drift riski, bkz. Faz 6 Task 6 raporu
+* "Endişeler").
+*/
+const activityPropertiesSchema = z.record(z.string(), z.unknown());
+const createActivityRequestSchema = z.object({
+	kind: activityKindSchema,
+	subject: z.string().trim().max(200, "en fazla 200 karakter olabilir").optional(),
+	body: z.string().trim().max(1e4, "en fazla 10000 karakter olabilir").optional(),
+	happensAt: z.iso.datetime("geçerli bir tarih olmalı"),
+	durationMinutes: z.number("sayı olmalı").int("tam sayı olmalı").min(0, "negatif olamaz").max(43200, "en fazla 43200 dakika (30 gün) olabilir").optional(),
+	targetType: targetTypeSchema,
+	targetId: z.uuid("geçerli bir hedef kimliği olmalı"),
+	actorUserId: z.uuid("geçerli bir kullanıcı kimliği olmalı").optional(),
+	properties: activityPropertiesSchema.optional()
+});
+z.object({
+	subject: z.string().trim().max(200, "en fazla 200 karakter olabilir").optional(),
+	body: z.string().trim().max(1e4, "en fazla 10000 karakter olabilir").optional(),
+	happensAt: z.iso.datetime("geçerli bir tarih olmalı").optional(),
+	durationMinutes: z.number("sayı olmalı").int("tam sayı olmalı").min(0, "negatif olamaz").max(43200, "en fazla 43200 dakika (30 gün) olabilir").optional(),
+	actorUserId: z.uuid("geçerli bir kullanıcı kimliği olmalı").optional(),
+	properties: activityPropertiesSchema.optional()
+}).strict();
+const activityResponseSchema = z.object({
+	id: z.uuid(),
+	kind: activityKindSchema,
+	subject: z.string().nullable(),
+	body: z.string().nullable(),
+	happensAt: z.iso.datetime(),
+	durationMinutes: z.number().nullable(),
+	targetType: targetTypeSchema,
+	targetId: z.uuid(),
+	targetCachedName: z.string(),
+	properties: activityPropertiesSchema,
+	actorUserId: z.uuid().nullable(),
+	createdAt: z.iso.datetime(),
+	updatedAt: z.iso.datetime()
+});
+pagedResponseSchema(activityResponseSchema);
+z.object({
+	activities: activityResponseSchema.array(),
+	tasks: taskResponseSchema.array(),
+	notes: noteResponseSchema.array()
+});
+clone();
+var isNumeric = /^-?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/i;
+var mathceil = Math.ceil;
+var mathfloor = Math.floor;
+var bignumberError = "[BigNumber Error] ";
+var BASE = 0x5af3107a4000;
+var LOG_BASE = 14;
+var MAX_SAFE_INTEGER = 9007199254740991;
+var POWS_TEN = [
+	1,
+	10,
+	100,
+	1e3,
+	1e4,
+	1e5,
+	1e6,
+	1e7,
+	1e8,
+	1e9,
+	1e10,
+	1e11,
+	0xe8d4a51000,
+	0x9184e72a000
+];
+var SQRT_BASE = 1e7;
+var MAX = 1e9;
+function clone(configObject) {
+	var div, convertBase, basePrefix = /^(-?)0([xbo])(?=[^.])/i, isInfinityOrNaN = /^-?(Infinity|NaN)$/, whitespaceOrPlus = /^\s*\+(?!-)|^\s+|\s+$/g, P = BigNumber.prototype = {
+		constructor: BigNumber,
+		toString: null,
+		valueOf: null
+	}, ONE = new BigNumber(1), DECIMAL_PLACES = 20, ROUNDING_MODE = 4, TO_EXP_NEG = -7, TO_EXP_POS = 21, MIN_EXP = -1e7, MAX_EXP = 1e7, CRYPTO = false, STRICT = true, MODULO_MODE = 1, POW_PRECISION = 0, FORMAT = {
+		prefix: "",
+		negativeSign: "-",
+		positiveSign: "",
+		groupSeparator: ",",
+		groupSize: 3,
+		secondaryGroupSize: 0,
+		decimalSeparator: ".",
+		fractionGroupSeparator: "",
+		fractionGroupSize: 0,
+		suffix: ""
+	}, ALPHABET = "0123456789abcdefghijklmnopqrstuvwxyz";
+	function BigNumber(v, b) {
+		var e, i, str, t, x = this;
+		if (!(x instanceof BigNumber)) return new BigNumber(v, b);
+		t = typeof v;
+		if (b == null) {
+			if (isBigNumber(v)) {
+				x.s = v.s;
+				if (!v.c || v.e > MAX_EXP) x.c = x.e = null;
+				else if (v.e < MIN_EXP) x.c = [x.e = 0];
+				else {
+					x.e = v.e;
+					x.c = v.c.slice();
+				}
+				return;
+			}
+			if (t == "number") {
+				if (v * 0 != 0) {
+					x.s = isNaN(v) ? null : v < 0 ? -1 : 1;
+					x.c = x.e = null;
+					return;
+				}
+				x.s = 1 / v < 0 ? (v = -v, -1) : 1;
+				if (v === ~~v) {
+					for (e = 0, i = v; i >= 10; i /= 10, e++);
+					if (e > MAX_EXP) x.c = x.e = null;
+					else {
+						x.e = e;
+						x.c = [v];
+					}
+					return;
+				}
+				return parseValidString(x, String(v));
+			}
+			if (t == "bigint") {
+				x.s = v < 0 ? (v = -v, -1) : 1;
+				return parseValidString(x, String(v));
+			}
+			if (t == "string") str = v;
+			else {
+				if (STRICT) throw Error(bignumberError + "BigNumber, string, number, or BigInt expected: " + v);
+				str = String(v);
+			}
+			if (isNumeric.test(str)) {
+				x.s = str.charCodeAt(0) == 45 ? (str = str.slice(1), -1) : 1;
+				return parseValidString(x, str);
+			}
+			str = str.replace(whitespaceOrPlus, "");
+			if (isInfinityOrNaN.test(str)) {
+				x.s = isNaN(str) ? null : str < 0 ? -1 : 1;
+				x.c = x.e = null;
+				return;
+			}
+			str = str.replace(basePrefix, function(m, p1, p2) {
+				b = (p2 = p2.toLowerCase()) == "x" ? 16 : p2 == "b" ? 2 : 8;
+				return p1;
+			});
+			if (b) return parseBaseString(x, str, b, v);
+			str = str.replace(/(\d)_(?=\d)/g, "$1");
+			if (isNumeric.test(str)) {
+				x.s = str.charCodeAt(0) == 45 ? (str = str.slice(1), -1) : 1;
+				return parseValidString(x, str);
+			}
+			if (STRICT) throw Error(bignumberError + "Not a number: " + v);
+			x.s = x.c = x.e = null;
+		} else {
+			if (t != "string") {
+				if (STRICT) throw Error(bignumberError + "String expected: " + v);
+				v = String(v);
+			}
+			intCheck(b, 2, ALPHABET.length, "Base");
+			parseBaseString(x, v.replace(whitespaceOrPlus, ""), b, v);
+		}
+	}
+	BigNumber.clone = clone;
+	BigNumber.ROUND_UP = 0;
+	BigNumber.ROUND_DOWN = 1;
+	BigNumber.ROUND_CEIL = 2;
+	BigNumber.ROUND_FLOOR = 3;
+	BigNumber.ROUND_HALF_UP = 4;
+	BigNumber.ROUND_HALF_DOWN = 5;
+	BigNumber.ROUND_HALF_EVEN = 6;
+	BigNumber.ROUND_HALF_CEIL = 7;
+	BigNumber.ROUND_HALF_FLOOR = 8;
+	BigNumber.EUCLID = 9;
+	BigNumber.config = BigNumber.set = function(obj) {
+		var p, v;
+		if (obj != null) if (typeof obj == "object") {
+			if (obj.hasOwnProperty(p = "DECIMAL_PLACES")) DECIMAL_PLACES = intCheck(obj[p], 0, MAX, p);
+			if (obj.hasOwnProperty(p = "ROUNDING_MODE")) ROUNDING_MODE = intCheck(obj[p], 0, 8, p);
+			if (obj.hasOwnProperty(p = "EXPONENTIAL_AT")) {
+				v = obj[p];
+				if (isArray(v)) {
+					intCheck(v[0], -MAX, 0, p);
+					intCheck(v[1], 0, MAX, p);
+					TO_EXP_NEG = v[0];
+					TO_EXP_POS = v[1];
+				} else TO_EXP_NEG = -(TO_EXP_POS = intCheck(v, -MAX, MAX, p) < 0 ? -v : v);
+			}
+			if (obj.hasOwnProperty(p = "RANGE")) {
+				v = obj[p];
+				if (v) if (isArray(v)) {
+					intCheck(v[0], -MAX, -1, p);
+					intCheck(v[1], 1, MAX, p);
+					MIN_EXP = v[0];
+					MAX_EXP = v[1];
+				} else MIN_EXP = -(MAX_EXP = intCheck(v, -MAX, MAX, p) < 0 ? -v : v);
+				else throw Error(bignumberError + p + " cannot be zero: " + v);
+			}
+			if (obj.hasOwnProperty(p = "CRYPTO")) {
+				v = obj[p];
+				if (v === !!v) if (v) if (typeof crypto != "undefined" && crypto && (crypto.getRandomValues || crypto.randomBytes)) CRYPTO = v;
+				else {
+					CRYPTO = !v;
+					throw Error(bignumberError + "crypto unavailable");
+				}
+				else CRYPTO = v;
+				else throw Error(bignumberError + p + " not true or false: " + v);
+			}
+			if (obj.hasOwnProperty(p = "STRICT")) {
+				v = obj[p];
+				if (v === !!v) STRICT = v;
+				else throw Error(bignumberError + p + " not true or false: " + v);
+			}
+			if (obj.hasOwnProperty(p = "MODULO_MODE")) MODULO_MODE = intCheck(obj[p], 0, 9, p);
+			if (obj.hasOwnProperty(p = "POW_PRECISION")) POW_PRECISION = intCheck(obj[p], 0, MAX, p);
+			if (obj.hasOwnProperty(p = "FORMAT")) {
+				v = obj[p];
+				if (typeof v == "object") {
+					for (p in v) if (v.hasOwnProperty(p) && FORMAT.hasOwnProperty(p)) FORMAT[p] = v[p];
+				} else throw Error(bignumberError + p + " not an object: " + v);
+			}
+			if (obj.hasOwnProperty(p = "ALPHABET")) {
+				v = obj[p];
+				if (typeof v == "string" && !/^.?$|[+\-.\s]|(.).*\1/.test(v)) ALPHABET = v;
+				else throw Error(bignumberError + p + " invalid: " + v);
+			}
+		} else throw Error(bignumberError + "Object expected: " + obj);
+		return {
+			DECIMAL_PLACES,
+			ROUNDING_MODE,
+			EXPONENTIAL_AT: [TO_EXP_NEG, TO_EXP_POS],
+			RANGE: [MIN_EXP, MAX_EXP],
+			CRYPTO,
+			STRICT,
+			MODULO_MODE,
+			POW_PRECISION,
+			FORMAT,
+			ALPHABET
+		};
+	};
+	BigNumber.fromFormat = function(str, options) {
+		if (typeof str !== "string") throw Error(bignumberError + "Not a string: " + str);
+		if (options == null) options = FORMAT;
+		else if (typeof options != "object") throw Error(bignumberError + "Argument not an object: " + options);
+		else options = resolveFormatOptions(options);
+		var i, isNeg, integerPart, fractionPart, negativeSign = options.negativeSign || "-", positiveSign = options.positiveSign || "", prefix = options.prefix || "", suffix = options.suffix || "", groupSeparator = options.groupSeparator || "", decimalSeparator = options.decimalSeparator || ".", fractionGroupSeparator = options.fractionGroupSeparator || "";
+		if (prefix && str.indexOf(prefix) === 0) str = str.slice(prefix.length);
+		if (suffix && str.lastIndexOf(suffix) === str.length - suffix.length) str = str.slice(0, -suffix.length);
+		if (negativeSign && str.indexOf(negativeSign) === 0) {
+			str = str.slice(negativeSign.length);
+			isNeg = true;
+		} else if (positiveSign && str.indexOf(positiveSign) === 0) str = str.slice(positiveSign.length);
+		i = str.indexOf(decimalSeparator);
+		if (i < 0) {
+			if (groupSeparator) while (str.indexOf(groupSeparator) > -1) str = str.replace(groupSeparator, "");
+		} else {
+			integerPart = str.slice(0, i);
+			fractionPart = str.slice(i + decimalSeparator.length);
+			if (groupSeparator) while (integerPart.indexOf(groupSeparator) > -1) integerPart = integerPart.replace(groupSeparator, "");
+			if (fractionGroupSeparator) while (fractionPart.indexOf(fractionGroupSeparator) > -1) fractionPart = fractionPart.replace(fractionGroupSeparator, "");
+			str = integerPart + "." + fractionPart;
+		}
+		return new BigNumber(isNeg ? "-" + str : str);
+	};
+	BigNumber.isBigNumber = function(v) {
+		if (!isBigNumber(v)) return false;
+		var i, n, c = v.c, e = v.e, s = v.s;
+		if (!isArray(c)) return c === null && e === null && (s === null || s === 1 || s === -1);
+		if (s !== 1 && s !== -1 || e < -MAX || e > MAX || e !== mathfloor(e)) return false;
+		if (c[0] === 0) return e === 0 && c.length === 1;
+		i = (e + 1) % LOG_BASE;
+		if (i < 1) i += LOG_BASE;
+		if (String(c[0]).length !== i) return false;
+		for (i = 0; i < c.length; i++) {
+			n = c[i];
+			if (n < 0 || n >= BASE || n !== mathfloor(n)) return false;
+		}
+		return n !== 0;
+	};
+	BigNumber.maximum = BigNumber.max = function() {
+		return maxOrMin(arguments, -1);
+	};
+	BigNumber.minimum = BigNumber.min = function() {
+		return maxOrMin(arguments, 1);
+	};
+	BigNumber.random = (function() {
+		var pow2_53 = 9007199254740992;
+		var random53bitInt = Math.random() * pow2_53 & 2097151 ? function() {
+			return mathfloor(Math.random() * pow2_53);
+		} : function() {
+			return (Math.random() * 1073741824 | 0) * 8388608 + (Math.random() * 8388608 | 0);
+		};
+		return function(dp) {
+			var a, b, e, k, v, i = 0, c = [], rand = new BigNumber(ONE);
+			dp = dp == null ? DECIMAL_PLACES : intCheck(dp, 0, MAX);
+			k = mathceil(dp / LOG_BASE);
+			if (CRYPTO) if (crypto.getRandomValues) {
+				a = crypto.getRandomValues(new Uint32Array(k *= 2));
+				for (; i < k;) {
+					v = a[i] * 131072 + (a[i + 1] >>> 11);
+					if (v >= 9e15) {
+						b = crypto.getRandomValues(/* @__PURE__ */ new Uint32Array(2));
+						a[i] = b[0];
+						a[i + 1] = b[1];
+					} else {
+						c.push(v % 0x5af3107a4000);
+						i += 2;
+					}
+				}
+				i = k / 2;
+			} else if (crypto.randomBytes) {
+				a = crypto.randomBytes(k *= 7);
+				for (; i < k;) {
+					v = (a[i] & 31) * 281474976710656 + a[i + 1] * 1099511627776 + a[i + 2] * 4294967296 + a[i + 3] * 16777216 + (a[i + 4] << 16) + (a[i + 5] << 8) + a[i + 6];
+					if (v >= 9e15) crypto.randomBytes(7).copy(a, i);
+					else {
+						c.push(v % 0x5af3107a4000);
+						i += 7;
+					}
+				}
+				i = k / 7;
+			} else {
+				CRYPTO = false;
+				throw Error(bignumberError + "crypto unavailable");
+			}
+			if (!CRYPTO) for (; i < k;) {
+				v = random53bitInt();
+				if (v < 9e15) c[i++] = v % 0x5af3107a4000;
+			}
+			k = c[--i];
+			dp %= LOG_BASE;
+			if (k && dp) {
+				v = POWS_TEN[LOG_BASE - dp];
+				c[i] = mathfloor(k / v) * v;
+			}
+			for (; c[i] === 0; c.pop(), i--);
+			if (i < 0) c = [e = 0];
+			else {
+				for (e = -1; c[0] === 0; c.splice(0, 1), e -= LOG_BASE);
+				for (i = 1, v = c[0]; v >= 10; v /= 10, i++);
+				if (i < LOG_BASE) e -= LOG_BASE - i;
+			}
+			rand.e = e;
+			rand.c = c;
+			return rand;
+		};
+	})();
+	BigNumber.sum = function() {
+		var i = 0, sum = new BigNumber(0);
+		for (; i < arguments.length;) sum = sum.plus(arguments[i++]);
+		return sum;
+	};
+	function parseValidString(x, str) {
+		var e, i, len;
+		if ((e = str.indexOf(".")) > -1) str = str.replace(".", "");
+		if ((i = str.search(/e/i)) > 0) {
+			if (e < 0) e = i;
+			e += +str.slice(i + 1);
+			str = str.substring(0, i);
+		} else if (e < 0) e = str.length;
+		for (i = 0; str.charCodeAt(i) === 48; i++);
+		for (len = str.length; str.charCodeAt(--len) === 48;);
+		if (str = str.slice(i, ++len)) {
+			len -= i;
+			e = e - i - 1;
+			if (e > MAX_EXP) x.c = x.e = null;
+			else if (e < MIN_EXP) x.c = [x.e = 0];
+			else {
+				x.e = e;
+				x.c = [];
+				i = (e + 1) % LOG_BASE;
+				if (e < 0) i += LOG_BASE;
+				if (i < len) {
+					if (i) x.c.push(+str.slice(0, i));
+					for (len -= LOG_BASE; i < len;) x.c.push(+str.slice(i, i += LOG_BASE));
+					i = LOG_BASE - (str = str.slice(i)).length;
+				} else i -= len;
+				for (; i--; str += "0");
+				x.c.push(+str);
+			}
+		} else x.c = [x.e = 0];
+	}
+	function parseBaseString(x, str, b, v) {
+		var c, len, alphabet = ALPHABET.slice(0, b), i = 0, clean = "", hasDot = false, prevIsNumeral = false, caseChanged = false;
+		x.s = str.charCodeAt(0) === 45 ? (str = str.slice(1), -1) : 1;
+		for (len = str.length; i < len; i++) {
+			c = str.charAt(i);
+			if (alphabet.indexOf(c) >= 0) {
+				clean += c;
+				prevIsNumeral = true;
+				continue;
+			}
+			if (c == "_") {
+				if (prevIsNumeral && i + 1 < len) {
+					prevIsNumeral = false;
+					continue;
+				}
+			} else if (c == ".") {
+				if (i == 0 || !hasDot && prevIsNumeral) {
+					if (i + 1 == len) break;
+					if (i == 0) clean = "0";
+					clean += c;
+					hasDot = true;
+					prevIsNumeral = false;
+					continue;
+				}
+			} else if (!caseChanged) {
+				if (str == str.toUpperCase() && alphabet == alphabet.toLowerCase() && (str = str.toLowerCase()) || str == str.toLowerCase() && alphabet == alphabet.toUpperCase() && (str = str.toUpperCase())) {
+					i = -1;
+					clean = "";
+					caseChanged = true;
+					hasDot = prevIsNumeral = false;
+					continue;
+				}
+			}
+			if (STRICT) throw Error(bignumberError + "Not a base " + b + " number: " + v);
+			x.s = x.c = x.e = null;
+			return;
+		}
+		parseValidString(x, convertBase(clean, b, 10, x.s));
+	}
+	convertBase = (function() {
+		var decimal = "0123456789";
+		function toBaseOut(str, baseIn, baseOut, alphabet) {
+			var j, arr = [0], arrL, i = 0, len = str.length;
+			for (; i < len;) {
+				for (arrL = arr.length; arrL--; arr[arrL] *= baseIn);
+				arr[0] += alphabet.indexOf(str.charAt(i++));
+				for (j = 0; j < arr.length; j++) if (arr[j] > baseOut - 1) {
+					if (arr[j + 1] == null) arr[j + 1] = 0;
+					arr[j + 1] += arr[j] / baseOut | 0;
+					arr[j] %= baseOut;
+				}
+			}
+			return arr.reverse();
+		}
+		return function(str, baseIn, baseOut, sign, callerIsToString) {
+			var alphabet, d, e, k, r, x, xc, y, i = str.indexOf("."), dp = DECIMAL_PLACES, rm = ROUNDING_MODE;
+			if (i >= 0) {
+				k = POW_PRECISION;
+				POW_PRECISION = 0;
+				str = str.replace(".", "");
+				y = new BigNumber(baseIn);
+				x = y.pow(str.length - i);
+				POW_PRECISION = k;
+				y.c = toBaseOut(toFixedPoint(coeffToString(x.c), x.e, "0"), 10, baseOut, decimal);
+				y.e = y.c.length;
+			}
+			xc = toBaseOut(str, baseIn, baseOut, callerIsToString ? (alphabet = ALPHABET, decimal) : (alphabet = decimal, ALPHABET));
+			e = k = xc.length;
+			for (; xc[--k] == 0; xc.pop());
+			if (!xc[0]) return alphabet.charAt(0);
+			if (i < 0) --e;
+			else {
+				x.c = xc;
+				x.e = e;
+				x.s = sign;
+				x = div(x, y, dp, rm, baseOut);
+				xc = x.c;
+				r = x.r;
+				e = x.e;
+			}
+			d = e + dp + 1;
+			i = xc[d];
+			k = baseOut / 2;
+			r = r || d < 0 || xc[d + 1] != null;
+			r = rm < 4 ? (i != null || r) && (rm == 0 || rm == (x.s < 0 ? 3 : 2)) : i > k || i == k && (rm == 4 || r || rm == 6 && xc[d - 1] & 1 || rm == (x.s < 0 ? 8 : 7));
+			if (d < 1 || !xc[0]) str = r ? toFixedPoint(alphabet.charAt(1), -dp, alphabet.charAt(0)) : alphabet.charAt(0);
+			else {
+				if (d < xc.length) xc.length = d;
+				if (r) for (--baseOut; ++xc[--d] > baseOut;) {
+					xc[d] = 0;
+					if (!d) {
+						++e;
+						xc = [1].concat(xc);
+					}
+				}
+				for (k = xc.length; !xc[--k];);
+				for (i = 0, str = ""; i <= k; str += alphabet.charAt(xc[i++]));
+				str = toFixedPoint(str, e, alphabet.charAt(0));
+			}
+			return str;
+		};
+	})();
+	div = (function() {
+		function multiply(x, k, base) {
+			var m, temp, xlo, xhi, carry = 0, i = x.length, klo = k % SQRT_BASE, khi = k / SQRT_BASE | 0;
+			for (x = x.slice(); i--;) {
+				xlo = x[i] % SQRT_BASE;
+				xhi = x[i] / SQRT_BASE | 0;
+				m = khi * xlo + xhi * klo;
+				temp = klo * xlo + m % SQRT_BASE * SQRT_BASE + carry;
+				carry = (temp / base | 0) + (m / SQRT_BASE | 0) + khi * xhi;
+				x[i] = temp % base;
+			}
+			if (carry) x = [carry].concat(x);
+			return x;
+		}
+		function compare(a, b, aL, bL) {
+			var i, cmp;
+			if (aL != bL) cmp = aL > bL ? 1 : -1;
+			else for (i = cmp = 0; i < aL; i++) if (a[i] != b[i]) {
+				cmp = a[i] > b[i] ? 1 : -1;
+				break;
+			}
+			return cmp;
+		}
+		function subtract(a, b, aL, base) {
+			var i = 0;
+			for (; aL--;) {
+				a[aL] -= i;
+				i = a[aL] < b[aL] ? 1 : 0;
+				a[aL] = i * base + a[aL] - b[aL];
+			}
+			for (; !a[0] && a.length > 1; a.splice(0, 1));
+		}
+		return function(x, y, dp, rm, base) {
+			var cmp, e, i, more, n, prod, prodL, q, qc, rem, remL, rem0, xi, xL, yc0, yL, yz, s = x.s == y.s ? 1 : -1, xc = x.c, yc = y.c;
+			if (!xc || !xc[0] || !yc || !yc[0]) return new BigNumber(!x.s || !y.s || (xc ? yc && xc[0] == yc[0] : !yc) ? NaN : xc && xc[0] == 0 || !yc ? s * 0 : s / 0);
+			q = new BigNumber(s);
+			qc = q.c = [];
+			e = x.e - y.e;
+			s = dp + e + 1;
+			if (!base) {
+				base = BASE;
+				e = bitFloor(x.e / LOG_BASE) - bitFloor(y.e / LOG_BASE);
+				s = s / LOG_BASE | 0;
+			}
+			for (i = 0; yc[i] == (xc[i] || 0); i++);
+			if (yc[i] > (xc[i] || 0)) e--;
+			if (s < 0) {
+				qc.push(1);
+				more = true;
+			} else {
+				xL = xc.length;
+				yL = yc.length;
+				i = 0;
+				s += 2;
+				n = mathfloor(base / (yc[0] + 1));
+				if (n > 1) {
+					yc = multiply(yc, n, base);
+					xc = multiply(xc, n, base);
+					yL = yc.length;
+					xL = xc.length;
+				}
+				xi = yL;
+				rem = xc.slice(0, yL);
+				remL = rem.length;
+				for (; remL < yL; rem[remL++] = 0);
+				yz = yc.slice();
+				yz = [0].concat(yz);
+				yc0 = yc[0];
+				if (yc[1] >= base / 2) yc0++;
+				do {
+					n = 0;
+					cmp = compare(yc, rem, yL, remL);
+					if (cmp < 0) {
+						rem0 = rem[0];
+						if (yL != remL) rem0 = rem0 * base + (rem[1] || 0);
+						n = mathfloor(rem0 / yc0);
+						if (n > 1) {
+							if (n >= base) n = base - 1;
+							prod = multiply(yc, n, base);
+							prodL = prod.length;
+							remL = rem.length;
+							while (compare(prod, rem, prodL, remL) == 1) {
+								n--;
+								subtract(prod, yL < prodL ? yz : yc, prodL, base);
+								prodL = prod.length;
+								cmp = 1;
+							}
+						} else {
+							if (n == 0) cmp = n = 1;
+							prod = yc.slice();
+							prodL = prod.length;
+						}
+						if (prodL < remL) prod = [0].concat(prod);
+						subtract(rem, prod, remL, base);
+						remL = rem.length;
+						if (cmp == -1) while (compare(yc, rem, yL, remL) < 1) {
+							n++;
+							subtract(rem, yL < remL ? yz : yc, remL, base);
+							remL = rem.length;
+						}
+					} else if (cmp === 0) {
+						n++;
+						rem = [0];
+					}
+					qc[i++] = n;
+					if (rem[0]) rem[remL++] = xc[xi] || 0;
+					else {
+						rem = [xc[xi]];
+						remL = 1;
+					}
+				} while ((xi++ < xL || rem[0] != null) && s--);
+				more = rem[0] != null;
+				if (!qc[0]) qc.splice(0, 1);
+			}
+			if (base == BASE) {
+				for (i = 1, s = qc[0]; s >= 10; s /= 10, i++);
+				round(q, dp + (q.e = i + e * LOG_BASE - 1) + 1, rm, more);
+			} else {
+				q.e = e;
+				q.r = +more;
+			}
+			return q;
+		};
+	})();
+	function format(n, i, rm, id) {
+		var c0, e, ne, len, str;
+		rm = rm == null ? ROUNDING_MODE : intCheck(rm, 0, 8);
+		if (!n.c) return n.toString();
+		c0 = n.c[0];
+		ne = n.e;
+		if (i == null) {
+			str = coeffToString(n.c);
+			str = id == 1 || id == 2 && (ne <= TO_EXP_NEG || ne >= TO_EXP_POS) ? toExponential(str, ne) : toFixedPoint(str, ne, "0");
+		} else {
+			n = round(new BigNumber(n), i, rm);
+			e = n.e;
+			str = coeffToString(n.c);
+			len = str.length;
+			if (id == 1 || id == 2 && (i <= e || e <= TO_EXP_NEG)) {
+				for (; len < i; str += "0", len++);
+				str = toExponential(str, e);
+			} else {
+				i -= ne + (id === 2 && e > ne);
+				str = toFixedPoint(str, e, "0");
+				if (e + 1 > len) {
+					if (--i > 0) for (str += "."; i--; str += "0");
+				} else {
+					i += e - len;
+					if (i > 0) {
+						if (e + 1 == len) str += ".";
+						for (; i--; str += "0");
+					}
+				}
+			}
+		}
+		return n.s < 0 && c0 ? "-" + str : str;
+	}
+	function isBigNumber(v) {
+		return v instanceof BigNumber || !!v && v._isBigNumber === true;
+	}
+	function maxOrMin(args, n) {
+		var k, y, i = 1, x = new BigNumber(args[0]);
+		for (; i < args.length; i++) {
+			y = new BigNumber(args[i]);
+			if (!y.s || (k = compare(x, y)) === n || k === 0 && x.s === n) x = y;
+		}
+		return x;
+	}
+	function normalise(n, c, e) {
+		var i = 1, j = c.length;
+		for (; !c[--j]; c.pop());
+		for (j = c[0]; j >= 10; j /= 10, i++);
+		if ((e = i + e * LOG_BASE - 1) > MAX_EXP) n.c = n.e = null;
+		else if (e < MIN_EXP) n.c = [n.e = 0];
+		else {
+			n.e = e;
+			n.c = c;
+		}
+		return n;
+	}
+	function resolveFormatOptions(options) {
+		var key, resolved = {};
+		for (key in FORMAT) if (FORMAT.hasOwnProperty(key)) resolved[key] = options.hasOwnProperty(key) ? options[key] : FORMAT[key];
+		return resolved;
+	}
+	function round(x, sd, rm, r) {
+		var d, i, j, k, n, ni, rd, xc = x.c, pows10 = POWS_TEN;
+		if (xc) {
+			out: {
+				for (d = 1, k = xc[0]; k >= 10; k /= 10, d++);
+				i = sd - d;
+				if (i < 0) {
+					i += LOG_BASE;
+					j = sd;
+					n = xc[ni = 0];
+					rd = mathfloor(n / pows10[d - j - 1] % 10);
+				} else {
+					ni = mathceil((i + 1) / LOG_BASE);
+					if (ni >= xc.length) if (r) {
+						for (; xc.length <= ni; xc.push(0));
+						n = rd = 0;
+						d = 1;
+						i %= LOG_BASE;
+						j = i - LOG_BASE + 1;
+					} else break out;
+					else {
+						n = k = xc[ni];
+						for (d = 1; k >= 10; k /= 10, d++);
+						i %= LOG_BASE;
+						j = i - LOG_BASE + d;
+						rd = j < 0 ? 0 : mathfloor(n / pows10[d - j - 1] % 10);
+					}
+				}
+				r = r || sd < 0 || xc[ni + 1] != null || (j < 0 ? n : n % pows10[d - j - 1]);
+				r = rm < 4 ? (rd || r) && (rm == 0 || rm == (x.s < 0 ? 3 : 2)) : rd > 5 || rd == 5 && (rm == 4 || r || rm == 6 && (i > 0 ? j > 0 ? n / pows10[d - j] : 0 : xc[ni - 1]) % 10 & 1 || rm == (x.s < 0 ? 8 : 7));
+				if (sd < 1 || !xc[0]) {
+					xc.length = 0;
+					if (r) {
+						sd -= x.e + 1;
+						xc[0] = pows10[(LOG_BASE - sd % LOG_BASE) % LOG_BASE];
+						x.e = -sd || 0;
+					} else xc[0] = x.e = 0;
+					return x;
+				}
+				if (i == 0) {
+					xc.length = ni;
+					k = 1;
+					ni--;
+				} else {
+					xc.length = ni + 1;
+					k = pows10[LOG_BASE - i];
+					xc[ni] = j > 0 ? mathfloor(n / pows10[d - j] % pows10[j]) * k : 0;
+				}
+				if (r) for (;;) if (ni == 0) {
+					for (i = 1, j = xc[0]; j >= 10; j /= 10, i++);
+					j = xc[0] += k;
+					for (k = 1; j >= 10; j /= 10, k++);
+					if (i != k) {
+						x.e++;
+						if (xc[0] == BASE) xc[0] = 1;
+					}
+					break;
+				} else {
+					xc[ni] += k;
+					if (xc[ni] != BASE) break;
+					xc[ni--] = 0;
+					k = 1;
+				}
+				for (i = xc.length; xc[--i] === 0; xc.pop());
+			}
+			if (x.e > MAX_EXP) x.c = x.e = null;
+			else if (x.e < MIN_EXP) x.c = [x.e = 0];
+		}
+		return x;
+	}
+	function valueOf(n) {
+		var str, e = n.e;
+		if (e === null) return n.toString();
+		str = coeffToString(n.c);
+		str = e <= TO_EXP_NEG || e >= TO_EXP_POS ? toExponential(str, e) : toFixedPoint(str, e, "0");
+		return n.s < 0 ? "-" + str : str;
+	}
+	P.absoluteValue = P.abs = function() {
+		var x = new BigNumber(this);
+		if (x.s < 0) x.s = 1;
+		return x;
+	};
+	P.comparedTo = function(y, b) {
+		return compare(this, new BigNumber(y, b));
+	};
+	P.decimalPlaces = P.dp = function(dp, rm) {
+		var c, n, v, x = this;
+		if (dp != null) return round(new BigNumber(x), intCheck(dp, -MAX, MAX) + x.e + 1, rm == null ? ROUNDING_MODE : intCheck(rm, 0, 8));
+		if (!(c = x.c)) return null;
+		n = ((v = c.length - 1) - bitFloor(this.e / LOG_BASE)) * LOG_BASE;
+		if (v = c[v]) for (; v % 10 == 0; v /= 10, n--);
+		if (n < 0) n = 0;
+		return n;
+	};
+	P.dividedBy = P.div = function(y, b) {
+		return div(this, new BigNumber(y, b), DECIMAL_PLACES, ROUNDING_MODE);
+	};
+	P.dividedToIntegerBy = P.idiv = function(y, b) {
+		return div(this, new BigNumber(y, b), 0, 1);
+	};
+	P.exponentiatedBy = P.pow = function(n, m) {
+		var half, isModExp, i, k, more, nIsBig, nIsNeg, nIsOdd, y, x = this;
+		n = new BigNumber(n);
+		if (n.c && !n.isInteger()) throw Error(bignumberError + "Exponent not an integer: " + valueOf(n));
+		if (m != null) m = new BigNumber(m);
+		nIsBig = n.e > 14;
+		if (!x.c || !x.c[0] || x.c[0] == 1 && !x.e && x.c.length == 1 || !n.c || !n.c[0]) {
+			y = new BigNumber(Math.pow(+valueOf(x), nIsBig ? n.s * (2 - isOdd(n)) : +valueOf(n)));
+			return m ? y.mod(m) : y;
+		}
+		nIsNeg = n.s < 0;
+		if (m) {
+			if (m.c ? !m.c[0] : !m.s) return new BigNumber(NaN);
+			isModExp = !nIsNeg && x.isInteger() && m.isInteger();
+			if (isModExp) x = x.mod(m);
+		} else if (n.e > 9 && (x.e > 0 || x.e < -1 || (x.e == 0 ? x.c[0] > 1 || nIsBig && x.c[1] >= 24e7 : x.c[0] < 8e13 || nIsBig && x.c[0] <= 9999975e7))) {
+			k = x.s < 0 && isOdd(n) ? -0 : 0;
+			if (x.e > -1) k = 1 / k;
+			return new BigNumber(nIsNeg ? 1 / k : k);
+		} else if (POW_PRECISION) k = mathceil(POW_PRECISION / LOG_BASE + 2);
+		if (nIsBig) {
+			half = new BigNumber(.5);
+			if (nIsNeg) n.s = 1;
+			nIsOdd = isOdd(n);
+		} else {
+			i = Math.abs(+valueOf(n));
+			nIsOdd = i % 2;
+		}
+		y = new BigNumber(ONE);
+		for (;;) {
+			if (nIsOdd) {
+				y = y.times(x);
+				if (!y.c) break;
+				if (k) {
+					if (y.c.length > k) y.c.length = k;
+				} else if (isModExp) y = y.mod(m);
+			}
+			if (i) {
+				i = mathfloor(i / 2);
+				if (i === 0) break;
+				nIsOdd = i % 2;
+			} else {
+				n = n.times(half);
+				round(n, n.e + 1, 1);
+				if (n.e > 14) nIsOdd = isOdd(n);
+				else {
+					i = +valueOf(n);
+					if (i === 0) break;
+					nIsOdd = i % 2;
+				}
+			}
+			x = x.times(x);
+			if (k) {
+				if (x.c && x.c.length > k) x.c.length = k;
+			} else if (isModExp) x = x.mod(m);
+		}
+		if (isModExp) return y;
+		if (nIsNeg) y = ONE.div(y);
+		return m ? y.mod(m) : k ? round(y, POW_PRECISION, ROUNDING_MODE, more) : y;
+	};
+	P.integerValue = function(rm) {
+		var n = new BigNumber(this);
+		return round(n, n.e + 1, rm == null ? ROUNDING_MODE : intCheck(rm, 0, 8));
+	};
+	P.isEqualTo = P.eq = function(y, b) {
+		return compare(this, new BigNumber(y, b)) === 0;
+	};
+	P.isFinite = function() {
+		return !!this.c;
+	};
+	P.isGreaterThan = P.gt = function(y, b) {
+		return compare(this, new BigNumber(y, b)) > 0;
+	};
+	P.isGreaterThanOrEqualTo = P.gte = function(y, b) {
+		return (b = compare(this, new BigNumber(y, b))) === 1 || b === 0;
+	};
+	P.isInteger = function() {
+		return !!this.c && bitFloor(this.e / LOG_BASE) > this.c.length - 2;
+	};
+	P.isLessThan = P.lt = function(y, b) {
+		return compare(this, new BigNumber(y, b)) < 0;
+	};
+	P.isLessThanOrEqualTo = P.lte = function(y, b) {
+		return (b = compare(this, new BigNumber(y, b))) === -1 || b === 0;
+	};
+	P.isNaN = function() {
+		return !this.s;
+	};
+	P.isNegative = function() {
+		return this.s < 0;
+	};
+	P.isPositive = function() {
+		return this.s > 0;
+	};
+	P.isZero = function() {
+		return !!this.c && this.c[0] == 0;
+	};
+	P.minus = function(y, b) {
+		var i, j, t, xLTy, x = this, a = x.s;
+		y = new BigNumber(y, b);
+		b = y.s;
+		if (!a || !b) return new BigNumber(NaN);
+		if (a != b) {
+			y.s = -b;
+			return x.plus(y);
+		}
+		var xe = x.e / LOG_BASE, ye = y.e / LOG_BASE, xc = x.c, yc = y.c;
+		if (!xe || !ye) {
+			if (!xc || !yc) return xc ? (y.s = -b, y) : new BigNumber(yc ? x : NaN);
+			if (!xc[0] || !yc[0]) return yc[0] ? (y.s = -b, y) : new BigNumber(xc[0] ? x : ROUNDING_MODE == 3 ? -0 : 0);
+		}
+		xe = bitFloor(xe);
+		ye = bitFloor(ye);
+		xc = xc.slice();
+		if (a = xe - ye) {
+			if (xLTy = a < 0) {
+				a = -a;
+				t = xc;
+			} else {
+				ye = xe;
+				t = yc;
+			}
+			t.reverse();
+			for (b = a; b--; t.push(0));
+			t.reverse();
+		} else {
+			j = (xLTy = (a = xc.length) < (b = yc.length)) ? a : b;
+			for (a = b = 0; b < j; b++) if (xc[b] != yc[b]) {
+				xLTy = xc[b] < yc[b];
+				break;
+			}
+		}
+		if (xLTy) {
+			t = xc;
+			xc = yc;
+			yc = t;
+			y.s = -y.s;
+		}
+		b = (j = yc.length) - (i = xc.length);
+		if (b > 0) for (; b--; xc[i++] = 0);
+		b = BASE - 1;
+		for (; j > a;) {
+			if (xc[--j] < yc[j]) {
+				for (i = j; i && !xc[--i]; xc[i] = b);
+				--xc[i];
+				xc[j] += BASE;
+			}
+			xc[j] -= yc[j];
+		}
+		for (; xc[0] == 0; xc.splice(0, 1), --ye);
+		if (!xc[0]) {
+			y.s = ROUNDING_MODE == 3 ? -1 : 1;
+			y.c = [y.e = 0];
+			return y;
+		}
+		return normalise(y, xc, ye);
+	};
+	P.modulo = P.mod = function(y, b) {
+		var q, s, x = this;
+		y = new BigNumber(y, b);
+		if (!x.c || !y.s || y.c && !y.c[0]) return new BigNumber(NaN);
+		else if (!y.c || x.c && !x.c[0]) return new BigNumber(x);
+		if (MODULO_MODE == 9) {
+			s = y.s;
+			y.s = 1;
+			q = div(x, y, 0, 3);
+			y.s = s;
+			q.s *= s;
+		} else q = div(x, y, 0, MODULO_MODE);
+		y = x.minus(q.times(y));
+		if (!y.c[0] && MODULO_MODE == 1) y.s = x.s;
+		return y;
+	};
+	P.multipliedBy = P.times = function(y, b) {
+		var c, e, i, j, k, m, xcL, xlo, xhi, ycL, ylo, yhi, zc, base, sqrtBase, x = this, xc = x.c, yc = (y = new BigNumber(y, b)).c;
+		if (!xc || !yc || !xc[0] || !yc[0]) {
+			if (!x.s || !y.s || xc && !xc[0] && !yc || yc && !yc[0] && !xc) y.c = y.e = y.s = null;
+			else {
+				y.s *= x.s;
+				if (!xc || !yc) y.c = y.e = null;
+				else {
+					y.c = [0];
+					y.e = 0;
+				}
+			}
+			return y;
+		}
+		e = bitFloor(x.e / LOG_BASE) + bitFloor(y.e / LOG_BASE);
+		y.s *= x.s;
+		xcL = xc.length;
+		ycL = yc.length;
+		if (xcL < ycL) {
+			zc = xc;
+			xc = yc;
+			yc = zc;
+			i = xcL;
+			xcL = ycL;
+			ycL = i;
+		}
+		for (i = xcL + ycL, zc = []; i--; zc.push(0));
+		base = BASE;
+		sqrtBase = SQRT_BASE;
+		for (i = ycL; --i >= 0;) {
+			c = 0;
+			ylo = yc[i] % sqrtBase;
+			yhi = yc[i] / sqrtBase | 0;
+			for (k = xcL, j = i + k; j > i;) {
+				xlo = xc[--k] % sqrtBase;
+				xhi = xc[k] / sqrtBase | 0;
+				m = yhi * xlo + xhi * ylo;
+				xlo = ylo * xlo + m % sqrtBase * sqrtBase + zc[j] + c;
+				c = (xlo / base | 0) + (m / sqrtBase | 0) + yhi * xhi;
+				zc[j--] = xlo % base;
+			}
+			zc[j] = c;
+		}
+		if (c) ++e;
+		else zc.splice(0, 1);
+		return normalise(y, zc, e);
+	};
+	P.negated = function() {
+		var x = new BigNumber(this);
+		x.s = -x.s || null;
+		return x;
+	};
+	P.plus = function(y, b) {
+		var t, x = this, a = x.s;
+		y = new BigNumber(y, b);
+		b = y.s;
+		if (!a || !b) return new BigNumber(NaN);
+		if (a != b) {
+			y.s = -b;
+			return x.minus(y);
+		}
+		var xe = x.e / LOG_BASE, ye = y.e / LOG_BASE, xc = x.c, yc = y.c;
+		if (!xe || !ye) {
+			if (!xc || !yc) return new BigNumber(a / 0);
+			if (!xc[0] || !yc[0]) return yc[0] ? y : new BigNumber(xc[0] ? x : a * 0);
+		}
+		xe = bitFloor(xe);
+		ye = bitFloor(ye);
+		xc = xc.slice();
+		if (a = xe - ye) {
+			if (a > 0) {
+				ye = xe;
+				t = yc;
+			} else {
+				a = -a;
+				t = xc;
+			}
+			t.reverse();
+			for (; a--; t.push(0));
+			t.reverse();
+		}
+		a = xc.length;
+		b = yc.length;
+		if (a - b < 0) {
+			t = yc;
+			yc = xc;
+			xc = t;
+			b = a;
+		}
+		for (a = 0; b;) {
+			a = (xc[--b] = xc[b] + yc[b] + a) / BASE | 0;
+			xc[b] = BASE === xc[b] ? 0 : xc[b] % BASE;
+		}
+		if (a) {
+			xc = [a].concat(xc);
+			++ye;
+		}
+		return normalise(y, xc, ye);
+	};
+	P.precision = P.sd = function(sd, rm) {
+		var c, n, v, x = this;
+		if (sd != null && sd !== !!sd) return round(new BigNumber(x), intCheck(sd, 1, MAX), rm == null ? ROUNDING_MODE : intCheck(rm, 0, 8));
+		if (!(c = x.c)) return null;
+		v = c.length - 1;
+		n = v * LOG_BASE + 1;
+		if (v = c[v]) {
+			for (; v % 10 == 0; v /= 10, n--);
+			for (v = c[0]; v >= 10; v /= 10, n++);
+		}
+		if (sd && x.e + 1 > n) n = x.e + 1;
+		return n;
+	};
+	P.shiftedBy = function(k) {
+		return this.times("1e" + intCheck(k, -MAX_SAFE_INTEGER, MAX_SAFE_INTEGER));
+	};
+	P.squareRoot = P.sqrt = function() {
+		var m, n, r, rep, t, x = this, c = x.c, s = x.s, e = x.e, dp = DECIMAL_PLACES + 4, half = new BigNumber("0.5");
+		if (s !== 1 || !c || !c[0]) return new BigNumber(!s || s < 0 && (!c || c[0]) ? NaN : c ? x : Infinity);
+		s = Math.sqrt(+valueOf(x));
+		if (s == 0 || s == Infinity) {
+			n = coeffToString(c);
+			if ((n.length + e) % 2 == 0) n += "0";
+			s = Math.sqrt(+n);
+			e = bitFloor((e + 1) / 2) - (e < 0 || e % 2);
+			if (s == Infinity) n = "5e" + e;
+			else {
+				n = s.toExponential();
+				n = n.slice(0, n.indexOf("e") + 1) + e;
+			}
+			r = new BigNumber(n);
+		} else r = new BigNumber(s + "");
+		if (r.c[0]) {
+			e = r.e;
+			s = e + dp;
+			if (s < 3) s = 0;
+			for (;;) {
+				t = r;
+				r = half.times(t.plus(div(x, t, dp, 1)));
+				if (coeffToString(t.c).slice(0, s) === (n = coeffToString(r.c)).slice(0, s)) {
+					if (r.e < e) --s;
+					n = n.slice(s - 3, s + 1);
+					if (n == "9999" || !rep && n == "4999") {
+						if (!rep) {
+							round(t, t.e + DECIMAL_PLACES + 2, 0);
+							if (t.times(t).eq(x)) {
+								r = t;
+								break;
+							}
+						}
+						dp += 4;
+						s += 4;
+						rep = 1;
+					} else {
+						if (!+n || !+n.slice(1) && n.charAt(0) == "5") {
+							round(r, r.e + DECIMAL_PLACES + 2, 1);
+							m = !r.times(r).eq(x);
+						}
+						break;
+					}
+				}
+			}
+		}
+		return round(r, r.e + DECIMAL_PLACES + 1, ROUNDING_MODE, m);
+	};
+	if (typeof BigInt == "function") P.toBigInt = function(rm) {
+		var x = this;
+		if (!x.c) return null;
+		return BigInt(format(x, x.e + 1, rm));
+	};
+	P.toExponential = function(dp, rm) {
+		return format(this, dp == null ? dp : intCheck(dp, 0, MAX) + 1, rm, 1);
+	};
+	P.toFixed = function(dp, rm) {
+		return format(this, dp == null ? dp : intCheck(dp, -MAX, MAX) + this.e + 1, rm);
+	};
+	P.toFormat = function(dp, rm, options) {
+		var isNeg, min, max, str, x = this;
+		if (options == null) {
+			options = FORMAT;
+			if (dp != null) {
+				if (rm != null) {
+					if (typeof rm == "object") {
+						options = resolveFormatOptions(rm);
+						rm = null;
+					}
+				} else if (typeof dp == "object" && !isArray(dp)) {
+					options = resolveFormatOptions(dp);
+					dp = rm = null;
+				}
+			}
+		} else if (typeof options != "object") throw Error(bignumberError + "Argument not an object: " + options);
+		else options = resolveFormatOptions(options);
+		if (dp != null) if (isArray(dp) && dp.length <= 2) {
+			min = dp[0];
+			max = dp[1];
+			dp = x.dp();
+			if (max != null && dp > intCheck(max, 0, MAX)) dp = max;
+			if (min != null && intCheck(min, 0, MAX) !== 0) {
+				if (max != null && min > max) throw Error(bignumberError + "Minimum must not exceed maximum");
+				if (dp < min) dp = min;
+			}
+		} else intCheck(dp, -MAX, MAX);
+		str = x.toFixed(dp, rm);
+		isNeg = str.charCodeAt(0) === 45;
+		if (isNeg) str = str.slice(1);
+		if (x.c) {
+			var i, arr = str.split("."), g1 = +options.groupSize, g2 = +options.secondaryGroupSize, groupSeparator = options.groupSeparator || "", intPart = arr[0], fractionPart = arr[1], len = intPart.length;
+			if (g2) {
+				i = g1;
+				g1 = g2;
+				g2 = i;
+				len -= i;
+			}
+			if (g1 > 0 && len > 0) {
+				i = len % g1 || g1;
+				str = intPart.substr(0, i);
+				for (; i < len; i += g1) str += groupSeparator + intPart.substr(i, g1);
+				if (g2 > 0) str += groupSeparator + intPart.slice(i);
+			} else str = intPart;
+			if (fractionPart) {
+				i = +options.fractionGroupSize;
+				if (i) fractionPart = fractionPart.replace(new RegExp("\\d{" + i + "}\\B", "g"), "$&" + (options.fractionGroupSeparator || ""));
+				str += (options.decimalSeparator || "") + fractionPart;
+			}
+		}
+		return (options.prefix || "") + (isNeg ? options.negativeSign || "" : x.s > 0 ? options.positiveSign || "" : "") + str + (options.suffix || "");
+	};
+	P.toFraction = function(md) {
+		var d, d0, d1, d2, e, exp, n, n0, n1, q, r, s, xd, xn, x = this, xc = x.c;
+		if (md != null) {
+			n = new BigNumber(md);
+			if (!n.isInteger() && (n.c || n.s !== 1) || n.lt(ONE)) throw Error(bignumberError + "Argument " + (n.isInteger() ? "out of range: " : "not an integer: ") + valueOf(n));
+		}
+		if (!xc) return [new BigNumber(x.s || 0), new BigNumber(0)];
+		d = new BigNumber(ONE);
+		n1 = d0 = new BigNumber(ONE);
+		d1 = n0 = new BigNumber(ONE);
+		s = coeffToString(xc);
+		e = d.e = s.length - x.e - 1;
+		d.c[0] = POWS_TEN[(exp = e % LOG_BASE) < 0 ? LOG_BASE + exp : exp];
+		md = !md || n.comparedTo(d) > 0 ? e > 0 ? d : n1 : n;
+		exp = MAX_EXP;
+		MAX_EXP = Infinity;
+		n = new BigNumber(s);
+		xn = n;
+		xd = d;
+		n0.c[0] = 0;
+		for (;;) {
+			q = div(n, d, 0, 1);
+			d2 = d0.plus(q.times(d1));
+			if (d2.comparedTo(md) == 1) break;
+			d0 = d1;
+			d1 = d2;
+			n1 = n0.plus(q.times(d2 = n1));
+			n0 = d2;
+			d = n.minus(q.times(d2 = d));
+			n = d2;
+		}
+		d2 = div(md.minus(d0), d1, 0, 1);
+		n0 = n0.plus(d2.times(n1));
+		d0 = d0.plus(d2.times(d1));
+		r = n1.times(xd).minus(xn.times(d1)).abs().times(d0).comparedTo(n0.times(xd).minus(xn.times(d0)).abs().times(d1)) < 1 ? [n1, d1] : [n0, d0];
+		r[0].s = x.s;
+		MAX_EXP = exp;
+		return r;
+	};
+	P.toNumber = function() {
+		return +valueOf(this);
+	};
+	P.toObject = function() {
+		var x = this;
+		return {
+			c: x.c ? x.c.slice() : null,
+			e: x.e,
+			s: x.s
+		};
+	};
+	P.toPrecision = function(sd, rm) {
+		return format(this, sd == null ? sd : intCheck(sd, 1, MAX), rm, 2);
+	};
+	P.toString = function(b) {
+		var str, n = this, s = n.s, e = n.e;
+		if (e === null) if (s) {
+			str = "Infinity";
+			if (s < 0) str = "-" + str;
+		} else str = "NaN";
+		else {
+			if (b == null) str = e <= TO_EXP_NEG || e >= TO_EXP_POS ? toExponential(coeffToString(n.c), e) : toFixedPoint(coeffToString(n.c), e, "0");
+			else {
+				intCheck(b, 2, ALPHABET.length, "Base");
+				str = convertBase(toFixedPoint(coeffToString(n.c), e, "0"), 10, b, s, true);
+			}
+			if (s < 0 && n.c[0]) str = "-" + str;
+		}
+		return str;
+	};
+	P.valueOf = P.toJSON = function() {
+		return valueOf(this);
+	};
+	P._isBigNumber = true;
+	if (configObject != null) BigNumber.set(configObject);
+	return BigNumber;
+}
+function bitFloor(n) {
+	var i = n | 0;
+	return n > 0 || n === i ? i : i - 1;
+}
+function coeffToString(a) {
+	var s, z, i = 1, j = a.length, r = a[0] + "";
+	for (; i < j;) {
+		s = a[i++] + "";
+		z = LOG_BASE - s.length;
+		for (; z--; s = "0" + s);
+		r += s;
+	}
+	for (j = r.length; r.charCodeAt(--j) === 48;);
+	return r.slice(0, j + 1 || 1);
+}
+function compare(x, y) {
+	var a, b, xc = x.c, yc = y.c, i = x.s, j = y.s, k = x.e, l = y.e;
+	if (!i || !j) return null;
+	a = xc && !xc[0];
+	b = yc && !yc[0];
+	if (a || b) return a ? b ? 0 : -j : i;
+	if (i != j) return i;
+	a = i < 0;
+	b = k == l;
+	if (!xc || !yc) return b ? 0 : !xc ^ a ? 1 : -1;
+	if (!b) return k > l ^ a ? 1 : -1;
+	j = (k = xc.length) < (l = yc.length) ? k : l;
+	for (i = 0; i < j; i++) if (xc[i] != yc[i]) return xc[i] > yc[i] ^ a ? 1 : -1;
+	return k == l ? 0 : k > l ^ a ? 1 : -1;
+}
+function intCheck(n, min, max, name) {
+	if (n < min || n > max || n !== mathfloor(n)) throw Error(bignumberError + (name || "Argument") + (typeof n == "number" ? n < min || n > max ? " out of range: " : " not an integer: " : " not a primitive number: ") + String(n));
+	return n;
+}
+function isArray(obj) {
+	return {}.toString.call(obj) == "[object Array]";
+}
+function isOdd(n) {
+	var k = n.c.length - 1;
+	return bitFloor(n.e / LOG_BASE) == k && n.c[k] % 2 != 0;
+}
+function toExponential(str, e) {
+	return (str.length > 1 ? str.charAt(0) + "." + str.slice(1) : str) + (e < 0 ? "e" : "e+") + e;
+}
+function toFixedPoint(str, e, z) {
+	var len, zs;
+	if (e < 0) {
+		for (zs = z + "."; ++e; zs += z);
+		str = zs + str;
+	} else {
+		len = str.length;
+		if (++e > len) {
+			for (zs = z, e -= len; --e; zs += z);
+			str += zs;
+		} else if (e < len) str = str.slice(0, e) + "." + str.slice(e);
+	}
+	return str;
+}
+//#endregion
+//#region packages/contracts/src/api-keys.ts
+/**
+* API anahtarı sözleşmeleri — permission-mask modeli (spec §5.5).
+*
+* KRİTİK KURAL: `scope`, oluşturma anındaki tavandır — gerçek etkili kapsam
+* istek anında sahibinin GÜNCEL tenant rolüyle kesişiminden hesaplanır (bkz.
+* apps/api/src/lib/api-key-auth.ts). Bu şemalar yalnız gövde şeklini tanımlar,
+* yetki hesabını YAPMAZ.
+*/
+const apiKeyScopeSchema = z.enum([
+	"read",
+	"write",
+	"admin"
+], "geçerli bir kapsam olmalı (read, write, admin)");
+z.object({
+	name: z.string().trim().min(2, "ad en az 2 karakter olmalı").max(80, "ad en fazla 80 karakter olabilir"),
+	scope: apiKeyScopeSchema
+});
+z.object({
+	id: z.uuid(),
+	name: z.string(),
+	scope: apiKeyScopeSchema,
+	prefix: z.string(),
+	token: z.string()
+});
+const apiKeyResponseSchema = z.object({
+	id: z.uuid(),
+	name: z.string(),
+	scope: apiKeyScopeSchema,
+	prefix: z.string(),
+	lastUsedAt: z.iso.datetime().nullable(),
+	revokedAt: z.iso.datetime().nullable(),
+	createdAt: z.iso.datetime()
+});
+z.object({ keys: z.array(apiKeyResponseSchema) });
+//#endregion
+//#region packages/contracts/src/common.ts
+/**
+* Ortak zod şemaları ve doğrulayıcılar — birden fazla domain tarafından
+* paylaşılan küçük yapı taşları. Domain'e özgü şemalar kendi dosyalarında
+* durur (ör. plans.ts, fields.ts).
+*
+* Hata mesajları Türkçe: bu şemalar doğrudan API yanıtına dönüşüyor.
+*/
+/** Tenant üyeliği rolü — sıralı: viewer < member < admin < owner */
+const memberRoleSchema = z.enum([
+	"owner",
+	"admin",
+	"member",
+	"viewer"
+], "geçerli bir rol olmalı (owner, admin, member, viewer)");
+/**
+* Tenant slug'ı. NOT: "ayrılmış adlar" (ör. `admin`, `api`, `www`) şu anda
+* route katmanında FİLTRELENMİYOR — slug bir subdomain değil path-prefix
+* olarak kullanıldığından (bkz. spec) bu bir güvenlik açığı oluşturmuyor;
+* yalnız kullanıcı deneyimi/marka çakışması riski Faz 4A kapsamı dışında
+* bırakıldı. İleride ayrılmış ad listesi eklenirse burası genişletilir.
+*/
+const tenantSlugSchema = z.string().min(2, "en az 2 karakter olmalı").max(64, "en fazla 64 karakter olabilir").regex(/^[a-z][a-z0-9-]*$/, "küçük harf, rakam ve tire kullanılabilir");
+/**
+* Katı hex renk — tenant branding'inde doğrudan CSS'e yazıldığı için
+* serbest string ASLA kabul edilmez (CSS enjeksiyonu sınırı).
+*/
+const hexColorSchema = z.string().regex(/^#([0-9a-fA-F]{6}|[0-9a-fA-F]{3})$/, "geçerli bir hex renk olmalı (örn. #14b8a6)");
+z.string().regex(/^\+[1-9]\d{7,14}$/, "uluslararası biçimde olmalı (örn. +905321234567)");
+/** Muhasebe/bildirim e-postası */
+const emailSchema = z.email("geçerli bir e-posta adresi olmalı").max(160, "en fazla 160 karakter olabilir");
+/**
+* TC Kimlik Numarası checksum doğrulaması (11 hane, sıfırla başlamaz).
+* 10. hane: (tek konumların toplamı×7 - çift konumların toplamı) mod 10
+* 11. hane: ilk 10 hanenin toplamı mod 10
+*/
+function validateTckn(value) {
+	if (!/^[1-9]\d{10}$/.test(value)) return false;
+	const d = [...value].map(Number);
+	let oddSum = 0;
+	let evenSum = 0;
+	for (let i = 0; i < 9; i += 1) {
+		const digit = d[i];
+		if (digit === void 0) return false;
+		if (i % 2 === 0) oddSum += digit;
+		else evenSum += digit;
+	}
+	const tenth = d[9];
+	const eleventh = d[10];
+	if (tenth === void 0 || eleventh === void 0) return false;
+	if (((oddSum * 7 - evenSum) % 10 + 10) % 10 !== tenth) return false;
+	return d.slice(0, 10).reduce((a, b) => a + b, 0) % 10 === eleventh;
+}
+/**
+* Vergi Kimlik Numarası checksum doğrulaması (10 hane).
+* Maliye Bakanlığı algoritması.
+*/
+function validateVkn(value) {
+	if (!/^\d{10}$/.test(value)) return false;
+	const d = [...value].map(Number);
+	let sum = 0;
+	for (let i = 0; i < 9; i += 1) {
+		const digit = d[i];
+		if (digit === void 0) return false;
+		const tmp = (digit + 10 - (i + 1)) % 10;
+		if (tmp === 9) sum += tmp;
+		else sum += tmp * 2 ** (10 - (i + 1)) % 9;
+	}
+	const last = d[9];
+	if (last === void 0) return false;
+	return (10 - sum % 10) % 10 === last;
+}
+z.object({
+	/** Zitadel'den PKCE akışıyla alınan id_token */
+	idToken: z.string().min(1, "idToken gerekli").max(8192, "idToken çok uzun"),
+	/** id_token profil claim'i taşımıyorsa userinfo tamamlaması için (opsiyonel) */
+	accessToken: z.string().min(1, "accessToken boş olamaz").max(8192, "accessToken çok uzun").optional()
+});
+z.object({
+	token: z.string(),
+	user: z.object({
+		id: z.uuid(),
+		email: z.string(),
+		name: z.string()
+	})
+});
+z.object({
+	user: z.object({
+		id: z.uuid(),
+		email: z.string(),
+		name: z.string()
+	}),
+	tenants: z.array(z.object({
+		id: z.uuid(),
+		name: z.string(),
+		slug: z.string(),
+		role: memberRoleSchema
+	}))
+});
+z.object({
+	name: z.string().trim().min(2, "ad en az 2 karakter olmalı").max(120, "ad en fazla 120 karakter olabilir"),
+	slug: tenantSlugSchema
+});
+z.object({
+	id: z.uuid(),
+	name: z.string(),
+	slug: z.string(),
+	role: memberRoleSchema
+});
+/** `GET /v1/tenants/:id/members` yanıtındaki tek üye satırı */
+const tenantMemberSchema = z.object({
+	userId: z.uuid(),
+	email: z.string(),
+	name: z.string(),
+	role: memberRoleSchema
+});
+z.object({ members: z.array(tenantMemberSchema) });
+z.object({ role: memberRoleSchema });
+z.object({
+	userId: z.uuid(),
+	role: memberRoleSchema
+});
+const COUNTRY_CODE_SET = /* @__PURE__ */ new Set([
+	"AD",
+	"AE",
+	"AF",
+	"AG",
+	"AI",
+	"AL",
+	"AM",
+	"AO",
+	"AQ",
+	"AR",
+	"AS",
+	"AT",
+	"AU",
+	"AW",
+	"AX",
+	"AZ",
+	"BA",
+	"BB",
+	"BD",
+	"BE",
+	"BF",
+	"BG",
+	"BH",
+	"BI",
+	"BJ",
+	"BL",
+	"BM",
+	"BN",
+	"BO",
+	"BQ",
+	"BR",
+	"BS",
+	"BT",
+	"BV",
+	"BW",
+	"BY",
+	"BZ",
+	"CA",
+	"CC",
+	"CD",
+	"CF",
+	"CG",
+	"CH",
+	"CI",
+	"CK",
+	"CL",
+	"CM",
+	"CN",
+	"CO",
+	"CR",
+	"CU",
+	"CV",
+	"CW",
+	"CX",
+	"CY",
+	"CZ",
+	"DE",
+	"DJ",
+	"DK",
+	"DM",
+	"DO",
+	"DZ",
+	"EC",
+	"EE",
+	"EG",
+	"EH",
+	"ER",
+	"ES",
+	"ET",
+	"FI",
+	"FJ",
+	"FK",
+	"FM",
+	"FO",
+	"FR",
+	"GA",
+	"GB",
+	"GD",
+	"GE",
+	"GF",
+	"GG",
+	"GH",
+	"GI",
+	"GL",
+	"GM",
+	"GN",
+	"GP",
+	"GQ",
+	"GR",
+	"GS",
+	"GT",
+	"GU",
+	"GW",
+	"GY",
+	"HK",
+	"HM",
+	"HN",
+	"HR",
+	"HT",
+	"HU",
+	"ID",
+	"IE",
+	"IL",
+	"IM",
+	"IN",
+	"IO",
+	"IQ",
+	"IR",
+	"IS",
+	"IT",
+	"JE",
+	"JM",
+	"JO",
+	"JP",
+	"KE",
+	"KG",
+	"KH",
+	"KI",
+	"KM",
+	"KN",
+	"KP",
+	"KR",
+	"KW",
+	"KY",
+	"KZ",
+	"LA",
+	"LB",
+	"LC",
+	"LI",
+	"LK",
+	"LR",
+	"LS",
+	"LT",
+	"LU",
+	"LV",
+	"LY",
+	"MA",
+	"MC",
+	"MD",
+	"ME",
+	"MF",
+	"MG",
+	"MH",
+	"MK",
+	"ML",
+	"MM",
+	"MN",
+	"MO",
+	"MP",
+	"MQ",
+	"MR",
+	"MS",
+	"MT",
+	"MU",
+	"MV",
+	"MW",
+	"MX",
+	"MY",
+	"MZ",
+	"NA",
+	"NC",
+	"NE",
+	"NF",
+	"NG",
+	"NI",
+	"NL",
+	"NO",
+	"NP",
+	"NR",
+	"NU",
+	"NZ",
+	"OM",
+	"PA",
+	"PE",
+	"PF",
+	"PG",
+	"PH",
+	"PK",
+	"PL",
+	"PM",
+	"PN",
+	"PR",
+	"PS",
+	"PT",
+	"PW",
+	"PY",
+	"QA",
+	"RE",
+	"RO",
+	"RS",
+	"RU",
+	"RW",
+	"SA",
+	"SB",
+	"SC",
+	"SD",
+	"SE",
+	"SG",
+	"SH",
+	"SI",
+	"SJ",
+	"SK",
+	"SL",
+	"SM",
+	"SN",
+	"SO",
+	"SR",
+	"SS",
+	"ST",
+	"SV",
+	"SX",
+	"SY",
+	"SZ",
+	"TC",
+	"TD",
+	"TF",
+	"TG",
+	"TH",
+	"TJ",
+	"TK",
+	"TL",
+	"TM",
+	"TN",
+	"TO",
+	"TR",
+	"TT",
+	"TV",
+	"TW",
+	"TZ",
+	"UA",
+	"UG",
+	"UM",
+	"US",
+	"UY",
+	"UZ",
+	"VA",
+	"VC",
+	"VE",
+	"VG",
+	"VI",
+	"VN",
+	"VU",
+	"WF",
+	"WS",
+	"YE",
+	"YT",
+	"ZA",
+	"ZM",
+	"ZW"
+]);
+//#endregion
+//#region packages/contracts/src/plans.ts
+const PLAN_CODES = [
+	"free",
+	"pro",
+	"team",
+	"enterprise"
+];
+/** Platform admin yanıtlarında (bkz. contracts/platform.ts) `tenants.planCode`'un doğrulaması */
+const planCodeSchema = z.enum(PLAN_CODES, "geçerli bir plan olmalı");
+const BILLING_PERIODS = ["monthly", "yearly"];
+//#endregion
+//#region packages/contracts/src/billing.ts
+/**
+* Faturalama sözleşmeleri — fatura profili (ülke/bireysel/kurumsal/yurtdışı),
+* checkout isteği, abonelik/fatura yanıt şekilleri (spec §8.5–§8.8).
+*
+* KRİTİK KURAL: `accountingEmail` HER ÜÇ varyantta da ZORUNLU ve ülkeden
+* BAĞIMSIZDIR (brief madde 8) — tüm muhasebe e-postaları BURAYA gider.
+*/
+const countryCodeSchema = z.string().length(2, "ISO 3166-1 iki harfli ülke kodu olmalı").refine((value) => COUNTRY_CODE_SET.has(value), "geçerli bir ülke kodu olmalı");
+z.enum([
+	"tr_individual",
+	"tr_corporate",
+	"international"
+], "geçerli bir fatura profili türü olmalı");
+const trIndividualInputSchema = z.object({
+	kind: z.literal("tr_individual"),
+	country: z.literal("TR"),
+	fullName: z.string().trim().min(1, "ad soyad gerekli").max(200, "en fazla 200 karakter olabilir"),
+	tckn: z.string().refine(validateTckn, "geçerli bir TC Kimlik Numarası olmalı"),
+	address: z.string().trim().min(1, "adres gerekli").max(500, "en fazla 500 karakter olabilir"),
+	city: z.string().trim().min(1, "şehir gerekli").max(120, "en fazla 120 karakter olabilir"),
+	district: z.string().trim().min(1, "ilçe gerekli").max(120, "en fazla 120 karakter olabilir"),
+	accountingEmail: emailSchema
+});
+const trCorporateInputSchema = z.object({
+	kind: z.literal("tr_corporate"),
+	country: z.literal("TR"),
+	legalName: z.string().trim().min(1, "unvan gerekli").max(250, "en fazla 250 karakter olabilir"),
+	vkn: z.string().refine(validateVkn, "geçerli bir Vergi Kimlik Numarası olmalı"),
+	taxOffice: z.string().trim().min(1, "vergi dairesi gerekli").max(120, "en fazla 120 karakter olabilir"),
+	address: z.string().trim().min(1, "adres gerekli").max(500, "en fazla 500 karakter olabilir"),
+	city: z.string().trim().min(1, "şehir gerekli").max(120, "en fazla 120 karakter olabilir"),
+	district: z.string().trim().min(1, "ilçe gerekli").max(120, "en fazla 120 karakter olabilir"),
+	accountingEmail: emailSchema
+});
+const internationalInputSchema = z.object({
+	kind: z.literal("international"),
+	country: countryCodeSchema.refine((value) => value !== "TR", "yurt dışı profilde ülke TR olamaz"),
+	fullName: z.string().trim().min(1, "ad/unvan gerekli").max(250, "en fazla 250 karakter olabilir"),
+	address: z.string().trim().min(1, "adres gerekli").max(500, "en fazla 500 karakter olabilir"),
+	taxId: z.string().trim().max(60, "en fazla 60 karakter olabilir").optional(),
+	accountingEmail: emailSchema
+});
+const billingProfileInputSchema = z.discriminatedUnion("kind", [
+	trIndividualInputSchema,
+	trCorporateInputSchema,
+	internationalInputSchema
+]);
+z.object({
+	data: billingProfileInputSchema,
+	maskedTaxId: z.string().nullable(),
+	createdAt: z.iso.datetime(),
+	updatedAt: z.iso.datetime()
+});
+const purchasablePlanCodeSchema = z.enum(PLAN_CODES, "geçerli bir plan olmalı").refine((value) => value === "pro" || value === "team", "yalnız pro veya team paketleri için satın alma başlatılabilir");
+z.object({
+	planCode: purchasablePlanCodeSchema,
+	billingPeriod: z.enum(BILLING_PERIODS, "geçerli bir dönem olmalı")
+});
+z.object({ purchaseUrl: z.url() });
+z.object({ code: z.literal("billing_profile_required") });
+const subscriptionStatusValueSchema = z.enum([
+	"trialing",
+	"active",
+	"past_due",
+	"cancelled",
+	"refunded"
+]);
+z.object({
+	planCode: z.enum(PLAN_CODES),
+	billingPeriod: z.enum(BILLING_PERIODS).nullable(),
+	status: subscriptionStatusValueSchema.nullable(),
+	currentPeriodEnd: z.iso.datetime().nullable(),
+	cancelAtPeriodEnd: z.boolean()
+});
+const invoiceResponseSchema = z.object({
+	id: z.uuid(),
+	invoiceNumber: z.string(),
+	kind: z.enum(["invoice", "refund"]),
+	status: z.enum([
+		"draft",
+		"formalized",
+		"cancelled"
+	]),
+	amountGross: z.string(),
+	amountNet: z.string(),
+	amountVat: z.string(),
+	currencyCode: z.string(),
+	vatRate: z.string(),
+	vatExemptionCode: z.string().nullable(),
+	hasPdf: z.boolean(),
+	issuedAt: z.iso.datetime()
+});
+z.object({
+	items: z.array(invoiceResponseSchema),
+	nextCursor: z.string().nullable(),
+	hasMore: z.boolean()
+});
+z.enum(["invoice", "refund"]);
+//#endregion
+//#region packages/contracts/src/companies.ts
+/**
+* Şirket (company) sözleşmeleri (spec §6.2).
+*
+* KRİTİK KURAL: `annualRevenue` PARA alanıdır — string olarak taşınır, hiçbir
+* yerde native `number`'a çevrilip aritmetik yapılmaz (bkz. spec §6.1,
+* `bignumber.js` dışında ASLA hesaplanmaz).
+*
+* [Fix round 2 — doğruluk reviewer'ının bulduğu, Task 3'ün `deals.amount`
+* fix'iyle BİREBİR aynı sınıf hata]: DB kolonu `text`TEN `numeric(18,2)`'ye
+* taşındı (`FIELD_CATALOG.companies.annual_revenue` `sortable`/`filterable`
+* ilan ediyordu ama `text`te `ORDER BY`/`>`/`<` LEXICOGRAPHIC karşılaştırma
+* yapıyordu — bkz. `packages/db/src/schema/companies.ts` dosya başı yorumu,
+* `packages/db/drizzle/0035_companies_annual_revenue_numeric.sql`). Biçim
+* kısıtı `deals.amount` ile AYNI (`./crm.ts` `numericMoneySchema`, DRY).
+*/
+const createCompanyRequestSchema = z.object({
+	name: z.string().trim().min(1, "ad gerekli").max(200, "en fazla 200 karakter olabilir"),
+	domain: z.string().trim().max(255, "en fazla 255 karakter olabilir").optional(),
+	industry: z.string().trim().max(120, "en fazla 120 karakter olabilir").optional(),
+	size: companySizeSchema.optional(),
+	phone: z.string().trim().max(40, "en fazla 40 karakter olabilir").optional(),
+	website: z.url("geçerli bir URL olmalı").max(500, "en fazla 500 karakter olabilir").optional(),
+	address: z.string().trim().max(500, "en fazla 500 karakter olabilir").optional(),
+	city: z.string().trim().max(120, "en fazla 120 karakter olabilir").optional(),
+	country: z.string().trim().max(120, "en fazla 120 karakter olabilir").optional(),
+	/** PARA — bkz. dosya başı KRİTİK KURAL, `numeric(18,2)` ile eşleşen biçim kısıtı */
+	annualRevenue: numericMoneySchema.optional(),
+	linkedinUrl: z.url("geçerli bir URL olmalı").max(500, "en fazla 500 karakter olabilir").optional(),
+	ownerUserId: z.uuid("geçerli bir kullanıcı kimliği olmalı").optional()
+});
+const updateCompanyRequestSchema = createCompanyRequestSchema.partial();
+pagedResponseSchema(z.object({
+	id: z.uuid(),
+	name: z.string(),
+	domain: z.string().nullable(),
+	industry: z.string().nullable(),
+	size: companySizeSchema.nullable(),
+	phone: z.string().nullable(),
+	website: z.string().nullable(),
+	address: z.string().nullable(),
+	city: z.string().nullable(),
+	country: z.string().nullable(),
+	annualRevenue: z.string().nullable(),
+	linkedinUrl: z.string().nullable(),
+	ownerUserId: z.uuid().nullable(),
+	createdAt: z.iso.datetime(),
+	updatedAt: z.iso.datetime()
+}));
+//#endregion
+//#region packages/contracts/src/contacts.ts
+/**
+* Kişi (contact) sözleşmeleri (spec §6.2). `companyId` nullable — bir kişi
+* şirketsiz de var olabilir (bireysel müşteri).
+*/
+const createContactRequestSchema = z.object({
+	firstName: z.string().trim().min(1, "ad gerekli").max(120, "en fazla 120 karakter olabilir"),
+	lastName: z.string().trim().min(1, "soyad gerekli").max(120, "en fazla 120 karakter olabilir"),
+	email: z.email("geçerli bir e-posta adresi olmalı").max(160).optional(),
+	phone: z.string().trim().max(40, "en fazla 40 karakter olabilir").optional(),
+	mobile: z.string().trim().max(40, "en fazla 40 karakter olabilir").optional(),
+	jobTitle: z.string().trim().max(160, "en fazla 160 karakter olabilir").optional(),
+	linkedinUrl: z.url("geçerli bir URL olmalı").max(500, "en fazla 500 karakter olabilir").optional(),
+	avatarUrl: z.url("geçerli bir URL olmalı").max(500, "en fazla 500 karakter olabilir").optional(),
+	city: z.string().trim().max(120, "en fazla 120 karakter olabilir").optional(),
+	country: z.string().trim().max(120, "en fazla 120 karakter olabilir").optional(),
+	ownerUserId: z.uuid("geçerli bir kullanıcı kimliği olmalı").optional(),
+	source: contactSourceSchema.optional(),
+	status: contactStatusSchema.default("lead"),
+	companyId: z.uuid("geçerli bir şirket kimliği olmalı").optional()
+});
+/**
+* [Fix round 1 — Faz 10 Task 3] `status` AÇIKÇA yeniden tanımlanır; düz
+* `.partial()` YETMEZ.
+*
+* ÖLÇÜLEN KUSUR: zod 4'te `.partial()` bir alanı `.optional()` yapar ama
+* `.default()`'unu KALDIRMAZ ⇒ `createContactRequestSchema.partial()`'in
+* `status`'ü hâlâ `.default('lead')` taşıyordu ve
+* `updateContactRequestSchema.parse({ city: 'x' })` → `{ city:'x',
+* status:'lead' }` üretiyordu (canlı ölçüldü). `PATCH /v1/tenants/:id/
+* contacts/:contactId` gövdeyi `validateJson(updateContactRequestSchema)` ile
+* doğrulayıp `.set({ ...body, updatedById })` yazdığı için
+* (`apps/api/src/routes/contacts.ts:314`) `status` GÖNDERMEYEN her kısmi
+* güncelleme, `active`/`inactive` bir kişiyi SESSİZCE `lead`'e geri
+* düşürüyordu — dashboard'ın düzenleme formu `status`'ü her zaman gönderdiği
+* için belirti orada görünmüyordu; kusuru MCP'nin `update_contact` aracı
+* (yalnız verilen alanları gönderir) ortaya çıkardı.
+*
+* KARDEŞ ŞEMALARDA AYNI KUSUR YOK ama gerekçesi TESADÜF: `companies`/
+* `pipelines`'ın create şemalarında `.default()`'lu alan HİÇ YOK,
+* `updateDealRequestSchema` ise `.partial()` DEĞİL elle yazılmış bir şemadır.
+* ⇒ `.default()`'lu bir alan içeren bir create şemasından `.partial()` ile
+* update şeması TÜRETİRKEN o alanı DAİMA açıkça `.optional()` olarak ez.
+*/
+const updateContactRequestSchema = createContactRequestSchema.partial().extend({ status: contactStatusSchema.optional() });
+pagedResponseSchema(z.object({
+	id: z.uuid(),
+	firstName: z.string(),
+	lastName: z.string(),
+	email: z.string().nullable(),
+	phone: z.string().nullable(),
+	mobile: z.string().nullable(),
+	jobTitle: z.string().nullable(),
+	linkedinUrl: z.string().nullable(),
+	avatarUrl: z.string().nullable(),
+	city: z.string().nullable(),
+	country: z.string().nullable(),
+	ownerUserId: z.uuid().nullable(),
+	source: contactSourceSchema.nullable(),
+	status: contactStatusSchema,
+	companyId: z.uuid().nullable(),
+	createdAt: z.iso.datetime(),
+	updatedAt: z.iso.datetime()
+}));
+z.object({
+	code: z.literal("contact_limit_reached"),
+	limit: z.number(),
+	planCode: planCodeSchema
+});
+z.string().regex(/^[A-Z]{3}$/, "geçerli bir 3 harfli para birimi kodu olmalı (örn. TRY)");
+//#endregion
+//#region packages/contracts/src/deals.ts
+/**
+* Fırsat (deal) sözleşmeleri (spec §6.2/§6.4).
+*
+* KRİTİK KURAL: `updateDealRequestSchema` `.strict()`'tir ve `stageId`/
+* `pipelineId`/`position`/`outcome`/`closedAt` alanlarını hiç TANIMLAMAZ —
+* bu alanlar yalnız `moveDealRequestSchema` (`/move` ucu) üzerinden değişir
+* (bkz. `packages/db/src/schema/deals.ts` dosya başı KRİTİK KURAL 2,
+* `apps/api/src/routes/deals.ts`). `.strict()` altında bilinmeyen bir anahtar
+* zod'un `unrecognized_keys` hatasını üretir; bu, `apps/api/src/lib/validate.ts`
+* içindeki `ZOD_DEFAULT_MESSAGE` deseniyle ZATEN eşleşiyor (`Unrecognized key`
+* ile başlar) — bu yüzden ayrı bir Türkçe mesaj GEREKMEZ, jenerik "Geçersiz
+* istek gövdesi" mesajına düşer (bu, Global Constraints #3'ün belgelediği
+* bilinçli istisna).
+*
+* FIX ROUND 1 (bkz. task-3-report.md): `amount` DB'de `numeric(18,2)`'ye
+* taşındı (önceden `text` idi — `sortable`/`filterable` ilan edilmiş bir
+* alanın metin karşılaştırmasıyla sıralanması sessiz bir doğruluk hatasıydı).
+* Biçim kısıtı (yalnız `-?\d+(\.\d{1,2})?`, en fazla 18 anlamlı basamak) ARTIK
+* `./crm.ts`'teki `numericMoneySchema`'da PAYLAŞILIYOR (Fix round 2 —
+* `companies.annual_revenue` AYNI sınıf hatayı taşıdığı için oraya taşındı,
+* bkz. o dosyanın JSDoc'u) — bilimsel gösterim (`1e10`), `NaN`/`Infinity`,
+* çift işaret (`--5`), virgüllü ondalık (`1,5`) ve 2'den fazla ondalık basamak
+* hep REDDEDİLİR. PARA YİNE string olarak taşınır, `bignumber.js` dışında
+* hesaplanmaz.
+*/
+/** ISO 4217 kodu — 3 büyük harf (DB `char(3)` kolonuyla eşleşir) */
+const currencyCodeSchema = z.string().trim().regex(/^[A-Z]{3}$/, "ISO 4217 biçiminde 3 büyük harf olmalı (örn. TRY)");
+/** Fırsat tutarı — DB `numeric(18,2)` ile BİREBİR eşleşen ortak biçim kısıtı (bkz. `crm.ts` `numericMoneySchema`) */
+const dealAmountSchema = numericMoneySchema;
+const createDealRequestSchema = z.object({
+	title: z.string().trim().min(1, "başlık gerekli").max(200, "en fazla 200 karakter olabilir"),
+	pipelineId: z.uuid("geçerli bir pipeline kimliği olmalı"),
+	stageId: z.uuid("geçerli bir aşama kimliği olmalı"),
+	amount: dealAmountSchema.optional(),
+	currencyCode: currencyCodeSchema.default("TRY"),
+	companyId: z.uuid("geçerli bir şirket kimliği olmalı").optional(),
+	primaryContactId: z.uuid("geçerli bir kişi kimliği olmalı").optional(),
+	expectedCloseDate: z.iso.datetime("geçerli bir tarih olmalı").optional(),
+	ownerUserId: z.uuid("geçerli bir kullanıcı kimliği olmalı").optional()
+});
+/**
+* Genel güncelleme — `stageId`/`pipelineId`/`position`/`outcome`/`closedAt`
+* BİLEREK YOK (bkz. dosya başı KRİTİK KURAL). `.strict()`: bu alanlardan biri
+* gönderilirse 400 (bkz. `apps/api/test/deals.test.ts`).
+*/
+const updateDealRequestSchema = z.object({
+	title: z.string().trim().min(1, "başlık gerekli").max(200, "en fazla 200 karakter olabilir").optional(),
+	amount: dealAmountSchema.optional(),
+	currencyCode: currencyCodeSchema.optional(),
+	companyId: z.uuid("geçerli bir şirket kimliği olmalı").optional(),
+	primaryContactId: z.uuid("geçerli bir kişi kimliği olmalı").optional(),
+	expectedCloseDate: z.iso.datetime("geçerli bir tarih olmalı").optional(),
+	ownerUserId: z.uuid("geçerli bir kullanıcı kimliği olmalı").optional(),
+	lostReason: z.string().trim().max(500, "en fazla 500 karakter olabilir").optional()
+}).strict();
+/**
+* Kanban taşıma kontratı (spec §6.4) — pipeline'ın `reorderRequestSchema`'sıyla
+* AYNI komşu şekli (`beforeId`/`afterId`), yalnız `stageId` hedefi eklenir.
+* `pipelineId` YOK: hedef aşamanın pipeline'ı, fırsatın yeni pipeline'ı olarak
+* KABUL EDİLİR (bkz. routes/deals.ts) — istemcinin ayrıca tutarlı bir
+* `pipelineId` göndermesini gerektirmeden çapraz-pipeline taşımaya izin verir.
+*/
+const moveDealRequestSchema = z.object({
+	stageId: z.uuid("geçerli bir aşama kimliği olmalı"),
+	beforeId: z.uuid("geçerli bir kimlik olmalı").optional(),
+	afterId: z.uuid("geçerli bir kimlik olmalı").optional()
+});
+z.object({
+	contactId: z.uuid("geçerli bir kişi kimliği olmalı"),
+	role: z.string().trim().max(80, "en fazla 80 karakter olabilir").optional()
+});
+const dealContactResponseSchema = z.object({
+	contactId: z.uuid(),
+	role: z.string().nullable(),
+	createdAt: z.iso.datetime()
+});
+const dealResponseSchema = z.object({
+	id: z.uuid(),
+	pipelineId: z.uuid(),
+	stageId: z.uuid(),
+	companyId: z.uuid().nullable(),
+	primaryContactId: z.uuid().nullable(),
+	title: z.string(),
+	amount: z.string().nullable(),
+	currencyCode: z.string(),
+	position: z.number(),
+	expectedCloseDate: z.iso.datetime().nullable(),
+	closedAt: z.iso.datetime().nullable(),
+	outcome: dealOutcomeSchema,
+	lostReason: z.string().nullable(),
+	ownerUserId: z.uuid().nullable(),
+	createdAt: z.iso.datetime(),
+	updatedAt: z.iso.datetime()
+});
+dealResponseSchema.extend({ contacts: z.array(dealContactResponseSchema) });
+pagedResponseSchema(dealResponseSchema);
+z.object({
+	email: emailSchema,
+	role: memberRoleSchema
+});
+const inviteStatusSchema = z.enum([
+	"pending",
+	"accepted",
+	"revoked"
+]);
+/** Tenant içi davet listesi satırı — token/hash ASLA yer almaz */
+const inviteResponseSchema = z.object({
+	id: z.uuid(),
+	email: z.string(),
+	role: memberRoleSchema,
+	status: inviteStatusSchema,
+	expiresAt: z.iso.datetime(),
+	createdAt: z.iso.datetime()
+});
+z.object({ invites: z.array(inviteResponseSchema) });
+z.object({
+	tenantName: z.string(),
+	email: z.string(),
+	role: memberRoleSchema,
+	status: inviteStatusSchema,
+	expiresAt: z.iso.datetime()
+});
+z.object({
+	tenantId: z.uuid(),
+	tenantName: z.string(),
+	role: memberRoleSchema
+});
+//#endregion
+//#region packages/contracts/src/legal/company.ts
+const VENNYX_COMPANY = {
+	legalName: "Vennyx Yazılım Danışmanlık A.Ş.",
+	taxOffice: "Uluçınar Vergi Dairesi",
+	taxNumber: "9241072735",
+	tradeRegistryNo: "40690",
+	tradeRegistryCity: "Gebze",
+	mersisNo: "0924107273500001",
+	address: "Muallimköy Mah. Deniz Cad. No: 143/8 - 1.1.C1 Blok - Zemin Kat - Kapı No: Z01 - 41400 Gebze/Kocaeli",
+	kepAddress: "vennyxyazilim@hs01.kep.tr",
+	phone: "+90 (850) 242 8992",
+	website: "https://solicrm.com",
+	legalEmail: "legal@solicrm.com",
+	privacyEmail: "privacy@solicrm.com"
+};
+/** Hukuki belgelerin "Veri Sorumlusu/Sağlayıcı Kimliği" bölümünde tekrar eden paragraf */
+function companyIdentityParagraph(locale) {
+	const c = VENNYX_COMPANY;
+	if (locale === "tr") return `${c.legalName} · ${c.taxOffice} · VN ${c.taxNumber} · ${c.tradeRegistryCity} Ticaret Sicil No ${c.tradeRegistryNo} · MERSİS ${c.mersisNo} · ${c.address}`;
+	return `${c.legalName} · Tax office: ${c.taxOffice} · Tax No: ${c.taxNumber} · Trade Registry No (${c.tradeRegistryCity}): ${c.tradeRegistryNo} · MERSIS: ${c.mersisNo} · ${c.address}, Türkiye`;
+}
+/** İletişim/başvuru bölümünde tekrar eden paragraf */
+function contactParagraph(locale) {
+	const c = VENNYX_COMPANY;
+	if (locale === "tr") return `KEP: ${c.kepAddress} · Tel: ${c.phone} · Hukuki başvurular: ${c.legalEmail} · Gizlilik başvuruları: ${c.privacyEmail}`;
+	return `Registered e-mail (KEP): ${c.kepAddress} · Phone: ${c.phone} · Legal inquiries: ${c.legalEmail} · Privacy inquiries: ${c.privacyEmail}`;
+}
+contactParagraph("tr"), contactParagraph("en");
+companyIdentityParagraph("tr"), contactParagraph("tr"), companyIdentityParagraph("en"), contactParagraph("en");
+companyIdentityParagraph("tr"), contactParagraph("tr"), companyIdentityParagraph("en"), contactParagraph("en");
+companyIdentityParagraph("tr"), contactParagraph("tr"), companyIdentityParagraph("en"), contactParagraph("en");
+companyIdentityParagraph("tr"), contactParagraph("tr"), companyIdentityParagraph("en"), contactParagraph("en");
+contactParagraph("tr"), contactParagraph("en");
+contactParagraph("tr"), contactParagraph("en");
+contactParagraph("tr"), contactParagraph("en");
+companyIdentityParagraph("tr"), contactParagraph("tr"), companyIdentityParagraph("en"), contactParagraph("en");
+//#endregion
+//#region packages/contracts/src/legal/slugs.ts
+/** Spec §10'un tam listesi — 9 belge, sıra `/legal` hub'ının kart sırasıdır */
+const LEGAL_SLUGS = [
+	"terms",
+	"privacy",
+	"cookies",
+	"kvkk",
+	"distance-sales",
+	"refund-policy",
+	"dpa",
+	"subprocessors",
+	"sla"
+];
+//#endregion
+//#region packages/contracts/src/legal/types.ts
+/**
+* `@solicrm/i18n`'in `SupportedLanguage`'ı İLE AYNI kümedir ama BAĞIMSIZ
+* tanımlanır (contracts, i18n'e bağımlı OLMAMALI — katman ihlali). Senkron
+* kalması `test/legal-locale-parity.test.ts` ile mekanik olarak zorlanır.
+*/
+const LEGAL_LOCALES = ["tr", "en"];
+z.object({ documentSlug: z.enum(LEGAL_SLUGS, "geçerli bir belge olmalı") });
+const legalAcceptanceResponseSchema = z.object({
+	id: z.uuid(),
+	documentSlug: z.enum(LEGAL_SLUGS),
+	locale: z.enum(LEGAL_LOCALES),
+	effectiveDate: z.string(),
+	acceptedAt: z.iso.datetime(),
+	isCurrentVersion: z.boolean()
+});
+z.object({ acceptances: z.array(legalAcceptanceResponseSchema) });
+//#endregion
+//#region packages/contracts/src/pipelines.ts
+/**
+* Pipeline + aşama (stage) sözleşmeleri (spec §6.2/§6.4).
+*
+* KRİTİK KURAL: `probability` (yüzde 0-100) PARA DEĞİLDİR — native `number`
+* kabul edilir (bkz. spec §6.1/plan Global Constraints #19, DB kolonu
+* `numeric(5,2)`). `pipelineStageColorSchema`, `common.ts`'teki `hexColorSchema`'yı
+* YENİDEN KULLANIR — spec renk formatı vermiyor, yeni bir renk kataloğu
+* İCAT EDİLMEDİ.
+*/
+const pipelineStageColorSchema = hexColorSchema;
+z.object({
+	name: z.string().trim().min(1, "ad gerekli").max(120, "en fazla 120 karakter olabilir"),
+	isDefault: z.boolean().optional()
+}).partial();
+const pipelineResponseSchema = z.object({
+	id: z.uuid(),
+	name: z.string(),
+	isDefault: z.boolean(),
+	position: z.number(),
+	createdAt: z.iso.datetime(),
+	updatedAt: z.iso.datetime()
+});
+z.object({ pipelines: z.array(pipelineResponseSchema) });
+/**
+* `key`, programatik eşleştirme için kullanılır (ör. `is_won`/`is_lost`
+* kanban kolonunu bulmak) — bu yüzden slug benzeri kısıtlı bir biçim taşır
+* (küçük harf, rakam, alt çizgi).
+*/
+const stageKeySchema = z.string().trim().min(1, "anahtar gerekli").max(60, "en fazla 60 karakter olabilir").regex(/^[a-z][a-z0-9_]*$/, "küçük harf, rakam ve alt çizgi kullanılabilir");
+z.object({
+	key: stageKeySchema,
+	label: z.string().trim().min(1, "etiket gerekli").max(120, "en fazla 120 karakter olabilir"),
+	color: pipelineStageColorSchema.optional(),
+	probability: z.number().min(0, "en az 0 olmalı").max(100, "en fazla 100 olmalı").optional(),
+	isWon: z.boolean().optional(),
+	isLost: z.boolean().optional()
+}).partial();
+const stageResponseSchema = z.object({
+	id: z.uuid(),
+	pipelineId: z.uuid(),
+	key: z.string(),
+	label: z.string(),
+	color: z.string().nullable(),
+	position: z.number(),
+	probability: z.string().nullable(),
+	isWon: z.boolean(),
+	isLost: z.boolean(),
+	createdAt: z.iso.datetime(),
+	updatedAt: z.iso.datetime()
+});
+z.object({ stages: z.array(stageResponseSchema) });
+z.object({
+	beforeId: z.uuid("geçerli bir kimlik olmalı").optional(),
+	afterId: z.uuid("geçerli bir kimlik olmalı").optional()
+});
+//#endregion
+//#region packages/contracts/src/platform.ts
+/**
+* Platform yönetimi sözleşmeleri (spec §5.8) — yalnız Vennyx personeli
+* (`SOLICRM_ADMIN_EMAILS` allowlist'i, bkz. `apps/api/src/lib/platform-admin.ts`)
+* tarafından tüketilir.
+*/
+const platformTenantSummarySchema = z.object({
+	id: z.uuid(),
+	name: z.string(),
+	slug: z.string(),
+	planCode: planCodeSchema,
+	suspendedAt: z.iso.datetime().nullable(),
+	createdAt: z.iso.datetime(),
+	memberCount: z.number().int().nonnegative()
+});
+z.object({ tenants: z.array(platformTenantSummarySchema) });
+z.object({
+	memberCount: z.number().int().nonnegative(),
+	activeApiKeyCount: z.number().int().nonnegative(),
+	pendingInviteCount: z.number().int().nonnegative(),
+	ssoEnabled: z.boolean()
+});
+z.object({ email: z.string() });
+/**
+* `GET /v1/admin/tenants/:id/audit-logs` satırı (Faz 9 Task 2, plan kararı "E").
+*
+* `data` NEDEN `z.unknown()`: `audit_logs.data` şemasız bir jsonb kolonudur —
+* her `writeAudit()` çağrısı kendi eylemine özgü bir şekil yazar (18 dosyada 55
+* çağrı), ortak bir yapı YOKTUR. Burada bir şekil DAYATMAK, bugün geçerli bir
+* denetim satırını yarın şema hatasıyla GÖRÜNMEZ kılardı — denetim kaydı
+* append-only olduğu için o satır bir daha DÜZELTİLEMEZ. Zod v4'te `z.unknown()`
+* anahtarın VARLIĞINI yine zorunlu kılar (ölçüldü: `{}` girdisi `success:false`),
+* yani "alan hiç gelmedi" ile "alan null" ayrımı KORUNUR.
+*
+* KRİTİK — `data` NORMALİZE EDİLMİŞ şekli tanımlar: ham `tx.execute()` yolu bu
+* kolonu jsonb çift-encode kusuru nedeniyle STRING olarak döndürebilir; route
+* katmanı tek bir `JSON.parse` ile bunu geri alır (bkz.
+* `apps/api/src/routes/platform-audit.ts`).
+*/
+const adminAuditLogEntrySchema = z.object({
+	id: z.uuid(),
+	actorEmail: z.string().nullable(),
+	action: z.string(),
+	target: z.string().nullable(),
+	data: z.unknown().nullable(),
+	createdAt: z.iso.datetime()
+});
+z.object({
+	items: z.array(adminAuditLogEntrySchema),
+	nextCursor: z.string().nullable(),
+	hasMore: z.boolean()
+});
+/**
+* Zehirli/çözülmemiş webhook olayı satırı — `GET /v1/admin/webhook-events`
+* (Faz 7 Task 6'nın ürettiği uç, Faz 9 Task 3 tüketicisi).
+*
+* KRİTİK — `payload` BİLİNÇLİ OLARAK YOK: `webhook_events.payload` Whop'un ham
+* gövdesidir (müşteri/ödeme bilgisi taşır, `safeJsonb` kolonu). Bu sözleşme onu
+* TAŞIMAZ ve route katmanı kolonu SELECT bile ETMEZ — operatör ekranı olayı
+* TANIMLAMAYA yeten alanlarla sınırlıdır (kaynak/tür/zaman/hata). Ham gövdeye
+* ihtiyaç duyulursa doğru yer DB erişimidir, bir HTTP yanıtı değil.
+*
+* `error` SERBEST METİNDİR ve route katmanında hassas sayı dizileri (VKN/TCKN/
+* kart benzeri) MASKELENMİŞ olarak gelir — bkz. `apps/api/src/lib/mask-sensitive.ts`.
+*
+* İKİ "çözülmemiş" sınıfı bu üç alandan TÜRETİLİR (bkz. `lib/webhook-health.ts`):
+* `error !== null` ⇒ iş kuralı hatası; `error === null && processedAt === null`
+* ⇒ hiç işlenemedi/sıkıştı.
+*/
+const adminWebhookEventSchema = z.object({
+	id: z.uuid(),
+	source: z.string(),
+	eventType: z.string(),
+	receivedAt: z.iso.datetime(),
+	processedAt: z.iso.datetime().nullable(),
+	error: z.string().nullable()
+});
+z.object({ items: z.array(adminWebhookEventSchema) });
+z.object({ reason: z.string().trim().min(1, "kapatma gerekçesi gerekli").max(1e3, "en fazla 1000 karakter olabilir") });
+z.object({
+	id: z.uuid(),
+	closedAt: z.iso.datetime(),
+	closedReason: z.string(),
+	closedBy: z.string()
+});
+z.object({
+	effective: z.boolean(),
+	source: z.enum(["platform-setting", "env-fallback"]),
+	envFallback: z.boolean(),
+	updatedAt: z.iso.datetime().nullable(),
+	updatedByEmail: z.string().nullable()
+});
+z.object({ enabled: z.boolean("etkin değeri true veya false olmalı") });
+z.object({
+	paymentId: z.uuid(),
+	tenantId: z.uuid(),
+	tenantName: z.string(),
+	whopPaymentId: z.string(),
+	paymentStatus: z.string(),
+	/** `numeric(18,2)` — API'de DAİMA dizge (kesinlik korunur, bkz. CLAUDE.md) */
+	amountGross: z.string(),
+	refundedAmount: z.string(),
+	currencyCode: z.string(),
+	/** `'passed' | 'out_of_band' | 'not_verifiable'` — bant dışı bir ödemeyi iade etmek ÖZEL dikkat ister */
+	amountCheckStatus: z.string(),
+	paidAt: z.iso.datetime().nullable(),
+	invoice: z.object({
+		id: z.uuid(),
+		invoiceNumber: z.string(),
+		status: z.string(),
+		amountGross: z.string(),
+		currencyCode: z.string(),
+		formalizedAt: z.iso.datetime().nullable()
+	}).nullable(),
+	billing: z.object({
+		kind: z.string(),
+		country: z.string(),
+		maskedTaxId: z.string().nullable()
+	}).nullable(),
+	openRefund: z.object({
+		id: z.uuid(),
+		status: z.string(),
+		amountGross: z.string(),
+		attemptCount: z.number().int().nonnegative(),
+		lastAttemptAt: z.iso.datetime().nullable()
+	}).nullable()
+});
+z.object({
+	refundId: z.uuid(),
+	status: z.enum([
+		"pending",
+		"completed",
+		"awaiting_balance",
+		"failed"
+	]),
+	message: z.string()
+});
+const filterLeafSchema = z.object({
+	fieldKey: z.string().trim().min(1, "alan adı gerekli").max(80, "en fazla 80 karakter olabilir"),
+	operand: filterOperandSchema,
+	value: z.unknown()
+});
+const filterGroupSchema = z.lazy(() => z.object({
+	logicalOperator: filterLogicalOperatorSchema,
+	filters: z.array(filterLeafSchema).max(20, "bir grupta en fazla 20 filtre olabilir"),
+	groups: z.array(filterGroupSchema).max(5, "bir grupta en fazla 5 alt grup olabilir")
+}));
+/** Bir filtre grubu ağacının GERÇEK azami derinliğini ölçer (bkz. dosya başı KRİTİK KURAL) */
+function filterGroupDepth(group) {
+	if (group.groups.length === 0) return 1;
+	return 1 + Math.max(...group.groups.map(filterGroupDepth));
+}
+const fieldSelectionSchema = z.object({
+	fieldKey: z.string().trim().min(1, "alan adı gerekli").max(80, "en fazla 80 karakter olabilir"),
+	isVisible: z.boolean().default(true)
+});
+const sortSelectionSchema = z.object({
+	fieldKey: z.string().trim().min(1, "alan adı gerekli").max(80, "en fazla 80 karakter olabilir"),
+	direction: sortDirectionSchema
+});
+/** Derinlik aşımını yakalayan paylaşılan `superRefine` — create/update ŞEMASI ikisi de kullanır */
+function checkFilterGroupDepth(rootFilterGroup, ctx) {
+	if (rootFilterGroup === void 0) return;
+	if (filterGroupDepth(rootFilterGroup) > 5) ctx.addIssue({
+		code: "custom",
+		path: ["rootFilterGroup"],
+		message: `filtre grubu en fazla 5 seviye iç içe olabilir`
+	});
+}
+z.object({
+	name: z.string().trim().min(1, "ad gerekli").max(120, "en fazla 120 karakter olabilir"),
+	icon: z.string().trim().max(60, "en fazla 60 karakter olabilir").optional(),
+	resource: savedViewResourceSchema,
+	layout: savedViewLayoutSchema.default("table"),
+	visibility: savedViewVisibilitySchema.default("private"),
+	groupByFieldKey: z.string().trim().min(1, "alan adı gerekli").max(80, "en fazla 80 karakter olabilir").optional(),
+	isDefault: z.boolean().optional(),
+	fields: z.array(fieldSelectionSchema).max(60, "en fazla 60 kolon olabilir").default([]),
+	sorts: z.array(sortSelectionSchema).max(5, "en fazla 5 sıralama alanı olabilir").default([]),
+	rootFilterGroup: filterGroupSchema.optional()
+}).superRefine((data, ctx) => checkFilterGroupDepth(data.rootFilterGroup, ctx));
+z.object({
+	name: z.string().trim().min(1, "ad gerekli").max(120, "en fazla 120 karakter olabilir").optional(),
+	icon: z.string().trim().max(60, "en fazla 60 karakter olabilir").nullable().optional(),
+	layout: savedViewLayoutSchema.optional(),
+	visibility: savedViewVisibilitySchema.optional(),
+	groupByFieldKey: z.string().trim().min(1, "alan adı gerekli").max(80, "en fazla 80 karakter olabilir").nullable().optional(),
+	isDefault: z.boolean().optional(),
+	fields: z.array(fieldSelectionSchema).max(60, "en fazla 60 kolon olabilir").optional(),
+	sorts: z.array(sortSelectionSchema).max(5, "en fazla 5 sıralama alanı olabilir").optional(),
+	rootFilterGroup: filterGroupSchema.nullable().optional()
+}).strict().superRefine((data, ctx) => {
+	if (data.rootFilterGroup !== null) checkFilterGroupDepth(data.rootFilterGroup, ctx);
+});
+const savedViewFieldResponseSchema = z.object({
+	fieldKey: z.string(),
+	isVisible: z.boolean()
+});
+const savedViewSortResponseSchema = z.object({
+	fieldKey: z.string(),
+	direction: sortDirectionSchema
+});
+z.object({
+	id: z.uuid(),
+	name: z.string(),
+	icon: z.string().nullable(),
+	resource: savedViewResourceSchema,
+	layout: savedViewLayoutSchema,
+	/** Sidebar sırası — `pipelineResponseSchema`/`stageResponseSchema` ile TUTARLILIK için döndürülür (bu fazda bir /reorder ucu YOK, yalnız append-only, bkz. routes/saved-views.ts `nextViewPosition`) */
+	position: z.number(),
+	visibility: savedViewVisibilitySchema,
+	createdById: z.uuid(),
+	groupByFieldKey: z.string().nullable(),
+	isDefault: z.boolean(),
+	fields: z.array(savedViewFieldResponseSchema),
+	sorts: z.array(savedViewSortResponseSchema),
+	rootFilterGroup: filterGroupSchema.nullable(),
+	createdAt: z.iso.datetime(),
+	updatedAt: z.iso.datetime()
+});
+/**
+* Liste ucu (`GET /saved-views`) YANITI — özet şekil, `fields`/`sorts`/
+* `rootFilterGroup` İÇERMEZ (bkz. `apps/api/src/routes/saved-views.ts`
+* KRİTİK KURAL — N+1 önleme: bir tenant'ın TÜM görünümlerini listelerken
+* her biri için 4 ek sorgu (fields/sorts/groups/filters) atmak N+1 olurdu;
+* tam detay yalnız TEKİL görünüm uçlarında (`GET .../saved-views/:viewId`,
+* `POST .../apply`) döner — o uçlarda "N" zaten 1'dir).
+*/
+const savedViewSummaryResponseSchema = z.object({
+	id: z.uuid(),
+	name: z.string(),
+	icon: z.string().nullable(),
+	resource: savedViewResourceSchema,
+	layout: savedViewLayoutSchema,
+	position: z.number(),
+	visibility: savedViewVisibilitySchema,
+	createdById: z.uuid(),
+	isDefault: z.boolean(),
+	createdAt: z.iso.datetime(),
+	updatedAt: z.iso.datetime()
+});
+z.object({ views: z.array(savedViewSummaryResponseSchema) });
+const searchableResourceSchema = z.enum([
+	"contacts",
+	"companies",
+	"deals"
+]);
+const searchResultItemSchema = z.object({
+	id: z.uuid("geçersiz kimlik"),
+	resource: searchableResourceSchema,
+	/** Kaynağın görünen adı — contacts: ad soyad, companies: unvan, deals: başlık */
+	title: z.string(),
+	/** İkincil satır (e-posta / alan adı / tutar) — kolon boşsa `null` */
+	snippet: z.string().nullable()
+});
+z.object({ items: z.array(searchResultItemSchema) });
+const searchQuerySchema = z.object({
+	q: z.string().trim().min(1, "arama metni boş olamaz").max(200, `en fazla 200 karakter olabilir`),
+	limit: z.coerce.number("sayı olmalı").int("tam sayı olmalı").min(1, "en az 1 olmalı").max(50, `en fazla 50 olabilir`).optional(),
+	/**
+	* Aranacak kaynakları daraltır (virgülle ayrılmış). Verilmezse ÜÇÜ de
+	* aranır. Bilinmeyen bir kaynak adı 400 üretir — sessizce yok SAYILMAZ
+	* (fail-closed: "tanımadığım filtreyi görmezden gel" bir fail-open kalıbıdır).
+	*/
+	resources: z.string().transform((raw) => raw.split(",").map((part) => part.trim())).pipe(z.array(searchableResourceSchema).min(1, "en az bir kaynak belirtilmeli")).optional()
+});
+//#endregion
+//#region packages/contracts/src/sso.ts
+/**
+* BYO-SSO tenant bağlantısı sözleşmeleri (spec §5.7).
+*
+* KRİTİK KURAL: `ssoConnectionResponseSchema` `clientSecret`/`clientSecretEncrypted`
+* ALANI TAŞIMAZ — sır listeleme/okuma yanıtlarında ASLA dönmez.
+*/
+const DOMAIN_RE = /^(?!-)[a-z0-9-]{1,63}(?<!-)(\.[a-z0-9-]{1,63})+$/;
+/**
+* Genel (kişisel) e-posta sağlayıcı alan adları — bunlar SSO `emailDomain`
+* olarak KABUL EDİLMEZ (spec'in "gmail.com gibi genel bir alan adını
+* doğrulamaya çalışırsa?" tehdidi — bir tenant bu alan adını doğrulayabilseydi
+* TÜM Gmail kullanıcılarını kendi tenant'ına çekebilirdi). TAM/kapsayıcı bir
+* liste DEĞİLDİR — ileride genişletilebilir bir başlangıç kümesidir (bkz.
+* plan "Belirsiz bırakılan noktalar" #4).
+*
+* Plandaki temel liste (gmail/outlook/yahoo/icloud ailesi ve büyük bölgesel
+* sağlayıcılar) OLDUĞU GİBİ alındı. Task brifinginin "eksik görürsen genişlet"
+* talimatıyla implementasyon anında GENUINE olarak eklenenler (regex her biri
+* AYRI bir alan adı olduğu için kök alan adı listede olsa da eşleşmez):
+* Microsoft'un bölgesel tüketici alan adları (`outlook.co.uk`, `hotmail.co.uk`,
+* `live.co.uk`, `hotmail.fr`, `live.fr`, `hotmail.de`, `live.de` — `outlook.com`/
+* `hotmail.com`/`live.com` zaten listede ama bunlar ayrı TLD'ler) ve büyük ISP
+* webmail'leri (kurumsal alan adı OLMASI beklenmeyen, geniş bireysel kullanıcı
+* tabanına sahip): `comcast.net`/`att.net`/`verizon.net`/`sbcglobal.net` (ABD),
+* `btinternet.com` (İngiltere), `free.fr` (Fransa).
+*/
+const PUBLIC_EMAIL_DOMAINS = /* @__PURE__ */ new Set([
+	"gmail.com",
+	"googlemail.com",
+	"outlook.com",
+	"hotmail.com",
+	"live.com",
+	"msn.com",
+	"yahoo.com",
+	"yahoo.co.uk",
+	"yahoo.fr",
+	"ymail.com",
+	"icloud.com",
+	"me.com",
+	"mac.com",
+	"aol.com",
+	"protonmail.com",
+	"proton.me",
+	"pm.me",
+	"gmx.com",
+	"gmx.de",
+	"gmx.net",
+	"mail.com",
+	"yandex.com",
+	"yandex.ru",
+	"zoho.com",
+	"fastmail.com",
+	"hey.com",
+	"hushmail.com",
+	"tutanota.com",
+	"tuta.io",
+	"inbox.com",
+	"mail.ru",
+	"qq.com",
+	"163.com",
+	"126.com",
+	"naver.com",
+	"daum.net",
+	"web.de",
+	"t-online.de",
+	"orange.fr",
+	"laposte.net",
+	"libero.it",
+	"virgilio.it",
+	"seznam.cz",
+	"wp.pl",
+	"onet.pl",
+	"rocketmail.com",
+	"outlook.co.uk",
+	"hotmail.co.uk",
+	"live.co.uk",
+	"hotmail.fr",
+	"live.fr",
+	"hotmail.de",
+	"live.de",
+	"comcast.net",
+	"att.net",
+	"verizon.net",
+	"sbcglobal.net",
+	"btinternet.com",
+	"free.fr"
+]);
+/**
+* [Fix round 1 — Minor 1, code review bulgusu]: `PUBLIC_EMAIL_DOMAINS.has(value)`
+* yalnız TAM eşleşme kontrol ediyordu — `mail.gmail.com` gibi bir ALT alan adı
+* engeli atlıyordu (canlı doğrulandı: `ACCEPTED` dönüyordu). Pratikte risk
+* düşük (saldırgan gerçek sağlayıcının alt alan DNS'ini kontrol edemez, TXT
+* sahiplik kanıtı hâlâ gerekir) ama kafa karıştırıcı/gereksiz bir açık —
+* engellenen bir kök alan adının HER alt alan adı da (`x.gmail.com`,
+* `a.b.gmail.com` vb.) reddedilir. `value` zaten `.toLowerCase()`'dan SONRA
+* buraya gelir (zincirleme sırası), bu yüzden büyük/küçük harf normalize
+* edilmiş durumda.
+*/
+function isPublicEmailProviderDomain(domain) {
+	if (PUBLIC_EMAIL_DOMAINS.has(domain)) return true;
+	for (const blocked of PUBLIC_EMAIL_DOMAINS) if (domain.endsWith(`.${blocked}`)) return true;
+	return false;
+}
+const ssoEmailDomainSchema = z.string().trim().toLowerCase().max(255, "en fazla 255 karakter olabilir").regex(DOMAIN_RE, "geçerli bir alan adı olmalı (örn. ornek.com)").refine((value) => !isPublicEmailProviderDomain(value), "genel bir e-posta sağlayıcı alan adı SSO için kullanılamaz");
+/**
+* Format kontrolü — prod'da yalnız https zorunluluğu ROUTE katmanında ayrıca
+* uygulanır (bkz. sso-admin.ts, `NODE_ENV==='production'` kontrolü).
+*
+* [Fix round 1 — Minor 2, code review bulgusu]: bu şema ÖNCEDEN
+* `http://127.0.0.1:PORT`'u da (localhost ile AYNI) dev istisnasına
+* sokuyordu, ama `lib/ssrf-guard.ts`'in `assertPublicHttpsUrl`'i yalnız
+* `localhost` HOST ADINI dev-bypass eder — çıplak `127.0.0.1` IP'sini HER
+* ZAMAN reddeder (bkz. o dosyanın KRİTİK KURAL 1 yorumu: kritik güvenlik
+* kuralı "özel IP aralıklarına (…, 127/8, …) gitmemeli" der, istisna YALNIZ
+* `localhost` için tanımlıdır). Sonuç: `http://127.0.0.1:9000` issuer'ıyla
+* bağlantı OLUŞTURULABİLİYORDU (bu şema kabul ediyordu) ama `/test` ucu HER
+* ZAMAN başarısız oluyordu (guard reddediyordu) — güvenlik açığı değil ama
+* kafa karıştırıcı bir tutarsızlık.
+*
+* ÇÖZÜM YÖNÜ — şema DARALTILDI (guard GENİŞLETİLMEDİ): guard'ın davranışı
+* kritik güvenlik kuralının kelimesi kelimesine yazdığı, implementasyon
+* anında canlı test edilip reviewer tarafından bağımsız doğrulanmış bir
+* karardı (bkz. Task 1 raporu) — bunu GEVŞETMEK yerine şemayı guard'a
+* UYDURMAK, sistemin her yerinde AYNI (daha sıkı) kuralı korur. Artık yalnız
+* `http://localhost` (port'lu/portsuz) dev istisnası kabul edilir; çıplak
+* `127.0.0.1` (ve `::1`) issuer olarak asla kabul edilmez — bu ikisi zaten
+* `ssrf-guard.ts`'te de reddediliyordu.
+*/
+const ssoIssuerSchema = z.url("geçerli bir URL olmalı").max(500, "en fazla 500 karakter olabilir").refine((value) => value.startsWith("https://") || /^http:\/\/localhost(:\d+)?(\/|$)/.test(value), "issuer https olmalı (yalnız geliştirmede localhost istisnası var)");
+z.object({
+	issuer: ssoIssuerSchema,
+	clientId: z.string().trim().min(1, "clientId gerekli").max(255, "en fazla 255 karakter olabilir"),
+	clientSecret: z.string().trim().min(1, "clientSecret gerekli").max(2e3, "en fazla 2000 karakter olabilir"),
+	emailDomain: ssoEmailDomainSchema
+});
+z.object({
+	id: z.uuid(),
+	issuer: z.string(),
+	clientId: z.string(),
+	emailDomain: z.string(),
+	domainVerificationToken: z.string(),
+	domainVerified: z.boolean(),
+	enabled: z.boolean(),
+	createdAt: z.iso.datetime(),
+	updatedAt: z.iso.datetime()
+});
+z.object({
+	ok: z.boolean(),
+	reason: z.string().optional()
+});
+z.object({
+	code: z.literal("integration_requires_plan"),
+	requiredPlans: z.array(z.enum(["team", "enterprise"]))
+});
+z.object({
+	ssoAvailable: z.boolean(),
+	tenantId: z.uuid().optional(),
+	tenantName: z.string().optional()
+});
+z.object({ code: z.string().min(1, "code gerekli").max(200, "en fazla 200 karakter olabilir") });
+//#endregion
+//#region packages/mcp/src/config.ts
+/**
+* `npx @vennyx/solicrm-mcp`'nin ortam değişkeninden yapılandırma okuması.
+*
+* KRİTİK KURAL 1 — ZORUNLU DEĞER YOKSA AÇIK HATA, VARSAYILANA DÜŞÜLMEZ.
+* `SOLICRM_API_KEY` ve `SOLICRM_TENANT_ID` ikisi de ZORUNLUDUR ve eksikse
+* süreç net bir Türkçe mesajla ölür. Sessiz bir varsayılan (`''`, `'default'`)
+* ilk araç çağrısında anlaşılmaz bir 401/404'e dönüşürdü — bu projenin beş
+* ayrı yerden çıkmış kusur sınıfı (bkz. kök `CLAUDE.md` "Sessiz kusurlar").
+*
+* KRİTİK KURAL 2 — `SOLICRM_TENANT_ID` NEDEN GEREKLİ. SoliCRM'in URL şeması
+* `/v1/tenants/:tenantId/...`'dir (bkz. `@vennyx/solicrm`'in
+* `TenantScopedResource`) ve API anahtarının hangi tenant'a bağlı olduğunu
+* SÖYLEYEN bir uç YOK — anahtarı çözen tek yer sunucunun kendi
+* `app_resolve_api_key`'idir ve o HTTP'ye açık değildir. Yani istemci URL'i
+* kuramaz. İleride "anahtarımın tenant'ı ne" ucu eklenirse bu env
+* GEREKSİZLEŞİR (barındırılan `POST /mcp` ucu zaten tenant'ı anahtardan
+* çözdüğü için ondan hiçbir env istemez).
+*
+* KRİTİK KURAL 3 — `SOLICRM_SCOPE` BİR GÜVENLİK KAPISI DEĞİLDİR, UX
+* FİLTRESİDİR. Bu değer `tools/list`'in hangi araçları göstereceğini belirler
+* (bkz. `scope.ts` KRİTİK KURAL 3a: "LLM göremediği aracı denemez"). GERÇEK
+* yetki sınırı sunucudadır ve HER istekte yeniden hesaplanır
+* (`ROLE_SCOPE_CEILING[güncel rol] ∩ anahtar kapsamı`,
+* `apps/api/src/lib/crm-access.ts`). Bu yüzden VERİLMEZSE `admin`'e düşer:
+* tüm araçlar kaydedilir, yetkisiz olanı sunucu 403'le reddeder. `read`'e
+* düşmek daha "güvenli" GÖRÜNÜR ama değildir — hiçbir şeyi kapatmaz, yalnız
+* yazma yetkisi OLAN bir anahtarın yazma araçlarını görünmez yapıp
+* kullanıcının teşhis edemeyeceği bir arıza üretir. VERİLİRSE ve geçersizse
+* (`Admin`, `full`, ...) SESSİZCE varsayılana düşülMEZ, açık hata verilir.
+*/
+/** Bkz. KRİTİK KURAL 3 — kapsam verilmediğinde sunucuyu yetkili taraf sayarız */
+const DEFAULT_MCP_SCOPE = "admin";
+function readTrimmed(env, name) {
+	const raw = env[name];
+	if (raw === void 0) return void 0;
+	const trimmed = raw.trim();
+	return trimmed.length === 0 ? void 0 : trimmed;
+}
+function loadConfigFromEnv(env) {
+	const apiKey = readTrimmed(env, "SOLICRM_API_KEY");
+	if (apiKey === void 0) throw new Error("SOLICRM_API_KEY ortam değişkeni zorunludur (dashboard → API anahtarları bölümünden oluşturun).");
+	const tenantId = readTrimmed(env, "SOLICRM_TENANT_ID");
+	if (tenantId === void 0) throw new Error("SOLICRM_TENANT_ID ortam değişkeni zorunludur (dashboard → kiracı ayarlarındaki kiracı kimliği).");
+	const rawScope = readTrimmed(env, "SOLICRM_SCOPE");
+	let scope = DEFAULT_MCP_SCOPE;
+	if (rawScope !== void 0) {
+		const parsed = apiKeyScopeSchema.safeParse(rawScope);
+		if (!parsed.success) throw new Error(`SOLICRM_SCOPE geçersiz: "${rawScope}". Geçerli değerler: read, write, admin (boş bırakılırsa ${DEFAULT_MCP_SCOPE}).`);
+		scope = parsed.data;
+	}
+	return {
+		apiKey,
+		tenantId,
+		baseUrl: readTrimmed(env, "SOLICRM_BASE_URL"),
+		scope
+	};
+}
+//#endregion
+//#region packages/mcp/src/prompts.ts
+function registerSummarizePipelinePrompt(server) {
+	return server.registerPrompt("summarize_pipeline", {
+		title: "Pipeline özeti",
+		description: "Guides an agent through summarising the health of one sales pipeline using the SoliCRM tools.",
+		argsSchema: { pipelineName: z.string().describe("Name of the pipeline to summarise, as shown by list_pipelines") }
+	}, ({ pipelineName }) => ({ messages: [{
+		role: "user",
+		content: {
+			type: "text",
+			text: [
+				`Summarise the health of the SoliCRM pipeline named "${pipelineName}".`,
+				"1. Call list_pipelines and find the pipeline whose name matches; note its id and the ordered stages.",
+				"2. Call list_deals with filters { pipeline_id: \"<that id>\" } and page through with the returned nextCursor until hasMore is false.",
+				"3. Group the deals by stage. For each stage report the count, the summed amount and the oldest deal.",
+				"4. Amounts are decimal STRINGS (numeric(18,2)) — add them with exact decimal arithmetic, never with floating-point math, and keep the currency code with every total.",
+				"5. Close with the two or three stages that look most at risk (largest value sitting in the earliest stages, or deals with the oldest expectedCloseDate)."
+			].join("\n")
+		}
+	}] }));
+}
+//#endregion
+//#region packages/mcp/src/errors.ts
+/**
+* MCP katmanının KENDİ hata sınıfları — sunucudan GELMEYEN, bu paketin
+* ürettiği başarısızlıklar.
+*
+* DİL İSTİSNASI (Global Constraints #8): buradaki mesajlar İngilizce'dir.
+* "Kullanıcıya dönen mesajlar Türkçe" kuralı `apps/api`'nin `jsonError()`
+* zarfı içindir; bu paket global npm tüketicilerine (Claude Code/Desktop) gider
+* ve mesajları bir LLM okur. Sunucudan gelen TÜRKÇE metin ise ÇEVRİLMEZ,
+* `toMcpToolError` onu AYNEN taşır (bkz. `result.ts`).
+*/
+/** Bu paketin ürettiği her hatanın taban sınıfı — tüketici tek `catch` ile kapsar. */
+var SolicrmMcpError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "SolicrmMcpError";
+		Object.setPrototypeOf(this, new.target.prototype);
+	}
+};
+/**
+* Çağıranın etkin kapsamı aracın gerektirdiği minimumun ALTINDA.
+*
+* KRİTİK KURAL — bu hata TEK yetki sınırı DEĞİLDİR, İKİNCİ katmandır. Gerçek
+* yetki kontrolü sunucu tarafındadır: her araç çağrısı SDK üzerinden
+* `/v1/tenants/:id/...` uçlarına gider ve orada
+* `checkApiKeyTenantAndScope` (`apps/api/src/lib/crm-access.ts`) çalışır — o
+* kontrol `effectiveScope`'u (= `ROLE_SCOPE_CEILING[güncel rol] ∩ anahtar
+* kapsamı`) HER istekte DB'den YENİDEN hesaplar. Bu paketteki `scope` ise
+* sunucu kurulurken bir kez alınmış bir ANLIK GÖRÜNTÜDÜR (bkz. `scope.ts`).
+*/
+var McpScopeError = class extends SolicrmMcpError {
+	toolName;
+	requiredScope;
+	actualScope;
+	constructor(params) {
+		super(`Tool "${params.toolName}" requires the "${params.requiredScope}" API key scope, but this key's effective scope is "${params.actualScope}".`);
+		this.name = "McpScopeError";
+		this.toolName = params.toolName;
+		this.requiredScope = params.requiredScope;
+		this.actualScope = params.actualScope;
+	}
+};
+/**
+* Araç girdisi zod şemasını GEÇTİ ama anlamsal olarak tutarsız (ör. sıralama
+* yönü verilmiş, sıralanacak alan verilmemiş).
+*
+* NEDEN AYRI BİR HATA: bu projenin "fail-open savunma savunma değildir"
+* dersinin doğrudan uygulaması — tutarsız girdiyi SESSİZCE yok saymak
+* (`sortDirection`'ı görmezden gelip sırasız sonuç döndürmek) çağırana
+* "istediğin sıralamayı yaptım" yalanını söylerdi.
+*/
+var McpInputError = class extends SolicrmMcpError {
+	constructor(message) {
+		super(message);
+		this.name = "McpInputError";
+	}
+};
+//#endregion
+//#region packages/mcp/src/scope.ts
+/**
+* Araç adı → gereken MİNİMUM coarse kapsam kataloğu, ve iki kapsam katmanının
+* paylaştığı karşılaştırma.
+*
+* KRİTİK KURAL 1 — KATALOG TOTAL, `Record<string, ApiKeyScope>` DEĞİL.
+* `TOOL_MIN_SCOPE`'un anahtarı `McpToolName` literal union'ıdır, bu yüzden
+* `TOOL_MIN_SCOPE[name]` HİÇBİR ZAMAN `undefined` olamaz (`noUncheckedIndexedAccess`
+* altında bile). Plan taslağı `Record<string, ApiKeyScope>` + `if (need !== undefined)`
+* yazıyordu; o biçimde katalogda UNUTULAN bir araç adı `undefined` verir ve kapı
+* SESSİZCE HİÇ UYGULANMAZ — projenin "fail-open savunma savunma değildir"
+* dersinin ta kendisi. Bu biçimde ise yeni bir araç adı eklerken kapsamını
+* yazmamak DERLEME HATASIDIR.
+*
+* KRİTİK KURAL 2 — BU PAKETTEKİ `scope` BİR ANLIK GÖRÜNTÜDÜR, YETKİ SINIRI
+* DEĞİLDİR. `createSolicrmMcpServer(client, scope)` çağrıldığı anda geçerli olan
+* etkin kapsam kapanışta (closure) taşınır; süreç yaşarken YENİDEN
+* HESAPLANMAZ. Gerçek yetki sınırı sunucudadır: her araç çağrısı SDK üzerinden
+* API'ye gider ve `checkApiKeyTenantAndScope` (`apps/api/src/lib/crm-access.ts`)
+* `effectiveScope`'u (= `ROLE_SCOPE_CEILING[güncel rol] ∩ anahtar kapsamı`) HER
+* istekte DB'den yeniden hesaplar — bu yüzden anahtarın sahibi demote edilince
+* ayrı bir iptal job'ı gerekmiyor. Plan Task 3 Step 4'ün "çağrı-anı kontrolü
+* gerekli ÇÜNKÜ stdio süreci uzun ömürlü ve sahibin rolü düşürülebilir"
+* gerekçesi YANLIŞTIR: çağrı-anı kontrolü de AYNI dondurulmuş `scope`'u okur,
+* demote'u göremez. Çağrı-anı kontrolünün GERÇEK değeri aşağıdaki KRİTİK
+* KURAL 3'tür.
+*
+* KRİTİK KURAL 3 — İKİ KATMAN, İKİ AYRI KUSURA KARŞI. (a) Kayıt-anı
+* `.disable()` `tools/list`'i filtreler: LLM göremediği bir aracı denemez
+* (bağlam kirliliği + gereksiz 403 turu yok). (b) Çağrı-anı `assertScope`
+* BİZİM KENDİ REGRESYONUMUZA karşıdır: `server.ts`'in disable döngüsü
+* kaldırılır/yanlış sıraya konursa ya da bir araç kayıt listesine eklenip
+* döngüye girmezse, handler yine reddeder. İkisi bağımsız testlerle sabitlenir.
+*/
+/**
+* Kapsam rütbeleri — `apps/api/src/lib/api-key-auth.ts`'in `SCOPE_RANK`'ıyla
+* BİREBİR aynı. İçe aktarılMAZ çünkü bu paket npm'e yayınlanır ve `apps/api`'ye
+* (Hono, Drizzle, Postgres) bağımlı OLAMAZ. Drift riski TİP SEVİYESİNDE
+* kapatılmıştır: `Record<ApiKeyScope, number>` `@solicrm/contracts`'ın
+* `apiKeyScopeSchema` enum'una bağlıdır ⇒ contracts'a dördüncü bir kapsam
+* eklenirse bu satır DERLENMEZ.
+*/
+const SCOPE_RANK = {
+	read: 0,
+	write: 1,
+	admin: 2
+};
+apiKeyScopeSchema.options;
+const TOOL_MIN_SCOPE = {
+	list_contacts: "read",
+	get_contact: "read",
+	create_contact: "write",
+	update_contact: "write",
+	list_companies: "read",
+	get_company: "read",
+	create_company: "write",
+	update_company: "write",
+	list_deals: "read",
+	get_deal: "read",
+	create_deal: "write",
+	update_deal: "write",
+	move_deal_stage: "write",
+	list_pipelines: "read",
+	list_activities: "read",
+	create_activity: "write",
+	list_tasks: "read",
+	create_task: "write",
+	complete_task: "write",
+	create_note: "write",
+	search: "read",
+	list_saved_views: "read"
+};
+/** `actual`, `required` kapsamını karşılıyor mu (read < write < admin) */
+function scopeSatisfies(actual, required) {
+	return SCOPE_RANK[actual] >= SCOPE_RANK[required];
+}
+/**
+* Çağrı-anı kapsam kapısı — HER araç handler'ının İLK satırı (bkz. KRİTİK
+* KURAL 3/b). Yetersizse fırlatır; `toMcpToolError` bunu `isError: true`
+* sonucuna çevirir.
+*/
+function assertScope(scope, toolName) {
+	const required = TOOL_MIN_SCOPE[toolName];
+	if (!scopeSatisfies(scope, required)) throw new McpScopeError({
+		toolName,
+		requiredScope: required,
+		actualScope: scope
+	});
+}
+//#endregion
+//#region packages/mcp/src/resources.ts
+/** Kaynak → gereken minimum kapsam. `TOOL_MIN_SCOPE` gibi TOTAL (fail-open yok). */
+const RESOURCE_MIN_SCOPE = {
+	contact: "read",
+	deal: "read"
+};
+/** URI şablonu değişkeni tek değer de dizi de olabilir — ilkini alır, yoksa hata. */
+function firstVariable(value, name) {
+	const first = Array.isArray(value) ? value[0] : value;
+	if (first === void 0 || first.length === 0) throw new McpInputError(`Resource URI is missing the "${name}" segment.`);
+	return first;
+}
+function assertResourceScope(scope, name) {
+	const required = RESOURCE_MIN_SCOPE[name];
+	if (!scopeSatisfies(scope, required)) throw new McpInputError(`Resource "${name}" requires the "${required}" API key scope, but this key's effective scope is "${scope}".`);
+}
+function registerCrmResources(server, client, scope) {
+	return [["contact", server.registerResource("contact", new ResourceTemplate("solicrm://contacts/{id}", { list: void 0 }), {
+		title: "SoliCRM kişisi",
+		mimeType: "application/json"
+	}, async (uri, variables) => {
+		assertResourceScope(scope, "contact");
+		const contact = await client.contacts.get(firstVariable(variables.id, "id"));
+		return { contents: [{
+			uri: uri.href,
+			mimeType: "application/json",
+			text: JSON.stringify(contact, null, 2)
+		}] };
+	})], ["deal", server.registerResource("deal", new ResourceTemplate("solicrm://deals/{id}", { list: void 0 }), {
+		title: "SoliCRM fırsatı",
+		mimeType: "application/json"
+	}, async (uri, variables) => {
+		assertResourceScope(scope, "deal");
+		const deal = await client.deals.get(firstVariable(variables.id, "id"));
+		return { contents: [{
+			uri: uri.href,
+			mimeType: "application/json",
+			text: JSON.stringify(deal, null, 2)
+		}] };
+	})]];
+}
+//#endregion
+//#region packages/mcp/src/result.ts
+/** Beklenmeyen (bizim kusurumuz olan) hatalar için TEK jenerik metin. */
+const UNEXPECTED_ERROR_MESSAGE = "An unexpected error occurred while calling the SoliCRM API.";
+/**
+* SDK'nın hata sınıflarının `this.name` değerlerinin KAPALI listesi. Listede
+* OLMAYAN her şey jenerik metne düşer (fail-closed).
+*/
+const SDK_ERROR_NAMES = [
+	"SolicrmError",
+	"SolicrmApiError",
+	"SolicrmResponseError"
+];
+/** Her aracın ORTAK başarı biçimi — veriyi okunabilir (girintili) JSON metne çevirir. */
+function jsonResult(data) {
+	return { content: [{
+		type: "text",
+		text: JSON.stringify(data, null, 2)
+	}] };
+}
+/** Bir hatayı MCP'nin `isError: true` sonucuna çevirir (JSON-RPC hatası DEĞİL). */
+function toMcpToolError(err) {
+	return {
+		isError: true,
+		content: [{
+			type: "text",
+			text: describeError(err)
+		}]
+	};
+}
+/** Ham gövdeyi + status'ü koruyan API hatası okuması; hata bu şekilde değilse `undefined`. */
+function readApiError(err) {
+	if (!(err instanceof Error) || err.name !== "SolicrmApiError") return void 0;
+	if (!("status" in err) || typeof err.status !== "number") return void 0;
+	if (!("body" in err) || !("serverMessage" in err)) return void 0;
+	const serverMessage = err.serverMessage;
+	return {
+		status: err.status,
+		body: err.body,
+		serverMessage: typeof serverMessage === "string" ? serverMessage : void 0,
+		message: err.message
+	};
+}
+function describeError(err) {
+	if (err instanceof SolicrmMcpError) return err.message;
+	const apiError = readApiError(err);
+	if (apiError !== void 0) return JSON.stringify({
+		status: apiError.status,
+		message: apiError.serverMessage ?? apiError.message,
+		body: apiError.body
+	}, null, 2);
+	if (err instanceof Error && SDK_ERROR_NAMES.includes(err.name)) return err.message;
+	return UNEXPECTED_ERROR_MESSAGE;
+}
+//#endregion
+//#region packages/mcp/src/tools/define.ts
+/**
+* Bir araç handler'ını MCP callback'ine çevirir: kapsam kapısı → handler →
+* `jsonResult`; her fırlatma `isError: true` sonucuna dönüşür (JSON-RPC
+* hatasına DEĞİL — LLM hatayı okuyup düzeltebilsin).
+*/
+function guarded(scope, name, handler) {
+	return async (args) => {
+		try {
+			assertScope(scope, name);
+			return jsonResult(await handler(args));
+		} catch (err) {
+			return toMcpToolError(err);
+		}
+	};
+}
+/** Girdi almayan araçlar için (`list_pipelines`) — aynı üç garanti, argümansız. */
+function guardedNoArgs(scope, name, handler) {
+	return async () => {
+		try {
+			assertScope(scope, name);
+			return jsonResult(await handler());
+		} catch (err) {
+			return toMcpToolError(err);
+		}
+	};
+}
+//#endregion
+//#region packages/mcp/src/tools/ids.ts
+/**
+* Araç girdilerindeki kimlik (id) alanlarının TEK tanımı. `@solicrm/contracts`
+* kaynak gövdelerinde `z.uuid('geçerli bir <şey> kimliği olmalı')` kalıbını
+* kullanıyor; yol parametreleri için bir sözleşme şeması YOK (uçlar onları yol
+* segmentinden okur), bu yüzden aynı kalıp burada tek yerde kurulur — 8 araç
+* dosyasında tekrarlanmaz.
+*/
+/** `label` Türkçe okunur bir isimdir ("kişi", "şirket", "fırsat"...) */
+function idField(label) {
+	return z.uuid(`geçerli bir ${label} kimliği olmalı`);
+}
+//#endregion
+//#region packages/mcp/src/tools/activities.ts
+const listActivitiesInputSchema = pageQuerySchema.extend({
+	targetType: targetTypeSchema.optional(),
+	targetId: idField("hedef").optional()
+});
+function toActivityListQuery(args) {
+	if (args.targetType !== void 0 !== (args.targetId !== void 0)) throw new McpInputError("targetType and targetId must be provided together. Send both to filter by a target, or neither to list every activity.");
+	const query = {
+		cursor: args.cursor,
+		limit: args.limit
+	};
+	if (args.targetType !== void 0 && args.targetId !== void 0) query.target = {
+		type: args.targetType,
+		id: args.targetId
+	};
+	return query;
+}
+function registerActivityTools(server, client, scope) {
+	return [["list_activities", server.registerTool("list_activities", {
+		title: "Aktiviteleri listele",
+		description: "Lists activities, cursor-paginated. Pass targetType AND targetId together to see one record’s timeline.",
+		inputSchema: listActivitiesInputSchema
+	}, guarded(scope, "list_activities", (args) => client.activities.list(toActivityListQuery(args))))], ["create_activity", server.registerTool("create_activity", {
+		title: "Aktivite oluştur",
+		description: "Logs an activity (call, meeting, email, note...) against a contact, company or deal. `happensAt` is an ISO 8601 UTC timestamp.",
+		inputSchema: createActivityRequestSchema
+	}, guarded(scope, "create_activity", (args) => client.activities.create(args)))]];
+}
+//#endregion
+//#region packages/mcp/src/list-input.ts
+/**
+* CRM liste araçlarının (`list_contacts`/`list_companies`/`list_deals`/
+* `list_tasks`) PAYLAŞTIĞI girdi şeması ve SDK sorgusuna çevirisi.
+*
+* KRİTİK KURAL 1 — ALAN KATALOĞU KOPYALANMAZ. Geçerli `sortField`/`filters`
+* anahtarları `@solicrm/contracts`'ın `FIELD_CATALOG`'undan ÇALIŞMA ZAMANINDA
+* okunur (araç açıklaması bile oradan üretilir, bkz. `describeCrmListFields`);
+* bu dosyada tek bir alan adı literali YOKTUR. Doğrulamanın kendisi de burada
+* TEKRARLANMAZ — SDK'nın `buildCrmListQuery`'si `resolveField` + `sortable`/
+* `filterable` bayrak kontrolünü zaten yapıyor ve bilinmeyen/uygun olmayan
+* alanda `SolicrmError` fırlatıyor (fail-closed).
+*
+* KRİTİK KURAL 2 — SAYFA SINIRLARI DA KOPYALANMAZ. `cursor`/`limit`
+* `pageQuerySchema`'dan `.extend()` ile MİRAS ALINIR ⇒ `PAGE_MAX_LIMIT`
+* değişirse araç şeması da değişir. `z.coerce.number()`'ın JSON Schema
+* karşılığının `{"type":"integer","minimum":1,"maximum":100}` olduğu canlı
+* ölçüldü — MCP tarafında sorun ÜRETMİYOR.
+*
+* KRİTİK KURAL 3 — `sortDirection` VERİLİP `sortField` VERİLMEZSE SESSİZCE
+* YOK SAYILMAZ, HATA VERİLİR (`McpInputError`). "Tanımadığım/eksik girdiyi
+* görmezden gel" bir fail-open kalıbıdır: çağıran sıralama istediğini sanır,
+* sırasız sonuç alır.
+*
+* KRİTİK KURAL 4 — ALAN ADLARI KANONİK KATALOĞA KARŞI DOĞRULANIR, DESENE
+* KARŞI DEĞİL. İlk uygulama `propertyNames` deseni (`^[a-z][a-z0-9_]*$`)
+* kullanıyor ve JSDoc'u "`__proto__`/`constructor` şema seviyesinde
+* reddedilir" diye İDDİA ediyordu. **Ölçüm bu iddiayı ÇÜRÜTTÜ:** `constructor`
+* deseni SAĞLIYOR (tamamı küçük harf) ⇒ belgelenen koruma YOKTU. Bu, bu
+* deponun "belgelenen koruma hiç çağrılmamış olabilir" kusur sınıfının ta
+* kendisi. Düzeltme: anahtarlar `resolveField(resource, key)` ile doğrulanır;
+* o fonksiyon `Object.hasOwn` allowlist'i olduğu için prototip zincirinden
+* gelen hiçbir ad kolon adına dönüşemez. Bu yüzden şema artık bir FABRİKADIR
+* — kaynağı bilmeden doğrulama yapılamaz.
+*
+* `__proto__` İSTİSNASI, DÜRÜST HÂLİ (ölçüldü): `zod@4.4.3`'ün `z.record`'u
+* `JSON.parse` ile gelen own `__proto__` anahtarını **doğrulamadan SESSİZCE
+* ATAR** — `safeParse` `success: true` döner ama çıktı `{}`'dir, yani anahtar
+* `refine`'a HİÇ ULAŞMAZ. Sonuç güvenlik açısından güvenlidir (anahtar
+* `buildCrmListQuery`'ye ve dolayısıyla SQL'e hiç geçmez) ama bir REDDETME
+* DEĞİL, bir DÜŞÜRMEDİR; `test/list-input.test.ts` bu ayrımı olduğu gibi
+* sabitler. Diğer prototip adları (`constructor`, `hasOwnProperty`,
+* `toString`, `valueOf`, `prototype`) GERÇEKTEN reddedilir.
+*
+* BAYRAK KONTROLÜ BURADA TEKRARLANMAZ: `sortable`/`filterable` denetimi
+* SDK'nın `buildCrmListQuery`'sinde yaşar (TEK sahip). Buradaki kontrol yalnız
+* "bu kaynakta böyle bir alan VAR MI" sorusunu yanıtlar.
+*/
+/**
+* Bir CRM kaynağı için liste aracı girdi şeması. Alan adları o kaynağın
+* `FIELD_CATALOG` girdisine karşı doğrulanır (bkz. KRİTİK KURAL 4).
+*/
+function buildCrmListInputSchema(resource) {
+	const knownField = (key) => resolveField(resource, key) !== void 0;
+	const unknownFieldMessage = `${resource} kaynağında böyle bir alan yok`;
+	return pageQuerySchema.extend({
+		sortField: z.string().trim().refine(knownField, unknownFieldMessage).optional(),
+		sortDirection: sortDirectionSchema.optional(),
+		filters: z.record(z.string().trim().refine(knownField, unknownFieldMessage), z.string().max(500, "en fazla 500 karakter olabilir")).optional()
+	});
+}
+/**
+* Araç girdisini SDK'nın `CrmListQuery`'sine çevirir. `tenantId` DİYE BİR ALAN
+* YOKTUR ve olamaz — tenant her zaman `SolicrmClient`'ın kurulduğu andaki
+* değerdir (bkz. `server.ts` dosya başı).
+*/
+function toCrmListQuery(args) {
+	if (args.sortField === void 0 && args.sortDirection !== void 0) throw new McpInputError("sortDirection was given without sortField. Provide the field to sort by, or omit both.");
+	const query = {
+		cursor: args.cursor,
+		limit: args.limit,
+		filters: args.filters
+	};
+	if (args.sortField !== void 0) query.sort = {
+		field: args.sortField,
+		direction: args.sortDirection ?? "asc"
+	};
+	return query;
+}
+/**
+* Bir kaynağın sıralanabilir/filtrelenebilir alanlarını araç açıklamasına
+* yazılacak metne çevirir — LLM'in geçersiz alan adı denemesini azaltır.
+* Liste `FIELD_CATALOG`'dan ÜRETİLİR, elle yazılmaz.
+*/
+function describeCrmListFields(resource) {
+	const catalog = FIELD_CATALOG[resource];
+	const sortable = [];
+	const filterable = [];
+	for (const [key, def] of Object.entries(catalog)) {
+		if (def.sortable) sortable.push(key);
+		if (def.filterable) filterable.push(key);
+	}
+	return `Sortable fields: ${sortable.join(", ")}. Filterable fields: ${filterable.join(", ")}.`;
+}
+//#endregion
+//#region packages/mcp/src/tools/companies.ts
+const listCompaniesInputSchema = buildCrmListInputSchema("companies");
+const getCompanyInputSchema = z.object({ companyId: idField("şirket") });
+const updateCompanyInputSchema = updateCompanyRequestSchema.extend({ companyId: idField("şirket") });
+function registerCompanyTools(server, client, scope) {
+	return [
+		["list_companies", server.registerTool("list_companies", {
+			title: "Şirketleri listele",
+			description: `Lists companies in the tenant, cursor-paginated. ${describeCrmListFields("companies")}`,
+			inputSchema: listCompaniesInputSchema
+		}, guarded(scope, "list_companies", (args) => client.companies.list(toCrmListQuery(args))))],
+		["get_company", server.registerTool("get_company", {
+			title: "Şirket getir",
+			description: "Fetches a single company by id.",
+			inputSchema: getCompanyInputSchema
+		}, guarded(scope, "get_company", (args) => client.companies.get(args.companyId)))],
+		["create_company", server.registerTool("create_company", {
+			title: "Şirket oluştur",
+			description: "Creates a company. `annualRevenue` is a decimal STRING (e.g. \"1250000.00\"), never a JSON number — the API stores it as numeric(18,2).",
+			inputSchema: createCompanyRequestSchema
+		}, guarded(scope, "create_company", (args) => client.companies.create(args)))],
+		["update_company", server.registerTool("update_company", {
+			title: "Şirketi güncelle",
+			description: "Updates a company. Only the fields you send are changed.",
+			inputSchema: updateCompanyInputSchema
+		}, guarded(scope, "update_company", ({ companyId, ...body }) => client.companies.update(companyId, body)))]
+	];
+}
+//#endregion
+//#region packages/mcp/src/tools/contacts.ts
+const listContactsInputSchema = buildCrmListInputSchema("contacts");
+const getContactInputSchema = z.object({ contactId: idField("kişi") });
+const updateContactInputSchema = updateContactRequestSchema.extend({ contactId: idField("kişi") });
+function registerContactTools(server, client, scope) {
+	return [
+		["list_contacts", server.registerTool("list_contacts", {
+			title: "Kişileri listele",
+			description: `Lists contacts in the tenant, cursor-paginated. ${describeCrmListFields("contacts")}`,
+			inputSchema: listContactsInputSchema
+		}, guarded(scope, "list_contacts", (args) => client.contacts.list(toCrmListQuery(args))))],
+		["get_contact", server.registerTool("get_contact", {
+			title: "Kişi getir",
+			description: "Fetches a single contact by id.",
+			inputSchema: getContactInputSchema
+		}, guarded(scope, "get_contact", (args) => client.contacts.get(args.contactId)))],
+		["create_contact", server.registerTool("create_contact", {
+			title: "Kişi oluştur",
+			description: "Creates a contact. Counts against the tenant plan limit — a 402 result carries the limit and plan code in its body.",
+			inputSchema: createContactRequestSchema
+		}, guarded(scope, "create_contact", (args) => client.contacts.create(args)))],
+		["update_contact", server.registerTool("update_contact", {
+			title: "Kişiyi güncelle",
+			description: "Updates a contact. Only the fields you send are changed.",
+			inputSchema: updateContactInputSchema
+		}, guarded(scope, "update_contact", ({ contactId, ...body }) => client.contacts.update(contactId, body)))]
+	];
+}
+//#endregion
+//#region packages/mcp/src/tools/deals.ts
+const listDealsInputSchema = buildCrmListInputSchema("deals");
+const getDealInputSchema = z.object({ dealId: idField("fırsat") });
+const updateDealInputSchema = updateDealRequestSchema.extend({ dealId: idField("fırsat") });
+const moveDealInputSchema = moveDealRequestSchema.extend({ dealId: idField("fırsat") });
+function registerDealTools(server, client, scope) {
+	return [
+		["list_deals", server.registerTool("list_deals", {
+			title: "Fırsatları listele",
+			description: `Lists deals in the tenant, cursor-paginated. ${describeCrmListFields("deals")}`,
+			inputSchema: listDealsInputSchema
+		}, guarded(scope, "list_deals", (args) => client.deals.list(toCrmListQuery(args))))],
+		["get_deal", server.registerTool("get_deal", {
+			title: "Fırsat getir",
+			description: "Fetches a single deal by id, including its stage and linked contacts.",
+			inputSchema: getDealInputSchema
+		}, guarded(scope, "get_deal", (args) => client.deals.get(args.dealId)))],
+		["create_deal", server.registerTool("create_deal", {
+			title: "Fırsat oluştur",
+			description: "Creates a deal in a pipeline stage. `amount` is a decimal STRING (e.g. \"45000.00\"), never a JSON number. Call list_pipelines first to get valid pipelineId/stageId values.",
+			inputSchema: createDealRequestSchema
+		}, guarded(scope, "create_deal", (args) => client.deals.create(args)))],
+		["update_deal", server.registerTool("update_deal", {
+			title: "Fırsatı güncelle",
+			description: "Updates a deal. Stage/pipeline changes are rejected here by design — use move_deal_stage instead.",
+			inputSchema: updateDealInputSchema
+		}, guarded(scope, "update_deal", ({ dealId, ...body }) => client.deals.update(dealId, body)))],
+		["move_deal_stage", server.registerTool("move_deal_stage", {
+			title: "Fırsatı aşamaya taşı",
+			description: "Moves a deal to another stage (kanban). Optional beforeId/afterId place it between two neighbouring deals; omit both to append.",
+			inputSchema: moveDealInputSchema
+		}, guarded(scope, "move_deal_stage", ({ dealId, ...body }) => client.deals.move(dealId, body)))]
+	];
+}
+//#endregion
+//#region packages/mcp/src/tools/notes.ts
+function registerNoteTools(server, client, scope) {
+	return [["create_note", server.registerTool("create_note", {
+		title: "Not oluştur",
+		description: "Creates a note. `body` is a free-form JSON object (rich text document). NOTE: the note is created unlinked — it will not appear on any contact/company/deal timeline until it is attached, which this MCP server does not expose.",
+		inputSchema: createNoteRequestSchema
+	}, guarded(scope, "create_note", (args) => client.notes.create(args)))]];
+}
+//#endregion
+//#region packages/mcp/src/tools/pipelines.ts
+function registerPipelineTools(server, client, scope) {
+	return [["list_pipelines", server.registerTool("list_pipelines", {
+		title: "Pipeline’ları listele",
+		description: "Lists every pipeline with its ordered stages. Use this to resolve pipelineId/stageId before creating or moving a deal."
+	}, guardedNoArgs(scope, "list_pipelines", () => client.pipelines.list()))]];
+}
+//#endregion
+//#region packages/mcp/src/tools/search.ts
+const searchInputSchema = z.object({
+	q: searchQuerySchema.shape.q,
+	limit: searchQuerySchema.shape.limit,
+	resources: z.array(searchableResourceSchema).min(1, "en az bir kaynak belirtilmeli").optional()
+});
+function toSearchParams(args) {
+	return {
+		q: args.q,
+		limit: args.limit,
+		resources: args.resources
+	};
+}
+function registerSearchTools(server, client, scope) {
+	return [["search", server.registerTool("search", {
+		title: "Çapraz arama",
+		description: "Full-text search across contacts, companies and deals in one call. Returns the best matches only (single page, no cursor). Omit `resources` to search all three.",
+		inputSchema: searchInputSchema
+	}, guarded(scope, "search", (args) => client.search.query(toSearchParams(args))))]];
+}
+//#endregion
+//#region packages/mcp/src/tools/tasks.ts
+const listTasksInputSchema = buildCrmListInputSchema("tasks");
+const completeTaskInputSchema = z.object({ taskId: idField("görev") });
+function registerTaskTools(server, client, scope) {
+	return [
+		["list_tasks", server.registerTool("list_tasks", {
+			title: "Görevleri listele",
+			description: `Lists tasks in the tenant, cursor-paginated. ${describeCrmListFields("tasks")}`,
+			inputSchema: listTasksInputSchema
+		}, guarded(scope, "list_tasks", (args) => client.tasks.list(toCrmListQuery(args))))],
+		["create_task", server.registerTool("create_task", {
+			title: "Görev oluştur",
+			description: "Creates a task. NOTE: the task is created unlinked — it will not appear on any contact/company/deal timeline until it is attached, which this MCP server does not expose. `dueAt` is an ISO 8601 UTC timestamp.",
+			inputSchema: createTaskRequestSchema
+		}, guarded(scope, "create_task", (args) => client.tasks.create(args)))],
+		["complete_task", server.registerTool("complete_task", {
+			title: "Görevi tamamla",
+			description: "Marks a task as completed and returns the updated task.",
+			inputSchema: completeTaskInputSchema
+		}, guarded(scope, "complete_task", (args) => client.tasks.complete(args.taskId)))]
+	];
+}
+//#endregion
+//#region packages/mcp/src/tools/views.ts
+const listSavedViewsInputSchema = z.object({ resource: savedViewResourceSchema.optional() });
+function registerSavedViewTools(server, client, scope) {
+	return [["list_saved_views", server.registerTool("list_saved_views", {
+		title: "Kaydedilmiş görünümleri listele",
+		description: "Lists saved views (the tenant’s stored filter/sort presets) with their fields, sorts and filters. Optionally narrow to one CRM resource.",
+		inputSchema: listSavedViewsInputSchema
+	}, guarded(scope, "list_saved_views", (args) => client.views.list(args)))]];
+}
+//#endregion
+//#region packages/mcp/src/tools/index.ts
+function registerAllTools(server, client, scope) {
+	return [
+		...registerContactTools(server, client, scope),
+		...registerCompanyTools(server, client, scope),
+		...registerDealTools(server, client, scope),
+		...registerPipelineTools(server, client, scope),
+		...registerActivityTools(server, client, scope),
+		...registerTaskTools(server, client, scope),
+		...registerNoteTools(server, client, scope),
+		...registerSearchTools(server, client, scope),
+		...registerSavedViewTools(server, client, scope)
+	];
+}
+//#endregion
+//#region packages/mcp/src/server.ts
+/**
+* SoliCRM ürün MCP sunucusu — 22 araç, 2 kaynak, 1 prompt. TRANSPORT-AGNOSTİK:
+* bu dosya ne HTTP ne stdio bilir; çağıran (Task 4) `server.connect(transport)`
+* ile bir taşımaya bağlar.
+*
+* KRİTİK KURAL 1 — TENANT HER ZAMAN `SolicrmClient`'IN KURULDUĞU ANDAKİ
+* DEĞERDİR, HİÇBİR ARAÇ GİRDİSİNDEN GELMEZ. Bu iddia üç bağımsız mekanizmayla
+* ayakta duruyor ve üçü de ölçülmüş durumda:
+*   (a) Hiçbir araç girdi şemasında `tenantId` alanı TANIMLI DEĞİL, ve
+*       `test/server.test.ts` `tools/list`'in ÜRETTİĞİ JSON Schema'ları
+*       tarayarak bunu her araç için doğruluyor (gelecekte eklenen bir araç da
+*       yakalanır).
+*   (b) MCP SDK girdiyi zod ile ayrıştırır ve zod obje şemaları BİLİNMEYEN
+*       ANAHTARLARI ATAR (canlı ölçüldü: `{firstName, lastName, tenantId:
+*       'ATTACKER-TENANT'}` → handler `{firstName, lastName, status:'lead'}`
+*       görüyor) ⇒ bir LLM `tenantId` uydursa bile handler'a hiç ULAŞMAZ.
+*   (c) Araç handler'ları argümanları SDK'nın `CallOptions` (`{ tenantId }`)
+*       parametresine GEÇİRMEZ — `guarded()`'ın imzası öyle bir kanal
+*       sunmuyor (bkz. `tools/define.ts` KRİTİK KURAL 1).
+* `[H4]` kanıtı `test/tenant-isolation.test.ts`'te: şemaya GEÇİCİ bir
+* `tenantId` alanı eklenip (yani (b) devre dışı bırakılıp) isteğin YİNE
+* client'ın tenant'ına gittiği ölçülüyor.
+*
+* KRİTİK KURAL 2 — STATELESS: her `createSolicrmMcpServer` çağrısı KENDİ
+* kapanışını kurar. Paylaşılan mutable state, modül düzeyi cache veya
+* `reset*()` gerektiren bir singleton YOKTUR ⇒ eşzamanlı isteklerde yarış
+* yapısal olarak imkânsız. Bu pakete cache EKLENMEZ; gerekirse önce
+* "ilk dolum yarışı + hata sonrası zehirlenme" sorularının ikisi de
+* yanıtlanır (bkz. kök `CLAUDE.md` "Yeni cache = iki zorunlu soru").
+*
+* KRİTİK KURAL 3 — KAPSAM İKİ KATMANLIDIR, ama İKİSİ DE SUNUCUNUN YERİNE
+* GEÇMEZ. Ayrıntı ve dürüst sınırlar için bkz. `scope.ts` KRİTİK KURAL 2/3.
+*/
+/** `dist/cli.js`'nin (Task 4) `package.json` okumadan taşıdığı sürüm sabiti. */
+const SOLICRM_MCP_VERSION = "0.1.0";
+const SOLICRM_MCP_SERVER_NAME = "solicrm";
+/**
+* Verilen istemci ve etkin kapsam için TAZE bir `McpServer` kurar.
+*
+* @param client Kurulmuş `SolicrmClient` — `tenantId`'si (ve API anahtarı)
+*   çağıranın kimliğinden gelir; bu fonksiyon onu SORGULAMAZ ve DEĞİŞTİRMEZ.
+* @param scope Çağıranın ŞU ANDAKİ etkin kapsamı (`ROLE_SCOPE_CEILING[rol] ∩
+*   anahtar kapsamı`). Anlık görüntüdür — bkz. `scope.ts` KRİTİK KURAL 2.
+*/
+function createSolicrmMcpServer(client, scope) {
+	const server = new McpServer({
+		name: SOLICRM_MCP_SERVER_NAME,
+		version: SOLICRM_MCP_VERSION
+	});
+	const toolHandles = registerAllTools(server, client, scope);
+	const resourceHandles = registerCrmResources(server, client, scope);
+	registerSummarizePipelinePrompt(server);
+	for (const [name, handle] of toolHandles) if (!scopeSatisfies(scope, TOOL_MIN_SCOPE[name])) handle.disable();
+	for (const [name, handle] of resourceHandles) if (!scopeSatisfies(scope, RESOURCE_MIN_SCOPE[name])) handle.disable();
+	return server;
+}
+const DEFAULT_HTTP_PORT = 3737;
+/** `--http` sunucusunun MCP yolu */
+const MCP_HTTP_PATH = "/mcp";
+const BROWSER_ORIGIN_REJECTED_MESSAGE = "Tarayıcıdan gelen istekler reddedilir (Origin başlığı taşıyor).";
+const METHOD_NOT_ALLOWED_MESSAGE = "Bu uçta yalnız POST desteklenir (stateless MCP).";
+const NOT_FOUND_MESSAGE = `Yalnız POST ${MCP_HTTP_PATH} desteklenir.`;
+function jsonResponse(status, body, headers = {}) {
+	return new Response(JSON.stringify(body), {
+		status,
+		headers: {
+			"content-type": "application/json",
+			...headers
+		}
+	});
+}
+/** Bkz. KRİTİK KURAL 1(b) — saf, tek satırlık, ayrı test edilebilir karar */
+function hasBrowserOrigin(request) {
+	const origin = request.headers.get("origin");
+	return origin !== null && origin.trim().length > 0;
+}
+/**
+* `Request → Response`. Port açmaz, soket kurmaz ⇒ testte doğrudan çağrılır.
+* Protokol hataları JSON-RPC zarfıyla transport'tan gelir; BU katmanın kendi
+* redleri (405/404/403) `{error}` zarfını kullanır — hosted uçtaki AYNI ayrım
+* (bkz. `apps/api/src/routes/mcp.ts` KRİTİK KURAL 5).
+*/
+function createMcpHttpHandler(deps) {
+	return async (request) => {
+		if (hasBrowserOrigin(request)) return jsonResponse(403, { error: BROWSER_ORIGIN_REJECTED_MESSAGE });
+		const { pathname } = new URL(request.url);
+		if (pathname !== "/mcp") return jsonResponse(404, { error: NOT_FOUND_MESSAGE });
+		if (request.method !== "POST") return jsonResponse(405, { error: METHOD_NOT_ALLOWED_MESSAGE }, { Allow: "POST" });
+		const server = deps.createServer();
+		const transport = new WebStandardStreamableHTTPServerTransport({ enableJsonResponse: true });
+		await server.connect(transport);
+		return await transport.handleRequest(request);
+	};
+}
+/**
+* `node:http` yapıştırıcısı — Node ve Bun'da AYNI şekilde çalışır (`Bun.serve`
+* kullanılmadı: paket npm'e yayınlanıyor ve `npx` altında Node ile koşuyor).
+*/
+async function startMcpHttpServer(options) {
+	const { createServer } = await import("node:http");
+	const host = options.host ?? "127.0.0.1";
+	const port = options.port ?? 3737;
+	const server = createServer((req, res) => {
+		(async () => {
+			try {
+				const chunks = [];
+				for await (const chunk of req) chunks.push(typeof chunk === "string" ? new TextEncoder().encode(chunk) : chunk);
+				const method = req.method ?? "GET";
+				const headers = new Headers();
+				for (const [key, value] of Object.entries(req.headers)) if (typeof value === "string") headers.set(key, value);
+				else if (Array.isArray(value)) for (const item of value) headers.append(key, item);
+				const hasBody = method !== "GET" && method !== "HEAD" && chunks.length > 0;
+				const request = new Request(`http://${host}:${port}${req.url ?? "/"}`, {
+					method,
+					headers,
+					...hasBody ? { body: Buffer.concat(chunks) } : {}
+				});
+				for (const [key, value] of headers) request.headers.set(key, value);
+				const response = await options.handler(request);
+				const outHeaders = {};
+				response.headers.forEach((value, key) => {
+					outHeaders[key] = value;
+				});
+				res.writeHead(response.status, outHeaders);
+				res.end(response.body === null ? void 0 : Buffer.from(await response.arrayBuffer()));
+			} catch (error) {
+				console.error("solicrm-mcp http isteği başarısız:", error);
+				if (!res.headersSent) res.writeHead(500, { "content-type": "application/json" });
+				res.end(JSON.stringify({ error: "Sunucu hatası" }));
+			}
+		})();
+	});
+	await new Promise((resolve, reject) => {
+		server.once("error", reject);
+		server.listen(port, host, () => {
+			server.removeListener("error", reject);
+			resolve();
+		});
+	});
+	const address = server.address();
+	return {
+		host,
+		port: typeof address === "object" && address !== null ? address.port : port,
+		close: () => new Promise((resolve, reject) => {
+			server.close((err) => err === void 0 || err === null ? resolve() : reject(err));
+		})
+	};
+}
+//#endregion
+//#region packages/mcp/src/transports/stdio.ts
+async function connectStdioTransport(server) {
+	const transport = new StdioServerTransport();
+	await server.connect(transport);
+	return transport;
+}
+//#endregion
+//#region packages/mcp/src/cli.ts
+const PORT_PATTERN = /^[0-9]+$/;
+const USAGE = `solicrm-mcp — SoliCRM MCP sunucusu (v${SOLICRM_MCP_VERSION})
+
+Kullanım:
+  solicrm-mcp                 stdio taşımasıyla başlar (varsayılan)
+  solicrm-mcp --http [port]   bağımsız Streamable HTTP sunucusu (varsayılan port ${DEFAULT_HTTP_PORT})
+  solicrm-mcp --help          bu metni yazar
+  solicrm-mcp --version       sürümü yazar
+
+Ortam değişkenleri:
+  SOLICRM_API_KEY    (zorunlu) scrm_ ile başlayan tenant API anahtarı
+  SOLICRM_TENANT_ID  (zorunlu) kiracı kimliği (UUID)
+  SOLICRM_BASE_URL   (opsiyonel) API tabanı; verilmezse https://api.solicrm.com
+  SOLICRM_SCOPE      (opsiyonel) read|write|admin — yalnız tools/list filtresi,
+                     gerçek yetki sunucuda her istekte yeniden hesaplanır`;
+/** Bkz. KRİTİK KURAL 3 */
+function parsePort(raw) {
+	if (!PORT_PATTERN.test(raw)) throw new Error(`--http için geçersiz port: "${raw}". 1–65535 arası bir tam sayı bekleniyor.`);
+	const port = Number.parseInt(raw, 10);
+	if (port < 1 || port > 65535) throw new Error(`--http için geçersiz port: "${raw}". 1–65535 arası bir tam sayı bekleniyor.`);
+	return port;
+}
+function parseCliArgs(argv) {
+	let transport = "stdio";
+	let port;
+	let help = false;
+	let version = false;
+	for (let i = 0; i < argv.length; i += 1) {
+		const arg = argv[i];
+		if (arg === void 0) continue;
+		if (arg === "--help" || arg === "-h") {
+			help = true;
+			continue;
+		}
+		if (arg === "--version" || arg === "-v") {
+			version = true;
+			continue;
+		}
+		if (arg === "--http") {
+			transport = "http";
+			const next = argv[i + 1];
+			if (next !== void 0 && !next.startsWith("-")) {
+				port = parsePort(next);
+				i += 1;
+			}
+			continue;
+		}
+		if (arg.startsWith("--http=")) {
+			transport = "http";
+			port = parsePort(arg.slice(7));
+			continue;
+		}
+		throw new Error(`Bilinmeyen argüman: "${arg}". Kullanım için --help.`);
+	}
+	return {
+		transport,
+		port,
+		help,
+		version
+	};
+}
+/**
+* `@vennyx/solicrm`'i ÇALIŞMA ZAMANINDA import eder. `await import(...)`
+* BİLİNÇLİ: modül düzeyinde statik bir import, `--help`/`--version` gibi
+* SDK'ya hiç ihtiyaç duymayan yolları da SDK'nın yüklenmesine bağlardı.
+*/
+async function createRealClient(config) {
+	const { SolicrmClient } = await import("@vennyx/solicrm");
+	return new SolicrmClient({
+		apiKey: config.apiKey,
+		tenantId: config.tenantId,
+		baseUrl: config.baseUrl
+	});
+}
+async function runCli(argv, deps = {}) {
+	const log = deps.log ?? ((message) => console.error(message));
+	const args = parseCliArgs(argv);
+	if (args.help) {
+		log(USAGE);
+		return;
+	}
+	if (args.version) {
+		log(SOLICRM_MCP_VERSION);
+		return;
+	}
+	const config = (deps.loadConfig ?? loadConfigFromEnv)(deps.env ?? process.env);
+	const createClient = deps.createClient;
+	const client = createClient === void 0 ? await createRealClient(config) : createClient(config);
+	const createServer = deps.createServer ?? createSolicrmMcpServer;
+	if (args.transport === "http") {
+		const running = await (deps.startHttp ?? (async ({ handler, port }) => await startMcpHttpServer({
+			handler,
+			port
+		})))({
+			handler: createMcpHttpHandler({ createServer: () => createServer(client, config.scope) }),
+			port: args.port
+		});
+		log(`solicrm-mcp HTTP dinliyor: http://${running.host}:${running.port}${MCP_HTTP_PATH}`);
+		return;
+	}
+	await (deps.connectStdio ?? connectStdioTransport)(createServer(client, config.scope));
+	log("solicrm-mcp stdio taşımasında hazır.");
+}
+//#endregion
+//#region packages/mcp/src/bin.ts
+/**
+* `solicrm-mcp` çalıştırılabilir girişi — `package.json`'ın `bin` alanı buraya
+* (`dist/bin.js`) işaret eder.
+*
+* KRİTİK KURAL — BURADA `import.meta.main` GİBİ BİR GUARD YOKTUR ve olmamalı.
+* Bu dosya YALNIZ giriş noktası olarak çalışır (hiçbir modül onu import
+* etmez), dolayısıyla guard'ın koruyacağı bir durum yok. Ayrıca
+* `import.meta.main` Bun'da her dosya için tanımlıdır ama Node'da yalnız çok
+* yeni sürümlerde vardır ⇒ `npx` altında (Node) kalıcı `undefined` olur ve
+* guard'lı bir sürüm SESSİZCE HİÇ ÇALIŞMAZDI. Tüm mantık `cli.ts`'te ve orada
+* test ediliyor; bu dosya bilinçli olarak dallanmasız tutuluyor.
+*
+* Hata yolu: `runCli` fırlatırsa mesaj `stderr`'a yazılır (stdout PROTOKOL
+* kanalıdır) ve çıkış kodu 1 olur — sessizce 0 dönmek, istemciye "sunucu
+* başladı" yalanını söylerdi.
+*/
+runCli(process.argv.slice(2)).catch((error) => {
+	console.error(error instanceof Error ? error.message : String(error));
+	process.exit(1);
+});
+//#endregion
+export {};