Skip to content

[IMP-243] Migrate task-explorer (previously task-viewer) to typescript-libs - #48

Merged
ctuncay merged 4 commits into
mainfrom
task-explorer-migration
Apr 16, 2026
Merged

[IMP-243] Migrate task-explorer (previously task-viewer) to typescript-libs#48
ctuncay merged 4 commits into
mainfrom
task-explorer-migration

Conversation

@ctuncay

@ctuncay ctuncay commented Apr 15, 2026

Copy link
Copy Markdown
Contributor

Extracts the task-viewer app from virtual-agent into this repo as a standalone task-explorer package.

What's included

New package: task-explorer/

  • Full-stack app (Express backend + React/Vite frontend) for browsing and inspecting task actions and workflows
  • Backend reads exclusively via @ambarltd/tasks/explorer — no direct Store queries
  • Frontend: paginated task list, task detail view, Gantt chart for workflow subtasks, stats widget, auth, timezone selector, auto-refresh

Changes to @ambarltd/tasks (landed in PR #45, surfaced here via the simplification commit):

  • Added excludeColumns?: string[] to all 4 explorer query functions (listTasks, searchTasks, listSubtasks, listTasksInTimeRange)
  • Summary schemas (TaskActionSummary, TaskWorkflowSummary) live in explorer.ts — eliminates ~400 lines of forked query code that task-explorer previously carried locally

CI/CD

  • .github/workflows/ambar-task-explorer.yaml: runs backend typecheck + unit tests and frontend typecheck + Vitest on every PR; builds and pushes ghcr.io/ambarltd/task-explorer:latest + :<sha> on merge
    to main

Test coverage

  • 17 backend unit tests (decoders, API schema encoders, environment, stats requirements)
  • 64 frontend tests (API client, task utils, format utils, stats utils, auth, components)

Potential future work

  • PR (virtual-agent):
    • Consume @ambarltd/tasks, delete local lib/tasks/ and lib/postgres.ts — unblocked now that @ambarltd/tasks@0.1.0 is published
    • Replace task-viewer/ with image: ghcr.io/ambarltd/task-explorer:latest in docker-compose

@ctuncay ctuncay self-assigned this Apr 15, 2026
@linear

linear Bot commented Apr 15, 2026

Copy link
Copy Markdown
IMP-243 [Tasks] Move task-viewer to typescript-libs

Let's make it one of the libraries we have there alongside core.

It should be separate from the tasks library as it is not a requirement for using the tasks library.

We need

  • A GitHub action that is only triggered when files for this library are changed.
  • A good way to distribute the Docker image. Ideally something private and easy to set up, similar to the GitHub registry for npm, but for Docker.

@ctuncay
ctuncay marked this pull request as ready for review April 15, 2026 19:39
@ctuncay
ctuncay requested a review from lazamar April 15, 2026 19:46

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: cd6efbb7ce

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread task-explorer/frontend/src/lib/taskUtils.ts
Comment thread task-explorer/backend/src/lib/api-schemas.ts Outdated
@ctuncay
ctuncay force-pushed the task-explorer-migration branch from 521c3a7 to 4c442f7 Compare April 16, 2026 04:12

@lazamar lazamar left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OK

@ctuncay
ctuncay merged commit f7104b8 into main Apr 16, 2026
3 checks passed
@ctuncay
ctuncay deleted the task-explorer-migration branch April 16, 2026 16:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants