dsh-issue-tracker

專案介紹

中文

Jira Cloud 工單整合，提供 8 個模型工具用於工單查詢、專案與流轉查詢、建立、更新、評論和狀態流轉；寫操作預設關閉並支援 dry-run。

English

Jira Cloud issue-tracker integration exposing eight model tools for issue search, project and transition lookup, creation, updates, comments, and transitions; writes are opt-in and support dry-run.

Jira Cloud issue-tracker service and model-facing tools for DeepSeek Harness.

The package is one installable DSH bundle with three internal roles:

a provider-neutral Cordis issueTracker service;
a Jira Cloud REST API v3 provider;
eight tools registered through the public DSH ToolRuntime service.

The plugin is read-only by default. Create, update, comment, and transition operations require an explicit writeEnabled: true; every write tool also supports a side-effect-free dryRun.

Requirements

Node.js ^22.19.0 || >=24.0.0
DeepSeek Harness 0.1.0-rc.6
Jira Cloud REST API v3

Install

dsh plugin --profile web add dsh-issue-tracker

The bundle row stays disabled until these variables are available:

$env:JIRA_BASE_URL = 'https://your-domain.atlassian.net'
$env:JIRA_EMAIL = '[email protected]'
$env:JIRA_API_TOKEN = 'your-api-token'

Writes remain disabled. Enable them only when intended:

$env:DSH_ISSUE_TRACKER_WRITE_ENABLED = 'true'

Restart DSH, then inspect the composed row:

dsh --profile web --dump-config

For OAuth bearer authentication or non-environment configuration, replace the issue-tracker row in the profile's cordis.patch.yml; a patch replaces the whole row, so restate every field:

- id: issue-tracker
  name: dsh-issue-tracker
  config:
    baseUrl: https://your-domain.atlassian.net
    auth:
      type: bearer
      accessToken: !!js process.env.JIRA_ACCESS_TOKEN
    writeEnabled: false

Tools

Tool	Purpose	Writes
`issue_get`	Read one issue	No
`issue_search`	Search with filters or raw JQL	No
`issue_transitions`	List available transitions	No
`issue_projects`	List visible projects	No
`issue_create`	Create an issue	Yes
`issue_update`	Update issue fields	Yes
`issue_comment`	Add a comment	Yes
`issue_transition`	Apply a transition	Yes

All HTTP calls honor the DSH tool cancellation signal and a configured request deadline. Structured filters are JQL-escaped; providerQuery is intentionally raw JQL and should be governed like any other privileged query input.

Security

HTTPS is required unless allowInsecureHttp: true is explicitly set.
Credentials in baseUrl are rejected.
Secrets are marked with Schemastery's secret role.
The plugin does not log credentials, prompts, issue bodies, or comments.
No telemetry is collected or sent by this package.

See docs/security.md for the complete boundary.

Uninstall

dsh plugin --profile web remove dsh-issue-tracker

Cordis owns both the service registration and tool registrations, so unloading the bundle removes all eight tools and the issueTracker service.

Verification status

The release is typechecked and tested on Windows with real Cordis and DSH 0.1.0-rc.6 packages. HTTP behavior is tested with mocked Jira responses; no live Jira tenant or production credential was used. See docs/verification-report.md.

中文说明

这是一个面向 DeepSeek Harness 的 Jira Cloud 工单插件。安装一个 npm 包即可获得通用 issueTracker 服务和 8 个模型工具。插件默认只读；所有写操作必须显式开启 writeEnabled，并且可以先用 dryRun 验证参数而不产生副作用。

许可证：MIT。

dsh-issue-tracker

專案介紹

專案資訊與收錄訊號

資料評分

安裝與使用

專案截圖

倉庫 README