gina 0.3.13-alpha.2 → 0.3.13

package/.playwright-mcp/page-2026-05-14T02-24-51-996Z.yml

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