@burdenoff/microfe-planmagnet 2026.1002.2 → 2026.1002.3

package/dist/generated/wspace-types.d.ts

@@ -850,6 +850,8 @@ export type Mutation = {
     planmagnetCreateCompetitor: Competitor;
     /** Create a new custom field definition */
     planmagnetCreateCustomFieldDefinition: CustomFieldDefinition;
+    /** Records one response (source MANUAL). See PlanmagnetCreateCustomerSatisfactionResponseInput for the rules. */
+    planmagnetCreateCustomerSatisfactionResponse: PlanmagnetCustomerSatisfactionResponse;
     /** Create a new dependency between work items */
     planmagnetCreateDependency: WorkItemDependency;
     planmagnetCreateDoc: PlanmagnetDoc;
@@ -947,6 +949,8 @@ export type Mutation = {
     planmagnetDeleteCompetitor: Scalars['Boolean']['output'];
     /** Delete a custom field definition */
     planmagnetDeleteCustomFieldDefinition: Scalars['Boolean']['output'];
+    /** Soft delete — the response stops counting in every figure. Unknown, deleted or other-workspace id: NOT_FOUND. */
+    planmagnetDeleteCustomerSatisfactionResponse: Scalars['Boolean']['output'];
     /** Remove a dependency */
     planmagnetDeleteDependency: Scalars['Boolean']['output'];
     planmagnetDeleteDoc: Scalars['Boolean']['output'];
@@ -1092,6 +1096,12 @@ export type Mutation = {
      * are computed and returned without writing to the database.
      */
     planmagnetGenerateReleaseNotes: PlanmagnetGenerateReleaseNotesPayload;
+    /**
+     * Imports a batch (source IMPORT). All or nothing: when any row is refused nothing is written, and the
+     * BAD_USER_INPUT lists every refused row in `extensions.rowErrors` ({ row (1-based position in `rows`), field, code,
+     * i18nKey, message }). Idempotent on externalId — see PlanmagnetCustomerSatisfactionImportResult.
+     */
+    planmagnetImportCustomerSatisfactionResponses: PlanmagnetCustomerSatisfactionImportResult;
     /**
      * Import issues exported from an external tool (e.g. a Linear CSV/JSON export)
      * into a project as WorkItems. Idempotent — already-imported issues are skipped.
@@ -1309,7 +1319,8 @@ export type Mutation = {
     /**
      * Set (create, or replace the target of) the CrewFoundry identity override for one workspace member (CWF-30).
      * Validates `platformUserId` is a real member of this workspace and `crewEmployeeId` a real employee in this
-     * workspace's CrewFoundry roster before saving.
+     * workspace's CrewFoundry roster (all of it, every page) before saving. Refused SERVICE_UNAVAILABLE, saving
+     * nothing, while the CrewFoundry roster cannot be read.
      */
     planmagnetSetMemberIdentityOverride: PlanmagnetMemberIdentityOverride;
     /** Tick (records who and when) or untick (clears both) a checklist item */
@@ -1406,6 +1417,8 @@ export type Mutation = {
     planmagnetUpdateCompetitor: Competitor;
     /** Update a custom field definition */
     planmagnetUpdateCustomFieldDefinition: CustomFieldDefinition;
+    /** Unknown, deleted or other-workspace id: NOT_FOUND. */
+    planmagnetUpdateCustomerSatisfactionResponse: PlanmagnetCustomerSatisfactionResponse;
     /** Update an existing dependency */
     planmagnetUpdateDependency: WorkItemDependency;
     planmagnetUpdateDoc: PlanmagnetDoc;
@@ -1614,6 +1627,9 @@ export type MutationPlanmagnetCreateCompetitorArgs = {
 export type MutationPlanmagnetCreateCustomFieldDefinitionArgs = {
     input: PlanmagnetCreateCustomFieldDefinitionInput;
 };
+export type MutationPlanmagnetCreateCustomerSatisfactionResponseArgs = {
+    input: PlanmagnetCreateCustomerSatisfactionResponseInput;
+};
 export type MutationPlanmagnetCreateDependencyArgs = {
     input: PlanmagnetCreateDependencyInput;
 };
@@ -1740,6 +1756,9 @@ export type MutationPlanmagnetDeleteCompetitorArgs = {
 export type MutationPlanmagnetDeleteCustomFieldDefinitionArgs = {
     id: Scalars['ID']['input'];
 };
+export type MutationPlanmagnetDeleteCustomerSatisfactionResponseArgs = {
+    id: Scalars['ID']['input'];
+};
 export type MutationPlanmagnetDeleteDependencyArgs = {
     id: Scalars['ID']['input'];
 };
@@ -1881,6 +1900,9 @@ export type MutationPlanmagnetGenerateReleaseNotesArgs = {
     id: Scalars['ID']['input'];
     persist?: InputMaybe<Scalars['Boolean']['input']>;
 };
+export type MutationPlanmagnetImportCustomerSatisfactionResponsesArgs = {
+    input: PlanmagnetImportCustomerSatisfactionResponsesInput;
+};
 export type MutationPlanmagnetImportExternalIssuesArgs = {
     input: PlanmagnetImportExternalIssuesInput;
 };
@@ -2199,6 +2221,10 @@ export type MutationPlanmagnetUpdateCustomFieldDefinitionArgs = {
     id: Scalars['ID']['input'];
     input: PlanmagnetUpdateCustomFieldDefinitionInput;
 };
+export type MutationPlanmagnetUpdateCustomerSatisfactionResponseArgs = {
+    id: Scalars['ID']['input'];
+    input: PlanmagnetUpdateCustomerSatisfactionResponseInput;
+};
 export type MutationPlanmagnetUpdateDependencyArgs = {
     id: Scalars['ID']['input'];
     input: PlanmagnetUpdateDependencyInput;
@@ -3054,6 +3080,11 @@ export type PlanmagnetBulkUpdateWorkItemsInput = {
     /** Group every selected item under this milestone (all must be in its project), or null to remove them from theirs */
     milestoneId?: InputMaybe<Scalars['String']['input']>;
     priority?: InputMaybe<WorkItemPriority>;
+    /**
+     * Replaces every selected item's required skills (same rules as on create); null or [] clears them, leaving it out
+     * keeps them
+     */
+    requiredSkills?: InputMaybe<Array<Scalars['String']['input']>>;
     sprintId?: InputMaybe<Scalars['String']['input']>;
     status?: InputMaybe<WorkItemStatus>;
 };
@@ -3276,6 +3307,31 @@ export type PlanmagnetCreateCustomFieldDefinitionInput = {
     sortOrder?: InputMaybe<Scalars['Int']['input']>;
     validationRules?: InputMaybe<Scalars['JSON']['input']>;
 };
+/**
+ * Shared rules (create and every import row): `score` on the metric type's scale (CSAT 1-5, NPS 0-10); `respondedAt`
+ * not in the future (a date picked as today in any time zone is accepted) and not before 2000-01-01; at least one of
+ * productId/releaseId/projectId, each a live row of this workspace (else NOT_FOUND); a release that belongs to a product
+ * must belong to the given productId (else BAD_USER_INPUT); an anonymous response takes no respondent name or email
+ * (else BAD_USER_INPUT). An archived product still takes responses.
+ */
+export type PlanmagnetCreateCustomerSatisfactionResponseInput = {
+    /** At most 5000 characters. Blank is stored as null. */
+    comment?: InputMaybe<Scalars['String']['input']>;
+    /** Optional (at most 200 characters). Another live MANUAL response with the same externalId is CONFLICT. */
+    externalId?: InputMaybe<Scalars['String']['input']>;
+    /** Defaults to false. */
+    isAnonymous?: InputMaybe<Scalars['Boolean']['input']>;
+    metricType: PlanmagnetSatisfactionMetricType;
+    productId?: InputMaybe<Scalars['ID']['input']>;
+    projectId?: InputMaybe<Scalars['ID']['input']>;
+    releaseId?: InputMaybe<Scalars['ID']['input']>;
+    respondedAt: Scalars['DateTime']['input'];
+    /** At most 254 characters. */
+    respondentEmail?: InputMaybe<Scalars['String']['input']>;
+    /** At most 200 characters. */
+    respondentName?: InputMaybe<Scalars['String']['input']>;
+    score: Scalars['Int']['input'];
+};
 export type PlanmagnetCreateDependencyInput = {
     description?: InputMaybe<Scalars['String']['input']>;
     lagMinutes?: InputMaybe<Scalars['Int']['input']>;
@@ -3636,6 +3692,11 @@ export type PlanmagnetCreateWorkItemInput = {
     priority?: InputMaybe<WorkItemPriority>;
     projectId: Scalars['String']['input'];
     reporterId?: InputMaybe<Scalars['String']['input']>;
+    /**
+     * Skills this item needs: normalized (trimmed, whitespace collapsed, case-insensitive duplicates dropped keeping the
+     * first spelling); at most 20, each 1 to 64 characters. An empty or over-long skill is refused, not dropped
+     */
+    requiredSkills?: InputMaybe<Array<Scalars['String']['input']>>;
     sortOrder?: InputMaybe<Scalars['Int']['input']>;
     sprintId?: InputMaybe<Scalars['String']['input']>;
     status?: InputMaybe<WorkItemStatus>;
@@ -3676,6 +3737,20 @@ export type PlanmagnetCriticalPath = {
      */
     totalDurationMinutes: Scalars['Int']['output'];
 };
+/** CSAT over a scope and window. `score` is exact (no server-side rounding). */
+export type PlanmagnetCsatScore = {
+    __typename?: 'PlanmagnetCsatScore';
+    /** 5: fewer responses than this give no score. */
+    minimumResponses: Scalars['Int']['output'];
+    /** True when responseCount < minimumResponses (score is then null). */
+    notEnoughResponses: Scalars['Boolean']['output'];
+    /** CSAT responses counted. */
+    responseCount: Scalars['Int']['output'];
+    /** Of those, the 4s and 5s. */
+    satisfiedCount: Scalars['Int']['output'];
+    /** satisfiedCount * 100 / responseCount, 0-100. Null when responseCount < minimumResponses — never 0. */
+    score?: Maybe<Scalars['Float']['output']>;
+};
 /** Cumulative flow diagram data for a project over a date range. */
 export type PlanmagnetCumulativeFlow = {
     __typename?: 'PlanmagnetCumulativeFlow';
@@ -3706,6 +3781,118 @@ export type PlanmagnetCustomFieldValueList = {
     pageInfo: PlanmagnetPageInfo;
     totalCount: Scalars['Int']['output'];
 };
+/**
+ * Customer satisfaction for one scope and window — CSAT and NPS side by side, each with its own response count and its
+ * own minimum. The scope fields echo the filter (null = not filtered on).
+ */
+export type PlanmagnetCustomerSatisfaction = {
+    __typename?: 'PlanmagnetCustomerSatisfaction';
+    /** The default delivery KPI. */
+    csat: PlanmagnetCsatScore;
+    nps: PlanmagnetNpsScore;
+    productId?: Maybe<Scalars['ID']['output']>;
+    projectId?: Maybe<Scalars['ID']['output']>;
+    releaseId?: Maybe<Scalars['ID']['output']>;
+    window: PlanmagnetSatisfactionWindow;
+    workspaceId: Scalars['ID']['output'];
+};
+/**
+ * Which responses a figure (or a list) covers. Filters combine (AND). `productId` matches responses linked to that
+ * product, and responses linked to one of its releases that name no product of their own (read through the release at
+ * query time). `releaseId` and `projectId` match that link only.
+ */
+export type PlanmagnetCustomerSatisfactionFilter = {
+    productId?: InputMaybe<Scalars['ID']['input']>;
+    projectId?: InputMaybe<Scalars['ID']['input']>;
+    releaseId?: InputMaybe<Scalars['ID']['input']>;
+    /** Defaults to the trailing 90 days. */
+    window?: InputMaybe<PlanmagnetSatisfactionWindowInput>;
+};
+export type PlanmagnetCustomerSatisfactionImportResult = {
+    __typename?: 'PlanmagnetCustomerSatisfactionImportResult';
+    /** Responses written by this call. */
+    createdCount: Scalars['Int']['output'];
+    /**
+     * Rows whose externalId this workspace had already imported — including a response deleted since, which stays
+     * deleted. Skipped: never updated, never duplicated.
+     */
+    skippedCount: Scalars['Int']['output'];
+    /** The skipped rows' externalIds, in row order. */
+    skippedExternalIds: Array<Scalars['String']['output']>;
+};
+/**
+ * One row of an import — the create rules, plus a required externalId (the key that makes re-importing the same file a
+ * no-op).
+ */
+export type PlanmagnetCustomerSatisfactionImportRow = {
+    comment?: InputMaybe<Scalars['String']['input']>;
+    /** 1-200 characters, unique within the import. */
+    externalId: Scalars['String']['input'];
+    isAnonymous?: InputMaybe<Scalars['Boolean']['input']>;
+    metricType: PlanmagnetSatisfactionMetricType;
+    productId?: InputMaybe<Scalars['ID']['input']>;
+    projectId?: InputMaybe<Scalars['ID']['input']>;
+    releaseId?: InputMaybe<Scalars['ID']['input']>;
+    respondedAt: Scalars['DateTime']['input'];
+    respondentEmail?: InputMaybe<Scalars['String']['input']>;
+    respondentName?: InputMaybe<Scalars['String']['input']>;
+    score: Scalars['Int']['input'];
+};
+/**
+ * One customer's answer. Links to a product, a release and/or a project — at least one. Deleting (soft) a linked
+ * product, release or project leaves the response in place: it is the customer's answer, and the link reads as null.
+ */
+export type PlanmagnetCustomerSatisfactionResponse = {
+    __typename?: 'PlanmagnetCustomerSatisfactionResponse';
+    /** Plain text, at most 5000 characters. Never rendered as HTML server-side. */
+    comment?: Maybe<Scalars['String']['output']>;
+    createdAt: Scalars['DateTime']['output'];
+    createdBy: Scalars['String']['output'];
+    deletedAt?: Maybe<Scalars['DateTime']['output']>;
+    /** The answer's id in the system it came from. Unique per workspace and source among live responses. */
+    externalId?: Maybe<Scalars['String']['output']>;
+    id: Scalars['ID']['output'];
+    /** When true, no respondent identity is stored — respondentName and respondentEmail are always null. */
+    isAnonymous: Scalars['Boolean']['output'];
+    metricType: PlanmagnetSatisfactionMetricType;
+    /** Null if there is no product link, or that product has since been deleted. */
+    product?: Maybe<Product>;
+    productId?: Maybe<Scalars['String']['output']>;
+    /** Null if there is no project link, or that project has since been deleted. */
+    project?: Maybe<PlanmagnetProject>;
+    projectId?: Maybe<Scalars['String']['output']>;
+    /** Null if there is no release link, or that release has since been deleted. */
+    release?: Maybe<Release>;
+    releaseId?: Maybe<Scalars['String']['output']>;
+    /** When the customer answered — what every window filters on. */
+    respondedAt: Scalars['DateTime']['output'];
+    /** The respondent's email as recorded, or null. Never set on an anonymous response. */
+    respondentEmail?: Maybe<Scalars['String']['output']>;
+    /** The respondent's name as recorded, or null. Never set on an anonymous response. */
+    respondentName?: Maybe<Scalars['String']['output']>;
+    /** CSAT 1-5, NPS 0-10. */
+    score: Scalars['Int']['output'];
+    source: PlanmagnetSatisfactionResponseSource;
+    updatedAt: Scalars['DateTime']['output'];
+    updatedBy?: Maybe<Scalars['String']['output']>;
+    workspaceId: Scalars['String']['output'];
+};
+export type PlanmagnetCustomerSatisfactionResponseFilter = {
+    metricType?: InputMaybe<PlanmagnetSatisfactionMetricType>;
+    /** Same product rule as PlanmagnetCustomerSatisfactionFilter.productId. */
+    productId?: InputMaybe<Scalars['ID']['input']>;
+    projectId?: InputMaybe<Scalars['ID']['input']>;
+    releaseId?: InputMaybe<Scalars['ID']['input']>;
+    source?: InputMaybe<PlanmagnetSatisfactionResponseSource>;
+    /** Omitted: every response, whenever it was given. */
+    window?: InputMaybe<PlanmagnetSatisfactionWindowInput>;
+};
+export type PlanmagnetCustomerSatisfactionResponseList = {
+    __typename?: 'PlanmagnetCustomerSatisfactionResponseList';
+    items: Array<PlanmagnetCustomerSatisfactionResponse>;
+    pageInfo: PlanmagnetPageInfo;
+    totalCount: Scalars['Int']['output'];
+};
 /**
  * Cycle-time distribution for a project over a date range. Only work items
  * with a recorded transition INTO DONE within the range are counted — an item
@@ -3771,13 +3958,20 @@ export type PlanmagnetDeliveryForecast = {
 };
 /**
  * On-time delivery and scope-adherence KPIs across sprints, releases and milestones COMPLETED within a date
- * range (default: the trailing 30 days), for a workspace or one project (ANR-21).
- *
- * `customerSatisfaction` is deliberately NOT a field here: PlanMagnet has no survey/NPS/CSAT data source to
- * back it, and a placeholder that always read null or zero would be worse than its absence.
+ * range (default: the trailing 30 days), for a workspace or one project (ANR-21), plus customer satisfaction
+ * (CSAT, the default delivery KPI, and NPS) from recorded customer responses — see `customerSatisfaction`.
  */
 export type PlanmagnetDeliveryKpis = {
     __typename?: 'PlanmagnetDeliveryKpis';
+    /**
+     * ANR-21: CSAT (the default delivery KPI) and NPS from customer-satisfaction responses about this scope — the
+     * workspace, or responses linked to `projectId` — exactly as planmagnetCustomerSatisfaction computes them (a
+     * score needs at least 5 responses per metric; below that it is null, never 0). Its window: when this query was
+     * given startDate and/or endDate, the same UTC days as every other KPI here (startDate..endDate); when it was
+     * given neither, the satisfaction default — the trailing 90 days — not this query's 30-day default.
+     * `customerSatisfaction.window` always states which. Computed only when selected.
+     */
+    customerSatisfaction: PlanmagnetCustomerSatisfaction;
     endDate: Scalars['DateTime']['output'];
     /** Milestones (status COMPLETED) whose completedDate fell in range. */
     milestoneCount: Scalars['Int']['output'];
@@ -4220,6 +4414,10 @@ export type PlanmagnetGenerateReleaseNotesPayload = {
     markdown: Scalars['String']['output'];
     release: Release;
 };
+export type PlanmagnetImportCustomerSatisfactionResponsesInput = {
+    /** 1 to 500 rows, parsed from a CSV by the client. */
+    rows: Array<PlanmagnetCustomerSatisfactionImportRow>;
+};
 /**
  * Import issues exported from an external tool (e.g. Linear) as WorkItems.
  * The caller supplies the exported payload directly (no external API credentials).
@@ -4607,6 +4805,24 @@ export type PlanmagnetNoEpicWorkBreakdown = {
     openCount: Scalars['Int']['output'];
     openPoints: Scalars['Int']['output'];
 };
+/** NPS over a scope and window. `score` is exact (no server-side rounding) and is never an average of the answers. */
+export type PlanmagnetNpsScore = {
+    __typename?: 'PlanmagnetNpsScore';
+    /** 0s to 6s. */
+    detractorCount: Scalars['Int']['output'];
+    /** 5: fewer responses than this give no score. */
+    minimumResponses: Scalars['Int']['output'];
+    /** True when responseCount < minimumResponses (score is then null). */
+    notEnoughResponses: Scalars['Boolean']['output'];
+    /** 7s and 8s. */
+    passiveCount: Scalars['Int']['output'];
+    /** 9s and 10s. */
+    promoterCount: Scalars['Int']['output'];
+    /** NPS responses counted (promoters + passives + detractors). */
+    responseCount: Scalars['Int']['output'];
+    /** (promoterCount - detractorCount) * 100 / responseCount, -100 to 100. Null when responseCount < minimumResponses. */
+    score?: Maybe<Scalars['Float']['output']>;
+};
 /**
  * A workspace-scoped goal for a given time period. `progress` is the average
  * of its non-deleted KeyResults' progress (0 when it has none).
@@ -5277,24 +5493,50 @@ export declare enum PlanmagnetQualityTrendDirection {
     /** recentDefectRatio is at least 10% above priorDefectRatio. */
     Worsening = "WORSENING"
 }
-/** Workspace-level quota usage and limits for PlanMagnet. */
+/**
+ * Workspace-level quota usage and limits for PlanMagnet. Each limit is the one
+ * enforced for that quota: the sum of the workspace's active billing assignments
+ * for it. A limit is null when none is known: an assignment is unlimited, the
+ * workspace holds no assignment for the quota, or billing could not be reached.
+ */
 export type PlanmagnetQuotaOverview = {
     __typename?: 'PlanmagnetQuotaOverview';
     /** Number of active automation rules in the workspace */
     automationRuleCount: Scalars['Int']['output'];
-    /** Monthly automation run quota limit (null when unlimited or unassigned) */
+    /**
+     * Automation runs the workspace may execute per month
+     * (`planmagnet.automation.runs_monthly`, the limit the run gate checks). Null
+     * when unlimited, unassigned, or billing could not be reached. Unlike the other
+     * limits, unassigned does not mean uncapped: the run gate refuses every run
+     * while the workspace holds no assignment for this quota.
+     */
     automationRunsMonthlyLimit?: Maybe<Scalars['Int']['output']>;
     /** Number of active boards across all projects */
     boardCount: Scalars['Int']['output'];
-    /** Board quota limit (null when unlimited or unassigned) */
+    /**
+     * Most active boards the workspace may hold (`planmagnet.boards.count`, the
+     * limit board creation is checked against). Null when unlimited, unassigned, or
+     * billing could not be reached; board creation is not capped in any of those
+     * cases.
+     */
     boardLimit?: Maybe<Scalars['Int']['output']>;
     /** Number of active editor seats in the workspace (BOFF-5094) */
     editorCount: Scalars['Int']['output'];
-    /** Editor quota limit (null when unlimited or unassigned) */
+    /**
+     * Most editor seats the workspace may hold (`planmagnet.editors.count`, the
+     * limit editor grants are checked against). Null when unlimited, unassigned, or
+     * billing could not be reached; editor grants are not capped in any of those
+     * cases.
+     */
     editorLimit?: Maybe<Scalars['Int']['output']>;
     /** Number of active projects in the workspace */
     projectCount: Scalars['Int']['output'];
-    /** Project quota limit (null when unlimited or unassigned) */
+    /**
+     * Most active projects the workspace may hold (`planmagnet.projects.count`,
+     * the limit project creation is checked against). Null when unlimited,
+     * unassigned, or billing could not be reached; project creation is not capped
+     * in any of those cases.
+     */
     projectLimit?: Maybe<Scalars['Int']['output']>;
     /** Workspace identifier */
     workspaceId: Scalars['ID']['output'];
@@ -5989,6 +6231,48 @@ export type PlanmagnetRoadmapVersionSummary = {
     note?: Maybe<Scalars['String']['output']>;
     roadmapId: Scalars['ID']['output'];
 };
+/**
+ * CSAT: a 1-5 answer, 4-5 counted as satisfied. NPS: a 0-10 answer, 9-10 promoters, 7-8 passives, 0-6 detractors.
+ * TEXT-backed in Prisma; this enum (and the service) is the only validator.
+ */
+export declare enum PlanmagnetSatisfactionMetricType {
+    Csat = "CSAT",
+    Nps = "NPS"
+}
+/**
+ * Where a response came from: MANUAL (entered one at a time by a team member) or IMPORT (a batch from a file). Set by
+ * the mutation used — never by the caller.
+ */
+export declare enum PlanmagnetSatisfactionResponseSource {
+    Import = "IMPORT",
+    Manual = "MANUAL"
+}
+export type PlanmagnetSatisfactionWindow = {
+    __typename?: 'PlanmagnetSatisfactionWindow';
+    /** The start of the first UTC day counted. */
+    from: Scalars['DateTime']['output'];
+    preset: PlanmagnetSatisfactionWindowPreset;
+    /** The end (23:59:59.999) of the last UTC day counted. */
+    to: Scalars['DateTime']['output'];
+};
+/** The window a figure covers. Responses count when their respondedAt is in [from, to], both ends included. */
+export type PlanmagnetSatisfactionWindowInput = {
+    /** CUSTOM only (required there). Any other preset with from/to is BAD_USER_INPUT. */
+    from?: InputMaybe<Scalars['DateTime']['input']>;
+    /** Defaults to LAST_90_DAYS. */
+    preset?: InputMaybe<PlanmagnetSatisfactionWindowPreset>;
+    /** CUSTOM only (required there). Not before `from`. */
+    to?: InputMaybe<Scalars['DateTime']['input']>;
+};
+/** A satisfaction window: the N UTC calendar days ending today (today included), or CUSTOM. */
+export declare enum PlanmagnetSatisfactionWindowPreset {
+    /** From the start of `from`'s UTC day to the end of `to`'s — both required. */
+    Custom = "CUSTOM",
+    Last_30Days = "LAST_30_DAYS",
+    Last_90Days = "LAST_90_DAYS",
+    Last_180Days = "LAST_180_DAYS",
+    Last_365Days = "LAST_365_DAYS"
+}
 export type PlanmagnetSaveRoadmapVersionInput = {
     /** At most 120 characters */
     name: Scalars['String']['input'];
@@ -6032,6 +6316,108 @@ export type PlanmagnetSharedReport = {
     /** FORBIDDEN widgets stay FORBIDDEN — exactly as the run recorded them; this endpoint grants no new access. */
     widgets: Array<PlanmagnetWidgetRunResult>;
 };
+/** One skill's coverage in the requested scope. */
+export type PlanmagnetSkillCoverage = {
+    __typename?: 'PlanmagnetSkillCoverage';
+    /** The part of openDemand that has an assignee — anyone, qualified or not */
+    assignedDemand: PlanmagnetSkillDemand;
+    /** Open work items in scope (not DONE or CANCELLED, not deleted, in a live project) that require the skill */
+    openDemand: PlanmagnetSkillDemand;
+    /** The number of qualifiedMembers */
+    qualifiedMemberCount: Scalars['Int']['output'];
+    /** Qualified members, ordered by name. Empty when status is UNKNOWN */
+    qualifiedMembers: Array<PlanmagnetSkillQualifiedMember>;
+    /**
+     * The skill tag, in the first spelling found — open work items (oldest first) before CrewFoundry. Matching ignores
+     * case and surrounding/repeated whitespace
+     */
+    skill: Scalars['String']['output'];
+    status: PlanmagnetSkillCoverageStatus;
+    /** Qualified members assigned none of this skill's open demand in scope (assignedDemandCount = 0) */
+    unassignedQualifiedCount: Scalars['Int']['output'];
+};
+/**
+ * Narrows planmagnetSkillCoverage. Every field is optional; the ones given are AND-ed together. A given id must be a
+ * live project / team / sprint of this workspace (NOT_FOUND otherwise).
+ */
+export type PlanmagnetSkillCoverageFilter = {
+    /** Only open work items of this project */
+    projectId?: InputMaybe<Scalars['ID']['input']>;
+    /** Only open work items in this sprint */
+    sprintId?: InputMaybe<Scalars['ID']['input']>;
+    /**
+     * Only open work items of this team's live projects — and only this team's live members (who are active workspace
+     * members) count as qualified. Without a team, every active workspace member counts
+     */
+    teamId?: InputMaybe<Scalars['ID']['input']>;
+};
+/**
+ * Skill coverage for a workspace, optionally narrowed (ANR-07 skill view, ANR-28 skill utilization). Utilization is
+ * counts and story points only — hours-based skill utilization is NOT computed until CrewFoundry has a per-person
+ * capacity baseline (CWF-28).
+ */
+export type PlanmagnetSkillCoverageResult = {
+    __typename?: 'PlanmagnetSkillCoverageResult';
+    /**
+     * True when the CrewFoundry roster could not be read in full (unreachable, or failing part-way through paging).
+     * Qualified members are then not counted and every skill with open demand is UNKNOWN. An empty roster is NOT
+     * unavailable
+     */
+    crewfoundryUnavailable: Scalars['Boolean']['output'];
+    /**
+     * True when the workspace member directory (or the members' e-mail identities) could not be read in full. Qualified
+     * members are then not counted and every skill with open demand is UNKNOWN
+     */
+    membersUnavailable: Scalars['Boolean']['output'];
+    /**
+     * One row per skill that open work in scope requires or a qualified member has: UNCOVERED first, then UNKNOWN,
+     * COVERED and NO_DEMAND; within each, most open work items first, then by skill
+     */
+    skills: Array<PlanmagnetSkillCoverage>;
+    /**
+     * True when more than 5,000 open work items in scope require a skill: the demand figures then cover the 5,000
+     * oldest only
+     */
+    truncated: Scalars['Boolean']['output'];
+};
+/** How well a skill's open demand is covered by qualified members. */
+export declare enum PlanmagnetSkillCoverageStatus {
+    /** Open work in scope requires the skill and at least one qualified member exists */
+    Covered = "COVERED",
+    /** No open work in scope requires the skill — it is listed because a qualified member has it */
+    NoDemand = "NO_DEMAND",
+    /** Open work in scope requires the skill and no qualified member exists */
+    Uncovered = "UNCOVERED",
+    /**
+     * Open work in scope requires the skill, but qualified members could not be counted: CrewFoundry or the workspace
+     * member directory could not be read (see crewfoundryUnavailable / membersUnavailable). Never reported as UNCOVERED
+     */
+    Unknown = "UNKNOWN"
+}
+/**
+ * Open work items requiring a skill: how many, and the sum of their story points (an item with no estimate counts as
+ * 0 — the same rule as planmagnetWorkItemCounts and the sprint analytics).
+ */
+export type PlanmagnetSkillDemand = {
+    __typename?: 'PlanmagnetSkillDemand';
+    storyPoints: Scalars['Int']['output'];
+    workItemCount: Scalars['Int']['output'];
+};
+/**
+ * A workspace member whose matched, ACTIVE CrewFoundry employee record lists the skill. The member is matched the
+ * same way sprint capacity matches an assignee: the CWF-30 identity override first, else the workspace e-mail.
+ */
+export type PlanmagnetSkillQualifiedMember = {
+    __typename?: 'PlanmagnetSkillQualifiedMember';
+    /** Platform actor id (the same value as WorkItem.assigneeId) */
+    actorId: Scalars['String']['output'];
+    /** Open work items in scope that require this skill and are assigned to this member */
+    assignedDemandCount: Scalars['Int']['output'];
+    /** The matched CrewFoundry CrewEmployee.id */
+    employeeId: Scalars['ID']['output'];
+    /** The CrewFoundry employee's full name */
+    employeeName: Scalars['String']['output'];
+};
 export declare enum PlanmagnetSortDirection {
     Asc = "ASC",
     Desc = "DESC"
@@ -6053,11 +6439,12 @@ export type PlanmagnetSprintBurndown = {
 export type PlanmagnetSprintCapacity = {
     __typename?: 'PlanmagnetSprintCapacity';
     /**
-     * True when the CrewFoundry roster lookup itself returned nothing — either
-     * a live lookup failure (service unreachable/timeout) or a workspace with no
-     * CrewFoundry data. `members`/`unmatchedAssigneeIds` cannot distinguish the
-     * two cases from PlanMagnet's side; this flag exists so callers can render
-     * "capacity data unavailable" instead of silently showing an empty list.
+     * True when the CrewFoundry roster could not be read in full — the service
+     * unreachable or timing out, or failing part-way through paging the roster.
+     * Callers render "capacity data unavailable" instead of an empty list. A
+     * workspace whose CrewFoundry roster is readable but EMPTY is NOT unavailable:
+     * its assignees are listed in `unmatchedAssigneeIds`, like any other assignee
+     * with no matching CrewFoundry employee.
      */
     crewfoundryUnavailable: Scalars['Boolean']['output'];
     /**
@@ -6113,6 +6500,12 @@ export type PlanmagnetSprintCapacityMember = {
     employeeName: Scalars['String']['output'];
     /** CrewFoundry position/title */
     position: Scalars['String']['output'];
+    /**
+     * The employee's skill tags as CrewFoundry records them (tidied: trimmed, whitespace collapsed, case-insensitive
+     * duplicates dropped). Read-only — CrewFoundry is canonical for person skills and PlanMagnet never writes them;
+     * edit them in CrewFoundry. Empty when CrewFoundry lists none.
+     */
+    skills: Array<Scalars['String']['output']>;
     /**
      * `billableHours / allocatedHours * 100`, rounded to 1 decimal place. Null
      * when `allocatedHours` is 0 (nothing to divide by).
@@ -6685,6 +7078,34 @@ export type PlanmagnetUpdateCustomFieldDefinitionInput = {
     sortOrder?: InputMaybe<Scalars['Int']['input']>;
     validationRules?: InputMaybe<Scalars['JSON']['input']>;
 };
+/**
+ * `source` and `externalId` are absent: they identify where the answer came from and never change. An omitted field
+ * keeps its value. A new metricType is checked against the stored score (and a new score against the stored type).
+ * Sending any of productId/releaseId/projectId re-checks the whole resulting link set (null clears a link; one must
+ * remain). isAnonymous true clears any stored respondent identity.
+ */
+export type PlanmagnetUpdateCustomerSatisfactionResponseInput = {
+    /** Null clears it. */
+    comment?: InputMaybe<Scalars['String']['input']>;
+    /** Cannot be cleared. */
+    isAnonymous?: InputMaybe<Scalars['Boolean']['input']>;
+    /** Cannot be cleared. */
+    metricType?: InputMaybe<PlanmagnetSatisfactionMetricType>;
+    /** Null clears it. */
+    productId?: InputMaybe<Scalars['ID']['input']>;
+    /** Null clears it. */
+    projectId?: InputMaybe<Scalars['ID']['input']>;
+    /** Null clears it. */
+    releaseId?: InputMaybe<Scalars['ID']['input']>;
+    /** Cannot be cleared. */
+    respondedAt?: InputMaybe<Scalars['DateTime']['input']>;
+    /** Null clears it. */
+    respondentEmail?: InputMaybe<Scalars['String']['input']>;
+    /** Null clears it. */
+    respondentName?: InputMaybe<Scalars['String']['input']>;
+    /** Cannot be cleared. */
+    score?: InputMaybe<Scalars['Int']['input']>;
+};
 export type PlanmagnetUpdateDependencyInput = {
     description?: InputMaybe<Scalars['String']['input']>;
     lagMinutes?: InputMaybe<Scalars['Int']['input']>;
@@ -7073,6 +7494,8 @@ export type PlanmagnetUpdateWorkItemInput = {
     parentId?: InputMaybe<Scalars['String']['input']>;
     priority?: InputMaybe<WorkItemPriority>;
     reporterId?: InputMaybe<Scalars['String']['input']>;
+    /** Replaces the item's required skills (same rules as on create); null or [] clears them, leaving it out keeps them */
+    requiredSkills?: InputMaybe<Array<Scalars['String']['input']>>;
     sortOrder?: InputMaybe<Scalars['Int']['input']>;
     sprintId?: InputMaybe<Scalars['String']['input']>;
     status?: InputMaybe<WorkItemStatus>;
@@ -8074,6 +8497,15 @@ export type Query = {
     planmagnetCustomFieldDefinitions: PlanmagnetCustomFieldDefinitionList;
     /** List custom field values */
     planmagnetCustomFieldValues: PlanmagnetCustomFieldValueList;
+    /**
+     * CSAT and NPS for the workspace, or one product/release/project (see PlanmagnetCustomerSatisfactionFilter), over a
+     * window — default the trailing 90 days. Computed in the database from live responses only.
+     */
+    planmagnetCustomerSatisfaction: PlanmagnetCustomerSatisfaction;
+    /** Null when it does not exist in this workspace or was deleted. */
+    planmagnetCustomerSatisfactionResponse?: Maybe<PlanmagnetCustomerSatisfactionResponse>;
+    /** Live responses, newest answer first. Same filter rules as planmagnetCustomerSatisfaction. */
+    planmagnetCustomerSatisfactionResponses: PlanmagnetCustomerSatisfactionResponseList;
     /**
      * Cycle-time distribution for a project's work items that reached DONE
      * within a date range (defaults to the trailing 90 days).
@@ -8160,7 +8592,10 @@ export type Query = {
      * project/sprint-scoped and feed planmagnetAnalytics.projectMetrics instead — see PlanmagnetAnalytics). Backed
      * by planmagnetDeliveryKpis, the one query in this module already scoped to the whole workspace. `category`
      * narrows to one named metric (sprintOnTimeRate | releaseOnTimeRate | milestoneOnTimeRate |
-     * scopeAdherenceRate); omitted, every metric with a real (non-null-denominator) value is returned.
+     * scopeAdherenceRate); omitted, every metric with a real (non-null-denominator) value is returned. Customer
+     * satisfaction is deliberately not a row here: a CSAT/NPS figure is always shown with its response count and
+     * window (owner decision 2026-10-02), which a PlanmagnetMetric row cannot carry — read
+     * planmagnetDeliveryKpis.customerSatisfaction or planmagnetCustomerSatisfaction instead.
      */
     planmagnetMetrics: Array<PlanmagnetMetric>;
     /** Get a single milestone by ID */
@@ -8352,6 +8787,12 @@ export type Query = {
      * nothing a possessor of a valid-looking token could not already infer.
      */
     planmagnetSharedReport?: Maybe<PlanmagnetSharedReport>;
+    /**
+     * Skill coverage (ANR-07, ANR-28): per skill, the open work requiring it, how much of that is assigned, and which
+     * active workspace members are qualified by their CrewFoundry skills (read-only — PlanMagnet never writes
+     * CrewFoundry). Hours-based skill utilization is not computed until CWF-28 adds a per-person capacity baseline.
+     */
+    planmagnetSkillCoverage: PlanmagnetSkillCoverageResult;
     /** Get a single sprint by ID */
     planmagnetSprint?: Maybe<Sprint>;
     /**
@@ -8564,6 +9005,18 @@ export type QueryPlanmagnetCustomFieldValuesArgs = {
     pagination?: InputMaybe<PlanmagnetPaginationInput>;
     workspaceId: Scalars['ID']['input'];
 };
+export type QueryPlanmagnetCustomerSatisfactionArgs = {
+    filter?: InputMaybe<PlanmagnetCustomerSatisfactionFilter>;
+    workspaceId: Scalars['ID']['input'];
+};
+export type QueryPlanmagnetCustomerSatisfactionResponseArgs = {
+    id: Scalars['ID']['input'];
+};
+export type QueryPlanmagnetCustomerSatisfactionResponsesArgs = {
+    filter?: InputMaybe<PlanmagnetCustomerSatisfactionResponseFilter>;
+    pagination?: InputMaybe<PlanmagnetPaginationInput>;
+    workspaceId: Scalars['ID']['input'];
+};
 export type QueryPlanmagnetCycleTimeArgs = {
     endDate?: InputMaybe<Scalars['DateTime']['input']>;
     projectId: Scalars['ID']['input'];
@@ -8887,6 +9340,10 @@ export type QueryPlanmagnetSharedReportArgs = {
     password?: InputMaybe<Scalars['String']['input']>;
     token: Scalars['String']['input'];
 };
+export type QueryPlanmagnetSkillCoverageArgs = {
+    filter?: InputMaybe<PlanmagnetSkillCoverageFilter>;
+    workspaceId: Scalars['ID']['input'];
+};
 export type QueryPlanmagnetSprintArgs = {
     id: Scalars['ID']['input'];
 };
@@ -9627,6 +10084,12 @@ export type UniversalTag = {
  */
 export type WorkItem = {
     __typename?: 'WorkItem';
+    /**
+     * For an EPIC: the union of its own requiredSkills and those of its live (not deleted) direct children, in that
+     * order, case-insensitive duplicates dropped keeping the first spelling. Computed on every read and never copied onto
+     * the epic, so it cannot drift from the children. For every other type: exactly requiredSkills. Read-only.
+     */
+    aggregatedRequiredSkills: Array<Scalars['String']['output']>;
     /** Assigned actor ID */
     assigneeId?: Maybe<Scalars['String']['output']>;
     /** Children work items */
@@ -9703,6 +10166,13 @@ export type WorkItem = {
     projectId: Scalars['String']['output'];
     /** Reporter actor ID */
     reporterId?: Maybe<Scalars['String']['output']>;
+    /**
+     * Skills this work item needs (ANR-07, ANR-28, CWF-29) — PlanMagnet's own free-text tags, normalized on every write:
+     * trimmed, inner whitespace collapsed, case-insensitive duplicates dropped keeping the first spelling, at most 20
+     * tags of at most 64 characters each. Matched case-insensitively against CrewFoundry person skills, which PlanMagnet
+     * only reads (see planmagnetSkillCoverage). Empty when none are set.
+     */
+    requiredSkills: Array<Scalars['String']['output']>;
     /** Sort order within lists */
     sortOrder: Scalars['Int']['output'];
     /** Sprint reference */