@zhangj1164/dsh-github-issue 0.2.0 → 0.3.0

package/lib/types.d.ts

@@ -133,5 +133,135 @@ type GithubIssueOptimizeResult = {
     readonly message: string;
   };
 };
+/** One open issue a session can claim and work on. */
+interface GithubIssueTask {
+  /** Issue number inside its repository. */
+  readonly number: number;
+  /** Issue title. */
+  readonly title: string;
+  /** Issue body in Markdown; empty when the issue has none. */
+  readonly body: string;
+  /** Canonical browser URL of the issue. */
+  readonly url: string;
+  /** Every label name the issue carries. */
+  readonly labels: readonly string[];
+}
+/**
+ * Stable failure codes the issue intake calls report.
+ *
+ * The codes are the contract: a caller decides what to do from the code, and
+ * the message exists for the human reading the failure. `auth-missing` is
+ * separate from `auth-failure` because no credential and a rejected credential
+ * are different deployment problems with different fixes.
+ */
+type GithubIssueFailureCode = 'auth-missing' | 'auth-failure' | 'rate-limited' | 'invalid-repo' | 'invalid-request' | 'http-failure' | 'network-failure' | 'session-unavailable' | 'dispatch-failed';
+/** One failed issue intake call. */
+interface GithubIssueFailure {
+  /** Failure discriminator. */
+  readonly ok: false;
+  /** The code and the user-facing message. */
+  readonly error: {
+    readonly code: GithubIssueFailureCode;
+    readonly message: string;
+  };
+}
+/** Request to create one issue from an optimized report. */
+interface GithubIssueCreateRequest {
+  /** Repository URL override; omit to use this service's configured `repoUrl`. */
+  readonly repoUrl?: string;
+  /** The report to file. */
+  readonly report: GithubIssueReport;
+}
+/** The issue GitHub created. */
+interface GithubIssueCreated {
+  /** Issue number inside the repository. */
+  readonly number: number;
+  /** Canonical browser URL of the new issue. */
+  readonly url: string;
+}
+/** Result of filing one issue. */
+type GithubIssueCreateResult = {
+  readonly ok: true;
+  readonly value: GithubIssueCreated;
+} | GithubIssueFailure;
+/** Request to list the open issues carrying the claim label. */
+interface GithubIssueListRequest {
+  /** Repository URL override; omit to use this service's configured `repoUrl`. */
+  readonly repoUrl?: string;
+  /** Claim label override; omit to use the configured `claimLabel`. */
+  readonly claimLabel?: string;
+  /** Largest number of issues to request; omit to use `maxIssuesPerRun`. */
+  readonly max?: number;
+}
+/** Result of listing claimable issues. */
+type GithubIssueListResult = {
+  readonly ok: true;
+  readonly value: readonly GithubIssueTask[];
+} | GithubIssueFailure;
+/** Request to hand one issue to a new Session. */
+interface GithubIssueDispatchRequest {
+  /** The issue to work on. */
+  readonly issue: GithubIssueTask;
+  /** Working directory the Session owns; omit to use the configured default. */
+  readonly cwd?: string;
+  /** Agent preset the Session runs; omit to use the configured default. */
+  readonly agentPreset?: string;
+}
+/** Result of dispatching one issue. */
+type GithubIssueDispatchResult = {
+  readonly ok: true;
+  readonly value: {
+    readonly sessionId: string;
+  };
+} | GithubIssueFailure;
+/** Request to run one intake pass over the configured repository. */
+interface GithubIssueIntakeRequest {
+  /** Repository URL override; omit to use this service's configured `repoUrl`. */
+  readonly repoUrl?: string;
+  /** Claim label override; omit to use the configured `claimLabel`. */
+  readonly claimLabel?: string;
+  /** Largest number of issues to dispatch in this pass. */
+  readonly max?: number;
+  /** Working directory each dispatched Session owns. */
+  readonly cwd?: string;
+  /** Agent preset each dispatched Session runs. */
+  readonly agentPreset?: string;
+}
+/** One issue handed to a Session during an intake pass. */
+interface GithubIssueDispatched {
+  /** Issue number. */
+  readonly number: number;
+  /** Session created for it. */
+  readonly sessionId: string;
+}
+/** One issue an intake pass selected but could not dispatch. */
+interface GithubIssueIntakeFailure {
+  /** Issue number. */
+  readonly number: number;
+  /** Stable failure code. */
+  readonly code: GithubIssueFailureCode;
+  /** User-facing explanation. */
+  readonly message: string;
+}
+/** What one intake pass did. */
+interface GithubIssueIntakeValue {
+  /** Wall-clock time the pass ran, in epoch milliseconds. */
+  readonly checkedAt: number;
+  /** Repository the pass read. */
+  readonly repoUrl: string;
+  /** Issues the claim label selected. */
+  readonly claimable: readonly GithubIssueTask[];
+  /** Issues handed to a Session in this pass. */
+  readonly dispatched: readonly GithubIssueDispatched[];
+  /** Issue numbers skipped because an earlier pass already dispatched them. */
+  readonly skipped: readonly number[];
+  /** Issues the pass selected but could not dispatch. */
+  readonly failures: readonly GithubIssueIntakeFailure[];
+}
+/** Result of one intake pass. */
+type GithubIssueIntakeResult = {
+  readonly ok: true;
+  readonly value: GithubIssueIntakeValue;
+} | GithubIssueFailure;
 //#endregion
-export { GithubIssueAnalysisWindow, GithubIssueFailureGroupInput, GithubIssueFailureRoute, GithubIssueGenerateReportRequest, GithubIssueGenerateReportResult, GithubIssueOptimizeRequest, GithubIssueOptimizeResult, GithubIssuePrefillRequest, GithubIssuePrefillResult, GithubIssueReport };
+export { GithubIssueAnalysisWindow, GithubIssueCreateRequest, GithubIssueCreateResult, GithubIssueCreated, GithubIssueDispatchRequest, GithubIssueDispatchResult, GithubIssueDispatched, GithubIssueFailure, GithubIssueFailureCode, GithubIssueFailureGroupInput, GithubIssueFailureRoute, GithubIssueGenerateReportRequest, GithubIssueGenerateReportResult, GithubIssueIntakeFailure, GithubIssueIntakeRequest, GithubIssueIntakeResult, GithubIssueIntakeValue, GithubIssueListRequest, GithubIssueListResult, GithubIssueOptimizeRequest, GithubIssueOptimizeResult, GithubIssuePrefillRequest, GithubIssuePrefillResult, GithubIssueReport, GithubIssueTask };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zhangj1164/dsh-github-issue",
-  "description": "GitHub issue generation and optimization service for DeepSeek Harness: builds structured issue reports from telemetry analysis, pre-filled issue URLs, and AI-optimized descriptions",
-  "version": "0.2.0",
+  "description": "GitHub issue generation, filing, and intake service for DeepSeek Harness: structured reports from telemetry analysis, AI-optimized descriptions, direct issue creation, and first-startup dispatch of claimable issues to new Sessions",
+  "version": "0.3.0",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -44,19 +44,27 @@
     }
   },
   "dependencies": {
-    "@deepseek-ai/schemastery": "^3.18.0",
+    "@deepseek-ai/cosmokit": "^1.8.6",
+    "@deepseek-ai/schemastery": "^3.18.4",
     "zod": "^4.6.5"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "~4.0.5",
     "@deepseek-ai/dsh-invariants": "^0.2.0-rc.2",
     "@deepseek-ai/dsh-llm": "^0.2.1-rc.2",
+    "@deepseek-ai/dsh-storage-domain": "^0.2.1-rc.2",
     "@deepseek-ai/dsh-typert-protocol": "^0.2.1-rc.2"
   },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-storage-domain": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@deepseek-ai/cordis": "~4.0.5",
     "@deepseek-ai/dsh-invariants": "^0.2.0-rc.2",
     "@deepseek-ai/dsh-llm": "^0.2.1-rc.2",
+    "@deepseek-ai/dsh-storage-domain": "^0.2.1-rc.2",
     "@deepseek-ai/dsh-typert-protocol": "^0.2.1-rc.2",
     "@types/node": "^26.5.1",
     "tsdown": "^0.22.2",