@ghcrawl/api-contract 0.1.0 → 0.1.1

package/dist/contracts.d.ts.map

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

package/dist/contracts.js

@@ -0,0 +1,174 @@
+import { z } from 'zod';
+export const threadKindSchema = z.enum(['issue', 'pull_request']);
+export const searchModeSchema = z.enum(['keyword', 'semantic', 'hybrid']);
+export const repositorySchema = z.object({
+    id: z.number().int().positive(),
+    owner: z.string(),
+    name: z.string(),
+    fullName: z.string(),
+    githubRepoId: z.string().nullable(),
+    updatedAt: z.string(),
+});
+export const threadSchema = z.object({
+    id: z.number().int().positive(),
+    repoId: z.number().int().positive(),
+    number: z.number().int().positive(),
+    kind: threadKindSchema,
+    state: z.string(),
+    title: z.string(),
+    body: z.string().nullable(),
+    authorLogin: z.string().nullable(),
+    htmlUrl: z.string().url(),
+    labels: z.array(z.string()),
+    updatedAtGh: z.string().nullable(),
+    clusterId: z.number().int().positive().nullable().optional(),
+});
+export const healthResponseSchema = z.object({
+    ok: z.boolean(),
+    configPath: z.string(),
+    configFileExists: z.boolean(),
+    dbPath: z.string(),
+    apiPort: z.number().int().positive(),
+    githubConfigured: z.boolean(),
+    openaiConfigured: z.boolean(),
+});
+export const repositoriesResponseSchema = z.object({
+    repositories: z.array(repositorySchema),
+});
+export const threadsResponseSchema = z.object({
+    repository: repositorySchema,
+    threads: z.array(threadSchema),
+});
+export const neighborSchema = z.object({
+    threadId: z.number().int().positive(),
+    number: z.number().int().positive(),
+    kind: threadKindSchema,
+    title: z.string(),
+    score: z.number(),
+});
+export const searchHitSchema = z.object({
+    thread: threadSchema,
+    keywordScore: z.number().nullable(),
+    semanticScore: z.number().nullable(),
+    hybridScore: z.number(),
+    neighbors: z.array(neighborSchema).default([]),
+});
+export const searchResponseSchema = z.object({
+    repository: repositorySchema,
+    query: z.string(),
+    mode: searchModeSchema,
+    hits: z.array(searchHitSchema),
+});
+export const neighborsResponseSchema = z.object({
+    repository: repositorySchema,
+    thread: threadSchema,
+    neighbors: z.array(neighborSchema),
+});
+export const clusterMemberSchema = z.object({
+    threadId: z.number().int().positive(),
+    number: z.number().int().positive(),
+    kind: threadKindSchema,
+    title: z.string(),
+    scoreToRepresentative: z.number().nullable(),
+});
+export const clusterSchema = z.object({
+    id: z.number().int().positive(),
+    repoId: z.number().int().positive(),
+    representativeThreadId: z.number().int().positive().nullable(),
+    memberCount: z.number().int().nonnegative(),
+    members: z.array(clusterMemberSchema),
+});
+export const clustersResponseSchema = z.object({
+    repository: repositorySchema,
+    clusters: z.array(clusterSchema),
+});
+export const repoStatsSchema = z.object({
+    openIssueCount: z.number().int().nonnegative(),
+    openPullRequestCount: z.number().int().nonnegative(),
+    lastGithubReconciliationAt: z.string().nullable(),
+    lastEmbedRefreshAt: z.string().nullable(),
+    staleEmbedThreadCount: z.number().int().nonnegative(),
+    staleEmbedSourceCount: z.number().int().nonnegative(),
+    latestClusterRunId: z.number().int().positive().nullable(),
+    latestClusterRunFinishedAt: z.string().nullable(),
+});
+export const clusterSummarySchema = z.object({
+    clusterId: z.number().int().positive(),
+    displayTitle: z.string(),
+    totalCount: z.number().int().nonnegative(),
+    issueCount: z.number().int().nonnegative(),
+    pullRequestCount: z.number().int().nonnegative(),
+    latestUpdatedAt: z.string().nullable(),
+    representativeThreadId: z.number().int().positive().nullable(),
+    representativeNumber: z.number().int().positive().nullable(),
+    representativeKind: threadKindSchema.nullable(),
+});
+export const clusterSummariesResponseSchema = z.object({
+    repository: repositorySchema,
+    stats: repoStatsSchema,
+    clusters: z.array(clusterSummarySchema),
+});
+export const threadSummariesSchema = z.object({
+    problem_summary: z.string().optional(),
+    solution_summary: z.string().optional(),
+    maintainer_signal_summary: z.string().optional(),
+    dedupe_summary: z.string().optional(),
+});
+export const clusterThreadDumpSchema = z.object({
+    thread: threadSchema,
+    bodySnippet: z.string().nullable(),
+    summaries: threadSummariesSchema,
+});
+export const clusterDetailResponseSchema = z.object({
+    repository: repositorySchema,
+    stats: repoStatsSchema,
+    cluster: clusterSummarySchema,
+    members: z.array(clusterThreadDumpSchema),
+});
+export const syncResultSchema = z.object({
+    runId: z.number().int().positive(),
+    threadsSynced: z.number().int().nonnegative(),
+    commentsSynced: z.number().int().nonnegative(),
+    threadsClosed: z.number().int().nonnegative(),
+});
+export const embedResultSchema = z.object({
+    runId: z.number().int().positive(),
+    embedded: z.number().int().nonnegative(),
+});
+export const clusterResultSchema = z.object({
+    runId: z.number().int().positive(),
+    edges: z.number().int().nonnegative(),
+    clusters: z.number().int().nonnegative(),
+});
+export const refreshRequestSchema = z.object({
+    owner: z.string(),
+    repo: z.string(),
+    sync: z.boolean().optional(),
+    embed: z.boolean().optional(),
+    cluster: z.boolean().optional(),
+});
+export const refreshResponseSchema = z.object({
+    repository: repositorySchema,
+    selected: z.object({
+        sync: z.boolean(),
+        embed: z.boolean(),
+        cluster: z.boolean(),
+    }),
+    sync: syncResultSchema.nullable(),
+    embed: embedResultSchema.nullable(),
+    cluster: clusterResultSchema.nullable(),
+});
+export const rerunActionSchema = z.enum(['summarize', 'embed', 'cluster']);
+export const actionRequestSchema = z.object({
+    owner: z.string(),
+    repo: z.string(),
+    action: rerunActionSchema,
+    threadNumber: z.number().int().positive().optional(),
+});
+export const actionResponseSchema = z.object({
+    ok: z.boolean(),
+    action: rerunActionSchema,
+    runId: z.number().int().positive().nullable(),
+    message: z.string(),
+});
+//# sourceMappingURL=contracts.js.map

package/dist/contracts.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './client.js';
+export * from './contracts.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC"}

package/{src/index.ts → dist/index.js}

@@ -1,2 +1,3 @@
 export * from './client.js';
 export * from './contracts.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghcrawl/api-contract",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "description": "ghcrawl shared transport contracts and validation schemas",
   "author": "PwrDrvr LLC <harold@pwrdrvr.com>",
@@ -23,21 +23,22 @@
     "node": ">=22"
   },
   "files": [
-    "src"
+    "dist"
   ],
   "publishConfig": {
     "access": "public"
   },
   "exports": {
     ".": {
-      "types": "./src/index.ts",
-      "default": "./src/index.ts"
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
     }
   },
   "dependencies": {
     "zod": "^3.24.1"
   },
   "scripts": {
+    "build": "tsc -p tsconfig.build.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "tsx --test src/*.test.ts src/**/*.test.ts"
   }

package/src/client.ts

@@ -1,135 +0,0 @@
-import {
-  actionRequestSchema,
-  actionResponseSchema,
-  clusterDetailResponseSchema,
-  clusterSummariesResponseSchema,
-  clustersResponseSchema,
-  healthResponseSchema,
-  refreshRequestSchema,
-  refreshResponseSchema,
-  repositoriesResponseSchema,
-  searchResponseSchema,
-  threadsResponseSchema,
-  type ActionRequest,
-  type ActionResponse,
-  type ClusterDetailResponse,
-  type ClusterSummariesResponse,
-  type ClustersResponse,
-  type HealthResponse,
-  type RefreshRequest,
-  type RefreshResponse,
-  type RepositoriesResponse,
-  type SearchMode,
-  type SearchResponse,
-  type ThreadsResponse,
-} from './contracts.js';
-
-export type GitcrawlClient = {
-  health: () => Promise<HealthResponse>;
-  listRepositories: () => Promise<RepositoriesResponse>;
-  listThreads: (params: { owner: string; repo: string; kind?: 'issue' | 'pull_request' }) => Promise<ThreadsResponse>;
-  search: (params: { owner: string; repo: string; query: string; mode?: SearchMode }) => Promise<SearchResponse>;
-  listClusters: (params: { owner: string; repo: string }) => Promise<ClustersResponse>;
-  listClusterSummaries: (params: {
-    owner: string;
-    repo: string;
-    minSize?: number;
-    limit?: number;
-    sort?: 'recent' | 'size';
-    search?: string;
-  }) => Promise<ClusterSummariesResponse>;
-  getClusterDetail: (params: {
-    owner: string;
-    repo: string;
-    clusterId: number;
-    memberLimit?: number;
-    bodyChars?: number;
-  }) => Promise<ClusterDetailResponse>;
-  refresh: (request: RefreshRequest) => Promise<RefreshResponse>;
-  rerun: (request: ActionRequest) => Promise<ActionResponse>;
-};
-
-type FetchLike = typeof fetch;
-
-async function readJson<T>(res: Response, schema: { parse: (value: unknown) => T }): Promise<T> {
-  if (!res.ok) {
-    const text = await res.text().catch(() => '');
-    throw new Error(`API request failed ${res.status} ${res.statusText}: ${text.slice(0, 2000)}`);
-  }
-  const value = (await res.json()) as unknown;
-  return schema.parse(value);
-}
-
-export function createGitcrawlClient(baseUrl: string, fetchImpl: FetchLike = fetch): GitcrawlClient {
-  const normalized = baseUrl.replace(/\/+$/, '');
-
-  return {
-    async health() {
-      const res = await fetchImpl(`${normalized}/health`);
-      return readJson(res, healthResponseSchema);
-    },
-    async listRepositories() {
-      const res = await fetchImpl(`${normalized}/repositories`);
-      return readJson(res, repositoriesResponseSchema);
-    },
-    async listThreads(params) {
-      const search = new URLSearchParams({ owner: params.owner, repo: params.repo });
-      if (params.kind) search.set('kind', params.kind);
-      const res = await fetchImpl(`${normalized}/threads?${search.toString()}`);
-      return readJson(res, threadsResponseSchema);
-    },
-    async search(params) {
-      const search = new URLSearchParams({
-        owner: params.owner,
-        repo: params.repo,
-        query: params.query,
-      });
-      if (params.mode) search.set('mode', params.mode);
-      const res = await fetchImpl(`${normalized}/search?${search.toString()}`);
-      return readJson(res, searchResponseSchema);
-    },
-    async listClusters(params) {
-      const search = new URLSearchParams({ owner: params.owner, repo: params.repo });
-      const res = await fetchImpl(`${normalized}/clusters?${search.toString()}`);
-      return readJson(res, clustersResponseSchema);
-    },
-    async listClusterSummaries(params) {
-      const search = new URLSearchParams({ owner: params.owner, repo: params.repo });
-      if (params.minSize !== undefined) search.set('minSize', String(params.minSize));
-      if (params.limit !== undefined) search.set('limit', String(params.limit));
-      if (params.sort) search.set('sort', params.sort);
-      if (params.search) search.set('search', params.search);
-      const res = await fetchImpl(`${normalized}/cluster-summaries?${search.toString()}`);
-      return readJson(res, clusterSummariesResponseSchema);
-    },
-    async getClusterDetail(params) {
-      const search = new URLSearchParams({
-        owner: params.owner,
-        repo: params.repo,
-        clusterId: String(params.clusterId),
-      });
-      if (params.memberLimit !== undefined) search.set('memberLimit', String(params.memberLimit));
-      if (params.bodyChars !== undefined) search.set('bodyChars', String(params.bodyChars));
-      const res = await fetchImpl(`${normalized}/cluster-detail?${search.toString()}`);
-      return readJson(res, clusterDetailResponseSchema);
-    },
-    async refresh(request) {
-      const body = refreshRequestSchema.parse(request);
-      const res = await fetchImpl(`${normalized}/actions/refresh`, {
-        method: 'POST',
-        headers: { 'content-type': 'application/json' },
-        body: JSON.stringify(body),
-      });
-      return readJson(res, refreshResponseSchema);
-    },
-    async rerun(request) {
-      const body = actionRequestSchema.parse(request);
-      const res = await fetchImpl(`${normalized}/actions/rerun`, {
-        method: 'POST',
-        headers: { 'content-type': 'application/json' },
-        body: JSON.stringify(body),
-      });
-      return readJson(res, actionResponseSchema);
-    },
-  };
-}

package/src/contracts.test.ts

@@ -1,85 +0,0 @@
-import test from 'node:test';
-import assert from 'node:assert/strict';
-
-import { actionRequestSchema, healthResponseSchema, neighborsResponseSchema, searchResponseSchema } from './contracts.js';
-
-test('health schema accepts configured status payload', () => {
-  const parsed = healthResponseSchema.parse({
-    ok: true,
-    configPath: '/Users/example/.config/ghcrawl/config.json',
-    configFileExists: true,
-    dbPath: 'data/ghcrawl.db',
-    apiPort: 5179,
-    githubConfigured: true,
-    openaiConfigured: false,
-  });
-
-  assert.equal(parsed.apiPort, 5179);
-});
-
-test('search schema rejects invalid mode', () => {
-  assert.throws(() =>
-    searchResponseSchema.parse({
-      repository: {
-        id: 1,
-        owner: 'openclaw',
-        name: 'openclaw',
-        fullName: 'openclaw/openclaw',
-        githubRepoId: null,
-        updatedAt: new Date().toISOString(),
-      },
-      query: 'panic',
-      mode: 'invalid',
-      hits: [],
-    }),
-  );
-});
-
-test('action request accepts optional thread number', () => {
-  const parsed = actionRequestSchema.parse({
-    owner: 'openclaw',
-    repo: 'openclaw',
-    action: 'summarize',
-    threadNumber: 42,
-  });
-
-  assert.equal(parsed.threadNumber, 42);
-});
-
-test('neighbors schema accepts repository, source thread, and neighbor list', () => {
-  const parsed = neighborsResponseSchema.parse({
-    repository: {
-      id: 1,
-      owner: 'openclaw',
-      name: 'openclaw',
-      fullName: 'openclaw/openclaw',
-      githubRepoId: null,
-      updatedAt: new Date().toISOString(),
-    },
-    thread: {
-      id: 10,
-      repoId: 1,
-      number: 42,
-      kind: 'issue',
-      state: 'open',
-      title: 'Downloader hangs',
-      body: 'The transfer never finishes.',
-      authorLogin: 'alice',
-      htmlUrl: 'https://github.com/openclaw/openclaw/issues/42',
-      labels: ['bug'],
-      updatedAtGh: new Date().toISOString(),
-      clusterId: null,
-    },
-    neighbors: [
-      {
-        threadId: 11,
-        number: 43,
-        kind: 'pull_request',
-        title: 'Fix downloader hang',
-        score: 0.93,
-      },
-    ],
-  });
-
-  assert.equal(parsed.neighbors[0].number, 43);
-});