@kernhq/module-tracker 0.1.1 → 0.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kernhq/module-tracker",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Kern tracker module: projects, work item types, custom fields, workflows, issues, KQL, cycles, views, reports, intake, time tracking (server + client skeleton)",
   "license": "AGPL-3.0-only",
   "type": "module",
@@ -15,7 +15,9 @@
   "files": [
     "dist",
     "migrations",
-    "src/client"
+    "src/client",
+    "src/contract",
+    "src/kql"
   ],
   "exports": {
     "./contract": {

package/src/client/api.ts

@@ -1,6 +1,6 @@
-import type { TrackerContract } from '@kernhq/module-tracker/contract'
 import { createModuleClient, type KernClientOptions } from '@kernhq/sdk'
 import type { ContractRouterClient } from '@orpc/contract'
+import type { TrackerContract } from '../contract/index.js'
 
 /**
  * Typed oRPC client for `/api/tracker` (see `../contract`).

package/src/client/format.ts

@@ -1,5 +1,5 @@
-import type { Priority } from '@kernhq/module-tracker/contract'
 import type { StatusCategory } from '@kernhq/workflow'
+import type { Priority } from '../contract/index.js'
 
 /**
  * Presentation rules shared by every tracker surface (list rows, board cards, detail panel).

package/src/client/group.ts

@@ -1,5 +1,5 @@
-import type { GroupBy, Issue, Priority } from '@kernhq/module-tracker/contract'
 import type { StatusCategory } from '@kernhq/workflow'
+import type { GroupBy, Issue, Priority } from '../contract/index.js'
 import { PRIORITY_GROUP_ORDER, STATUS_CATEGORY_ORDER } from './format.js'
 import { byRank } from './rank.js'
 

package/src/client/kql.ts

@@ -1,5 +1,5 @@
-import type { KqlError, KqlSuggestion } from '@kernhq/module-tracker/contract'
-import type { KqlExpr, KqlOp, KqlOrder, KqlQuery, KqlValue, Span } from '@kernhq/module-tracker/kql'
+import type { KqlError, KqlSuggestion } from '../contract/index.js'
+import type { KqlExpr, KqlOp, KqlOrder, KqlQuery, KqlValue, Span } from '../kql/index.js'
 import {
   customKqlField,
   findField,
@@ -8,7 +8,7 @@ import {
   operatorsFor,
   printQuery,
   SYSTEM_FIELDS,
-} from '@kernhq/module-tracker/kql'
+} from '../kql/index.js'
 
 /**
  * A KQL reader for the query box.
@@ -495,6 +495,6 @@ export type {
   KqlQuery,
   KqlValue,
   Span,
-} from '@kernhq/module-tracker/kql'
+} from '../kql/index.js'
 export type { KqlField }
 export { customKqlField, operatorsFor, SYSTEM_FIELDS }

package/src/client/types.ts

@@ -54,4 +54,4 @@ export type {
   ViewLayout,
   Workflow,
   WorkItemType,
-} from '@kernhq/module-tracker/contract'
+} from '../contract/index.js'

package/src/contract/events.ts

@@ -0,0 +1,94 @@
+import { defineEvent, Id, UserId, WorkspaceId } from '@kernhq/contracts'
+import { z } from 'zod'
+import { IssueKey, Priority, StatusCategory } from './models.js'
+
+const issueRef = z.object({
+  workspaceId: WorkspaceId,
+  projectId: Id,
+  issueId: Id,
+  key: IssueKey,
+})
+
+/** Events published by the tracker module (also available as automation triggers). */
+export const trackerEvents = {
+  issueCreated: defineEvent(
+    'tracker.issue.created',
+    issueRef.extend({
+      typeId: Id,
+      title: z.string(),
+      statusId: z.string(),
+      priority: Priority,
+      assigneeIds: z.array(UserId),
+      triage: z.boolean(),
+      source: z.string(),
+    }),
+  ),
+  issueUpdated: defineEvent(
+    'tracker.issue.updated',
+    issueRef.extend({
+      changes: z.array(z.object({ field: z.string(), from: z.unknown(), to: z.unknown() })),
+    }),
+  ),
+  issueStatusChanged: defineEvent(
+    'tracker.issue.status_changed',
+    issueRef.extend({
+      fromStatusId: z.string().nullable(),
+      toStatusId: z.string(),
+      fromCategory: StatusCategory.nullable(),
+      toCategory: StatusCategory,
+      transitionId: z.string().nullable(),
+      resolution: z.string().nullable(),
+    }),
+  ),
+  issueAssigned: defineEvent(
+    'tracker.issue.assigned',
+    issueRef.extend({ assigneeIds: z.array(UserId), added: z.array(UserId), removed: z.array(UserId) }),
+  ),
+  issueCommented: defineEvent(
+    'tracker.issue.commented',
+    issueRef.extend({ commentId: Id, parentId: Id.nullable(), authorId: UserId.nullable() }),
+  ),
+  issueDeleted: defineEvent('tracker.issue.deleted', issueRef),
+  issueArchived: defineEvent('tracker.issue.archived', issueRef.extend({ archived: z.boolean() })),
+  issueDue: defineEvent(
+    'tracker.issue.due',
+    issueRef.extend({ dueDate: z.string(), assigneeIds: z.array(UserId) }),
+  ),
+
+  cycleStarted: defineEvent(
+    'tracker.cycle.started',
+    z.object({ workspaceId: WorkspaceId, projectId: Id, cycleId: Id, number: z.number().int() }),
+  ),
+  cycleCompleted: defineEvent(
+    'tracker.cycle.completed',
+    z.object({
+      workspaceId: WorkspaceId,
+      projectId: Id,
+      cycleId: Id,
+      number: z.number().int(),
+      carriedOver: z.number().int(),
+    }),
+  ),
+
+  projectCreated: defineEvent(
+    'tracker.project.created',
+    z.object({ workspaceId: WorkspaceId, projectId: Id, key: z.string(), name: z.string() }),
+  ),
+  projectUpdated: defineEvent(
+    'tracker.project.updated',
+    z.object({ workspaceId: WorkspaceId, projectId: Id, changes: z.array(z.string()) }),
+  ),
+  projectArchived: defineEvent(
+    'tracker.project.archived',
+    z.object({ workspaceId: WorkspaceId, projectId: Id, archived: z.boolean() }),
+  ),
+  projectDeleted: defineEvent(
+    'tracker.project.deleted',
+    z.object({ workspaceId: WorkspaceId, projectId: Id, key: z.string() }),
+  ),
+
+  versionReleased: defineEvent(
+    'tracker.version.released',
+    z.object({ workspaceId: WorkspaceId, projectId: Id, versionId: Id, name: z.string() }),
+  ),
+}

package/src/contract/index.ts

@@ -0,0 +1,5 @@
+export * from './events.js'
+export * from './models.js'
+export * from './notifications.js'
+export * from './permissions.js'
+export * from './router.js'