gina 0.3.13-alpha.2 → 0.3.13

package/.playwright-mcp/page-2026-05-14T02-27-11-472Z.yml

@@ -0,0 +1,406 @@
+- generic [ref=e2]:
+  - region "Skip to main content":
+    - link "Skip to main content" [ref=e3] [cursor=pointer]:
+      - /url: "#__docusaurus_skipToContent_fallback"
+  - navigation "Main" [ref=e4]:
+    - generic [ref=e5]:
+      - generic [ref=e6]:
+        - link "Gina logo Gina" [ref=e7] [cursor=pointer]:
+          - /url: /docs/
+          - img "Gina logo" [ref=e9]
+          - generic [ref=e10]: Gina
+        - link "Docs" [ref=e11] [cursor=pointer]:
+          - /url: /docs/intro
+        - link "Tutorials" [ref=e12] [cursor=pointer]:
+          - /url: /docs/tutorials
+        - link "Templating" [ref=e13] [cursor=pointer]:
+          - /url: /docs/templating/
+        - link "Roadmap" [ref=e14] [cursor=pointer]:
+          - /url: /docs/roadmap
+      - generic [ref=e15]:
+        - generic [ref=e17]:
+          - link "Changelog" [ref=e18] [cursor=pointer]:
+            - /url: https://github.com/gina-io/gina/releases
+            - text: v0.3.12
+          - link "GitHub repository" [ref=e19] [cursor=pointer]:
+            - /url: https://github.com/gina-io/gina
+            - img [ref=e20]
+          - link "npm package (stable)" [ref=e22] [cursor=pointer]:
+            - /url: https://www.npmjs.com/package/gina/v/0.3.12
+            - img [ref=e23]
+        - generic "light mode" [ref=e26] [cursor=pointer]:
+          - checkbox "Switch between dark and light mode (currently light mode)" [disabled]
+          - generic [ref=e27]:
+            - generic [ref=e28]: ☾
+            - generic [ref=e29]: ☀
+        - textbox "Search" [ref=e32]
+  - generic [ref=e35]:
+    - complementary [ref=e36]:
+      - navigation "Docs sidebar" [ref=e39]:
+        - list [ref=e40]:
+          - listitem [ref=e41]:
+            - link "What is Gina?" [ref=e42] [cursor=pointer]:
+              - /url: /docs/intro
+              - img [ref=e44]
+              - generic "What is Gina?" [ref=e46]
+          - listitem [ref=e47]:
+            - generic [ref=e48]:
+              - link "Getting Started" [ref=e49] [cursor=pointer]:
+                - /url: /docs/getting-started
+                - img [ref=e51]
+                - generic "Getting Started" [ref=e56]
+              - button "Expand sidebar category 'Getting Started'" [ref=e57] [cursor=pointer]
+          - listitem [ref=e58]:
+            - generic [ref=e59]:
+              - link "Concepts" [ref=e60] [cursor=pointer]:
+                - /url: /docs/concepts
+                - img [ref=e62]
+                - generic "Concepts" [ref=e64]
+              - button "Expand sidebar category 'Concepts'" [ref=e65] [cursor=pointer]
+          - listitem [ref=e66]:
+            - generic [ref=e67]:
+              - link "Guides" [ref=e68] [cursor=pointer]:
+                - /url: /docs/guides
+                - img [ref=e70]
+                - generic "Guides" [ref=e73]
+              - button "Expand sidebar category 'Guides'" [ref=e74] [cursor=pointer]
+          - listitem [ref=e75]:
+            - generic [ref=e76]:
+              - link "CLI Reference" [ref=e77] [cursor=pointer]:
+                - /url: /docs/cli
+                - img [ref=e79]
+                - generic "CLI Reference" [ref=e81]
+              - button "Collapse sidebar category 'CLI Reference'" [expanded] [ref=e82] [cursor=pointer]
+            - list [ref=e83]:
+              - listitem [ref=e84]:
+                - link "bundle" [ref=e85] [cursor=pointer]:
+                  - /url: /docs/cli/cli-bundle
+                  - generic "bundle" [ref=e86]
+              - listitem [ref=e87]:
+                - link "project" [ref=e88] [cursor=pointer]:
+                  - /url: /docs/cli/cli-project
+                  - generic "project" [ref=e89]
+              - listitem [ref=e90]:
+                - link "framework" [ref=e91] [cursor=pointer]:
+                  - /url: /docs/cli/cli-framework
+                  - generic "framework" [ref=e92]
+              - listitem [ref=e93]:
+                - link "env" [ref=e94] [cursor=pointer]:
+                  - /url: /docs/cli/cli-env
+                  - generic "env" [ref=e95]
+              - listitem [ref=e96]:
+                - link "port" [ref=e97] [cursor=pointer]:
+                  - /url: /docs/cli/cli-port
+                  - generic "port" [ref=e98]
+              - listitem [ref=e99]:
+                - link "scope" [ref=e100] [cursor=pointer]:
+                  - /url: /docs/cli/cli-scope
+                  - generic "scope" [ref=e101]
+              - listitem [ref=e102]:
+                - link "view" [ref=e103] [cursor=pointer]:
+                  - /url: /docs/cli/cli-view
+                  - generic "view" [ref=e104]
+              - listitem [ref=e105]:
+                - link "cache" [ref=e106] [cursor=pointer]:
+                  - /url: /docs/cli/cli-cache
+                  - generic "cache" [ref=e107]
+              - listitem [ref=e108]:
+                - link "protocol" [ref=e109] [cursor=pointer]:
+                  - /url: /docs/cli/cli-protocol
+                  - generic "protocol" [ref=e110]
+              - listitem [ref=e111]:
+                - link "service" [ref=e112] [cursor=pointer]:
+                  - /url: /docs/cli/cli-service
+                  - generic "service" [ref=e113]
+              - listitem [ref=e114]:
+                - link "connector" [ref=e115] [cursor=pointer]:
+                  - /url: /docs/cli/cli-connector
+                  - generic "connector" [ref=e116]
+          - listitem [ref=e117]:
+            - generic [ref=e118]:
+              - link "Configuration Reference" [ref=e119] [cursor=pointer]:
+                - /url: /docs/reference/
+                - img [ref=e121]
+                - generic "Configuration Reference" [ref=e122]
+              - button "Expand sidebar category 'Configuration Reference'" [ref=e123] [cursor=pointer]
+          - listitem [ref=e124]:
+            - generic [ref=e125]:
+              - link "API Reference" [ref=e126] [cursor=pointer]:
+                - /url: /docs/api
+                - img [ref=e128]
+                - generic "API Reference" [ref=e131]
+              - button "Expand sidebar category 'API Reference'" [ref=e132] [cursor=pointer]
+          - listitem [ref=e133]:
+            - generic [ref=e134]:
+              - link "Globals" [ref=e135] [cursor=pointer]:
+                - /url: /docs/globals
+                - img [ref=e137]
+                - generic "Globals" [ref=e140]
+              - button "Expand sidebar category 'Globals'" [ref=e141] [cursor=pointer]
+          - listitem [ref=e142]:
+            - link "Security" [ref=e143] [cursor=pointer]:
+              - /url: /docs/security
+              - img [ref=e145]
+              - generic "Security" [ref=e147]
+          - listitem [ref=e148]:
+            - link "Migration Guide" [ref=e149] [cursor=pointer]:
+              - /url: /docs/migration
+              - img [ref=e151]
+              - generic "Migration Guide" [ref=e153]
+    - main [ref=e154]:
+      - generic [ref=e156]:
+        - generic [ref=e158]:
+          - article [ref=e159]:
+            - navigation "Breadcrumbs" [ref=e160]:
+              - list [ref=e161]:
+                - listitem [ref=e162]:
+                  - link "Home page" [ref=e163] [cursor=pointer]:
+                    - /url: /docs/
+                    - img [ref=e164]
+                - listitem [ref=e166]:
+                  - link "CLI Reference" [ref=e167] [cursor=pointer]:
+                    - /url: /docs/cli
+                - listitem [ref=e168]:
+                  - generic [ref=e169]: service
+            - generic [ref=e170]:
+              - heading "service" [level=1] [ref=e172]
+              - generic [ref=e173]:
+                - generic [ref=e174]:
+                  - generic [ref=e175]:
+                    - img [ref=e176]
+                    - text: 1 min read
+                  - generic [ref=e179]: Intermediate
+                - generic [ref=e180]:
+                  - generic [ref=e181]: Prerequisites
+                  - list [ref=e182]:
+                    - listitem [ref=e183]:
+                      - link "Gina installed globally" [ref=e184] [cursor=pointer]:
+                        - /url: /docs/getting-started/installation
+                    - listitem [ref=e185]:
+                      - link "CLI bundle reference" [ref=e186] [cursor=pointer]:
+                        - /url: /docs/cli/cli-bundle
+              - paragraph [ref=e187]: import DocMeta from '@site/src/components/DocMeta';
+              - generic [ref=e188]:
+                - paragraph [ref=e189]:
+                  - text: The
+                  - code [ref=e190]: service
+                  - text: command group lists
+                  - strong [ref=e191]: framework-internal services
+                  - text: — bundles that ship alongside gina and run as companion processes (currently
+                  - code [ref=e192]: proxy
+                  - text: and
+                  - code [ref=e193]: inspector
+                  - text: ). These services are registered under the reserved
+                  - code [ref=e194]: "@gina"
+                  - text: project.
+                - generic [ref=e195]:
+                  - generic [ref=e196]:
+                    - img [ref=e198]
+                    - text: Gina-internal surface
+                  - paragraph [ref=e201]:
+                    - code [ref=e202]: service:list
+                    - text: currently rejects any project other than
+                    - code [ref=e203]: "@gina"
+                    - text: . User-defined services are not a surface yet — use
+                    - link "bundle:list" [ref=e204] [cursor=pointer]:
+                      - /url: /docs/cli/cli-bundle#bundlelist
+                      - code [ref=e205]: bundle:list
+                    - text: for bundles in user projects.
+                - separator [ref=e206]
+                - heading "service:listDirect link to servicelist" [level=2] [ref=e207]:
+                  - code [ref=e208]: service:list
+                  - link "Direct link to servicelist" [ref=e209] [cursor=pointer]:
+                    - /url: "#servicelist"
+                    - text: "#"
+                - paragraph [ref=e210]:
+                  - emphasis [ref=e211]: New in 0.3.7-alpha.2
+                - paragraph [ref=e212]: List framework-internal services with src-existence, preferred-port summary, and host-side running state.
+                - code [ref=e216]:
+                  - generic [ref=e217]: gina service:list
+                - code [ref=e221]:
+                  - generic [ref=e222]: gina service:list @gina
+                - paragraph [ref=e223]:
+                  - strong [ref=e224]: Flags
+                - table [ref=e225]:
+                  - rowgroup [ref=e226]:
+                    - row "Flag Description" [ref=e227]:
+                      - columnheader "Flag" [ref=e228]
+                      - columnheader "Description" [ref=e229]
+                  - rowgroup [ref=e230]:
+                    - row "--format=json Emit a JSON payload instead of the human-readable text table" [ref=e231]:
+                      - cell "--format=json" [ref=e232]:
+                        - code [ref=e233]: "--format=json"
+                      - cell "Emit a JSON payload instead of the human-readable text table" [ref=e234]
+                - heading "OutputDirect link to Output" [level=3] [ref=e235]:
+                  - text: Output
+                  - link "Direct link to Output" [ref=e236] [cursor=pointer]:
+                    - /url: "#output"
+                    - text: "#"
+                - code [ref=e240]:
+                  - generic [ref=e241]: "[ running ] inspector http/2.0 dev https 4208 pid 27007"
+                  - generic [ref=e242]: "[ running ] proxy http/2.0 dev https 4210 pid 15346"
+                - list [ref=e243]:
+                  - listitem [ref=e244]:
+                    - strong [ref=e245]:
+                      - code [ref=e246]: "[ running ]"
+                      - text: /
+                      - code [ref=e247]: "[ stopped ]"
+                      - text: /
+                      - code [ref=e248]: "[ ?! ]"
+                    - text: — running state (probed from
+                    - code [ref=e249]: ~/.gina/run/<service>@gina.pid
+                    - text: with
+                    - code [ref=e250]: process.kill(pid, 0)
+                    - text: ) or src-existence when the source directory is missing.
+                  - listitem [ref=e251]:
+                    - strong [ref=e252]:
+                      - code [ref=e253]: http/2.0 dev https 4208
+                    - text: — preferred port. Read from
+                    - code [ref=e254]: ~/.gina/ports.reverse.json
+                    - text: ". Precedence:"
+                    - code [ref=e255]: http/2.0 https
+                    - text: →
+                    - code [ref=e256]: http/1.1 https
+                    - text: →
+                    - code [ref=e257]: http/1.1 http
+                    - text: ;
+                    - code [ref=e258]: dev
+                    - text: env is preferred when present, otherwise the first environment in the record. Services with no allocated port render as
+                    - code [ref=e259]: (no port)
+                    - text: .
+                  - listitem [ref=e260]:
+                    - strong [ref=e261]:
+                      - code [ref=e262]: pid 27007
+                    - text: — process id when running.
+                - paragraph [ref=e263]:
+                  - text: With
+                  - code [ref=e264]: "--format=json"
+                  - text: ", each service object carries:"
+                - code [ref=e268]:
+                  - generic [ref=e269]: "{"
+                  - generic [ref=e270]: "\"service\": \"inspector\","
+                  - generic [ref=e271]: "\"path\": \"src/inspector\","
+                  - generic [ref=e272]: "\"status\": \"ok\","
+                  - generic [ref=e273]: "\"ports\": {"
+                  - generic [ref=e274]: "\"dev\": { \"http/1.1\": { \"http\": 4200, \"https\": 4204 }, \"http/2.0\": { \"https\": 4208 } },"
+                  - generic [ref=e275]: "\"prod\": { \"http/1.1\": { \"http\": 4201, \"https\": 4205 }, \"http/2.0\": { \"https\": 4209 } }"
+                  - generic [ref=e276]: "},"
+                  - generic [ref=e277]: "\"running\": true,"
+                  - generic [ref=e278]: "\"pid\": 27007"
+                  - generic [ref=e279]: "}"
+                - paragraph [ref=e280]:
+                  - text: A missing or malformed
+                  - code [ref=e281]: ports.reverse.json
+                  - text: is tolerated — the command still renders with every service showing
+                  - code [ref=e282]: (no port)
+                  - text: /
+                  - code [ref=e283]: "ports: null"
+                  - text: . A stale pidfile (process exited) reports
+                  - code [ref=e284]: (stopped)
+                  - text: without being deleted; pidfile clean-up stays with
+                  - link "bundle:stop" [ref=e285] [cursor=pointer]:
+                    - /url: /docs/cli/cli-bundle#bundlestop
+                    - code [ref=e286]: bundle:stop
+                  - text: .
+                - generic [ref=e287]:
+                  - generic [ref=e288]:
+                    - img [ref=e290]
+                    - text: Docker bundles
+                  - paragraph [ref=e293]:
+                    - text: Services running inside a Docker container write their pidfile inside the container, not on the host
+                    - code [ref=e294]: ~/.gina/run/
+                    - text: directory. Running
+                    - code [ref=e295]: service:list
+                    - text: from a host shell will report them as
+                    - code [ref=e296]: (stopped)
+                    - text: even when the container is up — use
+                    - code [ref=e297]: docker ps
+                    - text: or
+                    - code [ref=e298]: docker exec <container> gina service:list
+                    - text: for the container-side view.
+                - separator [ref=e299]
+                - heading "service:helpDirect link to servicehelp" [level=2] [ref=e300]:
+                  - code [ref=e301]: service:help
+                  - link "Direct link to servicehelp" [ref=e302] [cursor=pointer]:
+                    - /url: "#servicehelp"
+                    - text: "#"
+                - paragraph [ref=e303]:
+                  - text: Print the usage summary for the
+                  - code [ref=e304]: service
+                  - text: command group.
+                - code [ref=e308]:
+                  - generic [ref=e309]: gina service:help
+                - code [ref=e313]:
+                  - generic [ref=e314]: gina service
+            - generic [ref=e315]:
+              - generic [ref=e316]:
+                - generic [ref=e317]: Was this page helpful?
+                - generic [ref=e318]:
+                  - button "Yes, this was helpful" [ref=e319] [cursor=pointer]:
+                    - generic [ref=e320]: 👍
+                    - generic [ref=e321]: –
+                  - button "No, this was not helpful" [ref=e322] [cursor=pointer]:
+                    - generic [ref=e323]: 👎
+                    - generic [ref=e324]: –
+              - link "Edit this page" [ref=e328] [cursor=pointer]:
+                - /url: https://github.com/gina-io/docs/tree/main/docs/cli/service.md
+                - img [ref=e329]
+                - text: Edit this page
+          - navigation "Docs pages" [ref=e333]:
+            - link "Previous « protocol" [ref=e334] [cursor=pointer]:
+              - /url: /docs/cli/cli-protocol
+              - generic [ref=e335]: Previous
+              - generic [ref=e336]: « protocol
+            - link "Next connector »" [ref=e337] [cursor=pointer]:
+              - /url: /docs/cli/cli-connector
+              - generic [ref=e338]: Next
+              - generic [ref=e339]: connector »
+        - list [ref=e343]:
+          - listitem [ref=e344]:
+            - link "service:list" [ref=e345] [cursor=pointer]:
+              - /url: "#servicelist"
+              - code [ref=e346]: service:list
+            - list [ref=e347]:
+              - listitem [ref=e348]:
+                - link "Output" [ref=e349] [cursor=pointer]:
+                  - /url: "#output"
+          - listitem [ref=e350]:
+            - link "service:help" [ref=e351] [cursor=pointer]:
+              - /url: "#servicehelp"
+              - code [ref=e352]: service:help
+  - contentinfo [ref=e353]:
+    - generic [ref=e354]:
+      - generic [ref=e355]:
+        - generic [ref=e356]:
+          - generic [ref=e357]: Docs
+          - list [ref=e358]:
+            - listitem [ref=e359]:
+              - link "Getting Started" [ref=e360] [cursor=pointer]:
+                - /url: /docs/intro
+        - generic [ref=e361]:
+          - generic [ref=e362]: Community
+          - list [ref=e363]:
+            - listitem [ref=e364]:
+              - link "GitHub Issues(opens in new tab)" [ref=e365] [cursor=pointer]:
+                - /url: https://github.com/gina-io/gina/issues
+                - text: GitHub Issues
+                - img "(opens in new tab)" [ref=e366]
+            - listitem [ref=e368]:
+              - link "GitHub Discussions(opens in new tab)" [ref=e369] [cursor=pointer]:
+                - /url: https://github.com/gina-io/gina/discussions
+                - text: GitHub Discussions
+                - img "(opens in new tab)" [ref=e370]
+            - listitem [ref=e372]:
+              - link "Support Gina" [ref=e373] [cursor=pointer]:
+                - /url: /docs/support
+        - generic [ref=e374]:
+          - generic [ref=e375]: More
+          - list [ref=e376]:
+            - listitem [ref=e377]:
+              - link "npm(opens in new tab)" [ref=e378] [cursor=pointer]:
+                - /url: https://www.npmjs.com/package/gina
+                - text: npm
+                - img "(opens in new tab)" [ref=e379]
+      - generic [ref=e382]: Copyright © 2009-2026 Gina I/O.
+  - button "Collapse sidebar" [ref=e384] [cursor=pointer]:
+    - img [ref=e385]