robotframework-plugins 2026.11.0.dev1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (195) hide show
  1. robotframework_plugins/__init__.py +14 -0
  2. robotframework_plugins/_assets/catalog.json +143 -0
  3. robotframework_plugins/_assets/plugins/rf-agentskills/.claude-plugin/plugin.json +25 -0
  4. robotframework_plugins/_assets/plugins/rf-agentskills/CHANGELOG.md +198 -0
  5. robotframework_plugins/_assets/plugins/rf-agentskills/README.md +27 -0
  6. robotframework_plugins/_assets/plugins/rf-agentskills/catalog.yaml +25 -0
  7. robotframework_plugins/_assets/plugins/rf-api/.claude-plugin/plugin.json +25 -0
  8. robotframework_plugins/_assets/plugins/rf-api/CHANGELOG.md +9 -0
  9. robotframework_plugins/_assets/plugins/rf-api/README.md +27 -0
  10. robotframework_plugins/_assets/plugins/rf-api/catalog.yaml +27 -0
  11. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/SKILL.md +110 -0
  12. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/assets/examples/authentication-patterns.robot +39 -0
  13. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/assets/examples/basic-crud.robot +46 -0
  14. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/assets/examples/file-upload.robot +28 -0
  15. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/assets/examples/session-handling.robot +48 -0
  16. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/authentication.md +58 -0
  17. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/install.md +10 -0
  18. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/request-options.md +90 -0
  19. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/response-validation.md +64 -0
  20. robotframework_plugins/_assets/plugins/rf-api/skills/rf-requests/references/troubleshooting.md +64 -0
  21. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/SKILL.md +119 -0
  22. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/assets/examples/basic-rest.robot +51 -0
  23. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/assets/examples/schema-validation.robot +38 -0
  24. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/assets/examples/schemas/user.json +10 -0
  25. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/authentication.md +61 -0
  26. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/install.md +11 -0
  27. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/json-handling.md +89 -0
  28. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/migrate-from-requests.md +15 -0
  29. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/schema-validation.md +85 -0
  30. robotframework_plugins/_assets/plugins/rf-api/skills/rf-restinstance/references/troubleshooting.md +68 -0
  31. robotframework_plugins/_assets/plugins/rf-core/.claude-plugin/plugin.json +19 -0
  32. robotframework_plugins/_assets/plugins/rf-core/CHANGELOG.md +11 -0
  33. robotframework_plugins/_assets/plugins/rf-core/README.md +38 -0
  34. robotframework_plugins/_assets/plugins/rf-core/agents/rf-debug-expert.md +104 -0
  35. robotframework_plugins/_assets/plugins/rf-core/agents/rf-migration-guide.md +73 -0
  36. robotframework_plugins/_assets/plugins/rf-core/agents/rf-test-architect.md +98 -0
  37. robotframework_plugins/_assets/plugins/rf-core/catalog.yaml +19 -0
  38. robotframework_plugins/_assets/plugins/rf-core/hooks/README.md +435 -0
  39. robotframework_plugins/_assets/plugins/rf-core/hooks/hooks.json +70 -0
  40. robotframework_plugins/_assets/plugins/rf-core/scripts/_hook_input.mjs +101 -0
  41. robotframework_plugins/_assets/plugins/rf-core/scripts/_pending_errors.mjs +65 -0
  42. robotframework_plugins/_assets/plugins/rf-core/scripts/_python_env.mjs +181 -0
  43. robotframework_plugins/_assets/plugins/rf-core/scripts/check_rf_environment.mjs +181 -0
  44. robotframework_plugins/_assets/plugins/rf-core/scripts/maybe_inject_rf_context.mjs +74 -0
  45. robotframework_plugins/_assets/plugins/rf-core/scripts/maybe_remind_robot_tests.mjs +108 -0
  46. robotframework_plugins/_assets/plugins/rf-core/scripts/report_pending_errors.mjs +72 -0
  47. robotframework_plugins/_assets/plugins/rf-core/scripts/rf_error_hints.mjs +126 -0
  48. robotframework_plugins/_assets/plugins/rf-core/scripts/validate_robot.mjs +509 -0
  49. robotframework_plugins/_assets/plugins/rf-core/scripts/validate_robot_project.mjs +103 -0
  50. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/SKILL.md +313 -0
  51. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/resources/api.resource +30 -0
  52. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/resources/calc.resource +23 -0
  53. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/resources/embedded.resource +20 -0
  54. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/resources/keywords.resource +26 -0
  55. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/resources/login.resource +10 -0
  56. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/01__keyword_driven.robot +15 -0
  57. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/02__data_driven.robot +10 -0
  58. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/03__templates.robot +17 -0
  59. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/04__bdd.robot +10 -0
  60. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/05__embedded.robot +13 -0
  61. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/__init__.robot +6 -0
  62. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/api/__init__.robot +7 -0
  63. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/api/users.robot +18 -0
  64. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/tests/env.robot +15 -0
  65. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/variables/common.py +11 -0
  66. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/variables/dev.yaml +3 -0
  67. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/assets/examples/variables/staging.yaml +3 -0
  68. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/arguments.md +139 -0
  69. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/control-structures.md +175 -0
  70. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/embedded-arguments.md +135 -0
  71. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/migration.md +90 -0
  72. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/resources-and-variable-files.md +127 -0
  73. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/styles.md +92 -0
  74. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/suites-and-init.md +96 -0
  75. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/tags-and-selection.md +104 -0
  76. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/templates.md +124 -0
  77. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/references/variables-and-scopes.md +129 -0
  78. robotframework_plugins/_assets/plugins/rf-core/skills/rf-language/scripts/rf_conventions.py +883 -0
  79. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/SKILL.md +216 -0
  80. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/ExampleLibrary.py +61 -0
  81. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/ResultListener.py +60 -0
  82. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/converters.py +48 -0
  83. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/converters.robot +20 -0
  84. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/example_library.robot +31 -0
  85. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/assets/examples/listener.robot +12 -0
  86. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/references/api-variants.md +291 -0
  87. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/references/communication.md +248 -0
  88. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/references/conversion.md +347 -0
  89. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/references/listeners.md +150 -0
  90. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/references/packaging-and-docs.md +155 -0
  91. robotframework_plugins/_assets/plugins/rf-core/skills/rf-python-library/scripts/check_library.py +842 -0
  92. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/SKILL.md +159 -0
  93. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/github-actions-robot.yml +32 -0
  94. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/gitignore.txt +22 -0
  95. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/pyproject.poetry.toml +28 -0
  96. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/pyproject.uv.toml +20 -0
  97. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/requirements.txt +9 -0
  98. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/robot.toml +16 -0
  99. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/assets/examples/smoke.robot +22 -0
  100. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/ci.md +61 -0
  101. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/cli-tools.md +33 -0
  102. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/libraries.md +47 -0
  103. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/poetry.md +77 -0
  104. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/project-layout.md +86 -0
  105. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/troubleshooting.md +73 -0
  106. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/uv.md +108 -0
  107. robotframework_plugins/_assets/plugins/rf-core/skills/rf-setup/references/venv-pip.md +71 -0
  108. robotframework_plugins/_assets/plugins/rf-core/variants/codex/agents/rf-debug-expert.toml +103 -0
  109. robotframework_plugins/_assets/plugins/rf-core/variants/codex/agents/rf-migration-guide.toml +72 -0
  110. robotframework_plugins/_assets/plugins/rf-core/variants/codex/agents/rf-test-architect.toml +97 -0
  111. robotframework_plugins/_assets/plugins/rf-core/variants/opencode/agents/rf-debug-expert.md +107 -0
  112. robotframework_plugins/_assets/plugins/rf-core/variants/opencode/agents/rf-migration-guide.md +76 -0
  113. robotframework_plugins/_assets/plugins/rf-core/variants/opencode/agents/rf-test-architect.md +101 -0
  114. robotframework_plugins/_assets/plugins/rf-core/variants/opencode/plugins/rf-core.js +93 -0
  115. robotframework_plugins/_assets/plugins/rf-desktop/.claude-plugin/plugin.json +24 -0
  116. robotframework_plugins/_assets/plugins/rf-desktop/CHANGELOG.md +9 -0
  117. robotframework_plugins/_assets/plugins/rf-desktop/README.md +26 -0
  118. robotframework_plugins/_assets/plugins/rf-desktop/catalog.yaml +23 -0
  119. robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/SKILL.md +266 -0
  120. robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/assets/examples/calculator.robot +45 -0
  121. robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/assets/examples/mock-deterministic.robot +33 -0
  122. robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/cli-and-inspector.md +82 -0
  123. robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/install.md +14 -0
  124. robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/keywords-reference.md +102 -0
  125. robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/locators-and-queries.md +95 -0
  126. robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/platform-setup.md +65 -0
  127. robotframework_plugins/_assets/plugins/rf-desktop/skills/rf-platynui/references/status-and-migration.md +41 -0
  128. robotframework_plugins/_assets/plugins/rf-mobile/.claude-plugin/plugin.json +24 -0
  129. robotframework_plugins/_assets/plugins/rf-mobile/CHANGELOG.md +9 -0
  130. robotframework_plugins/_assets/plugins/rf-mobile/README.md +26 -0
  131. robotframework_plugins/_assets/plugins/rf-mobile/catalog.yaml +23 -0
  132. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/SKILL.md +134 -0
  133. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/assets/examples/android-basic.robot +60 -0
  134. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/assets/examples/gestures-example.robot +59 -0
  135. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/assets/examples/hybrid-app.robot +54 -0
  136. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/assets/examples/ios-basic.robot +48 -0
  137. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/capabilities.md +117 -0
  138. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/gestures-touch.md +84 -0
  139. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/install.md +21 -0
  140. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/locators-mobile.md +74 -0
  141. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/platform-specific.md +105 -0
  142. robotframework_plugins/_assets/plugins/rf-mobile/skills/rf-appium/references/troubleshooting.md +70 -0
  143. robotframework_plugins/_assets/plugins/rf-web/.claude-plugin/plugin.json +25 -0
  144. robotframework_plugins/_assets/plugins/rf-web/CHANGELOG.md +9 -0
  145. robotframework_plugins/_assets/plugins/rf-web/README.md +27 -0
  146. robotframework_plugins/_assets/plugins/rf-web/catalog.yaml +27 -0
  147. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/SKILL.md +132 -0
  148. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/assets/examples/authentication-flow.robot +34 -0
  149. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/assets/examples/basic-web-test.robot +29 -0
  150. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/assets/examples/form-handling.robot +49 -0
  151. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/assets/examples/iframe-shadow-dom.robot +31 -0
  152. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/assertion-engine.md +79 -0
  153. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/authentication-storage.md +86 -0
  154. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/browser-context-page.md +110 -0
  155. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/downloads-uploads.md +51 -0
  156. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/iframes-shadow-dom.md +67 -0
  157. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/install.md +67 -0
  158. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/locators.md +83 -0
  159. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/migrate-from-selenium.md +22 -0
  160. robotframework_plugins/_assets/plugins/rf-web/skills/rf-browser/references/troubleshooting.md +100 -0
  161. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/SKILL.md +123 -0
  162. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/assets/examples/basic-web-test.robot +64 -0
  163. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/assets/examples/multi-window.robot +55 -0
  164. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/assets/examples/wait-patterns.robot +53 -0
  165. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/browser-setup.md +103 -0
  166. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/frames-windows.md +84 -0
  167. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/install.md +12 -0
  168. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/javascript-execution.md +65 -0
  169. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/locators.md +86 -0
  170. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/troubleshooting.md +122 -0
  171. robotframework_plugins/_assets/plugins/rf-web/skills/rf-selenium/references/waiting-strategies.md +84 -0
  172. robotframework_plugins/_assets.py +120 -0
  173. robotframework_plugins/_catalog.py +123 -0
  174. robotframework_plugins/_snapshot.py +230 -0
  175. robotframework_plugins/adapters/__init__.py +53 -0
  176. robotframework_plugins/adapters/_base.py +400 -0
  177. robotframework_plugins/adapters/claude_code.py +312 -0
  178. robotframework_plugins/adapters/claude_desktop.py +129 -0
  179. robotframework_plugins/adapters/codex.py +276 -0
  180. robotframework_plugins/adapters/copilot.py +87 -0
  181. robotframework_plugins/adapters/cursor.py +295 -0
  182. robotframework_plugins/adapters/goose.py +240 -0
  183. robotframework_plugins/adapters/opencode.py +170 -0
  184. robotframework_plugins/bundle.py +85 -0
  185. robotframework_plugins/cli.py +1311 -0
  186. robotframework_plugins/detect.py +121 -0
  187. robotframework_plugins/manifest.py +338 -0
  188. robotframework_plugins/py.typed +0 -0
  189. robotframework_plugins/skillzip.py +39 -0
  190. robotframework_plugins/transforms.py +725 -0
  191. robotframework_plugins-2026.11.0.dev1.dist-info/METADATA +178 -0
  192. robotframework_plugins-2026.11.0.dev1.dist-info/RECORD +195 -0
  193. robotframework_plugins-2026.11.0.dev1.dist-info/WHEEL +4 -0
  194. robotframework_plugins-2026.11.0.dev1.dist-info/entry_points.txt +2 -0
  195. robotframework_plugins-2026.11.0.dev1.dist-info/licenses/LICENSE +201 -0
@@ -0,0 +1,240 @@
1
+ """Adapter for Project Goose.
2
+
3
+ Goose (v1.25+ Summon extension) loads Agent Skills from
4
+ ``~/.agents/skills/``; it has no subagents or hooks. We install:
5
+
6
+ * skills → ``~/.agents/skills/<name>/`` (verbatim SKILL.md trees);
7
+ * a short persona-style hint file composed from each subagent's
8
+ frontmatter ``description`` and a list of available skills, written
9
+ to ``~/.goosehints`` (the file lives directly in ``$HOME``, not
10
+ inside the Goose config dir).
11
+
12
+ Subagents and hooks are *not* installable; the plan adds notes when the
13
+ user asked for those categories.
14
+
15
+ If ``--prefix`` is provided, ``.goosehints`` lands inside the prefix
16
+ dir — that's the "sandbox" tests rely on.
17
+ """
18
+
19
+ from __future__ import annotations
20
+
21
+ import shutil
22
+ import sys
23
+ from contextlib import ExitStack
24
+ from dataclasses import dataclass
25
+ from pathlib import Path
26
+
27
+ from .. import _assets
28
+ from .. import transforms as _x
29
+ from ._base import AdapterBase, ConfigMergeOp, InstallOptions, InstallPlan, InstallTarget, support_dir_name
30
+
31
+
32
+ EXTENSIONS_KEY = "extensions"
33
+ GOOSEHINTS_FILENAME = ".goosehints"
34
+ CONFIG_FILENAME = "config.yaml"
35
+
36
+
37
+ @dataclass
38
+ class GooseAdapter(AdapterBase):
39
+ name: str = "goose"
40
+ pretty: str = "Project Goose"
41
+ user_root_subpath: tuple[str, ...] = (".config", "goose")
42
+ project_root_subpath: tuple[str, ...] = (".goose",)
43
+
44
+ # ------------------------------------------------------------------
45
+ # detect
46
+ # ------------------------------------------------------------------
47
+
48
+ def detect(self) -> bool:
49
+ """True if the ``goose`` CLI is on PATH or any Goose dotfile exists."""
50
+ if shutil.which("goose") is not None:
51
+ return True
52
+ home = Path.home()
53
+ if (home / ".config" / "goose").is_dir():
54
+ return True
55
+ if (home / GOOSEHINTS_FILENAME).is_file():
56
+ return True
57
+ return False
58
+
59
+ # ------------------------------------------------------------------
60
+ # install_root overrides — Windows uses %APPDATA%/Block/goose/config
61
+ # ------------------------------------------------------------------
62
+
63
+ def install_root(self, opts: InstallOptions) -> Path:
64
+ if opts.prefix is not None:
65
+ return opts.prefix
66
+ if opts.scope == "project":
67
+ project = opts.project_dir
68
+ if project is None:
69
+ raise ValueError("--project required when --scope project")
70
+ return project.joinpath(*self.project_root_subpath)
71
+ if sys.platform == "win32":
72
+ # Goose on Windows: %APPDATA%\Block\goose\config\config.yaml
73
+ import os
74
+ appdata = os.environ.get("APPDATA")
75
+ if appdata:
76
+ return Path(appdata) / "Block" / "goose" / "config"
77
+ # Fallback: the POSIX layout under HOME (rarely used on Windows
78
+ # but keeps tests deterministic when APPDATA is unset).
79
+ return Path.home() / ".config" / "goose"
80
+ return Path.home() / ".config" / "goose"
81
+
82
+ def _goosehints_path(self, opts: InstallOptions) -> Path:
83
+ """Goose reads ``~/.goosehints`` directly from $HOME — *not* inside
84
+ the config dir. With ``--prefix`` we co-locate it there for the
85
+ sandbox-friendly install layout the tests assume."""
86
+ if opts.prefix is not None:
87
+ return opts.prefix / GOOSEHINTS_FILENAME
88
+ if opts.scope == "project":
89
+ project = opts.project_dir if opts.project_dir is not None else Path.cwd()
90
+ return project / GOOSEHINTS_FILENAME
91
+ return Path.home() / GOOSEHINTS_FILENAME
92
+
93
+ def _skills_root(self, opts: InstallOptions) -> Path:
94
+ """Goose v1.25+ reads skills from ``~/.agents/skills/`` (global) or
95
+ ``<project>/.agents/skills/`` (project). The Summon extension
96
+ auto-discovers them at startup — no registration needed.
97
+
98
+ ``--prefix`` co-locates skills at ``<prefix>/agents/skills/`` so the
99
+ sandbox tests don't need to assume a writable ``$HOME/.agents/``.
100
+ """
101
+ if opts.prefix is not None:
102
+ return opts.prefix / "agents" / "skills"
103
+ if opts.scope == "project":
104
+ project = opts.project_dir if opts.project_dir is not None else Path.cwd()
105
+ return project / ".agents" / "skills"
106
+ return Path.home() / ".agents" / "skills"
107
+
108
+ # ------------------------------------------------------------------
109
+ # plan
110
+ # ------------------------------------------------------------------
111
+
112
+ def plan(self, opts: InstallOptions) -> InstallPlan:
113
+ root = self.install_root(opts)
114
+ skills_root = self._skills_root(opts)
115
+ targets: list[InstallTarget] = []
116
+ merges: list[ConfigMergeOp] = []
117
+ notes: list[str] = []
118
+
119
+ with _assets.asset_root_path(opts.plugin) as src_root:
120
+ # 1. Skills → ~/.agents/skills/<name>/ (Goose v1.25+ Summon
121
+ # extension auto-discovers them). SKILL.md format is
122
+ # identical to Anthropic's — verbatim copy plus
123
+ # ${CLAUDE_PLUGIN_ROOT} substitution. The skill body's
124
+ # references / scripts / assets subdirs come along too.
125
+ # Goose has no plugin-root env var of its own (per
126
+ # docs.goose-docs.ai/.../using-skills/), so the
127
+ # install-time substitution is what makes the skill's
128
+ # bash blocks resolvable.
129
+ if "skills" in opts.what:
130
+ skills_src = src_root / "skills"
131
+ if skills_src.is_dir():
132
+ plugin_root_abs = _x.to_native_path_string(
133
+ (root / support_dir_name(opts.plugin)).resolve()
134
+ )
135
+ for f in sorted(skills_src.rglob("*")):
136
+ if not f.is_file():
137
+ continue
138
+ rel = f.relative_to(skills_src)
139
+ targets.append(InstallTarget(
140
+ dst=skills_root / rel,
141
+ payload=self.render_skill_dir(
142
+ self._read_with_substitution(f, plugin_root_abs),
143
+ f, skills_root / rel.parts[0],
144
+ ),
145
+ transform_name="plugin_root_substitution",
146
+ ))
147
+
148
+ # 2. Goosehints — Goose has no subagent primitive, so we fold
149
+ # subagent descriptions plus a skill index into the hints
150
+ # file. This ALSO helps users discover the skills installed
151
+ # in step 1 by giving them a single high-level summary.
152
+ # One hints file for the whole install: the first plugin's plan
153
+ # writes it and lists every selected plugin's agents and skills.
154
+ owner = _assets.DEFAULT_PLUGIN if _assets.DEFAULT_PLUGIN in opts.plugins else opts.plugins[0]
155
+ if {"skills", "agents"} & opts.what and opts.plugin == owner:
156
+ with ExitStack() as stack:
157
+ roots = [Path(stack.enter_context(_assets.asset_root_path(n))) for n in opts.plugins]
158
+ hints_text = self._compose_goosehints(*roots)
159
+ targets.append(InstallTarget(
160
+ dst=self._goosehints_path(opts),
161
+ payload=hints_text.encode("utf-8"),
162
+ transform_name="goosehints_persona",
163
+ ))
164
+
165
+ # 4. Honest skip-notes for the categories Goose still lacks.
166
+ if "agents" in opts.what:
167
+ notes.append(
168
+ "Goose has no native subagent primitive — subagent "
169
+ "descriptions are folded into .goosehints instead."
170
+ )
171
+ if "hooks" in opts.what:
172
+ notes.append(
173
+ "Goose has no hooks system — hooks were skipped."
174
+ )
175
+
176
+ return InstallPlan(
177
+ targets=tuple(targets),
178
+ merges=tuple(merges),
179
+ notes=tuple(notes),
180
+ )
181
+
182
+ # ------------------------------------------------------------------
183
+ # internals
184
+ # ------------------------------------------------------------------
185
+
186
+ @staticmethod
187
+ def _read_with_substitution(src: Path, plugin_root_abs: str) -> bytes:
188
+ data = src.read_bytes()
189
+ if _x.is_substitution_candidate(src):
190
+ return _x.substitute_plugin_root_bytes(data, plugin_root_abs)
191
+ return data
192
+
193
+ # ------------------------------------------------------------------
194
+ # post_install
195
+ # ------------------------------------------------------------------
196
+
197
+ def post_install(self, opts: InstallOptions) -> list[str]:
198
+ return [
199
+ "Skills were installed to ~/.agents/skills (loaded by Goose's Summon "
200
+ "extension); subagents are summarised in .goosehints. Goose has no "
201
+ "hooks, so none were installed.",
202
+ "Restart your Goose session to pick up the skills.",
203
+ ]
204
+
205
+ # ------------------------------------------------------------------
206
+ # internals
207
+ # ------------------------------------------------------------------
208
+
209
+ def _compose_goosehints(self, *src_roots: Path) -> str:
210
+ """Build a short persona-style hint text from agents + skills.
211
+
212
+ Format:
213
+
214
+ # rf-agentskills available
215
+ When working with Robot Framework:
216
+ - <agent-name>: <description>
217
+ - ...
218
+ - Skills: <comma-separated list of skill dirs>
219
+ """
220
+ lines: list[str] = [
221
+ "# rf-agentskills available",
222
+ "When working with Robot Framework:",
223
+ ]
224
+ for agent_md in sorted(md for root in src_roots for md in (root / "agents").glob("*.md")):
225
+ doc = _x.parse_frontmatter(agent_md.read_text(encoding="utf-8"))
226
+ agent_name = str(doc.frontmatter.get("name") or agent_md.stem)
227
+ description = str(doc.frontmatter.get("description") or "").strip()
228
+ if description:
229
+ lines.append(f"- {agent_name}: {description}")
230
+ else:
231
+ lines.append(f"- {agent_name}")
232
+
233
+ skill_names = sorted(
234
+ p.name for root in src_roots if (root / "skills").is_dir()
235
+ for p in (root / "skills").iterdir() if p.is_dir()
236
+ )
237
+ if skill_names:
238
+ lines.append(f"- Skills: {', '.join(skill_names)}")
239
+
240
+ return "\n".join(lines) + "\n"
@@ -0,0 +1,170 @@
1
+ """Adapter for OpenCode (sst/opencode).
2
+
3
+ Per opencode.ai/docs/skills/ (page updated 2026-05-07), OpenCode now
4
+ loads SKILL.md natively via a built-in ``skill`` tool. Skill folders
5
+ are auto-discovered from any of:
6
+
7
+ * ``<project>/.opencode/skills/<name>/SKILL.md`` (project)
8
+ * ``~/.config/opencode/skills/<name>/SKILL.md`` (user, XDG)
9
+ * Plus cross-vendor: ``.claude/skills/`` and ``.agents/skills/``
10
+
11
+ Layout produced:
12
+
13
+ * ``<root>/skills/<name>/`` (+ subtree) — verbatim SKILL.md copy
14
+ * ``<root>/agents/<name>.md`` — the generated OpenCode subagent
15
+ variant (``mode: subagent``)
16
+ * ``<root>/plugins/rf-core.js`` — generated JS plugin that runs the
17
+ shared hook scripts on OpenCode events
18
+ * ``<root>/rf-core-files/scripts/`` — those hook scripts (the plugin
19
+ resolves them relative to itself)
20
+
21
+ User scope: ``~/.config/opencode/``. Project scope: ``<project>/.opencode/``.
22
+ Variants come from ``plugins/rf-core/variants/opencode/``
23
+ (``scripts/build-agent-variants.py``).
24
+ """
25
+
26
+ from __future__ import annotations
27
+
28
+ import shutil
29
+ from dataclasses import dataclass
30
+ from pathlib import Path
31
+ from typing import Iterable
32
+
33
+ from .. import _assets
34
+ from .. import transforms as _x
35
+ from ._base import AdapterBase, InstallOptions, InstallPlan, InstallTarget, support_dir_name
36
+
37
+
38
+ OPENCODE_JSON = "opencode.json"
39
+
40
+
41
+ @dataclass
42
+ class OpenCodeAdapter(AdapterBase):
43
+ name: str = "opencode"
44
+ pretty: str = "OpenCode"
45
+ user_root_subpath: tuple[str, ...] = (".config", "opencode")
46
+ project_root_subpath: tuple[str, ...] = (".opencode",)
47
+
48
+ # ------------------------------------------------------------------
49
+ # detect
50
+ # ------------------------------------------------------------------
51
+
52
+ def detect(self) -> bool:
53
+ if shutil.which("opencode") is not None:
54
+ return True
55
+ return (Path.home() / ".config" / "opencode").is_dir()
56
+
57
+ # ------------------------------------------------------------------
58
+ # plan
59
+ # ------------------------------------------------------------------
60
+
61
+ def plan(self, opts: InstallOptions) -> InstallPlan:
62
+ root = self.install_root(opts)
63
+ plugin_dst = root / support_dir_name(opts.plugin)
64
+ plugin_root_abs = _x.to_native_path_string(plugin_dst.resolve())
65
+
66
+ with _assets.asset_root_path(opts.plugin) as src_root:
67
+ targets = list(self._collect_targets(
68
+ src_root=src_root,
69
+ root=root,
70
+ plugin_dst=plugin_dst,
71
+ plugin_root_abs=plugin_root_abs,
72
+ what=opts.what,
73
+ ))
74
+
75
+ return InstallPlan(targets=tuple(targets))
76
+
77
+ def _collect_targets(
78
+ self,
79
+ *,
80
+ src_root: Path,
81
+ root: Path,
82
+ plugin_dst: Path,
83
+ plugin_root_abs: str,
84
+ what: frozenset[str],
85
+ ) -> Iterable[InstallTarget]:
86
+ variants = src_root / "variants" / "opencode"
87
+ # 1. Subagents → <root>/agents/<name>.md (generated OpenCode variants).
88
+ if "agents" in what:
89
+ for f in sorted((variants / "agents").glob("*.md")):
90
+ yield InstallTarget(
91
+ dst=root / "agents" / f.name,
92
+ payload=f.read_bytes(),
93
+ transform_name="opencode_agent_variant",
94
+ )
95
+
96
+ # 2. Skills → <root>/skills/<name>/ (OpenCode reads SKILL.md
97
+ # natively per opencode.ai/docs/skills/). Verbatim copy of
98
+ # the full skill tree.
99
+ if "skills" in what:
100
+ skills_src = src_root / "skills"
101
+ if skills_src.is_dir():
102
+ for f in sorted(skills_src.rglob("*")):
103
+ if not f.is_file():
104
+ continue
105
+ rel = f.relative_to(skills_src)
106
+ yield InstallTarget(
107
+ dst=root / "skills" / rel,
108
+ payload=self.render_skill_dir(
109
+ self._read_with_substitution(f, plugin_root_abs),
110
+ f, root / "skills" / rel.parts[0],
111
+ ),
112
+ transform_name="plugin_root_substitution",
113
+ )
114
+
115
+ # 3. Hooks → the generated JS plugin plus the hook scripts it runs.
116
+ if "hooks" in what:
117
+ yield from self._hook_targets(variants, src_root, root, plugin_dst)
118
+
119
+ @staticmethod
120
+ def _hook_targets(
121
+ variants: Path, src_root: Path, root: Path, plugin_dst: Path
122
+ ) -> Iterable[InstallTarget]:
123
+ plugin_js = variants / "plugins" / f"{plugin_dst.name.removesuffix('-files')}.js"
124
+ if not plugin_js.is_file():
125
+ return
126
+ yield InstallTarget(
127
+ dst=root / "plugins" / plugin_js.name,
128
+ payload=plugin_js.read_bytes(),
129
+ transform_name="opencode_plugin_variant",
130
+ )
131
+ for f in sorted((src_root / "scripts").glob("*")):
132
+ if f.is_file():
133
+ yield InstallTarget(
134
+ dst=plugin_dst / "scripts" / f.name,
135
+ payload=f.read_bytes(),
136
+ transform_name="opencode_hook_script",
137
+ )
138
+ # validate_robot and check_rf_environment read the pinned interpreter.
139
+ yield InstallTarget(
140
+ dst=plugin_dst / "scripts" / "python_runtime.json",
141
+ payload=_x.python_runtime_config_bytes(),
142
+ transform_name="python_runtime_pin",
143
+ )
144
+
145
+ # ------------------------------------------------------------------
146
+ # post_install
147
+ # ------------------------------------------------------------------
148
+
149
+ def post_install(self, opts: InstallOptions) -> list[str]:
150
+ notes = ["OpenCode picks up skills and subagents on next session."]
151
+ if "hooks" in opts.what:
152
+ notes.append(
153
+ "Hooks run through plugins/rf-core.js (needs `node` on PATH): "
154
+ ".robot/.resource validation after edits, Robot Framework error hints "
155
+ "after shell commands, and an environment report in the first tool "
156
+ "output. The prompt-context and end-of-task reminder hooks have no "
157
+ "OpenCode equivalent."
158
+ )
159
+ return notes
160
+
161
+ # ------------------------------------------------------------------
162
+ # internals
163
+ # ------------------------------------------------------------------
164
+
165
+ @staticmethod
166
+ def _read_with_substitution(src: Path, plugin_root_abs: str) -> bytes:
167
+ data = src.read_bytes()
168
+ if _x.is_substitution_candidate(src):
169
+ return _x.substitute_plugin_root_bytes(data, plugin_root_abs)
170
+ return data
@@ -0,0 +1,85 @@
1
+ """Public Python API to the plugin content this package bundles.
2
+
3
+ from robotframework_plugins import bundle
4
+
5
+ bundle.CATALOG_FORMAT # 1; changes only on a breaking change to catalog() entries
6
+ bundle.catalog() # the bundled plugins (active and deprecated)
7
+ bundle.skills_dirs() # {plugin: Path of its skills/ folder}, rf-core first
8
+ bundle.fetch("main") # opt-in: the same for a ref of the repository (network)
9
+
10
+ Only these names (and ``Snapshot``, ``FetchError``) are public; see the
11
+ "Python API" section of the README for the compatibility promise. Importing
12
+ this module, ``catalog()`` and ``skills_dirs()`` never use the network.
13
+ """
14
+
15
+ from __future__ import annotations
16
+
17
+ import atexit
18
+ import copy
19
+ import shutil
20
+ import tempfile
21
+ import threading
22
+ from pathlib import Path
23
+ from typing import Any
24
+
25
+ from . import _assets
26
+ from ._catalog import CATALOG_FORMAT, skill_dirs
27
+ from ._snapshot import FetchError, Snapshot, fetch
28
+
29
+ __all__ = ("CATALOG_FORMAT", "FetchError", "Snapshot", "catalog", "fetch", "skills_dirs")
30
+
31
+ _lock = threading.Lock()
32
+ _extracted: Path | None = None
33
+
34
+
35
+ def catalog() -> list[dict[str, Any]]:
36
+ """The bundled plugins (status active or deprecated), in catalogue order.
37
+
38
+ Each entry has at least ``name``, ``version``, ``status``, ``tier``,
39
+ ``summary``, ``libraries`` (``[{name, package, versions}]``),
40
+ ``robotframework``, ``dependencies``, ``bundle`` and ``bundled``. The list
41
+ is a copy: changing it doesn't change later results. Empty for a broken
42
+ build without a catalogue.
43
+ """
44
+ return copy.deepcopy(_assets.bundled_catalog())
45
+
46
+
47
+ def skills_dirs() -> dict[str, Path]:
48
+ """``{plugin name: absolute Path of its skills/ folder}``.
49
+
50
+ Every active plugin that isn't a bundle and has skills, ``rf-core`` first,
51
+ then catalogue order. The folders exist for the life of the process, also
52
+ when the package is imported from a zip archive (then the bundle is copied
53
+ once to a temporary folder, removed at exit).
54
+ """
55
+ entries = _assets.bundled_catalog()
56
+ if not entries:
57
+ return {}
58
+ return skill_dirs(entries, _bundle_root())
59
+
60
+
61
+ def _bundle_root() -> Path:
62
+ """The bundle (``_assets/``) as a real directory."""
63
+ global _extracted
64
+ root = _assets.bundle_root_traversable()
65
+ if isinstance(root, Path):
66
+ return root
67
+ with _lock:
68
+ if _extracted is None:
69
+ target = Path(tempfile.mkdtemp(prefix="robotframework-plugins-bundle-"))
70
+ atexit.register(shutil.rmtree, target, True)
71
+ _copy_tree(root, target)
72
+ _extracted = target
73
+ return _extracted
74
+
75
+
76
+ def _copy_tree(src: Any, dest: Path) -> None:
77
+ """Copy an importlib Traversable tree; works where ``as_file`` can't copy
78
+ directories (Python 3.10 and 3.11)."""
79
+ for child in src.iterdir():
80
+ if child.is_dir():
81
+ sub = dest / child.name
82
+ sub.mkdir()
83
+ _copy_tree(child, sub)
84
+ else:
85
+ (dest / child.name).write_bytes(child.read_bytes())