[lihongyuan99]

Summary

AGENTS.md pointed at module paths that no longer exist, so an agent following the doc would open files that are not there. Each replacement below was checked by resolving the path against src/octop/ on develop 4c3bf764:

stale in AGENTS.md	actual
infra/db/_base	infra/db/repos/_base.py
infra/gateway/processor.py	infra/gateway/process/processor.py (GlobalProcessor at :127)
api/errors.py	api/app.py _install_exception_handlers() (:77)
cli/run_cmd.py, cli/init_cmd.py, cli/backup_cmd.py, cli/*_cmd.py	cli/commands/run.py, cli/commands/init.py, cli/commands/backup.py, cli/commands/*.py
infra/gateway/threads.py row's api/routers/chat.py	api/routers/chat/ (package)
infra/agents/manager.py (bare)	infra/agents/manager.py (AgentManager.start at :887)

The database paragraph said "bump the version assertion in tests/unit/db/test_db_pool.py (currently v == 7)". The literal was wrong twice over while this PR was open (v == 16 → v == 17), so it now points at the test that pins the number instead of restating it.

After rebasing, every src/octop/**.py path referenced in AGENTS.md resolves — machine-checked with a regex pass over the file against the working tree, which reports zero unresolvable references.

Target branch

develop (checked per CONTRIBUTING: main only takes releases/hotfixes).

Type of change

• Documentation only change

Test plan

Rebased onto origin/develop 4c3bf764; AGENTS.md is the only file in the diff (git diff --stat origin/develop..HEAD → 1 file changed, 12 insertions(+), 11 deletions(-)).

• uv run ruff check src tests → All checks passed!
• uv run ruff format --check src tests → 1074 files already formatted
• uv run mypy src/octop → Success: no issues found in 527 source files
• uv run pytest -q -m "not live" -n auto → 3820 passed, 18 skipped, 20 warnings in 211.02s
• Path-resolution check over AGENTS.md: stale .py references after rebase = NONE

No shell script or CLI surface is touched, so there is no bash 3.2 / 5.x behaviour difference to report; the two conflicted hunks were resolved by keeping every develop line (including the new infra/history/ row) and re-applying only the path corrections.

Checklist

• My code follows the style of this repository
• I have performed a self-review of my code
• Documentation-only change: no tests required
• I have updated the CHANGELOG if this change is user visible — N/A, internal module paths

[jubaoliang]

修 AGENTS.md 过期路径方向好，但有一处必须改：

文中把 schema 断言写成 v == 16，当前 develop 已是 v == 17（tests/unit/db/test_db_pool.py）。请改成 17（或改成「见该测试文件当前断言」以免再过期），再合。

[lihongyuan99]

Done in 06b8920 — instead of v == 17 I dropped the literal and pointed at the test that pins it, since the number moved from 16 to 17 while this PR was open. Happy to switch back to the explicit 17 if you'd rather see it spelled out.