Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

:bug: Cortex being down can break harness

Đã đóng
  • Có gì không ổn?
#1,002 0 bình luận 0 reaction 1 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

@cwiklik đang làm issue này rồi.

Từ ngày 13/10/2026.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
35/100
Loại issue
Lỗi
Độ rõ ràng
Cần làm rõ
Mức độ hoạt động
Sôi nổi
Công nghệ
go
Lĩnh vực
backend, cli, networking

Hướng nghiên cứu

Start by tracing the abctl service install, stop, and uninstall behavior, including how routing through :47600 is configured. Compare the shim and soft-fail approaches in the issue before choosing a lifecycle contract. Done means a stopped Cortex does not cause harness traffic to fail, with the resulting service semantics clear for users.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

kind/bug ux

Description

abctl service install writes proxy settings into the user's environment so any harness it was pointed at and routes through Cortex on :47600. When Cortex is down for any reason (abctl service stop, launchd killed it, abctl service uninstall didn't fully clean up), the routing stays configured but the port isn't listening. The harness's next request hits connection-refused. Cortex being down should mean "no observation," not "no traffic."

The failure mode is invisible to a user who has forgotten Cortex exists:

  • The error surfaced is generic ("network error", "cannot reach API"), not "your local proxy is down."
  • Nothing tells them their traffic is being routed through localhost.
  • Remediation (abctl service start or unsetting the routing) requires knowing Cortex exists.
  • Not scoped to a specific harness — anything abctl service install configured is affected.

Reproduction

  1. Install Cortex on a laptop where Claude Code was working, then abctl service install.
  2. Confirm Claude Code still works.
  3. abctl service stop.
  4. Send a message in Claude Code → connection error.

Potential approaches

A. Add a lightweight shim on :47600, move Cortex to :47602.
Shim always listens; forwards to Cortex when up, direct to origin when down. Harness never sees a dead port. Preserves abctl service stop as a real "kill the process" verb.

Cost: a second persistent service, one more proxy hop on every request, and more code between harness and origin — CONNECT, HTTP/2, WebSocket upgrade all get one more layer.

B. Make Cortex itself soft-fail; rename its lifecycle verbs.
Cortex process stays up as a transparent passthrough whenever its observation pipeline is down or "stopped." abctl service stop becomes "pause observation," not "kill the transport." abctl service uninstall is the only verb that removes the process and unroutes the harness. No new process, no new hop; coupling is removed by design.

Cost: a UX contract change on stop — it no longer stops the process, and existing operators have to adjust

Assisted-By: Claude (Anthropic AI) [email protected]

Ngôn ngữ chính
Go
Star
18
Fork
42
Merge trung bình
12 giờ 34 phút
Pull request đã merge (30 ngày)
257

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của rossoctl/cortex

Tất cả issue của rossoctl/cortex

Issue tương tự

Thêm issue về Go

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.