@kb-labs/qa-contracts 0.6.0

package/dist/index.js

@@ -0,0 +1,319 @@
+import { z } from 'zod';
+
+// src/types/rest-api.ts
+var CheckTypeSchema = z.string();
+var GitInfoSchema = z.object({
+  commit: z.string(),
+  branch: z.string()
+});
+var GitInfoWithMessageSchema = GitInfoSchema.extend({
+  message: z.string()
+});
+var CheckSummarySchema = z.object({
+  passed: z.number(),
+  failed: z.number(),
+  skipped: z.number()
+});
+var QASummaryRequestSchema = z.object({});
+var QASummaryCheckSchema = z.object({
+  checkType: z.string(),
+  label: z.string(),
+  icon: z.string().optional(),
+  passed: z.number(),
+  failed: z.number(),
+  skipped: z.number(),
+  total: z.number()
+});
+var QASummaryResponseSchema = z.object({
+  status: z.string(),
+  lastRunAt: z.string().nullable(),
+  git: GitInfoWithMessageSchema.nullable(),
+  checks: z.array(QASummaryCheckSchema),
+  hasBaseline: z.boolean(),
+  baselineTimestamp: z.string().nullable(),
+  historyCount: z.number()
+});
+var QALatestRequestSchema = z.object({});
+var HistoryEntrySchema = z.object({
+  timestamp: z.string(),
+  git: GitInfoWithMessageSchema,
+  status: z.enum(["passed", "failed"]),
+  summary: z.record(CheckTypeSchema, CheckSummarySchema),
+  failedPackages: z.record(CheckTypeSchema, z.array(z.string()))
+});
+var QALatestResponseSchema = z.object({
+  entry: HistoryEntrySchema.nullable()
+});
+var QAHistoryRequestSchema = z.object({
+  limit: z.number().optional()
+});
+var QAHistoryResponseSchema = z.object({
+  entries: z.array(HistoryEntrySchema),
+  total: z.number()
+});
+var QATrendsRequestSchema = z.object({
+  window: z.number().optional(),
+  enriched: z.boolean().optional()
+});
+var TrendResultSchema = z.object({
+  checkType: CheckTypeSchema,
+  label: z.string().optional(),
+  icon: z.string().optional(),
+  previous: z.number(),
+  current: z.number(),
+  delta: z.number(),
+  trend: z.enum(["regression", "improvement", "no-change"])
+});
+var QATrendsResponseSchema = z.object({
+  trends: z.array(TrendResultSchema),
+  historyCount: z.number(),
+  window: z.number()
+});
+var TrendTimeSeriesPointSchema = z.object({
+  timestamp: z.string(),
+  gitCommit: z.string(),
+  gitBranch: z.string(),
+  gitMessage: z.string(),
+  passed: z.number(),
+  failed: z.number(),
+  skipped: z.number()
+});
+var TrendChangelogEntrySchema = z.object({
+  timestamp: z.string(),
+  gitCommit: z.string(),
+  gitMessage: z.string(),
+  newFailures: z.array(z.string()),
+  fixed: z.array(z.string()),
+  delta: z.number()
+});
+var EnrichedTrendResultSchema = z.object({
+  checkType: CheckTypeSchema,
+  label: z.string().optional(),
+  icon: z.string().optional(),
+  timeSeries: z.array(TrendTimeSeriesPointSchema),
+  changelog: z.array(TrendChangelogEntrySchema),
+  current: z.number(),
+  previous: z.number(),
+  delta: z.number(),
+  trend: z.enum(["regression", "improvement", "no-change"]),
+  velocity: z.number()
+});
+var QAEnrichedTrendsResponseSchema = z.object({
+  trends: z.array(EnrichedTrendResultSchema),
+  historyCount: z.number(),
+  window: z.number()
+});
+var QARegressionsRequestSchema = z.object({
+  scope: z.string().optional()
+});
+var RegressionEntrySchema = z.object({
+  checkType: z.string(),
+  delta: z.number(),
+  newFailures: z.array(z.string())
+});
+var QARegressionsResponseSchema = z.object({
+  hasRegressions: z.boolean(),
+  regressions: z.array(RegressionEntrySchema),
+  scope: z.string().optional()
+});
+var QABaselineRequestSchema = z.object({});
+var BaselineCheckSnapshotSchema = z.object({
+  passed: z.number(),
+  failed: z.number(),
+  failedPackages: z.array(z.string())
+});
+var BaselineSnapshotSchema = z.object({
+  timestamp: z.string(),
+  git: GitInfoSchema,
+  results: z.record(CheckTypeSchema, BaselineCheckSnapshotSchema)
+});
+var QABaselineResponseSchema = z.object({
+  baseline: BaselineSnapshotSchema.nullable()
+});
+var CheckResultSchema = z.object({
+  passed: z.array(z.string()),
+  failed: z.array(z.string()),
+  skipped: z.array(z.string()),
+  errors: z.record(z.string(), z.string())
+});
+var QARunRequestSchema = z.object({
+  skipChecks: z.array(z.string()).optional(),
+  saveToHistory: z.boolean().optional()
+});
+var QARunResponseSchema = z.object({
+  status: z.enum(["passed", "failed"]),
+  results: z.record(CheckTypeSchema, CheckResultSchema),
+  entry: HistoryEntrySchema.nullable(),
+  durationMs: z.number()
+});
+var SubmoduleInfoSchema = z.object({
+  name: z.string(),
+  commit: z.string(),
+  branch: z.string(),
+  dirty: z.boolean(),
+  message: z.string()
+});
+var PackageCheckDetailSchema = z.object({
+  name: z.string(),
+  repo: z.string(),
+  status: z.enum(["passed", "failed", "skipped"]),
+  error: z.string().optional(),
+  submodule: SubmoduleInfoSchema.optional()
+});
+var CheckDetailsSchema = z.object({
+  passed: z.array(PackageCheckDetailSchema),
+  failed: z.array(PackageCheckDetailSchema),
+  skipped: z.array(PackageCheckDetailSchema)
+});
+var QADetailsRequestSchema = z.object({});
+var QADetailsResponseSchema = z.object({
+  timestamp: z.string().nullable(),
+  git: GitInfoWithMessageSchema.nullable(),
+  submodules: z.record(z.string(), SubmoduleInfoSchema).optional(),
+  checks: z.record(CheckTypeSchema, CheckDetailsSchema)
+});
+var QARunCheckRequestSchema = z.object({
+  checkType: z.string(),
+  repo: z.string().optional(),
+  package: z.string().optional()
+});
+var QARunCheckResponseSchema = z.object({
+  checkType: CheckTypeSchema,
+  status: z.enum(["passed", "failed"]),
+  result: CheckResultSchema,
+  durationMs: z.number()
+});
+var QABaselineUpdateRequestSchema = z.object({});
+var QABaselineUpdateResponseSchema = z.object({
+  success: z.boolean(),
+  baseline: BaselineSnapshotSchema
+});
+var CheckDiffSchema = z.object({
+  newFailures: z.array(z.string()),
+  fixed: z.array(z.string()),
+  stillFailing: z.array(z.string()),
+  delta: z.number()
+});
+var QABaselineDiffRequestSchema = z.object({});
+var QABaselineDiffResponseSchema = z.object({
+  hasDiff: z.boolean(),
+  diff: z.record(CheckTypeSchema, CheckDiffSchema),
+  baseline: BaselineSnapshotSchema.nullable(),
+  current: z.object({
+    timestamp: z.string(),
+    summary: z.record(CheckTypeSchema, z.object({
+      passed: z.number(),
+      failed: z.number()
+    }))
+  }).nullable()
+});
+var PackageTimelineEntrySchema = z.object({
+  timestamp: z.string(),
+  git: GitInfoWithMessageSchema,
+  submoduleCommit: z.string().optional(),
+  checks: z.record(CheckTypeSchema, z.enum(["passed", "failed", "skipped"]))
+});
+var QAPackageTimelineRequestSchema = z.object({});
+var QAPackageTimelineResponseSchema = z.object({
+  packageName: z.string(),
+  repo: z.string(),
+  entries: z.array(PackageTimelineEntrySchema),
+  flakyScore: z.number(),
+  flakyChecks: z.array(CheckTypeSchema),
+  firstFailure: z.string().optional(),
+  currentStreak: z.object({
+    status: z.enum(["passing", "failing"]),
+    count: z.number()
+  })
+});
+var ErrorGroupSchema = z.object({
+  pattern: z.string(),
+  count: z.number(),
+  packages: z.array(z.string()),
+  checkType: CheckTypeSchema,
+  example: z.string()
+});
+var QAErrorGroupsRequestSchema = z.object({});
+var QAErrorGroupsResponseSchema = z.object({
+  groups: z.array(ErrorGroupSchema),
+  ungrouped: z.number()
+});
+
+// src/constants.ts
+var QA_DATA_DIR = ".kb/qa";
+var PATHS = {
+  BASELINE: ".kb/qa/baseline.json",
+  HISTORY: ".kb/qa/history.json",
+  CACHE: ".kb/qa/cache.json",
+  LAST_RUN: ".kb/qa/last-run.json"
+};
+var HISTORY_MAX_ENTRIES = 50;
+var TRENDS_WINDOW = 10;
+var DEFAULT_LABELS = {
+  build: "Build",
+  lint: "Lint",
+  typeCheck: "Type Check",
+  test: "Tests"
+};
+var DEFAULT_ICONS = {
+  build: "\u{1F528}",
+  lint: "\u{1F50D}",
+  typeCheck: "\u{1F4D8}",
+  test: "\u{1F9EA}"
+};
+function getCheckLabel(id, configName) {
+  return configName ?? DEFAULT_LABELS[id] ?? id;
+}
+function getCheckIcon(id, configIcon) {
+  return configIcon ?? DEFAULT_ICONS[id] ?? "\u2611\uFE0F";
+}
+
+// src/routes.ts
+var QA_BASE_PATH = "/v1/plugins/qa";
+var QA_ROUTES = {
+  /** GET /summary - Aggregated QA overview */
+  SUMMARY: "/summary",
+  /** GET /latest - Last QA run result */
+  LATEST: "/latest",
+  /** GET /history - QA run history */
+  HISTORY: "/history",
+  /** GET /trends - Trend analysis */
+  TRENDS: "/trends",
+  /** GET /regressions - Regression detection */
+  REGRESSIONS: "/regressions",
+  /** GET /baseline - Current baseline snapshot */
+  BASELINE: "/baseline",
+  /** POST /run - Run QA checks */
+  RUN: "/run",
+  /** GET /details - Per-package details with errors from last run */
+  DETAILS: "/details",
+  /** POST /run/check - Run a single check type */
+  RUN_CHECK: "/run/check",
+  /** POST /baseline/update - Update baseline from last run */
+  BASELINE_UPDATE: "/baseline/update",
+  /** GET /baseline/diff - Diff current state vs baseline */
+  BASELINE_DIFF: "/baseline/diff",
+  /** GET /packages/:name/timeline - Per-package QA history timeline */
+  PACKAGE_TIMELINE: "/packages/:name/timeline",
+  /** GET /errors/groups - Grouped errors by pattern */
+  ERROR_GROUPS: "/errors/groups"
+};
+var QA_FULL_ROUTES = {
+  SUMMARY: `${QA_BASE_PATH}${QA_ROUTES.SUMMARY}`,
+  LATEST: `${QA_BASE_PATH}${QA_ROUTES.LATEST}`,
+  HISTORY: `${QA_BASE_PATH}${QA_ROUTES.HISTORY}`,
+  TRENDS: `${QA_BASE_PATH}${QA_ROUTES.TRENDS}`,
+  REGRESSIONS: `${QA_BASE_PATH}${QA_ROUTES.REGRESSIONS}`,
+  BASELINE: `${QA_BASE_PATH}${QA_ROUTES.BASELINE}`,
+  RUN: `${QA_BASE_PATH}${QA_ROUTES.RUN}`,
+  DETAILS: `${QA_BASE_PATH}${QA_ROUTES.DETAILS}`,
+  RUN_CHECK: `${QA_BASE_PATH}${QA_ROUTES.RUN_CHECK}`,
+  BASELINE_UPDATE: `${QA_BASE_PATH}${QA_ROUTES.BASELINE_UPDATE}`,
+  BASELINE_DIFF: `${QA_BASE_PATH}${QA_ROUTES.BASELINE_DIFF}`,
+  PACKAGE_TIMELINE: `${QA_BASE_PATH}${QA_ROUTES.PACKAGE_TIMELINE}`,
+  ERROR_GROUPS: `${QA_BASE_PATH}${QA_ROUTES.ERROR_GROUPS}`
+};
+
+export { HISTORY_MAX_ENTRIES, PATHS, QABaselineDiffRequestSchema, QABaselineDiffResponseSchema, QABaselineRequestSchema, QABaselineResponseSchema, QABaselineUpdateRequestSchema, QABaselineUpdateResponseSchema, QADetailsRequestSchema, QADetailsResponseSchema, QAEnrichedTrendsResponseSchema, QAErrorGroupsRequestSchema, QAErrorGroupsResponseSchema, QAHistoryRequestSchema, QAHistoryResponseSchema, QALatestRequestSchema, QALatestResponseSchema, QAPackageTimelineRequestSchema, QAPackageTimelineResponseSchema, QARegressionsRequestSchema, QARegressionsResponseSchema, QARunCheckRequestSchema, QARunCheckResponseSchema, QARunRequestSchema, QARunResponseSchema, QASummaryCheckSchema, QASummaryRequestSchema, QASummaryResponseSchema, QATrendsRequestSchema, QATrendsResponseSchema, QA_BASE_PATH, QA_DATA_DIR, QA_FULL_ROUTES, QA_ROUTES, TRENDS_WINDOW, getCheckIcon, getCheckLabel };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types/rest-api.ts","../src/constants.ts","../src/routes.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * REST API Request/Response Types and Zod Schemas for QA Plugin\n */\n\nimport { z } from 'zod';\n\n// ============================================================================\n// Common schemas\n// ============================================================================\n\nconst CheckTypeSchema = z.string();\n\nconst GitInfoSchema = z.object({\n  commit: z.string(),\n  branch: z.string(),\n});\n\nconst GitInfoWithMessageSchema = GitInfoSchema.extend({\n  message: z.string(),\n});\n\nconst CheckSummarySchema = z.object({\n  passed: z.number(),\n  failed: z.number(),\n  skipped: z.number(),\n});\n\n// ============================================================================\n// Summary API\n// ============================================================================\n\nexport const QASummaryRequestSchema = z.object({});\n\nexport type QASummaryRequest = z.infer<typeof QASummaryRequestSchema>;\n\nexport const QASummaryCheckSchema = z.object({\n  checkType: z.string(),\n  label: z.string(),\n  icon: z.string().optional(),\n  passed: z.number(),\n  failed: z.number(),\n  skipped: z.number(),\n  total: z.number(),\n});\n\nexport const QASummaryResponseSchema = z.object({\n  status: z.string(),\n  lastRunAt: z.string().nullable(),\n  git: GitInfoWithMessageSchema.nullable(),\n  checks: z.array(QASummaryCheckSchema),\n  hasBaseline: z.boolean(),\n  baselineTimestamp: z.string().nullable(),\n  historyCount: z.number(),\n});\n\nexport type QASummaryResponse = z.infer<typeof QASummaryResponseSchema>;\n\n// ============================================================================\n// Latest API\n// ============================================================================\n\nexport const QALatestRequestSchema = z.object({});\n\nexport type QALatestRequest = z.infer<typeof QALatestRequestSchema>;\n\nconst HistoryEntrySchema = z.object({\n  timestamp: z.string(),\n  git: GitInfoWithMessageSchema,\n  status: z.enum(['passed', 'failed']),\n  summary: z.record(CheckTypeSchema, CheckSummarySchema),\n  failedPackages: z.record(CheckTypeSchema, z.array(z.string())),\n});\n\nexport const QALatestResponseSchema = z.object({\n  entry: HistoryEntrySchema.nullable(),\n});\n\nexport type QALatestResponse = z.infer<typeof QALatestResponseSchema>;\n\n// ============================================================================\n// History API\n// ============================================================================\n\nexport const QAHistoryRequestSchema = z.object({\n  limit: z.number().optional(),\n});\n\nexport type QAHistoryRequest = z.infer<typeof QAHistoryRequestSchema>;\n\nexport const QAHistoryResponseSchema = z.object({\n  entries: z.array(HistoryEntrySchema),\n  total: z.number(),\n});\n\nexport type QAHistoryResponse = z.infer<typeof QAHistoryResponseSchema>;\n\n// ============================================================================\n// Trends API\n// ============================================================================\n\nexport const QATrendsRequestSchema = z.object({\n  window: z.number().optional(),\n  enriched: z.boolean().optional(),\n});\n\nexport type QATrendsRequest = z.infer<typeof QATrendsRequestSchema>;\n\nconst TrendResultSchema = z.object({\n  checkType: CheckTypeSchema,\n  label: z.string().optional(),\n  icon: z.string().optional(),\n  previous: z.number(),\n  current: z.number(),\n  delta: z.number(),\n  trend: z.enum(['regression', 'improvement', 'no-change']),\n});\n\nexport const QATrendsResponseSchema = z.object({\n  trends: z.array(TrendResultSchema),\n  historyCount: z.number(),\n  window: z.number(),\n});\n\nexport type QATrendsResponse = z.infer<typeof QATrendsResponseSchema>;\n\n// --- Enriched Trends ---\n\nconst TrendTimeSeriesPointSchema = z.object({\n  timestamp: z.string(),\n  gitCommit: z.string(),\n  gitBranch: z.string(),\n  gitMessage: z.string(),\n  passed: z.number(),\n  failed: z.number(),\n  skipped: z.number(),\n});\n\nconst TrendChangelogEntrySchema = z.object({\n  timestamp: z.string(),\n  gitCommit: z.string(),\n  gitMessage: z.string(),\n  newFailures: z.array(z.string()),\n  fixed: z.array(z.string()),\n  delta: z.number(),\n});\n\nconst EnrichedTrendResultSchema = z.object({\n  checkType: CheckTypeSchema,\n  label: z.string().optional(),\n  icon: z.string().optional(),\n  timeSeries: z.array(TrendTimeSeriesPointSchema),\n  changelog: z.array(TrendChangelogEntrySchema),\n  current: z.number(),\n  previous: z.number(),\n  delta: z.number(),\n  trend: z.enum(['regression', 'improvement', 'no-change']),\n  velocity: z.number(),\n});\n\nexport const QAEnrichedTrendsResponseSchema = z.object({\n  trends: z.array(EnrichedTrendResultSchema),\n  historyCount: z.number(),\n  window: z.number(),\n});\n\nexport type QAEnrichedTrendsResponse = z.infer<typeof QAEnrichedTrendsResponseSchema>;\n\n// ============================================================================\n// Regressions API\n// ============================================================================\n\nexport const QARegressionsRequestSchema = z.object({\n  scope: z.string().optional(),\n});\n\nexport type QARegressionsRequest = z.infer<typeof QARegressionsRequestSchema>;\n\nconst RegressionEntrySchema = z.object({\n  checkType: z.string(),\n  delta: z.number(),\n  newFailures: z.array(z.string()),\n});\n\nexport type RegressionEntry = z.infer<typeof RegressionEntrySchema>;\n\nexport const QARegressionsResponseSchema = z.object({\n  hasRegressions: z.boolean(),\n  regressions: z.array(RegressionEntrySchema),\n  scope: z.string().optional(),\n});\n\n\nexport type QARegressionsResponse = z.infer<typeof QARegressionsResponseSchema>;\n\n// ============================================================================\n// Baseline API\n// ============================================================================\n\nexport const QABaselineRequestSchema = z.object({});\n\nexport type QABaselineRequest = z.infer<typeof QABaselineRequestSchema>;\n\nconst BaselineCheckSnapshotSchema = z.object({\n  passed: z.number(),\n  failed: z.number(),\n  failedPackages: z.array(z.string()),\n});\n\nconst BaselineSnapshotSchema = z.object({\n  timestamp: z.string(),\n  git: GitInfoSchema,\n  results: z.record(CheckTypeSchema, BaselineCheckSnapshotSchema),\n});\n\nexport const QABaselineResponseSchema = z.object({\n  baseline: BaselineSnapshotSchema.nullable(),\n});\n\nexport type QABaselineResponse = z.infer<typeof QABaselineResponseSchema>;\n\n// ============================================================================\n// Run API (POST)\n// ============================================================================\n\nconst CheckResultSchema = z.object({\n  passed: z.array(z.string()),\n  failed: z.array(z.string()),\n  skipped: z.array(z.string()),\n  errors: z.record(z.string(), z.string()),\n});\n\nexport const QARunRequestSchema = z.object({\n  skipChecks: z.array(z.string()).optional(),\n  saveToHistory: z.boolean().optional(),\n});\n\nexport type QARunRequest = z.infer<typeof QARunRequestSchema>;\n\nexport const QARunResponseSchema = z.object({\n  status: z.enum(['passed', 'failed']),\n  results: z.record(CheckTypeSchema, CheckResultSchema),\n  entry: HistoryEntrySchema.nullable(),\n  durationMs: z.number(),\n});\n\nexport type QARunResponse = z.infer<typeof QARunResponseSchema>;\n\n// ============================================================================\n// Details API (GET /details)\n// ============================================================================\n\nconst SubmoduleInfoSchema = z.object({\n  name: z.string(),\n  commit: z.string(),\n  branch: z.string(),\n  dirty: z.boolean(),\n  message: z.string(),\n});\n\nconst PackageCheckDetailSchema = z.object({\n  name: z.string(),\n  repo: z.string(),\n  status: z.enum(['passed', 'failed', 'skipped']),\n  error: z.string().optional(),\n  submodule: SubmoduleInfoSchema.optional(),\n});\n\nconst CheckDetailsSchema = z.object({\n  passed: z.array(PackageCheckDetailSchema),\n  failed: z.array(PackageCheckDetailSchema),\n  skipped: z.array(PackageCheckDetailSchema),\n});\n\nexport const QADetailsRequestSchema = z.object({});\n\nexport type QADetailsRequest = z.infer<typeof QADetailsRequestSchema>;\n\nexport const QADetailsResponseSchema = z.object({\n  timestamp: z.string().nullable(),\n  git: GitInfoWithMessageSchema.nullable(),\n  submodules: z.record(z.string(), SubmoduleInfoSchema).optional(),\n  checks: z.record(CheckTypeSchema, CheckDetailsSchema),\n});\n\nexport type QADetailsResponse = z.infer<typeof QADetailsResponseSchema>;\n\n// ============================================================================\n// Run Check API (POST /run/check)\n// ============================================================================\n\nexport const QARunCheckRequestSchema = z.object({\n  checkType: z.string(),\n  repo: z.string().optional(),\n  package: z.string().optional(),\n});\n\nexport type QARunCheckRequest = z.infer<typeof QARunCheckRequestSchema>;\n\nexport const QARunCheckResponseSchema = z.object({\n  checkType: CheckTypeSchema,\n  status: z.enum(['passed', 'failed']),\n  result: CheckResultSchema,\n  durationMs: z.number(),\n});\n\nexport type QARunCheckResponse = z.infer<typeof QARunCheckResponseSchema>;\n\n// ============================================================================\n// Baseline Update API (POST /baseline/update)\n// ============================================================================\n\nexport const QABaselineUpdateRequestSchema = z.object({});\n\nexport type QABaselineUpdateRequest = z.infer<typeof QABaselineUpdateRequestSchema>;\n\nexport const QABaselineUpdateResponseSchema = z.object({\n  success: z.boolean(),\n  baseline: BaselineSnapshotSchema,\n});\n\nexport type QABaselineUpdateResponse = z.infer<typeof QABaselineUpdateResponseSchema>;\n\n// ============================================================================\n// Baseline Diff API (GET /baseline/diff)\n// ============================================================================\n\nconst CheckDiffSchema = z.object({\n  newFailures: z.array(z.string()),\n  fixed: z.array(z.string()),\n  stillFailing: z.array(z.string()),\n  delta: z.number(),\n});\n\nexport const QABaselineDiffRequestSchema = z.object({});\n\nexport type QABaselineDiffRequest = z.infer<typeof QABaselineDiffRequestSchema>;\n\nexport const QABaselineDiffResponseSchema = z.object({\n  hasDiff: z.boolean(),\n  diff: z.record(CheckTypeSchema, CheckDiffSchema),\n  baseline: BaselineSnapshotSchema.nullable(),\n  current: z.object({\n    timestamp: z.string(),\n    summary: z.record(CheckTypeSchema, z.object({\n      passed: z.number(),\n      failed: z.number(),\n    })),\n  }).nullable(),\n});\n\nexport type QABaselineDiffResponse = z.infer<typeof QABaselineDiffResponseSchema>;\n\n// ============================================================================\n// Package Timeline API (GET /packages/:name/timeline)\n// ============================================================================\n\nconst PackageTimelineEntrySchema = z.object({\n  timestamp: z.string(),\n  git: GitInfoWithMessageSchema,\n  submoduleCommit: z.string().optional(),\n  checks: z.record(CheckTypeSchema, z.enum(['passed', 'failed', 'skipped'])),\n});\n\nexport const QAPackageTimelineRequestSchema = z.object({});\n\nexport type QAPackageTimelineRequest = z.infer<typeof QAPackageTimelineRequestSchema>;\n\nexport const QAPackageTimelineResponseSchema = z.object({\n  packageName: z.string(),\n  repo: z.string(),\n  entries: z.array(PackageTimelineEntrySchema),\n  flakyScore: z.number(),\n  flakyChecks: z.array(CheckTypeSchema),\n  firstFailure: z.string().optional(),\n  currentStreak: z.object({\n    status: z.enum(['passing', 'failing']),\n    count: z.number(),\n  }),\n});\n\nexport type QAPackageTimelineResponse = z.infer<typeof QAPackageTimelineResponseSchema>;\n\n// ============================================================================\n// Error Groups API (GET /errors/groups)\n// ============================================================================\n\nconst ErrorGroupSchema = z.object({\n  pattern: z.string(),\n  count: z.number(),\n  packages: z.array(z.string()),\n  checkType: CheckTypeSchema,\n  example: z.string(),\n});\n\nexport const QAErrorGroupsRequestSchema = z.object({});\n\nexport type QAErrorGroupsRequest = z.infer<typeof QAErrorGroupsRequestSchema>;\n\nexport const QAErrorGroupsResponseSchema = z.object({\n  groups: z.array(ErrorGroupSchema),\n  ungrouped: z.number(),\n});\n\nexport type QAErrorGroupsResponse = z.infer<typeof QAErrorGroupsResponseSchema>;\n","/**\n * Data directory for the QA plugin, relative to monorepo root.\n */\nexport const QA_DATA_DIR = '.kb/qa';\n\n/**\n * File paths for QA plugin data storage (relative to monorepo root).\n */\nexport const PATHS = {\n  BASELINE: '.kb/qa/baseline.json',\n  HISTORY: '.kb/qa/history.json',\n  CACHE: '.kb/qa/cache.json',\n  LAST_RUN: '.kb/qa/last-run.json',\n} as const;\n\n/**\n * Maximum number of history entries to keep.\n */\nexport const HISTORY_MAX_ENTRIES = 50;\n\n/**\n * Default number of entries for trend analysis window.\n */\nexport const TRENDS_WINDOW = 10;\n\n/**\n * Default labels for built-in check types.\n */\nconst DEFAULT_LABELS: Record<string, string> = {\n  build: 'Build',\n  lint: 'Lint',\n  typeCheck: 'Type Check',\n  test: 'Tests',\n};\n\n/**\n * Default icons (emoji) for built-in check types.\n */\nconst DEFAULT_ICONS: Record<string, string> = {\n  build: '🔨',\n  lint: '🔍',\n  typeCheck: '📘',\n  test: '🧪',\n};\n\n/**\n * Get display label for a check type. Priority: configName > known default > id.\n */\nexport function getCheckLabel(id: string, configName?: string): string {\n  return configName ?? DEFAULT_LABELS[id] ?? id;\n}\n\n/**\n * Get display icon (emoji) for a check type. Priority: configIcon > known default > generic.\n */\nexport function getCheckIcon(id: string, configIcon?: string): string {\n  return configIcon ?? DEFAULT_ICONS[id] ?? '☑️';\n}\n","/**\n * @module @kb-labs/qa-contracts/routes\n * REST API route constants for QA plugin\n */\n\n/**\n * REST API base path for QA plugin\n */\nexport const QA_BASE_PATH = '/v1/plugins/qa' as const;\n\n/**\n * REST API route paths (relative to basePath)\n */\nexport const QA_ROUTES = {\n  /** GET /summary - Aggregated QA overview */\n  SUMMARY: '/summary',\n\n  /** GET /latest - Last QA run result */\n  LATEST: '/latest',\n\n  /** GET /history - QA run history */\n  HISTORY: '/history',\n\n  /** GET /trends - Trend analysis */\n  TRENDS: '/trends',\n\n  /** GET /regressions - Regression detection */\n  REGRESSIONS: '/regressions',\n\n  /** GET /baseline - Current baseline snapshot */\n  BASELINE: '/baseline',\n\n  /** POST /run - Run QA checks */\n  RUN: '/run',\n\n  /** GET /details - Per-package details with errors from last run */\n  DETAILS: '/details',\n\n  /** POST /run/check - Run a single check type */\n  RUN_CHECK: '/run/check',\n\n  /** POST /baseline/update - Update baseline from last run */\n  BASELINE_UPDATE: '/baseline/update',\n\n  /** GET /baseline/diff - Diff current state vs baseline */\n  BASELINE_DIFF: '/baseline/diff',\n\n  /** GET /packages/:name/timeline - Per-package QA history timeline */\n  PACKAGE_TIMELINE: '/packages/:name/timeline',\n\n  /** GET /errors/groups - Grouped errors by pattern */\n  ERROR_GROUPS: '/errors/groups',\n} as const;\n\n/**\n * Full REST API URLs (basePath + route)\n * Useful for testing and documentation\n */\nexport const QA_FULL_ROUTES = {\n  SUMMARY: `${QA_BASE_PATH}${QA_ROUTES.SUMMARY}`,\n  LATEST: `${QA_BASE_PATH}${QA_ROUTES.LATEST}`,\n  HISTORY: `${QA_BASE_PATH}${QA_ROUTES.HISTORY}`,\n  TRENDS: `${QA_BASE_PATH}${QA_ROUTES.TRENDS}`,\n  REGRESSIONS: `${QA_BASE_PATH}${QA_ROUTES.REGRESSIONS}`,\n  BASELINE: `${QA_BASE_PATH}${QA_ROUTES.BASELINE}`,\n  RUN: `${QA_BASE_PATH}${QA_ROUTES.RUN}`,\n  DETAILS: `${QA_BASE_PATH}${QA_ROUTES.DETAILS}`,\n  RUN_CHECK: `${QA_BASE_PATH}${QA_ROUTES.RUN_CHECK}`,\n  BASELINE_UPDATE: `${QA_BASE_PATH}${QA_ROUTES.BASELINE_UPDATE}`,\n  BASELINE_DIFF: `${QA_BASE_PATH}${QA_ROUTES.BASELINE_DIFF}`,\n  PACKAGE_TIMELINE: `${QA_BASE_PATH}${QA_ROUTES.PACKAGE_TIMELINE}`,\n  ERROR_GROUPS: `${QA_BASE_PATH}${QA_ROUTES.ERROR_GROUPS}`,\n} as const;\n\nexport type QARoute = typeof QA_ROUTES[keyof typeof QA_ROUTES];\n"]}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@kb-labs/qa-contracts",
+  "version": "0.6.0",
+  "type": "module",
+  "description": "Contracts for KB Labs QA Plugin — types, interfaces, and constants for QA checks, baselines, and history tracking.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./dist/*": "./dist/*"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "pretype-check": "pnpm --filter @kb-labs/qa-contracts build",
+    "clean": "rimraf dist",
+    "build": "tsup --config tsup.config.ts",
+    "dev": "tsup --config tsup.config.ts --watch",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint . --fix",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@kb-labs/devkit": "link:../../../../infra/kb-labs-devkit",
+    "@types/node": "^24.3.3",
+    "rimraf": "^6.0.1",
+    "tsup": "^8.5.0",
+    "typescript": "^5.6.3",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "pnpm": ">=9.0.0"
+  }
+}