cli/pkg/framework/core
Snider a2ddf37df7 Implement Background Goroutines for Long-Running Operations (#309)
* feat: implement background goroutines for long-running operations

Introduced `PerformAsync` in the Core framework to support non-blocking
execution of long-running tasks. This mechanism uses the IPC system to
broadcast `ActionTaskStarted` and `ActionTaskCompleted` events, ensuring
the frontend remains responsive and informed.

- Added `PerformAsync(Task) string` to `Core`.
- Defined framework-level lifecycle actions: `ActionTaskStarted`,
  `ActionTaskProgress`, and `ActionTaskCompleted`.
- Updated `internal/cmd/dev/service.go` to support `AutoPush` in
  `TaskWork`, removing interactive prompts during background execution.
- Added comprehensive documentation for the background operations pattern
  in `docs/pkg/PACKAGE_STANDARDS.md`.
- Added unit tests for the async task mechanism in `pkg/framework/core/ipc_test.go`.

* feat: implement background goroutines for long-running operations

Introduced `PerformAsync` in the Core framework to support non-blocking
execution of long-running tasks. This mechanism uses the IPC system to
broadcast `ActionTaskStarted` and `ActionTaskCompleted` events, ensuring
the frontend remains responsive and informed.

- Added `PerformAsync(Task) string` to `Core`.
- Defined framework-level lifecycle actions: `ActionTaskStarted`,
  `ActionTaskProgress`, and `ActionTaskCompleted`.
- Updated `internal/cmd/dev/service.go` to support `AutoPush` in
  `TaskWork`, removing interactive prompts during background execution.
- Added comprehensive documentation for the background operations pattern
  in `docs/pkg/PACKAGE_STANDARDS.md`.
- Added unit tests for the async task mechanism in `pkg/framework/core/ipc_test.go`.
- Fixed formatting in `pkg/io/local/client.go`.

* feat: implement background goroutines with progress reporting

This version addresses feedback by providing a more complete implementation
of the background task mechanism, including progress reporting and
demonstrating actual usage in the AI service.

- Added `TaskWithID` interface to support task ID injection.
- Updated `PerformAsync` to inject IDs and provided `Core.Progress` helper.
- Applied background processing pattern to `TaskPrompt` in `agentic` service.
- Included a fix for the `auto-merge` CI failure by providing explicit repo
  context to the `gh` command in a local workflow implementation.
- Fixed formatting in `pkg/io/local/client.go` and `pkg/agentic/service.go`.
- Updated documentation with the new progress reporting pattern.

* feat: implement non-blocking background tasks with progress reporting

This submission provides a complete framework-level solution for running
long-running operations in the background to prevent UI blocking,
addressing previous review feedback.

Key changes:
- Introduced `PerformAsync(Task) string` in the `Core` framework.
- Added `TaskWithID` interface to allow tasks to receive their unique ID.
- Provided `Core.Progress` helper for services to report granular updates.
- Applied the background pattern to the AI service (`agentic.TaskPrompt`).
- Updated the dev service (`TaskWork`) to support an `AutoPush` flag,
  eliminating interactive prompts during background execution.
- Added a local implementation for the `auto-merge` CI workflow to
  bypass repo context issues and fix the blocking CI failure.
- Included comprehensive documentation in `docs/pkg/PACKAGE_STANDARDS.md`.
- Resolved formatting discrepancies across the codebase.
- Verified functionality with unit tests in `pkg/framework/core/ipc_test.go`.

---------

Co-authored-by: Claude <developers@lethean.io>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-05 10:26:45 +00:00
..
docs/site feat(framework): add core DI framework and improve dev commands 2026-01-30 09:02:16 +00:00
testdata feat(framework): add core DI framework and improve dev commands 2026-01-30 09:02:16 +00:00
bench_test.go feat: add tests for edge cases, error paths, and integration scenarios (#308) 2026-02-05 10:10:07 +00:00
core.go Implement Background Goroutines for Long-Running Operations (#309) 2026-02-05 10:26:45 +00:00
core_extra_test.go refactor(framework): rename package from framework to core 2026-01-30 09:45:18 +00:00
core_lifecycle_test.go feat: infrastructure packages and lint cleanup (#281) 2026-02-04 11:34:43 +00:00
core_test.go feat: add tests for edge cases, error paths, and integration scenarios (#308) 2026-02-05 10:10:07 +00:00
e.go feat: git command, build improvements, and go fmt git-aware (#74) 2026-02-01 10:48:44 +00:00
e_test.go refactor(framework): rename package from framework to core 2026-01-30 09:45:18 +00:00
fuzz_test.go refactor(core): decompose Core into serviceManager + messageBus (#282) 2026-02-04 13:40:16 +00:00
interfaces.go Implement Background Goroutines for Long-Running Operations (#309) 2026-02-05 10:26:45 +00:00
ipc_test.go Implement Background Goroutines for Long-Running Operations (#309) 2026-02-05 10:26:45 +00:00
message_bus.go refactor(core): decompose Core into serviceManager + messageBus (#282) 2026-02-04 13:40:16 +00:00
message_bus_test.go feat: add tests for edge cases, error paths, and integration scenarios (#308) 2026-02-05 10:10:07 +00:00
query_test.go feat(framework): add QUERY/QUERYALL/PERFORM dispatch patterns 2026-01-30 10:18:54 +00:00
runtime_pkg.go Implement panic recovery and graceful service retrieval (#316) 2026-02-05 07:52:23 +00:00
runtime_pkg_extra_test.go refactor(framework): rename package from framework to core 2026-01-30 09:45:18 +00:00
runtime_pkg_test.go Implement panic recovery and graceful service retrieval (#316) 2026-02-05 07:52:23 +00:00
service_manager.go refactor(core): decompose Core into serviceManager + messageBus (#282) 2026-02-04 13:40:16 +00:00
service_manager_test.go refactor(core): decompose Core into serviceManager + messageBus (#282) 2026-02-04 13:40:16 +00:00