// src/entities/workitems/registry.ts:511-512
if (timeEstimate !== undefined) {
  createInput.timeTrackingWidget = { timeEstimate };  // ❌ NOT supported by GitLab API
}

// Step 1: Remove timeTrackingWidget from create input
const { timeEstimate, ...createInputWithoutTime } = createInput;

// Step 2: Create work item
const createResponse = await client.request(CREATE_WORK_ITEM_WITH_WIDGETS, {
  input: createInputWithoutTime,
});

const createdWorkItem = createResponse.workItemCreate?.workItem;
if (!createdWorkItem) {
  throw new Error("Work item creation failed");
}

// Step 3: If timeEstimate was requested, apply it via update
if (timeEstimate !== undefined) {
  try {
    const updateResponse = await client.request(UPDATE_WORK_ITEM, {
      input: {
        id: createdWorkItem.id,
        timeTrackingWidget: { timeEstimate },
      },
    });
    
    // Return updated work item with time estimate applied
    return cleanWorkItemResponse(updateResponse.workItemUpdate.workItem);
    
  } catch (updateError) {
    // Update failed - return create result with warning
    return {
      ...cleanWorkItemResponse(createdWorkItem),
      _warning: {
        message: "Work item created successfully, but some properties could not be applied",
        failedProperties: {
          timeEstimate: {
            requestedValue: timeEstimate,
            error: updateError.message,
          },
        },
      },
    };
  }
}

return cleanWorkItemResponse(createdWorkItem);

describe('manage_work_item create with widgets', () => {
  it('should create work item with title only', async () => {});

  it('should create work item with startDate + dueDate', async () => {
    // Verify startAndDueDateWidget works on create
  });

  it('should create work item with timeEstimate via two-step approach', async () => {
    // 1. Create with timeEstimate parameter
    // 2. Verify work item created
    // 3. Verify timeEstimate applied via update
  });

  it('should return partial success when timeEstimate update fails', async () => {
    // Mock update to fail
    // Verify create succeeded
    // Verify _warning in response
  });

  it('should create work item with all Free tier widgets', async () => {
    // assignees, labels, milestone, dates, hierarchy, description
  });

  it('should create work item with Premium tier widgets', async () => {
    // weight, iteration, isFixed
  });

  it('should create work item with Ultimate tier widgets', async () => {
    // healthStatus, color
  });
});

describe('Work Item Data Lifecycle', () => {
  describe('Time Tracking Lifecycle', () => {
    it('should handle time tracking across lifecycle', async () => {
      // 1. Create issue with timeEstimate: "4h" (via two-step)
      // 2. Verify timeEstimate applied
      // 3. Log timeSpent: "1h 30m"
      // 4. Verify totalTimeSpent
      // 5. Close issue
      // 6. Verify time data preserved
    });
  });

  describe('Dates Lifecycle', () => {
    it('should handle date updates including null (clear)', async () => {
      // 1. Create with startDate + dueDate
      // 2. Verify dates set
      // 3. Update dueDate to null
      // 4. Verify dueDate cleared, startDate preserved
    });
  });

  describe('Hierarchy Lifecycle', () => {
    it('should handle parent relationship changes', async () => {
      // 1. Create issue
      // 2. Create epic as parent
      // 3. Set parent
      // 4. Change parent to another epic
      // 5. Set parentId to null (unlink)
    });
  });

  describe('Linked Items Lifecycle', () => {
    it('should handle work item links', async () => {
      // 1. Create issue A and B
      // 2. Add link A BLOCKS B
      // 3. Verify link exists
      // 4. Remove link
      // 5. Verify link removed
    });
  });
});

describe('AI Agent Error Messages', () => {
  it('should return clear partial success response', async () => {
    // Create with timeEstimate where update fails
    // Verify:
    // 1. Work item is created (id, iid, webUrl present)
    // 2. _warning explains what failed
    // 3. Agent can understand and report to user
  });

  it('should provide tier-specific guidance on failure', async () => {
    // Try to use Premium widget on Free tier
    // Verify error in _warning.failedProperties explains tier requirement
  });
});

timeEstimate: z
  .string()
  .optional()
  .describe('Time estimate (e.g. "1h 30m", "2d"). Applied via update after create. Check _warning in response if application failed.')