@cloudglab/zentao-cli 0.1.3

package/README.md

@@ -0,0 +1,319 @@
+# @cloudglab/zentao-cli
+
+基于 TypeScript 重建的禅道命令行工具，优先适配当前禅道 `18.5` 的 REST v1 API。
+
+![zentao-cli hero](./assets/readme/zentao-cli-hero.png)
+
+> 把任务、Bug、需求、测试、计划、构建、发布这些禅道操作，直接接进本地 `zentao` 命令，给命令行、脚本和 skill 调用。
+
+## 亮点
+
+- `60` 个 CLI 命令，覆盖任务、Bug、需求、执行、测试、计划、构建、发布、搜索等核心场景
+- `4` 个内置角色：`Dev / QA / PM / Full`
+- 基于 TypeScript 重建，优先适配禅道 `18.5` REST v1 API
+- 发布产物运行时目标：`Node.js >= 16`
+- 默认写保护，写操作需要显式开启并确认，更适合接入智能体和自动化流程
+
+## 快速开始
+
+环境要求：`Node.js >= 16`
+
+### 安装
+
+```bash
+# 运行时要求：Node.js >= 16
+
+# 直接运行
+npx -y @cloudglab/zentao-cli@latest
+
+# 全局安装
+npm i -g @cloudglab/zentao-cli@latest
+```
+
+### 配置
+
+```bash
+export ZENTAO_URL="https://your-zentao.example.com"
+export ZENTAO_USERNAME="your-account"
+export ZENTAO_PASSWORD="your-password"
+export ZENTAO_API_VERSION="v1"
+
+# 可选：非标准部署时指定完整 API 基础地址
+# export ZENTAO_API_BASE_URL="https://your-zentao.example.com/custom/api.php/v1"
+```
+
+### 运行
+
+```bash
+# 查看帮助 / 版本
+zentao help
+zentao --version
+
+# 默认 full 角色
+zentao list
+zentao getMyTasks --status all --limit 20
+
+# 按角色启动
+zentao --role dev getMyTasks --status all
+zentao --role qa getMyBugs --limit 50
+zentao --role pm getProducts
+
+# 也可以直接用 npx
+npx -y @cloudglab/zentao-cli@latest --role qa getMyBugs --limit 50
+```
+
+## 使用方式
+
+### CLI
+
+适合手动查数据、排查问题、批量执行脚本。
+
+常见场景：
+- 查我的任务 / Bug / 统计
+- 查询需求、执行、计划、构建、发布
+- 创建或更新任务、测试用例、测试单
+- 做任务流转、Bug 处理、批量排期、回填工时、同步状态
+- 通过 `Dev / QA / PM / Full` 角色入口提供差异化能力
+
+### 智能体 / Skill 接入建议
+
+推荐顺序：
+
+1. 先检查本机有没有 `zentao`
+2. 没有就安装：`npm i -g @cloudglab/zentao-cli@latest`
+3. skill 内优先调用本地 `zentao`
+4. 只在不能安装时，才退回 `npx -y @cloudglab/zentao-cli@latest`
+
+常用检查命令：
+
+```bash
+command -v zentao
+zentao --version
+```
+
+skill / 自动化里推荐直接执行：
+
+```bash
+zentao --role qa getMyBugs --limit 50
+zentao getProductBugs --productId 123 --status all --limit 100
+```
+
+### Skill
+
+适合把当前能力包装成可复用的 AI Skill，对外推广更友好。
+
+相关文档：
+- `skills/zentao-cli/reference/overview.md`
+- `skills/zentao-cli/reference/install.md`
+
+安装 skill 时，统一走：
+
+```bash
+npx skills add @cloudglab/zentao-cli -g
+```
+
+skill 内部入口建议：
+
+- 优先：`zentao`
+- 或按角色：`zentao --role qa`
+- 无本地安装时兜底：`npx -y @cloudglab/zentao-cli@latest`
+
+适合场景：
+- 给团队成员提供统一入口
+- 给非开发用户提供更低门槛的禅道操作方式
+- 做内部推广和标准化接入
+
+## 当前 MVP 能力
+
+- token 登录：仅在明确鉴权失败时才从明文密码回退到 MD5
+- 登录错误分类：区分账号密码错误、token 接口不存在、网络失败、服务端异常
+- 自动清洗 PHP warning + JSON 混合响应
+- `getMyTasks`
+- `getTaskDetail`
+- `getBugDetail`
+- `getStoryDetail`
+- `getExecutionDetail`
+- `getExecutionBugs`
+- `getMyBugs`
+- `getProductBugs`
+- `getComments`
+- 写操作 preview：`updateTask`、`finishTask`、`resolveBug`、`addComment`
+- `getMyProfile`
+- `getMyTaskStatistics`
+- `getMyBugStatistics`
+- `getStoryRelatedBugs`
+- `getBugRelatedStory`
+- `getDevelopmentContext`
+- `getProducts` / `getProductDetail`
+- `getProjects` / `getProjectDetail`
+- `getProjectExecutions` / `getExecutionBuilds`
+- `getProductStories`
+- `getProductTestCases` / `getTestCaseDetail`
+- `getTestTasks` / `getTestTaskDetail`
+- `getPrograms` / `getProgramDetail`
+- `getProductPlans` / `getPlanDetail`
+- `getProjectBuilds` / `getBuildDetail`
+- `getProjectReleases`
+- `searchStories`
+- `searchStoriesByProductName`
+- `updateStory` / `changeStory`（默认 preview）
+- `createTaskFromStory` / `createTaskFromBug`（默认 preview）
+- `linkStoriesToPlan` / `unlinkStoriesFromPlan`（默认 preview）
+- `linkBugsToPlan` / `unlinkBugsFromPlan`（默认 preview）
+- `updateExecution` / `startExecution` / `closeExecution` / `suspendExecution` / `activateExecution` / `putoffExecution`（默认 preview）
+- `createBuild` / `updateBuild`（默认 preview）
+- `createTestCase` / `updateTestCase`（默认 preview）
+- `createTestTask` / `updateTestTask`（默认 preview）
+
+`updateExecution` 按禅道 18.5 REST v1 文档/源码需要保留/传入：
+
+- `project`
+- `name`
+- `code`
+- `begin`
+- `end`
+
+注意：`updateExecution` 在禅道 18.5 且后台启用代号时存在服务端源码问题：`api/v1/entries/execution.php` 中 `$fields .= 'code'` 缺少前置逗号，导致请求体里的 `code` 不会进入服务端 `$_POST`，服务端会误报 `『迭代代号』不能为空。`。客户端无法稳定绕过；工具仍保留，但调用时会直接返回该诊断错误，不做真实写入。
+
+`createBuild` 当前按禅道 18.5 实机/参考包契约使用 `POST /projects/{project}/builds`，通常需要提供：
+
+- `project`
+- `execution`
+- `product`
+- `name`
+- `builder`
+
+补充说明：
+
+- `createTaskFromStory` / `createTaskFromBug` 在当前实例上实机验证发现通常需要额外提供：
+  - `assignedTo`
+  - `estStarted`
+  - `deadline`
+- `createTaskFromBug` 当前只保证：
+  - 基于 Bug 预填任务内容并尝试创建任务
+  - 不保证创建后自动建立 Bug 关联
+- 角色工具过滤：`full` / `dev` / `qa` / `pm`
+- 写操作保护 helper：默认禁用写操作，后续写工具必须配合 `ZENTAO_ENABLE_WRITE=true` 和 `confirm: true`；已知 18.5 不支持或服务端有缺陷的写工具会保留入口，但调用时直接返回明确诊断错误。
+- Phase 3B 写工具（execution / build / testcase / testtask）默认同样返回 preview，真实执行仍需 `ZENTAO_ENABLE_WRITE=true` + `confirm=true`：
+  - execution：`updateExecution` / `startExecution` / `closeExecution` / `suspendExecution` / `activateExecution` / `putoffExecution`
+  - build：`createBuild` / `updateBuild`
+  - testcase：`createTestCase` / `updateTestCase`
+  - testtask：`createTestTask` / `updateTestTask`
+  - 角色权限：
+    - `full` 拥有 `execution-write` + `build-write` + `testcase-write` + `testtask-write`
+    - `dev` 拥有 `execution-write` + `build-write`
+    - `pm` 仅拥有 `execution-write`
+    - `qa` 拥有 `testcase-write` + `testtask-write`
+- `createTestCase` / `updateTestCase` 当前按禅道 18.5 REST v1 契约：
+  - 创建路径：`POST /products/{productId}/testcases`
+  - 更新路径：`PUT /testcases/{testCaseId}`
+  - `steps` 数组每项形如 `{ desc, expect, type? }`，`type` 支持 `step` / `item` / `group`，默认 `step`
+  - `module` / `story` 允许传 `0` 表示无模块 / 无关联需求
+- `project` / `execution` / `keywords` 不是禅道 18.5 REST v1 用例创建/更新 entry 接收字段，传入会被服务端忽略；18.5 v1 创建的是产品用例，不会直接绑定项目/执行。
+- `createTestTask` 当前按禅道 18.5 REST v1 契约：
+  - 创建路径：`POST /projects/{project}/testtasks`
+  - 创建必填：`project` / `productID` / `name` / `build` / `begin` / `end`，`begin` / `end` 格式 `YYYY-MM-DD`
+  - 创建请求体实际使用 `product` 字段，工具入参保留 `productID` 并在 API 层映射
+  - `build` 兼容数字 ID 和字符串 ID
+  - `createTestTask` 当前实例真实写验证通过
+- `updateTestTask`：禅道 18.5 v1 `api/v1/entries/testtask.php` 只有 `get/delete`，没有 `put` 更新入口。工具仍保留，但调用时会直接返回该诊断错误，不做真实写入。
+- `linkBugsToPlan` 已按 18.5 源码修正为 `POST /productplans/{planId}/linkbugs`。
+- `finishTask` 已按 18.5 源码改为 `POST /tasks/{taskId}/finish`，需要 `currentConsumed` / `realStarted` / `finishedDate`。
+- `addComment`：禅道 18.5 v1 没有 `comment/comments` entry，当前只支持 `getComments` 从对象详情 actions 回退读取；`addComment` 工具仍保留，但调用时会直接返回该诊断错误。
+- token 失效后自动重试一次
+- 可选 `ZENTAO_API_BASE_URL`：用于非标准 `/zentao/api.php/v1` 部署
+
+## 配置
+
+说明：
+
+- `getMyBugs` 当前默认语义是“跨所有产品指派给我的 Bug”；传 `productId` 时收窄到指定产品。
+- `getMyBugStatistics` 默认统计跨所有产品指派给我的 Bug；传 `productId` 时收窄到指定产品。
+- `getComments` 在禅道 18.5 上会 fallback 到对象详情里的 `actions`，返回结果会明确标注 `source: "actions-fallback"`。
+- `updateTask` / `finishTask` 不会默认修改 `assignedTo`，只有显式传入才会更新指派人。
+
+支持环境变量：
+
+```bash
+export ZENTAO_URL="https://zentao.cloudglab.cn"
+export ZENTAO_USERNAME="your-account"
+export ZENTAO_PASSWORD="your-password"
+export ZENTAO_API_VERSION="v1"
+# 可选：非标准部署时直接指定完整 API 基础地址
+# export ZENTAO_API_BASE_URL="https://zentao.cloudglab.cn/custom/api.php/v1"
+```
+
+注意：`ZENTAO_URL` 传根域名即可，不要带 `/zentao`。
+
+`initZentao` 现在默认只校验并在当前进程内生效，不会自动把密码写入 `~/.zentao/config.json`。
+只有显式传 `save: true` 才会落盘。
+
+## 开发
+
+```bash
+pnpm install
+pnpm typecheck
+pnpm build
+```
+
+## 发布链路
+
+已内置 GitHub Actions：当你 push 形如 `v*` 的 tag 时，会自动：
+
+1. 安装依赖
+2. 执行 `pnpm typecheck`
+3. 执行 `pnpm build`
+4. 发布 npm 包到 registry
+5. 自动创建对应 GitHub Release
+
+工作流文件：
+
+- `.github/workflows/publish.yml`
+
+### 使用前准备
+
+1. 先把代码推到 GitHub 仓库
+2. 在 npm 上为 `@cloudglab/zentao-cli` 配置 GitHub Actions trusted publisher，绑定仓库 `cloudglab/zentao-cli`
+3. 确保 `package.json` 中的 `version` 与你要打的 tag 一致
+
+### 发版方式
+
+例如当前 `package.json` 版本是 `0.1.0`，则发版命令：
+
+```bash
+git tag v0.1.0
+git push origin v0.1.0
+```
+
+工作流会校验：
+
+- tag `v0.1.0` 是否与 `package.json` 中的 `0.1.0` 一致
+
+如果不一致，Action 会直接失败，避免把错误版本发布到 npm。
+
+### 推荐顺序
+
+```bash
+# 1. 修改 package.json version
+# 2. 提交代码
+# 3. 推送分支
+# 4. 打 tag
+git tag v0.1.0
+git push origin main
+git push origin v0.1.0
+```
+
+### 当前还未自动完成的部分
+
+下面这些仍需要你首次手动完成一次：
+
+- 初始化本地 git 仓库
+- 首次 commit
+- 创建 GitHub 仓库并 push 上去
+- 在 npm 包侧完成 trusted publisher 绑定
+
+## 启动
+
+```bash
+pnpm dev
+```

package/dist/api/bug.d.ts

@@ -0,0 +1,32 @@
+import type { ZentaoHttpClient } from '../core/http.js';
+import { type PaginationInput } from '../core/pagination.js';
+import type { ZentaoBug } from '../types/zentao.js';
+export interface BugListParams extends PaginationInput {
+    productId: number;
+    status?: string;
+    branch?: string;
+    order?: string;
+}
+export interface ResolveBugInput {
+    resolution: 'fixed' | 'bydesign' | 'duplicate' | 'external' | 'notrepro' | 'postponed' | 'willnotfix';
+    resolvedBuild?: string;
+    resolvedDate?: string;
+    assignedTo?: string;
+    comment?: string;
+    duplicateBug?: number;
+}
+export interface MyBugListParams extends PaginationInput {
+    productId?: number;
+    branch?: string;
+    order?: string;
+}
+export declare class BugApi {
+    private readonly http;
+    constructor(http: ZentaoHttpClient);
+    getMyBugs(params?: MyBugListParams): Promise<unknown>;
+    getProductBugs(params: BugListParams): Promise<unknown>;
+    getBugDetail(bugId: number): Promise<ZentaoBug>;
+    resolveBug(bugId: number, input: ResolveBugInput): Promise<unknown>;
+    private getAllMyBugsInProduct;
+    private sortBugs;
+}

package/dist/api/bug.js

@@ -0,0 +1,85 @@
+import { toClientPaginatedListResult, toServerListResult } from '../core/list-result.js';
+import { normalizePagination } from '../core/pagination.js';
+export class BugApi {
+    constructor(http) {
+        this.http = http;
+    }
+    async getMyBugs(params = {}) {
+        if (params.productId) {
+            return this.getProductBugs({ ...params, productId: params.productId, status: 'assigntome' });
+        }
+        const response = await this.http.request('GET', '/products');
+        const productsResult = toServerListResult(response, ['products']);
+        const products = productsResult.items;
+        const allBugs = [];
+        for (const product of products) {
+            const productId = product.id;
+            if (!productId)
+                continue;
+            const bugs = await this.getAllMyBugsInProduct({
+                productId,
+                branch: params.branch,
+                order: params.order,
+            });
+            allBugs.push(...bugs.map((bug) => ({
+                ...bug,
+                product: bug.product ?? productId,
+                productName: bug.productName ?? product.name,
+            })));
+        }
+        const sorted = this.sortBugs(allBugs, params.order);
+        const paginated = toClientPaginatedListResult({ bugs: sorted }, ['bugs'], params);
+        return {
+            ...paginated,
+            scope: 'global-assigntome',
+            scannedProducts: products.length,
+        };
+    }
+    async getProductBugs(params) {
+        const pagination = normalizePagination(params);
+        const response = await this.http.request('GET', `/products/${params.productId}/bugs`, {
+            params: {
+                ...pagination,
+                branch: params.branch ?? 'all',
+                order: params.order ?? 'id_desc',
+                status: params.status === 'all' ? undefined : params.status,
+            },
+        });
+        return toServerListResult(response, ['bugs'], params);
+    }
+    async getBugDetail(bugId) {
+        return this.http.request('GET', `/bugs/${bugId}`);
+    }
+    async resolveBug(bugId, input) {
+        const payload = { ...input };
+        if (payload.resolution === 'fixed' && !payload.resolvedBuild)
+            payload.resolvedBuild = 'trunk';
+        if (payload.resolution === 'duplicate' && !payload.duplicateBug) {
+            throw new Error('resolution=duplicate 时必须提供 duplicateBug');
+        }
+        return this.http.request('POST', `/bugs/${bugId}/resolve`, { data: payload });
+    }
+    async getAllMyBugsInProduct(params) {
+        const limit = 100;
+        const firstPage = await this.getProductBugs({ ...params, status: 'assigntome', page: 1, limit });
+        const bugs = [...firstPage.items];
+        const total = firstPage.total ?? bugs.length;
+        const totalPages = Math.ceil(total / limit);
+        for (let page = 2; page <= totalPages; page += 1) {
+            const response = await this.getProductBugs({ ...params, status: 'assigntome', page, limit });
+            bugs.push(...response.items);
+        }
+        return bugs;
+    }
+    sortBugs(bugs, order) {
+        const normalizedOrder = (order ?? 'id_desc').toLowerCase();
+        const sorted = [...bugs];
+        if (normalizedOrder === 'id_asc') {
+            sorted.sort((a, b) => a.id - b.id);
+            return sorted;
+        }
+        sorted.sort((a, b) => b.id - a.id);
+        return sorted;
+    }
+}
+//# sourceMappingURL=bug.js.map

package/dist/api/bug.js.map

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

package/dist/api/build.d.ts

@@ -0,0 +1,31 @@
+import type { ZentaoHttpClient } from '../core/http.js';
+export interface CreateBuildInput {
+    project: number;
+    execution: number;
+    product: number;
+    branch?: number;
+    name: string;
+    builder: string;
+    date?: string;
+    desc?: string;
+    scmPath?: string;
+    filePath?: string;
+}
+export interface UpdateBuildInput {
+    execution?: number;
+    product?: number;
+    name?: string;
+    builder?: string;
+    date?: string;
+    desc?: string;
+    scmPath?: string;
+    filePath?: string;
+}
+export declare class BuildApi {
+    private readonly http;
+    constructor(http: ZentaoHttpClient);
+    getProjectBuilds(projectId: number): Promise<unknown>;
+    getBuildDetail(buildId: number): Promise<unknown>;
+    createBuild(payload: CreateBuildInput): Promise<unknown>;
+    updateBuild(buildId: number, update: UpdateBuildInput): Promise<unknown>;
+}

package/dist/api/build.js

@@ -0,0 +1,21 @@
+import { toServerListResult } from '../core/list-result.js';
+export class BuildApi {
+    constructor(http) {
+        this.http = http;
+    }
+    async getProjectBuilds(projectId) {
+        const response = await this.http.request('GET', `/projects/${projectId}/builds`);
+        return toServerListResult(response, ['builds']);
+    }
+    async getBuildDetail(buildId) {
+        return this.http.request('GET', `/builds/${buildId}`);
+    }
+    async createBuild(payload) {
+        const { project, ...build } = payload;
+        return this.http.request('POST', `/projects/${project}/builds`, { data: build });
+    }
+    async updateBuild(buildId, update) {
+        return this.http.request('PUT', `/builds/${buildId}`, { data: update });
+    }
+}
+//# sourceMappingURL=build.js.map

package/dist/api/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/api/build.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AA0B5D,MAAM,OAAO,QAAQ;IACnB,YAA6B,IAAsB;QAAtB,SAAI,GAAJ,IAAI,CAAkB;IAAG,CAAC;IAEvD,KAAK,CAAC,gBAAgB,CAAC,SAAiB;QACtC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,aAAa,SAAS,SAAS,CAAC,CAAC;QACjF,OAAO,kBAAkB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,OAAe;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,WAAW,OAAO,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAyB;QACzC,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;QACtC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,aAAa,OAAO,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACnF,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE,MAAwB;QACzD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,WAAW,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1E,CAAC;CACF"}

package/dist/api/comment.d.ts

@@ -0,0 +1,20 @@
+import type { ZentaoHttpClient } from '../core/http.js';
+export type CommentObjectType = 'task' | 'bug' | 'story' | 'product' | 'project' | 'execution' | string;
+export interface AddCommentInput {
+    objectType: CommentObjectType;
+    objectID: number;
+    comment: string;
+}
+export interface CommentsFallbackResult {
+    source: 'actions-fallback';
+    note: string;
+    actions: unknown;
+}
+export declare class CommentApi {
+    private readonly http;
+    constructor(http: ZentaoHttpClient);
+    getComments(objectType: CommentObjectType, objectID: number): Promise<unknown>;
+    addComment(input: AddCommentInput): Promise<unknown>;
+    private getActionsFromObjectDetail;
+    private getObjectEndpoint;
+}

package/dist/api/comment.js

@@ -0,0 +1,47 @@
+export class CommentApi {
+    constructor(http) {
+        this.http = http;
+    }
+    async getComments(objectType, objectID) {
+        try {
+            return await this.http.request('GET', `/comments/${objectType}/${objectID}`);
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('404')) {
+                return this.getActionsFromObjectDetail(objectType, objectID);
+            }
+            throw error;
+        }
+    }
+    async addComment(input) {
+        return this.http.request('POST', '/comment', { data: input });
+    }
+    async getActionsFromObjectDetail(objectType, objectID) {
+        const endpoint = this.getObjectEndpoint(objectType, objectID);
+        const detail = await this.http.request('GET', endpoint);
+        return {
+            source: 'actions-fallback',
+            note: '当前禅道版本不支持 /comments/{objectType}/{objectID}，这里返回对象详情中的 actions，其中包含评论以及状态变更等操作记录。',
+            actions: detail.actions ?? [],
+        };
+    }
+    getObjectEndpoint(objectType, objectID) {
+        switch (objectType) {
+            case 'task':
+                return `/tasks/${objectID}`;
+            case 'bug':
+                return `/bugs/${objectID}`;
+            case 'story':
+                return `/stories/${objectID}`;
+            case 'product':
+                return `/products/${objectID}`;
+            case 'project':
+                return `/projects/${objectID}`;
+            case 'execution':
+                return `/executions/${objectID}`;
+            default:
+                throw new Error(`不支持从详情回退获取评论: ${objectType}`);
+        }
+    }
+}
+//# sourceMappingURL=comment.js.map

package/dist/api/comment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment.js","sourceRoot":"","sources":["../../src/api/comment.ts"],"names":[],"mappings":"AAgBA,MAAM,OAAO,UAAU;IACrB,YAA6B,IAAsB;QAAtB,SAAI,GAAJ,IAAI,CAAkB;IAAG,CAAC;IAEvD,KAAK,CAAC,WAAW,CAAC,UAA6B,EAAE,QAAgB;QAC/D,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,aAAa,UAAU,IAAI,QAAQ,EAAE,CAAC,CAAC;QAC/E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5D,OAAO,IAAI,CAAC,0BAA0B,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YAC/D,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAsB;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAChE,CAAC;IAEO,KAAK,CAAC,0BAA0B,CAAC,UAA6B,EAAE,QAAgB;QACtF,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAA0B,KAAK,EAAE,QAAQ,CAAC,CAAC;QACjF,OAAO;YACL,MAAM,EAAE,kBAAkB;YAC1B,IAAI,EAAE,mFAAmF;YACzF,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;SAC9B,CAAC;IACJ,CAAC;IAEO,iBAAiB,CAAC,UAA6B,EAAE,QAAgB;QACvE,QAAQ,UAAU,EAAE,CAAC;YACnB,KAAK,MAAM;gBACT,OAAO,UAAU,QAAQ,EAAE,CAAC;YAC9B,KAAK,KAAK;gBACR,OAAO,SAAS,QAAQ,EAAE,CAAC;YAC7B,KAAK,OAAO;gBACV,OAAO,YAAY,QAAQ,EAAE,CAAC;YAChC,KAAK,SAAS;gBACZ,OAAO,aAAa,QAAQ,EAAE,CAAC;YACjC,KAAK,SAAS;gBACZ,OAAO,aAAa,QAAQ,EAAE,CAAC;YACjC,KAAK,WAAW;gBACd,OAAO,eAAe,QAAQ,EAAE,CAAC;YACnC;gBACE,MAAM,IAAI,KAAK,CAAC,iBAAiB,UAAU,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;CACF"}

package/dist/api/development-context.d.ts

@@ -0,0 +1,14 @@
+import type { BugApi } from './bug.js';
+import type { RelationApi } from './relation.js';
+import type { StoryApi } from './story.js';
+export declare class DevelopmentContextApi {
+    private readonly bugApi;
+    private readonly storyApi;
+    private readonly relationApi;
+    constructor(bugApi: BugApi, storyApi: StoryApi, relationApi: RelationApi);
+    getDevelopmentContext(input: {
+        entityType: 'story' | 'bug';
+        entityId: number;
+        productId?: number;
+    }): Promise<unknown>;
+}

package/dist/api/development-context.js

@@ -0,0 +1,35 @@
+export class DevelopmentContextApi {
+    constructor(bugApi, storyApi, relationApi) {
+        this.bugApi = bugApi;
+        this.storyApi = storyApi;
+        this.relationApi = relationApi;
+    }
+    async getDevelopmentContext(input) {
+        if (input.entityType === 'story') {
+            const story = await this.storyApi.getStoryDetail(input.entityId);
+            const relatedBugs = await this.relationApi.getStoryRelatedBugs(input.entityId, input.productId);
+            const testCases = Array.isArray(story.cases) ? story.cases : [];
+            return {
+                entityType: 'story',
+                story,
+                relatedBugs,
+                testCases,
+                summary: {
+                    relatedBugsCount: relatedBugs.bugs.length,
+                    testCasesCount: testCases.length,
+                },
+            };
+        }
+        const bug = await this.bugApi.getBugDetail(input.entityId);
+        const relatedStory = await this.relationApi.getBugRelatedStory(input.entityId);
+        return {
+            entityType: 'bug',
+            bug,
+            relatedStory,
+            summary: {
+                hasRelatedStory: relatedStory !== null,
+            },
+        };
+    }
+}
+//# sourceMappingURL=development-context.js.map

package/dist/api/development-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"development-context.js","sourceRoot":"","sources":["../../src/api/development-context.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,qBAAqB;IAChC,YACmB,MAAc,EACd,QAAkB,EAClB,WAAwB;QAFxB,WAAM,GAAN,MAAM,CAAQ;QACd,aAAQ,GAAR,QAAQ,CAAU;QAClB,gBAAW,GAAX,WAAW,CAAa;IACxC,CAAC;IAEJ,KAAK,CAAC,qBAAqB,CAAC,KAA4E;QACtG,IAAI,KAAK,CAAC,UAAU,KAAK,OAAO,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACjE,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;YAChG,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAEhE,OAAO;gBACL,UAAU,EAAE,OAAO;gBACnB,KAAK;gBACL,WAAW;gBACX,SAAS;gBACT,OAAO,EAAE;oBACP,gBAAgB,EAAE,WAAW,CAAC,IAAI,CAAC,MAAM;oBACzC,cAAc,EAAE,SAAS,CAAC,MAAM;iBACjC;aACF,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC3D,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAE/E,OAAO;YACL,UAAU,EAAE,KAAK;YACjB,GAAG;YACH,YAAY;YACZ,OAAO,EAAE;gBACP,eAAe,EAAE,YAAY,KAAK,IAAI;aACvC;SACF,CAAC;IACJ,CAAC;CACF"}