@happyvertical/smrt-timesheets 0.53.1 → 0.53.3

package/dist/smrt-knowledge.json

@@ -3,18 +3,21 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-timesheets",
-  "packageVersion": "0.53.1",
+  "packageVersion": "0.53.3",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "52dc7207ce4f40ef17360ef2956cb519741830f57b744640bc1a5c2084993164",
-    "packageJson": "3b966965edaa33570f9c7cc9015766eff72113decda22001c779f5c546e095bc",
-    "agents": "a6b055ef3df46c1dc653d96c8fc5983f223fbfcfd9a6b3c5be8382068c515096"
+    "manifest": "d61b7ce978a0467d489c8f87487cf7e2d6a7859e9f8d9824d6d204a3fb1a8dd1",
+    "packageJson": "a52a56bdab00ac2e1da8e3a8c02db1c97fd63869ec07db53eaba264845cf0c39",
+    "agents": "21421ad5f02335e4c994227122c13b881d10e9f9d55ae09c3ac8ffa4bc2a7e09",
+    "moduleDoc:agents/period-rollup.md": "0c28783f8911c20911a2c640e89f2190df886d86749b5b03219afea4c83ab75d"
   },
   "exports": [
     ".",
+    "./attendance",
     "./manifest",
     "./manifest.json",
+    "./rollup",
     "./svelte",
     "./ui"
   ],
@@ -23,8 +26,8 @@
     "@happyvertical/smrt-tenancy": "workspace:*",
     "@happyvertical/smrt-types": "workspace:*",
     "@happyvertical/smrt-ui": "workspace:*",
-    "@happyvertical/smrt-vitest": "workspace:*",
     "@happyvertical/sql": "catalog:",
+    "@happyvertical/smrt-vitest": "workspace:*",
     "@sveltejs/package": "^2.5.8",
     "@sveltejs/vite-plugin-svelte": "^7.3.0",
     "@types/node": "24.13.6",
@@ -54,97 +57,105 @@
     "timesheets"
   ],
   "risks": [
-    "cross-package-refs:4",
+    "cross-package-refs:9",
     "sensitive-fields-excluded"
   ],
   "objects": [
     {
-      "name": "ServiceChargeSnapshot",
-      "qualifiedName": "@happyvertical/smrt-timesheets:ServiceChargeSnapshot",
-      "previousQualifiedNames": [
-        "@happyvertical/smrt-projects:ServiceChargeSnapshot"
-      ],
-      "collection": "servicechargesnapshots",
-      "tableName": "service_charge_snapshots",
+      "name": "AttendancePunch",
+      "qualifiedName": "@happyvertical/smrt-timesheets:AttendancePunch",
+      "collection": "attendancepunches",
+      "tableName": "attendance_punches",
       "packageName": "@happyvertical/smrt-timesheets",
       "extends": "SmrtObject",
       "fields": [
         {
           "name": "tenantId",
           "type": "text",
-          "required": false,
+          "required": true,
           "columnType": "UUID"
         },
         {
-          "name": "timeEntryId",
-          "type": "foreignKey",
-          "required": true,
-          "related": "ServiceTimeEntry",
+          "name": "profileId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-profiles:Profile",
           "columnType": "UUID"
         },
         {
-          "name": "amount",
-          "type": "integer",
+          "name": "startedAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        },
+        {
+          "name": "endedAt",
+          "type": "datetime",
           "required": false,
+          "columnType": "TIMESTAMP"
+        },
+        {
+          "name": "durationSeconds",
+          "type": "integer",
+          "required": true,
           "columnType": "INTEGER",
           "default": 0
         },
         {
-          "name": "currency",
-          "type": "text",
-          "required": false,
-          "columnType": "TEXT"
+          "name": "unpaidBreakSeconds",
+          "type": "integer",
+          "required": true,
+          "columnType": "INTEGER",
+          "default": 0
         },
         {
-          "name": "pricingVersion",
-          "type": "text",
-          "required": false,
-          "columnType": "TEXT"
+          "name": "reviewRequired",
+          "type": "boolean",
+          "required": true,
+          "columnType": "BOOLEAN",
+          "default": false
         },
         {
-          "name": "strategy",
-          "type": "text",
-          "required": false,
-          "columnType": "TEXT"
+          "name": "recordedOffline",
+          "type": "boolean",
+          "required": true,
+          "columnType": "BOOLEAN",
+          "default": false
         },
         {
-          "name": "rateSnapshot",
-          "type": "text",
+          "name": "serviceTimeEntryId",
+          "type": "foreignKey",
           "required": false,
-          "columnType": "TEXT"
+          "related": "ServiceTimeEntry",
+          "columnType": "UUID"
         },
         {
-          "name": "sourceChargeRef",
+          "name": "openSlot",
           "type": "text",
-          "required": false,
+          "required": true,
           "columnType": "TEXT"
-        },
-        {
-          "name": "createdAt",
-          "type": "datetime",
-          "required": false,
-          "columnType": "TIMESTAMP"
         }
       ],
       "relationships": [
         {
-          "name": "timeEntryId",
+          "name": "profileId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "columnType": "UUID"
+        },
+        {
+          "name": "serviceTimeEntryId",
           "type": "foreignKey",
-          "required": true,
+          "required": false,
           "related": "ServiceTimeEntry",
           "columnType": "UUID"
         }
       ],
       "methods": [
-        "initialize",
         "save"
       ],
       "methodSignatures": [
-        {
-          "name": "initialize",
-          "async": true,
-          "returns": "Promise<this>"
-        },
         {
           "name": "save",
           "async": true,
@@ -153,71 +164,67 @@
       ],
       "tenant": {
         "scoped": true,
-        "mode": "optional",
+        "mode": "required",
         "field": "tenantId"
       },
       "conflictColumns": [
-        "time_entry_id"
+        "tenant_id",
+        "slug",
+        "context"
       ],
       "surfaces": [
         {
           "kind": "api",
-          "name": "servicechargesnapshots.list",
+          "name": "attendancepunches.list",
           "operation": "list",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceChargeSnapshot",
-          "path": "/servicechargesnapshots",
+          "objectName": "@happyvertical/smrt-timesheets:AttendancePunch",
+          "path": "/attendancepunches",
           "method": "GET"
         },
         {
           "kind": "api",
-          "name": "servicechargesnapshots.get",
+          "name": "attendancepunches.get",
           "operation": "get",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceChargeSnapshot",
-          "path": "/servicechargesnapshots/[id]",
+          "objectName": "@happyvertical/smrt-timesheets:AttendancePunch",
+          "path": "/attendancepunches/[id]",
           "method": "GET"
         },
         {
           "kind": "cli",
-          "name": "servicechargesnapshot_list",
+          "name": "attendancepunch_list",
           "operation": "list",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceChargeSnapshot"
+          "objectName": "@happyvertical/smrt-timesheets:AttendancePunch"
         },
         {
           "kind": "cli",
-          "name": "servicechargesnapshot_get",
+          "name": "attendancepunch_get",
           "operation": "get",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceChargeSnapshot"
+          "objectName": "@happyvertical/smrt-timesheets:AttendancePunch"
         },
         {
           "kind": "mcp",
-          "name": "servicechargesnapshot_list",
+          "name": "attendancepunch_list",
           "operation": "list",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceChargeSnapshot"
+          "objectName": "@happyvertical/smrt-timesheets:AttendancePunch"
         },
         {
           "kind": "mcp",
-          "name": "servicechargesnapshot_get",
+          "name": "attendancepunch_get",
           "operation": "get",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceChargeSnapshot"
+          "objectName": "@happyvertical/smrt-timesheets:AttendancePunch"
         }
       ],
       "withheldSurfaces": [
-        {
-          "kind": "api",
-          "operation": "initialize",
-          "code": "lifecycle-method",
-          "reason": "`initialize` is a framework lifecycle method, not a distinct operation",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceChargeSnapshot"
-        },
         {
           "kind": "api",
           "operation": "save",
           "code": "lifecycle-method",
           "reason": "`save` is a framework lifecycle method, not a distinct operation",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceChargeSnapshot"
+          "objectName": "@happyvertical/smrt-timesheets:AttendancePunch"
         }
       ],
       "relationshipFeatures": [
+        "crossPackageRef",
         "foreignKey",
         "uuidColumns"
       ],
@@ -225,80 +232,65 @@
       "risks": []
     },
     {
-      "name": "ServiceCompensationSnapshot",
-      "qualifiedName": "@happyvertical/smrt-timesheets:ServiceCompensationSnapshot",
-      "previousQualifiedNames": [
-        "@happyvertical/smrt-projects:ServiceCompensationSnapshot"
-      ],
-      "collection": "servicecompensationsnapshots",
-      "tableName": "service_compensation_snapshots",
+      "name": "AttendanceBreak",
+      "qualifiedName": "@happyvertical/smrt-timesheets:AttendanceBreak",
+      "collection": "attendancebreaks",
+      "tableName": "attendance_breaks",
       "packageName": "@happyvertical/smrt-timesheets",
       "extends": "SmrtObject",
       "fields": [
         {
           "name": "tenantId",
           "type": "text",
-          "required": false,
+          "required": true,
           "columnType": "UUID"
         },
         {
-          "name": "timeEntryId",
+          "name": "punchId",
           "type": "foreignKey",
-          "required": true,
-          "related": "ServiceTimeEntry",
+          "required": false,
+          "related": "AttendancePunch",
           "columnType": "UUID"
         },
         {
-          "name": "amount",
-          "type": "integer",
+          "name": "startedAt",
+          "type": "datetime",
           "required": false,
-          "columnType": "INTEGER",
-          "default": 0
+          "columnType": "TIMESTAMP"
         },
         {
-          "name": "currency",
-          "type": "text",
+          "name": "endedAt",
+          "type": "datetime",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TIMESTAMP"
         },
         {
-          "name": "termsVersion",
-          "type": "text",
-          "required": false,
-          "columnType": "TEXT"
+          "name": "paid",
+          "type": "boolean",
+          "required": true,
+          "columnType": "BOOLEAN",
+          "default": false
         },
         {
-          "name": "rateSnapshot",
+          "name": "openSlot",
           "type": "text",
-          "required": false,
+          "required": true,
           "columnType": "TEXT"
-        },
-        {
-          "name": "createdAt",
-          "type": "datetime",
-          "required": false,
-          "columnType": "TIMESTAMP"
         }
       ],
       "relationships": [
         {
-          "name": "timeEntryId",
+          "name": "punchId",
           "type": "foreignKey",
-          "required": true,
-          "related": "ServiceTimeEntry",
+          "required": false,
+          "related": "AttendancePunch",
           "columnType": "UUID"
         }
       ],
       "methods": [
-        "initialize",
         "save"
       ],
       "methodSignatures": [
-        {
-          "name": "initialize",
-          "async": true,
-          "returns": "Promise<this>"
-        },
         {
           "name": "save",
           "async": true,
@@ -307,68 +299,63 @@
       ],
       "tenant": {
         "scoped": true,
-        "mode": "optional",
+        "mode": "required",
         "field": "tenantId"
       },
       "conflictColumns": [
-        "time_entry_id"
+        "tenant_id",
+        "slug",
+        "context"
       ],
       "surfaces": [
         {
           "kind": "api",
-          "name": "servicecompensationsnapshots.list",
+          "name": "attendancebreaks.list",
           "operation": "list",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceCompensationSnapshot",
-          "path": "/servicecompensationsnapshots",
+          "objectName": "@happyvertical/smrt-timesheets:AttendanceBreak",
+          "path": "/attendancebreaks",
           "method": "GET"
         },
         {
           "kind": "api",
-          "name": "servicecompensationsnapshots.get",
+          "name": "attendancebreaks.get",
           "operation": "get",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceCompensationSnapshot",
-          "path": "/servicecompensationsnapshots/[id]",
+          "objectName": "@happyvertical/smrt-timesheets:AttendanceBreak",
+          "path": "/attendancebreaks/[id]",
           "method": "GET"
         },
         {
           "kind": "cli",
-          "name": "servicecompensationsnapshot_list",
+          "name": "attendancebreak_list",
           "operation": "list",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceCompensationSnapshot"
+          "objectName": "@happyvertical/smrt-timesheets:AttendanceBreak"
         },
         {
           "kind": "cli",
-          "name": "servicecompensationsnapshot_get",
+          "name": "attendancebreak_get",
           "operation": "get",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceCompensationSnapshot"
+          "objectName": "@happyvertical/smrt-timesheets:AttendanceBreak"
         },
         {
           "kind": "mcp",
-          "name": "servicecompensationsnapshot_list",
+          "name": "attendancebreak_list",
           "operation": "list",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceCompensationSnapshot"
+          "objectName": "@happyvertical/smrt-timesheets:AttendanceBreak"
         },
         {
           "kind": "mcp",
-          "name": "servicecompensationsnapshot_get",
+          "name": "attendancebreak_get",
           "operation": "get",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceCompensationSnapshot"
+          "objectName": "@happyvertical/smrt-timesheets:AttendanceBreak"
         }
       ],
       "withheldSurfaces": [
-        {
-          "kind": "api",
-          "operation": "initialize",
-          "code": "lifecycle-method",
-          "reason": "`initialize` is a framework lifecycle method, not a distinct operation",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceCompensationSnapshot"
-        },
         {
           "kind": "api",
           "operation": "save",
           "code": "lifecycle-method",
           "reason": "`save` is a framework lifecycle method, not a distinct operation",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceCompensationSnapshot"
+          "objectName": "@happyvertical/smrt-timesheets:AttendanceBreak"
         }
       ],
       "relationshipFeatures": [
@@ -379,124 +366,1013 @@
       "risks": []
     },
     {
-      "name": "ServiceChargeSnapshotCollection",
-      "qualifiedName": "@happyvertical/smrt-timesheets:ServiceChargeSnapshotCollection",
-      "collection": "servicechargesnapshots",
-      "tableName": "service_charge_snapshots",
-      "packageName": "@happyvertical/smrt-timesheets",
-      "extends": "SmrtCollection",
-      "fields": [],
-      "relationships": [],
-      "methods": [],
-      "surfaces": [],
-      "relationshipFeatures": [
-        "uuidColumns"
-      ],
-      "tags": [],
-      "risks": []
-    },
-    {
-      "name": "ServiceCompensationSnapshotCollection",
-      "qualifiedName": "@happyvertical/smrt-timesheets:ServiceCompensationSnapshotCollection",
-      "collection": "servicecompensationsnapshots",
-      "tableName": "service_compensation_snapshots",
-      "packageName": "@happyvertical/smrt-timesheets",
-      "extends": "SmrtCollection",
-      "fields": [],
-      "relationships": [],
-      "methods": [],
-      "surfaces": [],
-      "relationshipFeatures": [
-        "uuidColumns"
-      ],
-      "tags": [],
-      "risks": []
-    },
-    {
-      "name": "ServiceTimeEntry",
-      "qualifiedName": "@happyvertical/smrt-timesheets:ServiceTimeEntry",
-      "previousQualifiedNames": [
-        "@happyvertical/smrt-projects:ServiceTimeEntry"
-      ],
-      "collection": "servicetimeentries",
-      "tableName": "service_time_entries",
+      "name": "AttendanceReplay",
+      "qualifiedName": "@happyvertical/smrt-timesheets:AttendanceReplay",
+      "collection": "attendancereplays",
+      "tableName": "attendance_replays",
       "packageName": "@happyvertical/smrt-timesheets",
       "extends": "SmrtObject",
       "fields": [
         {
           "name": "tenantId",
           "type": "text",
-          "required": false,
+          "required": true,
           "columnType": "UUID"
         },
         {
-          "name": "workRefType",
+          "name": "replayKey",
           "type": "text",
-          "required": false,
+          "required": true,
           "columnType": "TEXT"
         },
         {
-          "name": "workRefId",
+          "name": "content",
           "type": "text",
           "required": false,
           "columnType": "TEXT"
         },
         {
-          "name": "participantKind",
+          "name": "outcome",
           "type": "text",
           "required": false,
           "columnType": "TEXT"
-        },
+        }
+      ],
+      "relationships": [],
+      "methods": [
+        "getOutcome",
+        "save",
+        "setOutcome"
+      ],
+      "methodSignatures": [
         {
-          "name": "participantProfileId",
-          "type": "crossPackageRef",
-          "required": false,
-          "related": "@happyvertical/smrt-profiles:Profile",
-          "columnType": "UUID"
+          "name": "getOutcome",
+          "returns": "AttendanceReplayOutcome"
         },
         {
-          "name": "agentRef",
-          "type": "text",
-          "required": false,
-          "columnType": "TEXT"
+          "name": "save",
+          "async": true,
+          "returns": "Promise<this>"
         },
         {
-          "name": "source",
+          "name": "setOutcome",
+          "params": [
+            "value: AttendanceReplayOutcome"
+          ],
+          "returns": "void"
+        }
+      ],
+      "tenant": {
+        "scoped": true,
+        "mode": "required",
+        "field": "tenantId"
+      },
+      "conflictColumns": [
+        "tenant_id",
+        "slug",
+        "context"
+      ],
+      "surfaces": [],
+      "withheldSurfaces": [
+        {
+          "kind": "api",
+          "operation": "getOutcome",
+          "code": "not-included",
+          "reason": "not listed in api.include",
+          "objectName": "@happyvertical/smrt-timesheets:AttendanceReplay"
+        },
+        {
+          "kind": "api",
+          "operation": "save",
+          "code": "lifecycle-method",
+          "reason": "`save` is a framework lifecycle method, not a distinct operation",
+          "objectName": "@happyvertical/smrt-timesheets:AttendanceReplay"
+        },
+        {
+          "kind": "api",
+          "operation": "setOutcome",
+          "code": "not-included",
+          "reason": "not listed in api.include",
+          "objectName": "@happyvertical/smrt-timesheets:AttendanceReplay"
+        }
+      ],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "AttendancePunchCollection",
+      "qualifiedName": "@happyvertical/smrt-timesheets:AttendancePunchCollection",
+      "collection": "attendancepunches",
+      "tableName": "attendance_punches",
+      "packageName": "@happyvertical/smrt-timesheets",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "AttendanceBreakCollection",
+      "qualifiedName": "@happyvertical/smrt-timesheets:AttendanceBreakCollection",
+      "collection": "attendancebreaks",
+      "tableName": "attendance_breaks",
+      "packageName": "@happyvertical/smrt-timesheets",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "AttendanceReplayCollection",
+      "qualifiedName": "@happyvertical/smrt-timesheets:AttendanceReplayCollection",
+      "collection": "attendancereplays",
+      "tableName": "attendance_replays",
+      "packageName": "@happyvertical/smrt-timesheets",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "ServiceChargeSnapshot",
+      "qualifiedName": "@happyvertical/smrt-timesheets:ServiceChargeSnapshot",
+      "previousQualifiedNames": [
+        "@happyvertical/smrt-projects:ServiceChargeSnapshot"
+      ],
+      "collection": "servicechargesnapshots",
+      "tableName": "service_charge_snapshots",
+      "packageName": "@happyvertical/smrt-timesheets",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "tenantId",
+          "type": "text",
+          "required": false,
+          "columnType": "UUID"
+        },
+        {
+          "name": "timeEntryId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "ServiceTimeEntry",
+          "columnType": "UUID"
+        },
+        {
+          "name": "amount",
+          "type": "integer",
+          "required": false,
+          "columnType": "INTEGER",
+          "default": 0
+        },
+        {
+          "name": "currency",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "pricingVersion",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "strategy",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "rateSnapshot",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "sourceChargeRef",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "createdAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        }
+      ],
+      "relationships": [
+        {
+          "name": "timeEntryId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "ServiceTimeEntry",
+          "columnType": "UUID"
+        }
+      ],
+      "methods": [
+        "initialize",
+        "save"
+      ],
+      "methodSignatures": [
+        {
+          "name": "initialize",
+          "async": true,
+          "returns": "Promise<this>"
+        },
+        {
+          "name": "save",
+          "async": true,
+          "returns": "Promise<this>"
+        }
+      ],
+      "tenant": {
+        "scoped": true,
+        "mode": "optional",
+        "field": "tenantId"
+      },
+      "conflictColumns": [
+        "time_entry_id"
+      ],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "servicechargesnapshots.list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceChargeSnapshot",
+          "path": "/servicechargesnapshots",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "servicechargesnapshots.get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceChargeSnapshot",
+          "path": "/servicechargesnapshots/[id]",
+          "method": "GET"
+        },
+        {
+          "kind": "cli",
+          "name": "servicechargesnapshot_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceChargeSnapshot"
+        },
+        {
+          "kind": "cli",
+          "name": "servicechargesnapshot_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceChargeSnapshot"
+        },
+        {
+          "kind": "mcp",
+          "name": "servicechargesnapshot_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceChargeSnapshot"
+        },
+        {
+          "kind": "mcp",
+          "name": "servicechargesnapshot_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceChargeSnapshot"
+        }
+      ],
+      "withheldSurfaces": [
+        {
+          "kind": "api",
+          "operation": "initialize",
+          "code": "lifecycle-method",
+          "reason": "`initialize` is a framework lifecycle method, not a distinct operation",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceChargeSnapshot"
+        },
+        {
+          "kind": "api",
+          "operation": "save",
+          "code": "lifecycle-method",
+          "reason": "`save` is a framework lifecycle method, not a distinct operation",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceChargeSnapshot"
+        }
+      ],
+      "relationshipFeatures": [
+        "foreignKey",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "ServiceCompensationSnapshot",
+      "qualifiedName": "@happyvertical/smrt-timesheets:ServiceCompensationSnapshot",
+      "previousQualifiedNames": [
+        "@happyvertical/smrt-projects:ServiceCompensationSnapshot"
+      ],
+      "collection": "servicecompensationsnapshots",
+      "tableName": "service_compensation_snapshots",
+      "packageName": "@happyvertical/smrt-timesheets",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "tenantId",
+          "type": "text",
+          "required": false,
+          "columnType": "UUID"
+        },
+        {
+          "name": "timeEntryId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "ServiceTimeEntry",
+          "columnType": "UUID"
+        },
+        {
+          "name": "amount",
+          "type": "integer",
+          "required": false,
+          "columnType": "INTEGER",
+          "default": 0
+        },
+        {
+          "name": "currency",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "termsVersion",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "rateSnapshot",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "createdAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        }
+      ],
+      "relationships": [
+        {
+          "name": "timeEntryId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "ServiceTimeEntry",
+          "columnType": "UUID"
+        }
+      ],
+      "methods": [
+        "initialize",
+        "save"
+      ],
+      "methodSignatures": [
+        {
+          "name": "initialize",
+          "async": true,
+          "returns": "Promise<this>"
+        },
+        {
+          "name": "save",
+          "async": true,
+          "returns": "Promise<this>"
+        }
+      ],
+      "tenant": {
+        "scoped": true,
+        "mode": "optional",
+        "field": "tenantId"
+      },
+      "conflictColumns": [
+        "time_entry_id"
+      ],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "servicecompensationsnapshots.list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceCompensationSnapshot",
+          "path": "/servicecompensationsnapshots",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "servicecompensationsnapshots.get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceCompensationSnapshot",
+          "path": "/servicecompensationsnapshots/[id]",
+          "method": "GET"
+        },
+        {
+          "kind": "cli",
+          "name": "servicecompensationsnapshot_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceCompensationSnapshot"
+        },
+        {
+          "kind": "cli",
+          "name": "servicecompensationsnapshot_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceCompensationSnapshot"
+        },
+        {
+          "kind": "mcp",
+          "name": "servicecompensationsnapshot_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceCompensationSnapshot"
+        },
+        {
+          "kind": "mcp",
+          "name": "servicecompensationsnapshot_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceCompensationSnapshot"
+        }
+      ],
+      "withheldSurfaces": [
+        {
+          "kind": "api",
+          "operation": "initialize",
+          "code": "lifecycle-method",
+          "reason": "`initialize` is a framework lifecycle method, not a distinct operation",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceCompensationSnapshot"
+        },
+        {
+          "kind": "api",
+          "operation": "save",
+          "code": "lifecycle-method",
+          "reason": "`save` is a framework lifecycle method, not a distinct operation",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceCompensationSnapshot"
+        }
+      ],
+      "relationshipFeatures": [
+        "foreignKey",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "ServiceChargeSnapshotCollection",
+      "qualifiedName": "@happyvertical/smrt-timesheets:ServiceChargeSnapshotCollection",
+      "collection": "servicechargesnapshots",
+      "tableName": "service_charge_snapshots",
+      "packageName": "@happyvertical/smrt-timesheets",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "ServiceCompensationSnapshotCollection",
+      "qualifiedName": "@happyvertical/smrt-timesheets:ServiceCompensationSnapshotCollection",
+      "collection": "servicecompensationsnapshots",
+      "tableName": "service_compensation_snapshots",
+      "packageName": "@happyvertical/smrt-timesheets",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "ServiceTimeEntry",
+      "qualifiedName": "@happyvertical/smrt-timesheets:ServiceTimeEntry",
+      "previousQualifiedNames": [
+        "@happyvertical/smrt-projects:ServiceTimeEntry"
+      ],
+      "collection": "servicetimeentries",
+      "tableName": "service_time_entries",
+      "packageName": "@happyvertical/smrt-timesheets",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "tenantId",
+          "type": "text",
+          "required": false,
+          "columnType": "UUID"
+        },
+        {
+          "name": "workRefType",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "workRefId",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "participantKind",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "participantProfileId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "columnType": "UUID"
+        },
+        {
+          "name": "agentRef",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "source",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "description",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "startedAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        },
+        {
+          "name": "endedAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        },
+        {
+          "name": "durationSeconds",
+          "type": "integer",
+          "required": false,
+          "columnType": "INTEGER",
+          "default": 0
+        },
+        {
+          "name": "evidence",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "status",
           "type": "text",
           "required": false,
           "columnType": "TEXT"
         },
         {
-          "name": "description",
+          "name": "submittedAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        },
+        {
+          "name": "submittedByProfileId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "columnType": "UUID"
+        },
+        {
+          "name": "approvedAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        },
+        {
+          "name": "approvedByProfileId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "columnType": "UUID"
+        },
+        {
+          "name": "approvalPath",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "rejectedAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        },
+        {
+          "name": "rejectedByProfileId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "columnType": "UUID"
+        },
+        {
+          "name": "rejectionReason",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "correctionOfId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "ServiceTimeEntry",
+          "columnType": "UUID"
+        },
+        {
+          "name": "metadata",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        }
+      ],
+      "relationships": [
+        {
+          "name": "participantProfileId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "columnType": "UUID"
+        },
+        {
+          "name": "submittedByProfileId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "columnType": "UUID"
+        },
+        {
+          "name": "approvedByProfileId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "columnType": "UUID"
+        },
+        {
+          "name": "rejectedByProfileId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "columnType": "UUID"
+        },
+        {
+          "name": "correctionOfId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "ServiceTimeEntry",
+          "columnType": "UUID"
+        }
+      ],
+      "methods": [
+        "durationHours",
+        "getEvidence",
+        "getMetadata",
+        "initialize",
+        "save",
+        "setEvidence",
+        "setMetadata"
+      ],
+      "methodSignatures": [
+        {
+          "name": "durationHours",
+          "returns": "number"
+        },
+        {
+          "name": "getEvidence",
+          "returns": "ServiceEvidence[]"
+        },
+        {
+          "name": "getMetadata",
+          "returns": "Record<string, unknown>"
+        },
+        {
+          "name": "initialize",
+          "async": true,
+          "returns": "Promise<this>"
+        },
+        {
+          "name": "save",
+          "async": true,
+          "returns": "Promise<this>"
+        },
+        {
+          "name": "setEvidence",
+          "params": [
+            "value: ServiceEvidence[]"
+          ],
+          "returns": "void"
+        },
+        {
+          "name": "setMetadata",
+          "params": [
+            "value: Record<string, unknown>"
+          ],
+          "returns": "void"
+        }
+      ],
+      "tenant": {
+        "scoped": true,
+        "mode": "optional",
+        "field": "tenantId"
+      },
+      "conflictColumns": [
+        "tenant_id",
+        "slug",
+        "context"
+      ],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "servicetimeentries.list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry",
+          "path": "/servicetimeentries",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "servicetimeentries.get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry",
+          "path": "/servicetimeentries/[id]",
+          "method": "GET"
+        },
+        {
+          "kind": "cli",
+          "name": "servicetimeentry_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry"
+        },
+        {
+          "kind": "cli",
+          "name": "servicetimeentry_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry"
+        },
+        {
+          "kind": "mcp",
+          "name": "servicetimeentry_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry"
+        },
+        {
+          "kind": "mcp",
+          "name": "servicetimeentry_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry"
+        }
+      ],
+      "withheldSurfaces": [
+        {
+          "kind": "api",
+          "operation": "durationHours",
+          "code": "not-included",
+          "reason": "not listed in api.include",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry"
+        },
+        {
+          "kind": "api",
+          "operation": "getEvidence",
+          "code": "not-included",
+          "reason": "not listed in api.include",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry"
+        },
+        {
+          "kind": "api",
+          "operation": "getMetadata",
+          "code": "not-included",
+          "reason": "not listed in api.include",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry"
+        },
+        {
+          "kind": "api",
+          "operation": "initialize",
+          "code": "lifecycle-method",
+          "reason": "`initialize` is a framework lifecycle method, not a distinct operation",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry"
+        },
+        {
+          "kind": "api",
+          "operation": "save",
+          "code": "lifecycle-method",
+          "reason": "`save` is a framework lifecycle method, not a distinct operation",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry"
+        },
+        {
+          "kind": "api",
+          "operation": "setEvidence",
+          "code": "not-included",
+          "reason": "not listed in api.include",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry"
+        },
+        {
+          "kind": "api",
+          "operation": "setMetadata",
+          "code": "not-included",
+          "reason": "not listed in api.include",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry"
+        }
+      ],
+      "relationshipFeatures": [
+        "crossPackageRef",
+        "foreignKey",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "ServiceTimeEntryCollection",
+      "qualifiedName": "@happyvertical/smrt-timesheets:ServiceTimeEntryCollection",
+      "collection": "servicetimeentries",
+      "tableName": "service_time_entries",
+      "packageName": "@happyvertical/smrt-timesheets",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "forWork",
+        "pendingApproval"
+      ],
+      "methodSignatures": [
+        {
+          "name": "forWork",
+          "async": true,
+          "params": [
+            "workRefType: string",
+            "workRefId: string"
+          ],
+          "returns": "Promise<ServiceTimeEntry[]>"
+        },
+        {
+          "name": "pendingApproval",
+          "async": true,
+          "returns": "Promise<ServiceTimeEntry[]>"
+        }
+      ],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "servicetimeentries.forWork",
+          "operation": "forWork",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntryCollection",
+          "path": "/servicetimeentries/forWork",
+          "method": "POST"
+        },
+        {
+          "kind": "api",
+          "name": "servicetimeentries.pendingApproval",
+          "operation": "pendingApproval",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntryCollection",
+          "path": "/servicetimeentries/pendingApproval",
+          "method": "POST"
+        },
+        {
+          "kind": "cli",
+          "name": "servicetimeentrycollection_forWork",
+          "operation": "forWork",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntryCollection"
+        },
+        {
+          "kind": "cli",
+          "name": "servicetimeentrycollection_pendingApproval",
+          "operation": "pendingApproval",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntryCollection"
+        },
+        {
+          "kind": "mcp",
+          "name": "servicetimeentrycollection_forwork",
+          "operation": "forWork",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntryCollection"
+        },
+        {
+          "kind": "mcp",
+          "name": "servicetimeentrycollection_pendingapproval",
+          "operation": "pendingApproval",
+          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntryCollection"
+        }
+      ],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "PeriodTimecard",
+      "qualifiedName": "@happyvertical/smrt-timesheets:PeriodTimecard",
+      "collection": "periodtimecards",
+      "tableName": "period_timecards",
+      "packageName": "@happyvertical/smrt-timesheets",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "tenantId",
           "type": "text",
+          "required": true,
+          "columnType": "UUID"
+        },
+        {
+          "name": "profileId",
+          "type": "crossPackageRef",
           "required": false,
-          "columnType": "TEXT"
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "columnType": "UUID"
         },
         {
-          "name": "startedAt",
+          "name": "startsAt",
           "type": "datetime",
           "required": false,
           "columnType": "TIMESTAMP"
         },
         {
-          "name": "endedAt",
+          "name": "endsAt",
           "type": "datetime",
           "required": false,
           "columnType": "TIMESTAMP"
         },
         {
-          "name": "durationSeconds",
-          "type": "integer",
+          "name": "timezone",
+          "type": "text",
           "required": false,
-          "columnType": "INTEGER",
-          "default": 0
+          "columnType": "TEXT"
         },
         {
-          "name": "evidence",
+          "name": "rulesVersion",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "rulesSnapshot",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "sourceSnapshot",
           "type": "text",
           "required": false,
           "columnType": "TEXT"
         },
+        {
+          "name": "regularSeconds",
+          "type": "integer",
+          "required": true,
+          "columnType": "INTEGER",
+          "default": 0
+        },
+        {
+          "name": "overtimeSeconds",
+          "type": "integer",
+          "required": true,
+          "columnType": "INTEGER",
+          "default": 0
+        },
+        {
+          "name": "totalSeconds",
+          "type": "integer",
+          "required": true,
+          "columnType": "INTEGER",
+          "default": 0
+        },
         {
           "name": "status",
           "type": "text",
@@ -504,65 +1380,159 @@
           "columnType": "TEXT"
         },
         {
-          "name": "submittedAt",
+          "name": "confirmedAt",
           "type": "datetime",
           "required": false,
           "columnType": "TIMESTAMP"
         },
         {
-          "name": "submittedByProfileId",
+          "name": "confirmedByProfileId",
           "type": "crossPackageRef",
           "required": false,
           "related": "@happyvertical/smrt-profiles:Profile",
           "columnType": "UUID"
-        },
+        }
+      ],
+      "relationships": [
         {
-          "name": "approvedAt",
-          "type": "datetime",
+          "name": "profileId",
+          "type": "crossPackageRef",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "columnType": "UUID"
         },
         {
-          "name": "approvedByProfileId",
+          "name": "confirmedByProfileId",
           "type": "crossPackageRef",
           "required": false,
           "related": "@happyvertical/smrt-profiles:Profile",
           "columnType": "UUID"
+        }
+      ],
+      "methods": [
+        "delete",
+        "getRules",
+        "getSources",
+        "save"
+      ],
+      "methodSignatures": [
+        {
+          "name": "delete",
+          "async": true,
+          "returns": "Promise<void>"
         },
         {
-          "name": "approvalPath",
+          "name": "getRules",
+          "returns": "Record<string, unknown>"
+        },
+        {
+          "name": "getSources",
+          "returns": "TimecardSource[]"
+        },
+        {
+          "name": "save",
+          "async": true,
+          "returns": "Promise<this>"
+        }
+      ],
+      "tenant": {
+        "scoped": true,
+        "mode": "required",
+        "field": "tenantId"
+      },
+      "conflictColumns": [
+        "tenant_id",
+        "slug",
+        "context"
+      ],
+      "surfaces": [],
+      "withheldSurfaces": [
+        {
+          "kind": "api",
+          "operation": "getRules",
+          "code": "not-included",
+          "reason": "not listed in api.include",
+          "objectName": "@happyvertical/smrt-timesheets:PeriodTimecard"
+        },
+        {
+          "kind": "api",
+          "operation": "getSources",
+          "code": "not-included",
+          "reason": "not listed in api.include",
+          "objectName": "@happyvertical/smrt-timesheets:PeriodTimecard"
+        },
+        {
+          "kind": "api",
+          "operation": "save",
+          "code": "lifecycle-method",
+          "reason": "`save` is a framework lifecycle method, not a distinct operation",
+          "objectName": "@happyvertical/smrt-timesheets:PeriodTimecard"
+        }
+      ],
+      "relationshipFeatures": [
+        "crossPackageRef",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "TimecardAdjustment",
+      "qualifiedName": "@happyvertical/smrt-timesheets:TimecardAdjustment",
+      "collection": "timecardadjustments",
+      "tableName": "timecard_adjustments",
+      "packageName": "@happyvertical/smrt-timesheets",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "tenantId",
           "type": "text",
+          "required": true,
+          "columnType": "UUID"
+        },
+        {
+          "name": "timecardId",
+          "type": "foreignKey",
           "required": false,
-          "columnType": "TEXT"
+          "related": "PeriodTimecard",
+          "columnType": "UUID"
         },
         {
-          "name": "rejectedAt",
-          "type": "datetime",
+          "name": "profileId",
+          "type": "crossPackageRef",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "columnType": "UUID"
         },
         {
-          "name": "rejectedByProfileId",
+          "name": "actorProfileId",
           "type": "crossPackageRef",
           "required": false,
           "related": "@happyvertical/smrt-profiles:Profile",
           "columnType": "UUID"
         },
         {
-          "name": "rejectionReason",
+          "name": "operationId",
           "type": "text",
           "required": false,
           "columnType": "TEXT"
         },
         {
-          "name": "correctionOfId",
-          "type": "foreignKey",
-          "required": false,
-          "related": "ServiceTimeEntry",
-          "columnType": "UUID"
+          "name": "regularSeconds",
+          "type": "integer",
+          "required": true,
+          "columnType": "INTEGER",
+          "default": 0
         },
         {
-          "name": "metadata",
+          "name": "overtimeSeconds",
+          "type": "integer",
+          "required": true,
+          "columnType": "INTEGER",
+          "default": 0
+        },
+        {
+          "name": "reason",
           "type": "text",
           "required": false,
           "columnType": "TEXT"
@@ -570,91 +1540,46 @@
       ],
       "relationships": [
         {
-          "name": "participantProfileId",
-          "type": "crossPackageRef",
-          "required": false,
-          "related": "@happyvertical/smrt-profiles:Profile",
-          "columnType": "UUID"
-        },
-        {
-          "name": "submittedByProfileId",
-          "type": "crossPackageRef",
+          "name": "timecardId",
+          "type": "foreignKey",
           "required": false,
-          "related": "@happyvertical/smrt-profiles:Profile",
+          "related": "PeriodTimecard",
           "columnType": "UUID"
         },
         {
-          "name": "approvedByProfileId",
+          "name": "profileId",
           "type": "crossPackageRef",
           "required": false,
           "related": "@happyvertical/smrt-profiles:Profile",
           "columnType": "UUID"
         },
         {
-          "name": "rejectedByProfileId",
+          "name": "actorProfileId",
           "type": "crossPackageRef",
           "required": false,
           "related": "@happyvertical/smrt-profiles:Profile",
           "columnType": "UUID"
-        },
-        {
-          "name": "correctionOfId",
-          "type": "foreignKey",
-          "required": false,
-          "related": "ServiceTimeEntry",
-          "columnType": "UUID"
         }
       ],
       "methods": [
-        "durationHours",
-        "getEvidence",
-        "getMetadata",
-        "initialize",
-        "save",
-        "setEvidence",
-        "setMetadata"
+        "delete",
+        "save"
       ],
       "methodSignatures": [
         {
-          "name": "durationHours",
-          "returns": "number"
-        },
-        {
-          "name": "getEvidence",
-          "returns": "ServiceEvidence[]"
-        },
-        {
-          "name": "getMetadata",
-          "returns": "Record<string, unknown>"
-        },
-        {
-          "name": "initialize",
+          "name": "delete",
           "async": true,
-          "returns": "Promise<this>"
+          "returns": "Promise<void>"
         },
         {
           "name": "save",
           "async": true,
           "returns": "Promise<this>"
-        },
-        {
-          "name": "setEvidence",
-          "params": [
-            "value: ServiceEvidence[]"
-          ],
-          "returns": "void"
-        },
-        {
-          "name": "setMetadata",
-          "params": [
-            "value: Record<string, unknown>"
-          ],
-          "returns": "void"
         }
       ],
       "tenant": {
         "scoped": true,
-        "mode": "optional",
+        "mode": "required",
         "field": "tenantId"
       },
       "conflictColumns": [
@@ -662,97 +1587,14 @@
         "slug",
         "context"
       ],
-      "surfaces": [
-        {
-          "kind": "api",
-          "name": "servicetimeentries.list",
-          "operation": "list",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry",
-          "path": "/servicetimeentries",
-          "method": "GET"
-        },
-        {
-          "kind": "api",
-          "name": "servicetimeentries.get",
-          "operation": "get",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry",
-          "path": "/servicetimeentries/[id]",
-          "method": "GET"
-        },
-        {
-          "kind": "cli",
-          "name": "servicetimeentry_list",
-          "operation": "list",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry"
-        },
-        {
-          "kind": "cli",
-          "name": "servicetimeentry_get",
-          "operation": "get",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry"
-        },
-        {
-          "kind": "mcp",
-          "name": "servicetimeentry_list",
-          "operation": "list",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry"
-        },
-        {
-          "kind": "mcp",
-          "name": "servicetimeentry_get",
-          "operation": "get",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry"
-        }
-      ],
+      "surfaces": [],
       "withheldSurfaces": [
-        {
-          "kind": "api",
-          "operation": "durationHours",
-          "code": "not-included",
-          "reason": "not listed in api.include",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry"
-        },
-        {
-          "kind": "api",
-          "operation": "getEvidence",
-          "code": "not-included",
-          "reason": "not listed in api.include",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry"
-        },
-        {
-          "kind": "api",
-          "operation": "getMetadata",
-          "code": "not-included",
-          "reason": "not listed in api.include",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry"
-        },
-        {
-          "kind": "api",
-          "operation": "initialize",
-          "code": "lifecycle-method",
-          "reason": "`initialize` is a framework lifecycle method, not a distinct operation",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry"
-        },
         {
           "kind": "api",
           "operation": "save",
           "code": "lifecycle-method",
           "reason": "`save` is a framework lifecycle method, not a distinct operation",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry"
-        },
-        {
-          "kind": "api",
-          "operation": "setEvidence",
-          "code": "not-included",
-          "reason": "not listed in api.include",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry"
-        },
-        {
-          "kind": "api",
-          "operation": "setMetadata",
-          "code": "not-included",
-          "reason": "not listed in api.include",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntry"
+          "objectName": "@happyvertical/smrt-timesheets:TimecardAdjustment"
         }
       ],
       "relationshipFeatures": [
@@ -764,76 +1606,33 @@
       "risks": []
     },
     {
-      "name": "ServiceTimeEntryCollection",
-      "qualifiedName": "@happyvertical/smrt-timesheets:ServiceTimeEntryCollection",
-      "collection": "servicetimeentries",
-      "tableName": "service_time_entries",
+      "name": "PeriodTimecardCollection",
+      "qualifiedName": "@happyvertical/smrt-timesheets:PeriodTimecardCollection",
+      "collection": "periodtimecards",
+      "tableName": "period_timecards",
       "packageName": "@happyvertical/smrt-timesheets",
       "extends": "SmrtCollection",
       "fields": [],
       "relationships": [],
-      "methods": [
-        "forWork",
-        "pendingApproval"
-      ],
-      "methodSignatures": [
-        {
-          "name": "forWork",
-          "async": true,
-          "params": [
-            "workRefType: string",
-            "workRefId: string"
-          ],
-          "returns": "Promise<ServiceTimeEntry[]>"
-        },
-        {
-          "name": "pendingApproval",
-          "async": true,
-          "returns": "Promise<ServiceTimeEntry[]>"
-        }
-      ],
-      "surfaces": [
-        {
-          "kind": "api",
-          "name": "servicetimeentries.forWork",
-          "operation": "forWork",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntryCollection",
-          "path": "/servicetimeentries/forWork",
-          "method": "POST"
-        },
-        {
-          "kind": "api",
-          "name": "servicetimeentries.pendingApproval",
-          "operation": "pendingApproval",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntryCollection",
-          "path": "/servicetimeentries/pendingApproval",
-          "method": "POST"
-        },
-        {
-          "kind": "cli",
-          "name": "servicetimeentrycollection_forWork",
-          "operation": "forWork",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntryCollection"
-        },
-        {
-          "kind": "cli",
-          "name": "servicetimeentrycollection_pendingApproval",
-          "operation": "pendingApproval",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntryCollection"
-        },
-        {
-          "kind": "mcp",
-          "name": "servicetimeentrycollection_forwork",
-          "operation": "forWork",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntryCollection"
-        },
-        {
-          "kind": "mcp",
-          "name": "servicetimeentrycollection_pendingapproval",
-          "operation": "pendingApproval",
-          "objectName": "@happyvertical/smrt-timesheets:ServiceTimeEntryCollection"
-        }
+      "methods": [],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
       ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "TimecardAdjustmentCollection",
+      "qualifiedName": "@happyvertical/smrt-timesheets:TimecardAdjustmentCollection",
+      "collection": "timecardadjustments",
+      "tableName": "timecard_adjustments",
+      "packageName": "@happyvertical/smrt-timesheets",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [],
+      "surfaces": [],
       "relationshipFeatures": [
         "uuidColumns"
       ],
@@ -842,6 +1641,86 @@
     }
   ],
   "surfaces": [
+    {
+      "kind": "api",
+      "name": "attendancepunches.list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-timesheets:AttendancePunch",
+      "path": "/attendancepunches",
+      "method": "GET"
+    },
+    {
+      "kind": "api",
+      "name": "attendancepunches.get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-timesheets:AttendancePunch",
+      "path": "/attendancepunches/[id]",
+      "method": "GET"
+    },
+    {
+      "kind": "cli",
+      "name": "attendancepunch_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-timesheets:AttendancePunch"
+    },
+    {
+      "kind": "cli",
+      "name": "attendancepunch_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-timesheets:AttendancePunch"
+    },
+    {
+      "kind": "mcp",
+      "name": "attendancepunch_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-timesheets:AttendancePunch"
+    },
+    {
+      "kind": "mcp",
+      "name": "attendancepunch_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-timesheets:AttendancePunch"
+    },
+    {
+      "kind": "api",
+      "name": "attendancebreaks.list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-timesheets:AttendanceBreak",
+      "path": "/attendancebreaks",
+      "method": "GET"
+    },
+    {
+      "kind": "api",
+      "name": "attendancebreaks.get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-timesheets:AttendanceBreak",
+      "path": "/attendancebreaks/[id]",
+      "method": "GET"
+    },
+    {
+      "kind": "cli",
+      "name": "attendancebreak_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-timesheets:AttendanceBreak"
+    },
+    {
+      "kind": "cli",
+      "name": "attendancebreak_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-timesheets:AttendanceBreak"
+    },
+    {
+      "kind": "mcp",
+      "name": "attendancebreak_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-timesheets:AttendanceBreak"
+    },
+    {
+      "kind": "mcp",
+      "name": "attendancebreak_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-timesheets:AttendanceBreak"
+    },
     {
       "kind": "api",
       "name": "servicechargesnapshots.list",
@@ -1005,12 +1884,19 @@
   ],
   "prompts": [],
   "relationshipsV2": {
-    "foreignKeyFields": 3,
-    "crossPackageRefFields": 4,
+    "foreignKeyFields": 6,
+    "crossPackageRefFields": 9,
     "junctionCollections": 0,
     "hierarchicalObjects": 0,
     "polymorphicAssociations": 0,
-    "uuidColumns": 26
+    "uuidColumns": 62
   },
-  "agentDoc": "# smrt-timesheets\n\nShared time entries: who (a `smrt-profiles` Profile, or an agent) worked how\nlong on what (a generic work reference), whether it was approved, and the\nimmutable charge / compensation snapshots taken at approval. Moved out of\n`smrt-projects` / `smrt-support` in #3288 so shops, builders, and service\ndesks share one model instead of re-implementing it.\n\nThis package is **layer 1 (entry)**. Attendance (punches, breaks, offline\nreplay) and period rollup (per-person timecards) are planned as later modules\nof this same package; do not add them to projects or support.\n\n## Models\n\n| Model | Table | Notes |\n|---|---|---|\n| `ServiceTimeEntry` | `service_time_entries` | `workRefType` + `workRefId`, `participantKind` (`human` \\| `agent`), `participantProfileId` / `agentRef`, `source`, `startedAt` / `endedAt` / `durationSeconds`, status machine, `correctionOfId` |\n| `ServiceChargeSnapshot` | `service_charge_snapshots` | Client charge, integer minor units (#2401), one per entry |\n| `ServiceCompensationSnapshot` | `service_compensation_snapshots` | Provider earning, integer minor units, one per entry |\n\n`ServiceEvidenceService` records, submits, approves (writing both snapshots\nthrough a `ServiceCommercialResolver`), and corrects. `smrt-projects` supplies\n`SubscriptionServiceCommercialResolver` for #1925 pricing.\n\n## Invariants\n\n- **No domain foreign key on the base.** Work context is the generic\n  `workRefType` (qualified class name) + `workRefId`. A domain adds its own\n  context by subclassing over the same table — smrt-support's\n  `ServiceTimeEntry` adds `caseId` / `specialistId` and extends\n  `frozenFieldNames()` so they freeze on approval.\n- **Entries carry no rate.** Money lives only on the snapshots, `= 0`\n  integer initializers (INTEGER columns). Never `= 0.0`. Snapshot `save()`\n  rejects an `amount` that is not a safe integer (`VALIDATION_INVALID_VALUE`),\n  so SQLite cannot silently store `19.99`; fix a fractional resolver at its\n  source rather than rounding here.\n- **Approved evidence never changes.** `save()` enforces\n  `SERVICE_TIME_ENTRY_STATUS_TRANSITIONS` and compares the frozen fields with\n  the stored row. A correction is a new row (`correctionOfId`), the original\n  flips to `corrected`. Snapshots are immutable after their first save.\n- **Old qualified names are aliases.** Each model declares its pre-#3288\n  `@happyvertical/smrt-projects:*` name in `previousQualifiedNames` (#3338;\n  `packages/core/agents/model-moves.md`). smrt-projects must never list these\n  classes in its manifests again (`CONFIG_QUALIFIED_NAME_ALIAS_COLLISION`),\n  and no subtype (smrt-support's, or a consumer's closing subclass) may\n  redeclare an alias (two claimants). Known gap: a same-named subtype that\n  replaces a moved class drops that class's alias, and the replaced class's\n  own `@happyvertical/smrt-timesheets:*` name stops resolving too — guidance\n  for apps with smrt-support must name `@happyvertical/smrt-support:ServiceTimeEntry`.\n  Support's vitest environment keeps both classes registered, so verify this\n  against built packages, not package tests. `projects/src/__tests__/legacy-qualified-identity.test.ts` pins\n  the projects-only contract.\n- **Table names are a compatibility contract.** `service_time_entries` and the\n  two snapshot tables hold existing production rows from smrt-projects /\n  smrt-support; renaming any of them, or adding a discriminator, is a data\n  migration.\n\n## One table family\n\nClasses may share a table only as one inheritance chain, and the registry\nresolves a chain of same-named classes by \"child wins\" on the simple name.\nThat works for exactly one subtype level per table (base → subtype); a third\nsame-named level makes the middle class look like it extends its own child on\nthe manifest path (`CONFIG_TABLE_NAME_COLLISION`). Therefore:\n\n- `smrt-projects` **re-exports** these classes (no projects subclass).\n- `smrt-support` subclasses `ServiceTimeEntry` directly from this package.\n- A consumer that needs its own surface (e.g. teamworks-os closing every\n  generated route with `api: { include: [] }` and\n  `@TenantScoped({ mode: 'required' })`) declares a same-named subclass over\n  `service_time_entries`; its manifest entry replaces the package's. It cannot\n  also install smrt-support's subtype on the same table.\n  The same applies to both snapshots;\n  `src/__tests__/consumer-closed-surface.test.ts` holds that contract for all\n  three models. The snapshots' explicit `time_entry_id` conflict key is not\n  rewritten when a consumer requires tenancy; widening it is the consumer's\n  schema change, never a package default.\n\nSubclasses restate their fields: package-isolated manifest scanning does not\nread dependency sources, so an unrestated subclass manifest has no columns.\n\n## Svelte UI\n\n`./svelte` exports `TimeEntryCard`, `TimeEntryList`, `TimeSummary`,\n`DurationDisplay`, and `TimeEntryApprovalQueue` (props-driven, plain view\nobjects, `smrt-ui` primitives, `smrtRawPrimitives: \"strict\"`). smrt-projects\nand smrt-support re-export them from their own `./svelte` subpaths.\nCard/list/summary message keys keep their `projects.*` namespace: tenant\nlanguage overrides are stored by key, and renaming would orphan them. New\nkeys use `timesheets.*`.\n\n## Validation\n\n```sh\npnpm --filter @happyvertical/smrt-timesheets test\npnpm --filter @happyvertical/smrt-timesheets test:postgres\npnpm --filter @happyvertical/smrt-timesheets typecheck\npnpm --filter @happyvertical/smrt-timesheets build\npnpm --filter @happyvertical/smrt-projects test\npnpm --filter @happyvertical/smrt-support test\n```\n\nSchema-affecting edits must keep `service-time-entry-compat.test.ts` (projects,\nsupport) and `service-time-entry-migration-plan.test.ts` (support) green: a\npre-move table must plan no DDL.\n"
+  "agentDoc": "# smrt-timesheets\n\nShared time entries: who (a `smrt-profiles` Profile, or an agent) worked how\nlong on what (a generic work reference), whether it was approved, and the\nimmutable charge / compensation snapshots taken at approval. Moved out of\n`smrt-projects` / `smrt-support` in #3288 so shops, builders, and service\ndesks share one model instead of re-implementing it.\n\nThis package contains **layer 1 (entry)**, **layer 2 (attendance)**, and\n**layer 3 (period rollup)**.\n`src/attendance/` owns punches, breaks, atomic transitions and durable offline\nreceipts; `./attendance` is the public subpath. Period rollup belongs in this\npackage too, never projects or support. See the README attendance contract.\nAttendance services accept trusted session actors, serialize mutations per\nactor, and bind every write to one executor. The new tables use non-null unique\nopen slots, not nullable unique keys. A linked entry is draft evidence, and\nrollups must deduplicate `AttendancePunch.serviceTimeEntryId`.\n\n## Models\n\n| Model | Table | Notes |\n|---|---|---|\n| `ServiceTimeEntry` | `service_time_entries` | `workRefType` + `workRefId`, `participantKind` (`human` \\| `agent`), `participantProfileId` / `agentRef`, `source`, `startedAt` / `endedAt` / `durationSeconds`, status machine, `correctionOfId` |\n| `ServiceChargeSnapshot` | `service_charge_snapshots` | Client charge, integer minor units (#2401), one per entry |\n| `ServiceCompensationSnapshot` | `service_compensation_snapshots` | Provider earning, integer minor units, one per entry |\n\n`ServiceEvidenceService` records, submits, approves (writing both snapshots\nthrough a `ServiceCommercialResolver`), and corrects. `smrt-projects` supplies\n`SubscriptionServiceCommercialResolver` for #1925 pricing.\n\n## Invariants\n\n- **No domain foreign key on the base.** Work context is the generic\n  `workRefType` (qualified class name) + `workRefId`. A domain adds its own\n  context by subclassing over the same table — smrt-support's\n  `ServiceTimeEntry` adds `caseId` / `specialistId` and extends\n  `frozenFieldNames()` so they freeze on approval.\n- **Entries carry no rate.** Money lives only on the snapshots, `= 0`\n  integer initializers (INTEGER columns). Never `= 0.0`. Snapshot `save()`\n  rejects an `amount` that is not a safe integer (`VALIDATION_INVALID_VALUE`),\n  so SQLite cannot silently store `19.99`; fix a fractional resolver at its\n  source rather than rounding here.\n- **Approved evidence never changes.** `save()` enforces\n  `SERVICE_TIME_ENTRY_STATUS_TRANSITIONS` and compares the frozen fields with\n  the stored row. A correction is a new row (`correctionOfId`), the original\n  flips to `corrected`. Snapshots are immutable after their first save.\n- **Old qualified names are aliases.** Each model declares its pre-#3288\n  `@happyvertical/smrt-projects:*` name in `previousQualifiedNames` (#3338;\n  `packages/core/agents/model-moves.md`). smrt-projects must never list these\n  classes in its manifests again (`CONFIG_QUALIFIED_NAME_ALIAS_COLLISION`),\n  and no subtype (smrt-support's, or a consumer's closing subclass) may\n  redeclare an alias (two claimants). Known gap: a same-named subtype that\n  replaces a moved class drops that class's alias, and the replaced class's\n  own `@happyvertical/smrt-timesheets:*` name stops resolving too — guidance\n  for apps with smrt-support must name `@happyvertical/smrt-support:ServiceTimeEntry`.\n  Support's vitest environment keeps both classes registered, so verify this\n  against built packages, not package tests. `projects/src/__tests__/legacy-qualified-identity.test.ts` pins\n  the projects-only contract.\n- **Table names are a compatibility contract.** `service_time_entries` and the\n  two snapshot tables hold existing production rows from smrt-projects /\n  smrt-support; renaming any of them, or adding a discriminator, is a data\n  migration.\n\n## One table family\n\nClasses may share a table only as one inheritance chain. Core resolves\nsame-named subclasses by constructor ancestry at runtime and qualified manifest\nancestry at build registration; the deepest subtype wins across N levels.\nSibling or unrelated types cannot share the table. `smrt-projects` re-exports\nthe base; `smrt-support` subclasses it directly.\n\nConsumers closing package routes should call\n`ObjectRegistry.registerOverride(qualifiedName, { api: false, mcp: false,\ncli: false, tenancy: { mode: 'required' } })` after importing the model and before\nconstructing transports. This tightens the existing registration without a new\nsubtype. See core's README for startup order, static route generation, and reset\nsemantics. `src/__tests__/consumer-closed-surface.test.ts` also covers existing\nmanifest subclass consumers. The snapshots' explicit `time_entry_id` conflict\nkey is not rewritten when a consumer requires tenancy; widening it remains a\nconsumer schema change.\n\nSubclasses restate their fields: package-isolated manifest scanning does not\nread dependency sources, so an unrestated subclass manifest has no columns.\n\n## Svelte UI\n\n`./svelte` exports `TimeEntryCard`, `TimeEntryList`, `TimeSummary`,\n`DurationDisplay`, and `TimeEntryApprovalQueue` (props-driven, plain view\nobjects, `smrt-ui` primitives, `smrtRawPrimitives: \"strict\"`). smrt-projects\nand smrt-support re-export them from their own `./svelte` subpaths.\nCard/list/summary message keys keep their `projects.*` namespace: tenant\nlanguage overrides are stored by key, and renaming would orphan them. New\nkeys use `timesheets.*`.\n\n## Validation\n\n```sh\npnpm --filter @happyvertical/smrt-timesheets test\npnpm --filter @happyvertical/smrt-timesheets test:postgres\npnpm --filter @happyvertical/smrt-timesheets typecheck\npnpm --filter @happyvertical/smrt-timesheets build\npnpm --filter @happyvertical/smrt-projects test\npnpm --filter @happyvertical/smrt-support test\n```\n\nSchema-affecting edits must keep `service-time-entry-compat.test.ts` (projects,\nsupport) and `service-time-entry-migration-plan.test.ts` (support) green: a\npre-move table must plan no DDL.\n\n## Period rollup\n\nLayer 3 lives under `src/rollup/` and the `./rollup` subpath. See\n[period-rollup.md](agents/period-rollup.md) for resolver, source clipping,\nconfirmation, attributed adjustments, isolation, and transaction contracts.\nTimecards and adjustments have closed generated surfaces and service-only\nmodel writes; never bypass the instance capability with generic persistence.\n",
+  "moduleDocs": [
+    {
+      "path": "agents/period-rollup.md",
+      "module": "period-rollup",
+      "content": "# Period timecards\n\n`@happyvertical/smrt-timesheets/rollup` exports `PeriodRollupService`,\n`PeriodTimecard`, `TimecardAdjustment`, their collections, and resolver types.\nThe package root also exports them. SQLite and PostgreSQL are supported.\nCreate application tables through normal migrations; neither service provisions\nschema. The attendance option additionally requires the attendance tables.\n\nConstruct a service only after authenticating and authorizing its trusted\n`{ tenantId, profileId }` scope. A conflicting ambient tenant is rejected.\n`options.actorProfileId` records a separately authorized supervisor; it defaults\nto the subject profile for self confirmation/correction. Never accept this\ntrusted scope or attribution unchecked from request input. Profile authorization\nis consumer-owned; the service filters every source/card/adjustment read by its\ntrusted subject and tenant. Generic API, CLI and MCP surfaces are closed by\ndefault; consumer registry overrides may further restrict them (#3318).\n\n## Resolver contract\n\n`periodFor(at, actor)` supplies half-open UTC `startsAt`/`endsAt`, an IANA\n`timezone`, a nonempty policy `version`, and a JSON `rules` snapshot.\nThe consumer owns period length, calendar start day, timezone and DST, overtime\nthresholds, holidays and classification. The requested instant must be inside\nthe window. Overlapping windows for existing cards are rejected: introduce a new\ncalendar at a boundary after existing windows, and use adjustments for already\nconfirmed periods.\n\n`classify(period, sources, actor)` returns nonnegative safe integer\n`regularSeconds` and `overtimeSeconds`, whose sum must equal source seconds.\nInputs are detached so resolver mutation cannot rewrite evidence. Resolver\nexceptions, malformed windows, invalid timezone, fractional/unsafe totals and\nnonconserving classification abort the transaction. No Alberta or other\njurisdiction rule is assumed, and no pay rate or money is stored.\n\nA configurable UTC calendar example (illustrative policy, not payroll advice):\n\n```ts\nimport { PeriodRollupService, type PeriodRulesResolver } from\n  '@happyvertical/smrt-timesheets/rollup';\n\nconst settings = {\n  lengthDays: 14, startDay: 1, timezone: 'UTC', // 0 = Sunday\n  anchor: '2026-01-05T00:00:00Z', // aligned Monday; anchors fortnight phase\n  thresholdSeconds: 80 * 3600,\n  holidays: ['2026-12-25'],\n};\nconst resolver: PeriodRulesResolver = {\n  async periodFor(at) {\n    const anchor = new Date(settings.anchor);\n    if (anchor.getUTCDay() !== settings.startDay || settings.timezone !== 'UTC')\n      throw new Error('Use a timezone-aware calendar resolver for local periods');\n    const length = settings.lengthDays * 86400000;\n    const start = anchor.getTime() +\n      Math.floor((at.getTime() - anchor.getTime()) / length) * length;\n    return {\n      startsAt: new Date(start), endsAt: new Date(start + length),\n      timezone: settings.timezone, version: 'shop-policy-v1', rules: settings,\n    };\n  },\n  async classify(period, sources) {\n    const rules = period.rules as typeof settings;\n    // This example assigns a contribution to its clipped start's UTC date.\n    // Local daily rules should split contributions at their own local midnight.\n    let regular = 0;\n    let holiday = 0;\n    for (const source of sources) {\n      if (rules.holidays.includes(source.startsAt.slice(0, 10))) holiday += source.seconds;\n      else regular += source.seconds;\n    }\n    return {\n      regularSeconds: Math.min(regular, rules.thresholdSeconds),\n      overtimeSeconds: holiday + Math.max(0, regular - rules.thresholdSeconds),\n    };\n  },\n};\nconst rollups = new PeriodRollupService(db, authorizedSubject, resolver,\n  { attendance: true, actorProfileId: authenticatedSupervisorProfileId });\nconst card = await rollups.rollup(new Date());\nawait rollups.confirm(card.id!);\nawait rollups.adjust(card.id!, {\n  operationId: requestId, regularSeconds: 900, overtimeSeconds: 0,\n  reason: 'Approved correction after confirmation',\n});\nconst effectiveSeconds = await rollups.totals(card.id!);\n```\n\nA timezone-aware resolver must compute each local boundary separately: a local\nday crossing DST is not necessarily 86400 seconds. Resolvers can use an app's\nexisting calendar library; no new timezone dependency or implicit default is\nintroduced here.\n\n## Evidence and immutability\n\nOnly approved human `ServiceTimeEntry` rows for the subject count; corrected\nancestors do not. Correction chains must remain within that subject/tenant and\npoint to corrected parents. Multiple approved descendants of one root are\nrejected as ambiguous rather than double-counted. Entries with both `startedAt`\nand `endedAt` allocate their declared seconds\nproportionally across the period using exact integer prefix division, preserving\nseconds over adjacent periods. Unbounded entries count at `startedAt`, or, when\nabsent, `approvedAt`; an end-only timestamp does not create an interval. Missing\nboth attribution timestamps is an error. This is time attribution, not a\nclaim that a manual entry has a continuous wall-clock duration.\n\nWith `attendance: true`, closed punches without `reviewRequired` count, excluding\nunpaid breaks and retaining paid breaks. Open/review-required punches do not\ncount. Linked attendance is authoritative: its evidence entry and any approved\ncorrection descendants are excluded, including when the punch is still under\nreview or outside the requested period. Unlinked approved work entries and\nattendance both count; consumers must link overlapping evidence explicitly.\nSource snapshots preserve each paid attendance segment and entry identity.\n\nRepeated rollup updates one open card per tenant/person/start; a confirmed card\ncannot be recomputed. Confirmation is attributed and idempotent. Model save,\ncollection create/update/upsert and object/collection delete cannot bypass the\nservice. Model mutation capabilities are per-instance and not exported.\nDirect SQL is a trusted administrative boundary, not an exposed application API.\nProfile/card foreign keys restrict deletion to preserve history.\n\nAdjustments contain signed integer regular/overtime deltas, reason, operation\nkey and actor attribution. A retry reuses its row only for the exact same\npayload and actor. Effective totals may never become negative or unsafe.\nAdjustments never alter the confirmed row or source snapshot. Undo an adjustment\nwith a separately attributed compensating adjustment, never deletion.\n\nAll service mutations use a root transaction, transaction-bound collections,\nembedded writer serialization or a PostgreSQL tenant/person advisory lock.\nOutputs are reloaded on the root executor after commit. Rollup reads are an\napplication snapshot: subsequent source approvals/corrections appear on the\nnext open rollup, and confirmed cards require explicit adjustments.\n"
+    }
+  ]
 }