@open-mercato/core 0.7.1-develop.7178.1.ab93fbaf4e → 0.7.1-develop.7179.1.e8c03264b6

package/dist/modules/staff/ai-tools/time-tracking-pack.js

@@ -0,0 +1,348 @@
+import { z } from "zod";
+import { defineApiBackedAiTool } from "@open-mercato/ai-assistant/modules/ai_assistant/lib/api-backed-tool";
+import {
+  assertTenantScope,
+  enumerateDates,
+  isWeekend,
+  resolveStaffToolScope,
+  toIsoDate,
+  toMinutes
+} from "./types.js";
+const VIEW_FEATURE = "staff.timesheets.view";
+const MANAGE_OWN_FEATURE = "staff.timesheets.manage_own";
+const REPORTS_VIEW_FEATURE = "staff.timesheets.reports.view";
+const isoDate = z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "Use a yyyy-mm-dd calendar date.");
+function readDate(row) {
+  return toIsoDate(row.date);
+}
+function readMinutes(row) {
+  const rounded = toMinutes(row.roundedMinutes);
+  if (rounded > 0) return rounded;
+  return toMinutes(row.durationMinutes ?? row.duration_minutes);
+}
+function readProjectId(row) {
+  const value = row.timeProjectId ?? row.time_project_id;
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+}
+const logTimeInput = z.object({
+  date: isoDate.describe("The calendar day the work happened, as yyyy-mm-dd."),
+  durationMinutes: z.number().int().min(1).max(1440).describe("How long the work took, in whole minutes (1\u20131440)."),
+  timeProjectId: z.string().uuid().optional().describe("Project the time belongs to. Omit for unassigned time."),
+  taskId: z.string().uuid().optional().describe("Task the time belongs to; the task carries its own project."),
+  notes: z.string().max(2e3).optional().describe("What was done. Shown to whoever reviews the timesheet."),
+  isBillable: z.boolean().optional().describe("Override the project default for whether the time is billable.")
+});
+const logTimeTool = defineApiBackedAiTool({
+  name: "staff.log_time",
+  displayName: "Log time",
+  description: "Create a time entry for the signed-in user. Mutation tool \u2014 the write is held for approval and shown as a preview card before it runs.",
+  inputSchema: logTimeInput,
+  requiredFeatures: [MANAGE_OWN_FEATURE],
+  isMutation: true,
+  loadBeforeRecord: async (input, ctx) => {
+    const scope = await resolveStaffToolScope(ctx);
+    return {
+      recordId: `new:${scope.staffMemberId}:${input.date}`,
+      entityType: "staff.staff_time_entry",
+      recordVersion: null,
+      before: {},
+      after: {
+        date: input.date,
+        durationMinutes: input.durationMinutes,
+        timeProjectId: input.timeProjectId ?? null,
+        taskId: input.taskId ?? null,
+        notes: input.notes ?? null,
+        isBillable: input.isBillable ?? null
+      },
+      display: {
+        fieldLabels: {
+          date: "Date",
+          durationMinutes: "Minutes",
+          timeProjectId: "Project",
+          taskId: "Task",
+          notes: "Notes",
+          isBillable: "Billable"
+        }
+      }
+    };
+  },
+  toOperation: async (input, ctx) => {
+    const scope = await resolveStaffToolScope(ctx);
+    return {
+      method: "POST",
+      path: "/staff/timesheets/time-entries",
+      body: {
+        tenantId: scope.tenantId,
+        organizationId: scope.organizationId,
+        staffMemberId: scope.staffMemberId,
+        date: input.date,
+        durationMinutes: input.durationMinutes,
+        ...input.timeProjectId ? { timeProjectId: input.timeProjectId } : {},
+        ...input.taskId ? { taskId: input.taskId } : {},
+        ...input.notes ? { notes: input.notes } : {},
+        ...input.isBillable === void 0 ? {} : { isBillable: input.isBillable }
+      }
+    };
+  },
+  mapResponse: (response, input) => ({
+    recordId: typeof response.data?.id === "string" ? response.data.id : null,
+    commandName: "staff.timesheets.time_entries.create",
+    before: {},
+    after: {
+      date: input.date,
+      durationMinutes: input.durationMinutes,
+      timeProjectId: input.timeProjectId ?? null,
+      taskId: input.taskId ?? null
+    }
+  })
+});
+const startTimerInput = z.object({
+  date: isoDate.optional().describe("Day to file the running timer under; defaults to today."),
+  timeProjectId: z.string().uuid().optional().describe("Project to start the timer against."),
+  taskId: z.string().uuid().optional().describe("Task to start the timer against; it carries its own project."),
+  notes: z.string().max(2e3).optional().describe("What the timer is for.")
+});
+const startTimerTool = defineApiBackedAiTool({
+  name: "staff.start_timer",
+  displayName: "Start timer",
+  description: "Start a running timer for the signed-in user. Mutation tool \u2014 held for approval before it runs.",
+  inputSchema: startTimerInput,
+  requiredFeatures: [MANAGE_OWN_FEATURE],
+  isMutation: true,
+  loadBeforeRecord: async (input, ctx) => {
+    const scope = await resolveStaffToolScope(ctx);
+    const date = input.date ?? (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+    return {
+      recordId: `timer:${scope.staffMemberId}:${date}`,
+      entityType: "staff.staff_time_entry",
+      recordVersion: null,
+      before: {},
+      after: {
+        date,
+        timeProjectId: input.timeProjectId ?? null,
+        taskId: input.taskId ?? null,
+        notes: input.notes ?? null
+      },
+      display: { fieldLabels: { date: "Date", timeProjectId: "Project", taskId: "Task", notes: "Notes" } }
+    };
+  },
+  toOperation: async (input, ctx) => {
+    const scope = await resolveStaffToolScope(ctx);
+    return {
+      method: "POST",
+      path: "/staff/timesheets/time-entries/start-timer",
+      body: {
+        tenantId: scope.tenantId,
+        organizationId: scope.organizationId,
+        staffMemberId: scope.staffMemberId,
+        date: input.date ?? (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
+        ...input.timeProjectId ? { timeProjectId: input.timeProjectId } : {},
+        ...input.taskId ? { taskId: input.taskId } : {},
+        ...input.notes ? { notes: input.notes } : {}
+      }
+    };
+  },
+  mapResponse: (response, input) => ({
+    recordId: typeof response.data?.id === "string" ? response.data.id : null,
+    commandName: "staff.timesheets.time_entries.start_timer",
+    before: {},
+    after: { timeProjectId: input.timeProjectId ?? null, taskId: input.taskId ?? null }
+  })
+});
+const stopTimerInput = z.object({
+  timeEntryId: z.string().uuid().describe("The time entry whose running timer should be stopped.")
+});
+const stopTimerTool = defineApiBackedAiTool({
+  name: "staff.stop_timer",
+  displayName: "Stop timer",
+  description: "Stop the running timer on a time entry and freeze its duration. Mutation tool \u2014 held for approval before it runs.",
+  inputSchema: stopTimerInput,
+  requiredFeatures: [MANAGE_OWN_FEATURE],
+  isMutation: true,
+  loadBeforeRecord: async (input, ctx) => {
+    assertTenantScope(ctx);
+    return {
+      recordId: input.timeEntryId,
+      entityType: "staff.staff_time_entry",
+      recordVersion: null,
+      before: { timerRunning: true },
+      after: { timerRunning: false },
+      display: { fieldLabels: { timerRunning: "Timer running" } }
+    };
+  },
+  toOperation: async (input, ctx) => {
+    assertTenantScope(ctx);
+    return {
+      method: "POST",
+      path: `/staff/timesheets/time-entries/${input.timeEntryId}/timer-stop`,
+      body: {}
+    };
+  },
+  mapResponse: (response, input) => ({
+    recordId: input.timeEntryId,
+    commandName: "staff.timesheets.time_entries.stop_timer",
+    before: { timerRunning: true },
+    after: { timerRunning: false, durationMinutes: toMinutes(response.data?.durationMinutes) }
+  })
+});
+const summarizeWeekInput = z.object({
+  from: isoDate.describe("First day of the range, yyyy-mm-dd."),
+  to: isoDate.describe("Last day of the range, inclusive, yyyy-mm-dd.")
+});
+const summarizeWeekTool = defineApiBackedAiTool({
+  name: "staff.summarize_week",
+  displayName: "Summarize logged time",
+  description: "Summarize the signed-in user\u2019s logged time over a date range: totals per day and per project. Read-only. Returns minutes, never money.",
+  inputSchema: summarizeWeekInput,
+  requiredFeatures: [VIEW_FEATURE],
+  toOperation: async (input, ctx) => {
+    const scope = await resolveStaffToolScope(ctx);
+    return {
+      method: "GET",
+      path: "/staff/timesheets/time-entries",
+      query: {
+        from: input.from,
+        to: input.to,
+        staffMemberId: scope.staffMemberId,
+        page: 1,
+        pageSize: 100
+      }
+    };
+  },
+  mapResponse: (response, input) => {
+    const items = Array.isArray(response.data?.items) ? response.data.items : [];
+    const byDate = /* @__PURE__ */ new Map();
+    const byProject = /* @__PURE__ */ new Map();
+    let totalMinutes = 0;
+    for (const row of items) {
+      const date = readDate(row);
+      const minutes = readMinutes(row);
+      totalMinutes += minutes;
+      if (date) byDate.set(date, (byDate.get(date) ?? 0) + minutes);
+      const projectKey = readProjectId(row) ?? "";
+      const bucket = byProject.get(projectKey) ?? { minutes: 0, entryCount: 0 };
+      bucket.minutes += minutes;
+      bucket.entryCount += 1;
+      byProject.set(projectKey, bucket);
+    }
+    return {
+      from: input.from,
+      to: input.to,
+      totalMinutes,
+      entryCount: items.length,
+      byDate: Array.from(byDate.entries()).map(([date, minutes]) => ({ date, minutes })).sort((left, right) => left.date.localeCompare(right.date)),
+      byProject: Array.from(byProject.entries()).map(([key, value]) => ({
+        timeProjectId: key.length > 0 ? key : null,
+        minutes: value.minutes,
+        entryCount: value.entryCount
+      }))
+    };
+  }
+});
+const findMissingDaysInput = z.object({
+  from: isoDate.describe("First day of the range, yyyy-mm-dd."),
+  to: isoDate.describe("Last day of the range, inclusive, yyyy-mm-dd."),
+  includeWeekends: z.boolean().optional().describe("Count Saturdays and Sundays as days that need time logged. Defaults to false.")
+});
+const findMissingDaysTool = defineApiBackedAiTool({
+  name: "staff.find_missing_days",
+  displayName: "Find days with no logged time",
+  description: "List the days in a range on which the signed-in user logged no time. Weekends are excluded unless asked for. Read-only.",
+  inputSchema: findMissingDaysInput,
+  requiredFeatures: [VIEW_FEATURE],
+  toOperation: async (input, ctx) => {
+    const scope = await resolveStaffToolScope(ctx);
+    return {
+      method: "GET",
+      path: "/staff/timesheets/time-entries",
+      query: {
+        from: input.from,
+        to: input.to,
+        staffMemberId: scope.staffMemberId,
+        page: 1,
+        pageSize: 100
+      }
+    };
+  },
+  mapResponse: (response, input) => {
+    const items = Array.isArray(response.data?.items) ? response.data.items : [];
+    const logged = /* @__PURE__ */ new Set();
+    for (const row of items) {
+      const date = readDate(row);
+      if (date && readMinutes(row) > 0) logged.add(date);
+    }
+    const candidates = enumerateDates(input.from, input.to).filter(
+      (date) => (input.includeWeekends ?? false) || !isWeekend(date)
+    );
+    return {
+      from: input.from,
+      to: input.to,
+      missingDates: candidates.filter((date) => !logged.has(date)),
+      checkedDayCount: candidates.length
+    };
+  }
+});
+const draftClientReportInput = z.object({
+  timeProjectIds: z.array(z.string().uuid()).min(1).max(100).describe("Projects the report covers. They must all belong to the same customer."),
+  periodFrom: isoDate.describe("First day of the reported period, yyyy-mm-dd."),
+  periodTo: isoDate.describe("Last day of the reported period, inclusive, yyyy-mm-dd."),
+  customerId: z.string().uuid().optional().describe("Customer the report is for."),
+  grouping: z.string().optional().describe("Report grouping id, e.g. project_task, project_person or project_day."),
+  includeAlreadyReported: z.boolean().optional().describe("Include entries already frozen into an earlier report. Defaults to false.")
+});
+const draftClientReportTool = defineApiBackedAiTool({
+  name: "staff.draft_client_report",
+  displayName: "Draft a client report",
+  description: "Preview what a customer report would contain for a set of projects and a period, without creating one. Read-only \u2014 no report is written and nothing is locked. Amounts are omitted; ask the reports screen for money.",
+  inputSchema: draftClientReportInput,
+  requiredFeatures: [REPORTS_VIEW_FEATURE],
+  toOperation: async (input, ctx) => {
+    assertTenantScope(ctx);
+    return {
+      method: "POST",
+      path: "/staff/timesheets/reports/preview",
+      body: {
+        timeProjectIds: input.timeProjectIds,
+        periodFrom: input.periodFrom,
+        periodTo: input.periodTo,
+        periodKind: "custom",
+        ...input.customerId ? { customerId: input.customerId } : {},
+        ...input.grouping ? { grouping: input.grouping } : {},
+        includeAlreadyReported: input.includeAlreadyReported ?? false,
+        showRates: false
+      }
+    };
+  },
+  /**
+   * The preview response carries rates and amounts when the caller holds
+   * `staff.timesheets.rates.view`. The tool asks for `showRates: false` and then
+   * projects only the minute columns, so an agent transcript never becomes a
+   * second, ungated copy of the customer's rate card.
+   */
+  mapResponse: (response, input) => ({
+    periodFrom: input.periodFrom,
+    periodTo: input.periodTo,
+    grouping: typeof response.data?.grouping === "string" ? response.data.grouping : null,
+    projects: (response.data?.projects ?? []).map((project) => ({
+      id: typeof project.id === "string" ? project.id : null,
+      name: typeof project.name === "string" ? project.name : null,
+      billableMinutes: toMinutes(project.billableMinutes),
+      nonbillableMinutes: toMinutes(project.nonbillableMinutes),
+      entryCount: toMinutes(project.entryCount)
+    }))
+  })
+});
+const timeTrackingAiTools = [
+  logTimeTool,
+  startTimerTool,
+  stopTimerTool,
+  summarizeWeekTool,
+  findMissingDaysTool,
+  draftClientReportTool
+];
+var time_tracking_pack_default = timeTrackingAiTools;
+export {
+  time_tracking_pack_default as default,
+  timeTrackingAiTools
+};
+//# sourceMappingURL=time-tracking-pack.js.map

package/dist/modules/staff/ai-tools/time-tracking-pack.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/staff/ai-tools/time-tracking-pack.ts"],
+  "sourcesContent": ["/**\n * EP-49 \u2014 the time-tracking AI tool pack.\n *\n * Six tools, three of them writes. The write path is the platform's approval\n * contract, and the shape of that contract is the one thing worth stating\n * plainly here, because the spec described it inside out:\n *\n * A module tool does NOT call `prepareMutation`. `prepareMutation` is framework\n * code \u2014 its only call site is `agent-tools.ts` in `@open-mercato/ai-assistant`,\n * which intercepts the model's call, short-circuits the handler, persists an\n * `AiPendingAction` and returns a preview card. A tool opts into that by\n * declaring `isMutation: true` and a `loadBeforeRecord` resolver that renders the\n * diff; the agent opts in with `mutationPolicy: 'confirm-required'`. The handler\n * runs later, once, from the confirm route, with the stored input. Calling\n * `prepareMutation` from here would be calling the interceptor from inside the\n * thing it intercepts.\n *\n * Every tool is API-backed. `createAiApiOperationRunner` resolves the route from\n * the generated manifest and refuses to run a mutation route whose\n * `requiredFeatures` the tool does not itself declare, so the `staff.timesheets.*`\n * gate on each tool below is checked twice: once by the tool registry before the\n * handler, once by the runner against the route. The route then applies the\n * project-access intersection, the mutation guards, the interceptors and the\n * commands \u2014 none of which is reimplemented here.\n */\n\nimport { z } from 'zod'\nimport { defineApiBackedAiTool } from '@open-mercato/ai-assistant/modules/ai_assistant/lib/api-backed-tool'\nimport type {\n  AiApiOperationRequest,\n  AiToolExecutionContext,\n} from '@open-mercato/ai-assistant/modules/ai_assistant/lib/ai-api-operation-runner'\nimport type { AiToolDefinition } from '@open-mercato/ai-assistant/modules/ai_assistant/lib/types'\nimport {\n  assertTenantScope,\n  enumerateDates,\n  isWeekend,\n  resolveStaffToolScope,\n  toIsoDate,\n  toMinutes,\n} from './types'\n\nconst VIEW_FEATURE = 'staff.timesheets.view'\nconst MANAGE_OWN_FEATURE = 'staff.timesheets.manage_own'\nconst REPORTS_VIEW_FEATURE = 'staff.timesheets.reports.view'\n\nconst isoDate = z\n  .string()\n  .regex(/^\\d{4}-\\d{2}-\\d{2}$/, 'Use a yyyy-mm-dd calendar date.')\n\ntype EntryRow = {\n  id?: unknown\n  date?: unknown\n  durationMinutes?: unknown\n  duration_minutes?: unknown\n  roundedMinutes?: unknown\n  timeProjectId?: unknown\n  time_project_id?: unknown\n  projectName?: unknown\n  taskId?: unknown\n  notes?: unknown\n  isBillable?: unknown\n  is_billable?: unknown\n}\n\ntype EntriesApiResponse = {\n  items?: EntryRow[]\n  total?: number\n}\n\nfunction readDate(row: EntryRow): string | null {\n  return toIsoDate(row.date)\n}\n\nfunction readMinutes(row: EntryRow): number {\n  const rounded = toMinutes(row.roundedMinutes)\n  if (rounded > 0) return rounded\n  return toMinutes(row.durationMinutes ?? row.duration_minutes)\n}\n\nfunction readProjectId(row: EntryRow): string | null {\n  const value = row.timeProjectId ?? row.time_project_id\n  return typeof value === 'string' && value.trim().length > 0 ? value.trim() : null\n}\n\n/* ------------------------------------------------------------------ writes */\n\nconst logTimeInput = z.object({\n  date: isoDate.describe('The calendar day the work happened, as yyyy-mm-dd.'),\n  durationMinutes: z\n    .number()\n    .int()\n    .min(1)\n    .max(1440)\n    .describe('How long the work took, in whole minutes (1\u20131440).'),\n  timeProjectId: z.string().uuid().optional().describe('Project the time belongs to. Omit for unassigned time.'),\n  taskId: z.string().uuid().optional().describe('Task the time belongs to; the task carries its own project.'),\n  notes: z.string().max(2000).optional().describe('What was done. Shown to whoever reviews the timesheet.'),\n  isBillable: z.boolean().optional().describe('Override the project default for whether the time is billable.'),\n})\n\ntype LogTimeInput = z.infer<typeof logTimeInput>\n\nconst logTimeTool = defineApiBackedAiTool<LogTimeInput, { id?: string }, { recordId: string | null; commandName: string; before: Record<string, unknown>; after: Record<string, unknown> }>({\n  name: 'staff.log_time',\n  displayName: 'Log time',\n  description:\n    'Create a time entry for the signed-in user. Mutation tool \u2014 the write is held for approval and shown as a preview card before it runs.',\n  inputSchema: logTimeInput,\n  requiredFeatures: [MANAGE_OWN_FEATURE],\n  isMutation: true,\n  loadBeforeRecord: async (input, ctx) => {\n    const scope = await resolveStaffToolScope(ctx as unknown as AiToolExecutionContext)\n    return {\n      recordId: `new:${scope.staffMemberId}:${input.date}`,\n      entityType: 'staff.staff_time_entry',\n      recordVersion: null,\n      before: {},\n      after: {\n        date: input.date,\n        durationMinutes: input.durationMinutes,\n        timeProjectId: input.timeProjectId ?? null,\n        taskId: input.taskId ?? null,\n        notes: input.notes ?? null,\n        isBillable: input.isBillable ?? null,\n      },\n      display: {\n        fieldLabels: {\n          date: 'Date',\n          durationMinutes: 'Minutes',\n          timeProjectId: 'Project',\n          taskId: 'Task',\n          notes: 'Notes',\n          isBillable: 'Billable',\n        },\n      },\n    }\n  },\n  toOperation: async (input, ctx) => {\n    const scope = await resolveStaffToolScope(ctx)\n    return {\n      method: 'POST',\n      path: '/staff/timesheets/time-entries',\n      body: {\n        tenantId: scope.tenantId,\n        organizationId: scope.organizationId,\n        staffMemberId: scope.staffMemberId,\n        date: input.date,\n        durationMinutes: input.durationMinutes,\n        ...(input.timeProjectId ? { timeProjectId: input.timeProjectId } : {}),\n        ...(input.taskId ? { taskId: input.taskId } : {}),\n        ...(input.notes ? { notes: input.notes } : {}),\n        ...(input.isBillable === undefined ? {} : { isBillable: input.isBillable }),\n      },\n    } satisfies AiApiOperationRequest\n  },\n  mapResponse: (response, input) => ({\n    recordId: typeof response.data?.id === 'string' ? response.data.id : null,\n    commandName: 'staff.timesheets.time_entries.create',\n    before: {},\n    after: {\n      date: input.date,\n      durationMinutes: input.durationMinutes,\n      timeProjectId: input.timeProjectId ?? null,\n      taskId: input.taskId ?? null,\n    },\n  }),\n}) as unknown as AiToolDefinition\n\nconst startTimerInput = z.object({\n  date: isoDate.optional().describe('Day to file the running timer under; defaults to today.'),\n  timeProjectId: z.string().uuid().optional().describe('Project to start the timer against.'),\n  taskId: z.string().uuid().optional().describe('Task to start the timer against; it carries its own project.'),\n  notes: z.string().max(2000).optional().describe('What the timer is for.'),\n})\n\ntype StartTimerInput = z.infer<typeof startTimerInput>\n\nconst startTimerTool = defineApiBackedAiTool<StartTimerInput, { id?: string | null }, { recordId: string | null; commandName: string; before: Record<string, unknown>; after: Record<string, unknown> }>({\n  name: 'staff.start_timer',\n  displayName: 'Start timer',\n  description:\n    'Start a running timer for the signed-in user. Mutation tool \u2014 held for approval before it runs.',\n  inputSchema: startTimerInput,\n  requiredFeatures: [MANAGE_OWN_FEATURE],\n  isMutation: true,\n  loadBeforeRecord: async (input, ctx) => {\n    const scope = await resolveStaffToolScope(ctx as unknown as AiToolExecutionContext)\n    const date = input.date ?? new Date().toISOString().slice(0, 10)\n    return {\n      recordId: `timer:${scope.staffMemberId}:${date}`,\n      entityType: 'staff.staff_time_entry',\n      recordVersion: null,\n      before: {},\n      after: {\n        date,\n        timeProjectId: input.timeProjectId ?? null,\n        taskId: input.taskId ?? null,\n        notes: input.notes ?? null,\n      },\n      display: { fieldLabels: { date: 'Date', timeProjectId: 'Project', taskId: 'Task', notes: 'Notes' } },\n    }\n  },\n  toOperation: async (input, ctx) => {\n    const scope = await resolveStaffToolScope(ctx)\n    return {\n      method: 'POST',\n      path: '/staff/timesheets/time-entries/start-timer',\n      body: {\n        tenantId: scope.tenantId,\n        organizationId: scope.organizationId,\n        staffMemberId: scope.staffMemberId,\n        date: input.date ?? new Date().toISOString().slice(0, 10),\n        ...(input.timeProjectId ? { timeProjectId: input.timeProjectId } : {}),\n        ...(input.taskId ? { taskId: input.taskId } : {}),\n        ...(input.notes ? { notes: input.notes } : {}),\n      },\n    } satisfies AiApiOperationRequest\n  },\n  mapResponse: (response, input) => ({\n    recordId: typeof response.data?.id === 'string' ? response.data.id : null,\n    commandName: 'staff.timesheets.time_entries.start_timer',\n    before: {},\n    after: { timeProjectId: input.timeProjectId ?? null, taskId: input.taskId ?? null },\n  }),\n}) as unknown as AiToolDefinition\n\nconst stopTimerInput = z.object({\n  timeEntryId: z.string().uuid().describe('The time entry whose running timer should be stopped.'),\n})\n\ntype StopTimerInput = z.infer<typeof stopTimerInput>\n\nconst stopTimerTool = defineApiBackedAiTool<StopTimerInput, { durationMinutes?: number }, { recordId: string; commandName: string; before: Record<string, unknown>; after: Record<string, unknown> }>({\n  name: 'staff.stop_timer',\n  displayName: 'Stop timer',\n  description:\n    'Stop the running timer on a time entry and freeze its duration. Mutation tool \u2014 held for approval before it runs.',\n  inputSchema: stopTimerInput,\n  requiredFeatures: [MANAGE_OWN_FEATURE],\n  isMutation: true,\n  loadBeforeRecord: async (input, ctx) => {\n    assertTenantScope(ctx as unknown as AiToolExecutionContext)\n    return {\n      recordId: input.timeEntryId,\n      entityType: 'staff.staff_time_entry',\n      recordVersion: null,\n      before: { timerRunning: true },\n      after: { timerRunning: false },\n      display: { fieldLabels: { timerRunning: 'Timer running' } },\n    }\n  },\n  toOperation: async (input, ctx) => {\n    assertTenantScope(ctx)\n    return {\n      method: 'POST',\n      path: `/staff/timesheets/time-entries/${input.timeEntryId}/timer-stop`,\n      body: {},\n    } satisfies AiApiOperationRequest\n  },\n  mapResponse: (response, input) => ({\n    recordId: input.timeEntryId,\n    commandName: 'staff.timesheets.time_entries.stop_timer',\n    before: { timerRunning: true },\n    after: { timerRunning: false, durationMinutes: toMinutes(response.data?.durationMinutes) },\n  }),\n}) as unknown as AiToolDefinition\n\n/* ------------------------------------------------------------------- reads */\n\nconst summarizeWeekInput = z.object({\n  from: isoDate.describe('First day of the range, yyyy-mm-dd.'),\n  to: isoDate.describe('Last day of the range, inclusive, yyyy-mm-dd.'),\n})\n\ntype SummarizeWeekInput = z.infer<typeof summarizeWeekInput>\n\nconst summarizeWeekTool = defineApiBackedAiTool<\n  SummarizeWeekInput,\n  EntriesApiResponse,\n  {\n    from: string\n    to: string\n    totalMinutes: number\n    entryCount: number\n    byDate: Array<{ date: string; minutes: number }>\n    byProject: Array<{ timeProjectId: string | null; minutes: number; entryCount: number }>\n  }\n>({\n  name: 'staff.summarize_week',\n  displayName: 'Summarize logged time',\n  description:\n    'Summarize the signed-in user\u2019s logged time over a date range: totals per day and per project. Read-only. Returns minutes, never money.',\n  inputSchema: summarizeWeekInput,\n  requiredFeatures: [VIEW_FEATURE],\n  toOperation: async (input, ctx) => {\n    const scope = await resolveStaffToolScope(ctx)\n    return {\n      method: 'GET',\n      path: '/staff/timesheets/time-entries',\n      query: {\n        from: input.from,\n        to: input.to,\n        staffMemberId: scope.staffMemberId,\n        page: 1,\n        pageSize: 100,\n      },\n    } satisfies AiApiOperationRequest\n  },\n  mapResponse: (response, input) => {\n    const items = Array.isArray(response.data?.items) ? response.data.items : []\n    const byDate = new Map<string, number>()\n    const byProject = new Map<string, { minutes: number; entryCount: number }>()\n    let totalMinutes = 0\n    for (const row of items) {\n      const date = readDate(row)\n      const minutes = readMinutes(row)\n      totalMinutes += minutes\n      if (date) byDate.set(date, (byDate.get(date) ?? 0) + minutes)\n      const projectKey = readProjectId(row) ?? ''\n      const bucket = byProject.get(projectKey) ?? { minutes: 0, entryCount: 0 }\n      bucket.minutes += minutes\n      bucket.entryCount += 1\n      byProject.set(projectKey, bucket)\n    }\n    return {\n      from: input.from,\n      to: input.to,\n      totalMinutes,\n      entryCount: items.length,\n      byDate: Array.from(byDate.entries())\n        .map(([date, minutes]) => ({ date, minutes }))\n        .sort((left, right) => left.date.localeCompare(right.date)),\n      byProject: Array.from(byProject.entries()).map(([key, value]) => ({\n        timeProjectId: key.length > 0 ? key : null,\n        minutes: value.minutes,\n        entryCount: value.entryCount,\n      })),\n    }\n  },\n}) as unknown as AiToolDefinition\n\nconst findMissingDaysInput = z.object({\n  from: isoDate.describe('First day of the range, yyyy-mm-dd.'),\n  to: isoDate.describe('Last day of the range, inclusive, yyyy-mm-dd.'),\n  includeWeekends: z\n    .boolean()\n    .optional()\n    .describe('Count Saturdays and Sundays as days that need time logged. Defaults to false.'),\n})\n\ntype FindMissingDaysInput = z.infer<typeof findMissingDaysInput>\n\nconst findMissingDaysTool = defineApiBackedAiTool<\n  FindMissingDaysInput,\n  EntriesApiResponse,\n  { from: string; to: string; missingDates: string[]; checkedDayCount: number }\n>({\n  name: 'staff.find_missing_days',\n  displayName: 'Find days with no logged time',\n  description:\n    'List the days in a range on which the signed-in user logged no time. Weekends are excluded unless asked for. Read-only.',\n  inputSchema: findMissingDaysInput,\n  requiredFeatures: [VIEW_FEATURE],\n  toOperation: async (input, ctx) => {\n    const scope = await resolveStaffToolScope(ctx)\n    return {\n      method: 'GET',\n      path: '/staff/timesheets/time-entries',\n      query: {\n        from: input.from,\n        to: input.to,\n        staffMemberId: scope.staffMemberId,\n        page: 1,\n        pageSize: 100,\n      },\n    } satisfies AiApiOperationRequest\n  },\n  mapResponse: (response, input) => {\n    const items = Array.isArray(response.data?.items) ? response.data.items : []\n    const logged = new Set<string>()\n    for (const row of items) {\n      const date = readDate(row)\n      if (date && readMinutes(row) > 0) logged.add(date)\n    }\n    const candidates = enumerateDates(input.from, input.to).filter(\n      (date) => (input.includeWeekends ?? false) || !isWeekend(date),\n    )\n    return {\n      from: input.from,\n      to: input.to,\n      missingDates: candidates.filter((date) => !logged.has(date)),\n      checkedDayCount: candidates.length,\n    }\n  },\n}) as unknown as AiToolDefinition\n\nconst draftClientReportInput = z.object({\n  timeProjectIds: z\n    .array(z.string().uuid())\n    .min(1)\n    .max(100)\n    .describe('Projects the report covers. They must all belong to the same customer.'),\n  periodFrom: isoDate.describe('First day of the reported period, yyyy-mm-dd.'),\n  periodTo: isoDate.describe('Last day of the reported period, inclusive, yyyy-mm-dd.'),\n  customerId: z.string().uuid().optional().describe('Customer the report is for.'),\n  grouping: z\n    .string()\n    .optional()\n    .describe('Report grouping id, e.g. project_task, project_person or project_day.'),\n  includeAlreadyReported: z\n    .boolean()\n    .optional()\n    .describe('Include entries already frozen into an earlier report. Defaults to false.'),\n})\n\ntype DraftClientReportInput = z.infer<typeof draftClientReportInput>\n\ntype PreviewApiResponse = {\n  currencyCode?: unknown\n  grouping?: unknown\n  projects?: Array<{\n    id?: unknown\n    name?: unknown\n    entryCount?: unknown\n    billableMinutes?: unknown\n    nonbillableMinutes?: unknown\n  }>\n  totals?: unknown\n}\n\nconst draftClientReportTool = defineApiBackedAiTool<\n  DraftClientReportInput,\n  PreviewApiResponse,\n  {\n    periodFrom: string\n    periodTo: string\n    grouping: string | null\n    projects: Array<{ id: string | null; name: string | null; billableMinutes: number; nonbillableMinutes: number; entryCount: number }>\n  }\n>({\n  name: 'staff.draft_client_report',\n  displayName: 'Draft a client report',\n  description:\n    'Preview what a customer report would contain for a set of projects and a period, without creating one. Read-only \u2014 no report is written and nothing is locked. Amounts are omitted; ask the reports screen for money.',\n  inputSchema: draftClientReportInput,\n  requiredFeatures: [REPORTS_VIEW_FEATURE],\n  toOperation: async (input, ctx) => {\n    assertTenantScope(ctx)\n    return {\n      method: 'POST',\n      path: '/staff/timesheets/reports/preview',\n      body: {\n        timeProjectIds: input.timeProjectIds,\n        periodFrom: input.periodFrom,\n        periodTo: input.periodTo,\n        periodKind: 'custom',\n        ...(input.customerId ? { customerId: input.customerId } : {}),\n        ...(input.grouping ? { grouping: input.grouping } : {}),\n        includeAlreadyReported: input.includeAlreadyReported ?? false,\n        showRates: false,\n      },\n    } satisfies AiApiOperationRequest\n  },\n  /**\n   * The preview response carries rates and amounts when the caller holds\n   * `staff.timesheets.rates.view`. The tool asks for `showRates: false` and then\n   * projects only the minute columns, so an agent transcript never becomes a\n   * second, ungated copy of the customer's rate card.\n   */\n  mapResponse: (response, input) => ({\n    periodFrom: input.periodFrom,\n    periodTo: input.periodTo,\n    grouping: typeof response.data?.grouping === 'string' ? response.data.grouping : null,\n    projects: (response.data?.projects ?? []).map((project) => ({\n      id: typeof project.id === 'string' ? project.id : null,\n      name: typeof project.name === 'string' ? project.name : null,\n      billableMinutes: toMinutes(project.billableMinutes),\n      nonbillableMinutes: toMinutes(project.nonbillableMinutes),\n      entryCount: toMinutes(project.entryCount),\n    })),\n  }),\n}) as unknown as AiToolDefinition\n\nexport const timeTrackingAiTools: AiToolDefinition[] = [\n  logTimeTool,\n  startTimerTool,\n  stopTimerTool,\n  summarizeWeekTool,\n  findMissingDaysTool,\n  draftClientReportTool,\n]\n\nexport default timeTrackingAiTools\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/staff/ai-tools/types.js

@@ -0,0 +1,54 @@
+import { getStaffMemberByUserId } from "../lib/staffMemberResolver.js";
+function assertTenantScope(ctx) {
+  if (!ctx.tenantId) throw new Error("[internal] Tenant context is required for staff.* tools");
+  if (!ctx.organizationId) {
+    throw new Error("[internal] Organization context is required for staff.* tools");
+  }
+  return { tenantId: ctx.tenantId, organizationId: ctx.organizationId };
+}
+async function resolveStaffToolScope(ctx) {
+  const { tenantId, organizationId } = assertTenantScope(ctx);
+  if (!ctx.userId) throw new Error("[internal] User context is required for staff.* tools");
+  const container = ctx.container;
+  const em = container.resolve("em").fork();
+  const member = await getStaffMemberByUserId(em, ctx.userId, tenantId, organizationId);
+  if (!member) {
+    throw new Error("The signed-in user has no staff profile, so time cannot be logged for them.");
+  }
+  return { tenantId, organizationId, staffMemberId: member.id };
+}
+function toIsoDate(value) {
+  if (value instanceof Date) {
+    if (Number.isNaN(value.getTime())) return null;
+    return value.toISOString().slice(0, 10);
+  }
+  if (typeof value === "string" && value.trim().length > 0) return value.trim().slice(0, 10);
+  return null;
+}
+function toMinutes(value) {
+  const parsed = typeof value === "number" ? value : Number(value ?? 0);
+  return Number.isFinite(parsed) ? Math.trunc(parsed) : 0;
+}
+function enumerateDates(from, to) {
+  const start = Date.parse(`${from}T00:00:00Z`);
+  const end = Date.parse(`${to}T00:00:00Z`);
+  if (!Number.isFinite(start) || !Number.isFinite(end) || end < start) return [];
+  const dates = [];
+  for (let cursor = start; cursor <= end && dates.length < 366; cursor += 864e5) {
+    dates.push(new Date(cursor).toISOString().slice(0, 10));
+  }
+  return dates;
+}
+function isWeekend(date) {
+  const day = (/* @__PURE__ */ new Date(`${date}T00:00:00Z`)).getUTCDay();
+  return day === 0 || day === 6;
+}
+export {
+  assertTenantScope,
+  enumerateDates,
+  isWeekend,
+  resolveStaffToolScope,
+  toIsoDate,
+  toMinutes
+};
+//# sourceMappingURL=types.js.map

package/dist/modules/staff/ai-tools/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/staff/ai-tools/types.ts"],
+  "sourcesContent": ["import type { AwilixContainer } from 'awilix'\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport type { AiToolExecutionContext } from '@open-mercato/ai-assistant/modules/ai_assistant/lib/ai-api-operation-runner'\nimport { getStaffMemberByUserId } from '../lib/staffMemberResolver'\n\n/**\n * EP-49. Shared context helpers for the time-tracking AI tool pack.\n *\n * Every tool in the pack is API-backed: it re-uses a documented\n * `/api/staff/timesheets/*` route through `createAiApiOperationRunner`, which\n * resolves the route from the generated manifest, refuses a mutation route whose\n * `requiredFeatures` are not covered by the tool's own, and invokes the handler\n * in process with the caller's identity. So the tools inherit \u2014 rather than\n * restate \u2014 the project-access intersection, the money gate, the mutation guards,\n * the interceptors and the commands' audit and undo. Nothing here writes a time\n * entry itself.\n */\n\nexport type StaffToolScope = {\n  tenantId: string\n  organizationId: string\n  staffMemberId: string\n}\n\nexport function assertTenantScope(ctx: AiToolExecutionContext): {\n  tenantId: string\n  organizationId: string\n} {\n  if (!ctx.tenantId) throw new Error('[internal] Tenant context is required for staff.* tools')\n  if (!ctx.organizationId) {\n    throw new Error('[internal] Organization context is required for staff.* tools')\n  }\n  return { tenantId: ctx.tenantId, organizationId: ctx.organizationId }\n}\n\n/**\n * The pack is written for \"log MY time\": every tool acts as the caller's own\n * staff member and none of them accepts a `staffMemberId` from the model. A user\n * with no staff profile is refused rather than defaulted to somebody else.\n */\nexport async function resolveStaffToolScope(ctx: AiToolExecutionContext): Promise<StaffToolScope> {\n  const { tenantId, organizationId } = assertTenantScope(ctx)\n  if (!ctx.userId) throw new Error('[internal] User context is required for staff.* tools')\n  const container = ctx.container as AwilixContainer\n  const em = (container.resolve('em') as EntityManager).fork()\n  const member = await getStaffMemberByUserId(em, ctx.userId, tenantId, organizationId)\n  if (!member) {\n    throw new Error('The signed-in user has no staff profile, so time cannot be logged for them.')\n  }\n  return { tenantId, organizationId, staffMemberId: member.id }\n}\n\nexport function toIsoDate(value: unknown): string | null {\n  if (value instanceof Date) {\n    if (Number.isNaN(value.getTime())) return null\n    return value.toISOString().slice(0, 10)\n  }\n  if (typeof value === 'string' && value.trim().length > 0) return value.trim().slice(0, 10)\n  return null\n}\n\nexport function toMinutes(value: unknown): number {\n  const parsed = typeof value === 'number' ? value : Number(value ?? 0)\n  return Number.isFinite(parsed) ? Math.trunc(parsed) : 0\n}\n\n/** Inclusive `yyyy-mm-dd` walk; caps at a year so a bad range cannot build an unbounded array. */\nexport function enumerateDates(from: string, to: string): string[] {\n  const start = Date.parse(`${from}T00:00:00Z`)\n  const end = Date.parse(`${to}T00:00:00Z`)\n  if (!Number.isFinite(start) || !Number.isFinite(end) || end < start) return []\n  const dates: string[] = []\n  for (let cursor = start; cursor <= end && dates.length < 366; cursor += 86_400_000) {\n    dates.push(new Date(cursor).toISOString().slice(0, 10))\n  }\n  return dates\n}\n\nexport function isWeekend(date: string): boolean {\n  const day = new Date(`${date}T00:00:00Z`).getUTCDay()\n  return day === 0 || day === 6\n}\n"],
+  "mappings": "AAGA,SAAS,8BAA8B;AAqBhC,SAAS,kBAAkB,KAGhC;AACA,MAAI,CAAC,IAAI,SAAU,OAAM,IAAI,MAAM,yDAAyD;AAC5F,MAAI,CAAC,IAAI,gBAAgB;AACvB,UAAM,IAAI,MAAM,+DAA+D;AAAA,EACjF;AACA,SAAO,EAAE,UAAU,IAAI,UAAU,gBAAgB,IAAI,eAAe;AACtE;AAOA,eAAsB,sBAAsB,KAAsD;AAChG,QAAM,EAAE,UAAU,eAAe,IAAI,kBAAkB,GAAG;AAC1D,MAAI,CAAC,IAAI,OAAQ,OAAM,IAAI,MAAM,uDAAuD;AACxF,QAAM,YAAY,IAAI;AACtB,QAAM,KAAM,UAAU,QAAQ,IAAI,EAAoB,KAAK;AAC3D,QAAM,SAAS,MAAM,uBAAuB,IAAI,IAAI,QAAQ,UAAU,cAAc;AACpF,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,MAAM,6EAA6E;AAAA,EAC/F;AACA,SAAO,EAAE,UAAU,gBAAgB,eAAe,OAAO,GAAG;AAC9D;AAEO,SAAS,UAAU,OAA+B;AACvD,MAAI,iBAAiB,MAAM;AACzB,QAAI,OAAO,MAAM,MAAM,QAAQ,CAAC,EAAG,QAAO;AAC1C,WAAO,MAAM,YAAY,EAAE,MAAM,GAAG,EAAE;AAAA,EACxC;AACA,MAAI,OAAO,UAAU,YAAY,MAAM,KAAK,EAAE,SAAS,EAAG,QAAO,MAAM,KAAK,EAAE,MAAM,GAAG,EAAE;AACzF,SAAO;AACT;AAEO,SAAS,UAAU,OAAwB;AAChD,QAAM,SAAS,OAAO,UAAU,WAAW,QAAQ,OAAO,SAAS,CAAC;AACpE,SAAO,OAAO,SAAS,MAAM,IAAI,KAAK,MAAM,MAAM,IAAI;AACxD;AAGO,SAAS,eAAe,MAAc,IAAsB;AACjE,QAAM,QAAQ,KAAK,MAAM,GAAG,IAAI,YAAY;AAC5C,QAAM,MAAM,KAAK,MAAM,GAAG,EAAE,YAAY;AACxC,MAAI,CAAC,OAAO,SAAS,KAAK,KAAK,CAAC,OAAO,SAAS,GAAG,KAAK,MAAM,MAAO,QAAO,CAAC;AAC7E,QAAM,QAAkB,CAAC;AACzB,WAAS,SAAS,OAAO,UAAU,OAAO,MAAM,SAAS,KAAK,UAAU,OAAY;AAClF,UAAM,KAAK,IAAI,KAAK,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,EAAE,CAAC;AAAA,EACxD;AACA,SAAO;AACT;AAEO,SAAS,UAAU,MAAuB;AAC/C,QAAM,OAAM,oBAAI,KAAK,GAAG,IAAI,YAAY,GAAE,UAAU;AACpD,SAAO,QAAQ,KAAK,QAAQ;AAC9B;",
+  "names": []
+}

package/dist/modules/staff/ai-tools.js

@@ -0,0 +1,8 @@
+import timeTrackingAiTools from "./ai-tools/time-tracking-pack.js";
+const aiTools = [...timeTrackingAiTools];
+var ai_tools_default = aiTools;
+export {
+  aiTools,
+  ai_tools_default as default
+};
+//# sourceMappingURL=ai-tools.js.map

package/dist/modules/staff/ai-tools.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/modules/staff/ai-tools.ts"],
+  "sourcesContent": ["import type { AiToolDefinition } from '@open-mercato/ai-assistant/modules/ai_assistant/lib/types'\nimport timeTrackingAiTools from './ai-tools/time-tracking-pack'\n\n/**\n * EP-49. The module's AI tool registry.\n *\n * The generator discovers `ai-tools.ts` at the module root only, so a pack living\n * in `ai-tools/` reaches the runtime through this aggregator \u2014 the customers\n * idiom.\n */\nexport const aiTools: AiToolDefinition[] = [...timeTrackingAiTools]\n\nexport default aiTools\n"],
+  "mappings": "AACA,OAAO,yBAAyB;AASzB,MAAM,UAA8B,CAAC,GAAG,mBAAmB;AAElE,IAAO,mBAAQ;",
+  "names": []
+}

package/dist/modules/staff/analytics.js

@@ -11,14 +11,97 @@ const analyticsConfig = {
       fieldMappings: {
         id: { dbColumn: "id", type: "uuid" },
         durationMinutes: { dbColumn: "duration_minutes", type: "numeric" },
+        roundedMinutes: { dbColumn: "rounded_minutes", type: "numeric" },
         date: { dbColumn: "date", type: "timestamp" },
         timeProjectId: { dbColumn: "time_project_id", type: "uuid" },
         staffMemberId: { dbColumn: "staff_member_id", type: "uuid" },
+        taskId: { dbColumn: "task_id", type: "uuid" },
+        customerId: { dbColumn: "customer_id", type: "uuid" },
+        isBillable: { dbColumn: "is_billable", type: "text" },
+        lockedReportId: { dbColumn: "locked_report_id", type: "uuid" },
         source: { dbColumn: "source", type: "text" }
       },
       labelResolvers: {
         timeProjectId: { table: "staff_time_projects", idColumn: "id", labelColumn: "name" },
-        staffMemberId: { table: "staff_team_members", idColumn: "id", labelColumn: "display_name" }
+        staffMemberId: { table: "staff_team_members", idColumn: "id", labelColumn: "display_name" },
+        taskId: { table: "staff_time_tasks", idColumn: "id", labelColumn: "title" },
+        customerId: { table: "customer_entities", idColumn: "id", labelColumn: "display_name" },
+        lockedReportId: { table: "staff_time_reports", idColumn: "id", labelColumn: "reference" }
+      }
+    },
+    {
+      entityId: "staff:staff_time_tasks",
+      requiredFeatures: ["staff.timesheets.tasks.view"],
+      entityConfig: {
+        tableName: "staff_time_tasks",
+        dateField: "created_at",
+        defaultScopeFields: ["tenant_id", "organization_id"]
+      },
+      fieldMappings: {
+        id: { dbColumn: "id", type: "uuid" },
+        reference: { dbColumn: "reference", type: "text" },
+        timeProjectId: { dbColumn: "time_project_id", type: "uuid" },
+        parentTaskId: { dbColumn: "parent_task_id", type: "uuid" },
+        taskStatusId: { dbColumn: "task_status_id", type: "uuid" },
+        assigneeStaffMemberId: { dbColumn: "assignee_staff_member_id", type: "uuid" },
+        createdAt: { dbColumn: "created_at", type: "timestamp" },
+        closedAt: { dbColumn: "closed_at", type: "timestamp" }
+      },
+      labelResolvers: {
+        timeProjectId: { table: "staff_time_projects", idColumn: "id", labelColumn: "name" },
+        taskStatusId: { table: "staff_time_task_statuses", idColumn: "id", labelColumn: "name" },
+        assigneeStaffMemberId: { table: "staff_team_members", idColumn: "id", labelColumn: "display_name" },
+        parentTaskId: { table: "staff_time_tasks", idColumn: "id", labelColumn: "title" }
+      }
+    },
+    {
+      entityId: "staff:staff_time_projects",
+      requiredFeatures: ["staff.timesheets.projects.view"],
+      entityConfig: {
+        tableName: "staff_time_projects",
+        dateField: "created_at",
+        defaultScopeFields: ["tenant_id", "organization_id"]
+      },
+      fieldMappings: {
+        id: { dbColumn: "id", type: "uuid" },
+        code: { dbColumn: "code", type: "text" },
+        customerId: { dbColumn: "customer_id", type: "uuid" },
+        projectType: { dbColumn: "project_type", type: "text" },
+        status: { dbColumn: "status", type: "text" },
+        ownerUserId: { dbColumn: "owner_user_id", type: "uuid" },
+        costCenter: { dbColumn: "cost_center", type: "text" },
+        budgetKind: { dbColumn: "budget_kind", type: "text" },
+        billableByDefault: { dbColumn: "billable_by_default", type: "text" },
+        startDate: { dbColumn: "start_date", type: "timestamp" },
+        createdAt: { dbColumn: "created_at", type: "timestamp" }
+      },
+      labelResolvers: {
+        customerId: { table: "customer_entities", idColumn: "id", labelColumn: "display_name" }
+      }
+    },
+    {
+      entityId: "staff:staff_time_reports",
+      requiredFeatures: ["staff.timesheets.reports.view"],
+      entityConfig: {
+        tableName: "staff_time_reports",
+        dateField: "period_from",
+        defaultScopeFields: ["tenant_id", "organization_id"]
+      },
+      fieldMappings: {
+        id: { dbColumn: "id", type: "uuid" },
+        reference: { dbColumn: "reference", type: "text" },
+        customerId: { dbColumn: "customer_id", type: "uuid" },
+        status: { dbColumn: "status", type: "text" },
+        periodKind: { dbColumn: "period_kind", type: "text" },
+        periodFrom: { dbColumn: "period_from", type: "timestamp" },
+        periodTo: { dbColumn: "period_to", type: "timestamp" },
+        grouping: { dbColumn: "grouping", type: "text" },
+        totalBillableMinutes: { dbColumn: "total_billable_minutes", type: "numeric" },
+        totalNonbillableMinutes: { dbColumn: "total_nonbillable_minutes", type: "numeric" },
+        closedAt: { dbColumn: "closed_at", type: "timestamp" }
+      },
+      labelResolvers: {
+        customerId: { table: "customer_entities", idColumn: "id", labelColumn: "display_name" }
       }
     }
   ]

package/dist/modules/staff/analytics.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/modules/staff/analytics.ts"],
-  "sourcesContent": ["import type { AnalyticsModuleConfig } from '@open-mercato/shared/modules/analytics'\n\nexport const analyticsConfig: AnalyticsModuleConfig = {\n  entities: [\n    {\n      entityId: 'staff:staff_time_entries',\n      requiredFeatures: ['staff.timesheets.view'],\n      entityConfig: {\n        tableName: 'staff_time_entries',\n        dateField: 'date',\n        defaultScopeFields: ['tenant_id', 'organization_id'],\n      },\n      fieldMappings: {\n        id: { dbColumn: 'id', type: 'uuid' },\n        durationMinutes: { dbColumn: 'duration_minutes', type: 'numeric' },\n        date: { dbColumn: 'date', type: 'timestamp' },\n        timeProjectId: { dbColumn: 'time_project_id', type: 'uuid' },\n        staffMemberId: { dbColumn: 'staff_member_id', type: 'uuid' },\n        source: { dbColumn: 'source', type: 'text' },\n      },\n      labelResolvers: {\n        timeProjectId: { table: 'staff_time_projects', idColumn: 'id', labelColumn: 'name' },\n        staffMemberId: { table: 'staff_team_members', idColumn: 'id', labelColumn: 'display_name' },\n      },\n    },\n  ],\n}\n\nexport const config = analyticsConfig\nexport default analyticsConfig\n"],
-  "mappings": "AAEO,MAAM,kBAAyC;AAAA,EACpD,UAAU;AAAA,IACR;AAAA,MACE,UAAU;AAAA,MACV,kBAAkB,CAAC,uBAAuB;AAAA,MAC1C,cAAc;AAAA,QACZ,WAAW;AAAA,QACX,WAAW;AAAA,QACX,oBAAoB,CAAC,aAAa,iBAAiB;AAAA,MACrD;AAAA,MACA,eAAe;AAAA,QACb,IAAI,EAAE,UAAU,MAAM,MAAM,OAAO;AAAA,QACnC,iBAAiB,EAAE,UAAU,oBAAoB,MAAM,UAAU;AAAA,QACjE,MAAM,EAAE,UAAU,QAAQ,MAAM,YAAY;AAAA,QAC5C,eAAe,EAAE,UAAU,mBAAmB,MAAM,OAAO;AAAA,QAC3D,eAAe,EAAE,UAAU,mBAAmB,MAAM,OAAO;AAAA,QAC3D,QAAQ,EAAE,UAAU,UAAU,MAAM,OAAO;AAAA,MAC7C;AAAA,MACA,gBAAgB;AAAA,QACd,eAAe,EAAE,OAAO,uBAAuB,UAAU,MAAM,aAAa,OAAO;AAAA,QACnF,eAAe,EAAE,OAAO,sBAAsB,UAAU,MAAM,aAAa,eAAe;AAAA,MAC5F;AAAA,IACF;AAAA,EACF;AACF;AAEO,MAAM,SAAS;AACtB,IAAO,oBAAQ;",
+  "sourcesContent": ["import type { AnalyticsModuleConfig } from '@open-mercato/shared/modules/analytics'\n\n/**\n * EP-47. Four time-tracking entities are aggregatable from a dashboard widget.\n *\n * Two rules shape every mapping below.\n *\n * **Money is absent, never blanked.** `staff_time_entries.rate_override_amount`,\n * `staff_time_projects.hourly_rate` / `budget_value` and\n * `staff_time_reports.total_amount` are deliberately NOT mapped. An\n * `AnalyticsEntityConfig` carries a single `requiredFeatures` list for the whole\n * entity, so there is no shape in which a money column is gated on\n * `staff.timesheets.rates.view` while the rest of the entity stays readable by a\n * plain viewer \u2014 and mapping it under the weaker gate would hand every dashboard\n * author the customer's rates. The minute columns carry the same analysis\n * without the disclosure.\n *\n * **Custom fields are not dimensions and cannot be.** `AnalyticsFieldMapping` is\n * `{ dbColumn, type }` and the aggregation builder emits `dbColumn` as a bare\n * identifier against `entityConfig.tableName` (`dashboards/lib/aggregations.ts`),\n * so a mapping can only ever name a real column on that one table. The custom\n * fields EP-43 declared are EAV rows in the `entities` module's tables, reachable\n * by neither a join nor the jsonb-path form (which needs the values to live in a\n * jsonb column on the row itself). The point is moot in any case while the\n * command-backed write path drops `cf_*` on the way in \u2014 see the module\n * `AGENTS.md` \u00A7 Time-tracking custom fields.\n *\n * `is_billable` and `billable_by_default` are declared `text` because\n * `AnalyticsFieldType` has no boolean member; the type is read for exactly one\n * decision \u2014 whether a group-by column gets a `date_trunc` \u2014 so a boolean column\n * grouped as `text` is emitted verbatim and labelled by its own value.\n */\nexport const analyticsConfig: AnalyticsModuleConfig = {\n  entities: [\n    {\n      entityId: 'staff:staff_time_entries',\n      requiredFeatures: ['staff.timesheets.view'],\n      entityConfig: {\n        tableName: 'staff_time_entries',\n        dateField: 'date',\n        defaultScopeFields: ['tenant_id', 'organization_id'],\n      },\n      fieldMappings: {\n        id: { dbColumn: 'id', type: 'uuid' },\n        durationMinutes: { dbColumn: 'duration_minutes', type: 'numeric' },\n        roundedMinutes: { dbColumn: 'rounded_minutes', type: 'numeric' },\n        date: { dbColumn: 'date', type: 'timestamp' },\n        timeProjectId: { dbColumn: 'time_project_id', type: 'uuid' },\n        staffMemberId: { dbColumn: 'staff_member_id', type: 'uuid' },\n        taskId: { dbColumn: 'task_id', type: 'uuid' },\n        customerId: { dbColumn: 'customer_id', type: 'uuid' },\n        isBillable: { dbColumn: 'is_billable', type: 'text' },\n        lockedReportId: { dbColumn: 'locked_report_id', type: 'uuid' },\n        source: { dbColumn: 'source', type: 'text' },\n      },\n      labelResolvers: {\n        timeProjectId: { table: 'staff_time_projects', idColumn: 'id', labelColumn: 'name' },\n        staffMemberId: { table: 'staff_team_members', idColumn: 'id', labelColumn: 'display_name' },\n        taskId: { table: 'staff_time_tasks', idColumn: 'id', labelColumn: 'title' },\n        customerId: { table: 'customer_entities', idColumn: 'id', labelColumn: 'display_name' },\n        lockedReportId: { table: 'staff_time_reports', idColumn: 'id', labelColumn: 'reference' },\n      },\n    },\n    {\n      entityId: 'staff:staff_time_tasks',\n      requiredFeatures: ['staff.timesheets.tasks.view'],\n      entityConfig: {\n        tableName: 'staff_time_tasks',\n        dateField: 'created_at',\n        defaultScopeFields: ['tenant_id', 'organization_id'],\n      },\n      fieldMappings: {\n        id: { dbColumn: 'id', type: 'uuid' },\n        reference: { dbColumn: 'reference', type: 'text' },\n        timeProjectId: { dbColumn: 'time_project_id', type: 'uuid' },\n        parentTaskId: { dbColumn: 'parent_task_id', type: 'uuid' },\n        taskStatusId: { dbColumn: 'task_status_id', type: 'uuid' },\n        assigneeStaffMemberId: { dbColumn: 'assignee_staff_member_id', type: 'uuid' },\n        createdAt: { dbColumn: 'created_at', type: 'timestamp' },\n        closedAt: { dbColumn: 'closed_at', type: 'timestamp' },\n      },\n      labelResolvers: {\n        timeProjectId: { table: 'staff_time_projects', idColumn: 'id', labelColumn: 'name' },\n        taskStatusId: { table: 'staff_time_task_statuses', idColumn: 'id', labelColumn: 'name' },\n        assigneeStaffMemberId: { table: 'staff_team_members', idColumn: 'id', labelColumn: 'display_name' },\n        parentTaskId: { table: 'staff_time_tasks', idColumn: 'id', labelColumn: 'title' },\n      },\n    },\n    {\n      entityId: 'staff:staff_time_projects',\n      requiredFeatures: ['staff.timesheets.projects.view'],\n      entityConfig: {\n        tableName: 'staff_time_projects',\n        dateField: 'created_at',\n        defaultScopeFields: ['tenant_id', 'organization_id'],\n      },\n      fieldMappings: {\n        id: { dbColumn: 'id', type: 'uuid' },\n        code: { dbColumn: 'code', type: 'text' },\n        customerId: { dbColumn: 'customer_id', type: 'uuid' },\n        projectType: { dbColumn: 'project_type', type: 'text' },\n        status: { dbColumn: 'status', type: 'text' },\n        ownerUserId: { dbColumn: 'owner_user_id', type: 'uuid' },\n        costCenter: { dbColumn: 'cost_center', type: 'text' },\n        budgetKind: { dbColumn: 'budget_kind', type: 'text' },\n        billableByDefault: { dbColumn: 'billable_by_default', type: 'text' },\n        startDate: { dbColumn: 'start_date', type: 'timestamp' },\n        createdAt: { dbColumn: 'created_at', type: 'timestamp' },\n      },\n      labelResolvers: {\n        customerId: { table: 'customer_entities', idColumn: 'id', labelColumn: 'display_name' },\n      },\n    },\n    {\n      entityId: 'staff:staff_time_reports',\n      requiredFeatures: ['staff.timesheets.reports.view'],\n      entityConfig: {\n        tableName: 'staff_time_reports',\n        dateField: 'period_from',\n        defaultScopeFields: ['tenant_id', 'organization_id'],\n      },\n      fieldMappings: {\n        id: { dbColumn: 'id', type: 'uuid' },\n        reference: { dbColumn: 'reference', type: 'text' },\n        customerId: { dbColumn: 'customer_id', type: 'uuid' },\n        status: { dbColumn: 'status', type: 'text' },\n        periodKind: { dbColumn: 'period_kind', type: 'text' },\n        periodFrom: { dbColumn: 'period_from', type: 'timestamp' },\n        periodTo: { dbColumn: 'period_to', type: 'timestamp' },\n        grouping: { dbColumn: 'grouping', type: 'text' },\n        totalBillableMinutes: { dbColumn: 'total_billable_minutes', type: 'numeric' },\n        totalNonbillableMinutes: { dbColumn: 'total_nonbillable_minutes', type: 'numeric' },\n        closedAt: { dbColumn: 'closed_at', type: 'timestamp' },\n      },\n      labelResolvers: {\n        customerId: { table: 'customer_entities', idColumn: 'id', labelColumn: 'display_name' },\n      },\n    },\n  ],\n}\n\nexport const config = analyticsConfig\nexport default analyticsConfig\n"],
+  "mappings": "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",
   "names": []
 }