@happyvertical/smrt-timesheets 0.55.24 → 0.56.1

package/dist/manifest.json

@@ -2,8 +2,513 @@
   "version": "1.0.0",
   "timestamp": 0,
   "packageName": "@happyvertical/smrt-timesheets",
-  "packageVersion": "0.55.24",
+  "packageVersion": "0.56.1",
   "objects": {
+    "@happyvertical/smrt-timesheets:AttendanceCorrection": {
+      "name": "attendancecorrection",
+      "className": "AttendanceCorrection",
+      "qualifiedName": "@happyvertical/smrt-timesheets:AttendanceCorrection",
+      "collection": "attendancecorrections",
+      "description": "One append-only change to closed attendance: who changed whose time, why, and the before/after values as JSON (null for an addition's before or a removal's after).",
+      "filePath": "/home/runner/work/smrt/smrt/packages/timesheets/src/attendance/correction-models.ts",
+      "packageName": "@happyvertical/smrt-timesheets",
+      "fields": {
+        "tenantId": {
+          "type": "text",
+          "required": true,
+          "_meta": {
+            "sqlType": "UUID",
+            "__tenancy": {
+              "isTenantIdField": true,
+              "autoFilter": true,
+              "required": true,
+              "autoPopulate": true,
+              "nullable": false,
+              "mode": "required",
+              "field": "tenantId",
+              "allowSuperAdminBypass": false
+            }
+          }
+        },
+        "subjectProfileId": {
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-profiles:Profile"
+        },
+        "actorProfileId": {
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-profiles:Profile"
+        },
+        "kind": {
+          "type": "text",
+          "required": false,
+          "_meta": {}
+        },
+        "punchId": {
+          "type": "foreignKey",
+          "required": false,
+          "related": "AttendancePunch"
+        },
+        "targetId": {
+          "type": "text",
+          "required": false
+        },
+        "beforeState": {
+          "type": "text",
+          "required": false,
+          "_meta": {}
+        },
+        "afterState": {
+          "type": "text",
+          "required": false,
+          "_meta": {}
+        },
+        "reason": {
+          "type": "text",
+          "required": false,
+          "_meta": {}
+        },
+        "acknowledgementRequired": {
+          "type": "boolean",
+          "required": true,
+          "default": false
+        },
+        "acknowledgedAt": {
+          "type": "datetime",
+          "required": false
+        },
+        "acknowledgedByProfileId": {
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "_meta": {
+            "nullable": true
+          }
+        }
+      },
+      "methods": {
+        "getBefore": {
+          "name": "getBefore",
+          "async": false,
+          "parameters": [],
+          "returnType": "T | null",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "getAfter": {
+          "name": "getAfter",
+          "async": false,
+          "parameters": [],
+          "returnType": "T | null",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "save": {
+          "name": "save",
+          "async": true,
+          "parameters": [],
+          "returnType": "Promise<this>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "delete": {
+          "name": "delete",
+          "async": true,
+          "parameters": [],
+          "returnType": "Promise<void>",
+          "isStatic": false,
+          "isPublic": true
+        }
+      },
+      "decoratorConfig": {
+        "tableName": "attendance_corrections",
+        "sensitive": true,
+        "indexes": [
+          {
+            "name": "attendance_corrections_punch_idx",
+            "columns": [
+              "tenantId",
+              "punchId"
+            ]
+          },
+          {
+            "name": "attendance_corrections_subject_idx",
+            "columns": [
+              "tenantId",
+              "subjectProfileId"
+            ]
+          }
+        ],
+        "api": {
+          "include": []
+        },
+        "cli": {
+          "include": []
+        },
+        "mcp": {
+          "include": []
+        },
+        "tenantScoped": {
+          "mode": "required"
+        },
+        "conflictColumns": [
+          "tenant_id",
+          "slug",
+          "context"
+        ]
+      },
+      "extends": "SmrtObject",
+      "exportName": "AttendanceCorrection",
+      "collectionExportName": "AttendanceCorrectionCollection",
+      "validationRules": [
+        {
+          "field": "acknowledgementRequired",
+          "rule": "required",
+          "fieldType": "boolean"
+        }
+      ],
+      "schema": {
+        "tableName": "attendance_corrections",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"attendance_corrections\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"subject_profile_id\" UUID,\n  \"actor_profile_id\" UUID,\n  \"kind\" TEXT,\n  \"punch_id\" UUID,\n  \"target_id\" TEXT,\n  \"before_state\" TEXT,\n  \"after_state\" TEXT,\n  \"reason\" TEXT,\n  \"acknowledgement_required\" BOOLEAN NOT NULL DEFAULT FALSE,\n  \"acknowledged_at\" TIMESTAMP,\n  \"acknowledged_by_profile_id\" UUID\n);",
+        "columns": {
+          "id": {
+            "type": "UUID",
+            "primaryKey": true,
+            "referenceKind": "id",
+            "notNull": true
+          },
+          "slug": {
+            "type": "TEXT",
+            "notNull": true
+          },
+          "context": {
+            "type": "TEXT",
+            "notNull": true,
+            "default": ""
+          },
+          "created_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "updated_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "tenant_id": {
+            "type": "UUID",
+            "referenceKind": "tenantId",
+            "notNull": true,
+            "unique": false
+          },
+          "subject_profile_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": false,
+            "unique": false
+          },
+          "actor_profile_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": false,
+            "unique": false
+          },
+          "kind": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "punch_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": false,
+            "unique": false,
+            "foreignKey": {
+              "table": "attendance_punches",
+              "column": "id",
+              "onDelete": "NO ACTION",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "target_id": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "before_state": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "after_state": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "reason": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "acknowledgement_required": {
+            "type": "BOOLEAN",
+            "notNull": true,
+            "unique": false,
+            "default": false
+          },
+          "acknowledged_at": {
+            "type": "TIMESTAMP",
+            "notNull": false,
+            "unique": false
+          },
+          "acknowledged_by_profile_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": false,
+            "unique": false
+          }
+        },
+        "indexes": [
+          {
+            "name": "attendance_corrections_slug_context_idx",
+            "columns": [
+              "tenant_id",
+              "slug",
+              "context"
+            ],
+            "unique": true
+          },
+          {
+            "name": "attendance_corrections_punch_idx",
+            "columns": [
+              "tenant_id",
+              "punch_id"
+            ]
+          },
+          {
+            "name": "attendance_corrections_subject_idx",
+            "columns": [
+              "tenant_id",
+              "subject_profile_id"
+            ]
+          },
+          {
+            "name": "attendance_corrections_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "attendance_corrections_subject_profile_id_idx",
+            "columns": [
+              "subject_profile_id"
+            ]
+          },
+          {
+            "name": "attendance_corrections_actor_profile_id_idx",
+            "columns": [
+              "actor_profile_id"
+            ]
+          },
+          {
+            "name": "attendance_corrections_punch_id_idx",
+            "columns": [
+              "punch_id"
+            ]
+          },
+          {
+            "name": "attendance_corrections_acknowledged_by_profile_id_idx",
+            "columns": [
+              "acknowledged_by_profile_id"
+            ]
+          }
+        ],
+        "version": "19e8de69"
+      },
+      "importPath": "@happyvertical/smrt-timesheets/attendance"
+    },
+    "@happyvertical/smrt-timesheets:AttendanceCorrectionCollection": {
+      "name": "attendancecorrectioncollection",
+      "className": "AttendanceCorrectionCollection",
+      "qualifiedName": "@happyvertical/smrt-timesheets:AttendanceCorrectionCollection",
+      "collection": "attendancecorrections",
+      "description": "The correction ledger.",
+      "filePath": "/home/runner/work/smrt/smrt/packages/timesheets/src/attendance/correction-models.ts",
+      "packageName": "@happyvertical/smrt-timesheets",
+      "fields": {},
+      "methods": {},
+      "decoratorConfig": {
+        "tableName": "attendance_corrections"
+      },
+      "extends": "SmrtCollection",
+      "extendsTypeArg": "AttendanceCorrection",
+      "exportName": "AttendanceCorrectionCollection",
+      "collectionExportName": "AttendanceCorrectionCollectionCollection",
+      "schema": {
+        "tableName": "attendance_corrections",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"attendance_corrections\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"subject_profile_id\" UUID,\n  \"actor_profile_id\" UUID,\n  \"kind\" TEXT,\n  \"punch_id\" UUID,\n  \"target_id\" TEXT,\n  \"before_state\" TEXT,\n  \"after_state\" TEXT,\n  \"reason\" TEXT,\n  \"acknowledgement_required\" BOOLEAN NOT NULL DEFAULT FALSE,\n  \"acknowledged_at\" TIMESTAMP,\n  \"acknowledged_by_profile_id\" UUID\n);",
+        "columns": {
+          "id": {
+            "type": "UUID",
+            "primaryKey": true,
+            "referenceKind": "id",
+            "notNull": true
+          },
+          "slug": {
+            "type": "TEXT",
+            "notNull": true
+          },
+          "context": {
+            "type": "TEXT",
+            "notNull": true,
+            "default": ""
+          },
+          "created_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "updated_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "tenant_id": {
+            "type": "UUID",
+            "referenceKind": "tenantId",
+            "notNull": true,
+            "unique": false
+          },
+          "subject_profile_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": false,
+            "unique": false
+          },
+          "actor_profile_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": false,
+            "unique": false
+          },
+          "kind": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "punch_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": false,
+            "unique": false,
+            "foreignKey": {
+              "table": "attendance_punches",
+              "column": "id",
+              "onDelete": "NO ACTION",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "target_id": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "before_state": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "after_state": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "reason": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "acknowledgement_required": {
+            "type": "BOOLEAN",
+            "notNull": true,
+            "unique": false,
+            "default": false
+          },
+          "acknowledged_at": {
+            "type": "TIMESTAMP",
+            "notNull": false,
+            "unique": false
+          },
+          "acknowledged_by_profile_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": false,
+            "unique": false
+          }
+        },
+        "indexes": [
+          {
+            "name": "attendance_corrections_slug_context_idx",
+            "columns": [
+              "tenant_id",
+              "slug",
+              "context"
+            ],
+            "unique": true
+          },
+          {
+            "name": "attendance_corrections_punch_idx",
+            "columns": [
+              "tenant_id",
+              "punch_id"
+            ]
+          },
+          {
+            "name": "attendance_corrections_subject_idx",
+            "columns": [
+              "tenant_id",
+              "subject_profile_id"
+            ]
+          },
+          {
+            "name": "attendance_corrections_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "attendance_corrections_subject_profile_id_idx",
+            "columns": [
+              "subject_profile_id"
+            ]
+          },
+          {
+            "name": "attendance_corrections_actor_profile_id_idx",
+            "columns": [
+              "actor_profile_id"
+            ]
+          },
+          {
+            "name": "attendance_corrections_punch_id_idx",
+            "columns": [
+              "punch_id"
+            ]
+          },
+          {
+            "name": "attendance_corrections_acknowledged_by_profile_id_idx",
+            "columns": [
+              "acknowledged_by_profile_id"
+            ]
+          }
+        ],
+        "version": "19e8de69"
+      },
+      "importPath": "@happyvertical/smrt-timesheets/attendance"
+    },
     "@happyvertical/smrt-timesheets:AttendancePunch": {
       "name": "attendancepunch",
       "className": "AttendancePunch",
@@ -30,10 +535,367 @@
             }
           }
         },
-        "profileId": {
-          "type": "crossPackageRef",
+        "profileId": {
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-profiles:Profile"
+        },
+        "startedAt": {
+          "type": "datetime",
+          "required": false
+        },
+        "endedAt": {
+          "type": "datetime",
+          "required": false
+        },
+        "durationSeconds": {
+          "type": "integer",
+          "required": true,
+          "default": 0
+        },
+        "unpaidBreakSeconds": {
+          "type": "integer",
+          "required": true,
+          "default": 0
+        },
+        "reviewRequired": {
+          "type": "boolean",
+          "required": true,
+          "default": false
+        },
+        "autoCloseReason": {
+          "type": "text",
+          "required": false
+        },
+        "recordedOffline": {
+          "type": "boolean",
+          "required": true,
+          "default": false
+        },
+        "source": {
+          "type": "text",
+          "required": false
+        },
+        "deviceRefType": {
+          "type": "text",
+          "required": false
+        },
+        "deviceRefId": {
+          "type": "text",
+          "required": false
+        },
+        "serviceTimeEntryId": {
+          "type": "foreignKey",
+          "required": false,
+          "related": "ServiceTimeEntry",
+          "_meta": {
+            "nullable": true
+          }
+        },
+        "openSlot": {
+          "type": "text",
+          "required": true,
+          "_meta": {
+            "required": true
+          }
+        }
+      },
+      "methods": {
+        "save": {
+          "name": "save",
+          "async": true,
+          "parameters": [],
+          "returnType": "Promise<this>",
+          "isStatic": false,
+          "isPublic": true
+        }
+      },
+      "decoratorConfig": {
+        "tableName": "attendance_punches",
+        "indexes": [
+          {
+            "name": "attendance_punches_open_owner_key",
+            "columns": [
+              "tenantId",
+              "profileId",
+              "openSlot"
+            ],
+            "unique": true
+          },
+          {
+            "name": "attendance_punches_source_idx",
+            "columns": [
+              "tenantId",
+              "source"
+            ]
+          },
+          {
+            "name": "attendance_punches_device_idx",
+            "columns": [
+              "tenantId",
+              "deviceRefType",
+              "deviceRefId"
+            ]
+          }
+        ],
+        "api": {
+          "include": [
+            "list",
+            "get"
+          ]
+        },
+        "cli": {
+          "include": [
+            "list",
+            "get"
+          ]
+        },
+        "mcp": {
+          "include": [
+            "list",
+            "get"
+          ]
+        },
+        "tenantScoped": {
+          "mode": "required"
+        },
+        "conflictColumns": [
+          "tenant_id",
+          "slug",
+          "context"
+        ]
+      },
+      "extends": "SmrtObject",
+      "exportName": "AttendancePunch",
+      "collectionExportName": "AttendancePunchCollection",
+      "validationRules": [
+        {
+          "field": "durationSeconds",
+          "rule": "required",
+          "fieldType": "integer"
+        },
+        {
+          "field": "unpaidBreakSeconds",
+          "rule": "required",
+          "fieldType": "integer"
+        },
+        {
+          "field": "reviewRequired",
+          "rule": "required",
+          "fieldType": "boolean"
+        },
+        {
+          "field": "recordedOffline",
+          "rule": "required",
+          "fieldType": "boolean"
+        },
+        {
+          "field": "openSlot",
+          "rule": "required",
+          "fieldType": "text"
+        }
+      ],
+      "schema": {
+        "tableName": "attendance_punches",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"attendance_punches\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"profile_id\" UUID,\n  \"started_at\" TIMESTAMP,\n  \"ended_at\" TIMESTAMP,\n  \"duration_seconds\" INTEGER NOT NULL DEFAULT 0,\n  \"unpaid_break_seconds\" INTEGER NOT NULL DEFAULT 0,\n  \"review_required\" BOOLEAN NOT NULL DEFAULT FALSE,\n  \"auto_close_reason\" TEXT,\n  \"recorded_offline\" BOOLEAN NOT NULL DEFAULT FALSE,\n  \"source\" TEXT,\n  \"device_ref_type\" TEXT,\n  \"device_ref_id\" TEXT,\n  \"service_time_entry_id\" UUID,\n  \"open_slot\" TEXT NOT NULL\n);",
+        "columns": {
+          "id": {
+            "type": "UUID",
+            "primaryKey": true,
+            "referenceKind": "id",
+            "notNull": true
+          },
+          "slug": {
+            "type": "TEXT",
+            "notNull": true
+          },
+          "context": {
+            "type": "TEXT",
+            "notNull": true,
+            "default": ""
+          },
+          "created_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "updated_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "tenant_id": {
+            "type": "UUID",
+            "referenceKind": "tenantId",
+            "notNull": true,
+            "unique": false
+          },
+          "profile_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": false,
+            "unique": false
+          },
+          "started_at": {
+            "type": "TIMESTAMP",
+            "notNull": false,
+            "unique": false
+          },
+          "ended_at": {
+            "type": "TIMESTAMP",
+            "notNull": false,
+            "unique": false
+          },
+          "duration_seconds": {
+            "type": "INTEGER",
+            "notNull": true,
+            "unique": false,
+            "default": 0
+          },
+          "unpaid_break_seconds": {
+            "type": "INTEGER",
+            "notNull": true,
+            "unique": false,
+            "default": 0
+          },
+          "review_required": {
+            "type": "BOOLEAN",
+            "notNull": true,
+            "unique": false,
+            "default": false
+          },
+          "auto_close_reason": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "recorded_offline": {
+            "type": "BOOLEAN",
+            "notNull": true,
+            "unique": false,
+            "default": false
+          },
+          "source": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "device_ref_type": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "device_ref_id": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "service_time_entry_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": false,
+            "unique": false,
+            "foreignKey": {
+              "table": "service_time_entries",
+              "column": "id",
+              "onDelete": "NO ACTION",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "open_slot": {
+            "type": "TEXT",
+            "notNull": true,
+            "unique": false
+          }
+        },
+        "indexes": [
+          {
+            "name": "attendance_punches_slug_context_idx",
+            "columns": [
+              "tenant_id",
+              "slug",
+              "context"
+            ],
+            "unique": true
+          },
+          {
+            "name": "attendance_punches_open_owner_key",
+            "columns": [
+              "tenant_id",
+              "profile_id",
+              "open_slot"
+            ],
+            "unique": true
+          },
+          {
+            "name": "attendance_punches_source_idx",
+            "columns": [
+              "tenant_id",
+              "source"
+            ]
+          },
+          {
+            "name": "attendance_punches_device_idx",
+            "columns": [
+              "tenant_id",
+              "device_ref_type",
+              "device_ref_id"
+            ]
+          },
+          {
+            "name": "attendance_punches_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "attendance_punches_profile_id_idx",
+            "columns": [
+              "profile_id"
+            ]
+          },
+          {
+            "name": "attendance_punches_service_time_entry_id_idx",
+            "columns": [
+              "service_time_entry_id"
+            ]
+          }
+        ],
+        "version": "6fa5db50"
+      },
+      "importPath": "@happyvertical/smrt-timesheets/attendance"
+    },
+    "@happyvertical/smrt-timesheets:AttendanceBreak": {
+      "name": "attendancebreak",
+      "className": "AttendanceBreak",
+      "qualifiedName": "@happyvertical/smrt-timesheets:AttendanceBreak",
+      "collection": "attendancebreaks",
+      "description": "A paid or unpaid break inside one attendance punch.",
+      "filePath": "/home/runner/work/smrt/smrt/packages/timesheets/src/attendance/models.ts",
+      "packageName": "@happyvertical/smrt-timesheets",
+      "fields": {
+        "tenantId": {
+          "type": "text",
+          "required": true,
+          "_meta": {
+            "sqlType": "UUID",
+            "__tenancy": {
+              "isTenantIdField": true,
+              "autoFilter": true,
+              "required": true,
+              "autoPopulate": true,
+              "nullable": false,
+              "mode": "required",
+              "field": "tenantId",
+              "allowSuperAdminBypass": false
+            }
+          }
+        },
+        "punchId": {
+          "type": "foreignKey",
           "required": false,
-          "related": "@happyvertical/smrt-profiles:Profile"
+          "related": "AttendancePunch"
         },
         "startedAt": {
           "type": "datetime",
@@ -43,33 +905,14 @@
           "type": "datetime",
           "required": false
         },
-        "durationSeconds": {
-          "type": "integer",
-          "required": true,
-          "default": 0
-        },
-        "unpaidBreakSeconds": {
-          "type": "integer",
-          "required": true,
-          "default": 0
-        },
-        "reviewRequired": {
-          "type": "boolean",
-          "required": true,
-          "default": false
-        },
-        "recordedOffline": {
+        "paid": {
           "type": "boolean",
           "required": true,
           "default": false
         },
-        "serviceTimeEntryId": {
-          "type": "foreignKey",
-          "required": false,
-          "related": "ServiceTimeEntry",
-          "_meta": {
-            "nullable": true
-          }
+        "kind": {
+          "type": "text",
+          "required": false
         },
         "openSlot": {
           "type": "text",
@@ -87,16 +930,24 @@
           "returnType": "Promise<this>",
           "isStatic": false,
           "isPublic": true
+        },
+        "delete": {
+          "name": "delete",
+          "async": true,
+          "parameters": [],
+          "returnType": "Promise<void>",
+          "isStatic": false,
+          "isPublic": true
         }
       },
       "decoratorConfig": {
-        "tableName": "attendance_punches",
+        "tableName": "attendance_breaks",
         "indexes": [
           {
-            "name": "attendance_punches_open_owner_key",
+            "name": "attendance_breaks_open_punch_key",
             "columns": [
               "tenantId",
-              "profileId",
+              "punchId",
               "openSlot"
             ],
             "unique": true
@@ -130,26 +981,11 @@
         ]
       },
       "extends": "SmrtObject",
-      "exportName": "AttendancePunch",
-      "collectionExportName": "AttendancePunchCollection",
+      "exportName": "AttendanceBreak",
+      "collectionExportName": "AttendanceBreakCollection",
       "validationRules": [
         {
-          "field": "durationSeconds",
-          "rule": "required",
-          "fieldType": "integer"
-        },
-        {
-          "field": "unpaidBreakSeconds",
-          "rule": "required",
-          "fieldType": "integer"
-        },
-        {
-          "field": "reviewRequired",
-          "rule": "required",
-          "fieldType": "boolean"
-        },
-        {
-          "field": "recordedOffline",
+          "field": "paid",
           "rule": "required",
           "fieldType": "boolean"
         },
@@ -160,8 +996,8 @@
         }
       ],
       "schema": {
-        "tableName": "attendance_punches",
-        "ddl": "CREATE TABLE IF NOT EXISTS \"attendance_punches\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"profile_id\" UUID,\n  \"started_at\" TIMESTAMP,\n  \"ended_at\" TIMESTAMP,\n  \"duration_seconds\" INTEGER NOT NULL DEFAULT 0,\n  \"unpaid_break_seconds\" INTEGER NOT NULL DEFAULT 0,\n  \"review_required\" BOOLEAN NOT NULL DEFAULT FALSE,\n  \"recorded_offline\" BOOLEAN NOT NULL DEFAULT FALSE,\n  \"service_time_entry_id\" UUID,\n  \"open_slot\" TEXT NOT NULL\n);",
+        "tableName": "attendance_breaks",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"attendance_breaks\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"punch_id\" UUID,\n  \"started_at\" TIMESTAMP,\n  \"ended_at\" TIMESTAMP,\n  \"paid\" BOOLEAN NOT NULL DEFAULT FALSE,\n  \"kind\" TEXT,\n  \"open_slot\" TEXT NOT NULL\n);",
         "columns": {
           "id": {
             "type": "UUID",
@@ -194,11 +1030,17 @@
             "notNull": true,
             "unique": false
           },
-          "profile_id": {
+          "punch_id": {
             "type": "UUID",
-            "referenceKind": "crossPackageRef",
+            "referenceKind": "foreignKey",
             "notNull": false,
-            "unique": false
+            "unique": false,
+            "foreignKey": {
+              "table": "attendance_punches",
+              "column": "id",
+              "onDelete": "NO ACTION",
+              "onUpdate": "CASCADE"
+            }
           },
           "started_at": {
             "type": "TIMESTAMP",
@@ -210,41 +1052,16 @@
             "notNull": false,
             "unique": false
           },
-          "duration_seconds": {
-            "type": "INTEGER",
-            "notNull": true,
-            "unique": false,
-            "default": 0
-          },
-          "unpaid_break_seconds": {
-            "type": "INTEGER",
-            "notNull": true,
-            "unique": false,
-            "default": 0
-          },
-          "review_required": {
-            "type": "BOOLEAN",
-            "notNull": true,
-            "unique": false,
-            "default": false
-          },
-          "recorded_offline": {
+          "paid": {
             "type": "BOOLEAN",
             "notNull": true,
             "unique": false,
             "default": false
           },
-          "service_time_entry_id": {
-            "type": "UUID",
-            "referenceKind": "foreignKey",
+          "kind": {
+            "type": "TEXT",
             "notNull": false,
-            "unique": false,
-            "foreignKey": {
-              "table": "service_time_entries",
-              "column": "id",
-              "onDelete": "NO ACTION",
-              "onUpdate": "CASCADE"
-            }
+            "unique": false
           },
           "open_slot": {
             "type": "TEXT",
@@ -254,7 +1071,7 @@
         },
         "indexes": [
           {
-            "name": "attendance_punches_slug_context_idx",
+            "name": "attendance_breaks_slug_context_idx",
             "columns": [
               "tenant_id",
               "slug",
@@ -263,44 +1080,38 @@
             "unique": true
           },
           {
-            "name": "attendance_punches_open_owner_key",
+            "name": "attendance_breaks_open_punch_key",
             "columns": [
               "tenant_id",
-              "profile_id",
+              "punch_id",
               "open_slot"
             ],
             "unique": true
           },
           {
-            "name": "attendance_punches_tenant_id_created_at_idx",
+            "name": "attendance_breaks_tenant_id_created_at_idx",
             "columns": [
               "tenant_id",
               "created_at"
             ]
           },
           {
-            "name": "attendance_punches_profile_id_idx",
-            "columns": [
-              "profile_id"
-            ]
-          },
-          {
-            "name": "attendance_punches_service_time_entry_id_idx",
+            "name": "attendance_breaks_punch_id_idx",
             "columns": [
-              "service_time_entry_id"
+              "punch_id"
             ]
           }
         ],
-        "version": "eeca63b1"
+        "version": "1f6b2ddc"
       },
       "importPath": "@happyvertical/smrt-timesheets/attendance"
     },
-    "@happyvertical/smrt-timesheets:AttendanceBreak": {
-      "name": "attendancebreak",
-      "className": "AttendanceBreak",
-      "qualifiedName": "@happyvertical/smrt-timesheets:AttendanceBreak",
-      "collection": "attendancebreaks",
-      "description": "A paid or unpaid break inside one attendance punch.",
+    "@happyvertical/smrt-timesheets:AttendanceSegment": {
+      "name": "attendancesegment",
+      "className": "AttendanceSegment",
+      "qualifiedName": "@happyvertical/smrt-timesheets:AttendanceSegment",
+      "collection": "attendancesegments",
+      "description": "A running unit of work inside one attendance punch: a work reference plus an optional second (task) reference as queryable columns, so job costing can index and join them.",
       "filePath": "/home/runner/work/smrt/smrt/packages/timesheets/src/attendance/models.ts",
       "packageName": "@happyvertical/smrt-timesheets",
       "fields": {
@@ -326,6 +1137,30 @@
           "required": false,
           "related": "AttendancePunch"
         },
+        "workRefType": {
+          "type": "text",
+          "required": false
+        },
+        "workRefId": {
+          "type": "text",
+          "required": false
+        },
+        "taskRefType": {
+          "type": "text",
+          "required": false
+        },
+        "taskRefId": {
+          "type": "text",
+          "required": false
+        },
+        "kind": {
+          "type": "text",
+          "required": false
+        },
+        "description": {
+          "type": "text",
+          "required": false
+        },
         "startedAt": {
           "type": "datetime",
           "required": false
@@ -334,7 +1169,17 @@
           "type": "datetime",
           "required": false
         },
-        "paid": {
+        "durationSeconds": {
+          "type": "integer",
+          "required": true,
+          "default": 0
+        },
+        "closedReason": {
+          "type": "text",
+          "required": false,
+          "default": ""
+        },
+        "reviewRequired": {
           "type": "boolean",
           "required": true,
           "default": false
@@ -355,19 +1200,43 @@
           "returnType": "Promise<this>",
           "isStatic": false,
           "isPublic": true
+        },
+        "delete": {
+          "name": "delete",
+          "async": true,
+          "parameters": [],
+          "returnType": "Promise<void>",
+          "isStatic": false,
+          "isPublic": true
         }
       },
       "decoratorConfig": {
-        "tableName": "attendance_breaks",
+        "tableName": "attendance_segments",
         "indexes": [
           {
-            "name": "attendance_breaks_open_punch_key",
+            "name": "attendance_segments_open_punch_key",
             "columns": [
               "tenantId",
               "punchId",
               "openSlot"
             ],
             "unique": true
+          },
+          {
+            "name": "attendance_segments_work_idx",
+            "columns": [
+              "tenantId",
+              "workRefType",
+              "workRefId"
+            ]
+          },
+          {
+            "name": "attendance_segments_task_idx",
+            "columns": [
+              "tenantId",
+              "taskRefType",
+              "taskRefId"
+            ]
           }
         ],
         "api": {
@@ -398,11 +1267,16 @@
         ]
       },
       "extends": "SmrtObject",
-      "exportName": "AttendanceBreak",
-      "collectionExportName": "AttendanceBreakCollection",
+      "exportName": "AttendanceSegment",
+      "collectionExportName": "AttendanceSegmentCollection",
       "validationRules": [
         {
-          "field": "paid",
+          "field": "durationSeconds",
+          "rule": "required",
+          "fieldType": "integer"
+        },
+        {
+          "field": "reviewRequired",
           "rule": "required",
           "fieldType": "boolean"
         },
@@ -413,8 +1287,8 @@
         }
       ],
       "schema": {
-        "tableName": "attendance_breaks",
-        "ddl": "CREATE TABLE IF NOT EXISTS \"attendance_breaks\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"punch_id\" UUID,\n  \"started_at\" TIMESTAMP,\n  \"ended_at\" TIMESTAMP,\n  \"paid\" BOOLEAN NOT NULL DEFAULT FALSE,\n  \"open_slot\" TEXT NOT NULL\n);",
+        "tableName": "attendance_segments",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"attendance_segments\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"punch_id\" UUID,\n  \"work_ref_type\" TEXT,\n  \"work_ref_id\" TEXT,\n  \"task_ref_type\" TEXT,\n  \"task_ref_id\" TEXT,\n  \"kind\" TEXT,\n  \"description\" TEXT,\n  \"started_at\" TIMESTAMP,\n  \"ended_at\" TIMESTAMP,\n  \"duration_seconds\" INTEGER NOT NULL DEFAULT 0,\n  \"closed_reason\" TEXT DEFAULT '',\n  \"review_required\" BOOLEAN NOT NULL DEFAULT FALSE,\n  \"open_slot\" TEXT NOT NULL\n);",
         "columns": {
           "id": {
             "type": "UUID",
@@ -459,6 +1333,36 @@
               "onUpdate": "CASCADE"
             }
           },
+          "work_ref_type": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "work_ref_id": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "task_ref_type": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "task_ref_id": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "kind": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "description": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
           "started_at": {
             "type": "TIMESTAMP",
             "notNull": false,
@@ -469,7 +1373,19 @@
             "notNull": false,
             "unique": false
           },
-          "paid": {
+          "duration_seconds": {
+            "type": "INTEGER",
+            "notNull": true,
+            "unique": false,
+            "default": 0
+          },
+          "closed_reason": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false,
+            "default": ""
+          },
+          "review_required": {
             "type": "BOOLEAN",
             "notNull": true,
             "unique": false,
@@ -483,7 +1399,7 @@
         },
         "indexes": [
           {
-            "name": "attendance_breaks_slug_context_idx",
+            "name": "attendance_segments_slug_context_idx",
             "columns": [
               "tenant_id",
               "slug",
@@ -492,7 +1408,7 @@
             "unique": true
           },
           {
-            "name": "attendance_breaks_open_punch_key",
+            "name": "attendance_segments_open_punch_key",
             "columns": [
               "tenant_id",
               "punch_id",
@@ -501,20 +1417,36 @@
             "unique": true
           },
           {
-            "name": "attendance_breaks_tenant_id_created_at_idx",
+            "name": "attendance_segments_work_idx",
+            "columns": [
+              "tenant_id",
+              "work_ref_type",
+              "work_ref_id"
+            ]
+          },
+          {
+            "name": "attendance_segments_task_idx",
+            "columns": [
+              "tenant_id",
+              "task_ref_type",
+              "task_ref_id"
+            ]
+          },
+          {
+            "name": "attendance_segments_tenant_id_created_at_idx",
             "columns": [
               "tenant_id",
               "created_at"
             ]
           },
           {
-            "name": "attendance_breaks_punch_id_idx",
+            "name": "attendance_segments_punch_id_idx",
             "columns": [
               "punch_id"
             ]
           }
         ],
-        "version": "00cb739e"
+        "version": "6e1c6c80"
       },
       "importPath": "@happyvertical/smrt-timesheets/attendance"
     },
@@ -718,7 +1650,7 @@
       "collectionExportName": "AttendancePunchCollectionCollection",
       "schema": {
         "tableName": "attendance_punches",
-        "ddl": "CREATE TABLE IF NOT EXISTS \"attendance_punches\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"profile_id\" UUID,\n  \"started_at\" TIMESTAMP,\n  \"ended_at\" TIMESTAMP,\n  \"duration_seconds\" INTEGER NOT NULL DEFAULT 0,\n  \"unpaid_break_seconds\" INTEGER NOT NULL DEFAULT 0,\n  \"review_required\" BOOLEAN NOT NULL DEFAULT FALSE,\n  \"recorded_offline\" BOOLEAN NOT NULL DEFAULT FALSE,\n  \"service_time_entry_id\" UUID,\n  \"open_slot\" TEXT NOT NULL\n);",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"attendance_punches\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"profile_id\" UUID,\n  \"started_at\" TIMESTAMP,\n  \"ended_at\" TIMESTAMP,\n  \"duration_seconds\" INTEGER NOT NULL DEFAULT 0,\n  \"unpaid_break_seconds\" INTEGER NOT NULL DEFAULT 0,\n  \"review_required\" BOOLEAN NOT NULL DEFAULT FALSE,\n  \"auto_close_reason\" TEXT,\n  \"recorded_offline\" BOOLEAN NOT NULL DEFAULT FALSE,\n  \"source\" TEXT,\n  \"device_ref_type\" TEXT,\n  \"device_ref_id\" TEXT,\n  \"service_time_entry_id\" UUID,\n  \"open_slot\" TEXT NOT NULL\n);",
         "columns": {
           "id": {
             "type": "UUID",
@@ -785,12 +1717,32 @@
             "unique": false,
             "default": false
           },
+          "auto_close_reason": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
           "recorded_offline": {
             "type": "BOOLEAN",
             "notNull": true,
             "unique": false,
             "default": false
           },
+          "source": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "device_ref_type": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "device_ref_id": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
           "service_time_entry_id": {
             "type": "UUID",
             "referenceKind": "foreignKey",
@@ -828,6 +1780,21 @@
             ],
             "unique": true
           },
+          {
+            "name": "attendance_punches_source_idx",
+            "columns": [
+              "tenant_id",
+              "source"
+            ]
+          },
+          {
+            "name": "attendance_punches_device_idx",
+            "columns": [
+              "tenant_id",
+              "device_ref_type",
+              "device_ref_id"
+            ]
+          },
           {
             "name": "attendance_punches_tenant_id_created_at_idx",
             "columns": [
@@ -848,7 +1815,7 @@
             ]
           }
         ],
-        "version": "eeca63b1"
+        "version": "6fa5db50"
       },
       "importPath": "@happyvertical/smrt-timesheets/attendance"
     },
@@ -871,7 +1838,7 @@
       "collectionExportName": "AttendanceBreakCollectionCollection",
       "schema": {
         "tableName": "attendance_breaks",
-        "ddl": "CREATE TABLE IF NOT EXISTS \"attendance_breaks\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"punch_id\" UUID,\n  \"started_at\" TIMESTAMP,\n  \"ended_at\" TIMESTAMP,\n  \"paid\" BOOLEAN NOT NULL DEFAULT FALSE,\n  \"open_slot\" TEXT NOT NULL\n);",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"attendance_breaks\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"punch_id\" UUID,\n  \"started_at\" TIMESTAMP,\n  \"ended_at\" TIMESTAMP,\n  \"paid\" BOOLEAN NOT NULL DEFAULT FALSE,\n  \"kind\" TEXT,\n  \"open_slot\" TEXT NOT NULL\n);",
         "columns": {
           "id": {
             "type": "UUID",
@@ -932,6 +1899,11 @@
             "unique": false,
             "default": false
           },
+          "kind": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
           "open_slot": {
             "type": "TEXT",
             "notNull": true,
@@ -971,7 +1943,188 @@
             ]
           }
         ],
-        "version": "00cb739e"
+        "version": "1f6b2ddc"
+      },
+      "importPath": "@happyvertical/smrt-timesheets/attendance"
+    },
+    "@happyvertical/smrt-timesheets:AttendanceSegmentCollection": {
+      "name": "attendancesegmentcollection",
+      "className": "AttendanceSegmentCollection",
+      "qualifiedName": "@happyvertical/smrt-timesheets:AttendanceSegmentCollection",
+      "collection": "attendancesegments",
+      "description": "Work segments for job costing and attendance review.",
+      "filePath": "/home/runner/work/smrt/smrt/packages/timesheets/src/attendance/models.ts",
+      "packageName": "@happyvertical/smrt-timesheets",
+      "fields": {},
+      "methods": {},
+      "decoratorConfig": {
+        "tableName": "attendance_segments"
+      },
+      "extends": "SmrtCollection",
+      "extendsTypeArg": "AttendanceSegment",
+      "exportName": "AttendanceSegmentCollection",
+      "collectionExportName": "AttendanceSegmentCollectionCollection",
+      "schema": {
+        "tableName": "attendance_segments",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"attendance_segments\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"punch_id\" UUID,\n  \"work_ref_type\" TEXT,\n  \"work_ref_id\" TEXT,\n  \"task_ref_type\" TEXT,\n  \"task_ref_id\" TEXT,\n  \"kind\" TEXT,\n  \"description\" TEXT,\n  \"started_at\" TIMESTAMP,\n  \"ended_at\" TIMESTAMP,\n  \"duration_seconds\" INTEGER NOT NULL DEFAULT 0,\n  \"closed_reason\" TEXT DEFAULT '',\n  \"review_required\" BOOLEAN NOT NULL DEFAULT FALSE,\n  \"open_slot\" TEXT NOT NULL\n);",
+        "columns": {
+          "id": {
+            "type": "UUID",
+            "primaryKey": true,
+            "referenceKind": "id",
+            "notNull": true
+          },
+          "slug": {
+            "type": "TEXT",
+            "notNull": true
+          },
+          "context": {
+            "type": "TEXT",
+            "notNull": true,
+            "default": ""
+          },
+          "created_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "updated_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "tenant_id": {
+            "type": "UUID",
+            "referenceKind": "tenantId",
+            "notNull": true,
+            "unique": false
+          },
+          "punch_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": false,
+            "unique": false,
+            "foreignKey": {
+              "table": "attendance_punches",
+              "column": "id",
+              "onDelete": "NO ACTION",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "work_ref_type": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "work_ref_id": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "task_ref_type": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "task_ref_id": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "kind": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "description": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "started_at": {
+            "type": "TIMESTAMP",
+            "notNull": false,
+            "unique": false
+          },
+          "ended_at": {
+            "type": "TIMESTAMP",
+            "notNull": false,
+            "unique": false
+          },
+          "duration_seconds": {
+            "type": "INTEGER",
+            "notNull": true,
+            "unique": false,
+            "default": 0
+          },
+          "closed_reason": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false,
+            "default": ""
+          },
+          "review_required": {
+            "type": "BOOLEAN",
+            "notNull": true,
+            "unique": false,
+            "default": false
+          },
+          "open_slot": {
+            "type": "TEXT",
+            "notNull": true,
+            "unique": false
+          }
+        },
+        "indexes": [
+          {
+            "name": "attendance_segments_slug_context_idx",
+            "columns": [
+              "tenant_id",
+              "slug",
+              "context"
+            ],
+            "unique": true
+          },
+          {
+            "name": "attendance_segments_open_punch_key",
+            "columns": [
+              "tenant_id",
+              "punch_id",
+              "open_slot"
+            ],
+            "unique": true
+          },
+          {
+            "name": "attendance_segments_work_idx",
+            "columns": [
+              "tenant_id",
+              "work_ref_type",
+              "work_ref_id"
+            ]
+          },
+          {
+            "name": "attendance_segments_task_idx",
+            "columns": [
+              "tenant_id",
+              "task_ref_type",
+              "task_ref_id"
+            ]
+          },
+          {
+            "name": "attendance_segments_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "attendance_segments_punch_id_idx",
+            "columns": [
+              "punch_id"
+            ]
+          }
+        ],
+        "version": "6e1c6c80"
       },
       "importPath": "@happyvertical/smrt-timesheets/attendance"
     },
@@ -1518,12 +2671,18 @@
       "className": "ServiceChargeSnapshotCollection",
       "qualifiedName": "@happyvertical/smrt-timesheets:ServiceChargeSnapshotCollection",
       "collection": "servicechargesnapshots",
-      "description": "Collection over service_charge_snapshots.",
       "filePath": "/home/runner/work/smrt/smrt/packages/timesheets/src/models/service-snapshots.ts",
       "packageName": "@happyvertical/smrt-timesheets",
       "fields": {},
       "methods": {},
       "decoratorConfig": {
+        "mcp": {
+          "include": [
+            "list",
+            "get"
+          ]
+        },
+        "cli": false,
         "tableName": "service_charge_snapshots"
       },
       "extends": "SmrtCollection",
@@ -1641,12 +2800,18 @@
       "className": "ServiceCompensationSnapshotCollection",
       "qualifiedName": "@happyvertical/smrt-timesheets:ServiceCompensationSnapshotCollection",
       "collection": "servicecompensationsnapshots",
-      "description": "Collection over service_compensation_snapshots.",
       "filePath": "/home/runner/work/smrt/smrt/packages/timesheets/src/models/service-snapshots.ts",
       "packageName": "@happyvertical/smrt-timesheets",
       "fields": {},
       "methods": {},
       "decoratorConfig": {
+        "mcp": {
+          "include": [
+            "list",
+            "get"
+          ]
+        },
+        "cli": false,
         "tableName": "service_compensation_snapshots"
       },
       "extends": "SmrtCollection",
@@ -2011,7 +3176,10 @@
         "api": {
           "include": [
             "list",
-            "get"
+            "get",
+            "record",
+            "submit",
+            "approve"
           ]
         },
         "cli": {
@@ -2258,6 +3426,72 @@
       "packageName": "@happyvertical/smrt-timesheets",
       "fields": {},
       "methods": {
+        "record": {
+          "name": "record",
+          "async": true,
+          "parameters": [
+            {
+              "name": "options",
+              "type": "RecordServiceTimeActionInput",
+              "optional": false
+            }
+          ],
+          "returnType": "Promise<ServiceTimeEntry>",
+          "isStatic": false,
+          "isPublic": true,
+          "decoratorConfig": {
+            "httpMethod": "POST",
+            "path": "record",
+            "effect": "write",
+            "idempotent": false,
+            "openWorld": false,
+            "description": "Record a draft time entry for the signed-in person (service-backed)."
+          }
+        },
+        "submit": {
+          "name": "submit",
+          "async": true,
+          "parameters": [
+            {
+              "name": "options",
+              "type": "ServiceTimeEntryActionTarget",
+              "optional": false
+            }
+          ],
+          "returnType": "Promise<ServiceTimeEntry>",
+          "isStatic": false,
+          "isPublic": true,
+          "decoratorConfig": {
+            "httpMethod": "POST",
+            "path": "submit",
+            "effect": "write",
+            "idempotent": false,
+            "openWorld": false,
+            "description": "Submit a time entry for approval (service-backed)."
+          }
+        },
+        "approve": {
+          "name": "approve",
+          "async": true,
+          "parameters": [
+            {
+              "name": "options",
+              "type": "ServiceTimeEntryActionTarget",
+              "optional": false
+            }
+          ],
+          "returnType": "Promise<ServiceTimeEntry>",
+          "isStatic": false,
+          "isPublic": true,
+          "decoratorConfig": {
+            "httpMethod": "POST",
+            "path": "approve",
+            "effect": "write",
+            "idempotent": true,
+            "openWorld": false,
+            "description": "Approve a submitted time entry and snapshot its charge and compensation (service-backed)."
+          }
+        },
         "forWork": {
           "name": "forWork",
           "async": true,
@@ -2287,6 +3521,24 @@
         }
       },
       "decoratorConfig": {
+        "api": {
+          "include": [
+            "forWork",
+            "pendingApproval",
+            "record",
+            "submit",
+            "approve"
+          ]
+        },
+        "mcp": {
+          "include": [
+            "list",
+            "get",
+            "forWork",
+            "pendingApproval"
+          ]
+        },
+        "cli": false,
         "tableName": "service_time_entries"
       },
       "extends": "SmrtCollection",
@@ -2584,9 +3836,23 @@
           "_meta": {},
           "enum": [
             "open",
+            "submitted",
             "confirmed"
           ]
         },
+        "submittedAt": {
+          "type": "datetime",
+          "required": false
+        },
+        "submittedByProfileId": {
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "_meta": {
+            "nullable": true,
+            "onDelete": "RESTRICT"
+          }
+        },
         "confirmedAt": {
           "type": "datetime",
           "required": false
@@ -2678,7 +3944,7 @@
       ],
       "schema": {
         "tableName": "period_timecards",
-        "ddl": "CREATE TABLE IF NOT EXISTS \"period_timecards\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"profile_id\" UUID,\n  \"starts_at\" TIMESTAMP,\n  \"ends_at\" TIMESTAMP,\n  \"timezone\" TEXT,\n  \"rules_version\" TEXT,\n  \"rules_snapshot\" TEXT,\n  \"source_snapshot\" TEXT,\n  \"regular_seconds\" INTEGER NOT NULL DEFAULT 0,\n  \"overtime_seconds\" INTEGER NOT NULL DEFAULT 0,\n  \"total_seconds\" INTEGER NOT NULL DEFAULT 0,\n  \"status\" TEXT,\n  \"confirmed_at\" TIMESTAMP,\n  \"confirmed_by_profile_id\" UUID\n);",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"period_timecards\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"profile_id\" UUID,\n  \"starts_at\" TIMESTAMP,\n  \"ends_at\" TIMESTAMP,\n  \"timezone\" TEXT,\n  \"rules_version\" TEXT,\n  \"rules_snapshot\" TEXT,\n  \"source_snapshot\" TEXT,\n  \"regular_seconds\" INTEGER NOT NULL DEFAULT 0,\n  \"overtime_seconds\" INTEGER NOT NULL DEFAULT 0,\n  \"total_seconds\" INTEGER NOT NULL DEFAULT 0,\n  \"status\" TEXT,\n  \"submitted_at\" TIMESTAMP,\n  \"submitted_by_profile_id\" UUID,\n  \"confirmed_at\" TIMESTAMP,\n  \"confirmed_by_profile_id\" UUID\n);",
         "columns": {
           "id": {
             "type": "UUID",
@@ -2770,6 +4036,17 @@
             "notNull": false,
             "unique": false
           },
+          "submitted_at": {
+            "type": "TIMESTAMP",
+            "notNull": false,
+            "unique": false
+          },
+          "submitted_by_profile_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": false,
+            "unique": false
+          },
           "confirmed_at": {
             "type": "TIMESTAMP",
             "notNull": false,
@@ -2805,6 +4082,12 @@
               "profile_id"
             ]
           },
+          {
+            "name": "period_timecards_submitted_by_profile_id_idx",
+            "columns": [
+              "submitted_by_profile_id"
+            ]
+          },
           {
             "name": "period_timecards_confirmed_by_profile_id_idx",
             "columns": [
@@ -2812,7 +4095,7 @@
             ]
           }
         ],
-        "version": "8153dc2a"
+        "version": "00299335"
       },
       "importPath": "@happyvertical/smrt-timesheets/rollup"
     },
@@ -2875,17 +4158,276 @@
           "required": true,
           "default": 0
         },
-        "overtimeSeconds": {
-          "type": "integer",
-          "required": true,
-          "default": 0
+        "overtimeSeconds": {
+          "type": "integer",
+          "required": true,
+          "default": 0
+        },
+        "reason": {
+          "type": "text",
+          "required": false
+        }
+      },
+      "methods": {
+        "save": {
+          "name": "save",
+          "async": true,
+          "parameters": [],
+          "returnType": "Promise<this>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "delete": {
+          "name": "delete",
+          "async": true,
+          "parameters": [],
+          "returnType": "Promise<void>",
+          "isStatic": false,
+          "isPublic": true
+        }
+      },
+      "decoratorConfig": {
+        "tableName": "timecard_adjustments",
+        "sensitive": true,
+        "api": {
+          "include": []
+        },
+        "cli": {
+          "include": []
+        },
+        "mcp": {
+          "include": []
+        },
+        "tenantScoped": {
+          "mode": "required"
+        },
+        "conflictColumns": [
+          "tenant_id",
+          "slug",
+          "context"
+        ]
+      },
+      "extends": "SmrtObject",
+      "exportName": "TimecardAdjustment",
+      "collectionExportName": "TimecardAdjustmentCollection",
+      "validationRules": [
+        {
+          "field": "regularSeconds",
+          "rule": "required",
+          "fieldType": "integer"
+        },
+        {
+          "field": "overtimeSeconds",
+          "rule": "required",
+          "fieldType": "integer"
+        }
+      ],
+      "schema": {
+        "tableName": "timecard_adjustments",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"timecard_adjustments\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"timecard_id\" UUID,\n  \"profile_id\" UUID,\n  \"actor_profile_id\" UUID,\n  \"operation_id\" TEXT,\n  \"regular_seconds\" INTEGER NOT NULL DEFAULT 0,\n  \"overtime_seconds\" INTEGER NOT NULL DEFAULT 0,\n  \"reason\" TEXT\n);",
+        "columns": {
+          "id": {
+            "type": "UUID",
+            "primaryKey": true,
+            "referenceKind": "id",
+            "notNull": true
+          },
+          "slug": {
+            "type": "TEXT",
+            "notNull": true
+          },
+          "context": {
+            "type": "TEXT",
+            "notNull": true,
+            "default": ""
+          },
+          "created_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "updated_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "tenant_id": {
+            "type": "UUID",
+            "referenceKind": "tenantId",
+            "notNull": true,
+            "unique": false
+          },
+          "timecard_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": false,
+            "unique": false,
+            "foreignKey": {
+              "table": "period_timecards",
+              "column": "id",
+              "onDelete": "RESTRICT",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "profile_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": false,
+            "unique": false
+          },
+          "actor_profile_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": false,
+            "unique": false
+          },
+          "operation_id": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "regular_seconds": {
+            "type": "INTEGER",
+            "notNull": true,
+            "unique": false,
+            "default": 0
+          },
+          "overtime_seconds": {
+            "type": "INTEGER",
+            "notNull": true,
+            "unique": false,
+            "default": 0
+          },
+          "reason": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          }
+        },
+        "indexes": [
+          {
+            "name": "timecard_adjustments_slug_context_idx",
+            "columns": [
+              "tenant_id",
+              "slug",
+              "context"
+            ],
+            "unique": true
+          },
+          {
+            "name": "timecard_adjustments_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "timecard_adjustments_timecard_id_idx",
+            "columns": [
+              "timecard_id"
+            ]
+          },
+          {
+            "name": "timecard_adjustments_profile_id_idx",
+            "columns": [
+              "profile_id"
+            ]
+          },
+          {
+            "name": "timecard_adjustments_actor_profile_id_idx",
+            "columns": [
+              "actor_profile_id"
+            ]
+          }
+        ],
+        "version": "582afe16"
+      },
+      "importPath": "@happyvertical/smrt-timesheets/rollup"
+    },
+    "@happyvertical/smrt-timesheets:TimecardReopening": {
+      "name": "timecardreopening",
+      "className": "TimecardReopening",
+      "qualifiedName": "@happyvertical/smrt-timesheets:TimecardReopening",
+      "collection": "timecardreopenings",
+      "description": "Append-only audit row for one reopening of a submitted or confirmed card: who reopened whose period, why, and the totals it had at that moment (base, adjustments and effective, in integer seconds).",
+      "filePath": "/home/runner/work/smrt/smrt/packages/timesheets/src/rollup/models.ts",
+      "packageName": "@happyvertical/smrt-timesheets",
+      "fields": {
+        "tenantId": {
+          "type": "text",
+          "required": true,
+          "_meta": {
+            "sqlType": "UUID",
+            "__tenancy": {
+              "isTenantIdField": true,
+              "autoFilter": true,
+              "required": true,
+              "autoPopulate": true,
+              "nullable": false,
+              "mode": "required",
+              "field": "tenantId",
+              "allowSuperAdminBypass": false
+            }
+          }
+        },
+        "timecardId": {
+          "type": "foreignKey",
+          "required": false,
+          "related": "PeriodTimecard",
+          "_meta": {
+            "onDelete": "RESTRICT"
+          }
+        },
+        "profileId": {
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "_meta": {
+            "onDelete": "RESTRICT"
+          }
+        },
+        "actorProfileId": {
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "_meta": {
+            "onDelete": "RESTRICT"
+          }
+        },
+        "operationId": {
+          "type": "text",
+          "required": false
+        },
+        "fromStatus": {
+          "type": "text",
+          "required": false,
+          "_meta": {},
+          "enum": [
+            "open",
+            "submitted",
+            "confirmed"
+          ]
         },
         "reason": {
           "type": "text",
-          "required": false
+          "required": false,
+          "_meta": {}
+        },
+        "previousState": {
+          "type": "text",
+          "required": false,
+          "_meta": {}
         }
       },
       "methods": {
+        "getPrevious": {
+          "name": "getPrevious",
+          "async": false,
+          "parameters": [],
+          "returnType": "T",
+          "isStatic": false,
+          "isPublic": true
+        },
         "save": {
           "name": "save",
           "async": true,
@@ -2904,8 +4446,17 @@
         }
       },
       "decoratorConfig": {
-        "tableName": "timecard_adjustments",
+        "tableName": "timecard_reopenings",
         "sensitive": true,
+        "indexes": [
+          {
+            "name": "timecard_reopenings_card_idx",
+            "columns": [
+              "tenantId",
+              "timecardId"
+            ]
+          }
+        ],
         "api": {
           "include": []
         },
@@ -2925,23 +4476,12 @@
         ]
       },
       "extends": "SmrtObject",
-      "exportName": "TimecardAdjustment",
-      "collectionExportName": "TimecardAdjustmentCollection",
-      "validationRules": [
-        {
-          "field": "regularSeconds",
-          "rule": "required",
-          "fieldType": "integer"
-        },
-        {
-          "field": "overtimeSeconds",
-          "rule": "required",
-          "fieldType": "integer"
-        }
-      ],
+      "exportName": "TimecardReopening",
+      "collectionExportName": "TimecardReopeningCollection",
+      "validationRules": [],
       "schema": {
-        "tableName": "timecard_adjustments",
-        "ddl": "CREATE TABLE IF NOT EXISTS \"timecard_adjustments\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"timecard_id\" UUID,\n  \"profile_id\" UUID,\n  \"actor_profile_id\" UUID,\n  \"operation_id\" TEXT,\n  \"regular_seconds\" INTEGER NOT NULL DEFAULT 0,\n  \"overtime_seconds\" INTEGER NOT NULL DEFAULT 0,\n  \"reason\" TEXT\n);",
+        "tableName": "timecard_reopenings",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"timecard_reopenings\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"timecard_id\" UUID,\n  \"profile_id\" UUID,\n  \"actor_profile_id\" UUID,\n  \"operation_id\" TEXT,\n  \"from_status\" TEXT,\n  \"reason\" TEXT,\n  \"previous_state\" TEXT\n);",
         "columns": {
           "id": {
             "type": "UUID",
@@ -3003,27 +4543,25 @@
             "notNull": false,
             "unique": false
           },
-          "regular_seconds": {
-            "type": "INTEGER",
-            "notNull": true,
-            "unique": false,
-            "default": 0
-          },
-          "overtime_seconds": {
-            "type": "INTEGER",
-            "notNull": true,
-            "unique": false,
-            "default": 0
+          "from_status": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
           },
           "reason": {
             "type": "TEXT",
             "notNull": false,
             "unique": false
+          },
+          "previous_state": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
           }
         },
         "indexes": [
           {
-            "name": "timecard_adjustments_slug_context_idx",
+            "name": "timecard_reopenings_slug_context_idx",
             "columns": [
               "tenant_id",
               "slug",
@@ -3032,32 +4570,39 @@
             "unique": true
           },
           {
-            "name": "timecard_adjustments_tenant_id_created_at_idx",
+            "name": "timecard_reopenings_card_idx",
+            "columns": [
+              "tenant_id",
+              "timecard_id"
+            ]
+          },
+          {
+            "name": "timecard_reopenings_tenant_id_created_at_idx",
             "columns": [
               "tenant_id",
               "created_at"
             ]
           },
           {
-            "name": "timecard_adjustments_timecard_id_idx",
+            "name": "timecard_reopenings_timecard_id_idx",
             "columns": [
               "timecard_id"
             ]
           },
           {
-            "name": "timecard_adjustments_profile_id_idx",
+            "name": "timecard_reopenings_profile_id_idx",
             "columns": [
               "profile_id"
             ]
           },
           {
-            "name": "timecard_adjustments_actor_profile_id_idx",
+            "name": "timecard_reopenings_actor_profile_id_idx",
             "columns": [
               "actor_profile_id"
             ]
           }
         ],
-        "version": "582afe16"
+        "version": "0498ec40"
       },
       "importPath": "@happyvertical/smrt-timesheets/rollup"
     },
@@ -3080,7 +4625,7 @@
       "collectionExportName": "PeriodTimecardCollectionCollection",
       "schema": {
         "tableName": "period_timecards",
-        "ddl": "CREATE TABLE IF NOT EXISTS \"period_timecards\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"profile_id\" UUID,\n  \"starts_at\" TIMESTAMP,\n  \"ends_at\" TIMESTAMP,\n  \"timezone\" TEXT,\n  \"rules_version\" TEXT,\n  \"rules_snapshot\" TEXT,\n  \"source_snapshot\" TEXT,\n  \"regular_seconds\" INTEGER NOT NULL DEFAULT 0,\n  \"overtime_seconds\" INTEGER NOT NULL DEFAULT 0,\n  \"total_seconds\" INTEGER NOT NULL DEFAULT 0,\n  \"status\" TEXT,\n  \"confirmed_at\" TIMESTAMP,\n  \"confirmed_by_profile_id\" UUID\n);",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"period_timecards\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"profile_id\" UUID,\n  \"starts_at\" TIMESTAMP,\n  \"ends_at\" TIMESTAMP,\n  \"timezone\" TEXT,\n  \"rules_version\" TEXT,\n  \"rules_snapshot\" TEXT,\n  \"source_snapshot\" TEXT,\n  \"regular_seconds\" INTEGER NOT NULL DEFAULT 0,\n  \"overtime_seconds\" INTEGER NOT NULL DEFAULT 0,\n  \"total_seconds\" INTEGER NOT NULL DEFAULT 0,\n  \"status\" TEXT,\n  \"submitted_at\" TIMESTAMP,\n  \"submitted_by_profile_id\" UUID,\n  \"confirmed_at\" TIMESTAMP,\n  \"confirmed_by_profile_id\" UUID\n);",
         "columns": {
           "id": {
             "type": "UUID",
@@ -3172,6 +4717,17 @@
             "notNull": false,
             "unique": false
           },
+          "submitted_at": {
+            "type": "TIMESTAMP",
+            "notNull": false,
+            "unique": false
+          },
+          "submitted_by_profile_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": false,
+            "unique": false
+          },
           "confirmed_at": {
             "type": "TIMESTAMP",
             "notNull": false,
@@ -3207,6 +4763,12 @@
               "profile_id"
             ]
           },
+          {
+            "name": "period_timecards_submitted_by_profile_id_idx",
+            "columns": [
+              "submitted_by_profile_id"
+            ]
+          },
           {
             "name": "period_timecards_confirmed_by_profile_id_idx",
             "columns": [
@@ -3214,7 +4776,7 @@
             ]
           }
         ],
-        "version": "8153dc2a"
+        "version": "00299335"
       },
       "importPath": "@happyvertical/smrt-timesheets/rollup"
     },
@@ -3356,21 +4918,311 @@
         "version": "582afe16"
       },
       "importPath": "@happyvertical/smrt-timesheets/rollup"
+    },
+    "@happyvertical/smrt-timesheets:TimecardReopeningCollection": {
+      "name": "timecardreopeningcollection",
+      "className": "TimecardReopeningCollection",
+      "qualifiedName": "@happyvertical/smrt-timesheets:TimecardReopeningCollection",
+      "collection": "timecardreopenings",
+      "description": "Scoped append-only reopening ledger.",
+      "filePath": "/home/runner/work/smrt/smrt/packages/timesheets/src/rollup/models.ts",
+      "packageName": "@happyvertical/smrt-timesheets",
+      "fields": {},
+      "methods": {},
+      "decoratorConfig": {
+        "tableName": "timecard_reopenings"
+      },
+      "extends": "SmrtCollection",
+      "extendsTypeArg": "TimecardReopening",
+      "exportName": "TimecardReopeningCollection",
+      "collectionExportName": "TimecardReopeningCollectionCollection",
+      "schema": {
+        "tableName": "timecard_reopenings",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"timecard_reopenings\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"timecard_id\" UUID,\n  \"profile_id\" UUID,\n  \"actor_profile_id\" UUID,\n  \"operation_id\" TEXT,\n  \"from_status\" TEXT,\n  \"reason\" TEXT,\n  \"previous_state\" TEXT\n);",
+        "columns": {
+          "id": {
+            "type": "UUID",
+            "primaryKey": true,
+            "referenceKind": "id",
+            "notNull": true
+          },
+          "slug": {
+            "type": "TEXT",
+            "notNull": true
+          },
+          "context": {
+            "type": "TEXT",
+            "notNull": true,
+            "default": ""
+          },
+          "created_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "updated_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "tenant_id": {
+            "type": "UUID",
+            "referenceKind": "tenantId",
+            "notNull": true,
+            "unique": false
+          },
+          "timecard_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": false,
+            "unique": false,
+            "foreignKey": {
+              "table": "period_timecards",
+              "column": "id",
+              "onDelete": "RESTRICT",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "profile_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": false,
+            "unique": false
+          },
+          "actor_profile_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": false,
+            "unique": false
+          },
+          "operation_id": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "from_status": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "reason": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "previous_state": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          }
+        },
+        "indexes": [
+          {
+            "name": "timecard_reopenings_slug_context_idx",
+            "columns": [
+              "tenant_id",
+              "slug",
+              "context"
+            ],
+            "unique": true
+          },
+          {
+            "name": "timecard_reopenings_card_idx",
+            "columns": [
+              "tenant_id",
+              "timecard_id"
+            ]
+          },
+          {
+            "name": "timecard_reopenings_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "timecard_reopenings_timecard_id_idx",
+            "columns": [
+              "timecard_id"
+            ]
+          },
+          {
+            "name": "timecard_reopenings_profile_id_idx",
+            "columns": [
+              "profile_id"
+            ]
+          },
+          {
+            "name": "timecard_reopenings_actor_profile_id_idx",
+            "columns": [
+              "actor_profile_id"
+            ]
+          }
+        ],
+        "version": "0498ec40"
+      },
+      "importPath": "@happyvertical/smrt-timesheets/rollup"
     }
   },
   "moduleType": "smrt",
+  "recipes": [
+    {
+      "id": "timesheets.time-entries",
+      "className": "TimeEntriesRecipe",
+      "label": "Time entries",
+      "summary": "Record who worked how long on what, for approval.",
+      "synonyms": [
+        "timesheets",
+        "time tracking",
+        "hours",
+        "billable hours",
+        "timecards"
+      ],
+      "models": [
+        "@happyvertical/smrt-timesheets:ServiceTimeEntry"
+      ],
+      "nav": [
+        {
+          "label": "Time entries",
+          "model": "@happyvertical/smrt-timesheets:ServiceTimeEntry",
+          "icon": "fileText",
+          "description": "Hours worked, by person and by job, from draft to approved."
+        }
+      ],
+      "requires": [],
+      "section": {
+        "id": "work",
+        "label": "Work",
+        "icon": "wrench",
+        "description": "Time and costs: the work behind each job."
+      },
+      "options": {
+        "@happyvertical/smrt-timesheets:ServiceTimeEntry": {
+          "fields": {
+            "participantProfileId": {
+              "label": "Person",
+              "order": 1
+            },
+            "description": {
+              "order": 2,
+              "help": "What the time was spent on, in a few words."
+            },
+            "startedAt": {
+              "label": "Started",
+              "order": 3
+            },
+            "endedAt": {
+              "label": "Ended",
+              "order": 4
+            },
+            "durationSeconds": {
+              "label": "Duration (seconds)",
+              "order": 5,
+              "help": "Whole seconds: 3600 is one hour."
+            },
+            "workRefId": {
+              "label": "Work reference",
+              "order": 6,
+              "help": "The job, project or case this time belongs to."
+            },
+            "workRefType": {
+              "visibility": "hidden"
+            },
+            "participantKind": {
+              "default": "human",
+              "visibility": "hidden"
+            },
+            "agentRef": {
+              "visibility": "hidden"
+            },
+            "source": {
+              "default": "manual",
+              "visibility": "hidden"
+            },
+            "evidence": {
+              "visibility": "hidden"
+            },
+            "status": {
+              "visibility": "hidden",
+              "locked": true
+            },
+            "submittedAt": {
+              "visibility": "hidden",
+              "locked": true
+            },
+            "submittedByProfileId": {
+              "visibility": "hidden",
+              "locked": true
+            },
+            "approvedAt": {
+              "visibility": "hidden",
+              "locked": true
+            },
+            "approvedByProfileId": {
+              "visibility": "hidden",
+              "locked": true
+            },
+            "approvalPath": {
+              "visibility": "hidden",
+              "locked": true
+            },
+            "rejectedAt": {
+              "visibility": "hidden",
+              "locked": true
+            },
+            "rejectedByProfileId": {
+              "visibility": "hidden",
+              "locked": true
+            },
+            "rejectionReason": {
+              "visibility": "hidden",
+              "locked": true
+            },
+            "correctionOfId": {
+              "visibility": "hidden",
+              "locked": true
+            },
+            "metadata": {
+              "visibility": "hidden"
+            }
+          }
+        }
+      },
+      "help": {
+        "markdown": "## Overview\n\nTime entries record who worked how long on what. Each entry names the person,\nwhat they did and when, and moves from draft to submitted to approved.\n\n## Tasks\n\n### Record time\n\n1. Create a new time entry.\n2. Pick the **{field:participantProfileId}** who did the work.\n3. Write a short **{field:description}** of what was done.\n4. Enter when it **{field:startedAt}** and **{field:endedAt}**, or type the\n   **{field:durationSeconds}** directly (3600 is one hour).\n\n### Send it for approval\n\nApproval is not something you change on this form. It runs through your\napp's approval screen, which records who did each step and when.\n\n1. When an entry is ready to check, the person who did the work submits it.\n2. An approver, someone your app allows to approve time, approves it or sends\n   it back with a reason. Approving fixes what the hours are charged and paid\n   at, so an approved entry never changes; correct it with a new entry.\n3. If your app has no approval screen yet, entries stay as drafts until one is\n   added.\n",
+        "fieldRefs": [
+          "description",
+          "durationSeconds",
+          "endedAt",
+          "participantProfileId",
+          "startedAt"
+        ]
+      },
+      "demo": {
+        "mode": "server",
+        "reasons": [
+          "Needs a server because its package does not build for a browser: node:crypto; and its package depends on @happyvertical/smrt-profiles, @happyvertical/smrt-tenancy, @happyvertical/smrt-users, which do not build for a browser (#3617, #3624, #3626)."
+        ]
+      }
+    }
+  ],
   "smrtDependencies": [
     "@happyvertical/smrt-core",
-    "@happyvertical/smrt-tenancy"
+    "@happyvertical/smrt-tenancy",
+    "@happyvertical/smrt-users"
   ],
   "browser": {
     "status": "server-only",
     "issues": [
-      "#3624"
+      "#3617",
+      "#3624",
+      "#3626"
     ],
     "reason": "node:crypto",
     "via": [
-      "@happyvertical/smrt-tenancy"
+      "@happyvertical/smrt-profiles",
+      "@happyvertical/smrt-tenancy",
+      "@happyvertical/smrt-users"
     ]
   },
   "stampsConstructors": true