Move a database that bd 1.2.x auto-migrated back to a 1.1.2-compatible workspace, keeping all data
The 1.2.0/1.2.1 releases migrated existing databases to schema v65
automatically, on any command — including reads. If your database was
migrated and you want to go back to bd 1.1.2 (whose binaries refuse a v65
database with schema version mismatch: database is at v65, binary knows up to v53), this runbook rebuilds a 1.1.2-compatible workspace from a full
export. It is written to be executable by an agent as-is.There is no in-place down-migration. The procedure is export → set aside →
fresh init → import. If you only need the 1.1 line to open the database
again, the cursor rollback in
Accidental v1.2.1 Release is shorter
and keeps the Dolt history in place.What survives (verified): issues with statuses and close reasons,
dependencies, comments, notes, labels, memories, and wisps (with
--all).
What does not: Dolt commit history and the events/telemetry audit
tables. Both remain readable in the set-aside .beads.v65.bak directory —
nothing is deleted.
Run every step with the binaries it names: the EXPORT runs under the 1.2.x
binary that matches the database; the INIT and IMPORT run under the 1.1.2
binary you are returning to. Mixing them up fails closed (schema-skew guard),
but re-running the whole sequence from the top is the only supported retry.
Preconditions
Stop anything that writes to this workspace — supervisors, watchers,
hooks on a timer.
Server mode: stop the dolt sql-server serving this database
(bd dolt stop, or stop the process that owns it). For a SHARED server
database, coordinate with the other clients first — after this procedure
they must re-clone or run it too; do not un-migrate a shared database
unilaterally.
Install (or locate) a bd 1.1.2 binary alongside the current one. GitHub
releases: tag v1.1.2. Keep both paths handy; the steps name which one to
use.
Run from the directory that CONTAINS .beads/.
Procedure
# 1. Full export, with the 1.2.x binary the database currently matches.bd export --all -o snapshot.jsonl# Sanity: the file is non-empty and its line count is plausible for# your workspace.wc -l snapshot.jsonl# 2. Set the migrated workspace aside. Salvage-first: rename, never delete.mv .beads .beads.v65.bak# 3. Fresh init under the 1.1.2 binary (creates a v53-schema workspace).# Use the same issue prefix as before.bd-1.1.2 init --prefix <your-prefix># 4. Import the snapshot under the 1.1.2 binary.bd-1.1.2 import snapshot.jsonl
Verify
# Counts match your expectations (compare against the export):bd-1.1.2 list -n 0 --status all | tail -3# A known issue round-trips with its comments/labels/deps:bd-1.1.2 show <some-known-id># Memories survived:bd-1.1.2 memories | head
If anything is missing, the migrated original is intact in .beads.v65.bak:
restore it with mv .beads .beads.failed && mv .beads.v65.bak .beads and use
a 1.2.x binary with it while you retry.
Afterwards
Keep .beads.v65.bak until you are confident; it holds the Dolt history
and audit tables the import does not carry.
Pin your install to 1.1.2 until a release whose default does not migrate
your database is available; see the release notes of the version that sent
you here.
If this workspace had a Dolt remote, the remote still holds the MIGRATED
history. Do not push the rebuilt workspace over it without deciding which
side is canonical; a fresh remote is the simple safe choice.
⌘I
{"docsConfig":{"theme":"linden","$schema":"https://mintlify.com/docs.json","name":"Beads Documentation","colors":{"primary":"#2e8555","light":"#3cad6e","dark":"#29784c"},"logo":{"light":"https://mintcdn.com/beads/YXx_fI6ZwwnOb98c/images/logo.svg?fit=max\u0026auto=format\u0026n=YXx_fI6ZwwnOb98c\u0026q=85\u0026s=30d41ea3e997e8f84bd1cb7ade9eaa07","dark":"https://mintcdn.com/beads/YXx_fI6ZwwnOb98c/images/logo.svg?fit=max\u0026auto=format\u0026n=YXx_fI6ZwwnOb98c\u0026q=85\u0026s=30d41ea3e997e8f84bd1cb7ade9eaa07"},"favicon":"https://mintcdn.com/beads/YXx_fI6ZwwnOb98c/images/favicon.svg?fit=max\u0026auto=format\u0026n=YXx_fI6ZwwnOb98c\u0026q=85\u0026s=b6df642d15e33f80a74ec5f1d5689961","navbar":{"links":[{"icon":"github","href":"https://github.com/gastownhall/beads","label":"GitHub"},{"href":"https://www.npmjs.com/package/@beads/bd","label":"npm"}]},"styling":{"latex":false},"background":{"color":{"light":"#f9fbfa","dark":"#0b0e0e"}},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"beads","hasAudioNarration":false,"actualSubdomain":"beads","customDomains":["beads.gascity.com"],"gitSource":{"type":"github","owner":"gastownhall","repo":"beads","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6b00b171964ab5c3f5ff2f18","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Reference","count":131},{"language":"default","tag":"CLI Reference","count":119},{"language":"default","tag":"Integrations","count":19},{"language":"default","tag":"Recovery","count":11},{"language":"default","tag":"Core Concepts","count":9},{"language":"default","tag":"Getting Started","count":6},{"language":"default","tag":"Multi-Agent","count":6},{"language":"default","tag":"Workflows","count":6},{"language":"default","tag":"Architecture","count":2},{"language":"default","tag":"Community","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"recovery/unmigrate-schema-v65","slug":"/recovery/unmigrate-schema-v65","pageMetadata":{"title":"Un-migrate from Schema v65","description":"Move a database that bd 1.2.x auto-migrated back to a 1.1.2-compatible workspace, keeping all data","href":"/recovery/unmigrate-schema-v65"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Move a database that bd 1.2.x auto-migrated back to a 1.1.2-compatible workspace, keeping all data\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`The 1.2.0/1.2.1 releases migrated existing databases to schema v65\nautomatically, on any command — including reads. If your database was\nmigrated and you want to go back to bd 1.1.2 (whose binaries refuse a v65\ndatabase with `,_jsx(_components.code,{children:`schema version mismatch: database is at v65, binary knows up to v53`}),`), this runbook rebuilds a 1.1.2-compatible workspace from a full\nexport. It is written to be executable by an agent as-is.`]}),`\n`,_jsxs(_components.p,{children:[`There is no in-place down-migration. The procedure is export → set aside →\nfresh init → import. If you only need the 1.1 line to open the database\nagain, the cursor rollback in\n`,_jsx(_components.a,{href:`/recovery/accidental-1-2-1-release`,children:`Accidental v1.2.1 Release`}),` is shorter\nand keeps the Dolt history in place.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`What survives`}),` (verified): issues with statuses and close reasons,\ndependencies, comments, notes, labels, memories, and wisps (with\n`,_jsx(_components.code,{children:`--all`}),`).\n`,_jsx(_components.strong,{children:`What does not`}),`: Dolt commit history and the events/telemetry audit\ntables. Both remain readable in the set-aside `,_jsx(_components.code,{children:`.beads.v65.bak`}),` directory —\nnothing is deleted.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Run every step with the binaries it names: the EXPORT runs under the 1.2.x\nbinary that matches the database; the INIT and IMPORT run under the 1.1.2\nbinary you are returning to. Mixing them up fails closed (schema-skew guard),\nbut re-running the whole sequence from the top is the only supported retry.`})}),`\n`,_jsx(Heading,{level:`2`,id:`preconditions`,children:`Preconditions`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Stop anything that writes to this workspace`}),` — supervisors, watchers,\nhooks on a timer.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Server mode: stop the dolt sql-server`}),` serving this database\n(`,_jsx(_components.code,{children:`bd dolt stop`}),`, or stop the process that owns it). For a SHARED server\ndatabase, coordinate with the other clients first — after this procedure\nthey must re-clone or run it too; do not un-migrate a shared database\nunilaterally.`]}),`\n`,_jsxs(_components.li,{children:[`Install (or locate) a `,_jsx(_components.strong,{children:`bd 1.1.2 binary`}),` alongside the current one. GitHub\nreleases: tag `,_jsx(_components.code,{children:`v1.1.2`}),`. Keep both paths handy; the steps name which one to\nuse.`]}),`\n`,_jsxs(_components.li,{children:[`Run from the directory that CONTAINS `,_jsx(_components.code,{children:`.beads/`}),`.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`procedure`,children:`Procedure`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`15`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`15`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# 1. Full export, with the 1.2.x binary the database currently matches.`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`bd`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` export`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --all`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -o`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` snapshot.jsonl`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Sanity: the file is non-empty and its line count is plausible for`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# your workspace.`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`wc`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -l`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` snapshot.jsonl`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# 2. Set the migrated workspace aside. Salvage-first: rename, never delete.`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`mv`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` .beads`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` .beads.v65.bak`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# 3. Fresh init under the 1.1.2 binary (creates a v53-schema workspace).`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Use the same issue prefix as before.`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`bd-1.1.2`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` init`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --prefix`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`your-prefi`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`x`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# 4. Import the snapshot under the 1.1.2 binary.`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`bd-1.1.2`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` import`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` snapshot.jsonl`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`verify`,children:`Verify`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Counts match your expectations (compare against the export):`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`bd-1.1.2`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` list`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -n`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 0`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --status`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` all`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` |`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` tail`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -3`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# A known issue round-trips with its comments/labels/deps:`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`bd-1.1.2`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` show`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`some-known-i`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`d`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Memories survived:`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`bd-1.1.2`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` memories`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` |`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` head`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`If anything is missing, the migrated original is intact in `,_jsx(_components.code,{children:`.beads.v65.bak`}),`:\nrestore it with `,_jsx(_components.code,{children:`mv .beads .beads.failed \u0026\u0026 mv .beads.v65.bak .beads`}),` and use\na 1.2.x binary with it while you retry.`]}),`\n`,_jsx(Heading,{level:`2`,id:`afterwards`,children:`Afterwards`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Keep `,_jsx(_components.code,{children:`.beads.v65.bak`}),` until you are confident; it holds the Dolt history\nand audit tables the import does not carry.`]}),`\n`,_jsx(_components.li,{children:`Pin your install to 1.1.2 until a release whose default does not migrate\nyour database is available; see the release notes of the version that sent\nyou here.`}),`\n`,_jsx(_components.li,{children:`If this workspace had a Dolt remote, the remote still holds the MIGRATED\nhistory. Do not push the rebuilt workspace over it without deciding which\nside is canonical; a fresh remote is the simple safe choice.`}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Un-migrate from Schema v65","description":"Move a database that bd 1.2.x auto-migrated back to a 1.1.2-compatible workspace, keeping all data","href":"/recovery/unmigrate-schema-v65"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Preconditions","slug":"preconditions","depth":2,"children":[]},{"title":"Procedure","slug":"procedure","depth":2,"children":[]},{"title":"Verify","slug":"verify","depth":2,"children":[]},{"title":"Afterwards","slug":"afterwards","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"beads","siteName":"Beads Documentation","title":"Un-migrate from Schema v65 - Beads Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-08T08:34:06.840Z","originalFileLocation":"recovery/unmigrate-schema-v65.md"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Move a database that bd 1.2.x auto-migrated back to a 1.1.2-compatible workspace, keeping all data\">\u003cmeta data-mint-head name=\"application-name\" content=\"Beads Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/beads/cJ_miYdT2liAG70b/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/beads/cJ_miYdT2liAG70b/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/beads/cJ_miYdT2liAG70b/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/beads/cJ_miYdT2liAG70b/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/beads/cJ_miYdT2liAG70b/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/beads/cJ_miYdT2liAG70b/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/beads/cJ_miYdT2liAG70b/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/beads/cJ_miYdT2liAG70b/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/beads/cJ_miYdT2liAG70b/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Un-migrate from Schema v65 - Beads Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Move a database that bd 1.2.x auto-migrated back to a 1.1.2-compatible workspace, keeping all data\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Beads Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://beads.gascity.com/recovery/unmigrate-schema-v65\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://beads.mintlify.site/_mintlify/api/og/v2?division=Recovery\u0026amp;title=Un-migrate+from+Schema+v65\u0026amp;description=Move+a+database+that+bd+1.2.x+auto-migrated+back+to+a+1.1.2-compatible+workspace%2C+keeping+all+data\u0026amp;theme=6834af2a4bd690d76b0e1ab8\u0026amp;signature=983ce51d8765ceab3eb953cefdfea681833629a32aebe3e8a4a502d151a7cdeb\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Un-migrate from Schema v65 - Beads Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Move a database that bd 1.2.x auto-migrated back to a 1.1.2-compatible workspace, keeping all data\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://beads.mintlify.site/_mintlify/api/og/v2?division=Recovery\u0026amp;title=Un-migrate+from+Schema+v65\u0026amp;description=Move+a+database+that+bd+1.2.x+auto-migrated+back+to+a+1.1.2-compatible+workspace%2C+keeping+all+data\u0026amp;theme=6834af2a4bd690d76b0e1ab8\u0026amp;signature=983ce51d8765ceab3eb953cefdfea681833629a32aebe3e8a4a502d151a7cdeb\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/beads/cJ_miYdT2liAG70b/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Beads Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2e8555\">\u003clink data-mint-head rel=\"canonical\" href=\"https://beads.gascity.com/recovery/unmigrate-schema-v65\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/recovery/unmigrate-schema-v65.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://beads.gascity.com/#organization\",\"name\":\"Beads Documentation\",\"url\":\"https://beads.gascity.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/beads/YXx_fI6ZwwnOb98c/images/logo.svg?fit=max\u0026auto=format\u0026n=YXx_fI6ZwwnOb98c\u0026q=85\u0026s=30d41ea3e997e8f84bd1cb7ade9eaa07\"}},{\"@type\":\"WebSite\",\"@id\":\"https://beads.gascity.com#website\",\"name\":\"Beads Documentation\",\"url\":\"https://beads.gascity.com\",\"publisher\":{\"@id\":\"https://beads.gascity.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://beads.gascity.com/recovery/unmigrate-schema-v65#webpage\",\"url\":\"https://beads.gascity.com/recovery/unmigrate-schema-v65\",\"name\":\"Un-migrate from Schema v65\",\"description\":\"Move a database that bd 1.2.x auto-migrated back to a 1.1.2-compatible workspace, keeping all data\",\"dateModified\":\"2026-10-08T08:34:06.840Z\",\"isPartOf\":{\"@id\":\"https://beads.gascity.com#website\"},\"breadcrumb\":{\"@id\":\"https://beads.gascity.com/recovery/unmigrate-schema-v65#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://beads.gascity.com/recovery/unmigrate-schema-v65#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Recovery\",\"item\":\"https://beads.gascity.com/recovery\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Un-migrate from Schema v65\",\"item\":\"https://beads.gascity.com/recovery/unmigrate-schema-v65\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://beads.gascity.com/recovery/unmigrate-schema-v65#article\",\"headline\":\"Un-migrate from Schema v65\",\"name\":\"Un-migrate from Schema v65\",\"description\":\"Move a database that bd 1.2.x auto-migrated back to a 1.1.2-compatible workspace, keeping all data\",\"url\":\"https://beads.gascity.com/recovery/unmigrate-schema-v65\",\"mainEntityOfPage\":{\"@id\":\"https://beads.gascity.com/recovery/unmigrate-schema-v65#webpage\"},\"dateModified\":\"2026-10-08T08:34:06.840Z\",\"publisher\":{\"@id\":\"https://beads.gascity.com/#organization\"},\"isPartOf\":{\"@id\":\"https://beads.gascity.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Beads Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Beads Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/recovery/unmigrate-schema-v65.md","siteName":"Beads Documentation","nav":{"global":null,"groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":"/index"},{"title":"Installation","href":"/getting-started/installation"},{"title":"Quick Start","href":"/getting-started/quickstart"},{"title":"IDE Setup","href":"/getting-started/ide-setup"},{"title":"Sync Setup Guide","href":"/getting-started/sync-setup"},{"title":"Upgrading","href":"/getting-started/upgrading"}]},{"group":"Core Concepts","pages":[{"title":"How Beads Works","href":"/core-concepts/index"},{"title":"Issues \u0026 Dependencies","href":"/core-concepts/issues"},{"title":"Dependencies and Gates","href":"/core-concepts/dependencies"},{"title":"Hash-based IDs","href":"/core-concepts/hash-ids"},{"title":"Adaptive ID Length","href":"/core-concepts/adaptive-ids"},{"title":"Graph Links in Beads","href":"/core-concepts/graph-links"},{"title":"Sync Concepts","href":"/core-concepts/sync-concepts"},{"title":"Labels","href":"/core-concepts/labels"},{"title":"Issue Metadata","href":"/core-concepts/metadata"}]},{"group":"Architecture","pages":[{"title":"Architecture Overview","href":"/architecture/index"},{"title":"Dolt Backend for Beads","href":"/architecture/dolt"}]},{"group":"Workflows","pages":[{"title":"Workflows","href":"/workflows/index"},{"title":"Molecules","href":"/workflows/molecules"},{"title":"Formulas","href":"/workflows/formulas"},{"title":"Gates","href":"/workflows/gates"},{"title":"Wisps","href":"/workflows/wisps"},{"title":"TODO Command","href":"/workflows/todo"}]},{"group":"Recovery","pages":[{"title":"Recovery Overview","href":"/recovery/index"},{"title":"Accidental v1.2.1 Release","href":"/recovery/accidental-1-2-1-release"},{"title":"Recovery Playbooks","href":"/recovery/init-safety"},{"title":"Database Corruption","href":"/recovery/database-corruption"},{"title":"Schema-Encoding Drift","href":"/recovery/schema-encoding-drift"},{"title":"Merge Conflicts","href":"/recovery/merge-conflicts"},{"title":"Circular Dependencies","href":"/recovery/circular-dependencies"},{"title":"Sync Failures","href":"/recovery/sync-failures"},{"title":"History Bloat","description":"Shed reachable Dolt history that dolt gc cannot reclaim","href":"/recovery/history-squash"},{"title":"Un-migrate from Schema v65","href":"/recovery/unmigrate-schema-v65"},{"title":"Uninstalling","description":"Remove beads from a repository with bd admin reset, uninstall git hooks, and delete the bd binary after backing up issue data","href":"/recovery/uninstalling"}]},{"group":"Multi-Agent","pages":[{"title":"Multi-Agent","href":"/multi-agent/index"},{"title":"Multi-Repo Routing","href":"/multi-agent/routing"},{"title":"Agent Coordination","href":"/multi-agent/coordination"},{"title":"Federation Setup Guide","href":"/multi-agent/federation"},{"title":"Bucket Federation Quickstart","href":"/multi-agent/bucket-federation"},{"title":"Multi-Repo Migration Guide","href":"/multi-agent/multi-repo-migration"}]},{"group":"Integrations","pages":[{"title":"Integrations","href":"/integrations/index"},{"title":"Aider","href":"/integrations/aider"},{"title":"Claude Code","href":"/integrations/claude-code"},{"title":"Beads Claude Code Plugin","href":"/integrations/claude-code-plugin"},{"title":"Codex","href":"/integrations/codex"},{"title":"Sourcegraph Cody","href":"/integrations/cody"},{"title":"Cursor","href":"/integrations/cursor"},{"title":"Factory.ai Droid","href":"/integrations/factory"},{"title":"Gemini CLI","href":"/integrations/gemini"},{"title":"Junie","href":"/integrations/junie"},{"title":"Kilo Code","href":"/integrations/kilocode"},{"title":"Kiro CLI","href":"/integrations/kiro"},{"title":"Mux","href":"/integrations/mux"},{"title":"OpenCode","href":"/integrations/opencode"},{"title":"Windsurf","href":"/integrations/windsurf"},{"title":"MCP Server","href":"/integrations/mcp-server"},{"title":"GitHub Copilot","href":"/integrations/github-copilot"},{"title":"GitHub Copilot CLI Integration Design","href":"/integrations/copilot-cli"},{"title":"Azure DevOps (ADO) Integration Configuration","href":"/integrations/azure-devops"}]},{"group":"Community","pages":[{"title":"Community Tools","href":"/community-tools"},{"title":"Related Projects","href":"/related-projects"}]},{"group":"Reference","pages":[{"title":"Reference","href":"/reference/index"},{"title":"Configuration","href":"/reference/configuration"},{"title":"Git Integration","href":"/reference/git-integration"},{"title":"Git Worktrees Guide","href":"/reference/worktrees"},{"title":"Protected Branches","href":"/reference/protected-branches"},{"title":"Advanced Features","href":"/reference/advanced"},{"title":"JSON Output Schema Contract","href":"/reference/json-schema"},{"title":"Events Journal","href":"/reference/events-journal"},{"title":"Observability (OpenTelemetry)","href":"/reference/observability"},{"title":"Troubleshooting","href":"/reference/troubleshooting"},{"title":"Antivirus False Positives","href":"/reference/antivirus"},{"title":"FAQ","href":"/reference/faq"},{"group":"CLI Reference","pages":[{"title":"CLI Reference","href":"/cli-reference/index"},{"title":"bd admin","href":"/cli-reference/admin"},{"title":"bd ado","href":"/cli-reference/ado"},{"title":"bd assign","href":"/cli-reference/assign"},{"title":"bd audit","href":"/cli-reference/audit"},{"title":"bd backup","href":"/cli-reference/backup"},{"title":"bd batch","href":"/cli-reference/batch"},{"title":"bd blocked","href":"/cli-reference/blocked"},{"title":"bd bootstrap","href":"/cli-reference/bootstrap"},{"title":"bd branch","href":"/cli-reference/branch"},{"title":"bd children","href":"/cli-reference/children"},{"title":"bd close","href":"/cli-reference/close"},{"title":"bd comment","href":"/cli-reference/comment"},{"title":"bd comments","href":"/cli-reference/comments"},{"title":"bd compact","href":"/cli-reference/compact"},{"title":"bd completion","href":"/cli-reference/completion"},{"title":"bd config","href":"/cli-reference/config"},{"title":"bd conflicts","href":"/cli-reference/conflicts"},{"title":"bd context","href":"/cli-reference/context"},{"title":"bd cook","href":"/cli-reference/cook"},{"title":"bd count","href":"/cli-reference/count"},{"title":"bd create-form","href":"/cli-reference/create-form"},{"title":"bd create","href":"/cli-reference/create"},{"title":"bd defer","href":"/cli-reference/defer"},{"title":"bd delete","href":"/cli-reference/delete"},{"title":"bd dep","href":"/cli-reference/dep"},{"title":"bd diff","href":"/cli-reference/diff"},{"title":"bd doctor","href":"/cli-reference/doctor"},{"title":"bd dolt","href":"/cli-reference/dolt"},{"title":"bd duplicate","href":"/cli-reference/duplicate"},{"title":"bd duplicates","href":"/cli-reference/duplicates"},{"title":"bd edit","href":"/cli-reference/edit"},{"title":"bd epic","href":"/cli-reference/epic"},{"title":"bd events","href":"/cli-reference/events"},{"title":"bd export","href":"/cli-reference/export"},{"title":"bd federation","href":"/cli-reference/federation"},{"title":"bd find-duplicates","href":"/cli-reference/find-duplicates"},{"title":"bd flatten","href":"/cli-reference/flatten"},{"title":"bd forget","href":"/cli-reference/forget"},{"title":"bd formula","href":"/cli-reference/formula"},{"title":"bd gate","href":"/cli-reference/gate"},{"title":"bd gc","href":"/cli-reference/gc"},{"title":"bd github","href":"/cli-reference/github"},{"title":"bd gitlab","href":"/cli-reference/gitlab"},{"title":"bd graph","href":"/cli-reference/graph"},{"title":"bd heartbeat","href":"/cli-reference/heartbeat"},{"title":"bd history","href":"/cli-reference/history"},{"title":"bd hooks","href":"/cli-reference/hooks"},{"title":"bd human","href":"/cli-reference/human"},{"title":"bd import","href":"/cli-reference/import"},{"title":"bd info","href":"/cli-reference/info"},{"title":"bd init-safety","href":"/cli-reference/init-safety"},{"title":"bd init","href":"/cli-reference/init"},{"title":"bd jira","href":"/cli-reference/jira"},{"title":"bd kv","href":"/cli-reference/kv"},{"title":"bd label","href":"/cli-reference/label"},{"title":"bd linear","href":"/cli-reference/linear"},{"title":"bd link","href":"/cli-reference/link"},{"title":"bd lint","href":"/cli-reference/lint"},{"title":"bd list","href":"/cli-reference/list"},{"title":"bd mail","href":"/cli-reference/mail"},{"title":"bd memories","href":"/cli-reference/memories"},{"title":"bd merge-slot","href":"/cli-reference/merge-slot"},{"title":"bd metrics","href":"/cli-reference/metrics"},{"title":"bd migrate-personal","href":"/cli-reference/migrate-personal"},{"title":"bd migrate","href":"/cli-reference/migrate"},{"title":"bd mol","href":"/cli-reference/mol"},{"title":"bd note","href":"/cli-reference/note"},{"title":"bd notion","href":"/cli-reference/notion"},{"title":"bd onboard","href":"/cli-reference/onboard"},{"title":"bd orphans","href":"/cli-reference/orphans"},{"title":"bd ping","href":"/cli-reference/ping"},{"title":"bd preflight","href":"/cli-reference/preflight"},{"title":"bd prime","href":"/cli-reference/prime"},{"title":"bd priority","href":"/cli-reference/priority"},{"title":"bd promote","href":"/cli-reference/promote"},{"title":"bd provenance","href":"/cli-reference/provenance"},{"title":"bd prune","href":"/cli-reference/prune"},{"title":"bd purge","href":"/cli-reference/purge"},{"title":"bd q","href":"/cli-reference/q"},{"title":"bd query","href":"/cli-reference/query"},{"title":"bd quickstart","href":"/cli-reference/quickstart"},{"title":"bd ready","href":"/cli-reference/ready"},{"title":"bd recall","href":"/cli-reference/recall"},{"title":"bd reclaim","href":"/cli-reference/reclaim"},{"title":"bd recompute-blocked","href":"/cli-reference/recompute-blocked"},{"title":"bd remember","href":"/cli-reference/remember"},{"title":"bd rename-prefix","href":"/cli-reference/rename-prefix"},{"title":"bd rename","href":"/cli-reference/rename"},{"title":"bd reopen","href":"/cli-reference/reopen"},{"title":"bd repo","href":"/cli-reference/repo"},{"title":"bd restore","href":"/cli-reference/restore"},{"title":"bd rules","href":"/cli-reference/rules"},{"title":"bd schema","href":"/cli-reference/schema"},{"title":"bd search","href":"/cli-reference/search"},{"title":"bd serve","href":"/cli-reference/serve"},{"title":"bd set-state","href":"/cli-reference/set-state"},{"title":"bd setup","href":"/cli-reference/setup"},{"title":"bd ship","href":"/cli-reference/ship"},{"title":"bd show","href":"/cli-reference/show"},{"title":"bd sql","href":"/cli-reference/sql"},{"title":"bd stale","href":"/cli-reference/stale"},{"title":"bd state","href":"/cli-reference/state"},{"title":"bd status","href":"/cli-reference/status"},{"title":"bd statuses","href":"/cli-reference/statuses"},{"title":"bd supersede","href":"/cli-reference/supersede"},{"title":"bd swarm","href":"/cli-reference/swarm"},{"title":"bd sync","href":"/cli-reference/sync"},{"title":"bd tag","href":"/cli-reference/tag"},{"title":"bd todo","href":"/cli-reference/todo"},{"title":"bd types","href":"/cli-reference/types"},{"title":"bd unclaim","href":"/cli-reference/unclaim"},{"title":"bd undefer","href":"/cli-reference/undefer"},{"title":"bd update","href":"/cli-reference/update"},{"title":"bd upgrade","href":"/cli-reference/upgrade"},{"title":"bd vc","href":"/cli-reference/vc"},{"title":"bd version","href":"/cli-reference/version"},{"title":"bd where","href":"/cli-reference/where"},{"title":"bd worktree","href":"/cli-reference/worktree"}]}]}]},"basePath":"","title":"Un-migrate from Schema v65 - Beads Documentation","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}