tapd-mcp 1.0.3 → 1.0.5

package/dist/tapd-client.d.ts

@@ -143,6 +143,30 @@ export interface Release {
     modified?: string;
     [key: string]: string | undefined;
 }
+export interface Timesheet {
+    id: string;
+    workspace_id: string;
+    entity_type: string;
+    entity_id: string;
+    owner?: string;
+    spentdate?: string;
+    timespent?: string;
+    memo?: string;
+    created?: string;
+    modified?: string;
+    [key: string]: string | undefined;
+}
+export interface CustomFieldSetting {
+    workspace_id?: string;
+    entry_type?: string;
+    field_name?: string;
+    field_type?: string;
+    field_label?: string;
+    required?: string;
+    options?: string;
+    is_open?: string;
+    [key: string]: string | undefined;
+}
 export interface StoryChange {
     id: string;
     story_id: string;
@@ -163,6 +187,15 @@ export interface WorkspaceUser {
     user_group_id?: string;
     [key: string]: string | undefined;
 }
+/**
+ * Upsert a "提测时间：YYYY-MM-DD" line inside a story description.
+ * Matches both "提测时间" and "提测日期", tolerates :/： and full-width dates,
+ * and works whether the description is plain text or HTML.
+ */
+export declare function upsertTestSubmissionLine(description: string, testDate: string): {
+    newDesc: string;
+    previous?: string;
+};
 export declare class TapdClient {
     private apiToken;
     private baseUrl;
@@ -205,6 +238,85 @@ export declare class TapdClient {
         categoryId?: string;
         releaseId?: string;
     }): Promise<Story>;
+    /**
+     * Look up a custom-field definition by user-facing label or by API name.
+     * `query` matches against (in order): the API name itself (e.g. "custom_field_one"),
+     * then the Chinese/English label, then the legacy `field_name` key. Match is
+     * case-insensitive, whitespace-trimmed, and both English+Chinese punctuation
+     * are normalised so users can type "提测时间" or "提测 时间" or "TestDate".
+     *
+     * Two data sources are tried, in order:
+     *   1. /stories/get_fields_info — covers ALL story fields (system + custom)
+     *      with localized labels. This is the canonical source for workspaces that
+     *      use TAPD's "field config" UI. Returns 403 in some workspaces; falls
+     *      back to source 2.
+     *   2. /stories/custom_fields_settings — older endpoint; only returns custom
+     *      fields and may be empty in workspaces that store labels under (1).
+     *
+     * Returns null when no field matches; otherwise the raw setting plus the
+     * resolved API name (the property you POST to /stories with).
+     */
+    resolveStoryCustomField(workspaceId: string, query: string, entryType?: string): Promise<(CustomFieldSetting & {
+        api_name: string;
+    }) | null>;
+    /**
+     * Fetch the workspace's full story field schema via /stories/get_fields_info.
+     * Returns a map { api_name -> { label, html_type, options, readonly } }.
+     *
+     * Caches the result on disk per workspace (see src/fields-cache.ts) — the
+     * schema rarely changes, and skipping the network on every resolve speeds
+     * up repeated `tapd_set_story_*` calls noticeably. Pass `forceRefresh: true`
+     * after a workspace admin edits the field config.
+     *
+     * Throws (rather than returning {}) on permission errors so callers can fall
+     * back to the legacy custom_fields_settings endpoint.
+     */
+    getStoryFieldsInfo(workspaceId: string, options?: {
+        forceRefresh?: boolean;
+    }): Promise<Record<string, {
+        label?: string;
+        html_type?: string;
+        options?: any;
+        readonly?: number;
+    }>>;
+    /**
+     * Set a custom field on a story by user-facing field name OR by API name.
+     *
+     * `field` accepts either:
+     *   - a label (e.g. "提测时间", "TestDate") — resolved via /stories/custom_fields_settings
+     *   - an API name (e.g. "custom_field_one") — used directly
+     *
+     * Returns the updated story plus the resolved field metadata so the caller
+     * can confirm what was written.
+     */
+    setStoryCustomField(workspaceId: string, storyId: string, field: string, value: string): Promise<{
+        story: Story;
+        field: {
+            api_name: string;
+            label?: string;
+            type?: string;
+        };
+        previous?: string;
+    }>;
+    /**
+     * Set a story's "提测时间" (ready-for-test / QA handoff date).
+     *
+     * Resolution order:
+     *   1. If `customField` is provided -> write to that exact field.
+     *   2. Otherwise resolve "提测时间" / "提测日期" against the workspace's
+     *      story field schema (/stories/get_fields_info, falling back to
+     *      /stories/custom_fields_settings) and write into the matching field.
+     *   3. Fall back to upserting a `提测时间：YYYY-MM-DD` line in the description.
+     */
+    setStoryTestSubmissionDate(workspaceId: string, storyId: string, testDate: string, options?: {
+        customField?: string;
+    }): Promise<{
+        story: Story;
+        mode: 'custom_field' | 'description';
+        field?: string;
+        label?: string;
+        previous?: string;
+    }>;
     getStoryChanges(workspaceId: string, storyId: string, options?: {
         limit?: number;
         page?: number;
@@ -344,6 +456,42 @@ export declare class TapdClient {
         customField?: string;
         owner?: string;
     }): Promise<Attachment>;
+    /**
+     * TAPD timesheet API expects singular entity_type ("task"/"story"/"bug"),
+     * but our MCP tool surface uses plural ("tasks"/"stories"/"bugs") for
+     * consistency with comments/attachments. Normalize here.
+     */
+    private toSingularEntityType;
+    listTimesheets(workspaceId: string, options?: {
+        entityType?: string;
+        entityId?: string;
+        owner?: string;
+        spentdate?: string;
+        startDate?: string;
+        endDate?: string;
+        limit?: number;
+        page?: number;
+    }): Promise<Timesheet[]>;
+    addTimesheet(workspaceId: string, data: {
+        entityType: string;
+        entityId: string;
+        timespent: string;
+        spentdate: string;
+        owner?: string;
+        memo?: string;
+    }): Promise<Timesheet>;
+    updateTimesheet(workspaceId: string, timesheetId: string, data: {
+        timespent?: string;
+        spentdate?: string;
+        owner?: string;
+        memo?: string;
+    }): Promise<Timesheet>;
+    deleteTimesheet(workspaceId: string, timesheetId: string): Promise<boolean>;
+    listAttachments(workspaceId: string, entityType: 'stories' | 'tasks' | 'bugs', entityId: string, options?: {
+        limit?: number;
+        page?: number;
+    }): Promise<Attachment[]>;
+    getCustomFieldsSettings(workspaceId: string, entryType?: string): Promise<CustomFieldSetting[]>;
     translateStoryStatus(status: string): string;
     translateTaskStatus(status: string): string;
     translateBugStatus(status: string): string;

package/dist/tapd-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tapd-client.d.ts","sourceRoot":"","sources":["../src/tapd-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tapd-client.d.ts","sourceRoot":"","sources":["../src/tapd-client.ts"],"names":[],"mappings":"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"}

package/dist/tapd-client.js

@@ -3,6 +3,7 @@
  */
 import { readFile } from 'node:fs/promises';
 import { basename } from 'node:path';
+import { readFieldsCache, writeFieldsCache } from './fields-cache.js';
 const STATUS_MAP = {
     'planning': 'planning',
     'developing': 'developing',
@@ -32,6 +33,29 @@ const TASK_STATUS_MAP = {
     'progressing': '进行中',
     'done': '已完成',
 };
+/**
+ * Upsert a "提测时间：YYYY-MM-DD" line inside a story description.
+ * Matches both "提测时间" and "提测日期", tolerates :/： and full-width dates,
+ * and works whether the description is plain text or HTML.
+ */
+export function upsertTestSubmissionLine(description, testDate) {
+    const newLine = `提测时间：${testDate}`;
+    const re = /(提测(?:时间|日期))\s*[:：]\s*([0-9０-９]{4}[-/年.][0-9０-９]{1,2}[-/月.][0-9０-９]{1,2}日?)/;
+    const match = description.match(re);
+    if (match) {
+        const previous = match[2];
+        const newDesc = description.replace(re, newLine);
+        return { newDesc, previous };
+    }
+    if (!description) {
+        return { newDesc: `<p>${newLine}</p>` };
+    }
+    // Looks like HTML (contains a tag) -> prepend a <p>; otherwise prepend text + newline.
+    if (/<[^>]+>/.test(description)) {
+        return { newDesc: `<p>${newLine}</p>${description}` };
+    }
+    return { newDesc: `${newLine}\n${description}` };
+}
 const BUG_STATUS_MAP = {
     'new': '新建',
     'in_progress': '接受/处理',
@@ -59,14 +83,17 @@ export class TapdClient {
         }
         return `Bearer ${this.apiToken}`;
     }
-    async request(method, endpoint, params) {
+    async request(method, endpoint, params, options) {
         const url = new URL(endpoint, this.baseUrl);
+        const keepEmpty = new Set(options?.keepEmpty || []);
         const filteredParams = {};
         if (params) {
             for (const [key, value] of Object.entries(params)) {
-                if (value !== undefined && value !== null && value !== '') {
-                    filteredParams[key] = String(value);
-                }
+                if (value === undefined || value === null)
+                    continue;
+                if (value === '' && !keepEmpty.has(key))
+                    continue;
+                filteredParams[key] = String(value);
             }
         }
         const headers = {
@@ -89,11 +116,12 @@ export class TapdClient {
         }
         if (!response.ok) {
             const text = await response.text();
-            throw new Error(`TAPD API error: ${response.status} ${response.statusText} - ${text}`);
+            throw new Error(`TAPD API error [${endpoint}]: HTTP ${response.status} ${response.statusText} - ${text}`);
         }
         const data = await response.json();
         if (data.status !== 1) {
-            throw new Error(`TAPD API error: ${data.info || 'Unknown error'}`);
+            const info = data.info || data.message || 'Unknown error';
+            throw new Error(`TAPD API error [${endpoint}]: ${info}`);
         }
         // Normalize response: POST returns {data: {Story: ...}}, GET returns {data: [{Story: ...}]}
         // Convert single object to array format for consistency
@@ -167,6 +195,220 @@ export class TapdClient {
         }
         return response.data[0].Story;
     }
+    /**
+     * Look up a custom-field definition by user-facing label or by API name.
+     * `query` matches against (in order): the API name itself (e.g. "custom_field_one"),
+     * then the Chinese/English label, then the legacy `field_name` key. Match is
+     * case-insensitive, whitespace-trimmed, and both English+Chinese punctuation
+     * are normalised so users can type "提测时间" or "提测 时间" or "TestDate".
+     *
+     * Two data sources are tried, in order:
+     *   1. /stories/get_fields_info — covers ALL story fields (system + custom)
+     *      with localized labels. This is the canonical source for workspaces that
+     *      use TAPD's "field config" UI. Returns 403 in some workspaces; falls
+     *      back to source 2.
+     *   2. /stories/custom_fields_settings — older endpoint; only returns custom
+     *      fields and may be empty in workspaces that store labels under (1).
+     *
+     * Returns null when no field matches; otherwise the raw setting plus the
+     * resolved API name (the property you POST to /stories with).
+     */
+    async resolveStoryCustomField(workspaceId, query, entryType = 'story') {
+        const norm = (s) => (s || '').replace(/\s+/g, '').toLowerCase();
+        const target = norm(query);
+        try {
+            const info = await this.getStoryFieldsInfo(workspaceId);
+            for (const [apiName, def] of Object.entries(info)) {
+                const label = def.label || '';
+                if (norm(apiName) === target || norm(label) === target) {
+                    return {
+                        api_name: apiName,
+                        field_name: apiName,
+                        field_label: label,
+                        field_type: def.html_type,
+                    };
+                }
+            }
+        }
+        catch {
+            // fall through to legacy endpoint
+        }
+        const settings = await this.getCustomFieldsSettings(workspaceId, entryType);
+        for (const f of settings) {
+            const apiName = f.custom_field ||
+                f.field_name ||
+                f.name ||
+                '';
+            const label = f.field_label || f.label || f.cn_name || '';
+            const enName = f.en_name || f.english_name || '';
+            if (norm(apiName) === target ||
+                norm(label) === target ||
+                norm(enName) === target ||
+                norm(f.field_name) === target) {
+                return { ...f, api_name: apiName };
+            }
+        }
+        return null;
+    }
+    /**
+     * Fetch the workspace's full story field schema via /stories/get_fields_info.
+     * Returns a map { api_name -> { label, html_type, options, readonly } }.
+     *
+     * Caches the result on disk per workspace (see src/fields-cache.ts) — the
+     * schema rarely changes, and skipping the network on every resolve speeds
+     * up repeated `tapd_set_story_*` calls noticeably. Pass `forceRefresh: true`
+     * after a workspace admin edits the field config.
+     *
+     * Throws (rather than returning {}) on permission errors so callers can fall
+     * back to the legacy custom_fields_settings endpoint.
+     */
+    async getStoryFieldsInfo(workspaceId, options) {
+        if (!options?.forceRefresh) {
+            const cached = await readFieldsCache(workspaceId, 'story');
+            if (cached?.data)
+                return cached.data;
+        }
+        const url = new URL('/stories/get_fields_info', this.baseUrl);
+        url.search = new URLSearchParams({ workspace_id: workspaceId }).toString();
+        const res = await fetch(url.toString(), {
+            method: 'GET',
+            headers: {
+                Authorization: this.buildAuthHeader(),
+                Accept: 'application/json',
+                'User-Agent': 'TAPD-MCP-Server/1.0',
+            },
+        });
+        if (!res.ok) {
+            throw new Error(`get_fields_info HTTP ${res.status} ${res.statusText}`);
+        }
+        const j = await res.json();
+        if (j.status !== 1) {
+            throw new Error(`get_fields_info status=${j.status} info=${j.info || 'unknown'}`);
+        }
+        const data = j.data || {};
+        try {
+            await writeFieldsCache(workspaceId, 'story', data);
+        }
+        catch {
+            // cache write failure is non-fatal; the network result is still returned
+        }
+        return data;
+    }
+    /**
+     * Set a custom field on a story by user-facing field name OR by API name.
+     *
+     * `field` accepts either:
+     *   - a label (e.g. "提测时间", "TestDate") — resolved via /stories/custom_fields_settings
+     *   - an API name (e.g. "custom_field_one") — used directly
+     *
+     * Returns the updated story plus the resolved field metadata so the caller
+     * can confirm what was written.
+     */
+    async setStoryCustomField(workspaceId, storyId, field, value) {
+        const looksLikeApiName = /^custom_field(?:_[a-z]+|_\d+)?$/i.test(field);
+        let apiName;
+        let label;
+        let type;
+        if (looksLikeApiName) {
+            apiName = field;
+        }
+        else {
+            const resolved = await this.resolveStoryCustomField(workspaceId, field);
+            if (!resolved) {
+                let available = '';
+                try {
+                    const info = await this.getStoryFieldsInfo(workspaceId);
+                    available = Object.entries(info)
+                        .filter(([, v]) => !v.readonly)
+                        .map(([k, v]) => {
+                        const l = v.label || '';
+                        return l ? `${k} (${l})` : k;
+                    })
+                        .join(', ');
+                }
+                catch {
+                    const settings = await this.getCustomFieldsSettings(workspaceId, 'story');
+                    available = settings
+                        .map(f => {
+                        const a = f.custom_field || f.field_name || f.name || '?';
+                        const l = f.field_label || f.label || '';
+                        return l ? `${a} (${l})` : a;
+                    })
+                        .join(', ');
+                }
+                throw new Error(`Field "${field}" not found in workspace ${workspaceId}. ` +
+                    (available ? `Available: ${available}` : 'No fields are defined for stories.'));
+            }
+            apiName = resolved.api_name;
+            label = resolved.field_label || resolved.label;
+            type = resolved.field_type;
+        }
+        if (!apiName) {
+            throw new Error(`Could not resolve API name for custom field "${field}"`);
+        }
+        const before = await this.getStory(workspaceId, storyId, `id,name,${apiName}`);
+        if (!before)
+            throw new Error(`Story ${storyId} not found`);
+        const previous = before[apiName];
+        const response = await this.request('POST', '/stories', {
+            workspace_id: workspaceId,
+            id: storyId,
+            [apiName]: value,
+        }, { keepEmpty: [apiName] });
+        if (!response.data || response.data.length === 0) {
+            throw new Error(`Failed to set ${apiName}: no data returned`);
+        }
+        return {
+            story: response.data[0].Story,
+            field: { api_name: apiName, label, type },
+            previous,
+        };
+    }
+    /**
+     * Set a story's "提测时间" (ready-for-test / QA handoff date).
+     *
+     * Resolution order:
+     *   1. If `customField` is provided -> write to that exact field.
+     *   2. Otherwise resolve "提测时间" / "提测日期" against the workspace's
+     *      story field schema (/stories/get_fields_info, falling back to
+     *      /stories/custom_fields_settings) and write into the matching field.
+     *   3. Fall back to upserting a `提测时间：YYYY-MM-DD` line in the description.
+     */
+    async setStoryTestSubmissionDate(workspaceId, storyId, testDate, options) {
+        if (!/^\d{4}-\d{2}-\d{2}$/.test(testDate)) {
+            throw new Error(`Invalid test_date: "${testDate}". Expected YYYY-MM-DD.`);
+        }
+        if (options?.customField) {
+            const result = await this.setStoryCustomField(workspaceId, storyId, options.customField, testDate);
+            return {
+                story: result.story,
+                mode: 'custom_field',
+                field: result.field.api_name,
+                label: result.field.label,
+                previous: result.previous,
+            };
+        }
+        for (const candidate of ['提测时间', '提测日期']) {
+            const resolved = await this.resolveStoryCustomField(workspaceId, candidate);
+            if (resolved && resolved.api_name) {
+                const result = await this.setStoryCustomField(workspaceId, storyId, resolved.api_name, testDate);
+                return {
+                    story: result.story,
+                    mode: 'custom_field',
+                    field: result.field.api_name,
+                    label: result.field.label,
+                    previous: result.previous,
+                };
+            }
+        }
+        const before = await this.getStory(workspaceId, storyId, 'id,name,description');
+        if (!before)
+            throw new Error(`Story ${storyId} not found`);
+        const oldDesc = before.description || '';
+        const { newDesc, previous } = upsertTestSubmissionLine(oldDesc, testDate);
+        const updated = await this.updateStory(workspaceId, storyId, { description: newDesc });
+        return { story: updated, mode: 'description', previous };
+    }
     async getStoryChanges(workspaceId, storyId, options) {
         const response = await this.request('GET', '/story_changes', {
             workspace_id: workspaceId,
@@ -555,6 +797,93 @@ export class TapdClient {
             filename: name,
         };
     }
+    // ==================== Timesheet APIs ====================
+    /**
+     * TAPD timesheet API expects singular entity_type ("task"/"story"/"bug"),
+     * but our MCP tool surface uses plural ("tasks"/"stories"/"bugs") for
+     * consistency with comments/attachments. Normalize here.
+     */
+    toSingularEntityType(entityType) {
+        if (!entityType)
+            return entityType;
+        return entityType.endsWith('s') ? entityType.slice(0, -1) : entityType;
+    }
+    async listTimesheets(workspaceId, options) {
+        const params = {
+            workspace_id: workspaceId,
+            entity_type: this.toSingularEntityType(options?.entityType),
+            entity_id: options?.entityId,
+            owner: options?.owner,
+            limit: options?.limit || 30,
+            page: options?.page || 1,
+        };
+        if (options?.startDate || options?.endDate) {
+            // TAPD supports spentdate[_gte]/[_lte] for range queries
+            if (options.startDate)
+                params['spentdate[_gte]'] = options.startDate;
+            if (options.endDate)
+                params['spentdate[_lte]'] = options.endDate;
+        }
+        else if (options?.spentdate) {
+            params.spentdate = options.spentdate;
+        }
+        const response = await this.request('GET', '/timesheets', params);
+        return (response.data || []).map(item => item.Timesheet);
+    }
+    async addTimesheet(workspaceId, data) {
+        const response = await this.request('POST', '/timesheets', {
+            workspace_id: workspaceId,
+            entity_type: this.toSingularEntityType(data.entityType),
+            entity_id: data.entityId,
+            timespent: data.timespent,
+            spentdate: data.spentdate,
+            owner: data.owner,
+            memo: data.memo,
+        });
+        if (!response.data || response.data.length === 0) {
+            throw new Error('Failed to add timesheet: no data returned');
+        }
+        return response.data[0].Timesheet;
+    }
+    async updateTimesheet(workspaceId, timesheetId, data) {
+        const response = await this.request('POST', '/timesheets/update', {
+            workspace_id: workspaceId,
+            id: timesheetId,
+            timespent: data.timespent,
+            spentdate: data.spentdate,
+            owner: data.owner,
+            memo: data.memo,
+        });
+        if (!response.data || response.data.length === 0) {
+            throw new Error('Failed to update timesheet: no data returned');
+        }
+        return response.data[0].Timesheet;
+    }
+    async deleteTimesheet(workspaceId, timesheetId) {
+        await this.request('POST', '/timesheets/delete', {
+            workspace_id: workspaceId,
+            id: timesheetId,
+        });
+        return true;
+    }
+    // ==================== Attachment List API ====================
+    async listAttachments(workspaceId, entityType, entityId, options) {
+        // TAPD /attachments uses singular type for filter
+        const tapdType = entityType.endsWith('s') ? entityType.slice(0, -1) : entityType;
+        const response = await this.request('GET', '/attachments', {
+            workspace_id: workspaceId,
+            entry_type: tapdType,
+            entry_id: entityId,
+            limit: options?.limit || 30,
+            page: options?.page || 1,
+        });
+        return (response.data || []).map(item => item.Attachment).filter(Boolean);
+    }
+    // ==================== Custom Fields Settings API ====================
+    async getCustomFieldsSettings(workspaceId, entryType = 'story') {
+        const response = await this.request('GET', '/stories/custom_fields_settings', { workspace_id: workspaceId, entry_type: entryType });
+        return (response.data || []).map(item => item.CustomFieldSetting).filter(Boolean);
+    }
     // ==================== Utility Methods ====================
     translateStoryStatus(status) {
         return STORY_STATUS_MAP[status] || status;