@happyvertical/smrt-support 0.52.0 → 0.53.1

package/AGENTS.md

@@ -7,10 +7,14 @@ systems of record. The package owns the case lifecycle, channel intake, the
 Automated Support Response workflow with lossless **Human Handoff**,
 Project-qualified routing, **Service Target** clocks with timed escalation,
 and auditable **Service Time Entries** whose client charges and provider
-compensation stay separate. Since #1955 the canonical `ServiceTimeEntry` class
-is owned by `smrt-projects`; this package exposes a compatibility subtype that
-restates the shared fields for isolated manifest scanning. Both imports use the
-unchanged `service_time_entries` table, so no data is duplicated.
+compensation stay separate. Since #3288 the shared `ServiceTimeEntry` class
+is owned by `smrt-timesheets` (smrt-projects re-exports it); this package's
+subtype extends it directly, adds `caseId` / `specialistId` (frozen on
+approval via `frozenFieldNames()`), and restates the shared fields for
+isolated manifest scanning. Every import uses the unchanged
+`service_time_entries` table, so no data is duplicated. Keep the subtype a
+direct child of the timesheets entry: a third same-named level on the table
+breaks single-table-family resolution.
 
 **Boundary (FR-29a):** Support owns tickets, interactions, routing, and
 service targets. Delivery Operations owns repository work — a **Delivery
@@ -219,20 +223,23 @@ or a `PermissionResolver`.
 `RoutingRationale` (ranked specialists with eligibility + factor chips and
 an optional reassign action), and `TimeEntryApprovalQueue`
 (date/hours/description/worker/status/amount with
-approve/reject-with-reason actions on submitted rows). Hosts adapt models
+approve/reject-with-reason actions on submitted rows; owned by
+smrt-timesheets since #3288 and re-exported here). Hosts adapt models
 with `toSupportCaseView` / `toCaseTimelineItemView` / `toServiceTargetView`
 / `toSupportTimeEntryView` — the time-entry view's first eight fields
-deliberately match `smrt-projects`' presentation `TimeEntry` contract.
+deliberately match the presentation `TimeEntry` contract, and
+`SupportTimeEntryView` extends smrt-timesheets' `TimeEntryApprovalView`.
 Components use `smrt-ui` primitives (`smrtRawPrimitives: "strict"`).
 
 ## Dependencies
 
 Package dependencies: `smrt-core`, `smrt-tenancy`, `smrt-projects`,
-`smrt-chat`, `smrt-messages`, `smrt-jobs`, `smrt-users`, `smrt-ui`,
+`smrt-timesheets`, `smrt-chat`, `smrt-messages`, `smrt-jobs`, `smrt-users`,
+`smrt-ui`,
 `@happyvertical/logger`, `@happyvertical/sql`. Profile and subscriptions
 references are `@crossPackageRef` string ids or plain string
-keys. `smrt-projects` is the intentional shared delivery/evidence edge added
-by #1955. No inter-`smrt-*` `peerDependencies`.
+keys. `smrt-projects` is the intentional shared delivery edge added by #1955;
+`smrt-timesheets` owns the shared time-entry evidence (#3288). No inter-`smrt-*` `peerDependencies`.
 
 ## Validation
 

package/README.md

@@ -11,10 +11,20 @@ connects the two without making Support execute repository work.
 ## Installation
 
 ```bash
-pnpm add @happyvertical/smrt-support
+pnpm add @happyvertical/smrt-support @happyvertical/smrt-timesheets
 ```
 
-Add `svelte` for the optional operator surfaces.
+Add `svelte` for the optional operator surfaces. Support's `ServiceTimeEntry`
+extends the [`smrt-timesheets`](../timesheets/README.md) entry (#3288). Under
+pnpm, declare `@happyvertical/smrt-timesheets` directly: the CLI's manifest
+discovery reads only top-level packages, so without it `smrt db:migrate` /
+`db:status` stop planning the timesheets snapshot tables
+(`service_charge_snapshots`, `service_compensation_snapshots`). Stored
+`@happyvertical/smrt-projects:ServiceTimeEntry` references do not yet resolve
+when smrt-support is installed, and neither does
+`@happyvertical/smrt-timesheets:ServiceTimeEntry` (support's subtype replaces
+it): reference `@happyvertical/smrt-support:ServiceTimeEntry`. See the
+smrt-timesheets README migration note.
 
 ## Open and manage a case
 
@@ -109,13 +119,16 @@ operations.
 `@happyvertical/smrt-support/svelte` exports presentational `CaseQueue`,
 `CaseDetail`, `TargetList`, `RoutingRationale`, and
 `TimeEntryApprovalQueue` components plus model-to-view adapters. Hosts own data
-loading and actions.
+loading and actions. `TimeEntryApprovalQueue` lives in
+[`smrt-timesheets`](../timesheets/README.md) and is re-exported here.
 
 ## Related packages
 
 - [`smrt-chat`](../chat/README.md) and
   [`smrt-messages`](../messages/README.md) provide transports.
 - [`smrt-jobs`](../jobs/README.md) runs escalation tasks.
+- [`smrt-timesheets`](../timesheets/README.md) owns the shared time entry that
+  support's `ServiceTimeEntry` extends with `caseId` / `specialistId`.
 - [`smrt-users`](../users/README.md) supplies permission resolution.
 - [`smrt-subscriptions`](../subscriptions/README.md) may supply plan keys without
   becoming a runtime dependency.