@kernhq/module-tracker 0.1.0 → 0.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kernhq/module-tracker",
-  "version": "0.1.0",
+  "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",
@@ -16,20 +16,24 @@
     "dist",
     "migrations",
     "src/client",
-    "docs"
+    "src/contract",
+    "src/kql"
   ],
   "exports": {
     "./contract": {
       "types": "./dist/contract/index.d.ts",
-      "import": "./dist/contract/index.js"
+      "import": "./dist/contract/index.js",
+      "default": "./dist/contract/index.js"
     },
     "./kql": {
       "types": "./dist/kql/index.d.ts",
-      "import": "./dist/kql/index.js"
+      "import": "./dist/kql/index.js",
+      "default": "./dist/kql/index.js"
     },
     "./server": {
       "types": "./dist/server/index.d.ts",
-      "import": "./dist/server/index.js"
+      "import": "./dist/server/index.js",
+      "default": "./dist/server/index.js"
     },
     "./client": {
       "types": "./src/client/index.ts",

package/src/client/format.ts

@@ -1,5 +1,5 @@
 import type { StatusCategory } from '@kernhq/workflow'
-import type { Priority } from '../contract/models.js'
+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 { StatusCategory } from '@kernhq/workflow'
-import type { GroupBy, Issue, Priority } from '../contract/models.js'
+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,14 +1,14 @@
-import type { KqlError, KqlSuggestion } from '../contract/models.js'
-import type { KqlExpr, KqlOp, KqlOrder, KqlQuery, KqlValue, Span } from '../kql/ast.js'
-import { printQuery } from '../kql/ast.js'
+import type { KqlError, KqlSuggestion } from '../contract/index.js'
+import type { KqlExpr, KqlOp, KqlOrder, KqlQuery, KqlValue, Span } from '../kql/index.js'
 import {
   customKqlField,
   findField,
   KQL_FUNCTIONS,
   type KqlField,
   operatorsFor,
+  printQuery,
   SYSTEM_FIELDS,
-} from '../kql/fields.js'
+} from '../kql/index.js'
 
 /**
  * A KQL reader for the query box.
@@ -487,6 +487,14 @@ function suggest(tokens: Token[], fields: readonly KqlField[], cursor: number):
     .map((k) => ({ kind: 'keyword' as const, label: k, insertText: `${k} ` }))
 }
 
-export type { KqlComparison, KqlExpr, KqlOp, KqlOrder, KqlQuery, KqlValue, Span } from '../kql/ast.js'
+export type {
+  KqlComparison,
+  KqlExpr,
+  KqlOp,
+  KqlOrder,
+  KqlQuery,
+  KqlValue,
+  Span,
+} 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 '../contract/models.js'
+} 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'