@xihe-lab/tapd-core 2.0.0-rc.1

package/dist/registry/richtext.test.js

@@ -0,0 +1,210 @@
+import assert from 'node:assert/strict';
+import { allTools } from '../tools/index.js';
+import { resolveWrite } from './write-policy.js';
+import { ToolRegistry } from './registry.js';
+import { SERVER_MD_TOOLS, WRITE_RICHTEXT_FIELDS_BY_TOOL, } from './richtext-manifests.generated.js';
+import { isRichtextAutoEnabled, looksLikeHtml, transformWriteArgs, transformReadData, READ_RICHTEXT_FIELDS, } from './richtext.js';
+const RICHTEXT_PARAM_FIELDS = ['description', 'markdown_description'];
+function withAutoOff(fn) {
+    process.env.TAPD_RICHTEXT_AUTO = '0';
+    try {
+        return fn();
+    }
+    finally {
+        delete process.env.TAPD_RICHTEXT_AUTO;
+    }
+}
+const checks = [
+    ['switch: enabled by default, env TAPD_RICHTEXT_AUTO=0 disables', () => {
+            delete process.env.TAPD_RICHTEXT_AUTO;
+            assert.equal(isRichtextAutoEnabled(), true);
+            assert.equal(withAutoOff(() => isRichtextAutoEnabled()), false);
+        }],
+    ['looksLikeHtml: block tags detected, plain markdown not', () => {
+            assert.equal(looksLikeHtml('<p>hi</p>'), true);
+            assert.equal(looksLikeHtml('标题<br>正文'), true);
+            assert.equal(looksLikeHtml('# 标题\n\n- 列表'), false);
+            assert.equal(looksLikeHtml('1 < 2 且 a>b'), false);
+        }],
+    ['write: markdown converted to html for client-side tools', () => {
+            const args = transformWriteArgs('tapd_create_story', {
+                name: 't',
+                description: '# 标题\n\n- a\n- b',
+            });
+            assert.equal(args.name, 't');
+            assert.match(args.description, /<h1>标题<\/h1>/);
+            assert.match(args.description, /<li>a<\/li>/);
+        }],
+    ['write: html passthrough unchanged (存量 HTML 零破坏)', () => {
+            const html = '<p>存量 <strong>HTML</strong></p>';
+            const args = transformWriteArgs('tapd_create_story', { description: html });
+            assert.equal(args.description, html);
+        }],
+    ['write: wiki markdown routed to server markdown_description', () => {
+            const args = transformWriteArgs('tapd_create_wiki', {
+                name: 'w',
+                description: '# wiki md',
+            });
+            assert.equal(args.description, undefined);
+            assert.equal(args.markdown_description, '# wiki md');
+        }],
+    ['write: wiki html passthrough keeps description', () => {
+            const html = '<p>wiki html</p>';
+            const args = transformWriteArgs('tapd_update_wiki', { id: '1', description: html });
+            assert.equal(args.description, html);
+            assert.equal(args.markdown_description, undefined);
+        }],
+    ['write: explicit markdown_description wins over converted description', () => {
+            const args = transformWriteArgs('tapd_create_wiki', {
+                name: 'w',
+                description: '# md from description',
+                markdown_description: '# explicit md',
+            });
+            assert.equal(args.markdown_description, '# explicit md');
+            assert.equal(args.description, undefined);
+        }],
+    ['write: switch off leaves args untouched', () => {
+            const md = '# 原样';
+            const out = withAutoOff(() => transformWriteArgs('tapd_create_story', { description: md }));
+            assert.equal(out.description, md);
+            const wiki = withAutoOff(() => transformWriteArgs('tapd_create_wiki', { description: md }));
+            assert.equal(wiki.description, md);
+            assert.equal(wiki.markdown_description, undefined);
+        }],
+    ['write: tools without richtext fields untouched', () => {
+            const args = transformWriteArgs('tapd_get_stories', { description: '# not a write tool' });
+            assert.equal(args.description, '# not a write tool');
+        }],
+    ['read: nested and array richtext fields converted to markdown', () => {
+            const data = {
+                data: {
+                    Story: { id: '1', description: '<h1>标题</h1><p><strong>加粗</strong></p>' },
+                    list: [{ id: '2', description: '<ul><li>项</li></ul>' }],
+                    info: { Comments: [{ id: '3', description: '<p>评论 <code>代码</code></p>' }] },
+                },
+            };
+            const result = transformReadData(data);
+            assert.equal(result.data.Story.id, '1');
+            assert.match(result.data.Story.description, /# 标题/);
+            assert.match(result.data.Story.description, /\*\*加粗\*\*/);
+            assert.match((result.data.list[0].description), /\*\s+项/);
+            assert.match((result.data.info.Comments[0].description), /评论 `代码`/);
+        }],
+    ['read: plain-text and non-richtext fields untouched', () => {
+            const data = {
+                description: '纯文本没有标签',
+                name: 'a<b 的名字',
+                note: '<p>note 不在富文本清单</p>',
+                nested: { description: '' },
+            };
+            const result = transformReadData(data);
+            assert.equal(result.description, '纯文本没有标签');
+            assert.equal(result.name, 'a<b 的名字');
+            assert.equal(result.note, '<p>note 不在富文本清单</p>');
+            assert.equal(result.nested.description, '');
+        }],
+    ['read: switch off returns raw html', () => {
+            const data = { description: '<p>raw</p>' };
+            const result = withAutoOff(() => transformReadData(data));
+            assert.equal(result, data);
+        }],
+    ['read: gfm tables and fenced code survive', () => {
+            const html = '<table><thead><tr><th>列</th></tr></thead><tbody><tr><td>值</td></tr></tbody></table><pre><code>echo hi</code></pre>';
+            const md = transformReadData({ description: html });
+            assert.match(md.description, /\|\s*列\s*\|/);
+            assert.match(md.description, /```\necho hi\n```/);
+        }],
+    ['exec: write tool receives converted html at client', async () => {
+            delete process.env.TAPD_RICHTEXT_AUTO;
+            let captured;
+            const registry = new ToolRegistry();
+            registry.register([allTools.find(t => t.name === 'tapd_create_story')]);
+            const result = await registry.exec('tapd_create_story', { name: 'zzz-delete-me', description: '# hi', workspace_id: 39814312, owner: 'x', workitem_type_id: '1139814312001000001' }, { entry: 'mcp' }, () => ({
+                post: (_path, body) => {
+                    captured = body;
+                    return Promise.resolve({ status: 1, data: {} });
+                },
+            }));
+            assert.equal(result.ok, true);
+            assert.match(captured?.description, /<h1>hi<\/h1>/);
+        }],
+    ['exec: read tool returns markdown description', async () => {
+            delete process.env.TAPD_RICHTEXT_AUTO;
+            const registry = new ToolRegistry();
+            registry.register([allTools.find(t => t.name === 'tapd_get_stories')]);
+            const result = await registry.exec('tapd_get_stories', { workspace_id: 39814312 }, { entry: 'mcp' }, () => ({
+                get: () => Promise.resolve({ status: 1, data: [{ id: '1', description: '<p>富文本 <strong>加粗</strong></p>' }] }),
+            }));
+            assert.equal(result.ok, true);
+            const data = result.data;
+            assert.match(data.data[0].description, /富文本 \*\*加粗\*\*/);
+        }],
+    ['exec: switch off keeps raw html on both sides', async () => {
+            process.env.TAPD_RICHTEXT_AUTO = '0';
+            try {
+                const registry = new ToolRegistry();
+                registry.register([allTools.find(t => t.name === 'tapd_create_story')]);
+                let captured;
+                const result = await registry.exec('tapd_create_story', { name: 'zzz-delete-me', description: '# 原样', workspace_id: 39814312, owner: 'x', workitem_type_id: '1139814312001000001' }, { entry: 'cli' }, () => ({
+                    post: (_path, body) => {
+                        captured = body;
+                        return Promise.resolve({ status: 1, data: {} });
+                    },
+                }));
+                assert.equal(result.ok, true);
+                assert.equal(captured?.description, '# 原样');
+            }
+            finally {
+                delete process.env.TAPD_RICHTEXT_AUTO;
+            }
+        }],
+    ['roundtrip: md -> html(write) -> md(read) -> html stays stable', () => {
+            delete process.env.TAPD_RICHTEXT_AUTO;
+            const markdown = '# 标题\n\n段落 **加粗** `code`。\n\n- a\n- b\n\n| x | y |\n|--|--|\n| 1 | 2 |';
+            const written = transformWriteArgs('tapd_create_story', { description: markdown });
+            const html1 = written.description;
+            const readBack = transformReadData({ description: html1 });
+            const written2 = transformWriteArgs('tapd_create_story', { description: readBack.description });
+            assert.equal(written2.description, html1);
+        }],
+    ['manifests: generated write-field list matches live schema scan', () => {
+            const scanned = {};
+            for (const tool of allTools) {
+                if (!resolveWrite(tool))
+                    continue;
+                const shape = tool.inputSchema.shape ?? {};
+                const fields = RICHTEXT_PARAM_FIELDS.filter(f => f in shape);
+                if (fields.length > 0)
+                    scanned[tool.name] = fields;
+            }
+            assert.deepEqual(WRITE_RICHTEXT_FIELDS_BY_TOOL, scanned);
+            assert.equal(Object.keys(scanned).length >= 25, true);
+            for (const name of SERVER_MD_TOOLS) {
+                assert.ok(scanned[name]?.includes('description'), name);
+                assert.ok(scanned[name]?.includes('markdown_description'), name);
+            }
+        }],
+    ['manifests: read fields cover TAPD richtext naming convention', () => {
+            assert.deepEqual([...READ_RICHTEXT_FIELDS].sort(), ['description']);
+        }],
+];
+let failed = 0;
+for (const [name, check] of checks) {
+    try {
+        await check();
+        console.log(`PASS ${name}`);
+    }
+    catch (error) {
+        failed++;
+        console.error(`FAIL ${name}`);
+        console.error(`  ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+if (failed > 0) {
+    console.error(`\n${failed}/${checks.length} failed`);
+    process.exitCode = 1;
+}
+else {
+    console.log(`\n${checks.length}/${checks.length} passed`);
+}
+//# sourceMappingURL=richtext.test.js.map

package/dist/registry/richtext.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"richtext.test.js","sourceRoot":"","sources":["../../src/registry/richtext.test.ts"],"names":[],"mappings":"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"}

package/dist/registry/write-policy.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDef } from '../types.js';
+export declare function resolveWrite(tool: ToolDef): boolean;
+//# sourceMappingURL=write-policy.d.ts.map

package/dist/registry/write-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-policy.d.ts","sourceRoot":"","sources":["../../src/registry/write-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAK3C,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAEnD"}

package/dist/registry/write-policy.js

@@ -0,0 +1,5 @@
+const WRITE_VERBS = /^(create|update|delete|add|copy|batch_update|save|remove|execute|lock|unlock|assign|bind|relate|link|submit|upload|set)_/;
+export function resolveWrite(tool) {
+    return tool.write ?? WRITE_VERBS.test(tool.name.replace(/^tapd_/, ''));
+}
+//# sourceMappingURL=write-policy.js.map

package/dist/registry/write-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-policy.js","sourceRoot":"","sources":["../../src/registry/write-policy.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GACf,0HAA0H,CAAC;AAE7H,MAAM,UAAU,YAAY,CAAC,IAAa;IACxC,OAAO,IAAI,CAAC,KAAK,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;AACzE,CAAC"}

package/dist/schema/export.d.ts

@@ -0,0 +1,12 @@
+import type { ToolDef } from '../types.js';
+export interface ToolSchema {
+    name: string;
+    description: string;
+    input_schema: Record<string, unknown>;
+}
+export type SchemaExportFormat = 'anthropic' | 'openai';
+export interface SchemaFilter {
+    resource?: string;
+}
+export declare function exportSchemas(tools: ToolDef[], format: SchemaExportFormat, filter?: SchemaFilter): unknown;
+//# sourceMappingURL=export.d.ts.map

package/dist/schema/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/schema/export.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,QAAQ,CAAC;AAExD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA+BD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAO1G"}

package/dist/schema/export.js

@@ -0,0 +1,39 @@
+import * as z4mini from 'zod/v4-mini';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { deriveCommand } from '../registry/derive-command.js';
+// 与 @modelcontextprotocol/sdk v3 分支的转换参数一致，保证与 tools/list 的 inputSchema 等价
+const TO_JSON_SCHEMA_OPTIONS = {
+    strictUnions: true,
+    pipeStrategy: 'input',
+};
+// MCP 侧空 shape 会经 objectFromShape 落到 zod v4-mini 转换，产物无 additionalProperties，
+// 此处走同一条路径保持字节级一致
+function toInputSchema(inputSchema) {
+    const shape = inputSchema.shape;
+    if (shape && Object.keys(shape).length === 0) {
+        return z4mini.toJSONSchema(z4mini.object({}), { target: 'draft-7', io: 'input' });
+    }
+    return zodToJsonSchema(inputSchema, TO_JSON_SCHEMA_OPTIONS);
+}
+function toToolSchema(tool) {
+    return {
+        name: tool.name,
+        description: tool.description,
+        input_schema: toInputSchema(tool.inputSchema),
+    };
+}
+function applyFilter(tools, filter) {
+    if (!filter?.resource)
+        return tools;
+    return tools.filter(tool => deriveCommand(tool.name).resource === filter.resource);
+}
+export function exportSchemas(tools, format, filter) {
+    const list = applyFilter(tools, filter).map(toToolSchema);
+    if (format === 'anthropic')
+        return list;
+    return list.map(t => ({
+        type: 'function',
+        function: { name: t.name, description: t.description, parameters: t.input_schema },
+    }));
+}
+//# sourceMappingURL=export.js.map

package/dist/schema/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/schema/export.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAe9D,2EAA2E;AAC3E,MAAM,sBAAsB,GAAqD;IAC/E,YAAY,EAAE,IAAI;IAClB,YAAY,EAAE,OAAO;CACtB,CAAC;AAEF,8EAA8E;AAC9E,kBAAkB;AAClB,SAAS,aAAa,CAAC,WAAoB;IACzC,MAAM,KAAK,GAAI,WAAmD,CAAC,KAAK,CAAC;IACzE,IAAI,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7C,OAAO,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,eAAe,CAAC,WAAwB,EAAE,sBAAsB,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,YAAY,CAAC,IAAa;IACjC,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,YAAY,EAAE,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,KAAgB,EAAE,MAAqB;IAC1D,IAAI,CAAC,MAAM,EAAE,QAAQ;QAAE,OAAO,KAAK,CAAC;IACpC,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAgB,EAAE,MAA0B,EAAE,MAAqB;IAC/F,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC1D,IAAI,MAAM,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IACxC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACpB,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC,YAAY,EAAE;KACnF,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/schema/export.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=export.test.d.ts.map

package/dist/schema/export.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.test.d.ts","sourceRoot":"","sources":["../../src/schema/export.test.ts"],"names":[],"mappings":""}

package/dist/schema/export.test.js

@@ -0,0 +1,68 @@
+import assert from 'node:assert/strict';
+import { z } from 'zod';
+import { exportSchemas } from './export.js';
+function makeTool(overrides) {
+    return {
+        description: '获取需求列表',
+        inputSchema: z.object({ id: z.string().describe('需求ID') }),
+        handler: () => Promise.resolve({ done: true }),
+        ...overrides,
+    };
+}
+const tools = [
+    makeTool({ name: 'tapd_get_stories', cli: { resource: 'story', action: 'list' } }),
+    makeTool({ name: 'tapd_create_story', cli: { resource: 'story', action: 'create' } }),
+    makeTool({ name: 'tapd_get_bugs', cli: { resource: 'bug', action: 'list' } }),
+];
+const checks = [
+    ['anthropic format returns name/description/input_schema list', () => {
+            const result = exportSchemas(tools, 'anthropic');
+            assert.equal(result.length, 3);
+            const first = result[0];
+            assert.equal(first.name, 'tapd_get_stories');
+            assert.equal(first.description, '获取需求列表');
+            assert.equal(first.input_schema.type, 'object');
+        }],
+    ['input_schema converts zod object to JSON schema', () => {
+            const result = exportSchemas(tools, 'anthropic');
+            const schema = result[0].input_schema;
+            assert.equal(schema.properties.id.type, 'string');
+            assert.equal(schema.properties.id.description, '需求ID');
+            assert.deepEqual(schema.required, ['id']);
+        }],
+    ['openai format wraps in function calling shape', () => {
+            const result = exportSchemas(tools, 'openai');
+            assert.equal(result.length, 3);
+            const first = result[0];
+            assert.equal(first.type, 'function');
+            assert.equal(first.function.name, 'tapd_get_stories');
+            assert.equal(first.function.description, '获取需求列表');
+            assert.equal(first.function.parameters.type, 'object');
+        }],
+    ['filter.resource keeps only derived resource match', () => {
+            const result = exportSchemas(tools, 'anthropic', { resource: 'story' });
+            assert.deepEqual(result.map(t => t.name).sort(), ['tapd_create_story', 'tapd_get_stories']);
+        }],
+    ['no filter returns all tools', () => {
+            const result = exportSchemas(tools, 'openai', {});
+            assert.equal(result.length, 3);
+        }],
+];
+let failed = 0;
+for (const [name, check] of checks) {
+    try {
+        await check();
+        console.log(`PASS: ${name}`);
+    }
+    catch (error) {
+        failed++;
+        console.error(`FAIL: ${name}`);
+        console.error(error instanceof Error ? error.message : error);
+    }
+}
+if (failed > 0) {
+    console.error(`${failed}/${checks.length} checks failed`);
+    process.exit(1);
+}
+console.log(`${checks.length}/${checks.length} checks passed`);
+//# sourceMappingURL=export.test.js.map

package/dist/schema/export.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.test.js","sourceRoot":"","sources":["../../src/schema/export.test.ts"],"names":[],"mappings":"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"}

package/dist/sdk-routes.d.ts

@@ -0,0 +1,9 @@
+export type RouteKey = `${'GET' | 'POST'} ${string}`;
+/**
+ * SDK route table: `METHOD /path` -> @opentapd/tapd-node-sdk method name.
+ * Covers every API path the 210 tool handlers call that exists in the SDK (1.68.0).
+ * Unlisted paths go through the original fetch path.
+ * Validate with `pnpm validate:sdk-routes` (fails on SDK upgrade drift).
+ */
+export declare const SDK_ROUTES: Partial<Record<RouteKey, string>>;
+//# sourceMappingURL=sdk-routes.d.ts.map

package/dist/sdk-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-routes.d.ts","sourceRoot":"","sources":["../src/sdk-routes.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,GAAG,KAAK,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAErD;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAgLxD,CAAC"}

package/dist/sdk-routes.js

@@ -0,0 +1,148 @@
+/**
+ * SDK route table: `METHOD /path` -> @opentapd/tapd-node-sdk method name.
+ * Covers every API path the 210 tool handlers call that exists in the SDK (1.68.0).
+ * Unlisted paths go through the original fetch path.
+ * Validate with `pnpm validate:sdk-routes` (fails on SDK upgrade drift).
+ */
+export const SDK_ROUTES = {
+    // attachments
+    'GET /attachments': 'getAttachments',
+    'GET /attachments/down': 'downloadAttachment',
+    // board-cards
+    'GET /board_cards': 'getBoardCards',
+    // board-columns
+    'GET /board_columns': 'getBoardColumns',
+    // bug-changes
+    'GET /bug_changes': 'getBugChanges',
+    'GET /bug_changes/count': 'getBugChangesCount',
+    // bugs
+    'GET /bugs': 'getBugs',
+    'GET /bugs/count': 'getBugsCount',
+    'GET /bugs/custom_fields_settings': 'getBugCustomFieldsSettings',
+    'GET /bugs/get_fields_info': 'getBugFieldsInfo',
+    'GET /bugs/get_link_bugs': 'getLinkBugs',
+    'GET /bugs/get_related_stories': 'getRelatedStories',
+    'POST /bugs': 'addBug', // multiple SDK methods share this path (add/update equivalent, FSD §2.4#5)
+    // code-commit-infos
+    'GET /code_commit_infos': 'getCodeCommitInfos',
+    // comments
+    'GET /comments': 'getComments',
+    'GET /comments/count': 'getCommentsCount',
+    'POST /comments': 'addComment', // multiple SDK methods share this path (add/update equivalent, FSD §2.4#5)
+    // files
+    'GET /files/get_image': 'getImage',
+    // iterations
+    'GET /iterations': 'getIterations',
+    'GET /iterations/count': 'getIterationsCount',
+    'GET /iterations/custom_fields_settings': 'getIterationCustomFieldsSettings',
+    'POST /iterations': 'addIteration', // multiple SDK methods share this path (add/update equivalent, FSD §2.4#5)
+    // launch-accessories
+    'GET /launch_accessories': 'getLaunchAccessories',
+    // life-times
+    'GET /life_times': 'getLifeTimes',
+    // mini-item-categories
+    'GET /mini_item_categories': 'getMiniItemCategories',
+    // mini-item-changes
+    'GET /mini_item_changes': 'getMiniItemChanges',
+    // mini-items
+    'GET /mini_items': 'getMiniItems',
+    'GET /mini_items/count': 'getMiniItemsCount',
+    'POST /mini_items': 'addMiniItem', // multiple SDK methods share this path (add/update equivalent, FSD §2.4#5)
+    // releases
+    'GET /releases': 'getReleases',
+    'GET /releases/count': 'getReleasesCount',
+    'POST /releases': 'addRelease', // multiple SDK methods share this path (add/update equivalent, FSD §2.4#5)
+    // roles
+    'GET /roles': 'getRoles',
+    // stories
+    'GET /stories': 'getStories',
+    'GET /stories/count': 'getStoriesCount',
+    'GET /stories/custom_fields_settings': 'getStoryCustomFieldsSettings',
+    'GET /stories/get_link_stories': 'getLinkStories',
+    'GET /stories/get_related_bugs': 'getStoryRelatedBugs',
+    'POST /stories': 'addStory', // multiple SDK methods share this path (add/update equivalent, FSD §2.4#5)
+    'POST /stories/add_story_link_relations': 'addStoryLinkRelations',
+    'POST /stories/change_workitem_type': 'changeWorkitemType',
+    'POST /stories/remove_story_link_relation': 'removeStoryLinkRelation',
+    // story-categories
+    'GET /story_categories': 'getStoryCategories',
+    'GET /story_categories/count': 'getStoryCategoriesCount',
+    // story-changes
+    'GET /story_changes': 'getStoryChanges',
+    'GET /story_changes/count': 'getStoryChangesCount',
+    // tapd-wikis
+    'GET /tapd_wikis': 'getTapdWikis',
+    'GET /tapd_wikis/count': 'getTapdWikisCount',
+    'POST /tapd_wikis': 'addTapdWiki', // multiple SDK methods share this path (add/update equivalent, FSD §2.4#5)
+    // tapd-wikis-attachments
+    'GET /tapd_wikis_attachments/count': 'getTapdWikisAttachmentsCount',
+    // tapd-wikis-drawios
+    'GET /tapd_wikis_drawios': 'getTapdWikisDrawios',
+    // tapd-wikis-entity-permissions
+    'GET /tapd_wikis_entity_permissions': 'getTapdWikisEntityPermissions',
+    // tapd-wikis-followers
+    'GET /tapd_wikis_followers': 'getTapdWikisFollowers',
+    'GET /tapd_wikis_followers/count': 'getTapdWikisFollowersCount',
+    // tapd-wikis-tags
+    'GET /tapd_wikis_tags': 'getTapdWikisTags',
+    'GET /tapd_wikis_tags/count': 'getTapdWikisTagsCount',
+    // task-changes
+    'GET /task_changes': 'getTaskChanges',
+    'GET /task_changes/count': 'getTaskChangesCount',
+    // tasks
+    'GET /tasks': 'getTasks',
+    'GET /tasks/count': 'getTasksCount',
+    'GET /tasks/custom_fields_settings': 'getTaskCustomFieldsSettings',
+    'GET /tasks/get_fields_info': 'getTaskFieldsInfo',
+    'POST /tasks': 'addTask', // multiple SDK methods share this path (add/update equivalent, FSD §2.4#5)
+    // tcase-categories
+    'GET /tcase_categories': 'getTcaseCategories',
+    'GET /tcase_categories/count': 'getTcaseCategoriesCount',
+    'POST /tcase_categories': 'addTcaseCategory',
+    // tcase-instance
+    'GET /tcase_instance/result': 'getTcaseResult',
+    'POST /tcase_instance/assign': 'assignTcaseInstance',
+    'POST /tcase_instance/delete_tcase_story_relation': 'deleteTcaseStoryRelation',
+    'POST /tcase_instance/execute': 'executeTcaseInstance',
+    'POST /tcase_instance/remove_tcase': 'removeTcaseInstance',
+    // tcases
+    'GET /tcases': 'getTcases',
+    'GET /tcases/count': 'getTcasesCount',
+    'GET /tcases/custom_fields_settings': 'getTcaseCustomFieldsSettings',
+    'GET /tcases/get_fields_info': 'getTcaseFieldsInfo',
+    'GET /tcases/get_story_by_tcase_id': 'getStoryByTcaseId',
+    'POST /tcases': 'addTcase', // multiple SDK methods share this path (add/update equivalent, FSD §2.4#5)
+    // test-plans
+    'GET /test_plans': 'getTestPlans',
+    'GET /test_plans/count': 'getTestPlansCount',
+    'GET /test_plans/details': 'getTestPlanDetails',
+    'GET /test_plans/get_fields_info': 'getTestPlanFieldsInfo',
+    'GET /test_plans/get_relative_stories': 'getTestPlanRelativeStories',
+    'GET /test_plans/get_test_plan_tcase': 'getTestPlanTcases',
+    'GET /test_plans/progress': 'getTestPlanProgress',
+    'GET /test_plans/result_relation_bugs': 'getTestPlanBugs',
+    'POST /test_plans': 'addTestPlan', // multiple SDK methods share this path (add/update equivalent, FSD §2.4#5)
+    'POST /test_plans/create_story_relation': 'createStoryRelation',
+    'POST /test_plans/create_tcase_relation': 'createTcaseRelation',
+    'POST /test_plans/delete_story_relation': 'deleteStoryRelation',
+    // timesheets
+    'GET /timesheets': 'getTimesheets',
+    'GET /timesheets/count': 'getTimesheetsCount',
+    'POST /timesheets': 'addTimesheet', // multiple SDK methods share this path (add/update equivalent, FSD §2.4#5)
+    // users
+    'GET /users': 'getUsers',
+    // workflows
+    'GET /workflows': 'getWorkflows',
+    'GET /workflows/all_transitions': 'getWorkflowAllTransitions',
+    'GET /workflows/first_step': 'getWorkflowFirstStep',
+    'GET /workflows/last_steps': 'getWorkflowLastSteps',
+    'GET /workflows/status_map': 'getWorkflowStatusMap',
+    // workitem-types
+    'GET /workitem_types': 'getWorkitemTypes',
+    // workspaces
+    'GET /workspaces/get_workspace_info': 'getWorkspaceInfo', // multiple SDK methods share this path (add/update equivalent, FSD §2.4#5)
+    'GET /workspaces/sub_workspaces': 'getSubWorkspaces',
+    'GET /workspaces/user_participant_projects': 'userParticipantProjects',
+    'GET /workspaces/users': 'getWorkspaceUsers', // multiple SDK methods share this path (add/update equivalent, FSD §2.4#5)
+};
+//# sourceMappingURL=sdk-routes.js.map

package/dist/sdk-routes.js.map

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