gina 0.3.13-alpha.3 → 0.3.13

package/.playwright-mcp/page-2026-05-14T02-26-47-905Z.yml

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