Time Tracking

ArcTime SDK

Data access layer for ArcTime — timer, timesheet, approvals, signals, and reports. Supabase-native. Schema: 093_arctime_p0_schema.sql. Feature-complete at /work/time/ in Surface. Replaces Clockify.

TypeScriptSupabaseSurface moduleFeature-complete

Overview

ArcTime is the Grid's sovereign time tracking module. It replaced Clockify as the primary time logging tool for the team. The feature set is complete: manual entry, timer start/stop, timesheet view, monthly calendar, approvals queue, signals view, and data export/import.

Feature-complete

All PM.3 features are live at /work/time/ in Surface. Clockify formal cancellation is pending Charles's decision. See the ArcTime Feature Matrix for the full breakdown.

Schema

All ArcTime data lives in Supabase. Migration: 093_arctime_p0_schema.sql.

  • time_entries - timer records (user, project, task, start, end, duration, billable, approved)
  • time_signals - passive signal records (source, type, estimated_minutes, metadata)
  • time_approvals - approval workflow (entry_id, status, reviewer_id, note, reviewed_at)
  • time_rates - hourly rate config per member + project (pending UI, schema exists)

API surface

ArcTime exposes Next.js API routes under /api/time/. All routes are RLS-protected by Supabase auth.

POST /api/time/entries # create entry GET /api/time/entries # list (with date range filter) PATCH /api/time/entries/:id # update (duration, project, etc.) POST /api/time/entries/:id/approve POST /api/time/entries/:id/reject GET /api/time/signals # list signal-sourced estimates POST /api/time/signals/accept # accept signal as entry GET /api/time/export # CSV export

Signal accrual

ArcTime listens to Surface events and accumulates passive time estimates. These appear in the Signals view and can be accepted with one click to create real time entries.

  • Meeting attendance (from Calendar integration) - estimates based on meeting duration
  • Status transitions on tasks - estimates based on transition type
  • File delivery events - fixed estimate per delivery
  • ArcFlow run completions - wall-clock from ArcFlow ledger

Reports integration

The ArcTime data store feeds four reports at /work/reports/: Benchmark (estimated vs actual), Capacity (available vs logged), Margin (billable split), and Workload (per-member distribution). All reports query Supabase directly — no export required.

Clockify migration

ArcTime supports Clockify CSV import for historical data. The import tool is at /work/time/data. Awaiting Charles's decision to formally cancel Clockify (PM.3 exit gate).