dsh-plugin-github-issues 0.0.0-stage → 0.4.7

package/lib/types/vm.d.ts

@@ -0,0 +1,264 @@
+/**
+ * Shared view-model types for both halves of the plugin.
+ *
+ * The Host assembles these from GitHub's GraphQL responses; the browser renders
+ * them without knowing anything about GraphQL. Keeping them in one module is what
+ * lets the two halves be built and tested separately.
+ *
+ * @module dsh-plugin-github-issues/vm
+ */
+/** One issue's state as GitHub reports it. */
+export type IssueState = 'OPEN' | 'CLOSED';
+/** Why an issue is closed; `null` while open. */
+export type StateReason = 'COMPLETED' | 'NOT_PLANNED' | 'DUPLICATE' | 'REOPENED' | null;
+/** Where a rendered priority came from, so the UI can say why it shows that value. */
+export type PrioritySource = 'project' | 'issue-field' | 'label';
+/** Rolled-up check state of a linked pull request. */
+export type CheckState = 'SUCCESS' | 'FAILURE' | 'ERROR' | 'PENDING' | 'EXPECTED' | 'NEUTRAL' | 'SKIPPED' | null;
+/** Review decision of a linked pull request; `null` when reviews are not required. */
+export type ReviewDecision = 'APPROVED' | 'CHANGES_REQUESTED' | 'REVIEW_REQUIRED' | null;
+/** State of a pull request as GitHub reports it. */
+export type PullRequestState = 'OPEN' | 'CLOSED' | 'MERGED';
+/** One label with GitHub's bare hex color (no leading `#`). */
+export interface LabelVM {
+    name: string;
+    color: string;
+}
+/** One assignee. */
+export interface AssigneeVM {
+    login: string;
+    avatarUrl?: string;
+}
+/** One milestone with its completion percentage. */
+export interface MilestoneVM {
+    title: string;
+    dueOn: string | null;
+    state: 'OPEN' | 'CLOSED';
+    progress: number | null;
+}
+/** GitHub's issue type (org-defined, may be absent). */
+export interface IssueTypeVM {
+    name: string;
+    color?: string;
+}
+/** The rendered priority and its source. */
+export interface PriorityVM {
+    source: PrioritySource;
+    name: string;
+    color?: string;
+}
+/** One Projects v2 single-select field value (Status and friends). */
+export interface ProjectFieldValueVM {
+    name: string;
+    color?: string;
+}
+/** One pull request linked to an issue. */
+export interface LinkedPRVM {
+    number: number;
+    title: string;
+    url: string;
+    state: PullRequestState;
+    isDraft: boolean;
+    merged: boolean;
+    reviewDecision: ReviewDecision;
+    checks: CheckState;
+    failingChecks?: string[];
+    author?: string;
+}
+/** One issue as a list row renders it. */
+export interface IssueCardVM {
+    /** GitHub node id, used as a stable React key and for merge/dedupe. */
+    id: string;
+    /** `owner/name`. */
+    repo: string;
+    number: number;
+    title: string;
+    url: string;
+    state: IssueState;
+    stateReason: StateReason;
+    isPrivate: boolean;
+    issueType?: IssueTypeVM;
+    labels: LabelVM[];
+    milestone?: MilestoneVM;
+    assignees: AssigneeVM[];
+    /** ISO 8601. */
+    updatedAt: string;
+    commentCount: number;
+    bodyExcerpt?: string;
+    priority?: PriorityVM;
+    /** PRs closed by this issue (best effort, cheap nested connection). */
+    linkedPRs: LinkedPRVM[];
+    /** Projects v2 Status value, when the card came from a project view. */
+    projectStatus?: ProjectFieldValueVM;
+    /** Sessions this issue has been handed to (newest last). */
+    sessionLinks?: IssueSessionLinkVM[];
+}
+/** The fast part of an issue detail: the body only. */
+export interface IssueBodyVM {
+    body: string;
+}
+/** One issue's full detail. */
+export interface IssueDetailVM extends IssueCardVM {
+    body: string;
+    /** PRs that mention this issue without closing it (`timelineItems` cross-references). */
+    mentionedPRs: LinkedPRVM[];
+}
+/** One Session this issue has been handed to. */
+export interface IssueSessionLinkVM {
+    sessionId: string;
+    /** Milliseconds since epoch when the handoff was recorded. */
+    at: number;
+}
+/** One persisted issue → session link. */
+export interface IssueLinkRecord {
+    repo: string;
+    number: number;
+    sessionId: string;
+    at: number;
+}
+/** One page of the list. */
+export interface IssueListPage {
+    items: IssueCardVM[];
+    totalCount?: number;
+    pageInfo: {
+        hasNextPage: boolean;
+        endCursor: string | null;
+    };
+    rateLimit?: {
+        cost?: number;
+        remaining?: number;
+    };
+    /** A non-fatal note, e.g. Projects v2 unavailable because of a missing scope. */
+    notice?: string;
+}
+/** The list views the panel offers. */
+export type ListView = 'assigned' | 'created' | 'open' | 'repo' | 'project';
+/**
+ * One list request from the browser.
+ *
+ * The scope is a cascade, not a view enum: an organization narrows the search to
+ * `org:<login>`, a project switches to Projects v2 items, and a repository adds a
+ * `repo:` qualifier (or filters the project's items by content repository). Any
+ * combination is legal; an empty scope means "everything the token can read".
+ */
+export interface IssueListRequest {
+    /** Legacy single-purpose view; the cascade UI sends the fields below instead. */
+    view?: ListView;
+    /** Organization scope (`org:<login>` in search, owner for project/repo lookups). */
+    org?: string;
+    /** Repository scope: `owner/name` values. */
+    repos?: string[];
+    /** Projects v2 node id. */
+    projectId?: string;
+    /** Assignee qualifier: `@me`, `all` (no qualifier), or a GitHub login. */
+    assignee?: string;
+    /** Author qualifier (legacy "created by me"). */
+    author?: string;
+    /** Open/closed/all filter. */
+    state?: 'open' | 'closed' | 'all';
+    first?: number;
+    after?: string | null;
+}
+/** One organization (or the viewer's personal account) in the scope picker. */
+export interface OrgRefVM {
+    login: string;
+    /** Display name, when GitHub reports one. */
+    name?: string;
+}
+/** One repository in the scope picker. */
+export interface RepoRefVM {
+    nameWithOwner: string;
+    isPrivate: boolean;
+    pushedAt?: string;
+    /** Whether this repository is a fork (kept in the list, marked in the UI). */
+    isFork?: boolean;
+}
+/** One page of a repository listing. */
+export interface RepoPageVM {
+    items: RepoRefVM[];
+    totalCount: number;
+    hasNextPage: boolean;
+    endCursor: string | null;
+}
+/** One Projects v2 project in the scope picker. */
+export interface ProjectRefVM {
+    id: string;
+    number: number;
+    title: string;
+    url: string;
+    owner: string;
+}
+/** Everything the scope pickers need. */
+export interface ScopeCatalog {
+    viewer: {
+        login: string;
+        avatarUrl?: string;
+    } | null;
+    /** Organizations the token can see, including private memberships. */
+    orgs: OrgRefVM[];
+    /** The viewer's repositories (forks included); org repositories load on demand. */
+    repos: RepoRefVM[];
+    /** True when projects could not be read because the token lacks `read:project`. */
+    projectsBlocked: boolean;
+    projectsError?: string;
+}
+/** What the settings page renders about auth. */
+export interface GitHubStatus {
+    mode: 'gh';
+    ghInstalled: boolean;
+    ghPath?: string;
+    signedIn: boolean;
+    login?: string;
+    host: string;
+    tokenSource?: string;
+    scopes: string[];
+    missingProjectScope: boolean;
+    config: {
+        authMode: string;
+        host: string;
+        handoffMode: string;
+        pollSeconds: number;
+    };
+    error?: string;
+}
+/** Preferences owned by the Host (persisted in the plugin's state file). */
+export interface Prefs {
+    /** Legacy view key, migrated to the cascade fields on load. */
+    view?: ListView | undefined;
+    /** Selected organization (`undefined` means all organizations). */
+    org?: string | undefined;
+    /** Selected Projects v2 node id. */
+    projectId?: string | undefined;
+    /** Selected repository `owner/name` (filter within the org or the project). */
+    repo?: string | undefined;
+    /** Assignee filter: `@me`, `all`, or a GitHub login. */
+    assignee: string;
+    /** Issue state filter. */
+    state: 'open' | 'closed' | 'all';
+    /** What a handoff does by default: fill the draft, or send it. */
+    handoffMode: 'draft' | 'send';
+    /** Template used to turn an issue into an agent prompt. */
+    promptTemplate: string;
+    /** The issue the composer dock shows. */
+    pinned?: {
+        repo: string;
+        number: number;
+    } | undefined;
+}
+/**
+ * A preference patch as it crosses the Remote wire.
+ *
+ * `undefined` properties disappear in JSON, so "clear the selection" is sent as
+ * `null`; the Host validates it into `undefined`. Every clearing control must use
+ * `null`, never an undefined value.
+ */
+export type PrefsPatch = {
+    [K in keyof Prefs]?: Prefs[K] | null;
+};
+/** The prompt a handoff writes into the composer. */
+export declare const DEFAULT_PROMPT_TEMPLATE: string;
+/** Default preferences for a fresh install: everything assigned to me that is open. */
+export declare const DEFAULT_PREFS: Prefs;
+/** Build preferences from the deployment config and whatever was saved. */
+export declare function mergePrefs(saved: Partial<Prefs> | undefined, configHandoffMode: string | undefined, configTemplate: string | undefined): Prefs;
+//# sourceMappingURL=vm.d.ts.map

package/lib/types/vm.d.ts.map

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

package/lib/types/workspace.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Workspace resolution for a one-click handoff.
+ *
+ * A handoff from the GitHub panel opens a fresh Session so the issue gets its
+ * own context. The new Session needs a Workspace, with this priority:
+ *
+ * 1. the Workspace of the Session the handoff came from,
+ * 2. the Workspace of a Session already linked to the same repository,
+ * 3. a Workspace whose directory basename or title matches the repository name,
+ * 4. no choice at all — the Host's "current or most recent Workspace" default.
+ *
+ * Pure so the rules are unit-tested without a browser.
+ *
+ * @module dsh-plugin-github-issues/workspace
+ */
+/** One Workspace candidate, narrowed from the client's workspace catalog. */
+export interface WorkspaceCandidate {
+    workspaceId: string;
+    /** Absolute directory path of the Workspace, when the catalog carries it. */
+    path?: string;
+    /** Display title of the Workspace (usually the directory basename). */
+    title?: string;
+    /** Sessions currently grouped under this Workspace. */
+    sessionIds: readonly string[];
+}
+/** The inputs of one resolution. */
+export interface ResolveWorkspaceInput {
+    /** `owner/name` of the issue's repository. */
+    repo: string;
+    /** The Session the handoff was triggered from, when one is on screen. */
+    currentSessionId?: string;
+    /** Sessions already linked to this repository, newest first. */
+    linkedSessionIds?: readonly string[];
+    /** The Workspace catalog, in display order. */
+    workspaces: readonly WorkspaceCandidate[];
+}
+/**
+ * Pick the Workspace for a handoff's new Session.
+ * @param input - repository, source Sessions, and the Workspace catalog.
+ * @returns the chosen Workspace id, or `undefined` to use the Host default.
+ */
+export declare function resolveHandoffWorkspace(input: ResolveWorkspaceInput): string | undefined;
+//# sourceMappingURL=workspace.d.ts.map

package/lib/types/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,uDAAuD;IACvD,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;CAC9B;AAED,oCAAoC;AACpC,MAAM,WAAW,qBAAqB;IACpC,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,+CAA+C;IAC/C,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAA;CAC1C;AASD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,GAAG,SAAS,CA+BxF"}

package/lib/vm.js

@@ -0,0 +1,42 @@
+/**
+ * Shared view-model types for both halves of the plugin.
+ *
+ * The Host assembles these from GitHub's GraphQL responses; the browser renders
+ * them without knowing anything about GraphQL. Keeping them in one module is what
+ * lets the two halves be built and tested separately.
+ *
+ * @module dsh-plugin-github-issues/vm
+ */
+/** The prompt a handoff writes into the composer. */
+export const DEFAULT_PROMPT_TEMPLATE = [
+    '处理 GitHub Issue：{{repo}}#{{number}} {{title}}',
+    '链接：{{url}}',
+    '状态：{{state}} ｜ 里程碑：{{milestone}} ｜ 优先级：{{priority}} ｜ 指派：{{assignees}}',
+    '标签：{{labels}}',
+    '关联 PR：{{prs}}',
+    '要求：先读 Issue 正文与关联 PR，确认验收标准后再动手；用 subagent_codex 执行具体改动，完成后跑相关测试并回报。',
+].join('\n');
+/** Default preferences for a fresh install: everything assigned to me that is open. */
+export const DEFAULT_PREFS = {
+    org: undefined,
+    projectId: undefined,
+    repo: undefined,
+    assignee: '@me',
+    state: 'open',
+    handoffMode: 'draft',
+    promptTemplate: DEFAULT_PROMPT_TEMPLATE,
+    pinned: undefined,
+};
+/** Build preferences from the deployment config and whatever was saved. */
+export function mergePrefs(saved, configHandoffMode, configTemplate) {
+    const handoff = saved?.handoffMode
+        ?? (configHandoffMode === 'send' ? 'send' : 'draft');
+    return {
+        ...DEFAULT_PREFS,
+        ...saved,
+        handoffMode: handoff,
+        promptTemplate: saved?.promptTemplate
+            ?? (configTemplate === undefined || configTemplate === '' ? DEFAULT_PROMPT_TEMPLATE : configTemplate),
+    };
+}
+//# sourceMappingURL=vm.js.map

package/lib/vm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vm.js","sourceRoot":"","sources":["../src/vm.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiRH,qDAAqD;AACrD,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,+CAA+C;IAC/C,YAAY;IACZ,wEAAwE;IACxE,eAAe;IACf,eAAe;IACf,sEAAsE;CACvE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAEZ,uFAAuF;AACvF,MAAM,CAAC,MAAM,aAAa,GAAU;IAClC,GAAG,EAAE,SAAS;IACd,SAAS,EAAE,SAAS;IACpB,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,KAAK;IACf,KAAK,EAAE,MAAM;IACb,WAAW,EAAE,OAAO;IACpB,cAAc,EAAE,uBAAuB;IACvC,MAAM,EAAE,SAAS;CAClB,CAAA;AAED,2EAA2E;AAC3E,MAAM,UAAU,UAAU,CACxB,KAAiC,EACjC,iBAAqC,EACrC,cAAkC;IAElC,MAAM,OAAO,GAAG,KAAK,EAAE,WAAW;WAC7B,CAAC,iBAAiB,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IACtD,OAAO;QACL,GAAG,aAAa;QAChB,GAAG,KAAK;QACR,WAAW,EAAE,OAAO;QACpB,cAAc,EAAE,KAAK,EAAE,cAAc;eAChC,CAAC,cAAc,KAAK,SAAS,IAAI,cAAc,KAAK,EAAE,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,cAAc,CAAC;KACxG,CAAA;AACH,CAAC"}

package/lib/workspace.js

@@ -0,0 +1,57 @@
+/**
+ * Workspace resolution for a one-click handoff.
+ *
+ * A handoff from the GitHub panel opens a fresh Session so the issue gets its
+ * own context. The new Session needs a Workspace, with this priority:
+ *
+ * 1. the Workspace of the Session the handoff came from,
+ * 2. the Workspace of a Session already linked to the same repository,
+ * 3. a Workspace whose directory basename or title matches the repository name,
+ * 4. no choice at all — the Host's "current or most recent Workspace" default.
+ *
+ * Pure so the rules are unit-tested without a browser.
+ *
+ * @module dsh-plugin-github-issues/workspace
+ */
+/** The last path segment, used for the directory-name rule. */
+function basename(path) {
+    const trimmed = path.replace(/[/\\]+$/, '');
+    const index = Math.max(trimmed.lastIndexOf('/'), trimmed.lastIndexOf('\\'));
+    return (index === -1 ? trimmed : trimmed.slice(index + 1)).toLowerCase();
+}
+/**
+ * Pick the Workspace for a handoff's new Session.
+ * @param input - repository, source Sessions, and the Workspace catalog.
+ * @returns the chosen Workspace id, or `undefined` to use the Host default.
+ */
+export function resolveHandoffWorkspace(input) {
+    const workspaces = input.workspaces;
+    if (workspaces.length === 0)
+        return undefined;
+    /** The first Workspace whose `sessionIds` contains one of the candidates. */
+    const bySession = (sessionIds) => {
+        for (const sessionId of sessionIds) {
+            const hit = workspaces.find(workspace => workspace.sessionIds.includes(sessionId));
+            if (hit !== undefined)
+                return hit.workspaceId;
+        }
+        return undefined;
+    };
+    if (input.currentSessionId !== undefined) {
+        const source = bySession([input.currentSessionId]);
+        if (source !== undefined)
+            return source;
+    }
+    if (input.linkedSessionIds !== undefined && input.linkedSessionIds.length !== 0) {
+        const linked = bySession(input.linkedSessionIds);
+        if (linked !== undefined)
+            return linked;
+    }
+    const repoName = basename(input.repo);
+    const directory = workspaces.find(workspace => ((workspace.path !== undefined && basename(workspace.path) === repoName)
+        || (workspace.title !== undefined && workspace.title.toLowerCase() === repoName)));
+    if (directory !== undefined)
+        return directory.workspaceId;
+    return undefined;
+}
+//# sourceMappingURL=workspace.js.map

package/lib/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAyBH,+DAA+D;AAC/D,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAA;IAC3E,OAAO,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;AAC1E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAA4B;IAClE,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAA;IACnC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IAE7C,6EAA6E;IAC7E,MAAM,SAAS,GAAG,CAAC,UAA6B,EAAsB,EAAE;QACtE,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAA;YAClF,IAAI,GAAG,KAAK,SAAS;gBAAE,OAAO,GAAG,CAAC,WAAW,CAAA;QAC/C,CAAC;QACD,OAAO,SAAS,CAAA;IAClB,CAAC,CAAA;IAED,IAAI,KAAK,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAA;QAClD,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAA;IACzC,CAAC;IAED,IAAI,KAAK,CAAC,gBAAgB,KAAK,SAAS,IAAI,KAAK,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChF,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAA;QAChD,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAA;IACzC,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACrC,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAC7C,CAAC,SAAS,CAAC,IAAI,KAAK,SAAS,IAAI,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC;WACpE,CAAC,SAAS,CAAC,KAAK,KAAK,SAAS,IAAI,SAAS,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,CACjF,CAAC,CAAA;IACF,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC,WAAW,CAAA;IAEzD,OAAO,SAAS,CAAA;AAClB,CAAC"}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "GitHub Issues",
+    "description": "Browse issues, milestones, labels, priority, and linked PR status across your repos and projects, and drag an issue into the composer to hand it to the agent."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "GitHub Issues",
+    "description": "跨仓库/项目管理并展示 GitHub Issue：里程碑、标签、优先级、关联 PR 状态；可把 Issue 拖进输入框交给 Agent 处理。"
+  }
+}

package/package.json

@@ -1,6 +1,99 @@
 {
   "name": "dsh-plugin-github-issues",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.4.7",
+  "description": "Browse GitHub issues, milestones, labels, priority, and linked PR status inside DeepSeek Harness, and hand an issue to the agent by dragging it into the composer.",
+  "keywords": [
+    "dsh-plugin",
+    "deepseek-harness",
+    "dsh",
+    "cordis",
+    "github",
+    "issues",
+    "milestones",
+    "projects"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "Kanner",
+    "email": "kanner.chen@gmail.com"
+  },
+  "homepage": "https://github.com/ckanner/dsh-plugin-github-issues#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ckanner/dsh-plugin-github-issues.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ckanner/dsh-plugin-github-issues/issues"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "default": "./lib/client.js"
+    },
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "locale",
+    "icon.svg",
+    "docs/README.zh.md"
+  ],
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node scripts/build-client.mjs",
+    "typecheck": "tsc -p tsconfig.typecheck.json",
+    "test": "node --test \"tests/*.test.ts\"",
+    "test:render": "node scripts/render-smoke.mjs",
+    "build:client": "node scripts/build-client.mjs",
+    "verify:client": "node scripts/verify-client-bundle.mjs",
+    "prepare": "npm run build",
+    "verify:package": "node scripts/verify-package-contents.mjs",
+    "check": "npm run typecheck && npm test && npm run test:render && npm run build && npm run verify:client && npm run verify:package"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=0.0.1-rc.1 <0.1.0 || >=0.1.0-rc.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0",
+    "@deepseek-ai/dsh-typert-protocol": ">=0.0.1-rc.1 <0.1.0 || >=0.1.0-rc.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0",
+    "@deepseek-ai/schemastery": ">=0.0.1-rc.1 <0.1.0 || >=0.1.0-rc.1 <0.2.0 || >=0.2.0-rc.1 <0.3.0"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-typert-protocol": {
+      "optional": true
+    },
+    "@deepseek-ai/schemastery": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.5",
+    "@types/react": "^18.3.31",
+    "esbuild": "^0.25.12",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "typescript": "^5.9.0"
+  }
+}