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

package/lib/index.js

@@ -0,0 +1,65 @@
+/**
+ * The bundle's Host entry point.
+ *
+ * A bundle is a configuration layer, so this module exists to do the one thing a
+ * layer cannot: own the live GitHub service and the machine-local preferences, and
+ * expose them to the browser through the plugin's own Remote namespace.
+ *
+ * @module dsh-plugin-github-issues
+ */
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import z from '@deepseek-ai/schemastery';
+import { GitHubIssuesController } from "./controller.js";
+import { probeGh, resolveToken } from "./github/auth.js";
+import { createGitHubApi } from "./github/client.js";
+import { PrefsStore } from "./github/state.js";
+/** What this plugin calls itself in diagnostics. */
+export const name = 'github-issues';
+/**
+ * Everything an installation may tune.
+ *
+ * No token lives here on purpose: the deployment's patch and its `.bak` copies
+ * would duplicate it. The token is read from the machine's `gh` CLI at call time.
+ */
+export const Config = z.object({
+    /** How the Host obtains a token; `gh` is the only mode in v0.1. */
+    authMode: z.string().default('gh'),
+    /** GitHub host, `github.com` or a GitHub Enterprise hostname. */
+    host: z.string().default('github.com'),
+    /** Explicit `gh` executable path, when the app's PATH cannot find one. */
+    ghPath: z.string().default(''),
+    /** Default handoff behavior: `draft` fills the composer, `send` submits it. */
+    handoffMode: z.string().default('draft'),
+    /** Seconds between list refreshes while the panel is visible. */
+    pollSeconds: z.number().default(90),
+    /** Directory for non-secret UI state; defaults to `$DSH_HOME/github-issues`. */
+    stateDir: z.string().default(''),
+    /** Default prompt template; empty means the built-in one. */
+    promptTemplate: z.string().default(''),
+});
+/**
+ * Register the GitHub service.
+ * @param ctx - the plugin context.
+ * @param config - the installation's configuration.
+ */
+export function apply(ctx, config) {
+    const stateDir = config.stateDir === ''
+        ? join(process.env.DSH_HOME ?? join(homedir(), '.dsh'), 'github-issues')
+        : config.stateDir;
+    const prefs = new PrefsStore(stateDir, config.handoffMode, config.promptTemplate);
+    new GitHubIssuesController(ctx, {
+        probeGh,
+        resolveToken,
+        createApi: createGitHubApi,
+        prefs,
+        config: {
+            authMode: config.authMode,
+            host: config.host,
+            ghPath: config.ghPath,
+            handoffMode: config.handoffMode,
+            pollSeconds: config.pollSeconds,
+        },
+    });
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAGhC,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAExC,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,oDAAoD;AACpD,MAAM,CAAC,MAAM,IAAI,GAAG,eAAe,CAAA;AAEnC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,mEAAmE;IACnE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAClC,iEAAiE;IACjE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC;IACtC,0EAA0E;IAC1E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9B,+EAA+E;IAC/E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;IACxC,iEAAiE;IACjE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACnC,gFAAgF;IAChF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAChC,6DAA6D;IAC7D,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CACvC,CAAC,CAAA;AAaF;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,GAAY,EAAE,MAAc;IAChD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,KAAK,EAAE;QACrC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,EAAE,eAAe,CAAC;QACxE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAA;IAEnB,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,cAAc,CAAC,CAAA;IACjF,IAAI,sBAAsB,CAAC,GAAG,EAAE;QAC9B,OAAO;QACP,YAAY;QACZ,SAAS,EAAE,eAAe;QAC1B,KAAK;QACL,MAAM,EAAE;YACN,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/lib/prompt.js

@@ -0,0 +1,87 @@
+/**
+ * Turning one issue into the prompt a handoff writes into the composer.
+ *
+ * Kept apart from the UI so the exact wording is testable, and so the Host can
+ * reuse it when it needs to describe an issue without the browser.
+ *
+ * @module dsh-plugin-github-issues/prompt
+ */
+import { DEFAULT_PROMPT_TEMPLATE } from "./vm.js";
+/** Fill one `{{token}}` occurrence. */
+function fill(template, token, value) {
+    return template.split(`{{${token}}}`).join(value);
+}
+/** A human-readable state line. */
+function stateText(issue) {
+    if (issue.state === 'OPEN')
+        return 'Open';
+    return issue.stateReason === 'COMPLETED' ? 'Closed (completed)' : `Closed (${issue.stateReason ?? 'no reason'})`;
+}
+/** The linked-PR line, naming each PR's state so the agent knows what exists. */
+function prsText(issue) {
+    if (issue.linkedPRs.length === 0)
+        return '无';
+    return issue.linkedPRs
+        .map(pr => {
+        const state = pr.merged ? 'merged' : pr.state.toLowerCase();
+        return `#${String(pr.number)} (${state}${pr.checks === null ? '' : `, checks ${pr.checks.toLowerCase()}`})`;
+    })
+        .join('、');
+}
+/** The milestone line. */
+function milestoneText(issue) {
+    if (issue.milestone === undefined)
+        return '无';
+    const due = issue.milestone.dueOn === null ? '' : `, due ${issue.milestone.dueOn}`;
+    const progress = issue.milestone.progress === null ? '' : `, ${String(issue.milestone.progress)}%`;
+    return `${issue.milestone.title}${due}${progress}`;
+}
+/** The priority line, including where the value came from. */
+function priorityText(issue) {
+    if (issue.priority === undefined)
+        return '无';
+    const source = issue.priority.source === 'project'
+        ? 'project field'
+        : issue.priority.source === 'issue-field' ? 'issue field' : 'label';
+    return `${issue.priority.name} (${source})`;
+}
+/**
+ * Render the handoff prompt for one issue.
+ * @param issue - the card the user dragged or clicked.
+ * @param template - the configured template; `{{token}}` placeholders are replaced.
+ * @returns the prompt text, trimmed to a size the composer handles comfortably.
+ */
+export function renderPrompt(issue, template) {
+    const source = template === '' ? DEFAULT_PROMPT_TEMPLATE : template;
+    let text = source;
+    text = fill(text, 'repo', issue.repo);
+    text = fill(text, 'number', String(issue.number));
+    text = fill(text, 'title', issue.title);
+    text = fill(text, 'url', issue.url);
+    text = fill(text, 'state', stateText(issue));
+    text = fill(text, 'milestone', milestoneText(issue));
+    text = fill(text, 'priority', priorityText(issue));
+    text = fill(text, 'assignees', issue.assignees.length === 0 ? '未指派' : issue.assignees.map(a => a.login).join(', '));
+    text = fill(text, 'labels', issue.labels.length === 0 ? '无' : issue.labels.map(l => l.name).join(', '));
+    text = fill(text, 'prs', prsText(issue));
+    if (text.length > 8_000)
+        return `${text.slice(0, 7_990)}\n…（已截断）`;
+    return text;
+}
+/** The invisible draft placeholder that keeps the native send enabled. */
+export const EMPTY_DRAFT_HOLD = '\u200b\n';
+/**
+ * Compose the message a pending issue card sends.
+ *
+ * The card carries the issue prompt; the user's own words are optional and are
+ * appended after a blank line. The invisible composer placeholder is stripped.
+ *
+ * @param prompt - the rendered issue prompt from the card.
+ * @param memo - the user's text from the composer (may contain the placeholder).
+ * @returns the text to submit.
+ */
+export function composeHandoffPrompt(prompt, memo) {
+    const extra = memo.replace(/\u200b/g, '').replace(/^\n+/, '').trim();
+    return extra === '' ? prompt : `${prompt}\n\n${extra}`;
+}
+//# sourceMappingURL=prompt.js.map

package/lib/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA;AAEjD,uCAAuC;AACvC,SAAS,IAAI,CAAC,QAAgB,EAAE,KAAa,EAAE,KAAa;IAC1D,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AACnD,CAAC;AAED,mCAAmC;AACnC,SAAS,SAAS,CAAC,KAAkB;IACnC,IAAI,KAAK,CAAC,KAAK,KAAK,MAAM;QAAE,OAAO,MAAM,CAAA;IACzC,OAAO,KAAK,CAAC,WAAW,KAAK,WAAW,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,WAAW,KAAK,CAAC,WAAW,IAAI,WAAW,GAAG,CAAA;AAClH,CAAC;AAED,iFAAiF;AACjF,SAAS,OAAO,CAAC,KAAkB;IACjC,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAA;IAC5C,OAAO,KAAK,CAAC,SAAS;SACnB,GAAG,CAAC,EAAE,CAAC,EAAE;QACR,MAAM,KAAK,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAA;QAC3D,OAAO,IAAI,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,GAAG,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,GAAG,CAAA;IAC7G,CAAC,CAAC;SACD,IAAI,CAAC,GAAG,CAAC,CAAA;AACd,CAAC;AAED,0BAA0B;AAC1B,SAAS,aAAa,CAAC,KAAkB;IACvC,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;QAAE,OAAO,GAAG,CAAA;IAC7C,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,CAAA;IAClF,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAA;IAClG,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,GAAG,GAAG,GAAG,QAAQ,EAAE,CAAA;AACpD,CAAC;AAED,8DAA8D;AAC9D,SAAS,YAAY,CAAC,KAAkB;IACtC,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,GAAG,CAAA;IAC5C,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,SAAS;QAChD,CAAC,CAAC,eAAe;QACjB,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAA;IACrE,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,MAAM,GAAG,CAAA;AAC7C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,KAAkB,EAAE,QAAgB;IAC/D,MAAM,MAAM,GAAG,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,QAAQ,CAAA;IACnE,IAAI,IAAI,GAAG,MAAM,CAAA;IACjB,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;IACrC,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;IACjD,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IACvC,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAA;IACnC,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;IAC5C,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAA;IACpD,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAA;IAClD,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IACnH,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IACvG,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;IACxC,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,CAAA;IACjE,OAAO,IAAI,CAAA;AACb,CAAC;AAED,0EAA0E;AAC1E,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAA;AAE1C;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc,EAAE,IAAY;IAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IACpE,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,OAAO,KAAK,EAAE,CAAA;AACxD,CAAC"}

package/lib/remote-methods.js

@@ -0,0 +1,32 @@
+/**
+ * The Remote surface, described once for both halves.
+ *
+ * The browser half cannot use the generated `ctx.remote.*` aggregate: that is
+ * assembled at build time from a fixed list of shipped packages. So the client
+ * mounts its own contribution (see `src/client/remote.ts`) built from this table,
+ * and the Host half decorates exactly these methods with `@Remote`. A method added
+ * to one side and forgotten here fails only when a user clicks.
+ *
+ * @module dsh-plugin-github-issues/remote-methods
+ */
+/** Every method the browser may call. */
+export const REMOTE_METHODS = [
+    { method: 'status', parameters: [] },
+    { method: 'catalog', parameters: [] },
+    { method: 'orgProjects', parameters: [{ wire: 'org' }] },
+    { method: 'orgRepos', parameters: [{ wire: 'org' }] },
+    { method: 'listIssues', parameters: [{ wire: 'request' }] },
+    { method: 'issueDetail', parameters: [{ wire: 'repo' }, { wire: 'number' }] },
+    { method: 'issueMentionedPRs', parameters: [{ wire: 'repo' }, { wire: 'number' }] },
+    { method: 'loadPrefs', parameters: [] },
+    { method: 'savePrefs', parameters: [{ wire: 'patch' }] },
+    { method: 'refresh', parameters: [] },
+    { method: 'links', parameters: [] },
+    { method: 'linkIssue', parameters: [{ wire: 'repo' }, { wire: 'number' }, { wire: 'sessionId' }] },
+    { method: 'unlinkIssue', parameters: [{ wire: 'repo' }, { wire: 'number' }, { wire: 'sessionId', optional: true }] },
+];
+/** The Cordis service key the controller registers, and the descriptor's `service` field. */
+export const REMOTE_SERVICE_KEY = 'githubIssuesController';
+/** The wire namespace both halves address this surface by. */
+export const REMOTE_NAMESPACE = 'githubIssues';
+//# sourceMappingURL=remote-methods.js.map

package/lib/remote-methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-methods.js","sourceRoot":"","sources":["../src/remote-methods.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAkBH,yCAAyC;AACzC,MAAM,CAAC,MAAM,cAAc,GAA4B;IACrD,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;IACpC,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE;IACrC,EAAE,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE;IACxD,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE;IACrD,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE;IAC3D,EAAE,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC7E,EAAE,MAAM,EAAE,mBAAmB,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE;IACnF,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,EAAE;IACvC,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE;IACxD,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE;IACrC,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE;IACnC,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE;IAClG,EAAE,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE;CACrH,CAAA;AAED,6FAA6F;AAC7F,MAAM,CAAC,MAAM,kBAAkB,GAAG,wBAAwB,CAAA;AAE1D,8DAA8D;AAC9D,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAA"}

package/lib/types/controller.d.ts

@@ -0,0 +1,105 @@
+/**
+ * The browser's way into GitHub.
+ *
+ * Everything that needs a credential happens here or below: the token is resolved
+ * on the Host, cached briefly in memory, and used only in an `Authorization`
+ * header. The browser half receives JSON view models and never a token.
+ *
+ * One `GitHubApi` is created lazily on the first call and re-created after a
+ * 401 (the machine's `gh` token may have been refreshed or revoked between
+ * sessions) or when the settings page asks for a refresh.
+ *
+ * @module dsh-plugin-github-issues/controller
+ */
+import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
+import type { GitHubApi, GitHubApiOptions, GhProbe, ResolvedAuth } from './github/types.ts';
+import type { PrefsStore } from './github/state.ts';
+import type { GitHubStatus, IssueBodyVM, IssueLinkRecord, IssueListPage, LinkedPRVM, Prefs, ProjectRefVM, RepoPageVM, ScopeCatalog } from './vm.ts';
+/** The Host-side collaborators the controller forwards to. */
+export interface ControllerOptions {
+    /** Probe `gh auth status` without exposing the token. */
+    probeGh: (config: {
+        host: string;
+        ghPath?: string;
+    }, signal?: AbortSignal) => Promise<GhProbe>;
+    /** Resolve the token from the machine's `gh` CLI. */
+    resolveToken: (config: {
+        host: string;
+        ghPath?: string;
+    }, signal?: AbortSignal) => Promise<ResolvedAuth>;
+    /** Create one API session for a token. */
+    createApi: (options: GitHubApiOptions) => GitHubApi;
+    /** Persisted preferences. */
+    prefs: PrefsStore;
+    /** Deployment configuration as the loader resolved it. */
+    config: {
+        authMode: string;
+        host: string;
+        ghPath: string;
+        handoffMode: string;
+        pollSeconds: number;
+    };
+}
+/** Remote owner of the GitHub Issues surface, namespace `githubIssues`. */
+export declare class GitHubIssuesController extends TypertRemoteService {
+    private readonly options;
+    private api;
+    private tokenAt;
+    private token;
+    /**
+     * @param ctx - the plugin context this service lives and dies with.
+     * @param options - the Host collaborators.
+     */
+    constructor(ctx: unknown, options: ControllerOptions);
+    /** Resolve one API session, reusing the token briefly. */
+    private apiNow;
+    /** Forget the cached token and session, so the next call re-resolves them. */
+    private forgetAuth;
+    private ghPath;
+    /** The membership the auth helpers accept, with no `undefined`-valued key. */
+    private authConfig;
+    /** Run one API operation, retrying once after a 401 with a freshly resolved token. */
+    private withApi;
+    /** Auth facts for the settings page: no token, only what `gh auth status` reports. */
+    status(): Promise<GitHubStatus>;
+    /** Repositories, organizations, projects, and the viewer. */
+    catalog(): Promise<ScopeCatalog>;
+    /** Attach the recorded session links to one card. */
+    private decorate;
+    /** One page of the list. */
+    listIssues(request: unknown): Promise<IssueListPage>;
+    /** Projects v2 of one organization; empty and `blocked` without `read:project`. */
+    orgProjects(org: string): Promise<{
+        projects: ProjectRefVM[];
+        blocked: boolean;
+        error?: string;
+    }>;
+    /** One organization's repositories, loaded when the organization is chosen. */
+    orgRepos(org: string): Promise<RepoPageVM>;
+    /** One issue with body and linked PRs. */
+    issueDetail(repo: string, number: number): Promise<IssueBodyVM>;
+    /** The issue's cross-referenced pull requests; fetched after the detail shows. */
+    issueMentionedPRs(repo: string, number: number): Promise<{
+        mentionedPRs: LinkedPRVM[];
+    }>;
+    /** Every recorded issue → session link (the dock resolves its own session). */
+    links(): Promise<IssueLinkRecord[]>;
+    /** Record that an issue was handed to one session. */
+    linkIssue(repo: string, number: number, sessionId: string): Promise<IssueLinkRecord[]>;
+    /** Remove one issue → session link, or all links of the issue. */
+    unlinkIssue(repo: string, number: number, sessionId?: string): Promise<IssueLinkRecord[]>;
+    /** Preferences persisted on the Host. */
+    loadPrefs(): Promise<Prefs>;
+    /** Merge one preference patch and persist it. */
+    savePrefs(patch: unknown): Promise<Prefs>;
+    /**
+     * Drop cached GitHub responses and the resolved token so the next request
+     * refetches. The token is re-resolved too: the user may have just granted a
+     * scope (`gh auth refresh -s read:project`) and the Host must see it at once,
+     * not after the five-minute token TTL.
+     */
+    refresh(): Promise<{
+        ok: true;
+    }>;
+}
+//# sourceMappingURL=controller.d.ts.map

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

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

package/lib/types/github/auth.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Resolving the machine's GitHub credential from the `gh` CLI.
+ *
+ * The plugin never asks for a token in its own UI: a developer machine that can
+ * run `gh` can list and read issues, and `gh auth token` hands the Host the same
+ * credential. Two invariants matter here:
+ *
+ * - **The token never leaves this module's success value.** It is not logged, not
+ *   placed in an error message, and not read from the environment by this code.
+ * - **A failure is always actionable.** "gh is missing", "not signed in", and
+ *   "gh failed" are distinct codes with human messages, so the settings card can
+ *   tell the user which of the three things to fix.
+ *
+ * @module dsh-plugin-github-issues/github/auth
+ */
+import { type GhProbe, type ResolvedAuth } from './types.ts';
+/** The facts both auth helpers need; matches the controller's collaborator type. */
+export interface GhAuthConfig {
+    /** GitHub host to authorize against, e.g. `github.com` or a GHES hostname. */
+    host: string;
+    /** Explicit `gh` executable path from Config; skips discovery when set. */
+    ghPath?: string;
+}
+/**
+ * Resolve the `gh` executable to run.
+ * An explicit Config value wins outright (the operator may point at a wrapper);
+ * otherwise the usual install locations are tried and a bare `gh` is left for
+ * PATH to resolve.
+ * @param ghPath - explicit path from Config, if any.
+ * @returns the executable path or the bare command name.
+ */
+export declare function resolveGhPath(ghPath?: string): string;
+/**
+ * Read what `gh auth status` says about this machine.
+ * Never throws for a missing CLI or a signed-out host — those are described by
+ * the returned value, because not being signed in is a normal first-run state.
+ * Only an abort is rethrown.
+ * @param config - host and optional explicit executable path.
+ * @param signal - cancellation signal, forwarded to the child process.
+ * @returns the probe facts, with `installed` false when gh cannot be started.
+ */
+export declare function probeGh(config: GhAuthConfig, signal?: AbortSignal): Promise<GhProbe>;
+/**
+ * Resolve the token for the configured host via `gh auth token`.
+ * A token is accepted only from a successful invocation; every failure path
+ * throws a {@link GitHubApiError} whose message is safe to render.
+ * @param config - host and optional explicit executable path.
+ * @param signal - cancellation signal, forwarded to the child process.
+ * @returns the token plus the account facts the settings card shows.
+ */
+export declare function resolveToken(config: GhAuthConfig, signal?: AbortSignal): Promise<ResolvedAuth>;
+//# sourceMappingURL=auth.d.ts.map

package/lib/types/github/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/github/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,EAAkB,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAA;AAQ5E,oFAAoF;AACpF,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAA;IACZ,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAkCD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAarD;AAyHD;;;;;;;;GAQG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAgC1F;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CA+CpG"}

package/lib/types/github/client.d.ts

@@ -0,0 +1,40 @@
+/**
+ * The Host-side GitHub GraphQL client.
+ *
+ * This is the only module that talks to api.github.com (or a GHES equivalent).
+ * It owns four concerns that the rest of the plugin should not have to know
+ * about:
+ *
+ * - **The credential.** The token lives in this closure and appears only in an
+ *   `Authorization` header; it is never logged and never placed in an error.
+ * - **Failure taxonomy.** GitHub answers GraphQL failures with HTTP 200 plus an
+ *   `errors[]` array, and transport failures with 401/403/404/429; both are
+ *   classified into a small set of codes so the UI can say what to fix.
+ * - **Scoping quirks.** Projects v2 need `read:project`, which a machine's `gh`
+ *   token may not have. That is a blocked picker, not a broken plugin, so it
+ *   degrades to `projectsBlocked` and a notice.
+ * - **Caching.** The panel polls, so responses are kept briefly in memory; a
+ *   refresh drops them. GraphQL has no conditional requests to rely on.
+ *
+ * The interface itself is defined in `types.ts`; this module only implements it.
+ *
+ * @module dsh-plugin-github-issues/github/client
+ */
+import type { GitHubApi, GitHubApiOptions } from './types.ts';
+/**
+ * The GraphQL endpoint for one host.
+ * github.com uses the dedicated API host; every GitHub Enterprise Server host
+ * serves GraphQL under its own `/api/graphql` path.
+ * @param host - configured host, e.g. `github.com` or `ghe.example.com`.
+ * @returns the absolute GraphQL endpoint.
+ */
+export declare function endpointFor(host: string): string;
+/**
+ * Create one GitHub API session.
+ * The returned object caches responses for a few minutes and caches the resolved
+ * scope catalog for five, so the caller may create it once per resolved token.
+ * @param options - the token, host, and optional session-wide abort signal.
+ * @returns the API the controller forwards to.
+ */
+export declare function createGitHubApi(options: GitHubApiOptions): GitHubApi;
+//# sourceMappingURL=client.d.ts.map

package/lib/types/github/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/github/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAcH,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AA4M7D;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOhD;AAwvBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAEpE"}

package/lib/types/github/queries.d.ts

@@ -0,0 +1,172 @@
+/**
+ * The GraphQL documents and variable builders the Host sends to GitHub.
+ *
+ * Queries are built per view instead of as one mega-document on purpose: a
+ * schema mismatch or a missing scope in one view must not break the others, and
+ * the search, repository, project, and detail endpoints accept different
+ * arguments. All documents are static text plus variables, except the project
+ * discovery query, whose organization aliases are generated from the viewer's
+ * organization list.
+ *
+ * Everything here is pure: no fetch, no token, no Node imports.
+ *
+ * @module dsh-plugin-github-issues/github/queries
+ */
+import type { IssueListRequest, IssueState, ListView } from '../vm.ts';
+/** One GraphQL operation ready to POST: the document and its variables. */
+export interface GitHubGraphQLRequest {
+    query: string;
+    variables: Record<string, unknown>;
+}
+/** The list views that are served by GitHub's search API. */
+export type SearchView = Exclude<ListView, 'project'>;
+/**
+ * The scope catalog: the viewer, their organizations, and their repositories.
+ * One request is one point at this page size. A second request is issued by the
+ * client when the repository connection has more pages (capped at 200 repos).
+ * @param after - cursor from the previous page, or `null` for the first page.
+ * @returns the operation and its variables.
+ */
+export declare function buildScopeQuery(after: string | null): GitHubGraphQLRequest;
+/**
+ * Projects v2 discovery for the project picker.
+ * Every `ProjectV2` field except `totalCount` needs `read:project`, so the whole
+ * request fails with `INSUFFICIENT_SCOPES` on a token without it; the client
+ * treats that as a blocked picker rather than an error. One alias per
+ * organization keeps the request count at one.
+ * @param orgs - organization logins to list projects for (the caller caps this).
+ * @returns the operation and its variables.
+ */
+export declare function buildProjectsQuery(orgs: readonly string[]): GitHubGraphQLRequest;
+/**
+ * The fields of one project, including single-select options.
+ * `ProjectV2.fields` returns the `ProjectV2FieldConfiguration` union, so each
+ * member has to be selected explicitly rather than through common fields.
+ * Kept for the project-view field/priority picker; the items query reads the
+ * selected `Priority` value directly.
+ * @param projectId - the project's GraphQL node id.
+ * @returns the operation and its variables.
+ */
+export declare function buildProjectFieldsQuery(projectId: string): GitHubGraphQLRequest;
+/**
+ * One page of projects v2 items, with the `Priority` field and the issue or
+ * pull-request content each item holds. Drafts are selected only enough to be
+ * recognised and skipped.
+ * @param input - project id and page window.
+ * @returns the operation and its variables.
+ */
+export declare function buildProjectItemsQuery(input: {
+    projectId: string;
+    first: number;
+    after: string | null;
+    /** Projects v2 filter DSL (`is:open assignee:@me`), evaluated by GitHub. */
+    filter?: string;
+}): GitHubGraphQLRequest;
+/**
+ * Free-text search for the assigned, created, open, and multi-repository views.
+ * Search is the one endpoint that spans all accessible repositories in a single
+ * point, so the repo view also uses it when more than one repository is
+ * selected; a single repository uses the exact `issues` connection instead.
+ * @param input - the search query string and page window.
+ * @returns the operation and its variables.
+ */
+export declare function buildSearchIssuesQuery(input: {
+    search: string;
+    first: number;
+    after: string | null;
+}): GitHubGraphQLRequest;
+/**
+ * One repository's issues, with exact `totalCount` and cursor paging.
+ * Used for the repo view's single-repository case; `states` is a list and the
+ * order is always most-recently-updated first.
+ * @param input - repository, states, and page window.
+ * @returns the operation and its variables.
+ */
+export declare function buildRepoIssuesQuery(input: {
+    owner: string;
+    name: string;
+    states: readonly IssueState[];
+    first: number;
+    after: string | null;
+}): GitHubGraphQLRequest;
+/**
+ * One issue with its body and card fields.
+ *
+ * The cross-reference timeline is *not* part of this request: it is the slowest
+ * leg of the detail (a timeline scan plus a full PR fragment per entry), so the
+ * panel asks for it separately after the detail is already on screen. See
+ * {@link buildMentionedPRsQuery}.
+ * @param input - repository and issue number.
+ * @returns the operation and its variables.
+ */
+export declare function buildIssueDetailQuery(input: {
+    owner: string;
+    name: string;
+    number: number;
+}): GitHubGraphQLRequest;
+/**
+ * The issue's cross-referenced pull requests (the slow timeline leg).
+ * @param input - repository and issue number.
+ * @returns the operation and its variables.
+ */
+export declare function buildMentionedPRsQuery(input: {
+    owner: string;
+    name: string;
+    number: number;
+}): GitHubGraphQLRequest;
+/**
+ * Turn the UI's three-way state filter into the `states` argument value.
+ * @param state - the requested filter; absent means open issues.
+ * @returns the values for the `[IssueState!]` argument.
+ */
+export declare function statesForView(state: IssueListRequest['state']): IssueState[];
+/**
+ * The GitHub search string for one search-backed view.
+ * `sort:` and `state:` are qualifiers inside the query string, not GraphQL
+ * arguments; `is:issue` is mandatory because `type: ISSUE` also matches pull
+ * requests. Multiple `repo:` qualifiers are OR-ed by GitHub, which is how the
+ * multi-repository view stays a single request.
+ * @param view - a search-backed view (the project view is not one).
+ * @param request - the normalized list request.
+ * @returns the query string, e.g. `is:issue assignee:@me state:open sort:updated-desc`.
+ */
+export declare function searchStringFor(view: SearchView, request: Pick<IssueListRequest, 'state' | 'repos'>): string;
+/**
+ * Projects v2 discovery for one organization, on demand.
+ * @param org - the organization login.
+ * @returns the operation and its variables.
+ */
+export declare function buildOrgProjectsQuery(org: string): GitHubGraphQLRequest;
+/**
+ * One page of an organization's repositories, forks included.
+ * GitHub's `organization.repositories` has no search argument, so the browser
+ * filters the fetched pages locally.
+ * @param input - organization, page window, and page size.
+ * @returns the operation and its variables.
+ */
+export declare function buildOrgReposQuery(input: {
+    org: string;
+    first: number;
+    after: string | null;
+}): GitHubGraphQLRequest;
+/**
+ * The issue search string for a cascade request.
+ *
+ * `is:issue` is mandatory because `search(type: ISSUE)` also matches pull
+ * requests. `org:` and `repo:` are ordinary search qualifiers, so an
+ * organization-wide list costs the same one point as a global one.
+ * @param request - the scope and filters.
+ * @returns e.g. `is:issue org:one2x-ai assignee:@me state:open sort:updated-desc`.
+ */
+export declare function searchStringForFilters(request: Pick<IssueListRequest, 'org' | 'repos' | 'assignee' | 'author' | 'state'>): string;
+/**
+ * The Projects v2 item filter for a cascade request. GitHub evaluates it
+ * server-side, so a state filter on a 126-item board returns the 25 open ones
+ * rather than the first page filtered locally.
+ * @param request - the state and assignee filters.
+ * @returns e.g. `is:open assignee:@me`, or an empty string for no filter.
+ */
+export declare function projectItemsFilterFor(request: Pick<IssueListRequest, 'assignee' | 'state'>): string;
+/** The repository filter a project view applies to its item content. */
+export declare function reposFor(request: Pick<IssueListRequest, 'repos'>): string[];
+//# sourceMappingURL=queries.d.ts.map

package/lib/types/github/queries.d.ts.map

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

package/lib/types/github/state.d.ts

@@ -0,0 +1,51 @@
+/**
+ * The plugin's non-secret state file.
+ *
+ * Preferences (which repo or project the panel shows, the pinned issue, the
+ * handoff template) are not credentials, so they live in the plugin's own
+ * directory instead of the DSH settings profile: the profile patch is rewritten
+ * by upgrades and its `.bak` copies would duplicate whatever is written there.
+ *
+ * @module dsh-plugin-github-issues/github/state
+ */
+import { type IssueLinkRecord, type IssueSessionLinkVM, type Prefs } from '../vm.ts';
+/**
+ * Apply a browser-supplied preference patch onto the current preferences.
+ * @param current - the preferences currently stored.
+ * @param patch - the untrusted patch.
+ * @returns the next preferences, with every field validated.
+ */
+export declare function applyPrefsPatch(current: Prefs, patch: unknown): Prefs;
+/** File-backed preference storage for one installation. */
+export declare class PrefsStore {
+    private readonly stateDir;
+    private readonly configureHandoff;
+    private readonly configureTemplate;
+    private readonly file;
+    private readonly directory;
+    private cached;
+    private cachedLinks;
+    /**
+     * @param stateDir - owner-only directory this installation's state lives in.
+     * @param configureHandoff - the deployment's default handoff mode.
+     * @param configureTemplate - the deployment's default prompt template.
+     */
+    constructor(stateDir: string, configureHandoff: string | undefined, configureTemplate: string | undefined);
+    /** Read the current preferences, creating defaults on first use. */
+    load(): Prefs;
+    /** Every recorded issue → session link, oldest first. */
+    links(): IssueLinkRecord[];
+    /** The links recorded for one issue, newest last. */
+    linksFor(repo: string, number: number): IssueSessionLinkVM[];
+    /** Record one issue → session handoff, idempotently. */
+    link(repo: string, number: number, sessionId: string): IssueLinkRecord[];
+    /** Remove one link (or every link for the issue when `sessionId` is omitted). */
+    unlink(repo: string, number: number, sessionId?: string): IssueLinkRecord[];
+    /** Read the state file once, tolerating absence, v1 files, and corruption. */
+    private readFile;
+    /** Merge one patch into the stored preferences and persist them. */
+    save(patch: unknown): Prefs;
+    /** Write the whole state document atomically with owner-only permissions. */
+    private writeFile;
+}
+//# sourceMappingURL=state.d.ts.map