@burdenoff/microfe-planmagnet 2026.923.5 → 2026.924.2

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

@@ -285,14 +285,27 @@ export declare enum DependencyStatus {
     Removed = "REMOVED",
     Resolved = "RESOLVED"
 }
+/**
+ * How one work item constrains the SCHEDULE of another.
+ *
+ * These four are the standard CPM relationships; `lagMinutes` offsets them. This
+ * enum used to carry issue-link verbs (BLOCKS, DUPLICATES, RELATES_TO, ...) while
+ * the database carried these four — one name, ZERO overlapping values — so every
+ * `planmagnetCreateDependency` passed gateway validation and then failed the
+ * write. The semantic verbs now live on `WorkItemLink.relationType`, which is
+ * where they belong: "A relates to B" says nothing about when either one starts.
+ *
+ * Only these relationships take part in critical-path analysis.
+ */
 export declare enum DependencyType {
-    BlockedBy = "BLOCKED_BY",
-    Blocks = "BLOCKS",
-    CausedBy = "CAUSED_BY",
-    Causes = "CAUSES",
-    DuplicatedBy = "DUPLICATED_BY",
-    Duplicates = "DUPLICATES",
-    RelatesTo = "RELATES_TO"
+    /** The successor finishes after the predecessor finishes. */
+    FinishToFinish = "FINISH_TO_FINISH",
+    /** The successor starts after the predecessor finishes. The usual case. */
+    FinishToStart = "FINISH_TO_START",
+    /** The successor finishes after the predecessor starts. Rare. */
+    StartToFinish = "START_TO_FINISH",
+    /** The successor starts after the predecessor starts. */
+    StartToStart = "START_TO_START"
 }
 export declare enum DocStatus {
     Archived = "ARCHIVED",
@@ -527,10 +540,14 @@ export type Mutation = {
     _planmagnetPing?: Maybe<Scalars['String']['output']>;
     /** Add work items to a sprint */
     planmagnetAddWorkItemsToSprint: Sprint;
+    /**
+     * Grant a user billable editor access to a PlanMagnet workspace. Rejected
+     * once the workspace is at its plan's editor limit (Free tier: 10).
+     * Idempotent: granting an already-active editor returns the existing seat.
+     */
+    planmagnetAddWorkspaceEditor: PlanmagnetWorkspaceEditor;
     /** Apply a template to create a new project */
     planmagnetApplyTemplate: PlanmagnetProject;
-    /** Approve an adapter submission. */
-    planmagnetApproveAdapter: PlanmagnetAdapterSubmission;
     /** Approve a budget */
     planmagnetApproveBudget: PlanmagnetBudget;
     /** Approve a submitted timesheet */
@@ -557,17 +574,14 @@ export type Mutation = {
     planmagnetCreateCustomFieldDefinition: CustomFieldDefinition;
     /** Create a new dependency between work items */
     planmagnetCreateDependency: WorkItemDependency;
-    /** Create a new doc */
     planmagnetCreateDoc: PlanmagnetDoc;
     /** Create a new external sync configuration */
     planmagnetCreateExternalSync: ExternalSync;
     /** Create a new feature request */
     planmagnetCreateFeatureRequest: FeatureRequest;
-    /** Create a new key result */
     planmagnetCreateKeyResult: PlanmagnetKeyResult;
     /** Create a new milestone */
     planmagnetCreateMilestone: Milestone;
-    /** Create a new objective */
     planmagnetCreateObjective: PlanmagnetObjective;
     /** Create a new portfolio */
     planmagnetCreatePortfolio: Portfolio;
@@ -611,7 +625,6 @@ export type Mutation = {
     planmagnetDeleteCustomFieldDefinition: Scalars['Boolean']['output'];
     /** Remove a dependency */
     planmagnetDeleteDependency: Scalars['Boolean']['output'];
-    /** Delete a doc */
     planmagnetDeleteDoc: Scalars['Boolean']['output'];
     /** Delete an expense */
     planmagnetDeleteExpense: Scalars['Boolean']['output'];
@@ -619,7 +632,10 @@ export type Mutation = {
     planmagnetDeleteExternalSync: Scalars['Boolean']['output'];
     /** Delete a feature request */
     planmagnetDeleteFeatureRequest: Scalars['Boolean']['output'];
-    /** Only the key result's owner, its objective's owner, or its creator may delete it. */
+    /**
+     * Only the key result's owner, its objective's owner, or its creator may
+     * delete it.
+     */
     planmagnetDeleteKeyResult: Scalars['Boolean']['output'];
     /** Delete a milestone */
     planmagnetDeleteMilestone: Scalars['Boolean']['output'];
@@ -650,36 +666,53 @@ export type Mutation = {
     /** Soft-delete a work item */
     planmagnetDeleteWorkItem: Scalars['Boolean']['output'];
     /**
-     * Manually request execution of an automation rule.
+     * Manually run an automation rule (BOFF-4445) against a specific work item.
      *
-     * NOT YET IMPLEMENTED: PlanMagnet has no automation execution engine. This
-     * mutation records an execution attempt with status FAILURE and an
-     * `errorMessage` of `NOT_IMPLEMENTED: ...`; it evaluates no `conditions`,
-     * dispatches no `actions`, and does not advance the rule's `executionCount` or
-     * `lastExecutedAt`.
+     * `triggerData` MUST include `workItemId` — every supported action type
+     * (`ASSIGN_TO_USER`/`ADD_LABEL`/`SET_STATUS`/`SET_PRIORITY`) mutates a
+     * specific WorkItem, and a manual run with no target records a FAILURE
+     * execution explaining that instead of evaluating anything. When a WorkItem is
+     * given, the rule's `conditions` are evaluated against a live snapshot of that
+     * item (merged with any extra fields in `triggerData`) and, if they pass, its
+     * `actions` are dispatched for real — this always records an
+     * `AutomationExecution` row, including a non-matching run.
      *
-     * Because it performs no billable work it deliberately carries NO `@usage`
-     * directive — it previously declared
-     * `@usage(quotaName: "planmagnet.automation.runs_monthly", checkQuota: true, trackUsage: true)`
-     * and so consumed a customer's metered monthly automation runs for a no-op.
-     * Restore the `@usage` directive in the same change that lands a real
-     * evaluation + dispatch engine, not before.
+     * Carries `@usage` again as of BOFF-4445: PlanMagnet now has a real evaluation
+     * + dispatch engine (see `automation-engine.ts`), so a manual run is real
+     * billable work.
      */
     planmagnetExecuteAutomationRule: PlanmagnetAutomationExecution;
-    /** Export items to external tool */
+    /**
+     * Export items to the external tool. Real for `provider: GITHUB` (BOFF-4446):
+     * creates/updates real GitHub Issues for the given `internalIds` (WorkItem
+     * ids), or one bounded page of every WorkItem in the sync's project when
+     * omitted. Every other provider records an honest `NOT_IMPLEMENTED` outcome.
+     */
     planmagnetExportToExternal: PlanmagnetSyncResult;
+    /**
+     * Generate release notes from the closed work items linked to a release
+     * (by `workItemIds`, falling back to the release's `projectIds`).
+     * Persists the generated markdown on `Release.releaseNotes` so it remains
+     * editable via `planmagnetUpdateRelease`. When `persist` is false the notes
+     * are computed and returned without writing to the database.
+     */
+    planmagnetGenerateReleaseNotes: PlanmagnetGenerateReleaseNotesPayload;
     /**
      * 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.
      */
     planmagnetImportExternalIssues: PlanmagnetImportResult;
-    /** Import items from external tool */
+    /**
+     * Import items from the external tool. Real for `provider: GITHUB`
+     * (BOFF-4446): fetches real GitHub Issues (specific `externalIds`, i.e. issue
+     * numbers, or one bounded page of all issues) and creates/updates the
+     * matching PlanMagnet WorkItems. Every other provider records an honest
+     * `NOT_IMPLEMENTED` outcome.
+     */
     planmagnetImportFromExternal: PlanmagnetSyncResult;
     /** Link a competitor to a feature request */
     planmagnetLinkCompetitorToFeature: FeatureRequest;
-    /** Link a doc to a work item */
     planmagnetLinkDocToWorkItem: PlanmagnetDoc;
-    /** Link a key result to a work item (informational rollup only) */
     planmagnetLinkKeyResultToWorkItem: PlanmagnetKeyResult;
     /** Link a work item to an external product entity */
     planmagnetLinkWorkItem: WorkItemLink;
@@ -687,16 +720,12 @@ export type Mutation = {
     planmagnetLogExpense: BudgetExpense;
     /** Quick log time against a work item */
     planmagnetLogTime: PlanmagnetTimeEntry;
-    /** Moderate a reported marketplace listing. */
-    planmagnetModerateListing: PlanmagnetMarketplaceReport;
     /** Move a card (work item) to a different column and/or position */
     planmagnetMoveCard: Board;
     /** Move a work item to a different status, sprint, or position */
     planmagnetMoveWorkItem: WorkItem;
     /** Pause a sync */
     planmagnetPauseExternalSync: ExternalSync;
-    /** Reject an adapter submission. */
-    planmagnetRejectAdapter: PlanmagnetAdapterSubmission;
     /** Reject a submitted timesheet */
     planmagnetRejectTimesheet: PlanmagnetTimesheet;
     /** Remove a custom field value from a work item */
@@ -705,6 +734,11 @@ export type Mutation = {
     planmagnetRemoveFeatureVote: Scalars['Boolean']['output'];
     /** Remove work items from a sprint */
     planmagnetRemoveWorkItemsFromSprint: Sprint;
+    /**
+     * Revoke a user's editor access to a PlanMagnet workspace, freeing the slot.
+     * Idempotent: revoking a user who is not currently an editor returns false.
+     */
+    planmagnetRemoveWorkspaceEditor: Scalars['Boolean']['output'];
     /** Reorder columns on a board */
     planmagnetReorderColumns: Board;
     /** Resume a paused sync */
@@ -720,17 +754,27 @@ export type Mutation = {
     planmagnetSetCustomFieldValue: CustomFieldValue;
     /** Start a sprint (transition to ACTIVE) */
     planmagnetStartSprint: Sprint;
-    /** Start a sync operation */
+    /**
+     * Start a sync operation in the direction `ExternalSync.direction` already
+     * records. Real for `provider: GITHUB` (BOFF-4446) — pulls/pushes real GitHub
+     * Issues, bounded to one REST page each way. Every other provider records an
+     * honest `NOT_IMPLEMENTED` outcome instead of a fabricated success.
+     */
     planmagnetStartSync: PlanmagnetSyncResult;
     /** Submit a timesheet for approval */
     planmagnetSubmitTimesheet: PlanmagnetTimesheet;
+    /**
+     * Calls the configured LLM provider to suggest a work-item breakdown for a
+     * plain-text description. Fails clearly (GraphQL error) when no provider key
+     * is configured or the model response can't be parsed — never returns
+     * fabricated suggestions.
+     */
+    planmagnetSuggestWorkItemBreakdown: PlanmagnetWorkItemBreakdownResult;
     /** Toggle an automation rule (activate/pause) */
     planmagnetToggleAutomationRule: PlanmagnetAutomationRule;
     /** Unlink a competitor from a feature request */
     planmagnetUnlinkCompetitorFromFeature: FeatureRequest;
-    /** Unlink a doc from a work item */
     planmagnetUnlinkDocFromWorkItem: Scalars['Boolean']['output'];
-    /** Unlink a key result from a work item */
     planmagnetUnlinkKeyResultFromWorkItem: Scalars['Boolean']['output'];
     /** Remove a work item link */
     planmagnetUnlinkWorkItem: Scalars['Boolean']['output'];
@@ -748,10 +792,6 @@ export type Mutation = {
     planmagnetUpdateCustomFieldDefinition: CustomFieldDefinition;
     /** Update an existing dependency */
     planmagnetUpdateDependency: WorkItemDependency;
-    /**
-     * Update a doc (creates a new version + revision); title/content/status are
-     * independently optional.
-     */
     planmagnetUpdateDoc: PlanmagnetDoc;
     /** Update an expense */
     planmagnetUpdateExpense: BudgetExpense;
@@ -760,9 +800,10 @@ export type Mutation = {
     /** Update an existing feature request */
     planmagnetUpdateFeatureRequest: FeatureRequest;
     /**
-     * Progress is updated manually here via `currentValue` -- see module deferral note
-     * re: automated roll-up from linked work item completion. Only the key result's
-     * owner, its objective's owner, or its creator may update it.
+     * Progress is updated manually here via `currentValue` -- see module
+     * deferral note re: automated roll-up from linked work item completion.
+     * Only the key result's owner, its objective's owner, or its creator may
+     * update it.
      */
     planmagnetUpdateKeyResult: PlanmagnetKeyResult;
     /** Update an existing milestone */
@@ -802,13 +843,13 @@ export type MutationPlanmagnetAddWorkItemsToSprintArgs = {
     id: Scalars['ID']['input'];
     input: PlanmagnetSprintWorkItemsInput;
 };
+export type MutationPlanmagnetAddWorkspaceEditorArgs = {
+    userId: Scalars['ID']['input'];
+    workspaceId: Scalars['ID']['input'];
+};
 export type MutationPlanmagnetApplyTemplateArgs = {
     input: PlanmagnetApplyTemplateInput;
 };
-export type MutationPlanmagnetApproveAdapterArgs = {
-    id: Scalars['ID']['input'];
-    notes?: InputMaybe<Scalars['String']['input']>;
-};
 export type MutationPlanmagnetApproveBudgetArgs = {
     id: Scalars['ID']['input'];
 };
@@ -996,6 +1037,10 @@ export type MutationPlanmagnetExecuteAutomationRuleArgs = {
 export type MutationPlanmagnetExportToExternalArgs = {
     input: PlanmagnetExportToExternalInput;
 };
+export type MutationPlanmagnetGenerateReleaseNotesArgs = {
+    id: Scalars['ID']['input'];
+    persist?: InputMaybe<Scalars['Boolean']['input']>;
+};
 export type MutationPlanmagnetImportExternalIssuesArgs = {
     input: PlanmagnetImportExternalIssuesInput;
 };
@@ -1022,11 +1067,6 @@ export type MutationPlanmagnetLogExpenseArgs = {
 export type MutationPlanmagnetLogTimeArgs = {
     input: PlanmagnetLogTimeInput;
 };
-export type MutationPlanmagnetModerateListingArgs = {
-    action: PlanmagnetModerationAction;
-    id: Scalars['ID']['input'];
-    reason: Scalars['String']['input'];
-};
 export type MutationPlanmagnetMoveCardArgs = {
     boardId: Scalars['ID']['input'];
     input: PlanmagnetMoveCardInput;
@@ -1038,10 +1078,6 @@ export type MutationPlanmagnetMoveWorkItemArgs = {
 export type MutationPlanmagnetPauseExternalSyncArgs = {
     id: Scalars['ID']['input'];
 };
-export type MutationPlanmagnetRejectAdapterArgs = {
-    id: Scalars['ID']['input'];
-    reason: Scalars['String']['input'];
-};
 export type MutationPlanmagnetRejectTimesheetArgs = {
     id: Scalars['ID']['input'];
     reason?: InputMaybe<Scalars['String']['input']>;
@@ -1057,6 +1093,10 @@ export type MutationPlanmagnetRemoveWorkItemsFromSprintArgs = {
     id: Scalars['ID']['input'];
     input: PlanmagnetSprintWorkItemsInput;
 };
+export type MutationPlanmagnetRemoveWorkspaceEditorArgs = {
+    userId: Scalars['ID']['input'];
+    workspaceId: Scalars['ID']['input'];
+};
 export type MutationPlanmagnetReorderColumnsArgs = {
     boardId: Scalars['ID']['input'];
     input: PlanmagnetReorderColumnsInput;
@@ -1084,6 +1124,9 @@ export type MutationPlanmagnetStartSyncArgs = {
 export type MutationPlanmagnetSubmitTimesheetArgs = {
     id: Scalars['ID']['input'];
 };
+export type MutationPlanmagnetSuggestWorkItemBreakdownArgs = {
+    input: PlanmagnetSuggestWorkItemBreakdownInput;
+};
 export type MutationPlanmagnetToggleAutomationRuleArgs = {
     id: Scalars['ID']['input'];
     status: PlanmagnetAutomationStatus;
@@ -1220,31 +1263,6 @@ export declare enum ObjectiveStatus {
     Completed = "COMPLETED",
     Draft = "DRAFT"
 }
-/** A submitted adapter awaiting admin approval. */
-export type PlanmagnetAdapterSubmission = {
-    __typename?: 'PlanmagnetAdapterSubmission';
-    /** Adapter identifier */
-    adapterId: Scalars['String']['output'];
-    /** Creation timestamp */
-    createdAt: Scalars['DateTime']['output'];
-    /** Unique identifier */
-    id: Scalars['ID']['output'];
-    /** Admin notes */
-    notes?: Maybe<Scalars['String']['output']>;
-    /** Current review status */
-    status: PlanmagnetSubmissionStatus;
-    /** Workspace that submitted the adapter */
-    submitterWorkspaceId: Scalars['String']['output'];
-    /** Last update timestamp */
-    updatedAt: Scalars['DateTime']['output'];
-};
-/** Paginated list of adapter submissions. */
-export type PlanmagnetAdapterSubmissionConnection = {
-    __typename?: 'PlanmagnetAdapterSubmissionConnection';
-    items: Array<PlanmagnetAdapterSubmission>;
-    pageInfo: PlanmagnetPageInfo;
-    totalCount: Scalars['Int']['output'];
-};
 export type PlanmagnetApplyTemplateInput = {
     ownerId: Scalars['String']['input'];
     projectDescription?: InputMaybe<Scalars['String']['input']>;
@@ -1290,10 +1308,21 @@ export type PlanmagnetAutomationExecutionList = {
     pageInfo: PlanmagnetPageInfo;
     totalCount: Scalars['Int']['output'];
 };
+/**
+ * The outcome of one automation run.
+ *
+ * PARTIAL_FAILURE exists because a run that dispatched some actions and could not
+ * dispatch others is neither a success nor a plain failure, and an operator needs
+ * to tell those apart. Before the status column existed the backing store was a
+ * single boolean, so this distinction could not be represented at all.
+ */
 export declare enum PlanmagnetAutomationExecutionStatus {
     Failure = "FAILURE",
+    /** Some actions ran, others failed or could not be dispatched. */
+    PartialFailure = "PARTIAL_FAILURE",
     Pending = "PENDING",
     Running = "RUNNING",
+    /** Nothing ran — no action the rule declared is supported by this engine. */
     Skipped = "SKIPPED",
     Success = "SUCCESS"
 }
@@ -1316,9 +1345,11 @@ export type PlanmagnetAutomationRule = {
     /** Rule description */
     description?: Maybe<Scalars['String']['output']>;
     /**
-     * Number of times this rule's actions have actually been dispatched.
-     * Manual `planmagnetExecuteAutomationRule` calls do NOT increment this while
-     * the execution engine is unimplemented — see that mutation's description.
+     * Number of times this rule's actions have actually been dispatched — bumped
+     * by the real engine (BOFF-4445) on a matched run, whether triggered
+     * automatically (WORK_ITEM_CREATED/STATUS_CHANGED) or manually via
+     * `planmagnetExecuteAutomationRule`. A manual run whose conditions did not
+     * match does NOT increment this — see that mutation's description.
      */
     executionCount: Scalars['Int']['output'];
     /** Unique identifier */
@@ -1509,9 +1540,9 @@ export type PlanmagnetBulkUpdateWorkItemsInput = {
  */
 export type PlanmagnetBurndownPoint = {
     __typename?: 'PlanmagnetBurndownPoint';
-    /** Story points DONE as of end of this day. */
-    completedCount: Scalars['Int']['output'];
     /** Work item count DONE as of end of this day. */
+    completedCount: Scalars['Int']['output'];
+    /** Story points DONE as of end of this day. */
     completedPoints: Scalars['Int']['output'];
     /** Calendar day (UTC midnight) this reading is as-of. */
     date: Scalars['DateTime']['output'];
@@ -1599,9 +1630,10 @@ export type PlanmagnetCreateCustomFieldDefinitionInput = {
 };
 export type PlanmagnetCreateDependencyInput = {
     description?: InputMaybe<Scalars['String']['input']>;
+    lagMinutes?: InputMaybe<Scalars['Int']['input']>;
     metadata?: InputMaybe<Scalars['JSON']['input']>;
-    sourceWorkItemId: Scalars['String']['input'];
-    targetWorkItemId: Scalars['String']['input'];
+    predecessorId: Scalars['String']['input'];
+    successorId: Scalars['String']['input'];
     type: DependencyType;
 };
 export type PlanmagnetCreateDocInput = {
@@ -1637,6 +1669,7 @@ export type PlanmagnetCreateKeyResultInput = {
     metricType?: InputMaybe<KeyResultMetricType>;
     objectiveId: Scalars['String']['input'];
     ownerId?: InputMaybe<Scalars['String']['input']>;
+    startValue?: InputMaybe<Scalars['Float']['input']>;
     status?: InputMaybe<KeyResultStatus>;
     targetValue: Scalars['Float']['input'];
     title: Scalars['String']['input'];
@@ -1786,6 +1819,11 @@ export type PlanmagnetCreateSprintInput = {
     metadata?: InputMaybe<Scalars['JSON']['input']>;
     name: Scalars['String']['input'];
     projectId: Scalars['String']['input'];
+    /**
+     * Accepted for API compatibility but not honored: sort position is always
+     * the auto-assigned, per-project-unique `sequenceNumber` — see
+     * sprint.service.ts.
+     */
     sortOrder?: InputMaybe<Scalars['Int']['input']>;
     startDate?: InputMaybe<Scalars['DateTime']['input']>;
 };
@@ -1836,6 +1874,28 @@ export type PlanmagnetCreateWorkItemLinkInput = {
     sourceProduct: Scalars['String']['input'];
     workItemId: Scalars['String']['input'];
 };
+/**
+ * Critical path through the dependency graph: the longest chain of
+ * constrained work items, weighted by `lagDays`. Any delay on the nodes
+ * returned in `path` pushes the project end date.
+ */
+export type PlanmagnetCriticalPath = {
+    __typename?: 'PlanmagnetCriticalPath';
+    path: Array<PlanmagnetDependencyNode>;
+    /** Per-node slack in days. Nodes on the critical path have slack 0. */
+    slack: Scalars['JSON']['output'];
+    /**
+     * Length of the critical chain in MINUTES — WORK PLUS LAG.
+     *
+     * This field has been wrong twice, in two different ways. As `totalLagDays` it
+     * summed lag expressed in days; the column rename made it minutes without
+     * renaming the field, so a two-day lag read as 2880 "days". And summing lag at
+     * all was the deeper error: A(5d) → B(3d) with FINISH_TO_START and no lag is an
+     * eight-day chain, and a lag-only total reports ZERO. It now measures what the
+     * name says. No consumer in the repo, MFE, SDK or CLI selects it.
+     */
+    totalDurationMinutes: Scalars['Int']['output'];
+};
 /** Cumulative flow diagram data for a project over a date range. */
 export type PlanmagnetCumulativeFlow = {
     __typename?: 'PlanmagnetCumulativeFlow';
@@ -1868,7 +1928,9 @@ export type PlanmagnetCustomFieldValueList = {
 };
 /**
  * Cycle-time distribution for a project over a date range. Only work items
- * with a recorded transition INTO DONE within the range are counted.
+ * with a recorded transition INTO DONE within the range are counted — an item
+ * that already sat at DONE before status-transition recording began
+ * contributes no sample (see analytics.service.ts).
  */
 export type PlanmagnetCycleTime = {
     __typename?: 'PlanmagnetCycleTime';
@@ -1887,43 +1949,63 @@ export type PlanmagnetCycleTimeItem = {
     title: Scalars['String']['output'];
     workItemId: Scalars['ID']['output'];
 };
+/**
+ * A single chain of dependencies rooted at a starting work item. The chain
+ * is built by following outgoing `BLOCKS` / `BLOCKED_BY` edges until the
+ * graph ends (or a cycle is reached).
+ */
+export type PlanmagnetDependencyChain = {
+    __typename?: 'PlanmagnetDependencyChain';
+    chain: Array<PlanmagnetDependencyNode>;
+    depth: Scalars['Int']['output'];
+    workItemId: Scalars['ID']['output'];
+};
+/**
+ * A detected cycle in the dependency graph. Each cycle is the list of
+ * work-item ids in traversal order.
+ */
+export type PlanmagnetDependencyCycle = {
+    __typename?: 'PlanmagnetDependencyCycle';
+    length: Scalars['Int']['output'];
+    workItemIds: Array<Scalars['ID']['output']>;
+};
 export type PlanmagnetDependencyFilter = {
-    sourceWorkItemId?: InputMaybe<Scalars['String']['input']>;
+    predecessorId?: InputMaybe<Scalars['String']['input']>;
     status?: InputMaybe<DependencyStatus>;
-    targetWorkItemId?: InputMaybe<Scalars['String']['input']>;
+    successorId?: InputMaybe<Scalars['String']['input']>;
     type?: InputMaybe<DependencyType>;
 };
+/**
+ * A node participating in a dependency chain / critical path. Holds the
+ * resolved work-item title and key so the client can render the chain
+ * without a follow-up N+1 query.
+ */
+export type PlanmagnetDependencyNode = {
+    __typename?: 'PlanmagnetDependencyNode';
+    id: Scalars['ID']['output'];
+    key?: Maybe<Scalars['String']['output']>;
+    title?: Maybe<Scalars['String']['output']>;
+};
 /**
  * A workspace-scoped, versioned markdown doc. `title`/`content`/`version`
  * always reflect the latest revision — use `revisions` for full history.
  */
 export type PlanmagnetDoc = {
     __typename?: 'PlanmagnetDoc';
-    /** Latest content */
     content: Scalars['String']['output'];
-    /** Creation timestamp */
     createdAt: Scalars['DateTime']['output'];
-    /** Actor who created this doc */
     createdBy: Scalars['String']['output'];
-    /** Unique identifier */
     id: Scalars['ID']['output'];
     /** Work items this doc is currently linked to. */
     linkedWorkItems: Array<WorkItem>;
-    /** Actor on whose behalf this was created */
     onBehalfOf?: Maybe<Scalars['String']['output']>;
     /** Full version history, including the current version, oldest first. */
     revisions: Array<PlanmagnetDocRevision>;
-    /** Current status */
     status: DocStatus;
-    /** Latest title */
     title: Scalars['String']['output'];
-    /** Last update timestamp */
     updatedAt: Scalars['DateTime']['output'];
-    /** Actor who last updated this doc */
     updatedBy?: Maybe<Scalars['String']['output']>;
-    /** Current version number */
     version: Scalars['Int']['output'];
-    /** Associated workspace ID */
     workspaceId: Scalars['String']['output'];
 };
 export type PlanmagnetDocFilter = {
@@ -1939,21 +2021,13 @@ export type PlanmagnetDocList = {
 /** An immutable snapshot of a PlanmagnetDoc at a given version. */
 export type PlanmagnetDocRevision = {
     __typename?: 'PlanmagnetDocRevision';
-    /** Optional note recorded for this revision */
     changeNote?: Maybe<Scalars['String']['output']>;
-    /** Content at this version */
     content: Scalars['String']['output'];
-    /** Creation timestamp */
     createdAt: Scalars['DateTime']['output'];
-    /** Actor who created this revision */
     createdBy: Scalars['String']['output'];
-    /** Parent doc ID */
     docId: Scalars['String']['output'];
-    /** Unique identifier */
     id: Scalars['ID']['output'];
-    /** Title at this version */
     title: Scalars['String']['output'];
-    /** Version number */
     version: Scalars['Int']['output'];
 };
 export type PlanmagnetExportToExternalInput = {
@@ -1999,6 +2073,18 @@ export type PlanmagnetFeatureRequestList = {
     pageInfo: PlanmagnetPageInfo;
     totalCount: Scalars['Int']['output'];
 };
+/**
+ * Result of `planmagnetGenerateReleaseNotes`: the generated markdown, the
+ * counts the UI needs to render a "X features / Y bug fixes" summary, and the
+ * release row in its post-update state (or pre-update state when `persist`
+ * was false).
+ */
+export type PlanmagnetGenerateReleaseNotesPayload = {
+    __typename?: 'PlanmagnetGenerateReleaseNotesPayload';
+    counts: PlanmagnetReleaseNotesCounts;
+    markdown: Scalars['String']['output'];
+    release: Release;
+};
 /**
  * Import issues exported from an external tool (e.g. Linear) as WorkItems.
  * The caller supplies the exported payload directly (no external API credentials).
@@ -2033,7 +2119,7 @@ export type PlanmagnetImportResult = {
     skipped: Scalars['Int']['output'];
     workItemIds: Array<Scalars['String']['output']>;
 };
-/** A measurable target belonging to exactly one Objective (BOFF-4441). */
+/** A measurable target belonging to exactly one Objective. */
 export type PlanmagnetKeyResult = {
     __typename?: 'PlanmagnetKeyResult';
     createdAt: Scalars['DateTime']['output'];
@@ -2041,7 +2127,10 @@ export type PlanmagnetKeyResult = {
     currentValue: Scalars['Float']['output'];
     description?: Maybe<Scalars['String']['output']>;
     id: Scalars['ID']['output'];
-    /** Live rollup of linked work item completion -- informational only; it does NOT drive `currentValue`. */
+    /**
+     * Live rollup of linked work item completion -- informational only; it does
+     * NOT drive `currentValue` (see module deferral note).
+     */
     linkedWorkItemRollup: PlanmagnetKeyResultRollup;
     /** Work items currently linked to this key result. */
     linkedWorkItems: Array<WorkItem>;
@@ -2089,33 +2178,6 @@ export type PlanmagnetLogTimeInput = {
     projectId: Scalars['String']['input'];
     workItemId: Scalars['String']['input'];
 };
-/** A marketplace listing report awaiting admin moderation. */
-export type PlanmagnetMarketplaceReport = {
-    __typename?: 'PlanmagnetMarketplaceReport';
-    /** Creation timestamp */
-    createdAt: Scalars['DateTime']['output'];
-    /** Unique identifier */
-    id: Scalars['ID']['output'];
-    /** Reported listing identifier */
-    listingId: Scalars['String']['output'];
-    /** Report reason */
-    reason: Scalars['String']['output'];
-    /** Workspace that filed the report */
-    reporterWorkspaceId: Scalars['String']['output'];
-    /** Resolution notes (populated on moderation) */
-    resolution?: Maybe<Scalars['String']['output']>;
-    /** Current moderation status */
-    status: PlanmagnetReportStatus;
-    /** Last update timestamp */
-    updatedAt: Scalars['DateTime']['output'];
-};
-/** Paginated list of marketplace reports. */
-export type PlanmagnetMarketplaceReportConnection = {
-    __typename?: 'PlanmagnetMarketplaceReportConnection';
-    items: Array<PlanmagnetMarketplaceReport>;
-    pageInfo: PlanmagnetPageInfo;
-    totalCount: Scalars['Int']['output'];
-};
 export type PlanmagnetMilestoneFilter = {
     ownerId?: InputMaybe<Scalars['String']['input']>;
     projectId?: InputMaybe<Scalars['String']['input']>;
@@ -2128,12 +2190,6 @@ export type PlanmagnetMilestoneList = {
     pageInfo: PlanmagnetPageInfo;
     totalCount: Scalars['Int']['output'];
 };
-export declare enum PlanmagnetModerationAction {
-    Approve = "APPROVE",
-    Escalate = "ESCALATE",
-    Hide = "HIDE",
-    Reject = "REJECT"
-}
 export type PlanmagnetMoveCardInput = {
     sortOrder?: InputMaybe<Scalars['Int']['input']>;
     targetColumnId: Scalars['ID']['input'];
@@ -2145,9 +2201,8 @@ export type PlanmagnetMoveWorkItemInput = {
     status?: InputMaybe<WorkItemStatus>;
 };
 /**
- * A workspace-scoped goal for a given time period (BOFF-4441). `progress` is
- * the average of its non-deleted KeyResults' progress (0 when it has none),
- * computed live -- never stored.
+ * A workspace-scoped goal for a given time period. `progress` is the average
+ * of its non-deleted KeyResults' progress (0 when it has none).
  */
 export type PlanmagnetObjective = {
     __typename?: 'PlanmagnetObjective';
@@ -2160,7 +2215,10 @@ export type PlanmagnetObjective = {
     onBehalfOf?: Maybe<Scalars['String']['output']>;
     ownerId: Scalars['String']['output'];
     periodLabel: Scalars['String']['output'];
-    /** Average progress (0-100) across this objective's non-deleted key results. */
+    /**
+     * Average progress (0-100) across this objective's non-deleted key results.
+     * Computed live -- never stored.
+     */
     progress: Scalars['Float']['output'];
     startDate?: Maybe<Scalars['DateTime']['output']>;
     status: ObjectiveStatus;
@@ -2369,6 +2427,10 @@ export type PlanmagnetQuotaOverview = {
     boardCount: Scalars['Int']['output'];
     /** Board quota limit (null when unlimited or unassigned) */
     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) */
+    editorLimit?: Maybe<Scalars['Int']['output']>;
     /** Number of active projects in the workspace */
     projectCount: Scalars['Int']['output'];
     /** Project quota limit (null when unlimited or unassigned) */
@@ -2388,14 +2450,17 @@ export type PlanmagnetReleaseList = {
     pageInfo: PlanmagnetPageInfo;
     totalCount: Scalars['Int']['output'];
 };
+export type PlanmagnetReleaseNotesCounts = {
+    __typename?: 'PlanmagnetReleaseNotesCounts';
+    bugFixes: Scalars['Int']['output'];
+    features: Scalars['Int']['output'];
+    improvements: Scalars['Int']['output'];
+    other: Scalars['Int']['output'];
+    total: Scalars['Int']['output'];
+};
 export type PlanmagnetReorderColumnsInput = {
     columnIds: Array<Scalars['ID']['input']>;
 };
-export declare enum PlanmagnetReportStatus {
-    Dismissed = "DISMISSED",
-    Pending = "PENDING",
-    Resolved = "RESOLVED"
-}
 export type PlanmagnetReviewQualityGateInput = {
     reviewNotes?: InputMaybe<Scalars['String']['input']>;
     status: QualityGateStatus;
@@ -2476,34 +2541,72 @@ export type PlanmagnetSprintBurndown = {
     /** Total story points across all items currently in the sprint. */
     totalPoints: Scalars['Int']['output'];
 };
-/**
- * Real cross-layer CrewFoundry workforce capacity for one sprint (BOFF-4444),
- * sourced live from wspace-crewfoundry-svc via the internal wspace gateway.
- */
+/** Cross-layer sprint capacity snapshot (BOFF-4444). */
 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.
+     */
     crewfoundryUnavailable: Scalars['Boolean']['output'];
+    /**
+     * One entry per work-item assignee who was successfully matched to a real
+     * CrewFoundry employee record
+     */
     members: Array<PlanmagnetSprintCapacityMember>;
     rangeEnd: Scalars['DateTime']['output'];
+    /**
+     * Window the capacity figures were computed over — the sprint's own
+     * startDate/endDate, or a trailing 14-day default when the sprint has no
+     * dates set (e.g. still PLANNING)
+     */
     rangeStart: Scalars['DateTime']['output'];
     sprintId: Scalars['ID']['output'];
+    /**
+     * Work-item assignees (actor ids) who could NOT be matched to a CrewFoundry
+     * employee — no workspace identity, or no CrewFoundry roster match by
+     * e-mail. This is the expected outcome for a workspace with no CrewFoundry
+     * module provisioned, or for a non-employee collaborator, not an error.
+     */
     unmatchedAssigneeIds: Array<Scalars['String']['output']>;
 };
 /**
  * Real CrewFoundry capacity/allocation for one sprint work-item assignee
- * (BOFF-4444) — sourced live, cross-layer, from wspace-crewfoundry-svc.
+ * (BOFF-4444) — sourced live, cross-layer, from `wspace-crewfoundry-svc`.
  */
 export type PlanmagnetSprintCapacityMember = {
     __typename?: 'PlanmagnetSprintCapacityMember';
+    /** Platform actor id (the same value as `WorkItem.assigneeId`) */
     actorId: Scalars['String']['output'];
+    /**
+     * Real CrewFoundry-tracked hours allocated across all projects over the
+     * sprint's date window (`crewEmployeeAllocation.totalHours`)
+     */
     allocatedHours: Scalars['Float']['output'];
+    /** Sum of story points on this person's assigned work items in this sprint */
     assignedStoryPoints: Scalars['Int']['output'];
+    /** Work items in this sprint assigned to this person */
     assignedWorkItemCount: Scalars['Int']['output'];
+    /**
+     * Real CrewFoundry-tracked billable hours over the same window
+     * (`crewEmployeeAllocation.billableHours`)
+     */
     billableHours: Scalars['Float']['output'];
+    /** CrewFoundry department */
     department: Scalars['String']['output'];
+    /** Matched CrewFoundry `CrewEmployee.id` */
     employeeId: Scalars['ID']['output'];
+    /** CrewFoundry employee's full name */
     employeeName: Scalars['String']['output'];
+    /** CrewFoundry position/title */
     position: Scalars['String']['output'];
+    /**
+     * `billableHours / allocatedHours * 100`, rounded to 1 decimal place. Null
+     * when `allocatedHours` is 0 (nothing to divide by).
+     */
     utilizationPercent?: Maybe<Scalars['Float']['output']>;
 };
 export type PlanmagnetSprintFilter = {
@@ -2520,11 +2623,15 @@ export type PlanmagnetSprintList = {
 export type PlanmagnetSprintWorkItemsInput = {
     workItemIds: Array<Scalars['ID']['input']>;
 };
-export declare enum PlanmagnetSubmissionStatus {
-    Approved = "APPROVED",
-    Pending = "PENDING",
-    Rejected = "REJECTED"
-}
+export type PlanmagnetSuggestWorkItemBreakdownInput = {
+    /** Plain-text feature request or description to break down. */
+    description: Scalars['String']['input'];
+    /**
+     * Optional explicit provider override ("gemini" | "openai" | "anthropic").
+     * Omit to use the platform's default provider chain.
+     */
+    requestedProvider?: InputMaybe<Scalars['String']['input']>;
+};
 export declare enum PlanmagnetSyncDirection {
     Bidirectional = "BIDIRECTIONAL",
     Inbound = "INBOUND",
@@ -2740,11 +2847,13 @@ export type PlanmagnetUpdateCustomFieldDefinitionInput = {
 };
 export type PlanmagnetUpdateDependencyInput = {
     description?: InputMaybe<Scalars['String']['input']>;
+    lagMinutes?: InputMaybe<Scalars['Int']['input']>;
     metadata?: InputMaybe<Scalars['JSON']['input']>;
     status?: InputMaybe<DependencyStatus>;
     type?: InputMaybe<DependencyType>;
 };
 export type PlanmagnetUpdateDocInput = {
+    /** Optional note recorded on the new revision this update creates. */
     changeNote?: InputMaybe<Scalars['String']['input']>;
     content?: InputMaybe<Scalars['String']['input']>;
     status?: InputMaybe<DocStatus>;
@@ -2783,6 +2892,7 @@ export type PlanmagnetUpdateKeyResultInput = {
     currentValue?: InputMaybe<Scalars['Float']['input']>;
     description?: InputMaybe<Scalars['String']['input']>;
     ownerId?: InputMaybe<Scalars['String']['input']>;
+    startValue?: InputMaybe<Scalars['Float']['input']>;
     status?: InputMaybe<KeyResultStatus>;
     targetValue?: InputMaybe<Scalars['Float']['input']>;
     title?: InputMaybe<Scalars['String']['input']>;
@@ -2931,6 +3041,11 @@ export type PlanmagnetUpdateSprintInput = {
     goal?: InputMaybe<Scalars['String']['input']>;
     metadata?: InputMaybe<Scalars['JSON']['input']>;
     name?: InputMaybe<Scalars['String']['input']>;
+    /**
+     * Accepted for API compatibility but not honored: sort position is always
+     * the auto-assigned, per-project-unique `sequenceNumber` — see
+     * sprint.service.ts.
+     */
     sortOrder?: InputMaybe<Scalars['Int']['input']>;
     startDate?: InputMaybe<Scalars['DateTime']['input']>;
     velocity?: InputMaybe<Scalars['Int']['input']>;
@@ -2977,7 +3092,11 @@ export type PlanmagnetVelocity = {
     __typename?: 'PlanmagnetVelocity';
     /** Mean completed points across the returned sprints. */
     averageVelocity: Scalars['Float']['output'];
-    /** Simple forecast for the next sprint's likely capacity (trailing average). */
+    /**
+     * Simple forecast for the next sprint's likely capacity: the trailing
+     * average above. Deliberately simple (moving average, not a full
+     * probabilistic model) — see analytics.service.ts.
+     */
     forecastNextSprintPoints: Scalars['Float']['output'];
     projectId: Scalars['ID']['output'];
     sprints: Array<PlanmagnetVelocitySprintPoint>;
@@ -2999,6 +3118,13 @@ export type PlanmagnetVoteOnFeatureInput = {
     comment?: InputMaybe<Scalars['String']['input']>;
     weight?: InputMaybe<Scalars['Int']['input']>;
 };
+export type PlanmagnetWorkItemBreakdownResult = {
+    __typename?: 'PlanmagnetWorkItemBreakdownResult';
+    /** Id of the PlanmagnetAgentRun ledger row this call was recorded as. */
+    agentRunId: Scalars['ID']['output'];
+    provider: Scalars['String']['output'];
+    suggestions: Array<PlanmagnetWorkItemSuggestion>;
+};
 export type PlanmagnetWorkItemDependencyList = {
     __typename?: 'PlanmagnetWorkItemDependencyList';
     items: Array<WorkItemDependency>;
@@ -3035,6 +3161,39 @@ export type PlanmagnetWorkItemList = {
     pageInfo: PlanmagnetPageInfo;
     totalCount: Scalars['Int']['output'];
 };
+export type PlanmagnetWorkItemSuggestion = {
+    __typename?: 'PlanmagnetWorkItemSuggestion';
+    description?: Maybe<Scalars['String']['output']>;
+    estimatedHours?: Maybe<Scalars['Float']['output']>;
+    priority: WorkItemPriority;
+    title: Scalars['String']['output'];
+    type: WorkItemType;
+};
+/**
+ * A user who currently holds billable "editor" access to a PlanMagnet
+ * workspace -- counted against the Free-tier `planmagnet.editors.count`
+ * quota (10 editors). Viewers/commenters are not tracked here and are free.
+ */
+export type PlanmagnetWorkspaceEditor = {
+    __typename?: 'PlanmagnetWorkspaceEditor';
+    /** Timestamp when this editor seat was granted */
+    createdAt: Scalars['DateTime']['output'];
+    /** Actor who granted this editor seat */
+    createdBy: Scalars['ID']['output'];
+    /** Unique identifier */
+    id: Scalars['ID']['output'];
+    /** User ID granted editor access */
+    userId: Scalars['ID']['output'];
+    /** Workspace ID */
+    workspaceId: Scalars['ID']['output'];
+};
+/** Paginated list of workspace editor seats. */
+export type PlanmagnetWorkspaceEditorList = {
+    __typename?: 'PlanmagnetWorkspaceEditorList';
+    items: Array<PlanmagnetWorkspaceEditor>;
+    pageInfo: PlanmagnetPageInfo;
+    totalCount: Scalars['Int']['output'];
+};
 /**
  * A strategic grouping of programs and projects for executive-level
  * oversight, resource allocation, and alignment tracking.
@@ -3280,7 +3439,16 @@ export type Query = {
     planmagnetCompetitor?: Maybe<Competitor>;
     /** List competitors in a workspace */
     planmagnetCompetitors: PlanmagnetCompetitorList;
-    /** Cumulative flow diagram data for a project over a date range (defaults to the trailing 30 days). */
+    /**
+     * Compute the critical path (longest dependency chain) for a workspace.
+     * When `projectId` is supplied, the path is scoped to the work items in
+     * that project; otherwise the entire workspace dependency graph is used.
+     */
+    planmagnetCriticalPath: PlanmagnetCriticalPath;
+    /**
+     * Cumulative flow diagram data for a project: work item counts per status,
+     * per day, over a date range (defaults to the trailing 30 days).
+     */
     planmagnetCumulativeFlow: PlanmagnetCumulativeFlow;
     /** Get a single custom field definition by ID */
     planmagnetCustomFieldDefinition?: Maybe<CustomFieldDefinition>;
@@ -3288,15 +3456,26 @@ export type Query = {
     planmagnetCustomFieldDefinitions: PlanmagnetCustomFieldDefinitionList;
     /** List custom field values */
     planmagnetCustomFieldValues: PlanmagnetCustomFieldValueList;
-    /** Cycle-time distribution for a project's work items reaching DONE within a date range (defaults to the trailing 90 days). */
+    /**
+     * Cycle-time distribution for a project's work items that reached DONE
+     * within a date range (defaults to the trailing 90 days).
+     */
     planmagnetCycleTime: PlanmagnetCycleTime;
     /** List dependencies in a workspace */
     planmagnetDependencies: PlanmagnetWorkItemDependencyList;
     /** Get a single dependency by ID */
     planmagnetDependency?: Maybe<WorkItemDependency>;
-    /** Get a single doc by ID */
+    /**
+     * Walk the dependency graph from a starting work item and return the
+     * reachable chain. Optional `maxDepth` bounds the traversal (default 50).
+     */
+    planmagnetDependencyChain: PlanmagnetDependencyChain;
+    /**
+     * List every distinct cycle in the workspace's dependency graph. Returns
+     * an empty array when the graph is acyclic.
+     */
+    planmagnetDependencyCycles: Array<PlanmagnetDependencyCycle>;
     planmagnetDoc?: Maybe<PlanmagnetDoc>;
-    /** List docs in a workspace */
     planmagnetDocs: PlanmagnetDocList;
     /** List external mappings */
     planmagnetExternalMappings: PlanmagnetExternalMappingList;
@@ -3308,19 +3487,12 @@ export type Query = {
     planmagnetFeatureRequest?: Maybe<FeatureRequest>;
     /** List feature requests in a workspace */
     planmagnetFeatureRequests: PlanmagnetFeatureRequestList;
-    /** Get a single key result by ID */
     planmagnetKeyResult?: Maybe<PlanmagnetKeyResult>;
-    /** List adapter submissions for admin review. */
-    planmagnetListAdapterSubmissions: PlanmagnetAdapterSubmissionConnection;
-    /** List marketplace reports for admin moderation. */
-    planmagnetListMarketplaceReports: PlanmagnetMarketplaceReportConnection;
     /** Get a single milestone by ID */
     planmagnetMilestone?: Maybe<Milestone>;
     /** List milestones in a workspace */
     planmagnetMilestones: PlanmagnetMilestoneList;
-    /** Get a single objective by ID */
     planmagnetObjective?: Maybe<PlanmagnetObjective>;
-    /** List objectives in a workspace */
     planmagnetObjectives: PlanmagnetObjectiveList;
     /** Get a single portfolio by ID */
     planmagnetPortfolio?: Maybe<Portfolio>;
@@ -3364,9 +3536,18 @@ export type Query = {
     planmagnetRoadmaps: PlanmagnetRoadmapList;
     /** Get a single sprint by ID */
     planmagnetSprint?: Maybe<Sprint>;
-    /** Burndown chart data for a sprint: remaining vs completed points/count per day. */
+    /**
+     * Burndown chart data for a sprint: remaining vs completed points/count per
+     * day across the sprint's date range. Returns null if the sprint does not
+     * exist in the workspace.
+     */
     planmagnetSprintBurndown?: Maybe<PlanmagnetSprintBurndown>;
-    /** Real cross-layer CrewFoundry workforce capacity for a sprint (BOFF-4444). */
+    /**
+     * Real cross-layer sprint-planning capacity view (BOFF-4444): for each
+     * work-item assignee in this sprint who matches a CrewFoundry employee
+     * record, surfaces live workforce allocation/availability queried from
+     * `wspace-crewfoundry-svc` via the internal wspace gateway.
+     */
     planmagnetSprintCapacity: PlanmagnetSprintCapacity;
     /** List sprints in a workspace */
     planmagnetSprints: PlanmagnetSprintList;
@@ -3378,7 +3559,10 @@ export type Query = {
     planmagnetTimesheet?: Maybe<PlanmagnetTimesheet>;
     /** List timesheets in a workspace */
     planmagnetTimesheets: PlanmagnetTimesheetList;
-    /** Velocity across the trailing N COMPLETED sprints of a project, plus a simple next-sprint forecast. */
+    /**
+     * Velocity (completed story points per sprint) across the trailing N
+     * COMPLETED sprints of a project, plus a simple next-sprint forecast.
+     */
     planmagnetVelocity: PlanmagnetVelocity;
     /** Get a single work item by ID */
     planmagnetWorkItem?: Maybe<WorkItem>;
@@ -3390,6 +3574,8 @@ export type Query = {
     planmagnetWorkItemLinks: PlanmagnetWorkItemLinkList;
     /** List work items in a workspace */
     planmagnetWorkItems: PlanmagnetWorkItemList;
+    /** List the users who currently hold billable editor access to a workspace. */
+    planmagnetWorkspaceEditors: PlanmagnetWorkspaceEditorList;
     /** Get a PlanMagnet workspace quota overview (counts + billing limits). */
     planmagnetWorkspaceQuotaOverview: PlanmagnetQuotaOverview;
 };
@@ -3439,6 +3625,10 @@ export type QueryPlanmagnetCompetitorsArgs = {
     pagination?: InputMaybe<PlanmagnetPaginationInput>;
     workspaceId: Scalars['ID']['input'];
 };
+export type QueryPlanmagnetCriticalPathArgs = {
+    projectId?: InputMaybe<Scalars['ID']['input']>;
+    workspaceId: Scalars['ID']['input'];
+};
 export type QueryPlanmagnetCumulativeFlowArgs = {
     endDate?: InputMaybe<Scalars['DateTime']['input']>;
     projectId: Scalars['ID']['input'];
@@ -3472,13 +3662,22 @@ export type QueryPlanmagnetDependenciesArgs = {
 export type QueryPlanmagnetDependencyArgs = {
     id: Scalars['ID']['input'];
 };
+export type QueryPlanmagnetDependencyChainArgs = {
+    maxDepth?: InputMaybe<Scalars['Int']['input']>;
+    workItemId: Scalars['ID']['input'];
+    workspaceId: Scalars['ID']['input'];
+};
+export type QueryPlanmagnetDependencyCyclesArgs = {
+    projectId?: InputMaybe<Scalars['ID']['input']>;
+    workspaceId: Scalars['ID']['input'];
+};
 export type QueryPlanmagnetDocArgs = {
     id: Scalars['ID']['input'];
 };
 export type QueryPlanmagnetDocsArgs = {
     filter?: InputMaybe<PlanmagnetDocFilter>;
     pagination?: InputMaybe<PlanmagnetPaginationInput>;
-    workspaceId: Scalars['ID']['input'];
+    workspaceId?: InputMaybe<Scalars['String']['input']>;
 };
 export type QueryPlanmagnetExternalMappingsArgs = {
     filter?: InputMaybe<PlanmagnetExternalMappingFilter>;
@@ -3504,14 +3703,6 @@ export type QueryPlanmagnetFeatureRequestsArgs = {
 export type QueryPlanmagnetKeyResultArgs = {
     id: Scalars['ID']['input'];
 };
-export type QueryPlanmagnetListAdapterSubmissionsArgs = {
-    pagination?: InputMaybe<PlanmagnetPaginationInput>;
-    status?: InputMaybe<PlanmagnetSubmissionStatus>;
-};
-export type QueryPlanmagnetListMarketplaceReportsArgs = {
-    pagination?: InputMaybe<PlanmagnetPaginationInput>;
-    status?: InputMaybe<PlanmagnetReportStatus>;
-};
 export type QueryPlanmagnetMilestoneArgs = {
     id: Scalars['ID']['input'];
 };
@@ -3661,6 +3852,10 @@ export type QueryPlanmagnetWorkItemsArgs = {
     pagination?: InputMaybe<PlanmagnetPaginationInput>;
     workspaceId: Scalars['ID']['input'];
 };
+export type QueryPlanmagnetWorkspaceEditorsArgs = {
+    pagination?: InputMaybe<PlanmagnetPaginationInput>;
+    workspaceId: Scalars['ID']['input'];
+};
 export type QueryPlanmagnetWorkspaceQuotaOverviewArgs = {
     workspaceId: Scalars['ID']['input'];
 };
@@ -3722,7 +3917,8 @@ export declare enum ReleaseStatus {
     Planning = "PLANNING",
     Ready = "READY",
     Released = "RELEASED",
-    RolledBack = "ROLLED_BACK"
+    RolledBack = "ROLLED_BACK",
+    Staging = "STAGING"
 }
 /**
  * A potential threat or issue that could impact project delivery,
@@ -3926,7 +4122,12 @@ export type Sprint = {
     project?: Maybe<PlanmagnetProject>;
     /** Parent project ID */
     projectId: Scalars['String']['output'];
-    /** Sort order */
+    /**
+     * Sort order. Backed by the Prisma `sequenceNumber` column (the only ordering
+     * primitive Sprint has) via a field resolver — see sprint.resolvers.ts. Not
+     * independently settable; see PlanmagnetCreateSprintInput/
+     * PlanmagnetUpdateSprintInput below.
+     */
     sortOrder: Scalars['Int']['output'];
     /** Sprint start date */
     startDate?: Maybe<Scalars['DateTime']['output']>;
@@ -3936,7 +4137,10 @@ export type Sprint = {
     updatedAt: Scalars['DateTime']['output'];
     /** Actor who last updated this sprint */
     updatedBy?: Maybe<Scalars['String']['output']>;
-    /** Sprint velocity (completed story points) */
+    /**
+     * Sprint velocity (completed story points). Backed by the Prisma
+     * `velocityActual` column via a field resolver — see sprint.resolvers.ts.
+     */
     velocity?: Maybe<Scalars['Int']['output']>;
     /** Work items in this sprint */
     workItems: Array<WorkItem>;
@@ -4061,20 +4265,30 @@ export type WorkItemDependency = {
     description?: Maybe<Scalars['String']['output']>;
     /** Unique identifier */
     id: Scalars['ID']['output'];
+    /**
+     * Offset applied to the constraint, in minutes. Negative means lead (overlap)
+     * rather than lag. The column has always existed as `lagDays`; the SDL never
+     * exposed it, so a lagged constraint could not be expressed at all.
+     */
+    lagMinutes?: Maybe<Scalars['Int']['output']>;
     /** Arbitrary metadata */
     metadata?: Maybe<Scalars['JSON']['output']>;
     /** Actor on whose behalf this was created */
     onBehalfOf?: Maybe<Scalars['String']['output']>;
-    /** Source work item */
-    sourceWorkItem?: Maybe<WorkItem>;
-    /** Source work item ID */
-    sourceWorkItemId: Scalars['String']['output'];
+    /** The constraining work item */
+    predecessor?: Maybe<WorkItem>;
+    /**
+     * The work item that constrains the other. Renamed from `sourceWorkItemId`:
+     * with `type` now purely a scheduling relationship, source/target read as a
+     * generic graph edge while predecessor/successor state the actual meaning.
+     */
+    predecessorId: Scalars['String']['output'];
     /** Current status */
     status: DependencyStatus;
-    /** Target work item */
-    targetWorkItem?: Maybe<WorkItem>;
-    /** Target work item ID */
-    targetWorkItemId: Scalars['String']['output'];
+    /** The constrained work item */
+    successor?: Maybe<WorkItem>;
+    /** The work item whose schedule is constrained. Renamed from `targetWorkItemId`. */
+    successorId: Scalars['String']['output'];
     /** Type of dependency */
     type: DependencyType;
     /** Last update timestamp */
@@ -4116,9 +4330,28 @@ export type WorkItemLink = {
     /** Associated workspace ID */
     workspaceId: Scalars['String']['output'];
 };
+/**
+ * How a work item relates to the thing it is linked to.
+ *
+ * The first six are cross-product verbs: a work item INSPECTS a HealthyBowl
+ * sensor, PRODUCES an artifact. The five added in 20260924130000 are the
+ * work-item-to-work-item issue-link verbs that used to sit on
+ * `WorkItemDependency.type`, where they were indistinguishable from scheduling
+ * constraints and dragged semantic links into critical-path maths.
+ *
+ * For a link between two PlanMagnet work items, use `sourceProduct: "planmagnet"`
+ * and `entityType: "WorkItem"`. **None of these relations affect scheduling** —
+ * that is `WorkItemDependency` and only `WorkItemDependency`.
+ */
 export declare enum WorkItemLinkRelation {
     Affects = "AFFECTS",
+    /** This work item is blocked by the linked one. Semantic only: it does NOT schedule. */
+    BlockedBy = "BLOCKED_BY",
     Blocks = "BLOCKS",
+    CausedBy = "CAUSED_BY",
+    Causes = "CAUSES",
+    DuplicatedBy = "DUPLICATED_BY",
+    Duplicates = "DUPLICATES",
     Inspects = "INSPECTS",
     Produces = "PRODUCES",
     RelatedTo = "RELATED_TO",