robert-github-agent 0.1.0b1__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 (172) hide show
  1. robert_github_agent-0.1.0b1/.github/CODEOWNERS +1 -0
  2. robert_github_agent-0.1.0b1/.github/ISSUE_TEMPLATE/bug.yml +52 -0
  3. robert_github_agent-0.1.0b1/.github/ISSUE_TEMPLATE/config.yml +8 -0
  4. robert_github_agent-0.1.0b1/.github/ISSUE_TEMPLATE/documentation.yml +54 -0
  5. robert_github_agent-0.1.0b1/.github/ISSUE_TEMPLATE/feature.yml +48 -0
  6. robert_github_agent-0.1.0b1/.github/PULL_REQUEST_TEMPLATE.md +22 -0
  7. robert_github_agent-0.1.0b1/.github/dependabot.yml +10 -0
  8. robert_github_agent-0.1.0b1/.github/workflows/ci.yml +76 -0
  9. robert_github_agent-0.1.0b1/.github/workflows/dco.yml +53 -0
  10. robert_github_agent-0.1.0b1/.github/workflows/release.yml +34 -0
  11. robert_github_agent-0.1.0b1/.gitignore +16 -0
  12. robert_github_agent-0.1.0b1/AGENTS.md +24 -0
  13. robert_github_agent-0.1.0b1/CHANGELOG.md +9 -0
  14. robert_github_agent-0.1.0b1/COMMUNITY.md +141 -0
  15. robert_github_agent-0.1.0b1/LICENSE +201 -0
  16. robert_github_agent-0.1.0b1/PKG-INFO +217 -0
  17. robert_github_agent-0.1.0b1/README.md +183 -0
  18. robert_github_agent-0.1.0b1/README_ZH.md +171 -0
  19. robert_github_agent-0.1.0b1/docs/concepts.md +128 -0
  20. robert_github_agent-0.1.0b1/docs/development.md +430 -0
  21. robert_github_agent-0.1.0b1/docs/guides.md +200 -0
  22. robert_github_agent-0.1.0b1/docs/reference.md +145 -0
  23. robert_github_agent-0.1.0b1/pyproject.toml +49 -0
  24. robert_github_agent-0.1.0b1/src/robert_agent/__init__.py +1 -0
  25. robert_github_agent-0.1.0b1/src/robert_agent/acceptance.py +394 -0
  26. robert_github_agent-0.1.0b1/src/robert_agent/acceptance_suite.py +287 -0
  27. robert_github_agent-0.1.0b1/src/robert_agent/audit_result.py +501 -0
  28. robert_github_agent-0.1.0b1/src/robert_agent/authorize.py +117 -0
  29. robert_github_agent-0.1.0b1/src/robert_agent/board.py +538 -0
  30. robert_github_agent-0.1.0b1/src/robert_agent/chat_status.py +338 -0
  31. robert_github_agent-0.1.0b1/src/robert_agent/cli/__init__.py +1 -0
  32. robert_github_agent-0.1.0b1/src/robert_agent/cli/exit_codes.py +5 -0
  33. robert_github_agent-0.1.0b1/src/robert_agent/cli/main.py +535 -0
  34. robert_github_agent-0.1.0b1/src/robert_agent/cli/output.py +20 -0
  35. robert_github_agent-0.1.0b1/src/robert_agent/common.py +6 -0
  36. robert_github_agent-0.1.0b1/src/robert_agent/controlled_e2e_acceptance.py +394 -0
  37. robert_github_agent-0.1.0b1/src/robert_agent/daemon.py +607 -0
  38. robert_github_agent-0.1.0b1/src/robert_agent/daemon_state.py +319 -0
  39. robert_github_agent-0.1.0b1/src/robert_agent/diagnostics.py +119 -0
  40. robert_github_agent-0.1.0b1/src/robert_agent/discover.py +775 -0
  41. robert_github_agent-0.1.0b1/src/robert_agent/dispatch.py +217 -0
  42. robert_github_agent-0.1.0b1/src/robert_agent/doctor.py +94 -0
  43. robert_github_agent-0.1.0b1/src/robert_agent/github_api.py +12 -0
  44. robert_github_agent-0.1.0b1/src/robert_agent/init_config.py +126 -0
  45. robert_github_agent-0.1.0b1/src/robert_agent/integrations/__init__.py +1 -0
  46. robert_github_agent-0.1.0b1/src/robert_agent/integrations/openclaw.py +285 -0
  47. robert_github_agent-0.1.0b1/src/robert_agent/live_discovery_acceptance.py +70 -0
  48. robert_github_agent-0.1.0b1/src/robert_agent/live_worker_acceptance.py +363 -0
  49. robert_github_agent-0.1.0b1/src/robert_agent/live_worktree_acceptance.py +344 -0
  50. robert_github_agent-0.1.0b1/src/robert_agent/loop_engine.py +285 -0
  51. robert_github_agent-0.1.0b1/src/robert_agent/memory_curator.py +105 -0
  52. robert_github_agent-0.1.0b1/src/robert_agent/migrate.py +157 -0
  53. robert_github_agent-0.1.0b1/src/robert_agent/notify.py +74 -0
  54. robert_github_agent-0.1.0b1/src/robert_agent/paths.py +16 -0
  55. robert_github_agent-0.1.0b1/src/robert_agent/production_write_canary.py +254 -0
  56. robert_github_agent-0.1.0b1/src/robert_agent/project_memory.py +503 -0
  57. robert_github_agent-0.1.0b1/src/robert_agent/publish.py +743 -0
  58. robert_github_agent-0.1.0b1/src/robert_agent/publish_dedupe_acceptance.py +270 -0
  59. robert_github_agent-0.1.0b1/src/robert_agent/redaction.py +41 -0
  60. robert_github_agent-0.1.0b1/src/robert_agent/render_prompt.py +544 -0
  61. robert_github_agent-0.1.0b1/src/robert_agent/resource_files.py +8 -0
  62. robert_github_agent-0.1.0b1/src/robert_agent/resources/__init__.py +1 -0
  63. robert_github_agent-0.1.0b1/src/robert_agent/resources/acceptance-matrix.md +120 -0
  64. robert_github_agent-0.1.0b1/src/robert_agent/resources/classifier.md +19 -0
  65. robert_github_agent-0.1.0b1/src/robert_agent/resources/command-matrix.md +38 -0
  66. robert_github_agent-0.1.0b1/src/robert_agent/resources/config.example.yml +20 -0
  67. robert_github_agent-0.1.0b1/src/robert_agent/resources/db/migrations/001_legacy_dd_to_robert.sql +14 -0
  68. robert_github_agent-0.1.0b1/src/robert_agent/resources/db/schema.sql +479 -0
  69. robert_github_agent-0.1.0b1/src/robert_agent/resources/failure-modes.md +36 -0
  70. robert_github_agent-0.1.0b1/src/robert_agent/resources/fixtures/actor-permission.json +1 -0
  71. robert_github_agent-0.1.0b1/src/robert_agent/resources/fixtures/discovery.json +1 -0
  72. robert_github_agent-0.1.0b1/src/robert_agent/resources/fixtures/redaction.json +1 -0
  73. robert_github_agent-0.1.0b1/src/robert_agent/resources/fixtures/review-followup.json +1 -0
  74. robert_github_agent-0.1.0b1/src/robert_agent/resources/fixtures/worker-results.json +1 -0
  75. robert_github_agent-0.1.0b1/src/robert_agent/resources/fixtures/workstreams.json +1 -0
  76. robert_github_agent-0.1.0b1/src/robert_agent/resources/github-events.md +77 -0
  77. robert_github_agent-0.1.0b1/src/robert_agent/resources/kanban-control.md +165 -0
  78. robert_github_agent-0.1.0b1/src/robert_agent/resources/redaction.md +29 -0
  79. robert_github_agent-0.1.0b1/src/robert_agent/resources/result-contract.md +56 -0
  80. robert_github_agent-0.1.0b1/src/robert_agent/resources/routes.yml +82 -0
  81. robert_github_agent-0.1.0b1/src/robert_agent/resources/schemas/config.schema.json +123 -0
  82. robert_github_agent-0.1.0b1/src/robert_agent/resources/schemas/event.schema.json +18 -0
  83. robert_github_agent-0.1.0b1/src/robert_agent/resources/schemas/result.schema.json +99 -0
  84. robert_github_agent-0.1.0b1/src/robert_agent/resources/schemas/route.schema.json +23 -0
  85. robert_github_agent-0.1.0b1/src/robert_agent/resources/schemas/snapshot.schema.json +17 -0
  86. robert_github_agent-0.1.0b1/src/robert_agent/resources/schemas/task.schema.json +15 -0
  87. robert_github_agent-0.1.0b1/src/robert_agent/resources/trust-model.md +16 -0
  88. robert_github_agent-0.1.0b1/src/robert_agent/resources/worker-prompt.md +121 -0
  89. robert_github_agent-0.1.0b1/src/robert_agent/resources/worker-protocol.md +47 -0
  90. robert_github_agent-0.1.0b1/src/robert_agent/resources/workflow.yml +50 -0
  91. robert_github_agent-0.1.0b1/src/robert_agent/resources/workstream-model.md +17 -0
  92. robert_github_agent-0.1.0b1/src/robert_agent/route.py +232 -0
  93. robert_github_agent-0.1.0b1/src/robert_agent/route_config.py +64 -0
  94. robert_github_agent-0.1.0b1/src/robert_agent/run_once.py +5375 -0
  95. robert_github_agent-0.1.0b1/src/robert_agent/runtime_knowledge.py +392 -0
  96. robert_github_agent-0.1.0b1/src/robert_agent/service.py +161 -0
  97. robert_github_agent-0.1.0b1/src/robert_agent/skills.py +28 -0
  98. robert_github_agent-0.1.0b1/src/robert_agent/status.py +1051 -0
  99. robert_github_agent-0.1.0b1/src/robert_agent/storage.py +376 -0
  100. robert_github_agent-0.1.0b1/src/robert_agent/summarize.py +100 -0
  101. robert_github_agent-0.1.0b1/src/robert_agent/supervise.py +72 -0
  102. robert_github_agent-0.1.0b1/src/robert_agent/usage.py +192 -0
  103. robert_github_agent-0.1.0b1/src/robert_agent/validate_config.py +616 -0
  104. robert_github_agent-0.1.0b1/src/robert_agent/wakeup.py +261 -0
  105. robert_github_agent-0.1.0b1/src/robert_agent/web.py +2893 -0
  106. robert_github_agent-0.1.0b1/src/robert_agent/web_assets/board.css +255 -0
  107. robert_github_agent-0.1.0b1/src/robert_agent/web_assets/board.html +165 -0
  108. robert_github_agent-0.1.0b1/src/robert_agent/web_assets/board.js +660 -0
  109. robert_github_agent-0.1.0b1/src/robert_agent/web_assets/github-shell.css +122 -0
  110. robert_github_agent-0.1.0b1/src/robert_agent/web_assets/index.html +103 -0
  111. robert_github_agent-0.1.0b1/src/robert_agent/web_assets/operations.css +168 -0
  112. robert_github_agent-0.1.0b1/src/robert_agent/web_assets/workbench.css +131 -0
  113. robert_github_agent-0.1.0b1/src/robert_agent/web_assets/workbench.js +581 -0
  114. robert_github_agent-0.1.0b1/src/robert_agent/work_items.py +1016 -0
  115. robert_github_agent-0.1.0b1/src/robert_agent/workbench.py +701 -0
  116. robert_github_agent-0.1.0b1/src/robert_agent/worker/__init__.py +1 -0
  117. robert_github_agent-0.1.0b1/src/robert_agent/worker/heartbeat.py +190 -0
  118. robert_github_agent-0.1.0b1/src/robert_agent/worker/result.py +321 -0
  119. robert_github_agent-0.1.0b1/src/robert_agent/worker/snapshot.py +98 -0
  120. robert_github_agent-0.1.0b1/src/robert_agent/worker_adapters/__init__.py +138 -0
  121. robert_github_agent-0.1.0b1/src/robert_agent/worker_adapters/cbc.py +68 -0
  122. robert_github_agent-0.1.0b1/src/robert_agent/worker_adapters/codex.py +56 -0
  123. robert_github_agent-0.1.0b1/src/robert_agent/worker_adapters/command.py +33 -0
  124. robert_github_agent-0.1.0b1/src/robert_agent/worker_adapters/tcodex.py +56 -0
  125. robert_github_agent-0.1.0b1/src/robert_agent/worker_heartbeat.py +6 -0
  126. robert_github_agent-0.1.0b1/src/robert_agent/worker_result.py +6 -0
  127. robert_github_agent-0.1.0b1/src/robert_agent/worker_snapshot.py +6 -0
  128. robert_github_agent-0.1.0b1/src/robert_agent/workstream.py +55 -0
  129. robert_github_agent-0.1.0b1/src/robert_agent/worktree.py +297 -0
  130. robert_github_agent-0.1.0b1/tests/__init__.py +1 -0
  131. robert_github_agent-0.1.0b1/tests/support.py +22 -0
  132. robert_github_agent-0.1.0b1/tests/test_acceptance_suite.py +170 -0
  133. robert_github_agent-0.1.0b1/tests/test_board.py +258 -0
  134. robert_github_agent-0.1.0b1/tests/test_board_control_integration.py +363 -0
  135. robert_github_agent-0.1.0b1/tests/test_cli.py +125 -0
  136. robert_github_agent-0.1.0b1/tests/test_config_and_schema.py +1022 -0
  137. robert_github_agent-0.1.0b1/tests/test_controlled_e2e_acceptance.py +72 -0
  138. robert_github_agent-0.1.0b1/tests/test_daemon.py +1054 -0
  139. robert_github_agent-0.1.0b1/tests/test_diagnostics.py +26 -0
  140. robert_github_agent-0.1.0b1/tests/test_discovery_authorization.py +1334 -0
  141. robert_github_agent-0.1.0b1/tests/test_distribution.py +36 -0
  142. robert_github_agent-0.1.0b1/tests/test_docs.py +43 -0
  143. robert_github_agent-0.1.0b1/tests/test_github_event_matrix.py +393 -0
  144. robert_github_agent-0.1.0b1/tests/test_init_and_doctor.py +64 -0
  145. robert_github_agent-0.1.0b1/tests/test_live_discovery_acceptance.py +94 -0
  146. robert_github_agent-0.1.0b1/tests/test_live_worker_acceptance.py +174 -0
  147. robert_github_agent-0.1.0b1/tests/test_live_worktree_acceptance.py +69 -0
  148. robert_github_agent-0.1.0b1/tests/test_loop_engine.py +316 -0
  149. robert_github_agent-0.1.0b1/tests/test_migration.py +98 -0
  150. robert_github_agent-0.1.0b1/tests/test_openclaw.py +19 -0
  151. robert_github_agent-0.1.0b1/tests/test_operational_commands.py +5506 -0
  152. robert_github_agent-0.1.0b1/tests/test_package_layout.py +27 -0
  153. robert_github_agent-0.1.0b1/tests/test_paths.py +32 -0
  154. robert_github_agent-0.1.0b1/tests/test_production_write_canary.py +142 -0
  155. robert_github_agent-0.1.0b1/tests/test_project_memory.py +286 -0
  156. robert_github_agent-0.1.0b1/tests/test_public_surface.py +66 -0
  157. robert_github_agent-0.1.0b1/tests/test_publish_dedupe_acceptance.py +37 -0
  158. robert_github_agent-0.1.0b1/tests/test_redaction.py +89 -0
  159. robert_github_agent-0.1.0b1/tests/test_route_config.py +126 -0
  160. robert_github_agent-0.1.0b1/tests/test_routing.py +330 -0
  161. robert_github_agent-0.1.0b1/tests/test_run_once.py +7099 -0
  162. robert_github_agent-0.1.0b1/tests/test_runtime_knowledge.py +211 -0
  163. robert_github_agent-0.1.0b1/tests/test_service.py +29 -0
  164. robert_github_agent-0.1.0b1/tests/test_skills.py +26 -0
  165. robert_github_agent-0.1.0b1/tests/test_web_security.py +91 -0
  166. robert_github_agent-0.1.0b1/tests/test_work_items.py +704 -0
  167. robert_github_agent-0.1.0b1/tests/test_workbench.py +333 -0
  168. robert_github_agent-0.1.0b1/tests/test_worker_adapter_config.py +48 -0
  169. robert_github_agent-0.1.0b1/tests/test_worker_protocol.py +1885 -0
  170. robert_github_agent-0.1.0b1/tests/test_workflow_matrix.py +846 -0
  171. robert_github_agent-0.1.0b1/tests/test_workspace_resolution.py +155 -0
  172. robert_github_agent-0.1.0b1/tests/test_workstreams.py +82 -0
@@ -0,0 +1 @@
1
+ * @wklken
@@ -0,0 +1,52 @@
1
+ name: Bug report
2
+ description: Report a reproducible Robert defect
3
+ title: "[Bug] "
4
+ labels: ["bug"]
5
+ body:
6
+ - type: input
7
+ id: version
8
+ attributes:
9
+ label: Robert version
10
+ placeholder: "0.1.0b1"
11
+ validations:
12
+ required: true
13
+ - type: input
14
+ id: environment
15
+ attributes:
16
+ label: Host OS and Python version
17
+ placeholder: "Ubuntu 24.04, Python 3.12"
18
+ validations:
19
+ required: true
20
+ - type: textarea
21
+ id: doctor
22
+ attributes:
23
+ label: Redacted doctor output
24
+ description: Paste redacted `robert doctor --output json` output.
25
+ render: json
26
+ validations:
27
+ required: true
28
+ - type: textarea
29
+ id: reproduction
30
+ attributes:
31
+ label: Reproduction steps
32
+ validations:
33
+ required: true
34
+ - type: textarea
35
+ id: expected
36
+ attributes:
37
+ label: Expected result
38
+ validations:
39
+ required: true
40
+ - type: textarea
41
+ id: actual
42
+ attributes:
43
+ label: Actual result
44
+ validations:
45
+ required: true
46
+ - type: checkboxes
47
+ id: redaction
48
+ attributes:
49
+ label: Redaction confirmation
50
+ options:
51
+ - label: I removed secrets, credentials, private repository content, and sensitive local paths.
52
+ required: true
@@ -0,0 +1,8 @@
1
+ blank_issues_enabled: false
2
+ contact_links:
3
+ - name: Security vulnerability
4
+ url: https://github.com/wklken/robert/security/advisories/new
5
+ about: Report security issues privately.
6
+ - name: Usage discussion
7
+ url: https://github.com/wklken/robert/discussions
8
+ about: Ask setup and usage questions when Discussions is enabled.
@@ -0,0 +1,54 @@
1
+ name: Documentation issue
2
+ description: Report unclear, missing, or incorrect documentation
3
+ title: "[Docs] "
4
+ labels: ["documentation"]
5
+ body:
6
+ - type: input
7
+ id: version
8
+ attributes:
9
+ label: Robert version
10
+ validations:
11
+ required: true
12
+ - type: input
13
+ id: environment
14
+ attributes:
15
+ label: Host OS and Python version
16
+ validations:
17
+ required: true
18
+ - type: textarea
19
+ id: doctor
20
+ attributes:
21
+ label: Redacted doctor output
22
+ description: Include `robert doctor --output json` when the issue is environment-specific.
23
+ render: json
24
+ - type: textarea
25
+ id: location
26
+ attributes:
27
+ label: Document and section
28
+ validations:
29
+ required: true
30
+ - type: textarea
31
+ id: reproduction
32
+ attributes:
33
+ label: Commands or steps that expose the problem
34
+ validations:
35
+ required: true
36
+ - type: textarea
37
+ id: expected
38
+ attributes:
39
+ label: Expected documentation
40
+ validations:
41
+ required: true
42
+ - type: textarea
43
+ id: actual
44
+ attributes:
45
+ label: Current documentation
46
+ validations:
47
+ required: true
48
+ - type: checkboxes
49
+ id: redaction
50
+ attributes:
51
+ label: Redaction confirmation
52
+ options:
53
+ - label: I removed secrets, credentials, private repository content, and sensitive local paths.
54
+ required: true
@@ -0,0 +1,48 @@
1
+ name: Feature request
2
+ description: Propose a focused Robert capability
3
+ title: "[Feature] "
4
+ labels: ["enhancement"]
5
+ body:
6
+ - type: input
7
+ id: version
8
+ attributes:
9
+ label: Robert version
10
+ validations:
11
+ required: true
12
+ - type: input
13
+ id: environment
14
+ attributes:
15
+ label: Host OS and Python version
16
+ validations:
17
+ required: true
18
+ - type: textarea
19
+ id: doctor
20
+ attributes:
21
+ label: Redacted doctor output
22
+ description: Include `robert doctor --output json` when relevant.
23
+ render: json
24
+ - type: textarea
25
+ id: problem
26
+ attributes:
27
+ label: Problem and reproduction or workflow
28
+ validations:
29
+ required: true
30
+ - type: textarea
31
+ id: expected
32
+ attributes:
33
+ label: Expected result
34
+ validations:
35
+ required: true
36
+ - type: textarea
37
+ id: current
38
+ attributes:
39
+ label: Current result
40
+ validations:
41
+ required: true
42
+ - type: checkboxes
43
+ id: redaction
44
+ attributes:
45
+ label: Redaction confirmation
46
+ options:
47
+ - label: I removed secrets, credentials, private repository content, and sensitive local paths.
48
+ required: true
@@ -0,0 +1,22 @@
1
+ ## Summary
2
+
3
+ Describe the problem and the smallest change that solves it.
4
+ Read [COMMUNITY.md](../COMMUNITY.md) before contributing.
5
+
6
+ ## Verification
7
+
8
+ - [ ] Focused tests added or updated
9
+ - [ ] `python3 -B -m unittest discover -s tests`
10
+ - [ ] `python3 -m build` when code, packaging, or resources changed
11
+ - [ ] `git diff --check`
12
+ - [ ] Documentation updated when behavior or commands changed
13
+
14
+ ## Trust and external effects
15
+
16
+ - [ ] No trust, authorization, audit, redaction, or idempotency boundary was weakened
17
+ - [ ] New dependencies are listed and justified
18
+ - [ ] New network calls, subprocesses, filesystem writes, credentials, or GitHub actions are disclosed
19
+
20
+ ## DCO
21
+
22
+ - [ ] Every commit includes a `Signed-off-by` line created with `git commit -s`
@@ -0,0 +1,10 @@
1
+ version: 2
2
+ updates:
3
+ - package-ecosystem: pip
4
+ directory: /
5
+ schedule:
6
+ interval: weekly
7
+ - package-ecosystem: github-actions
8
+ directory: /
9
+ schedule:
10
+ interval: weekly
@@ -0,0 +1,76 @@
1
+ name: CI
2
+
3
+ on:
4
+ pull_request:
5
+ push:
6
+ branches: [main]
7
+
8
+ permissions:
9
+ contents: read
10
+
11
+ jobs:
12
+ test:
13
+ strategy:
14
+ fail-fast: false
15
+ matrix:
16
+ os: [ubuntu-latest, macos-latest]
17
+ python: ["3.10", "3.11", "3.12", "3.13", "3.14"]
18
+ runs-on: ${{ matrix.os }}
19
+ steps:
20
+ - uses: actions/checkout@v4
21
+ - uses: actions/setup-python@v5
22
+ with:
23
+ python-version: ${{ matrix.python }}
24
+ cache: pip
25
+ - run: python -m pip install --upgrade pip setuptools
26
+ - run: python -m pip install -e '.[dev]'
27
+ - run: python -m ruff check src tests
28
+ - run: >-
29
+ python -m mypy
30
+ src/robert_agent/cli
31
+ src/robert_agent/paths.py
32
+ src/robert_agent/route_config.py
33
+ src/robert_agent/skills.py
34
+ src/robert_agent/service.py
35
+ src/robert_agent/migrate.py
36
+ - run: python -B -m unittest discover -s tests
37
+ - run: python -m compileall -q src
38
+ - run: python -m build
39
+ - run: python -m pip_audit
40
+ - run: git diff --check
41
+
42
+ wheel-smoke:
43
+ runs-on: ubuntu-latest
44
+ steps:
45
+ - uses: actions/checkout@v4
46
+ - uses: actions/setup-python@v5
47
+ with:
48
+ python-version: "3.12"
49
+ - run: python -m pip install build
50
+ - run: python -m build
51
+ - run: python -m venv /tmp/robert-smoke
52
+ - run: /tmp/robert-smoke/bin/pip install dist/*.whl
53
+ - run: /tmp/robert-smoke/bin/robert --version
54
+ - run: /tmp/robert-smoke/bin/robert --help
55
+
56
+ secret-scan:
57
+ runs-on: ubuntu-latest
58
+ steps:
59
+ - uses: actions/checkout@v4
60
+ with:
61
+ fetch-depth: 0
62
+ - uses: gitleaks/gitleaks-action@v2
63
+
64
+ docs-links:
65
+ runs-on: ubuntu-latest
66
+ steps:
67
+ - uses: actions/checkout@v4
68
+ - uses: lycheeverse/lychee-action@v2
69
+ with:
70
+ failIfEmpty: false
71
+ args: >-
72
+ --no-progress
73
+ README.md
74
+ README_ZH.md
75
+ COMMUNITY.md
76
+ docs
@@ -0,0 +1,53 @@
1
+ name: DCO
2
+
3
+ on:
4
+ pull_request:
5
+
6
+ permissions:
7
+ contents: read
8
+
9
+ jobs:
10
+ dco:
11
+ runs-on: ubuntu-latest
12
+ steps:
13
+ - uses: actions/checkout@v4
14
+ with:
15
+ fetch-depth: 0
16
+ - name: Verify Signed-off-by trailers
17
+ env:
18
+ BASE_SHA: ${{ github.event.pull_request.base.sha }}
19
+ HEAD_SHA: ${{ github.event.pull_request.head.sha }}
20
+ run: |
21
+ python - <<'PY'
22
+ import os
23
+ import subprocess
24
+ import sys
25
+
26
+ base = os.environ["BASE_SHA"]
27
+ head = os.environ["HEAD_SHA"]
28
+ commits = subprocess.check_output(
29
+ ["git", "rev-list", f"{base}..{head}"],
30
+ text=True,
31
+ ).splitlines()
32
+ failures = []
33
+ for commit in commits:
34
+ name = subprocess.check_output(
35
+ ["git", "show", "-s", "--format=%an", commit],
36
+ text=True,
37
+ ).strip()
38
+ email = subprocess.check_output(
39
+ ["git", "show", "-s", "--format=%ae", commit],
40
+ text=True,
41
+ ).strip()
42
+ body = subprocess.check_output(
43
+ ["git", "show", "-s", "--format=%B", commit],
44
+ text=True,
45
+ )
46
+ expected = f"Signed-off-by: {name} <{email}>"
47
+ if expected.lower() not in body.lower():
48
+ failures.append(f"{commit[:12]} missing {expected}")
49
+ if failures:
50
+ print("\n".join(failures))
51
+ sys.exit(1)
52
+ print(f"DCO sign-off verified for {len(commits)} commit(s)")
53
+ PY
@@ -0,0 +1,34 @@
1
+ name: Release
2
+
3
+ on:
4
+ push:
5
+ tags:
6
+ - "v*"
7
+
8
+ permissions:
9
+ contents: write
10
+ id-token: write
11
+ attestations: write
12
+
13
+ jobs:
14
+ build-and-publish:
15
+ runs-on: ubuntu-latest
16
+ environment: pypi
17
+ steps:
18
+ - uses: actions/checkout@v4
19
+ - uses: actions/setup-python@v5
20
+ with:
21
+ python-version: "3.12"
22
+ - run: python -m pip install --upgrade pip
23
+ - run: python -m pip install -e .
24
+ - run: python -m pip install build
25
+ - run: python -B -m unittest discover -s tests
26
+ - run: python -m build
27
+ - uses: actions/attest-build-provenance@v2
28
+ with:
29
+ subject-path: "dist/*"
30
+ - uses: pypa/gh-action-pypi-publish@release/v1
31
+ - uses: softprops/action-gh-release@v2
32
+ with:
33
+ files: dist/*
34
+ generate_release_notes: true
@@ -0,0 +1,16 @@
1
+ __pycache__/
2
+ *.py[cod]
3
+ *.egg-info/
4
+ .coverage
5
+ .mypy_cache/
6
+ .pytest_cache/
7
+ .ruff_cache/
8
+ .venv/
9
+ build/
10
+ dist/
11
+ htmlcov/
12
+ *.sqlite3
13
+ *.db
14
+ *.log
15
+ *.pid
16
+ .DS_Store
@@ -0,0 +1,24 @@
1
+ # AGENTS.md
2
+
3
+ ## Scope
4
+
5
+ These rules apply to the entire Robert repository.
6
+
7
+ ## Required behavior
8
+
9
+ - Read the target modules and tests before changing them.
10
+ - Keep changes limited to the active task.
11
+ - Add a failing behavior test before bug fixes.
12
+ - Preserve the trust, workstream, audit, redaction, and idempotency boundaries.
13
+ - Do not add runtime dependencies without documenting why the standard library
14
+ and current dependencies are insufficient.
15
+ - Do not store GitHub or OpenClaw credentials in configuration or fixtures.
16
+ - Run `python3 -B -m unittest discover -s tests` for code changes.
17
+ - Run `python3 -m build` for packaging or resource changes.
18
+ - Run `git diff --check` before committing.
19
+ - Documentation-only changes do not require the Python test suite.
20
+
21
+ ## Delivery authority
22
+
23
+ Local changes and commits do not authorize pushing, opening pull requests,
24
+ publishing packages, creating releases, or writing to GitHub.
@@ -0,0 +1,9 @@
1
+ # Changelog
2
+
3
+ ## 0.1.0b1
4
+
5
+ - Initial public beta of Robert.
6
+ - Standalone Python package and `robert` CLI.
7
+ - Multi-repository trusted GitHub workstreams.
8
+ - Configurable worker adapters and route skills.
9
+ - Native user services, local web UI, and optional OpenClaw commands.
@@ -0,0 +1,141 @@
1
+ # Community and Governance
2
+
3
+ ## Contributing
4
+
5
+ Robert accepts issues and pull requests from the community. Keep changes
6
+ focused, preserve the trust and audit boundaries, and add behavior tests for
7
+ new logic.
8
+
9
+ ### Development setup
10
+
11
+ ```bash
12
+ python3 -m venv .venv
13
+ . .venv/bin/activate
14
+ python3 -m pip install -e '.[dev]'
15
+ ```
16
+
17
+ ### Required verification
18
+
19
+ ```bash
20
+ python3 -B -m unittest discover -s tests
21
+ python3 -m build
22
+ git diff --check
23
+ ```
24
+
25
+ Add focused tests before the full suite. Documentation-only changes do not
26
+ require the Python suite unless they change executable examples or packaging.
27
+
28
+ ### Dependencies and external actions
29
+
30
+ Explain every new dependency and why the standard library and current
31
+ dependencies are insufficient. Pull requests must disclose new network calls,
32
+ filesystem writes, subprocesses, credentials, or GitHub actions.
33
+
34
+ ### DCO sign-off
35
+
36
+ Robert uses the Developer Certificate of Origin. Sign every commit:
37
+
38
+ ```bash
39
+ git commit -s
40
+ ```
41
+
42
+ By signing, you certify that you have the right to submit the contribution.
43
+ Robert does not require a contributor license agreement for the first beta.
44
+
45
+ ## Code of Conduct
46
+
47
+ ### Our Pledge
48
+
49
+ We as members, contributors, and leaders pledge to make participation in our
50
+ community a harassment-free experience for everyone, regardless of age, body
51
+ size, visible or invisible disability, ethnicity, sex characteristics, gender
52
+ identity and expression, level of experience, education, socio-economic status,
53
+ nationality, personal appearance, race, caste, color, religion, or sexual
54
+ identity and orientation.
55
+
56
+ We pledge to act and interact in ways that contribute to an open, welcoming,
57
+ diverse, inclusive, and healthy community.
58
+
59
+ ### Our Standards
60
+
61
+ Examples of behavior that contributes to a positive environment include:
62
+
63
+ - Demonstrating empathy and kindness toward other people.
64
+ - Being respectful of differing opinions, viewpoints, and experiences.
65
+ - Giving and gracefully accepting constructive feedback.
66
+ - Accepting responsibility, apologizing, and learning from mistakes.
67
+ - Focusing on what is best for the overall community.
68
+
69
+ Examples of unacceptable behavior include:
70
+
71
+ - Sexualized language or imagery and sexual attention or advances.
72
+ - Trolling, insulting or derogatory comments, and personal or political attacks.
73
+ - Public or private harassment.
74
+ - Publishing another person's private information without permission.
75
+ - Conduct that is inappropriate in a professional setting.
76
+
77
+ ### Enforcement Responsibilities
78
+
79
+ Community leaders are responsible for clarifying and enforcing these standards
80
+ and may remove, edit, or reject contributions that are not aligned with them.
81
+ Reasons for moderation decisions will be communicated when appropriate.
82
+
83
+ ### Scope
84
+
85
+ This Code of Conduct applies in all community spaces and when an individual is
86
+ officially representing the community in public spaces.
87
+
88
+ ### Enforcement
89
+
90
+ Report unacceptable behavior privately through the repository's
91
+ [GitHub security advisory form](https://github.com/wklken/robert/security/advisories/new).
92
+ All reports will be reviewed promptly and fairly. Community leaders must
93
+ respect the privacy and security of reporters.
94
+
95
+ ### Enforcement Guidelines
96
+
97
+ 1. **Correction** — A private written warning and clarification. A public
98
+ apology may be requested.
99
+ 2. **Warning** — A warning with consequences and a temporary restriction on
100
+ interaction.
101
+ 3. **Temporary Ban** — A temporary ban from community interaction.
102
+ 4. **Permanent Ban** — A permanent ban for sustained or severe violations.
103
+
104
+ This Code of Conduct is adapted from the
105
+ [Contributor Covenant 2.1](https://www.contributor-covenant.org/version/2/1/code_of_conduct.html).
106
+
107
+ ## Security
108
+
109
+ ### Reporting a vulnerability
110
+
111
+ Report vulnerabilities through the repository's
112
+ [private GitHub security advisory form](https://github.com/wklken/robert/security/advisories/new).
113
+ Do not open a public issue for a suspected vulnerability.
114
+
115
+ Include the affected Robert version, impact, reproduction conditions, and a
116
+ minimal redacted example. Do not include credentials, tokens, private keys,
117
+ private repository content, local diagnostics archives, or unredacted paths.
118
+
119
+ ### Supported version
120
+
121
+ The current public beta receives security fixes. Older prerelease builds may
122
+ require upgrading to the latest beta.
123
+
124
+ ### Security boundaries
125
+
126
+ Robert treats GitHub content as untrusted, relies on the authenticated `gh` CLI,
127
+ stores no GitHub token in YAML configuration, isolates worker directories, uses
128
+ environment allowlists, and audits all proposed GitHub writes.
129
+
130
+ ## Support
131
+
132
+ Use the GitHub issue forms for reproducible bugs, feature requests, and
133
+ documentation problems. Include the Robert version, operating system, Python
134
+ version, and redacted `robert doctor --output json` output.
135
+
136
+ Use [GitHub Discussions](https://github.com/wklken/robert/discussions) for
137
+ setup questions and general usage help. Security reports belong in private
138
+ GitHub security advisories.
139
+
140
+ Before posting, remove credentials, private repository content, internal URLs,
141
+ local paths, worker logs, and sensitive diagnostic data.