node-autotask 0.20.0 → 0.23.0

package/dist/{chunk-XSYJB4IW.js → chunk-PVUUOM5G.js}

@@ -7,6 +7,8 @@ import {
   EMPTY_REASON_STAMPS,
   FETCH_BY_IDS_CHUNK_SIZE,
   FETCH_BY_IDS_MAX_ITEMS,
+  MODEL_FIELD_SETS,
+  MoveRefusedError,
   NotFoundError,
   RELATIONSHIP_MAP,
   ResolutionError,
@@ -18,10 +20,12 @@ import {
   blindStampFor,
   buildDryRunResult,
   buildFilter,
+  buildUiLink,
   clampPageSize,
   createNamePlan,
   cursorToPath,
   decodeFileData,
+  formatUnknownNameList,
   formatVendorDetail,
   isAutotaskError,
   mergeDetails,
@@ -34,10 +38,10 @@ import {
   unwrapItem,
   unwrapItems,
   unwrapOperation
-} from "./chunk-GA6UCX3Z.js";
+} from "./chunk-B5SNZ3TZ.js";
 import {
   CAPABILITIES
-} from "./chunk-2T77J2ZM.js";
+} from "./chunk-OGNUI3UR.js";
 
 // src/resources/appointments.ts
 var AppointmentsResource = class extends BaseResource {
@@ -826,7 +830,76 @@ var ClassificationIconsResource = class extends BaseResource {
   }
 };
 
-// src/resources/special/companies.ts
+// src/resources/special/_shared/dates.ts
+var DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+function isDateYMD(v) {
+  return typeof v === "string" && DATE_RE.test(v) && !Number.isNaN(Date.parse(v));
+}
+function monthsInWindow(dateFrom, dateTo) {
+  const a = `${dateFrom.slice(0, 7)}`;
+  const b = `${dateTo.slice(0, 7)}`;
+  if (a > b) return 0;
+  const ay = Number(a.slice(0, 4));
+  const am = Number(a.slice(5, 7));
+  const by = Number(b.slice(0, 4));
+  const bm = Number(b.slice(5, 7));
+  return (by - ay) * 12 + (bm - am) + 1;
+}
+function monthsBetween(dateFrom, dateTo) {
+  const out = [];
+  let y = Number(dateFrom.slice(0, 4));
+  let m = Number(dateFrom.slice(5, 7));
+  const end = dateTo.slice(0, 7);
+  for (; ; ) {
+    const tag = `${y}-${String(m).padStart(2, "0")}`;
+    out.push(tag);
+    if (tag === end) break;
+    m += 1;
+    if (m === 13) {
+      m = 1;
+      y += 1;
+    }
+    if (out.length > 500) break;
+  }
+  return out;
+}
+function dayAfter(date) {
+  return new Date(Date.parse(date) + 864e5).toISOString().slice(0, 10);
+}
+function monthBounds(month, dateFrom, dateTo) {
+  const y = Number(month.slice(0, 4));
+  const m = Number(month.slice(5, 7));
+  const first = `${month}-01`;
+  const nextFirst = new Date(Date.UTC(y, m, 1)).toISOString().slice(0, 10);
+  const toExcl = dayAfter(dateTo);
+  return {
+    start: first > dateFrom ? first : dateFrom,
+    endExclusive: nextFirst < toExcl ? nextFirst : toExcl
+  };
+}
+
+// src/resources/special/_shared/numbers.ts
+function num(v) {
+  return typeof v === "number" && Number.isFinite(v) ? v : 0;
+}
+
+// src/resources/special/_shared/bounded-part.ts
+async function boundedPart(http, path, conditions, limit, operation, includeFields) {
+  const body = { MaxRecords: limit, filter: conditions };
+  if (includeFields !== void 0) body.IncludeFields = includeFields;
+  const res = await http.request({
+    method: "POST",
+    idempotent: true,
+    path,
+    body,
+    operation
+  });
+  const { items, pageDetails } = unwrapItems(res, operation);
+  const capped = items.length >= limit;
+  return { items, capped, hasMore: capped && pageDetails.nextPageUrl != null };
+}
+
+// src/resources/special/companies/shared.ts
 var DEFAULT_LIMIT2 = 25;
 var MAX_LIMIT2 = 500;
 function clampLimit(limit) {
@@ -834,6 +907,8 @@ function clampLimit(limit) {
   if (!Number.isInteger(n) || n < 1) throw new AutotaskConfigError(`limit must be an integer >= 1 (got ${String(limit)})`);
   return Math.min(n, MAX_LIMIT2);
 }
+
+// src/resources/special/companies/search.ts
 async function queryCompanies(http, filter, limit) {
   const res = await http.request({
     method: "POST",
@@ -854,9 +929,9 @@ async function queryContacts(http, filter, limit) {
   });
   return unwrapItems(res).items;
 }
-async function fetchCompanies(http, ids, limit) {
+async function fetchCompanies(http, ids2, limit) {
   const out = [];
-  for (const id of ids.slice(0, limit)) {
+  for (const id of ids2.slice(0, limit)) {
     try {
       const res = await http.request({
         method: "GET",
@@ -881,8 +956,8 @@ async function searchByDomain(_resource, domain, opts = {}, http) {
   const direct = await queryCompanies(http, filter, limit);
   if (direct.length > 0) return direct;
   const contacts = await queryContacts(http, [{ field: "emailAddress", op: "contains", value: text }], limit);
-  const ids = [...new Set(contacts.map((c) => c.companyID).filter((id) => typeof id === "number" && id >= 0))];
-  return fetchCompanies(http, ids, limit);
+  const ids2 = [...new Set(contacts.map((c) => c.companyID).filter((id) => typeof id === "number" && id >= 0))];
+  return fetchCompanies(http, ids2, limit);
 }
 async function searchByIdentity(_resource, identity, opts = {}, http) {
   const name = identity.companyName?.trim() ?? "";
@@ -901,11 +976,13 @@ async function searchByIdentity(_resource, identity, opts = {}, http) {
   if (name !== "") add(await queryCompanies(http, [{ field: "companyName", op: "contains", value: name }], limit));
   if (email !== "") {
     const contacts = await queryContacts(http, [{ field: "emailAddress", op: "contains", value: email }], limit);
-    const ids = [...new Set(contacts.map((c) => c.companyID).filter((id) => typeof id === "number" && id >= 0))];
-    add(await fetchCompanies(http, ids, limit));
+    const ids2 = [...new Set(contacts.map((c) => c.companyID).filter((id) => typeof id === "number" && id >= 0))];
+    add(await fetchCompanies(http, ids2, limit));
   }
   return [...found.values()].slice(0, limit);
 }
+
+// src/resources/special/companies/family.ts
 var COMPANIES_FAMILY_CHILD_CAP = 50;
 var COMPANIES_FAMILY_BLIND_NOTE = "the family is reported as SEEN BY THIS API USER, never as complete: childIDs (and the search hits themselves) are scoped to the caller-visible enumeration (companies.query is the plan-pinned unowned-blind surface \u2014 get is the authority)";
 var COMPANY_SEARCH_OPT_KEYS = ["limit", "includeFamily"];
@@ -984,12 +1061,8 @@ async function searchWithFamily(_resource, query, opts = {}, http) {
   }
   return rows;
 }
-var OP_UPSERT_NAME = "companies.upsertByName";
-var UPSERT_NAME_MAX_DISCOVERY_MERGES = 3;
-var DEFAULT_COMPANY_TYPE = 1;
-var DEDUP_NAME_LIMIT = 10;
-var BLIND_SURFACE_CAVEAT = "dedup only covers companies this API user can enumerate (the unowned surface is blind); a same-name company outside that scope is not detected";
-var SAFE_COMPANY_CREATE_DEFAULTS = {};
+
+// src/resources/special/companies/errors.ts
 var OwnerResourceRequiredError = class extends AutotaskError {
   constructor(message, options = {}) {
     super(message, {
@@ -1016,7 +1089,15 @@ var CompanyCreateFailedError = class extends AutotaskError {
     this.vendorFields = vendorFields;
   }
 };
-async function upsertByName(resource, companyName, params, opts, http) {
+
+// src/resources/special/companies/upsertByName.ts
+var OP_UPSERT_NAME = "companies.upsertByName";
+var UPSERT_NAME_MAX_DISCOVERY_MERGES = 3;
+var DEFAULT_COMPANY_TYPE = 1;
+var DEDUP_NAME_LIMIT = 10;
+var BLIND_SURFACE_CAVEAT = "dedup only covers companies this API user can enumerate (the unowned surface is blind); a same-name company outside that scope is not detected";
+var SAFE_COMPANY_CREATE_DEFAULTS = {};
+function validateUpsertInput(companyName, params) {
   if (typeof companyName !== "string" || companyName.trim() === "") {
     throw new AutotaskConfigError("upsertByName: companyName is required (a non-empty string)", { operation: OP_UPSERT_NAME });
   }
@@ -1031,73 +1112,53 @@ async function upsertByName(resource, companyName, params, opts, http) {
   if (owner !== void 0 && (typeof owner !== "number" || !Number.isSafeInteger(owner) || owner < 1)) {
     throw new AutotaskConfigError(`upsertByName: params.ownerResourceID must be a positive integer (got ${String(owner)})`, { operation: OP_UPSERT_NAME });
   }
-  const q = await resource.queryBounded({ filter: [{ field: "companyName", op: "eq", value: companyName }], limit: DEDUP_NAME_LIMIT });
-  const caveat = {
-    companies: true,
-    caveat: BLIND_SURFACE_CAVEAT,
-    ...q.blindSurface !== void 0 ? { sentinel: q.blindSurface } : {}
-  };
-  const match = q.items[0];
-  if (match !== void 0) {
-    if (opts.dryRun === true) {
-      return buildDryRunResult(
-        {
-          operation: OP_UPSERT_NAME,
-          method: "POST",
-          path: "/V1.0/Companies",
-          ids: [Number(match.id)],
-          checks: [
-            { name: "input-validation", ok: true },
-            { name: "duplicate-detection", ok: true }
-          ],
-          impact: { affected: 0, scope: "no write \u2014 the company already exists (dedup match; the create is skipped)", reversible: true },
-          warnings: [`EXISTS: company '${companyName}' already exists (id ${Number(match.id)}) \u2014 the apply would skip the create (zero mutating wire).`],
-          data: { reason: "EXISTS", id: Number(match.id) }
-        },
-        { redactPersonalData: http.redactPersonalData }
-      );
-    }
-    return { id: Number(match.id), created: false, existing: match, blindSurface: caveat };
-  }
-  const body = {
-    companyName,
-    companyType,
-    phone: params.phone,
-    isActive: true,
-    ...owner !== void 0 ? { ownerResourceID: owner } : {}
-  };
-  if (opts.dryRun === true) {
-    const warnings = [
-      `the vendor auto-creates a "Primary Address" location under the new company (V5 \u2014 UI-only cleanup; the delete 405 gap)`
-    ];
-    if (owner === void 0) {
-      warnings.push(
-        "ownerResourceID is REQUIRED on the apply path (the vendor requires it; the node cannot enumerate candidates \u2014 the resources table is blind to this API user (count/query return 0)): the apply throws the typed OWNER_RESOURCE_REQUIRED if it is still absent"
-      );
-    }
-    return buildDryRunResult(
-      {
-        operation: OP_UPSERT_NAME,
-        method: "POST",
-        path: "/V1.0/Companies",
-        ids: [],
-        checks: [
-          { name: "input-validation", ok: true },
-          { name: "duplicate-detection", ok: true }
-        ],
-        impact: { affected: 2, scope: "company + the vendor auto-created Primary Address location", reversible: false },
-        warnings,
-        data: body
-      },
-      { redactPersonalData: http.redactPersonalData }
-    );
-  }
+  return { companyType, owner };
+}
+function existsDryRun(http, companyName, match) {
+  return buildDryRunResult(
+    {
+      operation: OP_UPSERT_NAME,
+      method: "POST",
+      path: "/V1.0/Companies",
+      ids: [Number(match.id)],
+      checks: [
+        { name: "input-validation", ok: true },
+        { name: "duplicate-detection", ok: true }
+      ],
+      impact: { affected: 0, scope: "no write \u2014 the company already exists (dedup match; the create is skipped)", reversible: true },
+      warnings: [`EXISTS: company '${companyName}' already exists (id ${Number(match.id)}) \u2014 the apply would skip the create (zero mutating wire).`],
+      data: { reason: "EXISTS", id: Number(match.id) }
+    },
+    { redactPersonalData: http.redactPersonalData }
+  );
+}
+function createDryRun(http, body, owner) {
+  const warnings = [
+    `the vendor auto-creates a "Primary Address" location under the new company (V5 \u2014 UI-only cleanup; the delete 405 gap)`
+  ];
   if (owner === void 0) {
-    throw new OwnerResourceRequiredError(
-      `upsertByName: no company '${companyName}' is enumerable to this API user (the dedup query returned nothing \u2014 a miss is NOT proof of absence: the unowned surface is blind) and the create path requires ownerResourceID \u2014 companies.create requires ownerResourceID = an active non-API-only resource id; the resources table is blind to this API user (count/query return 0)`,
-      { operation: OP_UPSERT_NAME }
+    warnings.push(
+      "ownerResourceID is REQUIRED on the apply path (the vendor requires it; the node cannot enumerate candidates \u2014 the resources table is blind to this API user (count/query return 0)): the apply throws the typed OWNER_RESOURCE_REQUIRED if it is still absent"
     );
   }
+  return buildDryRunResult(
+    {
+      operation: OP_UPSERT_NAME,
+      method: "POST",
+      path: "/V1.0/Companies",
+      ids: [],
+      checks: [
+        { name: "input-validation", ok: true },
+        { name: "duplicate-detection", ok: true }
+      ],
+      impact: { affected: 2, scope: "company + the vendor auto-created Primary Address location", reversible: false },
+      warnings,
+      data: body
+    },
+    { redactPersonalData: http.redactPersonalData }
+  );
+}
+async function precheckOwner(http, owner) {
   const ownerRes = await http.request({ method: "GET", path: `/V1.0/Resources/${owner}`, operation: OP_UPSERT_NAME });
   const ownerBody = ownerRes;
   if (ownerBody === null || !("item" in ownerBody) || ownerBody.item === null || ownerBody.item === void 0) {
@@ -1112,6 +1173,8 @@ async function upsertByName(resource, companyName, params, opts, http) {
       { resourceIds: [owner], details: { idRefs: [{ entity: "resource", id: owner }] }, operation: OP_UPSERT_NAME, suggestedAction: "Activate the resource or pass an active non-API-only one." }
     );
   }
+}
+async function createWithDiscovery(resource, body, owner, caveat, opts) {
   let merges = 0;
   for (; ; ) {
     try {
@@ -1153,8 +1216,89 @@ async function upsertByName(resource, companyName, params, opts, http) {
     }
   }
 }
+async function upsertByName(resource, companyName, params, opts, http) {
+  const { companyType, owner } = validateUpsertInput(companyName, params);
+  const q = await resource.queryBounded({ filter: [{ field: "companyName", op: "eq", value: companyName }], limit: DEDUP_NAME_LIMIT });
+  const caveat = {
+    companies: true,
+    caveat: BLIND_SURFACE_CAVEAT,
+    ...q.blindSurface !== void 0 ? { sentinel: q.blindSurface } : {}
+  };
+  const match = q.items[0];
+  if (match !== void 0) {
+    if (opts.dryRun === true) return existsDryRun(http, companyName, match);
+    return { id: Number(match.id), created: false, existing: match, blindSurface: caveat };
+  }
+  const body = {
+    companyName,
+    companyType,
+    phone: params.phone,
+    isActive: true,
+    ...owner !== void 0 ? { ownerResourceID: owner } : {}
+  };
+  if (opts.dryRun === true) return createDryRun(http, body, owner);
+  if (owner === void 0) {
+    throw new OwnerResourceRequiredError(
+      `upsertByName: no company '${companyName}' is enumerable to this API user (the dedup query returned nothing \u2014 a miss is NOT proof of absence: the unowned surface is blind) and the create path requires ownerResourceID \u2014 companies.create requires ownerResourceID = an active non-API-only resource id; the resources table is blind to this API user (count/query return 0)`,
+      { operation: OP_UPSERT_NAME }
+    );
+  }
+  await precheckOwner(http, owner);
+  return createWithDiscovery(resource, body, owner, caveat, opts);
+}
+
+// src/resources/special/companies/fullProfile.ts
+var FULL_PROFILE_PROJECTABLE_PARTS = ["locations", "contacts", "notes", "projects", "openTickets"];
+var PART_ENTITY = {
+  locations: "company_locations",
+  contacts: "contacts",
+  notes: "company_notes",
+  projects: "projects",
+  openTickets: "tickets"
+};
 var OPEN_TICKETS_NOTE = "open = status != 5 (Complete) \u2014 the ww29 ticket-status picklist has no Closed value; tickets in any other status count as open";
 var PROFILE_PART_LIMIT = 50;
+var LOCATION_LIMIT_MAX = 500;
+function locationLimit(value) {
+  if (value === void 0) return PROFILE_PART_LIMIT;
+  if (!Number.isInteger(value) || value < 1 || value > LOCATION_LIMIT_MAX) {
+    throw new AutotaskConfigError(`fullProfile: locationLimit must be an integer 1-${LOCATION_LIMIT_MAX} (got ${String(value)})`);
+  }
+  return value;
+}
+function validateProjection(fields) {
+  if (fields === void 0) return {};
+  if (fields === null || typeof fields !== "object" || Array.isArray(fields)) {
+    throw new AutotaskConfigError("fullProfile: fields must be an object keyed by part name");
+  }
+  const out = {};
+  for (const [part, list] of Object.entries(fields)) {
+    if (!FULL_PROFILE_PROJECTABLE_PARTS.includes(part)) {
+      throw new AutotaskConfigError(`fullProfile: fields has unknown part "${part.slice(0, 40)}" \u2014 projectable parts: ${FULL_PROFILE_PROJECTABLE_PARTS.join(", ")}`);
+    }
+    if (!Array.isArray(list) || list.length === 0 || list.some((n) => typeof n !== "string" || n.length === 0)) {
+      throw new AutotaskConfigError(`fullProfile: fields.${part} must be a non-empty array of field-name strings`);
+    }
+    const names = [...new Set(list)];
+    const entity = PART_ENTITY[part];
+    const known = MODEL_FIELD_SETS[entity] ?? [];
+    const unknown = names.filter((n) => !known.includes(n));
+    if (unknown.length > 0) {
+      throw new AutotaskConfigError(
+        `fullProfile: fields.${part} has unknown field name(s) ${formatUnknownNameList(unknown)} against the vendored spec for ${entity} (${known.length} fields; operations.fieldCatalog resources: ["${entity}"] lists the live set) \u2014 no request was issued`
+      );
+    }
+    out[part] = names;
+  }
+  return out;
+}
+function project(items, names) {
+  if (names === void 0) return items;
+  return items.map((row) => {
+    const r = row;
+    return Object.fromEntries(names.filter((n) => n in r).map((n) => [n, r[n]]));
+  });
+}
 function profilePartLimit(value, name) {
   const n = value === void 0 ? PROFILE_PART_LIMIT : Math.trunc(value);
   if (!Number.isInteger(n) || n < 1) {
@@ -1162,27 +1306,17 @@ function profilePartLimit(value, name) {
   }
   return n;
 }
-async function scopedCompanyQuery(http, path, companyID, limit) {
+async function scopedCompanyQuery(http, path, companyID, limit, includeFields) {
   const res = await http.request({
     method: "POST",
     idempotent: true,
     path,
-    body: { MaxRecords: limit, filter: [{ field: "companyID", op: "eq", value: companyID }] },
+    body: { MaxRecords: limit, filter: [{ field: "companyID", op: "eq", value: companyID }], ...includeFields ? { IncludeFields: includeFields } : {} },
     operation: "companies.fullProfile"
   });
-  return unwrapItems(res).items;
+  return project(unwrapItems(res).items, includeFields);
 }
-async function fullProfile(resource, id, opts = {}, http) {
-  const contactLimit = profilePartLimit(opts.contactLimit, "contactLimit");
-  const noteLimit = profilePartLimit(opts.noteLimit, "noteLimit");
-  const ticketLimit = profilePartLimit(opts.ticketLimit, "ticketLimit");
-  const projectLimit = profilePartLimit(opts.projectLimit, "projectLimit");
-  const companyID = parseIdentifier(id, "id");
-  const company = await resource.get(companyID);
-  const locations = await scopedCompanyQuery(http, "/V1.0/CompanyLocations/query", companyID, PROFILE_PART_LIMIT);
-  const contacts = await scopedCompanyQuery(http, "/V1.0/Contacts/query", companyID, contactLimit);
-  const notes = await scopedCompanyQuery(http, "/V1.0/CompanyNotes/query", companyID, noteLimit);
-  const projects = await scopedCompanyQuery(http, "/V1.0/Projects/query", companyID, projectLimit);
+async function readOpenTickets(http, companyID, ticketLimit, includeFields) {
   const openRows = await (async () => {
     const res = await http.request({
       method: "POST",
@@ -1190,11 +1324,12 @@ async function fullProfile(resource, id, opts = {}, http) {
       path: "/V1.0/Tickets/query",
       body: {
         MaxRecords: ticketLimit,
-        filter: [{ field: "companyID", op: "eq", value: companyID }, { field: "status", op: "noteq", value: 5 }]
+        filter: [{ field: "companyID", op: "eq", value: companyID }, { field: "status", op: "noteq", value: 5 }],
+        ...includeFields ? { IncludeFields: includeFields } : {}
       },
       operation: "companies.fullProfile"
     });
-    return unwrapItems(res).items;
+    return project(unwrapItems(res).items, includeFields);
   })();
   let openTickets = {
     items: openRows,
@@ -1217,9 +1352,72 @@ async function fullProfile(resource, id, opts = {}, http) {
       };
     }
   }
+  return openTickets;
+}
+async function addProfileNames(http, company, openTickets, projects, result, opts) {
+  const builder = createNamePlan(TICKET_LABEL_FIELDS);
+  const c = company;
+  builder.addResource(c["ownerResourceID"]);
+  builder.addResource(c["createdByResourceID"]);
+  for (const row of openTickets.items) {
+    const r = row;
+    builder.addResource(r["creatorResourceID"]);
+    builder.addFk("contract", r["contractID"]);
+    builder.addFk("billingCode", r["billingCodeID"]);
+    builder.addFk("role", r["assignedResourceRoleID"]);
+  }
+  for (const row of projects) {
+    const r = row;
+    builder.addResource(r["projectLeadResourceID"]);
+    builder.addResource(r["creatorResourceID"]);
+    builder.addFk("contract", r["contractID"]);
+  }
+  const names = await resolveCompositeNames(http, builder.plan(), { maxNameReads: opts.maxNameReads });
+  const companyRow = { ...company };
+  addNameSibling(companyRow, "ownerResourceID", (v) => names.resourceName(v));
+  addNameSibling(companyRow, "createdByResourceID", (v) => names.resourceName(v));
+  result.company = companyRow;
+  result.openTickets = {
+    ...openTickets,
+    items: openTickets.items.map((row) => {
+      const r = { ...row };
+      addNameSibling(r, "creatorResourceID", (v) => names.resourceName(v));
+      addNameSibling(r, "contractID", (v) => names.recordName("contract", v));
+      addNameSibling(r, "billingCodeID", (v) => names.recordName("billingCode", v));
+      addNameSibling(r, "assignedResourceRoleID", (v) => names.recordName("role", v));
+      for (const f of TICKET_LABEL_FIELDS) addLabelSibling(r, f, names);
+      return r;
+    })
+  };
+  result.projects = {
+    ...result.projects,
+    items: result.projects.items.map((row) => {
+      const r = { ...row };
+      addNameSibling(r, "projectLeadResourceID", (v) => names.resourceName(v));
+      addNameSibling(r, "creatorResourceID", (v) => names.resourceName(v));
+      addNameSibling(r, "contractID", (v) => names.recordName("contract", v));
+      return r;
+    })
+  };
+  result.names = names.section;
+}
+async function fullProfile(resource, id, opts = {}, http) {
+  const contactLimit = profilePartLimit(opts.contactLimit, "contactLimit");
+  const noteLimit = profilePartLimit(opts.noteLimit, "noteLimit");
+  const ticketLimit = profilePartLimit(opts.ticketLimit, "ticketLimit");
+  const projectLimit = profilePartLimit(opts.projectLimit, "projectLimit");
+  const locLimit = locationLimit(opts.locationLimit);
+  const proj = validateProjection(opts.fields);
+  const companyID = parseIdentifier(id, "id");
+  const company = await resource.get(companyID);
+  const locations = await scopedCompanyQuery(http, "/V1.0/CompanyLocations/query", companyID, locLimit, proj.locations);
+  const contacts = await scopedCompanyQuery(http, "/V1.0/Contacts/query", companyID, contactLimit, proj.contacts);
+  const notes = await scopedCompanyQuery(http, "/V1.0/CompanyNotes/query", companyID, noteLimit, proj.notes);
+  const projects = await scopedCompanyQuery(http, "/V1.0/Projects/query", companyID, projectLimit, proj.projects);
+  const openTickets = await readOpenTickets(http, companyID, ticketLimit, proj.openTickets);
   const result = {
     company,
-    locations: { items: locations, capped: locations.length >= PROFILE_PART_LIMIT },
+    locations: { items: locations, capped: locations.length >= locLimit },
     contacts: { items: contacts, capped: contacts.length >= contactLimit },
     notes: { items: notes, capped: notes.length >= noteLimit },
     openTickets,
@@ -1233,57 +1431,15 @@ async function fullProfile(resource, id, opts = {}, http) {
       projects: "ok"
     }
   };
-  if (opts.names === true) {
-    const builder = createNamePlan(TICKET_LABEL_FIELDS);
-    const c = company;
-    builder.addResource(c["ownerResourceID"]);
-    builder.addResource(c["createdByResourceID"]);
-    for (const row of openTickets.items) {
-      const r = row;
-      builder.addResource(r["creatorResourceID"]);
-      builder.addFk("contract", r["contractID"]);
-      builder.addFk("billingCode", r["billingCodeID"]);
-      builder.addFk("role", r["assignedResourceRoleID"]);
-    }
-    for (const row of projects) {
-      const r = row;
-      builder.addResource(r["projectLeadResourceID"]);
-      builder.addResource(r["creatorResourceID"]);
-      builder.addFk("contract", r["contractID"]);
-    }
-    const names = await resolveCompositeNames(http, builder.plan(), { maxNameReads: opts.maxNameReads });
-    const companyRow = { ...company };
-    addNameSibling(companyRow, "ownerResourceID", (v) => names.resourceName(v));
-    addNameSibling(companyRow, "createdByResourceID", (v) => names.resourceName(v));
-    result.company = companyRow;
-    result.openTickets = {
-      ...openTickets,
-      items: openTickets.items.map((row) => {
-        const r = { ...row };
-        addNameSibling(r, "creatorResourceID", (v) => names.resourceName(v));
-        addNameSibling(r, "contractID", (v) => names.recordName("contract", v));
-        addNameSibling(r, "billingCodeID", (v) => names.recordName("billingCode", v));
-        addNameSibling(r, "assignedResourceRoleID", (v) => names.recordName("role", v));
-        for (const f of TICKET_LABEL_FIELDS) addLabelSibling(r, f, names);
-        return r;
-      })
-    };
-    result.projects = {
-      ...result.projects,
-      items: result.projects.items.map((row) => {
-        const r = { ...row };
-        addNameSibling(r, "projectLeadResourceID", (v) => names.resourceName(v));
-        addNameSibling(r, "creatorResourceID", (v) => names.resourceName(v));
-        addNameSibling(r, "contractID", (v) => names.recordName("contract", v));
-        return r;
-      })
-    };
-    result.names = names.section;
-  }
+  if (opts.names === true) await addProfileNames(http, company, openTickets, projects, result, opts);
   return result;
 }
+
+// src/resources/special/companies/unbilledWorkTypes.ts
 var UNBILLED_WORK_NOTE_CHARS_DEFAULT = 400;
 var UNBILLED_WORK_JOIN_SET_CAP = 300;
+
+// src/resources/special/companies/unbilledWorkValidate.ts
 var UNBILLED_WORK_OPT_KEYS = [
   "source",
   "includeParent",
@@ -1297,13 +1453,6 @@ var UNBILLED_WORK_OPT_KEYS = [
   "limit"
 ];
 var UNBILLED_WORK_SOURCE_SET = ["posted_uninvoiced", "invoice", "date_range", "tickets"];
-var DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
-function num(v) {
-  return typeof v === "number" && Number.isFinite(v) ? v : 0;
-}
-function isDateYMD(v) {
-  return typeof v === "string" && DATE_RE.test(v) && !Number.isNaN(Date.parse(v));
-}
 function validateUnbilledWorkOptions(companyId, opts) {
   if (opts !== void 0 && (typeof opts !== "object" || opts === null || Array.isArray(opts))) {
     throw new AutotaskConfigError(
@@ -1394,22 +1543,11 @@ function validateUnbilledWorkOptions(companyId, opts) {
     limit
   };
 }
-async function boundedPart(http, path, conditions, limit, includeFields) {
-  const body = { MaxRecords: limit, filter: conditions };
-  if (includeFields !== void 0) body.IncludeFields = includeFields;
-  const res = await http.request({
-    method: "POST",
-    idempotent: true,
-    path,
-    body,
-    operation: "companies.unbilledWork"
-  });
-  const { items, pageDetails } = unwrapItems(res, "companies.unbilledWork");
-  const capped = items.length >= limit;
-  return { items, capped, hasMore: capped && pageDetails.nextPageUrl != null };
-}
-function capJoinSet(ids, cap) {
-  const sorted = [...new Set(ids)].sort((a, b) => a - b);
+
+// src/resources/special/companies/unbilledWork.ts
+var OP = "companies.unbilledWork";
+function capJoinSet(ids2, cap) {
+  const sorted = [...new Set(ids2)].sort((a, b) => a - b);
   if (sorted.length <= cap) return { ids: sorted, truncated: false };
   return { ids: sorted.slice(0, cap), truncated: true };
 }
@@ -1422,14 +1560,12 @@ function unbilledWorkPartStatus(key, conditions, items) {
     note: `0 rows on ${key}.query for this filter (a filtered empty is a TRUE zero \u2014 the pinned blind surfaces stamp only their blind shape, and this call is always filtered)`
   };
 }
-async function unbilledWork(resource, companyId, opts = {}, http) {
-  const v = validateUnbilledWorkOptions(companyId, opts);
-  const id = parseIdentifier(companyId, "companyId");
+async function readCompanyAndParent(resource, id, includeParent) {
   const company = await resource.get(id);
   const companyIds = [num(company.id)];
   let parent = null;
   let parentStatus = "skipped";
-  if (v.includeParent) {
+  if (includeParent) {
     const parentID = company.parentCompanyID;
     if (typeof parentID === "number" && parentID > 0) {
       try {
@@ -1442,15 +1578,18 @@ async function unbilledWork(resource, companyId, opts = {}, http) {
       }
     }
   }
+  return { company, parent, parentStatus, companyIds };
+}
+async function readJoinSets(http, companyIds, v) {
   const ticketsCond = [{ field: "companyID", op: "in", value: companyIds }];
-  const ticketsRaw = await boundedPart(http, "/V1.0/Tickets/query", ticketsCond, v.limit);
+  const ticketsRaw = await boundedPart(http, "/V1.0/Tickets/query", ticketsCond, v.limit, OP);
   const projectsCond = [{ field: "companyID", op: "in", value: companyIds }];
-  const projectsRaw = await boundedPart(http, "/V1.0/Projects/query", projectsCond, v.limit);
+  const projectsRaw = await boundedPart(http, "/V1.0/Projects/query", projectsCond, v.limit, OP);
   const projectIds = projectsRaw.items.map((p) => num(p.id)).filter((n) => n > 0);
   let taskIds = [];
   let tasksHasMore = false;
   if (projectIds.length > 0) {
-    const tasksRaw = await boundedPart(http, "/V1.0/Tasks/query", [{ field: "projectID", op: "in", value: projectIds }], v.limit);
+    const tasksRaw = await boundedPart(http, "/V1.0/Tasks/query", [{ field: "projectID", op: "in", value: projectIds }], v.limit, OP);
     taskIds = tasksRaw.items.map((t) => num(t.id)).filter((n) => n > 0);
     tasksHasMore = tasksRaw.hasMore;
   }
@@ -1458,6 +1597,9 @@ async function unbilledWork(resource, companyId, opts = {}, http) {
   if (v.source === "tickets" && v.ticketIds !== void 0) {
     for (const tid of v.ticketIds) ticketJoinIds.push(typeof tid === "number" ? tid : parseInt(tid, 10));
   }
+  return { ticketsRaw, projectsRaw, taskIds, tasksHasMore, ticketJoinIds };
+}
+async function readBillingPart(http, v, companyIds) {
   const billingConditions = [{ field: "companyID", op: "in", value: companyIds }];
   if (v.source === "posted_uninvoiced") billingConditions.push({ field: "invoiceID", op: "notExist" });
   if (v.source === "invoice" && v.invoiceId !== void 0) billingConditions.push({ field: "invoiceID", op: "eq", value: v.invoiceId });
@@ -1471,12 +1613,31 @@ async function unbilledWork(resource, companyId, opts = {}, http) {
   }
   const billingFields = resolveFieldsPreset("billing_join", "billing_items");
   const billingIncludeFields = [...billingFields, "id", ...v.includeNotes ? ["description"] : []];
-  const billingRaw = await boundedPart(http, "/V1.0/BillingItems/query", billingConditions, v.limit, billingIncludeFields);
-  const taskCap = capJoinSet(taskIds, UNBILLED_WORK_JOIN_SET_CAP);
-  const ticketCap = capJoinSet(ticketJoinIds, UNBILLED_WORK_JOIN_SET_CAP);
-  const joinNotes = [];
-  for (const [what, more] of [["ticket", ticketsRaw.hasMore], ["project", projectsRaw.hasMore], ["task", tasksHasMore]]) {
-    if (more) joinNotes.push(`${what} join read hit the limit of ${v.limit} \u2014 time entries are joined against the first ${v.limit} ${what}s only (raise limit to widen it)`);
+  const billingRaw = await boundedPart(http, "/V1.0/BillingItems/query", billingConditions, v.limit, OP, billingIncludeFields);
+  let billingItems = billingRaw.items;
+  let billingNoteCharsTruncated = 0;
+  if (v.includeNotes) {
+    const noteFields = (UNTRUSTED_FIELDS_BY_RESOURCE["billing_items"] ?? []).filter((f) => billingIncludeFields.includes(f));
+    [billingItems, billingNoteCharsTruncated] = truncateNoteChars(billingRaw.items, v.noteChars, noteFields);
+  }
+  const billingSt = unbilledWorkPartStatus("billing_items", billingConditions, billingRaw.items);
+  const billingItemsPart = {
+    items: billingItems,
+    capped: billingRaw.capped,
+    hasMore: billingRaw.hasMore,
+    status: billingSt.status,
+    blindSurface: billingSt.blindSurface,
+    note: [...billingSt.note !== void 0 ? [billingSt.note] : [], ...billingNoteCharsTruncated > 0 ? [`noteChars: ${billingNoteCharsTruncated} note field value(s) truncated at ${v.noteChars} chars`] : []].filter(Boolean).join(" | ") || void 0
+  };
+  return { billingItems, billingSt, billingItemsPart };
+}
+async function readTimePart(http, v, join) {
+  const { ticketsRaw, projectsRaw, taskIds, tasksHasMore, ticketJoinIds } = join;
+  const taskCap = capJoinSet(taskIds, UNBILLED_WORK_JOIN_SET_CAP);
+  const ticketCap = capJoinSet(ticketJoinIds, UNBILLED_WORK_JOIN_SET_CAP);
+  const joinNotes = [];
+  for (const [what, more] of [["ticket", ticketsRaw.hasMore], ["project", projectsRaw.hasMore], ["task", tasksHasMore]]) {
+    if (more) joinNotes.push(`${what} join read hit the limit of ${v.limit} \u2014 time entries are joined against the first ${v.limit} ${what}s only (raise limit to widen it)`);
   }
   if (taskCap.truncated) joinNotes.push(`task join set truncated to ${UNBILLED_WORK_JOIN_SET_CAP} of ${taskIds.length} ids (the 8000-char filter cap \u2014 the results cover the returned join set only)`);
   if (ticketCap.truncated) joinNotes.push(`ticket join set truncated to ${UNBILLED_WORK_JOIN_SET_CAP} of ${ticketJoinIds.length} ids (the 8000-char filter cap \u2014 the results cover the returned join set only)`);
@@ -1496,7 +1657,7 @@ async function unbilledWork(resource, companyId, opts = {}, http) {
     if (v.dateFrom !== void 0) timeConditions.push({ field: "dateWorked", op: "gte", value: v.dateFrom });
     if (v.dateTo !== void 0) timeConditions.push({ field: "dateWorked", op: "lte", value: v.dateTo });
     const timeFields = ["taskID", "ticketID", "hoursWorked", "dateWorked", "id", ...v.includeNotes ? ["summaryNotes"] : []];
-    const raw = await boundedPart(http, "/V1.0/TimeEntries/query", timeConditions, v.limit, timeFields);
+    const raw = await boundedPart(http, "/V1.0/TimeEntries/query", timeConditions, v.limit, OP, timeFields);
     entries = raw.items;
     let cappedItems = entries;
     let noteCharsTruncated = 0;
@@ -1513,21 +1674,9 @@ async function unbilledWork(resource, companyId, opts = {}, http) {
       note: [...joinNotes, ...st.note !== void 0 ? [st.note] : [], ...noteCharsTruncated > 0 ? [`noteChars: ${noteCharsTruncated} note field value(s) truncated at ${v.noteChars} chars`] : []].filter(Boolean).join(" | ") || void 0
     };
   }
-  let billingItems = billingRaw.items;
-  let billingNoteCharsTruncated = 0;
-  if (v.includeNotes) {
-    const noteFields = (UNTRUSTED_FIELDS_BY_RESOURCE["billing_items"] ?? []).filter((f) => billingIncludeFields.includes(f));
-    [billingItems, billingNoteCharsTruncated] = truncateNoteChars(billingRaw.items, v.noteChars, noteFields);
-  }
-  const billingSt = unbilledWorkPartStatus("billing_items", billingConditions, billingRaw.items);
-  const billingItemsPart = {
-    items: billingItems,
-    capped: billingRaw.capped,
-    hasMore: billingRaw.hasMore,
-    status: billingSt.status,
-    blindSurface: billingSt.blindSurface,
-    note: [...billingSt.note !== void 0 ? [billingSt.note] : [], ...billingNoteCharsTruncated > 0 ? [`noteChars: ${billingNoteCharsTruncated} note field value(s) truncated at ${v.noteChars} chars`] : []].filter(Boolean).join(" | ") || void 0
-  };
+  return { timePart, entries };
+}
+function foldRollup(v, billingItems, entries, timePart) {
   const entryByTimeId = /* @__PURE__ */ new Map();
   for (const e of entries) entryByTimeId.set(num(e.id), e);
   const fold = /* @__PURE__ */ new Map();
@@ -1567,6 +1716,9 @@ async function unbilledWork(resource, companyId, opts = {}, http) {
     return a.ticketId - b.ticketId;
   });
   const rollup = v.rollup === "entry" ? { mode: "entry", items: timePart.items, capped: timePart.capped, hasMore: timePart.hasMore } : { mode: "ticket", rows: rollupRows };
+  return { entryByTimeId, totals, rollup };
+}
+function unpostedAndWarnings(v, billingItems, entries, entryByTimeId) {
   const billedEntryIds = new Set(billingItems.map((i) => num(i.timeEntryID)).filter((n) => n > 0));
   const unpostedAll = entries.filter((e) => num(e.id) > 0 && !billedEntryIds.has(num(e.id)));
   const unpostedCapped = unpostedAll.length > v.limit;
@@ -1594,6 +1746,17 @@ async function unbilledWork(resource, companyId, opts = {}, http) {
     noTimeEntry: { items: noTimeEntryAll.slice(0, v.limit).map((i) => ({ billingItemId: num(i.id) })), count: noTimeEntryAll.length },
     hourDelta: { items: hourDeltaAll.slice(0, v.limit), count: hourDeltaAll.length }
   };
+  return { unposted, warnings };
+}
+async function unbilledWork(resource, companyId, opts = {}, http) {
+  const v = validateUnbilledWorkOptions(companyId, opts);
+  const id = parseIdentifier(companyId, "companyId");
+  const { company, parent, parentStatus, companyIds } = await readCompanyAndParent(resource, id, v.includeParent);
+  const join = await readJoinSets(http, companyIds, v);
+  const { billingItems, billingSt, billingItemsPart } = await readBillingPart(http, v, companyIds);
+  const { timePart, entries } = await readTimePart(http, v, join);
+  const { entryByTimeId, totals, rollup } = foldRollup(v, billingItems, entries, timePart);
+  const { unposted, warnings } = unpostedAndWarnings(v, billingItems, entries, entryByTimeId);
   return {
     company,
     parent,
@@ -4544,7 +4707,7 @@ var ContractServiceUnitsResource = class extends BaseResource {
   }
 };
 
-// src/resources/special/contracts.ts
+// src/resources/special/contracts/profitability.constants.ts
 var PROFITABILITY_OPT_KEYS = [
   "dateFrom",
   "dateTo",
@@ -4578,58 +4741,11 @@ var PERIOD_TYPE_MONTHLY_FACTOR = { 2: 1, 3: 1 / 3, 4: 1 / 6, 5: 1 / 12 };
 var PERIOD_TYPE_ONE_TIME = 1;
 var SERVICE_LINE_FKS = ["contractServiceID", "contractServiceBundleID", "contractServicePeriodID", "contractServiceBundlePeriodID", "contractServiceAdjustmentID", "contractServiceBundleAdjustmentID"];
 var CHARGE_LINE_FKS = ["contractChargeID", "ticketChargeID", "projectChargeID"];
-var DATE_RE2 = /^\d{4}-\d{2}-\d{2}$/;
-function num2(v) {
-  return typeof v === "number" && Number.isFinite(v) ? v : 0;
-}
-function isDateYMD2(v) {
-  return typeof v === "string" && DATE_RE2.test(v) && !Number.isNaN(Date.parse(v));
-}
-function monthsInWindow(dateFrom, dateTo) {
-  const a = `${dateFrom.slice(0, 7)}`;
-  const b = `${dateTo.slice(0, 7)}`;
-  if (a > b) return 0;
-  const ay = Number(a.slice(0, 4));
-  const am = Number(a.slice(5, 7));
-  const by = Number(b.slice(0, 4));
-  const bm = Number(b.slice(5, 7));
-  return (by - ay) * 12 + (bm - am) + 1;
-}
-function monthsBetween(dateFrom, dateTo) {
-  const out = [];
-  let y = Number(dateFrom.slice(0, 4));
-  let m = Number(dateFrom.slice(5, 7));
-  const end = dateTo.slice(0, 7);
-  for (; ; ) {
-    const tag = `${y}-${String(m).padStart(2, "0")}`;
-    out.push(tag);
-    if (tag === end) break;
-    m += 1;
-    if (m === 13) {
-      m = 1;
-      y += 1;
-    }
-    if (out.length > 500) break;
-  }
-  return out;
-}
-function dayAfter(date) {
-  return new Date(Date.parse(date) + 864e5).toISOString().slice(0, 10);
-}
-function monthBounds(month, dateFrom, dateTo) {
-  const y = Number(month.slice(0, 4));
-  const m = Number(month.slice(5, 7));
-  const first = `${month}-01`;
-  const nextFirst = new Date(Date.UTC(y, m, 1)).toISOString().slice(0, 10);
-  const toExcl = dayAfter(dateTo);
-  return {
-    start: first > dateFrom ? first : dateFrom,
-    endExclusive: nextFirst < toExcl ? nextFirst : toExcl
-  };
-}
+
+// src/resources/special/contracts/profitability.revenue.ts
 function chargeCost(charge) {
   const ext = charge["extendedCost"];
-  const fromUnits = num2(charge["unitCost"]) * num2(charge["unitQuantity"]);
+  const fromUnits = num(charge["unitCost"]) * num(charge["unitQuantity"]);
   if (typeof ext === "number" && Number.isFinite(ext) && !(ext === 0 && fromUnits !== 0)) return ext;
   return fromUnits;
 }
@@ -4657,42 +4773,165 @@ var BILLING_ITEM_TYPE_KIND = {
   8: "other"
 };
 function billingLineType(item) {
-  const byType = BILLING_ITEM_TYPE_KIND[num2(item["billingItemType"])];
+  const byType = BILLING_ITEM_TYPE_KIND[num(item["billingItemType"])];
   if (byType !== void 0) return byType;
-  if (num2(item["timeEntryID"]) > 0) return "labour";
-  if (num2(item["expenseItemID"]) > 0) return "expenses";
-  if (CHARGE_LINE_FKS.some((k) => num2(item[k]) > 0)) return "charges";
-  if (SERVICE_LINE_FKS.some((k) => num2(item[k]) > 0)) return "recurring";
+  if (num(item["timeEntryID"]) > 0) return "labour";
+  if (num(item["expenseItemID"]) > 0) return "expenses";
+  if (CHARGE_LINE_FKS.some((k) => num(item[k]) > 0)) return "charges";
+  if (SERVICE_LINE_FKS.some((k) => num(item[k]) > 0)) return "recurring";
   return "other";
 }
 function internalAmount(row, internalKey, localKey) {
   const v = row[internalKey];
-  return typeof v === "number" && Number.isFinite(v) ? v : num2(row[localKey]);
+  return typeof v === "number" && Number.isFinite(v) ? v : num(row[localKey]);
 }
 function cents(v) {
   return v === null ? null : Math.round(v * 100) / 100;
 }
-async function readPicklists(http, entityPath, operation) {
-  const res = await http.request({ method: "GET", path: `${entityPath}/entityInformation/fields`, operation });
-  const body = typeof res === "object" && res !== null ? res : {};
-  const fields = Array.isArray(body["fields"]) ? body["fields"] : [];
-  const out = /* @__PURE__ */ new Map();
-  for (const f of fields) {
-    if (f["isPickList"] !== true || typeof f["name"] !== "string" || !Array.isArray(f["picklistValues"])) continue;
-    const values = /* @__PURE__ */ new Map();
-    for (const p of f["picklistValues"]) {
-      const id = typeof p["value"] === "string" ? Number.parseInt(p["value"], 10) : Number.NaN;
-      if (Number.isFinite(id)) values.set(id, String(p["label"] ?? ""));
-    }
-    out.set(f["name"], values);
-  }
-  return out;
-}
+
+// src/resources/special/contracts/profitability.util.ts
 function dateToDay(v) {
   if (typeof v !== "string" || v.length < 10) return null;
   const d = Date.parse(v.slice(0, 10));
   return Number.isNaN(d) ? null : Math.floor(d / 864e5);
 }
+function fmtHours(h) {
+  const r = Math.round(h * 100) / 100;
+  return String(r);
+}
+function fmtNum(v) {
+  const r = Math.round(v * 100) / 100;
+  return String(r);
+}
+function pctOrNa(r) {
+  return r === null ? "n/a" : `${Math.round(r * 1e3) / 10}%`;
+}
+function dedupeSortCap(ids2, limit) {
+  return [...new Set(ids2)].sort((a, b) => Number(a) - Number(b)).slice(0, limit);
+}
+
+// src/resources/special/contracts/profitability.ladder.ts
+function ladderFrom(ctx) {
+  const rungs = [];
+  const push = (s) => rungs.push(s);
+  switch (ctx.method) {
+    case "billing_item_our_cost":
+      push("billing_item.ourCost");
+      push("contract_role_costs.rate");
+      push("resource.internalCost");
+      break;
+    case "contract_role_cost":
+      push("contract_role_costs.rate");
+      push("resource.internalCost");
+      break;
+    case "resource_internal_cost":
+      push("resource.internalCost");
+      break;
+    case "provided":
+      break;
+  }
+  if (ctx.rate !== null) push("provided");
+  return rungs;
+}
+function hoursOf(entry) {
+  const h = entry["hoursWorked"];
+  return typeof h === "number" && Number.isFinite(h) && h > 0 ? h : 0;
+}
+function resolveLabour(entry, ctx) {
+  const id = num(entry["id"]);
+  const hours = hoursOf(entry);
+  for (const rung of ladderFrom(ctx)) {
+    if (rung === "billing_item.ourCost") {
+      const items = ctx.billedByEntryId.get(id) ?? [];
+      const costs = items.map((i) => i["ourCost"]).filter((v) => typeof v === "number" && Number.isFinite(v) && v >= 0);
+      if (costs.length > 0) {
+        return {
+          source: "billing_item.ourCost",
+          cost: costs.reduce((a, b) => a + b, 0),
+          rate: null,
+          evidence: { billingItemIds: items.map((i) => num(i["id"])) }
+        };
+      }
+      continue;
+    }
+    if (rung === "contract_role_costs.rate") {
+      const resId = num(entry["resourceID"]);
+      const roleId = num(entry["roleID"]);
+      const row = resId > 0 && roleId > 0 ? ctx.roleCostByResourceRole.get(`${resId}:${roleId}`) ?? ctx.roleCostByRole.get(roleId) : roleId > 0 ? ctx.roleCostByRole.get(roleId) : void 0;
+      const rate = row ? row["rate"] : void 0;
+      if (row !== void 0 && typeof rate === "number" && Number.isFinite(rate) && rate >= 0) {
+        const matched = row !== void 0 && resId > 0 && roleId > 0 && ctx.roleCostByResourceRole.get(`${resId}:${roleId}`) !== void 0 ? "resource+role" : "role";
+        return { source: "contract_role_costs.rate", cost: rate * hours, rate, evidence: { contractRoleCostId: num(row["id"]), matched } };
+      }
+      continue;
+    }
+    if (rung === "resource.internalCost") {
+      const resId = num(entry["resourceID"]);
+      const r = resId > 0 ? ctx.resourcesById.get(resId) : void 0;
+      const ic = r ? r["internalCost"] : void 0;
+      if (r !== void 0 && typeof ic === "number" && Number.isFinite(ic) && ic >= 0) {
+        return { source: "resource.internalCost", cost: ic * hours, rate: ic, evidence: { resourceId: resId } };
+      }
+      continue;
+    }
+    if (rung === "provided" && ctx.rate !== null) {
+      return { source: "provided", cost: ctx.rate * hours, rate: ctx.rate, evidence: {} };
+    }
+  }
+  return { source: "missing", cost: null, rate: null, evidence: {} };
+}
+function buildLadderCtx(method, rate, billingRows, roleCostRows, resources, resourceMissIds) {
+  const billedByEntryId = /* @__PURE__ */ new Map();
+  for (const b of billingRows) {
+    const te = num(b["timeEntryID"]);
+    if (te <= 0) continue;
+    const arr = billedByEntryId.get(te) ?? [];
+    arr.push(b);
+    billedByEntryId.set(te, arr);
+  }
+  const roleCostByResourceRole = /* @__PURE__ */ new Map();
+  const roleCostByRole = /* @__PURE__ */ new Map();
+  for (const rc of roleCostRows) {
+    const resId = num(rc["resourceID"]);
+    const roleId = num(rc["roleID"]);
+    if (resId > 0 && roleId > 0) roleCostByResourceRole.set(`${resId}:${roleId}`, rc);
+    else if (roleId > 0) roleCostByRole.set(roleId, rc);
+  }
+  const resourcesById = new Map(resources.map((r) => [num(r["id"]), r]));
+  return { method, rate, billedByEntryId, roleCostByResourceRole, roleCostByRole, resourcesById, resourceMissIds };
+}
+function resolveEntries(entries, ctx) {
+  const entryResolution = /* @__PURE__ */ new Map();
+  for (const e of entries) entryResolution.set(num(e["id"]), resolveLabour(e, ctx));
+  return entryResolution;
+}
+function buildCostRateResolution(ctx, entries, entryResolution) {
+  const sources = {};
+  for (const rung of ladderFrom(ctx)) sources[rung] = { entries: 0, hours: 0, cost: 0 };
+  sources.missing = { entries: 0, hours: 0, cost: 0 };
+  const resolutionNotes = [];
+  if (ctx.method === "billing_item_our_cost") {
+    const noItems = entries.filter((e) => !ctx.billedByEntryId.has(num(e["id"]))).length;
+    if (noItems > 0) resolutionNotes.push(`${noItems} ${noItems === 1 ? "entry" : "entries"} had no billing item (non-billable or unposted) \u2014 rung 1 not usable`);
+  }
+  for (const resId of [...ctx.resourceMissIds].sort((a, b) => a - b)) {
+    const n = entries.filter((e) => num(e["resourceID"]) === resId).length;
+    resolutionNotes.push(`resource ${resId} unreadable (fetchByIds NOT_FOUND) \u2014 rung 3 unavailable for ${n} ${n === 1 ? "entry" : "entries"}`);
+  }
+  for (const e of entries) {
+    const r = entryResolution.get(num(e["id"]));
+    const bucket = sources[r.source] ?? sources.missing;
+    bucket.entries += 1;
+    bucket.hours += hoursOf(e);
+    bucket.cost += r.cost ?? 0;
+  }
+  for (const b of Object.values(sources)) b.cost = cents(b.cost);
+  const unresolvedHours = sources.missing.hours;
+  if (unresolvedHours > 0) resolutionNotes.push(`${fmtHours(unresolvedHours)} hours unresolved (missing rate) \u2014 total_cost is a lower bound`);
+  return { method: ctx.method, sources, unresolvedHours, notes: resolutionNotes };
+}
+
+// src/resources/special/contracts/profitability.validate.ts
 function validateProfitabilityOptions(contractId, opts) {
   if (opts === void 0 || (typeof opts !== "object" || opts === null || Array.isArray(opts))) {
     throw new AutotaskConfigError(
@@ -4708,12 +4947,12 @@ function validateProfitabilityOptions(contractId, opts) {
       );
     }
   }
-  if (!isDateYMD2(opts.dateFrom)) problems.push(`dateFrom is required (YYYY-MM-DD) (got ${String(opts.dateFrom)})`);
-  if (!isDateYMD2(opts.dateTo)) problems.push(`dateTo is required (YYYY-MM-DD) (got ${String(opts.dateTo)})`);
-  if (isDateYMD2(opts.dateFrom) && isDateYMD2(opts.dateTo) && opts.dateTo < opts.dateFrom) {
+  if (!isDateYMD(opts.dateFrom)) problems.push(`dateFrom is required (YYYY-MM-DD) (got ${String(opts.dateFrom)})`);
+  if (!isDateYMD(opts.dateTo)) problems.push(`dateTo is required (YYYY-MM-DD) (got ${String(opts.dateTo)})`);
+  if (isDateYMD(opts.dateFrom) && isDateYMD(opts.dateTo) && opts.dateTo < opts.dateFrom) {
     problems.push(`dateTo must be >= dateFrom (got ${opts.dateTo})`);
   }
-  if (isDateYMD2(opts.dateFrom) && isDateYMD2(opts.dateTo) && opts.dateTo >= opts.dateFrom) {
+  if (isDateYMD(opts.dateFrom) && isDateYMD(opts.dateTo) && opts.dateTo >= opts.dateFrom) {
     const months = monthsInWindow(opts.dateFrom, opts.dateTo);
     if (months > PROFITABILITY_MAX_WINDOW_MONTHS) {
       problems.push(
@@ -4745,7 +4984,7 @@ function validateProfitabilityOptions(contractId, opts) {
     if (!Array.isArray(emc)) {
       problems.push("externalMonthlyCosts must be an array of finite numbers >= 0, indexed by month from dateFrom (got a non-array)");
     } else {
-      const max = isDateYMD2(opts.dateFrom) && isDateYMD2(opts.dateTo) && opts.dateTo >= opts.dateFrom ? monthsInWindow(opts.dateFrom, opts.dateTo) : Infinity;
+      const max = isDateYMD(opts.dateFrom) && isDateYMD(opts.dateTo) && opts.dateTo >= opts.dateFrom ? monthsInWindow(opts.dateFrom, opts.dateTo) : Infinity;
       for (let i = 0; i < emc.length; i++) {
         const v = emc[i];
         if (typeof v !== "number" || !Number.isFinite(v) || v < 0) {
@@ -4798,27 +5037,31 @@ function validateProfitabilityOptions(contractId, opts) {
     includeRows: opts.includeRows ?? false
   };
 }
-async function boundedPart2(http, path, conditions, limit, operation, includeFields) {
-  const body = { MaxRecords: limit, filter: conditions };
-  if (includeFields !== void 0) body.IncludeFields = includeFields;
-  const res = await http.request({
-    method: "POST",
-    idempotent: true,
-    path,
-    body,
-    operation
-  });
-  const { items, pageDetails } = unwrapItems(res, operation);
-  const capped = items.length >= limit;
-  return { items, capped, hasMore: capped && pageDetails.nextPageUrl != null };
+
+// src/resources/special/contracts/profitability.fetch.ts
+async function readPicklists(http, entityPath, operation) {
+  const res = await http.request({ method: "GET", path: `${entityPath}/entityInformation/fields`, operation });
+  const body = typeof res === "object" && res !== null ? res : {};
+  const fields = Array.isArray(body["fields"]) ? body["fields"] : [];
+  const out = /* @__PURE__ */ new Map();
+  for (const f of fields) {
+    if (f["isPickList"] !== true || typeof f["name"] !== "string" || !Array.isArray(f["picklistValues"])) continue;
+    const values = /* @__PURE__ */ new Map();
+    for (const p of f["picklistValues"]) {
+      const id = typeof p["value"] === "string" ? Number.parseInt(p["value"], 10) : Number.NaN;
+      if (Number.isFinite(id)) values.set(id, String(p["label"] ?? ""));
+    }
+    out.set(f["name"], values);
+  }
+  return out;
 }
-function capJoinSet2(ids, cap) {
-  const sorted = [...new Set(ids)].sort((a, b) => a - b);
+function capJoinSet2(ids2, cap) {
+  const sorted = [...new Set(ids2)].sort((a, b) => a - b);
   if (sorted.length <= cap) return { ids: sorted, truncated: false, total: sorted.length };
   return { ids: sorted.slice(0, cap), truncated: true, total: sorted.length };
 }
-async function fetchByIdsPart(http, entityPath, ids, fields, operation, entity) {
-  const unique = [...new Set(ids)].sort((a, b) => a - b);
+async function fetchByIdsPart(http, entityPath, ids2, fields, operation, entity) {
+  const unique = [...new Set(ids2)].sort((a, b) => a - b);
   const byKey = /* @__PURE__ */ new Map();
   const misses = [];
   const notes = [];
@@ -4834,7 +5077,7 @@ async function fetchByIdsPart(http, entityPath, ids, fields, operation, entity)
       const res = await http.request({ method: "POST", idempotent: true, path: `${entityPath}/query`, body, operation });
       const { items: rows } = unwrapItems(res, operation);
       for (const row of rows) {
-        const k = num2(row.id);
+        const k = num(row.id);
         if (k > 0 && chunkKeys.has(k)) byKey.set(k, row);
       }
     } catch (err) {
@@ -4874,75 +5117,6 @@ async function fetchByIdsPart(http, entityPath, ids, fields, operation, entity)
   }
   return { items, foundIds, misses, notes };
 }
-function ladderFrom(ctx) {
-  const rungs = [];
-  const push = (s) => rungs.push(s);
-  switch (ctx.method) {
-    case "billing_item_our_cost":
-      push("billing_item.ourCost");
-      push("contract_role_costs.rate");
-      push("resource.internalCost");
-      break;
-    case "contract_role_cost":
-      push("contract_role_costs.rate");
-      push("resource.internalCost");
-      break;
-    case "resource_internal_cost":
-      push("resource.internalCost");
-      break;
-    case "provided":
-      break;
-  }
-  if (ctx.rate !== null) push("provided");
-  return rungs;
-}
-function hoursOf(entry) {
-  const h = entry["hoursWorked"];
-  return typeof h === "number" && Number.isFinite(h) && h > 0 ? h : 0;
-}
-function resolveLabour(entry, ctx) {
-  const id = num2(entry["id"]);
-  const hours = hoursOf(entry);
-  for (const rung of ladderFrom(ctx)) {
-    if (rung === "billing_item.ourCost") {
-      const items = ctx.billedByEntryId.get(id) ?? [];
-      const costs = items.map((i) => i["ourCost"]).filter((v) => typeof v === "number" && Number.isFinite(v) && v >= 0);
-      if (costs.length > 0) {
-        return {
-          source: "billing_item.ourCost",
-          cost: costs.reduce((a, b) => a + b, 0),
-          rate: null,
-          evidence: { billingItemIds: items.map((i) => num2(i["id"])) }
-        };
-      }
-      continue;
-    }
-    if (rung === "contract_role_costs.rate") {
-      const resId = num2(entry["resourceID"]);
-      const roleId = num2(entry["roleID"]);
-      const row = resId > 0 && roleId > 0 ? ctx.roleCostByResourceRole.get(`${resId}:${roleId}`) ?? ctx.roleCostByRole.get(roleId) : roleId > 0 ? ctx.roleCostByRole.get(roleId) : void 0;
-      const rate = row ? row["rate"] : void 0;
-      if (row !== void 0 && typeof rate === "number" && Number.isFinite(rate) && rate >= 0) {
-        const matched = row !== void 0 && resId > 0 && roleId > 0 && ctx.roleCostByResourceRole.get(`${resId}:${roleId}`) !== void 0 ? "resource+role" : "role";
-        return { source: "contract_role_costs.rate", cost: rate * hours, rate, evidence: { contractRoleCostId: num2(row["id"]), matched } };
-      }
-      continue;
-    }
-    if (rung === "resource.internalCost") {
-      const resId = num2(entry["resourceID"]);
-      const r = resId > 0 ? ctx.resourcesById.get(resId) : void 0;
-      const ic = r ? r["internalCost"] : void 0;
-      if (r !== void 0 && typeof ic === "number" && Number.isFinite(ic) && ic >= 0) {
-        return { source: "resource.internalCost", cost: ic * hours, rate: ic, evidence: { resourceId: resId } };
-      }
-      continue;
-    }
-    if (rung === "provided" && ctx.rate !== null) {
-      return { source: "provided", cost: ctx.rate * hours, rate: ctx.rate, evidence: {} };
-    }
-  }
-  return { source: "missing", cost: null, rate: null, evidence: {} };
-}
 async function expandByMonth(http, path, fullWindowCond, limit, operation, fields, dateField, dateFrom, dateTo, wires) {
   const months = monthsBetween(dateFrom, dateTo);
   const seen = /* @__PURE__ */ new Set();
@@ -4956,10 +5130,10 @@ async function expandByMonth(http, path, fullWindowCond, limit, operation, field
       { field: dateField, op: "gte", value: b.start },
       { field: dateField, op: "lt", value: b.endExclusive }
     ];
-    const page = await boundedPart2(http, path, cond, limit, operation, fields);
+    const page = await boundedPart(http, path, cond, limit, operation, fields);
     wires.issued += 1;
     for (const row of page.items) {
-      const k = num2(row["id"]);
+      const k = num(row["id"]);
       if (seen.has(k)) continue;
       seen.add(k);
       all.push(row);
@@ -4979,28 +5153,33 @@ async function degradable(read) {
     return { items: [], capped: false, hasMore: false, absent: err.code, absentMessage: err.message };
   }
 }
-function fmtHours(h) {
-  const r = Math.round(h * 100) / 100;
-  return String(r);
-}
-function fmtNum(v) {
-  const r = Math.round(v * 100) / 100;
-  return String(r);
-}
-function pctOrNa(r) {
-  return r === null ? "n/a" : `${Math.round(r * 1e3) / 10}%`;
-}
-function dedupeSortCap(ids, limit) {
-  return [...new Set(ids)].sort((a, b) => Number(a) - Number(b)).slice(0, limit);
+
+// src/resources/special/contracts/profitability.context.ts
+var PROFITABILITY_OP = "contracts.profitability";
+var skipPart = (note) => ({ items: [], capped: false, hasMore: false, status: "skipped", note });
+var stampPart = (key, raw, conditions, extraNotes) => {
+  if (raw.absent !== void 0) {
+    return { items: [], capped: false, hasMore: false, status: "absent", absent: raw.absent, note: `absent: the read failed (${raw.absent}: ${raw.absentMessage ?? ""}) \u2014 the monthly figures it feeds carry it in coverage_gaps` };
+  }
+  const st = unbilledWorkPartStatus(key, conditions, raw.items);
+  return {
+    items: raw.items,
+    capped: raw.capped,
+    hasMore: raw.hasMore,
+    status: st.status,
+    blindSurface: st.blindSurface,
+    note: [st.note, ...extraNotes ?? []].filter(Boolean).join(" | ") || void 0,
+    emptyReason: raw.items.length === 0 && st.status === "ok" ? EMPTY_REASON_STAMPS[key]?.query : void 0
+  };
+};
+function appendWiresNote(wires, note) {
+  wires.note = (wires.note ? wires.note + " | " : "") + note;
 }
-async function profitability(resource, contractId, opts, rawHttp) {
-  const v = validateProfitabilityOptions(contractId, opts);
-  const OP2 = "contracts.profitability";
+function makeFetchCtx(rawHttp, v, contractId, budget) {
+  const OP5 = PROFITABILITY_OP;
   const id = parseIdentifier(contractId, "contractId");
   const idNum = typeof id === "number" ? id : Number(id);
-  const wires = { issued: 0, requests: 0, budget: PROFITABILITY_WIRE_BUDGET };
-  const asOf = (/* @__PURE__ */ new Date()).toISOString();
-  const asOfMs = Date.parse(asOf);
+  const wires = { issued: 0, requests: 0, budget };
   const toExcl = dayAfter(v.dateTo);
   const windowOn = (field) => [{ field, op: "gte", value: v.dateFrom }, { field, op: "lt", value: toExcl }];
   const http = { request: (o) => {
@@ -5009,52 +5188,34 @@ async function profitability(resource, contractId, opts, rawHttp) {
   } };
   const readPart = (path, conditions, fields) => {
     wires.issued += 1;
-    return degradable(() => boundedPart2(http, path, conditions, v.limit, OP2, fields));
-  };
-  const skipPart = (note) => ({ items: [], capped: false, hasMore: false, status: "skipped", note });
-  const stampPart = (key, raw, conditions, extraNotes) => {
-    if (raw.absent !== void 0) {
-      return { items: [], capped: false, hasMore: false, status: "absent", absent: raw.absent, note: `absent: the read failed (${raw.absent}: ${raw.absentMessage ?? ""}) \u2014 the monthly figures it feeds carry it in coverage_gaps` };
-    }
-    const st = unbilledWorkPartStatus(key, conditions, raw.items);
-    return {
-      items: raw.items,
-      capped: raw.capped,
-      hasMore: raw.hasMore,
-      status: st.status,
-      blindSurface: st.blindSurface,
-      note: [st.note, ...extraNotes ?? []].filter(Boolean).join(" | ") || void 0,
-      emptyReason: raw.items.length === 0 && st.status === "ok" ? EMPTY_REASON_STAMPS[key]?.query : void 0
-    };
+    return degradable(() => boundedPart(http, path, conditions, v.limit, OP5, fields));
   };
   const truncatedMonths = {};
   const windowedPart = async (name, key, path, cond, fields, dateField) => {
     const first = await readPart(path, cond, fields);
     if (first.absent !== void 0 || !first.hasMore) return { part: stampPart(key, first, cond), rows: first.items };
-    const wp = await degradable(() => expandByMonth(http, path, cond, v.limit, OP2, fields, dateField, v.dateFrom, v.dateTo, wires));
+    const wp = await degradable(() => expandByMonth(http, path, cond, v.limit, OP5, fields, dateField, v.dateFrom, v.dateTo, wires));
     if (!("truncatedMonths" in wp)) return { part: stampPart(key, wp, cond), rows: [] };
     const { truncatedMonths: tm, ...part } = wp;
     truncatedMonths[name] = tm;
     return { part, rows: wp.items };
   };
-  const contractCached = rawHttp.readCache?.get(`/V1.0/Contracts/${id}`) !== void 0;
-  const contract = await resource.get(id);
-  wires.issued += 1;
-  if (!contractCached) wires.requests += 1;
-  const contractRow = contract;
-  const companyID = num2(contractRow["companyID"]);
-  const contractType = num2(contractRow["contractType"]);
+  return { v, OP: OP5, id, idNum, rawHttp, http, wires, windowOn, readPart, windowedPart, truncatedMonths };
+}
+
+// src/resources/special/contracts/profitability.stages.ts
+async function fetchCustomer(ctx, companyID) {
   let customer = null;
   let customerStatus = "skipped";
   let customerAbsent;
   if (companyID > 0) {
     try {
-      const res = await http.request({
+      const res = await ctx.http.request({
         method: "GET",
         path: `/V1.0/Companies/${companyID}`,
-        operation: OP2
+        operation: ctx.OP
       });
-      const item = unwrapItem(res, companyID, OP2, "company");
+      const item = unwrapItem(res, companyID, ctx.OP, "company");
       customer = item ?? null;
       customerStatus = "ok";
     } catch (err) {
@@ -5064,13 +5225,16 @@ async function profitability(resource, contractId, opts, rawHttp) {
         customerAbsent = err.code;
       }
     }
-    wires.issued += 1;
+    ctx.wires.issued += 1;
   }
+  return { customer, customerStatus, customerAbsent };
+}
+async function resolveContractType(ctx, contractType) {
   let contractTypeLabel = null;
   if (contractType > 0) {
-    wires.issued += 1;
+    ctx.wires.issued += 1;
     try {
-      contractTypeLabel = (await readPicklists(http, "/V1.0/Contracts", OP2)).get("contractType")?.get(contractType) ?? null;
+      contractTypeLabel = (await readPicklists(ctx.http, "/V1.0/Contracts", ctx.OP)).get("contractType")?.get(contractType) ?? null;
     } catch (err) {
       if (!(err instanceof AutotaskError)) throw err;
     }
@@ -5078,73 +5242,102 @@ async function profitability(resource, contractId, opts, rawHttp) {
   const contractTypeKnown = contractTypeLabel !== null;
   const isBlockHours = contractTypeKnown && BLOCK_HOURS_LABEL_RE.test(contractTypeLabel);
   const isTimeAndMaterials = contractTypeKnown && TIME_AND_MATERIALS_LABEL_RE.test(contractTypeLabel);
-  const servicesCond = [{ field: "contractID", op: "eq", value: id }];
-  const servicesRaw = await readPart("/V1.0/ContractServices/query", servicesCond, ["id", "serviceID", "unitPrice", "unitCost", "internalCurrencyUnitPrice", "internalDescription"]);
-  const unitsCond = [{ field: "contractID", op: "eq", value: id }, ...windowOn("startDate")];
-  const units = await windowedPart("contractServiceUnits", "contract_service_units", "/V1.0/ContractServiceUnits/query", unitsCond, ["id", "contractServiceID", "serviceID", "units", "price", "cost", "internalCurrencyPrice", "startDate", "endDate", "approveAndPostDate"], "startDate");
-  const unitRows = units.rows;
-  let chargesPart;
-  let charges = [];
-  let chargesCond = [];
-  if (v.includeRecurringCosts) {
-    chargesCond = [{ field: "contractID", op: "eq", value: id }, ...windowOn("datePurchased")];
-    const raw = await readPart("/V1.0/ContractCharges/query", chargesCond, ["id", "chargeType", "billableAmount", "extendedCost", "unitCost", "unitPrice", "unitQuantity", "datePurchased", "isBilled", "status", "contractServiceID"]);
-    charges = raw.items;
-    chargesPart = stampPart("contract_charges", raw, chargesCond);
-  } else {
-    chargesPart = skipPart("skipped: includeRecurringCosts is false (zero wire)");
-  }
-  const roleCostsCond = [{ field: "contractID", op: "eq", value: id }];
-  const roleCostsRaw = await readPart("/V1.0/ContractRoleCosts/query", roleCostsCond, ["id", "rate", "resourceID", "roleID"]);
-  const ratesCond = [{ field: "contractID", op: "eq", value: id }];
-  const ratesRaw = await readPart("/V1.0/ContractRates/query", ratesCond, ["id", "roleID", "contractHourlyRate", "internalCurrencyContractHourlyRate"]);
-  let blocksPart;
-  if (!isBlockHours) {
-    blocksPart = skipPart(
-      contractTypeKnown ? `skipped: not a Block Hours contract (contractType ${contractType} "${contractTypeLabel}") \u2014 included hours apply to hour blocks only (zero wire)` : `skipped: the contract type is unknown (contractType ${contractType || "absent"}; label unresolved) \u2014 included hours are not evaluable (zero wire)`
+  return { contractTypeLabel, contractTypeKnown, isBlockHours, isTimeAndMaterials };
+}
+async function fetchRoot(ctx, resource) {
+  const contractCached = ctx.rawHttp.readCache?.get(`/V1.0/Contracts/${ctx.id}`) !== void 0;
+  const contract = await resource.get(ctx.id);
+  ctx.wires.issued += 1;
+  if (!contractCached) ctx.wires.requests += 1;
+  const contractRow = contract;
+  const companyID = num(contractRow["companyID"]);
+  const contractType = num(contractRow["contractType"]);
+  const customerStage = await fetchCustomer(ctx, companyID);
+  const typeStage = await resolveContractType(ctx, contractType);
+  return { contract, contractRow, contractType, ...customerStage, ...typeStage };
+}
+async function fetchCharges(ctx) {
+  if (!ctx.v.includeRecurringCosts) {
+    return { chargesPart: skipPart("skipped: includeRecurringCosts is false (zero wire)"), charges: [] };
+  }
+  const chargesCond = [{ field: "contractID", op: "eq", value: ctx.id }, ...ctx.windowOn("datePurchased")];
+  const raw = await ctx.readPart("/V1.0/ContractCharges/query", chargesCond, ["id", "chargeType", "billableAmount", "extendedCost", "unitCost", "unitPrice", "unitQuantity", "datePurchased", "isBilled", "status", "contractServiceID"]);
+  return { charges: raw.items, chargesPart: stampPart("contract_charges", raw, chargesCond) };
+}
+async function fetchBlocks(ctx, root) {
+  if (!root.isBlockHours) {
+    return skipPart(
+      root.contractTypeKnown ? `skipped: not a Block Hours contract (contractType ${root.contractType} "${root.contractTypeLabel}") \u2014 included hours apply to hour blocks only (zero wire)` : `skipped: the contract type is unknown (contractType ${root.contractType || "absent"}; label unresolved) \u2014 included hours are not evaluable (zero wire)`
     );
-  } else {
-    const blocksCond = [{ field: "contractID", op: "eq", value: id }];
-    const raw = await readPart("/V1.0/ContractBlocks/query", blocksCond, ["id", "datePurchased", "startDate", "endDate", "hours", "hoursApproved", "status", "isPaid"]);
-    blocksPart = stampPart("contract_blocks", raw, blocksCond);
   }
-  const billingCond = [{ field: "contractID", op: "eq", value: id }, ...windowOn("itemDate")];
+  const blocksCond = [{ field: "contractID", op: "eq", value: ctx.id }];
+  const raw = await ctx.readPart("/V1.0/ContractBlocks/query", blocksCond, ["id", "datePurchased", "startDate", "endDate", "hours", "hoursApproved", "status", "isPaid"]);
+  return stampPart("contract_blocks", raw, blocksCond);
+}
+async function fetchContractState(ctx, root) {
+  const servicesCond = [{ field: "contractID", op: "eq", value: ctx.id }];
+  const servicesRaw = await ctx.readPart("/V1.0/ContractServices/query", servicesCond, ["id", "serviceID", "unitPrice", "unitCost", "internalCurrencyUnitPrice", "internalDescription"]);
+  const unitsCond = [{ field: "contractID", op: "eq", value: ctx.id }, ...ctx.windowOn("startDate")];
+  const units = await ctx.windowedPart("contractServiceUnits", "contract_service_units", "/V1.0/ContractServiceUnits/query", unitsCond, ["id", "contractServiceID", "serviceID", "units", "price", "cost", "internalCurrencyPrice", "startDate", "endDate", "approveAndPostDate"], "startDate");
+  const { chargesPart, charges } = await fetchCharges(ctx);
+  const roleCostsCond = [{ field: "contractID", op: "eq", value: ctx.id }];
+  const roleCostsRaw = await ctx.readPart("/V1.0/ContractRoleCosts/query", roleCostsCond, ["id", "rate", "resourceID", "roleID"]);
+  const ratesCond = [{ field: "contractID", op: "eq", value: ctx.id }];
+  const ratesRaw = await ctx.readPart("/V1.0/ContractRates/query", ratesCond, ["id", "roleID", "contractHourlyRate", "internalCurrencyContractHourlyRate"]);
+  const blocksPart = await fetchBlocks(ctx, root);
+  return { servicesRaw, servicesCond, unitRows: units.rows, unitsPartRaw: units.part, chargesPart, charges, roleCostsRaw, roleCostsCond, ratesRaw, ratesCond, blocksPart };
+}
+async function fetchBillingItems(ctx) {
+  const billingCond = [{ field: "contractID", op: "eq", value: ctx.id }, ...ctx.windowOn("itemDate")];
   const billingFields = ["id", "invoiceID", "timeEntryID", "ticketID", "ourCost", "quantity", "rate", "extendedPrice", "internalCurrencyExtendedPrice", "itemDate", "postedDate", "nonBillable", "billingCodeID", "billingItemType", "expenseItemID", ...SERVICE_LINE_FKS, ...CHARGE_LINE_FKS];
-  const billing = await windowedPart("billingItems", "billing_items", "/V1.0/BillingItems/query", billingCond, billingFields, "itemDate");
-  const billingItems = billing.part;
-  const billingRows = billing.rows;
-  const invoiceIds = [...new Set(billingRows.map((b) => num2(b["invoiceID"])).filter((n) => n > 0))];
-  let invoicesPart;
-  let invoices = [];
+  const billing = await ctx.windowedPart("billingItems", "billing_items", "/V1.0/BillingItems/query", billingCond, billingFields, "itemDate");
+  return { billingItems: billing.part, billingRows: billing.rows };
+}
+async function fetchInvoices(ctx, billingRows) {
+  const invoiceIds = [...new Set(billingRows.map((b) => num(b["invoiceID"])).filter((n) => n > 0))];
   if (invoiceIds.length === 0) {
-    invoicesPart = skipPart("skipped: the billing part has no invoiceIDs (zero wire)");
-  } else {
-    const capped = capJoinSet2(invoiceIds, FETCH_BY_IDS_MAX_ITEMS);
-    if (capped.truncated) wires.note = (wires.note ? wires.note + " | " : "") + `invoiceJoinTruncated: the join set is capped at ${FETCH_BY_IDS_MAX_ITEMS} of ${capped.total} invoice ids (the fetch-by-ids cap) \u2014 the figures cover the returned set only`;
-    const fb = await fetchByIdsPart(http, "/V1.0/Invoices", capped.ids, ["id", "invoiceNumber", "invoiceTotal", "paidDate", "isVoided", "dueDate"], OP2, "invoice");
-    wires.issued += 1;
-    invoices = fb.items;
-    invoicesPart = { items: fb.items, capped: capped.truncated, hasMore: capped.truncated, status: "ok", note: fb.notes.join(" | ") || void 0 };
+    return { invoicesPart: skipPart("skipped: the billing part has no invoiceIDs (zero wire)"), invoices: [] };
   }
-  const timeCond = [{ field: "contractID", op: "eq", value: id }, ...windowOn("dateWorked")];
+  const capped = capJoinSet2(invoiceIds, FETCH_BY_IDS_MAX_ITEMS);
+  if (capped.truncated) appendWiresNote(ctx.wires, `invoiceJoinTruncated: the join set is capped at ${FETCH_BY_IDS_MAX_ITEMS} of ${capped.total} invoice ids (the fetch-by-ids cap) \u2014 the figures cover the returned set only`);
+  const fb = await fetchByIdsPart(ctx.http, "/V1.0/Invoices", capped.ids, ["id", "invoiceNumber", "invoiceTotal", "paidDate", "isVoided", "dueDate"], ctx.OP, "invoice");
+  ctx.wires.issued += 1;
+  return {
+    invoices: fb.items,
+    invoicesPart: { items: fb.items, capped: capped.truncated, hasMore: capped.truncated, status: "ok", note: fb.notes.join(" | ") || void 0 }
+  };
+}
+async function fetchBilling(ctx) {
+  const items = await fetchBillingItems(ctx);
+  const inv = await fetchInvoices(ctx, items.billingRows);
+  return { ...items, ...inv };
+}
+async function fetchTime(ctx) {
+  const timeCond = [{ field: "contractID", op: "eq", value: ctx.id }, ...ctx.windowOn("dateWorked")];
   const timeFields = ["id", "ticketID", "taskID", "resourceID", "roleID", "hoursWorked", "hoursToBill", "dateWorked", "startDateTime", "endDateTime", "isNonBillable", "timeEntryType", "billingCodeID", "createDateTime"];
-  const time = await windowedPart("timeEntries", "time_entries", "/V1.0/TimeEntries/query", timeCond, timeFields, "dateWorked");
-  const timeEntries = time.part;
-  const entries = time.rows;
-  const ticketFields = ["id", "ticketNumber", "title", "status", "ticketCategory", "contractID", "createDate", "resolvedDateTime", "completedDate", "lastActivityDate", "dueDateTime"];
-  const createdInWindow = [{ field: "contractID", op: "eq", value: id }, ...windowOn("createDate")];
-  const refTicketIds = capJoinSet2(entries.map((e) => num2(e["ticketID"])).filter((n) => n > 0), v.maxTicketsForJoin);
+  const time = await ctx.windowedPart("timeEntries", "time_entries", "/V1.0/TimeEntries/query", timeCond, timeFields, "dateWorked");
+  return { timeEntries: time.part, entries: time.rows };
+}
+
+// src/resources/special/contracts/profitability.joins.ts
+var TICKET_FIELDS = ["id", "ticketNumber", "title", "status", "ticketCategory", "contractID", "createDate", "resolvedDateTime", "completedDate", "lastActivityDate", "dueDateTime"];
+async function fetchTicketActivity(ctx, entries) {
+  const createdInWindow = [{ field: "contractID", op: "eq", value: ctx.id }, ...ctx.windowOn("createDate")];
+  const refTicketIds = capJoinSet2(entries.map((e) => num(e["ticketID"])).filter((n) => n > 0), ctx.v.maxTicketsForJoin);
   const ticketsActCond = refTicketIds.ids.length === 0 ? createdInWindow : [{ op: "or", items: [{ op: "and", items: createdInWindow }, { field: "id", op: "in", value: refTicketIds.ids }] }];
-  const ticketsActRaw = await readPart("/V1.0/Tickets/query", ticketsActCond, ticketFields);
+  const ticketsActRaw = await ctx.readPart("/V1.0/Tickets/query", ticketsActCond, TICKET_FIELDS);
+  return { ticketsActRaw, ticketsActCond, refTicketIds };
+}
+async function readOpenStatusSet(ctx) {
   let openStatusSet = null;
   let statusNote;
-  wires.issued += 1;
+  ctx.wires.issued += 1;
   try {
-    const values = (await readPicklists(http, "/V1.0/Tickets", OP2)).get("status");
+    const values = (await readPicklists(ctx.http, "/V1.0/Tickets", ctx.OP)).get("status");
     if (values === void 0 || values.size === 0) {
       statusNote = "the tickets.status picklist is not exposed to this API user \u2014 the open-status labels are unavailable";
     } else {
-      const open = [...values].filter(([, label]) => !CLOSED_STATUS_LABEL_RE.test(label)).map(([v2]) => v2);
+      const open = [...values].filter(([, label]) => !CLOSED_STATUS_LABEL_RE.test(label)).map(([v]) => v);
       if (open.length === 0) {
         statusNote = "every tickets.status picklist label is closed-class \u2014 no open statuses exist in this tenant";
       } else {
@@ -5154,346 +5347,396 @@ async function profitability(resource, contractId, opts, rawHttp) {
   } catch (err) {
     statusNote = `the tickets.status field catalog read failed (${err instanceof AutotaskError ? err.code : "SERVER_ERROR"}: ${err instanceof Error ? err.message : String(err)}) \u2014 the open-status labels are unavailable`;
   }
-  let ticketsOpenPart;
-  let openTickets = [];
+  return { openStatusSet, statusNote };
+}
+async function fetchOpenTickets(ctx) {
+  const { openStatusSet, statusNote } = await readOpenStatusSet(ctx);
   if (openStatusSet === null) {
-    ticketsOpenPart = skipPart(`skipped: ${statusNote} (zero wire)`);
-  } else {
-    const openCond = [{ field: "contractID", op: "eq", value: id }, { field: "status", op: "in", value: [...openStatusSet] }];
-    const raw = await readPart("/V1.0/Tickets/query", openCond, ticketFields);
-    openTickets = raw.items;
-    ticketsOpenPart = stampPart("tickets", raw, openCond, ["openStatusHeuristic: true (the open set is the tenant picklist minus the closed-class labels)"]);
-  }
-  const resourceIds = [...new Set(entries.map((t) => num2(t["resourceID"])).filter((n) => n > 0))];
-  let resourcesPart;
-  let resources = [];
+    return { openStatusSet, ticketsOpenPart: skipPart(`skipped: ${statusNote} (zero wire)`), openTickets: [] };
+  }
+  const openCond = [{ field: "contractID", op: "eq", value: ctx.id }, { field: "status", op: "in", value: [...openStatusSet] }];
+  const raw = await ctx.readPart("/V1.0/Tickets/query", openCond, TICKET_FIELDS);
+  return {
+    openStatusSet,
+    openTickets: raw.items,
+    ticketsOpenPart: stampPart("tickets", raw, openCond, ["openStatusHeuristic: true (the open set is the tenant picklist minus the closed-class labels)"])
+  };
+}
+async function fetchResources(ctx, entries) {
+  const resourceIds = [...new Set(entries.map((t) => num(t["resourceID"])).filter((n) => n > 0))];
   const resourceMissIds = /* @__PURE__ */ new Set();
   if (resourceIds.length === 0) {
-    resourcesPart = skipPart("skipped: the time part has no resourceIDs (zero wire)");
-  } else {
-    const capped = capJoinSet2(resourceIds, FETCH_BY_IDS_MAX_ITEMS);
-    if (capped.truncated) wires.note = (wires.note ? wires.note + " | " : "") + `resourceJoinTruncated: the join set is capped at ${FETCH_BY_IDS_MAX_ITEMS} of ${capped.total} resource ids (the fetch-by-ids cap) \u2014 the figures cover the returned set only`;
-    const fb = await fetchByIdsPart(http, "/V1.0/Resources", capped.ids, ["id", "internalCost", "firstName", "lastName", "isActive", "userType"], OP2, "resource");
-    wires.issued += 1;
-    resources = fb.items;
-    for (const m of fb.misses) if (m.code === "NOT_FOUND") resourceMissIds.add(m.id);
-    resourcesPart = { items: fb.items, capped: capped.truncated, hasMore: capped.truncated, status: "ok", note: fb.notes.join(" | ") || void 0 };
+    return { resourcesPart: skipPart("skipped: the time part has no resourceIDs (zero wire)"), resources: [], resourceMissIds };
   }
+  const capped = capJoinSet2(resourceIds, FETCH_BY_IDS_MAX_ITEMS);
+  if (capped.truncated) appendWiresNote(ctx.wires, `resourceJoinTruncated: the join set is capped at ${FETCH_BY_IDS_MAX_ITEMS} of ${capped.total} resource ids (the fetch-by-ids cap) \u2014 the figures cover the returned set only`);
+  const fb = await fetchByIdsPart(ctx.http, "/V1.0/Resources", capped.ids, ["id", "internalCost", "firstName", "lastName", "isActive", "userType"], ctx.OP, "resource");
+  ctx.wires.issued += 1;
+  for (const m of fb.misses) if (m.code === "NOT_FOUND") resourceMissIds.add(m.id);
+  return {
+    resources: fb.items,
+    resourceMissIds,
+    resourcesPart: { items: fb.items, capped: capped.truncated, hasMore: capped.truncated, status: "ok", note: fb.notes.join(" | ") || void 0 }
+  };
+}
+function buildTicketJoin(ctx, ticketRows) {
   const fetchedTickets = /* @__PURE__ */ new Map();
-  for (const t of [...ticketsActRaw.items, ...openTickets]) {
-    const k = num2(t["id"]);
+  for (const t of ticketRows) {
+    const k = num(t["id"]);
     if (k > 0 && !fetchedTickets.has(k)) fetchedTickets.set(k, t);
   }
-  const contractTickets = [...fetchedTickets.values()].filter((t) => num2(t["contractID"]) === idNum);
-  const ticketJoin = capJoinSet2(contractTickets.map((t) => num2(t["id"])), v.maxTicketsForJoin);
-  const joinNote = ticketJoin.truncated ? `the ticket join set is capped at ${v.maxTicketsForJoin} of ${ticketJoin.total} ids \u2014 the expenses + the miscoding probe cover the returned join set only` : void 0;
-  let expensesPart;
-  let expenses = [];
-  if (ticketJoin.ids.length === 0) {
-    expensesPart = skipPart("skipped: the contract has no fetched tickets to join against (an empty join set is NOT evidence of no expenses \u2014 zero wire)");
-  } else {
-    const expCond = [{ field: "ticketID", op: "in", value: ticketJoin.ids }, ...windowOn("expenseDate")];
-    const raw = await readPart("/V1.0/ExpenseItems/query", expCond, ["id", "expenseDate", "expenseCategory", "paymentType", "expenseCurrencyExpenseAmount", "internalCurrencyExpenseAmount", "ticketID"]);
-    expenses = raw.items;
-    expensesPart = stampPart("expense_items", raw, expCond, joinNote === void 0 ? void 0 : [joinNote]);
-  }
-  let probePart;
-  let probeRows = [];
-  if (ticketJoin.ids.length === 0) {
-    probePart = skipPart("skipped: the contract has no fetched tickets to probe against (zero wire) \u2014 check 1 (miscoded_time_out) is not evaluable");
-  } else {
-    const probeCond = [
-      { field: "ticketID", op: "in", value: ticketJoin.ids },
-      { op: "or", items: [{ field: "contractID", op: "noteq", value: id }, { field: "contractID", op: "notExist" }] },
-      ...windowOn("dateWorked")
-    ];
-    const raw = await readPart("/V1.0/TimeEntries/query", probeCond, ["id", "ticketID", "contractID", "resourceID", "hoursWorked", "dateWorked"]);
-    probeRows = raw.items;
-    probePart = stampPart("time_entries", raw, probeCond, joinNote === void 0 ? void 0 : [joinNote]);
-  }
-  let configurationItemsPart;
-  let cis = [];
-  if (!v.includeRecurringCosts) {
-    configurationItemsPart = skipPart("skipped: includeRecurringCosts is false (zero wire)");
-  } else {
-    const ciCond = [{ field: "contractID", op: "eq", value: id }];
-    const raw = await readPart("/V1.0/ConfigurationItems/query", ciCond, ["id", "configurationItemName", "status", "contractID"]);
-    cis = raw.items;
-    configurationItemsPart = stampPart("configuration_items", raw, ciCond);
+  const contractTickets = [...fetchedTickets.values()].filter((t) => num(t["contractID"]) === ctx.idNum);
+  const ticketJoin = capJoinSet2(contractTickets.map((t) => num(t["id"])), ctx.v.maxTicketsForJoin);
+  const joinNote = ticketJoin.truncated ? `the ticket join set is capped at ${ctx.v.maxTicketsForJoin} of ${ticketJoin.total} ids \u2014 the expenses + the miscoding probe cover the returned join set only` : void 0;
+  return { fetchedTickets, contractTickets, ticketJoin, joinNote };
+}
+async function fetchExpenses(ctx, join) {
+  if (join.ticketJoin.ids.length === 0) {
+    return { expenses: [], expensesPart: skipPart("skipped: the contract has no fetched tickets to join against (an empty join set is NOT evidence of no expenses \u2014 zero wire)") };
   }
-  let subscriptionsPart;
-  let subscriptions = [];
+  const expCond = [{ field: "ticketID", op: "in", value: join.ticketJoin.ids }, ...ctx.windowOn("expenseDate")];
+  const raw = await ctx.readPart("/V1.0/ExpenseItems/query", expCond, ["id", "expenseDate", "expenseCategory", "paymentType", "expenseCurrencyExpenseAmount", "internalCurrencyExpenseAmount", "ticketID"]);
+  return {
+    expenses: raw.items,
+    expensesPart: stampPart("expense_items", raw, expCond, join.joinNote === void 0 ? void 0 : [join.joinNote])
+  };
+}
+async function fetchProbe(ctx, join) {
+  if (join.ticketJoin.ids.length === 0) {
+    return { probeRows: [], probePart: skipPart("skipped: the contract has no fetched tickets to probe against (zero wire) \u2014 check 1 (miscoded_time_out) is not evaluable") };
+  }
+  const probeCond = [
+    { field: "ticketID", op: "in", value: join.ticketJoin.ids },
+    { op: "or", items: [{ field: "contractID", op: "noteq", value: ctx.id }, { field: "contractID", op: "notExist" }] },
+    ...ctx.windowOn("dateWorked")
+  ];
+  const raw = await ctx.readPart("/V1.0/TimeEntries/query", probeCond, ["id", "ticketID", "contractID", "resourceID", "hoursWorked", "dateWorked"]);
+  return {
+    probeRows: raw.items,
+    probePart: stampPart("time_entries", raw, probeCond, join.joinNote === void 0 ? void 0 : [join.joinNote])
+  };
+}
+async function fetchTicketJoinParts(ctx, ticketRows) {
+  const join = buildTicketJoin(ctx, ticketRows);
+  const exp = await fetchExpenses(ctx, join);
+  const probe = await fetchProbe(ctx, join);
+  return { ...join, ...exp, ...probe };
+}
+async function fetchConfigurationItems(ctx) {
+  if (!ctx.v.includeRecurringCosts) {
+    return { part: skipPart("skipped: includeRecurringCosts is false (zero wire)"), cis: [] };
+  }
+  const ciCond = [{ field: "contractID", op: "eq", value: ctx.id }];
+  const raw = await ctx.readPart("/V1.0/ConfigurationItems/query", ciCond, ["id", "configurationItemName", "status", "contractID"]);
+  return { cis: raw.items, part: stampPart("configuration_items", raw, ciCond) };
+}
+async function readSubscriptionLabels(ctx, subscriptions) {
+  if (subscriptions.length === 0) return null;
+  ctx.wires.issued += 1;
+  try {
+    return await readPicklists(ctx.http, "/V1.0/Subscriptions", ctx.OP);
+  } catch (err) {
+    if (!(err instanceof AutotaskError)) throw err;
+    return null;
+  }
+}
+async function fetchSubscriptions(ctx, cis) {
   const subFactor = /* @__PURE__ */ new Map();
   const oneTimeSubs = /* @__PURE__ */ new Set();
   const cancelledSubs = /* @__PURE__ */ new Set();
   if (cis.length === 0) {
-    subscriptionsPart = skipPart("skipped: the CI join found no configuration items \u2014 the subscriptions part is not evaluable (zero wire)");
-  } else {
-    const ciIds = capJoinSet2(cis.map((c) => num2(c["id"])).filter((n) => n > 0), FETCH_BY_IDS_MAX_ITEMS);
-    const subCond = [{ field: "configurationItemID", op: "in", value: ciIds.ids }];
-    const raw = await readPart("/V1.0/Subscriptions/query", subCond, ["id", "subscriptionName", "configurationItemID", "periodCost", "periodPrice", "periodType", "effectiveDate", "expirationDate", "status", "totalCost"]);
-    subscriptions = raw.items;
-    let labels = null;
-    if (subscriptions.length > 0) {
-      wires.issued += 1;
-      try {
-        labels = await readPicklists(http, "/V1.0/Subscriptions", OP2);
-      } catch (err) {
-        if (!(err instanceof AutotaskError)) throw err;
-      }
-    }
-    for (const x of subscriptions) {
-      const sid = num2(x["id"]);
-      const periodLabel = labels?.get("periodType")?.get(num2(x["periodType"]));
-      subFactor.set(sid, periodMonthlyFactor(x["periodType"], periodLabel));
-      if (isOneTimePeriod(x["periodType"], periodLabel)) oneTimeSubs.add(sid);
-      const statusLabel = labels?.get("status")?.get(num2(x["status"]));
-      const notActive = statusLabel !== void 0 ? NOT_ACTIVE_LABEL_RE.test(statusLabel) : labels === null && SUBSCRIPTION_NOT_ACTIVE_STATUS_IDS.has(num2(x["status"]));
-      if (notActive) cancelledSubs.add(sid);
-    }
-    const unknownPeriods = [...new Set(subscriptions.filter((x) => subFactor.get(num2(x["id"])) === null && !oneTimeSubs.has(num2(x["id"]))).map((x) => String(x["periodType"] ?? "absent")))];
-    subscriptionsPart = stampPart("subscriptions", raw, subCond, [
-      "scope: the subscriptions on the CIs this contract covers \u2014 periodCost prorated to a month by periodType into tooling_cost.vendor, REPORTED but NOT folded into total_cost/profit/margin (subscriptions bill outside the contract)",
-      ...subscriptions.length > 0 && labels === null ? ["the Subscriptions field catalog read failed \u2014 the verified id maps apply (periodType 1 One-Time, 2 Monthly, 3 Quarterly, 4 Semi-Annual, 5 Yearly; status 2 Cancelled / 3 Inactive excluded)"] : [],
-      ...cancelledSubs.size > 0 ? [`${cancelledSubs.size} not-active (cancelled/inactive) subscription(s) excluded from tooling_cost.vendor`] : [],
-      ...oneTimeSubs.size > 0 ? [`${oneTimeSubs.size} one-time subscription(s): periodCost booked whole in the effectiveDate month, never prorated`] : [],
-      ...unknownPeriods.length > 0 ? [`unrecognised periodType ${unknownPeriods.join(", ")} \u2014 those subscriptions are excluded from tooling_cost.vendor (not prorated)`] : []
-    ]);
+    return {
+      subscriptionsPart: skipPart("skipped: the CI join found no configuration items \u2014 the subscriptions part is not evaluable (zero wire)"),
+      subscriptions: [],
+      subFactor,
+      oneTimeSubs,
+      cancelledSubs
+    };
   }
-  const servicesPart = stampPart("contract_services", servicesRaw, servicesCond);
-  const unitsPart = units.part;
-  const roleCostsPart = stampPart("contract_role_costs", roleCostsRaw, roleCostsCond);
-  const ratesPart = stampPart("contract_rates", ratesRaw, ratesCond);
-  const ticketsActivityPart = stampPart("tickets", ticketsActRaw, ticketsActCond, [
-    ...ticketsActRaw.hasMore ? [`${fetchedTickets.size} ticket(s) returned of possibly more \u2014 the checks cover the returned set only`] : [],
-    ...refTicketIds.truncated ? [`the time-referenced ticket ids are capped at ${v.maxTicketsForJoin} of ${refTicketIds.total} \u2014 the rest read as ticket_not_in_fetched_set`] : []
+  const ciIds = capJoinSet2(cis.map((c) => num(c["id"])).filter((n) => n > 0), FETCH_BY_IDS_MAX_ITEMS);
+  const subCond = [{ field: "configurationItemID", op: "in", value: ciIds.ids }];
+  const raw = await ctx.readPart("/V1.0/Subscriptions/query", subCond, ["id", "subscriptionName", "configurationItemID", "periodCost", "periodPrice", "periodType", "effectiveDate", "expirationDate", "status", "totalCost"]);
+  const subscriptions = raw.items;
+  const labels = await readSubscriptionLabels(ctx, subscriptions);
+  for (const x of subscriptions) {
+    const sid = num(x["id"]);
+    const periodLabel = labels?.get("periodType")?.get(num(x["periodType"]));
+    subFactor.set(sid, periodMonthlyFactor(x["periodType"], periodLabel));
+    if (isOneTimePeriod(x["periodType"], periodLabel)) oneTimeSubs.add(sid);
+    const statusLabel = labels?.get("status")?.get(num(x["status"]));
+    const notActive = statusLabel !== void 0 ? NOT_ACTIVE_LABEL_RE.test(statusLabel) : labels === null && SUBSCRIPTION_NOT_ACTIVE_STATUS_IDS.has(num(x["status"]));
+    if (notActive) cancelledSubs.add(sid);
+  }
+  const unknownPeriods = [...new Set(subscriptions.filter((x) => subFactor.get(num(x["id"])) === null && !oneTimeSubs.has(num(x["id"]))).map((x) => String(x["periodType"] ?? "absent")))];
+  const subscriptionsPart = stampPart("subscriptions", raw, subCond, [
+    "scope: the subscriptions on the CIs this contract covers \u2014 periodCost prorated to a month by periodType into tooling_cost.vendor, REPORTED but NOT folded into total_cost/profit/margin (subscriptions bill outside the contract)",
+    ...subscriptions.length > 0 && labels === null ? ["the Subscriptions field catalog read failed \u2014 the verified id maps apply (periodType 1 One-Time, 2 Monthly, 3 Quarterly, 4 Semi-Annual, 5 Yearly; status 2 Cancelled / 3 Inactive excluded)"] : [],
+    ...cancelledSubs.size > 0 ? [`${cancelledSubs.size} not-active (cancelled/inactive) subscription(s) excluded from tooling_cost.vendor`] : [],
+    ...oneTimeSubs.size > 0 ? [`${oneTimeSubs.size} one-time subscription(s): periodCost booked whole in the effectiveDate month, never prorated`] : [],
+    ...unknownPeriods.length > 0 ? [`unrecognised periodType ${unknownPeriods.join(", ")} \u2014 those subscriptions are excluded from tooling_cost.vendor (not prorated)`] : []
   ]);
-  const billedByEntryId = /* @__PURE__ */ new Map();
-  for (const b of billingRows) {
-    const te = num2(b["timeEntryID"]);
-    if (te <= 0) continue;
-    const arr = billedByEntryId.get(te) ?? [];
-    arr.push(b);
-    billedByEntryId.set(te, arr);
-  }
-  const roleCostByResourceRole = /* @__PURE__ */ new Map();
-  const roleCostByRole = /* @__PURE__ */ new Map();
-  for (const rc of roleCostsRaw.items) {
-    const resId = num2(rc["resourceID"]);
-    const roleId = num2(rc["roleID"]);
-    if (resId > 0 && roleId > 0) roleCostByResourceRole.set(`${resId}:${roleId}`, rc);
-    else if (roleId > 0) roleCostByRole.set(roleId, rc);
-  }
-  const resourcesById = new Map(resources.map((r) => [num2(r["id"]), r]));
-  const ladderCtx = { method: v.method, rate: v.labourRatePerHour, billedByEntryId, roleCostByResourceRole, roleCostByRole, resourcesById, resourceMissIds };
-  const entryResolution = /* @__PURE__ */ new Map();
-  for (const e of entries) entryResolution.set(num2(e["id"]), resolveLabour(e, ladderCtx));
-  const activeRungs = ladderFrom(ladderCtx);
-  const sources = {};
-  for (const rung of activeRungs) sources[rung] = { entries: 0, hours: 0, cost: 0 };
-  sources.missing = { entries: 0, hours: 0, cost: 0 };
-  const resolutionNotes = [];
-  if (v.method === "billing_item_our_cost") {
-    const noItems = entries.filter((e) => !billedByEntryId.has(num2(e["id"]))).length;
-    if (noItems > 0) resolutionNotes.push(`${noItems} ${noItems === 1 ? "entry" : "entries"} had no billing item (non-billable or unposted) \u2014 rung 1 not usable`);
-  }
-  for (const resId of [...resourceMissIds].sort((a, b) => a - b)) {
-    const n = entries.filter((e) => num2(e["resourceID"]) === resId).length;
-    resolutionNotes.push(`resource ${resId} unreadable (fetchByIds NOT_FOUND) \u2014 rung 3 unavailable for ${n} ${n === 1 ? "entry" : "entries"}`);
-  }
-  for (const e of entries) {
-    const r = entryResolution.get(num2(e["id"]));
-    const bucket = sources[r.source] ?? sources.missing;
-    bucket.entries += 1;
-    bucket.hours += hoursOf(e);
-    bucket.cost += r.cost ?? 0;
-  }
-  for (const b of Object.values(sources)) b.cost = cents(b.cost);
-  const unresolvedHours = sources.missing.hours;
-  if (unresolvedHours > 0) resolutionNotes.push(`${fmtHours(unresolvedHours)} hours unresolved (missing rate) \u2014 total_cost is a lower bound`);
-  const costRateResolution = { method: v.method, sources, unresolvedHours, notes: resolutionNotes };
-  const months = monthsBetween(v.dateFrom, v.dateTo);
-  const monthOf = (date) => typeof date === "string" && DATE_RE2.test(`${date}`.slice(0, 10)) ? date.slice(0, 7) : null;
+  return { subscriptionsPart, subscriptions, subFactor, oneTimeSubs, cancelledSubs };
+}
+async function fetchSubscriptionsJoin(ctx) {
+  const ci = await fetchConfigurationItems(ctx);
+  const subs = await fetchSubscriptions(ctx, ci.cis);
+  return { configurationItemsPart: ci.part, ...subs };
+}
+
+// src/resources/special/contracts/profitability.data.ts
+async function gather(ctx, resource) {
+  const root = await fetchRoot(ctx, resource);
+  const state = await fetchContractState(ctx, root);
+  const billing = await fetchBilling(ctx);
+  const time = await fetchTime(ctx);
+  const activity = await fetchTicketActivity(ctx, time.entries);
+  const open = await fetchOpenTickets(ctx);
+  const res = await fetchResources(ctx, time.entries);
+  const join = await fetchTicketJoinParts(ctx, [...activity.ticketsActRaw.items, ...open.openTickets]);
+  const subs = await fetchSubscriptionsJoin(ctx);
+  return { root, state, billing, time, activity, open, res, join, subs };
+}
+function stampListParts(v, f) {
+  const { state, activity, join } = f;
+  return {
+    servicesPart: stampPart("contract_services", state.servicesRaw, state.servicesCond),
+    unitsPart: state.unitsPartRaw,
+    roleCostsPart: stampPart("contract_role_costs", state.roleCostsRaw, state.roleCostsCond),
+    ratesPart: stampPart("contract_rates", state.ratesRaw, state.ratesCond),
+    ticketsActivityPart: stampPart("tickets", activity.ticketsActRaw, activity.ticketsActCond, [
+      ...activity.ticketsActRaw.hasMore ? [`${join.fetchedTickets.size} ticket(s) returned of possibly more \u2014 the checks cover the returned set only`] : [],
+      ...activity.refTicketIds.truncated ? [`the time-referenced ticket ids are capped at ${v.maxTicketsForJoin} of ${activity.refTicketIds.total} \u2014 the rest read as ticket_not_in_fetched_set`] : []
+    ])
+  };
+}
+function makeFoldCtx(ctx, f, st, asOfMs) {
+  const { v } = ctx;
+  const ladder = buildLadderCtx(v.method, v.labourRatePerHour, f.billing.billingRows, f.state.roleCostsRaw.items, f.res.resources, f.res.resourceMissIds);
+  const entryResolution = resolveEntries(f.time.entries, ladder);
+  return {
+    v,
+    f,
+    st,
+    idNum: ctx.idNum,
+    asOfMs,
+    months: monthsBetween(v.dateFrom, v.dateTo),
+    truncatedMonths: ctx.truncatedMonths,
+    ladder,
+    activeRungs: ladderFrom(ladder),
+    entryResolution,
+    costRateResolution: buildCostRateResolution(ladder, f.time.entries, entryResolution)
+  };
+}
+
+// src/resources/special/contracts/profitability.monthly.ts
+function makeMonthCalc(fc) {
+  const { v, f } = fc;
+  const unitRows = f.state.unitRows;
+  const billingRows = f.billing.billingRows;
+  const monthOf = (date) => typeof date === "string" && DATE_RE.test(`${date}`.slice(0, 10)) ? date.slice(0, 7) : null;
   const inMonth = (date, m) => monthOf(date) === m;
   const unitIn = (unit, m) => inMonth(unit["startDate"], m);
   const lineRevenue = (b) => internalAmount(b, "internalCurrencyExtendedPrice", "extendedPrice");
-  const expectedBasis = unitsPart.status !== "absent" && (servicesRaw.items.length > 0 || unitRows.length > 0);
+  const expectedBasis = fc.st.unitsPart.status !== "absent" && (f.state.servicesRaw.items.length > 0 || unitRows.length > 0);
   const expectedIn = (m) => unitRows.filter((u) => unitIn(u, m)).reduce((a, u) => a + internalAmount(u, "internalCurrencyPrice", "price"), 0);
   const recurringIn = (m) => {
     if (!v.includeRecurringCosts) return 0;
     let total = 0;
-    for (const c of charges) if (inMonth(c["datePurchased"], m)) total += chargeCost(c);
-    for (const u of unitRows) if (unitIn(u, m)) total += num2(u["cost"]);
+    for (const c of f.state.charges) if (inMonth(c["datePurchased"], m)) total += chargeCost(c);
+    for (const u of unitRows) if (unitIn(u, m)) total += num(u["cost"]);
     return total;
   };
-  const invoicesById = new Map(invoices.map((i) => [num2(i["id"]), i]));
+  const invoicesById = new Map(f.billing.invoices.map((i) => [num(i["id"]), i]));
   const billedServiceIn = (m) => {
     let billed = 0;
-    const ids = [];
+    const ids2 = [];
     for (const b of billingRows) {
       if (!inMonth(b["itemDate"], m) || billingLineType(b) !== "recurring") continue;
-      const invId = num2(b["invoiceID"]);
+      const invId = num(b["invoiceID"]);
       const inv = invId > 0 ? invoicesById.get(invId) : void 0;
       if (inv === void 0 || inv["isVoided"] === true) continue;
       billed += lineRevenue(b);
-      ids.push(num2(b["id"]));
+      ids2.push(num(b["id"]));
     }
-    return { billed, ids };
+    return { billed, ids: ids2 };
   };
   const contractRateByRole = /* @__PURE__ */ new Map();
-  for (const r of ratesRaw.items) {
+  for (const r of f.state.ratesRaw.items) {
     const rate = typeof r["internalCurrencyContractHourlyRate"] === "number" ? r["internalCurrencyContractHourlyRate"] : r["contractHourlyRate"];
-    if (num2(r["roleID"]) > 0 && typeof rate === "number" && Number.isFinite(rate)) contractRateByRole.set(num2(r["roleID"]), rate);
+    if (num(r["roleID"]) > 0 && typeof rate === "number" && Number.isFinite(rate)) contractRateByRole.set(num(r["roleID"]), rate);
   }
+  return { monthOf, inMonth, unitIn, lineRevenue, expectedBasis, expectedIn, recurringIn, invoicesById, billedServiceIn, contractRateByRole };
+}
+function coverageGaps(fc, m) {
+  const { f, st, truncatedMonths, v } = fc;
   const monthlyParts = [
-    ["contractServiceUnits", unitsPart],
-    ["contractCharges", chargesPart],
-    ["contractRoleCosts", roleCostsPart],
-    ["billingItems", billingItems],
-    ["timeEntries", timeEntries],
-    ["expenses", expensesPart],
-    ["subscriptions", subscriptionsPart]
+    ["contractServiceUnits", st.unitsPart],
+    ["contractCharges", f.state.chargesPart],
+    ["contractRoleCosts", st.roleCostsPart],
+    ["billingItems", f.billing.billingItems],
+    ["timeEntries", f.time.timeEntries],
+    ["expenses", f.join.expensesPart],
+    ["subscriptions", f.subs.subscriptionsPart]
   ];
-  const coverageGaps = (m) => {
-    const gaps = [];
-    for (const [name, p] of monthlyParts) {
-      if (p.status === "absent") gaps.push(`${name}: absent (${p.absent})`);
-      else if (truncatedMonths[name] !== void 0) {
-        if (truncatedMonths[name].includes(m)) gaps.push(`${name}: truncated at limit ${v.limit}`);
-      } else if (p.hasMore) gaps.push(`${name}: capped at limit ${v.limit}`);
-    }
-    return gaps;
-  };
-  const monthly = [];
-  for (let mi = 0; mi < months.length; mi++) {
-    const m = months[mi];
-    const mBilling = billingRows.filter((b) => inMonth(b["itemDate"], m));
-    let revenueInvoiced = 0;
-    let revenueVoided = 0;
-    let postedUninvoiced = 0;
-    const byType = { recurring: 0, labour: 0, charges: 0, expenses: 0, other: 0 };
-    let unresolvedInvoice = 0;
-    let unresolvedLines = 0;
-    for (const b of mBilling) {
-      const invId = num2(b["invoiceID"]);
-      if (invId <= 0) {
-        postedUninvoiced += lineRevenue(b);
-        continue;
-      }
-      const inv = invoicesById.get(invId);
-      if (inv === void 0) {
-        unresolvedInvoice += lineRevenue(b);
-        unresolvedLines += 1;
-        continue;
-      }
-      if (inv["isVoided"] === true) revenueVoided += lineRevenue(b);
-      else {
-        revenueInvoiced += lineRevenue(b);
-        byType[billingLineType(b)] += lineRevenue(b);
-      }
+  const gaps = [];
+  for (const [name, p] of monthlyParts) {
+    if (p.status === "absent") gaps.push(`${name}: absent (${p.absent})`);
+    else if (truncatedMonths[name] !== void 0) {
+      if (truncatedMonths[name].includes(m)) gaps.push(`${name}: truncated at limit ${v.limit}`);
+    } else if (p.hasMore) gaps.push(`${name}: capped at limit ${v.limit}`);
+  }
+  return gaps;
+}
+function monthRevenue(calc, mBilling) {
+  let revenueInvoiced = 0;
+  let revenueVoided = 0;
+  let postedUninvoiced = 0;
+  const byType = { recurring: 0, labour: 0, charges: 0, expenses: 0, other: 0 };
+  let unresolvedInvoice = 0;
+  let unresolvedLines = 0;
+  for (const b of mBilling) {
+    const invId = num(b["invoiceID"]);
+    if (invId <= 0) {
+      postedUninvoiced += calc.lineRevenue(b);
+      continue;
     }
-    const expected = v.includeUnbilledRevenue && expectedBasis ? expectedIn(m) : null;
-    const expectedUnbilled = expected === null ? 0 : Math.max(0, expected - billedServiceIn(m).billed);
-    const mEntries = entries.filter((e) => inMonth(e["dateWorked"], m));
-    let labourHours = 0;
-    let labourTotal = 0;
-    let unresolved = 0;
-    const rateSources = {};
-    for (const rung of activeRungs) rateSources[rung] = { entries: 0, hours: 0, cost: 0 };
-    rateSources.missing = { entries: 0, hours: 0, cost: 0 };
-    for (const e of mEntries) {
-      const r = entryResolution.get(num2(e["id"]));
-      labourHours += hoursOf(e);
-      const bucket = rateSources[r.source];
-      bucket.entries += 1;
-      bucket.hours += hoursOf(e);
-      bucket.cost += r.cost ?? 0;
-      if (r.source === "missing") unresolved += hoursOf(e);
-      else labourTotal += r.cost ?? 0;
+    const inv = calc.invoicesById.get(invId);
+    if (inv === void 0) {
+      unresolvedInvoice += calc.lineRevenue(b);
+      unresolvedLines += 1;
+      continue;
     }
-    const unposted = mEntries.filter((e) => e["isNonBillable"] !== true && !billedByEntryId.has(num2(e["id"])));
-    const hoursMissing = unposted.some((e) => typeof e["hoursToBill"] !== "number" || !Number.isFinite(e["hoursToBill"]));
-    const hoursPart = hoursMissing ? { entries: unposted.length, hours: null, hoursAbsent: "HOURS_TO_BILL_MISSING" } : { entries: unposted.length, hours: unposted.reduce((a, e) => a + Math.max(0, num2(e["hoursToBill"])), 0) };
-    let unpostedTime;
-    if (!contractTypeKnown) {
-      unpostedTime = { ...hoursPart, value: null, absent: "CONTRACT_TYPE_UNKNOWN" };
-    } else if (!isTimeAndMaterials) {
-      unpostedTime = { ...hoursPart, value: null, absent: "NOT_TIME_AND_MATERIALS_CONTRACT" };
-    } else if (unposted.some((e) => !contractRateByRole.has(num2(e["roleID"])))) {
-      unpostedTime = { ...hoursPart, value: null, absent: "NO_CONTRACT_RATE" };
-    } else if (hoursMissing) {
-      unpostedTime = { ...hoursPart, value: null, absent: "HOURS_TO_BILL_MISSING" };
-    } else {
-      const value = unposted.reduce((a, e) => a + Math.max(0, num2(e["hoursToBill"])) * contractRateByRole.get(num2(e["roleID"])), 0);
-      unpostedTime = { ...hoursPart, value };
+    if (inv["isVoided"] === true) revenueVoided += calc.lineRevenue(b);
+    else {
+      revenueInvoiced += calc.lineRevenue(b);
+      byType[billingLineType(b)] += calc.lineRevenue(b);
     }
-    let toolingVendor = subscriptionsPart.status === "skipped" || subscriptionsPart.status === "absent" ? null : 0;
-    if (toolingVendor !== null) {
-      for (const s of subscriptions) {
-        const eff = monthOf(s["effectiveDate"]) ?? "0000-00";
-        const exp = monthOf(s["expirationDate"]) ?? "9999-99";
-        const sid = num2(s["id"]);
-        if (cancelledSubs.has(sid)) continue;
-        if (oneTimeSubs.has(sid)) {
-          if (eff === m) toolingVendor += num2(s["periodCost"]);
-          continue;
-        }
-        const factor = subFactor.get(sid) ?? null;
-        if (factor !== null && eff <= m && m <= exp) toolingVendor += num2(s["periodCost"]) * factor;
-      }
+  }
+  return { revenueInvoiced, revenueVoided, postedUninvoiced, byType, unresolvedInvoice, unresolvedLines };
+}
+function monthLabour(fc, mEntries) {
+  let labourHours = 0;
+  let labourTotal = 0;
+  let unresolved = 0;
+  const rateSources = {};
+  for (const rung of fc.activeRungs) rateSources[rung] = { entries: 0, hours: 0, cost: 0 };
+  rateSources.missing = { entries: 0, hours: 0, cost: 0 };
+  for (const e of mEntries) {
+    const r = fc.entryResolution.get(num(e["id"]));
+    labourHours += hoursOf(e);
+    const bucket = rateSources[r.source];
+    bucket.entries += 1;
+    bucket.hours += hoursOf(e);
+    bucket.cost += r.cost ?? 0;
+    if (r.source === "missing") unresolved += hoursOf(e);
+    else labourTotal += r.cost ?? 0;
+  }
+  return { labourHours, labourTotal, unresolved, rateSources };
+}
+function monthUnposted(fc, calc, mEntries) {
+  const { contractTypeKnown, isTimeAndMaterials } = fc.f.root;
+  const unposted = mEntries.filter((e) => e["isNonBillable"] !== true && !fc.ladder.billedByEntryId.has(num(e["id"])));
+  const hoursMissing = unposted.some((e) => typeof e["hoursToBill"] !== "number" || !Number.isFinite(e["hoursToBill"]));
+  const hoursPart = hoursMissing ? { entries: unposted.length, hours: null, hoursAbsent: "HOURS_TO_BILL_MISSING" } : { entries: unposted.length, hours: unposted.reduce((a, e) => a + Math.max(0, num(e["hoursToBill"])), 0) };
+  if (!contractTypeKnown) return { ...hoursPart, value: null, absent: "CONTRACT_TYPE_UNKNOWN" };
+  if (!isTimeAndMaterials) return { ...hoursPart, value: null, absent: "NOT_TIME_AND_MATERIALS_CONTRACT" };
+  if (unposted.some((e) => !calc.contractRateByRole.has(num(e["roleID"])))) return { ...hoursPart, value: null, absent: "NO_CONTRACT_RATE" };
+  if (hoursMissing) return { ...hoursPart, value: null, absent: "HOURS_TO_BILL_MISSING" };
+  const value = unposted.reduce((a, e) => a + Math.max(0, num(e["hoursToBill"])) * calc.contractRateByRole.get(num(e["roleID"])), 0);
+  return { ...hoursPart, value };
+}
+function monthToolingVendor(fc, calc, m) {
+  const { subs } = fc.f;
+  if (subs.subscriptionsPart.status === "skipped" || subs.subscriptionsPart.status === "absent") return null;
+  let toolingVendor = 0;
+  for (const s of subs.subscriptions) {
+    const eff = calc.monthOf(s["effectiveDate"]) ?? "0000-00";
+    const exp = calc.monthOf(s["expirationDate"]) ?? "9999-99";
+    const sid = num(s["id"]);
+    if (subs.cancelledSubs.has(sid)) continue;
+    if (subs.oneTimeSubs.has(sid)) {
+      if (eff === m) toolingVendor += num(s["periodCost"]);
+      continue;
     }
-    const callerSupplied = v.externalMonthlyCosts[mi] ?? 0;
-    const recurring = recurringIn(m);
-    let expenseCost = 0;
-    for (const x of expenses) if (inMonth(x["expenseDate"], m)) expenseCost += num2(x["internalCurrencyExpenseAmount"]);
-    const totalCost = labourTotal + callerSupplied + recurring + expenseCost;
-    const profit = revenueInvoiced - totalCost;
-    const margin = revenueInvoiced > 0 ? profit / revenueInvoiced : null;
-    const nonLabour = totalCost - labourTotal;
-    const resolvedHours = mEntries.filter((e) => entryResolution.get(num2(e["id"])).source !== "missing").reduce((a, e) => a + hoursOf(e), 0);
-    const avgRate = resolvedHours > 0 ? labourTotal / resolvedHours : 0;
-    const breakEven = avgRate > 0 ? Math.max(0, (revenueInvoiced - nonLabour) / avgRate) : null;
-    for (const b of Object.values(rateSources)) b.cost = cents(b.cost);
-    const gaps = coverageGaps(m);
-    if (unresolvedLines > 0) gaps.push(`invoices: ${unresolvedLines} line(s) on unresolved invoices`);
-    monthly.push({
-      month: m,
-      revenue_invoiced: cents(revenueInvoiced),
-      revenue_by_type: { recurring: cents(byType.recurring), labour: cents(byType.labour), charges: cents(byType.charges), expenses: cents(byType.expenses), other: cents(byType.other) },
-      revenue_voided_excluded: cents(revenueVoided),
-      revenue_posted_uninvoiced: cents(postedUninvoiced),
-      revenue_unresolved_invoice: cents(unresolvedInvoice),
-      revenue_expected: cents(expected),
-      revenue_expected_unbilled: cents(expectedUnbilled),
-      unposted_time: { ...unpostedTime, value: cents(unpostedTime.value) },
-      labour_hours: labourHours,
-      labour_cost: { total: cents(labourTotal), unresolvedHours: unresolved, rateSources },
-      tooling_cost: { vendor: cents(toolingVendor), caller_supplied: cents(callerSupplied) },
-      recurring_cost: cents(recurring),
-      expense_cost: cents(expenseCost),
-      total_cost: cents(totalCost),
-      profit: cents(profit),
-      margin,
-      break_even_hours: breakEven,
-      coverage_gaps: gaps
-    });
+    const factor = subs.subFactor.get(sid) ?? null;
+    if (factor !== null && eff <= m && m <= exp) toolingVendor += num(s["periodCost"]) * factor;
   }
-  const warnings = [];
-  warnings.push({
-    code: "miscoded_time_out",
-    count: probeRows.length,
-    sample_ids: dedupeSortCap(probeRows.map((p) => num2(p["id"])), v.limit)
-  });
-  const crossTimeEntries = entries.filter((e) => {
-    const t = num2(e["ticketID"]);
+  return toolingVendor;
+}
+function buildMonthlyRow(fc, calc, mi, m) {
+  const { v, f } = fc;
+  const rev = monthRevenue(calc, f.billing.billingRows.filter((b) => calc.inMonth(b["itemDate"], m)));
+  const expected = v.includeUnbilledRevenue && calc.expectedBasis ? calc.expectedIn(m) : null;
+  const expectedUnbilled = expected === null ? 0 : Math.max(0, expected - calc.billedServiceIn(m).billed);
+  const mEntries = f.time.entries.filter((e) => calc.inMonth(e["dateWorked"], m));
+  const lab = monthLabour(fc, mEntries);
+  const unpostedTime = monthUnposted(fc, calc, mEntries);
+  const toolingVendor = monthToolingVendor(fc, calc, m);
+  const callerSupplied = v.externalMonthlyCosts[mi] ?? 0;
+  const recurring = calc.recurringIn(m);
+  let expenseCost = 0;
+  for (const x of f.join.expenses) if (calc.inMonth(x["expenseDate"], m)) expenseCost += num(x["internalCurrencyExpenseAmount"]);
+  const totalCost = lab.labourTotal + callerSupplied + recurring + expenseCost;
+  const profit = rev.revenueInvoiced - totalCost;
+  const margin = rev.revenueInvoiced > 0 ? profit / rev.revenueInvoiced : null;
+  const nonLabour = totalCost - lab.labourTotal;
+  const resolvedHours = mEntries.filter((e) => fc.entryResolution.get(num(e["id"])).source !== "missing").reduce((a, e) => a + hoursOf(e), 0);
+  const avgRate = resolvedHours > 0 ? lab.labourTotal / resolvedHours : 0;
+  const breakEven = avgRate > 0 ? Math.max(0, (rev.revenueInvoiced - nonLabour) / avgRate) : null;
+  for (const b of Object.values(lab.rateSources)) b.cost = cents(b.cost);
+  const gaps = coverageGaps(fc, m);
+  if (rev.unresolvedLines > 0) gaps.push(`invoices: ${rev.unresolvedLines} line(s) on unresolved invoices`);
+  return {
+    month: m,
+    revenue_invoiced: cents(rev.revenueInvoiced),
+    revenue_by_type: { recurring: cents(rev.byType.recurring), labour: cents(rev.byType.labour), charges: cents(rev.byType.charges), expenses: cents(rev.byType.expenses), other: cents(rev.byType.other) },
+    revenue_voided_excluded: cents(rev.revenueVoided),
+    revenue_posted_uninvoiced: cents(rev.postedUninvoiced),
+    revenue_unresolved_invoice: cents(rev.unresolvedInvoice),
+    revenue_expected: cents(expected),
+    revenue_expected_unbilled: cents(expectedUnbilled),
+    unposted_time: { ...unpostedTime, value: cents(unpostedTime.value) },
+    labour_hours: lab.labourHours,
+    labour_cost: { total: cents(lab.labourTotal), unresolvedHours: lab.unresolved, rateSources: lab.rateSources },
+    tooling_cost: { vendor: cents(toolingVendor), caller_supplied: cents(callerSupplied) },
+    recurring_cost: cents(recurring),
+    expense_cost: cents(expenseCost),
+    total_cost: cents(totalCost),
+    profit: cents(profit),
+    margin,
+    break_even_hours: breakEven,
+    coverage_gaps: gaps
+  };
+}
+function buildMonthly(fc, calc) {
+  return fc.months.map((m, mi) => buildMonthlyRow(fc, calc, mi, m));
+}
+
+// src/resources/special/contracts/profitability.quality.ts
+function findCrossTimeEntries(fc) {
+  return fc.f.time.entries.filter((e) => {
+    const t = num(e["ticketID"]);
     if (t <= 0) return false;
-    const ticket = fetchedTickets.get(t);
-    return ticket !== void 0 && num2(ticket["contractID"]) !== idNum;
+    const ticket = fc.f.join.fetchedTickets.get(t);
+    return ticket !== void 0 && num(ticket["contractID"]) !== fc.idNum;
   });
-  warnings.push({ code: "cross_contract_ticket_time", count: crossTimeEntries.length, sample_ids: dedupeSortCap(crossTimeEntries.map((e) => num2(e["id"])), v.limit) });
+}
+function findUnresolvedRefs(fc) {
+  const { fetchedTickets } = fc.f.join;
+  return fc.f.time.entries.filter((e) => num(e["ticketID"]) > 0 && !fetchedTickets.has(num(e["ticketID"])));
+}
+var ids = (rows) => rows.map((e) => num(e["id"]));
+function check1(fc) {
+  const { probeRows } = fc.f.join;
+  return { code: "miscoded_time_out", count: probeRows.length, sample_ids: dedupeSortCap(ids(probeRows), fc.v.limit) };
+}
+function check2(fc, crossTimeEntries) {
+  return { code: "cross_contract_ticket_time", count: crossTimeEntries.length, sample_ids: dedupeSortCap(ids(crossTimeEntries), fc.v.limit) };
+}
+function check3(fc) {
   const tupleGroups = /* @__PURE__ */ new Map();
-  for (const e of entries) {
-    const key = [String(num2(e["resourceID"])), String(e["dateWorked"] ?? ""), String(num2(e["ticketID"])), String(e["hoursWorked"] ?? "")].join("|");
+  for (const e of fc.f.time.entries) {
+    const key = [String(num(e["resourceID"])), String(e["dateWorked"] ?? ""), String(num(e["ticketID"])), String(e["hoursWorked"] ?? "")].join("|");
     const arr = tupleGroups.get(key) ?? [];
     arr.push(e);
     tupleGroups.set(key, arr);
@@ -5502,20 +5745,24 @@ async function profitability(resource, contractId, opts, rawHttp) {
   const dupSample = [];
   for (const group of tupleGroups.values()) {
     if (group.length < 2) continue;
-    const sorted = [...group].sort((a, b) => num2(a["id"]) - num2(b["id"]));
-    for (const e of sorted) dupAll.push(num2(e["id"]));
-    for (const e of sorted.slice(1)) dupSample.push(num2(e["id"]));
+    const sorted = [...group].sort((a, b) => num(a["id"]) - num(b["id"]));
+    for (const e of sorted) dupAll.push(num(e["id"]));
+    for (const e of sorted.slice(1)) dupSample.push(num(e["id"]));
   }
-  warnings.push({ code: "duplicate_entries", count: dupAll.length, sample_ids: dedupeSortCap(dupSample, v.limit) });
-  const zeroHours = entries.filter((e) => {
+  return { code: "duplicate_entries", count: dupAll.length, sample_ids: dedupeSortCap(dupSample, fc.v.limit) };
+}
+function check4(fc) {
+  const zeroHours = fc.f.time.entries.filter((e) => {
     const h = e["hoursWorked"];
     return !(typeof h === "number" && Number.isFinite(h) && h > 0);
   });
-  warnings.push({ code: "zero_negative_hours", count: zeroHours.length, sample_ids: dedupeSortCap(zeroHours.map((e) => num2(e["id"])), v.limit) });
-  const outPeriod = entries.filter((e) => {
-    const t = num2(e["ticketID"]);
+  return { code: "zero_negative_hours", count: zeroHours.length, sample_ids: dedupeSortCap(ids(zeroHours), fc.v.limit) };
+}
+function check5(fc) {
+  const outPeriod = fc.f.time.entries.filter((e) => {
+    const t = num(e["ticketID"]);
     if (t <= 0) return false;
-    const ticket = fetchedTickets.get(t);
+    const ticket = fc.f.join.fetchedTickets.get(t);
     if (ticket === void 0) return false;
     const dW = dateToDay(e["dateWorked"]);
     if (dW === null) return false;
@@ -5525,280 +5772,370 @@ async function profitability(resource, contractId, opts, rawHttp) {
     if (ends.length > 0 && dW > Math.min(...ends)) return true;
     return false;
   });
-  warnings.push({ code: "time_outside_ticket_period", count: outPeriod.length, sample_ids: dedupeSortCap(outPeriod.map((e) => num2(e["id"])), v.limit) });
-  const missingRate = entries.filter((e) => entryResolution.get(num2(e["id"])).source === "missing");
-  warnings.push({ code: "missing_cost_rate", count: missingRate.length, sample_ids: dedupeSortCap(missingRate.map((e) => num2(e["id"])), v.limit) });
+  return { code: "time_outside_ticket_period", count: outPeriod.length, sample_ids: dedupeSortCap(ids(outPeriod), fc.v.limit) };
+}
+function check6(fc) {
+  const missingRate = fc.f.time.entries.filter((e) => fc.entryResolution.get(num(e["id"])).source === "missing");
+  return { code: "missing_cost_rate", count: missingRate.length, sample_ids: dedupeSortCap(ids(missingRate), fc.v.limit) };
+}
+function check7(fc, calc) {
+  const { months, f, v } = fc;
   let driftCount = 0;
   const driftIds = /* @__PURE__ */ new Set();
   if (v.includeRecurringCosts) {
     for (let i = 1; i < months.length; i++) {
-      const r1 = recurringIn(months[i]);
-      const r0 = recurringIn(months[i - 1]);
+      const r1 = calc.recurringIn(months[i]);
+      const r0 = calc.recurringIn(months[i - 1]);
       if (r1 <= 0 || r0 <= 0 || Math.abs(r1 - r0) <= RECURRING_DRIFT_EPSILON) continue;
       driftCount += 1;
       const mA = months[i - 1];
       const mB = months[i];
-      for (const c of charges) {
-        const cA = inMonth(c["datePurchased"], mA) ? chargeCost(c) : 0;
-        const cB = inMonth(c["datePurchased"], mB) ? chargeCost(c) : 0;
-        if (Math.abs(cB - cA) > 0) driftIds.add(num2(c["id"]));
+      for (const c of f.state.charges) {
+        const cA = calc.inMonth(c["datePurchased"], mA) ? chargeCost(c) : 0;
+        const cB = calc.inMonth(c["datePurchased"], mB) ? chargeCost(c) : 0;
+        if (Math.abs(cB - cA) > 0) driftIds.add(num(c["id"]));
       }
-      for (const u of unitRows) {
-        const cA = unitIn(u, mA) ? num2(u["cost"]) : 0;
-        const cB = unitIn(u, mB) ? num2(u["cost"]) : 0;
-        if (Math.abs(cB - cA) > 0) driftIds.add(num2(u["id"]));
+      for (const u of f.state.unitRows) {
+        const cA = calc.unitIn(u, mA) ? num(u["cost"]) : 0;
+        const cB = calc.unitIn(u, mB) ? num(u["cost"]) : 0;
+        if (Math.abs(cB - cA) > 0) driftIds.add(num(u["id"]));
       }
     }
   }
-  warnings.push({ code: "recurring_cost_drift", count: driftCount, sample_ids: dedupeSortCap([...driftIds], v.limit) });
+  return { code: "recurring_cost_drift", count: driftCount, sample_ids: dedupeSortCap([...driftIds], v.limit) };
+}
+function check8(fc, calc) {
   let expectedUnbilledCount = 0;
   const expectedUnbilledSamples = [];
-  if (v.includeUnbilledRevenue && expectedBasis) {
-    for (const m of months) {
-      const { billed, ids } = billedServiceIn(m);
-      if (expectedIn(m) > billed + 5e-3) {
+  if (fc.v.includeUnbilledRevenue && calc.expectedBasis) {
+    for (const m of fc.months) {
+      const { billed, ids: lineIds } = calc.billedServiceIn(m);
+      if (calc.expectedIn(m) > billed + 5e-3) {
         expectedUnbilledCount += 1;
-        for (const i of ids) expectedUnbilledSamples.push(i);
+        for (const i of lineIds) expectedUnbilledSamples.push(i);
       }
     }
   }
-  warnings.push({ code: "expected_unbilled_revenue", count: expectedUnbilledCount, sample_ids: dedupeSortCap(expectedUnbilledSamples, v.limit) });
-  const driftTickets = [...fetchedTickets.values()].filter((t) => num2(t["contractID"]) !== idNum);
-  const unresolvedRefs = entries.filter((e) => num2(e["ticketID"]) > 0 && !fetchedTickets.has(num2(e["ticketID"])));
-  warnings.push({
+  return { code: "expected_unbilled_revenue", count: expectedUnbilledCount, sample_ids: dedupeSortCap(expectedUnbilledSamples, fc.v.limit) };
+}
+function check9(fc, unresolvedRefs) {
+  const driftTickets = [...fc.f.join.fetchedTickets.values()].filter((t) => num(t["contractID"]) !== fc.idNum);
+  return {
     code: "cross_contract_tickets",
     count: driftTickets.length + unresolvedRefs.length,
-    sample_ids: dedupeSortCap([...driftTickets.map((t) => num2(t["id"])), ...unresolvedRefs.map((e) => num2(e["id"]))], v.limit)
-  });
+    sample_ids: dedupeSortCap([...driftTickets.map((t) => num(t["id"])), ...unresolvedRefs.map((e) => num(e["id"]))], fc.v.limit)
+  };
+}
+function check10(fc) {
+  const { openStatusSet } = fc.f.open;
   const stale = [];
   if (openStatusSet !== null) {
-    for (const t of contractTickets) {
+    for (const t of fc.f.join.contractTickets) {
       const status = t["status"];
       if (typeof status !== "number" || !openStatusSet.has(status)) continue;
       const lastDay = dateToDay(t["lastActivityDate"]);
       if (lastDay === null) continue;
-      const days = asOfMs / 864e5 - lastDay;
-      if (days > v.staleAfterDays) stale.push(num2(t["id"]));
+      const days = fc.asOfMs / 864e5 - lastDay;
+      if (days > fc.v.staleAfterDays) stale.push(num(t["id"]));
     }
   }
-  warnings.push({ code: "open_stale_tickets", count: stale.length, sample_ids: dedupeSortCap(stale, v.limit) });
+  return { code: "open_stale_tickets", count: stale.length, sample_ids: dedupeSortCap(stale, fc.v.limit) };
+}
+function check11(fc, monthly) {
+  const { contractRow } = fc.f.root;
   let estimateCount = 0;
   const estimateSample = [];
   let estimateNote;
-  {
-    const actualRevenue = monthly.reduce((a, r) => a + r.revenue_invoiced, 0);
-    const actualCost = monthly.reduce((a, r) => a + r.total_cost, 0);
-    const termStart = dateToDay(contractRow["startDate"]);
-    const termEnd = dateToDay(contractRow["endDate"]);
-    const fromDay = dateToDay(v.dateFrom);
-    const toDay = dateToDay(v.dateTo);
-    if (termStart !== null && termEnd !== null && fromDay !== null && toDay !== null) {
-      const overlapStart = Math.max(termStart, fromDay);
-      const overlapEnd = Math.min(termEnd, toDay);
-      const termDays = termEnd - termStart + 1;
-      const overlapDays = overlapEnd >= overlapStart ? overlapEnd - overlapStart + 1 : 0;
-      if (termDays > 0 && overlapDays > 0) {
-        const frac = overlapDays / termDays;
-        const estRev = num2(contractRow["estimatedRevenue"]);
-        const estCost = num2(contractRow["estimatedCost"]);
-        const devRev = estRev > 0 ? Math.abs(actualRevenue - estRev * frac) / (estRev * frac) : null;
-        const devCost = estCost > 0 ? Math.abs(actualCost - estCost * frac) / (estCost * frac) : null;
-        if (devRev !== null && devRev > ESTIMATE_DEVIATION_THRESHOLD_PCT / 100 || devCost !== null && devCost > ESTIMATE_DEVIATION_THRESHOLD_PCT / 100) {
-          estimateCount = 1;
-          estimateSample.push(idNum);
-        }
-        estimateNote = `estimate vs actual (window-prorated ${overlapDays}/${termDays} days): revenue ${pctOrNa(devRev)} deviation (actual ${fmtNum(actualRevenue)} vs prorated ${fmtNum(estRev * frac)}), cost ${pctOrNa(devCost)} deviation (actual ${fmtNum(actualCost)} vs prorated ${fmtNum(estCost * frac)})`;
+  const actualRevenue = monthly.reduce((a, r) => a + r.revenue_invoiced, 0);
+  const actualCost = monthly.reduce((a, r) => a + r.total_cost, 0);
+  const termStart = dateToDay(contractRow["startDate"]);
+  const termEnd = dateToDay(contractRow["endDate"]);
+  const fromDay = dateToDay(fc.v.dateFrom);
+  const toDay = dateToDay(fc.v.dateTo);
+  if (termStart !== null && termEnd !== null && fromDay !== null && toDay !== null) {
+    const overlapStart = Math.max(termStart, fromDay);
+    const overlapEnd = Math.min(termEnd, toDay);
+    const termDays = termEnd - termStart + 1;
+    const overlapDays = overlapEnd >= overlapStart ? overlapEnd - overlapStart + 1 : 0;
+    if (termDays > 0 && overlapDays > 0) {
+      const frac = overlapDays / termDays;
+      const estRev = num(contractRow["estimatedRevenue"]);
+      const estCost = num(contractRow["estimatedCost"]);
+      const devRev = estRev > 0 ? Math.abs(actualRevenue - estRev * frac) / (estRev * frac) : null;
+      const devCost = estCost > 0 ? Math.abs(actualCost - estCost * frac) / (estCost * frac) : null;
+      if (devRev !== null && devRev > ESTIMATE_DEVIATION_THRESHOLD_PCT / 100 || devCost !== null && devCost > ESTIMATE_DEVIATION_THRESHOLD_PCT / 100) {
+        estimateCount = 1;
+        estimateSample.push(fc.idNum);
       }
+      estimateNote = `estimate vs actual (window-prorated ${overlapDays}/${termDays} days): revenue ${pctOrNa(devRev)} deviation (actual ${fmtNum(actualRevenue)} vs prorated ${fmtNum(estRev * frac)}), cost ${pctOrNa(devCost)} deviation (actual ${fmtNum(actualCost)} vs prorated ${fmtNum(estCost * frac)})`;
     }
   }
-  warnings.push({ code: "estimate_vs_actual", count: estimateCount, sample_ids: estimateSample, ...estimateCount === 1 && estimateNote !== void 0 ? { note: estimateNote } : {} });
+  return { code: "estimate_vs_actual", count: estimateCount, sample_ids: estimateSample, ...estimateCount === 1 && estimateNote !== void 0 ? { note: estimateNote } : {} };
+}
+function buildWarnings(fc, calc, monthly, crossTimeEntries, unresolvedRefs) {
+  return [
+    check1(fc),
+    check2(fc, crossTimeEntries),
+    check3(fc),
+    check4(fc),
+    check5(fc),
+    check6(fc),
+    check7(fc, calc),
+    check8(fc, calc),
+    check9(fc, unresolvedRefs),
+    check10(fc),
+    check11(fc, monthly)
+  ];
+}
+
+// src/resources/special/contracts/profitability.sections.ts
+function makeTicketCalc(fc) {
   const entriesByTicket = /* @__PURE__ */ new Map();
-  for (const e of entries) {
-    const t = num2(e["ticketID"]);
+  for (const e of fc.f.time.entries) {
+    const t = num(e["ticketID"]);
     if (t <= 0) continue;
     const arr = entriesByTicket.get(t) ?? [];
     arr.push(e);
     entriesByTicket.set(t, arr);
   }
   const expenseByTicket = /* @__PURE__ */ new Map();
-  for (const x of expenses) {
-    const t = num2(x["ticketID"]);
+  for (const x of fc.f.join.expenses) {
+    const t = num(x["ticketID"]);
     if (t <= 0) continue;
-    expenseByTicket.set(t, (expenseByTicket.get(t) ?? 0) + num2(x["internalCurrencyExpenseAmount"]));
+    expenseByTicket.set(t, (expenseByTicket.get(t) ?? 0) + num(x["internalCurrencyExpenseAmount"]));
   }
   const ticketCost = (t) => {
-    const tid = num2(t["id"]);
+    const tid = num(t["id"]);
     const es = entriesByTicket.get(tid) ?? [];
     let cost = expenseByTicket.get(tid) ?? 0;
-    for (const e of es) cost += entryResolution.get(num2(e["id"])).cost ?? 0;
+    for (const e of es) cost += fc.entryResolution.get(num(e["id"])).cost ?? 0;
     return cost;
   };
-  const ticketHours = (t) => (entriesByTicket.get(num2(t["id"])) ?? []).reduce((a, e) => a + hoursOf(e), 0);
-  const allTickets = [...fetchedTickets.values()];
+  const ticketHours = (t) => (entriesByTicket.get(num(t["id"])) ?? []).reduce((a, e) => a + hoursOf(e), 0);
+  return { entriesByTicket, ticketCost, ticketHours };
+}
+function buildActivityCategories(fc, tc) {
   const activityCategories = [];
-  if (v.groupByActivity) {
-    const byCat = /* @__PURE__ */ new Map();
-    for (const t of allTickets) {
-      const cat = num2(t["ticketCategory"]) > 0 ? num2(t["ticketCategory"]) : null;
-      const arr = byCat.get(cat) ?? [];
-      arr.push(t);
-      byCat.set(cat, arr);
+  if (!fc.v.groupByActivity) return activityCategories;
+  const byCat = /* @__PURE__ */ new Map();
+  for (const t of fc.f.join.fetchedTickets.values()) {
+    const cat = num(t["ticketCategory"]) > 0 ? num(t["ticketCategory"]) : null;
+    const arr = byCat.get(cat) ?? [];
+    arr.push(t);
+    byCat.set(cat, arr);
+  }
+  for (const [cat, tickets] of byCat) {
+    let entryCount = 0;
+    let hours = 0;
+    let cost = 0;
+    for (const t of tickets) {
+      const es = tc.entriesByTicket.get(num(t["id"])) ?? [];
+      entryCount += es.length;
+      hours += es.reduce((a, e) => a + hoursOf(e), 0);
+      cost += tc.ticketCost(t);
     }
-    for (const [cat, tickets] of byCat) {
-      let entryCount = 0;
-      let hours = 0;
-      let cost = 0;
-      for (const t of tickets) {
-        const es = entriesByTicket.get(num2(t["id"])) ?? [];
-        entryCount += es.length;
-        hours += es.reduce((a, e) => a + hoursOf(e), 0);
-        cost += ticketCost(t);
-      }
-      activityCategories.push({
-        ticketCategory: cat,
-        ticketCount: tickets.length,
-        entryCount,
-        hours,
-        cost: cents(cost),
-        sample_ticketNumbers: dedupeSortCap(tickets.map((t) => num2(t["ticketNumber"])).filter((n) => n > 0), v.limit)
-      });
-    }
-    activityCategories.sort((a, b) => b.cost - a.cost || (a.ticketCategory === null ? 1 : b.ticketCategory === null ? -1 : (a.ticketCategory ?? 0) - (b.ticketCategory ?? 0)));
+    activityCategories.push({
+      ticketCategory: cat,
+      ticketCount: tickets.length,
+      entryCount,
+      hours,
+      cost: cents(cost),
+      sample_ticketNumbers: dedupeSortCap(tickets.map((t) => num(t["ticketNumber"])).filter((n) => n > 0), fc.v.limit)
+    });
   }
-  const highestCostTickets = allTickets.map((t) => ({
-    ticketId: num2(t["id"]),
-    ticketNumber: num2(t["ticketNumber"]) > 0 ? num2(t["ticketNumber"]) : null,
+  activityCategories.sort((a, b) => b.cost - a.cost || (a.ticketCategory === null ? 1 : b.ticketCategory === null ? -1 : (a.ticketCategory ?? 0) - (b.ticketCategory ?? 0)));
+  return activityCategories;
+}
+function buildHighestCostTickets(fc, tc) {
+  return [...fc.f.join.fetchedTickets.values()].map((t) => ({
+    ticketId: num(t["id"]),
+    ticketNumber: num(t["ticketNumber"]) > 0 ? num(t["ticketNumber"]) : null,
     title: typeof t["title"] === "string" ? t["title"] : "",
     status: typeof t["status"] === "number" ? t["status"] : null,
-    hours: ticketHours(t),
-    cost: cents(ticketCost(t)),
+    hours: tc.ticketHours(t),
+    cost: cents(tc.ticketCost(t)),
     lastActivityDate: typeof t["lastActivityDate"] === "string" ? t["lastActivityDate"] : null
-  })).sort((a, b) => b.cost - a.cost || a.ticketId - b.ticketId).slice(0, v.limit);
+  })).sort((a, b) => b.cost - a.cost || a.ticketId - b.ticketId).slice(0, fc.v.limit);
+}
+function buildActivity(fc) {
+  const tc = makeTicketCalc(fc);
+  return { activityCategories: buildActivityCategories(fc, tc), highestCostTickets: buildHighestCostTickets(fc, tc) };
+}
+function buildMiscoding(fc, crossTimeEntries, unresolvedRefs) {
   const miscoding = /* @__PURE__ */ new Map();
   const putMiscoding = (e, reason) => {
-    const eid = num2(e["id"]);
+    const eid = num(e["id"]);
     if (eid <= 0 || miscoding.has(eid)) return;
-    const c = num2(e["contractID"]);
-    miscoding.set(eid, { entryId: eid, reason, ticketId: num2(e["ticketID"]) > 0 ? num2(e["ticketID"]) : null, contractId: c > 0 ? c : null, hours: num2(e["hoursWorked"]) });
+    const c = num(e["contractID"]);
+    miscoding.set(eid, { entryId: eid, reason, ticketId: num(e["ticketID"]) > 0 ? num(e["ticketID"]) : null, contractId: c > 0 ? c : null, hours: num(e["hoursWorked"]) });
   };
-  for (const p of probeRows) putMiscoding(p, num2(p["contractID"]) > 0 ? "ticket_of_other_contract" : "no_contract_on_entry");
+  for (const p of fc.f.join.probeRows) putMiscoding(p, num(p["contractID"]) > 0 ? "ticket_of_other_contract" : "no_contract_on_entry");
   for (const e of crossTimeEntries) putMiscoding(e, "ticket_of_other_contract");
   for (const e of unresolvedRefs) putMiscoding(e, "ticket_not_in_fetched_set");
-  const possibleMiscoding = [...miscoding.values()].sort((a, b) => a.entryId - b.entryId).slice(0, v.limit);
-  const openRenewal = [];
-  if (openStatusSet !== null) {
-    for (const t of contractTickets) {
-      const status = t["status"];
-      if (typeof status !== "number" || !openStatusSet.has(status)) continue;
-      const last = t["lastActivityDate"];
-      const lastDay = typeof last === "string" ? (asOfMs - Date.parse(last.slice(0, 10))) / 864e5 : null;
-      const staleDays = lastDay !== null && lastDay > v.staleAfterDays ? Math.floor(lastDay) : null;
-      openRenewal.push({
-        kind: "ticket",
-        id: num2(t["id"]),
-        label: typeof t["title"] === "string" && t["title"] !== "" ? t["title"] : `ticket ${num2(t["ticketNumber"]) > 0 ? num2(t["ticketNumber"]) : num2(t["id"])}`,
-        date: typeof last === "string" ? last.slice(0, 10) : null,
-        detail: staleDays !== null ? `open \u2014 stale ${staleDays} days (last activity)` : "open"
-      });
-    }
-  }
-  for (const s of subscriptions) {
-    openRenewal.push({
-      kind: "subscription",
-      id: num2(s["id"]),
-      label: typeof s["subscriptionName"] === "string" && s["subscriptionName"] !== "" ? s["subscriptionName"] : `subscription ${num2(s["id"])}`,
-      date: typeof s["expirationDate"] === "string" ? s["expirationDate"].slice(0, 10) : null,
-      detail: `periodType: ${typeof s["periodType"] === "number" ? s["periodType"] : "unknown"} (period cost ${fmtNum(num2(s["periodCost"]))}${cancelledSubs.has(num2(s["id"])) ? " \u2014 not active, not in tooling_cost.vendor" : oneTimeSubs.has(num2(s["id"])) ? " \u2014 one-time, booked in its effective month" : subFactor.get(num2(s["id"])) == null ? " \u2014 unrecognised period, not in tooling_cost.vendor" : `, ${fmtNum(num2(s["periodCost"]) * subFactor.get(num2(s["id"])))}/month`})`
-    });
-  }
-  const contractEndDay = dateToDay(contractRow["endDate"]);
-  if (contractEndDay !== null) {
-    openRenewal.push({
-      kind: "contract_end",
-      id: idNum,
-      label: typeof contractRow["contractName"] === "string" && contractRow["contractName"] !== "" ? contractRow["contractName"] : `contract ${idNum}`,
-      date: String(contractRow["endDate"]).slice(0, 10),
-      detail: `the contract ends ${String(contractRow["endDate"]).slice(0, 10)}`
+  return [...miscoding.values()].sort((a, b) => a.entryId - b.entryId).slice(0, fc.v.limit);
+}
+function openTicketItems(fc) {
+  const { openStatusSet } = fc.f.open;
+  const items = [];
+  if (openStatusSet === null) return items;
+  for (const t of fc.f.join.contractTickets) {
+    const status = t["status"];
+    if (typeof status !== "number" || !openStatusSet.has(status)) continue;
+    const last = t["lastActivityDate"];
+    const lastDay = typeof last === "string" ? (fc.asOfMs - Date.parse(last.slice(0, 10))) / 864e5 : null;
+    const staleDays = lastDay !== null && lastDay > fc.v.staleAfterDays ? Math.floor(lastDay) : null;
+    items.push({
+      kind: "ticket",
+      id: num(t["id"]),
+      label: typeof t["title"] === "string" && t["title"] !== "" ? t["title"] : `ticket ${num(t["ticketNumber"]) > 0 ? num(t["ticketNumber"]) : num(t["id"])}`,
+      date: typeof last === "string" ? last.slice(0, 10) : null,
+      detail: staleDays !== null ? `open \u2014 stale ${staleDays} days (last activity)` : "open"
     });
   }
-  const blocks = blocksPart.items;
-  for (const b of blocks) {
-    const purchased = num2(b["hours"]);
-    const approved = num2(b["hoursApproved"]);
+  return items;
+}
+function subscriptionItems(fc) {
+  const { subscriptions, cancelledSubs, oneTimeSubs, subFactor } = fc.f.subs;
+  return subscriptions.map((s) => ({
+    kind: "subscription",
+    id: num(s["id"]),
+    label: typeof s["subscriptionName"] === "string" && s["subscriptionName"] !== "" ? s["subscriptionName"] : `subscription ${num(s["id"])}`,
+    date: typeof s["expirationDate"] === "string" ? s["expirationDate"].slice(0, 10) : null,
+    detail: `periodType: ${typeof s["periodType"] === "number" ? s["periodType"] : "unknown"} (period cost ${fmtNum(num(s["periodCost"]))}${cancelledSubs.has(num(s["id"])) ? " \u2014 not active, not in tooling_cost.vendor" : oneTimeSubs.has(num(s["id"])) ? " \u2014 one-time, booked in its effective month" : subFactor.get(num(s["id"])) == null ? " \u2014 unrecognised period, not in tooling_cost.vendor" : `, ${fmtNum(num(s["periodCost"]) * subFactor.get(num(s["id"])))}/month`})`
+  }));
+}
+function contractEndItems(fc) {
+  const { contractRow } = fc.f.root;
+  if (dateToDay(contractRow["endDate"]) === null) return [];
+  return [{
+    kind: "contract_end",
+    id: fc.idNum,
+    label: typeof contractRow["contractName"] === "string" && contractRow["contractName"] !== "" ? contractRow["contractName"] : `contract ${fc.idNum}`,
+    date: String(contractRow["endDate"]).slice(0, 10),
+    detail: `the contract ends ${String(contractRow["endDate"]).slice(0, 10)}`
+  }];
+}
+function hourBlockItems(fc) {
+  const blocks = fc.f.state.blocksPart.items;
+  return blocks.map((b) => {
+    const purchased = num(b["hours"]);
+    const approved = num(b["hoursApproved"]);
     const left = purchased - approved;
-    openRenewal.push({
+    return {
       kind: "included_hours_burn",
-      id: num2(b["id"]),
-      label: `hour block ${num2(b["id"])}`,
+      id: num(b["id"]),
+      label: `hour block ${num(b["id"])}`,
       date: typeof b["endDate"] === "string" ? b["endDate"].slice(0, 10) : null,
       detail: `${fmtHours(approved)} h approved of ${fmtHours(purchased)} h purchased (${left >= 0 ? `${fmtHours(left)} h left` : `${fmtHours(Math.abs(left))} h over`})`
-    });
-  }
-  const purchasedHours = blocks.reduce((a, b) => a + num2(b["hours"]), 0);
-  const approvedHours = blocks.reduce((a, b) => a + num2(b["hoursApproved"]), 0);
-  const includedHours = !contractTypeKnown ? { value: null, absent: "CONTRACT_TYPE_UNKNOWN" } : !isBlockHours ? { value: null, absent: "NOT_BLOCK_HOURS_CONTRACT" } : blocksPart.status === "absent" ? { value: null, absent: blocksPart.absent } : { value: { purchased: purchasedHours, approved: approvedHours, remaining: purchasedHours - approvedHours } };
-  const rows = (part) => {
-    if (v.includeRows) return part;
+    };
+  });
+}
+function buildOpenRenewal(fc) {
+  return [...openTicketItems(fc), ...subscriptionItems(fc), ...contractEndItems(fc), ...hourBlockItems(fc)];
+}
+function buildIncludedHours(fc) {
+  const { contractTypeKnown, isBlockHours } = fc.f.root;
+  const { blocksPart } = fc.f.state;
+  const blocks = blocksPart.items;
+  const purchasedHours = blocks.reduce((a, b) => a + num(b["hours"]), 0);
+  const approvedHours = blocks.reduce((a, b) => a + num(b["hoursApproved"]), 0);
+  return !contractTypeKnown ? { value: null, absent: "CONTRACT_TYPE_UNKNOWN" } : !isBlockHours ? { value: null, absent: "NOT_BLOCK_HOURS_CONTRACT" } : blocksPart.status === "absent" ? { value: null, absent: blocksPart.absent } : { value: { purchased: purchasedHours, approved: approvedHours, remaining: purchasedHours - approvedHours } };
+}
+
+// src/resources/special/contracts/profitability.ts
+function summarizeRows(includeRows) {
+  return (part) => {
+    if (includeRows) return part;
     const { items, ...stamps } = part;
     return { ...stamps, rows_fetched: items.length };
   };
+}
+function partStatuses(f, st) {
+  return {
+    contract: "ok",
+    customer: f.root.customerStatus,
+    contractServices: st.servicesPart.status,
+    contractServiceUnits: st.unitsPart.status,
+    contractCharges: f.state.chargesPart.status,
+    contractRoleCosts: st.roleCostsPart.status,
+    contractRates: st.ratesPart.status,
+    contractBlocks: f.state.blocksPart.status,
+    billingItems: f.billing.billingItems.status,
+    invoices: f.billing.invoicesPart.status,
+    timeEntries: f.time.timeEntries.status,
+    ticketsActivity: st.ticketsActivityPart.status,
+    ticketsOpen: f.open.ticketsOpenPart.status,
+    resources: f.res.resourcesPart.status,
+    expenses: f.join.expensesPart.status,
+    miscodingProbe: f.join.probePart.status,
+    configurationItems: f.subs.configurationItemsPart.status,
+    subscriptions: f.subs.subscriptionsPart.status
+  };
+}
+function partContainers(fc) {
+  const { f, st } = fc;
+  const rows = summarizeRows(fc.v.includeRows);
+  return {
+    contractServices: rows(st.servicesPart),
+    contractServiceUnits: rows(st.unitsPart),
+    contractCharges: rows(f.state.chargesPart),
+    contractRoleCosts: rows(st.roleCostsPart),
+    contractRates: rows(st.ratesPart),
+    contractBlocks: rows(f.state.blocksPart),
+    billingItems: rows(f.billing.billingItems),
+    invoices: rows(f.billing.invoicesPart),
+    timeEntries: rows(f.time.timeEntries),
+    ticketsActivity: rows(st.ticketsActivityPart),
+    ticketsOpen: rows(f.open.ticketsOpenPart),
+    resources: rows(f.res.resourcesPart),
+    expenses: rows(f.join.expensesPart),
+    miscodingProbe: rows(f.join.probePart),
+    configurationItems: rows(f.subs.configurationItemsPart),
+    subscriptions: rows(f.subs.subscriptionsPart)
+  };
+}
+var CURRENCY_NOTE = "single-currency P&L in the INTERNAL currency: revenue is billing items internalCurrencyExtendedPrice and service units internalCurrencyPrice (each falling back to the local field when absent), unposted value the internalCurrencyContractHourlyRate; costs are internal (ourCost/role cost/internalCost, charge extendedCost, unit cost, internalCurrencyExpenseAmount). companyCurrencyID is the customer context stamp only";
+function assemble(ctx, fc, asOf) {
+  const { v, f } = fc;
+  const { customer } = f.root;
+  const calc = makeMonthCalc(fc);
+  const monthly = buildMonthly(fc, calc);
+  const crossTimeEntries = findCrossTimeEntries(fc);
+  const unresolvedRefs = findUnresolvedRefs(fc);
+  const warnings = buildWarnings(fc, calc, monthly, crossTimeEntries, unresolvedRefs);
+  const { activityCategories, highestCostTickets } = buildActivity(fc);
+  const { contractType, contractTypeKnown, contractTypeLabel, customerAbsent } = f.root;
   return {
-    contract,
+    contract: f.root.contract,
     customer,
     ...customerAbsent !== void 0 ? { customerAbsent } : {},
     contract_type: contractTypeKnown ? { id: contractType, label: contractTypeLabel } : { id: contractType > 0 ? contractType : null, label: null, absent: "CONTRACT_TYPE_UNKNOWN" },
-    included_hours: includedHours,
-    period: { dateFrom: v.dateFrom, dateTo: v.dateTo, months, asOf },
+    included_hours: buildIncludedHours(fc),
+    period: { dateFrom: v.dateFrom, dateTo: v.dateTo, months: fc.months, asOf },
     currency: {
       companyCurrencyID: customer && typeof customer["currencyID"] === "number" ? customer["currencyID"] : null,
-      note: "single-currency P&L in the INTERNAL currency: revenue is billing items internalCurrencyExtendedPrice and service units internalCurrencyPrice (each falling back to the local field when absent), unposted value the internalCurrencyContractHourlyRate; costs are internal (ourCost/role cost/internalCost, charge extendedCost, unit cost, internalCurrencyExpenseAmount). companyCurrencyID is the customer context stamp only"
+      note: CURRENCY_NOTE
     },
     monthly,
     activity_categories: activityCategories,
     highest_cost_tickets: highestCostTickets,
-    possible_miscoding: possibleMiscoding,
-    open_renewal_items: openRenewal,
+    possible_miscoding: buildMiscoding(fc, crossTimeEntries, unresolvedRefs),
+    open_renewal_items: buildOpenRenewal(fc),
     data_quality_warnings: warnings,
-    costRateResolution,
-    parts: {
-      contract: "ok",
-      customer: customerStatus,
-      contractServices: servicesPart.status,
-      contractServiceUnits: unitsPart.status,
-      contractCharges: chargesPart.status,
-      contractRoleCosts: roleCostsPart.status,
-      contractRates: ratesPart.status,
-      contractBlocks: blocksPart.status,
-      billingItems: billingItems.status,
-      invoices: invoicesPart.status,
-      timeEntries: timeEntries.status,
-      ticketsActivity: ticketsActivityPart.status,
-      ticketsOpen: ticketsOpenPart.status,
-      resources: resourcesPart.status,
-      expenses: expensesPart.status,
-      miscodingProbe: probePart.status,
-      configurationItems: configurationItemsPart.status,
-      subscriptions: subscriptionsPart.status
-    },
-    contractServices: rows(servicesPart),
-    contractServiceUnits: rows(unitsPart),
-    contractCharges: rows(chargesPart),
-    contractRoleCosts: rows(roleCostsPart),
-    contractRates: rows(ratesPart),
-    contractBlocks: rows(blocksPart),
-    billingItems: rows(billingItems),
-    invoices: rows(invoicesPart),
-    timeEntries: rows(timeEntries),
-    ticketsActivity: rows(ticketsActivityPart),
-    ticketsOpen: rows(ticketsOpenPart),
-    resources: rows(resourcesPart),
-    expenses: rows(expensesPart),
-    miscodingProbe: rows(probePart),
-    configurationItems: rows(configurationItemsPart),
-    subscriptions: rows(subscriptionsPart),
-    wires: { issued: wires.issued, requests: wires.requests, budget: wires.budget, note: wires.note }
+    costRateResolution: fc.costRateResolution,
+    parts: partStatuses(f, fc.st),
+    ...partContainers(fc),
+    wires: { issued: ctx.wires.issued, requests: ctx.wires.requests, budget: ctx.wires.budget, note: ctx.wires.note }
   };
 }
+async function profitability(resource, contractId, opts, rawHttp) {
+  const v = validateProfitabilityOptions(contractId, opts);
+  const ctx = makeFetchCtx(rawHttp, v, contractId, PROFITABILITY_WIRE_BUDGET);
+  const asOf = (/* @__PURE__ */ new Date()).toISOString();
+  const f = await gather(ctx, resource);
+  const fc = makeFoldCtx(ctx, f, stampListParts(v, f), Date.parse(asOf));
+  return assemble(ctx, fc, asOf);
+}
 
 // src/resources/contracts.ts
 var ContractsResource = class extends BaseResource {
@@ -7366,18 +7703,18 @@ var ProjectsResource = class extends BaseResource {
    * closed scope; project picklists stay label-less) + the top-level `names` section;
    * `maxNameReads` may lower the name-read budget (default 20), never raise it. */
   async getContext(id, opts = {}) {
-    const project = await this.fetchRecordRaw("/V1.0/Projects", id);
-    const root = project;
+    const project2 = await this.fetchRecordRaw("/V1.0/Projects", id);
+    const root = project2;
     const company = await this.contextFetch("/V1.0/Companies", root["companyID"]);
     const opportunity = await this.contextFetch("/V1.0/Opportunities", root["opportunityID"]);
     const leadResource = await this.contextFetch("/V1.0/Resources", root["projectLeadResourceID"]);
-    const result = { project, company, opportunity, leadResource };
+    const result = { project: project2, company, opportunity, leadResource };
     if (opts.names === true) {
       const builder = createNamePlan();
       builder.addResource(root["creatorResourceID"]);
       builder.addFk("contract", root["contractID"]);
       const names = await resolveCompositeNames(this.http, builder.plan(), { maxNameReads: opts.maxNameReads });
-      const row = { ...project };
+      const row = { ...project2 };
       addNameSibling(row, "creatorResourceID", (v) => names.resourceName(v));
       addNameSibling(row, "contractID", (v) => names.recordName("contract", v));
       result.project = row;
@@ -8013,15 +8350,15 @@ var ResourceSkillsResource = class extends BaseResource {
 
 // src/resources/special/resources.ts
 var MAX_TRANSFER_IDS = 500;
-function requirePositiveIds(ids, label) {
-  if (!Array.isArray(ids) || ids.length === 0) {
+function requirePositiveIds(ids2, label) {
+  if (!Array.isArray(ids2) || ids2.length === 0) {
     throw new AutotaskConfigError(`${label}: at least one positive integer id is required`);
   }
-  if (ids.length > MAX_TRANSFER_IDS) {
+  if (ids2.length > MAX_TRANSFER_IDS) {
     throw new AutotaskConfigError(`${label}: at most ${MAX_TRANSFER_IDS} ids are accepted (bounded fan-out)`);
   }
   const out = [];
-  for (const raw of ids) {
+  for (const raw of ids2) {
     const id = parseIdentifier(raw, `${label} id`);
     if (typeof id === "number" && id < 1) {
       throw new AutotaskConfigError(`${label}: every id must be a positive integer (got ${String(raw)})`);
@@ -8044,16 +8381,16 @@ async function whoAmI(_resource, userName, http) {
   const matches = unwrapItems(res).items;
   if (matches.length === 0) return null;
   if (matches.length > 1) {
-    const ids = matches.map((m) => m.id).filter((id) => typeof id === "number");
+    const ids2 = matches.map((m) => m.id).filter((id) => typeof id === "number");
     throw new ResolutionError(
       `whoAmI: "${value}" is ambiguous (matched ${matches.length} resources)`,
-      { code: "RESOLUTION_AMBIGUOUS", resourceIds: ids, details: { idRefs: ids.map((cid) => ({ entity: "resource", id: cid })) } }
+      { code: "RESOLUTION_AMBIGUOUS", resourceIds: ids2, details: { idRefs: ids2.map((cid) => ({ entity: "resource", id: cid })) } }
     );
   }
   return matches[0];
 }
 async function transferOwnership(_resource, companyIds, destinationResourceId, http, opts) {
-  const ids = requirePositiveIds(companyIds, "transferOwnership");
+  const ids2 = requirePositiveIds(companyIds, "transferOwnership");
   const destination = parseIdentifier(destinationResourceId, "destinationResourceId");
   if (typeof destination === "number" && destination < 1) {
     throw new AutotaskConfigError("transferOwnership: destinationResourceId must be a positive integer");
@@ -8061,7 +8398,7 @@ async function transferOwnership(_resource, companyIds, destinationResourceId, h
   const dryRun = opts?.dryRun ?? true;
   const changes = [];
   const applied = [];
-  for (const id of ids) {
+  for (const id of ids2) {
     try {
       const res = await http.request({
         method: "GET",
@@ -8087,7 +8424,7 @@ async function transferOwnership(_resource, companyIds, destinationResourceId, h
       if (!dryRun && err instanceof AutotaskError) {
         err.resourceIds = [id];
         err.details = mergeDetails(err.details, { idRefs: [{ entity: "company", id }] });
-        err.suggestedAction = `Partial transfer: ${applied.length} of ${ids.length} companies were re-owned (ids: ${applied.join(", ") || "none"}); id ${id} failed. Re-run transferOwnership for the remaining ids (from ${id} on).`;
+        err.suggestedAction = `Partial transfer: ${applied.length} of ${ids2.length} companies were re-owned (ids: ${applied.join(", ") || "none"}); id ${id} failed. Re-run transferOwnership for the remaining ids (from ${id} on).`;
       }
       throw err;
     }
@@ -8100,18 +8437,18 @@ async function transferOwnership(_resource, companyIds, destinationResourceId, h
         method: "PUT",
         path: "/V1.0/Companies",
         // the collection (D1: the item path is GET-only)
-        ids,
+        ids: ids2,
         checks: [
           { name: "ids-positive-integer", ok: true },
           { name: "destination-valid", ok: true },
           { name: "owner-change-pending", ok: anyChange }
         ],
-        impact: { affected: ids.length, scope: "companies ownerResourceID", reversible: true },
+        impact: { affected: ids2.length, scope: "companies ownerResourceID", reversible: true },
         warnings: [
-          `the per-record request fans out to ${ids.length} id${ids.length === 1 ? "" : "s"} (bounded ${MAX_TRANSFER_IDS})`
+          `the per-record request fans out to ${ids2.length} id${ids2.length === 1 ? "" : "s"} (bounded ${MAX_TRANSFER_IDS})`
         ]
       }, { redactPersonalData: http.redactPersonalData }),
-      target: { resource: "companies", ids },
+      target: { resource: "companies", ids: ids2 },
       changes
     };
   }
@@ -9731,6 +10068,230 @@ var TicketChangeRequestApprovalsResource = class extends BaseResource {
   }
 };
 
+// src/resources/special/_shared/move-engine.ts
+import { randomUUID } from "crypto";
+var MOVE_SOURCE_AGE_DEFAULT_DAYS = 14;
+var TICKET_COMPLETE_STATUS = 5;
+var MOVE_EFFECTS_NOTE = "Create then delete: the new record gets a fresh create date and creator; creating/deleting may trigger notifications, SLA and workflow rules the API cannot suppress; vendor acceptance of the create is not validated by a dry run";
+var refuse = (code, message, ids2, operation, extra = {}) => new MoveRefusedError(message, { code, operation, details: { status: "failed", ...ids2, ...extra } });
+async function queryRows(http, resource, filter, operation, retries) {
+  const res = await http.request({ method: "POST", idempotent: true, path: `/V1.0/${resource}/query`, body: { MaxRecords: 5, filter }, operation, maxRetries: retries });
+  return unwrapItems(res).items;
+}
+function sameValue(a, b) {
+  if (a === null || a === void 0 || a === "") return b === null || b === void 0 || b === "";
+  if (b === null || b === void 0 || b === "") return false;
+  if (typeof a === "number" || typeof b === "number") return Math.abs(Number(a) - Number(b)) < 1e-9;
+  if (typeof a === "boolean" || typeof b === "boolean") return a === b;
+  if (typeof a === "string" && typeof b === "string") {
+    const iso3 = /^\d{4}-\d{2}-\d{2}T/;
+    if (iso3.test(a) && iso3.test(b)) return Date.parse(a) === Date.parse(b);
+    return a.trim() === b.trim();
+  }
+  return JSON.stringify(a) === JSON.stringify(b);
+}
+async function readTicket(http, id, retries, operation) {
+  try {
+    const res = await http.request({ method: "GET", path: `/V1.0/Tickets/${id}`, operation, maxRetries: retries });
+    const item = res?.item;
+    return item ?? null;
+  } catch (e) {
+    if (isAutotaskError(e) && (e.httpStatus === 404 || e.code === "NOT_FOUND")) return null;
+    throw e;
+  }
+}
+async function preview(http, spec, sourceId, toTicketId, opts) {
+  const op = spec.operation;
+  const ids2 = { sourceId, toTicketId };
+  const source = await spec.readSource(http, sourceId, opts.maxRetries);
+  if (source === null) throw refuse("MOVE_SOURCE_NOT_FOUND", `${op}: source ${spec.entity} ${sourceId} does not exist`, ids2, op);
+  const sourceTicketId = spec.sourceTicketId(source);
+  if (typeof sourceTicketId !== "number") {
+    throw refuse("MOVE_SOURCE_UNSUPPORTED", `${op}: source ${spec.entity} ${sourceId} is not attached to a ticket (task and internal records are not moved)`, ids2, op);
+  }
+  if (sourceTicketId === toTicketId) throw refuse("MOVE_TARGET_SAME", `${op}: target ticket ${toTicketId} is the source's current ticket`, ids2, op);
+  if (opts.lastModifiedDate !== void 0) {
+    const current = source.lastModifiedDateTime ?? source.lastModifiedDate;
+    if (current !== opts.lastModifiedDate) {
+      throw refuse("STALE_OBJECT", `${op}: source ${spec.entity} ${sourceId} was modified since the snapshot`, ids2, op);
+    }
+  }
+  const cap = opts.maxSourceAgeDays === void 0 ? MOVE_SOURCE_AGE_DEFAULT_DAYS : Math.min(MOVE_SOURCE_AGE_DEFAULT_DAYS, opts.maxSourceAgeDays);
+  if (!Number.isFinite(cap) || cap < 0) throw new AutotaskConfigError(`${op}: maxSourceAgeDays must be a number >= 0`);
+  const when = Date.parse(String(source[spec.dateField] ?? ""));
+  if (!Number.isFinite(when) || Date.now() - when > cap * 864e5) {
+    throw refuse("MOVE_SOURCE_TOO_OLD", `${op}: source ${spec.entity} ${sourceId} is older than ${cap} day(s) (or undated) \u2014 move it in the Autotask UI`, ids2, op, { manualAction: manualFor(http, spec, source, "older than the move age limit") });
+  }
+  const target = await readTicket(http, toTicketId, opts.maxRetries, op);
+  if (target === null) throw refuse("MOVE_TARGET_MISSING", `${op}: target ticket ${toTicketId} does not exist`, ids2, op);
+  if (target.status === TICKET_COMPLETE_STATUS || target.completedDate !== void 0 && target.completedDate !== null) {
+    throw refuse("MOVE_TARGET_CLOSED", `${op}: target ticket ${toTicketId} is closed (status 5 or completed)`, ids2, op);
+  }
+  const origin = await readTicket(http, sourceTicketId, opts.maxRetries, op);
+  const facts = {
+    sourceTicketId,
+    sourceCompanyID: origin?.companyID ?? null,
+    targetCompanyID: target.companyID ?? null,
+    companyChanged: origin === null ? null : origin.companyID !== target.companyID,
+    contractChanged: origin === null ? null : (origin.contractID ?? null) !== (target.contractID ?? null)
+  };
+  const ctx = { http, spec, sourceId, source, sourceTicketId, toTicketId, facts, retries: opts.maxRetries };
+  await spec.checkSource(ctx);
+  const sameScope = facts.companyChanged === false && facts.contractChanged === false;
+  const payload = spec.buildPayload(source, toTicketId, { sameScope });
+  await assertNoTwin(ctx, payload);
+  return { ctx, payload };
+}
+function manualFor(http, spec, source, reason) {
+  return { action: "delete_source", uiLink: spec.manualLink(http, source), reason };
+}
+async function assertNoTwin(ctx, payload) {
+  const q = ctx.spec.twinQuery(payload);
+  const rows = await queryRows(ctx.http, q.resource, q.filter, ctx.spec.operation, ctx.retries);
+  if (rows.length > 0) {
+    throw refuse("MOVE_TARGET_HAS_TWIN", `${ctx.spec.operation}: target ticket ${ctx.toTicketId} already has an equivalent ${ctx.spec.entity} (id ${String(rows[0].id)}) \u2014 a duplicate or resumed move`, { sourceId: ctx.sourceId, toTicketId: ctx.toTicketId }, ctx.spec.operation, { twinId: rows[0].id });
+  }
+}
+var statusOf = (e) => isAutotaskError(e) ? e.httpStatus : void 0;
+async function runMove(http, spec, sourceIdIn, toTicketIn, opts = {}) {
+  const op = spec.operation;
+  const sourceId = Number(parseIdentifier(sourceIdIn, "sourceId"));
+  const toTicketId = Number(parseIdentifier(toTicketIn, "toTicketId"));
+  if (!Number.isSafeInteger(sourceId) || !Number.isSafeInteger(toTicketId)) {
+    throw new AutotaskConfigError(`${op}: sourceId and toTicketId must be safe integers`);
+  }
+  const { ctx, payload } = await preview(http, spec, sourceId, toTicketId, opts);
+  if (opts.dryRun === true) {
+    return buildDryRunResult(
+      {
+        operation: op,
+        method: "POST",
+        path: spec.createPath(toTicketId),
+        ids: [sourceId],
+        checks: [
+          { name: "source-exists", ok: true },
+          { name: "target-open", ok: true },
+          { name: "invariants", ok: true },
+          { name: "no-twin-on-target", ok: true }
+        ],
+        impact: { affected: 2, scope: "create-then-delete", reversible: false },
+        warnings: [MOVE_EFFECTS_NOTE, ...ctx.facts.companyChanged === true ? ["the target ticket belongs to a different company"] : []],
+        data: payload
+      },
+      { redactPersonalData: http.redactPersonalData }
+    );
+  }
+  const correlationId = randomUUID();
+  const ids2 = { sourceId, toTicketId, correlationId };
+  await assertNoTwin(ctx, payload);
+  let newId;
+  try {
+    const created = await http.request({ method: "POST", path: spec.createPath(toTicketId), body: payload, operation: op, maxRetries: 0 });
+    newId = Number(unwrapOperation(created, op).id);
+  } catch (e) {
+    const status = statusOf(e);
+    if (status !== void 0 && status >= 400 && status < 500) {
+      throw new MoveRefusedError(`${op}: the vendor refused the create \u2014 nothing changed`, { code: "MOVE_CREATE_REFUSED", operation: op, httpStatus: status, details: { status: "failed", ...ids2 } });
+    }
+    throw new MoveRefusedError(`${op}: the create outcome is unknown (never resent) \u2014 check the target ticket for a new ${spec.entity} before retrying; the twin check blocks a second create`, { code: "MOVE_UNKNOWN", operation: op, details: { status: "unknown", ...ids2 } });
+  }
+  const rollback = async (code, message) => {
+    try {
+      await http.request({ method: "DELETE", path: spec.deletePath(newId, toTicketId), operation: op, maxRetries: 0 });
+    } catch (re) {
+      const unreadable = statusOf(re) === void 0 || (statusOf(re) ?? 0) >= 500;
+      throw new MoveRefusedError(`${op}: ${message}; rolling back the new ${spec.entity} ${newId} FAILED \u2014 both records exist`, { code: unreadable ? "MOVE_UNKNOWN" : "MOVE_PARTIAL", operation: op, details: { status: unreadable ? "unknown" : "partial", ...ids2, newId, reason: code } });
+    }
+    throw new MoveRefusedError(`${op}: ${message}; the new ${spec.entity} ${newId} was rolled back, the source is unchanged`, { code, operation: op, details: { status: "failed", ...ids2, newId } });
+  };
+  const fresh = await spec.readById(http, newId, toTicketId).catch(() => null);
+  if (fresh === null) return rollback("MOVE_VERIFY_FAILED", "the new record could not be read back");
+  const mismatched = [...spec.verifyFields, "ticketID"].filter((f) => !sameValue(f === "ticketID" ? toTicketId : payload[f], fresh[f]));
+  if (mismatched.length > 0) return rollback("MOVE_VERIFY_FAILED", `the read-back differs on ${mismatched.join(", ")}`);
+  const again = await spec.readSource(http, sourceId, void 0).catch(() => null);
+  if (again === null) {
+    return { status: "moved_source_absent", sourceId, newId, correlationId, snapshot: ctx.source, facts: ctx.facts };
+  }
+  const changed = [...spec.guardFields].filter((f) => !sameValue(ctx.source[f], again[f]));
+  if (changed.length > 0) return rollback("MOVE_SOURCE_CHANGED", `the source changed after the preview (${changed.join(", ")})`);
+  try {
+    await http.request({ method: "DELETE", path: spec.deletePath(sourceId, ctx.sourceTicketId), operation: op, maxRetries: 0 });
+  } catch (e) {
+    const status = statusOf(e);
+    if (status === 404) return { status: "moved_source_absent", sourceId, newId, correlationId, snapshot: ctx.source, facts: ctx.facts };
+    if (status !== void 0 && status >= 400 && status < 500) {
+      return {
+        status: "moved_manual_delete",
+        sourceId,
+        newId,
+        correlationId,
+        snapshot: ctx.source,
+        facts: ctx.facts,
+        manualAction: manualFor(http, spec, ctx.source, `the vendor refused to delete the source (HTTP ${status}); the verified copy exists on the target \u2014 delete the source in the Autotask UI`)
+      };
+    }
+    if (status === void 0) {
+      throw new MoveRefusedError(`${op}: the source delete outcome is unknown (never resent) \u2014 re-read the source: absent means the move completed`, { code: "MOVE_UNKNOWN", operation: op, details: { status: "unknown", ...ids2, newId } });
+    }
+    return rollback("MOVE_SOURCE_DELETE_FAILED", `the source delete failed (HTTP ${status})`);
+  }
+  return { status: "moved", sourceId, newId, correlationId, snapshot: ctx.source, facts: ctx.facts };
+}
+function uiLinkFor(http, entity, id) {
+  return buildUiLink({ entity, id, baseUrl: http.baseUrl }) ?? null;
+}
+
+// src/resources/special/ticket_charges.ts
+var OP2 = "ticket_charges.moveToTicket";
+var COPY = ["name", "description", "chargeType", "billingCodeID", "productID", "unitQuantity", "unitCost", "unitPrice", "datePurchased", "isBillableToCompany", "notes", "purchaseOrderNumber", "internalPurchaseOrderNumber"];
+var CONTRACT_SCOPED = ["contractServiceID", "contractServiceBundleID"];
+async function readCharge(http, id, retries) {
+  const rows = await queryRows(http, "TicketCharges", [{ field: "id", op: "eq", value: id }], OP2, retries);
+  return rows[0] ?? null;
+}
+async function checkSource({ http, source, sourceId, sourceTicketId, toTicketId }) {
+  if (source.isBilled === true) {
+    throw refuse("MOVE_BLOCKED_BILLED", `${OP2}: ticket charge ${sourceId} is billed \u2014 move it in the Autotask UI`, { sourceId, toTicketId }, OP2, {
+      manualAction: { action: "delete_source", uiLink: uiLinkFor(http, "tickets", sourceTicketId), reason: "billed charges are not moved by the API (the ticket link opens its charges)" }
+    });
+  }
+}
+var SPEC = {
+  operation: OP2,
+  entity: "ticket_charge",
+  readSource: readCharge,
+  sourceTicketId: (s) => typeof s.ticketID === "number" ? s.ticketID : null,
+  dateField: "datePurchased",
+  checkSource,
+  buildPayload(source, toTicketId, { sameScope }) {
+    const body = { ticketID: toTicketId };
+    for (const k of COPY) if (source[k] !== void 0 && source[k] !== null) body[k] = source[k];
+    if (sameScope) {
+      for (const k of CONTRACT_SCOPED) if (source[k] !== void 0 && source[k] !== null) body[k] = source[k];
+    }
+    return body;
+  },
+  createPath: (toTicketId) => `/V1.0/Tickets/${toTicketId}/Charges`,
+  deletePath: (id, ticketId) => `/V1.0/Tickets/${ticketId}/Charges/${id}`,
+  readById: (http, id) => readCharge(http, id),
+  verifyFields: ["name", "chargeType", "billingCodeID", "unitQuantity", "unitCost", "unitPrice", "datePurchased", "isBillableToCompany"],
+  guardFields: ["ticketID", "name", "chargeType", "billingCodeID", "unitQuantity", "unitCost", "unitPrice", "datePurchased", "isBilled"],
+  twinQuery: (p) => ({
+    resource: "TicketCharges",
+    filter: [
+      { field: "ticketID", op: "eq", value: p.ticketID },
+      { field: "name", op: "eq", value: p.name },
+      { field: "unitQuantity", op: "eq", value: p.unitQuantity },
+      { field: "datePurchased", op: "eq", value: p.datePurchased }
+    ]
+  }),
+  // charges have no ExecuteCommand code: the parent ticket is the closest clickable target
+  manualLink: (http, source) => typeof source.ticketID === "number" ? uiLinkFor(http, "tickets", source.ticketID) : null
+};
+function moveToTicket(_resource, sourceId, toTicketId, opts, http) {
+  return runMove(http, SPEC, sourceId, toTicketId, opts);
+}
+
 // src/resources/ticket_charges.ts
 var TicketChargesResource = class extends BaseResource {
   constructor(http, pageSize) {
@@ -9800,6 +10361,10 @@ var TicketChargesResource = class extends BaseResource {
   async search(query, opts) {
     return this.searchBase(query, opts);
   }
+  /** Node-parity special op (hand-written in src/resources/special/ticket_charges.ts). */
+  moveToTicket(sourceId, toTicketId, opts = {}) {
+    return moveToTicket(this, sourceId, toTicketId, opts, this.http);
+  }
 };
 
 // src/resources/ticket_checklist_items.ts
@@ -10221,9 +10786,7 @@ var TicketSecondaryResourcesResource = class extends BaseResource {
   }
 };
 
-// src/resources/special/tickets.ts
-var MS = 864e5;
-var SLA_PAGE = 100;
+// src/resources/special/tickets/common.ts
 async function fetchTicket(http, id, operation) {
   const res = await http.request({
     method: "GET",
@@ -10247,6 +10810,13 @@ async function ticketQueryItems(http, path, filter, maxRecords, operation) {
   });
   return unwrapItems(res).items;
 }
+function truncate(text, limit) {
+  const full = text ?? "";
+  if (full.length <= limit) return { value: full, truncated: false, length: full.length };
+  return { value: `${full.slice(0, limit)}\u2026`, truncated: true, length: full.length };
+}
+
+// src/resources/special/tickets/childRead.ts
 function isRouteUnavailable(err) {
   return isAutotaskError(err) && (err.httpStatus === 404 || err.httpStatus === 500);
 }
@@ -10340,11 +10910,10 @@ function applyRouteStatus(part, read) {
   if (read.status === "ok-scoped") part.route = "scoped";
   if (read.status === "miss") part.routeFacts = read.routeFacts;
 }
-function truncate(text, limit) {
-  const full = text ?? "";
-  if (full.length <= limit) return { value: full, truncated: false, length: full.length };
-  return { value: `${full.slice(0, limit)}\u2026`, truncated: true, length: full.length };
-}
+
+// src/resources/special/tickets/sla.ts
+var MS = 864e5;
+var SLA_PAGE = 100;
 async function slaHealthCheck(_resource, id, opts = {}, http) {
   void opts;
   const ticketId = parseIdentifier(id, "id");
@@ -10358,11 +10927,11 @@ async function slaHealthCheck(_resource, id, opts = {}, http) {
   );
   const slas = rows.map((row) => {
     const bool = (v) => typeof v === "boolean" ? v : null;
-    const num3 = (v) => typeof v === "number" ? v : null;
+    const num2 = (v) => typeof v === "number" ? v : null;
     const milestones = [
-      { name: "firstResponse", met: bool(row.isFirstResponseMet), elapsedHours: num3(row.firstResponseElapsedHours) },
-      { name: "resolution", met: bool(row.isResolutionMet), elapsedHours: num3(row.resolutionElapsedHours) },
-      { name: "resolutionPlan", met: bool(row.isResolutionPlanMet), elapsedHours: num3(row.resolutionPlanElapsedHours) }
+      { name: "firstResponse", met: bool(row.isFirstResponseMet), elapsedHours: num2(row.firstResponseElapsedHours) },
+      { name: "resolution", met: bool(row.isResolutionMet), elapsedHours: num2(row.resolutionElapsedHours) },
+      { name: "resolutionPlan", met: bool(row.isResolutionPlanMet), elapsedHours: num2(row.resolutionPlanElapsedHours) }
     ];
     return { id: Number(row.id), name: row.serviceLevelAgreementName ?? null, milestones };
   });
@@ -10399,7 +10968,9 @@ async function summary(_resource, id, opts = {}, http) {
     ageDays
   };
 }
-async function timeline(_resource, id, opts = {}, http) {
+
+// src/resources/special/tickets/timeline.ts
+function validateTimelineLimits(opts) {
   const limit = opts.limit === void 0 ? 100 : Math.trunc(opts.limit);
   if (!Number.isInteger(limit) || limit < 1) throw new AutotaskConfigError(`limit must be an integer >= 1 (got ${String(opts.limit)})`);
   const bounded = Math.min(limit, 500);
@@ -10407,6 +10978,56 @@ async function timeline(_resource, id, opts = {}, http) {
   if (!Number.isInteger(textLimit) || textLimit < 1) {
     throw new AutotaskConfigError(`textLimit must be an integer >= 1 (got ${String(opts.textLimit)})`);
   }
+  return { bounded, textLimit };
+}
+function noteEvent(n, textLimit) {
+  const text = truncate(typeof n.description === "string" ? n.description : null, textLimit);
+  return {
+    kind: "note",
+    id: Number(n.id),
+    date: typeof n.createDateTime === "string" ? n.createDateTime : null,
+    text: text.value || null,
+    title: typeof n.title === "string" ? n.title : null,
+    hours: null,
+    action: null,
+    textTruncated: text.truncated
+  };
+}
+function timeEntryEvent(t) {
+  return {
+    kind: "timeEntry",
+    id: Number(t.id),
+    date: typeof t.dateWorked === "string" ? t.dateWorked : null,
+    text: null,
+    title: null,
+    hours: typeof t.hoursWorked === "number" ? t.hoursWorked : null,
+    action: null,
+    textTruncated: false
+  };
+}
+function historyEvent(h, textLimit) {
+  const text = truncate(typeof h.detail === "string" ? h.detail : null, textLimit);
+  return {
+    kind: "history",
+    id: Number(h.id),
+    date: typeof h.date === "string" ? h.date : null,
+    text: text.value || null,
+    title: null,
+    hours: null,
+    action: typeof h.action === "string" ? h.action : null,
+    textTruncated: text.truncated
+  };
+}
+function compareEventDates(a, b) {
+  const da = a.date ?? "";
+  const db = b.date ?? "";
+  if (da === "" && db === "") return 0;
+  if (da === "") return 1;
+  if (db === "") return -1;
+  return da < db ? -1 : da > db ? 1 : 0;
+}
+async function timeline(_resource, id, opts = {}, http) {
+  const { bounded, textLimit } = validateTimelineLimits(opts);
   const ticketId = parseIdentifier(id, "id");
   await fetchTicket(http, ticketId, "tickets.timeline");
   const dateFilters = (field) => {
@@ -10419,59 +11040,17 @@ async function timeline(_resource, id, opts = {}, http) {
   const cappedSources = [];
   const notes = await ticketChildRead(http, { globalPath: "/V1.0/TicketNotes/query", resourceKey: "ticket_notes", filter: dateFilters("createDateTime"), limit: bounded, operation: "tickets.timeline" }, ticketId);
   if (notes.capped) cappedSources.push("notes");
-  for (const n of notes.items) {
-    const text = truncate(typeof n.description === "string" ? n.description : null, textLimit);
-    events.push({
-      kind: "note",
-      id: Number(n.id),
-      date: typeof n.createDateTime === "string" ? n.createDateTime : null,
-      text: text.value || null,
-      title: typeof n.title === "string" ? n.title : null,
-      hours: null,
-      action: null,
-      textTruncated: text.truncated
-    });
-  }
+  for (const n of notes.items) events.push(noteEvent(n, textLimit));
   const entries = await ticketChildRead(http, { globalPath: "/V1.0/TimeEntries/query", resourceKey: "time_entries", filter: dateFilters("dateWorked"), limit: bounded, operation: "tickets.timeline" }, ticketId);
   if (entries.capped) cappedSources.push("timeEntries");
-  for (const t of entries.items) {
-    events.push({
-      kind: "timeEntry",
-      id: Number(t.id),
-      date: typeof t.dateWorked === "string" ? t.dateWorked : null,
-      text: null,
-      title: null,
-      hours: typeof t.hoursWorked === "number" ? t.hoursWorked : null,
-      action: null,
-      textTruncated: false
-    });
-  }
+  for (const t of entries.items) events.push(timeEntryEvent(t));
   let historiesRead;
   if (opts.includeHistories) {
     historiesRead = await ticketChildRead(http, { globalPath: "/V1.0/TicketHistory/query", resourceKey: "ticket_history", filter: dateFilters("date"), limit: bounded, operation: "tickets.timeline" }, ticketId);
     if (historiesRead.capped) cappedSources.push("histories");
-    for (const h of historiesRead.items) {
-      const text = truncate(typeof h.detail === "string" ? h.detail : null, textLimit);
-      events.push({
-        kind: "history",
-        id: Number(h.id),
-        date: typeof h.date === "string" ? h.date : null,
-        text: text.value || null,
-        title: null,
-        hours: null,
-        action: typeof h.action === "string" ? h.action : null,
-        textTruncated: text.truncated
-      });
-    }
+    for (const h of historiesRead.items) events.push(historyEvent(h, textLimit));
   }
-  events.sort((a, b) => {
-    const da = a.date ?? "";
-    const db = b.date ?? "";
-    if (da === "" && db === "") return 0;
-    if (da === "") return 1;
-    if (db === "") return -1;
-    return da < db ? -1 : da > db ? 1 : 0;
-  });
+  events.sort(compareEventDates);
   const capped = events.slice(0, bounded);
   const result = {
     ticketId,
@@ -10487,6 +11066,64 @@ async function timeline(_resource, id, opts = {}, http) {
   }
   return result;
 }
+
+// src/resources/special/tickets/errors.ts
+var QueueRequiredError = class extends AutotaskError {
+  constructor(message, options = {}) {
+    super(message, {
+      code: "QUEUE_REQUIRED",
+      category: "validation",
+      suggestedAction: "pass params.queueID (discover via autotask_describe(tickets.create) or a known queue id)",
+      ...options
+    });
+    this.name = "QueueRequiredError";
+  }
+};
+var TicketResourceInvalidError = class extends AutotaskError {
+  constructor(message, options = {}) {
+    super(message, { code: "RESOURCE_INVALID", category: "validation", ...options });
+    this.name = "TicketResourceInvalidError";
+  }
+};
+var TicketCreateValidationFailedError = class extends AutotaskError {
+  /** The vendor-named fields (empty when the 500 body named nothing parseable). */
+  vendorFields;
+  constructor(message, vendorFields, options = {}) {
+    super(message, { code: "VALIDATION_FAILED", category: "validation", ...options });
+    this.name = "TicketCreateValidationFailedError";
+    this.vendorFields = vendorFields;
+  }
+};
+var StatusUnknownError = class extends AutotaskError {
+  /** The live picklist size (the message names it; the values + labels are via operations.fieldCatalog with labels: true). */
+  picklistCount;
+  constructor(message, options = {}) {
+    super(message, {
+      code: "STATUS_UNKNOWN",
+      category: "validation",
+      suggestedAction: `Pass one of the tenant's live status values (discover the current values + labels with operations.fieldCatalog({ resources: ["tickets"], fields: ["status"], labels: true })).`,
+      ...options
+    });
+    this.name = "StatusUnknownError";
+    this.picklistCount = options.picklistCount ?? 0;
+  }
+};
+var StatusFieldsRequiredError = class extends AutotaskError {
+  vendorFields;
+  currentStatus;
+  targetStatus;
+  currentValues;
+  constructor(message, details, options = {}) {
+    super(message, { code: "STATUS_FIELDS_REQUIRED", category: "validation", suggestedAction: "Pass the required field value(s) in the `fields` argument and retry (the node never fills a field without a proven-safe default).", ...options });
+    this.name = "StatusFieldsRequiredError";
+    this.vendorFields = details.vendorFields;
+    this.currentStatus = details.currentStatus;
+    this.targetStatus = details.targetStatus;
+    this.currentValues = details.currentValues;
+  }
+};
+
+// src/resources/special/tickets/writeSupport.ts
 var OP_OPEN = "tickets.openWithNoteAndAssign";
 var OP_STATUS = "tickets.changeStatus";
 var MAX_DISCOVERY_MERGES = 3;
@@ -10538,39 +11175,15 @@ function stepErrorText(code, err) {
   const base = isAutotaskError(err) ? err.message : String(err);
   return detail ? `${code}: ${detail}` : `${code}: ${base}`;
 }
+
+// src/resources/special/tickets/openWithNoteAndAssign.ts
 var DEFAULT_TICKET_PRIORITY = 3;
 var DEFAULT_TICKET_STATUS = 1;
 var DEFAULT_NOTE_TYPE = 1;
 var DEFAULT_PUBLISH = 1;
 var PUBLISH_VALUES = /* @__PURE__ */ new Set([1, 2, 4]);
 var SAFE_TICKET_CREATE_DEFAULTS = {};
-var QueueRequiredError = class extends AutotaskError {
-  constructor(message, options = {}) {
-    super(message, {
-      code: "QUEUE_REQUIRED",
-      category: "validation",
-      suggestedAction: "pass params.queueID (discover via autotask_describe(tickets.create) or a known queue id)",
-      ...options
-    });
-    this.name = "QueueRequiredError";
-  }
-};
-var TicketResourceInvalidError = class extends AutotaskError {
-  constructor(message, options = {}) {
-    super(message, { code: "RESOURCE_INVALID", category: "validation", ...options });
-    this.name = "TicketResourceInvalidError";
-  }
-};
-var TicketCreateValidationFailedError = class extends AutotaskError {
-  /** The vendor-named fields (empty when the 500 body named nothing parseable). */
-  vendorFields;
-  constructor(message, vendorFields, options = {}) {
-    super(message, { code: "VALIDATION_FAILED", category: "validation", ...options });
-    this.name = "TicketCreateValidationFailedError";
-    this.vendorFields = vendorFields;
-  }
-};
-async function openWithNoteAndAssign(resource, params, note, assign, opts, http) {
+function validateOpenInput(params, note, assign) {
   const companyID = parseIdentifier(params?.companyID, "params.companyID");
   const title = params?.title;
   if (typeof title !== "string" || title.trim() === "") {
@@ -10609,73 +11222,65 @@ async function openWithNoteAndAssign(resource, params, note, assign, opts, http)
   if (assign !== void 0 && !isPositiveInt(roleID)) {
     throw new AutotaskConfigError("openWithNoteAndAssign: assign.roleID is required (a positive integer) \u2014 the ww29 vendor requires BOTH assignedResourceID and assignedResourceRoleID when assigning a resource (S12-A live-verified: Data violation: When assigning a Resource, you must assign both a assignedResourceID and assignedResourceRoleID)", { operation: OP_OPEN });
   }
-  if (assign !== void 0 && assignee !== void 0) {
-    const rid = assignee;
-    const rec = await fetchItem(http, `/V1.0/Resources/${rid}`, OP_OPEN, { maxRetries: opts.maxRetries });
-    if (rec === null) {
-      throw new TicketResourceInvalidError(
-        `openWithNoteAndAssign: assignee resource ${assignee} was not found (resources.get returned item: null \u2014 the resources table is blind to the API user; get is the authority)`,
-        { resourceIds: [rid], details: { idRefs: [{ entity: "resource", id: rid }] }, operation: OP_OPEN, category: "not_found", suggestedAction: "Resolve the resource id (a ticket assignedResourceID via tickets.fullContext) and retry." }
-      );
-    }
-    if (rec.isActive !== true) {
-      throw new TicketResourceInvalidError(
-        `openWithNoteAndAssign: assignee resource ${assignee} is not active (isActive !== true) \u2014 the vendor would reject the assignment`,
-        { resourceIds: [rid], details: { idRefs: [{ entity: "resource", id: rid }] }, operation: OP_OPEN, suggestedAction: "Activate the resource or assign an active one." }
-      );
-    }
+  return { companyID, title, priority, status, assignee, roleID };
+}
+async function precheckAssignee(http, assignee, opts) {
+  const rid = assignee;
+  const rec = await fetchItem(http, `/V1.0/Resources/${rid}`, OP_OPEN, { maxRetries: opts.maxRetries });
+  if (rec === null) {
+    throw new TicketResourceInvalidError(
+      `openWithNoteAndAssign: assignee resource ${assignee} was not found (resources.get returned item: null \u2014 the resources table is blind to the API user; get is the authority)`,
+      { resourceIds: [rid], details: { idRefs: [{ entity: "resource", id: rid }] }, operation: OP_OPEN, category: "not_found", suggestedAction: "Resolve the resource id (a ticket assignedResourceID via tickets.fullContext) and retry." }
+    );
   }
-  const body = { title, status, priority, companyID };
-  if (params.queueID !== void 0) body.queueID = params.queueID;
-  const noteBody = note === void 0 ? null : {
-    title: note.title,
-    // REQUIRED by the vendor (S12-A live-verified: Missing Required Field: title)
-    description: note.description,
-    noteType: note.noteType ?? DEFAULT_NOTE_TYPE,
-    publish: note.publish ?? DEFAULT_PUBLISH
-  };
-  if (opts.dryRun === true) {
-    const warnings = [];
-    if (params.queueID === void 0) {
-      warnings.push("queueID is omitted \u2014 the node NEVER guesses a queue: if the vendor 500 names it, the apply throws the typed QUEUE_REQUIRED (pass params.queueID \u2014 discover via autotask_describe(tickets.create)).");
-    }
-    if (assign !== void 0) {
-      warnings.push(`the assignment is the v0.6.0 MERGE update (unredacted GET + collection PUT, 2 wire) setting assignedResourceID ${String(assignee)} + assignedResourceRoleID ${String(roleID)} (the vendor requires both \u2014 S12-A live-verified); a failure lands in steps[] as ASSIGN_FAILED (the applied ticketId is still returned).`);
-    }
-    return buildDryRunResult(
-      {
-        operation: OP_OPEN,
-        method: "POST",
-        path: "/V1.0/Tickets",
-        ids: [companyID],
-        checks: [
-          { name: "input-validation", ok: true },
-          { name: "assignee-active", ok: true }
-        ],
-        impact: {
-          affected: 1 + (noteBody !== null ? 1 : 0) + (assign !== void 0 ? 1 : 0),
-          scope: "ticket (+ scoped note, + assignment merge)",
-          reversible: false
-        },
-        warnings,
-        data: {
-          ticket: body,
-          note: noteBody,
-          assign: assign !== void 0 ? { method: "GET+PUT", path: `/V1.0/Tickets/<newId>`, body: { assignedResourceID: assignee, assignedResourceRoleID: roleID } } : null
-        }
-      },
-      { redactPersonalData: http.redactPersonalData }
+  if (rec.isActive !== true) {
+    throw new TicketResourceInvalidError(
+      `openWithNoteAndAssign: assignee resource ${assignee} is not active (isActive !== true) \u2014 the vendor would reject the assignment`,
+      { resourceIds: [rid], details: { idRefs: [{ entity: "resource", id: rid }] }, operation: OP_OPEN, suggestedAction: "Activate the resource or assign an active one." }
     );
   }
-  const steps = [];
-  let ticketId;
+}
+function openDryRun(http, v, params, assign, body, noteBody) {
+  const { companyID, assignee, roleID } = v;
+  const warnings = [];
+  if (params.queueID === void 0) {
+    warnings.push("queueID is omitted \u2014 the node NEVER guesses a queue: if the vendor 500 names it, the apply throws the typed QUEUE_REQUIRED (pass params.queueID \u2014 discover via autotask_describe(tickets.create)).");
+  }
+  if (assign !== void 0) {
+    warnings.push(`the assignment is the v0.6.0 MERGE update (unredacted GET + collection PUT, 2 wire) setting assignedResourceID ${String(assignee)} + assignedResourceRoleID ${String(roleID)} (the vendor requires both \u2014 S12-A live-verified); a failure lands in steps[] as ASSIGN_FAILED (the applied ticketId is still returned).`);
+  }
+  return buildDryRunResult(
+    {
+      operation: OP_OPEN,
+      method: "POST",
+      path: "/V1.0/Tickets",
+      ids: [companyID],
+      checks: [
+        { name: "input-validation", ok: true },
+        { name: "assignee-active", ok: true }
+      ],
+      impact: {
+        affected: 1 + (noteBody !== null ? 1 : 0) + (assign !== void 0 ? 1 : 0),
+        scope: "ticket (+ scoped note, + assignment merge)",
+        reversible: false
+      },
+      warnings,
+      data: {
+        ticket: body,
+        note: noteBody,
+        assign: assign !== void 0 ? { method: "GET+PUT", path: `/V1.0/Tickets/<newId>`, body: { assignedResourceID: assignee, assignedResourceRoleID: roleID } } : null
+      }
+    },
+    { redactPersonalData: http.redactPersonalData }
+  );
+}
+async function createTicketWithDiscovery(resource, params, companyID, body, steps) {
   let merges = 0;
   for (; ; ) {
     try {
       const created = await resource.create(body, {});
-      ticketId = created.id;
       steps.push({ name: "create", ok: true });
-      break;
+      return created.id;
     } catch (err) {
       const named = namedVendorFields(err);
       if (params.queueID === void 0 && named.includes("queueID")) {
@@ -10708,34 +11313,57 @@ async function openWithNoteAndAssign(resource, params, note, assign, opts, http)
       );
     }
   }
-  let noteId = null;
-  if (noteBody !== null) {
-    try {
-      const res = await http.request({ method: "POST", path: `/V1.0/Tickets/${ticketId}/Notes`, body: noteBody, operation: OP_OPEN, maxRetries: opts.maxRetries });
-      noteId = operationId(res) ?? null;
-      steps.push({ name: "note", ok: true });
-    } catch (err) {
-      steps.push({ name: "note", ok: false, error: stepErrorText("NOTE_CREATE_FAILED", err) });
-    }
+}
+async function createNoteStep(http, ticketId, noteBody, opts, steps) {
+  try {
+    const res = await http.request({ method: "POST", path: `/V1.0/Tickets/${ticketId}/Notes`, body: noteBody, operation: OP_OPEN, maxRetries: opts.maxRetries });
+    const noteId = operationId(res) ?? null;
+    steps.push({ name: "note", ok: true });
+    return noteId;
+  } catch (err) {
+    steps.push({ name: "note", ok: false, error: stepErrorText("NOTE_CREATE_FAILED", err) });
+    return null;
   }
+}
+async function assignStep(http, ticketId, assignee, roleID, opts, steps) {
   let assigned = false;
   let ticketNumber = null;
-  if (assign !== void 0) {
-    try {
-      const current = await fetchItemUnredacted(http, `/V1.0/Tickets/${ticketId}`, OP_OPEN, { maxRetries: opts.maxRetries });
-      if (current === null) {
-        throw new NotFoundError(`openWithNoteAndAssign: ticket ${ticketId} vanished between the create and the assign merge read`, { operation: OP_OPEN, resourceIds: [ticketId], details: { idRefs: [{ entity: "ticket", id: ticketId }] } });
-      }
-      ticketNumber = typeof current.ticketNumber === "string" ? current.ticketNumber : null;
-      const merged = mergePartialBody(current, { id: ticketId, assignedResourceID: assignee, assignedResourceRoleID: roleID });
-      merged.id = ticketId;
-      await http.request({ method: "PUT", path: "/V1.0/Tickets", body: merged, operation: OP_OPEN, maxRetries: opts.maxRetries });
-      assigned = true;
-      steps.push({ name: "assign", ok: true });
-    } catch (err) {
-      steps.push({ name: "assign", ok: false, error: stepErrorText("ASSIGN_FAILED", err) });
+  try {
+    const current = await fetchItemUnredacted(http, `/V1.0/Tickets/${ticketId}`, OP_OPEN, { maxRetries: opts.maxRetries });
+    if (current === null) {
+      throw new NotFoundError(`openWithNoteAndAssign: ticket ${ticketId} vanished between the create and the assign merge read`, { operation: OP_OPEN, resourceIds: [ticketId], details: { idRefs: [{ entity: "ticket", id: ticketId }] } });
     }
+    ticketNumber = typeof current.ticketNumber === "string" ? current.ticketNumber : null;
+    const merged = mergePartialBody(current, { id: ticketId, assignedResourceID: assignee, assignedResourceRoleID: roleID });
+    merged.id = ticketId;
+    await http.request({ method: "PUT", path: "/V1.0/Tickets", body: merged, operation: OP_OPEN, maxRetries: opts.maxRetries });
+    assigned = true;
+    steps.push({ name: "assign", ok: true });
+  } catch (err) {
+    steps.push({ name: "assign", ok: false, error: stepErrorText("ASSIGN_FAILED", err) });
   }
+  return { assigned, ticketNumber };
+}
+async function openWithNoteAndAssign(resource, params, note, assign, opts, http) {
+  const validated = validateOpenInput(params, note, assign);
+  const { companyID, title, priority, status, assignee } = validated;
+  if (assign !== void 0 && assignee !== void 0) await precheckAssignee(http, assignee, opts);
+  const body = { title, status, priority, companyID };
+  if (params.queueID !== void 0) body.queueID = params.queueID;
+  const noteBody = note === void 0 ? null : {
+    title: note.title,
+    // REQUIRED by the vendor (S12-A live-verified: Missing Required Field: title)
+    description: note.description,
+    noteType: note.noteType ?? DEFAULT_NOTE_TYPE,
+    publish: note.publish ?? DEFAULT_PUBLISH
+  };
+  if (opts.dryRun === true) return openDryRun(http, validated, params, assign, body, noteBody);
+  const steps = [];
+  const ticketId = await createTicketWithDiscovery(resource, params, companyID, body, steps);
+  const noteId = noteBody !== null ? await createNoteStep(http, ticketId, noteBody, opts, steps) : null;
+  let assigned = false;
+  let ticketNumber = null;
+  if (assign !== void 0) ({ assigned, ticketNumber } = await assignStep(http, ticketId, assignee, validated.roleID, opts, steps));
   return {
     ticketId,
     ticketNumber,
@@ -10745,60 +11373,30 @@ async function openWithNoteAndAssign(resource, params, note, assign, opts, http)
     ...assign !== void 0 ? { blind: { resources: true, note: "the resources table is blind to this API user (count/query return 0) \u2014 the assignee was verified via resources.get (the authority)" } } : {}
   };
 }
+
+// src/resources/special/tickets/changeStatus.ts
 var STATUS_REQUIRED_FIELDS = {
   // <discovery output lands here — e.g. 8: { requiredFields: ['dueDateTime'], safeDefaults: { dueDateTime: '<now>' } }>
 };
-var StatusUnknownError = class extends AutotaskError {
-  /** The live picklist size (the message names it; the values + labels are via operations.fieldCatalog with labels: true). */
-  picklistCount;
-  constructor(message, options = {}) {
-    super(message, {
-      code: "STATUS_UNKNOWN",
-      category: "validation",
-      suggestedAction: `Pass one of the tenant's live status values (discover the current values + labels with operations.fieldCatalog({ resources: ["tickets"], fields: ["status"], labels: true })).`,
-      ...options
-    });
-    this.name = "StatusUnknownError";
-    this.picklistCount = options.picklistCount ?? 0;
-  }
-};
-var StatusFieldsRequiredError = class extends AutotaskError {
-  vendorFields;
-  currentStatus;
-  targetStatus;
-  currentValues;
-  constructor(message, details, options = {}) {
-    super(message, { code: "STATUS_FIELDS_REQUIRED", category: "validation", suggestedAction: "Pass the required field value(s) in the `fields` argument and retry (the node never fills a field without a proven-safe default).", ...options });
-    this.name = "StatusFieldsRequiredError";
-    this.vendorFields = details.vendorFields;
-    this.currentStatus = details.currentStatus;
-    this.targetStatus = details.targetStatus;
-    this.currentValues = details.currentValues;
-  }
-};
 async function readLiveStatusSet(resource) {
   const raw = await resource.getFieldInfo();
   const row = raw.find((f) => f.name === "status");
   const values = row !== void 0 && row.isPickList === true ? row.picklistValues : void 0;
-  const ids = /* @__PURE__ */ new Set();
+  const ids2 = /* @__PURE__ */ new Set();
   if (Array.isArray(values)) {
     for (const pv of values) {
       const n = Number(pv.value);
-      if (Number.isFinite(n)) ids.add(n);
+      if (Number.isFinite(n)) ids2.add(n);
     }
   }
-  return ids;
+  return ids2;
 }
 var GUARD_DEGRADED_WARNING = "the tenant's live status picklist metadata was unavailable (the local guard is degraded for this call \u2014 the W-A4 wall or a metadata failure); the vendor's own validation is the final authority on the status value";
-async function changeStatus(resource, id, targetStatus, fields, opts, http) {
-  const ticketId = parseIdentifier(id, "id");
-  if (!isPositiveInt(targetStatus)) {
-    throw new AutotaskConfigError(`changeStatus: targetStatus must be a positive integer (got ${String(targetStatus)})`, { operation: OP_STATUS });
-  }
+async function guardTargetStatus(resource, http, targetStatus) {
   let liveStatus = null;
   try {
-    const ids = await readLiveStatusSet(resource);
-    if (ids.size > 0) liveStatus = ids;
+    const ids2 = await readLiveStatusSet(resource);
+    if (ids2.size > 0) liveStatus = ids2;
   } catch (err) {
     if (!isAutotaskError(err) || err.code === "ABORTED") throw err;
   }
@@ -10825,41 +11423,31 @@ async function changeStatus(resource, id, targetStatus, fields, opts, http) {
       );
     }
   }
-  const guardDegraded = liveStatus === null;
-  if (fields !== void 0 && (typeof fields !== "object" || fields === null || Array.isArray(fields))) {
-    throw new AutotaskConfigError("changeStatus: fields must be a plain object of ticket fields (or omitted)", { operation: OP_STATUS });
-  }
-  const current = await fetchItemUnredacted(http, `/V1.0/Tickets/${ticketId}`, OP_STATUS, { maxRetries: opts.maxRetries });
-  if (current === null) {
-    throw new NotFoundError(`changeStatus: ticket ${ticketId} was not found (tickets.get returned item: null)`, { operation: OP_STATUS, resourceIds: [ticketId], details: { idRefs: [{ entity: "ticket", id: ticketId }] } });
-  }
-  const previousStatus = typeof current.status === "number" ? current.status : null;
-  if (previousStatus === targetStatus) {
-    if (opts.dryRun === true) {
-      return buildDryRunResult(
-        {
-          operation: OP_STATUS,
-          method: "PUT",
-          path: "/V1.0/Tickets",
-          ids: [ticketId],
-          checks: [
-            { name: "status-known", ok: true },
-            { name: "merge-read", ok: true },
-            { name: "no-op", ok: true }
-          ],
-          impact: { affected: 0, scope: "single-record", reversible: true },
-          warnings: [
-            ...guardDegraded ? [GUARD_DEGRADED_WARNING] : [],
-            `NO_CHANGE: the ticket is already in the target status ${targetStatus} \u2014 the apply would be a zero-wire no-op.`
-          ],
-          data: { reason: "NO_CHANGE", status: targetStatus }
-        },
-        { redactPersonalData: http.redactPersonalData }
-      );
-    }
-    return { ticketId, changed: false, status: targetStatus, reason: "NO_CHANGE" };
-  }
-  const mapEntry = STATUS_REQUIRED_FIELDS[targetStatus];
+  return { guardDegraded: liveStatus === null };
+}
+function noChangeDryRun(http, ticketId, targetStatus, guardDegraded) {
+  return buildDryRunResult(
+    {
+      operation: OP_STATUS,
+      method: "PUT",
+      path: "/V1.0/Tickets",
+      ids: [ticketId],
+      checks: [
+        { name: "status-known", ok: true },
+        { name: "merge-read", ok: true },
+        { name: "no-op", ok: true }
+      ],
+      impact: { affected: 0, scope: "single-record", reversible: true },
+      warnings: [
+        ...guardDegraded ? [GUARD_DEGRADED_WARNING] : [],
+        `NO_CHANGE: the ticket is already in the target status ${targetStatus} \u2014 the apply would be a zero-wire no-op.`
+      ],
+      data: { reason: "NO_CHANGE", status: targetStatus }
+    },
+    { redactPersonalData: http.redactPersonalData }
+  );
+}
+function resolveMergeData(ticketId, targetStatus, previousStatus, current, fields, mapEntry) {
   const mergeData = { status: targetStatus };
   for (const [k, v] of Object.entries(fields ?? {})) {
     if (v !== void 0) mergeData[k] = v;
@@ -10881,33 +11469,36 @@ async function changeStatus(resource, id, targetStatus, fields, opts, http) {
       filled.push(field);
     }
   }
-  if (opts.dryRun === true) {
-    const warnings = [];
-    if (guardDegraded) warnings.push(GUARD_DEGRADED_WARNING);
-    if (filled.length > 0) {
-      warnings.push(`the node will fill the map-required field(s) ${filled.join(", ")} with the proven-safe defaults (the live-discovered map); the caller value always wins.`);
-    }
-    if (mapEntry === void 0) {
-      warnings.push(`status ${targetStatus} has no entry in the live-discovered required-field map yet \u2014 if the vendor 500 names a required field without a safe default, the apply throws the typed STATUS_FIELDS_REQUIRED (the caller supplies the value; never a blind retry).`);
-    }
-    return buildDryRunResult(
-      {
-        operation: OP_STATUS,
-        method: "PUT",
-        path: "/V1.0/Tickets",
-        ids: [ticketId],
-        checks: [
-          { name: "status-known", ok: true },
-          { name: "merge-read", ok: true },
-          { name: "fields-resolved", ok: true }
-        ],
-        impact: { affected: 1, scope: "single-record", reversible: true },
-        warnings,
-        data: mergeData
-      },
-      { redactPersonalData: http.redactPersonalData }
-    );
+  return { mergeData, filled };
+}
+function mergeDryRun(http, ticketId, targetStatus, guardDegraded, filled, mapEntry, mergeData) {
+  const warnings = [];
+  if (guardDegraded) warnings.push(GUARD_DEGRADED_WARNING);
+  if (filled.length > 0) {
+    warnings.push(`the node will fill the map-required field(s) ${filled.join(", ")} with the proven-safe defaults (the live-discovered map); the caller value always wins.`);
+  }
+  if (mapEntry === void 0) {
+    warnings.push(`status ${targetStatus} has no entry in the live-discovered required-field map yet \u2014 if the vendor 500 names a required field without a safe default, the apply throws the typed STATUS_FIELDS_REQUIRED (the caller supplies the value; never a blind retry).`);
   }
+  return buildDryRunResult(
+    {
+      operation: OP_STATUS,
+      method: "PUT",
+      path: "/V1.0/Tickets",
+      ids: [ticketId],
+      checks: [
+        { name: "status-known", ok: true },
+        { name: "merge-read", ok: true },
+        { name: "fields-resolved", ok: true }
+      ],
+      impact: { affected: 1, scope: "single-record", reversible: true },
+      warnings,
+      data: mergeData
+    },
+    { redactPersonalData: http.redactPersonalData }
+  );
+}
+async function putStatusWithDiscovery(http, ticketId, targetStatus, previousStatus, current, mergeData, mapEntry, filled, opts) {
   const safeDefaults = mapEntry?.safeDefaults ?? {};
   const body = mergePartialBody(current, mergeData);
   body.id = ticketId;
@@ -10915,7 +11506,7 @@ async function changeStatus(resource, id, targetStatus, fields, opts, http) {
   for (; ; ) {
     try {
       await http.request({ method: "PUT", path: "/V1.0/Tickets", body, operation: OP_STATUS, maxRetries: opts.maxRetries });
-      break;
+      return merges;
     } catch (err) {
       const named = namedVendorFields(err);
       const merge = discoveryMerge(err, body, safeDefaults);
@@ -10943,6 +11534,8 @@ async function changeStatus(resource, id, targetStatus, fields, opts, http) {
       throw err;
     }
   }
+}
+async function verifyStatusApplied(http, ticketId, targetStatus, opts) {
   const verify = await fetchItem(http, `/V1.0/Tickets/${ticketId}`, OP_STATUS, { maxRetries: opts.maxRetries });
   if (verify === null) {
     throw new AutotaskError(`changeStatus: the post-PUT read-back found no ticket ${ticketId} (the PUT 200ed but the record is gone)`, {
@@ -10968,8 +11561,34 @@ async function changeStatus(resource, id, targetStatus, fields, opts, http) {
       }
     );
   }
+}
+async function changeStatus(resource, id, targetStatus, fields, opts, http) {
+  const ticketId = parseIdentifier(id, "id");
+  if (!isPositiveInt(targetStatus)) {
+    throw new AutotaskConfigError(`changeStatus: targetStatus must be a positive integer (got ${String(targetStatus)})`, { operation: OP_STATUS });
+  }
+  const { guardDegraded } = await guardTargetStatus(resource, http, targetStatus);
+  if (fields !== void 0 && (typeof fields !== "object" || fields === null || Array.isArray(fields))) {
+    throw new AutotaskConfigError("changeStatus: fields must be a plain object of ticket fields (or omitted)", { operation: OP_STATUS });
+  }
+  const current = await fetchItemUnredacted(http, `/V1.0/Tickets/${ticketId}`, OP_STATUS, { maxRetries: opts.maxRetries });
+  if (current === null) {
+    throw new NotFoundError(`changeStatus: ticket ${ticketId} was not found (tickets.get returned item: null)`, { operation: OP_STATUS, resourceIds: [ticketId], details: { idRefs: [{ entity: "ticket", id: ticketId }] } });
+  }
+  const previousStatus = typeof current.status === "number" ? current.status : null;
+  if (previousStatus === targetStatus) {
+    if (opts.dryRun === true) return noChangeDryRun(http, ticketId, targetStatus, guardDegraded);
+    return { ticketId, changed: false, status: targetStatus, reason: "NO_CHANGE" };
+  }
+  const mapEntry = STATUS_REQUIRED_FIELDS[targetStatus];
+  const { mergeData, filled } = resolveMergeData(ticketId, targetStatus, previousStatus, current, fields, mapEntry);
+  if (opts.dryRun === true) return mergeDryRun(http, ticketId, targetStatus, guardDegraded, filled, mapEntry, mergeData);
+  const merges = await putStatusWithDiscovery(http, ticketId, targetStatus, previousStatus, current, mergeData, mapEntry, filled, opts);
+  await verifyStatusApplied(http, ticketId, targetStatus, opts);
   return { ticketId, previousStatus, status: targetStatus, changed: true, filledFields: filled, discoveryMerges: merges };
 }
+
+// src/resources/special/tickets/fullContext.ts
 var DEFAULT_PART_LIMIT = 50;
 function partLimit(value, name) {
   const n = value === void 0 ? DEFAULT_PART_LIMIT : Math.trunc(value);
@@ -10986,6 +11605,38 @@ function servedTextRecord(row, textField, limit) {
   out[textField] = `${text.slice(0, limit)}\u2026`;
   return out;
 }
+async function addCompositeNames(http, ctx, entriesPart, result, opts) {
+  const builder = createNamePlan(TICKET_LABEL_FIELDS);
+  const t = ctx.ticket;
+  builder.addResource(t["creatorResourceID"]);
+  builder.addFk("contract", t["contractID"]);
+  builder.addFk("billingCode", t["billingCodeID"]);
+  builder.addFk("role", t["assignedResourceRoleID"]);
+  for (const e of entriesPart.items) {
+    builder.addResource(e["resourceID"]);
+    builder.addFk("role", e["roleID"]);
+    builder.addFk("billingCode", e["billingCodeID"]);
+    builder.addFk("contract", e["contractID"]);
+  }
+  const names = await resolveCompositeNames(http, builder.plan(), { maxNameReads: opts.maxNameReads });
+  const ticketRow = { ...ctx.ticket };
+  addNameSibling(ticketRow, "creatorResourceID", (v) => names.resourceName(v));
+  addNameSibling(ticketRow, "contractID", (v) => names.recordName("contract", v));
+  addNameSibling(ticketRow, "billingCodeID", (v) => names.recordName("billingCode", v));
+  addNameSibling(ticketRow, "assignedResourceRoleID", (v) => names.recordName("role", v));
+  for (const f of TICKET_LABEL_FIELDS) addLabelSibling(ticketRow, f, names);
+  result.ticket = ticketRow;
+  result.timeEntries.items = entriesPart.items.map((e) => {
+    const row = { ...e };
+    addNameSibling(row, "resourceID", (v) => names.resourceName(v));
+    addNameSibling(row, "roleID", (v) => names.recordName("role", v));
+    addNameSibling(row, "billingCodeID", (v) => names.recordName("billingCode", v));
+    addNameSibling(row, "contractID", (v) => names.recordName("contract", v));
+    return row;
+  });
+  result.names = names.section;
+  result.truncated = result.truncated || names.section.truncated;
+}
 async function fullContext(resource, id, opts = {}, http) {
   const noteLimit = partLimit(opts.noteLimit, "noteLimit");
   const timeEntryLimit = partLimit(opts.timeEntryLimit, "timeEntryLimit");
@@ -11043,38 +11694,7 @@ async function fullContext(resource, id, opts = {}, http) {
     result.parts.histories = historiesRead.status;
     result.truncated = result.truncated || part.capped || historyRows.some((h) => h.detailTruncated === true);
   }
-  if (opts.names === true) {
-    const builder = createNamePlan(TICKET_LABEL_FIELDS);
-    const t = ctx.ticket;
-    builder.addResource(t["creatorResourceID"]);
-    builder.addFk("contract", t["contractID"]);
-    builder.addFk("billingCode", t["billingCodeID"]);
-    builder.addFk("role", t["assignedResourceRoleID"]);
-    for (const e of entriesPart.items) {
-      builder.addResource(e["resourceID"]);
-      builder.addFk("role", e["roleID"]);
-      builder.addFk("billingCode", e["billingCodeID"]);
-      builder.addFk("contract", e["contractID"]);
-    }
-    const names = await resolveCompositeNames(http, builder.plan(), { maxNameReads: opts.maxNameReads });
-    const ticketRow = { ...ctx.ticket };
-    addNameSibling(ticketRow, "creatorResourceID", (v) => names.resourceName(v));
-    addNameSibling(ticketRow, "contractID", (v) => names.recordName("contract", v));
-    addNameSibling(ticketRow, "billingCodeID", (v) => names.recordName("billingCode", v));
-    addNameSibling(ticketRow, "assignedResourceRoleID", (v) => names.recordName("role", v));
-    for (const f of TICKET_LABEL_FIELDS) addLabelSibling(ticketRow, f, names);
-    result.ticket = ticketRow;
-    result.timeEntries.items = entriesPart.items.map((e) => {
-      const row = { ...e };
-      addNameSibling(row, "resourceID", (v) => names.resourceName(v));
-      addNameSibling(row, "roleID", (v) => names.recordName("role", v));
-      addNameSibling(row, "billingCodeID", (v) => names.recordName("billingCode", v));
-      addNameSibling(row, "contractID", (v) => names.recordName("contract", v));
-      return row;
-    });
-    result.names = names.section;
-    result.truncated = result.truncated || names.section.truncated;
-  }
+  if (opts.names === true) await addCompositeNames(http, ctx, entriesPart, result, opts);
   return result;
 }
 
@@ -11155,8 +11775,8 @@ var TicketsResource = class extends BaseResource {
     const company = await this.contextFetch("/V1.0/Companies", root["companyID"]);
     const contact = await this.contextFetch("/V1.0/Contacts", root["contactID"]);
     const resource = await this.contextFetch("/V1.0/Resources", root["assignedResourceID"]);
-    const project = await this.contextFetch("/V1.0/Projects", root["projectID"]);
-    return { ticket, company, contact, resource, project };
+    const project2 = await this.contextFetch("/V1.0/Projects", root["projectID"]);
+    return { ticket, company, contact, resource, project: project2 };
   }
   /** Node-parity special op (hand-written in src/resources/special/tickets.ts). */
   changeStatus(id, targetStatus, fields, opts = {}) {
@@ -11260,7 +11880,7 @@ var TicketWebhooksResource = class extends BaseResource {
   }
 };
 
-// src/resources/special/time_entries.ts
+// src/resources/special/time_entries/windows.ts
 var DAY_MS2 = 864e5;
 var iso2 = (ms) => new Date(ms).toISOString().slice(0, 19) + "Z";
 async function queryTimeEntries(_resource, filter, limit, operation, http) {
@@ -11310,12 +11930,12 @@ async function postedDateStatusQuery(_resource, mode, http, opts) {
   return items;
 }
 async function postedWithin(_resource, from, to, http, opts, opLabel = "time_entries.postedWithin") {
-  const OP2 = opLabel;
-  const zone = opts?.tz === void 0 ? void 0 : validateZone(opts.tz, OP2);
-  const fromB = customRangeDay(from, "from", zone, OP2);
-  const toB = customRangeDay(to, "to", zone, OP2);
+  const OP5 = opLabel;
+  const zone = opts?.tz === void 0 ? void 0 : validateZone(opts.tz, OP5);
+  const fromB = customRangeDay(from, "from", zone, OP5);
+  const toB = customRangeDay(to, "to", zone, OP5);
   if (fromB.ms > toB.ms) {
-    throw new AutotaskConfigError(`${OP2}: from (${iso2(fromB.ms)}) must not be after to (${iso2(toB.ms)})`, { operation: OP2 });
+    throw new AutotaskConfigError(`${OP5}: from (${iso2(fromB.ms)}) must not be after to (${iso2(toB.ms)})`, { operation: OP5 });
   }
   const windowToMs = zone === void 0 ? toB.ms + DAY_MS2 - 1 : localDayEndMs(toB.y, toB.mo, toB.d, zone);
   const filter = [
@@ -11326,7 +11946,7 @@ async function postedWithin(_resource, from, to, http, opts, opLabel = "time_ent
   else if (opts?.posted === false) filter.push({ field: "postedDate", op: "notExist" });
   if (opts?.ticketID !== void 0) filter.push({ field: "ticketID", op: "eq", value: opts.ticketID });
   if (opts?.resourceID !== void 0) filter.push({ field: "resourceID", op: "eq", value: opts.resourceID });
-  const { items, hasMore } = await queryTimeEntries(_resource, filter, clampWindowLimit(opts?.limit), OP2, http);
+  const { items, hasMore } = await queryTimeEntries(_resource, filter, clampWindowLimit(opts?.limit), OP5, http);
   let postedCount = 0;
   for (const item of items) {
     const postedDate = item.postedDate;
@@ -11347,6 +11967,44 @@ async function postedWithin(_resource, from, to, http, opts, opLabel = "time_ent
 async function dateWorkedWindow(resource, from, to, http, opts) {
   return postedWithin(resource, from, to, http, opts, "time_entries.dateWorkedWindow");
 }
+
+// src/resources/special/time_entries/errors.ts
+var ResourceInvalidError = class extends AutotaskError {
+  constructor(message, options = {}) {
+    super(message, { code: "RESOURCE_INVALID", category: "validation", ...options });
+    this.name = "ResourceInvalidError";
+  }
+};
+var AllocationCodeError = class extends AutotaskError {
+  /** The failure kind (the machine code is `ALLOCATION_CODE_<KIND>`). */
+  kind;
+  constructor(kind, message, options = {}) {
+    super(message, { code: `ALLOCATION_CODE_${kind}`, category: "validation", ...options });
+    this.name = "AllocationCodeError";
+    this.kind = kind;
+  }
+};
+var NoApplicableAllocationCodeError = class extends AutotaskError {
+  /** The structured blocker details (filters tried + department sets). */
+  details;
+  constructor(details, options = {}) {
+    const families = details.families.map((f) => `${f.label} (useType eq ${f.family} + isActive eq true)`).join(", ");
+    super(
+      `No applicable allocation code for resource ${details.resourceID}: no active code passed the department applicability check for any family tried (${families}). The API user cannot create or activate allocation codes (userAccessForCreate "None") \u2014 this is a tenant-admin blocker.`,
+      {
+        code: "NO_APPLICABLE_ALLOCATION_CODE",
+        category: "policy",
+        resourceIds: [details.resourceID],
+        suggestedAction: `In the tenant administration, activate (or create, then activate) an allocation code that is tenant-wide (department null) or scoped to one of the resource departments [${details.resourceDepartments.join(", ")}] for a needed family, then retry.`,
+        ...options
+      }
+    );
+    this.name = "NoApplicableAllocationCodeError";
+    this.details = { ...details, idRefs: [{ entity: "resource", id: details.resourceID }] };
+  }
+};
+
+// src/resources/special/time_entries/createTypes.ts
 var USE_TYPE_GENERAL = 1;
 var USE_TYPE_INTERNAL = 3;
 var BODY_INTERNAL_CODE_KEY = "internalBillingCodeID";
@@ -11382,40 +12040,8 @@ var LINKAGE_OWNED_FIELDS = /* @__PURE__ */ new Set([
   "roleID"
 ]);
 var TIME_WINDOW_FIELDS = /* @__PURE__ */ new Set(["dateWorked", "startDateTime", "endDateTime", "hoursWorked"]);
-var ResourceInvalidError = class extends AutotaskError {
-  constructor(message, options = {}) {
-    super(message, { code: "RESOURCE_INVALID", category: "validation", ...options });
-    this.name = "ResourceInvalidError";
-  }
-};
-var AllocationCodeError = class extends AutotaskError {
-  /** The failure kind (the machine code is `ALLOCATION_CODE_<KIND>`). */
-  kind;
-  constructor(kind, message, options = {}) {
-    super(message, { code: `ALLOCATION_CODE_${kind}`, category: "validation", ...options });
-    this.name = "AllocationCodeError";
-    this.kind = kind;
-  }
-};
-var NoApplicableAllocationCodeError = class extends AutotaskError {
-  /** The structured blocker details (filters tried + department sets). */
-  details;
-  constructor(details, options = {}) {
-    const families = details.families.map((f) => `${f.label} (useType eq ${f.family} + isActive eq true)`).join(", ");
-    super(
-      `No applicable allocation code for resource ${details.resourceID}: no active code passed the department applicability check for any family tried (${families}). The API user cannot create or activate allocation codes (userAccessForCreate "None") \u2014 this is a tenant-admin blocker.`,
-      {
-        code: "NO_APPLICABLE_ALLOCATION_CODE",
-        category: "policy",
-        resourceIds: [details.resourceID],
-        suggestedAction: `In the tenant administration, activate (or create, then activate) an allocation code that is tenant-wide (department null) or scoped to one of the resource departments [${details.resourceDepartments.join(", ")}] for a needed family, then retry.`,
-        ...options
-      }
-    );
-    this.name = "NoApplicableAllocationCodeError";
-    this.details = { ...details, idRefs: [{ entity: "resource", id: details.resourceID }] };
-  }
-};
+
+// src/resources/special/time_entries/resolve.ts
 async function boundedQuery(http, path, filter, totalCap, operation) {
   const items = [];
   const pageSize = Math.min(PAGE_SIZE, totalCap);
@@ -11486,7 +12112,7 @@ function rankCodes(codes) {
     return Number(a.id) - Number(b.id);
   });
 }
-async function resolveCode(http, family, familyLabel, pinnedId, departments, operation) {
+async function resolveCode(http, family, familyLabel2, pinnedId, departments, operation) {
   const applicabilityFilters = [
     { field: "useType", op: "eq", value: family },
     { field: "isActive", op: "eq", value: true }
@@ -11497,7 +12123,7 @@ async function resolveCode(http, family, familyLabel, pinnedId, departments, ope
       throw new AllocationCodeError(
         "NOT_FOUND",
         `Pinned allocation code ${pinnedId} was not found (billing_codes.get returned item: null)`,
-        { resourceIds: [pinnedId], details: { idRefs: [{ entity: "billing_code", id: pinnedId }] }, operation, suggestedAction: `Resolve an existing ${familyLabel} allocation code id (billing_codes.query with a filter) and re-pin.` }
+        { resourceIds: [pinnedId], details: { idRefs: [{ entity: "billing_code", id: pinnedId }] }, operation, suggestedAction: `Resolve an existing ${familyLabel2} allocation code id (billing_codes.query with a filter) and re-pin.` }
       );
     }
     if (rec.isActive !== true) {
@@ -11510,7 +12136,7 @@ async function resolveCode(http, family, familyLabel, pinnedId, departments, ope
     if (rec.useType !== family) {
       throw new AllocationCodeError(
         "WRONG_TYPE",
-        `Pinned allocation code ${pinnedId} is useType ${String(rec.useType ?? "unknown")}, not the ${familyLabel} family (useType ${family})`,
+        `Pinned allocation code ${pinnedId} is useType ${String(rec.useType ?? "unknown")}, not the ${familyLabel2} family (useType ${family})`,
         { resourceIds: [pinnedId], details: { idRefs: [{ entity: "billing_code", id: pinnedId }] }, operation, suggestedAction: `Pin a code from the right family (billing_codes.query with useType eq ${family} + isActive eq true).` }
       );
     }
@@ -11528,7 +12154,9 @@ async function resolveCode(http, family, familyLabel, pinnedId, departments, ope
   const applicable = candidates.filter((c) => typeof c.department === "number" ? departments.has(c.department) : true);
   return rankCodes(applicable)[0] ?? null;
 }
-var OP = "time_entries.createForResource";
+
+// src/resources/special/time_entries/createForResource.ts
+var OP3 = "time_entries.createForResource";
 var PARAM_KEYS = /* @__PURE__ */ new Set([
   "internallAllocationCodeID",
   "ticketID",
@@ -11550,8 +12178,9 @@ function windowDefaults(params) {
     hoursWorked: 8
   };
 }
-async function createForResource(resource, resourceID, params, opts = {}, http) {
-  const rid = parseIdentifier(resourceID, "resourceID");
+var familyOf = (l) => l === "internal" ? USE_TYPE_INTERNAL : USE_TYPE_GENERAL;
+var familyLabel = (f) => f === USE_TYPE_GENERAL ? "General Allocation Code" : "Internal Allocation Code";
+function validateCreateParams(params) {
   const pin = (value, label) => typeof value === "number" ? parseIdentifier(value, label) : void 0;
   const pins = {
     code: pin(params.internallAllocationCodeID, "internallAllocationCodeID"),
@@ -11563,27 +12192,30 @@ async function createForResource(resource, resourceID, params, opts = {}, http)
   if (pinCount > 1) {
     throw new AutotaskConfigError(
       "createForResource: exactly one linkage pin is honoured (internallAllocationCodeID | ticketID | taskID) \u2014 the vendor gate requires exactly one; pass one pin (or none for the default internal linkage)",
-      { operation: OP }
+      { operation: OP3 }
     );
   }
   if (pins.role !== void 0 && pins.code !== void 0) {
     throw new AutotaskConfigError(
       "createForResource: a pinned roleID is only meaningful with the task/ticket linkage (internallAllocationCodeID pins the internal linkage and owns the code) \u2014 drop one",
-      { operation: OP }
+      { operation: OP3 }
     );
   }
   if (params.hoursWorked !== void 0 && (typeof params.hoursWorked !== "number" || !Number.isFinite(params.hoursWorked) || params.hoursWorked <= 0)) {
     throw new AutotaskConfigError(
       `createForResource: hoursWorked must be a positive finite number (got ${String(params.hoursWorked)})`,
-      { operation: OP }
+      { operation: OP3 }
     );
   }
-  const rec = await fetchItem2(http, `/V1.0/Resources/${rid}`, OP);
+  return pins;
+}
+async function assertResourceActive(http, rid) {
+  const rec = await fetchItem2(http, `/V1.0/Resources/${rid}`, OP3);
   if (rec === null) {
     throw new ResourceInvalidError(`Resource ${rid} was not found \u2014 a time entry cannot attach to a missing resource`, {
       resourceIds: [rid],
       details: { idRefs: [{ entity: "resource", id: rid }] },
-      operation: OP,
+      operation: OP3,
       category: "not_found",
       suggestedAction: "Resolve the resource id (resources.get / resources.search) and retry."
     });
@@ -11592,24 +12224,21 @@ async function createForResource(resource, resourceID, params, opts = {}, http)
     throw new ResourceInvalidError(`Resource ${rid} is not active (isActive !== true) \u2014 the vendor would reject a time entry for an inactive resource`, {
       resourceIds: [rid],
       details: { idRefs: [{ entity: "resource", id: rid }] },
-      operation: OP,
+      operation: OP3,
       suggestedAction: "Activate the resource or pick an active one."
     });
   }
-  const linkage = pins.code !== void 0 ? "internal" : pins.ticket !== void 0 ? "ticket" : pins.task !== void 0 ? "task" : "internal";
-  const roleRows = await resourceRoleRows(http, rid, OP);
-  const departments = roleRows.departments;
-  const familyOf = (l) => l === "internal" ? USE_TYPE_INTERNAL : USE_TYPE_GENERAL;
-  const familyLabel = (f) => f === USE_TYPE_GENERAL ? "General Allocation Code" : "Internal Allocation Code";
+}
+async function resolveAllocationCode(http, rid, linkage, pins, departments) {
   let usedLinkage = linkage;
   const pinnedForCode = pins.code !== void 0 ? pins.code : pins.role;
   let code = null;
   const familiesTried = [];
-  code = await resolveCode(http, familyOf(linkage), familyLabel(familyOf(linkage)), pinnedForCode, departments, OP);
+  code = await resolveCode(http, familyOf(linkage), familyLabel(familyOf(linkage)), pinnedForCode, departments, OP3);
   familiesTried.push({ family: familyOf(linkage), label: familyLabel(familyOf(linkage)), filters: [{ field: "useType", op: "eq", value: familyOf(linkage) }, { field: "isActive", op: "eq", value: true }] });
   if (code === null && linkage === "task" && pins.role === void 0) {
     usedLinkage = "internal";
-    code = await resolveCode(http, USE_TYPE_INTERNAL, familyLabel(USE_TYPE_INTERNAL), void 0, departments, OP);
+    code = await resolveCode(http, USE_TYPE_INTERNAL, familyLabel(USE_TYPE_INTERNAL), void 0, departments, OP3);
     familiesTried.push({ family: USE_TYPE_INTERNAL, label: familyLabel(USE_TYPE_INTERNAL), filters: [{ field: "useType", op: "eq", value: USE_TYPE_INTERNAL }, { field: "isActive", op: "eq", value: true }] });
   }
   if (code === null) {
@@ -11619,11 +12248,13 @@ async function createForResource(resource, resourceID, params, opts = {}, http)
         families: familiesTried,
         resourceDepartments: [...departments].sort((a, b) => a - b)
       },
-      { operation: OP }
+      { operation: OP3 }
     );
   }
   const resolvedCode = codeInfo(code);
-  const defaults = windowDefaults(params);
+  return { usedLinkage, resolvedCode };
+}
+function buildCreateBody(rid, params, pins, usedLinkage, resolvedCode, defaults) {
   const window = {};
   for (const field of ["dateWorked", "startDateTime", "endDateTime", "hoursWorked"]) {
     const callerValue = params[field];
@@ -11642,34 +12273,37 @@ async function createForResource(resource, resourceID, params, opts = {}, http)
     body[usedLinkage === "task" ? "taskID" : "ticketID"] = usedLinkage === "task" ? pins.task : pins.ticket;
     body.roleID = resolvedCode.id;
   }
-  if (opts.dryRun === true) {
-    const warnings = [];
-    if (usedLinkage !== "internal") {
-      warnings.push(
-        `roleID strategy: the resolved ${familyLabel(familyOf(usedLinkage))} code id ${resolvedCode.id} (H2 primary); on a vendor gate-3 rejection ("not an active general allocation code") the H1 demotion ladder applies (task.assignedResourceRoleID \u2192 the resource's active resource_roles rows) \u2014 at most ${MAX_CREATE_ATTEMPTS} create attempts.`
-      );
-    }
-    if (usedLinkage === "internal" && linkage === "task") {
-      warnings.push("the task had zero applicable general allocation codes \u2014 the linkage fell back to internal (the sanctioned fallback; no taskID/roleID in the body).");
-    }
-    return buildDryRunResult(
-      {
-        operation: OP,
-        method: "POST",
-        path: "/V1.0/TimeEntries",
-        ids: [rid],
-        checks: [
-          { name: "input-validation", ok: true },
-          { name: "resource-active", ok: true },
-          { name: "allocation-code-resolved", ok: true }
-        ],
-        impact: { affected: 1, scope: "single-record", reversible: true },
-        warnings,
-        data: body
-      },
-      { redactPersonalData: http.redactPersonalData }
+  return body;
+}
+function createDryRun2(http, rid, body, linkage, usedLinkage, resolvedCode) {
+  const warnings = [];
+  if (usedLinkage !== "internal") {
+    warnings.push(
+      `roleID strategy: the resolved ${familyLabel(familyOf(usedLinkage))} code id ${resolvedCode.id} (H2 primary); on a vendor gate-3 rejection ("not an active general allocation code") the H1 demotion ladder applies (task.assignedResourceRoleID \u2192 the resource's active resource_roles rows) \u2014 at most ${MAX_CREATE_ATTEMPTS} create attempts.`
     );
   }
+  if (usedLinkage === "internal" && linkage === "task") {
+    warnings.push("the task had zero applicable general allocation codes \u2014 the linkage fell back to internal (the sanctioned fallback; no taskID/roleID in the body).");
+  }
+  return buildDryRunResult(
+    {
+      operation: OP3,
+      method: "POST",
+      path: "/V1.0/TimeEntries",
+      ids: [rid],
+      checks: [
+        { name: "input-validation", ok: true },
+        { name: "resource-active", ok: true },
+        { name: "allocation-code-resolved", ok: true }
+      ],
+      impact: { affected: 1, scope: "single-record", reversible: true },
+      warnings,
+      data: body
+    },
+    { redactPersonalData: http.redactPersonalData }
+  );
+}
+async function createWithAttempts(resource, http, opts, body, defaults, pins, usedLinkage, resolvedCode, roleRows) {
   const roleCandidates = [resolvedCode.id];
   let taskRoleFetched = false;
   const pushLadder = (value) => {
@@ -11695,7 +12329,7 @@ async function createForResource(resource, resourceID, params, opts = {}, http)
       const gate3 = ROLE_REJECTION_PATTERN.test(text);
       if (usedLinkage !== "internal" && gate3) {
         if (!taskRoleFetched && usedLinkage === "task" && pins.task !== void 0) {
-          const task = await fetchItem2(http, `/V1.0/Tasks/${pins.task}`, OP);
+          const task = await fetchItem2(http, `/V1.0/Tasks/${pins.task}`, OP3);
           taskRoleFetched = true;
           if (task !== null) pushLadder(task.assignedResourceRoleID);
         }
@@ -11716,6 +12350,19 @@ async function createForResource(resource, resourceID, params, opts = {}, http)
   }
   throw lastError;
 }
+async function createForResource(resource, resourceID, params, opts = {}, http) {
+  const rid = parseIdentifier(resourceID, "resourceID");
+  const pins = validateCreateParams(params);
+  await assertResourceActive(http, rid);
+  const linkage = pins.code !== void 0 ? "internal" : pins.ticket !== void 0 ? "ticket" : pins.task !== void 0 ? "task" : "internal";
+  const roleRows = await resourceRoleRows(http, rid, OP3);
+  const departments = roleRows.departments;
+  const { usedLinkage, resolvedCode } = await resolveAllocationCode(http, rid, linkage, pins, departments);
+  const defaults = windowDefaults(params);
+  const body = buildCreateBody(rid, params, pins, usedLinkage, resolvedCode, defaults);
+  if (opts.dryRun === true) return createDryRun2(http, rid, body, linkage, usedLinkage, resolvedCode);
+  return createWithAttempts(resource, http, opts, body, defaults, pins, usedLinkage, resolvedCode, roleRows);
+}
 function discoveryField(err, body, defaults) {
   if (!isAutotaskError(err) || err.vendorError === void 0) return null;
   const entries = parseVendorErrors(err.vendorError);
@@ -11730,6 +12377,76 @@ function discoveryField(err, body, defaults) {
   return null;
 }
 
+// src/resources/special/time_entries/move.ts
+var OP4 = "time_entries.moveToTicket";
+var COPY2 = ["resourceID", "roleID", "billingCodeID", "dateWorked", "startDateTime", "endDateTime", "hoursWorked", "offsetHours", "summaryNotes", "internalNotes", "isNonBillable", "showOnInvoice"];
+var CONTRACT_SCOPED2 = ["contractID", "contractServiceID", "contractServiceBundleID"];
+async function readTimeEntry(http, id, retries) {
+  try {
+    const res = await http.request({ method: "GET", path: `/V1.0/TimeEntries/${id}`, operation: OP4, maxRetries: retries });
+    return res?.item ?? null;
+  } catch (e) {
+    if (isAutotaskError(e) && (e.httpStatus === 404 || e.code === "NOT_FOUND")) return null;
+    throw e;
+  }
+}
+async function checkSource2({ http, source, sourceId, toTicketId, retries }) {
+  const ids2 = { sourceId, toTicketId };
+  if (source.taskID !== null && source.taskID !== void 0) {
+    throw refuse("MOVE_SOURCE_UNSUPPORTED", `${OP4}: time entry ${sourceId} is on a task \u2014 only ticket time entries are moved`, ids2, OP4);
+  }
+  if (source.billingApprovalDateTime || source.billingApprovalResourceID || source.billingApprovalLevelMostRecent) {
+    throw refuse("MOVE_BLOCKED_APPROVED", `${OP4}: time entry ${sourceId} has billing approval set \u2014 move it in the Autotask UI`, ids2, OP4, { manualAction: { action: "delete_source", uiLink: uiLinkFor(http, "time_entries", sourceId), reason: "approved entries are not moved by the API" } });
+  }
+  let billing;
+  try {
+    billing = await queryRows(http, "BillingItems", [{ field: "timeEntryID", op: "eq", value: sourceId }], OP4, retries);
+  } catch {
+    throw refuse("MOVE_BLOCKED_BILLED", `${OP4}: the billing items of time entry ${sourceId} could not be read \u2014 refused (fails closed)`, ids2, OP4, { manualAction: { action: "delete_source", uiLink: uiLinkFor(http, "time_entries", sourceId), reason: "billing state unreadable" } });
+  }
+  if (billing.some((b) => b.invoiceID || b.postedDate)) {
+    throw refuse("MOVE_BLOCKED_BILLED", `${OP4}: time entry ${sourceId} is billed or posted \u2014 move it in the Autotask UI`, ids2, OP4, { manualAction: { action: "delete_source", uiLink: uiLinkFor(http, "time_entries", sourceId), reason: "billed entries are not moved by the API" } });
+  }
+  const attachments = await queryRows(http, "TimeEntryAttachments", [{ field: "timeEntryID", op: "eq", value: sourceId }], OP4, retries);
+  if (attachments.length > 0) {
+    throw refuse("MOVE_BLOCKED_ATTACHMENTS", `${OP4}: time entry ${sourceId} has attachments, which a delete would destroy \u2014 move it in the Autotask UI`, ids2, OP4, { manualAction: { action: "delete_source", uiLink: uiLinkFor(http, "time_entries", sourceId), reason: "entries with attachments are not moved by the API" } });
+  }
+}
+var SPEC2 = {
+  operation: OP4,
+  entity: "time_entry",
+  readSource: readTimeEntry,
+  sourceTicketId: (s) => typeof s.ticketID === "number" ? s.ticketID : null,
+  dateField: "dateWorked",
+  checkSource: checkSource2,
+  buildPayload(source, toTicketId, { sameScope }) {
+    const body = { ticketID: toTicketId };
+    for (const k of COPY2) if (source[k] !== void 0 && source[k] !== null) body[k] = source[k];
+    if (sameScope) {
+      for (const k of CONTRACT_SCOPED2) if (source[k] !== void 0 && source[k] !== null) body[k] = source[k];
+    }
+    return body;
+  },
+  createPath: () => "/V1.0/TimeEntries",
+  deletePath: (id) => `/V1.0/TimeEntries/${id}`,
+  readById: (http, id) => readTimeEntry(http, id),
+  verifyFields: ["resourceID", "roleID", "billingCodeID", "dateWorked", "startDateTime", "endDateTime", "hoursWorked", "summaryNotes", "internalNotes", "isNonBillable"],
+  guardFields: ["ticketID", "resourceID", "roleID", "dateWorked", "startDateTime", "endDateTime", "hoursWorked", "summaryNotes", "billingApprovalDateTime", "billingApprovalResourceID", "lastModifiedDateTime"],
+  twinQuery: (p) => ({
+    resource: "TimeEntries",
+    filter: [
+      { field: "ticketID", op: "eq", value: p.ticketID },
+      { field: "resourceID", op: "eq", value: p.resourceID },
+      { field: "dateWorked", op: "eq", value: p.dateWorked },
+      { field: "hoursWorked", op: "eq", value: p.hoursWorked }
+    ]
+  }),
+  manualLink: (http, source) => uiLinkFor(http, "time_entries", Number(source.id))
+};
+function moveToTicket2(_resource, sourceId, toTicketId, opts, http) {
+  return runMove(http, SPEC2, sourceId, toTicketId, opts);
+}
+
 // src/resources/time_entries.ts
 var TimeEntriesResource = class extends BaseResource {
   constructor(http, pageSize) {
@@ -11854,6 +12571,10 @@ var TimeEntriesResource = class extends BaseResource {
     return windowQuery3(this, "lastFullWeek", this.http, opts);
   }
   /** Node-parity special op (hand-written in src/resources/special/time_entries.ts). */
+  moveToTicket(sourceId, toTicketId, opts = {}) {
+    return moveToTicket2(this, sourceId, toTicketId, opts, this.http);
+  }
+  /** Node-parity special op (hand-written in src/resources/special/time_entries.ts). */
   postedWithin(from, to, opts) {
     return postedWithin(this, from, to, this.http, opts);
   }