Skip to content

docs: catch up README/CLAUDE/changelog/opencode after today's merges - #112

Merged
jphein merged 1 commit into
mainfrom
docs/post-2026-05-21-merges
May 22, 2026
Merged

docs: catch up README/CLAUDE/changelog/opencode after today's merges#112
jphein merged 1 commit into
mainfrom
docs/post-2026-05-21-merges

Conversation

@jphein

@jphein jphein commented May 22, 2026

Copy link
Copy Markdown
Collaborator

Summary

Documentation sweep after today's 10 fork-side + 2 palace-daemon merges. Brings the YAML/changelog up to date, removes the pre-transfer `jphein/mempalace` references, and captures the two gotchas we hit while debugging opencode tonight.

What's in this PR

`docs/fork-changes.yaml` + regenerated `FORK_CHANGELOG.md` — 5 new entries (newest first):

ID PR Commit What
`local-palace-retired-marker` #111 `798cf14` Honor `~/.mempalace/RETIRED` marker — refuses default-path opens, surfaces retire message via MCP + CLI
`opencode-repo-config-empty-mcp` #110 `7133eee` Strip the `mcp` block from the repo `.opencode/opencode.json` — `enabled: false` wasn't being respected
`opencode-repo-mcp-drop-comment-key` #109 `637bb01` Drop `$comment` field — opencode schema rejects unknown root keys, refused to start TUI
`opencode-repo-mcp-disable-flag` #108 `47018e5` First attempt at disabling repo entry; superseded by #110
`mcp-stub-resources-prompts-list` #107 `6ca0670` Stub the two optional MCP methods so clients stop ERROR-logging on connect

`CLAUDE.md`:

  • Fork URL: `jphein/mempalace` → `techempower-org/mempalace` (post-May-2026 transfer)
  • Origin/upstream line, issue-tracker links, palace-data paragraph all reflect today's reality (postgres + pgvector behind palace-daemon; local ChromaDB retired)
  • Python venv path: `./venv/` → `./.venv/` (uv convention)

`README.md`:

  • Quickstart `git clone` URL updated (2 sites)
  • "Open upstream PRs" table row points at `techempower-org/mempalace`

`docs/integrations/opencode.md` — two new subsections capturing tonight's debug:

  • Patch target gotcha: opencode caches plugins under `/.cache/opencode/packages/` independently of the global npm install; the JP-PATCH must apply there, not to `/.npm-global/lib/...`. The previous patches looked applied but had no effect on what opencode actually ran.
  • "What looks like an error but isn't": the three stderr lines that surfaced today (`palace-daemon: connected`, `routing → local palace`, `HNSW capacity divergence`) explained — including which are fixed by today's merges vs. which mean your repo checkout is stale.
  • Plus a troubleshooting block: when MCP `mempalace_status` and CLI `mempalace status` disagree on drawer count, you're hitting two different palaces.

Test plan

🤖 Generated with Claude Code

…merges

Five PRs landed today that didn't have YAML entries yet; CLAUDE.md +
README still referenced the pre-transfer jphein/mempalace ownership;
the opencode integration recipe didn't cover the two gotchas that
bit us tonight (npm-vs-opencode-cache patch target; the "looks like
an error" stderr lines from local-palace spawns).

YAML additions (newest first):
  - local-palace-retired-marker (#111798cf14)
  - opencode-repo-config-empty-mcp (#1107133eee)
  - opencode-repo-mcp-drop-comment-key (#109637bb01)
  - opencode-repo-mcp-disable-flag (#10847018e5; superseded by #110)
  - mcp-stub-resources-prompts-list (#1076ca0670)

CLAUDE.md changes:
  - Fork URL: `jphein/mempalace` → `techempower-org/mempalace`
  - Origin/upstream line reflects the May 2026 transfer
  - Palace data section: local palace is retired; production lives in
    postgres on disks.jphe.in
  - Python venv: `./venv/` → `./.venv/` (uv convention)
  - Issue tracker links updated to techempower-org

README.md changes:
  - Quickstart and `Open upstream PRs` table use techempower-org URLs

docs/integrations/opencode.md changes:
  - New "Patch target gotcha" subsection: opencode caches plugins under
    ~/.cache/opencode/packages/ independently of the global npm install;
    patches must apply there.
  - New "What 'looks like an error' but isn't" verification subsection
    listing the three stderr lines that surfaced today during debug.
  - New "If you see a different palace count" troubleshooting block:
    palace-count divergence between MCP and CLI usually means an old
    shell without PALACE_DAEMON_URL; on this fork the local palace is
    retired so the CLI now refuses with the marker text.

FORK_CHANGELOG.md regenerated via scripts/render-docs.py. check-docs.sh
clean (29 fork hash refs resolve; only existing MemPalace#1024 pr_state warning,
unchanged).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings May 22, 2026 16:04
@jphein
jphein merged commit dc3a77b into main May 22, 2026
1 of 2 checks passed
@jphein
jphein deleted the docs/post-2026-05-21-merges branch May 22, 2026 16:05
@gemini-code-assist

Copy link
Copy Markdown

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request performs a comprehensive documentation and configuration sweep following recent infrastructure merges. It standardizes the project's fork identity, formalizes the retirement of legacy local storage, and resolves several integration gotchas encountered when using OpenCode with the new daemon-routed architecture.

Highlights

  • Documentation Updates: Updated CLAUDE.md and README.md to reflect the repository transfer to techempower-org/mempalace and updated Python environment paths to use .venv.
  • Local Palace Retirement: Implemented a retirement marker system (~/.mempalace/RETIRED) to prevent accidental usage of legacy local ChromaDB stores in favor of the new postgres-backed daemon.
  • OpenCode Integration Fixes: Cleaned up .opencode/opencode.json by removing the MCP block to prevent double-server conflicts and added troubleshooting documentation regarding plugin caching and log noise.
  • MCP Reliability: Stubbed optional MCP methods (resources/list, prompts/list) to eliminate unnecessary ERROR-level log noise in OpenCode sessions.
Ignored Files
  • Ignored by pattern: FORK_CHANGELOG.md (1)
    • FORK_CHANGELOG.md
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize the Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counterproductive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copilot AI 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.

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

@gemini-code-assist gemini-code-assist 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.

Code Review

This pull request updates the project documentation and changelog to reflect the transfer to the TechEmpower organization and the migration from a local ChromaDB store to a daemon-routed pgvector setup. Key changes include the implementation of a retired palace marker to prevent stale data access, the removal of conflicting OpenCode configurations, and the addition of stub MCP methods to reduce log noise. Review feedback correctly identified unnecessary backslash escapes in the YAML changelog that would cause rendering issues for the "$comment" field.

Comment thread docs/fork-changes.yaml
bucket: Fixed
commit: 637bb01
area: CLI
summary: "Drop \\$comment from .opencode/opencode.json — schema rejects unknown root keys"

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

medium

The backslash in \$comment appears to be an unnecessary escape for a YAML double-quoted string. Since $comment is a literal field name in the OpenCode schema, it should be documented without the backslash to ensure it renders correctly in the generated changelog.

    summary: "Drop $comment from .opencode/opencode.json — schema rejects unknown root keys"

Comment thread docs/fork-changes.yaml
area: CLI
summary: "Drop \\$comment from .opencode/opencode.json — schema rejects unknown root keys"
body: |
Commit ``47018e5`` (PR #108) added a ``\$comment`` field to

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

medium

In a YAML block scalar (|), backslashes are interpreted literally. Additionally, inside Markdown code spans (backticks), the dollar sign does not require escaping. Documenting it as \$comment will cause the documentation to display a literal backslash in the final output.

      Commit ``47018e5`` (PR #108) added a ``$comment`` field to

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.

2 participants