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

chore: stop tracking .pi/ — it blocks rebase for any session with local goal state

Đang mở Phù hợp với người mới
  • Có gì không ổn?
#49 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

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

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
88/100
Loại issue
Tái cấu trúc
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
git
Lĩnh vực
developer-experience

Hướng nghiên cứu

Bắt đầu với .gitignore và kiểm tra các đường dẫn .pi/ được theo dõi liệt kê trong issue. Xóa .pi/ khỏi chỉ mục trong khi vẫn giữ nguyên các tệp cục bộ, sau đó xác minh rằng .pi/ bị bỏ qua, không thể đọc trạng thái mục tiêu từ repository và git rebase origin/main chạy thành công khi checkout không thay đổi .pi/.

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

Mô tả

bug

Problem

PR #43 committed the agent's local goal state into the repository:

.pi/.goals-pool-snapshot.json
.pi/goals/.goal-ledger-checkpoint.json
.pi/goals/goal_events.jsonl
.pi/goals/archived_goal_2026092111245901_mub1hdzf-5j5j22.md

.pi/ is per-session working state that the Pi agent writes to continuously. Tracking it has two consequences, one of which blocks work outright.

It breaks rebase and pull for any session that has local goal state. git rebase and git checkout refuse to proceed:

error: The following untracked working tree files would be overwritten by checkout:
	.pi/.goals-pool-snapshot.json
	.pi/goals/.goal-ledger-checkpoint.json
	.pi/goals/goal_events.jsonl
Please move or remove them before you switch branches.
Aborting

Hit while rebasing a feature branch onto main on 2026-09-22. The workaround is to move .pi/ aside and restore it afterwards, which is exactly the kind of step that turns into lost state when it is forgotten.

It also publishes local state, including goal text and ledger snapshots, to anyone with repository read access.

Suggested fix

  1. Add .pi/ to .gitignore.
  2. git rm -r --cached .pi so the files stay on disk but leave the index.
  3. Decide separately whether the archived goal documents are wanted in the repository; if they are, they belong under docs/ or plans/, not under a path the agent overwrites.

Acceptance

  • .pi/ is ignored and untracked.
  • git rebase origin/main succeeds on a branch whose checkout does not change .pi/.
  • No agent goal state is readable from the repository.
Ngôn ngữ chính
TypeScript
Star
186
Fork
40
Merge trung bình
10 giờ 12 phút
Pull request đã merge (30 ngày)
16

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

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

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 nextlevelbuilder/skillx

Tất cả issue của nextlevelbuilder/skillx

Issue tương tự

Thêm issue về TypeScript

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.