From 271a86eabbb8e9149de2ce7075bbe4f1b54d1609 Mon Sep 17 00:00:00 2001 From: duiguangbin810 <69414133+duiguangbin810@users.noreply.github.com> Date: Thu, 28 May 2026 13:54:56 +0800 Subject: [PATCH] docs: fix stale links and add missing CHANGELOGs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Fix typo "stauts" → "status" in stream.test.ts comment - Update frontmatter.ts link to packages/utils/src/ (moved from coding-agent) - Update notebook.ts link to src/edit/ (moved from src/tools/) - Mark removed bash-normalize.ts in docs and update description - Add CHANGELOG.md for swarm-extension and utils packages Co-Authored-By: Claude Opus 4.7 --- docs/bash-tool-runtime.md | 4 ++-- docs/notebook-tool-runtime.md | 4 ++-- docs/rulebook-matching-pipeline.md | 2 +- packages/ai/test/stream.test.ts | 2 +- packages/swarm-extension/CHANGELOG.md | 3 +++ packages/utils/CHANGELOG.md | 3 +++ 6 files changed, 12 insertions(+), 6 deletions(-) create mode 100644 packages/swarm-extension/CHANGELOG.md create mode 100644 packages/utils/CHANGELOG.md diff --git a/docs/bash-tool-runtime.md b/docs/bash-tool-runtime.md index f0b7ba6fa..4fc506533 100644 --- a/docs/bash-tool-runtime.md +++ b/docs/bash-tool-runtime.md @@ -27,7 +27,7 @@ Both eventually use `executeBash()` in `src/exec/bash-executor.ts` for non-PTY e - rejects `async: true` when `async.enabled` is false, - uses only explicit `head`/`tail` tool args for post-run filtering. -`normalizeBashCommand()` still exists in `src/tools/bash-normalize.ts`, but `BashTool.execute()` does not call it in the current source. Trailing shell pipes such as `| head -n 50` remain part of the shell command unless the caller uses the structured `head`/`tail` args. +`normalizeBashCommand()` was previously in `src/tools/bash-normalize.ts` but has been removed. Trailing shell pipes such as `| head -n 50` remain part of the shell command unless the caller uses the structured `head`/`tail` args. ## 2) Optional interception (blocked-command path) @@ -256,7 +256,7 @@ This component is wired by `CommandController.handleBashCommand()` and fed from ## Implementation files - [`src/tools/bash.ts`](../packages/coding-agent/src/tools/bash.ts) — tool entrypoint, input handling/interception, async and PTY/non-PTY selection, result/error mapping, bash tool renderer. -- [`src/tools/bash-normalize.ts`](../packages/coding-agent/src/tools/bash-normalize.ts) — post-run head/tail filtering; also contains an unused command-normalization helper. +- ~~`src/tools/bash-normalize.ts`~~ — removed (post-run head/tail filtering is now handled inline). - [`src/tools/bash-interceptor.ts`](../packages/coding-agent/src/tools/bash-interceptor.ts) — interceptor rule matching and blocked-command messages. - [`src/exec/bash-executor.ts`](../packages/coding-agent/src/exec/bash-executor.ts) — non-PTY executor, shell session reuse, cancellation wiring, output sink integration. - [`src/tools/bash-interactive.ts`](../packages/coding-agent/src/tools/bash-interactive.ts) — PTY runtime, overlay UI, input normalization, non-interactive env defaults. diff --git a/docs/notebook-tool-runtime.md b/docs/notebook-tool-runtime.md index ad65d7976..cc33e3f9d 100644 --- a/docs/notebook-tool-runtime.md +++ b/docs/notebook-tool-runtime.md @@ -6,7 +6,7 @@ The critical distinction: **`notebook` is a JSON notebook editor, not a notebook ## Implementation files -- [`src/tools/notebook.ts`](../packages/coding-agent/src/tools/notebook.ts) +- [`src/edit/notebook.ts`](../packages/coding-agent/src/edit/notebook.ts) - [`src/eval/py/executor.ts`](../packages/coding-agent/src/eval/py/executor.ts) - [`src/eval/py/kernel.ts`](../packages/coding-agent/src/eval/py/kernel.ts) - [`src/session/streaming-output.ts`](../packages/coding-agent/src/session/streaming-output.ts) @@ -14,7 +14,7 @@ The critical distinction: **`notebook` is a JSON notebook editor, not a notebook ## 1) Runtime boundary: editing vs executing -## `notebook` tool (`src/tools/notebook.ts`) +## `notebook` tool (`src/edit/notebook.ts`) - Supports `action: edit | insert | delete` on a `.ipynb` file. - Resolves path relative to session CWD (`resolveToCwd`). diff --git a/docs/rulebook-matching-pipeline.md b/docs/rulebook-matching-pipeline.md index a9aca7d40..3e731102d 100644 --- a/docs/rulebook-matching-pipeline.md +++ b/docs/rulebook-matching-pipeline.md @@ -20,7 +20,7 @@ It reflects the current implementation, including partial semantics and metadata - [`../src/sdk.ts`](../packages/coding-agent/src/sdk.ts) - [`../src/system-prompt.ts`](../packages/coding-agent/src/system-prompt.ts) - [`../src/internal-urls/rule-protocol.ts`](../packages/coding-agent/src/internal-urls/rule-protocol.ts) -- [`../src/utils/frontmatter.ts`](../packages/coding-agent/src/utils/frontmatter.ts) +- [`../src/utils/frontmatter.ts`](../packages/utils/src/frontmatter.ts) ## 1. Canonical rule shape diff --git a/packages/ai/test/stream.test.ts b/packages/ai/test/stream.test.ts index 5ea4b06e6..53f844956 100644 --- a/packages/ai/test/stream.test.ts +++ b/packages/ai/test/stream.test.ts @@ -1187,7 +1187,7 @@ describe("Generate E2E Tests", () => { it( "should handle thinking mode", async () => { - // FIXME Skip for now, getting a 422 stauts code, need to test with official SDK + // FIXME Skip for now, getting a 422 status code, need to test with official SDK // const llm = getModel("mistral", "magistral-medium-latest"); // await handleThinking(llm, { reasoningEffort: "medium" }); }, diff --git a/packages/swarm-extension/CHANGELOG.md b/packages/swarm-extension/CHANGELOG.md new file mode 100644 index 000000000..1a588142c --- /dev/null +++ b/packages/swarm-extension/CHANGELOG.md @@ -0,0 +1,3 @@ +# Changelog + +## [Unreleased] diff --git a/packages/utils/CHANGELOG.md b/packages/utils/CHANGELOG.md new file mode 100644 index 000000000..1a588142c --- /dev/null +++ b/packages/utils/CHANGELOG.md @@ -0,0 +1,3 @@ +# Changelog + +## [Unreleased]