gina 0.3.13-alpha.2 → 0.3.13

package/.playwright-mcp/page-2026-05-14T02-28-37-939Z.yml

@@ -0,0 +1,2061 @@
+- generic [ref=e2]:
+  - region "Skip to main content":
+    - link "Skip to main content" [ref=e3] [cursor=pointer]:
+      - /url: "#__docusaurus_skipToContent_fallback"
+  - navigation "Main" [ref=e4]:
+    - generic [ref=e5]:
+      - generic [ref=e6]:
+        - link "Gina logo Gina" [ref=e7] [cursor=pointer]:
+          - /url: /docs/
+          - img "Gina logo" [ref=e9]
+          - generic [ref=e10]: Gina
+        - link "Docs" [ref=e11] [cursor=pointer]:
+          - /url: /docs/intro
+        - link "Tutorials" [ref=e12] [cursor=pointer]:
+          - /url: /docs/tutorials
+        - link "Templating" [ref=e13] [cursor=pointer]:
+          - /url: /docs/templating/
+        - link "Roadmap" [ref=e14] [cursor=pointer]:
+          - /url: /docs/roadmap
+      - generic [ref=e15]:
+        - generic [ref=e17]:
+          - link "Changelog" [ref=e18] [cursor=pointer]:
+            - /url: https://github.com/gina-io/gina/releases
+            - text: v0.3.12
+          - link "GitHub repository" [ref=e19] [cursor=pointer]:
+            - /url: https://github.com/gina-io/gina
+            - img [ref=e20]
+          - link "npm package (stable)" [ref=e22] [cursor=pointer]:
+            - /url: https://www.npmjs.com/package/gina/v/0.3.12
+            - img [ref=e23]
+        - generic "light mode" [ref=e26] [cursor=pointer]:
+          - checkbox "Switch between dark and light mode (currently light mode)" [disabled]
+          - generic [ref=e27]:
+            - generic [ref=e28]: ☾
+            - generic [ref=e29]: ☀
+        - textbox "Search" [ref=e32]
+  - generic [ref=e35]:
+    - complementary [ref=e36]:
+      - navigation "Docs sidebar" [ref=e39]:
+        - list [ref=e40]:
+          - listitem [ref=e41]:
+            - link "What is Gina?" [ref=e42] [cursor=pointer]:
+              - /url: /docs/intro
+              - generic "What is Gina?" [ref=e43]
+          - listitem [ref=e44]:
+            - generic [ref=e45]:
+              - link "Getting Started" [ref=e46] [cursor=pointer]:
+                - /url: /docs/getting-started
+                - generic "Getting Started" [ref=e47]
+              - button "Expand sidebar category 'Getting Started'" [ref=e48] [cursor=pointer]
+          - listitem [ref=e49]:
+            - generic [ref=e50]:
+              - link "Concepts" [ref=e51] [cursor=pointer]:
+                - /url: /docs/concepts
+                - generic "Concepts" [ref=e52]
+              - button "Expand sidebar category 'Concepts'" [ref=e53] [cursor=pointer]
+          - listitem [ref=e54]:
+            - generic [ref=e55]:
+              - link "Guides" [ref=e56] [cursor=pointer]:
+                - /url: /docs/guides
+                - generic "Guides" [ref=e57]
+              - button "Expand sidebar category 'Guides'" [ref=e58] [cursor=pointer]
+          - listitem [ref=e59]:
+            - generic [ref=e60]:
+              - link "CLI Reference" [ref=e61] [cursor=pointer]:
+                - /url: /docs/cli
+                - generic "CLI Reference" [ref=e62]
+              - button "Collapse sidebar category 'CLI Reference'" [expanded] [ref=e63] [cursor=pointer]
+            - list [ref=e64]:
+              - listitem [ref=e65]:
+                - link "bundle" [ref=e66] [cursor=pointer]:
+                  - /url: /docs/cli/cli-bundle
+                  - generic "bundle" [ref=e67]
+              - listitem [ref=e68]:
+                - link "project" [ref=e69] [cursor=pointer]:
+                  - /url: /docs/cli/cli-project
+                  - generic "project" [ref=e70]
+              - listitem [ref=e71]:
+                - link "framework" [ref=e72] [cursor=pointer]:
+                  - /url: /docs/cli/cli-framework
+                  - generic "framework" [ref=e73]
+              - listitem [ref=e74]:
+                - link "env" [ref=e75] [cursor=pointer]:
+                  - /url: /docs/cli/cli-env
+                  - generic "env" [ref=e76]
+              - listitem [ref=e77]:
+                - link "port" [ref=e78] [cursor=pointer]:
+                  - /url: /docs/cli/cli-port
+                  - generic "port" [ref=e79]
+              - listitem [ref=e80]:
+                - link "scope" [ref=e81] [cursor=pointer]:
+                  - /url: /docs/cli/cli-scope
+                  - generic "scope" [ref=e82]
+              - listitem [ref=e83]:
+                - link "view" [ref=e84] [cursor=pointer]:
+                  - /url: /docs/cli/cli-view
+                  - generic "view" [ref=e85]
+              - listitem [ref=e86]:
+                - link "cache" [ref=e87] [cursor=pointer]:
+                  - /url: /docs/cli/cli-cache
+                  - generic "cache" [ref=e88]
+              - listitem [ref=e89]:
+                - link "protocol" [ref=e90] [cursor=pointer]:
+                  - /url: /docs/cli/cli-protocol
+                  - generic "protocol" [ref=e91]
+              - listitem [ref=e92]:
+                - link "service" [ref=e93] [cursor=pointer]:
+                  - /url: /docs/cli/cli-service
+                  - generic "service" [ref=e94]
+              - listitem [ref=e95]:
+                - link "connector" [ref=e96] [cursor=pointer]:
+                  - /url: /docs/cli/cli-connector
+                  - generic "connector" [ref=e97]
+          - listitem [ref=e98]:
+            - generic [ref=e99]:
+              - link "Configuration Reference" [ref=e100] [cursor=pointer]:
+                - /url: /docs/reference/
+                - generic "Configuration Reference" [ref=e101]
+              - button "Expand sidebar category 'Configuration Reference'" [ref=e102] [cursor=pointer]
+          - listitem [ref=e103]:
+            - generic [ref=e104]:
+              - link "API Reference" [ref=e105] [cursor=pointer]:
+                - /url: /docs/api
+                - generic "API Reference" [ref=e106]
+              - button "Expand sidebar category 'API Reference'" [ref=e107] [cursor=pointer]
+          - listitem [ref=e108]:
+            - generic [ref=e109]:
+              - link "Globals" [ref=e110] [cursor=pointer]:
+                - /url: /docs/globals
+                - generic "Globals" [ref=e111]
+              - button "Expand sidebar category 'Globals'" [ref=e112] [cursor=pointer]
+          - listitem [ref=e113]:
+            - link "Security" [ref=e114] [cursor=pointer]:
+              - /url: /docs/security
+              - generic "Security" [ref=e115]
+          - listitem [ref=e116]:
+            - link "Migration Guide" [ref=e117] [cursor=pointer]:
+              - /url: /docs/migration
+              - generic "Migration Guide" [ref=e118]
+    - main [ref=e119]:
+      - generic [ref=e121]:
+        - generic [ref=e123]:
+          - article [ref=e124]:
+            - navigation "Breadcrumbs" [ref=e125]:
+              - list [ref=e126]:
+                - listitem [ref=e127]:
+                  - link "Home page" [ref=e128] [cursor=pointer]:
+                    - /url: /docs/
+                    - img [ref=e129]
+                - listitem [ref=e131]:
+                  - link "CLI Reference" [ref=e132] [cursor=pointer]:
+                    - /url: /docs/cli
+                - listitem [ref=e133]:
+                  - generic [ref=e134]: connector
+            - generic [ref=e135]:
+              - heading "connector" [level=1] [ref=e137]
+              - generic [ref=e138]:
+                - generic [ref=e139]:
+                  - generic [ref=e140]:
+                    - img [ref=e141]
+                    - text: 14 min read
+                  - generic [ref=e144]: Intermediate
+                - generic [ref=e145]:
+                  - generic [ref=e146]: Prerequisites
+                  - list [ref=e147]:
+                    - listitem [ref=e148]:
+                      - link "Gina installed globally" [ref=e149] [cursor=pointer]:
+                        - /url: /docs/getting-started/installation
+                    - listitem [ref=e150]:
+                      - link "connectors.json reference" [ref=e151] [cursor=pointer]:
+                        - /url: /docs/reference/connectors
+                    - listitem [ref=e152]:
+                      - link "Projects and bundles" [ref=e153] [cursor=pointer]:
+                        - /url: /docs/concepts/projects-and-bundles
+              - paragraph [ref=e154]:
+                - text: The
+                - code [ref=e155]: connector
+                - text: command group inspects and maintains
+                - code [ref=e156]: connectors.json
+                - text: across a project's
+                - code [ref=e157]: shared/config/
+                - text: and each bundle's
+                - code [ref=e158]: config/
+                - text: directory. It reports the effective overlay that every bundle sees at runtime, adds or removes entries, and lints / auto-fixes common schema drift. Every subcommand is
+                - strong [ref=e159]: offline
+                - text: — no framework socket or network call.
+              - list [ref=e160]:
+                - listitem [ref=e161]:
+                  - strong [ref=e162]:
+                    - code [ref=e163]: connector:list
+                  - text: — read-only inventory of every declared connector, with driver install status and version-pin warnings.
+                - listitem [ref=e164]:
+                  - strong [ref=e165]:
+                    - code [ref=e166]: connector:add
+                  - text: — write a connector entry to shared or bundle scope, with driver install hint.
+                - listitem [ref=e167]:
+                  - strong [ref=e168]:
+                    - code [ref=e169]: connector:rm
+                  - text: (alias
+                  - code [ref=e170]: connector:remove
+                  - text: ) — remove a connector entry; prints retention hints, never touches
+                  - code [ref=e171]: node_modules/
+                  - text: .
+                - listitem [ref=e172]:
+                  - strong [ref=e173]:
+                    - code [ref=e174]: connector:migrate
+                  - text: — lint every
+                  - code [ref=e175]: connectors.json
+                  - text: for schema drift, optionally fix in place with
+                  - code [ref=e176]: "--fix"
+                  - text: .
+              - separator [ref=e177]
+              - heading "connector:listDirect link to connectorlist" [level=2] [ref=e178]:
+                - code [ref=e179]: connector:list
+                - link "Direct link to connectorlist" [ref=e180] [cursor=pointer]:
+                  - /url: "#connectorlist"
+                  - text: "#"
+              - paragraph [ref=e181]:
+                - emphasis [ref=e182]: New in 0.3.7-alpha.2
+              - paragraph [ref=e183]: List connectors for every registered project, a single project, or the merged view a single bundle sees at runtime.
+              - code [ref=e187]:
+                - generic [ref=e188]: "gina connector:list # Every registered project"
+                - generic [ref=e189]: "gina connector:list @<project> # One project (shared + all bundles)"
+                - generic [ref=e190]: "gina connector:list <bundle> @<project> # Merged shared+bundle view for <bundle>"
+              - paragraph [ref=e191]:
+                - strong [ref=e192]: Flags
+              - table [ref=e193]:
+                - rowgroup [ref=e194]:
+                  - row "Flag Description" [ref=e195]:
+                    - columnheader "Flag" [ref=e196]
+                    - columnheader "Description" [ref=e197]
+                - rowgroup [ref=e198]:
+                  - row "--format=json Emit a JSON payload instead of the human-readable text table" [ref=e199]:
+                    - cell "--format=json" [ref=e200]:
+                      - code [ref=e201]: "--format=json"
+                    - cell "Emit a JSON payload instead of the human-readable text table" [ref=e202]
+              - heading "OutputDirect link to Output" [level=3] [ref=e203]:
+                - text: Output
+                - link "Direct link to Output" [ref=e204] [cursor=pointer]:
+                  - /url: "#output"
+                  - text: "#"
+              - code [ref=e208]:
+                - generic [ref=e209]: "------------------------------------"
+                - generic [ref=e210]: myproject
+                - generic [ref=e211]: "------------------------------------"
+                - generic [ref=e212]: "[ ok ] session couchbase [shared] (couchbase@>=3.0.0 4.1.3 installed)"
+                - generic [ref=e213]: "[ ok ] profile couchbase [api] (couchbase@>=3.0.0 4.1.3 installed)"
+                - generic [ref=e214]: "[ ok ] session couchbase [api override] (couchbase@>=3.0.0 4.1.3 installed)"
+                - generic [ref=e215]: "[ ?! ] mongodb mongodb [admin] (mongodb@>=5.0.0 — run `npm install mongodb`)"
+                - generic [ref=e216]: "[ ok ] local sqlite [worker] (Node.js >= 22.5.0 built-in (node:sqlite))"
+              - paragraph [ref=e217]:
+                - strong [ref=e218]: Row columns
+              - table [ref=e219]:
+                - rowgroup [ref=e220]:
+                  - row "Column Meaning" [ref=e221]:
+                    - columnheader "Column" [ref=e222]
+                    - columnheader "Meaning" [ref=e223]
+                - rowgroup [ref=e224]:
+                  - row "[ ok ] / [ ?! ] / [ ?? ] Install status (see below)" [ref=e225]:
+                    - cell "[ ok ] / [ ?! ] / [ ?? ]" [ref=e226]:
+                      - strong [ref=e227]:
+                        - code [ref=e228]: "[ ok ]"
+                        - text: /
+                        - code [ref=e229]: "[ ?! ]"
+                        - text: /
+                        - code [ref=e230]: "[ ?? ]"
+                    - cell "Install status (see below)" [ref=e231]
+                  - row "name Logical connector key (JSON object key in connectors.json)" [ref=e232]:
+                    - cell "name" [ref=e233]:
+                      - strong [ref=e234]: name
+                    - cell "Logical connector key (JSON object key in connectors.json)" [ref=e235]:
+                      - text: Logical connector key (JSON object key in
+                      - code [ref=e236]: connectors.json
+                      - text: )
+                  - row "connector Driver type resolved from entry.connector (falls back to the logical key)" [ref=e237]:
+                    - cell "connector" [ref=e238]:
+                      - strong [ref=e239]: connector
+                    - cell "Driver type resolved from entry.connector (falls back to the logical key)" [ref=e240]:
+                      - text: Driver type resolved from
+                      - code [ref=e241]: entry.connector
+                      - text: (falls back to the logical key)
+                  - 'row "source label Where the entry comes from: [shared], [<bundle>], or [<bundle> override]" [ref=e242]':
+                    - cell "source label" [ref=e243]:
+                      - strong [ref=e244]: source label
+                    - 'cell "Where the entry comes from: [shared], [<bundle>], or [<bundle> override]" [ref=e245]':
+                      - text: "Where the entry comes from:"
+                      - code [ref=e246]: "[shared]"
+                      - text: ","
+                      - code [ref=e247]: "[<bundle>]"
+                      - text: ", or"
+                      - code [ref=e248]: "[<bundle> override]"
+                  - row "driver info Resolved npm package, peerDependencies range, pinned version (if any), install state" [ref=e249]:
+                    - cell "driver info" [ref=e250]:
+                      - strong [ref=e251]: driver info
+                    - cell "Resolved npm package, peerDependencies range, pinned version (if any), install state" [ref=e252]:
+                      - text: Resolved npm package,
+                      - code [ref=e253]: peerDependencies
+                      - text: range, pinned version (if any), install state
+              - paragraph [ref=e254]:
+                - strong [ref=e255]: Status flags
+              - table [ref=e256]:
+                - rowgroup [ref=e257]:
+                  - row "Flag Meaning" [ref=e258]:
+                    - columnheader "Flag" [ref=e259]
+                    - columnheader "Meaning" [ref=e260]
+                - rowgroup [ref=e261]:
+                  - row "[ ok ] Driver installed at <project>/node_modules/<driver>, or built-in (node:sqlite)" [ref=e262]:
+                    - cell "[ ok ]" [ref=e263]:
+                      - code [ref=e264]: "[ ok ]"
+                    - cell "Driver installed at <project>/node_modules/<driver>, or built-in (node:sqlite)" [ref=e265]:
+                      - text: Driver installed at
+                      - code [ref=e266]: <project>/node_modules/<driver>
+                      - text: ", or built-in ("
+                      - code [ref=e267]: node:sqlite
+                      - text: )
+                  - row "[ ?! ] Driver declared but not found — npm install <driver> suggested inline" [ref=e268]:
+                    - cell "[ ?! ]" [ref=e269]:
+                      - code [ref=e270]: "[ ?! ]"
+                    - cell "Driver declared but not found — npm install <driver> suggested inline" [ref=e271]:
+                      - text: Driver declared but not found —
+                      - code [ref=e272]: npm install <driver>
+                      - text: suggested inline
+                  - row "[ ?? ] Unknown connector type, or ai connector with missing/unrecognised protocol" [ref=e273]:
+                    - cell "[ ?? ]" [ref=e274]:
+                      - code [ref=e275]: "[ ?? ]"
+                    - cell "Unknown connector type, or ai connector with missing/unrecognised protocol" [ref=e276]:
+                      - text: Unknown connector type, or
+                      - code [ref=e277]: ai
+                      - text: connector with missing/unrecognised
+                      - code [ref=e278]: protocol
+                  - row "[ !! ] Version-pin disagreement — emitted as a trailing warning line when two bundles pin the same driver at different versions (the first npm install wins)" [ref=e279]:
+                    - cell "[ !! ]" [ref=e280]:
+                      - code [ref=e281]: "[ !! ]"
+                    - cell "Version-pin disagreement — emitted as a trailing warning line when two bundles pin the same driver at different versions (the first npm install wins)" [ref=e282]:
+                      - text: Version-pin disagreement — emitted as a trailing warning line when two bundles pin the same driver at different versions (the first
+                      - code [ref=e283]: npm install
+                      - text: wins)
+              - paragraph [ref=e284]:
+                - strong [ref=e285]: Source labels
+              - table [ref=e286]:
+                - rowgroup [ref=e287]:
+                  - row "Label Meaning" [ref=e288]:
+                    - columnheader "Label" [ref=e289]
+                    - columnheader "Meaning" [ref=e290]
+                - rowgroup [ref=e291]:
+                  - row "[shared] Declared only in shared/config/connectors.json" [ref=e292]:
+                    - cell "[shared]" [ref=e293]:
+                      - code [ref=e294]: "[shared]"
+                    - cell "Declared only in shared/config/connectors.json" [ref=e295]:
+                      - text: Declared only in
+                      - code [ref=e296]: shared/config/connectors.json
+                  - row "[<bundle>] Declared only in the bundle's config/connectors.json" [ref=e297]:
+                    - cell "[<bundle>]" [ref=e298]:
+                      - code [ref=e299]: "[<bundle>]"
+                    - cell "Declared only in the bundle's config/connectors.json" [ref=e300]:
+                      - text: Declared only in the bundle's
+                      - code [ref=e301]: config/connectors.json
+                  - row "[<bundle> override] Declared in shared and overridden by the bundle — the merged entry (bundle wins on conflicting keys) is shown" [ref=e302]:
+                    - cell "[<bundle> override]" [ref=e303]:
+                      - code [ref=e304]: "[<bundle> override]"
+                    - cell "Declared in shared and overridden by the bundle — the merged entry (bundle wins on conflicting keys) is shown" [ref=e305]:
+                      - text: Declared in
+                      - code [ref=e306]: shared
+                      - strong [ref=e307]: and
+                      - text: overridden by the bundle — the merged entry (bundle wins on conflicting keys) is shown
+              - heading "JSON outputDirect link to JSON output" [level=3] [ref=e308]:
+                - text: JSON output
+                - link "Direct link to JSON output" [ref=e309] [cursor=pointer]:
+                  - /url: "#json-output"
+                  - text: "#"
+              - code [ref=e313]:
+                - generic [ref=e314]: gina connector:list @<project> --format=json
+              - code [ref=e318]:
+                - generic [ref=e319]: "{"
+                - generic [ref=e320]: "\"project\": \"myproject\","
+                - generic [ref=e321]: "\"status\": \"ok\","
+                - generic [ref=e322]: "\"connectors\": ["
+                - generic [ref=e323]: "{"
+                - generic [ref=e324]: "\"project\": \"myproject\","
+                - generic [ref=e325]: "\"bundle\": \"api\","
+                - generic [ref=e326]: "\"name\": \"session\","
+                - generic [ref=e327]: "\"connector\": \"couchbase\","
+                - generic [ref=e328]: "\"source\": \"override\","
+                - generic [ref=e329]: "\"driver\": \"couchbase\","
+                - generic [ref=e330]: "\"builtin\": false,"
+                - generic [ref=e331]: "\"range\": \">=3.0.0\","
+                - generic [ref=e332]: "\"version\": null,"
+                - generic [ref=e333]: "\"installed\": true,"
+                - generic [ref=e334]: "\"installedVersion\": \"4.1.3\","
+                - generic [ref=e335]: "\"note\": null,"
+                - generic [ref=e336]: "\"unresolved\": false"
+                - generic [ref=e337]: "}"
+                - generic [ref=e338]: "]"
+                - generic [ref=e339]: "}"
+              - table [ref=e340]:
+                - rowgroup [ref=e341]:
+                  - row "Field Description" [ref=e342]:
+                    - columnheader "Field" [ref=e343]
+                    - columnheader "Description" [ref=e344]
+                - rowgroup [ref=e345]:
+                  - row "project / bundle / name Project, owning bundle (null for shared-only rows), logical connector key" [ref=e346]:
+                    - cell "project / bundle / name" [ref=e347]:
+                      - code [ref=e348]: project
+                      - text: /
+                      - code [ref=e349]: bundle
+                      - text: /
+                      - code [ref=e350]: name
+                    - cell "Project, owning bundle (null for shared-only rows), logical connector key" [ref=e351]
+                  - row "connector Resolved connector type" [ref=e352]:
+                    - cell "connector" [ref=e353]:
+                      - code [ref=e354]: connector
+                    - cell "Resolved connector type" [ref=e355]
+                  - row "source \"shared\", \"bundle\", or \"override\"" [ref=e356]:
+                    - cell "source" [ref=e357]:
+                      - code [ref=e358]: source
+                    - cell "\"shared\", \"bundle\", or \"override\"" [ref=e359]:
+                      - code [ref=e360]: "\"shared\""
+                      - text: ","
+                      - code [ref=e361]: "\"bundle\""
+                      - text: ", or"
+                      - code [ref=e362]: "\"override\""
+                  - row "driver npm package name (null for built-in drivers)" [ref=e363]:
+                    - cell "driver" [ref=e364]:
+                      - code [ref=e365]: driver
+                    - cell "npm package name (null for built-in drivers)" [ref=e366]
+                  - row "builtin true when the driver is Node-builtin (e.g. node:sqlite)" [ref=e367]:
+                    - cell "builtin" [ref=e368]:
+                      - code [ref=e369]: builtin
+                    - cell "true when the driver is Node-builtin (e.g. node:sqlite)" [ref=e370]:
+                      - code [ref=e371]: "true"
+                      - text: when the driver is Node-builtin (e.g.
+                      - code [ref=e372]: node:sqlite
+                      - text: )
+                  - row "range peerDependencies range declared by the framework" [ref=e373]:
+                    - cell "range" [ref=e374]:
+                      - code [ref=e375]: range
+                    - cell "peerDependencies range declared by the framework" [ref=e376]:
+                      - code [ref=e377]: peerDependencies
+                      - text: range declared by the framework
+                  - row "version User-set version pin from the connector entry (null if unset)" [ref=e378]:
+                    - cell "version" [ref=e379]:
+                      - code [ref=e380]: version
+                    - cell "User-set version pin from the connector entry (null if unset)" [ref=e381]:
+                      - text: User-set
+                      - code [ref=e382]: version
+                      - text: pin from the connector entry (null if unset)
+                  - row "installed / installedVersion Install probe result from <project>/node_modules/<driver>/package.json" [ref=e383]:
+                    - cell "installed / installedVersion" [ref=e384]:
+                      - code [ref=e385]: installed
+                      - text: /
+                      - code [ref=e386]: installedVersion
+                    - cell "Install probe result from <project>/node_modules/<driver>/package.json" [ref=e387]:
+                      - text: Install probe result from
+                      - code [ref=e388]: <project>/node_modules/<driver>/package.json
+                  - row "note Human-readable hint for unresolved or built-in entries" [ref=e389]:
+                    - cell "note" [ref=e390]:
+                      - code [ref=e391]: note
+                    - cell "Human-readable hint for unresolved or built-in entries" [ref=e392]
+                  - row "unresolved true when no driver mapping exists for the type" [ref=e393]:
+                    - cell "unresolved" [ref=e394]:
+                      - code [ref=e395]: unresolved
+                    - cell "true when no driver mapping exists for the type" [ref=e396]:
+                      - code [ref=e397]: "true"
+                      - text: when no driver mapping exists for the type
+              - heading "Driver resolutionDirect link to Driver resolution" [level=3] [ref=e398]:
+                - text: Driver resolution
+                - link "Direct link to Driver resolution" [ref=e399] [cursor=pointer]:
+                  - /url: "#driver-resolution"
+                  - text: "#"
+              - paragraph [ref=e400]:
+                - text: Drivers are resolved from the framework's
+                - code [ref=e401]: peerDependencies
+                - text: declared in
+                - code [ref=e402]: package.json
+                - text: ":"
+              - table [ref=e403]:
+                - rowgroup [ref=e404]:
+                  - row "Connector type npm package Range" [ref=e405]:
+                    - columnheader "Connector type" [ref=e406]
+                    - columnheader "npm package" [ref=e407]
+                    - columnheader "Range" [ref=e408]
+                - rowgroup [ref=e409]:
+                  - row "couchbase couchbase >=3.0.0" [ref=e410]:
+                    - cell "couchbase" [ref=e411]:
+                      - code [ref=e412]: couchbase
+                    - cell "couchbase" [ref=e413]:
+                      - code [ref=e414]: couchbase
+                    - cell ">=3.0.0" [ref=e415]:
+                      - code [ref=e416]: ">=3.0.0"
+                  - row "redis ioredis >=5.0.0" [ref=e417]:
+                    - cell "redis" [ref=e418]:
+                      - code [ref=e419]: redis
+                    - cell "ioredis" [ref=e420]:
+                      - code [ref=e421]: ioredis
+                    - cell ">=5.0.0" [ref=e422]:
+                      - code [ref=e423]: ">=5.0.0"
+                  - row "mysql mysql2 >=2.0.0" [ref=e424]:
+                    - cell "mysql" [ref=e425]:
+                      - code [ref=e426]: mysql
+                    - cell "mysql2" [ref=e427]:
+                      - code [ref=e428]: mysql2
+                    - cell ">=2.0.0" [ref=e429]:
+                      - code [ref=e430]: ">=2.0.0"
+                  - row "postgresql pg >=8.0.0" [ref=e431]:
+                    - cell "postgresql" [ref=e432]:
+                      - code [ref=e433]: postgresql
+                    - cell "pg" [ref=e434]:
+                      - code [ref=e435]: pg
+                    - cell ">=8.0.0" [ref=e436]:
+                      - code [ref=e437]: ">=8.0.0"
+                  - row "mongodb mongodb >=5.0.0" [ref=e438]:
+                    - cell "mongodb" [ref=e439]:
+                      - code [ref=e440]: mongodb
+                    - cell "mongodb" [ref=e441]:
+                      - code [ref=e442]: mongodb
+                    - cell ">=5.0.0" [ref=e443]:
+                      - code [ref=e444]: ">=5.0.0"
+                  - row "scylladb @scylladb/scylla-driver >=1.0.0" [ref=e445]:
+                    - cell "scylladb" [ref=e446]:
+                      - code [ref=e447]: scylladb
+                    - cell "@scylladb/scylla-driver" [ref=e448]:
+                      - code [ref=e449]: "@scylladb/scylla-driver"
+                    - cell ">=1.0.0" [ref=e450]:
+                      - code [ref=e451]: ">=1.0.0"
+                  - 'row "sqlite (built-in: node:sqlite) Node ≥ 22.5.0" [ref=e452]':
+                    - cell "sqlite" [ref=e453]:
+                      - code [ref=e454]: sqlite
+                    - 'cell "(built-in: node:sqlite)" [ref=e455]':
+                      - emphasis [ref=e456]:
+                        - text: "(built-in:"
+                        - code [ref=e457]: node:sqlite
+                        - text: )
+                    - cell "Node ≥ 22.5.0" [ref=e458]
+                  - row "ai Resolved from entry.protocol See below" [ref=e459]:
+                    - cell "ai" [ref=e460]:
+                      - code [ref=e461]: ai
+                    - cell "Resolved from entry.protocol" [ref=e462]:
+                      - text: Resolved from
+                      - code [ref=e463]: entry.protocol
+                    - cell "See below" [ref=e464]
+              - paragraph [ref=e465]:
+                - text: The
+                - code [ref=e466]: ai
+                - text: connector resolves its driver from
+                - code [ref=e467]: entry.protocol
+                - text: ":"
+              - table [ref=e468]:
+                - rowgroup [ref=e469]:
+                  - row "Scheme npm package" [ref=e470]:
+                    - columnheader "Scheme" [ref=e471]
+                    - columnheader "npm package" [ref=e472]
+                - rowgroup [ref=e473]:
+                  - row "anthropic:// @anthropic-ai/sdk (>=0.27.0)" [ref=e474]:
+                    - cell "anthropic://" [ref=e475]:
+                      - code [ref=e476]: anthropic://
+                    - cell "@anthropic-ai/sdk (>=0.27.0)" [ref=e477]:
+                      - code [ref=e478]: "@anthropic-ai/sdk"
+                      - text: (
+                      - code [ref=e479]: ">=0.27.0"
+                      - text: )
+                  - row "openai://, deepseek://, qwen://, groq://, mistral://, together://, ollama://, gemini://, xai://, perplexity:// openai (>=4.0.0)" [ref=e480]:
+                    - cell "openai://, deepseek://, qwen://, groq://, mistral://, together://, ollama://, gemini://, xai://, perplexity://" [ref=e481]:
+                      - code [ref=e482]: openai://
+                      - text: ","
+                      - code [ref=e483]: deepseek://
+                      - text: ","
+                      - code [ref=e484]: qwen://
+                      - text: ","
+                      - code [ref=e485]: groq://
+                      - text: ","
+                      - code [ref=e486]: mistral://
+                      - text: ","
+                      - code [ref=e487]: together://
+                      - text: ","
+                      - code [ref=e488]: ollama://
+                      - text: ","
+                      - code [ref=e489]: gemini://
+                      - text: ","
+                      - code [ref=e490]: xai://
+                      - text: ","
+                      - code [ref=e491]: perplexity://
+                    - cell "openai (>=4.0.0)" [ref=e492]:
+                      - code [ref=e493]: openai
+                      - text: (
+                      - code [ref=e494]: ">=4.0.0"
+                      - text: )
+              - heading "Overlay semanticsDirect link to Overlay semantics" [level=3] [ref=e495]:
+                - text: Overlay semantics
+                - link "Direct link to Overlay semantics" [ref=e496] [cursor=pointer]:
+                  - /url: "#overlay-semantics"
+                  - text: "#"
+              - paragraph [ref=e497]:
+                - text: Shared and bundle-level
+                - code [ref=e498]: connectors.json
+                - text: files are merged key-level, with the bundle side winning on conflicting keys. This mirrors the runtime behaviour of
+                - code [ref=e499]: core/config.js
+                - text: ": a bundle that overrides"
+                - code [ref=e500]: session
+                - text: in its own
+                - code [ref=e501]: config/connectors.json
+                - text: does
+                - strong [ref=e502]: not
+                - text: need to restate the full entry — it inherits the shared fields and only overrides the keys it declares.
+              - paragraph [ref=e503]: "The text output emits one row per resolved entry:"
+              - list [ref=e504]:
+                - listitem [ref=e505]:
+                  - text: A shared entry with no bundle override → one
+                  - code [ref=e506]: "[shared]"
+                  - text: row.
+                - listitem [ref=e507]:
+                  - text: A shared entry that is overridden by one or more bundles → one
+                  - code [ref=e508]: "[<bundle> override]"
+                  - text: row per overriding bundle;
+                  - strong [ref=e509]:
+                    - text: no standalone
+                    - code [ref=e510]: "[shared]"
+                    - text: row
+                  - text: .
+                - listitem [ref=e511]:
+                  - text: A bundle-only entry (not in shared) →
+                  - code [ref=e512]: "[<bundle>]"
+                  - text: .
+              - heading "Comment toleranceDirect link to Comment tolerance" [level=3] [ref=e513]:
+                - text: Comment tolerance
+                - link "Direct link to Comment tolerance" [ref=e514] [cursor=pointer]:
+                  - /url: "#comment-tolerance"
+                  - text: "#"
+              - paragraph [ref=e515]:
+                - code [ref=e516]: connectors.json
+                - text: ","
+                - code [ref=e517]: manifest.json
+                - text: ", and the file headers they carry are parsed with tolerance for"
+                - code [ref=e518]: //
+                - text: line comments and
+                - code [ref=e519]: /* … */
+                - text: block comments, the same as
+                - code [ref=e520]: routing.json
+                - text: .
+              - heading "Error pathsDirect link to Error paths" [level=3] [ref=e521]:
+                - text: Error paths
+                - link "Direct link to Error paths" [ref=e522] [cursor=pointer]:
+                  - /url: "#error-paths"
+                  - text: "#"
+              - table [ref=e523]:
+                - rowgroup [ref=e524]:
+                  - row "Input Behaviour" [ref=e525]:
+                    - columnheader "Input" [ref=e526]
+                    - columnheader "Behaviour" [ref=e527]
+                - rowgroup [ref=e528]:
+                  - 'row "connector:list @unknown CmdHelper rejects: \"Project [unknown] not found in your projects list\" (exit 1)" [ref=e529]':
+                    - cell "connector:list @unknown" [ref=e530]:
+                      - code [ref=e531]: connector:list @unknown
+                    - 'cell "CmdHelper rejects: \"Project [unknown] not found in your projects list\" (exit 1)" [ref=e532]'
+                  - row "connector:list <bundle> (no @<project>) \"connector:list <bundle> requires @<project>\" (exit 1)" [ref=e533]:
+                    - cell "connector:list <bundle> (no @<project>)" [ref=e534]:
+                      - code [ref=e535]: connector:list <bundle>
+                      - text: (no
+                      - code [ref=e536]: "@<project>"
+                      - text: )
+                    - cell "\"connector:list <bundle> requires @<project>\" (exit 1)" [ref=e537]:
+                      - text: "\""
+                      - code [ref=e538]: connector:list <bundle>
+                      - text: requires
+                      - code [ref=e539]: "@<project>"
+                      - text: "\" (exit 1)"
+                  - row "connector:list bogus @<project> \"Bundle [ bogus ] is not registered inside @<project>\" (exit 1)" [ref=e540]:
+                    - cell "connector:list bogus @<project>" [ref=e541]:
+                      - code [ref=e542]: connector:list bogus @<project>
+                    - cell "\"Bundle [ bogus ] is not registered inside @<project>\" (exit 1)" [ref=e543]:
+                      - text: "\"Bundle [ bogus ] is not registered inside"
+                      - code [ref=e544]: "@<project>"
+                      - text: "\" (exit 1)"
+                  - row "connectors.json malformed Treated as \"no connectors declared\" (silently skipped — use bundle:start for strict validation)" [ref=e545]:
+                    - cell "connectors.json malformed" [ref=e546]:
+                      - code [ref=e547]: connectors.json
+                      - text: malformed
+                    - cell "Treated as \"no connectors declared\" (silently skipped — use bundle:start for strict validation)" [ref=e548]:
+                      - text: Treated as "no connectors declared" (silently skipped — use
+                      - code [ref=e549]: bundle:start
+                      - text: for strict validation)
+              - generic [ref=e550]:
+                - generic [ref=e551]:
+                  - img [ref=e553]
+                  - text: Version-pin warnings vs. install resolution
+                - paragraph [ref=e556]:
+                  - text: npm resolves
+                  - code [ref=e557]: node_modules/<driver>/
+                  - text: to a single version per project. When two bundles declare the same driver with different
+                  - code [ref=e558]: version
+                  - text: pins, the first
+                  - code [ref=e559]: npm install
+                  - text: wins and the other bundle's pin is aspirational.
+                  - code [ref=e560]: connector:list
+                  - text: flags this with a trailing
+                  - code [ref=e561]: "[ !! ] driver \\"
+                  - text: "` has conflicting `version` pins: ...` line. The actual installed version still appears on the affected rows."
+              - separator [ref=e562]
+              - heading "connector:addDirect link to connectoradd" [level=2] [ref=e563]:
+                - code [ref=e564]: connector:add
+                - link "Direct link to connectoradd" [ref=e565] [cursor=pointer]:
+                  - /url: "#connectoradd"
+                  - text: "#"
+              - paragraph [ref=e566]:
+                - emphasis [ref=e567]: New in 0.3.7-alpha.2
+              - paragraph [ref=e568]:
+                - text: Add a connector entry to a project's
+                - code [ref=e569]: shared/config/connectors.json
+                - text: or a bundle-scoped
+                - code [ref=e570]: <bundle>/config/connectors.json
+                - text: . Preserves any
+                - code [ref=e571]: //
+                - text: /
+                - code [ref=e572]: /* */
+                - text: comment header above the first
+                - code [ref=e573]: "{"
+                - text: ", serialises the body with 4-space indentation, and pins"
+                - code [ref=e574]: $schema
+                - text: at the top.
+              - code [ref=e578]:
+                - generic [ref=e579]: "gina connector:add <name> @<project> # Writes to shared/config/connectors.json"
+                - generic [ref=e580]: "gina connector:add <name> <bundle> @<project> # Writes to <bundle-src>/config/connectors.json"
+              - paragraph [ref=e581]:
+                - text: After the write, the exact install command for the matching driver is printed — e.g.
+                - code [ref=e582]: npm install ioredis@">=5.0.0"
+                - text: .
+              - heading "FlagsDirect link to Flags" [level=3] [ref=e583]:
+                - text: Flags
+                - link "Direct link to Flags" [ref=e584] [cursor=pointer]:
+                  - /url: "#flags"
+                  - text: "#"
+              - table [ref=e585]:
+                - rowgroup [ref=e586]:
+                  - row "Flag Description" [ref=e587]:
+                    - columnheader "Flag" [ref=e588]
+                    - columnheader "Description" [ref=e589]
+                - rowgroup [ref=e590]:
+                  - 'row "--connector=<type> Driver type. One of: couchbase, mysql, postgresql, sqlite, redis, ai. Inferred from <name> when <name> matches one of those values." [ref=e591]':
+                    - cell "--connector=<type>" [ref=e592]:
+                      - code [ref=e593]: "--connector=<type>"
+                    - 'cell "Driver type. One of: couchbase, mysql, postgresql, sqlite, redis, ai. Inferred from <name> when <name> matches one of those values." [ref=e594]':
+                      - text: "Driver type. One of:"
+                      - code [ref=e595]: couchbase
+                      - text: ","
+                      - code [ref=e596]: mysql
+                      - text: ","
+                      - code [ref=e597]: postgresql
+                      - text: ","
+                      - code [ref=e598]: sqlite
+                      - text: ","
+                      - code [ref=e599]: redis
+                      - text: ","
+                      - code [ref=e600]: ai
+                      - text: . Inferred from
+                      - code [ref=e601]: <name>
+                      - text: when
+                      - code [ref=e602]: <name>
+                      - text: matches one of those values.
+                  - row "--driver=<type> Synonym for --connector=." [ref=e603]:
+                    - cell "--driver=<type>" [ref=e604]:
+                      - code [ref=e605]: "--driver=<type>"
+                    - cell "Synonym for --connector=." [ref=e606]:
+                      - text: Synonym for
+                      - code [ref=e607]: "--connector="
+                      - text: .
+                  - row "--protocol=<uri> Connection protocol URI scheme (couchbase://, anthropic://, etc). Required for ai connectors." [ref=e608]:
+                    - cell "--protocol=<uri>" [ref=e609]:
+                      - code [ref=e610]: "--protocol=<uri>"
+                    - cell "Connection protocol URI scheme (couchbase://, anthropic://, etc). Required for ai connectors." [ref=e611]:
+                      - text: Connection protocol URI scheme (
+                      - code [ref=e612]: couchbase://
+                      - text: ","
+                      - code [ref=e613]: anthropic://
+                      - text: ", etc). Required for"
+                      - code [ref=e614]: ai
+                      - text: connectors.
+                  - row "--host=<host> Hostname or IP. Comma-separated for clusters (db1,db2)." [ref=e615]:
+                    - cell "--host=<host>" [ref=e616]:
+                      - code [ref=e617]: "--host=<host>"
+                    - cell "Hostname or IP. Comma-separated for clusters (db1,db2)." [ref=e618]:
+                      - text: Hostname or IP. Comma-separated for clusters (
+                      - code [ref=e619]: db1,db2
+                      - text: ).
+                  - row "--connector-port=<port> Server port. Numeric when possible. Written to the entry under the port key. See the Reserved flag names note below." [ref=e620]:
+                    - cell "--connector-port=<port>" [ref=e621]:
+                      - code [ref=e622]: "--connector-port=<port>"
+                    - cell "Server port. Numeric when possible. Written to the entry under the port key. See the Reserved flag names note below." [ref=e623]:
+                      - text: Server port. Numeric when possible. Written to the entry under the
+                      - code [ref=e624]: port
+                      - text: key. See the
+                      - strong [ref=e625]: Reserved flag names
+                      - text: note below.
+                  - row "--database=<name> Database, bucket, or keyspace name." [ref=e626]:
+                    - cell "--database=<name>" [ref=e627]:
+                      - code [ref=e628]: "--database=<name>"
+                    - cell "Database, bucket, or keyspace name." [ref=e629]
+                  - row "--username=<name> Authentication username." [ref=e630]:
+                    - cell "--username=<name>" [ref=e631]:
+                      - code [ref=e632]: "--username=<name>"
+                    - cell "Authentication username." [ref=e633]
+                  - 'row "--password=<value> Authentication password. Supports ${ENV_VAR} interpolation." [ref=e634]':
+                    - cell "--password=<value>" [ref=e635]:
+                      - code [ref=e636]: "--password=<value>"
+                    - 'cell "Authentication password. Supports ${ENV_VAR} interpolation." [ref=e637]':
+                      - text: Authentication password. Supports
+                      - code [ref=e638]: "${ENV_VAR}"
+                      - text: interpolation.
+                  - 'row "--scope=<scope> Data isolation scope: local, beta, production, testing." [ref=e639]':
+                    - cell "--scope=<scope>" [ref=e640]:
+                      - code [ref=e641]: "--scope=<scope>"
+                    - 'cell "Data isolation scope: local, beta, production, testing." [ref=e642]':
+                      - text: "Data isolation scope:"
+                      - code [ref=e643]: local
+                      - text: ","
+                      - code [ref=e644]: beta
+                      - text: ","
+                      - code [ref=e645]: production
+                      - text: ","
+                      - code [ref=e646]: testing
+                      - text: .
+                  - row "--model=<id> AI connector only. Default model id." [ref=e647]:
+                    - cell "--model=<id>" [ref=e648]:
+                      - code [ref=e649]: "--model=<id>"
+                    - cell "AI connector only. Default model id." [ref=e650]
+                  - 'row "--api-key=<value> AI connector only. API key. Supports ${ENV_VAR} interpolation." [ref=e651]':
+                    - cell "--api-key=<value>" [ref=e652]:
+                      - code [ref=e653]: "--api-key=<value>"
+                    - 'cell "AI connector only. API key. Supports ${ENV_VAR} interpolation." [ref=e654]':
+                      - text: AI connector only. API key. Supports
+                      - code [ref=e655]: "${ENV_VAR}"
+                      - text: interpolation.
+                  - row "--base-url=<url> AI connector only. Override the provider base URL (OpenAI-compatible providers)." [ref=e656]:
+                    - cell "--base-url=<url>" [ref=e657]:
+                      - code [ref=e658]: "--base-url=<url>"
+                    - cell "AI connector only. Override the provider base URL (OpenAI-compatible providers)." [ref=e659]
+                  - row "--driver-version=<range> Optional semver range to pin the driver install (e.g. ^5.0.0, >=5.3.0 <6.0.0). Written to the entry under the version key. See the Reserved flag names note below." [ref=e660]:
+                    - cell "--driver-version=<range>" [ref=e661]:
+                      - code [ref=e662]: "--driver-version=<range>"
+                    - cell "Optional semver range to pin the driver install (e.g. ^5.0.0, >=5.3.0 <6.0.0). Written to the entry under the version key. See the Reserved flag names note below." [ref=e663]:
+                      - text: Optional semver range to pin the driver install (e.g.
+                      - code [ref=e664]: ^5.0.0
+                      - text: ","
+                      - code [ref=e665]: ">=5.3.0 <6.0.0"
+                      - text: ). Written to the entry under the
+                      - code [ref=e666]: version
+                      - text: key. See the
+                      - strong [ref=e667]: Reserved flag names
+                      - text: note below.
+                  - row "--force Overwrite an existing entry with the same <name>." [ref=e668]:
+                    - cell "--force" [ref=e669]:
+                      - code [ref=e670]: "--force"
+                    - cell "Overwrite an existing entry with the same <name>." [ref=e671]:
+                      - text: Overwrite an existing entry with the same
+                      - code [ref=e672]: <name>
+                      - text: .
+                  - row "--install After writing the entry, run the detected package manager's install command for the resolved driver + range. Opt-in; default behaviour is \"write entry, print hint\". See Driver install below." [ref=e673]:
+                    - cell "--install" [ref=e674]:
+                      - code [ref=e675]: "--install"
+                    - cell "After writing the entry, run the detected package manager's install command for the resolved driver + range. Opt-in; default behaviour is \"write entry, print hint\". See Driver install below." [ref=e676]:
+                      - text: After writing the entry, run the detected package manager's install command for the resolved driver + range. Opt-in; default behaviour is "write entry, print hint". See
+                      - link "Driver install" [ref=e677] [cursor=pointer]:
+                        - /url: "#driver-install-with---install"
+                      - text: below.
+              - generic [ref=e678]:
+                - generic [ref=e679]:
+                  - img [ref=e681]
+                  - text: Reserved flag names
+                - generic [ref=e683]:
+                  - paragraph [ref=e684]: "Two CLI flags use longer names than their schema property names:"
+                  - list [ref=e685]:
+                    - listitem [ref=e686]:
+                      - strong [ref=e687]:
+                        - code [ref=e688]: "--connector-port="
+                      - text: (not
+                      - code [ref=e689]: "--port="
+                      - text: "):"
+                      - code [ref=e690]: "--port="
+                      - text: is reserved by the framework for its own socket port (8124 by default) and is intercepted by
+                      - code [ref=e691]: bin/cli
+                      - text: before the handler runs. The written JSON entry still uses the property name
+                      - code [ref=e692]: port
+                      - text: .
+                    - listitem [ref=e693]:
+                      - strong [ref=e694]:
+                        - code [ref=e695]: "--driver-version="
+                      - text: (not
+                      - code [ref=e696]: "--version="
+                      - text: "): the framework auto-converts any"
+                      - code [ref=e697]: "--<key>=<value>"
+                      - text: flag to a
+                      - code [ref=e698]: GINA_<KEY>
+                      - text: env var, so
+                      - code [ref=e699]: "--version=^5.0.0"
+                      - text: would set
+                      - code [ref=e700]: GINA_VERSION=^5.0.0
+                      - text: and trigger a framework version migration. The written JSON entry still uses the property name
+                      - code [ref=e701]: version
+                      - text: .
+                  - paragraph [ref=e702]: These aliases exist to avoid collisions with framework-level flags; the on-disk JSON shape is unchanged.
+              - heading "ExamplesDirect link to Examples" [level=3] [ref=e703]:
+                - text: Examples
+                - link "Direct link to Examples" [ref=e704] [cursor=pointer]:
+                  - /url: "#examples"
+                  - text: "#"
+              - code [ref=e708]:
+                - generic [ref=e709]: "# Shared Redis, type inferred from name"
+                - generic [ref=e710]: gina connector:add redis @myproject --host=127.0.0.1 --connector-port=6379
+                - generic [ref=e711]: "# Shared Redis under a custom name"
+                - generic [ref=e712]: gina connector:add session @myproject --connector=redis --host=127.0.0.1 --connector-port=6379
+                - generic [ref=e713]: "# Bundle-scoped MySQL entry"
+                - generic [ref=e714]: gina connector:add mydb api @myproject --connector=mysql --database=mydb --username=root
+                - generic [ref=e715]: "# AI connector with env-var secret"
+                - generic [ref=e716]: "gina connector:add ai-bot @myproject --connector=ai --protocol=anthropic:// --api-key='${ANTHROPIC_API_KEY}'"
+                - generic [ref=e717]: "# Pin driver version, overwrite existing"
+                - generic [ref=e718]: gina connector:add session @myproject --connector=redis --driver-version=^5.0.0 --force
+                - generic [ref=e719]: "# Write entry AND run `npm install ioredis@<range>` (lockfile-detected PM)"
+                - generic [ref=e720]: gina connector:add redis @myproject --install
+              - heading "OutputDirect link to Output" [level=3] [ref=e721]:
+                - text: Output
+                - link "Direct link to Output" [ref=e722] [cursor=pointer]:
+                  - /url: "#output-1"
+                  - text: "#"
+              - code [ref=e726]:
+                - generic [ref=e727]: "Added connector `redis` (redis) in bundle `api` at /path/to/project/src/api/config/connectors.json"
+                - generic [ref=e728]: "Next: run `npm install ioredis@\">=5.0.0\"` inside your project root."
+              - paragraph [ref=e729]:
+                - text: When overwriting an existing entry with
+                - code [ref=e730]: "--force"
+                - text: ", the first line reads"
+                - code [ref=e731]: Updated connector ...
+                - text: instead of
+                - code [ref=e732]: Added connector ...
+                - text: .
+              - heading "Driver install with --installDirect link to driver-install-with---install" [level=3] [ref=e733]:
+                - text: Driver install with
+                - code [ref=e734]: "--install"
+                - link "Direct link to driver-install-with---install" [ref=e735] [cursor=pointer]:
+                  - /url: "#driver-install-with---install"
+                  - text: "#"
+              - paragraph [ref=e736]:
+                - text: By default,
+                - code [ref=e737]: connector:add
+                - text: writes the entry and prints the matching
+                - code [ref=e738]: npm install …
+                - text: hint — it does
+                - strong [ref=e739]: not
+                - text: run the install for you. Pass
+                - code [ref=e740]: "--install"
+                - text: to turn that hint into an actual call, using the package manager detected from the project's lockfile.
+              - code [ref=e744]:
+                - generic [ref=e745]: gina connector:add redis @myproject --install
+              - code [ref=e749]:
+                - generic [ref=e750]: "Added connector `redis` (redis) in shared scope at /path/to/project/shared/config/connectors.json"
+                - generic [ref=e751]: "[install] detected package manager: npm (package-lock.json)"
+                - generic [ref=e752]: "[install] resolving driver range: >=5.0.0 (source: framework)"
+                - generic [ref=e753]: "[npm] running: npm install ioredis@>=5.0.0 (cwd: /path/to/project)"
+                - generic [ref=e754]: …npm output…
+              - paragraph [ref=e755]:
+                - strong [ref=e756]: Package-manager detection (lockfile probe order)
+              - paragraph [ref=e757]: "The detector walks the project root looking for a lockfile, in this order:"
+              - table [ref=e758]:
+                - rowgroup [ref=e759]:
+                  - row "Order Lockfile Package manager Install subcommand" [ref=e760]:
+                    - columnheader "Order" [ref=e761]
+                    - columnheader "Lockfile" [ref=e762]
+                    - columnheader "Package manager" [ref=e763]
+                    - columnheader "Install subcommand" [ref=e764]
+                - rowgroup [ref=e765]:
+                  - row "1 bun.lockb bun bun add <pkg>@<range>" [ref=e766]:
+                    - cell "1" [ref=e767]
+                    - cell "bun.lockb" [ref=e768]:
+                      - code [ref=e769]: bun.lockb
+                    - cell "bun" [ref=e770]
+                    - cell "bun add <pkg>@<range>" [ref=e771]:
+                      - code [ref=e772]: bun add <pkg>@<range>
+                  - row "2 pnpm-lock.yaml pnpm pnpm add <pkg>@<range>" [ref=e773]:
+                    - cell "2" [ref=e774]
+                    - cell "pnpm-lock.yaml" [ref=e775]:
+                      - code [ref=e776]: pnpm-lock.yaml
+                    - cell "pnpm" [ref=e777]
+                    - cell "pnpm add <pkg>@<range>" [ref=e778]:
+                      - code [ref=e779]: pnpm add <pkg>@<range>
+                  - row "3 yarn.lock yarn yarn add <pkg>@<range>" [ref=e780]:
+                    - cell "3" [ref=e781]
+                    - cell "yarn.lock" [ref=e782]:
+                      - code [ref=e783]: yarn.lock
+                    - cell "yarn" [ref=e784]
+                    - cell "yarn add <pkg>@<range>" [ref=e785]:
+                      - code [ref=e786]: yarn add <pkg>@<range>
+                  - row "4 package-lock.json npm npm install <pkg>@<range>" [ref=e787]:
+                    - cell "4" [ref=e788]
+                    - cell "package-lock.json" [ref=e789]:
+                      - code [ref=e790]: package-lock.json
+                    - cell "npm" [ref=e791]
+                    - cell "npm install <pkg>@<range>" [ref=e792]:
+                      - code [ref=e793]: npm install <pkg>@<range>
+                  - row "— (no lockfile) npm (fallback) npm install <pkg>@<range>" [ref=e794]:
+                    - cell "—" [ref=e795]
+                    - cell "(no lockfile)" [ref=e796]:
+                      - emphasis [ref=e797]: (no lockfile)
+                    - cell "npm (fallback)" [ref=e798]
+                    - cell "npm install <pkg>@<range>" [ref=e799]:
+                      - code [ref=e800]: npm install <pkg>@<range>
+              - paragraph [ref=e801]:
+                - text: The first match wins. When no lockfile is present, npm is the fallback — the detector logs
+                - code [ref=e802]: (fallback — no lockfile found)
+                - text: so it's visible in the output.
+              - paragraph [ref=e803]:
+                - strong [ref=e804]: Install-range resolution order
+              - paragraph [ref=e805]:
+                - text: The range that follows
+                - code [ref=e806]: "@"
+                - text: "in the install command is resolved in three tiers, first match wins:"
+              - list [ref=e807]:
+                - listitem [ref=e808]:
+                  - strong [ref=e809]:
+                    - code [ref=e810]: "--driver-version=<range>"
+                  - text: — the pin on the
+                  - code [ref=e811]: connector:add
+                  - text: call (if set). Also written to the entry under the
+                  - code [ref=e812]: version
+                  - text: key.
+                - listitem [ref=e813]:
+                  - strong [ref=e814]:
+                    - text: Project
+                    - code [ref=e815]: package.json
+                  - text: —
+                  - code [ref=e816]: dependencies
+                  - text: first, then
+                  - code [ref=e817]: devDependencies
+                  - text: . If the driver is already declared there (from a previous install), that range is reused so
+                  - code [ref=e818]: npm install
+                  - text: doesn't churn the lockfile.
+                - listitem [ref=e819]:
+                  - strong [ref=e820]:
+                    - text: Framework
+                    - code [ref=e821]: peerDependencies
+                  - text: — the range declared by gina itself (e.g.
+                  - code [ref=e822]: ioredis >=5.0.0
+                  - text: ","
+                  - code [ref=e823]: couchbase >=3.0.0
+                  - text: ).
+              - paragraph [ref=e824]:
+                - text: The resolved tier is logged as
+                - code [ref=e825]: "(source: entry | project | framework)"
+                - text: so you can see which rung fired.
+              - paragraph [ref=e826]:
+                - strong [ref=e827]:
+                  - code [ref=e828]: sqlite
+                  - text: and
+                  - code [ref=e829]: ai
+                  - text: behaviour
+              - list [ref=e830]:
+                - listitem [ref=e831]:
+                  - strong [ref=e832]:
+                    - code [ref=e833]: sqlite
+                  - text: — short-circuits. Node.js ≥ 22.5.0 ships
+                  - code [ref=e834]: node:sqlite
+                  - text: built in, so
+                  - code [ref=e835]: "--install"
+                  - text: logs
+                  - code [ref=e836]: "[install] no install needed — Node.js >= 22.5.0 built-in (node:sqlite)."
+                  - text: and exits
+                  - code [ref=e837]: "0"
+                  - text: without running anything.
+                - listitem [ref=e838]:
+                  - strong [ref=e839]:
+                    - code [ref=e840]: ai
+                  - text: with a missing or unknown
+                  - code [ref=e841]: "--protocol="
+                  - text: — exits
+                  - code [ref=e842]: "1"
+                  - text: after writing the entry. The entry is still written to disk (you can fix the protocol and re-run
+                  - code [ref=e843]: "--install"
+                  - text: separately, or install by hand). The error names the supported schemes.
+              - paragraph [ref=e844]:
+                - strong [ref=e845]: Exit codes
+              - table [ref=e846]:
+                - rowgroup [ref=e847]:
+                  - row "Scenario Exit code" [ref=e848]:
+                    - columnheader "Scenario" [ref=e849]
+                    - columnheader "Exit code" [ref=e850]
+                - rowgroup [ref=e851]:
+                  - row "Entry written, install ran, package manager exited 0 0" [ref=e852]:
+                    - cell "Entry written, install ran, package manager exited 0" [ref=e853]:
+                      - text: Entry written, install ran, package manager exited
+                      - code [ref=e854]: "0"
+                    - cell "0" [ref=e855]:
+                      - code [ref=e856]: "0"
+                  - row "Entry written, sqlite short-circuit 0" [ref=e857]:
+                    - cell "Entry written, sqlite short-circuit" [ref=e858]:
+                      - text: Entry written,
+                      - code [ref=e859]: sqlite
+                      - text: short-circuit
+                    - cell "0" [ref=e860]:
+                      - code [ref=e861]: "0"
+                  - row "Entry written, install ran, package manager exited non-zero whatever the PM returned" [ref=e862]:
+                    - cell "Entry written, install ran, package manager exited non-zero" [ref=e863]
+                    - cell "whatever the PM returned" [ref=e864]
+                  - row "Entry written, PM binary missing on PATH 127" [ref=e865]:
+                    - cell "Entry written, PM binary missing on PATH" [ref=e866]:
+                      - text: Entry written, PM binary missing on
+                      - code [ref=e867]: PATH
+                    - cell "127" [ref=e868]:
+                      - code [ref=e869]: "127"
+                  - row "Entry written, AI connector with missing/unknown protocol 1" [ref=e870]:
+                    - cell "Entry written, AI connector with missing/unknown protocol" [ref=e871]:
+                      - text: Entry written, AI connector with missing/unknown
+                      - code [ref=e872]: protocol
+                    - cell "1" [ref=e873]:
+                      - code [ref=e874]: "1"
+                  - row "Entry written, unknown connector type 1" [ref=e875]:
+                    - cell "Entry written, unknown connector type" [ref=e876]
+                    - cell "1" [ref=e877]:
+                      - code [ref=e878]: "1"
+              - generic [ref=e879]:
+                - generic [ref=e880]:
+                  - img [ref=e882]
+                  - text: Opt-in by design
+                - paragraph [ref=e885]:
+                  - code [ref=e886]: "--install"
+                  - text: is never applied by default —
+                  - code [ref=e887]: connector:add
+                  - text: always writes the entry first, then honours the flag. There is no
+                  - code [ref=e888]: "--no-install"
+                  - text: /
+                  - code [ref=e889]: "--yes"
+                  - text: counterpart, and no configuration that silently turns install into the default. If a future session needs it, the flag can be added without changing the default.
+              - heading "Version pin — where it appliesDirect link to Version pin — where it applies" [level=3] [ref=e890]:
+                - text: Version pin — where it applies
+                - link "Direct link to Version pin — where it applies" [ref=e891] [cursor=pointer]:
+                  - /url: "#version-pin--where-it-applies"
+                  - text: "#"
+              - paragraph [ref=e892]:
+                - text: The
+                - code [ref=e893]: "--driver-version="
+                - text: pin is written to the entry under the
+                - code [ref=e894]: version
+                - text: key. At install time, the printed install hint uses that pin (so
+                - code [ref=e895]: "--driver-version=^5.0.0"
+                - text: produces
+                - code [ref=e896]: npm install ioredis@"^5.0.0"
+                - text: ). When omitted, the hint falls back to the framework's
+                - code [ref=e897]: peerDependencies
+                - text: range.
+              - paragraph [ref=e898]:
+                - text: Since
+                - code [ref=e899]: npm install
+                - text: resolves a single version per project, a
+                - code [ref=e900]: version
+                - text: pin set on one bundle still affects every bundle that uses the same driver.
+                - code [ref=e901]: connector:list
+                - text: flags conflicting pins with a
+                - code [ref=e902]: "[ !! ]"
+                - text: warning — see the
+                - link "version-pin warnings note" [ref=e903] [cursor=pointer]:
+                  - /url: "#connectorlist"
+                - text: .
+              - heading "Merge behaviourDirect link to Merge behaviour" [level=3] [ref=e904]:
+                - text: Merge behaviour
+                - link "Direct link to Merge behaviour" [ref=e905] [cursor=pointer]:
+                  - /url: "#merge-behaviour"
+                  - text: "#"
+              - paragraph [ref=e906]: "The written file always has this order:"
+              - list [ref=e907]:
+                - listitem [ref=e908]:
+                  - code [ref=e909]: $schema
+                  - text: (always first; inserted with the canonical
+                  - code [ref=e910]: https://gina.io/schema/connectors.json
+                  - text: URL if none was present)
+                - listitem [ref=e911]:
+                  - text: Existing entries — key order preserved verbatim; if
+                  - code [ref=e912]: <name>
+                  - text: already exists, it is replaced in place (not moved to the bottom)
+                - listitem [ref=e913]:
+                  - text: The new entry — appended only when
+                  - code [ref=e914]: <name>
+                  - text: was not already present
+              - paragraph [ref=e915]:
+                - text: Any comment header above the first
+                - code [ref=e916]: "{"
+                - text: is preserved byte-for-byte. Mid-body
+                - code [ref=e917]: //
+                - text: or
+                - code [ref=e918]: /* */
+                - text: comments are
+                - strong [ref=e919]: lost
+                - text: on rewrite — the body is re-serialised from the parsed JSON.
+              - heading "Error pathsDirect link to Error paths" [level=3] [ref=e920]:
+                - text: Error paths
+                - link "Direct link to Error paths" [ref=e921] [cursor=pointer]:
+                  - /url: "#error-paths-1"
+                  - text: "#"
+              - table [ref=e922]:
+                - rowgroup [ref=e923]:
+                  - row "Input Behaviour" [ref=e924]:
+                    - columnheader "Input" [ref=e925]
+                    - columnheader "Behaviour" [ref=e926]
+                - rowgroup [ref=e927]:
+                  - row "connector:add with no <name> \"connector:add requires <name> and @<project>\" (exit 1)" [ref=e928]:
+                    - cell "connector:add with no <name>" [ref=e929]:
+                      - code [ref=e930]: connector:add
+                      - text: with no
+                      - code [ref=e931]: <name>
+                    - cell "\"connector:add requires <name> and @<project>\" (exit 1)" [ref=e932]:
+                      - text: "\""
+                      - code [ref=e933]: connector:add
+                      - text: requires
+                      - code [ref=e934]: <name>
+                      - text: and
+                      - code [ref=e935]: "@<project>"
+                      - text: "\" (exit 1)"
+                  - row "connector:add <name> (no @<project>) \"connector:add requires @<project>\" (exit 1)" [ref=e936]:
+                    - cell "connector:add <name> (no @<project>)" [ref=e937]:
+                      - code [ref=e938]: connector:add <name>
+                      - text: (no
+                      - code [ref=e939]: "@<project>"
+                      - text: )
+                    - cell "\"connector:add requires @<project>\" (exit 1)" [ref=e940]:
+                      - text: "\""
+                      - code [ref=e941]: connector:add
+                      - text: requires
+                      - code [ref=e942]: "@<project>"
+                      - text: "\" (exit 1)"
+                  - row "connector:add <name> bogus @<project> \"Bundle [ bogus ] is not registered inside @<project>\" (exit 1)" [ref=e943]:
+                    - cell "connector:add <name> bogus @<project>" [ref=e944]:
+                      - code [ref=e945]: connector:add <name> bogus @<project>
+                    - cell "\"Bundle [ bogus ] is not registered inside @<project>\" (exit 1)" [ref=e946]:
+                      - text: "\"Bundle [ bogus ] is not registered inside"
+                      - code [ref=e947]: "@<project>"
+                      - text: "\" (exit 1)"
+                  - 'row "connector:add mycache @<project> --connector=notathing \"Unknown connector type notathing. Allowed values: ...\" (exit 1)" [ref=e948]':
+                    - cell "connector:add mycache @<project> --connector=notathing" [ref=e949]:
+                      - code [ref=e950]: connector:add mycache @<project> --connector=notathing
+                    - 'cell "\"Unknown connector type notathing. Allowed values: ...\" (exit 1)" [ref=e951]':
+                      - text: "\"Unknown connector type"
+                      - code [ref=e952]: notathing
+                      - text: ". Allowed values: ...\" (exit 1)"
+                  - 'row "connector:add redis @<project> with no shared/ dir \"Config directory does not exist: ...\" (exit 1)" [ref=e953]':
+                    - cell "connector:add redis @<project> with no shared/ dir" [ref=e954]:
+                      - code [ref=e955]: connector:add redis @<project>
+                      - text: with no
+                      - code [ref=e956]: shared/
+                      - text: dir
+                    - 'cell "\"Config directory does not exist: ...\" (exit 1)" [ref=e957]'
+                  - 'row "Entry already exists, --force not passed \"Connector `` already exists in ... Re-run with --force to overwrite.\" (exit 1)" [ref=e958]':
+                    - cell "Entry already exists, --force not passed" [ref=e959]:
+                      - text: Entry already exists,
+                      - code [ref=e960]: "--force"
+                      - text: not passed
+                    - 'cell "\"Connector `` already exists in ... Re-run with --force to overwrite.\" (exit 1)" [ref=e961]'
+                  - 'row "--scope= is not one of local, beta, production, testing The framework''s scope validation rejects first (before the handler); if it passes, the handler falls back to \"Scope `` is not valid. Allowed: ...\"" [ref=e962]':
+                    - cell "--scope= is not one of local, beta, production, testing" [ref=e963]:
+                      - code [ref=e964]: "--scope="
+                      - text: is not one of
+                      - code [ref=e965]: local
+                      - text: ","
+                      - code [ref=e966]: beta
+                      - text: ","
+                      - code [ref=e967]: production
+                      - text: ","
+                      - code [ref=e968]: testing
+                    - 'cell "The framework''s scope validation rejects first (before the handler); if it passes, the handler falls back to \"Scope `` is not valid. Allowed: ...\"" [ref=e969]'
+              - generic [ref=e970]:
+                - generic [ref=e971]:
+                  - img [ref=e973]
+                  - text: Inferred type
+                - generic [ref=e975]:
+                  - paragraph [ref=e976]:
+                    - text: If
+                    - code [ref=e977]: <name>
+                    - text: is one of the built-in connector types (
+                    - code [ref=e978]: couchbase
+                    - text: ","
+                    - code [ref=e979]: mysql
+                    - text: ","
+                    - code [ref=e980]: postgresql
+                    - text: ","
+                    - code [ref=e981]: sqlite
+                    - text: ","
+                    - code [ref=e982]: redis
+                    - text: ","
+                    - code [ref=e983]: ai
+                    - text: ), you can omit
+                    - code [ref=e984]: "--connector="
+                    - text: . In that case, the generated entry also omits the
+                    - code [ref=e985]: connector
+                    - text: field — the runtime uses the logical key name as the type.
+                  - paragraph [ref=e986]:
+                    - text: "Example:"
+                    - code [ref=e987]: gina connector:add redis @myproject --host=127.0.0.1 --connector-port=6379
+                    - text: "writes:"
+                  - code [ref=e991]:
+                    - generic [ref=e992]: "\"redis\": { \"host\": \"127.0.0.1\", \"port\": 6379 }"
+              - separator [ref=e993]
+              - heading "connector:rmDirect link to connectorrm" [level=2] [ref=e994]:
+                - code [ref=e995]: connector:rm
+                - link "Direct link to connectorrm" [ref=e996] [cursor=pointer]:
+                  - /url: "#connectorrm"
+                  - text: "#"
+              - paragraph [ref=e997]:
+                - emphasis [ref=e998]: New in 0.3.7-alpha.2
+              - paragraph [ref=e999]:
+                - text: Remove a connector entry from a project's
+                - code [ref=e1000]: shared/config/connectors.json
+                - text: or from a bundle-scoped
+                - code [ref=e1001]: <bundle>/config/connectors.json
+                - text: ". The scope is inferred from positional-absence: pass a"
+                - code [ref=e1002]: <bundle>
+                - text: to target that bundle, omit it to target shared.
+                - code [ref=e1003]: remove
+                - text: is accepted as an alias.
+              - code [ref=e1007]:
+                - generic [ref=e1008]: "gina connector:rm <name> @<project> # Removes from shared/config/connectors.json"
+                - generic [ref=e1009]: "gina connector:rm <name> <bundle> @<project> # Removes from <bundle-src>/config/connectors.json"
+                - generic [ref=e1010]: "gina connector:remove <name> @<project> # Alias for rm"
+              - generic [ref=e1011]:
+                - generic [ref=e1012]:
+                  - img [ref=e1014]
+                  - text: Never uninstalls the npm driver
+                - paragraph [ref=e1017]:
+                  - code [ref=e1018]: connector:rm
+                  - text: removes the JSON entry only — it never runs
+                  - code [ref=e1019]: npm uninstall
+                  - text: . A driver removed from one bundle may still be needed by another bundle in the same project, and the project's
+                  - code [ref=e1020]: node_modules/
+                  - text: is shared across bundles. After removal, the command prints a retention hint listing any sibling bundles (or shared) that still reference the same driver.
+              - heading "FlagsDirect link to Flags" [level=3] [ref=e1021]:
+                - text: Flags
+                - link "Direct link to Flags" [ref=e1022] [cursor=pointer]:
+                  - /url: "#flags-1"
+                  - text: "#"
+              - table [ref=e1023]:
+                - rowgroup [ref=e1024]:
+                  - row "Flag Description" [ref=e1025]:
+                    - columnheader "Flag" [ref=e1026]
+                    - columnheader "Description" [ref=e1027]
+                - rowgroup [ref=e1028]:
+                  - row "--dry-run Print what would be removed without touching any file. Includes the sibling-usage hint." [ref=e1029]:
+                    - cell "--dry-run" [ref=e1030]:
+                      - code [ref=e1031]: "--dry-run"
+                    - cell "Print what would be removed without touching any file. Includes the sibling-usage hint." [ref=e1032]
+                  - row "--force Skip the project-level guard that refuses to remove a shared connector while other bundles still reference it. Bundle-level removals never consult this guard." [ref=e1033]:
+                    - cell "--force" [ref=e1034]:
+                      - code [ref=e1035]: "--force"
+                    - cell "Skip the project-level guard that refuses to remove a shared connector while other bundles still reference it. Bundle-level removals never consult this guard." [ref=e1036]
+              - heading "Scoping rulesDirect link to Scoping rules" [level=3] [ref=e1037]:
+                - text: Scoping rules
+                - link "Direct link to Scoping rules" [ref=e1038] [cursor=pointer]:
+                  - /url: "#scoping-rules"
+                  - text: "#"
+              - table [ref=e1039]:
+                - rowgroup [ref=e1040]:
+                  - row "Command shape Target file Safety gate" [ref=e1041]:
+                    - columnheader "Command shape" [ref=e1042]
+                    - columnheader "Target file" [ref=e1043]
+                    - columnheader "Safety gate" [ref=e1044]
+                - rowgroup [ref=e1045]:
+                  - row "connector:rm <name> @<project> shared/config/connectors.json Refuses if any bundle still declares <name> unless --force is passed" [ref=e1046]:
+                    - cell "connector:rm <name> @<project>" [ref=e1047]:
+                      - code [ref=e1048]: connector:rm <name> @<project>
+                    - cell "shared/config/connectors.json" [ref=e1049]:
+                      - code [ref=e1050]: shared/config/connectors.json
+                    - cell "Refuses if any bundle still declares <name> unless --force is passed" [ref=e1051]:
+                      - text: Refuses if any bundle still declares
+                      - code [ref=e1052]: <name>
+                      - text: unless
+                      - code [ref=e1053]: "--force"
+                      - text: is passed
+                  - row "connector:rm <name> <bundle> @<project> <bundle-src>/config/connectors.json Always proceeds. Leaves shared untouched." [ref=e1054]:
+                    - cell "connector:rm <name> <bundle> @<project>" [ref=e1055]:
+                      - code [ref=e1056]: connector:rm <name> <bundle> @<project>
+                    - cell "<bundle-src>/config/connectors.json" [ref=e1057]:
+                      - code [ref=e1058]: <bundle-src>/config/connectors.json
+                    - cell "Always proceeds. Leaves shared untouched." [ref=e1059]
+              - heading "ExamplesDirect link to Examples" [level=3] [ref=e1060]:
+                - text: Examples
+                - link "Direct link to Examples" [ref=e1061] [cursor=pointer]:
+                  - /url: "#examples-1"
+                  - text: "#"
+              - code [ref=e1065]:
+                - generic [ref=e1066]: "# Remove shared entry (fails if any bundle still uses it)"
+                - generic [ref=e1067]: gina connector:rm session @myproject
+                - generic [ref=e1068]: "# Remove from one bundle only"
+                - generic [ref=e1069]: gina connector:rm session api @myproject
+                - generic [ref=e1070]: "# Preview removal with sibling warnings"
+                - generic [ref=e1071]: gina connector:rm session @myproject --dry-run
+                - generic [ref=e1072]: "# Remove shared entry even if bundles still use it"
+                - generic [ref=e1073]: gina connector:rm session @myproject --force
+              - heading "OutputDirect link to Output" [level=3] [ref=e1074]:
+                - text: Output
+                - link "Direct link to Output" [ref=e1075] [cursor=pointer]:
+                  - /url: "#output-2"
+                  - text: "#"
+              - code [ref=e1079]:
+                - generic [ref=e1080]: "Removed connector `session` from shared scope at /path/to/project/shared/config/connectors.json"
+                - generic [ref=e1081]: "Note: gina does not uninstall npm packages. Driver `redis` is still referenced by: api (override), worker (session)."
+              - paragraph [ref=e1082]: "When removing from a bundle:"
+              - code [ref=e1086]:
+                - generic [ref=e1087]: "Removed connector `session` from bundle `api` at /path/to/project/src/api/config/connectors.json"
+                - generic [ref=e1088]: "Note: gina does not uninstall npm packages. Driver `redis` is still referenced by: shared, worker (session)."
+              - paragraph [ref=e1089]:
+                - text: When the removed driver is
+                - code [ref=e1090]: sqlite
+                - text: (Node-builtin), the retention note is omitted — there is no npm package to retain.
+              - heading "Dry-runDirect link to Dry-run" [level=3] [ref=e1091]:
+                - text: Dry-run
+                - link "Direct link to Dry-run" [ref=e1092] [cursor=pointer]:
+                  - /url: "#dry-run"
+                  - text: "#"
+              - code [ref=e1096]:
+                - generic [ref=e1097]: gina connector:rm session @myproject --dry-run
+              - code [ref=e1101]:
+                - generic [ref=e1102]: "[dry-run] Would remove connector `session` from shared scope at /path/to/project/shared/config/connectors.json."
+                - generic [ref=e1103]: "[dry-run] Current entry:"
+                - generic [ref=e1104]: "{"
+                - generic [ref=e1105]: "\"connector\": \"redis\","
+                - generic [ref=e1106]: "\"host\": \"127.0.0.1\","
+                - generic [ref=e1107]: "\"port\": 6379"
+                - generic [ref=e1108]: "}"
+                - generic [ref=e1109]: "[dry-run] Warning: 2 bundle(s) still reference `session`: api (override), worker. Re-run without --dry-run and with --force to proceed."
+                - generic [ref=e1110]: "[dry-run] Note: gina does not uninstall npm packages. Driver `redis` is still referenced by: api (override), worker (session)."
+              - paragraph [ref=e1111]:
+                - text: Dry-run never writes to disk and always exits
+                - code [ref=e1112]: "0"
+                - text: ", even when the real command would refuse without"
+                - code [ref=e1113]: "--force"
+                - text: .
+              - heading "Project-level guard (--force)Direct link to project-level-guard---force" [level=3] [ref=e1114]:
+                - text: Project-level guard (
+                - code [ref=e1115]: "--force"
+                - text: )
+                - link "Direct link to project-level-guard---force" [ref=e1116] [cursor=pointer]:
+                  - /url: "#project-level-guard---force"
+                  - text: "#"
+              - paragraph [ref=e1117]: "By default, removing a shared connector requires that no bundle still declares the same logical name — this prevents a bundle that relies on overlay inheritance from breaking silently. The command prints the offending bundles:"
+              - code [ref=e1121]:
+                - generic [ref=e1122]: "[error] Removing shared connector `session` would break 2 bundle(s) that still reference it:"
+                - generic [ref=e1123]: api (override), worker.
+                - generic [ref=e1124]: Re-run with --force to remove anyway, or remove from each bundle first.
+              - paragraph [ref=e1125]:
+                - text: Pass
+                - code [ref=e1126]: "--force"
+                - text: to bypass the guard. Bundle-level removals never consult the guard — removing from
+                - code [ref=e1127]: api
+                - text: has no effect on
+                - code [ref=e1128]: worker
+                - text: or
+                - code [ref=e1129]: shared
+                - text: .
+              - heading "Inherited-from-shared hintDirect link to Inherited-from-shared hint" [level=3] [ref=e1130]:
+                - text: Inherited-from-shared hint
+                - link "Direct link to Inherited-from-shared hint" [ref=e1131] [cursor=pointer]:
+                  - /url: "#inherited-from-shared-hint"
+                  - text: "#"
+              - paragraph [ref=e1132]:
+                - text: Attempting to remove a connector from a bundle when it is only declared in
+                - code [ref=e1133]: shared
+                - text: "prints a hint pointing at the right scope:"
+              - code [ref=e1137]:
+                - generic [ref=e1138]: "[error] Connector `session` is not declared in `api/config/connectors.json` — it is inherited from shared/config/connectors.json. Use `gina connector:rm session @myproject` to remove it from shared."
+              - heading "Merge behaviourDirect link to Merge behaviour" [level=3] [ref=e1139]:
+                - text: Merge behaviour
+                - link "Direct link to Merge behaviour" [ref=e1140] [cursor=pointer]:
+                  - /url: "#merge-behaviour-1"
+                  - text: "#"
+              - paragraph [ref=e1141]: "The written file preserves:"
+              - list [ref=e1142]:
+                - listitem [ref=e1143]:
+                  - code [ref=e1144]: $schema
+                  - text: (always first)
+                - listitem [ref=e1145]: Existing entries in their original key order, minus the removed key
+                - listitem [ref=e1146]:
+                  - text: Any comment header above the first
+                  - code [ref=e1147]: "{"
+                  - text: (byte-for-byte)
+              - paragraph [ref=e1148]:
+                - text: Mid-body
+                - code [ref=e1149]: //
+                - text: or
+                - code [ref=e1150]: /* */
+                - text: comments are
+                - strong [ref=e1151]: lost
+                - text: on rewrite — the body is re-serialised from the parsed JSON, same as
+                - code [ref=e1152]: connector:add
+                - text: .
+              - heading "Error pathsDirect link to Error paths" [level=3] [ref=e1153]:
+                - text: Error paths
+                - link "Direct link to Error paths" [ref=e1154] [cursor=pointer]:
+                  - /url: "#error-paths-2"
+                  - text: "#"
+              - table [ref=e1155]:
+                - rowgroup [ref=e1156]:
+                  - row "Input Behaviour" [ref=e1157]:
+                    - columnheader "Input" [ref=e1158]
+                    - columnheader "Behaviour" [ref=e1159]
+                - rowgroup [ref=e1160]:
+                  - row "connector:rm with no <name> \"connector:rm requires <name> and @<project>\" (exit 1)" [ref=e1161]:
+                    - cell "connector:rm with no <name>" [ref=e1162]:
+                      - code [ref=e1163]: connector:rm
+                      - text: with no
+                      - code [ref=e1164]: <name>
+                    - cell "\"connector:rm requires <name> and @<project>\" (exit 1)" [ref=e1165]:
+                      - text: "\""
+                      - code [ref=e1166]: connector:rm
+                      - text: requires
+                      - code [ref=e1167]: <name>
+                      - text: and
+                      - code [ref=e1168]: "@<project>"
+                      - text: "\" (exit 1)"
+                  - row "connector:rm <name> (no @<project>) \"connector:rm requires @<project>\" (exit 1)" [ref=e1169]:
+                    - cell "connector:rm <name> (no @<project>)" [ref=e1170]:
+                      - code [ref=e1171]: connector:rm <name>
+                      - text: (no
+                      - code [ref=e1172]: "@<project>"
+                      - text: )
+                    - cell "\"connector:rm requires @<project>\" (exit 1)" [ref=e1173]:
+                      - text: "\""
+                      - code [ref=e1174]: connector:rm
+                      - text: requires
+                      - code [ref=e1175]: "@<project>"
+                      - text: "\" (exit 1)"
+                  - row "connector:rm <name> bogus @<project> \"Bundle [ bogus ] is not registered inside @<project>\" (exit 1)" [ref=e1176]:
+                    - cell "connector:rm <name> bogus @<project>" [ref=e1177]:
+                      - code [ref=e1178]: connector:rm <name> bogus @<project>
+                    - cell "\"Bundle [ bogus ] is not registered inside @<project>\" (exit 1)" [ref=e1179]:
+                      - text: "\"Bundle [ bogus ] is not registered inside"
+                      - code [ref=e1180]: "@<project>"
+                      - text: "\" (exit 1)"
+                  - row "connector:rm unknown @<project> \"Connector unknown not found in /…/shared/config/connectors.json\" (exit 1)" [ref=e1181]:
+                    - cell "connector:rm unknown @<project>" [ref=e1182]:
+                      - code [ref=e1183]: connector:rm unknown @<project>
+                    - cell "\"Connector unknown not found in /…/shared/config/connectors.json\" (exit 1)" [ref=e1184]:
+                      - text: "\"Connector"
+                      - code [ref=e1185]: unknown
+                      - text: not found in /…/shared/config/connectors.json" (exit 1)
+                  - row "connector:rm session api @<project> (lives only in shared) Inherited-from-shared hint (exit 1)" [ref=e1186]:
+                    - cell "connector:rm session api @<project> (lives only in shared)" [ref=e1187]:
+                      - code [ref=e1188]: connector:rm session api @<project>
+                      - text: (lives only in shared)
+                    - cell "Inherited-from-shared hint (exit 1)" [ref=e1189]
+                  - 'row "connector:rm session @<project> (siblings still reference it) \"Removing shared connector would break N bundle(s): …\" (exit 1; pass --force to override)" [ref=e1190]':
+                    - cell "connector:rm session @<project> (siblings still reference it)" [ref=e1191]:
+                      - code [ref=e1192]: connector:rm session @<project>
+                      - text: (siblings still reference it)
+                    - 'cell "\"Removing shared connector would break N bundle(s): …\" (exit 1; pass --force to override)" [ref=e1193]':
+                      - text: "\"Removing shared connector would break N bundle(s): …\" (exit 1; pass"
+                      - code [ref=e1194]: "--force"
+                      - text: to override)
+              - separator [ref=e1195]
+              - heading "connector:migrateDirect link to connectormigrate" [level=2] [ref=e1196]:
+                - code [ref=e1197]: connector:migrate
+                - link "Direct link to connectormigrate" [ref=e1198] [cursor=pointer]:
+                  - /url: "#connectormigrate"
+                  - text: "#"
+              - paragraph [ref=e1199]:
+                - emphasis [ref=e1200]: New in 0.3.7-alpha.2
+              - paragraph [ref=e1201]:
+                - text: Lint every
+                - code [ref=e1202]: connectors.json
+                - text: in a project (or a single bundle's file) and optionally apply auto-fixable issues in place.
+                - code [ref=e1203]: connector:migrate
+                - text: is
+                - strong [ref=e1204]: explicit and opt-in
+                - text: — the framework never auto-migrates a
+                - code [ref=e1205]: connectors.json
+                - text: at bundle boot. Run it in CI or before committing.
+              - code [ref=e1209]:
+                - generic [ref=e1210]: "gina connector:migrate @<project> # Scan shared + every bundle"
+                - generic [ref=e1211]: "gina connector:migrate <bundle> @<project> # Scan just the bundle's file"
+                - generic [ref=e1212]: "gina connector:migrate @<project> --fix # Apply auto-fixable issues"
+                - generic [ref=e1213]: "gina connector:migrate @<project> --format=json # Machine-readable report"
+              - generic [ref=e1214]:
+                - generic [ref=e1215]:
+                  - img [ref=e1217]
+                  - text: Dry run by default
+                - paragraph [ref=e1220]:
+                  - text: Without
+                  - code [ref=e1221]: "--fix"
+                  - text: ","
+                  - code [ref=e1222]: connector:migrate
+                  - text: is a
+                  - strong [ref=e1223]: read-only dry run
+                  - text: — nothing is written. Pass
+                  - code [ref=e1224]: "--fix"
+                  - text: to apply the auto-fixable issues.
+              - heading "FlagsDirect link to Flags" [level=3] [ref=e1225]:
+                - text: Flags
+                - link "Direct link to Flags" [ref=e1226] [cursor=pointer]:
+                  - /url: "#flags-2"
+                  - text: "#"
+              - table [ref=e1227]:
+                - rowgroup [ref=e1228]:
+                  - row "Flag Description" [ref=e1229]:
+                    - columnheader "Flag" [ref=e1230]
+                    - columnheader "Description" [ref=e1231]
+                - rowgroup [ref=e1232]:
+                  - row "--fix Apply auto-fixable issues to disk. Without it, connector:migrate is a read-only dry run." [ref=e1233]:
+                    - cell "--fix" [ref=e1234]:
+                      - code [ref=e1235]: "--fix"
+                    - cell "Apply auto-fixable issues to disk. Without it, connector:migrate is a read-only dry run." [ref=e1236]:
+                      - text: Apply auto-fixable issues to disk. Without it,
+                      - code [ref=e1237]: connector:migrate
+                      - text: is a read-only dry run.
+                  - row "--format=json Emit a machine-readable JSON report instead of the human-readable text summary." [ref=e1238]:
+                    - cell "--format=json" [ref=e1239]:
+                      - code [ref=e1240]: "--format=json"
+                    - cell "Emit a machine-readable JSON report instead of the human-readable text summary." [ref=e1241]
+              - heading "ChecksDirect link to Checks" [level=3] [ref=e1242]:
+                - text: Checks
+                - link "Direct link to Checks" [ref=e1243] [cursor=pointer]:
+                  - /url: "#checks"
+                  - text: "#"
+              - table [ref=e1244]:
+                - rowgroup [ref=e1245]:
+                  - row "Check Severity Auto-fixable Description" [ref=e1246]:
+                    - columnheader "Check" [ref=e1247]
+                    - columnheader "Severity" [ref=e1248]
+                    - columnheader "Auto-fixable" [ref=e1249]
+                    - columnheader "Description" [ref=e1250]
+                - rowgroup [ref=e1251]:
+                  - 'row "missing-schema info yes Top-level $schema key is absent. --fix injects \"$schema\": \"https://gina.io/schema/connectors.json\" at the top of the object, preserving the leading comment header and existing key order." [ref=e1252]':
+                    - cell "missing-schema" [ref=e1253]:
+                      - code [ref=e1254]: missing-schema
+                    - cell "info" [ref=e1255]
+                    - cell "yes" [ref=e1256]
+                    - 'cell "Top-level $schema key is absent. --fix injects \"$schema\": \"https://gina.io/schema/connectors.json\" at the top of the object, preserving the leading comment header and existing key order." [ref=e1257]':
+                      - text: Top-level
+                      - code [ref=e1258]: $schema
+                      - text: key is absent.
+                      - code [ref=e1259]: "--fix"
+                      - text: injects
+                      - code [ref=e1260]: "\"$schema\": \"https://gina.io/schema/connectors.json\""
+                      - text: at the top of the object, preserving the leading comment header and existing key order.
+                  - row "bare-key-no-connector warn no An entry has no connector field and its key is not in the built-in enum (couchbase, mysql, postgresql, sqlite, redis, ai). The correct driver cannot be inferred from the key name, so re-declare the entry explicitly via gina connector:add <name> @<project> --connector=<type> --force." [ref=e1261]:
+                    - cell "bare-key-no-connector" [ref=e1262]:
+                      - code [ref=e1263]: bare-key-no-connector
+                    - cell "warn" [ref=e1264]
+                    - cell "no" [ref=e1265]
+                    - cell "An entry has no connector field and its key is not in the built-in enum (couchbase, mysql, postgresql, sqlite, redis, ai). The correct driver cannot be inferred from the key name, so re-declare the entry explicitly via gina connector:add <name> @<project> --connector=<type> --force." [ref=e1266]:
+                      - text: An entry has no
+                      - code [ref=e1267]: connector
+                      - text: field
+                      - strong [ref=e1268]: and
+                      - text: its key is not in the built-in enum (
+                      - code [ref=e1269]: couchbase
+                      - text: ","
+                      - code [ref=e1270]: mysql
+                      - text: ","
+                      - code [ref=e1271]: postgresql
+                      - text: ","
+                      - code [ref=e1272]: sqlite
+                      - text: ","
+                      - code [ref=e1273]: redis
+                      - text: ","
+                      - code [ref=e1274]: ai
+                      - text: ). The correct driver cannot be inferred from the key name, so re-declare the entry explicitly via
+                      - code [ref=e1275]: gina connector:add <name> @<project> --connector=<type> --force
+                      - text: .
+              - heading "Example — dry runDirect link to Example — dry run" [level=3] [ref=e1276]:
+                - text: Example — dry run
+                - link "Direct link to Example — dry run" [ref=e1277] [cursor=pointer]:
+                  - /url: "#example--dry-run"
+                  - text: "#"
+              - code [ref=e1281]:
+                - generic [ref=e1282]: gina connector:migrate @myproject
+              - code [ref=e1286]:
+                - generic [ref=e1287]: "[dry-run] /.../shared/config/connectors.json (shared) — 2 connector(s), 1 issue(s) remaining"
+                - generic [ref=e1288]: "INFO missing-schema — Top-level `$schema` key missing. Auto-fix adds `\"$schema\": \"https://gina.io/schema/connectors.json\"`."
+                - generic [ref=e1289]: "[dry-run] /.../api/config/connectors.json (bundle `api`) — 1 connector(s), no issues"
+                - generic [ref=e1290]: "[dry-run] /.../admin/config/connectors.json (bundle `admin`) — 2 connector(s), 2 issue(s) remaining"
+                - generic [ref=e1291]: "INFO missing-schema — Top-level `$schema` key missing. Auto-fix adds `\"$schema\": \"https://gina.io/schema/connectors.json\"`."
+                - generic [ref=e1292]: "WARN bare-key-no-connector — `mongodb` Entry `mongodb` has no `connector` field and key `mongodb` is not in the built-in enum (couchbase, mysql, postgresql, sqlite, redis, ai). Add `\"connector\": \"<type>\"` by hand, or re-declare via `gina connector:add mongodb @<project> --connector=<type> --force`."
+                - generic [ref=e1293]: Re-run with --fix to apply 2 auto-fixable issue(s). 1 issue(s) need manual attention.
+              - heading "Example — apply fixesDirect link to Example — apply fixes" [level=3] [ref=e1294]:
+                - text: Example — apply fixes
+                - link "Direct link to Example — apply fixes" [ref=e1295] [cursor=pointer]:
+                  - /url: "#example--apply-fixes"
+                  - text: "#"
+              - code [ref=e1299]:
+                - generic [ref=e1300]: gina connector:migrate @myproject --fix
+              - code [ref=e1304]:
+                - generic [ref=e1305]: "[fix] /.../shared/config/connectors.json (shared) — 2 connector(s), 1 fixed"
+                - generic [ref=e1306]: "FIXED missing-schema — Top-level `$schema` key missing. Auto-fix adds `\"$schema\": \"https://gina.io/schema/connectors.json\"`."
+                - generic [ref=e1307]: "[fix] /.../api/config/connectors.json (bundle `api`) — 1 connector(s), no issues"
+                - generic [ref=e1308]: "[fix] /.../admin/config/connectors.json (bundle `admin`) — 2 connector(s), 1 fixed, 1 issue(s) remaining"
+                - generic [ref=e1309]: "FIXED missing-schema — Top-level `$schema` key missing. Auto-fix adds `\"$schema\": \"https://gina.io/schema/connectors.json\"`."
+                - generic [ref=e1310]: "WARN bare-key-no-connector — `mongodb` Entry `mongodb` has no `connector` field and key `mongodb` is not in the built-in enum (couchbase, mysql, postgresql, sqlite, redis, ai). Add `\"connector\": \"<type>\"` by hand, or re-declare via `gina connector:add mongodb @<project> --connector=<type> --force`."
+                - generic [ref=e1311]: Applied 2 fix(es). 1 issue(s) still need manual attention.
+              - paragraph [ref=e1312]:
+                - text: Re-running after
+                - code [ref=e1313]: "--fix"
+                - text: is idempotent — the fixable issue no longer fires, and only the manual-attention warnings remain.
+              - heading "JSON outputDirect link to JSON output" [level=3] [ref=e1314]:
+                - text: JSON output
+                - link "Direct link to JSON output" [ref=e1315] [cursor=pointer]:
+                  - /url: "#json-output-1"
+                  - text: "#"
+              - code [ref=e1319]:
+                - generic [ref=e1320]: gina connector:migrate @myproject --format=json
+              - code [ref=e1324]:
+                - generic [ref=e1325]: "{"
+                - generic [ref=e1326]: "\"project\": \"myproject\","
+                - generic [ref=e1327]: "\"scope\": \"project\","
+                - generic [ref=e1328]: "\"bundle\": null,"
+                - generic [ref=e1329]: "\"fixApplied\": false,"
+                - generic [ref=e1330]: "\"files\": ["
+                - generic [ref=e1331]: "{"
+                - generic [ref=e1332]: "\"path\": \"/.../shared/config/connectors.json\","
+                - generic [ref=e1333]: "\"bundle\": null,"
+                - generic [ref=e1334]: "\"exists\": true,"
+                - generic [ref=e1335]: "\"parseError\": null,"
+                - generic [ref=e1336]: "\"connectorCount\": 2,"
+                - generic [ref=e1337]: "\"fixed\": [],"
+                - generic [ref=e1338]: "\"issues\": ["
+                - generic [ref=e1339]: "{"
+                - generic [ref=e1340]: "\"type\": \"missing-schema\","
+                - generic [ref=e1341]: "\"severity\": \"info\","
+                - generic [ref=e1342]: "\"fixable\": true,"
+                - generic [ref=e1343]: "\"message\": \"Top-level `$schema` key missing. Auto-fix adds `\\\"$schema\\\": \\\"https://gina.io/schema/connectors.json\\\"`.\""
+                - generic [ref=e1344]: "}"
+                - generic [ref=e1345]: "]"
+                - generic [ref=e1346]: "}"
+                - generic [ref=e1347]: "]"
+                - generic [ref=e1348]: "}"
+              - table [ref=e1349]:
+                - rowgroup [ref=e1350]:
+                  - row "Field Description" [ref=e1351]:
+                    - columnheader "Field" [ref=e1352]
+                    - columnheader "Description" [ref=e1353]
+                - rowgroup [ref=e1354]:
+                  - row "project Project short-name (manifest name with the leading @ stripped)" [ref=e1355]:
+                    - cell "project" [ref=e1356]:
+                      - code [ref=e1357]: project
+                    - cell "Project short-name (manifest name with the leading @ stripped)" [ref=e1358]:
+                      - text: Project short-name (manifest
+                      - code [ref=e1359]: name
+                      - text: with the leading
+                      - code [ref=e1360]: "@"
+                      - text: stripped)
+                  - row "scope \"project\" when <bundle> is absent, \"bundle\" when present" [ref=e1361]:
+                    - cell "scope" [ref=e1362]:
+                      - code [ref=e1363]: scope
+                    - cell "\"project\" when <bundle> is absent, \"bundle\" when present" [ref=e1364]:
+                      - code [ref=e1365]: "\"project\""
+                      - text: when
+                      - code [ref=e1366]: <bundle>
+                      - text: is absent,
+                      - code [ref=e1367]: "\"bundle\""
+                      - text: when present
+                  - row "bundle Bundle name when scope is \"bundle\", otherwise null" [ref=e1368]:
+                    - cell "bundle" [ref=e1369]:
+                      - code [ref=e1370]: bundle
+                    - cell "Bundle name when scope is \"bundle\", otherwise null" [ref=e1371]:
+                      - text: Bundle name when scope is
+                      - code [ref=e1372]: "\"bundle\""
+                      - text: ", otherwise"
+                      - code [ref=e1373]: "null"
+                  - row "fixApplied true when --fix was passed (regardless of whether any fix ran)" [ref=e1374]:
+                    - cell "fixApplied" [ref=e1375]:
+                      - code [ref=e1376]: fixApplied
+                    - cell "true when --fix was passed (regardless of whether any fix ran)" [ref=e1377]:
+                      - code [ref=e1378]: "true"
+                      - text: when
+                      - code [ref=e1379]: "--fix"
+                      - text: was passed (regardless of whether any fix ran)
+                  - row "files[] One entry per scanned connectors.json file — path, owning bundle (null for shared), exists, parseError, connectorCount (excluding $schema), fixed[], issues[]" [ref=e1380]:
+                    - cell "files[]" [ref=e1381]:
+                      - code [ref=e1382]: files[]
+                    - cell "One entry per scanned connectors.json file — path, owning bundle (null for shared), exists, parseError, connectorCount (excluding $schema), fixed[], issues[]" [ref=e1383]:
+                      - text: One entry per scanned
+                      - code [ref=e1384]: connectors.json
+                      - text: file —
+                      - code [ref=e1385]: path
+                      - text: ", owning"
+                      - code [ref=e1386]: bundle
+                      - text: (null for shared),
+                      - code [ref=e1387]: exists
+                      - text: ","
+                      - code [ref=e1388]: parseError
+                      - text: ","
+                      - code [ref=e1389]: connectorCount
+                      - text: (excluding
+                      - code [ref=e1390]: $schema
+                      - text: ),
+                      - code [ref=e1391]: fixed[]
+                      - text: ","
+                      - code [ref=e1392]: issues[]
+              - heading "Comment header preservationDirect link to Comment header preservation" [level=3] [ref=e1393]:
+                - text: Comment header preservation
+                - link "Direct link to Comment header preservation" [ref=e1394] [cursor=pointer]:
+                  - /url: "#comment-header-preservation"
+                  - text: "#"
+              - paragraph [ref=e1395]:
+                - text: The leading
+                - code [ref=e1396]: //
+                - text: or
+                - code [ref=e1397]: /* */
+                - text: comment header above the first
+                - code [ref=e1398]: "{"
+                - text: is preserved byte-for-byte when
+                - code [ref=e1399]: "--fix"
+                - text: rewrites the file. Mid-body comments are lost on rewrite (same convention as
+                - code [ref=e1400]: connector:add
+                - text: and
+                - code [ref=e1401]: connector:rm
+                - text: ).
+              - heading "Why there is no auto-migrate hookDirect link to Why there is no auto-migrate hook" [level=3] [ref=e1402]:
+                - text: Why there is no auto-migrate hook
+                - link "Direct link to Why there is no auto-migrate hook" [ref=e1403] [cursor=pointer]:
+                  - /url: "#why-there-is-no-auto-migrate-hook"
+                  - text: "#"
+              - paragraph [ref=e1404]:
+                - code [ref=e1405]: connector:migrate
+                - text: does
+                - strong [ref=e1406]: not
+                - text: run automatically at bundle boot —
+                - code [ref=e1407]: core/config.js
+                - text: is unchanged by this command. A runtime auto-migration hook is the right long-term design, but only when a concrete old-shape → new-shape delta exists to migrate. Today's schema has no such delta (the enum and field shapes are stable since 0.3.7), so a boot-path hook would be scaffolding around a non-existent problem. The real hook is deferred to
+                - code [ref=e1408]: 0.4.0
+                - text: alongside the Couchbase SDK v2 removal (
+                - code [ref=e1409]: "#CN8"
+                - text: ), when the migration will have a real before/after to act on.
+              - heading "Error pathsDirect link to Error paths" [level=3] [ref=e1410]:
+                - text: Error paths
+                - link "Direct link to Error paths" [ref=e1411] [cursor=pointer]:
+                  - /url: "#error-paths-3"
+                  - text: "#"
+              - table [ref=e1412]:
+                - rowgroup [ref=e1413]:
+                  - row "Input Behaviour" [ref=e1414]:
+                    - columnheader "Input" [ref=e1415]
+                    - columnheader "Behaviour" [ref=e1416]
+                - rowgroup [ref=e1417]:
+                  - row "connector:migrate with no @<project> \"connector:migrate requires @<project>\" (exit 1)" [ref=e1418]:
+                    - cell "connector:migrate with no @<project>" [ref=e1419]:
+                      - code [ref=e1420]: connector:migrate
+                      - text: with no
+                      - code [ref=e1421]: "@<project>"
+                    - cell "\"connector:migrate requires @<project>\" (exit 1)" [ref=e1422]:
+                      - text: "\""
+                      - code [ref=e1423]: connector:migrate
+                      - text: requires
+                      - code [ref=e1424]: "@<project>"
+                      - text: "\" (exit 1)"
+                  - row "connector:migrate @unknown \"Project [unknown] not found in your projects list\" (CmdHelper, exit 1)" [ref=e1425]:
+                    - cell "connector:migrate @unknown" [ref=e1426]:
+                      - code [ref=e1427]: connector:migrate @unknown
+                    - cell "\"Project [unknown] not found in your projects list\" (CmdHelper, exit 1)" [ref=e1428]
+                  - row "connector:migrate bogus @<project> \"Bundle [ bogus ] is not registered inside @<project>\" (exit 1)" [ref=e1429]:
+                    - cell "connector:migrate bogus @<project>" [ref=e1430]:
+                      - code [ref=e1431]: connector:migrate bogus @<project>
+                    - cell "\"Bundle [ bogus ] is not registered inside @<project>\" (exit 1)" [ref=e1432]:
+                      - text: "\"Bundle [ bogus ] is not registered inside"
+                      - code [ref=e1433]: "@<project>"
+                      - text: "\" (exit 1)"
+                  - 'row "connector:migrate @<project> --format=xml \"Unknown --format value xml. Supported: json.\" (exit 1)" [ref=e1434]':
+                    - cell "connector:migrate @<project> --format=xml" [ref=e1435]:
+                      - code [ref=e1436]: connector:migrate @<project> --format=xml
+                    - 'cell "\"Unknown --format value xml. Supported: json.\" (exit 1)" [ref=e1437]':
+                      - text: "\"Unknown --format value"
+                      - code [ref=e1438]: xml
+                      - text: ". Supported: json.\" (exit 1)"
+                  - row "Target connectors.json missing Reported as \"missing (skipped)\" — not an error (exit 0)" [ref=e1439]:
+                    - cell "Target connectors.json missing" [ref=e1440]:
+                      - text: Target
+                      - code [ref=e1441]: connectors.json
+                      - text: missing
+                    - cell "Reported as \"missing (skipped)\" — not an error (exit 0)" [ref=e1442]
+              - separator [ref=e1443]
+              - heading "connector:helpDirect link to connectorhelp" [level=2] [ref=e1444]:
+                - code [ref=e1445]: connector:help
+                - link "Direct link to connectorhelp" [ref=e1446] [cursor=pointer]:
+                  - /url: "#connectorhelp"
+                  - text: "#"
+              - paragraph [ref=e1447]:
+                - text: Print the usage summary for the
+                - code [ref=e1448]: connector
+                - text: command group.
+              - code [ref=e1452]:
+                - generic [ref=e1453]: gina connector:help
+              - code [ref=e1457]:
+                - generic [ref=e1458]: gina connector
+            - generic [ref=e1459]:
+              - generic [ref=e1460]:
+                - generic [ref=e1461]: Was this page helpful?
+                - generic [ref=e1462]:
+                  - button "Yes, this was helpful" [ref=e1463] [cursor=pointer]:
+                    - generic [ref=e1464]: 👍
+                    - generic [ref=e1465]: –
+                  - button "No, this was not helpful" [ref=e1466] [cursor=pointer]:
+                    - generic [ref=e1467]: 👎
+                    - generic [ref=e1468]: –
+              - link "Edit this page" [ref=e1472] [cursor=pointer]:
+                - /url: https://github.com/gina-io/docs/tree/main/docs/cli/connector.md
+                - img [ref=e1473]
+                - text: Edit this page
+          - navigation "Docs pages" [ref=e1477]:
+            - link "Previous « service" [ref=e1478] [cursor=pointer]:
+              - /url: /docs/cli/cli-service
+              - generic [ref=e1479]: Previous
+              - generic [ref=e1480]: « service
+            - link "Next Overview »" [ref=e1481] [cursor=pointer]:
+              - /url: /docs/reference/
+              - generic [ref=e1482]: Next
+              - generic [ref=e1483]: Overview »
+        - list [ref=e1486]:
+          - listitem [ref=e1487]:
+            - link "connector:list" [ref=e1488] [cursor=pointer]:
+              - /url: "#connectorlist"
+              - code [ref=e1489]: connector:list
+            - list [ref=e1490]:
+              - listitem [ref=e1491]:
+                - link "Output" [ref=e1492] [cursor=pointer]:
+                  - /url: "#output"
+              - listitem [ref=e1493]:
+                - link "JSON output" [ref=e1494] [cursor=pointer]:
+                  - /url: "#json-output"
+              - listitem [ref=e1495]:
+                - link "Driver resolution" [ref=e1496] [cursor=pointer]:
+                  - /url: "#driver-resolution"
+              - listitem [ref=e1497]:
+                - link "Overlay semantics" [ref=e1498] [cursor=pointer]:
+                  - /url: "#overlay-semantics"
+              - listitem [ref=e1499]:
+                - link "Comment tolerance" [ref=e1500] [cursor=pointer]:
+                  - /url: "#comment-tolerance"
+              - listitem [ref=e1501]:
+                - link "Error paths" [ref=e1502] [cursor=pointer]:
+                  - /url: "#error-paths"
+          - listitem [ref=e1503]:
+            - link "connector:add" [ref=e1504] [cursor=pointer]:
+              - /url: "#connectoradd"
+              - code [ref=e1505]: connector:add
+            - list [ref=e1506]:
+              - listitem [ref=e1507]:
+                - link "Flags" [ref=e1508] [cursor=pointer]:
+                  - /url: "#flags"
+              - listitem [ref=e1509]:
+                - link "Examples" [ref=e1510] [cursor=pointer]:
+                  - /url: "#examples"
+              - listitem [ref=e1511]:
+                - link "Output" [ref=e1512] [cursor=pointer]:
+                  - /url: "#output-1"
+              - listitem [ref=e1513]:
+                - link "Driver install with --install" [ref=e1514] [cursor=pointer]:
+                  - /url: "#driver-install-with---install"
+                  - text: Driver install with
+                  - code [ref=e1515]: "--install"
+              - listitem [ref=e1516]:
+                - link "Version pin — where it applies" [ref=e1517] [cursor=pointer]:
+                  - /url: "#version-pin--where-it-applies"
+              - listitem [ref=e1518]:
+                - link "Merge behaviour" [ref=e1519] [cursor=pointer]:
+                  - /url: "#merge-behaviour"
+              - listitem [ref=e1520]:
+                - link "Error paths" [ref=e1521] [cursor=pointer]:
+                  - /url: "#error-paths-1"
+          - listitem [ref=e1522]:
+            - link "connector:rm" [ref=e1523] [cursor=pointer]:
+              - /url: "#connectorrm"
+              - code [ref=e1524]: connector:rm
+            - list [ref=e1525]:
+              - listitem [ref=e1526]:
+                - link "Flags" [ref=e1527] [cursor=pointer]:
+                  - /url: "#flags-1"
+              - listitem [ref=e1528]:
+                - link "Scoping rules" [ref=e1529] [cursor=pointer]:
+                  - /url: "#scoping-rules"
+              - listitem [ref=e1530]:
+                - link "Examples" [ref=e1531] [cursor=pointer]:
+                  - /url: "#examples-1"
+              - listitem [ref=e1532]:
+                - link "Output" [ref=e1533] [cursor=pointer]:
+                  - /url: "#output-2"
+              - listitem [ref=e1534]:
+                - link "Dry-run" [ref=e1535] [cursor=pointer]:
+                  - /url: "#dry-run"
+              - listitem [ref=e1536]:
+                - link "Project-level guard (--force)" [ref=e1537] [cursor=pointer]:
+                  - /url: "#project-level-guard---force"
+                  - text: Project-level guard (
+                  - code [ref=e1538]: "--force"
+                  - text: )
+              - listitem [ref=e1539]:
+                - link "Inherited-from-shared hint" [ref=e1540] [cursor=pointer]:
+                  - /url: "#inherited-from-shared-hint"
+              - listitem [ref=e1541]:
+                - link "Merge behaviour" [ref=e1542] [cursor=pointer]:
+                  - /url: "#merge-behaviour-1"
+              - listitem [ref=e1543]:
+                - link "Error paths" [ref=e1544] [cursor=pointer]:
+                  - /url: "#error-paths-2"
+          - listitem [ref=e1545]:
+            - link "connector:migrate" [ref=e1546] [cursor=pointer]:
+              - /url: "#connectormigrate"
+              - code [ref=e1547]: connector:migrate
+            - list [ref=e1548]:
+              - listitem [ref=e1549]:
+                - link "Flags" [ref=e1550] [cursor=pointer]:
+                  - /url: "#flags-2"
+              - listitem [ref=e1551]:
+                - link "Checks" [ref=e1552] [cursor=pointer]:
+                  - /url: "#checks"
+              - listitem [ref=e1553]:
+                - link "Example — dry run" [ref=e1554] [cursor=pointer]:
+                  - /url: "#example--dry-run"
+              - listitem [ref=e1555]:
+                - link "Example — apply fixes" [ref=e1556] [cursor=pointer]:
+                  - /url: "#example--apply-fixes"
+              - listitem [ref=e1557]:
+                - link "JSON output" [ref=e1558] [cursor=pointer]:
+                  - /url: "#json-output-1"
+              - listitem [ref=e1559]:
+                - link "Comment header preservation" [ref=e1560] [cursor=pointer]:
+                  - /url: "#comment-header-preservation"
+              - listitem [ref=e1561]:
+                - link "Why there is no auto-migrate hook" [ref=e1562] [cursor=pointer]:
+                  - /url: "#why-there-is-no-auto-migrate-hook"
+              - listitem [ref=e1563]:
+                - link "Error paths" [ref=e1564] [cursor=pointer]:
+                  - /url: "#error-paths-3"
+          - listitem [ref=e1565]:
+            - link "connector:help" [ref=e1566] [cursor=pointer]:
+              - /url: "#connectorhelp"
+              - code [ref=e1567]: connector:help
+  - contentinfo [ref=e1568]:
+    - generic [ref=e1569]:
+      - generic [ref=e1570]:
+        - generic [ref=e1571]:
+          - generic [ref=e1572]: Docs
+          - list [ref=e1573]:
+            - listitem [ref=e1574]:
+              - link "Getting Started" [ref=e1575] [cursor=pointer]:
+                - /url: /docs/intro
+        - generic [ref=e1576]:
+          - generic [ref=e1577]: Community
+          - list [ref=e1578]:
+            - listitem [ref=e1579]:
+              - link "GitHub Issues(opens in new tab)" [ref=e1580] [cursor=pointer]:
+                - /url: https://github.com/gina-io/gina/issues
+                - text: GitHub Issues
+                - img "(opens in new tab)" [ref=e1581]
+            - listitem [ref=e1583]:
+              - link "GitHub Discussions(opens in new tab)" [ref=e1584] [cursor=pointer]:
+                - /url: https://github.com/gina-io/gina/discussions
+                - text: GitHub Discussions
+                - img "(opens in new tab)" [ref=e1585]
+            - listitem [ref=e1587]:
+              - link "Support Gina" [ref=e1588] [cursor=pointer]:
+                - /url: /docs/support
+        - generic [ref=e1589]:
+          - generic [ref=e1590]: More
+          - list [ref=e1591]:
+            - listitem [ref=e1592]:
+              - link "npm(opens in new tab)" [ref=e1593] [cursor=pointer]:
+                - /url: https://www.npmjs.com/package/gina
+                - text: npm
+                - img "(opens in new tab)" [ref=e1594]
+      - generic [ref=e1597]: Copyright © 2009-2026 Gina I/O.
+  - button "Collapse sidebar" [ref=e1599] [cursor=pointer]:
+    - img [ref=e1600]