7.0 KiB
7.0 KiB
Bash worktree cwd workflow record
Status
- Status: waiting
- Current phase: 3. Design and obtain plan approval
- Next safe action: present the revised local-override plan and obtain explicit approval before further product mutation.
Request and scope
- Request: address the first repository TODO so Bash execution honors the current Pi tool context inside hidden Git worktrees.
- In scope: reproduce the Pi 0.84.4 behavior; add a repository-owned, publishable
@jbcode/pi-bash-cwdextension that delegates to Pi's built-in Bash implementation using each call'sctx.cwd; test workspace-root, nested-package, and missing-directory execution in a disposable hidden worktree; update package inventory and documentation; remove the resolved TODO. - Out of scope: upgrading Pi, changing Bash's public per-call arguments, installing or publishing the new package, deploying, pushing, or modifying live/production data.
Git identity
- Source branch:
main - Base commit:
7e7cfdb5cb0e1a1218b9a2c8250267d5099637fc - Feature branch:
feature/honor-bash-worktree-cwd - Worktree:
/srv/data/code/jb-pi/harness-tools/.worktrees/honor-bash-worktree-cwd - Omitted source changes: none; source checkout was clean and equal to
origin/mainaftergit fetch origin main.
Acceptance criteria
@jbcode/pi-bash-cwdoverrides the built-inbashtool without changing its public arguments, output, truncation, cancellation, timeout, session-environment, or renderer contracts.- The override constructs the delegated built-in tool with the current execution
ctx.cwd, rather than the extension factory's process directory. - A regression test executes
pwdfrom both a disposable hidden worktree root and a nested workspace package directory and observes the requested directory. - A missing requested working directory fails before the shell command can create a sentinel side effect.
- Package inventory, README guidance, and the upstream Pi 0.85.0 packaging blocker TODO are synchronized.
- Existing repository typecheck and test suites pass.
- The resolved Bash cwd TODO and temporary workaround language are removed or updated without changing unrelated historical evidence.
Approved implementation plan and gates
- Plan/specification source: user request,
docs/todos.md, and upstream Pi 0.84.4/0.85.0 source under/srv/data/opensrc/repos/github.com/earendil-works/pi/. - Exact plan: pending revised approval. Proposed: (1) create
extensions/bash-cwdas a publishable@jbcode/pi-bash-cwdpackage; (2) overridebashby preserving the host's built-in schema, metadata, rendering, and execution behavior while constructing the delegated built-in tool from the livectx.cwd; (3) move the red regression into the package and cover hidden-worktree root, nested package, and fail-before-sentinel cases; (4) add the package to workspace/package checks and root test execution; (5) document installation and compatibility, remove the resolved Bash cwd TODO, annotate historical workaround text, and add a separate TODO for removing the local override after a usable upstream release; (6) run focused package tests, packaging checks, typecheck, and the full repository suite. - Plan approval: pending after the Pi 0.85.0 blocker forced replanning. The user selected
local_overrideand thenpublishable_packagethroughask_useron 04SEP2026. - UI classification and direction approval: non-UI; no prototype gate applies.
- Risk decisions and scope: the approved Pi dependency upgrade was abandoned and fully restored after Pi 0.85.0 failed to load. No new dependency will be added. The new package remains repository-only and will not be installed, published, or added to the active global Pi environment in this task.
Ownership
| Assignment | Owner identity | Deadline | Exclusive paths | Before/after Git evidence | Outcome |
|---|---|---|---|---|---|
| Workflow setup and research | parent Pi session 01a06e08-8d07-76a7-a116-d7e3baf55b87 |
15 minutes | workflow record only | Before: clean main at 7e7cfdb; after: clean feature worktree at 5f853dc |
Complete |
| Initial dependency-plan implementation | parent Pi session 01a06e08-8d07-76a7-a116-d7e3baf55b87 |
15 minutes | package.json, bun.lock, focused test, workflow record |
Before: clean feature worktree at 9d68d5f; after: Pi 0.85.0 upgrade restored; focused red test retained unstaged |
Paused and replanned after upstream packaging blocker |
| Local override implementation | parent Pi session 01a06e08-8d07-76a7-a116-d7e3baf55b87 |
15 minutes | extensions/bash-cwd/**, scripts/bash-cwd.test.mjs removal, package.json, scripts/package-workspaces.test.mjs, README.md, docs/todos.md, docs/workflow/skill-led-development-workflow-plan.md, workflow record |
Before: feature worktree at 9d68d5f with inspected red-test changes |
Pending approval |
Verification matrix
| Surface | Command | Exit code | Outcome |
|---|---|---|---|
| Source/cache preflight | git status --short --branch; opensrc path ... |
0 | Clean source; Pi 0.84.4 and 0.85.0 source available locally. |
| Focused cwd reproduction | inline Node harness against Pi 0.84.4 | 0 (asserted buggy outcome) | Both hidden-worktree requests observed the primary checkout; a missing requested cwd still executed a sentinel command. |
| Focused cwd regression | pending repository test | pending | pending |
| Typecheck | bun run typecheck |
pending | pending |
| Full tests | bun run test |
pending | pending |
| Fresh-process integration | pending | pending | pending |
Review
- Base and product HEAD: pending
- Clean status and tree hash: pending
- Commit list: pending
- Exact diff command: pending
- SHA-256: pending
- Mutator identities: parent Pi session
01a06e08-8d07-76a7-a116-d7e3baf55b87 - Standards reviewer identity, digest confirmation, and verdict: pending
- Specification reviewer identity, digest confirmation, and verdict: pending
- Findings and remediation cycles: Pi 0.85.0 includes the upstream
ctx.cwdcorrection but its public package imports undeclared@earendil-works/pi-server, causingERR_MODULE_NOT_FOUND. The user rejected adding that dependency and selected a repository-owned override. The attempted catalog/lock upgrade was restored; a focused red test remains as inspected uncommitted work pending replan approval. - Before/after reviewer Git evidence: pending
Integration and rollback
- Synchronization and re-verification: fetch/rebase onto latest
origin/main, then rerun affected and full verification if the effective tree changes. - Fast-forward result: pending
- Product and closure commits: pending
- Reachability and cleanup: pending
- Rollback strategy: before integration, delete only the isolated feature branch/worktree after proof and approval if abandoned; after integration, revert the focused dependency/test/docs product commit.
Checkpoints and blockers
- Last committed valid checkpoint: initial record commit
5f853dc - Blockers: revised exact-plan approval.
- Exact next safe action: present this revised record and ask the user to approve or reject the local-override implementation plan.