kennethwussmann / zeitraum Goto Github PK

WHY

I noticed that multiple tags are combined to express a specific activity. It sometimes takes effort to remember the exact combination.

For example: life, cleaning, bathroom

In such a case, a quick activity could be lovely, which bundles multiple tags and a note together. Like a time span preset.

Example preset:

Name: Cleaning Bathroom
Tags: life, cleaning
Note: Bathroom

WHAT

• Add the ability to persist TimeSpanPreset. They hold an array of tags, an optional note, and a display name.
• Allow list, update and deletion of TimeSpanPresets.
• Add additional mutation that can track time spans based on presets.
  • This could be an additional parameter on the current mutation for time span creation, not sure.
  • The preset is referenced by it's UUID for creation, but they are not linked together on a database level. Data from the preset is instead copied into the new time span.

Currently, it's required to start a server, so SOFA generates the OpenAPI spec on the fly. But that's rather inconvenient to just check the API. There is still the GraphQL schema one can just look at but some still prefer REST.

Also for @zeitraum/client it could be helpful to have the TypeDoc online.

Build when the tag is published and upload to GH Pages.

This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

Open

These updates have all been created already. Click a checkbox below to force a retry/rebase of any.

• Update prom/prometheus Docker tag to v2.43.1
• Update dependency lightship to v8

Ignored or Blocked

These are blocked by an existing closed PR and will not be recreated unless you click a checkbox below.

• Update dependency @moia-oss/eslint-prettier-typescript-config to v0.11.59
• Update dependency sofa-api to ^0.17.0
• Update Node.js to v20
• Update dependency typescript to v5

Detected dependencies

• Check this box to trigger a request for Renovate to run again on this repository

The zeitraum ls command currently lists all time spans.

It would be nice to allow something like zeitraum ls work meeting that returns only time spans that are assigned to at least work and meeting. If they are also assigned to a third daily it should still return.

The backend allows filtering by tags already: https://github.com/KennethWussmann/zeitraum/blob/main/packages/server/src/api/graphql/schema.graphql#L30

To be verified if this needs adjustment to include the at least logic.

Currently, running time spans without an end are not exported in iCal, but it would be better if they were so that one at least knows that something is tracking.
It could be written in the title that the time span is still active.

Every client should know it's version.

CLI

zeitraum version and zeitraum -v should return it's currently used version and the version of the server it's connected to.

@zeitraum/client

Should have a constant that is built into the released package with it's version.

Server

The server knows it's version already and also provides it via a query to clients, but it should also expose a query with all latest versions of the client & the CLI.

This will be useful for update and compatibility checks.

If you misspelled a tag, it will be forever in the DB.
Instead, they could be pruned on update & delete of time spans so they get deleted when they are no longer assigned anywhere.
Another option could be to offer update and delete operations for tags, but it sounds tedious to implement in clients for occasional use.

For a potential client, it could be helpful to know about the time spans in real time because time can be tracked by multiple clients.
Add a subscription for the timeSpans query.

I didn't want to, but a frontend would be more comfortable than iOS Shortcuts.
The Shortcuts can't be edited easily; keeping them up-to-date is a mess.

• PWA (online-first, for now)
• Mobile-first
• Keyboard navigation (ease of use like the Raycast Extension)
• Time Spans
  • Create
  • Create from Preset
  • Update
  • Delete
  • List
• Presets
  • Create
  • Update
  • Delete
  • List

Edit:

• CLI
• Raycast Extension

Resume:

• CLI
• Raycast Extension

I'd like to start and stop specific tag combinations via Stream Deck for quick tracking while working.
But maybe not be worth it because the CLI or HTTP API should be sufficient. Could still offer a better UX.

It would be nice to have an iCal export. This way, one can easily have an overview of what they spent time on that day.

The go table lib used for the list command can have a footer.
Write the sum of all durations of the list into the footer as total duration.

This way one could do queries like zeitraum ls work --today to know how much they worked today. This specific example requires #43, but in general is independent.

Currently the CLI returns all the time spans (up to 1000) when using zeitraum ls. Would be good to switch the default behaviour and only return the time spans of today, like the --today flag already does. Then add a --all & -a flag that returns all time spans like before.