Skip to content

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

Closed

Description

@mrgoonie

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.

Activity

  1. self-assigned this
    on Oct 19, 2026
  2. added and removed on Oct 19, 2026
  3. added a commit that references this issue on Oct 20, 2026
    e3cf1df
  4. mrgoonie commented on Oct 20, 2026

    @mrgoonie
    ContributorAuthor

    Shipped: fixed by #96 (squash fbd0333, merged 2026-10-20 after 6 isolated review rounds). Deployed to production skillx-web (worker version 27d34bce at fbd0333; current 7d29ff0a at 79f98fb). Smoke 2026-10-20: /, /api/search and registry keys 200.

  5. added
    shippedMerged/deployed
    and removed on Oct 20, 2026
  6. added a commit that references this issue on Oct 20, 2026
    fbd0333
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

bugSomething isn't workingshippedMerged/deployed

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions