Skip to content

Conversation

@fxck
Copy link
Member

@fxck fxck commented Jan 18, 2026

Summary

  • Add zcli project processes command to list running and pending processes for a project
  • Add zcli project notifications command to list notifications with pagination support
  • Extend zcli service list to display active app version ID and creation timestamp
  • Add CLAUDE.md developer guide for AI-assisted development

New Commands

zcli project processes

Lists all currently RUNNING and PENDING processes for a project (deployments, builds, service starts/stops, etc.).

zcli project processes -P <project>
Column Description
id Process UUID
action Action name (e.g., "serviceStack.create")
status RUNNING or PENDING
services Affected service names
created by User email/name or "system"
created Timestamp

zcli project notifications

Lists notifications for a project with pagination support.

zcli project notifications -P <project> [--limit 50] [--offset 0]
Flag Description
--limit Max notifications to return (1-100, default: 50)
--offset Skip N notifications for pagination (default: 0)

Enhanced zcli service list

Now includes active app version information:

zcli service list -P <project>

New columns: app version id, app version created

Changes

New Files

  • src/cmd/projectProcesses.go - Processes command
  • src/cmd/projectNotifications.go - Notifications command
  • src/entity/userNotification.go - UserNotification entity
  • src/entity/repository/userNotification.go - Notification repository
  • src/uxHelpers/process.go - Process list rendering
  • src/uxHelpers/notification.go - Notification list rendering
  • CLAUDE.md - Developer guide

Modified Files

  • src/cmd/project.go - Register new subcommands
  • src/entity/process.go - Add fields (Created, LastUpdate, Started, CreatedByUser, ServiceNames, CreatedBySystem)
  • src/entity/service.go - Add ActiveAppVersionId, ActiveAppVersionCreated fields
  • src/entity/repository/process.go - Add GetRunningAndPendingProcessesByProject
  • src/entity/repository/service.go - Map ActiveAppVersion in serviceFromEsSearch
  • src/uxHelpers/service.go - Add app version columns to table
  • src/uxBlock/styles/styles.go - Add shared DateTimeFormat constant
  • src/i18n/en.go - Add translations
  • src/i18n/i18n.go - Add i18n constants

Test Plan

  • Run zcli project processes -P <project> and verify output shows running/pending processes
  • Run zcli project notifications -P <project> and verify pagination works with --limit/--offset
  • Run zcli service list -P <project> and verify app version columns appear
  • Verify empty state messages display correctly when no processes/notifications exist
  • Run go build ./... - passes
  • Run go test ./src/... - passes

fxck and others added 2 commits January 18, 2026 17:54
Add two new subcommands under 'zcli project':

- `project processes`: Lists running and pending processes for a project,
  showing process ID, action, status, services, creator, and creation time.
  Results limited to 100, sorted by creation time descending.

- `project notifications`: Lists notifications for a project with pagination
  support (--limit, --offset flags). Shows notification ID, action, type,
  services, creator, creation time, and acknowledgment status.

Changes include:
- New Process entity fields (Created, LastUpdate, Started, CreatedByUser,
  ServiceNames, CreatedBySystem) and ProcessFields variable
- New UserNotification entity with repository functions
- New uxHelpers for rendering process and notification tables
- Shared DateTimeFormat constant in styles package
- i18n translations for all new commands and messages

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Extend 'zcli service list' command to display the active app version ID
and creation timestamp for each service.

Changes:
- Add ActiveAppVersionId and ActiveAppVersionCreated fields to Service entity
- Map ActiveAppVersion from EsServiceStack in serviceFromEsSearch
- Update service list table to show 'app version id' and 'app version created'
  columns, displaying '-' when no active version exists
- Normalize table headers to lowercase for consistency

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add comprehensive developer documentation for Claude Code assistance,
covering project architecture, command framework, entity models, UX
components, build/release process, and common development patterns.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
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