Files
makelore/.project-docs/30-worklog/tasks/20260902-integrate-bash-tool-bridge-e81a5c6d.md
2026-09-02 12:11:04 +08:00

71 lines
3.1 KiB
Markdown

# Task: Integrate Bash tool bridge fix
## Identity
- Task ID: 20260902-integrate-bash-tool-bridge-e81a5c6d
- Mode: Integration
- Branch: main
- Worktree: /Users/inmanx/Documents/makelore
- Base commit: 6073bd6f4ce269b067b13e1eed0371b38dc2c054
- Owner: codex
- Status: Completed
## Scope
- Merge completed feature task `20260902-fix-bash-tool-bridge-9c4e7a12`
(`49112b6`) into local `main`.
- Reconcile the write-leased Pi tool-batch rule with README, canonical current
state, and the evidence index.
- Re-run focused real-process coverage, typecheck, and the production Vite build
on the integrated tree, then restart the local Makelore platform.
## Intent And Constraints
- Preserve the feature task's bounded semantics: only tools that acquire the
project write lease are serialized; read-only Pi tool batches remain parallel.
- Do not replay or mutate the user's accepted, currently stuck Conversation as a
smoke test. Use the disposable real-process regression instead.
- Merge only to local `main`; do not push, package, deploy, or alter unrelated
user changes.
- Treat production build success as proof that packaging consumes the fixed
resources, not as permission to claim an installer artifact was produced.
## Outcome
- Merged source commit `49112b6` into local `main` as merge commit `55bf80e`.
- Integrated the bounded Pi tool-batch correction: built-in `bash`, `edit`, and
`write`, plus dynamic product tools that acquire the project write lease, are
sequential within one assistant response. Read-only batches retain parallel
execution.
- Updated README, canonical current state, and the evidence index with the exact
failure mechanism and verification boundary. A production build was verified;
no installer was created, pushed, deployed, or published.
- Stopped the old development process cleanly so its already-open Agent Server
could not keep serving the pre-fix resource. The platform restart is the final
operational handoff after the integration commit.
## Verification
- Source branch: the pre-fix real-process regression reproduced the second Bash
result as `fetch failed` under a 250 ms managed-extension HTTP idle timeout.
- Source branch: 3 focused files / 9 tests, 213 full files / 1,733 tests with 3
skipped, typecheck, lint with 0 errors / 5 existing warnings, and the full
Renderer/Main/Preload/utility Vite production build passed.
- Integrated `main`: the 3 focused Pi process/extension/worker files passed all
9 tests, `pnpm run typecheck` passed, and `pnpm run build:vite` passed for all
four production targets.
- The regression verifies that a timed-out first Bash does not block the second
Bash, the second returns `SECOND_OK`, and neither result contains `fetch failed`.
## Follow-ups
- A signed installer is unnecessary to correct this source-level deadlock. Build
an installer only when release validation or distribution is requested; the
normal packaged resource path already consumes the corrected Agent Server and
v5 extension bundle.
## Promotion Candidates
- None; the relevant runtime contract and evidence were promoted during this
integration task.