Title: bug: local-to-orphan migration leaves existing governed memory unavailable through MCP · Issue #2425 · github/squad · GitHub
Open Graph Title: bug: local-to-orphan migration leaves existing governed memory unavailable through MCP · Issue #2425 · github/squad
X Title: bug: local-to-orphan migration leaves existing governed memory unavailable through MCP · Issue #2425 · github/squad
Description: Migrating an existing Squad from local to orphan leaves governed memory in the working tree while the MCP memory tools switch to the orphan branch. Previously stored memory then becomes unavailable through those tools, even though the or...
Open Graph Description: Migrating an existing Squad from local to orphan leaves governed memory in the working tree while the MCP memory tools switch to the orphan branch. Previously stored memory then becomes unavailable...
X Description: Migrating an existing Squad from local to orphan leaves governed memory in the working tree while the MCP memory tools switch to the orphan branch. Previously stored memory then becomes unavailable...
Opengraph URL: https://github.com/github/squad/issues/2425
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"bug: local-to-orphan migration leaves existing governed memory unavailable through MCP","articleBody":"Migrating an existing Squad from `local` to `orphan` leaves governed memory in the working tree while the MCP memory tools switch to the orphan branch. Previously stored memory then becomes unavailable through those tools, even though the original files remain on disk.\n\n**Affected version:** Squad CLI/SDK 1.1.0, Homebrew standalone installation on macOS. Source references below are pinned to release commit `c24da2aad2ab7576f6b68dec2bc50b2fe2dc7a8a`. This report is based on source inspection of that release and its installed bundle.\n\n**Expected behavior**\n\nExisting durable governed memory should remain available through `memory.search` after `squad upgrade --state-backend orphan`, with one authoritative store. The release's [migration documentation](https://github.com/github/squad/blob/c24da2aad2ab7576f6b68dec2bc50b2fe2dc7a8a/docs/src/content/docs/features/state-backends.md#L417) promises preservation of existing state.\n\n**Source evidence**\n\n- [`collectWorktreeState()`](https://github.com/github/squad/blob/c24da2aad2ab7576f6b68dec2bc50b2fe2dc7a8a/packages/squad-cli/src/cli/commands/migrate-backend.ts#L75) collects only `decisions.md` and `agents/\u003cname>/history.md`. It never collects `memory/` records, index, configuration, audit history, or tombstones.\n- [`migrateStateBackend()`](https://github.com/github/squad/blob/c24da2aad2ab7576f6b68dec2bc50b2fe2dc7a8a/packages/squad-cli/src/cli/commands/migrate-backend.ts#L174) nevertheless changes `stateBackend` to `orphan` after importing those selected files.\n- [`createStateMcpToolRegistry()`](https://github.com/github/squad/blob/c24da2aad2ab7576f6b68dec2bc50b2fe2dc7a8a/packages/squad-cli/src/cli/commands/state-mcp.ts#L70) obtains storage from `resolveSquadState()`. The [resolver](https://github.com/github/squad/blob/c24da2aad2ab7576f6b68dec2bc50b2fe2dc7a8a/packages/squad-sdk/src/resolution.ts#L886) selects `StateBackendStorageAdapter` for orphan storage, so MCP reads no longer consult the old filesystem memory store.\n- The same migration collector remains in the current `dev` source at the time of filing.\n\n**Reproduction scenario derived from the source**\n\n1. Start with `stateBackend: \"local\"` and a governed `LOCAL` memory written through MCP `memory.write`.\n2. Confirm that MCP `memory.search` can find it.\n3. Run `squad upgrade --state-backend orphan` and reconnect the MCP session so it resolves the new backend.\n4. Search for that memory through MCP again.\n\nThe record and index remain under the on-disk `.squad/memory/`, while MCP now reads `squad-state:memory/...`. The migration never imported the pre-existing memory. `squad sync --push` only synchronizes existing state refs; it does not import those filesystem files.\n\n**Scope**\n\nThis is a visibility/authority migration defect, not a claim that the old files are deleted. This report does not require transient logs, scratch files, or sessions to migrate.\n\nThis is distinct from #2316 / #2317: making CLI and MCP use the same configured store does not transfer existing local memory when changing backends. Any migration should preserve existing destination state and retain the source until a successful transfer is established.\n","author":{"url":"https://github.com/dat-intellis","@type":"Person","name":"dat-intellis"},"datePublished":"2026-11-08T21:07:30Z","url":"https://github.com/github/squad/issues/2425"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:f94c1d17-8d17-9d0e-3bae-c250167d1ed1 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | DB1E:26ECEB:1823F38:1EC70F3:6B012C62 |
| html-safe-nonce | c8986a5cfd781ef92264ecaa470d73ef7c8a9fa24fbc900f372e3e2522093c9e |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJEQjFFOjI2RUNFQjoxODIzRjM4OjFFQzcwRjM6NkIwMTJDNjIiLCJ2aXNpdG9yX2lkIjoiNjc4MTAzMTcxNzQ3OTE5Nzc5NCIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9 |
| visitor-hmac | 6f2e20a2c01a501c84f0a0c555e63d60c837b202247a12f835d98be3880aa55d |
| hovercard-subject-tag | issue:6275640381 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/github/squad/2425/issue_layout |
| twitter:image | https://opengraph.githubassets.com/742b72f044f853bcd063257eef075043fdd2a9458a0d50dcbccb6c0ce351a461/github/squad/issues/2425 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/742b72f044f853bcd063257eef075043fdd2a9458a0d50dcbccb6c0ce351a461/github/squad/issues/2425 |
| og:image:alt | Migrating an existing Squad from local to orphan leaves governed memory in the working tree while the MCP memory tools switch to the orphan branch. Previously stored memory then becomes unavailable... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | dat-intellis |
| hostname | github.com |
| expected-hostname | github.com |
| None | cc5dfdd32f62ebd3223cab3af3aa2b268d3605218237326a48a99d1efd89495c |
| turbo-cache-control | no-preview |
| go-import | github.com/github/squad git https://github.com/github/squad.git |
| octolytics-dimension-user_id | 9919 |
| octolytics-dimension-user_login | github |
| octolytics-dimension-repository_id | 1151205052 |
| octolytics-dimension-repository_nwo | github/squad |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 1151205052 |
| octolytics-dimension-repository_network_root_nwo | github/squad |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 8c77c9e8439031ad54c75a250694842892f693e1 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width