@kernhq/module-tracker 0.1.0

package/dist/server/services/reports.js

@@ -0,0 +1,295 @@
+import { KernError } from '@kernhq/kernel';
+import { and, asc, desc, eq, inArray, isNull, sql } from 'drizzle-orm';
+import { dateOnly } from '../../kql/dates.js';
+import { cycles, issueStatusHistory, issues } from '../schema.js';
+import { parseSettings, toCycle } from './db.js';
+const DAY_MS = 86_400_000;
+const RESOLVED = ['done', 'cancelled'];
+/** Inclusive list of `YYYY-MM-DD` between two dates. */
+function dayRange(from, to, max = 400) {
+    const start = new Date(`${from}T00:00:00.000Z`).getTime();
+    const end = new Date(`${to}T00:00:00.000Z`).getTime();
+    if (Number.isNaN(start) || Number.isNaN(end) || end < start)
+        throw KernError.badRequest('Invalid date range');
+    const days = [];
+    for (let t = start; t <= end && days.length < max; t += DAY_MS)
+        days.push(dateOnly(new Date(t)));
+    return days;
+}
+export class ReportService {
+    kernel;
+    access;
+    config;
+    planning;
+    timeService;
+    constructor(kernel, access, config, planning, timeService) {
+        this.kernel = kernel;
+        this.access = access;
+        this.config = config;
+        this.planning = planning;
+        this.timeService = timeService;
+    }
+    // ------------------------------------------------------------------ burndown
+    async burndown(tx, principal, workspaceId, cycleId) {
+        const [cycleRow] = await tx
+            .select()
+            .from(cycles)
+            .where(and(eq(cycles.workspaceId, workspaceId), eq(cycles.id, cycleId)))
+            .limit(1);
+        if (!cycleRow)
+            throw KernError.notFound('Cycle');
+        const project = await this.access.requireProject(tx, principal, workspaceId, cycleRow.projectId);
+        const unit = parseSettings(project.settings).estimation;
+        const rows = await tx
+            .select({
+            id: issues.id,
+            estimate: issues.estimate,
+            createdAt: issues.createdAt,
+            completedAt: issues.completedAt,
+            cancelledAt: issues.cancelledAt,
+            statusCategory: issues.statusCategory,
+        })
+            .from(issues)
+            .where(and(eq(issues.workspaceId, workspaceId), eq(issues.cycleId, cycleId), isNull(issues.archivedAt)));
+        const weight = (estimate) => (unit === 'none' ? 1 : (estimate ?? 0));
+        const days = dayRange(dateOnly(cycleRow.startAt), dateOnly(cycleRow.endAt), 120);
+        const totalScope = rows.reduce((sum, r) => sum + weight(r.estimate), 0);
+        let previousScope = 0;
+        const points = days.map((date, index) => {
+            const endOfDay = new Date(`${date}T23:59:59.999Z`);
+            const scope = rows
+                .filter((r) => r.createdAt <= endOfDay)
+                .reduce((sum, r) => sum + weight(r.estimate), 0);
+            const completed = rows
+                .filter((r) => {
+                const at = r.completedAt ?? r.cancelledAt;
+                return at != null && at <= endOfDay;
+            })
+                .reduce((sum, r) => sum + weight(r.estimate), 0);
+            const ideal = days.length > 1 ? totalScope * (1 - index / (days.length - 1)) : 0;
+            const point = {
+                date,
+                remaining: Math.max(0, scope - completed),
+                ideal: Number(ideal.toFixed(2)),
+                completed,
+                scope,
+                scopeChange: index === 0 ? 0 : scope - previousScope,
+            };
+            previousScope = scope;
+            return point;
+        });
+        const stats = {
+            total: rows.length,
+            done: rows.filter((r) => RESOLVED.includes(r.statusCategory)).length,
+            estimateTotal: totalScope,
+            estimateDone: rows
+                .filter((r) => RESOLVED.includes(r.statusCategory))
+                .reduce((sum, r) => sum + weight(r.estimate), 0),
+        };
+        return { cycle: toCycle(cycleRow, stats), unit, points };
+    }
+    // ------------------------------------------------------------------ velocity
+    async velocity(tx, principal, workspaceId, projectId, lastN) {
+        const project = await this.access.requireProject(tx, principal, workspaceId, projectId);
+        const unit = parseSettings(project.settings).estimation;
+        const rows = await tx
+            .select()
+            .from(cycles)
+            .where(and(eq(cycles.workspaceId, workspaceId), eq(cycles.projectId, projectId), inArray(cycles.status, ['completed', 'active'])))
+            .orderBy(desc(cycles.number))
+            .limit(lastN);
+        const ordered = rows.reverse();
+        const weight = (estimate) => (unit === 'none' ? 1 : (estimate ?? 0));
+        const entries = [];
+        for (const row of ordered) {
+            const issueRows = await tx
+                .select({ estimate: issues.estimate, statusCategory: issues.statusCategory })
+                .from(issues)
+                .where(and(eq(issues.workspaceId, workspaceId), eq(issues.cycleId, row.id), isNull(issues.archivedAt)));
+            const committedSnapshot = row.committed ?? {};
+            const completedRows = issueRows.filter((r) => r.statusCategory === 'done');
+            entries.push({
+                cycle: {
+                    id: row.id,
+                    number: row.number,
+                    name: row.name,
+                    startAt: row.startAt.toISOString(),
+                    endAt: row.endAt.toISOString(),
+                    status: row.status,
+                },
+                committed: committedSnapshot.estimateTotal ?? issueRows.reduce((sum, r) => sum + weight(r.estimate), 0),
+                completed: completedRows.reduce((sum, r) => sum + weight(r.estimate), 0),
+                committedCount: committedSnapshot.total ?? issueRows.length,
+                completedCount: completedRows.length,
+            });
+        }
+        const average = entries.length
+            ? Number((entries.reduce((sum, e) => sum + e.completed, 0) / entries.length).toFixed(2))
+            : 0;
+        return { unit, cycles: entries, average };
+    }
+    // ------------------------------------------------------------------ cumulative flow
+    async cfd(tx, principal, workspaceId, projectId, from, to) {
+        await this.access.requireProject(tx, principal, workspaceId, projectId);
+        const statuses = await this.config.statusesForProject(tx, workspaceId, projectId);
+        const days = dayRange(from, to);
+        const end = new Date(`${to}T23:59:59.999Z`);
+        const history = await tx
+            .select({
+            issueId: issueStatusHistory.issueId,
+            toStatusId: issueStatusHistory.toStatusId,
+            occurredAt: issueStatusHistory.occurredAt,
+        })
+            .from(issueStatusHistory)
+            .where(and(eq(issueStatusHistory.workspaceId, workspaceId), eq(issueStatusHistory.projectId, projectId), sql `${issueStatusHistory.occurredAt} <= ${end.toISOString()}`))
+            .orderBy(asc(issueStatusHistory.occurredAt));
+        const timeline = new Map();
+        for (const row of history) {
+            const list = timeline.get(row.issueId) ?? [];
+            list.push({ at: row.occurredAt.getTime(), statusId: row.toStatusId });
+            timeline.set(row.issueId, list);
+        }
+        const points = days.map((date) => {
+            const cutoff = new Date(`${date}T23:59:59.999Z`).getTime();
+            const counts = {};
+            for (const status of statuses)
+                counts[status.id] = 0;
+            for (const entries of timeline.values()) {
+                let current = null;
+                for (const entry of entries) {
+                    if (entry.at > cutoff)
+                        break;
+                    current = entry.statusId;
+                }
+                if (current)
+                    counts[current] = (counts[current] ?? 0) + 1;
+            }
+            return { date, counts };
+        });
+        return {
+            statuses: statuses.map((s) => ({ id: s.id, name: s.name, category: s.category, color: s.color })),
+            points,
+        };
+    }
+    // ------------------------------------------------------------------ created vs resolved
+    async createdVsResolved(tx, principal, workspaceId, projectId, from, to) {
+        await this.access.requireProject(tx, principal, workspaceId, projectId);
+        const days = dayRange(from, to);
+        const end = new Date(`${to}T23:59:59.999Z`);
+        const rows = await tx
+            .select({
+            createdAt: issues.createdAt,
+            completedAt: issues.completedAt,
+            cancelledAt: issues.cancelledAt,
+        })
+            .from(issues)
+            .where(and(eq(issues.workspaceId, workspaceId), eq(issues.projectId, projectId), sql `${issues.createdAt} <= ${end.toISOString()}`));
+        const points = days.map((date) => {
+            const dayStart = new Date(`${date}T00:00:00.000Z`).getTime();
+            const dayEnd = dayStart + DAY_MS;
+            let created = 0;
+            let resolved = 0;
+            let openTotal = 0;
+            for (const row of rows) {
+                const createdAt = row.createdAt.getTime();
+                const resolvedAt = (row.completedAt ?? row.cancelledAt)?.getTime() ?? null;
+                if (createdAt >= dayStart && createdAt < dayEnd)
+                    created++;
+                if (resolvedAt !== null && resolvedAt >= dayStart && resolvedAt < dayEnd)
+                    resolved++;
+                if (createdAt < dayEnd && (resolvedAt === null || resolvedAt >= dayEnd))
+                    openTotal++;
+            }
+            return { date, created, resolved, openTotal };
+        });
+        return { points };
+    }
+    // ------------------------------------------------------------------ time
+    async time(tx, principal, workspaceId, input) {
+        if (input.projectId)
+            await this.access.requireProject(tx, principal, workspaceId, input.projectId);
+        const visible = await this.access.visibleProjectIds(tx, principal, workspaceId, {
+            ...(input.projectId ? { only: [input.projectId] } : {}),
+        });
+        const logs = (await this.timeService.between(tx, workspaceId, input.from, input.to, {
+            ...(input.projectId ? { projectId: input.projectId } : {}),
+            ...(input.userId ? { userId: input.userId } : {}),
+            billableOnly: input.billableOnly,
+        })).filter((row) => visible.includes(row.projectId));
+        const issueIds = [...new Set(logs.map((l) => l.issueId))];
+        const issueRows = issueIds.length
+            ? await tx
+                .select({
+                id: issues.id,
+                key: issues.key,
+                title: issues.title,
+                originalEstimateSec: issues.originalEstimateSec,
+                remainingSec: issues.remainingSec,
+            })
+                .from(issues)
+                .where(and(eq(issues.workspaceId, workspaceId), inArray(issues.id, issueIds)))
+            : [];
+        const byIssueId = new Map(issueRows.map((r) => [r.id, r]));
+        const cells = new Map();
+        for (const log of logs) {
+            const date = dateOnly(log.startedAt);
+            const key = `${log.userId}|${log.issueId}|${date}`;
+            const existing = cells.get(key) ?? {
+                userId: log.userId,
+                projectId: log.projectId,
+                issueId: log.issueId,
+                issueKey: byIssueId.get(log.issueId)?.key ?? null,
+                date,
+                durationSec: 0,
+                billableSec: 0,
+            };
+            existing.durationSec += log.durationSec;
+            if (log.billable)
+                existing.billableSec += log.durationSec;
+            cells.set(key, existing);
+        }
+        const rows = [...cells.values()].sort((a, b) => a.date.localeCompare(b.date));
+        const byUser = new Map();
+        for (const row of rows) {
+            const entry = byUser.get(row.userId) ?? { userId: row.userId, durationSec: 0, billableSec: 0 };
+            entry.durationSec += row.durationSec;
+            entry.billableSec += row.billableSec;
+            byUser.set(row.userId, entry);
+        }
+        const byIssue = new Map();
+        for (const log of logs) {
+            const issue = byIssueId.get(log.issueId);
+            const entry = byIssue.get(log.issueId) ?? {
+                issueId: log.issueId,
+                issueKey: issue?.key ?? '',
+                title: issue?.title ?? '',
+                durationSec: 0,
+                originalEstimateSec: issue?.originalEstimateSec ?? null,
+                remainingSec: issue?.remainingSec ?? null,
+            };
+            entry.durationSec += log.durationSec;
+            byIssue.set(log.issueId, entry);
+        }
+        return {
+            from: input.from,
+            to: input.to,
+            totalSec: logs.reduce((sum, l) => sum + l.durationSec, 0),
+            billableSec: logs.filter((l) => l.billable).reduce((sum, l) => sum + l.durationSec, 0),
+            rows,
+            byUser: [...byUser.values()].map((u) => ({
+                userId: u.userId,
+                durationSec: u.durationSec,
+                billableSec: u.billableSec,
+            })),
+            byIssue: [...byIssue.values()].sort((a, b) => b.durationSec - a.durationSec),
+        };
+    }
+    /** Exposed so jobs can reuse the resolved-category list. */
+    resolvedCategories() {
+        return this.planning.resolvedCategories();
+    }
+    kernelRef() {
+        return this.kernel;
+    }
+}
+//# sourceMappingURL=reports.js.map

package/dist/server/services/reports.js.map

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

package/dist/server/services/time.d.ts

@@ -0,0 +1,53 @@
+import type { Principal } from '@kernhq/contracts';
+import { type Kernel, type Tx } from '@kernhq/kernel';
+import type { Issue, Timer, Worklog } from '../../contract/models.js';
+import type { AccessService } from './access.js';
+import { type WorklogRow } from './db.js';
+import type { IssueService } from './issues.js';
+import type { NotifyService } from './notify.js';
+export interface UpsertWorklogInput {
+    startedAt?: string;
+    durationSec: number;
+    note?: string | null;
+    billable?: boolean;
+    adjustRemaining: 'auto' | 'leave' | 'set';
+    remainingSec?: number;
+}
+/** Worklogs and the single running timer a user may have per workspace. */
+export declare class TimeService {
+    private readonly kernel;
+    private readonly access;
+    private readonly issuesService;
+    private readonly notify;
+    constructor(kernel: Kernel, access: AccessService, issuesService: IssueService, notify: NotifyService);
+    list(tx: Tx, principal: Principal, workspaceId: string, issueId: string): Promise<Worklog[]>;
+    create(tx: Tx, principal: Principal, workspaceId: string, issueId: string, input: UpsertWorklogInput, opts?: {
+        userId?: string;
+        startedAt?: Date;
+    }): Promise<{
+        worklog: Worklog;
+        issue: Issue;
+    }>;
+    /** Roll a logged duration into the issue's `timeSpentSec` and remaining estimate. */
+    private applyToIssue;
+    private worklogRow;
+    update(tx: Tx, principal: Principal, workspaceId: string, id: string, patch: Partial<UpsertWorklogInput>): Promise<Worklog>;
+    delete(tx: Tx, principal: Principal, workspaceId: string, id: string): Promise<void>;
+    private assertOwnership;
+    current(tx: Tx, principal: Principal, workspaceId: string): Promise<{
+        timer: Timer | null;
+    }>;
+    /** Starting a timer stops whatever the user had running, so the log never double counts. */
+    start(tx: Tx, principal: Principal, workspaceId: string, issueId: string, note?: string): Promise<Timer>;
+    stop(tx: Tx, principal: Principal, workspaceId: string, discard: boolean): Promise<{
+        worklog: Worklog | null;
+    }>;
+    /** Raw worklog rows for the time report. */
+    between(tx: Tx, workspaceId: string, from: string, to: string, filters?: {
+        projectId?: string;
+        userId?: string;
+        billableOnly?: boolean;
+    }): Promise<WorklogRow[]>;
+    kernelRef(): Kernel;
+}
+//# sourceMappingURL=time.d.ts.map

package/dist/server/services/time.d.ts.map

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

package/dist/server/services/time.js

@@ -0,0 +1,192 @@
+import { KernError, uuidv7 } from '@kernhq/kernel';
+import { and, asc, desc, eq, sql } from 'drizzle-orm';
+import { issues, timers, worklogs } from '../schema.js';
+import { toTimer, toWorklog } from './db.js';
+/** Worklogs and the single running timer a user may have per workspace. */
+export class TimeService {
+    kernel;
+    access;
+    issuesService;
+    notify;
+    constructor(kernel, access, issuesService, notify) {
+        this.kernel = kernel;
+        this.access = access;
+        this.issuesService = issuesService;
+        this.notify = notify;
+    }
+    async list(tx, principal, workspaceId, issueId) {
+        const issue = await this.issuesService.row(tx, workspaceId, issueId);
+        await this.access.requireProject(tx, principal, workspaceId, issue.projectId, 'tracker.issue.view');
+        const rows = await tx
+            .select()
+            .from(worklogs)
+            .where(and(eq(worklogs.workspaceId, workspaceId), eq(worklogs.issueId, issueId)))
+            .orderBy(desc(worklogs.startedAt));
+        return rows.map(toWorklog);
+    }
+    async create(tx, principal, workspaceId, issueId, input, opts = {}) {
+        const issue = await this.issuesService.row(tx, workspaceId, issueId);
+        await this.access.require(principal, 'tracker.worklog.log', workspaceId, issue.projectId);
+        const userId = opts.userId ?? this.access.userId(principal);
+        const startedAt = opts.startedAt ?? (input.startedAt ? new Date(input.startedAt) : new Date());
+        const [row] = await tx
+            .insert(worklogs)
+            .values({
+            id: uuidv7(),
+            workspaceId,
+            projectId: issue.projectId,
+            issueId,
+            userId,
+            startedAt,
+            durationSec: input.durationSec,
+            note: input.note ?? null,
+            billable: input.billable ?? false,
+        })
+            .returning();
+        const updated = await this.applyToIssue(tx, workspaceId, issueId, input.durationSec, input);
+        await this.notify.history(tx, {
+            workspaceId,
+            issueId,
+            actorId: userId,
+            action: 'worklog_added',
+            data: { durationSec: input.durationSec, worklogId: row.id },
+        });
+        await this.notify.change(workspaceId, 'issue', issueId, 'updated', {
+            scope: { projectId: issue.projectId },
+        });
+        return { worklog: toWorklog(row), issue: updated };
+    }
+    /** Roll a logged duration into the issue's `timeSpentSec` and remaining estimate. */
+    async applyToIssue(tx, workspaceId, issueId, deltaSec, input) {
+        const remaining = input.adjustRemaining === 'set'
+            ? sql `${input.remainingSec ?? 0}`
+            : input.adjustRemaining === 'auto'
+                ? sql `case when ${issues.remainingSec} is null then null else greatest(0, ${issues.remainingSec} - ${deltaSec}) end`
+                : sql `${issues.remainingSec}`;
+        const [row] = await tx
+            .update(issues)
+            .set({
+            timeSpentSec: sql `greatest(0, ${issues.timeSpentSec} + ${deltaSec})`,
+            remainingSec: remaining,
+            updatedAt: new Date(),
+            lastActivityAt: new Date(),
+        })
+            .where(and(eq(issues.workspaceId, workspaceId), eq(issues.id, issueId)))
+            .returning();
+        if (!row)
+            throw KernError.notFound('Issue');
+        return (await this.issuesService.hydrate(tx, [row]))[0];
+    }
+    async worklogRow(tx, workspaceId, id) {
+        const [row] = await tx
+            .select()
+            .from(worklogs)
+            .where(and(eq(worklogs.workspaceId, workspaceId), eq(worklogs.id, id)))
+            .limit(1);
+        if (!row)
+            throw KernError.notFound('Worklog');
+        return row;
+    }
+    async update(tx, principal, workspaceId, id, patch) {
+        const current = await this.worklogRow(tx, workspaceId, id);
+        await this.assertOwnership(principal, workspaceId, current);
+        const duration = patch.durationSec ?? current.durationSec;
+        const [row] = await tx
+            .update(worklogs)
+            .set({
+            ...(patch.startedAt === undefined ? {} : { startedAt: new Date(patch.startedAt) }),
+            ...(patch.durationSec === undefined ? {} : { durationSec: patch.durationSec }),
+            ...(patch.note === undefined ? {} : { note: patch.note }),
+            ...(patch.billable === undefined ? {} : { billable: patch.billable }),
+            updatedAt: new Date(),
+        })
+            .where(and(eq(worklogs.workspaceId, workspaceId), eq(worklogs.id, id)))
+            .returning();
+        if (duration !== current.durationSec)
+            await this.applyToIssue(tx, workspaceId, current.issueId, duration - current.durationSec, {
+                adjustRemaining: patch.adjustRemaining ?? 'leave',
+                ...(patch.remainingSec === undefined ? {} : { remainingSec: patch.remainingSec }),
+            });
+        await this.notify.change(current.workspaceId, 'issue', current.issueId, 'updated', {
+            scope: { projectId: current.projectId },
+        });
+        return toWorklog(row);
+    }
+    async delete(tx, principal, workspaceId, id) {
+        const current = await this.worklogRow(tx, workspaceId, id);
+        await this.assertOwnership(principal, workspaceId, current);
+        await tx.delete(worklogs).where(and(eq(worklogs.workspaceId, workspaceId), eq(worklogs.id, id)));
+        await this.applyToIssue(tx, workspaceId, current.issueId, -current.durationSec, {
+            adjustRemaining: 'leave',
+        });
+        await this.notify.change(workspaceId, 'issue', current.issueId, 'updated', {
+            scope: { projectId: current.projectId },
+        });
+    }
+    async assertOwnership(principal, workspaceId, row) {
+        if (principal.userId && row.userId === principal.userId)
+            return;
+        await this.access.require(principal, 'tracker.worklog.edit_any', workspaceId, row.projectId);
+    }
+    // ------------------------------------------------------------------ timers
+    async current(tx, principal, workspaceId) {
+        const userId = this.access.userId(principal);
+        const [row] = await tx
+            .select()
+            .from(timers)
+            .where(and(eq(timers.workspaceId, workspaceId), eq(timers.userId, userId)))
+            .limit(1);
+        return { timer: row ? toTimer(row) : null };
+    }
+    /** Starting a timer stops whatever the user had running, so the log never double counts. */
+    async start(tx, principal, workspaceId, issueId, note) {
+        const issue = await this.issuesService.row(tx, workspaceId, issueId);
+        await this.access.require(principal, 'tracker.worklog.log', workspaceId, issue.projectId);
+        const userId = this.access.userId(principal);
+        await this.stop(tx, principal, workspaceId, false).catch(() => undefined);
+        const [row] = await tx
+            .insert(timers)
+            .values({ id: uuidv7(), workspaceId, issueId, userId, note: note ?? null, startedAt: new Date() })
+            .onConflictDoUpdate({
+            target: [timers.workspaceId, timers.userId],
+            set: { issueId, note: note ?? null, startedAt: new Date() },
+        })
+            .returning();
+        return toTimer(row);
+    }
+    async stop(tx, principal, workspaceId, discard) {
+        const userId = this.access.userId(principal);
+        const [row] = await tx
+            .delete(timers)
+            .where(and(eq(timers.workspaceId, workspaceId), eq(timers.userId, userId)))
+            .returning();
+        if (!row || discard)
+            return { worklog: null };
+        const durationSec = Math.max(1, Math.round((Date.now() - row.startedAt.getTime()) / 1000));
+        const { worklog } = await this.create(tx, principal, workspaceId, row.issueId, { durationSec, note: row.note, adjustRemaining: 'auto' }, { userId, startedAt: row.startedAt });
+        return { worklog };
+    }
+    /** Raw worklog rows for the time report. */
+    async between(tx, workspaceId, from, to, filters = {}) {
+        const where = [
+            eq(worklogs.workspaceId, workspaceId),
+            sql `${worklogs.startedAt} >= ${`${from}T00:00:00Z`}::timestamptz`,
+            sql `${worklogs.startedAt} < (${`${to}T00:00:00Z`}::timestamptz + interval '1 day')`,
+        ];
+        if (filters.projectId)
+            where.push(eq(worklogs.projectId, filters.projectId));
+        if (filters.userId)
+            where.push(eq(worklogs.userId, filters.userId));
+        if (filters.billableOnly)
+            where.push(eq(worklogs.billable, true));
+        return tx
+            .select()
+            .from(worklogs)
+            .where(and(...where))
+            .orderBy(asc(worklogs.startedAt));
+    }
+    kernelRef() {
+        return this.kernel;
+    }
+}
+//# sourceMappingURL=time.js.map

package/dist/server/services/time.js.map

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

package/dist/server/services/transitions.d.ts

@@ -0,0 +1,61 @@
+import type { Principal } from '@kernhq/contracts';
+import { type Kernel, type Tx } from '@kernhq/kernel';
+import { type WorkflowDefinition } from '@kernhq/workflow';
+import { type AvailableTransition, type Issue, type IssueApproval } from '../../contract/models.js';
+import type { AccessService } from './access.js';
+import type { CommentService } from './comments.js';
+import type { ConfigService } from './config.js';
+import type { IssueService } from './issues.js';
+import type { NotifyService } from './notify.js';
+export interface ApplyInput {
+    transitionId: string;
+    fields?: Record<string, unknown>;
+    comment?: string;
+    resolution?: string | null;
+}
+/** Drives `@kernhq/workflow` for issues: conditions, validators, post-function intents and approvals. */
+export declare class TransitionService {
+    private readonly kernel;
+    private readonly access;
+    private readonly config;
+    private readonly issuesService;
+    private readonly notify;
+    /** Set after construction to break the cycle with the comment service. */
+    comments: CommentService;
+    constructor(kernel: Kernel, access: AccessService, config: ConfigService, issuesService: IssueService, notify: NotifyService);
+    private ruleObject;
+    private actor;
+    private hooks;
+    private context;
+    available(tx: Tx, principal: Principal, workspaceId: string, issueId: string): Promise<AvailableTransition[]>;
+    private approvalStates;
+    listApprovals(tx: Tx, principal: Principal, workspaceId: string, issueId: string): Promise<IssueApproval[]>;
+    apply(tx: Tx, principal: Principal, workspaceId: string, issueId: string, input: ApplyInput, opts?: {
+        system?: boolean;
+        skipConditions?: boolean;
+    }): Promise<{
+        issue: Issue;
+        approval: IssueApproval | null;
+    }>;
+    /** Write the status change and everything the post-functions asked for, in one transaction. */
+    private commit;
+    private callWebhook;
+    /** Pause/resume the SLA clock and flag breaches as the issue moves through categories. */
+    private advanceSla;
+    private approvalRow;
+    private requestApproval;
+    decide(tx: Tx, principal: Principal, workspaceId: string, issueId: string, transitionId: string, decision: 'approve' | 'reject', comment?: string): Promise<{
+        approval: IssueApproval;
+        issue: Issue | null;
+    }>;
+    /** Move an issue straight to a status, picking a transition automatically (triage, automations). */
+    moveToStatus(tx: Tx, principal: Principal, workspaceId: string, issueId: string, statusId: string, opts?: {
+        comment?: string;
+        resolution?: string | null;
+    }): Promise<Issue>;
+    /** The initial status of the workflow an issue follows (used when accepting out of triage). */
+    firstNonTriageStatus(tx: Tx, workspaceId: string, issueId: string): Promise<string>;
+    /** Statuses whose category counts as resolved, for reports and cycle roll-over. */
+    resolvedStatusIds(definition: WorkflowDefinition): string[];
+}
+//# sourceMappingURL=transitions.d.ts.map