robert-github-agent 0.1.0b1__tar.gz → 0.1.0b2__tar.gz

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 (184) hide show
  1. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/.github/workflows/ci.yml +10 -8
  2. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/.github/workflows/dco.yml +1 -1
  3. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/.github/workflows/release.yml +4 -4
  4. robert_github_agent-0.1.0b2/CHANGELOG.md +17 -0
  5. robert_github_agent-0.1.0b2/PKG-INFO +178 -0
  6. robert_github_agent-0.1.0b1/README_ZH.md → robert_github_agent-0.1.0b2/README.md +30 -58
  7. robert_github_agent-0.1.0b1/README.md → robert_github_agent-0.1.0b2/README_EN.md +18 -2
  8. robert_github_agent-0.1.0b2/docs/agent-install.md +183 -0
  9. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/docs/concepts.md +1 -2
  10. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/docs/development.md +120 -33
  11. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/docs/guides.md +1 -1
  12. robert_github_agent-0.1.0b2/docs/human-install.md +42 -0
  13. robert_github_agent-0.1.0b2/docs/imgs/openclaw-robert-status.png +0 -0
  14. robert_github_agent-0.1.0b2/docs/imgs/webui-task-board.png +0 -0
  15. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/docs/reference.md +79 -3
  16. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/pyproject.toml +6 -2
  17. robert_github_agent-0.1.0b2/src/robert_agent/__init__.py +1 -0
  18. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/cli/main.py +26 -4
  19. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/dispatch.py +16 -0
  20. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/init_config.py +13 -0
  21. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/integrations/openclaw.py +128 -1
  22. robert_github_agent-0.1.0b2/src/robert_agent/resources/config.example.yml +33 -0
  23. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/schemas/config.schema.json +17 -0
  24. robert_github_agent-0.1.0b2/src/robert_agent/service.py +384 -0
  25. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/validate_config.py +45 -18
  26. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_cli.py +60 -0
  27. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_config_and_schema.py +21 -3
  28. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_daemon.py +9 -9
  29. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_distribution.py +5 -2
  30. robert_github_agent-0.1.0b2/tests/test_docs.py +82 -0
  31. robert_github_agent-0.1.0b2/tests/test_openclaw.py +83 -0
  32. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_run_once.py +22 -4
  33. robert_github_agent-0.1.0b2/tests/test_service.py +145 -0
  34. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_worker_adapter_config.py +27 -0
  35. robert_github_agent-0.1.0b1/CHANGELOG.md +0 -9
  36. robert_github_agent-0.1.0b1/PKG-INFO +0 -217
  37. robert_github_agent-0.1.0b1/src/robert_agent/__init__.py +0 -1
  38. robert_github_agent-0.1.0b1/src/robert_agent/resources/config.example.yml +0 -20
  39. robert_github_agent-0.1.0b1/src/robert_agent/service.py +0 -161
  40. robert_github_agent-0.1.0b1/tests/test_docs.py +0 -43
  41. robert_github_agent-0.1.0b1/tests/test_openclaw.py +0 -19
  42. robert_github_agent-0.1.0b1/tests/test_service.py +0 -29
  43. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/.github/CODEOWNERS +0 -0
  44. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/.github/ISSUE_TEMPLATE/bug.yml +0 -0
  45. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/.github/ISSUE_TEMPLATE/config.yml +0 -0
  46. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/.github/ISSUE_TEMPLATE/documentation.yml +0 -0
  47. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/.github/ISSUE_TEMPLATE/feature.yml +0 -0
  48. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/.github/PULL_REQUEST_TEMPLATE.md +0 -0
  49. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/.github/dependabot.yml +0 -0
  50. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/.gitignore +0 -0
  51. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/AGENTS.md +0 -0
  52. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/COMMUNITY.md +0 -0
  53. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/LICENSE +0 -0
  54. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/acceptance.py +0 -0
  55. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/acceptance_suite.py +0 -0
  56. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/audit_result.py +0 -0
  57. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/authorize.py +0 -0
  58. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/board.py +0 -0
  59. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/chat_status.py +0 -0
  60. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/cli/__init__.py +0 -0
  61. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/cli/exit_codes.py +0 -0
  62. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/cli/output.py +0 -0
  63. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/common.py +0 -0
  64. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/controlled_e2e_acceptance.py +0 -0
  65. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/daemon.py +0 -0
  66. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/daemon_state.py +0 -0
  67. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/diagnostics.py +0 -0
  68. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/discover.py +0 -0
  69. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/doctor.py +0 -0
  70. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/github_api.py +0 -0
  71. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/integrations/__init__.py +0 -0
  72. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/live_discovery_acceptance.py +0 -0
  73. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/live_worker_acceptance.py +0 -0
  74. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/live_worktree_acceptance.py +0 -0
  75. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/loop_engine.py +0 -0
  76. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/memory_curator.py +0 -0
  77. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/migrate.py +0 -0
  78. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/notify.py +0 -0
  79. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/paths.py +0 -0
  80. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/production_write_canary.py +0 -0
  81. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/project_memory.py +0 -0
  82. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/publish.py +0 -0
  83. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/publish_dedupe_acceptance.py +0 -0
  84. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/redaction.py +0 -0
  85. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/render_prompt.py +0 -0
  86. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resource_files.py +0 -0
  87. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/__init__.py +0 -0
  88. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/acceptance-matrix.md +0 -0
  89. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/classifier.md +0 -0
  90. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/command-matrix.md +0 -0
  91. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/db/migrations/001_legacy_dd_to_robert.sql +0 -0
  92. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/db/schema.sql +0 -0
  93. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/failure-modes.md +0 -0
  94. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/fixtures/actor-permission.json +0 -0
  95. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/fixtures/discovery.json +0 -0
  96. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/fixtures/redaction.json +0 -0
  97. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/fixtures/review-followup.json +0 -0
  98. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/fixtures/worker-results.json +0 -0
  99. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/fixtures/workstreams.json +0 -0
  100. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/github-events.md +0 -0
  101. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/kanban-control.md +0 -0
  102. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/redaction.md +0 -0
  103. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/result-contract.md +0 -0
  104. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/routes.yml +0 -0
  105. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/schemas/event.schema.json +0 -0
  106. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/schemas/result.schema.json +0 -0
  107. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/schemas/route.schema.json +0 -0
  108. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/schemas/snapshot.schema.json +0 -0
  109. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/schemas/task.schema.json +0 -0
  110. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/trust-model.md +0 -0
  111. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/worker-prompt.md +0 -0
  112. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/worker-protocol.md +0 -0
  113. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/workflow.yml +0 -0
  114. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/workstream-model.md +0 -0
  115. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/route.py +0 -0
  116. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/route_config.py +0 -0
  117. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/run_once.py +0 -0
  118. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/runtime_knowledge.py +0 -0
  119. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/skills.py +0 -0
  120. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/status.py +0 -0
  121. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/storage.py +0 -0
  122. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/summarize.py +0 -0
  123. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/supervise.py +0 -0
  124. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/usage.py +0 -0
  125. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/wakeup.py +0 -0
  126. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/web.py +0 -0
  127. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/web_assets/board.css +0 -0
  128. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/web_assets/board.html +0 -0
  129. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/web_assets/board.js +0 -0
  130. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/web_assets/github-shell.css +0 -0
  131. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/web_assets/index.html +0 -0
  132. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/web_assets/operations.css +0 -0
  133. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/web_assets/workbench.css +0 -0
  134. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/web_assets/workbench.js +0 -0
  135. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/work_items.py +0 -0
  136. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/workbench.py +0 -0
  137. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/worker/__init__.py +0 -0
  138. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/worker/heartbeat.py +0 -0
  139. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/worker/result.py +0 -0
  140. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/worker/snapshot.py +0 -0
  141. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/worker_adapters/__init__.py +0 -0
  142. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/worker_adapters/cbc.py +0 -0
  143. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/worker_adapters/codex.py +0 -0
  144. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/worker_adapters/command.py +0 -0
  145. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/worker_adapters/tcodex.py +0 -0
  146. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/worker_heartbeat.py +0 -0
  147. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/worker_result.py +0 -0
  148. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/worker_snapshot.py +0 -0
  149. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/workstream.py +0 -0
  150. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/worktree.py +0 -0
  151. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/__init__.py +0 -0
  152. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/support.py +0 -0
  153. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_acceptance_suite.py +0 -0
  154. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_board.py +0 -0
  155. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_board_control_integration.py +0 -0
  156. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_controlled_e2e_acceptance.py +0 -0
  157. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_diagnostics.py +0 -0
  158. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_discovery_authorization.py +0 -0
  159. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_github_event_matrix.py +0 -0
  160. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_init_and_doctor.py +0 -0
  161. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_live_discovery_acceptance.py +0 -0
  162. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_live_worker_acceptance.py +0 -0
  163. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_live_worktree_acceptance.py +0 -0
  164. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_loop_engine.py +0 -0
  165. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_migration.py +0 -0
  166. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_operational_commands.py +0 -0
  167. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_package_layout.py +0 -0
  168. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_paths.py +0 -0
  169. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_production_write_canary.py +0 -0
  170. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_project_memory.py +0 -0
  171. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_public_surface.py +0 -0
  172. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_publish_dedupe_acceptance.py +0 -0
  173. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_redaction.py +0 -0
  174. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_route_config.py +0 -0
  175. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_routing.py +0 -0
  176. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_runtime_knowledge.py +0 -0
  177. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_skills.py +0 -0
  178. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_web_security.py +0 -0
  179. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_work_items.py +0 -0
  180. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_workbench.py +0 -0
  181. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_worker_protocol.py +0 -0
  182. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_workflow_matrix.py +0 -0
  183. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_workspace_resolution.py +0 -0
  184. {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_workstreams.py +0 -0
@@ -17,8 +17,8 @@ jobs:
17
17
  python: ["3.10", "3.11", "3.12", "3.13", "3.14"]
18
18
  runs-on: ${{ matrix.os }}
19
19
  steps:
20
- - uses: actions/checkout@v4
21
- - uses: actions/setup-python@v5
20
+ - uses: actions/checkout@v7
21
+ - uses: actions/setup-python@v7
22
22
  with:
23
23
  python-version: ${{ matrix.python }}
24
24
  cache: pip
@@ -42,8 +42,8 @@ jobs:
42
42
  wheel-smoke:
43
43
  runs-on: ubuntu-latest
44
44
  steps:
45
- - uses: actions/checkout@v4
46
- - uses: actions/setup-python@v5
45
+ - uses: actions/checkout@v7
46
+ - uses: actions/setup-python@v7
47
47
  with:
48
48
  python-version: "3.12"
49
49
  - run: python -m pip install build
@@ -56,21 +56,23 @@ jobs:
56
56
  secret-scan:
57
57
  runs-on: ubuntu-latest
58
58
  steps:
59
- - uses: actions/checkout@v4
59
+ - uses: actions/checkout@v7
60
60
  with:
61
61
  fetch-depth: 0
62
- - uses: gitleaks/gitleaks-action@v2
62
+ - uses: gitleaks/gitleaks-action@v3
63
+ env:
64
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
63
65
 
64
66
  docs-links:
65
67
  runs-on: ubuntu-latest
66
68
  steps:
67
- - uses: actions/checkout@v4
69
+ - uses: actions/checkout@v7
68
70
  - uses: lycheeverse/lychee-action@v2
69
71
  with:
70
72
  failIfEmpty: false
71
73
  args: >-
72
74
  --no-progress
73
75
  README.md
74
- README_ZH.md
76
+ README_EN.md
75
77
  COMMUNITY.md
76
78
  docs
@@ -10,7 +10,7 @@ jobs:
10
10
  dco:
11
11
  runs-on: ubuntu-latest
12
12
  steps:
13
- - uses: actions/checkout@v4
13
+ - uses: actions/checkout@v7
14
14
  with:
15
15
  fetch-depth: 0
16
16
  - name: Verify Signed-off-by trailers
@@ -15,8 +15,8 @@ jobs:
15
15
  runs-on: ubuntu-latest
16
16
  environment: pypi
17
17
  steps:
18
- - uses: actions/checkout@v4
19
- - uses: actions/setup-python@v5
18
+ - uses: actions/checkout@v7
19
+ - uses: actions/setup-python@v7
20
20
  with:
21
21
  python-version: "3.12"
22
22
  - run: python -m pip install --upgrade pip
@@ -24,11 +24,11 @@ jobs:
24
24
  - run: python -m pip install build
25
25
  - run: python -B -m unittest discover -s tests
26
26
  - run: python -m build
27
- - uses: actions/attest-build-provenance@v2
27
+ - uses: actions/attest-build-provenance@v4
28
28
  with:
29
29
  subject-path: "dist/*"
30
30
  - uses: pypa/gh-action-pypi-publish@release/v1
31
- - uses: softprops/action-gh-release@v2
31
+ - uses: softprops/action-gh-release@v3
32
32
  with:
33
33
  files: dist/*
34
34
  generate_release_notes: true
@@ -0,0 +1,17 @@
1
+ # Changelog
2
+
3
+ ## 0.1.0b2
4
+
5
+ - Add a Supervisor fallback for Linux hosts without user systemd, including service status and control support.
6
+ - Improve OpenClaw plugin installation diagnostics and verify installed commands expose Robert capabilities.
7
+ - Nest daemon configuration settings in the generated config and schema.
8
+ - Fix GitHub Actions release, DCO, gitleaks, documentation-link, and worker-dispatch checks.
9
+ - Refresh installation documentation, README copy, and Web UI/OpenClaw screenshots.
10
+
11
+ ## 0.1.0b1
12
+
13
+ - Initial public beta of Robert.
14
+ - Standalone Python package and `robert` CLI.
15
+ - Multi-repository trusted GitHub workstreams.
16
+ - Configurable worker adapters and route skills.
17
+ - Native user services, local web UI, and optional OpenClaw commands.
@@ -0,0 +1,178 @@
1
+ Metadata-Version: 2.4
2
+ Name: robert-github-agent
3
+ Version: 0.1.0b2
4
+ Summary: An AI teammate that takes care of your GitHub work.
5
+ Project-URL: Homepage, https://github.com/wklken/robert
6
+ Project-URL: Documentation, https://github.com/wklken/robert/tree/main/docs
7
+ Project-URL: Issues, https://github.com/wklken/robert/issues
8
+ Author: Robert contributors
9
+ License-Expression: Apache-2.0
10
+ License-File: LICENSE
11
+ Classifier: Development Status :: 4 - Beta
12
+ Classifier: Environment :: Console
13
+ Classifier: License :: OSI Approved :: Apache Software License
14
+ Classifier: Operating System :: MacOS
15
+ Classifier: Operating System :: POSIX :: Linux
16
+ Classifier: Programming Language :: Python :: 3
17
+ Classifier: Programming Language :: Python :: 3.10
18
+ Classifier: Programming Language :: Python :: 3.11
19
+ Classifier: Programming Language :: Python :: 3.12
20
+ Classifier: Programming Language :: Python :: 3.13
21
+ Classifier: Programming Language :: Python :: 3.14
22
+ Classifier: Topic :: Software Development
23
+ Requires-Python: >=3.10
24
+ Requires-Dist: pyyaml<7,>=6.0
25
+ Requires-Dist: supervisor<5,>=4.2
26
+ Provides-Extra: dev
27
+ Requires-Dist: build; extra == 'dev'
28
+ Requires-Dist: mypy; extra == 'dev'
29
+ Requires-Dist: pip-audit; extra == 'dev'
30
+ Requires-Dist: ruff; extra == 'dev'
31
+ Requires-Dist: tomli; (python_version < '3.11') and extra == 'dev'
32
+ Requires-Dist: twine; extra == 'dev'
33
+ Requires-Dist: types-pyyaml; extra == 'dev'
34
+ Description-Content-Type: text/markdown
35
+
36
+ # Robert
37
+
38
+ [English](README_EN.md) | [简体中文](README.md)
39
+
40
+ **Your Repo Teammate**
41
+
42
+ An AI teammate that takes care of your GitHub work.
43
+
44
+ Robert 是一个自托管的 GitHub 队友。它把可信的 Issue、提及、指派、评审和
45
+ 后续评论转换为受控的编码代理任务,并通过 Git worktree、审计门禁和 SQLite
46
+ 持久状态保证无人值守运行仍然可检查、可恢复。Robert 是运行在本机的 GitHub
47
+ 协作控制面:它发现事件、校验信任关系、选择路由和 Worker、监督执行、审计
48
+ 计划中的 GitHub 动作,并只发布路由允许的动作。
49
+
50
+ 编码代理本身不能解决授权、并发、去重、失败恢复和证据留存。Robert 将这些
51
+ 约束做成稳定协议,不需要 GitHub App,也不需要托管控制服务。Robert
52
+ `0.1.0b2` 是公开 Beta,当前只使用轮询获取 GitHub 事件,稳定版之前接口仍
53
+ 可能调整。
54
+
55
+ ## 核心能力
56
+
57
+ - 处理可信的 Issue、PR、评审、指派和提及。
58
+ - 使用 SQLite 管理多仓库工作流;每个仓库有独立 checkout、worktree 根目录、
59
+ 可信 Actor、并发限制和路由覆盖。
60
+ - 内置 `codex`、`tcodex`、`cbc` 和通用 `command` Worker 适配器。
61
+ - 按路由配置 Worker、必需 Skill 和推荐 Skill;缺少必需 Skill 时会在创建
62
+ worktree 和启动 Worker 前阻止任务。
63
+ - 使用隔离的 Git worktree 进行分析、实现和源码评审。
64
+ - 支持 systemd 用户服务和 macOS LaunchAgent。
65
+ - 默认只读的本地 Web UI。
66
+ - 可选的 OpenClaw 只读聊天命令。
67
+
68
+ ## 工作流程
69
+
70
+ ```mermaid
71
+ flowchart LR
72
+ A[通过 gh 轮询 GitHub] --> B[规范化并校验授权]
73
+ B --> C[创建或恢复 workstream]
74
+ C --> D[选择路由和 Skill]
75
+ D --> E[准备隔离 workspace]
76
+ E --> F[运行配置的 Worker]
77
+ F --> G[审计结构化结果]
78
+ G -->|通过| H[去重并发布]
79
+ G -->|阻止| I[保存失败证据]
80
+ H --> J[(SQLite 状态)]
81
+ I --> J
82
+ ```
83
+
84
+ Robert 使用已认证的 `gh` CLI 轮询 GitHub,规范化事件,应用仓库级信任规则,
85
+ 创建或恢复 workstream,准备任务目录,启动本地 Worker,审计结构化结果,并
86
+ 在发布前执行去重。
87
+
88
+ ## 环境要求
89
+
90
+ - Linux 或 macOS;Windows 通过 WSL 使用。
91
+ - Python 3.10 或更高版本。
92
+ - Git 和已登录的 GitHub CLI。
93
+ - 至少一个本地 Worker 命令。
94
+ - 推荐使用 `pipx` 安装。
95
+
96
+ ## 使用编码 Agent 安装
97
+
98
+ 把下面的提示词复制给 Codex、Claude Code 或其他终端编码 Agent:
99
+
100
+ ```text
101
+ Install and fully configure Robert on this machine by following:
102
+ https://github.com/wklken/Robert/blob/main/docs/agent-install.md
103
+
104
+ Read the entire guide before executing. Ask me for required values and for
105
+ confirmation wherever the guide requires it.
106
+ ```
107
+
108
+ ## 配置
109
+
110
+ Robert 使用带版本号的 YAML。配置包括 GitHub 账号、Worker、Skill 搜索路径、
111
+ 路由覆盖和一个或多个本地仓库。详见
112
+ [docs/reference.md](docs/reference.md#configuration)。
113
+
114
+ ## 守护进程
115
+
116
+ ```bash
117
+ robert service install
118
+ robert service start
119
+ robert service status
120
+ ```
121
+
122
+ 无人值守运行使用 systemd 用户服务或 launchd。前台调试使用
123
+ `robert daemon run`。
124
+
125
+ ## 本地 Web UI
126
+
127
+ ![Robert Web UI 任务看板](docs/imgs/webui-task-board.png)
128
+
129
+ ```bash
130
+ robert web run
131
+ ```
132
+
133
+ 默认模式只读且仅监听本机。写入模式必须显式开启:
134
+
135
+ ```bash
136
+ robert web run --writable --operator "$USER"
137
+ ```
138
+
139
+ 非回环地址还必须使用 `--allow-remote`,并部署经过认证的反向代理。
140
+
141
+ ## OpenClaw 集成
142
+
143
+ ![OpenClaw 中的 Robert 状态](docs/imgs/openclaw-robert-status.png)
144
+
145
+ ```bash
146
+ robert openclaw install
147
+ robert openclaw status
148
+ ```
149
+
150
+ 插件只提供 Robert 状态、任务、运行和产物查询,不会启动 Robert,也不会创建
151
+ 定时任务。
152
+
153
+ ## 故障排查
154
+
155
+ 先运行 `robert doctor --output json` 和 `robert service status`。需要提供诊断
156
+ 信息时,生成经过脱敏的压缩包:
157
+
158
+ ```bash
159
+ robert diagnostics export --output robert-diagnostics.zip
160
+ ```
161
+
162
+ 不要在公开 Issue 中上传凭证或私有仓库内容。
163
+
164
+ ## 参与贡献
165
+
166
+ 阅读 [COMMUNITY.md](COMMUNITY.md),执行其中的验证命令,并使用
167
+ `git commit -s` 签署提交。首个 Beta 使用 DCO,不要求 CLA。
168
+
169
+ ## 安全与信任模型
170
+
171
+ GitHub 文本始终按不可信输入处理。只有配置中的可信 Actor 能触发工作。仓库
172
+ 覆盖不能改变路由的 GitHub 权限和 workspace 策略。Worker 环境变量采用白名单,
173
+ 配置文件不保存 GitHub Token,所有对外文本都经过脱敏和审计。Web UI 默认绑定
174
+ `127.0.0.1`。
175
+
176
+ ## 许可证
177
+
178
+ Apache License 2.0,详见 `LICENSE`。
@@ -1,6 +1,6 @@
1
1
  # Robert
2
2
 
3
- [English](README.md) | [简体中文](README_ZH.md)
3
+ [English](README_EN.md) | [简体中文](README.md)
4
4
 
5
5
  **Your Repo Teammate**
6
6
 
@@ -8,28 +8,27 @@ An AI teammate that takes care of your GitHub work.
8
8
 
9
9
  Robert 是一个自托管的 GitHub 队友。它把可信的 Issue、提及、指派、评审和
10
10
  后续评论转换为受控的编码代理任务,并通过 Git worktree、审计门禁和 SQLite
11
- 持久状态保证无人值守运行仍然可检查、可恢复。
12
-
13
- ## Robert 是什么
14
-
15
- Robert 是运行在本机的 GitHub 协作控制面。它发现事件、校验信任关系、选择
16
- 路由和 Worker、监督执行、审计计划中的 GitHub 动作,并只发布路由允许的动作。
17
-
18
- ## 为什么需要 Robert
11
+ 持久状态保证无人值守运行仍然可检查、可恢复。Robert 是运行在本机的 GitHub
12
+ 协作控制面:它发现事件、校验信任关系、选择路由和 Worker、监督执行、审计
13
+ 计划中的 GitHub 动作,并只发布路由允许的动作。
19
14
 
20
15
  编码代理本身不能解决授权、并发、去重、失败恢复和证据留存。Robert 将这些
21
- 约束做成稳定协议,不需要 GitHub App,也不需要托管控制服务。
16
+ 约束做成稳定协议,不需要 GitHub App,也不需要托管控制服务。Robert
17
+ `0.1.0b2` 是公开 Beta,当前只使用轮询获取 GitHub 事件,稳定版之前接口仍
18
+ 可能调整。
22
19
 
23
20
  ## 核心能力
24
21
 
25
22
  - 处理可信的 Issue、PR、评审、指派和提及。
26
- - 使用 SQLite 管理多仓库工作流。
27
- - 按路由配置 Worker、必需 Skill 和推荐 Skill。
23
+ - 使用 SQLite 管理多仓库工作流;每个仓库有独立 checkout、worktree 根目录、
24
+ 可信 Actor、并发限制和路由覆盖。
25
+ - 内置 `codex`、`tcodex`、`cbc` 和通用 `command` Worker 适配器。
26
+ - 按路由配置 Worker、必需 Skill 和推荐 Skill;缺少必需 Skill 时会在创建
27
+ worktree 和启动 Worker 前阻止任务。
28
28
  - 使用隔离的 Git worktree 进行分析、实现和源码评审。
29
29
  - 支持 systemd 用户服务和 macOS LaunchAgent。
30
30
  - 默认只读的本地 Web UI。
31
31
  - 可选的 OpenClaw 只读聊天命令。
32
- - 安全迁移原 `dd-github-agent` 目录中的配置和数据库。
33
32
 
34
33
  ## 工作流程
35
34
 
@@ -51,13 +50,6 @@ Robert 使用已认证的 `gh` CLI 轮询 GitHub,规范化事件,应用仓
51
50
  创建或恢复 workstream,准备任务目录,启动本地 Worker,审计结构化结果,并
52
51
  在发布前执行去重。
53
52
 
54
- ## 安全与信任模型
55
-
56
- GitHub 文本始终按不可信输入处理。只有配置中的可信 Actor 能触发工作。仓库
57
- 覆盖不能改变路由的 GitHub 权限和 workspace 策略。Worker 环境变量采用白名单,
58
- 配置文件不保存 GitHub Token,所有对外文本都经过脱敏和审计。Web UI 默认绑定
59
- `127.0.0.1`。
60
-
61
53
  ## 环境要求
62
54
 
63
55
  - Linux 或 macOS;Windows 通过 WSL 使用。
@@ -66,19 +58,17 @@ GitHub 文本始终按不可信输入处理。只有配置中的可信 Actor 能
66
58
  - 至少一个本地 Worker 命令。
67
59
  - 推荐使用 `pipx` 安装。
68
60
 
69
- ## 快速开始
61
+ ## 使用编码 Agent 安装
70
62
 
71
- ```bash
72
- pipx install robert-github-agent
73
- gh auth login
74
- robert init
75
- robert doctor
76
- robert service install
77
- robert service start
78
- ```
63
+ 把下面的提示词复制给 Codex、Claude Code 或其他终端编码 Agent:
64
+
65
+ ```text
66
+ Install and fully configure Robert on this machine by following:
67
+ https://github.com/wklken/Robert/blob/main/docs/agent-install.md
79
68
 
80
- 配置路径为 `~/.config/robert/config.yml`,运行数据默认位于
81
- `~/.local/share/robert/`。
69
+ Read the entire guide before executing. Ask me for required values and for
70
+ confirmation wherever the guide requires it.
71
+ ```
82
72
 
83
73
  ## 配置
84
74
 
@@ -86,21 +76,6 @@ Robert 使用带版本号的 YAML。配置包括 GitHub 账号、Worker、Skill
86
76
  路由覆盖和一个或多个本地仓库。详见
87
77
  [docs/reference.md](docs/reference.md#configuration)。
88
78
 
89
- ## Worker 适配器
90
-
91
- 内置 `codex`、`tcodex`、`cbc` 和通用 `command` 适配器。Worker 定义包含命令、
92
- 默认模型、推理强度、超时、输入方式和环境变量白名单。
93
-
94
- ## 路由技能配置
95
-
96
- 路由可以配置必需 Skill 和推荐 Skill。缺少必需 Skill 时,任务会在创建
97
- worktree 和启动 Worker 之前被阻止;缺少推荐 Skill 只会产生诊断提示。
98
-
99
- ## 多仓库
100
-
101
- 每个仓库拥有独立 checkout、worktree 根目录、可信 Actor、并发限制和路由覆盖。
102
- 单个仓库失败不会阻塞同一轮中的其他仓库。
103
-
104
79
  ## 守护进程
105
80
 
106
81
  ```bash
@@ -114,6 +89,8 @@ robert service status
114
89
 
115
90
  ## 本地 Web UI
116
91
 
92
+ ![Robert Web UI 任务看板](docs/imgs/webui-task-board.png)
93
+
117
94
  ```bash
118
95
  robert web run
119
96
  ```
@@ -128,6 +105,8 @@ robert web run --writable --operator "$USER"
128
105
 
129
106
  ## OpenClaw 集成
130
107
 
108
+ ![OpenClaw 中的 Robert 状态](docs/imgs/openclaw-robert-status.png)
109
+
131
110
  ```bash
132
111
  robert openclaw install
133
112
  robert openclaw status
@@ -136,15 +115,6 @@ robert openclaw status
136
115
  插件只提供 Robert 状态、任务、运行和产物查询,不会启动 Robert,也不会创建
137
116
  定时任务。
138
117
 
139
- ## 迁移
140
-
141
- ```bash
142
- robert migrate dd-github-agent --dry-run
143
- robert migrate dd-github-agent
144
- ```
145
-
146
- 迁移会保留独立备份,并继续识别旧的去重标记。
147
-
148
118
  ## 故障排查
149
119
 
150
120
  先运行 `robert doctor --output json` 和 `robert service status`。需要提供诊断
@@ -161,10 +131,12 @@ robert diagnostics export --output robert-diagnostics.zip
161
131
  阅读 [COMMUNITY.md](COMMUNITY.md),执行其中的验证命令,并使用
162
132
  `git commit -s` 签署提交。首个 Beta 使用 DCO,不要求 CLA。
163
133
 
164
- ## 项目状态
134
+ ## 安全与信任模型
165
135
 
166
- Robert `0.1.0b1` 是公开 Beta。当前只使用轮询获取 GitHub 事件,稳定版之前接口
167
- 仍可能调整。
136
+ GitHub 文本始终按不可信输入处理。只有配置中的可信 Actor 能触发工作。仓库
137
+ 覆盖不能改变路由的 GitHub 权限和 workspace 策略。Worker 环境变量采用白名单,
138
+ 配置文件不保存 GitHub Token,所有对外文本都经过脱敏和审计。Web UI 默认绑定
139
+ `127.0.0.1`。
168
140
 
169
141
  ## 许可证
170
142
 
@@ -1,6 +1,6 @@
1
1
  # Robert
2
2
 
3
- [English](README.md) | [简体中文](README_ZH.md)
3
+ [English](README_EN.md) | [简体中文](README.md)
4
4
 
5
5
  **Your Repo Teammate**
6
6
 
@@ -85,6 +85,18 @@ robert service start
85
85
  The configuration is written to `~/.config/robert/config.yml`. Runtime data is
86
86
  stored under `~/.local/share/robert/`.
87
87
 
88
+ ## Install with a Coding Agent
89
+
90
+ Copy this prompt into Codex, Claude Code, or another terminal coding agent:
91
+
92
+ ```text
93
+ Install and fully configure Robert on this machine by following:
94
+ https://github.com/wklken/Robert/blob/main/docs/agent-install.md
95
+
96
+ Read the entire guide before executing. Ask me for required values and for
97
+ confirmation wherever the guide requires it.
98
+ ```
99
+
88
100
  ## Configuration
89
101
 
90
102
  Robert uses versioned YAML. Configure the GitHub account, worker definitions,
@@ -122,6 +134,8 @@ Robert runs in the foreground under systemd user services or launchd. Use
122
134
 
123
135
  ## Local Web UI
124
136
 
137
+ ![Robert Web UI task board](docs/imgs/webui-task-board.png)
138
+
125
139
  ```bash
126
140
  robert web run
127
141
  ```
@@ -137,6 +151,8 @@ proxy.
137
151
 
138
152
  ## OpenClaw
139
153
 
154
+ ![Robert status in OpenClaw](docs/imgs/openclaw-robert-status.png)
155
+
140
156
  ```bash
141
157
  robert openclaw install
142
158
  robert openclaw status
@@ -175,7 +191,7 @@ of Origin and does not require a CLA for the first beta.
175
191
 
176
192
  ## Project Status
177
193
 
178
- Robert `0.1.0b1` is a public beta. Polling is the only GitHub event transport in
194
+ Robert `0.1.0b2` is a public beta. Polling is the only GitHub event transport in
179
195
  this release. Interfaces may evolve before the first stable release.
180
196
 
181
197
  ## License
@@ -0,0 +1,183 @@
1
+ # Install Robert with a Coding Agent
2
+
3
+ This guide is written for terminal coding agents such as Codex or Claude Code.
4
+ Read the entire guide before executing commands.
5
+
6
+ ## Goal
7
+
8
+ - Install `robert-github-agent`.
9
+ - Configure Robert for one existing local GitHub repository.
10
+ - Validate GitHub CLI authentication and the configured worker.
11
+ - Install the native user service.
12
+ - Start unattended operation only after explicit user confirmation.
13
+
14
+ ## Safety Rules
15
+
16
+ - Do not print, copy, request, or store GitHub tokens, API keys, cookies, or
17
+ credentials.
18
+ - Robert must use the existing authenticated `gh` CLI session.
19
+ - If `gh auth status` fails, stop and ask the user to run `gh auth login`.
20
+ - Do not modify Robert's source or the target repository's source.
21
+ - Do not create GitHub issues, comments, pull requests, tags, releases, or
22
+ other remote writes during setup.
23
+ - Do not overwrite `~/.config/robert/config.yml` without explicit approval.
24
+ - Do not use `--force` unless the user approves it after reviewing the existing
25
+ configuration.
26
+ - Explain any system-package installation before running it.
27
+ - Show commands before execution and stop on failed verification.
28
+
29
+ ## Required Values
30
+
31
+ Determine safely or ask the user for:
32
+
33
+ 1. GitHub repository in `owner/name` form.
34
+ 2. Absolute path to its existing local Git checkout.
35
+ 3. GitHub account Robert runs as and listens for.
36
+ 4. Trusted human GitHub actor allowed to trigger Robert.
37
+ 5. Worker command or adapter, such as `codex`.
38
+
39
+ Do not assume that the Robert account and trusted human actor are the same
40
+ account.
41
+
42
+ ## Setup Procedure
43
+
44
+ ### 1. Inspect the Environment
45
+
46
+ Detect Linux, macOS, or WSL. Check:
47
+
48
+ ```bash
49
+ python3 --version
50
+ git --version
51
+ gh --version
52
+ pipx --version
53
+ ```
54
+
55
+ Python must be 3.10 or newer. Also verify the selected worker command:
56
+
57
+ ```bash
58
+ command -v codex
59
+ ```
60
+
61
+ Replace `codex` if another worker was selected.
62
+
63
+ ### 2. Verify GitHub Authentication
64
+
65
+ ```bash
66
+ gh auth status
67
+ ```
68
+
69
+ Do not display credential files or environment variables. If authentication
70
+ fails, stop and ask the user to run:
71
+
72
+ ```bash
73
+ gh auth login
74
+ ```
75
+
76
+ ### 3. Install pipx When Needed
77
+
78
+ If `pipx` is missing, explain the platform-supported installation command and
79
+ ask before installing a system package. Ensure the pipx binary directory is on
80
+ `PATH`.
81
+
82
+ ### 4. Install Robert
83
+
84
+ ```bash
85
+ pipx install robert-github-agent
86
+ ```
87
+
88
+ If already installed, report the current version and ask before upgrading.
89
+
90
+ ```bash
91
+ robert --version
92
+ robert --help
93
+ ```
94
+
95
+ ### 5. Inspect Existing Configuration
96
+
97
+ ```bash
98
+ test -f ~/.config/robert/config.yml
99
+ ```
100
+
101
+ If the file exists, do not overwrite it. Run validation and report its current
102
+ state:
103
+
104
+ ```bash
105
+ robert config validate \
106
+ --config ~/.config/robert/config.yml \
107
+ --output json
108
+ ```
109
+
110
+ Ask before replacing or changing the file.
111
+
112
+ ### 6. Create Configuration
113
+
114
+ When no configuration exists, run one correctly quoted command:
115
+
116
+ ```bash
117
+ robert init --non-interactive \
118
+ --config ~/.config/robert/config.yml \
119
+ --repo OWNER/REPO \
120
+ --repo-path /absolute/repository/path \
121
+ --worker WORKER \
122
+ --github-account ROBERT_ACCOUNT \
123
+ --trusted-actor TRUSTED_ACTOR
124
+ ```
125
+
126
+ Use the values confirmed by the user.
127
+
128
+ ### 7. Validate Readiness
129
+
130
+ ```bash
131
+ robert config validate \
132
+ --config ~/.config/robert/config.yml \
133
+ --output json
134
+
135
+ robert doctor \
136
+ --config ~/.config/robert/config.yml \
137
+ --output json
138
+ ```
139
+
140
+ Do not claim success if a required check failed or was skipped.
141
+
142
+ ### 8. Preview and Install the Native Service
143
+
144
+ Preview:
145
+
146
+ ```bash
147
+ robert service install \
148
+ --config ~/.config/robert/config.yml \
149
+ --dry-run \
150
+ --output json
151
+ ```
152
+
153
+ If validation passed, install:
154
+
155
+ ```bash
156
+ robert service install --config ~/.config/robert/config.yml
157
+ ```
158
+
159
+ ### 9. Confirm Before Starting
160
+
161
+ Explain which repository and GitHub events Robert will monitor. Ask the user
162
+ for explicit confirmation before starting unattended operation.
163
+
164
+ Only after confirmation:
165
+
166
+ ```bash
167
+ robert service start
168
+ robert service status --output json
169
+ ```
170
+
171
+ ## Final Report
172
+
173
+ Report:
174
+
175
+ - Robert version.
176
+ - Configuration path: `~/.config/robert/config.yml`.
177
+ - Runtime data path: `~/.local/share/robert/`.
178
+ - Repository and worker selected.
179
+ - Doctor and service status.
180
+ - Every skipped, blocked, or failed check.
181
+
182
+ Success means Robert is installed, configuration is valid, doctor checks pass,
183
+ the native service is installed, and no GitHub write occurred during setup.
@@ -98,8 +98,7 @@ routes:
98
98
  new-pr:
99
99
  worker: default
100
100
  required_skills: []
101
- recommended_skills:
102
- - fast-add-tests
101
+ recommended_skills: []
103
102
  ```
104
103
 
105
104
  Repository overrides replace only the fields they explicitly provide.