Skip to content

refactor(mcp): migrate consumers and documentation to 1.0 tools - #1849

Merged
phernandez merged 7 commits into
mainfrom
docs/skills-1.0-tools
Oct 24, 2026
Merged

phernandez merged 7 commits into
mainfrom
docs/skills-1.0-tools

Conversation

@phernandez

@phernandez phernandez commented Oct 24, 2026 •

Copy link
Copy Markdown
Member

Why

SPEC-35.2 introduces the 1.0 bm_* tool surface. Existing skills, prompts, integration adapters and benchmarks still taught or called legacy tools and expected their response shapes.

What Changed

  • Migrate shared skills, Claude/Codex harnesses, server instructions, prompts, manual guidance and current documentation to the new contracts; add a 1.0 migration guide.
  • Translate Hermes, OpenClaw and Tau calls and responses, fix Tau double prefixing, and migrate ChatGPT/view wrappers while preserving host-native APIs.
  • Migrate integration tests to exact reads, mutation receipts and structured refusals; preserve checksum, concurrency, locked-note and routing coverage.
  • Replace obsolete benchmark surfaces and corpus examples; archive obsolete test plans and remove the unused UI SDK.
  • Reject whitespace-only context targets and preserve legacy project-qualified permalink searches through cloud routes.

Implementation Details

Project UUIDs now use project; search uses mode, filters and items. Refusals are tool errors, not successful legacy conflict payloads. Multi-project routing stays explicit. Still-registered legacy tools retain labeled compatibility manuals; historical release and benchmark records remain unchanged.

Testing

  • just typecheck, targeted Ruff checks and git diff --check: passed.
  • just doctor: passed in its isolated temporary project.
  • Targeted MCP unit suites: 120 passed; manual tests: 57 passed; subsequent ChatGPT unit suite: 18 passed.
  • Affected MCP/bughunt/read-cache integration run: 327 passed and three failures; all three were fixed. uv run pytest test-int/mcp/test_chatgpt_tools_integration.py --no-cov -q: 11 passed. Final search/compact-search/workspace-routing and tests/mcp/test_tool_bm_search.py run: 70 passed.
  • Package checks passed for Claude, Codex, shared skills, Hermes (293 passed, 13 skipped), OpenClaw and Tau (78 passed, 4 skipped). OpenClaw real MCP integration tests: 3 passed.
  • Benchmark unit suite: 529 passed; benchmark lint/typecheck passed.
  • just package-check-pi: passed on the committed checkout, including generated-reference cleanliness, types, 15 tests and packaging. BM_LOCAL_PATH=.. just bench-agent-smoke (from benchmarks/): passed, 1/1 scripted task, run at-4550a4aaf310.

Risks / Follow-ups

  • PostgreSQL suite and paid/model-driven benchmark reruns were not run.
  • Coordinate docs-site publication and integration releases with availability of the 1.0 tools.
  • Legacy tool registry retirement remains separate from this consumer migration.

Companion docs-site PR: basicmachines-co/docs.basicmemory.com#52

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 24, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-24T17:08:50.177263Z c0ea1a7 New commits
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: cf774c89ff

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread src/basic_memory/mcp/prompts/search.py Outdated
Comment thread src/basic_memory/mcp/tools/chatgpt_tools.py Outdated
@phernandez

Copy link
Copy Markdown
Member Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f71d922ca9

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread integrations/tau/extension.py
@phernandez

Copy link
Copy Markdown
Member Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Already looking forward to the next diff.

Reviewed commit: b72c954575

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 74824569dd

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread integrations/openclaw/bm-client.ts Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f496f67907

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread src/basic_memory/mcp/tools/ranked_search.py

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d8a3344e08

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread integrations/openclaw/bm-client.ts Outdated
@phernandez
phernandez added this pull request to stack #1855 October 24, 2026 16:53
Signed-off-by: phernandez <paul@basicmachines.co>
Signed-off-by: phernandez <paul@basicmachines.co>
Signed-off-by: phernandez <paul@basicmachines.co>
Signed-off-by: phernandez <paul@basicmachines.co>
Signed-off-by: phernandez <paul@basicmachines.co>
Signed-off-by: phernandez <paul@basicmachines.co>
Signed-off-by: phernandez <paul@basicmachines.co>
@phernandez
phernandez force-pushed the docs/skills-1.0-tools branch from 41ca8ce to c0ea1a7 Compare October 24, 2026 17:06
@phernandez
phernandez merged commit bef49f4 into main Oct 24, 2026
38 checks passed
@phernandez
phernandez deleted the docs/skills-1.0-tools branch October 24, 2026 17:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant